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.