[z/OS]

Optimierte lokale Adapter für die Verbindungsherstellung zu einer Anwendung in einem externen Adressraum über eine WebSphere-Anwendung verwenden

Verwenden Sie diese Task, wenn Sie die abgehenden APIs verwenden möchten, um eine Verbindung zu einem externen Adressraum über eine Anwendung herzustellen, die in WebSphere Application Server for z/OS implementiert ist.

Vorbereitende Schritte

Die Dämongruppe, der Adressraum und der externe Adressraum müssen für die Verwendung der APIs für optimierte lokale Adapter konfiguriert werden. Der externe Adressraum muss durch den Aufruf der API BBOA1REG bei der Dämongruppe registriert werden.

Die Anwendung, die im externen Adressraum ausgeführt wird, muss sich über eine der APIs (BBOA1SRV, BBOA1RCA oder BBOA1RCS) Server-Task für die optimierten lokalen Adapter einrichten.

Die RAR-Datei für die optimierten lokalen Adapter "ola.rar" wird über die Administrationskonsole von WebSphere Application Server oder mit dem Script olaRar.py implementiert und konfiguriert.

Vorgehensweise

  1. Suchen Sie den Anwendungsimplementierungsdeskriptor in der Anwendung, die den externen Aufruf absetzt. Dies ist die Anwendung, die in WebSphere Application Server implementiert ist und über die Sie einen abgehenden Aufruf absetzen möchten.
  2. Erstellen Sie eine Ressourcenreferenz, die auf die Verbindungsfactory für die optimierten lokalen Adapter zeigt. Die Verbindungsfactory für die optimierten lokalen Adapter wird erstellt, wenn die Datei ola.rar in WebSphere Application Server installiert wird.
  3. Suchen Sie die Verbindungsfactory für die optimierten lokalen Adapter. Suchen Sie dazu die Ressourcenreferenz im Java™ Naming Directory Interface (JNDI), z. B.:
    Context ctx = new InitialContext();
    ConnectionFactory cf = ctx.lookup("java:comp/env/ola");
  4. Erstellen Sie einen ConnectionSpecImpl-Methodenaufruf, und geben Sie den Registrierungsnamen an, zu dem eine Verbindung hergestellt werden soll. Sie können den Namen "Register" als Attribut in der verwalteten Verbindungsfactory oder die ConnectionSpecImpl-Methode "setRegisterName" verwenden, um den Registrierungsnamen für die Anwendung anzugeben, die in dem externen Adressraum oder Subsystem ausgeführt wird, zu dem Sie eine Verbindung herstellen möchten. Dies muss derselbe Registrierungsname sein, der von der Anwendung im externen Adressraum bzw. Subsystem über eine der APIs (BBOA1SRV, BBOA1RCA oder BBOA1RCS) für die optimierten lokalen Adapter angegeben wurde. Beispiel:
    ConnectionSpecImpl csi = new ConnectionSpecImpl();
    csi.setRegisterName ("MyRES1");
    Achtung: Die Definition des Registrierungsnamens im ConnectionSpecImpl-Objekt ist nicht erforderlich, wenn der Registrierungsname mit der angepassten Eigenschaft "RegisterName" im ConnectionFactory-Objekt angegeben wurde.
    Achtung: Wenn Sie das Feature für hohe Verfügbarkeit des Ressourcenadapters verwenden möchten, müssen Sie sicherstellen, dass Ihr Anwendung nicht die Methode "setRegisterName" verwendet. Stattdessen müssen Sie Sie den Zielregisternamen in den Verbindungsfactory-Attributen der verwalteten Verbindung konfigurieren. Weitere Informationen zum Konfigurieren der hohen Verfügbarkeit finden Sie im Artikel "Unterstützung der hohen Verfügbarkeit im Ressourcenadapter aktivieren".
  5. Optional: Wenn Sie eine IMS-Transaktion (Information Management System) aufrufen, die die Server-APIs (BBOA1SRV, BBOA1RCA oder BBOA1RCS) der optimierten lokalen Adapter nicht verwenden, führen Sie diesen Schritt aus, um die OTMA-Parameter (IMS Open Transaction Manager Access) zu definieren. Sie können den IMS-OTMA-Servernamen, die XCF-Gruppen-ID und die Transaktionsstufe als Attribute in der verwalteten Verbindungsfactory angeben oder die entsprechenden ConnectionSpecImpl-Setter-Methoden setOTMAServerName, setOTMAGroupID und setOTMATranLevel verwenden, um diese Informationen für die Anwendung anzugeben, die in dem externen Adressraum oder Subsystem ausgeführt wird, zu dem Sie eine Verbindung herstellen möchten.
    Achtung: Wenn Sie optimierte lokale Adapter über OTMA verwenden, hat der Registrierungsname keine Entsprechung auf IMS-Transaktionsseite. Der Registrierungsname kann zwar definiert werden, aber er wird nicht für OLA-Aufrufe über OTMA verwendet. Weitere Informationen finden Sie im Artikel "Vorhandene IMS-Transaktionen mit optimierten lokalen Adaptern über OTMA aufrufen".
  6. Verwenden Sie die Verbindungsfactory, um eine Verbindung zu erstellen, z. B.:
    Connection con = cf.getConnection(csi);

Ergebnisse

Ihre in WebSphere Application Server implementierte Anwendung ist jetzt mit einem externen Adressraum verbunden und bereit, Aufrufe an die Services abzusetzen, die im externen Adressraum ausgeführt werden.

Symbol, das den Typ des Artikels anzeigt. Taskartikel



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