CHGDMSVAL-设置源系统参数

使用此命令可使用命令行来设置发布程序系统参数。

还可以在管理控制台中设置系统参数。建议您在管理控制台中修改系统参数设置。有关使用系统参数的更多信息，请参阅 System parameters for IBM® CDC for Db2® for i

应用于-源

参数

表 1. 支持的关键字
关键词	描述	选择	注意
日志	日记帐名称	`限定对象名`	可选
	限定符 1: 日志名称	*SAME， `名称`
	限定符 2: 库	LIBL， `名称`， CURLIB 和 *SAME
通知Q	消息队列名称	`限定对象名`	可选
	限定符 1: 消息队列名称	*SAME， `名称`
	限定符 2: 库	LIBL， `名称`， CURLIB 和 *SAME
通知计数器	错误计数	*SAME， `编号`	可选
复原	刷新方法	SAME， DELAY ， *IMMED	可选
AUTCDE	授权代码	*SAME， `代码`	可选
更新列	严重列状态	SAME， NO ， *YES	可选
CASCADE	级联复制状态	SAME， NO ， *YES	可选
REFWHLACT	活动时刷新	SAME， NO ， *YES	可选
美国国防部联合参谋部	用户定义的日志项	SAME， NO ， *YES	可选
心动时刻	Heartbeat Timeout	15， `时间`	可选
REPTPOSTIM	报告位置时间	5， `时间`	可选
书签同步	同步时间	60， `时间`	可选
蒙桑普尔克	等待时间度量值更新频率	5， `时间`	可选
启动	初始化进程终止的等待时间	120， `时间`	可选
PROGRESS	进度消息	0， `时间`	可选
LCK超时	锁定超时	30， `时间`	可选
UNICODE_IS	Unicode 列格式	*SAME， CHAR 和 NOCHANGE	可选
AUD滤液	审计过滤器	SAME， NO ， *YES	可选
DBCSRCCSID	DBCS 数据修复的 CCSID	NONE， ALL ， `number`	可选
ENDREPLJRN	结束日志上的结束镜像	NO， YES	可选
AUDTABTRAN	审计表级别条目	YES， NO	可选

日志名 (JOURNAL)

CDC Replication 缺省日志的名称。

缺省情况下，由 CDC Replication 镜像的表使用此日志。

限定符 1: 日志名称

Name: 缺省日志的名称。; 日志所在库的名称必须在日志的名称之前。
*相同: 保留此参数的当前设置。; 这是缺省设置。

限定符 2: 库

Name: 日志库的名称。; 日志所在库的名称必须在日志的名称之前。
*相同: 保留此参数的当前设置。
*LIBL: 指定库列表中的库组。会按顺序对这些库进行搜索，以查找第一个出现的所指定缺省日志。; 这是缺省设置。
*CURLIB: 指定当前库。

消息队列名称 (NOTIFYQ)

当 CDC Replication 检测到的错误数超过通知消息阈值时发送通知的消息队列的名称

限定符 1: 消息队列名称

Name: 消息队列的名称。; 消息队列所在的库的名称必须在消息队列的名称之前。
*相同: 保留此参数的当前设置。; 这是缺省设置。

限定符 2: 库

Name: 消息队列所在库的名称。; 消息队列所在的库的名称必须在消息队列的名称之前。
*相同: 保留此参数的当前设置。
*LIBL: 指定库列表中的库组。会按顺序对这些库进行搜索，以查找第一个出现的所指定消息队列。; 这是缺省设置。
*CURLIB: 指定当前库。

错误计数 (NOTIFYCNT)

在将通知发送到通知消息队列之前， CDC Replication 生成的错误数。

如果指定了小于最小设置的值，那么将使用最小设置。

如果指定了大于最大设置的值，那么将使用最大设置。

成员: 指定错误数。; 最小设置: 1 错误; 最大设置: 99999 个错误

*相同: 保留此参数的当前设置。; 这是缺省设置。

刷新方法 (RESTORE)

指示 CDC Replication 应该如何刷新已复原的表。这包括在启动镜像之前进行刷新。

*相同: 保留此参数的当前设置。; 这是缺省设置。
*IMMED: 指定当 CDC Replication 检测到复原时应立即刷新表。
*DELAY: 指定下次启动刷新时刷新表。

授权代码 (AUTCDE)

IBM发出的授权代码。当从临时许可证移动到永久许可证时，当机器类已更改时，或者当将 CDC Replication 升级到新版本时，需要对授权代码进行调整。

代码: 指定授权代码。
*相同: 保留此参数的当前设置。; 这是缺省设置。

严重列状态 (UPDCOLUMN)

指示是否启用关键列选择。

*相同: 保留此参数的当前设置。; 这是缺省设置。
*是: 启用关键列选择。
* 否: 禁用关键列选择。

级联复制状态 (CASCADE)

指定是否启用级联复制。

*相同: 保留此参数的当前设置。; 这是缺省设置。
*是: 允许将已复制到订户的数据再次从该订户复制到另一订户。
* 否: 阻止将复制的数据从初始订户复制到另一个订户。; 如果在两个服务器之间同时维护一个或多个表，那么应指定 *NO。

活动时刷新 (REFWHLACT)

指定是否启用 "活动时刷新" 功能，此功能允许 CDC Replication 在源表处于活动状态并在刷新期间进行更改时刷新目标表。刷新完成后，在刷新期间发生的源表更改也会发送到目标表。

*相同: 保留此参数的当前设置。; 这是缺省设置。
*是: 指示已启用活动时的刷新。
* 否: 指示已禁用活动时的刷新。

用户定义的日志项 (USDEFJRN)

指示是否应该处理用户定义的日志项以进行复制。此参数允许您禁用可能影响整体性能的用户定义日志项所需的处理。

*相同: 保留此参数的当前设置。; 这是缺省设置。
*是: 指示将处理 CDC Replication 元数据表中指定的用户定义的日志项以进行复制。
* 否: 指示没有为复制处理用户定义的日志项。

脉动信号超时 (HEARTTIME)

指定在停止预订的活动 CDC Replication 作业之前要等待的通信不活动分钟数。

脉动信号是一项功能，用于在指定时间段内通过缺少通信检测到通信问题或进程时管理 CDC Replication 进程。对于每个活动预订，将定期从发布者向订户发送内部脉动信号消息以确定通信和作业状态。如果发布程序在指定的超时时间间隔内未收到对消息的应答，那么 CDC Replication 将确定发生了问题，并尝试停止预订的所有 CDC Replication 发布程序和订户作业。此外，发生脉动信号超时时，会将消息 (消息标识 DMU3165 和 DMU0647) 放入事件日志中。

如果指定了小于最小设置的值，那么将使用最小设置。如果指定了大于最大设置的值，那么将使用最大设置。

时间: 时间量 (以分钟为单位)。; 最小设置: 3 分钟; 最大设置: 999 分钟; 缺省设置: 15 分钟

报告位置时间 (REPTPOSTIM)

指定在不活动时间段内，发布者将其在当前日志中的位置通知订户的频率 (以秒计)。在不活动时间段内，当没有与当前预订相关的日志项时，发布者会将其当前位置通知订户，以便订户可以相应地前进其书签。通过指定此参数的下限设置，订户可以更准确地反映复制的进度。此参数还可防止重新处理不适用于当前正在复制的表的条目。此参数的值会影响 "事件日志查看器" 中以及 " 管理控制台" 的 " 监视 " 视图中显示的正在进行的信息和书签消息。此参数的高设置可能导致显示的信息不是最新的信息。如果指定了小于最小设置的值，那么将使用最小设置。如果指定了大于最大设置的值，那么将使用最大设置。

时间: 时间量 (以秒为单位)。; 最小设置: 1 秒; 最大设置: 300 秒; 缺省设置: 5 秒

同步时间 (BKMARKSYNC)

发布程序与订户之间执行的连续同步之间的时间段 (以秒为单位)。当订户向发布者报告上次落实的更改的位置时，将实现同步。如果要复制大量信息，那么可能要将此值设置为较小的数字，以允许更频繁地除去过时的日志接收器。如果指定了小于最小设置的值，那么将使用最小设置。如果指定了大于最大设置的值，那么将使用最大设置。

