scsimgr_estape man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

scsimgr_estape(7)					     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:

	  · 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 ALSO
       scsictl(1M), scsimgr(1M), norewind_close_disabled(5), st_ats_enable(5),
       intro(7), scsi(7), scsi_tape(7).

							     scsimgr_estape(7)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net