Start IBM MQ DLQ Handler (STRMQMDLQ)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
Use the Start IBM MQ Dead-Letter Queue Handler (STRMQMDLQ) command to perform various actions on selected messages. The command specifies a set of rules that can both select a message and perform the action on that message.
The STRMQMDLQ command takes its input from the rules table as specified by SRCFILE and SRCMBR. When the command processes, the results and a summary are written to the printer spooler file.
Note:
The WAIT keyword, defined in the rules table, determines whether the dead-letter queue handler ends immediately after processing messages, or waits for new messages to arrive.
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| UDLMSGQ | Undelivered message queue | Character value, *DFT, *NONE | Required, Positional 1 |
| SRCMBR | Member containing input | Name, *FIRST | Required, Positional 2 |
| SRCFILE | Input file | Qualified object name | Optional, Positional 3 |
| Qualifier 1: Input file | Name, QTXTSRC | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| MQMNAME | Message Queue Manager name | Character value, *DFT, *NONE | Optional, Positional 4 |
Undelivered message queue (UDLMSGQ)
>Specifies the name of the local undelivered message queue that is to be processed.
The possible values are:
- *DFT
- The local undelivered-message queue used is taken from the default queue manager for the installation. If this option is specified, the INPUTQ keyword stated in the rules table is overridden by the default undelivered-message queue for the queue manager.
- undelivered-message-queue-name
- Specify the name of the local undelivered-message queue to be used. If this option is specified, the INPUTQ keyword stated in the rules table is overridden by the stated undelivered-message queue.
- *NONE
- The queue that is named by the INPUTQ keyword in the rules table is used, or the system-default dead-letter queue if the INPUTQ keyword in the rules table is blank.
Member containing input (SRCMBR)
>Specifies the name of the source member, containing the user-written rules table to be processed.
The possible values are:
- *FIRST
- The first member of the file is used.
- source-member-name
- Specify the name of the source member.
Input file (SRCFILE)
>Specifies the name of the source file and library, in the form LIBRARY/FILE, that contains the user-written rules table to be processed.
The possible values are:
- *LIBL
- Search the library list for the file name.
- *CURLIB
- Use the current library.
- source-library-name
- Specify the name of the library that is being used.
The possible values are:
- QTXTSRC
- Use QTXTSRC.
- source-file-name
- Specify the name of the source file.
Message Queue Manager name (MQMNAME)
>Specifies the name of the queue manager.
The possible values are:
- *DFT
- Use the default queue manager.
- queue-manager-name
- Specify the name of the queue manager. The name can contain up to 48 characters. The maximum number of characters is reduced if the system is using a double byte character set (DBCS).
- *NONE
- The queue manager that is named by the INPUTQM keyword in the rules table is used, or the system-default queue manager if the INPUTQM keyword in the rules table is blank.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i