GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-81
^TERMINATE
^TERMINATE
This procedure stops the primary and backup GDSX processes without waiting for
outstanding task I/Os from or to external openers to be completed and without waiting
for external openers to be closed.
When this procedure is called, all active LINEs and SUs are queried to determine
whether they have external openers. If no external openers exist, the primary and
backup GDSX processes are stopped after an EMS event message is generated
indicating that the GDSX process was terminated by you. The message is as follows:
STATUS *1005* GDS USER TERMINATED
If there are external openers when this procedure is called, an error 66 is returned to all
the openers, indicating that the “device“ has been downed. Then the preceding EMS
message is generated, and the primary and backup GDSX processes are stopped.
Considerations
•
A call to ^TERMINATE is the same as issuing the SCF STOP command with an
exclamation point:
STOP PROCESS $GDSX-process-name !
•
A call to ^SHUTDOWN is the same as issuing the following SCF STOP command:
STOP PROCESS $GDSX-process-name
^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
CALL ^TERMINATE
status := USER^CLOSE^TRACE^FILE