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
014package com.ibm.rational.wvcm.stp.cc;
015
016import 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 */
052public interface CcLocation extends StpLocation {
053}