UniBasic Commands Reference - Rocket Software

SQLFetch
Syntax
status = SQLFetch (statement.env)
Note: This function is case-sensitive. If you want it to be case-insensitive, you
must compile your programs using the BASIC command with the -i option.
Description
Use this function to retrieve the next row’s column values from the result set at the
data source and put them into the variables specified with SQLBindCol. SQLFetch
performs any required data conversions.
SQLFetch returns SQL.SUCCESS.WITH.INFO if numeric data is truncated or
rounded when converting SQL values to UniData values.
SQLFetch logically advances the cursor to the next row in the result set. Unbound
columns are ignored and are not available to the application. When no more rows are
available, SQLFetch returns a status of 100 (SQL.NO.DATA.FOUND).
Your application must issue an SQLFetch call at the same transaction nesting level
(or deeper) as the corresponding SQLExecDirect or SQLExecute call. Also, an
SQLFetch call must be executed at the same transaction isolation level as the
SELECT statement that generates the data. If it does not, SQLFetch returns
SQL.ERROR and sets SQLSTATE to S1000.
Use SQLFetch only when a result set is pending at the data source.
Parameters
The following table describes each parameter of the syntax.
Parameter Description
statement.env SQL statement environment of the executed SQL statement.
SQLFetch Parameters
SQLFetch 1-815