This document describes the additional steps for installing Natural for Db2 for zIIP Version 1.1.1 (product code NDZ) on z/OS.
For information on how to use Natural for Db2 for zIIP, see Natural for Db2 for zIIP in the Database Management System Interfaces documentation.
When used in this document, the notation
vrs or
vr represents the relevant product
version (see also Version in the
Glossary).
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.
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.
Be sure to read Installation Process and Major Natural Features before you start the installation procedure.
The installation procedure comprises the following:
This section describes the installation steps that apply to all Natural environments where Natural for Db2 for zIIP can be installed.
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.
Grant access to ndz user (RACF user with the permissions listed in the prerequisites).
(Job I020 Step 9610 + 9615)
Extract the TAR file into the Unix System Services directory (NDZ home directory)
Create the NDZ home directory/etc/db2.properties file from the sample NDZ home directory/etc/db2.properties.sample file.
Set the variables according to the instructions located in the sample file.
Create the NDZ home directory/etc/ndz.properties file from the sample NDZ home directory/etc/ndz.properties.sample file.
Set the variables according to the instructions located in the sample file.
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.
(Job I060 Step 9620)
Link the NDZ nucleus with
NDZvrs.LOAD(NDZNUC),
MLCvrs.LOAD(LICMAIN)
and
MLCvrs.LOAD(LICCHECK).
(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.
(Job I060 Step 0020)
Link the batch nucleus with the NDZ Support.
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 |