scsimgr_estape(7)scsimgr_estape(7)NAMEscsimgr_estape - SCSI class driver estape plug-in for scsimgr
DESCRIPTION
The SCSI class driver plug-in for implements management and diagnostic
operations specific to classes of devices bound to driver is the native
HP-UX SCSI class driver that handles, by default, all tape devices.
The plug-in handles the following operations for driver estape:
· Display and clear driver global statistics and the statistics it
maintains on instances of LUNs bound to it, and on related LUN
paths.
· Display status and other information maintained by driver on LUNs
bound to it.
· Get, set and save driver global and per-lun instance attributes.
Commands
The user can explicitly send the following scsimgr commands to driver
plug-in by specifying the
Clears statistics.
Displays information on attributes.
Displays status and other information.
Displays statistics.
Saves value of attributes in a persistent store.
Set current values of attributes.
Note: Refer to scsimgr(1M) for syntax of the above commands.
However, the only instances where it is necessary to explicitly send a
command to the plug-in is when performing operations on objects global
to driver global statistics, attributes or status information. In all
the other cases, automatically invokes the plug-in to perform the
driver specific part of the operation, when the operation applies to
LUNs bound to driver estape or to their LUN paths.
Attributes
The following table lists driver estape specific attributes. For
details on the concept of attribute refer to scsimgr(1M).
Note: The following conventions are used:
· RO is Read Only.
· RW is Read Write.
· VBM is Variable Block Mode.
· uint32 is unsigned 32 bits integer.
· uint64 is unsigned 64 bits integer.
· Range of values for applicable attributes is listed.
───────────────────────────────────────────────────────────────────────
Object Attribute Name RO/RW Type Description
───────────────────────────────────────────────────────────────────────
Global version RO string Version of driver estape
───────────────────────────────────────────────────────────────────────
norewind_ RW uint32 Disables the ability to
close_disabled open a "rewind" device.
Default: 0
Values: 0 (disabled)
1 (enabled).
Note: This tunable was
named "st_san_safe" in
releases prior to HP-UX
11i v3.
───────────────────────────────────────────────────────────────────────
st_ats_enable RW uint32 Determines whether to
reserve the device on
open and release on
close. See
st_ats_enable(5).
Default: 0
Values: 0 (disabled)
1 (enabled).
Note: This tunable was
named "st_ats_enabled" in
releases prior to HP-UX
11i v3.
───────────────────────────────────────────────────────────────────────
LUN default_secs RW uint32 Timeout for all commands
not referenced below.
Default: 60
───────────────────────────────────────────────────────────────────────
space_secs RW uint32 Timeout for the space
command.
Default: 1200
───────────────────────────────────────────────────────────────────────
write_secs RW uint32 Timeout for the write
command.
Default: 600
───────────────────────────────────────────────────────────────────────
read_secs RW uint32 Timeout for the read com‐
mand.
Default: 1200
───────────────────────────────────────────────────────────────────────
unload_secs RW uint32 Timeout for the unload
command.
Default: 600
───────────────────────────────────────────────────────────────────────
rewind_secs RW uint32 Timeout for the rewind
command.
Default: 600
───────────────────────────────────────────────────────────────────────
erase_secs RW uint32 Timeout for the erase
command.
Default: 18000
───────────────────────────────────────────────────────────────────────
mt_type RW uint32 The type of device a par‐
ticular LUN is associated
with.
Default: 0
Values:
0 = unknown,
5 = HPIB 9-track
6 = DDS1
7 = All other DDS/DAT
8 = Scsi 9-track
9 = QIC
10 = 8mm
11 = IBM 3480, STK 9XXX,
STK T10000
12 = Quantum DLT
13 = Sony AIT
14 = IBM 3590
15 = LTO
───────────────────────────────────────────────────────────────────────
default_block‐ RW uint32 Default blocksize.
size Default: 0
0 = variable, overridden
by a custom DSF.
───────────────────────────────────────────────────────────────────────
default_ir RW uint32 Default immediate report‐
ing.
Default: 1
Values: 0 (disabled)
1 (enabled)
───────────────────────────────────────────────────────────────────────
close_marks RW uint32 Number of filemarks to
indicate End of Data.
Default: 2
───────────────────────────────────────────────────────────────────────
num_partitions RW uint32 Number of partitions sup‐
_supp ported
Default: 1
Range: 1+
───────────────────────────────────────────────────────────────────────
characteristics RW uint64 Driver characteristics
bitwise or'd together
Default: 0
1 = Device supports set‐
marks
2 = Logpage 31 contains
capacity information
4 = Logpage 38 contains
capacity information
8 = Device supports
Reserve/Release
───────────────────────────────────────────────────────────────────────
best_density RW uint32 Tape Density to write.
Default: 0x7f
0xFFFFFFFF = Best Density
0x00 = Let the device
choose the density
0x7f = Do not modify tape
density.
other = a valid density
code for the Mode Parame‐
ter Block Descriptor.
───────────────────────────────────────────────────────────────────────
best_compression RW uint32 Compression Algorithm to
use
Default: 0
0x00 = Compression Dis‐
abled
0xDEF = default for drive
other = a valid compres‐
sion value for the Data
Compression Mode Page
(0x0F).
───────────────────────────────────────────────────────────────────────
clean_req_ RW uint32 The Key/Code/Qualifier
sns_info representing "Cleaning
Required"
Default: 0xffffffff
───────────────────────────────────────────────────────────────────────
Device Set space_secs RW uint32 Timeout for the space
command.
Default: 1200
───────────────────────────────────────────────────────────────────────
default_secs RW uint32 Timeout for all commands
not referenced below.
Default: 60
───────────────────────────────────────────────────────────────────────
write_secs RW uint32 Timeout for the write
command.
Default: 600
───────────────────────────────────────────────────────────────────────
read_secs RW uint32 Timeout for the read com‐
mand.
Default: 1200
───────────────────────────────────────────────────────────────────────
unload_secs RW uint32 Timeout for the unload
command.
Default: 600
───────────────────────────────────────────────────────────────────────
rewind_secs RW uint32 Timeout for the rewind
command.
Default: 600
───────────────────────────────────────────────────────────────────────
erase_secs RW uint32 Timeout for the erase
command.
Default: 18000
───────────────────────────────────────────────────────────────────────
default_ir RW uint32 Default immediate report‐
ing.
Default: 1
Values: 0 (disabled)
1 (enabled)
───────────────────────────────────────────────────────────────────────
default_block‐ RW uint32 Default blocksize.
size Default: 0
0 = variable, overridden
by a custom DSF.
───────────────────────────────────────────────────────────────────────
num_partitions RW uint32 Number of partitions sup‐
_supp ported
Default: 1
Range: 1+
───────────────────────────────────────────────────────────────────────
best_density RW uint32 Tape Density to write.
Default: 0x7f
0xFFFFFFFF = Best Density
0x00 = Let the device
choose the density
0x7f = Do not modify tape
density.
other = a valid density
code for the Mode Parame‐
ter Block Descriptor.
───────────────────────────────────────────────────────────────────────
best_compression RW uint32 Compression Algorithm to
use
Default: 0
0x00 = Compression Dis‐
abled
0xDEF = default for drive
other = a valid compres‐
sion value for the Data
Compression Mode Page
(0x0F).
───────────────────────────────────────────────────────────────────────
mt_type RW uint32 The type of device a par‐
ticular LUN is associated
with.
Default: 0
Values:
0 = unknown,
5 = HPIB 9-track
6 = DDS1
7 = All other DDS/DAT
8 = Scsi 9-track
9 = QIC
10 = 8mm
11 = IBM 3480, STK 9XXX,
STK T10000
12 = Quantum DLT
13 = Sony AIT
14 = IBM 3590
15 = LTO
───────────────────────────────────────────────────────────────────────
I/O Load Balancing and Multi-Pathing Policies
The driver uses method as load balancing policy and has minimal support
for multi-pathing.
When the device is first opened after a system boot, a path is chosen
and will remain fixed. If the path fails, the new path will be picked
on next open only. But with the support of the attribute beginning in
the HP-UX 11i v3 March 2009 Update, it lets users select a lunpath
among available lunpaths to the device, which will be locked down and
I/O's will be issued on the newly selected lunpath.
Refer to the attribute table in scsimgr(1M) for more information on the
attribute.
Block size limitation for Backup/Restore Applications
The block size in HP-UX 11i v3 SCSI driver is the physical block size
on the tape. The driver gets this block size from the Mass Storage
Stack. The actual block size is determined as the smallest value of
attribute and the maximum I/O sizes reported by interface drivers on
LUN paths of the LUN.
For more details on refer to scsimgr(1M).
To know about the maximum I/O size supported by the card, refer the
technical specifications of the I/O card.
Warning: Applications that use block size greater than this negotiated
value to issue writes will have their writes broken down by the driver
to the actual block size and then written on to the tape. This step of
breaking down a single block to multiple blocks of smaller block size
may lead to inconsistencies during some of the tape operations. For
example, an application positioning on tape and using the original
application block size might lose track of its correct position assum‐
ing it had no visibility of the actual block size. Also READ operations
by an unaware application would be at the incorrect block size.
Application designers/developers are highly encouraged to consider this
limitation and ensure that the block size used is less than or equal to
the actual value of the block size.
EXAMPLES
To display plug-in general help and supported commands:
To get driver global statistics:
To clear driver global statistics:
To get driver global status information:
To display information about driver global attributes:
AUTHOR
SCSI class driver plug-in for was developed by Hewlett Packard Company.
SEE ALSOscsictl(1M), scsimgr(1M), norewind_close_disabled(5), st_ats_enable(5),
intro(7), scsi(7), scsi_tape(7).
scsimgr_estape(7)