Control data

DLQ handler, INPUTQM keyword, RETRYINT keyword, WAIT keyword" /> Control data

Control data

This section describes the keywords that we can include in a control-data entry in a DLQ handler rules table. Note the following:

The default value for a keyword, if any, is underlined.
The vertical line (|) separates alternatives. We can specify only one of these.
All keywords are optional.

INPUTQ (QueueName|' ')

The name of the DLQ you want to process:

Any UDLMSGQ value (or *DFT) you specify as a parameter to the STRMQMDLQ command overrides any INPUTQ value in the rules table.
If you specify a blank UDLMSGQ value as a parameter to the STRMQMDLQ command, the INPUTQ value in the rules table is used.
If you specify a blank UDLMSGQ value as a parameter to the STRMQMDLQ command, and a blank INPUTQ value in the rules table, the system default dead-letter queue is used.

INPUTQM (QueueManagerName|' ')

The name of the queue manager that owns the DLQ named on the INPUTQ keyword.
If you do not specify a queue manager, or you specify INPUTQM(' ') in the rules table, the system uses the default queue manager for the installation.

RETRYINT (Interval|60)

The interval, in seconds, at which the DLQ handler should attempt to reprocess messages on the DLQ that could not be processed at the first attempt, and for which repeated attempts have been requested. By default, the retry interval is 60 seconds.

WAIT (YES|NO|nnn)

Whether the DLQ handler should wait for further messages to arrive on the DLQ when it detects that there are no further messages that it can process.

YES

Causes the DLQ handler to wait indefinitely.

NO

Causes the DLQ handler to terminate when it detects that the DLQ is either empty or contains no messages that it can process.

nnn

Causes the DLQ handler to wait for nnn seconds for new work to arrive before terminating, after it detects that the queue is either empty or contains no messages that it can process.

Specify WAIT (YES) for busy DLQs, and WAIT (NO) or WAIT (nnn) for DLQs that have a low level of activity. If the DLQ handler is allowed to terminate, re-invoke it using triggering.

We can supply the name of the DLQ as an input parameter to the STRMQMDLQ command, as an alternative to including control data in the rules table. If any value is specified both in the rules table and on input to the STRMQMDLQ command, the value specified on the STRMQMDLQ command takes precedence.
Note:
If a control-data entry is included in the rules table, it must be the first entry in the table.