ASA Programming Guide
The Database Tools Interface
DBTools structures
Holds information needed to upgrade a database using the DBTools library.
typedef struct an_upgrade_db {
unsigned short version;
const char * connectparms;
const char * startline;
MSG_CALLBACK errorrtn;
MSG_CALLBACK msgrtn;
MSG_CALLBACK statusrtn;
a_bit_field quiet : 1;
a_bit_field dbo_avail : 1;
const char * dbo_username;
a_bit_field java_classes : 1;
a_bit_field jconnect : 1;
a_bit_field remove_java : 1;
a_bit_field java_switch_specified : 1;
const char * jdk_version;
} an_upgrade_db;
| Member | Description |
|---|---|
| version | DBTools version number. |
| connectparms |
The parameters needed to connect to the database. They take the form of connection strings, such as the following:
"UID=DBA;PWD=SQL;DBF=c:\asa\asademo.db"For the full range of connection string options, see Connection parameters |
| startline |
The command-line used to start the database engine. The following is an example start line:
"c:\asa\win32\dbeng9.exe"The default start line is used if this member is NULL |
| errorrtn | Callback routine for handling an error message |
| msgrtn | Callback routine for handling an information message |
| statusrtn | Callback routine for handling a status message |
| quiet | Operate without printing messages (1), or print messages (0) |
| dbo_avail | Set to 1. Indicates that the version of DBTools is recent enough to support the dbo_username field |
| dbo_username | The name to use for the dbo |
| java_classes | Upgrade the database to be Java-enabled |
| jconnect | Upgrade the database to include jConnect procedures |
| remove_java | Upgrade the database, removing the Java features |
| jdk_version |
One of the values for the dbinit -jdk option.
|
For more information on callback functions, see Using callback functions.