Installing Super Natural on Mainframes

#### Search Results

Search

# Installing Super Natural on Mainframes

This section describes how to install Super Natural (language-dependent and language-independent Natural objects) under z/OS.

- Prerequisites

- Installation Jobs

- Using System Maintenance Aid

- Personal Database

- Contents of the Distribution Medium

- Installation Procedure

## Prerequisites

### Installation

The following software must be installed and running at your site before you install Super Natural:

- Adabas for Mainframes

- Natural for Mainframes

For product/version dependencies, refer to Natural and Other Software AG Products in the current Natural Release Notes for Mainframes.

### Transaction Modes

The following table lists the requirements which must be fulfilled in order to use certain Super Natural transaction modes.

Transaction Mode | Requirement
--- | ---
Destination PRINTER | Natural Advanced Facilities or Com-plete must be installed.
Destination WORK FILE | The operating system and TP monitor system used must support Natural work file access.
Destination PC | Entire Connection must be installed.

For information on the supported versions of the Natural add-on products mentioned in the table above, refer to Natural and Other Software AG Products in the current Natural Release Notes for Mainframes.

## Installation Jobs

The installation of Software AG products is performed by installation jobs. These jobs are either created manually or generated by System Maintenance Aid (SMA).

For each step of the installation procedure described below, the job number of a job performing the corresponding task is indicated. This job number refers to an installation job generated by SMA. If you are not using SMA, an example installation job of the same number is provided in the job library on the Natural installation medium; you must adapt this example job to your requirements.

## Using System Maintenance Aid

For information on using the Software AG product System Maintenance Aid, see the System Maintenance Aid documentation.

## Personal Database

The Super Natural personal database is the physical Adabas file that accommodates Super Natural user files as shown in the following diagram:

## Contents of the Distribution Medium

Super Natural is distributed as either a Special Purpose Medium or a System Maintenance Medium. The same data set (file) names are used for both media types, whereas volume serial numbers and the position of the data set (file) on the medium may vary.

All references in this document are made to data set (file) names, and are thus applicable to both types of media.

For a detailed description of the distribution medium, see The Software AG Product Delivery Report which accompanies the medium.

### Data Set (File) Names

Data set (file) names on Super Natural distribution medium are made up of three parts. The following is an example of a data set (file) name:

    NSNvrs.INPL

A Software AG product abbreviation forms the first part of the data set (file) name. Each data set (file) name contains one of the following:

- `NSN` for Super Natural

- `NZy` for Super Natural Language Module, where y is replaced by the language code letter of the language you want to install.

The second part of the name, represented by vrs, is substituted by the version, release and system maintenance level number of the software on your medium.

The third part of the name (the four letters after the period) denotes the type of data set (file). For example, `INPL` denotes a library of Natural modules.

### List of Data Sets (Files)

The distribution medium contains the following data sets (files) as standard labeled files.

#### NSNvrs.SYSF - Physical User File

This data set (file) contains the physical file description of the Super Natural physical user file in ADAULD format for use by the Personal Database.

#### NSNvrs.INPL - Language-Independent Objects and Master DDM for Personal Database

This data set (file) contains Super Natural language-independent modules in INPL format for loading into the Natural system system file (`FNAT`). It also contains the master DDM (Data Definition Module) for the Personal Database for loading into the Predict system file (`FDIC`).

#### NZyvrs.INPL - Language-Dependent Objects for Super Natural

This data set (file) contains Super Natural language-dependent maps (source and object modules) and programs.

#### NZyvrs.ERRN - Error Messages (Language-Dependent)

This data set (file) contains the Super Natural error message texts for loading into the Natural system file (`FNAT`).

#### NZyvrs.HLPS - Help Texts (Language-Dependent)

This data set (file) contains Super Natural help texts in a form suitable for loading into the Natural user file (`FUSER`) by the batch Natural program `SNLOAD` (this program is included in data set (file) NSNvrs.INPL).

#### Documentation on CD > supernat > tutorial > sample - Sample Application for the Tutorial

Sample application for the Super Natural RPC service on Natural for Windows. Contains the sample client to load to Natural for Windows.

## Installation Procedure

1. Delete former Super Natural versions from the Natural system system file (`FNAT`)

2. Load system file for personal database: Job I050

3. Load language-independent Natural objects: Job I061

4. Define `SYSSN` to Natural Security

