Borland® StarTeam® 2006 - Borland Technical Publications

Das Dienstprogramm "Bulk Check-out" für eine große Anzahl von
Dateien
Mit dem BCO-Dienstprogramm ("Bulk Check-out"), das mit dem Cross-Platform Client ausgeführt werden kann,
können Sie schnell eine große Menge an Dateien aus einem Anwendungs-Repository in Ihre Arbeitsordner
auschecken.
Dieses Thema enthält folgende Informationen:
♦ Schlüsselworterweiterung und BCO
♦ Tipps und Empfehlungen für BCO
Schlüsselworterweiterung und BCO
Ab StarTeam 2005 Release 2 (Patch 2) unterstützt das Dienstprogramm "Bulk Check-out" (BCO) die
Schlüsselworterweiterung mit Auscheckvorgängen, die von einem Cache-Agenten aus ausgeführt werden. In
früheren Versionen hat BCO die Schlüsselworterweiterung nur für Auscheckvorgänge von Nicht-Cache-Agenten
ausgeführt. Die Schlüsselworterweiterung wird nur für nicht binäre Dateien ausgeführt, die der
Schlüsselworterweiterungsliste im Projekt entsprechen.
Während Auscheckvorgängen von Cache-Agenten ruft das BCO alle Dateien vom Cache-Agenten ab, die es
abrufen kann. Wenn es jedoch ein Schlüsselwort wie $Log$, ($Log$, $Log[x]$, $LogUTC$ oder $LogUTC[x]
$) findet, gibt es eine Warnung für diese Datei aus und erweitert das Schlüsselwort nicht. Diese Dateien werden
anschließend vom Server abgerufen.
BCO unterstützt das Schlüsselwort $History$ sowohl für Auscheckvorgänge des Cache-Agenten als auch für
Auscheckvorgänge, die nicht über den Cache-Agenten abgewickelt werden. Da BCO die Schlüsselworterweiterung
mit dem Schlüsselwort $History$ für Cache-Agent-basierte Auscheckvorgänge unterstützt, empfiehlt Borland,
das Schlüsselwort $History$ dem Schlüsselwort $Log$ und seinen Varianten vorzuziehen.
Tipps und Empfehlungen für die Verwendung von BCO
Für die Arbeit mit BCO gibt es folgende Tipps und Empfehlungen:
♦ Dieses Dienstprogramm ist hilfreich, wenn Sie Dateien für ein Build auschecken müssen, da es schneller ist
als stcmd co, das Standard-Befehlszeilenprogramm zum Auschecken. Dies trifft besonders dann zu, wenn
BCO mit dem Cache-Agenten kombiniert wird.
♦ Sie können unter Verwendung der Option -cwf Arbeitsordner mit BCO erstellen, auch wenn Sie keine Dateien
auschecken.
♦ Die meisten Build-Prozesse führen ein Auschecken von einem Ansichts-Label oder einem
Heraufstufungsstatus aus durch (unter Verwendung von -cfgl und -cfgp). Wenn Sie aktuelle Revisionen
auschecken, müssen Sie beachten, dass Benutzer möglicherweise die Dateien einchecken, die Sie
auschecken, was zu einem inkonsistenten Snapshot führen kann. Wenn Sie einen konsistenten Snapshot
benötigen, müssen Sie auf andere Verfahrensweisen zurückgreifen. Sie können beispielsweise den Server
mit dem Befehl stcmd server-mode exklusiv sperren oder die anderen Benutzer bitten, bis auf weiteres
keine Dateien einzuchecken.
♦ BCO erkennt keine Unterschiede in Ordnernamen, die sich nur in der Groß-/Kleinschreibung unterscheiden.
Es erkennt diese Unterschiede jedoch bei Dateinamen.
♦ BCO gibt dieselben Fehlercodes wie das StarTeam Befehlszeilendienstprogramm (stcmd) zurück. Der Wert
0 wird für einen erfolgreichen Vorgang, 1 für einen Verbindungsfehler oder andere kritische Fehler, 101 bei
242