BeanConnect for openutm V2.0

Transkript

1 BeanConnect for openutm V2.0 Ausgabe: Juli 2005

2 Kritik Anregungen Korrekturen Die Redaktion ist interessiert an Ihren Kommentaren zu diesem Handbuch. Ihre Rückmeldungen helfen uns, die Dokumentation zu optimieren und auf Ihre Wünsche und Bedürfnisse abzustimmen. Für Ihre Kommentare stehen Ihnen Fax-Formulare auf den letzten Seiten dieses Handbuchs zur Verfügung. Dort finden Sie auch die Adressen der zuständigen Redaktion. Zertifizierte Dokumentation nach DIN EN ISO 9001:2000 Um eine gleichbleibend hohe Qualität und Anwenderfreundlichkeit zu gewährleisten, wurde diese Dokumentation nach den Vorgaben eines Qualitätsmanagementsystems erstellt, welches die Forderungen der DIN EN ISO 9001:2000 erfüllt. cognitas. Gesellschaft für Technik-Dokumentation mbh Copyright und Handelsmarken Copyright Fujitsu Siemens Computers GmbH Alle Rechte vorbehalten. Liefermöglichkeiten und technische Änderungen vorbehalten. Alle verwendeten Hard- und Softwarenamen sind Handelsnamen und/oder Warenzeichen der jeweiligen Hersteller. Dieses Handbuch wurde hergestellt von cognitas. Gesellschaft für Technik-Dokumentation mbh Dieses Handbuch wurde auf chlorfrei gebleichtem Papier gedruckt.

3 Inhalt Beispiele Abbildungen 1 Einleitung Zielgruppe Aufbau der Dokumentation zu BeanConnect Struktur dieses Handbuchs Darstellungsmittel JCA-Adapter-Integration Überblick Über OC4J JCA-Adapter-Integration JCA 1.5-Kontrakte BeanConnect-Komponenten BeanConnect Resource Adapter BeanConnect Proxy BeanConnect Management Console Plattform-Unterstützung BeanConnect als JCA-konformer Resource Adapter Outbound- und Inbound-Kommunikation Outbound-Kommunikation Inbound-Kommunikation Asynchrone und dialogbasierte Kommunikation Dialogbasierte Kommunikation Asynchrone Kommunikation Transaktionale und nicht-transaktionale Kommunikation Transaktionale Kommunikation Nicht-transaktionale Kommunikation Adapter-Integration für die Kommunikation mit dem EIS-Backend Outbound-Kommunikation Inbound-Kommunikation BeanConnect für openutm 3

4 Inhalt 3 BeanConnect installieren BeanConnect unter Solaris installieren BeanConnect Resource Adapter installieren Master-Installation PCMX installieren openutm installieren Produktdateien von BeanConnect for openutm installieren BeanConnect Proxy-Container und Management Console installieren Installationsprozedur starten BeanConnect Proxy-Container installieren Management Console installieren BeanConnect unter Linux installieren BeanConnect Resource Adapter installieren Master-Installation CMX installieren openutm installieren Produktdateien von BeanConnect for openutm installieren BeanConnect Proxy-Container und die Management Console installieren Installationsprozedur starten BeanConnect Proxy-Container installieren Management Console installieren BeanConnect unter Windows installieren BeanConnect Resource Adapter installieren Master-Installation PCMX installieren openutm installieren BeanConnect installieren Installationsprozedur BeanConnect Proxy-Container installieren Die BeanConnect Management Console installieren BeanConnect Proxy-Container und Management Console installieren Installation abschließen Den BeanConnect Proxy-Container über die Befehlszeile installieren BeanConnect (nur Resource Adapter) unter HP-UX, HP Tru64 oder AIX installieren BeanConnect für openutm

5 Inhalt 3.5 Update-Installation für den BeanConnect Proxy-Container und die Management Console Update-Installation unter Solaris Update-Installation starten Update-Installationsprozedur Update-Installation unter Linux Update-Installation starten Update-Installationsprozedur Update-Installation unter Windows Update-Installation starten Update-Installationsprozedur BeanConnect deinstallieren BeanConnect unter Solaris deinstallieren BeanConnect Resource Adapter deinstallieren BeanConnect Proxy-Container deinstallieren BeanConnect Management Console deinstallieren Produktdateien von BeanConnect deinstallieren PCMX deinstallieren openutm deinstallieren BeanConnect unter Linux deinstallieren BeanConnect Resource Adapter deinstallieren BeanConnect Proxy-Container deinstallieren BeanConnect Management Console deinstallieren Produktdateien von BeanConnect deinstallieren CMX deinstallieren openutm deinstallieren BeanConnect unter Windows deinstallieren BeanConnect Resource Adapter deinstallieren BeanConnect Proxy-Container deinstallieren BeanConnect Management Console deinstallieren Produktdateien von BeanConnect deinstallieren PCMX deinstallieren openutm deinstallieren BeanConnect (nur Resource Adapter) unter HP-UX, HP Tru64 oder AIX deinstallieren BeanConnect Resource Adapter deinstallieren BeanConnect für openutm 5

