HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

a
arrayfmt(1M) arrayfmt(1M)
NAME
arrayfmt - formats a LUN or an entire disk array.
SYNOPSIS
arrayfmt -L LUN [-V][-?
] array-id
arrayfmt -F [-h][-V
][-?] array-id
DESCRIPTION
arrayfmt formats the LUN (logical devices) identified by LUN or the entire disk array identified by
array-id.
WARNING: This is a destructive command. Data on the selected LUN or disk array will be destroyed fol-
lowing successful completion of this command. Backup all vital data before performing a format.
The array-id used to address the disk array can be the disk array serial number, the character device file
name of any LUN on the array (LUN 0 if no LUNs are created), or the alias text string assigned to the disk
array.
Options
arrayfmt supports the following options:
-F [ -h ] Format the entire disk array identified by array-id. By default, only disks currently
included in the array configuration will be formatted. If the
-h option is specified, all
disks installed in the cabinet will be formatted, even those that are not included in the
array configuration.
-L LUN Format the LUN specified by LUN.
-V Verbose mode displays additional command execution, state, and/or status messages.
-? Display expanded usage message. This option overrides all others.
EXTERNAL INFLUENCES
Environment Variables
LC_MESSAGES determines the language in which messages are displayed. The current language settings
can be checked with locale(1).
RETURN VALUE
arrayfmt returns the following values:
0 Successful completion.
1 An error in execution (I/O, subsystem, security, etc.) occurred.
2 An error in command syntax occurred: for example, an unknown command-line option was passed.
3 Timeout in communication to server. May indicate
ARMServer is not running.
DIAGNOSTICS
The following messages can be generated by
arrayfmt:
Usage: arrayfmt {-L LUN | -F [-h]} [-V] [-?] <array-id>
An error in command syntax has occurred. Re-enter the command with all necessary arguments.
arrayfmt: Arg out of range
One of the arguments has exceeded its maximum or minimum size, or is incorrect in form. Check the
size and form of each argument.
arrayfmt: Unknown argument
An invalid argument was specified. Check command usage.
arrayfmt: No such file or directory
The specified array-id does not exist or does not identify a disk array that is communicating with the
system. Verify the correct array-id with ioscan(1M).
arrayfmt: Error in command execution, <Additional Error Info>:
<Error Info Decode>
The command failed due to a device error, an internal error, or a system error. The Additional Error
Info and Error Info Decode fields will hold specifics about the failure and its cause.
Section 1M−−56 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005