Guardian Procedure Calls Reference Manual

on a remote node that has a process name consisting of more than five characters will fail
with an error 20.
DEFINE Considerations
The file-name parameter can be a DEFINE name; OPEN will use the file name given by the
DEFINE as the object to be opened. If a CLASS TAPE DEFINE without the DEVICE attribute is
referenced, a specific tape drive will be selected. A DEFINE of CLASS TAPE has other effects when
supplied to OPEN; see Appendix E: DEFINEs for further information about DEFINEs.
If no DEFINE exists for the specified DEFINE name, the procedure returns error 198 (missing
DEFINE).
Safeguard Considerations
For information on files protected by Safeguard, see the Safeguard Reference Manual.
OSS Considerations
This procedure operates only on Guardian objects. If an OSS file is specified, error 1163 is
returned.
Messages
The process open system message is received by a process when it is opened by another process.
The four-word process ID of the opener can be obtained in a subsequent call to
FILE_GETRECEIVEINFO_, LASTRECEIVE, or RECEIVEINFO. For a description and the form of this
message and all system messages, see the Guardian Procedure Errors and Messages Manual.
NOTE: This message is also received if the backup process of a process pair performs the open.
Therefore, a process can expect two of these messages when being opened by a process pair.
Example
The file in the following call has these defaults; wait I/O, exclusion mode (shared), access mode
(read/write), sync depth (0):
CALL OPEN ( FILE^NAME , FILE^NUM );
Related Programming Manuals
For programming information about the OPEN procedure, see the Enscribe Programmer's Guide.
OPEN Procedure (Superseded by FILE_OPEN_ Procedure) 907