QACCT(1)

NAME
qacct - display NQS accounting information.

SYNOPSIS
qacct [ -a after-time ] [ -b before-time ] [ -f ] [ -i inputfile ] [ -o outputfile ] [ -r ] [ -s ] [ -S ] [ -u username ] [ -v ]

DESCRIPTION
Qacct prints out the accounting information. The default is to print out a summary line for each job indicating the username, the request, the queue, the total cpu usage, and the starting and completion date/times. There are two types of NQS accounting files. The raw accounting file have records for NQS startup and shutdown and records for NQS request start and completion. The summary accounting is derived from the raw data file and has a single record for each NQS request. Qacct will read either type of file.

OPTIONS

-a after-time
    Selects records for requests which have completed after the time indicated.

-b before-time
    Selects records for requests which have completed before the time indicated.

-f  Full information, all records in the accounting file are to be printed. This is valuable for debugging, only.

-i inputfile
    Indicates that the file for input is to be the indicated file. By default the input file is /usr/adm/nqs. The input file can be an NQS accounting file or an NQS accounting summary file.

-o outputfile
    Indicates that the summary records are to be written to the indicated file.

-r  Indicates that the NQS accounting file is to be rolled over.

-s  Indicates that a summary file is to be created.

-S  Indicates that a summary report is to be printed. This report summarizes the number of jobs and cpu time used by each user in each queue.

-u username
    Only records for the corresponding username are to be printed.

-v  List the version of the program. All other switches will print a message indicating how the program is to be used.

The NQS daemon writes records to the NQS accounting file when NQS is brought up, when requests start, when requests complete, and when NQS is brought down. Consequently, the file cannot easily be concatenated with another NQS accounting file. The summary file contains only contains single records for requests, with no NQS startup or shutdown records. This file can be concatentated with another summary file. It also can be read by qacct using the -i switch to give its name.

Since the NQS accounting file only grows, the rollover switch is available to create a new copy of the accounting file with only currently active records. Normally, this should be invoked with the command:

qacct -r -s -o summary-file

Rollover processing involves reading through the NQS accounting file and writing out a record for the last NQS startup and the initiation record for each of the currently active NQS requests. The old version of the NQS accounting file is renamed to /usr/adm/nqs.o, and the new version is written to /usr/adm/nqs.

FILES
The accounting information is written to /usr/adm/nqs by default.

SEE ALSO
qsub(1), qstat(1).
qmgr(1M) in the NPSN UNIX System Administrator Reference Manual.

NPSN HISTORY
Origin: Monsanto

December 1992 - John Roman, Monsanto Company
Original release.

August 1994 - John Roman, Monsanto Company
Release 3.36