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

CPI-C Calls
Set_Deallocate_Type (cmsdt)
Chapter 3254
by the Initialize_Conversation call
and can be overridden by the
Set_Sync_Level call.
If the synchronization level of the
conversation is set to the default,
CM_NONE, the contents of the local
LU's send buffer are sent to the
partner program and the
conversation is deallocated normally.
If the synchronization level of the
conversation is CM_CONFIRM, the
contents of the local LU's send buffer
and a request to confirm the
deallocation are sent to the partner
program. This request for
deallocation confirmation is sent by
Deallocate call, or by the Send_Data
call with the send type set to
CM_SEND_AND_DEALLOCATE.
The conversation is deallocated
normally when the partner program
issues the Confirmed call, responding
to the confirmation request.
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.
CM_PROGRAM_PARAMETER_CHECK One of the following
has occurred:
The value specified by
conversation_ID
or
deallocate_type
is not valid