Use this command to change a TPF MQSeries remote queue definition.
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 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:
- 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.
- 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.