Befehl "sibDDLGenerator"
Eine Messaging-Engine benötigt zum Erstellen der DBMS-Ressourcen DDL-Anweisungen (Data Definition Language). Diese DBMS-Ressourcen werden mit dem Befehl sibDDLGenerator erstellt.
Syntax
>>-sibDDLGenerator--+---------------------+---------------------> '- -system--DBMS-Name-' >--+-------------------------+----------------------------------> '- -version--DBMS-Version-' >--+----------------------------+--+----------------------+-----> '- -platform--DBMS-Plattform-' '- -schema--Schemaname-' >--+----------------------+--+----------+-----------------------> '- -user--Benutzername-' +- -create-+ '- -drop---' >--+-----------------------+------------------------------------> '- -database--Datenbank-' >--+--------------------------------+---------------------------> '- -storagegroup--Speichergruppe-' >--+----------------------------------------------------+-------> '- -catalog--Qualifikationsmerkmal der höheren Ebene-' >--+--------------------------+---------------------------------> '- -bufferpool--Pufferpool-' >--+--------------------------------+--+----------------+-------> '- -statementend--Anweisungsende-' '- -nolinebreaks-' >--+----------------+--+--------------------------+-------------> '- -noblanklines-' '- -firstline--erste Zeile-' >--+--------------------------+--+---------------------+--------> '- -lastline--letzte Zeile-' '- -permanent--Anzahl-' >--+---------------------+------------------------------------->< '- -temporary--Anzahl-'
Zweck
Eine Messaging-Engine benötigt DBMS-Ressourcen, wie z. B. Datenbanktabellen, die sie beim Starten erstellen kann. Wenn Ihre Installation eine Richtlinie verwendet, die festlegt, dass nur der Datenbankadministrator zum Erstellen von Datenbanktabellen berechtigt ist, können Sie mit dem Befehl sibDDLGenerator Ihrem Datenbankadministrator ermöglichen, die DBMS-Ressourcen zu erstellen, die die Messaging-Engine benötigt. Der Befehl sibDDLGenerator generiert die DDL-Anweisungen, die Ihr Datenbankadministrator speichern und später bearbeiten kann, um die DBMS-Ressourcen zu erstellen, die im Artikel Datenspeichertabellen aufgelistet sind.
Der Befehl generiert außerdem DDL-Anweisungen, die einer Messaging-Engine die erforderlichen Berechtigungen zur Verwendung dieser Tabellen erteilen.
Verwenden Sie für den Zugriff
auf die Befehlszeile von IBM® i
den Befehl STRQSH, um eine Qshell-Sitzung zu starten.
Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.
Optionale Parameter
Einige Parameter gelten nur für ein bestimmtes DBMS, wie in der Parameterliste angegeben. Beispiel: -database [gilt nur für DB2 für z/OS].
- -system
- Gibt den Typ des DBMS an, in dem der Administrator die DDL-Anweisungen bearbeitet.
Gültige Werte:
- db2
- oracle
- sqlserver
- sybase
- informix
- derby
- -version
- Die Versionsnummer des mit dem Parameter -system angegebenen DBMS.
Die folgende Tabelle zeigt den Standardwert, der verwendet wird, wenn Sie den Parameter
-version nicht angeben.
Wenn Sie bei der Ausführung des Tools einen Fehler CWSIS1595E oder CWSIS1503E empfangen, sehen Sie sich die Anmerkungen hinter der Tabelle an, um festzustellen, ob ein alternativer Parameter -version für Ihre Datenbankversion verwendet werden kann.
Tabelle 1. Werte für den Parameter -version. In der ersten Spalte der Tabelle sind die Parameterwerte für "-system" aufgelistet. In der zweiten Spalte der Tabelle sind die Parameterwerte für "-platform" aufgeführt. Die dritte Spalte der Tabelle enthält die Standardwerte für die Parameter "-version". In der vierten Spalte der Tabelle sind die weiteren gültigen Werte der Parameter "-version" aufgelistet. Wert für den Parameter -system Wert für den Parameter -platform Standardwert für den Parameter -version Weitere akzeptierte Werte für den Parameter -version db2 zos 7.1 8.1, 9.1 (siehe Anmerkung 1) db2 unix, windows 8.1 9.1 (siehe Anmerkung 1) db2 iseries 5.2 (siehe Anmerkung 2) 5.3 (siehe Anmerkung 2) oracle 8i 10g, 11g (siehe Anmerkung 3) sqlserver 2000 2005 sybase 12.0 12.5, 15.0 informix 9.3 7.3, 9.4, 10.0, 11.0 (siehe Anmerkung 4) derby 10.1 Anmerkungen:- Die für DB2 for UNIX oder Windows mit den Werten 8.1 und 9.1 für den Parameter -version generierten DDLs sind identisch. Die für DB2 for z/OS mit den Werten 7.1, 8.1 und 9.1 für den Parameter -version generierten DDLs sind identisch.
- Für IBM i gehört die DB2-Datenbank zum Betriebssystem. Deshalb ist die angegebene Versionsnummer für die Version OS/400 bestimmt.
- Die für Oracle mit den Werten 10g und 11g für den Parameter -version generierten DDLs sind identisch.
- Die für Informix mit den Werten 10.0 und 11.0 für den Parameter -version generierten DDLs sind identisch.
- -platform
- Die Betriebssystemplattform, auf der das DBMS ausgeführt wird. Gültige Werte:
- iseries
- unix
- windows
- zos
- -schema
- Der Name des Schemas, das alle Objekte enthält, die von der Messaging-Engine verwendet werden. Wenn Sie den Parameter -schema nicht angeben, wird der Standardwert IBMWSSIB verwendet.
- -user
- Der Name der Benutzer-ID, die für die Interaktion mit dem DBMS verwendet wird. Wenn Sie den Parameter -user nicht angeben, wird der Standardwert IBMUSER verwendet.
- -create | -drop
- Gibt an, ob die DDL-Anweisungen DBMS-Ressourcen erstellen oder löschen. Wenn Sie keinen der Parameter angeben, ist der Standardwert -create.
- -database [gilt nur für DB2 for z/OS]
- Der Name der Datenbank, die für die Tabellen der Messaging-Engine zugeordnet wird. Wenn Sie den Parameter -database nicht angeben, wird der Standardwert SIBDB verwendet.
- -storagegroup [gilt nur für DB2 for z/OS]
- Der Name der Speichergruppe, die für die Tabellen der Messaging-Engine zugeordnet wird.
- Wenn Sie die Parameter -storagegroup und -catalog angeben, fügt der Befehl sibDDLGenerator beide Werte in die Anweisung CREATE STOGROUP ein.
- Wenn Sie nur den Parameter -storagegroup angeben, verwendet der Befehl sibDDLGenerator den Namen der Speichergruppe in anderen Anweisungen, aber erstellt keine Anweisung CREATE STOGROUP.
- Wenn Sie nur den Parameter -catalog angeben, zeigt der Befehl sibDDLGenerator den Verwendungshinweis an und wird dann beendet.
- Wenn Sie beide Parameter weglassen, verwendet der Befehl sibDDLGenerator den Standardwert SIBSG als Namen für die Speichergruppe in anderen Anweisungen, erstellt aber keine Anweisung CREATE STOGROUP.
- -catalog [gilt nur für DB2 for z/OS]
- Der Name des High Level Qualifier (HLQ) für die Speichergruppe, die für die Tabellen der Messaging-Engine zugeordnet wird. Informationen zu den Standardwerten können Sie der Beschreibung des Parameters -storagegroup entnehmen.
- -bufferpool [gilt nur für DB2 for z/OS]
- Der Name des Pufferpools, der für die Tabellen der Messaging-Engine zugeordnet wird. Wenn Sie den Parameter -bufferpool nicht angeben, wird der Standardwert BP1 verwendet.
- -statementend
- Hängt statement_end an jede DDL-Anweisung an. Beispielsweise können Sie ein Semikolon
(;) verwenden, das jeder DDL-Anweisung angefügt werden soll.
Standardmäßig hängt der Befehl sibDDLGenerator nichts an eine Anweisung an.
Tipp: Auf UNIX-Plattformen müssen Sie dem Semikolon ein Escape-Zeichen voranstellen, um zu verhindern, dass es von der Shell interpretiert wird.
- -nolinebreaks
- Stellt jede Anweisung ohne Zeilenumbruch in eine gesonderte Zeile. Standardmäßig bricht der Befehl sibDDLGenerator die Anweisungen zur besseren Lesbarkeit um.
- -noblanklines
- Fügt zwischen Anweisungen keine Leerzeilen ein. Standardmäßig fügt der Befehl sibDDLGenerator zur besseren Lesbarkeit nach jeder Anweisung eine Leerzeile ein.
- -firstline
- Generiert first_line als erste Zeile der Ausgabe. Beispielsweise können Sie als erste_Zeile die Zieldatenbank angeben. Standardmäßig generiert der Befehl sibDDLGenerator keine erste Zeile.
- -lastline
- Generiert last_line als letzte Zeile der Ausgabe. Sie können beispielsweise last_line verwenden, um einen Befehl aufzurufen, der die Befehle im Script ausführt. Standardmäßig generiert der Befehl sibDDLGenerator keine letzte Zeile.
Die folgenden beiden optionalen Parameter werden verwendet, um den Datenspeicher auf mehrere Tabellen zu verteilen:
- -permanent
- Die Anzahl permanenter Tabellen mit
- Standardwert: 1
- Mindestwert: 1
- Maximalwert: siehe Anmerkung
- -temporary
- Die Anzahl temporärer Tabellen mit
- Standardwert: 1
- Mindestwert: 1
- Maximalwert: siehe Anmerkung
Beispiele
- sibDDLGenerator -system db2 -version 8.1 -platform zos
Generiert DDL-Anweisungen für DB2 8.1 unter z/OS mit einem Standardschema, einer Standardbenutzer-ID, einer Standarddatenbank, einer Standardspeichergruppe und einem Standardpufferpool.
- sibDDLGenerator -system db2 -version 8.1 -platform windows -statementend ;
Generiert DDL-Anweisungen für DB2 8.1 unter Windows mit einem Standardschema, einer Standardbenutzer-ID und einer Standarddatenbank. Sie können die Anweisungen direkt in DB2-CLP eingeben. Dazu muss am Ende jeder Anweisung ein Semikolon stehen.
- sibDDLGenerator -system oracle -version 8i -schema SIB -user fred
Generiert DDL-Anweisungen für Oracle 8i.
- sibDDLGenerator -system oracle -schema SIB -user fred
Eine präzise Version des vorherigen Beispiels.