Version 4.2.6
 —  Statements  —

READ RESULT SET - SQL

Common Set-Syntax:

READ [(limit)] RESULT SET result-set INTO

VIEW view-name

FROM ddm-name
parameter
   [GIVING [:] sql-code]
END-RESULT

Extended Set-Syntax:

READ [(limit)] RESULT SET result-set INTO

VIEW view-name

FROM ddm-name
parameter
    [WITH INSENSITIVE SCROLL [:] scroll-hv]
   [GIVING [:] sql-code]
[WITH ROWSET POSITIONING FOR

[:] row_hv

ROWS]
integer
END-RESULT

Dieses Dokument behandelt folgende Themen:

Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.

Siehe auch READ RESULT SET - SQL im Teil Natural for DB2 der Database Management System Interfaces-Dokumentation.


Funktion

Das SQL-Statement READ RESULT SET kann nur in Verbindung mit einem CALLDBPROC-Statement verwendet werden. Es dient dazu, einen Result Set zu lesen, der von einer mit einem vorhergehenden CALLDBPROC-Statement aufgerufenen Stored Procedure erzeugt wurde.

Seitenanfang

Einschränkung

Dieses Statement steht bei Natural for SQL und Natural SQL Gateway nicht zur Verfügung.

Seitenanfang

Syntax-Beschreibung

limit

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.

result-set

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.

FROM ddm-name

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.

WITH INSENSITIVE SCROLL [:] scroll_hv

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.

GIVING sqlcode

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.

WITH ROWSET POSITIONING FOR ... ROWS
WITH ROWSET POSITIONING FOR ... ROWS-Klausel:

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.

END-RESULT

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

Seitenanfang

Beispiel

Siehe das Beispiel beim CALLDBPROC-Statement.

Sie auch die entsprechende Datenbank-Interface-Dokumentation.

Seitenanfang