IBM LoadLeveler for AIX 5L: 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 intended 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 Parallel command, where there are 24 initiators of class Parallel configured in the cluster, with one job step of class Parallel using 6 initiators currently running:

+--------------------------------------------------------------------------------+
|Name               MaxJobCPU     MaxProcCPU   Free    Max    Description        |
|                  d+hh:mm:ss     d+hh:mm:ss  Slots  Slots                       |
|                                                                                |
|Parallel          2+02:45:00       05:30:00     18     24    Parallel job class |
+--------------------------------------------------------------------------------+

The standard listing includes the following fields:

Name: The name of the class.
MaxJobCPU: The hard job CPU limit of job steps for the specified class. See job_cpu_limit for a description of job CPU limit for serial and parallel job steps.
MaxProcCPU: The hard CPU limit for the processes of the job steps of the specified class.
Free Slots: The number of initiators (slots) available for the specified class in the LoadLeveler cluster. A serial job step uses one initiator at run time. A parallel job step with N tasks uses N initiators at run time.
Max Slots: The number of configured initiators (slots) for the specified class in the LoadLeveler cluster.
Description: Lists the information provided in the class_comment keyword for the specified class. The class_comment keyword is defined in the class stanza of the LoadLeveler administration file.

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 Parallel command, where there are 24 initiators of class Parallel configured in the cluster, with one job step of class Parallel using 6 initiators currently running:

+--------------------------------------------------------------------------------+
|=============== Class Parallel ===============                                  |
|                Name: Parallel                                                  |
|            Priority: 70                                                        |
|       Exclude_Users:                                                           |
|       Include_Users: aliceb johnmt loadl rhclark srherb                        |
|      Exclude_Groups:                                                           |
|      Include_Groups: chemistry physics                                         |
|               Admin: loadl brownap alice                                       |
|           NQS_class: F                                                         |
|          NQS_submit:                                                           |
|           NQS_query:                                                           |
|      Max_processors: -1                                                        |
|             Maxjobs: -1                                                        |
|Resource_requirement: cons_res1(1) cons_res2(3)                                 |
|       Class_comment: Parallel job class                                        |
|Checkpoint_directory:                                                           |
|          Ckpt_limit: undefined, undefined                                      |
|    Wall_clock_limit: 10+10:30:01, 9+14:55:00 (901801 seconds, 831300 seconds)  |
|       Job_cpu_limit: 2+02:45:00, 2+01:30:00 (182700 seconds, 178200 seconds)   |
|           Cpu_limit: 05:30:00, 05:00:01 (19800 seconds, 18001 seconds)         |
|          Data_limit: 5.500 gb, 4.400 gb (5905580032 bytes, 4724464025 bytes)   |
|          Core_limit: 8.000 gb, 8.000 gb (8589934592 bytes, 8589934592 bytes)   |
|          File_limit: 1.500 tb, 1.200 tb (1649267441664 bytes, 1319413953331 byt|
|         Stack_limit: 400.000 mb, 300.000 mb (419430400 bytes, 314572800 bytes) |
|           Rss_limit: 3.000 pb, 2.000 pb (3377699720527872 bytes, 22517998136852|
|                Nice: 10                                                        |
|          Free_slots: 18                                                        |
|       Maximum_slots: 24                                                        |
|    Execution_factor: 1                                                         |
|     Max_total_tasks: 30                                                        |
|       Preempt_class: ALL { large } ENOUGH { small medium }                     |
|         Start_class: ( No_Class < 3 ) && ( 85ba < 10 )                         |
|                                                                                |
+--------------------------------------------------------------------------------+

The long listing includes these fields:

Admin: The list of administrators for the specified class.
Class_comment: Lists the information provided in the class_comment keyword for the specified class. The class_comment keyword is defined in the class stanza of the LoadLeveler administration file.
Ckpt_limit: Hard and soft checkpoint limits of a job step of the specified class.
Checkpoint_directory: The name of the directory containing the checkpointing files of job steps of the specified class.
Core_limit: The hard and soft core size limits of processes of job steps of the specified class.
Cpu_limit: The hard and soft CPU limits of processes of job steps of the specified class.
Data_limit: The hard and soft data area limits of processes of job steps of the specified class.
Exclude_Groups: Groups who are not allowed to submit jobs of the specified class.
Exclude_Users: Users who are not permitted to submit jobs of the specified class.
Execution_factor: Used only for Gang scheduling, Execution_factor sets the relative processing time for jobs of the specified class.
Free_slots: The number of available initiators (slots) for the specified class in the LoadLeveler cluster. A serial job step uses one initiator of the appropriate class at run time. A parallel job step with N tasks uses N initiators at run time.
File_limit: The hard and soft file size limits of processes of job steps of the specified class.
Include_Groups: Groups having permission to submit jobs of the specified class.
Include_Users: Users who are permitted to submit jobs of the specified class.
Job_cpu_limit: The hard and soft job CPU limits of job steps of the specified class. See job_cpu_limit for a description of job CPU limit for serial and parallel job steps.
Maximum_slots: The total number of configured initiators (slots) for the specified class in the LoadLeveler cluster.
Maxjobs: The maximum number of job steps of the specified class that can run at any time in the LoadLeveler cluster.
Max_processors: The maximum number of processors than can be used for a parallel job step of the specified class.
Max_total_tasks: Used only for Gang scheduling, Max_total_tasks sets the maximum number of tasks allowed to run at any given time for job steps of the specified class in the LoadLeveler cluster.
Name: The name of the class
Nice: The nice value of jobs of the specified class.
NQS_class: Indicates whether this class is a gateway for an NQS system.
NQS_query: The NQS queues to query where the job has been dispatched.
NQS_submit: The NQS queue where the job will be submitted.
Preempt_class: Used only for Gang scheduling, Preempt_class sets the preemption rule for job steps of the specified class.
Priority: The system priority of the specified class relative to other classes.
Resource_requirement: The default consumable resource requirements for job steps of the specified class.
Rss_limit: The hard and soft rss size limits of processes of job steps of the specified class.
Stack_limit: The hard and soft stack size limits of processes of job steps of the specified class.
Start_class: Used only for Gang scheduling, Start_class sets the starting rule for job steps of the specified class.
Wall_clock_limit: The hard and soft wall clock (elapsed time) limits of job steps of the specified class.

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 ]