EmailRelay <CQDatabase> XML 块

EmailRelay <CQDatbase> XML 块包含 EmailRelay 邮局方式用来与 IBM® Rational® ClearQuest® Web 服务器建立通信的属性。轮询 ClearQuest 数据库以找到新的 EmailPlus 电子邮件记录时需要此通信。
如果您为多个 ClearQuest 用户数据库配置 EmailRelay 应用程序,那么针对每个用户数据库将存在单独的 <repository> 部分。
注: 当您在邮局中继方式下配置 EmailRelay 应用程序时,会忽略 <repository> 部分。
此示例显示如何使用 ClearQuest Web 服务器参数:
<CQDatabase>
  <repository connection_timeout="30000" dbname="SAMPL" dbset="EmailPlus" is_enabled="yes" keyfile="" password="" payloaddumpdir="C:\EmailRelay" retries="3" socket_timeout="30000" url="http://your.cqweb.com/cqweb/oslc/" username="admin"/>
</CQDatabase>
表 1. <repository> XML 块属性
属性名称 描述
connection_timeout 包含一个整数,用于指定 EmailRelay 在放弃对 ClearQuest Web 服务器的连接请求之前将等待多长时间(以毫秒计)。缺省值为 30000,即 30 秒。如果大量利用 ClearQuest Web 服务器并且 EmailRelay 报告连接超时,请增大此值。请记住,这将使发送电子邮件所花费的时间更长。
注: 为获得最佳效果,connection_timeoutsocket_timeout 应设置为相同的值。
dbname 包含 ClearQuest 用户数据库名称。您无法更改此属性的值。该值基于传递给 -userdb 参数的参数自动生成。
dbset 包含 ClearQuest 主数据库名称。您无法更改此属性的值。该值基于传递给 -dbset 参数的参数自动生成。
is_enabled 包含值 yesno。缺省值为 yes。您可以临时更改此属性的值,以针对此 ClearQuest 存储库禁用发送电子邮件功能。例如,您可以在进行批处理更新时禁用发送电子邮件通知。
keyfile 包含密钥文件名,其中具有解密 password 属性中所存储用户密码的密钥。无需更改此属性的值。该值基于 -relaycfgdir 参数的值为您自动生成。
要点: 如果您更改此属性的值(例如,文件名或目录路径),那么还必须对物理密钥文件进行相同的更改。
password 包含 ClearQuest 用户的加密密码。
注: 您无法更改此属性的值。该值基于传递给 -password 参数的参数自动生成。
payloadddumpdir 包含转储有效内容的目录。有效内容是正在从 EmailPlus 程序包接收的电子邮件数据。此属性的值基于 -dumppayload 属性的值。您可以更改此属性的值以指定不同的位置。
注: 此属性是可选属性。仅当使用 -dumppayload 属性时才生成此属性。此属性仅用来调试 EmailRelay 应用程序问题。
retries 包含大于 -1 的整数。此值表示连接尝试失败时重新尝试与 ClearQuest Web 服务器通信的尝试次数。缺省值为 3。您可以更改此属性的值。如果 EmailRelay 应用程序与 ClearQuest Web 服务器之间存在通信问题,请增大此属性的值。
socket_timeout 包含一个整数,用于指定 EmailRelay 在放弃对 ClearQuest Web 服务器的套接字连接请求之前将等待多长时间(以毫秒计)。缺省值为 30000,即 30 秒。如果大量利用网络环境和 ClearQuest Web 服务器并且 EmailRelay 报告连接超时,请增大此值。请记住,这将使发送电子邮件所花费的时间更长。
注: 为获得最佳效果,connection_timeoutsocket_timeout 应设置为相同的值。
url 包含 EmailRelay 服务器用来轮询 ClearQueset 数据库以找到新的 EmailPlus 电子邮件记录的 URL。此属性值基于 -servername 属性的值自动生成。您可以更改此属性的值。例如,在您的 ClearQuest Web 服务器位置已更改,并且您希望在无需运行 cqemailrelay.pl 脚本的情况下将该更改反映在此 XML 块中时,您可能会更改该值。
username 包含 ClearQuest 在 EmailRelay 应用程序连接至 ClearQuest Web 服务器时所使用的名称。此属性的值基于传递给 -password 属性的参数自动生成。

反馈