Installing zIIP Enabler for Natural on z/OS

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

Related Topics:

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

Prerequisites

  • The z/OS operating system hosting the Natural environment executes on an IBM System z Integrated Information Processor (zIIP).

  • A valid license file for the zIIP Enabler for Natural is available in addition to the Natural product license file.

  • The Natural session runs in a z/OS batch, batch server or TSO environment.

See also General Prerequisites and System Support in the section Overview of the Installation Process.

Installation Procedure

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:

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

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

  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.