LU 6.2 API Application Programmer's Reference Guide (30294-90008)

Chapter 5 87
Intrinsic Descriptions
MCDeallocate
2 = ABEND
Allows the conversation to deallocate in any state
except Deallocate state. All buffers are flushed. If the
conversation is in Receive state, loss of data can occur.
5 = LOCAL
Deallocates the conversation from Deallocate state.
6 = CONFIRM
Causes an internal execution of the MCConfirm
intrinsic. The remote TP must respond with positive
confirmation before the conversation can be
deallocated. This DeallocateType can be used only if
the synchronization level of the conversation is
CONFIRM. The conversation must be in Send state to
use a
DeallocateType of CONFIRM.
Default: 0 (CONVERSATION_SYNC_LEVEL) Note
that the default cannot be used in all cases, because the
conversation must be in Send state to use a
DeallocateType of CONVERSATION_SYNC_LEVEL.
Status
Required; 32-bit signed integer; output. Indicates the
result of intrinsic execution. See the “Status
Parameter” section, earlier in this chapter, for more
information.
Description
The MCDeallocate intrinsic releases the resources used for a
conversation. Before the TPEnded intrinsic can be called to stop the TP,
MCDeallocate must be called for each conversation the TP is engaged
in.
MCDeallocate with
DeallocateType of ABEND ends posting. See the
MCPostOnRcpt intrinsic description, later in this chapter, for more
information about posting.
A TP in Deallocate state calls MCDeallocate with a
DeallocateType of
LOCAL. Unless there is an error, a
DeallocateType of LOCAL is used
when the remote TP deallocates first. Figure 5-2 shows the remote TP
deallocating a conversation. When the remote calls the equivalent of
MCDeallocate, the local TP is placed in Deallocate state. From
Deallocate state, the local TP deallocates its side of the conversation
with a
DeallocateType of LOCAL.