Trabalhando na Linha de Comandos para Rational Team Concert para System z

O controle de origem do Rational Team Concert para System z inclui uma interface de linha de comandos que fornece acesso flexível, de script a operações essenciais do controle de origem do Rational Team Concert para System z a partir de um shell de comando. O Rational Team Concert para System z oferece vários comandos adicionais, além dos disponíveis no produto base Rational Team Concert.

As ferramentas de linha de comandos do controle de origem do Rational Team Concert para System z são instaladas em JazzInstallDir/scmtools/eclipse, em que JazzInstallDir é a pasta na qual o Rational Team Concert para System z está instalado (por exemplo, C:\Program Files\IBM\TeamConcert no Windows®). Para usar estas ferramentas a partir de um shell de comando no Windows, no Sistema UNIX® ou no Linux®, configure a variável de ambiente PATH para incluir este diretório.
Nota: Em alguns hosts que executam UNIX ou Linux, também é necessário incluir o Eclipse Java™ runtime environment na variável de ambiente LD_LIBRARY_PATH do sistema. Execute uma linha de comandos semelhante à seguinte:

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 da Licença: Para executar a tarefa descrita aqui, é necessário possuir a Licença de Acesso do Cliente Desenvolvedor descrita no Edições e Licenças do Rational Team Concert para System z 2.0.

Sintaxe do Comando

O utilitário de linha de comandos do controle de origem pode ser acessado com este comando: scm. 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. 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. 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. Credenciais armazenadas desta maneira são difíceis de serem descobertas. É 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 Jazz. É possível executar as ferramentas de linha de comandos 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 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 durante 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.

Também é possível mostrar/ocultar aliases e UUIDs transmitindo -a yes/no e -u yes/no para scm. Por exemplo, scm -a y -u y list ws ... mostra o alias/UUID de todas as áreas de trabalho. A substituição de -a n mostra apenas UUIDs e de -a n -y n não mostra nada.

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. 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 (#).