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 IWMSSEL 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 125. Return and Reason Codes for the IWMSSEL 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.

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. Also check if you call this macro in 64-bit address mode. Refer to the description of reason code xxxx089E for further information.

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 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 possible storage overlay of the parameter list.

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

Meaning: Version number in parameter list is not valid.

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

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 IWMCONN 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 IWMCONN macro before invoking this macro.

8xxxx0854Equate Symbol: IwmRsnCodeTooManySelect

Meaning: The caller is attempting to select more work units than it has tasks to execute the work.

Action: Wait until an execution task has issued IWMSTEND before attempting to select more work units.

8xxxx0864Equate Symbol: IwmRsnCodeSecondaryWorkExists

Meaning: There are secondary work requests queued to this server task. The caller was expected to process them using IWMSSEM before calling IWMSSEL.

Action: Select all secondary work requests before issuing IWMSSEL.

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 (IWM4SSL) 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: Caller must disconnect by invoking the IWMDISC macro.

Cxxxx0C14Equate Symbol: IwmRsnCodeNoWorkShutDown

Meaning: No work selected. Caller is to shutdown.

Action: Caller must disconnect by invoking the IWMDISC macro.

Cxxxx0C3BEquate Symbol: IwmRsnCodeStopTask

Meaning: WLM decided to stop the server instance.

Action: Calling task must shutdown, but server address space must remain active.

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