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

Writing CPI-C Applications

Specifying the Local LU

Chapter 290

Specifying the Local LU

The local LU that an invoking CPI-C TP uses can be speciﬁed in a

number of ways which are described below.

NOTE The local LU for an invoked TP is not speciﬁed like this, but is deﬁned by

the partner LU value speciﬁed in the allocate request.

If the LU speciﬁed is a dependent LU, multiple concurrent conversations

are not supported (because dependent LUs cannot support multiple

sessions).

The different ways that you can set the local LU alias are described in

the following sections. The methods are listed in order of precedence.

This means that, if you specify a local LU alias using the ﬁrst method,

the CPI-C library uses this name and ignores any alias that you specify

using the second or later methods. If you do not use the ﬁrst method but

specify a local LU alias using the second method, the CPI-C library uses

this alias and ignores any alias that you specify using the third or later

methods, and so on.

Set_Local_LU_Name

The program can issue this call to specify the local LU alias after the

Initialize_Conversation call has completed. This call only affects the TP

from which it is issued. It does not modify the side information stored in

the conﬁguration ﬁle.

NOTE This call is not part of the standard CPI-C speciﬁcation, and may not be

available in other implementations. You may want to avoid using this

function, or to restrict it to a few speciﬁc routines which can be modiﬁed

easily, if you need to ensure that your application can be used with other

CPI-C implementations.