This document describes the steps for installing Natural Com-plete/SMARTS Interface which corresponds to the Natural Com-plete Interface (product code NCF) on z/OS.
For information on how to operate Natural in a Com-plete/SMARTS environment, see the following topics:
Using Natural with TP Monitors in the TP Monitor Interfaces documentation.
Natural under Com-plete/SMARTS in the TP Monitor Interfaces documentation.
Natural under Com-plete/SMARTS User Abend Codes in the Messages and Codes documentation.
For information on installing and using Com-plete, see the Com-plete documentation.
When used in this document, the notation
vrs or
vr represents the relevant product
version (see also Version in the
Glossary).
A supported version of the following product must be installed before you can install the Natural Com-plete/SMARTS Interface:
Com-plete
See the Com-plete Installation documentation.
See also General Prerequisites and System Support in the section Overview of the Installation Process.
The installation medium contains the following data sets required for product installation:
| Data Set Name | Contents |
|---|---|
NCFvrs.LOAD |
Load modules |
NCFvrs.SRCE |
Source modules and macros |
NCFvrs.LICS |
Product license file for Natural for Com-plete for zIIP
For information on the license file and product licensing, see Software AG Mainframe Product Licensing. |
Copy the data sets into your environment as described in Copying Data Sets to a z/OS Disk in the section Installing Natural.
Sample installation jobs are contained in the NATvrs.JOBS data set
and are prefixed with the product code. The data set is provided on the
installation medium supplied for base Natural.
Be sure to read Installation Process and Major Natural Features before you start the installation procedure.
Step 1: Prepare, Convert, Assemble and Link the License File for Natural for Com-plete for zIIP
Step 6: Define the Natural Com-plete/SMARTS Interface Server
(Job I007, Steps 2301, 2302, 2304)
This step is optional and only required if you want to install Natural for Com-plete for zIIP.
You must install a valid Natural license file. An additional license file is required if you want to install Natural for Com-plete for zIIP 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.
Check, convert, assemble and link the license file supplied for Natural for Com-plete for zIIP:
| Step 2301 | Check license file
NCFvrs.LICS. This job runs the
CHECK
function of the LICUTIL license utility (see below).
|
| Step 2302 | Convert license file into an assembler source. This job runs the MAKE function of the LICUTIL license utility (see below). |
| Step 2304 | Assemble and link the assembler
source to generate load module NCFLIC. This module is then linked
to the nucleus in Job
I080.
|
The functions and option settings provided by LICUTIL are described in Using the License Utility: LICUTIL in Software AG Mainframe Product Licensing.
(Job I070, Steps 2320, 2321)
This step is optional.
You can use a Natural Com-plete/SMARTS Interface startup program to pass dynamic parameters to Natural.
Adapt the example program NCO001 contained in the
source library to your requirements.
Assemble and link the startup program into your Com-plete user program library.
(Job I080, Steps 2300, 2310)
The Natural profile parameters and parameter macros mentioned in this section are described in the Parameter Reference documentation unless otherwise noted.
Modify the Natural parameter module for Com-plete/SMARTS:
Configure the Com-plete/SMARTS batch interface: Modify the
settings of the parameters supplied with the macro
NTCOMP
to meet your requirements. For descriptions of these parameters, see the
corresponding profile parameter COMP.
Modify the following parameters:
FNAT=(database-id,file-number) FUSER=(database-id,file-number)
where database-id
and file-number are the values you
specified when loading the system files during the
Installation
Procedure for base Natural.
Define a Natural local buffer pool under Com-plete by
modifying the values of the keyword parameters supplied with the parameter
macro NTBPI
(see the Natural profile parameter BPI) as required.
A local buffer pool is allocated during initialization of the first Natural session after Com-plete startup.
The status of the local buffer pools can be displayed on the operator console by issuing the following Com-plete operator command:
SERV,server-name,BPSTAT
where server-name is
the name of the server as specified with the Com-plete SERVER startup option.
If you want to use a Natural global buffer pool under
Com-plete, specify the same values as in the Natural installation procedure for
the profile parameter SUBSID in the
parameter macro NTPRM
(see the Operations documentation) for the keyword
subparameter NAME in the
parameter macro NTBPI
(see the Parameter Reference documentation).
Assemble and link the Natural parameter module.
(Job I080, Step 2320)
Link the environment-dependent nucleus for the Natural Com-plete/SMARTS Interface.
Link the environment-dependent nucleus into your Com-plete user program library.
The list of the modules to be linked for the environment-dependent nucleus is supplied with Step 2320.
If you want Natural to run in the IBM Language Environment
(LE), set the System Maintenance
Aid (SMA) NAT-LE to Y (Yes). The
default setting is N (No).
Specify the environment-dependent nucleus as a Com-plete startup option by setting the following Com-plete keyword parameter:
RESIDENTPAGE=name
where name is the name
of the environment-dependent nucleus for the Natural Com-plete/SMARTS
Interface.
(Job I080, Step 2350)
Link the Natural Com-plete/SMARTS Interface server.
The Natural Com-plete/SMARTS Interface server is used to maintain common storage and tables across Natural sessions, for example, the local buffer pool.
Specify the Natural Com-plete/SMARTS Interface server as a Com-plete startup option by setting the following Com-plete keyword parameter:
SERVER=(server-name,module-name)
where:
server-name is the
name of the server as specified with the keyword subparameter
SERVER in
the parameter macro NTCOMP
(see the Parameter Reference documentation).
module-name is the
name of the load module linked in
Step 4: Link the
Natural Com-plete/SMARTS Interface Server.
The Natural Com-plete/SMARTS Interface server module is loaded
during Com-plete initialization. The module must therefore be placed in a load
library contained in the COMPINIT load library concatenation (see
also the Com-plete Installation documentation).
This step is required if either of the following is true:
You run Natural under Com-plete/SMARTS
and use threads below the line (THABOVE=NO setting
in the NTCOMP
macro).
|
|
| Or: | |
| You want to use Natural work pools below the 16-MB line. |
Catalog the Natural Com-plete/SMARTS Interface by using the Com-plete ULIB utility.
For threads below the line:
The region size to be specified with the ULIB utility
parameter RG depends on the setting of the keyword
subparameter NTHSIZE
in the parameter macro
NTCOMP
described in the Parameter Reference documentation.
For work pools below the 16-MB line:
The region size to be specified with the ULIB utility
parameter RG depends on the setting of the Natural
profile parameter WPSIZE (see the
Parameter Reference documentation) for the parameter macro
NTPRM (see
the Operations documentation).
See also Storage Usage in the section Natural under Com-plete/SMARTS in the TP Monitor Interfaces documentation.
After installation, you can use the Natural SYSTP utility (see the Utilities documentation) to determine the region size actually used.
You can verify the successful installation of the Natural Com-plete/SMARTS Interface by performing the following steps:
Stop and restart Com-plete.
Enter the Com-plete user menu and type in the name of the environment-dependent nucleus for the Natural Com-plete/SMARTS Interface.
The Natural initial screen should appear.
Proceed with the steps described in the section Test Online Natural.