IXC367I
THE SETXCF {START|STOP} REBUILD REQUEST FOR {STRUCTURE|COUPLING FACILITY} name WAS {ACCEPTED.|REJECTED:} reason

Explanation

An operator entered a SETXCF START/STOP REBUILD or a SETXCF START/STOP REBUILD,DUPLEX command to start or stop structure rebuild processing, but the command was not successful.

In the message text:

START
The request was to start structure rebuild processing.
STOP
The request was to stop structure rebuild processing.
STRUCTURE
The request was for a structure.
COUPLING FACILITY
The request was for a coupling facility.
name
The name of the structure or coupling facility.
ACCEPTED.
The request was accepted.
REJECTED:
The request was rejected.
reason
One of the following:
STRUCTURE NOT DEFINED IN THE CFRM ACTIVE POLICY
The structure is not defined in the CFRM active policy and therefore is not allocated in any coupling facility.
STRUCTURE NOT ALLOCATED
The structure is not allocated in any coupling facility.
REBUILD HAS ALREADY BEEN INITIATED FOR THE STRUCTURE
The structure rebuild process is already in progress for the structure. Use the DISPLAY XCF,STR command to determine the type (rebuild or duplexing rebuild) and method (user-managed or system-managed) of the structure rebuild process.
REBUILD STOP HAS ALREADY BEEN INITIATED FOR THE STRUCTURE
Stop has already been initiated for the structure rebuild processing.
AT LEAST ONE ACTIVE CONNECTION INDICATED THAT REBUILD IS NOT ALLOWED
Rebuild not permitted because IXLCONN with ALLOWREBLD=NO was specified by at least one active connection.
COUPLE DATA SET FOR CFRM NOT AVAILABLE
The couple data set for CFRM is not available to this system.
NO ACTIVE CONNECTIONS TO THE STRUCTURE
The rebuild request would have resulted in a user-managed rebuild, but the structure has no active connectors to participate in rebuild.
REBUILD STOP IS IN PROGRESS FOR THE STRUCTURE
Rebuild stop is in progress for the structure.
STRUCTURE NOT IN REBUILD PROCESS
The structure is not in the rebuild process.
CLEANUP HAS BEGUN, REBUILD CANNOT BE STOPPED NOW
Rebuild has entered the cleanup phase. Rebuild cannot be stopped now.
XES FUNCTION NOT AVAILABLE
XES functions are not available. This can be because the hardware necessary to provide XES functions is not present.
AN UNEXPECTED ERROR OCCURRED
An unexpected error occurred during rebuild processing.
NO ELIGIBLE STRUCTURES FOUND IN COUPLING FACILITY
On a rebuild start request, no structures eligible for rebuild were found in the coupling facility specified. On a rebuild stop request, no structures eligible for rebuild stop were found in the coupling facility specified.
COUPLING FACILITY NOT DEFINED IN THE CFRM ACTIVE POLICY
The coupling facility is not defined in the CFRM active policy.
NO COUPLING FACILITY PROVIDED BETTER CONNECTIVITY
No other facility has better connectivity than the current one. The rebuild, which was initiated due to a loss of connectivity, would cause a further degradation in connectivity if accepted. The system evaluated the set of active connections that lost connectivity to the current structure as compared with the set of active connections which would not be able to connect to the rebuild new structure. The system terminates structure rebuild processing because the result of the rebuild would cause additional active connections to lose connectivity.
NO COUPLING FACILITY PROVIDED BETTER OR EQUIVALENT CONNECTIVITY
No other facility has better connectivity than the current one. The rebuild would cause a degradation in connectivity as determined by SFM system weights, if accepted.
Note: When this reason is received for an operator initiated rebuild by STRNAME or CFNAME and the installation needs to rebuild the structures. You can use a SETXCF START,REBUILD command that specifies LESSCONN=CONTINUE to force the rebuild to continue despite this condition. Because this might cause active connections to the structure to lose connectivity to the structure, do not use LESSCONN=CONTINUE unless you understand the impact to the application or subsystem. Consult the application or subsystem documentation for recommendations.
Start of changeA POPULATECF REBUILD OR REALLOCATE PROCESS IS ALREADY IN PROGRESSEnd of change
An attempt to start a POPULATECF rebuild was rejected for one of the following reasons:
  • A POPULATECF rebuild is in progress.
  • A REALLOCATE process is in progress or stopping.

Only one POPULATECF rebuild or REALLOCATE process is supported at a time. Use DISPLAY XCF,STR,STATUS=ALLOCATED to identify the process.

NO STRUCTURES SELECTED FOR THE POPULATECF REQUEST
On a POPULATECF rebuild start request, no structures eligible for rebuild were found to participate in the POPULATECF request. Refer to message IXC540I which lists the structures with a reason for not being selected for a rebuild.
NO POPULATECF REBUILD IS IN PROGRESS
An attempt to stop a POPULATECF rebuild was rejected for one of the following reasons:
  • No POPULATECF rebuild for the specified coupling facility is in progress.
  • A REALLOCATE process is in progress or stopping. The in progress REALLOCATE process can be stopped with the SETXCF STOP,REALLOCATE command. Use DISPLAY XCF,STR,STATUS=ALLOCATED to identify the structure(s) in the REALLOCATE process.
COUPLING FACILITY HAS FAILED
An attempt to start a POPULATECF rebuild was rejected since the specified coupling facility has failed. The specified coupling facility must be repaired before it can be used for allocating structures.
COUPLING FACILITY IS IN CLEANUP
An attempt to start a POPULATECF rebuild was rejected since the specified coupling facility is in cleanup processing. When cleanup processing has completed, the specified coupling facility can be used for allocating structures.
COUPLING FACILITY IS BEING REMOVED
An attempt to start a POPULATECF rebuild was rejected since the specified coupling facility is being removed from the active policy.
Start of changeCOUPLING FACILITY IS IN MAINTENANCE MODEEnd of change
Start of changeAn attempt to start a POPULATECF rebuild was rejected since the specified coupling facility is in maintenance mode.End of change
Start of changeCOUPLING FACILITY STRUCTURE ALLOCATION NOT PERMITTEDEnd of change
Start of changeAn attempt to start a POPULATECF rebuild was rejected. Structure allocation is prevented in the specified coupling facility.End of change
DUPLEXING REBUILD NOT ALLOWED FOR THE STRUCTURE
The structure does not support duplexing rebuild for one of the following reasons:
  • DUPLEX(DISABLED) was specified or defaulted to in the CFRM active policy for the structure.
  • There are failed persistent connections that are unavailable until a larger CFRM couple data set is made available.
  • A user-managed duplexing rebuild could not be started because:
    • User-managed duplexing rebuilds are not supported for the structure type.
    • At least one active or failed-persistent connection specified or defaulted to IXLCONN ALLOWDUPREBLD=NO.
  • A system-managed duplexing rebuild could not be started because:
    • The structure has at least one active connector, and none of the connectors (active or failed-persistent) specified IXLCONN ALLOWAUTO=YES when connecting.
    • A system-managed duplexing rebuild is not supported when a CFRM policy change is pending for the structure.
TYPE OF STOP REQUEST DOES NOT MATCH TYPE OF REBUILD IN PROGRESS
Either SETXCF STOP,REBUILD was requested to stop a duplexing rebuild or SETXCF STOP,REBUILD,DUPLEX was requested to stop a non-duplexing rebuild. The SETXCF STOP,REBUILD command must be used to stop non-duplexing rebuilds and the SETXCF STOP,REBUILD,DUPLEX command must be used to stop duplexing rebuilds.
DUPLEXING NOT ESTABLISHED, CANNOT STOP TO KEEP NEW STRUCTURE
SETXCF STOP,REBUILD,DUPLEX,KEEP=NEW was requested and the rebuild has not yet entered the duplex established phase. Stop requests to switch to the new structure are not excepted until the rebuild enters the duplex established phase.
STRUCTURE HAS FAILED.
The rebuild start request was rejected for one of the following reasons:
  • SETXCF START,REBUILD,DUPLEX was requested and the structure has failed. Duplexing rebuild is not allowed when the structure is in the failed state.
  • The rebuild start request would result in a system-managed rebuild. System-managed rebuild is not allowed when the structure is in the failed state.
NO OTHER COUPLING FACILITY FOUND IN PREFERENCE LIST.
SETXCF START,REBUILD was requested and LOCATION=OTHER was either specified on the rebuild request or defaulted to for STARTREASON=LOSSCONN or for a request to start a duplexing rebuild. In addition to avoiding the facility in which the structure is currently allocated, when a duplexing rebuild is stopped by the operator and DUPLEX(ENABLED) is specified in the active policy, the subsequent duplexing request initiated due to DUPLEX(ENABLED) will avoid the coupling facility in which the previous instance of the structure was allocated when the duplexing rebuild was stopped.
ALREADY STOPPING IN THE OTHER DIRECTION
The IXLREBLD STOP DUPLEX request was not processed because duplex rebuild stop has already been initiated for this structure name in the other direction. Either KEEP=OLD was requested and KEEP=NEW type of duplex rebuild stop is in progress or KEEP=NEW was requested and KEEP=OLD type of duplex rebuild stop is in progress.
STRUCTURE DOES NOT SUPPORT SYSTEM-MANAGED PROCESSES
The structure does not support system-managed processes (for example, rebuild) for one of the following reasons:
  • The structure was not allocated in a coupling facility at or above the minimum CFLEVEL required for the current process by a system supporting system-managed processing.
  • The structure has connections that have not been reconciled into the CFRM active policy.
  • Structure cleanup is in progress for the structure.
