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

p
parmodify(1M) parmodify(1M)
will override previous core cell choices. So, if the order of a given cell is changing,
all of the core cell choices should be specified in the new order.
A cell 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.
-I IPaddress Specifies the IP address that should be used by management tools such as
parmgr
to address the target partition. This value must be consistent with the IP address
that is assigned to the partition once HP-UX is installed and networking is
configured.
-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.
-t path Specifies the alternate boot path. path specifies a physical hardware path. Note:
On Itanium-based platforms, only boot paths of the local partition can be modified.
-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.
HP-UX 11i Version 2: September 2004 − 4 − Hewlett-Packard Company Section 1M−−603