HCL ZIE License Manager

Table of Contents


License manager is a tool that facilitates effective software management between end users and software vendors, thereby enabling organization to track and document the usage of the company's software products. HCL ZIE License Manager is the license control tool used to track the license information for Mainframe Terminal emulator products like HCL ZIE for Web and HCL ZIE for Windows.


The HCL ZIE License Manager can be configured for the following versions of HCL Terminal Emulators:

* HCL ZIE for Web version 1.0 & above

* HCL ZIE for Windows version 1.0 & above


HCL ZIE License Manager (LM) can track license usage for both ZIE for Web and ZIE for Windows, when it is installed and configured with WebSphere Application Server (WAS), ZIEWeb Embedded Server or Tomcat.


Installation and configuration of HCL ZIE License Manager Server for Z and I Emulator for Web (ZIEWeb) and Z and I Emulator for Windows (ZIEWin)


Prerequisites for the installation of License Manager:

Application Server

Flexera licensing details 

Installation of HCL ZIE License Manager:

Follow the below procedure to install License Manager: 

  1. Download the zip file from Flexnet Operations.
  2. Extract the zip file into a folder.
  3. Install the .ear or .war file on the application server by following the deployment instructions for the respective application server.
  4. Enter the URL to access the License Manager Web application:  

For example:  



<appserver-address>    :    is the hostname or IP address of the server on which license manager is installed, 

 <port-num>     :    is the port that is specified during the deployment of the application server, and 

 <context-root>     :    is the location name that can be configured by the Administrator.

Steps to configure the License Manager:

1. Client-based configuration:


For 'ZIE for Web':

 For all the client types (ZIEWeb Lite Client Launcher and Java Webstart client add the following parameters to the configuration file (config.properties), that is located in the ZIEWEB server publish directory.

 For example:






For 'ZIE for Windows':

 The License Manager settings can either be configured by providing the required server details in the 'InstallShield Wizard' at the time of ZIEWin installation itself, or can be added/updated in the 'License Manager Settings' section of the Advanced tab within the Preferences.


For Host Access Client Library (HACL):


For HACL applications, developers can set the License server URL and timeout values with the below session parameters and statements:

p.put(Session. LICENSE_SERVER_MAC_ADDRESS,"true");
p.put(Session. LICENSE_SERVER_MACHINE_NAME,"false");


2. Configuration of Unique License Count


Administrators can mandate license uniqueness, based on different values, by modifying the “adminConfig.properties” file in the License Manager installed directory. 


For Example:               




Below are the available parameters that need to be modified to define uniqueness. 


               IP address                      ip

               System user name        :   systemusername

               MAC address               :   macaddress

               Machine name            :   machinename 


Any combination of the above attributes can be used to define license uniqueness. If more than one parameter value has to be configured, then each parameter should be separated by a semi colon (;). 


Note : 

a).  While re-defining a unique user with existing logs, provide a different installation location for License manger in the servlet parameters (or delete the existing License manager folder) and restart, to avoid errors during license count calculation.

b).  Restart the HCL ZIE License manager, after re-defining the unique user.


3. Configuring the ZIE License Manager Servlet Parameters


 Following is a list of parameters that can be used to configure the License Manager:







Enable/ disable ZIE for Windows client



Enable/ disable ZIE for Web client


https://[license server host]/api/1.0/instances/[license server ID]

Flexera server URL for ZIE for Windows



Flexera private key location for ZIE for Windows


https://[license server host]/api/1.0/instances/[license server ID]

Flexera server URL for ZIE for Web



Flexera private key location for ZIE for Web



Directory Location for logs


Depending on the application server that is used to deploy the License Manager application, the path from which the above properties can be initialized may change.

For WebSphere Application Server (WAS):

For Embedded Web Server:

For Tomcat Server:

Return to Top


Using the HCL ZIE License Manager:


After the server module is successfully installed, Administrators can use the license logger to monitor the client login from the License Manager Admin console.

The console can be accessed by navigating to:  

When prompted for a username and password, Users may login with the default username admin and password password.



After logging in as a License Manager Admin, you can change the password by clicking on “admin on the menu bar. Refer to the ”Create New User" and "Change User Password"  sections below, for more information.


 As a License Manager Administrator, you can perform the following tasks:

License Information:

Total active licenses
- Number of active concurrent licenses for both ZIE for Web & ZIE for Windows combined.

