HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE_EXPEDITED_DATA and RECEIVE_EXPEDITED_DATA
The value of this parameter was returned by the TP_STARTED verb in the invoking TP or by RE-
CEIVE_ALLOCATE in the invoked TP.
conv_id
Conversation identifier.
The value of this parameter was returned by the [MC_]ALLOCATE verb in the invoking TP or by
RECEIVE_ALLOCATE in the invoked TP.
rtn_ctl
Indicates when the verb should return control to the TP if no expedited data is available at the time it is
issued. Possible values are:
AP_IMMEDIATE
If no expedited data is available, the verb returns immediately with a return code indicating this.
AP_WHEN_EXPD_RCVD
If no expedited data is available, the verb waits for data to arrive. It may wait indefinitely if the partner
TP does not send any expedited data.
max_len
Maximum number of bytes of data the local TP can receive.
The range for this value is
0–86.
This value must not exceed the length of the buffer to contain the received data.
dptr
Address of the buffer to contain the data received by the local LU.
4.13.4 Returned Parameters
After the verb executes, APPC returns parameters to indicate whether the execution was successful and, if not, to
indicate the reason the execution was not successful.
Successful Execution
If the verb executes successfully, APPC returns the following parameters:
primary_rc
AP_OK
expd_rcvd
Expedited data indicator.
Possible values are:
AP_YES
The partner TP has sent further expedited data that the local TP has not yet received, in
addition to the data returned on this verb. To receive this data, the local TP can issue the
[MC_]RECEIVE_EXPEDITED_DATA verb again.
This indicator can be set on a number of APPC verbs. It continues to be set on subsequent verbs until
the local TP issues the [MC_]RECEIVE_EXPEDITED_DATA verb to receive the data.
AP_NO
There is no expedited data waiting to be received.
dlen
197