<cclscoselector> Type

The <cclscoselector> type in a FileSet limits the files defined by that FileSet to those which are checked out of ClearCase.

Description

This type is a simple selector to obtain a set of elements that are currently checked out within a view. You case use this selector in combination with a FileSet and other ClearCase commands to perform collective operations on a set of checked out files. For example you could use it find all the files that have been checked out as part of a build and subsequently check them back in (see the examples below for more information).

Parameters
Attribute Description Type Requirement
cview Restricts the selection to checkouts made in the current view. On UNIX systems, if there is a working directory view, its checkouts are selected; otherwise, the checkouts in the set view are selected.
Default is false.
boolean Optional
user Restricts the selection to checkouts made by the specified user.
Default selects checkouts from all users.
String Optional
me Restricts the selection to your own checkouts.
Default is false.
boolean Optional
directory Selects the checkouts (if any) of a directory itself, rather than the checkouts of elements cataloged in it.
Default is false.
boolean Optional
all Selects all the checkouts in the VOB containing pname. If you don't specify any pname arguments, selects all checkouts in the VOB that contains the current working directory.
Note: A file element can have several names, by virtue of one or more VOB hard links. Checking out such an element under one name causes all the names to be selected as checked out. However, the all attribute selects the checked-out element only once.
boolean Optional
avobs Similar to all, but includes checkouts in all VOBs active (mounted) on the local host. (If environment variable CLEARCASE_AVOBS is set to a list of VOB-tags, this set of VOBs is used instead.) This option depends on the MVFS, and so has no meaning for snapshot-view-only hosts. This attribute is mutually exclusive with pname attribute.
Note: A view context is required when using this option.
boolean Optional
areplicas Selects checkouts of the element specified by pname in all replicas of the VOB that contains pname. If you don't specify any pname arguments, selects all checkouts in all replicas of the VOB that contains the current working directory. boolean Optional
 
Parameters as nested elements
See the Ant <fileset> task for supported parameters.
 
Examples

The following snippet will run "cleartool checkin -nc" on the set of files currently checkedout in the src directory:

       <project name="test" default="main" 
        xmlns:ca="antlib:net.sourceforge.clearantlib">
            <property name="dir.src" value="src"/>
            <target name="main">
                <ca:ccapply>
		    <arg value="checkin"/>
		    <arg value="-nc"/>
		    <fileset dir="${dir.src}">
			    <ca:cclscoselector me="true" cview="true"/>
		    </fileset>
		</ca:ccapply>
            </target>
        </project>

Copyright © 2000-2007, Kevin A. Lee and others; Portions © Apache Software Foundation