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 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