Explanation
An operator entered a SETXCF START MAINTMODE or
SETXCF STOP MAINTMODE command to start or stop the maintenance mode
for a coupling facility. When a coupling facility is in maintenance
mode, it is not eligible for structure allocation purposes. Furthermore,
a coupling facility in maintenance mode is considered an undesirable
location for the structure instances that it already contains, so
that a rebuild, duplexing failover, or REALLOCATE process will tend
to remove those structures from the coupling facility.
In the
message text:
- START
- The request was to start maintenance mode.
- STOP
- The request was to stop maintenance mode.
- cfname
- The name of the coupling facility.
- SUCCESSFUL
- The request was successful.
- REJECTED
- The request was rejected.
- reason
- The reason why the request was rejected, which can be one of the
following conditions:
- COUPLE DATA SET FOR CFRM NOT AVAILABLE
- The couple data set for CFRM is not available to this system.
- POPULATECF REQUEST IN PROGRESS FOR THE COUPLING FACILITY
- A PopulateCf rebuild request is in progress for the specified
coupling facility. The coupling facility is not available for maintenance
mode.
- AN UNEXPECTED ERROR OCCURRED
- An unexpected error occurred during processing of the maintenance
mode request.
- COUPLING FACILITY NOT DEFINED IN THE CFRM ACTIVE POLICY
- The coupling facility is not defined in the CFRM active policy.
System action
When the command succeeds, the system has processed
the request for the CF and either placed the coupling facility into
the requested state, or found that the coupling facility was already
in the requested state and therefore made no change.
When
the command is rejected, the system ignores the request for the CF
and makes no changes to the state of the CF.
Operator response
You can use the DISPLAY XCF,CF command to
verify the state of the CF with respect to maintenance mode.
- If maintenance mode has been started for a CF, you might want
to initiate actions, such as structure rebuild or REALLOCATE processes,
to remove structure instances from the CF before taking the CF down
for maintenance.
- If maintenance mode has been stopped for a CF, you might want
to initiate actions, such as structure rebuild or REALLOCATE processes,
to relocate structure instances from other CFs into this CF.
System programmer response
Provide directions to the operator
as to the maintenance procedure being undertaken on the CF, and the
proper use of the SETXCF START or STOP MAINTMODE command in carrying
out that procedure.
Source
Cross System Coupling Facility (SCXCF)
Module
Routing code
Descriptor code