Guardian Procedure Calls Reference Manual

using for dialogs. The server can abort the dialog, by replying with FEEOF, to enforce a level of
transaction control that the requester has not specified.
Reserved.[15]
receive-info2
output
(for FILE_GETRECEIVEINFOL_)INT .EXT:ref:*
is a block of 19 words describing the last message read on the $RECEIVE file. It has this
structure:
I/O type. Indicates the data operation last performed by the message sender. Values are:[0]
Not a data message (system message).0
Sender called WRITE.1
Sender called READ.2
Sender called WRITEREAD.3
File number. The value that identifies the file associated with this message in the requesting process. If
the received message is a system message that is not associated with a specific file open, this field contains
-1.
[1]
Message tag. The value that identifies the request message just read. To associate a reply with a request,
the message tag is passed to the REPLY procedure. The value returned is an integer between zero and
[2]
receive depth - 1, inclusive, that had not been in use as a message tag. When a reply is made, its
associated message tag value is made available for use as a message tag for a subsequent request
message.
Open label. The value assigned by the application (when replying to the open system message) to the
open on which the received message was sent. It is often used to find the open table entry for the message.
If this value is unavailable, -1 is returned.
[3]
Maximum reply count. The maximum number of bytes of data that can be returned by REPLY. (as determined
by the read count of the sender).
[4:5]
Sync ID. The sync ID associated with this message. If the received message is a system message, this
field is valid only if the message is associated with a specific file open; otherwise this field is not applicable
and should be ignored. See Considerations.
[6:7]
Sender process handle. The process handle of the process that sent the last message. For system messages
other than the open, close, CONTROL, SETMODE, SETPARAM, RESETSYNC, or CONTROLBUF messages,
the null process handle (-1 in each word) is returned.
[8:17]
dialog-info. It is 0 if no dialog is active. For information about dialog-info, see the dialog-info
parameter of the FILE_GETRECEIVEINFO[L]_ Procedures (page 443).
[18]
Returned Value
INT
A file-system error code that indicates the outcome of the call.
FEOK0
A successful operation.
FENOTOPEN16
File not open.
FEBOUNDSERR22
Bounds error.
FILE_GETRECEIVEINFO[L]_ Procedures 445