使用寄存器

寄存器是步骤可用于存储持久数据的常规用途缓冲区。普通的寄存器可以有单字母名称或以字母开始的多字符名称。

底层数据库的区分大小写确定在创建寄存器名称时可使用的大小写。

可以将寄存器变量加入通知模板;引用通知模板中的寄存器时,请使用 ${X} 符号括起来的格式。引用空寄存器将返回空字符串。

使用 .push 和 .pop 点命令可将信息存储在寄存器中并从中检索信息。另请参阅 .poptag 命令(.poptag),该命令使当前作业标记等同寄存器的内容。

注: 不能在命令中将寄存器用作变量。必须首先将寄存器的值出栈到文件,才能使用寄存器。

表 1. 专用寄存器

寄存器

包含

!

包含与“失败”过滤器模式匹配的命令输出行。

注: 该寄存器仅在应用过滤器的步骤的作用域中可见。在 Rational Build Forge 完成过滤器步骤的处理后,此步骤过滤器可能设置的寄存器的内容将不再可见。

@

包含与“通过”过滤器模式匹配的命令输出行。

注: 该寄存器仅在应用过滤器的步骤的作用域中可见。在 Rational Build Forge 完成过滤器步骤的处理后,此步骤过滤器可能设置的寄存器的内容将不再可见。

=

指定作业的说明数据库。允许步骤将来自文件的数据作为说明添加到作业。此寄存器不同于其他寄存器:

  • 只能写入(推送到)此寄存器,不能从中读取。
  • 推送到此寄存器的数据始终附加到该寄存器,而不是覆盖前面的数据。
  • 系统为时间戳记和用户标识提供附加的数据。这样可以保留作业说明的审计跟踪。

反馈