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 <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 array controller. 

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  —  HP-UX Release 10.20:  July 1996