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  /  August 11, 2020
Automation using PCSAPI
By: Sudhir Ranjan Rout, Senior Developer
ZIEWin provides an emulator interface to communicate with IBM Mainframe/AS400/VT sessions. This is used for reading & updating host data and interfacing host with other applications.
Mainframes  /  June 4, 2020
HCL ZIE for Transformation – Single Sign-on Implementation Guide
By: Badal Burathoki, Senior Technical Architect at HCL Software
Introduction Single sign-on (SSO) is a property of access control to multiple related, yet independent, software systems. With this property, a user logs in with a network credential to gain access to any of several- related systems. In this post, we will understand how we can setup single sign-on in HCL ZIE for Transformation (ZIETrans) that provides a mechanism to automatically log on to the Host system. Web Express Logon (WEL), a feature provided in ZIETrans allows users to access host applications using their network security credentials. It provides a means for a ZIETrans application to accept user network credential information, previously authenticated by a network security layer, and use it to generate host credentials instead of requiring a ZIETrans user to navigate host logon screens. To map Network Credentials to the Host Credentials, ZIETrans provides Credential Mapper plug-in. If these supplied plug-ins do not meet your needs, then you can create your own plug-in and integrate it into WEL. Implementation There are few components in the ZIETrans project, which must be configured to implement Web Express Logon. The configuration steps are: 1.       Enable and Configure WEL. 2.       Record a WEL Macro. 3.       Configure ZIETrans to invoke the WEL Macro. Enable and Configure Web Express Logon Complete the following steps to enable WEL in your ZIETrans Web Application: 1.       Go to Connection Editor. 2.       Select Security Tab. 3.       Select Use Web Express Logon and click Configure. To configure WEL, you need to identify the Network Security and Credential Mapper plug-ins. Web Express Logon relies on these plug-ins to provide the network user ID and host access credentials. You can either select the plug-ins provided in the ZIETrans Project or can create your own custom plug-ins. For more information, refer to this link to create your own custom plug-in. Network Security...
Mainframes  /  May 19, 2020
Converter Solution for migration of automated scripts to HCL ZIE Emulators
By: Shivaprasad Nanjundaswamy, Technical Specialist at HCL Software
Each Emulator provides specific automation APIs to create scripts to automate the business process. Automated Scripts contains core logics to read, write, update, and copy data in Mainframe/AS400 emulators which helps is accomplishing every-day business. When migrating to HCL ZIE for Windows (ZIEWin)/ZIE for Web (ZIEWeb), apart from migration of session properties and keyboard mapping, it is also important to migrate automated scripts to make it compatible and run in the new emulator without breaking automated core logic. These automated scripts can be recorded macros, Excel-based VBA automation code, VBS, or other supported formats. Migration to HCL ZIEWin and HCL ZIEWeb (EHLLAPI programs only) is made easy with HCL Lab services proprietary Script Converter Solution which can swiftly convert external emulator automation scripts to HCL ZIEWin or HCL ZIEWeb compatible.  The HCL ZIEWeb supports Excel VBA scripts written in EHLLAPI with IBM EHLLAPI bridge (32-bit only). Customers migrating to HCL ZIEWin or HCL ZIEWeb can connect with the HCL Lab Services team to leverage the Script Converter Solution for a semi-automated migration solution HCL ZIEWin and HCL ZIEWeb are HCL equivalent products of IBM Personal Communication (PCOMM) and IBM Host on Demand (HOD) that have the same feature set and functionalities as later. Script Converter Solution: Converter solution is a standalone application provides a graphical interface to convert a single script or multiple scripts in a directory from competitive products script to HCL ZIEWin/ZIEWeb equivalent. The solution automatically identifies script file type, script API type, and converts to relevant conversion format of ZIEWin or ZIEWeb. It can also convert script which contains multiple external emulator API types in a single file. Converted scripts can be viewed in comparison editor to compare with the original scripts. A comparison editor helps in reviewing and modifying converted scripts before completing the final conversion...
a/icon/common/search Created with Sketch.