asoo Command

Edit online

Purpose

Manages the tunable parameters of the active system optimizer (ASO).

Syntax

asoo [-p|-r [-K]] [-y] {-o Tunable [=Newvalue]}

asoo [-p|-r [-K]] [-y] {-d Tunable }

asoo [-p|-r [-K]] [-y] -D

asoo [-p|-r | -K] [-F] -a

asoo [-h] [Tunable]

asoo [-F] [-K] -L [Tunable]

asoo [-F] [-K] -x [Tunable]

Note: Multiple options, such as-o, -d, -x, and -L, are allowed.

Description

The asoo command is used to configure the ASO tunable parameters. This command sets or displays the current or next boot values for all ASO tunable parameters. It also makes permanent changes or defers changes until the next reboot operation.

Whether the command sets or displays a parameter is determined by the accompanying flag. The -o flag performs both actions. It can either display the value of a parameter or set a new value for a parameter.

Note: If used incorrectly, the asoo command can cause serious performance degradation or operating system failure.

Before changing any tunable parameter, first carefully read about all the tunable parameter characteristics in the Tunable Parameters section , and follow any Refer To pointer to fully understand its purpose. You must then ensure that the Diagnosis and Tuning sections for this parameter actually apply to your situation and that changing the value of this parameter could help improve the performance of your system. If the Diagnosis and Tuning sections both contain only N/A, do not change this parameter unless specifically directed by the AIX.

Flags

Item Description
-a Displays current value, reboot value (when used with the -r option), Live Update value (when used with the -K option), or permanent values for all tunable parameters (when used with the -p option), one per line in pairs Tunable = Value. For the permanent options, a value only displays for a parameter if its reboot and current values are equal. Otherwise, it displays NONE as the value.
-d Tunable Resets the Tunable parameters to its default value. If a Tunable parameter, which must be changed because it is not set to its default value, meets one or more of the following sets of criteria, a warning message is displayed and no change is made to the parameter:
  • The tunable parameter is of type Bosboot or Reboot.
  • The tunable parameter is of type Incremental and was changed from its default value, and the -r flag is not used in combination.
  • The tunable parameter is of type Reboot and is supported across the Live Update operation.
-D Resets all Tunable parameters to their default values. If Tunables that need to be changed because they are not set to their default values meet one or more of the following sets of criteria, a warning message is displayed and no change is made:
  • The tunable is of type Bosboot or Reboot.
  • The tunable is of type Incremental and was changed from its default value, and -r is not used in combination.
  • The tunable parameter is of type Reboot and is supported across the Live Update operation.
-F Forces display of the restricted tunable parameters when the -a, -L, and -x options are specified alone on the command line to list all tunable parameters. When the -F flag is not specified, restricted tunable parameters are not displayed, unless these restricted tunable parameters are specifically named with a display option.
-h Tunable Displays help about the tunable parameter if the parameter is specified. Otherwise, displays the asoo command usage statement.
-K Sets the tunable parameter value in both /etc/tunables/nextboot and /etc/tunables/nextliveupdate files. The -K flag can be used only with the -r flag.

When you specify the -K flag with the -r and -d (or -D) flags, the tunable parameter value is set to its default value in the /etc/tunables/nextboot and /etc/tunables/nextliveupdate files to be used during the next boot or Live Update operations.

When you specify the -K flag with the -L or -x flag, the asoo command displays the Live Update values.
-L Tunable Lists the characteristics of one or all tunable parameters, one per line, using the following format. If you specify the -K flag with the -L flag, the Live Update values are also displayed.
NAME          CUR     DEF    BOOT    MIN      MAX    UNIT    TYPE
    DEPENDENCIES
-----------------------------------------------------------------
aso_active      1      1       1       0       1     boolean    D
-----------------------------------------------------------------
where:
	CUR = current value
	DEF = default value
	BOOT = reboot value
	MIN = minimal value
	MAX = maximum value
	UNIT = tunable unit of measure
	TYPE = parameter type: D (for Dynamic), S (for Static), R (for Reboot),
	     B (for Bosboot), M (for Mount), I (for Incremental),
	     C (for Connect), and d (for Deprecated)
       DEPENDENCIES = list of dependent tunable parameters, one per line
-o Tunable=[NewValue] Displays or sets the value of a tunable parameter to a new value. The /etc/tunables/usermodified file is updated with the new tunable parameter value whenever you use the -o flag to change the value of a dynamic tunable. If a tunable parameter that you want to change meets one or more of the following sets of criteria, a warning message is displayed and no change is made to the parameter:
  • The tunable parameter is of type Bosboot or Reboot.
  • The tunable parameter is of type Incremental, and its current value is greater than the specified value, and the -r flag is not used in combination.
  • The tunable parameter is of type Reboot, and the tunable parameter is supported across the Live Update operation.

