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 IWMWSYSQ 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 63. Return and Reason Codes for the IWMWSYSQ 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: None required. If necessary, reinvoke the service with an output area of sufficient size (returned in QUERYLEN) to receive all information.
4	xxxx0420	Equate Symbol: IwmRsnCodeSysInfoIncomplete Meaning: System capacity data for one or more systems running in goal mode is unavailable when the IWMWSYSQ service is invoked. Action: None required. If necessary, wait a few minutes and reinvoke the service to receive all information.
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	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	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Version number in parameter list is not valid or the length specified is incorrect. Action: Check for possible storage overlay of the parameter list.
8	xxxx083C	Equate Symbol: IwmRsnCodeMissingAcro Meaning: Required parameter list acronym (eye catcher) not found or a zero SYSINFO_BLOCK pointer is found to be associated with a non-zero ANSLEN. Action: Check for possible storage overlay of the parameter list after ensuring that the acronym was correctly set.
C	—	Equate Symbol: IwmRetCodeEnvError Meaning: Environmental error.
C	xxxx0C12	Equate Symbol: IwmRsnNoGoalModeSystems Meaning: There are no goal mode systems in the sysplex Action: No action required.
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