Requesting an IBM i work item package

An IBM® i package build uses the information in an IBM i package definition to generate an archive of deployable binary files as a save file. Create and configure your IBM i package definition, then request a work item package that is based on those specifications.

About this task

To request an IBM i work item package, you must first create an IBM i package definition. For details, see Creating a package definition. Typically you create a work item package after a ship list package is created. With work item packaging, you can select artifacts that are related to specific work items and modify a package ship list.

Procedure

  1. Expand your project area, then expand Enterprise Extensions > Packages, then right-click your IBM i package definition.
  2. Select Create Package. The Create Package wizard opens.
  3. On the Packaging Type Selection page:
    1. Choose Work item packaging.
    2. Optional: To change the user authority for running this package, expand the Build Agent Authentication Override section and enter a user name and password.
    3. Optional: To change the build properties that are associated with this package, expand the Build Properties section and add, edit, or remove properties.
    4. Click Next.
  4. Select the work items that you want to package and specify any additional options. In the Definition field, either click Browse to choose the package definition you want to run, or run the default.
    1. Optional: Select Include children of selected work items.
    2. Optional: Select Include Impacted Outputs. This option adds to the package any artifacts that are built because of changes that are associated with the work items. For example, selecting this option packages all programs that are built because of a change to a copybook or include member.
    3. In the Select Work Items field, click Add to add a work item. The Select Work Items window opens.
    4. In the Select Work Items window, search for work items to add by entering some properties or work item keywords in the Containing ID or text field. Choose matching, assignment, and inclusion criteria to further filter your search results.
      1. Select a work item to add to your package, or select multiple work items by holding the CTRL key while you make your work item selections.
      2. Click OK to add your work items to the Package Work Items wizard.
    5. Optional: In the Package Work Items wizard, click Run Query to find and select work items to add to the Package Work Items editor.
      1. Click Run Query. The Select query to run window opens.
      2. Select and run a query and then add the work items that the query returns to the Package Work Items list.
  5. After you select all of the work items you want to package, click Next in the Package Work Items wizard. The Package Work Items Work Item Summary opens.
  6. On the summary page, verify the objects that are associated with the work items you chose. These objects are the ones that you are packaging. Click Next.
  7. Optional: On the Library Mapping Selection page, specify any additional changes that you want to make to your Library mapping table before you create your package. Click Add or Edit, and the Mapping Entry Manager wizard opens. Indicate which Library you want to map from, and which Library you want to map to. Click OK, and then click Next in the Library Mapping Selection page.
  8. Optional: In the Include Ship List Selection page, specify any additional changes that you want to make to your include ship list table before you create your package. Click Add or Edit, and the Ship List Manager wizard opens.
    1. If you do not specify a build definition in your package definition, Add generic filter is the only available option. Indicate library, object and type filters.
    2. Select specific objects is the default if you first select a build definition. Add library, object, and type filters and click Run.
    3. Click OK. You are returned to the Include Ship List Selection window, and your filters are displayed in the Include table. Click Next.
  9. Optional: In the Exclude Ship List Selection page, specify any additional changes that you want to make to your exclude ship list table before you create your package. Click Add or Edit, and the Ship List Manager wizard opens.
    1. If you do not specify a build definition in your package definition, Add generic filter is the only available option. Add library, object, and type filters. Click Run.
    2. Select specific objects is the default if you first select a build definition. Add a specific library, object, and type.
    3. Click OK. You are returned to the Exclude Ship List Selection window, and your filters are displayed in the Exclude table.
  10. Click Finish.

What to do next

Check your package results. For more information, see Checking packaging results.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki