HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE_EXPEDITED_DATA and RECEIVE_EXPEDITED_DATA
Number of bytes of data received (the data is stored in the buffer specified by the dptr parameter). A length
of
0
(zero) indicates that no data was received.
Any data received is unformatted, and does not contain a two-byte length field (LL).
No Data Available
If the rtn_ctl parameter was set to AP_IMMEDIATE and no expedited data was available, APPC returns the following
parameter:
primary_rc
AP_UNSUCCESSFUL
Conversation Deallocated
If the partner TP has deallocated the conversation, APPC returns one of the following values:
primary_rc
AP_DEALLOC_NORMAL
The partner TP issued the [MC_]DEALLOCATE verb with dealloc_type set to one of the following:
• AP_FLUSH
• AP_SYNC_LEVEL with the synchronization level of the conversation specified as AP_NONE
primary_rc
AP_CONVERSATION_ENDED
This verb was issued as a non-blocking verb and was queued behind an earlier verb. The partner TP
issued the [MC_]DEALLOCATE verb as for
AP_DEALLOC_NORMAL above, and the first verb in the
queue returned with primary_rc set to
AP_DEALLOC_NORMAL, indicating the end of the conversation.
Any subsequent verbs in the queue then return with primary_rc set to
AP_CONVERSATION_ENDED,
indicating that the conversation had already ended before the verb could be processed.
Unsuccessful Execution
If the verb does not execute successfully, APPC returns a primary return code parameter to indicate the type of
error and a secondary return code parameter to provide specific details about the reason for unsuccessful execution.
Expedited Data Not Supported
If the verb does not execute because the remote LU does not support expedited data, APPC returns the following
parameter:
primary_rc
AP_EXPD_NOT_SUPPORTED_BY_LU
Data Buffer Too Small
If the verb does not execute because the TP’s data buffer is too small to contain all of the available expedited data,
APPC returns the following parameter:
primary_rc
AP_BUFFER_TOO_SMALL
dlen
Number of bytes of expedited data available at the LU.
Parameter Check
If the verb does not execute because of a parameter error, APPC returns the following parameters:
primary_rc
198