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 | September 17, 2020
Organizing Web Application Deployment in HCL ZIETrans
HCL ZIETrans allows you to transform your user experience by extending 3270 and 5250 terminal applications to the web, portlet, rich client, or as standard SOAP or RESTful web services. By default, all HCL ZIETrans Web applications are stored in one enterprise archive file. HCL ZIETrans Toolkit is an HCL ZIE component that enables you to develop new applications and allows previewing and saving each change. We can streamline the HCL ZIETrans application in such a way that it becomes easier to use the host applications whose data and functions it presents. The supported servers for multiple HCL ZIETrans applications in an ear are ‘WebSphere Application Server’ and ‘WebSphere Liberty’. This blog describes the ways to manage the HCL ZIETrans web applications that have multiple .ear and multiple .war in the projects, using HCL ZIETrans Toolkit and the best practices. When you export your applications as HCL ZIETrans EAR file and deploy them on WebSphere Application Server, the .ear file contains a Web archive (.war) file with the resources to run each application. An EAR may also combine multiple web projects (WAR), Enterprise JavaBeans projects (JAR), standard JARs, etc. into a single application. Each individual .ear consumes around 25MB (minimum) of disk space during runtime. So, if you have multiple HCL ZIETrans projects you may end up having multiple HCL ZIETrans EAR of varying size depending on the complexity of the application. Based on different deployment or development scenarios may lead to developers/administrators opting for single EAR or multiple EAR’s deployment solutions. The below table illustrates salient points of the ‘Individual’ Vs ‘Multiple wars in single’ EAR deployment method, based on these customers can decide their HCL ZIETrans application deployment architecture. Table 1: Individual Vs Multiple wars in one EAR deployment Ways to organize the HCL ZIETrans Web Applications: Associating...
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. In addition to host terminal emulation, it provides these useful features: File transfer Dynamic configuration An easy-to-use graphical interface Emulator APIs such as Emulator High-Level Language Programming Interface (EHLLAPI), Host Access Class Library (HACL), and PCSAPI. For example, EHLLAPI is often used for automated operator applications which read host screens and enter keystrokes without direct user intervention. System Requirements This document provides the system requirements for Z and I Emulator for Windows, version 1.1. Higher maintenance levels, such as fix packs and service packs, may be supported as they become available Supported Environments Platforms Covered – English OS OS Architecture ZIEWIN Architecture Clean Install/Migration Windows 10 64 bit Ent – 1809 64 bit 64 bit Custom/Users -> Custom/All Users (1.0 -> 1.1) Windows 10 64 bit Ent – 1903 64 bit 64 bit Typical/ Users -> Typical/All Users(1.0 -> 1.1) Windows 2019 Server 64 bit 64 bit Fresh (Custom -> Custom) (1.1) Platforms Covered - Non English OS OS Architecture ZIEWIN Architecture Clean Install Windows 2016 Server – Japanese 64 bit 64 bit Fresh (Custom/All Users) (1.1) Windows 10 64 bit Ent - 1909 – Japanese 64 bit 64 bit Fresh (Typical/All User) ( 1.1) Hardware Requirements HCL ZIE for Windows supports workstations with the following hardware: System units   The recommended system unit has an Intel Pentium microprocessor and access to a DVD-ROM drive. A minimum of 180 MB of fixed drive space is required. Display monitors All VGA resolution or above display monitors supported by Windows. Video adapters All VGA resolution or above video adapters supported by Windows. Keyboards Enhanced keyboard (101-key, 102-key, 104-key) (Only the 101-key for Japanese) Space-saving keyboard Microsoft...
Mainframes | September 3, 2020
Installing Z and I Emulator for Windows (ZIEWin)
Introduction: 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. Z and I Emulator for Windows uses Microsoft Windows Installer technology for all installation procedures. When the Z and I Emulator for Windows installation image is first run, it examines the target system and, if necessary, automatically installs the proper version of the Windows Installer service. Setup.exe is the bootstrap loader that calls the Windows Installer service (msiexec.exe) and launches the installation dialogs. The following should be taken into account when installing Z and I Emulator for Windows: In some cases, installation of Windows Installer triggers a reboot of the system. If you are required to reboot, upon subsequent startup you are taken immediately back to Windows Installer to continue installation of Z and I Emulator for Windows. After Windows Installer has been successfully installed, if the installation of Z and I Emulator for Windows fails or is cancelled by the user, Windows Installer rolls back all partially installed Z and I Emulator for Windows files and returns the system to its original state. You must be a member of the Administrator's group to perform these installations. Before you begin installation, make sure all other applications are stopped. If you are reinstalling Z and I Emulator for Windows or are upgrading Z and I Emulator for Windows, make sure that Z and I Emulator for Windows is not running before you start setup. For more details, see the video on ‘ZIEWin Installation’ : Contact us For further information on Organizing Web Applications in HCL ZIE, automation capabilities and Lab services offerings, please write to: Mahua Chanda Developer, Lab Services, HCL ZIE
a/icon/common/search Created with Sketch.