Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-108
FILE_GETRECEIVEINFO_ Procedure
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 the
following meanings:
[0:11] Reserved
[12:13] Dialog status. Indicates the last operation performed by the message
sender. Values are:
For more information about the use of Pathsend procedures, Pathsend dialogs,
and the information in this parameter, refer to the
TS/MP Pathsend and Server
Programming Manual.
Considerations
•
Sync ID definition
A sync ID is a doubleword, unsigned integer. Each opened process has its own
sync ID. Sync IDs are not part of the message data; rather, the receiver of a
message obtains the sync ID value associated with a particular message by calling
FILE_GETRECEIVEINFO_. A file’s sync ID is set to 0 when the file is opened and
when the RESETSYNC procedure is called for that file (RESETSYNC can be
called directly or indirectly through the CHECKMONITOR procedure).
When a request is sent to a process (that is, when a process is the object of a
CONTROL, CONTROLBUF, SETMODE, SETPARAM, open, close, read, write, or
WRITEREAD operation), the system increments the requester’s sync ID just prior
0 Context-free server-class send operation.
1 First server-class send operation in a new dialog.
2 Server-class send operation in an existing dialog.
3 Aborted dialog. No further server-class send operations
will be received in this dialog. There is no buffer
associated with this value.
[14] 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 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.
[15] Reserved