5. Load language-dependent objects: Job I061

6. Load language-dependent help texts: Job I200

7. Load the sample application

### Step 1: Delete former Super Natural Versions from the Natural System File

#### Exception: Do not delete the following modules stored in the library `SYSSN`:

Natural Security Modules | `NSSNSPFI` `NSSNSPFL` `NSSNSPUL`
Predict Modules | `PRDNSPED` `PRDNSPFA` `PRDNSPFI` `PRDNSPRL` `PRDNSPSF` `PRDNSPWF`

####

### Step 2: Load System File for Personal Database

- (Job I050, Step 0400 NSNvrs.SYSF)

  Note
  For SMA Users:
  If you want to continue using your old system file, check that the `NSN-FIRST-INSTALL` parameter is set to `NO`.
  For Non-SMA Users:
  If you want to continue using your old system file, ignore this step.

  Load the `NSNvrs` system file as delivered on the installation medium using the ADALOD utility.

  The size of this file should be based on the size of your production environment. The following is a list of sample values:

      DBID=7
      NAME=FNSN
      FILE=20
      ISNREUSE=YES
      NISIZE=200B
      UISIZE=100B
      DSSIZE=100B
      MAXISN=1000
      VERSION=7
      USERISN=YES

### Step 3: Load language-independent Natural Objects

- (Job I061, Step 0400 NSNvrs.INPL)

  Job I061 performs the following SMA steps:

  The INPL utility loads the programs (maps, subprograms etc.) for Super Natural processor, administration and personal database and the master DDM for personal database.

  For the personal database master DDM, use the following input for `CMSYNIN`:

      INPL B

  Otherwise use the following input for `CMSYNIN`:

      INPL L

  The Super Natural modules are loaded into the library `SYSSN` on the Natural system system file (`FNAT`).

  The following modules are loaded into the library `SYSTEM` on the Natural system system file (`FNAT`):

  `LAYCHINA` | `LAYGEDUM`
  `LOADGDA` | `NRM-INPI`
  `NRM-INPL` | `NRMPRFD`
  `SNLIB` | `SNLOAD`
  `SNRTE` | `SNSWISA`
  `SNTEND` | `SNTENDE`
  `SPPRWF` | `SRNWSI`

  When the INPL is completed, you receive two messages confirming that Super Natural and the Natural Report Manager profiles for Super Natural have been successfully installed. If these messages do not appear, Super Natural is not correctly installed.

### Step 4: Define SYSSN to Natural Security

For information on defining `SYSSN` to Natural Security, see the Natural Security documentation.

### Step 5: Load language-dependent Objects

- (Job I061, Steps 04n1 NZyvrs.INPL, 04n2 NZyvrs.ERRN)

  Job I061 performs the following SMA steps where n is replaced by the language code number of the language you want to install:

  - #### Step 04n1 NZyvrs.INPL

    Loads the language-dependent Natural objects (programs and maps).

    Users not using SMA can issue the following command for `CMSYNIN`:

        INPL L

  - #### Step 04n2 NZyvrs.ERRN

    The ERRLODUS utility loads the Super Natural error messages into the Natural system file (`FNAT`).

    Users not using SMA can issue the following commands, as in the following example:

        LOGON SYSTEM
        ERRLODUS
        FIN

### Step 6: Load language-dependent Help Texts

- (Job I200, Step 04n3 NZyvrs.HLPS)

  The program `SNLOAD` loads the Super Natural help texts into the Natural user system file (`FUSER`).

  Users not using SMA can issue the following commands, as in the following example:

      LOGON SYSSN
      SNLOAD
      FIN

### Step 7: Load the Sample Application

Load the sample application for Natural for Windows from the Documentation CD (Documentation CD > supernat > tutorial > sample) to your Natural for Windows environmemnt.

The Super Natural RPC service objects, resulting from the tutorial samples 9, 10 and 11 are available on the library `SYSSN` on theNatural system system file (`FNAT`):

`RPCSMPL1` | `RPCSMPL2` | `RPCSMPL3`

The are intended to be compared with your own results if you proceed with the samples. You can copy the objects into the library `NSNSAMPL` on the Natural user system file (`FUSER`) to execute them with the sample application for Natural for Windows via RPC.

### On this page

- Prerequisites
- Installation Jobs
- Using System Maintenance Aid
- Personal Database
- Contents of the Distribution Medium
- Installation Procedure