parmodify.1m (2010 09)

p
parmodify(1M) parmodify(1M)
Options and Arguments
parmodify recognizes the following command line options and arguments:
-p PartitionNumber Specifies the partition to be modified. PartitionNumber specifies the unique
number (integer) assigned to the partition when it was created. Note: The partition
which is specified to be modified is called the target partition. The partition in
which the command is executing is called the local partition.
One or more of the following options must be specified with the
-p option:
-a cell:[celltype]:[
use_on_next_boot
]:[failure_usage][:
clm_value]
Assigns the specified cell to the target partition. To assign multiple cells to the par-
tition, multiple -a options should be used.
cell specifies the cell id. It can be specified either in the local (cabinet# /slot# ) or glo-
bal (cell# ) format. For example, the cell located in cabinet 0, slot 1 is identified in
the local format as 0/1 or in the global format as 1.
celltype specifies the type of the cell. The valid celltype values for a cell are:
base This is the default if celltype is not specified.
floating A floating cell in a partition does not participate in interleaved
memory (all of the cell’s memory is used as CLM). A floating cell can-
not be a partition’s core cell.
use_on_next_boot specifies whether the cell will participate in a reboot and allows
online operations. The valid values for use_on_next_boot are:
y participate in reboot and allow cell online operation to be performed. Refer to
the parolrad (1M) manpage for more information. This is the default. How-
ever if the slot is missing, or the cell does not exist, or the cell is powered off,
then it defaults to n.
n do not participate in reboot.
failure_usage field is used by system firmware when a partition is booted. If a CPU
selftest failure or a DIMM de-allocation occurs during the power-on self-test process
then this flag is used by the system firmware to determine whether or not and how
the cell should be integrated into the partition at boot time. The valid failure_usage
value for cells is:
ri reactivate with memory interleave. Specifies to integrate the cell as it
would normally be integrated. This is the default for base cells.
float this is the default value for floating cells. If the user specifies ri for a
floating cell, the command outputs an error and exits.
deconf deconfigure.
ni no interleave.
clm_value specifies the amount of the memory that will be configured as local (non-
interleaved) memory for the cell. The command issues a warning if the specified
clm_value exceeds the total memory of the cell.
Note: On PA platforms, the amount of memory allocated for CLM may not match
the amount of CLM requested due to some memory being reserved exclusively by
the operating system.
If no clm_value is specified, maximum interleaved memory (no clm) is assumed for
cells. The command will issue a warning if 100% CLM is specified for all the cells
in the partition. The clm_value can be expressed in two forms:
• As a percentage (ratio). The percent number can be any number in the range 0 -
100 with a suffix of "%". This number will be rounded up to 12.5%, 25%, 37.5%,
50%, 62.5%, 75%, 87% or 100%. If the cell contains less than 4 GB memory,
then the percentage will be rounded to 25%, 50%, 75% or 100%. The specified
percentage is applied each time the partition boots, thus resulting in a different
value if the working memory in the cell is different. For example, a cell in a par-
tition has 8 GB memory and the user specifies 4 GB CLM. When the partition
boots 4 GB of that cell’s memory will be used as CLM. Later the user shuts
down the partition, adds another 8 GB memory to that cell. When the partition
is booted again, the cell now has 16 GB of memory, so 8 GB (50%) is allocated as
CLM.
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010