XML adapter return and reason codes

XML Adapter returns errors to the client in either an XML adapter status message (XASM) or an XML error message.

XASM uses the same format as the IMS Connect request status message (RSM), with an ID of *XADPST*.

The return code (RC) is the XML Adapter code returned to IMS Connect on all errors in the parameter list fields EXPRXML_RSNCODE for inbound and EXPXXML_RSNCODE for outbound. The return codes are shown in the following table:

Table 1. XML adapter return codes
RC XASM RC Message ID Description
RCs from 1-99 are general errors.
8 XASM RC=8   IMS Connect passed an invalid XML adapter function code.
RCs from 100-199 are inbound errors.
108 XASM RC=108   The XML adapter did not find the specified XML Converter. Check that the XML Converter is compiled and linked to the correct data set.
112 XASM RC=112   The XML adapter failed to load the specified XML Converter. Check that the XML Converter is compiled and linked to the correct data set.
116 XASM RC=116   The XML adapter failed to load the XML Converter Metadata Service. Check that the XML Converter is linked using its name and has an alias where the last character of the name is replaced by the letter X. For example, if the XML Converter name is XMLCNVD, then link it with entry name of XMLCNVD and alias of XMLCNVX.
118 XASM RC=118   The PreInit table is full. The XML adapter failed to delete an entry from the table. This is an internal error. If the problem persists, search the problem reporting databases to find a correction for the problem. If none exists, contact IBM® Software Support.
120 XASM RC=120   The XML adapter failed to invoke the XML Converter Metadata Service. This is an internal error. If the problem persists, search the problem reporting databases to find a correction for the problem. If none exists, contact IBM Software Support.
124   HWSB0105E Failed to obtain storage.
125 XASM RC=125   The XML adapter failed to convert HWSB0105E message to the outbound code page. The conversion failure is a secondary failure; check that z/OS® support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
128   HWSB0110E Failed to invoke XML Converter.
129 XASM RC=129   The XML adapter failed to convert HWSB0110E message to the outbound code page. The conversion failure is a secondary failure; check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
132     XML Converter error. An IRZ error message is reported.
133 XASM RC=133   The XML adapter failed to convert the XML Converter error message to the outbound code page. The conversion failure is a secondary failure; check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
136   HWSB0115E Converted inbound message is greater than max supported size of 32,767 bytes.
137 XASM RC=137   The XML adapter failed to convert HWSB0115E message to the outbound code page. The conversion failure is a secondary failure; check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
141 XASM RC=141   The XML adapter failed to convert the output open and close tags to the outbound code page. Check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
RCs from 200-299 are outbound errors.
208 XASM RC=208   The XML adapter did not find the specified XML Converter. Check that the XML Converter is compiled and linked to the correct data set.
212 XASM RC=212   The XML adapter failed to load the specified XML Converter. Check that the XML Converter is compiled and linked to the correct data set.
216 XASM RC=216   The XML adapter failed to load the XML Converter Metadata Service. Check that the XML Converter is linked using its name and has an alias where the last character of the name is replaced by the letter X. For example, if the XML Converter name is XMLCNVD, then link the XML converter with entry name of XMLCNVD and alias of XMLCNVX.
218 XASM RC=218   The PreInit table is full. The XML adapter failed to delete an entry from the table. This problem is internal. If the problem persists, search the problem reporting databases to find a correction for the problem. If none exists, contact IBM Software Support.
220 XASM RC=220   The XML adapter failed to invoke the XML Converter Metadata Service. This problem is internal. If the problem persists, search the problem reporting databases to find a correction for the problem. If none exists, contact IBM Software Support.
224   HWSB0205E Failed to obtain storage.
225 XASM RC=225   The XML adapter failed to convert HWSB0205E to the outbound code page. The conversion failure is a secondary failure; check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
228   HWSB0210E Failed to invoke XML Converter.
229 XASM RC=229   The XML adapter failed to convert HWSB0210E message to the outbound code page. The conversion failure is a secondary failure; check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
232     XML Converter error. An IRZ error message is reported.
233 XASM RC=233   The XML adapter failed to convert an XML Converter error message to the outbound code page. Check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
237 XASM RC=237   The XML adapter failed to convert an IMS DFS message to the outbound code page. Check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.
241 XASM RC=241   The XML adapter failed to convert the output open and close tags to the outbound code page. Check that z/OS support for Unicode Conversion Services is setup to support conversions from EBCDIC to UTF-8 and vice versa.