通道属性

您可以为所有类型的通道(包括客户机连接通道)设置属性。 某些属性特定于某些类型的通道。

以下各表列出了可以设置的所有属性:

某些属性并不适用于所有类型的通道:
  • 某些属性特定于集群通道。
  • [z/OS]某些属性特定于 z/OS® 通道。

对于每个属性,都有一个简短描述来说明在什么情况下您可能需要配置它。 这些表还给出了 DEFINE、ALTER 和 DISPLAY CHANNEL 命令的等效 MQSC 参数。 有关 MQSC 命令的更多信息,请参阅 IBM Documentation中的 使用 MQSC 命令管理 IBM® MQ

“常规”页面

下表列出了可以在 " 通道属性 " 对话框的 常规 页面上设置的属性。

属性 含义 MQSC 参数
通道名称 只读。 这是通道定义的名称。 通道
类型 只读。 这是通道定义的类型。 CHLTYPE
QSG 处置 只读。 这是通道定义的队列共享组处置。 在创建了通道定义之后,您就不能更改其处置。 Queue manager 表示对象定义仅可用于托管其的队列管理器;Group 表示对象定义存储在共享存储库中,并且队列共享组中的每个队列管理器都具有定义的副本;Copy 表示对象定义是共享存储库中定义的队列管理器副本。 QSGDISP
描述 输入通道用途的有意义的描述。 请参阅 属性对话框中的字符串 DESCR
队列管理器名称 输入定义通道的队列管理器的名称。 对于客户机连接通道,输入正在 MQI 客户机环境中运行的应用程序可请求连接的队列管理器名称。 QMNAME
传输协议 从列表中选择通道使用的传输类型。 TRPTYPE
连接名称 对于除集群接收方通道以外的所有类型的通道,输入主管目标队列管理器的计算机的名称。 连接名称的格式取决于所选的传输协议。 例如,如果正在使用 TCP/IP 协议并且您知道目标队列管理器使用 IBM MQ 缺省值 1414 之外的端口号进行连接,请输入 computer_name(port_number),其中,computer_name 是托管目标队列管理器的计算机的名称或 IP 地址,port_number 是目标队列管理器的侦听器正在使用的端口。

[AIX、Linux 和 Windows]对于 AIX®, Linux®, and Windows上使用 TCP/IP 传输协议的集群接收方通道,请勿指定此属性的值; IBM MQ 将生成一个名称以供使用 (假定缺省端口和系统的当前 IPv4 地址)。 如果系统没有 IPv4 地址,那么会使用系统当前的 IPv6 地址。 对于其他平台上的集群接收方通道以及不使用 TCP/IP 传输协议的集群接收方通道,输入主管本地队列管理器的计算机的名称。

CONNAME
传输队列 输入对应于通道接收方一端的队列管理器的传输队列的名称。 XMITQ
本地通信地址 如果通道使用 TCP/IP 并且对于出站通信,您要通道使用特定的 IP 地址、端口或端口范围,请输入用于此通道的本地通信地址。 通道在本地绑定至该地址。 使用以下格式ipaddress(low-port, high-port),其中 ipaddress 是以 IPv4 点分十进制, IPv6 十六进制或字母数字主机名格式指定的 IP 地址。 例如192.0.2.0指定具有任何端口的 IPv4 地址;192.0.2.0(1000)指定 IPv4 地址和特定端口;192.0.2.0(1000,2000)指定 IPv4 地址和端口范围;(1000)仅指定端口。

Cluster-sender channels: 如果在手动定义的集群发送方通道的 Local communication address 字段中输入值,那么在与完整存储库队列管理器建立通信时,将使用完整存储库的集群接收方通道中的值覆盖此值。 除了在手动定义的集群发送方通道中指定值外,还必须编写通道自动定义出口,以强制将 Local communication address 属性的值包含在任何自动定义的集群发送方通道中。

LOCLADDR
 

Cluster-receiver channels: 请勿将 IP 地址放在集群接收方通道的 Local communication address 字段中,除非所有队列管理器都在同一计算机上。 这是因为尝试使用其集群接收方通道的 Local communication address 字段中的 IP 地址连接到队列管理器的任何队列管理器都将这些值传播到其自动定义的集群发送方通道。 但是,如果您希望集群中的所有队列管理器将特定端口或端口范围用于其所有出站通信,那么可以将端口号或端口范围放在集群接收方通道的 Local communication address 字段中。

 
整个通道状态 只读。 这是通道的状态。 状态

“扩展”页面

下表列出了可以在 " 通道属性 " 对话框的 扩展 页面上设置的属性。

属性 含义 MQSC 参数
最大消息长度 输入可在通道上传输的消息最大长度:
  • 在以下平台上,该值必须大于或等于零,并且小于或等于队列管理器的最大消息长度:
    • [AIX]AIX
    • [IBM i]IBM i
    • [Windows]Windows
    • VSE/ESA
  • 在其他多平台上,该值必须大于或等于零,并且小于或等于 4,194,304 字节。
  • [z/OS]IBM MQ for z/OS上,该值必须大于或等于零,且小于或等于 104,857,600 字节。
MAXMSGL
脉动信号间隔 输入脉动信号间隔的长度,范围是 0 - 999999。 零值表示不发生脉动信号交换。 将该值设置为小于 Disconnect interval 属性的值。 使用的值是在发送方和接收方中指定的较大值。 脉动信号间隔是在传输队列上没有消息时从发送 MCA 传递来的脉动信号流之间的时间(以秒计)。 脉动信号交换为接收 MCA 提供了停顿通道的机会。 HBINT
最大实例数

此参数用于服务器连接通道和 AMQP 通道。 Maximum instances 指定单个服务器连接通道或 AMQP 通道的最大同步实例数。

此值可以是 0 - 999999999 范围内的数字。 缺省值是 999999999

0 值表示阻止所有客户机访问。

如果将 Maximum instances 设置为小于当前正在运行的服务器连接通道的实例数,那么将阻止新实例启动,直至足够的现有实例停止运行。

如果客户机在 AMQP 通道上使用已连接的标识进行连接(即,它执行客户机接管),那么无论已连接的客户机数是否达到 MAXINST,都会成功接管。

MAXINST
每个客户机的最大实例数

此参数用于服务器连接通道上。 Maximum instances per client指定可从单个客户机启动的个别服务器连接通道的最大同步实例数。 在此上下文中,起源于同一远程网络地址的连接被认为是来自同一客户机。

此值可以是 0 - 999999999 之间的数字。 缺省值是 999999999

0 值表示阻止所有客户机访问。

Maximum instancesMaximum instances per client 不同,因为 Maximum instances 是最大连接数,而 Maximum instances per client 是允许每个客户机连接到服务器的最大连接数。

MAXINSTC
保持活动时间间隔 输入保持活动时间间隔的长度,范围是 0 - 99999。 如果通道使用除 TCP 或 SPX 之外的传输类型,那么将忽略此属性。 在队列管理器属性的“通道”页面上,TCP Keep alive 属性必须设置为 Yes

[z/OS]z/OS 队列管理器上, Keep alive interval 属性指定各个通道的保持活动时间间隔。

[UNIX、Linux、Windows、IBM i] 在多平台上的队列管理器中,Keep alive interval 属性仅在通道连接到 z/OS 队列管理器时使用;要使用 Keep alive interval 属性提供的功能,请将 Keep alive interval 属性设置为 Auto 以使用基于协商的心跳间隔值。

KAINT
序号回绕 序号是通过通道发送的消息计数。 每当通过该通道发送消息时,会增加该序号。

[z/OS]对于使用 CICS®z/OS ,输入消息序号在 1 重新启动之前达到的 1-999999999 范围内的最高数字。

对于所有其他平台,输入消息序号从值 1 重新开始之前所能达到的最高编号,范围是 100 至 999999999。

该值必须足够大,以确保发出的编号不会与较早的消息正在使用的编号重复。 通道启动时,通道两端的序号复位值必须相同,否则会发生错误。

SEQWRAP
非持久消息速度

要指定在事务内不传送通道上的非持久消息,请选择快速。 这意味着非持久消息可用于检索的速度比它们作为事务一部分来检索的速度更快。 但是,由于非持久消息不是事务的一部分,所以它们在某些情况下可能会丢失,例如,在消息传输时,如果通道停止就会丢失。 要防止此类情况发生,请选择正常 NPMSPEED
批处理大小 输入在获取同步点之前要发送的最大消息数。 消息总是单独传送的,但会作为一个批次来落实或回退。 尝试缺省批处理大小50并仅在需要时更改值。 BATCHSZ
消息压缩 单击编辑以打开“编辑消息压缩”对话框。 按优先顺序选择通道定义支持的消息压缩技术。 使用通道另一端所支持的第一个技术。 表示不执行消息压缩。 RLE 表示使用运行长度编码来执行消息数据压缩。 ZLIBFAST 表示使用 zlib 压缩技术执行消息数据压缩,并且首选快速压缩时间。 ZLIBHIGH 表示使用 zlib 压缩技术执行消息数据压缩,并且首选高级别压缩。 [MQ 9.4.0 2024 年 6 月][UNIX、Linux、Windows、IBM i]LZ4FAST 表示使用 LZ4 压缩技术对信息数据进行压缩,并优先选择快速压缩时间。 LZ4HIGH表示使用 LZ4 压缩技术进行信息数据压缩,并且首选高水平的压缩。

ANY 表示可以使用队列管理器支持的任何压缩技术。

有关详细信息,请参阅 IBM Documentation 中的 分布式队列和集群

COMPMSG
头压缩 单击编辑以打开“编辑头压缩”对话框。 按优先顺序选择通道定义支持的头压缩技术。 使用通道另一端所支持的第一个技术。 表示不执行任何头压缩;系统表示执行头压缩。 有关详细信息,请参阅 IBM Documentation 中的 分布式队列和集群 COMPHDR
批处理时间间隔 输入 0 - 999999999 范围内的毫秒数,它表示通道保持批处理打开的时间(即使在传输队列上没有消息)。 BATCHINT
批处理数据限制 提供在获取同步点之前,通过通道发送的数据量的限制(千字节),范围是 0 - 999999。 值为 0 表示没有数据限制应用于此通道上的批处理。 BATCHLIM
断开连接时间间隔 输入批处理结束之后且通道关闭之前的秒数,范围是 0 - 999999。 零值表示通道不会断开连接。 DISCINT
数据转换 要指定接收应用程序将消息转换为接收系统上所需的格式(这是典型方法),请选择;如果远程队列管理器所在平台不支持数据转换,请选择以指定在传输之前将消息转换为接收系统所需的格式。 CONVERT
放入权限 此属性指定对目标队列或 MQI 调用运行 MQPUT 命令时,消息通道代理程序 (MCA) 执行的安全性处理类型。 要使用缺省用户标识,单击缺省值;要使用与此消息关联的上下文信息中的备用用户标识,单击上下文 PUTAUT
批处理脉动信号间隔

如果发送通道在批处理脉动信号间隔内已与接收通道进行过通信,那么假定接收通道仍处于活动状态,否则会将“脉动信号”发送至接收通道以进行检查。 发送通道会根据通道脉动信号间隔 (HBINT) 属性中指定的秒数,等待来自通道接收端的响应一段时间。

如果通道接收端不活动,那么此批次可被回退,而不是变为不确定。 通过回退此批次,消息仍可供处理,以便它们能够(例如)被重定向至另一个通道。 输入通道发送端等待通道接收端响应的秒数(范围是 0 - 999999),超过该时间会将通道接收端视为不活动。

零值表示没有使用批处理脉动信号。 有关更多信息,请参阅 配置通道以减少被 "怀疑 "的机会

BATCHHB
缺省通道处置 当您发出不带通道处置关键字(CHLDISP)的 START CHANNEL 命令时,将使用缺省通道处置(DEFCDISP)的值启动通道。 可能的值有以下三个:

专用。 这是缺省值。 启动为本地队列管理器上的专用通道。

共享。 如果启动了接收通道来响应定向至队列共享组的入站传输,那么此接收通道是共享通道。 如果发送通道的传输队列具有 SHARED 处置,那么此发送通道是共享通道。

固定共享。 如果发送通道的传输队列具有 SHARED 处置且 CONNAME 不是空白,那么此发送通道是共享通道。
DEFCDISP
属性控制

(仅适用于在发送方通道、服务器通道、集群发送方通道和集群接收方通道上)

如果消息包含具有以下前缀的属性:mcd.jms.usr.、 或 mqext., 那么在将消息发送到远程队列管理器前,会将所有可选消息属性(支持值为 MQPD_SUPPORT_OPTIONAL)放入消息数据的一个或多个 MQRFH2 头中,消息描述符(或扩展)中的属性除外。 否则,在将消息发送至远程队列管理器之前,将从消息中除去除消息描述符(或扩展)中的属性之外的所有消息属性。

如果消息包含的某个属性中,属性描述符的“支持”字段未设置为 MQPD_SUPPORT_OPTIONAL,那么该消息将被拒绝并按照其报告选项进行处理。 如果消息包含的一个或多个属性中,属性描述符的“支持”字段设置为 MQPD_SUPPORT_OPTIONAL,但属性描述符的其他字段设置为非缺省值,那么在将消息发送至远程队列管理器之前,将从消息中除去这些属性。

表示在将消息发送至远程队列管理器之前,将从消息中除去除消息描述符(或扩展)中的属性之外的所有消息属性。 如果消息包含的某个属性中,属性描述符的“支持”字段未设置为 MQPD_SUPPORT_OPTIONAL,那么该消息将被拒绝并按照其报告选项进行处理。

PROPCTL
共享对话

(仅在服务器连接通道和客户机连接通道上)

指定可基于特定 TCP/IP 客户机通道实例(套接字)共享的最大对话数。 可能的值为:
0:指定未共享任何基于 TCP/IP 套接字的对话。 通道实例在 IBM WebSphere® MQ 7.0之前的方式下运行,涉及到:
  • 管理员停止-停顿
  • 正在发出脉动信号
  • 提前读取

1:指定未共享任何基于 TCP/IP 套接字的对话。 客户机脉动信号和预读功能可用(无论是否进行 MQGET 调用),并且通道停顿更容易控制。

2 - 999999999:共享对话数。 缺省值为 10

如果客户机连接 SHARECNV 值与服务器连接 SHARECNV 值不匹配,那么使用最小值。
SHARECNV
暂挂复位序号

这是未完成请求的序号,它表示用户 RESET CHANNEL 命令请求未完成。 零值表示没有未完成的 RESET CHANNEL。 此值可以在 1 - 999999999 范围内。

当 RESETSEQ 的值是 0 时,DISPLAY CHANNEL 命令将返回 RESETSEQ(NO)。

RESETSEQ
使用死信队列

(不在客户机连接通道、服务器连接通道或遥测通道上)

指定当通道无法传递消息时,是否使用死信队列。 共有两个可能的值:
  • 表示通道无法传递的消息被视为故障,通道将根据 非持久消息速度的设置结束,或者废弃消息。
  • 表示如果队列管理器 死信队列 属性提供死信队列的名称,那么将使用该队列。 否则此行为与相同。
USEDLQ
端口

(仅在 AMQP 通道上)

指定 AMQP 连接的端口。 AMQP 1.0 连接的缺省端口是 5672。 如果您已使用端口 5672,那么可以指定其他端口。 PORT
使用客户机标识

(仅在 AMQP 通道上)

指定将客户机标识用于 AMQP 通道上的连接。 设置为 USECLTID
AMQP 保持活动的时间

(仅在 AMQP 通道上)

以毫秒为单位指定保持活动的时间。 如果 AMQPKA 属性为 自动,则会使用基于协商的心跳间隔值。

如果 AMQP 客户机未在保持活动时间间隔内发送任何帧,那么将使用amqp:resource-limit-exceededAMQP 错误情况。

AMQPKA
主题根目录

(仅在 AMQP 通道上)

为 AMQP 通道指定主题根。 使用此属性可确保 MQ Light 应用程序在部署到队列管理器时,不会向其他应用程序正在使用的主题树区域发布消息或从这些区域预订消息。

TPROOT 的缺省值为 SYSTEM.BASE.TOPIC。 如果使用此缺省值,那么 AMQP 客户机用于发布或预订的主题字符串将不具有前缀,并且此客户机可与其他 MQ 发布/预订应用程序交换消息。

TPROOT
临时模型队列

(仅在 AMQP 通道上)

指定创建临时队列时要使用的模型队列的名称(最大长度为 48 个字符)。

缺省值为 SYSTEM.DEFAULT.MODEL.QUEUE。

TMPMODEL
临时队列前缀

(仅在 AMQP 通道上)

派生临时队列名时添加到模型队列开头的临时队列名称前缀(最大长度为 32 个字符)。

缺省值为 AMQP。*

TMPQPRFX
[z/OS]安全策略保护 这将定义消息通道代理程序在应用 AMS 保护策略方面从传输队列获取消息或将消息放入目标队列时的行为。
这适用于发送方、服务器、接收方和请求方等类型的通道。 可能的值为:
传递
按原样传递此通道的消息通道代理发送或接收的任何消息。
该值适用于发送方、服务器、接收方或请求方等通道类型的通道,并且是缺省值。
移除
通过消息通道代理程序从传输队列中检索的消息中除去任何 AMS 保护,并将消息发送给伙伴。
当 MCA 从传输队列获取消息时,如果为传输队列定义了 AMS 策略,那么它适用于在通道中发送消息之前从消息中除去任何 AMS 保护。 如果没有为传输队列定义 AMS 策略,那么将按原样发送消息。
该值仅适用于发送方或服务器通道类型的通道。
作为策略
根据为目标队列定义的策略,在将入站消息放入目标队列之前对其应用 AMS 保护。
当消息通道代理程序接收入站消息时,如果为目标队列定义了 AMS 策略,那么在将消息放入目标队列之前,会对该消息应用 AMS 保护。 如果没有为目标队列定义 AMS 策略,那么会按原样将消息放入目标队列。
该值仅适用于接收方或请求方通道类型的通道。
SPLPROT

MCA 页面

下表列出了您可以在 " 通道属性 " 对话框的 MCA 页面上设置的属性。 要配置用于此通道的消息通道代理程序 (MCA) 的运行方式,请编辑 MCA 页面上的属性。

属性 含义 MQSC 参数
MCA 用户标识 消息通道代理程序用户标识。 如果非空白,那么它是消息通道代理程序用于授权访问 IBM MQ 资源的用户标识,包括 (如果 PUTAUT 为 DEF) 授权将消息放入接收方或请求者通道的目标队列。
如果为空,那么消息通道代理程序使用其缺省用户标识。 缺省用户标识源自启动接收通道的用户标识。 可能的值为:
  • [z/OS]z/OS上,由z/OS started-procedures 表分配给通道启动器启动任务的用户 ID。
  • [UNIX、Linux、Windows、IBM i] 对于多平台上的 TCP/IP,inetd.conf 条目中的用户 ID,或启动监听器的用户。
  • [UNIX、Linux、Windows、IBM i]对于多平台上的 SNA,SNA 服务器条目中的用户 ID,如果没有,则为传入附件请求中的用户 ID 或启动监听器的用户。
  • 对于 NetBIOS 或 SPX,启动侦听器的用户标识。
字符串的最大长度为:
  • [Windows]Windows上有 64 个字符。
  • Windows以外的平台上的 12 个字符。

[Windows]Windows中,您可以选择用域名限定用户标识符,格式为user@domain

MCAUSER
MCA 类型 要指定消息通道代理程序(MCA)作为线程运行,请选择线程;要指定 MCA 作为进程运行,请选择进程 MCATYPE
MCA 名称 只读。 您不能编辑此属性,因为 MCA 名称是保留的并且必须只能设置为空白。 MCANAME

“出口”页面

下表列出了可以在 " 通道属性 " 对话框的 出口 页面上设置的属性。 要配置通道以运行用户出口,请编辑出口页面上的属性。

属性 含义 MQSC 参数
发送出口名 单击编辑以打开“编辑发送出口名称”对话框。 添加您的发送出口程序名称:
  • [AIX][Linux]AIX and Linux 上,输入一个或多个退出程序的名称。 所有名称加起来的最大总长度为 999 个字符。 使用以下格式libraryname(functionname),其中名称中的最大字符数为 128。
  • [Windows]Windows 上,输入一个或多个退出程序的名称。 所有名称加起来的最大总长度为 999 个字符。 使用以下格式dllname(functionname),其中名称中的最大字符数为 128。
  • [IBM i]IBM i 上,最多输入 10 个退出程序的名称。 使用以下格式programname libname,其中 programname 占用前 10 个字符, libname 占用后 10 个字符。 在较短名称的末尾添加空格,将该名称补足为 10 个字符。
  • [z/OS]z/OS 上,最多输入 8 个退出程序的名称。 使用装入模块名称,其中,名称中的最大字符数是 8。
  • 在其他平台上,仅可以对每个通道指定一个发送出口程序的名称。
SENDEXIT
发送出口用户数据 输入调用发送出口程序时传递至通道发送出口的数据(最多 32 个字符):
  • [AIX、Linux 和 Windows]AIX, Linux, and Windows 上,键入一个或多个退出程序的数据。 使用逗号分隔数据。 最大字段总长度为 999 个字符。
  • [IBM i]IBM i 上,最多键入 10 个数据字符串,每个字符串的长度为 32 个字符。 将数据的第一个字符串传递至第一个发送出口,将第二个字符串传递至第二个出口,以此类推。
  • [z/OS]z/OS 上,最多键入 8 个数据字符串,每个字符串的长度为 32 个字符。 将数据的第一个字符串传递至第一个发送出口,将第二个字符串传递至第二个出口,以此类推。
  • 在其他平台上,仅可以为每个通道指定一个发送出口数据字符串。
SENDDATA
接收出口名 单击编辑以打开“编辑接收出口名称”对话框。 添加您的接收出口程序名称:
  • [AIX][Linux]AIX and Linux 上,输入一个或多个退出程序的名称。 所有名称加起来的最大字符总长度为 999 个字符。 使用以下格式libraryname(functionname),其中字符串中的最大字符数为 128。
  • [Windows]Windows 上,输入一个或多个退出程序的名称。 使用逗号分隔名称。 最大字段总长度为 999 个字符。 使用以下格式dllname(functionname),其中字符串中的最大字符数为 128。
  • [Windows]Windows 上,最多键入 10 个退出程序的名称。 使用逗号分隔名称。 使用以下格式programname libname,其中 programname 占用前 10 个字符, libname 占用后 10 个字符。 在较短名称的末尾添加空格,将该名称补足为 10 个字符。
  • [z/OS]z/OS 上,最多键入 8 个退出程序的名称。 使用逗号分隔名称。 使用装入模块名称,最大字符数是 8。
  • 在其他平台上,仅可以对每个通道指定一个发送出口程序的名称。
RCVEXIT
接收出口用户数据 输入调用接收出口程序时传递至通道接收出口的数据(最多 32 个字符):
  • [AIX、Linux 和 Windows]AIX, Linux, and Windows 上,键入一个或多个退出程序的数据。 使用逗号分隔数据。 最大字段总长度为 999 个字符。
  • [IBM i]IBM i 上,最多键入 10 个数据字符串,每个字符串的长度为 32 个字符。 将数据的第一个字符串传递至第一个接收出口,将第二个字符串传递至第二个出口,以此类推。
  • [z/OS]z/OS 上,最多键入 8 个数据字符串,每个字符串的长度为 32 个字符。 将数据的第一个字符串传递至第一个接收出口,将第二个字符串传递至第二个出口,以此类推。
  • 在其他平台上,仅可以为每个通道指定一个接收出口数据字符串。
RCVDATA
安全出口名 输入安全性出口程序的名称:
  • [AIX、Linux 和 Windows]AIX, Linux, and Windows上,使用以下格式libraryname(functionname),其中字符串中的最大字符数为 128。
  • [IBM i]IBM i上,使用以下格式programname libname,其中 programname 占用前 10 个字符, libname 占用后 10 个字符。 在较短名称的末尾添加空格,将该名称补足为 10 个字符。
  • [z/OS]z/OS 上,使用加载模块名称,其中最大字符数为 8。
SCYEXIT
安全出口用户数据 输入调用通道安全性出口时传递至通道安全性出口的数据(最多 32 个字符): SCYDATA
消息出口名 单击编辑以打开“编辑消息出口名称”对话框。 添加您的消息出口程序名称:
  • [AIX][Linux]AIX and Linux 上,输入一个或多个退出程序的名称。 所有名称加起来的最大总长度为 999 个字符。 使用以下格式libraryname(functionname),其中名称中的最大字符数为 128。
  • [Windows]Windows 上,输入一个或多个退出程序的名称。 所有名称加起来的最大总长度为 999 个字符。 使用以下格式dllname(functionname),其中名称中的最大字符数为 128。
  • [IBM i]IBM i 上,最多输入 10 个退出程序的名称。 使用以下格式programname libname,其中 programname 占用前 10 个字符, libname 占用后 10 个字符。 在较短名称的末尾添加空格,将该名称补足为 10 个字符。
  • [z/OS]z/OS 上,最多输入 8 个退出程序的名称。 使用装入模块名称,其中,名称中的最大字符数是 8。
  • 在其他平台上,仅可以对每个通道指定一个消息出口程序的名称。
MSGEXIT
消息出口用户数据 输入调用通道消息出口程序时传递至通道消息出口的数据(最多 32 个字符):
  • [AIX、Linux 和 Windows]AIX, Linux, and Windows 上,键入一个或多个退出程序的数据。 使用逗号分隔数据。 最大字段总长度为 999 个字符。
  • [IBM i]IBM i 上,最多键入 10 个数据字符串,每个字符串的长度为 32 个字符。 将数据的第一个字符串传递至第一个通道消息出口,将第二个字符串传递至第二个出口,以此类推。
  • [z/OS]z/OS 上,最多键入 8 个数据字符串,每个字符串的长度为 32 个字符。 将数据的第一个字符串传递至第一个通道消息出口,将第二个字符串传递至第二个出口,以此类推。
  • 在其他平台上,仅可以为每个通道指定一个通道消息出口数据字符串。
MSGDATA

LU6.2 页面

下表列出了可以在 " 通道属性 " 对话框的 LU6.2 页面上设置的属性。 如果此通道使用 LU6.2 传输协议,请编辑 LU6.2 页面上的属性。

属性 含义 MQSC 参数
方式名 输入 LU 6.2 方式名,这是 SNA 方式名,除非常规页面上的 Connection name 属性的值包含侧面对象,在此情况下保留 Mode name 值为空。 最大长度是 8 个字符。 MODENAME
TP 名称 输入在链路远端运行的 MCA 程序的名称或通用名称。 TPNAME
用户标识 输入用户标识,此用户标识是试图用远程 MCA 启动安全 LU6.2 会话时 MCA 所使用的用户标识。 最大长度是 12 个字符,但仅使用前 10 个字符。 USERID
密码 单击更改通道密码,然后在“更改密码”对话框中输入密码,此密码是试图用远程 MCA 启动安全 LU6.2 会话时 MCA 所使用的密码。 最大长度为 12 个字符。 密码

“重试”页面

下表列出了您可以在 " 通道属性 " 对话框的 重试 页面上设置的属性。 要配置通道在不能连接至远程队列管理器时的通道行为方式,请编辑重试页面上的属性。

属性 含义 MQSC 参数
短重试次数 键入通道尝试连接远程队列管理器的最大次数,0 - 999999999(或者,对于使用 CICSz/OS,1 - 99999999999) SHORTRTY
短重试时间间隔 输入短重试次数期间通道再次尝试连接远程队列管理器之前必须等待的大约时间间隔(以秒计)。 零值表示立即重试此通道。 SHORTTMR
长重试次数 输入通道可尝试连接至远程队列管理器的最大次数,范围是 0 - 999999999。 仅在 Short retry count 属性中指定的计数已耗尽并且通道仍未成功连接到远程队列管理器时,才使用此属性的值。 LONGRTY
长重试时间间隔 输入长重试次数期间通道再次尝试连接远程队列管理器之前必须等待的大约时间间隔(以秒计)。 零值表示立即重试此通道。 LONGTMR
保持活动时间间隔 Keep alive interval 属性的值指定通道的超时值。 要将“保持活动”值基于协商的脉动信号间隔值,选择自动。 如果协商的脉动信号间隔值大于零,那么 Keep alive interval 是协商的脉动信号间隔加上 60 秒;如果协商的脉动信号间隔为零,那么 Keep alive interval 也为零。 要指定超时值,请输入 0 - 99999 范围内的秒数。 要在此通道上禁用“保持活动”,请输入 0。 KAINT

“消息重试”页面

下表列出了您可以在 " 通道属性 " 对话框的 消息重试 页面上设置的属性。 要配置通道在第一次尝试将消息放置到远程队列失败时的通道行为方式,请编辑消息重试页面上的属性。

属性 含义 MQSC 参数
消息重试次数 输入通道重试传递消息的最大次数(范围是 0 - 999999999),超过该次数之后,通道确定无法将消息传递至远程队列。 仅在 Message retry exit name 属性为空时,此属性此控制 MCA 的操作。 如果 Message retry exit name 属性不为空,那么会将 Message retry count 属性的值传递到出口以供出口使用,但是通道重试交付消息的次数由出口控制,而非 Message retry count 属性。 MRRTY
消息重试时间间隔 输入通道可再次尝试将消息放置到远程队列之前必须等待的最小时间长度(以毫秒计)。 MRTMR
消息重试出口名 输入通道消息重试出口程序的名称:
  • [AIX][Linux]AIX and Linux 上,请使用以下格式libraryname(functionname),其中字符串中的最大字符数为 128。
  • [Windows]Windows上,使用以下格式dllname(functionname),其中字符串中的最大字符数为 128。
  • [IBM i]IBM i上,使用以下格式programname libname,其中 programname 占用前 10 个字符,而 libname 占用 后 10 个字符。 在较短名称的末尾添加空格,将该名称补足为 10 个字符。
  • [z/OS]z/OS 上,使用加载模块名称,其中最大字符数为 8。
MRDATA
消息重试出口用户数据 输入调用通道消息重试出口时传递至通道消息重试出口的数据(最多 32 个字符): MREXIT

“集群”页面

下表列出了可以在 " 通道属性 " 对话框的 集群 页面上设置的属性。 要在一个或多个集群中共享通道,请编辑集群页面上的属性。
注: 在目标队列管理器上的集群接收方通道上指定集群通道属性。 在匹配的集群发送方通道上指定的任何属性都可能被忽略。 请参见 集群通道 中的 IBM Documentation
属性 含义 MQSC 参数
未在集群中共享 缺省情况下已选择此选项,以便不在任何集群中共享通道。 不适用。
在集群中共享 要在集群中共享通道,请选择此选项,然后输入集群的名称。 请参阅 属性对话框中的字符串 集群
在集群列表中共享 要在多个集群中共享通道,请选择此选项,然后输入包含集群名称的名称列表对象的名称。 请参阅 属性对话框中的字符串 CLUSNL
网络优先级 此属性的值表示网络连接的通道优先级。 输入 0 - 9 范围内的值;0 是最低优先级。 请参见 NETPRTY 通道属性 中的 IBM Documentation NETPRTY
CLWL 通道等级 输入通道在集群中的排名,范围是 0 - 9;0 是最低排名。 请参见 CLWLRANK 通道属性 中的 IBM Documentation CLWLRANK
CLWL 通道优先级 输入通道在集群中的优先级,范围是 0 - 9;0 是最低优先级。 请参见 CLWLPRTY 通道属性 中的 IBM Documentation CLWLPRTY
CLWL 通道权重 输入应用于通道的权重,以便控制通过通道发送的消息的比例。 此值必须在 1 - 99 之间;1 是最低权重。 请参见 CLWLWGHT 通道属性 中的 IBM Documentation CLWLWGHT

SSL 页面

下表列出了您可以在 " 通道属性 " 对话框的 SSL 页面上设置的属性。 要配置通道以使用 SSL 安全性,请编辑 SSL 页面上的属性。

属性 含义 MQSC 参数
CertificateLabel 该通道要使用的证书标签。 该标签用于标识将要发送至远程对等项的密钥存储库中的个人证书。 如果此属性为空白,那么会由队列管理器 CertificateLabel 属性决定证书。 CERTLABL
CipherSpec 输入用于 TLS 连接的 CipherSpec 的名称(最多 32 个字符)。 IBM MQ SSL 通道定义的两端在 CipherSpec 属性中必须具有相同的值。 有关详细信息,请参阅 IBM Documentation定义通道 的 SSLCIPH 属性。

此参数的值还用于设置 "安全协议" 属性的值,该属性是 " 通道状态属性 " 页面上的输出字段。

SSLCIPH
对启动连接方的认证 要指定通道必须从 TLS 客户机接收和认证 TLS 证书,选择必需;要指定通道不需要从 TLS 客户机接收和认证 TLS 证书,选择可选;如果选择可选并且对等 TLS 客户机发送了证书,那么通道会将此证书认证为正常。 SSLCAUTH
对等颁发者名称 证书颁发者专有名称过滤器。 此字段包含一个专有名称过滤器,与远程对等个人证书的颁发者 DN 匹配。 “对等颁发者名称”是 SSL 对等映射中的关键字段,用于匹配入站通道连接的通道权限记录。 SSLCERTI
仅接受专有名称与这些值匹配的证书 输入来自 IBM MQ 通道另一端的对等队列管理器或客户机的证书上专有名称的值。 启动通道时,此属性的值会与此证书上的“专有名称”进行比较。 SSLPEER
仅接受专有名称与这些值匹配的证书 此通道认证记录将 TLS 专有名称 (DN) 映射至 MCAUSER 值。 SSLPEERMAP 参数必须随附 SSLPEER。 SSLPEERMAP

“负载均衡”页面

下表列出了您可以在 " 通道属性 " 对话框的 负载均衡 页面上设置的属性。

属性 含义 MQSC 参数
权重 客户机通道权重属性用来指定权重,以影响将使用哪个客户机连接通道定义。 使用客户机通道权重属性的目的在于当存在多个合适的客户机通道定义时,可以根据其权重随机地选择这些定义。

当客户机通过指定以星号开头的队列管理器名称发出 MQCONN 命令以请求连接至队列管理器组,并且客户机通道定义表(CCDT)中存在多个合适的通道定义时,将根据权重随机地选择要使用的定义,但首先按字母顺序选择任何适用的 CLNTWGHT(0) 定义。 请指定 0 至 99 范围内的值。 缺省值是 0。 零值指示不执行负载均衡并且按字母顺序选择适用的定义。 要启用负载均衡,请指定一个在范围 1 至 99 之间的值,其中 1 是最小的权重,99 是最大的权重。 两个或更多通道之间具有非零权重的消息的分布近似于与这些权重的比率成正比。

CLNTWGHT
亲缘关系 使用通道亲缘关系属性时,多次使用相同队列管理器名称进行连接的客户机应用程序可以选择是否对每次连接都使用相同的客户机通道定义。 当存在多个适用的通道定义时,请使用此属性。 可能的值为:

首选。 这是缺省值。 进程中读取客户机通道定义表的第一个连接根据客户机通道权重创建一个适用的定义列表,权重为 0 的任何定义按字母顺序排在前面。 进程中的每个连接尝试使用该列表中的第一个定义进行连接。 如果连接不成功,那么将使用下一个定义。 客户机通道权重值不为 0 的不成功定义将移至列表末尾。 客户机通道权重为 0 的定义仍位于列表的前面,每次连接时将首先选择这些定义。 具有相同主机名的每个客户机进程会创建相同的列表。

NONE。 进程中读取 CCID 的第一个连接创建适用的定义列表。 进程中的所有连接根据客户机通道权重选择适用的定义,首先按字母顺序选择权重为 0 的任何定义。

AFFINITY

“统计信息”页面

下表列出了可以在 " 通道属性 " 对话框的 统计信息 页面上设置的属性。 要配置通道以收集监视数据或统计数据,请编辑统计信息页面上的属性。

属性 含义 MQSC 参数
变更日期 只读。 这是最近一次变更队列属性的日期。 ALTDATE
变更时间 只读。 这是最近一次变更队列属性的时间。 ALTTIME
通道监视 您可以配置 IBM MQ 以收集有关通道当前性能的联机监视数据。 要继承队列管理器 Channel monitoring 属性的值(请参阅 Queue manager 属性),请单击 Queue manager。 如果队列管理器的 Channel monitoring 属性为 None,那么将忽略队列的 Channel monitoring 属性。 如果队列管理器的 Channel monitoring 属性不是 None:要覆盖队列管理器设置并阻止收集此通道的数据,请单击关闭;要以低速率收集数据,请单击;要以中速率收集数据,请单击;要以高速率收集数据,请单击 MONCHL
通道统计 您可以配置 IBM MQ 以收集有关通道活动的统计数据。 要继承队列管理器的 Channel statistics 属性的值(请参阅队列管理器属性),请单击队列管理器。 如果队列管理器的 Channel statistics 属性为 None,那么将忽略队列的 Channel statistics 属性。 如果队列管理器的 Channel statistics 属性不是 None,要覆盖队列管理器设置并阻止收集此通道的数据,请单击关闭;要以低速率收集数据,请单击;要以中速率收集数据,请单击;要以高速率收集数据,请单击 STATCHL