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

p
parmodify(1M) parmodify(1M)
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.
-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.
-T flag Specifies that whether Hyper-Threading should be enabled or not (only if cell support
this feature). If this option is not specified, Hyper-Threading property will not be
changed. The valid values for flag are:
y enables Hyper-Threading, which allows multiple threads to run concurrently on
each CPU.
n disables Hyper-Threading.
-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.
-u username[:] Specifies the required authorization to access a partition other than the local system
(but can also be used as a loopback access to the local partition).
The -h option is required if this option is used.
If this option is specified, the command prompts for the password.
username specifies a configured user name on the target partition.
Note: This command is a Web-Based Enterprise Management (WBEM) Client Appli-
cation. The -u option accesses the target partition using a Secure Sockets Layer
(SSL) connection. If errors are reported, check that the conditions described in the
DEPENDENCIES section are satisfied.
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 correspond-
ing 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.
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 (iCAP) license, the par-
modify
command fails if a configuration change would take the partition out of compliance.
Examples of such actions include:
• Assigning an iCAP cell to a partition, specifying "y" for the cell’s use_on_next_boot field.
• Changing an iCAP cell’s use_on_next_boot field to "y" after assigning it to a partition.
• Assigning a cell containing iCAP-licensed CPUs to a partition that is not running, or that does not have
the iCAP software installed.
136 Hewlett-Packard Company − 4 − HP-UX 11i Version 3: February 2007