IBM MQ 属性
IBM® MQ 属性适用于整个 IBM MQ 安装。
以下各表列出了您可以为 IBM MQ 设置的属性:
对于每个属性,都有一个简短描述来说明在什么情况下您可能需要配置此属性。IBM MQ 属性对话框中的属性与配置文件中的节相关。
“常规”页面
下表列出了您可在“IBM MQ 属性”对话框的常规页面上设置的属性。
属性 | 描述 | 节键 |
---|---|---|
缺省前缀 | 要更改存储所有队列管理器数据的目录位置,输入新目录的完整路径。 | DefaultPrefix |
缺省队列管理器名称 | 要指定新队列管理器的缺省名称,在此字段中输入此名称。 | 名称 |
“扩展”页面
下表列出了您可在“IBM MQ 属性”对话框的扩展页面上设置的属性。
属性 | 描述 | 节键 |
---|---|---|
转换 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 对象的名称(例如,队列名称)有效的字符。 | 名称 |
类型 | 指定出口类型:公共或模板。 | (不是单独的节键。) |
顺序 | 此属性是一个无符号数值,它定义了此 API 出口相对于其他 API 出口的调用顺序。先调用序号较低的 API 出口,然后调用序号较高的 API 出口。具有相同序号的不同 API 出口的调用顺序未进行定义。为队列管理器定义的 API 出口指定不连续的序号可以有效地避免这种情况。 | 顺序 |
模块 | 指定包含 API 出口代码的模块。如果此字段包含模块的完整路径名,那么将照原样使用它。如果此字段仅包含模块名称,那么会使用与查找通道出口相同的方法来找到模块;即,使用“队列管理器属性”对话框的出口页面上的出口缺省路径字段中的值。 | 模块 |
函数 | 指定模块的函数入口点的名称,该模块包含 API 出口的代码。此入口点是 MQ_INIT_EXIT 函数。此字段的长度受限于 MQ_EXIT_NAME_LENGTH。 | 函数 |
数据 | 如果指定了此属性,那么将除去开头和末尾的空格,剩余的字符串被截断为 32 个字符,并且将结果字符串传递到 MQAXP 结构的 ExitData 字段的出口。如果未指定此属性,那么会将 32 个空白字符的缺省值传递至 MQAXP 结构的 ExitData 字段中的出口。 | 数据 |
缺省日志设置
下表列出了您可在“IBM MQ 属性”对话框的缺省日志设置页面上设置的属性。要更改缺省日志设置,编辑缺省日志设置页面上的属性。缺省情况下,这些设置应用于所有新队列管理器。
属性 | 描述 | 节键 |
---|---|---|
日志类型 | 要使此队列管理器在重新启动时进行恢复,请单击循环。如果此队列管理器使用循环日志记录,那么当日志文件满时,将从此日志文件的开头重写此文件。要使队列管理器在重新启动时进行恢复并要启用介质恢复或正向恢复,请单击线性。如果队列管理器使用线性日志记录,那么当日志文件满时,将创建新的日志文件。 | LogType |
日志路径 | 要更改日志的缺省位置,在此处输入完整路径。如果您在此处未指定路径,那么缺省路径是 DefaultPrefix 中名为 Log 的子目录,其中 DefaultPrefix 是在“IBM MQ 属性”对话框的常规页面上的缺省前缀属性中指定的目录。 | LogPath |
日志文件页数 | 输入日志文件中的页数,范围是 32 - 4095,每页大小为 4KB。 例如,如果输入 256,那么文件大小是 1MB。 | LogFilePages |
日志主文件数 | 在 Windows 上,输入主日志文件数,范围是 2 至 254。缺省值是 3。主日志文件和辅助日志文件的总数不得超过 255 且不得小于 3。 在 UNIX 和 Linux 上,输入主日志文件数,范围是 2 至 510。缺省值是 3。主日志文件和辅助日志文件的总数不得超过 511 且不得小于 3。 |
LogPrimaryFiles |
日志辅助文件数 | 在 Windows 上,输入辅助日志文件数,范围是 1 至 253。缺省值是 3。主日志文件和辅助日志文件的总数不得超过 255 且不得小于 3。 在 UNIX 和 Linux 上,输入辅助日志文件数,范围是 1 至 509。缺省值是 3。主日志文件和辅助日志文件的总数不得超过 511 且不得小于 3。 |
LogSecondaryFiles |
日志缓存页数 | 输入用于写入的缓存页数,范围是 0 - 512,每页大小为 4KB。
如果指定 0,那么队列管理器自己选择页数。 如果输入 1 至 17 之间的一个数字,那么将使用最小值 18。如果输入 18 - 512 范围内的数字,那么将使用该数量的页面。如果更改此属性的值,请重新启动队列管理器以检测此更改。 |
LogBufferPages |
日志写完整性 | 记录器用于可靠写入日志记录的方法。 缺省值为 TripleWrite。请注意,您可以选择 DoubleWrite,但如果选择此项,那么系统会将此解释为 TripleWrite。 仅当托管 IBM MQ 恢复日志的文件系统或设备显式保证 4KB 写入的原子性时,才应使用 SingleWrite。 即,当写入某个 4KB 页面因任何原因而失败时,只存在两种可能的状态:映像前或映像后。不可能存在中间状态。 |
LogWriteIntegrity |
![]() |
![]() 如果更改 LogManagement 值,更改在重新启动队列管理器之后才会生效。 有三个选项。 手动,手动管理日志扩展数据块。指定该选项意味着队列管理器不会复用或删除日志扩展数据块,即使不再需要将这些日志扩展数据块用于恢复也是如此。 自动,由队列管理器自动管理日志扩展数据块。指定该选项意味着当不再需要将这些日志扩展数据块用于恢复后,队列管理器即可复用或删除日志扩展数据块。不允许归档。 归档,由队列管理器管理日志扩展数据块,但是在每个日志扩展数据块归档完成后必须通知队列管理器。 指定该选项意味着当通知队列管理器不再需要将某日志扩展数据块用于恢复并且该日志扩展数据块已归档后,队列管理器即可复用或删除日志扩展数据块。 缺省值为手动。 |
![]() |
ACPI 页面
下表列出了您可在“IBM MQ 属性”对话框的 ACPI 页面上设置的属性。ACPI(高级配置和Power®电源接口)是一项操作系统功能,它允许计算机检测某些活动状态并因此进入休眠状态,即,将自身切换到不运行任何程序并允许快速“唤醒”的低功耗模式。
当 ACPI 要将计算机置于休眠状态时,它首先向所有应用程序发出暂挂请求。要控制 IBM MQ 响应此请求的方式,请在 ACPI 页面上设置进行对话属性。
属性 | 描述 | 节键 |
---|---|---|
进行对话 | 缺省值为是,它表示 IBM MQ 显示一条消息,询问用户是否要暂挂正在运行的队列管理器。要暂挂 IBM MQ 而不显示此消息,请单击否。 | DoDialog |
拒绝暂挂 | 如果未设置进行对话属性,或者如果设置了但无法显示对话框(例如,如果笔记本电脑关闭了上盖),那么拒绝暂挂控制响应。缺省值为否,它表示即使无法显示此对话框,IBM MQ 仍会暂挂。要在无法显示此对话框的情况下阻止 IBM MQ 暂挂,请单击是。 此属性可由检查通道是否正在运行属性控制。 | DenySuspend |
检查通道是否正在运行 | 缺省值为否,它表示 IBM MQ 不检查是否存在任何正在运行的通道,并按照进行对话属性和拒绝暂挂属性的指示进行响应。要检查是否存在任何正在运行的通道,请单击是。如果不存在正在运行的通道,那么 IBM MQ 会忽略进行对话属性和拒绝暂挂属性。如果存在正在运行的通道,那么 IBM MQ 会按照进行对话属性和拒绝暂挂属性的指示进行响应。 | CheckChannelsRunning |
![[Windows]](./ngwin.gif)
“报警监视器”页面
报警监视器仅可用于 Windows。
下表列出了您可在“IBM MQ 属性”对话框的报警监视器页面上设置的属性。 报警监视器用于问题确定。当发生错误时,服务将会报警;例如,如果由于删除了需要的队列而不能启动通道启动程序服务时,就会报警。要配置报警监视器,编辑报警监视器页面上的属性。
属性 | 描述 | 节键 |
---|---|---|
报警监视器通知用户 | 缺省值为否,它表示 IBM MQ 在出现问题时不向用户发送警报。要将 IBM MQ 配置为在出现问题时发送警报,请单击是。 | Enable |
报警监视器用户 | 输入 IBM MQ 应向其发送警报的计算机名称或用户名。 | Recipient |
报警监视器图标添加至任务栏 | 缺省值为否,表示报警监视器图标不显示在 Windows 系统托盘中。要在 Windows 系统托盘中显示报警监视器图标,请单击是。 | TaskBar |
“配置信息”页面
下表列出了您可在“IBM MQ 属性”对话框的配置信息页面上显示的属性。 配置信息页面上的属性是只读的。
属性 | 描述 |
---|---|
安装类型 | 只读。此属性指示您在此计算机上安装的是 IBM MQ 的服务器版还是客户机版。 |
mqjbnd05 已装入 | 只读。这是需要用来连接至本地队列管理器的库。 |
MQ 版本 | 只读。这是安装在此计算机上的 IBM MQ 版本。 |
构建级别 | 只读。这是安装在此计算机上的 IBM MQ 产品的构建号。 |
构建类型 | 只读。这是安装在此计算机上的 IBM MQ 产品的构建类型。 |