Copying rules

You can copy IBM. rules to your own locale.

About this task

You can copy IBM. and optionally customize the rules to apply appropriately to your environment. The copy and customize tasks can be performed as part of the initial Policy Services setup, or the tasks can be performed at a later time.

The rule threshold values can be modified.

The Manage Rules panel lists all IBM. rules and all locale-specific rules (copied from the BSNGLOBL rule template).

Because rules can be copied and modified, you must be aware of the following possible copy and modify combinations:

Scenario 1: Modify an IBM. rule now, and then copy the rule to a new locale (or locales)
In this scenario, you can modify the IBM. version of the rule threshold values.

You then copy this modified version to one or more locales.

This is generally the most logical scenario to follow.

From the Manage Rules panel, you perform the following row actions in this order:

  1. S - Select rule to customize
  2. C - Copy IBM.xxxxx rule (to another locale)
Scenario 2: Copy an IBM. rule to a new locale (or locales), and then modify the copied rule now
In this scenario, you copy the IBM. rule from BSNGLOBL to one or more locales and then modify the copied version of the rule threshold values.

The danger of this scenario is that the rule template remaining in the BSNGLOBL locale is now different from the modified version of the rule in the new locale.

From the Manage Rules panel, you perform the following row actions in this order:

  1. C - Copy IBM.xxxxx rule (to another locale)
  2. S - Select rule to customize
Scenario 3: Copy an IBM. rule to a new locale (or locales) now, and modify the copied rule later or not at all
In this scenario, you copy the IBM. rule from BSNGLOBL to one ore more locales, but you modify the copied version of the rule at a later date, or not at all.

From the Manage Rules panel, you perform the following row action:

  1. C - Copy IBM.xxxxx rule (to another locale)
Scenario 4: Modify the original IBM. version of the rule now, and do not copy the rule to any locale (or locales)
In this scenario, you modify the IBM. rule in the BSNGLOBL locale, but you do not copy the rule to a new locale (or locales). The rule template is now modified and ready for copying at a later time.

From the Manage Rules panel, you perform the following row action:

  1. S - Select rule to customize
Scenario 5: Copy the IBM. rule to a new locale (or locales) later, and modify the copied rule later
In this scenario, you copy the IBM. rule in the BSNGLOBL locale at a later date. Additionally, you modify the copied rule at a later date.
Remember: All Policy Services user interface panels provide field-specific and panel-specific help information when you press Help (PF1).

Procedure

