HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
Deallocate (cmdeal)
Chapter 3 151
Returned Parameters
After the verb executes, SNAplus2 returns parameters to indicate
whether the execution was successful and, if not, to indicate the reason
the execution was unsuccessful.
return_code Possible values are:
CM_OK The call executed successfully, the
conversation is deallocated.
CM_PROGRAM_PARAMETER_CHECK The value specified by
conversation_ID is not valid.
CM_PROGRAM_STATE_CHECK The following state errors
can occur when the deallocate type
indicates a normal deallocation
(CM_DEALLOCATE_SYNC_LEVEL,
CM_DEALLOCATE_FLUSH,
CM_DEALLOCATE_CONFIRM):
• The conversation is not in Send
or Send-Pending state
• The conversation is in Send state,
but the program did not finish
sending a logical record
For an explanation of the following return codes, see
Appendix A, “Common Return Codes.”
CM_OPERATION_INCOMPLETE
CM_OPERATION_NOT_ACCEPTED
CM_PRODUCT_SPECIFIC_ERROR
The following return codes can be returned when the
deallocate type is set to CM_DEALLOCATE_CONFIRM or
when it is set to CM_DEALLOCATE_SYNC_LEVEL and the
conversation's synchronization level is set to
CM_CONFIRM. For an explanation of these return codes,
see Appendix A, “Common Return Codes.”
CM_CONVERSATION_TYPE_MISMATCH
CM_DEALLOCATED_ABEND
CM_DEALLOCATED_ABEND_SVC
CM_DEALLOCATED_ABEND_TIMER
CM_PIP_NOT_SPECIFIED_CORRECTLY
CM_SECURITY_NOT_VALID