Configuring the Natural Web I/O Interface Server IMS Adapter

#### Search Results

Search

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

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.

Note
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.

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

### On this page

- Configuration File
- Configuration Parameters