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:
SCSI
(device level) communications
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.
