Installing Super Natural on Mainframes

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

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.
Destination or Report Type Con-nect Con-nect 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:

graphics/persdat.gif

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

graphics/ingraphic6.gif

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

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

Con-nect Modules Z-DOCVAR
Z-VARSYM
Z-110
Z-120
Z-210
Z-220
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.