DEFINE QREMOTE

Use DEFINE QREMOTE to define a new local definition of a remote queue, a queue manager alias, or a reply-to queue alias, and to set its parameters.

A remote queue is one that is owned by another queue manager that application processes connected to this queue manager need to access.

Synonym: DEF QR

Read syntax diagramSkip visual syntax diagramDEFINE QREMOTE

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

   .-QSGDISP(QMGR)-------. (2)
>--+---------------------+-------+------------------+----------->
   |               (1)   |       '-| define attrs |-'
   +-QSGDISP(COPY)-------+
   |                (1)  |
   '-QSGDISP(GROUP)------'

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

Define attrs:

                           .-NOREPLACE-.
|--+--------------------+--+-----------+------------------------|
   '-LIKE(qremote-name)-'  '-REPLACE---'

Common q attrs:

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

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

Remote q attrs:

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

                 (3)                    (3)
   .-CLWLPRTY(0)-------.  .-CLWLRANK(0)-------.
>--+-------------------+--+-------------------+----------------->
   '-CLWLPRTY(integer)-'  '-CLWLRANK(integer)-'

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

                  (3)                   (5) (3)
   .-RQMNAME(' ')------.  .-SCOPE(QMGR)----------.
>--+-------------------+--+----------------------+-------------->
   '-RQMNAME(string)---'  |             (6)      |
                          '-SCOPE(CELL)----------'

                (3)
   .-XMITQ(' ')------.
>--+-----------------+------------------------------------------|
   '-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. This is the default supplied with WebSphere MQ, but your installation might have changed it.
  4. Valid only on AIX, HP OpenVMS, HP-UX, Linux, i5/OS, Solaris, Windows, and z/OS.
  5. Valid only on HP OpenVMS, i5/OS, UNIX systems, and Windows.
  6. Valid only on HP OpenVMS, UNIX systems, and Windows.