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 IWM4CON 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 66. Return and Reason Codes for the IWM4CON 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.

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 requested in 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.

8xxxx080BEquate Symbol: IwmRsnCodeBadPl

Meaning: Error accessing parameter list.

Action: Check for possible storage overlay.

8xxxx0810Equate Symbol: IwmRsnCodeEutFrr

Meaning: The caller has EUT FRR established.

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

8xxxx0812Equate Symbol: IwmRsnCodeBadAscb

Meaning: Bad ASCB address passed.

Action: Check for possible storage overlay.

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: The caller invoked the 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.

8xxxx0829Equate Symbol: IwmRsnCodeBadOptions

Meaning: Parameter list omits required parameters or supplies mutually exclusive parameters or provides data associated with options not selected.

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

8xxxx082CEquate Symbol: IwmRsnCodeBadNumberAscb

Meaning: NUMBERASCB variable is not a positive value.

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

8xxxx082EEquate Symbol: IwmRsnCodeConnectExists

Meaning: Connect has already been established for the current home address space.

Action: Avoid requesting this function when a connection already exists.

8xxxx0840Equate Symbol: IwmRsnCodeServiceNotEnabled

Meaning: Requested connection type cannot be established in the current execution environment. This occurs when SERVER_MANAGER=YES is specified and the program is run as a batch job in a WLM-managed job class.

Action: Run the program as a started task.

8xxxx0841Equate Symbol: IwmRsnCodeXMemMode

Meaning: The caller is in cross-memory mode.

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

8xxxx0847Equate Symbol: IwmRsnCodeOtherSpaceConnected

Meaning: Another address space with the same subsystem type and name is connected to WLM on the MVS™ image and has the role of queue manager or router.

Action: Avoid requesting this function with duplicate values.

8xxxx0849Equate Symbol: IwmRsnCodeWLMServBadAPPL

Meaning: The application environment name (APPLENV=) specified is not the same as the one used by WLM to start the server.

Action: Verify that the start parameters for the application environment are coded correctly in the WLM ISPF application, and that those parameters are used by the started JCL procedure.

8xxxx084AEquate Symbol: IwmRsnCodeWLMServBadSSN

Meaning: The subsystem name (SUBSYSNM=) specified is not the same as the one used by WLM to start the server.

Action: Verify that the start parameters for the application environment are coded correctly in the WLM ISPF application, and that those parameters are used by the started JCL procedure.

8xxxx084BEquate Symbol: IwmRsnCodeWLMServBadSST

Meaning: The subsystem type (SUBSYS=) specified is not the same as the one used by WLM to start the server.

Action: Verify that the start parameters for the application environment are coded correctly in the WLM ISPF application, and that those parameters are used by the started JCL procedure.

8xxxx084DEquate Symbol: IwmRsnCodeNotAuthConnect

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

Action: Avoid requesting this function in this environment.

8xxxx084EEquate Symbol: IwmRsnCodeWlmServBadType

Meaning: For WLM started servers, the SERVER_TYPE= is not the one used to start the server.

Action: Specify the correct SERVER_TYPE.

8xxxx0853Equate Symbol: IwmRsnCodeWlmQmBadType

Meaning: There is a queue manager or router environment of the specified subsystem name, but of a different type than that specified by the caller.

Action: Verify that the option for queue manager/router is specified correctly on IWM4CON. If the option is correct, then server address spaces for a different Server_Type exist and must terminate before the current space may connect as a queue manager or router.

8xxxx0855Equate Symbol: IwmRsnCodeBadNumEUMax

Meaning: PARALLEL_EU variable is greater than the maximum of 65534.

Action: Specify a value between 1 and 65534.

8xxxx0856Equate Symbol: IwmRsnCodeBadNumEUMin

Meaning: PARALLEL_EU is less than the minimum of 1.

Action: Specify a value between 1 and 65534.

8xxxx085CEquate Symbol: IwmRsnCodeWrongNumEU

Meaning: The caller invoked the service with a PARALLEL_EU value which is different from the PARALLEL_EU of existing servers in the application environment

