SQLConnectionMBS constants

Online Documentation   -   Statistics   -   FAQ   -   Plugin Parts (All, Dependencies)   -   Class hierarchy

New in Version 22.2 22.3 22.4 22.5 23.0 23.1 23.2 23.3 23.4 23.5 24.0 24.1

The list of the   topics,   classes,   interfaces,   controls,   modules,   global methods by category,   global methods by name,   screenshots,   licenses   and   examples.

Platforms to show: All Mac Windows Linux Cross-Platform

Back to SQLConnectionMBS class.

Isolation Levels

SQLConnectionMBS.kANSILevel0 = 0

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the ANSI level constants.

ANSI Level 0

SQLConnectionMBS.kANSILevel1 = 1

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the ANSI level constants.

ANSI Level 1

SQLConnectionMBS.kANSILevel2 = 2

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the ANSI level constants.

ANSI Level 2

SQLConnectionMBS.kANSILevel3 = 3

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the ANSI level constants.

ANSI Level 3

SQLConnectionMBS.kLevelUnknown = -1

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the isolation level constants.

Unknown

SQLConnectionMBS.kReadCommitted = 1

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the isolation level constants.
Example
dim con as SQLConnectionMBS // your connection
con.IsolationLevel = SQLConnectionMBS.kReadCommitted

Read committed.

SQLConnectionMBS.kReadUncommitted = 0

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the isolation level constants.
Example
dim con as SQLConnectionMBS // your connection
con.IsolationLevel = SQLConnectionMBS.kReadUncommitted

Read uncommitted.

SQLConnectionMBS.kRepeatableRead = 2

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the isolation level constants.

Repeatable read.

SQLConnectionMBS.kSerializable = 3

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the isolation level constants.

Serializable.

SQLConnectionMBS.kSnapshot = 4

Type Topic Plugin Version
const SQL MBS SQL Plugin 21.2
One of the isolation level constants.

Changes made in other transactions can not be seen. For Microsoft SQL Server.

Options to specify the library with SetFileOption

SQLConnectionMBS.kOptionLibraryDB2 = "DB2CLI.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("db2cli.dll")
con.SetFileOption con.kOptionLibraryDB2, f

Tells the plugin where to find the library for DB2.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the DB2 download on their homepage.

If no value is given, we default to
Windows: db2clio.dll
macOS: libdb2.dylib
Linux: libdb2.so

SQLConnectionMBS.kOptionLibraryFirebird = "IBASE.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("fbclient.dll")
con.SetFileOption con.kOptionLibraryFirebird, f

Tells the plugin where to find the library for FireBird (or Interbase).
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the FireBird download on their homepage.

If no value is given, we default to
Windows: ibclient64.dll;fbclient.dll;gds32.dll
macOS: libgds.dylib:libfbclient.dylib
Linux: libgds.so:libfbclient.so

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibraryInformix = "INFCLI.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("ICLIT09B.dll")
con.SetFileOption con.kOptionLibraryInformix, f

Tells the plugin where to find the library for Informix.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the Informix download on their homepage.

If no value is given, we default to
Windows: ICLIT09B.DLL;ICLIT09A.DLL
macOS: iclit09b.dylib:iclit09a.dylib:libifcli.dylib
Linux: iclit09b.so:iclit09a.so:libifcli.so

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibraryInterbase = "IBASE.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("ibclient64.dll")
con.SetFileOption con.kOptionLibraryInterbase, f

Tells the plugin where to find the library for FireBird (or Interbase).
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the FireBird download on their homepage.

If no value is given, we default to
Windows: ibclient64.dll;fbclient.dll;gds32.dll
macOS: libgds.dylib:libfbclient.dylib
Linux: libgds.so:libfbclient.so

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibraryMySQL = "MYSQL.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("libmysqlclient.18.dylib")
con.SetFileOption con.kOptionLibraryMySQL, f

Tells the plugin where to find the library for MySQL (or MariaDB).
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the MySQL download on their homepage or from the Libs folder on our website.

If no value is given, we default to
Windows: libmySQL.dll;libmariadb.dll
macOS: libmysqlclient.dylib.21:libmysqlclient_r.dylib:libmysqlclient_r.18.dylib:libmysqlclient_r.16.dylib:libmysqlclient_r.15.dylib:libmysqlclient.dylib:libmariadb.dylib.3:libmariadb.dylib.2:libmariadb.dylib
Linux: libmysqlclient.so.21:libmysqlclient_r.so:libmysqlclient_r.so.18:libmysqlclient_r.so.16:libmysqlclient_r.so.15:libmysqlclient.so:libmariadb.so.3:libmariadb.so.2:libmariadb.so

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibraryODBC = "ODBC.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

