HP 3000 Manuals

WHILE [ ALLBASE/SQL Reference Manual ] MPE/iX 5.5 Documentation


ALLBASE/SQL Reference Manual

WHILE 

The WHILE statement is used to allow looping within a procedure.

Scope 

Procedures only

SQL Syntax 

WHILE Condition DO [Statement; [...]] ENDWHILE;

Parameters 

Condition               specifies anything that is allowed in a search
                        condition except subqueries, column references,
                        host variables, dynamic parameters, aggregate
                        functions, string functions, date/time functions
                        involving column references, long column
                        functions, or TID functions.  Local variables,
                        built-in variables, and parameters may be
                        included.  See the "Search Conditions" chapter.

Statement               is any SQL statement allowed in a
                        procedure--including a compound statement.

Description 

   *   Statement is executed as long as the Condition evaluates to TRUE.

   *   WHILE statements can be nested.

   *   Local variables, built-in variables, and parameters can be used in
       a procedure as host variables are used in an application program.

Authorization 

Anyone can use the WHILE statement.

Example 

Create and execute a procedure to display all the quantities in the
LargeOrders table for a given part:

     CREATE PROCEDURE ShowOrders AS
        BEGIN
           DECLARE Quantity INTEGER;
           DECLARE PartName CHAR(16);

           DECLARE QtyCursor CURSOR FOR
              SELECT PartName, Quantity
              FROM LargeOrders;

           OPEN QtyCursor;
           WHILE ::sqlcode <> 100 DO
              FETCH QtyCursor INTO :PartName, :Quantity
              PRINT :PartName;
              PRINT :Quantity;
           ENDWHILE;
           CLOSE QtyCursor;
        END;
     EXECUTE PROCEDURE ShowOrders;



MPE/iX 5.5 Documentation