This document provides information on installing the zIIP Enabler for Natural (product code NAZ) on z/OS.
For information on zIIP usage with Natural, see the zIIP Enabler for Natural 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.
The Natural session runs in a CICS environment if Natural CICS Version 8.3. is installed.
The Natural session runs in a Com-plete environment if Natural Com-plete Version 8.3. is installed.
A valid license file for the zIIP Enabler for Natural is available in addition to the Natural product license file.
A separate NAZvrs.LICS license
file is required for each environment in which zIIP Enabler for Natural runs,
batch/TSO, CICS or Com-plete. It is not possible to link two ore more license
files together, for example, one CICS license together with one for batch,
because they have the same CSECT name NAZLIC.
Important:
In order to install zIIP Enabler for Natural with Natural CICS
Version 8.3. or Natural Com-plete Version 8.3., you need to apply the
load fix
required for the license utility described in the current Natural
Release Notes.
Under CICS, the Natural environment-dependent nucleus must be defined to run in a CICS OTE (open transaction environment) as described in Environment-Dependent Nucleus in the section Installing Natural CICS Interface.
See also General Prerequisites and System Support in the section Overview of the Installation Process.
The steps required to install the zIIP Enabler for Natural are performed during the installation for base Natural described in Installing Natural on z/OS. These steps are referenced in the following section:
Install a valid NAZvrs.LICS
license file: see Step 3 of Prepare, Convert, Assemble and Link
the License File.
zIIP support will not be enabled if the license file check for the
zIIP Enabler for Natural fails. Appropriate warning messages will then be
displayed on the operator console and in the job log. You can run the job again
and use the ZIIP system command (described in the
System Commands documentation) to display the license file
for the zIIP Enabler for Natural and find out the reason for this failure.
You can skip the following and go to Step 3 if you have already installed and activated a Natural Authorized Services Manager (ASM) in your environment.
Link the ASM module: see Link Natural Modules to an APF Library.
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 the zIIP
Enabler for Natural. 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. See the Parameter Reference
documentation for details.
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.