gtpc2mb2C/C++ Language Support User's Guide

cmrts-Request Change to Send State

This function notifies the remote transaction program that the local TPF transaction program is requesting to enter send state for the conversation. The conversation changes to send, send-pending, or confirm-send state when the local TPF program subsequently receives a SEND indication from the remote program.

Format

#include   <tpfmap.h>
void       cmrts(unsigned char *conversation_ID,
                 signed int *return_code);

conversation_ID
This is a pointer to an 8-byte character array that contains the conversation ID. This conversation ID must be the ID returned by the cminit (INITIALIZE) or cmaccp (ACCEPT_CONVERSATION) that started this conversation.

return_code
This is a pointer to a 4-byte field where the return code is to be placed.

Return Codes

The following is a list of return codes that can be returned to the program that called the cmrts function. A complete list of the return codes and their definitions can be found in Table 45.

Programming Considerations

Examples

The following example notifies the remote transaction program that the local transaction program is requesting to enter send state for the conversation.

#include <tpfmap.h>
 
      unsigned char convid[8];
      signed int    rcode;
      .
      .
/* set conversation_ID with value returned from accept or initialize */
      .
      .
cmrts(convid,&rcode);
      .                       /*  normal processing path             */
      .
      .

Related Information