Limit für Verarbeitungsschleifen
Mit diesem Natural Profil- und Session-Parameter können Sie das allgemeine Limit für Verarbeitungsschleifen in Natural-Programmen bestimmen, d.h. wieviele Datensätze eine Verarbeitungsschleife in einer Natural-Anwendung maximal verarbeiten darf.
Dieses Limit gilt für alle Statements, mit denen Datensätze aus der Datenbank gelesen werden, d.h.:
Statements, die eine Verarbeitungsschleife auslösen, wie zum Beispiel
READ
,
FIND
,
HISTOGRAM
oder
SELECT
und
Statements, mit denen nur ein einzelner Datensatz gelesen wird, wie zum
Beispiel FIND
UNIQUE
,
FIND
NUMBER
,
FIND
FIRST
, GET
(SAME
) und
SELECT
SINGLE
.
Alle gelesenen Datensätze werden gezählt und das Ergebnis dieser Zählung
wird mit dem im LT
-Parameter gesetzten Wert verglichen.
Hierbei werden alle gelesenen Datensätze mitgezählt, auch solche, die aufgrund
einer WHERE
-Klausel eines FIND
-, READ
-
oder HISTOGRAM
-Statements zurückgewiesen und nicht
weiterverarbeitet werden. Das mit dem LT
-Parameter
gesetzte Limit hat keine Auswirkung auf die Statements STORE
,
UPDATE
, DELETE
, END TRANSACTION
und
BACKOUT TRANSACTION
.
Wird ein Datensatz von der Datenbank gelesen, wird die Anzahl der
gelesenen Datensätze erhöht, bevor sie mit dem Wert des
LT
-Parameters verglichen wird. Übersteigt der erhöhte
Zählwert den aktuellen LT
-Wert, wird der Natural-Fehler
NAT1003 (Global limit for database calls reached
)
ausgegeben. Der Wert der gezählten gelesenen Datensätze wird immer dann auf
Null gesetzt, wenn ein Natural-Programm auf Level 1 gestartet wird. Der Wert
wird allerdings nicht zurückgesetzt, wenn das Programm auf Level 1 ein anderes
Natural-Objekt aufruft (weitere Informationen hierzu siehe
Mehrere
Stufen (Levels) aufgerufener Objekte im
Leitfaden zur Programmierung). Deshalb wird mit dem
LT
-Parameter die Anzahl der Datensätze begrenzt, die von
einem Level 1-Programm und von den Objekten gelesenen wurden, die von diesem
Programm auf einem anderen Level als Level 1 aufgerufen wurden.
Wird der Wert des LT
-Parameters dynamisch in einem
Programm mittels einem SET GLOBALS
LT=n
-Statement geändert, wird der neue
Limit-Wert beim nächsten Statement wirksam, das einen Datensatz von der
Datenbank liest.
In einer Natural-Session kann der Profilparameter
LT
durch den Session-Parameter LT
überschrieben werden.
Mögliche Werte | 0 - 2147483647
In einer Session: ( |
Maximale Anzahl der Datensätze, die in einer gegebenen Verarbeitungsschleife gelesen werden können. Hierbei werden alle gelesenen Datensätze mitgezählt, auch solche,
die aufgrund einer
|
|
---|---|---|---|
Standard-Einstellung | 99999999 |
||
Dynamische Spezifikation | ja | ||
Spezifikation in Session | ja | Gültige Statements: | SET
GLOBALS , siehe Anmerkung.
|
Gültiges Kommando: | GLOBALS ,
siehe Anmerkung.
|
||
Programmierschnittstelle (API) | USR1005N |
Siehe SYSEXT - Natural Application Programming Interfaces in der Utilities-Dokumentation. |
Anmerkung:
Wird der LT
-Parameter mit einem SET
GLOBALS
-Statement oder einem SET GLOBALS
-Systemkommando
benutzt, kann der einstellbare Limit-Wert nicht größer als der
LT
-Wert sein, der im Natural-Parametermodul NATPARM
gesetzt wurde.