NAME

jvm − optical disk jukebox volume manager

SYNOPSIS

jvm unit [options]

DESCRIPTION

jvm is a jukebox management tool used to insert, erase, mount, unmount and eject jukebox volumes.  unit selects the jukebox by name or number.  If the command used to invoke jvm has a numeric component, that component serves as a unit number to select the jukebox in lieu of unit. The default jukebox name is /dev/jb.  options represents a list of numeric and keyword parameters specifying one or more operations to be performed. 

jvm uses jbc to operate the jukebox mechanism and to discover the jukebox parameters and status information. 

OPTIONS

Parameter options expect an associated numeric value either immediately following the keyword or concatenated with it at either end.  For example, the drive option may be specified 1d, d1 or drive 1. This last form appears in option descriptions and examples, but any of the forms may be used interchangeably. A numeric value either alone or followed by a or b is assumed to specify a storage slot in the jukebox. 

Command options may expect one or more parameter options have already been specified earlier on the command line.  Keywords may be abbreviated to as little as one letter.  jvm recognizes these option keywords:

a or b Identify the surface of a volume to be used in a command.  May be prefixed with a numeric slot.

c[lear] Erase the specified volume using the specified drive and the designated format.  Stop the ofs daemon for the drive beforehand and restart it afterward. 

d[rive] index Specify the relative position of the optical disk drive in the jukebox to be used in a command. 

e[ject] Eject the volume in the specified slot from the jukebox. 

f[orce] Permit the clear command to erase a volume even though it may contain active files. 

g[et] Fetch the specified volume into the specified drive.  Stop the ofs daemon for the drive before fetching the volume. 

h[elp] Display a terse command summary. 

i[nsert] Insert a volume into the specified slot in the jukebox. 

j[ukebox] index Specify the jukebox to be used in a command.  Equivalent to the unit parameter. 

k[ill] Kill the ofs daemon associated with the specified drive. 

m[ount] /path Mount the specified volume on the indicated path. The path name must begin with a "/" and may appear before the mount command.

n[ormal] or rw Select the normal (rewritable) volume format to be used by the clear command.  This is the default. 

p[ut] Store a volume in the specified drive back in its slot.  Restart the ofs daemon for the drive after storing the volume. 

s[lot] index Specify the slot to be used in a command.  This is the default for numeric values not accompanied by a parameter keyword.  May be suffixed by a or b.

t[otal] Clear the volume completely, without referring to the file space utilization on the volume. 

u[nmount] Unmount the specified volume. 

v[erify] Verify the file structure on the specified volume using the ofsck utility. 

w[orm] Select the WORM (write-once) volume format to be used by the clear command. 

z[ero] Erase the specified volume using the WORM format. 

EXAMPLES

To insert a disk into a slot:
# jvm jb0 slot 1 insert

    or # jvm 0 1 i

To insert a disk and mount both sides:
# jvm jb0 slot 1 insert a mount /jb0/1a b mount /jb0/1b

    or # jvm 0 1a i m /jb0/1a 1b m /jb0/1b

To insert a disk, clear both sides and eject:
# jvm jb0 slot 1 insert drive 2 a clear b clear eject

    or # jvm 0 2d 1a i c 1b c e

To clear and mount both sides of a disk:
# jvm jb0 slot 1 drive 2 a clear mount /jb0/1a b clear mount /jb0/1b

    or # jvm 0 2d 1a c m /jb0/1a 1b c m /jb0/1b

To unmount both sides of a disk and eject:
# jvm jb0 slot 1 a unmount b unmount eject

    or # jvm 0 1a u 1b u e

To eject a disk from a slot:
# jvm jb0 slot 1 eject

    or # jvm 0 1 e

SEE ALSO

jbc(8), ofsd(8), over(8), ofsck(8), mount(8), umount(8)

  —  30 April 1995