csaedit - displays and edits the accounting information


SYNOPSIS

       //uussrr//ssbbiinn//ccssaaeeddiitt [--PP pacctfile] --bb offsetfile --oo outfile [--vv]

       //uussrr//ssbbiinn//ccssaaeeddiitt [--PP pacctfile] [--oo outfile] --AA [--mm] [--tt] [--vv]

       //uussrr//ssbbiinn//ccssaaeeddiitt [--PP pacctfile] --rr reclist --oo outfile [--vv]

       //uussrr//ssbbiinn//ccssaaeeddiitt [--PP pacctfile] --rr reclist [--oo outfile] --AA | --xx [--mm] [--tt] [--vv]


DESCRIPTION

       The  ccssaaeeddiitt  command  edits  the  accounting  file.   The
       accounting file (pacctfile) can be a pacct or sorted pacct
       file.

       You must use the csaverify(8) command to verify records in
       the accounting file prior to using this command.   If  the
       ccssaavveerriiffyy  command indicates that the accounting file con­
       tains invalid data, you  must  first  delete  the  invalid
       data.   You  can do this by passing the file that contains
       information about invalid records produced by the  ccssaavveerr­­
       iiffyy  command  to the ccssaaeeddiitt command.  The ccssaaeeddiitt command
       uses the byte offset and length information from this file
       to delete the invalid data.  To ensure that all of the bad
       records were removed, use the ccssaavveerriiffyy command to  rever­
       ify the accounting file after deleting any records.

       After  deleting  bad records, you can use the ccssaaeeddiitt com­
       mand to view the remaining records and delete any of these
       remaining  records.  Use the record numbers display by the
       --AA option to delete records.

       The ccssaaeeddiitt command outputs the data to  stdout  or  to  a
       file.   The  output  data  can be in binary or ASCII form.
       Binary data can only be  written  out  to  a  file.   Only
       accounting  records  can be output.  No data can be output
       until bad data has been removed.

       Displaying the data in ASCII form allows you to  view  the
       valid records and decide which ones to delete.

       The ccssaaeeddiitt command accepts three types of options: input,
       output, and record selection options.

   Input Options
       The ccssaaeeddiitt command accepts the following input option:

       --PP pacctfile
                   Specifies a pacct file or sorted  pacct  file.
                   The  default filename is /var/csa/work/Wpacct.

       The ccssaaeeddiitt command accepts the following output options:

       --AA          Specifies ASCII  output  for  all  data.   The
                   default  is to output binary data.  You cannot
                   use this option with the --xx option.

       --mm          Outputs memory values.  This option  may  only
                   be used with the --AA option or the --xx option.

       --oo outfile  Specifies  the  output  file.  The default for
                   ASCII  output  is  ssttddoouutt.   This  option   is
                   required  with the --bb and --rr options.  Records
                   cannot be written back to the input pacct file
                   as in the following example: ccssaaeeddiitt --PP ppaacccctt00
                   --rr 1188 --oo ppaacccctt00.  You cannot  edit  the  file;
                   you have to create a new file.

       --tt          Outputs  CPU  times.  Also displays queue wait
                   time  for  consolidated  workload   management
                   records.   This  option  may only be used with
                   the --AA option or the --xx option.

       --vv          Specifies verbose mode.  Output is written  to
                   ssttddeerrrr.

       --xx          Specifies  no  execute mode.  Only the records
                   to be deleted  are  displayed.   The  selected
                   records are not actually deleted.  The records
                   are displayed in ASCII form.  This option must
                   be  used with the --rr option.  This option can­
                   not be used with the --AA option.

   Record Selection Options
       The ccssaaeeddiitt command accepts the following record selection
       options:

       --bb offsetfile
                   Specifies  the file that contains the informa­
                   tion about invalid  records  that  are  to  be
                   deleted.   The   offsetfile is produced by the
                   ccssaavveerriiffyy command.  You must use  this  option
                   with  the  --oo  option  since  the data will be
                   written out in binary form only.  You can only
                   use this option with the --PP and --vv options.

       --rr reclist  Specifies the record numbers of the records to
                   be  deleted.   reclist  is  a  comma-separated
                   list.


EXAMPLES

       Example  1:  The following example deletes invalid records
       from  the  Wpacct1  file.   The  file   iinnvvaalliidd   contains

       to file Wpacct1.NEW.

            ccssaaeeddiitt --PP WWppaacccctt11 --bb iinnvvaalliidd --oo WWppaacccctt11..NNEEWW

       Example 2: The following example outputs the Wpacct1  file
       in ASCII.  CPU times and memory values are reported.

            ccssaaeeddiitt --PP WWppaacccctt11 --AAmmtt

       Example 3: The following example displays records that are
       deleted in Example 4.

            ccssaaeeddiitt --PP WWppaacccctt11 --xxrr 22,, 1100,, 1155

       Example 4: The following example deletes  records  2,  10,
       and  15  from  the Wpacct1 file.  The output is written to
       file Wpacct1.NEW, and verbose output is  written  to  file
       err.

            ccssaaeeddiitt  --PP  WWppaacccctt11  --rr 22,,1100,,1155 --oo WWppaacccctt11..NNEEWW --vv 22>>
            eerrrr


FILES

       //uussrr//iinncclluuddee//ccssaa..hh                    Accounting   records
                                             header file

       //uussrr//iinncclluuddee//ccssaaaacccctt..hh                Daemon    accounting
                                             header file


SEE ALSO

       csaverify(8).


Man(1) output converted with man2html