A SETXCF START,REALLOCATE operator command was issued to start the REALLOCATE process. Once started, the REALLOCATE process will examine each allocated structure to determine the need for adjustment by either activating a pending policy change and/or changing the location of instance(s) allocated in CF(s). When the structure needs to be adjusted, messages associated with the structure rebuild process (IXC57nI and IXC52nI) and the deallocation process (IXC579I) will be issued.

When the structure is not adjusted, message IXC544I will be issued to provide an explanation.

In the message text:

strname

Name of the structure for which information is recorded.

WAS NOT ATTEMPTED BECAUSE

The REALLOCATE process did not process the name structure for the specified reason.

reason

One of the following:

AN UNEXPECTED ERROR OCCURRED

The REALLOCATE process cannot be performed because an unexpected error occurred.

STRUCTURE IS ALLOCATED IN PREFERRED CF

The structure is allocated in preferred CF.

OF A PENDING POLICY CHANGE TO DELETE THE STRUCTURE DEFINITION

There is an administrative policy change pending. The pending policy change is to delete the policy definition for the structure. Since the change is to delete the structure from the CFRM active policy, the structure rebuild process cannot be used to make the pending policy changes active.

OF A PENDING POLICY CHANGE TO SIZE/INITSIZE BUT ALTER NOT ALLOWED

There is an administrative policy change pending. The pending policy change includes a change to the SIZE or INITSIZE specifications. Since at least one of the active or failed-persistent connections to the structure does not allow alter processing AND system-managed rebuild is required, the structure rebuild process cannot be used to make the pending policy changes active.

THERE IS NO CONNECTIVITY TO COUPLING FACILITY

The CFRM active policy indicates that this system does not have connectivity to the coupling facility where an instance of the structure is allocated.

OF AN UNEXPECTED ERROR WHEN BUILDING THE LIST OF ELIGIBLE CFS

The REALLOCATE process encountered an unexpected error during processing to build the list of coupling facilities where an instance of the structure could be allocated. When this processing accessed an allocated instance to determine the structure parameters, either connectivity to the CF was lost or the command to the CF failed unexpectedly.

A STRUCTURE REBUILD PROCESS IS IN PROGRESS

The structure rebuild process is already in progress for the structure. The structure rebuild process type could be either rebuild or duplexing rebuild. For a duplexing rebuild, the in-progress processing could be one of the following:

• The structure is duplexed. For a user-managed duplexing rebuild, only one instance is allocated because the last user connected to both instances disconnected in between another user's IXLCONN and IXLCONN REBUILD requests.
• Process is in progress but has not reached duplexing established.
• Process has been stopped with KEEP=OLD.
• Process has been stopped with KEEP=NEW.

THE STRUCTURE HAS FAILED

The rebuild start request was rejected for one of the following reasons:

• The request was to start a duplexing rebuild and the structure has failed. Duplexing rebuild is not allowed when the structure is in the failed state.
• The request would result in a system-managed rebuild. System-managed rebuild is not allowed when the structure is in the failed state.

THE STRUCTURE HAS NO ACTIVE CONNECTORS

The request would have resulted in a user-managed process, but the structure has no active connectors to participate in structure rebuild processing.

AT LEAST ONE CONNECTOR DOES NOT SUPPORT REBUILD

At least one of the active connectors to the structure does not support rebuild.

NO SUITABLE COUPLING FACILITY FOR REBUILD WITH LOCATION=OTHER

The rebuild start request was rejected because LOCATION=OTHER was necessary and no other eligible coupling facility was found in the preference list.

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.

DUPLEXING REBUILD PREVENTED BY CONNECTOR(S)

The structure does not support duplexing rebuild for one of the following reasons:

• 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.

THE 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.

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 rebuild if a CFRM policy change is pending, and either:
  • The policy changes does not involve updates to the SIZE or INITSIZE values, or
  • the policy change does involve updates to SIZE or INITSIZE and all the structure connectors specified IXLCONN ALLOWALTER=YES.
• A potentially suitable coupling facility does not permit structure allocation.

CONNECTORS DO NOT SUPPORT SYSTEM-MANAGED PROCESSES

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.

AT LEAST ONE CONNECTOR HAS LOST CONNECTIVITY

The requested system-managed process (for example, rebuild) cannot be initiated because one or more of the connectors to the target structure has lost connectivity.

THE CFRM CDS 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)" implicitly formats a CFRM couple data set that supports both system-managed rebuild and system-managed duplexing rebuild.

A 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.

A CFRM ACTIVE POLICY DATA AREA COULD NOT BE OBTAINED

The requested system-managed process (for example, rebuild) cannot be initiated because the necessary CFRM active policy data area could not be obtained.

THE CFRM ACTIVE POLICY INDICATES REALLOCATE NOT ALLOWED

The REALLOCATE process is bypassing the structure because ALLOWREALLOCATE(NO) is specified in the CFRM active policy.

STRUCTURE IS ALLOCATED IN PREFERRED CF AND POLICY CHANGE MADE

The structure is allocated in the preferred CF and the pending policy change was made. The policy change was made immediately because the structure is allocated in the preferred CF according to the pending policy and the pending policy did not affect the structure size.

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 will contain additional diagnostic information.

STRUCTURE OBJECTS IN STORAGE-CLASS MEMORY

The request would have resulted in a duplexing rebuild, but a duplexing rebuild could not be started because storage-class memory is in use.