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

104 Chapter5
Intrinsic Descriptions
MCPostOnRcpt
MCPostOnRcpt
Allows the LU to check the contents of the receive buffer for the
specified conversation.
Syntax
I16V I16V CA I32
MCPostOnRcpt( ResourceID , Length , Data , 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. This
parameter specifies the minimum amount of data (in
bytes) that must be received in the receive buffer before
the TP is to be notified. If the logical record length is
less than the number specified in this parameter, the
TP will be notified when a complete logical record is
received. A value of 0 or 1 in this parameter indicates
that the TP is to be notified when any amount of data is
received. The value of
Length may not exceed 4092
bytes.
Data Required; character array; input. This is the character
array into which data will be received after it arrives in
the receive buffer. Its length must be greater than or
equal to the
Length parameter.
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 MCPostOnRcpt intrinsic causes LU 6.2 API to set up resources to
check the contents of the receive buffer for the specified conversation.
The MCTest or MCWait intrinsic can then be called to interrogate these
resources and find out if any data has arrived for the conversation. See
the descriptions of MCTest and MCWait, later in this chapter.
Once MCPostOnRcpt has executed successfully, posting is active. It
remains active until something is received into the receive buffer or an