Syntax für das Binden über ein Archiv für die Clientoptimierung

Sie können diesen Befehl verwenden, um das Dienstprogramm StaticBinder für ein Archiv ausführen, das Ihre Anwendung enthält. Das Archiv muss eine Optionsdatei mit der Erweiterung .bindProps enthalten, in der die pureQueryXML-Dateien aufgelistet sind, die Sie dem Dienstprogramm StaticBinder zur Verfügung stellen wollen.
Syntaxdiagramm lesenSyntaxdiagramm überspringen
                                        (1)   
>>-java--com.ibm.pdq.tools.StaticBinder------------------------->

    (2)                                                                  
>-------- -url--jdbc--:--db2--:--//--Server--+---------+--/--Datenbank-->
                                             '-:--Port-'                 

>-- -username--Benutzer-ID-- -password--Kennwort---------------->

>-- -archive-- -Dateiname--+-.ear-+----------------------------->
                           +-.jar-+   
                           +-.war-+   
                           '-.zip-'   

>--+-------------------------------------------------------------------------+-->
   |                   (3)                                                   |   
   +-| DBRM-Optionen |-------------------------------------------------------+   
   +- -bindOptions-- -"--Bindeoptionen--"--+-------------------------------+-+   
   |                                       '- -verifyPackages--+-DETAIL--+-' |   
   |                                                           '-SUMMARY-'   |   
   '- -verifyPackages--+-DETAIL--+-------------------------------------------'   
                       '-SUMMARY-'                                               

>--+-----------------------------+--+----------------+---------->
   |                   .-FALSE-. |  |            (4) |   
   '- -differenceOnly--+-TRUE--+-'  '-| -grant |-----'   

>--+--------------------------+--+-----------------------+------>
   '- -isolationLevel--+-CS-+-'  |                   (5) |   
                       +-RR-+    '-| Traceoptionen |-----'   
                       +-RS-+                                
                       '-UR-'                                

>--+--------------------------+--------------------------------><
   |                .-FALSE-. |   
   '- -showDetails--+-TRUE--+-'   

Anmerkungen:
  1. Sie können die Optionen in beliebiger Reihenfolge angeben.
  2. Sie brauchen die Optionen -url, -username- und -password nicht zu verwenden, wenn Sie nur DBRM-Dateien erstellen.
  3. Informationen zur Syntax finden Sie in der Beschreibung dieser Optionen.
  4. Informationen zur Syntax finden Sie in der Beschreibung dieser Option.
  5. Informationen zur Syntax finden Sie in der Beschreibung dieser Optionen.

Beschreibungen der Optionen

-archive
Verwenden Sie diese Option, wenn Sie Ihre Anwendung in einer Archivdatei auf einem DB2-Server implementiert haben und SQL-Anweisungen durch das Ausführen von StaticBinder auf diesem Server binden wollen. Es werden folgende Archivtypen unterstützt: EAR, JAR, WAR und ZIP.
-bindOptions "Zeichenfolge_mit_Bindeoptionen"
Diese Optionen haben dieselbe Funktion wie DB2-Vorkompilierungs- und Bindeoptionen mit denselben Namen. Die Syntax der Zeichenfolge lautet "Option_1 Wert_1 Option_2 Wert_2".

Eine Liste sowie eine Beschreibung dieser Optionen finden Sie in BIND command.

Wenn Sie die Bindeoption CONCURRENTACCESSRESOLUTION in DB2 Version 9.7 für Linux®, UNIX® und Windows® verwenden, gilt die Option für alle Anweisungen, die sich in Paketen befinden, die an die Isolationsstufen CS und RR gebunden sind. Diese Option, die nur für diese beiden Isolationsstufen gilt, ermöglicht Anwendungen, den zuletzt festgeschriebenen Wert in Zeilen zu finden, die von anderen Anwendungen gesperrt sind.
DBRM-Optionen
Mit dieser Option können Sie DBRM-Dateien generieren, anstatt Pakete zu erstellen. Diese Optionen gelten nur, wenn Sie DB2 für z/OS verwenden.

Nachdem das Dienstprogramm StaticBinder die DBRM-Dateien generiert hat, müssen Sie die Dateien in einen Datensatz kopieren. Der Standardname des DBRM-Datensatzes lautet Präfix.DBRMLIB.DATA. Dabei steht Präfix für das übergeordnete Qualifikationsmerkmal, das im TSO-Profil für den Benutzer angegeben ist. Präfix ist in der Regel Ihre Benutzer-ID in TSO.