6 Inhalt 4 Konfiguration im Applikations-Server (Outbound-Kommunikation über das OSI-TP-Protokoll und Inbound-Kommunikation) Deployment und Undeployment des Resource Adapters Überblick BeanConnect.rar bearbeiten Deployment der Datei BeanConnect.rar in OC4J oc4j-ra.xml bearbeiten RAR-Datei deklarieren Globale Konfigurations-Properties einstellen Deployment des Resource Adapters Undeployment Konfigurations-Properties einstellen Konfigurations-Properties für Outbound-Konfiguration einstellen Konfigurations-Properties für Inbound-Konfiguration einstellen Sicherheitseinstellungen definieren (Anmeldung verwalten) Logging für den Resource Adapter vorbereiten Beispiele Beispiel: ra.xml Beispiel: oc4j-ra.xml Deployment eines Enterprise Java Bean (EJB) für Outbound-Kommunikation Deployment eines OLTP Message-Driven Bean für Inbound-Kommunikation Konfiguration im Applikations-Server (Outbound-Kommunikation über das UPIC-Protokoll) Deployment und Undeployment des Resource Adapters Überblick Deployment der Datei BeanConnect.rar in OC4J oc4j-ra.xml bearbeiten RAR-Datei deklarieren Deployment des Resource Adapters Undeployment Konfigurations-Properties einstellen Sicherheitseinstellungen definieren (Anmeldung verwalten) Logging für den Resource Adapter vorbereiten Beispiel: oc4j-ra.xml Deployment eines Enterprise Java Bean (EJB) BeanConnect für openutm

7 Inhalt 6 BeanConnect Management Console Die Management Console starten und beenden Management Console starten Online-Hilfe der Management Console starten Management Console beenden Bedienoberfläche - Management Console-Fenster Navigationsbereich in der Management Console Verwaltete Objekte Zusätzliche Funktionen und Informationen Funktionen der BeanConnect Management Console Konfigurationsfunktionen Administrationsfunktionen Diagnoseunterstützung Todo-Aktionen Verwaltungsdaten Management Console Command Handler (MC-CmdHandler) Sicherheit und Berechtigungen MC-CmdHandler verwalten MC-CmdHandler starten Verfügbarkeit des MC-CmdHandlers prüfen MC-CmdHandler beenden BeanConnect Proxy konfigurieren Konfigurationsschritte BeanConnect Proxy zur Management Console hinzufügen Neuen Proxy hinzufügen Proxy entfernen BeanConnect Proxy konfigurieren Allgemeine Proxy-Daten Weitere Konfigurationsoptionen im Experten-Modus Timer Settings Performance Settings Beschreibung des BeanConnect Resource Adapters BeanConnect für openutm 7

8 Inhalt 7.5 EIS-Partner konfigurieren EIS-Partner hinzufügen Konfigurationsdateien für die EIS-Partner EIS-Partner entfernen Outbound-Kommunikation konfigurieren Outbound-Services konfigurieren Outbound Communication Endpoints konfigurieren Inbound-Kommunikation konfigurieren Inbound Message Endpoints konfigurieren Benutzer für den Zugriff auf Inbound Message Endpoints einrichten Konfiguration eines BeanConnect Proxys speichern und aktivieren EIS-Konfiguration Verbindungen zwischen BeanConnect und openutm definieren OSI-TP-, UPIC- und Socket- oder RFC1006-Verbindungen definieren BCMAP-Eintrag definieren (nur für BS2000/OSD-Partner) Verbindungen zwischen BeanConnect und anderen EIS-Partnern definieren BeanConnect Proxy betreiben BeanConnect Proxy mit der Management Console administrieren Starten Restart Beenden BeanConnect Proxy-Container auf Befehlsebene administrieren Proxy-Container starten Mit Skript starten Über die Programmgruppe des Proxy-Containers unter Windows starten Als Windows-Dienst starten Nach einem fehlerhaften Abbruch eines Proxy-Container-Laufs starten Restart des Proxy-Containers Restart mit Skript Restart über die Programmgruppe des Proxy-Containers unter Windows neu starten Proxy-Container beenden Mit einem lokalen Skript beenden Über die Programmgruppe des Proxy-Containers unter Windows beenden Als Windows-Dienst beenden Verfügbarkeit eines BeanConnect Proxys prüfen BeanConnect für openutm

