Most of IBM® CICS® enterprise applications that are currently running in IBM® TXSeries® for Multiplatforms are accessed by using IBM® 3270 consoles. Modernizing these proven and reliable applications should not lead to change in the applications. IBM® Rational® Host Access Transformation Services (HATS) enables organizations to quickly modernize existing 3270 green screen applications without changing the application source code so that users can access them through their web browsers.
Introduction to the TXSeries for Multiplatforms
IBM TXSeries for Multiplatforms is a distributed CICS transaction processor for mixed-language applications. It is widely used for integrating data and applications between distributed solutions and enterprise systems, and deployment of CICS applications written in COBOL, C / C++, and PL/I programming languages. The TXSeries also provides extremely good connectivity with CICS Transaction Server (CICS TS) on IBM® z/OS® systems. This acts as a gateway to CICS TS to increase the performance and protect it from client-originated disruption. Uniquely, TXSeries allows you to scale up to CICS TS on the mainframe as the needs of your business grow.
TXSeries for Multiplatforms controls the processing of transactions in a business system, even when the transactions are working concurrently on different computers and accessing the same data. User application programs do not have to perform the specialized task scheduling and control and the data routing and locking that are required by transaction processing. Transaction processing services enable application programs to concentrate on business logic and not on how the logic is implemented. These services are implemented by TXSeries CICS regions to provide each user with a single-user view of the transaction processing system, while maintaining the data integrity and optimum performance for many concurrent users.
Why modernization is required
CICS is a proven platform for deploying the enterprise applications from the last couple of decades. These applications will produce a lot of data, and if this data could be available in a format that allows it to be easily combined with other data, either within the enterprise or available on the Internet, business users could have the ability to use this data to help solve business issues by using a feature-rich, modern browser interface. It also extends the life of traditional applications by reusing the existing data in a modernized way.
How to deploy a 3270 map-based application on TXSeries for Multiplatforms
This section explains how to create and configure the TXSeries region for running 3270 basic mapping support (BMS) map-based CICS applications in an IBM® AIX® system. It also explains how to deploy and use the application in TXSeries regions. Figure 1 shows a typical application, where the client software connects to the application deployed in a TXSeries region through traditional 3270 clients and CICS transactional gateway. It also shows the connection mechanism after converting the BMS maps with Rational HATS.
Figure 1. Typical TXSeries application deployment
The following section explains how to create and configure a TXSeries region to deploy the application by using BMS maps.
Creating and configuring the TXSeries region
A TXSeries for Multiplatforms region is a named collection of resources that are controlled by TXSeries as a unit. A TXSeries resource is any facility or component of a TXSeries CICS system that is required to perform a task. The resources in a region include programs, basic mapping support (BMS) map sets, transactions, terminals, files, transient data queues, temporary storage queues, and journals. Each TXSeries region is defined (by permanent resources) by a list of resources with which it can be started. When the CICS region starts, resources are loaded into the CICS region as runtime resources. TXSeries uses Structured File Server (SFS) as a file manager by default.
Configuring and starting a new TXSeries region
Perform the following steps on the machine on which you intend to run a region that uses a local SFS server as file manager:
- Ensure that you are logged in as
- Ensure that the SFS is running.
- Configure the region. Enter the
cicscp create regioncommand:
#cics_install_dir/bin/cicscp -v create region region_name
Where region_name is the name of the region that you want to create. Figure 2 shows the example for creating the region.
cicscp -v create region hatsdemo
The name of the region must not exceed eight characters in length. Do not use underscores ( _ ), spaces, or the word "stanza" in the region name.
Figure 2. Sample TXSeries region creation using the cicscp administrative tool
- Start the region. Enter the
cicscp start regioncommand:
# cics_install_dir/bin/cicscp -v start region region_name
cicscp -v start region hatsdemo StartType=cold
If the region was created and started successfully, a directory for it exists in the var/cics_regions directory. This directory has the name that you specified for the region.
Configuring a TXSeries region with a BMS map-based sample application
To configure the TXSeries region with BMS map-based application developed in C programming language, perform the following steps on the server that contains the region:
- Log into the machine as
- Ensure that your PATH environment variable includes the /bin, /usr/bin, cics_install_dir/bin directories and the directory that contains the executable files for the C compiler.
- Stop the region that you want to configure if it is already running. Enter this command:
# cics_install_dir/bin/cicscp -v stop region region_name
cicscp -v stop region hatsdemo
- Ensure that the SFS server that manages the region files is running. Enter this command:
# cics_install_dir/bin/sfsadmin list lvols -server \ /.:/cics/sfs/sfs_server_name
Where sfs_server_name is the name of the SFS server. The command output displays the name of the data volume that was created for the SFS server, if it is running correctly.
Figure 3 shows the output for the sfsadmin command.
sfsadmin list lvols -server /.:/cics/sfs/ajnabi1
Figure 3. List data volumes of the SFS server by using the sfsadmin command
- Enter the following command for configuring the sample application:
# cics_install_dir/bin/cicsivp -r region_name \ -s /.:/cics/sfs/sfs_server_name -v data_volume
Where region_name is the name of the region that is to be configured, sfs_server_name is the name of the SFS server, and data_volume is the name of the data volume of the SFS server. Figure 4 shows the list of resource definitions to be added to configure the sample application.
cicsivp -r hatsdemo -s /.:/cics/sfs/ajnabi1 -v sfs_Sajnabi1
Figure 4. Adding resource definitions for configuring the application
- When the configuration is finished, cold-start the region that you configured by using the
cicscpcommand (also see Figure 5):
# cics_install_dir/bin/cicscp -v start region region_name StartType=cold
cicscp -v start region hatsdemo StartType=cold
Figure 5. Cold start the region by using the cicscp command
Creating a Telnet server for TXSeries regions
The TXSeries Telnet server process (
cicsteld) allows client software that can interpret an IBM 3270 Information Display System to connect to a TXSeries region. The Telnet terminal resides on the client's system, receives input, and communicates with the Telnet server process,
cicsteld, on the destination machine. The
server process then communicates with the TXSeries region.
- Use the
cicscp create telnet_servercommand to create the cicsteld process:
#cics_install_dir/bin/cicscp create telnet_server serverName -P portNumber -t transid -r region_name
Where serverName is the name for the Telnet server, portNumber is the numeric port number on which the
process listens for incoming Telnet client requests, region_name is the region to connect with, and transid is the initial transaction to be invoked.
cicscp -v create telnet_server HATS -P 9009 -r hatsdemo -t MENU
You must specify
while creating the Telnet server for connecting to the application deployed in the TXSeries region from Rational HATS, because HATS relies on the initial data from the server for further processing.
Now the region is ready with BMS application configured to use it. The next section explains how to connect to this BMS application that is running on a TXSeries region from HATS running on Microsoft® Windows®.
Connecting to a BMS application running on a TXSeries region from HATS
- From the Windows server, select Start > Programs > IBM Software Delivery Platform > IBM Rational HATS 7.5 > HATS Toolkit 7.5 to launch the HATS home screen. To create the new project, follow these steps, (also shown in Figure 6):
- Select File > New > HATS Project.
- Specify the name, choose the target server from available options from drop-down menu, and specify the enterprise application project name.
- Click Next.
Figure 6. Creating a project in the HATS toolkit
- Configure the connection settings by specifying the Host name (where the TXSeries region is created and the application is deployed), Type, Port, Code page, and Screen size details for where the BMS application is running, as shown in Figure 7.
Make sure that the Port mentioned in Connection Settings in HATS is the same as the port that you used while creating the Telnet server on the TXSeries region side.
Figure 7. Configuring the connection settings
- Choose a theme from the different themes available on the Project Theme screen, as shown in Figure 8, and then click Finish. Make sure that the Keyboard support option is selected while you are creating the theme. For more information about these settings, check the Rational HATS information center.
Figure 8. Choosing the theme for the HATS project
- Go to HATS Projects tab in left navigation panel, expand the hatsdemo project, expand Connections, and right-click the main (default) option.
- Choose the following options from the menu that is generated:
- Select Open HATS Host Terminal > main to connect to the BMS application deployed in the TXSeries region, as shown in Figure 9.
- Before connecting to the application, make sure that the application is deployed in the region created in TXSeries server and also the Telnet server.
Figure 9. Connecting to the application by using Host Terminal option
.When the application is connected from HATS and the initial BMS screen from application is displayed on the Host Terminal screen, Rational HATS automatically converts the fields available on the BMS map to its equivalent form fields for the web page, based on the default options selected.
- Click the Host Screen Preview (Figure 10) to check the default web page that is created by using HATS.
Figure 10. Initial screen from the application
- Right-click the main(default) option, and select the Run on Server option to run the application on the IBM® WebSphere® Application Server, with default screen customization provided by Rational HATS.
- From the Run On Server screen, the Choose an existing server option is selected by default. It will also list the available servers configured on the machine. Choose a server from available servers, and then click Finish.
After the application is deployed and published, you can run the application by using a web browser similarly to a 3270 client.
ADDSin the Enter Transaction field (Figure 11), and type 111111 (six ones) in the Number field.
- Then press Enter to display next page as in 3270 sample application. Type these values into the following fields (press the Tab key to advance from one field to the next):
Name: JOE [not case-sensitive]
Address: 123 MAIN
- Use the Enter key to proceed to the next screen.
- To view the newly added record:
a. In the Enter Transaction field, type
b. In the Number field, type
c. Press Return.
Figure 11. Customized screen with HATS
HATS screen customization for simple 3270 BMS application running on TXSeries
- From the Host Terminal view (as discussed as in Step 4) click the Create HATS Screen Customization option (see Figure 12) so that you can customize the screen.
Figure 12. Create HATS Screen Customization option
- In Screen Customization view, specify the name for the screen event that defines a list of actions to perform on the recognition criteria selected for the screen, and then click Next.
- From the Screen Recognition Criteria screen, click Next, and then on the Actions screen, choose the Prepopulated using Fields pattern.
- Click Finish, and you will see the generated JSP file, or Java™Server Page, InstructionsCVersion.jsp.
- From the InstructionsCVersion.jsp page, under the Design tab, add the Submit button to the screen by right-clicking where you want to place it on the screen and then selecting Insert> Form and Input Fields > Submit Button.
This is a simple example for converting the Enter option from the keyboard for BMS applications to a Submit button for a web page. For a detailed explanation about the screen customization, see the Rational HATS information center or go through the HATS overview demos.
- In the Insert Submit Button screen, enter a Name and Label for the Submit button, and then click OK.
- The Submit button is now added on the Design screen in the JavaServer page. Save the InstructionsCVersion.jsp page to save this customization.
- Go back to the Host Terminal window and enter
ADDSin the Enter Transaction field and 111333 as an example in the Number filed. Then press the Enter key to go the next screen. You can also customize the next screen by clicking the Create HATS Screen Customization option. The input field for the Enter Transaction field can be changed to a drop-down menu.
- Different web design templates are supplied with Rational HATS. Choose a template from the Templates option from the left panel as hatsdemo (Project Name) >Web Content> Templates > Select a template (example: Swirl). Right-click the selected template, and make it the default template by selecting the Set as Default Template option.
- When you have finished all customization, follow the previous steps to access the customized application deployed in WebSphere Application server from a browser.
For instructions on customizing the 3270 BMS screens, see the Rational HATS documentation.
Modernizing 3270-based BMS applications running on a TXSeries region using Rational HATS gives you the following advantages:
- Improves the workflow and navigation of your host 3270 and 5250 applications without any access or modification to the application source code.
- Provides the ability to extend host applications to the web, rich client, portal, web services, and to browsers on mobile devices quickly and at low risk.
- Creates service-oriented architecture (SOA) assets from logic contained in your terminal applications.
- Supports mobile devices, such as cellular phones, data collection terminals, and personal digital assistants (PDAs).
- Learn more about Rational Host Access Transformation Services (HATS). With HATS, you can extend your 3270 and 5250 host applications to the web, to a portlet, to a rich client, or to browsers on mobile devices quickly, easily, and with low risk. There is a trial version that you can download (see the last subsection here).
- Read the HATS documentation for a complete overview of HATS.
- Browse the TXSeries 7.1 information center
- Watch the demos for configuring and modernizing 3270 applications with HATS.
- Review TXSeries product information
- Browse the developerWorks area for WebSphere on System z
- Learn about other applications in the IBM Rational Software Delivery Platform, including collaboration tools for parallel development and geographically dispersed teams, plus specialized software for architecture management, asset management, change and release management, integrated requirements management, process and portfolio management, and quality management. You can find product manuals, installation guides, and other documentation in the IBM Rational Online Documentation Center.
- Visit the Rational software area on developerWorks for technical resources and best practices for Rational Software Delivery Platform products.
- Explore Rational computer-based, Web-based, and instructor-led online courses. Hone your skills and learn more about Rational tools with these courses, which range from introductory to advanced. The courses on this catalog are available for purchase through computer-based training or Web-based training. Some of the "Getting Started" courses are available free of charge.
- Subscribe to the IBM developerWorks newsletter, a weekly update on the best of developerWorks tutorials, articles, downloads, community activities, webcasts and events.
Get products and technologies
- IBM Enterprise Modernization Sandbox for System z
- Trials and demos: Rational HATS
- Trial: IBM TXSeries for Multiplatforms
- Download trial versions of other IBM Rational software.
- Download IBM product evaluation versions and get your hands on application development tools and middleware products from DB2®, Lotus®, Tivoli®, and WebSphere®.
Dig deeper into Rational software on developerWorks
Get samples, articles, product docs, and community resources to help build, deploy, and manage your cloud apps.
Experiment with new directions in software development.
Software development in the cloud. Register today to create a project.
Evaluate IBM software and solutions, and transform challenges into opportunities.