Guardian Procedure Calls Reference Manual

STOP Procedure (Superseded by PROCESS_STOP_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
NetBatch Considerations
OSS Considerations
Messages
Examples
Related Programming Manual
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
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' 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. For a description of the process access ID, see the PROCESSACCESSID
procedure Considerations (page 1131) and the Guardian User's Guide.
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.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL STOP ( [ process-id ] ! i
,[ stop-backup ] ! i
,[ error ] ! o
,[ compl-code ] ! i
,[ termination-info ] ! i
,[ spi-ssid ] ! i
,[ length ] ! i
,[ text ] ); ! i
1398 Guardian Procedure Calls (S)