gtpo1maaOperations

ZMQSC DEF QA-Define a TPF MQSeries Alias Queue

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

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.