Profile für Structured Query Language in Java-(SQLJ)-Anwendungen anpassen und binden

Vereinfachen Sie die Anpassung und Bindung von SQLJ-Profilen für Ihre Anwendungen, indem Sie die folgenden Funktionen über die Administrationskonsole oder Scripting ausführen. SQLJ-Profile müssen angepasst und gebunden werden, bevor die Unternehmensanwendung das eingebettete SQL der Anwendung verwenden kann.

Vorbereitende Schritte

Sie müssen eine SQLJ-Anwendung haben, die bereits im Anwendungsserver installiert und implementiert wurde.
Für SQLJ-Anwendungen, die CMP (Container-managed Persistence, über Container realisierte Transaktionspersistenz) verwenden, können Sie die Anwendung auf zwei Arten implementieren.
  • Implementieren Sie die SQLJ-Anwendung im Anwendungsserver. Weitere Informationen finden Sie im Artikel zur Implementierung von SQLJ-Anwendungen, die CMP verwenden.
  • Implementieren Sie die SQLJ-Anwendungen mit dem Tool "ejbdeploy". Weitere Informationen finden Sie im Artikel zur Implementierung von SQLJ-Anwendungen, die CMP verwenden, mit dem Tool "ejbdeploy".
Für SQLJ-Anwendungen, die BMP (Bean-managed Persistence, über JavaBeans realisierte Transaktionspersistenz) verwenden, lesen Sie den Artikel zum Implementieren von SQLJ-Anwendungen, die BMP verwenden, Servlets und Session-Beans.

Informationen zu diesem Vorgang

Wenn Sie SQLJ-Anwendungen im Anwendungsserver nutzen möchten, müssen Sie die SQLJ-Profile anpassen, die die integrierten SQL-Anweisungen enthalten. Standardmäßig werden vier DB2-Pakete in der Datenbank erstellt, eines für jede Isolationsstufe. Der Anpassungsprozess erweitert die Profile um Informationen, die für die DB2-Datenbank spezifisch sind. Die Datenbank verwendet diese Informationen zur Laufzeit.

Zusätzlich zur Profilanpassung müssen Sie die angepassten Profile an die DB2-Datenbank binden. Die Profilbindung darf erst nach der Anpassung der SQLJ-Profile stattfinden.

Sie können Profile auch mit Scripting oder mit dem Tool "db2sqljcustomize" anpassen und binden.
  • Informationen zur Scripting-Unterstützung finden Sie im Artikel zur Befehlsgruppe für die Anwendungsverwaltung für das Objekt "AdminTask".
  • Informationen zum Tool "db2sqljcustomize" finden Sie im Artikel zur Anpassung und Bindung von SQLJ-Profilen mit dem Tool "db2sqljcustomize". Wenn Sie Profile mit dem Tool "db2sqljcustomize" anpassen, müssen Sie die Anwendung erneut installieren.

