HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE_AND_POST and RECEIVE_AND_POST
AP_YES
The partner TP has sent expedited data that the local TP has not yet received. To receive this data, the
local TP can use the [MC_]RECEIVE_EXPEDITED_DATA verb.
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
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. This parameter is only used if the what_rcvd parameter indicates
that data was received.
Conversation Deallocated
If the partner TP has deallocated the conversation without requesting confirmation, APPC returns the following
parameters:
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
dlen
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. This parameter is only used if rtn_status was set to AP_YES.
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.
Parameter Check
If the verb does not execute because of a parameter error, APPC returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_BAD_CONV_ID
The value of conv_id did not match a conversation identifier assigned by APPC.
AP_BAD_RETURN_STATUS_WITH_DATA
The rtn_status parameter was set to a value that was not valid.
AP_BAD_TP_ID
The value of tp_id did not match a TP identifier assigned by APPC.
AP_INVALID_FORMAT
The reserved field format was set to a nonzero value.
AP_SYNC_NOT_ALLOWED
167