Contents | Sun Microsystems JDBC/ODBC Adapter specs

Contents

Contents

Chapter 1

Introducing the JDBC/ODBC eWay	7
About Java Database Connectivity (JDBC)	7
JDBC Drivers	7
Type I: JDBC-ODBC Bridge	8
Type One Driver	8
Type II: Partial Java driver	9
Type Two Driver	9
Pure Java driver for database middleware	10
Type Three Driver	10
Type Four Driver: Direct-to-database pure Java driver	11
About the JDBC/ODBC eWay	13
What’s New in This Release	13
About This Document	14
JDBC eWay Javadoc	14
Scope	14
Intended Audience	15
Text Conventions	15
Related Documents	15
Sun Microsystems, Inc. Web Site	15
Documentation Feedback	16

Chapter 2
Installing the JDBC/ODBC eWay	17
Installing the JDBC eWay	17
Installing the JDBC eWay on an eGate supported system	18
Adding the eWay to an Existing Sun Java Composite Application Platform Suite Installation
18
After Installation	19
Extracting the Sample Projects and Javadocs	19
ICAN 5.0 Project Migration Procedures	19
Installing Enterprise Manager eWay Plug-Ins	21
Viewing Alert Codes	22

JDBC/ODBC eWay Adapter User’s Guide

3

Sun Microsystems, Inc.

Image 3

Sun Microsystems JDBC/ODBC Adapter manual Contents

Contents

