UniBasic Commands Reference - Rocket Software

SQLTransact
Syntax
status = SQLTransact (bci.env, connect.env, type)
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
SQLTransact requests a COMMIT or ROLLBACK for all SQL statements
associated with a connection or all connections associated with an environment. Use
this function only when you are connected to an ODBC data source.
This function provides the same transaction functions as the UniBasic statement
TRANSACTION COMMIT. When connect.env is a valid connection environment
with SQL.AUTOCOMMIT set to OFF, SQLTransact commits the connection.
To use SQLTransact, all of the following conditions must be met:
The SQL.PRIVATE.TX option of SQLSetConnectOption is set to
SQL.PRIVATE.TX.ON.
The SQL.AUTOCOMMIT option is set to SQL.AUTOCOMMIT.OFF.
The connection is active.
Setting bci.env to a valid environment handle and connect.env to SQL.NULL.HDBC
requests the server to try to execute the requested action on all hdbcs that are in a
connected state.
If any action fails, SQL.ERROR is returned, and the user can determine which
connections failed by calling SQLError for each connection environment in turn.
If you call SQLTransact with a type of SQL.COMMIT or SQL.ROLLBACK when
no transaction is active, SQL.SUCCESS is returned.
SQLTransact 1-863