Open Data Hub for Mainframe JDBC Connector

The Open Data Hub for Mainframe JDBC Connector provides access to a server. It receives incoming JDBC calls (requests) from a JDBC application and converts the calls into the appropriate API commands. The SQL statement is sent to the server in the form passed from the application.

Using the Open Data Hub for Mainframe JDBC Connector

The Open Data Hub for Mainframe JDBC Connector consists of a single self-contained .jar file named jlink_standalone.jar.

When the setup_odbc_client.exe file is executed, by default, the jlink_standalone.jar file is included in the C:\ibi\odh_client9x\home\etc\java\srvr folder.

Use the Open Data Hub for Mainframe JDBC Connector With sqlline

You can test the Open Data Hub for Mainframe JDBC Connector using the open source program sqlline.

    Procedure
  1. Download the sqlline-1.12.0-jar-with-dependencies.jar file from the following website:

    https://search.maven.org/search?q=sqlline

  2. Extract the two .jar files to the same directory.
    • jlink-standalone.jar
    • sqlline-1.12.0-jar-with-dependencies.jar
  3. For Windows, create a batch file called sqlline, with the following code: 
    java -cp "%~dp0\*" sqlline.SqlLine %* --color=true

Connect to a Server Using a URL

The Connector uses a standard JDBC URL to locate a server. You can include all the necessary information to connect to a server in a URL, using the following syntax:

sqlline> ! connect jdbc:jlink://host:port;keyword1=value1;keyword2=value2

For example:

sqlline> ! connect jdbc:jlink://MVS123:8120;user=sysadmin;pswd=sysadmin

where:

jdbc:jlink

Identifies the interface you are using. This indicates that the Connector should be loaded.

host

Is the IP address or Domain Name Service (DNS) of the server.

port

Is the TCP/IP port number on which the server listens.

keywords

You can pass all the required communications properties in the URL. Properties are specified as keyword=value pairs and must be separated by a semicolon (;). Possible values are:

user or userid

Is the user identification for access to the server.

password or pswd

Is the user password for access to the server.

trace

Identifies the active trace level. A trace setting can be any combination of the numbers 1, 2, 3, and 4. You can use one or more of the trace levels for tracing and debugging applications. The following table provides detailed information about each trace level. The numbers for each trace level represent the numbers as they appear on the trace.

Level

Description

1

Displays each entry and exit to and from a Connector function, along with the parameter values processed.

2

Displays data transmission and internal logic. Key decisions made in JLINK are traced.

3

Displays internal logic. Input and output are traced.

4

Displays internal debugging information.

Use the Open Data Hub for Mainframe JDBC Connector With SQuirrel SQL

You can use the Open Data Hub for Mainframe JDBC Connector with the SQuirrel SQL Client open source program on Windows and other platforms.

    Procedure
  1. Download the SQuirrel SQL Client from the following website and follow the installation instructions:

    http://www.squirrelsql.org/#installation

  2. Open the SQuirrel SQL Client.
  3. Click the Drivers tab, and then click the plus (+) button to add a new driver, as shown in the following image.

    The Add Driver dialog box opens.

  4. In the Name field, type a name for the driver, for example, ODH Connector, and in the Example JDBC URL field, type the URL for your server, for example, jdbc:jlink://MVS123:8120;, as shown in the following image.

  5. Click the SQuirrel Java Class Path tab and then click Add.
  6. Select the jlink_standalone.jar file that you downloaded, as shown in the following image.

  7. Click Open.

    The jlink_standalone.jar file is successfully added, as shown in the following image.

  8. Click List Drivers.

    The ibi.jdbc.EdaDriver class name will be populated in the Class Name field.

  9. Click OK.

Create an Alias

    Procedure
  1. Click the Aliases tab, and then click the plus (+) button to add a new alias, as shown in the following image.

    Note: An Alias is what SQuirrel calls a connection to a server.

    The Add Alias dialog box opens, as shown in the following image.

  2. In the Name field, type a name for the alias, for Driver, select ODH Connector, and for URL, type the connection information for your server, as shown in the following image.

  3. Click Test.

    The Connect to data dialog box opens, as shown in the following image.

    Note: If you did not enter a password on the previous Add Alias dialog box, type a password on the Connect to data dialog box, as shown in the following image.

  4. Click Connect.

    You should see a Connection successful message, as shown in the following image.

  5. Click OK and then click Close.
  6. You can now click Connect to connect to your configured server. The first screen shows the properties of the JDBC Connection, as shown in the following image.

  7. Click the SQL tab.

    You can now type a select statement for a table on your server. Click the running man to run the select statement and view the results, as shown in the following image.