HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_DEALLOCATE and DEALLOCATE
Specifies how to perform the deallocation. The possible values are listed below.
Using AP_ABEND or any of the AP_ABEND_* values deallocates the conversation abnormally. If the
conversation is in Send state when the local TP issues the [MC_]DEALLOCATE verb, APPC sends the
contents of the local LU’s send buffer to the partner TP before deallocating the conversation. If the
conversation is in Receive or Pending-Post state, APPC purges any incoming data before deallocating the
conversation.
AP_ABEND
This value is valid only for the MC_DEALLOCATE verb. A TP should specify AP_ABEND when it
encounters an error preventing the successful completion of a transaction.
AP_ABEND_PROG
This value is valid only for the DEALLOCATE verb. An application or service TP should specify
AP_ABEND_PROG when it encounters an error preventing the successful completion of a transaction.
AP_ABEND_SVC
A service TP should specify AP_ABEND_SVC when it encounters an error caused by its partner service
TP (for example, a format error in control information sent by the partner service TP).
AP_ABEND_TIMER
A service TP should specify AP_ABEND_TIMER when it encounters an error requiring immediate
deallocation (for example an operator ending the program prematurely).
AP_FLUSH
Sends the contents of the local LU’s send buffer to the partner TP before deallocating the conversation.
This value is allowed only if the conversation is in Send or Send_Pending state.
AP_CONFIRM_TYPE
Use this value only if the conversation’s synchronization level is AP_SYNCPT. It indicates that confirma-
tion from the partner TP (but not syncpoint processing) is required before deallocating the conversation.
APPC sends the contents of the local LU’s send buffer and a confirmation request to the partner TP.
Upon receiving confirmation from the partner TP, APPC deallocates the conversation. If, however, the
partner TP reports an error, the conversation remains allocated.
AP_SYNC_LEVEL
Uses the conversation’s synchronization level (established by the [MC_]ALLOCATE verb) to determine
how to deallocate the conversation. This value is allowed only if the conversation is in Send or
Send_Pending state.
If the synchronization level of the conversation is AP_NONE, APPC sends the contents of the local
LU’s send buffer to the partner TP before deallocating the conversation.
If the synchronization level is AP_CONFIRM_SYNC_LEVEL, APPC sends the contents of the local
LU’s send buffer and a confirmation request to the partner TP. Upon receiving confirmation from
the partner TP, APPC deallocates the conversation. If, however, the partner TP reports an error, the
conversation remains allocated.
UNIX
If the synchronization level of the conversation is AP_SYNCPT, APPC sends the contents of the local
LU’s send buffer to the partner TP before deallocating the conversation. The Syncpoint Manager is
responsible for the following:
• Intercepting the [MC_]DEALLOCATE verb when a dealloc_type of AP_SYNC_LEVEL is specified
• Performing the required syncpoint processing
132