Installing Natural for zIIP on z/OS

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

Related Topics:

For information on zIIP usage with Natural, see the Natural for zIIP 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 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.

Installation Procedure

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.

Step 1: Install Natural for ZIIP License Files

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:

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.

Step 2: Link and Start ASM

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.

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

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

Step 3: Set the ZIIP Profile Parameter

ZIIP and NTZIIP are described in the Parameter Reference documentation.

Step 4: Link the Environment-Dependent Nucleus

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.

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.

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