rmccli 信息文件

在线编辑

用途

提供有关资源监视和控制 (RMC) 及相关命令的常规信息。

描述

有关 RMC 及相关命令的常规信息（其中包括数据类型、术语以及对相关信息的引用）如下所示。

命令结构和用法

RMC 命令可分组为下列类别，这些类别表示可对资源类和资源运行的不同操作：

创建和除去资源：mkrsrc 和 rmrsrc
修改资源：chrsrc 和 refrsrc
查看定义和数据：lsrsrc 和 lsrsrcdef
查看操作：lsactdef
运行操作：runact

可以直接从命令行运行 RMC 命令或通过用户编写的脚本调用 RMC 命令。此外，RMC 命令还用作更高级命令的基础，例如事件响应资源管理器 (ERRM) 命令。

数据显示信息

以下是用于控制 RMC CLI 例程的显示功能的标志（按优先顺序列出）：

–l 表示以长格式显示。此标志是缺省显示格式。

例如，命令：

lsrsrc -s 'Name == "c175n05"' IBM.Foo Name NodeList SD Binary RH Int32Array

会产生以下输出：

Persistent Attributes for Resource: IBM.Foo
resource 1:
        Name       = "c175n05"
        NodeList   = {1}
        SD         = ["testing 1 2 3",1,{0,1,2}]
        Binary     = "0xaabbcc00 0xeeff"
        RH         = "0x0000 0x0000 0x00000000 0x00000000 0x00000000 0x00000000"
        Int32Array = {1,5,-10,1000000}

–t 表示以表格形式显示。

例如，命令：

lsrsrc -s 'Name ?= "Page"' -t IBM.Condition Name EventExpression

会产生以下输出：

Persistent Attributes for Resource: IBM.Condition

Name                  EventExpression       
"Page space out rate" "VMPgSpOutRate > 500" 
"Page fault rate"     "VMPgFaultRate > 500" 
"Page out rate"       "VMPgOutRate > 500"   
"Page in rate"        "VMPgInRate > 500"    
"Page space in rate"  "VMPgSpInRate > 500"

–x 表示在打印时不显示标题。
–d 表示以冒号 (:) 定界的形式显示。
例如，命令：
```
lsrsrc -xd -s 'Name == "c175n05"' IBM.Foo Name Int32 Uint32Array SD Binary 
```
会产生以下输出：
```
c175n05:-100:{}:["hel  lo1",1,{0,1,2}]:"0xaabbcc00 0xeeff":
```
注意，要将 –x 标志与 –d 标志一起使用。
–Ddelimiter 表示以字符串定界的形式显示。
例如，命令：
```
lsrsrc -xD:: -s 'Name == "c175n05"' IBM.Foo Name Int32 Uint32Array SD Binary 
```
会产生以下输出：
```
c175n05::-100::{}::["hel  lo1",1,{0,1,2}]::"0xaabbcc00 0xeeff"::
```
注意，要将 –x 标志与 –DDelimiter 标志一起使用。

以表格输出格式显示任何列表命令（lsrsrc 或 lsrsrcdef）的输出时，可能会截断打印列宽。如果需要显示更多字符（字符串就是这种情况），请使用 –l 标志来显示整个字段。

数据输入格式

可以采用以下格式来输入二进制类型的属性的二进制数据：

"0xnnnnnnnn 0xnnnnnnnn 0xnnnn..."
"0xnnnnnnnnnnnnnnnnnnnnn..."
0xnnnnnnnnnnnnnnnn...

其中一种整数类型的属性的整数数据可以输入为：

一个以非零数字开头的十进制常量（例如，Int32=45）
一个以前缀 0 开头的八进制常数，前缀后面可选择性地跟有范围介于 0 到 7 的十进制数字的组合（例如，Int32=055）
以前缀 0x 或 0X 开头的十六进制常量，后跟范围为 a 到 f 以及 A 到 F 的十进制数字的组合 (例如，Int32=0x2d)

指定字符串作为输入数据时应格外小心。包含以下内容的字符串：

可以输入非空格字符或非字母数字字符作为输入，而不必使用引号引起
空格字符或其他字母数字字符必须用引号引起
单引号 (') 必须用双引号 (") 括起，如以下示例中所示: "this is a string with 'single quotation marks'"

选择字符串必须用双引号引起，除非选择字符串本身包含双引号，在这种情况下，选择字符串必须用单引号引起。 For information about how to specify selection strings, see the 管理 RSCT Guide.

样本选择字符串输入："NodeNumber == 1"
选择字符串输入，其中双引号是选择字符串的一部分：'Name == "c175n05"'

结构化数据 (SD) 类型必须用方括号括起：[hello,1,{2,4,6,8}]

将结构化数据 (SD) 作为命令行输入提供给 RMC 命令时，请用单引号将 SD 引起：SD='[hello,1,{2,4,6,8}]'

任何类型的数组都必须用花括号 {} 括起：

整数数组：{-4, -3, -2, -1, 0, 1, 2, 3, 4}
字符串数组：{abc, "do re mi", 123}
结构化数据数组：{[hello,1,{0,1,2,3}],[hello2,2,{2,4,6,8}]}

具有多个元素的任何类型的数组都必须用引号引起。例如：

mkrsrc IBM®.Foo Name=testingNodeList={1 Uint32Array={1,2,3}'
mkrsrc IBM.Foo名称=测试NodeList='{1'Uint32_array={1,2,3}'

字符串数组和结构化数据数组必须总是用引号引起。

将结构化数据数组或包含用引号引起的字符串的数组作为命令行输入提供给 RMC 命令时，请用单引号将整个数组引起：

字符串数组：mkrsrc IBM.Foo Name="c175n05" NodeList={1} StringArray='{"a string","a different string"}'
结构化数据数组：mkrsrc IBM.Foo Name="c175n05" NodeList={1} SDArray='{["string 1",1,{1,1}],["string 2",2,{1,2,3}]}'

有关更多示例，请参阅 resource_data_input。

数据输出格式

显示的字符串数据始终用双引号或单引号引起，如下所示：

与字符串这是一个字符串，其中包含空格相等的描述属性以长格式显示为:
```
Description = "This is a string that contains white space"
```
以长格式显示等于空字符串的描述属性值，如下所示:
```
Description = "" 
```
等同于字符串（在该字符串结尾处包含换行符）的描述属性值以长格式显示为：
```
Description = "This string ends with a new-line character..."   
```
包含双引号的选择字符串以长格式显示为：
```
SelectionString = 'Name == "c175n05"'
```
等同于字符串 "c175n05" 的名称属性值以长格式显示为：
```
Name = "c175n05"
```

二进制数据以如下格式显示：

"0x nnnnnnnn 0x nnnnnnnn 0x nnnnnnnn 0x nnnnnnnn"

命名约定

以下变量名称用在所有 RMC 命令联机帮助页中：

变量	描述
`attr`	资源类或资源属性的名称
`资源类`	资源类的名称

节点组

如果系统上安装了 Cluster Systems Management (CSM)，可以将 CSM 定义的节点组用作节点名值来引用多个节点。有关使用 CSM 节点组以及使用 CSM nodegrp 命令的信息，请参阅 CSM: Administration Guide 和 CSM: Command and Technical Reference。

术语

指标

属性是持久的或动态的。资源类由一组持久和动态属性定义。资源也由一组持久和动态属性定义。持久属性定义资源类和资源的配置。动态属性定义资源类和资源的一种状态或一个与性能相关的方面。在同一个资源类或资源中，属性名称可以指定为持久或动态，但不能同时指定为两者。

资源

系统中提供一组服务的实体。硬件实体示例为处理器、磁盘驱动器、内存和适配器。软件实体示例为数据库应用程序、进程和文件系统。系统中的每个资源均具有一个或多个用来定义资源状态的属性。

资源类

广义类别的系统资源，例如：节点、文件系统和适配器。每个资源类均具有一个用来保留函数、信息、动态属性以及适用于该资源类的条件的容器。例如， /tmp space used 条件适用于文件系统资源类。

资源管理器

此进程将资源和资源类抽象映射至一个或多个特定类型资源的调用和命令。资源管理器可以是独立守护程序，也可以直接集成到应用程序或子系统中。

要查看系统中定义的所有资源类，请不带任何标志或参数运行 lsrsrc 命令。要查看系统中为 IBM.FileSystem 资源类定义的所有资源，请输入：

lsrsrc IBM.FileSystem

选择字符串

必须用双引号或单引号引起。如果选择字符串包含双引号，请用单引号将整个选择字符串引起，例如：

-s 'Name == "testing"'

-s 'Name ?= "test"'

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

标志

-h: 将命令的用法语句写到标准输出。
-T: 将命令的跟踪消息写到标准错误。仅供您的软件服务组织使用。
-V: 将命令的详细消息（如果有的话）写到标准输出。

所有 RMC 命令都包括一个 -T 标志和一个 -V 标志。 -T 标志只有在软件服务组织指导您打开跟踪功能时才予以使用。跟踪消息未翻译。请使用 -V 标志来指示“详细”方式以查看有关该命令的更多信息。详细消息（如果有的话）包含在消息目录中，并且已根据您正在运行的语言环境及其他条件进行翻译。

环境变量

CT_CONTACT

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

CT_IP_AUTHENT

如果 CT_IP_AUTHENT 环境变量存在，那么 RMC 守护程序会使用基于 IP 的网络认证来联系由 IP 地址（CT_CONTACT 环境变量设置为该 IP 地址）指定的系统上的 RMC 守护程序。如果 CT_CONTACT 环境变量设置为 IP 地址，那么 CT_IP_AUTHENT 环境变量有效；它不依赖于域名系统 (DNS) 服务。

CT_MANAGEMENT_SCOPE

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

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

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

标准输出

指定 -h 标志时，会将此命令的用法语句写到标准输出。如果指定了 -V 标志，那么会将这些命令详细消息（如果有的话）写入标准输出。

标准错误

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

退出状态

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

安全性

许可权在联系系统的访问控制表 (ACL) 文件中指定。

实现细节

此信息是针对 Linux®， Solaris 和 Windows 的 AIX® 和 rsct.core-3.1.0.0-0.平台.rpm 软件包的 rsct.core.rmc 文件集的一部分，其中 平台 是 i386， ppc， ppc64， s390或 x86_64。

位置

/opt/rsct/man/rmccli: /opt/rsct/man/rmccli.7 -对于 Linux 平台。