Práce v příkazovém řádku

Komponenta Řízení zdrojů produktu Rational Team Concert obsahuje rozhraní příkazového řádku, které poskytuje tvárný a sktriptovatelný přístup k nezbytným operacím Řízení zdrojů produktu Rational Team Concert z libovolného příkazového shellu.
Nástroje příkazového řádku Řízení zdrojů produktu Rational Team Concert jsou nainstalované ve složce instalační_adresář_Jazz/scmtools/eclipse, kde instalační_adresář_Jazz je složka, ve které je nainstalován Rational Team Concert (například, C:\Program Files\IBM\TeamConcert v systému Windows®). Chcete-li tyto nástroje používat z příkazového shellu v systému Windows, UNIX® nebo Linux®, nastavte vaši proměnnou prostředí PATH tak, aby obsahovala tento adresář.
Poznámka: V některých počítačích se systémem UNIX nebo Linux musíte přidat běhové prostředí Eclipse Java™ do proměnné prostředí LD_LIBRARY_PATH systému. Spusťte příkazový řádek ve tvaru:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:instalační_adresář_Jazz/jdk/jre/bin

než začnete používat podpříkazy scm, nebo tento příkaz vložte do spouštěcího skriptu shellu.
Poznámka: Pro lepší výkon můžete spustit příkazový řádek pomocí lscm.bat nebo lscm. Tato odlehčená verze příkazového řádku vytvoří ve vašem počítači proces démon, který zkrátí dobu spouštění a zlepší dobu provádění u většiny příkazů. Možná budete muset nahradit proměnnou JAVA v těchto skriptech, aby ukazovala na javu, která běží ve vašem počítači.
Poznámka k licencím: Chcete-li provést zde uvedenou úlohu, musíte mít přiřazenu Licenci pro klientský přístup na úrovni Vývojář. Při spuštění Rational Team Concert 2.0.0.1 přispěvatelé mohou také implementovat a spravovat šablony sestav a vytvořit své vlastní sestavy z těchto šablon.

Syntaxe příkazu

Referenční stránka každého podpříkazu scm poskytuje s pomocí následujících konvencí stručný přehled syntaxe příkazu. Volby, které mají alternativní formy, jsou odděleny hranatými závorkami. Například:

-P  |  --password ] 

označuje, že pro tuto volbu můžete zadat -P nebo --password. Nepovinné volby jsou odděleny složenými závorkami. Například:

scm load pracovní prostor -r  |  --repository-uri ] identifikátor URI nebo přezdívka úložiště
 -d  |  --dir ] cesta-k-pracovnímu-prostoru { -q  |  --quiet ] -f  |  --force ]  -c  |  --component ] název ... } komponenta...

označuje, že pro podpříkaz scm load musí být zadaná alespoň jedna komponenta a že je povolený seznam komponent, volby -d, -f, a -c jsou nepovinné a je povolená pouze jedna z voleb -v nebo -q.
Příkazy mají obecný tvar:

scm {volby} {podpříkaz {podpříkaz volby}}

Použití uvozovek a jiné konvence týkající se shellu

Když argumenty voleb podpříkazu scm obsahují mezery, je nutno je uzavřít do uvozovek. V shellu jsou povolené zástupné znaky, kde je to vhodné (například určení souborů k vrácení).

Vytvoření a uložení přihlašovacích pověření

I když má mnoho podpříkazů scm volby podporující jednorázové připojení k úložišti, obecně je pohodlnější uložit pomocí příkazu scm login identifikátor URI úložiště a pověření. Uložené hodnoty poté mohou používat jiné příkazy scm. Pověření uložená tímto způsobem je obtížné, ale nikoli nemožné, zjistit. Uložená pověření můžete odebrat příkazem scm logout.

Lokální pracovní prostory a podpříkazy scm

