环境变量

供客户使用的服务器和客户机环境变量的列表。

使用范例

在 UNIX 和 Linux® 系统上，使用: export [environment variable]=filename。
在 Windows 系统上，使用: Set [environment variable]=filename。
在 IBM® i 系统上使用: ADDENVVAR ENVVAR(environment variable) VALUE(xx)。

amq_bad_comms_data_fdcs: 此环境变量在设置为任何值时有效。; 如果 IBM MQ 通过 TCP/IP 从主机接收的数据格式不正确，例如，由于网络客户机已连接到 IBM MQ 侦听器端口并尝试与不受支持的应用程序协议进行通信，那么队列管理器会将 AMQ9207E 错误消息写入队列管理器错误日志。 IBM MQ 侦听器支持来自队列管理器消息通道代理程序 (MCA) 以及来自 MQI ， JMS 和 XMS 客户机应用程序的 TCP/IP 连接。
注: IBM MQ 侦听器不支持 AMQP 和 MQTT 客户机使用的应用程序协议，这些客户机应改为连接到适用的 AMQP 通道或 MQXR 遥测服务中配置的网络端口。; 可能还会写入包含 IBM MQ 已接收的无效数据的故障数据捕获 (FDC) 记录。然而，如果这是与远程端对话的开始，且格式是简单的已知格式，例如HTTP GET请求，则不会生成FFST文件。如果要覆盖此值以导致针对任何错误数据 (包括简单已知格式) 写入 FFST 文件，那么可以将 AMQ_BAD_COMMS_DATA_FDCS 环境变量设置为任何值 (例如， TRUE) 并重新启动队列管理器。
amq_no_bad_comms_data_fdcs: 此环境变量在设置为任何值时有效。; 如果 IBM MQ 在尝试将非IBM MQ 客户机连接到 IBM MQ TCP/IP 侦听器时无法识别初始数据传输，那么会导致队列管理器将 AMQ9207E 错误消息写入队列管理器错误日志。还会写入故障数据捕获 (FDC) 记录。您可以使用 AMQ_NO_BAD_COMMS_DATA_FDCS 环境变量来禁止生成这些诊断文件。当 AMQ_NO_BAD_COMMS_DATA_FDCS 设置为任何值 (例如， TRUE) 时，这将指示 IBM MQ 在初始通信流上报告 AMQ9207E 错误消息时不生成 FFST。要生效，应在启动队列管理器和侦听器进程之前设置环境变量。; 如果客户机将有效的 IBM MQ 协议流发送到队列管理器，然后发送无效数据，那么将继续生成 FDC ，因为这指示存在需要进一步调查的客户机问题。
AMQ_CONVAMQICNEWLINE: 从 V 8.0.0FP12开始，可以使用此环境变量来指定 IBM MQ 如何将 EBCDIC NL 字符转换为 ASCII 格式。环境变量采用与 mqs.ini的 ConvEBCDICNewline 属性相同的值，即 NL_TO_LF， TABLE或 ISO (请参阅所有队列管理器)。例如，在无法使用 mqs.ini 文件的情况下，可以使用 AMQ_CONVEBCDICNEWLINE 环境变量而不是 ConvEBCDICNewline 节属性在客户端上提供 ConvEBCDICNewline 功能。; 如果同时设置了节属性和环境变量，那么节属性优先。

amq_dmpmqcfg_qsgdisp_default

从 IBM MQ 8.0.0FP14开始，缺省情况下， dmpmqcfg 命令使用的队列管理器处置查询仅查询 QSGDISP (QMGR) 定义。您可以使用环境变量 AMQ_DMPMQCFG_QSGDISP_DEFAULT来查询其他定义，该变量可以设置为下列其中一个值:

