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 IWMTAFF 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 129. Return and Reason Codes for the IWMTAFF 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.

Action: None required.

4xxxx0439Equate Symbol: IwmRsnCodeNoAffinityFound

Meaning: The service has been invoked to tell WLM that an existing server region affinity has been terminated but WLM has no affinity defined for this server region.

Action: If region token was not specified make sure to use the service properly at the beginning and end of each affinity. If the region token has been defined make sure that it is used for the correct server region.

4xxxx043AEquate Symbol: IwmRsnCodeRegionNotFound

Meaning: The region token does not identify a valid server region.

Action: Please specify the correct region token.

8Equate Symbol: IwmRetCodeInvocError

Meaning: Invalid invocation environment or parameters.

8xxxx0801Equate Symbol: IwmRsnCodeSrbMode

Meaning: 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: Caller is locked.

Action: Avoid requesting this function while locked.

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 reason code xxxx089E for further information.

8xxxx0824Equate Symbol: IwmRsnCodeAmode24

Meaning: Caller invoked 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 in primary ASC mode.

Action: Avoid requesting this function in this environment.

8xxxx0828Equate Symbol: IwmRsnCodeBadVersion

Meaning: Version number in parameter list is not valid.

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

8xxxx0840Equate Symbol: IwmRsnCodeServiceNotEnabled

Meaning: Caller's space connection is not enabled for this service

Action: Make sure that SERVER_MANAGER=YES and SERVER_TYPE=QUEUE is specified on the IWMCONN request to enable this service.

8xxxx0841Equate Symbol: IwmRsnCodeXmemMode

Meaning: Caller is in cross-memory mode.

Action: Request this function only when you are not in cross-memory mode.

8xxxx0842Equate Symbol: IwmRsnCodeNoWLMConnect

Meaning: Caller's space is not connected to WLM.

Action: Invoke the IWMCONN macro before invoking this macro.

8xxxx084DEquate Symbol: IwmRsnCodeNotAuthConnect

Meaning: The caller must be supervisor state or have PSW key mask 0-7 authority to use the requested WLM service. This applies only if the caller provides a region token for a server address space for which it wants to set the affinity.

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 (IWM4TAF) or change the address mode of the caller to 31-bit.

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