[z/OS]

ALTER TRACE (alter trace event settings) on z/OS

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 on z/OS

For information on how you use MQSC commands on z/OS®, see Sources from which you can issue MQSC and PCF commands on IBM® MQ for z/OS.

Parameters not specified in the ALTER TRACE command result in the existing values for those parameters being left unchanged.

You can issue this command from sources 12CR. For an explanation of the source symbols, see Sources from which you can issue MQSC and PCF commands on IBM MQ for z/OS.

Syntax diagram for ALTER TRACE

Synonym: ALT TRACE

ALTER TRACE

Read syntax diagramSkip visual syntax diagram ALTER TRACE ( GLOBALSTATACCTG ) TNO ( integer ) CMDSCOPE(' ')CMDSCOPE(qmgr-name)1trace attrs
Trace attrs
Read syntax diagramSkip visual syntax diagramCLASS(*,integerinteger:integer)COMMENT(string)IFCID(*,ifcid)
Notes:
  • 1 Valid only on z/OS when the queue manager is a member of a queue sharing group.

Usage notes

Channel initiator traces cannot be altered.

Parameter descriptions for ALTER TRACE

Specify one of the following trace types:
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)
And:
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 runs 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 runs on the queue manager on which it was entered.
qmgr-name
The command runs 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 (start trace) on z/OS for a list of allowed classes. A range of classes can be specified as m:n (for example, CLASS(01:03)).

For GLOBAL and CHINIT traces, CLASS(*) activates all classes.

For ACCTG and STAT traces, CLASS(*) activates classes 1 to 3. Channel initiator statistics and channel accounting data are not started with CLASS(*), and must be started with CLASS(4).

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.