Understanding parsing errors

The IMS Spool API support provides feedback to the application program when IMS detects errors in the print data set options included on either the CHNG calls or SETO calls. This section describes the high-level processing of the parameters associated with the CHNG and SETO calls, including some examples of errors and the types of feedback information that can be expected.

Error codes provides a summary of the error codes that can be expected to be returned if the application provides a feedback area. It might be useful for the application to develop ways to display these errors by sending a message to an IMS printer or some other technique that allows examination of the parameter lists and feedback area without having to look at a dump. This section discusses each error code and provides some examples of when the error code might be expected. This discussion applies to these calls when used with the IMS Spool API support.

When diagnosing multiple parsing error return codes, the first code returned should be the most meaningful. Errors detected with incorrect length fields or previously invalid keywords can result in valid keywords being reported as errors.