Exempel på gatewaydiagnostik

I en gatewayarkitektur skickar en drivrutin begäranden till en gateway som stöder ODBC. Gatewayen skickar begäranden till en DBMS. Eftersom det är komponenten som samverkar med Driver Manager formaterar och returnerar drivrutinen argument för SQLGetDiagRec.

Om Oracle till exempel baserade en gateway till Rdb på Microsoft Open Data Services och rdb inte kunde hitta tabellen EMPLOYEE, kan gatewayen generera det här diagnostikmeddelandet:

"[42S02][-1][DEC][ODS Gateway][Rdb]%SQL-F-RELNOTDEF, Table EMPLOYEE is not defined "  
   "in schema."  

Eftersom felet inträffade i datakällan lade gatewayen till ett prefix för datakällans identifierare ([Rdb]) i diagnostikmeddelandet. Eftersom gatewayen var komponenten som samverkade med datakällan lade den till prefix för leverantören ([DEC]) och identifieraren ([ODS Gateway]) i diagnostikmeddelandet. Det lade också till SQLSTATE-värdet och Rdb-felkoden i början av diagnostikmeddelandet. Detta möjliggjorde att den kunde bevara semantiken i sin egen meddelandestruktur och samtidigt tillhandahålla ODBC-diagnostikinformation till drivrutinen. Drivrutinen parsar felinformationen som är kopplad till felmeddelande från gatewayen.

Eftersom gatewaydrivrutinen är den komponent som samverkar med Driver Manager använder den föregående diagnostikmeddelandet för att formatera och returnera följande värden från SQLGetDiagRec:

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