Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-166
STOP Procedure
(Superseded by PROCESS_STOP_ Procedure )
STOP Procedure
(Superseded by PROCESS_STOP_ Procedure
)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
NetBatch Considerations
Messages
OSS Considerations
Examples
Related Programming Manual
Summary
The STOP procedure deletes a process or process pair and indicates that the deletion
was caused by a normal condition. When this procedure is used to delete a Guardian
process or an OSS process, a STOP system message is sent to the deleted process’s
creator. When this procedure is used to delete an OSS process, a
SIGCHLD signal
and the OSS process termination status are sent to the OSS parent.
STOP can be used by a process to:
•
Delete itself
•
Delete its own backup
•
Delete another process
When the STOP procedure is used to delete a Guardian process, the caller must either
have the same process access ID as the process it is attempting to stop, be the group
manager of the process access ID, or be the super ID. See the “Considerations” under
the PROCESSACCESSID procedure and to the
Guardian User’s Guide for a
description of process access ID.
When STOP is used on an OSS process, the same security rules apply as when using
the OSS
kill() function.
When STOP executes, all open files associated with the deleted process are
automatically closed. If a process had BREAK enabled, BREAK is disabled.
Note. This procedure is supported for compatibility with previous software and should not be
used for new development.