CHGMQMSUB (更改 MQ 预订)

允许运行的位置: 所有环境 (*ALL)
THREADSAFE: Yes

“更改MQ预订(CHGMQMSUB)”命令将更改现有MQ预订的指定属性。

参数

表 1. 命令参数
关键词	描述	选项	注意
SUBID	预订标识	`字符值`， *SAME	可选，密钥，位置 2
SUBNAME	预订名称	`字符值`， *SAME	可选，密钥，位置 1
MQM名称	消息队列管理器名称	`字符值`， *DFT	可选，密钥，位置 3
TOPICSTR	主题字符串	`字符值`， NONE ， SAME	可选，位置 4
TOPICOBJ	主题对象	`字符值`， NONE ， SAME	可选，位置 5
DEST	Destination	`字符值`， *SAME	可选，位置 6
DESTMQM	目标队列管理器	`字符值`， NONE ， SAME	可选，位置 7
DESTCRRLID	目标相关标识	`字符值`， NONE ， SAME	可选，位置 8
PUBACCT	发布记帐标记	`字符值`， NONE ， SAME	可选，位置 9
PUBAPPID	发布应用程序标识	`字符值`， NONE ， SAME	可选，位置 10
SUBUSER	预订用户标识	`字符值`， *SAME	可选，位置 11
USERDATA	预订用户数据	`字符值`， NONE ， SAME	可选，位置 12
选择器	选择器字符串	`字符值`， NONE ， SAME	可选，位置 13
PSPROP	PubSub属性	SAME， NONE ， COMPAT ， RFH2， *MSGPROP	可选，位置 14
分类	目标类	SAME， MANAGED ， *PROVIDED	可选，位置 15
VARUSER	可变用户	SAME， ANY ， *FIXED	可选，位置 16
REQONLY	请求发布	SAME， YES 和 *NO	可选，位置 17
PUBPTY	发布优先级	0-9 ， SAME， ASPUB 和 *ASQDEF	可选，位置 18
WSCHEMA	通配模式	SAME， CHAR 和 *TOPIC	可选，位置 19
EXPIRY	到期时间	0-999999999 ， SAME和 UNLIMITED	可选，位置 20

预订标识 (SUBID)

要更改的预订的预订标识。

可能的值为：

预订标识: 指定包含48个字符的十六进制字符串，以表示包含24个字节的预订标识。

预订名称 (SUBNAME)

要更改的预订的名称。

可能的值为：

预订名称: 对预订名称指定最多256个字节。
注: 可以使用 MQSC 指定大于 256 个字节的预订名称。

消息队列管理器名称 (MQMNAME)

指定队列管理器的名称。

可能的值为：

*密度泛函理论: 使用缺省队列管理器。
队列管理器名称: 队列管理器的名称。

主题字符串 (TOPICSTR)

指定与此预订相关联的主题字符串。

可能的值为：

主题字符串: 对主题字符串指定最多256个字节。
注: 可以使用 MQSC 指定大于 256 个字节的主题字符串。

主题对象 (TOPICOBJ)

指定与此预订相关联的主题对象。

可能的值为：

*相同: 属性不改变。
主题对象: 指定主题对象的名称。

目标 (DEST)

指定发布至此预订的消息的目标队列。

可能的值为：

*相同: 属性不改变。
目标队列: 指定目标队列的名称。

目标队列管理器 (DESTMQM)

指定发布至此预订的消息的目标队列管理器。

可能的值为：

*相同: 属性不改变。
*无: 未指定任何目标队列管理器。
目标队列: 指定目标队列管理器的名称。

目标相关标识 (DESTCRRLID)

指定发布至此预订的消息的相关标识。

可能的值为：

*相同: 属性不改变。
*无: 消息将放在相关标识为MQCI_NONE的目标上。
相关标识: 指定包含48个字符的十六进制字符串，以表示包含24个字节的相关标识。

发布记帐令牌 (PUBACCT)

指定发布至此预订的消息的记帐标记。

可能的值为：

*相同: 属性不改变。
*无: 消息将放在记帐标记为MQACT_NONE的目标上。
发布-记帐-令牌: 指定包含64个字符的十六进制字符串，以表示包含32个字节的发布记帐标记。

发布应用程序标识 (PUBAPPID)

指定发布至此预订的消息的发布应用程序标识。

可能的值为：

*相同: 属性不改变。
*无: 未指定发布应用程序标识。
发布应用程序标识: 指定发布应用程序标识。

预订用户标识 (SUBUSER)

指定拥有此预订的用户概要文件。

可能的值为：

*相同: 属性不改变。
用户概要文件: 指定用户概要文件。

预订用户数据 (USERDATA)

指定与预订关联的用户数据。

可能的值为：

*相同: 属性不改变。
*无: 未指定用户数据。
user-data: 对用户数据指定最多256个字节。
注: 可以使用 MQSC 指定大于 256 个字节的用户数据。

选择器字符串 (SELECTOR)

指定要应用于指定主题上发布的消息的SQL 92选择器字符串，该字符串用于选择它们是否符合此预订要求的资格。

可能的值为：

*相同: 属性不改变。
*无: 未指定选择字符串。
选择字符串: 对选择字符串指定最多256个字节。
注: 可以使用 MQSC 指定大于 256 个字节的选择字符串。

PubSub 属性 (PSPROP)

指定用于将与发布/预订相关的消息属性添加至发送给此预订的消息的方式。

可能的值为：

*相同: 属性不改变。
*无: 不将发布/预订属性添加至消息。
*兼容: 将发布/预订属性添加到消息中，以保持与 IBM® MQ V6.0 发布/预订的兼容性。
*RFH2: 发布/预订属性将添加到 RFH 2 头中的消息。
*MSGPROP: 发布/预订属性作为消息属性添加。

目标类 (DESTCLASS)

指定它是否为受管预订。

可能的值为：

*相同: 属性不改变。
* 受管: 目标是受管目标。
* 已提供: 目标是队列。

变量用户 (VARUSER)

指定预订创建者以外的用户概要文件能否连接至该预订（需要主题和目标权限检查）。

可能的值为：

*相同: 属性不改变。
*ANY: 任何用户概要文件都可以连接到预订。
* 固定: 只有创建预订的用户概要文件才能连接至该预订。

请求发布 (REQONLY)

指定订户是否通过MQSUBRQ API来轮询更新，或者是否将所有发布传送至此预订。

可能的值为：

*相同: 属性不改变。
*是: 发布仅作为MQSUBRQ API的响应传送至此预订。
* 否: 有关该主题的所有发布将传送至此预订。

发布优先级 (PUBPTY)

指定发送至此预订的消息的优先级。

可能的值为：

*相同: 属性不改变。
*ASPUB: 发送至此预订的消息的优先级取自已发布消息中提供的优先级设置。
*ASQDEF: 发送至此预订的消息的优先级取自定义为目标的队列的缺省优先级设置。
优先级值: 指定范围在0到9之间的优先级。

通配符模式 (WSCHEMA)

指定在解释主题字符串中的通配符时要使用的模式。

可能的值为：

*相同: 属性不改变。
* TOPIC: 通配符表示主题层次结构的一部分。
*CHAR: 通配符表示字符串的一部分。

到期时间 (到期)

指定预订的到期时间。超过预订的到期时间后，预订就符合队列管理器的废弃条件并且不会接收任何其他发布。

可能的值为：

*相同: 属性不改变。
* 无限制: 预订不会到期。
到期时间: 以1/10秒为单位指定范围在0到999999999之间的到期时间。