Script (MQSC) Command Reference: STOP TRACE

STOP TRACE

Use STOP TRACE to stop tracing.
Synonym: There is no synonym for this command.
STOP TRACE
 
                               .-CMDSCOPE(' ')------------.
>>-STOP TRACE--(-+-ACCTG--+-)--+--------------------------+----->
                 +-GLOBAL-+    |                     (1)  |
                 +-STAT---+    '-CMDSCOPE(qmgr-name)------'
                 '-*------'
 
>--+-----------------------+--+----------------------+---------->
   '-| destination block |-'  '-| constraint block |-'
 
>--+-----------------+-----------------------------------------><
   '-COMMENT(string)-'
 
Destination block
 
           .-,-------.
           V         |
|--DEST--(---+-GTF-+-+-)----------------------------------------|
             +-RES-+
             +-SMF-+
             '-SRV-'
 
Constraint block
 
   .-CLASS(*)---------------------.  .-RMID(*)-------------.
|--+------------------------------+--+---------------------+---->
   |          .-,-------.         |  |       .-,-------.   |
   |          V         |         |  |       V         |   |
   '-CLASS(-+---integer-+-----+-)-'  '-RMID(---integer-+-)-'
            '-integer:integer-'
 
   .-TNO(*)-------------.  .-USERID(*)------------.
>--+--------------------+--+----------------------+-------------|
   |      .-,-------.   |  |         .-,------.   |
   |      V         |   |  |         V        |   |
   '-TNO(---integer-+-)-'  '-USERID(---string-+-)-'
 
 
Notes:

Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

Parameter descriptions

Each option that you use limits the effect of the command to active traces that were started using the same option, either explicitly or by default, with exactly the same parameter values.
You must specify a trace type or an asterisk. STOP TRACE(*) stops all active traces.
The trace types are:

ACCTG

Accounting data (the synonym is A)

Note:

Accounting data can be lost if the accounting trace is started or stopped while applications are running. For information about the conditions that must be satisfied for successful collection of accounting data, see the WebSphere MQ for z/OS System Setup Guide.

GLOBAL

Service data from the entire queue manager (the synonym is G)

STAT

Statistical data (the synonym is S)

*

All active traces

CMDSCOPE

This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.
CMDSCOPE cannot be used for commands issued from the first initialization input data set CSQINP1.

' '

The command is executed on the queue manager on which it was entered. This is the default value.

qmgr-name

The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.
You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.

COMMENT(string)

Specifies a comment that is reproduced in the trace output record (except in the resident trace tables), and can be used to record why the command was issued.
string is any character string. It must be enclosed in single quotation marks if it includes a blank, comma, or special character.

Destination block

DEST

Limits the action to traces started for particular destinations. More than one value can be specified, but do not use the same value twice. If no value is specified, the list is not limited.
Possible values and their meanings are:

GTF

The Generalized Trace Facility

RES

A wrap-around table residing in the ECSA

SMF

The System Management Facility

SRV

A serviceability routine designed for problem diagnosis

Constraint block

CLASS(integer)

Limits the command to traces started for particular classes. See the START TRACE command for a list of allowed classes. A range of classes can be specified as m:n (for example, CLASS(01:03)). You cannot specify a class if you did not specify a trace type.
The default is CLASS(*), which does not limit the command.

RMID(integer)

Limits the command to traces started for particular resource managers. See the START TRACE command for a list of allowed resource manager identifiers.
Do not use this option with the STAT or ACCTG trace type.
If the list of RMIDs includes 231, explicitly or by default, the tracing for this resource manager is left unchanged if one of the following is true:

The channel initiator is not active
TRACE(GLOBAL) or TRACE(*) is not specified
The list of destinations does not include RES
This list of classes does not include 01 or 04

Also, comments are truncated to 120 characters.
The default is RMID(*), which does not limit the command.

TNO(integer)

Limits the command to particular traces, identified by their trace number (0 to 32). Up to 8 trace numbers can be used. If more than one number is used, only one value for USERID can be used.
0 is the trace that the channel initiator can start automatically. Traces 1 to 32 are those that can be started automatically by the queue manager, or manually, using the START TRACE command.
The default is TNO(*), which applies the command to all active traces with numbers 1 to 32, but not to the 0 trace. You can stop trace number 0 only be specifying it explicitly.

USERID(string)

Limits the action of the STOP TRACE to traces started for particular user ID. Up to 8 user IDs can be used. If more than one user ID is used, only one value can be used for TNO. Do not use this option with STAT.
The default is USERID(*), which does not limit the command.

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.