Use this command to define a local definition of a remote queue or a queue
manager alias. A remote queue is one that is owned by another queue
manager that applications connected to the TPF MQSeries queue manager need to
access.
Requirements and Restrictions
- You can enter this command only in NORM state.
- You must define the queue manager profile by entering the ZMQSC DEF MQP
command before entering this command.
- Without single quotation marks (' ') specified, characters are
handled as uppercase only. If a TPF MQSeries object needs to be
case-sensitive, enclose the object in single quotation marks.
Format
- QR-qrname
- specifies the name of the local definition of a remote queue or the queue
manager alias, where qrname is a 1- to 48-character queue
name. A queue name can contain percent signs (%), slashes
(/), underscores (_), periods (.), letters in either uppercase
(A-Z) or lowercase (a-z), and digits (0-9).
Do not specify a remote queue name of ALL.
- RQMNAME-rqmname
- specifies the name of the remote queue manager on which the remote queue
is defined, where rqmname is a 1- to 48-character queue manager
name. A queue manager name can contain percent signs (%),
slashes (/), underscores (_), periods (.), letters in either
uppercase (A-Z) or lowercase (a-z), and digits (0-9).
If the name is enclosed in single quotation marks, the characters can be mixed
case.
RQMNAME cannot be the same as the local queue manager name.
- RNAME-rname
- specifies the name of the remote queue, where rname is a 1- to
48-character queue name. A queue name can contain percent signs
(%), slashes (/), underscores (_), periods (.), letters
in either uppercase (A-Z) or lowercase (a-z), and digits
(0-9). If the name is enclosed in single quotation marks, the
characters can be mixed case.
If you specify this parameter, a local definition for the remote queue is
defined. If you do not specify this parameter, a queue manager alias is
defined.
- XMITQ-xmitq
- specifies the name of the transmission queue to be used for forwarding
messages to the remote queue, where xmitq is the 1- to 48-character
queue name. A queue name can contain percent signs (%), slashes
(/), underscores (_), periods (.), letters in either uppercase
(A-Z) or lowercase (a-z), and digits (0-9). If the
name is enclosed in single quotation marks, the characters can be mixed
case. If you do not specify this parameter, the value specified for the
RQMNAME parameter is used instead.
- PUT
- specifies one of the following:
- ENABLED
- specifies that messages can be added to the queue.
- DISABLED
- specifies that messages cannot be added to the queue.
- DEFPSIST
- specifies one of the following:
- NO
- specifies that messages on the queue are lost when the queue manager is
restarted.
- YES
- specifies that messages on the queue are retained when the queue manager
is restarted.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZMQSC HELP
ZMQSC ?
- The queue is defined to all processors in a loosely coupled
complex.
Examples
The following example defines a local definition for a remote queue called
RQ1 and specifies that a transmission queue called H2 will be used.
+--------------------------------------------------------------------------------+
|User: ZMQSC DEF QR-RQ1 RNAME-OS2Q RQMNAME-OS2MGR XMITQ-H2 |
| |
|System: MQSC0145I 08.41.05 REMOTE QUEUE RQ1 DEFINED |
+--------------------------------------------------------------------------------+
The following example defines a queue manager alias called QMGR1 and
specifies that a transmission queue called H3 will be used.
+--------------------------------------------------------------------------------+
|User: ZMQSC DEF QR-QMGR1 RQMNAME-OS2MGR XMITQ-H3 |
| |
|System: MQSC0145I 08.41.05 REMOTE QUEUE QMGR1 DEFINED |
+--------------------------------------------------------------------------------+
The following example defines a local definition for a remote queue called
RQ2 and specifies that a transmission queue called OS2MGR will be used.
+--------------------------------------------------------------------------------+
|User: ZMQSC DEF QR-RQ2 RQMNAME-OS2MGR RNAME-OS2Q |
| |
|System: MQSC0145I 08.41.05 REMOTE QUEUE RQ2 DEFINED |
+--------------------------------------------------------------------------------+
Related Information
See MQSeries Command Reference for more
information about defining local definitions of remote queues and queue
manager aliases.