GDSX (Extended General Device Support) Manual

Service Routines

Extended General Device Support (GDSX) Manual—529931-001

8-83

^UNLOCKREC

This procedure unlocks a record currently locked by the task.

The syntax, condition code settings, and considerations regarding this procedure are

the same as the counterpart in the Guardian Procedure Calls Reference Manual.

USER^CLOSE^TRACE^FILE

This procedure causes TSCODE to close the trace file in extended memory. After the

trace file is closed, TSCODE does not generate trace entries for the file, and USCODE

is not allowed to generate trace entries for the file by calls to ADD^TRACE^DATA or

ADD^TRACE^DATA^INT.

status returned value

INT:value

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

status := USER^CLOSE^TRACE^FILE

-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 ] !

,[ segment-size ] !

,[ record-count ] ); !