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 IXLALTER 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, if applicable, GPR 0 (and rsncode, if you coded RSNCODE) contains a reason code.
The IXLYCON macro provides equate symbols for the return and reason codes. The equate symbols associated with each hexadecimal return code are as follows:
0
IXLRETCODEOK
4
IXLRETCODEWARNING
8
IXLRETCODEPARMERROR
C
IXLRETCODEENVERROR
10
IXLRETCODECOMPERROR

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 IXLALTER Macro
Hexadecimal Return Code Hexadecimal Reason Code

Equate Symbol
Meaning and Action

0 None. Meaning: IXLALTER request accepted.

Action: None.

4 xxxx0427 Equate Symbol: IXLRSNCODEALREADYALTERING

Meaning: The request was rejected because alter is already in progress for the structure. A new alter request will not be accepted until the current alter completes or is stopped.

Action: Either wait for the structure alter to complete or issue IXLALTER to stop the structure alter.

8 xxxx0801 Equate Symbol: IXLRSNCODEBADPARMLIST

Meaning: Program error. The IXLALTER parameter list is not accessible.

Action: Verify that:
  • The parameter list address is uncorrupted
  • The parameter list is addressable in the caller's primary address space.
  • If you are calling IXLALTER in AR-mode and you specified the parameter list address using explicit register notation, the corresponding access register was updated appropriately.
  • If you are calling IXLALTER in AR-mode, SYSSTATE ASCENV=AR must be issued before the IXLALTER.
8 xxxx0802 Equate Symbol: IXLRSNCODEBADPARMLISTALET

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

Action: Verify that:
  • If you issued IXLALTER in AR-mode and you specified the parameter list address using explicit register notation, the corresponding access register was updated appropriately.
  • If you are calling IXLALTER in AR-mode, SYSSTATE ASCENV=AR must be issued before issuing the IXLALTER.
  • If you are not running in AR-mode, and the parameter list does not need to be ALET-qualified, the corresponding access register should contain zeros.
8 xxxx0804 Equate Symbol: IXLRSNCODEBADVERSION#

Meaning: Program error. The IXLALTER parameter list version number is not valid.

Action:
  • Verify that your program did not overlay the parameter list storage.
  • Verify that your program was assembled with the correct macro library for the release of MVS™ on which your program is running.
8 xxxx0806 Equate Symbol: IXLRSNCODESRBMODE

Meaning: Program error. The requestor is in SRB mode.

Action: Change into task mode before issuing IXLALTER.

8 xxxx0807 Equate Symbol: IXLRSNCODENOTENABLED

Meaning: Program error. The requestor is not in an enabled state.

Action: The requestor must be enabled for I/O and external interrupts.

8 xxxx0809 Equate Symbol: IXLRSNCODEPRIMARYNOTHOME

Meaning: Program error. The requestor's primary address space is not the same as the home address space.

Action: The primary address space must equal the home address space to issue the IXLALTER.

8 xxxx0824 Equate Symbol: IXLRSNCODEWRONGSTRTYPE

Meaning: Program error. EMCSTGPCT cannot be altered on a cache or lock structure.

Action: EMCSTGPCT is meaningful only for a list structure.

8 xxxx084C Equate Symbol: IXLRSNCODENOSAFAUTH

Meaning: Program error. The requestor does not have proper SAF authorization.

Action: Have the installation set up the proper SAF authorization for access to the structure.

8 xxxx0883 Equate Symbol: IXLRSNCODEBADEMCSTGPCT

Meaning: Program error. The value specified for EMCSTGPCT is not valid. The value must be between 0 and 10000.

Action: Correct the value of EMCSTGPCT.

C xxxx0C05 Equate Symbol: IXLRSNCODESTRNOTINPOLICY

Meaning: Environmental error. The requested structure is not in the CFRM active policy.

Action: Specify a structure that is currently defined in the CFRM active policy or switch to a new CFRM policy that contains the structure for which this IXLALTER was invoked.

C xxxx0C0A Equate Symbol: IXLRSNCODESTRNOTALLOCATED

Meaning: Environmental error. The requested structure is not allocated.

Action: Ensure that you have specified the correct structure name on the IXLALTER request. If so, allocate the structure by issuing the appropriate IXLCONN request.

C xxxx0C25 Equate Symbol: IXLRSNCODESTRFAILURE

Meaning: Environmental error. Structure failure has occurred.

Action: None.

C xxxx0C29 Equate Symbol: IXLRSNCODEXESNOTACTIVE

Meaning: Environmental error. The CFRM function is not active or not available.

Action: Bring the CFRM couple data set into use in the sysplex by issuing the SETXCF COUPLE,TYPE=CFRM,PCOUPLE= command.

C xxxx0C36 Equate Symbol: IXLRSNCODESTOPINPROGRESS

Meaning: Environmental error. Request rejected because structure rebuild stop was in progress for the structure.

Action: Wait to initiate structure alter until the structure rebuild stop process completes.

C xxxx0C51 Equate Symbol: IXLRSNCODEREBUILDINPROGRESS

Meaning: Environmental error. Request rejected because structure rebuild was in progress for the structure.

Action: Wait to initiate structure alter until the structure rebuild process completes or stop the rebuild process.

C xxxx0C60 Equate Symbol: IXLRSNCODENOALTERCF

Meaning: Environmental error. Request rejected because the structure is allocated in a coupling facility that does not support alter. CFLEVEL is equal to zero.

Action: Reallocate the structure in a coupling facility with CFLEVEL=1 or higher.

C xxxx0C61 Equate Symbol: IXLRSNCODEALLOWALTER

Meaning: Environmental error. Request rejected because at least one active, disconnecting, failing, or failed-persistent connection specified ALLOWALTER=NO on IXLCONN.

Action: Use IXCQUERY to determine the set of connections that do not support structure alter for the structure. When those connections are no longer connected to the structure, retry the IXLALTER request.

If a connector to the structure is failed-persistent, consider the use of IXLFORCE to delete the connection. Be aware that such an action might result in the loss of persistent information.

C xxxx0C62 Equate Symbol: IXLRSNCODEALTERRATIOCHG

Meaning: Environmental error. Request rejected because at least one active, failing, or failed-persistent connection specified RATIO=NO on IXLCONN.

Action: Use IXCQUERY to determine the set of connections that specified RATIO=NO for the structure. When those connections are no longer connected to the structure, retry the IXLALTER request.

If a connector to the structure is failed-persistent, consider the use of IXLFORCE to delete the connection. Be aware that such an action might result in the loss of persistent information.

C xxxx0C63 Equate Symbol: IXLRSNCODEALTERNOTINPROG

Meaning: Environmental error. Request rejected because structure alter stop was requested and structure alter is not in progress for the structure.

Action: None.

C xxxx0C66 Equate Symbol: IXLRSNCODEALTERSTOPINPROG

Meaning: Environmental error. Request rejected because alter stop was requested and an alter stop is already in progress.

Action: None.

C xxxx0C6E Equate Symbol: IXLRSNCODEALTERNOTPERMITTED

Meaning: CF structure alter is not|permitted to start. This restriction might be the result of a SETXCF MODIFY ALTER=DISABLED command. A structure-specific ENF35 is to be issued when alter is permitted.

Action: Retry the IXLALTER request when a structure-specific ENF35 is issued.

C xxxx0C76 Equate Symbol: IXLRSNCODEDUPALTER

Meaning: Environmental error. An IXLALTER request was rejected because alter stop was requested and a stop of an alter for a structure in a system-managed duplexing rebuild is not allowed.

Action: None.

Start of change C End of change Start of change xxxx0CA2 End of change Start of changeEquate Symbol: IXLRSNCODESTORAGECLASSMEMORYINUSE

Meaning: Environmental error. Request rejected because the structure has objects in storage-class memory.

Action: Repeat the alter request when all storage objects are migrated back into coupling facility real storage.

End of change
C FFFFFFFF Equate Symbol: IXLRSNCODENOTAVAILABLE

Meaning: Environmental error. There are no coupling facility services available. The hardware support necessary to provide coupling facility services might not be present.

Action: Re-IPL the system, or follow your particular failure management protocol.

10 Meaning: XES processing has failed.

Action: Save the reason code information and contact the IBM® support center.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014