时间: 时间量 (以秒为单位)。; 最小设置: 1 秒; 最大设置: 300 秒; 缺省设置: 60 秒

等待时间度量更新频率 (MONSAMPFRQ)

用于维护复制等待时间度量的数据存储器的连续更新之间的时间段 (以秒计)。数据存储器由管理控制台引用以提供复制等待时间信息。

如果指定了小于最小设置的值，那么将使用最小设置。如果指定了大于最大设置的值，那么将使用最大设置。

时间: 时间量 (以秒为单位)。; 最小设置: 0 秒。如果此参数设置为 0 ，那么不会在数据存储器中更新复制等待时间度量值。; 最大设置: 3600 秒 (1 小时); 缺省设置: 5 秒

初始化进程终止的等待时间 (STARTUP)

在终止 CDC Replication 初始化阶段之前要等待的最大时间量 (以秒计)。在数据复制之前的 CDC Replication 初始化期间，发布或预订服务器上的进程终止可能会导致初始化阶段的暂挂。

此参数允许您设置此情况下的最大等待时间。

如果指定了小于最小设置的值，那么将使用最小设置。

如果指定了大于最大设置的值，那么将使用最大设置。

时间: 时间量 (以秒为单位)。; 最小设置: 4 秒; 最大设置: 3600 秒 (1 小时); 缺省设置: 120 秒

进度消息 (PROGRESS)

生成下一条进度消息之前要等待的时间量 (以秒计)。进度消息放置在事件日志中。

如果指定了小于最小设置的值，那么将使用最小设置。

如果指定了大于最大设置的值，那么将使用最大设置。

时间: 时间量 (以秒为单位)。; 最小设置: 0 秒。不会发出任何进度消息。; 最大设置: 7200 秒 (2 小时); 缺省设置: 0 秒。不会发出任何进度消息。

锁定超时 (LCKTIMEOUT)

CDC Replication 在事件日志中生成错误消息之前等待表或行解锁的时间量 (以秒计)。

如果指定了小于最小设置的值，那么将使用最小设置。

如果指定了大于最大设置的值，那么将使用最大设置。

时间: 时间量 (以秒为单位)。; 最小设置: 2 秒; 最大设置: 60 秒; 缺省设置: 30 秒

Unicode 列格式 (UNICODE_IS)

用于处理已定义 Unicode 列中的数据的缺省方法。在管理控制台e 中，可以确定如何处理源表中每个 Unicode 列中的数据。对于服务器上的每个 CDC Replication 安装，此参数定义用于处理 Unicode 列中的数据的系统缺省方法。如果管理控制台中的 Unicode 列设置为系统缺省值，那么将使用此参数定义的当前系统缺省方法。

以下 DB2® for IBM i 数据类型被视为 Unicode 列，因此受为此参数指定的值影响:

代码页为 1208 (UTF-8) 的 GRAPHIC 或 VARGRAPHIC
代码页为 1208 (UTF-8) 的 CHARACTER 或 VARCHAR

*相同: 保留此参数的当前设置。; 这是缺省设置。
CHAR: CDC Replication 将 Unicode 列中的所有数据视为单字节字符。在 Unicode 列包含单字节字符数据时使用此设置。
无更改: CDC Replication 将 Unicode 列中的所有数据视为连续位流。; 当 Unicode 列包含非单字节字符数据时，使用此设置。 NOCHANGE 确保 CDC Replication 以与先前的 CDC Replication 发行版相同的方式处理非单字节字符数据。; NOCHANGE 不会确保在预订服务器上正确表示 Unicode 列中复制的非单字节字符数据。; 对于复制的非单字节字符数据，您可能必须应用用户出口程序或其他定制以正确表示 Unicode 列中的数据。

审计过滤器 (AUDFILTER)

指示在行更新后是否同时审计前映像和后映像会导致仅其中一个映像满足定义的行选择表达式。

可能要启用此系统参数的环境包括:

使用LiveAudit审核源表更改。
当对分配的源表应用行更新操作时，记录预订审计表中的前映像和后映像。
使用行选择来过滤放置在预订审计表中的行。当需要同时审计预订审计表中的前映像和后映像时，可以使用此参数来覆盖行选择，但只有其中一个映像满足定义的行选择表达式。

