[z/OS]

Beispiele für optimierte lokale Adapter

Das Produkt enthält Beispieldateien, die optimierte lokale Adapter für z/OS unterstützen.

Die folgenden Beispieldateien befinden sich im Produktverzeichnis von WebSphere Application Server unter <Stammverzeichnis_des_Produktdateisystems>/util/zos/OLASamples:
  • Dateien .jclsamp
  • Dateien olarar.py und olararupdate.py
  • Headerdateien bboaapi.h und bboaapip.include
  • EAR-Beispieldateien

Die Datei ola_apis.jar befindet sich im Produktverzeichnis /lib.

Beschreibungen der Beispieldateien

Ein Verzeichnis mit den Namen der Beispieldateien und ihren Funktionen finden Sie in einem Verzeichnis im Element @@README der Gruppe nativer Dateien. Diese Beispiele befinden sich im Verzeichnis <Installationsstammverzeichnis>/util/zos/OLASamples und enthalten Folgendes:

  • BBOAAPI - C-Headerdatei, die für die Kompilierung von C/C++-Beispielen, in denen OLA-APIs (bboaapi.h) verwendet werden, erforderlich ist.
  • BBOAAPIC - C-Headerdatei, die für die Kompilierung von C/C++-Beispielen, in denen OLA-APIs (bboaapic.h) mit CICS LINK BBOACNTL mit COMMAREA (bboaapic.h) verwendet werden, erforderlich ist.
  • BBOAAPIP - PL/I-Include-Datei, die für die Kompilierung von PL/I-Anwendungen, die OLA-APIs (bboaapip.include) verwenden, erforderlich ist.
  • BBOACPLT - Assemblerbeispielquelle für die CICS-PLT-Initialisierungsroutine, die zeigt, wie ein OLA-TRUE-Programm während des CICS-Starts aktiviert wird (BBOACPLT.cicsasm).
  • BBOACPL2 - Assemblerbeispielquelle für die CICS-PLT-Initialisierungsroutine, die zeigt, wie OLA-Initialisierungsparameter (INITPARMS) von CICS-Startparametern abgerufen werden, und BBOC STRT_SRVR während des CICS-Starts absetzt (BBOACPL2.cicsasm).
  • BBOACPL3 - Assemblerbeispielquelle für die CICS-PLT-Initialisierungsroutine, die zeigt, wie mehrere BBOC-Befehle während des CICS-Starts an BBOACNTL übergeben werden (BBOACPL3.cicsasm).
  • BBOACPLS - Assemblerbeispielquelle für die CICS-PLT-Beendigungsroutine, die zeigt, wie eine Liste aktiver WOLA-Link-Server während der Beendigung von CICS abgerufen werden und wie sie gestoppt werden (bboacpls.cicsasm).
  • CSDUPDAT - CICS-DFHCSDUP-Dienstprogrammjob, der alle Ressourcendefinitionen definiert, die für OLA unter CICS erforderlich sind (CSDUPDAT.jclsamp).
  • DFHPLTOL - JCL-Quelle für die Assemblierung einer Beispiel-PLT mit dem optimierten lokalen Adapter (OLA). Aktivieren Sie das TRUE-Exitprogramm (BBOACPLT) und die PLT des OLA-BBOC-Befehlsprozessors (BBOACPL2) (dfhpltol.jclsamp).
  • OLABATCH - JCL für die Ausführung eines der Beispiele im Stapelbetrieb. Stellen Sie sicher, dass dieses Beispiel in derselben logischen Partition ausgeführt wird, in der auch WebSphere z/OS ausgeführt wird (OLABATCH.jclsamp).
  • OLACB01 - JCL-Quelle für eine CICS-Verknüpfung mit einem Cobol-Beispielprogramm, das einen Kommunikationsbereich (commarea) verwendet. Dieses Beispielzielprogramm kann verwendet werden, wenn der CICS-Link-Server für optimierte lokale Adapter (OLA) verwendet wird. Es meldet die gesendete Nachricht zurück (OLACB01.jclsamp).
  • OLACB02 - JCL-Quelle für eine CICS-Verknüpfung mit einem Cobol-Beispielprogramm, das einen Container verwendet. Dieses Beispielzielprogramm kann verwendet werden, wenn der CICS-Link-Server für optimierte lokale Adapter (OLA) verwendet wird. Es meldet die gesendete Nachricht zurück (OLACB02.jclsamp).
  • OLACB03 - JCL-Quelle für ein CICS-Cobol-Beispielprogramm, das demonstriert, wie eine CICS-Task über die API "Host-Service" an einen OLA-Server abgesetzt wird (OLACB03.jclsamp).
  • OLACB04 - JCL-Quelle für ein CICS-Cobol-Beispielprogramm, das demonstriert, wie eine CICS-Task über die APIs "Anforderung empfangen" und "Daten abrufen" an einen OLA-Server abgesetzt wird (OLACB04.jclsamp).
  • OLACB05 - JCL-Quelle für ein CICS-Cobol-Beispielprogramm, das demonstriert, wie die APIs "Registrieren" und "Verbindung abrufen" verwendet werden, eine EJB über "Anforderung senden" aufgerufen wird, die Antwort mit "Daten abrufen" abgerufen wird und die Verbindung mit "Verbindung freigeben" und "Registrierung zurücknehmen" freigegeben wird (OLACB05.jclsamp).
  • OLACB06 - JCL-Quelle für ein CICS-Cobol-Beispielprogramm, das demonstriert, wie die API "Registrieren" verwendet wird und eine EJB mit "Aufrufen" und "Registrierung zurücknehmen" aufgerufen wird (OLACB06.jclsamp).
  • OLACB10 - JCL-Quelle für ein CICS-Cobol-Beispielprogramm, das mehrere Container zum Übergeben von Daten an CICS über eine EJB verwendet. Dieses Beispielzielprogramm kann verwendet werden, wenn der CICS-Link-Server für optimierte lokale Adapter (OLA) verwendet wird (OLACB10.jclsamp).
  • OLACB11 - JCL-Quelle für ein CICS-Cobol-Beispielprogramm, das mehrere Container zum Übergeben von Daten an CICS über eine EJB verwendet. Dieses Beispielzielprogramm kann verwendet werden, wenn der CICS-Link-Server für optimierte lokale Adapter (OLA) verwendet wird. Die Daten werden im Zielprogramm geändert (OLACB11.jclsamp).
  • OLACB12 - JCL-Quelle für ein CICS-Cobol-Beispielprogramm, das mehrere Container zum Übergeben von Daten an CICS über eine EJB verwendet. Dieses Beispielzielprogramm kann verwendet werden, wenn der CICS-Link-Server für optimierte lokale Adapter (OLA) verwendet wird. Die Daten werden im Zielprogramm gelöscht (OLACB12.jclsamp).
  • OLACC01 - JCL-Quelle für ein C-Programm, das "Registrieren", "Aufrufen" und "Registrierung zurücknehmen" verwendet. Es kann unter batch/USS/CICS ausgeführt werden (OLACC01.jclsamp).
  • OLACC02 - JCL-Quelle für ein C-Programm, das die APIs "Host-Service", "Anforderung senden", "Antwort senden" und "Daten abrufen" aufruft. Dieses Programm ruft sich im Grunde selbst auf, setzt Aufrufe an eine EJB und anschließend Callbacks an dieses Programm ab. Es kann unter batch/USS/CICS ausgeführt werden (OLACC01.jclsamp).
  • OLACC10 - JCL-Quelle für ein CICS-C-Beispielprogramm, das mehrere Container zum Übergeben von Daten an CICS über eine EJB verwendet. Dieses Beispielzielprogramm kann verwendet werden, wenn der CICS-Link-Server für optimierte lokale Adapter (OLA) verwendet wird (OLACC10.jclsamp).
  • OLAMAP - JCL-Quelle für eine CICS-BMS-Maskendefinition. Dies ist eine 3270-Teststeuermaske für die Übergabe von Anforderungen an und von WebSphere von CICS (OLAMAP.jclsamp).
  • OLAPL01 - JCL-Quelle für ein PL/I-Programm, das als IMS Fast Path-Nachrichtentransaktion ausgeführt wird. Informationen zum Generieren dieser Transaktion in Ihrer IMS-Umgebung finden Sie in der Beschreibung der Beispielmember STAGE1 und PSBOLA2 (OLAPL01.jclsamp).
  • OLAPL02 - JCL-Quelle für ein PL/I-Programm, das als IMS-Nachrichtenverarbeitungsprogrammtransaktion ausgeführt wird. Informationen zum Generieren dieser Transaktion in Ihrer IMS-Umgebung finden Sie in der Beschreibung der Beispielmember STAGE1 und PSBOLA2 (OLAPL02.jclsamp).
  • OLAUTIL - JCL-Quelle für das Cobol-CICS-Testanwendungsdienstprogramm. Sie können über diese Anzeige die APIs "Registrieren", "Aufrufen", "Host-Service", "Antwort senden" testen und die Namen von Dämongruppe/Server/Knoten sowie den Servicenamen für die Ausführung aktualisieren. Dieses Dienstprogramm kann für das Testen von Aufrufen in beide Richtungen verwendet werden. Dieser Code kann als Beispiel für die Verwendung dieser APIs verwendet werden (OLAUTIL.jclsamp).
  • PSBOLA2 - JCL-Beispielquelle die zeigt, wie der IMS PSB OLAPL01 und OLAPL02 generiert (PSBOLA2.jclsamp).
  • OTMAINIT - Beispiel-JCL, mit der veranschaulicht wird, wie die SVCs der aufrufbare IMS-OTMA-Schnittstelle auf Ihrem System gestartet werden (OTMAINIT.jclsamp).
  • STAGE1 - Beispielquelle für IMS STAGE1 für OLAPL01 und OLAPL02 (STAGE1.jclsamp).
