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 IWMSEQRY 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 51. Return and Reason Codes for the IWMSEQRY Macro
Return CodeReason CodeEquate Symbol, Meaning, and Action
0IwmRetCodeOk: Successful completion. All requested data returned.
4IwmRetCodeWarning: Successful completion, unusual conditions noted.
4xxxx040AEquate Symbol: IwmRsnCodeOutputAreaTooSmall:

Meaning: The output area supplied is too small to receive all the available information.

Action: Obtain a new output area using the length returned in the QUERYLEN parameter and invoke the service again.

4xxxx0425Equate 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.

4xxxx0428Equate Symbol: IwmRsnCodeNoSCHENVDefined

Meaning: No scheduling environments or resources are defined in the active service policy. No data is returned in the output area.

Action: Do not use the output area.  

8IwmRetCodeInvocError: Invalid invocation environment or parameters
8xxxx0801Equate Symbol: IwmRsnCodeSrbMode:

Meaning: The caller is in SRB mode.

Action: Avoid requesting this function while in SRB mode.

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.

8xxxx0810Equate Symbol: IwmRsnCodeEutFrr

Meaning: The caller has an EUT FRR established.

Action: Avoid requesting this function with an EUT FRR set.

8xxxx0824Equate Symbol: IwmRsnCodeAmode24

Meaning: The caller is in 24-bit addressing mode.

Action: Request this function in 31-bit addressing mode.

8xxxx0825Equate Symbol: IwmRsnCodeAscModeNotPrimary

Meaning: The caller invoked the service but was not in primary ASC mode.

Action: Request this function in primary mode.

8xxxx0827Equate Symbol: IwmRsnCodeRsvdNot0

Meaning: Reserved field in parameter list was non-zero.

Action: Request this function with reserved fields zero.  

CEquate Symbol: IwmRetCodeEnvError

Meaning: Environmental error.

Cxxxx0C2CEquate Symbol: IwmRsnCodeCannotAccessPolicy

Meaning: The service cannot access the active policy possibly due to a policy activation in progress.

Action: The caller can try the service again later, or return an error indication to its caller.  

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