Installing Natural openUTM Interface on BS2000/OSD

This document describes the steps for installing the Natural openUTM Interface (product code NUT) on BS2000/OSD.

Prerequisites
Installation Medium
Installation Procedure
Installation Verification

Notation `vrs` or `vr`:

When used in this document, the notation vrs or vr represents the relevant product version (see also Version in the Glossary).

Prerequisites

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.

Installation Medium

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/OSD Disk in the section Installing Natural.

Installation Procedure

Be sure to read Installation Process and Major Natural Features and Naming Conventions for Installation Procedures before you start the installation procedure.

Step 1: Generate the KDCROOT Source
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
Step 5: Generate the Swap Pool Parameter Module NTSWPRM
Step 6: Assemble KDCROOT
Step 7: Generate KDCFILE
Step 8: Build the Natural Parameter Module
Step 9: Link the Environment-Dependent Nucleus

Step 1: Generate the KDCROOT Source

(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.

Step 2: Assemble the BS2STUB Module for the Natural openUTM Interface

(Job I070, Step 0111)

Assemble the source module ANUTSTUB in the library job-library.

See also Local Common Memory Pools in the Operations documentation.

Step 3: Assemble the Non-Reentrant Part for the Natural openUTM Interface

(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.

Step 4: Assemble the Reentrant Part for the Natural openUTM Interface

(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.

Step 5: Generate the Swap Pool Parameter Module NTSWPRM

(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.

Step 6: Assemble KDCROOT

(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.

Step 7: Generate KDCFILE

(Job I075, Step 0100)

Use the sample KDCDEF instruction source NUT.KDCDEF prepared in Step 1.

Step 8: Build the Natural Parameter Module

(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.

Step 9: Link the Environment-Dependent Nucleus

(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.

Installation Verification

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.