Allgemeine Operationen

• ShowError (ret, str, env, dbc, stmt) gibt die Fehlermeldung str und weitere Fehlerinformationen aus, wenn ret nicht gleich Success ist und showErrors eine der in options gesetzen Optionen ist. Ist auch die Option verboseErrorMsg gesetzt, erfolgen zusätzliche Ausgaben.

• Mit dem Kommando SetOption kann man Optionen setzen und rücksetzen. SetOption 1 -2 -3 setzt die Option showErrors und setzt die Optionen haltOnErrors und verboseErrorMsg zurück. Standardmäßig ist nur showErrors gesetzt.

• EnumDataSources(callback) ruft callback für jede Datenquelle auf, die über den ODBC-Treibermanager verfügbar ist. Indem man den Parameter continue der Callback-Prozedur auf FALSE setzt, kann man den Enumerierungsprozeß vorzeitig abbrechen. Das folgende Codestück gibt alle verfügbaren Datenquellen aus.

   nnnnnnnn¯
  
  PROCEDURE PrintDataSources (dataSource, description: ARRAY OF CHAR;
  
  		VAR continue: BOOLEAN);
  
  BEGIN
  
  			Out.String(dataSource); Out.Ln
  
  END PrintDataSources;
  
  BEGIN
  
  	...
  
  	SQLEnumDataSources(PrintDataSources)
  
  	...
  
  END
  
  

• EnumDrivers(callback) ruft callback für jeden über den ODBC-Treibermanager verfügbaren Datenbanktreiber auf. Indem man den Parameter continue der Callback-Prozedur auf FALSE setzt, kann man den Enumerierungsprozeß vorzeitig abbrechen.

• EnumDataTypes(conn, callback, sqlType) ruft callback für jeden Datentyp auf, der den gewünschten Datentyp sqlType implementiert und von der Datenbank, mit der man über conn verbunden ist, unterstützt wird. Es ist möglich, daß ein vordefinierter SQL-Datentyp von keinem, einem oder mehreren Datentypen der Datenbank implementiert wird. Wenn man für sqlType 0 angibt, wird über alle Datentypen der Datenbank iteriert. Weitere gültige Werte für sqlType sind SQLBit bis SQLLVarChar. Indem man den Parameter continue der Callback-Prozedur auf FALSE setzt, kann man den Enumerierungsprozeß vorzeitig abbrechen. Die Tabelle enthält eine kurze Beschreibung der Parameter der Callback-Prozedur callback.

   
  Table: Parameter von EnumDataTypesCB