HCL SW Blogs
Select Page

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

Web Application Deployment in HCL ZIETrans

Ways to organize the HCL ZIETrans Web Applications:

Associating multiple .war or HCL ZIETrans projects with one .ear and de-associating can be achieved using deployment descriptor application.xml present in the META-INF folder of the EAR.

The sections below demonstrate

  • Creating individual .ear for each project on HCL ZIETrans Toolkit
  • Adding multiple .war to one .ear in application.xml
  • Removing .war from .ear in application.xml and deploying the same.

Creating individual .ear for each project

  1. Go to File->New-> ZIETrans Project. On the Create a Project console, specify a name for the
    Enterprise application project (.ear) to be created as shown.
  2. Click Next and specify connection settings. Click Finish.
A screenshot of a social media postDescription automatically generated

Figure 1: Create a project

 

The created project and EAR in the Navigator are displayed.

Web Application Deployment in HCL ZIETrans

Figure 2: Created project

By default, all HCL ZIETrans Web applications are associated with existing enterprise archive file. Hence the next project will have a .ear name same as above ZIETrans_testOne_EAR. We could continue using it.

Or we can provide a different.ear name in step 1: ‘Create project’ dialog which will create separate .ear for the individual project.

Web Application Deployment in HCL ZIETrans

Figure 3: .ear for the individual project

After creating individual ears and deploying it on server:

Web Application Deployment in HCL ZIETrans

Web Application Deployment in HCL ZIETrans
Figure 4: Individual ears deployed on server

 

Adding multiple .war to one .ear in application.xml

Initially, there are 4 projects in the workspace. Where, the project “testFour” is imported as folder into the workspace.

Web Application Deployment in HCL ZIETrans

Figure 5: projects in the workspace

  1. Take project ear to which you want to add .war file to, for instance, ZIETrans_testThree_EAR. Expand the META-INF folder to find application.xml and double click to open the editor.

Web Application Deployment in HCL ZIETrans

Figure 6: Deployment Descriptor Editor

As we see in ZIETrans_testThree_EAR, “testThree.war” is already present in the Overview section. Let’s add 2 others .war to it. for instance, testFour and testOne.

2. So to add .war, click on Add button shown on the right side of the Overview. Add Item window appeares. Click on Module and click OK.

Web Application Deployment in HCL ZIETrans

Figure 7: Add Item window

3. The next window shows the available modules/projects in the workspace. Add these modules one by one. Select the module and click Finish. Save the application.xml.

Web Application Deployment in HCL ZIETrans Web Application Deployment in HCL ZIETrans

Figure 8: Add modules

The Overview window is displayed as below:

Web Application Deployment in HCL ZIETrans

Figure 9: Overview window

4. Deploy the ear on the server and the server.

Web Application Deployment in HCL ZIETrans

Figure 10: Deploy the ear on the server

Web Application Deployment in HCL ZIETrans

Removing .war from .ear in application.xml

  1. Select project ear from which we want to remove .war file from, for instance, ZIETrans_testThree_EAR. Expand the META-INF folder to find application.xml. Double click to open the editor.

Web Application Deployment in HCL ZIETrans

Figure 11: Remove .war file

2. Let us remove testOne.war from the ZIETrans_testThree_EAR. Click on testOne.war in the Overview section and click on Remove button shown on the right side. Save the application.xml.

The Overview section after removing appears as shown below:

Web Application Deployment in HCL ZIETrans

3. Deploying the ear on the server. Restart the server.

Web Application Deployment in HCL ZIETrans

Figure 12: Deploy the ear on the server

Web Application Deployment in HCL ZIETrans

Contact us

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

ZIO@hcl.com

Akshata Betageri

Developer, Lab Services

Comment wrap
Further Reading
Mainframes | November 10, 2022
Sending E-Mails From the Application in ZIE Transformation
HCL ZIETrans makes it possible to build an application that can scrape data from the host, format it as required, and present the formatted data on an e-mail, programmed to trigger the e-mail automatically on any user action.
desktop-computer-beside-analog-camera-3759101
Mainframes | July 8, 2022
Accessing ZIETrans administrative console on Liberty server
The ZIETrans administrative console allows you to view and change problem-determination settings. It also allows: Select the scope of management, View log and trace files, etc.
Using ZIETrans EJB
Mainframes | December 7, 2021
Using ZIETrans EJB
EJB is server-side software that helps summarize a particular application's business logic. With EJB, we can develop secure and scalable distributed applications.
Close
Filters result by
Sort:
|