预定义的参数和标记

本节介绍在 CLI 中具有预定义含义的参数，

其中部分预定义参数的名称为单个字母。例如 a、f 和 o。这些都是正确的参数名，并没有错误。

- b

如果启动 CLI 时在 UNIX 命令行中包含此标记，则指示 CLI 在批处理模式下运行。在会话模式下将忽略此标记。

- h

如果在会话模式下使用此标记作为命令的参数，则指示 CLI 显示命令的帮助文本。

- l

此标记的名称为小写字母 l（ASCII 字符 0x6c），而不是数字 1（ASCII 字符 0x31）。 如果在会话模式下将此标记用作扩展命令的参数，则指示 CLI 在执行当前命令时保持最后一条扩展命令中的参数值不变。如果指定了 -l 标记，则为当前命令指定的任何其它参数都将被忽略。此标记对基本命令没有影响。以下示例说明了 -l 标记的用法：

> getLoadModules a=myHostName ... ... > getAlarms -l

getAlarms 命令在执行时将使用此前执行的 getLoadModules 命令中的参数 a (myHostName ) 的值。

a

参数 a 的值表示代理，它被指定为代理主机和（可选）端口号。如果指定了端口号，请使用冒号 (:)。 一般语法为 a=agentHost[:agentPort]。例如，要指定在主机 example_host 上运行并监听端口 12345 的代理，应使用以下语法：

a=example_host:12345

参数 a 的值也可以是用逗号分隔的代理名称列表：a=agent[, agent]+.

append

参数 append 的值是一个文件的名称，命令输出将附加到其中。如果此文件不存在，将创建它。如果全局设置 append 参数，则该会话中所有命令的输出都将附加到指定的文件中。也可以为特定命令设置此参数，如下所示。

append=/home/examples/cli_output

如果同时设置了 append 参数和 o 参数，则 append 将优先于 o。只在指定文件中记录命令结果，并不记录实际的命令。可以使用 log 参数记录命令信息。

columns

参数 columns 的值是由 print 命令显示的一列或多列命令输出的名称。列名称区分大小写。多个列名称之间用逗号分隔。下例使用了几个列名称。

columns="Alarm Id,Node URL,Target Host,Severity"

f

f 参数的值确定命令输出的格式。当前格式为 plain 和 html。详细信息，请参见命令输出格式。要将格式设置为 HTML，可使用以下语法：

f=html

height

height 参数的值是在屏幕上显示的命令输出的行数。下例将 height 设置为大约相当于标准终端屏幕的高度：

height=24

i

i 参数的值是输入文件的名称，该文件中包含的参数定义要包含在当前会话中。输入文件中的每个参数定义应位于不同的行上。例如，假设 /home/examples/myParams 文件中包含以下各行：

more=off serverHost=myserver a=myagent:161

可在下面的行中将这些参数包含到当前的 CLI 会话中：

i=/home/examples/myParams

log

log 参数的值是一个文件的名称，此文件记录了所有 CLI 命令和执行命令的时间。注意，日志文件只记录命令名称和命令执行的时间。命令输出记录在由参数 a 或参数 o 指定的文件中。设置该参数后，所有后续命令都附加到该文件中。如果此文件不存在，将创建它。由于打开日志记录时不覆盖日志文件，因此在需要创建其它日志时要确保另外指定一个文件。要关闭日志记录，可对 log 参数使用 unset 命令。下例将启动日志，然后再停止日志。

> log=/home/examples/sunmc-log ... ... > unset log

m

m 参数的值是 Sun Management Center 模块的名称。该值也可以是由逗号分隔的模块列表。

m=kernel-reader

more

more 参数的值控制屏幕上显示的命令输出的分页。可以使用的值包括 on 和 off。如果将 more 设置为 on，则到终端的所有后续输出一次显示一屏。屏幕大小由 height 和 width 参数定义。在批处理模式下，缺省值为 off；在会话模式下，缺省值为 on。

more=on

o

o 参数的值是向其中写入命令输出的文件的名称。如果此文件已存在，则将其覆盖。通过将 o 参数指定给特定命令，可以使用 o 参数捕获该命令的输出。也可以使用 set 命令全局设置该参数，将所有后续输出写入到某个文件。

如果同时设置了 append 参数和 o 参数，则 append 将优先于 o。命令输出将附加到指定的文件。只在该文件中写入命令输出，并不记录实际的命令。可以使用 log 参数记录命令信息。下例定义了将命令输出写入其中的文件。

o=/home/examples/sunmc-output

serverHost

serverHost 参数的值确定登录时 CLI 连接的服务器主机。CLI 连接到服务器后，将无法更改此全局参数。

serverPort

serverPort 参数的值表示登录的服务器端口。建立登录会话后，将无法设置此全局参数。如果未设置此参数，将使用缺省端口 2099。

t

t 参数的值表示在拓扑代理中管理的对象的名称。该对象可以是域、视图组或实体。对象名称是以域名开头的全限定名称，例如 /domain/group/host。