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 Manager 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.