chmed(1M)

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)