DRDA サービスは、%DRDAROOT%\system ディレクトリ内の MsDrdaErrorMappings.xml ファイルに格納されている定義済みのマッピングセットに基づいて、SQL Server エラー コードとメッセージを DRDA 応答メッセージまたは DB2 SQLCA (通信領域) のインスタンスに変換します。 インバインド SQL Server エラー コードは、アウトバインド DB2 エラー コードにマップされます。 XML ドキュメントには、関連する HostIntegrationDrdaSqlErrorMappings.xsd スキーマ ファイルに記載されているように、標準形式が設定されています。
<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."
/>
例。 DB2 エラー メッセージにマップされた SQL Server エラー メッセージ。
次の表は、Microsoft SQL Server のエラー メッセージを示しています。
| アイテム | タイプ | 説明 |
|---|---|---|
| SQLエラーマッピング | 要素 | sqlErrorMappings 要素には、sqlErrorMapping 定義要素が含まれています。 |
| SQLエラーマッピング | 要素 | sqlErrorMapping 要素には、DRDA 応答メッセージにマップされた SQL Server エラー メッセージの定義が含まれています。 |
次の表は、Microsoft SQL Server のエラー メッセージを示しています。
| アイテム | タイプ | 説明 |
|---|---|---|
| msSqlMessageId | 整数 (integer) | msSqlMessageId 属性は、メッセージの識別子 (ID) を表し、サーバー全体で一意の値です。 この必須属性は整数値を受け入れます。 |
| msSqlMessageSeverityLevel (MS SQL メッセージ重大度レベル) | 整数 (integer) | msSqlMessageSeverityLevel 属性は、メッセージの重大度レベル (1 ~ 25) を表します。 この必須属性は整数値を受け入れます。 |
| エムエスエスキューエルメッセージテキスト | string(1024) | msSqlMessageText 属性は、メッセージ テキストを表します。 この必須属性は、文字列値を受け入れます。 |
次の表は、IBM DB2 エラー・メッセージを示しています。
| アイテム | タイプ | 説明 |
|---|---|---|
| drdaSqlCode | 整数 (integer) | drdaSqlCode 属性は、IBM DB2 SQLCODE を表します。 この必須属性は整数値を受け入れます。 |
| drdaSqlState | 整数 (integer) | drdaSqlState 属性は、IBM DB2 SQLSTATE を表します。 この必須属性は整数値を受け入れます。 |
| drdaReasonCode（DRDAの理由コード） | 16 進数バイナリ | drdaReasonCode 属性は、IBM DB2 理由コードを表します。 この省略可能な属性は、16 進バイナリ値を受け入れます。 既定値は 0 です。 |
| drdaメッセージテキスト | ひも | drdaMessageText 属性は、IBM DB2 メッセージ・テキストを表します。 この必須属性は、文字列値を受け入れます。 |
| drda説明テキスト | ひも | drdaExplanationText 属性は、IBM DB2 の説明テキストを表します。 この省略可能な属性は、文字列値を受け入れます。 |
| drdaActionText | ひも | drdaActionText 属性は、IBM DB2 アクション・テキストを表します。 この省略可能な属性は、文字列値を受け入れます。 |