z/OS MVS Programming: Workload Management Services
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Return and Reason Codes

z/OS MVS Programming: Workload Management Services
SC34-2663-00

Return and Reason Codes

When the IWMDINST 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 26. Return and Reason Codes for the IWMDINST Macro
Return CodeReason CodeEquate Symbol, Meaning, and Action
0Equate Symbol: IwmRetCodeOk

Meaning: Successful completion.

Action: None required.

4Equate Symbol: IwmRetCodeWarning

Meaning: Successful completion, unusual conditions noted.

4xxxx0413Equate Symbol: IwmRsnCodeIdsDontMatch

Meaning: COND=YES was specified on the IWMDINST macro, yet the service definition identifier specified on the IN_BASEID keyword did not match the identifier of the installed service definition. The identifier of the currently installed service definition is returned in the area specified on the QRY_BASEID keyword.

Action: None required.

8Equate Symbol: IwmRetCodeInvocError

Meaning: Invalid invocation environment or parameters.

8xxxx0801Equate Symbol: IwmRsnCodeSrbMode

Meaning: The caller is in SRB mode.

Action: Avoid requesting this function while in SRB mode.

8xxxx0803Equate Symbol: IwmRsnCodeDisabled

Meaning: Caller is disabled.

Action: Avoid requesting this function while disabled.

8xxxx0804Equate Symbol: IwmRsnCodeLocked

Meaning: The caller is locked.

Action: Avoid requesting this function while locked.

8xxxx0810Equate Symbol: IwmRsnCodeEutFrr

Meaning: The caller has EUT FRR established.

Action: Avoid requesting this function with an EUT FRR set.

8xxxx0823Equate Symbol: IwmRsnCodeDatoff

Meaning: The caller invoked the service while DATOFF

Action: Avoid requesting this function in this environment.

8xxxx0824Equate Symbol: IwmRsnCodeAmode24

Meaning: The caller invoked the service but was in 24-bit addressing mode.

Action: Request this function only when you are in 31-bit addressing mode.

8xxxx0827Equate Symbol: IwmRsnCodeRsvdNot0

Meaning: Reserved field in parameter list was non-zero.

Action: Check for possible storage overlay of the parameter list.

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

Meaning: Version number in parameter list is not valid or the length specified is incorrect.

Action: Check for possible storage overlay of the parameter list.

8xxxx0829Equate Symbol: IwmRsnCodeBadOptions

Meaning: Parameter list omits required parameters or supplies mutually exclusive parameters or provides data associated with options not selected.

Action: Check for possible storage overlay of the parameter list.

8xxxx0830Equate Symbol: IwmRsnCodeBadAlet

Meaning: The caller has passed an invalid ALET.

Action: Check for possible storage overlay of the parameter list or variable.

8xxxx083DEquate Symbol: IwmRsnCodeBadServDI

Meaning: The caller has passed a Service Definition area that failed validation.

Action: See values in VALCHECK_RSN and VALCHECK_OFFSET parameters for more information concerning the specific failure.

8xxxx0841Equate Symbol: IwmRsnCodeXMemMode

Meaning: The caller is in cross-memory mode.

Action: Invoke the function in non-cross memory mode.

8xxxx085BEquate Symbol: IwmRsnCodeNoSERVDArea

Meaning: The caller invoked the service without a required SERVD area or the SERVD area address is 0.

Action: Check for possible storage overlay of the parameter list or variable.

8xxxx08B2Equate Symbol: IwmRsnCodeParserError

Meaning: The XML parser was not able to parse the service definition XML document.

Action: See values in VALCHECK_RSN and VALCHECK_OFFSET parameters for more information concerning the specific failure. The XML parser reason codes can be found in the book: "XML System Services Users Guide and Reference".

8xxxx08B3Equate Symbol: IwmRsnCodeXmlZeroLen

Meaning: The length of the provided XML service definition is zero.

Action: Provide the correct length of the service definition.

8xxxx08B5Equate Symbol: IwmRsnCodeXmlInvalid

Meaning: The XML parser was not able to parse the service definition XML document.

Action: See values in VALCHECK_RSN and VALCHECK_OFFSET parameters for more information concerning the specific failure. The reason codes can be found in z/OS MVS Programming: Workload Management Services .

CEquate Symbol: IwmRetCodeEnvError

Meaning: Environmental error.

Cxxxx0C01Equate 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.

Cxxxx0C0EEquate Symbol: IwmRsnCodeInsufAccess

Meaning: The RACF® FACILITY class is active and a profile has been defined for the MVSADMIN.WLM.POLICY RACF facility class profile to which the caller does not have sufficient (update) access.

Action: Invoke the function when the conditions are alleviated.

Cxxxx0C0FEquate Symbol: IwmRsnCodeCDSNotAvail

Meaning: A couple data set for WLM has not been defined or it has been defined but this system does not have connectivity to the data set.

Action: No action required.

Cxxxx0C10Equate Symbol: IwmRsnCodeCDSTooSmall

Meaning: WLM CDS is too small to process the request.

Action: No action required.

10Equate Symbol: IwmRetCodeCompError

Meaning: Component error.

Action: No action required. The function may be successful if invoked again.

10xxxx0F0AEquate Symbol: IwmRsnCodeEndOfBuffer

Meaning: Internal error.

Action: Contact IBM.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014