Installing Natural Messaging on z/OS

#### Search Results

Search

# Installing Natural Messaging on z/OS

This document describes the steps for installing Natural Messaging (product code NMQ) on z/OS.

- Installation Medium

- Installation Procedure

#### Related Topic:

For information on the features and functions provided by Natural Messaging, see Natural Messaging in the Database Management System Interfaces documentation.

#### Notation vrs or vr:

When used in this document, the notation `vrs` or `vr` represents the relevant product version (see also Version in the Glossary).

## Installation Medium

The installation medium contains the following data sets required for product installation:

Data Set Name | Contents
--- | ---
`NMQvrs.LICS` | Load modules for the z/OS license check software containing the LICUTIL license utility The placeholder `vrs` in the library name represents the version of the license check software, which is not necessarily the same as the version of Natural. For detailed information on the license check software and the LICUTIL utility, see Mainframe Product Licensing.
`NMQvrs.LOAD` | Load modules
`NMQvrs.INPL` | DDMs for Natural Messaging and examples

Copy the data sets into your environment as described in Copying Data Sets to a z/OS Disk in the section Installing Natural.

## Installation Procedure

Be sure to read Installation Process and Major Natural Features before you start the installation procedure.

- Step 1: Prepare, Convert, Assemble and Link the License File

- Step 2: Build the Natural Parameter Module with a Database Assignment for Natural Messaging

- Step 3: Link the Nucleus

- Step 4: Load the DDMs and the Natural Example Objects

### Step 1: Prepare, Convert, Assemble and Link the License File

(Job I007, Steps 3401, 3402, 3404)

In addition to the Natural product license file, a valid Natural Messaging license file is required and must be installed for each environment in which Natural Messaging (NMQ) runs. For license file `NMQvrs.LICS`, see Mainframe Product Licensing.

1. Copy the license file from the installation medium to disk or transfer it from the PC as described in Transferring a License File from PC to a z/OS Host Using FTP in Mainframe Product Licensing.

2. Check, convert, assemble, and link the license file:

   Step 3401 | Check the license file `NMQvrs.LICS`. This job executes the CHECK function of the LICUTIL license utility.
   Step 3402 | Convert the license file into an assembler source. This job executes the MAKE function of the LICUTIL license utility.
   Step 3404 | Assemble and link the assembler source to generate load module `NMQLIC`. This module is then linked to the nucleus (see below).

   The functions and option settings provided by LICUTIL are described in Using the License Utility: LICUTIL in Mainframe Product Licensing.

| Warning: Natural Messaging is not enabled unless you install a valid Natural Messaging license file. Trying to activate Natural Messaging without a valid license file results in warnings or errors at session start.

### Step 2: Build the Natural Parameter Module with a Database Assignment for Natural Messaging

(Job I060, Steps 0010, 0015 for batch)

(Job I080, Steps 2210, 2220 for CICS)

(Job I080, Steps 2300, 2310 for Com-plete)

(Job I080, Steps 0010, 0015 for TSO)

Build the Natural parameter module:

1. Modify the appropriate jobs according to the batch modules or TP monitor you are relinking: Job I060 for batch, Job I080 for CICS and Com-plete.

   Add the following macro call to your Natural parameter module:

       NTDB MQ, my-dbid

2. Assemble and link the Natural parameter module.

### Step 3: Link the Nucleus

(Job I060, Step 0105)

(Job I060, Step 0020 for batch)

(Job I080, Steps 2230 for CICS)

(Job I080, Steps 2320 for Com-plete)

(Job I080, Steps 0020 for TSO)

- Modify the JCL used to link your environment-independent nucleus by adding the following `INCLUDE` statement:

      INCLUDE NMQLIB(NQMNUC)

- Modify the JCL used to link your environment-dependent nucleus for the Natural CICS Interface by adding the following `INCLUDE` statements:

      INCLUDE NMQLIB(NMQTAB)
      INCLUDE MQLIB(CSQCSTUB)

  `CSQCSTUB` is the IBM MQ stub for CICS provided in the IBM MQ library.

- Modify the JCL used to link your environment-dependent nucleus for all other environments besides CICS by adding the following `INCLUDE` statements:

      INCLUDE NMQLIB(NMQTAB)
      INCLUDE MQLIB(CSQBSTUB)

  `CSQBSTUB` is the IBM MQ stub for batch and TSO provided in the IBM MQ library. This is also applicable for Natural under Com-plete.

### Step 4: Load the DDMs and the Natural Example Objects

(Job I061, Step 3410)

Load the DDMs and Natural example objects specific to Natural Messaging from the `NMQvrs.INPL` data set into the Natural system file by using the Natural INPL utility.

### On this page

- Installation Medium
- Installation Procedure