IBM MQ 属性

IBM® MQ 属性适用于整个 IBM MQ 安装。

下表列出了可以为 IBM MQ设置的属性:

对于每个属性,都有一个简短描述来说明在什么情况下您可能需要配置此属性。 IBM MQ 属性对话框中的属性与配置文件中的节相关。

“常规”页面

下表列出了可以在 IBM MQ“属性”对话框的常规页面上设置的属性。

属性 描述 节键
缺省前缀 要更改存储所有队列管理器数据的目录位置,请输入新目录的完整路径。 DefaultPrefix
缺省队列管理器名称 要指定新队列管理器的缺省名称,在此字段中输入此名称。 名称

“扩展”页面

下表列出了可以在 IBM MQ“属性”对话框的扩展页面上设置的属性。

属性 描述 节键
缺省临时前缀 要更改存储所有简短队列管理器数据的目录位置,请输入新目录的完整路径。 DefaultEphemeralPrefix
转换 EBCDIC 换行符 EBCDIC 代码页包含 ASCII 代码页不支持的换行符 (NL)(尽管 ASCII 的某些 ISO 变体包含等效的符号)。 如果消息从使用 EBCDIC 代码页的系统 (例如, z/OS® 系统) 发送到使用 ASCII 的系统,那么您可以控制如何将 EBCDIC 换行符转换为 ASCII 格式。 缺省值是 NL_TO_LF,它表示对于所有 EBCDIC 至 ASCII 的转换,都可将 EBCDIC NL 字符(X'15')转换为 ASCII 换行符 LF(X'0A')。 要按照您的操作系统上的转换表来转换 EBCDIC NL 字符,请单击 TABLE。 注意,TABLE 转换的结果可因平台和语言的不同而有所变化,甚至在同一平台上,如果您使用不同的编码字符集标识(CCSID),也可能产生不同结果。 要使用 TABLE 方法来转换 ISO CCSID 并且使用 NL_TO_LF 方法转换所有其他 CCSID,请单击 ISO ConvEBCDICNewline
集群工作负载方式 集群工作负载出口 CLWL 允许您指定要打开集群中哪一个集群队列以响应 MQI 调用(例如,MQOPEN 或 MQPUT)。 缺省值是 SAFE,它表示 CLWL 出口在独立进程中运行,与队列管理器的进程不同,因此,如果出现问题,也可保留队列管理器的完整性。 然而,作为独立进程运行 CLWL 出口会对性能产生不利影响。 要通过在队列管理器所运行的进程中运行 CLWL 出口来提高性能,请单击 FAST。 仅当您确定使用 CLWL 出口没有问题时才使用“FAST”方式,因为如果使用“FAST”方式存在问题,那么队列管理器失败,并且队列管理器的完整性也很难保证。 可使用集群工作负载方式属性覆盖各个队列管理器的值。 有关更多信息,请参阅 队列管理器属性 CLWLMode

“出口”页面

下表列出了可在 IBM MQ“属性”对话框的出口页面上设置的属性。 要配置可用于此计算机上所有队列管理器的公共出口,请编辑出口页面上的属性。

