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 IWMMXFER 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 120. Return and Reason Codes for the IWMMXFER 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: Input monitoring token indicates no monitoring environment was established. Action: None required.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx081F	Equate Symbol: IwmRsnCodeNoRelate Meaning: NO Parent environment exists since Relate Function(Continue) has not been performed or has not been performed subsequent to a Relate Function(Delete). Action: Check for possible storage overlay and whether Relate Function(Continue) has been used properly.
8	xxxx0820	Equate Symbol: IwmRsnCodeBadMonEnv Meaning: Monitoring environment does not pass verification.
8	xxxx0822	IwmRsnCodeBadParEnv: Parent monitoring environment does not pass 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 WORKREQ_STA only when the monitoring environment is created with IWMMCREA EWLM=YES or the address space is connected with IWMCONN EWLM=YES and the connect token is passed to IWMMCREA when creating the monitoring environment.
8	xxxx0897	Equate Symbol: IwmRsnCodeTranStatusInvalid Meaning: Passed work request completion status is not valid. Action: Check the EWLM ARM interface specification for valid completion status values.

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