Appendix B. Editing the Emulator Configuration File

This appendix provides information on 3270 configuration parameters so you can edit the configuration file to change emulator settings if you are using an ASCII terminal. Observe these guidelines when entering a configuration parameter:

The IRIS 3270 Emulator operates in several modes, as SNA, TCP, or 5080. The operational mode is determined by the LINK = [SNA, TCP, 5080] parameter in the /var/opt/3270/lib/t3279rc.$LOGNAME configuration file, where $LOGNAME is your login ID. You must have this file on the system running the IRIS 3270 Emulator for the software to function properly. To create a new configuration file, copy /var/opt/3270/lib/t3279rc.default and rename the default extension to your login ID name.

The sections that follow address the parameters that must be changed to establish one of these particular configurations: SNA, TCP, or 5080 link type, and Silicon Graphics IRISXFR file transfer support.

Parameter Descriptions

This section describes the /var/opt/3270/lib/t3279rc.$LOGNAME configuration file parameters. Some parameters are specific to particular link modes or file transfer operations.

Link Type

LINK=[SNA,TCP,5080]

This parameter specifies the Silicon Graphics host interface to which the 3270 emulator is connected.

SNA 

The IRIS 3270 Emulator is attached to an IBM host via the IRIS SNA SERVER gateway. An IBM control unit is not needed. The workstation running the IRIS 3270 Emulator may be connected to the SNA SERVER gateway through Ethernet.

TCP 

The IRIS 3270 Emulator is attached via Ethernet to an IBM host.

5080 

The IRIS 3270 Emulator is attached to an IBM host via the IRIS Channel Adapter. This mode emulates an IBM 3270 terminal session using the IRIS Channel Adapter.

Character Set

CHAR_SET=[FRENCH, GERMAN, ITALIAN, KATAKANA, PORTUGUESE, SPANISH, SWEDISH, UK_ENGLISH, US_ENGLISH]

This parameter defines the national character set used for keyboard input and display. There is no default character set.

Point Size

POINT_SIZE=[9,11,13,15]

This parameter defines the point size of window characters. Keep in mind that the font size changes the size of the emulation window.

For example, if you are using a 1024x1280 IRIS graphics terminal, models 2, 3, 4, and 5 fit on the screen with point size 9; models 2, 3, and 4 fit on the screen with point size 11; models 2 and 3 fit on the screen with point size 13; and model 2 fits on the screen with point size 15.

If you are using a 768x1024 IRIS graphics terminal, models 2, 3, and 4 fit on the screen with point sizes 9 and 11.

Trace

TRACE=[0,1]

This parameter turns the 3270 Trace option on and off. The values are:

0 

This is the default value. No trace is generated when trace=zero.

1 

Records the 3270 Presentation Space (PS), the status line, keyboard input, Silicon Graphics Message Mode data, and IBM structured fields.

Cursor Type

CURSOR_TYPE=[0,1]

This parameter determines the style of cursor. The values are:

0 

Block cursor

1 

Underline cursor (default)

SNA Parameters

These parameters are used only with SNA link types.

Gateway

SNA_GATEWAY=hostname

This parameter specifies the TCP host name of the SNA gateway workstation. If the SNA gateway is the same workstation running the IRIS 3270 Emulator, comment out this parameter by placing a pound sign (#) at column 1.

TCP Parameters

These parameters are used only with TCP link types.

TCP Host

TCP_HOST=hostname or IP_address

This parameter can be the TCP name for the IBM host or the IP address.

TCP Port

TCP_PORT=portnumber

This parameter is the TCP port number for 3270 full-screen emulation on the IBM host. The default port number is 23.

TCP Model

TCP_MODEL=tcp_model

This parameter determines the terminal model emulated if LINK=TCP. Possible values are: 3278-2, 3278-3, 3278-4, 3278-5, 3279-2, 3279-3, 3279-4, 3279-5, 3279-2-E, 3279-3-E, 3279-4-E, and 3279-5-E.

5080 Parameters

These parameters are used only with 5080 link types.

5080 Gateway

5080_GATEWAY=hostname

This parameter specifies the 5080 host name of the 5080 gateway workstation.

5080 Address

5080_ADDRESS=0-0xffff

This parameter determines the channel address for the 3270 session, if specified.

5080 Model

5080_MODEL=[2,3,4,5]

This parameter determines the terminal model emulated if LINK=5080.

Required SNA Parameters

To emulate an SNA 3270 terminal, you must define these parameters:

LINK=SNA
CHAR_SET=[FRENCH, GERMAN, ITALIAN, KATAKANA, PORTUGUESE, SPANISH, SWEDISH, UK_ENGLISH,US_ENGLISH]
SNA_GATEWAY=hostname
POINT_SIZE=[9, 11, 13 15]
TRACE=[0,1]

Required TCP Parameters

To emulate a TCP 3270 terminal, you must define these parameters:

LINK=TCP
CHAR_SET=[FRENCH, GERMAN, ITALIAN, KATAKANA, PORTUGUESE, SPANISH, SWEDISH, UK_ENGLISH, US_ENGLISH]
TCP_HOST=hostname
TCP_PORT=portnumber
TCP_MODEL=[2, 3, 4, 5] 
POINT_SIZE=[9, 11, 13, 15] 
TRACE=[0,1] 

Required 5080 Parameters

To emulate a 3270 terminal for the 5080, you must define these parameters:

LINK=5080
CHAR_SET=[FRENCH, GERMAN, ITALIAN, KATAKANA, PORTUGUESE, SPANISH, SWEDISH, UK_ENGLISH, US_ENGLISH]
5080_GATEWAY=hostname
5080_MODEL=[2, 3, 4, 5] 
POINT_SIZE=[9, 11, 13, 15] 
TRACE=[0,1]