9 Inhalt 10 Interfaces und Programmierung BeanConnect-spezifische Interfaces und das Common Client Interface (CCI) Outbound-Kommunikation programmieren BeanConnect-spezifische Interfaces für Outbound-Kommunikation Connection-Factory-Interfaces Connection-Interfaces (Übersicht) Kommunikation unter Verwendung von Connection-Interfaces Common Client Interface (CCI) für Outbound-Kommunikation Programmierinformationen zu Outbound-Kommunikation EIS-Anwendung ansprechen Aufrufe von BeanConnect in einem EJB platzieren Authentisierung (Benutzerkennung und Passwort) Informationen zur Conversation mit der EIS-Anwendung abfragen Programm-Framework für Outbound-Kommunikation Programm-Framework für BeanConnect-spezifische Interfaces Programm-Framework für Common Client Interface (CCI) Code-Beispiele für Outbound-Kommunikation Inbound-Kommunikation programmieren OLTP Message-Driven Beans Inbound-Kommunikation mit openutm-anwendungen Inbound-Kommunikation mit anderen EIS-Partnern BeanConnect-spezifische Interfaces für Inbound-Kommunikation Programmierinformationen zu OLTP Message-Driven Beans Programm-Framework mit den Interfaces AsyncOltpMessageListener und OltpMessageListener Common Client Interface (CCI) für Inbound-Kommunikation Programmierinformationen zu OLTP Message-Driven Beans (CCI) Program Framework mit dem Interface javax.resource.cci.messagelistener Code-Beispiel für Inbound-Kommunikation Codierung und Sprachunterstützung Codierung Standard-Konvertierung zwischen EBCDIC-Code und Unicode Andere vordefinierte Code-Tabellen verwenden Benutzerdefinierte Zeichensätze verwenden Legacy-Code-Tabellen erstellen und verwenden Sprachunterstützung für die Ausgabe von Meldungen BeanConnect für openutm 9

10 Inhalt 12 Hoch-Verfügbarkeit und Skalierbarkeit Shared Memory im Proxy-Container Shared Memory anpassen Anzahl der Prozesse im Proxy-Container Prozess-Auslastung anzeigen Prozess-Anzahl ändern Pagepool Area und Cache im Proxy-Container Anzahl der parallelen Verbindungen zum EIS-Partner Outbound-Kommunikation Inbound-Kommunikation Asynchrone Verarbeitung im Proxy-Container Lebensdauer von asynchronen Aufträgen Inbound-Kommunikation OSI-SCRATCH-AREA im Proxy-Container Anzahl der Semaphore im Proxy-Container Diagnose und Fehlerbehebung Überblick zum Logging des BeanConnect Resource Adapters Logging mit Log4j Grundlagen von Log4j Logger Appender Funktionsweise des Rolling File Appenders Diagnose des BeanConnect Resource Adapters Logging des BeanConnect Resource Adapters konfigurieren Logger konfigurieren Appender konfigurieren Vordefinierte Logging-Konfiguration eines Resource Adapters Log4j-Konfigurationsdatei mit der BeanConnect Management Console bearbeiten BeanConnect Management Console als Log4j-Socket-Reader konfigurieren Logging-Ereignisse auf der BeanConnect Management Console anzeigen Logging-Datei von Log4j in der BeanConnect Management Console anzeigen BeanConnect für openutm

11 Inhalt 13.4 Diagnose des BeanConnect Proxy-Containers Logging des BeanConnect Proxys konfigurieren Logger konfigurieren Appender konfigurieren Vordefinierte Logging-Konfiguration eines Proxys BeanConnect Management Console als Log4j-Socket-Reader konfigurieren Logging-Ereignisse auf der BeanConnect Management Console anzeigen Logging-Datei von Log4j in der BeanConnect Management Console anzeigen Logging-Dateien des BeanConnect Proxy-Containers stdout-/stderr-log System-Logging-Datei SYSLOG Dumps und Diagnose-Dumps Anwendungsprotokoll unter Windows Traces des BeanConnect Proxy-Containers OSS-Trace BCAM-Trace CMX-Trace Diagnose der BeanConnect Management Console Diagnosedaten sammeln Fehlermeldungen des BeanConnect Proxy-Containers Konfigurations-Fehlermeldungen Laufzeit-Fehlermeldungen Meldungstypen K-Meldungen P-Meldungen U-Meldungen Fehlercodes Fehlercodes bei Dateibearbeitung (DMS-Fehlercodes) Systemfehlercodes Cobol2Java COBOL-Datentypen auf Java-Klassen abbilden Systemanforderungen Installation BeanConnect für openutm 11

12 Inhalt 14.2 COBOL-Datentypen konvertieren XML-Beschreibung für COBOL-Programm in BS2000 erstellen LMS-Bibliothek nach BS2000/OSD transferieren Datenstrukturen konvertieren D.XMLPROG D.XMLCOPY Beispielaufruf Generierte Dateien Java-Klassen auf UNIX- oder Windows-Systemen generieren Java-Klassen mit Ant generieren Java-Klassen ohne Ant generieren XSLT-Prozessor ersetzen Programmier-Referenz Typzuweisung Namenskonventionen Auf COBOL-Felder zugreifen Datenfeld schreiben Datenfeld lesen Ersatzdatentyp PicU Daten für die gesamte Struktur festlegen und lesen (Senden und Empfangen) Java/EBCDIC-Konvertierung Unterstützung des formatierten Modus Beispiel COBOL-Beispielprogramm XML-Beschreibung erstellen Java-Klassen generieren Verwendung der generierten Klassen Fehlermeldungen und Fehlerbehandlung Glossar Stichwörter BeanConnect für openutm

