Reporting

The report function is used to generate reports from the policy databases. You can generate a full report of a policy database, or generate special reports which work in similar way, for example, a resource report, a symbol report, and so on. This topic describes the steps to generate a resource report and a full policy database report.

Generate a resource report

  1. On the Customization Dialog primary panel, select option 3 Report to display the Report Selection Menu. Except for option 1, the other reports work in similar way.
       MENU  HELP                                                                   
     ------------------------------------------------------------------------------ 
     AOFGREPK                      Report Selection Menu                            
     Option ===>                                                                    
                                                                                    
       1 Report           Create Policy Database Report                              
                                                                                    
       2 Unlinked         Create List of entries not linked in Policy Database       
       3 ViewUnlinked     View List of unlinked entries                              
                                                                                    
       4 Resources        Create List of generated Resources                         
       5 ViewResources    View List of generated Resources                           
                                                                                    
       6 MemberList       Create List of unused members in configuration data set    
       7 ViewMemberList   View List of unused members                                
                                                                                    
       8 StatusMsgs       Create Status Messages Report                              
       9 ViewStatusMsgs   View Status Messages Report                                
                                                                                    
       A Symbols          Create List of Symbols (AOCCLONEx) in Policy Database      
       B ViewSymbols      View List of Symbols   
      
       C OverrideMsgs     Create Message Override Report                            
       D ViewOverrideMsgs View Message Override Report  
    
       E Runmodes         Create Runmodes Report                                    
       F ViewRunmodes     View Runmodes Report
                                            
     
  2. On the Report Selection Menu panel, select option 4 to generate a resource report.
       MENU  HELP                                                                   
     ------------------------------------------------------------------------------ 
     AOFGREPK                      Report Selection Menu                            
     Option ===> 4                                                                 
                                                                                    
       1 Report           Create Policy Database Report                              
                                                                                    
       2 Unlinked         Create List of entries not linked in Policy Database       
       3 ViewUnlinked     View List of unlinked entries                              
                                                                                    
       4 Resources        Create List of generated Resources                         
       5 ViewResources    View List of generated Resources                           
                                                                                    
       6 MemberList       Create List of unused members in configuration data set    
       7 ViewMemberList   View List of unused members                                
                                                                                    
       8 StatusMsgs       Create Status Messages Report                              
       9 ViewStatusMsgs   View Status Messages Report                                
                                                                                    
       A Symbols          Create List of Symbols (AOCCLONEx) in Policy Database      
       B ViewSymbols      View List of Symbols   
      
       C OverrideMsgs     Create Message Override Report                            
       D ViewOverrideMsgs View Message Override Report     
    
       E Runmodes         Create Runmodes Report                                    
       F ViewRunmodes     View Runmodes Report  
  3. After the command process is displayed, press Enter to continue.
                              Command Progress Display                       
                                                                             
     Searching resources for system SYS1                                     
     Searching resources for system SYS1                                     
     Searching resources for system SYS1                                     
     Report output stored in member "RPTRES" in data set 'YUE.YUE.TEST.PDB-  
     ..........cont. .REP'. It can be viewed with option 5.                  
                                                                             
                    
     Press ENTER to continue 
  4. Enter 5 to view the resource report. The resources that are linked to specified systems are displayed. You see the system and the three resources that you linked to the system. There are no APG resources because you used a simple group, which does not generate a resource.
    ************************************************************************
    *                                                                       
    * Function                         RESOURCE REPORT                      
    * Policy Database name             TEST_PDB                            
    * Policy Database data set name    'YUE.YUE.TEST.PDB'    
    * Policy Description               test purpose               
    * Product Version                  IBM Z System Automatin 4.2      
    *    
    * UserId                           YUE                                  
    * Creation Date                    Monday, 5 July 2019                  
    * Creation Time                    08:37                                
    *                                                                       
    ************************************************************************
    Monitor resources (MTR) for system: SYS1                                
    
    Application resources (APL) for system: SYS1                            
      JES/APL/SYS1              JES                   via APG: BASE_SYS    
      TSO/APL/SYS1              TSO                   via APG: BASE_SYS    
      VTAM/APL/SYS1             VTAM                  via APG: BASE_SYS    
    
    ApplicationGroup (APG) resources for system: SYS1 
                          
    Sysplex ApplicationGroup (APG) resources          

