gtpo1ma0Operations

ZMQSC ALT MQP-Alter a TPF MQSeries Profile

Use this command to change and set default values for a local MQSeries queue manager on your TPF system.

Requirements and Restrictions

Format




MQP-qmanager
specifies the name of the TPF MQSeries queue manager to be changed, where qmanager is the 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 qmanager is enclosed in single quotation marks, the characters can be mixed case.

You can have one queue manager in the TPF system complex for each subsystem.

DEADQ-dlqname
defines the default dead-letter queue name, where dlqname is the name of the file that is used as the dead-letter queue.

MAXMSGL-maxmsgl
changes the default maximum message length that can be transmitted on the channel or the maximum message length for a message on a queue, where maxmsgl is a number in the range 0-4 194 304.

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

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

BATCHSZ-batchsz
changes the default maximum number of messages that can be sent over any subsequently defined channels before TPF MQSeries guarantees delivery of the messages in the batch. The TPF batch size is from 1 to 9999 messages. The maximum batch size actually used is the lowest of the following:

NEWNAME-qmanager
specifies the new name of the TPF MQSeries queue manager in the TPF system, where qmanager is the 1- to 48-character alphanumeric name. If qmanager is enclosed in single quotation marks, the characters can be mixed case.

You can have one queue manager in the TPF system complex for each subsystem.

The new name may not be the same as any RQMNAME for any defined or remote queues.

QDT-qdt
specifies the time interval, in seconds, for checking the maximum queue depth that is set for each transmission queue, where qdt is a number from 0 to 999 999 999.

If you specify 0, the queue depth is not checked.

MAXDEPTH-maxdepth
changes the default maximum number of messages allowed on all subsequently defined memory queues, where maxdepth is a number from 0 to 999 999 999. If you specify zero, there is no maximum for any subsequently defined queues.

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

SWEEP
specifies one of the following:

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

OFF
specifies that memory queues are not swept.

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

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 TPF MQSeries profile.

+--------------------------------------------------------------------------------+
|User:   ZMQSC ALT MQP-TPFMQA MAXMSGL-4000                                       |
|                                                                                |
|System: MQSC0002I 08.41.25 ALTER PROFILE SUCCESSFUL                             |
+--------------------------------------------------------------------------------+

Related Information

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