Wenn der DBRM-Datensatz noch nicht vorhanden ist, müssen Sie ihn erstellen. Der DBRM-Datensatz benötigt Speicherplatz, um alle SQL-Anweisungen zu speichern, wobei zusätzlicher Speicherplatz für jeden Hostvariablennamen und für Headerdaten erforderlich ist. Die Headerdaten benötigen etwa zwei Datensätze für jedes DBRM (Database Request Module - Datenbankanforderungsmodul), 20 Byte für jeden SQL-Datensatz und 6 Byte für jede Hostvariable. Ein exaktes Format des DBRM finden Sie im DBRM-Zuordnungsmakro DSNXDBRM in der Bibliothek Präfix.SDSNMACS.

Im folgenden Syntaxdiagramm werden die Optionen für das Generieren von DBRM-Dateien beschrieben.

Syntaxdiagramm lesenSyntaxdiagramm überspringen
                   .-FALSE-.                           
>>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--Pfad-----------><

-generateDBRM TRUE|FALSE
Gibt an, ob DBRM-Dateien generiert werden sollen, anstatt Pakete zu erstellen. Wenn generateDBRM auf TRUE gesetzt ist, generiert das Dienstprogramm StaticBinder standardmäßig vier DBRM-Dateien, jeweils eine pro Isolationsstufe: CS, RR, RS, UR. Sie können jedoch nur eine DBRM-Datei generieren, wenn Sie die Option -isolationLevel angeben.

Der Stammname der generierten DBRM-Dateien ist der Stammpaketname, den Sie angeben, wenn Sie das Dienstprogramm Configure ausführen.

Der Standardwert ist FALSE.

-outputDBRMPath Pfad
Gibt das Verzeichnis an, in dem die generierten DBRM-Dateien gespeichert werden sollen. Der Standardwert ist das Verzeichnis, aus dem Sie das Dienstprogramm StaticBinder ausführen.
-differenceOnlyTRUE|FALSE
Gibt an, dass DB2-Pakete nicht ersetzt werden sollen, die Objektgruppennamen, Paketnamen und Konsistenztoken aufweisen, die mit diesen Werten für die entsprechenden Anweisungsgruppen innerhalb der pureQueryXML-Datei übereinstimmen, für die Sie das Dienstprogramm StaticBinder ausführen.

Beispiel: Sie führen das Dienstprogramm StaticBinder für eine pureQueryXML-Datei mit den Namen capture.pdqxml aus. Das Dienstprogramm erstellt die Pakete MYPKGA, MYPKGB und MYPKGC. Sie modifizieren anschließend die Anweisungsgruppe MYPKGA in capture.pdqxml und führen für diese Datei das Dienstprogramm Configure aus, wobei für die Option -cleanConfigure der Standardwert FALSE festgelegt ist. Das Dienstprogramm Configure ordnet der Anweisungsgruppe ein neues Konsistenztoken zu, weil die Gruppe geändert wurde. Wenn Sie das Dienstprogramm StaticBinder für capture.pdqxml erneut ausführen, um die neue Version von MYPKGA zu binden, geben Sie für -differenceOnly den Wert TRUE an. Das Dienstprogramm bindet nur MYPKGA und bindet die übrigen zwei Pakete nicht erneut.

Der Standardwert ist FALSE.
-grant "grantees(erste_ID,zweite_ID,...)"
Gibt die durch Kommata getrennte Liste der Berechtigten (in Klammern) an, denen Sie das Zugriffsrecht EXECUTE für Pakete erteilen wollen, die das Dienstprogramm StaticBinder erstellt. Wenn Sie diese Option nicht angeben, erteilt das Dienstprogramm StaticBinder dieses Zugriffsrecht nicht.
Syntaxdiagramm lesenSyntaxdiagramm überspringen
                             .-,--------------------.          
                             V                      |          
>>- -grant-- "--grantees--(----+-Berechtigungs-ID-+-+--) - "---><
                               '-PUBLIC-----------'            

grantees
Die durch Kommata getrennte Liste von Berechtigungs-IDs, denen Sie das Zugriffsrecht EXECUTE erteilen wollen. Stellen Sie sicher, dass die Berechtigungs-IDs, die Sie auflisten, für die von Ihnen verwendete DB2-Datenbank gültig sind.

