Overview of the DEQUEUE command
When you have messages that you do not need on the message queues, Message Advisor lets you dequeue (delete) them, freeing the message queue space. To dequeue (and optionally write to a sequential data set) all or selected messages from a specified destination, use the options provided with the DEQUEUE command.
The DEQUEUE command lets you perform the following tasks:
- Dequeue all messages from a destination
- Dequeue Multiple System Coupling (MSC) destinations
- Dequeue a specific message from a destination
- Dequeue a specific queue
- Dequeue transactions (SMBs)
- Dequeue messages meeting your selection criteria
- Validate (test) messages for a successful dequeue without actually doing the dequeue
Unload messages satisfying all selection criteria and then dequeue these messages (MODE=UNLOAD_DEQUEUE)
The MODE=UNLOAD_DEQUEUE option unloads messages to an output file, reads the output file records, deletes the messages from IMS, and updates the output file. Use this option to ensure that only the messages that are unloaded will be dequeued. Message Advisor compares data to ensure that before any messages are dequeued, it verifies that these messages are exactly the ones that were unloaded.
Also, this option is used to dequeue messages from one IMS system and then requeue them to the same, or another IMS system.
- Select or reject messages for dequeue based on the following criteria:
- Date and time ranges
- Destinations (with masking allowed)
- LU names (with masking allowed)
- Origin (with masking allowed)
- Destination type
- Type of message (queue number)
- Additional types of criteria (see Dequeueing-messages-command-set)
For more information about the DEQUEUE command, subcommands, keywords, and parameters, see the Reference.
Related topic