The Silicon Graphics® IRIS® 3270 Emulator products provide a high-speed communications link between an IRIS-4DTM Series workstation and an IBM® host computer running either Virtual Machine/Conversational Monitor System (VM/CMS) or Multiple Virtual Storage/Time Sharing Option (MVS/TSO).
With the IRIS 3270 Emulator, you can use an IRIS-4D workstation or server—with Systems Network Architecture (SNA), Transmission Control Protocol (TCP), or 5080 Graphics System Workstation connectivity—to access your IBM mainframe. The list below shows how the various link types of the IRIS 3270 Emulator product connect to an IBM host.
IRIS 3270 Emulator Product: | Connects to IBM Host through: |
|---|---|
SNA 3270 Emulator | IBM 3705, 3725, or 3745 front end processor |
TCP 3270 Emulator | IBM 8232 Ethernet controller |
3270 for the 5080 Emulator | IRIS Channel Adapter (ICA) |
This document describes how to create High-Level Language Application Program Interface (HLLAPI) applications that interact with IBM host applications using Silicon Graphics' 3270 HLLAPI programming environment and tools. It is organized to provide programming information, including 3270 HLLAPI functionality and troubleshooting.
Chapter 1 explains Silicon Graphics' 3270 HLLAPI programming environment. Chapter 2 discusses troubleshooting using the trace display utility.
 | Note: For information on how to use and configure the IRIS 3270 Emulator, refer to the IRIS 3270 Emulator User's Guide. |
These type conventions and symbols are used in this guide:
| Italics | Filenames, variables, IRIX command arguments, command flags, titles of publications, icon names | |
| Bold | Subroutine names | |
| UPPERCASE | IBM file names, command names and the names of keys used on IBM systems | |
| Screen type | Code examples, file excerpts, and screen displays (including error messages) | |
| Bold Screen type |
| |
| () | (Parentheses) Following IRIX commands, they surround the reference page (man page) section where the command is described | |
| [] | (Brackets) Surrounding optional syntax statement arguments | |
| # | IRIX shell prompt for the superuser (root) |
The IRIS 3270 Emulator software and hardware communicate between the IRIS workstation and an IBM-host system running VM/CMS or MVS/TSO. For information on system requirements, refer to the release notes included with your 3270 emulator product.
The IRIS 3270 Emulator software includes these key files and directories:
| /opt/3270/bin/ | Contains all executable files for 3270 | |
| /opt/3270/chest/ | Contains Toolchest menu files | |
| /opt/3270/font/ | Contains all fonts used by the emulator | |
| /opt/3270/lib | Contains libsgi3270.a, the 3270 HLLAPI link library. | |
| /var/opt/3270/example/ |
| |
| /var/opt/3270/file/ |
| |
| /var/opt/3270/spool/ |
| |
| /var/opt/3270/lib/ |
| |
| /usr/lib/X11/app-defaults/Setup3270 |
|
To use Silicon Graphics' IRISXFR file transfer utility, you must install the IRISXFR program on your IBM host. This software is distributed on a
1/2-inch tape, generated at 1600 bytes per inch (BPI). For information on how to install the host software, refer to the installation instructions included with the IRISXFR distribution.
 | Warning: Do not attempt to add boards or other upgrades in your system. Hardware upgrades should be installed only by Silicon Graphics-certified personnel. Upgrades performed by noncertified persons void your warranty and may damage your system, or cause injury to improperly trained individuals. |
The IRIS workstation running 3270 emulator software can be connected to an IBM host through these network configurations:
a leased line using Synchronous Data Link Control (SDLC) via an IBM 37X5 front end processor
Ethernet, Token Ring, or FDDI using IBM 3172 or equivalent controller
local non-SNA channel attach using the IRIS Channel Adapter (ICA)
The typical IRIS 3270 Emulator hardware configuration includes:
an IBM, or IBM compatible, mainframe computer
an IBM host front-end processor running Network Control Program (NCP)
an IRIS SNA workstation running the IRIS 3270 Emulator software (SNA mode) through an IRIS SNA gateway
an IRIS SNA gateway running the IRIS 3270 Emulator software (SNA mode)
an IRIS Channel Adapter gateway and connections