z/VM: CP Commands and Utilities Reference - z/VM - IBM

Operands
TRSOURCE ID (Definition Operands)
You do not need to specify all of the definition operands on each invocation of the
TRSOURCE command; you can build the definition piecemeal on a number of
TRSOURCE commands. Note, however, that the TYPE operand and certain TYPE
parameters must be associated with a trace ID before that trace can be enabled.
traceid
identifies the trace; it is a user-defined, alphanumeric, 1- to 8-character string.
You can specify traceid as a target on the ENABLE, DISABLE, and DROP
operands to activate, deactivate, or delete a particular trace; you can also use
traceid as a target for the TRSAVE command, which can alter the recording
options for a trace.
Used with the SET operand, trace IDs can be grouped to form trace sets. A
traceid cannot be a member of more than one trace set at a time.
The trace ID also serves as the default name of the system trace file for the
trace data. The operand trace IDs cannot duplicate any of the following
TRSOURCE keywords or any accepted abbreviation of these keywords: ID,
SET, TYPE, ENABLE, DISABLE, DROP, DISPLAY, and ALL.
SET traceset
SET NULL
is a user-defined, alphanumeric, 1- to 8-character string; it identifies the trace
set that includes the specified trace ID. Creating trace sets lets you group
individual traces that are functionally or logically related. You can then specify
traceset as the target of the ENABLE, DISABLE, and DROP operands to
activate, deactivate, or delete all of the trace IDs in traceset.
A trace set can contain trace IDs of more than one type. A trace set of NULL
indicates that the trace ID is not a member of any specific set. Set operations
cannot be performed on the NULL set.
A trace ID cannot be made a member of a set while it is enabled. Trace sets
cannot duplicate any of the following TRSOURCE keywords or any accepted
abbreviation of these keywords: ID, SET, TYPE, ENABLE, DISABLE, DROP,
DISPLAY, and ALL.
TYPE IO
TYPE GT
TYPE DATA
specifies a system-defined trace type. The trace type determines which
parameters are allowed and which are required for trace ID. The TYPE operand
need only be specified once for a given trace ID but must be specified before or
at the same time as any type parameter for that trace ID.
Different trace IDs of the same trace type can be placed in the same or
different trace sets. Trace types cannot be used as targets of the ENABLE,
DISABLE, and DROP operands. Grouping of trace IDs is done with the SET
operand, not the TYPE operand.
type parameters
The parameters and descriptions for the respective trace types are documented
in the following sections:
v “The I/O Trace”
v “The GT Trace”
v “The Data Trace”.
Chapter 2. CP Commands 1683