Use this command to change and set default values for a local MQSeries
queue manager on your TPF system.
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
- 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:
- The batch size of the sending channel
- The batch size of the receiving channel.
- 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.