CONNECTORS DO NOT SUPPORT SYSTEM-MANAGED PROCESSES
The requested system-managed process cannot be initiated for one of the following reasons:
  • The structure has at least one active connector, and at least one of the connectors (active or failed-persistent) did not specify IXLCONN ALLOWAUTO=YES when connecting.
  • A duplexing rebuild cannot be initiated for a structure that has only failed-persistent connectors, and at least one of the failed-persistent connectors did not specify IXLCONN ALLOWAUTO=YES when connecting.
NO SUITABLE COUPLING FACILITY IN PREFERENCE LIST
The requested system-managed process cannot be initiated for one or more of the following reasons:
  • The preference list is empty.
  • The preference list contains no other coupling facility at or above the minimum CFLEVEL required for the current process.
  • The structure already exists in the only suitable coupling facility. The same coupling facility can only be selected as the target for the system-managed process if a CFRM policy change is pending for the structure and one of the following is true:
    • The policy change does not affect the SIZE or INITSIZE parameters.
    • The policy change affects the SIZE or the INITSIZE parameter and all of the structure connectors specified IXLCONN ALLOWALTER=YES.
  • A potentially suitable coupling facility does not permit structure allocation.
AT LEAST ONE CONNECTOR HAS LOST CONNECTIVITY TO THE STRUCTURE
The requested system-managed process (for example, rebuild) cannot be initiated because one or more of the connectors has lost connectivity to the target structure.
CFRM COUPLE DATA SET DOES NOT SUPPORT SYSTEM-MANAGED PROCESS
The CFRM couple data set does not support the requested system-managed process (for example, rebuild), because the CFRM couple data set was not formatted at or above the minimum version for the system-managed process requested. Use the DISPLAY XCF,COUPLE,TYPE=CFRM command to determine the format of the CFRM couple data set. To support system-managed rebuild, the CFRM couple data set should be formatted specifying “ITEM NAME(SMREBLD) NUMBER(1)”. For system-managed duplexing rebuild, “ITEM NAME(SMDUPLEX) NUMBER(1)” should also be specified when formatting a CFRM couple data set. Specifying “ITEM NAME(SMDUPLEX) NUMBER(1)” implicitly formats a CFRM couple data set that supports both system-managed rebuild and system-managed duplexing rebuild.
STRUCTURE WITH NO CONNECTORS HAS NEVER BEEN SYSTEM-MANAGED DUPLEXED
A system-managed duplexing rebuild cannot be initiated because there are no connections to the structure and the structure has not previously been duplexed using system-managed processing.
ALLOCATION OF REBUILD NEW STRUCTURE FOR DUPLEXING REBUILD NOT FEASIBLE
Allocation of the rebuild new structure instance in support of a duplexing rebuild is not feasible. Message IXC574I contains additional diagnostic information.
Start of changeSTRUCTURE OBJECTS IN STORAGE-CLASS MEMORYEnd of change
Start of changeThe duplexing rebuild could not be started because structure objects are currently residing in storage-class memory.End of change

System action

The system ignores the command.

Operator response

Use the DISPLAY XCF command with the STRUCTURE or CF options to verify the name and state of the structure to be rebuilt. If the reason for refusing the rebuild is a perceived degradation in connectivity and this is acceptable, issue a SETXCF START,REBUILD command specifying LESSCONN=CONTINUE. LESSCONN=CONTINUE can be used to initiate a rebuild that will force the rebuild to continue despite this condition. Because this action might cause active connections to the structure to lose connectivity to the structure, do not use LESSCONN=CONTINUE unless you understand the impact on the application or subsystem. Some connectors will stop the rebuild if a loss of connectivity is observed but most will disconnect from the structure to allow the rebuild to complete. Depending on the exploiter, disconnecting from the structure is likely to result in losing the exploiter's sysplex-related functionality on that system (for example, loss of data sharing capability) and for critical system exploiters. This might result in a system wait state. Before proceeding with this action, consult the documentation for the exploiting application or subsystem.

System programmer response

Not applicable.

Source

Cross System Coupling Facility (SCXCF)

Module

IXCO1SCP

Routing code

#

Descriptor code

5