13 Beispiele Beispiel 1: Connection Pooling Beispiel 2: Sicherheitsabschnitt in oc4j-ra.xml Beispiel 3: Konfigurations-Properties in der Datei ra.xml Beispiel 4: Konfigurations-Properties in der Datei oc4j-ra.xml Beispiel 5: ejb-jar.xml Beispiel 6: orion-ejb-jar.xml Beispiel 7: OC4J-Utility admin.jar zum Deployment aufrufen Beispiel 8: OC4J-Utility admin.jar zum Undeployment aufrufen Beispiel 9: Connection Pooling Beispiel 10: Sicherheitsabschnitt in oc4j-ra.xml Beispiel 11: Konfigurations-Properties in der Datei oc4j-ra.xml Beispiel 12: Beispiel eines URL Beispiel 13: Überprüfen der Kommunikation auf Verwendung des OSI-TP-Protokolls. 185 Beispiel 14: Informationen zur Conversation mit der EIS-Anwendung Beispiel 15: Dialogbasierte Kommunikation unter Verwendung des Interfaces EISConnection Beispiel 16: Dialogbasierte Kommunikation unter Verwendung des Interfaces CCI Beispiel 17: Connection Groups unter Verwendung des Interfaces EISConnectionGroup Beispiel 18: OLTP Message-Driven Beans für dialogbasierte Kommunikation Beispiel 19: OLTP Message-Driven Beans für asynchrone Kommunikation Beispiel 20: OLTP Message-Driven Bean (CCI) BeanConnect für openutm 13

14 Beispiele Beispiel 21: Vordefinierte Code-Tabelle verwenden Beispiel 22: Logger-Namensbereich Beispiel 23: Logging-Level Beispiel 24: Ausgabe der Logging-Ereignisse über den Appender Beispiel 25: Logging-Dateien Beispiel 26: Beispiel für eine cobol2java.properties-datei Beispiel 27: Java-Klassen generieren Beispiel 28: Namenszuweisungen für unterschiedliche Code-Konventionen Beispiel 29: Daten senden und empfangen Beispiel 30: Daten holen und speichern BeanConnect für openutm

15 Abbildungen Bild 1: OC4J J2EE Connection Architecture Bild 2: BeanConnect-Komponenten Bild 3: Beziehung zwischen BeanConnect-Komponenten Bild 4: Outbound-Kommunikation Bild 5: Inbound-Kommunikation Bild 6: Bedienoberfläche der Management Console Bild 7: Navigationsbereich Bild 8: Proxies innerhalb der Management Console Bild 9: Neuen Proxy hinzufügen Bild 10: Allgemeine Proxy-Daten Bild 11: Beschreibung des Resource Adapters Bild 12: EIS-Partner konfigurieren Bild 13: Allgemeine Eigenschaften eines EIS-Partners Bild 14: Eigenschaften des openutm-partners Bild 15: Outbound-Services konfigurieren Bild 16: Outbound Communication Endpoints konfigurieren Bild 17: Message Endpoints konfigurieren Bild 18: Benutzer für Inbound-Kommunikation konfigurieren Bild 19: Proxy-Kontextmenü Bild 20: Proxy-Verfügbarkeit Bild 21: Auf OltpMessagePart-Objekten basierender Datenaustausch BeanConnect für openutm 15

16 Abbildungen Bild 22: Auf OltpMessageRecord-Objekten (OSI-TP Protokoll) basierender Datenaustausch Bild 23: Auf OltpMessageRecord-Objekten (UPIC-Protokoll) basierender Datenaustausch Bild 24: Logger konfigurieren Bild 25: Appender konfigurieren Bild 26: Logger konfigurieren Bild 27: Appender konfigurieren Bild 28: Logging-Ausgabe Bild 29: Cobol2Java Generierungsschritte BeanConnect für openutm

17 Tabellen Tabelle 1: Für COBOL-Typen verwendete Java-Klassen Tabelle 2: Unterstützung für COBOL-Typen und -Anweisungen Tabelle 3: Namenszuweisungen für unterschiedliche Code-Konventionen Tabelle 4: Cobol2Java Fehlermeldungen BeanConnect für openutm 17

18 Tabellen 18 BeanConnect für openutm

19 1 Einleitung Die Adapter-Familie BeanConnect gehört zur Produkt-Suite openseas (open Suite for Enterprise Application Server). Die BeanConnect-Adapter realisieren die Verknüpfung zwischen klassischen Transaktionsmonitoren und modernen Applikations-Servern und ermöglichen damit die effiziente Integration von Legacy-Anwendungen in moderne Java-Anwendungen. Dieses Handbuch beschreibt das Produkt BeanConnect for openutm. BeanConnect for openutm bietet einen JCA 1.5-konformen Adapter, der openutm-anwendungen mit Anwendungen auf Basis von J2EE, z.b. dem Oracle Application Server, verbindet. In den folgenden Abschnitten bezieht sich der Begriff EIS (Enterprise Information System) auf die openutm-anwendung. BeanConnect unterstützt verschiedene Kommunikationsrichtungen und -modelle, so ermöglicht es Outbound- und Inbound-Kommunikation, transaktionale und nicht-transaktionale Kommunikation sowie asynchrone und dialogbasierte Kommunikation. BeanConnect-Komponenten BeanConnect besteht aus folgenden Komponenten: Der BeanConnect Resource Adapter implementiert die JCA 1.5-Schnittstellen. Als konformer JCA-Adapter wird er in den Applikations-Server deployt und läuft daher auch innerhalb des Applikations-Servers. Der BeanConnect Proxy stellt die Funktionalität einer Protokollmaschine sowie Funktionen zur Transaktionssteuerung bereit. Er kann als intelligentes Gateway betrachtet werden. Er kommuniziert mit dem Resource Adapter, der im Applikations-Server läuft, auf der einen Seite und mit dem EIS auf der anderen. Die BeanConnect Management Console (MC) ist eine Java-basierte grafische Benutzeroberfläche für die Konfiguration und Administration von BeanConnect Proxies. Mit Hilfe der Management Console können Sie mehrere Proxies auf demselben System oder auf anderen Systemen verwalten. BeanConnect für openutm 19

20 Aufbau der Dokumentation zu BeanConnect Einleitung 1.1 Zielgruppe Dieses Handbuch richtet sich an folgende Zielgruppen: BeanConnect Entwickler und Administratoren Administratoren von Applikations-Servern wie z.b. OracleAS/OC4J Deployer EJB-Entwickler (Enterprise Java Beans) openutm-administratoren Es wird davon ausgegangen, dass Sie mit Java und der JCA-Spezifikation V1.5 von Sun Microsystems vertraut sind. 1.2 Aufbau der Dokumentation zu BeanConnect Die BeanConnect Dokumentation besteht aus folgenden Komponenten: Das Handbuch BeanConnect for openutm (dieses Dokument) Das Hilfesystem für die Management Console. Dieses bietet online schnelle und kontextbezogene Unterstützung bei der Konfiguration und Administration von BeanConnect Proxies. Die Javadoc zu BeanConnect, die mit der JAR-Datei des Resource Adapters RAInstall.jar ausgeliefert wird. Diese Dokumentation steht nach der Installation des Resource Adapters zur Verfügung. Erweiterungsdatei zum Handbuch Änderungen und Ergänzungen am Handbuch, die nach Redaktionsschluss vorgenommen wurden, finden Sie in der produktspezifischen Handbucherweiterungsdatei (man-datei). Diese Datei ist im Home-Verzeichnis von BeanConnect abgelegt. unter Solaris und Linux unter /docs/deutsch/man01-de.pdf unter Windows unter \docs\deutsch\man01-de.pdf I Weitere Einzelheiten zu openutm finden Sie in den zugehörigen Handbüchern. Einzelheiten zum Oracle Application Server und zu weiteren Softwareprodukten, die in diesem Handbuch erwähnt werden, finden Sie in der zugehörigen Dokumentation. 20 BeanConnect für openutm

21 Einleitung Struktur dieses Handbuchs 1.3 Struktur dieses Handbuchs Kapitel 2, JCA-Adapter-Integration Überblick vermittelt einen Überblick über das Oracle-Konzept für die Adapterintegration. Es beschreibt die Funktionen von BeanConnect for openutm und zeigt, wie dieses Produkt in die Umgebung des Oracle Application Server eingebunden wird. Kapitel 3, BeanConnect installieren beschreibt Installation, Update-Installation und Deinstallation von BeanConnect. Kapitel 4, Konfiguration im Applikations-Server (Outbound-Kommunikation über das OSI-TP-Protokoll und Inbound-Kommunikation) bietet Informationen zum Konfigurieren der Kommunikation über das OSI-TP-Protokoll. Es beschreibt das Deployment des Resource Adapters, eines OLTP Message-Driven Bean und von Enterprise Java Beans. Kapitel 5, Konfiguration im Applikations-Server (Outbound-Kommunikation über das UPIC-Protokoll) bietet Informationen zum Konfigurieren der Kommunikation über das UPIC-Protokoll. Es beschreibt das Deployment des Resource Adapters und der Enterprise Java Beans. Kapitel 6, BeanConnect Management Console vermittelt einen Überblick über die BeanConnect Management Console. Die Management Console wird zum Konfigurieren und Administrieren eines oder mehrerer BeanConnect Proxies verwendet. Kapitel 7, BeanConnect Proxy konfigurieren beschreibt die erforderlichen Schritte zum Konfigurieren eines BeanConnect Proxys mit der Management Console. Kapitel 8, EIS-Konfiguration beschreibt die erforderlichen Konfigurationsaktivitäten im EIS (Enterprise Information System), um eine Kommunikation zwischen dem Applikations-Server und dem EIS aufzubauen. Kapitel 9, BeanConnect Proxy betreiben beschreibt die Administrationsaufgaben beim Betrieb der BeanConnect Proxies. Kapitel 10, Interfaces und Programmierung beschreibt die Programmierung der Kommunikation zwischen dem Applikations-Server und dem EIS. Kapitel 11, Codierung und Sprachunterstützung beschreibt die Code-Konvertierung zwischen der spezifischen Codierung des EIS-Partners und Unicode. Zusätzlich informiert dieses Kapitel über die Sprachenunterstützung bei der Ausgabe von Meldungen. Kapitel 12, Hoch-Verfügbarkeit und Skalierbarkeit beschreibt die Konfigurationsänderungen, die für den Hochlast-Betrieb in BeanConnect notwendig werden können. Kapitel 13, Diagnose und Fehlerbehebung beschreibt die Vielzahl verschiedener Diagnose- und Trace-Funktionen. BeanConnect für openutm 21

