issuelist

list the change packages in a stream

Usage

accurev issuelist [ -s <stream> | -p <depot> ] [ -a ] [ -i ]
[ -I <issue-number> [ -d ] [ -3 ] ] [ -t <time-spec> ] [ -fx ]

Description

The issuelist command displays a list of issue numbers: for the issues whose change packages are partially or completely “in” a particular stream, snapshot, or workspace. (For simplicity, we just say “stream” below.)

•	Each change package entry is said to be “in” a particular stream if its head version (Version column) is the same as — or is an ancestor of — the version in the stream.

•	A change package is said to be “completely in” a particular stream if all of its entries are “in”.

•	A change package is said to be “partially in” a particular stream if some — but not all — of its entries are “in”.

•	A change package is said to be “active” in a particular stream if at least one of its head versions is in the stream’s default group.

Options

-a

Include an issue even if none of its change package’s head versions is active in the stream. By default, issues with such “old” change packages are excluded from the listing.

-d

Display information about the issue specified by the -I option, even if it is not in a change package for the specified stream or any stream in the specified depot.

 

-i

(“incomplete”) List issue records whose change packages are “partially in” the stream. By default, issue records whose change packages are “completely in” the stream are listed.

-I <issue-number>

Restrict the listing to the specified issue record. No error occurs if that issue record’s change package would not be listed; the command output is empty.

-3

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

-p <depot-name>

The depot to be processed. Returns all the issue record numbers for all the change packages for all the streams in the depot.

-s <stream>

 

The stream, snapshot, or workspace to be processed. Default: the workspace containing the current working directory.

-t <time-spec>

Display the issues that existed as of the specified time. A time-spec can be any of the following:

•	Time in <"YYYY/MM/DD HH:MM:SS"> format, "2007/08/07 20:27:15", for example. Note that you must use quotes when specifying time-spec as YYYY/MM/DD HH:MM:SS to ensure that the entire argument is interpreted by the command shell as a single token.

•	Time keyword: now

•	Transaction number as a positive integer: e.g. 146 or 23965

•	Transaction number keyword: highest

-fx

Display the results in XML format. The results include the field-by-field contents of each of issue record, not just the issue number.

Examples

List the issues whose change packages are completely in workspace brass_dvt_mary, including those with no version active in that workspace.

> accurev issuelist -s brass_dvt_mary -a
Issue: 1
Issue: 4
Issue: 5
Issue: 17

See Also

cpkadd, cpkdepend, cpkdescribe, cpkremove, issuediff, patch