Guardian Procedure Calls Reference Manual

PROCESS_STOP_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
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
#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 ] );
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.
Syntax for TAL Programmers
error := PROCESS_STOP_ [ ( [ processhandle ] ! i
,[ specifier ] ! i
,[ options ] ! i
,[ completion-code ] ! i
,[ termination-info ] ! i
,[ spi-ssid ] ! i
,[ text:length ] ) ]; ! i:i
PROCESS_STOP_ Procedure 1121