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

Chapter 5 117
Intrinsic Descriptions
MCRcvNoWait
1. MCRcvNoWait can be called only from Receive state. Unlike
MCRcvAndWait, it cannot be used to change the conversation state
of the local TP from Send state to Receive state.
2. Unlike MCRcvAndWait, which waits for information from the remote
before returning control to the calling TP, MCRcvNoWait does not
wait for information to arrive. It checks to see if any information is
available in the receive buffer, and if the buffer is empty, it returns a
status info value of +38 (Not Posted) and returns control to the TP.
3. The MCRcvNoWait intrinsic can receive a maximum of 4092 bytes in
a single intrinsic call. The MCRcvAndWait intrinsic can receive 4092
bytes on MPE V, or 32763 bytes on MPE XL, in a single intrinsic call.
MCRcvNoWait may not be used in conjunction with posting. Posting ends
as soon as MCRcvNoWait is called. For more information on posting, see
the description of MCPostOnRcpt, earlier in this chapter.
When logical records sent by the remote processor are larger than 4092
bytes, the local TP must call MCRcvNoWait more than once to receive
each record.
NOTE If the local TP will be receiving data records larger than 4092 bytes, it
must allocate more than one location for storing data. Data received in
the
Data parameter during the first call to MCRcvNoWait will be
overwritten during the second call unless it is moved to another
location.
Status Info Values
0 Successful Completion.
-1 Intrinsic called with parameter out of bounds.
-2 Invalid 'ResourceID' parameter specified in intrinsic call.
-11 Out of range 'Length' parameter specified in intrinsic call.
-13 Data buffer specified in intrinsic call is out of bounds.
-20 Not enough stack space for intrinsic to run.
+38 Not Posted.
-40 Intrinsic called in invalid state.
-50 Allocation Error.
-51 Resource Failure: Retry possible.
-52 Resource Failure: No retry possible.
-56 Program Error: No data truncation has occurred.
-60 Program Error: Data may have been purged.
-90 An internal error in Presentation Services has occurred.
-91 An internal error in the APPC subsystem has occurred.
+100 Deallocate Normal received from the remote TP.
-1002 An internal error at the mapped conversation level has occurred.
-1003 Required parameter missing.
-1020 Deallocate Abend.
-1050 Invalid 'Data' parameter specified in intrinsic call.
-1105 Internal Error: Conversation deallocated.