Guardian Procedure Calls Reference Manual

OPENER_LOST_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The OPENER_LOST_ procedure examines a system message and searches an open table to
determine if an opener has been lost. An opener might be lost due to a processor or system failure
that is reported in the system message.
An opener is a process that has opened the process that is calling OPENER_LOST_. An open table
is a table that describes the opens (or openers) of the caller; it is created and maintained by the
caller. See Considerations, later in this subsection, for the description of an open table.
When a process receives a system message on $RECEIVE, it can call OPENER_LOST_ to determine
if the message indicates that an opener has been lost. If OPENER_LOST_ finds that an opener has
been lost, it deletes the table entry for that opener and returns the table index of the entry. The
returned table index can be supplied to OPENER_LOST_ in a subsequent call, along with the same
system message, to search for additional lost openers.
Syntax for C Programmers
#include <cextdecs(OPENER_LOST_)>
short OPENER_LOST_ ( char *message
,short length
,short *table
,short *index
,short number-of-entries
,short entry-size );
Syntax for TAL Programmers
status := OPENER_LOST_ ( message:length ! i:i
,table ! i
,index ! i,o
,number-of-entries ! i
,entry-size ); ! i
Parameters
message:length
input:input
STRING .EXT:ref:*, INT:value
is the status-change system message that was received. message must be exactly length
bytes long. Relevant messages include:
Local processor failure.-2
Network status change.-8
OPENER_LOST_ Procedure 921