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 IWMESTRT 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 37. Return and Reason Codes for the IWMESTRT 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.

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.

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.

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.

8xxxx0885Equate Symbol: IwmRsnCodeDependentEnclave

Meaning: Service is not available for dependent enclaves.

Action: Avoid requesting this function for dependent enclaves.

8xxxx0893Equate Symbol: IwmRsnCodeMissingEWLMCorr

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

Action: Provide an EWLM correlator (EWLM_CORR) within the passed classification information.

8xxxx0894Equate Symbol: IwmRsnCodeInvalidEWLMCorr

Meaning: Passed classification information contains an EWLM correlator (EWLM_CORR) that does not pass validity checking or that is not associated with the enclave.

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: Ensure that EWLM=YES is specified on the IWMCONN request to enable this service.

8xxxx089FEquate Symbol: IwmRsnCodeMoreThanOneStart

Meaning: The service has been invoked with the EWLMMODE=EXPLICIT_SINGLE option, but a workrequest is already active for the enclave. For EWLMMODE=EXPLICIT_SINGLE only one workrequest may be active at a given point in time.

Action: Ensure that the IWMESTRT and IWMESTOP invocations are correctly paired and that only one workrequest is active.

8xxxx08A0Equate Symbol: IwmRsnCodeNotExplicitSingle

Meaning: The service has been invoked with option EWLMMODE=EXPLICIT_SINGLE, but the enclave has not been created with the ESTRT=EXPLICIT_SINGLE option or vice versa.

Action: If ESTRT=EXPLICIT_SINGLE was coded on the IWM4ECRE or IWMECREA call, EWLMMODE=EXPLICIT_SINGLE must also specified on the IWMESTRT call.
If ESTRT=EXPLICIT OR ESTRT=IMPLIED was coded on the IWM4ECRE or IWMECREA call, EWLMMODE=NORMAL must be specified on the IWMESTRT call (or the EWLMMODE parameter can be omitted).

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