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 IWM4STBG 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 95. Return and Reason Codes for the IWM4STBG 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.

4xxxx041FEquate Symbol: IwmRsnCodeExecEnvChanged

Meaning: The execution environment has changed while the requested function is in progress.

Action: None required.

8Equate Symbol: IwmRetCodeInvocError

Meaning: Invalid invocation environment or parameters.

8xxxx0801Equate Symbol: IwmRsnCodeSrbMode

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

Action: Avoid requesting this function while locked.

8xxxx080BEquate Symbol: IwmRsnCodeBadPl

Meaning: Error accessing parameter list.

Action: Check for possible storage overlay.

8xxxx0810Equate Symbol: IwmRsnCodeEutFrr

Meaning: Caller has EUT FRR established.

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

8xxxx0823Equate Symbol: IwmRsnCodeDatoff

Meaning: Caller invoked service while DATOFF

Action: Avoid requesting this function in this environment.

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.

8xxxx0825Equate Symbol: IwmRsnCodeAscModeNotPrimary

Meaning: Caller invoked service but was not DAT on Primary ASC mode.

Action: Avoid requesting this function in this environment.

8xxxx0826Equate Symbol: IwmRsnCodeTaskTerm

Meaning: Caller invoked service while task termination is in progress for the TCB associated with the owner.

Action: Avoid requesting this function while task termination is in progress.

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

Meaning: Version number in parameter list is not valid or version length field is not valid.

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.

8xxxx0840Equate Symbol: IwmRsnCodeServiceNotEnabled

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

Action: Make sure that SERVER_MANAGER=YES is specified on the IWM4CON request to enable this service.

8xxxx0841Equate Symbol: IwmRsnCodeXmemMode

Meaning: Caller is in cross-memory mode.

Action: Request this function only when you are not in cross-memory mode.

8xxxx0842Equate Symbol: IwmRsnCodeNoWLMConnect

Meaning: Caller's space is not connected to WLM.

Action: Invoke the IWM4CON macro before invoking this macro.

8xxxx0850Equate Symbol: IwmRsnCodeBeginEnvOutstanding

Meaning: Caller is already operating under an outstanding Begin environment.

Action: Avoid requesting this function in this environment.

8xxxx0851Equate Symbol: IwmRsnCodeSecEnvOutstanding

Meaning: Caller is already operating under an outstanding security environment.

Action: Avoid requesting this function while there is a TCB level security environment outstanding.

8xxxx0852Equate Symbol: IwmRsnCodeExecTokenNotCorrect

Meaning: The execution unit token does not identify a previously selected work unit.

Action: Verify that you have coded the WLMEUTKN parameter correctly.

8xxxx0857Equate Symbol: IwmRsnCodeAlreadyInEnclave

Meaning: Current dispatchable workunit is already in an enclave.

Action: Avoid requesting this function while the caller is already in an enclave.

8xxxx085AEquate Symbol: IwmRsnCodeSelectedWorkActive

Meaning: The selected work element associated with the input execution unit token is already in execution.

Action: You may have invoked IWM4STBG from multiple tasks in the server address space passing the same WLMEUTKN. Avoid requesting this function in this environment.

CEquate Symbol: IwmRetCodeEnvError

Meaning: Environmental error.

Cxxxx0C17Equate Symbol: IwmRsnCodeSecEnvCreateFailed

Meaning: A user security environment cannot be created.

Action: Verify that the userid is defined to RACF or check the SAF installation exit routine to enable the function.

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