--------------------------------------------------------------------
* *
* DESCRIPTIVE NAME IBM WebSphere MQ for Windows, Version 5.3 *
* *
* Statement: Licensed Materials - Property of IBM *
* *
* (c) Copyright IBM Corp. 2002 *
* All rights reserved. *
* *
* U.S. Government Users Restricted Rights - use, *
* duplication or disclosure restricted by GSA *
* ADP Schedule Contract with IBM Corp. *
* *
* Status: Version 5.3 *
* Updated: 4th September 2002 *
* *
* *
--------------------------------------------------------------------
WebSphere MQ Windows 版，V5.3 自述文件
--------------------------------------
欢迎使用 WebSphere MQ Windows 版，版本 5.3
本自述文件适用于 2002 年 10 月发行的 WebSphere MQ 书籍和 2002 年 10 月
或以后提供的 V5.3 产品的 CSD01 级别。
本自述文件包含目前我们的出版物中没有的信息。除了此文件 README.TXT 外，
您还可以在下列 WebSphere MQ Web 站点上找到更多信息：
http://www.ibm.com/software/ts/mqseries/
SupportPac Web 页面位于：
http://www.ibm.com/software/mqseries/txppacs/
有关已知问题和可用修正的当前信息，请查看下列 WebSphere MQ Web 站点的
“支持”页面：
http://www.ibm.com/software/ts/mqseries/support
现在可以从以下 WebSphere MQ Web 站点获取基于 Web 的 WebSphere MQ 文档的
最新更新：
http://www.ibm.com/software/ts/mqseries/library/manualsa/index.htm
Web 上提供了本自述文件的联机版本，并且该联机版本可能会包含一些自本文件
封存于媒体后的附加信息。此站点是：
http://www.ibm.com/software/ts/mqseries/support/readme
《WebSphere MQ Windows 版快速入门 V5.3》
----------------------------------------
Using MQSC commands to alter WebSphere MQ objects while the WebSphere MQ
Explorer or WebSphere MQ Services are running can cause unpredictable results.
You should close the WebSphere MQ Explorer and WebSphere MQ Services while the
MQSC commands are used, and re-start them afterwards if required.
Chapter 1: Planning to install the WebSphere MQ for Windows server
__________________________________________________________________
Prerequisite server software
----------------------------
In section "Java" add
IBM 32-bit SDK for Windows, Java 2 Technology Edition, Version 1.4.0
Chapter 3: Installing WebSphere MQ
---------------------------------------------------
Add a note:
When installing on Windows XP using a Remote Desktop Connection, you will need
to logoff, then re-logon to pick up the changes made to your environment by
the installation process.
In the section "Installing WebSphere MQ - step-by-step" step 4 of Installing
WebSphere MQ, "Software Prerequisites" note that selecting the Supported Java
Runtime Environment V1.3 or later now allows you to install the
IBM 32-bit SDK for Windows, Java 2 Technology Edition, Version 1.4.0 from the
CD.
第 4 章：『安装 WebSphere MQ 的其它方法』
-----------------------------------------
在表 12.“Services 节中的属性”中，为属性 USERTYPE 添加了值 onlydomain，
所以 USERTYPE 条目可替换为：
属性 值 描述
---- -- ----
USERTYPE local|domain|onlydomain 要使用的用户帐户类型：
local.
创建本地用户帐户。
domain.
创建本地用户帐户。如果没有必需的
安全性权限，将使用由 DOMAINNAME、
USERNAME 和 PASSWORD 指定的域用户
帐户。
onlydomain.
不创建本地用户帐户，但立即使用由
DOMAINNAME、USERNAME 和 PASSWORD
指定的域用户帐户。如果丢失这三种
属性中的任何一种，则假设本地的
USERTYPE。
如果 USERTYPE 设置为 onlydomain，则属性 DOMAINNAME、USERNAME 和 PASSWORD
是必需的。
WebSphere MQ V5.3 Intercommunication
------------------------------------
Chapter 1, "Concepts of intercommunication"
-------------------------------------------
在节“Distributed queuing components”的子节“Channel initiators
and listeners”中，添加下列子节：
New channel behavior in WebSphere MQ
By default, in WebSphere MQ 5.3, threaded channels started by the channel
initiator or a listener do not run under that process, but under a process
called AMQRMPPA, otherwise known as a pool process.
To revert to the MQSeries 5.2 behavior, and have channels run under the
originating process, define an envrionment variable MQNOREMPOOL. The
existence of this variable, set to any value, runs the channel threads as
part of the listner or channel initiator process. This can be useful when
trying to isolate one or more channels from the rest of the configuration,
for example when testing channel exits.
Chapter 6, "Channel attributes"
-------------------------------
在节“Channel attributes in alphabetical order”的子节“KeepAlive Interval
(KAINT)”中，添加下列内容：
You can set the KeepAlive Interval (KAINT) parameter for channels on a
per-channel basis. You can access and modify the parameter, but it
is only stored and forwarded on non-z/OS platforms; there is no functional
implementation of the parameter.
If you need the functionality provided by the KAINT parameter, use the
Heartbeat Interval (HBINT) parameter, as described in "Heartbeat interval
(HBINT)".
《WebSphere MQ V5.3 使用 Java》
-------------------------------
第 4 章. 『使用 WebSphere MQ Java 消息服务类』
----------------------------------------------
在节“运行样本 applet”的子节“将 applet 作为应用程序运行”中，
在运行 applet 之前使用命令：
java JMSTestApplet
编译 applet，使用命令：
javac JMSTestApplet.java
Chapter 5. Using the WebSphere MQ JMS administration tool
---------------------------------------------------------
In section "Administering JMS objects" add a note to Table 11 "Property names
and valid values":
In certain environments, specifying the same queue name for both the
brokerDurSubQueue and brokerCCDurSubQueue attributes on an MQTopic object can
result in a JMSException being thrown. It is advised that separate queues are
used for these two attributes."
第 11 章. 『编写发布／订阅应用程序』
------------------------------------
在节“解决发布／订阅”的结尾处添加新的节，内容如下：
“其它注意事项”
当连接到具有大量使用 TCP/IP 套接字（即具有 TRANSPORT(DIRECT) 的 JMSAdmin
属性类型）的 JMS 客户机的 Microsoft Windows 系统上的 WebSphere MQ Event
Broker V2.1 时，注意以下情况。
如果大量连接几乎是同步发生的，可能会抛出“java.net.BindException Address
正在使用”的异常来响应 TopicConnection 调用。通过捕捉异常并重试或通过调步
连接，可尝试避免这种情况的发生。
WebSphere MQ Application Programming Guide
------------------------------------------
Appendix A. Language compilers and assemblers
---------------------------------------------
replace the existing
Table 66. Language compilers and assemblers for WebSphere MQ for Windows
by
---------------------------------------------------------
* Language * Compiler/Assembler *
*-----------+-------------------------------------------*
* Basic * Microsoft Visual Basic for Windows, V6.0 *
* * *
* C++ * Microsoft Visual C++ V6.0 *
* * *
* C * Microsoft Visual C++ V6.0 *
* * *
* COBOL * VisualAge COBOL Enterprise, V2.2 *
* * Micro Focus Net Express, V3.0 or V3.1 *
* * *
* PL/I * IBM VisualAge for PL/I for Windows, V2.1 *
---------------------------------------------------------
Note that the IBM VisualAge for C++ for Windows compilers are NOT supported.
replace the existing
Table 69. Language compilers and assemblers for Windows 98 clients
by
---------------------------------------------------------
* Language * Compiler/Assembler *
*-----------+-------------------------------------------*
* C++ * Microsoft Visual C++ V6.0 *
* * *
* C * Microsoft Visual C++ V6.0 *
* * *
* COBOL * Micro Focus Net Express, V3.0 or V3.1 *
---------------------------------------------------------
WebSphere MQ Using C++
----------------------
Appendix A. Compiling and linking
---------------------------------
The section "Compiling VisualAge C++ sample programs for Windows"
should be deleted.
WebSphere MQ Security Version 5.3
---------------------------------
Chapter 13. Working with the Secure Sockets Layer (SSL) on Windows systems
--------------------------------------------------------------------------
To add personal certificates to a Queue Manager store on Windows NT 4.0 the
WebSphere MQ Explorer or WebSphere MQ Services must be used. Amqmcert.exe
must be used on Windows NT 4.0 to add certificates to a client store.
On Windows 2000 and Windows XP you can use amqmcert.exe or the WebSphere MQ
Explorer or WebSphere MQ Services to add personal certificates to a Queue
Manager store.
In the section "Creating a self-signed personal certificate"
add the following examples on using the makecert certificate creation tool.
Creating Test Certificates Using MakeCert
=========================================
Note: these instructions were tested using Makecert.exe version
5.131.3617.0.
Creating and Installing a Certificate Authority Certificate
------------------------------------------------------------
You should create a separate certificate for the a root certificate.
This certificate will sign the SSL Certificate. The CA certificate in the
example has an id named "WebSphereCA". You can name it whatever you like.
1. makecert -pe -n CN=WebSphereCA -ss MY -sr CurrentUser -a sha1
-sky signature -r WebSphereCA.cer
2. run or double click on WebSphereCA.cer to install and trust the CA.
3. On Dialog, click Install Certificate.
4. Click the Next button.
5. Click the "Place all certificates in the following Store" radio button
and then click the Browse Button.
6. Check the "show Physical Stores" checkbox.
7. Expand the "Trusted Root Certification Authorities", select
"Local Computer" and click the OK button.
8. Click on the Next button and then the Finish button.
Creating the SSL Server Certificate
-----------------------------------
This example uses WebSphereMQ as the name of the SSL Certificate.
makecert -pe -n CN=WebSphereMQ -ss MY -sr CurrentUser -a sha1 -sky exchange
-eku 1.3.6.1.5.5.7.3.1 -in WebSphereCA -is MY -ir CurrentUser
-sp "Microsoft RSA SChannel Cryptographic Provider"
-sy 12 WebSphereMQ.cer
(Note: ensure the -sp name is exactly as specified in the example.)
Importing the SSL Certificates
------------------------------
The CA and Personal Certificates (issued to WebSphere in this example) can
then be imported into the queue manager or client certificate stores using
the WebSphere MQ Explorer, WebSphere MQ Services or amqmcert command line
utility.
In the section "Requesting a personal certificate" add:
Strong Private Key Protection
-----------------------------
When importing a certificate into the Personal Certificate store for the
Current User, an option to "Enable strong private key protection" is offered.
If this option is selected a dialogue is started where the level of security
can be chosen.
The dialogue offers a choice of High or Medium.
Both state that usage of this item will invoke a request for a user response.
If either of these security levels are selected IBM WebSphere MQ will
request a user response when the certificate is imported into the QM store.
Any further user request will not then be made when WebSphere MQ "uses"
this certificate: for example when channels are established.
Accessibilty of the IBM 32-bit SDK for Windows, Java 2 Technology Edition, Version 1.4.0
----------------------------------------------------------------------------------------
Java Web Start
--------------
The IBM 32-bit SDK for Windows, Java 2 Technology Edition, Version 1.4.0
includes Java Web Start. This is a reference implementation of the Java Network
Launching Protocol (JNLP). Java Web Start is an application deployment tool
that is not required for application development, and its use is entirely
optional.
The Java Web Start Application Manager is a client-side tool used to configure
and administer both Java Web Start and the applications that have been deployed
with it. The current version of this tool has some accessibility limitations
(described in the IBM 32-bit SDK for Windows, Java 2 Technology Edition,
Version 1.4.0 User Guide) that affect its use with assistive technologies.
The Java User Guide describes keyboard alternatives to some functions of the
Application Manager. In addition there are Open Source implementations of JNLP
that support command line operation. More details are available from the
SourceForge.net Web site (http://sourceforge.net/). Note, however, that such
alternatives are not supported by IBM and may not provide all of the features
found in Java Web Start.
Swing list box
--------------
The Swing list box allows multiple items to be selected using the mouse.
Selections can be either by contiguous items (the shift key is held down while
clicking the mouse button) or by discontiguous items (the control key is held
down while clicking the mouse button). Using the keyboard, however, only
contiguous items can be selected.
The inability to perform discontiguous selection might affect users who cannot
operate a mouse or other pointing device.
For applications that need to select more than one item, this alternative is
recommended. Use a dialog containing two list boxes with arrow buttons between
the boxes controlling the movement of list items from a source list on the
left to a selected list on the right. This use of two list boxes is a common
feature in Windows applications and means that the user does not have to make
discontiguous selections from a single list box.
商标
----
以下术语是 IBM 公司在美国和／或其它国家或地区的商标：
IBM MQSeries SupportPac WebSphere
ActiveX、Microsoft、Visual Basic、Visual C++、Windows 和 Windows NT 是
Microsoft Corporation 在美国和／或其它国家或地区的商标或注册商标。
Java 和所有基于 Java 的商标和徽标是 Sun Microsystems，Inc. 在美国和／或
其它国家或地区的商标或注册商标。
UNIX 是 The Open Group 在美国和其它国家或地区的注册商标。
其它公司、产品和服务名称可能是其它公司的商标或服务标记。