itemize(1M)

NAME
     itemize - Catalog optical disk or jukebox

SYNOPSIS
     /opt/SUNWsamfs/sbin/itemize [  -file  |  f  identifier  ]  [
     -owner | u owner ] [ -group | g group ] [ -2 ] device

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     itemize generates a list of files on a specific optical disk
     or  generates  a  catalog  listing  of  disks or tapes for a
     robot, as specified by device. device is the device name  or
     equipment number defined in the mcf file.

     If device is an optical disk, itemize generates  a  list  of
     the  files cataloged on the given optical disk.  The list is
     generated by scanning the PTOC (partition table of contents)
     on  the  given  disk.   The options (see OPTIONS) apply only
     when using itemize on an optical disk.  The following infor-
     mation is returned when itemizing an optical disk:

       file ID   version   length   uid   gid

     These fields contain the following information:

     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 device is a robot, itemize generates a  list  of  optical
     disks  or  tapes that are cataloged in that robot.  The fol-
     lowing information is returned.

       EA   access_time   count   use   ty   vsn
            lvtime        lvpos

     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  per-
     centage of the media already used, ty is the media type, and
     vsn is the volume serial name of the media.  A vsn of  nola-
     bel  indicates  that media has been assigned to this element
     address but has not yet been labeled.

     When itemizing a robot, a status may also be returned.  This
     information  follows  the vsn field.  The following messages
     may be listed.

     VSN MISSING
               A  medium  has  been  assigned  to  this   element
               address,  the  status  of  the  element address is
               labeled, and the VSN is null.

     SLOT VACANT
               A  medium  has  been  assigned  to  this   element
               address,  the element address is physically empty,
               and the VSN is null.

     NEEDS AUDIT
               The status of the element address  has  the  needs
               audit flag set.

     MEDIA ERROR
               A read or write or positioning error was detected.

     When itemizing a robot with a two line display then
     lvtime (last verified time) and lvpos (last  verified  posi-
     tion) are shown.

OPTIONS
     -2 Displays two lines per file, which  makes  more  readable
     output for terminals.

     The following options apply only when itemizing an optical disk:

     -file | f identifier
          Lists only files with the specified file identifier.

     -owner | u owner
          Lists only files with the specified owner.

     -group | g group
          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 from 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 non-zero lvpos (last verified position)
     indicates the last tpverify was canceled  and  the  starting
     position of the next verify.

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