scsimgr_estape(7)

NAME

scsimgr_estape — SCSI class driver estape plug-in for scsimgr

DESCRIPTION

The SCSI class driver estape plug-in for scsimgr implements management and diagnostic operations specific to classes of devices bound to driver estape. estape 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 estape 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 estape on LUNs bound to it.
Get, set and save driver estape global and per-lun instance attributes.

Commands

The user can explicitly send the following scsimgr commands to driver estape plug-in by specifying the -d estape option:

clear_stat: Clears statistics.
get_attr: Displays information on attributes.
get_info: Displays status and other information.
get_stat: Displays statistics.
save_attr: Saves value of attributes in a persistent store.
set_attr: 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 estape: global statistics, attributes or status information. In all the other cases, scsimgr 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_` `close_disable`	`RW`	`uint32`	Disables the ability to open a "rewind" device. Default: 0. Values: 0 (disabled), 1 (enabled).
	`st_ats_enabled`	`RW`	`uint32`	Determines whether to reserve the device on open and release on close. See st_ats_enabled(5). Default: 1. Values: 0 (disabled), 1 (enabled).
`LUN`	`default_secs`	`RW`	`uint32`	Timeout for all commands not referenced below. Default: 30.
	`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 command. Default: 600.
	`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 particular 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_blocksize`	`RW`	`uint32`	Default blocksize. Default: 0. Values: 0 = variable, overridden by a custom DSF.
	`default_ir`	`RW`	`uint32`	Default immediate reporting. Default: 1. Values: 0 (disabled), 1 (enabled).
	`close_marks`	`RW`	`uint32`	Number of filemarks to indicate End of Data. Default: 2.
	`num_partitions` `_supp`	`RW`	`uint32`	Number of partitions supported Default: 1. Range: 1+
	`characteristics`	`RW`	`uint64`	Driver characteristics bitwise ORed together Default: 0. Values: 1 = Device supports setmarks, 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. Values: 0xFFFFFFFF = Best density, 0x00 = Let the device choose the density, 0x7F = Do not modify tape density, other = a valid density code for the Mode Parameter Block Descriptor.
	`best_compression`	`RW`	`uint32`	Compression Algorithm to use. Default: 0. Values: 0x00 = Compression Disabled, 0xDEF = default for drive, other = a valid compression value for the Data Compression Mode Page (0x0F).
	`clean_req_` `sns_info`	`RW`	`uint32`	The Key/Code/Qualifier representing "Cleaning Required" Default: 0xFFFFFFFF.

I/O Load Balancing and Multipathing Policies

The estape driver does not support load balancing and has minimal support for multipathing.

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 scsimgr estape plug-in general help and supported commands:

scsimgr -h -d estape 

To get estape driver global statistics:

scsimgr get_stat -d estape 

To clear estape driver global statistics:

scsimgr clear_stat -d estape 

To get estape driver global status information:

scsimgr get_info -d estape 

To display information about estape driver global attributes:

scsimgr get_attr -d estape 

AUTHOR

SCSI class driver estape plug-in for scsimgr was developed by HP.

scsimgr_estape(7)

Technical documentation

» Table of Contents

» Index