5 oVTCS 操作注意事项

本章介绍 oVTCS（在 VSM 控制台服务器上运行的 VTCS 版本）的软件注意事项。

oVTCS 功能

oVTCS 表示 StorageTek Virtual Tape Control Software (VTCS) 发行版 7.3，它已定制为在 Solaris 操作环境中的 VSM 控制台上操作。oVTCS 执行以下功能：

  • 影响虚拟磁带机 (Virtual Tape Drive, VTD) 的分配。

    虚拟磁带存储子系统 (Virtual Tape Storage Subsystem, VTSS) 是包含虚拟卷 (virtual volume, VTV) 和传送装置的 VSM 磁盘缓冲区。VTSS 是具有微代码的磁盘设备，可用于模拟 32 或 64 个传送装置。该设备可以从磁盘读取/向磁盘写入“磁带”数据，也可以从 RTD 读取/向 RTD 写入数据。

    虚拟磁带机 (Virtual Tape Drive, VTD) 是 VSM 的虚拟磁带存储子系统 (Virtual Tape Storage Subsystem, VTSS) 中模拟物理盒式磁带的传送装置。写入到 VTD 中的数据会被实际写入到磁盘中。VTSS 包含 64 个可以虚拟挂载 VTV 的 VTD。

  • 管理虚拟磁带卷 (Virtual Tape Volume, VTV) 的使用，包括迁移和撤回。

    • 迁移是指将数据从 VTSS 移动到实际磁带机 (Real Tape Drive, RTD)，通过后者将 VTV 堆叠到 MVC 上。

    • 撤回是指将 VTV 从 MVC 移回到 VTSS。VSM 可用于按需撤回 VTV。

  • 管理 VSM 所用的实际磁带介质和传送装置的使用。

定义 oVTCS 策略参数

本节介绍 oVTCS 策略参数文件以及如何在 VSM 控制台配置中激活此文件。

oVTCS 策略参数文件

在 VSM 控制台配置中，oVTCS 利用 oVTCS 策略参数文件来包括 oVTCS 配置的管理和存储类策略。在启动期间，oVTCS 检查 CDS 中 VTV 的状态，装入已定义的策略，并实施所需操作以便执行这些策略。

oVTCS 正在群集中运行时，此参数文件会自动分发到每个节点。重新启动后，文件设置也持续存在。

初始装入此参数文件所用的方法取决于您的配置。

必需的语句

oVTCS 策略参数文件必须包括以下每个语句的至少一个实例：

注:

除了 TAPEPLEX 外，以下语句与 ELS 用法密切匹配。有关这些语句的更多信息，请参阅 Oracle StorageTek ELS 出版物。
POOLPARM

这些语句描述了 oVTCS 实例的暂存池和 MVC 池。

注:

在共享 CDS 模式下，不使用 CDS 中的 POOLPARM 语句。
VOLPARM

这些语句定义各种 volser 范围的属性，并将其分配给 POOLPARM 语句。它们与此语句的 ELS 用法密切匹配，不同之处仅在于更改 VOLPARM 语句并不更新 oVTCS 配置。

STORCLAS

这些语句定义存储类。存储类是存储属性的命名列表，这些属性标识数据集的性能目标和可用性要求。

MGMTCLAS

这些语句定义管理类。管理类是管理属性的集合，管理属性由存储管理员分配，用于控制数据集对空间的分配和使用。

TAPEPLEX

这些语句定义 ACSLS、HSC 和 VLE 的其他实例的网络联系人详细信息。如果 VSM 控制台具有要迁移到的 RTD，则 TAPEPLEX 语句是必需的，而不管 TAPEPLEX 的类型（ACSLS、HSC 或 VLE）如何。

如果 VSM 控制台可以迁移到多个系统，则每个系统需要单独的 TAPEPLEX 语句。

TAPEPLEX 语句的格式如下所示：

TAPEPLEX NAME=tapeplex_name SERVer(server [,server] [,server] [,server]) [SUBSYS=subsystem_name]

其中：

  • NAME 指定分配给 TapePlex 的名称。这可以是 ACSLS、HSC 或 VLE 系统，且必须与目标 ACSLS、HSC 或 VLE 分配的 TapePlex 名称匹配。

  • SERVer 指定已命名 TapePlex 的一个或多个服务器路径。可以指定主机名或 IP 地址。

  • SUBSYS 指定 HSC MVS 子系统的名称，仅当目标 TapePlex 为 HSC 且仅当在同一 MVS 主机上存在多个 HSC 子系统时才是必需的。

以下是 HSC 系统的 TAPEPLEX 语句的示例，其中 SERVer 参数指定主机名：

