After you install the 3270 Emulator on your workstation for the first time, you need to set certain configuration options before you start the emulator and connect to the IBM host system. Follow these steps:
Run the setup3270 program. See the section, “Starting setup3270.”
Set the appropriate character set. See the section “Changing the Character Set.”
Choose a link type (SNA, TCP, or 5080). See the section “Choosing a Link Type.”
Select a terminal model. See the section “Selecting a Terminal Model.”
If desired, choose a font size. See the section “Changing the Font Size.”
Select link-specific options. See the section “Choosing Link-Specific Options.”
Depending upon which link type you choose, you may have to set particular link-specific options. Depending upon the link type, these can include the name of the IBM host system, the names and number of gateways, and the model of IBM terminal to emulate.
If you are using the emulator in ASCII mode, you must edit a plain-text configuration file in the directory /var/opt/3270/lib. There is a separate configuration file for each login on the workstation that uses the emulator. The configuration files are named:
t3279rc.LOGNAME
In the above example, LOGNAME is actually the name of a particular login. For example, if you log in as ralph, your configuration file in /opt/3270/lib is called:
t3279rc.ralph
For information about the ASCII configuration file, see Appendix B, “Editing the Emulator Configuration File.”
The setup3270 program is the main configuration tool for the 3270 Emulator. Start the setup3270 program by selecting Set Up "3270" from the 3270 Toolchest menu.
You cannot use the setup3270 program from an ASCII terminal. To configure the emulator for an ASCII terminal, see the previous section, “Configuring the Emulator for an ASCII Terminal,” and Appendix B, “Editing the Emulator Configuration File.”
Once you start setup3270, you see a screen similar to Figure 1-1:
The setup3270 window allows you to change the character set, link type, terminal model, font size, as well as other link-specific and miscellaneous items for your emulation session.
Note that as you change settings in the setup3270 window, messages are displayed in the message area. For example, Figure 1-2 shows a message confirming that you have changed the character set:
The colors of the setup3270 window are controlled by the file /usr/lib/X11/app-defaults/Setup3270. To change the colors of the setup3270 window, edit that file and change the various color settings.
There are some examples of alternate color settings in the directory /usr/lib/X11/app-defaults/Setup3270. In that directory are several example configuration files, each named after a particular color scheme. You can replace the default Setup3270 configuration file with one of these example files. The default colors are described in the example file DorianGray.
 | Note: You can change the colors of only the setup3270 window using this configuration file. The colors of the emulator window are set by the emulator and by host applications. |
