HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls

Specify_Local_TP_Name (cmsltp)

Chapter 3294

Specify_Local_TP_Name (cmsltp)

The Specify_Local_TP_Name call is issued by a CPI-C application to

specify a local TP name for which it will accept incoming Allocate

requests.

Instead of using this call, you can set the local TP name in other ways

such as by using the APPCTPN environment variable. For more

information about setting the local TP name, see “Specifying the Local

TP Name” in Chapter 2. The Specify_Local_TP_Name call is required

only when a single application wishes to accept incoming Allocates for

more than one local TP name; it can use APPCTPN for one name, but must

use this call to specify additional names. (After issuing the

Accept_Conversation or Accept_Incoming call to accept an incoming

Allocate request, it can use Extract_TP_Name to determine which of the

names was speciﬁed by the partner application.)

This call functions differently from Set_TP_Name. Set_TP_Name is

issued by the invoking program, to specify the name of the program it

wants to allocate a conversation with; Specify_Local_TP_Name is issued

by the invoked program, to specify a name for which it will accept

incoming Allocate requests.

Function Call

void cmsltp (

unsigned char CM_PTR TP_name,

CM_INT32 CM_PTR TP_name_length,

CM_RETURN_CODE CM_PTR return_code

);

Function Call for Java CPI-C

public native void cmsltp (

byte[] TP_name,

CPICLength TP_name_length,

CPICReturnCode return_code

);

Supplied Parameters

The supplied parameters are: