NEWVOL [ Volume Management ] MPE/iX 5.0 Documentation
Volume Management
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
[[LDEV=]ldev ]
NEWVOL [VNAME=]sname:vname [[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.
1. 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.
2. 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 |
| |
____________________________________________
3. 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.
4. 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.
MPE/iX 5.0 Documentation