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] 1612
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 1613
- 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
- Seite 1583 und 1584: Verwandte Konzepte Übersicht über
- Seite 1585 und 1586: Zeilentrennzeichen beim Speichern
- Seite 1587 und 1588: Unterschieds-Links zwischen ausgew
- Seite 1589 und 1590: Verwandte Konzepte Übersicht über
- Seite 1591 und 1592: Bericht generieren (klicken Sie in
- Seite 1593 und 1594: Aktionsentscheidungen für das Verg
- Seite 1595 und 1596: Definitionen von Aktionen In der fo
- Seite 1597 und 1598: Hinweis: Da "Basis neu bestimmen" u
- Seite 1599 und 1600: Hinweis: Bei nicht verzweigbaren El
- Seite 1601 und 1602: ♦ Die Datei wurde in der Quelle v
- Seite 1603 und 1604: Experte zum Vergleichen und Zusamme
- Seite 1605 und 1606: Experte zum Vergleichen und Zusamme
- Seite 1607 und 1608: Experte zum Vergleichen und Zusamme
- Seite 1609 und 1610: Ziel mit Unterschieden sperren Mit
- Seite 1611: VCM-Befehlszeilenprogramm Das View
- Seite 1615 und 1616: 2 Teilweise erfolgreich. Dieses Erg
- Seite 1617 und 1618: auflösen und anschließend die Sit
- Seite 1619 und 1620: UseCA UseCA {: | AutoLocate} Gibt a
- Seite 1621 und 1622: Eigenschaften erfolgreich, wird das
- Seite 1623 und 1624: DefaultComment DefaultComment Der
- Seite 1625 und 1626: Bei allen Include- und Exclude-Opti
- Seite 1627 und 1628: ReportDiffs ReportDiffs [True | Fal
- Seite 1629 und 1630: Verwandte Referenz Übersicht über
- Seite 1631 und 1632: Beispiele für das VCM-Dienstprogra
- Seite 1633 und 1634: VCMUtility - Befehlsreferenz VCM-Di
- Seite 1635 und 1636: [] {ChangeRequest | CR | ChangeRe
- Seite 1637 und 1638: Syntax der zusammengesetzten Option
- Seite 1639 und 1640: {CR | CRs | ChangeRequests} * Gibt
- Seite 1641 und 1642: Verwandte Referenz Syntax der zusam
- Seite 1643 und 1644: Verwandte Referenz Syntax der zusam
- Seite 1645 und 1646: * Definiert Bedingungen für die El
- Seite 1647 und 1648: ProcessItems *{[View ] CR | [View
- Seite 1649 und 1650: RevLabels *{} Gibt alle Elemente an
- Seite 1651 und 1652: Ein muss einen der in Java gebräu
- Seite 1653 und 1654: Filter für Sitzungen zum Vergleich
- Seite 1655 und 1656: Terminologie für das Vergleichen/Z
- Seite 1657 und 1658: Ignorieren Zusammenführen View Com
- Seite 1659 und 1660: Quellansicht Zieltypen Zielansicht
- Seite 1661 und 1662: Referenz zum Anpassen von E-Mail-Na
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 />
1613