This document provides information on installing the following Natural for zIIP products on z/OS: Natural Batch for zIIP (product code NAZBT), Natural for CICS for zIIP (product code NAZCI), Natural for Com-plete for zIIP (product code NAZCO) and Natural for IMS for zIIP (product code NAZNI).
For information on zIIP usage with Natural, see the Natural for zIIP documentation.
The z/OS operating system hosting the Natural environment executes on an IBM System z Integrated Information Processor (zIIP).
The Natural session runs in a z/OS batch, batch server or TSO environment in which Natural Batch for zIIP is installed.
The Natural session runs in a CICS environment in which Natural CICS Interface and Natural for CICS for zIIP are installed.
The Natural session runs in a Com-plete environment in which Natural Com-plete/SMARTS Interface and Natural for Com-plete for zIIP are installed.
The Natural session runs in an IMS TM environment in which Natural IMS TM Interface and Natural for IMS for zIIP are installed.
In addition to the Natural product license file, a license file is required for each environment in which Natural for zIIP runs.
See also General Prerequisites and System Support in the section Overview of the Installation Process.
The steps required to install Natural for zIIP are performed during the installation for base Natural described in Installing Natural on z/OS. These steps are summarized in the following section.
In addition to the Natural product license file, a license file is required and must be installed for each environment in which Natural for zIIP runs:
For Natural Batch for zIIP:
NAZvrs.LICS; see
Prepare, Convert,
Assemble and Link the License File in Installing
Natural.
For Natural for CICS for zIIP:
NCIvrs.LICS; see
Prepare, Convert,
Assemble and Link the License File for Natural for CICS for
zIIP in Installing Natural CICS
Interface.
Natural for Com-plete for zIIP:
NCFvrs.LICS; see
Prepare, Convert,
Assemble and Link the License File for Natural for Com-plete for
zIIP in Installing Natural Com-plete/SMARTS
Interface.
Natural for IMS for zIIP:
NIIvrs.LICS; see
Prepare, Convert,
Assemble and Link the License File for Natural for Com-plete for
zIIP in Installing Natural IMS TM
Interface.
zIIP support will not be enabled if a Natural for zIIP license file check fails. Appropriate warning messages will then be displayed on the operator console and in the job log.
If you have already installed and activated a Natural Authorized Services Manager (ASM) in your environment, you can skip the following and go to Set the ZIIP Profile Parameter.
Link the ASM module: see Link Natural Modules to an APF Library in Installing Natural.
The ASM must be of the same Natural version that provides zIIP support.
Start the ASM: Create and Start the Natural Authorized Services Manager.
The subsystem ID is the only parameter the ASM requires for Natural
for zIIP. Each Natural session must run with the same subsystem ID as the ASM.
Otherwise, Natural will issue an appropriate error message. The subsystem ID is
defined with the Natural profile parameter SUBSID (see the
Natural Parameter documentation).
Set the Natural profile parameter ZIIP to
AUTO (default) or ON or use the corresponding macro
NTZIIP:
For NAZvrs.LICS, see
Build the Natural Parameter
Module in Installing Natural;
For NCIvrs.LICS, see
Build the Natural
Parameter Module in Installing Natural CICS
Interface;
For NCFvrs.LICS, see
Build the Natural Parameter
Module in Installing Natural Com-plete/SMARTS
Interface;
For NIIvrs.LICS, see
Build the Natural
Parameter Module in Installing Natural IMS TM
Interface;
ZIIP and
NTZIIP
are described in the Parameter Reference
documentation.
The license files must be linked to the environment-dependent nucleus.
It is not possible to link two or more license files together to the
environment-independent nucleus, for example, one CICS license together with
one for batch, because they have the same CSECT name NAZLIC.
Link the environment-dependent nucleus with the appropriate license file generated in Install Natural for zIIP License Files:
For NAZvrs.LICS, see
Link the
Nucleus in Installing Natural;
For NCIvrs.LICS, see
Link the
Environment-Dependent Nucleus in Installing
Natural CICS Interface;
Under CICS, the Natural environment-dependent nucleus must be defined to run in the CICS open transaction environment (OTE) as described in Environment-Dependent Nucleus in Installing Natural CICS Interface.
For NCFvrs.LICS, see
Link the
Nucleus in Installing Natural Com-plete/SMARTS
Interface.
For NIIvrs.LICS, see the link
steps for different front-ends described in Installing Natural IMS TM
Interface.
After the last step of the installation procedure has been completed, you can run a Natural session and check whether zIIP support is active.
To find out whether zIIP
support has been enabled
Check whether the following message is shown on the operator console or in the job log:
NAT7070 Advanced zIIP support enabled successfully.No zIIP-specific message is displayed if your Natural session runs without zIIP enablement.
Or:
Issue the Natural system command ZIIP in batch or online mode.
If zIIP support is active, a zIIP Processing Information report is displayed indicating that zIIP support has been enabled. See the System Commands documentation for details.
If zIIP support is not active, a corresponding message appears.
Or:
For batch processing, set the Natural profile parameter
ZIIP=(PRINT=INFO)
or use the corresponding macro NTZIIP macro. See the
Parameter Reference documentation for details.
If zIIP support is active, the zIIP Processing Information report (see above) is shown.
If zIIP support is not active, a corresponding message appears.
To check whether the correct license file is installed
Issue the Natural system command
ZIIP
LIC.
A zIIP License Information screen appears listing details about the Natural for zIIP product license installed in your current environment.