Setting Up a Build with Sample Files

The API call analysis is supported by the AD extensibility feature. You can try out the feature by setting up a build with the API extensibility sample files. For more information about the sample files, see topic API Extensibility Sample Files.

Procedure

  1. Create an AD project, and add the sample program files SQLCALL1.cbl and SQLGET.cbl into the project.
  2. Enable the API extensibility feature. After the API extensibility feature is enabled, the API Config virtual folder is added into the project. This folder is used to store the extensibility configuration files.
    1. Click Project > Settings > Extensibility.
    2. In the Extensibility pane, select the Enable API/Macro handling by using a configuration file check box.
      This image shows the Extensibility pane.
    3. Click OK.
  3. Add the following two sample files into the API Config virtual folder of the project. The files are the API extensibility configuration files.
    • Api_Config.json
    • ue-config.json
  4. Modify the paths in the ue-config.json file according to your settings.
    • Modify the class path of the sample JAR files according to your local environment.
    • Specify a path to store the input JSON files. This setting is optional and for debug purposes.
    • Specify a path to store the output JSON files.
  5. Build the project. For more information about building an AD project, see topic Building Projects.
With the API extensibility feature enabled, after a project build is completed, the following callgraph is generated for the SQLCALL1 program. In addition to the standard output log file, an extensibility log file is generated by the build process and stored in the <User folder name>\AD\comp\log folder.
This image shows the callgraph that is generated with the extensibility feature enabled.
Without the API extensibility feature enabled, after a project build is completed, the following callgraph is generated for the SQLCALL1 program:
This image shows the callgraph that is generated without the extensibility feature enabled.