配置 Rational 构建代理程序 Shell 脚本

Jazz™ 构建系统包含样本脚本 startbfa.sh,此脚本可用于启动 Rational® 构建代理程序。

您可以在 @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa 目录中找到样本脚本,其中 @pathPrefix@ 是您安装 SMP/E 时指定的任何前缀。启动 Rational 构建代理程序时,需要使用此脚本来指定凭证,以便此代理程序能够连接至 Jazz Team Server 并且使您能够访问“带有企业扩展的 Ant”和本机编译所需的库。此脚本由 BLZCPBTK 作业复制到 Rational Team Concert 配置目录(通常是 /etc/jazz40/ccm)。
要点: 必须对此脚本进行配置,以使其适合于您的环境。许多必需变量已由 BLZCPBTK 复制和配置作业配置完毕。但是,某些变量(例如用户标识和密码信息)不会自动进行设置。请检查样本脚本中的必需变量字符串并按下表中的描述对其进行替换:
表 1. 样本脚本变量字符串
变量 描述
@pathPrefix@ 作为 Jazz 目录前缀的目录路径
注: 这是 Jazz 目录的前缀,所以前缀应包括您在 SMP/E 安装过程中指定的任何前缀,后跟 /usr/lpp。
@javaPathPrefix@ 31 位 IBM® SDK for z/OS® Java 2 Technology 的目录路径。
@yourUserid@ Jazz 用户标识。
@yourPasswordFile@ 这是 BLZBPASS 作业所定义的 Jazz 密码文件。请参阅在 z/OS 上运行 Jazz Build Engine 以了解有关如何运行 BLZBPASS 作业的信息。
@stepLib@ 要在 z/OS 构建中使用的 STEPLIB DD(数据集定义)。例如,SYS1.LINKLIB:CEE.SCEERUN
@bfaBinPath@ Rational 构建代理程序可执行文件目录的目录路径。
@bfaConfPath@ Rational 构建代理程序配置文件目录的目录路径。
@zLang@ hosts 文件中使用的编码。例如,IBM-037。
@timeout@ 构建步骤执行超时值,以秒计。如果未指定,那么缺省值是 300 秒。
@workPath@ PDSE 的元数据的存储目录路径。缺省情况下,这是 /u/jazz40/ccm/。
@yourHomeDirectory@ 您的主目录。仅当未在其他任何位置定义 HOME 环境变量时,才应使用此变量。
_CMDSERV_BASE_HOME 指示由 ISPF 提供的文件所在的位置,以便 Rational 构建代理程序可以启动 ISPF 网关。请参阅配置 ISPF 网关以支持构建、部署和提升以了解有关 _CMDSERV_BASE_HOME 的更多信息。
在准备好启动 Rational 构建代理程序并接受构建请求时,可以通过下列其中一种方法来运行 startbfa.sh 脚本:
  • 以手动方式从 OMVS 中启动 startbfa.sh 脚本
  • 通过按照作业中的指示信息执行操作,配置 BLZ.SBLZSAMP 库中提供的样本启动式任务 BLZBFA。这样,就可以在系统启动时将 Build Forge 代理程序作为启动式任务运行。您必须将此作业复制到系统分配的 PROCLIB 并设置必需的安全性设置才能使其作为启动式作业运行。
注: 在 z/OS 上,除非 bfagent.conf 文件中指定了其他 Shell,否则 Rational 构建代理程序所启动的会话中将使用缺省 Shell (/bin/sh)。在 startbfa.sh 运行后,z/OS 上的缺省 Shell 始终运行 /etc/profile 脚本来设置系统范围的配置,并且可以覆盖在 Shell 脚本 startbfa.sh 中设置的某些环境变量。

在 Ant 参数中指定了 -verbose 或 -debug 选项的情况下运行“具有企业扩展的 Ant”构建或依赖关系构建时,UNIX 命令 export 将在调用 Ant 之前运行。您可以在构建日志中查看 export 命令的输出以确保环境变量设置正确。

如果某些环境变量被 /etc/profile 覆盖,请要求系统程序员更改 /etc/profile。如果无法更改 /etc/profile,那么您可以使用基本 Shell,基本 Shell 在 z/OS Ported Tools 中提供。通过向 bfagent.conf 文件添加以下两行来指定 –noprofile 选项:
shell /bin/bash   
shellflag --noprofile 

反馈