[z/OS]

Optimierte lokale Adapter für z/OS-APIs

Die optimierten lokalen Adapter von WebSphere Application Server for z/OS werden von einer Reihe nativer aufrufbarer z/OS-Services oder -Anwendungsprogrammierschnittstellen sowie Java™ EE Connector Architecture (JCA) unterstützt.

Diese aufrufbaren Services können von den folgenden nativen Programmiersprachen verwendet werden:
  • Cobol
  • C/C++
  • PL/I
  • High Level Assembler
Jeder aufrufbare Service hat eine 31-Bit- und eine 64-Bit-Version. Die Namenskonvention ist BBOA1- für 31-Bit-API-Stubs und BBGA1- für 64-Bit-API-Caller.

Ein Caller, der in AMODE 64 ausgeführt wird, kann die AMODE-31-Versionen der APIs verwenden, vorausgesetzt, die Parameterliste befindet sich unter der Leiste und sie übergibt Parameter mit 31-Bit-Konventionen (jeder Parameterverweis ist eine 31-Bit-Adresse). Caller, die mit der 64-Bit-Version ausgeführt werden, müssen in C, C++ oder Assemblersprache definiert und im 64-Bit-Adressierungsmodus ausgeführt werden. Wenn Sie die BBGA1*-64-Bit-APIs in Assembleranwendungen verwenden, ist ein Format-4- oder ein F4SA-64-Bit-Sicherungsbereich erforderlich, der von den OLA-Stubs (Optimized Local Adapters, optimierte lokale Adapter) verwendet wird, um die Caller-Register zu speichern und wiederherzustellen. Wenn der Aufruf von C oder C++ erfolgt, definiert der Beispielheader in <Prod_FS-Stammverzeichnis>/util/zos/OLASamples/bboaapi.h die 64-Bit-APIs als externen OS_NOSTACK, wodurch sichergestellt wird, dass sie mit den richtigen Konventionen für Verknüpfungen und Sicherheitsbereiche aufgerufen werden.

Wenn der Begriff lokale Verbindung in dieser API-Dokumentation verwendet wird, ist damit eine speicherübergreifende Verbindung gemeint, die für die Kommunikation zwischen einem externen Adressraum auf dem z/OS-System und WebSphere Application Server auf demselben z/OS-System erstellt wird. Der Clientadressraum muss unter demselben z/OS-Image ausgeführt werden. Die Adapter-API verwaltet diese lokalen Verbindungen in Pools, die jedem eindeutig registrierten Caller zugeordnet werden. Der 12-stellige Registrierungsname kann nur für eine einzige Gruppe von Verbindungspools pro Adressraum verwendet werden. Die Anzahl eindeutiger Registrierungen in einem einzelnen Adressraum ist nicht begrenzt. Sie wird nur durch die verfügbare Speicherkapazität beschränkt.

Registrieren

Sie können die API BBOA1REG (für 31-Bit-Caller) und BBGA1REG (für 64-Bit-Caller) für die Registrierung bei einer Dämongruppe und einem Server des lokalen WebSphere Application Server for z/OS verwenden. Die APIs BBOA1REG und BBGA1REG fordern die Zuordnung und die Registrierung einer Gruppe optimierter Verbindungen für eine Dämongruppe und einen Server des lokalen WebSphere Application Server unter dem angegebenen "Registrierungsnamen" (registername) an.