EWAY JDBC/ODBC Adapter USER’S Guide Part Number Version Contents Activity Input and Output Transaction Support Levels Between Different Versions Stored Procedure Creating the Collaboration Definitions JavaCreate the Collaboration Business Rules Building and Deploying the Project Running the Sample Building and Deploying the prjJDBCBPEL Sample Project About Java Database Connectivity Jdbc Jdbc DriversWhat’s In This Chapter Type One Driver Type I JDBC-ODBC Bridge Cons Type II Partial Java driverType Two Driver Pros Type Three Driver Pure Java driver for database middleware Type Four Driver Direct-to-database pure Java driver Typical Type 3 Middleware Driver Configuration Typical Type 4 Driver Configuration About the JDBC/ODBC eWay What’s New in This ReleaseNew for Version About This Document ScopeJdbc eWay Javadoc Text Conventions Related DocumentsSun Microsystems, Inc. Web Site Intended Audience Documentation Feedback Installing the Jdbc eWay Installing the JDBC/ODBC eWay Installing the Jdbc eWay on an eGate supported system Ican 5.0 Project Migration Procedures After InstallationExtracting the Sample Projects and Javadocs Install Java Caps Import the ProjectDeploy the Project To add plug-ins from the Enterprise Manager Installing Enterprise Manager eWay Plug-Ins Alert Code\Description Description Details User Actions Viewing Alert CodesTo View the eWay Alert Codes Alert Codes for the JDBC/ODBC eWay Duncommitted Chapter Section Configuring the eWay Connectivity Map Properties Creating and Configuring a Jdbc eWay Connectivity Map with Components To configure the eWay properties Example Transaction Support Levels Between Different Versions Transaction Support Levels To Configure the Environment Properties Configuring the eWay Environment Properties EWay Connectivity Map Properties Outbound eWay Configuration Sections Include Connectivity Map Outbound non-Transactional eWay Properties Outbound XA eWay Configuration Settings IncludeEWay Environment Properties Connectivity Map Outbound eWay Properties Name Description Required Value Inbound Jdbc eWay-Parameter SettingsInbound Jdbc eWay Properties Outbound Jdbc eWay Properties ConnectionPoolDataSource Jdbc Connector SettingsOutbound Jdbc eWay-JDBC Connector Settings Is Jdbc Connection Pool Datasource Connection Retry Settings Outbound Jdbc eWay-Connection Retry SettingsXADataSource or ConnectionPoolDataSource Outbound non-Transactional Jdbc eWay Properties Outbound non-Transactional eWay -JDBC Connector Settings Outbound non-Transactional eWay -JDBC Connector Settings Outbound XA Jdbc eWay Properties Outbound non-Transactional eWay-Connection Retry Settings Outbound XA Jdbc eWay-JDBC Connector Settings Is Jdbc XA DatasourceConnectionPoolDataSource or Outbound XA Jdbc eWay-Connection Retry Settings Outbound XA Jdbc eWay-Connection Retry Settings Creating a New Jdbc OTD About the Database OTD Wizard Connect To Database Select Wizard Type Select Database Objects Required Database Connection Fields includeSteps Required to Select Database Objects Include Steps Required to Select Table/Views/Aliases Include Select Tables/Views/Aliases Select Tables/Views/Aliases Database Wizard All Schemes Selected Tables/Views/Aliases window with a table selected Table/View Columns Select Procedures Steps Required to Select Stored Procedures Include Add Procedures Edit Resultset Steps Required to Add Prepared Statements Include Add Prepared Statement Prepared Statement Edit the Prepared Statement Parameters Steps Required to Review Your OTD Selections Specify the OTD NameReview Selections Steps Required to Specify the OTD Name Steps to Edit the OTD from the Enterprise Designer Include Steps to Edit an Existing Jdbc OTD Activity Input and Output Jdbc eWay Database Operations Bpel EInsight Operations Activity Input Activity Output JDBC.ODBC Operations Jdbc eWay Database Operations JCD To perform a query operation on a table Query Select Operation To perform an insert operation on a table Insert Operation To perform an update operation on a table Update Operation Stored Procedure Delete OperationTo perform a delete operation on a table Steps for executing the Stored Procedure include Executing Stored Procedures FileClient1.write Collaboration usability for a stored procedure ResultSet Batch Operations Prepared Statement Chapter Section Using JDBC/ODBC Operations About the Jdbc eWay Sample Projects Implementing the JDBC/ODBC eWay Sample Projects Sample input files Sample output JCD filesSample output Bpel files Assigning Operations in Bpel Sample Project DataOperations Used in the Jdbc Sample Projects Assigning Operations in JCD Running the Sample Projects About the eInsight Engine and eGate ComponentsSample Projects Drivers Importing a Sample Project Running the SQL Script Steps required to create the sample project Building and Deploying the prjJDBCJCD Sample Project Creating a Project Creating the OTDsSteps required to create a Jdbc Database OTD Click Next the Add Prepared Statements Wizard appears Creating a Connectivity Map Populating the Connectivity Map Steps required to create a new Connectivity MapSteps required to select a Jdbc External System Creating the Collaboration Definitions Java JcdDelete CollaborationSteps required to create the jcdDelete Collaboration Steps required to create the jcdPsSelect Collaboration JcdInsert CollaborationJcdPsSelect Collaboration Steps required to create the jcdInsert Collaboration Steps required to create the jcdTableSelect Collaboration JcdPsUpdate CollaborationSteps required to create the jcdPsUpdate Collaboration JcdTableSelect Collaboration Create the Collaboration Business Rules Creating the jcdDelete Business RulesCreating the jcdInsert Business Rules JcdInsert Business Rules Creating the jcdPsSelect Business Rules Sample code from the jcdPsSelect Includes JcdPsSelect Business Rules Creating the jcdTableSelect Business Rules Sample code from the jcdTableSelect Includes JcdTableSelect Business Rules Binding the eWay Components Creating the jcdUpdate Business Rules Steps required to bind eWay components together Creating an Environment Steps required to create an Environment Configuring the eWays FileClientOUT eWay Property Settings Configuring the eWay PropertiesSteps required to configure the eWay properties FileClientIN eWay Property Settings Configuring the Environment Explorer Properties Jdbc eWay Environment PropertiesSection Property Name Required Value Configuring the Integration Server Creating the Deployment ProfileFile eWay Environment Properties Steps required to create the Deployment Profile Creating and Starting the Domain Build the Project Building and Deploying the ProjectRunning the Sample Steps required to create and start the domain Building and Deploying the prjJDBCBPEL Sample Project Steps required to create a Jdbc Database OTD include Steps to create a business process flow include Creating the Business ProcessCreating the Business Process Flow Steps required to create inbound and outbound DTD OTDs Configuring the bpelPsInsert Modeling Elements Business Process ActivitiesBusiness Process Activity BpelPsInsert Business Process Configuring the bpelUpdate Modeling Elements Steps required to configure the bpelUpdate business process BpelUpdate Business Process Configuring the bpelDelete Modeling Elements BpelDelete Business Process Steps required to configure the bpelDelete business process BpelTableSelect Business Process Configuring the bpelTableSelect Modeling Elements BpelTableSelect Business Rule # BpelSelectTable Business Rule # Creating the Connectivity Map Steps required to create the Connectivity MapTo Select a Jdbc External System To Select a Jdbc Business Process Binding the eWay Components 109 FileClientOUT eWay FileClientIN eWay EaJDBCOUT eWay 111 112 113 114 Running the Sample Project 116 JDBC/ODBC Drivers AS/400 Database Connection Information Configuration PropertiesAS/400 Toolbox Driver OTD Wizard Database Connection Information Attunity Driver Environment PropertiesAS/400 Database Environment Properties Attunity Driver Database Environment Properties Attunity Driver Database Connection Information Parameter Value MaxIdleTime Default is MySQL Connector/J DriverMySQL Connector/J Driver Database Connection Information MySQL Connector/J Driver Environment Properties PostgreSQL Driver Connection Information PostgreSQL Driver PostgreSQL Driver Environment Properties SyBase JConnect Driver Sybase JConnect Driver Database Connection InformationSybase JConnect Driver Environment Properties Sequelink DataDirect Informix Odbc Driver Sequelink DataDirect MS Access Odbc Driver MS Access Odbc Driver Environment Properties MS Access Odbc Driver Database Connection Information Teradata Driver Teradata Driver Database Connection InformationTeradata Driver Environment Properties Installing JDBC/ODBC Drivers Troubleshooting Index Jdbc Update count