GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-82
USER^OPEN^TRACE^FILE
indicates the outcome of the call. The value of status is one of the following:
USER^OPEN^TRACE^FILE
This procedure causes TSCODE to allocate an extended segment for a trace file, which
is saved as TRACEP by a primary process or as TRACEB by a backup process. After
the trace file is open, depending on settings of auto^trace^flag of the DEBUGFLAGS
configuration parameter and the trace^control^flags in DCCBDECS, TSCODE
automatically generates trace entries for the file.
You can also generate trace entries by calling ADD^TRACE^DATA or
ADD^TRACE^DATA^INT. Calling USER^CLOSE^TRACE^FILE closes the trace file
and prevents further entries.
status returned value
INT:value
indicates the outcome of the call. The value of status is one of the following:
record-size input
INT:value
specifies the maximum size of each record added to the trace file. The default is 256
words and the maximum is 16,383 words.
segment-size input
INT:value
specifies the number of extent pages. Segment-size must be less than or equal to 64.
The default is 64.
-1 The trace file is already closed
0 Successful close
Note. TSCODE does not generate trace records until the USER^INITIALIZE exit has been
called, so USER^OPEN^TRACE^FILE need not be called until then.
status := USER^OPEN^TRACE^FILE ( [ record-size ] !
i
,[ segment-size ] !
i
,[ record-count ] ); !
i
-1 The trace file could not be opened
0 Successful open
1 The trace file is already open