Searching for object dependencies with the system definition reference search on IBM i

Before you archive a particular language definition, search path, library definition, or translator, you can search your Eclipse workspace and display a list of references to any of these objects.

Before you begin

To check for references to objects, you must first load the Eclipse workspace that contains these objects. To do this, load your personal repository workspace with all of the required components and then load the Eclipse workspace using that repository workspace.

About this task

It is possible for several project areas to reference language definitions, search paths, translators, and library definitions. Many IBM® i functions, like Rational® Developer for i integration and the build function, can also reference any of these objects. If you want to stop using a language definition, search paths, translator, or library definition, you can archive it so that it is no longer available for reference. Before you do so, you should search for any dependencies on that object. To search for dependencies on a language definition, search path, translator, or library definition, perform the following steps:


  1. In the client, click Search in the topmost toolbar.
    A menu is displayed.
  2. Select Search from the menu.
    A Search window opens.
  3. Click the System Definition Reference Search tab.
  4. In the first field, select the repository to which you are logged in.
  5. Select the project area you want to search.
  6. In the Search For field, first select IBM i as the system and then select what you want to search for:
    • Language definitions
    • Search paths
    • Library definitions
    • Translators
    Tip: Put an asterisk (*) at the end of a search string to perform a wild card search. For example, if you want to search for and display a list of any translators that begin with the letters "CO," enter CO* in the Search string field.
  7. In the Limit To field, choose how you want to filter the display results. You can choose to limit your search to one of the following object statuses:
    • Archived
    • Active
    • All
  8. Click Search to search or Cancel to stop.
    Note: The queries related to system definition searches run against indices. The size of the indices increases over time.

    The location of the indices is controlled by the variable in the file of the Change and Configuration Management (CCM) application. For a large stream, the indices folder can grow in size to multiple gigabytes (GB). The administrator might prefer to set an absolute path for the variable, to ensure that enough disk space is available for the growth of the indices.

What to do next

You can repeat any search you have already performed. To repeat a previous search, perform the first four steps to search for model object dependencies. The first field drop-down menu displays a history of all of your previous searches in that repository.
Restriction: Your repository search history is available only until you close your client.

Performing the References To action

Perform the References To action to discover and display a list of any references to a language definition, library definition, search path, or translator that you are considering archiving.

About this task

If you are considering archiving a language definition, translator, search path, or library definition, select that object, then select the References To action in the Team Artifacts popup menu to discover and display a list of any references to that object.


  1. In the Team Artifacts view, expand your project area node, then expand the Library Definitions Search Paths, or Language Definitions node.
    Note: To select a translator, you must first expand the Language Definitions node.
  2. Right-click the library definition, search path, language definition, or translator whose references you want to display.
  3. Select References To.
    A list of objects that reference your language definition, library definition, search path, or translator opens in the Search Results window.