HP ProLiant SL4545 HP Scripting Toolkit 9.30 for Windows User Guide - Page 23

Using HWQUERY, HWQUERY command-line syntax, HWQUERY return codes

Page 23 highlights

Expression input HWQ:SystemName eq "ProLiant DL380 G2" and "PCI:Smart Array 5i" and HWQ:ROMDate eq "11/12/2004" Result True if the system is a ProLiant DL380 G2 with a Smart Array 5i Controller present and a ROM date of 11/12/2004 "PCI:Smart Array 5i" or "PCI:Smart Array True if the system contains a Smart Array 5i Controller or 6i" a Smart Array 6i Controller Using HWQUERY HWQUERY is used from a script, in conjunction with other utilities, to control the deployment. The HWQUERY utility enables you to use data from the hardware discovery file in your own scripts. HWQUERY cannot alter environment variables directly. To set the variable, the output of HWQUERY must be used by the hosting script. The most common way to use it is to write the output to an intermediate script that is subsequently called by the hosting script. HWQUERY command-line syntax hwquery [drive:][path]hpdiscoveryfilename [drive:][path]allboards.xml variable= ... HWQUERY command line arguments Command-line argument [drive:][path]hpdiscoveryfilename [drive:][path]allboards.xml variable= ... Description This argument specifies the hardware discovery file used to run the query. This argument specifies the allboards.xml PCI device list file, which is used to convert PCI IDs found in hardware discovery into device names, such as "Smart Array 5i Controller." In this argument, variable is the name of an environment variable and is a PCI device name or the name of an element from the hardware discovery file. Arguments must be in quotes if contains spaces. is case-sensitive. You can specify multiple variable= arguments. HWQUERY return codes Value 0 n HWQUERY command-line examples Meaning The command was completed successfully. N arguments were ignored because they were not in the variable= format. Command-line argument hwquery hpdiscovery.xml allboards.xml MY_SYS_RAM=TotalRAM Description For a hpdiscovery.xml file that contains 768, HWQUERY produces the following: Using HWQUERY 23

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62

Result
Expression input
True if the system is a ProLiant DL380 G2 with a Smart
Array 5i Controller present and a ROM date of
11/12/2004
HWQ:SystemName eq
"ProLiant DL380 G2" and "PCI:Smart Array
5i" and HWQ:ROMDate eq "11/12/2004"
True if the system contains a Smart Array 5i Controller or
a Smart Array 6i Controller
"PCI:Smart Array 5i" or "PCI:Smart Array
6i"
Using HWQUERY
HWQUERY is used from a script, in conjunction with other utilities, to control the deployment. The
HWQUERY utility enables you to use data from the hardware discovery file in your own scripts.
HWQUERY cannot alter environment variables directly. To set the variable, the output of HWQUERY
must be used by the hosting script. The most common way to use it is to write the output to an
intermediate script that is subsequently called by the hosting script.
HWQUERY command-line syntax
hwquery [
drive:
][
path
]hpdiscoveryfilename
[
drive:
][
path
]allboards.xml
variable
=<
string
> ...
HWQUERY command line arguments
Description
Command-line argument
This argument specifies the hardware discovery file used
to run the query.
[drive:][path]hpdiscoveryfilename
This argument specifies the
allboards.xml
PCI device
list file, which is used to convert PCI IDs found in hardware
[drive:][path]allboards.xml
discovery into device names, such as "Smart Array 5i
Controller."
In this argument,
variable
is the name of an environment
variable and <
string
> is a PCI device name or the name
variable=<string>
of an element from the hardware discovery file. Arguments
must be in quotes if <string> contains spaces. <
string
> is
case-sensitive.
You can specify multiple
variable
=<
string
> arguments.
...
HWQUERY return codes
Meaning
Value
The command was completed successfully.
0
N
arguments were ignored because they were not in the
variable=<string>
format.
n
HWQUERY command-line examples
Description
Command-line argument
For a
hpdiscovery.xml
file that contains
<TotalRAM>768</TotalRAM>, HWQUERY produces the
following:
hwquery hpdiscovery.xml allboards.xml
MY_SYS_RAM=TotalRAM
Using HWQUERY
23