Chapter 2. Setting Up the IRIS SNA SERVER

This chapter provides overview information for setting up the IRIS SNA SERVER software. Instructions for accessing the SNAView graphical user interface management tool and a description of the SNAView's main window are also given.

Before You Begin

Your IRIS SNA SERVER software must be correctly installed. Follow the
IRIS-4D User's Guide instructions for installing a software update on your system.

Note: Refer to the latest version of the IRIS SNA SERVER Release Notes for hardware and software prerequisites and any additional instructions.

In addition, one or both of these Silicon Graphics communication cards need to be properly installed:

  • IRIS SDLC hardware product

  • IRIS Token Ring hardware product

Note: To determine whether SDLC or token ring boards are installed, enter:


If a token ring board is correctly installed, text similar to this is displayed, depending on your configuration:

Formation Token-ring controller fv0: 16 Mbit

Formation Token-ring controller fv0: 4 Mbit

If an SDLC board is correctly installed, text similar to this is displayed, depending on your configuration:

Formation SNA SDLC controller 0

Validating the TCP Port Number

The IRIS SNA SERVER communicates with IRIS SNA application programs by means of the socket.

For the service name snaverb, the tcp entry in the /etc/services file for a particular port number on the IRIS workstation running an IRIS SNA application must match the tcp entry in the /etc/services file on the IRIS workstation running the IRIS SNA SERVER. At installation, the /etc/services file is updated with a pre-determined port number. The system administrator verifies that the number is unique in the network. Any TCP port number above 5000 and not used by the network at installation is valid. Change the snaverb tcp port number in the
/etc/services file, if necessary.

If multiple servers are run simultaneously (for testing or other purposes), enter additional tcp port number in /etc/services. The verb service name in this case is imparted to the server and LU through the IRIX environment variable SNAVERB. Set the IRIX environment variable SNAHOST on the LU to the name of the host that is running the IRIS SNA Scheduler s2_schd. This name looks up the host address in /etc/hosts.

Setting Up IRIS Token Ring

Note: If your token ring has not been set up, see the instructions given in the Token Ring Administration Guide.

To configure your IRIS SNA SERVER for token ring, you may also need to modify a file called /etc/config/trconfig.options. This section explains the procedures for modifying the /etc/config/trconfig.options file and gives an example of a modified file.

Your token ring hardware has been given a universal MAC address by the manufacturer. If your IBM host requires you to use a locally administered address, or if your site uses a locally assigned MAC address rather than a universal address, you need to override this burned-in MAC address with a MAC address assigned by a system administrator at your site.

To override the universal MAC addresses of one or more token ring boards on your workstation, you must edit the file /etc/config/trconfig.options and add a line for each of your token ring boards.

Follow these steps to override universal MAC addresses:

  1. Use a text editor to copy the second to last line of the file
    /etc/config/trconfig.options and append it to the end of the file.

  2. Remove the # character at the beginning of the new last line.

  3. Replace the string with the 12 hexadecimal digit number assigned as your locally administered address.

  4. Insert a period between each pair of digits in the 12 hexadecimal digit number to create a MAC address. Leading zeros in each pair of numbers can be deleted. An example of a modified file is shown in Figure 2-1.

    Figure 2-1. A Modified /etc/config/trconfig.options File

  5. If you have additional token ring boards, repeat Steps 1 through 4 for each board, using a different address each time and editing the device name fv0 on each line.

Getting Started with IRIS SNAView

After the software and any appropriate hardware are installed, you can use the default values to access the IRIS SNAView graphical user interface network management tool. You may want to become familiar with a few features of the interface before configuring the IRIS SNA SERVER for your installation (see Chapter 3, “Configuring the IRIS SNA SERVER”).

If the SNA icon appears in the main menu after you restart your system, the installation was successful.

The standard pop-up menus shown in Figure 2-2 are always available from the SNA screen icon.

Figure 2-2. SNA Cascading Menu

Note: When other IRIS SNA products are installed, pop-up menus are added that permit access to operations specific to that product.

Follow these steps to display the IRIS SNAView main window:

  1. Select the SNA icon from the toolchest.

Access to the IRIS SNAView is through the SNA icon and the associated pop-up menus. To select a menu, position the screen cursor over a selection and click the right mouse button.

  1. Select “Net Oper” (Network Operations) from the SNA pull-down menu.

  2. Select “SNAView” from the Network Operations Tools submenu.

Figure 2-3 shows the main window of the IRIS SNAView that is displayed.

Figure 2-3. IRIS SNAView Main Window

Note: When you iconize IRIS SNAView, the icon is represented by an image of a network.

The main window of IRIS SNAView serves as the operation panel and main information panel. It enables you to easily configure the IRIS SNA SERVER for a given SNA application and simplifies server operation.

The window is divided into four areas as shown in Figure 2-3:

  • Main Menu Bar

File and Help pull-down menus are located in the title bar.

Click and pull down the File menu to display dialog boxes in which you can enter a new SNAconfiguration file name, open an existing configuration file, save new configuration data, or create a new configuration file. The selected file name is then displayed in the Information Panel.

