HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE_AND_POST and RECEIVE_AND_POST
primary_rc
New state
AP_CONV_FAILURE_RETRY
AP_CONV_FAILURE_NO_RETRY
AP_DEALLOC_ABEND
AP_DEALLOC_ABEND_PROG
AP_DEALLOC_ABEND_SVC
AP_DEALLOC_ABEND_TIMER
AP_DEALLOC_NORMAL
Reset
AP_PROG_ERROR_PURGING
AP_PROG_ERROR_NO_TRUNC
AP_SVC_ERROR_PURGING
AP_SVC_ERROR_NO_TRUNC
AP_PROG_ERROR_TRUNC
AP_SVC_ERROR_TRUNC
Receive
AP_CANCELLED
The conversation returns to the state (Send or
Receive) in which the
[MC_]RECEIVE_AND_POST verb was issued.
Since the
AP_CANCELLED
return code is caused by
another verb issued by the same TP, the
conversation state will then change again when this
later verb completes.
4.10.9 Usage Notes
This section provides additional usage information about the following topics:
• PS Header data
• Callback routine
• Processing while the verb is pending
• Compatibility with other APPC implementations
• How the TP uses the verb
• Avoiding indefinite waits
PS Header Data
In a conversation with a synchronization level of AP_SYNCPT, the received data may be in PS Header format. In
a mapped conversation, this is indicated by the value of the what_rcvd parameter; in a basic conversation, this is
indicated by an LL field of 0x0001 (see Section 2.11.1, Logical Records for more information). The Syncpoint
Manager is responsible for converting the data into the appropriate Syncpoint commands.
Callback Routine
UNIX
The application supplies a pointer to a callback routine as one of the parameters to the VCB. This section describes
how SNAplus2 uses this routine, and the functions that it must perform.
The callback routine is defined as follows:
void (*callback) (
void * vcb,
unsigned char tp_id[8],
AP_UINT32 conv_id
);
SNAplus2 calls the routine with the following parameters:
171