z/OS MVS Programming: Sysplex Services Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Return and Reason Codes

z/OS MVS Programming: Sysplex Services Reference
SA38-0658-00

When the IXCSRVR 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 a reason code.

The following table identifies the hexadecimal return and reason codes and the equate symbol associated with each reason code.

Table 1. Return and Reason Codes for the IXCSRVR Macro

Hexadecimal
Return Code

Hexadecimal
Reason Code

Equate Symbol
Meaning and Action

0 None Successful completion.

For a START request, the server exit routine set the "stop code" to indicate that it had finished processing (ixcysrvr_kStopCodeFinished). For a STOP request, stop processing for the indicated server was initiated.

4 01 Equate Symbol: IXCSRVRRSNSTOPPED

Meaning: The XCF Server Stub loop terminated because the server was stopped through an IXCSRVR REQTYPE=STOP request. The server exit routine was not involved in the stop and so did not have an opportunity to set the stop code.

This reason applies only to REQTYPE=START.

Action: None.

4 02 Equate Symbol: IXCSRVRRSNEXITFAILURE

Meaning: Environmental error The server exit routine set the "stop code" to indicate that it was terminating due to a failure (ixcysrvr_kStopCodeFailure.

This reason applies only to REQTYPE=START.

Action: None.

4 04 Equate Symbol: IXCSRVRRSNNOSERVER

Meaning: Environmental error. The server does not have any instances defined on the local system. Nothing to stop.

Action: None.

8 01 Equate Symbol: IXCSRVRRSNPLISTBADSTG

Meaning: Environmental error. Program error. The storage containing the parameter list is not accessible.

Action: Correct the storage error, and retry.

8 02 Equate Symbol: IXCSRVRRSNPLISTBADALET

Meaning: Environmental error. Program error. The parameter list ALET is not valid.

Action: The storage containing the IXCSRVR parameter list must reside in the primary address space of the caller, or in a space addressable through a public entry on the dispatchable unit access list (DU-AL), or in a common area data.

8 03 Equate Symbol: IXCSRVRRSNPLISTBADRSVD

Meaning: Environmental error. Reserved field in the parameter list is not zero.

Action: Either the parameter list was corrupted, or the program is running on a system that does not have the necessary support.

8 04 Equate Symbol: IXCSRVRRSNPLISTBADVERSION

Meaning: Environmental error. Program error. Parameter list version is not valid.

Action: Either the parameter list was corrupted or the program is running on a system that does not have the necessary support.

8 05 Equate Symbol: IXCSRVRRSNPLISTBADREQTYPE

Meaning: Environmental error. Program error.

Action: Parameter list request type is not valid. Either the parameter list was corrupted or the program is running on a system that does not have the necessary support.

8 06 Equate Symbol: IXCSRVRRSNEXITFAILED

Meaning: Environmental error. Program error. The server exit routine failed. XCF stops the offending server instance.

Action: Note that this particular reason code will not normally be seen. If the server exit routine fails, XCF recovery processing will stop the server instance, cleanup XCF resources, and then percolate to the recovery routine established by the work unit that started the server.

8 07 Equate Symbol: IXCSRVRRSNSERVERBADSTG

Meaning: Environmental error. The storage containing the server name is not accessible.

Action: None.

8 08 Equate Symbol: IXCSRVRRSNSERVERBADALET

Meaning: Invalid parameters. The ALET for the server name is not valid. The storage containing the server name must reside in the primary address space of the caller, or in a space addressable through a public entry on the dispatchable unit access list (DU-AL), or in a common area data space.

Action: Ensure that the ALET for the server name is valid.

8 09 Equate Symbol: IXCSRVRRSNSERVERBADNAME

Meaning: Environmental error. Program error. The server name is not valid.

Action: Specify a valid server name.

8 0A Equate Symbol: IXCSRVRRSNDESCBADSTG

Meaning: Environmental error. The storage containing the server description is not accessible.

Action: None.

8 0B Equate Symbol: IXCSRVRRSNDESCBADALET

Meaning: Environmental error. The ALET for the server description is not valid. The storage containing the server description must reside in the primary address space of the caller, or in a space addressable through a public entry on the dispatchable unit access list (DU-AL), or in a common area data space.

Action: Ensure that the ALET for the server description is valid.

8 0C Equate Symbol: IXCSRVRRSNDESCBADDESC

Meaning: Invalid parameters. The server description is not valid.

Action: Specify a valid description for the server.

8 0D Equate Symbol: IXCSRVRRSNINFOBADSTG

Meaning: Environmental error. The storage containing the server info is not accessible.

Action: None.

8 0E Equate Symbol: IXCSRVRRSNINFOBADALET

Meaning: Environmental error. Program error. The ALET for the server info is not valid. The storage containing the server description must reside in the primary address space of the caller, or in a space addressable through a public entry on the dispatchable unit access list (DU-AL), or in a common area data space.

Action: Specfiy a valid ALET for the server description information.

8 0F Equate Symbol: IXCSRVRRSNFEATURESBADLEVEL

Meaning: Environmental error. Program error. The content of FEATURES is not valid because the sf_level field specified a value that is reserved by XCF.

Action: None.

8 10 Equate Symbol: IXCSRVRRSNLEVELBADMAX

Meaning: Invalid parameters. Program error. The value of MAXLEVEL must be greater than or equal to the value of MINLEVEL.

Action: Specify a correct value for MAXLEVEL.

8 11 Equate Symbol: IXCSRVRRSNCLIENTBADMAX

Meaning: Environmental error. Program error. The value of MAXCLIENT must be greater than or equal to the value of MINCLIENT.

Action: Specify a correct value for MAXCLIENT.

8 12 Equate Symbol: IXCSRVRRSNFDIBADVALUE

Meaning: Environmental error. Program error. The parameter list FDI value is not valid.

Action: FDI must be an integer value in the range 1 and 3600.

8 13 Equate Symbol: IXCSRVRRSNRESPBINDBADVALUE

Meaning: Environmental error. Program error. The parameter list RESPBIND value is not valid

Action: Specify a valid RESPBIND option.

8 14 Equate Symbol: IXCSRVRRSNSERVERIDBADVALUE

Meaning: Environmental error. Program error. The SERVERID is not valid.

Action: specify a valid server id.

8 15 Equate Symbol: IXCSRVRRSNSERVERIDBADSYSTEM

Meaning: Environmental error. Program error. The SERVERID is not valid for use on the local system. For example, the server designated by the SERVERID appears to reside on some other system in the sysplex.

Action: Correct the server id for the local system.

8 16 Equate Symbol: IXCSRVRRSNDDTBADSTG

Meaning: Environmental error. Program error. The data descriptor table returned to XCF through the work area descriptor in the Server Exit Parameter List (SXPL_WAD.WAD_DataDesc.dd_DataAddr) was not accessible. As a consequence, XCF stops running the server.

Action: None.

8 17 Equate Symbol: IXCSRVRRSNDDTBADALET

Meaning: Environmental error. Program error. The ALET of a data descriptor table returned to XCF through the work area descriptor in the Server Exit Parameter List (SXPL_WAD.WAD_DataDesc.dd_DataAlet) was not valid. As a consequence, XCF stops running the server. The storage containing the data descriptor table must be in the primary address space of the server, or in a space addressable through a public entry on the dispatchable unit access list (DU-AL), or in a common area data space.

Action: Correct the ALET for the data descriptor table.

8 1A Equate Symbol: IXCSRVRRSNWORKAREABADSTG

Meaning: Environmental error. Program error. The work area provided by the server exit routine is not accessible. As a consequence, XCF stops running the server.

Action: None.

8 1B Equate Symbol: IXCSRVRRSNWORKAREABADALET

Meaning: Environmental error. Program error. The ALET for the work area provided by the server exit routine is not valid. As a consequence, XCF stops running the server. The storage containing the work area must be in the primary address space of the server, or in a space addressable through a public entry on the dispatchable unit access list (DU-AL), or in a common area data space.

Action: Correct the ALET for the work area.

8 1C Equate Symbol: IXCSRVRRSNMODEBADVALUE

Meaning: Environmental error. Program error. The parameter list MODE specification is not valid.

Action: Correct the MODE specification for the parameter list.

8 1D Equate Symbol: IXCSRVRRSNSERVERIDBADSTG

Meaning: Environmental error. Program error. The storage containing the SERVERID is not accessible.

Action: None.

8 1E Equate Symbol: IXCSRVRRSNSERVERIDBADALET

Meaning: Environmental error. Program error. The ALET for the SERVERID is not valid. The storage containing the SERVERID must reside in the primary address space of the caller, or in a space addressable through a public entry on the dispatchable unit access list (DU-AL), or in a common area data space.

Action: Correct the ALET for the server id.

8 1F Equate Symbol: IXCSRVRRSNSCOPEBADVALUE

Meaning: Environmental error. Program error. The parameter list SCOPE specification is not valid.

Action: Correct the SCOPE specification for the parameter list.

8 20 Equate Symbol: IXCSRVRRSN#SERVERSBADVALUE

Meaning: Environmental error. Program error. The number of servers is not valid.

Action: The value must be non-zero

8 21 Equate Symbol: IXCSRVRRSNXCFSERVER

Meaning: Environmental error. Program error. Only XCF itself is allowed to start and stop an XCF Server.

Action: None.

8 22 Equate Symbol: IXCSRVRRSNSXPLRSVD

Meaning: Environmental error. Program error. The server exit routine overlaid reserved fields in the Server Exit Parameter List (SXPL). XCF stopped the offending server instance

Action: None.

8 23 Equate Symbol: IXCSRVRRSNSXPLWADRSVD

Meaning: Environmental error. Program error. The server exit routine overlaid reserved fields in the Work Area Descriptor (SXPL_WAD) within the Server Exit Parameter List (SXPL). XCF stopped the offending server instance.

Action: None.

8 24 Equate Symbol: IXCSRVRRSNSXPLRESPBIND

Meaning: Environmental error. Program error. The server exit routine stored an invalid response bind value in the SXPL_RespBind field within the Server Exit Parameter List (SXPL). XCF stopped the offending server instance.

Action: None.

8 25 Equate Symbol: IXCSRVRRSNSXPLREFUSALCODE

Meaning: Environmental error. Program error. The server exit routine stored a nonzero refusal code in the SXPL_RefusalCode field within the Server Exit Parameter List (SXPL). The refusal code is not valid for use when processing an initialization request (SXPL_ServerCode = ixcysrvr_kSC_InitServer). XCF stopped the offending server instance.

Action: None.

8 26 Equate Symbol: IXCSRVRRSNSXPLSTOPCODE

Meaning: Environmental error. Program error. The server exit routine stored an invalid stop code in the SXPL_StopCode field within the Server Exit Parameter List (SXPL). XCF stopped the offending server instance.

Action: None.

8 27 Equate Symbol: IXCSRVRRSNSXPLRESULTCODE

Meaning: Environmental error. Program error. The server exit routine stored a nonzero result code in the SXPL_ResultCode field within the Server Exit Parameter List (SXPL). The result code is not valid for use when processing an initialization request (SXPL_ServerCode = ixcysrvr_kSC_InitServer) nor when processing a get work area request (SXPL_ServerCode = ixcysrvr_kSC_GetWorkArea). XCF stopped the offending server instance.

Action: None.

8 28 Equate Symbol: IXCSRVRRSNSXPLMIXEDRESULT

Meaning: Environmental error. Program error. The server exit routine stored a nonzero value in both the SXPL_ResultCode field and the SXPL_RefusalCode field within the Server Exit Parameter List (SXPL). Thus XCF cannot determine whether the request was accepted or whether it was refused. The relevant request is acknowledged with a response code indicating that the server exit failed while processing the request. XCF stopped the offending server instance.

Action: None.

8 57 Equate Symbol: IXCSRVRRSNHASFRR

Meaning: Environmental error. Program error. Caller is running with an FRR established.

Action: Ensure that macro is invoked while program is running in the required environment. This reason applies only to REQTYPE=START requests.

8 76 Equate Symbol: IXCSRVRRSNLOCKED

Meaning: Environmental error. Program error. Caller holds locks. Ensure that macro is invoked while program is running in the required environment.

Action: Retry.

8 8A Equate Symbol: IXCSRVRRSNBADASCMODE

Meaning: Environmental error. Program error. Caller is running neither in primary ASC mode nor in AR ASC mode.

Action: Ensure that macro is invoked while program is running in the required environment.

8 A4 Equate Symbol: IXCSRVRRSNREQTYPECONFLICT

Meaning: Environmental error. Program error. The request type in the parameter list is not consistent with the request type in register 0 on entry to the service routine. The parameter list or the register contents were corrupted before the service routine received control.

Action: None.

8 118 Equate Symbol: IXCSRVRRSNNOTTASKMODE

Meaning: Environmental error. Program error. Caller is not running in task mode.

Action: Ensure that macro is invoked while program is running in the required environment. This reason applies only to REQTYPE=START requests.

8 11C Equate Symbol: IXCSRVRRSNNOTENABLED

Meaning: Environmental error. Program error. Caller is not running enabled.

Action: Ensure that macro is invoked while program is running in the required environment.

8 120 Equate Symbol: IXCSRVRRSNXMEM

Meaning: Caller is running cross-memory mode.

Action: Ensure that macro is invoked while program is running in the required environment. This reason applies only to REQTYPE=START requests.

8 127 Equate Symbol: IXCSRVRRSNONLYONE

Meaning: Environmental error. Program error. Current® task is already instantiated as a server.

Action: At most one server can be instantiated under any given task.

8 128 Equate Symbol: IXCSRVRRSNTASKTERM

Meaning: Environmental error. Program error. Current task is ending.

Action: A server cannot be started once task termination begins.

8 129 Equate Symbol: IXCSRVRRSNRESMGR

Meaning: Environmental error. Program error. The caller is a resource manager.

Action: A server cannot be started by an (address space) resource manager.

C 0CA1 Equate Symbol: IXCSRVRRSNNOUSERSTORAGE

Meaning: Environmental error. Unable to obtain user storage needed to process the request.

Action: None.

C 0CA2 Equate Symbol: IXCSRVRRSNNOXCFSTORAGE

Meaning: Environmental error. Unable to obtain XCF storage needed to process the request.

Action: None.

C 0CA3 Equate Symbol: IXCSRVRRSNMAXSERVERS

Meaning: Environmental error. Unable to define new server. Maximum number of servers already defined.

Action: None.

C 0CA4 Equate Symbol: IXCSRVRRSNNOSYSRESOURCES

Meaning: Environmental error. Unable to obtain the system resources needed to process the request.

Action: None.

10 None Equate Symbol: None.

Meaning: Failure in XCF processing.

Action:

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014