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