Initiating structure rebuild with z/OS and CQS

A structure rebuild can be initiated by a z/OS® operator, by CQS, or by z/OS.

• A z/OS operator can initiate a structure rebuild to copy or recover queues using the following command:

  SETXCF START,REBUILD,STRNAME=strname,LOCATION=NORMAL/OTHER

• CQS initiates a structure rebuild if, during CQS initialization, it detects an empty structure and a valid SRDS (indicating a valid structure checkpoint in the SRDS). If CQS detects an empty structure and a valid SRDS, it also initiates a structure rebuild during event notification facility (ENF) 35 event processing.
• z/OS initiates a structure rebuild if the rebuild threshold for loss of connectivity is reached. The rebuild threshold for loss of connectivity is defined with the CFRM policy REBUILDPERCENT keyword. The REBUILDPERCENT default is 1. If the system programmer does not define REBUILDPERCENT, z/OS initiates a rebuild if any CQS loses connectivity to the structure.
• If structure copy aborts because of a CQS failure and no other CQS can determine if the failed CQS is the master, then the rebuild starts over as a structure recovery.