Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-27
OPEN Procedure (Superseded by FILE_OPEN_
Procedure )
•
Opening high-PIN processes
The OPEN procedure cannot be used to open a high-PIN unnamed process
because the process ID cannot fit into the process file name; FILE_OPEN_ must
be used instead. However the OPEN procedure can be used on high-PIN named
processes, devices, and files on high-PIN volumes.
•
Opening an unconverted (C-series) process from a high-PIN process.
A high-PIN process cannot open an unconverted process unless the unconverted
process has the HIGHREQUESTERS object-file attribute set. If a high-PIN
process attempts to open a low-PIN process that does not have this attribute set,
file-system error 560 occurs.
•
Opening $RECEIVE and being opened by a remote long-named process
If a process uses the OPEN procedure to open $RECEIVE (or if it uses the
FILE_OPEN_ procedure to open $RECEIVE and requests that C-series format
messages be delivered), then a subsequent open of that process (using either
OPEN or FILE_OPEN_) by another process on a remote node that has a process
name consisting of more than five characters will fail with an error 20.
Message
The process open system message is received by a process when it is opened by
another process. The 4-word process ID of the opener can be obtained in a
subsequent call to FILE_GETRECEIVEINFO_ , LASTRECEIVE, or RECEIVEINFO.
Refer to the
Guardian Procedure Errors and Messages Manual for a description and
the form of this message and all system messages.
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).
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.