AIX命令参考大全，卷 4，n - r - runact 命令

[ 页的底部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]

AIX命令参考大全，卷 4，n - r

runact 命令

用途

对资源或资源类运行操作。

语法

runact -s "selection_string" [-f resource_data_input_file] [-l | -t | -d | -D delimiter] [-x] [-h] [-TV] resource_class action [in_element_0=value ... in_element_n=value] [rsp_element...]

runact -r [-f resource_data_input_file] [-l | -t | -d | -D delimiter] [-x] [-h] [-TV] resource_handle action [in_element_0=value ... in_element_n=value] [rsp_element...]

runact -c | -C rpd_name_1 ... rpd_name_n [-f resource_data_input_file] [-l | -t | -d | -D delimiter] [-x] [-h] [-TV] resource_class action [in_element_0=value ... in_element_n=value] [rsp_element...]

描述

runact 命令请求 RMC 子系统对指定资源或资源类运行指定操作。

运行此命令之前，请使用 lsactdef 命令列出此资源类支持的资源和资源类操作。并使用 lsactdef 命令列出调用操作时必须指定的所需输入操作元素。lsactdef 命令还标识每个输入元素的数据类型。为每个输入元素指定的值必须匹配该数据类型。

标志

-c

对资源类，而不是对资源调用此操作。缺省情况下对资源调用此操作。

-C rpd_name_1 ... rpd_name_n

对分布式管理（DM）作用域的 RSCT 对等域中的全局化类调用类操作。

-r

对匹配 resource_handle 的特定资源调用此操作。

-s "selection_string"

指定 selection_string。selection_string 必须用双引号或单引号引起来。如果 selection_string 包含双引号标记，必须将其用单引号标记引起来，例如：

-s 'Name == "testing"'

-s 'Name ?= "test"'

只有持久属性才可在选择字符串中列出。

-f resource_data_input_file

指定包含资源操作输入元素和值的文件的名称。带 -i 标志使用 lsactdef 命令为该输入文件生成模板。

-d

指定定界符格式的输出。缺省的定界符为冒号（:）。如果要更改缺省定界符，请使用 -D 标志。

-D delimiter

指定使用特定定界符的定界符格式输出。使用该标志以指定不同于缺省冒号（:）的其它定界符。例如，当要显示的数据包含冒号时。使用该标志以指定一个或多个字符的定界符。

-l

指定“长整型”格式－每行一个条目。此为缺省显示格式。

-t

指定表格式。在单独列中显示每个属性，每行一个资源。

-x

取消报头打印。

-h

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

-T

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

-V

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

参数

resource_class

使用要调用的操作指定资源类的名称。

resource_handle

指定要对其运行操作的资源对应的资源句柄。使用 lsrsrc 命令来获取有效资源句柄列表。必须将该资源句柄用双引号标记引起来，例如：

"0x4017 0x0001 0x00000000 0x0069684c 0x0d4715b0 0xe9635f69"

action

知道要调用的操作的名称。

in_element_n=value

指定操作的输入元素名和值。如果使用 -f 标志，请勿在命令行上输入任何 in_element_n=value 对。

in_element_n 是任意输入结构化数据元素名。指定的操作的每个指定结构化数据（SD）输入元素应该有一个 in_element_n=value 对。带 -s i 标志使用 lsactdef 来列出特定资源类和操作的输入元素。带 i 标志使用 lsactdef 来生成进行适当编辑后可用作输入文件的输入文件模板。

value 必须为指定元素的相应数据类型。例如，如果将 NodeNumber 定义为 unit32 数据类型，则输入正数值。

rsp_element

指定一个或多个操作响应结构化数据元素名称。如果指定了一个或多个元素名称，则以指定顺序仅显示这些元素。如果不指定任何元素名称，将显示响应的所有元素。

安全性

此命令需要超级权限。

退出状态

0: 命令已成功运行。
1: RMC 发生错误。
2: 命令行界面（CLI）脚本出错。
3: 在命令行上指定了不正确的标志。
4: 在命令行上指定了不正确的参数。
5: 发生了一个由于不正确的命令行输入而导致的 RMC 错误。
6: 没有找到匹配指定的选择字符串的资源。

环境变量

CT_CONTACT

当 CT_CONTACT 环境变量被设置为一个主机名或 IP 地址，该命令同指定主机上的资源监视和控制（RMC）守护程序联系。如果没有设置环境变量，该命令同运行命令的本地系统上的 RMC 守护程序联系。该命令显示或修改的资源类或资源位于连接建立的系统上。

CT_MANAGEMENT_SCOPE

确定用于同 RMC 守护程序进行会话的管理作用域，该守护程序用来监视和控制资源和资源类。该管理作用域确定了能被监视和控制的资源和资源类所在的可能目标节点集。有效值为：

0: 指定本地作用域。
1: 指定本地作用域。
2: 指定对等域作用域。
3: 指定管理域作用域。

如果没有设置这个环境变量，使用本地作用域。

标准输出

在指定 -h 标志时，该命令的用法语句将写到标准输出。

命令的输出和所有详细信息写到标准输出。

标准错误

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

示例

要对匹配指定选择字符串的 IBM.Foo 资源类中的资源调用 ExecuteCommand 资源操作，请输入：

runact -s 'Name == "c175n05"' IBM.Foo ExecuteCommand Command="uname -a" User=bealzy

输出如下：

Resource Action Response for: ExecuteCommand
sd_element 1:
   Stdout          = "AIX c175n07 1 5 000069564C00"
   Stderr          = ""
   ExitCode        = 0
sd_element 2:
   Stdout          = ""
   Stderr          = ""
ExitCode           = 0

要对匹配指定选择字符串的 IBM.Foo 资源类中的资源调用 ExecuteCommand 资源操作，但仅显示不带头信息的表格式的格式的响应元素 Stdout，请输入：
```
runact -s 'Name == "c175n05"' -t -x IBM.Foo ExecuteCommand Command="uname -a" \ 
       User=bealzy Stdout
```
输出如下：
```
"AIX c175n07 1 5 000069564C00
"
""
```

要对资源类 IBM.Foo 调用 TestClassAction 资源类操作，请输入：

runact -c IBM.Foo TestClassAction Int32=99