Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-196
PROCESS_STOP_ Procedure
PROCESS_STOP_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
NetBatch Considerations
Safeguard Considerations
OSS Considerations
Examples
Related Programming Manual
Summary
The PROCESS_STOP_ procedure deletes a process or process pair. When this
procedure is used to delete a Guardian process or an OSS process, a process deletion
system message is sent to the mom of the process and to any other process that is
entitled to receive the message. When this procedure is used to delete an OSS
process, a SIGCHLD signal and the OSS process termination status are sent to the
OSS caller.
A process can use PROCESS_STOP_ to:
•
Delete itself
•
Delete its backup
•
Delete another process
Syntax for C Programmers
The parameter length specifies the length in bytes of the character string pointed to
by
text. The parameters text and length must either both be supplied or both be
absent.
#include <cextdecs(PROCESS_STOP_)>
short PROCESS_STOP_ ( [ short *processhandle ]
,[ short specifier ]
,[ short options ]
,[ short completion-code ]
,[ short termination-info ]
,[ short *spi-ssid ]
,[ const char *text ]
,[ short length ] );