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) and Natural for Com-plete for zIIP (product code NAZCO).
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 on z/OS.
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 on z/OS.
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 on
z/OS.
For NCFvrs.LICS, see Build the Natural Parameter Module
in Installing Natural Com-plete/SMARTS Interface on
z/OS.
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 on
z/OS.
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 on z/OS.
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.