Version 8.2.3
 —  Installation and Set-Up  —

Installing Super Natural on Mainframes

This section describes how to install Super Natural Version 8.2.3 (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:

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.

Top of page

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.

Top of page

Using System Maintenance Aid

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

Top of page

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

Top of page

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:

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.

Top of page

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

Step 3: Load language-independent Natural Objects

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

Step 6: Load language-dependent Help Texts

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.

Top of page