连接到流引擎

开始之前

要执行此任务,必须先完成下列任务:

调试部署流

在您可以调试消息流之前,必须把流调试器连接到部署了流的流引擎(执行组)。如果您愿意,您可以将流调试器连接到运行在相同的或不同的主机上的多个流引擎,然后同步地调试它们的流。

要连接到流引擎:

  1. 切换到“代理管理”透视图。当在窗格中显示时,记下您的消息流的名称。
  2. 通过在代理管理导航器窗格中双击流的名称,在“消息流”编辑器中打开流。
  3. 在引出消息流输入节点的连接中添加断点。 添加此断点,为的是确保在可以开始调试之前,消息流不会完成其运行。

    断点显示为启用断点。(有关添加断点的信息,请参阅使用断点)。

  4. 切换到“调试”透视图
  5. 单击工具栏上的调试图标 启动调试,并选择调试以调用调试(创建、管理和运行配置)向导。
    提示: 将要创建调试启动配置。如果已创建调试启动配置,可以通过直接单击调试图标 启动调试 本身来重新启动。 然而要注意的是,在下列几种情况下这样做会生成错误:
    • 尚未创建调试启动配置
    • 先前连接的代理和执行组没有在运行
    • 代理和执行组已重新启动并因此具有新的进程标识(请参阅以下内容)。
  6. 在配置列表中,选择消息代理调试,然后单击新建按钮。窗口将出现一组选项卡式面板,开头为连接
    提示: “调试”按钮一直是灰化的,直到您完成连接面板上的字段。之后您可以选择完成其他面板上的字段,或径直单击调试
    向导中的面板如下所示:
    1. 连接 - 使用此面板建立通过 IBM Agent Controller 的流引擎连接。必须先完成这个面板上的所有字段,才可以单击调试按钮以启动调试会话。

      IBM Agent Controller 端口号
      输入您想要使用的端口号。
      流项目
      选择流项目。
      HostName
      选择运行流引擎的主机。如果没有列出该主机,请在 HostName 字段中输入主机的主机名或 IP 地址(如果 HostName 字段不可用,则先单击复位按钮,然后进行更改)。
      流引擎
      选择要调试的代理和流引擎。在打开的列表中,单击浏览按钮时,每个流引擎都作为其进程编号列出,后跟用冒号分隔的代理名和执行组名称,例如:
      ProcessID    Engine name
      --------- ---------------
      5984         WMBV6BR:default
      如果流引擎没有出现在列表框中,单击刷新以使用主机上当前已部署的、可用的所有流引擎的名称来更新。(如果流引擎仍然没有出现在列表框中,尝试重新启动主机上的 IBM Agent Controller。)
      注: 将显示个选项,让您选择连接到在目标主机上运行的任何执行组。这包括没有部署任何流的执行组。
      提示: 此进程编号是 Windows PID,如进程页面上的任务管理器中列出的。 当您部署时,在事件日志中报告 PID,如部署发布/预订拓扑中描述的。
      现在,可以单击调试以进行到下一步,或可以如下所示继续完成其他面板。
    2. Java 调试设置 - 调试 Java 插件节点或 Java Compute 节点时使用此面板。Java 端口是为代理 JVM 指定的端口号。如果不指定端口,则禁用 Java 调试。
      提示:
      设置代理 JVM 调试端口
      若要调试 JavaCompute 节点或包含 Java 代码的用户定义节点,代理 JVM 必须配置调试端口号。要这样操作,请发出下列命令(在一行中输入):
      mqsichangeproperties <broker-name> -e <execution-group-name>
      -o ComIbmJVMManager -n jvmDebugPort -v <port-number>
      发出此命令后,必须重新启动代理。
    3. 源文件 - 使用此面板,列出调试器在调试期间用于查找流、映射、ESQL 或 Java 的位置。查找路径可以是 Eclipse 项目名、外部文件夹或压缩文件。虽然可以指定多个位置,但调试器总会先在连接面板上指定的消息流项目中查找。
    4. 公共 - 流调试器不直接使用此面板,但如果在其中设置了选项,这些选项会起作用。 请参阅工作台用户指南以获取详细信息。
  7. 单击调试按钮。“调试”视图中,将显示所选主机和流引擎的名称。
  8. 当下一条消息进入流并到达断点时,流暂停,断点图标变成启用暂停的断点,就可以开始调试了。
  9. “调试”视图中,双击您要调试的消息流。将在“消息流”编辑器中打开消息流,现在就可以执行如添加更多断点,启动单步跳过流等操作。
提示: 调试器可从单个工作台连接至多个执行组,并同时在不同执行组(因此也包括多条消息)中调试多个流。不过,一个执行组中的部署流每次只能由一个用户调试,因此,如果您将调试器连接到此执行组,别的用户就不能同时也连接调试器。
注: V6.0 中提供的流调试器可以调试先前版本中的运行时代理。也可以如上所述,通过在调试向导中的引擎选择面板中选取相应的选项,可以选择要调试的代理的版本。
下表显示不同平台上支持的代理版本。RACIBM Agent Controller 的短名称。
  V6.0 Broker + RAC 6.0 V5 Broker + Fix Pack 3 或以上版本 + RAC 5.0.2 V5 Broker + Fix Pack 2 + RAC 5.0.2 V5 Broker + Fix Pack 2 + RAC 5.0.1
Windows
AIX
Solaris
HP-UX
z/OS
Linux 是(带有 IFix)

如果想要在 Linux 上使用流调试器和 Fix Pack 3 Broker,请与 IBM 支持中心联系。

相关概念
流调试器概述
声明 | 商标 | 下载 | | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后更新:2006/05/19
ag11186_