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 IWM4ECRE 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 68. Return and Reason Codes for the IWM4ECRE 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.

4xxxx044EEquate Symbol: IwmRsnCodeNewServcls

Meaning: Input service class token is not valid. A new one has been assigned and returned in SERVCLS (if specified).

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.

8xxxx080CEquate Symbol: IwmRsnCodeMonEnvLacksData

Meaning: Input monitoring environment does not contain the necessary information.

Action: Provide missing 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. IWM4CON 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.

8xxxx0872Equate Symbol: IwmRsnCodeForeignEnclave

Meaning: It is not allowed to create an enclave of type work-dependent from out of a foreign enclave.

Action: Make sure not to have joined a forein enclave prior to calling IWM4ECRE with TYPE=WORKDEPENDENT.

8xxxx0894Equate Symbol: IwmRsnCodeInvalidEWLMCorr

Meaning: Passed 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.

8xxxx0895Equate Symbol: IwmRsnCodeEWLMServNotEnabled

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

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

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, IWM4CLSY/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