Return codes and messages - Documentation for Common mainframe infrastructure 2018 release
Emma Terry
During RMU processing, return codes and messages indicate the success or failure of each invocation.
Return codes
When the RMU encounters an error that causes it to terminate without continuing, a return code is generated to indicate the nature of the failure.
Each return code is described in the following table.
Registry Import Utility return codes
Return Code | Description |
|---|---|
20 | The RMU is unable to open SYSPRINT. Ensure that the SYSPRINT DD statement is specified correctly, and then resubmit the job. SYSPRINT is typically directed to SYSOUT. |
16 | The RMU is unable to open SYSIN. Ensure that the SYSIN DD statement is specified correctly, and then resubmit the job. |
12 | The RMU is unable to open an external data set, such as one that is associated with an IMPORT control statement. Error messages are generated to SYSPRINT to provide more information about which statement specified the failing data set or partitioned data set and member name. If the failing control statement specifies a ddname, check the allocation of that ddname for errors (for example, ensure that the specified member exists). |
8 | An error occurred during the processing of either an RMU control statement or an XML document. This return code is accompanied by messages (written to SYSPRINT) that can help diagnose the problem that occurred. |
Messages
During RMU processing, the utility generates a variety of messages.
Each message is prefixed with OSZ and ends with one of the following message severity indicators:
- E - Error
- W - Warning
- I - Informational
Most RMU messages are in the range OSZ1500x through OSZ1699x.
If you have not changed the default values for the OPTIONS control statement, the RMU generates a small set of messages for all invocations, including:
- Each control statement, as it is being processed
- Start and end of processing of an XML document by IMPORT
- Completion of the utility program
- Warning and error messages that were generated during processing
When the TRACE option is specified, the RMU generates additional messages detailing the processing of each control statement, as well as the results of each update to an RTCS registry. These additional messages are informational.
When the TRACEX option is specified, the RMU generates additional messages detailing the progress in parsing the elements and attributes of the XML document that is being IMPORTed. These additional messages are informational and are intended for debugging problems with the RMU operation.
Note
A distinct message is always generated by any errors in the XML document input.
This section provides more information about the following topic: