Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-128
FILE_OPEN_ Procedure
process attempts to open a low-PIN process that does not have this attribute set,
the high-PIN process receives file-system error 560.
System Message
When a process is opened by either FILE_OPEN_ or OPEN, it receives a process
open message (unless it specified when opening $RECEIVE that it wants no
messages). This message is in D-series format (message -103) or in C-series format
(message -30), depending on what the receiving process specified when it opened
$RECEIVE. The process handle of the opener can be obtained by a subsequent call
to FILE_GETRECEIVEINFO_. Refer to the
Guardian Procedure Errors and Messages
Manual for a description of the process open message.
DEFINE Considerations
•
The filename or pathname parameter can be a DEFINE name; FILE_OPEN_
uses the file name given by the DEFINE as the name of the object to be opened. If
you specify a CLASS TAPE DEFINE without the DEVICE attribute, the system
selects the tape drive to be opened. A CLASS TAPE DEFINE has other effects
when supplied to FILE_OPEN_; see Appendix E, DEFINEs
for further information
about DEFINEs.
•
If a supplied DEFINE name is a valid name but no such DEFINE exists, the
procedure returns an error 198 (missing DEFINE).
•
When performing a backup open of a file originally opened through the use of a
DEFINE,
filename must contain the same DEFINE name. The DEFINE must
exist and must have the same value as when the primary open was performed.
Safeguard Considerations
For information on files protected by Safeguard, refer to the Safeguard Reference
Manual.
OSS Considerations
•
To open an OSS file by its pathname, set options.<10> to 1 and specify the
pathname parameter.
•
OSS files can be opened only with shared exclusion mode.
Example
error := FILE_OPEN_ ( file^name:length, file^num );
Note. This message is also received if the backup process of a process pair performs an
open. Therefore, a process can expect two of these messages when being opened by a
process pair.