Creating a package definition

Use the Package Definition editor to define package definition properties.

Before you begin

To use the deployments and packages components, you must have a Developer for IBM® Enterprise Platforms client access license (CAL). You must also have the following permissions:
Save Build Engine, Save Build Definition, Request Build, Save Build Result.
Request Package.
Request Deployment.
A project administrator can modify these permissions by right-clicking your project area, clicking Open, and then expanding the Team Configuration node from the Process Configuration tab in the Project Area editor.
Note: For Rational Team Concert version 4 or version 5, the IBM i and z/OS® scripts are consolidated, so the directory structure changed. If you upgrade from V3.0.1.x to V4.0 or later but continue to use the V3.0.1.x package and deployment definitions, the old scripts are used. If you create new package and deployment definitions, the new scripts are used. If you customized the scripts for version 3.0.1.x, make the same changes to the new V4.0 or later scripts. For more information, see


  1. In the Team Artifacts view, expand your project area, and then expand the Enterprise Extensions node. Right-click Packages, and then select New Package Definition.
    The New Package Definition wizard opens.
  2. In the New Package Definition wizard, browse to the project or team area that is associated with your package.
  3. Select Create a new package, which is the default selection. If another package is available, you can also choose Create a package by copying an existing package. Click Next.
    The General Information window opens.
  4. In the General Information window, enter a package ID, a brief definition description, and then select the package file system that you are using.
    The file system options are as follows:
    • IBM i
    • Linux/UNIX
    • z/OS
    Click Next.
  5. Choose any additional configuration options and click Finish.


The Package Definition editor opens to the Overview tab, displaying an overview of your new package definition.

The archive produced on z/OS uses the PAX/tar file format, even if the package has a .zip extension. You can inspect the content of the produced archive. See Inspecting a package.

What to do next

Configure your package definition according to the steps required for your operating system. Also, for Linux or UNIX you must create a ship list file by completing the steps that are described here: Creating a ship list filter file. A ship list filter file is optional for IBM i and z/OS.