Introduction:

With ZIETrans, you can create Web applications that provide an easy-to-use graphical user interface (GUI) for your 3270 applications running on System z® platforms and your 5250 applications running on IBM i operating system platforms.

You can also create service-oriented architecture (SOA) assets using Web services that provide standard programming interfaces to business logic and transactions contained within host applications. Data from video terminal (VT) emulation screens can also be accessed.

ZIETrans applications can be given a modern appearance. ZIETrans Web applications can be developed with an interface that matches your company’s Web, and your users can access them through their Web browsers. ZIETrans Web applications can also be developed to provide access from mobile devices such as cellular phones, data collection terminals, and personal digital assistants (PDAs).

The following figure shows the stages of development, deployment, and runtime for a ZIETrans Web application.

  • The developer uses the ZIETrans Toolkit to develop and test a ZIETrans Web application.
  • When ready, the developer deploys the ZIETrans application by exporting it as a Java™ EE application and installing and running it on a WebSphere Application Server system.
  • Using a Web browser, the user accesses the ZIETrans application.
  • The ZIETrans runtime connects to the target host system through a Telnet server.
  • As the user interacts with the host through the ZIETrans application, the ZIETrans runtime transforms host screens to a GUI.

You can configure application server for ZIETrans by following steps below:

Method 1:

  1. Open the ZIETrans toolkit click on menu bar, click Window -> Show View.
  2. Server tab will open below.
  3. To add a server Right click -> New-> Server.
  4. In the New Server Runtime Environment dialog, expand the IBM folder.
  5. Select WebSphere Application Server Liberty Profile in the New Server Runtime Environment dialog box and provide path of the server in your directory.
  6. Select WebSphere Application Server Liberty Profile.
  7. Select the Create a new local server box to create a new Liberty Profile server on your workspace Servers tab.

Method 2:

  1. Open the ZIETrans toolkit click on the menu bar, click Window > Preferences.
  2. In the left panel, expand Server.
  3. Click Runtime Environments.
  4. In the Server Runtime Environments panel, click Add.
  5. In the New Server Runtime Environment dialog box, expand the IBM folder.
  6. Select WebSphere Application Server Liberty Profile.
  7. Select the Create a new local server box to create a new Liberty Profile server on your workspace Servers tab.

Run Application Using Websphere Liberty Server:

You can test your Liberty Profile application within ZIETrans local test environment using the Run on Server, Debug on Server, and Profile on Server functions.

Considerations and limitations for WebSphere Application Server Liberty Profile

When using Debug on server to test your application, a display issue might occur on the terminal window. You might receive the following error message:

ERROR HPS5018 An unexpected exception has occurred.

Frame unable to display: java.awt.HeadlessException.

If this error occurs in the console, you can fix this problem by following these steps.

  1. In the ZIETRANS Projects view, open the Servers tab.
  2. Right-click on the WebSphere Application Server Liberty Profile server listed and click on New > Server Environment File > jvm.options.
  3. Add the value to the file:

-Djava.awt.headless=false

4. Save and close the jvm.options file.

5. Restart the server to activate the changes.

For more details on Configuring Application Server, see the video:

https://youtu.be/HRWvm1vuKlg

Contact us

For further information on Organizing Web Applications in HCL ZIE, automation capabilities and Lab services offerings, please write to:

ZIO@hcl.com

Sudhir Ranjan Rout

Developer, Lab Services, HCL ZIE

 

Comment wrap
Further Reading
Mainframes | October 14, 2020
HCL ZIE for Web Hardware and Software Pre-requisites
HCL Z and I Emulator for Web provides secure host access to Users in intranet-based and extranet-based environments. Z and I Emulator for Web is installed on a Web server, simplifying administrative management and deployment, and the Z and I Emulator for Web applet or application is downloaded to the client browser or workstation, providing user connectivity to critical host applications and data.   1.1. System Requirements This document provides the system requirements for Z and I Emulator for Web, version 1.0. Higher maintenance levels, such as fix packs and service packs, may be supported as they become available. 1.2. Supported Environments Client Environment Details Client Operating System/Architecture Client Java Java Version Java Architecture Browser Version Browser Architecture Client Type Red Hat Enterprise Linux (RHEL) 7.6 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 32-bit 74 Mozilla FireFox 32-bit Java Network Launching Protocol (JNLP) Red Hat Enterprise Linux (RHEL) 7.6 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 75 Mozilla FireFox 64-bit Launcher Red Hat Enterprise Linux (RHEL) 7.6 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 32-bit 74 Mozilla FireFox 32-bit Launcher Ubuntu 18.0.4 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 32-bit 74 Mozilla FireFox 32-bit Java Network Launching Protocol (JNLP) Ubuntu 18.0.4 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 75 Mozilla FireFox 64-bit Launcher Ubuntu 18.0.4 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 32-bit 74 Mozilla FireFox 32-bit Launcher Red Hat Enterprise Linux (RHEL) 6.10 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 60.3 Mozilla FireFox 64-bit Launcher Windows 10 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 44.18362 Edge 64-bit Launcher Windows 10 - 64-bit Open Java Development Kit (JDK) 1.8.0_242 64-bit 75 Mozilla FireFox 64-bit Launcher Windows 10 - 64-bit Oracle Java Runtime Environment (JRE) 1.8_221_11 64-bit 80 Chrome 64-bit Launcher Windows 10 - 64-bit...
Mainframes | October 14, 2020
Installing Z and I Emulator for Transformation
Prerequisites Installation Manager Version 1.8.3, or later, is required to install ZIETrans Toolkit. When you install ZIETrans V1.0 using the Installation Manager, the installation process checks that prerequisite packages and features are already installed. If not, a message is displayed, and the install does not proceed. The following sections list the prerequisite packages and features that must already be installed. HCL ZIETrans For HCL ZIETrans (ZIETrans): One of the following SDP packages, or later FixPacks, including the WebSphere® Application Server version 7.0, version 8.0, or version 8.5 development tools features: Application Developer for WebSphere Software V9.7 If none of the required SDP packages are installed, ZIETrans will not install. If this occurs, use the Install function of the Installation Manager to install one of the required packages along with the required features. Then start the ZIETrans install again. If one of the required SDP packages is installed without the required features, ZIETrans will not install. If this occurs, use the Modify function of Installation Manager to add the required features. Then start the ZIETrans install again. Installing ZIETrans Toolkit To install ZIETrans Toolkit: Verify that your system meets all the prerequisites. For more information see Prerequisites. ZIETrans is structured as an Eclipse offering that is installed to a SDP system using Installation Manager. Select the language for the Launchpad. Click OK. The HCL ZIETrans V1.0 window appears. From this window you can install the product and view release information. Be sure to click Release Notes to review last-minute information. When you are ready to install ZIETrans Toolkit, click Install HCL ZIETrans V1.0 which launches the Installation Manager. Note: If Installation Manager is not installed an error message is displayed. 6. The Installation Manager window appears. 7. On the Install Packages panel, the box for HCL ZIETrans is selected for you. Click Next. Note: An error message is displayed if the...
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...
a/icon/common/search Created with Sketch.