TAPEPLEX NAME=HSCVTCS SERV(host-name)

或者，SERVer 参数可以指定 IP 地址来代替 host-name。

以下是多节点 VLE 系统的 TAPEPLEX 语句的示例，其中 SERVer 参数指定每个节点的 IP 地址：

TAPEPLEX NAME=VLE1 SERV(ip_address1, ip_address2, ip_address3)

在此类型的配置中，您可能需要对单个 VLE 节点执行维护。SMC SERVer DISable 命令不受 VSM 控制台支持。取而代之的是，您必须使用以下过程：

  1. 在 oVTCS 策略参数文件中，更新 TAPEPLEX 语句以删除需要维护的节点的 IP 地址。

  2. 对更新后的参数文件发出 oVTCS MGMTDEF ACTIVATE 命令。

  3. 对已删除的节点执行维护。

  4. 更新 TAPEPLEX 语句以重新添加节点 IP 地址。

  5. 发出 oVTCS MGMTDEF ACTIVATE 命令以装入更新后的参数文件。

可选的语句

oVTCS 参数文件可以选择包括以下语句：

注:

以下语句与 ELS 用法密切匹配。有关这些语句的更多信息，请参阅 Oracle StorageTek ELS 出版物。
OPTION

此语句指定文件的标识字符串（名称）。

MIGRSEL

这些语句指定用于管理从 VTSS 到存储类的迁移的迁移请求设置。

MIGRVTV

这些语句指定由立即迁移处理的单个 VTV 副本的迁移请求设置。

MVCATTR

这些语句将交换目标 RTD 设备类型分配给 MVC 介质名称。在 RTD 上读取 MVC 的过程中出现错误时，VTCS 可能将 MVC 交换到其他 RTD 以重试操作。

STORLST

这些语句指定存储类及其对应优先级列表。

STORSEL

这些语句指定适用于在引用的 STORLST 控制语句上指定的存储类列表及其优先级的存储类用法规则。

VTSSLST

这些语句指定 VTSS 及其对应优先级的列表。

VTSSSEL

这些语句指定适用于在引用的 VTSSLST 控制语句上指定的 VTSS 列表及其优先级的存储类用法规则。

CMDEXEC

这些语句定义要在启动时或者每次装入参数文件时要执行的命令。它提供 ELS 启动命令文件的等效项。

在大型机配置中装入 oVTCS 策略参数文件

要在大型机配置中激活 oVTCS 策略参数文件，请使用 SMC SMCUUUI 实用程序发出 oVTCS MGMTDEF 命令。

oVTCS MGMTDEF 命令

oVTCS MGMTDEF 命令激活 oVTCS 策略参数文件。

从 SMCUUUI 实用程序，在 UUIIN SDD 语句中指定 oVTCS 参数文件的名称，以及包含 ACTIVATE 参数的 MGMTDEF 命令语句，如示例 5-1 中所示。

只要已指定全限定路径和文件名，oVTCS 参数文件就可以存在于任何位置。

有关 SMCUUUI 实用程序的信息，请参阅《ELS Command, Control Statement, and Utility Reference》。

注:

oVTCS MGMTDEF 命令是本机 oVTCS 命令，与 SMC MGMTDEF 命令无关。
语法

图 5-1 显示了 oVTCS MGMTDEF 命令语句的语法：

图 5-1 oVTCS MGMTDEF 命令语法

周围的文本说明了 图 5-1 。
参数

如图 5-1 中所示，oVTCS MGMTDEF 命令包括以下参数：

ACTIVATE

（可选）验证包含在指定的 oVTCS 参数文件中的参数，然后激活这些参数设置。

注:

如果不指定 ACTIVATE 参数，则仅验证包含在指定的 oVTCS 参数文件中的参数。
LIST

（可选）列出从 oVTCS 参数文件读取的参数。

示例

以下示例显示了带有 ACTIVATE 参数的 MGMTDEF 命令，如 SMCUUUI 实用程序 UUIIN 语句中指定的那样：

示例 5-1 MGMTDEF ACTIVATE 命令

//UUIIN    DD  *
    SDD DDNAME(INPARMS) INPUT TEXT
    MGMTDEF ACTIVATE

在上面的示例中，MGMTDEF ACTIVATE 命令指示验证和激活名为 INPARMS 的 oVTCS 参数文件。

在 VSM 7 开放系统连接配置中装入 oVTCS 策略参数文件

