chresponse 命令

用途

添加或删除响应的操作或重命名响应。

语法

要将操作添加到响应：

chresponse -a -n 操作 [ -d days_of_week[,days_of_week ...]] [-t time_of_day[,time_of_day ...]] [-s action_script] [-r return_code] [ -b | [-e a | A | b | e | r]] [-o] [-E env_var=value[,env_var=value ... ] ] [-u] [-h] [-TV] 响应[:node_name]

要从响应删除操作：

chresponse -p -n 操作 [-h] [-TV] 响应[:node_name]

要重命名响应：

chresponse -c new_response [-h] [-TV] 响应[:node_name]

要解锁或锁定某个响应：

chresponse {-U | -L} [-h] [-TV] 响应[:node_name]

描述

chresponse 命令向响应添加操作或从响应中删除操作。 操作定义了当响应使用的条件满足时运行该命令。 chresponse 命令还可用于重命名响应。

如果系统软件正确工作需要某个特定的响应，那么该响应可能被锁定。 不能修改或除去锁定的响应，直到将它解锁为止。 如果您在 chresponse 命令上指定的响应已锁定，那么不会对其进行修改; 而是会生成错误，通知您响应已锁定。 要解锁响应，可以使用 -U 标志。 但是，由于响应通常是被锁定的（因为它是系统软件正确工作的基本因素），您应该在解锁它之前进行提醒。 要锁定响应以使其无法修改，请使用 -L 标志。

如果系统上安装了 Cluster Systems Management (CSM)，可以将 CSM 定义的节点组用作节点名值来引用多个节点。

标志

-a

将操作规范添加到 response。

-b

指定响应以及要在此响应中定义的所有操作都支持事件批处理。 对于事件批处理，多个事件可以一起进行批处理或分组并传递至响应。 响应的操作会定向至包含批处理事件的详细信息的文件。 支持事件批处理的响应只能用于那些指定要进行批处理的事件的条件。

-b 标志不能与 -e 标志一起指定。

-p

从 响应中删除 操作 。

--c new_response

指定新的名称以分配到响应。 新的名称绝不能已经存在。 新的名称替换当前名称。 new_response 名称是标识响应的字符串。 如果名称中包含空格，那么必须用引号将其括起。 名称不能全部由空格组成，不能为空或包含嵌入式的双引号。

--n 行动

指定操作的名称。 使用 -a 标志时，这是正在定义的操作的名称。 使用 -p 标志时，这是要删除的操作的名称。 操作名称在响应内必须是唯一的。 一次只可以定义一个操作。

--d 每周天数[,每周天数...]

指定在每周的哪些天可以运行定义的操作。 当操作能运行时，days_of_week 和 time_of_day 共同定义间隔。

输入以加号 (+) 分隔的天数或以连字符 (-) 分隔的天数范围。 可以指定多个 days_of_week 参数，但这些参数必须以逗号 (,) 分隔。 指定的 days_of_week 参数的数目必须与指定的 time_of_day 参数的数目相匹配。 缺省为所有天。 如果不指定值而输入一个逗号，使用缺省值。 每天的值如下：

1

星期日

2

星期一

3

星期二

4

星期三

5

星期四

6

星期五

7

星期六

-t 每日时间[,time_of_day..]

指定运行操作的时间范围，组成为启动时间后紧跟结束时间，用连字符分开。 当操作能运行时，days_of_week 和 time_of_day 共同定义间隔。

时间为 24 小时格式（HHMM），其中前两个数字表示小时，后两个数字表示分钟。 由于时间由星期几指定，因此启动时间必须小于结束时间、 可以指定多个 time_of_day 参数，但这些参数必须以逗号 (,) 分隔。 指定的 days_of_week 参数的数目必须与指定的 time_of_day 参数的数目相匹配。 缺省值为 0000-2400。 如果不指定值而输入一个逗号，使用缺省值。

--s action_script

指定脚本或命令的全限定路径，该脚本或命令用来运行正定义的操作。 请参阅 displayevent， logevent， notifyevent和 wallevent 命令，以获取应用程序随附的预定义响应脚本的描述。

