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 IWM4MSTO 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 82. Return and Reason Codes for the IWM4MSTO 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	xxxx0441	Equate Symbol: IwmRsnCodeTooManyMsgCorrs Meaning: The correlator passed to EWLM_RCVD_CORR is ignored, since the maximum number of supported correlators has been reached. Action: None required.
4	xxxx0443	Equate Symbol: IwmRsnCodeTooManyMsgsSent Meaning: The value passed to MESSAGES_SENT is ignored, since the maximum number of messages sent is reached. Action: None required.
4	xxxx0444	Equate Symbol: IwmRsnCodeTooManyMsgsReceived Meaning: The EWLM_RCVD_CORR parameter has been specified too often. The correlated counter is not increased. 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	xxxx0897	Equate Symbol: IwmRsnCodeTranStatusInvalid Meaning: An unsupported value has been passed to the STATUS parameter. Action: Specify a supported value.
8	xxxx08AC	Equate Symbol: IwmRsnCodeTranNotStarted Meaning: No work unit has been started by IWM4MSTR for the specified monitoring environment. Action: Start a work unit by IWM4MSTR macro, before issuing this macro.

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