 | Task 1: Install the IMS TM Resource Adapter
In this section, you will validate that the WebSphere Application Server runtime environment is available, and then import the IMS TM Resource Adapter.
Using Rational Developer for System z and the J2EE Projects perspective
Start Rational Developer for System z if it is not already started.
-
Select Start > Programs > IBM Software Development Platform > IBM Rational Developer for System z > IBM Rational Developer for System z
|
What is a workspace?
A workspace is a directory that stores files for your projects. You can select your own directory or take the default directory. Artifacts created by Rational Developer for System z will be stored in this directory.
|
|
Important! Be sure that you are using the right workspace. This Lab uses the directory C:\Workspaces\RDZv7 as your work workspace, as shown in Figure 2.
Figure 2. Workspace Launcher in Rational Developer for System z
-
On the Welcome page, click the Workbench icon, as shown in Figure 3:
Figure 3. Workbench icon on the Welcome page
Switch to the J2EE perspective
|
What is a perspective?
A perspective defines the initial set and layout of views in the Workbench window. Within the window, each perspective shares the same set of editors. Each perspective provides a set of functionality aimed at accomplishing a specific type of task, or that works with specific types of resources. For example, the Java perspective combines views that you would commonly use while editing Java source files, while the Debug perspective contains the views that you would use while debugging Java programs.
|
|
Switch from the default z/OS Projects perspective to the J2EE perspective. Within Eclipse, there are several ways to change perspectives.
-
From the Window pull down, select Open Perspective > Other, as shown in Figure 4.
Figure 4. Opening a perspective in Rational Developer for System z
-
Scroll down and select J2EE from the Open Perspective dialog box, as shown in Figure 5:
Figure 5. Choosing the J2EE perspective
|
What is Java EE?
The Java Platform, Enterprise Edition (previously known as Java 2 Platform, Enterprise Edition, or J2EE) provides a standard for developing component-based, multi-tier, enterprise applications.
A Java EE application system typically includes the following tiers:
-
Client tier: In the client tier, Web components (such as servlets, JSP components, or standalone Java applications) provide a dynamic interface to the middle tier.
-
Middle tier: In the server tier, or middle tier, enterprise beans and Web services encapsulate reusable, distributable business logic for the application. These server-tier components are contained on a Java EE Application Server, which provides the platform for these components to perform actions and store data.
-
Enterprise data tier: In the data tier, the enterprise's data is stored and persisted, typically in a relational database.
Java EE applications are comprised of components, containers, and services. Web components, such as servlets and JSPs, provide dynamic responses to requests from a Web page. EJB components contain server-side business logic for enterprise applications. Web and EJB component containers host services that support Web and EJB modules.
|
|
-
Press OK to switch to the J2EE Perspective.
Import the IMS TM Resource Adapter
-
Click File > Import to open the Import dialog box.
-
Enter
RAR, select RAR file, and then click Next to continue, as shown in Figure 6.
Figure 6. Importing a Connector RAR file
-
From the Connector Import dialog, click Browse to locate and import the IMS TM Resource Adapter file.
-
Navigate to the file C:\Program Files\IBM\SDP70\ResourceAdapters\ims15\imsico1011.rar and click Open, as shown in Figure 7:
Figure 7. Importing the IMS TM Resource Adapter RAR file
-
Choose these options, as shown in Figure 8:
-
Accept the default Connector module name of
imsico1011.
-
Using the drop down list, make sure that the Target runtime is
WebSphere Application Server 6.1.
-
Leave the Add the project to an EAR checkbox cleared.
-
Click Finish to complete the import of the IMS TM Resource Adapter.
Figure 8. Importing the connector (the IMS TM Resource Adapter RAR file)
|
What is a resource adapter?
Resource adapters allow your application to communicate with the enterprise information system (EIS). A resource adapter is a system-level software driver that is used by a Java application to connect to an EIS. The resource adapters reside on the application server and provide connectivity between the EIS, the application server, and the enterprise application. Applications deployed on the application server communicate with the resource adapter using the Common Client Interface (CCI). The RAR contains all the information necessary for installing, configuring, and running a resource adapter. Resource adapters comply with the J2EE Connector Architecture specification. In this lab, you are using IMS TM Resource Adapter to connect to IMS.
|
|
-
The IMS TM Resource Adapter module should now be visible in your J2EE perspective, as shown in Figure 9:
Figure 9. IMS TM Resource Adapter Version 10.1.1 module in J2EE project explorer
| |
