si discardcp
discards a change package
Synopsis
si discardcp [--[no]confirm] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-Ffile|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] issue|issue:change package id...
Description
si discardcp discards a change package. For example,
si discardcp --confirm 34343:2
Integrity Lifecycle Manager provides a way to remove change packages from active use when they are not needed by discarding them.
Change packages can only be discarded if they are in the Open or Rejected states. In order to discard a change package, that change package must be both created by you and not contain any committed entries. However, a change package administrator may discard a change package created by another user.
When a change package is discarded, the following happens where applicable:
• all uncommitted entries are removed from the change package
• all deferred operations corresponding to deferred entries are reverted
• all locks on members corresponding to lock entries are released
• all work in progress entries are reverted
• all pending operations corresponding to pending entries are reverted, and appear as discarded entries in the review log (to preserve the review history)
• all pending revisions that correspond to pending entries are deleted
• any archives created for pending members associated with pending entries in the change package are deleted from the server (pre-existing archives that were shared to create a pending member are not deleted)
Note the following about discarded change packages:
• The change package ID for the discarded change package can never be used for any future change packages that are created.
• Discarded change packages have a state of Discarded, and can still be viewed using the Change Package filter.
• If the change package has undergone a review, the review log persists.
• Discarded change packages can be opened and used again.
Options
This command takes the universal options available to all
si commands, as well as some general options. See the
options reference page for descriptions.
• --[no]confirm
specifies if to confirm discarding the change package.
• issue...
issue identifies a specific issue that contains all change packages that you want to discard; use spaces to specify more than one issue.
• issue:change package id...
issue:change package ididentifies a specific change package to discard; use spaces to specify more than one change package.
Diagnostics
See the
diagnostics reference page for possible exit status values.
Preferences
Using
si setprefs or
si viewprefs, you are able to set or view the preference keys for this command.
See Also
• Commands:
si add,
si ci,
si co,
si cpissues,
si createcp,
si drop,
si lock,
si viewcps,
si acceptcp,
si rejectcp,
si opencp