Chapter 4. IRIS SNA SERVER Operations

This chapter describes how to perform the following IRIS SNA SERVER operations, which are accessed through the Operation Panel of the IRIS SNAView main window:

Instructions for activating the IRIS SNA SERVER for the new configuration you created in Chapter 3, “Creating a New Configuration: A Tutorial,” are given in Section , “Activating the IRIS SNA SERVER: A Tutorial.”


Note: For information about the Operation Panel, see “Operation Panel” in Chapter 2.


Activating the IRIS SNA SERVER

After you have selected the configuration file (and its associated token ring or SDLC device), activate the server, which activates the default configuration, initializes the environment, and starts the SNA background processes (s2_schd and, if your installation includes IRIS SNA LU 6.2, s2_tpi). Follow these steps:

  1. Move the cursor to the Operation Panel. Click the Activate Gateway radio button.

If you have only one line, a Please Wait dialog box is displayed. After it disappears, this message is displayed in the Information Panel:

Gateway and PU are successfully activated.

  1. After the gateway has been activated, move the cursor to the Activate Line radio button and click.

Another Please Wait dialog box is displayed. After you receive a message indicating that the line and station have been activated, the line is operational for the new configuration.


If you are connected to more than one line, the Select Line for Activation dialog box is displayed; see Figure 4-1.

  1. Select the Line for activation by selecting the appropriate line name.
    If you have only one LU, go to step C.

If you have more than one LU, a dialog box is then displayed requesting that you select the LU.

  1. Select the LU for activation by selecting it and press OK.

You are returned to the Select Line dialog box.

  1. Press OK to return to the SNAView main window.

    Figure 4-1. Select Line for Activation Dialog Box


  2. Click the Server Status button to observe the status of both the Line and Adjacent Link Station.

Both should be active. (See Section , “Showing Server Status.”)

  1. On host connections, press the Host Status button from the Query Status window to observer the status of host LU sessions as shown in the Query Status dialog box. Press the OK button to return to the Query Status window.

  2. Press the OK button to return to the SNAView main window.

Activating the IRIS SNA SERVER: A Tutorial


Note: This is a continuation of the tutorial in Chapter 3, “Creating a New Configuration: A Tutorial,” for the 3270/3770 host configuration.

Activate the IRIS SNA SERVER by following these steps:

  1. Restart IRIS SNAView, which sets the new configuration with four LUs, of which the second is named MYLU02. When the window appears, click the Activate Gateway radio button in the Operation Panel.

A message indicating that a delay may occur is displayed.

  1. After you receive a message indicating a successful operation, click the Activate Line radio button.

Another message indicating successful operation is displayed. The gateway has now been activated for the new configuration.

  1. Click the Server Status button to observe the status of both the Line and Adjacent Link Station. (Both should be active.) Press the OK
    button to return to the SNAView main window.

You are now ready to start using SNA 3270/3770 applications.

Deactivating the IRIS SNA SERVER

Deactivating the IRIS SNA SERVER terminates s2_schd


Caution: The Line must be deactivated before you deactivate the Gateway.

Follow these steps to deactivate the IRIS SNA SERVER:

  1. In the Deactivate section of the Operation Panel (main IRIS SNAView window), click on the Deactivate Line radio button to deactivate the PUs and the line.

If you have only one line, go to step 4. If you have more than one line, the Select Line for Deactivation dialog box shown in Figure 4-2 is displayed. Go to step 2.

  1. Select the line to be deactivated.
    If you have only one LU, go to step 4.

If there is more than one LU for the line, the Select LU for Deactivation dialog displayed.

Figure 4-2. Select Line for Deactivation Dialog Box


  1. Select the appropriate LU or LUs to be deactivated and press OK.

If you have an additional line to be deactivated, go back to step 2. Press OK to return to the SNAView main window.

  1. Click on the Deactivate Gateway radio button.

Tracing Server Activity


Note: This operation is available to SDLC connections only.

The IRIS SNA SERVER trace feature provides a link trace of the server activity, which assists you in problem determination. Trace data is written to a disk file in what is mostly raw format.


Note: To operate the trace feature, you must first activate the IRIS SNA SERVER.

After you press the Server Trace button, which is located in the Operation Panel of the IRIS SNAView main window, the Operator Trace dialog box shown in Figure 4-3 is displayed.

Figure 4-3. Operator Trace Dialog Box


Indicate which device is to be traced and then set trace parameters as follows:

  1. Click on the radio button representing the device you want to trace.


    Note: Link trace is currently not supported for token ring.


  2. On the left side of the Trace Parameters subarea, enter the trace file name into which the data will be written.

This is a file name in the directory /usr/sna/log.

  1. Enter the maximum number of blocks in the text box.

This is the maximum number of UNIX® blocks (512 byte blocks) in the raw output file. The default is 16 blocks.

  1. Indicate the desired format: ASCII (the default) or EBCDIC by clicking the radio button.

  2. Select the I-Frame (the default) or All Frames radio button.

Specifies whether all Frames, including poll frames, are written to the trace file.

  1. On the right side of the Trace Parameters subarea, select the following boxes as appropriate:

  2. Print Ruler

Indicates whether or not a ruler is provided as part of the output file.

    1. FMD Convert

If the RU category is Function Management Data, select this box to convert the category to ASCII.

    1. Outbound only

Select if the data flow is to be outbound only. If this box is not filled in, data flow is both inbound and outbound.

  1. Press Apply to accept the information (or Cancel to negate it and return to the IRIS SNAView main window).

  2. To begin the trace operation, press the Start Trace push button. To stop the trace, press the Stop Trace push button.

Other push buttons are Print (lp) and View (vi). Pressing the Print button prints the output file to the default printer using the UNIX lp line print command. Pressing the View button opens a window and displays the file for editing using the UNIX vi text editor command. You can interact with the file using the standard vi commands.

Showing Server Status

To view the status of the lines for the current configuration, press the
Server Status button in the Operation Panel, which displays the Query Status window shown in Figure 4-4.

Figure 4-4. Query Status Window


The status of the line (or lines) can be either RESET or ACTIVE. RESET is the initial state before the line has been activated. ACTIVE is the desired state for server operation. The server activates the line before establishing the connection with the remote station (adjacent link station).

The adjacent link station status can be either RESET, PND_CONTACT, ACTIVE (the desired state), or PND_RESET. RESET is the initial state before the line has been activated. PND_CONTACT (pending contact) is displayed while the server attempts to establish a connection with a remote station. If you display the Query Status window several times in succession and the status remains PND_CONTACT, there is a problem with the connection. Verify whether or not the remote station is operational.

After the line has been deactivated, but before it is reset, the adjacent link station state is PND_RESET (pending reset).

Showing Host Status


Note: The Host Status does not apply to LU 6.2 peer-to-peer connections.

To view the status of the host LU sessions, press the Host Status button in the Query Status window, which displays the Host Status dialog box shown in Figure 4-5.

Figure 4-5. Host Status Dialog Box