Use this command to change a TPF MQSeries local queue definition.
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
- 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
- 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 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.