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

Values shown above the main line in the railroad diagram are the defaults supplied with IBM® MQ, but your installation might have changed them. See How to read railroad diagrams.

DEFINE QREMOTE

Read syntax diagramSkip visual syntax diagram DEFINE QREMOTE ( q-name ) CMDSCOPE(' ')CMDSCOPE(qmgr-name)1CMDSCOPE(*)12QSGDISP(QMGR)QSGDISP(COPY)1QSGDISP(GROUP)12define attrscommon queue attrsremote queue attrs
Define attrs
Read syntax diagramSkip visual syntax diagramLIKE(qremote-name)NOREPLACEREPLACE
Common queue attrs
Read syntax diagramSkip visual syntax diagramCUSTOM(' ')CUSTOM(string)DEFPRTY(0)DEFPRTY(integer)DEFPRESP(SYNC)DEFPRESP(ASYNC)DEFPSIST(NO)DEFPSIST(YES)DESCR(' ')DESCR(string)PUT(ENABLED)PUT(DISABLED)
Remote queue attrs
Read syntax diagramSkip visual syntax diagramCLUSNL(' ')CLUSNL(nlname)CLUSTER(' ')CLUSTER(clustername)CLWLPRTY(0)CLWLPRTY(integer)CLWLRANK(0)CLWLRANK(integer)DEFBIND(OPEN)DEFBIND(NOTFIXEDGROUP)RNAME(' ')RNAME(string)RQMNAME(' ')RQMNAME(string)SCOPE(QMGR)SCOPE(CELL)34XMITQ(' ')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 UNIX and Linux® systems, and Windows.
  • 4 Not valid on z/OS.