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 IWMERES 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 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 34. Return and Reason Codes for the IWMERES 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.

4xxxx043BEquate Symbol: IwmRsnCodeIsQuiesced

Meaning: The enclave cannot be reset because an address space currently serving this enclave is quiesced. An address space is known to serve an enclave if any of its tasks is joined to the enclave or if an SRB is scheduled to the enclave and the SRB established an association with the address space by using the ENCASSOC-sysevent.

Action: Retry the request when no address spaces serving the enclave is quiesced.

8Equate Symbol: IwmRetCodeInvocError

Meaning: Invalid invocation environment or parameters.

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.

8xxxx080BEquate Symbol: IwmRsnCodeBadPl

Meaning: Error accessing parameter list.

Action: Check for possible storage overlay.

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.

8xxxx0825Equate Symbol: IwmRsnCodeAscModeNotPrimary

Meaning: The caller invoked the service but was not in primary ASC mode.

Action: Avoid requesting this function in this environment.

8xxxx0827Equate Symbol: IwmRsnCodeRsvdNot0

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

Action: Check for use of keywords that are not supported by the MVS™ release on which the program is running.

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

Meaning: Version number in parameter list is not valid.

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

8xxxx0829Equate Symbol: IwmRsnCodeBadOptions

Meaning: Parameter list omits required parameters.

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

8xxxx083AEquate Symbol: IwmRsnCodeBadEnclave

Meaning: Enclave token does not pass verification.

Action: Check for possible storage overlay of the enclave token, or asynchronous events which may have deleted the enclave.

8xxxx0841Equate Symbol: IwmRsnCodeXMemMode

Meaning: Caller is in cross memory mode.

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

8xxxx0872Equate Symbol: IwmRsnCodeForeignEnclave

Meaning: The requested service is not supported for a foreign enclave. This reason code is returned for independent foreign enclaves only.

Action: All participants of a multisystem enclave can only be reset together by resetting the original enclave on the originating system.

8xxxx0885Equate Symbol: IwmRsnCodeDependentEnclave

Meaning: The requested service is not supported for a dependent enclave. This reason code is returned for both, an original and a foreign dependent enclave.

Action: A dependent enclave cannot be reset directly. It can only be reset by resetting its owning address space.

8xxxx08B7Equate Symbol: IwmRsnCodeWorkDepEnclave

Meaning: The requested service is not supported for a 'work-dependent' enclave.

Action: A 'work-dependent' enclave cannot be reset directly. It can only be reset by resetting its owning independent enclave.

CEquate Symbol: IwmRetCodeEnvError

Meaning: Environmental error.

Cxxxx0C28Equate Symbol: IwmRsnCodeBadServiceClass

Meaning: The input service class name is not defined in the active workload manager policy.

Action: Record or report the error if appropriate.

Cxxxx0C2EEquate Symbol: IwmRsnCodeWrongMode

Meaning: Reserved.

Cxxxx0C32Equate Symbol: IwmRsnCodeNotEligibleForSrvClass

Meaning: The active job in the specified address space or the specified enclave is not eligible for reset into the specified system service class. Only address spaces created with the ASCRE HIPRI attribute are eligible for reset into the SYSTEM service class.

Action: Record or report the error if appropriate.

10Equate Symbol: IwmRetCodeCompError

Meaning: Component error.

Action: Contact your system programmer.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014