User Guide - Mks.com

Chapter 7: Using Change Packages and Reviews
What Are Change Packages?
214
A change package is a group of changes made by a single user that can be
considered a logical unit of work. Only the creator of a change package
may add entries to that change package. Change package entries take the
form of operations, both deferred and committed. When reviews are
mandatory, change package entries take the form of pending entries before
they are committed.
For more information on change package entries, see “Change Package
Entry Types” on page 220 and “CP Entry Categories” on page 244
A change package administrator is a user with the permission to discard,
close, and submit change packages that were not created by that user.
The following rules apply when using issues and change packages:
Each change package has a unique change package ID (CP ID). The CP
ID is a colon separated identifier of the following form:
:
NOTE
If Integrity Manager integration is enabled, then the issue ID is used as the
container ID. For more information, see “The Integrity Manager Integration”
on page 371.
A change package acts as a log of both the changes to members that
have already been committed to the repository (server), and as a
record of work in progress, which is only visible to the user on the
desktop and not committed to the repository. It tracks the work in
progress using deferred operations that can be associated with a
change package. When reviews are mandatory, a change package acts
as a control placed on changes to the repository, by making them
pending before they are committed (see “Change Package Review
Process” on page 240).
A traditional change package has the following states: Open, Closed,
Discarded, and CommitFailed. A change package is open, or “in
progress” until you close it, which signifies that work on the change is
completed. If the changes fail to commit to the repository, then the
change package can be submitted again, or opened to continue work.
When reviews are mandatory, a change package has additional states
before it is closed (see “CP States” on page 241).
u s e r g u i d e