4 XCMD XAPI 服务器操作员命令

本章介绍了 XCMD 支持的 XAPI 服务器操作员命令。这些命令有助于操作员或管理员监视 ACSLS XAPI 组件。支持的命令包括：

使用 XCMD 命令从 ACSLS user_proc 发出这些命令。有关更多信息，请参见XCMD 命令约定。

有关以下各个命令部分中包括的语法流程图中使用的约定，请参见语法约定。

LOG

以下部分介绍 LOG 命令。

说明

LOG 命令可更改或列出当前的 XAPI 服务器日志设置。

注:

日志文件名和位置由 ACSLS 环境变量设置，默认为 XAPI_WORK_PATH 目录中的文件名 vlog.file。

语法

下图显示 LOG 命令的语法：

图 4-1 LOG 命令语法

周围的文本说明了 图 4-1 。

参数

如图 4-1中所示，LOG 命令包括以下参数：

LIst

（可选）指定显示当前日志设置。如果未指定命令参数，默认值为 LIst。

log_setting

（可选）将指定的所需日志设置表示为一系列 '0' 和 '1' 字符。

  • 0 表示所需的位置日志设置应为 OFF 或禁用。

  • 1 表示所需的位置日志设置应为 ON 或启用。

指定的值将完全替换当前日志设置，不会与其合并。位置日志设置如下所述：

  • 1－将错误消息记录到 ACSLS XAPI 组件日志。

  • 01－将消息记录到日志文件。

  • 001－将输入事务错误记录到日志文件。

  • 0001－将所有 XML recv() 包记录到日志文件。

  • 00001－将所有 XML send() 包记录到日志文件。

  • 000001－将本地命令和响应记录到日志文件。

XAPI LOG 消息将保存在 $ACS_HOME/log/xapi/vlog.file 中。

注:

使用 LOG 命令设置和显示的 0 和 1 位置数 (16) 比上面当前定义为 LOG 设置的位置数多；这便于将来进行扩展，任何无关的 0 或 1 LOG 设置将被直接忽略。
OFF

（可选）指定应禁用日志记录。此参数与 LOG 0 等效。

示例

在下面的示例中，用户发出 LOG 命令以将 XAPI 服务器设置为将所有错误和所有 XML recv() 包记录到日志文件：

XCMD LOG 1011

LIST

以下部分介绍 LIST 命令。

说明

LIST 命令列出当前 XAPI 服务器状态和设置。

语法

下图显示 LIST 命令的语法：

图 4-2 LIST 命令语法

周围的文本说明了 图 4-2 。

参数

如图 4-2中所示，LIST 命令包括以下参数：

ALL

（可选）显示所有 XAPI 服务器状态和设置。如果发出 LIST 命令而不带任何参数，则这是默认值。

CB name

指定已命名的控制块以字符以及字符十六进制格式显示。只能在 Oracle 技术支持指导下使用。

为 name 指定以下控制块之一：

  • HTTPCVT

  • HTTPGBL

  • HTTPREQ-nnn

  • HTTPAPI-nnn

对于 LIST CB HTTPREQ 和 LIST CB HTTPAPI，必须指定介于 0 和 999 之间的索引。此外，必须使用单个短划线 ("-") 将索引与控制块隔开，其中没有空格。例如：

LIST HTTPREQ-0

或者

LIST HTTPAPI-900

FILES

（可选）指定显示 XAPI 服务器控制、日志和跟踪文件的全路径名。

HISTORY

（可选）指定显示过去 24 小时内的 XAPI 事务计数历史记录。

LOG

（可选）指定显示当前 XAPI 服务器日志设置。这与发出不带参数的 LOG 命令等效。

MSGLVL

（可选）指定显示当前 XAPI 服务器消息级别设置。这与发出不带参数的 MSGLVL 命令等效。

SERVER

（可选）指定显示当前 XAPI 服务器和 UNIX 版本、相关参数和环境变量以及共享段和消息队列。

您可以选择性地包括 PROCESS 关键字，以请求同时显示所有活动 XAPI 服务器进程 ID、线程和打开文件计数、CPU 和内存使用情况。

PROCESS

与 SERVER 一起指定时，PROCESS 关键字请求同时显示所有活动 XAPI 服务器进程 ID、线程和打开文件计数、CPU 和内存使用情况。