要在 VSM 7 开放系统连接配置中激活 oVTCS 策略参数文件，请使用随 VSM 控制台提供的 VSM GUI：

  1. 启动 VSM GUI 应用程序。

  2. 访问 VSM 控制台菜单。此菜单包括以下选项：

    • Command Line Interface (CLI)

    • Configuration/Policy

    • Console Log

  3. 选择 VSMc Configuration/Policy 选项卡。通过此页面可以下载、编辑和上载定义 oVTCS 策略设置的 oVTCS 策略文件。

  4. 从菜单中选择 TapePlex name。

  5. 从菜单中选择 server address。仅列出为选定的 TapePlex 配置的服务器地址。

  6. 单击 Download 按钮以指定策略参数文件并将其装入到 VSM GUI 中。

  7. 单击 Edit 按钮以对文件进行任何所需的编辑。

  8. 单击 Upload 按钮以激活指定 oVTCS TapePlex 中的文件。

有关使用 VSM 控制台菜单装入配置设置的更多详细信息，请参阅 VSM GUI 用户指南。

oVTCS 命令注意事项

以下列表介绍了 oVTCS 命令注意事项：

  • 不支持 CDS 日志记录。因此，LOGPOL 参数在 CONFIg GLOBAL 语句中无效。

  • 如果使用 SMC 7.3，则必须通过将 SMC HTTP 命令的 XSECurity 参数设置为 OFF 来禁用 XAPI 安全。这样，连接到 HSC 的 RTD 就可以联机。

    有关 SMC HTTP 命令的信息，请参阅《ELS Command, Control Statement, and Utility Reference》。

  • oVTCS 包括本机 MGMTDEF 命令，通过该命令可以在大型机配置中激活 oVTCS 策略参数文件。此命令与 ELS MGMTDEF 命令无关。有关更多信息，请参见在大型机配置中装入 oVTCS 策略参数文件。

  • 必须使用 CONFIg VTVVOL 和 CONFIg MVCVOL 语句才能将 VTV 或 MVC 添加到 CDS。不能使用 POOLPARM 或 VOLPARM 方法。

    可以将 POOLPARM 和 VOLPARM 用于 SUBPOOL 命名，但是必须使用 CONFIg VTVVOL 和 CONFIg MVCVOL 来定义卷。

    有关 POOLPARM 和 VOLPARM 控制语句的信息，请参阅《ELS Command, Control Statement, and Utility Reference》。

    有关 CONFIg VTVVOL 和 CONFIg MVCVOL 控制语句的更多信息，请参阅《ELS Legacy Interfaces Reference》。

  • 从 SMCUUUI 实用程序发出挂载时，请使用以下约定：

    • 必须指定完整的 MOUNT 关键字。与 ELS 命令不同，不能缩写此关键字。

    • 将设备地址指定为 N、NAME 或 DRIVE_NAME=devaddr，其中 devaddr 是设备地址。

    • 将 volser 指定为 V、VOL 或 VOLSER=volser，其中 volser 是卷序列号或 SCRTCH。

    • 将子池指定为 P、POOL、SUBPOOL 或 SUBPOOL_NAME=subpool-name。

  • 从 SMCUUUI 实用程序发出卸载时，请使用以下约定：

    • 可以指定完整的 DISMOUNT 关键字或者缩写的 DISM。

    • 将设备地址指定为 N、NAME 或 DRIVE_NAME=devaddr，其中 devaddr 是设备地址。

    • 将 volser 指定为 V、VOL 或 VOLSER=volser，其中 volser 是卷序列号或 SCRTCH。

  • 在非共享 CDS 模式下处理磁带库：

    如果配置未在共享 CDS 模式下运行，则适用以下参数限制：

    • oVTCS 配置中的 RTD 语句必须包括 STORMNGR 参数。

    • 在 oVTCS 配置的 VTSS 语句中，DEFLTACS 参数只能采用默认值。

    • 在 STORCLAS 语句中，ACS 参数的使用需要 STORMNGR 参数。

    • 在 MGMTCLAS 语句中，不能使用 ACSLIST 参数。

    如果配置在共享 CDS 模式下运行，则所有磁带库将被视为“远程”，因此属于独立的 TapePlex。为默认磁带库的 TapePlex 的名称作为数据库配置的一部分提供。通常，此 TapePlex 还会提供 CDS。因此，上述限制不适用。

  • oVTCS TRace 命令仅包括两个选项：ON 和 OFF。

    • TRace ON 关闭所有的跟踪文件，并为所有正在运行的进程打开一个新的跟踪文件。这是建议的设置。

    • TRace OFF 停止所有跟踪。

    与 ELS TRace 命令不同，不能指定要跟踪的特定组件。

  • 使用 SMC VMSG 命令可获取 VSM 控制台消息

    有关此命令的更多信息，请参见启动/停止 VSM 控制台消息处理器。

  • 使用 HSC DBSERVER 命令可使 VSM 控制台能够共享 HSC CDS。

    有关此命令的更多信息，请参见运行 oVTCS CDS 数据库服务器。

  • 使用 SMC SMCUSMF 实用程序可从 VSM 控制台服务器卸载 SMF 类型的记录。

    有关此实用程序的更多信息，请参见卸载 VSM 控制台 SMF 记录。

  • 使用内部 MVS GETMGPOL 命令可返回活动 oVTCS 策略语句的列表：

    • 指定不带子参数的 GETMGPOL 命令可返回 oVTCS MGMTCLAS 和 STORCLAS 语句。

    • 指定 GETMGPOL MGMTCLAS 可返回 oVTCS MGMTCLAS 语句。

    • 指定 GETMGPOL STORCLAS 可返回 oVTCS STORCLAS 语句。

    • 指定 GETMPOL FLATDD(filename) 可返回所有的 oVTCS 策略语句。这将返回 oVTCS 参数文件的全部内容。

  • 在多节点中

