MODIFY QUEUE statement
MODIFY QUEUE statement
Function
Alters the current default option(s) for an open queue for the issuing user.
Syntax
MODIFY QUEUE {%variable | name | external_qmanager:external_queue} {[option...] [?%variable...]}
Where
- Queue to operate on is specified as:
-
option is one or more of the following options:
- ACCEPT_TRUNCATED_MSG or NO_ACCEPT_TRUNCATED_MSG
- ALL_MSGS_AVAILABLE or NOT_ALL_MSGS_AVAILABLE (default)
- CONTEXT
- EXPIRY
- FAIL_IF_QUIESCING or NO_FAIL_IF_QUIESCING
- FORMAT
- LOGICAL_ORDER or NOT_LOGICAL_ORDER (default)
- MSGTYPE
- PERSISTENT or NOT_PERSISTENT
- PERSISTENCE_AS_Q_DEF
- SYNCPOINT or NO_SYNCPOINT
- PRIORITY or PRIORITY_AS_Q_DEF
- REPLY_QMGR
- REPLY_QUEUE
- REPORT
- WAIT or NO_WAIT
- WAIT_TIME
- ?%variable specifies option(s) of the MODIFY QUEUE statement to compile at evaluation time. For more information on ?%variables, see Using runtime options.
| Queue as... | Specifies |
|---|---|
| %variable | Queue name |
| name | Literal without quotation marks |
| external_qmanager:external_queue | External name of a queue manager that contains the remote queue to process and the external name of the remote queue |
Usage
Options that apply to MQGET, MQPUT, and MQPUT1 statements can be specified in the DEFINE QUEUE command, and defaults for MQGET and MQPUT statements can be specified in an OPEN QUEUE statement.
You can override defined options by specifying the desired options directly on an MQGET, MQPUT, or MQPUT1 statement.
If you are repeatedly overriding DEFINE QUEUE command options, you might prefer to alter the current options for an open queue using the MODIFY QUEUE statement.