Return and reason codes
IRRSMO00 can return the following values in the reason and return code parameters:
| SAF return code | RACF® return code | RACF reason code | Explanation |
|---|---|---|---|
| 0 | 0 | 0 | Success. The input XML was processed by IRRSMO00. All RACF commands were generated properly. If the EXECUTE option was specified, all commands were successfully run and completed with return code 0. It is possible that some commands might have issued warning or informational messages. All output from the commands is contained in the result buffer. |
| 4 | 4 | 0 | Success. The input XML was processed by IRRSMO00. All RACF commands were generated properly. All commands were run. However, one or more commands completed with a nonzero return code. All output from the commands is contained in the result buffer. The result buffer contains the r_admin return codes for each security definition. |
| 4 | 4 | 8 | All security definitions were run. However, r_admin reported an error other than 8/16/x (RACF command failed) for one or more security definitions in the request XML. The result buffer contains the r_admin return codes for each security definition. |
| 8 | 8 | 4 | Internal error. |
| 8 | 8 | 8 | Unable to initialize recovery environment. |
| 8 | 100 | x | Parameter number x in error. For reference, function_code is parameter number 9. |
| 8 | 200 | 8 | Caller specified the RunAs_user parameter and lacks authorization to appropriate SURROGAT profile. See the Authorization requirements. |
| 8 | 200 | 12 | Unauthorized caller specified the ACEE parameter. See the Authorization requirements. |
| 8 | 200 | 16 | PRECHECK '00000002'x specified, but caller lacks access to IRR.IRRSMO00.PRECHECK resource in the XFACILIT class. See Authorization requirements. |
| 8 | 200 | 20 | Profile IRR.IRRSMO00.DISABLE.XML exists in the XFACILIT class. Existence of this profile disables the R_SecMgtOperservice. The IRR.IRRSMO00.DISABLE.XML profile will be defined in a Common Criteria evaluated system. |
| 8 | 10xx | yy | z/OS® XML services reported an error with return code xx. yy is the z/OS XML reason code. |
| 8 | 2000 | 20 | The request contained an unknown segment name. |
| 8 | 2000 | 24 | The request contained a valid segment name, but in the wrong case. Segment names must be specified in lowercase. |
| 8 | 2000 | 32 | The request contained an unknown field name. |
| 8 | 2000 | 36 | The request contained a valid field name, but in the wrong case. Field names must be specified in lowercase. |
| 8 | 2000 | 40 | Unknown security definition specified or was specified in incorrect case. Security definitions are specified in lowercase. |
| 8 | 2000 | 44 | operation='del' specified in a security definition that does not support the delete operation. |
| 8 | 2000 | 52 | Character data was found in the request document in a place where character data is not permitted. |
| 8 | 2000 | 56 | Specified operation=”xx” attribute incompatible with field. |
| 8 | 2000 | 60 | Unknown or incompatible operation=”xx” attribute value specified. |
| 8 | 2000 | 64 | Unknown or incompatible XML attribute name specified. |
| 8 | 2000 | 68 | Unknown or incompatible XML attribute value specified. |
| 8 | 2000 | 72 | Unexpected XML tag encountered. |
| 8 | 2000 | 76 | Character data specified for a Boolean value, which is not allowed. |
| 8 | 2000 | 88 | Null value not allowed for this LIST field. |
| 8 | 2000 | 92 | Bad character in data value. |
| 8 | 2000 | 96 | A required XML attribute is missing from a security definition. |
| 8 | 2100+x | yy | A problem in the security definition was detected by a non-RACF external security manager (ESM). The return code is 2100+x, where x indicates the vendor slot number. For information about the cause of the error (reason code yy), see the vendor documentation. |
| 8 | 3000 | yy | See reason codes for return code 2000. In this case, the input XML request might be partially processed. The results from the partially completed request can be found in the result buffer. This is not supposed to happen. IBM® support should be contacted. |
| 8 | 3000 | 48 | Internal state transition error. Contact IBM support. |
| 8 | 3100+x | yy | A problem in the security definition was detected by a non-RACF external security manager (ESM). The return code is 3100+x, where x indicates the vendor slot number. For information about the cause of the error (reason code yy), see the vendor documentation. |
| 8 | 4000 | Len | Result buffer is too small. Result_len bytes of data were copied to the result and represents work that is already processed by IRRSMO00. The data in result should be copied to local storage. After you reset result_len, call IRRSMO00 again without altering the input request or request_handle parameters. The results from subsequent calls to IRRSMO00 are appended to the results from prior calls. The reason code indicates the minimum size of the result buffer on the next call. The reason code is never less than 10000. |