Volume sets

Set up a volume set

First the disks for the volume set are initialized or formatted (VOLIN function) and entered in the Volres (system disk of the volume set). Then a catalog extent is set up on the Volres.

The following statements are available for the “Set up a volume set” function:

BEGIN-VOLUME-SET-DECLARATION ...,ACTION=*INSTALL 
CREATE-VOLUME ... 
CREATE-CATALOG 0,nnnn 
END-VOLUME-SET-DECLARATION 

The BEGIN-VOLUME-SET-DECLARATION statement starts the declaration of the volume set to be set up. The declaration ends with END-VOLUME-SET-DECLARATION. If several volume sets are to be set up in one SIR run, this statement block can be repeated for each volume set.

The CREATE-VOLUME statement must be specified for every disk that belongs to the volume set so that they can be stored in the SVL of the Volres. A CREATE-CATALOG statement can be specified for the Volres. Without the statement, a file catalog with
2000 PAM pages is created by default and its size is rounded up to the next multiple of the allocation unit size.

The function supports the setting up of volume sets that are used as dual recording and also of volume sets with disks of block size 4K.

The setup and extension of “free” volume sets, i.e. volume sets that do not belong to an SM pubset, is needed primarily for pubset reconfiguration.

Example

/START-SIR 
//BEGIN-VOLUME-SET-DECLARATION VOLUME-SET=AB, 
        ACTION=*INSTALL(FORMAT=*NK(*4K(8)),AVAILABILITY=*DRV)              1.
//CREATE-VOLUME DISK-NUMBER=000(OVERWRITE-DISK=*ANY,UNIT=MA(SUBUNIT=MB)), 
        FORMAT=*YES                                                        2.
//CREATE-CATALOG DISK-NUMBER=000,FILE-SIZE=160                             3.
//END-VOLUME-SET-DECLARATION                                               4.
//BEGIN-VOLUME-SET-DECLARATION VOLUME-SET=X, 
        ACTION=*INSTALL(FORMAT=*K,AVAILABILITY=*NORMAL)                    5.
//CREATE-VOLUME DISK-NUMBER=*RANGE(00,04,OVERWRITE-DISK=*ANY,
        UNIT=(MN00,MN01,MN02,MN03,MN04)), 
        FORMAT=*NO                                                         6.
//CREATE-CATALOG DISK-NUMBER=00,FILE-SIZE=500                              7.
//END-VOLUME-SET-DECLARATION                                               8.
//END 

1. A volume set with the ID AB, disk format NK4 and an allocation unit of 8 KB is to be set up. The volume set is to have DRV capability. Its logical properties (e.g. performance and availability) are defined when the volume set is assigned to a pubset. Before a volume set is defined as a DRV volume set with SIR, it must be entered in DRV with the command SET-DRV-PARAMETER UNIT=*VOLUME-SET(AB).

2. The first volume in the volume set AB is initialized with the VSN AB.000 and formatted without a prior VSN check.

3. A catalog section is created for the initialized and formatted volume 000. It has a size of 160 PAM pages.

4. The declaration for volume set AB is terminated. Such a BEGIN-/END statement block can be repeated as often as required in one SIR run.

5. An additional volume set is to be set up with the ID X and volume format K (i.e. with an allocation unit of 6 KB). The volume set is to be set up without a mirror volume (normal availability).

6. Five volumes are initialized for volume set X without a prior VSN check. These volumes are assigned the VSNs PUBX.00 through PUBX.04.

7. A catalog section is created for the initialized and formatted volume 00. It has a size of 500 PAM pages.

8. The declaration for volume set X is terminated.

Extending a volume set

A “free” volume set, i.e. one that does not yet belong to an SM pubset, can be extended by additional disks.

The following statements are available for the “Extend a volume set” function:

BEGIN-VOLUME-SET-DECLARATION ...,ACTION=*EXTEND 
CREATE-VOLUME ... 
END-VOLUME-SET-DECLARATION 

The CREATE-VOLUME statement must be specified for each disk added to the volume set so that they can be stored in the SVL of the Volres.

The CREATE-CATALOG statement is not permitted for this function.

A volume set that already belongs to an SM pubset can be extended with the “Extend an SM pubset” function (see "SM pubsets").

Example

/START-SIR 
//BEGIN-VOLUME-SET-DECLARATION VOLUME-SET=AB,ACTION=*EXTEND           1.
//CREATE-VOLUME DISK-NUMBER=*RANGE(001,002,OVERWRITE-DISK=*ANY,
        UNIT=(MP(SUBUNIT=MQ),MR(SUBUNIT=MS))), 
        FORMAT=*YES                                                   2.
//END-VOLUME-SET-DECLARATION 
//END 

1. The volume set with ID AB is to be extended.

2. A second and third volume with VSN AB.001 and AB.002 now also belong to this volume set.