Managing deferred reports

Edit online

Deferred reports are reports that were generated by IMS Tools products in the Output repository but that have not been made available to users.

About this task

For example, the IMS Parallel Reorganization tool might be in the process of reorganizing databases to restore data clustering and distribute free space evenly. During the process, shadow databases exist.

The reorganization process requires the services of several other IMS Tools products. For example, IMS High Performance Image Copy allows database blocks to be passed directly from the reload task to an image copy task for processing. IMS High Performance Pointer Checker allows HASH pointer checking during the image copy processing.

Both IMS High Performance Image Copy and IMS High Performance Pointer Checker might be generating reports while supporting the reorganization process. While the reorganization task is in process (until the databases are switched), the generated reports are held in a deferred status by IMS Tools Knowledge Base.

If the IMS Parallel Reorganization database reorganization does not complete for some reason, the generated reports remain in the deferred state. You can manually manage these deferred reports by either deleting them or committing them to the Output repository. Typically this action will not be required.

Do not delete or commit any reports for active processes (in general, ignore anything within the last 24 hours).

Procedure

To manage deferred reports, complete the following steps:

Note: While reports are in the deferred state, they are not accessible for viewing from the IMS Tools Knowledge Base ISPF user interface.

Access the Administration menu from the IMS Tools Knowledge Base main menu panel.

For example:

Figure 1. Administration menu options

   Administration  Help           
 ________________________________________
 |    1. List Deferred Reports           |
 |    2. List Installed Products         |
 |    3. List Repositories               |
 |    4. List Recon Information          |
 |    5. Set retention for sensor data   |
 |_______________________________________|

Select option 1 (List Deferred Reports). Press Enter.

The Deferred Reports panel is displayed.

For example:

Figure 2. Deferred Reports panel

   Help                                                                         
 _______________________________________________________________________________
 SERVER: FPQRDP01                   Deferred Reports            Row 1 to 3 of 3 
 Command ===>                                                  Scroll ===> PAGE 
                                                                                
 Select a row action or press END to exit.                                      
                                                                                
 Row actions: C - Commit D - Delete                                             
                                                                                
     Job      Jobnum ID               Date/Time         Prod Name      Rptcnt   
     RDDEFRD  00938  C0908F66C6F26369 20220508 10:23:16 HP Unload      1        
     RDDEFRD  00938  C0908F67F39B3C69 20220508 10:23:17 HP Unload      1        
     RDDEFRD  00938  C0908F68FA315DAC 20220508 10:23:18 HP Unload      1        
 ******************************* Bottom of data ********************************

Use the Commit row action (C) to make the reports available from the IMS Tools Knowledge Base ISPF user interface. Press Enter.

The Report ID value changes to Committed.

For example:

Figure 3. Deferred Reports panel

   Help                                                                         
 _______________________________________________________________________________
 SERVER: FPQRDP01                   Deferred Reports          Reports Committed 
 Command ===>                                                  Scroll ===> PAGE 
                                                                                
 Select a row action or press END to exit.                                      
                                                                                
 Row actions: C - Commit D - Delete                                             
                                                                                
     Job      Jobnum ID               Date/Time         Prod Name      Rptcnt   
     RDDEFRD  00938  Committed        20220508 10:23:16 HP Unload      1        
     RDDEFRD  00938  C0908F67F39B3C69 20220508 10:23:17 HP Unload      1        
     RDDEFRD  00938  C0908F68FA315DAC 20220508 10:23:18 HP Unload      1        
 ******************************* Bottom of data ********************************

Use the Delete row action (D) to remove the reports entirely from the Output repository. Press Enter.

The Report ID value changes to Deleted.

For example:

Figure 4. Deferred Reports panel

   Help                                                                         
 _______________________________________________________________________________
 SERVER: FPQRDP01                   Deferred Reports            Reports Deleted 
 Command ===>                                                  Scroll ===> PAGE 
                                                                                
 Select a row action or press END to exit.                                      
                                                                                
 Row actions: C - Commit D - Delete                                             
                                                                                
     Job      Jobnum ID               Date/Time         Prod Name      Rptcnt   
     RDDEFRD  00938  Committed        20220508 10:23:16 HP Unload      1        
     RDDEFRD  00938  Deleted          20220508 10:23:17 HP Unload      1        
     RDDEFRD  00938  C0908F68FA315DAC 20220508 10:23:18 HP Unload      1        
 ******************************* Bottom of data ********************************