HP-UX SNAplus2 R7 LUA Programmer's Guide

Designing and Writing LUA Applications

HP-UX Environment Considerations

2.6 Conﬁguration Information

The SNAplus2 conﬁguration ﬁle, which is set up and maintained by the System Administrator, contains information

that is required for LUA applications to communicate. For additional information, refer to the HP-UX SNAplus2

Administration Guide.

UNIX

For a Primary RUI application communicating with a downstream LU, the only conﬁguration required is the

downstream LU (or a Downstream PU template).

The following components must be conﬁgured for use with an LUA application communicating with a host:

2.6.1 Data Link Control (DLC), Port, and Link Station (LS)

The communications components that SNAplus2 uses to communicate with the remote host computer.

2.6.2 LU

An LU of type 0–3, with an LU number that matches that of a suitable LU on the host.

2.6.3 LU Pool (Optional)

If required, you can conﬁgure more than one LU for use by the application, and group the LUs into a pool. This

means that an application can specify the pool rather than a speciﬁc LU when attempting to start a session, and

will be assigned the ﬁrst available LU from the pool.

An LUA application indicates to SNAplus2 that it wants to start a session by issuing an RUI_INIT or SLI_OPEN

verb with an LU name. This name must match the name of an LU of type 0–3, or of an LU pool, in the conﬁgu-

ration ﬁle. SNAplus2 uses this name as follows:

• If the name supplied is the name of an LU that is not in a pool, a session will be assigned using that LU if it

is available (that is, if it is not already in use by a program).

• If the name supplied is the name of an LU pool, or the name of any LU within the pool, a session will be

assigned using the named LU, if it is available, or otherwise the ﬁrst available LU in the pool. The RUI_INIT or

SLI_OPEN verb returns the name of the actual LU assigned (which may not be the same as the name speciﬁed).

The application can then use this returned LU name on subsequent LUA verbs to identify the session.

2.7 HP-UX Environment Considerations

UNIX

This section summarizes processing considerations of which you must be aware when developing LUA applications

on a HP-UX computer.

2.7.1 LUA Header File

The header ﬁle to be used with LUA applications is /usr/include/sna/lua_c.h. This ﬁle contains the

deﬁnitions of the LUA entry points and the LUA VCBs. It also includes the common interface header ﬁle /