build_cat - Build a media changer catalog file
/opt/SUNWsamfs/sbin/build_cat [ -t media ] file catalog
/opt/SUNWsamfs/sbin/build_cat [ -t media ] - catalog
build_cat will build a catalog file from file. If '-' is
substituted for file, standard input will be used. If nei-
ther file or '-' is given, the usage message is emitted and
Each line in the input file describes one piece of media in
the catalog. The first four fields are required. The
remaining fields should not be supplied except if generated
by the dump_cat utility. Manually creating or editing of
these fields can produce undesirable results.
The fields, in order, on each line are:
Index The index of this entry within the catalog. The
index must be an incrementing integer starting at
vsn The volume serial name of the media. If there is
no volume serial name then the character "?"
should be used.
bar code The bar code or volser for the media. If there is
no bar code then the string NO_BAR_CODE should be
The media type for this media (see mcf(4)).
ptoc-fwa The next position to be used to write data to the
The number of times the media has been mounted.
capacity The capacity of the device in 1024-byte units.
The amount of space left in 1024-byte units.
flags The flags field from the catalog entry, in numeric
The tape block size or optical disk sector size.
The time that the medium was labeled.
slot The slot containing the volume within the
partition The partition or side of a magneto-optical car-
tridge. The value of partition is 0 for tapes, 1
or 2 for m-o cartridges.
The time the medium was last modified.
The time the medium was last mounted.
The time the volume was reserved. A value of 0
means no reservation.
The volume reservation - archive-set/owner/file
Information about this volume supplied by the
lvtime The last verified time for a tape.
lvpos The last verified position on tape.
Set the media type of the catalog to media (see mcf(4).
If the media option is specified, the media type field
from the input file must match the media type specified
by media. If the media option is not specified, no
enforcement of media type is performed.
build_cat can be used to generate a catalog that contains a
combination of usual SAM-QFS media and so-called foreign
media. Foreign media are those that use a different format
from SAM-QFS. The migration toolkit (SAMmigkit) provides
hooks for the site to use to enable SAM-QFS file systems to
stage (and optionally re-archive) data from foreign media.
When building a catalog for foreign media, the -t media
option must be used to set the physical media type. For
example, if the library contains DLT tapes, you would use -t
lt on the command line. In the input file, for each foreign
volume, specify a media type beginning with 'z'.
dump_cat(1M), export(1M), import(1M), mcf(4), sam-