This document describes the steps for installing Natural for DL/I (product code NDL) on z/OS.
For information on how to operate Natural in a DL/I environment, see Natural for DL/I 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).
See General Prerequisites and System Support in the section Overview of the Installation Process.
The installation medium contains the following data sets required for product installation:
| Data Set Name | Contents |
|---|---|
NDLvrs.LOAD |
Load modules |
NDLvrs.SRCE |
Source modules and macros |
NDLvrs.JOBS |
Sample installation jobs |
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 described the installation steps that apply to all Natural environments where Natural for DL/I can be installed. The steps additionally required for a particular TP monitor are described in the following sections.
(Job I054, Step 1500)
Link the Natural for DL/I bootstrap module
NDLSINIB.
(Job I055, Steps 1500, 1501)
Modify the Natural for DL/I parameter module
NDLPARM
as described in the section Natural Parameter Modifications
for DL/I in the Database Management System
Interfaces documentation.
Assemble and link/catalog NDLPARM.
(Job I060, Steps 0010, 0015)
Build the Natural parameter module for batch mode:
Add the Natural profile parameter DLISIZE and
specify DLISIZE=27. This value applies if the default values of
the parameters contained in the
NDLPARM
module are used. DLISIZE is described in the
Parameter Reference documentation.
Add an NTDB
macro (see the Parameter Reference documentation) to the
Natural parameter module specifying the database IDs (DBIDs) that relate to
DL/I segment types. The numbers specified in this DBID list must be in the
range from 1 to 254. They indicate which DBIDs are reserved for DL/I segment
types. Up to 254 entries can be specified. All Natural DDMs that refer to a
DL/I segment type are cataloged with a DBID from this list. The number with the
lowest value in this list is the default DBID for DL/I segment types.
NTDB DLI,(250,253,252) NTDB DLI,250
Note:
Values for DL/I DBIDs above 255 are not possible.
Assemble and link the parameter module.
(Job I060, Steps 0020, 0105)
Link the environment-dependent nucleus (Step 0020) for batch Natural.
Add the following INCLUDE statements and the
corresponding DD statements to the link step for Natural:
INCLUDE NDLLIB(NDLSIOBA) INCLUDE SMALIB(NDLPARM) INCLUDE RESLIB(ASMTDLI)
Link the environment-independent nucleus (Step 0105).
Add the following INCLUDE statement and
the corresponding DD statement to the link step for Natural:
INCLUDE NDLLIB(NDLNUC)
(Jobs I008, I053, I075)
Build a Natural for DL/I environment with a sample database:
Allocate VSAM spaces for the sample database (Job I008, Steps 1500 and 1501).
Create the DBDs and PSBs, and perform the initial load (Job I053, Steps 1500, 1521, 1531, 1541, 1542, 1543, 1550, and 1560).
Execute the procedures NATPSB and
NATDBD for the sample database (Job I075, Steps 1500, 1510, 1520,
152,1 and 1522).
Additional data must be added to the FDIC system
file to enable Natural to access DL/I databases. To do so, the procedures
NATPSB and
NATDBD (see
the relevant sections in the Database Management System
Interfaces documentation) must be executed for each PSB/DBD to be
used.
This section describes the additional steps required to install Natural for DL/I in a CICS environment.
(Job I080, Steps 2210, 2220)
Build the Natural Parameter Module for the Natural CICS Interface:
Add the Natural profile parameter DLISIZE and
specify DLISIZE=27. This value applies if the default values of
the parameters contained in the
NDLPARM
module are used. DLISIZE is described in the
Parameter Reference documentation.
Add an NTDB
macro (see the Parameter Reference documentation) to the
Natural parameter module specifying the database IDs (DBIDs) that relate to
DL/I segment types. The numbers specified in this DBID list must be in the
range from 1 to 254. They indicate which DBIDs are reserved for DL/I segment
types. Up to 254 entries can be specified. All Natural DDMs that refer to a
DL/I segment type are cataloged with a DBID from this list. The number with the
lowest value in this list is the default DBID for DL/I segment types.
NTDB DLI,(250,253,252) NTDB DLI,250
Note:
Values for DL/I DBIDs above 255 are not possible.
Assemble and link the parameter module.
(Job I080, Step 2230)
Link the environment-dependent nucleus for the Natural CICS Interface.
Add the following INCLUDE statements and
the corresponding DD statements to the link step for Natural:
INCLUDE NDLLIB(NDLSIOCX) INCLUDE SMALIB(NDLPARM) INCLUDE TPSLIB(ASMTDLI)
Instead of the standard link-edit options, you can also use one of the following link-edit methods:
Link-edit all Natural for DL/I modules (NDLNUC,
NDLPARM and NDLSIOCX), the DL/I module
ASMTDLI and an alternate Natural parameter module as a separate
module with the mandatory entry name CMPRMTB. The name of the
resulting module is optional. This way of link-editing only applies if an
alternate parameter module (PARM=) is used. If so, under CICS, an
additional CICS PPT entry with
PROGRAM=name is required.
Link-edit all Natural for DL/I modules (NDLNUC,
NDLPARM and NDLSIOCX) and the DL/I module
ASMTDLI as a separate module with the mandatory entry name
NATGWDLI. The name of the resulting module is optional. However,
if it is different from NATGWDLI, it must be specified as an alias
name in an NTALIAS macro entry of the Natural parameter
module. This way of link-editing only applies if the Natural Resolve CSTATIC
Addresses feature (RCA) is used. If so, under CICS, an additional CICS PPT
entry with PROGRAM=name is
required.
This section describes the additional steps required to install Natural for DL/I in an IMS TM environment.
(Job I080, Steps 2500, 2510)
Build the Natural Parameter Module for the Natural IMS TM Interface:
Add the Natural profile parameter DLISIZE and
specify DLISIZE=27. This value applies if the default values of
the parameters contained in the
NDLPARM
module are used. DLISIZE is described in the
Parameter Reference documentation.
Add an NTDB
macro (see the Parameter Reference documentation) to the
Natural parameter module specifying the database IDs (DBIDs) that relate to
DL/I segment types. The numbers specified in this DBID list must be in the
range from 1 to 254. They indicate which DBIDs are reserved for DL/I segment
types. Up to 254 entries can be specified. All Natural DDMs that refer to a
DL/I segment type are cataloged with a DBID from this list. The number with the
lowest value in this list is the default DBID for DL/I segment types.
NTDB DLI,(250,253,252) NTDB DLI,250
Note:
Values for DL/I DBIDs above 255 are not possible.
Assemble and link the parameter module.
(Job I080, Steps 2570, 2572)
Link the environment-dependent nucleus for the Natural IMS TM Interface.
Add the following INCLUDE statements and
the corresponding DD statements to the link step for Natural:
INCLUDE NDLLIB(NDLSIOBA) INCLUDE SMALIB(NDLPARM) INCLUDE RESLIB(ASMTDLI)
Instead of the standard link-edit options, you can also use one of the following link-edit methods:
Link-edit all Natural for DL/I modules (NDLNUC,
NDLPARM and NDLSIOBA), the DL/I module
ASMTDLI and an alternate Natural parameter module as a separate
module with the mandatory entry name CMPRMTB. The name of the
resulting module is optional. This way of link-editing only applies if an
alternate parameter module (PARM=) is used.
Link-edit all Natural for DL/I modules (NDLNUC,
NDLPARM and NDLSIOBA) and the DL/I module
ASMTDLI as a separate module with the mandatory entry name
NATGWDLI. The name of the resulting module is optional. However,
if it is different from NATGWDLI, it must be specified as an alias
name in an NTALIAS macro entry of the Natural parameter
module. This way of link-editing only applies if the Natural Resolve CSTATIC
Addresses feature (RCA) is used.
The following steps are required if you want to run the Natural for
DL/I NATEXPL example program in an IMS TM environment.
Run IMS TM PSBGEN procedures to create the sample PSBs
NATSYSF, NATSYSFL,
NIIvrsFR,
NIIvrsNC and NIIBOOT.
Run an IMS TM DBDGEN procedure to generate the
NATEXPL example program.
Perform an IMS TM GEN with the new DATABASE,
APPLCTN and TRANSACT definitions as shown in the
following examples:
DATABASE DBD=NATEXPL,ACCESS=UP NATURAL DL/I
DATABASE DBD=NATEXPLO,ACCESS=UP NATURAL DL/I
APPLCTN PSB=NATSYSF,PGMTYPE=BATCH
TRANSACT CODE=NATTRNSF,MODE=SNGL, *
MSGTYPE=(SNGLSEG,RESPONSE,4)
APPLCTN PSB=NATSYSFL,PGMTYPE=BATCH
TRANSACT CODE=NATTRNFL,MODE=SNGL, *
MSGTYPE=(SNGLSEG,RESPONSE,4)
APPLCTN PSB=NIIvrsFR,PGMTYPE=TP
TRANSACT CODE=NATvrs,MODE=SNGL,SPA=512, *
MSGTYPE=(SNGLSEG,RESPONSE,4)
APPLCTN PSB=NIIvrsNC,PGMTYPE=TP
TRANSACT CODE=NATvrsNC,MODE=SNGL, *
MSGTYPE=(SNGLSEG,NONRESPONSE,4)
APPLCTN PSB=NIIBOOT,PGMTYPE=TP
TRANSACT CODE=NATTRNBT,MODE=SNGL, *
MSGTYPE=(SNGLSEG,RESPONSE,4)
Update the IMS TM dynamic allocation table with information on the new databases:
DFSMDA TYPE=DATABASE,DBNAME=NATEXPL
DFSMDA TYPE=DATASET,DDNAME=NATEXPL, *
DSNAME=RD.IBM.EXPLDBD.DATA, *
DISP=SHR
DFSMDA TYPE=DATASET,DDNAME=NATEXPLO, *
DSNAME=RD.IBM.EXPLDBDX.OVFL, *
DISP=SHR
Update the RECON data set with information on the new databases:
INIT.DB DBD(NATEXPL) SHARELVL(3) TYPEIMS
INIT.DBDS DBD(NATEXPL) DDN(NATEXPL) -
DSN(RD.IBM.EXPLDBD.DATA) -
ICJCL(ICJCL) OICJCL(OICJCL) RECOVJCL(RECOVJCL) -
NOREUSE RECOVPD(0) GENMAX(3)
INIT.DBDS DBD(NATEXPL) DDN(NATEXPLO) -
DSN(RD.IBM.EXPLDBDX.OVFL) -
ICJCL(ICJCL) OICJCL(OICJCL) RECOVJCL(RECOVJCL) -
NOREUSE RECOVPD(0) GENMAX(3)
You can verify the successful installation of Natural for DL/I online by using the function (described in the Database Management System Interfaces documentation) of the Natural SYSDDM utility:
Invoke online Natural.
Invoke the SYSDDM utility.
In the SYSDDM main menu, enter function code D to
invoke the function.
On the resulting screen, enter function code D to
invoke the function.
On the resulting screen, enter function code S to
select the NDB which was created in Step 4: Build the Natural for DL/I
Sample Database .
On the resulting screen, enter function code L to
list the NDB segments.
On the resulting screen, enter function code A to
assign DBID and FNR to the segments.
On the same screen, enter function code G to
generate a DDM from the segment description.
Catalog the generated DDM.
Only if running under CICS:
Enter NATPSB ON NATSYSF in the command line where
NATSYSF refers to the name used for DBD and PSB in
Step 4: Build the Natural
for DL/I Sample Database .
Edit and run the following program:
DEFINE DATA LOCAL 01 COURSE VIEW OF NATEXPL-COURSE 02 COURSEN 02 TITLE 02 DESCRIPN END-DEFINE READ (100) COURSE BY COURSEN DISPLAY COURSEN TITLE DESCRIPN END
where NATEXPL-COURSE refers to the name used for
DBD and PSB in Step 4: Build
the Natural for DL/I Sample Database.