Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-167
STOP Procedure
(Superseded by PROCESS_STOP_ Procedure )
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be
used for new development. This procedure is supported only for compatibility with
previous software.
Syntax for TAL Programmers
Parameters
process-id input
INT:ref:4
indicates the process that is to be stopped. At this point, you have two options.
The value you enter can be either:
•
omitted (or zero), meaning “stop myself,” or
•
the 4-word array containing the process ID of the process to be stopped,
where:
[0:2] Process name or creation timestamp
[3].<0:3> Reserved
[3].<4:7> Processor number where the process is executing
[3].<8:15> PIN assigned by the operating system to identify the
process in the processor
If
process-id[0:2] references a process pair and process-id[3] is
specified as -1, then both members of the process pair are stopped.
stop-backup input
INT:value
if specified as 1, the current process’s backup is stopped and STOP is returned to
the caller. The
process-id is not used.
If zero, this parameter is ignored, and the
process-id parameter is used as
described.
CALL STOP ( [ process-id ] ! i
,[ stop-backup ] ! i
,[ error ] ! o
,[ compl-code ] ! i
,[ termination-info ] ! i
,[ spi-ssid ] ! i
,[ length ] ! i
,[ text ] ); ! i