HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)

p
parmodify(1M) parmodify(1M)
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 parti-
tion, multiple -a options should be used.
cell specifies the cell id. It can be specified either in the local (cabinet#/slot#) or global
(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.
use_on_next_boot specifies whether the cell will participate in a reboot. The valid
values for use_on_next_boot are:
y participate in reboot. This is the default. However 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.
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 percen-
tage 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 partition 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.
• As an absolute number (default). This can also be optionally suffixed by "GB". The
clm_value is interpreted as an absolute number of gigabytes of memory. Numbers
other than integers and halves are rounded up to the nearest 0.5 GB. For exam-
ple: 2.5 GB will not be rounded up. However 2.3 GB will be rounded up to 2.5 GB.
For example, a cell in a partition has 8 GB memory and the user specifies 50%
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, but the
CLM is still 4 GB.
-B Specifies to reboot the partition now. The default is not to boot. If this option is
specified and the partition to be modified is not the local partition, then the command
proceeds only if the specified partition is not active. Also this option is useful only if
the -a option or the -d option or a clm_value has been specified.
-b path Specifies the primary boot path. path specifies a physical hardware path. Note: On
Itanium-based platforms, only boot paths of the local partition can be modified.
134 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: February 2007