6 VM Client 命令

本章介绍 VM Client 操作员命令以及用于发出命令的方法。

发出 VM Client 命令

使用以下方法发出 VM Client 命令：

• 在 SMCPARMS 或 SMCCMDS 文件中指定启动时要处理的 VM Client 命令。有关更多信息，请参见VM Client 命令文件。

• 使用 CP 特殊消息 (Special Message, SMSG) 工具将 VM Client 命令发送到 VM Client 服务机。

  从任何有权发出命令的虚拟机向 VM Client 服务机发出以下命令：

  CP SMSG userid command-string
  

  其中：

  • userid 是在 CP 目录中定义的 VM Client 服务机的名称。

  • command-string 是包含任何有效 VM Client 命令的字符串。

• 登录 VM Client 服务机并从连接的控制台发出命令。

VM Client 命令

此部分介绍 VM Client 命令。

AUTHorize

AUTHorize 命令用于标识得到授权可以执行 TMI 和 VM Client 命令请求的 VM 用户 ID。此命令还可用于删除之前定义的授权条目。

注:

• 提供了客户出口 SMCXIT01 以向 VM Client 添加覆盖授权功能。如果未经授权的 VM 用户 ID 执行 VM Client 命令或 TMI 请求，则可使用 SMCXIT01 出口覆盖缺少匹配的 AUTHorize 命令的情况并提供必要的授权。

• VM Client 安装中不包含默认的 SMCXIT01 EXEC 可执行文件。

• 有关客户出口 SMCXIT01 示例和安装说明，请参见分发的 SMCXIT01.samp 文件。

语法

下图展示了 AUTHorize 命令的语法：

图 6-1 AUTHorize 命令语法

参数

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

LIst

（可选）列出当前所有 AUTHorize 映射。

• LIst 是未指定其他参数时的默认参数。

• LIst 可与其他参数一起指定。与其他参数一起指定时，将在处理了所有其他参数之后再应用 LIst。

ID(VM-userid_list)

（可选）指定要授权的 VM 用户 ID，即 VM-userid-list 中所指示的 ID。

OFF ID(VM-userid-list)

（可选）为 VM-userid-list 中指定的 VM 用户 ID 删除 AUTHorize 条目。参数值为 "*" 时将删除所有 AUTHorize 条目。

REQuest(CMD|TMI|ALL)

（可选）指定要授予或删除的 VM Client 特权。此参数可以与 ID 或 OFF ID 参数一起指定。必须指定以下值之一或全部：

• CMD 指示通过 SMSG 接口接收的 Authorize 命令请求。

• TMI 指示 Authorize 磁带管理接口 API 请求。

• ALL 指示 Authorize CMD 或 TMI 请求。如果未指定 REQuest，则默认为该值。

示例

在以下示例中，AUTHorize 命令授权用户 ID VMTAPE 执行 TMI 请求，并列出所有 AUTHORIZE 条目：

AUTH REQ(TMI) ID(VMTAPE) LIST

CMS

CMS 命令用于在不离开 VM Client 的情况下将命令传送至 VM CMS（Conversational Monitor System，对话监视系统）程序环境。

语法

下图展示了 CMS 命令的语法。

图 6-2 CMS 命令语法

参数

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

cmdparm

任何有效的 CMS 命令和参数字符串。

示例

在以下示例中，CMS 命令指定查询生效的文件定义：

CMS QUERY FILEDEF

COMMtest

COMMtest 命令用于测试到一个或多个服务器的通信路径，方法为：对指定的通信路径执行 QUERY SERVER 命令并汇总结果。

语法

下图展示了 COMMtest 命令的语法：

图 6-3 COMMtest 命令语法

参数

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

TAPEPlex(name)

（可选）指定用于通信测试的 TapePlex。如果不指定此参数，则为所有未禁用的 TapePlex 测试通信。

name 是通过 VM Client TAPEPlex 命令定义的 TapePlex 名称。适用下列规则：

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

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

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

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

可以指定以下子参数：

SERVer(name)

（可选）指定用于通信测试的服务器路径。如果不指定此参数，则为指定的 TapePlex 的所有未禁用的服务器路径测试通信。

name 是通过 VM Client SERVer 命令定义的服务器路径名称。适用下列规则：

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

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

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

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

ANYSTATus

（可选）为所有通信路径测试通信，包括由操作员命令或通过 VM Client 禁用的路径。

PORTrange(nnnn|nnnn-nnnn)

（可选）指定按照指定的端口或端口范围为远程服务器路径测试通信。指定的 PORTrange 可以不同于 TCPip PORTrange 指定内容，以便允许测试防火墙设置。

nnnn 或 nnnn-nnnn 是要用于通信的端口号或端口号范围。每个端口号可以为 1-65535 中的一个值。但是，可指定的最大端口号范围是 100 个端口（ 例如，6401-6500）。如省略了端口号，则使用 TCPip PORTrange 中定义的端口。如果未定义此类端口，则使用任意临时端口。如果指定了端口范围，则在每个端口号上尝试通信。

REPEAT(nnnnn)

（可选）指定通信测试的重复次数。nnnnn 的有效值为 1 至 99999。

示例

在以下示例中，用户发出 COMMtest 命令以使用 SERVer PATHHSC1 测试到 TapePlex PRODHSC1 的通信路径，并重复 XAPI QUERY SERVER 通信操作 100 次。

COMMTEST TAPEPLEX(PRODHSC1) SERVER(PATHHSC1) REPEAT(100)

CP

CP 命令用于在不离开 VM Client 的情况下将命令传送至 VM CP（Control Program，控制程序）环境。

语法

下图展示了 CP 命令的语法：

图 6-4 CP 命令语法

参数

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

cmdparm

任何有效的 CMS 命令和参数字符串。

示例

在以下示例中，CP 命令指定查询生效的 CPLEVEL 属性。

CP QUERY CPLEVEL

DISMount

DISMount 命令从磁带机中卸载卷。

语法

下图展示了 DISMount 命令的语法：

图 6-5 DISMount 命令语法

参数

如图 6-5中所示，DISMount 命令包括以下参数：

DRive(uuuu)

指定要从中卸载卷的传送装置的磁带机地址。此参数是必需参数。

uuuu 磁带机地址。如果使用 DRIVEMAP 命令，则这是 CLIENT 地址。请参见DRIVemap。

VOLser(vvvvvv)

指定要从中卸载卷的传送装置的磁带机地址。此参数是必需参数。

vvvvvv 是磁带机地址（卷序列号）。

FORCE

（可选）指定要在卸载卷之前卸下的设备。此参数对虚拟磁带机无效。

示例

在以下示例中，DISMount 命令从磁带机 2900 卸载卷 AAA001。

DISMOUNT DRIVE(2900) VOLSER(AAA001)

Display DRive

Display DRive 命令可用于请求 VM Client 磁带机属性和 TapePlex 所有权信息。

语法

下图展示了 Display DRive 命令的语法：

图 6-6 Display DRive 命令语法

参数

如图 6-6中所示，Display DRive 命令包括以下参数：

devnum、devnum-range 或 devnum-list

指示要显示的设备编号、设备编号范围或设备编号列表。每个设备编号必须是有效的十六进制地址，采用 ccuu 格式。如果使用 DRIVEmap 命令，则这将是 CLIENT 地址。

TAPEPlex(name)

（可选）仅列出指定 TapePlex 拥有的设备。如果不指定此参数，则显示所有 TapePlex 拥有的设备。

name 是 TapePlex 名称。适用下列规则：

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

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

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

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

此外，还可以加入 ALL、Real 或 Virtual 参数以控制显示的 TapePlex 的类型。

ALL

（可选）列出 SMC 定义的 TapePlex 拥有的所有设备。如果不指定参数，则此参数为默认参数。

Real

（可选）仅列出所有定义的 TapePlex 拥有的“真实”设备（即非虚拟设备）。

Virtual

（可选）仅列出所有定义的 TapePlex 拥有的虚拟设备。

IDentity

（可选）显示标识磁带机序列号的信息。

示例

在以下示例中，Display DRive 命令仅列出 VM Client 已知的“真实”（即非虚拟）设备：

DISPLAY DRIVE REAL

Display RC

Display RC 命令可用于显示有关 SMC 返回/原因代码或者 HSC/VTCS UUI 原因代码的含义的信息。

语法

下图展示了 Display RC 命令的语法：

图 6-7 Display RC 命令语法

参数

如图 6-7中所示，Display RC 命令包括以下参数：

X 或 HEX

（可选）指定以十六进制数字形式指定原因/返回代码值或范围。

nnnn 或 nnnn-nnnn

（可选）指示要为其显示说明的返回代码或返回代码列表。

• 如果指定了 X 或 HEX，则值可以包含十六进制字符 0-9 及 A-F。

• 如果不指定 X 或 HEX，则值只能包含数字字符。

ALL

（可选）指示要列出所有定义的返回代码或原因代码。ALL 仅允许通过实用程序使用。

注:

ALL 和 X/HEX 互斥。

DETail

（可选）指示要列出有关所请求的代码的详细信息。

示例

在以下示例中，Display RC 命令显示 SMC 返回代码 302 的信息：

DISPLAY RC 302

Display Volume

Display Volume 命令可用于请求卷属性和 TapePlex 所有权信息。

语法

下图展示了 Display Volume 命令的语法：

图 6-8 Display Volume 命令语法

参数

如图 6-8中所示，Display Volume 命令包括以下参数：

volser、volser-range 或 volser-list

指示要处理的卷序列号、卷序列号范围或卷序列号列表。如果指定了多个卷，则仅显示前 100 个卷。

ALLTapeplex

（可选）指定为指定卷序列号查询所有活动的 TapePlex。如果指定此参数，则在多个 TapePlex 中定义了同一个卷序列号时，可能为该卷序列号列出多个显示行。