Für DB2 Database für Linux, UNIX und Windows: Sie können die Schlüsselwörter USER, GROUP und ROLE verwenden. Informationen zu diesen Schlüsselwörtern finden Sie in GRANT (Package Privileges) statement.

Für DB2 für z/OS: Sie können das Schlüsselwort ROLE verwenden. Informationen zu diesem Schlüsselwort finden Sie in GRANT (package privileges).

Einschränkungen:

  • Sie können die Option -grant nicht verwenden, wenn der Wert der Option -generateDBRM TRUE ist.
  • In einer Optionsdatei können Sie die Option -grant entweder in der Zeile defaultOptions oder für mindestens einen einzelnen Eintrag in der Datei verwenden. Sie können -grant nicht an beiden Positionen in einer einzelnen Optionsdatei verwenden.
-isolationLevel CS | RR | RS | UR
Gibt an, dass Sie ein einzelnes DB2-Paket oder eine einzelne DBRM-Datei für eine bestimmte Isolationsstufe generieren möchten, anstatt ein DB2-Paket oder eine DBRM-Datei für jede der vier Isolationsstufen zu generieren.

Die Isolationsstufe gilt für alle SQL-Anweisungen, die im Paket enthalten sind. Wenn Sie eine Isolationsstufe über die Methode Connection.setTransactionIsolation() von IBM® Data Server Driver für JDBC und SQLJ definieren, ignoriert pureQuery diese Isolationsstufe für statisch ausgeführte Anweisungen.

UR
Gibt Uncommitted Read als Isolationsstufe an.
Das Dienstprogramm StaticBinder fügt dem Namen des erstellten Pakets bzw. der erstellten DBRM-Datei 1 hinzu, sofern Sie nicht die Option -forceSingleIsolationLevel bei der Ausführung des Dienstprogramms Configure verwendet haben.
CS
Gibt Cursor Stability als Isolationsstufe an.
Das Dienstprogramm StaticBinder fügt dem Namen des erstellten Pakets bzw. der erstellten DBRM-Datei 2 hinzu, sofern Sie nicht die Option -forceSingleIsolationLevel bei der Ausführung des Dienstprogramms Configure verwendet haben.
RS
Gibt Read Stability als Isolationsstufe an. Read Stability stellt sicher, dass die Ausführung von SQL-Anweisungen im Paket von anderen Anwendungsprozessen für Zeilen isoliert ist, die von der Anwendung gelesen und geändert werden.
Das Dienstprogramm StaticBinder fügt dem Namen des erstellten Pakets bzw. der erstellten DBRM-Datei 3 hinzu, sofern Sie nicht die Option -forceSingleIsolationLevel bei der Ausführung des Dienstprogramms Configure verwendet haben.
RR
Gibt Repeatable Read als Isolationsstufe an.
Das Dienstprogramm StaticBinder fügt dem Namen des erstellten Pakets bzw. der erstellten DBRM-Datei 4 hinzu, sofern Sie nicht die Option -forceSingleIsolationLevel bei der Ausführung des Dienstprogramms Configure verwendet haben.
-password Kennwort
Das Kennwort, das zum Herstellen einer Verbindung zur Datenquelle verwendet werden soll.
-showDetails TRUE|FALSE
Gibt an, ob das Dienstprogramm StaticBinder Übersichtsdaten zu den von ihm erstellten DB2-Paketen und den SQL-Anweisungen anzeigen soll, die in den von ihm verarbeiteten pureQueryXML-Dateien enthalten sind.
Der Standardwert ist 'FALSE'.
Traceoptionen
Sie können die Datei, in der Nachrichten protokolliert werden sollen, und die zu protokollierende Informationsebene angeben.
Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-+------------------------+--+---------------------------+---><
   '- -traceFile--Dateiname-'  |               .-OFF-----. |   
                               '- -traceLevel--+-ALL-----+-'   
                                               +-SEVERE--+     
                                               +-WARNING-+     
                                               +-INFO----+     
                                               +-CONFIG--+     
                                               +-FINE----+     
                                               +-FINER---+     
                                               '-FINEST--'     

