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

118 Chapter5
Intrinsic Descriptions
MCReqToSend
MCReqToSend
Notifies the remote TP that the local TP wants to enter Send state.
Syntax
I16V I32
MCReqToSend( ResourceID , Status );
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.
Description
The MCReqToSend intrinsic can be called from either Receive state or
Confirm state. It does not cause a state change; it requests that the
remote TP, which is in Send state and therefore controls the
conversation, enter Receive state and place the local TP in Send state.
After calling MCReqToSend, the local TP must call MCRcvAndWait or
MCRcvNoWait to find out whether the remote TP performed the
requested state change. If the state change was successful, the
WhatReceived parameter of the MCRcvAndWait or MCRcvNoWait
intrinsic will return 4 (SEND). See the descriptions of MCRcvAndWait
and MCRcvNoWait, earlier in this chapter.
Status Info Values
0 Successful Completion.
-1 Intrinsic called with parameter out of bounds.
-2 Invalid 'ResourceID' parameter specified in intrinsic call.
-20 Not enough stack space for intrinsic to run.
-40 Intrinsic called in invalid state.
-51 Resource failure: No retry possible.
-52 Resource failure: Retry possible.
-90 An internal error in Presentation Services has occurred.
-91 An internal error in the APPC subsystem has occurred.
-1002 An internal error at the mapped conversation level has occurred.
-1003 Required parameter missing.