This tutorial illustrates how to use the J2C wizard to
build a simple web application that processes an IMS™ transaction that returns a phone book record.
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, V7.0, V8.0, or V8.5.
To use this sample, you must have an application server installed
and configured. To verify that a server runtime environment is available,
click , 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 will:
- Use the J2C Java bean wizard
to submit a transaction to IMS.
- Create a Java method, runPhonebook.java, which accepts a customer number and
returns information about the customer.
Learning objectivesIn this tutorial,
you will:
- Use the J2C Java bean wizard
to create a J2C application that interfaces with an IMS transaction.
- Create a Java method, runPhoneBook.java , which accepts an individual's name
and returns the individual's contact information.
- Create a JSP to deploy the application on WebSphere® Application Server.
- Create a Faces JSP to deploy the application on WebSphere Application Server.
Time required
This tutorial should take
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 V7.0,
V8.0, or V8.5.
- J2EE Connector (J2C) tools installed
- Information about your IMS environment: In this tutorial, your application interacts with
an IMS 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. Specifically, you need to perform some setup work in IMS if you want to run the IMS\PhoneBook IMS program.
- A copy of the COBOL file ex01.cbl: You may locate this
file in your product installation directory: <installdir>\IBM\SDP70Shared\plugins\com.ibm.j2c.cheatsheet.content_7.0.0\samples\IMS\PhoneBook.
If you want to store it locally, you can copy the code from here: EX01.cbl.
- A clean workspace.
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