Tutorial: Updating the scan options for the GenAppC project

Learn how to update a scan option for the GenAppC project and then observe the changes to the scan results after your update.

Prerequisite

You have completed the Tutorial: Performing impact analysis of GenAppC, a demo project.

Notes: The steps below are based on the following assumptions.
  1. You are deploying the Wazi Analyze container from a Wazi Analyze image.
  2. You are using Docker Desktop for Windows or Mac.
If you are deploying Wazi Analyze from Docker registry or using a Linux® machine, see Deploying the Wazi Analyze container with Docker.

Procedures

To update a scan option for the GenAppC project, complete the following steps:
  1. If you have not yet done so, navigate to https://localhost:5000/login and log in to Wazi Analyze with the password wa1234.
  2. Select the History icon (Figure shows the History icon. ) to see the graph that you previously viewed.
  3. Select the LGICDB01.CBL view from the saved views.
    Figure shows the LGICDB01.CBL view.
  4. Click the Close (X) icon on the History pane to close it.
  5. Observe the graph that is displayed.
    Figure shows the relationship of LGICDB01.CBL with system copybooks.
    You will see the relationship of LGICDB01.CBL with system copybooks, for example, DFHEIVAR.CPY, DFHEIBLK.CPY, DIBSTAT.CPY, and DEFVAR.CPY. It is because that the OPTION_IBM_ALLSRCEDGES is enabled in the configuration file (.dat file) of GenAppC project.
    Note: When the OPTION_IBM_ALLSRCEDGES option is enabled, Wazi Analyze displays the relationships between files to system copybooks and macros that are used by internal processing. For more information, see Understanding scan options for the demo project GenAppC.
  6. On the terminal, run the following command to shut down Wazi Analyze servers.
    wa-shutdown.sh
    When the servers are shut down, you will see the following message.
    Shutting down Wazi Analyze servers
Wazi Analyze servers shutdown complete
  7. Open the configuration file for GenAppC under the /home/wazi/data/GenAppC directory. If you use the VI editor, you can run the following command to open the file.
    vi /home/wazi/data/GenAppC/GenAppC.dat
    You will notice that the OPTION_IBM_ALLSRCEDGES is enabled (set to 1) along with the other options that are described in Understanding scan options for the demo project GenAppC.
  8. Disable the OPTION_IBM_ALLSRCEDGES option by changing the setting to zero as the following example.
    OPTION_IBM_ALLSRCEDGES=0
  9. Press Esc + :wq to save the changes.
  10. Scan the GenAppC project by running the following command.
    wa-scan.sh GenAppC
  11. On the terminal, run the following command to start the Wazi Analyze servers.
    wa-startup.sh
    When servers are started up, you will see the following messages.
    Figure shows the message that is showed after the Wazi Analyze servers are started.
  12. When the terminal prompts for your password input, enter wa1234.
    Figure shows the command lines after you enter a password.
  13. Navigate to https://localhost:5000/login and log in to Wazi Analyze with the password wa1234
  14. Select the History icon (Figure shows the History icon. ) to see the graph that you previously viewed.
  15. Select the LGICDB01.CBL view from the saved views to observe the changes to the scan results after your update to the option.
    Figure shows the LGICDB01.CBL view.
    You will notice that all of the system copybooks are not displayed on the graph since the OPTION_IBM_ALLSRCEDGES option is disabled.

Since you have learned how to update a scan option for the GenAppC project, you can try to update the other scan options available. For more information about the scan options of GenAppC, see Understanding scan options for the demo project GenAppC.