Borland® StarTeam® 2006 - Borland Technical Publications

Borland® StarTeam® 2006 - Borland Technical Publications Borland® StarTeam® 2006 - Borland Technical Publications

techpubs.borland.com
von techpubs.borland.com Mehr von diesem Publisher
22.11.2013 Aufrufe

Übersicht über das VCM-Befehlszeilendienstprogramm Das View Compare/Merge-Dienstprogramm (VCMUtility) ist ein Befehlszeilenprogramm, mit dem eine Quellansicht von StarTeam mit einer Zielansicht verglichen werden kann und die Unterschiede optional in der Zielansicht zusammengeführt werden können. VCMUtility besteht aus: ♦ Befehl ♦ VCMUtility-Befehle ♦ VCMUtility-Verbindungsoptionen ♦ VCMUtility-Sitzungsoptionen ♦ VCMUtility - Verschiedene Optionen (werden in Sitzungen nicht gespeichert) Hinweis: In manchen Fällen starten Sie möglicherweise eine Sitzung zum Vergleichen/Zusammenführen von Ansichten über die Befehlszeile und beenden die Sitzung im StarTeam-Client in der Benutzeroberfläche von View Compare/Merge. Sie können beispielsweise das VCM-Dienstprogramm verwenden, um eine VCM-Sitzung zu erstellen, und dabei vielleicht die Option DefaultAction verwenden. Sie dürfen jedoch noch keinen Festschreibevorgang zulassen. Die VCM-Sitzung wird automatisch gespeichert (falls erforderlich können Sie einen anderen Namen wählen). Danach können Sie die View Compare/Merge- Sitzung im StarTeam-Client öffnen, prüfen und Anpassungen vornehmen, und dann die Änderungen festschreiben. Syntaxkonventionen Für die Befehlszeilensyntax werden folgende Konventionen verwendet: Konvention Geschweifte Klammern {} Eckige Klammern [] Spitze Klammern < > Senkrechter Strich | Beschreibung Umschließen erforderliche Syntaxelemente. Umschließen optionale Elemente. Umschließen ein Wort oder einen Ausdruck, der durch einen oder mehrere geeignete Werte ersetzt werden muss.Beispielsweise würde durch einen tatsächlichen Dateinamen oder Pfad ersetzt und durch eine tatsächliche Benutzer-ID. Viele der Wörter oder Ausdrücke in spitzen Klammern können jedoch eine komplexere Syntax haben.Beispielsweise kann durch CR, CRs, ChangeRequest, ChangeRequests, ChangeRequest *4277 usw. ersetzt werden. Wenn Sie nicht sicher sind, was Sie verwenden können, lesen Sie in der VCM Utility-Befehlsreferenz nach; dort ist die vollständige Syntax für Ausdrücke wie angegeben. Trennt alternative Elemente. Voranstellung eines Sternchens * Bedeutet, dass das nachfolgende Element wiederholt werden kann. Hinweis: Bei allen Optionen kann die Groß-/Kleinschreibung ignoriert werden (z. B. ist Server dasselbe wie server). VCMUtility-Befehl VCMUtility [] [Optionen] 1532

