Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

PUT_FILE_OPEN_(2) OSS System Calls Reference Manual
not complete until process B opens $RECEIVE. Specifically, the open
by process A completes as follows:
— When process B opens $RECEIVE with file-management sys-
tem messages disabled, a waited open by process A completes
immediately, but a nowait open by process A completes after the
first read of $RECEIVE by process B.
— When process B opens $RECEIVE with file-management sys-
tem messages enabled, the open call by process A completes
when process B reads the open message from A by using
READ[X], or if B uses READUPDATE[X], the open call com-
pletes when process B replies to the open message (by using
REPLY[X]).
Message formats
When $RECEIVE is opened by PUT_FILE_OPEN_(), system messages are
delivered to the caller in D-series format unless messages in C-series format are
requested by setting options bit 14 to 1. (No file-management system messages
are delivered to the caller if options bit 15 is set to 1 when opening $RECEIVE.)
Messages from high-PIN processes
Opening $RECEIVE with PUT_FILE_OPEN_() implies that the caller is capa-
ble of handling messages from processes with PINs greater than 255.
Opening $RECEIVE and being opened by a remote long-named process
A process that has a process name consisting of more than five characters will
fail with an error 20 if it attempts to open a process on a remote node and the
process it attempts to open:
• Used the PUT_FILE_OPEN_() procedure to open $RECEIVE and
requested that C-series format messages be delivered, or
• Used the Guardian OPEN procedure to open $RECEIVE.
Notification of this failure is not sent to the process reading $RECEIVE.
Opening an unconverted (C-series format) 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 pro-
cess 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 PUT_FILE_OPEN_() or the Guardian OPEN procedure, 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. This mes-
sage is also received if the backup process of a process pair performs an open. Therefore, a pro-
cess can expect two of these messages when being opened by a process pair.
You can obtain he process handle of the opener by a subsequent call to
FILE_GETRECEIVEINFO_. For a description of the process open message see the Guardian
Procedure Errors and Messages Manual.
5−210 Hewlett-Packard Company 527186-023