z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Completing or Continuing the System-Managed Process

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014