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 IWM4EDEL macro returns control to your program:

GPR 15 (and retcode, if you coded RETCODE) contains a return code.
When the value in GPR 15 is not zero, GPR 0 (and rsncode, if you coded RSNCODE) contains 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 69. Return and Reason Codes for the IWM4EDEL 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	xxxx0411	Equate Symbol: IwmRsnCodeEnclActive Meaning: Input enclave had 1 or more SRBs scheduled or running, or 1 or more TCBs joined to the enclave. Action: None required.
4	xxxx0449	Equate Symbol: IwmRsnCodeWDEDeleted Meaning: Enclave was deleted and one or several associated work-dependent enclaves were physically deleted. Action: None required.
4	xxxx044A	Equate Symbol: IwmRsnCodeActiveWDEDeleted Meaning: Enclave was deleted while it had one or several TCBs joined or SRBs scheduled/running. Additionally, one or several associated work- dependent enclaves were physically deleted. Action: None required.
4	xxxx044B	Equate Symbol: IwmRsnCodeAWDEDeleted Meaning: Enclave was deleted and one or several associated work-dependent enclaves were physically deleted. One or several physically deleted work-dependent enclaves had TCBs joined or SRBs scheduled/running. Action: None required.
4	xxxx044C	Equate Symbol: IwmRsnCodeActiveAWDEDeleted Meaning: Enclave was deleted and one or several associated work-dependent enclaves were physically deleted. The enclave itself and one or several physically deleted work-dependent enclaves had TCBs joined or SRBs scheduled/running 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: The caller is locked. Action: Avoid requesting this function while locked.
8	xxxx080B	Equate Symbol: IwmRsnCodeBadPl Meaning: Error accessing the parameter list. Action: Check for possible storage overlay.
8	xxxx0824	Equate Symbol: IwmRsnCodeAmode24 Meaning: The caller invoked the service but was in 24-bit addressing mode. Action: Request this function only when you are in 31-bit addressing mode.
8	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Version number in parameter list is not valid. Action: Check for possible storage overlay of the parameter list.
8	xxxx083A	Equate Symbol: IwmRsnCodeBadEnclave Meaning: Enclave token does not pass verification. Action: Check for possible storage overlay of the enclave token, or asynchronous events which may have deleted the enclave.
8	xxxx0872	Equate Symbol: IwmRsnCodeForeignEnclave Meaning: The enclave is foreign. Action: Use the IWMUIMPT macro to delete a foreign enclave.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error. Action: No action required. The function may be successful if invoked again.

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