Using trace on HP Integrity NonStop Server

Use the strmqtrc and endmqtrc commands to start and end tracing, and dspmqtrc to display a trace file.

Use the following commands on the IBM® MQ client for HP Integrity NonStop Server system to use the IBM MQ client trace facility:

strmqtrc: To start tracing
endmqtrc: To end tracing
dspmqtrc <filename>: To display a formatted trace file

The trace facility creates a file for each entity that is being traced. The trace files are created in a fixed location, which is <mqpath>/var/mqm/trace. You can handle large trace files by mounting a temporary file system over this directory.

Trace files are named AMQ.nnn.xx.ppp.qq.TRC where:

nnn: The name of the process.
xx: The processor number on which the process is running.
ppp: The PIN of the process that you are tracing.
qq: A sequence number, starting at 0. If the full file name exists, this value is incremented by one until a unique trace file name is found. A trace file name can exist if a process is reused.

Note:

Each field can contain fewer, or more, digits than shown in the example.
There is one trace file for each process that is running as part of the entity that is being traced.

Trace files are created in a binary format. To format or view a trace file use the dspmqtrc command, you must be either the creator of the trace file, or a member of the mqm group. For example, to format all trace files in the current directory use the following command:


dspmqtrc *.TRC

For more information about the control command dspmqtrc, see dspmqtrc.

How to start and stop a trace

On IBM MQ client for HP Integrity NonStop Server systems, you can enable or modify tracing by using the strmqtrc control command, for more information, see strmqtrc. To stop tracing, use the endmqtrc control command, for more information, see endmqtrc.

The control commands strmqtrc and endmqtrc affect tracing only for those processes that are running in one specific processor. By default, this processor is the same as the one in your OSS shell. To enable or end tracing for processes that are running in another processor, you must precede the strmqtrc or endmqtrc commands with run -cpu=n at an OSS shell command prompt, where n is the processor number. Here is an example of how to enter the strmqtrc command at an OSS shell command prompt:


run -cpu=2 strmqtrc

This command enables tracing for all processes that are running in processor 2.

The -m option to select a queue manager is not relevant for use on the IBM MQ client for HP Integrity NonStop Server . Specifying the -m option produces an error.

Use the -t and -x options to control the amount of trace detail to record. By default, all trace points are enabled. Specify the points that you do not want to trace by using the -x option.