实时: 仅包括使用 QSGDISP (QMGR) 或 QSGDISP (COPY) 定义的对象。
全部: 包含使用 QSGDISP (QMGR) 和 QSGDISP (COPY) 定义的对象。如果队列管理器是队列共享组的成员，那么还包括 QSGDISP (GROUP) 和 QSGDISP (SHARED)。
COPY: 仅包括使用 QSGDISP (COPY) 定义的对象
GROUP: 仅包括使用 QSGDISP (GROUP) 定义的对象; 目标队列管理器必须是队列共享组的成员。
QMGR: 仅包括使用 QSGDISP (QMGR) 定义的对象。如果使用此环境变量来匹配 dmpmqcfg的现有行为，那么这是缺省行为。
PRIVATE: 仅包括使用 QSGDISP (QMGR) 或 QSGDISP (COPY) 定义的对象。
SHARED: 仅包括使用 QSGDISP (SHARED) 定义的对象。

AMQ_LDAP_TRACE: 从 IBM MQ 8.0.0FP14开始，如果环境变量 AMQ_LDAP_TRACE 设置为非空值，那么可以在不停止或启动队列管理器的情况下打开和关闭 LDAP 客户机跟踪。有关更多信息，请参阅启用 LDAP 客户机库代码的动态跟踪。

amq_mqs_ini_location: 在 UNIX 和 Linux 系统上，可以通过在此变量中设置 mqs.ini 文件的位置来变更用于 mqs.ini 文件的位置。必须在系统级别设置此变量。

amq_reverse_commit_order: 此变量配置队列管理器，以便在完成相应的数据库更新后，在 XA 事务中落实 IBM MQ 队列管理器更改。; 请勿在未读取和了解以下主题中描述的方案的情况下设置 AMQ_REVERSE_COMMIT_ORDER: 隔离级别。
AMQ_NO_IPV6: 此环境变量在设置为任何值时有效。设置此环境变量时，将在尝试连接时禁止使用 IPv6 。

amq_ssl_allow_default_cert: 从 IBM MQ 8.0.0FP$tag8开始，如果未设置此变量，那么仅当证书包含 ibmwebspheremq<userid>的标签名称时，应用程序才能使用客户机密钥库中的个人证书连接到队列管理器。通过使用 AMQ_SSL_ALLOW_DEFAULT_CERT 环境变量，证书不需要标签名称 ibmwebspheremq<userid>。即，用于连接到队列管理器的证书可以是缺省证书，前提是密钥存储库中存在缺省证书，并且密钥存储库不包含前缀为 ibmwebspheremq<userid>的个人证书。有关更多信息，请参阅技术说明在 MQ 客户机的 SSL 证书标签中指定用户标识。; 值 1 允许使用缺省证书。; 从 IBM MQ 8.0开始，应用程序可以使用 mqclient.ini 文件中 SSL 节的 CertificateLabel 设置，而不是使用 AMQ_SSL_ALLOW_DEFAULT_CERT 环境变量。有关更多信息，请参阅数字证书标签，了解需求和客户机配置文件的 SSL 节。

amq_ssl_ldap_server_version: 从 IBM MQ 8.0.0FP$tag8开始，此变量可用于确保在 CRL 服务器要求使用特定版本的 LDAP 协议的情况下， IBM MQ 加密组件使用 LDAP v2 或 LDAP v3 。; 在用于启动队列管理器或通道的环境中，将该变量设置为相应的值。要请求使用 LDAP v2 ，请设置 AMQ_SSL_LDAP_SERVER_VERSION=2。要请求使用 LDAP v3 ，请设置 AMQ_SSL_LDAP_SERVER_VERSION=3。; 此变量不会影响 IBM MQ 队列管理器为用户认证或用户授权建立的 LDAP 连接。

GMQ_MQ_LIB: 当 IBM MQ MQI client 和 IBM MQ 服务器都安装在系统上时，缺省情况下， MQAX 应用程序会针对该服务器运行。要对客户机运行 MQAX ，必须在 GMQ_MQ_LIB 环境变量中指定客户机绑定库，例如，设置 GMQ_MQ_LIB=mqic.dll。仅对于客户机安装，不需要设置 GMQ_MQ_LIB 环境变量。如果未设置此变量，那么 IBM MQ 会尝试装入 amqzst.dll。如果此 DLL 不存在 (如仅在客户机安装中一样) ，那么 IBM MQ 会尝试装入 mqic.dll。

主: 此变量包含搜索 mqclient.ini 文件的目录的名称。此文件包含 IBM MQ MQI clients 在 IBM i， UNIX 和 Linux 系统上使用的配置信息。

HOMEDRIVE 和 HOMEPATH: 要同时使用这两个变量，必须设置。它们用于包含搜索 mqclient.ini 文件的目录的名称。此文件包含 IBM MQ MQI clients 在 Windows 系统上使用的配置信息。

LDAP 基本 DN: 运行 LDAP 样本程序所需的环境变量。它指定目录搜索的基本专有名称。

LDAP_HOST: 用于运行 LDAP 样本程序的可选变量。它指定运行 LDAP 服务器的主机的名称; 如果未指定，那么缺省为本地主机

LDAP 版本: 用于运行 LDAP 样本程序的可选变量。它指定要使用的 LDAP 协议的版本，可以是 2 或 3。现在，大多数 LDAP 服务器都支持版本 3 的协议; 它们都支持旧版本 2。此样本与协议的任一版本同样有效，如果未指定此样本，那么缺省为 V 2。

mqapi_trace_logfile: 样本 API 出口程序使用 MQAPI_TRACE_LOGFILE 环境变量中定义的前缀对用户指定的文件生成 MQI 跟踪。

MQCCSID: 指定要使用的编码字符集号并覆盖应用程序的本机 CCSID。

MQCERTLABL: 定义证书标签。

MQCERTVPOL

确定所使用的证书验证类型:

ANY: 使用底层安全套接字库支持的任何证书验证策略。此设置为缺省设置。
RFC5280: 仅使用符合 RFC 5280 标准的证书验证。

MQCHLLIB: 指定包含客户机通道定义表 (CCDT) 的文件的目录路径。该文件在服务器上创建，但可以复制到 IBM MQ MQI client 工作站。

MQCHLTAB: MQCHLTAB 指定包含客户机通道定义表 (ccdt) 的文件的名称。缺省文件名为 AMQCLCHL.TAB。

MQS_IPC_HOST: 共享 IBM MQ 文件和生成的 myHostName 值时，将使用环境变量 MQS_IPC_HOST 创建问题集 myHostName

MQCLNTCF: 使用此环境变量可修改 mqclient.ini 文件路径。

mq_channel_suppress_interval: 指定要禁止使用 MQ_CHANNEL_SUPPRESS_MSGS 定义的消息写入错误日志的时间间隔 (以秒计) ，以及在指定的时间间隔内禁止消息出现的次数。缺省值为 60,5 ，这意味着在该消息的前五次出现之后，将在 60 秒时间间隔内禁止给定消息的任何其他出现。有关更多信息，请参阅禁止来自错误日志的通道错误消息。; 环境变量 MQ_CHANNEL_SUPPRESS_INTERVAL 与 qm.ini 文件中的 SuppressInterval 相当。

mq_channel_suppress_msgs: 指定在 MQ_CHANNEL_SUPPRESS_INTERVAL 中定义的时间间隔内直到该时间间隔到期之前，仅允许在指定次数内将 IBM MQ 通道错误消息写入错误日志。有关更多信息，请参阅禁止来自错误日志的通道错误消息。; 环境变量 MQ_CHANNEL_SUPPRESS_MSGS 与 qm.ini 文件中的 SuppressMessage 相当，但其指定方式不同。

MQ_CONNECT_TYPE: 在 IBM MQ for IBM i， Windows， UNIX 和 Linux 系统上，将此环境变量与 MQCONNX 调用上使用的 MQCNO 结构的 "选项" 字段中指定的绑定类型结合使用。请参阅 MQCONNX 环境变量

