Previous Page Contents Page Next Page

1 Understanding SNAP-IX TN3270

This chapter provides an overview of the SNAP-IX TN3270 product and describes the responsibilities of the SNAP-IX TN3270 administrator. The administrator is responsible for installing, configuring, and managing the SNAP-IX TN3270 software.

1.1 What Is SNAP-IX TN3270?

SNAP-IX TN3270 is a software product that enables Solaris computer terminals to connect over a TCP/IP network and emulate 3270 terminals connected to a host computer. Two versions of the TN3270 program, with different user interfaces, are available: a character-based version that runs on standard text terminals and a Motif graphical user interface.

The SNAP-IX TN3270 program can connect directly to a host computer that supports TN3270 access over TCP/IP or to a communications product that provides the TN Server function. The standard SNAP-IX product provides the TN Server function; therefore, the TN3270 programs can access a host over the SNA communications links provided by SNAP-IX.

You can configure the TN3270 program to grant different user permissions for the following options:

Each user's copy of the TN3270 program can access up to ten TN3270 sessions to the same host or to different hosts.

For information about using the SNAP-IX TN3270 software, refer to the SNAP-IX TN3270 User's Guide.

1.1.1 SNAP-IX TN3270 Features

SNAP-IX TN3270 provides the following additional features:

3179G emulation

The Motif 3179G emulation program emulates an IBM 3179G Color Graphics Display Station to provide access to graphical host applications. The 3179G emulation program is based on the Motif TN3270 emulation program and offers the same features.

For information about using 3179G emulation, refer to the SNAP-IX TN3270 User's Guide.

HLLAPI support

The high level language application program interface (HLLAPI) enables you to develop application programs that communicate with the SNAP-IX TN3270 program to perform tasks, such as entering data and searching the screen for specific messages, that are normally done by a TN3270 user. Using this API enables you to automate frequently used TN3270 emulation tasks, such as host application startup.

For more information about the functions provided by HLLAPI, refer to the SNAP-IX HLLAPI Programmer's Guide.

TN3270 style files

The TN3270 program enables you to customize TN3270 emulation parameters such as color mappings, Solaris terminal keys used to represent host 3270 keys, and HLLAPI session IDs for TN3270 sessions. The details of this customization are stored in a style file that is loaded when the TN3270 program is started. You can set up a standard style for all your TN3270 users, or you can allow users to customize these settings individually and create their own style files.

Configuration file

A single configuration file contains the following details of your TN3270 configuration:

  • Host computers you want to access

  • TN3270 emulation functions available to individual TN3270 users

  • Files used to record TN3270 diagnostics information

You can create and modify the configuration file as a simple text file using any standard ASCII text editor, such as vi. The TN3270 tncfgtcp program validates the configuration and generates a binary configuration file for use by TN3270 components.

Diagnostics support

The following log and trace files can help you diagnose TN3270 errors, events, and system problems:

Error log file

A single file that contains a record of any errors that TN3270 detects. The name of this file is specified in the configuration file.

Audit log file

A single file that contains a record of all significant system events. The name of this file, and the level of detail recorded in it, are specified in the configuration file.

Trace files

One or more optional trace files record the data transferred between the TN3270 program and the host, or between a HLLAPI application and the TN3270 program. You can use these files to help you debug specific problems. Tracing is normally disabled because it degrades system performance.

All these files are simple text files; you can view them with any ASCII text editor, such as vi.

1.1.2 TN3270 Features Supported

The SNAP-IX TN3270 product supports both the standard TN3270 features and the extended TN3270E features that are described in the Internet RFCs listed in Related Publications. TN3270E supports all the standard TN3270 features and the following additional features:

  • LU type 1 and LU type 3 printing

  • Access to specific display and printer LUs

  • Access to printer LUs associated with display LUs

  • Access to the SSCP-LU session

  • Support for the ATTN and SYSREQ keys

  • Negotiation of which enhancements to use on each connection

The TN3270E features are supported only if the host, or the intermediate communications product that provides the TN Server function, also supports the TN3270E features. When the connection is established, the host or the intermediate communications product negotiates with the TN3270 product to determine the level of support.

You can configure the level of support that you desire for the TN3270 product by specifying a value for the tn3270_support field in the host record. You can determine the level of support that was negotiated by looking at the Control Display Sessions dialog box or the Control Printer Sessions dialog box. For more information about these dialog boxes, refer to the SNAP-IX TN3270 User's Guide.

SNAP-IX TN3270 does not provide support for the following functions that are described in the various RFCs that are supported:

  • The device type IBM-DYNAMIC. The device type that corresponds to the configured display model is used instead.

  • Keep-alive messages, although it does respond to them. If a TCP/IP connection is lost, the loss is detected when the user presses a key that causes data to be sent to the host.

  • The SYSREQ key on non-TN3270E connections.

  • Renegotiation of device type, LU, or TN3270E functions on a connection that is already open.

Previous Page Contents Page Top of Page Next page