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 }