001    /*
002    * file CcLocation.java
003    *
004    * Licensed Materials - Property of IBM
005    * Restricted Materials of IBM
006    * 
007    * com.ibm.rational.wvcm.stp.cc.CcLocation
008    *
009    * (C) Copyright IBM Corporation 2004, 2011.  All Rights Reserved. 
010    * Note to U.S. Government Users Restricted Rights:  Use, duplication or  
011    * disclosure restricted by GSA ADP  Schedule Contract with IBM Corp. 
012    */
013    
014    package com.ibm.rational.wvcm.stp.cc;
015    
016    import com.ibm.rational.wvcm.stp.StpLocation;
017    
018    /**
019     * <p>
020     * The location of a ClearCase resource.  Note that the WVCM term "location"
021     * is synonymous with the ClearCase term "selector" in this context.
022     * The ClearCase CM API accepts most standard ClearCase selector formats, i.e.,
023     * those accepted by the "cleartool" command line utility. For example, the
024     * following are all valid selectors for a ClearCase UCM activity:
025     * <bl>
026     * <li>activity:CCM16900@\projects ("user-friendly" format)
027     * <li>dbid:5083219@\projects (by database id)
028     * <li>oid:79e75671a6894a05bef3740180434922@\projects (by universal object id)
029     * </bl>
030     * </p>
031     * <p>
032     * <p>
033     * The ClearCase CM API supports the following selector formats for
034     * view-resident resources - ClearCase files, directories, etc.
035     * <bl>
036     * <li>File system path, e.g., "/view/MyView/vobs/applets/Xmakefile"
037     * <li>Workspace path (view tag form), e.g., "workspace:MyView/vobs/applets/Xmakefile"
038     * <li>Workspace path (view uuid form), e.g., "workspace:53c77da1679c46ad913329b0625b8a30/vobs/applets/Xmakefile"
039     * </bl>
040     * </p>
041     * ClearCase resource selectors must be fully-qualified. Paths must be absolute,
042     * not relative. Metadata selectors must include the VOB in which the object
043     * resides, etc.
044     * </p>
045     * <p>
046     * Note that the {@link com.ibm.rational.wvcm.stp.StpLocation StpLocation} interface
047     * describes a number of selector formats and properties that are specific to
048     * the CQ CM API and are not part of the standard ClearCase selector format.
049     * These StpLocation extensions are not supported by the CC CM API. 
050     * </p>
051     */
052    public interface CcLocation extends StpLocation {
053    }