5 启动 VM Client

本章介绍如何启动 VM Client 软件。

VM Client 在其自己的 CMS 虚拟机（称为“VM Client 服务机”）中执行。第 3 章 安装 VM Client介绍了 VM Client 服务机的设置以及 VM Client 服务机软件的安装。

安装 VM Client 服务机后，通过发出分布式 SMCSTART 命令来启动 VM Client。SMCSTART 命令是一个 EXEC 命令，它首先初始化 VM Client 虚拟机环境，然后执行 SMCBINT 模块。

SMCBINT 模块读取 VM Client 命令文件，并初始化 VM Client 环境，以从其他虚拟机接收 TMI 命令。有关 VM Client 命令文件的更多信息，请参见VM Client 命令文件。

SMCBINT 模块参数

除 VM Client 命令文件以外，SMCBINT 模块还接受可选命令行参数。利用 SMCBINT 可选命令行参数，可以在读取 VM Client 命令文件之前设置 VM Client OPERATOR 和 VM Client TRACE，或者在启动时启用 VM Client MAXRC 处理。

SMCBINT 可选命令行参数以关键字对的形式输入，跟在模块名称后面。例如，下面是指定 SMCBINT 参数的示例：

SMCBINT TRACE ON OPERATOR VMOPER MAXRC 4

在命令行参数处理期间遇到的任何错误都将导致 VM Client 初始化进程终止。

后面几部分详细介绍了允许的各个关键字值对。

TRACE 关键字值对

TRACE{ON|OFF}

指定是否在 VM Client 命令文件处理之前激活 VM Client 跟踪处理。ON 指定尽早启用 VM Client TRACE。

OPERATOR 关键字值对

OPERATOR userid

指定是否在 VM Client 命令文件处理之前设置 VM Client 操作员。userid 指定要接收 VM Client 消息的虚拟机的名称。

MAXRC 关键字值对

MAXRC nn

指定是否激活 VM Client MAXRC 处理。

MAXRC 处理确定当超过指定的命令返回代码时 VM Client 系统是否在启动时终止。如果未指定 MAXRC，则 VM Client 将始终尝试完成其初始化，而不考虑任何启动命令失败的情况。这是默认行为。值 nn 指定允许的最高返回代码。如果从 SMCPARMS 或 SMCCMDS 数据集执行的 VM Client 命令超过了此值，则将生成 SMC0236 和 SMC0237 消息，并且 VM Client 将会终止。允许的值为 0、4、8 和 12。

VM Client 命令文件

VM Client 命令可以在 SMCPARMS 和 SMCCMDS 命令文件中指定。在 VM Client 初始化期间，将会读取这些命令文件并执行这些文件中包含的命令。按照约定，命令文件按如下方式命名：

  • SMCPARMS FILE A1

  • SMCCMDS FILE A1

如果要使用不同的文件名，可以修改 SMCSTART EXEC 中 SMCPARMS 和 SMCCMDS 的 FILEDEF。

VM Client 命令文件中的控制语句必须遵循控制语句的标准约定，如控制语句约定中所述。

SMCPARMS

首先读取 SMCPARMS 命令文件。它用于在 VM Client 处于活动状态时无法更改的用户配置项目。不能使用 READ 命令重新处理 SMCPARMS。

下面是 SMCPARMS 成员条目示例：

OPERATOR ID(nnnn)
LOGDISK ON
MSGDEF CASE(MIXED)
TCPIP TCPNAME(tcpname)

SMCCMDS

SMCCMDS 命令文件用于在 VM Client 处于活动状态时可以更改的用户配置项目。可以使用 VM Client READ 命令重新处理 SMCCMDS。有关此命令的更多信息，请参见READ。

下面是 SMCCMDS 成员条目示例：

TAPEPLEX NAME(tttttttt)
SERVER NAME(ssssssss) TAPEPLEX(tttttttt) PORT(pppp) +
IPADDRESS(nn.nn.nn.nn)

VM Client 客户出口

VM Client 提供了以下客户出口，它们可以作为 CMS EXEC 实施。

  • SMCXIT00 午夜出口

    如果实施了此出口，它将在每晚午夜执行。

    有关输入参数（如果有）、功能和安装说明，请参见安装示例 SMCXIT00.samp。

  • SMCXIT01 命令授权出口

    如果实施了此出口，它将在收到 VM Client 命令或 TMI 请求且 VM Client 命令或 TMI 请求未经适当的 VM Client AUTHorize 命令授权时执行。

    有关 VM Client AUTHorize 命令的信息，请参见AUTHorize。有关输入参数（如果有）、功能和安装说明，请参见安装示例 SMCXIT01.samp。

    注:

    VMSES/E 安装不安装这些出口。有关安装说明，请参阅各个客户出口样例。

CP DETACH 支持

提供了 SMCPROP EXEC，目的是用作 PRogrammable OPerator (PROP) 操作例程，用于处理 CP 发送至系统控制台的以下类型的所有消息：

TAPE raddr DETACHED....

VM (CP) 会导致对通过 CP 命令 LOGOFF、FORCE 或 DETACH 分离的任何磁带机执行“重绕卸载”命令。这样会使任何 StorageTek 分离的 TapePlex 卷处于“选中”状态，同时仍驻留在自动化 TapePlex 传送装置中。在从磁带机中移除（或通过 DISMOUNT 命令卸载）之前，卷对于任何请求者都不可用。

SMCPROP EXEC 是一个“操作例程”，可以通过 VM PROP 服务进行调用，以便在 TapePlex 传送装置从虚拟机中分离时自动发出 VM Client DISMOUNT 命令，从而使卷处于可用状态（即，未选中）的时间早于本来可能的时间。提供了 RTABLE SAMPLE，目的是将 SMCPROP 操作例程与 PROP 一起使用。有关 PROP 服务的信息，请参阅 IBM 出版物《CMS Planning and Administration》。

SMCPROP EXEC 也可以与 VMOPERATOR 一起使用来捕获 DETACH 消息。LOGTABLE SAMPLE 包含一些 VMOPERATOR LOGTABLE 语句样例，应该对您有所帮助。有关根据您的需求量身定制样例的信息，请参阅 VMOPERATOR 文档。如果 VM Client 服务机用户 ID 不是 VMSMC，则必须更新 SMCPROP EXEC。

SMCPROP EXEC 必须可供 PROP/VMOPERATOR 计算机使用才能正常运行。