MQUnsubscribe() 函数

语法

subscriber_name

可选参数。引用 "gbasedbt".mqiservice 表的 pubsubname 列中的值。如果不指定 subscriber_name，将把 IDS.DEFAULT.SUBSCRIBER 用作订户。subscriber_name 的最大大小为 48 个字节。

policy_name

可选参数。引用 "gbasedbt".mqipolicy 表的 policyname 列中的值。如果不指定 policy_name，将把 IDS.DEFAULT.PUB.SUB.POLICY 用作策略。policy_name 的最大大小为 48 个字节。

topic

必需参数。一个字符串，其中包含消息出版物的主题。主题的最大大小为 40 个字节。可以在一个字符串中指定多个主题（长度最大为 40 个字符）。每个主题必须使用冒号分隔。例如，“t1:t2:the third topic”表示消息与三个主题全部关联：t1、t2 和 the third topic。如果不指定主题，消息将没有关联内容。

用途

MQUnsubscribe() 函数用于注销有关指定主题的感兴趣 WMQ 消息预订。subscriber_name 为匹配指定主题的消息指定逻辑目标。

该函数要求安装 WMQ 的 WMQ 发布/预订组件，且消息代理必须正在运行。

返回码

1

操作成功。

错误

操作失败。

示例

begin;
EXECUTE FUNCTION MQUnsubscribe('Weather');
commit;

begin;
EXECUTE FUNCTION MQUnsubscribe('PORTFOLIO-UPDATES','BASIC-POLICY',
            'Stocks:Bonds');
commit;