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 Oracle HSM environment and should be modified by administrators only in unusual circumstances. Administrators should exercise 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 different 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. For example:

2.43G
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 capacity 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 hexadecimal representation. For example:

0400000
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 catalog:

A: needs audit
C: slot contains cleaning cartridge
E: volume is bad or expired cleaning media
L: volume is a Linear Tape File System (LTFS) volume
N: volume is not in Oracle HSM format
R: volume is read-only (software flag)
S: volume is migration source and migration is underway
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
e: volume is migration source and failed to migrate
f: volume found full or foul by archiver
d: volume has a duplicate vsn
l: volume is labeled
m: volume is migration source and has finished migration
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, respectively. See mcf (4) for the complete list of media types supported by Oracle HSM 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 hexadecimal representation. For example:

0400000
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, respectively, 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 Oracle HSM format. The migration toolkit (SAMmigkit) provides hooks for the site to use to enable Oracle HSM 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 commands 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.

LTFS MEDIA

An existing catalog entry can be changed to add or remove a LTFS designation.

For a volume to be considered as LTFS media, its catalog entry must indicate that: 1) it is unlabeled, 2) it is non-SAM, 3) it is marked as LTFS, and 4) it must be formatted with a LTFS file system.

To mark LTO tape SQL519 as LTFS media, the following commands would be used:

chmed -l li.SQL519
      chmed +N li.SQL519
      samltfs mkltfs li.SQL519

To change Titanium LTFS tape SQT203 to Oracle HSM usage, execute the following:

samltfs unltfs ti.SQT203
      chmed -N ti.SQT203
      tplabel -vsn SQT203 -new ti.SQT203

Like foreign media, if you have many LTFS volumes, 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