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:
When used in this document, the notation
vrs
or
vr
represents the relevant product
version (see also Version in the
Glossary).
For details, refer to the section Prerequisites.
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.
Perform the following steps:
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
.
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.
(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.
(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.
(Job I055, Step 2582)
Relink the Natural IMS TM interface module
NIIvrsIF
.
(Job I080, Steps 2500, 2510)
Build the Natural IMS TM parameter module.
Assemble and link the Natural IMS TM parameter module.
(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.
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:
(Job I009, Step 9412)
Create member NWOCONFI
for the NWO server.
(Job I054, Step 9440)
Notes:
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.
NATISRFE
(referenced in config via
FRONTEND_NAME=NATISRFE
) has already been linked in the prior steps
of batch installation.
(Job I200, Step 9417)
Create the startup procedure for the NWO 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.