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

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-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.

[IBM i]Verwenden Sie für den Zugriff auf die Befehlszeile von IBM® i den Befehl STRQSH, um eine Qshell-Sitzung zu starten. [IBM i]Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.

Anmerkung: Der Befehl sibDDLGenerator kann die DDL-Anweisungen für das Erstellen und Löschen aller Datenspeichertabellen generieren. Für das Hinzufügen weiterer Elementtabellen zum Datenspeicher ist der Befehl weniger geeignet. Es ist jedoch möglich, die DDL-Anweisung erneut abzusetzen, um vorhandene Tabellen zu erstellen, ohne den Datenspeicher zu beschädigen.

Optionale Parameter

Tipp: Der Befehl sibDDLGenerator unterscheidet zwischen Groß- und Kleinschreibung. Der Parameterwert Oracle ist beispielsweise nicht identisch mit dem Parameterwert oracle.

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
Wenn Sie den Parameter -system nicht angeben, ist der Standardwert 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:
  1. 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.
  2. Für IBM i gehört die DB2-Datenbank zum Betriebssystem. Deshalb ist die angegebene Versionsnummer für die Version OS/400 bestimmt.
  3. Die für Oracle mit den Werten 10g und 11g für den Parameter -version generierten DDLs sind identisch.
  4. 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.
Tipp: Mit den optionalen Parametern, die das Format der DDL-Anweisungen steuern, z. B. -statementend, können Sie eine Ausgabe generieren, die sich für bestimmte Scripting-Tools, wie z. B. CLP von DB2, eignet. Standardmäßig generiert der Befehl sibDDLGenerator Leerzeichen zwischen den einzelnen DDL-Anweisungen, fügt aber kein Semikolon am Ende einer DDL-Anweisung an.

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
Anmerkung: Die maximale Anzahl der SIBnnn-Tabellen, die eine Messaging-Engine verwenden kann, ist 32. Dazu gehören alle Datenstrom-, permanenten und temporären Tabellen.

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.


Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjm0630_
Dateiname:rjm0630_.html