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 IWMCLSFY 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 104. Return and Reason Codes for the IWMCLSFY 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	xxxx0409	Equate Symbol: IwmRsnCodeNoConn Meaning: Connect token does not reflect a successful Connect. Action: None required.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0821	Equate Symbol: IwmRsnCodeBadConn Meaning: Input connect token does not pass validity checking. Action: Check for possible storage overlay.
8	xxxx0840	Equate Symbol: IwmRsnCodeServiceNotEnabled Meaning: Caller's space connection is not enabled for this service. Action: Avoid requesting this function under the input connection. IWM4CON options must be specified previously to enable this service.
8	xxxx0894	Equate Symbol: IwmRsnCodeInvalidEWLMCorr Meaning: The classification information contains an EWLM correlator (EWLM_CORR) that does not pass validity checking. The architected ARM correlator length field in the first two Bytes of the EWLM_CORR is either less than 4 ('0004'x) or greater than 512 ('0200'x). Action: Check the specification of the EWLM correlator in the classification information.
8	xxxx0895	Equate Symbol: IwmRsnCodeEWLMServNotEnabled Meaning: Service is not enabled because caller invoked the IWMCONN service with EWLM=NO. Action: Specify the parameter EWLM_CORR only when connected with EWLM=YES.
C	—	Equate Symbol: IwmRetCodeEnvError Meaning: Environmental error.
C	xxxx0C01	Equate Symbol: IwmRsnCodeNoStg Meaning: Storage is not available for the request. Action: There is a storage shortage. The function may work successfully at a later time.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error. Action: No action required. The function may be successful if invoked again.

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