gtpo1ma4Operations

ZMQSC ALT QR-Alter a TPF MQSeries Remote Queue Definition

Use this command to change a TPF MQSeries remote queue definition.

Requirements and Restrictions

Format




QR-qrname
specifies the name of the remote queue definition to be changed, where qrname 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.

RQMNAME-rqmname
changes 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
changes 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.

Notes:

  1. Specify blanks enclosed in single quotation marks (' ') for this parameter to change a previously defined local definition for a remote queue to a queue manager alias.

  2. Specify a queue name for this parameter to change a previously defined queue manager alias to a local definition for a remote queue or to change the name of the remote queue in the local definition of the remote queue.

XMITQ-xmitq
changes the name of the transmission queue 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 specify blanks (' ') for the name, the remote queue manager name specified with the RQMNAME parameter is used.

PUT
specifies one of the following:

ENABLED
specifies that applications can add messages to the queue.

DISABLED
specifies that applications cannot add messages 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 ?

Examples

The following example changes a remote queue.

+--------------------------------------------------------------------------------+
|User:   ZMQSC ALT QR-OS2Q XMITQ-H2                                              |
|                                                                                |
|System: MQSC0149I 08.41.05 REMOTE QUEUE OS2Q ALTERED                            |
+--------------------------------------------------------------------------------+

Related Information

See MQSeries Command Reference for more information about the MQSeries product.