deutschen Handbuch - QT software GmbH

5.5.1 Die Initialisierung der ODBC Umgebung
Der erste Schritt einer ODBC Applikation ist die Initialisierung der ODBC
Umgebung unter Zuordnung der Umgebungsidentifikationsnummer
(environment handle). Nachdem die notwendige Variablen deklariert
wurden
INTEGER (KIND=SQLHANDLE) :: env = SQL_NULL_HANDLE
INTEGER rtc
erfolgt der Aufruf zur Erzeugung der ODBC Umgebung:
rtc = SQLAllocHandle( SQL_HANDLE_ENV, &
SQL_NULL_HANDLE, env )
Die Funktion SQLAllocHandle gibt im Erfolgsfall (rtc =
SQL_SUCCESS) die Umgebungsidentifikationsnummer im Argument
env zurück.
Die Initialisierung einer ODBC Umgebung darf in einer Applikation nur
dann mehrmals stattfinden, nachdem die jeweils zuvor geöffnete ODBC
Umgebung geschlossen wurde (mittels SQLFreeHandle).
5.5.2 Der Verbindungsaufbau
Nachdem die ODBC Umgebung initialisiert wurde, kann die Verbindung
zum Treiber bzw. der Datenbank hergestellt werden. Die für die
Verbindungsidentifikationsnummer (connection handle) notwendige
Deklaration lautet bspw.:
INTEGER (SQLHANDLE) :: dbc = SQL_NULL_HANDLE
Für die Verbindung wird die Funktion SQLAllocHandle aufgerufen,
die als Argument die zuvor angelegte Umgebungsidentifikationsnummer
(environment handle) benötigt.
rtc = SQLAllocHandle( SQL_HANDLE_DBC, env, dbc )
Falls kein Fehler auftritt (rtc = SQL_SUCCESS), wird im letzten
Argument der Funktion die Verbindungsidentifikationsnummer
zurückgegeben.
Schließlich folgt dann der eigentliche Verbindungsaufbau, z.B. mithilfe der
Funktion SQLConnect. Die Funktion fordert die Angabe des Namens
der Datenquelle, eine Benutzeridentifikationsnummer (User ID oder auch
Login ID) und ein Paßwort. Z.B.:
rtc = SQLConnect(dbc, &
'Waehrungen'//CHAR(0), SQL_NTS, &
'dba'//CHAR(0), SQL_NTS, &
'sql'//CHAR(0), SQL_NTS )
Die Datenquelle im obigen Beispiel heißt „Waehrungen“, die
Benutzeridentifikation (Login ID) „dba“ und das Paßwort „sql“.
Sämtliche Längenangaben der Zeichenketten erfolgen intern automatisch
gemäß Angabe SQL_NTS (null terminated string). Man beachte, daß
sämtliche Zeichenketten null-terminiert sind (//CHAR(0) wurde
angehängt).
Wenn SQLConnect aufgerufen wird, sucht der Treiber Manager in der
ODBC.INI Datei bzw. in der Registrierdatenbank nach weiteren Angaben
der zugehörigen Treiber-DLL und lädt die DLL. Werden für die
Verbindung zur Datenquelle mehr Informationen benötigt, versucht der
Treiber Manager diese ebenfalls aus dem entsprechenden Abschnitt der
Treiber-DLL zu ermitteln. Falls der Name der Datenquelle nicht in der
ODBC.INI Datei bzw. Registrierdatenbank (registry) gefunden oder auch
http://www.qtsoftware.de ForDBC - Fortran Database Connectivity 22