HMC Command Line Help
Commands by Task:
Activate CoD Advanced Functions - chvet
Activate On/Off CoD resources - chcod
Activate partition - chsysstate
Activate system profile - chsysstate
Add memory to a partition - chhwres
Add processors to a partition - chhwres
Change the number of Utility CoD processors - chcod
Create LPAR - mksyscfg
Create LPAR profile - mksyscfg
Create system profile - mksyscfg
Deactivate all On/Off CoD processors - chcod
Deactivate all On/Off CoD resources - chcod
Delete LPAR - rmsyscfg
Delete LPAR profile - rmsyscfg
Delete system profile - rmsyscfg
Display activation code generation information - lsvet
Display activation history log - lsvet
Enter a Capacity on Demand (CoD) code - chcod
Fast power off the managed system - chsysstate
Get LPAR state - lssyscfg
Hard partition reset - chsysstate
List all partitions in a managed system - lssyscfg
List all systems managed by the HMC - lssyscfg
List CoD capacity information - lscod
List CoD code generation information - lscod
List CoD history log - lscod
List HMC remote access settings - lshmc
List HMC network settings - lshmc
List HMC VPD information - lshmc
List HMC version - lshmc
List I/O resources for a managed system - lshwres
List Licensed Internal Code levels - lslic
List LPAR profile properties - lssyscfg
List LPAR properties - lssyscfg
List managed system properties - lssyscfg
List memory resources - lshwres
List On/Off CoD billing information - lscod
List processor resources - lshwres
List reference code entries - lsrefcode
List system profile properties - lssyscfg
List virtual I/O resources for a managed system - lshwres
Modify LPAR profile properties - chsyscfg
Modify LPAR properties - chsyscfg
Modify managed system properties - chsyscfg
Modify system profile properties - chsyscfg
Move a physical I/O slot from one partition to another - chhwres
Move memory from one partition to another - chhwres
Move processors from one partition to another - chhwres
Power off the managed system - chsysstate
Power on the managed system - chsysstate
Re-IPL the managed system - chsysstate
Remove a physical I/O slot from a partition - chhwres
Remove memory from a partition - chhwres
Remove processors from a partition - chhwres
Set a Utility CoD processor minute usage limit - chcod
Soft partition reset - chsysstate
Update Licensed Internal Code - updlic
Validate a system profile - chsysstate
Commands by Name:
asmmenu - launch the ASM interface
bkconsdata - back up critical HMC data
bkprofdata - back up profile data for the managed-system
chaccfg - change access control configuration
chcod - perform Capacity on Demand (CoD) operations
enter a CoD code
activate an amount of CoD resources
change the number of Utility CoD processors
deactivate all On/Off CoD processors
deactivate all On/Off CoD resources
set a Utility CoD processor minute usage limit
chhmc - change HMC configuration information
chhmcusr - change HMC user attribute
chhwres - change system memory and processor resources
add memory to a partition
add processors to a partition
move memory from one partition to another
move processors from one partition to another
remove memory from a partition
remove processors from a partition
chkmedia - check media readiness
chled - change LED
chlparutil - change utilization data collection settings
chsacfg - change Service Agent configuration
chsvcevent - update serviceable events on the HMC
chsyscfg - change system configuration
modify LPAR properties
modify LPAR profile properties
modify managed system properties
modify system profile properties
chsyspwd - change system password
chsysstate - change system state
activate partition
activate system profile
fast power off the managed system
hard partition reset
power off the managed system
power on the managed system
re-IPL the managed system
soft partition reset
chvet - activate Capacity on Demand advanced funtions
enter an activation code
cpdump - copy dumps
cpsysplan - copy system plan
defsysplanres - define system plan resource
deploysysplan - deploy system plan
dump - perform dump operation
getdump - get dump
getupgfiles - get upgrade files
hmcshutdown - shut down the HMC
hmcwin - proide screen capture on the HMC
installios - install the Virtual I/O Server
logssh - log ssh command usage
lpar_netboot - retrieve MAC address and physical location code from network adapters for a partition or instruct a partition to network boot
lpcfgop - perform a partition configuration image operation
lsaccfg - list access control configuration information
lscod - list Capacity on Demand resources for a managed system
list CoD capacity information
list CoD code generation information
list CoD history log
list On/Off CoD billing information
lsdump - lists dump information
lshmc - List HMC Configuration Information
list HMC remote access settings
list HMC network settings
list HMC VPD information
list HMC version
lshmcusr - list HMC user information
lshwinfo - list environmental information
lshwres - list the hardware resources of a managed system
determine DRC indexes for physical I/O slots
determine memory region size
list I/O resources for a managed system
list memory resources
list processor resources
list virtual I/O resources for a managed system
lsled - list LEDs
lslic - list Licensed Internal Code (LIC) levels
list LIC levels active on a managed system
list LIC levels available in a repository
lslock - list lock information
lslparutil - list utilization data
lsmediadev - list storage media devices
lsrefcode - list reference code entries for partitions or managed systems
list reference code entries for all partitions
list reference code entries for a managed system
lssacfg - list Service Agent configuration information
lssvcevents - list console or serviceable events
lssyscfg - list system configuration information
get LPAR state
list all partitions in a managed system
list all systems managed by the HMC
list LPAR profile properties
list LPAR properties
list managed system properties
list system profile properties
lssysconn - list system connections
lssysplan - list system plans
lssysplanres - list system plan resources
lvet - list Capacity on Demand advanced functions
display activation code generation information
display activation history log
migrcfg - migrate configuration
mkaccfg - create access control object
mahmcusr - create an HMC user
mksyscfg - create system configuration
create LPAR profile
create system profile
mksysconn - create system connection
mksysplan - make system plan file
mkvterm - open a virtual terminal session
monhmc - monitor HMC subsystems and system resources
pedbg - Product Engineering debug tools
pesh - provide PE Shell access
rmaccfg - remove access control object
rmhmcusr - remove an HMC user
rmlock - remove lock
rmlparutil - remove utilization data
rmprofdata - remove profile data
rmsyscfg - remove system configuration
delete LPAR
delete LPAR profile
delete system profile
rmsysconn - remove system connection
rmsysplan - remove system plan
rmsysplanres - remove system plan resource
rmvterm - close a vertual terminal session
rsthwres - restore hardware resources
rstprofdata - restore profile data
rstupgdata - restore upgrade data
saveupgdata - save upgrade data
sendfile - transfer file from the HMC to a remote system
startdump - start dump
updhmc - update code on the HMC
updlic- update Licensed Internal Code (LIC)
retrieve, install, activate updates
retrieve and install updates
remove the last update
change LIC update control to HMC
change LIC update control to operating system
viosvrcmd - issue virtual I/O server command
4.0 Using the Managed System
Powering On the Managed System
Use the chsysstate command to power on the managed system. This power on option is similar to a “White Button" power on. Enter the following:
chsysstate -r sys -m <managed system> -o on
Powering Off the Managed System
Use the chsysstate command to power off the managed system. This can be done in two ways.
To power off a managed system normally, type the following:
chsysstate -r sys -m <managed system> -o off
You can also perform a fast power off (operator panel function 8) of a managed system. To do this, type the following command:
chsysstate -r sys -m <managed system> -o off --immed
Updating Licensed Internal Code
Use the updlic command to retrieve, install, and activate Licensed Internal Code on a managed system. Use the -q parameter to determine if the update is disruptive.
To determine if the latest CPC update from IBM Retain is disruptive:
updlic -m <managed system> -o a -t cpc -l latest -r ibmretain -q
To change LIC update control on the managed system from HMC to operating system:
updlic -m <managed system> -o o
Listing HMC Current Configuration
Use the lshmc command to list the current remote access settings, network settings, version, and Vital Product Data (VPD) information for the HMC.
To list the remote access settings for ssh, websm, and http:
lshmc -r
To list the HMC hostname and network IP address:
lshmc -n -F hostname,ipaddr
To list the HMC Vital Product Data (VPD) information:
lshmc -v
Display the HMC version information:
lshmc -V
Listing all Systems Managed by the HMC
Use the lssyscfg command to list system configuration and managed system MTMS information. To list the properties of all systems managed by this HMC, enter the following:
lssyscfg -r sys
To list only the user-defined names, model types, serial numbers, and states for all of the systems managed by this HMC, enter:
lssyscfg -r sys -F name,type_model,serial_num,state --header
Note that after executing this command, <type_model> concatenated with * then with <serial_num> represents the MODEL-TYPE*SERIAL, or MTMS, for the managed system.
Listing a Managed System's Properties
To list a specific managed system's properties, enter:
lssyscfg -r sys -m <managed system>
Modifying the Managed System Properties
Use the chsyscfg command to change the properties of a managed system. The following example shows how to change the managed system's user-defined name and power off policy:
chsyscfg -r sys -m <managed system> –i "new_name=newsys1,power_off_policy=0"
Valid attributes, specified with the –i flag, include:
new_name
power_on_side
power_off_policy
power_on_speed
service_lpar_id
power_on_speed_override
service_lpar_name
Instead of entering configuration information on the command line with the -i flag, the information can be placed in a file and the filename specified with the -f flag.
For more information about the valid attributes listed in this command example, refer to the Command Attributes table.
Listing Reference Codes for a Managed System or Partition
Use the lsrefcode command to list SRC entries for a managed system or partition. Entries may be filtered by lpar name or lpar id.
To list the last 10 SRC entries for the managed system:
lsrefcode -m <managed system> -r sys -n 10
To list the current SRC entry for each partition on the managed system:
lsrefcode -m <managed system> -r lpar
Display the last 50 SRC entries for partition p1:
lsrefcode -m <managed system> -r lpar -n 50 --filter "lpar_names=p1"
Restarting the Managed System
To restart the managed system, enter:
chsysstate -r sys -m <managed system> -o off --immed --restart
Listing Licensed Internal Code Levels for a Managed System
Use the lslic command to list the LIC levels (cpc or power) on a partition or managed system that have been installed, activated, and accepted. You may also list available levels in a repository.
To list current CPC LIC levels on a managed system:
lslic -m <managed system> -t cpc
To list available POWER LIC levels in a repository:
lslic -m <managed system> -t power -r <repository>
Listing Capacity on Demand Information for a Managed System
Use the lscod command to list memory and processor Capacity on Demand information for a managed system, including capacity, code generation, and CoD history logs for Capacity Upgrade on Demand (CUoD) and On/Off Capacity on Demand (OOCoD). More CoD operations are covered in 10.0 CLI: Performing Capacity on Demand (CoD) Operations.
To list On/Off CoD processor capacity information:
lscod -m <managed system> -t cap -r proc -c onoff
To list CUoD memory activation code generation information:
lscod -m <managed system> -t code -r mem -c cuod
To list the Capacity on Demand history log:
lscod -m <managed system> -t hist
To Display On/Off Capacity on Demand memory billing information:
lscod -m <managed system> -t bill -r mem -c onoff
9.0 Listing Hardware Resources
The lshwres command, which lists the hardware resources of a managed system, can be used to display I/O, virtual I/O, processor, and memory resources.
Listing I/O Resources for a Managed System
Use the following commands to list:
I/O units on the managed system
lshwres -m <managed system> -r io --rsubtype unit
I/O buses on the managed system
lshwres -m <managed system> -r io --rsubtype bus
I/O slots on the managed system
lshwres -m <managed system> -r io --rsubtype slot
All partitions participating in an I/O pool and all slots assigned to an I/O pool
lshwres -m <managed system> -r io --rsubtype iopool
Tagged I/O for i5/OS (OS/400) partitions
lshwres -m <managed system> -r io --rsubtype taggedio
Listing Processor Resources
Use the following commands to list processor information for:
The managed system
lshwres -m <managed system> -r proc --level sys
Partitions
lshwres -m <managed system> -r proc --level lpar
The shared pool
lshwres -m <managed system> -r proc --level pool
Listing Virtual I/O Resources for a Managed System
Use the following commands to list:
Virtual Ethernet adapters
lshwres -m <managed system> -r virtualio --rsubtype eth --level lpar
System level virtual Ethernet information
lshwres -m <managed system> -r virtualio --rsubtype eth --level sys
Virtual OptiConnect pool information
lshwres -m <managed system> -r virtualio --rsubtype virtualopti --level lpar
HSL OptiConnect pool information
lshwres -m <managed system> -r virtualio --rsubtype hslopti --level lpar
Virtual serial adapters
lshwres -m <managed system> -r virtualio --rsubtype serial --level lpar
Virtual serial servers with open connections
lshwres -m <managed system> -r virtualio --rsubtype serial --level openserial
Virtual SCSI adapters
lshwres -m <managed system> -r virtualio --rsubtype scsi --level lpar
Partition-level virtual slot information
lshwres -m <managed system> -r virtualio --rsubtype slot --level lpar
Virtual slot information
lshwres -m <managed system> -r virtualio --rsubtype slot --level slot
Listing Memory Resources
Use the following commands to list:
Memory information for a managed system
lshwres -m <managed system> -r mem --level sys
Memory information for partitions
lshwres -m <managed system> -r mem --level lpar
10.0 Performing Capacity on Demand (CoD) Operations
Entering a Capacity on Demand Code
To enter an CoD code:
chcod -o e -m <managed system> -k <CoD code>
Activating an Amount of On/Off CoD Resources
To activate an amount of On/Off CoD memory for a certain number of days:
chcod -m <managed system> -o a -c onoff -r mem -q <quantity of resources> -d <number of days>
Changing the Number of Utility CoD Processors
To decrease the number of Activated Utility CoD processors:
chcod -m <managed system> -o a -c utility -r proc -q <quantity of processors>
Deactivating all On/Off CoD Processors
To deactivate all On/Off CoD processors:
chcod -m <managed system> -o d -c onoff -r proc
Deactivating all On/Off CoD Resources
To deactivate all On/Off CoD resources:
chcod -m <managed system> -o d -c onoff -r mem
Setting a Utility CoD Processor Minute Usage Limit
To set a Utility CoD processor minute usage limit::
chcod -m <managed system> -o s -c utility -r proc -l <number of processor minutes>
Activating Capacity on Demand (CoD) Advanced Functions
CoD advanced functions include Advanced POWER Virtualization and Endterprise Enablement. CoD advanced functions are sometimes referred to as Virtualization Engine systems technologies. To enter an activation code:
chvet -m <managed system> -o e -k <activation code>
Displaying Activation Code Generation Information
To display activation code generation information:
lsvet -m <managed system> -t code
Displaying the Activation History Log
To display activation history log:
lsvet -m <managed system> -t hist
5.0 Working with LPARs
Creating LPARs
Use the mksyscfg command to create a partition.
The following is an example of how to create an AIX/Linux partition:
mksyscfg -r lpar -m <managed system> –i "lpar_id=2,name=aixlinux_lpar2,profile_name=prof1, lpar_type=aixlinux,boot_mode=norm, desired_procs=1,min_procs=1, max_procs=1,min_proc_units=0.1, desired_proc_units=0.5,max_proc_units=0.5, proc_type=shared,sharing_mode=cap,desired_mem=400, min_mem=400, max_mem=400,auto_start=1, power_ctrl_lpar_ids=0,io_slots=553713666/65535/1"
The following is an example of how to create an i5/OS (OS/400) partition:
mksyscfg -r lpar -m <managed system> –i "lpar_id=3,name=os400_lpar3,profile_name=prof1, lpar_type=os400, desired_procs=1,min_procs=1,max_procs=1, min_proc_units=0.1,desired_proc_units=0.5, max_proc_units=0.5,proc_type=shared, sharing_mode=cap,desired_mem=400, min_mem=400, max_mem=400,auto_start=1,power_ctrl_lpar_ids=0, io_slots=553713699/65535/1, load_source_slot=553713699, console_slot=553713699,min_interactive=0, desired_interactive=0, max_interactive=0"
Valid attributes, specified with the –i flag, include:
name
desired_proc_units
min_proc_units
lpar_id
max_proc_units
ecs_slot
profile_name
lpar_io_pool_ids
sni_windows
lpar_type
io_slots
alt_console_slot
cluster_id
boot_mode
sni_device_ids
sharing_mode
max_virtual_slots
console_slot
desired_procs
auto_start
sni_config_mode
min_procs
power_ctrl_lpar_ids
alt_load_source_slot
max_procs
virtual_opti_pool_id
virtual_serial_adapters
desired_mem
hsl_opti_pool_id
load_source_slot
min_mem
min_interactive
virtual_scsi_adapters
max_mem
desired_interactive
uncap_weight
proc_type
max_interactive
virtual_eth_adapters
lnstead of entering configuration information on the command line with the -i flag, the information can instead be placed in a file, and the filename specified with the -f flag.
For more information about the valid attributes listed in this command example, refer to the Command Attributes table.
Listing All Partitions in a Managed System
Use the lssyscfg command to list all partitions in a managed system. To do this, enter:
lssyscfg -r lpar -m <managed system>
To list only the names, IDs, and states of all partitions in a managed system, enter:
lssyscfg -r lpar -m <managed system> -F name,lpar_id,state --header
Listing LPAR Properties
Use the lssyscfg command to list the properties of a specific partition. Type the following:
lssyscfg -r lpar -m <managed system> --filter "lpar_ids=<partition ID>"
Note that the partition name can be specified instead of the partition ID by using the lpar_names filter in place of the lpar_ids filter. Also, more than one partition may be specified in the filter list.
For information on using the lshwres command to list a partition's I/O, virtual I/O, processor, and memory resources, see Listing Hardware Resources.
Getting the LPAR State
Use the lssyscfg command to display the state of a partition. Type the following:
lssyscfg -r lpar -m <managed system> --filter "lpar_names=<partition name>" -F state
Note that the partition ID can be specified instead of the partition name by using the lpar_ids filter in place
of the lpar_names filter. Also, more than one partition may be specified in the filter list.
Modifying LPAR Properties
Use the chsyscfg command to modify the properties of a partition. The following example shows how to change a partition’s cluster ID:
chsyscfg -r lpar -m <managed system> -i "lpar_id=l,cluster_id=3"
Valid attributes, specified with the –i flag, are:
new_name
name | lpar_id
default_profile
cluster_id
Instead of entering configuration information on the command line with the -i flag, the information can instead be placed in a file, and the filename specified with the -f flag.
For more information about the valid attributes listed in this command example, refer to the Command Attributes table.
Activating a Partition
Use the chsysstate command to activate a partition. Type the following:
chsysstate -r lpar -m <managed system> -o on -n <partition name> -f <partition profile name>
The partition ID can be specified instead of the partition name by using the --id parameter instead of the -n parameter.
Using a Soft Partition Reset
Use the chsysstate command to perform a soft reset of a partition. Type the following:
chsysstate -r lpar -m <managed system> -o reset -n <partition name>
The partition ID can be specified instead of the partition name by using the --id parameter instead of the -n parameter.
Using a Hard Partition Reset
Use the chsysstate command to perform a hard reset of a partition. Type the following:
chsysstate -r lpar -m <managed system> -o off --id <partition ID>
The partition name can be specified instead of the partition ID by using the -n parameter instead of the --id parameter.
Deleting an LPAR
Use the rmsyscfg command to remove a partition. Type the following:
rmsyscfg -r lpar -m <managed system> -n <partition name>
This command removes the specified partition and all of its associated partition profiles from the specified managed system. The partition’s profiles are also removed from any system profiles that contain them.
The partition ID can be specified instead of the partition name by using the --id parameter instead of the -n parameter.
7.0 Working with LPAR Profiles
Creating an LPAR Profile
Use the mksyscfg command to create a partition profile. The following is an example of how to create a partition profile:
mksyscfg -r prof -m <managed system> -i
"name=prof3,lpar_id=2,boot_mode=norm, sfp_surveillance=1,desired_procs=2, min_procs=1,max_procs=2,min_proc_units=0.1, desired_proc_units=0.5,max_proc_units=0.5, proc_type=shared,sharing_mode=cap, desired_mem=400,min_mem=400,max_mem=400, auto_ipl=1,power_ctrl_lpar_ids=0, io_slots=553713666/65535/1"
Valid attributes, specified with the -i flag, include:
name
lpar_id | lpar_name
power_ctrl_lpar_ids
desired_procs
min_procs
max_procs
desired_mem
min_mem
max_mem
proc_type
uncap_weight
sharing_mode
load_source_slot
alt_load_source_slot
console_slot
alt_console_slot
ecs_slot
min_proc_units
desired_proc_units
max_proc_units
lpar_io_pool_ids
io_slots
boot_mode
sfp_surveillance
sni_windows
virtual_opti_pool_id
hsl_opti_pool_id
min_interactive
desired_interactive
max_interactive
max_virtual_slots
virtual_eth_adapters
virtual_scsi_adapters
virtual_serial_adapters
sni_config_mode
sni_device_ids
auto_ipl
The profile name (name) and the partition (lpar_id or lpar_name) must be specified. Instead of entering configuration information on the command line with the -i flag, the information can instead be placed in a file, and the filename specified with the -f flag.
For more information about the valid attributes listed in this command example, refer to the Command Attributes table.
Listing LPAR Profile Properties
Use the lssyscfg command to list a partition profile. Type the following:
lssyscfg -r prof -m <managed system> -–filter
"lpar_names=<partition name>, profile_names=<profile name>"
Use the --filter parameter to specify the partition for which partition profiles are to be listed, and to specify which profile names to list. While the filter can only specify a single partition, it can specify multiple profile names for that partition.
Note that the partition ID can be specified instead of the partition name by using the lpar_ids filter in place of the lpar_names filter.
Modifying LPAR Profile Properties
Use the chsyscfg command to modify a partition profile’s properties. The following example shows how to change prof1's memory amounts:
chsyscfg -r prof -m <managed system> -i
"name=prof1,lpar_name=lpar3,min_mem=256,
max_mem=512,desired_mem=512"
Valid attributes, specified with the -i flag, include:
name
lpar_name | lpar_id
new_name
desired_procs
min_procs
max_procs
desired_mem
min_mem
max_mem
proc_type
uncap_weight
sharing_mode
load_source_slot
alt_load_source_slot
console_slot
alt_console_slot
ecs_slot
min_proc_units
desired_proc_units
max_proc_units
lpar_io_pool_ids
io_slots
boot_mode
sfp_surveillance
sni_windows
virtual_opti_pool_id
hsl_opti_pool_id
min_interactive
desired_interactive
max_interactive
max_virtual_slots
virtual_eth_adapters
virtual_scsi_adapters
virtual_serial_adapters
sni_config_mode
sni_device_ids
auto_ipl
power_ctrl_lpar_ids
Instead of entering configuration information on the command line with the -i flag, the information can instead be placed in a file, and the filename specified with the -f flag.
For more information about the valid attributes listed in this command example, refer to the Command Attributes table.
Deleting an LPAR Profile
Use the rmsyscfg command to remove a partition profile. Type the following:
rmsyscfg -r prof -m <managed system> -n <profile name> -p <partition name>
The partition ID can be specified instead of the partition name by using the --id parameter in place of the -p parameter
8.0 Working with System Profiles
Creating a System Profile
Use the mksyscfg command to create a system profile. In the following example, the user is making a system profile named sysprof1, with partition profile prof1 for partition lpar1 and partition profile prof1 for partition lpar2.
mksyscfg -r sysprof -m <managed system> –i "name=sysprof1,\"lpar_names=lpar1,lpar2\", \"profile_names=prof1,prof1\""
Partition IDs can be specified instead of partition names when creating a system profile. This is done by using the lpar_ids attribute instead of the lpar_names attribute.
Instead of entering configuration information on the command line with the-i flag, the information can instead be placed in a file, and the filename specified with the -f flag.
Activating a System Profile
Use the chsysstate command to activate a system profile. Type the following:
chsysstate -r sysprof -m <managed system> -o on -n <system profile name>
Validating a System Profile
Use the chsysstate command to validate a system profile. Type the following:
chsysstate -r sysprof -m <managed system> -n <system profile name> - -test
To validate a system profile, then activate that system profile if the validation is successful, type the following:
chsysstate -r sysprof -m <managed system> -o on -n <system profile name> - -test
Deleting a System Profile
Use the rmsyscfg command to remove a system profile. Type the following:
rmsyscfg -r sysprof -m <managed system> -n <system profile name>
Listing System Profile Properties
Use the lssyscfg command to list a system profile’s properties. Type the following:
lssyscfg -r sysprof -m <managed system> --filter "profile_names=<system profile name>"
To list all system profiles for the managed system, type the following:
lssyscfg -r sysprof -m <managed system>
Modifying System Profile Properties
Use the chsyscfg command to modify system profile properties. In the following example, the user is adding profiles prof1 for partition lpar3 and prof2 for partition lpar4 to system profile sysprof1:
chsyscfg -r sysprof -m <managed system> -i "name=sysprof1,\"lpar_names+=lpar3,lpar4\",
\"profile_names+=prof1,prof2\""
Valid attributes, specified with the –i flag, include:
new_name
profile_names
lpar_names | lpar_ids
name
Instead of entering configuration information on the command line with the-i flag, the information can instead be placed in a file, and the filename specified with the -f flag.
For more information about the valid attributes listed in this command example, refer to the Command Attributes table.
6.0 Performing DLPAR Operations
Use the chhwres command to to perform dynamic logical partitioning (DLPAR) operations on running partitions. DLPAR operations can be performed for memory, physical I/O slots, and processor resources.
Memory
Memory can be dynamically added to a partition, removed from a partition, or moved from one partition to another. In the following commands, the quantity of memory to be added, removed, or moved must be specified with the -q flag. This quantity is in megabytes, and must be a multiple of the memory region size for the managed system.
Determining Memory Region Size
To see what the memory region size is for the managed system, enter this command:
lshwres -r mem -m <managed system> –-level sys -F mem_region_size
The value returned is the memory region size in megabytes.
Adding Memory to a Partition
To add memory to a partition, enter this command:
chhwres -r mem -m <managed system> -o a -p <partition name> -q <quantity>
Removing Memory from a Partition
To remove memory from a partition, enter this command:
chhwres -r mem -m <managed system> -o r -p <partition name> -q <quantity>
Moving Memory from One Partition to Another
To move memory from one partition to another partition, enter this command:
chhwres -r mem -m <managed system> -o m -p <source partition name> -t <target partition name> -q <quantity>
Physical I/O Slots
A physical I/O slot can be dynamically added to a partition, removed from a partition, or moved from one partition to another. In the following commands, the DRC index of the I/O slot to be added, removed, or moved must be specified with the -s flag.
Note that only one physical I/O slot can be added, removed, or moved at a time.
Determining DRC Indexes for Physical I/O Slots
To see the DRC indexes for all of the physical I/O slots that are on the managed system, enter this command:
lshwres -r io --rsubtype slot -m <managed system>
The DRC index for each slot is returned via the drc_index attribute.
Adding a Physical I/O Slot to a Partition
To add a physical I/O slot to a partition, enter this command:
chhwres -r io -m <managed system> -o a -p <partition name> -s <DRC index>
Removing a Physical I/O Slot from a Partition
To remove a physical I/O slot from a partition, enter this command:
chhwres -r io -m <managed system> -o r -p <partition name> -s <DRC index>
Moving a Physical I/O Slot from One Partition to Another
To move a physical I/O slot from one partition to another partition, enter this command:
chhwres -r io -m <managed system> -o m -p <source partition name> -t <target partition name> -s <DRC index>
Processors
Processing resources can be dynamically added to a partition, removed from a partition, or moved from one partition to another. These processing resources depend on the type of processors used by the partitions:
For partitions using dedicated processors, processing resources are dedicated processors.
For partitions using shared processors, processing resources include virtual processors and processing units.
Note: Currently, AIX/Linux partitions using shared processors do not support processor DLPAR operations.
In the following commands, for partitions using dedicated processors, the quantity of processors to be added, removed, or moved are specified with the --procs flag.
For partitions using shared processors, the quantity of virtual processors to be added, removed, or moved are also specified with the --procs flag. The quantity of processing units to be added, removed, or moved are specified with the --procunits flag. Both of these flags can be specified, but only one is required.
Note that the quantity of processing units must be multiplied by 100 for the command. For example, to add, remove, or move .5 processing units, specify a quantity of 50.
Adding Processors to a Partition
To add processors to a partition using dedicated processors, enter this command:
chhwres -r proc -m <managed system> -o a -p <partition name> --procs <quantity>
To add processors to a partition using shared processors, enter this command:
chhwres -r proc -m <managed system> -o a -p <partition name> --procs <quantity> --procunits <quantity>
Removing Processors from a Partition
To remove processors from a partition using dedicated processors, enter this command:
chhwres -r proc -m <managed system> -o r -p <partition name> --procs <quantity>
To remove processors from a partition using shared processors, enter this command:
chhwres -r proc -m <managed system> -o r -p <partition name> --procs <quantity> --procunits <quantity>
Moving Processors from One Partition to Another
To move processors from a partition using dedicated processors to another, enter this command:
chhwres -r proc -m <managed system> -o m -p <source partition name> -t <target partition name> --procs <quantity>
To move processors from a partition using shared processors to another, enter this command:
chhwres -r proc -m <managed system> -o m -p <source partition name> -t <target partition name> --procs <quantity> --procunits <quantity>
Processing resources can also be moved between partitions using dedicated processors and partitions using shared processors. To move processing resources from a partition using dedicated processors to a partition using shared processors, specify the quantity of processors using the --procs flag. This quantity is converted to processing units (by multiplying the quantity by 100) by the HMC for the target partition.
To move processing resources from a partition using shared processors to a partition using dedicated processors, specify the quantity of processing units (which must be a multiple of 100) using the --procunits flag. This quantity is converted to processors (by dividing the quantity by 100) by the HMC for the target partition. The --procs flag cannot be specified in this case.
