HMC Manual Reference Pages  - CHPWRMGMT (1)

NAME

chpwrmgmt - change power management settings

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

To enable or disable power saver mode:
chpwrmgmt -m managed-system -r sys -o {enable | disable}
[-t {static | dynamic_favor_perf | dynamic_favor_power |
fixed_max_frequency | idle}] [--help]

To set or reset dynamic or idle power saver parameters:
chpwrmgmt -m managed-system -r sys -o {set | reset}
-t {dynamic_parms | idle_parms} [-a "attributes"]
[--help]

DESCRIPTION

chpwrmgmt configures the power management settings for the managed-system.

OPTIONS

-m The name of the managed system for which to configure power management settings. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name.
-r The type of resource for which to configure power management settings. The only valid value is sys for managed system.
-o The operation to perform. Valid values are enable to enable power saver mode, disable to disable power saver mode, set to set dynamic or idle power saver parameters, and reset to reset dynamic or idle power saver parameters to their default values.

Warning: enabling any of the power saver modes will cause changes in processor frequencies, changes in processor utilization, and changes in power consumption, which can cause performance of the managed system to vary.

Warning: changing dynamic or idle power saver parameters can result in unexpected behavior and performance impacts. It is recommended that you consult your system provider before changing dynamic or idle power saver parameters.

-t The type of power saver mode to enable or the type of power saver parameters to set or reset. Valid power saver mode types are static for static power saver mode, dynamic_favor_perf for dynamic power saver mode favoring performance, dynamic_favor_power for dynamic power saver mode favoring power, fixed_max_frequency for fixed maximum frequency power saver mode, and idle for idle power saver mode. Valid power saver parameter types are dynamic_parms for dynamic power saver tuning parameters and idle_parms for idle power saver parameters.

When enabling power saver mode, static power saver mode will be enabled if this option is not specified. With the exception of idle power saver mode, only one power saver mode can be enabled at a time. Idle power saver mode can be enabled independently of all other modes.

To disable idle power saver mode, you must specify idle with this option. Otherwise, this option is not allowed when disabling power saver mode, as the current power saver mode will be disabled.

-a The power saver parameters to set. The data consists of attribute name/value pairs, which are in comma separated value (CSV) format.

The format of the attribute data is as follows:

attribute-name=value,attribute-name=value,...

The valid attribute names for setting dynamic power saver tuning parameters are listed below. Issue the lspwrmgmt -m managed-system -r sys -t dynamic_parms command to display the minimum and maximum values allowed for each parameter.

util_thresh_incr_freq
percentage with up to 1 decimal place
util_thresh_decr_freq
percentage with up to 1 decimal place
num_samples_util_stats
integer
freq_step_up_size
percentage with up to 1 decimal place
freq_step_down_size
percentage with up to 1 decimal place
active_cores_delta
percentage
active_slack_cores_util_thresh
percentage with up to 1 decimal place
core_freq_delta_state
Valid values:
0 - disable
1 - enable
core_max_freq_delta
percentage

The valid attribute names for setting idle power saver parameters are listed below. Issue the lspwrmgmt -m managed-system -r sys -t idle_parms command to display the minimum and maximum values allowed for each parameter.

enter_delay_seconds
integer
exit_delay_seconds
integer
enter_util_thresh
percentage
exit_util_thresh
percentage

This option is required when setting dynamic or idle power saver parameters. Otherwise this option is not valid.

--help Display the help text for this command and exit.

EXAMPLES

Enable static power saver mode on managed system system1:

chpwrmgmt -m system1 -r sys -o enable

or

chpwrmgmt -m system1 -r sys -o enable -t static

Enable dynamic power saver mode favoring performance on managed system system1:

chpwrmgmt -m system1 -r sys -o enable -t dynamic_favor_perf

Enable idle power saver mode on managed system system1:

chpwrmgmt -m system1 -r sys -o enable -t idle

Disable the current power saver mode on managed system 9117-MMA*1234567:

chpwrmgmt -m 9117-MMA*1234567 -r sys -o disable

Disable idle power saver mode on managed system system1:

chpwrmgmt -m system1 -r sys -o disable -t idle

Set the utilization thresholds for increasing and decreasing frequency on managed system system1 to 95.5%:

chpwrmgmt -m system1 -r sys -o set -t dynamic_parms
-a "util_thresh_incr_freq=95.5,util_thresh_decr_freq=95.5"

Reset the dynamic power saver tuning parameters on managed system system1 to their default values:

chpwrmgmt -m system1 -r sys -o reset -t dynamic_parms

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

SEE ALSO

lspwrmgmt


Linux CHPWRMGMT (1) "November 2015"
Generated by manServer 1.07 from chpwrmgmt.1 using man macros.