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.

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

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

(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