Optional Rule-initiated EXEC parameter settings that determine how the DLQ solution processes DLQ messages
The following table describes the EXEC parameters that you can use to specify how the Rule-initiated EXEC processes DLQ messages.
Parameter | Description | |
---|---|---|
DP | Disposition: specifies a 1-character value which configures how the DLQ solution processed a message in the dead letter queue. Choose one of the following optional parameters:
| |
FD | Final Disposition: specifies a one-character value that tells the DLQ solution what to do if the retries fail. Possible values are as follows:
| |
FQ | Forward Queue: Specify one of the following values:
| |
FQM | Forward Queue Manager: specifies a remote queue manager to which the message should be forwarded when the FQ(qname) parameter is used. Specifies one of the following values:
| |
RD | Remove Dead Letter Header: specifies whether or not the Dead Letter Header (DLH) should be removed when the message is retried, forwarded or moved (moved applies to final disposition processing only). Specify Y or N. For retry processing the default is Y; for forwarding and moving the default is N. With this option, the original message is reconstituted by moving the Encoding, CodedCharSetId and Format fields from the DLH back into the message descriptor (MD) prior to the PUT of the message. | |
PA | Put Authorization: specifies whether to use the authority of the original application that is attempting to PUT the message or that of the BMC AMI Ops Automation for MQ BBI-SS PAS jobname when retrying the message or forwarding or moving it to another queue. Specifying PA(D) for default, causes the jobname of the BBI-SS PAS to be used (MQPMO_SET_IDENTITY_CONTEXT) for authority checking by MQ. This is the default setting. Specifying PA(C) will cause the context fields from the original application that PUT the message to be used for authority checking (MQPMO_PASS_ALL_CONTEXT). | |
R | Retry: specifies the number of retries in which the DLQ solution should attempt to PUT the dead letter message on its original destination queue or other queue as specified in the FQ(xxx) parameter. Valid values are 1-999999999. The default is 3. After all retries have been exhausted the message is subject to Final Disposition processing. | |
AL | Alert: specifies a queue name in which an alert should be created should all retries fail. The queue name specified must follow the normal syntax requirements. See Using-Rules-with-BMC-AMI-Ops-Automation and Using-advanced-automation-with-BMC-AMI-Ops-Automation for more information about how to create ALERTs. There is no default and if you do not specify a value for this parameter means that the Rule will not create an LALERT. When the Rule issues the ALERT, the ALERT will contain the following attributes:
|
Related topic