如果不指定此参数，则 Display Volume 命令将按定义顺序查询 TapePlex，并仅列出第一个出现的卷。

示例

在以下示例中，Display Volume 命令列出在可从 VM Client 访问的任何 TapePlex 中找到的卷序列号 EVT100：

DISPLAY VOLUME EVT100 ALLTAPEPLEX

DRIVemap

DRIVemap 命令可用于将 VM Client 设备地址映射到服务器驱动器地址。此命令允许用户在 VM Client 上以及在同一个 TapePlex 真实或虚拟设备的服务器主机上指定不同的地址。

语法

下图展示了 DRIVemap 命令的语法：

图 6-9 DRIVemap 命令语法

参数

如图 6-9中所示，DRIVemap 命令包括以下参数：

LIst

（可选）列出当前所有 DRIVemap 映射。

CLient(address)

（可选）指定通过 DRIVemap 命令映射的设备编号。

address 是设备编号、设备编号范围或设备编号列表。每个设备编号是一个十六进制数字。

此外，还可以加入 SErver 子参数：

SErver(address)

（可选）指定在 HSC 服务器上定义的设备编号。

address 是设备编号、设备编号范围或设备编号列表。设备编号是一个十六进制数字。

• 如果指定 CLient 时没有 OFF 参数，则需要 SErver。

• 如果同时指定了 CLient 和 SErver，则 CLient 参数必须指定一个与服务器参数所指定的等效的地址列表或地址范围。

注:

任何输入的 VM Client 命令如果引用了设备地址（例如 DISPLAY DRIVE、DISMOUNT 或 MOUNT），则必须指定客户机设备地址（或 VM Client 已知的地址）。

可以包含 LIst 参数以列出指定设备编号的 DRIVemap 映射。

OFF

（可选）删除所有 DRIVemap 条目。如果此参数与 CLient 参数一起指定，则仅删除匹配的 CLient DRIVemap 映射。地址指定方式（列表或范围）必须与定义指定方式完全匹配。

示例

在以下示例中，DRIVemap 命令将客户机设备地址 180-188 映射到服务器设备地址 280-288：

DRIVEMAP CLIENT(180-188) SERVER(280-288)

DUMP

DUMP 命令可用于随时强制生成服务机存储的转储。所有服务机存储都将转储。DUMP 命令用于诊断目的。请仅在 StorageTek 软件支持人员的指导下使用。

转储是通过 CP VMDUMP 命令生成的。转储目标是服务机的读取器（V 类）。

语法

下图展示了 DUMP 命令的语法：

图 6-10 DUMP 命令语法

参数

如图 6-10中所示，DUMP 命令包括以下参数：

TITLE(’comment’)

（可选）描述转储。

comment 是转储标题，最大长度为 72 个字符并括在单引号中。此标题仅对此 DUMP 命令有效。默认标题为 ’VM CLIENT DUMP COMMAND’。

示例

在以下示例中，DUMP 命令指定具有指定标题的 VM Client 服务机的转储：

DUMP TITLE(’Sample Dump’)

DUMPOpts

DUMPOpts 命令用于指定或重置要生成的最大 VMDUMP 转储数量。此命令可帮助防止 VM 假脱机空间在发生不太可能发生的严重异常终止循环事件时被耗尽。

语法

下图展示了 DUMPOpts 命令的语法：

图 6-11 DUMPOpts 命令语法

参数

如图 6-11中所示，DUMPOpts 命令包括以下参数：

LIst

（可选）列出当前的 DUMPOpts 设置，其中包括 DUMPS TAKEN、DUMPS MAX COUNT 和 USERID。

RESETcount

（可选）将生成的转储数量重置为零。

MAXdump(nnn)

（可选）设置在禁用转储处理前允许的转储数量的阈值计数。

nnn 是转储数量。这是一个从 0 到 999 的十进制数。默认值为 50。

TO(userid)

（可选）指定要接收转储的用户 ID。

userid 是用户 ID。这必须是已定义的 VM 用户 ID。如果输入星号 (*)，则会将其转换为 VM Client 服务机 ID。默认值为 VM Client 服务机的用户 ID。

示例

在以下示例中，DUMPOpts 命令将生成的转储数量重置为零，并将阈值设置为 10：

DUMPOPTS RESETCOUNT MAXDUMP(10)

EXIT

EXIT 命令用于终止 VM Client 服务机。

语法

下图展示了 EXIT 命令的语法：

图 6-12 EXIT 命令语法

参数

无。

Help

Help 命令用于显示 VM Client 命令和消息信息。

注:

如果输入 Help 命令时不带任何参数，则显示所有可用 VM Client 命令的信息。

语法

下图展示了 Help 命令的语法：

图 6-13 Help 命令语法

参数

如图 6-13中所示，Help 命令包括以下参数：

command-name

（可选）VM Client 命令名称。