22 Darstellungsmittel Einleitung Kapitel 14, Cobol2Java beschreibt die Integration von BS2000/OSD COBOL-Anwendungen und BeanConnect Clients. Dabei wird auch das Tool COBOL2Java beschrieben, mit dem die COBOL-Datentypen auf Java-Klassen abgebildet und konvertiert werden. 1.4 Darstellungsmittel In diesem Handbuch werden folgende Darstellungsmittel verwendet: Darstellungsmittel... Bedeutung Vertikale Auslassungspunkte in einem Beispiel weisen darauf hin, dass Informationen, die sich nicht direkt auf das Beispiel beziehen, weggelassen wurden.... Horizontale Auslassungspunkte in Anweisungen oder Befehlen weisen darauf hin, dass Teile der Anweisung oder des Befehls, die sich nicht direkt auf das Beispiel beziehen, weggelassen wurden. Halbfette Schrift Schreibmaschinenschrift Halbfette Schrift im Fließtext kennzeichnet alle Zitate der Benutzeroberfläche (Menüpunkte, Feldnamen, Optionen, etc.) Schrift mit festen Zeichenabstand kennzeichnet Systemeingaben, Systemausgaben und Dateinamen. < > Spitze Klammern enthalten Namen, die vom Benutzer eingegeben werden müssen. In den Beispielen mit XML kennzeichnen spitze Klammern XML-Anweisungen. [ ] Eckige Klammern enthalten optionale Angaben, von denen Sie eine auswählen können, aber nicht müssen. { } Geschwungene Klammern enthalten alternative Angaben, von denen Sie genau eine auswählen müssen. Eine vertikale Linie trennt die alternativen oder optionalen Angaben. I Dieses Symbol kennzeichnet wichtige Hinweise und weitere Informationen. V Dieses Symbol kennzeichnet eine Warnung. 22 BeanConnect für openutm

23 2 JCA-Adapter-Integration Überblick Dieses Dokument beschreibt das Produkt BeanConnect for openutm (Universelle Transaktions-Monitor). BeanConnect for openutm stellt einen JCA 1.5-konformen Adapter zur Verfügung, der openutm-anwendungen mit J2EE-basierten Anwendungen verbindet, wie z.b. dem Oracle Application Server. Dieses Kapitel bietet einen Überblick über die JCA-Adapter-Integration in eine J2EE Applikations-Server-Umgebung. Bei JCA handelt es sich um die J2EE-Connector- Architecture-Spezifikation von Sun Microsystems TM. Das Kapitel beschreibt die Funktionen von BeanConnect for openutm und zeigt, wie dieses Produkt in die Umgebung des Oracle Application Servers eingebunden wird. Dieses Kapitel enthält Informationen zu folgenden Themen: Über OC4J BeanConnect-Komponenten BeanConnect als JCA-konformer Resource Adapter Adapter-Integration für die Kommunikation mit dem EIS-Backend BeanConnect für openutm 23

