System-managed list structure rebuild

System-managed rebuild allows z/OS® to manage the moving of coupling facility structures used for shared temporary storage, coupling facility data tables, and named counter server pools, without recycling the CICS® system using them.

Before this, you could move a structure by using server functions to UNLOAD to a sequential data set and then RELOAD elsewhere from the data set, but the switch caused errors in CICS such that restart was recommended, which in some situations was an unacceptable outage.

System-managed rebuild rebuilds the contents of a coupling facility list structure to a new location. The only impact when rebuild occurs is that requests are temporarily suspended within MVS™ during the few seconds or tens of seconds needed for rebuild processing. The system-managed rebuild process rebuilds only from one structure to another. Therefore, it is not applicable when the original structure has been lost or damaged. It is very useful for planned maintenance and is used for recovery purposes where connectivity to the structure has been lost from one or more systems but at least one system still has access to the original structure. For a loss of connectivity, the system does not initiate a system-managed rebuild automatically, regardless of connectivity options in the policy, but a rebuild can be requested using an operator command.

Any pending requests are made to wait during system-managed rebuild. Apart from the time delay, the application should not notice anything unusual when a system-managed rebuild occurs. For more information about system-managed rebuild, see z/OS MVS Programming: Sysplex Services Guide.

CICS supports the MVS system-managed rebuild facility, provided that the SUSPEND=FAIL option of the IXLCONN macro is available. The CICS servers detect automatically whether this support is available.

When a server is active, you can use the MVS operator DISPLAY XCF,STR command to display the connection details in message IXC360I.

For example, to look at the connection details for structure DFHXQLS_PRODTSQ1, use the following command:
     Display  XCF,STR,STRNAME=DFHXQLS_PRODTSQ1,CONNAME=ALL
To look at the connection details for coupling facility data tables structure DFHCFLS_DTPOOL1, use the following command:
    Display  XCF,STR,STRNAME=DFHCFLS_DTPOOL1,CONNAME=ALL
To look at the connection details for the named counter structure DFHNCLS_PRODNC1, use the following command:
    Display  XCF,STR,STRNAME=DFHNCLS_PRODNC1,CONNAME=ALL
For any of these start commands, the resulting IXC360I message output contains the following lines (in the CONNECTION information section), indicating that system-managed rebuild is enabled for the connection:
 ALLOW AUTO      : YES
  SUSPEND        : FAIL


dfha2_sysmgd_list_rebuild.html | Timestamp icon Last updated: Sunday, 4 June 2017