Ejemplo de diagnóstico de controladores basados en DBMS

Un controlador basado en DBMS envía solicitudes a un DBMS y devuelve información a la aplicación a través del Administrador de controladores. Dado que el controlador es el componente que interactúa con el Administrador de controladores, da formato y devuelve argumentos para SQLGetDiagRec.

Por ejemplo, si, con SQL/Services, un controlador de Microsoft para Oracle Rdb encontró un nombre de cursor no válido, podría devolver los siguientes valores de SQLGetDiagRec:

SQLSTATE:         "34000"  
Native Error:      0  
Diagnostic Msg:   "[Microsoft][ODBC Rdb Driver]Invalid cursor name: EMPLOYEE_CURSOR."  

Dado que el error se produjo en el controlador, agregó prefijos al mensaje de diagnóstico del proveedor ([Microsoft]) y al controlador ([ODBC Rdb Driver]).

Si dbMS no pudo encontrar la tabla EMPLOYEE, el controlador podría dar formato y devolver los siguientes valores de SQLGetDiagRec:

SQLSTATE:         "42S02"  
Native Error:      -1  
Diagnostic Msg:   "[Microsoft][ODBC Rdb Driver][Rdb] %SQL-F-RELNOTDEF, Table EMPLOYEE "  
                  "is not defined in schema."  

Dado que se produjo el error en el origen de datos, el controlador agregó un prefijo para el identificador del origen de datos ([Rdb]) al mensaje de diagnóstico. Dado que el controlador era el componente que se interfazba con el origen de datos, agregó prefijos para su proveedor ([Microsoft]) e identificador ([ODBC Rdb Driver]) al mensaje de diagnóstico.