unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 icod_stat(1M)						       icod_stat(1M)




 NAME
      icod_stat - Display instant Capacity on Demand (iCOD) status and
      system information.

 SYNOPSIS
      Path:   /usr/sbin

      icod_stat

      icod_stat -s

 DESCRIPTION
      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_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
      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_stat(1M)						       icod_stat(1M)




    Information displayed for the local hard partition
	   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
      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_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
      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_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
      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
    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_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
      icod_stat exits with one of these values:

	   0	   Command succeeded.

	   2	   Command succeeded; system is not an iCOD system.

	   >&gt&gt>0, !=2 Command failed; error message sent to STDERR.

 AUTHOR
      icod_stat was developed by HP.

 SEE ALSO
      icod_modify(1M), icod_notify(1M), icodd(1M), icod(5).































 Hewlett-Packard Company	    - 6 -