Syntax der Einträge in der Datei Default.genProps für das Konfigurieren der Unterstützung von statischem SQL im pureQuery-Code

Verwenden Sie die Datei Default.genProps, um Optionen für die DB2-Pakete festzulegen, die gebundene SQL-Anweisungen enthalten sollen.

In dieser Datei können Sie Optionen angeben, die für alle Schnittstellen in Ihrem Projekt gelten. Sie können auch für einzelne Schnittstellen 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 für alle Schnittstellen angezeigt, die in der Datei aufgelistet werden.

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-defaultOptions--=-------------------------------------------->

>--+--------------------------------------------+--------------->
   '- -baseDataOverride--Java-Paket.Klassenname-'   

>--+-------------------------------------+---------------------->
   |               .-NULLID------------. |   
   '- -collection--+-Objektgruppenname-+-'   

>--+---------------------------------+-------------------------->
   '- -pkgVersion-- -+-AUTO--------+-'   
                     '-Versions-ID-'     

>--+---------------------------------------+-------------------->
   |                             .-FALSE-. |   
   '- -forceSingleBindIsolation--+-TRUE--+-'   

>--+----------------------+--+-----------------------+---------><
   '- -xmlFile--XML-Datei-'  |                   (1) |   
                             '-| Traceoptionen |-----'   

Anmerkungen:
  1. Informationen zur Syntax finden Sie in der Beschreibung dieser Optionen.

Im nächsten Syntaxdiagramm wird die zulässige Syntax zum Festlegen von Optionen für einzelne Schnittstellen angezeigt, die in der Datei aufgelistet werden.

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-Java-Paket.Schnittstelle--=---------------------------------->

>--+--------------------------------------------+--------------->
   '- -baseDataOverride--Java-Paket.Klassenname-'   

>--+-------------------------------------+---------------------->
   |               .-NULLID------------. |   
   '- -collection--+-Objektgruppenname-+-'   

>--+---------------------------------+-------------------------->
   '- -pkgVersion-- -+-AUTO--------+-'   
                     '-Versions-ID-'     

>--+--------------------------------------+--------------------->
   '- -rootPkgName--Stamm_des_Paketnamens-'   

>--+---------------------------------------+-------------------->
   |                             .-FALSE-. |   
   '- -forceSingleBindIsolation--+-TRUE--+-'   

>--+----------------------+------------------------------------><
   '- -xmlFile--XML-Datei-'   

-baseDataOverride Java-Paket.Klassenname
Ermöglicht das Festlegen eines Namens einer Java-Klasse, die die generierte Implementierungsklasse erweitert. Generierte Implementierungsklassen erweitern standardmäßig die Klasse com.ibm.pdq.runtime.generator.BaseData. Durch das Angeben Ihrer eigenen Klasse können Sie die generierte Implementierungsklasse mit Ihren eigenen Methoden erweitern.
defaultOptions
Gibt an, dass die Optionen in der Zeile für die SQL-Anweisungen in allen Schnittstellen gelten, die in dieser Datei aufgelistet sind. Nur eine einzige Zeile in der Datei darf mit diesem Schlüsselwort beginnen.
Java-Paket.Schnittstelle (am Zeilenanfang in einer Optionsdatei)
Gibt an, dass die Optionen in der Zeile nur für die SQL-Anweisungen in der angegebenen Schnittstelle gelten. Diese Optionen setzen Optionen außer Kraft, die Sie als Standardwerte angeben.
Sie müssen den Namen der Schnittstelle mit dem Namen des Java-Pakets qualifizieren, zu dem die Schnittstelle gehört.
-collection Objektgruppenname
Das Qualifikationsmerkmal für die Pakete, die das pureQuery-Dienstprogramm StaticBinder bindet. Das Qualifikationsmerkmal muss die Integritätsbedingungen für Objektgruppennamen für die von Ihnen verwendete DB2-Datenbank erfüllen.
Wenn Sie diesen Parameter nicht angeben, nimmt er standardmäßig den Wert NULLID an.
-pkgVersion AUTO|Versions-ID
Gibt die Paketversion an, die beim Binden von Paketen verwendet werden soll.

Für DB2 ist es zulässig, dass mehrere Versionen eines Pakets gleichzeitig vorhanden sind. Somit können Sie neue Pakete binden, ohne ältere Versionen von Paketen mit demselben Namen ersetzen zu müssen. Wenn bei neuen Paketen Probleme auftreten, können Sie eine ältere Version dieses Pakets verwenden.

Das Dienstprogramm Configure erstellt eine Kopie der pureQueryXML-Datei und hängt die Versions-ID an den Namen der Datei an.

AUTO
Gibt an, dass die Versions-ID unter Verwendung der aktuellen Zeitmarke automatisch generiert wird. Für die Versions-ID wird eine einzige Zeitmarke verwendet.
Versions-ID
Gibt die Versions-ID für ein Paket an. Die Zeichenfolge muss für die von Ihnen verwendete Version von DB2 gültig sein.

