Deferred_Deallocate - Terminating a conversation after termination of a transaction

A CPI-C program uses the Deferred_Deallocate (CMDFDE) call to terminate the conversation
as soon as the current transaction is successfully terminated. The call can be used at any time within a transaction. Deferred_Deallocate serves only to make CPI-C programs more portable. It does not change the state of the program.

CMDFDE (conversation_ID, return_code)

Syntax

CMDFDE (conversation_ID, return_code)

Parameters

--> conversation_ID	Identifier of the conversation to be terminated.
<-- return_code	Result of the function call.

Result (return_code)

CM_OK

The call is OK.

CM_PROGRAM_PARAMETER_CHECK

The value of conversation_ID is invalid.

CM_PROGRAM_STATE_CHECK

The program is in “Start” state.

CM_PRODUCT_SPECIFIC_ERROR

The UPIC instance could not be found.

State change

This call does not change the program state.

Behavior in the event of errors

CM_PROGRAM_PARAMETER_CHECK

Modify program.

CM_PRODUCT_SPECIFIC_ERROR

The operating system cannot provide enough memory for the internal buffers. Check whether the memory requirement of your program is too high and if necessary reboot your system.

CM_PROGRAM_STATE_CHECK

Modify program

Function declaration: Deferred_Deallocate

CM_ENTRY Deferred_Deallocate ( unsigned char CM_PTR conversation_ID,
                              CM_RETURN_CODE CM_PTR return_code)