LU 6.2 API Application Programmer's Reference Guide (30294-90008)

106 Chapter5
Intrinsic Descriptions
MCPrepToRcv
MCPrepToRcv
Changes the conversation state of the local TP from Send to Receive,
and changes the conversation state of the remote TP from Receive to
Send.
Syntax
I16V I32 I16V I16V
MCPrepToRcv(
ResourceID
,
Status
, [
PrepToRcvType
], [
Locks
]);
Parameters
ResourceID
Required; 16-bit signed integer by value; input. This is
the unique resource ID number assigned to this
conversation when it was allocated. See MCAllocate or
MCGetAllocate, in this chapter, for more information.
Status
Required; 32-bit signed integer; output. Indicates the
result of intrinsic execution. See the “Status
Parameter” section, earlier in this chapter, for more
information.
PrepToRcvType
16-bit signed integer by value; input. The type of
MCPrepToRcv to be executed. Possible values are as
follows:
0 = CONVERSATION_SYNC_LEVEL
Denotes that the MCPrepToRcv intrinsic will be
executed with the synchronization level specified by the
SyncLevel
parameter of the MCAllocate or
MCGetAllocate intrinsic. The
SyncLevel
parameter
can specify synchronization levels of CONFIRM and
NONE.
If the conversation was allocated with a
SyncLevel
of
CONFIRM, then MCPrepToRcv is executed as if
CONFIRM were given as the
MCPrepToRcvType
. See
the discussion of CONFIRM
MCPrepToRcvType
= 2).
If the conversation was allocated with a
SyncLevel
of
NONE, then MCPrepToRcv is executed as if FLUSH
were given as the
MCPrepToRcvType
. See the discussion
of FLUSH (
MCPrepToRcvType
= 1).