Dieses Dokument beschreibt, wie Sie die CICS-Verbindung für einen Natural Web I/O Interface Server (Produktcode NWO) unter z/OS konfigurieren.
Die folgenden Themen werden behandelt:
Nach Abschluss der Installation des Natural Web I/O Interface Server CICS Adapter muss die Konfiguration des Natural Web I/O Interface Server CICS Adapter in der Konfigurationsdatei des entsprechenden Natural Web I/O Interface Server vorgenommen werden.
Um den CICS Adapter zu aktivieren, müssen Sie das Remote-Frontend-Modul im
NWO-Konfigurationsparameter FRONTEND_NAME
(FRONTEND_NAME=NATCSRFE) angeben.
Es gibt die folgenden CICS-relevanten Konfigurationsparameter:
Dieser Konfigurationsparameter gibt die CICS-Transaktion an, die zum Starten des
Remote-Frontend in CICS verwendet werden soll. Diese Transaktion muss in CICS
definiert sein und auf das Programm NATCNRFE verweisen. Siehe auch
Installation des Natural Web I/O
Interface Server CICS-Adapters unter z/OS.
| Standardwert | Erklärung |
|---|---|
| Beispiel | RFE_CICS_TA_NAME=NRFE |
Dieser Konfigurationsparameter gibt den Natural CICS-Nukleus an, den Sie mit der entsprechenden Natural for z/OS-Installation unter CICS installiert haben. Dieses Programm muss in CICS definiert sein.
| Standardwert | keiner |
|---|---|
| Beispiel | RFE_CICS_FE_NAME=NCIvrNUC |
wobei vr für die relevante Versions- und Release-Nummer steht.
Siehe auch Natural CICS-Schnittstelle auf z/OS installieren, CICS anpassen in der Installation für z/OS-Dokumentation.
Dieser Konfigurationsparameter gibt die TCP/IP-Adresse des Hosts an, auf dem das gewünschte CICS ausgeführt wird. Dieser Parameter kann weggelassen werden, wenn der Web I/O Interface Server und CICS auf demselben TCP/IP-Knoten ausgeführt werden.
| Standardwert | Die Hostadresse des Servers. |
|---|---|
| Beispiel | RFE_CICS_TA_HOST=node1
oder
|
Dieser Konfigurationsparameter gibt den TCP/IP-Port des von CICS bereitgestellten Listener an.
Sie können diese Portnummer mit der von CICS bereitgestellten Transaktion EZAC
abrufen. Das CICS-Kommando EZAC DISPLAY LISTENER zeigt die
Definitionen des CICS-Standard-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 Definition
RFE_CICS_TA_HOST) wird intern vom Web I/O Interface Server
für die Kommunikation mit der CICS-Region verwendet.
| Mögliche Werte | 1 - 65535 |
|---|---|
| Standardwert | keiner |
| Beispiel | RFE_CICS_TA_PORT=3010 |
Wenn der Web I/O Interface Client eine Anfrage an einen Natural Web I/O Interface Server sendet, der für die Verwendung des CICS-Remote-Frontend konfiguriert ist, startet das Remote-Frontend eine CICS-Transaktion (NRFE) zur Verarbeitung der Anfrage. Die CICS-Transaktion überwacht wiederum das TCP/IP, um die für die Verarbeitung der Anfrage erforderlichen Daten vom Web I/O Interface Server zu empfangen.
Dieser Konfigurationsparameter gibt den Timeout-Wert (in Sekunden) an, den eine gestartete Transaktion wartet, bis die erwarteten Anfragedaten vom Server eintreffen. Wenn dieser Timeout abläuft, wird die Anfrage mit einem NAT9940-Fehler abgebrochen.
| Standardwert | 5 |
|---|---|
| Beispiel | RFE_CICS_TA_INIT_TOUT=20 |
Anmerkung
Definieren Sie keinen Wert unter 5.
Für jede von Natural gesendete Anfrage öffnet der Natural Web I/O Interface Server
eine TCP/IP-Verbindung zur CICS-Region und startet eine CICS-Transaktion (NRFE) zur
Verarbeitung der Anfrage. Mit RFE_CICS_KEEP_TA=YES bleibt die
CICS-Transaktion für die Verarbeitung weiterer Anfragen desselben Client aktiv. Dies
spart den Aufwand für die Herstellung der TCP/IP-Verbindung und die
Transaktionsinitialisierung für aufeinanderfolgende Anfragen, verbraucht jedoch
aufgrund der wartenden Transaktionen innerhalb der CICS-Region mehr Ressourcen.
Die Transaktionswartezeit (für aufeinanderfolgende Anfragen) wird durch RFE_CICS_TA_INIT_TOUT begrenzt. Das heißt, wenn
der Zeitabschnitt zwischen zwei aufeinanderfolgenden Anfragen die durch
RFE_CICS_TA_INIT_TOUT festgelegte Zeit überschreitet, werden
die CICS-Transaktion und die TCP/IP-Verbindung unabhängig von der Definition von
RFE_CICS_KEEP_TA beendet.
RFE_CICS_TA_INIT_TOUT=5 ist ein angemessener Wert, um Transaktionen für
mehrere Anfragen wiederzuverwenden, die durch eine einzelne Aktion in Natural Studio
initiiert wurden, und um CICS-Ressourcen zu sparen, wenn Natural Studio auf die
nächste Aktion des Benutzers wartet.
| Standardwert | NO |
|---|---|
| Beispiel | RFE_CICS_KEEP_TA=YES |
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 eine bestimmte Trace-Information zuständig ist:
| Bit 31 | Trace-Hauptereignisse (Transaktionsinitialisierung/-beendigung, Anfrageverarbeitung). |
| Bit 30 | Detaillierte Funktionen. |
| Bit 29 | Interne Speicherbereiche ausgeben (Dump). |
| Bit 27 | Zwischen dem Web I/O Interface Server und CICS ausgetauschten Puffer-Header ausgeben (Dump). |
| Bit 26 | Gesamten zwischen dem Web I/O Interface Server und CICS ausgetauschten 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 CICS-Region aktivieren. |
| Bit 00 | Für Trace-Stufenerweiterung reserviert. |
Die Trace-Destination ist der für STDOUT definierte Dataset.
| Standardwert | 0 |
|---|---|
| Beispiel | RFE_CICS_TRACE=0x02000011
Dump der Hauptereignisse und des Pufferheaders in der CICS-Region (Bits 31 + 27 + 07). |
Das folgende Beispiel zeigt eine Serverkonfigurationsdatei, die den Natural Web I/O Interface Server CICS Adapter verwendet:
# the Web I/O Interface Server parameter SESSION_PARAMETER=PROFILE=(NWO,10,930) FRONTEND_NAME=NATCSRFE # use the CICS Adapter front-end PORT_NUMBER=4711 # the port number used by the Web I/O Interface Client # the CICS Adapter parameter RFE_CICS_TA_NAME=NRFE # the CICS transaction for remote front-end RFE_CICS_TA_PORT=3010 # the port of the CICS listener # no RFE_CICS_TA_HOST is defined. This requires # that CICS runs on the same node as the # server. RFE_CICS_FE_NAME=NCIvrNUC # the name of the installed Natural CICS nucleus RFE_CICS_TA_INIT_TOUT=20 # transaction timeout is 20 seconds
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 CICS Adapter nicht mehr erforderlich.
