NEWSET
The NEWSET command creates a new volume set by initializing the master of
the volume set. Nonsystem volumes have only permanent space and should
be set to 100 for percentperm.
The volume master must be mounted in the SCRATCH or UNKNOWN state in
order for the NEWSET command to initialize a new volume set.
Task
Creates a new volume set.
Capability
CV, create mountable volume set
Syntax
NEWSET [SNAME=]sname
[MASTER=]master
[LDEV=]ldev
[[PERM=]percentperm] [[TRANS=]percenttrans]
[[GEN=]gen_number]
[[CLASSES=](cname[[,,cname]...])]
Parameters
sname The name assigned to the new volume set. It is
used to reference and identify the set, so it must
be unique to the system. Required.
master The name assigned to the master volume of the set.
The name assigned to the master volume need not be
the same as the name of the volume set. Required.
ldev A number from 1 to 100 specifying the logical
device on which the master volume being created is
mounted. It must specify a drive with a volume in
the SCRATCH or UNKNOWN state. Required.
percentperm A number between 0 and 100 specifying the maximum
percentage of disk space that can be allocated as
permanent. 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. Optional.
gen_number A number from 0 to 32767 specifying the generation
of the new volume. The default is 0. Optional.
cname The names of the volume classes to be initially
created in the volume set. The master volume
(volume being initialized) is assigned to these
classes. If this parameter is omitted, the volume
class DISC is created, and the master volume is
assigned to it. Optional.
Example
This example shows how to create a new volume set from a volume in either
the UNKNOWN or SCRATCH state.
1. Use the DSTAT command to check the states of the volumes in the
volume set.
2. Use the NEWSET command to create a new volume set, BSET.
3. Use the DSTAT command to verify that the new set was created.
__________________________________________________________________________
| |
| |
| volutil: :DSTAT |
| |
| LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) |
| - - - - - - - - - - - - - - - - - - - - - - |
| 21-079330 UNKNOWN |
| 22-079350 SCRATCH |
| 23-079350 SCRATCH |
| |
| volutil: NEWSET SNAME=BSET MASTER=BVOL1 LDEV=21 PERM=100 |
| |
| *Verify: Initialize new volume set BSET:BVOL1 on ldev 21 [Y/N]? Y |
| *Note: New master volume has been initialized on ldev 21. |
| |
| volutil: :DSTAT |
| |
| LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) |
| - - - - - - - - - - - - - - - - - - - - - - |
| 21-079330 MASTER BVOL1 (BSET - 0) |
| 22-079350 SCRATCH |
| 23-079350 SCRATCH |
| |
__________________________________________________________________________
4. Use the SHOWSET commands to display volume set information.
___________________________________________________________________________
| |
| |
| volutil: SHOWSET SNAME=BSET |
| |
| Volume - set name: BSET |
| Creation date: THU, OCT 15, 1987, 4:48 PM |
| Generation number: 1 |
| Number of volumes in set: 1 |
| Number of classes in set: 1 |
| Volume-class name: Index: |
| - - - - - - - - - - - - |
| DISC 1 |
| |
| volutil: SHOWSET SNAME=BSET INFO=VOLUMES |
| Volume name: Index: |
| - - - - - - - - - |
| BVOL1 1 |
| |
| volutil: SHOWSET SNAME=BSET INFO=SETINFO |
| |
| Volume - set name: BSET |
| Creation date: THU, OCT 15, 1987, 4:48 PM |
| Generation number: 1 |
| Number of volumes in set: 1 |
| Number of classes in set: 1 |
| |
| volutil: SHOWSET SNAME=BSET INFO=DSTATUS |
| |
| Volume name: State: ldev: Type: Path: |
| - - - - - - - - - - - - - - - - - - |
| BVOL1 MASTER 21 079330 8.0.4 |
| |
| |
| volutil: SHOWSET SNAME=BSET INFO=STORAGE |
| |
| Volume name: Free: Permanent: Transient: Device |
| - - - - - - - - - - - - - - - - - - - - - - - |
| BOLV1 1178032 401872 0 15 |
| |
| Total: 1178032 401872 0 15 |
| |
| |
___________________________________________________________________________
______________________________________________________________________________
| |
| |
| volutil: SHOWSET SNAME=BSET INFO=LABELS |
| |
| Volume name: BSET:BVOL1 |
| Initialization date: THU, OCT 15, 1987, 4:48 PM Volume type: 2 |
| Member number: 1 Number in set: 1 |
| Label Table Address: $00000500 MVT Address: $00000000 |
| Free Space Map Address: $00000070 Cold Load ID: $00000000 |
| Logical Volume ID: $05570001 Physical Volume ID: $05570001 |
| |
| |
| volutil: SHOWSET SNAME=BSET INFO=STRUCT |
| |
| Volumes in set: BSET |
| BVOL1 |
| Classes in set: BSET |
| DISC |
| Volumes in class: BSET:DISC |
| BVOL1 |
| |
______________________________________________________________________________