HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE_IMMEDIATE and RECEIVE_IMMEDIATE
rts_rcvd
Request-to-send-received indicator. This parameter applies only in a half-duplex conversation; it is not used
in a full-duplex conversation.
Possible values are:
AP_YES
The partner TP has issued the [MC_]REQUEST_TO_SEND verb, which requests that the local TP
change the conversation to Receive state.
AP_NO
The partner TP has not issued the [MC_]REQUEST_TO_SEND verb.
For an explanation of why this indicator can be received by RECEIVE verbs, see Section 4.14,
MC_REQUEST_TO_SEND and REQUEST_TO_SEND.
expd_rcvd
Expedited data indicator.
Possible values are:
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
This parameter is only used if the what_rcvd parameter indicates that data was received.
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.
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:
191