unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 pscan(1M)							   pscan(1M)




 NAME
      pscan - scan an HP SCSI disk array LUN for parity consistency

 SYNOPSIS
      pscan -s system_state device_file

 DESCRIPTION
      pscan is a front end script to scn designed to be called during system
      bootup and shutdown.  It stores information on the disk array used to
      indicate improper system shutdown.  If the system was not properly
      shutdown, a parity scan is initiated when the system boots.  The
      values of 0 (operating system booting), and 1 (operating system
      shutdown) are expected for system_state.	device_file refers to the
      device file associated with the selected disk array.  If multiple
      hosts (initiators) are connected to the disk array, the file
      /etc/hpC2400/pscan.initiators needs to be created.  This file will
      contain an integer value from 1 to 8.  If the file is not created,
      pscan will assume that only one host (initiator) is connected to the
      disk array.

 RETURN VALUE
      pscan returns the following values:

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

 DIAGNOSTICS AND ERRORS
      Errors can originate from problems with:

	   +  pscan

	   +  SCSI (device level) communications

	   +  system calls

    Error messages generated by pscan:
      usage: pscan -s <&lt&lt&lt;system_state>&gt&gt&gt; <&lt&lt&lt;special>&gt&gt&gt;
	   An error in command syntax has occurred.  Enter command again
	   with all required arguments, in the order shown.

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

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

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




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






 pscan(1M)							   pscan(1M)




      pscan: 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:
      pscan uses the following system calls:

	   malloc(), free(), stat(), open(), close(), fopen(), fclose(),
	   read(), write(), and ioctl().

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

 EXAMPLES
      To call pscan on the LUN /dev/rdsk/c2t0d2 prior to a system shutdown
      on a series 800:

	   pscan -s 1 /dev/rdsk/c2t0d2

      To call pscan on the LUN /dev/rdsk/c2t0d2 during a system bootup on a
      series 700:

	   pscan -s 0 /dev/rdsk/c2t0d2

 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
      pscan was developed by HP.

















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