Borland® StarTeam® 2006 - Borland Technical Publications
Borland® StarTeam® 2006 - Borland Technical Publications Borland® StarTeam® 2006 - Borland Technical Publications
Ü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
- Seite 1481 und 1482: -help -is -netmon Wendet den Befehl
- Seite 1483 und 1484: -useCA -vb Versucht, Dateien unter
- Seite 1485 und 1486: starteamserver-Befehlsparameter In
- Seite 1487 und 1488: -eval Zahl Siehe auch: -serial, -ac
- Seite 1489 und 1490: -r "Repository_Pfad" Verwendung mit
- Seite 1491 und 1492: ♦ Im Register Datenbank des Dialo
- Seite 1493 und 1494: Befehlszeilenoptionen für das Chec
- Seite 1495 und 1496: Vault Verify - Befehlszeilenoptione
- Seite 1497 und 1498: Befehlszeilenoptionen für Report A
- Seite 1499 und 1500: Weitere Client-Befehlszeilenoperati
- Seite 1501 und 1502: Allgemeine Optionen Einige der im F
- Seite 1503 und 1504: Mit oder ohne Verwendung des Befehl
- Seite 1505 und 1506: Mithilfe dieser Option können Sie
- Seite 1507 und 1508: Sonderzeichen * entspricht einem be
- Seite 1509 und 1510: Dateien hinzufügen: stcmd add Verw
- Seite 1511 und 1512: stcmd add p "JMarsch:Passwort@Orion
- Seite 1513 und 1514: Ansichten hinzufügen: stcmd add-vi
- Seite 1515 und 1516: Labels übernehmen: stcmd apply-lab
- Seite 1517 und 1518: Dateien auschecken: stcmd co Verwen
- Seite 1519 und 1520: Dateirevisionen vergleichen: stcmd
- Seite 1521 und 1522: Labels erstellen: stcmd label Verwe
- Seite 1523 und 1524: Lokale Dateien löschen: stcmd dele
- Seite 1525 und 1526: Dateien auflisten: stcmd list Verwe
- Seite 1527 und 1528: Server sperren und entsperren: stcm
- Seite 1529 und 1530: Persönliche Optionen anpassen: stc
- Seite 1531: VCM-Befehlszeilenprogramm Das View
- Seite 1535 und 1536: 2 Teilweise erfolgreich. Dieses Erg
- Seite 1537 und 1538: auflösen und anschließend die Sit
- Seite 1539 und 1540: UseCA UseCA {: | AutoLocate} Gibt a
- Seite 1541 und 1542: Eigenschaften erfolgreich, wird das
- Seite 1543 und 1544: DefaultComment DefaultComment Der
- Seite 1545 und 1546: Bei allen Include- und Exclude-Opti
- Seite 1547 und 1548: ReportDiffs ReportDiffs [True | Fal
- Seite 1549 und 1550: Verwandte Referenz Übersicht über
- Seite 1551 und 1552: Beispiele für das VCM-Dienstprogra
- Seite 1553 und 1554: VCMUtility - Befehlsreferenz VCM-Di
- Seite 1555 und 1556: [] {ChangeRequest | CR | ChangeRe
- Seite 1557 und 1558: Syntax der zusammengesetzten Option
- Seite 1559 und 1560: {CR | CRs | ChangeRequests} * Gibt
- Seite 1561 und 1562: Verwandte Referenz Syntax der zusam
- Seite 1563 und 1564: Verwandte Referenz Syntax der zusam
- Seite 1565 und 1566: * Definiert Bedingungen für die El
- Seite 1567 und 1568: ProcessItems *{[View ] CR | [View
- Seite 1569 und 1570: RevLabels *{} Gibt alle Elemente an
- Seite 1571 und 1572: Ein muss einen der in Java gebräu
- Seite 1573 und 1574: Vergleichen/Zusammenführen Dieser
- Seite 1575 und 1576: Aktionen für das Vergleichen und Z
- Seite 1577 und 1578: Unterschiede getrennt anzeigen Änd
- Seite 1579 und 1580: Tastaturkürzel für das Vergleiche
- Seite 1581 und 1582: Optionen für das Vergleichen und Z
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