CLI Reference > Configuration Management Commands > si discardcp
si discardcp
discards a change package
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...
si discardcp discards a change package. For example,
si discardcp --confirm 34343:2
Windchill RV&S 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.
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
specifies if to confirm discarding the change package.
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.
See the diagnostics reference page for possible exit status values.
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
Miscellaneous: ACL, diagnostics, options, preferences