Use this command to define a TPF MQSeries alias queue. An alias
queue is a virtual queue that is resolved to another queue name.
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
- QA-qaname
- specifies the name of the alias queue to be defined, where qaname
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. The name must be unique in the entire TPF
system complex.
Do not specify an alias queue name of ALL.
- TARGQ-tname
- specifies the name of the queue defined with the ZMQSC DEF QL or ZMQSC DEF
QR command to which this alias will refer, where tname 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.
- PUT
- specifies one of the following:
- ENABLED
- specifies that applications can add messages to the queue.
- Note:
- Messages will only be added to the queue if the definition for the target
queue also specifies PUT-ENABLED.
- DISABLED
- specifies that applications cannot add messages to the queue.
- GET
- specifies one of the following:
- ENABLED
- specifies that applications can retrieve messages from the queue.
- Note:
- Messages will only be retrieved from the queue if the definition for the
target queue also specifies GET-ENABLED.
- DISABLED
- specifies that applications cannot retrieve messages from 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 defines an alias queue named AQ1, which refers to
local queue LQ1. Receiving messages is disabled for this queue.
Adding messages to the queue is enabled if the ability to add messages is
enabled for local queue LQ1.
+--------------------------------------------------------------------------------+
|User: ZMQSC DEF QA-AQ1 TARGQ-LQ1 GET-DISABLED |
| |
|System: MQSC0143I 08.42.06 ALIAS QUEUE AQ1 DEFINED |
+--------------------------------------------------------------------------------+
Related Information
See MQSeries Command Reference for more
information about the MQSeries product.