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 Syntax diagrams.


DEFINE QREMOTE

DEFINE QREMOTE ( q-name ) CMDSCOPE(' ')CMDSCOPE(qmgr-name)1CMDSCOPE(*)12QSGDISP(QMGR)QSGDISP(COPY)1QSGDISP(GROUP)12define attrscommon queue attrsremote queue attrsDefine attrsLIKE(qremote-name)NOREPLACEREPLACECommon queue attrsCUSTOM(' ')CUSTOM(stringCAPEXPRY(NOLIMITinteger))DEFPRTY(0)DEFPRTY(integer)DEFPRESP(SYNC)DEFPRESP(ASYNC)DEFPSIST(NO)DEFPSIST(YES)DESCR(' ')DESCR(string)PUT(ENABLED)PUT(DISABLED)Remote queue attrsCLUSNL(' ')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, Linux, and Windows.
  • 4 Not valid on z/OS.

Parent topic: DEFINE queues