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

CPI-C Calls
Request_To_Send (cmrts)
Chapter 3 215
Supplied Parameters
The supplied parameter is:
conversation_ID This is the identifier for the conversation. The value of
this parameter was returned by the
Initialize_Conversation, Initialize_For_Incoming, or
Accept_Conversation call.
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 The value specified by
conversation_ID is not valid.
CM_PROGRAM_STATE_CHECK The conversation is not in
Receive, Send, Send-Pending,
Confirm, Confirm-Send, or
Confirm-Deallocate state.
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
State When Issued
The conversation can be in any of the following states: Receive, Send,
Send-Pending, Confirm, Confirm-Send, Confirm-Deallocate, or
Pending-Post.
State Change
There is no state change.