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

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

    Wichtig:
    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.

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.

Beginn der AnweisungslisteTo 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.

    Oder:
    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.

    Oder:
    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.