Guardian Procedure Calls Reference Manual

Parameters
receive-info
output
(for FILE_GETRECEIVEINFO_)INT .EXT:ref:17
is a block of 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
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).
[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.
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.
[3]
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 (page 446).
[4:15]
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.
[6:15]
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.
[16]
dialog-info
output
INT .EXT:ref:1
is used by context-sensitive Pathway servers. The dialog-info parameter returns dialog
information about the server-class send operation that was initiated by a requester with a
Pathsend procedure call. The bits of dialog-info have these meanings:
Reserved.[0:11]
Dialog status. Indicates the last operation performed by the message sender. Values are:[12:13]
Context-free server-class send operation.0
First server-class send operation in a new dialog.1
Server-class send operation in an existing dialog.2
Aborted dialog. No further server-class send operations will be received in this dialog. There
is no buffer associated with this value.
3
A copy of the flags.<14> parameter bit in the requester’s call to the Pathsend
SERVERCLASS_DIALOG_BEGIN_ procedure. This bit identifies the transaction model the requester is
[14]
444 Guardian Procedure Calls (F)