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

CPI-C Calls

Request_To_Send (cmrts)

Chapter 3214

Request_To_Send (cmrts)

The Request_To_Send call notiﬁes the partner program that the local

program wants to send data.

Action of the Partner Program

In response to this request, the partner program can change the

conversation to Receive state by issuing one of the following calls:

• Receive with

receive_type

set to CM_RECEIVE_AND_WAIT

• Prepare_To_Receive

• Send_Data with

send_type

set to

CM_SEND_AND_PREP_TO_RECEIVE

The partner program can also ignore the request to send.

When the Local Program Can Send Data

The conversation state changes to Send for the local program when the

local program receives one of the following values through the

status_received

parameter of a subsequent Receive call:

• CM_SEND_RECEIVED

• CM_CONFIRM_SEND_RECEIVED and replies with a Conﬁrmed call

Function Call

void cmrts (

unsigned char CM_PTR conversation_ID,

CM_RETURN_CODE CM_PTR return_code

);

Function Call for Java CPI-C

public native void cmrts (

byte[] conversation_ID,

CPICReturnCode return_code

);