Pravidla pro zpracování diagnostiky

Následující pravidla řídí zpracování diagnostiky v nástroji SQLGetDiagRec a SQLGetDiagField.

Pro všechny komponenty ODBC:

• Nesmí nahradit, změnit nebo maskovat chyby nebo upozornění přijatá z jiné komponenty ODBC.

• Může přidat další záznam stavu, když obdrží diagnostickou zprávu z jiné komponenty ODBC. Přidaný záznam musí do původní zprávy přidat skutečnou hodnotu informací.

Komponenta ODBC, která přímo zprostředkovává rozhraní se zdrojem dat:

• Musí připojit předponu svého identifikátoru dodavatele, svého identifikátoru komponenty a identifikátoru zdroje dat k diagnostické zprávě, kterou obdrží ze zdroje dat.

• Je nutné zachovat nativní kód chyby zdroje dat.

• Musí zachovat diagnostickou zprávu zdroje dat.

Pro libovolnou komponentu ODBC, která generuje chybu nebo upozornění nezávisle na zdroji dat:

• Je nutné zadat správný stav SQLSTATE pro chybu nebo upozornění.

• Musí vygenerovat text diagnostické zprávy.

• Musí přidat předponu identifikátoru dodavatele a identifikátoru komponenty k diagnostické zprávě.

• Musí se vrátit nativní kód chyby, pokud je k dispozici a smysluplný.

Pro komponentu ODBC, která je součástí rozhraní Správce ovladačů:

• Musí inicializovat výstupní argumenty SQLGetDiagRec a SQLGetDiagField.

• Musí formátovat a vracet diagnostické informace jako výstupní argumenty SQLGetDiagRec a SQLGetDiagField při volání této funkce.

Pro jednu jinou komponentu ODBC než Správce ovladačů:

• Je nutné nastavit SQLSTATE na základě nativní chyby. Pro ovladače založené na souborech a ovladače založené na DBMS, které nepoužívají bránu, musí ovladač nastavit SQLSTATE. U ovladačů založených na DBMS, které používají bránu, může ovladač nebo brána podporující rozhraní ODBC nastavit SQLSTATE.