icod_stat(1M) icod_stat(1M)
NAME [Toc] [Back]
icod_stat - Display instant Capacity on Demand (iCOD) status and
system information.
SYNOPSIS [Toc] [Back]
Path: /usr/sbin
icod_stat
icod_stat -s
DESCRIPTION [Toc] [Back]
The icod_stat command displays the status and system information on an
iCOD system. For further information see the iCOD User's Guide
located at /usr/share/doc/icodUserGuide.pdf.
If no options are specified icod_stat displays:
Software version:
This field displays the version of the iCOD client software.
System ID:
This field displays the user-specified system identifier
that the iCOD system uses when reporting the system state to
HP, and when HP refers to this system in correspondence to
the system contact. The default value for this field is the
hostname of the iCOD system. To change this value, use the
icod_modify -i command (see icod_modify(1M)).
Serial number:
This field displays the iCOD complex's hardware serial
number.
Product number:
This field displays the iCOD complex's hardware product
number.
Unique ID:
This field displays a unique identifier for the iCOD system
(generated by HP).
System contact e-mail:
This field displays the e-mail address for the person who
should receive configuration change notification and
exception reports. This field is set via the icod_modify -c
command.
From e-mail:
This field displays the e-mail address that will be
specified as the sender of all iCOD initiated e-mail
correspondence. This field is set via the icod_modify -f
Hewlett-Packard Company - 1 - iCOD version B.06.01: March 2004
icod_stat(1M) icod_stat(1M)
command. If not set, e-mail will be sent from the adm user
on the local system.
Asset reporting:
This field indicates if the iCOD software is presently
configured to send e-mail asset reports to HP.
Exception status:
This field indicates if the complex is presently in an
exception state. A complex is in an exception state when
the number of active components of a given type (processors,
cells, memory) exceeds the number of licensed components of
the given type.
Information displayed for the local virtual partition [Toc] [Back]
The following status is displayed when icod_stat is run on a virtual
partition:
Assigned processors:
This field displays the total number of processors assigned
to the local virtual partition.
Active assigned processors:
This field displays the number of assigned processors in the
local virtual partition that are currently active.
Inactive assigned processors:
This field displays the number of assigned processors in the
local virtual partition that are currently inactive.
Licensed processors that can be assigned:
This field displays the number of licensed unassigned
processors in the hard partition that are not currently
assigned to any virtual partition and can be instantly
assigned.
Processors that can be assigned if licensed:
This field displays the number of unlicensed processors that
are immediately available for licensing and assignment.
Processors that cannot immediately be assigned:
This field displays the number of unassigned processors
(licensed or unlicensed) in the hard partition that are not
assigned to the local virtual partition and cannot be
instantly assigned. Bound processors at the time the local
virtual partition booted, if unbound later, cannot be
instantly assigned to the local virtual partition without an
intervening reboot (subject to license limitations). This
number will also include CPUs in inactive cells and
deconfigured CPUs.
Hewlett-Packard Company - 2 - iCOD version B.06.01: March 2004
icod_stat(1M) icod_stat(1M)
Information displayed for the local hard partition [Toc] [Back]
Total processors:
This field displays the number of processors physically
present in the hard partition.
Intended active processors:
This field displays the number of processors requested to be
active for this hard partition via the icod_modify command.
Active processors:
This field displays the current number of processors active
in the hard partition.
Licensed processors that can be activated:
This field displays the number of licensed processors that
are immediately available for activation. This information
is not displayed on a virtual partition.
Processors that can be activated if licensed:
This field displays the number of unlicensed processors that
are available for licensing and subsequent activation.
These processors are also available for temporary activation
if temporary capacity is available. This information is not
displayed on a virtual partition.
Inactive processors that cannot immediately be activated:
This field displays the number of processors (licensed or
unlicensed) that cannot be activated by iCOD software. This
includes CPUs in inactive cells, deconfigured processors,
and failed processors deactivated due to LPMCs (Low Priority
Machine Checks). This information is not displayed on a
virtual partition.
Global iCOD information [Toc] [Back]
The following status is displayed for the entire complex:
iCOD cells:
This field displays the number of unlicensed cells in the
complex. Unlicensed cells are expected to be inactive.
Actual inactive cells:
This field displays the current number of inactive cells in
the complex.
iCOD processors:
This field displays the total number of unlicensed
processors in the complex. Unlicensed processors are
expected to be inactive.
Actual inactive processors:
This field displays the current number of inactive
Hewlett-Packard Company - 3 - iCOD version B.06.01: March 2004
icod_stat(1M) icod_stat(1M)
processors in the complex.
iCOD memory:
This field displays the total amount of unlicensed memory in
the complex. Unlicensed memory is expected to be inactive.
Actual inactive memory:
This field displays the current amount of inactive memory in
the complex.
Temporary capacity available:
This field displays the amount of temporary capacity
available. This balance is displayed in CPU days, hours,
and minutes.
Processors using temporary capacity:
This field displays the number of processors presently
consuming temporary capacity.
Projected temporary capacity expiration:
This field displays the date and time that temporary
capacity is projected to expire at the present consumption
rate.
Allocation of iCOD Resources Among Partitions [Toc] [Back]
The following table displays how iCOD components are distributed among
the partitions in the complex:
nPar ID:
This field displays the partition number for the row of
data.
Inactive Cells:
This field displays the current number of inactive cells in
the hard partition.
Inactive Memory:
This field displays the current amount of inactive memory in
the hard partition.
Inactive CPUs:
This field displays the current number of inactive
processors in the hard partition.
nPar Name:
This field displays the partition name corresponding to the
row of information that is displayed. If the row is the
local partition, the word "local" will follow the partition
name. For cells that are not assigned to partitions, the
"Unassigned Cells" label will be displayed.
Hewlett-Packard Company - 4 - iCOD version B.06.01: March 2004
icod_stat(1M) icod_stat(1M)
iCOD Partition Configuration Information
The following table displays iCOD configuration information for each
partition in the complex:
nPar ID:
This field displays the partition number for the row of
data.
Intended Active CPUs:
This field displays the number of processors requested to be
active for this hard partition via the icod_modify command.
Actual Active CPUs:
This field displays the current number of active processors
for the hard partition. An asterisk will appear in this
field if the iCOD software makes an assumption when
displaying this number. See the iCOD User's Guide located
at /usr/share/doc/icodUserGuide.pdf for more information on
what these assumptions might be.
Total CPUs:
This field displays the total number of processors
physically present for the hard partition. An asterisk will
appear in this field if the iCOD software makes an
assumption when displaying this number. See the iCOD User's
Guide located at /usr/share/doc/icodUserGuide.pdf for more
information on what these assumptions might be.
Compatible Software Installed:
This field indicates whether the hard partition contains
compatible iCOD software.
nPar Name:
This field displays the partition name corresponding to the
row of information that is displayed.
Options [Toc] [Back]
icod_stat recognizes these options:
-s Displays system snapshot information. This option displays
the product and serial number for this system, as well as a
snapshot string that can be entered into the HP iCOD portal
for periodic auditing purposes.
EXTERNAL INFLUENCES [Toc] [Back]
Environment Variables
+ LANG determines the locale to use for the locale categories
when both LC_ALL and the corresponding environment variable
(beginning with LC_) do not specify a locale. If LANG is not
set or is set to the empty string, a default of "C" is used
(see lang(5)).
Hewlett-Packard Company - 5 - iCOD version B.06.01: March 2004
icod_stat(1M) icod_stat(1M)
+ LC_TIME determines the date and time strings output.
+ LC_MESSAGES determines the language in which messages (other
than the date and time strings) are displayed.
If any internationalization variable contains an invalid setting,
icod_stat behaves as if all internationalization variables are
set to "C" (see environ(5)).
RETURN VALUE [Toc] [Back]
icod_stat exits with one of these values:
0 Command succeeded.
2 Command succeeded; system is not an iCOD system.
>0, !=2 Command failed; error message sent to STDERR.
AUTHOR [Toc] [Back]
icod_stat was developed by HP.
SEE ALSO [Toc] [Back]
icod_modify(1M), icod_notify(1M), icodd(1M), icod(5).
Hewlett-Packard Company - 6 - iCOD version B.06.01: March 2004 [ Back ] |
