Information

This site will undergo a brief period of maintenance on Friday, 18 December at 12:30 AM Central/12:00 PM IST. During a 30 minute window, site availability may be intermittent.

Editing or viewing a data policy definition


Use this procedure to review or modify the information that is saved for a data policy definition.

To edit or view information for a data policy in the control data set

  1. Access the BMC AMI Batch Optimizer Objects List panel (Creating-a-new-data-policy-in-the-control-data-set).
  2. Type E (Edit) in the action entry field to the left of the data policy that you want to edit, and press Enter.The Data Optimization Policy panel is displayed. The following figure is an example of the panel. This panel lists the definitions in the data policy. The list shows the order of the definitions.
  3. Review the Selection Criteria.The Selection Criteria column contains an abbreviated version of the selection information for each definition statement in the data policy member. If more selection criteria exist than can be displayed in the allotted space for a definition, a plus (+) sign is displayed at the end of the affected definition. You can view a complete list of selection criteria by positioning your cursor beneath the '+' and pressing Enter or by using the ES line command to select this definition. You can view the following abbreviations for selection criteria by positioning your cursor beneath the Selection Criteria column and pressing F1 for Help.
    • DSN–data set name
    • JBN–job name
    • PGM–program name
    • DTY–data set type (VSAM, NONVSAM, and ALLFILES)
    • UID–RACF user ID
    • JBC–job class
    • J3C–JES3 //*MAIN job class
    • STP–step name
    • PRC–procedure step name
    • DDN–data definition (DD) name
    • DCL–SMS data class
    • SCL–SMS storage class
    • MCL–SMS management class
    • GRP–RACF group
    • TIM–time range (hhmm-hhmm)
  4. Review the Action and Mode values and modify them if needed.For each definition, the list indicates the associated action and mode to employ (the Action and Mode fields). These two fields indicate the options that you explicitly specified or they indicate implied behavior based upon your selections. When creating or modifying a statement, if you indicate that Action or Mode or both should use the default value, these columns display the result of that choice. To view the options that are explicitly specified for a particular statement, select the definition statement by using one of the Edit line commands.

    The following figure is an example of the panel. The customization process created this sample data policy. You can use this data policy for practice as you learn to manipulate data policies by using the BMC AMI Batch Optimizer dialog. You can edit this data policy to meet the needs of your site, or you can delete this data policy and create a new one.

                        Data Optimization Policy          Row 1 to 17 of 17
    Command ===> ________________________________________________ SCROLL ===> CSR_
                                                                                  
    Data Policy Information                                     System: SYSL       
      Name . . : DATPOL00                                       SMF ID: SYSL       
      Comment  . Sample data policy                             Date  : 2008/06/11
                                                                Time  : 14:49:26   
    Edit line commands:                                Statement line commands:    
    E=All fields       EG=Common fields                C=Copy  D=Delete  I=Insert  
    EN=NonVSAM fields  EV=VSAM Fields                  X=Cut   P=Paste             
    ES=Selection criterion only                                                    
                                                                                  
       Selection Criteria                                 Action  Mode   Response
    .. <new>                                                                       
    .. PGM(EASY*) DTY(VSAM)                               Exclude Advanced         
    .. JBN(APPRODJ*)                                      Exclude Advanced         
    .. PGM(EZT*) DTY(VSAM)                                Exclude Advanced         
    .. PGM(IEBDG) UID(MEB*)                               Include Advanced         
    .. PGM(IEBCOMPR) UID(MEB*)                            Include Advanced         
    .. DSN(PROD.AP.VSAM.BIAS01.**) DTY(VSAM)              Include Advanced         
    .. DSN(PROD.AP.VSAM.BIAS03.**) DTY(VSAM)              Include Advanced         
    .. DSN(PROD.AP.VSAM.BIAS05.**) DTY(VSAM)              Include Advanced         
    .. DSN(PROD.AP.VSAM.BIAS10.**) DTY(VSAM)              Include Advanced         
    .. DSN(PROD.AP.VSAM.BIAS99.**) DTY(VSAM)              Include Advanced         
    .. DSN(PROD.AP.NONVSAM.BIAS01.**) DTY(NONVSAM)        Include Advanced         
    .. DSN(PROD.AP.NONVSAM.BIAS03.**) DTY(NONVSAM)        Include Advanced         
    .. DSN(PROD.AP.NONVSAM.BIAS05.**) DTY(NONVSAM)        Include Advanced         
    .. DSN(PROD.AP.NONVSAM.BIAS10.**) DTY(NONVSAM)        Include Advanced         
    .. DSN(PROD.AP.NONVSAM.BIAS99.**) DTY(NONVSAM)        Include Advanced         
    .. DSN(PROD.AP.EXCLUDE.**) DTY(ALLFILES)              Exclude Advanced         
    .. DSN(PROD.AP.**) DTY(ALLFILES)                      Include Advanced         
    ******************************* Bottom of data ********************************

    The Data Optimization Policy panel is in a table format. Editing or viewing a data policy definition shows this panel as if it is displayed on a screen that is large enough to display all of the table rows.

  5. (optional) Change any input field on this screen by positioning the cursor in the field and typing a new value. Clear any characters that remain from the previously displayed value.
  6. (optional) Change the data policy definitions by typing one of the following edit line commands to the left of the policy that you want to change:

    • E - displays the complete definition
    • EG - displays optimization options that affect all data sets
    • EN - displays optimization options that affect nonVSAM data sets only
    • EV - displays optimization options that affect VSAM data sets only
    • ES - displays selection criteria only

    The individual edit line commands enable you to reference only the data that is of interest to you. The commands are useful when you want to view or modify a subset of the optimization options for a specific definition.

    If you select options E, EG, EN, or EV, the Data Policy Definition panel (or a variant of this panel with the appropriate subset information) is displayed.

    Warning

    Note

    The Data Policy Definition panel contains two scrollable areas that are designated by More:. One area is for the selection criteria and the other is for the data optimization options. To scroll a specific area, place the cursor within the area and enter a scroll command. The active selection criteria are displayed at the top of the list; blank specifications are displayed at the bottom. If you see one or more blank selection criteria, there is no need to scroll down for more selection criteria.

    The following figure shows an example of the panel. The customization process defines these sample data policy options.

    ------------------------------------------------------------------------------
    BSSP00MA                     Data Policy Definition
    Command ===> ________________________________________________ SCROLL ===> CSR_

    Data policy name  . . . . . . : DATPOL00
    Definition comment  . . . . . . ______________________

    Selection Criterion         Value
                                                                       More:     +
      Data set name . . . . . . PROD.AP.VSAM.BIAS01.**______________________
      Data set type . . . . . . VSAM________________________________________   +
      Job name  . . . . . . . . ____________________________________________
      Program name  . . . . . . ____________________________________________
                                                                       More:     +
    General options                 Value          Valid settings
      Action  . . . . . . . . . . . INCLUDE      + Include Exclude
      Optimization mode . . . . . . __________   + Basic Advanced Reportonly
      Dynamic region adjustment . . _              Y=Yes N=No
      Resource usage bias . . . . . 01             1-10 99
      Honor RUB value . . . . . . . _              Y=Yes N=No
      Optimize STC access . . . . . _              Y=Yes N=No
      Optimize TSO access . . . . . _              Y=Yes N=No
      Optimize TAPE data sets . . . _              Y=Yes N=No
      Optimize PO data sets . . . . _              Y=Yes N=No
      Optimize EXCP access  . . . . _              Y=Yes N=No
      Optimize DA data sets . . . . _              Y=Yes N=No
      SMF record type . . . . . . . ___            0, 128-255
      Override user values  . . . . _              Y=Yes N=No
    Resource Utilization options                   Valid settings
      Page fault rate threshold . . _____          0-99999   CPU utilization threshold . . D__           0-999                           
       Below 16M reserve . . . . . . D_______      0-16777215,16383K,15M           
       Above 16M reserve . . . . . . D_________    0-2147483647,2097151K,2047M     
       Maximum below 16M reserve . . D_______      0-16777215,16383K,15M           
       Maximum above 16M reserve . . D_________    0-2147483647,2097151K,2047M     
     Reporting options                             Valid settings                  
       Statistics  . . . . . . . . . D             Y=Yes N=No                      
       Statistics destination  . . . D_____        Sysmsg Sysout                   
       Statistics SYSOUT class . . . D             Sysout destination              
       Data set info . . . . . . . . D             Y=Yes N=No                      
       Data set info destination . . D_____        Sysmsg Sysout                   
       Data set info SYSOUT class  . D             Sysout destination              
       Message level . . . . . . . . D             0 1 2                           
       Message destination . . . . . D_____        Sysmsg Sysout                   
       Message SYSOUT class  . . . . D             Sysout destination
  7. (optional) Change any input field as necessary.You can make changes to any input field on this panel by positioning the cursor in the field and typing a new value. Clear any characters that remain from the previously displayed value. Fields that are followed by a plus (+) sign can be prompted for a list of valid values by positioning the cursor on the field and pressing F4 (Prompt) or by positioning the cursor beneath the '+' and pressing Enter.

    Warning

    Note

    The column to the right of the input fields describes the valid settings for those fields.

  8. (optional) Change the display if you want to modify a different subset of information or to see the comprehensive list of options.You can use F11 to toggle through the various displays or use the Display pull-down option and directly select a subset. If you display your function keys on the panel, the dialog sets the F11 label to the name of the next subset of data.
  9. (optional) Determine the current default (global) values. You can press F6 or choose View => 2 (Default values) on the action bar to toggle the column to the right of the optimization value input fields between the valid settings and the default values display. This test helps you to see the results of applying the global defaults. An example is shown in the following figure.

                                  Data Policy Definition                            
     Command ===> ________________________________________________ SCROLL ===> CSR_
                                                                                   
     Data policy name  . . . . . . : DATPOL00                                       
     Definition comment  . . . . . . ______________________                         
                                                                                   
     Selection Criterion         Value                                              
                                                                        More:     +
       Data set name . . . . . . PROD.AP.VSAM.BIAS01.**______________________       
       Data set type . . . . . . VSAM________________________________________  +    
       Job name  . . . . . . . . ____________________________________________       
       Program name  . . . . . . ____________________________________________       
                                                                        More:     +
     General options                 Value (or D)  Default values                   
       Action  . . . . . . . . . . . INCLUDE_    + EXCLUDE                          
       Optimization mode.. . . . . .             + ADVANCED                         
       Dynamic region adjustment . .               Y                                
       Resource usage bias . . . . . 01            99                               
       Honor RUB value . . . . . . .               N                                
       Optimize STC access . . . . .               N                                
       Optimize TSO access . . . . .               N                                
       SMF record type . . . . . . .               0                                
       Override user values  . . . .               N                                
     Resource Utilization options                  Default values                   
       Page fault rate threshold . .               0                                
       CPU utilization threshold . . D__           101                              
       Below 16M reserve . . . . . . D_______      0                                
       Above 16M reserve . . . . . . D_________    0                                
       Maximum below 16M reserve . . D_______      0                                
       Maximum above 16M reserve . . D_________    0                                
     Reporting options                             Default values                   
       Statistics  . . . . . . . . . D             Y                                
       Statistics destination  . . . D_____        SYSMSG                           
       Statistics SYSOUT class . . . D             A                                
       Data set info . . . . . . . . D             N                                
       Data set info destination . . D_____        SYSMSG                           
       Data set info SYSOUT class  . D             A                                
       Message level . . . . . . . . D             2                                
       Message destination . . . . . D_____        SYSMSG                           
       Message SYSOUT class  . . . . D             A                                
     NonVSAM options                               Default values
    Warning

    Note

    The column to the right of the input fields now describes the default values that are specified in the Defaults (Global) panel.

  10. (optional) Select option ES to display the Data Policy Definition Selection Criterion panel (see the following figure).In this panel, you can modify the selection criteria for a data policy definition. You can make changes to any input field on this screen by positioning the cursor in the field and typing a new value. Clear any characters that remain from the previously displayed value. Fields that are followed by a plus (+) sign can be prompted for a list of valid values by positioning the cursor on the field and enter F4 (Prompt) or by positioning the cursor beneath the '+' and pressing Enter.

    An example of the Data Policy Definition Selection Criteria panel is shown (see the following figure). This panel displays the complete list of available selection criteria in a scrollable area (designated by the More: specification).

                    Data Policy Definition Selection Criterion                   
                                                                                 
       Command ===> ________________________________________ SCROLL ===> CSR_     
                                                                                 
       Data policy name  . . . . . . : DATPOL00                                   
       Definition comment  . . . . . . ______________________                     
                                                                                 
       Selection Criterion       Value                                            
                                                                  More:     +     
       Data set name . . . . . . PROD.AP.VSAM.BIAS01.**______________________     
       Data definition (DD) name ________                                         
       Program name  . . . . . . ________                                         
       Step name . . . . . . . . ________                                         
       Procedure step name . . . ________                                         
       Data set type . . . . . . VSAM____   +                                     
       SMS Data class  . . . . . ________                                         
       SMS Storage class . . . . ________                                         
       SMS Management class  . . ________                                         
       Job name  . . . . . . . . ________                                         
       User ID . . . . . . . . . ________                                         
       Group . . . . . . . . . . ________

    The following figure shows an example of the Data Policy Selection Criterion panel after using the Prompt command to request a list of acceptable data set types. Select an appropriate data set type by placing the cursor next to the desired value and pressing Enter.

                 Data Policy Definition Selection Criterion     
                                                                                 
       Command ===> ________________________________________ SCROLL ===> CSR_     
                                                                                 
       Data policy name  . . . . . . : DATPOL00                                   
       Definition comment  . . . . . . ______________________                     
                                                                                 
       Selection Criterion       Value                                            
                                                                  More:     +     
       Data set name . . . . . . PROD.AP.VSAM.BIAS01.**______________________     
       Data definition (DD) name ________                                         
       Program name  . . . . . . ________                                         
       Step name . . . . . . . . ________                                         
       Procedure step name . . . ________                                         
       Data set type . . . . . . VSAM____   +                                     
       SMS Data class  -------------------Data Set Types--------------------------                   
       SMS Storage cl  |                                                         |  
       SMS Management  | Command ===> _________________________ SCROLL ===> CSR_ |  
       Job name  . .   |                                                         |  
       User ID . . .   |   Dstype     Description                                |  
       Group . . . .   | . ALLFILES   NonVSAM and VSAM data sets                 |  
                       | . VSAM       VSAM data sets only                        |  
    . DSN(PROD.AP.VSA  | . NONVSAM    NonVSAM data sets only                     |  
    . DSN(PROD.AP.VSA  ------------   ---------------- End of Data --------------  
    . DSN(PROD.AP.VSA                                                             
    . DSN(PROD.AP.VSA                                                             
    . DSN(PROD.AP.NON                                                             
    . DSN(PROD.AP.NON                                                             
    . DSN(PROD.AP.NON                                                             
    . DSN(PROD.AP.NON                                                             
    . DSN(PROD.AP.NON  ssssssssssssssssssssssssssssssssssssssssssssssssssssssssss
    . DSN(PROD.AP.EXCLUDE.**) DTY(ALLFILES)              Exclude Advanced
    Warning

    Note

    On some smaller display stations (24 lines by 80 columns), the Prompt pop-up panel might obscure fields that you need to see to aid you with your decision. Use the IBM ISPF Window command to move the pop-up panel display.

  11. (optional) Make changes to the list of definitions as required. See Data-policy-definition-administrative-actions.

    Warning

    Note

    The order of data policy definitions affects Data Optimizer operation. Data Optimizer processes data policy definitions from top to bottom and processes the service according to the first match that is found. If no match is found, no action is taken.

  12. (optional) Delete a definition by performing the following steps:
    1. Position the cursor in the action entry field to the left of your definition choice.
    2. Type D (for Delete) and press Enter.The Confirm Delete pop-up message is displayed, which asks you to confirm the delete request before the dialog removes the definition from the data policy.
    3. Press Enter to confirm the delete request.
  13. Save your changes by using one of the following methods:
    • Choose File => 2 (Save policy).

      The changed data policy is saved, and the same panel is displayed.

    • Type Save on the Command line.

      The changed data policy is saved and the same panel is displayed.

    • Press F3 (Exit). A Confirm Exit pop-up message is displayed. Type 1 (Save changes to disk and exit), and press Enter.

      The changed data policy is saved, and the BMC AMI Batch Optimizer Objects List panel is displayed with 'Edited' displayed in the Response column next to the changed policy.

Related topic




 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Batch Optimizer (Advanced and Standard) 2.9