-traceFile Dateiname
Gibt den absoluten oder relativen Pfad und den Namen der Datei an, die zum Protokollieren von Informationen zur Operation verwendet werden soll.
Falls die Datei bereits vorhanden ist, hängt pureQuery neue Nachrichten an den vorhandenen Inhalt der Datei an. Standardmäßig werden die Einträge in 'System.err' geschrieben.
-traceLevel OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|ALL
Gibt den zu protokollierenden Informationstyp an. Die Standardstufe ist OFF. Wenn Sie keine Datei angeben, in die die Protokolleinträge geschrieben werden sollen, und Sie diese Option auf einen anderen Wert als OFF setzen, werden die Einträge in 'System.err' geschrieben.
-url Verbindungs-URL
Die JDBC-Typ-4-URL für die Verbindung zur Datenbank.
-username Benutzer-ID
Die Benutzer-ID, die zum Herstellen einer Verbindung zur Datenquelle verwendet werden soll.
-verifyPackages DETAIL|SUMMARY
Gibt an, ob das Dienstprogramm StaticBinder einen Bericht über die Pakete erstellt, die für die SQL-Anweisungen, die der pureQueryXML-Datei zugeordnet sind, vorhanden oder nicht vorhanden sind. Wenn Sie diese Option verwenden, bindet das Dienstprogramm StaticBinder keine Pakete.

Beispiel: Sie führen das Dienstprogramm Configure für eine pureQueryXML-Datei mit dem Namen myApp.pdqxml aus. Beim Ausführen des Dienstprogramms haben Sie Werte für die Optionen -collection, -pkgVersion und -rootPkgName angegeben und das Dienstprogramm hat diese Werte in der pureQueryXML-Datei gespeichert. Sie führen das Dienstprogramm StaticBinder unter Angabe dieses Dateinamens aus und das Dienstprogramm erstellt DB2-Pakete.

Zu einem späteren Zeitpunkt möchten Sie eine Liste der Pakete anzeigen, die das Dienstprogramm StaticBinder anhand der pureQueryXML-Datei erstellt hat. Beim Ausführen des Dienstprogramms können Sie die Option -verifyPackages mit dem Wert DETAIL verwenden und wiederum den Namen der Datei angeben.

Wenn die Werte für die Optionen -collection, -pkgVersion und -rootPkgName dieselben sind wie bei der vorherigen Ausführung des Dienstprogramms StaticBinder, findet das Dienstprogramm die Pakete und listet sie auf.

Wenn Sie jedoch das Dienstprogramm Configure für myApp.pdqxml ausführen würden, nachdem Sie zunächst das Dienstprogramm StaticBinder ausgeführt und die Werte für -collection, -pkgName und -rootPkgName geändert haben, würde das Dienstprogramm StaticBinder keine Pakete finden, die mit den neuen Werten für diese Optionen übereinstimmen. Im zugehörigen Bericht des Dienstprogramms StaticBinder würde stehen, dass die gesuchten Pakete nicht vorhanden sind.

Die Option -verifyPackages funktioniert unter der Voraussetzung, dass Sie, nachdem Sie das Dienstprogramm Configure für eine pureQueryXML-Datei und danach das Dienstprogramm StaticBinder für diese Datei ausgeführt haben, das Dienstprogramm Configure nicht nochmals für die Datei ausgeführt und andere Werte für -collection, -pkgVersion und -rootPkgName angegeben haben.

Sie können diese Option zusammen mit der Option -bindOptions angeben. Das Dienstprogramm StaticBinder bindet jedoch keine Pakete. Verwenden Sie -bindOptions nur dann zum Angeben der Objektgruppe für die Pakete, die Sie verifizieren möchten, wenn Sie diese Option beim Erstellen der Pakete für die Angabe der Objektgruppe verwendet haben.

DETAIL
Erstellt einen Bericht mit den folgenden Informationen auf Basis der Werte von -collection, -pkgVersion und -rootPkgName:
  • Welche Pakete nicht vorhanden sind.
  • Welche Pakete vorhanden sind. Für jedes Paket werden im Bericht der Name, das Konsistenztoken, die Zeitmarke und die Isolationsstufe aufgelistet.
  • Die Anzahl Pakete, die vorhanden bzw. nicht vorhanden sind.
SUMMARY
Erstellt einen Bericht, in dem auf Basis der Werte für -collection, -pkgVersion und -rootPkgNamevon die Pakete aufgezählt werden, die vorhanden bzw. nicht vorhanden sind.

Feedback