rmccli 信息

在线编辑

用途

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

描述

提供有关 RMC 和相关命令的常规信息，包括数据类型，术语以及对相关信息的引用。

命令结构和用法
RMC 命令可以分为多个类别，这些类别表示可以对资源类和资源执行的不同操作:
  • 创建和除去资源: mkrsrc， rmrsrc
  • 修改资源: chrsrc， refrsrc
  • 查看定义和数据: lsrsrc， lsrsrcdef
  • 查看操作: lsactdef
  • 正在运行操作: runact
可以直接从命令行运行 RMC 命令或通过用户编写的脚本调用 RMC 命令。 此外，RMC 命令还用作更高级命令的基础，例如事件响应资源管理器 (ERRM) 命令。
数据显示信息
以下是控制 RMC CLI 例程的显示功能的标志 (按优先顺序排列):
  1. –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}
  2. –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"
  3. –x ，用于在打印时禁止标题。
  4. –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 标志的使用。
  5. –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 Delimiter 标志一起使用。
当以表格输出格式显示任何列表命令 (lsrsrc lsrsrcdef的输出时，可能会截断打印列宽。 如果需要显示更多字符 (如字符串) ，请使用 –l 标志来显示整个字段。
数据输入格式
可以输入以下格式的二进制数据:
  • "0x######## 0x######## 0x####..."
  • "0x###################..."
  • 0x################...
将字符串指定为输入数据时请小心:
  • 可以输入不包含空格或非字母数字字符的字符串作为输入，而不需要括起引号
  • 包含空格或其他字母数字字符的字符串必须括在引号中
  • 包含单引号 (') 的字符串必须用双引号 (") 括起，如以下示例所示: "this is a string with 'single quotations marks'"
选择字符串必须用双引号引起，除非选择字符串本身包含双引号，在这种情况下，选择字符串必须用单引号引起。 关于如何指定选择字符串的信息，请参阅 RSCT: Administration 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}]}
具有多个元素的任何类型的数组都必须用引号引起。 例如：
  • mkrsrcIBMFoo Name=testingNodeList={1 Uint32Array={1,2,3}'
  • mkrsrc 'IBMFoo Name=testing '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 信息文件。

数据输出格式
字符串数据始终显示在双引号或单引号中，如下所示:
  • 与字符串 "This is is a string contains white space" 相等的描述属性使用长格式显示为:
    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######## 0x######## 0x######## 0x###..."
命名约定
在 RMC 命令信息中使用了以下变量名称:
变量
描述
阿特尔
资源类或资源属性的名称
资源类别
资源类的名称
术语
指标
属性是持久的或动态的。 资源类由一组持久和动态属性定义。 资源也由一组持久和动态属性定义。 持久属性定义资源类和资源的配置。 动态属性定义资源类和资源的一种状态或一个与性能相关的方面。 在同一资源类或资源中，可以将给定属性名称指定为持久或动态名称，但不能同时指定这两者。
资源
系统中提供一组服务的实体。 硬件实体示例为处理器、磁盘驱动器、内存和适配器。 软件实体示例为数据库应用程序、进程和文件系统。 系统中的每个资源均具有一个或多个用来定义资源状态的属性。
资源类
广义类别的系统资源，例如：节点、文件系统和适配器。 每个资源类均具有一个用来保留函数、信息、动态属性以及适用于该资源类的条件的容器。 例如， 已使用 /tmp 个空间 条件将适用于文件系统资源类。
资源管理器
此进程将资源和资源类抽象映射至一个或多个特定类型资源的调用和命令。 资源管理器可以是一个独立的守护程序，也可以直接集成到应用程序或子系统中。
要查看系统中定义的所有资源类，请运行不带任何标志或参数的 lsrsrc 命令。 要查看系统中为 IBM.FileSystem 资源类定义的所有资源，请输入:
lsrsrc IBM.FileSystem
选择字符串
必须用双引号或单引号引起。 如果选择字符串包含双引号，请用单引号将整个选择字符串引起，例如：
-s 'Name == "testing"'

-s 'Name ?= "test"'

只有持久属性才可在选择字符串中列出。 关于如何指定选择字符串的信息，请参阅 RSCT: Administration Guide。

标志

-h
将命令的用法语句写到标准输出。
-T
将命令的跟踪消息写到标准错误。 仅供您的软件服务组织使用。
-V
将命令的详细消息写到标准输出。
所有 RMC 命令都包含 -T 标志和 -V 标志。 仅当软件服务组织指示您开启跟踪时，才使用 -T 标志。 跟踪消息未翻译。 使用指示 "verbose" 方式的 -V 标志来查看有关该命令的更多信息。 详细消息包含在消息目录中，并根据您正在运行的语言环境和其他条件进行翻译。

环境变量

CT_CONTACT
当 CT_CONTACT 环境变量设置为主机名或 IP 地址时，该命令将联系指定的主机上的资源监视和控制 (RMC) 守护程序。 如果没有设置该环境变量，那么该命令会联系其运行所在的本地系统上的 RMC 守护程序。 该命令显示或修改的资源类或资源位于建立连接的系统上。
CT_MANAGEMENT_SCOPE
确定用来与 RMC 守护程序进行会话的管理作用域，以监视和控制资源和资源类。 管理作用域确定了能够监视和控制资源和资源类的可能的目标节点集。 有效值为：
0
指定本地作用域。
1
指定本地作用域。
2
指定对等域作用域。
3
指定管理域作用域。

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