Enterprise Administration > Windchill ESI > Administering Windchill ESI in an SAP Environment > Administration Tasks > Configuring and Administering JMS Queues > Enable JMS Message Logging
  
Enable JMS Message Logging
It may be helpful for you to turn on logging for all JMS queues so that you can look at every message that is being exchanged across the Windchill ESI interface.
* 
Shutdown the JMS server and purge any messages on the queues before performing the following steps.
1. Enable logging on the server by following these steps:
a. Locate the tibemsd.conf file in the <Tibco_Home>/ems/<version>/tibco/cfgmgmt/ems/data directory and open it using a text editor, such as Notepad.
b. Locate the following properties related to logging and make the changes:
Property
Description
Example
logfile
Specifies the path and name of your JMS log file.
C:\tibco\jms\jms.log
logfile_max _size
Specifies the maximum size of the log file before it is rotated. Specified as KB and MB.
1MB
log_trace
Specifies what you want logged to the log file. Possible tracing options are:
INFO, WARNING, ACL, LIMITS, SSL, SSL_DEBUG, ROUTE, ROUTE_DEBUG, ADMIN, RVADV, CONNECT, CONNECT_ERROR, PRODCONS, DEST.
* 
A value called DEFAULT logs the following: INFO, WARNING, ACL, LIMITS, ROUTE, ADMIN, RVADV, CONNECT_ERROR. You can add or remove from the default by using a + or a — in front of the property.
log_trace= DEFAULT,-LIMITS, -ACL,+SSL,+ROUTE,+ROUTE_DEBUG
The above setting provides for default logging without LIMITS and ACL, but adds SSL, ROUTE and ROUTE_DEBUG
console_ trace
Determines what you want logged on the console window.
* 
This can impact performance. It is recommended that you log to a file rather than to the console.
See log_trace, described earlier in this table, for values and examples.
The next time you start your EMS server, the changed properties take effect.
2. Specify what should be logged on each queue:
a. Locate the queues.conf file in the <Tibco_Home>/ems/<version>/tibco/cfgmgmt/ems/data directory and open it using a text editor, such as Notepad.
b. Add one of the following properties to the list of properties for each queue you would like to trace, separating each property with commas.
Property
Description
Example
trace
Logs the time the message was put on the queue, the user that sent the message onto the queue, the time the message was taken off of the queue and the user that received the message from the queue.
Tracing messages on the DataResponse queue, you would have the following line in your queues.conf file:
SAP
com.ptc.windchill.esi.DataResponse.<ESISAPAdapter/SystemID>.<ESISAPAdapter/Client>secure,trace
Oracle
com.ptc.windchill.esi.DataResponse.<DSN> secure,trace
trace=body
Logs everything that the trace property logs, but also the actual content of the JMS message.
Tracing the DataResponse queue and collecting the actual content of the JMS message, you would have the following line in your queues.conf file:
SAP
com.ptc.windchill.esi.DataResponse.<ESISAPAdapter/SystemID>.<ESISAPAdapter/Client>,trace=body
Oracle
com.ptc.windchill.esi.DataResponse.<DSN> ,trace=body
3. Restart your EMS server.
* 
You can also use the EMS Administration tool to perform these steps. For more information, see the TIBCO Enterprise Message Service User's Guide. To get more information about each command, you can also type “help” in the Administration tool.