list, ls

List ClearCase Synchronizer repository objects and synchronization objects.

Purpose

The ccc list subcommand with one of three ClearCase Synchronizer object types, (clones, synchronizedFilesAndFolders, or synchronizedStreams) lists ClearCase Synchronizer objects, including clones, synchronized files and folders, and synchronization streams. The alias for ccc list synchronizedStreams is ccc ls ccss. The alias for ccc list synchronizedFilesAndFolders is ccc ls sff.

Synopsis

  • To run ccc list after you have used ccc login to create stored credentials:

    ccc list object type -r 
    |  --repository-uri ] repository URI or nickname
     [ [ -c ] name -v  |  --verbose ] ] [object-type specific options]

  • To run ccc list supplying credentials on the command line:

    ccc list object type -r  |  --repository-uri ] repository URI -u  |  --username ] user ID in repository -P  |  --password ] password for user ID in repository [ [ -c ] name -v  |  --verbose ] ] [object-type specific options]

Options and arguments

-c ] name
A user ID valid in the specified repository. If this option is omitted, name defaults to the user ID of the user running ccc list. Not applicable when listing project areas, components, and remote files.
-P  |  --password ] password for user ID in repository
The password for the specified user ID in the named repository. If this option is not included on the command line, you are prompted for a password. If you specified a repository URI or nickname for which you have stored credentials using the ccc login command, this option is ignored.
-r  |  --repository-uri ] repository URI
Specifies the repository in which to take this action. If you have stored repository credentials using the ccc login command, you can use the nickname that you supplied for these stored credentials.
-u  |  --username ] user ID in repository
Specifies a user ID that exists in the named repository. If you specified a repository URI or nickname for which you have stored credentials using the ccc login command, this option is ignored.
-v  |  --verbose ]
Provide additional informational messages while operating.
object type
The type of item to list. One of:
clones
Lists all of the clone link information in a repository, regardless of project area boundaries. This command is for diagnostic use only.
-c  |  --component ] 
If this option is supplied, only clone links to objects within this component are listed.
synchronizedFilesAndFolders
List the synchronized files and folders of the named synchronized stream. The alias for ccc list with the synchronizedFilesAndFolders object type is ccc ls sff. The object-type specific option for this object type is required:
synchronized stream
A synchronized stream, specified by name. The files and folders of this synchronized stream are listed. A stream must be specified, and no more than one stream can be entered.
synchronizedStreams
List synchronized streams and stream information in all of the project and team areas of which the named user is a member. The alias for ccc list with the synchronizedStreams object type is ccc ls ccss. Object-type specific options for this object type are:
-L  |  --locallySyncd ] 
Operate on all synchronized streams that are synchronized on this host. This option can only be used if the command is run on the synchronization host.
-s
Display Jazz and ClearCase properties of the synchronized streams.
synchronized stream [...]
A space-separated list of synchronized streams, specified by name. If streams are specified, stream information is listed only for those streams.
syncEngine
List the synchronization engine processes that have been started by the named user and are currently running for one or more specified synchronized streams.
Operating system note: This command works on Linux only.
The alias for ccc list syncEngine is ccc list se. Object-type specific options for this object type are:
-L  |  --locallySyncd ] 
Operate on all synchronized streams that are synchronized on this host. This option can only be used if the command is run on the synchronization host.
synchronized stream [...]
A space-separated list of synchronized streams, specified by name. If streams are specified, stream information is listed only for those streams. You must specify one or more stream names or include the [ -L  |  --locallySyncd ]  option to specify all streams on this host.

List synchronized streams:

The user logs into the server with user1 as the user name, user1pw as the password, and repos as the repository nickname, then runs the list command.

C:\Program Files\IBM\TeamConcert\ccctools\eclipse>ccc login -r https://hostname.example.com:9443/jazz -u user1 -P user1pw -n repos
Logged in to https://hostname.example.com:9443/ccm

C:\Program Files\IBM\TeamConcert\ccctools\eclipse>ccc list synchronizedStreams -r repos
main:

Int1_15.35.55:

Int1:

main_BLX:

4 ClearCase synchronized stream(s) found

List synchronization engine process information about all synchronized streams in the repository nicknamed repos that are synchronized on the local host:

$ ./ccc list syncEngine -r repos --locallySyncd
main:
The count of active synchronization engine processes for the named synchronization stream(s) is 0, and a listing of the process ID(s) is as follows:

IntStream:
The count of active synchronization engine processes for the named synchronization stream(s) is 1, and a listing of the process ID(s) is as follows:
Process ID: 11508

List synchronization engine process information about synchronized stream IntStream in the repository nicknamed repos:

$ ./ccc list syncEngine -r repos IntStream
IntStream:
The count of active synchronization engine processes for the named synchronization stream(s) is 1, and a listing of the process ID(s) is as follows:
Process ID: 11508

Examples


video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki