unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 dsp(1M)							     dsp(1M)




 NAME
      dsp - display status of an HP SCSI disk array

 SYNOPSIS
      dsp -p [-h|-d] device_file

      dsp -l [-h|-d] device_file

 DESCRIPTION
      dsp displays the status of the LUN (in an HP SCSI disk array) that is
      associated with the device file device_file.  dsp displays the status
      of physical drives in an array (when the -p option is specified), or
      the status of LUNs in an array (when the -l option is specified).
      This information can be displayed in interpreted form, or in raw
      hexadecimal or raw decimal format.

    Options
	   -p		  Display physical drive status.  The -p option
			  displays the status of a LUN's physical drives,
			  regardless of their LUN ownership.  This
			  information is retrieved the array physical page
			  (Mode Page 2A), and inquiry data.

	   -l		  Display LUN status.  The -l option displays
			  information about the state of the LUN including
			  it's RAID level, block and segment sizes,
			  reconstruction information, and so on.  This
			  information is retrieved from the array logical
			  page (Mode Page 2B), and inquiry data.

	   By default, data is displayed in interpreted form; if raw data is
	   desired, one of the following options can be used:

	   -h		  Raw hex format.  Displays the data in raw hex
			  format in rows, each of which contains the ASCII
			  representation of 16 hexadecimal data bytes,
			  separated by spaces.

	   -d		  Raw decimal format.  Displays the data in raw
			  decimal format in rows, each of which contains the
			  ASCII representation of 16 decimal data bytes,
			  separated by spaces.

 RETURN VALUE
      dsp returns the following values:

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

 DIAGNOSTICS AND ERRORS
      Errors can originate from problems with:



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






 dsp(1M)							     dsp(1M)




	   +  dsp

	   +  SCSI (device level) communications

	   +  system calls

    Error messages generated by dsp:
      usage: dsp <&lt&lt&lt;-p | -l>&gt&gt&gt; [-h | -d] <&lt&lt&lt;special>&gt&gt&gt;
	   An error in command syntax has occurred.  Enter the command again
	   with all required arguments.

      dsp: Arg out of range
	   One of the arguments is larger than its allowed maximum value (or
	   smaller than its allowed minimum value), or is incorrect in form.
	   Check the size and form of each argument and make appropriate
	   corrections.

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

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

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

      dsp: LUN does not exist
	   The requested LUN is not among those known to the controller.

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

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

    Error messages generated by system calls:
      dsp 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.	dsp does not
      alter the value of errno.	 The interpretation of errno for printing
      purposes is performed by the system utility strerror().

 EXAMPLES
      To display the status of the drives on the HP SCSI disk array
      /dev/rdsk/c2t4d0 on a Series 700:




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






 dsp(1M)							     dsp(1M)




	   dsp -p /dev/rdsk/c2t4d0

      To display the status of the LUN associated with the HP SCSI disk
      array /dev/rdsk/c2t0d0 on a Series 800 in raw hex format:

	   dsp -l -h /dev/rdsk/c2t0d0

      To display the status of the drives on the HP SCSI disk array
      /dev/rdsk/c2t5d0 in raw decimal format on a Series 700:

	   dsp -p -d /dev/rdsk/c2t5d0

 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
      runing HP-UX versions 9.0X and 10.0X.

 AUTHOR
      dsp was developed by HP.

































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