Contents

About This Guide

What you Should Already Know
User Roles
What's in This Guide
Documentation Conventions
Online Guide
Related Information

Installing Sun ONE Connector Builder

Overview
Software and Hardware Requirements
Additional Software Needed for Deploying the Samples
Preparing to Install the Connector Builder

User Privilege Requirement

Installing Connector Builder on Windows NT/2000/XP
Uninstalling Connector Builder on Windows NT/2000/XP
Installing Connector Builder on Solaris or Linux

Preparing for Installing the Connector Builder on Solaris or Linux

Uninstalling Connector Builder on Solaris or Linux
Sample Adapters and Application

Introduction to Sun ONE Connector Builder Samples

Styles of EIS Application Programming Interfaces

Specific EIS APIs
General-purpose EIS APIs

General Approach to Building Adapters with Connector Builder
Samples

Customer Order Tracking System (COTS) Sample
Data Base Management System (DBMS)

Lessons for Creating a COTS Sample Resource Adapter

Lesson 1 - Mount the COTS EIS API and a Working Directory
Lesson 2 - Define the Resource Adapter

Step 1 - Choose Template
Step 2 - Specifying Adapter Location Information
Step 3 - Entering Adapter General Information
Step 4 - Mapping the EIS API
Step 5 - Customizing Interaction Specs
Step 6 - Specifying Configuration Properties
Step 7 - Choosing Authentication and Transactional Support
Step 8 - Enter Licensing Information (Optional)
Step 9 - Set Adapter Icons (Optional)

Lesson 3- Generate the COTS Resource Adapter
Lesson 4- Customize the Generated Code for the COTS Adapter

Customize the Methods for the COTS Adapter
To Customize the ManagedConnectionFactory Method

Lesson 5 - Copy the EIS Client Files
Lesson 6 - Build and Package the Resource Adapter
Lesson 7- Generate SOAP Services for the Connector Builder COTS Resource Adapter (optional)

Adding SOAP Services Configuration

Edit the Serializers for Each JIO

Generating SOAP Services
Customizing the Generated SOAP Clients

Customize the Methods for the COTS SOAP Client
To Customize the populateInputData Method

Summary

Deploying the COTS Sample Adapter

Customer Order Tracking System (COTS) Sample

Directory Structure

Adapters Directory
Application Directory
eissystem Directory

Deploying, Configuring, and Running the COTS Sample
Step 1 - Deploy and Configure the COTS Resource Adapter

iPlanet Application Server 6.5
iPlanet Web Server 6.0
J2EE RI Server 1.3.1
Sun ONE Application Server 7.0

Step 2 - Deploy the Web-Based Sample Application

iPlanet Application Server 6.5
iPlanet Web Server 6.0
J2EE RI Server 1.3.1
Sun ONE Application Server 7.0

Step 3 - Start the COTS EIS Server
Step 4 - Run the Sample Application
Step 5 - Run Sample Tests Using the TestClient
Step 6 - Deploy SOAP Services and Run the SOAP Clients (Optional)

Deploy COTS SOAP Services
Running the SOAP clients

Lessons for Creating a DBMS Sample Resource Adapter

Lesson 1 - Mount a Working Directory
Lesson 2 - Define the Resource Adapter

Step 1 - Choose Template
Step 2 - Specifying Adapter Location Information
Step 3 - Entering Adapter General Information
Step 4 - Specifying Configuration Properties
Step 5- Choosing Authentication and Transactional Support

Lesson 3- Generate the DBMS Resource Adapter
Lesson 4 - Customize the Generated Code for the DBMS Adapter

Customizing the DBMS Adapter
Connection and Transaction Customizations
To Customize the Methods for the DBMS Adapter

To Customize the getEISProductName() Method
To Customize the getEISProductVersion() Method
To Customize the getMaxConnections() Method
To Customize the getUserName() Method

EIS API-related Customizations

To Customize the createIndexedRecord(String recordName)Method
To Customize the execute(javax.resource.cci.InteractionSpec iSpec, javax.resource.cci.Record iRec)Method
To Customize the exec(String procName, String schema, String catalog,Record input, Record output) Method

Lesson 5 - Copy the JDBC API
Lesson 6- Build and Package the DBMS Resource Adapter

Summary

Deploying the DBMS Sample Adapter

Deploying, Configuring, and Running the DBMS Sample

Oracle Client Requirements
Step 1 - Deploy and Configure the DBMS Sample Resource Adapter

iPlanet Application Server 6.5
iPlanet Web Server 6.0
J2EE Reference Implementation Server 1.3.1
Sun ONE Application Server 7.0

Step 2- Configure the Database
Step 3 - Verify the DBMS Resource Adapter Deployment

Glossary

Index