Guardian Procedure Calls Reference Manual

CHILD_LOST_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The CHILD_LOST_ procedure examines a system message to determine whether it indicates that a
specified process or process pair has been lost.
When a process receives a system message on $RECEIVE, it can call CHILD_LOST_ to determine
whether the message contains information indicating that a particular process has been deleted
or has been lost due to a processor or system failure. CHILD_LOST_ reports a loss if any of these
are true:
• The connection to a remote system has been lost and the specified process was running in
that system.
• A local or remote processor has failed and the specified process was running in that processor.
• A process deletion message has been received for the specified unnamed process, for the
specified single named process, or for the entire named process pair of which the specified
process is a member.
Syntax for C Programmers
#include <cextdecs(CHILD_LOST_ )>
short CHILD_LOST_ ( char *message
,short length
,short *processhandle );
Syntax for TAL Programmers
status := CHILD_LOST_ ( message:length ! i:i
,processhandle ); ! i
Parameters
message:length
input:input
STRING .EXT:ref:*, INT:value
is the status-change message that was received. The message must be exactly length bytes
long. Relevant messages are:
Local processor down.-2
Process deletion (stop).-5
Process deletion (abend).-6
Network status change.-8
166 Guardian Procedure Calls (C)