UniBasic Commands Reference - Rocket Software

SQLPrepare
Syntax
status = SQLPrepare (statement.env, statement)
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
SQLPrepare passes an SQL statement or procedure call to the data source in order
to prepare it for execution by SQLExecute.
Use this function to deliver either an SQL statement or a call to an SQL procedure to
the data source where it can prepare to execute the passed SQL statement or the
procedure. The application subsequently uses SQLExecute to tell the data source to
execute the prepared SQL statement or procedure.
What happens when the data source executes the SQLPrepare call depends on the
data source. In many cases the data source parses the SQL statement and generates
an execution plan that allows rapid, efficient execution of the SQL statement.
Use SQLPrepare and SQLExecute functions when you are issuing SQL statements
or calling a procedure repeatedly. You can supply values to a prepared INSERT or
UPDATE statement and issue an SQLExecute call each time you change the values
of parameter markers. SQLExecute sends the current values of the parameter
markers to the data source and executes the prepared SQL statement or procedure
with the current values.
Note: Before you issue an SQLExecute call, all parameter markers in the SQL
statement or procedure call must be defined using an SQLBindParameter call,
otherwise SQLExecute returns an error.
If the parameter type of an SQLBindParameter procedure is
SQL.PARAM.OUTPUT or SQL.PARAM.INPUT.OUTPUT, values are returned to
the specified program variables.
SQLPrepare 1-841