缺省设置选项
有若干个缺省选项可用。
以下主题定义了这些设置,描述了如何更改这些设置,并说明了这些设置之间的任何交互。
add_object_task_assoc
设置为
TRUE
时,
add_object_task_assoc
选项会确保添加到项目的现有对象与指定任务或当前任务关联。此选项与“添加对象”过程(从 GUI)或
ccm use
命令(从 CLI)一起使用。
add_used_subcomponents_to_task
当在手动
use
操作上将
add_used_subcomponents_to_task
设置为
TRUE
时,会发生以下结果。如果所使用的对象是子项目或产品,并且所使用对象的发布标识的组件部分不同于使用该对象的父项目,那么新版本将与当前任务关联。如果先前已将另一个版本的子项目或产品与当前任务关联,那么会取消此另一个版本与当前任务的关联。当此设置为
FALSE
时,子项目或产品的手动
use
不会更改与当前任务关联的对象。
admin_user
admin_user
设置的值为 Rational Synergy 管理员用户的名称(例如,
ccm_root
)。
allow_delimiter_in_name
allow_delimiter_in_name
选项用于控制版本定界符在非项目对象的名称中是否为受限字符。设置为
TRUE
时,当前版本定界符对于非项目对象名不再是受限字符。版本定界符对于版本、类型、实例和项目仍为受限字符。
allow_prep
当
allow_prep
设置为
TRUE
时,会将准备子项目视为针对工作项目的更新成员操作中的有效候选项。当该设置为
FALSE
时,准备子项目不是针对工作项目的更新成员操作中的有效候选项。
auto_create_component_tasks
当
auto_create_component_tasks
选项设置为
TRUE
时,将在创建基线时自动创建组件任务。与基线的发布标识关联的发布标识定义上定义的对应属性会覆盖此设置。
baseline_template
如果在创建基线或修改基线操作中显式指定 none,那么
baseline_template
设置会指定要用于基线中的项目和产品的版本模板。基线模板语法在
ccm baseline -create
命令的帮助中进行定义。
baseline_template_date_format
在
baseline_template
中展开日期关键字时,
baseline_template_date_format
设置可指定创建基线时要使用的日期格式。
baseline_template_repl_char
baseline_template_repl_char
选项指定在基线中任何项目或产品的实例化基线模板包含版本字符串中不允许的字符时,所使用的缺省版本字符串替换字符。
check_release
当
check_release
设置为
TRUE
时,对象的发布标识会与对象的关联任务的发布标识进行比较。如果发布标识不匹配,那么会报告一条消息。
ccm.cli.format.date
定义了
ccm.cli.format.date
设置后,会将其用作日期的缺省输出格式。此外,针对数据输入,还会将此设置用作将日期字符串转换为日期值的首次尝试。缺省情况下,将使用依赖于客户机语言环境的设置。
ccm.cli.start.defaultrole
ccm.cli.start.defaultrole
设置用于定义当启动 Rational Synergy CLI 会话但未通过
-r role
选项显式指定任何角色时的缺省角色。
ccm.cli.tools.compare.*
ccm.cli.tools.compare.*
设置用于定义所使用的比较工具命令。
ccm.cli.tools.compare.*.checkstatus
ccm.cli.tools.compare.*.checkstatus
设置用于指定是否必须检查比较工具的退出状态。 如果设置为
true
并且此工具以非零退出状态值退出,那么 Rational Synergy CLI 将报告一条错误消息。
ccm.cli.tools.edit.unix / ccm.cli.tools.edit.windows
此设置用于指定编辑文件、属性或注释时所使用的编辑工具。
ccm.cli.tools.edit.unix.checkstatus / ccm.cli.tools.edit.windows.checkstatus
该设置用于指定是否必须检查编辑工具的退出状态。如果该设置为
true
并且此工具以非零退出状态值退出,那么 Rational Synergy CLI 将报告一条错误消息。
ccm.cli.tools.merge.*
ccm.cli.tools.merge.*
设置用于定义所使用的合并工具命令。
ccm.cli.tools.merge.*.checkstatus
ccm.cli.tools.merge.*.checkstatus
设置用于定义是否必须检查合并工具的退出状态。 如果设置为
true
并且此工具以非零退出状态值退出,那么 Rational Synergy CLI 将报告一条错误消息。
ccm.cli.tools.merge.conflict.content
ccm.cli.tools.merge.conflict.content
设置用于指定一个正则表达式,它在输出合并结果文件中得到匹配时将指示已检测到合并冲突。
ccm.cli.tools.merge.unix.conflict.status / ccm.cli.tools.merge.windows.conflict.status
此设置用于指定合并工具的退出状态值,该值指示合并已成功但检测到一个或多个合并冲突。如果未设置,那么 Rational Synergy CLI 不会检查合并工具的退出状态来确定是否发现了合并冲突。
ccm.cli.tool.shell.unix / ccm.cli.tool.shell.windows
该设置指定是否在操作系统 shell 内合并和执行 Rational Synergy CLI 所执行的工具命令。缺省设置是在 UNIX 客户机上使用
sh -c
合并命令,而在 Windows 客户机上使用
cmd /c
合并命令。该设置允许命令使用 shell 功能,如流重定向和管道。在 Windows 上,如果指定了 shell,那么 Rational Synergy CLI 将为要执行的命令创建一个临时批处理文件,并且将对该临时批处理文件执行此 Windows shell。
ccm.cli.tools.view.unix / ccm.cli.tools.view.windows
此设置用于指定查看文件或只读属性时所使用的查看工具。
ccm.cli.tools.edit.unix.checkstatus / ccm.cli.tools.view.windows.checkstatus
该设置用于指定是否必须检查查看工具的退出状态。如果设置为
true
并且此工具以非零退出状态值退出,那么 Rational Synergy CLI 将报告一条错误消息。
ccm.migrate.default.type
ccm.migrate.default.type
设置用于指定对映射规则求值但无映射规则显式设置类型时所使用的缺省 Rational Synergy 类型。在未指定 Rational Synergy 类型的情况下进行迁移,检测工作区冲突,或创建对象时,将使用此设置。
ccm.migrate.new_project.purpose
ccm.migrate.new_project.purpose
设置用于指定迁移操作生成导入包时用于项目的项目用途。
ccm.migrate.replacement.character
ccm.migrate.replacement.character
设置用于指定当要迁移的对象包含 Rational Synergy 限制字符时所使用的替换字符。
ccm.migrate.source.export
ccm.migrate.source.export
设置用于指定构建迁移操作所生成导入包的临时客户机位置。
%temp
关键字将展开为依赖于客户机平台的位置。
cli_compare_cmd
cli_compare_cmd
设置用于指定比较文件时要使用的命令。如果未设置,那么 Rational Synergy CLI 将使用
ccm.cli.tools.compare.ascii.unix
的首选项值(在 UNIX 客户机上)和
ccm.cli.tools.compare.ascii.windows
的首选项值(在 Windows 客户机上)。
cli_dir_compare_cmd
cli_dir_compare_cmd
设置用于指定比较目录时要使用的命令。如果未设置,那么 RationalSynergy CLI 将使用
ccm.cli.tools.compare.dir.unix
的首选项值(在 UNIX 客户机上)和
ccm.cli.tools.compare.dir.windows
的首选项值(在 Windows 客户机上)。
cli_proj_compare_cmd
cli_proj_compare_cmd
设置用于指定比较项目时要使用的命令。如果未设置,那么 Rational Synergy CLI 将使用
ccm.cli.tools.compare.project.unix
的首选项值(在 UNIX 客户机上)和
ccm.cli.tools.compare.project.windows
的首选项值(在 Windows 客户机上)。
cli_symlink_compare_cmd
cli_symlink_compare_cmd
设置用于指定比较符号链接对象时要使用的命令。如果未设置,那么 Rational Synergy CLI 将使用
ccm.cli.tools.compare.symlink.unix
的首选项值(在 UNIX 客户机上)和
ccm.cli.tools.compare.symlink.windows
的首选项值(在 Windows 客户机上)。
conflict_exclude_rules
conflict_exclude_rules
属性用于控制从成员资格冲突报告中排除成员资格冲突的条件
conflict_parameters
conflict_parameters
设置指定报告的成员资格冲突的类型。属性值由以下格式的行组成:
conflict_number
: TRUE|FALSE
。以井号字符 (#) 开头的行被视为注释。
数据库
该只读设置的值是与当前 CLI 会话关联的 Rational Synergy 数据库路径。
dcm_broadcast_dbid
dcm_broadcast_dbid
设置指定用于表示广播传输包的数据库标识。 设置空字符串将禁止接收广播包。 如果您使用非缺省值,那么还必须创建一个使用该数据库标识的对应 DCM 数据库定义。此外,还请对 DCM 集群中的其他数据库应用相同的更改,以便所有数据库均使用相同的设置。
dcm_log_enabled
当设置为
TRUE
时,
dcm_log_enabled
选项指定在 DCM 接收操作过程中创建并更新
dcm_log
属性。
dcm_log
属性用于记录与 DCM 接收操作更新对象的时间或者与执行控制权移交的时间相关的详细信息。对于Rational 技术支持人员,此设置是一种诊断辅助,以了解 DCM 更新对象的原因、方式和时间。
dcm_time_sync_tolerance
dcm_time_sync_tolerance
设置用于指定在 DCM 生成期间确定要为传输集和传输包所包含的增量时 DCM 允许的时间容差(以秒为单位)。 如果运行 Rational Synergy 服务器和引擎进程的机器具有在指定的容差时间内同步的系统时间,那么 DCM 将复制更新。 但是,如果这些机器中的系统时间超过此时间,那么已修改的对象可能不会包含在传输包中。
dcm_update_recon_temp
dcm_update_recon_temp
设置用于控制 DCM 接收操作进程是否处理规则和文件夹模板。如果您不希望从另一个数据库更新数据库的本地重新配置模板和文件夹模板,那么请将此模型属性设置为值
FALSE
。
deep_conflict_detection
deep_conflict_detection
设置用于指定成员资格冲突检测必须深还是浅。浅检测将不会理会项目中使用的基线版本。 深检测将考虑项目中使用的基线之前的版本。
default_version
default_version
设置用于指定在创建文件或目录的实例时要使用的缺省版本。
error
error
设置的值是已执行的最后一个 CLI 命令的错误状态值。
expand_on_checkin
对类型定义设置为
TRUE
时,
expand_on_checkin
设置会指定:此类型或其子类型的文件(没有二进制内容)将在检入该文件时执行关键字扩展。缺省情况下,基本模型类型定义不会定义此设置,并且整体模型缺省值会指定在检入时不执行关键字扩展。
include_required_tasks
当设置为
TRUE
时,
include_required_tasks
设置会指定当任务添加到项目分组时,还将计算并添加此任务所依赖于的必需任务。
mail_cmd
Rational Synergy 使用缺省邮件工具来进行 DCM 电子邮件通知。要使用自己的邮件程序而不是缺省工具,请在服务器安装文件
ccm.ini
的
[Options]
节输入以下行:
mapping_rules
Rational Synergy 在迁移期间或在检测工作区冲突时使用映射规则来确定是否必须忽略文件和目录。 系统还在迁移期间,在未显式指定类型的情况下创建对象时,或者在通过解决工作区冲突来创建对象时使用映射规则来确定对象的
type
。
max_object_name_length
max_object_name_length
选项限制对象名的长度。
max_object_version_length
max_object_version_length
选项限制对象版本的长度。
multiple_local_proj_instances
设置为
TRUE
时,
multiple_local_proj_instances
设置会指定即使已在本地创建的另一个项目实例具有相同名称,用户仍可以创建项目。新项目会使用不同的实例值。
objreg_address
objreg_address
设置的值是 Rational Synergy 对象注册器(它与用于当前 CLI 会话的数据库关联)的地址。
parallel_exclude_rules
parallel_exclude_rules
选项包含的规则集用于定义从并行通知中排除哪个版本。
平台
platforms
设置的值是对象的有效平台名称的列表。
project_purpose_mgr
project_purpose_mgr
设置包含了可以创建或删除数据库中所定义项目用途的角色的列表。必须使用至少一个空格字符来分隔角色。
project_subdir_template
project_subdir_template
设置用于为工作区路径中特定于项目的部分指定模板。创建或复制项目时会使用此模板。您也可以使用
ccm wa -pst|-project_subdir_template
命令来为指定的项目更改模板。
range_for_keyword_expand
range_for_keyword_expand
选项用于确定在创建或派生对象时,在文件中为查找关键字而从文件开头开始扫描的字符数。
reconcile.control_files_below_new_project
reconcile.control_files_below_new_project
设置指定在同步/协调操作过程中,是否将非受控文件文件添加到从目录派生的新项目中。
reconcile.save_uncontrolled
reconcile.save_uncontrolled
设置指定由于冲突解决而从工作区中移除的非受控文件是否必须保存在工作区废纸篓中。如果将该选项设置为
TRUE
,在数据库解决方法中的更新工作区从工作区中移除文件时,会将非受控文件存储在工作区废纸篓中。
reconf_consider_all_cands
reconf_consider_all_cands
设置可指定在项目的更新属性中找不到任何候选值时,使用最佳匹配项填充目录。如果不存在此属性或值为
FALSE
时,那么在项目的更新属性中没有任何候选值时,该目录项将留空。
reconf_prop_mgr
reconf_prop_mgr
设置用于定义可对更新模板进行创建或编辑的角色。
reconf_stop_on_fail
reconf_stop_on_fail
设置指定在遇到错误时更新成员是否必须停止并放弃进一步的处理。缺省情况下,在遇到错误时,更新成员会报告错误并停止。
release_phase_list
release_phase_list
功能用于定义某个发布标识的开发或部署阶段。使用此功能可在开发过程中跟踪发布标识的状态。您可以定制此列表以与产品的开发阶段匹配,或者使用缺省列表。
require_actual_time
require_actual_time
设置用于指定是否要求用户在将任务指定为完成之前填写完成任务所花费的实际时间。
required_attributes
required_attributes
设置指定是否要求用户先填写特定字段才能将任务指定为完成。如果其中某个必填任务字段缺失或包含无效值,那么该任务不会转换为已完成状态,并会报告错误消息。
restricted_chars
restricted_chars
设置的值是不能在对象名称或版本中使用的限制字符的列表。
restricted_task_admin_roles
restricted_task_admin_roles
设置用于指定哪些角色被限制为不允许管理任务。其值是不允许创建、注册和分配任务的角色的空格分隔列表。缺省情况下,允许所有角色来管理任务。
role
role
设置用于指定当前 Rational Synergy CLI 会话的当前角色。
role_definitions
role_definitions
设置用于指定为具有各种角色的用户提供的特权。
router_address
router_address
设置用于显示 Rational Synergy 路由器(它与用于当前 CLI 会话的数据库关联)的地址。
save_to_wastebasket
save_to_wastebasket
设置用于指定将您工作区中的所有文件移到废纸篓目录。
shared_project_directory_checkin
shared_project_directory_checkin
设置用于控制在共享项目内的非可写目录中添加或删除对象时是否自动将此类目录检入到
integrate
状态。
start_day_of_week
start_day_of_week
设置可指定在计算使用相对时间关键字的查询时所使用的一周开始日期,这些相对时间关键字包括:
%this_week_begin
、
%this_week_end
、
%last_week_begin
和
%last_week_end
。有效条目包括整数 0 到 6,0 表示星期日,1 表示星期一,以此类推。
task_platforms
task_platforms
设置可列出任务的有效平台值。此信息由配置文件
databasePath/pt/attrange.dft
进行定义。
task_priorities
task_priorities
设置可列出有效的任务优先级值。此信息由配置文件 databasePath/pt/attrange.dft 进行定义。
task_release_propagate
如果开启了此功能,并且您使用
ccm task -modify -release
命令或者 GUI 中的“属性”对话框来修改针对任务的发布标识,那么此发布标识中的更改将根据以下规则传播至任务的关联对象。
task_resolvers
task_resolvers
设置可列出任务的有效解析器值。此信息由配置文件
databasePath/pt/attrange.dft
和
databasePath/pt/extusers.dft
进行定义。
task_subsystems
task_subsystems
设置可列出有效的任务子系统值。此信息由配置文件 databasePath/pt/attrange.dft 进行定义。
text_editor
text_editor
设置可指定比较文件时要使用的命令。如果未进行设置,那么 Rational Synergy CLI 在 UNIX 客户机上使用
ccm.cli.tools.edit.unix
的首选项值,在 Windows 客户机上使用
ccm.cli.tools.edit.windows
的首选项值。
update_baseline_on_update
update_baseline_on_update
设置指定在检入后,更新成员是使用新项目的基线,还是使用先前定义的基线。
update_on_checkin_if_equal
update_on_checkin_if_equal
设置用于指定具有优先权的时间戳记。当您使用某些编辑器或者执行脚本化的检出和检入时,文件的数据库和工作区版本上的时间戳记可能会显示为完全相同。 当设置为
TRUE
时,
update_on_checkin_if_equal
选项会强制 Rational Synergy 将工作区中的此类文件复制到数据库(即使这些文件的时间戳记指示它们并不比其数据库版本新)。
update_parallel_check
update_parallel_check
设置用于指定在更新成员时是否提供并行版本通知。此选项的值可以为
TRUE
、
FALSE
或
FULL
(用于获取更详细的通知)。
update_replace_subprojects
update_replace_subprojects
设置可定义在对项目执行更新成员操作时的缺省行为。启用时,更新会评估最佳候选子项目并将子项目的当前版本替换为更好候选者。禁用时,子项目的当前版本不会发生更改。
用户
user
设置可显示与当前 CLI 会话相关联的 Rational Synergy 用户名。
valid_create_roles
valid_create_roles
设置可指定允许检出项目的角色。该值是允许检出项目的角色的列表(由空格分隔)。
wa_template
wa_template
设置用于为工作区路径中非特定于项目的部分指定模板。创建或复制项目时会使用此模板。您也可以使用
ccm wa -set|-path|-setpath
命令来为指定的项目更改工作区路径。
废纸篓
废纸篓
设置可指定废纸篓目录的位置。
work_area_products_writable
work_area_products_writable
设置可指定基于副本的工作区的可写性。将此设置设置为
TRUE
时,即使可修改副本工作区属性已关闭,产品在基于副本的工作区中也始终是可以修改的。缺省值
FALSE
表示基于副本的工作区中的产品可写性取决于对象的可修改副本工作区属性和/或状态。
相关参考
:
缺省设置
反馈