createWMQTopic 命令

在特定作用域上使用 createWMQTopic 命令来创建 WebSphere® MQ 消息传递提供程序的 JMS 主题目标。

要运行此命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。

[IBM i]wsadmin 脚本编制客户机是从 Qshell 运行的。有关更多信息,请参阅“配置 Qshell 以运行 WebSphere Application Server 脚本”主题。

此命令仅适用于 WebSphere Application Server V7 和更高版本的应用程序服务器。请不要对先前版本使用此命令。

要获取可用的 IBM MQ 消息传递提供程序管理命令的列表以及每个命令的简短描述,请在 wsadmin 提示符处输入以下命令:

print AdminTask.help('WMQAdminCommands')

要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:

print AdminTask.help('command_name')

在使用这些命令之后,保存对主配置所做的更改。例如,使用以下命令:

AdminConfig.save()

用途

在特定作用域上使用 createWMQTopic 命令来创建 WebSphere MQ 消息传递提供程序主题类型目标。

您不能在以下条件之一创建 WebSphere MQ 消息传递提供程序主题类型目标:
  • 在同一范围内已经存在具有同一名称的 WebSphere MQ 消息传递提供程序主题类型目标。
  • JNDI 名称与 WebSphere Application Server JNDI 中的另一条目发生冲突。

目标对象

在 WebSphere MQ 消息传递提供程序主题类型目标中创建 WebSphere MQ 消息传递提供程序的范围。

必需参数

-name
被分配到此 WebSphere MQ 消息传递提供程序主题类型目标的管理名称。
-jndiName
用于将此对象与 WebSphere Application Server JNDI 绑定的名称。
-topicName
在使用此目标定义时,接收或发送出版物的 WebSphere MQ 主题名称。

可选参数

-description
对此主题类型目标指定的管理描述。
-persistence
此参数确定用来存储发送至此目标的消息的持久性级别。
请输入下列其中一个区分大小写的值:
  • APP
  • TDEF
  • PERS
  • NON
  • HIGHT

APP 是缺省值。

-priority
对发送到此目标的消息指定的优先级。
请输入下列其中一个值:
  • APP
    注: (APP 区分大小写。)
  • QDEF
    注: (QDEF 区分大小写。)
  • <范围 0 到 9(包括 9)中的正整数>
请输入下列其中一个值:
  • APP
    注: (APP 区分大小写。)
  • QDEF
    注: (QDEF 区分大小写。)
  • <范围 0 到 9(包括 9)中的正整数>

缺省值为 APP

-expiry
时间长度,在此时间过后,发送到此目标的消息将到期并根据其处置选项进行处理。
请输入下列其中一个值:
  • APP
    注: (APP 区分大小写。)
  • UNLIM
    注: (UNLIM 区分大小写。)
  • <任何正整数>

缺省值为 APP

-ccsid
编码字符集标识 (CCSID)。

此参数的值必须是正整数或空白。有关更多详细信息,请参阅IBM MQ 消息传递提供程序队列和主题高级属性设置

缺省值为 1208

-useNativeEncoding
此参数指定是否使用本机编码。此参数的值可以是 truefalse

如果设置为 true,那么 -integerEncoding-decimalEncoding-floatingPointEncoding 属性的值将被忽略。

如果设置为 false,那么编码由 -integerEncoding-decimalEncoding-floatingPointEncoding 属性指定。

-integerEncoding
此队列的整数编码设置。

请输入下列其中一个区分大小写的值:NormalReversed

Normal 是缺省值。

-decimalEncoding
此队列的十进制编码设置。

请输入下列其中一个区分大小写的值:NormalReversed

缺省值为 Normal

-floatingPointEncoding
此队列的浮点编码设置。

请输入下列其中一个区分大小写的值:IEEENormalIEEEReversedz/OS

缺省值为 IEEENormal

-useRFH2
此参数确定是否对发送到此目标(也称为 targetClient)的消息追加 RFH V2 头。

输入下列其中一个区分大小写的值:truefalse(分别等效于 JMS targetClient 或 MQ targetClient)

缺省值是 true (JMS targetClient)

-sendAsync
此参数确定能否在队列管理器不了解消息已到达的情况下将消息发送到此目标。

请输入下列其中一个区分大小写的值:YESNOTDEF

缺省值为 YES

-readAhead
此参数确定能否对非持久使用者的消息进行预读和高速缓存。

请输入下列其中一个区分大小写的值:YESNOTDEF

缺省值为 YES

-readAheadClose
此属性确定在关闭通过使用消息侦听器以异步方式从 readAhead 参数设置为 True 的目标接收消息的消息使用者时发生的行为。

如果指定了 deliverAll 值,那么在关闭使用者之前,将传递预读的所有消息。

如果指定了 deliverCurrent 值,那么在关闭使用者之前,将只传递进行中的消息。

缺省值为 deliverCurrent

-wildcardFormat
此参数确定将哪些字符解释为主题通配符。

有效值是 TopicChar

缺省值为 Topic

-brokerDurSubQueue
这是对队列管理器定义的一个队列的名称,连接使用者将从此队列中接收非持久预订消息。

此参数的值必须是有效队列名或者保留为空。

缺省值为 SYSTEM.JMS.D.SUBSCRIBER.QUEUE

-brokerCCDurSubQueue
这是对队列管理器定义的一个队列的名称,连接使用者将从此队列中接收持久预订消息。

此参数的值必须是有效队列名或者保留为空。

缺省值是 SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE

-brokerPubQueue
这是对队列管理器定义的一个队列的名称,发布消息将被发送到此队列。

此参数的值必须是有效队列名或者保留为空。

缺省值为 SYSTEM.BROKER.DEFAULT.STREAM

-brokerPubQmgr
运行代理的队列管理器的名称。

此参数的值必须是有效队列管理器名称或者保留为空。

没有缺省值。

-brokerVersion
此参数确定发布/预订操作所需的功能的级别。

此参数的值必须是 V1V2

缺省值为 V1

-customProperties
此参数将对传递至 WebSphere MQ 消息传递提供程序主题类型目标实现进行指定。通常情况下,定制属性用于设置主题类型目标的属性,该目标不直接通过 WebSphere 管理接口受到支持。
将使用名称和值表步骤参数指定每个定制属性。因为这些步骤都是表步骤,所以两个参数的顺序是固定的,因此必须始终先指定名称,然后指定值:
  • 使用 Jython:[name value]
  • 使用 Jacl:{name value}
注: 在以下示例中,以 wsadmin> 开始的代码块显示了由用户输入的代码。不是以 wsadmin> 开始的行显示控制台所返回的代码。
以下示例通过指定数目最少的参数来创建主题定义。
  • 使用 Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01")
    MQTopic_1098737234986)
     9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    wsadmin>AdminTask.createWMQTopic("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name T1 -jndiName jms/topic/t1
     -topicName myTopic"])
    T1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
  • 使用 Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
     
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    wsadmin>$AdminTask createWMQTopic 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) 
    {-name T1 -jndiName jms/topic/t1 -topicName myTopic}
    T1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQTopic_1098737234986)

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rmj_wmq_jmstopic_create
文件名:rmj_wmq_jmstopic_create.html