Use trace on Compaq OpenVMS Alpha, HP-UX, SINIX, DC/OSx, and Solaris

Using trace on Compaq OpenVMS Alpha, HP-UX, SINIX, DC/OSx, and Solaris

Compaq OpenVMS Alpha, HP-UX, SINIX, Solaris, and DC/OSx use the following commands for the WebSphere MQ client trace facility:

strmqtrc -e

to start early tracing

endmqtrc -e

to end early tracing

dspmqtrc <filename>

to display a formatted trace file

For more information about the trace commands, see the WebSphere MQ System Administration Guide manual for Version 5.3 products, or the System Management Guide for your platform for products earlier than Version 5.3.
The trace facility uses a number of files, which are:

One file for each entity being traced, in which trace information is recorded
One additional file on each machine, to provide a reference for the shared memory used to start and end tracing
One file to identify the semaphore used when updating the shared memory

Files associated with trace are created in a fixed location in the file tree, which is /var/mqm/trace.
On Compaq OpenVMS Alpha systems, the files are in the MQS_ROOT:[MQM.TRACE] directory.
All queue manager tracing, all early tracing, and all @SYSTEM tracing takes place to files in this directory.
You can handle large trace files by mounting a temporary file system over this directory.

File names for trace files

Trace file names are constructed in the following way:
AMQppppp.TRC
where ppppp is the process ID (PID) of the process producing the trace.
Notes:

The value of the process ID can contain fewer or more digits than shown in the example.
There is one trace file for each process running as part of the entity being traced.

How to examine FFSTs

FFST logs are written when a severe WebSphere MQ error occurs. They are written to the directory /var/mqm/errors, except on OS/2. On OS/2 they are written to the FFST logging facility.
These are normally severe, unrecoverable errors and indicate either a configuration problem with the system or a WebSphere MQ internal error.
The files are named AMQnnnnn.mm.FDC, where:

nnnnn is the process id reporting the error
mm is a sequence number, normally 0

When a process creates an FFST it also sends a record to syslog. The record contains the name of the FFST file to assist in automatic problem tracking.
The syslog entry is made at the "user.error" level.
The WebSphere MQ trace utility is explained in detail in the WebSphere MQ System Administration Guide manual for WebSphere MQ V5.3 products, and the relevant System Management Guide for other platforms.

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.