HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

p
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 <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 associ-
ated with each call. pscan does not alter the value of errno. The interpretation of errno for print-
ing 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
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−685