Příkazy scm load a scm share vytvářejí lokální pracovní prostor, který používají nástroje příkazového řádku Řízení zdrojů produktu Rational Team Concert. Nástroje příkazového řádku Řízení zdrojů produktu Rational Team Concert můžete spustit v lokálním pracovním prostoru nebo jej zadat pomocí volby -d, kterou mají všechny podpříkazy scm vyžadující kontext lokálního pracovního prostoru. Pokud podpříkaz spustíte v lokálním pracovním prostoru, nemusíte -d zadávat.

Tyto podpříkazy neumožňují zadat identifikátor URI úložiště v příkazovém řádku. Místo toho jej odvozují z metadat přidružených k lokálnímu pracovnímu prostoru, ve kterém příkaz spustíte (nebo který jste zadali volbou -d). Pokud jste pro uložení pověření pro toto úložiště použili scm login, podpříkaz nevyzve k jejich zadání.

Nástroje příkazového řádku Řízení zdrojů produktu Rational Team Concert nepoužívejte k práci v pracovním prostoru Eclipse.

O klíčích UUID a aliasech

Mnoho podpříkazů scm přebírá argument, který odkazuje na objekt úložiště. Tyto odkazy mohou mít formu názvu (například název pracovního prostoru), UUID (jedinečný identifikátor přiřazený každému objektu úložiště) nebo aliasu. Aliasy jsou krátké řetězce číslic, pomocí kterých se můžete odkazovat na objekty úložiště vždy, když podpříkaz scm takové odkazy přijímá. Příkaz scm automaticky vytváří tyto aliasy při každém spuštění podpříkazu, který vrací název nebo UUID objektu úložiště. Chcete-li alias použít, musíte ho zadat celý (nejsou to celá čísla, takže musíte zadat také úvodní nuly, pokud jsou přítomné). Aliasy jsou jedinečné v pracovním prostoru. Nemůžete je sdílet s ostatními členy týmu. Nemůžete vytvářet jejich seznamy. Nepřetrvávají dlouhá časová období (po vyčerpání nepoužitých aliasů je možno každý alias znovu použít jako odkaz na jiný objekt).

Zadáním voleb -a a -u v příkazovém řádku scm můžete určit, zda se zobrazují aliasy, klíče UUID nebo obojí. (Hodnotay způsobí zobrazení aliasů nebo klíčů UUID. Hodnota n způsobí jejich potlačení.

Můžete také zobrazit/skrýt aliasy a UUID předáním -a yes/no a -u yes/no do scm. Například scm -a y -u y list ws ... zobrazí alias/UUID všech pracovních prostorů. Záměna za -a n zobrazí pouze UUID a -a n -y n nezobrazí ani ty.

Příklady uvedené na referenčních stránkách podpříkazů scm zobrazují a používají aliasy, kde je to vhodné.

Příznaky Stavu

Několik podpříkazů scm zobrazuje stav souborů a složek pomocí znaků, které uvádí Tabulka 1.
Tabulka 1. Příznaky stavu SCM
Příznak Stav
@ Sada změn je aktivní
! Příchozí prostředek je v konfliktu s verzí prostředku v pracovním prostoru
# Příchozí prostředek má potenciální konflikt s prostředkem v pracovním prostoru
$ Sada změn je zavřená
a Prostředek byl přidán
c Obsah nebo vlastnosti souboru byly upraveny, nebo se změnily vlastnosti adresáře.
d Prostředek byl odstraněn
m Prostředek byl přejmenován nebo přesunut
Příznaky stavu se kombinují, kde je to možné. Například:

C:\local-workspaces\HelloJazz> scm history .
(1009:) #@ nobody 32424 "degauss the flux capacitor" - "most recent changes"

označuje, že sada změn s aliasem 1009 je aktivní (@) a má potenciální konflikt (#).

Váš názor

Byla tato pomoc užitečná? Zpětnou vazbu můžete poskytnout na stránkách Jazz.net (registrace je požadována): Komentář na fóru nebo odeslat chybu