gtpc2mawC/C++ Language Support User's Guide

cmepln-Extract the Partner LU Name

This function returns the current value of the partner_LU_name and partner_LU_name_length characteristics.

Format

#include   <tpfmap.h>
void       cmepln(unsigned char *conversation_ID,
                  unsigned char *partner_LU_name,
                  signed int *partner_LU_name_length,
                  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.

partner_LU_name
This is a pointer to an array of characters where the fully qualified partner LU name for this conversation will be placed. The string must allow for as many as 17 characters. On return, the string contains the name of the LU's network, followed by a period, followed by the partner LU name. If there is no period, the entire string is the LU name. Trailing blanks are compressed. The previous contents of the string are overwritten.

partner_LU_name_length
This is a pointer to a 4-byte field where the length of the mode name will be placed. Trailing blanks are not included.

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

Return Codes

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

Programming Considerations

Examples

The following example gets the partner LU name for the conversation.

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

Related Information