import - Imports cartridges into a library or the historian
/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
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:
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.
import -b 007001 -m lt 27
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:
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
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
-e Specifies that all newly added cartridges be
audited. This includes an EOD search and updating
the catalog with actual capacity and space-
-l (Network-attached StorageTek automated libraries
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
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
If the second form of the import command is used,
eq must be the equipment number of the default
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
mcf The configuration file for SAM-QFS environments.