chmed - Set or clear library catalog flags and values
∕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
SUNWsamfs
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.
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.
These arguments are used in various combinations by the different forms of the command.
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
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.
gives the equipment number (as defined in the mcf file) for the robot being operated on.
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.
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
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.
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
identifies the volume to be affected by the chmed
command,
in one of two forms: media_type.vsn or eq:slot[:partition].
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.
gives the VSN of the volume to be affected.
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.
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.
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.
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