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

Vereinfachen Sie die Anpassung und Bindung von SQLJ-Profilen (Structured Query Language in Java) 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.

Vorbereitungen

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 dieser Task

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® In der Datenbank werden Pakete erstellt, eines für jede Isolationsebene. Der Anpassungsprozess ergänzt die Profile mit Informationen, die spezifisch für die DB2 Datenbank. Die Datenbank verwendet diese Informationen zur Laufzeit.

Zusätzlich zur Profilanpassung müssen Sie die angepassten Profile an die DB2 Datenbank. 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 Anwendungen >WebSphere geschäftliche Anwendungen > App Name .
    Vermeide Ärger: Führen Sie nicht mehrere Sitzungen der Administrationskonsole aus, um Profile anzupassen und zu binden, die sich in derselben EAR-Datei befinden.
  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 Profile anpassen und binden oder Pakete binden.
    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.
        Beste Praktiken:
        • 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.
      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 Durchsuche... um die Datei auf dem System zu lokalisieren.
  6. Geben Sie die erforderlichen Informationen für die Verbindungsherstellung zur Datenbank ein.
    Sie müssen die folgenden Felder ausfüllen:
    Datenbank-URL
    Gibt die 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> or 
    oder
    fully_qualified_host_name: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. Sehen Sie sich die DB2 Eine vollständige Liste der Anpassungsoptionen finden Sie in der 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.
    Vermeide Ärger: Wenn Sie eine große Unternehmensanwendung oder viele SQLJ-Profile verarbeiten, kann der Vorgang länger dauern als das Standardtimeout der Verwaltungskonsole. 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.

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: The SQLJ operation on application {0} completed successfully.  Exit code: {1}
ADMA0507I.explanation=This informational message indicates the program status.
ADMA0507I.useraction=No user action is required.
Wenn die Operation nicht erfolgreich durchgeführt wurde, ist die folgende Nachricht im Systemprotokoll enthalten:
ADMA0506I=ADMA0506I: The SQLJ operation on application {0} did not complete successfully.  Exit code: {1}
ADMA0506I.explanation=The SQLJ operation encountered a problem.  This informational message indicates 
the program status. Prior messages in the command output give details of the problem.
ADMA0506I.useraction=Check the command output for the cause of the problem.