Shared queues interface trace

The shared queues interface trace provides information about errors associated with the interface between IMS and CQS.

Examples of errors that are traced are:

  • CQS Request errors
  • CQS Inform errors
  • Service errors
  • Storage errors

Use this trace under the direction of IBM® Software Support when problems are suspected in the interface between IMS and CQS.

You can turn on the shared queues interface trace in two ways:

  • During IMS online initialization, with the SQTT parameter in the DFSVSMxx IMS.PROCLIB member.
  • During online operation, with the /TRACE command.

Each trace entry is X'20' bytes long.

You can specify trace output destination and tracing volume on both the SQTT parameter and the /TRACE command.

The /TRACE SET ON TABLE SQTT command activates the trace and sends the output to an internal trace table that consists of 126 entries. If you specify OPTION LOG on the /TRACE command, IMS sends the output to the system log or an external trace data set in groups of 126. Other parameters control the volume of output.

You can format trace table entries with the Offline Dump Formatter under IPCS, using either the VERBX parameter or the IMS Dump Formatter panels. You can use the File Select and Formatting Print utility (DFSERA10) with exit routine DFSERA60 to format the trace entries written to an external data set.

To locate the shared queues interface trace in a dump, look for eye catcher **SQTT.

To display the status of the trace, use the /DISPLAY TRACE command.