Set Up DB2 on iSeries Using a JDBC Driver¶

Introduction¶

You can connect to DB2 on iSeries using either a JDBC or ODBC driver. Using a JDBC driver allows you to use additional features, such as being able to provide a manual query. This page covers instructions are for the JTOpen (AS400) and JCC JDBC drivers.

Note

A few customers have experienced issues connecting to DB2 on iSeries using the JDBC driver. In these cases, the issues were resolved by using the ODBC driver.

Install and Configure a DB2 JDBC Driver (AS400)¶

Download JTOpen. The ZIP file includes the JDBC driver file jt400.jar.
Install the driver in Jitterbit by unzipping the download and then copying the jt400.jar file to <JITTERBIT_HOME>/tomcat/drivers/lib/, replacing <JITTERBIT_HOME> with the path to your Private Agent root directory.

Edit the file <JITTERBIT_HOME>/JdbcDrivers.conf and add this driver entry:

<Driver>
<Name>IBM DB2</Name>
<Class>com.ibm.as400.access.AS400JDBCDriver</Class>
<Subprotocol>as400</Subprotocol>
</Driver>

Restart the Jitterbit Tomcat server service.
The newly installed driver should now be available in Design Studio. During configuration of a source or target database, select IBM DB2 (AS400) [JDBC] from the driver selection list.
Under Options, enter a manual connection string, replacing this example with your own host, libraries, and database name (if applicable):
Sample Connection String
```
jdbc:as400://example.com;libraries=LIB1;Database=S12345;socket timeout=30000
```

Install and Configure a DB2 JDBC Driver (JCC)¶

Important

IBM's JCC driver requires a license file db2jcc_license_cisuz-XX.jar. If you do not have a license file, you will need to obtain one or use the JTOpen (AS400) library instead.

Download JCC from IBM's DB2 JDBC Driver Versions and Downloads. The TAR.GZ file includes a ZIP file with the JDBC driver file db2jcc4.jar.

Note

The driver file db2jcc.jar uses the JDBC 3 specification and is deprecated. Use the driver file db2jcc4.jar, which uses the JDBC 4 specification instead.
Install the driver on a Private Agent by extracting the download and then copying the file db2jcc4.jar to <JITTERBIT_HOME>/tomcat/drivers/lib/, replacing <JITTERBIT_HOME> with the path to your Private Agent root directory.

Edit the file <JITTERBIT_HOME>/JdbcDrivers.conf and add this driver entry:

<Driver>
<Name>IBM DB2 JCC Driver</Name>
<Class>com.ibm.db2.jcc.DB2Driver</Class>
<Subprotocol>db2</Subprotocol>
</Driver>

Locate and copy your IBM-provided license file db2jcc_license_cisuz-XX.jar to <JITTERBIT_HOME>/tomcat/shared/lib/.
Edit the file <JITTERBIT_HOME>/tomcat/conf/catalina.properties and add this entry if not present:
```
shared.loader=${catalina.home}/shared/lib/*.jar
```
Restart the Jitterbit Tomcat server service.
The newly installed driver should now be available in Design Studio. During configuration of a source or target database, select IBM DB2 (JCC) [JDBC] from the driver selection list.
Under Options, enter a manual connection string, replacing this example with your own host and database name (if applicable):
Sample Connection String
```
jdbc:db2://example.com/DBNAME
```