HCL SW Blogs
Select Page


Z and I Emulator for Windows (ZIEWin) is an emulator interface that connects to IBM System Z (Mainframes) and System I (AS/400) systems from a Windows system. In ZIEWin, the connection configuration details such as IP, TLS protocol, Host Codepage, font, and so on can be saved in a profile file. A profile can be used to open a session as in the saved configuration. Users can manage the profiles using Session Manager, where the user gets to create new sessions, open existing sessions within the local device ( a laptop or a PC). But, in this scenario a user can have profiles on a single machine only. This restriction is dismissed with new Managed ZIEWin feature introduced in ZIEWin version 1.1. Using Managed ZIEWin, users having different devices can work on different devices with the same set of profile files in “Online” mode.

Managed ZIEWin is a solution where a ZIEWin user can store the profiles on a centralized server. User can access the centralized server by logging in using Session Manager Online utility from any device to retrieve the profiles. This centralized server is a ZIE Server that  can be installed by the Administrator.

ZIEWin client needs to be configured to a ZIE Server to store user profiles in a user- dedicated space on the server. Once the ZIE Server is configured, user can log in and open Session Manager Online; any creation or modification of profiles from here is directly saved on the ZIE Server. Managed ZIEWin also provides additional features like “Create User”, “Upload\Download Profiles”, and “Profile Migration”. Now, let us understand how to setup a Managed ZIEWin.

Setting up Managed ZIEWin

To setup a Managed ZIEWin client at the user end, the administrator must install ZIE Server and provide IP address and port of the ZIE Server. ZIEWin client must be connected to the ZIE Sever through the network.

On the ZIEWin client, the end user can configure either while installing ZIEWin or through the Preferences utility. The settings configured during the installation will apply for all the users of the same machine. If the configuration is done from the Preferences, it applies for the current user only.

The configuration needs two fields to be filled in Config Server and Config Server Port. We must configure the ZIE Server IP address in the Config Server field and the ZIE service port number in the Config Server Port field.

Refer to Figure 1 and Figure 2 for the configuration in Install panel and Preferences utility respectively.

install shield wizard

Figure 1: Configuring Managed ZIEWin during Installation

preferences manager

Figure 2: Configuring Managed ZIEWin from the Preferences Utility

List of Supported Configuration Files by Managed ZIEWin

Along with the Profile files (.ws), the Managed ZIEWin also stores the dependent configuration files on the ZIE server.

Here is the list of configuration files supported by Managed ZIEWin:


Creating User, Login, and Profile Migration

After the ZIE server is setup at the client side and when the user invokes the Managed ZIEWin by starting the Start or Configure Sessions – Online utility from Start menu for the first time,  Session Manager Online connects to ZIE Server and provides an option to create a new user account and set password.

Users can create the user accounts only if ZIE Server administrator allows the user to create a new user; by default, the ZIE server does not allow the client to create new users. Using the “fulladmin” console, the ZIE Server administrator must enable the Allow users to create accounts field on the ZIE server as highlighted in Figure 3.

full administration client

Figure 3: Enabling Users to Create User Accounts

In the Create User panel, once the user enters User Name, Password, and Confirm Password and clicks OK, a user account is created in the ZIE Server and the Login panel is displayed. If there is an existing user that is already created in some other machine, then you can skip the steps to create a user account and go to the Login panel by clicking Existing User >> as shown in Figure 4.

hcl z and i emulator for windows

Figure 4: Create User Panel – Creating a User Account

In the Login panel, the user can log in by entering the password or can go back to Create User panel by clicking << Create User as shown in Figure 5.

zie for windows

Figure 5: Login Panel – Creating a User Account

User also can change the password by selecting Change Password. The Change Password window will appear only after the user logs in successfully. Once the password is changed, the subsequent login will work only with the new password.

After the user logs in successfully, the user is prompted to migrate the profiles to ZIE Server. In the Profile Migration panel, click Yes to migrate the profiles or else click No to skip the migration as shown in Figure 6. The profile migration uploads all the profile files in the user space of the ZIE server.

zie profile migration

     Figure 6: Profile Migration Panel


If the user is logged in using an existing user account, then the profile migration will override the user space. After the profile migration, the Session Manager Online is displayed where the user can see the migrated profiles.

After the first login, if the user invokes the Session Manager Online again, the Create User or Profile Migration option is not provided, instead the Login panel appears as shown in Figure 7.

hcl zie login

Figure 7: Login Panel

Once the login is successful, the Session Manager Online is displayed as shown.

session manager online

Figure 8: Session Manager Online

Upload/Download Option

The upload and download features enable the user to exchange files between ZIE Server and ZIEWin client (file system). The upload of sessions or batch files to the ZIE server can be done by clicking Upload in the File menu in the Session Manager Online. To download a profile from the Session Manager Online, user can either right-click the profile and select the Download option or select a profile and use the Download option from the File menu. The Upload\Download of user profile file will also provide the option of uploading\downloading the dependent configuration files (like a .kmp file when associated with a .ws file) and are available in the same directory.

Figure 9 shows the Upload/Download option in the File menu of the Session Manager Online.

upload download option

Figure 9: Upload/Download Option

Logout and Exit

When the user starts a session from Session Manager Online, the opened session has a suffix “ – Online” on the session title. If the user wants to log out or exit (close), it is recommended to close all the online sessions and log out. If a user clicks Logout or Close, the application asks confirmation from the user to end all online sessions. If the user confirms, then all the online sessions are closed and subsequently the user is logged out or exited from the application, else the Logout or Exit operation is aborted. If you click Logout, then the Login panel will appear for the user to re-login again. If you click Exit, the Session Manager Online application will be closed.

Comment wrap
Further Reading
HCL ZIE for Windows
Mainframes | September 17, 2020
HCL ZIE for Windows Hardware and Software Pre-requisites
HCL ZIE for Windows, a native Windows 64-bit application is a proven emulator solution that supports 3270 and 5250 systems adhering to the latest security standards. Read the blog to know more details.
Z and I Emulator for Windows
Mainframes | September 3, 2020
Installing Z and I Emulator for Windows (ZIEWin)
Z and I Emulator for Windows provides 3270, 5250, and VT emulation, connecting to z/OS®, z/VM®, eServer™ i5, iSeries®, System i5®, zSeries, and ASCII systems.
Configuring session on Z and I Emulator
Mainframes | September 3, 2020
Configuring session on Z and I Emulator for Windows (ZIEWin)
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 workstation profile and a configuration file.
Filters result by