Subsystem Control Point (SCP) Management Programming Manual

Tr ac ing
Subsystem Control Point (SCP) Management Programming Manual—520619-001
B-10
Initiating a Trace
Initiating a Trace
To initiate a trace, issue a TRACE command containing:
Specifying Tracing Process and Object
The manager process that performs the trace is specified in ZSPI-TKN-MANAGER or
ZCOM-TKN-XMGR, or, if the manager name is part of the object name, in ZCOM-TKN-
OBJNAME. If ZCOM-TKN-OBJNAME is not included, the manager process itself is
traced. If both manager token and object-name token are included in the request, they
identify the tracing process and the traced object, respectively.
Specifying the Trace-Data Disk File
You can create the trace-data file before requesting the trace so that the size, ownership,
and access parameters of the file satisfy your requirements. The file should be an
unstructured file with a file code of 830.
If the file specified by ZTRC-DDL-TRACE-MODIF.ZFNAME does not exist, the
collector process creates the file with these characteristics:
•
The file is owned by the requester that issued the TRACE command.
•
The file has the default file security of the requester that issued the TRACE
command.
•
The file’s extent size and maximum number of extents are calculated by the trace
collector process using the algorithm listed on the following page.
If you reuse an existing trace file, old data is purged before the new trace is started.
ZSPI-TKN-MANAGER (old)
or ZCOM-TKN-XMGR
Set to the name of the subsystem manager
process. If no OBJNAME token is included, this
is the object that will be traced.
ZCOM-TKN-OBJNAME Set to the name of the object to be traced. If
omitted, the object is the manager process
specified in the MANAGER or XMGR token.
Some subsystems might include the manager
name as part of the object name.
ZTRC-TKN-OPT Set to any valid tracing option (required, and
might be included more than once). For
supported values, see the appropriate subsystem
management programming manual. (For values
supported by SCP, see TRACE Command on
page 5-35.)
ZTRC-DDL-TRACE-MODIF.ZSTOP Set to ZSPI-VAL-FALSE (default) or blank.
ZTRC-DDL-TRACE-MODIF.ZFNAME Set to the file name of the trace-data disk file.