Die Parameter für die Datenbank-Verwaltungssystem-Schnittstellen (Natural
DBMS Interfaces) Natural for
DB2, Natural for
SQL/DS und Natural SQL
Gateway können als Subparameter des Profilparameters
DB2
oder
des Makros NTDB2
angegeben werden.
Mögliche Werte | Siehe DB2-Parameter-Syntax. | |
---|---|---|
Standard-Einstellung | Siehe Schlüsselwort-Subparameter. | |
Dynamische Angabe | ja | Der Parameter DB2 kann nur dynamisch
angegeben werden. Im Natural-Parametermodul
wird das Makro NTDB2
verwendet.
|
Angabe innerhalb der Session | nein |
Dieses Dokument behandelt folgende Themen:
Der Profilparameter DB2
wird wie folgt
angegeben:
DB2=(keyword-subparameter=value,keyword-subparameter=value,...) |
Siehe Schlüsselwort-Subparameter.
Das Makro NTDB2
wird wie folgt angegeben:
NTDB2 BTIGN=value, * CONVERS=value, * CONVRS2=value, * DB2COLL=value, * DB2GROV=value, * DB2PLAN=value, * DB2SSID=value, * DB2XID=value, * DDFSERV=value, * DELIMID=value, * EBPFSRV=value, * EBPMAX=value, * EBPPRAL=value, * EBPSEC=value, * ETIGN=value, * FSERV=value, * MAXLOOP=value, * MAXSTMT=value, * NNPSF=value, * NNPSF=value, * NSBDATE=value, * NSBHOST=value, * NSBPORT=value, * PSCIGN=value, * REFRESH=value, * RETRYPO=value, * RWRDONL=value, * STATDYN=value
Siehe Schlüsselwort-Subparameter.
Es gibt zwei Gruppen von Schlüsselwort-Subparametern:
BTIGN
| CONVERS
|
CONVRS2
|
DDFSERV
|
DELIMID
|
EBPFSRV
|
EBPPRAL
|
EBPSEC
|
EBPMAX
|
ETIGN
|
FSERV
|
MAXLOOP
|
MAXSTMT
|
NNPSF
|
NSBDATE
|
NSBHOST
|
NSBPORT
|
PSCIGN
|
REFRESH
|
RETRYPO
|
RWRDONL
|
STATDYN
Die folgenden Schlüsselwort-Subparameter gehören zusammen. Sie gelten nur bei DB2 für z/OS in Umgebungen, in denen CAF und RRSAF verwendet wird.
DB2COLL
|
DB2GROV
|
DB2PLAN
|
DB2SSID
|
DB2XID
Anmerkungen:
COLLID
bereitstellt.
Somit werden die hier erwähnten Schlüsselwort-Subparameter in einer Natural for
DB2 Stored Procedure-Umgebung nicht benutzt. Bevor in einer CAF oder
RRSAF-Umgebung der allererste DB2 SQL-Zugriff durch Natural erfolgt, stellt
Natural die Verbindung zu dem gewünschten DB2-Subsystem (DB2SSID) her, und es
erfolgt die Zuordnung des geünschten Plans (DB2PLAN).
NTDB2
bzw. DB2
ignoriert, und es
wird die schon bestehende Verbindung benutzt.
BTIGN=value
ermöglicht es, den
Fehler zu ignorieren, der dadurch verursacht wurde, dass ein
BACKOUT
TRANSACTION
-Statement für die Rückgängigmachung der aktuellen
Transaktion zu spät abgesetzt wurde, weil zuvor schon ein impliziter Syncpoint
vom TP-Monitor abgesetzt worden war.
Wert: | Erklärung: |
---|---|
ON |
Der Fehler nach einem zu spät abgesetzten
BACKOUT TRANSACTION wird ignoriert.
Dies ist der Standardwert. |
OFF |
Der Fehler nach einem zu spät abgesetzten
BACKOUT TRANSACTION wird nicht ignoriert.
|
Anmerkungen:
CONVERS=name
ermöglicht den
konversationalen Modus in CICS-Umgebungen, in denen kein Natural File Server
verwendet wird.
Wert: | Erklärung: |
---|---|
ON |
Konversationaler Modus ist erlaubt.
Dies ist der Standardwert. |
OFF |
Konversationaler Modus ist not erlaubt. |
Anmerkungen:
OFF
gesetzt ist und kein
Natural File Server verwendet wird, können Sie keine Datenbankschleifen über
Terminal-Ein-/Ausgaben hinweg fortsetzen; in diesem Fall können folgende
Schlüssel auftreten.
CONVERS=ON
angeben, sonst kann der oben
erwähnte Fehler auftreten.
CONVRS2=value
dient dazu, in
CICS-Umgebungen den konversationalen Modus 2 zuzulassen bzw. nicht zuzulassen.
Wert: | Erklärung: |
---|---|
ON |
Der konversationale Modus 2 ist gestattet. |
OFF |
Der konversationale Modus 2 ist nicht
gestattet.
Dies ist der Standardwert. |
Anmerkungen:
COMMIT
oder explizites
ROLLBACK
-Statement abgesetzt worden ist (Vorsicht: DB2- und
CICS-Ressourcen werden über Terminal-Ein-/Ausgaben beibehalten!). Das bedeutet,
dass CONVRS2=ON
die gleiche Wirkung hat wie der
Natural-Profilparameter PSEUDO=OFF
, aber mit der
Ausnahme, dass der konversationale Modus nach einem
DB2-Datenbank-Aktualiserungs-Statement (UPDATE
,
DELETE
, INSERT
) begonnen und nach einem
COMMIT
oder ROLLBACK
wieder beendet wird, während
PSEUDO=OFF
konversationalen Modus für die ganze Natural-Session
bewirkt.
CALLNAT
-Subprogramm
NDBCONV
(in der Database Management System
Interfaces-Dokumentation), mit dem der konversationale Modus 2
dynamisch gesetzt und zurückgesetzt werden kann.
DB2COLL=value
dient zur Angabe
des Collection-Namens von DB2-Paketen, die von der Anwendung in einer Umgebung
benutzt werden, in das RRSAF Interface eingesetzt wird.
Wert: | Erklärung: |
---|---|
value |
Ein gültiger, 18 Zeichen langer DB2 Collection-Name. |
' ' (leer) | Es ist kein Name angegeben. Dies ist der Standardwert. |
Anmerkungen:
DB2GROV=value
gibt an, ob die
durch DB2SSID
gekennzeichnete Verbindung zum DB2-System mit dem einzelnen DB2-Subsystem oder
mit der DB2 Sharing Group hergestellt werden soll, falls eine Sharing Group und
ein einzelnes DB2 mit identischer DB2SSID existiert.
Wert: | Erklärung: |
---|---|
' ' (leer) | Die Verbindung wird zu der durch
DB2SSID gekennzeichneten DB2 Sharing Group hergestellt.
Dies ist der Standardwert. |
NOGROUP |
Die Verbindung wird zu dem durch
DB2SSID gekennzeichneteen Subsystem hergestellt.
|
Anmerkungen:
DB2PLAN=value
dient zur Angabe
des Namens des von der Anwendung benutzten Plans.
Wert: | Erklärung: |
---|---|
value |
Ein gültiger, 8 Zeichen langer DB2-Planname.
Wenn das erste Zeichen ein Fragezeichen (?) ist und wenn die Anwendung das
RRSAF Interface benutzt, dann verwendet die Anwendung die Pakete, die durch den
Collection-Namen gekennzeichnet sind, der mit dem Subparameter
DB2COLL
angegeben wurde.
|
' ' (leer) | Es ist kein Name angegeben. Dies ist der Standardwert. |
Anmerkungen:
DB2SSID=value
gibt den Namen
der DB2 Sharing Group bzw. den Namen des DB2-Subsystems an, zu dem die
Verbindung hergestellt werden soll.
Wert: | Erklärung: |
---|---|
value |
Ein gültiger, 4 Zeichen langer Name einer DB2 Sharing Group oder eines DB2-Subsystems. |
' ' (leer) | Es ist kein Name angegeben. Dies ist der Standardwert. |
Anmerkungen:
DB2XID=value
gibt an, ob das
RRSAF Interface eine globale Transaktionskennung verwenden soll oder nicht.
Wert: | Erklärung: |
---|---|
ON |
RRSAF erzeugt eine globale Transaktionskennung.
Dies ist der Standardwert. |
OFF |
RRSAF erzeugt keine globale Transaktionskennung. |
Anmerkungen:
DDFSERV=ddname
gibt einen
DD-Namen für das Natural File Server-Modul an.
Wert: | Erklärung: |
---|---|
ddname |
Jeder gültige 8 Zeichen lange DD-Name. |
CMFSERV |
Dies ist der Standard-Name. |
Anmerkung:
Dieser Subparameter wird von Natural for SQL/DS ignoriert.
DELIMID=value
gibt das
Escape-Zeichen an, das für die Generierung von SQL-Begrenzungskennzeichen für
die Spaltennamen und Tabellennamen in SQL-Statements verwendet werden soll.
Wert: | Erklärung: |
---|---|
DQ |
Doppeltes Hochkomma ('') |
SQ |
Einzelnes Hochkomma (') |
OFF |
Begrenzungskennungen sind nicht aktiv.
Dies ist der Standardwert. |
Anmerkungen:
DELIMID
in doppelte (''
) oder einzelne
('
) Hochkommas gesetzt werden.
DELIMID
angegebene Escape-Zeichen
und der SQL STRING DELIMITER
schließen sich gegenseitig
aus. Das impliziert, dass die zum Einschließen von alphanumerischen
Zeichenketten in SQL-Statements verwendete Markierung (doppeltes oder einzelnes
Hochkomma) unterschiedlich zu dem Wert sein muss, der bei
DELIMID
angegeben ist. Wenn Sie Begrenzungskennzeichen
ermöglichen, müssen Sie außerdem sicherstellen, dass der bei
DELIMID
angegebene Wert mit dem Begrenzungszeichen für
SQL-Zeichenketten in Ihrer DB2-Installation übereinstimmt.
RWRDONL
.
IIn dem folgenden Beispiel ist als Escape-Zeichen für das
Begrenzungskennzeichen ein doppeltes Hochkomma (''
) verwendet
worden:
Natural-Statement:
SELECT FUNCTION INTO #FUNCTION FROM XYZ-T1000
Generierte SQL-Zeichenkette:
SELECT "FUNCTION" FROM XYZ.T1000
EBPFSRV=value
gibt an, ob der
Natural File Server den Software AG Editor buffer
pool als Speichermedium benutzt.
Wert: | Erklärung: |
---|---|
ON |
The Software AG Buffer Pool soll als
Speichermedium für den Natural File Server benutzt werden.
|
OFF |
Eine VSAM-Datei soll als Speichermedium für den
Natural File Server benutzt werden.
Dies ist der Standardwert. |
Anmerkung:
Dieser Subparameter wird von Natural for SQL/DS ignoriert.
EBPMAX=value
gibt die maximale
Anzahl an Blöcken an, die für jeden Benutzer des Natural File Server zugeordnet
werden soll, wenn der Software AG Editor buffer
poolals Speichermedium benutzt wird.
Wert: | Erklärung: |
---|---|
0 - 32676 |
Maximale Anzahl an Blöcken, die zugeordnet werden soll. |
100 |
Dies ist der Standardwert. |
Anmerkungen:
EBPFSRV
auf
OFF
gesetzt ist, wird EBPMAX
zur Laufzeit
nicht berücksichtigt.
EBPPRAL=value
gibt die Anzahl
an Blöcken an, die primär für jeden Benutzer des Natural File Server zugeordnet
werden soll, wenn der Software AG Editor buffer
pool als Speichermedium benutzt soll.
Wert: | Erklärung: |
---|---|
0 - 32676 |
Anzahl an Blöcken, die primär zugeordnet werden soll. |
20 |
Dies ist der Standardwert. |
Anmerkungen:
EBPFSRV
auf
OFF
gesetzt ist, wird EBPPRAL
zur Laufzeit
nicht berücksichtigt.
EBPSEC=value
der Subparameter
gibt die Anzahl an Blöcken an, die sekundär für jeden Benutzer des Natural File
Server zugeordnet werden soll, wenn der
Software AG Editor buffer
pool als Speichermedium benutzt soll.
Wert: | Erklärung: |
---|---|
0 - 32676 |
Anzahl an Blöcken, die primär zugeordnet werden soll. |
10 |
Dies ist der Standardwert. |
Anmerkungen:
EBPFSRV
auf
OFF
gesetzt ist, wird EBPSEC
zur Laufzeit
nicht berücksichtigt.
ETIGN=value
wird benutzt, um
END TRANSACTION
Statements in einer nachrichtenorientierten
IMS-Region (MPP oder nachrichtenorientiertes BPM) zu behandeln.
Wert: | Erklärung: |
---|---|
ON |
Der END TRANSACTION -Fehler wird
ignoriert, und die Verarbeitung wird fortgesetzt.
Dies ist der Standardwert. |
OFF |
Der END TRANSACTION -Fehler wird
nicht ignoriert.
|
Anmerkungen:
END TRANSACTION
Statement nicht durch das Natural IMS TM Interface ausgeführt werden und wird
deshalb ohne Benachrichtigung ignoriert. In solchen Situationen kann der
Subparameter ETIGN
benutzt werden, um ersatzweise eine
Fehlermeldung auszugeben.
FSERV=value
gibt an, ob der
Natural File Server benutzt werden soll und ob er im Falle eines
Initialisierungsfehlers gesperrt werden kann.
Wert: | Erklärung: |
---|---|
ON |
Der Natural File Server soll benutzt werden. |
OFF |
Der Natural File Server soll nicht benutzt
werden.
Dies ist der Standardwert. |
DIS |
Der Natural File Server soll benutzt werden, aber er soll gesperrt werden, wenn er nicht initialisiert werden kann. |
Anmerkungen:
FSERV
auf ON
gesetzt ist
und wenn der Natural File Server nicht betriebsbereit ist, wird die
Initialisierung von Natural for DB2 mit einer entsprechenden
Natural-Fehlermeldung beendet. Das Natural for DB2 Interface wird deaktiviert,
und jeder SQL-Aufruf wird mit einer entsprechenden Fehlermeldung
zurückgewiesen.
MAXLOOP=nn
gibt die maximal
mögliche Anzahl an verschachtelten SQL-Datenbankzugriff-Statements an.
Wert: | Erklärung: |
---|---|
1 - 99 |
Maximal mögliche Anzahl an Datenbankzugriff-Statements. |
10 |
Dies ist der Standardwert. |
MAXSTMT=value
gibt die maximal
mögliche Anzahl zugeordneter dynamischer SQL-Statements für Natural SQL Gateway
an.
Wert: | Erklärung: |
---|---|
1 - 99 |
Maximal mögliche Anzahl zugeordneter dynamischer SQL-Statements. |
10 |
Dies ist der Standardwert. |
Anmerkung:
Dieser Subparameter wird von Natural for DB2 und von Natural for
SQL/DS ignoriert.
NNPSF=value
wird benutzt, um
das Zeichen für das Vorzeichen positiver Natural-Variablen mit Format N zu
ändern, wenn diese vom SQL-Datenbanksystem gefüllt werden. Normalerweise haben
diese Variablen das C
als Zeichen für das positive Vorzeichen.
Wenn der Subparameter NNPSF
auf ON
gesetzt
wird, dann wird F
als Zeichen für das positive Vorzeichen
verwendet.
Wert: | Erklärung: |
---|---|
ON |
Positive Zahlen, die vom SQL-Datenbanksystem in
Natural-Variable eingestellt werden, erhalten das F als
Vorzeichen.
|
OFF |
Positive Zahlen, die vom SQL-Datenbanksystem in
Natural-Variable eingestellt werden, bleiben unverändert.
Dies ist der Standardwert. |
Anmerkung:
Dieser Subparameter wird von Natural for SQL/DS ignoriert.
NSBDATE=value
gibt das Format
an, in dem der Natural SQL Gateway Server Datumszeichenketten an die Anwendung
zurückgibt. Standardmäßig gibt die Anwendung ein SQL-Datum als Zeichenkette im
ISO-Format (YYYY-MM-DD
) zurück. Die Einstellung
NSBDATE=E
ermöglicht es, dass die Anwendung
SQL-Datumszeichenketten im EUR-Format (DD.MM.YYYY
) zurückgibt.
Wert: | Erklärung: |
---|---|
' ' |
Natural SQL Gateway gibt SQL-Datumszeichenketten
im ISO-Format (YYYY-MM-DD ) zurück.
Dies ist der Standardwert. |
E |
Natural SQL Gateway gibt SQL-Datumszeichenketten
im (DD.MM.YYYY ) zurück.
|
Anmerkung:
Dieser Subparameter wird von Natural for DB2 und von Natural for
SQL/DS ignoriert.
NSBHOST=value
gibt für Natural
SQL Gateway den TCP/IP Host-Namen an, der für die Kommunikation von
TP-Monitor-Umgebungen wie z.B. CICS oder Com-Plete nach CONNX JDBC verwendet
wird, um auf Datenbanken zuzugreifen.
Wert: | Erklärung: |
---|---|
hostname |
Dieser Host-Name bezeichnet die TCP/IP-Adresse des Natural SQL Gateway Server, der mit dem CONNX JDBC Server kommuniziert. |
LOCALHOST |
Dies ist der Standardwert; er bedeutet, dass sich der Natural SQL Gateway Server resident auf dem lokalen Host befindet. |
Anmerkungen:
NSBHOST='IBM2.HQ.SAG'
NSBPORT=value
gibt die Nummer
des TCP/IP Port an, von welchem der Natural SQL Gateway Server Daten
empfängt.
Mögliche Werte:
Wert: | Erklärung: |
---|---|
integer |
Gibt die Nummer des TCP/IP Port an, von welchem der Natural SQL Gateway Server Daten empfängt. |
0 |
Dies ist der Standardwert; er bedeutet, dass keine Natural SQL Gateway Server Port-Nummer angegeben ist. |
Anmerkung:
Dieser Subparameter wird von Natural for DB2 und von Natural for
SQL/DS ignoriert.
NSBPORT=4713
PSCIGN=value
hat Einfluss
darauf, wie positive SQLCODEs, die vom SQL-Datenbanksystem zurückgeliefert
werden, behandelt werden.
Wert: | Erklärung: |
---|---|
ON |
Positive SQLCODEs werden als Null behandelt. |
OFF |
Positive SQLCODEs verursachen eine Fehlermeldung
(NAT3700).
Dies ist der Standardwert. |
Anmerkungen:
PSCIGN
auf
OFF
gesetzt ist, wird die Fehlermeldung NAT3700
ausgegeben.
PSCIGN
auf
ON
gesetzt ist, werden positive SQLCODEs so behandelt, als ob sie
Null wären; das bedeutet, es wird keine Fehlermeldung (NAT3700)
ausgegeben.
REFRESH=value
dient dazu, den
DB2 Server und Package Set automatisch auf die Werte zu setzen, die bei der
Ausführung der letzten Transaktion gültig waren.
Wert: | Erklärung: |
---|---|
ON |
Jedes Mal, bevor eine Datenbanktransaktion beginnt, und wenn ein Server oder ein Package Set angegeben worden ist, erfolgt eine automatische Aktualisierung. |
OFF |
Es erfolgt keine automatische Aktualisierung.
Dies ist der Standardwert. |
Anmerkungen:
CONNECT TO server-name
und SET CURRENT PACKAGESET =
'package-name'
aktualisiert.
RETRYPO=value
begrenzt die
Anzahl der erneuten Versuche, die von Natural for DB2 unternommen werden, um
einen dynamisch verschiebbaren Cursor in einer pseudo-konversationalen Umgebung
(IMS MPP oder CICS) erneut zu positionieren.
Wert: | Erklärung: |
---|---|
1 - 2147483648 |
Anzahl der von Natural for DB2 unternommenen erneuten Versuche. |
0 |
Wenn RETRYPO auf
0 gesetzt ist, erfolgen keine Wiederholungsversuche.
|
10 |
Dies ist der Standardwert. |
Anmerkungen:
RETRYPO
) erreicht ist. In letzterem
Fall wird die Fehlermeldung NAT3703 ausgegeben. Wenn eine Tabellenzeile
abgerufen wird, deren Schlüsselspalten mit den gespeicherten Werten
übereinstimmen, wird die Verarbeitung mit der nächsten Datenbankanweisung
fortgesetzt.
RETRYPO
begrenzt die Wiederholversuche in
beiden Richtungen (nächster bzw.
vorhergehender).
RWRDONL=value
legt fest, welche
Kennzeichen als Begrenzungskennzeichen in einer SQL-Zeichenkette generiert
werden.
Wert: | Erklärung: |
---|---|
ON |
Nur Kennzeichen, die reservierte Wörter sind,
werden als Begrenzungskennzeichen generiert. Die Liste der reservierten Wörter
ist im Modul NDBPARM enthalten. Diese Liste ist eine
Zusammenfassung der Einträge aus den Listen für reservierte Wörter für DB2 für
z/OS, DB2 für VSE & VM, DB2 für LINUX, OS/2, Windows und UNIX sowie aus
ISO/ANSI SQL99.
Dies ist der Standardwert. |
OFF |
Alle Kennzeichen werden als Begrenzungskennzeichen generiert. |
Anmerkung:RWRDONL
wird nur dann wirksam, wenn die
Einstellung des Subparameters DELIMID
Begrenzungskennzeichen zulässt.
STATDYN=value
wird verwendet,
um die Ausführung von statisch generierten SQL-Statements zuzulassen, wenn die
statische Ausführung einen Fehler zurückliefert.
Wert: | Erklärung: |
---|---|
NEVER |
Die dynamische Ausführung wird niemals
gestattet.
Dies ist der Standardwert. |
ALWAYS |
Die dynamische Ausführung ist immer nach einem Fehler gestattet. |
SPECIAL |
Die dynamische Ausführung ist nur nach
speziellen Fehlern gestattet.
Spezielle Fehler sind:
|
Anmerkung:
Dieser Subparameter wird von Natural SQL Gateway ignoriert.
DB2=(FSERV=DIS,DELIMID=DQ,RWRDONL=ON,STATDYN=ALWAYS)
NTDB2 FSERV=ON, * DELIMID=DQ, * NSBHOST=LOCALHOST, * NSBPORT=4851, * RWRDONL=ON