HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE_AND_WAIT and RECEIVE_AND_WAIT
Data is received in logical-record format. The data received can be any of the following:
• A complete logical record
• A
max_len-byte portion of a logical record
• The end of a logical record
max_len
Maximum number of bytes of data the local TP can receive.
The range for this value is 0–65,535.
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.
WINDOWS
The data buffer can reside in a static data area or in a globally allocated area. The data buffer must
fit entirely
within this area.
4.11.6 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
what_rcvd
Status information received with the incoming data.
The next action taken by the TP will usually depend on the value of this parameter. For more information,
see Section 4.9.2, The what_rcvd Parameter.
Possible values are:
AP_CONFIRM_DEALLOCATE
This value can be returned only in a half-duplex conversation.
The partner TP has issued the [MC_]DEALLOCATE verb with dealloc_type set to AP_SYNC_LEVEL,
and the conversation’s synchronization level, established by the [MC_]ALLOCATE verb, is
AP_CONFIRM_SYNC_LEVEL.
AP_CONFIRM_SEND
This value can be returned only in a half-duplex conversation.
The partner TP has issued the [MC_]PREPARE_TO_RECEIVE verb with ptr_type set
to AP_SYNC_LEVEL, and the conversation’s synchronization level, established by the
[MC_]ALLOCATE verb, is AP_CONFIRM_SYNC_LEVEL.
AP_CONFIRM_WHAT_RECEIVED
This value can be returned only in a half-duplex conversation.
The partner TP has issued the [MC_]CONFIRM verb.
177