Installing Natural zIIP Enabler on z/OS

This document provides information on installing Natural zIIP Enabler (product code NAZ) on z/OS.

Related Topics:

For information on zIIP usage with Natural, see the Natural zIIP Enabler documentation.

Prerequisites

  • 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 Natural zIIP Enabler is available in addition to the Natural product license file.

    A separate license file is required for each environment in which Natural zIIP Enabler runs:

    NAZvrs.LICS for batch/TSO,
    NCIvrs.LICS for CICS, and
    NCFvrs.LICS for Com-plete.

    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.

  • 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.

Installation Procedure

The steps required to install Natural zIIP Enabler are performed during the installation for base Natural described in Installing Natural on z/OS. These steps are referenced in the following section:

  1. Install a valid license file:

    For NAZvrs.LICS, see Step 2: Prepare, Convert, Assemble and Link the License File in Installing Natural on z/OS,

    For NCIvrs.LICS, see Step 2: Prepare, Convert, Assemble and Link the License File for Natural zIIP Enabler for CICS in Installing Natural CICS Interface on z/OS, and

    For NCFvrs.LICS, see Step 1: Prepare, Convert, Assemble and Link the License File for Natural zIIP Enabler for Com-plete in Installing Natural Com-plete/SMARTS Interface on z/OS.

    zIIP support will not be enabled if the license file check for Natural zIIP Enabler 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 Natural zIIP Enabler and find out the reason for this failure.

  2. 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 Natural zIIP Enabler. 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).

  3. Set the Natural profile parameter ZIIP to AUTO (default) or ON or use the corresponding macro NTZIIP. See the Parameter Reference documentation for details.

Installation Verification

After the last step of the installation procedure has been completed, you can run a Natural session and check whether zIIP support is active.

Start of instruction setTo 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.