lswlmconf Command

Purpose

Lists Workload Manager (WLM) configurations.

Syntax

lswlmconf [ -r | -s | -c | -d Config ] [ -l ] [ -t TimeSpec ]

Description

The lswlmconf command lists by default all WLM configurations and, using its flags, it is able to do the following:

Tell which is the current configuration or set name.
Give the list of all existing regular WLM configurations.
Give the list of all existing WLM configuration sets.
Tell which configuration of a set is (or would be) applicable currently (or at some time of the week).
Tell the type of a configuration.

Flags

Item	Description
-c	Restricts the displayed configurations to the current configuration or set.
-d Config	Restricts the displayed configurations to the Config configuration or set.
-l	Modifies the way dates are displayed for configuration sets (ineffective for regular configurations). Sets are displayed with their currently applicable regular configuration, in the form confset/config.
-r	Restricts the displayed configurations to regular configurations only.
-s	Restricts the displayed configurations to configuration sets only.
-t TimeSpec	Uses TimeSpec instead of the current time to display applicable regular configuration of sets. TimeSpec consists in the day of the week (0 for Sunday to 6 for Saturday) and the time of the day in 24 hours format separated with a comma, in a form similar to time ranges as described in the confsetcntrl command. For example, to know which configuration would apply on Mondays at noon, use `-t 1,12:00`. Note: The -t flag is only effective with -l flag.

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 as follows:
```
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
```
Now, use the lswlmconf command to show the new configuration set, as follows:
```
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, use the wlmcheck command as follows:

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 configurations or sets files are subdirectories of /etc/wlm.