To modify an IBM. rule now, and then copy the rule to a new locale (scenario 1), complete the following steps:
  1. In the Policy Services Main Menu: Maintenance panel, select option 6 (Maintenance management), and press Enter.

    The Maintenance Management panel is displayed.

  2. Select option 2 (Customize rule templates), and press Enter.

    The Customize Rule Template panel is displayed.

    Figure 1. Customize Rule Template panel
       Sort by  Help                                                                
     -----------------------------------------------------------------------------  
     REORG/MAINTENANCE   Customize Rule Template                  Row 1 to 19 of 21 
     Command ===>                                                                   
                                                                                    
     Type a row action, then press Enter.                                           
     A: Row Action: C - Copy IBM. rule           F - Mark as customized             
                    L - List policies for rule   M - View rule in maint env.        
                    O - View rule in orig. env.  R - List of cloned rules           
                    S - Select rule to customize V - View maintenance info          
     A Rule Name                      Installed  Customized Copied                  
       IBM.AVG_DBREC_LEN.10           INSTALLED
       IBM.CICA_SPLITS.10             INSTALLED
       IBM.DBDS_EXTENTS.10            INSTALLED
       IBM.DBDS_GROWTH.10             INSTALLED
       IBM.DBDS_GROWTH.20             INSTALLED
       IBM.DBDS_GROWTH.30             INSTALLED
       IBM.DEDB_DBREC_IO.10           INSTALLED
       IBM.DEDB_DBREC_IO.20           INSTALLED
       IBM.DEDB_DBRECCNT.10           INSTALLED
       IBM.DEDB_FS.10                 INSTALLED
       IBM.DEDB_FS.20                 INSTALLED                                   
    
  3. Type the S row action (Select rule to customize) on the rule that you want to modify (for example, IBM®.AVG_DBREC_LEN.10), and press Enter.

    The View/Update Rule panel is displayed.

      Help                                                                        
    ------------------------------------------------------------------------------
    REORG/MAINTENANCE                         View/Update Rule     Row 1 to 3 of 3
                                                                                  
    View rule/update threshold set and values. End to exit.                       
    Locale  . . . . . : BSNGLOBL  Rule name . . : IBM.AVG_DBREC_LEN.10            
    Description . . . :                                                           
    Average length of database records                                            
    Exception class . : AVERAGE_DB_RECORD_LENGTH                                  
    Resource types:                                                               
    HDAM HIDAM PHDAM PHIDAM HISAM SHISAM                                          
    Message: The average length of database records in %RESOURCE% has reached     
              or exceeded a threshold                                             
    Threshold value set.                                                          
    A: Row Actions: V - Display  U - Update  D - Delete  A - Add  F - View formula
    A Threshold                                                                   
      LOW                                                                         
      MED                                                                         
      HIGH                                                                        
    ******************************* Bottom of data ********************************
  4. Type the U row action (Update) on a threshold set row (for example, LOW), and press Enter.

    The Update/Add Threshold Value Set panel is displayed.

      Commands  Help                                                              
    ------------------------------------------------------------------------------
    REORG/MAINTENANCE     Update/Add Threshold Value Set           Row 1 to 1 of 1
                                                                                  
    Update the threshold values and press Enter to commit the updates. Acceptable 
    range for each threshold value is shown in the Description field. Press Cancel
    to remove all updates and exit. Use the Commands menu to display the rule     
    evaluation formula.                                                           
                                                                                  
    Locale  . . . . . . . . : BSNGLOBL  Rule name  : IBM.AVG_DBREC_LEN.10         
    Value set for threshold : LOW                                                 
    ID#     Value                             Description                         
    &1  85899345920   Numeric, range: 0 to 8589934592000                          
                      Data element name:  DB_AVG_DBREC_LENGTH                     
                      The average length of database records in the database, the 
                      partition, or the area.                                     
    ******************************* Bottom of data ********************************
  5. Note in the Description column the valid range allowed for the threshold you want to change. Type the new threshold value, and press Enter.
  6. When you have completed all modifications to this rule, press Enter.

    A Confirmation window is displayed.

                    Confirmation          
                                          
    Confirm you want to commit the changes.
                                          
    Do you want to commit all changes     
    for rule: IBM.AVG_DBREC_LEN.10        
                                          
                    Y  (Y/N)               
  7. Type Y (Yes) to commit all changes that you made to this rule, and press Enter.

    The Manage Rules panel is displayed.

  8. Type the C row action (Copy IBM. rule) on the row of the first rule you want to copy (for example, IBM.AVG_DBREC_LEN.10), and press Enter.

    The Locales in Current® Environment panel is displayed.

    Figure 2. Locales in Current Environment panel
       Help                                                                     
     -------------------------------------------------------------------------- 
     REORG/MAINTENANCE   Locales in Current Environment          Row 1 to 4 of 6
     Command ===>                                                               
                                                                                
     Rule name to copy to new locale(s) . : IBM.AVG_DBREC_LEN.10                
                                                                                
     Enter ALL for all locales.                                                 
     Enter row action for one or more locales.                                  
     A: Row Action: S- select locale                                            
                                                                                
     A   Locale    Description                                                  
     _   MYRECON1  MyRecon1                                                     
     _   MYRECON2  MyRecon2                                                     
     _   MYRECON3  MyRecon3                                                     
     _   MYRECON4  MyRecon4                                                     
    

    All listed locales were established during the Policy Services post-installation process using the IMS Tools Knowledge Base user/administration interface.

  9. Type the S row action (Select locale) on the row of the appropriate locale (or locales), and press Enter.

    You can also type ALL in the command line to select all listed locales.

    The Customize Rule Template panel is displayed again.

    The Copied column is updated to indicate that the rule has been copied to your locale (COPIED).

    A message is also displayed to indicate the success of the task:

    Rule IBM.AVG_DBREC_LEN.10 copied to new locale(s)
    Figure 3. Customize Rule Template panel
       Sort by  Help                                                                
     --------------------------------------------------------------------------      
     REORG/MAINTENANCE   Customize Rule Template                  Row 1 to 19 of 21 
     Command ===>                                                                   
     Rule IBM.AVG_DBREC_LEN.10 copied to new locale(s)                              
     Type a row action, then press Enter.                                           
     A: Row Action: C - Copy IBM. rule           F - Mark as customized             
                    L - List policies for rule   M - View rule in maint env.        
                    O - View rule in orig. env.  R - List of cloned rules           
                    S - Select rule to customize V - View maintenance info          
     A Rule Name                      Installed  Customized Copied                  
       IBM.AVG_DBREC_LEN.10           INSTALLED             COPIED
       IBM.CICA_SPLITS.10             INSTALLED             COPIED
       IBM.DBDS_EXTENTS.10            INSTALLED             COPIED
       IBM.DBDS_GROWTH.10             INSTALLED             COPIED
       IBM.DBDS_GROWTH.20             INSTALLED             COPIED
       IBM.DBDS_GROWTH.30             INSTALLED             COPIED
       IBM.DEDB_DBREC_IO.10           INSTALLED             COPIED
       IBM.DEDB_DBREC_IO.20           INSTALLED             COPIED
       IBM.DEDB_DBRECCNT.10           INSTALLED             COPIED
       IBM.DEDB_FS.10                 INSTALLED             COPIED
       IBM.DEDB_FS.20                 INSTALLED             COPIED
  10. Repeat the copy procedure for each remaining rule you want to copy. You can only perform this task one rule at a time.
  11. Press End (PF3).

    The Maintenance Management panel is displayed.

  12. Press End (PF3).

    The Policy Services Main Menu: Maintenance panel is displayed.