oVTCS 操作员和管理员命令

oVTCS 包括一组操作员和管理员命令。这些命令相当于其 ELS VTCS 对应命令，但稍有不同，如oVTCS 命令注意事项中所述。

使用以下方法之一发出这些命令：

  • 在仅大型机配置中，使用 SMC Route 命令或 SMCUUUI 实用程序将命令从 SMC 客户机发送到 VSM 控制台上的 oVTCS。

    有关 SMC Route 命令和 SMCUUUI 实用程序的信息，请参阅《ELS Command, Control Statement, and Utility Reference》。

  • 在 VSM 7 开放系统连接 (Open Systems Attachment, OSA) 配置中，启动随 VSM 控制台提供的 VSM GUI 应用程序，并使用 VSMc 命令行界面 (Command Line Interface, CLI) 功能将命令发送到 VSM 控制台上的 oVTCS。有关使用此功能的信息，请参阅 VSM GUI 用户指南。

    1. 启动 VSM GUI 应用程序。

    2. 访问 VSM 控制台菜单。

    3. 选择 VSMc Command Line Interface (CLI) 选项卡。通过此页面可以下载、编辑和上载定义 oVTCS 策略设置的 oVTCS 策略文件。

    4. 选择 TapePlex 和相应的节点服务器地址。

    5. 在输入文本框中输入 oVTCS 命令，然后单击 Submit。

      命令将记录在命令日志和命令输出表中。

oVTCS 包括下面列出的命令。有关每个命令的信息，请参阅《ELS Command, Control Statement, and Utility Reference》。

  • ARCHive

  • AUDIT

  • CANcel

  • CONSolid

  • CONFIg

  • DEComp

  • DELETSCR

  • DISMount

  • Display

    • CMD

    • MSG

    • SERVer

    • ACTive

    • CLInk

    • CLUster

    • CONFIG

    • LOCKs

    • MIGrate

    • MVC

    • MVCPool

    • PATH

    • Queue

    • REPlicat

    • RTD

    • SCRatch

    • STORclas

    • STORMNgr

    • TASKs

    • VSCRatch

    • VTD

    • VTSS

    • VTV

  • DRMONitr

  • EEXPORT

  • EXPORT

  • INVENTRY

  • MEDVERfy

  • MERGMFST

  • METADATA

  • MIGrate

  • Mount

  • MVCDRain

  • MVCMAINT

  • MVCPLRPT

  • MVCRPt

  • RECall

  • RECLaim

  • RECONcil

  • SCRPT

  • SET MIGOPT

  • TRace

  • Vary (CLInk, PATH, RTD, VTSS)

  • VLEMAINT

  • VTVMAINT

  • VTVRPt

oVTCS XAPI 服务器组件操作员和管理员命令

VSM 控制台包括多个 XAPI 服务器操作员和管理员命令，通过这些命令可以管理在 VSM 控制台内操作的 XAPI 服务器组件。

