您必须先将流调试器连接到部署了流的流引擎(执行组)并启动调试会话,然后才能调试消息流。如果您愿意,您可以将流调试器连接到运行在相同的或不同的主机上的多个流引擎,然后同步地调试它们的流。
不能调试已部署到 64 位执行组的流;流调试器只支持 32 位执行组。
要连接到流引擎:
- 切换到“代理管理”透视图。当在域窗格中显示您的消息流的名称时,请记下这个名称。
- 在消息流编辑器中打开您要调试的消息流,方法是在代理管理导航器窗格中双击其名称。
- 在引出消息流输入节点的连接中添加断点。 添加此断点,为的是确保在可以开始调试之前,消息流不会完成其运行。
断点显示为
。(有关添加断点的信息,请参阅在调试器中处理断点)。
- 切换到“调试”透视图。
- 单击工具栏上的调试图标
,并选择调试以调用调试(创建、管理和运行配置)向导。 提示: 将要创建调试启动配置。如果已创建调试启动配置,可以通过直接单击
调试图标

本身来重新启动。
如果以下任一条件为真,则该操作会生成错误:
- 您尚未创建调试启动配置。
- 您先前连接的代理和执行组不再运行。
- 代理和执行组已重新启动,因此具有新的进程标识(请参阅下文)。
- 在配置列表中,选择消息代理调试,然后单击新建按钮。窗口将出现一组选项卡式面板,开头为连接。
提示: “调试”按钮一直是灰化的,直到您填充了连接面板上的字段。之后您可以选择填充其他面板上的字段,或直接单击调试。
向导中的面板如下所示:- 连接:使用此面板可建立通过 Rational Agent Controller 的流引擎连接。必须先填充这个面板上的所有字段,才可以单击调试按钮来启动调试会话。
- 代理控制器端口号
- 输入您要使用的端口号。
- 流项目
- 选择流项目。
- HostName
- 选择正在运行流引擎的主机。如果没有列出该主机,请在 HostName 字段中输入主机的主机名或 IP 地址(如果 HostName 字段不可用,请先单击复位按钮,然后进行更改)。
- 流引擎
- 选择您要调试的代理和流引擎。在打开的列表中,单击浏览按钮时,每个流引擎都作为其进程编号列出,后跟用冒号分隔的代理名和执行组名称,例如:
ProcessID Engine name
--------- ---------------
5984 WMBV6BR:default
如果流引擎没有出现在列表框中,请单击刷新以使用主机上所有当前已部署并且可用的流引擎的名称来更新列表框。(如果流引擎仍然没有出现在列表框中,则尝试重新启动主机上的 RAC。)将显示一个选项,让您选择连接到目标主机上运行的任何执行组。这包括没有部署任何流的执行组。
提示: 如
进程页面上的
任务管理器中列出的,此进程编号是 Windows
PID。
如
部署发布/预订拓扑中描述的,当您部署时,在事件日志中报告 PID。
现在,单击调试进入下一步,或按如下所示继续完成其他面板。
- Java 调试设置:在您希望调试 Java 用户定义的节点或 JavaCompute 节点时使用此面板。Java 端口是为代理 JVM 指定的端口号。如果不指定端口,则禁用 Java 调试。
提示: - 设置代理 JVM 调试端口
- 为了调试 JavaCompute 节点或包含 Java 代码的用户定义节点,代理 JVM 必须配置有调试端口号。要设置该值,则发出下列命令(在一行中):
mqsichangeproperties <broker-name> -e <execution-group-name>
-o ComIbmJVMManager -n jvmDebugPort -v <port-number>
必须在该命令完成后重新启动代理。
- 源文件:使用此面板可告知调试器在调试期间何处查找流、映射、ESQL 或 Java 的源文件。查找路径可以是 Eclipse 项目名、外部文件夹或压缩(zip 格式)文件。您可以指定多个位置,但调试器始终先查看您在连接面板上指定的消息流项目。
- 公共:流调试器不直接使用此面板,但如果您在其中设置选项,这些选项则会起作用。
请参阅工作台用户指南以获取详细信息。
- 单击调试按钮。 在“调试”视图中,将显示所选主机和流引擎的名称。
- 当下一条消息进入流并到达断点时,流暂停,断点图标变成
,就可以开始调试了。
- 在“调试”视图中,双击您要调试的消息流。将在消息流编辑器中打开消息流,现在就可以执行如添加更多断点,启动单步跳过流等操作。
提示: 调试器可从单个工作台连接至多个执行组,并同时在不同执行组中调试多个流(因此也包括多条消息)。不过,一个执行组中的已部署流每次只能由一个用户调试,因此,如果您将调试器连接到此执行组,别的用户则不能同时也连接调试器。

V6.0 中提供的流调试器可以调试先前版本中的运行时代理。如上所述,通过选中调试向导中引擎选择面板上的相应选项,选择要调试的代理的版本。
有关在每个代理平台上必须安装的 Rational Agent Controller 版本的详细信息,请参阅安装 Rational Agent Controller。
既然完成了该任务,您就可以继续执行下面其中一项任务:
