Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 18 Monitoring Server Activity : Message Tracing

Message Tracing
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.
Enabling Message Tracing for a Destination
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.
When message tracing is enabled for a destination, a trace entry is output for each of the following events that occur in message processing:
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.
Enabling Message Tracing on a Message
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.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved