ALTER 队列 (改变队列设置)

• 不能超过 12 个字符
• 必须以大写字母 (A-Z) 开头
• 只能包含字符 A-Z 和 0-9

• 在 QSGDISP ( SHARED ) 的本地队列中， CFSTRUCT 不能更改。
• 如果更改 CFSTRUCT 或 QSGDISP 值，那么必须删除并重新定义队列。 要保留队列上的任何消息，必须先卸载消息，然后才能删除队列。 在重新定义队列后重新装入消息，或者将消息移至另一个队列。
• 在带有 DEFTYPE ( SHAREDYN ) 的模型队列中， CFSTRUCT 不能为空。
• 在 QSGDISP 不是 SHARED 的本地队列上，或在 DEFTYPE 不是 SHAREDYN 的模型队列上， CFSTRUCT 的值并不重要。

• 在带有 QSGDISP ( SHARED ) 的本地队列或带有 DEFTYPE ( SHAREDYN ) 的模型队列中， CFSTRUCT 不能为空。
• 在 QSGDISP 不是 SHARED 的本地队列上，或在 DEFTYPE 不是 SHAREDYN 的模型队列上， CFSTRUCT 的值并不重要。

• 必须可共享，通过指定队列属性 SHARE。
• 必须通过指定 INDXTYPE (CORRELID) 对相关标识建立索引。
• 不能是动态队列或共享队列。

只有 CLUSNL 或 CLUSTER 的其中一个结果值可以是非空白值; 不能同时指定这两个值的值。

只有 CLUSNL 或 CLUSTER 的其中一个结果值可以是非空白值; 不能同时指定这两个值的值。

''

该命令在输入该命令的队列管理器上运行。

QmgrName

如果队列管理器在队列共享组中处于活动状态，那么该命令将在您指定的队列管理器上运行。

可以指定队列管理器名称，但输入命令的队列管理器除外。 仅当您正在使用队列共享组环境并且已启用命令服务器时，才能指定其他名称。

*

该命令在本地队列管理器上运行，并且还会传递到队列共享组中的每个活动队列管理器。 * 的效果与在队列共享组中的每个队列管理器上输入命令相同。

• CUSTOM('')
• CUSTOM('A(B)')
• CUSTOM('C(D) E(F)')
• CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

资本支出 （整数）

最长时间 (以十分之一秒为单位) ，直到在解析路径中将对象句柄与此对象配合使用的消息变为适合到期处理为止。

有关消息到期处理的更多信息，请参阅 强制缩短到期时间。

整数

该值必须在范围 1 到 999 999 999 之间。

NOLIMIT

对于使用此对象放入的消息的到期时间没有限制。 这是缺省值。

在 IBM MQ for z/OS 上，您可以使用 CUSTOM 属性设置 CAPEXPRY 。

例如：

ALTER QL(Q1) CUSTOM('CAPEXPRY(1000)')

例如，要取消设置 IBM MQ for z/OS 上的 CAPEXPRY 属性，请输入以下命令:

ALTER QL(Q1) CUSTOM(' ')

注意： 在 z/OS 上，单引号之间必须留一个空格，否则命令会失败。

为 CAPEXPRY 指定无效的值不会导致命令失败。 而是使用缺省值。

请注意，在 CAPEXPRY中进行更改之前，队列中的现有消息不受更改影响 (即，其到期时间保持不变)。 只有在 CAPEXPRY 中的更改后放入队列中的新消息才具有新的到期时间。

PERMDYN

当应用程序发出具有对象描述符 (MQOD) 中指定的此模型队列的名称的 MQOPEN MQI 调用时，将创建永久动态队列。

在 z/OS 上，动态队列的布局为 QMGR。

SHAREDYN

此选项仅在 z/OS 上可用。

当应用程序发出具有对象描述符 (MQOD) 中指定的此模型队列的名称的 MQOPEN API 调用时，将创建永久动态队列。

动态队列的配置为 SHARED 。

TEMPDYN

当应用程序发出具有在对象描述符 (MQOD) 中指定的此模型队列的名称的 MQOPEN API 调用时，将创建临时动态队列。

在 z/OS 上，动态队列的布局为 QMGR。

对于 DEFPSIST 参数为 YES 的模型队列定义，请勿指定该值。

如果指定了该选项，请不要指定 INDXTYPE(MSGTOKEN)。

在队列中存在消息时，请勿更改 USAGE 参数; 将消息放入传输队列时，这些消息的格式会更改。

如果未在描述的环境中指定 FORCE ，那么该命令将失败。

mqrc_object_changed (2041)

NONE

没有维护索引。 在通常按顺序检索邮件时，使用 NONE ，或在 MQGET 调用中将邮件标识符和相关标识符作为选择标准。

MSGID

维护消息标识的索引。 当通常在 MQGET 调用中使用信息标识符作为选择标准检索信息，并将相关标识符设为 NULL 时，请使用 MSGID 。

CORRELID

维护相关标识的索引。 当通常在 MQGET 调用中使用相关标识符作为选择标准检索报文，并将报文标识符设为 NULL 时，请使用 CORRELID 。

GROUPID

维护组标识的索引。 使用邮件分组选择标准检索邮件时，请使用 GROUPID 。

注：

1. 如果队列是传输队列，则不能将 INDXTYPE 设置为 GROUPID 。
2. 队列必须使用 CFLEVEL(3) 的 CF 结构，以指定与 INDXTYPE ( GROUPID ) 共享队列。

MSGTOKEN

维护消息令牌的索引。 如果队列是由 WLM 管理的队列，并与 z/OS 的工作负载管理器功能一起使用，请使用 MSGTOKEN 。

注意： 如果出现以下情况，则不能将 INDXTYPE 设置为 MSGTOKEN ：

• 队列是一个模型队列，定义类型为 SHAREDYN
• 队列是临时动态队列
• 队列是传输队列
• 您指定 QSGDISP ( SHARED )

• AIX, Linux, and Windows
• z/OS

QMGR

根据队列管理器参数 MONQ的设置收集监视数据。

OFF

对此队列关闭联机监视数据收集。

LOW

如果队列管理器的 MONQ 参数值不是 NONE ，则会为该队列打开在线监控数据收集功能。

MEDIUM

如果队列管理器的 MONQ 参数值不是 NONE ，则会为该队列打开在线监控数据收集功能。

HIGH

如果队列管理器的 MONQ 参数值不是 NONE ，则会为该队列打开在线监控数据收集功能。

PRIORITY

在优先级内以先进先出 (FIFO) 顺序传递消息 (响应 MQGET API 调用)。

FIFO

按 FIFO 顺序传递消息 (响应 MQGET API 调用)。 对于此队列上的消息，将忽略优先级。

• IBM i
• AIX, Linux, and Windows
• z/OS

ALL

设置 ALL 后，应用程序就能从 MQRFH2 头信息或信息句柄属性中读取信息的所有属性。

ALL 选项使无法更改的应用程序能够从 MQRFH2 标头访问所有报文属性。 可以更改的应用程序可以将消息的所有属性作为消息句柄的属性进行访问。

在某些情况下，接收到的消息中的 MQRFH2 头中的数据格式可能与发送消息时的格式不同。

COMPAT

设置 COMPAT 后，那些希望 JMS 相关属性出现在 MQRFH2 报文数据头中的未修改应用程序就能像以前一样继续工作。 可以更改的应用程序可以将消息的所有属性作为消息句柄的属性进行访问。

如果消息包含前缀为 mcd.， jms.， usr.或 mqext.的属性，那么所有消息属性都将传递到应用程序。 如果未提供消息句柄，那么将在 MQRFH2 头中返回属性。 如果提供了消息句柄，那么将在消息句柄中返回所有属性。

如果消息不包含具有其中一个前缀的属性，并且应用程序未提供消息句柄，那么不会将任何消息属性返回到应用程序。 如果提供了消息句柄，那么将在消息句柄中返回所有属性。

在某些情况下，接收到的消息中的 MQRFH2 头中的数据格式可能与发送消息时的格式不同。

FORCE

强制所有应用程序从 MQRFH2 头读取消息属性。

无论应用程序是否指定消息句柄，都将始终在 MQRFH2 头中的消息数据中返回属性。

将忽略 MQGET 调用上 MQGMO 结构的 MsgHandle 字段中提供的有效消息句柄。 无法使用消息句柄来访问消息的属性。

在某些情况下，接收到的消息中的 MQRFH2 头中的数据格式可能与发送消息时的格式不同。

NONE

如果提供了消息句柄，那么将在消息句柄中返回所有属性。

在将消息传递到应用程序之前，将从消息体中除去所有消息属性。

ENABLED

生成队列深度上限事件。

DISABLED

不生成队列深度上限事件。

ENABLED

生成队列深度下限事件。

DISABLED

不生成队列深度下限事件。

ENABLED

生成队列满事件。

DISABLED

不生成队列满事件。

• 如果此定义用于远程队列的本地定义，那么当发生打开时， RNAME 不得为空。
• 如果此定义用于队列管理器别名定义，那么当发生打开时， RNAME 必须为空白。

  在队列管理器集群中，此定义仅适用于创建此定义的队列管理器。 要将别名发布到整个集群，请将 CLUSTER 属性添加到远程队列定义。

• 如果此定义用于应答队列别名，那么此名称是要作为应答队列的队列的名称。

• 如果应用程序打开远程队列的本地定义，那么 RQMNAME 不得为空或本地队列管理器的名称。 当打开时，如果 XMITQ 为空白，那么必须有此名称的本地队列，该队列将用作传输队列。
• 如果此定义用于队列管理器别名，那么 RQMNAME 是要设置别名的队列管理器的名称。 它可以是本地队列管理器的名称。 否则，如果 XMITQ 为空，那么在打开时，必须存在此名称的本地队列，该队列将用作传输队列。
• 如果 RQMNAME 用于应答队列别名，那么 RQMNAME 是要作为应答队列管理器的队列管理器的名称。

QMGR

队列定义具有队列管理器作用域。 这意味着队列的定义不会扩展到拥有该队列的队列管理器之外。 您可以通过以下两种方式之一打开另一个队列管理器拥有的输出队列:

1. 指定拥有队列管理器的名称。
2. 在另一个队列管理器上打开队列的本地定义。

CELL

队列定义具有单元作用域。 单元作用域表示该队列对于单元中的所有队列管理器都是已知的。 可以仅通过指定队列的名称来打开具有单元作用域的队列以进行输出。 无需指定拥有该队列的队列管理器的名称。

如果单元目录中已有同名的队列，那么该命令将失败。 REPLACE 选项不会影响此情况。

仅当配置了支持单元目录的名称服务时，此值才有效。

限制: 不再支持 DCE 名称服务。

SHARE

多个应用程序实例可以从队列中获取消息。

NOSHARE

只有单个应用程序实例可以从队列中获取消息。

贝 STEF

如果可以传递原始消息，但流式消息无法传递，那么原始消息仍将传递到其队列。

这是缺省值。

必须

队列管理器确保将原始消息和流式消息都成功传递到其队列。

如果由于某种原因无法将流式消息传递到其队列，那么原始消息也不会传递到其队列。 放置应用程序接收到错误原因码，必须尝试再次放置消息。

FIRST

每当第一条优先级等于或大于队列的 TRIGMPRI 参数指定的优先级的消息到达队列时。 这是缺省值。

EVERY

每次消息到达队列时，其优先级等于或大于队列的 TRIGMPRI 参数指定的优先级。

DEPTH

当优先级等于或大于 TRIGMPRI 指定的优先级的消息数等于 TRIGDPTH 参数指示的数目时。

NONE

不写入任何触发器消息。

NORMAL

此队列不是传输队列。

XMITQ

该队列是传输队列，用于保存以远程队列管理器为目标的消息。 当应用程序将消息放入远程队列时，该消息将存储在相应的传输队列上。 它停留在那里，等待传输到远程队列管理器。

如果指定此选项，请勿指定 CLUSTER 和 CLUSNL的值。

此外，在 z/OS 上，不要指定 INDXTYPE(MSGTOKEN) 或 INDXTYPE(GROUPID)。