TASKS

（可选）指定显示当前 XAPI 服务器系统和工作任务。

TRACE

（可选）指定显示当前 XAPI 服务器跟踪设置。这与发出不带参数的 TRACE 命令等效。

XAPI

（可选）指定显示当前 XAPI 服务器侦听器端口和 IP 地址。

您可以选择性地包括 IO 关键字，以请求同时显示所有 XAPI 服务器侦听器统计信息。

示例

在下面的示例中，用户发出 LIst 命令以显示当前 XAPI 服务器侦听器端口、IP 地址和侦听器状态：

XCMD LIST XAPI IO

MSGLVL

以下部分介绍 MSGLVL 命令。

说明

MSGLVL 命令可更改或列出 XAPI 服务器的消息详细级别。

语法

下图显示 MSGLVL 命令的语法：

图 4-3 MSGLVL 命令语法

周围的文本说明了 图 4-3 。

参数

如图 4-3中所示，MSGLVL 命令包括以下参数：

LIst

指定显示当前 MSGLVL 设置。如果未指定命令参数，默认值为 LIst。

level

指定所需的 MSGLVL 设置。级别越高，XAPI 服务器消息就越详细。消息级别是累积性的；MSGLVL 8 将生成最高到 MSGLVL 8 并包含该级别的所有消息（即生成 MSGLVL 0 到 8 的消息）。消息级别概括如下：

  • 0－正常的启动、关闭和错误消息；不能禁止这些消息。

  • 4－严重警告消息。

  • 8－次要警告消息。

  • 12－启动参数和选项消息。

  • 16－其他启动和关闭消息。

  • 20－其他诊断级别 20 消息。

  • 24－其他诊断级别 24 消息。

  • 28－其他任务启动和关闭消息。

OFF

指定应禁用所有详细消息。此参数与 MSGLVL 0 等效。

示例

在下面的示例中，用户发出 MSGLVL 命令以将 XAPI 服务器消息更改为包括所有警告消息：

XCMD MSGLVL 8

TRACE

以下部分介绍 TRACE 命令。

说明

TRACE 命令可更改或列出 XAPI 服务器跟踪设置。

注:

  • 跟踪文件名和位置由 ACSLS 环境变量设置，默认为 DV_TAG_XAPI_WORK_PATH 变量中的文件名 vtrace.file。

  • 跟踪对系统性能有重要影响。只能在 Oracle StorageTek 技术支持的请求下将跟踪设置为 ON。

  • 使用 TRACE 命令设置和显示的 0 和 1 位置数 (16) 比上面当前定义为 TRACE 设置的位置数多；这便于将来进行扩展，任何无关的 0 或 1 TRACE 设置将被直接忽略。

语法

下图显示 TRACE 命令的语法：

图 4-4 TRACE 命令语法

周围的文本说明了 图 4-4 。

参数

如图 4-4中所示，TRACE 命令包括以下参数：

LIst

（可选）指定显示当前跟踪设置。如果未指定命令参数，默认值为 LIst。

trace_setting

（可选）将指定的所需跟踪设置表示为一系列 '0' 和 '1' 字符。0 表示所需的位置跟踪设置应为 OFF 或禁用，而 1 表示所需的位置跟踪设置应为 ON 或启用。指定的值将完全替换当前跟踪设置，不会与其合并。位置跟踪设置如下所述：

  • 1－跟踪错误到跟踪文件。

  • 01－跟踪 TCP/IP 函数和事件到跟踪文件。

  • 001－跟踪 PGMI 或 ACSAPI 函数和事件到跟踪文件。

  • 0001－跟踪其他未分类的 XAPI 服务器事件到跟踪文件。

  • 00001－跟踪 malloc() 和 free() 事件到跟踪文件。

  • 000001－跟踪 XML 解析器事件到跟踪文件。

  • 0000001－跟踪命令服务器进程事件到跟踪文件。

  • 00000001－跟踪监视器进程事件到跟踪文件。

  • 000000001－跟踪 CSV 函数和事件到跟踪文件。

OFF

（可选）指定禁用跟踪。此参数与 TRACE 0 等效。

示例

在下面的示例中，用户发出 TRACE 命令以将 XAPI 服务器设置为跟踪所有错误及所有 malloc() 和 free() 事件到跟踪文件：

XCMD TRACE 10001