使用以下方法之一发出这些命令：

  • 使用 xapi_startup_file 发出 XAPI 服务器命令

    xapi_start_file 是 XAPI 服务器命令的文件，在 XAPI 服务器启动期间会读取它。

    这是指定 XCLIENT 和 XUDB 定义以及 XSECURITY 和 MSGLVL 规范的首选方法。

    由于在启动时读取此文件，因此重新启动 XAPI 服务器组件时无需重新输入这些命令。

    VSM 控制台下 xapi_start_file 的默认路径是：/data/ovtcs/config/xapi_startup_file。

  • 使用 oVTCS_cli XCMD 界面发出 XAPI 服务器命令

    通过指定 'XCMD' 后跟 XAPI 服务器命令字符串，oVTCS_cli 界面可以用于将命令定向到 XAPI 服务器组件。

    例如，要使用 oVTCS_cli 输入 XAPI 服务器 'LOG 0011' 命令，请输入以下命令：

    oVTCS_cli ’ XCMD LOG 0011’

    这是在 StorageTek 软件支持人员指导下输入 XAPI 服务器 LIST 和 TRACE 命令的首选方法。

  • 使用 VSM GUI 发出 XAPI 服务器命令

    在 VSM 7 开放系统连接 (Open Systems Attachment, OSA) 配置中，可以使用 VSM GUI VSM 控制台命令行界面选项向 VSM 控制台发出 XAPI 服务器命令。

    有关使用 VSM 控制台菜单选项的信息，请参阅 VSM GUI 用户指南。

XCMD LIst 命令

XCMD LIst 命令显示 XAPI 服务器组件和环境设置。XCMD LIst 命令应主要在 StorageTek 软件支持人员指导下使用。

语法

图 5-2 显示了 XCMD LIst 命令的语法。

图 5-2 XCMD LIst 命令语法

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

参数

如图所示，XCMD LIst 命令包括以下参数：

ALl

（可选）显示所有 XAPI 服务器参数和环境变量。ALl 是未在 LIst 命令上指定参数时的默认参数。

CB NNNN 或 NNNN-IIII

（可选）以字符十六进制形式列出命名的 (NNNN) XAPI 服务器控制块。名称 (NNNN) 或名称索引 (NNNN-IIII) 组合如下：

  • HTTPCVT 指示主 XAPI 服务器共享段。

  • HTTPGBL 指示 XAPI 服务器全局定义。

  • HTTPREQ-nnn 指示 XAPI 服务器请求块。

  • HTTPAPI-nnn 指示 XAPI 服务器 API 请求块。

  • XCLIENTTABLE 指示 XAPI 服务器 XCLIENT 共享段。

  • XUDBTABLE 指示 XAPI 服务器 XUDB 共享段。

FILEs

（可选）列出 XAPI 服务器文件路径。

HISTory

（可选）列出过去 24 小时的 XAPI 服务器接受历史记录。

LOG

（可选）列出 XAPI 服务器 LOG 设置。

MAXCLients

（可选）列出 XAPI 服务器 MAXCLients 设置。

MSGLvl

（可选）列出 XAPI 服务器 MSGLvl 设置。

SERVer

（可选）列出相关的 UNIX 系统发行版和资源限制，以及 XAPI 服务器发行版、版本和环境设置。

PROcess

使用 LIst SERVer 指定时，PROcess 关键字可以选择列出各个 XAPI 系统进程。

TAPEPlex

（可选）列出 XAPI 服务器 TapePlex 名称。

TASKs

（可选）列出 XAPI 服务器系统和工作任务及其执行统计信息。

TRace

（可选）列出 XAPI 服务器 TRace 设置。

XApi

（可选）列出相关的 XAPI 服务器 TCP/IP 参数

IO 或 I/O

使用 LIst XApi 指定时，IO（或 I/O）关键字可以选择列出 XAPI 服务器 TCP/IP 统计信息。

XCLIent

（可选）列出 XAPI 服务器 XCLIent 定义。

XSECurity

（可选）列出 XAPI 服务器 XSECurity 设置。

XUDB

（可选）列出 XAPI 服务器 XUDB 定义。

XCMD LOG 命令

XCMD LOG 命令显示或更改 XAPI 服务器日志设置。XAPI 服务器日志记录可以选择允许将 TCP/IP 请求、TCP/IP 响应、XAPI 服务器操作员命令、控制台消息和错误写入 XAPI 服务器日志文件。XCMD LOG 命令应主要在 StorageTek 软件支持人员指导下使用。

语法

图 5-3 显示了 XCMD LOG 命令的语法。

图 5-3 XCMD LOG 命令语法

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

参数

如图所示，XCMD LOG 命令包括以下参数：

LIst

（可选）显示 XAPI 服务器日志设置。LIst 是未在 LOG 命令上指定参数时的默认参数。

OFF

（可选）关闭所有的 XAPI 服务器日志事件。

1 或 0

（可选）关闭或打开单个 XAPI 服务器日志事件。可以输入多达 16 个 "0" 和 "1" 字符的字符串。"1" 打开日志事件，"0" 关闭日志事件。输入的字符串中的位置控制单个日志事件，如下所示：

  • 1000000000 将 XAPI 服务器错误消息记录到 stdout

  • 0100000000 将 XAPI 服务器消息记录到日志文件

  • 0010000000 将 XAPI 输入请求错误记录到日志文件

  • 0001000000 将 XAPI recv 数据包记录到日志文件

  • 0000100000 将 XAPI send 数据包记录到日志文件

  • 0000010000 将 XCMD 命令和响应记录到日志文件