When you specify the -r flag with the -o flag without specifying a new value, the next boot value for tunable is displayed. When you specify the -K flag with the -o flag without specifying a new value, the value of tunable parameter of type Live Update in the nextliveupdate file is displayed. When you specify the -p flag with the -o flag without specifying a new value, a value is displayed only if the current and next boot values for the tunable are the same. Otherwise, NONE is displayed as the value.
-p

When the -p option is used in combination without a new value, a value is displayed only if the current and next boot values for tunable parameter are the same. Otherwise, it displays NONE as the value.

When used in combination with the -o, -d, or -D options, this flag applies changes to both the current and reboot values. That is, this flag turns on the updating function of the /etc/tunables/nextboot file in addition to turning on the updating function of the current value. These combinations cannot be used on the Reboot and Bosboot type parameters because their current value cannot be changed.

When used with the -a or -o options without specifying a new value, values are displayed only if the current and next boot values for a parameter are the same. Otherwise, it displays NONE as the value.
-r

When the -r option is used in combination with the -o, -d, or -D options, this flag applies changes to the reboot values, for example, turns on the updating function of the /etc/tunables/nextboot file. If any parameter of type Bosboot is changed, you are prompted to run the bosboot command.

When used with the -a or the -o flags without specifying a new value, next boot values for tunable parameters are displayed instead of current values. When used with the -K flag, changes apply to both the /etc/tunables/nextboot and /etc/tunables/nextliveupdate files.
-x [Tunable] Lists characteristics of one or all tunable parameter, one per line, by using the following (spreadsheet) format. If you specify the -K flag with the -x flag, the Live Update values are also displayed.
tunable,current,default,reboot,min,max,unit,type,{dtunable}

where:
       current = current value
       default = default value
       reboot = reboot value
       min = minimal value
       max = maximum value
       unit = tunable unit of measure
       type = parameter type: D (for Dynamic), S (for Static), R (for Reboot),
	    B (for Bosboot), M (for Mount), I (for Incremental),
	    C (for Connect), and d (for Deprecated)
       dtunable = list of dependent tunable parameters
-y Suppresses the confirmation prompt before running the bosboot command.
If you make any change (with the -o, -d, or -D option) to a restricted tunable parameter, it results in a warning message that a tunable parameter of the restricted use type has been changed. If you also specify the -r or -p options on the command line, you are prompted for confirmation of the change. In addition, at system reboot, the presence of restricted tunable parameter in the /etc/tunables/nextboot file, which were changed to a value that is different from the default value (by using a command line for specifying the -r or -p options), results in an error log entry that identifies the list of these changed tunable parameters.

Tunable Parameters Type

All the tunable parameters that are manipulated by the tuning commands (no, nfso, vmo, ioo, schedo, raso, and asoo) are classified into the following categories:

Item Description
Dynamic The parameter can be changed at any time.
Static The parameter can never be changed.
Reboot The parameter can only be changed a during reboot operation.
Bosboot The parameter can only be changed by running the bosboot command, and rebooting the system.
Mount Changes to the parameter are only effective for future file systems or directory mounts.
Incremental The parameter can only be incremented at boot time.
Connect Changes to the parameter are only effective for future socket connections.
Deprecated Changes to this parameter are no longer supported by the current release of AIX.

For parameters of the Bosboot type, whenever a change is performed, the tuning commands automatically prompt you to determine whether you want to run the bosboot command. For parameters of the Connect type, the tuning commands automatically restarts the inetd daemon.

Note: The current set of parameters that are managed by the asoo command only includes the Dynamic and Reboot types of tunable parameters.

Tunable Parameters

For default values and range of values for tunable parameters, see the help information for the asoo command (-h<tunable_parameter_name>).

Item Description
aso_active
Purpose
Disables the ASO.
Tuning

A value of 0 indicates that the ASO is disabled. A value of 1 indicates that the ASO is enabled.
debug_level
Purpose
Changes the debug level of the ASO.
Tuning

A value of -1 (default) indicates that no debug information is collected. A value that is greater than -1 indicates that all levels of debug information at or below the level specified by this tunable parameter is collected. The location of the data collected is specified by the aso.debug entry in the /etc/syslog.conf file.

Security

Attention RBAC users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, ee the lssecattr command or the getcmdattr subcommand.

Examples

  1. To list the current and reboot values, the range, the unit, the type, and dependencies of all the tunable parameters that are managed by the asoo command, enter: 
    asoo -L
  2. To list (spreadsheet format) the current and reboot values, the range, the unit, the type, and dependencies of all the tunable parameters that are managed by the asoo command, enter: 
    asoo -x
  3. To reset the aso_active tunable parameter to the default, enter: 
    asoo -d aso_active
  4. To display help information for the aso_active tunable parameter, enter: 
    asoo -h aso_active
  5. To permanently reset all the asoo tunable parameters to the default, enter: 
    asoo -p -D
  6. To list the reboot value for all the asoo parameters, enter: 
    asoo -r -a