READ RESULT SET - SQL

Sie können die Anzahl der zu lesenden Reihen begrenzen. Sie können das limit entweder als numerische Konstante (0 bis 99999999) oder als Variable mit Format N, P oder I angeben.

Als result-set geben Sie eine Result-Set-Locator-Variable an, die mit einem vorhergehenden CALLDBPROC-Statement gefüllt wurde. Result-set muss eine Variable von Format/Länge I4 sein.

Anmerkung:
Falls zwischen dem CALLDBPROC-Statement und dem READ RESULT SET-Statement eine Syncpoint-Operation stattfand, kann das READ RESULT SET-Statement nicht mehr auf die Result Sets zugreifen.

Als ddm-name geben Sie den Namen des DDMs an, das benutzt wird, um auf die Datenbank zuzugreifen, die die Stored Procedure ausführt. Weitere Informationen siehe ddm-name.

Diese Klausel gehört zum SQL Extended Set.

Mit dieser Klausel wird die Anwendung veranlasst, einen beliebig positionierbaren Insensitive Cursor zu verwenden, um auf den von der zuvor aufgerufenen Stored Procedure erstellten Result Set zuzugreifen. Damit diese Klausel verwendet werden kann, muss die Stored Procedure den Result Set mit einem beliebig positionierbaren Cursor erstellt haben. scroll_hv muss eine alphanumerische Natural-Variable sein, die die Scroll-Richtung enthält. scroll_hv wird bei jeder Ausführung der READ RESULT SET-Verarbeitungsschleife ausgewertet.

Wenn auch die Option GIVING sqlcode angegeben wird, bleibt die Verarbeitungsschleife auch dann geöffnet, wenn der SQL-Code +100 (Row not found) von der RDBMS zurückgeliefert wird.

Die Verabeitung wird beendet, wenn die Anwendung ein ESCAPE-Statement absetzt oder wenn der der SQL-Code +100 fünf Mal auftritt, ohne dass ein Terminal I/O erfolgt ist.

Wird die Option GIVING sqlcode nicht angegeben, so wird die Verabeitungsschleife beendet, wenn ein SQL-Code von der RDBMS zurückgeliefert wird, der nicht 0 (Success) ist.

Mit dieser Option erhalten Sie den SQL-Code der SQL-Fetch-Operation, mit der der Result Set verarbeitet wurde.

Wenn Sie diese Option angeben und der SQL-Code der SQL-Operation ist nicht 0, wird keine Natural-Fehlermeldung ausgegeben. In diesem Fall muss die als Reaktion auf den SQL-Codewert auszuführende Handlung im aufrufenden Natural-Objekt programmiert werden.

Das sqlcode-Feld muss eine Variable mit Format/Länge I4 sein.

Wenn Sie die Option GIVING sqlcode nicht verwenden, gibt Natural eine Fehlermeldung aus, falls der SQL-Code nicht 0 ist.

Diese Klausel gehört zum SQL Extended Set.

Mit dieser Klausel wird die Anwendung veranlasst, einen beliebig positionierbaren Insensitive Cursor zu verwenden, um auf den von der zuvor aufgerufenen Stored Procedure erstellten Result Set zuzugreifen. Damit diese Klausel verwendet werden kann, muss die Stored Procedure den Result Set mit einem Scrollable Cursor erstellt haben. scroll_hv muss eine alphanumerische Natural-Variable sein, die die Scroll-Richtung enthält. scroll_hv wird bei jeder Ausführung der READ RESULT SET-Verarbeitungsschleife ausgewertet.

Wenn auch die Option GIVING sqlcode angegeben wird, bleibt die Verarbeitungsschleife auch dann geöffnet, wenn der SQL-Code +100 (Row not found) von der RDBMS zurückgeliefert wird.

Wird die Option GIVING sqlcode nicht angegeben, so wird die Verabeitungsschleife beendet, wenn ein SQL-Code von der RDBMS zurückgeliefert wird, der nicht 0 (Success) ist.

Das für Natural reservierte Schlüsselwort END-RESULT muss zum Beenden des READ RESULT SET-Statements verwendet werden.