mq_cross_queue_order_all: 将 MQ_CROSS_QUEUE_ORDER_ALL 环境变量设置为非零值时，将在工作单元中维护消息放入顺序。这意味着，如果将工作单元 (UoW) 中的消息放入多个队列 (例如， Q1，然后是 Q2) 中，那么在发出 MQCMIT 时，将以它们 PUT 的相同队列顺序传递消息并使这些消息可用。
在多队列管理器环境中，在启动每个队列管理器之前， MQ_CROSS_QUEUE_ORDER_ALL 必须存在并且在发送端和接收端都具有非空值。

MQ_FILE_PATH

在 Windows 平台上安装运行时包期间，将配置名为 MQ_FILE_PATH 的新环境变量。此环境变量包含与 Windows 注册表中的以下键相同的数据:

HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\Installation\<InstallationName>\FilePath

MQIPADDRV: MQIPADDRV 指定要用于通道连接的 IP 协议。它具有可能的字符串值 "MQIPADDR_IPv4" 或 "MQIPADDR_IPv6"。这些值与 ALTER QMGR IPADDRV 中的 IPv4 和 IPv6 具有相同的含义。如果未设置，那么将采用 "MQIPADDR_IPv4"。

MQ_JAVA_DATA_PATH: 指定日志和跟踪输出的目录。

MQ_JAVA_INSTALL_PATH: 指定 IBM MQ classes for Java 的安装目录，如 IBM MQ classes for Java 安装目录中所示。

MQ_JAVA_LIB_PATH: 指定存储 IBM MQ classes for Java 库的目录。 IBM MQ classes for Java随附的某些脚本 (例如 IVTRun) 使用此环境变量。

MQNAME: MQNAME 指定 IBM MQ 进程可以使用的本地 NetBIOS 名称。

MQNOREMPOOL: 设置此变量时，它将关闭通道池并使通道作为侦听器的线程运行。

mqpse_trace_logfile: 发布出口样本程序时使用。在要跟踪的应用程序进程中，此环境变量描述必须将跟踪文件写入的位置。请参阅 "发布出口" 样本程序

MQSERVER: MQSERVER 环境变量用于定义最小通道。不能使用 MQSERVER 来定义 SSL 通道或具有通道出口的通道。 MQSERVER 指定 IBM MQ 服务器的位置以及要使用的通信方法。

mq_set_nodelayack: 设置此变量时，它会关闭 TCP 延迟应答; 在 AIX®上设置此变量时，设置通过使用 TCP_NODELAYACK 选项调用操作系统的 setsockopt 调用来关闭 TCP 延迟应答。只有 AIX 支持此函数，因此 MQ_SET_NODELAYACK 环境变量仅对 AIX有影响。

MQSNOAUT: 警告: 建议不要使用此功能。; 当您将此变量设置为任何值时，它将禁用对象权限管理器 (OAM) 并阻止任何安全性检查。这可能适用于测试环境。这包括授权和连接认证功能。 TLS ，通道认证记录和安全出口不受影响。; MQSNOAUT 变量仅在创建队列管理器时生效。
警告: 要启用 OAM ，必须删除队列管理器，删除环境变量，然后在不指定 MQSNOAUT 的情况下重新创建队列管理器。

MQSPREFIX: 作为更改缺省前缀的替代方法，您可以使用环境变量 MQSPREFIX 来覆盖 crtmqm 命令的 DefaultPrefix 。

MQSSLCRYP: MQSSLCRYP 包含可用于配置系统上存在的加密硬件的参数字符串。允许的值与 ALTER QMGR 命令的 SSLCRYP 参数相同。

MQSSLFIPS: MQSSLFIPS 指定在 IBM MQ中执行密码术时是否仅使用经 FIPS 认证的算法。这些值与 ALTER QMGR 命令的 SSLFIPS 参数相同。

