SNAX/APC Application Programming Manual

Application Prototype Simulator
SNAX/APC Application Programming Manual—138786
4-20
DEALLOCATE (F3)
AP
specifies a DEALLOCATE ABEND-PROG request. The contents of the
SNAX/APC buffer are sent to the partner TP and the conversation is terminated
abnormally. APS can use this type of deallocation request when it is in either
the Send or Receive state. Using it in the Send state could cause record
truncation, but using it in the Receive state could cause loss of data.
CO
specifies a DEALLOCATE (CONFIRM) request. Confirmation is requested
from the partner TP. If the request is confirmed, the conversation is terminated
normally (with a DEALLOCATE return code of OK). If the request is not
confirmed, the return code will indicate the new state of the conversation. The
TP must be in the Send state to issue a DEALLOCATE (CONFIRM) request.
Note that if a TP issues a DEALLOCATE (CONFIRM) request and its
synchronization level is NONE, SNAX/APC rejects the request.
FL
specifies a DEALLOCATE (FLUSH) request. The contents of the SNAX/APC
buffer are sent to the partner TP, and the conversation is terminated normally.
APS must be in Send state to issue a DEALLOCATE (FLUSH) request.
LO
specifies a DEALLOCATE (LOCAL) request. The conversation is deallocated
locally, which releases local resources. This type of deallocation request can
only be used when the conversation is in the Deallocate state. A TP enters the
Deallocate state when it receives any of the following values in the reply Header
Return Code:
Deallocate Normal
Deallocate Abend Prog (for REP-RETURN-CODE-DETAIL value “0”)
Resource Fail No Retry
Resource Fail Retry
Allocation Error
If APS receives CONFIRM-DEALLOCATE, it enters the Confirm state. Once
the local TP issues the CONFIRMED verb, it enters the Deallocate state and can
issue a DEALLOCATE (LOCAL) request.
SL
specifies a DEALLOCATE (SYNC-LEVEL) request. If the synchronization
level is SYNCPT, the DEALLOCATE will be rejected. If the synchronization
level is CONFIRM, confirmation is requested from the partner TP. If
confirmation is successful, the conversation is terminated normally (with a
DEALLOCATE return code of OK). If the confirmation is not successful, the
return code indicates the new state of the conversation. APS must be in Send
state to issue a DEALLOCATE (SYNC-LEVEL) verb request.