DEFINE QALIAS

Use DEFINE QALIAS to define a new alias queue, and set its parameters.

Note: An alias queue provides a level of indirection to another queue or a topic object. If the alias refers to a queue, it must be another local or remote queue, defined at this queue manager, or a clustered alias queue defined on another queue manager. It cannot be another alias queue on this queue manager. If the alias refers to a topic, it must be a topic object defined at this queue manager.

Synonym: DEF QA

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 QALIAS

Read syntax diagramSkip visual syntax diagram DEFINE QALIAS ( q-name ) CMDSCOPE(' ')CMDSCOPE(qmgr-name)1CMDSCOPE(*)12QSGDISP(QMGR)QSGDISP(COPY)1QSGDISP(GROUP)12define attrscommon queue attrsalias queue attrs
Define attrs
Read syntax diagramSkip visual syntax diagramLIKE(qalias-name)NOREPLACEREPLACE
Common queue attrs
Read syntax diagramSkip visual syntax diagramCUSTOM(stringCAPEXPRY(NOLIMITinteger))DEFPRTY(0)DEFPRTY(integer)DEFPRESP(SYNC)DEFPRESP(ASYNC)DEFPSIST(NO)DEFPSIST(YES)DESCR(' ')DESCR(string)PUT(ENABLED)PUT(DISABLED)
Alias 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)DEFREADA(NO)DEFREADA(YESDISABLED+)GET(ENABLED)GET(DISABLED)PROPCTL(COMPAT)PROPCTL(ALLFORCENONEV6COMPAT)SCOPE(QMGR)SCOPE(CELL)345TARGET(' ')TARGET(string)TARGTYPE(QUEUE)TARGTYPE(TOPIC)
Notes:
  • 1 Valid only on z/OS®.
  • 2 Valid only on z/OS when the queue manager is a member of a queue sharing group.
  • 3 Valid only on UNIX, Linux®, and Windows.
  • 4 Not valid on z/OS.
  • 5 The TARGQ parameter, defined in IBM WebSphere® MQ 6.0, is renamed to TARGET from version 7.0 and generalized to allow you to specify the name of either a queue or a topic. The default value for TARGET is a queue, therefore TARGET(my_queue_name) is the same as TARGQ(my_queue_name). The TARGQ attribute is retained for compatibility with your existing programs.