qacct(1)
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
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