an_upgrade_db structure

Holds information needed to upgrade a database using the DBTools library.

Syntax

typedef struct an_upgrade_db {
    unsigned short      version;
    const char *        connectparms;
    MSG_CALLBACK        errorrtn;
    MSG_CALLBACK        msgrtn;
    MSG_CALLBACK        statusrtn;
    a_bit_field         quiet           : 1;
    a_bit_field         jconnect        : 1;
} an_upgrade_db;

Members

Member

Description

version

DBTools version number.

connectparms

Parameters needed to connect to the database. They take the form of connection strings, such as the following:

"UID=DBA;PWD=sql;DBF=samples-dir\demo.db"

The database server would be started by the connection string START parameter. For example:

"START=d:\sqlany11\bin32\dbeng11.exe"

A full example connection string including the START parameter:

"UID=DBA;PWD=sql;DBF=samples-dir\demo.db;START=d:\sqlany11\bin32\dbeng11.exe"

For a list of connection parameters, see Connection parameters.

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).

jconnect

Upgrade the database to include jConnect procedures.