Locating source

When you create a launch configuration for debugging an IBM® i application, you can set the source lookup path for the configuration, using the Source tab.

About this task

See below, and see Debugging a job with full prompt for information on the launch configuration.

If you do not move the source after compiling, the debug engine can find it. However, if you do move the source, you might want to add your own source path so that the debug engine can find it after it is moved.

Altering the source search path

About this task

Procedure

  1. Right-click the debug target in the Debug view (or one of its threads or call stack entries) and select Edit Source Lookup. The Edit Source Lookup Path dialog opens.
  2. By default, the debugger looks for the source in the location from which the program object is compiled. You can specify your own source lookup path:
    1. Click Add to add your own source path.
    2. In the Add Source dialog, click IBM i Source Physical File or Remote Folder.
      • Select IBM i Source Physical File if your source resides in source physical files. Click OK. In the "Select one or more source physical files" dialog, navigate to your source physical files.
      • Select Remote Folder if your source resides in the IFS. Click OK. In the "Browse for a folder" dialog, navigate to the remote folder containing your source.
    3. Click OK. Your source physical file or IFS path is added to the list under Source Lookup Path. You can add multiple source paths. The sequence in which they are listed is the sequence in which the debugger searches for the source.

  3. Optional: click Search for duplicate source files on the path. If this check box is not selected, the debugger searches the specified paths in sequence and uses the first occurrence. If this check box is selected, the debugger searches the specified paths and lists all occurrences, allowing you to select one.
  4. After you have added the path, click OK .

No source file found

About this task

When source cannot be found, an editor with an error message and three buttons displays. You have three options.

Procedure

Multiple source files found

About this task

If the Search for duplicate source files on the path check box is selected, the Select Source File dialog box opens when multiple files are found. The dialog box displays a list of all files that are found in the source containers specified in the Source tab of the launch configuration, from which you can choose the correct source to display for the debug session.


Feedback