cpkremove

remove an entry from a change package

Usage

accurev cpkremove [ -p <depot-name> ] [ -I <issue-number> [ -3] ] [ -fx ]
{ <element-list> | -e <eid> [ -v <seg_head> -j <seg_basis> ] | -k |
[ -Fx ] -l <list-file> }

Description

The cpkremove command removes one or more entries from the specified change package — that is, the Changes tab of the specified AccuWork issue record. You can specify the element by its name or its element-ID, and you can specify a specific segment of an EID.

Options

-I <issue-number>

The issue record whose change package entry is to be removed.

-3

Specifies that the <issue-number> specified by the -I switch is a third-party ITS key rather than an AccuWork issue number.

-k

Process all (kept) elements in the workspace.

 

-e <eid>

The element whose change entry is to be removed. If you also specify a <list-file> or <element-list>, it is ignored.

 

-v <seg_head>

The head version of the segment to be removed.

-j <seg_basis>

 

The basis version of the segment to be removed.

-Fx

Signals that <list-file> (see the -l option) is an XML-format file, not a flat text file.

<elements>
    <e l="\.\file_0001" v="4/1" eid="2"></e>
    <e l="\.\file_0002" v="4/1"></e>
    <e eid="4" v="4/1"></e>
</elements>

-l <list-file>

Process the elements listed in <list-file>. This must be a text file, with one element name per line. Extra whitespace is not allowed; make sure there are no empty lines and no leading or trailing white space around the filenames. Wildcards are not expanded. There is no provision for comment lines in the file.

If you use this option, any <element-list> specified is silently ignored.

<element-list>

One or more element names, separated by whitespace. If you also specify a <list-file> using the –l option, this <element-list> is silently ignored.

-p <depot-name>

The depot in which the issue record is located (default: the depot of the current workspace).

-fx

Display the results in XML format. If the command succeeds, the response is:

<acResponse/>

If the command fails, the response is:

<acResponse>
     <Message>Issue not found.</Message>
</acResponse>

Examples

In issue record #4871 in depot brass, remove the change package entry for the element with element-ID 729.

> accurev cpkremove -I 4871 -e 729 -p brass

In issue record #4871 in depot brass, remove the change package entry for the segment with basis version of 16/3 and a head version of 15/9 for the element with element-ID 729.

> accurev cpkremove -I 4871 -e 729 -p brass -j 16/3 -v 15/9

Perform the same task as above, but by using the "-Fx -l" XML technique:

> accurev cpkremove -I 4871 -p brass -Fx -l .\element_list.xml

where element_list.xml has the following contents:

<elements>
     <element eid="729" v="15/9" bv="16/3"></element>
</elements>

See Also

cpkadd, cpkdepend, cpkdescribe, issuediff, issuelist, patch

Techniques for Selecting Elements