Klicken Sie doppelt auf diese Datei, um sie in einem Editor in der Workbench zu öffnen. Die Datei befindet sich im Ordner dataAccessFolder in Ihrem Java™-Projekt.
In dieser Datei können Sie Optionen angeben, die für alle pureQueryXML-Dateien in Ihrem Projekt gelten. Sie können auch für einzelne pureQueryXML-Dateien spezifische Optionen angeben.
Sie können dieser Datei Kommentare hinzufügen. Beginnen Sie jeden Kommentar mit einem Symbol #.
Während Sie Einträge erstellen oder bearbeiten, können Sie Strg+Leertaste (oder Ihren eigenen Tastenanschlag, wenn Sie die Standardeinstellung geändert haben) eingeben, um Unterstützung abzurufen.
Eine Beschreibung der in den Syntaxdiagrammen verwendeten Konventionen finden Sie in Informationen zum Lesen von Syntaxdiagrammen.
Im folgenden Diagramm wird die zulässige Syntax zum Festlegen der Standardoptionen in dieser Datei angezeigt.
>>-defaultOptions--=--------------------------------------------> >--+- -bindOptions-- -"--Bindeoptionen--"-+---------------------> | (1) | '-| DBRM-Optionen |--------------------' >--+-----------------------------+--+----------------+----------> | .-FALSE-. | | (2) | '- -differenceOnly--+-TRUE--+-' '-| -grant |-----' >--+--------------------------+--+-----------------------+----->< '- -isolationLevel--+-CS-+-' | (3) | +-RR-+ '-| Traceoptionen |-----' +-RS-+ '-UR-'
Im nächsten Syntaxdiagramm wird die zulässige Syntax zum Festlegen von Optionen für einzelne pureQueryXML-Dateien angezeigt, die in der Datei aufgelistet werden.
>>-+-pureQueryXML-Datei--------------------+--=-----------------> '-pureQueryXML-Datei--:--Basispaketname-' >--+- -bindOptions-- -"--Bindeoptionen--"-+---------------------> | (1) | '-| DBRM-Optionen |--------------------' >--+-----------------------------+--+----------------+----------> | .-FALSE-. | | (2) | '- -differenceOnly--+-TRUE--+-' '-| -grant |-----' >--+--------------------------+-------------------------------->< '- -isolationLevel--+-CS-+-' +-RR-+ +-RS-+ '-UR-'
Der Wert für die jeweilige Option darf keine Leerzeichen enthalten.
Eine Liste sowie eine Beschreibung dieser Optionen finden Sie in BIND (Befehl).
Wenn Sie die Bindeoption CONCURRENTACCESSRESOLUTION in DB2 Version 9.7 for Linux, UNIX, and 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.
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.
.-FALSE-. >>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--Pfad-----------><
Der Stammname der generierten DBRM-Dateien ist der Stammpaketname, den Sie angeben, wenn Sie das Dienstprogramm Configure ausführen.
Der Standardwert ist FALSE.
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.
Der Standardwert ist FALSE.
.-,--------------------. V | >>- -grant-- "--grantees--(----+-Berechtigungs-ID-+-+--) - "--->< '-PUBLIC-----------'
Für DB2 Database for Linux, UNIX, and Windows: Sie können die Schlüsselwörter USER, GROUP und ROLE verwenden. Informationen zu diesen Schlüsselwörtern finden Sie in Anweisung GRANT (Paketzugriffsrechte).
Für DB2 for z/OS: Sie können das Schlüsselwort ROLE verwenden. Informationen zu diesem Schlüsselwort finden Sie in GRANT (Paketzugriffsrechte).
Einschränkung: Sie können die Option -grant nicht verwenden, wenn die Option -generateDBRM den Wert TRUE hat.
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.
Diese Datei muss die Erweiterung .pdqxml oder .xml aufweisen. 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.
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.
Enthält eine Optionsdatei einen Eintrag für ein Paket in einer pureQueryXML-Datei und einen Eintrag für die vollständige pureQueryXML-Datei, werden die Ergebnisse dieser Einträge durch die Reihenfolge der Einträge festgelegt.
C:/dir/captureFile.pdqxml = -bindOptions "QUALIFIER NULLID"
C:/dir/captureFile.pdqxml:MYPKGA = -bindOptions "QUALIFIER DB2ADMIN"
Das Dienstprogramm StaticBinder erstellt Pakete für alle Anweisungsgruppen in der pureQueryXML-Datei und all diese Pakete verwenden das Qualifikationsmerkmal NULLID. Das Dienstprogramm StaticBinder bindet dann MYPKGA mit dem Qualifikationsmerkmal DB2ADMIN.C:/dir/captureFile.pdqxml:MYPKGA = -bindOptions "QUALIFIER DB2ADMIN"
C:/dir/captureFile.pdqxml = -bindOptions "QUALIFIER NULLID"
Das Dienstprogramm StaticBinder erstellt das Paket MYPKGA mit dem Qualifikationsmerkmal DB2ADMIN. Anschließend bindet das Dienstprogramm StaticBinder alle Pakete und bindet dabei auch MYPKGA mit dem Qualifikationsmerkmal NULLID erneut.Durch Angabe der Option -differenceOnly in der zweiten Zeilen können Sie das erneute Binden von MYPKGA durch das Dienstprogramm StaticBinder jedoch unterbinden.
C:/dir/captureFile.pdqxml:MYPKGA = -bindOptions "QUALIFIER DB2ADMIN"
C:/dir/captureFile.pdqxml = -bindOptions "QUALIFIER NULLID" -differenceOnly TRUE
>>-+------------------------+--+---------------------------+--->< '- -traceFile--Dateiname-' | .-OFF-----. | '- -traceLevel--+-ALL-----+-' +-SEVERE--+ +-WARNING-+ +-INFO----+ +-CONFIG--+ +-FINE----+ +-FINER---+ '-FINEST--'
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.