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:
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
.
The following IMS-relevant configuration parameters exist:
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 |
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
|
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 |
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.