createWMQQueue 命令
在特定作用域上使用 createWMQQueue 命令来创建 WebSphere® MQ 消磁传递提供程序的队列类型目标。
要运行此命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin 脚本编制客户机是从 Qshell 运行的。有关更多信息,请参阅“配置 Qshell 以运行 WebSphere Application Server 脚本”主题。
此命令仅适用于 WebSphere Application Server V7 和更高版本的应用程序服务器。请不要对先前版本使用此命令。
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
用途
在特定作用域上使用 createWMQQueue 命令来创建 WebSphere MQ 消息传递提供程序队列类型目标。
- 在同一范围内已经存在具有同一名称的 WebSphere MQ 消息传递提供程序队列类型目标。
- JNDI 名称与 WebSphere Application Server JNDI 中的另一条目发生冲突。
目标对象
在 WebSphere MQ 消息传递提供程序队列类型目标中创建 WebSphere MQ 消息传递提供程序的范围。
必需参数
- -name
- 被分配到此 WebSphere MQ 消息传递提供程序队列类型目标的管理名称。
- -jndiName
- 用于将此对象与 WebSphere Application Server JNDI 绑定的名称。
- -queueName
- 用于存储 WebSphere MQ 消息传递提供程序队列类型目标的消息的 WebSphere MQ 队列名称。
可选参数
- -description
- 分配至该主队列类型目标的管理描述。
- -qmgr
- 主管 WebSphere MQ 队列的队列管理器。
- -persistence
- 此参数确定用来存储发送至此目标的消息的持久性级别。
请输入下列其中一个区分大小写的值:
- APP
- QDEF
- PERS
- NON
- HIGH
缺省值为 APP。
- -priority
- 对发送到此目标的消息指定的优先级。请输入下列其中一个值:
- 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 或 QDEF。
缺省值为 QDEF。
- -readAhead
- 此参数确定能否对非持久使用者的消息进行预读和高速缓存。
请输入下列某个区分大小写的值:YES、NO 或 QDEF。
缺省值为 QDEF。
- -readAheadClose
- 此参数指定消息使用者的预读关闭方法。
请输入下列其中一个区分大小写的值:DELIVERALL 或 DELIVERCURRENT。
缺省值为 DELIVERALL。
- -customProperties
- 此参数指定将传递到 WebSphere MQ 消息传递提供程序队列类型目标实现的定制属性。通常情况下,定制属性用于设置队列类型目标的属性,该目标不直接通过 WebSphere 管理接口受到支持。将使用名称和值表步骤参数指定每个定制属性。因为这些步骤都是表步骤,所以两个参数的顺序是固定的,因此必须始终先指定名称,然后指定值:
- 使用 Jython:[name value]
- 使用 Jacl:{name value}
以下示例创建了 WebSphere MQ 消息传递提供程序队列类型目标。
- 使用 Jython:
wsadmin>AdminTask.createWMQQueue("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1"])
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)
- 使用 Jacl:
wsadmin>$AdminTask createWMQQueue 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1}
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)