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.

Figure 1: Configuring Managed ZIEWin during Installation

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.

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.

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.

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.

     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.

Figure 7: Login Panel

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

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.

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
Mainframes | January 22, 2021
Installing Z and I Emulator for Web
Z and I Emulator for Web (‘ZIEWeb’ or ‘ZIE for Web’) is a browser-based multi-platform application that is designed to be compatible with a wide range of browsers and operating systems. The product is tested with all the available versions of Chrome, Firefox, Edge, Safari, and other browsers to ensure that Users continue to have reliable access to host systems with benefits of browser-based technology. Salient features of ZIE for Web: Multi-platform browser-based emulator API Support Support for IBM system Z and I Language support English and Japanese Transport Layer Security(TLS) Installing ZIE for Web ZIE for Web can be installed on all the supported platforms using Installation Manager. Select File > Preferences. 2. Select Repositories in the left panel. This option shows all the available repositories that have been added to the Installation Manager. 3. If HCL ZIE for Web is not listed, then Select the Add Repository button on the right side. 4. Click Browse and navigate to the location of the extracted HCL ZIE WEB path and select the diskTag.inf file present in disk1 folder. 5. Click OK, to add the new repository location to the list. 6. Click Test Connections to ensure that the Repository URL is available. 7. From the Home page of the Installation Manager, click Install. The Installation Manager searches the defined repositories for available packages. 8. Select the ‘Z and I Emulator for Web’ package. Click Next. 9. Read the license agreements. If you agree to the terms of the license agreement, select the checkbox against ‘I accept the terms of the license agreement’, and then click Next to continue. 10. Select the required architecture and click on Next. 11. Select the languages that you want to install. The default language is English. Click Next. 12. Review your selection and provide the...
Mainframes | November 19, 2020
HCL Software is pleased to introduce Z abend Investigator. This blog talks about how ZAI provides precise real-time problem analysis to help developers swiftly recover failed applications.
Mainframes | October 14, 2020
HCL ZIE for Web Hardware and Software Pre-requisites
HCL Z and I Emulator for Web provides secure host access to Users in intranet-based and extranet-based environments. Z and I Emulator for Web is installed on a Web server, simplifying administrative management and deployment, and the Z and I Emulator for Web applet or application is downloaded to the client browser or workstation, providing user connectivity to critical host applications and data.   1.1. System Requirements This document provides the system requirements for Z and I Emulator for Web, version 1.0. Higher maintenance levels, such as fix packs and service packs, may be supported as they become available. 1.2. Supported Environments Client Environment Details Client Operating System/Architecture Client Java Java Version Java Architecture Browser Version Browser Architecture Client Type Red Hat Enterprise Linux (RHEL) 7.6 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 32-bit 74 Mozilla FireFox 32-bit Java Network Launching Protocol (JNLP) Red Hat Enterprise Linux (RHEL) 7.6 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 75 Mozilla FireFox 64-bit Launcher Red Hat Enterprise Linux (RHEL) 7.6 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 32-bit 74 Mozilla FireFox 32-bit Launcher Ubuntu 18.0.4 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 32-bit 74 Mozilla FireFox 32-bit Java Network Launching Protocol (JNLP) Ubuntu 18.0.4 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 75 Mozilla FireFox 64-bit Launcher Ubuntu 18.0.4 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 32-bit 74 Mozilla FireFox 32-bit Launcher Red Hat Enterprise Linux (RHEL) 6.10 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 60.3 Mozilla FireFox 64-bit Launcher Windows 10 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 44.18362 Edge 64-bit Launcher Windows 10 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 75 Mozilla FireFox 64-bit Launcher Windows 10 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 64-bit 80 Chrome 64-bit Launcher Windows 10 - 64-bit...
a/icon/common/search Created with Sketch.