GDSX (Extended General Device Support) Manual

Design and Development
Extended General Device Support (GDSX) Manual—529931-001
2-88
Modifying the Trace
Opening the Trace File
When the trace facility is turned on in the primary GDSX process without using SCF,
TSCODE allocates an extended segment with segment ID 1025, a default size of 64
pages, and the default file name TRACEP in the subvolume where GDSX is running.
The SCF TRACE command can be used to turn on the trace and specify a different file
name (in which case the file will be created in the subvolume where SCF is running),
and the TSCODE-supported USER^OPEN^TRACE^FILE procedure can be used to
specify a different file size.
When the trace facility is turned on in the backup process without using SCF, TSCODE
allocates an extended segment with segment ID 1025, a default size of 64 pages, and
the file name TRACEB in the subvolume where GDSX is running.
If the specified trace file does not exist, the GDSX process creates and uses the file. If
the default subvolume already has a file with the name specified and the file has not
been opened by another process, the GDSX process opens the file and writes over the
old data. If the specified trace file is in use by any other process, the GDSX process
will not initiate the trace.
Modifying the Trace
During the tracing of a GDSX process, records are added to the trace file until the end
of file is reached. When the end of the file is reached, the trace records wrap to
replace the oldest records in the file, except for the file header. The default for the
maximum number of records that can be generated for the TRACE file before the
Table 2-7. Events Traced by USAMPLE
SCF Trace
Class Keyword
Equivalent
trace^control^flags
DEFINE USCODE Events Traced by USAMPLE
TERMREQ TERM^REQ^TRACE Traces terminal requests
TERMDATA TERM^DATA^TRACE Traces terminal data
TERMINTL TERM^INTR^TRACE Traces internal activities within a
DEVICE^HANDLER task
LINEREQ LINE^REQ^TRACE Traces line requests
LINEDATA LINE^DATA^TRACE Traces line data
LINEINTL LINE^INTR^TRACE Traces internal activities within a
LINE^HANDLER task
SRCB SR^CB^TRACE Traces USCODE control block resources
SRPOOL SR^POOL^TRACE Traces USCODE pool resources
SRCTRL SR^CTRL^TRACE Traces USCODE controls
SRMISC SR^MISC^TRACE Traces miscellaneous requests from USCODE
USCODE USCODE^TRACE Traces all the above USCODE events