Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der DRDA-Dienst konvertiert SQL Server-Fehlercodes und -Meldungen in Instanzen einer DRDA-Antwortnachricht oder eines DB2 SQLCA (Communications Area) basierend auf einem definierten Satz von Zuordnungen, die in einer MsDrdaErrorMappings.xml Datei im %DRDAROOT%\Systemverzeichnis gespeichert sind. Der ingebundene SQL Server-Fehlercode ist dem out-gebundenen DB2-Fehlercode zugeordnet. Das XML-Dokument enthält ein festgelegtes Standardformat, wie in der zugeordneten HostIntegrationDrdaSqlErrorMappings.xsd-Schemadatei dokumentiert.
<SqlErrorMappings>
<sqlErrorMapping
msSqlMessageId="201"
msSqlMessageSeverityLevel="16"
msSqlMessageText="Procedure or function '{0}' expects parameter '{1}', which was not supplied."
drdaSqlCode="-313"
drdaSqlState="07001"
drdaReasonCode=""
drdaMessageText="THE NUMBER OF HOST VARIABLES SPECIFIED IS NOT EQUAL TO THE NUMBER OF PARAMETER MARKERS."
drdaExplanationText="The server cannot execute a SQL statement that contains an incorrect parameter list."
drdaActionText="Verify the number and type of parameters."
/>
Beispiel: SQL Server-Fehlermeldung, die DB2-Fehlermeldung zugeordnet ist.
Die folgende Tabelle zeigt Fehlermeldungen in Microsoft SQL Server.
| Gegenstand | Typ | BESCHREIBUNG |
|---|---|---|
| sqlErrorMappings | Element | Das sqlErrorMappings-Element enthält sqlErrorMapping-Definitionselemente. |
| sqlErrorMapping | Element | Das sqlErrorMapping-Element enthält die Definition einer SQL Server-Fehlermeldung, die einer DRDA-Antwortnachricht zugeordnet ist. |
Die folgende Tabelle zeigt Fehlermeldungen in Microsoft SQL Server.
| Gegenstand | Typ | BESCHREIBUNG |
|---|---|---|
| msSqlMessageId | Integer | Das Attribut msSqlMessageId stellt den Bezeichner (ID) der Nachricht dar und ist ein eindeutiger Wert auf dem gesamten Server. Dieses erforderliche Attribut akzeptiert einen ganzzahligen Wert. |
| msSqlMessageSeverityLevel | Integer | Das Attribut msSqlMessageSeverityLevel stellt den Schweregrad der Nachricht zwischen 1 und 25 dar. Dieses erforderliche Attribut akzeptiert einen ganzzahligen Wert. |
| msSqlMessageText | string(1024) | Das Attribut "msSqlMessageText" stellt den Nachrichtentext dar. Dieses erforderliche Attribut akzeptiert einen Zeichenfolgenwert. |
In der folgenden Tabelle sind IBM DB2-Fehlermeldungen aufgeführt.
| Gegenstand | Typ | BESCHREIBUNG |
|---|---|---|
| drdaSqlCode | Integer | Das Attribut "drdaSqlCode" gibt den IBM DB2 SQLCODE an. Dieses erforderliche Attribut akzeptiert einen ganzzahligen Wert. |
| drdaSqlState | Integer | Das Attribut "drdaSqlState" gibt den IBM DB2 SQLSTATE an. Dieses erforderliche Attribut akzeptiert einen ganzzahligen Wert. |
| drdaReasonCode | Hex-Binärdatei | Das Attribut "drdaReasonCode" gibt den IBM DB2-Grundcode an. Dieses optionale Attribut akzeptiert einen hexadezimalen Binärwert. Der Standardwert ist 0. |
| drdaMessageText | Schnur | Das Attribut "drdaMessageText" gibt den IBM DB2-Nachrichtentext an. Dieses erforderliche Attribut akzeptiert einen Zeichenfolgenwert. |
| drdaErklärungstext | Schnur | Das Attribut "drdaExplanationText" gibt den ERLÄUTERUNGstext von IBM DB2 an. Dieses optionale Attribut akzeptiert einen Zeichenfolgenwert. |
| drdaActionText | Schnur | Das drdaActionText-Attribut gibt den IBM DB2-Aktionstext an. Dieses optionale Attribut akzeptiert einen Zeichenfolgenwert. |