gtpc2maqC/C++ Language Support User's Guide

cmallc-Allocate a Conversation

This function establishes a conversation with the partner program specified by the TP_name and partner_LU_name characteristics. This function establishes only mapped conversations.

Format

#include   <tpfmap.h>
void       cmallc(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 assigned on the previous cminit (INITIALIZE) for 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 cmallc function. A complete list of the return codes and their definitions can be found in Table 45.

Programming Considerations

Examples

The following example allocates a conversation.

#include <tpfmap.h>
 
      unsigned char convid[8];
      signed int    rcode;
      .
      .
      .
cmallc(convid,&rcode,);
      .
      .
      .

Related Information