gtpc2maw | C/C++ Language Support User's Guide |
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.
- CM_OK
- CM_PRODUCT_SPECIFIC_ERROR
- CM_PROGRAM_PARAMETER_CHECK -- The specified conversation_ID
is invalid.
Programming Considerations
- You can execute this function on any I-stream.
- The conversation can be in any state.
- The value supplied in conversation_ID must be the conversation ID
returned by the cmaccp or cminit function.
- This function does not change the partner_LU_name or
partner_LU_name_length characteristics.
- If return_code is not CM_OK, partner_LU_name returns no
information.
- If return_code is not CM_OK, partner_LU_name_length does
not return a meaningful value.
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