[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 4

rmclass Command

Purpose

Remove a Workload Management class.

Syntax

rmclass [ -d Config_Dir ] [ -S SuperClass ] Name

Description

The rmclass command removes the superclass or the subclass identified by the Name parameter from the class definition file, the class limits file and the class shares file. The class must already exist. The predefined Default, System, and Shared classes cannot be removed.

In addition, when removing a superclass Super, the directory /etc/wlm/Config_Dir/Super and all the WLM property files it contains (if they exist) are removed. Removing a superclass fails if any user created subclass still exists (subclass other than Default and Shared).

Note: Only root can remove a superclass. Only root or authorized users whose user ID or group ID matches the user name or group name specified in the attributes adminuser and admingroup of a superclass can remove a subclass of this superclass.

Normally, rmclass deletes the class and its attributes in the relevant WLM property files, and the modifications are applied to the in-core class definitions (active classes) only after an update of WLM using the wlmcntrl command.

If an empty string is passed as the configuration name (Config_dir) with the -d flag, the class is deleted only in the WLM in-core data structures, and no property file is updated. So, if the class is still defined in a WLM configuration, it is recreated after an update or restart of WLM. This flag should be mainly used to remove classes dynamically created in the in-core WLM data structures only by applications using the WLM API, for example, to do some cleanup after application failure.

Note
This command cannot apply to a set of time-based configurations (do not specify a set with the -d flag). If the current configuration is a set, the -d flag must be given to indicate which regular configuration the command should apply to.

Flags

-d Config_Dir Uses /etc/wlm/Config_dir as alternate directory for the properties files. If this flag is not used, the configuration files in the directory pointed to by /etc/wlm/current are used. If an empty string is passed as the configuration name (-d "") the class is deleted only in the WLM in-core data structures and no configuration file is modified.
-S SuperClass Specifies the name of the superclass when removing a subclass. There are two ways of specifying the subclass Sub of superclass Super:
  1. Specify the full name of the subclass as Super.Sub and do not use -S.
  2. Specify the -S flag to give the superclass name and use the short name for the subclass:

    rmclass options -S Super  Sub

Files

classes Contains the names and definitions of the classes.
limits Contains the resource limits.
shares Contains the resource shares.

Related Information

The wlmcntrl command, lsclass command, chclass command, and mkclass command.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]