MQSSLKEYR: MQSSLKEYR 指定以系统格式保存属于用户的数字证书的密钥存储库的位置。主干格式表示它包含完整路径和不带扩展名的文件名。有关完整详细信息，请参阅 ALTER QMGR 命令的 SSLKEYR 参数。

MQSSLPROXY: MQSSLPROXY指定了 IBM Global Security Kit (GSKit) 用于OCSP检查的 HTTP的主机名和端口号。

MQSSLRESET: MQSSLRESET 表示在重新协商 SSL 密钥之前在 SSL 通道上发送和接收的未加密字节数。

MQS_TRACE_OPTIONS: 使用环境变量 MQS_TRACE_OPTIONS 来分别激活高详细信息功能和参数跟踪功能。

MQTCPTIMEOUT: 此变量指定 IBM MQ 等待 TCP 连接调用的时间长度。

MQSUITEB

此变量指定是否使用符合 Suite B 的密码术。在使用 Suite B 密码术的实例中，可以通过将 MQSUITEB 设置为下列其中一项来指定密码术的强度:

NONE
128_BIT, 192_BIT
128_BIT
192_BIT

ODQ_MSG: 如果使用不同于 RUNMQDLQ 的死信队列处理程序，那么样本的源可供您用作基础。该样本类似于产品中提供的死信处理程序，但跟踪和错误报告不同。使用 ODQ_MSG 环境变量来设置包含错误和参考消息的文件的名称。提供的文件是 amqsdlq.msg。

ODQ_TRACE: 如果使用不同于 RUNMQDLQ 的死信队列处理程序，那么样本的源可供您用作基础。该样本类似于产品中提供的死信处理程序，但跟踪和错误报告不同。将 ODQ_TRACE 环境变量设置为 YES 或 yes 以开启跟踪

OMQ_PATH: 如果 ActiveX 脚本的 IBM MQ 自动化类失败，那么您可以在此环境变量中找到 "首次故障症状" 报告。

OMQ_TRACE: MQAX 包含跟踪工具，用于帮助服务组织识别发生问题时发生的情况。它显示运行 MQAX 脚本时采用的路径。除非您迂到问题，否则请在设置跟踪的情况下运行，以避免不必要使用系统资源。 OMQ_TRACE 是设置为控制跟踪的三个环境变量之一。为 OMQ_TRACE 指定任何值将打开跟踪工具。即使将 OMQ_TRACE 设置为 OFF ，跟踪仍处于活动状态。请参阅使用跟踪

OMQ_TRACE_PATH: 为控制跟踪而设置的三个环境变量之一。请参阅使用跟踪

OMQ_TRACE_LEVEL: 为控制跟踪而设置的三个环境变量之一。请参阅使用跟踪

ONCONFIG

Informix® 服务器配置文件的名称。例如，在 UNIX 和 Linux 系统上，使用:

export ONCONFIG=onconfig.hostname_1

在 Windows 系统上，使用:

set ONCONFIG=onconfig.hostname_1

WCF_TRACE_ON: 有两种不同的跟踪方法可用于 WCF 定制通道，这两种跟踪方法独立或一起激活。每种方法都会生成各自的跟踪文件，所以当两种跟踪方法都激活时，会生成两个输出文件。可以使用四种组合来启用和禁用 2 种不同的跟踪方法。除了这些用于启用 WCF 跟踪的组合外，还可以使用 WCF_TRACE_ON 环境变量来启用 XMS .NET 跟踪。请参阅 WCF 跟踪配置和跟踪文件名

WMQSOAP_HOME: 在 IBM MQ中正确安装和配置 .NET SOAP over JMS 服务托管环境之后，请在执行其他配置步骤时使用。可从本地队列管理器进行访问。请参阅 WCF 客户机到 IBM MQ 样本托管的 .NET 服务和 WCF 客户机到由 IBM MQ 样本托管的 Axis Java 服务; 还在安装 IBM MQ Web Transport for SOAP 时使用。请参阅安装 IBM MQ Web Transport for SOAP