This document describes the steps for installing Natural Advanced Facilities under CICS on z/VSE.
Supported versions of the following products must be installed before you can install Natural Advanced Facilities:
Natural for VSAM if a VSAM file is to be used as a spool file
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 |
|---|---|
NAFvrs.SYSF |
Natural FSPOOL system file
definition
|
NAFvrs.LIBJ |
Sample installation jobs |
NAFvrs.LIBR |
Source modules, macros, phases and object modules |
NAFvrs.INPL |
Natural objects |
NAFvrs.ERRN |
Natural error messages |
Copy the data sets into your environment as described in Copying Data Sets to a z/VSE Disk in the section Installing Natural.
Be sure to read Installation Process and Major Natural Features before you start the installation procedure.
Step 9: Create a Separate Thread Group for Printer Transaction
Step 10: Define Natural Advanced Facilities for Natural Security
Step 14: Define Natural Advanced Facilities for VTAM/non-SNA
(Job I005)
This step only applies when using VSAM system files.
Define the CICS RDO definitions for the sample VSAM files:
Add the Natural Advanced Facilities spool files (SPOOL,
SPOOLA, SPOOLB, SPOOLC,
SPOOLD and SPOOLE) to your FCT.
For performance reasons, we strongly recommend you to specify a transaction ID for the spool server, which is different from that of the terminal task. It is then possible to dedicate special threads to the spool server.
If you want to convert an existing VSAM spool file, the FCT must contain the entries for this spool file. The cluster names of the new and the old versions must be different. The VSAM database ID and file number as well as the VSAM DD names must be unique.
(Job I008, Steps 0300 - 0311)
This step only applies when using VSAM system files.
Define and initialize a VSAM cluster to be used as the spool file
(FSPOOL) and five alternate indices.
(Job I050, Step 0300)
This step only applies when using Adabas system files.
Skip this step if you want to use an existing spool file of Natural Advanced Facilities.
Load the new Natural FSPOOL system file definition
contained in the NAFvrs.SYSF data set
by using the Adabas ADALOD utility.
(Job I055, Step 0305)
The use of the NAFPARMC parameter module is optional.
Alternatively, you can set the server options with
Function
30 (see the Natural Advanced Facilities
documentation) of the SYSPOOL application.
Modify, assemble and link the NAFPARMC module.
(Jobs I060, I080)
Modify the parameters FSPOOL,
NTPRINT, NAFUPF and
NAFSIZE in the Natural parameter module according to
your site requirements. For more information on these parameters, see
NATSPOOL
Initialization in the Natural Advanced
Facilities documentation.
Assemble and link the Natural parameter module.
The following additional step applies when using VSAM system files:
Set the FSPOOL parameter as follows:
FSPOOL=(vsam-dbid,fnr-fspool,dd-name-fspool)
where:
vsam-dbid is the
database ID of the VSAM file to be used as the spool file,
fnr-fspool is the file
number of the VSAM file to be used as the spool file,
dd-name-fspool is
limited to seven characters.
(Jobs I060, I080)
Add the following INCLUDE statements to the link steps
for Natural and link-edit the executable module:
INCLUDE NAFAF |
INCLUDE NAFNUC |
INCLUDE NAFPARMC (optional) |
The link-edit of the object module containing Natural Advanced Facilities can be done in any of the following ways:
Include all modules of Natural Advanced Facilities, that is,
NAFNUC, NAFAF and, optionally, NAFPARMC
in the link-edit of Natural.
Note:
If a shared nucleus is created, the modules can be included in the
shared nucleus.
Link-edit NAFNUC, NAFAF and, optionally,
NAFPARMC and an alternative Natural parameter module as a separate
module with the mandatory name CMPRMTB specified in the
ENTRY statement. The name of the resulting module is optional.
Note:
This way of link-editing only applies if an alternate parameter
module (PARM=parameter) is used. If so,
an additional CICS PPT entry with
PROGRAM=name is required.
Link-edit NAFNUC, NAFAF and, optionally,
NAFPARMC as a separate module with the mandatory name
NATAM08 specified in the ENTRY statement. The name of
the resulting module is optional. If it is different from NATAM08,
however, it must be specified as an alias name in the
NTALIAS macro of the Natural parameter module.
Note:
This way of link-editing only applies if the
CSTATIC
and RCA
profile parameters (see the Parameter Reference
documentation) are used. If so, an additional CICS PPT entry with
PROGRAM=name is required.
The following additional step applies when using VSAM system files.
Add the following INCLUDE statement to all links of the
nucleus:
INCLUDE NVSFSPO
(Job I061, Step 0300)
Load the Natural objects specific to Natural Advanced Facilities from the
NAFvrs.INPL data set into the Natural
system files SYSPOOL and SYSPRINT by using the
Natural INPL
utility.
Ensure that the INPL load function finishes with the message:
Natural Advanced Facilities initialized by INPL
If this initialization fails, various problems will be encountered at execution time.
The maps contained on the data set are provided in source form so that you can modify them according to your requirements (for example, translate the maps from English into another language). If you modify these maps, 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 Natural error messages specific to Natural Advanced
Facilities from the NAFvrs.ERRN
data set into the Natural FDIC system file by using the
ERRLODUS
program of the Natural SYSERR utility (described in the
Utilities documentation).
(Job I070, Steps 2245, 2250, and Job I080)
We recommend that you establish a separate thread group for the Natural Advanced Facilities printer transaction. To do so, perform these steps:
Modify the Natural CICS Interface system directory (Step 2245):
Include a definition of the Natural Advanced Facilities printer thread group into the Natural CICS Interface system directory.
Relink the modified Natural CICS Interface system directory (Step 2250).
Repeat linking of the Natural CICS Interface system directory.
See also Build the Natural CICS Interface System Directory Module of the Installation Procedure for the Natural CICS Interface.
This step must be performed only if Natural Advanced Facilities is being installed in a Natural Security environment.
Define SYSPOOL to Natural Security with the startup
program MENU.
Note:
The physical CICS printers and the application
SYSPRINT need not be defined to Natural Security. The Natural
Security logon processing will identify the NATSPOOL spool server
and perform a simplified logon to SYSPRINT, that is, without any
further security checks. In this way, maintenance efforts and the number of
Adabas calls at the start of the spool server are considerably reduced. Any
logon to SYSPRINT attempted by users other than the
NATSPOOL spool server will be rejected by Natural Security,
regardless of whether SYSPRINT is defined to it or not.
Start Natural and add the user profile, as defined in the
NAFUPF parameter of the Natural parameter module, to the
SYSPOOL file by using
Function
31.1 (described in the Natural Advanced
Facilities documentation).
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.
Initialize a new NATSPOOL environment as described in
NATSPOOL
Initialization in the Natural Advanced
Facilities documentation.
This step must be performed only if Natural Advanced Facilities is to be used in conjunction with VTAM/SNA printers.
Define devices in the TCT with a RELREQ
setting of (YES,YES). (This will ensure that VTAM printers are
released at the end of printout time when devices are shared with TSO, BATCH,
JES, etc.)
Define TRMSTAT=INTLOG or CREATESESS=YES for
the printer to allow EXEC CICS START requests to create a
session.
Ensure that the devices have the SHARE option generated
into the controller VTAM specifications.
This step must be performed only if Natural Advanced Facilities is to be used in conjunction with VTAM/non-SNA printers.
Include TRMSTAT=TRANSCEIVE in the TCT definition for the
device.
Set the VTAM definition for the device parameter
ISTATUS to ACTIVE.