您可以使用两个日志码 (FP 和 FB) 来识别预订审计表中在此情况下不满足行选择表达式的前后图像。

此参数的初始设置根据您是从不支持此参数的先前 CDC Replication 发行版升级还是安装此 CDC Replication 发行版而有所不同。在 IBM i 服务器上安装 CDC Replication 时，将应用初始设置 *YES。如上所述， CDC Replication 升级的初始设置为 *NO。这将确保在完成此类型的升级后维护现有产品功能。

*相同: 保留此参数的当前设置。; 这是缺省设置。
*是: 当行更新仅导致其中一个图像满足定义的行选择表达式时，审计前映像和后映像。
* 否: 仅审计满足或不满足定义的行选择表达式的后映像。; 此设置在支持此参数之前维护现有的 CDC Replication 行为。

DBCS 数据修复的 CCSID (DBCSRCCSID)

指示应该为其修复格式不正确的混合 DBCS 数据的 CCSID。修复过程会将缺少的 Shift-Out 字符添加到数据末尾。请注意，数据修复会对复制性能产生负面影响。有效的混合 CCSID 是那些受 AS/400 支持且具有编码方案 1301 的 CCSID。

*全部: 将修复具有编码方案 1301 的列中的所有混合 DBCS 数据。
成员: 指定有效的混合 CCSID 值。
*无: 将不会修复任何混合 DBCS 数据。; 这是缺省设置。

结束日志上的结束镜像 (ENDREPLJRN)

指示在提取物理文件成员结束条目的日志记录时是否应该结束镜像。

*是: 当提取物理文件成员结束项的日志记录时，应结束镜像。
* 否: 当提取物理文件成员结束条目的日志记录时，镜像将继续。; 这是缺省设置。

审计表级别条目 (AUDTABTRAN)

指示是否应在 LiveAudit 预订中审计表级别日志项 (日志代码 F)。

*是: 将在 LiveAudit 预订中审计表级别日志项。; 这是缺省设置。
* 否: 将不会在 LiveAudit 预订中审计表级别日志项。

结果

将向作业记录生成相关消息。

示例

CHGDMSVAL JOURNAL(JRNLIB/JRN1)
NOTIFYQ(NOTQLIB/NOTQ1) NOTIFYCNT(10) RESTORE(*IMMED) AUTCDE(12345678)
UPDCOLUMN(*NO) CASCADE(*NO) REFWHLACT(*YES) USDEFJRN(*YES) HEARTTIME(60)
REPTPOSTIM(120) BKMARKSYNC(15) MONSAMPFRQ(15) STARTUP(180) PROGRESS(5)
LCKTIMEOUT(40) UNICODE_IS(CHAR) AUDFILTRAN(*YES)

将表记录到位于库 JRNLIB 中的日志 JRN1 。

通知消息将发送到位于库 NOTQLIB 中的消息队列 NOTQ1 。

在将通知发送到消息队列之前， CDC Replication 最多可以检测到 10 个错误。

当 CDC Replication 检测到复原时，将立即刷新表。

授权代码为 12345678。

未启用关键列过滤和级联复制，但启用了活动时刷新。

将处理用户定义的日志项以进行复制。

在尝试结束预订的所有 CDC Replication 发布程序和订户作业之前，发布程序最多等待来自订户的应答 60 分钟。

在不活动时间段内，发布者每 120 秒向订户通知其在当前日志中的位置。

每 15 秒执行一次发布者与订户之间的同步，以传达有关上次落实的更改的信息。

每 15 秒更新一次用于维护复制等待时间度量的数据存储器。

如果 CDC Replication 初始化阶段无法在 180 秒内完成，那么该阶段将终止。

每 5 秒生成一次进度消息。

在事件日志中生成错误消息之前， CDC Replication 将等待 40 秒以使表或行解锁。

GRAPHIC ， VARGRAPHIC ， CHARACTER 和 VARCHAR 列中的数据被视为单字节字符。

当审计应用于源表的更改时，当行更新导致仅其中一个映像满足已定义的行选择表达式时，会将前映像和后映像都放入预订审计表中。