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

Meaning: Successful completion.

Action: None required.

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: Caller is locked.

Action: Avoid requesting this function while locked.

8xxxx080BEquate Symbol: IwmRsnCodeBadPl

Meaning: Error accessing parameter list.

Action: Check for possible storage overlay. Also check if you call this macro in 64-bit address mode. Refer to the description of xxxx089E for further information.

8xxxx0820Equate Symbol: IwmRsnCodeBadMonEnv

Meaning: Monitoring environment does not pass short form verification.

Action: Check for possible storage overlay.

8xxxx0821Equate Symbol: IwmRsnCodeBadConn

Meaning: Connect token from the input classify parameter list does not pass validity checking.

Action: Check for possible storage overlay.

8xxxx0824Equate Symbol: IwmRsnCodeAmode24

Meaning: Caller invoked service but was in 24 bit addressing mode.

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

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

Meaning: Version number in parameter list is not valid.

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

8xxxx0836Equate Symbol: IwmRsnCodeMaxEnclave

Meaning: Enclave could not be created because the enclave limit has been reached.

Action: Check for possible problems wherein enclaves are not being deleted as expected or excessive numbers of enclaves are being created in a loop.

8xxxx0837Equate Symbol: IwmRsnCodeUserKeyConntkn

Meaning: Connect token from the input classify parameter list is associated with a user key.

Action: Invoke the function with a token associated with a system key.

8xxxx0838Equate Symbol: IwmRsnCodeClsfyAreaTooBig

Meaning: Input area associated with classification information is larger than supported.

Action: Invoke the function with an area of the proper size. Check for possible storage overlay.

8xxxx0839Equate Symbol: IwmRsnCodeClsfyPlTooSmall

Meaning: Input Classify parameter list is too small.

Action: Invoke the function with an area of the proper size. Check for possible storage overlay.

8xxxx083BEquate Symbol: IwmRsnCodeHomeNotOwnConn

Meaning: Home address space does not own the connect token from the input classify parameter list.

Action: Invoke the function with the correct home address space.

8xxxx0840Equate Symbol: IwmRsnCodeServiceNotEnabled

Meaning: Caller's space connection is not enabled for this service.

Action: Avoid requesting this function under the input connection. IWMCONN options must be specified previously to enable this service.

8xxxx085DEquate Symbol: IwmRsnCodeMonenvNotHome

Meaning: The input monitoring environment is related to an address space other than home.

Action: None required.

8xxxx0892Equate Symbol: IwmRsnCodeEWLMCorrNotAllowed

Meaning: Passed classification information must not contain an EWLM correlator (EWLM_CORR).

Action: Do not pass an EWLM correlator within the classification information when invoking the service with ESTRT=EXPLICIT.

8xxxx0894Equate Symbol: IwmRsnCodeInvalidEWLMCorr

Meaning: Passed classification information contains an ARM 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 (X'0004') or greater than 512 (X'0200').

Action: Check the specification of the EWLM correlator in the classification information.

8xxxx0895Equate Symbol: IwmRsnCodeEWLMServNotEnabled

Meaning: Service is not enabled because caller invoked the IWMCONN service with EWLM=NO.

Action: Specify the parameter WORKREQ_HDL only when connected with EWLM=YES.

8xxxx089EEquate Symbol: IwmRsnCodeServiceAModeMismatch

Meaning: The caller is in 64-bit address mode and tried to invoke a service macro that is only enabled for a 31-bit environment.

Action: Use the 64-bit enabled service macro (IWM4ECRE) or change the address mode of the caller to 31-bit.

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.

Cxxxx0C0CEquate Symbol: IwmRsnCodeClassifyFail

Meaning: Received a non-zero return code from the classification service, IWMCLSFY.

Action: No action required. Reinvoking the function later may succeed.

Cxxxx0C0DEquate Symbol: IwmRsnCodeBadClsfy

Meaning: Classification apparently can not access the current policy, possibly due to a policy switch in progress.

Action: Invoke the function when the conditions are alleviated.

Cxxxx0C20Equate Symbol: IwmRsnCodeDepClassifyFail

Meaning: Unable to obtain classification attributes for a dependent enclave.

Action: None required.

Cxxxx0C21Equate Symbol: IwmRsnCodeNoMonEnvErr

Meaning: Input monitoring token indicates no monitoring environment was established.

Action: None required.

10Equate Symbol: IwmRetCodeCompError

Meaning: Component error.

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

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014