createWMQTopic 命令
在特定作用域上使用 createWMQTopic 命令来创建 WebSphere® MQ 消息传递提供程序的 JMS 主题目标。
要运行此命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin 脚本编制客户机是从 Qshell 运行的。有关更多信息,请参阅“配置 Qshell 以运行 WebSphere Application Server 脚本”主题。
此命令仅适用于 WebSphere Application Server V7 和更高版本的应用程序服务器。请不要对先前版本使用此命令。
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
用途
在特定作用域上使用 createWMQTopic 命令来创建 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。
- APP
- -expiry
- 时间长度,在此时间过后,发送到此目标的消息将到期并根据其处置选项进行处理。请输入下列其中一个值:
- APP注: (APP 区分大小写。)
- UNLIM注: (UNLIM 区分大小写。)
- <任何正整数>
缺省值为 APP。
- APP
- -ccsid
- 编码字符集标识 (CCSID)。
此参数的值必须是正整数或空白。有关更多详细信息,请参阅IBM MQ 消息传递提供程序队列和主题高级属性设置。
缺省值为 1208。
- -useNativeEncoding
- 此参数指定是否使用本机编码。此参数的值可以是 true 或 false。
如果设置为 true,那么 -integerEncoding、-decimalEncoding 和 -floatingPointEncoding 属性的值将被忽略。
如果设置为 false,那么编码由 -integerEncoding、-decimalEncoding 和 -floatingPointEncoding 属性指定。
- -integerEncoding
- 此队列的整数编码设置。
请输入下列其中一个区分大小写的值:Normal 或 Reversed。
Normal 是缺省值。
- -decimalEncoding
- 此队列的十进制编码设置。
请输入下列其中一个区分大小写的值:Normal 或 Reversed。
缺省值为 Normal。
- -floatingPointEncoding
- 此队列的浮点编码设置。
请输入下列其中一个区分大小写的值:IEEENormal、IEEEReversed 或 z/OS。
缺省值为 IEEENormal。
- -useRFH2
- 此参数确定是否对发送到此目标(也称为 targetClient)的消息追加 RFH V2 头。
输入下列其中一个区分大小写的值:true 或 false(分别等效于 JMS targetClient 或 MQ targetClient)。
缺省值是 true (JMS targetClient)。
- -sendAsync
- 此参数确定能否在队列管理器不了解消息已到达的情况下将消息发送到此目标。
请输入下列其中一个区分大小写的值:YES、NO 或 TDEF。
缺省值为 YES。
- -readAhead
- 此参数确定能否对非持久使用者的消息进行预读和高速缓存。
请输入下列其中一个区分大小写的值:YES、NO 或 TDEF。
缺省值为 YES。
- -readAheadClose
- 此属性确定在关闭通过使用消息侦听器以异步方式从 readAhead 参数设置为 True 的目标接收消息的消息使用者时发生的行为。
如果指定了 deliverAll 值,那么在关闭使用者之前,将传递预读的所有消息。
如果指定了 deliverCurrent 值,那么在关闭使用者之前,将只传递进行中的消息。
缺省值为 deliverCurrent。
- -wildcardFormat
- 此参数确定将哪些字符解释为主题通配符。
有效值是 Topic 或 Char。
缺省值为 Topic。
- -brokerDurSubQueue
- 这是对队列管理器定义的一个队列的名称,连接使用者将从此队列中接收非持久预订消息。
此参数的值必须是有效队列名或者保留为空。
缺省值为 SYSTEM.JMS.D.SUBSCRIBER.QUEUE。
- -brokerCCDurSubQueue
- 这是对队列管理器定义的一个队列的名称,连接使用者将从此队列中接收持久预订消息。
此参数的值必须是有效队列名或者保留为空。
缺省值是 SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE。
- -brokerPubQueue
- 这是对队列管理器定义的一个队列的名称,发布消息将被发送到此队列。
此参数的值必须是有效队列名或者保留为空。
缺省值为 SYSTEM.BROKER.DEFAULT.STREAM。
- -brokerPubQmgr
- 运行代理的队列管理器的名称。
此参数的值必须是有效队列管理器名称或者保留为空。
没有缺省值。
- -brokerVersion
- 此参数确定发布/预订操作所需的功能的级别。
此参数的值必须是 V1 或 V2。
缺省值为 V1。
- -customProperties
- 此参数将对传递至 WebSphere MQ
消息传递提供程序主题类型目标实现进行指定。通常情况下,定制属性用于设置主题类型目标的属性,该目标不直接通过 WebSphere 管理接口受到支持。将使用名称和值表步骤参数指定每个定制属性。因为这些步骤都是表步骤,所以两个参数的顺序是固定的,因此必须始终先指定名称,然后指定值:
- 使用 Jython:[name value]
- 使用 Jacl:{name value}
- 使用 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)