Create a release

Create a snapshot of a product configuration or a baseline that you can then package and ship to a customer, for example, or use in integration testing.

If you are creating a release on a z/OS mainframe node, Dimensions CM automatically creates the target data sets, and you do not have to pre-allocate them. But make note of the target location so that you know where the files are stored.


  • To create releases, you need the Create Release privilege.

  • If the baseline for the release includes items that do not belong to the product, you may need additional privileges.

  • Ensure that you have permissions to create the folders on the appropriate workstation or server.

To create a release:

  1. In the web client, open the Baselines view and click the Manage Releases button on the toolbar. The Manage Releases dialog box opens.

  2. On the Releases tab, click the New button.

  3. In the New Release dialog box, specify the following options:

    Option Description
    Release ID

    Enter a name for the release. The name must be unique within the product. Because Dimensions CM doesn't record variants, versions, or revisions for a release, make the name as specific as possible, for example:

    Release for USA

    Release template ID

    If applicable, select a release template.

    Release templates are created in the Administration Console.

    Description (Optional) Add a description of the release.
    Baseline to be released Enter the name of the baseline from which to make the release, or click the browse button to select a baseline.
    Release directory To use the project/stream root folder, leave the field empty. To specify a release folder where to copy the item revisions, enter an absolute path or path relative to the project root folder.
    Expand substitution variables Select this option to enable item header substitution. For details, see About creating items.
    Automatically overwrite files Select this option to overwrite any matching files in the release directory. By default, no files are overwritten.
    Apply system date/time Select this option to set the timestamp of your work area files to the current date and time.
    Delta release Select this option to base the new release on a previous release. For Previous Release, enter the name of the source release.
  4. Click OK. Dimensions CM sends an email notifying you when the operation is completed.

Back to top

See also: