NAME

itemize - Catalog optical disk or jukebox

SYNOPSIS

∕opt∕SUNWsamfs∕sbin∕itemize [-2] robotic-library

∕opt∕SUNWsamfs∕sbin∕itemize [-file|f identifier] [-owner|u owner] [-group|g group] [-2] optical-disk-device

AVAILABILITY

SUNWsamfs

DESCRIPTION

The itemize command generates a list of the files on a specified optical disk or a catalog listing of the volumes stored in a robotic library, where the device identifier optical-disk-device or robotic-library is the device name or equipment number defined in the mcf file.

If the device is an optical disk, itemize scans the PTOC (partition table of contents) on the disk. Each entry in the generated list takes the form

file ID version length uid gid

where:

file ID The name of the file.
version The version of the file.
length The size of the file in bytes.
uid The users ID of the file.
gid The group ID of the file.

If the device is a robotic library, itemize generates a list of optical disks or tapes that are cataloged in that library. Each entry in the list takes the form

EA access_time count use ty vsn lvtime lvpos [status]

where:

EA is the element address within the catalog.
access_time is the last time this element address was accessed.
count is the number of accesses.
use is the percentage of the media already used.
ty is the media type.
vsn is the volume serial name of the media. The VSN nolabel indicates that media has been assigned to this element address but has not yet been labeled.
The status field, when present, has one of the following values:

VSN MISSING means that a volume has been assigned to this element address, the status of the element address is labeled, and the VSN is null.

SLOT VACANT means that a volume has been assigned to this element address, the element address is physically empty, and the VSN is null.

NEEDS AUDIT means that the element address has been flagged with the the needs audit flag.
MEDIA ERROR means that a read, write, or positioning error was detected.

OPTIONS

-2

When itemizing a tape library, the -2 option displays the Data Integrity Validation (DIV) status of volumes and the progress of the tpverify (1m) operation:

lvtime, the last verified time
lvpos, the last verified position on the media.
status is either div for 100% DIV media or none for media that contains one or more Non-DIV archives.

When itemizing an optical media volume, the -2 option displays two lines per file, which makes terminal output more readable.

-file | f identifier

Lists only files with the specified file identifier.

-owner | "uowner

Lists only files with the specified owner.

-group | "ggroup

Lists only files with the specified group.

EXAMPLES

The following example lists a catalog for an optical library with a device number of 50:

server# itemize 50
Robot VSN catalog: eq: 50   count: 476
EA      access_time  count  use  ty vsn
   0    Jan 22 15:57   117  76%  mo OPT000  SLOT VACANT
   1    Jan 22 17:17    86  76%  mo OPT001  SLOT VACANT
   2    Jan 22 15:57    55  76%  mo OPT002
   3    Jan 22 16:13    72  76%  mo OPT003
   4    Jan 22 16:29   807  76%  mo OPT004
   5    Jan 22 16:45    27  76%  mo OPT005
   6    Jan 22 17:01    44  76%  mo OPT006
   7    Jan 22 15:14    36   0%  mo OPT007
   8    Jan 22 15:14    43   0%  mo OPT008
   9    Jan 22 15:15    30   0%  mo OPT009
  10    Jan 22 13:32    45  99%  mo OPT010
  11    Jan 22 15:47    35  99%  mo OPT011
  12    Jan 22 15:49    43  99%  mo OPT012
  13    Jan 22 15:53    31  84%  mo OPT013
  14    Jan 22 09:44    30   0%  mo OPT014
  15    Jan 22 09:45    52   0%  mo OPT015
  16    Jan 22 15:57  2163  99%  mo OPT016
  17    Jan 22 12:29  1618   0%  mo OPT017

This example shows an itemize listing for an optical disk:

  server# itemize 20
  some.1      15       2048 sam_archive  sam_archive
  samfs1.1    67       5120 sam_archive  sam_archive
  some.1      14       1024 sam_archive  sam_archive
  samfs1.1    66       5120 sam_archive  sam_archive
  samfs1.1    65       5120 sam_archive  sam_archive
  samfs1.1    64       5120 sam_archive  sam_archive
     .
. 
.

This example shows an itemize two line listing for a Robot VSN catalog with DIV media. A lvtime (last verified time) of none indicates the media has never had a completed tpverify (1m) run. A status of div indicates the media is 100% DIV. A status of none indicates the media is not 100% DIV or the media is not DIV capable. A non-zero lvpos (last verified position) indicates the last tpverify was canceled and the starting position of the next tpverify.

server# itemize -2 20
Robot VSN catalog: eq: 20       count: 3
slot    access_time  count  use  ty vsn
        lvtime      status          lvpos
   0    Apr  2 16:34     6   0%  ti 000219                          
        Apr  2 09:23   div          0
   1    Apr  2 16:17    28  29%  ti 000210                          
        Apr  2 16:17   div          0x9bb9
   2    none             0   0%  ti 000211                          
        none          none          0