Creating IBM i search paths

Create a search path to provide a list of libraries to a Engineering Workflow Management build to locate artifacts for the build for an i Project on IBM® i.

Before you begin

Before you begin this task, you must create an IBM i project area. You must also create library definitions that specify the libraries to reference during a build.
Restriction: Before you can create, modify, or delete a search path, you must have permission to make these modifications. You can manage these permissions from the Project Configuration node on the Process Configuration tab in the Project Area editor.

About this task

You can create a search path in two ways:
  1. Expand these nodes in the Team Artifacts navigator: Enterprise Extensions > System Definitions > IBM i > Search Paths.
  2. From the main menu, select File > New > Other > Enterprise Extensions > IBM i > Search Paths.

The following task describes how to create a new search path from the Search Paths node in the Team Artifacts navigator.


  1. If you have not already done so, from the Team Artifacts view, select your repository connection and log in to your project area.
  2. Right-click the Search Paths node and click New Search Path.
    The Search Path editor opens with two tabs: General and History.
  3. In the Search Path editor, in the Name field, provide a name for the search path.
  4. Optional: On the General tab, you can browse to select the object library for the build to use. The library that you specify on this panel overrides the library that is specified for the IBM i project. You can select a target library or an existing library.
    Note: An existing library used as the object library is not supported for personal builds or promotions.

    You can specify any additional libraries to search during the build process using the Referenced libraries table. If a library already exists in the list, you can remove it if you do not want that library searched for artifacts. When the libraries are listed, move the libraries up or down in the list to determine the order in which the libraries are searched.

  5. Optional: In the Description field, briefly describe your language definition.
  6. If you made changes to this search path that do not require a full analysis of buildable files, click the Ignore changes to this system definition for dependency builds check box.
    For more information about analysis of buildable files, see Running dependency builds on z/OS and IBM i systems.
  7. On the History tab, you can see all changes made over time by different users to the search path. You can review the state of the search path at any point in time, which is useful for debugging and fixing dependency build problems.
  8. To save the new search path, click Save.