Configuring Sessions

Z and I Emulator for Windows saves emulator configuration information to a workstation profile (.WS). Depending on your Z and I Emulator for Windows configuration, you might have a workstation profile only or both a workstation profile and a configuration file. The workstation profile can be used later by other Z and I Emulator for Windows sessions, or to restart this session.

You can have an icon created for each workstation profile. Then you can select the session icon to establish communication with the host system using the saved workstation profile.

Configuring for iSeries®, eServer™ i5, or System i5®
To connect to an iSeries, eServer i5, or System i5, specific configuration information in the workstation profile must correspond to the information specified at the iSeries, eServer i5, or System i5 system. Refer to the iSeries, eServer i5, or System i5 configuration examples in Emulator User's Reference for more information about creating display, line, and controller descriptions on the iSeries, eServer i5, or System i5 system.

If you want to configure multiple links, refer to Administrator's Guide and Reference.

Creating a Configuration

To create a new session, use the following procedure:

  1. From the Start menu, click Programs -> HCL Z and I Emulator for Windows -> Start or Configure Sessions.
  2. From the Session Manager dialog, click New Session.

    The Customize Communication window appears.

  3. Select the type of host from the Type of Host drop-down list box.
  4. Select the interface you will use from the Interface drop-down list box.
  5. Select the attachment type you want to use from the Attachment drop-down list box.
  6. Click Session Parameters to modify the session type (display or printer), host code page, and display/graphics options.

    The Session Parameters - 3270, 5250, or ASCII - Host window appears (depending on the host you selected in step 3). Click OK.

  7. Click Link Parameters.

    Enter the appropriate information for each page and click Next to continue. Click Finish when you are done.

    Based on the attachment type that you have chosen, make your selections for the parameters in the window displayed. Click Help or press F1 to display parameter details. Click OK when you are finished.

    If your host is configured to support Secure Sockets Layer (SSL) or Transport Security Layer (TLS), then click the Security Setup tab. Refer to Administrator's Guide and Reference for details on configuring session security.
  8. Click the Host Definition tab to configure the Connection Options.
  9. To set up printer association, click the Printer Association tab and do the following:
    1. Select Associated Printer Session.
    2. Enter the .WS file for the printer that is to be associated with the specific terminal. You can also click Browse to locate the file.

    You can also set the following options:

  10. After configuring the session options, click OK in the Telnet tab panel.
  11. Click OK on the Customize Communication window. The session is displayed automatically.

    Save the workstation profile as described in Saving a Workstation Profile.

Creating an FTP configuration

  1. Open the FTP client from Start Menu by clicking Start -> HCL Z and I Emulator for Windows -> Utilities -> FTP Client.
  2. Click Communication -> Configuration from the menu.
  3. Choose the options in the Connect tab.
  4. Click the Logon tab.
  5. Click the File Transfer tab and select the appropriate choice for the Transfer mode from the drop-down list. Browse and select a Transfer List File if any.
  6. Click the SSL tab to specify the security parameters for Secure FTP. SSL is optional and not enabled by default.
  7. Click the Runtime Preferences tab.
  8. Click OK to close the configuration dialog.
  9. Connect to the host by clicking Communication->Connect or the Connect button.

Environment variables in workstation profile

In the .WS profile, you can specify environment variables for the paths of the following Z and I Emulator for Windows files:

The syntax is as follows:


In the above examples, USERDIR, PROFILEDIR, ZIEWinPROFILE, and USERFOLDER are environment variables that you specify. See the following example:

USERDIR = profile\toolbarfiles

Saving Configuration Information

This section describes how to save configuration information. The emulator workstation profile, and FTP Client configuration information is stored in a .WS, and .CFG file respectively.

Saving a Workstation Profile

If you save your emulator configuration information, the session will have the same characteristics the next time you start it. If you have an icon added to the Z and I Emulator for Windows folder, you can restart the session with the saved configuration information by clicking this icon from the Start menu. You are automatically given the opportunity to save your session information when you close a session. However, if you want to save the information at any time, use the following procedure:

  1. Select Save from the File menu in the session window.

    The Save WorkStation Profile As window appears.

  2. Type a file name (.WS) and then click OK. The name you enter will become the icon title unless you enter a description. Note that you can choose the directory where this file is saved, but the default directory is the application data directory specified during installation.
  3. An icon associated with the profile will appear in the Session Manager.

Saving an FTP Client Configuration

You can save the FTP Client configuration in two ways:

Changing Configuration Information

You can change all of the configuration parameters in the workstation profile.

Changing a Workstation Profile

To change a workstation profile, use the following procedure:

  1. If your session window is not active, select the icon corresponding to the workstation profile to be changed.

    The session window appears.

  2. Select Configure from the Communication menu.

    The subsequent steps are the same as for creating a new configuration, beginning with step 3.

  3. After you have made your changes, the following message appears:
          Because you have changed the configuration,
          communication will be terminated if you
          proceed. Are you sure?

    If you click OK, communication ends, but then you are reconnected using the new configuration information.

    To save the changes in your workstation profile, click Save from the File menu in the session window and then click Yes to replace the existing file. Otherwise, click No to save this information in a new configuration file.


Unless you have deselected Save on Exit in the Exit Options dialog by selecting Exit from the Settings menu, changes are saved in the workstation profile automatically whenever you exit a session.