Use this command to do the following:
- Set or display trace parameters
- Start or stop tracing according to the current trace parameters.
Requirements and Restrictions
- You can enter this command only in NORM state.
- You must define the queue manager profile by entering the ZMQSC DEF MQP
command before entering this command.
- Without single quotation marks (' ') specified, characters are
handled as uppercase only. If a TPF MQSeries object needs to be
case-sensitive, enclose the object in single quotation marks.
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:
- If you specify the CHL or CHANNEL parameter, the specified trace
(function, communications, or both) is set on for the specified
channel.
- If you specify the QUEUE parameter, function trace is set on for the
specified queue. Tracing will occur even if the queue is not
defined.
- If you specify the ADMIN parameter, function trace is set on for the ZMQSC
commands.
- If you specify the ALL parameter, function trace is set on for all system
activity.
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:
- If you specify the CHL or CHANNEL parameter, the specified trace
(function, communications, or both) is set off for the specified
channel.
- If you specify the QUEUE parameter, function trace is set off for the
specified queue.
- If you specify the ADMIN parameter, function trace is set off for the
ZMQSC commands.
- If you specify the ALL parameter, function trace is set off for all system
activity. This setting is independent of activity specified with the
QUEUE, CHL, CHANNEL, or ADMIN parameters.
- 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
- Online help information is available for this command. To display
the help information, enter one of the following:
ZMQSC HELP
ZMQSC ?
- The trace data is attached to the entry control block (ECB) and will be
included in any system error dumps that are issued even if you specify NO for
both the CONSOLE and TAPE parameters.
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
- See MQSeries Command Reference for more
information about the MQSeries product.
- See TPF Program Development Support Reference
for more information about TPF MQSeries tracing and postprocessing and an
example of the trace data.