Introduction: Create a J2C application for an IMS transaction containing arrays

This tutorial describes how to use the J2C Java Bean wizard to build a simple web application that processes an IMS™ transaction with input and output data containing arrays.

This tutorial might require some optionally installable components. If you encounter errors or cannot find user interface options when you run the sample, ensure that you installed the appropriate optional components:

IBM® WebSphere® Application Server, version 7.0 OR IBM® WebSphere® Application Server, version 6.1 with the fix pack for EJB 3.0 installed

To use this sample, you must have an application server installed and configured. To verify that a server runtime environment is available, click Window > Preferences, expand Server, and then click Installed Runtimes. You can use this pane to add, remove, or edit installed server runtime definitions. You can also download and install support for a new server.

This tutorial is divided into several exercises that must be completed in sequence for the tutorial to work properly. This tutorial teaches you how to use the J2C Java Bean wizard to create a Java bean that runs a transaction in IMS. While completing the exercises, you

Use the J2C Bean wizard to create a J2C Java bean that runs an IMS transaction.
Create a Java method for the bean, runInOut.java, to run the IMS transaction.
Create a test proxy Java class, TestInOutProxy.class, to build the input message for the IMS transaction, invoke the J2C Java bean method that runs the IMS transaction, then display the output data returned by the IMS transaction.
Note: The TestInOutProxy.java Java class was created for an English locale; you have to modify the code for other locales.

Time required

This tutorial takes approximately 30 minutes to finish. If you explore other concepts related to this tutorial, it could take longer to complete.

Skill level

Experienced

Audience

This tutorial is intended for users who are familiar with Enterprise Information systems (EIS) and IMS in particular.

System requirements

To complete this tutorial, you need to have the following tools and components installed:

IBM® WebSphere® Application Server, version 6.1
J2EE Connector (J2C) tools
Information about your IMS environment: In this tutorial, your application interacts with an application program in IMS. You need to obtain information such as the host name and port number of IMS Connect and the name of the IMS data store where the transaction runs. Contact your IMS systems administrator for this information. In addition, you need to perform some setup work in IMS if you want to run this sample.
A copy of the COBOL file InEqualsOut.cbl: You can locate this file in your product installation directory: <installdir>\IBM\SDP70Shared\plugins\com.ibm.j2c.cheatsheet.content_7.0.0\samples\IMS\InOutArray. If you want to store it locally, you can copy the code from here: ../resources/inequalsout.html
A clean workspace.

To use this tutorial, you must have an application server installed and configured. To verify that a server runtime environment is available, click Window > Preferences, expand Server, and then click Runtime Environments. You can use this pane to add, remove, or edit installed server runtime definitions. You can also download and install support for a new server.

Prerequisites

In order to complete this tutorial end to end, you should be familiar with:

J2EE and Java programming
Basic IMS Transaction Manager (IMS TM) concepts