This document describes the steps for installing Natural (product code NAT) on BS2000.
For information on how to run Natural in a BS2000 environment, see the relevant section in the Operations documentation.
When used in this document, the notation
vrs
or
vr
represents the relevant product
version (see also Version in the
Glossary).
See General Prerequisites and System Support.
The installation medium contains the following files required for product installation:
File Name | Contents |
---|---|
ICSvrs.MOD |
Load modules and object modules for International Components for Unicode for Software AG (ICS) |
MLCvrs.JOBS
|
Sample installation jobs for Software
AG's mainframe license check software
For detailed information on the license check software, see Software AG Mainframe Product Licensing. |
MLCvrs.MOD
|
Load modules and object modules for
Software AG's mainframe license check software including the LICUTIL license
utility
For detailed information on the license check software and the LICUTIL utility, see Software AG Mainframe Product Licensing. |
NATvrs.LICS |
Product license file
For information on the license file and product licensing, see Software AG Mainframe Product Licensing. |
NATvrs.SRC |
Source modules |
NATvrs.SYSF |
Natural system file definitions |
NATvrs.MOD |
Load modules and object modules |
NATvrs.MAC |
Macros |
NATvrs.JOBS |
Sample installation jobs |
NATvrs.INPL |
Natural objects |
NATvrs.EXPL |
Natural example objects |
Note:
The file
NATvrs.JOBS
will be converted
automatically into an LMS library when it is copied from the installation
medium to disk.
Copy the files (data sets) from the supplied installation medium to your disk before you perform the individual installation procedure for each component to be installed.
The way you copy the files depends on the installation method and the medium used:
If you use System Maintenance Aid (SMA), refer to the copy job instructions provided in the System Maintenance Aid documentation.
If you are not using SMA and want to copy the files from CD-ROM, refer to the README.TXT file on the CD-ROM.
If you are not using SMA and want to copy the files from tape, follow the instructions in this section.
This section explains how to copy all files from tape to disk.
This step is not necessary if you have already copied the library
SRVvrs.LIB
from another Software AG
installation tape. For further information, refer to the element
#READ-ME
in this library. The library
SRVvrs.LIB
is stored on the tape as a
sequential file named SRVvrs.LIBS
containing LMS commands. The current version
vrs
can be obtained from the
Software AG Product Delivery Report.
Execute the following commands to convert
SRVvrs.LIBS
into an LMS library:
/IMPORT-FILE SUPPORT=*TAPE(FILE-NAME=SRVvrs.LIBS,- / VOLUME=volser, DEV-TYPE=tape-device) /ADD-FILE-LINK LINK-NAME=EDTSAM, FILE-NAME=SRVvrs.LIBS,- / SUPPORT=*TAPE(FILE-SEQ=3), ACC-METH=*BY-CAT,- / BUF-LEN=*BY-CAT, REC-FORM=*BY-CAT, REC-SIZE=*BY-CAT /START-EDT @READ '/' @SYSTEM 'REMOVE-FILE-LINK EDTSAM' @SYSTEM 'EXPORT-FILE FILE-NAME=SRVvrs.LIBS' @WRITE 'SRVvrs.LIBS' @HALT /ASS-SYSDTA SRVvrs.LIBS /MOD-JOB-SW ON=1 /START-PROG $LMS /MOD-JOB-SW OFF=1 /ASS-SYSDTA *PRIMARY
where:
tape-device
is the device
type of the tape, for example, TAPE-C4
, and
volser
is the VOLSER of the
tape (see the Software AG Product Delivery
Report).
Call the procedure P.COPYTAPE
in the library
SRVvrs.LIB
to copy the procedure
COPY.PROC
to disk:
/CALL-PROCEDURE (SRVvrs.LIB,P.COPYTAPE), - / (VSNT=volser, DEVT=tape-device)
If you use a TAPE-C4 device, you can omit the parameter
DEVT
.
Enter the procedure COPY.PROC
to copy all product files to
disk:
/ENTER-PROCEDURE COPY.PROC, DEVT=tape-device
If you use a TAPE-C4 device, you can omit the parameter
DEVT
.
The result of this procedure is written to the file
L.REPORT.SRV
.
Be sure to read Installation Process and Major Natural Features and Naming Conventions for Installation Procedures before you start the installation procedure.
Step 1: Prepare, Convert, Assemble and Link the License File
Step 8: Assemble the Natural BS2000 Stub Module and Batch Driver
Step 13: Load New Natural Objects and Natural Error Messages
(Job I010, Steps 0110, 0111, 0112)
You must install a valid Natural license file.
For detailed information on the license file and product licensing, see Software AG Mainframe Product Licensing.
Copy the license file from the supplied installation medium to disk or transfer it from the PC as described in Transferring a License File from PC to a BS2000 Host Using FTP in Software AG Mainframe Product Licensing.
Check, convert, assemble and link the license file:
Step 0110 | Check license file
NATvrs.LICS . This job runs the
CHECK
function of the LICUTIL license utility (see below).
|
Step 0111 | Convert license file into an assembler source. This job runs the MAKE function of the LICUTIL license utility (see below). |
Step 0112 | Assemble and link the assembler source to generate
load module ANATLIC . This module is then linked to the
nucleus in Job I060.
|
The functions and option settings provided by LICUTIL are described in Using the License Utility: LICUTIL in Software AG Mainframe Product Licensing.
(Job I050, Step 0100)
Skip this step if you want to use an existing Natural FNAT
system file.
Load the new Natural FNAT
system file definition:
Specify the database ID and file number of the Adabas file where to load
the new FNAT
system file definition by using the Adabas ADALOD
utility.
In addition, you must specify this database ID and file number in the Natural parameter module as described in Step 9: Build the Natural Parameter Module.
Load the FNAT
system file definition contained in the
NATvrs.SYSF
file by using the Adabas ADALOD
utility.
The following ADALOD utility parameter must not be changed:
ISNREUSE=YES
The following ADALOD utility parameter setting is recommended:
USERISN=YES
If you reorganize an FNAT
file
or if you unload from or load data to the FNAT
file (for example, by using ADAULD
/ADALOD
),
you must specify the parameter USERISN=YES
for the ADALOD
utility to avoid
Natural errors NAT7397 and NAT9988 which require that you re-INPL the Natural FNAT
system file.
If you specify the parameter USERISN=YES
when you load a new FNAT
system file,
and you unload data from this FNAT
file, the ADALOD
utility assumes USERISN=YES
as a default setting when reloading the data into the FNAT
file.
(Job I050, Step 0101)
Skip this step if you want to use an existing Natural FUSER
system file.
Load the new Natural FUSER
system file definition:
Specify the database ID and file number of the Adabas file where to load
the new FUSER
system file definition by using the Adabas ADALOD
utility.
In addition, you must specify this database ID and file number in the Natural parameter module as described in Step 9: Build the Natural Parameter Module.
Load the FUSER
system file definition contained in the
NATvrs.SYSF
file by using the Adabas ADALOD
utility.
The following ADALOD utility parameter must not be changed:
ISNREUSE=YES
If you want to use existing Natural applications, copy all user-written
objects to the empty FUSER
.
If you want to use Natural Application Programming Interfaces (APIs), see Using a Natural API in the SYSEXT Utility documentation for further guidance.
This step is only required if you want to use read-only system files. See also Natural Scratch-Pad File in the Operations documentation.
You can skip this step if you want to use an existing Natural scratch-pad file.
This step is not supported by System Maintenance Aid (SMA).
Load the new Natural scratch-pad system file definition:
Specify the database ID and file number of the Adabas file where to load the scratch-pad file by using the Adabas ADALOD utility.
In addition, you must specify this database ID and file number in the Natural parameter module as described in Step 9: Build the Natural Parameter Module.
Load the scratch-pad system file definition contained in the
NATvrs.SYSF
file by using the Adabas ADALOD
utility.
The following ADALOD utility parameter must not be changed:
ISNREUSE=YES
(Job I050, Step 0104)
This step is only required if registry information must be available to
control concurrent user sessions limited with the Natural profile parameter
UCONMAX
(see the Parameter Reference documentation).
You can skip this step if you want to use an existing Natural
FREG
system file.
This step is not supported by System Maintenance Aid (SMA).
Load the new Natural FREG
system file definition:
Specify the database ID and file number of the Adabas file where to load
the FREG
system file by using the Adabas ADALOD utility.
In addition, you must specify this database ID and file number in the Natural parameter module as described in Step 9: Build the Natural Parameter Module.
Load the FREG
system file definition contained in the
NATvrs.SYSF
file by using the Adabas ADALOD
utility.
The following ADALOD utility parameter must not be changed:
ISNREUSE=YES
(Job I050, Step 0103)
Skip this step:
if you want to install Predict. In this case, use the corresponding installation step described in the Predict Installation documentation.
if you want to use an existing Natural FDIC
system file.
Load the new Natural FDIC
system file definition:
Specify the database ID and file number of the Adabas file where to load
the new FDIC
system file definition by using the Adabas ADALOD
utility.
In addition, you must specify this database ID and file number in the Natural parameter module as described in Step 9: Build the Natural Parameter Module.
Load the FDIC
system file definition contained in the
NATvrs.SYSF
file by using the Adabas ADALOD
utility.
The following ADALOD utility parameter must not be changed:
ISNREUSE=YES
Note:
If you also install Predict, you must refresh the FDIC system
file before you initialize Predict. See
Step 16: Refresh the FDIC
System File for Predict.
(Job I050, Step 9900)
Skip this step, if you do not use Natural Security.
If you use Natural Security, refer to Installing Natural Security.
(Job I055, Steps 0216 - 0218)
Assemble the following source modules:
ANATSTUB |
Natural BS2000 stub module |
ANATFRNT |
Natural BS2000 non-reentrant part of the Natural batch interface |
ANATRENT |
Natural BS2000 reentrant part of the Natural batch interface |
These source modules are contained in the library
job-library
.
(Job I060, Step 0010)
Build the Natural parameter module for batch mode.
Modify the settings of the Natural profile parameters supplied with this job, if required. The parameters and corresponding macros (if applicable) are described in the Parameter Reference documentation. The most important parameter/macro settings are described below.
Adapt the following parameters:
FNAT=(database-id,file-number) FUSER=(database-id,file-number) FDIC=(database-id,file-number)
where database-id
and
file-number
are either the database ID
and file number you specified when loading the new FNAT
,
FUSER
and FSEC
system files (see Step 2,
Step
3 and Step
6, respectively), or the database ID and file
number of your existing Natural system files.
These parameters are supplied with the
NTPRM
macro
described in the Operations documentation.
If you want to to limit the number of concurrent users with the Natural
profile parameter UCONMAX
,
proceed as follows:
Supply the following parameter with the NTPRM
macro:
FREG=(database-id,file-number)
where database-id
and
file-number
are either the database ID
and file number you specified when loading the new Natural FREG
system file (see Step 5), or
the database ID and file number of your existing Natural FREG
system file.
If you want to use read-only system files, proceed as follows:
Supply the following parameter with the NTPRM
macro:
ROSY=ON
Specify the
NTLFILE
macro (see the parameter LFILE
):
NTLFILE 212,database-id,file-number
where database-id
and
file-number
are the database ID and
file number you specified when loading the new Natural scratch-pad file (see
Step
4), or the database ID and file number of your
existing Natural scratch-pad file.
Assemble the Natural parameter module.
(Job I060, Step 1230)
This step is only required if you want to use the Optimize Monitor Buffer Pool described in Optimize Monitor Buffer Pool in the Operations documentation.
Link the NATO4I82
program for the Optimize
Monitor Buffer Pool.
Create and start the job E.START.O4IBP
(supplied
with Step 1230) before using Natural. See
Starting
the Optimize Monitor Buffer Pool in the
Operations documentation.
(Job I060, Steps 3801, 3802)
Link the environment-dependent nucleus
LNATFRNT
(Step 3801) for batch Natural.
The list of modules to be linked for the environment-dependent nucleus is supplied with Step 3801.
Note:
If the parameter ILCS=CRTE
is specified for
the assembly of the reentrant part of the BS2000 batch driver, 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, - 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.
Link the environment-independent nucleus
LNATSHAR
(Step 3802).
The list of modules to be linked for the environment-independent nucleus is supplied with Step 3802.
Ensure that the Natural profile parameter
NUCNAME
(see the Parameter Reference documentation) specified in
the Natural parameter module contains the name of the module resulting from
this link step.
If you want to use a sort program (either Natural's internal one
or an external one), include the module NAT2SORT
.
It is also possible to place NAT2SORT
in a load
library from where it can be loaded dynamically at runtime; this requires that
NAT2SORT
is specified with the Natural profile parameter
RCA
(described in the Parameter Reference documentation).
(Job I061, Step 0001)
Start the job E.START.ALL
which is contained in
the library job-library
.
To end all pools, start the job E.END.ALL
which
is contained in the library
job-library
.
(Job I061, Step 0100)
Load the Natural objects and Natural error messages from the
NATvrs.INPL
file into the Natural
system files by using the Natural INPL utility.
The Natural error messages comprise short and long message texts and the
German (ULANG=2
) short message texts. You can use the
ERRUPPER
program of the Natural SYSERR utility to convert the
message texts to upper case.
For details on the ULANG
profile
parameter and ERRUPPER
,
see the Parameter Reference and the
Utilities documentation, respectively.
(Job I061, Step 0103)
Load the Natural example objects from the
NATvrs.EXPL
file into the Natural
system file by using the Natural INPL
utility.
(Job I081, Step 1900)
Allocate the editor work file (see also Editor Work File in the Operations documentation) by issuing the command:
/FILE file-name,LINK=CMEDIT,SPACE=...
Execute the formatting program (NATEDFM2
,
NATvrs.MOD
) by entering
FORMAT
to format and load the control record in the
editor work file.
(Job I200, Step 0500)
This step is only required if you install Predict on a new FDIC dictionary system file.
Refresh the FDIC system file to allow Predict access.
This section provides instructions for verifying the successful installation of Natural.
You can use the following procedure to invoke Natural in batch mode and check whether the Natural system files are available:
/ SET-PROCEDURE-OPTIONS DATA-ESCAPE-CHAR = *STD / ADD-FILE-LINK DDLIB, ADALNK.LIB / ADD-FILE-LINK DDLNKPAR, ADALNK.PARMS / ADD-FILE-LINK CMEDIT, EDTWORK / START-PROGRAM NATBATCH EDIT WRITE 'TESTBAT' END .END SAVE TESTBAT RUN FIN / EXIT-PROCEDURE
This procedure starts Natural (using the Adabas link routine
ADALNK
), creates the example program TESTBAT
, and
executes the program with the system command
RUN
.
Start a Natural session according to the procedure that applies to your TP monitor interface; see also Installation Verification described for the Natural TIAM Interface and the Natural openUTM Interface.
You can use the following verification procedure to test Natural system functions in online mode and check whether the Natural system files are available.
Enter the following Natural system command to check the Natural system files:
SYSPROF
Enter the following Natural system command:
SYSDDM
In the SYSDDM utility menu, enter the following:
R
in the Code field and
EMPLOYEES
in the DDM Name
field.
After pressing ENTER, enter the following:
C
in the Code field,
the appropriate Natural system file number in the
FNR field,
the appropriate database ID in the DBID field,
and
Y
in the Replace field.
The specified DDM has been adapted to your environment.
Repeat Steps 9 and 10 for the VEHICLES
DDM.
Check whether the EMPLOYEES
and VEHICLES
DDMs
are now available in your environment:
Enter the following Natural system command to logon to the Natural
library SYSEXSYN
:
LOGON SYSEXSYN
Execute an example program that uses EMPLOYEES
and
VEHICLES
, for example, IFEX1S
, by entering the
following Natural system command:
RUN IFEX1S