HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_DEALLOCATE and DEALLOCATE
This value indicates that the local TP is deallocating the conversation because it did not accept the
security parameters specified by the partner TP on [MC_]ALLOCATE. The error will be reported to
the partner TP with the return codes
AP_ALLOCATION_FAILURE
and
AP_SECURITY_NOT_VALID.
log_dlen
Number of bytes of data to be sent to the error log file. The range for this value is 0–32,767.
This parameter is used only by the DEALLOCATE verb, with the dealloc_type parameter set to
AP_ABEND_PGM, AP_ABEND_SVC,orAP_ABEND_TIMER. For MC_DEALLOCATE, or for other values
of dealloc_type, this parameter must be 0 (zero).
log_dptr
Address of data buffer containing error information. This data is sent to the local error log and to the partner
LU.
This parameter is used by the DEALLOCATE verb if log_dlen is greater than 0 (zero); otherwise it is reserved.
The TP must format the error data as a General Data Stream (GDS) error log variable. For further
information, refer to the IBM publication Systems Network Architecture Format and Protocol Reference
Manual: Architecture Logic for LU Type 6.2.
WINDOWS
The log data buffer can reside in a static data area or in a globally allocated area. The data buffer must
fit
entirely within this area.
UNIX
The following parameters are used if the conversation’s synchronization level is AP_SYNCPT; they are reserved
otherwise.
callback
If the TP requires “implied forget” notification, this parameter specifies a pointer to a callback routine that
SNAplus2 will call to provide this notification. If the TP does not require this notification, it does not use
this parameter. For more information, see Section 4.5.9, Implied Forget Notification.
correlator
An optional correlator for use by the application. This parameter is used only if the callback parameter is
specified; it is reserved otherwise.
SNAplus2 does not use this value, but passes it as a parameter to the callback routine with the
“implied
forget” notification. This value enables the application to correlate the returned information with its other
processing.
4.5.6 Returned Parameters
After the verb executes, APPC returns parameters to indicate whether the execution was successful and, if not, to
indicate the reason the execution was not successful.
Successful Execution
If the verb executes successfully, APPC returns the following parameter:
primary_rc
134