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 IWMIMPT 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 40. Return and Reason Codes for the IWMIMPT 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.

4xxxx0432Equate Symbol: IwmRsnCodeUnknownExportToken

Meaning: No enclave matching the export token was found. The enclave may have been unexported or deleted, or the WLM coupling facility structure may have been lost.

Action: Discontinue processing the unit of work.

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: The 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 the primary address space connected to WLM using the IWM4CON service. Make sure the connect token returned by IWM4CON is passed correctly.

8xxxx0824Equate Symbol: IwmRsnCodeAmode24

Meaning: The 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: The caller invoked the 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 OS/390® 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.

8xxxx0836Equate Symbol: IwmRsnCodeMaxEnclave

Meaning: Enclave could not be created because the enclave limit ha been reached.

Action: Check for possible problems wherein enclaves are not being deleted as expected or excessive numbers of enclaves are being created in a loop.

8xxxx0840Equate Symbol: IwmRsnCodeServiceNotEnabled

Meaning: The caller's connection is not enabled for this service.

Action: Make sure that EXPTIMPT=YES is specified on the IWM4CON macro invocation.

8xxxx0842Equate Symbol: IwmRsnCodeNoWLMConnect

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

Action: Invoke the IWM4CON macro before invoking this macro.

8xxxx0870Equate Symbol: IwmRsnCodeBadExportToken

Meaning: The export token is not validly formatted.

Action: Check for possible storage overlay of the export token.

CEquate Symbol: IwmRetCodeEnvError

Meaning: Environmental error.

Cxxxx0C01Equate Symbol: IwmRsnCodeNoStg

Meaning: Virtual storage is not available for the request.

Action: Contact your system programmer.

Cxxxx0C36Equate Symbol: IwmRsnCodeStructureUnavailable

Meaning: WLM does not have access to its coupling facility structure.

Action: Check for WLM or XES messages which describe the problem.

Cxxxx0C38Equate Symbol: IwmRsnCodeUplevelObject

Meaning: The multisystem enclave requires functions that are not available on this level of the operating system.

Action: Do not process the work request on this system.

Cxxxx0C39Equate Symbol: IwmRsnCodeTooManySystems

Meaning: The sysplex has exceeded 32 systems with unique names. This can occur when a system is reIPLed into the sysplex with a different SYSNAME or CPU Adjustment factor.

Action: Do not process the work request on this system.

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