要使用 Optim™ Development Studio (ODS) 调试 SPL
例程,您必须在
GBase 8s
数据库服务器和 ODS
客户端之间建立连接。
您可以在客户端调试环境中检查 SPL 例程的运行时的行为,并用 Optim Development
Studio(ODS)的标准调试器接口控制调试会话的流程。以下步骤也适用于 Optim Data
Studio。
注:
GBase 8s
数据库服务器的 SPL Routine Debugger
支持在 ODS 2.2.1.0 及以后的版本中有效。 早期的 ODS 版本(如 2.2.0)支持
GBase 8s
数据库服务器,但是不提供
GBase 8s
SPL 支持和 SPL Routine Debugger
支持。
要在 ODS 中启用 SPL Routine 调试会话,请遵循以下步骤:
GBase 8s
服务器实例:启动和配置
要配置
GBase 8s
数据库服务器实例以致于启用 SPL
例程调试,请按照下列步骤操作:
- 安装
GBase 8s
数据库服务器产品。
- 配置 onconfig 和 sqlhosts 文件中的条目并启动
GBase 8s
服务器,以支持 DRDA 通信协议:
注:
GBase 8s
数据库服务器的 SPL Routine
Debugger 支持通过 JDBC 和 SQL 的 GBase Data
Server 驱动连接到客户端,并且需要
GBase 8s
DRDA 协议连接。
- 您必须提供一个 sbspace ,以便数据库服务器存储 ODS 发送给服务器的 XML 消息。SBSPACENAME 配置参数的设置指定了系统缺省 sbspace
的名称。可以通过带 -Df "LOGGING=ON" 选项的 onspaces 实用程序在数据库上创建缺省 sbspace。此 sbspace 在
ODS 上调试 SPL 的必要条件。
- 如果这是新的服务器实例,使用 CREATE DATABASE 语句创建新的数据库。稍后将使用此数据库在 ODS 中创建数据库连接,以部署和调试 SPL 例程。
启动例程调试器会话管理器(可选的)
在大多数情况下,您可以使用 ODS 提供的内置的会话管理其调试
GBase 8s
SPL 例程。但是在某些情况中(例如,如果您的服务器机器在防火墙之后),您可能需要在 TCP/IP
端口上启动会话管理器,该端口在服务器计算机或其它计算机上具有出站访问权限。
要手动启动会话管理器,请按照下列步骤操作:
- 要手动启动会话管理器,使用以下的命令输出 CLASSPATH
环境变量设置:
export CLASSPATH=${GBASEDBTDIR}/bin/db2dbgm.jar:$CLASSPATH
- 使用 Java™ 1.5.0 或更高版本并确保它在 PATH
环境变量中运行下列命令,指定会话管理器将会使用的 port number 以及会话管理器日志文件的 pathname
:
java com.ibm.db2.psmd.mgr.Daemon -port port_num -log sess_mgr_log_path
在 ODS 中部署和调试 SPL 例程的步骤
要配置 ODS 以部署和调试
GBase 8s
SPL
例程,请按照下列步骤操作:
- 如果不使用内置会话管理器并启动单个的会话管理器,请使用菜单命令在 ODS 中配置该选项(Window > Preferences > Run/Debug >
Routine Debugger >
DB2
screen)方法是选择 "Use an already running Session manager"
单项按钮,并提供端口号和机器名称。
- 要配置 ODS 以调试
GBase 8s
SPL 例程,您需要在 ODS
的 Data Source Explorer 中创建一个 Database 连接。有关如何创建 Database 连接的详细信息请参阅 Optim Development Studio 文档。
- 在 Database Connection > New Connection 对话框中右击。选择
GBase 8s
,并通过从驱动程序列表中选择对
GBase 8s
适当版本的 JDBC 和 SQLJ GBase Data
Server 驱动程序来创建新的数据库连接。
- 在 Edit Driver Definitions 对话框中,打开 Jar List 选项卡并验证它是否包含
db2jcc4.jar。如果没有,在Driver files: 列表中使用 db2jcc4.jar 替换
db2jcc.jar 。
- 有关如何 Create 、Deploy 和 Debug SPL 例程的详细信息请参阅 Optim Development Studio 文档。
现在您可以准备在 Optim Development Studio 中创建、部署并调试
GBase 8s
SPL 例程。