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 IWMSINF 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 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 54. Return and Reason Codes for the IWMSINF Macro
Return Code	Reason Code	Equate Symbol, Meaning, and Action
0	—	Equate Symbol: IwmRetCodeOk Meaning: Successful completion. Action: None required.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0801	Equate Symbol: IwmRsnCodeSrbMode Meaning: The 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	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 in 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. Action: Check for possible storage overlay of the parameter list.
8	xxxx0840	Equate Symbol: IwmRsnCodeServiceNotEnabled Meaning: Caller's space connection is not enabled for this service Action: Make sure that SERVER_MANAGER=YES, SERVER_TYPE=QUEUE and MANAGE_TASKS=YES is specified on the IWM4CON request to enable this service.
8	xxxx0841	Equate Symbol: IwmRsnCodeXmemMode Meaning: The caller is in cross-memory mode. Action: Request this function only when you are not in cross-memory mode.
8	xxxx0842	Equate Symbol: IwmRsnCodeNoWLMConnect Meaning: The caller's space is not connected to WLM. Action: Invoke the IWM4CON macro before invoking this macro.
8	xxxx084D	Equate Symbol: IwmRsnCodeNotAuthConnect Meaning: The caller must be supervisor state or have PSW key mask 0-7 authority to use the requested WLM service. This applies only if the caller uses the service with MODE=POST. Action: Avoid requesting this function in this environment.
8	xxxx087B	Equate Symbol: IwmRsnCodeUnexpectedCall Meaning: The system did not expect the caller to use this service. Action: Make sure that MANAGE_TASKS=YES is specified on the IWM4CON request.
C	—	Equate Symbol: IwmRetCodeEnvError Meaning: Environmental error.
C	xxxx0C14	Equate Symbol: IwmRsnCodeNoWorkShutDown Meaning: No work selected. The caller is to shutdown. Action: Caller must disconnect by invoking the IWM4DIS macro.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error. Action: Contact your system programmer.

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