Reorganization Overview

Reorganization is required when more space is needed.

CICS® notifies CICS VR that an error occurred during a backout attempt. The error condition could be that a data set is out of storage, or that there is no space in a non-unique alternate index.

By default, spheres is reallocated with their space increased by 10%, rounded up to the unit of allocation. This 10% default value is defined in the DWWCBRRG reorganization job skeleton as:
//SETINCR SET INC=10    ! 10% INCREMENT AT REORG
Modifying the value of this parameter changes the space increment from the default 10%.
Note: The actual increment is limited according to the VSAM limits defined for the MAXRECORDSIZE attribute.
The following steps take place during reorganization:
  1. The original sphere attributes are retrieved from the ICF catalog.
  2. A new sphere is defined using the attributes, updated for the space increase
  3. REPRO is used to copy data from the original sphere to the new sphere
  4. Alternate indexes are built for the new sphere
  5. The original sphere is deleted
  6. The new sphere component names are renamed to the original sphere component names
Note: The IDCAMS processor performs the reorganization steps. For RLS spheres, the RLS protocols are used.

The DWWRG reorganization program is called during the reorganization job created by CICS VR. This applies to both automatic and manual jobs.