con.Option( con.kOptionLibraryODBC) = "/usr/lib/libiodbc.dylib"

Tells the plugin where to find the library for ODBC.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll".

If no value is given, we default to
Windows: odbc32.dll
macOS: libiodbc.dylib:libiodbc.3.dylib:libiodbc.2.dylib:libodbc.dylib
Linux: libiodbc.so:libiodbc.so.3:libiodbc.so.2:libodbc.so:libodbc.so.1

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibraryOracle = "OCI8.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("oci.dll")
con.SetFileOption con.kOptionLibraryOracle, f

Tells the plugin where to find the library for Oracle.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the Oracle download on their homepage.

If no value is given, we default to
Windows: oci.dll
macOS: libclntsh.dylib
Linux: libclntsh.so

SQLConnectionMBS.kOptionLibraryPostgreSQL = "LIBPQ.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("libpq.dll")
con.SetFileOption con.kOptionLibraryPostgreSQL, f

Tells the plugin where to find the library for PostgreSQL
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the PostgreSQL download on their homepage or from the Libs folder on our website.

If no value is given, we default to
Windows: libpq.dll;pq.dll
macOS: libpq.dylib:libpq.5.dylib
Linux: libpq.so:libpq.so.5:libpq.so.4:libpq.so.3

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibrarySQLanywhere = "SQLANY.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 15.2
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("dbcapi.dll")
con.SetFileOption con.kOptionLibrarySQLanywhere, f

Tells the plugin where to find the library for SQL Anywhere.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the SQL Anywhere download on their homepage.

If no value is given, we default to
Windows: dbcapi.dll
macOS: libdbcapi_r.dylib
Linux: libdbcapi_r.so

SQLConnectionMBS.kOptionLibrarySQLBase = "SQLBASE.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("sqlwntm.dll")
con.SetFileOption con.kOptionLibrarySQLBase, f

Tells the plugin where to find the library for SQLBase.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the SQLBase download on their homepage.

If no value is given, we default to
Windows: sqlwntm.dll
macOS: libsqlbapl.dylib
Linux: libsqlbapl.so

SQLConnectionMBS.kOptionLibrarySQLite = "SQLITE.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("sqlite.dylib")
con.SetFileOption con.kOptionLibrarySQLite, f

Tells the plugin where to find the library for SQLite. Not needed if you use InternalSQLiteLibraryMBS module!

The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the SQLite download on their homepage or from the Libs folder on our website. But normally you'd use the built-in library using InternalSQLiteLibraryMBS module.

If no value is given, we default to
Windows: libsqlite3.dll
macOS: libsqlite3.dylib
Linux: libsqlite3.so

SQLConnectionMBS.kOptionLibrarySybaseComn = "SYBCOMN.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
OOne of the option constant to specify the library with the SetFileOption method.

Tells the plugin where to find the library for Sybase.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the Sybase download on their homepage.

If no value is given, we default to
Windows: libsybcomn.dll:libcomn.dll
macOS: libsybcomn_r.dylib:libcomn_r.dylib
Linux: libsybcomn_r.so:libcomn_r.so

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibrarySybaseCS = "SYBCS.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("libsybcs.dll")
con.SetFileOption con.kOptionLibrarySybaseCS, f

Tells the plugin where to find the library for Sybase.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the Sybase download on their homepage.

If no value is given, we default to
Windows: libsybcs.dll:libcs.dll
macOS: libsybcs_r.dylib:libcs_r.dylib
Linux: libsybcs_r.so:libcs_r.so

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibrarySybaseCT = "SYBCT.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.
Example
dim con as SQLConnectionMBS // your connection

dim f as FolderItem = GetFolderItem("libsybct.dll")
con.SetFileOption con.kOptionLibrarySybaseCT, f

Tells the plugin where to find the library for Sybase.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the Sybase download on their homepage.

If no value is given, we default to
Windows: libsybct.dll:libct.dll
macOS: libsybct_r.dylib:libct_r.dylib
Linux: libsybct_r.so:libct_r.so

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibrarySybaseIntl = "SYBINTL.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.

Tells the plugin where to find the library for Sybase.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the Sybase download on their homepage.

If no value is given, we default to
Windows: libsybintl.dll:libintl.dll
macOS: libsybintl_r.dylib:libintl_r.dylib
Linux: libsybintl_r.so:libintl_r.so

The default is set to work in most cases and try various possible library names.

SQLConnectionMBS.kOptionLibrarySybaseTCL = "SYBTCL.LIBS"

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.5
One of the option constant to specify the library with the SetFileOption method.

Tells the plugin where to find the library for Sybase.
The value can contain multiple names and paths separated with ";" on Windows and ":" on macOS/Linux.
The library extension on Mac is ".dylib", on Linux ".so" and on Windows ".dll". You get this library with the Sybase download on their homepage.

