Sybase Technical Library - Product Manuals Home
[Search Forms] [Previous Section with Hits] [Next Section with Hits] [Clear Search] Expand Search
an_unload_db structure [Table of Contents] a_validate_db structure

[-] Chapter 3: The Database Tools Interface
[-] DBTools structures
[-] an_upgrade_db structure

an_upgrade_db structure


Function

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


Syntax

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


Parameters

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:\asa6\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:\asa6\win32\dbeng6.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.


See Also

DBUpgrade function

For more information on callback functions, see Using callback functions .

an_unload_db structure [Table of Contents] a_validate_db structure