Trabalhando na Linha de Comandos

O Controle de Origem do Jazz inclui uma interface de linha de comandos que fornece acesso flexível através de scripts às operações essenciais do Controle de Origem do Jazz a partir de qualquer shell de comandos.

As ferramentas de linha de comandos do Controle de Origem do Jazz são instaladas no JazzInstallDir/scmtools/eclipse, onde JazzInstallDir é a pasta na qual o Rational Team Concert está instalado (por exemplo C:\Arquivos de Programas\IBM\TeamConcert no Windows). Para utilizar essas ferramentas a partir de uma shell de comandos no Windows, o sistema UNIX ou o Linux, configura sua variável de ambiente PATH para incluir este diretório.

Nota: Em alguns hosts executando o sistema UNIX ou o Linux, você também deve incluir o Eclipse JRE (Java Runtime Environment) à variável de ambiente LD_LIBRARY_PATH do sistema. Execute uma linha de comandos com o seguinte formato:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:JazzInstallDir/jdk/jre/bin

antes de começar a utilização de subcomandos scm ou incorporar o comando em um script de inicialização da shell.

Nota de licença: Para executar a tarefa descrita aqui, você deve ser designado com a Licença do Acesso do Cliente ou do Desenvolvedor.

Sintaxe do Comando

A página de referência para cada subcomando scm fornece uma sinopse da sintaxe de comando utilizando as seguintes convenções. As opções que possuem formatos alternativos são delimitadas por colchetes. Por exemplo:

[ -P | --password ]

indica que você pode digitar -P ou --password para esta opção. Opções que são opcionais são delimitadas por chaves. Por exemplo:

scm load espaço de trabalho [ -r |
--repository-uri ] URI do repositório ou apelido
[ -d |
--dir ] workspace-path { [ -q | --quiet ] [ -f | --force ] [ -c |
--component ] name ... } componente...

indica que, para o subcomando scm load, no mínimo um componente deve ser especificado, e uma lista de componentes é permitida, as opções -d -f e -c são opcionais, e somente uma das opções -v ou -q é permitida.

Os comandos assumem o formato geral:

scm {opções} {subcomando {opções do subcomando}}

Colocando Entre Aspas e Outras Convenções da Shell

Quando os argumentos para opções do subcomando scm contêm espaços, eles devem ser colocados entre aspas. Os curingas da shell são permitidos onde aplicável (a especificação de arquivos para efetuar o registro de entrada, por exemplo).

Criando e Armazenando Credenciais de Login

Enquanto muitos dos subcomandos scm possuem opções que suportam uma única conexão com um repositório, geralmente é mais conveniente utilizar o comando scm login para armazenar um URI de repositório e as credenciais, que podem ser então utilizadas por outros comandos scm. As credenciais armazenadas desta maneira são difíceis de serem descobertas, mas não impossíveis. É possível remover credenciais armazenadas com o comando scm logout.

Espaços de Trabalho Locais e Subcomandos scm

Os comandos scm load e scm share criam um espaço de trabalho local para utilização pelas ferramentas de linha de comandos do Controle de Origem do Jazz. É possível executar as ferramentas de linha de comandos do Controle de Origem do Jazz em um espaço de trabalho local ou especificá-las utilizando a opção -d, que é comum a todos os subcomandos scm que necessitam de um contexto de espaço de trabalho local. Se estiver executando o subcomando em um espaço de trabalho local, não é preciso especificar -d.

Esses subcomandos não permitem especificar um URI de repositório na linha de comandos. Em vez disso, eles derivam de metadados associados ao espaço de trabalho local no qual você está executando o comando (ou que você especificou utilizando -d). Se tiver utilizado scm login para armazenar credenciais para este repositório, o subcomando não solicita por eles.

Não utilize as ferramenta de linha de comandos do Controle de Origem do Jazz para trabalhar em um espaço de trabalho do Eclipse.

Sobre UUIDs e Aliases

Diversos subcomandos scm utilizam um argumento que refere-se a um objeto de repositório. Essas referências podem ter o formato de um nome (como o nome de um espaço de trabalho), um UUID (um identificador exclusivo designado a cada objeto de repositório) ou um alias. Os aliases são cadeias curtas de dígitos que podem ser utilizadas para referenciar objetos de repositório sempre que essas referências forem aceitas por um subcomando scm. O comando scm automaticamente cria esses aliases sempre que você executar um subcomando que retorna o nome ou o UUID de um objeto de repositório. Para usá-los, digite o alias inteiro (eles não são inteiros, assim inclua os zeros à esquerda quando estiverem presentes). Os aliases são exclusivos para um espaço de trabalho. É impossível compartilhá-los com outros membros da equipe. É impossível listá-los. Eles não são persistentes ao longo de longos períodos de tempo (qualquer alias pode ser reutilizado para referenciar outro objeto depois do conjunto de aliases não utilizados ter se esgotado).

É possível especificar se os aliases, UUIDs ou ambos são exibidos configurando-se as opções -a e -u na linha de comandos do scm. Um valor y faz com que os aliases ou UUIDs sejam exibidos. Um valor n faz com que eles sejam suprimidos.

Os exemplos apresentados nas páginas de referência do subcomando scm são exibidos e os aliases são utilizados onde for adequado.

Sinalizadores de Status

Diversos subcomandos scm exibem o status de arquivos e pastas utilizando os caracteres mostrados em Tabela 1.

Tabela 1. Sinalizadores de Status do SCM
Sinalizador	Status
@	O conjunto de alterações está ativo
!	O recurso de entrada está em conflito com a versão do recurso no espaço de trabalho
#	O recurso de entrada possui um conflito em potencial com o recurso no espaço de trabalho
$	O conjunto de alterações está fechado
í	O recurso foi incluído
c	O conteúdo ou as propriedades de um arquivo foram modificados, ou as propriedades de um diretório foram alteradas.
d	O recurso foi excluído
r	O recurso foi renomeado ou movido

Os sinalizadores de status são combinados onde for adequado. Por exemplo:

C:\local-workspaces\HelloJazz> scm history .
(1009:) #@ nobody 32424 "degauss do capacitor de fluxo" - "alterações mais recentes"

indica que o conjunto de alterações com alias 1009 está ativo (@) e possui um conflito em potencial (#).