XML メッセージ文書
XML メッセージ文書は、SQL 警告状態に関する詳細情報が提供します。
共通 SQL API ストアード・プロシージャーで内部処理エラーまたは無効なパラメーターが検出された場合、データ・サーバーは SQLCODE および対応する SQL メッセージを呼び出し元に返します。このエラーが発生した場合、プロシージャーは、警告に関する追加情報が含まれる XML メッセージ文書を xml_message パラメーターで返します。
XML メッセージ文書には、キーと値のペア、その後に続いて SQL 警告状態の詳細が出力されます。XML メッセージ文書の一般的な構造を以下に示します。
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
<key>Document Type Name</key>
<string>Data Server Message</string>
<key>Document Type Major Version</key><integer>1</integer>
<key>Document Type Minor Version</key><integer>0</integer>
<key>Data Server Product Name</key><string>DSN</string>
<key>Data Server Product Version</key><string>9.1.5</string>
<key>Data Server Major Version</key><integer>9</integer>
<key>Data Server Minor Version</key><integer>1</integer>
<key>Data Server Platform</key><string>z/OS</string>
<key>Document Locale</key><string>en_US</string>
--- Details about an SQL warning condition are included here. ---
</dict>
</plist>
次の例で示すように、SQL 警告に関する詳細は、ディクショナリー・エントリーにカプセル化されます。ディクショナリー・エントリーは、Display Name、Value、および Hint で構成されます。
<key>Short Message Text</key>
<dict>
<key>Display Name</key><string>Short Message Text</string>
<key>Value</key>
<string>DSNA630I DSNADMGC A PARAMETER FORMAT OR CONTENT ERROR WAS FOUND.
The XML input document must be empty or NULL.</string>
<key>Hint</key><string />
</dict>
XML メッセージ文書は UTF-8 で生成され、英語文字のみが含まれます。