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 IWMSRFSV 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 57. Return and Reason Codes for the IWMSRFSV 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 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.

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 current TCB.

Action: Avoid requesting this function in this environment.

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

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

Action: Check for possible overlay of the parameter list.

8xxxx083BEquate Symbol: IwmRsnCodeHomeNotOwnConn

Meaning: Home address space does not own the connect token from the input 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.

8xxxx0841Equate Symbol: IwmRsnCodeXmemMode

Meaning: Caller invoked service but was in cross-memory mode.

Action: Avoid requesting this function in cross-memory mode.

8xxxx0842Equate Symbol: IwmRsnCodeNoWLMConnect

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

Action: Issue IWM4CON with the necessary options prior to invoking this service.

CIwmRetCodeEnvError: Environmental error. Hex Reason Meaning
Code
xxxx0C01
Name: IwmRsnCodeNoStg Meaning: Storage is not available for the request. Action: There is a storage shortage. The function may work successfully at a later time.
xxxx0C1A
Name: IwmRsnCodeApplNotDefined Meaning: The application environment name is not defined in the active WLM policy. Action: Check whether the correct application environment name is being used. If so, a service administrator must define the application environment in the WLM service definition.
xxxx0C1B
Name: IwmRsnCodeApplNotSST Meaning: The application environment name is defined for use by a different subsystem type in the active WLM policy. Action: Check whether the correct application environment name is being used. If so, a service administrator must change the application environment in the WLM service definition to specify the correct subsystem type.
xxxx0C1C
Name: IwmRsnCodeServerNotStarted Meaning: No server exists for the specified application environment and no server could be started. Action: No action required. The function may be successful if invoked again.
xxxx0C22
Name: IwmRsnCodeApplEnvQuiesced Meaning: The specified application environment has been quiesced, server cannot be started for the request. Action: Restart the application environment and then retry the request.
xxxx0C23
Name: IwmRsnCodeIndLocalSystem Meaning: Local system is not running with the current WLM policy, new server cannot be started for the request. Action: Avoid requesting this function while the local system is not running with the current WLM policy.
xxxx0C24
Name: IwmRsncodeProcNameBlank Meaning: Server procname is blank, server cannot be started for the request. Action: Check the server procname, fix it, and then retry the request.
xxxx0C25
Name: IwmRsnCodeApplEnvStopped Meaning: WLM has given up trying to start a server because of failures. The associated application environment has been internally stopped. Action: Restart the application environment and then retry the request.
xxxx0C26
Name: IwmRsnCodeRouterNotActive Meaning: Either there is no router exists for the requested server or the router exists but not active. No server can be selected/started on this system. Action: Re-connect the router for the requested application environment to WLM and then retry the request.
xxxx0C27
Name: IwmRsnCodeFsvReqInCompat Meaning: Reserved
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