201106k3组件跟踪工具使用简介资料

《201106k3组件跟踪工具使用简介资料》由会员分享，可在线阅读，更多相关《201106k3组件跟踪工具使用简介资料（13页珍藏版）》请在金锄头文库上搜索。

1、 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 1 页 共 13 页 K/3 组件跟踪工具使用简介组件跟踪工具使用简介 ? 本文档适用于 k/3 安装调试方面的应用。 ? 学习完本文档以后， 可以对 K/3 组件跟踪工具以及由组件问题引起的程序错误有初 步的了解。 ? 2011 年 06 月 25 日 V1.0 编写人： 孙晓阳 ? 2011 年 06 月 30 日 V2.0 编写人： 覃海枝 ? 本文件使用须知 著作权人保留本文件的内容的解释权， 并且仅将本文件内容提供给阁下个人使 用。 对于内容中所含的版权和其他所有权声明， 您应予以尊重并在其副本中予以保 留。您不得以任何方

2、式修改、复制、公开展示、公布或分发这些内容或者以其他方 式把它们用于任何公开或商业目的。 任何未经授权的使用都可能构成对版权、 商标 和其他法律权利的侵犯。 如果您不接受或违反上述约定， 您使用本文件的授权将自 动终止，同时您应立即销毁任何已下载或打印好的本文件内容。 著作权人对本文件内容可用性不附加任何形式的保证， 也不保证本文件内容的 绝对准确性和绝对完整性。 本文件中介绍的产品、 技术、 方案和配置等仅供您参考， 且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权 人不承诺更新它们。 如需得到最新的技术信息和服务， 您可向当地的金蝶业务联系 人和合作伙伴进行咨询。

3、著作权声明 著作权所有 2011 金蝶软件（中国）有限公司 。 所有权利均予保留。 本期概述 版本信息 版权信息 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 2 页 共 13 页 目 录 目 录 第一章 K/3 组件跟踪工具使用简介 . 3 1.1 K/3 组件简述3 1.1.1 中间层组件.3 1.1.2 客户端组件.4 1.2 组件跟踪工具-KDMAINDBG.5 1.2.1 KDMAINDBG.EXE 工具简介5 1.2.2 使用方法5 1.3 组件注册.7 1.3.1 中间层组件的手工注册方法7 1.3.2 客户端组件的手工注册方法12 金蝶知识库文档 金蝶软件（中国）

4、有限公司 客户服务中心 第 3 页 共 13 页 第一章 第一章 K/3 组件跟踪工具使用简介组件跟踪工具使用简介 在使用 K/3 的过程中， 经常会遇到组件报错导致程序全部或者部分功能无法正常运行的 情况。遇到此类问题，我们应该如何分析呢？K/3 从 10.2 版本开始，金蝶客户端的安装目录 中附带了一个功能强大的调试工具，该工具可以跟踪 COM+组件的运行情况。下面我们将 介绍一下组件跟踪工具的具体应用。 1.1 K/3 组件简述 1.1 K/3 组件简述 在介绍组件跟踪工具之前，首先需要对 K/3 软件的各种组件有所了解。 K/3 系统是一套基于三层结构技术的应用程序， 三层结构包括数据

5、库服务器、 中间层服务器、 客户端三个层次，在 K/3 系统中的 COM 组件包括了中间层组件和客户端组件。 1.1.1 中间层组件 1.1.1 中间层组件 K/3 中间层组件可以在【控制面板】【管理工具】【组件服务】中，进入【组件服 务】窗口，展开【组件服务】【计算机】【我的电脑】【COM+应用程序】 ，这里可 以看到很多的 COM+组件包，以 ebo 开头的组件包都是 K/3 的中间层组件，如图-1 所示。 图-1 com+应用程序中的中间层组件 K/3的中间层组件， 分COM+组件和非COM+组件两种， 接下来将介绍如何区分组件是COM+ 组件还是非 COM+组件。 （1）中间层 COM

6、+组件 在中间层服务器上的%systemdrive%windowssystem32KDCOM 目录下，可以找到一个 Mtsspsetup.lst 的文件，此文件记录了所有中间层 COM+组件的信息；用记事本打开这个文 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 4 页 共 13 页 件，可以查看到每一个组件包对应的 K/3 功能模块，也可以查看到每个组件包所包含的 dll 文件。如图-2 所示。 图-2 组件包中包含的组件 （2）中间层非 COM+组件 在 K/3 客户端机器的%systemdrive% Program FilesCommon FilesKingdeeK3 目录

7、下， 可 以找到一个K3ComponentInfo.INI的配置信息文件， 打开此文件， 在KDMIDDLEWARE_FILE 目录下从 FILE1 到 FILE75 都是中间层非 com+组件。如图-3 所示。 图-3 中间层非 com+组件 1.1.2 客户端组件 1.1.2 客户端组件 客户端组件也可以分为两种。 （1）VBR 文件 在 K/3 客户端组件中，所有以 VBR 为后缀名的文件都与中间层 COM+组件一一对应， 这类文件都是通过 DCOM 方式调用中间层的 COM+组件，即客户端 COM 组件。 （2）DLL 和 OCX 文件 K/3 客户端组件还有一些是只在客户端运行，不用

8、通过 DCOM 调用中间层组件的，这类 客 户 端 组 件 可 以 在 我 们 上 面 提 到 的K3ComponentInfo.INI配 置 文 件 中 ， 在 KDPRODUCT_FILE目录下面从 FILE1 到 FILE1031 都是 K/3 客户端非 COM 组件。如图-4 所示。 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 5 页 共 13 页 图-4 客户端非 com+组件 1.21.2 组件跟踪工具-KDMAINDBG 组件跟踪工具-KDMAINDBG 1.2.11.2.1 KDMAINDBG.EXE 工具简介 KDMAINDBG.EXE 工具简介 K/3 从

