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 IWMELEAV 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 31. Return and Reason Codes for the IWMELEAV 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	xxxx041C	Equate Symbol: IwmRsnCodeNotEnclave Meaning: The current dispatchable workunit is not associated with an enclave. Action: Check for possible asynchronous events which may have deleted the enclave.
4	xxxx044D	Equate Symbol: IwmRsnCodeXmSoNoSubtasks Meaning: The corresponding IWMEJOIN requested SUBTASKS=YES but IWMELEAV was issued with the primary address space not equal to the home address space. No processing of subtasks was done. The Leave processing completed successfully because the current dispatchable work unit does not have residual subtasks propagated to the enclave which are still associated with the enclave. Action: Issue IWMELEAV with PASN=HASN if you need the subtasks processed.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0801	Equate Symbol: IwmRsnCodeSrbMode Meaning: Caller is in SRB mode. Action: Avoid requesting this function while in SRB mode.
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	xxxx0810	Equate Symbol: IwmRsnCodeEutFrr Meaning: Caller has EUT FRR established. Action: Avoid requesting this function with an EUT FRR set.
8	xxxx0823	Equate Symbol: IwmRsnCodeDatoff Meaning: Caller invoked service while DATOFF Action: Avoid requesting this function in this environment.
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 addressing mode.
8	xxxx0825	Equate Symbol: IwmRsnCodeAscModeNotPrimary Meaning: Caller invoked service but was not DAT on Primary ASC mode. Action: Avoid requesting this function in this environment.
8	xxxx0826	Equate Symbol: IwmRsnCodeTaskTerm Meaning: Caller invoked service while task termination is in progress for the current TCB. Action: Avoid requesting this function while task termination is in progress.
8	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Version number in parameter list is not valid or version length field 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.
8	xxxx0845	Equate Symbol: IwmRsnCodeWrongEnclave Meaning: The current dispatchable workunit is not associated with the input enclave. Action: Check for possible storage overlay of the enclave token.
8	xxxx0850	Equate Symbol: IwmRsnCodeBeginEnvOutstanding Meaning: Current dispatchable workunit is operating under an outstanding Begin environment, enclave leave is not allowed. IWM4STEN is the required operation. Action: Avoid requesting this function in this environment.
8	xxxx0858	Equate Symbol: IwmRsnCodeNotEjoinedTcb Meaning: The current dispatchable workunit did not issue enclave Join, but only inherited enclave attribute from mother TCB. Action: Avoid requesting this function in this environment.
8	xxxx0859	Equate Symbol: IwmRsnCodeEnclaveSubTaskExists Meaning: The current dispatchable workunit has residual subtasks propagated to the enclave which are still associated with the enclave. Either the join (IWMEJOIN) of this work unit to the enclave did not specify SUBTASKS=YES or the join (IWMEJOIN) of this work unit to the enclave did specify SUBTASKS=YES, but the IWMELEAV invocation was not made with PASN=HASN. Action: Avoid requesting this function in this environment.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error. Action: Contact your system programmer.

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