nnnn

（可选）VM Client 消息标识符的四位数数字部分。不需要有前导零。

nnnn-nnnn

（可选）使用消息标识符的四位数数字部分指定的 VM Client 消息的范围。

SMCnnnn

（可选）完整的 VM Client 消息标识符。

SMCnnnn-SMCnnnn

（可选）使用完整的消息标识符指定的 VM Client 消息范围。

示例

在以下示例中，Help 命令显示了 VM Client 消息 SMC0228 的信息。

HELP SMC0228

LIst

LIst 命令用于显示 VM Client 虚拟机内的存储内容。此命令用于诊断目的。请仅在 StorageTek 软件支持人员的指导下使用。

语法

下图展示了 LIst 命令的语法：

图 6-14 LIst 命令语法

参数

如图 6-14中所示，LIst 命令包括以下参数：

Address(address)

（可选）指定开始列出 VM Client 内存内容的地址。

address 是十六进制地址。

CB(control-block-name)

（可选）指定要列出的内部 VM Client 控制块。

control-block-name 是控制块名称。

列出 VM Client 控制块仅用于诊断目的。请仅在 StorageTek 软件支持人员的指导下指定 control-block-name

TASKs

（可选）列出活动的 VM Client 系统任务。

FUNIT(uuuu|uuuu-uuuu)

（可选）列出与指定的单元地址关联的 VM Client 控制块。

uuuu 或 uuuu-uuuu 是单个单元地址或单元地址范围。

LOGdisk

LOGdisk 命令用于控制将控制台输出记录到名为 YYYYMMDD LOG 的磁盘文件。

语法

下图展示了 LOGdisk 命令的语法：

图 6-15 LOGdisk 命令语法

参数

如图 6-15中所示，LOGdisk 命令包括以下参数：

LIst

（可选）显示当前 LOGdisk 设置。

• LIst 是未在 LOGdisk 命令上指定参数时的默认参数。

• LIst 可与其他参数一起指定。在这种情况下，将在处理了其他参数之后再应用 LIst。

ON

（可选）允许使用列出的选项记录控制台输出。如果启用日志记录，则将记录所有命令和消息。

此外，还可以输入以下参数：

FM(m)

指定接收磁盘日志文件时使用的文件模式。FM 必须指定一个 RW 小型磁盘。此参数仅在与 ON 参数一起使用时有效。

m 是文件模式。此值必须是一个字母字符。默认值为 'A'。

OFF

（可选）不允许使用列出的选项记录控制台输出。日志文件被关闭。

FLUSH

（可选）刷新日志文件。文件被关闭后再重新打开。

所有消息都写入到 VM Client 服务机控制台。可通过 CP SPOOL 命令控制对 VM Client 服务机控制台的处理。建议 VM Client 服务机控制台在 PROFILE EXEC 中启动并假脱机到维护 ID。例如：

CP SPOOL CON START TO MAINT

示例

在以下示例中，LOGdisk 命令允许记录到磁盘文件：

LOGDISK ON

MOunt

MOunt 命令可用于在磁带机上挂载卷。

语法

下图展示了 MOunt 命令的语法：

图 6-16 MOunt 命令语法

参数

如图 6-16中所示，MOunt 命令包括以下参数：

DRive(uuuu)

指定要在其上挂载卷的传送装置的磁带机地址。

uuuu 磁带机地址。如果使用 DRIVemap 命令，则这是 CLIENT 地址。

VOLser(vvvvvv)

（可选）指定要挂载的卷。如果不指定此参数，则挂载擦写卷。

vvvvvv 是卷序列号。指定 SCRTCH 表示擦写卷。

Readonly

（可选）指定挂载的卷供只读访问。此参数仅对特定的挂载有效。

SUBpool(subpool-name)

（可选）指定要从擦写子池中获取擦写卷。如果不指定此参数，则行为取决于擦写池在 HSC 服务器上的定义情况。有关详细信息，请参见 HSC MOUNT 命令描述。此参数仅对擦写卷挂载有效。

subpool-name 是子池名称。

MEdia(media-type)

（可选）指定擦写卷的介质类型。指定的介质必须与请求 DRive 兼容。此参数仅对擦写卷挂载有效。

media-type 是介质类型。有关有效的介质类型值列表，请参见附录 A MEDia、RECtech 和 MODel 值。

注:

如果不指定 MEDia，则选择下一个擦写卷时将不考虑介质类型。

MGMTclas(mgmt-clas-name)

（可选）指定在 HSC/VTCS MGMTclas 控制语句中定义的管理类。此参数仅对擦写卷挂载有效。

mgmt-clas-name 是管理类名称。

示例

在以下示例中，MOunt 命令在磁带机 2900 上挂载卷 AAA001：

MOUNT DRIVE(2900) VOLSER(AAA001)

MSGDef

MDGDef 命令定义 VM Client 系统消息的外观，并控制显示和隐藏哪些消息。

语法

下图展示了 MSGDef 命令的语法：

图 6-17 MSGDef 命令语法

参数

如图 6-17中所示，MSGDef 命令包括以下参数：

LIst

（可选）列出当前的默认 VM Client 消息设置。

• LIst 是未在 MSGDef 命令上指定其他参数时的默认参数。

• LIst 可与其他参数一起指定。在这种情况下，将在处理了其他参数之后再应用 LIst 生成列表。

OFF

（可选）将所有 MSGDef 值重置为原始 VM Client 默认设置。指定 LIst 及此参数可列出这些设置。

CASE(UPPER|MIXED)

（可选）指定消息大小写。有效值为 UPPER 或 MIXED。

• UPPER 指定大写。这是默认值。

• MIXED 指定混合大小写。

LVl(level)

（可选）指定用于控制显示和隐藏哪些 VM Client 消息的默认级别。

level 是默认级别。包括以下有效值：

• 0 - 仅显示错误消息。

• 4 - 显示来自 VM Client 服务机的错误消息和警告消息。

• 8 - 显示所有 VM Client 服务机消息以及分配作业日志警告消息。如果不指定此 MSGDef 参数，则这是默认值。

注:

高于 8 的级别用于诊断目的，仅应在 StorageTek 软件支持人员的指导下指定。

ECHOmnterr(ON|OFF)

（可选）指定 HSC 生成的挂载错误是否直接回显到 VM Client 的控制台。

• ON 指定 HSC 生成的挂载错误回显到 VM Client 的控制台。这是默认值。

• OFF 指定 HSC 生成的挂载错误不回显到 VM Client 的控制台。

VERBOSE(OFF|ON)

（可选）指定是否只要 VM Client 设置发生更改就显示 SMC0190 和 SMC0191 消息。

• OFF 指定显示 SMC0190 和 SMC0191 消息。

• OFF 指定不显示 SMC0190 和 SMC0191 消息。这是默认值。

示例

在以下示例中，MSGDef 命令指定消息以混合大小写显示，并且仅显示来自 VM Client 服务机的错误和警告消息：

MSGD CASE(MIXED) LVl(4)

OPERator

OPERator 命令指定要接收 VM Client 消息的虚拟机。

语法

下图展示了 OPERator 命令的语法：

图 6-18 OPERator 命令语法

参数

如图 6-8中所示，OPERator 命令包括以下参数：

LIst

（可选）显示当前 OPERator 设置。

• LIst 是未为 OPERator 命令指定参数时的默认参数。

• LIst 可与其他参数一起指定。在这种情况下，将在处理了其他参数之后再生成列表。

ID(VM-userid)

（可选）指定要接收 VM Client 消息的虚拟机的名称。

VM-userid 是虚拟机的用户 ID。这必须是已定义的 VM 用户 ID。如果输入星号 (*)，则会将其转换为 VM Client 服务机 ID。默认值为 VM Client 服务机的用户 ID。

示例

在以下示例中，OPERator 命令指定 OPER 计算机接收消息：

OPERATOR ID(OPER)

POOLmap

POOLmap 命令可用于将 HSC 擦写子池名称映射到 VTCS 管理类。

使用 VM/HSC 磁带管理接口 (VM/HSC Tape Management Interface, VMTMI) 的磁带管理系统通常仅为擦写卷请求指定子池名称，而不指定管理类。POOLmap 命令提供了为擦写卷挂载提供管理类名称的一种方法。POOLmap 命令尤其适合在 VM Client 请求虚拟磁带挂载时使用。

注:

POOLmap 命令通过与 TapePlex 服务器通信来验证指定的子池和管理类名称。因此，在指定 POOLmap 命令之前，应先处理所有 VM Client TAPEPlex 和 SERVer 命令。

语法

下图展示了 POOLmap 命令的语法：

图 6-19 POOLmap 操作员命令

参数

如图 6-19中所示，POOLmap 命令包括以下参数：

LIst

（可选）显示当前 OPERator 设置。

• LIst 是未为 OPERator 命令指定参数时的默认参数。

• LIst 可与其他参数一起指定。在这种情况下，将在处理了其他参数之后再生成列表。

MGMTclass(mmmmm)

（可选）指定在 HSC 服务器上定义的管理类名称。

mmmmm 是 1-8 个字符的字母数字管理类名称。

OFF

（可选）删除所有 POOLmap 条目。

如果此参数与 MGMTclass 或 SUBPool 参数一起指定，则仅删除匹配的 POOLmap 条目。

SUBPool(subpool-list)

指定在 HSC 服务器上定义的擦写子池名称。

subpool-list 是要与指定的管理类名称关联的一个或多个擦写子池名称。

示例

在以下示例中，POOLmap 命令将管理类 DAILY 映射到擦写子池 VIRTCART1 和 VIRTCART2：

POOLMAP MGMT(DAILY) SUBP(VIRTCART1,VIRTCART2)

READ

READ 命令可用于通过输入数据集（而不是控制台命令）来输入一系列命令。

语法

下图展示了 READ 命令的语法：

图 6-20 READ 命令语法

参数

如图 6-20中所示，READ 命令包括以下参数：

SMCCMDs

（可选）重新处理包含在 VM Client START 过程的 SMCCMDS FILEDEF 中指定的数据集中的命令。

FILE(filename filetype) 以及可选的 filemode。

（可选）指定要 READ 的文件。

• filename 是文件名称。

• filetype 是文件类型。

• filemode 是文件模式。默认值为 A。

示例

在以下示例中，READ 命令处理 VM Client 启动 EXEC 的 SMCCMDS FILEDEF 中的命令。

READ SMCCMDS

RESYNChronize

RESYNChronize 命令可用于重新建立到所有定义的 TapePlex 的连接以便从所有 TapePlex 获取磁带机配置信息。

在 VM Client 首次激活到 TapePlex 的新路径时，或者在 HSC 服务器报告配置更改时，将自动执行此操作。

语法

下图展示了 RESYNChronize 命令的语法：

图 6-21 RESYNChronize 命令语法

参数

如图 6-21中所示，RESYNChronize 命令包括以下参数：

REStart

（可选）在第一个服务器上开始尝试 RESYNChronize，不考虑最后一个活动路径。

WAIT(OFF|nnnnnn)

（可选）等待服务器变得可用。此选项在定义了 TAPEPLEX 和 SERVERs 后有用。在服务器变得可用或者经过指定的时间 nnnnnn 之前，该命令不会完成。

• nnnnnn 是以分钟为单位的等待时间 (0-999999)。

• OFF 指定命令不等待服务器可用。这是默认值。

示例

在以下示例中，RESYNChronize 命令指定从第一个服务器重新开始通信：

RESYNC RESTART

在下一个示例中，RESYNChronize 命令指定等待服务器变得可用：

RESYNC WAIT(9999)

Route

Route 命令可用于请求从 VM Client 到定义的 TapePlex 名称的事务处理的路由。

注:

此外，还可以使用 Route 命令发出从 VM Client 到 ACSLS XAPI 服务器的各种命令。有关更多信息，请参阅 ELS 出版物《XAPI Client Interface to ACSLS Server Reference》。

语法

下图展示了 Route 命令的语法：

图 6-22 Route 命令语法

参数

如图 6-22中所示，Route 命令包括以下参数：

tapeplex-name

VM Client TAPEPlex 命令上定义的 TapePlex 名称。VM Client 使用当前活动的 TapePlex 路径将请求路由到指定的 TapePlex。

command-string

要路由到请求的 TapePlex 的命令字符串。

• VM Client 不会尝试验证指定的命令字符串，而只是将输入的命令字符串路由到指定的 tapeplex-name 并显示所有响应。

• VTCS 命令不能带 VT 前缀；HSC UUI 接口将 VTCS 命令路由到不带 VT 前缀的正确的功能处理器。

• command-string 必须是 HSC UUI 支持的命令（VOLRPT 除外）或任何 VTCS 命令（VTVRPT、DISPLAY MSG 和 DISPLAY CMD 除外）。

示例

在以下示例中，Route 命令将 "D CDS" 命令字符串路由到 TapePlex HSC8 进行处理。SMC0173 消息将显示收到的所有响应：

R HSC8 DI CDS

SERVer

SERVer 命令定义到远程磁带库服务器的指定路径。SERVer 命令描述到 StorageTek HTTP 服务器的通信路径。SERVer 命令还可以列出针对 VM Client 定义的服务器。

请注意以下事项：

• 在定义 SERVer 之前，必须使用 TAPEPlex 命令定义其引用的 TapePlex。

• 与 SERVer 关联的 TapePlex 名称不能更改。有关更多信息，请参见TAPEPlex。

语法

下图展示了 SERVer 命令的语法：

图 6-23 SERVer 命令语法

参数

如图 6-23中所示，SERVer 命令包括以下参数：

LIst

（可选）显示 TapePlex 服务器路径的状态信息。

• LIst 是未在 SERVer 命令上指定参数时的默认参数。在这种情况下，将列出所有磁带库服务器路径。

• LIst 可与其他参数一起指定。在与 NAme 以外的其他参数一起指定时，将在处理了其他参数之后再应用 LIst 生成列表。

（可选）也可以随此参数指定 NAme (name)。NAme 指定要显示其状态的 TapePlex 服务器路径。name 是服务器路径名称。

NAme(name)

（可选）指定到 TapePlex 服务器的通信路径或路由。

name 是路径参数的标识符。在所有通信错误消息中都会报告此名称。适用下列规则：

• 该值的长度必须为 1-8 字符。

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

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

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

ENable

（可选）允许为挂载请求选择指定的服务器路径。

DIsable

（可选）禁用指定的服务器路径。如果这是到 TapePlex 的唯一路径，则 TapePlex 不可用于挂载请求。

