ALTER Queues

 

---

This section contains the following commands:

• ALTER QALIAS
• ALTER QLOCAL
• ALTER QMODEL
• ALTER QREMOTE

 

ALTER QALIAS

Use ALTER QALIAS to alter the parameters of an alias queue.

Synonym: ALT QA

ALTER QALIAS
 
>>-ALTER QALIAS(q-name)--+-------+------------------------------>
                         '-FORCE-'
 
   .-CMDSCOPE(' ')------------. (1)
>--+--------------------------+--------------------------------->
   |                     (2)  |
   +-CMDSCOPE(qmgr-name)------+
   |             (2)          |
   '-CMDSCOPE(*)--------------'
 
   .-QSGDISP(QMGR)-------. (1)
>--+---------------------+-------+--------------------+--------->
   +-QSGDISP(COPY)-------+       '-| common q attrs |-'
   |                (2)  |
   +-QSGDISP(GROUP)------+
   '-QSGDISP(PRIVATE)----'
 
>--+-------------------+---------------------------------------><
   '-| alias q attrs |-'
 
Common q attrs
 
|--+------------------+--+---------------------+---------------->
   '-DEFPRTY(integer)-'  '-DEFPSIST(-+-NO--+-)-'
                                     '-YES-'
 
>--+---------------+--+---------------------+-------------------|
   '-DESCR(string)-'  '-PUT(-+-ENABLED--+-)-'
                             '-DISABLED-'
 
Alias q attrs
 
|--+---------------------------+--+---------------------+------->
   |                      (3)  |  |                (3)  |
   '-CLUSTER(clustername)------'  '-CLUSNL(nlname)------'
 
>--+------------------------------+--+---------------------+---->
   |                         (3)  |  '-GET(-+-ENABLED--+-)-'
   '-DEFBIND(-+-OPEN-----+-)------'         '-DISABLED-'
              '-NOTFIXED-'
 
>--+------------------------+--+---------------+----------------|
   |               (4)      |  '-TARGQ(string)-'
   '-SCOPE(-+-QMGR------+-)-'
            |      (5)  |
            '-CELL------'
 
 

Notes:

1. Valid only on z/OS.

2. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

3. Valid only on AIX, HP-UX, z/OS, OS/400, Solaris, and Windows.

4. Valid only on Compaq OpenVMS, OS/400, UNIX systems, and Windows.

5. Valid only on Compaq OpenVMS, UNIX systems, and Windows.

 

ALTER QLOCAL

Use ALTER QLOCAL to alter the parameters of a local queue.

Synonym: ALT QL

ALTER QLOCAL
 
>>-ALTER QLOCAL(q-name)--+-------+------------------------------>
                         '-FORCE-'
 
   .-CMDSCOPE(' ')------------. (1)
>--+--------------------------+--------------------------------->
   |                     (2)  |
   +-CMDSCOPE(qmgr-name)------+
   |             (2)          |
   '-CMDSCOPE(*)--------------'
 
   .-QSGDISP(QMGR)--------. (1)
>--+----------------------+-------+--------------------+-------->
   +-QSGDISP(COPY)--------+       '-| common q attrs |-'
   |                (2)   |
   +-QSGDISP(GROUP)-------+
   +-QSGDISP(PRIVATE)-----+
   |                 (2)  |
   '-QSGDISP(SHARED)------'
 
>--+-------------------+---------------------------------------><
   '-| local q attrs |-'
 
Common q attrs
 
|--+------------------+--+---------------------+---------------->
   '-DEFPRTY(integer)-'  '-DEFPSIST(-+-NO--+-)-'
                                     '-YES-'
 
>--+---------------+--+---------------------+-------------------|
   '-DESCR(string)-'  '-PUT(-+-ENABLED--+-)-'
                             '-DISABLED-'
 
Local q attrs
 
|--+-----------------+--+-------------------+------------------->
   '-BOQNAME(string)-'  '-BOTHRESH(integer)-'
 
>--+---------------------+--+---------------------------+------->
   |                (1)  |  |                      (3)  |
   '-CFSTRUCT(name)------'  '-CLUSTER(clustername)------'
 
>--+---------------------+--+------------------------------+---->
   |                (3)  |  |                         (3)  |
   '-CLUSNL(nlname)------'  '-DEFBIND(-+-OPEN-----+-)------'
                                       '-NOTFIXED-'
 
>--+-----------------------+--+-----------------------+--------->
   '-DEFSOPT(-+-EXCL---+-)-'  |                  (4)  |
              '-SHARED-'      '-DISTL(-+-NO--+-)------'
                                       '-YES-'
 
>--+---------------------+--+-------------------------------+--->
   '-GET(-+-ENABLED--+-)-'  |                          (1)  |
          '-DISABLED-'      '-INDXTYPE(-+-CORRELID-+-)------'
                                        +-GROUPID--+
                                        +-MSGID----+
                                        +-MSGTOKEN-+
                                        '-NONE-----'
 
