SQL$HELP72.HLB  —  FETCH  Arguments

1  –  cursor-name

    Specifies the name of the cursor from which you want to retrieve
    a row. Use a parameter if the cursor referred to by the cursor
    name was declared at run time with a dynamic DECLARE CURSOR
    statement. Specify the parameter used for the cursor name in
    the dynamic DECLARE CURSOR statement.

    You can use a parameter to refer to the cursor name only when the
    FETCH statement is accessing a dynamic cursor.

2  –  fetch FROM

    Specifies the specific segment of the list cursor to fetch. These
    options are available only if you specified the SCROLL option in
    the DECLARE CURSOR statement. The choices are:

    o  NEXT

       Fetches the next segment of the list cursor. This is the
       default.

    o  PRIOR

       Fetches the segment immediately before the current segment of
       the list cursor.

    o  FIRST

       Fetches the first segment of the list cursor.

    o  LAST

       Fetches the last segment of the list cursor.

    o  RELATIVE simple-value-expression

       Fetches the segment of the list cursor indicated by the value
       expression. For example, relative -4 would fetch the segment
       that is four segments prior to the current segment.

    o  ABSOLUTE simple-value-expression

       Fetches the segment of the list cursor indicated by the value
       expression. For example, absolute 4 would fetch the fourth
       segment of the list cursor.

3  –  INTO

    Syntax options:

    INTO parameter | INTO qualified-parameter | INTO variable

    Specifies a list of parameters, qualified parameters (host
    structures), or variables to receive the values SQL retrieves
    from the row of the cursor's result table. The number of
    parameters or variables in the list must be the same as the
    number of values in the row. (If any of the parameters is a host
    structure, SQL counts the number of parameters in that structure
    when it compares the number of host parameters in the INTO clause
    with the number of values in the row.)

    The data types of parameters and variables must be compatible
    with the values of the corresponding column of the cursor row.

4  –  parameter

    Specifies the name of the cursor from which you want to retrieve
    a row. Use a parameter if the cursor referred to by the cursor
    name was declared at run time with a dynamic DECLARE CURSOR
    statement. Specify the parameter used for the cursor name in
    the dynamic DECLARE CURSOR statement.

    You can use a parameter to refer to the cursor name only when the
    FETCH statement is accessing a dynamic cursor.

5  –  simple-value-expression

    Specifies either a positive or negative integer, or a numeric
    module language or host language parameter.

6  –  USING_DESCRIPTOR

    Specifies the name of a descriptor that corresponds to an SQLDA.
    If you use the INCLUDE statement to insert the SQLDA into your
    program, the descriptor name is simply SQLDA.

    An SQLDA is a collection of host language variables used only in
    dynamic SQL. In a FETCH statement, the SQLDA points to a number
    of parameters SQL uses to store values from the row. The number
    of parameters must match the number of columns in the row.

    The data types of parameters must be compatible with the values
    of the corresponding column of the cursor row.
Close Help