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.
|
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.
|
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.
|