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 IWMAEDEF 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 103. Return and Reason Codes for the IWMAEDEF 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.

8xxxx0821Equate Symbol: IwmRsnCodeBadConn

Meaning: Input connect token does not pass validity checking.

Action: Make sure to use the connect token returned by the IWM4CON service requesting Queue_Manager=Yes, or Server_Manager=Yes with Server_Type=Queue.

8xxxx0823Equate Symbol: IwmRsnCodeDatoff

Meaning: The caller invoked the service while DATOFF

Action: Avoid requesting this function in this environment.

8xxxx0824Equate Symbol: IwmRsnCodeAmode24

Meaning: Caller invoked the 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 use of keywords that are not supported by the MVS™ release on which the program is running.

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

Meaning: Version number in parameter list is not valid.

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

8xxxx083FEquate Symbol: IwmRsnCodePrimaryNotOwnConn

Meaning: Primary address space does not own the passed connect token.

Action: Ensure that the primary address space has previously connected to WLM using the IWM4CON macro. Ensure that the connect token returned by the IWM4CON macro is passed to the IWMAEDEF macro.

8xxxx0840Equate Symbol: IwmRsnCodeServiceNotEnabled

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

Action: Make sure that Queue_Manager=Yes, or Server_Manager=Yes with Server_Type=Queue is specified on the IWM4CON request to enable this service.

8xxxx0842Equate Symbol: IwmRsnCodeNoWLMConnect

Meaning: Caller's space disconnected from WLM during processing of the request.

Action: None.

8xxxx0890Equate Symbol: IwmRsnCodeApplEnvExists

Meaning: The caller tried to add an application environment that has already been defined. subsystem type.

Action: Check whether the correct application environment name is being used. Make sure that a unique application environment name is used when adding application environments.

8xxxx0891Equate Symbol: IwmRsnCodeApplEnvNotFound

Meaning: The caller tried to delete or modify an application environment that does not exist.

Action: Check whether the correct application environment name is being used.

CEquate Symbol: IwmRetCodeEnvError

Meaning: Environmental error.

Cxxxx0C01Equate Symbol: IwmRsnCodeNoStg

Meaning: Storage is not available for the request.

Action: Contact your system programmer. There is a common storage shortage.

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