THE REQUESTED {START,REALLOCATE | STOP,REALLOCATE | STOP,REALLOCATE,FORCE}
WAS {ACCEPTED. |REJECTED: | COMPLETED.} reason
Explanation
A SETXCF START/STOP operator command was issued
to start or stop a REALLOCATE process or XCF forced an in-progress
REALLOCATE process to terminate. The requested START or STOP was either
rejected with a reason provided for explanation or accepted.
Once
started, the REALLOCATE process will examine each allocated structure
to determine the need for activation of a pending policy and/or changing
the location of instance(s) allocated in CF(s). The XCF allocation
algorithm is used to determine whether or not the CFs containing the
structure instances are the preferred CFs. Message IXC574I is written
to the hardcopy log to show the current location of instance(s) allocated
in CF(s), the policy information used, and the results of applying
the XCF allocation criteria. REALLOCATE processing uses these results
when evaluating the allocated structure. When the structure needs
to be adjusted, REALLOCATE processing predetermines the necessary
steps and uses structure rebuild processing to accomplish the adjustment.
Messages associated with the structure rebuild process (IXC57nI and
IXC52nI) and the deallocation process (IXC579I) will be issued. Message
IXC546I is issued for an error encountered when starting a structure
rebuild process for the next step to adjust the target structure.
When REALLOCATE processing does not attempt adjustment of an allocated
structure, message IXC544I will be issued to provide an explanation.
IXC543I
will be issued to indicate processing is complete. REALLOCATE processing
is complete when one of the following occurs:
- All allocated structures have been evaluated with appropriate
action taken.
- The REALLOCATE process was stopped and relocation steps for the
current target structure have finished.
- Either a SETXCF STOP,REALLOCATE,FORCE command or internal XCF
processing has resulted in the immediate termination of the REALLOCATE
process. The structure which is the current target of the REALLOCATE
process will continue the in-progress structure rebuild process but
this may not complete all the steps for relocation.
In addition, message will be issued to provide the summary
of the actions taken.
In the message text:
START,REALLOCATE
STOP,REALLOCATE
STOP,REALLOCATE,FORCE
- ACCEPTED.
- The request to start or stop a REALLOCATE process was accepted.
- REJECTED:
- The request to start or stop a REALLOCATE process was rejected
for the specified reason.
- COMPLETED.
- The system has completed processing for an accepted request to
START or STOP the REALLOCATE process.
- reason
- One of the following:
- AN UNEXPECTED ERROR OCCURRED
- The REALLOCATE request cannot be performed because an unexpected
error occurred.
- XES FUNCTION NOT AVAILABLE
- XES functions are not available. This can be because the hardware
necessary to provide XES functions is not present.
- COUPLE DATA SET FOR CFRM NOT AVAILABLE
- The couple data set for CFRM is not available to this system.
- A REALLOCATE PROCESS OR POPULATECF REBUILD IS ALREADY IN PROGRESS
- An attempt to start a REALLOCATE process was rejected for one
of the following reasons:
- A REALLOCATE process is in progress or stopping.
- A ROPULATECF rebuild is in progress.
Only one POPULATECF rebuild or REALLOCATE process is supported
at a time. Use DISPLAY XCF,STR,STATUS=ALLOCATED to identify the process.
- AT LEAST ONE SYSTEM DOES NOT SUPPORT THE REALLOCATE PROCESS
- A SETXCF START,REALLOCATE request was rejected or an in-progress
REALLOCATE process is terminated because there is at least one system
in the sysplex that does not support the REALLOCATE process. Since
the REALLOCATE process uses structure rebuild processing which can
be completed on any system in the sysplex, all systems must support
REALLOCATE processing in order either to accomplish the relocation
steps for the current target structure or to continue the necessary
actions for the in-progress REALLOCATE process.
- NO ALLOCATED STRUCTURES EXIST FOR REALLOCATE TO EVALUATE
- An attempt to start a REALLOCATE process was rejected because
there are no allocated structures to evaluate. The REALLOCATE process
is only applicable for allocated structures with instance(s) which
are displayed as the ACTIVE, REBUILD OLD/NEW, or DUPLEXING REBUILD
OLD/NEW structure.
- NO REALLOCATE PROCESS IS IN PROGRESS
- An attempt to stop a REALLOCATE process was rejected for one of
the following reasons:
- No REALLOCATE process is in progress.
- A POPULATECF rebuild is in progress and must be stopped with a
SETXCF STOP,REBUILD command specifying POPULATECF. Use DISPLAY XCF,STR,STATUS=ALLOCATED
to identify the structure(s) in the POPULATECF rebuild.
- REALLOCATE STOP ALREADY IN PROGRESS
- The SETXCF STOP,REALLOCATE request cannot be performed because
a stop request has already been accepted. The REALLOCATE process will
finish processing for the structure that is having the location adjusted
prior to completing the stop request. Use DISPLAY XCF,STR,STATUS=ALLOCATED
to identify the structure with "REALLOCATE PROCESS STOPPING".
System action
When the command is accepted, the system processes
the request. When the command is rejected, the system ignores the
request.
Operator response
Notify the system programmer.
System programmer response
When the start or stop request was
accepted, use the DISPLAY XCF,STR,STATUS=ALLOCATED command to determine
the state of REALLOCATE processing. The state of the REALLOCATE process
will be shown as "IN PROGRESS" or "STOPPING". The structure that is
the current target will indicate "TARGET OF REALLOCATE PROCESS". When
the REALLOCATE process is "IN PROGRESS", structures which have not
been evaluated will indicate "REALLOCATE EVALUATION PENDING". Structures
which have been processed will not have additional status indicators
displayed but the log can be examined to determine the action taken.
When
the start or stop request was rejected, based on the specified reason
take the necessary steps to correct the problem and reissue the command.
Source
Cross System Coupling Facility (SCXCF)
Module