Creating an IBM i library definition

Create a library definition to describe the library that your build will reference.

Before you begin

This topic describes how to create a IBM® i library definition.
Restriction: Before you can create, modify, or delete a library definition, 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 library definition one of two ways:
  • Expand these nodes in the Team Artifacts navigator: Enterprise Extensions > System Definitions > IBM i > Libraries.
  • From the main menu, select File > New > Other > Enterprise Extensions > IBM i > Library Definition.

The following steps describe how to create a new library definition from the Libraries node in the Team Artifacts navigator.


  1. From the Team Artifacts view, select your repository connection and log in.
  2. Expand your team project node.
  3. Expand the Enterprise Extensions > System Definitions > IBM i > Libraries nodes. Right-click the type of library you want to define, either an existing library or a target library, and select New Library Definition. The Library Definition editor opens with two tabs: General and History.
  4. In the Name field, give your library definition a name.
  5. On the General tab, specify the following attributes:
    1. In the Library field, enter the actual library name that either already exists on the IBM i build machine, or that you want to create during the build process.
    2. Optional: In the Description field, briefly describe your new library definition.
    3. If you made changes to this library definition 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.
  6. On the History tab, you can see all changes made over time by different users to the library definition. You can review the state of the library definition at any point in time, which is useful for debugging and fixing dependency build problems.
  7. Click Save.

What to do next

You can also duplicate any library definition. To do this, perform the following steps:
  1. Open the Team Artifacts view.
  2. Expand the Libraries node.
  3. Expand either Existing Libraries or Target Libraries.
  4. Right-click the library definition you want to duplicate.
  5. Select Duplicate. The Duplicate system definition window opens.
  6. Give your duplicate library definition a name.
  7. Click OK to duplicate the library definition or Cancel to stop.
  8. Your new duplicate library definition should be displayed under the Libraries node. If it does not, refresh the view.

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