Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-198
PROCESS_STOP_ Procedure
options input
INT:value
specifies whether the process is being stopped because of a normal or abnormal
condition. Valid values are:
<0:14> Reserved (specify 0)
<15> 0 Normal termination (STOP)
1 Abnormal termination (ABEND)
The default is 0.
The following parameters supply completion-code information, which consists of
four items: the completion code, a numeric field for additional termination
information, a subsystem identifier in SPI format, and an ASCII text string. These
items apply only when the caller is terminating itself.
completion-code input
INT:value
is the completion code to be returned in the process deletion system message and,
for a terminating OSS process, in the OSS process termination status. Specify this
parameter only if the calling process is terminating itself and you want to return a
completion code value other than the default value of 0 (STOP) or 5 (ABEND).
A nonprivileged caller cannot pass a negative value for
completion-code.
Refer to Appendix C, Completion Codes
for a list of completion codes.
termination-info input
INT:value
specifies the Subsystem Programmatic Interface (SPI) error number that identifies
what caused the process to stop itself. For more information on SPI error numbers
and subsystem IDs, refer to the
Distributed Systems Management (DSM)
Programming Manual. If termination-info is not specified, the default is 0.
If
termination-info is specified, spi-ssid and text:length should be
supplied.
spi-ssid input
INT .EXT:ref:6
is a subsystem ID (SSID) that identifies the subsystem defining the
termination-info. The format and use of the SSID is described in the
Distributed Systems Management (DSM) Programming Manual.