Subsystem Control Point (SCP) Management Programming Manual

Tr ac ing
Subsystem Control Point (SCP) Management Programming Manual—520619-001
B-12
Modifying a Trace
Modifying a Trace
Your application can modify a currently executing trace by sending a TRACE command
containing:
Three parameters can be modified:
•
The number of records to be recorded (ZTRC-DDL-TRACE-MODIF.ZCNT). If
ZCNT contains 0, the current record count is retained. Otherwise, the record count is
set to the new value. If the new record count is less than the number of records
already recorded, the trace stops.
•
The size of the records (ZTRC-DDL-TRACE-MODIF.ZREC-SIZE). If ZREC-
SIZE contains 0, the current record size is retained.
•
The trace options (ZTRC-TKN-OPT). If no OPT token appears in the request, no
options are modified. If OPT tokens are included, all options are reset, and only the
specified options are set.
Any combination of these parameters can be changed using a single TRACE command.
Any parameters not specified retain their current values. A trace can be modified as
many times as your application requires.
Stopping a Trace
Your application can stop a currently executing trace by sending a TRACE command
containing:
In addition, a trace stops automatically if any of these occur:
•
TRACE-MODIF.ZWRAP is FALSE, TRACE-MODIF.ZCOLL is FALSE, and the
extended data segment is full.
•
TRACE-MODIF.ZWRAP is FALSE, TRACE-MODIF.ZCOLL is TRUE, and the
trace-data disk file is full.
•
TRACE-MODIF.ZCOLL is TRUE, and the number of records written to the disk file
is equal to TRACE-MODIF.ZCNT (where ZCNT contains a positive value).
•
TRACE-MODIF.ZCOLL is FALSE, and the number of records written to the
extended memory segment is equal to TRACE-MODIF.ZCNT (where ZCNT
contains a positive value).
•
The collector detects a tracing error.
•
The object being traced can no longer be found.
ZTRC-DDL-TRACE-MODIF.ZSTOP Set to ZSPI-VAL-FALSE (default) or blank.
ZTRC-DDL-TRACE-MODIF.ZFNAME Set to blank.
ZTRC-DDL-TRACE-MODIF.ZSTOP Set to ZSPI-VAL-TRUE