Version 4.2.6 for Mainframes	SEARCH   INDEX   CONTENTS   |   PDF PAGE   PDF BOOKS   |   HOME   UP   PREV   NEXT

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

The following topics are covered:

• Prerequisites

• Installation Tape for the Natural TIAM Interface

• Installation Procedure for the Natural TIAM Interface

• Installation Verification

For detailed information on the following topics, refer to Natural under TIAM in the Natural TP Monitor Interfaces documentation.

• Structure of the Natural TIAM Interface

• Parameters in Macro NAMTIAM

• Common Memory Pools under TIAM

• Natural Shared Nucleus

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.

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.

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
• 2. Copy the Procedure COPY.PROC from Tape to Disk
• 3. Copy all Product Files from Tape to Disk

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.

Installation Procedure for the Natural TIAM Interface

Naming Conventions

In the following text, the library name JOBLIB stands for

• the example job library (NRTvrs.JOBS) if you are not using SMA or

• the SMA job library (see SMA parameter JOBLIB in SMA Parameter Group BASIC) if you are using SMA.

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

• (Job I070, Step 0102)

  The front-end part of Natural/TIAM is assembled by generating the macro NAMTIAM. You can generally use the default values of the parameters in macro NAMTIAM.

  Modify only the values of those parameters whose default values do not suit your requirements.

  For a description of the individual parameters, see Parameters in Macro NAMTIAM in the Natural TP Monitor Interfaces documentation.

  Assemble source module ANRTFRNT in the library JOBLIB to generate macro NAMTIAM for the front-end part.

Step 2: Assemble the Natural/TIAM Reentrant Part

• (Job I070, Step 0103)

  The reentrant part of Natural/TIAM is assembled by generating the macro NAMTIAM. You can generally use the default values of the parameters in macro NAMTIAM.

  Modify only the values of those parameters whose default values do not suit your requirements.

  For a description of the individual parameters, see Parameters in Macro NAMTIAM in the Natural TP Monitor Interfaces documentation.

  Assemble source module ANRTRENT in the library JOBLIB to generate macro NAMTIAM.

Step 3: Assemble the Natural/TIAM Parameter Module

• (Job I080, Step 0109)

  Assemble source module ANRTPARM in the library JOBLIB.

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

• (Job I080, Step 0110)

  Use the INCLUDE statements for TSOSLNK contained in LNRTFRNT in the library JOBLIB.

  Note:
  The source module ANATSTUB has been assembled during the installation of Natural for BS2000/OSD.

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.

www.softwareag.com

Copyright © Software AG 1979-2009. All rights reserved.

SEARCH   INDEX   CONTENTS   |   PDF PAGE   PDF BOOKS   |   HOME   UP   PREV   NEXT