Syntax für die Ausführung des Dienstprogramms StaticBinder für die Clientoptimierung mit einer Optionsdatei

Sie können die Namen der pureQueryXML-Dateien und die Optionen für die Erstellung von DB2-Paketen oder DBRM-Dateien, die auf diesen Dateien basieren, über einen Befehl und eine Optionsdaei angeben. Sie können eine Optionsdatei auch dann verwenden, wenn Sie nur eine pureQueryXML-Datei haben.

Sie können die pureQueryXML-Dateien im Befehl auflisten und nur den Eintrag defaultOptions in der Optionsdatei verwenden.

Sie können pureQueryXML-Dateien im Befehl und in der Optionsdatei auflisten. Wenn eine Datei sowohl im Befehl als auch in der Optionsdatei aufgelistet ist, verarbeitet das Dienstprogramm StaticBinder die Datei. Wenn eine Datei in der Optionsdatei, aber nicht im Befehl aufgelistet ist, verarbeitet das Dienstprogramm StaticBinder die Datei nicht. Wenn eine Datei im Befehl, aber nicht in der Optionsdatei aufgelistet ist, verarbeitet das Dienstprogramm StaticBinder die Datei mit den Optionen in der Befehlszeile und im Eintrag defaultOptions der Optionsdatei.

Wenn Sie das Dienstprogramm StaticBinder über eine Befehlszeile ausführen und eine Optionsdatei verwenden, erkennt das Dienstprogramm die Optionen in folgender Reihenfolge:
  1. Optionen in der Befehlszeile
  2. Optionen für einzelne pureQueryXML-Dateien und Anweisungsgruppen, die in der angegebenen Optionsdatei vorhanden sind
  3. Standardoptionen in der angegebenen Optionsdatei
Syntaxdiagramm lesenSyntaxdiagramm überspringen
                                        (1)   
>>-java--com.ibm.pdq.tools.StaticBinder------------------------->

>--+--------------------------------------------------------------------------------------------------------------------+-->
   |  (2)                                                                                                               |   
   '------- -url--jdbc--:--db2--:--//--Server--+---------+--/--Datenbank-- -username--Benutzer-ID-- -password--Kennwort-'   
                                               '-:--Port-'                                                                  

>--+---------------------------------------------------------------+-->
   |                 .-------------------------------------------. |   
   |                 V                                           | |   
   '- -pureQueryXml----+-pureQueryXML-Datei--------------------+-+-'   
                       '-pureQueryXML-Datei--:--Basispaketname-'       

>-- -optionsFile--Dateiname--+-----------------------------+---->
                             |                   .-FALSE-. |   
                             '- -differenceOnly--+-TRUE--+-'   

>--+--------------------------+--+-----------------------+------>
   |                .-FALSE-. |  |                   (3) |   
   '- -showDetails--+-TRUE--+-'  '-| Traceoptionen |-----'   

>--+-------------------------------+---------------------------->
   '- -verifyPackages--+-DETAIL--+-'   
                       '-SUMMARY-'     

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

Anmerkungen:
  1. Sie können die Optionen in beliebiger Reihenfolge angeben.
  2. Wenn Sie URL, Benutzer-ID und Kennwort im Befehl nicht angeben, müssen Sie sie in der Optionsdatei angeben, sofern Sie nicht nur DBRM-Dateien erstellen.
  3. Informationen zur Syntax finden Sie in der Beschreibung dieser Optionen.

Beschreibungen der Optionen

-optionsFile Dateiname
Der Name der Datei, einschließlich ihres absoluten oder relativen Pfads, in der die pureQueryXML-Dateien aufgelistet werden, die die zu bindenden SQL-Anweisungen enthalten.
-password Kennwort
Das Kennwort, das zum Herstellen einer Verbindung zur Datenquelle verwendet werden soll.
-pureQueryXml pureQueryXML-Datei|pureQueryXML-Datei:Basispaketname
Gibt die pureQueryXML-Datei an, die die Gruppen von SQL-Anweisungen enthält, die Sie in Pakete binden wollen, oder eine einzelne Gruppe von SQL-Anweisungen, die Sie in ein Paket binden wollen. Sie können mehrere Werte angeben.
pureQueryXML-Datei
Der Name der pureQueryXML-Datei. Beispiel: C:\Verzeichnis\captureFile.pdqxml
Diese Datei muss die Erweiterung .pdqxml oder .xml aufweisen. Entweder muss die Datei eine Ressource im Klassenpfad für Ihre Anwendung sein oder Sie müssen den vollständigen oder relativen Pfad zu der Datei angeben.
pureQueryXML-Datei:Basispaketname
Der Name der pureQueryXML-Datei und der Basisname des zu bindenden Pakets. Beispiel: C:\Verzeichnis\captureFile.pdqxml:MYPKGA.

Die Datei muss die Erweiterung .pdqxml oder .xml haben. Entweder muss die Datei eine Ressource im Klassenpfad für Ihre Anwendung sein oder Sie müssen den vollständigen oder relativen Pfad zu der Datei angeben.

Der Basisname des Pakets ist der Wert des Attributs name des Elements package, das das Paket in der Datei pureQueryXML beschreibt. Der Basisname besteht aus zwei Teilen:
  • Stammpaketname
  • Zeichen, die vom Konfigurationsdienstprogramm bei der letzten Verarbeitung der Datei pureQueryXML aufgrund des Werts der Option sqlLimit an den Stammpaketnamen angehängt wurdenConfigure utility last processed the file
Wenn Sie -pureQueryXml in Verbindung mit -optionsFile in einem Befehl verwenden, ist eine Reihe von Ergebnissen möglich. Siehe Optionsdatei verwenden und pureQueryXML-Dateien und Anweisungsgruppen in einem Befehl angeben.
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.
-validateXml TRUE|FALSE
Gibt an, ob XML-Schemaprüfung für die pureQueryXML-Eingabedateien unter Verwendung des pureQueryXML-Schemas ausgeführt wird. Ist der Wert TRUE, wird die Prüfung ausgeführt. Ist der Wert FALSE oder ist die Option nicht angegeben, wird die Prüfung nicht ausgeführt. Der Standardwert ist FALSE.

Das Ergebnis der XML-Schemaprüfung (erfolgreich oder fehlerhaft) wird für jede Eingabedatei ermittelt und aufgelistet. Falls eine der Eingabedateien fehlschlägt, wird die StaticBinder-Verarbeitung nicht gestoppt, sondern mit den nachfolgenden Dateien fortgesetzt.

Schlägt die Schemaprüfung für eine pureQueryXML-Datei fehl, werden die Pakete in dieser Datei nicht gebunden. Der erste Fehler bei der Schemaprüfung und der Bindefehler für die Datei werden zurückgemeldet.

Nur pureQueryXML-Dateien des aktuellen Release oder der vorherigen Version (Version 4 oder 3) werden geprüft. Wird eine frühere Version von pureQueryXML gefunden, wird die Prüfung für diese Datei nicht ausgeführt.


Feedback