When the system-managed process commits to using the new structure,
connectors receive the Structure State Change event. The purpose
of this event is to alert connected users to any structure characteristics
that might have changed during the course of the system-managed process.
- For system-managed rebuild, EEPLSTRSTATECHANGEINFO contains information
about the coupling facility in which the new structure has been rebuilt
and specifies the structure's physical version numbers.
- For system-managed duplexing rebuild, the new “composite” attributes
of the duplexed pair of structures are returned in IXLYEEPL.
- VOLATILITY
If either structure is nonvolatile, the composite
state is nonvolatile.
- FAILURE-ISOLATION
If the connector is failure-isolated from
either structure instance, the composite state is failure-isolated.
- PHYSICAL STRUCTURE VERSION NUMBERS
There is no composite state
of this attribute. The physical structure version numbers for both
structure instances (primary and secondary) will be returned.
See Understanding the Structure Version Numbers for additional information about structure
version numbers.
- LOGICAL STRUCTURE VERSION NUMBER
There is no composite state
of this attribute. The logical version number will be the same for
the primary and secondary structure in a duplex pair.
- CFNAME
There is no composite state of this attribute. The
CFNAME is for the coupling facility where the primary instance of
the structure is allocated.
- CFLEVEL
When establishing duplexing, the secondary structure
must be allocated in at least as high a CFLEVEL as that which has
been previously reported back to any connector as the primary structure's
CFLEVEL. However, the secondary structure's actual CFLEVEL may validly
be lower than the actual CFLEVEL of the primary structure.
Therefore,
when a new connector connects to the duplexed structure, the composite
CFLEVEL reported is the lower of the connector's requested CFLEVEL
or the lower of the actual CFLEVELs for the primary or secondary
structure.
- EXCLUSION LIST
The exclusion list indicator is not applicable
to a connect during the Duplex Established phase.
- DUPLEXING STATE INDICATORS
There are two attributes that pertain
to duplexed structures. The indicators are:
- An indicator of whether the structure is simplex or duplexed.
- If duplexed, an indication of whether the primary structure instance
is duplex failure-isolated from the secondary.
When connecting to a structure during the Duplex Established
phase, the structure will be presented as duplexed, with the structures
either being duplex failure-isolated from one another or not.
No response is required for the Structure State Change event. It
simply provides an opportunity for connected users to evaluate the
new structure's attributes based on the coupling facility containing
the structure and take any action deemed appropriate.
To communicate the end of a system-managed rebuild or the beginning
of the Duplex Established phase of system-managed duplexing rebuild,
the system presents the Structure Available event to the event exits
of the active connectors to the structure. No response is required
for this event. Its purpose is to inform connectors that had previously
quiesced their activity against the structure that they may now resume
their coupling facility requests. For duplexing rebuild, operations
which were originally intended to be sent to a single coupling facility
structure while in simplex mode are now converted into duplex operations
and sent to both structures.
Whether or not the structure's size or object counts were modified
during the system-managed rebuild, Structure Alter Begin and Structure
Alter End events are presented to the event exits of the active connectors
to the structure if all connectors specified ALLOWALTER=YES.