属性 描述 节键
出口缺省路径 要更改客户机的通道出口位置以及服务器的通道出口和数据转换出口位置,请输入新目录的路径。 ExitsDefaultPath
公共 API 出口 要为 IBM MQ配置新的公共 API 出口,请单击 添加 ,然后在 " 属性 " 对话框中输入出口的详细信息。 要编辑已显示在表中的公共 API 出口,请单击编辑;要从表中除去 API 出口,请单击除去 ApiExitCommon
模板 API 出口 要为 IBM MQ配置新的模板 API 出口,请单击 添加 ,然后在 "属性" 对话框中输入出口的详细信息。 要编辑已显示在表中的模板 API 出口,请单击编辑;要从表中除去 API 出口,请单击除去 ApiExitTemplate
名称 指定 API 出口的描述性名称,它传递至 MQAXP 结构的 ExitInfoName 字段中的 API 出口。 此名称必须唯一,长度限制为 48 个字符,并且必须仅包含对 IBM MQ 对象的名称有效的字符,例如队列名称。 名称
类型 指定出口的类型:commontemplate (不是单独的节键。)
顺序 此属性是一个无符号数值,它定义了此 API 出口相对于其他 API 出口的调用顺序。 先调用序号较低的 API 出口,然后调用序号较高的 API 出口。 具有相同序号的不同 API 出口的调用顺序未进行定义。 为队列管理器定义的 API 出口指定不连续的序号可以有效地避免这种情况。 顺序
模块 指定包含 API 出口代码的模块。 如果此字段包含模块的完整路径名,那么将照原样使用它。 如果此字段仅包含模块名称,那么该模块将使用与通道出口相同的方法进行定位;即,使用队列管理器属性对话框的出口页面上 Exit default path 字段中的值。 模块
函数 指定模块的函数入口点的名称,该模块包含 API 出口的代码。 此入口点是 MQ_INIT_EXIT 函数。 此字段的长度受限于 MQ_EXIT_NAME_LENGTH。 函数
数据 如果指定了此属性,那么将除去开头和末尾的空格,剩余的字符串被截断为 32 个字符,并且将结果字符串传递到 MQAXP 结构的 ExitData 字段的出口。 如果未指定此属性,那么会将 32 个空白字符的缺省值传递至 MQAXP 结构的 ExitData 字段中的出口。 数据

缺省记录设置

下表列出了可以在 IBM MQ“属性”对话框的缺省日志设置页面上设置的属性。 要更改缺省日志设置,请编辑缺省日志设置页面上的属性。 缺省情况下,这些设置应用于所有新队列管理器。

属性 描述 节键
日志类型 要使此队列管理器在重新启动时进行恢复,请单击循环。 如果此队列管理器使用循环日志记录,那么当日志文件满时,将从此日志文件的开头重写此文件。 要使队列管理器在重新启动时进行恢复并要启用介质恢复或正向恢复,请单击线性。 如果队列管理器使用线性日志记录,那么当日志文件满时,将创建新的日志文件。 LogType
记录路径 要更改日志的缺省位置,在此处输入完整路径。 如果未在此处指定路径,那么缺省值为 DefaultPrefix 中名为 Log 的子目录,其中,DefaultPrefix 是在 IBM MQ“属性”对话框的常规页面上的 Default prefix 属性中指定的目录。 LogPath
记录文件页数 输入日志文件中的页数,范围是 32 - 4095,每页大小为 4KB。 例如,如果输入256,文件大小为 1MB。 LogFilePages
记录主文件数

AIX® and Linux®上,输入主日志文件数 (从 2 到 510)。 缺省值为 3。 主日志文件和辅助日志文件的总数不得超过 511 个,且不得少于 3个。

Windows上,输入主日志文件数 (从 2 到 254)。 缺省值为 3。 主日志文件和辅助日志文件的总数不得超过 255 个,且不得少于 3个。

LogPrimaryFiles
记录辅助文件数

AIX and Linux上,输入辅助日志文件的编号 (从 1 到 509)。 缺省值为 3。 主日志文件和辅助日志文件的总数不得超过 511 个,且不得少于 3个。

Windows上,输入辅助日志文件数 (从 1 到 253)。 缺省值为 3。 主日志文件和辅助日志文件的总数不得超过 255 个,且不得少于 3个。

LogSecondaryFiles
日志缓冲区页 输入用于写入的缓存页数,范围是 0 - 512,每页大小为 4KB。 如果指定 0,那么队列管理器自己选择页数。

如果输入 1 至 17 之间的一个数字,那么将使用最小值 18。 如果输入 18 - 512 范围内的数字,那么将使用该数量的页面。 如果更改此属性的值,请重新启动队列管理器以检测此更改。

LogBufferPages
记录写完整性 记录器用于可靠写入日志记录的方法。

缺省值为 TripleWrite。 请注意,您可以选择 DoubleWrite,但如果选择此项,那么系统会将此解释为 TripleWrite

仅在托管 IBM MQ 恢复日志的文件系统或设备明确保证 4KB 写入原子性时,才应使用 SingleWrite

即,当写入某个 4KB 页面因任何原因而失败时,只存在两种可能的状态:映像前或映像后。 不可能存在中间状态。

LogWriteIntegrity
日志管理 用于管理日志的方法。 仅当 LogType 为 LINEAR 时,LogManagement 才适用。

