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

CPI-C Calls
Confirm (cmcfm)
Chapter 3136
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.
request_to_send_received This is the request-to-send-received
indicator. Possible values are:
CM_REQ_TO_SEND_RECEIVED The partner program has
issued the Request_To_Send call,
which requests the local program to
change the conversation to Receive
state.
CM_REQ_TO_SEND_NOT_RECEIVED The partner program
has not issued the Request_To_Send
call.
This value is not relevant if the return_code
parameter is set to one of the following:
• CM_PROGRAM_PARAMETER_CHECK
• CM_PROGRAM_STATE_CHECK
return_code Possible values are:
CM_OK The call executed successfully. The
partner program has issued the
Confirmed call.
CM_PROGRAM_PARAMETER_CHECK One of the following
has occurred:
• The value specified by
conversation_ID is not valid.
• The local program attempted to
use the Confirm call in a
conversation with a
synchronization level of CM_NONE.
The synchronization level must
be CM_CONFIRM.
CM_PROGRAM_STATE_CHECK One of the following has
occurred: