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 IWM4MXTR 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 87. Return and Reason Codes for the IWM4MXTR 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: Monitoring token indicates that no monitoring environment exists. Action: None required.
4	xxxx040A	Equate Symbol: IwmRsnCodeOutputAreaTooSmall Meaning: The output area is too small to contain all the available information.
4	xxxx040C	Equate Symbol: IwmRsnCodeMonEnvLacksInfo Meaning: Input monitoring environment does not contain the necessary information to return the data requested. Action: None required.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0820	Equate Symbol: IwmRsnCodeBadMonEnv Meaning: Monitoring environment does not pass short form verification. Action: Check for possible storage overlay.
8	xxxx0895	Equate Symbol: IwmRsnCodeEWLMServNotEnabled Meaning: Service is not enabled because monitoring environment can not be associated with EWLM work requests. Action: Specify the parameter EWLM_CHCORR or EWLM_PACTKN only when the monitoring environment is created with IWM4MCRE EWLM=YES or the address space is connected with IWM4CON EWLM=YES and the connect token is passed to IWM4MCRE when creating the monitoring environment.
8	xxxx08AC	Equate Symbol: IwmRsnCodeTranNotStarted Meaning: A work unit has not been started. Action: Start a work unit by IWM4MSTR macro, before specifying the EWLM_S_CURCORR parameter.

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