HPlogo Volume Management: HP 3000 MPE/iX Computer Systems > Chapter 5 Volume Management Commands

NEWSET

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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
Feedback to webmaster