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.
(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-. | '- -showDetails--+-TRUE--+-' .-NOT_SET------. >-- -statementBindError--+-REMOVE-------+-----------------------> '-MARK_INVALID-' >--+-----------------------+------------------------------------> | (3) | '-| Traceoptionen |-----' >--+-------------------------------+----------------------------> '- -verifyPackages--+-DETAIL--+-' '-SUMMARY-' >--+--------------------------+-------------------------------->< | .-FALSE-. | '- -validateXml--+-TRUE--+-'
Die Datei muss die Erweiterung .pdqxml oder .xml haben. Die Datei muss entweder eine Ressource im Klassenpfad für die Anwendung sein oder Sie müssen den vollständigen oder relativen Pfad zu der Datei angeben.
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 bearbeiten anschließend die Anweisungsgruppe MYPKGA in capture.pdqxml mithilfe der Workbench und führen für die 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.
>>-+------------------------+--+---------------------------+--->< '- -traceFile--Dateiname-' | .-OFF-----. | '- -traceLevel--+-ALL-----+-' +-SEVERE--+ +-WARNING-+ +-INFO----+ +-CONFIG--+ +-FINE----+ +-FINER---+ '-FINEST--'
SQL-Anweisungen, die zuvor als ungültig markiert wurden, werden im Bericht nicht aufgeführt.
Sie können SQL-Anweisungen, die als ungültig markiert wurden, mit der Option -restoreInvalidSQLForce von Configure wiederherstellen. Sie können die Anweisungen mit der Option -removeInvalidSQL entfernen.
Wenn die Option -statementBindError mit dem Wert MARK_INVALID oder REMOVE angegeben wird, muss Schreibberechtigung für die pureQueryXML-Dateien vorliegen. Wenn die Datei nicht vom Dienstprogramm StaticBinder aktualisiert werden kann, wird ein Fehler angezeigt, und die Datei wird nicht verarbeitet.
Die Option -statementBindError wird beim Binden von DAO-Schnittstellenimplementierungsklassen (DAO - Data Access Object) von pureQuery nicht unterstützt. Wenn das Dienstprogramm StaticBinder zum Binden einer Implementierungsklasse ausgeführt wird und die Option mit dem Wert MARK_INVALID oder REMOVE angegeben wird, zeigt es eine Warnung an und versucht nicht, die Klassen zu binden.
-url jdbc:db2://localhost:50000/SAMPLE:enableNamedParameterMarkers=1;
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.
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.
Wenn Sie 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.
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.
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.
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.