Installing Natural for zIIP on z/OS

#### Search Results

Search

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

- Prerequisites

- Installation Procedure

- Installation Verification

#### 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

- Step 2: Link and Start ASM

- Step 3: Set the ZIIP Profile Parameter

- Step 4: Link the Environment-Dependent Nucleus

### 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:

- For Natural Batch for zIIP: `NAZvrs.LICS`, see Prepare, Convert, Assemble and Link the License File in Installing Natural.

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

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

- Natural for IMS for zIIP: `NIIvrs.LICS`, see Prepare, Convert, Assemble and Link the License File for Natural for Com-plete for zIIP in Installing Natural IMS TM Interface.

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

- Set the Natural profile parameter `ZIIP` to `AUTO` (default) or `ON` or use the corresponding macro `NTZIIP`:

  For `NAZvrs.LICS`, see Build the Natural Parameter Module in Installing Natural.

  For `NCIvrs.LICS`, see Build the Natural Parameter Module in Installing Natural CICS Interface on z/OS.

  For `NCFvrs.LICS`, see Build the Natural Parameter Module in Installing Natural Com-plete/SMARTS Interface on z/OS.

  For `NIIvrs.LICS`, see Build the Natural Parameter Module in Installing Natural IMS TM Interface.

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

- Link the environment-dependent nucleus with the appropriate license file generated in Install Natural for ZIIP License Files:

  For `NAZvrs.LICS`, see Link the Nucleus in Installing Natural.

  For `NCIvrs.LICS`, see Link the Environment-Dependent Nucleus in Installing Natural CICS Interface on z/OS.

  Under CICS, the Natural environment-dependent nucleus must be defined to run in the CICS open transaction environment (OTE) as described in Environment-Dependent Nucleus in Installing Natural CICS Interface.

  For `NCFvrs.LICS`, see Link the Nucleus in Installing Natural Com-plete/SMARTS Interface on z/OS.

  For `NIIvrs.LICS`, see the link steps for different front-ends described in Installing Natural IMS TM Interface.

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

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.

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

### On this page

- Prerequisites
- Installation Procedure
- Installation Verification