注:

  • 目前，字符串位置 7-16 不控制任何 XAPI 服务器日志设置。如果输入了长度大于 6 个字符（但是小于 17 个字符）的字符串，则对字符进行验证，但是随后将其忽略。

  • LOG 0 相当于 LOG OFF。

  • 任何已输入的设置将完全替换之前的日志设置：因此，如果之前是 LOG 010001，而后输入 LOG 00011，则根据第二个 LOG 命令，XAPI 消息以及 XCMD 命令和响应都不会记录到日志文件。

  • 可以使用环境变量 SMCVLOGFILE（如果在 XAPI 服务器启动之前已指定）覆盖默认的 XAPI 服务器日志文件路径。

  • 要显示 XAPI 服务器日志文件的位置和名称，请输入 XCMD LIST FILES 命令。

  • 可以使用环境变量 SMCVLOG（如果在 XAPI 服务器启动之前已指定）设定 XAPI 服务器日志设置。

示例

在以下示例中，LOG 命令将 XAPI recv 和 send 数据包都记录到日志文件：

LOG 00011

XCMD MAXCLients 命令

XCMD MAXCLients 命令用于设置在任何一个时间可处于活动状态的并发请求数的上限。达到 MAXCLients 限制时，XAPI 服务器收到的任何新的客户机请求都会收到 '503 Service unavailable' 响应，而且应该由客户机重试。

语法

图 5-4 显示了 XCMD MAXCLients 命令的语法。

图 5-4 XCMD MAXCLients 命令语法

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

参数

如图所示，XCMD MAXCLients 命令包括以下参数：

LIst

（可选）显示 XAPI 服务器 MAXCLients 设置。LIst 是未在 MAXCLients 命令上指定参数时的默认参数。

NNNN

（可选）指定最大并发请求数。请输入介于 1 和 1000 之间的数字。

XCMD MSGLvl 命令

XAPI 服务器 MSGLvl 命令用于确定输出到 stdout 的消息。每个 XAPI 服务器消息具有固定的 MSGLvl。XAPI 服务器 MSGLvl 大于消息 MSGLvl 时，会输出消息，否则将其禁止。因此 XAPI 服务器 MSGLvl 越高，XAPI 服务器消息就越详细。

语法

图 5-5 显示了 XCMD MSGLvl 命令的语法。

图 5-5 XCMD MSGLvl 命令语法

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

参数

如图所示，XCMD MSGLvl 命令包括以下参数：

LIst

（可选）显示 XAPI 服务器 MSGLvl 设置。LIst 是未在 MSGLvl 命令上指定参数时的默认参数。

NN

（可选）指定 XAPI 服务器 MSGLvl。输入一个介于 0 和 32 之间的数字，如下所示：

  • 0－仅显示启动/关闭消息和错误消息。

  • 4－显示警告消息

  • 8－显示其他系统状态消息

  • > 8－显示调试消息；仅在 StorageTek 软件支持人员指导下使用。

XCMD TRace 命令

XCMD TRace 命令显示或更改 XAPI 服务器跟踪设置。XAPI 服务器跟踪可以选择启用 XAPI 服务器组件跟踪事件。XCMD TRace 命令应仅在 StorageTek 软件支持人员指导下使用。

语法

图 5-6 显示了 XCMD TRace 命令的语法。

图 5-6 XCMD TRace 命令语法

周围的文本说明了 图 5-6 。

参数

如图所示，XCMD TRace 命令包括以下参数：

LIst

（可选）显示 XAPI 服务器跟踪设置。LIst 是未在 TRace 命令上指定参数时的默认参数。

OFF

（可选）关闭所有的 XAPI 服务器跟踪事件。

1 或 0

（可选）关闭或打开单个 XAPI 服务器跟踪事件。可以输入多达 16 个 "0" 和 "1" 字符的字符串。"1" 打开跟踪事件，"0" 关闭跟踪事件。输入的字符串中的位置控制单个跟踪事件，如下所示：

  • 1000000000 跟踪 XAPI 错误

  • 0100000000 跟踪 XAPI TCP/IP 组件事件

  • 0010000000 跟踪 PGMI API 组件事件

  • 0001000000 跟踪 XAPI 服务器线程事件

  • 0000100000 跟踪 XAPI 服务器 malloc() 和 free() 事件

  • 0000010000 跟踪 XAPI 服务器 XML 解析事件

  • 0000001000 跟踪 XAPI 服务器命令事件

  • 0000000100 跟踪 XAPI 服务器系统监视

  • 0000000010 跟踪 XAPI 服务器 XML、CSV 和文本输出组件事件

  • 0000000001 跟踪 XAPI 服务器逻辑文件事件

