Please note: ============ The PTF memo states that PTF U469913 is the first PTF for MQSeries for Sun Solaris V5.1 and that it is numbered 01. That is incorrect. PTF U469861 was the first PTF (numbered 01) and PTF U469913 is the second PTF (numbered 02). README.TXT: =========== The corrective service files in this directory are of the form: U4xxxxx.tar.Z This means that they have been processed by the tar program and then compressed. The latest PTF (U469913) supersedes all previous PTFs for MQSeries for Sun Solaris V5.1 and it contains updates to the following components of MQSeries for Sun Solaris: runtime MQSeries Runtime support for external applications server MQSeries server support for client connections dce_server MQSeries support for DCE in server dce_samples MQSeries DCE Samples sol_client MQSeries client for Sun Solaris and client for Java samples MQSeries sample application programs base MQSeries Base Kit for Client and Server java_base MQSeries Java Base java_bind MQSeries Java Bindings java_clnt MQSeries Client for Java - Runtime De_DE MQSeries Messages - German Es_ES MQSeries Messages - Spanish Fr_FR MQSeries Messages - French It_IT MQSeries Messages - Italian Ja_JP MQSeries Messages - Japanese Ko_KR MQSeries Messages - Korean Pt_BR MQSeries Messages - Portuguese-Brazilian Zh_CN MQSeries Messages - Simplified Chinese Zh_TW MQSeries Messages - Traditional Chinese To use the latest PTF file, perform the following steps: 1) download the file to your local system in binary mode 2) uncompress U469913.tar.Z 3) tar -xvf U469913.tar In addition there is an additional APAR fix provided which may also be downloaded and applied on any installation at service level U469913 (CSD #4). This optional APAR fix is IY11905 and it it can only be used on non-DCE installations. The file to be downloaded and the instructions for installing for this APAR fix are specified below. PTF U469913 ----------- After installation of this CSD, there is a MEMO.PTF file that contains information relating to this PTF. You are advised to read this file which contains: o installation instructions for applying maintenance o a summary of the current and superseded service levels o Special Information which may be mandatory for complete resolution of one or more of the APAR fixes shipped by this PTF. This PTF is applicable to ALL releases of product 5765-B75-00, IBM MQSeries for Sun Solaris Version 5.1, namely the English version or any of the National Language versions. APAR IY11905 ------------ With the release of Sun MicroSystems' Sun Workshop C++ Compiler 5.0 for Sun Solaris, it has become apparent that many IBM customers wish to use this compiler in 'standard mode' to build C++ programs using ANSI standard C++. The C++ libraries shipped as standard with IBM MQSeries for Sun Solaris V5.1 do not support use of this compiler in 'standard' mode. IBM customers wishing to use Sun Workshop C++ Compiler 5.0 in 'standard' mode must apply E-Fix IY11905, which implements support for this compiler in IBM MQSeries for Sun Solaris V5.1. IBM customers wishing to make use of this E-Fix should have installed MQSeries for Sun Solaris V5.1 at Service Level CSD04 (PTF U469913) without the DCE option. Do not use this E-Fix if you have installed the DCE option. The E-Fix (IY11905.tar.Z) for this problem consists of a single compressed tar file which contains some additional and some replacement libraries and sample programs for MQSeries for Solaris V5.1: Libraries: libimqs23as.so libimqc23as.so libimqb23as.so libdmqnsapi_r.a libdmqicapi_r.a libdmqkern_r.so libmqjbnd01.so libwmqjbind.so Samples: imqdputc imqdputs imqsgetc imqsgets imqsputc imqsputs imqwrldc imqwrlds Note 1: IMPORTANT - Support for Java with MQSeries ========================================== If you have applied SupportPac MA88 - MQSeries Classes for Java and MQSeries Classes for Java Message Service, you will need to use libmqjbnd01.so. If you have not applied this SupportPac, you will need to use libwmqjbind.so Note 2: IMPORTANT - Support for DCE.DFS 2.0 for Sun Solaris 2.6 ------------------------------------------------------- DCE.DFS 2.0 for Sun Solaris 2.6 is not supported for use with the libraries contained within this E-Fix. To apply the fix :- (1) Uncompress and tar the compressed tar file IY11905.tar.Z into a temporary directory (2) Do not have queue managers running while you are applying or removing maintenance updates to MQSeries for Solaris V5.1 (3) Remove any existing MQSeries shared memory and/or semaphores before applying or removing maintenance updates to MQSeries for Solaris V5.1 (4) Take backup copies of the following libraries on your system: libdmqnsapi_r.a libdmqicapi_r.a libdmqkern_r.so libmqjbnd01.so libwmqjbind.so (5) Copy over the new version of these libraries to your system, into /opt/mqm/lib, after making secure backup copies of the original libraries. (6) Ensure that the owner and group of the libraries is mqm/mqm using the command chown mqm:mqm ... (7) Ensure that the permissions of the libraries is -r-xr-xr-x using the command chmod 555 ... (8) The new sample programs should go into a new directory, /opt/mqm/samp/bin/as/ (9) Restart the queue managers. INSTALLATION AND MAINTENANCE INFORMATION ---------------------------------------- Applying Maintenance to MQSeries for Sun Solaris V5.1 ----------------------------------------------------- These steps will ensure that you are left with files that are installable using the normal install method for your platform. +--- PRECAUTIONS ---------------------------------------+ | | | Do not have any queue managers operating during | | installation of maintenance on MQSeries for Sun | | Solaris V5.1. | | | | Remove any existing MQSeries shared memory and/or | | semaphores before applying or removing maintenance | | updates to MQSeries for Sun Solaris V5.1. | | | +-------------------------------------------------------+ | | | To end all running queue managers: | | | | 1. End the queue manager by issuing the command: | | | | endmqm -i QMgrName | | | | 2. Check that the queue manager has ended. | | | | Use the command: | | | | endmqm -w QMgrName | | | | The message returning should show that the queue | | manager is not available. | | | | Alternatively, use the command: | | | | ps -ef | grep mq | | | | where | is the pipe symbol. Check that there are | | no processes listed that are running command | | lines commencing "amq" or "runmq". Ignore any | | that start with "amqi". | | | | 3. Issue the IPCS -A command to identify any shared | | memory segments or semaphore sets that were | | created by MQSeries. Remove these using the | | IPCRM command. | | | +-------------------------------------------------------+ SPACE REQUIREMENTS ------------------ The installation process for this PTF requires 14MB of disk space for installation. In addition, the installation process requires an additional 14MB of disk space to save the previous level. This allows a PTF to be removed, and the previous level to be automatically restored. If disk space is limited, the backup can be suppressed by creating an empty flag file called MQPTF_NOSAVE in the directory "/var/sadm/pkg". Note that if this option is used, the previous level will not be restored if a PTF is removed. The only way to restore a previous level in this instance is to reinstall the product and then to reapply a previous PTF image. APPLYING THE MAINTENANCE INFORMATION ------------------------------------ 1. Mount the CD by typing the following commands: mkdir -p /cdrom/mq_solaris mount -F hsfs -r /dev/dsk/cntndnsn /cdrom/mq_solaris substituting "cntndnsn" with the name of your CD-ROM device. 2. Install the software by entering the following command: pkgadd -d /cdrom/mq_solaris/mqm/mqm-U469913.image For further information on using PKGADD to install software packages, see the Solaris documentation. RESTORING THE PREVIOUS SERVICE LEVEL ------------------------------------ To restore the previous service level: 1. Log in as root, or use the command su. 2. Use the PKGRM command to remove the latest PTF from the system. For example, to remove PTF "U469913" issue the following command: pkgrm mqm-upd02 Error messages of the form "" can be ignored. Details of the PKGRM command can be found in the Solaris documentation, or by using the MAN PKGRM command. 3. If you have installed an MQI client, and the client was updated after installing the PTF that is being removed, then you MUST specifically update your MQI client installation again, after the PTF has been removed.