Using and Administering

llclass - Query Class Information

Purpose

Returns information about classes.

Syntax

llclass [-?] [-H] [-v] [-l] [classlist]

Flags

-?
Provides a short usage message.

-H
Provides entended help information.

-v
Outputs the name of the command, release number, service level, service level date, and operating system used to build the command.

-l
Specifies that a long listing be generated for each class for which status is requested. If -l is not specified, then the standard listing is generated.

classlist
Is a blank-delimited list of classes for which you are requesting status. If no classlist is specified, all classes are queried.

If you have more than a few classes configured for LoadLeveler, consider redirecting the output to a file when you use the -l flag.

Examples

This example generates a long listing for classes named silver and gold:

llclass -l silver gold

Results

The Standard Listing: . The standard listing is generated when you do not specify -l with the llclass command. The following is sample output from the llclass silver command, where there are five silver classes configured in the cluster, with one silver class job currently running:

+--------------------------------------------------------------------------------+
|Name               MaxJobCPU     MaxProcCPU  Free   Max Description             |
|                  d+hh:mm:ss     d+hh:mm:ss Slots Slots                         |
|                                                                                |
|silver            0+00:30:00     0+00:10:00     4     5 silver grade jobs       |
+--------------------------------------------------------------------------------+

The standard listing includes the following fields:

MaxJobCPU
The CPU limit for all the processes in a job of this class. For a parallel job, this is the CPU limit for all processes in a task.

MaxProcCPU
The CPU limit for processes in this class.

Free Slots
The number of free slots (available classes) on this machine.

Max Slots
The total number of slots (configured classes) on this cluster.

Description
The description of this class.

The Long Listing: The long listing is generated when you specify the -l option on the llclass command. The following is sample output from the llclass -l silver command, where there are five silver classes configured in the cluster, with one silver class job currently running:

+--------------------------------------------------------------------------------+
|                                                                                |
|=============== Class silver ===============                                    |
|                Name: silver                                                    |
|            Priority: 50                                                        |
|       Exclude_Users: user1                                                     |
|      Exclude_Groups: 85ba                                                      |
|               Admin: loadl:brownap:alice                                       |
|           NQS_class: F                                                         |
|          NQS_submit:                                                           |
|           NQS_query:                                                           |
|      Max_processors: 1                                                         |
|             Maxjobs: 15                                                        |
|Resource_requirement: spice2g6(2)                                               |
|       Class_comment: silver grade jobs                                         |
|    Wall_clock_limit:   0+02:00:00,   0+01:00:00                                |
|       Job_cpu_limit:   0+00:59:59,   0+00:29:29                                |
|           Cpu_limit:   0+00:30:00,   0+00:10:00                                |
|          Data_limit: -1, -1                                                    |
|          Core_limit: -1, -1                                                    |
|          File_limit: -1, -1                                                    |
|         Stack_limit: -1, -1                                                    |
|           Rss_limit: -1, -1                                                    |
|                Nice: 15                                                        |
|                Free: 13                                                        |
|             Maximum: 21                                                        |
|                                                                                |
+--------------------------------------------------------------------------------+

The long listing includes these fields:

Name
The name of the class

Priority
The system priority of this class relative to other classes.

Exclude_Users
Users who are not permitted to submit jobs of this class.

Exclude_Groups
Groups who are not allowed to submit jobs of this class.

Admin
The list of administrators of this class.

NQS_class
Indicates whether this class is a gateway for an NQS system.

NQS_submit
The NQS queue where the job will be submitted.

NQS_query
The NQS queues to query where the job has been dispatched.

Max_processors
The maximum number of processors than can be used for parallel jobs.

Max_jobs
The maximum number of jobs the class can run at any time.

Resource_requirement
Default consumable resource requirements for jobs of this class.

Class_comment
The text supplied by the administrator describing this class.

Wall_clock_limit
The hard and soft wall clock limits (the elapsed time for which the job can run).

Job_cpu_limit
The hard and soft CPU limits for all processes in a job of this class.

Cpu_limit
The hard and soft CPU limits for all processes in this class.

Data_limit
The hard and soft limits for the data area used for processes in this class.

Core_limit
The hard and soft core size limits.

File_limit
The hard and soft file size limits.

Stack_limit
The hard and soft stack size limits.

Rss_limit
The hard and soft rss size limits.

Nice
The nice value of jobs in this class.

Free
The number of classes available to new jobs.

Maximum
The total number of configured classes in this cluster.

Related Information

Each machine periodically updates the central manager with a snapshot of its environment. Since the information returned by llclass is a collection of these snapshots, all taken at varying times, the total picture may not be completely consistent.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]