注:

  • 目前，字符串位置 11-16 不控制任何 XAPI 服务器跟踪设置。如果输入了长度大于 11 个字符（但是小于 17 个字符）的字符串，则对字符进行验证，但是随后将其忽略。

  • 输入 TRACE 0 相当于输入 TRACE OFF。

  • 任何已输入的设置将完全替换之前的跟踪设置：因此，如果之前是 TRACE 010001，而后输入 TRACE 00011，则根据第二个 TRACE 命令，不会将 TCP/IP 组件事件以及 XAPI 服务器 malloc() 和 free() 事件跟踪到 XAPI 服务器跟踪文件。

  • 可以使用环境变量 SMCVTRCFILE（如果在 XAPI 服务器启动之前已指定）覆盖默认的 XAPI 服务器跟踪文件路径。

  • 要显示 XAPI 服务器跟踪文件的位置和名称，请输入 XCMD LIST FILES 命令。

  • 可以使用环境变量 SMCVTRACE（如果在 XAPI 服务器启动之前已指定）设定 XAPI 服务器跟踪设置。

示例

在以下示例中，TRace 命令将 XAPI 服务器线程和进程事件以及 XAPI 服务器 malloc() 和 free() 事件跟踪到 XAPI 服务器跟踪文件：

TRace 00011

XCMD XCLIent 命令

XAPI 服务器 XCLIent 命令用于定义使用与默认服务器 XAPI 协议不同的协议版本的 XAPI 客户机。

注:

  • 仅当已启用 XAPI 安全 (XSECurity ON) 时，才需要使用 XCLIent 命令定义使用较旧“不安全”协议的客户机。如果指定了 XSECurity ON，则将源自未使用 XCLIent 命令定义的客户机的任何 XAPI 请求假定为使用较新的 XAPI 安全协议。

  • 如果指定了 XSECurity OFF，则不需要 XCLIent 定义。

语法

图 5-7 显示了 XCMD XCLIent 命令的语法。

图 5-7 XCMD XCLIent 命令语法

周围的文本说明了 图 5-7 。

参数

如图所示，XCMD XCLIent 命令包括以下参数：

LIst

（可选）显示 XAPI 服务器 XCLIent 定义。LIst 是未在 XCLIent 命令上指定参数时的默认参数。

HOst HHHHHHHH

（可选）指定客户机所驻留的 IP 解析器主机名 (HHHHHHHH)。HOst 名称必须是 TCP/IP 名称表中的可解析名称。适用下列规则：

  • 值的长度必须在 1 到 255 个字符之间。

  • 第一个字符必须是字母字符或数字。

  • 最后一个字符必须是字母字符或数字。

  • 首末字符之间的所有字符都必须为字母字符、数字、连字符或点。

IPaddress NN.NN.NN.NN

（可选）指定客户机的 IP 地址 (NN.NN.NN.NN)。

NAme CCCCCCCC

（可选）指定客户机的名称 (CCCCCCCC)。如果客户机是 SMC/MVS，则指定的 NAme 应该是返回为 <client_subsystem_name> 的名称。否则，指定的 NAme 应该是返回为 <client_name> 的名称。如果将 NAme 指定为 '*'，则来自指定的 HOst 或 IPaddress 的任何请求都将定义为使用指定的协议版本。

PORTrange NN-NN

（可选）指定在允许使用指定的协议版本的特定 HOst 或 IPaddress 上 XAPI 请求源自的客户机端口的范围 (NN-NN)。有效端口为 1 到 65535，端口范围可以包含的端口数介于 10 和 1000 之间。

PROTver [0|1]

（可选）指定协议版本。

  • "0" 指示较旧的“不安全”协议。

  • "1" 指示新的 XAPI 安全协议版本。默认值为 0。

注:

  • HOst 和 IPaddress 互斥。

  • NAme 和 PORTrange 互斥。

  • 如果 SMC/MVS TCPIP PORTrange 命令已指定为将 SMC/MVS 客户机端口限制到指定的范围，则应该使用 PORTrange。

XCMD XSECurity 命令

XAPI 服务器 XSECurity 命令用于对 XAPI 服务器全局启用或禁用 XAPI 安全协议。

如果启用了 XAPI 安全协议，则对 XAPI 服务器收到的任何请求强制实施用户密码安全性。

