HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_DEALLOCATE and DEALLOCATE
The callback routine is defined as follows:
void (*AP_CALLBACK) (
void * vcb,
unsigned char tp_id[8],
AP_UINT32 conv_id,
AP_UINT16 type,
AP_CORR corr
);
typedef union ap_corr {
void * corr_p;
AP_UINT32 corr_l;
AP_INT32 corr_i;
} AP_CORR;
SNAplus2 calls the routine with the following parameters:
vcb
Pointer to the original [MC_]DEALLOCATE VCB supplied by the application. If the application needs to
use the VCB parameters in the callback routine, it should not free or reuse the memory associated with the
VCB until the callback routine has been called.
tp_id
The 8-byte TP identifier of the TP in which the verb was issued.
conv_id
The conversation identifier of the conversation in which the verb was issued. The application cannot issue
further verbs using this conversation identifier, because it is no longer valid after the [MC_]DEALLOCATE
verb has completed.
type
The type of message flow that SNAplus2 is reporting. Possible values are:
AP_DATA_FLOW
Normal data flow on the session.
AP_UNBIND
The session ended normally.
AP_FAILURE
The session ended abnormally. The Syncpoint manager may need to perform resynchronization.
corr
The correlator value supplied by the application. This value enables the application to correlate the returned
information with its other processing.
The callback routine need not use all of these parameters. It can perform all the necessary processing on the returned
VCB, or it can simply set a variable to inform the main program that the notification has been received.
The application can issue further APPC verbs from within the callback routine, if required. However, these must be
asynchronous verbs. Any synchronous verbs issued from within a callback routine will be rejected with the return
codes
AP_PARAMETER_CHECK and AP_SYNC_NOT_ALLOWED.
139