pscan - scan an HP SCSI disk array LUN for parity consistency
pscan -s system_state device_file
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
pscan returns the following values:
0 Successful completion.
-1 Command failed (an error occurred).
DIAGNOSTICS AND ERRORS
Errors can originate from problems with:
+ SCSI (device level) communications
+ system calls
Error messages generated by pscan:
usage: pscan -s <<<<system_state>>>> <<<<special>>>>
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
Hewlett-Packard Company - 1 - HP-UX Release 11i: November 2000
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().
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
pscan -s 0 /dev/rdsk/c2t0d2
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.
pscan was developed by HP.
Hewlett-Packard Company - 2 - HP-UX Release 11i: November 2000