创建物理目的地

要创建物理目的地，请使用 imqcmd create 子命令。 下面是 create 子命令的语法：

create dst -t destType -n 
destName [-o property=value
] [-o property=value1]
…

例如，要创建队列目的地，请输入以下命令：

imqcmd create dst -n myQueue -t q -o "maxNumActiveConsumers=5"

要创建主题目的地，请输入以下命令：

imqcmd create dst -n myTopic -t t -o "maxBytesPerMsg=5000"

创建物理目的地时，请指定以下内容：

• 物理目的地类型 t（主题）或 q（队列）。

• 物理目的地名称。命名规则如下：

  • 名称必须仅包含字母数字字符。不能包含空格。

  • 名称可以字母字符、下划线字符 (_) 或美元符号 ($) 开头。名称不能以字符串 mq 开头。

  物理目的地属性的非默认值。

也可以在更新物理目的地时设置属性。

许多物理目的地属性都影响代理的内存资源和消息流。例如，可以指定能发送到物理目的地的生成方数量，它们可以发送的消息数量和大小，以及达到物理目的地限制时代理应做出的响应。这些限制与由代理配置属性控制的代理范围的限制类似。

以下属性既适用于队列目的地，也适用于主题目的地：

• maxNumMsgs。指定物理目的地中允许的未使用消息的最大数量。

• maxTotalMsgBytes。指定物理目的地中允许用于未使用消息的内存的最大总量（以字节为单位）。

• limitBehavior。指定当达到内存限制阈值时代理的响应方式。

• maxBytesPerMsg。指定物理目的地中允许的任何单个消息的最大大小（以字节为单位）。

• maxNumProducers。指定物理目的地的生成方的最大数量。

• consumerFlowLimit。指定在一批中传送给使用方的消息的最大数量。

• isLocalOnly。仅适用于代理群集。指定物理目的地不能在其他代理上复制，因而限定只能将消息传送到本地使用方（连接到创建物理目的地的代理的使用方）。

• useDMQ。指定是丢弃物理目的地的停用消息，还是将其放在停用消息队列中。

以下属性只适用于队列目的地：

• maxNumActiveConsumers。指定来自队列目的地的负载平衡传送中可以处于活动状态的最大使用方数。

• maxNumBackupConsumers。指定当来自队列目的地的负载平衡传送中出现任何错误时，可以代替活动使用方的最大备份使用方数。

• localDeliveryPreferred。仅应用于代理群集中的负载平衡队列传送。指定仅当本地代理中没有使用方时才将消息传送到远程使用方。

有关物理目的地属性的完整参考信息，请参见第 15 章，物理目的地属性参考。

对于自动创建的目的地，在代理的实例配置文件中设置默认属性值。有关自动创建的属性的参考信息，请参见表 14–3。