UniBasic Commands Reference - Rocket Software

SQLParamOptions
Syntax
status = SQLParamOptions (statement.env, option, value)
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
SQLParamOptions lets applications load an array of parameter markers in a single
SQLExecDirect or SQLExecute function call. Use this function only when you are
connected to an ODBC data source.
SQLParamOptions works for all parameter types—output and input/output parameters
as well as the more usual input parameters.
Be careful when you use matrices instead of arrays. For example, in the matrix:
dim matrix(10,10)
the elements 1,1, 1,2, ..., 1,10, 2,1, 2,2, ... occupy consecutive memory locations.
Since SQLParamOptions requires each location specified in SQLBind Parameter to
point to a consecutive series of values in memory, an application using a matrix must
load the values of the matrix in the correct order.
When the SQL statement is executed, all variables are checked, data is converted
when necessary, and all values in the set are verified to be appropriate and within the
bounds of the marker definition. Values are then copied to low-level structures
associated with each parameter marker. If a failure occurs while the values are being
checked, SQLExecDirect or SQLExecute returns SQL.ERROR, and value contains
the number of the row where the failure occurred.
1-838 UniBasic Commands Reference