通过使用 runwithtrace 命令的变体,可以从安装到您自己的 Eclipse 环境或基于 Eclipse的产品中的 IBM® MQ Explorer 实例收集跟踪。
开始之前
此任务假定您已将 IBM MQ Explorer 安装到自己的 Eclipse 环境或基于 Eclipse的产品中,因此无法使用标准 runwithtrace 命令,如 收集 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。
- 单击 卸载 ... 并遵循向导指示信息。