NAME

import - Imports cartridges into a library or the historian

SYNOPSIS

∕opt∕SUNWsamfs∕sbin∕import [[-v volser] | [-c num -s pool]] [-e] [-l] [-n] [-L] 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

The -L option requests that the new volume be marked as LTFS media.

-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 Oracle HSM media). It is write protected and can be only used for read access.

-v volser

(Network-attached StorageTek automated libraries only.)

This option creates a catalog entry with volser as the barcode. Physical import and export of cartridges within 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 Oracle HSM environments.

SEE ALSO

export (1m), sam-robotsd (1m).

mcf (4).

historian (7),