lsacct

Displays accounting statistics on finished RES tasks in the LSF system.

Synopsis

lsacct [-l] [-C time0,time1] [-S time0,time1] [-f logfile_name] [-m host_name] [-u user_name ... | -u all] [pid ...]

lsacct [-h | -V]

Description

Displays statistics on finished tasks that are run through RES. When a remote task completes, RES logs task statistics in the task log file.

By default, displays accounting statistics for only tasks that are owned by the user who ran the lsacct command.

By default, displays accounting statistics for tasks that are executed on all hosts in the LSF system.

By default, displays statistics for tasks that are logged in the task log file that is currently used by RES: LSF_RES_ACCTDIR/lsf.acct.host_name or /tmp/lsf.acct.host_name.

If the -l option is not specified, the default is to display only the fields in SUMMARY.

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

All times are reported in seconds. All sizes are reported in KB.

Options

-l: Per-task statistics. Displays statistics about each task.
-C time0,time1: Displays accounting statistics for only tasks that completed or exited during the specified time interval.
The time format is the same as in the bhist command.
-f logfile_name: Searches the specified task log file for accounting statistics. Specify either an absolute or a relative path.
Useful for analyzing old task log files or files that are merged with the lsacctmrg command.
-m host_name ...: Displays accounting statistics only for tasks that are executed on the specified hosts.
If a list of hosts is specified, host names must be separated by spaces and enclosed in quotation marks (") or (’).
-S time0,time1: Displays accounting statistics only for tasks that began running during the specified time interval.
The time format is the same as in the bhist command.
-u user_name ... | -u all: Displays accounting statistics only for tasks that are owned by the specified users, or by all users if the keyword all is specified.
If a list of users is specified, user names must be separated by spaces and enclosed in quotation marks (") or (’). You can specify both user names and user IDs in the list of users. To specify a Windows user account, include the domain name in uppercase letters and use a single backslash (DOMAIN_NAME\user_name) on a Windows command prompt or a double backslash (DOMAIN_NAME\\user_name) on a UNIX or Linux command line.
pid ...: Displays accounting statistics only for tasks with the specified process ID. This option overrides all other options except for the -l, -f, -h, and -V options.
-h: Prints command usage to stderr and exits.
-V: Prints LSF release version to stderr and exits.

Default output

Overall statistics for tasks are displayed. The SUMMARY is the default output format.

The total, average, maximum, and minimum resource usage statistics apply to all specified tasks.

The following fields are displayed:

Total number of tasks: Total number of tasks, including tasks that are completed successfully and total number of exited tasks.
Time range of started tasks: Start time of the first and last task selected.
Time range of ended tasks: Completion or exit time of the first and last task selected.
Resource usage of tasks selected: See getrusage.
CPU time: Total CPU time that is consumed by the task.
Page faults: Number of page faults.
Swaps: Number of times the process was swapped out.
Blocks in: Number of input blocks.
Blocks out: Number of output blocks.
Messages sent: Number of System VIPC messages sent.
Messages rcvd: Number of IPC messages received.
Voluntary cont sw: Number of voluntary context switches.
Involuntary con sw: Number of involuntary context switches.
Turnaround: Elapsed time from task execution to task completion.

Per-task statistics with the -l option

In addition to the fields displayed by default in SUMMARY, displays the following fields for each task:

Starting time: Time the task started.
User and host name: User who submitted the task and the host from which the task was submitted, in the format user_name@host.
PID: UNIX process ID of the task.
Execution host: Host on which the command was run.
Command line: Complete command line that was run.
CWD: Current working directory of the task.
Completion time: Time at which the task completed.
Exit status: UNIX exit status of the task.

Files

Reads the lsf.acct.host_name file.