IBM MQ classes for JMS 的发布/预订 IVT

要在绑定方式下运行测试，请输入以下命令：

PSIVTRun -nojndi [-m qmgr ] [-bqm brokerQmgr ] [-v providerVersion ] [-t]

要以客户机方式运行测试，请首先设置队列管理器，如 配置队列管理器以接受 Multiplatforms 版上的客户机连接 中所述，同时注意要使用的通道缺省为 SYSTEM.DEF.SVRCONN，然后输入以下命令:

PSIVTRun -nojndi -client -m qmgr -host hostname [-port port ] [-channel channel ]
[-bqm brokerQmgr ] [-v providerVersion ] [-ccsid ccsid ] [-t]

这些命令上的参数具有以下含义：

--m qmgr

IVT 程序连接到的队列管理器的名称。 如果在绑定方式下运行测试且省略此参数，那么 IVT 程序将连接到缺省队列管理器。

-host 主机名

运行队列管理器的系统的主机名或 IP 地址。

-port 端口

队列管理器的侦听器正在侦听的端口的编号。 缺省值为1414.

-channel 通道

IVT 程序用于连接到队列管理器的 MQI 通道的名称。 缺省值为SYSTEM.DEF.SVRCONN.

-bqm brokerQmgr

运行代理程序的队列管理器的名称。 缺省值为 IVT 程序连接到的队列管理器的名称。

此参数与队列管理器版本号 v 7（或更高）无关。

-v providerVersion

IVT 程序预期连接到的队列管理器的发行版级别。

此参数用于设置 MQTopicConnectionFactory 对象的 PROVIDERVERSION 属性，并具有与 PROVIDERVERSION 属性值相同的有效值。 因此，有关此参数的更多信息 (包括其有效值) ，请参阅 IBM MQ classes for JMS 对象的属性中 PROVIDERVERSION 属性的描述。

缺省值为unspecified.

-ccsid ccsid

连接使用的编码字符集的标识 (CCSID) 或代码页。 缺省值为819.

-t

已启用跟踪。 缺省情况下，已禁用跟踪。

测试成功后，将生成类似于以下样本输出的输出：

5724-H72, 5655-R36, 5724-L26, 5655-L82 (c) Copyright IBM Corp. 2008, 2025. All Rights Reserved.
IBM MQ classes for Java(tm) Message Service 7.0
Publish/Subscribe Installation Verification Test

Creating a TopicConnectionFactory
Creating a Connection
Creating a Session
Creating a Topic
Creating a TopicPublisher
Creating a TopicSubscriber
Creating a TextMessage
Adding text
Publishing the message to topic://MQJMS/PSIVT/Information
Waiting for a message to arrive [5 secs max]...

Got message:
JMSMessage class: jms_text
JMSType:     null
JMSDeliveryMode: 2
JMSExpiration:  0
JMSPriority:   4
JMSMessageID:   ID:414d5120514d5f6d627720202020202001edb14620006706
JMSTimestamp:   1187182520203
JMSCorrelationID: ID:414d5120514d5f6d627720202020202001edb14620006704
JMSDestination:  topic://MQJMS/PSIVT/Information
JMSReplyTo:    null
JMSRedelivered:  false
JMSXUserID: mwhite
JMS_IBM_Encoding: 273
JMS_IBM_PutApplType: 26
JMSXAppID: QM_mbw
JMSXDeliveryCount: 1
JMS_IBM_PutDate: 20070815
JMS_IBM_ConnectionID: 414D5143514D5F6D627720202020202001EDB14620006601
JMS_IBM_PutTime: 12552020
JMS_IBM_Format: MQSTR
JMS_IBM_MsgType: 8
A simple text message from the MQJMSPSIVT program
Reply string equals original string
Closing TopicSubscriber
Closing TopicPublisher
Closing Session
Closing Connection
PSIVT finished

IVT 程序必须能够使用 JNDI 来从目录服务检索 MQTopicConnectionFactory 对象和 MQTopic 对象。 提供了脚本来为您创建这些受管对象。 该脚本在 UNIX and Linux 系统上称为 IVTSetup ，在 Windows上称为 IVTSetup.bat ，位于binIBM MQ classes for JMS 安装目录的子目录。 要运行此脚本，请输入以下命令：

IVTSetup

此脚本调用 IBM MQ JMS 管理工具以创建受管对象。

创建受管对象时，可运行 IVT 程序。 要使用 JNDI 运行测试，请输入以下命令：

PSIVTRun -url "providerURL" [-icf initCtxFact ] [-t]

此命令上的参数具有以下含义：

-url"providerURL"

目录服务的统一资源定位符 (URL)。 URL 可以是以下某种格式：

• ldap://hostname/contextName ，针对基于 LDAP 服务器的目录服务
• file:/directoryPath ，用于基于本地文件系统的目录服务

请注意，必须使用引号 (") 将 URL 引起来。

-icfinitCtxFact

初始上下文工厂的类名，其必须是以下值之一：

• com.sun.jndi.ldap.LdapCtxFactory，用于基于 LDAP 服务器的目录服务。 这是缺省值。
• com.sun.jndi.fscontext.RefFSContextFactory，用于基于本地文件系统的目录服务。

-t

已启用跟踪。 缺省情况下，已禁用跟踪。

安装验证测试可能出于以下原因而失败：

• 如果 IVT 程序写入一条消息，指示它找不到类，请检查是否正确设置了类路径，如 为 IBM MQ classes for JMS 设置环境变量中所述。
• 测试可能失败，显示以下消息：

  Failed to connect to queue manager ' qmgr ' with
  connection mode ' connMode ' and host name ' hostname '
  

  及关联原因码 2059。 此消息中的变量具有以下含义：

  QMGR

  IVT 程序尝试连接到的队列管理器的名称。 如果 IVT 程序尝试在绑定方式下连接到缺省队列管理器，那么插入的此消息为空。

  connMode

  连接方式，即Bindings或Client.

  HOSTNAME

  运行队列管理器的系统的主机名或 IP 地址。

  此消息意味着 IVT 程序正在尝试连接到的队列管理器不可用。 请检查队列管理器是否正在运行，如果 IVT 程序正在尝试连接到缺省队列管理器，请确保将此队列管理器定义为系统的缺省队列管理器。
• 测试可能失败，显示以下消息：

  Unable to bind to object
  

  此消息意味着已连接到 LDAP 服务器，但未正确配置 LDAP 服务器。 LDAP 服务器未配置为存储 Java 对象，或者对象或后缀上的许可权不正确。 要在此情况下获取更多帮助，请参阅 LDAP 服务器文档。
• 测试可能失败，显示以下消息：

  The security authentication was not valid that was supplied for
  QueueManager ' qmgr ' with connection mode 'Client' and host name ' hostname '
  

  此消息表示未正确设置队列管理器以接受来自系统的客户机连接。 有关更多信息，请参阅 配置队列管理器以接受 Multiplatforms 版上的客户机连接。