GDSX Manual

Design and Development
Extended General Device Support (GDSX) Manual–134303
2-78
User-Coded Trace Calls
User-Coded Trace Calls
If there are events that you want to trace that are not included among those for which
TSCODE automatically generates trace records, you can generate trace entries for these
events by calling ADD^TRACE^DATA or ADD^TRACE^DATA^INT at appropriate
places in USCODE. Trace entries generated by these procedure calls are merged with
any trace entries that you specify to be generated by TSCODE.
GDSX uses variable-length trace records, allowing users to define different record
formats for different types of trace entries. The default for the maximum record size is
256 words. You can change the maximum record size by setting the TRACERECSIZE
dynamic configuration parameter (see "GDSX Configuration Parameters" on page 2-42)
or by setting the maximum in a call to USER^OPEN^TRACE^FILE (see Section 8).
Trace entries are differentiated from each other by a trace entry type. Type values from
0–127 are reserved for TSCODE events. Values from 128–255 are used for USCODE
events. Except for these restrictions, use of type, which is a parameter passed in calls to
ADD^TRACE^DATA or ADD^TRACE^DATA^INT, is completely user dependent:
whatever value is assigned to type is be passed through to the trace records.
TASK^WAKED^UP 74 Task awakened—an event occurred
for the task
TASK^OPEN^REQ 75 Task opened
TASK^STOPPED 76 Task stopped
None 77-79 None
NSTCTRL NST^BK^CREATED 80 Backup task created
NST^BK^STOPPED 81 Backup task stopped
NST^BK^LISTENING 82 Backup task received checkpoint
data
NST^BK^TAKEOVER 83 Backup process is taking over
NST^CP^OP 84 Checkpointing operation
NST^Q^CP^OP 85 (Not currently supported)
None 86-87 None
ERRCTRL DEBUG^ERR^MSG 88 Going into DEBUG
INT^ERR^MSG 89 A configuration error or an internal
error (abend) occurred
TRAP^ERR^MSG 90 Trap occurred
None 91-95 None
Table 2-4. TSCODE Trace Classes and Entry Types (page 3 of 3)
SCF Trace
Class Keyword
Literal Name for
Entry Type
Literal
Value Events Traced by TSCODE