confsetcntrl Command

Purpose

Manage a set of time-based Workload Manager (WLM) configurations.

Syntax

confsetcntrl -C ConfigurationSet DefaultConfig

confsetcntrl { -D | -R } ConfigurationSet

confsetcntrl [ -d ConfigurationSet ] { -a | -r } Configuration TimeRange

confsetcntrl [ -d ConfigurationSet ] [ -l | -c ]

Description

The confsetcntrl command supports the following operations:

Create a new configuration set with its initial default regular configuration.
Delete an existing configuration set (this includes the configuration set directory and its .times and description files, but does not affect the regular configurations of the set).
Add or remove from a configuration set a configuration and its associated time range.
Remove from a configuration set all configurations and associated time ranges.
Check the configuration set file.
List all the configurations contained in a set with their associated time ranges.

Note: Only the root user can create, delete, or change configuration sets, but any user can list or check them.

Time Ranges

Time ranges are used to indicate at which day of the week and which times of the day the associated configuration will be used by the WLM for classifying processes, for accounting, and regulation.

A time range is represented by a range of days, with 0 representing Sunday and 6 representing Saturday, and a range of time, in 24 hour format with hours and minutes specified. These two ranges are separated with a comma. In each range, values are separated with a minus sign, and values may wrap (the first value may be greater than the second one).

The range of days may be omitted, which means every day of the week. Both ends of this range are included. It may then also consist in only one day: 1 is valid and stands for 1-1.

The range of time may be omitted, which means the whole day. Elsewhere, start and end times must be specified. Hours and minutes are separated with a colon or a dot. The end time is not part of the range, so 24:00 is a valid end time but 12:00-12:00 is empty and not valid.

At least one of the day or time ranges must be present. A single minus sign is a valid time range and is a special case: It is called the default time range and means always outside the other defined time ranges if any. This is different from specifying all the time, for example with 0-6,00:00-24:00

For the WLM to be able to find which configuration must be activated, there must exist one and only one configuration applicable at any time of the week. The default time range, which is added when creating a set, is useful to avoid the possibility that no configuration would be applicable for some time. Additional time ranges must not overlap with each other.

Time range examples:

1-4,8:00-17:00: Monday to Thursday, from 8 am to 5 pm
5-0,22:00-6:00: Friday, Saturday and Sunday, from midnight to 6 am and from 10 pm to midnight
3: Wednesday
14:00-16:30: Every day from 2 pm to 4:30 pm
-: The default time range

Flags

Item	Description
-a Configuration TimeRange	Adds Configuration to the configuration set for the given TimeRange. Configuration must be an existing WLM regular configuration. It may appear several times in a set associated with different time ranges. Note: Even if time ranges become not coherent due to this operation, the changes are performed, but a warning is reported indicating that further changes are needed.
-c	Checks all the configuration/time range pairs of the set.
-C ConfigurationSet DefaultConfig	Creates configuration set ConfigurationSet with DefaultConfig initial configuration, having default time range. (The default time range means always outside any other explicit time range. Only one is allowed in a set.) DefaultConfig must be an existing WLM regular configuration.
-d ConfigurationSet	Specifies an alternate configuration set. If not given, current configuration set will be the target of the command.
-D ConfigurationSet	Deletes configuration set ConfigurationSet.
-l	Checks and lists all the configuration/time range pairs of the set. This is the default operation if no flag is given.
-r Configuration TimeRange	Removes the Configuration and TimeRange pair from the configuration set. This pair is supposed to exist in the set. Note: Even if time ranges become not coherent due to this operation, the changes are performed, but a warning is reported indicating that further changes are needed.
-R ConfigurationSet	Erases configuration set ConfigurationSet (removes from ConfigurationSet all configuration/time range pairs). This operation is not recommended as the resulting configuration set state is not consistent and requires additional changes.

Security

Attention RBAC users and Trusted AIX® 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, see the lssecattr command or the getcmdattr subcommand.

Examples

The following examples demonstrate how to display, change, and use WLM configurations using the lswlmconf command, the confsetcntrl command, the wlmcheck command, and the wlmcntrl command.

