Sun Microsystems JDBC/ODBC Adapter manual

Chapter 3

Setting Properties of the JDBC/ODBC eWay

This chapter describes how to set the properties of the JDBC/ODBC eWay.

What’s In This Chapter

Creating and Configuring a JDBC eWay on page 25

Configuring the eWay Connectivity Map Properties on page 25

Configuring the eWay Environment Properties on page 29

eWay Connectivity Map Properties on page 30

eWay Environment Properties on page 31

3.1Creating and Configuring a JDBC eWay

All eWays contain a unique set of default configuration parameters. After the eWays are established and a JDBC External System is created in the Project’s Environment, the eWay parameters are modified for your specific system. The JDBC eWay configuration parameters are modified from two locations:

Connectivity Map: These parameters most commonly apply to a specific component eWay, and may vary from other eWays (of the same type) in the Project.

Environment Explorer : These parameters are commonly global, applying to all eWays (of the same type) in the Project. The saved properties are shared by all eWays in the JDBC External System window.

Collaboration or Business Process: JDBC eWay properties may also be set from your Collaboration or Business Process, in which case the settings will override the corresponding properties in the eWay’s Connectivity Map configuration. Any properties that are not overridden retain their configured default settings.

3.2Configuring the eWay Connectivity Map Properties

When you connect an External Application to a Collaboration, Enterprise Designer automatically assigns the appropriate eWay to the link. Each eWay is supplied with a list of eWay connections (transaction support levels) from which to choose.

Transaction support levels provided by the JDBC eWay include:

JDBC/ODBC eWay Adapter User’s Guide

25

Sun Microsystems, Inc.

Image 25

Sun Microsystems JDBC/ODBC Adapter Creating and Configuring a Jdbc eWay, Configuring the eWay Connectivity Map Properties

Contents

EWAY JDBC/ODBC Adapter USER’S Guide Part Number Version Contents Activity Input and Output Transaction Support Levels Between Different Versions Creating the Collaboration Definitions Java Stored ProcedureCreate the Collaboration Business Rules Building and Deploying the Project Running the Sample Building and Deploying the prjJDBCBPEL Sample Project Jdbc Drivers About Java Database Connectivity JdbcWhat’s In This Chapter Type One Driver Type I JDBC-ODBC Bridge Type Two Driver Type II Partial Java driverPros Cons 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 What’s New in This Release About the JDBC/ODBC eWayNew for Version Scope About This DocumentJdbc eWay Javadoc Sun Microsystems, Inc. Web Site Related DocumentsIntended Audience Text Conventions Documentation Feedback Installing the Jdbc eWay Installing the JDBC/ODBC eWay Installing the Jdbc eWay on an eGate supported system After Installation Ican 5.0 Project Migration ProceduresExtracting the Sample Projects and Javadocs Import the Project Install Java CapsDeploy the Project To add plug-ins from the Enterprise Manager Installing Enterprise Manager eWay Plug-Ins To View the eWay Alert Codes Viewing Alert CodesAlert Codes for the JDBC/ODBC eWay Alert Code\Description Description Details User Actions 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 EWay Environment Properties Outbound XA eWay Configuration Settings IncludeConnectivity Map Outbound eWay Properties Connectivity Map Outbound non-Transactional eWay Properties Inbound Jdbc eWay Properties Inbound Jdbc eWay-Parameter SettingsOutbound Jdbc eWay Properties Name Description Required Value Outbound Jdbc eWay-JDBC Connector Settings Jdbc Connector SettingsIs Jdbc Connection Pool Datasource ConnectionPoolDataSource Outbound Jdbc eWay-Connection Retry Settings 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 Is Jdbc XA Datasource Outbound XA Jdbc eWay-JDBC Connector SettingsConnectionPoolDataSource 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 Required Database Connection Fields include Select Database ObjectsSteps 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 Review Selections Specify the OTD NameSteps Required to Specify the OTD Name Steps Required to Review Your OTD Selections 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 Delete Operation Stored ProcedureTo 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 output JCD files Sample input filesSample output Bpel files Operations Used in the Jdbc Sample Projects Sample Project DataAssigning Operations in JCD Assigning Operations in Bpel About the eInsight Engine and eGate Components Running the Sample ProjectsSample 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 the OTDs Creating a ProjectSteps required to create a Jdbc Database OTD Click Next the Add Prepared Statements Wizard appears Creating a Connectivity Map Steps required to create a new Connectivity Map Populating the Connectivity MapSteps required to select a Jdbc External System JcdDelete Collaboration Creating the Collaboration Definitions JavaSteps required to create the jcdDelete Collaboration JcdPsSelect Collaboration JcdInsert CollaborationSteps required to create the jcdInsert Collaboration Steps required to create the jcdPsSelect Collaboration Steps required to create the jcdPsUpdate Collaboration JcdPsUpdate CollaborationJcdTableSelect Collaboration Steps required to create the jcdTableSelect Collaboration Creating the jcdDelete Business Rules Create the Collaboration 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 Steps required to configure the eWay properties Configuring the eWay PropertiesFileClientIN eWay Property Settings FileClientOUT eWay Property Settings Jdbc eWay Environment Properties Configuring the Environment Explorer PropertiesSection Property Name Required Value Creating the Deployment Profile Configuring the Integration ServerFile eWay Environment Properties Steps required to create the Deployment Profile Creating and Starting the Domain Running the Sample Building and Deploying the ProjectSteps required to create and start the domain Build the Project Building and Deploying the prjJDBCBPEL Sample Project Steps required to create a Jdbc Database OTD include Creating the Business Process Flow Creating the Business ProcessSteps required to create inbound and outbound DTD OTDs Steps to create a business process flow include Business Process Activities Configuring the bpelPsInsert Modeling ElementsBusiness 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 # Steps required to create the Connectivity Map Creating 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 Toolbox Driver Configuration PropertiesOTD Wizard Database Connection Information AS/400 Database Connection Information Environment Properties Attunity DriverAS/400 Database Environment Properties Attunity Driver Database Environment Properties Attunity Driver Database Connection Information MySQL Connector/J Driver Database Connection Information MySQL Connector/J DriverMySQL Connector/J Driver Environment Properties Parameter Value MaxIdleTime Default is PostgreSQL Driver Connection Information PostgreSQL Driver PostgreSQL Driver Environment Properties Sybase JConnect Driver Database Connection Information SyBase JConnect DriverSybase 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 Database Connection Information Teradata DriverTeradata Driver Environment Properties Installing JDBC/ODBC Drivers Troubleshooting Index Jdbc Update count