Message mimicking

Use this page to configure a trace-route message to mimic a message, for example when the original message did not reach its intended destination

One use of trace-route messaging is to help determine the last known location of a message that did not reach its intended destination. The IBM MQ display route application provides parameters that can help configure a trace-route message to mimic the original message. When mimicking a message, we can use the following parameters:

-l Persistence

Specifies the persistence of the generated trace-route message. Possible values for Persistence are:

yes

The generated trace-route message is persistent. (MQPER_PERSISTENT).

no

The generated trace-route message is not persistent. (MQPER_NOT_PERSISTENT).

q

The generated trace-route message inherits its persistence value from the destination specified by -q TargetQName or -ts TargetTopicString. (MQPER_PERSISTENCE_AS_Q_DEF).

A trace-route reply message, or any report messages, returned will share the same persistence value as the original trace-route message.

If Persistence is specified as yes, you must specify the parameter -rq ReplyToQ. The reply-to queue must not resolve to a temporary dynamic queue.

If we do not specify this parameter, the generated trace-route message is not persistent.

-p Priority

Specifies the priority of the trace-route message. The value of Priority is either greater than or equal to 0, or MQPRI_PRIORITY_AS_Q_DEF. MQPRI_PRIORITY_AS_Q_DEF specifies that the priority value is taken from the destination specified by -q TargetQName or -ts TargetTopicString.

If we do not specify this parameter, the priority value is taken from the destination specified by -q TargetQName or -ts TargetTopicString.

-xs Expiry

Specifies the expiry time for the trace-route message, in seconds.

If we do not specify this parameter, the expiry time is specified as 60 seconds.

-ro none |ReportOption

none

Specifies no report options are set.

ReportOption

Specifies report options for the trace-route message. Multiple report options can be specified using a comma as a separator. Possible values for ReportOption are:

activity

The report option MQRO_ACTIVITY is set.

coa

The report option MQRO_COA_WITH_FULL_DATA is set.

cod

The report option MQRO_COD_WITH_FULL_DATA is set.

exception

The report option MQRO_EXCEPTION_WITH_FULL_DATA is set.

expiration

The report option MQRO_EXPIRATION_WITH_FULL_DATA is set.

discard

The report option MQRO_DISCARD_MSG is set.

If neither -ro ReportOption nor -ro none are specified, then the MQRO_ACTIVITY and MQRO_DISCARD_MSG report options are specified.

The IBM MQ display route application does not allow you to add user data to the trace-route message. If you require user data to be added to the trace-route message you must generate the trace-route message manually.