Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-47
OPENER_LOST_ Procedure
OPENER_LOST_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
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 );