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

Read syntax diagramSkip visual syntax diagramALTER QREMOTE

>>-ALTER QREMOTE(q-name)--+-------+----------------------------->
                          '-FORCE-'

   .-CMDSCOPE(' ')------------. (2)
>--+--------------------------+--------------------------------->
   |                     (1)  |
   +-CMDSCOPE(qmgr-name)------+
   |             (1)          |
   '-CMDSCOPE(*)--------------'

   .-QSGDISP(QMGR)-------. (2)
>--+---------------------+-------+--------------------+--------->
   +-QSGDISP(COPY)-------+       '-| common q attrs |-'
   |                (1)  |
   +-QSGDISP(GROUP)------+
   '-QSGDISP(PRIVATE)----'

>--+--------------------+--------------------------------------><
   '-| remote q attrs |-'

Common q attrs:

|--+------------------+--+---------------------+---------------->
   '-DEFPRTY(integer)-'  '-DEFPSIST(-+-NO--+-)-'
                                     '-YES-'

>--+---------------+--+---------------------+-------------------|
   '-DESCR(string)-'  '-PUT(-+-ENABLED--+-)-'
                             '-DISABLED-'

Remote q attrs:

|--+---------------------------+--+---------------------+------->
   |                      (3)  |  |                (3)  |
   '-CLUSTER(clustername)------'  '-CLUSNL(nlname)------'

>--+-------------------+--+-------------------+----------------->
   '-CLWLPRTY(integer)-'  '-CLWLRANK(integer)-'

>--+------------------------------+--+---------------+---------->
   |                         (3)  |  '-RNAME(string)-'
   '-DEFBIND(-+-OPEN-----+-)------'
              '-NOTFIXED-'

>--+-----------------+--+------------------------+-------------->
   '-RQMNAME(string)-'  |               (4)      |
                        '-SCOPE(-+-QMGR------+-)-'
                                 |      (5)  |
                                 '-CELL------'

>--+---------------+--------------------------------------------|
   '-XMITQ(string)-'

Notes:
  1. Valid only on z/OS when the queue manager is a member of a queue-sharing group.
  2. Valid only on z/OS.
  3. Valid only on AIX, HP-UX, z/OS, i5/OS, Solaris, and Windows.
  4. Valid only on HP OpenVMS, i5/OS, UNIX systems, and Windows.
  5. Valid only on HP OpenVMS, UNIX systems, and Windows.