MQSendClob() 函数

语法

service_name: 可选参数。引用 "gbasedbt".mqiservice 表的 servicename 列中的值。如果不指定 service_name，将把 IDS.DEFAULT.SERVICE 用作服务。service_name 的最大大小为 48 个字节。
policy_name: 可选参数。引用 "gbasedbt".mqipolicy 表的 policyname 列中的值。如果不指定 policy_name，将把 IDS.DEFAULT.POLICY 用作策略。policy_name 的最大大小为 48 个字节。
clob_data: 必需参数。要发送到 WMQ 的 CLOB 数据。尽管 CLOB 数据大小最大可达 4 TB，消息的最大大小仍受 Websphere MQ 支持的对象所限制。如果 clob_data 为 NULL，将向队列发送一条长度为零的消息。
correl_id: 可选参数。一个字符串，其中包含要与此消息关联的相关标识。通常在请求与回复场景中指定 correl_id，以便将请求与回复关联。correl_id 的最大大小为 24 个字节。如果不指定，将不向消息添加任何相关标识。

用途

MQSendClob() 函数会将 clob_data 中包含的数据放入 service_name 指定的 WMQ 队列（使用 policy_name 定义的服务质量策略）。如果指定了 correl_id，将使用相关标识发送消息。如果不指定 correl_id，将不使用任何相关标识发送消息。

下表描述 MQSendClob() 函数自变量的解释方式。

表 1. MQSendClob() 自变量解释
用途	自变量解释
MQSendClob(arg1)	arg1 = clob_data
MQSendClob(arg1, arg2)	arg1 = service_name arg2 = clob_data
MQSendClob(arg1, arg2, arg3)	arg1 = service_name arg2 = policy_name arg3 = clob_data
MQSendClob(arg1, arg2, arg3, arg4)	arg1 = service_name arg2 = policy_name arg3 = clob_data arg4 = correl_id

返回码

1: 操作成功。
0 或 Error: 操作失败。

示例

示例 1

begin;
EXECUTE FUNCTION MQSendClob(filetoclob("/work/mydata", "client"));
commit;

此示例使用以下参数将 CLOB 发送到 WMQ：

service_name：缺省服务名称
policy_name：缺省策略
clob_data：filetoclob("/work/mydata", "client")
correl_id：无

示例 2

begin;
EXECUTE FUNCTION MQSendClob('MYSERVICE', filetoclob("/work/mydata", "client"));
commit;

此示例使用以下参数将 CLOB 发送到 WMQ：

service_name：“MYSERVICE”
policy_name：缺省策略
msg_data：filetoclob("/work/mydata", "client")
correl_id：无

示例 3

begin;
EXECUTE FUNCTION MQSendClob('MYSERVICE', 'MYPOLICY', 
filetoclob("/work/mydata", "client"));
commit;

此示例使用以下参数将 CLOB 发送到 WMQ：

service_name：“MYSERVICE”
policy_name：“MYPOLICY”
msg_data：filetoclob("/work/mydata", "client")
correl_id：无

示例 4

begin;
EXECUTE FUNCTION MQSendClob('MYSERVICE', 'MYPOLICY', 
filetoclob("/work/mydata", "client"), 'TEST3');
commit;

此示例使用以下参数将 CLOB 发送到 WMQ：

service_name：“MYSERVICE”
policy_name：“MYPOLICY”
msg_data：filetoclob("/work/mydata", "client")
correl_id：“TEST3”