--r 返回代码

指定 action_script 的预期返回值。 将 action_script 的实际返回码与期望返回码比较。 向审计日志中写入一条消息，该审计日志表示它们是否匹配。 如果未指定 -r 标志，那么会将实际返回码写入审计日志，并且不会执行比较。

-e a | A | b | e | r

指定使正定义的操作运行的事件的类型：

a

指定事件。 这是缺省值。

A

指定任何类型的事件（事件、错误事件或重整事件）。

b

指定事件和重整事件。

e

指定错误事件。

r

指定重整事件。

可以指定多种事件类型，例如：-e ae。

-e 标志不能与 -b 标志一起指定。

-o

将标准输出从 action_script 指向审计日志。 缺省为不保留标准输出。 总是将标准错误指向审计日志。

-E env_var=价值[,env_var=价值..]

指定要在 action_script 运行之前设置的任何环境变量。 如果指定了多个 env_var=value 变量，那么必须使用逗号进行分隔。

-u

指定当受监控的资源成为未定义时运行该操作。

-h

将命令的用法语句写到标准输出。

-T

将命令的跟踪消息写到标准错误。 仅供您的软件服务组织使用。

-V

将命令的详细消息写到标准输出。

-U

解锁某个响应而使其可以修改或删除。 如果某个响应被锁定，这通常是因为它是系统软件正确运行的基本因素。 由于此原因，您在解锁它之前应小心谨慎。 使用 -U 标志解锁某个条件时，此命令不能执行其他操作。

-L

锁定某个响应而使其无法修改或删除。 当使用 -L 标志锁定响应时，此命令不能执行其他操作。

参数

响应

指定要更改的响应的名称。

节点名

指定定义响应的节点。 如果未指定 node_name，那么使用本地节点。 node_name 是由 CT_MANAGEMENT_SCOPE 环境变量所确定的作用域内的节点。

安全性

chresponse 命令的用户需要对定义了响应的节点上的 IBM.EventResponse 资源类具有写许可权。 许可权在联系系统的访问控制表 (ACL) 文件中指定。 请参阅 RSCT: Administration Guide 以获取有关 ALC 文件以及如何修改该文件的详细信息。

退出状态

0

命令成功运行。

1

RMC 发生错误。

2

命令行界面脚本发生错误。

3

命令行中输入错误标志。

4

命令行中输入错误参数。

5

不正确的命令行输入导致出错。

环境变量

CT_CONTACT

确定与资源监视和控制 (RMC) 守护程序发生会话的系统。 当 CT_CONTACT 设置为主机名或 IP 地址时，该命令会与指定主机上的 RMC 守护程序联系。 如果未设置 CT_CONTACT，那么该命令会与运行它的本地系统的 RMC 守护程序联系。 RMC 守护程序会话的目标和管理作用域确定了处理的资源类或资源。

CT_IP_AUTHENT

如果存在 CT_IP_AUTHENT 环境变量，那么 RMC 守护程序将使用基于 IP 的网络认证，与 CT_CONTACT 环境变量中的 IP 地址所指定系统上的 RMC 守护程序联系。 仅当 CT_CONTACT 设为 IP 地址时，CT_IP_AUTHENT 才有意义；它不依赖于域名系统（DNS）服务。

CT_MANAGEMENT_SCOPE

确定处理事件响应资源管理器（ERRM）的资源时用于与 RMC 守护程序的会话的管理作用域。 管理作用域确定可以处理资源的可能目标节点集。 有效值为：

0

指定本地作用域。

1

指定本地作用域。

2

指定对等域作用域。

3

指定管理域作用域。

如果此环境变量未设置，那么使用本地作用域。

实现细节

该命令是AIX Reliable Scalable Cluster Technology（RSCT）文件集的一部分。

标准输出

当指定 -h 标志时，此命令的用法语句将写入标准输出。 所有详细消息都写到标准输出。

标准错误

所有跟踪消息都写到标准错误。

示例

位置

/opt/rsct/bin/chresponse