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

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

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:

  • Natural (NAT)Version 8.2.8 or higher

  • Natural for Db2 (NDB)Version 8.4.3 or higher

  • Mainframe License Check (MLC) 1.3.7 or higher

  • 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.

Installation Medium

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

Data Set Name Contents
NDZvrs.LOAD Load modules
NDZvrs.SRCE Source modules and macros
NDZvrs.JOBS Example jobs
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

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

Step 1: Prepare the Unix System Services directory

  1. Create the Unix System Services directory where the .jar and configuration files will be located. The directory is referred to as NDZ home directory in the next steps.

  2. Grant access to ndz user (RACF user with the permissions listed in the prerequisites).

Step 2: Copy and Extract the TAR file

(Job I020 Step 9610 + 9615)

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

Step 3: Create the Db2 properties file

  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

  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

Update the Db2, Java, and NDZ home path variables located in NDZ directory path/bin/setnenv.sh according to the instructions located in the 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 0020)

  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