How to change the default value for how many versions of a Job in Control-M/Enterprise Manager in Planning domain for Control-M Client?

Version 5
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    Control-M/Enterprise Manager


    COMPONENT:

    Control-M/Enterprise Manager


    APPLIES TO:

    All versions of Control-M/Enterprise Manager



    QUESTION:

    How to change the default value for how many versions of a Job in Control-M/Enterprise Manager in Planning domain for Control-M Client


    ANSWER:

     

    The number of versions of a job is dictated by 3 Control-M/Enterprise Manager system parameters:
     
    VMVersionsNumberToKeep
    VMMaxDaysRetainCurJobsHistory
    VMCleanupIntervalMinutes

    These are the steps to update the values:
    1. Launch Control-M Configuration Manager (CCM) --> Control-M/Enterprise Manager system parameters --> Advanced 
    2. Type in the parameter under the 'Name' column and it will be displayed in the list.
    3. Double click on the parameter to update the value and Save.

    The following are their definitions:

    VMMaxDaysRetainCurJobsHistory           The number of days after which the history of the current jobs should be deleted automatically.
                  NOTE: A job version is deleted only when all of the following are true:
                  ·         The version exceeds VMVersionsNumberToKeep. 
                  ·         The version exceeds VMMaxDaysRetainCurJobsHistory. 
                  ·         Automatic cleanup has run, as determined by VMCleanupIntervalMinutes.
                  Valid values: Any whole number that is equal to or greater than 0.
                  Default: 0
     

    VMVersionsNumberToKeep       The number of versions of the job to keep, including the current version.
                  NOTE: A job version is deleted only when all of the following are true:
                  ·         The version exceeds VMVersionsNumberToKeep. 
                  ·         The version exceeds VMMaxDaysRetainCurJobsHistory. 
                  ·         Automatic cleanup has run, as determined by VMCleanupIntervalMinutes.
                  BMC Software recommends not setting a value greater than 30 because of possible performance degradation.
                  To deactivate version history, set the parameter to 1 (keep current version only).
                  Valid values: Any whole number that is equal to or greater than 0.
                  Default: 2 (current version, and one history version)
                  Refresh Type: Manual
     

    VMCleanupIntervalMinutes        Interval, in minutes, between activations of automatic job history cleanup by the CMS.
                  NOTE: To disable automatic cleanup, set the value to 0.
                  Valid values: Any whole number that is equal to or greater than 30.
                  Default: 30

      
    For more information, you can find details in the online documentation link below: 

    Control-M Online Documentation

      

     


    Article Number:

    000022406


    Article Type:

    FAQ/Procedural



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles