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 IWM4QDE macro returns control to your program:

GPR 15 (and retcode, if you coded RETCODE) contains a return code.
When the value in GPR 15 is not zero, GPR 0 (and rsncode, if you coded 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 89. Return and Reason Codes for the IWM4QDE 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	xxxx0408	Equate Symbol: IwmRsnCodeWorkNotFound: Meaning: No work matching the input search criteria was found. Action: None required.
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 to use the connect token returned by the IWM4CON service requesting Queue_Manager=Yes, or Server_Manager=Yes with Server_Type=Queue.
8	xxxx0823	Equate Symbol: IwmRsnCodeDatoff Meaning: The caller invoked the service while DATOFF Action: Avoid requesting this function in this environment.
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 DAT on Primary ASC mod 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	xxxx083F	Equate Symbol: IwmRsnCodePrimaryNotOwnConn Meaning: Primary address space does not own the passed connect token. Action: Avoid requesting this function while primary address space does not own the connect token.
8	xxxx0840	Equate 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.
8	xxxx0848	Equate Symbol: IwmRsnCodeBadWorkUnitToken Meaning: The work unit token is not valid. Action: Check the specification of the WLMWUTKN parameter.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error. Action: Contact your system programmer.

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