gtpo1mamOperations

ZMQSC TRACE-Tracing a TPF MQSeries Channel or Queue

Use this command to do the following:

Requirements and Restrictions

Format




CHL
specifies the name of the channel you want to trace, where:

name
is the 1- to 20-character channel name. A channel name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). If the name is enclosed in single quotation marks, the characters can be mixed case.

ALL
sets tracing for all channels. This is independent of any individual channels for which trace has been started.

CHANNEL
specifies the name of the channel you want to trace. This is equivalent to the CHL parameter.

Comms
sets communications trace for the specified channel.

Function
sets function trace for the specified channel.

ALL
sets both function and communications trace for the specified channel.

Queue
specifies the queue for which function trace is to be set, where:

qname
is a 1- to 48-character single queue name. A queue name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). If the name is enclosed in single quotation marks, the characters can be mixed case.

ALL
sets function trace for all queues. This setting is independent of any individual queues for which trace was started.

ADMin
sets function trace for all ZMQSC commands.

ALL
sets function trace for all system activity. Do not specify this parameter during high system activity because it can severely degrade performance. Setting this parameter does not affect the setting for channels, queues, or the ZMQSC commands.

ON
specifies one of the following:

Tracing does not actually start until you enter ZMQSC TRACE START. Tracing continues until you enter ZMQSC TRACE STOP.

OFF
specifies one of the following:

CONSOLE
specifies one of the following:

ON
specifies that the trace output will be sent to the console. Specify this parameter only for test systems because it can degrade performance on a production system.
Note:
If you enter ZMQSC TRACE STOP to stop tracing and there are still messages in the buffer, these messages will continue to display on the console until the buffer is empty.

OFF
specifies that the trace output will not be sent to the console.

TAPE
specifies one of the following:

ON
specifies that the trace output will be sent to the RTL tape. You must postprocess the output offline. See TPF Program Development Support Reference for an example of the job control language (JCL) you can use to postprocess the trace data.

OFF
specifies that the trace output will not be sent to the RTL tape.

START
starts tracing according to the current parameter settings.

STOP
stops tracing. The current parameter settings are retained.

DISplay
displays trace information, where:

STATUS
displays the current trace parameters.

Queue
displays a list of queues to be traced.

CHL
displays a list of channels to be traced.

CHANNEL
displays a list of channels to be traced.

ALL
displays the current trace parameter and a list of queues and channels to be traced.

Additional Information

Examples

The following example sets a queue named LQ1 to be traced.

+--------------------------------------------------------------------------------+
|User:   ZMQSC TRACE Q-LQ1 ON                                                    |
|                                                                                |
|System: MQSC0030I 12.08.32 QUEUE LQ1 ADDED TO FUNCTION TRACE TABLE              |
+--------------------------------------------------------------------------------+

The following example sets both function and communication trace on for all channels.

+--------------------------------------------------------------------------------+
|User:   ZMQSC TRACE CHL-ALL ALL ON                                              |
|                                                                                |
|System: MQSC0047I 12.10.30 TRACE PARAMETERS ALTERED SUCCESSFULLY                |
+--------------------------------------------------------------------------------+

The following example sets tracing off for the ZMQSC commands.

+--------------------------------------------------------------------------------+
|User:   ZMQSC TRACE ADMIN OFF                                                   |
|                                                                                |
|System: MQSC0047I 13.15.44 TRACE PARAMETERS ALTERED SUCCESSFULLY                |
+--------------------------------------------------------------------------------+

The following example specifies that trace output will be sent to the console.

+--------------------------------------------------------------------------------+
|User:   ZMQSC TRACE CONSOLE-ON                                                  |
|                                                                                |
|System: MQSC0047I 13.15.44 TRACE PARAMETERS ALTERED SUCCESSFULLY                |
+--------------------------------------------------------------------------------+

The following example starts tracing according to the current parameter settings.

+--------------------------------------------------------------------------------+
|User:   ZMQSC TRACE START                                                       |
|                                                                                |
|System: MQSC0048I 13.15.44 TRACE STARTED                                        |
+--------------------------------------------------------------------------------+

The following example displays the current tracing parameters.

+--------------------------------------------------------------------------------+
|User:   ZMQSC TRACE DISPLAY STATUS                                              |
|                                                                                |
|System: MQSC0177I 13.15.44 TRACE STATUS DISPLAY                                 |
|        TRACE IS OFF                                                            |
|          TAPE - ON                                                             |
|          CONSOLE - OFF                                                         |
|        TRACING ALL - OFF                                                       |
|        TRACING ADMIN - ON                                                      |
|        TRACING ALL QUEUES - NO                                                 |
|        TRACING ALL CHANNELS (FUNCTION) - NO                                    |
|                             (COMMS) - NO                                       |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The following example displays a list of the queues being traced.

+--------------------------------------------------------------------------------+
|User:   ZMQSC TRACE DISPLAY QUEUE                                               |
|                                                                                |
|System: MQSC0177I 13.15.44 TRACE STATUS DISPLAY                                 |
|        QUEUES IN FUNCTION TRACE TABLE:                                         |
|          LQ1                                                                   |
|          LQ2                                                                   |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information