TAPEPlex(name)

（可选）指定与 ACS 硬件配置关联的 TapePlex 名称。必须在定义新服务器时指定 TAPLEPlex 参数。

name 是 TapePlex 名称。在所有 TapePlex 服务器错误消息中都会报告此名称。适用下列规则：

• 该值的长度必须为 1-8 字符。

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

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

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

注:

可以定义指向单个 TapePlex 的多个路径。

服务器路径参数

HSCSUB(ssss)

（可选）指定代表与服务器关联的 TapePlex 的 HSC 子系统。仅当存在多个在服务器主机上执行的 HSC 子系统（在 MULT 模式下运行的 HSC）时才需要此参数。

ssss 是 HSC 子系统名称。

HOst(hostname)

（可选）指定 TapePlex 服务器的 IP 解析器主机名称。对于 DNS 查找，VM Client 必须能访问 TCPIP DATA 文件。

hostname 是远程主机的名称。

注:

HOst 和 IPaddress 互斥。

IPaddress(ipaddress)

（可选）指定 TapePlex 服务器的 IP 地址。

ipaddress 是远程主机的 IP 地址。

注:

IPaddress 和 HOst 互斥。

POrt(nnnn)

（可选）指定服务器端口。

nnnn 是服务器端口 (0-65535)。默认值为 8080。

WAit(nnnn)

（可选）指定在 VM Client 让请求超时之前的最大默认等待时间。

nnnn 以秒为单位的等待时间 (0-9999)。默认值为 60。

注:

默认等待时间不适用于挂载、卸载、弹出或移动请求，这些请求的默认超时值分别为 10 分钟、10 分钟、24 小时和 1 小时。

REtry(nnnn)

（可选）指定任何单个请求在允许任务恢复并记录失败之前的重试次数。

nnnn 是重试次数 (0-9999)。默认值为 3。

FAil(nnnn)

（可选）指定在成功建立通信之后、特定的服务器路径被禁用或停止服务之前的最大失败次数。

nnnn 指示失败次数。默认值为 0。

如果指定 0，则指定的 SERVER 将永远不会因为通信错误而被自动禁用。

如果指定的磁带库没有备份 SERVER 路径，则应指定此值。

FAIL 限制计数仅在此 SERVER 路径上成功建立了通信之后才适用。

示例

在以下示例中，SERVer 命令为 TapePlex DENVER 添加了一个名为 DENVER1 的服务器。

SERVER NAME(DENVER1) TAPEPLEX(DENVER) IP(11.22.33.44) PORT(7777)

TAPEPlex

TAPEPlex 命令定义 TapePlex；一种特定的 StorageTek 磁带硬件配置，通常情况下用单个 CDS 表示。

请注意以下事项：

• 需要使用 TAPEPlex 和 SERVer 命令来访问 HSC TapePlex。

• TAPEPlex 命令还可以列出 VM Client 尝试与其通信的 TapePlex，并报告其状态。

语法

下图展示了 TAPEPlex 命令的语法：

图 6-24 TAPEPlex 命令语法

参数

如图 6-24中所示，TAPEPlex 命令包括以下参数：

LIst

（可选）列出指定的 TapePlex。

NAme(name)

（可选）指定要定义或修改的 TapePlex 名称。

name 是 TapePlex 名称。在任何 TapePlex 错误消息中都会报告此名称。适用下列规则：

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

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

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

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

可以指定以下子参数：

• ENable 允许为挂载请求选择指定的 TapePlex。这是默认值。

• DIsable 禁用指定的 TapePlex。TapePlex 不用于任何挂载请求。

SERVerlist

（可选）列出定义的 TapePlex 及其属性和关联的服务器。SERVerlist 参数还可与 NAME 参数一起指定以只显示单个 TapePlex。

可以指定以下子参数：

• NAME 指定要为其列出服务器的 TapePlex 名称。name 是 TapePlex 名称。

STATus

（可选）列出所有 TapePlex 或指定的单个 TapePlex 的当前状态。TapePlex 状态指示 TapePlex 是处于活动、非活动还是禁用状态。对于活动的 TapePlex，状态会列出当前服务器的名称。STATus 不执行 RESYNChronize 命令。

可以指定以下子参数：

• NAME 指定要为其列出状态信息的 TapePlex 名称。name 是 TapePlex 名称。

示例

在以下示例中，TAPEPlex 命令定义了一个名为 DENVER 的 TapePlex（假定其尚未定义）。

TAPEPLEX NAME(DENVER)

注:

必须指定 SERVer 命令以定义到 TapePlex DENVER 的通信路径。有关示例，请参见SERVer。

TCPip

TCPip 命令更改或列出 TCP/IP 通信环境的当前设置。它允许您将 TCP/IP 请求指向 VM 主机上的某个特定 TCP/IP 堆栈。可以随时发出 TCPip 命令。

语法

下图展示了 TCPip 命令的语法：

图 6-25 TCPip 命令语法

参数

