使用 GBase Database Add-Ins for Visual Studio 调试 SPL 过程

您可以调试运行在 GBase 8s 上的任何 SPL 过程。您可以遍历您的代码，设置行或变量断点，查看变量值，更改变量值，查看嵌套过程的调用堆栈信息，以及在调用堆栈的不同过程之间切换。通过在调试模式下运行过程并查看结果时单步执行代码，可以发现过程的问题并进行必要的更改。

要在 GBase Database Add-Ins for Visual Studio（IDAIVS）中启动 SPL 例程调试，请按照以下步骤操作：

启动并配置 GBase 8s 数据库服务器实例

要配置 GBase 8s 数据库服务器实例以致于启用 SPL 例程调试，请按照下列步骤操作：

1. 安装 GBase 8s 数据库服务器产品。
2. 配置 onconfig 和 sqlhosts 文件中的条目并启动 GBase 8s 服务器，以支持 DRDA 通信协议：
   • onconfig:

     DBSERVERNAME   ids_spldb

   • sqlhosts:

     ids_spldb   drsoctcp   ids_server_machine_name   port_number

   注： GBase 8s 的 SPL Routine Debugger 支持通过 GBase 8s .Net provider 连接到客户端，并且需要 GBase 8s DRDA 协议连接。
3. 您必须提供一个 sbspace ，以便数据库服务器存储 GBase Database Add-Ins for Visual Studio 发送给服务器的 XML 消息。SBSPACENAME 配置参数的设置指定了系统缺省 sbspace 的名称。可以通过带 -Df "LOGGING=ON" 选项的 onspaces 实用程序在数据库上创建缺省 sbspace。此 sbspace 在 GBase Database Add-Ins for Visual Studio上调试 SPL 的必要条件。
4. 如果这是新的服务器实例，使用 CREATE DATABASE 语句创建新的数据库。稍后将使用此数据库在 GBase Database Add-Ins for Visual Studio 中创建数据库连接，以部署和调试 SPL 例程。

启动例程调试会话管理器

要启动会话管理器，请按照下列步骤操作：

1. 要手动启动会话管理器，使用以下的命令输出 CLASSPATH 环境变量设置：

   export CLASSPATH=${GBASEDBTDIR}/bin/db2dbgm.jar:$CLASSPATH
             

2. 使用 Java™ 1.5.0 或更高版本并确保它在 PATH 环境变量中运行下列命令，指定会话管理器将会使用的 port number 以及会话管理器日志文件的 pathname ：

   java com.ibm.db2.psmd.mgr.Daemon -port port_num -log sess_mgr_log_path

建立 GBase 8s 数据库服务器连接

通过选择 "Add Connection…" 菜单项创建新连接，可以从服务器资源管理器中 "Data Connections" 节点上的操作（右键单击）弹出菜单访问 Add Connection 对话框。Data source 字段会显示 "IBM DB2,GBase 8s and U2 Servers (IBM DB2, GBase 8s, and U2 Data Provider)。"

1. 在下面 "1. Select or enter server name:"字段中，输入 GBase 8s 服务器实例的名称。
2. 在 "2. Enter information to log on to the server:" 旁边的字段中输入您的用户 ID 作为 User ID: ，在 Password: 字段中输入服务器上 gbasedbt 账户的密码。
3. 在"3. Select or enter a database name:" 下面的字段中，输入存储要调试的 SPL 过程的数据库的名称。
4. 点击 Test Connection 按钮以测试 GBase 8s 服务器实例的连接。
5. 如果出现 Test connection succeeded 对话框，您可以点击 OK 按钮。可以忽略此 Add Connection 对话框，因为您已经在 GBase 8s 服务器和 Visual Studio 之间创建了连接。

设置会话管理器

在您开始调试会话之前，需要指定要调试的 SPL 例程，和数据库服务器连接以及会话管理器的端口号。

1. 从 Server Explorer 中的 "Data Connections" 节点中，单击所有连接的 GBase 8s 服务器。
2. 展开 Procedures 标题以显示数据库中所有存储过程的名称。
3. 单击您要调试的 SPL 例程的名称。
4. 从 Tools 选项卡，选择 Tools 列表底部附近的 "Options . . . " 菜单。
5. 从 Options 对话框中，展开 GBase 8s Database Tools 项，然后单击 General 项显示类别的列表。
6. 使用 General 选项列表右侧的滑块控件显示 Session Manager Connection 和 Session Manager Port 号。
7. 单击 OK 接受会话管理器配置的这些值。

有关如何使用 Visual Studio 的调试 SPL 例程的详细信息，请参阅 GBase Database Add-Ins for Visual Studio。

调试 GBase 8s SPL 过程

在 CLR 应用程序中调试 GBase 8s SPL 过程

当您以 C# 和 Visual Basic 语言开发 Windows™ 或 ASP.NET 应用程序，您可以使用 GBase Database Add-Ins for Visual Studio调试公共语言运行库（CLR）应用程序。 如果该应用程序访问 GBase 8s 数据库服务器实例，则您可以在调试此应用程序时调试从此应用程序调用的 SPL 过程。

GBase Unified Debugger 通过 GBase Procedure Designer 调试 SPL 过程。如果当您调试应用程序时一个过程定义在 Designer 中打开，随着调试器进入该过程，将激活该 Designer 的实例。如果未在 Designer 中打开该过程定义，则随着调试器进入该过程，此调试器会在 Designer 的新实例中打开过程定义。

先决条件： 要调试 CLR 应用程序的 SPL 过程，在包含此应用程序中的项目中启用 GBase 8s SQL debugging 。

要调试 CLR 应用程序的 SPL 过程，请按照以下步骤操作：

在 CLR 应用程序中启用 SQL 调试

如果要在 C# 或 Visual Basic 公共语言运行时（CLR）应用程序中调试 GBase 8s SPL 过程，则必须首先为 GBase 数据库项目启用 GBase SQL 调试。您只需执行一次此过程，为项目启用 SQL 调试会在 Visual Studio 中设置一个会在会话之间持续存在的项目属性。

当您在应用程序中启用 SQL 调试，则 GBase Unified Debugger 必须关闭并重新打开包含此应用程序的 GBase 数据库项目。项目重新打开后，必须指定数据连接以及可选的运行调试会话管理器的端口。您还必须更改某些标准 Visual Studio 项目调试属性的设置。

加载项（ 32 位应用程序）不支持控制台应用程序的 64 位调试过程。在 64 位操作系统中，缺省的 debug 平台是 Any CPU ，这是一个 64 位调试过程。您必须在项目属性中指定 32 位调试平台。

Prerequisite:要在应用程序中启用 GBase SQL 调试，在包含此应用程序的 GBase 数据库项目必须在解决方资源案管理中打开。