Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-41
RECEIVEINFO Procedure
(Superseded by FILE_GETRECEIVEINFO_
currently queued. To associate a reply with a given request, message-tag is
passed in a parameter to the REPLY procedure. The returned value of
message-
tag is an integer between zero and receive depth -1, inclusive, that is not
currently used 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.
sync-id output
INT(32):ref:1
returns the sync ID associated with this message. If the received message is a
system message, this parameter is valid only if the message is associated with a
specific file open; otherwise this parameter is not applicable and should be
ignored.
filenum output
INT:ref:1
returns the file number of the file in the requesting process associated with this
message. If the received message is a system message that is not associated
with a specific file open, this parameter contains -1.
read-count output
INT:ref:1
returns the number of bytes requested in reply to the message. If the message is
the result of a request made in a call to WRITE[X],
read-count will be 0. If the
message is the result of a request made in a call to WRITEREAD[X],
read-count
is the same as the read count value passed by the requester to WRITEREAD[X].
iotype output
INT:ref:1
returns a value indicating the data operation last performed by the message
sender:
0 Not a data message (system message)
1 Sender called WRITE
2 Sender called READ
3 Sender called WRITEREAD
Condition Code Settings
< (CCL) indicates that $RECEIVE is not open.
= (CCE) indicates that RECEIVEINFO is successful.
> (CCG) does not return from RECEIVEINFO.