This document describes how to configure the IMS TM connection for a Natural Web I/O Interface server (product code NWO) running on z/OS.

The following topics are covered:

• Configuration File

• Configuration Parameters

---

Configuration File

After the installation of the Natural Web I/O Interface Server IMS Adapter is complete, the configuration of the Natural Web I/O Interface Server IMS Adapter has to be done in the configuration file of the corresponding Natural Web I/O Interface server.

To enable the Natural Web I/O Interface Server IMS Adapter, specify the remote front-end module in the NWO configuration parameter FRONTEND_NAME:

FRONTEND_NAME=NATISRFE.

Configuration Parameters

The following IMS-relevant configuration parameters exist:

• RFE_IMS_TA_NAME

• RFE_IMS_TA_HOST

• RFE_IMS_TA_PORT

• RFE_IMS_TRACE

RFE_IMS_TA_NAME

This configuration parameter specifies the IMS transaction to be used for starting the remote front-end in IMS TM. This transaction must be defined in IMS TM and must refer to the program NATINRFE. See also Installing the Natural Web I/O Interface Server IMS Adapter under z/OS.

Default Value	none
Example	RFE_IMS_TA_NAME=NATvrsAD

RFE_IMS_TA_HOST

This configuration parameter specifies the TCP/IP address of the host the desired IMS TM is running. This parameter can be omitted if the Web I/O Interface server and IMS TM are running on the same TCP/IP node.

Default Value	The host address of the server.
Example	RFE_IMS_TA_HOST=node1 or RFE_IMS_TA_HOST=157.189.160.55

RFE_IMS_TA_PORT

This configuration parameter specifies the TCP/IP port of the IMS supplied listener.

Possible Values	1 - 65535
Default Value	none
Example	RFE_IMS_TA_PORT=3010

RFE_IMS_TRACE

This configuration parameter specifies the trace level for the remote front-end.

The trace level is similar to the trace implemented for the Web I/O Interface server. It is a bit string where each bit is responsible for a certain trace information:

Bit 31	Trace main events (transaction initialization/termination, request processing).
Bit 30	Detailed functions.
Bit 29	Dump internal storage areas.
Bit 27	Dump buffer header exchanged between Web I/O Interface server and IMS TM.
Bit 26	Dump entire buffer exchanged between Web I/O Interface server and IMS TM.
Bit 25	Dump the Natural Web I/O Interface server relevant buffer only (remote gateway buffer).
Bit 23	Trace error situations only.
Bit 07	Activate trace in the Web I/O Interface server region.
Bit 06	Activate trace in the IMS MPP region.
Bit 00	Reserved for trace-level extension.

The trace destination is the data set defined for STDOUT.

Default Value	0
Example	RFE_IMS_TRACE=31+27+7 Dump main events and buffer header in the IMS MPP region (Bits 31 + 27 + 7).

The following is a sample server configuration file using the Natural Web I/O Interface Server IMS Adapter:

   # The Web I/O Interface Server parameter.
SESSION_PARAMETER=PROFILE=(NWO,10,930)
FRONTEND_NAME=NATISRFE         # Use the IMS Adapter front-end.
PORT_NUMBER=4711               # The port number used by the Web I/O Interface Client.

   # The IMS Adapter parameter.
RFE_IMS_TA_NAME=NATvrsAD       # The IMS transaction for the remote front-end.
RFE_IMS_TA_PORT=3020           # The port of the IMS listener. 
                               # No RFE_IMS_TA_HOST is defined. This requires
                               # that IMS runs on the same node as the server.