Searching for object dependencies with the system definition reference search on z/OS

Before you archive a particular language definition, data set 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, translators, and data set definitions. Many z/OS® functions, like IBM® Developer for z Systems® integration and the z/OS build functionality, can also reference any of these objects. If you want to stop using a language definition, translator, or data set definition, you can archive it so that it is no longer available for reference, but before you do so, you should search for any dependencies on that object. To search for dependencies on a language definition, translator, or data set definition, perform the following steps:


  1. In the z/OS 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 that you are logged in to.
  5. Select the project area you want to search.
  6. In the Search For field, select what you want to search for:
    • Language definitions
    • Data set 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 then 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 will display 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, data set definition, or translator that you are considering archiving.

About this task

If you are considering archiving a language definition, translator, or data set 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. To perform the References To action:


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

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki