Tracing WebSphere MQ for UNIX systems

In WebSphere MQ for UNIX systems you enable or modify tracing using the strmqtrc control command, which is described in strmqtrc (Start trace). To stop tracing, you use the endmqtrc control command, which is described in endmqtrc (end trace). On WebSphere MQ for Linux (x86 platform) systems you can alternatively use the WebSphere MQ Explorer to start and stop tracing.

Trace output is unformatted; use the dspmqtrc control command to format trace output before viewing. For example, to format all trace files in the current directory use the following command:

dspmqtrc *.TRC

For more information on the control command dspmqtrc, see dspmqtrc (display formatted trace output).

Selective component tracing on WebSphere MQ for UNIX systems

Use the -t and -x options to control the amount of trace detail to record. By default, all trace points are enabled. The -x option enables you to specify the points you do not want to trace. So if, for example, you want to trace, for queue manager QM1, only output data associated with using Secure Sockets Layer (SSL) channel security, use:

strmqtrc -m QM1 -t ssl 

For a full description of the trace command, see strmqtrc (Start trace).

Example trace data for WebSphere MQ for UNIX systems

Figure 25 shows an extract from a WebSphere MQ for HP-UX trace:

Figure 25. Sample WebSphere MQ for HP-UX trace
Timestamp        Process.Thread  Trace Data
===========================================
 15:19:01.830759    18153.1          Version : 6.0.0.0    Level : p000-L050228
 15:19:01.831571    18153.1          Date : 03/04/05  Time : 15:19:01
 15:19:01.831598    18153.1          PID : 18153 Process : strmqm_nd
 15:19:01.831607    18153.1          QueueManager : QM1
 15:19:01.831615    18153.1          --------------------------------
 15:19:01.831623    18153.1          Trace Control Memory:
 15:19:01.831632    18153.1          StrucId:              
 15:19:01.831640    18153.1          EarlyTraceOptions:        0
 15:19:01.831649    18153.1          EarlyTraceMaxFileSize: 0
 15:19:01.831657    18153.1          ActiveEntries:     0
 15:19:01.831665    18153.1          Options MaxFileSize FileCount SubPoolName
 15:19:01.831674    18153.1           1f4ffff             0    0         elk
 15:19:01.831683    18153.1                 0             0    0         
 15:19:01.831691    18153.1                 0             0    0         
 15:19:01.831700    18153.1                 0             0    0         
 15:19:01.831709    18153.1                 0             0    0         
 15:19:01.831717    18153.1                 0             0    0         
 15:19:01.831726    18153.1                 0             0    0         
 15:19:01.831778    18153.1                 0             0    0         
 15:19:01.831787    18153.1                 0             0    0         
 15:19:01.831800    18153.1          Thread stack
 15:19:01.838603    18153.1          -> zslWaitEC
 15:19:01.838612    18153.1          -> zslCheckIfRunning
 15:19:01.841757    18153.1          -> xcsInitialize
 15:19:01.841767    18153.1          -> xcsGetEnvironmentString
 15:19:01.841774    18153.1     ---{  xcsGetEnvironmentString
 15:19:01.841785    18153.1          xcsGetEnvironmentString[AMQ_SERVICE_MODULE]
                                                                          = NULL
 15:19:01.841793    18153.1     ---}! xcsGetEnvironmentString 
                                                     rc=xecE_E_ENV_VAR_NOT_FOUND
 15:19:01.841801    18153.1     ---{  xcsReleaseThreadMutexSem

Figure 26 shows an extract from a WebSphere MQ for Solaris trace:

Figure 26. Sample WebSphere MQ for Solaris trace
Timestamp        Process.Thread  Trace Data
===========================================
 15:00:04.324190    12277.1          Version : 6.0.0.0    Level : p000-L050203
 15:00:04.325045    12277.1          Date : 07/02/05  Time : 15:00:04
 15:00:04.325375    12277.1          PID : 12277 Process : strmqm
 15:00:04.325403    12277.1          QueueManager : QM1
 15:00:04.325419    12277.1          --------------------------------
 15:00:04.325446    12277.1          Trace Control Memory:
 15:00:04.325471    12277.1          StrucId:              
 15:00:04.325490    12277.1          EarlyTraceOptions:        0
 15:00:04.325507    12277.1          EarlyTraceMaxFileSize: 0
 15:00:04.325527    12277.1          ActiveEntries:     0
 15:00:04.325544    12277.1          Options MaxFileSize FileCount SubPoolName
 15:00:04.325566    12277.1            74ffff             0    0         elk
 15:00:04.325587    12277.1                 0             0    0         
 15:00:04.325609    12277.1                 0             0    0         
 15:00:04.325632    12277.1                 0             0    0         
 15:00:04.325654    12277.1                 0             0    0         
 15:00:04.325677    12277.1                 0             0    0         
 15:00:04.325698    12277.1                 0             0    0         
 15:00:04.325774    12277.1                 0             0    0         
 15:00:04.325798    12277.1                 0             0    0         
 15:00:04.325891    12277.1          Thread stack
 15:00:04.325971    12277.1          -> zslWaitEC
 15:00:04.326078    12277.1          -> zslCheckIfRunning
 15:00:04.326098    12277.1          -> xcsInitialize
 15:00:04.326147    12277.1          -> xcsGetEnvironmentString
 15:00:04.326186    12277.1     ---{  xcsGetEnvironmentString
 15:00:04.326241    12277.1          xcsGetEnvironmentString[AMQ_SERVICE_MODULE] 
                                                      = NULL

Figure 27 shows an extract from a WebSphere MQ for Linux trace:

Figure 27. Sample WebSphere MQ for Linux trace
Timestamp        Process.Thread  Trace Data
===========================================
 15:15:05.931699     1159.1          Version : 6.0.0.0    Level : p000-L050107
 15:15:05.931843     1159.1          Date : 02/07/05  Time : 15:15:05
 15:15:05.932016     1159.1          PID : 1159 Process : amqzdmaa
 15:15:05.932024     1159.1          QueueManager : QM1
 15:15:05.932028     1159.1          --------------------------------
 15:15:05.932037     1159.1          Trace Control Memory:
 15:15:05.932044     1159.1          StrucId:              
 15:15:05.932049     1159.1          EarlyTraceOptions:        0
 15:15:05.932054     1159.1          EarlyTraceMaxFileSize: 0
 15:15:05.932059     1159.1          ActiveEntries:     0
 15:15:05.932064     1159.1          Options MaxFileSize FileCount SubPoolName
 15:15:05.932070     1159.1            74ffff             0    0         elk
 15:15:05.932075     1159.1                 0             0    0         
 15:15:05.932081     1159.1                 0             0    0         
 15:15:05.932086     1159.1                 0             0    0         
 15:15:05.932091     1159.1                 0             0    0         
 15:15:05.932097     1159.1                 0             0    0         
 15:15:05.932102     1159.1                 0             0    0         
 15:15:05.932107     1159.1                 0             0    0         
 15:15:05.932112     1159.1                 0             0    0         
 15:15:05.932138     1159.1          Thread stack
 15:15:05.932149     1159.1          -> xxxInitialize
 15:15:05.932158     1159.1     {  xxxInitialize
 15:15:05.932165     1159.1     -{  xcsSetlocale
 15:15:05.932189     1159.1          category(6) locale() buffer(0xbfffd340) 
                                                      buflen(1285)
 15:15:05.932196     1159.1          Doing the first-thread-only 
                                                      locale check . . . .
 15:15:05.932326     1159.1     -}  xcsSetlocale rc=OK
 15:15:05.932344     1159.1     -{  xcsGetMem

Figure 28 shows an extract from a WebSphere MQ for AIX trace:

Figure 28. Sample WebSphere MQ for AIX trace
Timestamp        Process.Thread  Trace Data
===========================================
 13:12:12.336214   286850.1          Version : 6.0.0.0    Level : p000-L050201
 13:12:12.336345   286850.1          Date : 02/15/05  Time : 13:12:12
 13:12:12.336419   286850.1          PID : 286850 Process : amqzlaa0_nd
 13:12:12.336444   286850.1          QueueManager : QM1
 13:12:12.336468   286850.1          --------------------------------
 13:12:12.336493   286850.1          Trace Control Memory:
 13:12:12.336518   286850.1          StrucId:              
 13:12:12.336542   286850.1          EarlyTraceOptions:        0
 13:12:12.336567   286850.1          EarlyTraceMaxFileSize: 0
 13:12:12.336591   286850.1          ActiveEntries:     0
 13:12:12.336616   286850.1          Options MaxFileSize FileCount SubPoolName
 13:12:12.336641   286850.1            74ffff             0    0         elk
 13:12:12.336668   286850.1                 0             0    0         
 13:12:12.336692   286850.1                 0             0    0         
 13:12:12.336718   286850.1                 0             0    0         
 13:12:12.336742   286850.1                 0             0    0         
 13:12:12.336768   286850.1                 0             0    0         
 13:12:12.336792   286850.1                 0             0    0         
 13:12:12.336817   286850.1                 0             0    0         
 13:12:12.336842   286850.1                 0             0    0         
 13:12:12.336870   286850.1          Thread stack
 13:12:12.336897   286850.1          -> xxxInitialize
 13:12:12.336921   286850.1     {  xxxInitialize
 13:12:12.336947   286850.1     -{  xcsSetlocale
 13:12:12.336977   286850.1          category(-1) locale() 
                                          buffer(fffffffffffcf08) buflen(1285)
 13:12:12.337005   286850.1       Doing the first-thread-only locale check . . .
 13:12:12.338602   286850.1     -}  xcsSetlocale rc=OK