Version 4.2.6 for Mainframes
 —  Installation  —

Installing the Natural TSO Interface

This document describes how to install the Natural TSO Interface (product code NTI).

The Natural TSO Interface (NATTSO) consists of a number of service routines interfacing with the z/OS operating system. NATTSO is supplied as a source module and can be customized to meet your requirements.

You have two options:

NATTSO is fully reentrant and can run above the 16 MB line.

This document describes step by step how to install Natural in a TSO environment.

The following topics are covered:

For information on the following topics, refer to Natural under TSO in the Natural TP Monitor Interfaces documentation:

Notation vrs or vr: If used in the following document, the notation vrs or vr stands for the relevant version, release, system maintenance level numbers. For further information on product versions, see Version in the Glossary.


Prerequisites

Base Natural must be installed under z/OS.

See Installing Natural under z/OS.

Top of page

Installation Tape for the Natural TSO Interface

The installation tape contains the dataset listed in the table below. The position of the dataset is shown in the Report of Tape Creation which accompanies the installation tape.

Dataset Name Contents
NTIvrs.SRCE TSO-dependent source programs

Copying the Tape Contents to a z/OS Disk

If you are using SMA, refer to the System Maintenance Aid documentation (included in the current edition of the Natural documentation CD).

If you are not using SMA, follow the instructions below.

This section explains how to:

The JCL in this dataset is then used to copy all datasets from tape to disk.

If the datasets for more than one product are delivered on the tape, the dataset COPY.JOB contains the JCL to unload the datasets for all delivered products from the tape to your disk.

After that, you will have to perform the individual install procedure for each component.

Step 1 - Copy Dataset COPY.JOB from Tape to Disk

The dataset COPY.JOB (Label 2) contains the JCL to unload all other existing datasets from tape to disk. To unload COPY.JOB, use the following sample JCL:

//SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X
//* ---------------------------------
//COPY EXEC PGM=IEBGENER
//SYSUT1 DD DSN=COPY.JOB,
// DISP=(OLD,PASS),
// UNIT=(CASS,,DEFER),
// VOL=(,RETAIN,SER=tape-volume),
// LABEL=(2,SL)
//SYSUT2 DD DSN=hilev.COPY.JOB,
// DISP=(NEW,CATLG,DELETE),
// UNIT=3390,VOL=SER=volume,
// SPACE=(TRK,(1,1),RLSE),
// DCB=*.SYSUT1
//SYSPRINT DD SYSOUT=*
//SYSIN DD DUMMY
// 

where:

hilev is a valid high level qualifier
tape-volume is the tape volume name, for example: T12345
volume is the disk volume name

Step 2 - Modify COPY.JOB on Your Disk

Modify the COPY.JOB on your disk to conform to your local naming conventions and set the disk space parameters before submitting this job:

Step 3 - Submit COPY.JOB

Submit COPY.JOB to unload all other datasets from the tape to your disk.

Top of page

Installation Procedure for the Natural TSO Interface

Step 1: Create CLIST

Step 2: Create ADARUN Cards

Step 3: Assemble the Natural TSO Interface Module

Step 4: Create and Assemble Parameter Module

Step 5: Link Natural TSO Nucleus

Step 6: Make Adabas Interface Available

Top of page

Installation Verification

Perform the following steps to verify the successful installation of the Natural TSO Interface:

  1. Enter TSO, READY mode.

  2. Invoke the CLIST you created at the beginning of this Installation Procedure.

    Example:

    EX 'SAGLIB.SMA.SRCE(NATvr)'
  3. Proceed with the steps described in the section Installation Verification for the TP Monitor Interface.

Top of page