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 IWMDISC 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 106. Return and Reason Codes for the IWMDISC 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.

4xxxx0409Equate Symbol: IwmRsnCodeNoConn

Meaning: Input connection token does not reflect an active connection to WLM.

Action: None required.

8Equate Symbol: IwmRetCodeInvocError

Meaning: Invalid invocation environment or parameters.

8xxxx0801Equate Symbol: IwmRsnCodeSrbMode

Meaning: The caller is in SRB mode.

Action: Avoid requesting this function while in SRB mode.

8xxxx0802Equate Symbol: IwmRsnCodeXmemUserKeyTkn

Meaning: The caller is in cross-memory mode while the token was obtained in a user key.

Action: Avoid requesting this function while in cross-memory 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.

8xxxx0809Equate Symbol: IwmRsnCodeSrbUserKeyTkn

Meaning: The caller is in SRB mode, while the token was obtained in a user key (8-F).

Action: Avoid requesting this function in SRB mode for tokens associated with user key.

8xxxx080AEquate Symbol: IwmRsnCodeTcbNotOwnerUserKeyTkn

Meaning: Current TCB is not the owner, while the token was obtained in a user key (8-F).

Action: Avoid requesting this function under a TCB other than the owner for a token associated with user key.

8xxxx080BEquate Symbol: IwmRsnCodeBadPl

Meaning: Error accessing parameter list.

Action: Check for possible storage overlay. Also check if you call this macro in 64-bit address mode. Refer to the description of xxxx089E for further information.

8xxxx0810Equate Symbol: IwmRsnCodeEutFrr

Meaning: The caller has EUT FRR established.

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

8xxxx0823Equate Symbol: IwmRsnCodeDatoff

Meaning: The caller invoked the service while DATOFF

Action: Avoid requesting this function in this environment.

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: Caller invoked service but was not DAT on Primary ASC mode.

Action: Avoid requesting this function in this environment.

8xxxx0826Equate Symbol: IwmRsnCodeTaskTerm

Meaning: The caller invoked the service while task termination is in progress for the TCB associated with the owner.

Action: Avoid requesting this function in this environment.

8xxxx0827Equate Symbol: IwmRsnCodeRsvdNot0

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

Action: Check for possible storage overlay of the parameter list.

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

Meaning: Version number in parameter list is not valid.

Action: Check for possible storage overlay of the parameter list.

8xxxx082FEquate Symbol: IwmRsnCodeWrongHome

Meaning: The caller invoked the service from the wrong home address space.

Action: Invoke the function with the correct home address space.

8xxxx0841Equate Symbol: IwmRsnCodeXMemMode

Meaning: Caller is in cross-memory mode.

Action: Invoke the function in non-cross memory mode.

8xxxx084DEquate Symbol: IwmRsnCodeNotAuthConnect

Meaning: The caller must be supervisor state or have PSW key mask 0-7 authority to disconnect from the requested WLM services.

Action: Avoid requesting this function in this environment.

8xxxx089EEquate Symbol: IwmRsnCodeServiceAModeMismatch

Meaning: The caller is in 64-bit address mode and tried to invoke a service macro that is only enabled for a 31-bit environment.

Action: Use the 64-bit enabled service macro (IWM4DIS) or change the address mode of the caller to 31-bit.

10Equate Symbol: IwmRetCodeCompError

Meaning: Component error.

Action: No action required. The function may be successful if invoked again.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014