Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-4
ABEND Procedure
(Superseded by PROCESS_STOP_ Procedure )
designated process. If it makes the request successfully (error is 0), the
designated process might or might not be stopped depending on the stopmode of
the process and the authority of the caller. (The stop mode of the process can be
changed; hence, a stop request that has inadequate authority to stop the process
is saved by the system and might succeed at a later time.) See “Considerations.”
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 have
meaning in the call to ABEND only when a process is stopping itself.
compl-code input
INT:value
is the completion code to be returned to the creator process in the ABEND system
message and, for a terminating OSS process, in the OSS 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 5. Refer to
Appendix C, Completion Codes
for a list of completion codes.
termination-info input
INT:value
can be provided as an option by the calling process if it is a subsystem process
that defines Subsystem Programmatic Interface (SPI) error numbers. If supplied,
this parameter should be the SPI error number that identifies the error that caused
the process to stop itself. For more information on the SPI error numbers and
subsystem IDs, refer to the
SPI Programming Manual. If termination-info is
not specified, this field is zero.
spi-ssid input
INT .EXT:ref:6
is a subsystem ID (SSID) that identifies the subsystem defining
termination-
info
. The format and use of the SSID is described in the SPI Programming
Manual.
length input
INT:value
is the length in bytes of
text. The maximum length is 80 bytes.
text input
STRING .EXT:ref:*
is an optional string of ASCII text to be sent in the ABEND system message.