This document describes the purpose and the functions of the Natural Web I/O Interface Server IMS Adapter.
The following topics are covered:
The Natural Web I/O Interface Server IMS Adapter is designed for a mainframe Natural context where it enables the use of a Natural Web I/O Interface server running under z/OS in batch mode within an IMS TM environment.
The IMS TM support is not implemented within the front-end stub
NATRNWO. For dispatching the Natural sessions in IMS TM, the Web
I/O Interface server continues to run in batch mode. But it uses the remote
front-end NATISRFE that is delivered with the Natural Web I/O
Interface server to dispatch the Natural sessions in IMS TM. That is, depending
on the installed front-end, a server dispatches the sessions locally
(NATMVS for batch mode) or remotely (NATISRFE for IMS
TM).
NATISRFE in turn accepts the Natural request from
NATRNWO and transfers it to a configured IMS TM environment using
the IMS installation provided BPM listener. The IMS listener launches in a
dedicated MPP region a non conversational Natural transaction that processes
the Natural request and returns the result. Thus it is not necessary to execute
the entire Natural Web I/O Interface server under IMS TM. Only small working
units (Natural requests such as "save source" or "get
library list") are transferred to IMS TM for execution.
The Natural Web I/O Interface Server IMS Adapter comprises the following components:
NATISRFE
|
The remote front-end called by the Natural Web I/O Interface server to dispatch a Natural request. It is loaded into the Web I/O Interface server's address space. |
NATINRFE
|
The counterpart of NATISRFE. NATINRFE
runs in an MPP region. It is launched by the IBM-provided IMS Listener (refer
also to z/OS Communications Server IP IMS Socket Guide).
|
NATSRGWO/NATLRGWO |
Transmits the data relevant for Natural Web I/O Interface server
between Natural Web I/O Interface server and the Natural session running in IMS
TM. NATSRGWO must be loaded into the Natural Web I/O Interface
server's address space, and NATLRGWO into the MPP region.
|
The following description explains the interaction between the Natural Web I/O Interface server and the IMS TM environment involved.
The Web I/O Interface (NWO) client sends a request to the Natural Web
I/O Interface server using the port number specified with the Natural Web I/O
Interface server configuration variable
PORT_NUMBER.
The Natural Web I/O Interface server dispatches the Natural session
using the Natural front-end you have specified with the Natural Web I/O
Interface server configuration variable
FRONTEND_NAME. Specify NATISRFE in
order to use the Natural Web I/O Interface Server IMS Adapter.
NATISRFE transmits the request to the host/port specified
with the Natural Web I/O Interface server configuration variable
RFE_IMS_TA_HOST /
RFE_IMS_TA_PORT. You must configure the IBM
provided BMP Listener to listen at this port.
The BMP Listener launches the IMS TM transaction you have specified
with the Natural Web I/O Interface server configuration parameter
RFE_IMS_TA_NAME. This transaction must be specified in the
configuration of the IMS Listener.
The server transaction first retrieves the transaction initialization
message. TIM contains the necessary information to do the
TAKESOCKET and passes it to NATINRFE.
NATINRFE does the TAKESOCKET and establishes the
TCP/IP conversation with NATISRFE.
NATINRFE finally dispatches the Natural IMS front-end,
which establishes a Natural server session.