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 / csaperiod.z / csaperiod
Encoding:
Text File  |  2001-04-17  |  8.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccssssaaaappppeeeerrrriiiioooodddd((((1111MMMM))))                                                    ccccssssaaaappppeeeerrrriiiioooodddd((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      csaperiod - runs periodic accounting
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd [_----_eeee _M_M_D_D_h_h_m_m] [_----_rrrr] [_----_ssss _M_M_D_D_h_h_m_m]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd command directs the processing of the daily consolidated
  16.      accounting files, which are created by the _cccc_ssss_aaaa_rrrr_uuuu_nnnn(1M) command.  The
  17.      _cccc_ssss_aaaa_aaaa_dddd_dddd_cccc(1M) command merges the daily files into one file.  The
  18.      _cccc_ssss_aaaa_cccc_rrrr_eeee_pppp(1M) command then generates a report based on the merged file.
  19.  
  20.      The progress of _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd is recorded in the _pppp_dddd_aaaa_cccc_tttt file.  When an error
  21.      is detected, a message is written to the _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_SSSS_YYYY_SSSS_LLLL_OOOO_GGGG _ffff_iiii_llll_eeee, and mail
  22.      is sent to _rrrr_oooo_oooo_tttt and _aaaa_dddd_mmmm.  Further data processing is halted.
  23.  
  24.      The _cccc_rrrr_oooo_nnnn(1M) command usually initiates _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd.
  25.  
  26.      The _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd command accepts the following options:
  27.  
  28.      _----_eeee _M_M_D_D_h_h_m_m
  29.           Selects consolidated accounting data generated at or before the
  30.           specified date, _M_M_D_D_h_h_m_m.
  31.  
  32.      _----_rrrr   Removes the daily data files after processing is done.  The default
  33.           is to leave the daily data files in the _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_cccc_ssss_aaaa
  34.           directory.
  35.  
  36.      _----_ssss _M_M_D_D_h_h_m_m
  37.           Selects consolidated accounting data generated at or after the
  38.           specified date, _M_M_D_D_h_h_m_m.
  39.  
  40. NNNNOOOOTTTTEEEESSSS
  41.      By default, _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd processes all the _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_cccc_ssss_aaaa files.  The
  42.      mail recipients (_rrrr_oooo_oooo_tttt and _aaaa_dddd_mmmm) can be changed by modifying the _MMMM_AAAA_IIII_LLLL______LLLL_IIII_SSSS_TTTT
  43.      and _WWWW_MMMM_AAAA_IIII_LLLL______LLLL_IIII_SSSS_TTTT parameters in the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.
  44.  
  45.      If the script _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_...._pppp_uuuu_ssss_eeee_rrrr exists, _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd will execute it
  46.      via the shell "." command.  A possible use of this user exit would be to
  47.      generate any site specific report, which would be appended to the
  48.      periodic report.  _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd will check the return status from
  49.      "csa.puser".  If the return status is non-zero, execution of csaperiod
  50.      will be aborted.
  51.  
  52.      For example, the script could contain:
  53.  
  54.           /usr/bin/local/siterpt > siterpt
  55.           pr -h "${SITEHDR} ${SYSNAME} ${BTWMSG}" siterpt >> ${PDRPT}.${DTIME}
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccssssaaaappppeeeerrrriiiioooodddd((((1111MMMM))))                                                    ccccssssaaaappppeeeerrrriiiioooodddd((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      You need to make sure that the _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd command can read the site-
  75.      generated user exit script.  If _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd cannot read the script, it does
  76.      not handle the error graciously as it does for other errors.  This means
  77.      the error will not be logged in the SYSLOG file and the _pppp_dddd_aaaa_cccc_tttt file, and
  78.      no notification email will be sent out.
  79.  
  80. FFFFIIIILLLLEEEESSSS
  81.      _////_eeee_tttt_cccc_////_cccc_oooo_nnnn_ffff_iiii_gggg_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff                                   CSA configuration
  82.                                                             file
  83.  
  84.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ffff_iiii_ssss_cccc_aaaa_llll_////_cccc_ssss_aaaa_////_cccc_mmmm_ssss_...._MMMM_MMMM_DDDD_DDDD_hhhh_hhhh_mmmm_mmmm                  Periodic command
  85.                                                             usage data in _cccc_mmmm_ssss
  86.                                                             record format
  87.  
  88.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ffff_iiii_ssss_cccc_aaaa_llll_////_cccc_ssss_aaaa_////_uuuu_pppp_dddd_aaaa_cccc_cccc_tttt_...._MMMM_MMMM_DDDD_DDDD_hhhh_hhhh_mmmm_mmmm              Periodic condensed
  89.                                                             data files
  90.  
  91.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ffff_iiii_ssss_cccc_aaaa_llll_////_cccc_ssss_aaaa_////_rrrr_pppp_rrrr_tttt_...._MMMM_MMMM_DDDD_DDDD_hhhh_hhhh_mmmm_mmmm                 Periodic report
  92.                                                             files
  93.  
  94.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_pppp_dddd_aaaa_cccc_tttt                           Log file
  95.  
  96.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_EEEE_****_MMMM_MMMM_DDDD_DDDD_hhhh_hhhh_mmmm_mmmm                      Error messages
  97.                                                             files
  98.  
  99.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_cccc_ssss_aaaa_////_cccc_aaaa_aaaa_cccc_tttt_...._MMMM_MMMM_DDDD_DDDD_hhhh_hhhh_mmmm_mmmm                   Daily condensed
  100.                                                             data files
  101.  
  102.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_...._pppp_uuuu_ssss_eeee_rrrr                                Site-generated
  103.                                                             user exit script
  104.                                                             for _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd.
  105.  
  106. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  107.      csacms(1M), cron(1M), csaaddc(1M), csacon(1M), csacrep(1M), csarun(1M).
  108.  
  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.