Generate a full PDB report

  1. On the Report Selection Menu panel, select option 1 Report. The Policy Database Report Parameters panel is displayed.
  2. On the Policy Database Report Parameters panel, rename the Member / file name field as you like, leave the other fields as defaulted, specify 1 on the option line, and press Enter.
       OPTIONS  HELP                                                               
    --------------------------------------------------------------------------------
                             Policy Database Report Parameters                     
     Option ===> 1                                                                 
                                                                        More:     +
       1 Create report for a complete enterprise                                   
       2 Create report for entry type or entry name                                
                Entry Type. . . . . . . . . .                       (*, ?, or type)
                Entry Name. . . . . . . . . . *                     (*, ?, or name)
                                                                                   
     Report options:                                                               
       Data set type . . . . . PDS         (PDS FS)                                
       PDS name  . . . . . . . YUE.YUE.TEST.PDB.REP                           
       File system directory .                                                
       Member / file name  . . REPORT                      
       Mode  . . . . . . . . . ONLINE      (ONLINE BATCH)                          
       Format  . . . . . . . . FLAT        (FLAT HTML)                             
       HTML file split . . . . 1           (1 to 99 or *)                          
                                                                                   
     Job statement information:  (used for BATCH report)                           
     //AOFBUILD JOB                                                                
     //*                                                                           
  3. After the command process is displayed, Report Success is displayed in the upper right of the panel. Then, press PF2 to enter a new ISPF primary panel in split screen mode, enter 3.4 on the option line, and press Enter.
  4. On the Data Set List Utility panel, fill in the Dsname Level field with the same value as the PDB data set name.
       OPTIONS  HELP                                                                
      ----------------------------------------------------------------------------- 
                             Policy Database Report Parameters    Report Successful 
     .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
       Menu  RefList  RefMode  Utilities  Help                                      
      -----------------------------------------------------------------------------  
                                 Data Set List Utility                              
                                                                        More:     + 
        blank Display data set list               P Print data set list             
            V Display VTOC information           PV Print VTOC information          
                                                                                    
     Enter one or both of the parameters below:                                     
        Dsname Level . . . YUE.YUE.TEST.PDB.REP                                      
        Volume serial  . .                                                          
                                                                                    
     Data set list options                                                          
        Initial View                 Enter "/" to select option                     
        1  1. Volume                 /  Confirm Data Set Delete                     
           2. Space                  /  Confirm Member Delete                       
           3. Attrib                 /  Include Additional Qualifiers               
           4. Total                  /  Display Catalog Name                        
     Option ===>                                                                    
  5. Enter / and press Enter to select the data set you specified. Then Press Enter again.
       OPTIONS  HELP                                                                
      -----------------------------------------------------------------------------  
                             Policy Database Report Parameters    Report Successful 
     .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
       Menu  Options  View  Utilities  Compilers  Help                              
      -----------------------------------------------------------------------------  
     DSLIST - Data Sets Matching YUE.YUE.TEST.PDB.REP                    Row 1 of 1 
                                                                                    
     Command - Enter "/" to select action                  Message           Volume 
     -------------------------------------------------------------------------------
      /       YUE.YUE.TEST.PDB.REP                                           AOCSM3 
     ***************************** End of Data Set list ****************************
  6. On the Data Set List Actions panel, select option 2 and press Enter.
                        Data Set List Actions                      
                                                      More:     +  
     Data Set: YUE.YUE.TEST.PDB.REP                                
                                                                   
     DSLIST Action                                                 
     2   1.  Edit                     15. Reset                    
         2.  View                     16. Move                     
         3.  Browse                   17. Copy                     
         4.  Member List              18. Refadd                   
         5.  Delete                   19. Exclude                  
         6.  Rename                   20. Unexclude 'NX'           
         7.  Info                     21. Unexclude first 'NXF'    
         8.  Short Info               22. Unexclude last 'NXL'     
         9.  Print                    23. SuperC 'SC'              
         10. Catalog                  24. SuperCE 'SCE'            
         11. Uncatalog                25. Search-For 'SF'          
  7. Select the report you named in step 2 and press Enter to view the report. You see all the groups, systems, applications, and application groups that are defined so far in the policy database.
    
    -------------------------------------------------------------------------------  
                                   Report Selection Menu                            
     .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
       Menu  Functions  Confirm  Utilities  Help                                    
    ------------------------------------------------------------------------------- 
     VIEW              YUE.YUE.TEST.PDB.REP                  Row 0000001 of 0000002 
                Name     Prompt       Size   Created          Changed          ID   
     __s______ REPORT                  294  2018/08/06  2018/08/06 09:58:35  YUE       
               **End**                                                              
                                
     000109 ========== Applications ==========                                      
     000110 Subsystem Name                 : JES                                    
     000111 Job Name                       : JES                                    
     000112 Last changed by                : YUE                                    
     000113                                                                         
     000114 ========================================                                
     000115 TSO                                                                     
     000116 ========================================                                
     000117                                                                         
     000118 ========== Applications ==========                                      
     000119 Subsystem Name                 : TSO                                    
     000120 Job Name                       : TSO                                    
     000121 Last changed by                : YUE                                    
     000122                                                                         
     000123 ========== Relationships ==========                                     
     000124 | Relationship Type | Supporting Resource |                            
     000125 -------------------------------------------                            
     000126 | HASPARENT         | VTAM/APL/=          |                            
     000127                                                                        
     000128 ========================================                               
     000129 VTAM                                                                   
     000130 ========================================                               
     000131                                                                        
     000132 ========== Applications ==========                                     
     000133 Subsystem Name                 : VTAM                                  
     000134 Job Name                       : VTAM                                  
     000135 Last changed by                : YUE                                   
     000136                                                                        
     000137 ========== Relationships ==========   
     000138 | Relationship Type | Supporting Resource |                            
     000139 -------------------------------------------                            
     000140 | HASPARENT         | JES/APL/=           |