Vorgehensweise

  1. Stellen Sie sicher, dass die erforderlichen Datenbanktabellen vorhanden sind, wie im Artikel zur Implementierung von Datenzugriffsanwendungen beschrieben.
  2. Navigieren Sie zu der SQLJ-Anwendung, die im Anwendungsserver installiert ist. Klicken Sie auf Anwendungen > WebSphere-Unternehmensanwendungen > Anwendnungsname.
    Fehler vermeiden Fehler vermeiden: Führen Sie nicht mehrere Sitzungen zum Anpassen und Binden von Profilen aus derselben EAR-Datei in der Administrationskonsole aus.gotcha
  3. Navigieren Sie zum Abschnitt "SQLJ-Profile". Klicken Sie auf SQLj-Profile. Wenn Sie auf diesen Link klicken, erweitert der Anwendungsserver die EAR-Datei für die Anwendung in einem temporären Verzeichnis. Die Anzeige für die SQLJ-Profile kann mit einer gewissen Verzögerung erscheinen.
  4. Wählen Sie Profile anpassen und binden oder Pakete binden aus. Wählen Sie Option nach den Profilen aus, mit denen Sie arbeiten:
    • Wenn Ihre Profile noch nicht angepasst wurden oder wenn Sie die Profile erneut anpassen möchten, wählen Sie Profile anpassen und binden aus.
    • Wenn die Profile bereits angepasst sind, wähle Sie Pakete binden aus.
  5. Wählen Sie Profile oder eine Profilgruppe für die Anpassung und Bindung aus.
    • Wählen Sie in der bereitgestellten Liste Profile aus.
      1. Wählen Sie die Profile in der Liste aus, und klicken Sie auf Hinzufügen. In der Liste werden die SQLJ-Profile angezeigt, die in der Unternehmensanwendung vorhanden sind.
        Bewährtes Verfahren Bewährtes Verfahren:
        • Wenn Sie mehrere Profile auswählen möchten, halten Sie die Taste STRG gedrückt.
        • Wenn Sie mehrere Profile auswählen möchten, die in der Liste hintereinander aufgeführt werden, wählen Sie den ersten Profilnamen aus, drücken Sie dann die Umschalttaste, halten Sie sie gedrückt, und wählen Sie dann das letzte gewünschte Profil aus. Damit werden das erste, das letzte und alle anderen Profile dazwischen ausgewählt.
        bprac
      2. Wählen Sie Ausgewählte SQLj-Profile als Gruppe anpassen/binden aus. Diese Option gibt an, dass der Anwendungsserver eine Datei mit der Erweiterung ".grp" erstellt, die die zu verarbeitenden SQLj-Profile enthält. Sie können die Datei mit der Erweiterung ".grp" danach für weitere Bindungsoperationen verwenden. Nachdem Sie diese Anzeige fertig bearbeitet haben, klicken Sie auf OK. Daraufhin wird eine Option zum Herunterladen der Datei mit der Erweiterung ".grp" angezeigt.
    • Wählen Sie Profilgruppendatei für die Angabe der anzupassenden bzw. zu bindenden SQLJ-Profile verwenden aus. Wählen Sie diese Option aus, um eine zu verarbeitende Profilgruppe anzugeben. Klicken Sie auf Durchsuchen..., um die Datei im System zu suchen.
  6. Geben Sie die erforderlichen Informationen für die Verbindungsherstellung zur Datenbank ein. Sie müssen die folgenden Felder ausfüllen:
    Datenbank-URL
    Gibt den URL der Datenbank an, an die die Profile gebunden werden. Die typische Syntax ist wie folgt:
    jdbc:db2://<host name="">:<port>/<database name="">.</database></port></host> 
    oder
    vollständig_qualifizierter_Hostname:Port
    Benutzer
    Gibt die Benutzer-ID für den Datenbankadministrator auf dem Server an, auf dem sich die Datenbank befindet.
    Kennwort
    Gibt das Kennwort für den Datenbankadministrator auf dem Server an, auf dem sich die Datenbank befindet.
    Weitere Optionen
    Gibt weitere Optionen an, die in den Anpassungs- und Bindungsprozessen verwendet werden sollen. Eine vollständige Liste der Anpassungsoptionen finden Sie in der DB2-Dokumentation.
    Klassenpfad
    Gibt den Klassenpfad an, in dem sich die Dateien "sqlj.zip" und "db2jcc.jar" bzw. "db2jcc4.jar" befinden.
  7. Klicken Sie auf OK.
    Fehler vermeiden Fehler vermeiden: Wenn Sie eine große Unternehmensanwendung oder viele SQLJ-Profile verarbeiten, kann der Prozess das Standardzeitlimit für die Administrationskonsole überschreiten. Das Standardverbindungszeitlimit für die Administrationskonsole des Anwendungsserver sind 30 Minuten. Wenn das Standardzeitlimit erreicht ist und die Verbindung zu Server verloren geht, können Sie im Systemausgabeprotokoll nach den letzten Ergebnissen des Anpassungs- und Bindungsprozesses suchen.

    Um zu verhindern, dass die Verbindung getrennt wird, konfigurieren Sie ein höheres Zeitlimit für die Konsolsitzung. Nach erfolgreichem Anpassungs- und Bindungsprozess können Sie sich im Systemausgabeprotokoll die Gesamtverarbeitungszeit ansehen. Verwenden Sie diese Zeit als Basis für die Festlegung des neuen Zeitlimits. Informationen zum Konfigurieren des Zeitlimits für die Konsole finden Sie im Artikel zum Ändern der Verfallszeit für Konsolsitzungen.

    gotcha

Ergebnisse

Nachdem der Anwendungsserver die Verarbeitung der SQLJ-Profile abgeschlossen hat, werden die Ergebnisse der Anpassung und Bindung angezeigt. In der Ergebnisanzeige werden Nachrichten des Datenbankservers sowie eine Zusammenfassung der Ergebnisse des Anwendungsservers angezeigt.
Wenn die Operation erfolgreich durchgeführt wurde, ist die folgende Nachricht im Systemprotokoll enthalten:
ADMA0507I=ADMA0507I: Die SQLJ-Operation in der Anwendung {0} war erfolgreich. Exit-Code: {1}
ADMA0507I.explanation=Diese Informationsnachricht zeigt den Programmstatus an.
ADMA0507I.useraction=Es ist keine Benutzeraktion erforderlich. 
Wenn die Operation nicht erfolgreich durchgeführt wurde, ist die folgende Nachricht im Systemprotokoll enthalten:
ADMA0506I=ADMA0506I: Die SQLJ-Operation in der Anwendung {0} war nicht erfolgreich. Exit-Code: {1}
ADMA0506I.explanation=In der SQLJ-Operation ist ein Problem aufgetreten. Diese Informationsnachricht zeigt den Programmstatus an. Die vorherigen Nachrichten in der Befehlsausgabe enthalten Details zum Problem.
ADMA0506I.useraction=Suchen Sie in der Befehlsausgabe nach der Ursache für das Problem.

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_sqljcustomize
Dateiname:tdat_sqljcustomize.html