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 IWMMSTRT 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 118. Return and Reason Codes for the IWMMSTRT 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	xxxx0402	Equate Symbol: IwmRsnCodeNoMonEnv Meaning: The input monitoring token indicates no monitoring environment was established. Action: Establish a monitoring environment by macro IWM4MCRE.
4	xxxx0442	Equate Symbol: IwmRsnCodeCorrelatorUnknown Meaning: A unknown correlator has been passed to the EWLM_RCVD_CORR parameter. It is ignored. Action: None required.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0820	Equate Symbol: IwmRsnCodeBadMonEnv Meaning: Input monitoring environment does not pass short form validity checking. Action: Check for possible storage overlay.
8	xxxx0894	Equate Symbol: IwmRsnCodeInvalidEwlmCorr Meaning: An unknown EWLM correlator has been passed to the EWLM_S_PACORR or EWLM_S_CURCORR parameter. Action: Specify a supported correlator. You can create a supported correlator by macro IWM4CLSY.
8	xxxx0895	Equate Symbol: IwmRsnCodeEWLMServNotEnabled Meaning: The EWLM service was not enabled for a delay monitoring environment. Action: Create a monitoring environment with EWLM=YES (either on macro IWM4CON or macro IWM4MCRE).
8	xxxx08AD	Equate Symbol: IwmRsnCodeAlreadyActive Meaning: A work unit started by IWMMSTRT is already active. Action: Stop the active work unit by macro IWMMSTOP before creating a new one.
8	xxxx08AF	Equate Symbol: IwmRsnCodeArrTimeGTStartTime Meaning: The arrivaltime passed is greater than the current timestamp. Action: Check the format of the passed arrivaltime.

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