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

86 Chapter5
Intrinsic Descriptions
MCDeallocate
MCDeallocate
Deallocates the specified conversation.
Syntax
I16V I16V I32
MCDeallocate( ResourceID , [ DeallocateType ], Status );
Parameters
ResourceID
Required; 16-bit signed integer by value; input. This is
the unique resource ID number assigned to this
conversation when it was allocated. See MCAllocate or
MCGetAllocate, in this chapter, for more information.
DeallocateType
16-bit signed integer by value; input. The type of
deallocation to be performed. Possible values are as
follows:
0 = CONVERSATION_SYNC_LEVEL
Denotes that the conversation should be deallocated
with the synchronization level specified by the
SyncLevel parameter of the MCAllocate or
MCGetAllocate intrinsic. The
SyncLevel parameter
can specify synchronization levels of CONFIRM and
NONE.
If the conversation was allocated with a
SyncLevel of
CONFIRM, then the conversation is deallocated as if
CONFIRM were given as the
DeallocateType . See the
discussion of CONFIRM (
DeallocateType = 6).
If the conversation was allocated with a
SyncLevel of
NONE, then the conversation is deallocated as if
FLUSH were given as the
DeallocateType . See the
discussion of FLUSH (
DeallocateType = 1).
1 = FLUSH
Causes the local LU to empty its send buffer and
release the conversation resources normally. The
conversation must be in Send state to use a
DeallocateType of FLUSH. A DeallocateType of
FLUSH may be specified no matter what the
synchronization level of the conversation is.