版本 4.2
SA40-1754-01
5697-D17 5697-D18 5697-D19 5697-D20 5697-D21 5697-D22 1997 年 8 月 12 日
第一版(1998 年 2 月)
本版本适用于:
除非在新版本中特别说明,该版本还适用于所有的后续版本、发行本和修订本。 请参考可用的系统书目的最新版本,获得这些产品的当前信息。
软拷贝版本基于本书的打印版本。 已进行了某些格式修正,以使此信息更适合于软拷贝。
可以通过 IBM 或 Transarc 代理或通过当地的 IBM 分支部门来订购出版物。
在本出版物的背后有一张"读者意见表"。 如果您要提出意见, 而这里描述的方式又不适用于您的话, 请将它们寄往以下地址:
Transarc Corporation, The Gulf Tower,当您向 IBM 或 Transarc 发送了信息后,就授予了它们非专有权, 它们可以以任何认为适当的方法使用或散发这些信息,而不必对您负任何责任。
© Copyright International Business Machines Corporation 1993, 1998; Transarc Corporation, 1998. All rights reserved.
Note to U.S. government Users -- Documentation related ...
第 3 部分 安装、升级和配置 TXSeries Encina
本书提供了在单个机器上安装、升级和配置 IBM TXSeries(TM) Windows NT® 版的指令。 为使初学者系统的安装和配置更容易,过程使用缺省设置选项并且不提供定制指令。 请参考 TXSeries 库中的其它书籍,获得定制 TXSeries 配置的信息。在按照本书提供的过程执行后, 就有了一个可使用的 TXSeries 系统;然后,可以修改和扩充它的配置,使它满足您的特殊需求。
本书是为要安装、配置或升级 TXSeries Windows NT 版系统的 TXSeries 的用户所写的。 本文档假设您熟悉网络管理和 Windows NT 操作系统。 如果您没有使用 TXSeries 的经验,则郑重建议您在阅读本书前阅读概念与功能一书。
本书由以下部分组成:
第 1 部分:准备 TXSeries
第 2 部分:安装、升级和配置 TXSeries CICS
第 3 部分:安装、升级和配置 TXSeries Encina
第 4 部分:删除 TXSeries 软件
附录
IBM TXSeries 4.2 是两个事务处理产品的集成: IBM 的用户信息控制系统(CICS®)和 Transarc 的 Encina®。 这两个产品使您可以创建一个分布式客户机/服务器环境, 提供联机事务处理(OLTP)所需的可靠性、规模可变性、互操作性和数据完整性。 有了 TXSeries,您可以使用 CICS 或 Encina 来创建和管理商业解决方案。
CICS 提供了各种平台的联机事务处理和事务管理。它在操作系统的服务基础上, 建立了开放组的分布式计算环境(DCE)和 Encina 来提供服务,用于应用程序开发、通信、数据恢复、 数据管理、安全性和内部通信。
Encina 提供了 Encina 监视器,它是一种用于开发、 运行和管理事务处理应用程序的基础设施。 Encina 监视器还可用于各种平台,它包括一个全功能的应用程序设计接口(API)、 一个跨越多机种环境进行负载均衡和调度的执行环境, 以及一个使广泛的分布式系统作为一个单个系统进行管理的复杂的管理环境。
请参阅概念与功能获得有关 CICS 和 Encina 的功能、 服务和优点的更多信息。
本文档描述了如何安装、升级和配置 CICS 或 Encina 系统。 如果您是第一次接触 CICS 或 Encina,您可以使用本文档来设置和启动两个系统的基本部件。 如果您是有经验的 CICS 或 Encina 用户,则可以使用本文档来升级到两个系统的最新版本, 然后请参考合适的章节来执行附加的配置。
对于 CICS,本文档提供了一些指令,包括使用 CICS 来设置 CICS 所需的 DCE 服务; 创建和启动区域、本地终端和文件管理器; 使用 CICS 安装验证程序(IVP)来确定是否已正确安装和配置了 CICS。
对于 Encina,本文档提供了为 Encina 设置 DCE 和使用 Enconsole(Encina 的图形用户界面(GUI)管理工具)的指令, 用于创建和启动单元管理器、节点管理器和 SFS 服务器。
在执行本文档中的指令前,您必须做下列决定。 请参考概念与功能获得关于这些事项的更多信息以及作决定的指导。
作出决定后,可以按下列方法执行本文档中的指令:
要执行该任务: | 按照这些章中的指令操作: |
---|---|
安装和配置一个新的 CICS 系统 |
|
从事务处理服务器 4.0.1 CICS 升级到 TXSeries CICS 4.2 |
|
安装和配置一个新的 Encina 系统 |
|
从 Encina 2.5.1 升级到 TXSeries Encina 4.2 |
|
从事务处理服务器 4.0.1 Encina 2.2 升级到 TXSeries Encina 4.2 |
|
安装 Encina OTS |
|
本章描述了在软件 CD-ROM 中提供的 TXSeries 部件。 列出了它们之间的相关性,并描述了进行典型 TXSeries 配置所需的部件。
注意: | 部件必须安装在每个要使用它的机器上。 |
IBM DCE 软件 CD-ROM 中的 TXSeries 包含了 IBM 分布式计算环境 (DCE)客户机, 使您可以将 Windows NT 机器配置为使用 DCE 安全性的客户机, 或者将它配置为一个没有 DCE 安全服务的仅远程过程调用(RPC)环境。如果还没有在机器上安装 DCE, IBM DCE 客户机就会在 CICS 或 Encina 安装期间自动安装。
如果您已有了 TXSeries 的 Gradient DCE 版本,您必须在安装 CICS 或 Encina 前安装 Gradient DCE Runtime 版本和 ADK 部件。 请参考 Gradient DCE 文档获得更多信息。
CICS 包含了下列部件:
另外,CICS 还需要几个 Encina 部件,这些部件是在安装 CICS 时自动安装的。这些 Encina 部件包括了执行、 服务器核心程序和结构化文件服务器。如需关于这些部件的更多信息, 请参阅"Encina 部件"。
如果需要一个产品系统,使您可以运行 CICS 应用程序,则必须安装服务器运行时部件。如果需要一个开发系统, 使您可以创建和维护 CICS 应用程序,则必须安装服务器开发部件。
Encina 包含了下列部件:
如需有关这些部件提供的功能的更多信息, 请参考 Encina 文档。
某些 Encina 部件之间存在着相关性,如表 2 所示。
| |
要安装的 Encina 部件 | 必需的 Encina 部件 |
---|---|
执行体 | - |
服务器核心程序 | 执行体 |
结构化文件服务器 | 执行体,服务器核心程序 |
可恢复队列服务 | 执行体,服务器核心程序 |
同级间通信网关(IBM SNA) | 执行体,服务器核心程序 |
监视器单元管理器 | 执行体,服务器核心程序 |
监视器节点管理器 | 执行体,服务器核心程序 |
监视器队列请求设施 | 执行体,服务器核心程序,监视器节点管理器 |
应用程序开发环境 | 执行体 |
请注意下列进行典型 Encina 配置需满足的条件:
在 Encina 服务器或应用程序开发环境中,除那些需要的部件之外,还可以安装其它的 Encina 部件。 例如,如果您需要 SFS 服务器,只需在其它所需的部件之外再安装一个结构化文件服务器部件即可。
注意: | Encina 服务器不支持 Windows 95 平台。 |
Encina 用于 Orbix 的对象事务处理服务(OTS)提供了不使用 DCE 服务的纯公共对象请求代理体系结构(CORBA)环境。 它包含了下列部件:
必须安装用于 Orbix 的 OTS 客户机部件,以安装和使用 Orbix 的 OTS 服务器和 Orbix 的 OTS 应用程序开发环境部件。
注意: | 郑重建议您不要在同一台机器上安装 Encina 和用于 Orbix 的 Encina OTS。 |
本章描述了在机器上安装用户信息控制系统(CICS)版本 4.2 前, 必须满足的硬件和软件先决条件。
下面的部分描述了在 Windows NT 上安装 CICS 4.2 所需的特定内存和磁盘空间。
CICS 可以安装在文件分配表(FAT)和 NT 文件系统(NTFS)驱动器上。 不过,因为软件使用 NTFS 文件存取控制信息来提供安全的系统,郑重建议您将 Encina 安装在 NTFS 驱动器上。
CICS Windows NT 版可以在任何带有 Intel 处理器的 Windows NT 机器上运行。 建议您的机器上至少有 75 MHz Intel 80486 处理器。
需要最小 64 MB 的内存来正确运行 CICS 区域配置。要检查机器上是否有可用的内存, 从 Windows NT 资源管理器的帮助菜单中选择关于 Windows NT 命令。
安装 CICS 时需要一定的磁盘空间,配置和使用它时需要额外的磁盘空间。 CICS 还需要交换空间。另外, 如果您要在该机器上运行 SFS 服务器,还必须为 SFS 所使用的卷留出磁盘空间。
下面的部分概述了磁盘空间需求:
要知道您的机器上当前有多少可用的磁盘空间, 打开 Windows NT 资源管理器并选择一个磁盘驱动器。从文件菜单中选择属性命令, 查看该驱动器上可用的磁盘空间。
表 3 列出了 在 \opt 目录中 安装 CICS 部件所需的最少可用磁盘空间。磁盘空间需求是累积的。 当确定了最小磁盘空间要求后,请注意以下方面:
部件 | 所需的磁盘空间 |
CICS 服务器运行时 | 20 MB |
CICS 服务器开发 | 26 MB |
SFS | 2 MB |
IBM DCE 客户机(运行时和 ADK) | 28 MB |
License Use Runtime | 15 MB |
除了安装 CICS 所需的磁盘空间之外,您还必须分配一些磁盘空间来保存 CICS 配置文件、日志文件和核心文件。
表 4 列出了典型 CICS 配置所需的最小基本磁盘空间。
CICS 配置 | 磁盘空间 |
---|---|
区域(带有本地 SFS 服务器) | 8 MB,加上:
|
必须分配一些空间来安装用于国家语言的 NLS 文件。这些文件使 CICS 可以以选中的语言显示信息。 CICS 信息可以以美式英语、简体中文、法语、德语、意大利语、日语、韩语、巴西葡萄牙语和西班牙语显示。 每种语言的文件都需要大约 1 MB 的空间。
CICS 需要交换空间(调页)。所需的交换空间大小取决于在机器上正运行的 CICS 区域数、 每个区域任务池的大小,以及为每个区域配置的应用程序服务器、侦听程序进程和远程过程调用(RPC)侦听程序线程数。 还必须考虑到运行 CICS 管理实用程序、 本地 CICS 终端和 DCE 客户机(如果需要)所需的交换空间大小。
因为如果没有足够的交换空间就可能发生错误,所以建议您将最大调页文件大小调整到每区域 150 MB, 来容纳区域和相关的服务器和进程。这样就可以按您的特殊配置的需要来增加或减少调页大小了。 要更改调页大小,在控制面板中双击系统图标, 然后选择性能标签。选择更改按钮, 然后调整最大大小字段中的值。
在运行 SFS 服务器的机器上,您还必须为主要日志卷和数据卷提供一些空间。
表 5 列出了这些卷所需的最小附加磁盘空间。
主要数据卷 | 主要日志卷 | 数据卷镜像 | 日志卷镜像 | 日志归档文件 |
8 MB | 8 MB | 8 MB | 8 MB | 4 MB |
请注意以下方面:
郑重建议您镜象 SFS 数据和日志卷来确保数据的可恢复性。 表 5 列出了镜像卷所需的最小磁盘空间数量。 当为镜像卷分配空间时,请注意以下方面:
如需镜象的说明,请参阅 Encina 管理指南第 1 卷:基本管理。
因为媒体归档用于恢复 SFS 日志文件以及恢复备份数据,所以郑重建议进行媒体归档。 表 5 列出了日志归档文件所需的最小磁盘空间数量。 当为媒体归档生成的 SFS 日志归档文件分配磁盘空间时,请注意以下方面:
如需有关媒体归档的说明,请参阅 Encina 管理指南第 1 卷:基本管理。
如果您要在仅 RPC 环境中安装 CICS 服务器开发系统并运行带有本地 SFS 服务器的区域, 您必须最少有下列磁盘空间:
此外,还建议您另外分配 16 MB 用于 SFS 镜像卷。
本节描述了在 Windows NT 机器上安装 CICS 的软件先决条件。
在 Windows NT 机器上安装任何 CICS 部件前,必须验证机器是否在运行带有 Service Pack 3 的 Windows NT 版本 4.0。
CICS 4.2 经过验证,可以和 IBM DCE 版本 2.0 (ECO-2) 以及 Gradient DCE 版本 2.1 一起使用。 如果已有了 TXSeries 的 IBM DCE 版本, IBM DCE 客户机就包括在软件 CD-ROM 中,如果您的机器上还没有 DCE,就自动安装它。 TXSeries 安装程序还将任何 IBM DCE 以前的版本升级到版本 2.0 (ECO-2)。
如果您希望使用 Gradient DCE,必须保证在安装 CICS 前已安装了版本 2.1。
必须使用 IBM Database 2 (DB2) 或 Encina SFS 服务器来管理 CICS 文件系统。当选择文件管理器时,请注意以下方面:
如果您要使其它的第三方软件和 CICS 一起使用,就需要安装这些文件,尽管它们的安装不是 CICS 安装的先决条件。 Windows NT 版 TXSeries 特定于平台的发行说明提供了与 CICS 一起使用的对应版本的第三方软件的信息。
注意: | 如果正在使用第三方数据库,并计划使用 CICS 提供的数据库 XA 支持交换加载文件 makefile, 必须将 Encina 应用程序开发环境部件安装在您的机器上。 |
本章描述了在 Windows NT 机器上安装 CICS 软件的过程。 该过程假设满足了在第 3 章 "CICS 先决条件"中描述的先决条件。如果您正在运行任何其它的 Windows 应用程序, 建议您在安装 CICS 前退出它们。
如果已有了 TXSeries 的 IBM DCE 版本, 而且 IBM DCE 客户机软件还没有安装在您的机器上, 则它会在 CICS 安装期间被自动安装。缺省情况下, DCE 是安装在目录 C:\Program Files\dce 中的。 如果您不希望将 DCE 安装在缺省目录中, 则必须在安装 CICS 之前手工安装它。
注意: | TXSeries 安装程序需要一个工作目录用于资源。 该目录是在 TEMP 环境变量所指向的位置中创建的。工作目录需要 1 MB 的空间; 因此,必须保证 TEMP 指向的目录有足够的可用空间。如果工作目录太小,就不能设置必需的资源, 安装进程就会失败。 |
要在机器上安装 CICS 软件,请执行下列任务:
注意: | 如果您的机器不支持自动播放选项,或者如果您已将它关闭, 必须手工启动 TXSeries 安装程序(位于 CD-ROM 上的 \x86 目录中)。 |
如需有关 CICS 部件的更多信息,请参考第 2 章 "确定要安装的部件"。
注意: | 如果选择了非缺省值的目的目录, 请确保在路径名中没有空格( 避免例如 C:\My Files\Cics 这样的路径名)。 |
TXSeries 安装程序开始将 IBM DCE (如果需要)、 许可证使用运行时(如果需要)和所选的 CICS 和 Encina 部件安装到目的目录中。
在安装期间,出现“产品许可证登记”对话框。它会询问您是否希望此时就登记产品许可证。
注意: | 如果您没有在此时登记产品许可证,请参考附录 A. "登记 TXSeries 许可证"获得有关使用带评估许可证的 CICS 的信息。 该附录还包含了在安装 CICS 后登记产品许可证的指令。 |
在机器上安装了 CICS 后, 下列应用程序图标出现在 IBM CICS 服务器 Windows NT 版程序文件夹中:
TXSeries 安装程序还创建了 Encina 程序文件夹。它包含了下列图标:
另外,如果没有许可证使用运行时软件,TXSeries 安装程序将为它创建一个程序文件夹。 它包含了下列图标:
如果您的机器上已安装了 IBM DCE 客户机, 下列应用程序图标就出现在 DCE Windows NT V2.0 版程序文件夹中:
在安装期间,TXSeries 安装程序创建或更新下列环境变量:
如果安装了 IBM DCE 客户机,这些附加的环境变量就被创建或更新:
如果安装了许可证使用运行时软件,这些附加的环境变量就被创建或更新:
在安装期间,创建了下列 Windows NT 用户 ID 和用户组:
尽管组 cicsgroup 被初始定义为本地组, 您也可以将它定义为存在在域中一个服务器设备上的全局组。 请参阅 Windows NT 文档,获得有关本地和全局组的更多信息。
可以使用安静安装功能来安装 CICS 4.2,而无需经过任何 InstallShield 设置面板。 在安静安装期间,TXSeries 安装程序使用响应文件 (称为 CICS.ISS)中的信息来确定安装选项。
与 TXSeries 一起提供的 CICS.ISS 文件以安静方式将 CICS 开发环境 (包括必需的 Encina 部件)安装到 Windows NT 系统上的缺省目标安装目录中。 CICS 的缺省目标安装目录为 C:\opt\cics, C:\var 是 CICS 变量数据目录。 缺省情况下,必需的 Encina 部件安装在 C:\opt\encina 中。
为每种 TXSeries 支持的国家语言提供 CICS.ISS 响应文件。 这些文件位于 CD-ROM 的 \x86\language 目录(其中的 language 是 TXSeries 支持的国家语言)中。 它们包含了关于每个部件的已转换字符串的信息, 如果在安静安装中使用的语言不是美式英语, 则必须使用这些信息来修改响应文件 。
本节描述了与 TXSeries 一起提供的 CICS.ISS 文件的结构。 同时还提供了关于编辑该响应文件的一些有用信息。
编辑响应文件时,请注意以下方面:
注意: | 如果已将所有 CICS 安装映像复制到网络驱动器或者本地机器上的驱动器中, 就不需要对响应文件作备份了。可以编辑所提供的文件,但要确保不将它重新命名。 |
美式英语版本的 CICS.ISS 文件如下所示:
[InstallShield Silent] Version=v3.00.000 File=Response File [Application] Name=CICS Version=4.2 Company=IBM [DlgOrder] Dlg0=SdWelcome-0 Count=11 Dlg1=SdAskOptions-0 Dlg2=SdAskOptions-1 Dlg3=SdAskOptions-2 Dlg4=SdComponentDialog-0 Dlg5=SdAskDestPath-0 Dlg6=SdStartCopy-0 Dlg7=AskYesNo-0 Dlg8=AskYesNo-1 Dlg9=SdFinishReboot-0 Dlg10=MessageBox-0 [SdWelcome-0] Result=1 [SdAskOptions-0] Component-type=string Component-count=1 Component-0=English (United States) Result=1 [SdAskOptions-1] Component-type=string Component-count=1 Component-0=CICS Server Result=1 [SdAskOptions-2] Component-type=string Component-count=1 Component-0=CICS Server Development System Result=1 [SdComponentDialog-0] szDir=c:\opt\cics Component-type=string Component-count=2 Component-0=Server Development Component-1=Structured File Server Result=1 [SdAskDestPath-0] szDir=c:\VAR Result=1 [SdStartCopy-0] Result=1 [AskYesNo-0] Result=0 [AskYesNo-1] Result=0 [SdFinishReboot-0] Result=1 BootOption=0 [MessageBox-0] Result=1
CICS.ISS 文件包含了若干节,每节都用 [ ] (方括号)括起。 下面的部分将对文件中的每一节进行描述。
[Application]节提供了软件的名称、 版本和设计它的公司。这些信息存储在 Windows NT 注册表中。
[DlgOrder]节按 TXSeries 安装程序调用的顺序列出了 InstallShield 对话框(或窗口)。 缺省 CICS 安静安装的对话框如下所示:
本节包含了“欢迎”对话框中的信息。它包含了下列关键字:
[SdAskOptions-0]节包含了“选择语言”对话框中的信息;它指定了安装 CICS 所用的语言。 它包括下列关键字:
[SdAskOptions-1]节包含了第一个“选择要安装的产品”对话框中的信息。 它表明您正在安装 CICS 服务器产品。该节包括了下列关键字:
[SdAskOptions-2]节包含了第二个“选择要安装的产品”对话框中的信息。 它允许您指定希望安装的 CICS 产品:CICS 服务器产品系统或 CICS 服务器开发系统。该节包括了下列关键字:
[SdComponentDialog-0]节包含了“选择部件”对话框中的信息。它允许您指定希望安装的 CICS 部件。 该节包含了下列关键字:
注意: | 当编辑该节时,必须确保为 Component-count 指定的数与在 Component-n 节 (其中的 n 是一个从 0 到 1 的数)中列出的部件数相等。 |
[SdAskDestPath-0]节包含了“选择 CICS 数据目录”对话框中的信息。它包含了下列关键字:
[SdStartCopy-0]节包含了“检查设置信息”对话框中的信息。它包含了下列关键字:
[AskYesNo-0]节包含了“产品许可证登记”对话框中的信息。 该节表明您是否正在登记产品许可证。它包含了下列关键字:
如果您要在安装进程期间登记产品许可证, 该关键字的值必须设置为 1, 表明对话框中的是按钮已被选中。然后, 安装进程将继续显示第二个“产品许可证登记”对话框。 如需有关在安静安装期间登记产品许可证的更多信息,请参阅"为产品许可证使用安静安装"。
[AskYesNo-1]节指定了您是否希望查看 README 文件 (特定于 Windows 的 TXSeries 发行说明)。 它包含了下列关键字:
如果希望查看该文件,该关键字的值必须设置为 1, 表明对话框中的是按钮已被选中。 README 文件可在文本编辑器中显示。
[SdFinishReboot-0]节包含了“产品安装完毕”对话框中的信息。它包含了下列关键字:
如果您希望自动重新引导机器, 将 BootOption 的值设置为 1, 并从响应文件和[DlgOrder]节的对话框列表中将最后的[MessageBox-0]节都删除。 请记住,要更新[DlgOrder]节中的 Count 关键字。
[MessageBox-0]节提示您稍后重新引导计算机。它包含了下列关键字:
如果您将[SdFinishReboot-0]节中的 BootOption关键字的值更改为 1, 则必须从响应文件中删除[MessageBox-0]节。另外, 还必须编辑[DlgOrder]节来删除对[MessageBox-0]的引用。 请记住,要更新 Count 关键字。
如果您希望在 CICS 的安静安装期间登记产品许可证, 必须对 CICS.ISS 响应文件作下列修改:
[SdShowDlgEdit1-0] szEdit1=licenseDirectory Result=1
[SdShowDlgEdit1-0]节包含了“登记产品许可证”表中的信息。
[DlgOrder] Dlg0=SdWelcome-0 Count=12 Dlg1=SdAskOptions-0 Dlg2=SdAskOptions-1 Dlg3=SdAskOptions-2 Dlg4=SdComponentDialog-0 Dlg5=SdAskDestPath-0 Dlg6=SdStartCopy-0 Dlg7=AskYesNo-0 Dlg8=SdShowDlgEdit1-0 Dlg9=AskYesNo-1 Dlg10=SdFinishReboot-0 Dlg11=MessageBox-0
本节描述了运行响应文件来启动 CICS 安静安装的方法。它提供了运行已编辑和未编辑响应文件的命令。
注意: | 如果您使用带有产品许可证的 CICS.ISS 文件, 必须在启动安静安装前,或者将许可证软盘插入到驱动器中,或者使许可证文件在本地网络驱动器或网络驱动器上可用。 响应文件必须有产品许可证的正确的盘符和路径。请参阅"为产品许可证使用安静安装"获得更多信息。 |
要启动一个使用还未编辑的响应文件的安静安装,请输入下列命令:
driveLetter:\x86\language\setup -s -f1responseFile -f2logPath\SETUP.LOG
其中的 driveLetter 是存储了 CICS 安装映像的 CD-ROM 驱动器、本地驱动器或网络驱动器, language 是包含安装 CICS 所使用语言的二进制文件的目录 (例如,en_US 目录用于英语二进制文件), responseFile 是 CICS.ISS 文件的完整路径名(例如, D:\x86\en_US\CICS.ISS), logPath 是存储 SETUP.LOG 文件的地方。
发出该命令后,可以检查 SETUP.LOG 文件来确定安静安装是否成功。 结果代码为 -0 表明 CICS 已在机器上安装成功。
要启动一个使用已编辑过的响应文件的安静安装,请输入下列命令:
driveLetter:\x86\language\setup -s -f1responseFile -f2logPath\SETUP.LOG
其中的 driveLetter 是存储了 CICS 安装映像的 CD-ROM 驱动器、本地驱动器或网络驱动器, language 是包含安装 CICS 所使用语言的二进制文件的目录 (例如,en_US 目录用于英语二进制文件), responseFile 是 CICS.ISS 文件的完整路径名(例如, C:\temp\cics.iss), logPath 是存储 SETUP.LOG 文件的地方。
发出该命令后,可以检查 SETUP.LOG 文件来确定安静安装是否成功。 结果代码为 -0 表明 CICS 已在机器上安装成功。
如果您要对安静安装进程作进一步的更改,郑重建议您参考 InstallShield 3 文档。 您可以从 InstallShield 公司获得文档。 也可以从 Web 站点 <A HREF="http://www.installshield.com">http://www.installshield.com</A> 中找到更多可用信息。
本章描述了从事务处理服务器 4.0.1 CICS 升级到 TXSeries 4.2 CICS 的过程。 在执行升级之前,必须确保满足了第 3 章 "CICS 先决条件"中描述的所有先决条件。
本章中的过程允许您用相应的配置,将每个现存的事务处理服务器 CICS 4.0.1 机器升级到 TXSeries CICS 4.2 机器。 就是说,该过程将机器的分布式计算环境(DCE)配置(完整客户机或仅远程过程调用(RPC))、 CICS 配置(区域或本地终端)以及文件管理器 (结构化文件服务器(SFS)服务器或 DB2 数据库)升级到相同 DCE 配置、 CICS 配置和文件管理器的当前版本。
请在每个要升级到 CICS 4.2 的机器上执行下列步骤:
如果您只运行 DCE 客户机,就不需要手工升级到 IBM DCE 2.0 了; 在 CICS 的升级期间就已自动完成它的升级。
注意: | 如果您的机器不支持自动播放选项,或者如果您已将它关闭, 必须手工启动 TXSeries 安装程序(位于 CD-ROM 上的 \x86 目录中)。 |
在升级期间,会出现“产品许可证登记”表, 询问您是否希望此时登记产品许可证。
注意: | 如果您没有在此时登记产品许可证, 请参考附录 A. "登记 TXSeries 许可证" 获得有关使用带评估许可证的 CICS 的信息。该附录还包含了在升级 CICS 后登记产品许可证的指令。 |
C:\> opt\cics\bin\cicsmigrate regionName 2>&1 | more
其中的 regionName 是正在升级的区域名称, 2>&1 将输出从 stderr 指向 stdout。 cicsmigrate 命令文件更新了 Windows NT 注册表项以及 CICS 资源定义中的各节。
C:\> opt\cics\bin\cicsdb2conf -I -r regionName -C -i instanceName -a databaseName -s
忽略有关队列对象创建的错误信息。
在上面的命令中,-I 选项使命令忽略不严重的错误, 而 -s 选项则抑制 XA 定义(XAD)的创建。 regionName 是使用相应 DB2 实例(instanceName)和 DB2 数据库(databaseName)的区域的名称。
*** CICS startup is complete ***
本章描述了如何为使用 CICS 4.2 而配置分布式计算环境 (DCE)。 配置 DCE 有两个选项:
注意: | 除非特别指出,本章仅包含配置 IBM DCE 客户机部件的指令。 如果您要配置其它的 IBM DCE 部件(包括 DCE 服务器),或者如果您要配置 Gradient DCE, 请参考 DCE 文档。 |
本节描述了如何将 IBM 或 Gradient DCE 配置为仅 RPC 环境。在对 CICS 使用仅 RPC 环境前, 必须执行下列任务;
本节描述了创建仅 RPC 环境的过程。 请注意,如果在您的机器上有依赖 DCE 服务的应用程序,就不能有仅 RPC 环境。还要注意, 如果您在机器上已配置并正在运行 DCE 客户机或 DCE 服务器,也不能有仅 RPC 环境。
请执行下列步骤来将 DCE 配置为一个仅 RPC 环境:
如果正在使用 Gradient DCE,请参考 DCE 文档获得删除客户机或服务器配置的指令。
C:\> cicscp -v -l logFile create dce -R
其中的 logFile 是 cicscp 日志文件的路径(例如, d:\temp\cicscp.log)。
本节描述了设置 CICS_HOSTS 环境变量的方法, 该环境变量使仅 RPC CICS 区域可以找到其它的 CICS 区域或 Encina 服务器。 必须将该变量设置为指定主机的网际协议(IP)地址或主机名, 该主机是在寻找需要与之连接的区域或 Encina 服务器字符串联接信息时, CICS 必须搜索的主机。
按下列方法设置 CICS_HOSTS 环境变量:
如果您要搜索多个主机,按下列方法输入主机名:
'hostA hostB hostC'
该语法使得 CICS 从第一个搜索到最后一个主机,直到找到所需的字符串联接信息。
请注意,您必须在设置了环境变量后重新引导机器,以使更改生效。如果您设置多个环境变量, 不需要每次都重新引导。将所有必需的环境变量都设置好以后, 重新引导一次即可。
注意: | 也可以对 cicsteld 命令使用 -h 选项来指定要搜索的主机。 如果使用该选项,您输入的值就覆盖了 CICS_HOSTS 的现存值。 如需有关 cicsteld 命令的更多信息, 请参考 CICS 管理参考大全。 |
本节描述了设置 ENCINA_BINDING_FILE 环境变量的方法, 该环境变量指向一个包含 Encina 服务器以及相应字符串联接(联编文件)的列表的文件。 设置该环境变量使 CICS 在试图连接到 Encina SFS 服务器时, 可以找到必需的字符串联接信息。
按下列方法设置 ENCINA_BINDING_FILE 环境变量:
dataDirectory\cics_servers\server_bindings
其中的 dataDirectory 是 \var 目录的位置。
请注意,您必须在设置了环境变量后重新引导机器,以使更改生效。
通过将 DCE 配置为现存 DCE 单元的一个客户机, 可以利用在单元中运行的 DCE 安全性服务器和单元目录服务(CDS)服务器提供的安全性服务和目录服务。 如果您希望拥有一个安全的 CICS 系统,这是推荐选项。在 DCE 客户机环境中使用 CICS 以前, 必须执行下列任务:
请执行下列步骤来将 IBM DCE 配置为一个现存单元的完整客户机:
If there is an existing configuration for this host, it will be overwritten if you proceed. Do you wish to continue?
一旦确认了您的选项并选择了结束按钮, 确认窗口就会消失,您返回到 DCEsetup 窗口, 开始配置进程。 DCEsetup 窗口显示了在配置进程期间生成的信息。
如果您已将 IBM DCE 配置为现存 DCE 单元的一个客户机, 就必须现在将 CICS 目录和组添加到单元目录服务(CDS)中。 它是在成功安装 CICS 后通过使用 cicssetupdce 命令实现的。 对于每个 DCE 单元它只需执行一次。
执行下列步骤:
C:\> cicssetupdce -v
该命令在 DCE 中创建必需的目录和组。 -v 标志用于显示在进程期间生成的信息。 如果这些组已经存在,它还会导致命令停止并产生错误信息。
cicssetupdce 命令创建了 CDS 的下列目录:
另外,cicssetupdce 命令还创建了 CDS 的下列组:
如需有关 cicssetupdce 命令的更多信息, 请参考 CICS 管理参考大全。
如果您希望对 CICS 区域使用 Telnet 客户机或 CICS 客户机 AIX 版, 本节描述了配置 IBM DCE 客户机的方法。 在创建完 CDS 必需的目录和组后执行该任务。
必须在每个包含将与客户机交互的区域的机器上执行该任务。
执行下列步骤来配置 DCE 客户机:
C:\> cicssetupclients -v
该命令创建了客户机的密钥表文件,并将它存储在 dataDirectory\cics_clients 目录中, 其中的 dataDirectory 是 CICS 数据目录(缺省情况下是 C:\var)。 该命令中使用的 -v 标志用于显示在进程期间产生的信息。
如需有关 cicssetupclients 命令的更多信息, 请参考 CICS 管理参考大全。
本章描述了配置用户信息控制系统(CICS)的方法。它提供了配置和启动 CICS 区域和文件管理器的指令。
要配置 CICS,您必须执行下列步骤:
在配置和启动 CICS 区域前,必须决定要使用何种类型的文件和队列管理器。
必须在配置和启动 CICS 区域前配置 DB2 数据库,以和 CICS 一起使用。 在机器上安装并设置了 DB2 后,请按照本节中的指令操作。
在开始配置 DB2 数据库以和 CICS 一起使用前,您必须确定下列内容:
要配置 DB2 以和 CICS 一起使用,请执行下列步骤:
DB2_RR_TO_RS=ON
C:\SQLIB\BIN> db2 connect to database
C:\SQLIB\BIN> db2 grant connect on database to user userID
其中的 userID 是在3 中选择使用的用户 ID。
C:\SQLIB\BIN> db2 connect reset
C:\SQLIB\BIN> db2 update dbm cfg using TP_MON_NAME libEncServer.dll
libEncServer.dll 文件存储在 Encina 可执行目录 (缺省情况下为 C:\opt\encina\bin)中, 该目录必须在 PATH 环境变量设置中。
C:\SQLIB\BIN> cicsdefaultservers
cicsdefaultservers 命令设置了包含用来定义 DB2 数据文件的缺省图表的文件系统。 如需有关使用模式文件的更多信息,请参考 CICS 管理指南。
本节描述了如何通过使用缺省定义来配置 CICS 区域的方法。 如果您计划使用本地 SFS 服务器用于文件和队列管理, 可以在配置 CICS 区域的同时创建它。 在 CICS 区域配置期间自动创建的 SFS 服务器有缺省名称和缺省定义。
如果您要用定制定义创建一个区域或 SFS 服务器, 请参考 CICS 管理指南。
本节假设您已有经过配置的 DCE 和(如果需要) DB2 数据库。
执行下列步骤来配置 CICS 区域:
注意: | 如果 Windows NT 机器配置为使用大字体,您在将文本输入到“管理实用程序”字段中时可能会有一些困难。 可以通过将 TSCFONTFACE 环境变量设置为 Lucida, 并且将 TSCFONTSIZE 环境变量设置为 8 来改变该限制。 |
userID,userPassword
如果在配置区域时选择了文件系统位于该机器上以及使用 SFS 选项, 同时还将创建并启动带有缺省定义的 SFS 服务器。 SFS 服务器必需的日志卷和数据卷就自动创建在 \var\cics_servers 目录中, 并在该进程中指定给服务器。SFS 服务器有一个缺省名称, /.:/cics/sfs/hostName(其中的 hostName 是在其上创建了服务器的本地机器的名称)。 同时也为 SFS 服务器创建了联编文件(缺省情况下是 server_bindings); 在仅 RPC 环境下使用该文件。 它存储在 \var\cics_servers 目录中。
如果您正在使用本地 SFS 服务器,CICS 文件就提供给 SFS 服务器, 并为服务器创建 CICS 用户 ID(缺省情况下是 ShostName, 其中的 hostName 表示在缺省 SFS 名称中使用的机器名称的前七个字母)。如果您正在使用 DB2 数据库, CICS 文件就提供给指定的数据库。
管理实用程序此时显示新区域(如果适用)和 SFS 服务器的定义,如图 2 所示。
如果您在配置区域时有问题,请检查错误日志获得重要信息。 可以通过从 CICS 管理实用程序的查看菜单中选择错误日志命令来访问该文件。
如果您要使用一个远程 SFS 服务器(在其它机器上,而非在您刚配置了 CICS 区域的机器上,运行的 SFS 服务器), 就必须在已配置了新的 CICS 区域后提供附加的配置信息。
要使用远程 SFS 服务器,按下列方法配置 CICS 区域:
在开始对 CICS 区域进行新的配置之前,郑重建议您配置对 CICS 本地终端的支持。 CICS 本地终端(cicslterm.exe)是仅在 Windows NT 上才有的无足轻重的 CICS 客户机。
本节中的过程描述了如何在机器上设置侦听程序进程, 以使区域可以侦听来自 CICS 本地终端的请求。因为您在定义了侦听程序进程后必须冷启动(即第一次启动)区域, 所以建议您在第一次启动新的 CICS 区域前执行该任务。
要通过添加侦听程序进程来配置对本地 CICS 终端的支持, 请使用 CICS 管理实用程序来执行下列步骤:
注意: | 两者兼有按钮将更改当前会话和所有将来会话的侦听程序定义。 两者兼有按钮一般用在区域正在运行时修改侦听程序定义的情况下。 |
ModelTerm = hft-mb
一旦您配置完 CICS 区域(如果需要,还有远程 SFS 服务器),就可以启动它了。当您启动 CICS 区域时, 任何没有在运行的相关的本地 SFS 服务器都将自动启动。
请执行下列步骤来启动 CICS 区域:
注意: | 第一次启动 CICS 区域时,会提示您注册 TXSeries 副本。如果您此时不注册副本的话, 该提示会在每次启动 CICS 区域时重复出现,直到您注册为止。 如果您选择现在联机注册 TXSeries,请按照“软件登记工具”屏幕中提供的指令操作。如果您要稍后再注册产品, 请参考"联机注册 TXSeries"。 |
在冷启动期间,CICS 将下列永久数据库中的资源定义文件装入到运行时数据库中:
如需有关资源定义文件的更多信息,请参考 CICS 管理指南。
如果您在启动区域时有困难,可以查看在启动进程期间 CICS 显示的信息,以帮助确定问题的原因。 要查看这些信息,从管理实用程序的查看菜单中选择控制台信息命令。 您也可以通过从查看菜单中选择错误日志和输出日志命令来查看输出和错误日志。
当配置和启动 CICS 区域以及本地 SFS 服务器时, 创建下列 Windows NT 服务:
您必须使用 CICS 管理实用程序来停止和启动这些服务。 不能使用 Windows NT 控制面板中的“服务”对话框来停止和启动 CICS 区域及 SFS 服务器。
当启动 CICS 区域时,任何与区域相关的未启动的 SFS 服务器也将启动。不过, 您也可以在 CICS 管理实用程序中通过执行下列步骤单独启动 SFS 服务器:
一旦您配置并启动了新的 CICS 区域,就可以按下列方法启动一个本地 CICS 终端了:
如果您在启动 CICS 区域期间出现注册提示时没有注册您所使用版本的 TXSeries, 可以通过使用软件注册实用程序现在注册。该实用程序存储在 IBM CICS 服务器 Windows NT 版程序组中。
请执行下列步骤来注册 TXSeries:
一旦您注册了软件,就可以使用软件注册实用程序来更新用户概要。 在软件注册工具中执行下列步骤来更新用户概要:
CICS 安装验证程序(IVP)可以用来确定 CICS 区域和本地终端是否在正确运行, 以及 CICS 应用程序(C 或 COBOL 语言编写的)是否可以在机器上被成功开发。
注意: | CICS IVP 必须在包含 CICS 区域和 CICS 本地终端的机器上运行。另外, 区域必须使用本地文件管理器(SFS 服务器或 DB2 数据库)。 |
以下部分中的指令需要您使用某些键来清除本地终端屏幕以及输入 CICS 提供的事务处理。 缺省情况下,清除屏幕操作映射为 ESC 键,输入操作映射为键盘右侧的 Ctrl 键。 您可以参考 \opt\cics\bin 目录中的 cicskey.ini 文件来确定其它用于 CICS 本地终端的缺省键映射。
本节描述了运行 C 程序设计语言的 CICS IVP 的过程。 可以使用该过程来测试产品和开发系统。
当使用 C 的 CICS IVP 时请注意下列方面:
执行下列过程来运行 C 的 CICS IVP:
Shutdown of CICS region 'regionName' is complete
C:\ > opt\cics\bin\cicsivp -r regionName -s serverName -v volumeName其中的 regionName 是要测试的区域名称, serverName 是 SFS 服务器的名称(缺省情况下是 /.:/cics/sfs/hostName), volumeName 是 SFS 服务器数据卷的名称,数据卷已在服务器的结构化文件服务器定义(SSD)一节中定义了。 当它显示了为 0 的返回码时该命令就成功了。
C:\> opt\cics\bin\cicsivp -r regionName -s databaseName其中的 regionName 是要测试的区域名称, databaseName 是用于文件管理的 DB2 数据库的名称。如果命令成功, 它显示为 0 的返回码。
C:\> nmake C
NAME: JOE ADDRESS: 123 MAIN PHONE: 5555555 DATE: 121597 AMOUNT: $1000.00 COMMENT: COMMENT
本节描述了运行 COBOL 程序设计语言的 CICS IVP 的过程。可以使用 IVP 来测试产品和开发系统。
当使用 COBOL 的 CICS IVP 时请注意以下方面:
执行下列过程来运行 COBOL 的 CICS IVP:
C:\> setmfenv 32
如果您要测试一个 CICS 开发系统,请不要关闭该命令提示窗口。
注意: | 该命令只在运行时环境中设置环境变量, 并且限制您从该命令提示上发出所有与 COBOL 相关的命令。如果您计划使用 COBOL 来开发 CICS 应用程序, 请参考对象 COBOL 入门一书获得有关永久设置必需的环境变量的更多信息。 |
Shutdown of CICS region 'regionName' is complete
C:\ > opt\cics\bin\cicsivp -r regionName -s serverName -v volumeName -l sampleLanguage其中的 regionName 是要测试的区域名称, serverName 是 SFS 服务器的名称,volumeName 是 SFS 服务器数据卷 (已在服务器的 SSD 资源定义中定义)的名称,sampleLanguage 是该样本使用的程序设计语言。 如果正在使用 Micro Focus COBOL,sampleLanguage 的值是 COBOL; 如果正在使用 IBM COBOL,值是 IBMCOB。
当它显示了为 0 的返回码时该命令就成功了。
C:\> opt\cics\bin\cicsivp -r regionName -s databaseName -l sampleLanguage其中的 regionName 是要测试的区域名称, databaseName 是 DB2 数据库的名称,sampleLanguage 是样本使用的程序设计语言。 如果正在使用 Micro Focus COBOL,sampleLanguage 的值是 COBOL; 如果正在使用 IBM COBOL,值是 IBMCOB。
如果命令成功, 它显示为 0 的返回码。
C:\> nmake COBOL
注意: | 必须从与在7中输入 setmfenv 命令所在的相同的命令提示中输入该命令。 |
C:\> nmake IBMCOB
对于 Micro Focus COBOL。 创建一个名为 installationDirectory\src\samples\ivp\COBOL 的目录。
对于 IBM COBOL。 创建一个名为 installationDirectory\src\samples\ivp\IBMCOB 的目录。
NAME: JOE ADDRESS: 123 MAIN PHONE: 5555555 DATE: 121597 AMOUNT: $1000.00 COMMENT: COMMENT
以下部分描述了在 Windows 机器上安装 Encina 所需的特定内存和磁盘空间。
Encina 软件可以安装在文件分配表(FAT)和 NT 文件系统(NTFS)驱动器上。不过, 因为软件使用只在 NTFS 驱动器上才可用的文件存取控制信息来提供安全系统,郑重建议您将 Encina 安装在 NTFS 驱动器上。
表 6 列出了运行 Encina 4.2 部件的机器所需的最小内存要求。
如果您在一个机器上使用多个 Encina 部件,请考虑在满足最小要求之外增加机器的内存。
请注意,内存需求不是累积的;例如,您不需要 128 MB 的内存来运行节点管理器和服务器。
在一个机器上运行的部件 | 必需的最小机器内存 |
Encina 单元管理器 | 64 MB |
Encina 节点管理器 | |
Encina 服务器(SFS、RQS、MAS) | |
Encina 客户程序 | 32 MB |
要检查机器上是否有可用的内存,请按照下列步骤操作:
要确定安装和使用 Encina 部件所需的磁盘空间的大小,必须同时考虑安装和运行所需的磁盘空间, 以及为安全地存储部件生成的数据所建议的磁盘空间。
部件必需的磁盘空间包括:
为安全存储由 Encina 部件产生的数据,建议的磁盘空间包括:
例如,如果您要在一个机器上安装和运行单元管理器,必须具有下列磁盘空间:
如果您按照 Transarc 的建议操作来防止数据丢失, 还需要至少 16 MB 的磁盘空间用于镜象单元管理器的日志卷和数据卷。
Encina 安装所需的磁盘空间根据安装的 Encina 部件不同,不同的机器可以有非常大的差别。
在安装 Encina 之前,您必须决定要在每个机器上运行哪些 Encina 部件;
使用第 2 章 "确定要安装的部件" 中的信息来确定需要哪些部件。
使用表 7 中的信息来确定为安装 Encina 部件,
在每个机器上需要多少磁盘空间。安装部件的磁盘空间是累积的。
Encina 部件 | 必需的磁盘空间 |
执行体 | 18 MB |
服务器核心程序 | 4 MB |
结构化文件服务器 | 2 MB |
可恢复队列服务 | 2 MB |
同级间通信网关(IBM SNA) | 1 MB |
监视器单元管理器 | 1 MB |
监视器节点管理器 | 1 MB |
监视器队列请求设施 | 26 KB |
应用程序开发环境 | 8 MB |
用于 Orbix 客户机的 OTS | 3 MB |
用于 Orbix 服务器的 OTS | 1 MB |
用于 Orbix 应用程序开发环境的 OTS | 4 MB |
另外,您可以分配下列磁盘空间:
必须分配一些磁盘空间来安装用于国家语言的 NLS 文件。 这些文件使 Encina 可以显示以选中语言显示的信息。 Encina 信息可以以美式英语、简体中文、法语、德语、意大利语、日语、韩语、巴西葡萄牙语和西班牙语显示。 每种语言的文件的大小大约是 1 MB。
注意: | Encina 图形用户界面(GUI), 例如 Enconsole 和 WinTidl,只用美式英语显示。 |
您必须至少为单元管理器、节点管理器、服务器和客户机提供最小数量的交换空间,
如表 8 所示。必需的交换空间的数量是累积的;
它为多个配置积累而成。
在一个机器上运行的进程 | 必需的最小交换空间(以 MB 为单位) |
单元管理器 | 26.0 |
节点管理器 | 14.0 |
带有一个处理代理(PA)的 MAS | 7.0 |
RQS 服务器 | 26.0 |
SFS 服务器 | 26.0 |
客户机 | 10.0 |
请注意下列内容:
要确定机器上有多少可用的交换空间,请按照下列步骤操作:
对于运行单元管理器或可恢复服务器的机器, 您必须提供一定的磁盘空间用于 Encina 主日志卷和数据卷。 同时郑重建议您提供一定的磁盘空间用于镜像日志卷和数据卷, 以及主数据卷的日志归档文件。 对于运行节点管理器的机器,您必须提供一定的磁盘空间用于 Encina 主日志卷(如果您选择要镜像卷的话, 还有它的镜像)。
表 9 列出了日志卷和数据卷、它们的镜像,
以及日志归档文件所需的最小磁盘空间数量。
请注意,您需要的实际数量取决于这些文件必须存储的记录的大小和数量。
要确定配置所用的合适的空间大小,建议您测量在原型系统上使用的日志卷和数据卷。
在机器上运行的部件 | 主数据卷 | 主日志卷 | 数据卷镜像 | 日志卷镜像 | 日志归档文件 |
---|---|---|---|---|---|
单元管理器 | 8 MB | 8 MB | 8 MB | 8 MB | 4 MB |
节点管理器 | N/A | 4 MB | N/A | 4 MB | N/A |
Encina 可恢复服务器 | 8 MB | 8 MB | 8 MB | 8 MB | 4 MB |
请注意下列事项:
如需有关管理 Encina 物理存储空间的信息,请参阅 Encina 管理指南第 1 卷:基本管理。
对于单元管理器、节点管理器和可恢复服务器, 郑重建议进行镜象卷来保证数据的可恢复性。 当为镜像卷分配空间时,请注意以下方面:
如需镜象的说明,请参阅 Encina 管理指南第 1 卷:基本管理。
对于单元管理器和 RQS 和 SFS 服务器, 因为需要媒体归档来恢复数据文件以及恢复备份数据, 所以郑重建议进行媒体归档。当为媒体归档生成的日志归档文件分配磁盘空间时, 请注意以下方面:
如需有关媒体归档的说明,请参阅 Encina 管理指南第 1 卷:基本管理。
本节描述了在 Windows NT 或 Windows 95 机器上安装 Encina 的软件先决条件。
在 Windows 机器上安装任何 Encina 部件前, 必须验证机器是否正在运行 Windows NT 或 Windows 95 操作系统的兼容版本。 必须运行 Windows NT 版本 4.0 (Service Pack 3) 或 Windows 95 (OEM 服务发行本 2)。
注意: | 如果您有 Windows 95 系统,可以只安装和运行 Encina 客户机。 |
Encina 4.2 已经过验证,可以和 IBM DCE 版本 2.0 (ECO-2) 以及 Gradient DCE 版本 2.1 一起使用。 如果您正使用 TXSeries 的 IBM DCE 版本, IBM DCE 2.0 客户机部件就包括在 TXSeries 软件 CD-ROM 中,并且, 如果您的机器上还没有 DCE,就自动安装它。 TXSeries 安装程序还将任何 IBM DCE 的以前版本升级到版本 2.0 (ECO-2)。
如果您正在使用 TXSeries 的 Gradient DCE 版本, 必须保证在安装 Encina 前已安装了版本 2.1。 请参考 Gradient DCE 文档获得更多信息。
如果您要在机器上安装任何 Encina 的用于 Orbix 的对象事务处理服务(OTS)部件, 必须将 Orbix 版本 2.3 安装在您的机器上。
Encina 4.2 已经过验证,可以和 IBM 通信服务器 Windows NT 版 版本 5.01 一起使用。 如果您要在 Encina 机器上配置并运行一个同级间通信(PPC)网关服务器,必须验证该通信服务器的版本已安装在机器上了。
如果您要使其它的第三方软件和 Encina 4.2 一起使用,必须安装那些文件, 尽管它们的安装不是 Encina 安装的先决条件。 Windows NT 和 Windows 95 版 TXSeries 特定于平台的发行说明提供了与 Encina 一起使用的对应版本的第三方软件的信息。
本章描述了在一个 Windows 系统中安装 Encina 软件的过程。该过程假设符合第 9 章 "Encina 先决条件"所描述的先决条件。 如果正在运行任何其它的 Windows 应用程序,建议您在安装 Encina 之前先退出这些应用程序。
如果已有了 TXSeries 的 IBM 分布式计算环境(DCE)版本,并且, 机器上还没有安装 DCE,那么在 Encina 的安装过程中将自动安装 DCE 客户机软件。 缺省情况下,DCE 将安装在 C:\Program Files\dce 目录下。如果希望将 DCE 安装在非缺省目录的其它目录中, 则必须在安装 Encina 之前手工安装它。
注意: | TXSeries 安装程序需要创建一个工作目录用于其资源。该目录是在 TEMP 环境变量所指向的位置中创建的。 工作目录需要 1 MB 的空间;因此,必须保证由 TEMP 变量所指向的目录有足够的可用空间。如果工作目录太小,就不能设置必需的资源, 安装进程就会失败。 |
要在机器上安装 Encina 客户机、服务器或者开发软件, 请执行下列任务:
注意: | 如果您的机器不支持自动播放选项,或者如果您已将它关闭, 必须手工启动 TXSeries 安装程序(位于 CD-ROM 上的 \x86 目录中)。 |
注意: | 如果选择了非缺省值的目录,请确保在路径名中没有空格 (避免例如 C:\My Files\Encina 这样的路径名)。 |
注意: | 如果您没有在此时登记产品许可证,请参考附录 A. "登记 TXSeries 许可证"获得有关使用带评估许可证的 Encina 的信息。 该附录还包含了在安装 Encina 后登记产品许可证的指令。 |
AUTOEXEC.bat 文件如果是写保护的,那么安装程序将不对其作修改。 而是由安装程序创建一个名为 AUTOEXEC.enc 的文件。比较这两个文件, 查看由安装程序所作的更改,然后用 AUTOEXEC.enc 来替换 AUTOEXEC.bat 文件。
在机器上安装了 Encina 之后,下列图标会出现在 Encina 程序文件夹中:
另外,如果没有许可证使用运行时软件,TXSeries 安装程序将为其创建一个程序文件夹。它包含了下列图标:
如果您的机器上已安装了 IBM DCE 客户机,下列图标就出现在 DCE Windows NT 2.0 版程序文件夹中:
在安装期间,TXSeries 安装程序创建或更新下列环境变量:
如果安装了应用程序开发环境部件,那么安装程序还将创建或更新下列环境变量:
如果安装了 IBM DCE 客户机,这些附加的环境变量就被创建或更新:
如果安装了许可证使用运行时软件,这些附加的环境变量就被创建或更新:
可以使用安静安装功能来安装 Encina 4.2,而无需经过任何 InstallShield 设置面板。 在安静安装期间,TXSeries 安装程序使用响应文件(ENCINA.ISS)中的信息来确定安装选项。
与 TXSeries 一起提供的 ENCINA.ISS 文件以安静方式将 Encina 应用程序开发环境安装到 Windows NT 系统缺省的目标安装目录 (C:\opt\encina)中。可以编辑响应文件来定制安装以使它符合您的需要。
为每种 TXSeries 4.2 所支持的国家语言都提供了一个 ENCINA.ISS 响应文件。 这些文件位于 CD-ROM 的 \x86\language 目录 (其中的 language 是 TXSeries 所支持的国家语言)中。 文件包含了关于每个部件名的转换字符串的信息,如果在安静安装中所使用的语言不是美式英语, 则必须使用这些信息来修改响应文件。
本节描述了与 TXSeries 一起提供的 ENCINA.ISS 文件的结构。 同时还提供了关于编辑响应文件的一些有用信息。
编辑响应文件时,请注意以下方面:
注意: | 如果已经将所有的 Encina 安装映像复制到网络驱动器或本地机器上的驱动器, 就不需要对响应文件作备份了。可以编辑所提供的文件,但不要对它重新命名。 |
美式英语版的 ENCINA.ISS 文件如下所示:
[InstallShield Silent] Version=v3.00.000 File=Response File [Application] Name=Encina Version=4.2 Company=TransarcCorporation [DlgOrder] Dlg0=SdWelcome-0 Count=10 Dlg1=SdAskOptions-0 Dlg2=SdAskOptions-1 Dlg3=SdAskOptions-2 Dlg4=SdComponentDialog-0 Dlg5=SdStartCopy-0 Dlg6=AskYesNo-0 Dlg7=AskYesNo-1 Dlg8=SdFinishReboot-0 Dlg9=MessageBox-0 [SdWelcome-0] Result=1 [SdAskOptions-0] Component-type=string Component-count=1 Component-0=English (United States) Result=1 [SdAskOptions-1] Component-type=string Component-count=1 Component-0=Encina Client/Server Result=1 [SdAskOptions-2] Component-type=string Component-count=1 Component-0=Encina Application Development Result=1 [SdComponentDialog-0] szDir=c:\opt\encina Component-type=string Component-count=9 Component-0=Executive Component-1=Server Core Component-2=Structured File Server Component-3=Recoverable Queueing Service Component-4=Peer-to-Peer Communications Gateway (IBM SNA) Component-5=Monitor Cell Manager Component-6=Monitor Node Manager Component-7=Application Queued Request Facility Component-8=Application Development Environment Result=1 [SdStartCopy-0] Result=1 [AskYesNo-0] Result=0 [AskYesNo-1] Result=0 [SdFinishReboot-0] Result=1 BootOption=0 [MessageBox-0] Result=1
ENCINA.ISS 文件包含了若干节, 每节都用 [ ](方括号)括起。下面的部分将对文件中的每一节进行描述。
[Application]节提供了软件的名称、 版本和设计它的公司。这些信息将存储在 Windows NT 注册表中。
[DlgOrder]节按 TXSeries 安装程序调用的顺序列出了 InstallShield 对话框(或窗口)。 缺省的 Encina 安静安装的对话框如下所示:
每个对话框都有一个包含了安静安装过程中所需信息的相应节。
本节包含了“欢迎”对话框中的信息。它包含了下列关键字:
[SdAskOptions-0] 节包含了“选择语言”对话框中的信息; 它指定了安装 Encina 所用的语言。 它包括下列关键字:
[SdAskOptions-1]节包含了第一个“选择要安装的产品”对话框中的信息。 它表明您正在安装 Encina 客户机/服务器产品。该节包括了下列关键字:
[SdAskOptions-2]节包含了第二个“选择要安装的产品”对话框中的信息。 允许您指定希望安装的 Encina 产品:客户机、服务器或应用程序开发环境。该节包括了下列关键字:
[SdComponentDialog-0]节包含了“选择部件”对话框中的信息。它允许您指定希望安装的 Encina 部件。 该节包含了下列关键字:
注意: | 当编辑本节时,必须确保为 Component-count 指定的数与在 Component-n 节 (其中的 n 是一个从 0 到 8 的数)中列出的部件数相等。 |
[SdStartCopy-0]节包含了“检查设置信息”对话框中的信息。它包含了下列关键字:
[AskYesNo-0] 节包含了“产品许可证登记”对话框中的信息。 该节表明您是否正在登记产品许可证。它包含了下列关键字:
如果要在安装进程期间登记产品许可证,该关键字的值必须设置为 1, 表明对话框中的是按钮已被选中。然后, 安装进程将继续显示第二个“产品许可证登记”对话框。 如需有关在安静安装期间登记产品许可证的更多信息, 请参阅"为产品许可证使用安静安装"。
[AskYesNo-1] 节指定了您是否希望查看自述文件(特定于 Windows 的 TXSeries 发行说明)。 它包含了下列关键字:
如果希望查看该文件,该关键字的值必须设置为 1, 表明对话框中的是按钮已被选中。自述文件可在文本编辑器中显示。
[SdFinishReboot-0]节包含了“产品安装完毕”对话框中的信息。它包含了下列关键字:
如果您希望自动重新引导机器,将值设置为 1, 并从响应文件和 [DlgOrder] 节的对话框列表中删除最后的 [MessageBox-0] 节。 请记住,要更新{DlgOrder]节中的 Count 关键字。
[MessageBox-0]节提示您稍后重新引导计算机。 它包含了下列关键字:
如果您将[SdFinishReboot-0]节中的 BootOption关键字的值更改为 1, 则必须从响应文件中删除[MessageBox-0]节。另外, 还必须编辑[DlgOrder]节来删除对[MessageBox-0]的引用。 请记住,要更新 Count 关键字。
如果您希望在安静安装期间登记产品许可证, 必须对 ENCINA.ISS 响应文件作下列修改:
[SdShowDlgEdit1-0] szEdit1=licenseDirectory Result=1
[SdShowDlgEdit1-0] 节包含了“登记产品许可证”表格中的信息。
[DlgOrder] Dlg0=SdWelcome-0 Count=11 Dlg1=SdAskOptions-0 Dlg2=SdAskOptions-1 Dlg3=SdAskOptions-2 Dlg4=SdComponentDialog-0 Dlg5=SdStartCopy-0 Dlg6=AskYesNo-0 Dlg7=SdShowDlgEdit1-0 Dlg8=AskYesNo-1 Dlg9=SdFinishReboot-0 Dlg10=MessageBox-0
本节描述了如何运行响应文件来启动 Encina 的安静安装。它提供了运行已编辑和未编辑的响应文件的命令。
注意: | 如果您使用带有产品许可证的 ENCINA.ISS 文件, 必须在启动安静安装前,或者将许可证软盘插入到驱动器中, 或者使该许可证文件在本地驱动器或网络驱动器上可用。响应文件必须有产品许可证的正确的盘符和路径。 请参阅"为产品许可证使用安静安装"获得更多信息。 |
要启动一个使用还未编辑的响应文件的安静安装,请输入下列命令:
driveLetter:\x86\language\setup -s -f1responseFile -f2logPath\SETUP.LOG
其中的 driveLetter 是存储了 Encina 安装映像的 CD-ROM 驱动器、 本地驱动器或网络驱动器,language 是包含安装 Encina 所使用语言的二进制文件的目录 (例如,en_US 目录用于英语二进制文件), responseFile 是 ENCINA.ISS 文件的完整的路径名 (例如 D:\x86\en_US\ENCINA.ISS), logPath 是存储 SETUP.LOG 文件的地方。
发出该命令后,可以检查 SETUP.LOG 文件来确定安静安装是否成功。结果代码为 -0, 表明 Encina 已在机器上安装成功。
要启动一个使用已编辑过的响应文件的安静安装,请输入下列命令:
driveLetter:\x86\language\setup -s -f1responseFile -f2logPath\SETUP.LOG
其中的 driveLetter 是存储了 Encina 安装映像的 CD-ROM 驱动器、 网络驱动器或本地驱动器,language 是包含安装 Encina 所使用语言的二进制文件的目录 (例如 en_US 目录用于英语二进制文件), responseFile 是 ENCINA.ISS 文件的路径名 (例如 C:\temp\encina.iss), logPath 是存储 SETUP.LOG 文件的地方。
发出该命令后,可以检查 SETUP.LOG 文件来确定安静安装是否成功。结果代码为 -0, 表明 Encina 已在机器上安装成功。
如果您要对安静安装进程作进一步的更改,郑重建议您参考 InstallShield 3 文档。 您可以从 InstallShield 公司获得文档。 还可以从 Web 页面 <A HREF="http://www.installshield.com">http://www.installshield.com</A> 找到更多可用信息。
本章描述了在 Windows 机器上安装 Encina 用于 Orbix 的对象事务处理服务(OTS)软件的过程。 该过程假设满足了第 9 章 "Encina 先决条件"中所描述的先决条件。 郑重建议您不要在同一台机器上安装 OTS 和 Encina。
如果正在运行任何其它的 Windows 应用程序,建议在安装 OTS 之前先退出这些应用程序。
注意: | TXSeries 安装程序需要一个工作目录用于其资源。 该目录是在 TEMP 环境变量指向的位置中创建的。该工作目录需要 1 MB 的空间;因此, 必须确保 TEMP 指向的目录有足够的可用空间。如果工作目录太小,就不能设置必需的资源, 安装进程就会失败。 |
要在机器上安装 OTS 软件,请执行下列任务:
注意: | 如果您的机器不支持自动播放选项,或者您已将它关闭, 则必须手工启动 TXSeries 安装程序(位于 CD-ROM 上的 \x86 目录中)。 |
注意: | 如果选择的目的地目录不是缺省目录,请确保在路径名中没有使用空格 (避免例如 C:\My Files\Encina 这样的路径名)。 |
在机器上安装了 OTS 之后,下列图标会出现在 Encina 程序文件夹中:
请参考 Encina 面向对象编程指南获得有关使用 Encina 用于 Orbix 的 OTS 的信息。
本章描述了从 Encina 2.2 升级到 TXSeries Encina 4.2 的过程。 在执行升级之前,必须确保满足了第 9 章 "Encina 先决条件"中描述的所有先决条件。
必须在每台要升级到 Encina 4.2 的机器上执行下列步骤。可按任何顺序升级 Encina 机器。 当升级一个节点时,必须停止在该机器上运行的所有 Encina 进程。 当升级一台运行单元管理器的机器时, 必须停止在单元管理器机器上运行的所有 Encina 进程。请注意,当升级正在运行单元管理器的机器时, 该单元中的节点管理器无法和单元管理器进行交互。一旦单元管理器升级成功并重新启动后, 该节点管理器就可以和单元管理器重新建立联系了。
如果监视器单元中包含了多个节点,升级前要知道,升级单元管理器需要停止单元管理器。 如果在未关闭多节点单元中其它节点上的服务器的情况下停止了该单元的单元管理器, 则可能会丢失发送到 Enconsole 的重要信息。 如果要确保所有重要信息都被保存,可以先停止其它节点上的服务器,然后再关闭单元管理器。 不需要关闭单元内的其它节点管理器。
注意: | 作为该过程的一部分,应当将 Encina 目录根、 镜像目录根以及任何 Encina 日志卷和数据卷备份到一个不受升级影响的地方。 使用常用的方法备份 Encina 卷。如果一般是使用管理命令 (例如 tkadmin backup lvol)来备份卷的, 必须在关闭本地服务器前进行备份。如果一般是使用操作系统实用程序来备份卷的, 则必须在停止本地 Encina 服务器后、安装 Encina 4.2 之前进行备份。 |
执行下列步骤来升级 Encina 软件:
要关闭一个服务器,请从操作菜单中选择关闭服务器命令。在选择框中选择该服务器, 然后再选择确定按钮。Enconsole 关闭选择框, 显示“命令状态”显示屏,然后停止服务器。选择确定按钮,关闭“命令状态”屏幕。
C:\>\opt\encina\bin\tkadmin stop server -server /.:/cellName/node/nodeName
系统显示一个取消标记来确认节点管理器已停止。
C:\>\opt\encina\bin\tkadmin stop server -server /.:/cellName/ecm
系统显示一个取消标记来确认单元管理器已停止。
要更改启动类型,可以从“服务”对话框中选择启动按钮, 然后从“服务”对话框的启动类型列表中选择手工选项。选择确定按钮关闭对话框。
注意: | 如果您的机器不支持自动播放选项,或者您已将它关闭, 则必须手工启动 TXSeries 安装程序(位于 CD-ROM 的 \x86 目录中)。 |
否则,选择否按钮,跳至21,继续升级进程。
注意: | 如果此时不登记产品许可证,请参考附录 A. "登记 TXSeries 许可证"获得有关使用带评估许可证的 Encina 的信息。 该附录还包含了在 Encina 升级后登记产品许可证的指令。 |
C:\> opt\encinalocal\cellName\ecm\encina.cell.cmd
请不要关闭命令提示窗口,除非想停止单元管理器。
Erasing node nodeName will erase its restart data. The node will need to be cold started once the operation completes. Proceed?
选择是按钮。删除节点管理器不影响任何由节点管理器管理的服务器。
The cell manager is using principal '/.../dceCell/cellName'; is this correct? ('Yes' to accept)
选择是按钮。
对于每个重新启动的服务器,请从选择框中选择服务器,然后再选择确定按钮。Enconsole 关闭选择框, 显示“命令状态”显示屏,然后启动服务器。选择确定按钮,关闭“命令状态”屏幕。
C:\> \opt\encina\etc\addOperatorToAcl.cmd cellName serverName encina_operator_group
本节描述了创建新的 Encina 操作员委托人和组所需执行的任务。这些对象不是自动创建的, 所以必须以手工方式创建它们。Encina 操作员委托人和 Encina 操作员组的成员将受到比 Encina 管理组成员 (缺省情况下为 encina_admin_group)更多的管理许可权的限制。如需有关新委托人和组的更多信息, 请参阅发行说明以及第 16 章 "配置 Encina"。
执行下列任务来创建 Encina 操作员委托人和组:
dcecp> login DCEAdministrativePrincipal
dcecp> principal create encina_operator
dcecp> group create encina_operator_group -inprojlist yes
dcecp> group add encina_operator_group -member encina_operator
dcecp> group add encina_operator_group -member encina_admin
dcecp> organization add none -member encina_operator
dcecp> account create encina_operator -group encina_operator_group -organization none -password encinaOperatorPassword -mypwd cellAdminPassword
dcecp> exit
C:\> \opt\encina\etc\2.0_upgrade.cmd cellName
该脚本将新创建的 Encina 操作员委托人的有关信息插入到单元仓库。
本章描述了从 Encina 2.5.1 升级到 TXSeries Encina 4.2 的过程。 在执行升级之前,必须确保满足了第 9 章 "Encina 先决条件"中描述的所有先决条件。
注意: | 要从 Encina 2.5.1 之前的 Encina 版本升级到 Encina 4.2, 首先必须升级到 Encina 2.5.1,然后再升级到 Encina 4.2。如需有关升级到 Encina 2.5.1 的信息, 请与您的用户支持代理人联系。 |
必须在每台要升级到 Encina 4.2 的机器上执行下列步骤。可按任何顺序升级 Encina 机器。 当升级一个节点时,必须停止在该机器上运行的所有 Encina 进程。 当升级一台运行单元管理器的机器时,必须停止在单元管理器所在机器上运行的所有 Encina 进程。 请注意,当升级运行单元管理器的机器时, 该单元中的节点管理器无法和单元管理器进行交互。一旦单元管理器升级成功并重新启动后, 该节点管理器就可以和单元管理器重新建立联系了。
如果监视器单元中包含了多个节点,升级前要知道,升级单元管理器需要停止单元管理器。 如果在未关闭多节点单元中其它节点上服务器的情况下停止了该单元的单元管理器, 则可能会丢失发送到 Enconsole 的重要信息。 如果要确保所有重要信息都被保存,可以先停止其它节点上的服务器,然后再关闭单元管理器。 不需要关闭单元内的其它节点管理器。
注意: | 作为该过程的一部分,应当将 Encina 目录根、 镜像目录根以及任何 Encina 日志卷和数据卷备份到一个不受升级影响的地方。 使用常用的方法备份 Encina 卷。如果一般是使用管理命令 (例如 tkadmin backup lvol)来备份卷的, 必须在关闭本地服务器前进行备份。如果一般是使用操作系统实用程序来备份卷的, 则必须在停止本地 Encina 服务器后,安装 Encina 4.2 之前进行备份。 |
执行下列步骤来升级 Encina 软件:
要关闭一个服务器,请从操作菜单中选择关闭服务器命令。在选择框中选择该服务器, 然后再选择确定按钮。Enconsole 关闭选择框, 显示“命令状态”显示屏,然后停止服务器。选择确定按钮,关闭“命令状态”屏幕。
如果您正在使用 IBM DCE,但机器上没有安装 2.0 版,在 Encina 升级期间,DCE 将自动升级为 2.0 版本。
注意: | 如果您的机器不支持自动播放选项,或者如果您已将它关闭,则必须手工启动 TXSeries 安装程序 (位于 CD-ROM 的 \x86 目录中)。 |
注意: | 如果此时不登记产品许可证, 请参考附录 A. "登记 TXSeries 许可证"获得使用带评估许可证的 Encina 的信息。 该附录还包含了在 Encina 升级后登记产品许可证的指令。 |
C:\> opt\encinalocal\cellName\ecm\encina.cell.cmd
C:\> opt\encinalocal\cellName\node\nodeName\encina.nodeName.cmd start -enable
对于每个重新启动的服务器,请从选择框中选择服务器,然后再选择确定按钮。Enconsole 关闭选择框, 显示“命令状态”显示屏,然后启动服务器。 选择确定按钮关闭“命令状态”屏幕。
本章描述了如何将 IBM 分布式计算环境 (DCE) 配置为现存单元的一个客户机。通过将 DCE 配置为一个客户机, 可以利用在 DCE 单元中运行的 DCE 安全性服务器和单元目录服务(CDS)服务器所提供的安全性服务和目录服务。
注意: | 本章包含了配置 IBM DCE 客户机的指令。如果您要配置其它的 IBM DCE 部件(包括 DCE 服务器) 或希望配置 Gradient DCE 客户机,请参考 DCE 文档。 |
要将 DCE 配置为现存单元的一个完整的客户机,请执行下列步骤:
If there is an existing configuration for this host, it will be overwritten if you proceed. Do you wish to continue?
一旦确认了您的选项并选择了结束按钮, 确认窗口就会消失,您返回到 DCEsetup 窗口, 开始配置进程。 DCEsetup 窗口显示了在配置进程期间生成的信息。
本章描述了如何配置一个基本的 Encina 监视器单元, 该单元中包含一个单元管理器、 一个节点管理器和一个结构化文件服务器 (SFS) 服务器。
要配置一个监视器单元,必须设置本地环境, 然后定义并启动一个单元管理器和至少一个节点管理器。为每个监视器单元定义一个单元管理器, 为监视器单元中的每个节点(机器)定义一个节点管理器。 使用 Enconsole 监视和管理监视器单元中的服务器。 因为单元是一个分布式的 Encina 系统, 所以可以在分布式计算环境(DCE)单元中的任何节点上启动 Enconsole 并复查整个单元中的有关服务器和节点的信息。
本章中的过程描述了如何设置本地环境、 如何在监视器单元中的第一台机器上定义和启动单元管理器、 节点管理器和 SFS 服务器。 一旦监视器单元已在运行, 您就可以在单元中的其它机器上配置附加的节点管理器和服务器。
下列步骤概述了配置监视器单元的过程:
如果在配置过程中,Enconsole 命令一直没有成功, 则复查 Enconsole 在“命令状态”显示屏上显示的信息,然后再次执行该命令。 如果单元管理器、节点管理器或服务器的 Start 命令没有成功, 那么您也可以复查存储在服务器工作目录下的输出文件 (缺省值为 server.out) 中的信息。
在执行了本章中的这些步骤后,您就可以设置附加的节点和服务器来扩充监视器单元。 请参阅 Encina 管理指南第 1 卷:基本管理获得更多信息。
本节描述了使用 Encina 所必需的本地环境设置,包括操作系统标识符、 文件系统目录和环境变量。 单元中的每台机器上都必须设置环境。
缺省情况下,Enconsole 用名为 encina 的操作系统用户和名为 encina 的组定义所有服务器 (除单元和节点管理器外)。 Enconsole 自动授予 encina 用户 ID 对 Encina 目录和文件所必需的操作系统许可权。
对于在 UNIX 上运行的服务器。 服务器“进程选项”表中的用户名和组名字段值必须与目标 UNIX 平台 (服务器将要在其上运行的机器)上所使用的用户和组名匹配。如果正使用 Enconsole 缺省值, 则必须使用标准操作系统过程来在目标机器上创建 encina 用户和组。 组 encina 必须是用户 encina 的主组。
对于在 Windows NT 上运行的服务器。 “进程选项” 表中的用户名和组名字段值可忽略; 不必在目标 Windows NT 机器(服务器将要在其上运行的机器)上创建 encina 用户和组标识符。
在任何机器上配置 Encina 之前,必须创建存储卷 (用于在该机器上运行的 Encina 服务器) 的物理设备。 运行 Encina 服务器所需要的物理存储空间的大小取决于服务器的需求。 由于服务器所管理的数据和事务的数量不断增加, 服务器对磁盘空间的需求也不断增加。磁盘空间不足会影响服务器的操作, 所以在分配磁盘空间时请不要吝啬。
Encina 服务器数据存储在逻辑卷中。使用逻辑卷可能是出于两个目的之一:作为日志卷 (存储服务器的日志文件) 或作为数据卷 (存储服务器的应用数据)。监视器单元管理器、 SFS 服务器和可恢复队列服务(RQS)服务需要一个日志卷及一个或多个数据卷。监视器节点管理器和同级间通信 (PPC)网关服务器仅需要一个日志卷。请参阅 Encina 管理指南第 1 卷:基本管理获得有关卷的更多信息。
卷的大小取决于它必须存储的记录的大小和数量。 节点管理器和 PPC 网关服务器记录少量的数据, 因为它们记录的只是事务状态数据(而非应用数据)。单元管理器、 SFS 服务器和 RQS 服务器需要较大的日志卷。例如, 在生产系统中实现单一应用的 SFS 或 RQS 服务器可以记录大量的数据并需要一个 64 MB 或更大的日志卷。 如需有关 Encina 服务器建议的最小卷大小的更多信息, 请参阅第 9 章 "Encina 先决条件"。
所需的物理设备类型取决于您使用的平台。物理设备可以是:
在非 AIX UNIX 系统上。 使用 UNIX 实用程序创建您需要的磁盘分区。
在 AIX 系统上。 使用 AIX 实用程序创建您需要的 AIX 逻辑卷。
在 Windows NT 系统上。 使用 Windows NT 磁盘管理器创建逻辑磁盘驱动器或完全分配的操作系统文件。 可以使用 Encina fileVol 程序(或自己的程序)创建操作系统文件。fileVol 程序位于 installationDirectory\etc 中。命令语法为
fileVol fileName fileSize
fileName 变量指定您要创建的文件的名称。 fileSize 变量指定以字节、千字节(KB) 或兆字节(MB) 为单位的文件大小。 要指定字节,请输入一个整数。 千字节 (KB) 用后面带字母 k 的整数来指定, 兆字节 (MB) 用后面带字母 M 的整数来指定。
使用下列命令创建一个名为 rqs1data 的 8 MB 的操作系统文件:
C:\> fileVol D:\rqs1data 8M
8m bytes is 8388608 bytes. Set D:\rqs1data to 8388608 bytes.
该文件可在磁盘分区(逻辑驱动器) 上或在跨越多个磁盘的一个卷或磁条集上找到。一个文件可占用一个完整的磁盘或磁盘分区。 强烈反对使用网络或软盘存储 Encina 逻辑卷。不要将这些文件存储在压缩文件系统中或 RAM 磁盘上。 推荐使用 Windows NT 文件系统(NTFS)分区。
Enconsole 在目标机器(服务器将要在其上运行的机器)的本地盘上自动创建 Encina 服务器的目录结构。在 Enconsole 中, 这些目录是指目录根和镜像目录根。例如,在 UNIX 上创建的缺省目录为
在 UNIX 系统上,缺省情况下在同一个 UNIX 文件系统上创建目录根及其镜像。 在 Windows NT 系统上,目录根的缺省位置为安装 Encina 的驱动器。镜像目录的缺省位置是所找到的最低的盘符, 只要该驱动器不是软盘驱动器、RAM 磁盘、网络驱动器或(如果可能)与目录根的缺省值相同的驱动器即可。 在生产环境中,更改这些缺省目录位置,使镜像目录存储在单独的物理盘上。在 UNIX 上, 可用符号链接或文件系统安装点来达到这种效果而无需更改缺省路径。
在启动服务器时, Enconsole 自动创建顶层目录的子目录来存储并组织服务器的输出、 重新启动、密钥表和日志归档文件。图 9 说明了在名为 branch1 的监视器单元中运行的监视器单元管理器 (ecm) 的 Encina 目录结构。 显示的目录路径是大多数 UNIX 平台和 Windows NT 系统的缺省值。
对于在 UNIX 系统上运行的服务器。 在目标平台上自动创建目录根及其镜像。为保证可恢复性, 更改缺省值,使 /opt/encinalocal 目录及其镜像存储在不同的分区中 (使用到其它物理磁盘上文件系统的符号链接)。请记住, 要更改链接目标的许可模式并将所有者和组更改为 encina。
下列命令显示了如何创建 /opt/encinalocal 和 /opt/encinamirror 目录以及设置对它们的访问权。 在命令中,otherPartition 是指驻留在其它物理磁盘上的不同的 UNIX 分区。 您必须以 root 登录来输入命令。
# mkdir /opt/encinalocal # mkdir /otherPartition/encinamirror # ln -s /otherPartition/encinamirror /opt/encinamirror # chmod 755 /opt/encinalocal # chmod 755 /otherPartition/encinamirror # chown encina /opt/encinalocal # chown encina /otherPartition/encinamirror # chgrp encina /opt/encinalocal # chgrp encina /otherPartition/encinamirror
对于在 Windows NT 系统上运行的服务器。 在目标机器上自动创建目录根及其镜像。 可以使用 Windows NT 资源管理器以保证只有适当的用户才对 \opt\encinalocal 目录下的文件有写许可权。
要保证可恢复性,验证(如果必要,并更改)缺省值, 使 \opt\encinalocal 目录存储在与其镜像不同的驱动器上。 指定驻留在其它物理磁盘上的分区盘符。不要将这些目录存储在压缩文件系统中、RAM 磁盘上或网络驱动器上。出于安全性考虑, 极力推荐使用 Windows NT 文件系统 (NTFS)。
可能需要在运行 Encina 的机器上设置 NLSPATH 环境变量。特定于平台的发行说明包含了有关设置 NLSPATH 的信息。 因为每次使用 Enconsole 时都必须设置该环境变量,所以将环境变量设置选项添加到 .login 或 .cshrc 文件 (UNIX 系统上)或系统环境变量(Windows NT 系统上)中比较实际。
启动 Enconsole 会话的进程取决于您使用的平台。 本节提供了在 Windows NT 和 UNIX 系统上启动 Enconsole 的指令。
在 Windows NT 系统上:
注意: | 不要从网络驱动器、RAM 磁盘或可删除媒体中运行 Enconsole。 |
Enconsole 显示了“单元名称”表 (如图 11 所示)。
注意: | 您可以创建 Enconsole 的快捷方式并修改快捷方式的属性, 使监视器单元的名称作为命令行变量传递给 enconsole 程序。 如果指定了一个传递到 enconsole 程序的单元名称, 将提示您在每次启动 Enconsole 时输入监视器单元。(要修改快捷方式, 请选择“enconsole 快捷方式属性”框中的 快捷方式标签。 在目标字段中,在可执行路径名后输入监视器单元名称。) |
Enconsole failed to connect to the cell. Do you wish to define and start a cell?
注意: | 如果还没有登录到 DCE 上,Enconsole 将显示下列信息:
Initialization will continue after you DCE-login from the Misc menu. 转至"注册到 DCE" 并按照登录到 DCE 的指令操作。一旦建立了 DCE 登录场境,返回到本节中的这一步。 Enconsole 会询问您是否要定义并启动一个单元。 |
在 UNIX 系统上:
% enconsole &
Enconsole 提示您在“单元选择”表 (该表与图 11 中所示的“单元名称”表类似) 中输入 Encina 监视器单元名称。
Enconsole failed to connect to the cell. Do you wish to define and start a cell?
注意: | 如果还没有登录到 DCE 上,Enconsole 将显示下列信息:
Initialization will continue after you DCE-login from the Misc menu. 转至"注册到 DCE" 并按照登录到 DCE 的指令操作。一旦建立了 DCE 登录场境,返回到本节中的这一步。 Enconsole 会询问您是否要定义并启动一个单元。 |
在使用 Encina 中的单元、节点和服务器之前,必须登录到 DCE 上。对于大多数的管理任务, 可以以 Encina 操作员委托人(缺省情况下名为 encina_operator)登录。 然而对于特定的任务,则必须以 DCE 管理委托人或 Encina 管理委托人来进行认证。 如果尝试执行一项需要您以另一个委托人登录的任务,Enconsole 将提示您输入该委托人的口令。
Encina 所用的三个缺省委托人为:
执行下列步骤从 Enconsole 内注册到 DCE 上:
本节说明了如何使用 Enconsole 提供的缺省值定义和启动单元管理器。您必须在单元管理器将要在其上运行的机器上定义并启动一个单元管理器。 不能远程定义单元管理器。为每个监视器单元只定义一个单元管理器。
必须在同一个 Enconsole 会话中定义和启动该单元管理器。 如果在定义后不启动单元管理器, 则在退出 Enconsole 时不保存该单元管理器定义。
定义和启动单元管理器的登录需要:
本节描述了如何使用 Enconsole 所提供的缺省值定义一个单元管理器。“单元管理器”表(如图 14 所示) 定义单元管理器的配置。按照本节中的步骤操作时, 请提供特定于您的监视器单元的信息。例如, 用您使用的磁盘名来替代所显示的示例磁盘名。如果一个字段在以下步骤中没有提及, 请接受它的缺省值。请参阅 Enconsole 联机帮助获得有关这些字段的更多信息。
执行下列步骤来定义单元管理器:
图 15. “EncinaLocal 和 EncinaMirror 验证”表
您对该表所做的任何更改都是持久的,并将影响以后所有的 Enconsole 会话。选择确定按钮。
注意: | Encina 目录根及其镜像的位置将存储在 HKEY_LOCAL_MACHINE\SOFTWARE \TransarcCorporation\Encina\SystemConfiguration 子键的 Windows NT 注册表中。 Encina 目录根的值项其中一例为 Encinalocal: REG_SZ: C:/opt/encinalocal。 要更改 Encina 目录根及镜像的位置,可以删除或修改注册表中它们的相应的值项。 如果删除注册表中的项,Enconsole 会用缺省值重新显示“EncinaLocal 和 EncinaMirror”表。 在使用 NT 注册表时,请务必非常小心。 |
在 Windows NT 和 非 AIX UNIX 系统上。在日志卷磁盘名字段中, 输入您打算在其上存储单元管理器的事务日志数据的磁盘的路径名。 在 Windows NT 中,磁盘是一个在表 \\.\driveName (例如,\\.\D:) 中指定的逻辑磁盘驱动器, 在表 \\.\PHYSICALDRIVEdriveNumber (例如,\\.\PHYSICALDRIVE3) 中指定的一个完整的物理磁盘, 或者是某个操作系统文件的完整的路径名,包含了盘符 (例如, D:\filevol1)。
在 AIX 系统上。 在日志卷磁盘名字段中, 输入您打算在其上存储单元管理器的事务日志数据的 AIX 逻辑卷的名称。
在 Windows NT 和 非 AIX UNIX 系统上。在日志卷镜像磁盘名字段中, 输入您打算在其上存储事务日志数据的镜像或备份的磁盘的路径名。
在 AIX 系统上。 Enconsole 不用来指定日志卷镜像磁盘名。
在 Windows NT 和 非 AIX UNIX 系统上。 在数据卷磁盘名字段中, 输入您打算在其上存储单元管理器数据的磁盘路径名。
在 AIX 系统上。 在数据卷磁盘名字段中, 输入您打算在其上存储单元管理器的数据的 AIX 逻辑卷的名称。
在 Windows NT 和 非 AIX UNIX 系统上。 在数据卷镜像磁盘名字段中, 输入您打算在其上镜像数据的磁盘的路径名。
在 AIX 系统上。Enconsole 是用来指定数据卷镜像磁盘名。
验证可执行文件和工作目录字段中的值。 单元管理器可执行文件的缺省值是 installationDirectory\bin\ecm,其中的 installationDirectory 是安装 Encina 的目录名(例如,C:\opt\encina)。 工作目录用于确定输入输出文件的位置。 单元管理器的缺省工作目录基于单元名称。 它是完整的路径名 directoryRoot\monitorCell\ecm,其中的 directoryRoot是顶层 Encina 目录(例如, \opt\encinalocal) 的名称,monitorCell 是监视器单元的名称。
如果不希望使用显示的缺省路径名, 可以更改这些字段的值。
验证安全性对象和单元管理器属性的缺省值。 使用 Enconsole 联机帮助可获得特定字段的信息。 您对这些值所做的任何更改都是持久的,并将影响以后所有的 Enconsole 会话。
要启动一个单元管理器,必须在单元管理器将要在其上运行的机器上使用 Enconsole。 当首次启动(冷启动)单元管理器时,Enconsole 在该单元的 Encina 根和镜像目录下创建文件。 图 9 显示了 Encina 为名为 branch1 的样本监视器单元创建的目录结构和文件。
另外,Enconsole 在冷启动单元时执行下列管理任务:
执行下列步骤从 Enconsole 中启动单元管理器:
注意: | 如果您正在冷启动单元管理器,则必须以 DCE 管理委托人进行认证。 |
每个在监视器单元中正运行服务器的节点都必须有一个控制本地服务器活动的节点管理器。 该单元管理器与单独的节点管理器通信。 每个监视器单元中必须至少有一个被管理的节点。
要定义一个节点管理器,可以在任何节点上使用 Enconsole。不过,要启动一个节点管理器,则必须在节点将要在其上运行的机器上使用 Enconsole。
定义和启动一个节点管理器的登录需要:
本节说明了如何使用 Enconsole 提供的缺省值定义节点管理器。 按照本节中的步骤操作时,请提供特定于您的节点的信息。例如, 用您使用的磁盘名来替代所显示的示例磁盘名。 如果一个字段在以下步骤中没有提及, 请接受它的缺省值。 请参阅 Enconsole 联机帮助获得有关这些字段的更多信息。
该过程假设您是以 Encina 管理委托人登录到 DCE 上的。
执行下列步骤在 Enconsole 中定义一个节点管理器:
注意: | 为保证可恢复性,请确保目录根及其镜像目录根驻留在不同的驱动器(不同的物理磁盘)上。 |
您对该表所做的任何更改都是持久的,并将影响以后所有的 Enconsole 会话。
注意: | Encina 目录根及其镜像的位置将存储在 HKEY_LOCAL_MACHINE\SOFTWARE \TransarcCorporation\Encina\SystemConfiguration 子键的 Windows NT 注册表中。 Encina 目录根的值项其中一例为 Encinalocal: REG_SZ: C:/opt/encinalocal。 要更改 Encina 目录根及镜像的位置,可以删除或修改注册表中它们的相应的值项。 如果删除注册表中的项,Enconsole 会用缺省值重新显示“EncinaLocal 和 EncinaMirror”表。 在使用 NT 注册表时,请务必非常小心。 |
不过,如果该机器上已有单元管理器在运行, Enconsole 还是使用定义单元管理器时所指定的 Encina 根和镜像目录。 在这种情况下,不显示“EncinaLocal 和 EncinaMirror”表。
对于定义要在非 AIX UNIX 和 Windows NT 系统上运行的节点。 在日志卷磁盘名字段中, 输入打算在其上存储节点管理器的事务日志数据的磁盘名称 (例如,非 AIX UNIX 上的 /dev/rsd1f)。 在 Windows NT 上,磁盘是在表 //./driveName 中指定的一个逻辑磁盘驱动器(如 //./D:) , 或者是操作系统文件的完整路径名,包括盘符 (如 D:\filevol1)。
对于定义要在 AIX 系统上运行的节点。 在日志卷磁盘名字段中, 输入您打算在其上存储节点管理器的事务日志数据的 AIX 逻辑卷的名称。
请参阅 Encina 管理指南第 1 卷:基本管理获得有关创建和分配卷的详细信息。
对于定义要在非 AIX UNIX 和 Windows NT 系统上运行的节点。 在日志卷镜像磁盘名字段中, 输入您打算在其上存储事务日志数据的镜像或备份的磁盘的名称。
对于定义要在 AIX 系统上运行的节点。 Enconsole 不用于指定日志卷镜像磁盘名称。
该表显示了 Encina 目录根、 镜像目录根(用于存储服务器的输出、配置、重新启动和日志文件) 和在寻找 Encina 二进制文件时所使用的路径名的值。 Enconsole 使用“节点管理器”表中的系统类型字段值来确定这些字段的缺省值。缺省目录如下:
要启动节点管理器, 必须在节点管理器将要在其上运行的机器上使用 Enconsole。当首次启动节点管理器时, Enconsole 在您定义单元或节点时指定的 Encina 目录根和镜像目录根下创建文件。
图 22 显示在启动名为 branch1 的监视器单元中名为 node1 的节点管理器时, Enconsole 创建的缺省的目录结构和文件。显示的缺省目录结构用于大多数的 UNIX 平台和 Windows NT 系统。
执行下列步骤从 Enconsole 中启动一个节点管理器:
如果不需要更高程度的安全性,请选择否按钮。节点管理器不验证单元管理器委托人。
一旦选择了适当的按钮,Enconsole 关闭选项框, 显示“命令状态”显示屏,创建存储和组织服务器文件的目录, 并执行节点管理器启动命令 (enm)。系统启动该节点管理器可能会花费一些时间。
本节描述了如何定义和启动一个 SFS 服务器。您可以在任何节点上使用 Enconsole 来定义和启动一个 SFS 服务器。
SFS 服务器是一个 Encina 可恢复服务器, 它管理对存储在面向记录的文件中的数据的访问。 它提供了事务的完整性和灵活的存储器管理。 SFS 服务器适合于管理大量数据(存货、用户订单和雇员文件)的应用程序。
定义和启动一个 SFS 服务器的登录需要:
本节描述了如何定义一个 SFS 服务器。要定义一个服务器, 要指定所有启动服务器所需的信息并以该服务器的名义存储这些信息。
执行下列步骤从 Enconsole 内定义一个 SFS 服务器:
对于在 Windows NT 和非 AIX UNIX 系统上运行的服务器。 在日志卷磁盘名字段中, 输入您打算在其上存储服务器事务日志数据的磁盘的名称。
对于在 AIX 系统上运行的服务器。在日志卷磁盘名字段中, 输入您打算在其上存储服务器事务日志数据的 AIX 逻辑卷的名称。
对于在 Windows NT 和非 AIX UNIX 系统上运行的服务器。 在日志卷镜像磁盘名字段中, 输入您打算在其上存储服务器事务日志数据的镜像或备份的磁盘名称。
对于在 AIX 系统上运行的服务器。 Enconsole 不用来指定日志卷镜像磁盘名。
对于在 Windows NT 和非 AIX UNIX 系统上运行的服务器。 在数据卷磁盘名字段中, 输入您打算在其上存储服务器数据的磁盘名称。
在 AIX 系统上运行的服务器。在数据卷磁盘名字段中, 输入您打算在其上存储服务器数据的 AIX 逻辑卷的名称。
对于在 Windows NT 和非 AIX UNIX 系统上运行的服务器。 在数据卷镜像磁盘名字段中, 输入您打算在其上镜像服务器数据的磁盘的名称。
对于在 AIX 系统上运行的服务器。 Enconsole 不是用来指定数据卷镜像磁盘名的。
对于在 Windows NT 系统上运行的服务器。 Enconsole 忽略“进程选项”表中的用户名和组名字段。
对于在 UNIX 系统上运行的服务器。 用户名和组名字段值必须与在目标 UNIX 机器(服务器将要运行的机器)上使用的用户和组 ID 匹配。
选择确定按钮接受“进程选项”表中其余字段的缺省值然后返回 SFS 表。
本节描述了如何启动一个已定义或已停止的 SFS 服务器。 要启动一个服务器,必须以 Encina 管理委托人登录到 DCE。
当启动一个处于 Defined 状态的服务器(一个从未启动过的服务器), 节点管理器在本地文件系统和镜像文件系统中创建一些文件来存储和组织服务器的输出、 重新启动和密钥表文件。 (缺省情况下,在监视器单元中运行的服务器将输出文件存储在工作目录 directoryRoot\monitorCell\server\serverName 中,其中的 directoryRoot 是顶层 Encina 目录, monitorCell 是监视器单元的名称,serverName 是服务器名称。) Enconsole 还执行下列 SFS 服务器的 DCE 管理任务:
执行下列步骤从 Enconsole 内启动一个 SFS 服务器:
注意: | 如果启动服务器命令不成功, 请复查“命令状态”屏幕中显示的错误。您可以复查存储在服务器将要运行的机器上服务器工作目录中的服务器输出文件 (缺省值为 server.out) 中的附加信息。 |
本节描述了如何退出 Enconsole。请注意,在您退出 Enconsole 之前不需要停止单元管理器或节点管理器。 在退出 Enconsole 后它们将继续运行。一旦运行了监视器单元, 可以在任何时侯重新启动 Enconsole 以管理该单元。
要退出 Enconsole, 从文件菜单中选择退出命令, 然后在确认框中选择是按钮。退出 Enconsole。
如果您还没有注册 TXSeries 版本,现在可以使用软件注册实用程序来注册。该实用程序存储在 Encina 程序文件夹中。
执行下列步骤来注册 TXSeries:
一旦您注册了软件,就可以使用软件注册实用程序来更新用户概要。执行下列步骤来从软件注册实用程序中更新用户概要:
本章描述了删除 TXSeries 软件和数据的过程。 需要卸装 TXSeries 时请使用这个过程。
注意: | 卸装过程不从分布式计算环境(DCE)登记数据库或单元目录服务(CDS)名称空间中删除项。 必须在删除了 TXSeries 软件后,使用合适的 DCE 实用程序来从 DCE 中删除 TXSeries 项。 |
本节描述了从机器中删除 CICS Windows NT 版软件的过程。当卸装 CICS 时,CICS 使用的 Encina 软件也从您的机器中删除了。
要从机器中删除 CICS 软件,请执行下列步骤:
一旦您从机器中删除了 CICS,就可以卸装许可证使用运行时 (请参阅"卸装许可证使用运行时")和 DCE(请参阅"卸装 DCE")了。
CICS 的卸装进程不删除 CICS 数据目录 (缺省情况下是 C:\var)中的区域数据。 它还将 cicslcli.ini 文件写入 CICS 数据目录(例如, C:\var\cics_clients)的 \cics_clients 子目录中。 因此,如果您要重新安装 CICS,就必须执行下列任务:
另外,如果您重新安装 CICS 并选择了一个 CICS 数据目录位置, 它与以前的安装所在的位置不同,您就必须在用新目录中的现存短名创建新的 SFS 服务器前, 删除结构化文件服务器(SFS)服务器的所有现存用户 ID。
如果您已通过使用 cicscp create telnet_server 命令在机器上创建了 CICS Telnet 服务器, 必须在卸装 CICS 软件前将它撤除,并从 Windows NT 注册表中将它的服务定义删除。
cicscp create telnet_server 命令为 Telnet 服务器创建自动启动服务。 当卸装 CICS 时,卸装实用程序不删除控制面板上服务列表中的自动启动服务项。结果是,当在删除 CICS 软件后重新启动机器时, 系统尝试重新启动 CICS Telnet 服务器。 服务器不能启动,并且 Windows NT 显示一条错误信息。 撤消服务器,并将它的服务定义删除,以避免这种情况的再次发生。
要从机器中删除 Telnet 服务器,请执行下列步骤:
C:\> cicscp destroy telnet_server serverName
其中 serverName 是要撤除的 Telnet 服务器的名称。 该命令删除 cicsteld Windows NT 服务,但它不删除 DCE 委托人。 如需有关该命令的更多信息,请参阅 CICS 管理参考大全。
本节包含了从机器中删除 Encina 软件和数据的过程。如果您对停止服务器、 节点管理器和单元管理器的进程不熟悉的话,请参阅 Encina 管理指南第 1 卷:基本管理获得更多信息。
请执行下列步骤来删除 Encina 4.2:
注意: | 不能使用 Enconsole 来删除单元管理器。 您必须使用合适的 DCE 实用程序来删除 DCE 注册表和 CDS 名称空间中的信息。 |
您也可以使用 Windows 添加/删除程序实用程序来删除 Encina 4.2。请参阅 Windows 文档获得更多信息。
一旦您从机器中删除了 Encina,就可以删除许可证使用运行时 (请参阅"卸装许可证使用运行时") 和 DCE(请参阅"卸装 DCE")了。
本节描述了删除许可证使用运行时软件的进程。如果在机器上有使用许可证使用运行时服务的应用程序的话, 就不能删除许可证使用运行时。
请执行下列步骤来删除许可证使用运行时:
本节描述了卸装 IBM DCE 客户机的过程。 在从机器中删除 DCE 客户机前,必须确保已删除了使用 DCE 的所有软件(例如 Encina 和 CICS)。
请执行下列步骤来从机器中删除 DCE:
如果您要从机器中删除其它的 DCE 部件(例如安全性服务器), 或者如果您要删除 Gradient DCE,请参考 DCE 文档。
本附录描述了 TXSeries 的产品和评估许可证。还描述了在安装或升级 CICS 或 Encina 后登记 TXSeries 产品许可证的过程。
有两种类型的 TXSeries 许可证:
在您安装或升级了 TXSeries 后,可执行下列过程来登记产品许可证:
图 27. 带有已登记许可证的“Nodelock 管理工具”
本附录提供了获取 TXSeries 的附加信息的指令。它列出了所有可用于 TXSeries 的文档, 描述了包括在 TXSeries 媒体/手册组件中的 TXSeries 文档 CD-ROM 的内容,并提供在您机器上查看和安装该文档的指令。
表 10 列出了所有可用于 TXSeries 的书籍。这些文档是按产品(CICS 和 Encina)和平台组织的。
订单号码 | 书籍名称 | 书籍说明 |
---|---|---|
CICS/Encina IBM TXSeries 公共文档(用于所有支持的平台) | ||
SA40-1753 | 概念和设施 | 提供一个关于 IBM TXSeries 的概念、服务和部件的技术性概述。 |
GI10-5100 | 发行说明 | 包含 Encina 和 CICS 所支持的所有平台的公共信息。它描述了新的功能、 对已记载的过程的更新、修正过的缺陷以及重要的已知的缺陷。 |
IBM TXSeries AIX 版文档 | ||
GC40-1668 | 快速入门 | 描述如何安装、升级和配置 CICS 或 Encina 系统。 |
GI10-5108 | TXSeries AIX 版发行说明 | 包含特定于平台的 CICS 和 Encina 信息,包括兼容的操作系统和第三方产品。 |
IBM TXSeries Solaris 版文档 | ||
GC09-3929 | 快速入门 | 描述如何安装、升级和配置 CICS 或 Encina 系统。 |
GI10-5116 | TXSeries Solaris 版发行说明 | 包含特定于平台的 CICS 和 Encina 信息,包括兼容的操作系统和第三方产品。 |
IBM TXSeries Windows NT 版文档(Windows NT 和 Windows 95) | ||
SA40-1754 | 快速入门 | 描述如何安装、升级和配置 CICS 或 Encina 系统。 |
GI10-5124 | TXSeries Windows NT 和 Windows 95 版发行说明 | 包含特定于平台的 CICS 和 Encina 信息,包括兼容的操作系统和第三方产品。 |
IBM TXSeries HP-UX 版文档 | ||
GC09-3941 | 快速入门 | 描述如何安装、升级和配置 CICS 或 Encina 系统。 |
GI10-5039 | TXSeries HP-UX 版发行说明 | 包含特定于平台的 CICS 和 Encina 信息,包括兼容的操作系统和第三方产品。 |
CICS 文档 (除非特别说明,否则用于所有支持的平台) | ||
SC09-3948 | CICS 管理指南 | 为系统管理员提供有关设置和管理 CICS AIX 版系统的各方面信息。 |
SC33-1828 | CICS 管理指南 | 为系统管理员提供有关设置和管理 CICS Solaris 版系统的各方面信息。 |
SC09-3954 | CICS 管理指南 | 为系统管理员提供有关设置和管理 CICS Windoes NT 版系统的各方面信息。 |
SC33-1933 | CICS 管理指南 | 为系统管理员提供有关设置和管理 CICS HP-UX 版系统的各方面信息。 |
SC33-1563 | CICS 管理参考大全 | 为系统管理员提供管理 CICS 系统所需的命令和定义的参考信息。与CICS 管理指南结合使用。 |
SC09-3899 | CICS 应用程序设计指南 | 为应用程序员提供有关使用 CICS 应用程序设计接口(API)开发 COBOL、 C、C++ 或 PL/I 应用程序的指南信息以及从或向 CICS 移植应用程序的指南信息。 |
SC33-1569 | CICS 应用程序设计参考大全 | 为应用程序员提供有关使用 CICS API 开发 COBOL、C、C++ 或 PL/I 应用程序的参考信息。 |
SC09-3900 | CICS 内部通信指南 | 描述 CICS 区域与其它 CICS 系统以及与其它支持 LU6.2 协议的系统是如何进行通信的。 |
SC33-1566 | CICS 信息与代码 | 列示了 CICS 发出的信息与代码。 |
SC33-1565 | CICS 问题确定指南 | 提供了指南信息,以帮助解决 CICS 应用程序和系统的问题,并在使用支持组织时提供帮助。 |
CICS 系列文档(用于所有支持的平台) | ||
SC33-1007 | CICS 系列:API 结构 | 为 CICS 应用程序设计接口(API) 和系统程序设计 INQUIRE 和 SET 命令提供由 CICS 系列的每个成员提供的支持级别的交叉引用。 |
SC33-1435 | CICS 系列:客户机/服务器程序设计 | 提供有关使用 CICS 外部调用接口(ECI) 和 CICS 外部程序设计接口(EPI)的信息以开发客户应用程序, 使 CICS 系统可以作为服务器使用。 |
GC09-3926 | 工作站上的前端程序设计接口 | 描述 CICS/ESA、CICS OS/2 版和 CICS Windows NT 版可用的前端程序设计接口。 |
SC33-0824 | CICS 系列:产品间通信 | 介绍 CICS 产品系列的 CICS 内部通信功能。 |
SC33-1898 | IBM 通信服务器 AIX 版与 CICS 一起使用 | 描述 IBM 通信服务器 AIX 版如何为 CICS AIX 版区域提供本地系统网络体系结构(SNA)支持, 以及如何在 Encina 同级间通信(PPC)网关服务器中提供网关 SNA 支持的。 |
SC33-1900 | IBM 通信服务器 Windows NT 版与 CICS 一起使用 | 描述 IBM 通信服务器 Windows NT 版如何提供 CICS 区域的本地 SNA 支持。 |
SC33-1715 | Microsoft SNA 服务器版本 3 与 CICS 一起使用 | 描述 Microsoft SNA 服务器版本 3 如何提供 CICS 区域的本地 SNA 支持。 |
SC09-3896 | HP-UX SNAplus2 与 CICS 一起使用 | 描述 HP-UX SNAPlus2 如何提供 CICS 区域的本地 SNA 支持。 |
SC09-3897 | SunLink 与 CICS 一起使用 | 描述 SunLink 如何提供 CICS 区域的本地 SNA 支持。 |
Encina 管理指南文档(用于所有支持的平台) | ||
SC33-1795 | Encina 管理指南第 1 卷:基本管理 | 描述例行程序服务器的管理过程, 例如配置和管理物理存储空间以及执行备份。 也包含管理事务处理和从媒体故障中恢复的过程。此外, 还特别包括了对 Encina 资源的控制存取、 修改服务器行为和使用 Encina 跟踪设施。 |
SC33-1948 | Encina 管理指南第 2 卷:服务器管理 | 介绍可恢复队列服务(RQS)、 结构化文件服务器(SFS)和同级间通信(PPC)网关/SNA 管理。包含特定于服务器的管理任务的详细信息, 例如为 RQS 服务器管理队列、为 SFS 服务器管理 SFS 文件,以及配置 PPC 服务对话。 |
SC33-1940 | Encina 管理指南第 3 卷:高级管理 | 描述可用于管理 Encina 监视器单元的 Encina 监视器对象类型系统和 Encina 控制程序(enccp)接口。 还包含从命令行启动独立的 Encina 服务器、 设置与配置队列请求设施(QRF)和使用字符串联接启动 Encina 服务器的过程。 |
Encina 程序设计指南文档 (用于所有支持的平台) | ||
SC33-1913 | Encina COBOL 程序设计指南 | 描述如何开发使用 COBOL 的 Encina 监视器应用程序。 |
SC33-1914 | Encina 监视器程序设计指南 | 描述如何开发使用 C 的 Encina 监视器应用程序。 |
SC09-3894 | Encina 面向对象编程指南 | 描述如何使用 Encina C++ 程序设计接口开发面向对象的应用程序。介绍 Encina C++ 程序设计模型, 并描述如何编写分布式计算环境(DCE)和公共对象请求代理体系结构(CORBA)环境下的客户机与服务器应用程序。 |
SC33-1915 | Encina PPC 服务程序设计指南 | 描述 Encina PPC 执行体的程序设计环境和相关实用程序。 |
SC33-1916 | Encina RQS 程序设计指南 | 描述 RQS 程序设计环境以及如何开发 Encina RQS 应用程序。 |
SC33-1917 | Encina SFS 程序设计指南 | 描述 SFS 程序设计环境以及如何开发 Encina SFS 应用程序。 |
SC33-1918 | Encina 工具箱程序设计指南 | 描述 Encina 工具箱的组织, 各种工具箱模块间的交互, 以及如何使用特定工具箱接口来开发分布式事务应用程序。 |
SC33-1919 | Encina 事物程序设计指南 | 描述如何使用 Encina Transactional-C 程序设计接口来开发分布式事务处理应用程序。 还描述 Encina TX 接口和事务处理接口定义语言(TIDL)。 |
SC33-1760 | 编写 Encina 应用程序 | 提供了使用 Encina 的简单客户机/服务器应用程序开发的类似于教程的介绍。 同时提供了建立 Encina 应用程序必需的头文件和库的信息。 |
Encina 管理参考文档(用于所有支持的平台) | ||
SK3T-2623 | 管理介绍页面 | 介绍 Encina 管理命令。 |
SK3T-2624 | emadmin 命令页面 | 提供了有关 emadmin 命令组的参考信息, 该命令可用于管理 Encina 监视器对象。 |
SK3T-2625 | enccp 介绍页面 | 提供了有关 Encina 控制程序(enccp)、命令行和 Encina 基于脚本的管理界面的参考信息。 |
SK3T-2626 | enccp 示例页面 | 提供了 enccp 命令和脚本的示例。 |
SK3T-2627 | enccp 对象页面 | 提供了有关 Encina 监视器对象和它们属性的参考信息。 |
SK3T-2628 | enccp 操作页面 | 提供了有关 enccp 操作的参考信息。 |
SK3T-2629 | 各种管理命令页面 | 提供了有关服务器启动命令、Enconsole 重新启动脚本和与 Encina 跟踪设施相关的实用程序的参考信息。 |
SK3T-2630 | otsadmin 命令页面 | 提供了用于管理对象事务处理服务(OTS)服务器的 otsadmin 命令组的参考信息。 |
SK3T-2631 | ppcadmin 命令页面 | 提供了用于管理 PPC 网关服务器的 ppcadmin 命令组的参考信息。 |
SK3T-2632 | rqsadmin 命令页面 | 提供了用于管理 RQS 服务器的 rqsadmin 命令组的参考信息。 |
SK3T-2633 | sfsadmin 命令页面 | 提供了用于管理 SFS 服务器的 sfsadmin 命令组的参考信息。 |
SK3T-2634 | tkadmin 命令页面 | 提供了用于管理 Encina 工具箱服务器的 tkadmin 命令组的参考信息。 |
Encina 程序设计参考文档(用于所有支持的平台) | ||
SK3T-2635 | 介绍 C 程序设计页面 | 提供了 Encina C API 的功能、数据类型和其它元素的背景信息。 |
SK3T-2636 | 异常中止设施程序设计页面 | 提供了 Encina 异常中止设施的参考信息。 |
SK3T-2637 | 分布式事务服务程序设计页面 | 提供了有关 Encina 分布式事务服务(TRAN)的数据类型和功能的参考信息。 |
SK3T-2638 | EMA 程序设计页面 | 提供了有关 Encina 监视器管理(EMA)接口的数据类型和功能的参考信息。同时提供了 EMA 类型系统中对象的参考信息。 |
SK3T-2639 | 锁定服务程序设计页面 | 提供了有关 Encina 锁定服务(LOCK)的数据类型和功能的参考信息。 |
SK3T-2640 | 日志服务程序设计页面 | 提供了有关 Encina 日志服务(LOG)的数据类型和功能的参考信息。 |
SK3T-2641 | 杂项 C 程序设计页面 | 提供了有关 TIDL 编译器以及与 Encina 状态码相关的数据类型和功能的参考信息。 |
SK3T-2642 | 监视器程序设计页面 | 提供了有关 Encina 监视器 API 的数据类型和功能的参考信息。 |
SK3T-2643 | PPC 执行体程序设计页面 | 提供了有关 PPC 执行体 API 的参考信息。 |
SK3T-3196 | 恢复服务程序设计页面 | 提供了有关 Encina 恢复服务(REC)的数据类型和功能的参考信息。 |
SK3T-3197 | 重新启动服务程序设计页面 | 提供了有关 Encina 重新启动服务的数据类型和功能的参考信息。 |
SK3T-3198 | RQS 程序设计页面 | 提供了有关 RQS API 的数据类型和功能的参考信息。 |
SK3T-3199 | SFS 程序设计页面 | 提供了有关 SFS API 的数据类型和功能的参考信息。 |
SK3T-3200 | T-ISAM 程序设计页面 | 提供了有关 Encina 事务处理索引顺序存取法(T-ISAM)的数据类型和功能的参考信息。 |
SK3T-3201 | ThreadTid 程序设计页面 | 提供了有关 Encina Thread-to-Tid 映射服务(threadTid)的数据类型和功能的参考信息。 |
SK3T-3202 | TM-XA 程序设计页面 | 提供了有关 Encina 事务处理管理器-XA(TM-XA)服务的数据类型和功能的参考信息。 |
SK3T-3203 | 跟踪设施程序设计页面 | 提供了有关 Encina 跟踪设施的参考信息。 |
SK3T-3204 | Transactional-C 程序设计页面 | 提供了有关 Encina Transactional-C API 的数据类型和功能的参考信息。 |
SK3T-3205 | TranLog 程序设计页面 | 提供了有关 Encina 事务处理状态记录(tranLog)接口的数据类型和功能的参考信息。 |
SK3T-3206 | TRDCE 程序设计页面 | 提供了有关 Transarc/Encina DCE 实用程序(TRDCE) API 的参考信息。 |
SK3T-3207 | TRPC 程序设计页面 | 提供了有关 Encina 事务处理远程过程调用(RPC)服务(TRPC)的数据类型和功能的参考信息。 |
SK3T-3208 | TX 接口程序设计页面 | 提供了有关 Encina X/Open TX 接口的参考信息。 |
SK3T-3209 | 卷服务程序设计页面 | 提供了有关 Encina 卷服务(VOL)的数据类型和功能的参考信息。 |
SK3T-3210 | 介绍面向对象的程序设计页面 | 提供了有关 Encina 面向对象 API 的类别、功能、观念、数据类型以及命令的背景信息。 |
SK3T-3211 | Encina++ 程序设计页面 | 提供了有关 Encina++ API 的参考信息。 |
SK3T-3212 | 各种面向对象的程序设计页面 | 提供了有关数据定义语言(DDL)编译器和 DDL 类的参考信息。 |
SK3T-3213 | OMG OCCS 程序设计页面 | 提供了有关 Encina 对象管理组(OMG)对象一致控制服务(OCCS) API 的参考信息。 |
SK3T-3214 | OMG OTS 管理程序设计页面 | 提供了有关 Encina OMG OTS 管理 API 的参考信息。 |
SK3T-3215 | OMG OTS C++ 程序设计页面 | 提供了有关 Encina OMG OTS C++ API 的参考信息。 |
SK3T-3216 | OMG OTS Java 程序设计页面 | 提供了有关 Encina OMG OTS Java API 的参考信息。 |
SK3T-3217 | OMG OTS 同步化级别程序设计页面 | 提供了有关 Encina OMG OTS 同步化 API 的参考信息。 |
SK3T-3218 | RQS++ 程序设计页面 | 提供了有关 Encina RQS++ API 的参考信息。 |
SK3T-3219 | SFS++ 程序设计页面 | 提供了有关 Encina SFS++ API 的参考信息。 |
SK3T-3220 | Transactional-C++ 程序设计页面 | 提供了有关 Encina Transactional-C++ API 的参考信息。 |
SK3T-3221 | COBOL 程序设计页面 | 提供了有关 Encina COBOL 调用的参考信息。 |
大多数 TXSeries 文档集可用于印刷格式。 除了产品所携带的印刷文档外, 所有的文档(除了 Encina 参考文档和特定于平台的 TXSeries 发行说明)都可作为印刷文档订购。 Encina 管理和程序设计接口的参考页面仅可用于超文本标记语言(HTML)和 PostScript 格式。 要订购印刷文档,可以与销售代理或本地的 IBM 分支机构联系。 在订购印刷手册时,请使用表 10 中提供的订单号码。
注意: | 不是所有的 TXSeries 文档都有受支持的语言的版本。 所有的 HTML、PostScript 和打印文档都有美式英语版本。 对于其它语言,每种格式仅有一部分文档可用。 |
TXSeries 的文档 CD-ROM 包含了 TXSeries 产品的完整文档库,如表 10 所示。 标号为 "TXSeries Windows NT 版,文档" 的 CD-ROM 包含下列格式的文档:
TXSeries 的 HTML 文档已经过验证, 可以用 Netscape Navigator 4.0 或更新的版本以及 Microsoft Internet Explorer 4.0 或更新的版本来查看。 您可使用任何支持 HTML 3.0 或更新版本的浏览器来查看文档。
您可直接从文档 CD-ROM 中查看 TXSeries 联机文档。 可以从 CD-ROM 根目录下名为 start.htm 的文件访问该文档。 将该文件装入浏览器并选择您要查看哪种语言的文档。 以该语言提供的所有文档都可用。从 CD-ROM 中,也可使用浏览器下载所有该种语言的可用 PostScript 文档。
文档 CD-ROM 用它要使用的操作系统名称标号。 您可从任何正运行 TXSeries 产品支持的操作系统版本的机器上查看该文档。
为使联机文档能为多个用户使用,可在本地安装该文档,使它可用于下列某一方式:
文档 CD-ROM 用它要使用的操作系统名称标号。 您可由与任何正运行支持使用 TXSeries 产品的操作系统文档的机器相连的 CD-ROM 驱动器安装该联机文档。
缺省情况下,TXSeries 文档将安装在 Windows NT 和 Windows 95 系统的下列目录中:
C:\Program Files\TXSeriesDoc\language\html
在路径名中,language 是一个 5 个字符的字符串,表明所安装文档的语言。您可为该文档指定一个不同的安装目录。
不管选择什么目录,
安装路径名的最后两个元素总是
language\html。
表 11 列出了 TXSeries 文档可用的语言和安装目录的路径名中相应的 language 值。
语言 | 安装目录 |
---|---|
美式英语 | en_US |
简体中文 | zh_CN |
法语 | fr_FR |
德语 | de_DE |
意大利语 | it_IT |
日语 | ja_JP |
韩语 | ko_KR |
巴西葡萄牙语 | pt_BR |
西班牙语 | es_ES |
您可在同一时间安装多种语言的文档。缺省情况下, 安装实用程序选择美式英语和 LANG 环境变量值(如果不是美式英语) 作为安装文档的语言。 您可以更改这些选项来指定不同的语言。
该文档集的美式英语版大约需要 50 MB 的磁盘空间用于安装。其它语言版本所需的空间比较少,因为不是所有的文档都经过翻译。
要在运行 Windows NT 或 Windows 95 的机器上安装该文档, 请使用位于文档 CD-ROM 的 \x86 目录下的 setup.exe 应用程序。要安装该文档, 可执行下列步骤:
注意: | 如果机器不支持自动播放选项,或者如果您已将它关闭, 那么必须手工启动位于 CD-ROM 的 \x86 目录中的 TXSeries 文档安装程序 (setup.exe)。 |
一旦安装成功,您可以打开 Web 浏览器中的文件 directory\language\html\index.htm来查看 TXSeries 文档,其中的 directory 是安装目录的路径名 (缺省情况下为 C:\Program Files\TXSeriesDoc), language 是表 11 中列出的 5 字符的字符串。 如果您安装了多种语言的 TXSeries 文档,那么在 directory (缺省情况下为 C:\Program Files\TXSeriesDoc)中可找到多个 language\html 子目录。
要从 Windows NT 或 Windows 95 系统中删除 TXSeries 文档, 不要手工删除安装目录及其内容。应该执行下列步骤: