Creating a summary report using the load module scanner

Start of changeYou can request a summary report from the load module scanner by editing and running the job DFHEILMS in SDFHSAMP. The summary report gives a list of the modules that contain the commands specified by your filter, and the number of specified commands in each module. The job to request a summary report includes statements identifying the filter to be used (DFHFLTR), and (optionally) a data set to be produced for use with a detailed report (DFHDTL).End of change

To request a summary report from the scanner:

  1. Ensure that the load library to be scanned does not contain concatenated data sets.
  2. Edit the JOB accounting parameters as appropriate.
  3. Ensure that your region size is appropriate for the number of load modules that you want to scan. Do not specify REGION=0M. See Points to bear in mind when using the load module scanner for more information.
  4. On the PARM statement, specify SUMMARY. If you want to produce a list of modules to be used when running a detailed scan on this load library, specify DETAILMODS as well.
    Read syntax diagramSkip visual syntax diagram>>-PARM=SUMMARY--+-------------+-------------------------------><
                     '-,DETAILMODS-'
     
    
    SUMMARY
    Specifies that a summary scan (and report) is required for the entire library, except for certain CICS® modules (those beginning with XDFH, and the DL/I modules ASMTDLI, CBLTDLI and PLITDLI), CICS tables, and those modules that cannot be loaded (due to an error).
    DETAILMODS
    Specifies that the names of those modules that may contain at least one of the EXEC CICS commands identified in your filter, are to be written to the sequential file defined by the DFHDTL DD statement.
  5. Edit the STEPLIB, DFHIN, SYSPRINT, DFHFLTR and DFHDTL statements as required.
    STEPLIB DD statement
    Specifies the name of the load library where you have installed the scanner program, DFHEISUP.
    DFHIN DD statement
    Specifies the name of the load library to be scanned. This must not contain concatenated data sets. The DFHIN DD statement accepts only PDSs. If a PDSE is supplied, the results are undefined.
    SYSPRINT DD statement
    Specifies the destination for the summary report.
    DFHFLTR DD statement
    Specifies the input file for the filter, containing details of the commands in which you are interested. A sample command list, DFHEIDBR, is provided to search for commands that are not supported in the 3270 bridge environment. Another sample command list, DFHEIDTH, is provided to search for commands that give access to shared storage, which could make a program not threadsafe. See Creating a filter input file for the load module scanner for information on how to create a filter input file.
    DFHDTL DD statement
    This optional statement specifies the name of a sequential data set where the list of modules with potential command matches is to be sent. To send the list of modules to the data set, specify DETAILMODS on the PARM statement. You can edit the data set to alter the list of modules to be scanned, but note that all the modules listed must be in the same load library. You can use this file to restrict a subsequent detailed report on that load library, by specifying it on the DFHLIST DD statement of a detailed report run of the scanner. For more information about the DFHLIST DD statement, see Creating a detailed report using the load module scanner.

Figure 40 shows an example of a job to run a summary scan, using the sample command list DFHEIDBR as the filter input file.

Figure 40. Example of a job to run a summary scan
 //DFHSCNR  JOB (accounting information)                                
 //DFHSCAN    EXEC PGM=DFHEISUP,PARM=('SUMMARY, DETAILMODS'),REGION=512M
 //STEPLIB  DD DSN=HLQ.SDFHLOAD,DISP=SHR                                
 //SYSPRINT DD SYSOUT=*                                                 
 //SYSERR   DD SYSOUT=*                                                 
 //* Filter file, supplied by user, or from samples data set              
 //DFHFLTR  DD DSN=HLQ.ADFHSAMP(DFHEIDBR),DISP=SHR                     
 //*  Module list, to be created during summary,detail runs. 
 //DFHDTL   DD DSN=HLQ.MODLIST,DISP=(NEW,CATLG,DELETE),                
 //            DCB=(RECFM=FB,LRECL=80,BLKSIZE=8000),SPACE=(CYL,(1,1))  
 //* PDS containing loadmodules to be scanned                            
 //DFHIN    DD DSN=HLQ.SDFHLOAD,DISP=SHR  
                                                                  

Figure 41 shows an example of a summary report.

Figure 41. Example of a summary report produced by the scanner
CICS LOAD MODULE SCANNER UTILITY                                      
SCAN PERFORMED ON Tue Jun  6 13:37:48 2000 USING TABLE RSTABLE1.3     
                                                                      
SUMMARY LISTING OF UTL.CL717.LOAD             
                                
Module Name  Commands Found  Language                                 
DFHLMS00                 15  Assembler                                
INTROC                    8  Cobol                                    
                                                                      
LOAD LIBRARY STATISTICS                       
                                              
Total modules in library                             =      2         
Total modules Scanned                                =      2         
Total CICS modules/tables not scanned                =      0         
Total modules possibly containing requested commands =      2         

                   

Each summary report contains the following:

Related reference
Load module scanner (DFHEISUP)
Creating a filter input file for the load module scanner
Creating a detailed report using the load module scanner
Activating trace for the load module scanner
[[ Contents Previous Page | Next Page Index ]]