Installing Natural TSO Interface on z/OS

This document describes the steps for installing the Natural TSO Interface (product code NTI) on z/OS.

Related Topics:

For information on how to operate Natural in a TSO environment, see Using Natural with TP Monitors and Natural under TSO in the TP Monitor Interfaces documentation and the following topics:

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


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

Installation Medium

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

Data Set Name Contents
NTIvrs.LOAD Load modules

Copy the data set into your environment as described in Copying Data Sets to a z/OS Disk in the section Installing Natural.

Sample Jobs

Sample installation jobs are contained in the NATvrs.JOBS data set and are prefixed with the product code. The data set is provided on the installation medium supplied for base Natural.

Installation Procedure

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

Note for LE Options:

If you want Natural to run in the IBM Language Environment (LE), set the System Maintenance Aid (SMA) parameter NAT-LE to Y (Yes). The default setting is N (No). Additionally, if you want to modify the LE options in the NATLEOPT source module or if you use non-Natural programs running in 24-bit mode, set the appropriate SMA parameter as described in Build the Natural-Specific IBM Language Environment Options in Installing Natural.

The installation procedure comprises the following:

Step 1: Create the CLIST for the Natural TSO Interface

(Job I070, Step 2400)

  • Create a TSO CLIST for Natural.

    This CLIST is used later to invoke Natural under TSO. Note that the CLIST supplied with this step is only a basic example which you can adapt to your requirements and to your TSO environment.

Step 2: Create ADARUN Cards

(Job I070, Step 2410)

Step 3: Build the Natural Parameter Module

(Job I080, Steps 0010, 0015)

  1. Modify the Natural parameter module for TSO.

    • Configure the TSO batch interface:

      Modify the settings of the parameters supplied with the NTTSOP macro in the Natural parameter module to meet your requirements. For descriptions of these parameters, see the corresponding dynamic profile parameter TSOP in the Parameter Reference documentation.

    • Modify the following parameters:


      where database-id and file-number are the values you specified when loading the system files during the Installation Procedure for base Natural.

    • Global buffer pool:

      If you want to use a global buffer pool, specify the NTBPI macro.

    • For all other parameters:

      You can generally use the default values. Modify only the values of those parameters whose default values do not suit your requirements. For descriptions of the individual parameters contained in the parameter module, refer to the Parameter Reference documentation.

    For dynamic assignment of profile parameters, see also the CMPRMIN data set described in the section Natural in Batch Mode in the Operations documentation.

  2. Assemble and link the Natural parameter module.

Step 4: Link the Nucleus

(Job I080, Step 0020)

Step 5: Make the Adabas Interface Available

Skip this step if the Adabas link module is available in your LPA.

  • Perform either of the following steps:

    • Include the Adabas load library in the steplib of your TSO user procedures.

    • Copy the modules listed in the section referring to installation with TSO of the appropriate Adabas installation documentation to a library of your TSO user steplib.

Installation Verification

You can verify the successful installation of the Natural TSO Interface by performing the following steps:

  1. Start a TSO session in ISPF mode.

  2. Invoke the CLIST you created in Step 1: Create the CLIST for the Natural TSO Interface.


  3. Proceed with the steps described in the section Test Online Natural.