RESUME statement

Description

Resumes a procedure after a query.

Syntax

Syntax 1

RESUME cursor-name

Syntax 2

RESUME [ ALL ]

Parameters

cursor-name:

identifier

cursor-name:

identifier or host-variable

Examples

Example 1

1. EXEC SQL RESUME cur_employee;
2. EXEC SQL RESUME :cursor_var;

Example 2

CALL sample_proc() ;
RESUME ALL;

Usage

This statement resumes execution of a procedure that returns result sets. The procedure executes until the next result set (SELECT statement with no INTO clause) is encountered. If the procedure completes and no result set is found, the SQLSTATE_PROCEDURE_COMPLETE warning is set. This warning is also set when you RESUME a cursor for a SELECT statement.

The DBISQL RESUME statement (Format 2) resumes the current procedure. If ALL is not specified, executing RESUME displays the next result set or, if no more result sets are returned, completes the procedure.

The DBISQL RESUME ALL statement cycles through all result sets in a procedure, without displaying them, and completes the procedure. This is useful mainly in testing procedures.


Side effects

None.

Standards

Permissions

The cursor must have been previously opened.

See also

DECLARE CURSOR statement [ESQL] [SP]