Use the chdev
command to change the attributes of a configured tape drive or library. Use the mkdev command to configure a device.
See Also:
"Device Commands" for related commandsYou must have the modify administrative domain's configuration right to use the chdev
command.
Use the following syntax to reconfigure a tape drive.
chd•ev [ --attach/-a aspec[,aspec]... ] [ --addattach/-A aspec[,aspec]... ] [ --rmattach/-R aspec[,aspec]... ] [ --inservice/-o | --notinservice/-O ] [ --wwn/-W wwn ] [ --library/-l devicename ] [ --dte/-d dte ] [ --blockingfactor/-f bf ] [ --maxblockingfactor/-F maxbf ] [ --automount/-m { yes | no } ] [ --erate/-e erate ] [ --current/-T se-spec ] [ --uselist/-u se-range ] [ --usage/-U duration ] [ --queryfreq/-q queryfrequency ] [ --serial/-N serial-number ] [ --model/-L model-name ] devicename ...
Use the following syntax to reconfigure a tape library.
chd•ev [ --attach/-a aspec[,aspec]... ] [ --addattach/-A aspec[,aspec]... ] [ --rmattach/-R aspec[,aspec]... ] [ --inservice/-o | --notinservice/-O ] [ --wwn/-W wwn ] [ --autoclean/-C { yes | no } ] [ --cleanemptiest/-E { yes | no } ] [ --cleaninterval/-i { duration | off } ] [ --barcodereader/-B { yes | no | default } ] [ --barcodesrequired/-b { yes | no } ] [ --unloadrequired/-Q { yes | no } ] [ --serial/-N serial-number ] [ --model/-L model-name ] devicename ...
The following options enable you to reconfigure a tape drive or library. Refer to "mkdev" for descriptions of options not included in this section.
Adds a device attachment for a tape drive or library. Refer to "aspec" for a description of the aspec placeholder.
Removes a device attachment for a tape drive or library. Refer to "aspec" for a description of the aspec placeholder.
Specifies the amount of time a drive has been used since it was last cleaned. Refer to "duration" for a description of the duration placeholder.
The mkdev command enables you to request a cleaning cycle for a specific interval. Specify the --usage
option on chdev
to initialize the configured interval to reflect drive usage since the last cleaning.
Specifies the name of the library or tape drive to be reconfigured. Refer to "devicename" for the rules governing device names.
Example 2-18 reconfigures tape drive tape1
in library lib1
. The chdev
command specifies the following:
The tape drive is in service.
The error rate is 16 (the default is 8).
The blocking factor is 256, which means that obtool
writes blocks of size 128K.
Tapes can be automounted.
Note that the command line has been reformatted to fit on the page.
Example 2-18 Reconfiguring a Tape Drive
ob> lsdev --long tape1 tape1: Device type: tape (virtual) Model: [none] Serial number: [none] In service: yes Library: lib1 DTE: 1 Automount: yes Error rate: 8 Query frequency: [undetermined] Debug mode: no Blocking factor: (default) Max blocking factor: (default) Current tape: 4 Use list: all Drive usage: 33 seconds Cleaning required: no UUID: 42e073da-5a39-1028-92bf-000cf1d9be50 Attachment 1: Host: brhost3 Raw device: /dev/tape1 ob> chdev --type tape --erate 16 --blockingfactor 256 --maxblockingfactor 256 tape1
Example 2-19 reconfigures a tape library called lib1
. The chdev
command specifies the following:
The tape library is in service.
There is no barcode reader.
The interval between automatic cleaning cycles is 30 hours.
obtool
should use the fullest cleaning tape for cleaning.
Note that the command line has been reformatted to fit on the page.
Example 2-19 Reconfiguring a Tape Library
ob> lsdev --long --nohierarchy lib1 lib1: Device type: library Model: [none] Serial number: [none] In service: yes Debug mode: no Barcode reader: default (hardware-selected) Barcodes required: no Auto clean: no Clean interval: (not set) Clean using emptiest: no UUID: f088f234-8d46-1027-90e1-000cf1d9be50 Attachment 1: Host: brhost3 Raw device: /dev/lib1 ob> chdev --type library --inservice --barcodereader no --barcodesrequired no --autoclean yes --cleanemptiest no --cleaninterval 30hours lib1 ob> lsdev --long --nohierarchy lib1 lib1: Device type: library Model: [none] Serial number: [none] In service: yes Debug mode: no Barcode reader: no Barcodes required: no Auto clean: yes Clean interval: 30hours Clean using emptiest: yes UUID: f088f234-8d46-1027-90e1-000cf1d9be50 Attachment 1: Host: brhost3 Raw device: /dev/lib1