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 IWMRQRY 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 48. Return and Reason Codes for the IWMRQRY 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	xxxx040A	Equate Symbol: IwmRsnCodeOutputAreaTooSmall Meaning: The output area supplied is too small to receive all the available information. Action: None required. If necessary, reinvoke the service with an output area of sufficient size to receive all information.
4	xxxx042C	Equate Symbol: IwmRsnCodeEtokenNoMatch Meaning: No enclave information matching the input enclave token was found. Enclave related information is not returned. Action: None required.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0801	Equate Symbol: IwmRsnCodeSrbMode Meaning: Caller is in SRB mode. Action: Avoid requesting this function while in SRB mode.
8	xxxx0803	Equate Symbol: IwmRsnCodeDisabled Meaning: Caller is disabled. Action: Avoid requesting this function while disabled.
8	xxxx0804	Equate Symbol: IwmRsnCodeLocked Meaning: Caller is locked. Action: Avoid requesting this function while locked.
8	xxxx080B	Equate Symbol: IwmRsnCodeBadPl Meaning: Error accessing parameter list. Action: Check for possible storage overlay.
8	xxxx0810	Equate Symbol: IwmRsnCodeEutFrr Meaning: Caller has EUT FRR established. Action: Avoid requesting this function with an EUT FRR set.
8	xxxx0812	Equate Symbol: IwmRsnCodeBadAscb Meaning: The ASID value specified on the ASID keyword is invalid. Action: Check for possible storage overlay.
8	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Version number in parameter list is not valid or version length field is not valid. Action: Check for possible storage overlay of the parameter list.
8	xxxx0830	Equate Symbol: IwmRsnCodeBadAlet Meaning: Caller has passed an invalid ALET. Action: Check for possible storage overlay of the parameter list or variable.
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.
C	xxxx0C0A	Equate Symbol: IwmRsnCodeSuspended Meaning: Data sampling is suspended as a result of a component error. No data can be returned for this IWMRQRY invocation. Action: Reinvoke the function as it may be sucessful.
C	xxxx0C0B	Equate Symbol: IwmRsnCodeStateChanged Meaning: A state change (a policy activation) occurred while the data for the last sampling interval was being collected. No data is returned for this invocation of IWMRQRY. Action: The current sampling interval should be bypassed, future invocations of IWMRQRY for subsequent sampling intervals should begin returning data again.
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