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_modify(1M)					     icod_modify(1M)




 NAME
      icod_modify - Activate and deactivate processors.	 Specify system
      contact e-mail address.  Change iCOD configuration information.
      Specify iCOD from e-mail address.	 Specify system identifier.  Apply
      codewords.

 SYNOPSIS
      Path:   /usr/sbin

      icod_modify -c <contact_email_address>

      icod_modify -C <codeword>

      icod_modify -f <from_email_address>

      icod_modify -i <system_id>

      icod_modify -r

      icod_modify -a <n> [-D] [-t] [desc[:user_name]]

      icod_modify -d <n> [-D] [desc[:user_name]]

      icod_modify -s <n> [-D] [-t] [desc[:user_name]]

 DESCRIPTION
      Use icod_modify to activate or deactivate processors, specify system
      contact or iCOD "from" e-mail address, apply codewords, change the
      system identifier, and change iCOD configuration information.
      icod_modify does not allow the activation of unlicensed iCOD
      components.  Additional components are licensed after HP receives
      payment of an enablement fee (for the component) and the application
      of a codeword.  A complex is in a compliant state when the number of
      active components of a given type does not exceed the number of
      licensed components of a given type (processors, cells, memory).

      Changes to the intended number of active processors using this command
      are persistent (survive system reboot).  The intended number is the
      number of active processors that iCOD attempts to satisfy at system
      boot time, and is effected using the -a, -d and -s options.  The
      intended number of active processors for each partition is displayed
      using the icod_stat command (see icod_stat(1M)).

      For detailed information on the use of this command, activation and
      deactivation of iCOD components, licensing, and temporary capacity,
      see the iCOD User's Guide located at /usr/share/doc/icodUserGuide.pdf.

    Options and Arguments
      icod_modify recognizes the following options and arguments:





 Hewlett-Packard Company	    - 1 -






 icod_modify(1M)					     icod_modify(1M)




	   -a <n>		      Activates n additional processors for
				      this partition.  This does not permit
				      the activation of processors if the
				      end result would take the complex out
				      of compliance.

	   -c <contact_email_address> Sets the system contact e-mail
				      address.	This is the e-mail address
				      that will receive configuration change
				      notification and exception reports.
				      Note that this can be an e-mail alias,
				      if multiple recipients of these
				      reports are desired.

	   -C <codeword>	      Codeword application.  This option
				      allows the user to apply a codeword
				      they receive from the HP iCOD portal.
				      Application of codewords only
				      authorizes the use of iCOD components;
				      it does not activate any components.

	   -d <n>		      Deactivates n processors.	 This option
				      reduces the number of intended active
				      processors by n, for this partition.

	   -D			      Defers a processor activation or
				      deactivation until the next reboot.
				      This option modifies the default
				      behavior of the -d, -s, and -a
				      options, which is to activate or
				      deactivate processors instantly.	This
				      option is not supported within a
				      virtual partition.  NOTE: the behavior
				      of the -d and -a options is modified
				      such that all invocations are
				      calculated based on the running
				      configuration, and NOT on any previous
				      icod_modify -D[asd] commands.

	   -f <from_email_address>    Set iCOD "from" e-mail address.
				      Causes all iCOD e-mail correspondence
				      from this system to appear to be sent
				      from from_email_address.	Specifying
				      an empty string ("") returns to
				      default behavior, which is to send
				      from the adm user on the local system.
				      The address specified must be DNS
				      resolvable by HP.

	   -i <system_id>	      Set system identifier used during
				      asset reporting.	The default setting



 Hewlett-Packard Company	    - 2 -






 icod_modify(1M)					     icod_modify(1M)




				      for the system identifier is the
				      hostname of the iCOD system.  This
				      value can be returned to the default
				      setting by specifying an empty string
				      ("").  The system identifier is a
				      string that you specify to help track
				      your own systems.

	   -r			      Reconcile.  Activate or deactivate
				      processors (subject to compliance
				      limits) to bring the system to a state
				      where the intended number of
				      processors are active.

	   -s <n>		      Sets the number of active processors
				      to n.  This option does not permit the
				      activation of processors if the end
				      result causes the complex to be out of
				      compliance.

	   -t			      Authorize use of temporary capacity.
				      This option specifies that a processor
				      activation is allowed to consume
				      temporary capacity.

	   desc			      Optional description to help customers
				      identify this configuration change.
				      This description becomes part of the
				      iCOD logfile (/var/adm/icod.log) entry
				      documenting the activation or
				      deactivation.  This description is
				      also contained in the configuration
				      change notification e-mail.

	   user_name		      Optional string identifying the person
				      performing the processor activation or
				      deactivation.  This can be any ASCII
				      string, and will become part of the
				      iCOD logfile (/var/adm/icod.log) entry
				      documenting the activation or
				      deactivation.  The string specified
				      here will also be contained in the
				      configuration change notification e-
				      mail.

 UPGRADES
      The icod_modify command fails if the system is in a state where a
      software upgrade is incomplete (the software on the system has been
      upgraded from version B.05.00 or earlier, but an upgrade codeword
      issued by the HP iCOD portal (http://www.hp.com/go/icod/portal) has
      not been applied to the system).	The only option that can be used



 Hewlett-Packard Company	    - 3 -






 icod_modify(1M)					     icod_modify(1M)




      when the complex is in this state is the -C option, which accepts the
      upgrade codeword.

 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)).

	   +  LC_CTYPE determines the interpretation of single- and multi-
	      byte characters.

	   +  LC_TIME determines the date and time strings output.

	   +  LC_MESSAGES determines the language in which messages are
	      displayed.

	   If any internationalization variable contains an invalid setting,
	   icod_modify behaves as if all internationalization variables are
	   set to "C" (see environ(5)).

    International Code Set Support
      Single- and multi-byte character code sets are supported.	 However,
      input to the command must be entered using ASCII characters only.

 RETURN VALUE
      icod_modify exits with one of these values:

	   0	Command succeeded.

	   >0	Command failed; error message sent to STDERR.

 FILES
      /var/adm/icod.log

 EXAMPLES
      Instantly activate one CPU with "Add horsepower now" as the
      description and "Super User" as the user name:

	   icod_modify -a 1 "Add horsepower now:Super User"

      Activate two CPUs (deferred until the next reboot) with "Add
      horsepower after reboot" as the description and "Super User" as the
      user name:

	   icod_modify -D -a 2 "Add horsepower after reboot:Super User"

      Instantly activate one CPU using temporary capacity with "Temp use of
      one CPU" as the description and "Super User" as the user name:



 Hewlett-Packard Company	    - 4 -






 icod_modify(1M)					     icod_modify(1M)




	   icod_modify -t -a 1 "Temp use of one CPU:Super User"

      Instantly activate or deactivate CPUs to specify 8 active CPUs with
      "Set active CPUs to 8" as the description and "Super User" as the user
      name.

	   icod_modify -s 8 "Set active CPUs to 8:Super User"

      Deactivate one CPU at the next reboot with "Less horsepower after
      reboot" as the description and "Super User" as the user name:

	   icod_modify -D -d 1 "Less horsepower after reboot:Super User"

      Set the iCOD from_email_address to adminATresearch.com:

	   icod_modify -f admin@research.corp.com

      Set the system_id to Asset_Num_234:

	   icod_modify -i Asset_Num_234

      Set the system contact e-mail address to super_userATcorp.com:

	   icod_modify -c super_user@corp.com

 AUTHOR
      icod_modify was developed by HP.

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
























 Hewlett-Packard Company	    - 5 -