NEWVOL

The NEWVOL command adds a new member volume to an existing volume set. If you include the ldev parameter, then the command initializes the new volume. That is, the command can define a volume in the set without the volume being present online. Defining a volume means that an entry identifying the volume is put on the volume set information table (VSIT) on the master volume, but the volume will not be initialized or available to the system.

The NEWVOL and INITVOL commands work together. If the volumes are not online, you can define the volumes with the NEWVOL command by not including the ldev parameter. Later, when the volume is available and online, you can use the INITVOL command to initialize the volume.

Task

Adds a new volume to a volume set.

Capability

CV, create mountable volume set

Syntax

   NEWVOL [VNAME=]sname:vname

              [ [LDEV=]ldev

                [PERM=]percentperm 

                [TRANS=]percenttrans

 		        [CLASSES=](cname[[,,cname]...])]

Parameters

sname: The name of the volume set where the new volume will reside. Required.
vname: The name assigned to the new volume. The name must be unique. Required.
ldev: A number from 1 to 100 specifying the logical device number of the volume being created. It must specify a drive with a volume in the SCRATCH or UNKNOWN state. Optional.




	NOTE: If the `ldev` parameter is omitted, the volume is defined only; that is, an entry is placed in the volume set information table (VSIT), but the volume is not initialized. You must then use `INITVOL` to initialize the volume. (Refer to the `INITVOL` command in this chapter.)

percentperm: A number between 0 and 100 specifying the maximum percentage of disk space that can be allocated as permanent storage. Optional.
percenttrans: For system volumes only, a number between 0 and 100 specifying the maximum percentage of disk space that can be allocated as transient storage. Optional.
cname: The class assigned to the new volume. The class must have been created previously with the NEWCLASS or NEWSET command. If this parameter is omitted, the volume will be assigned to the volume class DISC. Optional.

Example

This example shows how to add a volume to an existing volume set.

Before attempting to create a new volume, use the DSTAT ALL command to make certain the master volume of the volume set is in the MASTER state.

Next, use the SHOWSET command with the STRUCT parameter to determine the structure of the volume set, BSET. The STRUCT parameter shows that there are five volumes in volume set BSET and two classes, XL_DATA and the default class, DISC. It also shows the volumes in the classes.

   volutil: :DSTAT ALL



   LDEV-TYPE  STATUS   VOLUME (VOLUME SET - GEN)

   ---------  -------  --------------------------

   1-079350   MASTER   MEMBER1  (MPEXL_SYSTEM_VOLUME_SET-0

   2-079350   MEMBER   MEMBER2  (MPEXL_SYSTEM_VOLUME_SET-0

   21-079330  MASTER   BVOL1    (BSET-0)

   22-079350  MEMBER   BVOL2    (BSET-0)

   23-079350  UNKNOWN



   volutil: SHOWSET BSET STRUCT



        Volumes in set: BSET



         BVOL1

         BVOL2

         BVOL3

         BVOL4

         BVOL5



         Classes in set: BSET



         XL_DATA

         DISC

     Volumes in class: BSET:XL_DATA



         BVOL1

         BVOL3



     Volumes in class: BSET:DISC



         BVOL1

         BVOL2

         BVOL3

         BVOL4

         BVOL5

Now add another volume to the set. For this example, the volume is not physically mounted, so it cannot be initialized. Since a class is not specified, the volumes are automatically added to the DISC class.
Use SHOWSET STRUCT to verify that the volume has been added.



   volutil: NEWVOL BSET:BVOL6



   *Verify: Define new member volume BSET:BVOL6 [Y/N]? Y



   *Warning: Volume only defined and not physically 

             initialized.



   volutil: SHOWSET BSET STRUCT





       Volumes in set: BSET



       BVOL1

       BVOL2

       BVOL3

       BVOL4

       BVOL5

      *BVOL6

     Classes in set: BSET



       XL_DATA

       DISC



     Volumes in class: BSET:XL_DATA



       BVOL1

       BVOL3



     Volumes in class: BSET:DISC



       BVOL1

       BVOL2

       BVOL3

       BVOL4

       BVOL5

      *BVOL6




	NOTE: The `*` indicates that the volume has been defined but not initialized. Refer to the `INITVOL` command in this chapter.

NEWVOL

Technical documentation

» Table of Contents

» Index

Task

Capability

Syntax

Parameters

Example