发行说明

|20.1 DB2 MQSeries 函数的安装和配置

|本节描述如何配置 DB2 环境以使用“DB2 MQSeries 函数”。成功完成下列过程后，就可以在 SQL 中使用“DB2 MQSeries 函数”。这些函数的描述可在《发行说明》的『SQL |Reference』一节中找到。

|配置和启用“DB2 MQSeries 函数”的基本过程是：

1. |安装 MQSeries。
2. |安装 MQSeries AMI。
3. |启用和配置“DB2 MQSeries 函数”。 |

|此外，要利用“DB2 MQSeries 函数”提供的发布／预订功能，还必须安装“MQSeries 集成器”或“MQSeries 发布／预订函数”。有关“MQSeries 集成器”的信息，可在以下网址找到：http://www.ibm.com/software/ts/mqseries/integrator。有关“MQSeries 发布／预订”功能部件的信息，可在类别 3 中的 http://www.ibm.com/software/ts/mqseries/txppacs 中找到。

|20.1.1 安装 MQSeries

|第 1 步是确保 DB2 服务器上至少安装了具有最新修订包的 MQSeries 版本 5.1。如果已安装了此版本的 MQSeries，则跳至下一步“安装 MQSeries AMI”。DB2 版本 7.2 |包括要与 DB2 配合使用的 MQSeries 服务器。有关安装 MQSeries |或升级现有 MQSeries 安装的特定于平台的指示信息可在以下网址处的特定于平台的《快速入门》中找到：http://www.ibm.com/software/ts/mqseries/library/manuals。在进行安装过程时，一定要设置缺省队列管理器。

|20.1.2 安装 MQSeries AMI

|下一步就是安装“MQSeries 应用程序消息传递接口”（AMI）。这是对让管理和编程任务完全分离的 |MQSeries 编程接口的扩展。“DB2 MQSeries 函数”需要安装此接口。如果已在 DB2 服务器上安装了 MQSeries AMI，则跳至下一步“启用 DB2 MQSeries 函数”。如果未安装 |MQSeries AMI，则可通过随 DB2 7.2 提供的安装软件包或通过从 MQSeries Support Pacs |Web 站点（网址为 http://www.ibm.com/software/ts/mqseries/txppacs）下载 AMI 的副本来完成此操作。AMI 可在“第 3 类－产品扩展功能”中找到。为方便起见，我们在提供 DB2 的同时也提供了 MQSeries AMI 的副本。此文件在 |sqllib/cfg 目录中。该文件的名称是与操作系统有关的：
|

|遵循 AMI 自述文件（包含在压缩安装映象中）中所概述的正常 AMI 安装过程。

|20.1.3 启用 DB2 MQSeries 函数

|在此步骤中，您将对“DB2 MQSeries 函数”配置和启用数据库。enable_MQFunctions |实用程序是一个非常灵活的命令，它首先会检查是否设置了正确的 MQSeries 环境，然后为 DB2 MQSeries 函数创建缺省配置，启用带有这些函数的指定数据库，并确认配置是否生效。 |

1. |对于 Windows NT 或 Windows 2000，转至第 5 步。
2. |在 UNIX 上设置组：如果正在 UNIX 上启用这些函数，则必须首先将 DB2 实例所有者（通常是 db2inst1）和与受防护 UDF（通常是 db2fenc1）相关联的用户标识添加至 MQSeries 组 mqm。这对于 DB2 函数访问 |MQSeries 是必需的。
3. |在 UNIX 上设置“DB2 环境变量”：将 AMT_DATA_PATH 环境变量添加至 DB2 理解的列表。可编辑文件 |$INSTHOME/sqllib/profile.env，将 AMT_DATA_PATH 添加至 |DB2ENVLIST。还可使用 db2set 命令。
4. |在 UNIX 上，重新启动数据库实例：要使环境变量更改生效，必须重新启动数据库实例。
5. |将目录切换至 $INSTHOME/sqllib/cfg（对于 UNIX）或 %DB2PATH%/cfg（在 Windows 上）。
6. |运行命令 enable_MQFunctions |以对“DB2 MQSeries 函数”配置和启用数据库。参考20.6, enable_MQFunctions以获取此命令的完整描述。下面给出了一些常见示例。成功完成后，将启用指定数据库并测试配置。
7. |要使用“命令行处理器”测试这些函数，在连接至启用的数据库后发出下列命令：

   |values DB2MQ.MQSEND('a test')  
   |values DB2MQ.MQRECEIVE()

   第一个语句会将消息“a test”发送至 DB2MQ_DEFAULT_Q 队列，而第二个语句将接收回该消息。 |

|注意:

作为运行 enable_MQFunctions |的结果，将会建立缺省 MQSeries 环境。将创建 MQSeries 队列管理器 |DB2MQ_DEFAULT_MQM 和缺省队列 DB2_DEFAULT_Q。如果 AMT_DATA_PATH |所指向的目录中不存在文件 |amt.xml、amthost.xml 和 amt.dtd 的话，将会创建这些文件。如果 |amthost.xml 文件不存在，且不包含对 connectionDB2MQ 的定义，则会对该文件添加一行，以指出适当的信息。原始文件的副本将另存为 |DB2MQSAVE.amthost.xml。 |