jbformat(8) CLIX jbformat(8)
NAME
jbformat - Formats, labels, and builds file systems for read/write jukebox
media
SYNOPSIS
/usr/bin/jbformat [-F|-N ] [-f config_file] jukebox_id
FLAGS
-F Forces the format and other operations. By default, the command
prevents formatting of the cartridge or platter with valid label.
This helps accidental loss of data by formatting the wrong
cartridge or platter. Setting this flag overrides this check.
-N Does not activate the format operation, but activates other
operations such as writing labels, creating partitions, and making
file systems. Setting this flag overrides this check.
-f config_file
Uses config_file as the standard input file. By default, a minimal
user interface allows for configuring the command. This can be
overridden by use of the configuration file. The details of the
format of the configuration file are explained later.
jukebox_id
Indicates the ID of the jukebox in which the operations are to take
place.
DESCRIPTION
The jbformat command allows an automated formatting, partitioning,
labeling, and creation of file systems on the cartridge intended to reside
in a read/write optical jukebox. The command combines all these steps and
allows the user to perform such operations on more than one cartridge or
platter, without having to wait for drive availability.
When you key in the jbformat command, the cartridge or platter used is
requested to be inserted in the mail box slot. The cartridge or platter
is either moved into a drive, if a free drive is available, or moved into
an empty slot before moved into a drive, if available. This permits
importing more than one cartridge or platter without the user having to
wait for more than the time required to insert all the desired media into
the mailbox slot.
A minimal, simplistic user interface is provided for configuring the
jbformat command. The interface requests for parameters like the required
label names, the partition numbers, the modifier numbers, the sizes of the
partitions, and the file system types. More than one partition can be
specified, but the file system type should be the same across all the
2/94 - Intergraph Corporation 1
jbformat(8) CLIX jbformat(8)
partitions. More than one cartridge or platter can also be configured.
The manual interface becomes too cumbersome when the number of media are
large. The configuration file can then be convenient to use. The format
of the configuration file consists of specification on each volume name,
followed by the parameters for each volume, as follows:
vols = VOL_A, VOL_B
VOL_A = FFS, { par = 7, mod = 3, len = 500000 }
VOL_B = FFS, { par = 7, mod = 0, len = 800000, par = 7, mod = 3, len = 30000 }
The previous configuration file displays the configuration for one
cartridge or platter, whose volume names are to be labeled as VOL_A, and
VOL_B. The parameters of each volume are specified following the volume
names. More than one partition information can be specified and
maintained, by specifying the par, mod, and len. The entire partition
information must be enclosed within braces ({}). One entry exists for
each cartridge or platter.
The command prints the configuration information before starting the
process.
A log file, /usr/ip32/jbm/format.log, is maintained and updated by the
command to indicate the operations that have completed. This helps you
determine how long the command operations have progressed (or are still
progressing), or when the workstation/server shuts down.
FILES
/usr/ip32/jbm/format.log Log file of the operations of the command.
config_file User-specified optional configuration file.
NOTES
The jbformat command requires superuser privileges.
A format operation takes approximately 45 to 60 minutes per side. The
administrator should perform this operation when the jukebox is not being
actively used, since the drive performing the format is unavailable for
the duration of the format operation.
EXIT VALUES
The jbformat command exits with a value of 0 if successful. If
unsuccessful, it exits with a nonzero value.
RELATED INFORMATION
Commands: utdisk(8), dmu(8), mkpar(8), mkfs(8), newfs(8)
2 Intergraph Corporation - 2/94
jbformat(8) CLIX jbformat(8)
2/94 - Intergraph Corporation 3