This document describes how to install Natural Advanced Facilities (NAF) in a BS2000/OSD environment in batch mode and under TIAM and UTM.
Base Natural must be installed.
For further information, refer to the products and versions specified under Natural and Other Software AG Products and Operating and Teleprocessing Systems Required in the current Natural Release Notes.
The installation tape contains the datasets listed in the table below. The sequence of the datasets is shown in the Report of Tape Creation which accompanies the installation tape.
Dataset Name | Contents |
---|---|
NAFnnn.MOD |
NAF modules. |
NAFnnn.MAC |
NAF macros. |
NAnnn.INPL |
INPL file for libraries SYSPOOL and
SYSPRINT .
|
NAFnnn.ERRN |
NAF error messages. |
NAFnnn.SYSF |
Empty sample spool file; input to Adabas load utility. |
NAFnnn.JOBS |
NAF example jobs. |
The notation nnn
in dataset
names represents the version number of the product.
Step 3: Assemble the Natural Batch Driver and the Natural Parameter Module for the NAF Server Task *
In the following text, the library name JOBLIB
stands
for
the example job library
(NAFnnn.JOBS
) if you are not
using SMA or
the SMA job library (see SMA parameter JOBLIB
in SMA Parameter Group BASIC
) if you are using SMA.
Job I050, Step 0300
When you upgrade from the previous release of Natural Advanced Facilities, skip this step.
When you upgrade from an older release, see the section relating to Natural Advanced Facilities migration in the Natural Release Notes.
Load the NAF spool file contained in
NAFnnn.SYSF
by using the
ADALOD
utility. An initial size of one cylinder for this file will
be sufficient. The following parameters are mandatory
ISNREUSE=YES
to cause Adabas to reuse the ISN of a deleted record. For the file
number <fspool>
, you may choose
any value.
Job I055, Step 0300
Assemble the source module ANAFB2P
, which is contained in
dataset NAFnnn.JOBS
. If Natural
Security is installed, check the LOGON
command to
application SYSPRINT
.
The following examples illustrate how the parameters may be set.
DC01 = NAFDCAM1 DC02 = NAFDCAM2 DC03 = NO . . . . . DC30 = NO NAFERK1 = NAFP1 NAFERK2 = NAFP2 PA01 = 'STACK=(LOGON SYSPRINT,user1,passw;SVPBS201)' PA02 = 'STACK=(LOGON SYSPRINT,user2,passw;SVPBS201)' PA03 = 'NO' . . . . . PA30 = 'NO'
DC01 = NAFDCAM1 DC02 = NO . . . . . . DC30 = NO NAFERK1 = NAFP1 NAFERK2 = NAFP2 PA01 = 'STACK=(LOGON SYSPRINT;SVPBS201)' PA02 = 'NO' . . . . . PA30 = 'NO'
Note:
If Natural Security is installed, link the library
SYSPRINT
to a user which is normally not active in the security
environment. Moreover, link SYSPRINT
to as many users as there are
spool servers (1-9).
The parameters for DCAM connection (DC01 - D30
)
and for P1-EVENTING
(NAFERK1
,
NAFERK2
) must be different from those used for the same
function in any other application for the same CPU.
Described below are the parameters that can be specified in the macro
NAFB2P
:
Parameter | Explanation |
---|---|
DC01 - DC30 |
7 bytes indicating the name of the corresponding DCAM
application. Unused entries should be set to NO .
|
NAFERK1 |
8 bytes indicating the event ID for the communication between the online Natural and the spool server(s) and defining the name of the used common memory pool. |
NAFERK2 |
8 bytes indicating the event ID for the automatic startup for
spool server(s) using TP monitor UTM and the corresponding parameter
SPOOL=(name,
number) .
|
PA01 - PA30 |
Stack data for the initialization of Natural by using the
following format:
STACK=(LOGON library,userid; programname) If Natural Security is installed the format is as follows: STACK=(LOGON library,userid,password; programname) Unused parameters must be set to |
MONEVT |
Name of the event ID for the BS2000/OSD monitor task (8 bytes maximum). |
PAMO |
LOGON command for the monitor task.
The start program must always be set to SVPMON01 .
|
CMPSIZE |
Specifies the size of the NAF common memory pool (in units of 1 KB). The value is rounded up to the next higher multiple of 64 KB (64 KB = segment size = allocation unit for the common memory pools). |
RSOFORM |
Specifies the name of a form to be used by the spool server
when output is sent to an RSO printer. The information in the report is
ignored. If value ' ' is used, the information from the report is
used.
|
BS2FORM |
Specifies the name of a form to be used by the spool server
when output is sent to a system printer. The information in the report is
ignored. If value ' ' is used, the information from the report is
used.
|
PASEC |
Determines whether at logon, the spool server uses the
FSEC value applicable to the invoking online
application. (YES /NO ).
|
PANAT |
Determines whether at logon, the spool server uses the
FNAT value applicable to the invoking online
application. (YES /NO ).
|
ISO |
Determines whether the spool server(s) use(s) a DCAM ISO
application in addition to the DCAM NEA application.
(YES /NO ).
|
RSOPROT |
Determines whether the RSO messages resulting from the
|
MAXERR |
Specifies the maximum number of acceptable Natural spool
server abends (abnormal termination of Natural). If the specified limit is
exceeded, the spool server terminates itself.
|
(*) and also for the Natural Monitor task.
Job I055, Steps 0301 to 0303
ANAFFRNT |
Natural BS2000/OSD front-end batch driver |
ANAFRENT |
Natural BS2000/OSD reentrant batch driver |
ANAFPARM |
Natural BS2000/OSD batch parameter module |
Job I060, Step 0010 and Job I080, Step 0109
Modify the parameters FSPOOL
,
NTPRINT
, NAFUPF
and
NAFSIZE
in NATPARM
according to your site
requirements. For more information on these parameters, see
Natural Profile Parameters for
NATSPOOL.
Assemble and link the Natural parameter module
NATPARM
.
Job I060, Step 3802
Add the following INCLUDE
statements to the sources
LNATSHAR
in the ibrary
NAFnnn.JOBS
:
INCLUDE NAFNUC ,NAFnnn.MOD INCLUDE NAFREENT ,NAFnnn.MOD INCLUDE NAFB2RSO ,NAFnnn.MOD INCLUDE NAFSERVR ,NAFnnn.MOD
Job I061, Step 0300
Load the NAF system programs into the Natural system file by using the
Natural INPL
utility. INPL
loads the maintenance
programs under the application IDs SYSPOOL
and
SYSPRINT
.
Ensure that INPL
finishes with the message:
Natural Advanced Facilities initialized by INPL
If this initialization fails, various problems will be encountered at execution time.
This INPL
file contains the source for all maps used in
the NAF system.
These maps are provided in source form to enable users to customize the system (for example, to translate the maps from English to another language).
If these maps are modified, ensure that all fields have the same format/length/relative position in the map. Failure to abide by this restriction will result in an invalid system.
Job I061, Step 0304
Load the NAF error messages file (dataset
NAFnnn.ERRN
) by using the
ERRLODUS
program as described in the Natural SYSERR
Utility
documentation.
Job I065, Steps 0100, 0110, 0111, 0201
Link source members LNAFSERV
, LNAFSEND
,
LNAFMON
and LNAFMEND
in the library
NAFnnn.JOBS
.
Source | Function |
---|---|
LNAFSERV |
Links the program that starts the NAF server task. |
LNAFSEND |
Links the program that terminates the NAF server task. |
LNAFMON |
Links the program that starts the NAF monitor task. See also the section BS2000/OSD Monitor in Features in a BS2000/OSD Environment. |
LNAFMEND |
Links the program that terminates the NAF monitor task. |
Job I080, Steps 0100, 0200
Add the following INCLUDE
statements to the sources
LNUTFRNT
, LNRTFRNT
and/or LNATFRNT
in
the library JOBLIB
:
INCLUDE NAFB2P ,JOBLIB INCLUDE NAFFRONT ,NAFnnn.MOD
This step must only be performed, if NAF is being installed in a Natural Security environment.
Define SYSPOOL
to Natural Security with startup program
MENU
.
Start Natural and add the user profile, as defined in the
NAFUPF
parameter of NATPARM
, to the
SYSPOOL
file by using Function
31.1.
Note:
A NAT7201 message is issued at the start of the session indicating
that the profile has not yet been added to the SYSPOOL
file.
Job I200, Step 0300
When upgrading from Natural Advanced Facilities Version 4.1, omit this step.
See Migrating to Natural Advanced Facilities Version 4.2, Case 1, in the Natural Release Notes.
When upgrading from a Natural Advanced Facilities version prior to Version 4.1, you must proceed as described in the section Migrating to Natural Advanced Facilities Version 4.2, Case 2, in the Natural Release Notes.