Tabelle 1. Syntax der APIs BBOA1REG (31-Bit-Caller) und BBGA1REG (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1REG oder BBGA1REG

BBOA1REG ( daemongroupname , nodename , servername , registername , minconn , maxconn , registerflags , rc, rsn )

BBGA1REG ( daemongroupname , nodename , servername , registername , minconn , maxconn , registerflags , rc, rsn )

Parameter

daemongroupname (input)

Eine Eintragsvariable oder Eintragskonstante, die den Namen der zu verknüpfenden Dämongruppe von WebSphere Application Server for z/OS enthält. Der Name der Dämongruppe muss mit dem Kurznamen der Zelle und nicht mit dem Jobnamen des Dämons übereinstimmen.

Die Eintragsvariable oder -konstante muss eine auf null endende Zeichenfolge von genau acht Zeichen sein und nach Referenz übergeben werden. Der Dämon von WebSphere Application Server for z/OS muss auf dem lokalen System aktiv und initialisiert sein.

nodename (Eingabe)

Eine Eintragsvariable oder Eintragskonstante, die den Namen des zu verknüpfenden Knotens (Kurzname) von WebSphere Application Server for z/OS enthält. Die Eintragsvariable oder -konstante muss nach Referenz übergeben werden. Der WebSphere Application Server z/OS-Server muss aktiv sein und auf dem lokalen System initialisiert werden. Sie müssen eine mit Leerzeichen aufgefüllte Zeichenfolge mit genau 8 Zeichen eingeben.

servername (Eingabe)

Eine Eintragsvariable oder Eintragskonstante, die den Namen des zu verknüpfenden Knotens (Kurzname) von WebSphere Application Server for z/OS enthält. Die Eintragsvariable oder -konstante muss nach Referenz übergeben werden. Der WebSphere Application Server z/OS-Server muss aktiv sein und auf dem lokalen System initialisiert werden. Sie müssen eine mit Leerzeichen aufgefüllte Zeichenfolge mit genau 8 Zeichen eingeben.

registername (Eingabe)

Eine Eintragsvariable oder Eintragskonstante, die den Namen des für die Registrierung einer Gruppe lokaler Verbindungen zu verwendenden Namen enthält. In späteren Aufrufen muss dieser Name verwendet werden, um den Pool zu verwendender Verbindungen anzugeben. Sie müssen eine mit Leerzeichen aufgefüllte Zeichenfolge mit genau 12 Zeichen eingeben, die noch nicht im aktuellen Adressraum verwendet wird.

minconn (Eingabe)
Eine ganze Zahl, die die anfängliche Mindestanzahl an Verbindungen enthält, die dieser Registrierung zugeordnet werden sollen. Der Adapter versucht während der Registrierung, diese Anzahl an Verbindungen mit dem zugeordneten Server zu reservieren.
Wichtig: Es wird mindestens eine Verbindung für die Bindung an den Zielserver zugeordnet, selbst wenn MINCONN mit null (0) angegeben ist. Die Angabe von 0 entspricht der Angabe von 1.
maxconn (Eingabe)

Eine ganze Zahl, die die maximale Anzahl an Verbindungen enthält, die dieser Registrierung zugeordnet werden sollen. Der Adapter versucht während einer Verbindungsabrufanforderung, den lokalen Verbindungspool bis auf diese Anzahl zu erweitern, wenn die Mindestanzahl an Verbindungen bereits alle in Gebrauch ist.

registerflags (Eingabe)
Ein 32-Bit-Flagwort, das die Registrierungsflags enthält.
  • reg_flag_trans - Bit 30

    Enthält eine 1, wenn die Transaktionswiederherstellung in Verbindungen unter dieser Registrierung unterstützt werden soll, andernfalls eine 0 (null).

    Wenn der Parameter für Transaktionen aktiviert ist, versucht die Adapter-API die Registrierung bei den z/OS Resource Recovery Services (RRS), und es wird eine globale Transaktion, die zweiphasiges Commit unterstützt, zwischen WebSphere Application Server und der Umgebung des API-Nutzers erstellt.

    Wenn Sie ab Version 8.5.0.2 eine IMS-abhängige Region ausführen und dieses Flag auf 1 setzen, stellen Sie sicher, dass Sie Ihre IMS-Umgebung mit der Einstellung "RRS=YES" ausführen und dass die Umgebungsvariable "ola_rrs_context_propagate" auf Server- oder Knotenebene zu Ihrer Konfiguration hinzugefügt und auf "true" (bzw. 1) gesetzt wurde. Unter IMS ist der RRS-Kontext im Thread wirksam, wenn die WOLA-API-Aufruf "Invoke" oder "Send Request" im EJB-Container von WebSphere Application Server for z/OS weitergegeben und zugesichert wird.

    Fehler vermeiden Fehler vermeiden: Wenn Sie die Variable "ola_rrs_context_propagate" zu Ihren Konfigurationseinstellungen hinzufügen oder die Einstellung für diese Variable auf true setzen möchten, müssen Sie den Server, nachdem Sie diese Konfigurationsänderung durchgeführt haben, erneut starten. gotcha
  • reg_flag_W2Cprop - Bit 31 oder Bit 64

    Das Flag "reg_flag_W2Cprop" steuert die Weitergabe der abgehenden Transaktionssicherheit von WebSphere Application Server an CICS.

  • reg_flag_C2Wprop - Bit 29
    Gibt die Identität der aufrufenden Task von CICS an WebSphere Application Server weiter. Für eingehende Transaktionen von CICS an WebSphere Application Server steuert das Registrierungsflag "reg_flag_C2Wprop", wie die Identität bestimmt wird. Wenn dieses Bit aktiviert wird, wird die Taskidentität der CICS-Anwendung im Berechtigungsprozess des WebSphere Application Server-Servers verwendet. Wenn dieses Bit ausgeschaltet ist, wird die Identität der CICS-Region verwendet.
    Achtung: Sie müssen WebSphere Application Server für die Anforderung der Sicherheit auf CICS-Anwendungsebene aktivieren. Setzen Sie die WebSphere-Umgebungsvariable "ola_cicsuser_identity_propagate" über die Administrationskonsole auf den Wert 1, um diesen Typ von Sicherheitsweitergabe festzulegen.
  • reg_flag_trcmod - Bit 0

    Setzen Sie das Flag "reg_flag_trcmod", wenn Sie die Traceeinstellungen des optimierten Adapters für die angeforderte Registrierung ändern möchten. Wenn Sie dieses Flag nicht setzen möchten, wird die Traceeinstellung nicht geändert, und die Standardeinstellungen des Systems oder die vordefinierten Traceeinstellungen, die für den Registrierungsnamen gültig sind, werden verwendet.

  • reg_flag_trcmore - Bit 1 und reg_flag_trcsome - Bit 2

    Wenn "reg_flag_trcmod" auf 1 gesetzt ist, können Sie mit dem Flag "reg_flag_trcmore" oder "reg_flag_trcsome" ein detailliertes bzw. grobkörniges Tracing für die Registrierung festlegen. Wenn Sie beide Flags auf "off" gesetzt lassen und das Flag "reg_flag_trcmod" auf 1 setzen, wird kein Tracing für die Registrierung gesetzt, unabhängig davon, welche Vorabdefinitionen oder Standardeinstellungen festgelegt sind.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Die angeforderte Mindestanzahl an Verbindungen wird mit der maximalen Verbindungsanzahl des Servers verglichen, die über die Administrationskonsole von WebSphere Application Server konfigurierbar ist. Ein minconn-Wert von 3 bedeutet, dass während des Registrierungsaufrufs 3 Verbindungen reserviert werden. Wenn zu einem bestimmten Zeitpunkt mehr als drei Verbindungen angefordert werden, kann der Verbindungspool auf die maximale Verbindungsanzahl (maxconn) erweitert werden. Wenn die Anzahl aller Verbindungen zu einem Server die maximal zulässige Anzahl erreicht, werden alle nachfolgenden Anforderungen der API "Verbindung abrufen" für diesen Server zurückgewiesen, selbst wenn der maxconn-Wert noch nicht erreicht ist.
    Wichtig: Gehen Sie beim Festlegen des Werts für die Mindestanzahl an Verbindungen mit Vorsicht vor. Mit Ausnahme bestimmter Fälle ist eine zu hohe Einstellung nicht ratsam, da die Ressourcen in der Steuerregion von WebSphere Application Server für jede Verbindung reserviert werden.
  • Es können mehrere Aufrufe an die API "Registrieren" unter demselben Adressraum, demselben Thread oder derselben CICS-Task (Customer Information Control System) abgesetzt werden, aber diese dürfen nicht denselben Registrierungsnamen haben. Der Registrierungsname muss ein eindeutiger Name sein.
  • Wenn Sie den Parameter "transactional" auf 1 setzen, werden alle Verbindungen für diese Registrierung mit Transaktionalität ausgeführt. Das bedeutet, dass RRS über den aktuellen Adressraum zugeordnet wird. Weitere Einzelheiten zu den Voraussetzungen und der entsprechenden Konfiguration finden Sie im Abschnitt zur Weitergabe von Transaktionen. Die Transaktionalität wird nur zwischen WebSphere Application Server und CICS unterstützt. Anforderungen für transactional(1) von anderen Umgebungen führen zur Ausgabe einer Warnung während des Aufrufs der API "Registrieren". Das Flag wird ignoriert, und die Verarbeitung wird fortgesetzt.
  • Verwenden Sie die API "Registrierung zurücknehmen", um diese Registrierung zu entfernen und den zugeordneten Verbindungspool freizugeben.
  • Wenn der Adressraum, über den ein Registrierungsaufruf abgesetzt wird, beendet wird, wird die Registrierung automatisch beendet, und die Verbindungen werden freigegeben.
Rückkehr- und Ursachencodes:
Tabelle 2. Rückkehr- und Ursachencodes der APIs BBOA1REG und BBGA1REG. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
  4 Das Registrierungsflag "transactional" wurde in einer Umgebung auf 1 gesetzt, in der der Adapter keine globalen Transaktionen unterstützt. Diese Einstellung wird ignoriert, und die Verarbeitung wird fortgesetzt.
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Sie müssen die Registrierung dieses Namens zurücknehmen, bevor Sie die API "Registrieren" für diesen Namen aufrufen.
  10 Der Parameter für die maximale Anzahl an Verbindungen überschreitet die für eine einzelne Registrierung maximal zulässige Anzahl an Verbindungen. Die Anforderung der API "Registrieren" wird zurückgewiesen. Stellen Sie sicher, dass der Wert für die maximale Anzahl optimierter lokaler Adapter des Zielservers für diese und alle weiteren Anforderungen ausreichend ist. Weitere Informationen zur Umgebungsvariablen "WAS_DAEMON_ONLY_adapter_max_conn" finden Sie im Artikel "Angepasste Eigenschaften optimierter lokaler Adapter" und im Artikel "Serverumgebung für die Verwendung optimierter lokaler Adapter aktivieren".
  12 Der für den Parameter für die Mindestanzahl an Verbindungen angegebene Wert ist höher als der Maximalwert. Stellen Sie sicher, dass die Einstellung für die Mindestanzahl an Verbindungen kleiner-gleich der Einstellung für die Maximalanzahl ist.
  14 Beim Erstellen der Registrierung wurde festgestellt, dass der gemeinsam genutzte Speicher nicht ausreicht. Erhöhen Sie die Zuordnung gemeinsam genutzten Speichers für den optimierten lokalen Adapter, oder setzen Sie Aufrufe an die API "Registrierung zurücknehmen" ab, um den Speicherkonsum zu reduzieren.
  21 Beim Herstellen der Verbindung zum lokalen WebSphere Application Server ist ein Fehler auftreten. Wenn Sie das Bit "reg_flag_C2Wprop" (Bit 29) auf 1 setzen, müssen Sie sicherstellen, dass die WebSphere-Umgebungsvariable "ola_cicsuser_identity_propagate" auf 1 gesetzt wird.
  25 Der Transaktionsmanager kann nicht gestartet werden. Wenden Sie sich an den IBM® Support.
  70 Beim Erstellen einer neuen Verbindung wurde festgestellt, dass der gemeinsam genutzte Speicher nicht ausreicht. Erhöhen Sie die Zuordnung gemeinsam genutzten Speichers für den optimierten lokalen Adapter.
  74 Der eingegebene Registrierungsname enthält eine Null. Füllen Sie den Registrierungsnamen mit Leerzeichen auf, bevor Sie die API "Registrieren" aufrufen.
12 4 Beim Suchen des BBOACALL-Moduls ist ein Fehler aufgetreten. Stellen Sie sicher, dass die Datei, die das BBOACALL-Modul von WebSphere Application Server enthält, in STEPLIB, LNKLST verfügbar ist.
  10 Die ausgewählte Dämongruppe von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Zielserver von WebSphere Application Server gestartet sind, vergewissern Sie sich, dass die Unterstützung optimierter lokaler Adapter aktiv ist, und wiederholen Sie die Operation.
  14 Die Benutzer-ID ist für den angeforderten WebSphere Application Server nicht berechtigt. Stellen Sie sicher, dass die Benutzer-ID für die CBIND-SAF-Klasse des angeforderten WebSphere Application Server berechtigt ist.
  16 Der Knotenname oder Servername wurde nicht gefunden. Stellen Sie sicher, dass die übergebenen Knotennamen- und Servernamensparameter gültig sind und dass der Server aktiv ist.
  23 Beim Benennen des Tokens ist ein Fehler aufgetreten. Wenden Sie sich an den IBM Support.
  24 Beim Herstellen der anfänglichen lokalen Kommunikationsverbindung mit WebSphere Application Server ist ein Fehler aufgetreten. Einzelheiten zum Aufruf der lokalen Kommunikationsverbindung finden Sie in den Protokollen der Steuerregion von WebSphere Application Server.
  28 Die mit diesem Namen angegebene Registrierung ist nicht gültig. Der angegebene Registrierungsname ist bereits registriert, aber der RGE-Eintrag fehlt. Melden Sie den Fehler dem IBM Support. Sie können das Problem umgehen, indem Sie die API "Registrierung zurücknehmen" aufrufen und anschließend versuchen, die API "Registrieren" erneut aufzurufen.
  30 Die Dämongruppe wird nicht mit der Einstellung 1 für die Eigenschaft "WAS_DAEMON_ONLY_enable_adapter" ausgeführt. Fügen Sie die Variable "variable:WAS_DAEMON_ONLY_enable_adapter=1" über die Administrationskonsole von WebSphere Application Server hinzu.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  68 Eine Zuordnung zum gemeinsam genutzten Speicher ist fehlgeschlagen. Wenden Sie sich an den IBM Support.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Registrierung zurücknehmen

Nehmen Sie die Registrierung bei der lokalen Dämongruppe und beim Server von WebSphere Application Server for z/OS mit den APIs BBOA1URG (für 31-Bit-Caller) und BBGA1URG (für 64-Bit-Caller) zurück.
Tabelle 3. Syntax der APIs BB0A1URG (31-Bit-Caller) und BBGA1URG (64-Bit-Caller) . Diese API fordert die Freigabe einer Gruppe optimierter Verbindungen zu einer Dämongruppe und zu einem Server des lokalen WebSphere Application Server über den angegebenen Registrierungsnamen an.
API Syntax
BBOA1URG oder BBGA1URG

BBOA1URG (registername, unregflags, rc, rsn)

BBGA1URG (registername, unregflags, rc, rsn)

Parameter:

registername (Eingabe)

Eine Eintragsvariable oder Eintragskonstante, die den Namen des für die Rücknahme der Registrierung einer Gruppe lokaler Verbindungen zu verwendenden Namen enthält. Sie müssen einen Namen mit genau 12 Zeichen eingeben, der mit Leerzeichen aufgefüllt ist und der dem in BBOA1REG verwendeten Namen entspricht.

unregisterflags (Eingabe)
Ein 32-Bit-Flagwort, das Flags für die Rücknahme der Registrierung enthält.
  • Reserviert - Bit 0-30
  • Force (0|1) - Bit 31 oder Bit 64

    Enthält eine 1, wenn die Anforderung zur Rücknahme der Registrierung erzwungen werden soll. Standardmäßig ist eine Anforderung zur Rücknahme der Registrierung abgeschlossen, wenn alle Verbindungen an den Verbindungspool zurückgegeben wurden. Wenn nicht alle Verbindungen an den Pool zurückgegeben werden, wird eine Warnung an den Caller gesendet. Die Rücknahme der Registrierung ist abgeschlossen, wenn die letzte Verbindung an den Pool zurückgegeben wurde. Es kann eine zweite Anforderung zur Rücknahme der Registrierung abgesetzt werden, in der das Bit "Force" auf 1 gesetzt ist, Damit wird der Abschluss der Rücknahme der Registrierung erzwungen, und alle verbleibenden Verbindungskennungen für diese Registrierung werden ungültig gemacht.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Wenn Sie die API "Registrierung zurücknehmen" nicht aufrufen und der Adressraum, über den ein Registrierungsaufruf abgesetzt wurde, beendet wird, wird automatisch ein Aufruf zur Rücknahme der Registrierung durchgeführt, und die Verbindungen werden freigegeben.
  • Alle Verbindungskennungen für diese Registrierung, die im Gebrauch oder aktiv sind, wenn der Aufruf zur Rücknahme der Registrierung abgesetzt wird, bleiben möglicherweise so lange gültig, bis sie über die API BBOA1CNR an den Verbindungspool zurückgegeben werden. Um die Bereinigung der Verbindungskennungen zu erzwingen, muss ein zweiter Aufruf zur Rücknahme der Registrierung abgesetzt werden, in dem das Flag "Force" gesetzt ist. Daraufhin werden alle ausstehenden Verbindungskennungen ungültig gemacht.
Rückkehr- und Ursachencodes:
Tabelle 4. Rückkehr- und Ursachencodes der APIs BBOA1URG und BBGA1URG. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
  66 Der Aufruf zur Rücknahme der Registrierung wird verzögert, bis alle Verbindungen an den Pool zurückgegeben wurden. Die Rücknahme der Registrierung ist abgeschlossen, wenn die letzte Verbindung an den freien Pool zurückgegeben wurde.
8 - Fehler, siehe Ursachencode  
  8 Der Name des Registrierungstokens ist nicht vorhanden. Sie müssen diesen Namen registriert haben, bevor Sie für ihn die API "Registrierung zurücknehmen" aufrufen.
  64 Die Option force kann erst nach dem Absetzen eines normalen Aufrufs zur Rücknahme der Registrierung angegeben werden. Rufen Sie die API "Registrierung zurücknehmen" ohne die Option force auf.
  76 Ein Versuch, mit dem Server zu kommunizieren, ist fehlgeschlagen, weil der Server nicht mehr aktiv ist. Starten Sie den Server, und wiederholen Sie den Kommunikationsversuch.
  82 Es wurde bereits versucht, diese Registrierung zurückzunehmen. Warten Sie, bis die vorherige Anforderung zur Rücknahme der Registrierung abgeschlossen ist, oder setzen Sie die entsprechende Anforderung mit der Option force erneut ab.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
12 34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Verbindung abrufen

Diese API fordert an, dass eine verfügbare Verbindung aus dem Pool, die mit dem ausgewählten Registrierungsnamen erstellt wurde, zurückgegeben wird.
Tabelle 5. Syntax der APIs BBOA1CNG (31-Bit-Caller) und BBGA1CNG (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1CNG oder BBGA1CNG

BBOA1CNG ( registername, connectionhandle, waittime, rc, rsn )

BBGA1CNG ( registername, connectionhandle, waittime, rc, rsn )

Parameter:

registername (Eingabe)

Eine Eintragsvariable oder Eintragskonstante, die den Namen enthält, der zum Suchen des Verbindungspools verwendet wird, aus dem eine Verbindung abgerufen werden soll. Dieser Name muss eine mit Leerzeichen aufgefüllte Zeichenfolge mit genau 12 Zeichen sein.

connectionhandle (Ausgabe)

Eine 12-Byte-Verbindungskennung, die in späteren Anforderungen für Aktionen in dieser Verbindung übergeben werden muss.

waittime (Eingabe)

Eine ganze Zahl, die angibt, wie lange (in Sekunden) auf den Abschluss der Verbindung gewartet werden soll, bevor ein Ursachencode für nicht verfügbare Verbindung zurückgegeben wird. Der Wert 0 (null) impliziert, dass es keine Wartezeit gibt und dass die API unbegrenzt warten soll.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (BBOA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor die API "Verbindung abrufen" verwendet wird.
Rückkehr- und Ursachencodes:
Tabelle 6. Rückkehr- und Ursachencodes der APIs BBOA1CNG und BBGA1CNG. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist nicht vorhanden. Stellen Sie sicher, dass dieser Name registriert ist, bevor Sie versuchen, den Namen mit der API "Verbindung abrufen" aufzurufen.
  10 Die Verbindung ist nicht verfügbar. Die Wartezeit ist abgelaufen, bevor die Verbindungsanforderung abgerufen werden konnte. Das Anwendungsverhalten variiert. Warten Sie, und wiederholen Sie die Operation, oder beenden Sie diese Verbindung abnormal. Eine andere Option ist die Erhöhung des Werts der Einstellung für die maximale Verbindungsanzahl im Aufruf der API "Registrieren".
  24 Nach einem erfolgreichen Registrierungsaufruf ist ein Fehler beim Abrufen einer Verbindung aus dem Pool aufgetreten. Stellen Sie sicher, dass der Server gestartet ist. Wenn dies nicht funktioniert, starten Sie den Server erneut, und wiederholen Sie die API-Anforderung.
  28 Die Registrierung wurde zwar gefunden, aber sie ist inaktiv.  
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Vorgang.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Verbindung freigeben

Die API "Verbindung freigeben" fordert an, dass eine Verbindung an den Pool zurückgegeben wird, aus dem sie abgerufen wurde, und für einen anderen Anforderer verfügbar gemacht wird.
Tabelle 7. Syntax der APIs BBOA1CNR (31-Bit-Caller) und BBGA1CNR (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1CNR oder BBGA1CNR

BBOA1CNR ( connectionhandle, rc, rsn )

BBGA1CNR ( connectionhandle, rc, rsn )

Parameter:

connectionhandle (Eingabe)

Eine 12-Byte-Verbindungskennung, die die zuvor abgerufene Verbindung angibt, die an den Verbindungspool zurückgegeben werden soll.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für das Fehlschlagen des Aufrufs beschreibt.

Verwendungshinweise
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie vor der Verwendung der API "Verbindung freigeben" sicher, dass ein Registrierungsaufruf (API BBOA1REG oder BBGA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen und ein Aufruf zum Abrufen der Verbindung (API BBOA1CNG), die jetzt freigegeben werden soll, erfolgreich abgeschlossen wurden.
Tabelle 8. Rückkehr- und Ursachencodes der APIs BBOA1CNR und BBGA1CNR. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Alle Ressourcen, die mit dieser Verbindung in Zusammenhang stehen, wurden bereinigt. Keine
8 - Fehler, siehe Ursachencode  
  36 Der Verbindungsstatus ist nicht gültig. Eine Verbindungskennung, die für diese Anforderung verwendet wird, hat den falschen Status. Die Regeln für Verbindungsstatus sind in der API-Dokumentation beschrieben.
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für diese Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
12 14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG) hat den Verbindungspool ungültig gemacht.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Anforderung senden

Diese APIs senden eine Anforderung zur Verarbeitung an den lokalen WebSphere Application Server.
Tabelle 9. Syntax der APIs BBOA1SRQ (31-Bit-Caller) und BBGA1SRQ (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1SRQ oder BBGA1SRQ

BBOA1SRQ ( connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn )

BBGA1SRQ ( connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn )

Parameter:

connectionhandle (Eingabe)

Eine 12-Byte-Verbindungskennung, die für diese Anforderung verwendet werden soll.

requesttype (Eingabe)

Eine ganze Zahl, die den Anforderungstyp, d. h. den Typ der zu verarbeitenden Arbeitsanforderung, angibt. Folgende Typwerte werden unterstützt: 1 = Lokale EJB-Arbeitsanforderungen, 2 = Ferne EJB-Arbeitsanforderungen.

requestservicename (Eingabe)

Eine EBCDIC-Zeichenfolge von maximal 256 Byte Länge, die den Namen des zu startenden Service enthält. Für Type=1 (EJB) ist dies der Name der JNDI-Home-Schnittstelle für das Ziel.

requestservicenamel (Eingabe)

Eine ganze Zahl, die die Länge des zu startenden Service oder 0 (null) enthält, falls der Servicename auf null endet.

requestdata (Eingabe)

Ein 31-Bit- oder 64-Bit-Zeiger auf die Startadresse der zu sendenden Anforderungsdaten.

requestdatalen (Eingabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der zu sendenden Daten enthält.

async(0|1) (Eingabe)

Ein ganzzahliger Wert. Der Wert 1 zeigt an, dass der Caller möchte, dass die Steuerung sofort zurückgegeben wird, selbst wenn die Antwortlänge noch nicht bekannt ist. Bei async(0) wartet aktuelle Thread, bis die Antwort von WebSphere Application Server zurückgegeben wird, und die Antwortlänge wird im Ausgabeargument responsedatalen zurückgegeben.

responsedatalen (Ausgabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der Antwort enthält. Diese Länge kann anschließend vom Caller verwendet werden, um Speicher anzufordern, bevor die API "Daten abrufen" aufgerufen wird, um die Daten zu kopieren. Wenn "async" auf 1 gesetzt wird, d. h., wenn der Caller möchte, dass die Steuerung sofort zurückgegeben wird, wird alles auf 0xFFs gesetzt, wenn die Antwort noch nicht empfangen wurde.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (BBOA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor die API "Anforderung senden" verwendet wird.
Rückkehr- und Ursachencodes:
Tabelle 10. Rückkehr- und Ursachencodes der APIs BBOA1SRQ und BBGA1SRQ . In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  14 Beim Speichern der Nachricht ist eine abnormale Speicherbedingung eingetreten. Es ist nicht genügend Speicher verfügbar, damit die API "Anforderung senden" die Nachricht verarbeiten kann. Der aktuelle Adressraum liegt außerhalb des privaten Speichers.
  16 Die Länge des Anforderungsservicenamens ist nicht gültig. Korrigieren Sie das Programm, und wiederholen Sie den Aufruf.
  18 Die Anforderungslänge überschreitet die Systemgrenzwerte. Die Wert für die Nachrichtenlänge ist zu hoch und wird von WebSphere Application Server nicht unterstützt. Vergewissern Sie sich, dass die Größe gültig ist. Wenn die Größe gültig ist, stellen Sie sicher, dass die Größe in WebSphere Application Server für die Nachricht ausreicht.
  26 Die globale Transaktion konnte nicht gestartet werden.  
  32 Der Typ der API-Aufrufanforderung ist nicht gültig. Der Anforderungstyp ist nicht gültig. Korrigieren Sie das Programm, und wiederholen Sie den Aufruf.
  34 Der Zielservice wurde nicht gefunden. Stellen Sie sicher, dass die Anwendung, die die Ziel-Enterprise-Bean enthält, installiert und im Zielserver für WebSphere Application Server gestartet ist.
  36 Der Verbindungsstatus ist nicht gültig. Eine Verbindungskennung, die für die Anforderung verwendet wird, hat den falschen Status. Die Regeln für Verbindungsstatus sind in der API-Dokumentation beschrieben.
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für die Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  44 Es ist eine Ausnahme oder unerwartete Bedingung in der Ziel-Enterprise-Bean eingetreten. Suchen Sie in den Protokollen von WebSphere Application Server nach den Ausnahmedaten.
  46 Es ist ein Fehler im Aufruf zum Senden der Anforderung in der lokalen Kommunikation aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
  98 Der Zugriff auf den Anfang des bereitgestellten Anforderungspuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Anforderungspuffers korrekt sind.
  100 Der Zugriff auf das Ende des bereitgestellten Anforderungspuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Anforderungspuffers korrekt sind.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Versuchen Sie erneut, die Dämongruppe und den Server von WebSphere Application Server zu finden.
  14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG) hat den Verbindungspool ungültig gemacht.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Antwort senden

Diese API sendet eine Antwort auf eine Anforderung an den lokalen WebSphere Application Server zurück.
Tabelle 11. Syntax der APIs BBOA1SRP (31-Bit-Caller) und BBGA1SRP (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1SRP oder BBGA1SRP

BBOA1SRP ( connectionhandle, responsedata, responsedatalen, rc, rsn )

BBGA1SRP ( connectionhandle, responsedata, responsedatalen, rc, rsn )

Parameter:

connectionhandle (Eingabe)

Eine 12-Byte-Verbindungskennung, die für diese Antwort verwendet werden soll.

responsedata (Eingabe)

Ein 31-Bit- oder 64-Bit-Zeiger auf die Startadresse der zu sendenden Antwortdaten.

responsedatalen (Eingabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der zu sendenden Daten enthält.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (API BBOA1REG oder BBGA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor die API "Antwort senden" verwendet wird.
  • Stellen Sie sicher, dass ein Aufruf zum Abrufen einer Verbindung (API BBOA1CNG oder BBGA1CNG) erfolgreich abgeschlossen wurde und die Kennung für diese Verbindung als Eingabe in diesem Aufruf angegeben wird.
  • Stellen Sie sicher, dass ein Aufruf der API "Anforderung in jeder Verbindung empfangen", "Anforderung in bestimmter Verbindung empfangen" oder "Host" erfolgreich abgesetzt und mit Anforderungsdaten für die Verbindungskennung zurückgegeben wurde. Die Verbindung muss einen Status haben, in dem die API "Antwort senden" gültig ist.
Rückkehr- und Ursachencodes:
Tabelle 12. Rückkehr- und Ursachencodes der APIs BBOA1SRP und BBGA1SRP. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  14 Beim Speichern der Nachricht ist eine abnormale Speicherbedingung eingetreten. Es ist nicht genügend Speicher verfügbar, damit die API "Antwort senden" die Nachricht verarbeiten kann. Der aktuelle Adressraum liegt außerhalb des privaten Speichers.
  18 Die Antwortlänge überschreitet die Systemgrenzwerte. Die Wert für die Nachrichtenlänge ist zu hoch und wird von WebSphere Application Server nicht unterstützt. Vergewissern Sie sich, dass die Größe gültig ist. Wenn die Größe gültig ist, stellen Sie sicher, dass die Größe in WebSphere Application Server für die Nachricht ausreicht.
  34 Der Zielservice wurde nicht gefunden. Stellen Sie sicher, dass die Anwendung, die die Ziel-EJB enthält, installiert und in der Zielumgebung von WebSphere Application Server gestartet ist.
  36 Der Verbindungsstatus ist nicht gültig. Eine Verbindungskennung, die für diese Anforderung verwendet wird, hat den falschen Status. Die Regeln für Verbindungsstatus sind in der API-Dokumentation beschrieben.
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für diese Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  46 Es ist ein Fehler im Aufruf zum Senden der Anforderung in der lokalen Kommunikation aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
  102 Der Zugriff auf den Anfang des bereitgestellten Antwortpuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Antwortpuffers korrekt sind.
  104 Der Zugriff auf das Ende des bereitgestellten Antwortpuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Antwortpuffers korrekt sind.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Vorgang.
  14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG) hat den Verbindungspool ungültig gemacht.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Antwortausnahme senden

Diese API sendet Ausnahmeantwortdaten an den JPA-Caller im lokalen WebSphere Application Server zurück. Die Antwort ist eine Ausnahme des Typs "ResourceAdapterException", die mit den angegebenen Ausnahmeantwortdaten zurückgegeben wird.

Tabelle 13. Syntax der APIs BBOA1SRX (31-Bit-Caller) und BBGA1SRX (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1SRX oder BBGA1SRX

BBOA1SRX ( connectionhandle, excresponsedata, exresponsedatalen, rc, rsn )

BBGA1SRX ( connectionhandle, excresponsedata, exresponsedatalen, rc, rsn )

Parameter:

connectionhandle (Eingabe)

Eine 12-Byte-Verbindungskennung, die für diese Antwort verwendet werden soll.

excresponsedata (Eingabe)

Ein 31-Bit- oder ein 63-Bit-Zeiger auf die Startadresse der zu sendenden Ausnahmeantwortdaten.

excresponsedatalen (Eingabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der zu sendenden Ausnahmeantwortdaten enthält. Die Ausnahmeantwortdaten sind eine EBCDIC-Zeichenfolge, die den Fehler beschreibt.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (API BBOA1REG oder BBGAREG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor der Aufruf zum Senden einer Antwort verwendet wird.
  • Stellen Sie sicher, dass ein Aufruf zum Abrufen einer Verbindung (API BBOA1CNG oder BBGA1CNG) erfolgreich abgeschlossen wurde und die Kennung für diese Verbindung als Eingabe in diesem Aufruf angegeben wird.
  • Stellen Sie sicher, dass ein Aufruf der API "Anforderung in jeder Verbindung empfangen", "Anforderung in bestimmter Verbindung empfangen" oder "Host" erfolgreich abgesetzt und mit Anforderungsdaten für die Verbindungskennung zurückgegeben wurde. Die Verbindung muss einen Status haben, in dem die APIs "Antwort senden" und "Antwortausnahme senden" gültig ist.
Rückkehr- und Ursachencodes:
Tabelle 14. Rückkehr- und Ursachencodes der APIs BBOA1SRX und BBGA1SRX. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  10 Die Verbindungskennung ist freigegeben oder hat einen anderen ungültigen Status. Stellen Sie sicher, dass eine gültige Verbindungskennung übergeben wird.
  14 Beim Speichern der Nachricht ist eine abnormale Speicherbedingung eingetreten. Es ist nicht genügend Speicher verfügbar, damit die API "Antwortausnahme senden" die Nachricht verarbeiten kann. Der aktuelle Adressraum liegt außerhalb des privaten Speichers.
  16 Mindestens ein Parameter ist nicht gültig. Stellen Sie sicher, dass alle Parameter gültig sind, und wiederholen Sie anschließend den Aufruf.
  18 Die Antwortlänge überschreitet die Systemgrenzwerte. Die Wert für die Nachrichtenlänge ist zu hoch und wird von WebSphere Application Server nicht unterstützt. Vergewissern Sie sich, dass die Größe gültig ist. Wenn die Größe gültig ist, stellen Sie sicher, dass die Größe in WebSphere Application Server für die Nachricht ausreicht.
  20 Mindestens ein Parameter ist nicht gültig. Stellen Sie sicher, dass alle Parameter gültig sind, und wiederholen Sie anschließend den Aufruf.
  28 Die Registrierung, der die Verbindungskennung zugeordnet war, ist nicht mehr aktiv. Rufen Sie die API "Registrieren" erneut mit dem Registrierungsnamen auf, bevor Sie Aufrufe zum Abrufen einer Verbindung und zum Senden der Anforderung aufrufen.
  36 Der Verbindungsstatus ist nicht gültig. Eine Verbindungskennung, die für diese Anforderung verwendet wird, hat den falschen Status. Die Regeln für Verbindungsstatus sind in der API-Dokumentation beschrieben.
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für diese Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  46 Es ist ein Fehler im Aufruf zum Senden der Anforderung in der lokalen Kommunikation aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
  102 Der Zugriff auf den Anfang des bereitgestellten Antwortpuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Antwortpuffers korrekt sind.
  104 Der Zugriff auf das Ende des bereitgestellten Antwortpuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Antwortpuffers korrekt sind.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Vorgang.
  14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG) hat den Verbindungspool ungültig gemacht.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Anforderung in jeder Verbindung empfangen

Wenn Sie diese API verwenden, können Sie eine Anforderung von einem lokalen WebSphere Application Server in jeder Verbindung empfangen. Eine Anforderung und die zugehörigen Daten können in jeder verfügbaren Verbindung im Pool für den übergebenen Registrierungsnamen empfangen werden. Die Länge der Anforderungsdaten werden als Ausgabeparameter zurückgegeben. Außerdem wird eine Verbindungskennung als Ausgabeparameter an den Caller zurückgegeben. Ein Aufruf der API "Daten abrufen" mit der zurückgegebenen Verbindungskennung gibt die empfangenen Nachrichtendaten zurück.

Tabelle 15. Syntax der APIs BBOA1RCA (31-Bit-Caller) und BBGA1RCA (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1RCA oder BBGA1RCA

BBOA1RCA ( registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn )

BBGA1RCA ( registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn )

Parameter:

registername (Eingabe)

Eine Eintragsvariable oder Eintragskonstante, die den Namen enthält, der zum Suchen des Verbindungspools verwendet wird, aus dem eine Verbindung abgerufen werden soll. Dieser Name muss eine mit Leerzeichen aufgefüllte Zeichenfolge mit genau 12 Zeichen sein.

connectionhandle (Ausgabe)

Eine 12-Byte-Verbindungskennung, die zurückgegeben wird und in späteren Anforderungen für Aktionen in dieser Verbindung übergeben werden muss.

requestservicename (Eingabe/Ausgabe)

Eine EBCDIC-Zeichenfolge mit bis zu 256 Bytes, die den Namen des Service enthält. Dies ist der Name des Zielservice, der im Parameter "InteractionSpec" von der WebSphere Application Server-Anwendung angegeben wird. Der Wert * zeigt eine Empfangsanforderung für alle Servicenamen an, die unter dem aktuellen registrierten Namen eingehen.

requestservicenamel (Eingabe/Ausgabe)

Eine ganze Zahl, die die Länge des zu startenden Service oder 0 (null) enthält, falls der Servicename auf null endet.

requestdatalen (Ausgabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der zu empfangenden Daten enthält.

waittime (Eingabe)

Eine ganze Zahl, die angibt, wie lange (in Sekunden) auf den Abschluss der Verbindung gewartet werden soll, bevor ein Ursachencode für nicht verfügbare Verbindung zurückgegeben wird. Der Wert 0 (null) impliziert, dass es keine Wartezeit gibt und dass die API unbegrenzt warten soll.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (API BBOA1REG oder BBGA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor diese API verwendet wird.
Rückkehr- und Ursachencodes:
Tabelle 16. Rückkehr- und Ursachencodes der APIs BBOA1RCA und BBGA1RCA. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  11 Es wurden ungültige Daten von WebSphere Application Server gesendet.  
  16 Die Länge des Anforderungsservicenamens ist nicht gültig. Korrigieren Sie das Programm, und wiederholen Sie den Aufruf.
  19 Es ist ein Datenfehler in der lokalen Kommunikation aufgetreten.  
  21 Es ist ein Fehler bei der Vorschau der Daten in der lokalen Kommunikation aufgetreten.  
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für diese Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  46 Es ist ein Fehler im Aufruf zum Senden der Anforderung in der lokalen Kommunikation aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  76 Ein Versuch, mit dem Server zu kommunizieren, ist fehlgeschlagen, weil der Server nicht mehr aktiv ist. Starten Sie den Server, und wiederholen Sie den Kommunikationsversuch.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Vorgang.
  24 Nach einem erfolgreichen Registrierungsaufruf ist ein Fehler beim Abrufen einer Verbindung aus dem Pool aufgetreten. Stellen Sie sicher, dass der Server gestartet ist. Wenn der Server nicht gestartet ist, starten Sie den Server erneut, und wiederholen Sie die API-Anforderung.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  44 "CP build" für Serviceaufruf ungültig.  
  46 "CP get" für Serviceaufruf ungültig.  
  48 "CP free" für Serviceaufruf ungültig.  
  60 SRVQ-Sperre kann nicht abgerufen werden.  
  62 SRVQ-Sperre kann nicht freigegeben werden.  
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Anforderung in bestimmter Verbindung empfangen

Wenn Sie diese API verwenden, können Sie eine Anforderung von einem lokalen WebSphere Application Server in einer bestimmten Verbindung empfangen. Es werden eine Anforderung und zugehörige Daten für die angegebene Verbindungskennung empfangen. Die Länger der Anforderungsdaten wird zurückgegeben. Ein Aufruf der API "Daten abrufen" mit der zurückgegebenen Verbindungskennung gibt die empfangenen Nachrichtendaten zurück.
Tabelle 17. Syntax der APIs BBOA1RCS (31-Bit-Caller) und BBGA1RCS (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1RCS oder BBGA1RCS

BBOA1RCS ( connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn )

BBGA1RCS ( connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn )

Parameter:

connectionhandle (Eingabe)

Eine 12-Byte-Verbindungskennung, die für diese Anforderung verwendet werden soll.

requestservicename (Eingabe/Ausgabe)

Eine EBCDIC-Zeichenfolge mit bis zu 256 Bytes, die den Namen des Service enthält. Dies ist der Name des Zielservice, der im Parameter "InteractionSpec" von der WebSphere Application Server-Anwendung angegeben wird. Der Wert * (Stern) zeigt an, dass ein Server für alle Servicenamen konfiguriert wurde, die unter dem aktuellen registrierten Namen eingehen.

requestservicenamel (Eingabe/Ausgabe)

Eine ganze Zahl, die die Länge des zu startenden Service oder 0 (null) enthält, falls der Servicename auf null endet.

requestdatalen (Ausgabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der empfangenen Anforderungsdaten enthält. Diese Länge kann anschließend vom Caller verwendet werden, um Speicher anzufordern, bevor die API "Daten abrufen" aufgerufen wird, um die Daten zu kopieren. Wenn "async" auf 1 gesetzt wird, d. h., wenn der Caller möchte, dass die Steuerung sofort zurückgegeben wird, wird alles auf 0xFFs gesetzt, wenn die Anforderungsdaten noch nicht empfangen wurden. In diesem Fall muss die API erneut aufgerufen werden, um eine eingehende Anforderung abzurufen.

async(0|1) (Eingabe)

Ein ganzzahliger Wert. Der Wert 1 zeigt an, dass der Caller möchte, dass die Steuerung sofort zurückgegeben wird, selbst wenn die Anforderungslänge noch nicht bekannt ist. Wenn "async" auf 0 gesetzt wird, wartet der Aufruf auf den Empfang einer Anforderung von WebSphere Application Server.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (API BBOA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor diese API verwendet wird.
Rückkehr- und Ursachencodes:
Tabelle 18. Rückkehr- und Ursachencodes der APIs BBOA1RCS und BBGA1RCS. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  10 Die Verbindungskennung ist freigegeben oder hat einen anderen ungültigen Status. Stellen Sie sicher, dass eine gültige Verbindungskennung übergeben wird.
  11 Es wurden ungültige Daten von WebSphere Application Server gesendet.  
  16 Die Länge des Anforderungsservicenamens ist nicht gültig. Korrigieren Sie das Programm, und wiederholen Sie den Aufruf.
  19 Es ist ein Datenfehler in der lokalen Kommunikation aufgetreten.  
  21 Es ist ein Fehler bei der Vorschau der Daten in der lokalen Kommunikation aufgetreten.  
  28 Die Registrierung, der die Verbindungskennung zugeordnet war, ist nicht mehr aktiv. Wiederholen Sie den Aufruf mit dem Registrierungsnamen, bevor Sie die APIs "Verbindung abrufen" und "Anforderung in bestimmter Verbindung empfangen" aufrufen.
  36 Der Verbindungsstatus ist nicht gültig. Eine Verbindungskennung, die für diese Anforderung verwendet wird, hat den falschen Status. Die Regeln für Verbindungsstatus sind in der API-Dokumentation beschrieben.
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für diese Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  46 Es ist ein Fehler im Aufruf zum Senden der Anforderung in der lokalen Kommunikation aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  76 Ein Versuch, mit dem Server zu kommunizieren, ist fehlgeschlagen, weil der Server nicht mehr aktiv ist. Starten Sie den Server, und wiederholen Sie den Kommunikationsversuch.
  78 Es ist ein interner Fehler aufgetreten, der zur Folge hatte, dass die Verbindung eine Anforderung ausgewählt hat, die nicht Teil der von dieser Verbindung auszuführenden Transaktion war. Gibt die Verbindung an den Verbindungspool zurück. Sollte der Fehler weiterhin auftreten, wenden Sie sich an den IBM Support.
  80 Die Transaktion, die in dieser Verbindung aktiv ist, hat ein Zeitlimit überschritten, und der Verbindungsstatus konnte nicht zurückgesetzt werden. Es wird eine andere Anforderung verarbeitet. Gibt die Verbindung an den Verbindungspool zurück. Sollte der Fehler weiterhin auftreten, wenden Sie sich an den IBM Support.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Vorgang.
  14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG) hat den Verbindungspool ungültig gemacht.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  44 "CP build" für Serviceaufruf ungültig.  
  46 "CP get" für Serviceaufruf ungültig.  
  48 "CP free" für Serviceaufruf ungültig.  
  60 SRVQ-Sperre kann nicht abgerufen werden.  
  62 SRVQ-Sperre kann nicht freigegeben werden.  
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Antwortlänge abrufen

Die API "Antwortlänge abrufen" wird verwendet, um die Länge der Antwortdaten aus einem vorherigen Aufruf der API "Anforderung senden" abzurufen.
Tabelle 19. Syntax der APIs BBOA1RCL (31-Bit-Caller) und BBGA1RCL (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1RCL oder BBGA1RCL

BBOA1RCL ( connectionhandle, async(0|1), responsedatalen, rc, rsn )

BBGA1RCL ( connectionhandle, async(0|1), responsedatalen, rc, rsn )

Parameter:

connectionhandle (Eingabe)

Eine 12-Byte-Verbindungskennung, die für diese Anforderung verwendet werden soll.

async (Eingabe)

Ein ganzzahliger Wert. Der Wert 1 zeigt an, dass der Caller möchte, dass die Steuerung sofort zurückgegeben wird, selbst wenn die Antwortlänge noch nicht bekannt ist. Wenn "async" auf 0 gesetzt wird, wartet dieser Aufruf auf die Rückgabe der Antwort von WebSphere Application Server mit der Antwortlänge im Wert des Parameters responsedatalen.

responsedatalen (Ausgabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der empfangenen Daten enthält. Diese Länge kann anschließend vom Caller verwendet werden, um Speicher anzufordern, bevor die API "Daten abrufen" aufgerufen wird, um die Daten zu kopieren. Wenn "async" auf 1 gesetzt ist, ist es möglich, dass nur FFs zurückgegeben werden, wenn die Antwortdaten noch nicht empfangen wurden.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (API BBOA1REG oder BBGA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor diese API verwendet wird.
  • Stellen Sie sicher, dass ein Aufruf zum Abrufen einer Verbindung (API BBOA1CNG oder BBGA1CNG) erfolgreich abgeschlossen wurde und die Kennung als Eingabe in diesem Aufruf angegeben wird.
  • Stellen Sie sicher, dass ein Aufruf zum Senden einer Anforderung (API BBOA1SRQ oder BBGA1SRQ) erfolgreich abgeschlossen wurde, bevor Sie diesen Abruf absetzen.
Rückkehr- und Ursachencodes:
Tabelle 20. Rückkehr- und Ursachencodes der APIs BBOA1RCL und BBGA1RCL. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  11 Es wurden ungültige Daten von WebSphere Application Server gesendet.  
  19 Es ist ein Datenfehler in der lokalen Kommunikation aufgetreten.  
  21 Es ist ein Fehler bei der Vorschau der Daten in der lokalen Kommunikation aufgetreten.  
  34 Der Zielservice wurde nicht gefunden. Stellen Sie sicher, dass die Anwendung, die die Ziel-Enterprise-Bean enthält, installiert und in der Zielumgebung von WebSphere Application Server gestartet ist.
  36 Der Verbindungsstatus ist nicht gültig. Eine Verbindungskennung, die für diese Anforderung verwendet wird, hat den falschen Status. Die Regeln für Verbindungsstatus sind in der API-Dokumentation beschrieben.
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für diese Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Vorgang.
  14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG) hat den Verbindungspool ungültig gemacht.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Nachrichtendaten abrufen

Diese API wird verwendet, um empfangene Nachrichtendaten zu kopieren. Nach der Rückkehr von diesem Aufruf wird die Nachricht aus dem Nachrichtencache des Adapters entfernt.
Tabelle 21. Syntax der APIs BBOA1GET (31-Bit-Caller) und BBGA1GET (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1GET oder BBGA1GET

BBOA1GET ( connectionhandle, msgdata, msgdatalen, rc, rsn, rv )

BBGA1GET ( connectionhandle, msgdata, msgdatalen, rc, rsn, rv )

Parameter:

connectionhandle (Eingabe)

Eine 12-Byte-Verbindungskennung, die für diese Anforderung verwendet werden soll.

msgdata (Eingabe)

Ein 31-Bit- oder 64-Bit-Zeiger auf die Startadresse des Datenbereichs, in den die Daten kopiert werden sollen. Der Speicher, auf den gezeigt wird, muss in einem Schlüssel enthalten sein, auf den der Caller Schreibzugriff hat.

msgdatalen (Eingabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der zu kopierenden Daten enthält.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

rv (Ausgabe)

Ein ganzzahliger 32-Bit-Rückgabewert, der die Größe des Kontextpuffers für diese Anforderung enthält.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (API BBOA1REG oder BBGA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor die API "Anforderung senden" verwendet wird.
  • Stellen Sie sicher, dass ein Aufruf zum Abrufen einer Verbindung (API BBOA1CNG oder BBGA1CNG) erfolgreich abgeschlossen wurde und die Kennung für diese Verbindung als Eingabe in diesem Aufruf angegeben wird.
  • Wenn der Eingabeparameter msgdatalen des API-Callers höher ist als die Größe der tatsächlichen Nachrichtenantwort, enthält der Rückkehrcode eine 0 (null), und die tatsächliche Nachrichtenlänge wird im Rückgabewert bereitgestellt.
  • Wichtig: Wenn der Aufruf der API "Nachrichtendaten abrufen" an den Caller zurückgegeben wird, werden die Nachrichtendaten nicht persistent gespeichert, und die Verbindung wird in einen Zustand zurückversetzt, in dem sie für einen weiteren Aufruf zum Senden oder Empfangen einer Anforderung verwendet werden kann. Ein nachfolgender Aufruf zum Abrufen von Datendaten oder Empfangen der Antwortlänge wird mit einem Fehler zurückgegeben.
Rückkehr- und Ursachencodes:
Tabelle 22. Rückkehr- und Ursachencodes der APIs BBOA1GET und BBGA1GET. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  36 Der Verbindungsstatus ist nicht gültig. Eine Verbindungskennung, die für diese Anforderung verwendet wird, hat den falschen Status. Die Regeln für Verbindungsstatus sind in der API-Dokumentation beschrieben.
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für diese Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  48 Bei der Leseanforderungen in der lokalen Kommunikation ist ein Fehler aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  50 Die Verbindung mit WebSphere Application Server ist beendet. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  72 Der Eingabeparameter für die Antwortlänge ist für die Antwortnachricht nicht ausreichend. Es wird nur ein Teil der Nachricht zurückgegeben. Der Rest wird verworfen. Sehen Sie sich den Rückgabewert für die Größe der Antwortnachricht an.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
  98 Der Zugriff auf den Anfang des bereitgestellten Anforderungspuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Anforderungspuffers korrekt sind.
  100 Der Zugriff auf das Ende des bereitgestellten Anforderungspuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Anforderungspuffers korrekt sind.
  102 Der Zugriff auf den Anfang des bereitgestellten Antwortpuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Antwortpuffers korrekt sind.
  104 Der Zugriff auf das Ende des bereitgestellten Antwortpuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Antwortpuffers korrekt sind.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Aufruf.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Vorgang.
  14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG) hat den Verbindungspool ungültig gemacht.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Aufrufen

Diese API verwendet andere zugrunde liegende einfache API-Funktionen, um eine Methode in einem lokalen WebSphere Application Server aufzurufen. Sie ist für die Verwendung in Situationen bestimmt, in denen die maximale Größe des Antwortausgabebereichs im Voraus bekannt ist.
Tabelle 23. Syntax der APIs BBOA1INV (31-Bit-Caller) und BBGA1INV (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1INV oder BBGA1INV

BBOA1INV ( registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv )

BBGA1INV ( registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv )

Parameter:

registername (Eingabe)

Eine Eintragsvariable oder Eintragskonstante, die den Namen enthält, der zum Suchen des Verbindungspools verwendet wird, aus dem eine Verbindung für diesen Aufruf abgerufen werden soll. Dieser Name muss eine mit Leerzeichen aufgefüllte Zeichenfolge mit genau 12 Zeichen sein.

requesttype (Eingabe)

Eine ganze Zahl, die den Anforderungstyp, d. h. den Typ der zu verarbeitenden Arbeitsanforderung, angibt. Folgende Typwerte werden unterstützt: 1 = Lokale EJB-Arbeitsanforderungen, 2 = Ferne EJB-Arbeitsanforderungen.

requestservicename (Eingabe)

Eine EBCDIC-Zeichenfolge von maximal 256 Byte Länge, die den Namen des zu startenden Service enthält. Für Type=1 (EJB) ist dies der Name der JNDI-Home-Schnittstelle für das Ziel.

requestservicenamel (Eingabe)

Eine ganze Zahl, die die Länge des zu startenden Service oder 0 (null) enthält, falls der Servicename auf null endet.

requestdata (Eingabe)

Ein 31-Bit- oder 64-Bit-Zeiger auf die Startadresse der zu sendenden Anforderungsdaten.

requestdatalen (Eingabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der zu sendenden Daten enthält.

responsedata (Eingabe)

Ein 31-Bit- oder 64-Bit-Zeiger auf die Startadresse des Antwortdatenbereichs, in den die Daten kopiert werden sollen. Der Speicher, auf den gezeigt wird, muss in einem Schlüssel enthalten sein, auf den der Caller Schreibzugriff hat.

responsedatalen (Eingabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge der zu sendenden Daten enthält.

waittime (Eingabe)

Eine ganze Zahl, die angibt, wie lange (in Sekunden) auf den Abschluss der Verbindung gewartet werden soll, bevor ein Ursachencode für nicht verfügbare Verbindung zurückgegeben wird. Der Wert 0 (null) impliziert, dass es kein Zeitlimit gibt und dass die API unbegrenzt warten soll.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

rv (Ausgabe)

Ein ganzzahliger 32-Bit-Rückgabewert, der die Größe der Nachrichtendaten enthält, die empfangen und in den Antwortbereich des Callers kopiert wurden.

Hinweise:
  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (API BBOA1REG oder BBGA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor die API "Anforderung senden" verwendet wird.
  • Wenn der Eingabeparameter responsedatalen des API-Callers höher ist als die Größe der tatsächlichen Nachrichtenantwort, enthält der Rückkehrcode eine 0 (null), und die tatsächliche Nachrichtenlänge wird im Rückgabewert bereitgestellt.
Rückkehr- und Ursachencodes:
Tabelle 24. Rückkehr- und Ursachencodes der APIs BBOA1INV und BBGA1INV. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  10 Die Verbindung ist nicht verfügbar. Die Wartezeit ist abgelaufen, bevor die Verbindungsanforderung abgerufen werden konnte. Das Anwendungsverhalten variiert. Warten und wiederholen Sie die Operation, oder akzeptieren Sie diesen fehlgeschlagenen Aufruf der API "Aufrufen". Eine andere Option ist die Erhöhung des Werts der Einstellung für die maximale Verbindungsanzahl im Aufruf der API "Registrieren".
  11 Es wurden ungültige Daten von WebSphere Application Server gesendet.  
  14 Beim Speichern der Nachricht ist eine abnormale Speicherbedingung eingetreten. Es ist nicht genügend Speicher verfügbar, damit die API "Aufrufen" die Nachricht verarbeiten kann. Der aktuelle Adressraum liegt außerhalb des privaten Speichers.
  16 Die Länge des Anforderungsservicenamens ist nicht gültig. Korrigieren Sie das Programm, und wiederholen Sie den Aufruf.
  18 Die Antwortlänge überschreitet die Systemgrenzwerte. Die Wert für die Nachrichtenlänge ist zu hoch und wird von WebSphere Application Server nicht unterstützt. Vergewissern Sie sich, dass die Größe gültig ist. Wenn die Größe gültig ist, stellen Sie sicher, dass die Größe in WebSphere Application Server für die Nachricht ausreicht.
  19 Es ist ein Datenfehler in der lokalen Kommunikation aufgetreten.  
  21 Es ist ein Fehler bei der Vorschau der Daten in der lokalen Kommunikation aufgetreten.  
24 Nach einem erfolgreichen Registrierungsaufruf ist ein Fehler beim Abrufen einer Verbindung aus dem Pool aufgetreten. Stellen Sie sicher, dass der Server gestartet ist. Wenn dies nicht funktioniert, starten Sie den Server erneut, und wiederholen Sie die API-Anforderung.
  26 Die globale Transaktion konnte nicht gestartet werden.  
  28 Die Registrierung wurde zwar gefunden, aber sie ist inaktiv.  
  32 Der Anforderungstyp im API-Aufruf ist nicht gültig. Der Parameter für den Anforderungstyp ist nicht gültig. Korrigieren Sie das Programm, und wiederholen Sie den Aufruf.
  34 Der Zielservice wurde nicht gefunden. Stellen Sie sicher, dass die Anwendung, die die Ziel-Enterprise-Bean enthält, installiert und in der Zielumgebung von WebSphere Application Server gestartet ist.
  36 Der Verbindungsstatus ist nicht gültig. Eine Verbindungskennung, die für diese Anforderung verwendet wird, hat den falschen Status. Die Regeln für Verbindungsstatus sind in der API-Dokumentation beschrieben.
  38 Die Clientverbindungskennung ist nicht gültig. Die Clientverbindungskennung, die für diese Anforderung verwendet wird, ist nicht gültig. Informationen zu Clientverbindungskennungen finden Sie in der API-Dokumentation.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  44 Es ist eine Ausnahme oder unerwartete Bedingung in der Ziel-Enterprise-Bean eingetreten. Suchen Sie in den Protokollen von WebSphere Application Server nach den Ausnahmedaten.
  46 Es ist ein Fehler im Aufruf zum Senden der Anforderung in der lokalen Kommunikation aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  48 Bei der Leseanforderungen in der lokalen Kommunikation ist ein Fehler aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  50 Die Verbindung mit WebSphere Application Server ist beendet. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  72 Der Eingabeparameter für die Antwortlänge ist für die Antwortnachricht nicht ausreichend. Es wird nur ein Teil der Nachricht zurückgegeben. Der Rest wird verworfen. Sehen Sie sich den Rückgabewert für die Größe der Antwortnachricht an.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
  98 Der Zugriff auf den Anfang des bereitgestellten Anforderungspuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Anforderungspuffers korrekt sind.
  100 Der Zugriff auf das Ende des bereitgestellten Anforderungspuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Anforderungspuffers korrekt sind.
  102 Der Zugriff auf den Anfang des bereitgestellten Antwortpuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Antwortpuffers korrekt sind.
  104 Der Zugriff auf das Ende des bereitgestellten Antwortpuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Antwortpuffers korrekt sind.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Vorgang.
  14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG) hat den Verbindungspool ungültig gemacht.
  24 Nach einem erfolgreichen Registrierungsaufruf ist ein Fehler beim Abrufen einer Verbindung aus dem Verbindungspool aufgetreten. Stellen Sie sicher, dass der Server gestartet ist. Wenn dies nicht funktioniert, starten Sie den Server erneut, und wiederholen Sie die API-Anforderung.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

Host-Service

Host-Service für einen lokalen WebSphere Application Server. Diese API verwendet andere zugrunde liegende einfache API-Funktionen, um ein z/OS-Programm in einer nativen Programmiersprache als Server und Ziel für Aufrufe optimierter lokaler Adapter über einen lokalen WebSphere Application Server zu konfigurieren. Sie ist für die Verwendung in Situationen bestimmt, in denen die maximale Größe des Anforderungsbereichs im Voraus bekannt ist.
Tabelle 25. Syntax der APIs BBOA1SRV (31-Bit-Caller) und BBGA1SRV (64-Bit-Caller) . Die Syntax wird im Abschnitt "Parameter" beschrieben.
API Syntax
BBOA1SRV oder BBGA1SRV

BBOA1SRV ( registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv )

BBGA1SRV ( registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv )

Parameter:

registername (Eingabe)

Eine Eintragsvariable oder Eintragskonstante, die den Namen enthält, der zum Suchen des Verbindungspools verwendet wird, aus dem eine Verbindung für diesen Aufruf abgerufen werden soll. Dieser Name muss eine mit Leerzeichen aufgefüllte Zeichenfolge mit genau 12 Zeichen sein.

requestservicename (Eingabe/Ausgabe)

Eine EBCDIC-Zeichenfolge mit bis zu 256 Bytes, die den Namen des Service enthält. Dies ist der Name des Zielservice, der im Parameter "InteractionSpec" von der WebSphere Application Server-Anwendung angegeben wird. Der Wert * (Stern) zeigt an, dass ein Server für alle Servicenamen konfiguriert wurde, die unter dem aktuellen registrierten Namen eingehen.

requestservicenamel (Eingabe/Ausgabe)

Eine ganze Zahl, die die Länge des zu startenden Service oder 0 (null) enthält, falls der Servicename auf null endet.

requestdata (Eingabe)

Ein 31-Bit- oder 64-Bit-Zeiger auf die Startadresse der zu sendenden Anforderungsdaten. Der Speicher, auf den gezeigt wird, muss in einem Schlüssel enthalten sein, auf den der Caller Schreibzugriff hat.

requestdatalen (Eingabe)

Ein 32-Bit-Wert ohne Vorzeichen im 31-Bit-Modus bzw. ein 64-Bit-Wert ohne Vorzeichen im 64-Bit-Modus, der die Länge des Datenbereichs enthält, in dem die Nachricht empfangen werden soll.

connectionhandle (Ausgabe)

Eine 12-Byte-Verbindungskennung, die an den Caller zurückgegeben und dazu verwendet wird, um eine Antwort auf diese Anforderung zu senden.

waittime (Eingabe)

Eine ganze Zahl, die angibt, wie lange (in Sekunden) auf den Abschluss der Verbindung gewartet werden soll, bevor ein Ursachencode für nicht verfügbare Verbindung zurückgegeben wird. Der Wert 0 (null) impliziert, dass es kein Zeitlimit gibt und dass die API unbegrenzt warten soll.

rc (Ausgabe)

Ein ganzzahliger Rückkehrcode, der den Erfolg oder Misserfolg dieses Aufrufs anzeigt.

rsn (Ausgabe)

Ein ganzzahliger Ursachencode, der die Ursache für einen Fehler in diesem Aufruf beschreibt.

rv (Ausgabe)

Ein ganzzahliger 32-Bit-Rückgabewert, der die Größe der Nachrichtenanforderungsdaten enthält, die empfangen und in den Bereich des Callers kopiert wurden.

Verwendungshinweise

  • Stellen Sie sicher, dass die Dämongruppe und der Server von WebSphere Application Server for z/OS, die in diesem Aufruf angegeben sind, gestartet sind und die Unterstützung für lokale Adapter aktiviert ist.
  • Stellen Sie sicher, dass ein Registrierungsaufruf (API BBOA1REG oder BBGA1REG) im aktuellen Adressraum mit einem übereinstimmenden Namen erfolgreich abgeschlossen wurde, bevor diese API verwendet wird.
  • Wenn der Eingabeparameter requestdatalen des API-Callers höher ist als die Größe der tatsächlichen Nachrichtenantwort, enthält der Rückkehrcode eine 0 (null), und die tatsächliche Nachrichtenlänge wird im Rückgabewert bereitgestellt.
  • Die zurückgegebene Verbindungskennung muss in jeder Antwort für diesen Hostaufruf über die API BBOA1SRP oder BBGA1SRP angegeben werden. In allen nachfolgenden Aufrufen der API BBOA1SRP oder BBGA1SRP wird dieselbe Verbindungskennung wiederverwendet. In diesem Fall geht die API davon aus, dass es keine Antwort für die vorherige Anforderung gibt.
  • Wichtig: Wenn der Aufruf von "Host-Service" zum Caller zurückkehrt, werden die Nachrichtendaten nicht persistent gespeichert, und die Verbindung wird in einen Zustand zurückversetzt, in dem Sie für eine weitere API-Anforderung verwendet werden kann.
Rückkehr- und Ursachencodes:
Tabelle 26. Rückkehr- und Ursachencodes der APIs BBOA1SRV und BBGA1SRV. In der folgenden Tabelle werden entsprechende Aktionen empfohlen.
Rückkehrcode Ursachencode Beschreibung Aktion
0 - Erfolg  
4 - Warnung, siehe Ursachencode  
8 - Fehler, siehe Ursachencode  
  8 Das Token für den Registrierungsnamen ist bereits vorhanden. Stellen Sie sicher, dass der übergebene Registrierungsname gültig ist.
  10 Die Verbindungskennung ist freigegeben. Stellen Sie sicher, dass eine richtige Verbindungskennung übergeben wird.
  12 Die Verbindungskennung ist nicht in der Verbindung enthalten, die im Registrierungsnamen angegeben ist. Korrigieren Sie das Programm, und wiederholen Sie den Aufruf.
  16 Die Länge des Anforderungsservicenamens ist nicht gültig. Korrigieren Sie das Programm, und wiederholen Sie den Aufruf.
  18 Die Antwortlänge überschreitet die Systemgrenzwerte. Die Wert für die Nachrichtenlänge ist zu hoch und wird von WebSphere Application Server nicht unterstützt. Vergewissern Sie sich, dass die Größe gültig ist. Wenn die Größe gültig ist, stellen Sie sicher, dass die Größe in WebSphere Application Server für die Nachricht ausreicht.
  40 Es ist ein lokaler Kommunikationsfehler aufgetreten. Suchen Sie im Serverprotokoll von WebSphere Application Server nach Fehlernachrichten zur lokalen Kommunikation.
  46 Es ist ein Fehler im Aufruf zum Senden der Anforderung in der lokalen Kommunikation aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  48 Bei der Leseanforderungen in der lokalen Kommunikation ist ein Fehler aufgetreten. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  50 Die Verbindung mit WebSphere Application Server ist beendet. Bestimmen Sie den Fehler anhand der Protokolle von WebSphere Application Server.
  72 Der Eingabeparameter für die Antwortlänge ist für die Antwortnachricht nicht ausreichend. Es wird nur ein Teil der Nachricht zurückgegeben. Der Rest wird verworfen. Sehen Sie sich den Rückgabewert für die Größe der Antwortnachricht an.
  76 Ein Versuch, mit dem Server zu kommunizieren, ist fehlgeschlagen, weil der Server nicht mehr aktiv ist. Starten Sie den Server, und wiederholen Sie den Kommunikationsversuch.
  96 Diese API kann während der IMS-Initialisierung oder während eines Exits bei der IMS-Vorinitialisierung nicht ausgeführt werden. Rufen Sie diese API auf, nachdem die IMS-Initialisierung abgeschlossen ist.
  98 Der Zugriff auf den Anfang des bereitgestellten Anforderungspuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Anforderungspuffers korrekt sind.
  100 Der Zugriff auf das Ende des bereitgestellten Anforderungspuffers war nicht möglich. Vergewissern Sie sich, dass die Adresse und die Länge des bereitgestellten Anforderungspuffers korrekt sind.
12 10 Die Dämongruppe oder der Server von WebSphere Application Server wurde nicht gefunden. Stellen Sie sicher, dass der Dämon und der Server von WebSphere Application Server gestartet sind und dass die Unterstützung lokaler Verbindungen aktiv ist. Wiederholen Sie anschließend den Aufruf.
  14 Der API-Aufrufvektor, der die bereitgestellte Verbindungskennung verwendet, kann nicht gefunden oder verifiziert werden. Die Verbindungskennung ist nicht gültig, oder ein Aufruf zur Rücknahme der Registrierung (API BBOA1URG oder BBGA1URG) hat den Verbindungspool ungültig gemacht.
  34 Ein 64-Bit-API-Stub wurde in einer IMS-Umgebung verwendet. Die 64-Bit-APIs werden unter IMS nicht unterstützt.
  38 Ein 64-Bit-API-Stub wurde in einer CICS-Umgebung verwendet. Die 64-Bit-APIs werden unter CICS nicht unterstützt.
  44 "CP build" für Serviceaufruf ungültig.  
  46 "CP get" für Serviceaufruf ungültig.  
  48 "CP free" für Serviceaufruf ungültig.  
  60 SRVQ-Sperre kann nicht abgerufen werden.  
  62 SRVQ-Sperre kann nicht freigegeben werden.  
  86 Master-BGVT von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. WebSphere wurde noch nicht im aktuellen z/OS-Systemimage gestartet. Vergewissern Sie sich, bevor Sie einen WebSphere Application Server-OLA-Clientprozess starten, dass der Dämon und ein Knoten/Server gestartet wurden.
  88 Tabelle des Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.
  90 Tabellenbereich des OLA-Master-Client-Stubs von WebSphere Application Server for z/OS konnte nicht lokalisiert werden. Im aktuellen z/OS-Systemimage wurde ein WebSphere Application Server gestartet, der jedoch nicht mit der Version ausgeführt wird, die die Tabelle des OLA-Client-Stubs unterstützt. Möglicherweise verwenden Sie eine OLA-Stubschnittstelle von WebSphere Application Server Version 8.0.0.1, die nicht mit der Wartungsstufe des Anwendungsservers kompatibel ist. Wenn Sie die OLA-Stubs der Version 8.0.0.1 verwenden möchten, muss der Anwendungsserver auch in WebSphere Application Server Version 8.0.0 ausgeführt werden. Vergewissern Sie sich, dass Ihre Anwendung mit der OLA-Stubversion ausgeführt wird, die mit WebSphere Application Server auf diesem z/OS-System kompatibel ist.

JCA-Adapter-APIs

Für Aufrufe von WebSphere Application Server an ein Stapelverarbeitungsprogramm oder ein Subsystem verwendet die WebSphere Application Server-Anwendung die Standard-JCA-APIs. Die Objekte, die für diesen Adapter angepasst werden, sind im Folgenden aufgelistet:
  • ConnectionSpec
  • InteractionSpec
  • Record I/O
Weitere Informationen zu diesen Standard-JCA-APIs finden Sie unter den zugehörigen Links im Information Center.

De API "ConnectionSpec" wird verwendet, um den Registrierungsnamen anzugeben, mit dem die Kommunikation erfolgen soll. Der Registrierungsname wird verwendet, wenn die API "Registrieren" verwendet wird. Dieser Name gibt auch an, zu welchem Subsystem die Verbindung hergestellt werden soll. Ein Subsystem kann mehrere Registrierungsname haben.

Der Name der Program-Link-Transaktions-ID kann von WebSphere Application Server an CICS übergeben werden und wird zum Ausführen der Program-Link-Aufruftask verwendet. Er muss 4 Zeichen lang und in der CICS-Region definiert sein. Sie müssen den Namen mit denselben Attributen und demselben Programmnamen wie die BBO#-Transaktion (Programm: BBOACLNK) konfigurieren. Wenn diese Transaktions-ID mit der Methode "setLinkTaskTranid" übergeben wird, überschreibt sie die BBO#-API und jede Transaktions-ID, die mit BBOC und dem Parameter "LTX=xxx" angegeben wurde.

Sie können die Methode "setUseCICSContainer" oder die JCA-Schnittstelle "MappedRecord" verwenden, um Anwendungen über Kanäle und Container an CICS zu senden.

  • In der API "ConnectionSpecImpl" wird die Methode "setUseCICSContainer" bereitgestellt. Wenn diese auf 1 gesetzt ist, können der Name und der Typ eines CICS-Containers für Nachrichtenanforderungen an CICS mit den Methoden "setLinkTaskReqContid()" und "setLinkTaskReqContType(0|1)" übergeben werden, wobei 0=CHAR und 1=BIT ist. Wenn der CICS-Container der Nachrichtenanforderung an CICS übergeben wird, hat das Zielprogramm eigene Eingabedaten, die im angegebenen Container übergeben werden, der mit dem ausgewählten Typ (BIT oder CHAR) erstellt wird.

    Der Name und der Typ des CICS-Containers für Nachrichtenantworten können mit den Methoden "setLinkTaskRspContid()" und "setLinkTaskRspContType(bit|char)" an CICS übergeben werden. In diesem Fall wird erwartet, dass die Antwort des Zielprogramms aus dem angegebenen Container mit dem ausgewählten Typ (BIT oder CHAR) kommt.

  • Die JCA-Schnittstelle "MappedRecord" kann verwendet werden, um einen oder mehrere Container an CICS zu übergeben. Wenn Sie die JCA-Schnittstelle "MappedRecord" verwenden, wird der angegebene Kanal für die Kommunikation mit dem Zielprogramm verwendet. Wenn Sie die Schnittstelle "MappedRecord" verwenden, müssen Sie UseCICSContainer auf 1 setzen und der Name und der Typ eines CICS-Kanals müssen mit den Methoden setLinkTaskChanID() und setLinkTaskChanType(bit|char) an CICS übergeben werden.
    Fehler vermeiden Fehler vermeiden: Die JCA-Schnittstelle "MappedRecord", die verwendet wird, um Container an CICS zu übergeben, wird durch Aufrufen der Methode recordFactory.createMappedRecord() abgerufen, wobei die recordFactory aus dem WOLA-Verbindungsobjekt verwendet wird. Verwenden Sie die Methode setLinkTaskReqContId(), setLinkTaskReqContType(), setLinkTaskRspContId() oder SetLinkTaskRspContType() nicht mit der JCA-Schnittstelle "MappedRecord".gotcha

Für IMS-Anwendungstransaktionen verwenden Sie die Methode "setOTMAMaxRecvSize(nnn)" in der Verbindungsspezifikation, um die maximale Empfangsgröße für Nachrichten festzulegen. Verwenden Sie zum Festlegen der maximalen Segmentanzahl auf Verbindungsebene die Methode "setOTMAMaxSegments(nnn)" in der Verbindungsspezifikation. Weitere Informationen zur Verwendung optimierter lokaler Adapter mit IMS über OTMA finden Sie im Artikel "Vorhandene IMS-Transaktionen mit optimierten lokalen Adaptern über OTMA aufrufen".

InteractionSpec

Die API "InteractionSpec" wird verwendet, um den vom Ziel zu startenden Service anzugeben. Dies ist abhängig davon, welches Subsubsystem oder welcher Stapelprozess gestartet wird. Der Prozess kann Anforderungen für einen bestimmten Service oder für jeden Service empfangen. Für CICS muss der Servicename der Name des in CICS auszuführenden Programms sein.

Record I/O

Anwendungen können für das Übergeben von Daten an den Adapter und für das Empfangen von Daten vom Adapter die JCA-Record-Schnittstelle verwenden. Diese Adapter-API schlägt die Verwendung der indexierten Datensatzschnittstelle für, um dem Caller zu ermöglichen, eine oder mehrere Datenstrukturen, einschließlich Cobol-Copybooks und C-Strukturen, an den externen Adressraum zu übergeben. Jeder Index in der Liste wird als separates Copybook verwendet und in der angegebenen Reihenfolge an das Ziel übergeben.

Wenn die Schnittstelle verwendet wird, um Rückgabeparameter von einem Funktionsaufruf zu akzeptieren, kann IndexedRecordImpl so vordefiniert werden, dass eine bestimmte Anzahl an Parametern akzeptiert wird, und die Klassennamen, die von Assembliertools für die einzelnen Copybooks und Strukturen generiert werden, können angegeben werden. Die Schnittstelle "IndexedRecordImpl" dekomprimiert die serialisierten Copybooks und Strukturen und definiert sie in der Schnittstelle "IndexedRecordImpl", sodass sie abgerufen und verwendet werden können, ohne die serialisierten byte[]-Darstellungen verarbeiten zu müssen.

Damit Sie eine Vorstellung davon bekommen, wie diese API funktioniert, werden nur ausgewählte Methoden gezeigt. Es werden alle Methoden in der Schnittstelle implementiert.


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_olaapis
Dateiname:cdat_olaapis.html