home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / csabuild.z / csabuild
Encoding:
Text File  |  2001-04-17  |  7.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccssssaaaabbbbuuuuiiiilllldddd((((1111MMMM))))                                                      ccccssssaaaabbbbuuuuiiiilllldddd((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      csabuild - organizes accounting records into job records
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd [_----_aaaa] [_----_AAAA] [_----_DDDD _l_e_v_e_l] [_----_iiii] [_----_nnnn] [_----_oooo _n_d_a_y] [_----
  13.      _PPPP _p_a_c_c_t] [_----_ssss _s_p_a_c_c_t] [_----_tttt]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd command reads accounting records from the CSA _p_a_c_c_t file and
  17.      organizes them into job records by job ID and boot times.  It writes
  18.      these job records into the sorted _pppp_aaaa_cccc_cccc_tttt file.  This sorted _pppp_aaaa_cccc_cccc_tttt file
  19.      contains all of the accounting data available for each job.  The _pppp_aaaa_cccc_cccc_tttt
  20.      file configuration records are associated with the job ID 0 job record
  21.      within each boot period.  The information in the sorted _pppp_aaaa_cccc_cccc_tttt file is
  22.      used by other commands to generate reports and for billing.
  23.  
  24.      An integer suffix is attached to the _p_a_c_c_t pathname arguments; a 0
  25.      indicates recycled information, and 1 and higher indicates current data.
  26.  
  27.      The _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd command accepts several types of options:  filename,
  28.      performance, job ending, and debugging.
  29.  
  30.    FFFFiiiilllleeeennnnaaaammmmeeee OOOOppppttttiiiioooonnnnssss
  31.      The _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd command accepts the following filename options:
  32.  
  33.      _----_PPPP _p_a_c_c_t       Specifies _pppp_aaaa_cccc_cccc_tttt file pathname.  The default is
  34.                     /_v_a_r/_a_d_m/_a_c_c_t/_w_o_r_k/_W_p_a_c_c_t.
  35.  
  36.      _----_ssss _s_p_a_c_c_t      Specifies the sorted _pppp_aaaa_cccc_cccc_tttt file pathname.  The default is
  37.                     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_wwww_oooo_rrrr_kkkk_////_ssss_pppp_aaaa_cccc_cccc_tttt.
  38.  
  39.    PPPPeeeerrrrffffoooorrrrmmmmaaaannnncccceeee OOOOppppttttiiiioooonnnnssss
  40.      The _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd command accepts the following performance option:
  41.  
  42.      _----_tttt             Prints timing information for the two major phases of
  43.                     _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd.
  44.  
  45.    JJJJoooobbbb EEEEnnnnddddiiiinnnngggg OOOOppppttttiiiioooonnnnssss
  46.      The _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd command accepts the following job ending options:
  47.  
  48.      _----_aaaa             Does not assume crash option.  The default operation is if
  49.                     a job does not have an associated end-of-job record, but
  50.                     the system was rebooted, the job is assumed to be
  51.                     terminated.  With this option, these jobs are not marked
  52.                     as terminated.
  53.  
  54.      _----_oooo _n_d_a_y        Terminates the session if a session is older than _n_d_a_y
  55.                     days.  NQS or workload management requests submitted more
  56.                     than _n_d_a_y_s ago also are terminated.  You can use this
  57.                     option to terminate old jobs that are known to be
  58.                     finished.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccssssaaaabbbbuuuuiiiilllldddd((((1111MMMM))))                                                      ccccssssaaaabbbbuuuuiiiilllldddd((((1111MMMM))))
  71.  
  72.  
  73.  
  74.    DDDDeeeebbbbuuuuggggggggiiiinnnngggg OOOOppppttttiiiioooonnnnssss
  75.      The _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd command accepts the following debugging options:
  76.  
  77.      _----_AAAA             Abort option.  If _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd exits with an error, a core
  78.                     dump is generated.
  79.  
  80.      _----_DDDD _l_e_v_e_l       Controls messages printed during program execution.  Level
  81.                     1 is verbose, level 9 is not appropriate for any
  82.                     execution, except small test cases.
  83.  
  84.      _----_iiii             Ignores bad records.  If _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd runs into a record that
  85.                     it detects as bad, it can recover from the error by
  86.                     discarding the record and continuing to process input.
  87.                     When it discards a record, it prints a diagnostic message.
  88.  
  89.      _----_nnnn             Suppresses the NQS or workload management sort and
  90.                     condense phase.  This option prevents NQS or workload
  91.                     management jobs that span multiple system boots from being
  92.                     condensed into one job.  (This function is intended only
  93.                     for error recovery.)
  94.  
  95. NNNNOOOOTTTTEEEESSSS
  96.      The _pppp_aaaa_cccc_cccc_tttt_1111 file must exist.  _cccc_ssss_aaaa_vvvv_eeee_rrrr_iiii_ffff_yyyy(1M) can verify the _p_a_c_c_t input
  97.      files.  Generally, _cccc_ssss_aaaa_eeee_dddd_iiii_tttt(1M) can verify and repair bad input files.
  98.  
  99. BBBBUUUUGGGGSSSS
  100.      _cccc_ssss_aaaa_bbbb_uuuu_iiii_llll_dddd is limited by its input.  Unless the data files are accurate,
  101.      the jobs cannot be organized correctly.
  102.  
  103. FFFFIIIILLLLEEEESSSS
  104.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy        Directory that contains current unprocessed
  105.                               accounting data
  106.  
  107. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  108.      csaedit(1M), csarun(1M), csaverify(1M).
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.