Configuring source file location

Edit online

This topic describes how to reference source code files, like an alternative data set, from other locations.

About this task

2.6.0+

By default, the analysis output files use the data sets from which your source code files were compiled from as the reference location for features like source code linking and identifying the correct data to load for the statement performance tables. This may cause issues for users that use development tools that ‘check out’ source code into temporary data sets for compilation. Since these data sets no longer exist after the compile is completed, IBM® watsonx Code Assistant™ for Z Code Optimization Advice will not be able to find the source files when attempting to link to and open them.

This setting enables you to specify alternative source file location data set or local folder path that the extension can reference instead of the default location.

Procedure

  1. Navigate to the VS Code extension settings for Z Code Optimization Advice.
    This displays the source file location mapping setting.
  2. Confirm default source locations are populated in the Item column. If no entries are displayed, ensure you have completed the Configuring analysis output location step first, and select the Refresh default source files button to populate the list.
  3. Select Edit Item.
    This opens a text input field for the Item and Value columns.
  4. For each Item entry, specify your preferred source file location in the Value column. This can be a data set member name 2.6.10+ or a local absolute file path.
    Warning: Editing entries in the Item column can cause an error.

    It is recommended that you do not attempt to manually add Items to this table. Instead, follow this procedure after you have generated a performance analysis. This will automatically populate the default source file locations for you and reduce the amount of manual data entry required.

    Note: This is an example of source mapping entries. In this example, the user has specified preferred locations in the value column for the default locations in the Item column.
    Item                 Value
USER.TEMP.SOURCE     USER.ACTUAL.SOURCE
USER.HOST.SOURCE     /user/local/source

What to do next

Once you have completed this configuration, the extension will open the file when prompted from the preferred location instead of the original location. Ensure the source files in the two locations match to avoid data mismatches.