使用命令行工作

Rational Team Concert™ 源代码控制 提供了命令行界面,这使您能够灵活地从任何命令 shell 中对基本的 Rational Team Concert 源代码控制 操作进行可脚本化访问。
Rational Team Concert 源代码控制 命令行工具安装在 JazzInstallDir/scmtools/eclipse 中,其中 JazzInstallDirRational Team Concert 的安装文件夹(例如 Windows® 上的 C:\Program Files\IBM\TeamConcert)。要从 Windows、UNIX® 系统或 Linux® 上的命令 shell 中使用这些工具,请将 PATH 环境变量设置为包括此目录。
注: 在某些运行 UNIX 系统或 Linux 的主机上,还必须将 Eclipse Java™ 运行时环境添加到系统的 LD_LIBRARY_PATH 环境变量。请先运行具有以下格式的命令行:

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

然后再开始使用 scm 的子命令或者将该命令嵌入到 shell 启动脚本中。
注: 为了提高性能,可以使用 lscm.batlscm 来运行命令行。这个轻量级命令行版本将在机器上创建一个守护进程,这将缩短启动时间以及大多数命令的执行时间。您可能需要替换这些脚本中的 JAVA 变量,以使其指向机器上运行的 java。
许可证说明: 要执行此处所描述的任务,必须为您分配一个开发者客户访问许可证。从 Rational Team Concert 2.0.0.1 开始,添加者还可以部署和管理报告模板以及根据那些模板创建自己的报告。

命令语法

每个 scm 子命令的参考页面都使用下列约定来提供命令语法的大纲。具有备用格式的选项由方括号定界。例如:

-P |  --password

表示可以通过输入 -P--password 来指定此选项。可选的选项由花括号定界。例如:

scm load 工作空间 -r |  --repository-uri]   存储库 URI 或昵称
 -d |  --dir]  工作空间路径 { -q |  --quiet] -f |  --force -c |  --component]  名称... } 组件...

表示对于 scm load 子命令,必须至少指定一个 组件 并允许指定一组 组件-d-f-c 选项是可选的,而且只允许指定 -v-q
命令的一般格式如下:

scm {选项} {子命令 {子命令选项}}

加引号和其他 shell 约定

scm 子命令选项的参数包含空格时,您必须将其括在引号中。在适当时(例如指定要检入的文件时),可以使用 shell 通配符。

创建和存储登录凭证

虽然许多 scm 子命令的选项支持与存储库建立一次性的连接,但使用 scm login 命令来保存存储库 URI 和凭证以供其他 scm 子命令使用通常更为方便。以此方式存储的凭证难以(但并非不可能)被发现。您可以使用 scm logout 命令来除去已存储的凭证。

本地工作空间和 scm 子命令

scm loadscm share 命令将创建本地工作空间以供 Rational Team Concert 源代码控制 命令行工具使用。您可以在本地工作空间中运行 Rational Team Concert 源代码控制 命令行工具,也可以使用 -d 选项来指定此工作空间,这是所有需要本地工作空间上下文的 scm 子命令的公共选项。如果您正在某个本地工作空间中运行子命令,那么不需要指定 -d

这些子命令不允许在命令行中指定存储库 URI。而是,它们根据您运行该命令时所处的本地工作空间(或者您使用 -d 指定的本地工作空间)的相关联元数据来派生该 URI。如果您已使用 scm login 来存储此存储库的凭证,那么该子命令将不会提示您输入凭证。

请不要使用 Rational Team Concert 源代码控制 命令行工具在 Eclipse 工作空间中工作。

关于 UUID 和别名

许多 scm 子命令有一个用于引用存储库对象的参数。这些引用可以接受名称(例如工作空间的名称)、UUID(对每个存储库对象指定的唯一标识)或别名。别名是数字的短字符串,您可以在 scm 子命令接受通过别名引用存储库对象时进行此类引用。每当您运行的子命令返回存储库对象的名称或 UUID 时,scm 命令都将自动创建这些别名。要使用这些别名,必须输入完整的别名(它们不是整数,因此存在前导零时,必须包括这些前导零)。别名对于工作空间而言是唯一的。您无法与其他团队成员共享这些别名。您无法列示别名。别名并不会长时间持久存在(在耗尽全部未使用的别名后,可以重复使用任何别名以引用另一个对象)。

通过在 scm 命令行中设置 -a-u 选项,可以指定是显示别名、UUID 还是同时显示这两者。(值 y 将致使显示别名或 UUID。值 n 将致使不显示别名或 UUID。)

您还可以通过将 -a yes/no-u yes/no 传递给 scm 来显示/隐藏别名和 UUID。例如,scm -a y -u y list ws ... 将显示所有工作空间的别名/UUID。替换为 -a n 将只显示 UUID,-a n -y n 将隐藏别名和 UUID。

scm 子命令参考页面中提供的示例在适当时显示并使用了别名。

状态标志

多个 scm 子命令使用表 1 所示的字符来显示文件和文件夹的状态。
表 1. SCM 状态标志
标志 状态
@ 变更集处于活动状态
! 传入资源与工作空间中的资源版本有冲突
# 在传入资源与工作空间中的资源之间可能存在冲突
$ 变更集已关闭
a 资源已被添加
c 文件的内容或属性已被修改,或者目录的属性已变更。
d 资源已被删除
m 资源已被重命名或移动
在适当时,状态标志将进行组合。例如:

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

表明别名为 1009 的变更集处于活动状态(@)并且包含潜在的冲突(#)。

反馈

本资料对您是否有帮助?您可以在 Jazz.net 上提供反馈(需要注册):在论坛中发表意见或者提交错误