Controlling the number of saved log files

software can retain up to 1,000 rolled over log files for each log that is being generated. For example, if you are generating two log files, MYDM_en_US_UTF-8.log and MYDM_fr_UTF-8.log file, you can maintain up to 1,000 backup log files for the MYDM_en_US_UTF-8.log and 1,000 backup log files for the MYDM_fr_UTF-8.log.
The number of log files retained is determined by the value of SM_BACKUP_FILE_LIMIT. When a
starts up, it renames a file that matches its log filename, adding a .bak to the name. If there is an existing .bak file, the .bak will be replaced with .NNN.
For example, if the SM_BACKUP_FILE_LIMIT environment variable is set to 3, the process is as follows:
  1. A log file is created and it is named MYDM_en_US_UTF-8.log.
  2. The MYDM_en_US_UTF-8.log file created in step 1 is rolled over:
    • The MYDM_en_US_UTF-8.log file created in step 1 is renamed to MYDM_en_US_UTF-8.log.bak.
      • A new MYDM_en_US_UTF-8.log file is created.
  3. The MYDM_en_US_UTF-8.log file created in step 2 is rolled over:
    • The MYDM_en_US_UTF-8.log.bak file renamed in step 2 is now renamed to MYDM_en_US_UTF-8.log.001.
      • The MYDM_en_US_UTF-8.log file created in step 2 is renamed to MYDM_en_US_UTF-8.log.bak.
      • A new MYDM_en_US_UTF-8.log file is created.
  4. The MYDM_en_US_UTF-8.log file created in step 3 is rolled over:
    • The MYDM_en_US_UTF-8.log.bak file renamed in step 3 is renamed to MYDM_en_US_UTF-8.log.002.
      • The MYDM_en_US_UTF-8.log file created in step 3 is renamed to MYDM_en_US_UTF-8.log.bak.
      • A new MYDM_en_US_UTF-8.log file is created.
  5. The MYDM_en_US_UTF-8.log file created in step 4 is rolled over:
    • The MYDM_en_US_UTF-8.log.bak file renamed in step 3 is renamed to MYDM_en_US_UTF-8.log.003.
      • The MYDM_en_US_UTF-8.log file created in step 4 is renamed to MYDM_en_US_UTF-8.log.bak.
      • A new MYDM_en_US_UTF-8.log file is created.
  6. Since the limit of MYDM_en_US_UTF-8.log.NNN files that are retained is set to 3, when the MYDM_en_US_UTF-8.log file created in step 5 is rolled over:
    • The oldest log file, MYDM_en_US_UTF-8.log.001 from step 3 , is deleted.
      • The MYDM_en_US_UTF-8.log.bak file renamed in step 5 is renamed MYDM_en_US_UTF-8.log.004.
      • The MYDM_en_US_UTF-8.log file created in step 5 is renamed MYDM_en_US_UTF-8.log.bak.
      • A new MYDM_en_US_UTF-8.log is created.