IBM Db2 for z/OS connection

To access your data in IBM Db2 for z/OS, create a connection asset for it.

Db2 for z/OS is an enterprise data server for IBM Z. It manages core business data across an enterprise and supports key business applications.

Supported versions

IBM Db2 for z/OS 12 and 13.

Prerequisites

Obtain certificate or upload JAR files

This connection requires either an IBM Db2 Connect Unlimited Edition license certificate file on the Db2 for z/OS server or that you upload two JAR files to Cloud Pak for Data.

These steps must be done on the Db2 for z/OS server: Obtain an IBM Db2 Connect Unlimited Edition license certificate file from IBM Db2 Connect: Pricing and Installing the IBM Data Server Driver for JDBC and SQLJ. For installation instructions, see Activating the license certificate file for Db2 Connect Unlimited Edition.
Upload two JAR files: db2jcc_license_cisuz.jar and db2jcc4.jar. For information about obtaining the JAR files, see IBM Db2 Connect: Pricing and Installing the IBM Data Server Driver for JDBC and SQLJ. See Importing JDBC drivers in the IBM Software Hub documentation for the procedure and required permissions to upload the JAR file to Cloud Pak for Data. Important: By default, uploading JDBC driver files is disabled and users cannot view the list of JDBC drivers in the web client. An administrator must enable users to upload or view JDBC drivers in the IBM Software Hub documentation.

Run the bind command

Run the following commands from the Db2 client that is configured to access the Db2 for z/OS server.
You need to run the bind command only one time per remote database per Db2 client version.

db2 connect to DBALIAS user USERID using PASSWORD
db2 bind path@ddcsmvs.lst blocking all sqlerror continue messages ddcsmvs.msg grant public
db2 connect reset

For more information about bind commands, see Binding applications and utilities (Db2 Connect Server).

Run catalog commands

Run the following catalog commands from the Db2 client that is configured to access the Db2 for z/OS server:

db2 catalog tcpip node node_name remote hostname_or_address server port_no_or_service_name

Example:
db2 catalog tcpip node db2z123 remote 192.0.2.0 server 446

 db2 catalog dcs database local_name as real_db_name

Example:
db2 catalog dcs database db2z123 as db2z123

```
db2 catalog database local_name as alias at node node_name authentication server
```
Example:
db2 catalog database db2z123 as db2z123 at node db2z123 authentication server

For information about catalog commands, see CATALOG TCPIP NODE and CATALOG DCS DATABASE.

Create a connection to Db2 for z/OS

To create the connection asset, you need these connection details:

Hostname or IP address
Port number
Collection ID: The ID of the collections of packages to use
Location: The unique name of the Db2 location you want to access
Username and password
Application name (optional): The name of the application that is currently using the connection. For information, see Client info properties support by the IBM Data Server Driver for JDBC and SQLJ.
Client accounting information (optional): The value of the accounting string from the client information that is specified for the connection. For information, see Client info properties support by the IBM Data Server Driver for JDBC and SQLJ.
Client hostname (optional): The hostname of the machine on which the application that is using the connection is running. For information, see Client info properties support by the IBM Data Server Driver for JDBC and SQLJ.
Client user (optional): The name of the user on whose behalf the application that is using the connection is running. For information, see Client info properties support by the IBM Data Server Driver for JDBC and SQLJ.
SSL certificate (if required by the database server)

For Credentials and Certificates, you can use secrets if a vault is configured for the platform and the service supports vaults. For information, see Using secrets from vaults in connections.

Federal Information Processing Standards (FIPS) compliance

This connection is FIPS-compliant and can be used on a FIPS-enabled cluster.

Restriction

For SPSS Modeler, you can use this connection only to import data. You cannot export data to this connection or to a Db2 for z/OS connected data asset.

Running SQL statements

To ensure that your SQL statements run correctly, refer to the Db2 for z/OS and SQL concepts for the correct syntax.