HP StorageWorks Command View XP Advanced Edition Device Manager Agent Installation and Configuration Guide (December 2005)

Device Manager Agent Operations 49
Table 3-2 hldutil Command Syntax
Syntax
Component
Description
Synopsis For the device information display function:
hldutil [-d [device-file]|[-g [disk-group]|-l ldev#.ser#][-p] [-q] [-nolog] [-s sort-key...] [-k|-hf [log-file]|-h
[log-number]]
For the execution-result log file management function:
hldutil -h [log-number] -hb [log-file]| -hrm [log-number|all]| -history number
Description Hldutil provides device information display and execution results log file management functions. If
you do not specify an option, the command outputs information about all currently recognized
logical devices.
This command requires super user or Administrator privileges. If you execute the hldutil
command immediately after the host environment is changed (for example, when a logical unit is
added or deleted), the command might not be able to recognize the changed contents of the host.
Options -d [device-file]: If you want to view information about a specific logical device, specify the device
special file name (in Solaris™, AIX
®
, HP-UX, or Linux
®
) or disk number (in Windows
®
) of the
logical device. If you omit this option, the command displays information about all currently
recognized logical devices. You cannot specify the -d option and the -g or -l option at the same
time.
-g [disk-group]: If you want to view information about a specific disk group, specify the name of
the disk group. If you omit the disk group name, the command outputs information about all
currently defined disk groups. You cannot specify the -g option and the -d or -l option at the same
time.
-l ldev# ser#: If you want to view information about a specific logical device, specify the logical
device number (ldev#) and serial number (ser#) of the logical device. The logical device number
and serial number must be specified in the indicated order. If you omit the logical device number
or serial number, the command does not output information about the logical device. You cannot
specify the -l option and the -d or -g option at the same time. If you specify the -l option, the
display items output by the command with this option specified is limited to Ldev# (logical device
number). If you specify the -l option, the command displays only the following items:
ldev# (logical device number), ser#: (disk array device serial number), Device (device special file
or disk number), Dg name (disk group name), fs (file system)
-p: Specify this option when adding P-VOL and S-VOL information configured using the
Continuous Access or Business Copy to the logical device information. If no P-VOL or S-VOL
information is assigned to a logical device, the command with this option specified does not
output P-VOL or S-VOL information.
-q: Specify this option to output command execution results only to the execution-result log file. If
you specify this option, the command does not send its execution results to the standard output
(quiet mode). Typically, you specify this option when you want to run a background job to supply
the latest logical device information to the execution-result log file. However, error messages are
output to the standard error output.
-nolog: Specify this option to output command execution results only to the standard output. If
you specify this option, the execution-result log file is not updated.
-s sort-key: Specify this option when sorting logical device information in ascending order of
ASCII codes. This option includes one or more sort keys. When specifying multiple sort keys,
place a one-byte space between adjacent sort keys. If you specify multiple sort keys, the
command sorts information using the sort keys in the order in which they are specified. If you
specify the file system name as the sort key, the command sorts logical device information using
the file system name that is included in each logical device and assigned the lowest ASCII code.
If you do not specify a sort key or if you specify the same sort key more than once, you receive an
error message. If you do not specify the -s option, the command outputs logical device
information in the order in which it has processed the information. See
Table 3-3 for the sort key
descriptions.