Installing Natural for DL/I on z/OS

This document describes the steps for installing Natural for DL/I (product code NDL) on z/OS.

Related Topic:

For information on how to operate Natural in a DL/I environment, see Natural for DL/I 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

See General Prerequisites and System Support in the section Overview of the Installation Process.

Installation Medium

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.

Installation Procedure

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

The installation procedure comprises the following:

Common Installation Steps

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.

Step 1: Build the DL/I Bootstrap Module

(Job I054, Step 1500)

  • Link the Natural for DL/I bootstrap module NDLSINIB.

Step 2: Build the Natural for DL/I Parameter Module

(Job I055, Steps 1500, 1501)

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

  2. Assemble and link/catalog NDLPARM.

Step 3: Build the Natural Parameter Module

(Job I060, Steps 0010, 0015)

Build the Natural parameter module for batch mode:

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

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

    Examples:

    NTDB DLI,(250,253,252)
    NTDB DLI,250

    Note:
    Values for DL/I DBIDs above 255 are not possible.

  3. Assemble and link the parameter module.

Step 4: Link the Nucleus

(Job I060, Steps 0020, 0105)

  1. 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)
  2. 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)

Step 5: Build the Natural for DL/I Sample Database

(Jobs I008, I053, I075)

Build a Natural for DL/I environment with a sample database:

  1. Allocate VSAM spaces for the sample database (Job I008, Steps 1500 and 1501).

  2. Create the DBDs and PSBs, and perform the initial load (Job I053, Steps 1500, 1521, 1531, 1541, 1542, 1543, 1550 and 1560).

  3. Execute the procedures NATPSB and NATDBD for the sample database (Job I075, Steps 1500, 1510, 1520, 1521 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.

Installation Steps Specific to CICS

This section describes the additional steps required to install Natural for DL/I in a CICS environment.

Step 1: Build the Natural Parameter Module for the Natural CICS Interface

(Job I080, Steps 2210, 2220)

Build the Natural Parameter Module for the Natural CICS Interface:

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

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

    Examples:

    NTDB DLI,(250,253,252)
    NTDB DLI,250

    Note:
    Values for DL/I DBIDs above 255 are not possible.

  3. Assemble and link the parameter module.

Step 2: Link the Nucleus for the Natural CICS Interface

(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)

Alternative Link-Edit Options

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.

Installation Steps Specific to IMS TM

This section describes the additional steps required to install Natural for DL/I in an IMS TM environment.

Step 1: Build the Natural Parameter Module for the Natural IMS TM Interface

(Job I080, Steps 2500, 2510)

Build the Natural Parameter Module for the Natural IMS TM Interface:

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

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

    Examples:

    NTDB DLI,(250,253,252)
    NTDB DLI,250

    Note:
    Values for DL/I DBIDs above 255 are not possible.

  3. Assemble and link the parameter module.

Step 2: Link the Nucleus for the Natural IMS TM Interface

(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)

Alternative Link-Edit Options

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.

Customizing the IMS TM Environment

The following steps are required if you want to run the Natural for DL/I NATEXPL example program in an IMS TM environment.

Step 1: Run PSBGENs for Sample PSBs

  • Run IMS TM PSBGEN procedures to create the sample PSBs NATSYSF, NATSYSFL, NIIvrsFR, NIIvrsNC and NIIBOOT.

Step 2: Run DBDGEN for NATEXPL

  • Run an IMS TM DBDGEN procedure to generate the NATEXPL example program.

Step 3: Perform GEN and Create the APPLCTN Table Definitions

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

Step 4: Modify the Allocation Table

  • 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

Step 5: Modify the RECON Data Set

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

Installation Verification

You can verify the successful installation of Natural for DL/I online by using the DL/I Services function (described in the Database Management System Interfaces documentation) of the Natural SYSDDM utility:

  1. Invoke online Natural.

  2. Invoke the SYSDDM utility.

  3. In the SYSDDM main menu, enter function code D to invoke the DL/I Services function.

  4. On the resulting screen, enter function code D to invoke the NDB Maintenance function.

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

  6. On the same screen, enter function code G to generate a DDM from the segment description.

  7. Catalog the generated DDM.

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

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