Anmerkung: Das Beispiel OLAUTIL führt GET CONTAINER INTOCCSID(37) über CCSID(1208)- UTF-8 aus. Bevor Sie dieses Beispiel ausführen, um den Datenfluss zwischen WebSphere und CICS zu veranschaulichen, müssen Sie sich vergewissern, dass z/OS-Unicode-Services ausgeführt werden und diese Konvertierung unterstützt wird. Andernfalls kann die abnormale CICS-Beendigung AEZW auftreten.

Installation der Beispiele

  1. Ordnen Sie eine partitionierte Datei (PDS, Partitioned Dataset) oder eine erweiterte partitionierte Datei (PDSE, Partitioned Dataset Extended) für die JCL-Quelle zu. In der Beispiel-JCL hat diese Datei den Namen BOSS.OLA.SAMPLES.SRC.

    Diese Datei ist mit den Einstellungen RECFM=FB, DSORG=PO, LRECL=80, BLKSIZE=9040, TRKS=40 zugeordnet. Kopieren Sie z. B. OGET, die Dateien mit dem Dateityp "jclsamp", aus dem Verzeichnis <Stammverzeichnis_des_Produktdateisystems>/util/zos/OLASamples in diese Datei. Die Headerdatei bboaapi.h wird ebenfalls als BBOAAPI in dieser Datei gespeichert.

  2. Es wird eine EAR-Datei bereitgestellt, die sofort nach der Konfiguration des Ressourcenadapters "ola.rar" und der Definition einer Verbindungsfactory mit dem JNDI-Namen "eis/ola" installiert werden kann.
    Die EAR-Datei befindet sich im Verzeichnis <Stammverzeichnis_des_Produktdateisystems>/util/zos/OLASamples.
    Achtung: Wenn Sie Version 8.0 verwenden, verwenden Sie die Datei OLASample2.ear.
  3. Ordnen Sie eine weitere PDS oder PDSE für das vom Erstellungsjob OLAMAP für CICS-BMS-Masken erstellte COBOL-COPYBOOK zu.

    Diese Datei ist mit den Einstellungen RECFM=FB, DSORG=PO, LRECL=80, BLKSIZE=9040, TRKS=15 zugeordnet. In der Beispiel-JCL hat diese Datei den Namen BOSS.OLA.SAMPLES.COPYBOOK.

  4. Ordnen Sie eine Lademodulbibliothek für die Beispiellademodule für die optimierten lokalen Adapter zu, bzw. wählen Sie sie aus.

    Sie muss als Bibliothek und nicht als partitioniert Datei zugeordnet werden.

  5. Verwenden Sie die folgenden Schritte, um die z/OS-Stapelbeispieldateien zu erstellen und auszuführen.

    Für alle Elemente, die Sie in diesen Schritten aktualisieren, müssen Sie die JCLLIB-Anweisung so ändern, dass sie auf Ihre Prozedurbibliotheken zeigen (in diesem Beispiel für C-Kompilierungen). Hierfür sollte jemand zu Rate gezogen werden, der weiß, wo sich diese Informationen auf Ihrem System befinden. Außerdem sind in die Testfallquelle die Dämongruppe (Kurzname der Zelle), der Kurzname des Knotens und der Kurzname des Servers integriert, die Sie vor der Kompilierung ändern müssen, damit diese auf Ihrem System funktionieren.

    1. Ändern Sie das Element "OLACCnn" (wobei nn für die Testfallnummer steht), und aktualisieren Sie die JCL so, dass sie den Dateinamenskonventionen Ihres Standorts für den C-Compiler entspricht, und legen Sie die SYSLMOD-Datei fest, in der das Ausgabelademodul gespeichert werden soll.
    2. Aktualisieren Sie im Element "OLACCnn" den Namen der Dämongruppe (Kurzname der Zelle), den Knotennamen und den Servernamen, und übergeben Sie den Job zum Erstellen des Lademoduls für den Testfall.
    3. Stellen Sie sicher, dass der Zielanwendungsserver mit aktivierter Unterstützung für optimierte lokale Adapter gestartet wird. Sie aktivieren die Unterstützung optimierter lokaler Adapter, indem Sie "WAS_DAEMON_ONLY_enable_adapter" auf true setzen. Stellen Sie außerdem sicher, dass die Datei ola.rar installiert ist und dass eine Verbindungsfactory mit dem JNDI-Namen "eis/ola" erstellt wurde.
    4. Stellen Sie sicher, dass die EAR-Datei "OLA" im Zielanwendungsserver installiert ist.
      Achtung: Wenn Sie Version 8.0 verwenden, verwenden Sie die Datei OLASample2.ear.
    5. Verwenden Sie OLABATCH als Schablone für die Ausführung der OLACCnn-Beispiele für den Stapelbetrieb.

    Einige Beispieljobs verweisen auf eine Datei mit dem Namen BOSS.OLA90902.SBBOLOAD. Diese Datei stellt die Datei dar, in die Sie die Onlineadaptermodule mit dem Script copyZOS.sh kopiert haben.

  6. Die z/OS-Beispiele für den Stapelbetrieb können auch unter CICS ausgeführt werden. Folgen Sie den Schritten im Artikel "Unterstützung optimierter lokaler Adapter in CICS aktivieren", und fügen Sie die Beispiellademodulbibliothek aus Schritt 4 der CICS-DFHRPL-DD-Verknüpfung hinzu.
  7. Verwenden Sie die folgenden Schritte, um die Anzeige für das CICS-Beispieltestdienstprogramm für optimierte lokale Adapter zu erstellen und auszuführen. Für alle Elemente, die Sie in diesem Prozess aktualisieren, müssen Sie die JCLLIB-Anweisung so ändern, dass sie auf Ihre Prozedurbibliotheken zeigt (in diesem Fall für Cobol-Compiler und für die CICS-Übersetzung). Hierfür sollte jemand zu Rate gezogen werden, der weiß, wo sich diese Informationen auf Ihrem System befinden.
    1. Ändern Sie das Element OLAMAP, und aktualisieren Sie die JCL so, dass sie den Dateinamenskonventionen Ihres Standorts für HLASM-Anwendungen entspricht.
      Sie müssen die Parameter MAPLIB und DSCTLIB an die Namen Ihrer Dateien anpassen. MAPLIB muss auf die Beispiellademodulbibliothek zeigen, die Sie in Schritt 4 zugeordnet haben. DSCTLIB muss auf die COPYBOOK-Datei zeigen, die Sie in Schritt 3 zugeordnet haben.
      Anmerkung: Sie können den Standardregistrierungsnamen in dieser Anzeige von CICSTEST in einen anderen Namen ändern. Außerdem können Sie den Standarddämongruppennamen (Kurzname der Zelle), den Knotennamen und den Servernamen festlegen. Die hier eingegebenen Werte erscheinen in der Anzeige, wenn Sie die OLAU-Transaktion unter CICS ausführen.
    2. Übergeben Sie den OLAMAP-Job zum Erstellen des CICS-Maskengruppenmoduls.
    3. Ändern Sie das Element OLAUTIL, und überprüfen Sie den Inhalt.

      Diese Cobol-Beispielanwendung demonstriert eine Reihe der APIs für optimierte lokale Adapter unter Cobol. Sie sendet und empfängt die CICS-BMS-Maske OLAMAP und kann eine Nachricht an jede Ziel-Enterprise-Bean in jedem lokal zugeordneten Anwendungsserver senden. Außerdem kann sie veranschaulichen, wie Sie mit der API BBOA1SRV aus Ihrer CICS-Task einen Zielservice für optimierte lokale Adapter machen. Nachdem Sie die JCL an Ihre Dateinamenskonventionen angepasst haben, übergeben Sie den Job, woraufhin das OLAUTIL-Lademodul in der mit dem Symbol PROGLIB angezeigten Datei gespeichert wird.

    4. Stellen Sie sicher, dass die Lademodulbibliothek für die optimierten lokalen Adapter und die Beispiellademodulbibliothek für die optimierten lokalen Adapter in der CICS-DFHRPL-DD-Verknüpfung Ihrer katalogisierten CICS-Prozedur enthalten sind.
    5. Stellen Sie sicher, dass der CSDUPDAT-Beispieljob ausgeführt wurde und die Schritte zum Installieren der optimierten lokalen Adapter unter CICS abgeschlossen sind.
    6. Stellen Sie sicher, dass der Zielanwendungsserver mit aktivierter Unterstützung für optimierte lokale Adapter gestartet wird. Sie aktivieren die Unterstützung optimierter lokaler Adapter, indem Sie "WAS_DAEMON_ONLY_enable_adapter" auf true setzen. Stellen Sie außerdem sicher, dass die Datei ola.rar installiert ist und dass eine Verbindungsfactory mit dem JNDI-Namen "eis/ola" erstellt wurde. Weitere Informationen zu diesen Prozeduren finden Sie im Artikel "Serverumgebung für die Verwendung optimierter lokaler Adapter aktivieren".
    7. Stellen Sie sicher, dass die EAR-Datei "OLA" im Zielanwendungsserver installiert ist.
      Achtung: Wenn Sie Version 8.0 verwenden, verwenden Sie die Datei OLASample2.ear.
    8. Starten Sie CICS.

      Stellen Sie sicher, dass die Unterstützung optimierter lokaler Adapter aktiviert ist, melden Sie sich bei CICS mit einer Benutzer-ID an, die für die Ausführung von BBOC- und OLAU-Transaktionen berechtigt ist, und löschen Sie dann den Anzeigeninhalt. Geben Sie BBOC START_TRUE ein, um den taskbezogenen CICS Benutzerexit für die optimierten lokalen Adapter zu starten. Es erscheint eine Nachricht, wenn der Exit erfolgreich gestartet wurde. Falls Sie diese Nachricht nicht erhalten, müssten Sie stattdessen eine Nachricht empfangen, in der Sie über den aufgetretenen Fehler informiert werden. Ausführlichere Nachrichten finden Sie in der CICS-Jobausgabe und in der Datei BBOOUT. Wenn Sie das PLTPI-Programm (Program List Table for Post Initialization) verwenden möchten, um die optimierten lokalen Adapter beim CICS-Start zu starten, finden Sie im folgenden Abschnitt eine Beschreibung dieses Prozesses.

    9. Löschen Sie den Anzeigeninhalt, und geben Sie OLAU ein, um die Testanzeige zu starten.

      Wenn alles ordnungsgemäß funktioniert, wird in der Anzeige die Überschrift * Optimized Local Adapters WAS z/OS Testing * angezeigt. In dieser Anzeige werden die Ausführungsparameter aufgelistet. Für "Register first" wird der Wert Y, für "Register name" der Wert CICSTEST, und für "Service name" wird der Wert ejb/com/ibm/ola/olasample1_echoHome angezeigt. Das Feld "Number of Tests to run" enthält den Wert 00001.

    10. Geben Sie im Feld "Send message data" eine Nachricht ein, die an den Service in WebSphere Application Server gesendet werden soll.
    11. Geben Sie den Kurznamen des Servers von WebSphere Application Server, den Kurznamen des Knotens von WebSphere Application Server und den Kurznamen der Zelle von WebSphere Application Server (Name der Dämongruppe) für den Server ein, in dem eine Enterprise-Bean aufgerufen werden soll.
    12. Die verbleibenden Felder können unverändert übernommen werden. Der angezeigte Servicename ist der Name des JNDI-Ausgangsverzeichnisses einer Beispielziel-Enterprise-Bean in der Datei "OLA.EAR".
      Achtung: Wenn Sie Version 8.0 verwenden, verwenden Sie die Datei OLASample2.ear.
    13. Klicken Sie auf PF4, um die Nachricht an die EJB "olasample1_echoHome" zu senden. Die Nachricht wird in das Feld "Received message data" zurückgegeben.
    14. Damit haben Sie einen Aufruf von einem CICS-Cobol-Programm an eine EJB-Anwendung von WebSphere Application Server demonstriert.

      Die Daten in der Anzeige haben Sie jetzt geändert. Das Feld "Register First?" enthält jetzt nicht mehr den Wert Y, sondern den Wert N. Wenn erneut Anforderungen mit diesem Registrierungsnamen ausgeführt werden, ist kein vorheriger Registrierungsaufruf erforderlich, damit sich der Wert in N ändert. Wenn Sie den Rückkehrcode 8 (RC8) und den Ursachencode 8 (RSN8) auf einen Registrierungsaufruf hin empfangen, bedeutet dies, dass Sie bereits registriert sind und sich nicht erneut registrieren müssen. Wenn Sie OLAU verlassen und später dorthin zurückkehren, ist die Registrierung immer noch aktiv, sodass Sie sich nicht erneut mit diesem Namen registrieren und den Wert auf N setzen müssen.

    15. Zum Testen eines Aufrufs von WebSphere Application Server an CICS können Sie dieselbe Anzeige verwenden.

      Sie müssen das Feld für den Servicenamen in den Namen ändern, den Sie als Zielservicenamen verwenden möchten. Klicken Sie anschließend auf PF5. Daraufhin wird die Anzeige in einen x-wait-Status versetzt, da OLAUTIL die API BBOA1SRV mit dem angeforderten Servicenamen und dem angeforderten Registrierungsnamen aufruft. In der Anzeige wird eine Registrierung mit dem Namen CICSTEST und der Servicename "myserv" angezeigt. Weitere Parameter mit Werten in der Anzeige sind die Parameter für den Kurznamen des WAS-Servers, den Kurznamen des WAS-Knotens, den Kurznamen der WAS-Zelle (Name der Dämongruppe), die Anzahl der auszuführenden Tests und die Anzahl der abgeschlossenen Tests.

    16. Wenn sich OLAU für den angeforderten Servicenamen im Wartestatus befindet, müssen Sie die Beispielwebanwendung in Ihrem Browser starten.

      Verwenden Sie den folgenden URL (in dem Sie die IP-Adresse/Portnummer an Ihren Standort anpassen müssen): http://nn.nn.nn.nn:nnnn/OLA_Sample1_Web/. Ändern Sie nnnn (Portnummer) in den Nicht-SSL-Port der Anwendung von WebSphere Application Server.

    17. Es erscheint eine Webseite mit den folgenden Feldern: "Data to send to external address space", "Response back from external address space", "OLA Register Name", "OLA Service Name", "CICS Link server-specific data", "CICS Link Request Container ID", "CICS Link Response Container ID" und "CICS Link Transaction ID". Geben Sie die Nachricht ein, die Sie senden möchten, geben Sie den Registrierungsnamen Namen und den Servicenamen wie zuvor in der OLAU-Anzeige ein, und klicken Sie auf Run WAS->External address space test.
    18. Jetzt sollten Sie die Nachricht, die Sie eingegeben haben, in der Browseranzeige Ihrer CICS-3270-Anzeige im Feld "Received message data" sehen.
    19. Geben Sie eine Antwortnachricht im Feld "Send message data" ein, und klicken Sie auf PF6, um die Antwort an WebSphere Application Server zurückzusenden. Diese sollte daraufhin im Browser angezeigt werden.
    20. Damit haben Sie einen Aufruf von einem Servlet von WebSphere Application Server an ein CICS-Cobol-Programm demonstriert.
  8. Verwenden Sie die folgenden Schritte, um einen Aufruf von einer Anwendung von WebSphere Application Server an ein CICS-Cobol-Programm über den CICS-Link-Server für optimierte lokale Adapter abzusetzen.
    1. Ändern Sie das Element OLACB01, und überprüfen Sie den Inhalt.

      Diese Cobol-Beispielanwendung ist das Ziel eines Befehls EXEC CICS LINK mit einem Kommunikationsbereich (COMMAREA). Sie schreibt die übergebenen COMMAREA-Nachrichtendaten in die Cobol-Standardausgabe (CEEMSG) und meldet die Nachricht zurück. Aktualisieren Sie die JCL so, dass sie auf Ihre lokalen Dateien zeigt, und übergeben Sie sie. Die Ladebibliothek, in dem dieses Modul gespeichert ist, muss in der CICS-DFHRPL-Verknüpfung enthalten sein.

    2. Ändern Sie das Element OLACB02, und überprüfen Sie den Inhalt.

      Diese Cobol-Beispielanwendung ist das Ziel eines Befehls EXEC CICS LINK mit einem Container. Sie liest den Containerinhalt und schreibt diesen in denselben Container zurück. Aktualisieren Sie die JCL so, dass sie auf Ihre lokalen Dateien zeigt, und übergeben Sie sie. Die Ladebibliothek, in dem dieses Modul gespeichert ist, muss in der CICS-DFHRPL-Verknüpfung enthalten sein.

    3. Stellen Sie sicher, dass der CSDUPDAT-Beispieljob ausgeführt wurde und die Schritte zum Installieren der optimierten lokalen Adapter unter CICS abgeschlossen sind.
    4. Starten Sie CICS.

      Melden Sie sich bei CICS mit einer Benutzer-ID an, die für die Ausführung der BBOC-, BBO#- und BBO$-Transaktionen berechtigt ist, und löschen Sie den Anzeigeninhalt.

      Geben Sie BBOC START_TRUE ein, um den taskbezogenen CICS Benutzerexit für die optimierten lokalen Adapter zu starten.

      Es erscheint eine Nachricht, wenn der Exit erfolgreich gestartet wurde. Falls Sie diese Nachricht nicht erhalten, müssten Sie stattdessen eine Nachricht empfangen, in der Sie über den aufgetretenen Fehler informiert werden. Ausführlichere Nachrichten finden Sie in der CICS-Jobausgabe und in der Datei BBOOUT. Wenn Sie das PLTPI-Programm (Program List Table for Post Initialization) verwenden möchten, um die optimierten lokalen Adapter beim CICS-Start zu starten, finden Sie im folgenden Abschnitt eine Beschreibung dieses Prozesses.

    5. Löschen Sie den Anzeigeninhalt erneut und geben Sie Folgendes ein, um eine Task des CICS-Link-Servers für optimierte lokale Adapter zu starten: bboc start_srvr rgn=olaserver svn=<Servername> dgn=<Zellenname> ndn=<Knotenname> mnc=1 mxc=5 sec=n svc=*.

      Daraufhin wird eine BBO$-Task mit dem Registrierungsnamen OLASERVER gestartet und eine Verbindung zum angegebenen Anwendungsserver hergestellt. Sie müssen auf jeden Fall den Serverkurznamen, den Zellenkurznamen und den Knotenkurznamen für den Server angeben.

    6. Jetzt können Sie eine Anforderung zur Verbindungsherstellung zu einem vorhandenen CICS-Programm senden. Starten Sie die Testwebseite (http://nn.nn.nn.nn:nnnn/OLA_Sample1_Web/). Geben Sie OLASERVER als Registrierungsnamen und OLACB01 als Servicenamen ein.
    7. Klicken Sie auf Run WAS > External address space test. Daraufhin sollte Seite mit derselben Nachricht zurückgegeben werden, die an CICS gesendet wurde. Wenn Sie sich den CICS-CEEMSG-DD (im aktiven CICS-Job) ansehen, werden die Nachrichtendaten in UTF-8 angezeigt.
    8. Damit haben Sie einen Aufruf von einem Servlet in WebSphere Application Server an ein CICS-Cobol-Programm OLACB01 demonstriert, in dem Daten in einem Kommunikationsbereich übergeben und zurückgegeben werden.
    9. Rufen Sie die Browseranzeige erneut auf, und ändern Sie den Servicenamen in OLACB02. Klicken Sie anschließend auf das Kontrollkästchen "Use Containers".
      Wichtig: Sie müssen das Kontrollkästchen "Use Containers" auswählen.
    10. Klicken Sie auf Run WAS > External address space test. Daraufhin sollte eine Seite mit der zurückgemeldeten Eingabenachricht angezeigt werden.
    11. Damit haben Sie einen Aufruf von einem Servlet in WebSphere Application Server an ein CICS-Cobol-Programm OLACB02 demonstriert, in dem Daten über einen Container übergeben werden.
    12. Wenn Sie die Abläufe genauer verfolgen möchten, können Sie den Link-Server stoppen und anschließen mit aktivierter Traceerstellung erneut starten. Wenn Sie "TRC=2" setzen, können Sie die Tracenachrichten in der Datei BBOOUT des CICS-Jobs sehen. Geben Sie Folgendes ein, um den Link-Server zu stoppen: bboc stop_srvr rgn=olaserver. Geben Sie Folgendes ein, um den Link-Server mit Traceerstellung erneut zu starten: bboc start_srvr rgn=olaServer svn=<Servername> dgn=<Zellenname> ndn=<Knotenname> mnc=1 mxc=5 sec=n svc=* trc=2.
  9. Verwenden Sie die folgenden Schritte, wenn Sie CICS so konfigurieren möchten, dass der taskbezogene Benutzerexit für die optimierten lokalen Adapter automatisch beim CICS-Start gestartet wird.
    1. Sie können "BBOC START_TRUE\" in einem sequenziellen CICS-Terminal (TYPE=SDSCI) codieren, um den taskbezogenen Benutzerexit für die optimierten lokalen Adapter zu starten.
    2. Sie können aber auch eine PLTPI (Program List Table for Post Initialization) für die CICS-Region erstellen und diese während des Starts der CICS-Region aufrufen lassen.

      Der Beispieljob DFHPLTOL erstellt eine PLTPI mit dem Suffix OL. Führen Sie diesen Beispieljob aus, stellen Sie das erstellte Modul DFHPLTOL in eine Lademodulbibliothek in der DFHRPL-Verknüpfung, und fügen Sie der SIT-PLTPI, die für die CICS-Region angegeben ist, das Suffix OL hinzu, z. B. PLTPI=OL.

      Ein diesbezügliches Beispiel finden Sie in der Beispieldatei DFHPLTOL. Wenn Sie die PLTPI ausführen, sollten die folgenden Nachrichten in Ihrem CICS-Jobprotokoll erscheinen, wenn der taskbezogene Benutzerexit für die optimierten lokalen Adapter ordnungsgemäß gestartet wurde:
      +BBOA9920I WAS z/OS OLA CICS PLT init start.     
      +BBOA9921I WAS z/OS OLA CICS TRUE enabled. +BBOA9925I WAS z/OS OLA CICS PLT init ending.

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cdat_olasamples
Dateiname:cdat_olasamples.html