UPDATE ALERT CONFIGURATION 命令
UPDATE ALERT CONFIGURATION 命令更新运行状况指示器的警报配置设置。
重要信息: 不推荐使用此命令或 API ,在以后的发行版中可能会将其除去,因为在版本 9.7中已不推荐使用运行状况监视器。 它在 Db2® pureScale® 环境中不受支持。 有关更多信息,请参阅 已不推荐使用运行状况监视器。
权限
为下列其中一种权限:
- SYSADM
- SYSMAINT
- SYSCTRL
必需的连接
。 不需要显式连接。
命令语法
命令参数
- DATABASE MANAGER
- 更新数据库管理器的警报设置。
- DATABASES
- 更新数据库管理器管理的所有数据库的警报设置。 这些是应用于所有没有定制设置的数据库的设置。 定制设置是使用 DATABASE ON database-alias 子句定义的。
- CONTAINERS
- 更新数据库管理器管理的所有表空间容器的警报设置。 这些是应用于所有没有定制设置的表空间容器的设置。 定制设置是使用 CONTAINER container-name ON database-alias 子句定义的。
- TABLESPACES
- 更新数据库管理器管理的所有表空间的警报设置。 这些是应用于所有没有定制设置的表空间的设置。 定制设置是使用 TABLESPACE tblspace-name ON database-alias 子句定义的。
- DATABASE ON database-alias
- 更新使用 ON database-alias 子句指定的数据库的警报设置。 如果此数据库具有定制设置,那么它们将覆盖使用 DATABASES 参数指定的实例的所有数据库的设置。
- CONTAINER container-name FOR tblspace-name ON database-alias
- 在使用 ON database-alias 子句指定的数据库上,针对使用 FOR tblspace-name 子句指定的表空间,更新名为 container-name的表空间容器的警报设置。 如果此表空间容器具有定制设置,那么它们将覆盖使用 CONTAINERS 参数指定的数据库的所有表空间容器的设置。
- TABLESPACE tblspace-name ON database-alias
- 在使用 ON database-alias 子句指定的数据库上更新名为 name的表空间的警报设置。 如果此表空间具有定制设置,那么它们将覆盖使用 TABLESPACES 参数指定的数据库的所有表空间的设置。
- USING health-indicator-name
- 指定将更新其警报配置的一组运行状况指示器。 运行状况指示器名称由两个字母的对象标识组成,后跟描述指示器度量内容的名称。 例如:
db.sort_privmem_util
- SET parameter-name value
- 将运行状况指示器的警报配置元素 parameter-name更新为指定的值。 parameter-name 必须是下列其中一个值:
- ALARM: value 是运行状况指示器单元。
- 警告: value 是运行状况指示器单元。
- 灵敏度: 值 以秒为单位。
- 操作能力: 值 可以是 是 或 否。
- THRESHOLDSCHECKED: 值 可以是 YES 或 NO。
- UPDATE ACTION SCRIPT pathname ON [WARNING | ALARM | ALLALERT | ATTENTION state]
- 指定将根据以下子句更新具有绝对路径名 pathname 的预定义脚本的脚本属性:
- SET parameter-name value
- 将脚本属性 parameter-name更新为指定的值。 parameter-name 必须是下列其中一个值:
- 脚本类型
操作系统 或 DB2 是有效类型。
- WORKINGDIR
- TERMCHAR
- CMDLINEPARMS您为操作系统脚本指定的命令行参数将在缺省提供的参数之前。 发送到操作系统脚本的参数包括:
- 用户提供的参数列表
- 运行状况指示器短名称
- 标准对象名
- 运行状况指示器值
- 警报状态
- USERID
- 密码
- 系统
- 脚本类型
- UPDATE ACTION TASK task-name ON [WARNING | ALARM | ALLALERT | ATTENTION state]
- 指定将根据以下子句更新名称为 name 的任务的任务属性:
- SET parameter-name value
- 将任务属性 parameter-name更新为指定的值。 parameter-name 必须是下列其中一个值:
- USERID
- 密码
- 系统
- DELETE ACTION SCRIPT pathname ON [WARNING | ALARM | ALLALERT | ATTENTION state]
- 从警报操作脚本列表中除去具有绝对路径名 pathname 的操作脚本。
- DELETE ACTION TASK task-name ON [WARNING | ALARM | ALLALERT | ATTENTION state]
- 从警报操作任务列表中除去名为 name 的操作任务。
- ADD ACTION SCRIPT pathname ON [WARNING | ALARM | ALLALERT | ATTENTION state]
- 指定要添加具有绝对路径名 pathname 的新操作脚本,其属性由以下各项提供:
- TYPE
- 操作脚本必须是 Db2 命令脚本或操作系统脚本:
- DB2
- 操作系统
如果是 Db2 命令脚本,那么以下子句允许您 (可选) 指定脚本中用于终止语句的字符 character:STATEMENT TERMINATION CHARACTER ;
如果它是操作系统脚本,那么以下子句允许您选择性地指定将在调用时传递到脚本的命令行参数 parms: COMMAND LINE PARAMETERS parms
- WORKING DIRECTORY pathname
- 指定将在其中执行脚本的目录的绝对路径名 pathname。
- USER username USING password
- 指定将在其下执行脚本的用户帐户 username和关联密码 password。
- ADD ACTION TASK name ON [WARNING | ALARM | ALLALERT | ATTENTION state]
- 指定将添加名为 name的新任务以运行 ON 指定的条件。
- ON [WARNING | ALARM | ALLALERT | ATTENTION state]
- 指定将运行操作或任务的条件。 对于基于阈值的运行状况指示器 (HIs) ,这是 WARNING 或 ALARM。 对于基于状态的 HIs ,这将是针对每个基于状态的 HI 记录的数字状态 (例如,对于 ts.ts_op_status 运行状况指示器,请参阅 tablespace_state 监视元素以获取表空间状态)。 ALLALERTS 处理基于阈值的 HI 和基于状态的 HI 的状态更改 (例如,状态从警告更改为正常)。
- ATTENTION state
- 以下部分提供了一些数据库运行状况指示器状态的有效数字值,作为 ADD ACTION SCRIPT CLP 命令选项的示例:
- 0 -活动; 正常 (ACTIVE)
- 1 -停顿暂挂 (QUIESCE_PEND)
- 2 -已停顿 (QUIESCED)
- 3 -前滚 (ROLLFWD)
在头文件 sqlmon.h 和 sqlutil.h中定义了其他基于状态的运行状况指示器。
使用说明
对于 ADD ACTION 选项,提供的 username 和 password 可能会在捕获 SQL 语句文本的各种位置公开:
- 网络 (用户名/密码通过未加密的连线传递)
- db2diag 日志文件
- 跟踪文件
- 转储文件
- 快照监视器 (动态 SQL 快照)
- 系统监视器快照
- 多个事件监视器 (语句,死锁)
- 说明表
- db2pd 输出 (程序包高速缓存和锁定超时机制等)
- Db2 审计记录