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:

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

• 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.

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.