DEFINE QALIAS (define a new alias queue)

Use the MQSC command 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.

Syntax diagram for DEFINE QALIAS

Synonym: DEF QA

Values shown above the main line in the syntax diagram are the defaults supplied with IBM® MQ, but your installation might have changed them. For an explanation of how to use these diagrams, see How to read 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 diagramCAPEXPRY (NOLIMIT)CAPEXPRY(integer)CUSTOM(' ')CUSTOM(string)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 AIX®, 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.