Konfiguration des Natural Web I/O Interface Server IMS Adapter

Dieses Dokument beschreibt, wie Sie die IMS TM-Verbindung für einen Natural Web I/O Interface Server (Produktcode NWO) unter z/OS konfigurieren.

Die folgenden Themen werden behandelt:


Konfigurationsdatei für den IMS Adapter

Nach Abschluss der Installation des Natural Web I/O Interface Server IMS Adapter muss die Konfiguration des Natural Web I/O Interface Server IMS Adapter in der Konfigurationsdatei des entsprechenden Natural Web I/O Interface Server vorgenommen werden.

Um den Natural Web I/O Interface Server IMS Adapter zu aktivieren, müssen Sie das Remote-Frontend-Modul im NWO-Konfigurationsparameter FRONTEND_NAME angeben:

FRONTEND_NAME=NATISRFE.

Konfigurationsparameter für den IMS Adapter

Es gibt die folgenden IMS-relevanten Konfigurationsparameter:

RFE_IMS_TA_NAME

Dieser Konfigurationsparameter gibt die IMS-Transaktion an, die zum Starten des Remote-Frontend in IMS TM verwendet werden soll. Diese Transaktion muss in IMS TM definiert sein und sich auf das Programm NATINRFE beziehen. Siehe auch Installation des Natural Web I/O Interface Server IMS Adapter.

Standardwert keiner
Beispiel RFE_IMS_TA_NAME=NATvrsAD

RFE_IMS_TA_HOST

Dieser Konfigurationsparameter gibt die TCP/IP-Adresse des Hosts an, auf dem das gewünschte IMS TM ausgeführt wird. Dieser Parameter kann weggelassen werden, wenn der Web I/O Interface Server und IMS TM auf demselben TCP/IP-Knoten ausgeführt werden.

Standardwert Die Hostadresse des Servers.
Beispiel RFE_IMS_TA_HOST=node1

or

RFE_IMS_TA_HOST=157.189.160.55

RFE_IMS_TA_PORT

Dieser Konfigurationsparameter gibt den TCP/IP-Port des von IMS bereitgestellten Listener an.

Anmerkung
Diese Portnummer wird im Web I/O Interface Client nicht für die Verbindung mit einem Web I/O Interface Server verwendet. Diese Portnummer (und die RFE_IMS_TA_HOST-Definition) wird intern vom Web I/O Interface Server für die Kommunikation mit der IMS-Region verwendet.

Possible Values 1 - 65535
Standardwert keiner
Beispiel RFE_IMS_TA_PORT=3010

RFE_IMS_TRACE

Dieser Konfigurationsparameter legt die Trace-Stufe für das Remote-Frontend fest.

Die Trace-Stufe ähnelt der für den Web I/O Interface Server implementierten Trace-Stufe. Es handelt sich um eine Bitfolge, wobei jedes Bit für bestimmte Trace-Informationen zuständig ist:

Bit 31 Trace-Hauptereignisse (Transaktionsinitialisierung/-beendigung, Anfrageverarbeitung)
Bit 30 Detaillierte Funktionen.
Bit 29 Interne Speicherbereiche ausgeben (Dump).
Bit 27 Zwischen Web I/O Interface Server und IMS TM ausgetauschten Puffer-Header ausgeben (Dump).
Bit 26 Zwischen Web I/O Interface Server und IMS TM ausgetauschten gesamten Puffer ausgeben (Dump).
Bit 25 Nur den für den Natural Web I/O Interface Server relevanten Puffer (Remote-Gateway-Puffer) ausgeben (Dump).
Bit 23 Trace nur für Fehlersituationen erstellen.
Bit 07 Trace in der Web I/O Interface Server-Region aktivieren.
Bit 06 Trace in der IMS-MPP-Region aktivieren.
Bit 00 Für Trace-Stufenerweiterung reserviert.

Die Trace-Destination ist der für STDOUT definierte Dataset.

Standardwert 0
Beispiel RFE_IMS_TRACE=31+27+7

Dump der Hauptereignisse und des Puffer-Header in der IMS MPP-Region (Bits 31 + 27 + 7).

Das folgende Beispiel zeigt eine Serverkonfigurationsdatei, die den Natural Web I/O Interface Server IMS Adapter verwendet:

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

wobei vr für die relevante Versions- und Release-Nummer steht.

Anmerkung
Die Serverparameter THREAD_NUMBER und THREAD_SIZE sind bei Verwendung des Natural Web I/O Interface Server IMS Adapter nicht mehr erforderlich.