scsimgr_estape(7) Miscellaneous Information Manual scsimgr_estape(7)
NAME
scsimgr_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:
o Display and clear driver global statistics and the statistics it maintains on instances of LUNs bound to it, and on related LUN paths.
o Display status and other information maintained by driver on LUNs bound to it.
o 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:
o RO is Read Only.
o RW is Read Write.
o VBM is Variable Block Mode.
o uint32 is unsigned 32 bits integer.
o uint64 is unsigned 64 bits integer.
o 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
-------------------------------------------------------------------
I/O Load Balancing and Multi-Pathing Policies
The driver does not support load balancing 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 next open will pick a
new path.
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 ALSO
scsictl(1M), scsimgr(1M), norewind_close_disabled(5), st_ats_enable(5), intro(7), scsi(7), scsi_tape(7).
scsimgr_estape(7)
