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 chmed - Set or clear library catalog flags and values SYNOPSIS /opt/SUNWsamfs/sbin/chmed [-b] +flags specifier /opt/SUNWsamfs/sbin/chmed [-b] -flags specifier /opt/SUNWsamfs/sbin/chmed [-b] -capacity capacity specifier /opt/SUNWsamfs/sbin/chmed [-b] -space space specifier /opt/SUNWsamfs/sbin/chmed [-b] -time time specifier /opt/SUNWsamfs/sbin/chmed [-b] -count count specifier /opt/SUNWsamfs/sbin/chmed [-b] -vsn vsn specifier /opt/SUNWsamfs/sbin/chmed [-b] -mtype media specifier /opt/SUNWsamfs/sbin/chmed [-b] -I information specifier AVAILABILITY SUNWsamfs WARNING chmed sets or clears flags and values in a library catalog entry. These values are critical to the operation of the SAM-QFS environment and should be modified by administrators only in unusual circumstances. Administrators should exer- cise caution in using this powerful command, as there is no checking to ensure that the catalog remains consistent. OPTIONS This command accepts the following argument: -b Displays size in base 10 units. This command displays a modified catalog entry upon successful completion, size is displayed in base 2 units by default. ARGUMENTS These arguments are used in various combinations by the dif- ferent forms of the command. capacity is the total number of bytes that the volume can contain. The capacity may be specified with 'k', 'M', 'G', 'T', 'P', and 'E' multipliers. e.g. 2.43G or 0.7G. The updated capacity is interpreted in units of 1024k blocks. For example, if '1023' is specified, a value of 0k capacity is displayed. If '1023k' is specified, the updated capacity is displayed as 1023k. The space may also be specified in octal or hexadecimal using '0' or '0x' respectively. However, fractional values and multipliers are not allowed when using octal or hexade- cimal representation. For example, '0400000' or '0x800000'. count is the number of times a volume has been mounted since import, or the number of times a cleaning cartridge may be mounted before it is considered exhausted. eq gives the equipment number (as defined in the mcf file) for the robot being operated on. flags is a string of one or more of the following case- sensitive characters. Each character specifies one flag in the catalog entry. The characters are the same as the flags that are shown in the "flags" column of the robot VSN cata- log: A needs audit C slot contains cleaning cartridge E volume is bad or expired cleaning media N volume is not in SAM-QFS format R volume is read-only (software flag) U volume is unavailable W volume is physically write-protected X slot is an export slot b volume has a bar code c volume is scheduled for recycling f volume found full or foul by archiver d volume has a duplicate vsn l volume is labeled o slot is occupied p high priority volume NOTE: The f flag can mean that the volume is 100% full or that there is a problem with the tape. This can happen when a new tape is imported into the library with a partial label, or with a tape that does not have an EOD. I is an information field to hold information on a volume. A maximum of 128 characters is allowed and these characters must be enclosed in quotation marks. An example is: "Warehouse A, room 310, shelf 3" media specifies the media type. Valid values include (among others) mo and lt, for magneto-optical and DLT tape, respec- tively. See mcf(4) for the complete list of media types supported by SAM-QFS file systems. space is the total number of bytes remaining to be written on the volume. The space may be specified with 'k', 'M', 'G', 'T', 'P', and 'E' multipliers. e.g. 200.5M or 0.2005G. The updated space is interpreted in units of 1024k blocks. For example, if '1023' is specified, a value of 0k space is displayed. If '1023k' is specified, the updated space is displayed as 1023k. The space may also be specified in octal or hexadecimal using '0' or '0x' respectively. However, fractional values and multipliers are not allowed when using octal or hexade- cimal representation. For example, '0400000' or '0x800000'. specifier identifies the volume to be affected by the chmed command, in one of two forms: media_type.vsn or eq:slot[:partition]. time is the time the volume was last mounted in a drive. Several formats are allowed for time. Examples are: "2000-09-19"; "2000-07-04 20:31"; 23:05; "Mar 23"; "Mar 23 1994"; "Mar 23 1994 23:05"; "23 Mar"; "23 Mar 1994"; "23 Mar 1994 23:05". Month names may be abbreviated or spelled out in full. Time-of-day is given in 24-hour format. Years must use all four digits. If the time contains blanks, the entire time must be enclosed in quotation marks. vsn gives the VSN of the volume to be affected. DESCRIPTION The first form sets (+flags) and the second clears (-flags) the flags for for the given volume. The third and fourth forms set the capacity and space, respectively, for the given volume. The fifth form sets the last-mounted time for the volume. The sixth form sets the mount-count value for the volume. The final two forms sets the media type and vsn, respec- tively, for the given volume. FOREIGN MEDIA chmed can be used to modify existing catalog entries so that they denote so-called foreign media. Foreign media are those that are not in SAM-QFS format. The migration toolkit (SAMmigkit) provides hooks for the site to use to enable SAM-QFS file systems to stage (and optionally re-archive) data from the foreign media. When a foreign volume is imported to a library, it probably will not be found to have an ANSI-standard label. The volume's VSN will show as nolabel. The following chmed com- mands can be used to assign a media type, VSN, and foreign status to the volume (assuming it is in slot 5 of equipment 30): chmed -mtype lt 30:5 chmed -vsn TAPE1 30:5 chmed +N 30:5 If you have many foreign cartridges, you can use build_cat to bulk load a catalog. EXAMPLES chmed -RW lt.TAPE0 chmed +c lt.CYCLE chmed -capacity 19.5G lt.TAPE0 chmed -space 8.2G lt.TAPE0 chmed -time "Mar 23 10:15" lt.TAPE0 chmed -time "Nov 28 1991 10:15" lt.TAPE0 chmed -vsn TAPE1 30:5 SEE ALSO build_cat(1M), mcf(5), sam-recycler(1M), samu(1M)