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 IWMSEDES 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 50. Return and Reason Codes for the IWMSEDES Macro
Return Code	Reason Code	Equate Symbol, Meaning, and Action
0	—	IwmRetCodeOk: Successful completion.
4	—	IwmRetCodeWarning: Successful completion, unusual conditions noted.
4	xxxx0425	Equate Symbol: IwmRsnCodeNoSCHENV: Meaning: The system does not support scheduling environments services. This return code is set for releases prior to OS/390® Release 4. Action: Avoid requesting this function on releases prior to OS/390 Release 4.
4	xxxx0426	Equate Symbol: IwmRsnCodeSCHENVNotFound: Meaning: The scheduling environment specified by SCHENV does not exist. Action: Check the specification of the SCHENV parameter. If the SCHENV parameter is correct, check whether the scheduling environment is defined in the active service policy.
4	xxxx0427	Equate Symbol: IwmRsnCodeSCHENVNotAvailable: Meaning: The scheduling environment is not available on the specified system. Action: Do not process work that depends upon the scheduling environment being available on the specified system.
4	xxxx042A	Equate Symbol: IwmRsnCodeSCHENVNoSystem: Meaning: The scheduling environment exists. However, the specified system does not exist. Action: Do not process work that depends upon the scheduling environment being available on the specified system.
8	—	IwmRetCodeInvocError: Invalid invocation environment or parameters
8	xxxx0801	Equate Symbol: IwmRsnCodeSrbMode: Meaning: The caller is in SRB mode. Action: Avoid requesting this function while in SRB mode.
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	xxxx0824	Equate Symbol: IwmRsnCodeAmode24 Meaning: Caller in 24-bit addressing mode. Action: Request this function in 31-bit addressing mode.
8	xxxx0825	Equate Symbol: IwmRsnCodeAscModeNotPrimary Meaning: The caller invoked the service but was not in primary ASC mode. Action: Request this function in primary mode.
8	xxxx0827	Equate Symbol: IwmRsnCodeRsvdNot0 Meaning: Reserved field in parameter list was non-zero. Action: Request this function with reserved fields zero.
8	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Version number in parameter list or version length field is not valid. Action: Request this function with corrent version number.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error. Action: Contact your system programmer.

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