24 Über OC4J JCA-Adapter-Integration Überblick 2.1 Über OC4J Der Oracle Application Server Container für J2EE (OC4J) bildet den Kern der J2EE-Laufzeitkomponente des Oracle Application Servers. OC4J ist J2EE-1.4-kompatibel und läuft auf den Standard-J2SE-Distributionen; OC4J bleibt dadurch benutzerfreundlich und für Entwickler hochproduktiv bei gleichzeitig hervorragender Leistung und Skalierbarkeit in Produktionsumgebungen. OC4J stellt eine vollständige J2EE-1.4-konforme Umgebung bereit. OC4J stand-alone ist für Entwicklungs- und kleine bis mittlere Produktionsumgebungen bestimmt. OC4J stellt alle durch J2EE spezifizierten Container, APIs und Dienste bereit. OC4J ist vollständig in Java geschrieben und wird auf der Java Virtual Machine (JVM) mit dem standardmäßigen Java Development Kit (JDK) ausgeführt. OC4J kann mit dem Standard-JDK Ihres Betriebssystems betrieben werden JCA-Adapter-Integration Ein Resource Adapter ist speziell an das Enterprise Information System (EIS) angepasst, für das er entwickelt wurde. Er stellt die Operationen auf Systemebene bereit, die für den Betrieb und die Kommunikation mit dem EIS benötigt werden. Da er nicht speziell an einen bestimmten Applikations-Server angepasst ist, kann er auf jedem J2EE-Applikations- Server eingesetzt werden. Der Resource Adapter stellt dem Applikations-Server seine Fähigkeiten über ein JCA-definiertes API zur Verfügung. Durch die Verwendung des definierten API kann der Applikations-Server die Dienste des Resource Adapters wirksam in seine Operationen integrieren, während er die Anwendungen selbst von der darunterliegenden Implementierung des EIS isoliert. Wichtige Voraussetzungen für eine wirksame und skalierbare Integration für die Kommunikation mit den EIS-Systemen sind Dienste wie z.b. Connection Management und Pooling, Transaction Management zur Unterstützung EIS-interner Transaktionen und zwischen mehreren EIS-Systemen, Fehler-Logging und -Tracing sowie ein Sicherheits-Framework, das sowohl container- als auch anwendungsgesteuerte Anmeldung ermöglicht. JCA definiert Standard-Java-Interfaces für die einfache Integration von Anwendungen zur Kommunikation mit dem EIS. Die JCA 1.5-Resource-Adapter können einfach in den OC4J-Container deployt werden. 24 BeanConnect für openutm

25 JCA-Adapter-Integration Überblick Über OC4J Bild 1: OC4J J2EE Connection Architecture OC4J J2EE-Anwendungskomponente Anwendungskontrakt Systemkontrakte Resource Adapter Netzwerk Enterprise Information System (Quality of Service) JCA 1.5-Kontrakte Es werden alle Kontrakte der JCA 1.5-Spezifikation unterstützt: Connection Management-Kontrakt Der Connection Management-Kontrakt ermöglicht den Anwendungskomponenten, eine Verbindung mit einem EIS aufzubauen und jedes vom Applikations-Server bereitgestellte Connection Pooling zu nutzen. Transaction Management-Kontrakt Der Transaction Management-Kontrakt ermöglicht einem Applikations-Server, Transaktionen mit einem Transaktionsmanager zwischen mehreren Resource Managern zu verwalten. Security Management-Kontrakt Der Security Management-Kontrakt bietet Zugangs- und Zugriffskontrolle sowie sichere Kommunikation zwischen dem J2EE-Server und dem EIS. Lifecycle Management-Kontrakt Der Lifecycle Management-Kontrakt ermöglicht dem Applikations-Server die Aktivitätsphasen des Resource Adapters, d.h. Funktionen im Zusammenhang mit dem Starten und Beenden, zu verwalten. Work Management-Kontrakt Der Work Management-Kontrakt ermöglicht dem Resource Adapter, Aufträge zur Ausführung an einen Applikations-Server zu schicken. Da der Applikations-Server die Arbeit für den Resource Adapter übernimmt, braucht sich der Resource Adapter nicht um das Thread Management zu kümmern. Stattdessen verwaltet der Applikations-Server diesen Aspekt effizient und verwendet bei Bedarf das Thread Pooling. Der Work Management-Kontrakt ist zwar nicht erforderlich (der Resource Adapter kann für Arbeitsabläufe auch seinen eigenen Thread verwalten), wird aber dringend empfohlen. BeanConnect für openutm 25

26 Über OC4J JCA-Adapter-Integration Überblick Message Inflow-Kontrakt Der Message Inflow-Kontrakt ermöglicht einem Resource Adapter die synchrone oder asynchrone Auslieferung von Nachrichten an die Endpunkte im Applikations-Server unabhängig von Nachrichtenstil, Semantik und Infrastruktur. Transaction Inflow-Kontrakt Der Transaction Inflow-Kontrakt ermöglicht einem Resource Adapter, sowohl eine importierte Transaktion an einen Applikations-Server weiterzuleiten als auch eine Transaktion abzuschließen sowie einen Wiederanlauf, die von einem EIS angestoßen wurde. Common Client Interface (CCI) Das CCI ermöglicht J2EE Clients, wie z.b. Enterprise Beans, JavaServer Pages Technologie (JSP) und Servlets, den Zugriff auf ein darunterliegendes EIS. Weitere Informationen zu den vom OC4J-Container bereitgestellten Services finden Sie in der Dokumentation zum Oracle Application Server OC4J. 26 BeanConnect für openutm

