csabuild - organizes accounting records into job records


SYNOPSIS

       //uussrr//ssbbiinn//ccssaabbuuiilldd   [--aa]   [--AA]   [--DD level]   [--ii]  [--nn]
       [--oo nday] [--PP pacct] [--ss spacct] [--tt]


DESCRIPTION

       The ccssaabbuuiilldd 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 ppaacccctt file.  This sorted ppaacccctt file contains all of
       the accounting data available for  each  job.   The  ppaacccctt
       file  configuration records are associated with the job ID
       0 job record within each boot period.  The information  in
       the  sorted ppaacccctt file is used by other commands to gener­
       ate reports and for billing.

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

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

   Filename Options
       The   ccssaabbuuiilldd  command  accepts  the  following  filename
       options:

       --PP pacct       Specifies ppaacccctt file pathname.  The default
                      is /var/csa/work/Wpacct.

       --ss spacct      Specifies  the  sorted ppaacccctt file pathname.
                      The default is //vvaarr//ccssaa//wwoorrkk//ssppaacccctt.

   Performance Options
       The ccssaabbuuiilldd command  accepts  the  following  performance
       option:

       --tt             Prints timing information for the two major
                      phases of ccssaabbuuiilldd.

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

       --aa             Assumes  crash  option.  The default opera­
                      tion is if a job does not have  an  associ­
                      ated  end-of-job record, but the system was
                      rebooted, the job is assumed to  be  termi­
                      nated.   With  this  option, these jobs are
                      not marked as terminated.

       --oo nday        Terminates the  session  if  a  session  is

                      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  ccssaabbuuiilldd  command  accepts  the  following  debugging
       options:

       --AA             Abort option.  If ccssaabbuuiilldd  exits  with  an
                      error, a core dump is generated.

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

       --ii             Ignores bad records.  If ccssaabbuuiilldd 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.

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


NOTES

       The ppaacccctt11 file must exist.  csaverify(8) can  verify  the
       pacct  input  files.  Generally, csaedit(8) can verify and
       repair bad input files.


BUGS

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


FILES

       //vvaarr//ccssaa//ddaayy             Directory  that  contains current
                                unprocessed accounting data


SEE ALSO

       csaedit(8), csarun(8), csaverify(8).


Man(1) output converted with man2html