Optionen konfigurieren, für die SQL-Anweisungen erneut gebunden werden müssen

Mit Ausnahme der Option -cleanConfigure TRUE wirken sich die Optionen des Dienstprogramms Configure in der Regel nicht auf alle SQL-Anweisungen oder alle benannten Anweisungsgruppen einer pureQueryXML-Datei aus. Wenn das Dienstprogramm Configure eine Anweisungsgruppe ändert, müssen die SQL-Anweisungen in der Anweisungsgruppe in der Regel erneut gebunden werden, bevor die Anweisungen in eine DB2-Datenbank statisch ausgeführt werden können.
Für die meisten Optionen legt der Wert des Attributs configureStatus einer benannten Anweisungsgruppe fest, ob die Option des Dienstprogramms Configure eine Anweisungsgruppe ändert:
  • Wenn der Wert des Attributs configureStatus auf AUTO gesetzt ist, wird die Anweisungsgruppe nur geändert, wenn eine Option eine Änderung erforderlich macht. Wird die Anweisungsgruppe nicht geändert, müssen die SQL-Anweisungen in der Gruppe nicht erneut gebunden werden.
  • Wenn der Wert des Attributs configureStatus auf FINAL gesetzt ist, wird die Anweisungsgruppe nicht geändert.
  • Wenn der Wert des Attributs configureStatus auf REQUIRED gesetzt ist, wird die Anweisungsgruppe geändert. Die SQL-Anweisungen in der Gruppe müssen erneut gebunden werden.

Die Option -setPreStatusOfAllPkgs des Dienstprogramms Configure wirkt sich auf den Wert des Attributs configureStatus aus. Wenn diese Option angegeben ist, verarbeitet das Dienstprogramm Configure die SQL-Anweisungen und Anweisungsgruppen, nachdem die Auswirkung der Option berücksichtigt wurde. Die Verarbeitung richtet sich nicht nach dem Wert des Attributs configureStatus beim Start der Configure-Operation.

Sie führen das Dienstprogramm StaticBinder aus, indem Sie die pureQueryXML-Datei zum Binden oder erneuten Binden der SQL-Anweisungen in den Anweisungsgruppen angeben. Sie können die Option -differenceOnly TRUE für StaticBinder bei der Ausführung einer Bindeoperation angeben. Die Option begrenzt die Bindeoperation auf die Anweisungen in Anweisungsgruppen, die tatsächlich erneut gebunden werden müssen.

Anmerkung: Das Dienstprogramm StaticBinder versucht, Pakete zu erstellen und die Pakete für SQL-Anweisungen nur in den benannten Anweisungsgruppen zu binden. Sie müssen das Dienstprogramm Configure ausführen, um SQL-Anweisungen aus nicht benannten Anweisungsgruppen in benannte Anweisungsgruppen zu versetzen.

Die folgende Tabelle listet die Optionen des Dienstprogramms Configure auf, die benannte Anweisungsgruppen ändern, wenn der Wert der Option -cleanConfigure auf FALSE gesetzt oder nicht angegeben ist. Wenn Sie das Dienstprogramm Configure mit dem auf TRUE gesetzten Wert der Option -cleanConfigure ausführen, werden alle Anweisungsgruppen geändert. Alle Optionen des Dienstprogramms Configure werden auf alle SQL-Anweisungen angewendet, die sich in nicht benannten Anweisungsgruppen befinden.

Tabelle 1. Optionen des Dienstprogramms Configure, die Anweisungsgruppen ändern und erneutes Binden von SQL-Anweisungen erfordern.
Option Benannte Anweisungsgruppen, die geändert werden
-allowStaticRowsetCursors Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED gesetzt ist.
-collection Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED gesetzt ist.
-forceSingleBindIsolation Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED gesetzt ist.
-groupSQLBySpecialRegisters Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED oder AUTO gesetzt ist.
-groupSQLByStrings Benannte Anweisungsgruppen werden nicht geändert. Nur nicht benannte Anweisungsgruppen werden geändert.
-markDDLForBind Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED gesetzt ist.
-maxMissingSections Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED oder AUTO gesetzt ist.
-pkgVersion Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED oder AUTO gesetzt ist.
-removeSQLInactiveForDays Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED oder AUTO gesetzt ist.
-removeInvalidSQL Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED oder AUTO gesetzt ist.
-replaceLocations Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED oder AUTO gesetzt ist.
-replaceSchemas Anweisungsgruppen, bei denen der Wert des Attributs configureStatus auf REQUIRED oder AUTO gesetzt ist.
-restoreInvalidSQLForce Alle benannten Anweisungsgruppen.
-rootPkgName Benannte Anweisungsgruppen werden nicht geändert. Nur nicht benannte Anweisungsgruppen werden geändert.
-setPostStatusOfAllPkgs Alle benannten Anweisungsgruppen.
-setPreStatusOfAllPkgs Alle benannten Anweisungsgruppen.
-sqlLimit Benannte Anweisungsgruppen werden nicht geändert. Nur nicht benannte Anweisungsgruppen werden geändert.

Es gibt Operationen des Dienstprogramms Configure, denen keine Option zugeordnet ist. Die Operationen behalten die pureQueryXML-Datei bei und stellen ihre Gültigkeit sicher.

Mit Ausnahme der benannten Anweisungsgruppen, bei denen das Attribut configureStatus auf den Wert FINAL gesetzt ist, kann jede der folgenden Änderungen auftreten. Aufgrund der Änderungen ist es erforderlich, die betroffenen Pakete erneut zu binden.

Anmerkung: Das Dienstprogramm StaticBinder kann eine pureQueryXML-Datei nicht für den Bindeprozess verwenden, wenn Abschnittsnummern nicht in der richtigen Reihenfolge vorhanden sind oder sich SQL-Anweisungen in der falschen Anweisungsgruppe befinden. Ist der Wert des Attributs configureStatus auf FINAL gesetzt und das Dienstprogramm Configure stellt fest, dass eine dieser Änderungen angewendet wird, beendet das Dienstprogramm erforderlichenfalls die Konfigurationsoperation oder protokolliert Informationen zu diesem Problem.

Feedback