Installing Natural for Db2 for zIIP Version 1.1.2 on z/OS

#### Search Results

Search

# Installing Natural for Db2 for zIIP Version 1.1.2 on z/OS

This document describes the additional steps for installing Natural for Db2 for zIIP Version 1.1.2 (product code NDZ) on z/OS.

- Prerequisites

- Installation Medium

- Installation Procedure

- NDZ Server Installation Steps

- Installation Steps Specific to Batch

#### Related Topics:

For information on how to use Natural for Db2 for zIIP, see Natural for Db2 for zIIP in the Database Management System Interfaces documentation.

#### Notation vrs or vr:

When used in this document, the notation `vrs` or `vr` represents the relevant product version (see also Version in the Glossary).

## Prerequisites

Before you can install Natural for Db2 for zIIP, you must meet all the prerequisites for Natural for Db2 and have the following software installed:

- IBM Java 8 64 bits

- Db2 JDBC driver

- z/OS Unix System Services

- APF authorized load library

- RACF user (referred as ndz user in the next steps) with:

  - Started RACF profile defined for NDZ started task(s).

  - Permit to `ERBSDS.MON3DATA` RACF facility profile.

  - Permit to `BPX.WLMSERVER` RACF facility profile.

- USS directory (referred as ndz home directory in the next steps) with ndz user as owner

## Installation Medium

The installation medium contains the following data sets required for product installation:

Data Set Name | Contents
--- | ---
`NDZvrs.LOAD` | Load modules
`NDZvrs.JOBS` | Sample jobs for static preparation, creating trusted context, etc.
`NDZvrs.TAR` | USS files (tar format for extraction to unix system services)

Copy the data sets into your environment as described in Copying Data Sets to a z/OS Disk in the section Installing Natural.

## Installation Procedure

Be sure to read Installation Process and Major Natural Features before you start the installation procedure.

The installation procedure comprises the following:

- NDZ Server Installation Steps

- Installation Steps Specific to Batch

## NDZ Server Installation Steps

This section describes the installation steps that apply to all Natural environments where Natural for Db2 for zIIP can be installed.

- Step 1: Create Trusted Context

- Step 2: Copy and Extract the TAR file

- Step 3: Create the Db2 properties file

- Step 4: Create the NDZ properties file

- Step 5: Update Static Preparation Shell Script

- Step 6: Link the NDZ Nucleus

- Step 7: Create NDZ started task procedure(s)

### Step 1: Create Trusted Context

(Job I010 Step 9610)

Create the Trusted context object in a Db2 server using the NDZ user to establish a trusted connection.

### Step 2: Copy and Extract the TAR file

(Job I020 Step 9610 + 9615 + 9620)

Extract the TAR file into the Unix System Services directory (NDZ home directory)

### Step 3: Create the Db2 properties file

(Job I022 Step 9615)

Create the Db2 properties file in the NDZ configuration directory (NDZ home directory/etc/db2.properties) with the specific Db2 connection and configuration properties.

#### OR:

1. Create the NDZ home directory/etc/db2.properties file from the sample NDZ home directory/etc/db2.properties.sample file.

2. Set the variables according to the instructions located in the sample file.

### Step 4: Create the NDZ properties file

(Job I022 Step 9620)

Create the NDZ properties file in the NDZ configuration directory (NDZ home directory/etc/ndz.properties) with the parameters for the NDZ Server.

#### OR:

1. Create the NDZ home directory/etc/ndz.properties file from the sample NDZ home directory/etc/ndz.properties.sample file.

2. Set the variables according to the instructions located in the sample file.

### Step 5: Update Static Preparation Shell Script

(Job I022 Step 9625)

Update the shell script responsible for setting the Db2, Java, and NDZ home path variables (NDZ home directory/bin/setenv.sh) for the NDZ Server.

#### OR:

Create the NDZ home directory/bin/setenv.sh file from the sample NDZ home directory/bin/setenv.sh.sample file. Update the Db2, Java, and NDZ home path variables in the setenv.sh file.

### Step 6: Link the NDZ Nucleus

(Job I060 Step 9620)

Link the NDZ nucleus with `NDZvrs.LOAD`(`NDZNUC`), `MLCvrs.LOAD`(`LICMAIN`) and `MLCvrs.LOAD`(`LICCHECK`).

### Step 7: Create NDZ started task procedure(s)

(Job I200 Step 9610)

Create procedure(s) for NDZ started task(s) (or daemons) using the following template:

    //NAME   PROC
    //*
    //NDZ11    EXEC  PGM=NDZNUC11,REGION=0M,TIME=NOLIMIT,
    //  PARM=('PATH=NDZ INSTALLATION PATH','PORT=PORT NUMBER TO CONNECT')
    //*--------------------------------------------------------------------*
    //LICNDZ   DD DISP=SHR,DSN=LICENSE DATASET(ndzlic)
    //STEPLIB  DD DISP=SHR,DSN=LOAD DATASET
    //SYSPRINT DD SYSOUT=X
    //SYSOUT   DD SYSOUT=X
    //SYSUDUMP DD SYSOUT=X
    //STDOUT   DD SYSOUT=X
    //STDERR   DD SYSOUT=X

Substitute the highlighted parts using the following instructions:

- `NAME` – The name of the started task.

- `NDZ INSTALLATION PATH` – The path to the NDZ home directory.

- `PORT NUMBER TO CONNECT` – The port number.

- `LICENSE DATASET` – The dataset which contains the license file.

- `LOAD DATASET` – The APF authorized dataset in which the NDZ nucleus is located.

## Installation Steps Specific to Batch

(Job I060 Step 9625)

1. Link the batch nucleus with the NDZ Support.

2. Add the following `INCLUDE` statements and corresponding `DD` statements to the link instructions for the linkage editor:

   `INCLUDE NDBLIB(NDBNDZ)` | NDB support for NDZ
   `CHANGE DSNHLI(DB2HLI)` `INCLUDE DB2LIB(DSNALI)` | Db2 Interface module

### On this page

- Prerequisites
- Installation Medium
- Installation Procedure
- NDZ Server Installation Steps
- Installation Steps Specific to Batch