This document describes how to install the Natural UTM Interface (product code NUT).
The following topics are covered:
For information on how to operate the Natural UTM Interface, refer to Natural under UTM 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.
The following software must be installed and running before you install the Natural UTM Interface:
Base Natural under BS2000/OSD. See Installing Natural Under BS2000/OSD.
Adabas UTM Interface (product code AUT), version as specified under Natural and Other Software AG Products in the current Natural Release Notes for Mainframes.
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 |
|---|---|
NUTvrs.MAC |
Macros necessary for Natural/UTM |
NUTvrs.SRC |
Sources necessary for Natural/UTM |
NUTvrs.JOBS |
Example job library for Natural/UTM |
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:
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)
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.
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.
In the following text, the library name
JOBLIB stands for
the example job library
(NUTvrs.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
(Job I070, Step 0110)
Prepare the sample KDCDEF instruction source
NUT.KDCDEF (LMS element type = D) in the library
JOBLIB so that it suits your
environment.
Therefore, refer to Defining the UTM Resources (KDCDEF) in the Natural TP Monitor Interfaces documentation.
(Job I070, Step 0111)
Assemble source module ANUTSTUB in the library
JOBLIB.
See also Local Common Memory Pools in the Natural Operations documentation.
(Job I070, Step 0112)
Assemble source module ANUTFRNT in the library
JOBLIB.
See also Keyword Parameters of Macro NATUTM in the Natural TP Monitor Interfaces documentation.
(Job I070, Step 0113)
Assemble source module ANUTRENT in the library
JOBLIB.
See also Keyword Parameters of Macro NURENT in the Natural TP Monitor Interfaces documentation).
(Job I070, Step 0114)
Assemble and link module ANUTSWP in the library
JOBLIB.
See also Keyword Parameters of Macro NTSWPRM in the section Defining the Swap Pool in the Natural Operations documentation.
(Job I070, Step 0120)
Assemble the sample source ANUTKDCR (generated under Step
1) in the library JOBLIB for the
KDCROOT module.
See also Generating KDCROOT in the Natural TP Monitor Interfaces documentation.
(Job I075, Step 0100)
Prepare the sample KDCDEF instruction source
NUT.KDCDEF (LMS element type = D) in the library
JOBLIB so that it suits your environment.
Therefore, refer to Defining the UTM Resources (KDCDEF) in the Natural TP Monitor Interfaces documentation.
(Job I080, Step 0200)
In source module ANUTPARM, modify the
Natural profile parameters
so that they suit your environment, but at least have a look at the following
parameters:
FNAT=(dbid,fnat) FUSER=(dbid,fuser)
Assemble source module ANUTPARM in the library
JOBLIB.
(Job I080, Step 0210)
Use the INCLUDE statements for TSOSLNK
contained in LNUTFRNT in the library
JOBLIB.
Submit job E.START.SWP in the library
JOBLIB to start the Natural Swap
Pool.
Submit job E.START.NUT in the library
JOBLIB, which is a sample job for
starting Natural under UTM.
Proceed with the steps described in the section Installation Verification for the TP Monitor Interface.
