201106K3组件跟踪工具使用简介

K/3组件跟踪工具使用简介

本期概述

z本文档适用于k/3安装调试方面的应用。

z学习完本文档以后，可以对K/3组件跟踪工具以及由组件问题引起的程序错误有初步的了解。

版本信息

z2011年06月25日V1.0 编写人：孙晓阳

z2011年06月30日V2.0 编写人：覃海枝

版权信息

z本文件使用须知

著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。

著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。

著作权声明著作权所有 2011金蝶软件（中国）有限公司。

所有权利均予保留。

目 录

第一章 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)

第一章 K/3组件跟踪工具使用简介

在使用K/3的过程中，经常会遇到组件报错导致程序全部或者部分功能无法正常运行的情况。遇到此类问题，我们应该如何分析呢？K/3从10.2版本开始，金蝶客户端的安装目录中附带了一个功能强大的调试工具，该工具可以跟踪COM+组件的运行情况。下面我们将介绍一下组件跟踪工具的具体应用。

1.1 K/3组件简述

在介绍组件跟踪工具之前，首先需要对K/3软件的各种组件有所了解。

K/3系统是一套基于三层结构技术的应用程序，三层结构包括数据库服务器、中间层服务器、客户端三个层次，在K/3系统中的COM组件包括了中间层组件和客户端组件。

1.1.1 中间层组件

K/3中间层组件可以在【控制面板】→【管理工具】→【组件服务】中，进入【组件服务】窗口，展开【组件服务】→【计算机】→【我的电脑】→【COM+应用程序】，这里可以看到很多的COM+组件包，以ebo开头的组件包都是K/3的中间层组件，如图-1所示。

图-1 com+应用程序中的中间层组件

K/3的中间层组件，分COM+组件和非COM+组件两种，接下来将介绍如何区分组件是COM+组件还是非COM+组件。

（1）中间层COM+组件

在中间层服务器上的%systemdrive%\windows\system32\KDCOM目录下，可以找到一个Mtsspsetup.lst的文件，此文件记录了所有中间层COM+组件的信息；用记事本打开这个文

件，可以查看到每一个组件包对应的K/3功能模块，也可以查看到每个组件包所包含的dll 文件。如图-2所示。

图-2 组件包中包含的组件

（2）中间层非COM+组件

在K/3客户端机器的%systemdrive%\ Program Files\Common Files\Kingdee\K3目录下，可以找到一个K3ComponentInfo.INI的配置信息文件，打开此文件，在[KDMIDDLEWARE_FILE]目录下从FILE1到FILE75都是中间层非com+组件。如图-3所示。

图-3 中间层非com+组件

1.1.2 客户端组件

客户端组件也可以分为两种。

（1）VBR文件

在K/3客户端组件中，所有以VBR为后缀名的文件都与中间层COM+组件一一对应，这类文件都是通过DCOM方式调用中间层的COM+组件，即客户端COM组件。

（2）DLL和OCX文件

K/3客户端组件还有一些是只在客户端运行，不用通过DCOM调用中间层组件的，这类客户端组件可以在我们上面提到的K3ComponentInfo.INI配置文件中，在[KDPRODUCT_FILE]目录下面从FILE1到FILE1031都是K/3客户端非COM组件。如图-4所示。

图-4 客户端非com+组件

1.2组件跟踪工具-KDMAINDBG

1.2.1KDMAINDBG.EXE工具简介

K/3从10.2版本开始，其客户端的安装目录中附带了一个功能强大的调试工具-KDMAINDBG.EXE，该工具可以跟踪COM+组件的运行情况。但是在10.2版本之前并没有附带这个工具，需要安装一个K/3性能监控工具来实现相同的功能。

1.2.2使用方法

组件跟踪工具在%systemdrive%\Program Files\Kingdee\K3ERP目录下，其执行文件的名称是kdmaindbg.exe，启动后系统会提示您进入的是调试版，如图-5所示。

图-5 跟踪工具

点击【确定】后，程序会自动打开K/3主控台的登陆窗口，同时也会开启一个组件跟踪窗口，实时记录当前K/3组件的调用情况，如果有组件出现异常，那么通过它非常方便定位问题并解决问题，另外该工具还跟踪了对象的执行时间，可以用来检测性能数据。如图-6所示。