Installing the Natural Web I/O Interface Server IMS Adapter

#### Search Results

Search

# Installing the Natural Web I/O Interface Server IMS Adapter

This document describes how to install the IMS TM connection for a Natural Web I/O Interface server (abbreviated: "NWO server") running under z/OS in batch mode.

The following topics are covered:

- Prerequisites

- Example Jobs

- Installation Procedure

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

## Prerequisites

For details, refer to the section Prerequisites.

## Example Jobs

The example installation jobs are contained in the `NWOvrs.JOBS` data set and are prefixed with the product code. The data set is provided on the installation medium for Natural Web I/O Interface.

## Installation Procedure

Perform the following steps:

### Step 1: Customize the IMS Listener

See z/OS Communications Server IP IMS Socket Guide for the description of

- how to set up and operate the IMS Listener,

- how to use the IMS TCP/IP control statements.

Note
The port number of the IMS Listener is to be used later on in the NWO configuration parameter `RFE_IMS_TA_PORT`.

### Step 2: Install the Server Transaction

It is assumed that the Natural IMS TM Interface is already installed. Thus, this step describes the additional steps which are necessary to create the Natural Web I/O Interface server environment.

### Step 2.1: Adapt the Transaction Code Table

(Job I055, Steps 2555, 2556)

- In the `NTIMSPT` macro of the Natural parameter module, add the following entry:

               NTIMSPT TRAN=NATvrsAD,TYPE=SFE,                               X
                     ENVPID=ENVNWO00,                                        X
                     PSB=NIIvrsAD

- Assemble and link the parameter module.

### Step 2.2: Adapt the Environment Parameters

(Job I055, Steps 2580, 2581)

- In the `NTIMSPE` macro of the Natural parameter module, add a new entry:

               NTIMSPE ENTRYNM=ENVNWO00,                                     X
                     THBELOW=OFF,                                            X
                     THSIZE=1536000     (1500K)

- Assemble and link the parameter module.

### Step 2.3: Relink the Natural IMS TM Interface Module

(Job I055, Step 2582)

Relink the Natural IMS TM interface module `NIIvrsIF`.

### Step 2.4: Natural IMS TM Parameter Module

(Job I080, Steps 2500, 2510)

- Build the Natural IMS TM parameter module.

- Assemble and link the Natural IMS TM parameter module.

### Step 2.5: Link the Server Front-End

(Job I080, Step 2586)

Link the server front-end.

Ensure that the name of the server front-end matches the value specified with the `PSB` keyword subparameter of the `NTIMSPT` macro in installation step 2.1 above.

### Step 3: Customize IMS TM

- Define the PSB for the server transaction.

  As a minimum requirement you need a TP PCB.

  Define the application of the server transaction in the stage1 input. The transaction is a single mode, single segment non-conversational transaction.

  Example:

               APPLCTN PSB=NIIvrsAD,PGMTYPE=TP,SCHDTYP=PARALLEL
                 TRANSACT CODE=NATvrsAD,MODE=SNGL,                           X
                     MSGTYPE=(SNGLSEG,NONRESPONSE,4)

- Adapt the MPP region.

  In the JCL of the MPP region, add the `SYSTPCD` DD statement.

  See z/OS Communications Server IP IMS Socket Guide for the description on how to configure TCPIP.DATA.

- Concatenate the data set containing the NWO load library to the `STEPLIB` DD statement.

Before starting the Natural Web I/O Interface Server IMS Adapter installation, set the SMA parameter `NWO-SRV-IMS` to `Y` (yes).

To install the Natural Web I/O Interface Server IMS Adapter, perform the following steps:

### Step 4: Create Member for NWO Server

(Job I009, Step 9412)

Create member `NWOCONFI` for the NWO server.

### Step 5: Link the Object Modules into the NWO Load Library

(Job I054, Step 9440)

Notes:

1. The module `NATINRFE` applies to two different products: the Natural Development Server (NDV) and the Natural Web I/O Interface (NWO server). So if you have already installed NDV, the module `NATINRFE` might already be there. However, it does not matter if you reinstall `NATINRFE` with NWO because the resulting module from either installation is the same.
2. The module `NATISRFE` (referenced in config via `FRONTEND_NAME=NATISRFE`) has already been linked in the prior steps of batch installation.

### Step 6: Create Startup Procedure

(Job I200, Step 9417)

Create the startup procedure for the NWO server.

### Step 7: Customize the Natural Web I/O Interface Server

In order to dispatch the NWO Natural sessions in IMS, you must adapt the configuration file of your development server running under z/OS in batch mode. For this purpose, two sample JCL members (`NWOI009I` and `NWOCONFI`) are available.

Refer to Configuring the Natural Development Server IMS Adapter and to Configuring the Natural Web I/O Interface Server.

### On this page

- Prerequisites
- Example Jobs
- Installation Procedure