Version 4.2.6 for Mainframes
 —  Installation  —

Installing the Natural TIAM Interface

This document describes how to install the Natural TIAM Interface (product code NRT).

The following topics are covered:

For detailed information on the following topics, refer to Natural under TIAM 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 BS2000/OSD.

See Installing Natural under BS2000/OSD.

Top of page

Installation Tape for the Natural TIAM Interface

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

Dataset Name Contents
NRTvrs.MAC Macros necessary for Natural/TIAM
NRTvrs.JOBS Example job library for Natural/TIAM

Copying the Tape Contents to a BS2000/OSD Disk

If you are not using System Maintenance Aid (SMA), use the procedure described below. In this procedure, the values specified below must be supplied.

To copy the datasets from tape to disk, perform the following steps:

1. Copy the Library SRVvrs.LIB from Tape to Disk

This step is not necessary if you have already copied the library SRVvrs.LIB from another Software AG installation tape. For further information, refer to the element #READ-ME in this library. The library SRVvrs.LIB is stored on the tape as a sequential file named SRVvrs.LIBS containing LMS commands. The current version vrs can be obtained from the Report of Tape Creation. To convert this sequential file into an LMS-library, execute the following commands:

/IMPORT-FILE  SUPPORT=*TAPE(FILE-NAME=SRVvrs.LIBS,       -
/   VOLUME=volser, DEV-TYPE=tape-device)
/ADD-FILE-LINK  LINK-NAME=EDTSAM, FILE-NAME=SRVvrs.LIBS, -
/   SUPPORT=*TAPE(FILE-SEQ=3), ACC-METH=*BY-CAT,                -
/   BUF-LEN=*BY-CAT, REC-FORM=*BY-CAT, REC-SIZE=*BY-CAT
/START-EDT 
@READ  '/'
@SYSTEM 'REMOVE-FILE-LINK  EDTSAM'
@SYSTEM 'EXPORT-FILE  FILE-NAME=SRVvrs.LIBS'
@WRITE  'SRVvrs.LIBS'
@HALT
/ASS-SYSDTA  SRVvrs.LIBS
/MOD-JOB-SW  ON=1
/START-PROG  $LMS
/MOD-JOB-SW  OFF=1
/ASS-SYSDTA  *PRIMARY

where:

tape-device is the device-type of the tape, for example: TAPE-C4
volser is the VOLSER of the tape (see Report of Tape Creation)

2. Copy the Procedure COPY.PROC from Tape to Disk

To copy the procedure COPY.PROC to disk, call the procedure P.COPYTAPE in the library SRVvrs.LIB:

/CALL-PROCEDURE  (SRVvrs.LIB,P.COPYTAPE), -
/   (VSNT=volser, DEVT=tape-device)

If you use a TAPE-C4 device, you may omit the parameter DEVT.

3. Copy all Product Files from Tape to Disk

To copy all Software AG product files from tape to disk, enter the procedure COPY.PROC:

/ENTER-PROCEDURE  COPY.PROC, DEVT=tape-device

If you use a TAPE-C4 device, you may omit the parameter DEVT. The result of this procedure is written to the file L.REPORT.SRV.

Top of page

Installation Procedure for the Natural TIAM Interface

Naming Conventions

In the following text, the library name JOBLIB stands for

Note:
Software AG uses the following naming conventions for source elements in the library JOBLIB:

A<product-code><function> = Assembler sources
L<product-code><function> = Instruction for TSOSLNK/BINDER

Example: ANATFRNT, ANATRENT, ANATSTUB or LNATFRNT

Step 1: Assemble the Natural/TIAM Non-Reentrant Front-End Part

Step 2: Assemble the Natural/TIAM Reentrant Part

Step 3: Assemble the Natural/TIAM Parameter Module

Step 4: Link the Natural/TIAM Front-End Part

Top of page

Installation Verification

  1. Call procedure P.STARTNRT in library JOBLIB to start Natural under TIAM.

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

Top of page