To find the WLM configurations, type:
```
lswlmconf
```
The output to this command might look similar to the following:
```
standard
template
fvtrules
fvtlimits
fvtregul
fvtdfct
fvtsynt
fvtthreads
```
To show the current WLM configuration, type:
```
lswlmconf -c
```
The output might look similar to the following:
```
fvtlimits
```
To show configuration sets, use the lswlmconf with the -s flag, type:
```
lswlmconf -s
```
Since this example configuration contains no configuration sets, this command produces a message indicating that no matching configuration was found.
In order to create a configuration set using "standard" as the default configuration, type:
```
confsetcntrl -C confset1 standard
```
To use the lswlmconf command to show the new configuration set, type:
```
lswlmconf -s
```
The command now produces the following output:
```
confset1
```
In order to use the "fvtlimits" configuration for "confset1" on week days (Monday through Friday) by specifying a time range, type:
```
confsetcntrl -d confset1 -a fvtlimits 1-5
```
You might want this configuration only in the morning. You cannot change a time range. Instead you must remove the time range and then create a new time range.
First, remove the old time range, as follows (confsetcntrl accepts day names, as reported by "locale day" or "locale abday" commands):
```
confsetcntrl -d confset1 -r fvtlimits monday-friday
```
Then create the new time range, as follows:
```
confsetcntrl -d confset1 -a fvtlimits 1-5,8:00-12:00
```
In order to add another time range for using the "fvtregul" configuration on Sundays, type:
```
confsetcntrl -d confset1 -a fvtregul 0
```

In order to display configuration set "confset1", type:

confsetcntrl -d confset1

In this example, this command produces the following output:

fvtlimits:
        time = "1-5,8:00-12:00"

fvtregul:
        time = "0"

standard:
        time = "-"

In order to create a configuration set called "confset2" using "template" as the default configuration, type:
```
confsetcntrl -C confset2 template
```
In order change "confset2' so it will use the configuration "fvtsynt" every nigh, type:
```
confsetcntrl -d confset2 -a fvtsynt 18:00-10:00
```
In order to display the list of regular configurations, type:
```
lswlmconf -r
```
In this example, this produces the following output, (which demonstrates that in this example the list of regular configurations has not changed):
```
standard
template
fvtrules
fvtlimits
fvtregul
fvtdfct
fvtsynt
fvtthreads
```
However, as expected, the list of configurations sets in this example has changed, as shown by the following command:
```
lswlmconf -s
```
This command produces the following output in this example:
```
confset1
confset2
```
In order to show which configuration would be currently active when that the date command reports the current time as "Tue Jul 16 18:55:10 EET 2002" with configuration set "confset2", type:
```
lswlmconf -d confset2 -l
```
In this example, this command produces the following output:
```
confset2/fvtsynt
```
You can also show which configurations would be active at another time. To show which configurations would be active on Sunday at 9:00am, type:
```
lswlmconf -l -t 0,9:00
```
This command produces the following output in this example:
```
standard
template
fvtrules
fvtlimits
fvtregul
fvtdfct
fvtsynt
fvtthreads
confset1/fvtregul
confset2/fvtsynt
```
In order to display this information only for configuration sets, type:
```
lswlmconf -s -l -t 0,9:00
```
This produces the following output in this example:
```
confset1/fvtregul
confset2/fvtsynt
```
In order to remove configuration set "confset2", type:
```
confsetcntrl -D confset2
```
lswlmconf -s now produces the following output in this example:
```
confset1
```

In order to check configuration set "confset1", using the wlmcheck command, type:

wlmcheck -d confset1

In this example, this produces the following output:

WLM is not running.
Checking classes and rules for 'confset1' configuration...
fvtlimits/System
fvtlimits/Default
fvtlimits/Shared
fvtlimits/login
fvtregul/System
fvtregul/Default
fvtregul/Shared
standard/System
standard/Default
standard/Shared

In order to start using configuration set "confset1" used in this example, type:
```
wlmcntrl -a -d confset1
```
The command lswlmconf -c now produces the following output:
```
confset1
```
The command lswlmconf -cl, which shows the active regular configuration, now produces the following output:
```
confset1/standard
```

Files

The configuration set files reside in a subdirectory of /etc/wlm whose name is the set name.

Item	Description
.times	Contains the list of all the configuration/time range pairs of the set.
description	Contains an optional description text of the set.