Configuring the Natural Web I/O Interface Server IMS Adapter

This Dokument 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

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

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.

Anmerkung:
This port number is not used in the Web I/O Interface client to connect to a Web I/O Interface server. This port number (and the RFE_IMS_TA_HOST definition) is used internally by the Web I/O Interface server to communicate with the IMS region.

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.

Anmerkung:
The server parameters THREAD_NUMBER and THREAD_SIZE are obsolete when the Natural Web I/O Interface Server IMS Adapter is used.