>--+---------------+--+-------------------+--------------------->
   '-INITQ(string)-'  '-MAXDEPTH(integer)-'
 
>--+------------------+--+--------------------------+----------->
   '-MAXMSGL(integer)-'  '-MSGDLVSQ(-+-PRIORITY-+-)-'
                                     '-FIFO-----'
 
>--+----------------+--+-------------+--+---------------+------->
   '-+-NOHARDENBO-+-'  '-+-NOSHARE-+-'  '-+-NOTRIGGER-+-'
     '-HARDENBO---'      '-SHARE---'      '-TRIGGER---'
 
>--+-----------------+--+-------------------+------------------->
   '-PROCESS(string)-'  '-QDEPTHHI(integer)-'
 
>--+-------------------+--+-------------------------+----------->
   '-QDEPTHLO(integer)-'  '-QDPHIEV(-+-ENABLED--+-)-'
                                     '-DISABLED-'
 
>--+-------------------------+--+--------------------------+---->
   '-QDPLOEV(-+-ENABLED--+-)-'  '-QDPMAXEV(-+-ENABLED--+-)-'
              '-DISABLED-'                  '-DISABLED-'
 
>--+---------------------+--+------------------+---------------->
   '-QSVCIEV(-+-NONE-+-)-'  '-QSVCINT(integer)-'
              +-HIGH-+
              '-OK---'
 
>--+-------------------+--+------------------------+------------>
   '-RETINTVL(integer)-'  |               (5)      |
                          '-SCOPE(-+-QMGR------+-)-'
                                   |      (6)  |
                                   '-CELL------'
 
>--+-----------------------+--+------------------+-------------->
   |                  (1)  |  '-TRIGDATA(string)-'
   '-STGCLASS(string)------'
 
>--+-------------------+--+-------------------+----------------->
   '-TRIGDPTH(integer)-'  '-TRIGMPRI(integer)-'
 
>--+-----------------------+--+---------------------+-----------|
   '-TRIGTYPE(-+-FIRST-+-)-'  '-USAGE(-+-NORMAL-+-)-'
               +-EVERY-+               '-XMITQ--'
               +-DEPTH-+
               '-NONE--'
 
 

Notes:

1. Valid only on z/OS.

2. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

3. Valid only on AIX, HP-UX, z/OS, OS/400, Solaris, and Windows.

4. Valid only on AIX, HP-UX, OS/400, Solaris, and Windows.

5. Valid only on Compaq OpenVMS, OS/400, UNIX systems, and Windows.

6. Valid only on Compaq OpenVMS, UNIX systems, and Windows.

 

ALTER QMODEL

Use ALTER QMODEL to alter the parameters of a model queue.

Synonym: ALT QM

ALTER QMODEL
 
                         .-CMDSCOPE(' ')------------. (1)
>>-ALTER QMODEL(q-name)--+--------------------------+----------->
                         |                     (2)  |
                         +-CMDSCOPE(qmgr-name)------+
                         |             (2)          |
                         '-CMDSCOPE(*)--------------'
 
   .-QSGDISP(QMGR)-------. (1)
>--+---------------------+-------+--------------------+--------->
   +-QSGDISP(COPY)-------+       '-| common q attrs |-'
   |                (2)  |
   +-QSGDISP(GROUP)------+
   '-QSGDISP(PRIVATE)----'
 
>--+-------------------+--+------------------+-----------------><
   '-| local q attrs |-'  '-| model q attr |-'
 
Common q attrs
 
|--+------------------+--+---------------------+---------------->
   '-DEFPRTY(integer)-'  '-DEFPSIST(-+-NO--+-)-'
                                     '-YES-'
 
>--+---------------+--+---------------------+-------------------|
   '-DESCR(string)-'  '-PUT(-+-ENABLED--+-)-'
                             '-DISABLED-'
 
Local q attrs
 
|--+-----------------+--+-------------------+------------------->
   '-BOQNAME(string)-'  '-BOTHRESH(integer)-'
 
>--+---------------------+--+-----------------------+----------->
   |                (1)  |  '-DEFSOPT(-+-EXCL---+-)-'
   '-CFSTRUCT(name)------'             '-SHARED-'
 
>--+-----------------------+--+---------------------+----------->
   |                  (3)  |  '-GET(-+-ENABLED--+-)-'
   '-DISTL(-+-NO--+-)------'         '-DISABLED-'
            '-YES-'
 
>--+-------------------------------+--+---------------+--------->
   |                          (1)  |  '-INITQ(string)-'
   '-INDXTYPE(-+-CORRELID-+-)------'
               +-GROUPID--+
               +-MSGID----+
               +-MSGTOKEN-+
               '-NONE-----'
 