如图 6-25中所示，TCPip 命令包括以下参数：

LIst

（可选）显示当前的 TCP/IP 设置。如果指定了 PORTrange，则 LIst 还会显示当前绑定的端口号以及高水位端口号（指示一次执行的并发通信子任务的最大数量）。

• LIst 是未在 TCPip 命令上指定参数时的默认参数。

• LIst 可与其他参数一起指定。在这种情况下，将在处理了其他参数之后再应用 LIst 生成列表。

OFF

（可选）指定使用系统默认值进行 VM Client TCP/IP 通信。

tcpip 参数

TCPname(name)

（可选）指定 VM 主机上的 TCP/IP 服务机。

name 是作为 TCP/IP 通信目标的 VM 上的 TCP/IP 服务机的用户 ID。默认值为 TCPIP。

PORTrange(nnnn-mmmm) 或 (OFF)

（可选）指定 VM Client 在远程服务器路径上通信时要在客户机上 bind()（绑定）套接字的端口的范围。

如果定义了 PORTrange，则 VM Client 将客户机套接字绑定了指定的 PORTrange 中的某个端口，并且不会使用 PORTrange 以外的客户机端口。因此，VM Client 可以在将通信限制到已知端口的防火墙后运行。每个需要通信服务的并发子任务都需要一个唯一端口用于进行批量查找、挂载等。如果未定义 PORTrange，则 VM Client 将使用任一临时端口。

一次只能有一个 PORTrange 处于活动状态，但可以动态地重新定义 PORTrange，即使新 PORTrange 与旧 PORTrange 重叠也没关系。

• nnnn-mmmm 是端口号范围。每个端口号可以为 1-65535 中的一个值。可指定的最小端口号范围是 10 个端口（ 例如，6401-6410）。可指定的最大端口号范围是 1000 个端口（ 例如，6401-7400）。

• OFF 禁用 PORTrange 逻辑。此时将使用任一临时端口。这是默认值。

请注意以下事项：

• 建议在指定 PORTrange 时，指定一个不与 TCP/IP 常用端口冲突的 PORTrange。

• 建议在指定 PORTrange 时，指定大于请求通信服务的并发子任务的预期端口的 PORTrange。对于大多数安装，40 个端口的 PORTrange 足够了。但是，如果生成了 SMC0128 消息，并且返回代码指示“无空闲端口”，则需要更大的 PORTrange。

• TCPip LIST 命令可用于显示高水位端口号（指示一次执行的并发通信子任务最大数量）。

MONitor(nnnn) 以及可选的 mmmm

（可选）指定通信监视器子任务扫描间隔，以及通信监视器子任务消息间隔。

nnnn 是以秒为单位的监视器扫描间隔。通信监视器每 nnnn 秒活跃一次以执行磁带库通信验证。指定一个介于 10 和 9999 之间的值。默认值为 60。

建议保留默认设置 60 以每分钟启用一次监视器扫描。在存在非活动磁带库时，太低的值可能会降低性能。太高的值可能会延迟返回到主服务器（在指定了 PREFPRIMARY(ON) 的情况下）。

mmmm 是可选的监视器扫描间隔（以扫描次数为单位）。通信错误消息按此间隔显示。指定一个介于 0 和 9999 之间的值。默认值为 10。

默认的 MONITOR(60,10) 设置指定监视器扫描间隔为 60 秒， 指定监视器消息间隔为 10 次扫描。扫描每分钟进行一次，但错误消息仅在每 10 次扫描才生成一次。

mmmm 值为 0 时禁用由通信监视器子任务发出的所有非不可恢复或非禁用错误消息。但是，导致禁用服务器通信路径的错误仍会发出。

PREFprimary(ON|OFF)

（可选）启用或禁用自动主服务器切换。自动主服务器切换要求通信监视器子任务处于活动状态。如果指定 MONITOR(OFF)，则禁用主服务器切换。

示例

在以下示例中，TCPip 命令使用任一临时端口将 TCP/IP 请求指向名为 TCPIP 的 VM 服务机。

TCPIP TCPNAME(TCPIP) PORTRANGE(OFF)

TRace

TRace 命令启用 VM Client 跟踪。VM Client 跟踪文件会写入 TRACE FILEDEF 文件。

注:

此命令可能会影响系统性能。请仅在 StorageTek 软件支持人员的指导下使用。

语法

下图展示了 TRace 命令的语法：

图 6-26 TRace 命令语法

参数

如图 6-26中所示，TRace 命令包括以下参数：

参数

LIst

（可选）列出当前的 VM Client 跟踪设置。

• LIst 是未在 TRace 命令上指定参数时的默认参数。

• LIst 可与其他参数一起指定。在这种情况下，将在处理了其他参数之后再生成列表。

OFF

（可选）禁用 VM Client 跟踪。

ON

（可选）启用 VM Client 跟踪。

示例

在以下示例中，TRace 命令启用了 VM Client 跟踪。

TRACE ON