9、10.2 版本开始，其客户端的安装目录中附带了一个功能强大的调试工具 -KDMAINDBG.EXE，该工具可以跟踪 COM+组件的运行情况。但是在 10.2 版本之前并没有附带 这个工具，需要安装一个 K/3 性能监控工具来实现相同的功能。 1.2.21.2.2 使用方法 使用方法 组件跟踪工具在%systemdrive%Program FilesKingdeeK3ERP 目录下，其执行文件的名 称是 kdmaindbg.exe，启动后系统会提示您进入的是调试版，如图-5 所示。 图-5 跟踪工具 点击 【确定】 后， 程序会自动打开 K/3 主控台的登陆窗口， 同时也会开启一个组件跟踪窗口，

10、 实时记录当前 K/3 组件的调用情况， 如果有组件出现异常， 那么通过它非常方便定位问题并 解决问题，另外该工具还跟踪了对象的执行时间，可以用来检测性能数据。如图-6 所示。 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 6 页 共 13 页 图-6 调出 K/3 跟踪工具 当我们跟踪到有组件出现错误时，会出现一条红色显示的记录，表示该组件调用异常，如图 -7 所示。 图-7 查找红色记录 出现错误组件之后，我们该如何处理呢，下面我们将介绍具体的处理方法。 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 7 页 共 13 页 1.31.3 组件注册 组件注册 当我们

11、使用 K/3 组件跟踪工具跟踪处错误组件之后， 需要对已经被破坏的组件进行重新 注册，使该组件可以正常运行。 1.3.11.3.1 中间层组件的手工注册方法 中间层组件的手工注册方法 K/3 的中间层组件包括 COM+组件和非 COM+组件，这两类组件的注册方法是不同的。 一、中间层一、中间层 COM+组件的注册方法组件的注册方法 这里将以中间层组件 ebsarSystem.dll 为例来介绍注册方法。 （1）用记事本打开中间层机器 C:Program FilesKingdeeK3ERPKDSYSTEMKDCOM 目录 下的文件“MtsSpSetup.LST” ，搜索 ebsarSystem.

12、dll 文件名，可以看到该文件属于 ebopubilc 组件包。如图-8 所示。 图-8 查找报错组件所属组件包 （2）打开【控制面板】【管理工具】【组件服务】 ，找到 ebopubilc 组件包，单击该组 件包下的【组件】按钮，可以看到右边出现很多对应的组件，如图-9 所示。 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 8 页 共 13 页 图-9 ebopublic 组件包中的组件 （3）右键单击某个组件，选择【属性】 ，我们可以查看该组件包属于哪个 dll 文件，如图-10 所示。 图-10 com+应用程序中找到报错组件所属组件包 实际上会有多个组件对应同一个 dll

13、文件， 我们可以看到每个组件的名称都是由两部分组成， 中间由点隔开，组件名称的前半部分与其对应的 dll 文件的名称是一致的。在此例中，我们 可以看到有如下组件都对应了 ebsarSystem.dll 文件，如图-11 所示。 图-11 查找组件所对应的 dll 文件 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 9 页 共 13 页 （4）确定了需要重新注册的组件后，即可进行注册操作。在重新注册之前，为避免 k3 客户 端正在使用，造成 k3 应用的错误，需要先关闭此组件所属的组件包。如图-12 操作： 图-12 关闭组件 （5）关闭组件包后，删除所对应的组件。右键点击组件包下

14、面的【组件】文件夹，在弹出 的菜单中选择【新建】【组件】 ，然后单击下一步，如图-13 所示。 图-13 安装组件包 在弹出的界面选择“创建空的应用程序”按钮，如图-14 所示。 金蝶知识库文档 金蝶软件 （中国） 有限公司 客户服务中心 第 10 页 共 13 页 图-14 创建空的应用程序 然 后 选 择C:Program FilesKingdeeK3ERPKDSYSTEMKDCOM目 录 下 的 ebsarSystem.dll 文件，单击【打开】 ，如图-15 所示。 图-15 KDCOM 文件夹下找到 dll 文件 看到显示该组件文件的信息后，单击下一步，如图-16 所示。 金蝶知识库

15、文档 金蝶软件 （中国） 有限公司 客户服务中心 第 11 页 共 13 页 图-16 安装组件包 点击完成即完成整个注册过程，如图-17 所示。 图-17 完成组件安装 二、中间层非二、中间层非 COM+组件的注册方法组件的注册方法 中间层非 COM+组件主要包含了 DLL 和 OCX 两种格式的文件， DLL 和 OCX 格式的文 件用 regsvr32.exe 进行注册，详细注册方法有以下两种。 （1）通过命令行参数进行注册： 在开始运行中，输入： 金蝶知识库文档 金蝶软件 （中国） 有限公司 客户服务中心 第 12 页 共 13 页 C:WINDOWSsystem32regsvr32.exe 文件名，点击【确定】完成注册。如图-18 所示。 图-18 命令注册非 com+组件 （2）通过打开方式注册。 右键单击需要注册的 DLL 或 OCX 文件，选择【打开方式】 ，在【打开方式】中选择 C:WINDOWSsystem32regsvr32.exe，单击【打开】按钮进行注册。如图-19 所示。 图-19 手动打开非 com+组件 1.3.21.3.2 客户端组件的手工注册方法 一、 客户端组件的手工注