CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-39
CRE_Receive_Read_
INT Dialog^Flags; ! See following description
END; ! CRE^sender^model
Dialog^Flags is used by context-sensitive Pathway servers. It provides
dialog information about the server-class send operation that a requestor
initiated by means of a Pathsend procedure call.
The bits of
Dialog^Flags have the following meanings:
<0:11> Reserved
<12:13> Dialog status. Indicates the last operation performed by the
message sender. Values are:
0 Context-free server-class send operation.
1 First server-class end 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> This is 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.
<15> Reserved
For more information about the use of Pathsend procedures, Pathsend dialogs,
and the
Dialog^Flags field, see the NonStop TS/MP Pathsend and Server
Programming Manual.
flags
if present, is the “any requesters” flag setting if an end-of-file is encountered (no
messages are waiting in $RECEIVE or the requester is waiting for an open
request). If
flags is not present, its value is treated as zero.
Using CRE_Receive_Read_
CRE_Receive_Read_ reads messages from $RECEIVE by calling the READUPDATE
system procedure. If your program specifies Receive^depth equals one when it calls
CRE_Receive_Open_Close_ and a received message requires a reply,
CRE_Receive_Read_ calls CRE_Receive_Write_ to reply automatically to the
message. If your program specifies Receive^depth greater than one, but the CRE’s
table of unreplied messages is full, CRE_Receive_Read_ returns error 74 (the number
of READUPDATEs without replies exceeds the Receive^depth specified) to the
process that called your process.