注:

  • 如果全局启用了 XAPI 安全，则可以将单个客户机从 XAPI 安全中“免除”（如果在 XCLIent 定义中指定了它们）。

  • 如果全局启用了 XAPI 安全，则必须在客户机和服务器上定义相同的用户和密码。XAPI 安全用户和密码通常使用 XUDB 定义进行指定，但是，请参见 Virtual Storage Manager 控制台 (Virtual Storage Manager console, VSMc) 下 XUDB 命令中有关 XAPI 安全用户的说明。

语法

图 5-8 显示了 XCMD XSECurity 命令的语法。

图 5-8 XCMD XSECurity 命令语法

周围的文本说明了 图 5-8 。

参数

如图所示，XCMD XSECurity 命令包括以下参数：

LIst

（可选）显示 XAPI 服务器 XSECurity 设置。LIst 是未在 XSECurity 命令上指定参数时的默认参数。

ON

（可选）启用 XAPI 安全。

OFF

（可选）禁用 XAPI 安全。

XCMD XUDB 命令

XAPI 服务器 XUDB 命令用于添加、更新、删除和列出 XAPI 安全用户。XAPI 安全用户列表由客户机和服务器维护。

注:

  • 必须在客户机和服务器上定义相同的 XUDB USER。

  • 如果指定了 XSECurity OFF，则不需要 XUDB 定义。

语法

图 5-9 显示了 XCMD XUDB 命令的语法。

图 5-9 XCMD XUDB 命令语法

周围的文本说明了 图 5-9 。

参数

如图所示，XCMD XUDB 命令包括以下参数：

LIst

（可选）显示 XAPI 服务器 XUDB 定义。LIst 是未在 XUDB 命令上指定参数时的默认参数。

ADD

指定要将指定用户名和密码添加到 XAPI 安全用户列表。

USER UUUUUUUU

指定要添加的名称。只要在客户机和服务器中定义了相同的名称和密码，则 USER 名称不需要是已定义的 UNIX 用户名。USER 名称的长度最大可以为 20 个字符。

PASSWORD PPPPPPPP

为指定的 USER 指定密码。PASSword 的长度最大可以为 20 个字符。

UPDate

指定使用指定的 PASSword 更新 XAPI 安全用户列表中的指定用户名。

USER UUUUUUUU

指定要更新的名称。

PASSWORD PPPPPPPP

为指定 USER 指定新密码。

DELete

指定在 XAPI 安全用户列表中删除指定的用户名。

USER UUUUUUUU

指定要删除的名称。

LIst

指定 XAPI 安全用户列表中要列出的指定用户名。

USER UUUUUUUU

指定要列出的名称。如果未指定 USER，则列出所有名称。

注:

  • XAPI 服务器是虚拟存储管理控制台 (Virtual Storage Management console， VSMc) 的组件时，XAPI 服务器会使用 VSM 控制台工具来添加、更新和删除 XAPI 安全用户。虽然可以在 VSM 控制台上发出 XUDB ADD 命令，但是建议您使用 VSM 控制台 TUI 维护 XAPI 安全用户。

  • 如果在 VSM 控制台上发出 XUDB ADD、UPDate 或 DELete 命令，则更新 VSM 控制台用户数据库。

  • 在 VSM 控制台中，XUDB LIST 命令将仅规定在 VSM 控制台用户数据库中维护用户。

查看 oVTCS 控制台日志

通过随 VSM 控制台提供的 VSM GUI，可以查看正在运行的系统日志以了解从每个 VSM 控制台服务器上运行的 oVTCS 实例生成的控制台操作员消息。

要查看控制台日志，请执行以下操作：

  1. 启动 VSM GUI 应用程序。

  2. 访问 VSM 控制台菜单。

  3. 选择 Console Log 选项卡。

  4. 从 Tapeplex 菜单中选择 Tapeplex，使用来自该 Tapeplex 的消息填充控制台日志。

显示了以下三种类型的消息：

  • WTO（写给操作控制台的消息）

  • WTOR（带回复的 WTO）

  • HILITE（突出显示的 WTO）

在 "Console Log" 页上有两个表：

  • "WTORs and HILITEs" 表列出了选定 TapePlex 的 WTOR 和 HILITE 消息。消息按时间顺序显示，并按消息类型排序，最新的消息位于底部。

    某些字段包括上下文菜单指示符。右键单击这些字段可访问上下文菜单，通过该菜单可以执行操作，其中包括回复 WTOR 消息或删除消息。

  • "Log" 表列出了 WTO 消息以及已回复或删除的 WTOR 和 HILITE 消息。消息按时间顺序显示，并按消息类型排序，最新的消息位于底部。

有关使用 VSM 控制台的 "Console Log" 的更多详细信息，请参阅 VSM GUI 用户指南。