gtpc2mb0C/C++ Language Support User's Guide

cmptr-Prepare to Receive Data

This function changes the conversation from send or send-pending to receive state in preparation to receive data. The execution of this function includes the function of the FLUSH or CONFIRM verb.

Format

#include   <tpfmap.h>
void       cmptr(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 cmptr function. A complete list of the return codes and their definitions can be found in Table 45.

When prepare_to_receive_type is set to CM_PREP_TO_RECEIVE_FLUSH, or prepare_to_receive_type is set to CM_PREP_TO_RECEIVE_SYNC_LEVEL and sync_level is CM_NONE, the possible return codes are:

When prepare_to_receive_type is set to CM_PREP_TO_RECEIVE_CONFIRM, or prepare_to_receive_type is set to CM_PREP_TO_RECEIVE_SYNC_LEVEL and sync_level is CM_CONFIRM, the possible return codes are:

Programming Considerations

Examples

The following example places the conversation in receive state.

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

Related Information