HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

p
parmodify(1M) parmodify(1M)
-s path Specifies the secondary boot path. path specifies a physical hardware path. Note:
On Itanium-based platforms, only boot paths of the local partition can be modified.
-P Partition Name Specifies the name of the partition. The characters which can appear in a valid par-
tition name are
a-z, A
-Z, 0-9, - (dash), _ (underscore), " " (space) and
. (period).
If the partition name includes space then the name should be enclosed within dou-
ble quotes. The partition name can have a maximum of 64 characters.
-k s_lock :p_lock Specifies the lock keys provided by
parmgr for the Stable Complex Configuration
Data and Partition Configuration Data. The lock keys should always be specified in
pairs. If either lock key is not available
-1 should be specified as a placeholder.
For example: if the s_lock is available but the p_lock is not available, then it should
be specified as
-k s_lock:-1
.
Note: The
-k option is intended for use by system management tools which invoke
the parmodify command programmatically. Command line users should avoid
this option.
Mapping of Global Cell Numbers to Local Cell Numbers
The cabinets in a complex are numbered starting from 0. The cell slots in each cabinet are also numbered
starting from 0. Each cabinet can have a maximum of 8 cells. For example, the cells located in cabinet 0
will have the following cell numbers in global format: 0, 1, 2, 3, 4, 5, 6, 7. The cell numbers in
corresponding local format will be 0/0, 0/1, 0/2, 0/3, 0/4, 0/5, 0/6, 0/7.
Similarly the cells located in cabinet 1 will have the following cell numbers in global format: 8, 9, 10, 11,
12, 13, 14, 15. The cell numbers in corresponding local format will be 1/0, 1/1, 1/2, 1/3, 1/4, 1/5, 1/6, 1/7.
From the above convention the cell located in cabinet 1, slot 0 is identified in the local format as 1/0 or in
the global format as 8. The parstatus (1) command will display the above cell as "cab1,cell0". The cell
located in cabinet 1, slot 4 is identified in the local format as 1/4 or in the global format as 12. The par-
status (1) command will display the above cell as "cab1,cell4".
RETURN VALUE
The
parmodify command exits with one of the following values:
0 Successful completion.
1 Error condition occurred.
EXAMPLES
Add a new cell in cabinet 0 slot 5 to the existing Partition 2 and activate it.
parmodify -p 2 -a 0/5:base:y:ri:50% -B
Delete a cell in cabinet 0 slot 5 from the existing Partition 2.
parmodify -p 2 -d 5
WARNINGS
On a partition whose hardware resources are managed under an instant Capacity On Demand (iCOD)
license, the parmodify command fails if a configuration change would take the partition out of compli-
ance.
Examples of such actions include:
• Assigning an iCOD cell to a partition, specifying "y" for the cell’s use_on_next_boot field.
• Changing an iCOD cell’s use_on_next_boot field to "y" after assigning it to a partition.
• Assigning a cell containing iCOD-licensed CPUs to a partition that is not running, or that does not
have the iCOD software installed.
For more information about actions that are restricted on iCOD partitions, refer to the iCOD User’s Guide
located at /usr/share/doc/icodUserGuide.pdf.
DEPENDENCIES
This command uses the Web-Based Enterprise Management (WBEM) product and certain of its
configuration settings. If you encounter connection errors when using the
-u option, check that the fol-
lowing two conditions are satisfied:
• Use the cimconfig(1M) command to verify (and correct if necessary) the setting of the following two
variables:
HP-UX 11i Version 2: August 2003 − 4 − Hewlett-Packard Company Section 1M−−593