HP-UX TN3270 Users Guide, March 1998

Table Of Contents

Chapter 3 95

Getting Started with 3270 Emulation

Running HLLAPI Programs

During 3270 emulation, you can run programs that use the HLLAPI

application program interface. These programs enable you to simulate

the actions of a 3270 user by entering data and handling data received

from the host. For example, you can use a HLLAPI program to log on to a

3270 host automatically.

To run a HLLAPI program, follow these steps:

Step 1. Start the TN3270 emulation program as explained in “Starting the

TN3270 Emulation Program”. Either use a style ﬁle that includes a

session with the session ID used by the HLLAPI program, or specify the

session ID when starting the TN3270 emulation program.

Step 2. Check that the session with this session ID is active. For more

information, see Chapter 4, “Controlling 3270 Emulation.”

Step 3. Switch to the 3270 session and log on to the host, unless the HLLAPI

program performs these actions automatically.

Step 4. Move to another terminal, or use the TEMPEXIT keystroke to exit to

another HP-UX shell, and start the HLLAPI program. Use the same

HP-UX login ID to run the HLLAPI program as you used to start the

TN3270 emulation program; the two programs must run with the same

effective user ID.

Alternatively, if you are using a HLLAPI application that performs all

necessary interaction with the host and does not require any operator

input, you can start the TN3270 emulation program in the background

(see “Running 3270 Emulation in the Background”) and then run the

HLLAPI application. You still must use a 3270 session with a session ID

that matches the session ID used by the HLLAPI application.

If the TN3270 conﬁguration enables you to have multiple 3270 sessions

active, you can access more than one session using the same HLLAPI

program or different HLLAPI programs.

For details on writing HLLAPI programs, refer to the HP-UX SNAplus2

3270 & TN3270 HLLAPI Programmers Guide.