Return and Reason Codes

z/OS MVS Programming: Workload Management Services

Return and Reason Codes

z/OS MVS Programming: Workload Management Services
SC34-2663-00

Return and Reason Codes

When the IWMUEXPT 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 60. Return and Reason Codes for the IWMUEXPT Macro
Return Code	Reason Code	Equate Symbol, Meaning, and Action
0	—	Equate Symbol: IwmRetCodeOk Meaning: Successful completion. Action: None required.
4	—	Equate Symbol: IwmRetCodeWarning Meaning: Successful completion, unusual conditions noted.
4	xxxx0432	Equate 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: None.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0803	Equate Symbol: IwmRsnCodeDisabled Meaning: Caller is disabled. Action: Avoid requesting this function while disabled.
8	xxxx0804	Equate Symbol: IwmRsnCodeLocked Meaning: The caller is locked. Action: Avoid requesting this function while locked.
8	xxxx080B	Equate Symbol: IwmRsnCodeBadPl Meaning: Error accessing parameter list. Action: Check for possible storage overlay.
8	xxxx0821	Equate 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.
8	xxxx0824	Equate 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.
8	xxxx0825	Equate Symbol: IwmRsnCodeAscModeNotPrimary Meaning: The caller invoked the service but was not in primary ASC mode. Action: Avoid requesting this function in this environment.
8	xxxx0827	Equate 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.
8	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Version number in parameter list is not valid. Action: Check for possible storage overlay of the parameter list.
8	xxxx0840	Equate 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.
8	xxxx0842	Equate Symbol: IwmRsnCodeNoWLMConnect Meaning: The caller's primary address space is not connected to WLM. Action: Invoke the IWM4CON macro before invoking this macro.
8	xxxx0870	Equate Symbol: IwmRsnCodeBadExportToken Meaning: The export token is not validly formatted. Action: Check for possible storage overlay of the export token.
8	xxxx0871	Equate Symbol: IwmRsnCodeDidNotExportOrImport Meaning: The primary address space did not export the enclave. Action: Invoke IWMUEXPT from the correct address space.
C	—	Equate Symbol: IwmRetCodeEnvError Meaning: Environmental error.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error. Action: Contact your system programmer.

Notices | Terms of use | Support | Contact z/OS | zFavorites