csabuild(1M)                                                      csabuild(1M)


NAME
     csabuild - organizes accounting records into job records

SYNOPSIS
     /usr/lib/acct/csabuild [-a] [-A] [-D level] [-i] [-n] [-o nday] [-
     P pacct] [-s spacct] [-t]

DESCRIPTION
     The csabuild command reads accounting records from the CSA pacct file and
     organizes them into job records by job ID and boot times.  It writes
     these job records into the sorted pacct file.  This sorted pacct file
     contains all of the accounting data available for each job.  The pacct
     file configuration records are associated with the job ID 0 job record
     within each boot period.  The information in the sorted pacct file is
     used by other commands to generate reports and for billing.

     An integer suffix is attached to the pacct pathname arguments; a 0
     indicates recycled information, and 1 and higher indicates current data.

     The csabuild command accepts several types of options:  filename,
     performance, job ending, and debugging.

   Filename Options
     The csabuild command accepts the following filename options:

     -P pacct       Specifies pacct file pathname.  The default is
                    /var/adm/acct/work/Wpacct.

     -s spacct      Specifies the sorted pacct file pathname.  The default is
                    /var/adm/acct/work/spacct.

   Performance Options
     The csabuild command accepts the following performance option:

     -t             Prints timing information for the two major phases of
                    csabuild.

   Job Ending Options
     The csabuild command accepts the following job ending options:

     -a             Does not assume crash option.  The default operation is if
                    a job does not have an associated end-of-job record, but
                    the system was rebooted, the job is assumed to be
                    terminated.  With this option, these jobs are not marked
                    as terminated.

     -o nday        Terminates the session if a session is older than nday
                    days.  NQS or workload management requests submitted more
                    than ndays ago also are terminated.  You can use this
                    option to terminate old jobs that are known to be
                    finished.


   Debugging Options
     The csabuild command accepts the following debugging options:

     -A             Abort option.  If csabuild exits with an error, a core
                    dump is generated.

     -D level       Controls messages printed during program execution.  Level
                    1 is verbose, level 9 is not appropriate for any
                    execution, except small test cases.

     -i             Ignores bad records.  If csabuild runs into a record that
                    it detects as bad, it can recover from the error by
                    discarding the record and continuing to process input.
                    When it discards a record, it prints a diagnostic message.

     -n             Suppresses the NQS or workload management sort and
                    condense phase.  This option prevents NQS or workload
                    management jobs that span multiple system boots from being
                    condensed into one job.  (This function is intended only
                    for error recovery.)

NOTES
     The pacct1 file must exist.  csaverify(1M) can verify the pacct input
     files.  Generally, csaedit(1M) can verify and repair bad input files.

BUGS
     csabuild is limited by its input.  Unless the data files are accurate,
     the jobs cannot be organized correctly.

FILES
     /var/adm/acct/day        Directory that contains current unprocessed
                              accounting data

SEE ALSO
     csaedit(1M), csarun(1M), csaverify(1M).


                                                                        Page 2