samimport(1M)

NAME
     import - Imports cartridges into a library or the historian

SYNOPSIS
     /opt/SUNWsamfs/sbin/import [[-v volser] | [-c num -s pool]]

     [-e] [-l] [-n] eq

     /opt/SUNWsamfs/sbin/import -v volser | -b barcode [-n]
     -m type eq

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The first form of the import command sends a request to the
     automated library specified by eq to import media.  The
     cartridge is placed in the first available slot in the
     library.  For example:

     import 27

     The second form of the import command can be used only when
     eq is the Equipment Identifier of the default historian(7)
     and the cartridge is neither two-sided nor partitioned.
     This form adds an entry to the historian's catalog for the
     given type and the given barcode or volser.  At least one of
     the -b barcode or -v volser identifiers must be present.
     For example:

     import -b 007001 -m lt 27

OPTIONS
     This command accepts several options.  Some of the options
     affect only certain automated libraries.  See the option
     descriptions and the NOTES section for information pertinent
     to vendor-specific automated libraries.  The options for the
     import command are as follows:

     -b barcode
               The barcode assigned to the cartridge.  If the
               second form of the command is used, either a
               -v volser or a -b barcode option is required.

     -c num -s pool
               (Network-attached StorageTek automated libraries
               only.)

               For StorageTek automated libraries using the first
               form of the import command, either a -v volser
               identifier or a -c num -s pool identifier must be
               used.  If used, the -c num and -s pool options
               must be specified together.

               The -c num option specifies the number of volumes
               to be taken from the scratch pool specified by the
               -s pool option.

               The -s pool option specifies the scratch pool from
               which num volumes should be taken and added to the
               catalog.

     -e        Specifies that all newly added cartridges be
               audited.  This includes an EOD search and updating
               the catalog with actual capacity and space-
               remaining values.

     -l        (Network-attached StorageTek automated libraries
               only.)

               The -l option requests that the new VSN numbers be
               written to standard output.  If present, this
               option must be specified in conjunction with the
               -c num and -s pool options.

     -m type   The media type of the cartridge.  For more
               information on valid media type codes, see the
               mcf(4) man page.

     -n        Specifies that the media is unlabeled foreign tape
               (not SAM-QFS media). It is write protected and can
               be only used for read access.

     -v volser (Network-attached ADIC/GRAU, StorageTek, and IBM
               3494 automated libraries only.  For the IBM 3494
               library, this option is accepted only when running
               in shared mode; for more information, see the
               ibm3494(7) man page.)

               This option creates a catalog entry with volser as
               the barcode.  Physical import and export of
               cartridges within ADIC/Grau and StorageTek
               libraries are performed by utilities supplied by
               the vendor.

     eq        The Equipment Identifier as entered in the mcf
               file.  For more information on the mcf file, see
               the mcf(4) man page.

               If the first form of the import command is used,
               eq must be the equipment identifier of an
               automated libarary.

               If the second form of the import command is used,
               eq must be the equipment number of the default
               historian.

NOTES
     If you are using the first form of the command with a
     network-attached StorageTek automated library, you can
     identify the cartridge being imported by using either the
     -v volser option or by using the -s pool and -c num options
     together.

FILES
     mcf       The configuration file for SAM-QFS environments.

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

     mcf(4).

     historian(7), ibm3494(7).