Interoperability between HCL Z and I Emulator for Windows and HCL Z and I Emulator for Web Clients

The interoperability feature allows the ZIEWin users to use the ZIEWin sessions from other HCL terminal emulator clients, such as ZIEWeb and ZIEWeb Client. ZIEWin users can use the “Session Manager Online” utility to store the new sessions and migrate the existing sessions to ZIE server, these sessions are then converted to ZIEWeb Session formats for the ZIEWeb and ZIEWeb Client usage.

Note: Interoperability feature is introduced in ZIEWin 2.1 version.

ZIEWin client communicates with the ZIE server over HTTP/HTTPS connectivity using JSON data format.

The interoperability feature is supported by ZIEWeb v2.1.0.0 & ZIEWeb Client v2.1.0.0 and is applicable for 3270 Display, 5250 Display, 3270 Printer, 5250 Printer, and VT sessions.

Note: The session conversion happens only for ZIEWin to ZIEWeb sessions and not vice versa.

When the user stores the ZIEWin sessions using the “Session Manager Online” utility, they are converted to ZIEWeb sessions before saving them to the ZIE server . After storing to the ZIE server , users can log in from ZIEWin, ZIEWeb, or ZIEWeb Client to work with the stored ZIEWin sessions.

Using ZIEWin Sessions from ZIEWeb and ZIEWeb Client:

After the ZIEWin sessions are stored in the ZIE server , if any changes are made to the session definition from any of the clients, it is saved in the ZIE server . These session changes will be available to ZIEWin users after the next login.

Below is the list of supported parameters as part of the Interoperability feature.

Table 1. List of Supported Parameters for Interoperability
ZIEWIN Parameter	ZIEWEB Parameter
Primary Host Name or IP Address	Destination Address
Primary Port Number	Destination Port
Primary LU or Pool Name	LU or Pool Name
Screen Size	Screen Size
Host Code-Page	Host Code-Page
Auto-reconnect	Auto-reconnect
Backup 1 Host Name or IP Address	Backup 1 Destination Address
Backup 2 Host Name or IP Address	Backup 2 Destination Address
Backup 1 Port Number	Backup 1 Destination Port
Backup 2 Port Number	Backup 2 Destination Port
Backup 1 LU or Pool Name	Backup 1 LU or Pool Name
Backup 2 LU or Pool Name	Backup 2 LU or Pool Name
Enable Security	Protocol
Workstation ID	Workstation ID
Server Authentication	Server Authentication
Message Queue	Message Queue
Message Library	Queue Library
Send Personal Certificate to Server if it is Requested	Send a Certificate
Send Personal Certificate Trusted by Server	Certificate Source
Send Personal Certificate Based on Key Usage	Enable Key Usage
Machine Mode	Terminal Type (VT session)
AutoWrap	AutoWrap (VT session)

Note: Only the listed parameters will be modified from ZIEWeb / ZIEWeb Client for a ZIEWin profile. If any other parameters are updated from ZIEWeb / ZIEWeb Client, there will not be any changes to the ZIEWin session. Users should modify the ZIEWin sessions either from ZIEWin or ZIEWeb / ZIEWeb Client at a time and should avoid simultaneous modifications from different clients.

Interoperability 2.1.0.0 Configuration Introduction:

ZIEWeb v2.1.0.0 introduced interoperability between ZIEWin and ZIEWeb. This allowed ZIEWin sessions to be accessed through ZIEWeb and ZIEWeb Client after the session definitions were uploaded to the ZIE server .

Password provided during the user creation will be encrypted using AES 128-bit algorithm and will be sent to the server through the HTTP/HTTPS protocol as Json object. UID is added to the WS and BCH profile files for unique identification. Only Connection parameters are considered for the interoperability between ZIEWin and ZIEWeb Clients and vice-versa.

After the ZIEWin sessions are converted and stored in the ZIE server , any changes made to the common parameters from any of the clients will be saved on the ZIE server . These parameter changes will be available to ZIEWin users after the next login.

Steps to install:

Install the ZIEWeb v2.1.0.0.
Install the ZIEWin v2.1.0.0.

WAR File Configuration:

The interoperability executable (ZIEWeb_Interoperability.war) is available under the lib directory of the product.

For Embedded Web Server:

If the Embedded Web Server is used, by default Interoperability application is running on context root "interop”. If the user needs to change the context root, add the following parameter to the configuration file (config.properties), located in the ZIE server publish directory.

Example: InterOpContextPath=interop

The default ZIE server IP is 127.0.0.1 and the ZIE server port is 8999. If the user needs to connect to the ZIE server located on a different machine, then override the interoperability configuration by modifying the properties of “interop_overrides.xml” in the conf directory under the lib directory of the product.

Table 2. List of properties that can be used to configure the Interoperability
Property	Value	Description
ZIEWEB_SERVER_IP	127.0.0.1	ZIE server address
ZIEWEB_SERVER_PORT	8999	ZIEWEB Config Server port
Directory_Location	C:\\dir_location	Directory Location for logs

The user can utilize ZIEWeb_Interoperability.war file (available under the lib directory of the product) to deploy to different application servers such as WAS/Tomcat.

For WebSphere Application Server (WAS):

Log in to WebSphere Application Server.
Go to Applications.
Click WebSphere enterprise applications under Application Type.
Select ZIEWeb_Interoperability.war file.
Click on Initialize parameters for servlets link under Web Module Properties section.
Enter the required values.

Supported Application Servers: Apache Tomcat and WAS.

Limitations

Only connection parameters are considered for interoperability between ZIEWin and ZIEWeb and vice-versa.
Session creation from ZIEWeb / ZIEWeb Client will not be converted to a ZIEWin session.

Known Issues

For stored ZIEWin sessions, changes to any session parameters (not only the listed parameters) from ZIEWeb / ZIEWeb Client will be overridden or set to default when there is an update from “Session Manager Online” (ZIEWin Client).
If there are simultaneous profile updates from any of the two clients, the most recent update will be saved as the final copy in the ZIE server .
Modifications done in multiple sessions (add, delete sessions, or rename) from the ZIEWeb Clients do not reflect in the ZIEWin Client.
Saving/renaming profiles with special characters (Ex: \ / : * ? " < > |.) in ZIEWeb/ ZIEWeb Clients will result in unexpected behavior in the ZIEWin Client.