###############################################################################
#
# COMPONENT_NAME: MQSeries Adapter Kernel for Multiplatforms Version 1.1.1
#
# FILE: memo.ptf
#
# Program Number 5648-D75
# (C) COPYRIGHT International Business Machines Corp. 1995, 2001
# All Rights Reserved
# Licensed Material - Property of IBM
#
# US Government Users Restricted Rights - Use, duplication or
# disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
#
##############################################################################
PTF Memo for IBM MQSeries Adapter Kernel for Multiplatforms Version 1.1.1 CSD02
-------------------------------------------------------------------------------
This memo.ptf file corresponds to release 1.1 mod level 1 with the
second CSD, which is defined as PTF U200159 and is numbered 02.
The second CSD will bring your MQSeries Adapter Kernel for
Multiplatforms Version 1.1.1 installation up to service level U200159.
To determine your current service level, you may run aqmversion.bat
(Windows systems) or aqmversion.sh (UNIX and AS/400) in the kernel
bin directory. This will display the version number of the
kernel. If your service level is already U200159 then you do not need
to install this CSD.
All previous CSD corrections for release 1.1 have already been incorporated
in release 1.1 mod level 1 with CSD1, defined as PTF U200160. This CSD
contains additional corrections or features as documented in the "CSD HISTORY"
section.
This memo.ptf file will be updated whenever a cumulative service PTF
is made available. It will be updated to contain information that
you will need for updating IBM MQSeries Adapter Kernel for Multiplatforms
Version 1.1.1, as well as a summary of the contents of the latest CSD
and any earlier CSDs.
The memo.ptf file for this release is divided into the following
sections:
o Installation and maintenance information
o Documentation changes
o Special information
o Service and technical support
o CSD history
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
INSTALLATION AND MAINTENANCE INFORMATION
----------------------------------------
Maintenance updates can be supplied on CD-ROM, or they can be
downloaded from the World Wide Web.
** Precaution **************************************************
* *
* Do not have the AdapterDaemon running while you are *
* applying or removing maintenance updates to MQSeries *
* Adapter Kernel for Multiplatforms. *
* *
* Do not have source adapters running while you are *
* applying or removing maintenance updates to MQSeries *
* Adapter Kernel for Multiplatforms Version. *
* *
****************************************************************
The installation of this PTF requires approximately 10MB of disk
space to do the PTF installation and to save the previous level.
Some of this disk space is used to keep copies of the previous
levels of the parts updated by this PTF so that the PTF can be
removed, and the previous level automatically restored. The procedure
for OS/400 is different compared to other platforms. The following
instructions are generic and do not apply to OS/400. For OS/400
specific instructions, please refer to "AS/400 Specific" section.
If you need to apply maintenance updates to your MQSeries Adapter
Kernel product:
1. Ensure you are logged on as an Administrator
2. Ensure that the IBM MQSeries Adapter Kernel's AdapterDaemon
has been stopped.
3. Ensure that all source adapters are stopped.
4. The installation process will automatically detect what
components you have previously installed on your system,
and it will only update those components.
5. You will be presented with the "Welcome" dialog. Select the
"Next>" button.
6. Type in or choose the directory where you have installed the
base product and then select the "Next>" button.
7. From the "Ready to Install" dialog, verify that the installed
components are correct and then select the "Next>" button to
proceed.
8. Verify the installation was successful on the "Installation
Summary" dialog.
9. Select the "Finish" button to complete the installation of
the CSD.
Restoring the Previous Backup Version
-------------------------------------
If you need to restore from backup, to the previous level of
maintenance:
1. Ensure you are logged on as an Administrator
2. Ensure that the IBM MQSeries Adapter Kernel's AdapterDaemon
has been stopped.
3. Ensure that all source adapters are stopped.
4. Select MQSeries Adapter Kernel from the Start Menu and
then select 'Remove CSD'.
Querying the Service Level
--------------------------
To query the service level on Windows NT Version 4.0 and
Windows 2000 , select "Start", and then select "Programs" and
then select "MQSeries Adapter Kernel", and finally select
"Service Level".
This shows the memo.ptf file containing the service level and
details of the maintenance applied (PTF number). This file is
included in the root directory of the CD-ROM.
NOTE: This file does not contain all information necessary
for installation. See the MQSeries Adapter Kernel for
Multiplatforms Quick Beginnings book for detailed information
on how to install on a specific platform.
The installation program for MQSeries Adapter Kernel for
the various platforms uses Java to install the product
to your workstation. It has been fully tested with Java
Development Kit 1.1.8 and 1.2.2. Other versions of the Java
Development Kit may work but are not directly supported.
During installation, installation status messages are written
to the log.txt file in the kernel's root directory. If a
problem occurs during installation, you can examine this file.
Windows NT and Windows 2000 Specific
====================================
The read only attribute of the memo.ptf and the readme.txt files
needs to be changed to write. In a command window change into the
MQSeries Adapter Kernel installation directory and enter:
attrib -r memo.ptf
To install on Windows NT and Windows 2000, run the installCSD.bat
command file.
On Windows 2000 the memo.ptf and readme.txt files are not replaced
by the installation of the CSD. You must copy these files from the
Win\W2K\ directory on the web to the MQSeries Adapter Kernel
installation directory.
AIX Specific
============
To install on AIX run the installCSD.sh shell script.
On some AIX systems the installation directory entry field
within the installation program displays as white text on
a white background. Use the style manager color utility to
modify the system color pallette before starting the install.
Solaris Specific
================
To install on Solaris run the installCSD.sh shell script.
Some users may see an hour glass for the cursor on some of
the installation panels. The cursor can still be used to
select buttons when displayed as the hour glass.
HP-UX Specific
==============
To install on HP-UX run the installCSD.sh shell script.
At the end of the log.txt file there may be two messages:
one indicating date and time could not be changed and the
second indicating the file permissions could not be changed.
These messages can be ignored.
With some X-Windows managers, font errors may be given that
can cause the installation to fail. Installation from a
remote Intel-based system is usually successful.
AS/400 Specific
===============
To install on OS/400 use the installCSDAS400.jar file.
java -cp installCSDAs400.jar run -os400
Before installing on the AS/400 create a user profile named
MQAKSRV using the CRTUSRPRF command.
Performing an install to an OS/400 system can be performed
either from the OS/400 system or from an attached client. We
recommend using the attached client method, it is the easiest
and it has the best overall performance.
AS/400 attached client
======================
On the workstation, open a command prompt and change to
the AS400 directory of the MQSeries Adapter Kernel installation
media (either local area network or CD-ROM).
If the workstation is running JDK 1.1.8, enter the
following command:
jre -cp installCSDAS400.jar run -os400
If the workstation is running JDK 1.2.2 or higher, enter
the following command:
java -cp installCSDAS400.jar run -os400
AS/400 Remote AWT
=================
Start Remote AWT on your client workstation by changing to the
directory where you copied the RAWTGui.jar file and typing
'java -jar RAWTGui.jar'.
The installAS400.jar file needs to be accessible to the OS/400
system. The file needs to be either in the IFS directory system,
or on a device attached to the OS/400 system. If the file is on
an attached device, you need to use the Create Link (CRTLINK)
command to create a symbolic link to the file.
You can significantly increase the performance of the install
by running Create Java Program (CRTJVAPGM) against the
installCSDAS400.jar file. On some machines the running of the
CRTJVAPGM can be very time consuming.
Call the Run Java (RUNJVA) command, supplying the TCP/IP
address of the client that is running Remote AWT:
RUNJVA CLASS(run)
CLASSPATH('/installCSDAS400.jar')
PROP((os400.class.path.rawt 1) (RmtAwtServer 'x.x.x.x')
(java.version 1.2))
Uninstall on AS/400
===================
The uninstall CSD function on the AS/400 does not restore the previous
version of the code as is done on other platforms. When the CSD
is uninstalled, the installation of the kernel is destroyed. As
a result, in order to restore the previous version of the code on the
AS/400 platform, follow the following steps:
1. Uninstall CSD:
java -cp uninstallCSDAS400.jar run -os400
2. Uninstall MQ Series Adapter V1.1:
java -cp uninstallAS400.jar run -os400
3. Re-Install MQ Series Adapter V1.1.
java -cp installAs400.jar run -os400
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
DOCUMENTATION CHANGES
---------------------
In addition to any amendments to the MQSeries Adapter Kernel
publications listed in the read.me file on the product CD-ROM,
the following changes to the publications should also be made:
In the Kernel's installation root directory under directory
"documentation" there are language specific directories de, es, fr,
it, ja, ko, pt_BR, zh_CN, and zh_TW. These directories should not
be there and their html files do not contain valid links.
Quick Beginings Book
--------------------
Appendix C. Message headers
- Table 13.MQSeries Adapter Kernel Header
- Under column "Header name" value "RespondToLogicalID"
The "Meaning or usage" description should be
"Used for responses."
- Under column "Header name" value "ProcessingCategory"
The "Meaning or usage" description should be "Reserved use."
- Under column "Header name" value "DeliveryCategory"
The "Meaning or usage" description should be "Reserved use."
- Under column "Header name" value "SessionID"
The "Meaning or usage" description should be "Reserved use."
Problem Determination Guide
---------------------------
Chapter 2: Problem "Queue depth exceeded"
The first response should be
"Response: Set the maximum queue depth for the queue appropriately."
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
SPECIAL INFORMATION
-------------------
A) CSD01 (PTF U200160) feature 1036
--------------------------------
1) Audit Logging criteria has been changed from using the application id
used for instantiating the NativeAdapter to:
a) Using the SourceLogicalID meta-data value of the Message being sent.
b) Using the ApplicationID of ENAService object being used to
receive a message.
2) Two new Audit Logging API's are now used for Audit Logging:
a) writeSentMsg(EpicMessage) when sending a message.
b) writeRetrievedMsg(EpicMessage) when retrieving a message.
If either of these two methods do not exist then the current
writeAudit(EpicMessage) will be used. Use of the new API's still
require Websphere Business Integrator product 5724-A78 version 2.1
plus CSD01 or later.
B) CSD02 (PTF U200159)
-------------------
1) feature 15275
If a process is running without WebSphere Business Integrator (WSBI)
installed, an exception message is issued indicating that the Exception
Log client class cannot be found. Now, the following exception message is issued
only for the first occurrence of the flow:
"Putting a message to an error queue".
2) feature 15213
The support for C Adapters is now fully NLS enabled.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
SERVICE AND TECHNICAL SUPPORT
-----------------------------
A) Service Level Information
-------------------------
IBM MQSeries Adapter Kernel for Multiplatforms Version 1.1.1 CSD 02 is
the second PTF for the third release of product 5648-D75.
B) Service Support Available from the Internet
-------------------------------------------
You can find additional information on the MQSeries Web site,
located at:
http://www.ibm.com/software/ts/mqseries/
For additional information related to MQSeries Adapter Offering,
see the following Web page on the MQSeries Web site:
http://www.ibm.com/software/ts/mqseries/adapter/information
For current information on known problems and available fixes
please see the Support option on the MQSeries Web site at:
http://www.ibm.com/software/ts/mqseries/support
From the MQSeries support page, you can obtain the latest
information about the following topics:
IBM Transaction Processing SupportPacs
Closed APARs
Fix Packages
Frequently Asked Questions
Tips and Techniques
Device Drivers
Forums
Related Links
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
CSD HISTORY
===========
A) CSD01 (PTF U200160)
-------------------
This is the first CSD for IBM MQSeries Adapter Kernel for
Multiplatforms Version 1.1.1 from IBM. It is delivered via PTF U200160.
Number of APARs in CSD = 1.
It contains fixes for all the problems listed below:
APAR IC30330
------------
0001061 - JMSNMRFH2Formatter doesn't set DestinationLogicalID.
0001063 - RelatedSubjectID missing from JMS Formatter processing.
Non-APAR
------------
0001036 - NativeAdapter - Use new Logging API's and log by appid criteria.
0001046 - AdapterExceptionMessages.properties messageid corrections.
0001049 - AdapterExceptionMessages.properties messageid corrections.
0001055 - Installation language corrections.
0001076 - Updated NLS message files.
0001096 - MQNMBDFormatter requires epicdestids in target application
configuration on EpicNativeAdapter sendRequestResponse.
B) CSD02 (PTF U200159)
-------------------
This is the second CSD for IBM MQSeries Adapter Kernel for
Multiplatforms Version 1.1.1 from IBM. It is delivered via PTF U200159
and includes all fixes from CSD01.
Number of APARs in CSD = 0.
It contains fixes for all the problems listed below:
Non-APAR
------------
0015215 - Two Exception Message issues
0015217 - Builder-generated adapter gets NullPointer Exception calling toString
0015218 - MQAOXMLIJ.copyContents problem with comments and PIs
0015219 - Passing in null to ENA.receiveMsg gives NullPointerException
0015220 - AdapterDirectory::getDirectoryServices - EpicMessage in message
0015226 - No TraceDaemon output if TraceServer ePICTrace = false
0015229 - Alias Queues don't work with the AdapterDaemon
0015275 - Suppress repeated exception traces if WSBI is not installed.
0015295 - Sample does not compile without the epicDirectory.jar
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
TRADEMARKS
----------
The following terms are trademarks of the IBM Corporation in the
United States or other countries or both:
IBM
AIX
MQSeries
Windows is a trademark of Microsoft Corporation.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++