Trabajo con la línea de mandatos para Rational Team Concert for System z

El control de origen de Rational Team Concert for System z incluye una interfaz de línea de mandatos que proporciona acceso flexible y codificable a operaciones de control de origen básicas de Rational Team Concert for System z desde cualquier shell de mandatos. Rational Team Concert for System z ofrece varios mandatos adicionales, además de los disponibles en el producto Rational Team Concert base.

Las herramientas de línea de mandatos del control de origen de Rational Team Concert for System z instaladas en JazzInstallDir/scmtools/eclipse, siendo JazzInstallDir la carpeta en la que se ha instalado Rational Team Concert for System z (por ejemplo, C:\Archivos de programa\IBM\TeamConcert en Windows®). Para utilizar estas herramientas desde una shell de mandatos en Windows, en el sistema UNIX® System, o en Linux®, establezca la variable de entorno PATH para incluir este directorio.
Nota: En algunos hosts que se ejecutan en el sistema UNIX o en Linux, debe añadir también el entorno de tiempo de ejecución Java™ de Eclipse a la variable de entorno LD_LIBRARY_PATH del sistema. Ejecute una línea de mandatos como la siguiente:

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

antes de empezar a utilizar submandatos scm, o incluir el mandato en un script de inicio de shell.
Nota de licencia : Para llevar a cabo la tarea descrita en esta sección, debe tener asignada la Licencia de acceso de cliente de desarrollador descrita en Ediciones y licencias de Rational Team Concert for System z 2.0.

Sintaxis de mandatos

Puede obtener el programa de utilidad de línea de mandatos de control de origen con este mandato: scm. La página de referencia de cada submandato scm proporciona una sinopsis de la sintaxis del mandato mediante las convenciones siguientes. Las opciones que tienen formas alternativas se delimitan con corchetes. Por ejemplo:

-P  |  --password ] 

indica que puede escribir tanto -P como --password para esta opción . Las opciones opcionales se delimitan con llaves. Por ejemplo:

scm load espacio de trabajo -r  |  --repository-uri ] repository URI or nickname
 -d  |  --dir ] workspace-path { -q  |  --quiet ] -f  |  --force ]  -c  |  --component ] nombre ... } componente...

indica que, para el submandato scm load, debe especificarse por lo menos un componente, y se permite una lista de componentes, las opciones -d, -f, y -c son opcionales, y solo se permite una de -v o -q.
Los mandatos toman la forma general:

scm {opciones} {submandato {opciones de submandato}}

Entrecomillado y otras convenciones de shell

Cuando los argumentos las opciones del submandato scm contienen espacios, deben entrecomillarse. Los comodines de shell se permiten donde sean aplicables (al especificar archivos para incorporar, por ejemplo).

Creación y almacenamiento de credenciales de inicio de sesión

Aunque muchos de los submandatos scm tienen opciones que admiten una conexión única a un repositorio, normalmente es más conveniente utilizar el mandato scm login para almacenar credenciales y un URI de repositorio, que después pueden utilizar otros mandatos scm. las credenciales que se almacenan de este modo son difíciles de descubrir. Puede eliminar las credenciales almacenadas con el mandato scm logout.

Espacios de trabajo locales y submandatos scm

Los mandatos scm load y scm share crean un espacio de trabajo local para uso de las herramientas de línea de mandatos de Control de fuente Jazz. Puede ejecutar las herramientas de línea de mandatos de Control de fuente Jazz en un espacio de trabajo local o especificarlo mediante la opción -d, que es común a todos los submandatos scm que necesitan un contexto de espacio de trabajo local. Si ejecuta el submandato en un espacio de trabajo local, no es necesario especificar -d.

Estos submandatos no permiten especificar un URI de repositorio en la línea de mandatos. En su lugar, lo derivan de metadatos asociados al espacio de trabajo local en el que está ejecutando el mandato (o el que ha especificado mediante -d). Si ha utilizado scm login para almacenar credenciales de este repositorio, el submandato no los solicita.

No utilice las herramientas de línea de mandatos de Control de fuente Jazz para trabajar en un espacio de trabajo de Eclipse.

Acerca de los UUID y los alias

Muchos submandatos scm toman un argumento que hace referencia a un objeto de repositorio. Estas referencias pueden tener forma de nombre (como el nombre de un espacio de trabajo), un UUID (un identificador exclusivo asignado a cada objeto de repositorio) o un alias. Los alias son series cortas de dígitos que puede utilizar para hacer referencia a objetos de repositorio siempre que dichas referencias las acepte un submandato scm. El mandato scm crea automáticamente estos alias cuando se ejecuta un submandato que recupera el nombre o el UUID de un objeto de repositorio. Para utilizarlos, debe escribir el alias completo (no son enteros, por lo que debe incluir los ceros iniciales en caso de haberlos). Los alias son exclusivos de un espacio de trabajo. No puede compartirlos con otros miembros del equipo. No puede listarlos. No persisten durante largos periodos de tiempo (todos los alias pueden reutilizarse para hacer referencia a otro objeto una vez que el conjunto de alias sin utilizar se haya agotado).

Puede especificar si se muestran los alias, los UUID o ambos estableciendo las opciones -a y -u en la línea de mandatos de scm. (El valor y hace que los alias o los UUID se muestren. El valor n hace que se supriman.

También puede mostrar/ocultar alias y UUID transfiriendo -a yes/no y -u yes/no a scm. Por ejemplo, scm -a y -u y list ws ... muestra el alias/UUID de todos los espacios de trabajo. La sustitución de -a n muestra solo los UUID y -a n -y n no muestra ninguno.

Los ejemplos que se presentan en las páginas de referencia del submandato scm muestran y utilizan los alias donde corresponde.

Distintivos de estado

Varios submandatos scm muestran el estado de los archivos y carpetas mediante los caracteres que figuran en Tabla 1.
Tabla 1. Distintivos de estado SCM
Distintivo Estado
@ El conjunto de cambios está activo
! Hay un conflicto entre el recurso entrante y la versión del recurso del espacio de trabajo
# Hay un conflicto potencial entre el recurso entrante y el recurso del espacio de trabajo
$ El conjunto de cambios está cerrado
a El recurso se ha añadido
c El contenido o las propiedades de un archivo se han modificado, o las propiedades de un directorio han cambiado.
d El recurso se ha suprimido
m El recurso se ha renombrado o movido
Los distintivos de estado se combinan cuando corresponde. Por ejemplo:

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

indica que el conjunto de cambios con el alias 1009 está activo (@) y tiene un conflicto potencial (#).