2.1;dmtvol (dismount_volume), revision 2.1, 81/06/27
DMTVOL (DISMOUNT_VOLUME) -- Dismount a logical volume.
usage:  DMTVOL {W | S | F}[unit] [log_vol_number] [pathname] [-FU | -NW]


FORMAT

  DMTVOL device[unit] [log_vol_number] [pathname] [options]


  DMTVOL  dismounts  a logical volume that was previously mounted with the MTVOL
  (MOUNT_VOLUME)  command.    After  the  volume  has  been  dismounted,  it  is
  unavailable for further access.


ARGUMENTS

  device
  (required)          Specify the type of disk on which the volume resides:  "W"
                     for a Winchester disk, "S" for a storage module, or "F" for
                     a floppy disk.

  unit
  (optional)         Specify a unit number (0 or 1  only)  for  the  device,  if
                     necessary.   For example, S1 denotes storage module unit 1.


                     Default if omitted:  0 (zero)

  log_vol_number
  (optional)         Specify the number of the logical volume to be  dismounted.


                     Default if omitted:  1

  pathname
  (optional)          Specify the entry directory of the logical volume.  If you
                     include this argument,  DMTVOL  dismounts  the  volume  and
                     uncatalogs  its  entry  directory.   If you omit it, DMTVOL
                     dismounts the logical volume, but retains its name  in  the
                     naming tree.

                     Default if omitted:  see above


OPTIONS

  -FU                 Forcibly  unlock  any  locked  objects,  then dismount the
                     volume.  If you omit this option, the dismount fails if the
                     volume contains any locked objects.

  -NW                No_write -- Prevents DMTVOL from trying  to  write  to  the
                     disk  during  the  dismount.  Normally, writing to the disk
                     saves current  information.    However,  if  the  disk  was
                     removed prior to dismount, this option should be used.


EXAMPLES

    1. $ dmtvol s 2           Dismount storage module unit zero,
       $                       logical volume 2, and leave its name in
                               the naming tree.

    2. $ dmtvol f /floppy     Dismount floppy unit zero, logical volume 1,
       $                       and delete its name from the naming tree.


RELATED TOPICS

  More information is available.  Type:

  - HELP MTVOL
    for details about mounting logical volumes.