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

114 Chapter5
Intrinsic Descriptions
MCRcvNoWait
MCRcvNoWait
Receives any information available for the specified conversation but
does not wait for information to arrive before returning control to the
calling TP.
Syntax
I16V I16 I16
MCRcvNoWait( ResourceID , Length , RequestToSendReceived ,
CA I16 I32
Data , WhatReceived , 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.
Length
Required; 16-bit signed integer by value;
input/output.
Input:
The
Length value that the local TP passes to the
remote TP indicates the maximum amount of data, in
bytes, that the local TP can receive in its
Data
parameter. The Length value must not exceed 4092
bytes. A
Length of 0 means that only control or error
information can be received (no data).
Output:
If data is received (
WhatReceived =
DATA_COMPLETE or DATA_INCOMPLETE), the
Length value that the remote TP returns to the local
TP is the actual length of the data received. If control
information is received (
WhatReceived = SEND,
CONFIRM, CONFIRM_SEND, or
CONFIRM_DEALLOCATE), the remote TP does not
change the value in the
Length parameter, so it
contains whatever was supplied as input.