Skip to Content

Using plan and package impact analysis and reporting

BMC AMI Recovery Manager allows you to determine what plans or packages (and therefore what applications) are potentially unavailable during a planned backup and recovery.

You can obtain a list either online or from a batch report using the ARMBGIM program (see ARMBGIM-Impact-analysis).

BMC AMI Recovery Manager determines the impact information by analyzing the SYSIBM.SYSPLANDEP and SYSIBM.SYSPACKDEP tables for plans and packages respectively.

Related topics

ARMBGIM-syntax-and-option-descriptions

Creating-a-new-object-set

Object-set-recovery-revalidation-and-reporting

You can request a plan or package impact report for the current object set, which may be either a new (unsaved) object set that you have just created or one that you have retrieved from the repository.

You make your request in the Object Set Edit panel or you can generate JCL to run a report by using the R or RA options on the Object Set List panel.

Warning

Important

If you want to perform an analysis on multiple object sets, you can select all object sets of interest in the Object Set List panel and proceed to display a combined list of objects in the Object List panel. Then make the request in the Object Set Edit panel.

Generating impact reports in foreground or background mode

You can generate a list of plans and packages that would be impacted should you recover the current object set or object sets.

You can generate this report online (foreground mode) or create JCL to submit offline (background mode).

Generating impact reports in foreground or background mode - edited.png

Before you begin

You need the following authorizations to perform this analysis:

  • EXECUTE authority on the BMC AMI Recovery Manager Db2 plan

  • READ authority (TYPE O) on the object set

    Warning

    Important

    DB2 must be active when you execute the JCL.

To perform impact analysis for the current object set

  1. In the BMC AMI Recovery for Db2 Main Menu, select 1. Appl object sets.
  2. In the Object Set List panel, type a wildcard pattern or the name of a single object set in the format creator.name and press Enter. The object set or object sets that you specified are displayed.
  3. To generate an impact analysis report, perform either step A or step B.

    1. To report on selected object sets, type R beside one or more individual object sets. To report on all object sets, type RA in any space in the Act column. Press Enter. The Batch Object Set Report Options panel is displayed.

       ARMVO001 Batch Object Set Report Options - (1 OF 3)                    ========
       Command ===> _________________________________________________________________
                                                                                     
       Type information below. Then press Enter.                                      
                                                                                     
       Report type . . . . . . . 1 1. Revalidation   2. Impact analysis               
                                   3. Health check                                    
         Site type . . . . . . . 1 1. Local  2. Recovery                              
         JCL type. . . . . . . . 1 1. Local  2. DR                                    
         Recovery Resources. . . 1 1. Yes    2. No                                    
         Recoverability. . . . . 1 1. Yes    2. No                                    
         Tape pick list. . . . . 1 1. Yes    2. No                                    
         Data set recall list. . 1 1. Yes    2. No                                    
         Archive copy. . . . . . _ 1. Archive 1  2. Archive 2  3. Offsite Log         
         Email Summary . . . . . ________  EMAILDST Entry name                        
         Email at EOJ. . . . . . ________  EMAILDST Entry name                        
           EOJ RC. . . . . . . . ___  Range 0-254                                     
         Mirror System . . . . . 2 1. Yes    2. No        

       In the Batch Object Set Report Options panel, select 2. Impact analysis and specify any of the other options as necessary. For descriptions of the options, see Batch-object-set-report-option-descriptions. Press Enter.

      A second Batch Object Set Report options panel appears.

      ARMVO01A ============ Batch Object Set Report Options (2 of 2) =====================
      Command ===> _________________________________________________________________
                                                                                    
      Type information below. Then press Enter.                                      
                                                                                    
          Impact analysis options:                                                   
            Analyze plans . . . . . 1 1. Yes         2. No                           
            Analyze packages. . . . 1 1. Yes         2. No                           
            Report routing. . . . . 1 1. SYSOUT      2. Data set                     
              if data set, enter complete data definition below:                     
         . . //ARMPRINT DD___________________________________________________________
         . . ________________________________________________________________________
         WARNING - must include member name if the data set is partitioned.

      In the second Batch Object Set Report Options panel, perform the following substeps:

      • At Analyze plans, select Yes to obtain a plan impact report.
      • At Analyze packages, select Yes to obtain a package impact report.
      • At Report routing, if you do not want to use the default SYSOUT, you must also supply a complete data definition for the report output. If the data set that you specify is a partitioned data set, you must provide the member name.

      The JCL Specification panel is displayed (go to Step 5).

    2. This method allows you to generate the selected reports in foreground mode. It can only be used for the current object set.Type S in the Act column beside an object set. The Object List panel is displayed. Select 2. Object Set Edit and press Enter. The Object Set Edit panel is displayed. 

      ARMGE001 ========================= Object Set Edit =================================
      Command ===> __________________________________________________________________

      Type selection, and then press Enter.  You may modify the description.

      Object Set name   RDAXXX    TESTOBJECTSET
      Date created           2022-01-10-03.34.03.544585
      Date last updated      2022-02-24-16.05.16.01.300625
      Last updated by        RDAXXX

      4 1. Utility options      - Display or modify backup & recovery options
        2. Definition display   - Display population definition
        3. Batch report         - Batch object set revalidation report
        4. Impact report        - Report plans and packages impacted by the object set

      Description:
      ______________________________________________________________________________________________

    3. On the Object Set Edit panel, select option 4. Impact report and press Enter. The Plan/Package Impact Report panel is displayed. 

      ARMGIM01 = Plan / Package Impact Report - RDAXXX   TESTOBJECTSET          =========
      Command ===> _________________________________________________________________

      Indicate desired analysis.  Select foreground or background execution. For
      background provide the report routing information.  Then press Enter.

       Analyze plans. . . . 1 1. Yes  2. No
       Analyze packages . . 1 1. Yes  2. No
       Execution. . . . . . 1 1. Foreground   2. Background
       For background execution
         report routing . . 1 1. SYSOUT       2. Data set

            if data set, enter complete data definition below:

       . . //ARMPRINT DD___________________________________________________________
       . . ________________________________________________________________________

       WARNING - must include member name if the data set is partitioned.
  4. In the Plan and Package Impact Report Specification Options panel, perform the following substeps:
    1. At Analyze plans, select Yes to obtain a plan impact report.
    2. At Analyze packages, select Yes to obtain a package impact report.

    3. Select Foreground or Background mode for this report.

      Warning

      Important

      If you select Background and do not want to use the default SYSOUT, you must also supply a complete data definition for the report output. If the data set that you specify is a partitioned data set, you must provide the member name.

      Depending on your selections, one of the following panels appears:

      • If you selected Foreground, a list of the packages and/or plans involved in the recovery of the current object set is displayed in the Plan and Package Impact Report panel. Press F3 to exit the panel.
      ARMGI001 =============== Plan and Package Impact Report ==== NO PACKAGES FOUND
      Command ===> ________________________________________________ Scroll ===> PAGE


       Plan     Collection ID      Package   Version
      ACPSUP39
      ACPSUP40
      ACPSUP47
      ACPSUP48
      ACPSUP49
      • If you selected Background, the JCL Specification panel appears. Continue with Step 5.
  5. When the JCL Specification panel appears, enter a fully qualified output data set name. Be aware of the following information:
    • The output data set is used for saving the JCL and must be cataloged. If not enclosed in quotes, the output data set will be prefixed by your TSO prefix.
    • The job statement must contain a symbolic variable (&#) for the job number. For more information, see Output-data-sets-job-cards-and-symbolic-variables.
  6. Save the JCL data set or submit the job as required.

 

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

BMC AMI Recovery Manager for Db2 13.1