HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
p
pscan(1M) pscan(1M)
NAME
pscan - scan anHP 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 Release 11i: December 2000 − 1 − Section 1M−−651
___
___