vparenv(1M)															       vparenv(1M)

NAME

       vparenv - display or set the environment for the next boot

SYNOPSIS

       mode] memtype:size]

DESCRIPTION

       The  command displays or sets appropriate firmware variables on Itanium-based platforms.  The variables manage the partition boot mode ( or
       CLM granularity and ILM granularity.  By default, the command displays the current settings of the partition boot mode and memory granular-
       ities.

       The  command  also  displays  the  maximum possible ILM granules for the system and the maximum possible CLM granules per cell.	Note: This
       information is displayed by the command only if the system has been switched to vPars mode atleast once after a system reset.  Users should
       consider  these maximums when specifying either granularity.  Care should be taken to choose granule sizes which do not result in the total
       number of granules exceeding the permissible limits for that system.

       In certain scenarios, the command may not be able to validate if the chosen memory granularities are appropriate for the system.  The  com-
       mand  will  display a warning message. In such cases, the user should validate the granularities against the total memory on the system and
       the supported number of memory granules on the system. Please refer to manpage for more details.

       Note: This command does not modify the ILM/CLM granule values in the vPars database file. It only modifies the appropriate EFI variables.

       This command is not supported on PA-RISC platforms.

   Options and Arguments
       recognizes the following command line options and arguments:

       Specifies the mode for the next system boot.
			 The valid values for mode are case-insensitive If mode is specified as then after the next reboot, the system will be	in
			 the vPars mode.  If mode is specified as then after the next reboot, the system will be in the nPars mode.

			 Note: The mode setting does not take effect until the next system (hard partition) reboot.

       Specifies the desired granularity of Cell Local Memory (CLM) or
			 InterLeaved  Memory  (ILM)  to  be set in the appropriate EFI variable.  memtype specifies the type of memory.  The valid
			 values are case insensitive and size specifies the desired granularity in megabytes.  Note: The granule settings  do  not
			 take effect until the next system (hard partition) reboot.

WARNINGS

       The EFI granule settings must be the same as those in the vPar database loaded into the monitor.  If one or both settings do not match, the
       monitor will not allow any vPar to boot.  Refer to the vparcreate(1M) manpage.  To correct this, you must either change the  EFI  variables
       using this command or change the granularity values in the database file by recreating the database using

EXAMPLES

       Set the boot mode to

       Set the CLM granularity to 128 MB.

       Set the ILM granularity to 128 MB and CLM granularity to 128 MB.

SECURITY RESTRICTIONS

       This command is restricted to processes owned by superuser.

       When virtual partition flexible administrative capability is enabled, the boot environment firmware variables can only be set from within a
       Designated-Admin vPar.

RETURN VALUE

       The command exits with one of the following values:

       Successful completion.
       An error condition occurred.

AUTHOR

       was developed by the Hewlett-Packard Company.

SEE ALSO

       vparadmin(1M), vparboot(1M), vparconfig(1M), vparcreate(1M), vpardump(1M), vparefiutil(1M), vparextract(1M), vparmodify(1M), vparreloc(1M),
       vparremove(1M), vparreset(1M), vparstatus(1M), vparutil(1M), vparresources(5), vpartition(5), vpmon(5).

							   Itanium(R)-based Systems Only					       vparenv(1M)