Providing VSAM sphere reorganization parameters

When you select the Reorganization option for VSAM spheres, the CICS® VR VSAM sphere reorganization parameters secondary window opens. Use this window to specify the parameters for the reorganization job.

Figure 1. VSAM sphere reorganization parameters secondary window
DWWPPRGS          CICSVR VSAM sphere reorganization parameters Row 1 to 2 of 2 
                                                                             
 Type the increase amount, percent, and specify new CI sizes for desired     
 entries. Switch reorganization type by pressing PF4, SwType, if needed.  
 Press Enter to continue.                                 
 
 VSAM sphere . . . . . . : CICSMVS.AA.KSDS01                               
                                                                           
 Reorganization type . . : AIXFULL                                         
 Increase  . . . . . . . . 10  % (0-99)                               
                                                                          
 Backup name for ESDS  . . ____________________________________________ 
 REORG mode  . . . . . . . 2  (1-CICS Offline, 2-non-CICS)  
 CICS APPLID . . . . . . . ________                                       

 VSAM sphere entry                             Type      Cur. CI  New CI 
 CICSMVS.AA.KSDS01.DATA                        DATA        4K     4608
 CICSMVS.AA.KSDS01.INDEX                       INDEX       2K     ____    

Command ===>  ________________________________________________________________ 
 F1=Help  F4=SwType  F7=Bkwd  F8=Fwd  F12=Cancel      
The parameters you need to specify are as follows:
Reorganization type
There are two reorganization types, AIXFULL and NOSPACE. Press F4, SwType, to switch between the two types.
AIXFULL
All the components of the VSAM sphere are reorganized according to the parameters that you specify for the reorganization job. The reorganization type AIXFULL can be used only for a VSAM sphere that has alternate indexes defined.
NOSPACE
Only the base cluster of the VSAM sphere is affected by the reorganization.
Increase
The percentage amount by which the space of the sphere and its alternate indexes increases. The default is 10%. 99% almost doubles the space. If you specify zero, the space of the VSAM sphere remains unchanged, and the only changes made in the reorganization are to the control interval (CI) sizes for the components of the sphere, if you have requested changes using the New CI fields.
Backup name for ESDS
The backup name is used for a backup step after the reorganization, if you change any of the control interval (CI) sizes for the components of the sphere. After changing the CI size, backup of an ESDS sphere is required for any further forward recovery processing to run correctly, because the change to the CI size affects the Relative Base Addresses (RBAs) of the records.

The backup name for an ESDS sphere is ignored if the sphere being processed is not of an ESDS type or if you leave all of the New CI fields blank.

REORG mode
There are two reorganization modes, CICS Offline and non-CICS. Specify 1 for CICS Offline, and 2 for non-CICS.
CICS Offline
Additional processing is carried out to disable the VSAM sphere and take it offline to a particular CICS region before the reorganization, and to enable the VSAM sphere to CICS after the reorganization. If you choose the CICS Offline reorganization mode, you must specify a CICS APPLID, which is used to take the sphere offline to that CICS region.
Non-CICS
The VSAM sphere is not taken offline to any CICS region.
CICS APPLID
The APPLID of the CICS region to which the VSAM sphere is to be taken offline before the reorganization.
New CI
The new control interval (CI) size for this component of the VSAM sphere, in either bytes or kilobytes. For kilobytes, specify K after the numeric value, for example, 16K. If you specify the new value in bytes, the maximum value is 32768. If you specify the new value in kilobytes, the maximum value is 32 KB.
For detailed help information about any of these parameters, move the cursor to the appropriate field and press F1.