Purpose
Returns job resource information on completed jobs for accounting purposes.
You must enable the recording of accounting data in order to generate any of the four throughput reports. To do this, specify ACCT=A_ON in your LoadL_config file. For more details, refer to Step 9: Define job accounting.
Syntax
llsummary [-?] [-H] [-v] [-x] [-l] [-s <MM/DD/YYYY> to <MM/DD/YYYY>] [-e <MM/DD/YYYY> to <MM/DD/YYYY>] [-g <group>] [-G <unixgroup>] [-a <allocated>] [-r <report>] [-j <jobname>] [-d <section>] [-c <class>] [-u <user>] [<filename>]
Flags
Related Information
In order to create an accounting report with the llsummary command, you must have read access to a history file. If a history file name is not specified as an argument, llsummary uses the history file in the LoadLeveler spool directory of the local machine as input. By default, the permissions of the spool directory are set by the llinit command to 700 at install time. However, these permissions may be changed by a system administrators with root privileges.
The file permissions of the history file created by a LoadL_schedd daemon are controlled by the HISTORY_PERMISSION configuration keyword. A specification such as HISTORY_PERMISSION = rw-rw-r-- will result in permission settings of 664. The default settings are 660.
Examples
The following example requests summary reports (standard listing) of all the jobs submitted on your machine between the days of September 12, 1999 and October 12, 1999:
llsummary -s 09/12/1999 to 10/12/1999
The Standard Listing: The standard listing is generated when you do not specify -l. -r, or -d with llsummary. This sample report includes summaries of the following data:
The following is an example of the standard listing:
+--------------------------------------------------------------------------------+ | Name Jobs Steps Job Cpu Starter Cpu Leverage | | krystal 15 36 0+00:09:50 0+00:00:10 59.0 | | lixin3 18 54 0+00:08:28 0+00:00:16 31.8 | | TOTAL 33 90 0+00:18:18 0+00:00:27 40.7 | | | | Class Jobs Steps Job Cpu Starter Cpu Leverage | | small 9 21 0+00:01:03 0+00:00:06 10.5 | | large 12 36 0+00:13:45 0+00:00:11 75.0 | | osl2 3 9 0+00:00:27 0+00:00:02 13.5 | | No_Class 9 24 0+00:03:01 0+00:00:06 30.2 | | TOTAL 33 90 0+00:18:18 0+00:00:27 40.7 | | | | Group Jobs Steps Job Cpu Starter Cpu Leverage | | No_Group 12 30 0+00:09:32 0+00:00:09 63.6 | | chemistry 7 18 0+00:04:50 0+00:00:05 58.0 | |engineering 14 42 0+00:03:56 0+00:00:12 19.7 | | TOTAL 33 90 0+00:18:18 0+00:00:27 40.7 | | | | Account Jobs Steps Job Cpu Starter Cpu Leverage | | 33333 16 39 0+00:05:54 0+00:00:11 32.2 | | 22222 15 45 0+00:12:05 0+00:00:13 55.8 | | 99999 2 6 0+00:00:18 0+00:00:01 18.0 | | TOTAL 33 90 0+00:18:18 0+00:00:27 40.7 | | | | | +--------------------------------------------------------------------------------+
The standard listing includes the following fields:
The -r Listing: The following is sample output from the llsummary -r throughput command. Only the user output is shown; the class, group, and account lines are not shown.
+--------------------------------------------------------------------------------+ | Name Jobs Steps AvgQueueTime AvgRealTime AvgCPUTime | | loadl 1 4 0+00:00:03 0+00:05:27 0+00:05:17 | | user1 2 6 0+00:03:05 0+00:03:45 0+00:03:04 | | ALL 3 10 0+00:01:52 0+00:04:26 0+00:03:58 | | | | Name Jobs Steps MinQueueTime MinRealTime MinCPUTime | | loadl 1 4 0+00:00:01 0+00:02:49 0+00:02:44 | | user1 2 6 0+00:02:02 0+00:03:43 0+00:03:02 | | ALL 3 10 0+00:00:01 0+00:02:49 0+00:02:44 | | | | Name Jobs Steps MaxQueueTime MaxRealTime MaxCPUTime | | loadl 1 4 0+00:00:06 0+00:12:58 0+00:12:37 | | user1 2 6 0+00:06:21 0+00:03:48 0+00:03:07 | | ALL 3 10 0+00:06:21 0+00:12:58 0+00:12:37 | +--------------------------------------------------------------------------------+
The -r listing includes the following fields:
The MaxQueueTime, MaxRealTime, and MaxCPUTime fields display the time of the job with the greatest amount of queue, wall clock, and CPU time, respectively. The ALL line for the Average listing displays the average time for all users, classes, groups, and accounts. The ALL line for the Minimum listing displays the time of the job with the least amount of time for all users, classes, groups, and accounts. The ALL line for the Maximum listing displays the time of the job with the greatest amount of time for all users, classes, groups, and accounts.
The Long Listing: If you specify both the -x and -l options when running the llsummary command, the generated output you receive will resemble the listing below. In this sample, c209f1n05.ppd.pok.ibm.com.2 is a parallel job consisting of one job step with four tasks. Two of these tasks are running on c209f1n05 and two tasks are running on c209f1n01.
| Note: | Job statistics for the running hosts are available separately. |
In this sample, you will find system defined events named started and completed. The listing also shows two installation defined events named user_event_1 and user_event_2. These two installation defined events are the result of accounting snapshots made while the job was running. A LoadLeveler administrator made the snapshots by issuing the commands, llctl -g capture user_event_1 and llctl -g capture user_event_2.
Figure 25. Output generated by llsummary -x -l command
+--------------------------------------------------------------------------------+ |================== Job c209f1n05.ppd.pok.ibm.com 2 ================== | | Job Id: c209f1n05.ppd.pok.ibm.com 2 | | Job Name: c209f1n05.ppd.pok.ibm.com.2 | | Structure Version: 210 | | Owner: loadl | | Unix Group: loadl | | Submitting Host: c209f1n05.ppd.pok.ibm.com | | Submitting Userid: 1064 | | Submitting Groupid: 222 | | Number of Steps: 1 | |------------------ Step c209f1n05.ppd.pok.ibm.com.2.0 ------------------ | | Job Step Id: c209f1n05.ppd.pok.ibm.com.2.0 | | Step Name: parallel_job_step_1 | | Queue Date: Fri Jul 27 17:52:59 EDT 2001 | | Dependency: | | Status: Completed | | Dispatch Time: Fri Jul 27 17:52:59 EDT 2001 | | Start Time: Fri Jul 27 17:53:00 EDT 2001 | | Completion Date: Fri Jul 27 17:55:12 EDT 2001 | | Completion Code: 0 | | Start Count: 1 | | User Priority: 50 | | user_sysprio: 50 | | class_sysprio: 45 | | group_sysprio: 0 | | Notifications: Complete | | Virtual Image Size: 800 kb | | Checkpointable: no | |Good Ckpt Time/Date: | | Ckpt Accum Time: 0 | | Checkpoint File: | | | +--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| Restart From Ckpt: no |
| Restart Same Nodes: no |
| Restart: yes |
| Hold Job Until: |
| Cmd: /bin/poe |
| Args: /tmp/PARA_50/ivp_cpu_60_60_sleep_60 -euilib us -ilevel 6 -l|
| Env: MANPATH=/usr/local/man:/usr/share/man:/usr/lpp/LoadL/full/man; LANG=en_|
| In: /dev/null |
| Out: poe5_1.c209f1n05.2.0.out |
| Err: poe5_1.c209f1n05.2.0.err |
|Initial Working Dir: /tmp/PARA_50 |
| Requirements: (Arch == "R6000") && (OpSys == "AIX51") && (Memory > 128) |
| Preferences: (Machine == { "c209f1n01.ppd.pok.ibm.com" "c209f1n05.ppd.pok.ibm.co|
| Step Type: General Parallel |
| Min Processors: 2 |
| Max Processors: 2 |
| Alloc. Host Count: 2 |
| Allocated Host: c209f1n05.ppd.pok.ibm.com |
| c209f1n01.ppd.pok.ibm.com |
| Node Usage: shared |
| Notify User: loadl |
| Shell: /bin/ksh |
| LoadLeveler Group: No_Group |
| Class: Parallel |
| Ckpt Hard Limit: undefined |
| Ckpt Soft Limit: undefined |
| Cpu Hard Limit: 00:30:00 (1800 seconds) |
| Cpu Soft Limit: 00:25:00 (1500 seconds) |
| Data Hard Limit: 4.250 pb (4785074604081152 bytes) |
| Data Soft Limit: 1.500 tb (1649267441664 bytes) |
| Core Hard Limit: 2.250 tb (2473901162496 bytes) |
| Core Soft Limit: 1.250 tb (1374389534720 bytes) |
| File Hard Limit: 1.200 eb (1383505805528216384 bytes) |
| File Soft Limit: 1.100 eb (1268213655067531680 bytes) |
| |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+ | Stack Hard Limit: 40.000 mb (41943040 bytes) | | Stack Soft Limit: 30.000 mb (31457280 bytes) | | Rss Hard Limit: 1.200 eb (1383505805528216384 bytes) | | Rss Soft Limit: 5.500 pb (6192449487634432 bytes) | |Step Cpu Hard Limit: 3+08:00:00 (288000 seconds) | |Step Cpu Soft Limit: 23:59:59 (86399 seconds) | |Wall Clk Hard Limit: 01:40:00 (6000 seconds) | |Wall Clk Soft Limit: 01:40:00 (6000 seconds) | | Comment: Test job 3 of Parallel test suite 6. | | Account: 99999 | | NQS Submit Queue: | | NQS Query Queues: | | Job Tracking Exit: | | Job Tracking Args: | | Task_geometry: | | Resources: ConsumableMemory(75 bytes) ConsumableCpus(1) | | Blocking: UNSPECIFIED | |Adapter Requirement: | | Step Cpus: 4 | |Step Virtual Memory: 0.000 mb | | Step Real Memory: 300.000 mb | |Step Adapter Memory: 8.000 mb (8388608 bytes) | |--------------- Detail for c209f1n05.ppd.pok.ibm.com.2.0 --------------- | | Running Host: c209f1n05.ppd.pok.ibm.com | | Machine Speed: 1.000000 | | Event: System | | Event Name: started | | Time of Event: Fri Jul 27 17:53:00 EDT 2001 | | Starter User Time: 00:00:00.000000 | |Starter System Time: 00:00:00.000000 | | Starter Total Time: 00:00:00.000000 | | Starter maxrss: 0 | | Starter ixrss: 0 | | ... | | ... | | | +--------------------------------------------------------------------------------+ +--------------------------------------------------------------------------------+ | Starter nivcsw: 0 | | Step User Time: 00:00:00.000000 | | Step System Time: 00:00:00.000000 | | Step Total Time: 00:00:00.000000 | | Step maxrss: 0 | | Step ixrss: 0 | | ... | | ... | | Step nivcsw: 0 | | Event: Installation Defined | | Event Name: user_event_1 | | Time of Event: Fri Jul 27 17:53:29 EDT 2001 | | Starter User Time: 00:00:00.110000 | |Starter System Time: 00:00:00.140000 | | Starter Total Time: 00:00:00.250000 | | Starter maxrss: 2000 | | Starter ixrss: 9324 | | ... | | ... | | Starter nivcsw: 29 | | Step User Time: 00:00:49.920000 | | Step System Time: 00:00:00.420000 | | Step Total Time: 00:00:50.340000 | | Step maxrss: 4312 | | Step ixrss: 59888 | | ... | | ... | | Step nivcsw: 5235 | | Event: Installation Defined | | Event Name: user_event_2 | | Time of Event: Fri Jul 27 17:53:55 EDT 2001 | | Starter User Time: 00:00:00.110000 | |Starter System Time: 00:00:00.140000 | | Starter Total Time: 00:00:00.250000 | | Starter maxrss: 2000 | | Starter ixrss: 9324 | | ... | | ... | | | +--------------------------------------------------------------------------------+ +--------------------------------------------------------------------------------+ | Starter nivcsw: 29 | | Step User Time: 00:01:41.940000 | | Step System Time: 00:00:00.450000 | | Step Total Time: 00:01:42.390000 | | Step maxrss: 4312 | | Step ixrss: 122408 | | ... | | ... | | Step nivcsw: 10692 | | Event: System | | Event Name: completed | | Time of Event: Fri Jul 27 17:55:11 EDT 2001 | | Starter User Time: 00:00:00.110000 | |Starter System Time: 00:00:00.150000 | | Starter Total Time: 00:00:00.260000 | | Starter maxrss: 2000 | | Starter ixrss: 9324 | | Starter idrss: 16812 | | Starter isrss: 0 | | Starter minflt: 0 | | Starter majflt: 0 | | Starter nswap: 0 | | Starter inblock: 0 | | Starter oublock: 0 | | Starter msgsnd: 0 | | Starter msgrcv: 0 | | Starter nsignals: 3 | | Starter nvcsw: 52 | | Starter nivcsw: 30 | | Step User Time: 00:02:00.310000 | | Step System Time: 00:00:00.580000 | | Step Total Time: 00:02:00.890000 | | | +--------------------------------------------------------------------------------+ +--------------------------------------------------------------------------------+ | Step maxrss: 4312 | | Step ixrss: 288516 | | Step idrss: 51400928 | | Step isrss: 0 | | Step minflt: 4919 | | Step majflt: 4 | | Step nswap: 0 | | Step inblock: 0 | | Step oublock: 0 | | Step msgsnd: 0 | | Step msgrcv: 0 | | Step nsignals: 2 | | Step nvcsw: 899 | | Step nivcsw: 12634 | | Running Host: c209f1n01.ppd.pok.ibm.com | | Machine Speed: 1.000000 | | Event: System | | Event Name: started | | Time of Event: Fri Jul 27 17:53:00 EDT 2001 | | Starter User Time: 00:00:00.000000 | |Starter System Time: 00:00:00.000000 | | Starter Total Time: 00:00:00.000000 | | Starter maxrss: 0 | | Starter ixrss: 0 | | ... | | ... | | Starter nivcsw: 0 | | Step User Time: 00:00:00.000000 | | Step System Time: 00:00:00.000000 | | Step Total Time: 00:00:00.000000 | | Step maxrss: 0 | | Step ixrss: 0 | | ... | | ... | | | +--------------------------------------------------------------------------------+ +--------------------------------------------------------------------------------+ | Step nivcsw: 0 | | Event: Installation Defined | | Event Name: user_event_1 | | Time of Event: Fri Jul 27 17:53:29 EDT 2001 | | Starter User Time: 00:00:00.120000 | |Starter System Time: 00:00:00.070000 | | Starter Total Time: 00:00:00.190000 | | Starter maxrss: 1940 | | Starter ixrss: 8432 | | ... | | ... | | Starter nivcsw: 25 | | Step User Time: 00:00:50.110000 | | Step System Time: 00:00:00.250000 | | Step Total Time: 00:00:50.360000 | | Step maxrss: 4288 | | Step ixrss: 40368 | | ... | | ... | | Step nivcsw: 5455 | | Event: Installation Defined | | Event Name: user_event_2 | | Time of Event: Fri Jul 27 17:53:55 EDT 2001 | | Starter User Time: 00:00:00.120000 | |Starter System Time: 00:00:00.070000 | | Starter Total Time: 00:00:00.190000 | | Starter maxrss: 1940 | | Starter ixrss: 8432 | | ... | | ... | | Starter nivcsw: 25 | | Step User Time: 00:01:42.280000 | | Step System Time: 00:00:00.250000 | | Step Total Time: 00:01:42.530000 | | Step maxrss: 4288 | | Step ixrss: 82128 | | ... | | ... | | | +--------------------------------------------------------------------------------+ +--------------------------------------------------------------------------------+ | Step nivcsw: 10878 | | Event: System | | Event Name: completed | | Time of Event: Fri Jul 27 17:55:12 EDT 2001 | | Starter User Time: 00:00:00.120000 | |Starter System Time: 00:00:00.070000 | | Starter Total Time: 00:00:00.190000 | | Starter maxrss: 2004 | | Starter ixrss: 8432 | | Starter idrss: 12428 | | Starter isrss: 0 | | Starter minflt: 606 | | Starter majflt: 0 | | Starter nswap: 0 | | Starter inblock: 0 | | Starter oublock: 0 | | Starter msgsnd: 0 | | Starter msgrcv: 0 | | Starter nsignals: 2 | | Starter nvcsw: 40 | | Starter nivcsw: 25 | | Step User Time: 00:02:00.420000 | | Step System Time: 00:00:00.330000 | | Step Total Time: 00:02:00.750000 | | Step maxrss: 4292 | | Step ixrss: 196376 | | Step idrss: 51428956 | | Step isrss: 0 | | Step minflt: 3511 | | Step majflt: 0 | | Step nswap: 0 | | Step inblock: 0 | | Step oublock: 0 | | Step msgsnd: 0 | | Step msgrcv: 0 | | Step nsignals: 2 | | Step nvcsw: 771 | | Step nivcsw: 12823 | +--------------------------------------------------------------------------------+ |
For an explanation of these fields, see the description of the output fields for the long listing of the llq command.