Return and Reason Codes

z/OS MVS Programming: Workload Management Services

Return and Reason Codes

z/OS MVS Programming: Workload Management Services
SC34-2663-00

Return and Reason Codes

When the IWM4EQRY macro returns control to your program:

GPR 15 (and retcode, when you code RETCODE) contains a return code.
When the value in GPR 15 is not zero, GPR 0 (and rsncode, when you code RSNCODE) contains a reason code.

The following table identifies the hexadecimal return and reason codes and the equate symbol associated with each reason code. IBM support personnel may request the entire reason code, including the xxxx value.

Table 70. Return and Reason Codes for the IWM4EQRY Macro
Return Code	Reason Code	Equate Symbol Meaning and Action
0	—	Equate Symbol: IwmRetCodeOk Meaning: Successful completion. Action: None required.
4	—	Equate Symbol: IwmRetCodeWarning Meaning: Successful completion, unusual conditions noted.
4	xxxx040A	Equate Symbol: IwmRsnCodeOutputAreaTooSmall Meaning: The output area supplied is too small to receive all the available information. Action: Reinvoke the service with an output area of sufficient size to receive all information.
4	xxxx043C	Equate Symbol: IwmRsnCodeIsReset Meaning: Classification information returned may not reflect how the independent enclave is being managed. The independent enclave was reset to another service class or is reset quiesced. Information returned. Action: None required.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0803	Equate Symbol: IwmRsnCodeDisabled Meaning: Caller is disabled. Action: Avoid requesting this function while disabled.
8	xxxx0804	Equate Symbol: IwmRsnCodeLocked Meaning: Caller is locked. Action: Avoid requesting this function while locked.
8	xxxx080B	Equate Symbol: IwmRsnCodeBadPl Meaning: Error accessing parameter list. Action: Check for possible storage overlay.
8	xxxx0824	Equate Symbol: IwmRsnCodeAmode24 Meaning: Caller invoked service but was in 24 bit addressing mode. Action: Request this function only when you are in 31-bit or 64-bit addressing mode.
8	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Caller invoked service with an invalid value for PLISTVER. Action: Check for possible storage overlay of the parameter list.
8	xxxx0830	Equate Symbol: IwmRsnCodeBadAlet Meaning: Caller has an invalid ALET. The ALET is used to address the output area specified in parameter ANSAREA. Action: Check for possible storage overlay of the parameter list.
8	xxxx083A	Equate Symbol: IwmRsnCodeBadEnclave Meaning: Enclave token is invalid. Action: Check the specification of the ETOKEN parameter.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error Action: Consider reporting the problem to IBM.

Notices | Terms of use | Support | Contact z/OS | zFavorites