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

Verwenden Sie die Datei Default.bindProps, um Optionen anzugeben, die festlegen, wie SQL-Anweisungen in DB2-Paketen gebunden werden.

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 in dieser Datei angezeigt.

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

>--+- -bindOptions-- -"--Bindeoptionen--"-+--------------------->
   |                   (1)                |   
   '-| DBRM-Optionen |--------------------'   

>--+----------------+--+--------------------------+------------->
   |            (2) |  '- -isolationLevel--+-CS-+-'   
   '-| -grant |-----'                      +-RR-+     
                                           +-RS-+     
                                           '-UR-'     

>--+-----------------------+-----------------------------------><
   |                   (3) |   
   '-| Traceoptionen |-----'   

Anmerkungen:
  1. Informationen zur Syntax finden Sie in der Beschreibung dieser Optionen.
  2. Informationen zur Syntax finden Sie in der Beschreibung dieser Option.
  3. 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--=---------------------------------->

>--+- -bindOptions-- -"--Bindeoptionen--"-+--------------------->
   |                   (1)                |   
   '-| DBRM-Optionen |--------------------'   

>--+----------------+--+--------------------------+------------><
   |            (2) |  '- -isolationLevel--+-CS-+-'   
   '-| -grant |-----'                      +-RR-+     
                                           +-RS-+     
                                           '-UR-'     

Anmerkungen:
  1. Informationen zur Syntax finden Sie in der Beschreibung dieser Optionen.
  2. Informationen zur Syntax finden Sie in der Beschreibung dieser Option.
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.
-bindOptions "Zeichenfolge_mit_Bindeoptionen"
Diese Optionen haben dieselbe Funktion wie die DB2-Vorkompilierungs- und Bindeoptionen mit denselben Namen. Wenn Sie Ihr Programm für die Ausführung auf einem System mit DB2 für z/OS vorbereiten, müssen Sie die Optionen für DB2 für z/OS angeben. Wenn Sie Ihr Programm für die Ausführung auf einem System mit DB2 für Linux®, UNIX® und Windows® vorbereiten, müssen Sie Optionen für DB2 für Linux, UNIX und Windows angeben.

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.
Die Bindeoption REOPT kann im pureQuery-Code nützlich sein. Sie können mit dieser Option Parametermarken in SQL-Anweisungen verwenden und dabei trotzdem DB2-Zugriffspfade optimieren. Informationen zum Verwenden dieser Option mit unterstützten DB2-Datenbanken finden Sie über die folgenden Links:
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
>>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--Pfad-----------><
                   '-FALSE-'                           

-generateDBRM
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 Generator ausführen. Wenn dieser Name länger als sieben Zeichen ist, gibt StaticBinder eine Ausnahmebedingung aus.

-outputDBRMPath Pfad
Gibt das Verzeichnis an, in dem die generierte DBRM-Datei gespeichert werden soll. Der Standardwert ist das Verzeichnis, aus dem Sie das Dienstprogramm StaticBinder ausführen.
-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 Generator verwendet haben.
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 Generator verwendet haben.
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 Generator verwendet haben.
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 Generator verwendet haben.
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.

Feedback