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:

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. In order to access DL/I databases from the server transactions, the specific DB PCBs have to be added.

    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.