Interoperability between HCL Z and I Emulator for Windows and HCL Z and I Emulator for Web Clients
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.
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.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) |
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
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.