historian(7)

NAME
     historian - The Sun QFS and SAM-QFS historian

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     historian is a catalog that keeps track of volumes that have
     been  exported  from  an automated library or that have been
     unloaded from manually loaded devices.

CONFIGURATION
     The historian catalog is  similar  to  the  catalog  for  an
     automated  library but since there are no devices associated
     with it, has no family set name.  If there is  no  historian
     catalog  configured in the mcf file (see mcf(4)) one will be
     created as:

         historian    n+1   hy   -   -   /var/opt/SUNWsamfs/catalog/historian

     Where n+1 is the highest equipment number  defined   in  the
     mcf file plus 1.

     The historian catalog will be created with 32  entries  when
     the  catalog  server  initializes and can grow during execu-
     tion. Each time the catalog fills, 32  entries  of  approxi-
     mately  200  bytes  each  will  be  added.   Make  sure  the
     historian's catalog resides on a file system large enough to
     hold  the expected size.  Since the catalog is needed before
     a sam file system can be mounted, DO NOT put the catalog  on
     a Sun QFS or SAM-QFS file system.

     Two configuration parameters in the defaults.conf file  (see
     defaults.conf(4))  affect  the  way the system will react to
     requests for media or requests to add media to the historian
     catalog.   If exported_media is set to unavailable, then any
     media exported from a media changer will be set to  unavail-
     able  in  the  historian.   Any request for media flagged as
     unavailable will receive an ESRCH error.  If attended is set
     to  "no"  (operator  is NOT available), then any request for
     media in the historian catalog will be sent back to the file
     system  with  an  error  (ESRCH).   Any  request  for  media
     currently loaded in a manually loaded drive will be accepted
     no  matter  what  the  state  of the attended or unavailable
     flags are.

EFFECTS OF HISTORIAN
     Whenever the file system receives  the  error  ESRCH  for  a
     stage  request,  it  will  automatically  generate  a  stage
     request for the next archived copy (unless  the  last  stage
     request  was  for  the  last  copy).   For a removable media
     request, the error ESRCH will be returned to the user.

IMPORT/EXPORT
     import (see import(1M)) is used to  insert  entries  to  the
     historian catalog.

     export (see export(1M)) is used to remove entries  from  the
     historian catalog.  You may export by slot or vsn.

CATALOG
     The catalog server will create a new, empty catalog  in  the
     default file location if none exists or no catalog is speci-
     fied in the mcf file.  Alternately,  the  build_cat  command
     (see  build_cat(1M))  may be used to build the initial cata-
     log.

     To initialize a catalog with 32 slots run:

          build_cat - /tmp/catalog_file < /dev/null

     then move /tmp/catalog_file to the path pointed  to  in  the
     mcf  file for the historian.  Or, you can create a file with
     the list of volumes and supply it as input to build_cat (see
     build_cat(1M)) for the format of the input file.

FILES
     mcf                           The configuration file for the
                                   Sun QFS and SAM-QFS software.
     defaults.conf                 Default information.
     /var/opt/SUNWsamfs/catalog/historian
                                   Default   historian    catalog
                                   file.

SEE ALSO
     build_cat(1M), dump_cat(1M), export(1M), sam-robotsd(1M).

     defaults.conf(4), mcf(4).