Guardian Procedure Calls Reference Manual

Parameters
process-id
input
INT:ref:4
indicates the process that is to be stopped:
• omitted (or zero), meaning "stop myself," or
• the four-word array containing the process ID of the process to be stopped, where:
Process name or creation timestamp[0:2]
Reserved.<0:3>[3]
Processor number where the process is executing.<4:7>
PIN assigned by the operating system to identify the process in the processor.<8:15>
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' 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.
error
output
INT:ref:1
returns a file-system error number. STOP returns a nonzero value for this parameter only when
it cannot successfully make the request to stop the designated process. If it makes the request
successfully (error is 0), the designated process might or might not be stopped depending
on the stop mode 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 (page 1400).
These 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 STOP only when a process
is stopping itself.
compl-code
input
INT:value
compl-code is the completion code to be returned to the creator process in the STOP system
message and, for a terminating OSS process, in the OSS termination status. Specify this
parameter only if the calling process is abending itself and you want to return a completion
code value other than the default value of 0. For a list of completion codes, see Appendix C:
Completion Codes.
STOP Procedure (Superseded by PROCESS_STOP_ Procedure) 1399