unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 see(1M)							     see(1M)




 NAME
      see - access bytes in the HP SCSI disk array controller EEPROM

 SYNOPSIS
      see -d special

      see -b byte_number -h hex_byte device_file

 DESCRIPTION
      see displays, or changes bytes in the controller EEPROM of the HP SCSI
      disk array associated with device file device_file.  A 64-byte area in
      the EEPROM is accessible to the user.  Although the command is
      directed to a single LUN, the EEPROM settings affect all the LUNs of
      the device.

    Options
	   -d		   Display only.  Displays the current values of the
			   bytes in the accessible portion of the EEPROM.

	   -b byte_number -v hex_byte
			   Loads the hexadecimal value hex_byte into the
			   decimal byte byte_number of the user accessible
			   64-byte region in the EEPROM.

 BYTE DESCRIPTION
      The following list of user accessible bytes in the EEPROM, and their
      default values is provided for informational purposes only.  Changing
      the values can result in "incorrect" controller behavior with respect
      to HP SCSI disk array utilities, and other support software.  See
      WARNINGS.
























 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 see(1M)							     see(1M)




    _________________________________________________________________________
    | byte   meaning				 C2425/7 value	 C2430 value |
    |	 0   enable synchronous negotiation	     0x00	    0x00     |
    |	 1   enable wide negotiation		     0x00	    0x00     |
    |	 2   spin-up algorithm			     0x01	    0x01     |
    |	 3   spin-up delay			     0x32	    0x1e     |
    |	 4   ready timeout			     0x0a	    0x17     |
    |	 5   host command delay at power on	     0x00	    0x00     |
    |	 6   firmware drive cmd timeout value	     0x64	    0x64     |
    |	 7   default RAID level			     0x00	    0x05     |
    |	 8   option control bits MSB		     0x00	    0x00     |
    |	 9   option control bits LSB		     0x27	    0x53     |
    |	10   sense key for drive failures	     0x06	    0x06     |
    |	11   inquiry data byte 7		     0x12	    0x32     |
    |	12   ROM sequence control bits		     0x01	    0x01     |
    |	13   synchronization control bits	     0x02	    0x02     |
    |	14   inquiry revision level format	     0x00	    0x00     |
    |	15   diagnostic self-test options	     0x01	    0x01     |
    |	16   host command delay for bus reset	     0x00	    0x00     |
    |	17   inquiry unconfigured device type	     0x20	    0x20     |
    |	18   software command timeout value	     0x14	    0x14     |
    |	19   software command timeout actions	     0x07	    0x07     |
    |	20   drive bus reset to ready wait	     0x08	    0x08     |
    |	21   host delay after data phase	     0x00	    0x00     |
    |	22   drive scan disabled channel (MSB)	     0x00	    0x00     |
    |	23   drive scan disabled channel (LSB)	     0x00	    0x00     |
    |	24   time to asynchronous event		     0x00	    0x00     |
    |	25   fan polling interval		     0x00	    0x00     |
    |	26   power supply polling interval	     0x00	    0x00     |
    |	27   reserved				     0x00	    0x00     |
    |	28   Error Reporting Options (MSB)	     0x01	    0x01     |
    |	29   Error Reporting Options (LSB)	     0x00	    0x00     |
    |30-63   reserved				     0x00	    0x00     |
    |________________________________________________________________________|

 RETURN VALUE
      see returns the following values:

	    0	Successful completion.
	   -1	Command failed (an error occurred).

 DIAGNOSTICS AND ERRORS
      Errors can originate from problems with:

	   +  see

	   +  SCSI (device level) communications

	   +  system calls





 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 see(1M)							     see(1M)




    Error messages generated by see:
      usage: see <&lt&lt&lt;-d | -b <&lt&lt&lt;byteno>&gt&gt&gt; -v <&lt&lt&lt;hex byte>&gt&gt&gt;>&gt&gt&gt; <&lt&lt&lt;special>&gt&gt&gt;
	   An error in command syntax has occurred.  Re-enter command with
	   the required arguments, in the order shown.

      see: Arg out of range
	   One of the arguments has exceeded its maximum or minimum size, or
	   is incorrect in form.  Check the size and form of each argument.

      see: device busy
	   To ensure that see does not modify a disk array that is being
	   used by another process, see attempts to obtain exclusive access
	   to the disk array.  If the disk array is already opened by
	   another process (for example, LVM - the Logical Volume Manager),
	   a ``device busy'' error message is returned by the driver. To
	   eliminate the ``device busy'' condition, determine what process
	   has the device open. In the case of LVM, it is necessary to
	   deactivate the volume group containing the array before
	   configuring the array (see vgchange(1M)).

      see: LUN # too big
	   The LUN number, which is derived from the device special file
	   name, is out of range.

      see: LUN does not exist
	   The addressed LUN is not configured, and thus is not known to the
	   array controller.

      see: Not a raw file
	   Utilities must be able to open the device file for raw access.

      see: Not an HP SCSI disk array
	   The device being addressed is not an HP SCSI disk array.

      see: Transfer length error
	   The amount of data actually sent to or received from the device
	   was not the expected amount.

    SCSI (device level) communication errors:
      Sense data associated with the failed operation is printed.

    Error messages generated by system calls:
      see uses the following system calls:

		stat(), open(), close(), read(), write(), and ioctl().

      Documentation for these HP-UX system calls contains information about
      the specific error conditions associated with each call.	see does not
      alter the value of errno.	 The interpretation of errno for printing
      purposes is performed by the system utility strerror().




 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 see(1M)							     see(1M)




 EXAMPLES
      To display the values of the accessible EEPROM bytes on HP SCSI disk
      array /dev/rdsk/c2t6d0 on a Series 700:

	   see -d /dev/rdsk/c2t6d0

 WARNING
      Changing the values of EEPROM bytes can result in incorrect controller
      behavior with respect to utilities and support software that may not
      be immediately obvious.  Also, the EEPROM can only be written to a
      finite number of times, and if its write count is exceeded, it must be
      replaced.

 DEPENDENCIES
      The HP C2425 and HP C2427 disk arrays are only supported on Series 700
      systems running HP-UX version 9.0X.

      The HP C2430 disk array is supported on Series 700 and 800 systems
      running HP-UX versions 9.0X and 10.0X.

 AUTHOR
      see was developed by HP.
































 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000