>--+-------------------+--+------------------+------------------>
   '-MAXDEPTH(integer)-'  '-MAXMSGL(integer)-'
 
>--+--------------------------+--+----------------+------------->
   '-MSGDLVSQ(-+-PRIORITY-+-)-'  '-+-NOHARDENBO-+-'
               '-FIFO-----'        '-HARDENBO---'
 
>--+-------------+--+---------------+--+-----------------+------>
   '-+-NOSHARE-+-'  '-+-NOTRIGGER-+-'  '-PROCESS(string)-'
     '-SHARE---'      '-TRIGGER---'
 
>--+-------------------+--+-------------------+----------------->
   '-QDEPTHHI(integer)-'  '-QDEPTHLO(integer)-'
 
>--+-------------------------+--+-------------------------+----->
   '-QDPHIEV(-+-ENABLED--+-)-'  '-QDPLOEV(-+-ENABLED--+-)-'
              '-DISABLED-'                 '-DISABLED-'
 
>--+--------------------------+--+---------------------+-------->
   '-QDPMAXEV(-+-ENABLED--+-)-'  '-QSVCIEV(-+-NONE-+-)-'
               '-DISABLED-'                 +-HIGH-+
                                            '-OK---'
 
>--+------------------+--+-------------------+------------------>
   '-QSVCINT(integer)-'  '-RETINTVL(integer)-'
 
>--+-----------------------+--+------------------+-------------->
   |                  (1)  |  '-TRIGDATA(string)-'
   '-STGCLASS(string)------'
 
>--+-------------------+--+-------------------+----------------->
   '-TRIGDPTH(integer)-'  '-TRIGMPRI(integer)-'
 
>--+-----------------------+--+---------------------+-----------|
   '-TRIGTYPE(-+-FIRST-+-)-'  '-USAGE(-+-NORMAL-+-)-'
               +-EVERY-+               '-XMITQ--'
               +-DEPTH-+
               '-NONE--'
 
Model q attr
 
|--+------------------------------+-----------------------------|
   '-DEFTYPE(-+-TEMPDYN-------+-)-'
              +-PERMDYN-------+
              |          (1)  |
              '-SHAREDYN------'
 
 

Notes:

1. Valid only on z/OS.

2. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

3. Valid only on AIX, HP-UX, OS/400, Solaris, and Windows.

 

ALTER QREMOTE

Use ALTER QREMOTE to alter the parameters of a local definition of a remote queue, a queue-manager alias, or a reply-to queue alias.

Synonym: ALT QR

ALTER QREMOTE
 
>>-ALTER QREMOTE(q-name)--+-------+----------------------------->
                          '-FORCE-'
 
   .-CMDSCOPE(' ')------------. (4)
>--+--------------------------+--------------------------------->
   |                     (5)  |
   +-CMDSCOPE(qmgr-name)------+
   |             (5)          |
   '-CMDSCOPE(*)--------------'
 
   .-QSGDISP(QMGR)-------. (4)
>--+---------------------+-------+--------------------+--------->
   +-QSGDISP(COPY)-------+       '-| common q attrs |-'
   |                (5)  |
   +-QSGDISP(GROUP)------+
   '-QSGDISP(PRIVATE)----'
 
>--+--------------------+--------------------------------------><
   '-| remote q attrs |-'
 
Common q attrs
 
|--+------------------+--+---------------------+---------------->
   '-DEFPRTY(integer)-'  '-DEFPSIST(-+-NO--+-)-'
                                     '-YES-'
 
>--+---------------+--+---------------------+-------------------|
   '-DESCR(string)-'  '-PUT(-+-ENABLED--+-)-'
                             '-DISABLED-'
 
Remote q attrs
 
|--+---------------------------+--+---------------------+------->
   |                      (1)  |  |                (1)  |
   '-CLUSTER(clustername)------'  '-CLUSNL(nlname)------'
 
>--+------------------------------+--+---------------+---------->
   |                         (1)  |  '-RNAME(string)-'
   '-DEFBIND(-+-OPEN-----+-)------'
              '-NOTFIXED-'
 
>--+-----------------+--+------------------------+-------------->
   '-RQMNAME(string)-'  |               (2)      |
                        '-SCOPE(-+-QMGR------+-)-'
                                 |      (3)  |
                                 '-CELL------'
 
>--+---------------+--------------------------------------------|
   '-XMITQ(string)-'
 
 

Notes:

1. Valid only on AIX, HP-UX, z/OS, OS/400, Solaris, and Windows.

2. Valid only on Compaq OpenVMS, OS/400, UNIX systems, and Windows.

3. Valid only on Compaq OpenVMS, UNIX systems, and Windows.

4. Valid only on z/OS.

5. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

 

Parameter descriptions

For a description of the parameters see DEFINE queues.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.