License Count Statistics:

Highest Concurrent License Count
 -  Highest concurrent license count gives the maximum number of distinct users who have accessed the product (ZIE for Web / ZIE for Windows) simultaneously, since the installation of License Manager.

Highest Authorized License Count
- Highest authorized license count gives the maximum number of authorized users who have accessed either of the products ZIE for Web / ZIE for Windows) on a day.

Cumulative Authorized License Count
 -  Cumulative Authorized License Count gives the total number of distinct authorized users who have accessed either of the products (ZIE for Web or ZIE for Windows) till date, since the installation of License Manager.

- Clicking on the More option takes us to the License Summary Report for both the products combined.

 By default, the report shows a daily summary of licenses for the individual products, ZIE for Web and ZIE for Windows. The filter feature can be used to view the license usage for a specified date interval. It includes the following information for each product:

 The Admin can sort specific columns as required.




License Count Statistics specific for ZIE for Web and ZIE for Windows:




Each section/tab shows the following information for the corresponding product. 

  1. Active Licenses
  2. Highest Concurrent License Count (Today)
  3. Highest Concurrent License Count
  4. Total Authorized Used License (Today)
  5. Highest Authorized License Count
  6. Cumulative Authorized License Count 

Active Licenses
 Active concurrent licenses for ZIE for Web / ZIE for Windows (for the active sessions). Admin can view the active client details by clicking the highlighted Active Licenses link. Active clients report shows the below information about all active clients at that time.

 The Administrator can sort specific columns as required.

Highest Authorized License Count
Highest Authorized license count gives the maximum number of authorized license users accessing the product (ZIE for Web /ZIE for Windows) on any day since the installation of License Manager.

Cumulative Authorized License Count
Cumulative Authorized license count of distinct authorized users since the installation of license Manager for the product (ZIE for Web and ZIE for Windows).

License usage details:

License details report for the current day (ZIE for Web and ZIE for Windows). 

Log level

This option is available on "License usage details" page. 

Select the log level (from 1-LOW to 3-HIGH) to filter the number of entries to be logged. The default log level, which is Level 3 (HIGH), logs all the entry parameters, including connection closed entry along with the periodic client check-ins. All the other log levels (1 and 2) will log only the first client check-in and the connection closed entry. 


Following are the parameters which are logged: 



Level 3:  All Parameters

Level 2:  Timestamp, IP, System User Name, Client Type, Sub-Client Type, Machine Name, Connection Status   

Level 1:  Timestamp, IP, System User Name, Client Type, Sub-Client Type, Connection Status  


The license usage report containing Log level 3 (HIGH) with license usage information can be extracted by the Admin into a .csv file (that can be opened as an Excel Workbook). 


User Management: 

To manage Users who can access the License Manager Admin console, click on Users on the menu bar.



To Create a New User


To create a new user, follow the below steps:  

Note: New users for license manager can be created only by the Admin.


To Delete an Existing User


Under the Existing Users section, there is an option to delete the existing user, by selecting the icon image-20180831153902-1 next to the username.


To Reset the Password for an Existing User


If required, Admin can reset the password for a selected user to the default password (‘password’), by clicking on icon image-20180831155312-2 next to the username in the existing users list.


To Change User Password


User can change the current password, by hovering the mouse pointer over the Username field displayed on top of the screen. After specifying the current and new password, Click Submit. 

Return to Top


Flexera Licensing integration for HCL ZIE License Manager


The licensing tool that is integrated with the HCL ZIE License Manager is Flexera, which provides a floating license model using the Flexera REST API client.


The usage of HCL ZIE License Manager sessions and requests are tracked and granted by Flexera licensing. For licensing to work in HCL ZIE License Manager applications, the Flexera server and the required runtime properties need to be pre-configured.


HCL ZIE License Manager Users may configure an on-premise license server or use HCL's Flexera Cloud Server. After configuration of the license server, License Manager Administrators need to create a public/private key pair, out of which, the public key is to be uploaded to the License server and the private key is used to configure the License Manager for communication with the server.

For more information on the Secure License Server Configuration of Flexera Licensing Integration for ZIEWeb, refer to Configuring HCL Z and I Emulator for Web with Flexera


Limitations of HCL ZIE License Manager:


National Translation is not available. Help files are currently available only in English.


Return to Top