Die Versions-ID darf nur Zeichen enthalten, die für Dateinamen unter Ihrem Betriebssystem gültig sind. Außerdem darf die Länge der Zeichenfolge und des Namens des Pakets die von Ihrem Betriebssystem unterstützte maximal zulässige Länge für Dateinamen nicht überschreiten.

Wenn Sie diese Option angeben und das Dienstprogramm Configure die pureQueryXML-Datei nicht ändert, erstellt das Dienstprogramm keine Kopie der pureQueryXML-Datei.

Wenn Sie diese Option nicht angeben, werden Datenbankpakete, die aus nachfolgenden Bindevorgängen resultieren, ohne eine Version erstellt und es wird keine Kopie der Datei erstellt.

Die Prüfung der Version während der Laufzeit basiert auf dem Konsistenztoken, nicht auf dem Versionsnamen.

-rootPkgName Stamm_des_Paketnamens
Gibt den Stamm des Namens an, der für DB2-Pakete verwendet werden soll. Eine vollständige Beschreibung dazu, wie das Dienstprogramm Configure die Namen von DB2-Paketen erstellt, finden Sie in der Beschreibung von sqlLimit.

Stamm_des_Paketnamens muss den Integritätsbedingungen entsprechen, die von der von Ihnen verwendeten DB2-Datenbank festgelegt werden.

Wenn Sie vorhaben, mit dem pureQuery-Dienstprogramm StaticBinder DBRM-Dateien zu generieren anstatt DB2-Pakete zu erstellen, muss Stamm_des_Paketnamens in Großbuchstaben geschrieben sein und darf nicht länger als 6 Zeichen sein. Das Dienstprogramm Configure fügt Zeichen zu dem Stamm des Namens hinzu, wenn entweder die pureQueryXml-Datei DDL-Anweisungen enthält oder die Anzahl der Anweisungen pro Paket (angegeben mit sqlLimit) erreicht ist. Wenn Sie mit dem Dienstprogramm StaticBinder eine DBRM-Datei generieren und die Kombination aus Stamm_des_Paketnamens, den zusätzlichen Zeichen wegen der Aktivität des Dienstprogramms Configure und der Isolationsstufe länger als 8 Zeichen ist, gibt das Dienstprogramm StaticBinder eine Ausnahmebedingung aus.

-forceSingleBindIsolation TRUE | FALSE
Gibt an, ob Sie vorhaben, ein DB2-Paket für nur eine einzige Isolationsstufe zu erstellen, und dass daher zum Angeben der Isolationsstufe keine Nummer an den Namen des Pakets angehängt werden soll. Der Standardwert ist FALSE, d. h., dass eine Nummer angehängt wird.
Verwenden Sie diese Option zusammen mit der Option -isolationLevel in der Datei Default.bindProps.

Wenn Sie eine einzelne Anweisungsgruppe mithilfe der Option -isolationLevel in zwei oder drei verschiedene Pakete binden wollen, von denen jedes eine andere Isolationsstufe aufweist, dürfen Sie die Option -forceSingleBindIsolation nicht angeben, wenn Sie das Dienstprogramm Configure für die pureQueryXML-Datei ausführen, die die Anweisungsgruppe enthält.

Nehmen wir beispielsweise an, dass Sie die folgenden beiden Einträge in eine Optionsdatei für das Dienstprogramm StaticBinder aufgenommen haben:

C:/dir/captureFile.pdqxml:MYPKGA = -isolationLevel UR
C:/dir/captureFile.pdqxml:MYPKGA = -isolationLevel CS

Wenn Sie für die Ausführung des Dienstprogramms Configure für die Datei captureFile.pdqxml die Option -forceSingleBindIsolation verwendet haben, führt das Dienstprogramm StaticBinder Folgendes aus:

  1. Binden des Pakets MYPKGA mit der Isolationsstufe UR.
  2. Erneutes Binden des Pakets MYPKGA mit der Isolationsstufe CS.

Das Ergebnis ist ein einzelnes Paket MYPKGA, das mit der Isolationsstufe CS gebunden ist.

Wenn Sie als Ergebnis zwei Pakete MYPKGA wollen, von denen das eine die Isolationsstufe UR und das andere die Isolationsstufe CS aufweist, dürfen Sie die Option -forceSingleBindIsolation nicht angeben, wenn Sie das Dienstprogramm Configure für die Datei captureFile.pdqxml ausführen.

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 über die Konsolsicht ausgegeben.
-xmlFile XML-Datei
Der Name der XML-Konfigurationsdatei, die SQL enthält, die die SQL in den Methoden angibt oder überschreibt, die in der Schnittstelle definiert sind. Eine XML-Konfigurationsdatei kann auch die Definitionen der entsprechenden Beans überschreiben.

Feedback