This tutorial illustrates how to use the J2C wizard to build a
simple Web application that processes an IMS™ transaction that returns a phonebook
record.
This tutorial
might require some optionally installable components. To ensure that you have
installed the appropriate optional components, see the System requirements
list.
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 the customer's information.
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 6.1
- J2EE Connector (J2C) tools
- 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 datastore
where the transaction will run. 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 wish to store it locally, you can copy the code from here: EX01.cbl.
- 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 , 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.
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