This document describes the steps for installing Natural (product code NAT) on z/OS.
For information on how to run Natural in a z/OS environment, see 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 data sets required for product installation:
Data Set Name | Contents |
---|---|
ICSvrs.LOAD |
Load modules for International Components for Unicode for Software AG (ICS) |
ICSvrs.SRCE |
Source modules for International Components for Unicode for Software AG (ICS) |
MLCvrs.JOBS
|
Sample installation jobs for Software AG's
mainframe license check software
The placeholder For detailed information on the license check software, see Software AG Mainframe Product Licensing. |
MLCvrs.LOAD
|
Load modules for Software AG's mainframe license
check software containing the LICUTIL license utility
The placeholder For detailed information on the license check software and the LICUTIL utility, see Software AG Mainframe Product Licensing. |
NATvrs.LOAD |
Load modules |
NATvrs.LICS |
Product license file for Natural
For information on the license file and product licensing, see Software AG Mainframe Product Licensing. |
NAZvrs.LICS |
Product license file for the zIIP Enabler for
Natural
For information on the license file and product licensing, see Software AG Mainframe Product Licensing. |
NATvrs.SRCE |
Source modules and macros |
NATvrs.SYSF |
Natural system file definitions |
NATvrs.OBJS |
Object modules |
NATvrs.JOBS |
Sample installation jobs |
NATvrs.INPL |
Natural objects |
NATvrs.EXPL |
Natural example objects |
Copy the 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 data sets 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 data sets from CD-ROM, refer to the README.TXT file on the CD-ROM.
If you are not using SMA and want to copy the data sets from tape, follow the instructions in this section.
This section explains how to copy all data sets from tape to disk.
Modify the following sample job according to your requirements:
//SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X //* --------------------------------- //COPY EXEC PGM=IEBGENER //SYSUT1 DD DSN=COPY.JOB, // DISP=(OLD,PASS), // UNIT=(CASS,,DEFER), // VOL=(,RETAIN,SER=tape-volser), // LABEL=(2,SL) //SYSUT2 DD DSN=hilev.COPY.JOB, // DISP=(NEW,CATLG,DELETE), // UNIT=3390,VOL=SER=disk-volser, // SPACE=(TRK,(1,1),RLSE), // DCB=*.SYSUT1 //SYSPRINT DD SYSOUT=* //SYSIN DD DUMMY //
where:
tape-volser
is the VOLSER
of the tape, for example: T12345
,
hilev
is a valid high-level
qualifier, and
disk-volser
is the VOLSER
of the disk.
Execute the job to copy the data set COPY.JOB
to your
disk.
Modify hilev.COPY.JOB
according
to your requirements:
Set EXPDT
to a valid expiration date, for example,
99365
.
Set HILEV
to a valid high-level qualifier, for example,
USERLIB
.
Set LOCATION
to a storage location, for example,
STORCLAS=ABC
or UNIT=3390,VOL=SER=USR123
.
Execute hilev.COPY.JOB
to copy
single, multiple, or all data sets to your disk.
Be sure to read Installation Process and Major Natural Features before you start the installation procedure.
Step 2: Prepare, Convert, Assemble and Link the License File
Step 12: Build the Natural-Specific IBM Language Environment Options
Step 15: Load New Natural Objects and Natural Error Messages
Step 20: Create and Start the Natural Authorized Services Manager
(Job I002, Steps 0010, 0020, 0030, 0040)
Allocate the user-specific source, load and save libraries of System
Maintenance Aid (SMA) and copy them to the LOAD.SAVE
library.
Make sure that the SMA parameters are set correctly:
Set |
(Job I007, Steps 0101, 0102, 0104 and optional Steps 0111, 0112, 0114)
You must install a valid Natural license file. An additional license file is required if you want to install the zIIP Enabler for Natural to enable support of the IBM z/IIP (IBM System z Integrated Information Processor).
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 z/OS Host Using FTP in Software AG Mainframe Product Licensing.
Set the System Maintenance Aid (SMA) parameter
LICCHECK
to Y
(Yes).
Check, convert, assemble and link the license file:
Step 0101 | Check license file
NATvrs.LICS . This job runs the
CHECK
function of the LICUTIL license utility (see below).
|
Step 0102 | Convert license file into an assembler source. This job runs the MAKE function of the LICUTIL license utility (see below). |
Step 0104 | Assemble and link the assembler source to generate
load module NATLIC . 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.
This step is only required if you want to install the zIIP Enabler for Natural.
Set the System Maintenance Aid (SMA) parameter
LICCHECK-NAZ
to Y
(Yes).
Check, convert, assemble and link the license file supplied for the zIIP Enabler for Natural:
Step 0111 | Check license file
NAZvrs.LICS . This job runs the
CHECK
function of the LICUTIL license utility.
|
Step 0112 | Convert license file into an assembler source. This job runs the MAKE function of the LICUTIL license utility. |
Step 0114 | Assemble and link the assembler source to generate
load module NAZLIC . This module is then
linked to the nucleus in Job I060.
|
(Job I009, Steps 1200, 1210, 1220, 1230, 1232, 1240, 1250)
If you want to use one of the Natural components listed in the table below, link the appropriate Natural module to an Authorized Program Facility (APF) library.
The table below indicates when a component is required and the System Maintenance Aid (SMA) parameters used to specify the module names.
Step/Component to be Installed | Module | SMA Parameter |
---|---|---|
Step 1200: Global Buffer Pool1
See also Step 4: Start the Global Buffer Pool. |
NATGBP82
|
NAT-GLOBAL-BP
or
|
Step 1210: Authorized Services Manager
(ASM)1
You must use an ASM in the following cases:
See also Step 20: Create and Start the Natural Authorized Services Manager. |
NATASM82 |
NAT-ASM |
Step 1220:
Natural Roll
Server1
You must use a Natural Roll Server in the following cases:
See also Step 18: Create and Format the Roll File and Step 19: Create and Start the Natural Roll Server. Depending on the setting of the SMA parameter
|
NATRSM82 or
NATRSM83 |
ROLLSRV ,
NATRSM83 |
Steps 1230 and 1232:
Optimize Monitor Buffer
Pool1
See also Step 21: Create and Start the Optimize Monitor Buffer Pool . |
NATO4I82 |
NAT-EOIMBP |
Step 1240: Message Buffer Pool 1 | NATMBP82 |
NAT-MTBP |
Step 1250:
Impersonation
with the Natural RPC (Remote Procedure
Call)2
We recommend that you link the RPC server front-end into an
APF-authorized See also Step 23: Create Sample JCL for the Natural RPC Server. |
RPC Server Front-End | NAT-RPC-FRONT |
1 described in the Operations documentation
2 described in the Natural RPC (Remote Procedure Call) documentation
(Job I015, Steps 0100, 0101, 0102, 0104)
These steps are only required if you want to use a global buffer pool. For further information on the global buffer pool, see Natural Global Buffer Pool in the Operations documentation.
Installation of the Natural Authorized Services Manager (ASM) is
mandatory if ALLOWUSERKEYCSA(NO)
applies by default or has
explicitly been specified in
SYS1.PARMLIB(DIAGxx)
. See also
Allocation of
the Natural GBP in the Operations
documentation.
Create the jobs required to start and stop a global buffer pool:
Step | Job | Function |
---|---|---|
0100 | GBNASTRT |
Start global buffer pool |
0101 | GBNASTOP |
Stop global buffer pool |
0102 | GBEDSTRT |
Start editor global buffer pool |
0104 | GBEDSTOP |
Stop editor global buffer pool |
If you want to use a Natural global buffer pool, start the job
GBNASTRT
before using Natural.
If you want to use an editor global buffer pool, start the job
GBEDSTRT
before using Natural.
(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 13: Build the Natural Parameter Module.
Load the FNAT
system file definition contained in the
NATvrs.SYSF
data
set 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
This avoids the Natural errors NAT9988 and NAT7397 after reorganizing the
FNAT
system file using the Adabas utility ADAULD or ADALOD.
(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 13: Build the Natural Parameter Module.
Load the FUSER
system file definition contained in the
NATvrs.SYSF
data
set 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.
(Job I050, Step 0102)
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.
Load the new Natural scratch-pad system file definition:
Set the System Maintenance Aid (SMA) parameter
NAT-SCRF
to Y
(Yes).
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 13: Build the Natural Parameter Module.
Load the scratch-pad system file definition contained in the
NATvrs.SYSF
data
set 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.
Load the new Natural FREG
system file definition:
Set the System Maintenance Aid (SMA) parameter
NAT-FREG
to Y
(Yes).
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 13: Build the Natural Parameter Module.
Load the FREG
system file definition contained in the
NATvrs.SYSF
data
set 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 13: Build the Natural Parameter Module.
Load the FDIC
system file definition contained in the
NATvrs.SYSF
data
set by using the Adabas ADALOD
utility.
The following ADALOD utility parameter must not be changed:
ISNREUSE=YES
(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, Step 0110)
This step is only required if you need to change the delivered
NATCONFG
module, for example, to adapt the
NTDVCE
macro definition to your requirements.
Change and assemble the source contained in the
hilev.NATvrs.SRCE
data set.
Link the resulting Natural configuration module NATCONFG
to the environment-independent nucleus (see
Step 14: Link the
Nucleus).
For more information on the configuration tables in
NATCONFG
, refer to Natural Configuration
Tables in the Operations
documentation.
(Job I055, Step 0120 or 0130)
Build the Natural-specific runtime options for the IBM Language Environment (LE).
Step 0120 is only required if you need to adapt the LE options at the
.MVSDEF
label in the delivered NATLEOPT
module to
your requirements.
Set the System Maintenance Aid (SMA) parameter NAT-LEOPT
to Y
(Yes); default is N
(No).
Change the required LE options in the NATLEOPT
source
module contained in the NATvrsSRCE
data set at the .MVSDEF
label.
Assemble and link the NATLEOPT
source module contained
in the NATvrsSRCE
data set.
Link the resulting NATLEOPT
module to the
environment-dependent nucleus (see Step 14: Link the
Nucleus).
Step 0130 is only required if you have any non-Natural programs running in 24-bit addressing mode:
Set the SMA parameter NAT-LEOPT-AMODE24
to
Y
(Yes); default is N
(No).
Assemble the NATLEOPT
module contained in the
NATvrsSRCE
data set.
Link the resulting NATLEOPT
module to the
environment-dependent nucleus (see Step 14: Link the
Nucleus).
(Job I060, Steps 0010, 0015)
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.
Configure the z/OS batch interface: Modify the settings of the
parameters supplied with the
NTOSP
macro to meet your requirements. For descriptions of these parameters, see the
corresponding dynamic profile parameter OSP
.
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
5, Step 6 and
Step
9, 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
8), 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
7), or the database ID and file number of your
existing Natural scratch-pad file.
If you want to use a Natural global buffer pool, perform the following steps:
Specify the NTBPI
macro (see the BPI
parameter):
NTBPI TYPE=NAT,NAME=gbp-name
where gbp-name
is the name of
the Natural global buffer pool to be used.
Supply the following parameter with the NTPRM
macro:
SUBSID=subsystem-name
where subsystem-name
is the
name of the Natural subsystem specified when creating the global buffer pool.
Make sure that the System
Maintenance Aid (SMA) parameter NAT-GLOBAL-BP
is set to Y
(Yes). This is the default setting.
For detailed information on the Natural global buffer pool, see Natural Global Buffer Pool under z/OS in the Operations documentation.
Assemble and link the Natural parameter module.
(Job I060, Steps 0020, 0105)
If you want Natural to run in the IBM Language Environment (LE), set
the System Maintenance Aid
(SMA) parameter NAT-LE
to Y
(Yes). The default setting is N
(No).
Link the environment-dependent nucleus (Step 0020) for batch Natural.
The list of modules to be linked for the environment-dependent nucleus is supplied with Step 0020.
Do not link the environment-dependent nucleus with the
linkage editor option RENT
.
Link the environment-independent nucleus (Step 0105).
The list of modules to be linked for the environment-independent nucleus is supplied with Step 0105.
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.
(Job I061, Step 0100)
Load the Natural objects and Natural error messages from the
NATvrs.INPL
data set 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 8300, 8302)
This step is optional and only required if you want to replace the English long message texts by their Japanese equivalents or if you want to load the Japanese short message texts. The Japanese message texts are contained in the Natural Japanese Language Pack (product code NCJ), a separate product that can be loaded optionally. If you do not load the Japanese message texts, the English message texts are used instead.
Replace the English long message texts (Step 8300) by loading the
Japanese long message texts from the
NCJvrs.INPL
data set into the Natural
system file with the Natural INPL
utility.
Load the Japanese (ULANG=59
) short message texts (Step 8302)
from the NCJvrs.ERRN
data set into the
Natural system file by using the ERRLODUS
program of the Natural
SYSERR utility (described in the Utilities
documentation).
For details on the ULANG
profile
parameter and
ERRLODUS
,
see the Parameter Reference and the
Utilities documentation, respectively.
(Job I061, Step 0103)
Load the Natural example objects from the
NATvrs.EXPL
data set into the Natural
system file by using the Natural INPL
utility.
(Job I200, Step 0101)
This step is only required if you want to use the Natural Roll Server. For information on the different types of roll files, see Roll File and LRB in the Operations documentation, and Natural under CICS and Natural under IMS TM in the TP Monitor Interfaces documentation.
If you use the roll file of a previous version, it is sufficient to
execute the NATRSRFI RESET
function. See
Formatting the
Roll File in the Operations
documentation.
If you use a new roll file, create and start the job
FORMRF1
(supplied with Step 0101) before using Natural.
(Job I200, Step 0102)
This step is only required if you want to use the Natural Roll Server described in Natural Roll Server Operation in the Operations documentation.
Create and start the job SAGRSM
(supplied with Step
0102) before using Natural. See
Starting
the Roll Server in the Operations
documentation.
Depending on the setting of the SMA parameter NATRSM83
,
either NATRSM82
(NATRSM83=NO
) or
NATRSM83
(NATRSM83=YES
) is used to start the Roll
Server.
(Job I200, Step 0103)
This step is only required if you want to use the Natural Authorized Services Manager (ASM) described in Authorized Services Manager under z/OS in the Operations documentation.
Create and start the job SAGASM
before using
Natural.
(Job I200, Step 0105)
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.
Create and start the job SAGEOI
(supplied with Step
0105) before using Natural. See
Starting
the Optimize Monitor Buffer Pool in the
Operations documentation.
(Job I200, Step 0107)
This step is only required if you want to use a message buffer pool described in Message Buffer Pool in the Operations documentation.
Create and start the job SAGMTBP
(supplied with Step
0107) before using Natural. See also
Operating the Message
Buffer Pool in the Operations
documentation.
(Job I200, Steps 0109, 0115, 0120)
These steps are only required if you want to use Natural RPC.
Sample Natural RPC server:
Set the parameters in the
System Maintenance Aid
(SMA) group RPC
accordingly; in particular, set the
parameter NAT-RPC
to Y
(Yes).
For further information, see Starting a Natural RPC Server and Starting a Batch Server in a Mainframe Environment in the Natural RPC (Remote Procedure Call) documentation.
Create the CMPRMIN
sample input to execute a Natural RPC
server in batch mode (Step 0109).
Create the sample JCL to execute a standard Natural RPC server task without RPC server front-end (Step 0115).
Create the sample JCL to execute a Natural RPC server task by the RPC server front-end (Step 0120). This JCL is necessary for impersonation.
This section provides instructions for verifying the successful installation of Natural.
You can use the following sample JCL to invoke Natural in batch mode and check whether the Natural system files are available:
//JOBNAME JOB (,,,999),CLASS=K,MSGCLASS=X,MSGLEVEL=(1,1) //* //NATBAT EXEC PGM=NATvrsBA,COND=(0,LT) //STEPLIB DD DSN=NATURAL.BATCH.LIBRARY,DISP=SHR // DD DSN=ADAvrs.LOAD,DISP=SHR //DDCARD DD * ADARUN DB=001,DE=3390,SVC=249,MODE=MULTI //CMPRINT DD SYSOUT=X //CMPRT01 DD SYSOUT=X //CMWKF01 DD DUMMY //SYSOUT DD DUMMY //CMSYNIN * EDIT WRITE 'TESTBAT' END .E RUN SAVE TESTBAT FIN //
This job starts Natural, creates the example program
TESTBAT
, and executes the program with the system command
RUN
.
You can use the following verification procedure to test Natural system functions in online mode and check whether the Natural system files are available.
Log on to the Natural user library SYSTEM
:
LOGON SYSTEM
Enter the following Natural system command:
MAINMENU
Select
and enter the following:
C
in the Code field,
P
in the Type field, and
TEST
in the Name field.
In the editing area of the program editor, type the following:
WRITE 'HELLO' END
Save the source code and exit the program editor.
In the
menu, enter the following:
L
in the Code field and
TES*
in the Name field.
On the LIST Objects in a Library screen, enter the
RU
line command for the TEST
program.
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.
You can check whether the DDMs EMPLOYEES
and
VEHICLES
are now available in your environment by logging on to
the Natural system library SYSEXSYN
and executing the example
programs (for example, AEDEX1R
) with the system command
RUN
.