This document describes the steps for installing the Natural openUTM Interface (product code NUT) on BS2000.
For information on how to operate the Natural openUTM Interface, see Natural under openUTM in the TP Monitor Interfaces documentation.
When used in this document, the notation
vrs
or
vr
represents the relevant product
version (see also Version in the
Glossary).
A supported version of the following product must be installed before you can install the Natural openUTM Interface:
Adabas UTM Interface (product code AUT)
See also General Prerequisites and System Support in the section Overview of the Installation Process.
The installation medium contains the following files required for product installation:
File Name | Contents |
---|---|
NUTvrs.SRC |
Source modules |
NUTvrs.MAC |
Macros |
NUTvrs.JOBS |
Sample installation jobs |
Copy the files into your environment as described in Copying Files to a BS2000 Disk in the section Installing Natural.
Be sure to read Installation Process and Major Natural Features and Naming Conventions for Installation Procedures before you start the installation procedure.
Step 2: Assemble the BS2STUB Module for the Natural openUTM Interface
Step 3: Assemble the Non-Reentrant Part for the Natural openUTM Interface
Step 4: Assemble the Reentrant Part for the Natural openUTM Interface
(Job I070, Step 0110)
Prepare the sample KDCDEF
instruction source
NUT.KDCDEF
(LMS element type = D) in the library
job-library
so that it suits your environment.
Therefore, refer to Defining the openUTM Resources (KDCDEF) in the TP Monitor Interfaces documentation.
(Job I070, Step 0111)
Assemble the source module ANUTSTUB
in the library
job-library
.
See also Local Common Memory Pools in the Operations documentation.
(Job I070, Step 0112)
Assemble the source module ANUTFRNT
in the library
job-library
.
See also Keyword Parameters of Macro NATUTM in the TP Monitor Interfaces documentation.
(Job I070, Step 0113)
Assemble the source module ANUTRENT
in the library
job-library
.
See also Keyword Parameters of Macro NURENT in the TP Monitor Interfaces documentation.
(Job I070, Step 0114)
Assemble and link the module ANUTSWP
in the library
job-library
.
See also Keyword Parameters of Macro NTSWPRM in the section Defining the Swap Pool in the Operations documentation.
(Job I070, Step 0120)
Assemble the sample source ANUTKDCR
(generated in
Step 1) in the library
job-library
for the KDCROOT
module.
See also Generating KDCROOT in the TP Monitor Interfaces documentation.
(Job I075, Step 0100)
Use the sample KDCDEF
instruction source
NUT.KDCDEF
prepared in
Step 1.
(Job I080, Step 0200)
Build the Natural parameter module for the Natural openUTM Interface.
Set the FNAT
and
FUSER
profile parameters (see the Parameter Reference
documentation) in the source module ANUTPARM
of the Natural
parameter module:
FNAT=(database-id,file-number) FUSER=(database-id,file-number)
where database-id
and
file-number
are the values you
specified when loading the system files during the
Installation
Procedure for base Natural.
Assemble the source module ANUTPARM
in the library
job-library
.
(Job I080, Step 0210)
Use the INCLUDE
statements for BINDER
contained in LNUTFRNT
in the library
job-library
.
If the parameter ILCS=CRTE
is specified for the assembly
of NURENT
, the BINDER
statements for the masking of
symbols have to be specified as follows:
INCLUDE-MODULES ELEMENT=(IT0SL#),LIB=$TSOS.SYSLNK.CRTE RESOLVE-BY-AUTOLINK LIB=($TSOS.SYSLNK.CRTE) MODIFY-SYMBOL-VISIBILITY - SYMBOL-NAME = *ALL, - SYMBOL-TYPE = *DEFINITIONS, - VISIBLE = *YES MODIFY-SYMBOL-VISIBILITY - SYMBOL-NAME = (CMPRMTB,NU8*), - SYMBOL-TYPE = *DEFINITIONS, - VISIBLE = *NO(KEEP-RES=*YES)
VISIBLE = *YES
: Necessary to prevent duplicate loading
of the CRTE routines.
VISIBLE = *NO(KEEP-RES=*YES)
: The entry
CMPRMTB
in the Natural parameter module has to be masked if the
Natural parameter module is bound to the environment-dependent nucleus.
You can verify the successful installation of the Natural openUTM Interface by performing the following steps:
Submit the job E.START.SWP
in the library
job-library
to start the Natural swap pool.
Submit the job E.START.NUT
in the library
job-library
,
which is a sample job for starting Natural under openUTM.
Enter the Natural transaction code.
Proceed with the steps described in the section Test Online Natural.