Table of Contents

NAME

lsacct - report accounting statistics on completed RES tasks in the LSF system

SYNOPSIS

lsacct [ -h ] [ -V ] [ -l ] [ -f logfile ] [ -u userlist | -u all ] [ -m machinelist ] [ -C time0, time1 ] [ -S time0, time1 ] [ pid ... ]

DESCRIPTION

The lsacct command displays statistics on completed tasks run through the LSF RES server. When each remote task completes, the RES logs task statistics in the task log file (see lsf.acct(5) ) by RES. lsacct generates reports from these logs; it does not report on tasks that are still in progress.

By default, lsacct produces a summary of the statistics for all jobs selected. The statistics generated are described in the SUMMARY section below. The lsacct -l option displays individual statistics for each job, as well as the summary for all jobs. The additional fields are described in the PER-JOB STATISTICS section.

The other options specify the tasks you are interested in, such as tasks belonging to certain users, tasks executed on certain hosts, tasks with specific pids, or tasks that began or completed execution within specified time intervals.

Only those tasks that satisfy all the optional specifications are considered. If no tasks are specified, all tasks belonging to the user invoking lsacct are considered.

The RES on each host writes its own accounting log file. These files can be merged using the lsacctmrg(1) command to generate statistics for the entire LSF cluster.

All times are reported in seconds; all sizes are reported in kilobytes.

OPTIONS

-h Print command usage to stderr and exit.

-V Print LSF release version to stderr and exit.

-l Also display individual statistics about each selected job, as described in the PER-JOB STATISTICS section. The default is to display only the statistics described in the SUMMARY section.

-f logfile
Specify the file name of the task log file to be analyzed. The default is to use the task log file currently used by the RES, either LSF_RES_ACCTDIR/lsf.acct.<hostname> or /tmp/lsf.acct.<hostname> (see lsf.acct(5) ). The lsacct -f option is useful for analyzing old log files or merged files created by the lsacctmrg(1) command.

-C time0, time1
Consider only those tasks that completed or exited within the time interval time0, time1 (see TIME FORMAT). The default is to consider all logged tasks.

-S time0, time1
Consider only those tasks that began executing within the time interval time0, time1 (see TIME FORMAT). The default is to consider all logged tasks.

-m machinelist
Consider only those tasks executed on the hosts whose names are given in machinelist. If two or more host names are given, then they must be separated by spaces and enclosed by (") or ('). The default is to consider all hosts used by LSF.

-u userlist | -u all
Consider only those tasks belonging to the users whose login names and/or user IDs are given in userlist, or by all users (if the reserved user name all is specified). If two or more user names and/or IDs are given, then they must be separated by spaces and enclosed by (") or ('). A mixture of user names and IDs can be used in the list. The default is to consider only the tasks belonging to the user invoking lsacct.

pid ...
Consider only those tasks specified by pid .... This option overrides all other options except -h, -V, -l and -f. The default is to consider all the tasks satisfying other options.

SUMMARY

The fields described in this section are always displayed. The total, average, maximum and minimum resource usage statistics apply to all specified tasks.

The SUMMARY set includes the following statistics fields:

Total number of tasks (including total number of tasks completed successfully and total number of exited tasks)

Time range of started tasks
The started times of the first and the last task selected

Time range of ended tasks
The completion or exit times of the first and last task selected

Resource usage of tasks selected (see getrusage (2)):

CPU time
Total cpu time consumed by the task

Page faults
The number of page faults

Swaps
The number of times the process was swapped out

Blocks in
The number of blocks input

Blocks out
The number of blocks output

Messages sent
The number of System V IPC messages sent

Messages rcvd
The number of IPC messages received

Voluntary cont sw
The number of voluntary context switches

Involuntary con sw
The number of involuntary context switches

Turnaround
The elapsed time from task execution to task completion

PER-JOB STATISTICS

The following detailed information on individual tasks is displayed only if the -l option is given.

Starting time
The time the task started

User and Host Name
The user name and the name of the host from which the job was submitted, in the format username@host

PID The UNIX process ID of the task

Execution host
The host where the command was run

Command line
The complete command line that was executed

CWD The current work directory of the task

Completion time
The time that the task completed

Exit status
The UNIX exit status of the task

Accounting Information
The resource use statistics for the task; individual fields are described in the SUMMARY section

TIME FORMAT

The format of time in the options -C and -S is the same as in bhist(1) .

See bhist(1) for details.

SEE ALSO

lsf.acct(5) lsacctmrg(1) , res(8) , bhist(1) ,


Table of Contents