build_cat(1M)

NAME
     build_cat - Build a media changer catalog file

SYNOPSIS
     /opt/SUNWsamfs/sbin/build_cat [ -t media ] file catalog

     /opt/SUNWsamfs/sbin/build_cat [ -t media ] - catalog

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     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
     build_cat exits.

     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
               zero.

     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
               used.

     media type
               The media type for this media (see mcf(4)).

     ptoc-fwa  The next position to be used to write data to  the
               media.

     access count
               The number of times the media has been mounted.

     capacity  The capacity of the device in 1024-byte units.

     space avail
               The amount of space left in 1024-byte units.

     flags     The flags field from the catalog entry, in numeric

               form.

     sector size
               The tape block size or optical disk sector size.

     label time
               The time that the medium was labeled.

     slot      The  slot  containing  the   volume   within   the
               automated library.

     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.

     modification time
               The time the medium was last modified.

     mount time
               The time the medium was last mounted.

     reserve time
               The time the volume was reserved.  A  value  of  0
               means no reservation.

     reservation
               The volume  reservation  -  archive-set/owner/file
               system.

     information field
               Information about  this  volume  supplied  by  the
               user.

     lvtime    The last verified time for a tape.

     lvpos     The last verified position on tape.

OPTIONS
     -t media
          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.

FOREIGN MEDIA
     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'.

SEE ALSO
     dump_cat(1M),   export(1M),   import(1M),    mcf(4),    sam-
     robotsd(1M)