Load module scanner (DFHEISUP)

This section describes the load module scanner. This utility can scan load libraries for the CICS® commands in load modules, and identify which modules contain specific API or SPI commands that you have named. For example, if you know that a particular API or SPI command should be changed to take advantage of a new feature in CICS, you can use the load module scanner to identify all the load modules that contain the command. The load module scanner can look for specific commands, or options on commands, or combinations of options. It can also scan for commands where certain options are not specified.

The load module scanner is a batch utility. It locates all the EXEC CICS commands in your load modules, and then applies the filter that you have created, to identify only the commands in which you are interested. It returns one of two types of report:

Both types of report identify the language of each load module.

Start of changeCICS supplies a sample job, DFHEILMS in SDFHSAMP, that you can edit and use to execute the load module scanner. On a given run of the load module scanner, you can scan all the load modules in a load library (if you specify a complete PDS), or you can specify certain load modules within the library to scan. A useful technique is to run a summary scan for a particular load library, to produce a list of the modules that contain the commands in which you are interested. The load module scanner enables you to place this list of modules into a data set. You can then run a detailed scan, using this data set as input, to produce a detailed report on only the modules that contain the commands in which you are interested.End of change

Start of changeYou specify the commands to be reported upon as a filter input file. You can name the commands in which you are interested. You can also include or exclude commands that have certain parameters. The 'any' operator can be used to search for all parameters, or for all commands. A number of sample command lists are provided to help you. Use DFHEIDBR to search for commands that are not supported in the 3270 bridge environment. Use DFHEIDTH to search for commands that give access to shared storage, which could make a program not threadsafe. Use DFHEIDAL to search for all the basic valid commands, and use DFHEIDNT to find all non-threadsafe CICS commands (which would cause a switch to the QR TCB).End of change

Points to bear in mind when using the load module scanner

Figure 39 shows how the scanner works.

Figure 39. Load module scanner with filter
 The load module scanner looks at the modules identified in the list of modules you have provided. It produces a list of all the EXEC CICS commands in the modules. Next, it looks at the filter input file you have provided, which contains a list of the commands in which you are interested. It applies this filter to the list it has just produced, to create a filtered list of the EXEC CICS commands of interest in the modules. Finally, it produces a report showing you each module that contains one or more of the commands in which you are interested, and listing the commands of interest in each of those modules.

Related reference
Creating a filter input file for the load module scanner
Creating a summary report using 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 ]]