Rückkehrcodes von eingebetteten SQL-Anweisungen in den Feldern SQLCODE, SQLWARN und SQLSTATE der SQLCA-Struktur. diese Struktur ist in einer Kopfdatei SQLCA definiert. (Weitere Informationen zur SQLCA-Struktur und der Kopfdatei SQLCA finden Sie im Handbuch DB2 Application Development Guide.)
DB2-CLI-Aufrufe geben SQLCODE- und SQLSTATE-Werte zurück, die Sie über die Funktion SQLError abrufen können. (Weitere Informationen zum Abrufen von Fehlerinformationen mit der Funktion SQLError finden Sie im Handbuch CLI Guide and Reference.)
Der SQLCODE-Wert 0 bedeutet, daß die Anweisung erfolgreich (mit möglichen Warnungsbedingungen) ausgeführt wurde. Ein positiver SQLCODE-Wert bedeutet, daß die Anweisung erfolgreich, aber mit einer Warnung ausgeführt wurde. (Eingebettete SQL-Anweisungen geben Informationen zu der Warnung zurück, die dem SQLCODE-Wert 0 bzw. dem positiven SQLCODE-Wert im Feld SQLWARN zugeordnet ist.) Ein negativer SQLCODE-Wert bedeutet, daß ein Fehler aufgetreten ist.
DB2 ordnet jedem SQLCODE-Wert eine Nachricht zu. Wenn ein XML Extender UDF eine Warnungs- oder Fehlerbedingung feststellt, leitet sie die entsprechenden Informationen an DB2 weiter, wo sie in die SQLCODE-Nachricht eingebunden werden.
SQLSTATE-Werte enthalten Codes zur Ergänzung der SQLCODE-Nachrichten. Eine Beschreibung der vom XML Extender zurückgegebenen SQLSTATE-Codes finden Sie im Abschnitt SQLSTATE-Codes.
Eingebettete SQL-Anweisungen und DB2-CLI-Aufrufe, die die DB2 XML Extender-UDFs aufrufen, geben eventuell SQLCODE-Nachrichten und SQLSTATE-Werte zurück, die eindeutig aus diesen UDFs stammen. DB2 gibt diese Werte jedoch auf die gleiche Weise zurück wie andere eingebettete SQL-Anweisungen oder andere DB2-CLI-Aufrufe. Sie rufen daher diese Werte auf die gleiche Weise auf wie eingebettete SQL-Anweisungen oder DB2-CLI-Aufrufe, die keine DB2 XML Extender-UDFs starten.
Der Abschnitt SQLSTATE-Codes enthält eine Übersicht über die SQLSTATE-Werte und die Nachrichtennummer der zugeordneten Nachrichten, die vom XML Extender zurückgegeben werden können. Informationen zu den einzelnen Nachrichten finden Sie im Abschnitt Nachrichten.