MQSeries Client 连接Server配置.doc

MQSeries Client 连接Server配置对服务器的要求:1.正确安装MQSeries Server，启动侦听器;2.建立服务器连接通道（即通道类型为SVRCONN的通道），以接受MQI的连接;如:DEF CHL(PBC.CHL.YH13) CHLTYPE(SVRCONN) MCAUSER(administrator) REPLACE3.异构平台的连接需指定MCA用户标识;对客户机要求：1.正确安装MQSeries Client;2.设置系统设置环境变量MQSERVERMQSERVER=channel_name/protocol_type/hostname(port)说明：channel_name: MQSeries Server的服务器连接通道protocol_type: Client与Server连接使用的网络协议，一般为TCPhostname: Server的主机名称或IP地址port: Server的侦听端口，默认1414示例：unix/linux 平台在/.bash_profile添加export MQSERVER= PBC.CHL.YH13/TCP/10.50.10.241(22222)win32平台在控制面板里设置环境变量3.在MQSeries Client的安装目录下有mqclient.ini，用来定义Client连接Server的详细配置参数。（具体配置见后面）4.linux平台客户端程序采用用于非线程应用程序的 libmqic.so 库或用于线程应用程序的 libmqic_r.so 库进行编译链接,其它平台参见手册。如：$gcc -o -lmqic如何使用 WebSphere MQ 6.0 资源管理器管理远程队列管理器WebSphere MQ 6.0 for Windows & Linux 使用 Eclipse 3.0 作为资源管理器平台。当用户希望使用Windows 或 Linux 上的 MQ 资源管理器管理位于远程的队列管理器时如何进行配置？与WebSphere MQ 5.3 for Windows 的版本类似，WebSphere MQ 6.0 的资源管理器远程管理也通过远程队列管理器的服务器连接通道实现远程管理。直接连接设置步骤：1、队列管理器需要定义一个用于连接队列管理器的服务器连接通道。与5.3版本不同的是，这个通道不一定是SYSTEM.ADMIN.SVRCONN。该通道的名字可以随意定义，在设置远程管理的时候在 WebSphere MQ 资源管理器中指定即可。需要注意的是，启动WebSphere MQ 资源管理器的机器上的当前用户可能没有访问队列管理器对象的权限，导致 MQ 资源管理器无法管理远程队列管理器。简单的方法是在定义服务器连接通道的时候设置该通道的 MCAUSER 属性为 mqm。DEFINE CHANNEL(SYSTEM.ADMIN.SVRCONN) CHLTYPE(SVRCONN) TRPTYPE(TCP) MCAUSER(mqm)2、队列管理器需要定义一个名为 SYSTEM.MQEXPLORER.REPLY.MODEL 的临时模型队列以和MQ 资源管理器通信：DEFINE QM(SYSTEM.MQEXPLORER.REPLY.MODEL) DEFTYPE(TEMPDYN)3、队列管理器需要启动命令服务器strmqcsv 4、队列管理器需要启动侦听：DEFINE LISTENER(TCP.LISTENER) TRPTYPE(TCP) PORT(1414)START LISTENER(TCP.LISTENER)完成以上步骤后，就可以在 MQ 资源管理器中按照下面步骤连接队列管理器：1、打开 WebSphere MQ 资源管理器；右键点击队列管理器导航器中的队列管理器文件夹，选择“显示/隐藏队列管理器”：2、在弹出的“显示/隐藏队列管理器”对话框中选择“添加”按钮：3、在“添加队列管理器”对话框中选择直接连接，并输入队列管理器名称，然后点击下一步：4、填入主机名或 IP 地址、队列管理器侦听端口、以及服务器连接通道，然后点击完成即可。间接接连接设置步骤WebSphere MQ 资源管理器不但可以通过直接连接管理远程队列管理器，还可以通过队列管理器间接管理一个队列管理器。其基本原理为：作为间接队列管理器的队列管理能将消息路由自动到目标队列管理器。其设置方法如下：仍然延续前面的例子，我们将实现MQ 资源管理器对与 ERP.QM1 在同一台机器的另外一个队列管理器 ERP.QM2 的远程管理。1、在队列管理器 ERP.QM2 上进行如下设置：/* 定义/启动侦听 */DEF LISTENER(TCP.LISTENER) TRPTYPE(TCP) PORT(1415)START LISTENTER(TCP.LISTENER)/* 定义与ERP.QM1 同名的传输队列 */DEF QL(ERP.QM1) USAGE(XMITQ) TRIGGER TRIGTYPE(FIRST) INITQ(SYSTEM.CHANNEL.INITQ) TRIGDATA(QM2.TO.QM1)/* 定义ERP.QM2 到 ERP.QM1 的发送通道*/DEF CHANNEL(QM2.TO.QM1) CHLTYPE(SDR) TRPTYPE(TCP) CONNAME(9.181.159.231) XMITQ(ERP.QM1)/* 定义ERP.QM1 到 ERP.QM2 的接收通道*/DEF CHANNEL(QM1.TO.QM2) CHLTYPE(RCVR) TRPTYPE(TCP)2、在队列管理器 ERP.QM1 上进行如下设置：/* 定义与目标队列管理器同名的传输队列 */DEF QL(ERP.QM2) USAGE(XMITQ) TRIGGER TRIGTYPE(FIRST) INITQ(SYSTEM.CHANNEL.INITQ) TRIGDATA(QM1.TO.QM2)/* 定义ERP.QM1 到 ERP.QM2 的发送通道*/DEF CHANNEL(QM1.TO.QM2) CHLTYPE(SDR) TRPTYPE(TCP) CONNAME(9.181.159.231(1415) XMITQ(ERP.QM2)/* 定义ERP.QM1 到 ERP.QM2 的接收通道*/DEF CHANNEL(QM2.TO.QM1) CHLTYPE(RCVR) TRPTYPE(TCP)3、启动队列管理器 ERP.QM2 的命令服务器：strmqcsv ERP.QM2配置远程管理：1、打开 WebSphere MQ 资源管理器；右键点击队列管理器导航器中的队列管理器文件夹，选择“显示/隐藏队列管理器”：2、在弹出的“显示/隐藏队列管理器”对话框中选择“添加”按钮：3、在“添加队列管理器”对话框中选择“使用中间队列管理器进行连接”，并输入队列管理器名称，然后点击下一步：4、在中间队列管理器下拉选项中选择 ERP.QM1 点击完成即可。参考资料: 以下信息来自IBM Websphere信息中心.使用 WebSphere MQ 环境变量本章描述了可与 WebSphere MQ 客户机应用程序配合使用的环境变量。 对于那些尚未设置的变量，WebSphere MQ 会使用缺省值。使用环境变量，您可以更新您的系统概要文件进行永久的更改，从命令行发出命令进行仅对此会话的更改，或者如果您想根据正在运行的应用程序，给一个或多个变量设置特定的值，您可以把命令添加到应用程序使用的命令脚本文件中。WebSphere MQ 环境变量如下： MQCCSID MQCHLLIB MQCHLTAB MQIPADDRV MQNAME MQSERVER MQSSLCRYP MQSSLFIPS MQSSLKEYR MQSSLRESET 除非另有说明，否则，命令在所有 WebSphere MQ 客户机平台上都可用。 注： 1. WebSphere MQ for z/OS 不支持任何 WebSphere MQ 环境变量。如果您使用这个平台作为您的服务器，请参阅客户机通道定义表以获取有关客户机通道定义表是如何在 z/OS 上生成的信息。仍然可以在您的客户机平台上使用 WebSphere MQ 环境变量。 对于每个环境变量，使用与您的平台相关的命令来显示当前设置或重新设置变量的值。例如：命令效果SET MQSERVER=从 Windows 环境中除去变量unset MQSERVER从 UNIX 系统环境中除去变量SET MQSERVER显示 Windows 上的当前设置echo $MQSERVER显示 UNIX 系统上的当前设置set显示会话的所有环境变量 MQCCSID它指定所要使用的编码字符集数并覆盖机器的已配置 CCSID。 MQCHLLIB这指定包含客户机通道定义表的文件的目录路径。 MQCHLTAB这指定包含客户机通道定义表的文件的名称。 MQIPADDRV它指定要将哪个 IP 协议用于通道连接。 MQNAME它指定 WebSphere MQ 进程可以使用的本地 NetBIOS 名称。 MQSERVER此环境变量用于定义小型通道。 MQSSLCRYP此变量带有一个参数字符串，该字符串允许您配置系统上存在的加密硬件。允许的值与 ALTER QMGR 命令的 SSLCRYP 参数的相同。 MQSSLFIPS如果密码术在 WebSphere MQ 中执行，那么此变量指定是否仅使用 FIPS 认证的算法。值与 ALTER QMGR 命令的 SSLFIPS 参数的值相同。 MQSSLKEYR此变量以主干格式指定保存用户数字证书的密钥库的位置。即，它包括完整路径和不带扩展名的文件名。要了解完整的详细信息，请参阅 ALTER QMGR 命令的 SSLKEYR 参数。 MQSSLRESET它表示在重新协商 SSL 密钥之前在 SSL 通道上发送和接收的未加密字节的数目。 客户机配置文件的 CHANNELS 节使用 CHANNELS 节以指定有关客户机通道的信息。CHANNELS 节中可包括下列属性： CCSID=number 将使用的编码字符集数量。 这等同于 MQCCSID 环境参数。ChannelDefinitionDirectory=path 指向包含客户机通道定义表的文件的目录路径。 在 Windows 上，缺省值为 WebSphere MQ 安装目录，通常为 C:Program FilesIBMWebSphere MQ；在 Unix 系统上，缺省值为 /var/mqm。这等同于 MQCHLLIB 环境参数。ChannelDefinitionFile=filename|AMQCLCHL.TAB 包含客户机通道定义表的文件的名称。 这等同于 MQCHLTAB 环境参数。DefRecon=NO|YES|QMGR|DISABLED DefRecon 属性提供管理选项，以启用自动重新连接的客户机程序，或禁用客户机程序（已经自动写入重新连接）的自动重新连接。如果程序使用诸如 MQPMO_LOGICAL_ORDER 的选项（与重新连接不兼容），那么您可能需要选择执行此操作。 DefRecon 选项的解释决于 MQCNO_RECONNECT_* 值是否仍在客户机程序中设置以及设置为何值。 如果客户机程序使用 MQCONN 进行连接，或使用 MQCONNX 设置 MQCNO_RECONNECT_AS_DEF 选项，那么 DefRecon 设置的重新连接值将会生效。如果程序中没有设置重新连接值，或 DefRecon 选项没有设置重新连接值，那么客户机程序不会自动重新连接。 NO 除非 MQCONNX 覆盖此选项，否则客户机不会自动重新连接。 YES 除非 MQCONNX 覆盖此选项，否则客户机将自动重新连接。 QMGR 除非 MQCONNX 覆盖此选项，否则客户机将自动重新连接，但仅至同一队列管理器。QMGR 选项与 MQCNO_RECONNECT_Q_MGR 的作用相同。 DISABLED 禁用重新连接，即使客户机程序使用 MQCONNX MQI 调用进行请求。 MQReconnectTimeout 重试客户机重新连接的超时值（以秒计）。缺省值为 1800 秒（30 分钟）。 XAReconnectTimeout 重试事务性客户机重新连接的超时值（以秒计）。缺省值为 5 秒。 ServerConnectionParms ServerConnectionParms 指定 WebSphere MQ 服务器的位置以及要使用的通信方法。此属性仅定义简单的通道；您不能将它用于定义 SSL 通道或具有通道出口的通道。它是格式为 ChannelName/TransportType/ConnectionName 的字符串。 ConnectionName 必须是标准网络名。因为正斜杠（）字符用于分隔通道名称、传输类型和连接名称，所以 ChannelName 不能包含此字符。当 ServerConnectionParms 用于定义客户机通道时，可使用的最大消息长度为 100 MB。因此，通道的有效最大消息大小为服务器上 SVRCONN 通道中指定的值。 这等同于 MQSERVER 环境参数。将 ConnectionName 指定为已声明 TransportType 的机器名称（以逗号分隔）列表。通常，只需要一个机器名称。您可以提供多个机器名称来配置具有相同属性的多个连接。将按照连接列表中指定的顺序来尝试连接，直至成功建立连接为止。如果没有连接成功，那么客户机会开始重试处理。连接列表是队列管理器组为可重新连接客户机配置连接的备选方案。客户机配置文件的 ClientExitPath 节使用 ClientExitPath 节来指定客户机上通道出口的缺省位置。ClientExitPath 节中可包括下列属性： ExitsDefaultPath=string 指定客户机的 32 位通道出口的位置。 ExitsDefaultPath64=string 指定客户机的 64 位通道出口的位置。 JavaExitsClassPath=string 当运行 Java 出口时将添加至类路径的值。这在任何其他语言中将被出口忽略。 在 JMS 配置文件中，将为 JavaExitsClassPath 名称提供标准的 com.ibm.mq.cfg. 前缀，并且在 Websphere MQ V7.0 系统属性上也使用此完整名称。在版本 6.0 中，使用系统属性 com.ibm.mq.exitClasspath 来指定此属性，该系统属性已记录在版本 6.0 自述文件中。现在不推荐使用 com.ibm.mq.exitClasspath。如果 JavaExitsClassPath 和 exitClasspath 均存在，那么将采用 JavaExitsClassPath。如果仅存在 exitClasspath 用法，那么在 Websphere MQ V7.0 中仍会采用它。客户机配置文件的 LU62、NETBIOS 和 SPX 节仅限于在 Windows 系统上，使用这些节来为已指定的网络协议指定配置参数。LU62使用 LU62 节来指定 SNA LU 6.2 协议配置参数。此节中可包括下列属性： Library1=DLLName|WCPIC32 APPC DLL 的名称。 Library2=DLLName|WCPIC32 与 Library1 相同，如果代码存储在两个独立的库中，那么将使用它。. TPName 要在远程站点上启动的 TP 名称。 NETBIOS使用 NETBIOS 节来指定 NetBIOS 协议配置参数。此节中可包括下列属性： AdapterNum=number|0 LAN 适配器的编号。 Library1=DLLName|NETAPI32 NetBIOS DLL 的名称。 LocalName=name LAN 上此计算机为人所知的名称。 这等同于 MQNAME 环境参数。NumCmds=number|1 要分配的命令的数量。 NumSess=number|1 要分配的会话的数量。 SPX使用 SPX 节来指定 SPX 协议配置参数。此节中可包括下列属性： BoardNum=number|0 LAN 适配器的编号。 KeepAlive=YES|NO 打开或关闭 KeepAlive 功能。 KeepAlive=YES 使 SPX 定期检查连接的另一端是否仍可用。如果不可用，那么将关闭该通道。Library1=DLLName|WSOCK32.DLL SPX DLL 的名称。 Library2=DLLName|WSOCK32.DLL 与 Library1 相同，如果代码存储在两个独立的库中，那么将使用它。 Socket=number|5E86 采用十六进制表示法的 SPX 套接字编号。 客户机配置文件的 MessageBuffer 节使用 MessageBuffer 节以指定有关消息缓冲区的信息。MessageBuffer 节中可包括下列属性： MaximumSize=integer|1 介于范围 1 - 999999 的预读缓冲区的大小（以千字节计）。 存在下列特殊值： -1 客户机确定适当的值。 0 对客户机禁用预读。 PurgeTime=integer|600 清除预读缓冲区中留下的消息之前的时间间隔（以秒计）。 当客户机应用程序根据 MsgId 或 CorrelId 选择消息时，预读缓冲区可能包含带有先前请求的 MsgId 或 CorrelId 且被发送至客户机的消息。然后，这些消息将滞留在预读缓冲区中，直到发出带有相应 MsgId 或 CorrelId 的 MQGET 为止。通过设置 PurgeTime，可以清除预读缓冲区中的消息。在预读缓冲区中保留的时间超过清除时间间隔的任何消息都会被自动清除。已从队列管理器上的队列中除去这些消息。因此，除非用户正在浏览它们，否则它们将丢失。有效范围是 1 - 999999 秒，或者是表示不进行清除的特殊值 0。UpdatePercentage=integer|-1 介于范围 1 - 100 的更新百分比值，用于计算阈值以确定客户机应用程序何时对服务器进行新的请求。特殊值 -1 指示客户机确定适当的值。 客户机定期将请求发送至服务器，从而指出客户机应用程序已使用的数据量。当客户机通过 MQGET 调用检索到的字节数 n 超过阈值 T 时，会发送请求。每次新请求被发送至服务器时，n 都复位为零。阈值 T 的计算如下：T = Upper - Lower上限与预读缓冲区大小相同，由 MaximumSize 属性指定，以千字节计。其缺省值是 100 Kb。下限小于上限，由 UpdatePercentage 属性指定。此属性为介于 1 与 100 之间的数字，缺省值是 20。下限的计算如下：Lower = Upper x UpdatePercentage / 100示例 1： MaximumSize 和 UpdatePercentage 属性的缺省值分别为 100 Kb 和 20。 客户机调用 MQGET 来检索消息并重复此操作。将一直持续此操作，直到 MQGET 已使用 n 个字节为止。 在使用上述计算方法的情况下，T 为 100 减 20，等于 80 Kb。 因此，当 MQGET 调用已从队列中除去 80 Kb 时，客户机会自动发出新请求。 示例 2： MaximumSize 属性的缺省值为 100 Kb，为 UpdatePercentage 选择的值则为 40。 客户机调用 MQGET 来检索消息并重复此操作。将一直持续此操作，直到 MQGET 已使用 n 个字节为止。 在使用上述计算方法的情况下，T 为 100 减 40，等于 60 Kb。 因此，当 MQGET 调用已从队列中除去 60 Kb 时，客户机会自动发出新请求。在使用缺省值的情况下，此示例所用时间比示例 1 更少。 因此，选择较大阈值 T 将有助于降低客户机向服务器发送请求的频率。相反，选择较小阈值 T 将有助于提高客户机向服务器发送请求的频率。但是，选择较大阈值 T 意味着，随着预读缓冲区为空的可能性增大，预读的性能增益减小。当此情况发生时，MQGET 调用可能必须暂停，以等待服务器发出的数据到达。客户机配置文件的 SSL 节使用 SSL 节以指定有关使用 SSL 的信息。SSL 节中可包括下列属性： OCSPAuthentication=OPTIONAL|REQUIRED|WARN 定义在启用 OCSP 且 OCSP 撤销检查无法确定证书撤销状态时 WebSphere MQ 的行为。有三个可能的值： OPTIONAL 接受 OCSP 检查无法确定其撤销状态的任何证书，并且不会生成警告或错误消息。 SSL 连接会继续，就好像未执行撤销检查一样。 REQUIRED OCSP 检查必须为已检查的每个 SSL 证书生成明确的撤销结果。无法验证其撤销状态的任何 SSL 证书将被拒绝，且显示错误消息。如果队列管理器 SSL 事件消息已启用，那么将生成具有 MQRQ_SSL_HANDSHAKE_ERROR 的 ReasonQualifier 的 MQRC_CHANNEL_SSL_ERROR 消息。该 SSL 连接已关闭。 这是缺省值。WARN 如果 OCSP 撤销检查无法确定任何 SSL 证书的撤销状态，那么队列管理器错误日志中将报告警告。如果队列管理器 SSL 事件消息已启用，那么将生成具有 MQRQ_SSL_UNKNOWN_REVOCATION 的 ReasonQualifier 的 MQRC_CHANNEL_SSL_WARNING 消息。该 SSL 连接被允许继续。 SSLCryptoHardware=string 设置配置系统上存在的加密硬件所需的参数字符串的名称。 指定下列格式的字符串：GSK_PKCS11=driver path and filename;token label;token password;symmetric cipher setting;驱动程序路径是为 PKCS #11 卡提供支持的共享库的绝对路径。驱动程序文件名是共享库的名称。例如，PKCS #11 驱动程序路径和文件名所需的值为 /usr/lib/pkcs11/PKCS11_API.so。要通过 GSKit 访问对称密码运算，请指定对称密码设置参数。此参数值为以下任何一个： SYMMETRIC_CIPHER_OFF 不访问对称