The ITDBInfo class

Base class: ITErrorManager

Sets or returns information about connections to HCL Informix® databases (such as the user, database, system, and password). When an ITDBInfo is used to open a connection, the ITDBInfo becomes frozen and cannot be modified by using the Set calls.

This class provides the following methods.
Method Description
ITDBInfo() Constructs an ITDBInfo object for the system environment of the user.
ITDBInfo(const ITDBInfo &) Copy constructor. The ITDBInfo copy constructor makes a deep copy rather than a shallow copy. The new ITDBInfo object is thawed and can be modified by using the Set calls.
ITDBInfo(const ITString &db, const ITString &user = ITString(), const ITString &system = ITString(), const ITString &passwd = ITString()); Constructs ITDBInfo and sets system database and user information. This method has these parameters:
  • db is the database name.
  • user is the user name.
  • system is the system name.
  • passwd is the password.
ITBool operator==(const ITDBInfo &) const; Compares the instances of the ITDBInfo objects.
ITBool Frozen() const Returns TRUE if the information of this database object is frozen, or FALSE if the information is not frozen.
ITBool Freeze() Freezes the database information of the object.
ITBool CreateDatabase (int flags = ITDBInfo::Default, const ITString &dbspace = ITString::Null) Creates the database; returns TRUE if the database was successfully created, FALSE if it was not. The database name and server name are taken from ITDBInfo.
The following values are valid for type:
  • ITDBInfo::Default
  • ITDBInfo::Log
  • ITDBInfo::BufferedLog
  • ITDBInfo::ANSIModeLog
  • dbspace is the name of dbspace; default dbspace if omitted.
ITBool DropDatabase() Drops the database; returns TRUE if the database was successfully dropped, FALSE if it was not.
ITBool SetUser(const ITString &) Sets the user name.
ITBool SetDatabase(const ITString &) Sets the database name.
ITBool SetSystem(const ITString &) Sets the system name.
ITBool SetPassword(const ITString &) Sets the password.
const ITString &GetUser() const Returns the user name.
const ITString &GetDBLocaleName() const Returns the database locale name.
const ITString &GetSystem() const Returns the system name.
const ITString &GetDatabase() const Returns the database name.