If no value is given, we default to
Windows: libsybtcl.dll:libtcl.dll
macOS: libsybtcl_r.dylib:libtcl_r.dylib
Linux: libsybtcl_r.so:libtcl_r.so

The default is set to work in most cases and try various possible library names.

The database client constants

SQLConnectionMBS.kClientNotSpecified = 0

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

Client is not specified.

SQLConnectionMBS.kCubeSQLClient = 13

Type Topic Plugin Version
const SQL MBS SQL Plugin 18.0
One of the database client constants.

CubeSQL client. (coming soon)

SQLConnectionMBS.kDB2Client = 6

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

DB2 client.

SQLConnectionMBS.kDuckDBClient = 14

Type Topic Plugin Version
const SQL MBS SQL Plugin 21.2
One of the database client constants.

DuckDB client

SQLConnectionMBS.kFirebirdClient = 4

Type Topic Plugin Version
const SQL MBS SQL Plugin 10.4
One of the database client constants.
Example
Dim con As New SQLConnectionMBS

try

// where is the library?
Dim LibPath As String = GetFolderItem("FIREBIRD3").child("fbclient.dll").NativePath
System.DebugLog LibPath
con.Option( con.kOptionLibraryFirebird) = LibPath

// connect to database
// in this example it is Firebird/InterBase,
// but can also be Sybase, Informix, DB2, MySQL
// SQLServer, SQLBase and ODBC

// Read more here: http://www.sqlapi.com/ServerSpecific/InterBase.html

// Please enter values for your server here:

Dim DBFile As FolderItem = GetFolderItem("test.FDB")
Dim ConnectionString As String = DBFile.NativePath

// For local databases, this can be a file name.
// To connect to a database on a remote server using TCP/IP the syntax is <server name>:<filename>.
// To connect to a database on a remote server using NetBEUI, the syntax is \\<server name>\<filename>.
// To connect to a database on a remote server using SPX, the syntax is <server name>@<filename>.

dim username as string = "SYSDBA"
Dim password As String = "masterkey"

con.Connect(ConnectionString, username, password, SQLConnectionMBS.kFirebirdClient)

MsgBox "We are connected!"

// now use database

Catch r As RuntimeException
MsgBox "Failed: "+r.message
end try

InterBase/Firebird client.

SQLConnectionMBS.kInformixClient = 7

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

Informix client.

SQLConnectionMBS.kInterBaseClient = 4

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

InterBase/Firebird client.

SQLConnectionMBS.kMariaDBClient = 15

Type Topic Plugin Version
const SQL MBS SQL Plugin 22.3
One of the database client constants.

MariaDB client.

SQLConnectionMBS.kMySQLClient = 9

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

MySQL or MariaDB client.

SQLConnectionMBS.kODBCClient = 1

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

ODBC client.

SQLConnectionMBS.kOracleClient = 2

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

Oracle client.

For Windows the file is "oci.dll", for Linux libclntsh.so and for Mac OS X libclntsh.dylib.

SQLConnectionMBS.kPostgreSQLClient = 10

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

PostgreSQL client.

SQLConnectionMBS.kSQLAnywhereClient = 12

Type Topic Plugin Version
const SQL MBS SQL Plugin 18.0
One of the database client constants.

SQL Anywhere client.

SQLConnectionMBS.kSQLBaseClient = 5

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

SQLbase client.

SQLConnectionMBS.kSQLiteClient = 11

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

SQLite client. Or spatialite.

SQLConnectionMBS.kSQLServerClient = 3

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

Mircosoft SQL Server client.

You may need to download the client packages for accessing SQL Server. Files like the SQLNCLI dll may be missing. You can download for example the Feature Pack for Microsoft SQL Server 2005 from the microsoft download page.

SQLConnectionMBS.kSybaseClient = 8

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the database client constants.

Sybase client.

Values for autocommit property

SQLConnectionMBS.kAutoCommitOff = 0

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the constants for the autocommit property.
Example
dim db as SQLConnectionMBS // your database connection

db.AutoCommit = SQLConnectionMBS.kAutoCommitOff

Autocommit is off.

SQLConnectionMBS.kAutoCommitOn = 1

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the constants for the autocommit property.
Example
dim db as SQLConnectionMBS // your database connection

db.AutoCommit = SQLConnectionMBS.kAutoCommitOn

Autocommit is on.

SQLConnectionMBS.kAutoCommitUnknown = -1

Type Topic Plugin Version
const SQL MBS SQL Plugin 9.3
One of the constants for the autocommit property.

Autocommit unknown

The items on this page are in the following plugins: MBS SQL Plugin.


💬 Ask a question or report a problem