Press the OK push button at the bottom of the dialog box to complete the transaction; press Cancel to negate it, and press Help for instructions.

The File menu items are:

When you create a new configuration file, use the “Save” menu item to name and save it. Enter a new file name for the configuration file in the Selection text entry box (see Figure 2-4) and press OK. The file becomes an entry in the Open Config dialog box.

Displays the Open Config File dialog box. Select a configuration file by clicking on the desired item. The new file name is shown in the Selection text entry box.

Saves the current configuration data into the current configuration file.

When you modify a configuration file, use the “SaveAs...” menu item to name and save it. Enter the new file name for the modified configuration file in the Selection text entry box (see Figure 2-4) and press OK. The file becomes an entry in the Open Config dialog box. )

Figure 2-4. Save Config File As...Dialog Box

  • “Exit”

Exits SNAView.

Note: Become the superuser before modifying an existing configuration file using “Save” or “Save As...”.

  • Information Panel

Three text display windows: Configuration, Line, and Gateway, followed by two lines of messages.


You can enter the configuration file name in the Configuration text display window.


Shows current setting of the line parameter in the SNA Configuration. The value should be in the configuration file, although you can enter it manually.


Shows your current local workstation name.

Message Lines

Displays messages from the IRIS SNA SERVER and other informational messages.

  • Configuration Panel

The Configuration Panel consists of two areas:

Server Device Selection: SDLC or token ring

Configuration type buttons: 3270/3770 Host, LU 6.2 Host, or
LU 6.2 Peer-Peer

  • Operation Panel

The Operation Panel consists of two areas:

Gateway Operation Panel

Operation: Server Trace, Server Status, and Session Operator buttons

The Configuration Panel and Operation Panel are described in more detail below.

Quitting IRIS SNAView

To exit from IRIS SNAView, click on the File pull-down menu located on the IRIS SNAView main window's title bar. Select “Exit,” which returns you to the current xterm window.

Getting Help Information

The Help menu item in the title bar provides information on Help, SNA configuration, SNA operation, and LU 6.2 operation. Each of the subwindows and dialog boxes also has a Help button.

Press the <F1> function key to receive context-sensitive help on any item that requires a response (radio button, check box, text entry field).

Configuration Panel

The Configuration Panel has two areas: the Device Selection and the Configuration Type buttons (see Figure 2-3). The device is either SDLC or token ring. At start-up, the IRIS SNA SERVER software automatically checks the hardware device installation status. You can select only valid installed devices (invalid selections are grayed out). See “Selecting the Device (SDLC/Token Ring)” in Chapter 3 for a discussion of valid devices.

The four text display windows, which are used for token ring only, show the first item in the Adjacent Link Station for each token ring. Usually, there is only one Adjacent Link Station; if there are more, these are also listed. To modify this field, enter another valid name.

After selecting the valid device, press one of these three Configuration Type buttons only if you chose to create a new configuration file or modify an existing one:

  • 3270/3770 Host (for SNA 3270 or SNA 3770 applications)

  • LU 6.2 Host (for LU 6.2 host applications)

  • LU 6.2 Peer (for LU 6.2 peer-to-peer applications)

Data that you enter in the Connection Configuration window that is displayed enables you to create a new configuration file based on the existing one that you opened from the File pull-down menu.

After selecting a valid device, you may create or modify a single configuration file that can be used for both 3270/3770 Host and LU6.2 Host connections. Press either the 3270/3770 Host or LU 6.2 Host configuration type button and enter the information requested in its Connection Configuration window. Afterwards, return to the IRIS SNAView main window and press the other configuration type button. Then complete the requested information in its Connection Configuration window. This dual-purpose configuration file is valid for 3270/3770 and LU 6.2 hosts only.

Note: Just as each configuration file has its associated communications device or devices, each configuration file has its own configuration type. You may not be able to select a type other than the pre-defined one. If you attempt to do so, a warning message is displayed.

Operation Panel

As shown in Figure 2-3, the Operation Panel consists of radio buttons for activating and deactivating the gateway and line, as well as three optional buttons. The text windows labeled Logical Unit and Adj Link Station display the Logical Unit and the Adjacent Link Station names that are in operation. The three optional operation buttons are:

  • Server Trace

  • Server Status

  • Session Operator (LU 6.2 applications only)

Use the Server Trace and Server Status buttons for problem determination. To perform a link level trace for a given device, press the Server Trace button.To examine IRIS SNA SERVER status, press the Server Status button. When a gateway is successfully activated, the status for Line and Adj Link Station should be Active. (For a more complete description, see the sections “Tracing Server Activity” and “Showing Server Status” in Chapter 4).

Chapter 5, “Managing IRIS SNA LU 6.2 Sessions,” describes the Session Operator dialog box that is displayed when you press the Session Operator button. Use this dialog box to manage SNA LU 6.2 sessions and to control the number of active sessions in the LU 6.2 network.

Note: The Session Operator button is grayed out (not selectable) unless the IRIS SNA LU 6.2 optional software is installed.

For instructions on creating a new configuration, continue to Chapter 3.