gtpo1ma3Operations

ZMQSC ALT QL-Alter a TPF MQSeries Local Queue Definition

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

Requirements and Restrictions

Format




QL-qlname
specifies the name of the local queue to be changed, where qlname 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.

MAXMSGL-maxmsgl
changes the maximum message length on this local queue, where maxmsgl is a number from 0 to the maximum message length specified in the TPF MQSeries profile.

Applications can use this attribute to determine the size of the buffer they need to retrieve messages from the queue.

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.

GET
specifies one of the following:

ENABLED
specifies that applications can retrieve messages from the queue.

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.

QDEPTHHI-qdepthhi
changes the default percentage of messages that are allowed before a warning message is sent to the console, where qdepthhi is a number from 0 to 100.

If you specify 0, no warnings are sent to the console.

This parameter is not valid for queues that are processor shared; that is, queues defined with the COMMON parameter set to YES.

MAXDEPTH-maxdepth
changes the maximum number of messages allowed on a memory queue, where maxdepth is a number from 0 to 999 999 999. If you specify zero, there is no maximum for this queue.

Other factors can cause the queue to be handled as full; for example, if there is no more DASD or memory space available.

This parameter is not valid for queues that are processor shared; that is, queues defined with the COMMON parameter set to YES.

SWEEP
specifies one of the following:

ON
specifies that this memory queue is moved (swept) to a TPF collection support (TPFCS) persistent collection when the number of messages on the queue are increasing.

OFF
specifies that this memory queue is not swept.

Attention: Setting the SWEEP parameter to OFF can decrease the number of system work blocks (SWBs).

TRIGTYPE
specifies one of the following:

FIRST
specifies that the program in the process object is triggered to run the first time a message arrives on the queue. If no process is associated with the queue, the TPF queue trigger user exit (CUIR) is called.

EVERY
specifies that the program in the process object is triggered to run every time a message arrives on the queue. If no process is associated with the queue, no triggering occurs.

NONE
specifies that the program in the process object is not triggered to run.

TRIGDATA-trigdata
specifies a character string that contains trigger information pertaining to the application to be started, where trigdata is a 1- to 64-character string. This is free-format data that the queue manager inserts into the trigger message when a message arriving on this queue causes a trigger message to be written.

NOTRIGGER
specifies that triggering is not active.

TRIGGER
specifies that triggering is active and will occur as specified by the TRIGTYPE parameter.

PROCESS-processname
specifies the name of a process object that is defined on the local queue manager, where processname is the 1- to 48-character process name. A process name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). If processname is enclosed in single quotation marks, the characters can be mixed case.

Additional Information

Examples

The following example changes a local queue.

+--------------------------------------------------------------------------------+
|User:   ZMQSC ALT QL-'local.queue.' GET-DISABLED                                |
|                                                                                |
|System: MQSC0146I 08.41.05 LOCAL QUEUE local.queue ALTERED                      |
+--------------------------------------------------------------------------------+

Related Information

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