ALTER TRACE
Use the MQSC command ALTER TRACE to change the trace events being traced for a particular active queue manager trace. ALTER TRACE stops the specified trace, and restarts it with the altered parameters.
Using MQSC commands
For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.
IBM® i | UNIX and Linux® | Windows | z/OS® |
---|---|---|---|
12CR |
Parameters not specified in the ALTER TRACE command result in the existing values for those parameters being left unchanged.
For an explanation of the symbols in the z/OS column, see Using commands on z/OS.
Usage notes
Channel initiator traces cannot be altered.Parameter descriptions for ALTER TRACE
- GLOBAL
- Service data from the entire queue manager (the synonym is G)
- STAT
- Statistical data (the synonym is S)
- ACCTG
- Accounting data (the synonym is A)
- TNO( integer )
- The number of the trace to be altered (1 through 32). You can specify only one trace number.
- 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.
- 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.
Trace parameters
- CLASS( integer )
- The new trace class. See START TRACE for a list of allowed classes. A range of classes can be specified as m:n (for example, CLASS(01:03)). CLASS(*) activates all classes.
- COMMENT( string )
-
A comment that is
reproduced in the trace output record (except in the resident trace tables).
string is any character string. If it includes blanks, commas, or special characters, it must be enclosed between single quotation marks (').
- IFCID( ifcid )
- Reserved for IBM Service.