如果您更改 LogManagement 值,那么在重新启动队列管理器之后,更改才会生效。

有三个选项。

手动,手动管理日志扩展数据块。 指定该选项意味着队列管理器不会复用或删除日志扩展数据块,即使不再需要将这些日志扩展数据块用于恢复也是如此。

自动,由队列管理器自动管理日志扩展数据块。 指定该选项意味着当不再需要将这些日志扩展数据块用于恢复后,队列管理器即可复用或删除日志扩展数据块。 不允许归档。

归档,由队列管理器管理日志扩展数据块,但是在每个日志扩展数据块归档完成后必须通知队列管理器。

指定该选项意味着当通知队列管理器不再需要将某日志扩展数据块用于恢复并且该日志扩展数据块已归档后,队列管理器即可复用或删除日志扩展数据块。

缺省值为手动

LogManagement

ACPI 页面

下表列出了可以在 IBM MQ“属性”对话框的 ACPI 页面上设置的属性。 ACPI (Advanced Configuration and Power ® Interface) 是一种操作系统功能,它允许计算机检测某些活动状态,从而冬眠,即在没有程序运行的情况下将自身切换到低功耗模式,并以允许快速 "唤醒" 的方式。

当 ACPI 要将计算机置于休眠状态时,它首先向所有应用程序发出暂挂请求。 要控制 IBM MQ 如何响应此请求,请在 ACPI 页面上设置 "执行" 对话框 属性。

属性 描述 节键
显示对话框 缺省值为 Yes,这意味着 IBM MQ 将显示一条消息,询问用户是否暂挂正在运行的队列管理器。 要暂挂 IBM MQ 而不显示此消息,请单击 DoDialog
拒绝暂挂 如果未设置 Do dialog 属性,或者如果已设置但无法显示对话框(例如,如果已合上笔记本电脑的盖子),那么 Deny suspend 控制响应。 缺省值为 No,这意味着 IBM MQ 将暂挂,即使无法显示对话框也是如此。 要防止 IBM MQ 在无法显示对话框时暂挂,请单击 。 此属性可被 Check channels running 属性否决。 DenySuspend
检查通道是否正在运行 缺省值为 No,表示 IBM MQ 不会检查是否有任何通道正在运行,并且将按照 Do dialogDeny suspend 属性的指示进行响应。 要检查是否存在任何正在运行的通道,请单击。 如果没有通道正在运行,那么 IBM MQ 将忽略 Do dialogDeny suspend 属性。 如果有通道正在运行,那么 IBM MQ 按照 Do dialogDeny suspend 属性的指示进行响应。 CheckChannelsRunning
[Windows]

“报警监视器”页面

报警监视器仅可用于 Windows

下表列出了可以在 IBM MQ“属性”对话框的警报监视器页面上设置的属性。 报警监视器用于问题确定。 当发生错误时,服务将会报警;例如,如果由于删除了需要的队列而不能启动通道启动程序服务时,就会报警。 要配置报警监视器,请编辑报警监视器页面上的属性。

属性 描述 节键
报警监视器通知用户 缺省值为 No,这意味着 IBM MQ 不会在发生问题时向用户发送警报。 要配置 IBM MQ 以在发生问题时发送警报,请单击 Enable
报警监视器用户 输入 IBM MQ 应该向其发送警报的计算机名称或用户名。 Recipient
报警监视器图标添加至任务栏 缺省值是,它表示报警监视器图标不显示在 Windows 系统任务栏。 要在 Windows 系统任务栏中显示报警监视器图标,请单击 TaskBar

“配置信息”页面

下表列出了在 IBM MQ“属性”对话框的配置信息页面上显示的属性。 配置信息页面上的属性是只读的。

属性 描述
安装类型 只读。 此属性指示您是在此计算机上安装了 IBM MQ 的服务器版本还是客户机版本。
mqjbnd05 已装入 只读。 这是需要用来连接至本地队列管理器的库。
MQ 版本 只读。 这是安装在此计算机上的 IBM MQ 版本。
构建级别 只读。 这是安装在此计算机上的 IBM MQ 产品的构建号。
构建类型 只读。 这是安装在此计算机上的 IBM MQ 产品的构建类型。