samexport(1M)

NAME
     export, samexport - Export a cartridge from a robot

SYNOPSIS
     /opt/SUNWsamfs/sbin/export [-f] eq:slot
     /opt/SUNWsamfs/sbin/export [-f] mediatype.vsn
     /opt/SUNWsamfs/sbin/samexport [-f] eq:slot
     /opt/SUNWsamfs/sbin/samexport [-f] mediatype.vsn

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     export sends a request to the library  specified  by  eq  to
     place  the  specified  cartridge  in  the  mail-slot  of the
     library.  For the form mediatype.vsn, eq and slot are deter-
     mined from the catalog entry.  All other volumes on the car-
     tridge are also exported.

OPTIONS
     -f   The -f option is used for  network-attached  StorageTek
          automated  libraries only. The -f option will cause the
          volume specified to be exported to the  CAP  (Cartridge
          Access  Port)  and  the SAM-QFS catalog updated accord-
          ingly. The CAPID must be defined in the stk  parameters
          file.  See  the stk(7) man page for details on defining
          the CAPID.

     For the network-controlled libraries such as the GRAU  using
     the  GRAU  ACI  interface,  IBM 3494, or STK libraries using
     ACSLS and not specifying the -f option,  this  utility  only
     removes  the  catalog entry for the cartridge from the cata-
     log. Physical removal  and  addition  of  cartridges  within
     these  libraries is performed by utilities supplied by GRAU,
     IBM, and STK.

     Volumes on  cartridges  exported  from  a  library  will  be
     tracked  in  the historian(7).  The historian acts as a vir-
     tual library.  Volumes on cartridges that have been exported
     from a library will, by default, be considered available for
     archiving and staging activities. Operator  intervention  is
     required to provide access to exported cartridges to satisfy
     load requests.

     See the historian(7) man page for  details  about  the  his-
     torian  and  for the default settings that control access to
     exported cartridges.

     Note:  A cartridge may be exported from the historian.   The
     information about volumes on this cartridge will be lost.

     The export and samexport commands are identical; the  samex-
     port  name  is  provided to avoid a conflict with the Bourne
     shell intrinsic of the same name.

FILES
     mcf                 The  configuration  file   for   SAM-QFS
                         environments

SEE ALSO
     import(1M),  build_cat(1M),  dump_cat(1M),  sam-robotsd(1M),
     mcf(4), stk(7), historian(7)