Sie können die Optionen in Form einer (als ersten Parameter), in Befehlszeilenargumenten oder in beiden angeben. Befehlszeilenargumente haben Vorrang vor den Optionen in der . In der muss der Optionsname am Anfang einer neuen Zeile stehen und ohne den vorangestellten "-" angegeben werden. VCMUtility-Optionsdatei Sie können die VCMUtility-Optionen in einer Optionsdatei angeben, deren Name der erste Parameter des VCMUtility-Befehls ist. Beispiel: VCMUtility c:\VCMconfig.txt Jede Option muss in der Datei in einer neuen Zeile beginnen. Optionsnamen müssen in Spalte 1 beginnen und es muss mindestens ein Whitespace-Zeichen folgen. Der Wert einer Option kann sich über mehrere Zeilen erstrecken, wenn jede fortlaufende Zeile mit einem Leerzeichen oder einem Tabulatorzeichen beginnt. Leerzeilen werden ignoriert. Kommentare werden durch zwei vorangestellte Schrägstriche (//) gekennzeichnet. Beispiel: // Dies ist ein Kommentar server jsmith:mypw@somehost:49201 type Rebase include "/Cygnus/StarTeam//Server/Common/*.h" +ALL *.cpp *.rc Makefile // langer Wert, der in einer zusätzlichen Zeile fortgesetzt wird // Die Zeile darüber ist leer save my-rebase-session // Wert in separater Zeile Befehlszeilenparameter VCMUtility-Optionen können als Befehlszeilenparameter übergeben werden, indem ein Bindestrich vor den Optionsnamen gesetzt wird. Beispielsweise kann die Option Server wie folgt als Befehlszeilenparameter verwendet werden: -server. Wenn eine Option weitere Werte hat, müssen sie dem Optionsnamen direkt folgen (ohne Bindestrich). Input-Quellen mischen VCMUtility-Optionen können in einer Optionsdatei, mit Befehlszeilenparametern oder durch eine Mischung aus beiden angegeben werden. Häufig verwendete oder "statische" Optionswerte können beispielsweise in der Konfigurationsdatei angegeben werden, während "dynamische" Werte als Befehlszeilenparameter angegeben werden können. Mit einem Befehlszeilenparameter kann dieselbe Option angegeben werden, wie sie in der Konfigurationsdatei definiert wird. Wenn ein Befehlszeilenargument dieselbe Option enthält wie die Optionsdatei, hat der Wert der Befehlszeilenoption Vorrang vor dem Wert der Konfigurationsdateioption. Wenn beispielsweise in der Konfigurationsdatei -Source View1 und in der Befehlszeile -Source View2 angegeben wird, wird View2 als Quellansicht verwendet. Optionswerte und Unicode-Zeichen Die Codierung der Optionswerte, die als Befehlszeilenargumente übergeben werden, wird durch die Umgebung (z. B. die Command-Shell) gesteuert, in der das Programm gestartet wird. Optionen, die an VCMUtility übergeben 1533

Sie können die Optionen in Form einer (als ersten Parameter), in Befehlszeilenargumenten oder<br />

in beiden angeben. Befehlszeilenargumente haben Vorrang vor den Optionen in der . In der<br />

muss der Optionsname am Anfang einer neuen Zeile stehen und ohne den vorangestellten "-"<br />

angegeben werden.<br />

VCMUtility-Optionsdatei<br />

Sie können die VCMUtility-Optionen in einer Optionsdatei angeben, deren Name der erste Parameter des<br />

VCMUtility-Befehls ist.<br />

Beispiel:<br />

VCMUtility c:\VCMconfig.txt<br />

Jede Option muss in der Datei in einer neuen Zeile beginnen. Optionsnamen müssen in Spalte 1 beginnen und es<br />

muss mindestens ein Whitespace-Zeichen folgen. Der Wert einer Option kann sich über mehrere Zeilen erstrecken,<br />

wenn jede fortlaufende Zeile mit einem Leerzeichen oder einem Tabulatorzeichen beginnt. Leerzeilen werden<br />

ignoriert. Kommentare werden durch zwei vorangestellte Schrägstriche (//) gekennzeichnet.<br />

Beispiel:<br />

// Dies ist ein Kommentar<br />

server jsmith:mypw@somehost:49201<br />

type Rebase<br />

include "/Cygnus/StarTeam//Server/Common/*.h" +ALL<br />

*.cpp *.rc Makefile // langer Wert, der in einer zusätzlichen Zeile fortgesetzt<br />

wird<br />

// Die Zeile darüber ist leer<br />

save<br />

my-rebase-session<br />

// Wert in separater Zeile<br />

Befehlszeilenparameter<br />

VCMUtility-Optionen können als Befehlszeilenparameter übergeben werden, indem ein Bindestrich vor den<br />

Optionsnamen gesetzt wird. Beispielsweise kann die Option Server wie folgt als Befehlszeilenparameter verwendet<br />

werden: -server. Wenn eine Option weitere Werte hat, müssen sie dem Optionsnamen direkt folgen (ohne<br />

Bindestrich).<br />

Input-Quellen mischen<br />

VCMUtility-Optionen können in einer Optionsdatei, mit Befehlszeilenparametern oder durch eine Mischung aus<br />

beiden angegeben werden. Häufig verwendete oder "statische" Optionswerte können beispielsweise in der<br />

Konfigurationsdatei angegeben werden, während "dynamische" Werte als Befehlszeilenparameter angegeben<br />

werden können.<br />

Mit einem Befehlszeilenparameter kann dieselbe Option angegeben werden, wie sie in der Konfigurationsdatei<br />

definiert wird. Wenn ein Befehlszeilenargument dieselbe Option enthält wie die Optionsdatei, hat der Wert der<br />

Befehlszeilenoption Vorrang vor dem Wert der Konfigurationsdateioption. Wenn beispielsweise in der<br />

Konfigurationsdatei -Source View1 und in der Befehlszeile -Source View2 angegeben wird, wird View2 als<br />

Quellansicht verwendet.<br />

Optionswerte und Unicode-Zeichen<br />

Die Codierung der Optionswerte, die als Befehlszeilenargumente übergeben werden, wird durch die Umgebung (z.<br />

B. die Command-Shell) gesteuert, in der das Programm gestartet wird. Optionen, die an VCMUtility übergeben<br />

1533

Hurra! Ihre Datei wurde hochgeladen und ist bereit für die Veröffentlichung.

Erfolgreich gespeichert!

Leider ist etwas schief gelaufen!