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.
CICS 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.
You 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).
Figure 39 shows how the scanner works.