XML 消息文档

XML消息文档提供了有关SQL警告条件的详细信息。

当普通的SQL API存储过程遇到内部处理错误或无效参数时，数据服务器会向调用方返回SQLCODE和相应的SQL消息。发生这种情况时，程序会在xml_message参数中返回一个XML消息文档，其中包含有关警告的附加信息。

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 中生成，且仅包含英文字符。