In addition to other server activity, you can trace messages as they are processed. Trace entries for messages are only generated for destinations or messages that specify tracing should be performed. For destinations, you specify the trace property to enable the generation of trace messages. For individual messages, the
JMS_TIBCO_MSG_TRACE property specifies that tracing should be performed for this message, regardless of the destination settings. The sections below describe the tracing properties for destinations and messages.
Message trace entries can be output to either the console or the log. The MSG trace option specifies that message trace entries should be displayed, and the
DEFAULT trace option includes the
MSG option. See
Tracing on the Server for more information about specifying trace options.
You must set the tracing property on either destinations or messages and also set the MSG or
DEFAULT trace option on the console or the log before you can view trace entries for messages.
The trace property on a destination specifies that trace entries are generated for that destination.
The trace property can optionally be specified as
trace=body. Setting
trace=body includes the message body in trace messages. The EMS server prints up to one kilobyte of a message string field, and up to a total message size of 8 KB. The trace message indicates if the full message is not printed.
Setting trace without the
body option specifies that only the message sequence and message ID are included in the trace message.
Replies to request messages are traced only when the reply destination has the trace property. Similarly, replies to exported messages are only traced when the
trace property is set.
You can enable tracing on individual messages by setting the JMS_TIBCO_MSG_TRACE property on the message. The value of the property can be either
null (Java/.NET null or NULL in C) or the string
"body". Setting the property to
null specifies only the message ID and message sequence will be included in the trace entries for the message. Setting the property to
"body" specifies the message body will be included in the trace entries for the message.
When the JMS_TIBCO_MSG_TRACE property is set for a message, trace entries are generated for the message as it is processed, regardless of whether the
trace property is set for any destinations the message passes through. Trace messages are generated for the message when it is sent by the producer and when it is received by the consumer.