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 IWM4STEN 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 96. Return and Reason Codes for the IWM4STEN Macro
Return Code	Return 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 work unit is not associated with an enclave. Action: None required.
4	xxxx041F	Equate Symbol: IwmRsnCodeExecEnvChanged Meaning: The execution environment has changed while the requested function is in progress. Action: None required.
4	xxxx042F	Equate Symbol: IwmRsnCodeSecondaryWorkDeleted Meaning: There were secondary work requests queued to this server task. The caller was expected to process them using IWM4SSM before calling IWM4STEN. The secondary work requests were deleted. Action: Select all secondary work requests before issuing IWM4STEN.
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: The 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: The caller has EUT FRR established. Action: Avoid requesting this function with an EUT FRR set.
8	xxxx0823	Equate Symbol: IwmRsnCodeDatoff Meaning: The caller invoked the service while DATOFF Action: Avoid requesting this function in this environment.
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	xxxx0825	Equate Symbol: IwmRsnCodeAscModeNotPrimary Meaning: The caller invoked the service but was not DAT on Primary ASC mode. Action: Avoid requesting this function in this environment.
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	xxxx0841	Equate Symbol: IwmRsnCodeXmemMode Meaning: The caller invoked the service but was in cross-memory mode. Action: Avoid requesting this function in cross-memory mode.
8	xxxx084F	Equate Symbol: IwmRsnCodeWrongExecToken Meaning: Current dispatchable work unit is not associated with the input execution unit token. Action: Check for possible storage overlay of the execution unit token.
8	xxxx0859	Equate Symbol: IwmRsnCodeEnclaveSubTaskExists Meaning: The current dispatchable work unit has residual subtasks propagated to the enclave which are still associated with the enclave. The operation (IWM4STBG) that associated this work unit with the enclave did not specify SUBTASKS=YES. 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