Damit Natural auf eine Db2-Tabelle zugreifen kann, muss ein logisches Natural-Datendefinitionsmodul (DDM) für die Tabelle generiert werden. Dies geschieht entweder mit Predict (Einzelheiten finden Sie in der entsprechenden Predict-Dokumentation) oder mit der Natural Utility SYSDDM. Siehe auch DDM-Editor (SYSDDM Utility) in der Natural Editoren-Dokumentation.
Wenn Sie Predict nicht installiert haben, verwenden Sie die SYSDDM-Funktion SQL Services, um Natural DDMs aus Db2-Tabellen zu erzeugen. Diese Funktion wird über das Hauptmenü der Utility SYSDDM aufgerufen und auf den folgenden Seiten beschrieben.
Weitere Informationen zu Natural DDMs finden Sie unter Datendefinitionsmodule (DDMs) im Natural-Leitfaden zur Programmierung .
In diesem Kapitel werden die folgenden Themen behandelt:
Die Funktion SQL Services (NDB) der Natural-Utility SYSDDM (siehe
SYSDDM Pflege- und
Service-Funktionen benutzen in der
Natural-Editoren-Dokumentation) wird für den Zugriff auf
Db2-Tabellen verwendet. Sie können damit auf den Katalog des Db2-Servers zugreifen, mit
dem Sie verbunden sind, indem Sie z.B. die Funktion Environment
Setting benutzen, wie in Natural Tools for DB2
beschrieben, oder indem Sie den Namen eines Servers in das Feld Server
Name im Menü SQL Services eingeben. Der Name des
Db2-Servers, mit dem Sie verbunden sind, wird dann in der oberen linken Ecke des
Bildschirms SQL Services Menu angezeigt. Sie können auf jeden
Db2-Server zugreifen, der sich entweder auf einem Großrechner (z/OS) oder einer
UNIX-Plattform befindet, wenn die Server über DRDA (Distributed Relational Database
Architecture) verbunden wurden. Weitere Einzelheiten zur Verbindung von Db2-Servern und
Informationen zur Bindung des Anwendungs-Package (SYSDDM verwendet das E/A-Modul NDBIOMO) für den Zugriff
auf Daten auf entfernten Servern finden Sie in der entsprechenden IBM-Literatur.
Die Funktion SQL Services ermittelt, ob Sie mit einem Großrechner-Db2 oder einem UNIX-Db2 verbunden sind, greift auf den entsprechenden Db2-Katalog zu und führt die unten aufgeführten Funktionen aus.
Anmerkung
Wenn Sie die SYSDDM SQL Services in einer CICS-Umgebung ohne File
Server verwenden, müssen Sie CONVERS=ON im NTDB2-Makro angeben, andernfalls erhalten Sie
möglicherweise SQLCODE -518.
SQL-Tabelle aus einer Liste auswählen - Funktion: Select SQL Table from a List
DDM aus einer SQL-Tabelle generieren - Funktion: Generate DDM from an SQL Table
Spalten einer SQL-Tabelle auflisten - Funktion: List Columns
Um die Funktion SQL Services aufzurufen:
Geben Sie in der Kommandozeile das Natural-Systemkommando
SYSDDM ein und drücken Sie Enter.
Oder:
Wählen Sie im Natural-Hauptmenü den Menüpunkt Maintenance and Transfer Utilities, um das Menü Maintenance and Transfer Utilities aufzurufen.
Wählen Sie im Menü Maintenance and Transfer Utilities die Option Maintain DDMs.
Das Menü der Utility SYSDDM wird angezeigt. Die Felder und Funktionen im Menü der Utility SYSDDM werden im Kapitel SYSDDM Pflege- und Service-Funktionen benutzen erläutert.
Geben Sie im Feld Code des Menüs der Utility SYSDDM den Code
B ein und drücken Sie Enter.
Das Menü SQL Services wird angezeigt.
11:31:39 ***** NATURAL SYSDDM UTILITY ***** 2009-11-27
Server DAEFDB29 - SQL Services: Menu -
Code Function
S Select SQL Table from a List
G Generate DDM from an SQL Table
L List Columns of an SQL Table
? Help
. Exit
Code ... _
Table name ... ________________________________
Creator ...... ________________________________
Replace ...... N (Y,N) DDM Name with Creator .. Y (Y/N)
Server name .. DAEFDB29__________
Remark ....... O (Overwrite/SQL/Comment)
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Canc |
Die auf diesem Bildschirm verfügbaren Funktionen werden in den entsprechenden Abschnitten beschrieben.
Die Funktion Select SQL Table from a List dient dazu, eine Db2-Tabelle aus einer Liste zur weiteren Bearbeitung auszuwählen.
Um die Funktion Select SQL Table from a List aufzurufen:
Geben Sie im Bildschirm SQL Services Menu den Funktionscode
S ein.
Wenn Sie nur den Funktionscode eingeben, erhalten Sie eine Liste aller im Db2-Katalog definierten Tabellen.
Wenn Sie nicht eine Liste aller Tabellen, sondern nur einen bestimmten Bereich von Tabellen auflisten möchten, können Sie zusätzlich zum Funktionscode einen Wert in den Feldern Table Name und/oder Creator (Ersteller) angeben. Sie können Stern-Notation (*) oder das Größer-als-Zeichen (>) als Anfangswert verwenden.
Drücken Sie Enter.
Der Bildschirm Select SQL Table From a List wird aufgerufen. Er zeigt eine Liste aller angeforderten Db2-Tabellen an. In der Liste können Sie eine Db2-Tabelle mit einem Funktionscode markieren:
| Code | Funktion | Beschreibung |
|---|---|---|
G |
Generate DDM from an SQL Table | Mit dieser Funktion können Sie auf der Basis der Definitionen im Db2-Katalog ein Natural DDM aus einer Db2-Tabelle generieren. |
L |
List Columns of an SQL Table | Diese Funktion listet alle Spalten einer bestimmten Db2-Tabelle auf. |
Mit dieser Funktion können Sie auf der Basis der Definitionen im Db2-Katalog ein Natural DDM aus einer Db2-Tabelle generieren.
Die folgenden Themen werden in diesem Abschnitt behandelt:
Um die Funktion aufzurufen:
Geben Sie im Bildschirm SQL Services Menu den
Funktionscode G zusammen mit dem Namen und dem Ersteller (Creator)
der Tabelle ein, für die Sie einen DDM generieren möchten.
Wenn Sie den Tabellennamen oder den Ersteller nicht kennen, können Sie die Funktion Select SQL Table from a List benutzen, um die gewünschte Tabelle auszuwählen.
Wenn Sie nicht möchten, dass der Ersteller der Tabelle Teil des DDM-Namens
ist, geben Sie ein N (Nein) in das Feld DDM Name with
Creator ein. Die Standardeinstellung ist Y
(Ja).
Wenn Sie ein DDM für eine Tabelle generieren möchten, für die bereits ein
DDM existiert, und Sie möchten, dass das bestehende DDM durch das neu
generierte DDM ersetzt wird, geben Sie ein Y (Ja) in das Feld
Replace (Ersetzen) ein.
Standardmäßig ist Replace auf N (Nein)
eingestellt, um zu verhindern, dass ein vorhandenes DDM versehentlich
ersetzt wird.
Im Feld Remark können Sie den Inhalt der DDM-Spalte Remark angeben. Geben Sie ein:
O (Overwrite)
|
für SQL-Spaltenbemerkungen, falls definiert, überschrieben durch Feldinformationen, die von Natural generiert werden, falls vorhanden. Dies ist die Standardeinstellung. |
S (SQL) für SQL-Spaltenbemerkungen, falls definiert,
sonst leer.
|
|
C (Comment)
|
für Feldinformationen, die von Natural generiert werden, falls verfügbar. SQL-Spaltenbemerkungen werden in eine separate DDM-Kommentarzeile kopiert. |
Standardmäßig ist Remark auf O
(Overwrite)
gesetzt.
Um einen Standardwert für die Felder Code,
Table Name (Tabellenname),
Creator (Ersteller), Replace
(Ersetzen), DDM Name with Creator (DDM-Name mit
Ersteller) oder Remark (Bemerkung) zu definieren oder
zu ändern, verwenden Sie den User-Exit NDBDDM-2 und seinen
Datenbereich NDBDDM-L, der in der Library SYSDB2 enthalten ist. Siehe
Eine User Exit Routine verfügbar machen.
Detaillierte Informationen zur Handhabung von NDBDDM-2 finden
Sie in den Erläuterungen im Quellcode.
Wichtig
Da die Angabe von Sonderzeichen als Teil eines Feld- oder DDM-Namens
den Natural-Namenskonventionen widerspricht, müssen alle in Db2
zulässigen Sonderzeichen vermieden werden. Auch abgegrenzte Db2-Bezeichner
müssen vermieden werden.
Um das Auftreten von Fenstern mit Benutzerinteraktion während der DDM-Feldgenerierung
zu vermeiden, kann der in der Library SYSDB2 enthaltene User-Exit
NDBDDM-1 und sein Datenbereich NDBDDM-L verwendet werden.
Detaillierte Informationen zur Handhabung von NDBDDM-1 finden Sie in den
Anmerkungen im Quellcode. Siehe auch
Eine User Exit Routine verfügbar machen.
Wenn die Funktion Generate DDM from an SQL Table für eine Tabelle aufgerufen wird, für die zum ersten Mal ein DDM generiert werden soll, wird der Bildschirm DBID/FNR Assignment angezeigt. Wenn ein DDM für eine Tabelle generiert werden soll, für die bereits ein DDM existiert, werden die vorhandene DBID und FNR verwendet und der Bildschirm DBID/ FNR-Assignment erscheint nicht.
Geben Sie auf dem Bildschirm DBID/FNR-Assignment eine der bei der Natural-Installation gewählten Datenbankkennungen (DBIDs) und die Dateinummer (FNR) ein, die der Db2-Tabelle zugewiesen werden soll. Natural benötigt diese Angaben nur zu Identifikationszwecken.
Der Bereich der DBIDs, der für Db2-Tabellen reserviert ist, wird im NTDB-Makro des
Natural-Parametermoduls (siehe Natural Parameter
Referenz-Dokumentation) für den Datenbanktyp Db2 angegeben. Jede DBID, die
nicht in diesem Bereich liegt, wird nicht akzeptiert. Die FNR kann eine beliebige
gültige Dateinummer innerhalb der Datenbank sein (zwischen 1 und
65535).
Nachdem eine gültige DBID und FNR zugewiesen worden sind, wird automatisch ein DDM aus der angegebenen Tabelle erzeugt.
Die von Natural unterstützte maximale Feldlänge beträgt 1 GB-1 (1073741823 Bytes). Wenn eine Db2-Tabelle eine Spalte enthält, die länger als 253 Bytes ist, oder wenn eine Db2-Spalte als Db2-LOB-Feld definiert ist, wird automatisch das Fenster Long Field Generation aufgerufen. Ein Db2-LOB-Feld kann als einfache Natural-Variable mit einer maximalen Länge von 1 GB-1 oder als dynamische Natural-Variable definiert werden.
Ein Feld, das länger als 253 Bytes ist und kein Db2-LOB-Feld ist, kann als einfaches Natural-Feld mit einer maximalen Länge von 1GB-1 oder als Array definiert werden. Im DDM wird ein solches Array als eine multiple Variable dargestellt.
Wenn z.B. eine Db2-Spalte eine Länge von 2000 Bytes hat, können Sie eine Array-Elementlänge von 200 Bytes angeben, und Sie erhalten ein multiples Feld mit 10 Ausprägungen, jede Ausprägung mit einer Länge von 200 Bytes.
Da generierte lange Felder keine multiplen Felder im Sinne von Natural sind, ergibt die Natural-C*-Notation hier keinen Sinn und wird daher nicht unterstützt.
Wenn ein solches generiertes langes Feld in einer Natural-Datensicht (View) definiert ist, die von Natural-SQL-Statements referenziert werden soll (d. h. von Host-Variablen, die multiple Felder darstellen), muss der angegebene Bereich von Ausprägungen (Indexbereich) sowohl bei der Definition als auch bei der Referenzierung immer mit Ausprägung 1 beginnen. Wenn nicht, wird ein Natural-Syntaxfehler zurückgegeben.
UPDATE table SET varchar = #arr(*) SELECT ... INTO #arr(1:5)
Anmerkung
Wenn ein solches generiertes langes Feld mit dem Natural DML UPDATE-Statement
aktualisiert wird, muss darauf geachtet werden, dass jede Ausprägung ordnungsgemäß
aktualisiert wird.
Für jeden der oben aufgeführten Spaltentypen wird im DDM ein zusätzliches
Längenindikatorfeld (Format/Länge I2 bzw. I4 für LOB-Felder) generiert. Die Länge wird
immer in der Anzahl der Zeichen und nicht in Bytes gemessen. Um die Anzahl der Bytes
eines VARGRAPHIC-, LONG VARGRAPHIC- oder
DBCLOB-Feldes zu erhalten, muss die Länge mit 2 multipliziert werden.
Der Name eines Längenindikatorfeldes beginnt mit L@, gefolgt vom Namen des entsprechenden Feldes. Der Wert des Längenindikatorfelds kann von einem Natural-Programm überprüft oder aktualisiert werden.
Ist das Längenindikatorfeld nicht Teil der Natural-View und handelt es sich bei dem
entsprechenden Feld um ein redefiniertes langes Feld, wird die Länge dieses Feldes bei
UPDATE- und STORE-Operationen ohne nachgestellte
Leerzeichen berechnet.
Mit Natural ist es möglich, zwischen einem Wert NULL und dem
tatsächlichen Wert Null (0) oder Blank (Leerzeichen) in einer Db2-Spalte zu
unterscheiden.
Wenn ein Natural DDM aus dem Db2-Katalog generiert wird, wird ein zusätzliches
NULL-Indikatorfeld für jede Spalte generiert, die NULL
sein kann, d.h. für die weder NOT NULL noch NOT NULL WITH
DEFAULT angegeben ist.
Der Name des NULL-Indikatorfeldes beginnt mit N@, gefolgt
von dem Namen des entsprechenden Feldes.
Wenn die Spalte aus der Datenbank gelesen wird, enthält das entsprechende
Indikatorfeld entweder Null (0) (wenn die Spalte einen Wert enthält, einschließlich
des Wertes 0 oder Leerzeichen) oder -1 (wenn die Spalte
keinen Wert enthält).
Die Spalte NULLCOL CHAR(6) in einer Db2-Tabellendefinition ergibt die
folgenden View-Felder führen:
NULLCOL A 6.0 N@NULLCOL I 2.0
Wenn das Feld NULLCOL aus der Datenbank gelesen wird, enthält das
zusätzliche Feld N@NULLCOL:
0 (Null), wenn NULLCOL einen Wert enthält
(einschließlich des Wertes 0 oder Leerzeichen),
-1 (minus Eins), wenn NULLCOL keinen Wert enthält.
Ein Nullwert kann in einem Datenbankfeld gespeichert werden, indem -1
als Eingabe für das entsprechende NULL-Indikatorfeld eingegeben wird.
Anmerkung
Wenn eine Spalte NULL ist, wird ein impliziter RESET für
das entsprechende Natural-Feld durchgeführt.
Für jede LOB-Spalte wird ein zusätzliches Locator-Feld im Format I4 generiert.
Ein LOB Locator kann verwendet werden, um einen LOB-Wert im
Db2-Datenbankserver zu referenzieren, wenn ein LOB-Wert nicht lokal in
einem Programm benötigt wird.
Diese Funktion listet alle Spalten einer bestimmten Db2-Tabelle auf.
Um die Funktion List Columns aufzurufen:
Geben Sie im Bildschirm SQL
Services Menu den Funktionscode L sowie den
Namen und den Ersteller (Creator) der Tabelle ein, deren Spalten Sie auflisten
möchten, und drücken Sie Enter.
Der Bildschirm List Columns für diese Tabelle wird aufgerufen. Er listet alle Spalten der angegebenen Tabelle auf und zeigt für jede Spalte die folgenden Informationen an:
| Variable | Inhalt | |
|---|---|---|
Name |
Db2-Name der Spalte. | |
Type |
Der Spaltentyp. | |
Length |
Die Länge (oder Genauigkeit, wenn der
Typ DECIMAL ist) der Spalte, wie im Db2-Katalog
definiert.
|
|
Scale |
Die Dezimalskalierung der Spalte (nur
anwendbar, wenn der Typ DECIMAL ist).
|
|
Update |
Y
|
Die Spalte kann aktualisiert werden. |
N |
Die Spalte kann nicht aktualisiert werden. | |
Nulls |
Y
|
Die Spalte kann Nullwerte enthalten. |
N |
Die Spalte kann keine Nullwerte enthalten. | |
Not |
Eine Spalte, deren Skalierungslänge
oder deren Typ von Natural nicht unterstützt wird, wird mit einem Stern
(*) gekennzeichnet. Für eine solche Spalte kann kein View-Feld generiert
werden. Die maximal unterstützte Skalierungslänge beträgt 7 Bytes.
Die folgenden SQL-Typen werden unterstützt: |
|
Die Datentypen DATE, TIME, TIMESTAMP,
FLOAT und ROWID werden in numerische oder
alphanumerische Felder unterschiedlicher Länge konvertiert: DATE in
A10, TIME in A8, TIMESTAMP in A26, FLOAT in
F8 und ROWID in A40. DATE und TIME können
alternativ auf Natural DATE bzw. Natural TIME abgebildet
werden.
Für Db2 bietet Natural eine Db2 TIMESTAMP-Spalte als
alphanumerisches Feld (A26) im Format
YYYY-MM-DD-HH.II.SS.MMMMMM. Alternativ
können Sie das Natural TIME-Feld (Datenformat T) als Db2
TIMESTAMP-Datentyp generieren, wenn die Option DBTSTI des
Systemkommandos COMPOPT auf ON gesetzt ist
(siehe Systemkommandos-Dokumentation).
Sie können das Natural-Subprogramm NDBSTMP verwenden, um
TIMESTAMP-Felder (A26) zu berechnen.
Sie können die Maske Generating Natural Data Definition Modules
(DDMs) mit der User-Exit-Routine NDBDDM-1 oder
NDBDDM-2 anpassen.
Um die User-Exit-Routine NDBDDM-1 oder NDBDDM-1 verfügbar zu machen:
Katalogisieren Sie das Quellcode-Objekt
NDBDDM-num in der Library SYSDB2 unter
dem Namen NDBDDMUnum.
Anmerkung
Die Namen des Quellcode-Objekts und des katalogisierten Objekts der
User-Exit-Routine müssen unterschiedlich sein, damit beim Überschreiben des
Quellcode-Objekts bei einer Update-Installation das katalogisierte Objekt nicht
verändert wird.
Kopieren Sie NDBDDMUnum in die Steplib
SYSLIBS.
Ein von der Utility SYSDDM verwendetes Subprogramm sucht in der Steplib SYSLIBS
nach NDBDDMUnum.
