Explanation
A DISPLAY XCF,STRUCTURE command was entered to display
summary information about the structures defined in the CFRM active
policy that is used by this sysplex. The system will repeat the message
text to report all requested structures. The status of a single structure
might also extend to several message lines. Additionally, a message
will be displayed to provide the CFRM event management protocol that
is used by this sysplex.
If no structures are displayed, then
one of the trailer messages shown above will be displayed instead
to explain the absence of structures.
If the CFRM Couple Data
Set needs to be reformatted, then a message will be displayed before
any structures are listed. This message will specify the minimum numbers
to be used in reformatting the data set.
If the
REALLOCATE process has been initiated, then a message is displayed
before any structures are listed. This message indicates the current
state of the REALLOCATE process. The REALLOCATE process is in progress
if a SETXCF START,REALLOCATE operator command has been issued. The
REALLOCATE process is stopping if a SETXCF STOP,REALLOCATE operator
command has been issued. Once started, the REALLOCATE process evaluates
each allocated structure to determine the need for activation of a
pending policy and/or location adjustment of instance(s) allocated
in CF(s). REALLOCATE processing ends either when all allocated structures
have been evaluated with appropriate action taken or when the REALLOCATE
process was stopped and relocation steps for the current target structure
have finished.
In the message text:
- hh.mm.ss
- The time in hours (00-23), minutes (00-59), and seconds (00-59)
for the DISPLAY XCF command.
- CF LOSSCONN RECOVERY MANAGEMENT IS IN PROGRESS
- A loss of connectivity to a coupling facility occurred that required
connector recovery.
- str#
- The STR number to be used in reformatting the CFRM Couple Data
Set. If the current number is adequate, then this line will not be
displayed.
- conn#
- The CONNECT number to be used in reformatting the CFRM Couple
Data Set. If the current number is adequate, then this line will not
be displayed.
- totalstr
- The total number of structures that should be deleted from the
CFRM active policy.
- THE REALLOCATE PROCESS IS IN PROGRESS.
- The REALLOCATE process is initiated by the SETXCF START,REALLOCATE
operator command. Once started, the REALLOCATE process examines each
allocated structure to determine whether the location of any instance
needs to be adjusted and/or a pending policy activated. The evaluation
process uses the XCF allocation algorithm which factors in the CFRM
active policy information and current set of active connections to
make the determination.
- THE REALLOCATE PROCESS IS STOPPING.
- The REALLOCATE process is stopped by the SETXCF STOP,REALLOCATE
operator command. Once stopped, the structure, which is the current
target of the REALLOCATE process, will complete the relocation steps
prior to ending the REALLOCATE process.
- strname
- The name of a structure.
- mm/dd/yyyy
- The date when the structure was allocated. The date is in months
(01-12), days (01-31), and years (0000-9999). If the structure is
not allocated, dashes are displayed instead.
- hh:mm:ss
- The time when the structure was allocated. The time is in hours
(00-23), minutes (00-59), and seconds (00-59). This is used to guarantee
structure uniqueness. If the structure is not allocated, dashes are
displayed instead.
- status
- One or more of the following:
- ALLOCATED
- The structure is allocated in a coupling facility.
- NOT ALLOCATED
- The structure is not allocated.
- ALLOCATED (NEW)
- A structure rebuild process is in progress and two instances of
the structure are allocated. This is the new instance of the structure.
The structure rebuild process type is either rebuild or duplexing
rebuild.
- ALLOCATED (OLD)
- A structure rebuild process is in progress and two instances of
the structure are allocated. This is the old instance of the structure.
The structure rebuild process type is either rebuild or duplexing
rebuild.
- CFNAME: cfname
- cfname is the name of the CF in which the instance
of the structure currently resides.
- DEALLOCATION PENDING:
- Possible reasons for structure deallocation pending
are:
- DEALLOCATING SYSTEM LOST CONNECTIVITY
- The system that attempts to deallocate the structure lost connectivity
to the coupling facility that contains the structure. The structure
deallocation might remain pending if the coupling facility that contains
the structure is not connected to any system. Use either the DISPLAY
XCF,CF or the DISPLAY CF command to show the connectivity status of
the coupling facility.
- STRUCTURE DUMP EXISTS WITH STRUCTURE DUMP ID nnnn
- Deallocation is pending for this structure because a structure
dump is associated with this structure. The structure deallocation
remains pending until the structure dump is either forced or written
to a dump data set. The structure dump id nnnn is
given for use in the SETXCF FORCE,STRDUMP command.
- TRANSITIONING: CONNECT OR DISCONNECT IN PROGRESS
- The structure is either being allocated in a coupling facility
or deallocated from a coupling facility. The structure
deallocation may remain pending if the coupling facility containing
the structure is not connected to any system. Use the DISPLAY XCF,CF
or DISPLAY CF command to show the connectivity status of the coupling
facility.
- STRUCTURE FAILED
- The structure has failed.
- POLICY CHANGE PENDING - CHANGE
- There is an administrative policy change pending.
The pending change is to change the policy definition for the structure.
- POLICY CHANGE PENDING - DELETE
- There is an administrative policy change pending. The pending
change is to delete the policy definition for the structure.
- STRUCTURE NOT DEFINED IN POLICY
- The structure is not defined in the active policy and therefore
cannot be connected to. This scenario can only occur when all instances
of the structure are either deallocation pending or in transition.
- FAILED-PERSISTENT CONNECTIONS UNAVAILABLE DUE TO LARGER CFRM COUPLE
DATA SET REQUIRED
- The CFRM Couple Data Set must be reformatted to correct this unavailability.
- STRUCTURE DUMP EXISTS WITH STRUCTURE DUMP ID nnnn
- There is a structure dump associated with this structure, and
the structure dump ID nnnn is given for use in
the SETXCF FORCE,STRDUMP command.
- ALTER IN PROGRESS
- Structure alter has been initiated.
- ALTER STOP IN PROGRESS
- Structure alter stop has been initiated.
- POPULATECF REBUILD PENDING FOR cfname
- The structure is pending rebuild for the current PopulateCF rebuild. cfname is
the name of the coupling facility specified for the PopulateCF rebuild
request.
- POPULATECF REBUILD IN PROGRESS FOR cfname
- The structure is being rebuild for the current PopulateCF rebuild. cfname is
the name of the coupling facility specified for the PopulateCF rebuild
request.
- REALLOCATE EVALUATION PENDING
- The allocated structure is pending evaluation of its current location.
The REALLOCATE process initiated by the SETXCF START,REALLOCATE operator
command examines each allocated structure to determine whether the
location of any of the instance(s) needs to be adjusted and/or a pending
policy activated. The evaluation process uses the XCF allocation algorithm,
which factors in the CFRM active policy information and current set
of connections, to make the determination.
- TARGET OF REALLOCATE PROCESS
- The structure was selected by the REALLOCATE process to have its
location adjusted and/or pending policy activated. The REALLOCATE
process was initiated by the SETXCF START,REALLOCATE operator command.
Once marked as the target of the REALLOCATE process, the structure
remains the target until one of the following occurs:
- The REALLOCATE process evaluates the next structure or completes.
- The structure is reduplexed, deallocated, or forced.
- REBUILDING
- The structure rebuild process type is rebuild.
- REBUILD STOPPING
- The structure rebuild process type is rebuild.
The process is being stopped.
- DUPLEXING REBUILD
- The structure rebuild process type is duplexing
rebuild.
- DUPLEXING REBUILD STOPPING
- The structure rebuild process type is duplexing
rebuild. The process is being stopped to fall back to the old structure.
- DUPLEXING REBUILD SWITCHING
- The structure rebuild process type is duplexing
rebuild. The process is being stopped to switch to the new structure.
- METHOD: method
- The method used to manage the current process (for example, rebuilding,
rebuild stopping, or duplexing rebuild) is one of the following:
- SYSTEM-MANAGED
- The system is managing the process.
- USER-MANAGED
- The connected users are managing the process.
- PHASE: phase
- The phase of the current process (for example, rebuilding, rebuild
stopping, or duplexing rebuild) is one of the following:
- WAITING FOR QUIESCE
- The structure rebuild process is in the quiesce phase.
- WAITING FOR COMPLETE
- The structure rebuild process is in the complete phase.
- WAITING FOR CLEANUP
- The structure rebuild process is in the cleanup phase.
- DUPLEX STARTUP
- The structure rebuild process is in the startup phase.
- DUPLEX ESTABLISHED
- The structure rebuild process is in the duplex established phase.
- DUPLEX SWITCHING
- The structure rebuild process is in the duplex switching phase.
- STARTUP
- The structure rebuild process is in the startup phase.
- ALLOCATE
- The structure rebuild process is in the allocate phase.
- ATTACH
- The structure rebuild process is in the attach phase.
- COPY
- The structure rebuild process is in the copy phase.
- COPY STOP
- The structure rebuild process is in the copy stop phase.
- QUIESCE FOR STOP
- The structure rebuild process is in the quiesce for stop phase.
- STOP
- The structure rebuild process is in the stop phase.
- START ALTER NOT PERMITTED
- CF structure alter processing has been disabled; start alter is
not permitted.
- strtype
- One of the following:
- LOCK
- The structure type is lock.
- SLIST
- The structure type is serialized list.
- LIST
- The structure type is list.
- CACHE
- The structure type is cache.
- blank
- The structure type is only applicable when the status is one of
the following:
- ALLOCATED
- ALLOCATED (NEW)
- ALLOCATED (OLD)
- EVENT MANAGEMENT:
- The CFRM event management protocol according to the CFRM active
policy. Except for XCF signaling structures, message-based processing
can be used for any allocated structure. When the CFRM event management
protocol is message-based, message-based processing is enabled for
an allocated structure during event processing. When the CFRM event
management protocol is policy-based, event processing is policy-based
for all allocated structures.
- evtmgmt
- One of the following:
- POLICY-BASED
- For the sysplex, event management for an allocated structure is
controlled on each system that has a structure connection and the
CFRM active policy is accessed to obtain event data.
- MESSAGE-BASED MANAGER SYSTEM NAME: mgrsysname
- For the sysplex, allocated structures that are enabled for message-based
processing have event processing managed by an event manager system
using messages sent through XCF signaling for communication with the
participant system(s). The manager system updates the CFRM active
policy once all participant system(s) distribute the event to active
connections. The event manager system is identified by mgrsysname.
- MESSAGE-BASED TRANSITIONING TO NEW MANAGER
- For the sysplex, allocated structures that are enabled for message-based
processing have event processing managed by an event manager system,
but the sysplex is transitioning to a new manager system. When the
new manager system is assigned, the name of the event manager system
can be displayed. The sysplex changes to a new manager system as
the result of removing the prior manager system from the sysplex.
- msgbasedlevel
- The level of message-based event processing being used by CFRM.
Message-based processing can be restarted by the system if a system
in the sysplex does not support this level. Message-based processing
can also be restarted by the system to increase this level. There may be functions that require a particular level.
For example, the CFLCRMGMT function requires a level that is not supported
by levels of z/OS lower than V2R2. See "Comparing message-based processing
and policy-based processing" in for
more information on the CFLCRMGMT function,.
System action
The system continues processing.
Source
Cross System Coupling Facility (SCXCF)
Module
Routing code
Descriptor code