lsclass Command

Purpose

List Workload Management classes and their limits.

Syntax

lsclass [ -C | -D | -f ] [ -r ] [ -d Config_Dir ] [ -S SuperClass ] [ Class ]

Description

The lsclass command, with no argument, returns the list of superclasses, one per line. With a class name as argument, it prints the class. The subclasses can be displayed with the -r (recursive) flag, or with the -S Superclass flag.

When WLM is started, if an empty string is passed as the name of the configuration with the -d flag, lsclass lists the classes defined in the in-core WLM data structures.

The lsclass command does not require any special level of privilege and is accessible for all users.

Note: If this command is given a set of time-based configurations (either specified with the -d flag, or because the current configuration is a set), the lsclass command returns the classes of the regular configuration which applies (or would apply) at the time the command is issued.

Flags

Item Description
-C Displays the class attributes and limits in colon-separated records, as follows:
lsclass -C myclass
#name:description:tier:inheritance:authuser:authgroup:
adminuser:admingroup:rset:CPUshares:CPUmin:
CPUsoftmax:CPUhardmax:memoryshares:memorymin:
memorysoftmax:memoryhardmax:diskIOshares:diskIOmin:
diskIOsoftmax:diskIOhardmax:totalCPUhardmax:
totalCPUunit:totalDiskIOhardmax:totalDiskIOunit:
totalConnecttimehardmax:totalConnecttimeunit:
totalProcesseshardmax:totalThreadshardmax:
totalLoginshardmax:
classRealMem:classRealMemunit:classVirtMem:
classVirtMemunit:classLargePages:classLargePagesunit:
procVirtMem:procVirtMemunit:localshm:vmenforce:delshm
myclass::0:no::::::-:0:100:100:-:1:100:100:-:0:100:
100:-:s:-:KB:-:s:-:-:-:-:KB:-:KB:-:KB:-:KB:no:proc:no
-d Config_Dir Use /etc/wlm/Config_Dir as alternate directory for the definition files. If an empty string is passed (for example, -d ""), lsclass lists the classes defined in the in-core WLM data structures. If this flag is not present, the current configuration files in the directory pointed to by /etc/wlm/current are used.
-D Displays the default values for the class attributes and limits in colon-separated records. Any other flag or argument used in conjunction with -D is ignored. For example:
lsclass -D
#name:description:tier:inheritance:authuser:
authgroup:adminuser:admingroup:rset:CPUshares:CPUmin:
CPUsoftmax:CPUhardmax:memoryshares:memorymin:
memorysoftmax:memoryhardmax:diskIOshares:diskIOmin:
diskIOsoftmax:diskIOhardmax:totalCPUhardmax:
totalCPUunit:totalDiskIOhardmax:totalDiskIOunit:
totalConnecttimehardmax:totalConnecttimeunit:
totalProcesseshardmax:totalThreadshardmax:totalLoginshardmax:
classRealMem:classRealMemunit:classVirtMem:
classVirtMemunit:classLargePages:classLargePagesunit:
procVirtMem:procVirtMemunit:localshm:vmenforce:delshm
::0:no::::::-:0:100:100:-:0:100:100:-:0:100:100:-:s:-:
KB:-:s:-:-:-:-:KB:-:KB:-:KB:-:KB:no:proc:no
-f Displays the output in stanzas, with each stanza identified by a class name. Each Attribute=Value pair is listed on a separate line:
Class:
       attribute1=value
       attribute2=value
       attribute3=value
-r Displays, recursively, the superclasses with all their subclasses. When specifying -r:
  • If Class is not specified, lsclass shows all the superclasses with all their subclasses.
  • If the name of a superclass is specified, lsclass displays the superclass with all its subclasses.
  • If the name of a subclass is specified, -r is ineffective (displays only the subclass).
-S SuperClass Restricts the scope of the command to the subclasses of the specified superclass. Only subclasses are shown with the -S flag.

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 AIX® Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Files

Item Description
classes Contains the names and definitions of the classes.
limits Contains the limits enforced on the classes.
shares Contains the resource shares attributes for each class.