To change the character set to match the host code page, click the left mouse button on the diamond button for one of the international character sets, as shown in Figure 1-3:
The default character set is U.S. English. You may also choose French, German, Italian, Katakana, Portuguese, Spanish, Swedish, or U.K. English.
To change the 3270 connection, click the left mouse button on the diamond button for one of the installed connections listed in the "Link Type" box. The example in Figure 1-4 shows the supported link types:
The following conditions apply to using the various link types:
The TCP link type connects to a 3172 or equivalent controller.
The 5080 link type connects to the Silicon Graphics IRIS Channel Adapter gateway.
The SNA link type connects to the Silicon Graphics SNA Server product on the local or remote workstation.
For the 5080 link type, you can select terminal Model 2, 3, 4, or 5 by clicking the left mouse button on the diamond buttons in the "Model" box shown in Figure 1-5:
Terminal models shown in Figure 1-5 are grayed out and inactive for the SNA link type, which initially defaults to the Model 2 terminal type. (To change your SNA terminal model, specify the appropriate LOGMODE when you log in to the IBM host, or change the LOGMODE tables on the host.)
For TCP link types, you can choose one of several terminal models using the Link Specific box. See “TCP Link-Specific Options” for information about setting the terminal model for TCP link types.
To change the size of the text in your 3270 terminal window, click the left mouse button on one of the diamond buttons in the "Font Size" box, as shown in Figure 1-6:
You can select point size 9, 11, 13, or 15. Keep in mind that changing the font size also changes the size of the 3270 terminal window.
For example, if you are using a 1280x1024 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 1024x768 IRIS graphics terminal, Models 2, 3, and 4 fit on the screen with point sizes 9 and 11.
The setup3270 window contains several link-specific options. These options differ depending on how the IRIS 3270 Emulator is connected to the IBM host. The link-type connection you choose—SNA, TCP, or 5080—determines which options are listed in the "Link Specific" box. For information about setting the link type, see the section “Choosing a Link Type,” earlier in this chapter.
The SNA Link-Specific box contains the "Gateway" option shown in
Figure 1-7:
Gateway: To choose an SNA gateway, click the left mouse button on Gateway to display the SNA Gateways dialog box shown in Figure 1-8.
To select a gateway from among those listed, click the left mouse button on a gateway name in the Gateway Names area. To add a new gateway to the Gateway Names area, click the left mouse button on the Selection entry box, enter a new gateway name, and click the Add button.
To delete a gateway, click the left mouse button on a gateway name in the Gateway Names area, then click the Delete button. For help, click the Help button.
When you are finished, click the Quit button to exit from the dialog box and return to the Link-Specific menu box.
The TCP Link-Specific box includes the Port, Model, and Host options shown in Figure 1-9:
Port: To select a TCP port on the IBM host, double-click the left mouse button on the Port entry box to highlight it, then enter the port number. The default port is 23. Appropriate ports for a TCP connection support full-screen mode, rather than line mode. If you are not sure about which port to choose, ask your IBM host system programmer.
Model: With a TCP connection, you can choose Model 2, 3, 4, or 5 for either 3278 or 3279 terminals, as well as Model 2-E, 3-E, 4-E, or 5-E for 3279 extended-attribute-enable terminals. The default TCP terminal model is 3278-2. To select a different terminal model, click the left mouse button on the Next button to display the next terminal model in the Model list box.
Host: To choose a TCP host, double-click the left mouse button on the Host option to display the TCP Hosts dialog box shown in Figure 1-10. Then, click the left mouse button on a host name in the Host Names list box.
To add a new host to the Host Names list box, click the left mouse button on the Selection entry box, enter a new host name, and click the Add button. To delete a host, click the left mouse button on a host name in the list box, then click the Delete button. For help, click the Help button. To quit the dialog box, click the Quit button.
When you select a 5080 link type, the Link-Specific box displays the Gateway Name, Channel Address, and Board Number options, as shown in
Figure 1-11:
Gateway Name: To choose a 5080 gateway workstation or server, double-click the left mouse button on the Gateways option to display the 5080 Gateways dialog box shown in Figure 1-12. Then, click on a gateway name in the Gateway Names list box.
To add a new gateway to the Gateway Names list box, click the left mouse button on the Selection entry box, enter a new gateway name, and click the Add button. To delete a gateway, click the left mouse button on a gateway name in the list box, then click the Delete button. For help, click the Help button. To quit the dialog box, click the Quit button.
Channel Address: Certain site configurations require that each 3270 device always use the same channel address. Normally, channel addresses are assigned dynamically, but you can enter a specific channel address for your emulation session. This address is stored and used for all subsequent sessions (unless you change it).
Board Number: Use the Board Number slider to choose a specific ICA gateway board in the gateway workstation or server. Valid board numbers are 0 through 3. The default is 0.
The setup3270 window Miscellaneous box includes the 3270 Trace and cursor type options, shown in Figure 1-13:
3270 Trace records what you see in the 3270 Presentation Space (PS), the location and value of all 3270 attributes, the 3270 status line, keyboard input, Silicon Graphics Message Mode data, and IBM structured field data. To turn the 3270 Trace option on or off, hold down the left mouse button on the 3270 Trace button. A pop-up menu appears displaying the choices Yes and No. Click on Yes to enable 3270 Trace and No to disable 3270 Trace. The default is No. The trace option is used primarily to troubleshoot errors. See Chapter 5, “Troubleshooting” for more information.
The Actions menu provides a way to use the 3270 emulator directly from the setup3270 window. From the Actions menu, you can:
save your 3270 emulator settings
start the emulator
display the IBM keyboard map
To display the Actions menu, click and hold down the left mouse button on Actions at the upper left of setup3270 window; the keyboard shortcut is
<Alt-a>. The Actions menu appears, similar to the one shown in Figure 1-14. Move the cursor to highlight a menu item, then release the left mouse button to select it.
The Actions menu includes these items:
| Save and Start 3270 Emulator |
| |
| Display Keyboard Map |
| |
| Save and Quit |
| |
| Quit | Exits the setup3270 window without saving your configuration settings; the keyboard shortcut is <Ctrl-Q>. |
To use the setup3270 window's context-sensitive help, move the cursor to the item in question and press the <F1> key. To see additional information about the setup3270 window user interface, Actions menu operations, host connections, and IRIS 3270 Emulator products, you can use the Help menu.
To display the Help menu, click and hold down the left mouse button on Help at the upper right of the setup3270 window, or press <Alt-h>. The
Help menu appears, similar to the one shown in Figure 1-15. Move the cursor to highlight a menu item, then release the left mouse button to select it.
The Help menu includes these items:
| On Help | Provides information on how to use the setup3270 window graphical user interface; the keyboard shortcut is | |
| On Actions | Explains Actions menu operations; the keyboard shortcut is <Ctrl-A>. | |
| On Connection | Provides information on different host connections; the keyboard shortcut is <Ctrl-C>. | |
| About... | Provides general IRIS 3270 Emulator product information; the keyboard shortcut is <Ctrl-B>. |
To see how the keys on an IRIS keyboard correspond to those on an IBM keyboard, you can display the IBM Keyboard Map at any time by selecting the "Display Keyboard Map" item from the IRIS 3270 Emulator Toolchest menu. The keyboard layout for the IRIS 3270 window appears, such as the one shown for U.S. English in Figure 1-16.
Larger versions of all the keyboard maps, including the U.S. English map above, are included in Appendix E, “Keyboard Maps.”
| Note: Ignore the lighted <NUM LOCK> and <CAPS LOCK> on-off indicators during 3270 operation. |
The keyboard map shows the setting for each key as determined by the character set selected in the Char Set box of the setup3270 window. See the section “Changing the Character Set” earlier in this chapter for more information on setting and changing the keyboard character set.