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.

  1. 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
  2. To show the current WLM configuration, type:
    lswlmconf -c
    The output might look similar to the following:
    fvtlimits
  3. 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.
  4. In order to create a configuration set using standard as the default configuration, type:
    confsetcntrl -C confset1 standard
  5. Now, use the lswlmconf command to show the new configuration set, as follows:
    lswlmconf -s
    The command now produces the following output:
    confset1
  6. 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
  7. 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
  8. In order to add another time range for using the fvtregul configuration on Sundays, type:
    confsetcntrl -d confset1 -a fvtregul 0
  9. 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 = "-"
  10. 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
  11. 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
  12. 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
  13. In order to remove configuration set confset2, type:
    confsetcntrl -D confset2
    lswlmconf -s now produces the following output in this example:
    confset1
  14. 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
  15. 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.