1 ///////////////////////////////////////////////////////////////////////////////
3 // Purpose: Implementation of the wxDB class. The wxDB class represents a connection
4 // to an ODBC data source. The wxDB class allows operations on the data
5 // source such as opening and closing the data source.
9 // -Added support for SQL statement logging and database cataloging
11 // -Added QUERY_ONLY mode support to reduce default number of cursors
12 // -Added additional SQL logging code
13 // -Added DEBUG-ONLY tracking of wxTable objects to detect orphaned DB connections
14 // -Set ODBC option to only read committed writes to the DB so all
15 // databases operate the same in that respect
18 // Copyright: (c) 1996 Remstar International, Inc.
19 // Licence: wxWindows licence, plus:
20 // Notice: This class library and its intellectual design are free of charge for use,
21 // modification, enhancement, debugging under the following conditions:
22 // 1) These classes may only be used as part of the implementation of a
23 // wxWindows-based application
24 // 2) All enhancements and bug fixes are to be submitted back to the wxWindows
25 // user groups free of all charges for use with the wxWindows library.
26 // 3) These classes may not be distributed as part of any other class library,
27 // DLL, text (written or electronic), other than a complete distribution of
28 // the wxWindows GUI development toolkit.
29 ///////////////////////////////////////////////////////////////////////////////
36 #include "wx/wxprec.h"
38 // Use this line for wxWindows v1.x
40 // Use this line for wxWindows v2.x
41 #include "wx/version.h"
43 #if wxMAJOR_VERSION == 2
45 #pragma implementation "db.h"
49 #ifdef DBDEBUG_CONSOLE
57 #if wxMAJOR_VERSION == 2
59 #include "wx/string.h"
60 #include "wx/object.h"
63 #include "wx/msgdlg.h"
65 #include "wx/filefn.h"
66 #include "wx/wxchar.h"
69 #if wxMAJOR_VERSION == 1
70 # if defined(wx_msw) || defined(wx_x)
87 #if wxMAJOR_VERSION == 1
89 #elif wxMAJOR_VERSION == 2
93 DbList WXDLLEXPORT
*PtrBegDbList
= 0;
96 extern wxList TablesInUse
;
102 #define stricmp _stricmp
103 #define strnicmp _strnicmp
105 int strcasecmp(const char *str_1
, const char *str_2
) ;
106 int strncasecmp(const char *str_1
, const char *str_2
, size_t maxchar
) ;
107 #define stricmp strcasecmp
108 #define strnicmp strncasecmp
112 // SQL Log defaults to be used by GetDbConnection
113 enum sqlLog SQLLOGstate
= sqlLogOFF
;
115 char SQLLOGfn
[DB_PATH_MAX
+1] = "sqllog.txt";
117 // The wxDB::errorList is copied to this variable when the wxDB object
118 // is closed. This way, the error list is still available after the
119 // database object is closed. This is necessary if the database
120 // connection fails so the calling application can show the operator
121 // why the connection failed. Note: as each wxDB object is closed, it
122 // will overwrite the errors of the previously destroyed wxDB object in
124 char DBerrorList
[DB_MAX_ERROR_HISTORY
][DB_MAX_ERROR_MSG_LEN
];
126 /********** wxDB Constructor **********/
127 wxDB::wxDB(HENV
&aHenv
)
131 fpSqlLog
= 0; // Sql Log file pointer
132 sqlLogState
= sqlLogOFF
; // By default, logging is turned off
137 nativeError
= cbErrorMsg
= 0;
138 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
139 strcpy(errorList
[i
], "");
141 // Init typeInf structures
142 strcpy(typeInfVarchar
.TypeName
,"");
143 typeInfVarchar
.FsqlType
= 0;
144 typeInfVarchar
.Precision
= 0;
145 typeInfVarchar
.CaseSensitive
= 0;
146 typeInfVarchar
.MaximumScale
= 0;
148 strcpy(typeInfInteger
.TypeName
,"");
149 typeInfInteger
.FsqlType
= 0;
150 typeInfInteger
.Precision
= 0;
151 typeInfInteger
.CaseSensitive
= 0;
152 typeInfInteger
.MaximumScale
= 0;
154 strcpy(typeInfFloat
.TypeName
,"");
155 typeInfFloat
.FsqlType
= 0;
156 typeInfFloat
.Precision
= 0;
157 typeInfFloat
.CaseSensitive
= 0;
158 typeInfFloat
.MaximumScale
= 0;
160 strcpy(typeInfDate
.TypeName
,"");
161 typeInfDate
.FsqlType
= 0;
162 typeInfDate
.Precision
= 0;
163 typeInfDate
.CaseSensitive
= 0;
164 typeInfDate
.MaximumScale
= 0;
166 // Error reporting is turned OFF by default
169 // Copy the HENV into the db class
172 // Allocate a data source connection handle
173 if (SQLAllocConnect(henv
, &hdbc
) != SQL_SUCCESS
)
176 // Initialize the db status flag
179 // Mark database as not open as of yet
184 /********** wxDB::Open() **********/
185 bool wxDB::Open(char *Dsn
, char *Uid
, char *AuthStr
)
187 assert(Dsn
&& strlen(Dsn
));
194 #if !wxODBC_FWD_ONLY_CURSORS
196 // Specify that the ODBC cursor library be used, if needed. This must be
197 // specified before the connection is made.
198 retcode
= SQLSetConnectOption(hdbc
, SQL_ODBC_CURSORS
, SQL_CUR_USE_IF_NEEDED
);
200 #ifdef DBDEBUG_CONSOLE
201 if (retcode
== SQL_SUCCESS
)
202 cout
<< "SQLSetConnectOption(CURSOR_LIB) successful" << endl
;
204 cout
<< "SQLSetConnectOption(CURSOR_LIB) failed" << endl
;
209 // Connect to the data source
210 retcode
= SQLConnect(hdbc
, (UCHAR FAR
*) Dsn
, SQL_NTS
,
211 (UCHAR FAR
*) Uid
, SQL_NTS
,
212 (UCHAR FAR
*) AuthStr
,SQL_NTS
);
213 if (retcode
== SQL_SUCCESS_WITH_INFO
)
214 DispAllErrors(henv
, hdbc
);
215 else if (retcode
!= SQL_SUCCESS
)
216 return(DispAllErrors(henv
, hdbc
));
219 If using Intersolv branded ODBC drivers, this is the place where you would substitute
220 your branded driver license information
222 SQLSetConnectOption(hdbc, 1041, (UDWORD) "");
223 SQLSetConnectOption(hdbc, 1042, (UDWORD) "");
225 // Mark database as open
228 // Allocate a statement handle for the database connection
229 if (SQLAllocStmt(hdbc
, &hstmt
) != SQL_SUCCESS
)
230 return(DispAllErrors(henv
, hdbc
));
232 // Set Connection Options
233 if (! setConnectionOptions())
236 // Query the data source for inf. about itself
240 // Query the data source regarding data type information
243 // The way I determined which SQL data types to use was by calling SQLGetInfo
244 // for all of the possible SQL data types to see which ones were supported. If
245 // a type is not supported, the SQLFetch() that's called from getDataTypeInfo()
246 // fails with SQL_NO_DATA_FOUND. This is ugly because I'm sure the three SQL data
247 // types I've selected below will not alway's be what we want. These are just
248 // what happened to work against an Oracle 7/Intersolv combination. The following is
249 // a complete list of the results I got back against the Oracle 7 database:
251 // SQL_BIGINT SQL_NO_DATA_FOUND
252 // SQL_BINARY SQL_NO_DATA_FOUND
253 // SQL_BIT SQL_NO_DATA_FOUND
254 // SQL_CHAR type name = 'CHAR', Precision = 255
255 // SQL_DATE SQL_NO_DATA_FOUND
256 // SQL_DECIMAL type name = 'NUMBER', Precision = 38
257 // SQL_DOUBLE type name = 'NUMBER', Precision = 15
258 // SQL_FLOAT SQL_NO_DATA_FOUND
259 // SQL_INTEGER SQL_NO_DATA_FOUND
260 // SQL_LONGVARBINARY type name = 'LONG RAW', Precision = 2 billion
261 // SQL_LONGVARCHAR type name = 'LONG', Precision = 2 billion
262 // SQL_NUMERIC SQL_NO_DATA_FOUND
263 // SQL_REAL SQL_NO_DATA_FOUND
264 // SQL_SMALLINT SQL_NO_DATA_FOUND
265 // SQL_TIME SQL_NO_DATA_FOUND
266 // SQL_TIMESTAMP type name = 'DATE', Precision = 19
267 // SQL_VARBINARY type name = 'RAW', Precision = 255
268 // SQL_VARCHAR type name = 'VARCHAR2', Precision = 2000
269 // =====================================================================
270 // Results from a Microsoft Access 7.0 db, using a driver from Microsoft
272 // SQL_VARCHAR type name = 'TEXT', Precision = 255
273 // SQL_TIMESTAMP type name = 'DATETIME'
274 // SQL_DECIMAL SQL_NO_DATA_FOUND
275 // SQL_NUMERIC type name = 'CURRENCY', Precision = 19
276 // SQL_FLOAT SQL_NO_DATA_FOUND
277 // SQL_REAL type name = 'SINGLE', Precision = 7
278 // SQL_DOUBLE type name = 'DOUBLE', Precision = 15
279 // SQL_INTEGER type name = 'LONG', Precision = 10
281 // VARCHAR = Variable length character string
282 if (! getDataTypeInfo(SQL_VARCHAR
, typeInfVarchar
))
283 if (! getDataTypeInfo(SQL_CHAR
, typeInfVarchar
))
286 typeInfVarchar
.FsqlType
= SQL_CHAR
;
288 typeInfVarchar
.FsqlType
= SQL_VARCHAR
;
291 if (! getDataTypeInfo(SQL_DOUBLE
, typeInfFloat
))
292 if (! getDataTypeInfo(SQL_REAL
, typeInfFloat
))
293 if (! getDataTypeInfo(SQL_FLOAT
, typeInfFloat
))
294 if (! getDataTypeInfo(SQL_DECIMAL
, typeInfFloat
))
295 if (! getDataTypeInfo(SQL_NUMERIC
, typeInfFloat
))
298 typeInfFloat
.FsqlType
= SQL_NUMERIC
;
300 typeInfFloat
.FsqlType
= SQL_DECIMAL
;
302 typeInfFloat
.FsqlType
= SQL_FLOAT
;
304 typeInfFloat
.FsqlType
= SQL_REAL
;
306 typeInfFloat
.FsqlType
= SQL_DOUBLE
;
309 if (! getDataTypeInfo(SQL_INTEGER
, typeInfInteger
))
310 // If SQL_INTEGER is not supported, use the floating point
311 // data type to store integers as well as floats
312 if (! getDataTypeInfo(typeInfFloat
.FsqlType
, typeInfInteger
))
315 typeInfInteger
.FsqlType
= typeInfFloat
.FsqlType
;
317 typeInfInteger
.FsqlType
= SQL_INTEGER
;
320 if (Dbms() != dbmsDBASE
)
322 if (! getDataTypeInfo(SQL_TIMESTAMP
, typeInfDate
))
325 typeInfDate
.FsqlType
= SQL_TIMESTAMP
;
329 if (! getDataTypeInfo(SQL_DATE
, typeInfDate
))
332 typeInfDate
.FsqlType
= SQL_DATE
;
335 #ifdef DBDEBUG_CONSOLE
336 cout
<< "VARCHAR DATA TYPE: " << typeInfVarchar
.TypeName
<< endl
;
337 cout
<< "INTEGER DATA TYPE: " << typeInfInteger
.TypeName
<< endl
;
338 cout
<< "FLOAT DATA TYPE: " << typeInfFloat
.TypeName
<< endl
;
339 cout
<< "DATE DATA TYPE: " << typeInfDate
.TypeName
<< endl
;
343 // Completed Successfully
348 // The Intersolv/Oracle 7 driver was "Not Capable" of setting the login timeout.
350 /********** wxDB::setConnectionOptions() **********/
351 bool wxDB::setConnectionOptions(void)
353 SQLSetConnectOption(hdbc
, SQL_AUTOCOMMIT
, SQL_AUTOCOMMIT_OFF
);
354 SQLSetConnectOption(hdbc
, SQL_OPT_TRACE
, SQL_OPT_TRACE_OFF
);
356 // Display the connection options to verify them
357 #ifdef DBDEBUG_CONSOLE
359 cout
<< ">>>>> CONNECTION OPTIONS <<<<<<" << endl
;
361 if (SQLGetConnectOption(hdbc
, SQL_AUTOCOMMIT
, &l
) != SQL_SUCCESS
)
362 return(DispAllErrors(henv
, hdbc
));
363 cout
<< "AUTOCOMMIT: " << (l
== SQL_AUTOCOMMIT_OFF
? "OFF" : "ON") << endl
;
365 if (SQLGetConnectOption(hdbc
, SQL_ODBC_CURSORS
, &l
) != SQL_SUCCESS
)
366 return(DispAllErrors(henv
, hdbc
));
367 cout
<< "ODBC CURSORS: ";
370 case(SQL_CUR_USE_IF_NEEDED
):
371 cout
<< "SQL_CUR_USE_IF_NEEDED";
373 case(SQL_CUR_USE_ODBC
):
374 cout
<< "SQL_CUR_USE_ODBC";
376 case(SQL_CUR_USE_DRIVER
):
377 cout
<< "SQL_CUR_USE_DRIVER";
382 if (SQLGetConnectOption(hdbc
, SQL_OPT_TRACE
, &l
) != SQL_SUCCESS
)
383 return(DispAllErrors(henv
, hdbc
));
384 cout
<< "TRACING: " << (l
== SQL_OPT_TRACE_OFF
? "OFF" : "ON") << endl
;
389 // Completed Successfully
392 } // wxDB::setConnectionOptions()
394 /********** wxDB::getDbInfo() **********/
395 bool wxDB::getDbInfo(void)
400 if (SQLGetInfo(hdbc
, SQL_SERVER_NAME
, (UCHAR
*) dbInf
.serverName
, 80, &cb
) != SQL_SUCCESS
)
401 return(DispAllErrors(henv
, hdbc
));
403 if (SQLGetInfo(hdbc
, SQL_DATABASE_NAME
, (UCHAR
*) dbInf
.databaseName
, 128, &cb
) != SQL_SUCCESS
)
404 return(DispAllErrors(henv
, hdbc
));
406 if (SQLGetInfo(hdbc
, SQL_DBMS_NAME
, (UCHAR
*) dbInf
.dbmsName
, 40, &cb
) != SQL_SUCCESS
)
407 return(DispAllErrors(henv
, hdbc
));
410 // After upgrading to MSVC6, the original 20 char buffer below was insufficient,
411 // causing database connectivity to fail in some cases.
412 retcode
= SQLGetInfo(hdbc
, SQL_DBMS_VER
, (UCHAR
*) dbInf
.dbmsVer
, 64, &cb
);
413 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
414 return(DispAllErrors(henv
, hdbc
));
416 if (SQLGetInfo(hdbc
, SQL_ACTIVE_CONNECTIONS
, (UCHAR
*) &dbInf
.maxConnections
, sizeof(dbInf
.maxConnections
), &cb
) != SQL_SUCCESS
)
417 return(DispAllErrors(henv
, hdbc
));
419 if (SQLGetInfo(hdbc
, SQL_ACTIVE_STATEMENTS
, (UCHAR
*) &dbInf
.maxStmts
, sizeof(dbInf
.maxStmts
), &cb
) != SQL_SUCCESS
)
420 return(DispAllErrors(henv
, hdbc
));
422 if (SQLGetInfo(hdbc
, SQL_DRIVER_NAME
, (UCHAR
*) dbInf
.driverName
, 40, &cb
) != SQL_SUCCESS
)
423 return(DispAllErrors(henv
, hdbc
));
425 if (SQLGetInfo(hdbc
, SQL_DRIVER_ODBC_VER
, (UCHAR
*) dbInf
.odbcVer
, 60, &cb
) == SQL_ERROR
)
426 return(DispAllErrors(henv
, hdbc
));
428 retcode
= SQLGetInfo(hdbc
, SQL_ODBC_VER
, (UCHAR
*) dbInf
.drvMgrOdbcVer
, 60, &cb
);
429 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
430 return(DispAllErrors(henv
, hdbc
));
432 if (SQLGetInfo(hdbc
, SQL_DRIVER_VER
, (UCHAR
*) dbInf
.driverVer
, 60, &cb
) == SQL_ERROR
)
433 return(DispAllErrors(henv
, hdbc
));
435 if (SQLGetInfo(hdbc
, SQL_ODBC_API_CONFORMANCE
, (UCHAR
*) &dbInf
.apiConfLvl
, sizeof(dbInf
.apiConfLvl
), &cb
) != SQL_SUCCESS
)
436 return(DispAllErrors(henv
, hdbc
));
438 if (SQLGetInfo(hdbc
, SQL_ODBC_SAG_CLI_CONFORMANCE
, (UCHAR
*) &dbInf
.cliConfLvl
, sizeof(dbInf
.cliConfLvl
), &cb
) != SQL_SUCCESS
)
439 return(DispAllErrors(henv
, hdbc
));
441 if (SQLGetInfo(hdbc
, SQL_ODBC_SQL_CONFORMANCE
, (UCHAR
*) &dbInf
.sqlConfLvl
, sizeof(dbInf
.sqlConfLvl
), &cb
) != SQL_SUCCESS
)
442 return(DispAllErrors(henv
, hdbc
));
444 if (SQLGetInfo(hdbc
, SQL_OUTER_JOINS
, (UCHAR
*) dbInf
.outerJoins
, 2, &cb
) != SQL_SUCCESS
)
445 return(DispAllErrors(henv
, hdbc
));
447 if (SQLGetInfo(hdbc
, SQL_PROCEDURES
, (UCHAR
*) dbInf
.procedureSupport
, 2, &cb
) != SQL_SUCCESS
)
448 return(DispAllErrors(henv
, hdbc
));
450 if (SQLGetInfo(hdbc
, SQL_CURSOR_COMMIT_BEHAVIOR
, (UCHAR
*) &dbInf
.cursorCommitBehavior
, sizeof(dbInf
.cursorCommitBehavior
), &cb
) != SQL_SUCCESS
)
451 return(DispAllErrors(henv
, hdbc
));
453 if (SQLGetInfo(hdbc
, SQL_CURSOR_ROLLBACK_BEHAVIOR
, (UCHAR
*) &dbInf
.cursorRollbackBehavior
, sizeof(dbInf
.cursorRollbackBehavior
), &cb
) != SQL_SUCCESS
)
454 return(DispAllErrors(henv
, hdbc
));
456 if (SQLGetInfo(hdbc
, SQL_NON_NULLABLE_COLUMNS
, (UCHAR
*) &dbInf
.supportNotNullClause
, sizeof(dbInf
.supportNotNullClause
), &cb
) != SQL_SUCCESS
)
457 return(DispAllErrors(henv
, hdbc
));
459 if (SQLGetInfo(hdbc
, SQL_ODBC_SQL_OPT_IEF
, (UCHAR
*) dbInf
.supportIEF
, 2, &cb
) != SQL_SUCCESS
)
460 return(DispAllErrors(henv
, hdbc
));
462 if (SQLGetInfo(hdbc
, SQL_DEFAULT_TXN_ISOLATION
, (UCHAR
*) &dbInf
.txnIsolation
, sizeof(dbInf
.txnIsolation
), &cb
) != SQL_SUCCESS
)
463 return(DispAllErrors(henv
, hdbc
));
465 if (SQLGetInfo(hdbc
, SQL_TXN_ISOLATION_OPTION
, (UCHAR
*) &dbInf
.txnIsolationOptions
, sizeof(dbInf
.txnIsolationOptions
), &cb
) != SQL_SUCCESS
)
466 return(DispAllErrors(henv
, hdbc
));
468 if (SQLGetInfo(hdbc
, SQL_FETCH_DIRECTION
, (UCHAR
*) &dbInf
.fetchDirections
, sizeof(dbInf
.fetchDirections
), &cb
) != SQL_SUCCESS
)
469 return(DispAllErrors(henv
, hdbc
));
471 if (SQLGetInfo(hdbc
, SQL_LOCK_TYPES
, (UCHAR
*) &dbInf
.lockTypes
, sizeof(dbInf
.lockTypes
), &cb
) != SQL_SUCCESS
)
472 return(DispAllErrors(henv
, hdbc
));
474 if (SQLGetInfo(hdbc
, SQL_POS_OPERATIONS
, (UCHAR
*) &dbInf
.posOperations
, sizeof(dbInf
.posOperations
), &cb
) != SQL_SUCCESS
)
475 return(DispAllErrors(henv
, hdbc
));
477 if (SQLGetInfo(hdbc
, SQL_POSITIONED_STATEMENTS
, (UCHAR
*) &dbInf
.posStmts
, sizeof(dbInf
.posStmts
), &cb
) != SQL_SUCCESS
)
478 return(DispAllErrors(henv
, hdbc
));
480 if (SQLGetInfo(hdbc
, SQL_SCROLL_CONCURRENCY
, (UCHAR
*) &dbInf
.scrollConcurrency
, sizeof(dbInf
.scrollConcurrency
), &cb
) != SQL_SUCCESS
)
481 return(DispAllErrors(henv
, hdbc
));
483 if (SQLGetInfo(hdbc
, SQL_SCROLL_OPTIONS
, (UCHAR
*) &dbInf
.scrollOptions
, sizeof(dbInf
.scrollOptions
), &cb
) != SQL_SUCCESS
)
484 return(DispAllErrors(henv
, hdbc
));
486 if (SQLGetInfo(hdbc
, SQL_STATIC_SENSITIVITY
, (UCHAR
*) &dbInf
.staticSensitivity
, sizeof(dbInf
.staticSensitivity
), &cb
) != SQL_SUCCESS
)
487 return(DispAllErrors(henv
, hdbc
));
489 if (SQLGetInfo(hdbc
, SQL_TXN_CAPABLE
, (UCHAR
*) &dbInf
.txnCapable
, sizeof(dbInf
.txnCapable
), &cb
) != SQL_SUCCESS
)
490 return(DispAllErrors(henv
, hdbc
));
492 if (SQLGetInfo(hdbc
, SQL_LOGIN_TIMEOUT
, (UCHAR
*) &dbInf
.loginTimeout
, sizeof(dbInf
.loginTimeout
), &cb
) != SQL_SUCCESS
)
493 return(DispAllErrors(henv
, hdbc
));
495 #ifdef DBDEBUG_CONSOLE
496 cout
<< ">>>>> DATA SOURCE INFORMATION <<<<<" << endl
;
497 cout
<< "SERVER Name: " << dbInf
.serverName
<< endl
;
498 cout
<< "DBMS Name: " << dbInf
.dbmsName
<< "; DBMS Version: " << dbInf
.dbmsVer
<< endl
;
499 cout
<< "ODBC Version: " << dbInf
.odbcVer
<< "; Driver Version: " << dbInf
.driverVer
<< endl
;
501 cout
<< "API Conf. Level: ";
502 switch(dbInf
.apiConfLvl
)
504 case SQL_OAC_NONE
: cout
<< "None"; break;
505 case SQL_OAC_LEVEL1
: cout
<< "Level 1"; break;
506 case SQL_OAC_LEVEL2
: cout
<< "Level 2"; break;
510 cout
<< "SAG CLI Conf. Level: ";
511 switch(dbInf
.cliConfLvl
)
513 case SQL_OSCC_NOT_COMPLIANT
: cout
<< "Not Compliant"; break;
514 case SQL_OSCC_COMPLIANT
: cout
<< "Compliant"; break;
518 cout
<< "SQL Conf. Level: ";
519 switch(dbInf
.sqlConfLvl
)
521 case SQL_OSC_MINIMUM
: cout
<< "Minimum Grammer"; break;
522 case SQL_OSC_CORE
: cout
<< "Core Grammer"; break;
523 case SQL_OSC_EXTENDED
: cout
<< "Extended Grammer"; break;
527 cout
<< "Max. Connections: " << dbInf
.maxConnections
<< endl
;
528 cout
<< "Outer Joins: " << dbInf
.outerJoins
<< endl
;
529 cout
<< "Support for Procedures: " << dbInf
.procedureSupport
<< endl
;
531 cout
<< "Cursor COMMIT Behavior: ";
532 switch(dbInf
.cursorCommitBehavior
)
534 case SQL_CB_DELETE
: cout
<< "Delete cursors"; break;
535 case SQL_CB_CLOSE
: cout
<< "Close cursors"; break;
536 case SQL_CB_PRESERVE
: cout
<< "Preserve cursors"; break;
540 cout
<< "Cursor ROLLBACK Behavior: ";
541 switch(dbInf
.cursorRollbackBehavior
)
543 case SQL_CB_DELETE
: cout
<< "Delete cursors"; break;
544 case SQL_CB_CLOSE
: cout
<< "Close cursors"; break;
545 case SQL_CB_PRESERVE
: cout
<< "Preserve cursors"; break;
549 cout
<< "Support NOT NULL clause: ";
550 switch(dbInf
.supportNotNullClause
)
552 case SQL_NNC_NULL
: cout
<< "No"; break;
553 case SQL_NNC_NON_NULL
: cout
<< "Yes"; break;
557 cout
<< "Support IEF (Ref. Integrity): " << dbInf
.supportIEF
<< endl
;
558 cout
<< "Login Timeout: " << dbInf
.loginTimeout
<< endl
;
560 cout
<< endl
<< endl
<< "more ..." << endl
;
563 cout
<< "Default Transaction Isolation: ";
564 switch(dbInf
.txnIsolation
)
566 case SQL_TXN_READ_UNCOMMITTED
: cout
<< "Read Uncommitted"; break;
567 case SQL_TXN_READ_COMMITTED
: cout
<< "Read Committed"; break;
568 case SQL_TXN_REPEATABLE_READ
: cout
<< "Repeatable Read"; break;
569 case SQL_TXN_SERIALIZABLE
: cout
<< "Serializable"; break;
571 case SQL_TXN_VERSIONING
: cout
<< "Versioning"; break;
576 cout
<< "Transaction Isolation Options: ";
577 if (dbInf
.txnIsolationOptions
& SQL_TXN_READ_UNCOMMITTED
)
578 cout
<< "Read Uncommitted, ";
579 if (dbInf
.txnIsolationOptions
& SQL_TXN_READ_COMMITTED
)
580 cout
<< "Read Committed, ";
581 if (dbInf
.txnIsolationOptions
& SQL_TXN_REPEATABLE_READ
)
582 cout
<< "Repeatable Read, ";
583 if (dbInf
.txnIsolationOptions
& SQL_TXN_SERIALIZABLE
)
584 cout
<< "Serializable, ";
586 if (dbInf
.txnIsolationOptions
& SQL_TXN_VERSIONING
)
587 cout
<< "Versioning";
591 cout
<< "Fetch Directions Supported:" << endl
<< " ";
592 if (dbInf
.fetchDirections
& SQL_FD_FETCH_NEXT
)
594 if (dbInf
.fetchDirections
& SQL_FD_FETCH_PRIOR
)
596 if (dbInf
.fetchDirections
& SQL_FD_FETCH_FIRST
)
598 if (dbInf
.fetchDirections
& SQL_FD_FETCH_LAST
)
600 if (dbInf
.fetchDirections
& SQL_FD_FETCH_ABSOLUTE
)
601 cout
<< "Absolute, ";
602 if (dbInf
.fetchDirections
& SQL_FD_FETCH_RELATIVE
)
603 cout
<< "Relative, ";
605 if (dbInf
.fetchDirections
& SQL_FD_FETCH_RESUME
)
608 if (dbInf
.fetchDirections
& SQL_FD_FETCH_BOOKMARK
)
612 cout
<< "Lock Types Supported (SQLSetPos): ";
613 if (dbInf
.lockTypes
& SQL_LCK_NO_CHANGE
)
614 cout
<< "No Change, ";
615 if (dbInf
.lockTypes
& SQL_LCK_EXCLUSIVE
)
616 cout
<< "Exclusive, ";
617 if (dbInf
.lockTypes
& SQL_LCK_UNLOCK
)
621 cout
<< "Position Operations Supported (SQLSetPos): ";
622 if (dbInf
.posOperations
& SQL_POS_POSITION
)
623 cout
<< "Position, ";
624 if (dbInf
.posOperations
& SQL_POS_REFRESH
)
626 if (dbInf
.posOperations
& SQL_POS_UPDATE
)
628 if (dbInf
.posOperations
& SQL_POS_DELETE
)
630 if (dbInf
.posOperations
& SQL_POS_ADD
)
634 cout
<< "Positioned Statements Supported: ";
635 if (dbInf
.posStmts
& SQL_PS_POSITIONED_DELETE
)
636 cout
<< "Pos delete, ";
637 if (dbInf
.posStmts
& SQL_PS_POSITIONED_UPDATE
)
638 cout
<< "Pos update, ";
639 if (dbInf
.posStmts
& SQL_PS_SELECT_FOR_UPDATE
)
640 cout
<< "Select for update";
643 cout
<< "Scroll Concurrency: ";
644 if (dbInf
.scrollConcurrency
& SQL_SCCO_READ_ONLY
)
645 cout
<< "Read Only, ";
646 if (dbInf
.scrollConcurrency
& SQL_SCCO_LOCK
)
648 if (dbInf
.scrollConcurrency
& SQL_SCCO_OPT_ROWVER
)
649 cout
<< "Opt. Rowver, ";
650 if (dbInf
.scrollConcurrency
& SQL_SCCO_OPT_VALUES
)
651 cout
<< "Opt. Values";
654 cout
<< "Scroll Options: ";
655 if (dbInf
.scrollOptions
& SQL_SO_FORWARD_ONLY
)
656 cout
<< "Fwd Only, ";
657 if (dbInf
.scrollOptions
& SQL_SO_STATIC
)
659 if (dbInf
.scrollOptions
& SQL_SO_KEYSET_DRIVEN
)
660 cout
<< "Keyset Driven, ";
661 if (dbInf
.scrollOptions
& SQL_SO_DYNAMIC
)
663 if (dbInf
.scrollOptions
& SQL_SO_MIXED
)
667 cout
<< "Static Sensitivity: ";
668 if (dbInf
.staticSensitivity
& SQL_SS_ADDITIONS
)
669 cout
<< "Additions, ";
670 if (dbInf
.staticSensitivity
& SQL_SS_DELETIONS
)
671 cout
<< "Deletions, ";
672 if (dbInf
.staticSensitivity
& SQL_SS_UPDATES
)
676 cout
<< "Transaction Capable?: ";
677 switch(dbInf
.txnCapable
)
679 case SQL_TC_NONE
: cout
<< "No"; break;
680 case SQL_TC_DML
: cout
<< "DML Only"; break;
681 case SQL_TC_DDL_COMMIT
: cout
<< "DDL Commit"; break;
682 case SQL_TC_DDL_IGNORE
: cout
<< "DDL Ignore"; break;
683 case SQL_TC_ALL
: cout
<< "DDL & DML"; break;
691 // Completed Successfully
694 } // wxDB::getDbInfo()
696 /********** wxDB::getDataTypeInfo() **********/
697 bool wxDB::getDataTypeInfo(SWORD fSqlType
, SqlTypeInfo
&structSQLTypeInfo
)
699 // fSqlType will be something like SQL_VARCHAR. This parameter determines
700 // the data type inf. is gathered for.
702 // SqlTypeInfo is a structure that is filled in with data type information,
707 // Get information about the data type specified
708 if (SQLGetTypeInfo(hstmt
, fSqlType
) != SQL_SUCCESS
)
709 return(DispAllErrors(henv
, hdbc
, hstmt
));
711 if ((retcode
= SQLFetch(hstmt
)) != SQL_SUCCESS
)
713 #ifdef DBDEBUG_CONSOLE
714 if (retcode
== SQL_NO_DATA_FOUND
)
715 cout
<< "SQL_NO_DATA_FOUND fetching inf. about data type." << endl
;
717 DispAllErrors(henv
, hdbc
, hstmt
);
718 SQLFreeStmt(hstmt
, SQL_CLOSE
);
721 // Obtain columns from the record
722 if (SQLGetData(hstmt
, 1, SQL_C_CHAR
, (UCHAR
*) structSQLTypeInfo
.TypeName
, DB_TYPE_NAME_LEN
, &cbRet
) != SQL_SUCCESS
)
723 return(DispAllErrors(henv
, hdbc
, hstmt
));
724 if (SQLGetData(hstmt
, 3, SQL_C_LONG
, (UCHAR
*) &structSQLTypeInfo
.Precision
, 0, &cbRet
) != SQL_SUCCESS
)
725 return(DispAllErrors(henv
, hdbc
, hstmt
));
726 if (SQLGetData(hstmt
, 8, SQL_C_SHORT
, (UCHAR
*) &structSQLTypeInfo
.CaseSensitive
, 0, &cbRet
) != SQL_SUCCESS
)
727 return(DispAllErrors(henv
, hdbc
, hstmt
));
728 // if (SQLGetData(hstmt, 14, SQL_C_SHORT, (UCHAR*) &structSQLTypeInfo.MinimumScale, 0, &cbRet) != SQL_SUCCESS)
729 // return(DispAllErrors(henv, hdbc, hstmt));
731 //#ifdef __UNIX__ // BJO : IODBC knows about 5, not 15...
732 // if (SQLGetData(hstmt, 5, SQL_C_SHORT,(UCHAR*) &structSQLTypeInfo.MaximumScale, 0, &cbRet) != SQL_SUCCESS)
733 // return(DispAllErrors(henv, hdbc, hstmt));
735 if (SQLGetData(hstmt
, 15, SQL_C_SHORT
,(UCHAR
*) &structSQLTypeInfo
.MaximumScale
, 0, &cbRet
) != SQL_SUCCESS
)
736 return(DispAllErrors(henv
, hdbc
, hstmt
));
739 if (structSQLTypeInfo
.MaximumScale
< 0)
740 structSQLTypeInfo
.MaximumScale
= 0;
742 // Close the statement handle which closes open cursors
743 if (SQLFreeStmt(hstmt
, SQL_CLOSE
) != SQL_SUCCESS
)
744 return(DispAllErrors(henv
, hdbc
, hstmt
));
746 // Completed Successfully
749 } // wxDB::getDataTypeInfo()
751 /********** wxDB::Close() **********/
752 void wxDB::Close(void)
754 // Close the Sql Log file
761 // Free statement handle
764 if (SQLFreeStmt(hstmt
, SQL_DROP
) != SQL_SUCCESS
)
765 DispAllErrors(henv
, hdbc
);
768 // Disconnect from the datasource
769 if (SQLDisconnect(hdbc
) != SQL_SUCCESS
)
770 DispAllErrors(henv
, hdbc
);
772 // Free the connection to the datasource
773 if (SQLFreeConnect(hdbc
) != SQL_SUCCESS
)
774 DispAllErrors(henv
, hdbc
);
776 // There should be zero Ctable objects still connected to this db object
777 assert(nTables
== 0);
780 CstructTablesInUse
*tiu
;
782 pNode
= TablesInUse
.First();
787 tiu
= (CstructTablesInUse
*)pNode
->Data();
788 if (tiu
->pDb
== this)
790 sprintf(s
, "(%-20s) tableID:[%6lu] pDb:[%p]", tiu
->tableName
,tiu
->tableID
,tiu
->pDb
);
791 sprintf(s2
,"Orphaned found using pDb:[%p]",this);
794 pNode
= pNode
->Next();
798 // Copy the error messages to a global variable
800 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
801 strcpy(DBerrorList
[i
],errorList
[i
]);
805 /********** wxDB::CommitTrans() **********/
806 bool wxDB::CommitTrans(void)
810 // Commit the transaction
811 if (SQLTransact(henv
, hdbc
, SQL_COMMIT
) != SQL_SUCCESS
)
812 return(DispAllErrors(henv
, hdbc
));
815 // Completed successfully
818 } // wxDB::CommitTrans()
820 /********** wxDB::RollbackTrans() **********/
821 bool wxDB::RollbackTrans(void)
823 // Rollback the transaction
824 if (SQLTransact(henv
, hdbc
, SQL_ROLLBACK
) != SQL_SUCCESS
)
825 return(DispAllErrors(henv
, hdbc
));
827 // Completed successfully
830 } // wxDB::RollbackTrans()
832 /********** wxDB::DispAllErrors() **********/
833 bool wxDB::DispAllErrors(HENV aHenv
, HDBC aHdbc
, HSTMT aHstmt
)
835 char odbcErrMsg
[DB_MAX_ERROR_MSG_LEN
];
837 while (SQLError(aHenv
, aHdbc
, aHstmt
, (UCHAR FAR
*) sqlState
, &nativeError
, (UCHAR FAR
*) errorMsg
, SQL_MAX_MESSAGE_LENGTH
- 1, &cbErrorMsg
) == SQL_SUCCESS
)
839 sprintf(odbcErrMsg
, "SQL State = %s\nNative Error Code = %li\nError Message = %s\n", sqlState
, nativeError
, errorMsg
);
840 logError(odbcErrMsg
, sqlState
);
843 #ifdef DBDEBUG_CONSOLE
844 // When run in console mode, use standard out to display errors.
845 cout
<< odbcErrMsg
<< endl
;
846 cout
<< "Press any key to continue..." << endl
;
852 wxMessageBox(odbcErrMsg
);
856 return(FALSE
); // This function always returns false.
858 } // wxDB::DispAllErrors()
860 /********** wxDB::GetNextError() **********/
861 bool wxDB::GetNextError(HENV aHenv
, HDBC aHdbc
, HSTMT aHstmt
)
863 if (SQLError(aHenv
, aHdbc
, aHstmt
, (UCHAR FAR
*) sqlState
, &nativeError
, (UCHAR FAR
*) errorMsg
, SQL_MAX_MESSAGE_LENGTH
- 1, &cbErrorMsg
) == SQL_SUCCESS
)
868 } // wxDB::GetNextError()
870 /********** wxDB::DispNextError() **********/
871 void wxDB::DispNextError(void)
873 char odbcErrMsg
[DB_MAX_ERROR_MSG_LEN
];
875 sprintf(odbcErrMsg
, "SQL State = %s\nNative Error Code = %li\nError Message = %s\n", sqlState
, nativeError
, errorMsg
);
876 logError(odbcErrMsg
, sqlState
);
881 #ifdef DBDEBUG_CONSOLE
882 // When run in console mode, use standard out to display errors.
883 cout
<< odbcErrMsg
<< endl
;
884 cout
<< "Press any key to continue..." << endl
;
888 } // wxDB::DispNextError()
890 /********** wxDB::logError() **********/
891 void wxDB::logError(char *errMsg
, char *SQLState
)
893 assert(errMsg
&& strlen(errMsg
));
895 static int pLast
= -1;
898 if (++pLast
== DB_MAX_ERROR_HISTORY
)
901 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
902 strcpy(errorList
[i
], errorList
[i
+1]);
906 strcpy(errorList
[pLast
], errMsg
);
908 if (SQLState
&& strlen(SQLState
))
909 if ((dbStatus
= TranslateSqlState(SQLState
)) != DB_ERR_FUNCTION_SEQUENCE_ERROR
)
910 DB_STATUS
= dbStatus
;
912 // Add the errmsg to the sql log
915 } // wxDB::logError()
917 /**********wxDB::TranslateSqlState() **********/
918 int wxDB::TranslateSqlState(char *SQLState
)
920 if (!wxStrcmp(SQLState
, "01000"))
921 return(DB_ERR_GENERAL_WARNING
);
922 if (!wxStrcmp(SQLState
, "01002"))
923 return(DB_ERR_DISCONNECT_ERROR
);
924 if (!wxStrcmp(SQLState
, "01004"))
925 return(DB_ERR_DATA_TRUNCATED
);
926 if (!wxStrcmp(SQLState
, "01006"))
927 return(DB_ERR_PRIV_NOT_REVOKED
);
928 if (!wxStrcmp(SQLState
, "01S00"))
929 return(DB_ERR_INVALID_CONN_STR_ATTR
);
930 if (!wxStrcmp(SQLState
, "01S01"))
931 return(DB_ERR_ERROR_IN_ROW
);
932 if (!wxStrcmp(SQLState
, "01S02"))
933 return(DB_ERR_OPTION_VALUE_CHANGED
);
934 if (!wxStrcmp(SQLState
, "01S03"))
935 return(DB_ERR_NO_ROWS_UPD_OR_DEL
);
936 if (!wxStrcmp(SQLState
, "01S04"))
937 return(DB_ERR_MULTI_ROWS_UPD_OR_DEL
);
938 if (!wxStrcmp(SQLState
, "07001"))
939 return(DB_ERR_WRONG_NO_OF_PARAMS
);
940 if (!wxStrcmp(SQLState
, "07006"))
941 return(DB_ERR_DATA_TYPE_ATTR_VIOL
);
942 if (!wxStrcmp(SQLState
, "08001"))
943 return(DB_ERR_UNABLE_TO_CONNECT
);
944 if (!wxStrcmp(SQLState
, "08002"))
945 return(DB_ERR_CONNECTION_IN_USE
);
946 if (!wxStrcmp(SQLState
, "08003"))
947 return(DB_ERR_CONNECTION_NOT_OPEN
);
948 if (!wxStrcmp(SQLState
, "08004"))
949 return(DB_ERR_REJECTED_CONNECTION
);
950 if (!wxStrcmp(SQLState
, "08007"))
951 return(DB_ERR_CONN_FAIL_IN_TRANS
);
952 if (!wxStrcmp(SQLState
, "08S01"))
953 return(DB_ERR_COMM_LINK_FAILURE
);
954 if (!wxStrcmp(SQLState
, "21S01"))
955 return(DB_ERR_INSERT_VALUE_LIST_MISMATCH
);
956 if (!wxStrcmp(SQLState
, "21S02"))
957 return(DB_ERR_DERIVED_TABLE_MISMATCH
);
958 if (!wxStrcmp(SQLState
, "22001"))
959 return(DB_ERR_STRING_RIGHT_TRUNC
);
960 if (!wxStrcmp(SQLState
, "22003"))
961 return(DB_ERR_NUMERIC_VALUE_OUT_OF_RNG
);
962 if (!wxStrcmp(SQLState
, "22005"))
963 return(DB_ERR_ERROR_IN_ASSIGNMENT
);
964 if (!wxStrcmp(SQLState
, "22008"))
965 return(DB_ERR_DATETIME_FLD_OVERFLOW
);
966 if (!wxStrcmp(SQLState
, "22012"))
967 return(DB_ERR_DIVIDE_BY_ZERO
);
968 if (!wxStrcmp(SQLState
, "22026"))
969 return(DB_ERR_STR_DATA_LENGTH_MISMATCH
);
970 if (!wxStrcmp(SQLState
, "23000"))
971 return(DB_ERR_INTEGRITY_CONSTRAINT_VIOL
);
972 if (!wxStrcmp(SQLState
, "24000"))
973 return(DB_ERR_INVALID_CURSOR_STATE
);
974 if (!wxStrcmp(SQLState
, "25000"))
975 return(DB_ERR_INVALID_TRANS_STATE
);
976 if (!wxStrcmp(SQLState
, "28000"))
977 return(DB_ERR_INVALID_AUTH_SPEC
);
978 if (!wxStrcmp(SQLState
, "34000"))
979 return(DB_ERR_INVALID_CURSOR_NAME
);
980 if (!wxStrcmp(SQLState
, "37000"))
981 return(DB_ERR_SYNTAX_ERROR_OR_ACCESS_VIOL
);
982 if (!wxStrcmp(SQLState
, "3C000"))
983 return(DB_ERR_DUPLICATE_CURSOR_NAME
);
984 if (!wxStrcmp(SQLState
, "40001"))
985 return(DB_ERR_SERIALIZATION_FAILURE
);
986 if (!wxStrcmp(SQLState
, "42000"))
987 return(DB_ERR_SYNTAX_ERROR_OR_ACCESS_VIOL2
);
988 if (!wxStrcmp(SQLState
, "70100"))
989 return(DB_ERR_OPERATION_ABORTED
);
990 if (!wxStrcmp(SQLState
, "IM001"))
991 return(DB_ERR_UNSUPPORTED_FUNCTION
);
992 if (!wxStrcmp(SQLState
, "IM002"))
993 return(DB_ERR_NO_DATA_SOURCE
);
994 if (!wxStrcmp(SQLState
, "IM003"))
995 return(DB_ERR_DRIVER_LOAD_ERROR
);
996 if (!wxStrcmp(SQLState
, "IM004"))
997 return(DB_ERR_SQLALLOCENV_FAILED
);
998 if (!wxStrcmp(SQLState
, "IM005"))
999 return(DB_ERR_SQLALLOCCONNECT_FAILED
);
1000 if (!wxStrcmp(SQLState
, "IM006"))
1001 return(DB_ERR_SQLSETCONNECTOPTION_FAILED
);
1002 if (!wxStrcmp(SQLState
, "IM007"))
1003 return(DB_ERR_NO_DATA_SOURCE_DLG_PROHIB
);
1004 if (!wxStrcmp(SQLState
, "IM008"))
1005 return(DB_ERR_DIALOG_FAILED
);
1006 if (!wxStrcmp(SQLState
, "IM009"))
1007 return(DB_ERR_UNABLE_TO_LOAD_TRANSLATION_DLL
);
1008 if (!wxStrcmp(SQLState
, "IM010"))
1009 return(DB_ERR_DATA_SOURCE_NAME_TOO_LONG
);
1010 if (!wxStrcmp(SQLState
, "IM011"))
1011 return(DB_ERR_DRIVER_NAME_TOO_LONG
);
1012 if (!wxStrcmp(SQLState
, "IM012"))
1013 return(DB_ERR_DRIVER_KEYWORD_SYNTAX_ERROR
);
1014 if (!wxStrcmp(SQLState
, "IM013"))
1015 return(DB_ERR_TRACE_FILE_ERROR
);
1016 if (!wxStrcmp(SQLState
, "S0001"))
1017 return(DB_ERR_TABLE_OR_VIEW_ALREADY_EXISTS
);
1018 if (!wxStrcmp(SQLState
, "S0002"))
1019 return(DB_ERR_TABLE_NOT_FOUND
);
1020 if (!wxStrcmp(SQLState
, "S0011"))
1021 return(DB_ERR_INDEX_ALREADY_EXISTS
);
1022 if (!wxStrcmp(SQLState
, "S0012"))
1023 return(DB_ERR_INDEX_NOT_FOUND
);
1024 if (!wxStrcmp(SQLState
, "S0021"))
1025 return(DB_ERR_COLUMN_ALREADY_EXISTS
);
1026 if (!wxStrcmp(SQLState
, "S0022"))
1027 return(DB_ERR_COLUMN_NOT_FOUND
);
1028 if (!wxStrcmp(SQLState
, "S0023"))
1029 return(DB_ERR_NO_DEFAULT_FOR_COLUMN
);
1030 if (!wxStrcmp(SQLState
, "S1000"))
1031 return(DB_ERR_GENERAL_ERROR
);
1032 if (!wxStrcmp(SQLState
, "S1001"))
1033 return(DB_ERR_MEMORY_ALLOCATION_FAILURE
);
1034 if (!wxStrcmp(SQLState
, "S1002"))
1035 return(DB_ERR_INVALID_COLUMN_NUMBER
);
1036 if (!wxStrcmp(SQLState
, "S1003"))
1037 return(DB_ERR_PROGRAM_TYPE_OUT_OF_RANGE
);
1038 if (!wxStrcmp(SQLState
, "S1004"))
1039 return(DB_ERR_SQL_DATA_TYPE_OUT_OF_RANGE
);
1040 if (!wxStrcmp(SQLState
, "S1008"))
1041 return(DB_ERR_OPERATION_CANCELLED
);
1042 if (!wxStrcmp(SQLState
, "S1009"))
1043 return(DB_ERR_INVALID_ARGUMENT_VALUE
);
1044 if (!wxStrcmp(SQLState
, "S1010"))
1045 return(DB_ERR_FUNCTION_SEQUENCE_ERROR
);
1046 if (!wxStrcmp(SQLState
, "S1011"))
1047 return(DB_ERR_OPERATION_INVALID_AT_THIS_TIME
);
1048 if (!wxStrcmp(SQLState
, "S1012"))
1049 return(DB_ERR_INVALID_TRANS_OPERATION_CODE
);
1050 if (!wxStrcmp(SQLState
, "S1015"))
1051 return(DB_ERR_NO_CURSOR_NAME_AVAIL
);
1052 if (!wxStrcmp(SQLState
, "S1090"))
1053 return(DB_ERR_INVALID_STR_OR_BUF_LEN
);
1054 if (!wxStrcmp(SQLState
, "S1091"))
1055 return(DB_ERR_DESCRIPTOR_TYPE_OUT_OF_RANGE
);
1056 if (!wxStrcmp(SQLState
, "S1092"))
1057 return(DB_ERR_OPTION_TYPE_OUT_OF_RANGE
);
1058 if (!wxStrcmp(SQLState
, "S1093"))
1059 return(DB_ERR_INVALID_PARAM_NO
);
1060 if (!wxStrcmp(SQLState
, "S1094"))
1061 return(DB_ERR_INVALID_SCALE_VALUE
);
1062 if (!wxStrcmp(SQLState
, "S1095"))
1063 return(DB_ERR_FUNCTION_TYPE_OUT_OF_RANGE
);
1064 if (!wxStrcmp(SQLState
, "S1096"))
1065 return(DB_ERR_INF_TYPE_OUT_OF_RANGE
);
1066 if (!wxStrcmp(SQLState
, "S1097"))
1067 return(DB_ERR_COLUMN_TYPE_OUT_OF_RANGE
);
1068 if (!wxStrcmp(SQLState
, "S1098"))
1069 return(DB_ERR_SCOPE_TYPE_OUT_OF_RANGE
);
1070 if (!wxStrcmp(SQLState
, "S1099"))
1071 return(DB_ERR_NULLABLE_TYPE_OUT_OF_RANGE
);
1072 if (!wxStrcmp(SQLState
, "S1100"))
1073 return(DB_ERR_UNIQUENESS_OPTION_TYPE_OUT_OF_RANGE
);
1074 if (!wxStrcmp(SQLState
, "S1101"))
1075 return(DB_ERR_ACCURACY_OPTION_TYPE_OUT_OF_RANGE
);
1076 if (!wxStrcmp(SQLState
, "S1103"))
1077 return(DB_ERR_DIRECTION_OPTION_OUT_OF_RANGE
);
1078 if (!wxStrcmp(SQLState
, "S1104"))
1079 return(DB_ERR_INVALID_PRECISION_VALUE
);
1080 if (!wxStrcmp(SQLState
, "S1105"))
1081 return(DB_ERR_INVALID_PARAM_TYPE
);
1082 if (!wxStrcmp(SQLState
, "S1106"))
1083 return(DB_ERR_FETCH_TYPE_OUT_OF_RANGE
);
1084 if (!wxStrcmp(SQLState
, "S1107"))
1085 return(DB_ERR_ROW_VALUE_OUT_OF_RANGE
);
1086 if (!wxStrcmp(SQLState
, "S1108"))
1087 return(DB_ERR_CONCURRENCY_OPTION_OUT_OF_RANGE
);
1088 if (!wxStrcmp(SQLState
, "S1109"))
1089 return(DB_ERR_INVALID_CURSOR_POSITION
);
1090 if (!wxStrcmp(SQLState
, "S1110"))
1091 return(DB_ERR_INVALID_DRIVER_COMPLETION
);
1092 if (!wxStrcmp(SQLState
, "S1111"))
1093 return(DB_ERR_INVALID_BOOKMARK_VALUE
);
1094 if (!wxStrcmp(SQLState
, "S1C00"))
1095 return(DB_ERR_DRIVER_NOT_CAPABLE
);
1096 if (!wxStrcmp(SQLState
, "S1T00"))
1097 return(DB_ERR_TIMEOUT_EXPIRED
);
1102 } // wxDB::TranslateSqlState()
1104 /********** wxDB::Grant() **********/
1105 bool wxDB::Grant(int privileges
, char *tableName
, char *userList
)
1107 char sqlStmt
[DB_MAX_STATEMENT_LEN
];
1109 // Build the grant statement
1110 strcpy(sqlStmt
, "GRANT ");
1111 if (privileges
== DB_GRANT_ALL
)
1112 strcat(sqlStmt
, "ALL");
1116 if (privileges
& DB_GRANT_SELECT
)
1118 strcat(sqlStmt
, "SELECT");
1121 if (privileges
& DB_GRANT_INSERT
)
1124 strcat(sqlStmt
, ", ");
1125 strcat(sqlStmt
, "INSERT");
1127 if (privileges
& DB_GRANT_UPDATE
)
1130 strcat(sqlStmt
, ", ");
1131 strcat(sqlStmt
, "UPDATE");
1133 if (privileges
& DB_GRANT_DELETE
)
1136 strcat(sqlStmt
, ", ");
1137 strcat(sqlStmt
, "DELETE");
1141 strcat(sqlStmt
, " ON ");
1142 strcat(sqlStmt
, tableName
);
1143 strcat(sqlStmt
, " TO ");
1144 strcat(sqlStmt
, userList
);
1146 #ifdef DBDEBUG_CONSOLE
1147 cout
<< endl
<< sqlStmt
<< endl
;
1150 WriteSqlLog(sqlStmt
);
1152 return(ExecSql(sqlStmt
));
1156 /********** wxDB::CreateView() **********/
1157 bool wxDB::CreateView(char *viewName
, char *colList
, char *pSqlStmt
, bool attemptDrop
)
1159 char sqlStmt
[DB_MAX_STATEMENT_LEN
];
1161 // Drop the view first
1162 if (attemptDrop
&& !DropView(viewName
))
1165 // Build the create view statement
1166 strcpy(sqlStmt
, "CREATE VIEW ");
1167 strcat(sqlStmt
, viewName
);
1169 if (strlen(colList
))
1171 strcat(sqlStmt
, " (");
1172 strcat(sqlStmt
, colList
);
1173 strcat(sqlStmt
, ")");
1176 strcat(sqlStmt
, " AS ");
1177 strcat(sqlStmt
, pSqlStmt
);
1179 WriteSqlLog(sqlStmt
);
1181 #ifdef DBDEBUG_CONSOLE
1182 cout
<< sqlStmt
<< endl
;
1185 return(ExecSql(sqlStmt
));
1187 } // wxDB::CreateView()
1189 /********** wxDB::DropView() **********/
1190 bool wxDB::DropView(char *viewName
)
1192 // NOTE: This function returns TRUE if the View does not exist, but
1193 // only for identified databases. Code will need to be added
1194 // below for any other databases when those databases are defined
1195 // to handle this situation consistently
1197 char sqlStmt
[DB_MAX_STATEMENT_LEN
];
1199 sprintf(sqlStmt
, "DROP VIEW %s", viewName
);
1201 WriteSqlLog(sqlStmt
);
1203 #ifdef DBDEBUG_CONSOLE
1204 cout
<< endl
<< sqlStmt
<< endl
;
1207 if (SQLExecDirect(hstmt
, (UCHAR FAR
*) sqlStmt
, SQL_NTS
) != SQL_SUCCESS
)
1209 // Check for "Base table not found" error and ignore
1210 GetNextError(henv
, hdbc
, hstmt
);
1211 if (wxStrcmp(sqlState
,"S0002")) // "Base table not found"
1213 // Check for product specific error codes
1214 if (!((Dbms() == dbmsSYBASE_ASA
&& !wxStrcmp(sqlState
,"42000")))) // 5.x (and lower?)
1217 DispAllErrors(henv
, hdbc
, hstmt
);
1224 // Commit the transaction
1225 if (! CommitTrans())
1230 } // wxDB::DropView()
1233 /********** wxDB::ExecSql() **********/
1234 bool wxDB::ExecSql(char *pSqlStmt
)
1236 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1237 if (SQLExecDirect(hstmt
, (UCHAR FAR
*) pSqlStmt
, SQL_NTS
) == SQL_SUCCESS
)
1241 DispAllErrors(henv
, hdbc
, hstmt
);
1245 } // wxDB::ExecSql()
1247 /********** wxDB::GetNext() **********/
1248 bool wxDB::GetNext(void)
1250 if (SQLFetch(hstmt
) == SQL_SUCCESS
)
1254 DispAllErrors(henv
, hdbc
, hstmt
);
1258 } // wxDB::GetNext()
1260 /********** wxDB::GetData() **********/
1261 bool wxDB::GetData(UWORD colNo
, SWORD cType
, PTR pData
, SDWORD maxLen
, SDWORD FAR
*cbReturned
)
1266 if (SQLGetData(hstmt
, colNo
, cType
, pData
, maxLen
, cbReturned
) == SQL_SUCCESS
)
1270 DispAllErrors(henv
, hdbc
, hstmt
);
1274 } // wxDB::GetData()
1276 /********** wxDB::GetColumns() **********/
1278 * 1) The last array element of the tableName[] argument must be zero (null).
1279 * This is how the end of the array is detected.
1280 * 2) This function returns an array of CcolInf structures. If no columns
1281 * were found, or an error occured, this pointer will be zero (null). THE
1282 * CALLING FUNCTION IS RESPONSIBLE FOR DELETING THE MEMORY RETURNED WHEN IT
1283 * IS FINISHED WITH IT. i.e.
1285 * CcolInf *colInf = pDb->GetColumns(tableList, userID);
1288 * // Use the column inf
1290 * // Destroy the memory
1294 CcolInf
*wxDB::GetColumns(char *tableName
[], char *userID
)
1298 CcolInf
*colInf
= 0;
1301 char tblName
[DB_MAX_TABLE_NAME_LEN
+1];
1302 char colName
[DB_MAX_COLUMN_NAME_LEN
+1];
1304 char userIdUC
[80+1];
1305 char tableNameUC
[DB_MAX_TABLE_NAME_LEN
+1];
1307 if (!userID
|| !strlen(userID
))
1310 // dBase does not use user names, and some drivers fail if you try to pass one
1311 if (Dbms() == dbmsDBASE
)
1314 // Oracle user names may only be in uppercase, so force
1315 // the name to uppercase
1316 if (Dbms() == dbmsORACLE
)
1319 for (char *p
= userID
; *p
; p
++)
1320 userIdUC
[i
++] = toupper(*p
);
1325 // Pass 1 - Determine how many columns there are.
1326 // Pass 2 - Allocate the CcolInf array and fill in
1327 // the array with the column information.
1329 for (pass
= 1; pass
<= 2; pass
++)
1333 if (noCols
== 0) // Probably a bogus table name(s)
1335 // Allocate n CcolInf objects to hold the column information
1336 colInf
= new CcolInf
[noCols
+1];
1339 // Mark the end of the array
1340 strcpy(colInf
[noCols
].tableName
, "");
1341 strcpy(colInf
[noCols
].colName
, "");
1342 colInf
[noCols
].sqlDataType
= 0;
1344 // Loop through each table name
1346 for (tbl
= 0; tableName
[tbl
]; tbl
++)
1348 // Oracle table names are uppercase only, so force
1349 // the name to uppercase just in case programmer forgot to do this
1350 if (Dbms() == dbmsORACLE
)
1353 for (char *p
= tableName
[tbl
]; *p
; p
++)
1354 tableNameUC
[i
++] = toupper(*p
);
1358 sprintf(tableNameUC
,tableName
[tbl
]);
1360 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1362 // MySQL and Access cannot accept a user name when looking up column names, so we
1363 // use the call below that leaves out the user name
1364 if (wxStrcmp(userID
,"") &&
1365 Dbms() != dbmsMY_SQL
&&
1366 Dbms() != dbmsACCESS
)
1368 retcode
= SQLColumns(hstmt
,
1369 NULL
, 0, // All qualifiers
1370 (UCHAR
*) userID
, SQL_NTS
, // Owner
1371 (UCHAR
*) tableNameUC
, SQL_NTS
,
1372 NULL
, 0); // All columns
1376 retcode
= SQLColumns(hstmt
,
1377 NULL
, 0, // All qualifiers
1379 (UCHAR
*) tableNameUC
, SQL_NTS
,
1380 NULL
, 0); // All columns
1382 if (retcode
!= SQL_SUCCESS
)
1383 { // Error occured, abort
1384 DispAllErrors(henv
, hdbc
, hstmt
);
1387 SQLFreeStmt(hstmt
, SQL_UNBIND
);
1388 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1391 SQLBindCol(hstmt
, 3, SQL_C_CHAR
, (UCHAR
*) tblName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
1392 SQLBindCol(hstmt
, 4, SQL_C_CHAR
, (UCHAR
*) colName
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
1393 SQLBindCol(hstmt
, 5, SQL_C_SSHORT
, (UCHAR
*) &sqlDataType
, 0, &cb
);
1394 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
1396 if (pass
== 1) // First pass, just add up the number of columns
1398 else // Pass 2; Fill in the array of structures
1400 if (colNo
< noCols
) // Some extra error checking to prevent memory overwrites
1402 strcpy(colInf
[colNo
].tableName
, tblName
);
1403 strcpy(colInf
[colNo
].colName
, colName
);
1404 colInf
[colNo
].sqlDataType
= sqlDataType
;
1409 if (retcode
!= SQL_NO_DATA_FOUND
)
1410 { // Error occured, abort
1411 DispAllErrors(henv
, hdbc
, hstmt
);
1414 SQLFreeStmt(hstmt
, SQL_UNBIND
);
1415 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1421 SQLFreeStmt(hstmt
, SQL_UNBIND
);
1422 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1425 } // wxDB::GetColumns()
1428 /********** wxDB::Catalog() **********/
1429 bool wxDB::Catalog(char *userID
, char *fileName
)
1431 assert(fileName
&& strlen(fileName
));
1435 char tblName
[DB_MAX_TABLE_NAME_LEN
+1];
1436 char tblNameSave
[DB_MAX_TABLE_NAME_LEN
+1];
1437 char colName
[DB_MAX_COLUMN_NAME_LEN
+1];
1439 char typeName
[30+1];
1440 SWORD precision
, length
;
1442 FILE *fp
= fopen(fileName
,"wt");
1446 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1448 if (!userID
|| !strlen(userID
))
1451 char userIdUC
[80+1];
1452 // Oracle user names may only be in uppercase, so force
1453 // the name to uppercase
1454 if (Dbms() == dbmsORACLE
)
1457 for (char *p
= userID
; *p
; p
++)
1458 userIdUC
[i
++] = toupper(*p
);
1463 if (wxStrcmp(userID
,""))
1465 retcode
= SQLColumns(hstmt
,
1466 NULL
, 0, // All qualifiers
1467 (UCHAR
*) userID
, SQL_NTS
, // User specified
1468 NULL
, 0, // All tables
1469 NULL
, 0); // All columns
1473 retcode
= SQLColumns(hstmt
,
1474 NULL
, 0, // All qualifiers
1475 NULL
, 0, // User specified
1476 NULL
, 0, // All tables
1477 NULL
, 0); // All columns
1479 if (retcode
!= SQL_SUCCESS
)
1481 DispAllErrors(henv
, hdbc
, hstmt
);
1486 SQLBindCol(hstmt
, 3, SQL_C_CHAR
, (UCHAR
*) tblName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
1487 SQLBindCol(hstmt
, 4, SQL_C_CHAR
, (UCHAR
*) colName
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
1488 SQLBindCol(hstmt
, 5, SQL_C_SSHORT
, (UCHAR
*) &sqlDataType
, 0, &cb
);
1489 SQLBindCol(hstmt
, 6, SQL_C_CHAR
, (UCHAR
*) typeName
, sizeof(typeName
), &cb
);
1490 SQLBindCol(hstmt
, 7, SQL_C_SSHORT
, (UCHAR
*) &precision
, 0, &cb
);
1491 SQLBindCol(hstmt
, 8, SQL_C_SSHORT
, (UCHAR
*) &length
, 0, &cb
);
1494 strcpy(tblNameSave
,"");
1497 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
1499 if (wxStrcmp(tblName
,tblNameSave
))
1503 fputs("================================ ", fp
);
1504 fputs("================================ ", fp
);
1505 fputs("===================== ", fp
);
1506 fputs("========= ", fp
);
1507 fputs("=========\n", fp
);
1508 sprintf(outStr
, "%-32s %-32s %-21s %9s %9s\n",
1509 "TABLE NAME", "COLUMN NAME", "DATA TYPE", "PRECISION", "LENGTH");
1511 fputs("================================ ", fp
);
1512 fputs("================================ ", fp
);
1513 fputs("===================== ", fp
);
1514 fputs("========= ", fp
);
1515 fputs("=========\n", fp
);
1516 strcpy(tblNameSave
,tblName
);
1518 sprintf(outStr
, "%-32s %-32s (%04d)%-15s %9d %9d\n",
1519 tblName
, colName
, sqlDataType
, typeName
, precision
, length
);
1520 if (fputs(outStr
, fp
) == EOF
)
1522 SQLFreeStmt(hstmt
, SQL_UNBIND
);
1523 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1530 if (retcode
!= SQL_NO_DATA_FOUND
)
1531 DispAllErrors(henv
, hdbc
, hstmt
);
1533 SQLFreeStmt(hstmt
, SQL_UNBIND
);
1534 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1537 return(retcode
== SQL_NO_DATA_FOUND
);
1539 } // wxDB::Catalog()
1542 // Table name can refer to a table, view, alias or synonym. Returns true
1543 // if the object exists in the database. This function does not indicate
1544 // whether or not the user has privleges to query or perform other functions
1546 bool wxDB::TableExists(char *tableName
, char *userID
, char *tablePath
)
1548 assert(tableName
&& strlen(tableName
));
1550 if (Dbms() == dbmsDBASE
)
1553 if (tablePath
&& strlen(tablePath
))
1554 dbName
.sprintf("%s/%s.dbf",tablePath
,tableName
);
1556 dbName
.sprintf("%s.dbf",tableName
);
1558 glt
= wxFileExists(dbName
.GetData());
1562 if (!userID
|| !strlen(userID
))
1565 char userIdUC
[80+1];
1566 // Oracle user names may only be in uppercase, so force
1567 // the name to uppercase
1568 if (Dbms() == dbmsORACLE
)
1571 for (char *p
= userID
; *p
; p
++)
1572 userIdUC
[i
++] = toupper(*p
);
1577 char tableNameUC
[DB_MAX_TABLE_NAME_LEN
+1];
1578 // Oracle table names are uppercase only, so force
1579 // the name to uppercase just in case programmer forgot to do this
1580 if (Dbms() == dbmsORACLE
)
1583 for (char *p
= tableName
; *p
; p
++)
1584 tableNameUC
[i
++] = toupper(*p
);
1588 sprintf(tableNameUC
,tableName
);
1590 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1593 // MySQL and Access cannot accept a user name when looking up table names, so we
1594 // use the call below that leaves out the user name
1595 if (wxStrcmp(userID
,"") &&
1596 Dbms() != dbmsMY_SQL
&&
1597 Dbms() != dbmsACCESS
)
1599 retcode
= SQLTables(hstmt
,
1600 NULL
, 0, // All qualifiers
1601 (UCHAR
*) userID
, SQL_NTS
, // All owners
1602 (UCHAR FAR
*)tableNameUC
, SQL_NTS
,
1603 NULL
, 0); // All table types
1607 retcode
= SQLTables(hstmt
,
1608 NULL
, 0, // All qualifiers
1609 NULL
, 0, // All owners
1610 (UCHAR FAR
*)tableNameUC
, SQL_NTS
,
1611 NULL
, 0); // All table types
1613 if (retcode
!= SQL_SUCCESS
)
1614 return(DispAllErrors(henv
, hdbc
, hstmt
));
1616 retcode
= SQLFetch(hstmt
);
1617 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
1619 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1620 return(DispAllErrors(henv
, hdbc
, hstmt
));
1623 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1626 } // wxDB::TableExists()
1629 /********** wxDB::SqlLog() **********/
1630 bool wxDB::SqlLog(enum sqlLog state
, char *filename
, bool append
)
1632 assert(state
== sqlLogON
|| state
== sqlLogOFF
);
1633 assert(state
== sqlLogOFF
|| filename
);
1635 if (state
== sqlLogON
)
1639 fpSqlLog
= fopen(filename
, (append
? "at" : "wt"));
1640 if (fpSqlLog
== NULL
)
1648 if (fclose(fpSqlLog
))
1654 sqlLogState
= state
;
1660 /********** wxDB::WriteSqlLog() **********/
1661 bool wxDB::WriteSqlLog(char *logMsg
)
1665 if (fpSqlLog
== 0 || sqlLogState
== sqlLogOFF
)
1668 if (fputs("\n", fpSqlLog
) == EOF
) return(FALSE
);
1669 if (fputs(logMsg
, fpSqlLog
) == EOF
) return(FALSE
);
1670 if (fputs("\n", fpSqlLog
) == EOF
) return(FALSE
);
1674 } // wxDB::WriteSqlLog()
1677 /********** wxDB::Dbms() **********/
1679 * Be aware that not all database engines use the exact same syntax, and not
1680 * every ODBC compliant database is compliant to the same level of compliancy.
1681 * Some manufacturers support the minimum Level 1 compliancy, and others up
1682 * through Level 3. Others support subsets of features for levels above 1.
1684 * If you find an inconsistency between the wxDB class and a specific database
1685 * engine, and an identifier to this section, and special handle the database in
1686 * the area where behavior is non-conforming with the other databases.
1689 * NOTES ABOUT ISSUES SPECIFIC TO EACH DATABASE ENGINE
1690 * ---------------------------------------------------
1693 * - Currently the only database supported by the class to support VIEWS
1696 * - Does not support the SQL_TIMESTAMP structure
1697 * - Supports only one cursor and one connect (apparently? with Microsoft driver only?)
1698 * - Does not automatically create the primary index if the 'keyField' param of SetColDef
1699 * is TRUE. The user must create ALL indexes from their program.
1700 * - Table names can only be 8 characters long
1701 * - Column names can only be 10 characters long
1704 * - To lock a record during QUERY functions, the reserved word 'HOLDLOCK' must be added
1705 * after every table name involved in the query/join if that tables matching record(s)
1707 * - Ignores the keywords 'FOR UPDATE'. Use the HOLDLOCK functionality described above
1709 * SYBASE (Enterprise)
1710 * - If a column is part of the Primary Key, the column cannot be NULL
1713 * - If a column is part of the Primary Key, the column cannot be NULL
1714 * - Cannot support selecting for update [::CanSelectForUpdate()]. Always returns FALSE
1717 * - Does not support the keywords 'ASC' or 'DESC' as of release v6.5.0
1721 DBMS
wxDB::Dbms(void)
1723 wxChar baseName
[20];
1725 wxStrncpy(baseName
,dbInf
.dbmsName
,6);
1727 // if (!wxStrnicmp(dbInf.dbmsName,"Oracle",6))
1728 if (!wxStricmp(baseName
,"Oracle"))
1730 if (!wxStricmp(dbInf
.dbmsName
,"Adaptive Server Anywhere"))
1731 return(dbmsSYBASE_ASA
);
1732 if (!wxStricmp(dbInf
.dbmsName
,"SQL Server")) // Sybase Adaptive Server Enterprise
1733 return(dbmsSYBASE_ASE
);
1734 if (!wxStricmp(dbInf
.dbmsName
,"Microsoft SQL Server"))
1735 return(dbmsMS_SQL_SERVER
);
1736 if (!wxStricmp(dbInf
.dbmsName
,"MySQL"))
1738 if (!wxStricmp(dbInf
.dbmsName
,"PostgreSQL")) // v6.5.0
1739 return(dbmsPOSTGRES
);
1740 if (!wxStricmp(dbInf
.dbmsName
,"ACCESS"))
1742 wxStrncpy(baseName
,dbInf
.dbmsName
,5);
1744 // if (!wxStrnicmp(dbInf.dbmsName,"DBASE",5))
1745 if (!wxStricmp(baseName
,"DBASE"))
1747 return(dbmsUNIDENTIFIED
);
1752 /********** GetDbConnection() **********/
1753 wxDB WXDLLEXPORT
*GetDbConnection(DbStuff
*pDbStuff
)
1757 // Scan the linked list searching for an available database connection
1758 // that's already been opened but is currently not in use.
1759 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
1761 // The database connection must be for the same datasource
1762 // name and must currently not be in use.
1763 if (pList
->Free
&& (! wxStrcmp(pDbStuff
->Dsn
, pList
->Dsn
))) // Found a free connection
1765 pList
->Free
= FALSE
;
1766 return(pList
->PtrDb
);
1770 // No available connections. A new connection must be made and
1771 // appended to the end of the linked list.
1774 // Find the end of the list
1775 for (pList
= PtrBegDbList
; pList
->PtrNext
; pList
= pList
->PtrNext
);
1776 // Append a new list item
1777 pList
->PtrNext
= new DbList
;
1778 pList
->PtrNext
->PtrPrev
= pList
;
1779 pList
= pList
->PtrNext
;
1783 // Create the first node on the list
1784 pList
= PtrBegDbList
= new DbList
;
1788 // Initialize new node in the linked list
1790 pList
->Free
= FALSE
;
1791 strcpy(pList
->Dsn
, pDbStuff
->Dsn
);
1792 pList
->PtrDb
= new wxDB(pDbStuff
->Henv
);
1794 // Connect to the datasource
1795 if (pList
->PtrDb
->Open(pDbStuff
->Dsn
, pDbStuff
->Uid
, pDbStuff
->AuthStr
))
1797 pList
->PtrDb
->SqlLog(SQLLOGstate
,SQLLOGfn
,TRUE
);
1798 return(pList
->PtrDb
);
1800 else // Unable to connect, destroy list item
1803 pList
->PtrPrev
->PtrNext
= 0;
1805 PtrBegDbList
= 0; // Empty list again
1806 pList
->PtrDb
->CommitTrans(); // Commit any open transactions on wxDB object
1807 pList
->PtrDb
->Close(); // Close the wxDB object
1808 delete pList
->PtrDb
; // Deletes the wxDB object
1809 delete pList
; // Deletes the linked list object
1813 } // GetDbConnection()
1815 /********** FreeDbConnection() **********/
1816 bool WXDLLEXPORT
FreeDbConnection(wxDB
*pDb
)
1820 // Scan the linked list searching for the database connection
1821 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
1823 if (pList
->PtrDb
== pDb
) // Found it!!!
1824 return(pList
->Free
= TRUE
);
1827 // Never found the database object, return failure
1830 } // FreeDbConnection()
1832 /********** CloseDbConnections() **********/
1833 void WXDLLEXPORT
CloseDbConnections(void)
1835 DbList
*pList
, *pNext
;
1837 // Traverse the linked list closing database connections and freeing memory as I go.
1838 for (pList
= PtrBegDbList
; pList
; pList
= pNext
)
1840 pNext
= pList
->PtrNext
; // Save the pointer to next
1841 pList
->PtrDb
->CommitTrans(); // Commit any open transactions on wxDB object
1842 pList
->PtrDb
->Close(); // Close the wxDB object
1843 delete pList
->PtrDb
; // Deletes the wxDB object
1844 delete pList
; // Deletes the linked list object
1847 // Mark the list as empty
1850 } // CloseDbConnections()
1852 /********** NumberDbConnectionsInUse() **********/
1853 int WXDLLEXPORT
NumberDbConnectionsInUse(void)
1858 // Scan the linked list counting db connections that are currently in use
1859 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
1861 if (pList
->Free
== FALSE
)
1867 } // NumberDbConnectionsInUse()
1869 /********** SqlLog() **********/
1870 bool SqlLog(enum sqlLog state
, char *filename
)
1872 bool append
= FALSE
;
1875 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
1877 if (!pList
->PtrDb
->SqlLog(state
,filename
,append
))
1882 SQLLOGstate
= state
;
1883 strcpy(SQLLOGfn
,filename
);
1889 /********** GetDataSource() **********/
1890 bool GetDataSource(HENV henv
, char *Dsn
, SWORD DsnMax
, char *DsDesc
, SWORD DsDescMax
,
1895 if (SQLDataSources(henv
, direction
, (UCHAR FAR
*) Dsn
, DsnMax
, &cb
,
1896 (UCHAR FAR
*) DsDesc
, DsDescMax
, &cb
) == SQL_SUCCESS
)
1901 } // GetDataSource()