Action: Ensure that all servers in the application environment specify the same PARALLEL_EU value.

Note:
If this reason code occurs after changes have been made to the application environment, refer to the section about "Making changes to the Application Environment Servers" in Chapter 13 "Defining Application Environments" in z/OS MVS Planning: Workload Management.
8xxxx0873Equate Symbol: IwmRsnCodeWrongSrvLmt

Meaning: The caller invoked the service with a SERVER_LIMIT parameter setting which is different from the SERVER_LIMIT of existing servers in the application environment.

Action: Ensure that all servers in the application environment specify the same SERVER_LIMIT value.

8xxxx0874Equate Symbol: IwmRsnCodeWrongMngTsk

Meaning: The caller invoked the service with a MANAGE_TASKS parameter setting which is different from the MANAGE_TASKS of existing servers in the application environment

Action: Ensure that all servers in the application environment specify the same MANAGE_TASKS value.

8xxxx0878Equate Symbol: IwmRsnCodeBadNumLimitMax

Meaning: The caller invoked the service with a SERVER_LIMIT parameter setting which exceeds the maximum number of tasks which can be started in a server address space. The current maximum value is 65534.

Action: Correct the number or do not specify SERVER_LIMIT parameter in order to use the default.

8xxxx0879Equate Symbol: IwmRsnCodeBadNumLimitMin

Meaning: The caller invoked the service with a SERVER_LIMIT parameter setting which is less than what has been defined on the PARALLEL_EU parameter.

Action: Ensure that SERVER_LIMIT is always greater or equal to PARALLEL_EU.

8xxxx087AEquate Symbol: IwmRsnCodeNoQServer

Meaning: The MANAGE_TASKS parameter is not allowed when QUEUE_SERVER=YES has been specified.

Action: Ensure to use the parameters correctly.

8xxxx088EEquate Symbol: IwmRsnCodeWlmServBadSSND

Meaning: For WLM started servers, the NODENM= is not the one used to start the server.

Action: Specify the correct NODENM.

8xxxx088FEquate Symbol: IwmRsnCodeApplNotSSN

Meaning: The application environment name is defined for use by a different subsystem node.

Action: Check whether the correct application environment name is being used.

CEquate Symbol: IwmRetCodeEnvError

Meaning: Environmental error.

Cxxxx0C01Equate Symbol: IwmRsnCodeNoStg

Meaning: Storage is not available for the request.

Action: There is a storage shortage. The function may work successfully at a later time.

Cxxxx0C09Equate Symbol: IwmRsnCodeNoResmgr

Meaning: Resource manager could not be established.

Action: No action required. This condition may be due to a storage shortage condition.

Cxxxx0C14Equate Symbol: IwmRsnCodeNoWorkShutDown

Meaning: No work selected. Caller is to shutdown.

Action: The server should shut down (terminate).

Cxxxx0C19Equate Symbol: IwmRsnCodeNotSecAuthConnect

Meaning: The caller is not authorized by SAF to connect to WLM with SERVER_MANAGER=YES.

Action: The security administrator must grant access to the appropriate resource.

Cxxxx0C1AEquate Symbol: IwmRsnCodeApplNotDefined

Meaning: The application environment name is not defined in the active WLM policy.

Action: Check whether the correct application environment name is being used. If so, a service administrator must define the application environment in the WLM service definition.

Cxxxx0C1BEquate Symbol: IwmRsnCodeApplNotSST

Meaning: The application environment name is defined for use by a different subsystem type in the active WLM policy.

Action: Check whether the correct application environment name is being used. If so, a service administrator must change the application environment in the WLM service definition to specify the correct subsystem type.

Cxxxx0C1FEquate Symbol: IwmRsnCodeServerExists

Meaning: A server exists for the specified application environment which only allows 1 such server in the sysplex.

Action: Check whether the correct application environment name is being used. If so and the current server is shutting down, a retry may be successful after a delay.

Cxxxx0C22Equate Symbol: IwmRsnCodeApplEnvQuiesced

Meaning: The specified application environment has been quiesced, server cannot be started for the request.

Action: Restart the application environment and then retry the request.

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