gtpo1macOperations

ZMQSC DEF QR-Define a TPF MQSeries Remote Queue

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

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

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.