setplevel

Changes the list of promotion levels in a UCM project VOB

APPLICABILITY

ClearCase UCM (cleartool subcommand)

SYNOPSIS

setplevel [ -c·omment comment | -cfi·le comment-file-pname |-cq·uery | -nc·omment ]

[ -inv·ob vob-selector ] -def·ault default-promotion-level
promotion-level ...

DESCRIPTION

The setplevel command allows you to redefine the list of baseline promotion levels for a UCM project VOB and to designate one of these levels as the default promotion level for new baselines

Each UCM project VOB includes an ordered set of promotion levels. Promotion levels are ordered from lowest to highest and can be assigned to baselines to indicate the quality or degree of completeness of the activities and versions represented by the baseline. Each project VOB uses one of its promotion levels as the default promotion level. This is the level that is assigned to newly created baselines.

When a project VOB is created, it includes the following ordered set of promotion levels: REJECTED, INITIAL, BUILT, TESTED, RELEASED. The default promotion level is INITIAL.

You can replace this set, add or remove a promotion level, or change the default promotion level. To do this, supply a complete, ordered list of promotion levels to replace the current set. You must also specify one of the elements of the new list as the default promotion level.

When you delete a level that is in use, it is not completely removed from the project VOB. Instead, its place in order is changed so that it is considered to be "lower" than the lowest defined level. You can list information for baselines labeled with such a promotion level lsbl -level command.

The promotion levels available in a VOB can be listed by running the describe command on the UCM project VOB object.

OPTIONS AND ARGUMENTS

EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by your .clearcase_profile file (default: -nc). See CUSTOMIZING COMMENT HANDLING in the comments reference page. Comments can be edited with chevent.

-c·omment comment | -cfi·le comment-file-pname |-cq·uery | -cqe·ach | -nc·omment

Overrides the default with the option you specify. See the comments reference page.

-invo·b vob-selector

Specifies the UCM project VOB for the project whose promotion levels are being modified. By default, the setplevel command operates on the project VOB containing the current working directory.

-def·ault default-promotion-level

Specifies the default promotion level. Project baselines are given the default promotion level when they are created. This argument is required and must be one of the specified promotion levels.

promotion-level ...

An ordered list of promotion levels that defines the promotion level set for a project VOB. List elements are ordered from lowest to highest. All elements of a set must be given.

EXAMPLES

Examples including wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• From the project VOB directory, modify a new project VOB's set of promotion levels by removing the INITIAL level and adding a START level. Change the default level for new baselines to BUILT.

cmd-context  setplevel -default BUILT REJECTED START BUILT TESTED

• Replace the promotion level UNIT_TEST with U_TEST.
  1. Add the new level to the current set of promotion levels:

cmd-context setplevel -default NEW NEW BUILT UNIT_TEST U_TEST

1. Find baselines that use the old promotion level:

cmd-context  lsbl -level UNIT_TEST mybaseline

1. Change the promotion level from UNIT_TEST to U_TEST:

cmd-context  chbl -level U_TEST the-baselines-listed-by-step-b.

1. Remove the obsolete promotion level from the project VOB:

cmd-context  setplevel -default NEW NEW BUILT U_TEST

SEE ALSO

chbl, describe, lsbl