DLQ action keywords on IBM i

Use these dead-letter queue action keywords to determine how a matching message on the IBM i dead-letter queue is processed.

ACTION (DISCARD|IGNORE|RETRY|FWD)

The action taken for any message on the DLQ that matches the pattern defined in this rule.

DISCARD

Causes the message to be deleted from the DLQ.

IGNORE

Causes the message to be kept on the DLQ.

RETRY

Causes the DLQ handler to try again to put the message on its destination queue.

FWD

Causes the DLQ handler to forward the message to the queue named on the FWDQ keyword.

We must specify the ACTION keyword. The number of attempts made to implement an action is governed by the RETRY keyword. The RETRYINT keyword of the control data controls the interval between attempts.

FWDQ ( QueueName|&DESTQ|&REPLYQ)

The name of the message queue to which the message is forwarded when you select the ACTION keyword.

QueueName

The name of a message queue. FWDQ(' ') is not valid.

&DESTQ

Take the queue name from the DestQName field in the MQDLH structure.

&REPLYQ

Take the queue name from the ReplyToQ field in the message descriptor, MQMD.

We can specify REPLYQ (?*) in the message pattern to avoid error messages, when a rule specifying FWDQ (&REPLYQ) matches a message with a blank ReplyToQ field.

FWDQM ( QueueManagerName|&DESTQM|&REPLYQM|' ')

The queue manager of the queue to which a message is forwarded.

QueueManagerName

The queue manager name for the queue to which the message is forwarded when you select the ACTION (FWD) keyword.

&DESTQM

Take the queue manager name from the DestQMgrName field in the MQDLH structure.

&REPLYQM

Take the queue manager name from the ReplyToQMgr field in the message descriptor, MQMD.

' '

FWDQM(' '), which is the default value, identifies the local queue manager.

HEADER ( YES|NO)

Whether the MQDLH should remain on a message for which ACTION (FWD) is requested. By default, the MQDLH remains on the message. The HEADER keyword is not valid for actions other than FWD.

PUTAUT ( DEF|CTX)

The authority with which messages should be put by the DLQ handler:

DEF

Puts messages with the authority of the DLQ handler itself.

CTX

Causes the messages to be put with the authority of the user ID in the message context. We must be authorized to assume the identity of other users, if we specify PUTAUT (CTX).

RETRY ( RetryCount|1 )

The number of times, in the range 1 - 999,999,999, to attempt an action (at the interval specified on the RETRYINT keyword of the control data). Note: The count of attempts made by the DLQ handler to implement any particular rule is specific to the current instance of the DLQ handler; the count does not persist across restarts. If you restart the DLQ handler, the count of attempts made to apply a rule is reset to zero.

Parent topic: DLQ rules (patterns and actions) on IBM i