Version 4.2.6 for Mainframes
 —  Installation  —

Installing the Natural IMS TM Interface

This document describes how to install the Natural IMS TM Interface (product code NII).

The following topics are covered:

For detailed information on using the Natural IMS TM Interface, refer to Natural under IMS TM 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

The following software must be installed and running before you install the Natural IMS TM Interface:

For details, see the relevant sections in the Natural under IMS TM or Natural Operations documentation.

Top of page

Installation Tape for the Natural IMS TM Interface

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

Dataset Name Contents
NIIvrs.LOAD Load modules of the Natural IMS TM Interface
NIIvrs.SRCE Source programs and macros of the Natural IMS TM Interface

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.

Sample Jobs

The sample jobs are contained in the dataset NATvrs.JOBS and are prefixed with NII.

Top of page

Installation Procedure for the Natural IMS TM Interface

The installation procedure comprises the following:

  1. Common Installation Steps

  2. Installing the Batch Message Processing BMP Environment

  3. Installing the Message-Oriented NTRD Environment

  4. Installing the Dialog-Oriented MPP Environment

  5. Installing the Server Environment

  6. Customizing the IMS TM Environment

Perform the steps in the sequence indicated above.

Top of page

Common Installation Steps

The following steps are required to install the Natural IMS TM Interface in a BMP, an NTRD an MPP and/or a server environment:

Step 1: Create and Assemble the Transaction Code Table

Step 2: Create and Assemble the Parameter Module

Step 3: Link the Interface Module

Top of page

Installing the Batch Message Processing BMP Environment

The following steps are required to install the Natural IMS TM Interface for the BMP environment:

Step 1: Create and Assemble the BMP Interface

Step 2: Link the BMP Front-End

Top of page

Installing the Message-Oriented NTRD Environment

The following steps are required to install the Natural IMS TM Interface for the NTRD environment:

Step 1: Create and Assemble the NTRD Interface

Step 2: Link the NTRD Front-End

Top of page

Installing the Dialog-Oriented MPP Environment

The following steps are required to install the Natural IMS TM Interface for the MPP environment:

Step 1: Create and Assemble the Online Natural Parameter Module

Step 2: Create and Assemble the Conversational MPP Interface

Step 3: Link the Conversational MPP Front-End

Step 4: Create and Assemble the Non-Conversational MPP Interface

Step 5: Link the Non-Conversational MPP Front-End

Step 6: Allocate and Format the Roll Files

Top of page

Installing the Server Environment

The following steps are required to install the Natural IMS TM Interface for the sever environment:

Step 1: Create and Assemble the Server Interface

Step 2: Link the Server Front-End

Step 3: Create and Assemble the Bootstrap Module NIIBOOTS

Top of page

Customizing the IMS TM Environment

The following steps require system modifications to your IMS TM environment.

Step 1: Create the APPLCTN Table Definitions for MPP, BMP and NTRD

Step 2: Create the PSB/ACB for both the MPP and BMP

Step 3: Create the BMP and MPP Regions

Step 4: Create the PRELOAD List

Top of page

Installing the Optional Multi-Session Feature

The multi-session feature is an optional feature of the Natural IMS TM Interface. For details, see the relevant section in the Natural TP Monitor Interfaces documentation.

Step 1: Create the Multi-Session Database

Step 2: Adapt the Parameter Module of the Natural IMS TM Interface

Step 3: Adapt the Transaction Code Table

Top of page

Installation Verification

  1. From an IMS TM session, start a BMP with the following IMS TM command:

    /STA REG BMPJOB
    
  2. Check the output. The output results from the Natural system command TECH. Verify the output with your environment.

  3. From an IMS TM session, issue the following IMS TM commands:

    /STA REG MPPJOB
    /STA TRAN NATvrs
    /STA PROG NIIvrsFR
    
  4. Type in transaction name NATvrs.

  5. Proceed with the steps described in the section Installation Verification for the TP Monitor Interface.

Top of page