通过使用 runwithtrace 命令的变体,可以从安装到您自己的 Eclipse 环境或基于 Eclipse的产品中的 IBM® MQ Explorer 实例收集跟踪。
关于本任务
可以将 IBM MQ Explorer 安装到您自己的 Eclipse 环境或基于 Eclipse的产品中,以帮助开发 Java 应用程序或开发您自己的扩展。
要收集跟踪,请使用 runwithtrace 命令来启动 IBM MQ Explorer。 不能使用随产品提供的 runwithtrace 命令。 而是使用命令的变体,如以下过程中所述。
注意:通常只有在 "IBM支持部门要求时才会启用跟踪功能。 跟踪会减慢 IBM MQ Explorer 的速度,并且跟踪文件会快速变大。
过程
- IBM MQ Explorer 跟踪机制依赖于正在安装的 AspectJ 和 Equinox We起来的插件。 要确认是否已安装这些插件:
- 单击 帮助
- 单击 关于 ...
- 单击 安装详细信息
- 单击 插件 选项卡。
org.eclipse.equinox.weaving.caching.j9 插件不再存在,但是如果使用 IBM MQ 9.0.4 之前的 IBM MQ 9.0 Long Term Support 或 IBM MQ 9.0 Continuous Delivery 发行版,那么需要此插件。
验证是否安装了以下插件:
org.aspectj.runtime
org.aspectj.weaver
org.eclipse.equinox.weaving.aspectj
org.eclipse.equinox.weaving.caching
org.eclipse.equinox.weaving.caching.j9
org.eclipse.equinox.weaving.hook
- 如果尚未安装 AspectJ 和 Equinox Weaving 插件,请加以安装。 这些插件必须与您使用的 Eclipse 版本匹配,并且可从“Eclipse AspectJ 开发工具”下载站点进行下载。 要确定 Eclipse 版本使用哪个下载网站,请参阅 https://projects.eclipse.org/projects/tools.ajdt。
要安装 AspectJ 和 Equinox Weaving 插件,请完成以下分步:
- 单击 帮助 ,然后单击 安装新软件 ...
- 单击 添加 ... 然后输入适合 Eclipse 版本的下载站点的位置。
例如,对于 Eclipse 4.4,请输入
https://download.eclipse.org/tools/ajdt/44/dev/update。
- 单击 确定
这会显示可用软件的列表。
- 展开 其他 AJDT 工具 (可选) 类别,然后选择 AspectJ Compiler and Equinox We起来 SDK。
- 单击 下一步 并遵循向导指示信息。
- 跟踪 IBM MQ Explorer。
使用 runwithtrace 命令启动 IBM MQ Explorer 时,将合并用于启用 IBM MQ Explorer跟踪的额外参数。 请注意,runwithtrace 命令本身不带任何参数。
当命令运行时,跟踪文件的输出位置将打印到命令行,因为实际位置取决于
IBM MQ Explorer 跟踪文件具有格式为 AMQYYYYMMDDHHmmssmmm.TRC.n 的名称,指示跟踪会话的开始时间。 在跟踪文件到达其最大大小时,跟踪工具会通过使文件后缀 .n 递增 1 来重命名会话的所有跟踪文件。 然后,跟踪工具会创建后缀为 .0 且包含最新跟踪的新文件
- 卸载 AspectJ 和 Equinox Weaving 插件。 完成 IBM MQ Explorer 跟踪后,可以从 Eclipse 环境中除去 AspectJ 和 Equinox We起来的插件。 要卸载 AspectJ 和 Equinox Weaving 插件:
- 单击 帮助 ,然后单击 关于 ...。
- 单击 安装详细信息 ,然后单击 已安装软件 选项卡。
- 选择项 AspectJ Complier 和 Equinox We起来 SDK。
- 单击 卸载 ... 并遵循向导指示信息。