AIX命令参考大全，卷 3，i - m - mkrsrc 命令

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

AIX命令参考大全，卷 3，i - m

mkrsrc 命令

用途

定义一个新资源。

语法

要定义新资源，请使用下列数据……

在命令行上输入的数据：
mkrsrc [-v] [-h] [-TV] resource_class attr=value...
在输入文件中预定义的数据：
mkrsrc -f resource_data_input_file [-v] [-h] [-TV] resource_class

要查看 mkrsrc 命令对某个资源类的示例：

mkrsrc -e [-h] [-TV] resource_class

描述

mkrsrc 命令请求 RMC 子系统为由 resource_class 参数指定的类创建一个新的资源实例。至少一个持久的属性名及其值必须指定为命令，或者通过使用 -f 标志的资源定义文件指定。

在运行 mkrsrc 之前，应该运行 lsrsrcdef 命令来确定哪些属性指定为 reqd_for_define（必需）或 option_for_define（可选）。只有指定为 reqd_for_define 或 option_for_define 的属性才能使用 mkrsrc 命令来定义。lsrsrcdef 命令还标识每个属性的数据类型。为每个属性指定的值必须与该数据类型匹配。

要验证命令行上或 resource_data_input_file 中指定的属性名是否定义为持久属性，以及是指定为 reqd_for_define 还是 option_for_define，请使用 -v 标志。如果运行 mkrsrc 命令时使用了 -v 标志，则不定义该资源。而是仅验证这些资源属性是否持久，以及是指定为 reqd_for_define 还是 option_for_define。只要运行了 mkrsrc -v 来验证在命令行或 resource_data_input_file 上指定的属性是否有效，就可以不使用 -v 标志发出 mkrsrc 命令来定义此新资源。

标志

-e

对下列属性显示 mkrsrc 命令输入的示例：

仅必需的属性
必需的和可选的属性

-f resource_data_input_file

指定包含资源属性信息的文件名。

-v

验证在命令行上或在输入文件中指定的所有属性名是否被定义为持久属性以及指定为 reqd_for_define 或 option_for_define。使用此标志时，mkrsrc 命令不定义任何资源。

-h

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

-T

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

-V

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

参数

resource_class

指定要定义的资源的资源类名称。

attr=value...

指定正在定义的资源的属性。当定义新资源实例时，对于每个必须定义的资源都存在特定的要求的属性。这些属性可以定义为命令行上的参数，或者通过使用 -f 标志在输入文件中定义。

attr: 该资源的持久属性的名称。该属性必须指定为 reqd_for_define 或 option_for_define。使用 lsrsrcdef 命令来检查该指定。
value: 该持久属性的值。该值的数据类型必须与该属性的值的已定义的数据类型匹配。使用 lsrsrcdef 命令以验证每个属性的数据类型。

安全性

要运行 mkrsrc，用户需要有 mkrsrc 中定义的 resource_class 的写权限。权限定义在联系系统的访问控制表（ACL）文件中。

退出状态

0: 命令已成功运行。
1: RMC 出错。
2: 命令行界面（CLI）脚本出错。
3: 在命令行上指定了不正确的标志。
4: 在命令行上指定了不正确的参数。
5: 发生了一个由于不正确的命令行输入而导致的 RMC 错误。

环境变量

CT_CONTACT

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

CT_MANAGEMENT_SCOPE

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

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

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

标准输出

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

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

标准错误

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

示例

要在 IBM.Host 类中创建新资源，假定您已经知道当定义该类的资源时需要哪些持久属性，请输入：
```
mkrsrc IBM.Host Name=c175n05
```
在 IBM.Processor 类中创建一个新资源，首先要生成一个模板来协助定义这些资源，输入：
```
lsrsrcdef -i IBM.Processor > /tmp/IBM.Processor.rdef
```
然后，编辑文件 /tmp/IBM.Processor.rdef 并输入所有属性的值，用适当的值代替类型，或让它留空为缺省值。

最后，输入：
```
mkrsrc -f /tmp/IBM.Processor.rdef IBM.Processor
```

要使用文件 /tmp/IBM.Host.rdef 中定义的信息来创建两种新的 IBM.Host 资源，请输入：

mkrsrc -f /tmp/IBM.Host.rdef IBM.Host

文件 /tmp/IBM.Host.rdef 形式如下：

持久资源属性：
资源 1：
    名称         =  c175n04

资源 2：
    名称         =  c175n05

该示例在 IBM.Foo 类中创建一种新的资源。在该类中，Name 和 NodeList 是必需的属性。Binary、SD、StringArray 和 SDArray 属性是可选的。该示例显示了如何从命令行输入更复杂的数据类型。可选属性（Binary、SD、StringArray 和 SDArray）的数据类型是显而易见的。输入：
```
mkrsrc IBM.Foo Name=c175n05 \
NodeList={1} \
Binary="0xaabbccddeeff00" \
SD='[testing123,1,{2,4,6}]' \
StringArray='{"testing 1 2 3",testing123,"testing 1 2 3"}' \
SDArray='{["testing 1 2 3",1,{1,3,5}],[testing,2,{2,4,6}]}'
```
注:

如 rmccli 一般信息文件中所论述，某些数据类型（结构数据、结构数据数组和包含以引号括起来的字符串的数组）的属性值应该用单引号括起来。

位置

/usr/sbin/rsct/bin/mkrsrc: 包含 mkrsrc 命令