Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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).