27 JCA-Adapter-Integration Überblick BeanConnect-Komponenten 2.2 BeanConnect-Komponenten BeanConnect besteht aus folgenden Komponenten: Der BeanConnect Resource Adapter implementiert die Interfaces von JCA 1.5. Als konformer JCA-Adapter wird er in den Applikations-Server deployt und läuft daher auch innerhalb des Applikations-Servers. Der Resource Adapter wird in zwei Varianten ausgeliefert: für die Kommunikation über das OSI-TP-Protokoll und für die Kommunikation über das UPIC-Protokoll. Der BeanConnect Proxy stellt die Funktionalität einer Protokollmaschine sowie Funktionen zur Transaktionssteuerung bereit. Er kann als intelligentes Gateway betrachtet werden. Er kommuniziert auf der einen Seite mit dem Resource Adapter, der im Applikations-Server läuft, und auf der anderen Seite mit dem EIS. Er kann sich auf demselben Rechner wie der Resource Adapter oder auf einem anderen Rechner befinden. Er wird nicht für die Kommunikation über das UPIC-Protokoll verwendet. Die BeanConnect Management Console (MC) ist eine Java-basierte grafische Benutzeroberfläche für die Konfiguration und Administration von Proxys. Mit Hilfe der Management Console können mehrere Proxys auf demselben Rechner wie die Management Console oder auf anderen Rechnern verwaltet werden. Sie wird nicht für die Konfiguration von Verbindungen über das UPIC-Protokoll verwendet. Bild 2: BeanConnect-Komponenten Applikations-Server BeanConnect Resource Adapter Kommunikation über das UPIC-Protokoll BeanConnect Proxy Enterprise Information System BeanConnect Management Console BeanConnect für openutm 27

28 BeanConnect-Komponenten JCA-Adapter-Integration Überblick In komplexeren Szenarien kann die Notwendigkeit bestehen, einen oder mehrere Applikations-Server mit mehreren EIS zu verbinden. Beachten Sie in diesem Fall die folgenden Regeln: Ein Applikations-Server kann mehrere Resource Adapter enthalten, falls erforderlich in unterschiedlichen Versionen. Ein Resource Adapter kommuniziert mit genau einem Proxy. Ein Proxy kann mit mehreren EIS-Partnern kommunizieren. Eine Management Console kann mehrere Proxys verwalten (Konfiguration und Administration). Bild 3: Beziehung zwischen BeanConnect-Komponenten Applikations- Server BeanConnect Resource Adapter 1:1 BeanConnect Proxy 1:n Enterprise Information System 1:n 1:n BeanConnect Management Console 28 BeanConnect für openutm

29 JCA-Adapter-Integration Überblick BeanConnect-Komponenten BeanConnect Resource Adapter BeanConnect beinhaltet einen Connector Resource Adapter gemäß der JCA 1.5-Spezifikation von Sun Microsystems TM. Er ermöglicht standardisierte Verbindungen von openutm-anwendungen zu Anwendungen, die auf J2EE-basierten Applikations-Servern laufen und spielt eine tragende Rolle für die Integration und Konnektivität zwischen einem EIS und einem Applikations-Server. Der Resource Adapter dient als Kontaktstelle zwischen Anwendungskomponenten, Applikations-Servern und Enterprise Information Systemen. Resource Adapter und Applikations-Server müssen auf der Grundlage gut definierter Kontrakte miteinander kommunizieren, die durch die J2EE Connector Architecture festgelegt sind. Der Resource Adapter unterstützt JCA 1.5-Kontrakte (siehe JCA 1.5-Kontrakte auf Seite 25) Der Resource Adapter liegt als RAR-Datei vor. Die Datei muss im Applikations-Server deployt werden. Weitere Einzelheiten über die Konfiguration des Resource Adapters finden Sie in Kapitel 4, Konfiguration im Applikations-Server (Outbound-Kommunikation über das OSI-TP-Protokoll und Inbound-Kommunikation) BeanConnect Proxy Der Proxy verbindet Resource Adapter und EIS. Er wird nicht für die Kommunikation über das UPIC-Protokoll verwendet. Er dient als Container für die Konfigurationseigenschaften der Kommunikationspartner und hält alle Informationen zu Services und Communication Endpoints bereit. Der Proxy ist für das Weiterleiten von Nachrichten und ihre Zuordnung zu den entsprechenden Partnern und Services zuständig. Er stellt Funktionen für die Transaktionssicherung bereit und für die Verifizierung von Zugriffsrechten (Benutzerkennung und Passwort) bei Anfragen an openutm-anwendungen. Die BeanConnect-Konfiguration besteht im wesentlichen aus der Konfiguration des Proxys. Der Proxy enthält den Proxy-Container, der auf dem Transaktionsmonitor openutm basiert. Der Proxy wird mit der Management Console verwaltet und administriert. BeanConnect für openutm 29