SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-56
MC-DEALLOCATE Verb
DE-TYPE
The type of deallocation used is dependent on the state and synchronization level of
the conversation. The following symbols are defined in the SNAX/APC DDL
definitions:
MC-DE-SYNC-LEVEL (SL)
If the synchronization level is CONFIRM, the action is the same as for
APC-DEALLOCATE-CONFIRM (CO).
If the synchronization level is NONE, the action is the same as for
APC-DEALLOCATE-FLUSH (FL).
If the synchronization level is SYNCPT, the request is rejected with error
RCD-IMPROPER-SYNCLEVEL-PARAM.
MC-DE-CONFIRM (CO)
Confirmation is requested from the remote TP. If confirmation is successful, the
conversation is terminated normally (with an MC-DEALLOCATE return code
of OK). If the CONFIRM is not successful and the return code is PROGRAM-
ERROR-PURGING, the conversation enters the Receive state; otherwise, the
conversation enters the DEALLOCATE state. The TP must be in the Send state
to issue a CONFIRM level MC-DEALLOCATE verb request.
MC-DE-FLUSH (FL)
Flush the transmission buffer and terminate the conversation normally. The TP
must be in the Send state to issue a MC-DEALLOCATE FLUSH verb request.
MC-DE-ABEND-PROG (AP)
Flush the transmission buffer and terminate the conversation abnormally.
ATP can use this type of deallocation when it is in either the Send or Receive
state. Using deallocate in the Send state could cause record truncation; using it
in the Receive state could cause the data to be purged.
MC-DE-LOCAL (LO)
Deallocate the conversation locally (release the local resources). This type of
deallocation can be used only when the conversation is in the DEALLOCATE
state. A TP must prepare to enter the DEALLOCATE state when it receives any
of the following codes in the REP-RETURN-CODE field of a verb reply:
RC-DEALLOCATE-NORMAL
RC-DEALLOCATE-ABEND-PROG (remote)
RC-RESOURCE-FAIL-NO-RETRY
RC-RESOURCE-FAIL-RETRY
RC-ALLOCATION-ERROR with RCD-ALLOC-FAIL-NO-RETRY
RC-ALLOCATION-ERROR with RCD-ALLOC-FAIL-RETRY
Note. If a TP issues a MC-DEALLOCATE CONFIRM request and its sync
level is NONE, SNAX/APC rejects the request.