Skip to content

Promoting a Release Area

Note

Components are promoted to all libraries that are defined for a promotion library type. (Multiple libraries for a library type for a promotion level display in ChangeMan ZDD with a number suffix. For example, if you have two libraries defined for JCL, they display as JCL.1 and JCL.2).

Running Promote Release Area

There are three or four pages in the Promote wizard. You can go back and forth between the pages using the Next and Back buttons. The Back button is the back arrow button at the upper left corner of the window.

To start the wizard, right-click on a package, release, or release area and chose Promote from the popup menu.

...

Promote Options Page

The Promote Options page displays when the wizard starts. On this page, you specify the release area from which you are promoting.

Fields on the Promote Options Page

This table describes the fields and options in the Promote Options page.

Field / Box Description
Release Displays the current release.
Promote from Select which libraries to promote from: Release - Package starting area Select a package from the Package drop-down list. Release - Any release area Select a release area from the Release area drop-down list and an application from the Application drop-down list. Base - Package staging libraries Select a package from the Package drop-down list.

...

Promote Location Page

On the Promote Location page, specify the location to which you are promoting the components.

The upper window displays a directory tree of promotion sites and levels. Hold the mouse pointer over a promotion level to see a description, which would be one of the following:

  • First promotion for the site.

  • New level. Package has previously been promoted to a lower level for the site.

  • Promoted level with no components. Can be any level up to the highest promotion level for the site.

  • Promoted level with components. Can be any level up to the highest promotion level for the site.

  • Invalid level selection.

    The Schedule box on the right side allows you to schedule a package promotion at a future date or time. If no date and time are specified, the promotion job will be submitted immediately. Scheduled promotions require ChangeMan ZMF 6.1 or higher.

The "Show user variables" check box displays the Other Options page which allows you to set user variables.

The lower window displays the job card for submitting the Promote job:

  • Default values are displayed initially. If you change the values, they will be stored in your registry and used as the defaults in the future.

  • Each time this dialog displays, the last character of the job name is incremented alphabetically.

  • If the \&SYSUID parameter in the Notify field is not overridden, the user ID is automatically substituted.

    Select a valid site/level to which you want to promote the package and change the job card if necessary.

Promote Components Page

On the Promote Components page, select the components to promote.

The display window lists all of the components available for promotion.

To hide components that have already been promoted to the target level, select the option "Hide components already at target level".

Selecting Components

There are two ways to select or deselect components:

  • Select or deselect components individually using the check boxes in the Components list.

  • Use the Selection filter field to enter one or more name patterns with wild characters, delimited by semicolons. Then press the Select or Clear button.

Promote Overlay Page

The Promote Overlay page lists components already in the promotion library that will be overlaid if you proceed with this promotion.

Promote Other Options Page

The Promote Other Options page displays only if customer-defined options have been specified in the PROMOTE member of the ZDDOPTS library.

Update the options as needed, following the validation rules specified in the PROMOTE member of ZDDOPTS.

Back to top