IBM WebSphere Host Access Transformation Services (HATS) V5

Tutorial Module 4

Migrating a Host Publisher v4 application into HATS v5 Studio and running on server

Abstract

This tutorial is designed for anyone who wants to learn how to migrate a Host Publisher v4 application and bring it into a HATS v5 project. The Host Publisher v4 application is a simple application consisting of one Integration Object and two JSPs. This module will go through the basic steps to bring it in and run the application within the HATS v5 studio environment.

Assumptions / Requirements

It is assumed that the user has already installed WebSphere Studio 5.1 and the HATS Studio v5 software on a supported platform. The platform requirements were covered in the HATS Tutorial - Module 1. It is also assumed that a network connection can be made to the publicly accessible IBM Demonstration iSeries host at:

Host name: iseriesd.dfw.ibm.com, port: 23, type: 5250

Connectivity to this host can be tested by using any TN5250 emulator configured for the settings above. A WebSphere application server that meets the requirements for HATS needs to be available if you want to deploy the HATS application to a production WebSphere server. It is assumed that you are already familiar with the WebSphere application server console.

Topics covered on this tutorial

Importing into HATS v5 studio the Host Publisher v4 application
Creating web pages from the Integration Object within the HATS v5 Studio
Testing the application using Run on Server feature

Host Publisher v4 application

A sample Host Publisher v4 application is used for this exercise. It is a simple inquiry search application using the boats application that is used for other demo exercises. A Host Publisher v4 application EAR file is provided for you to use. This EAR application file contains the Host Publisher resources to complete this module. The two main components that we will be working with is the two JSPs and and the one Integration Object that is part of the EAR file.

Figure 1. Host Publisher v4 Application Integrator with boatloop application opened.

Figure 2. Example of creating J2EE archives for use with HATS v5 Studio.

Figure 3. boatloop.ear resides in the HostPub\Studio\Applications\boatloop folder if you use default locations.

Copy the provided Host Publisher v4 EAR to a location on your local hard drive.

Create a HATS v5 project

With the HATS v5 studio open, create a new project for this module using the following settings:

Host name: iseriesd.dfw.ibm.com
Port: 23
Type: 5250

Figure 4. Initial Project View of HATS module 4.

Project folders that will be used when using Host Publisher applications with HATS v5:

Macros - this folder is where HATS macros will be imported
Integration Object Pages - this folder is where Java Server Pages are kept that are associated with Integration Objects
Source - this folder is where Host Publisher Integration Objects will be imported

Import Host Publisher EAR into the HATS project

Highlight the hatsv5mod4 project go to File -> Import and select the Host Publisher EAR file and click Next.

Figure 5. Importing Host Publisher EAR into the HATS project.

The Import Host Publisher EAR panel will open, browse to the location for the boatloop.ear file on the hard drive and then click Finish.

Figure 6. Import Host Publisher EAR panel.

Figure 7. Migration Report indicating the migration ran successfully.

Figure 8. Automatically Generate IO message box.

Figure 9. Navigator view of project. Notice that the Boatloop.jar (Host Publisher Integration Object) is under the Web Content/WEB-INF/lib folder.

Figure 10. HATS project view with Host Publisher Java Server Pages from the Host Publisher application in the project.

Running the imported Host Publisher application on the server

To run the application, highlight the boatloopinp JSP and right click and select Run on Server.
The application should run and the boatloopinp JSP should open in the browser.
Select a type of boat and then click on the Submit button.
The boatloop out should run and the results should be presented to you in the browser.

Figure 11. Boatloopinp JSP in browser after Run on Server selected.

Figure 12. Boatloopout.jsp after making All for the selection and clicking on Submit button.

Conclusion

In this tutorial you were shown how to import a Host Publisher v4 application into HATS v5 studio and run it on the server and also where the Host Publisher application files are kept in the HATS v5 project.

Copyright: Licensed Materials - Property of IBM
             (C) Copyright IBM Corp. 2002, 2003 All rights reserved.
             U.S. Government Users Restricted Rights -
             Use, duplication or disclosure restricted by
             GSA ADP Schedule Contract with IBM Corp.