Readme for IBM MQSeries for HP-UX Version 5.2 (HP-UX V10) Download PTF U478290 =================================================================== This readme file contains information you need for updating IBM MQSeries for HP-UX V5.2 (server and/or client), as well as a summary of the contents of the latest CSD and any earlier CSDs. This is the third CSD, corresponding to PTF U478290, and it is numbered 03. It will bring your MQSeries for HP-UX Version 5.2 installation up to service level U478290 (CSD03). This PTF can be used to update the MQSeries for HP-UX V5.2 server. This PTF can be used to update the MQSeries for HP-UX V5.2 client if you installed the client in one of the following ways: a) From the MQSeries for HP-UX V5.2 CD-ROM b) From the MQSeries V5.2 client CD-ROM c) By downloading the SupportPac MACM from the web and installing it. How to Download this Corrective Service ======================================= 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 (U478290) supersedes all previous PTFs for MQSeries for HP-UX V5.2 (HP-UX Version 10) and it contains updates to the following components of MQSeries for HP-UX: MQM-RUNTIME MQSeries Runtime support for external applications MQM-SERVER MQSeries server support for client connections MQM-CL-HPUX MQSeries client for HP-UX MQM-BASE MQSeries Base Kit for Client and Server MQM-SAMPLES MQSeries Samples In addition there are three additional APAR fixes provided which if applicable to your installation should also be downloaded and applied on any installation at service level U478290 (CSD #3). These optional APAR fixes are IC32843, IY20727 and IY28347. The files to be downloaded and the instructions for installing for these APAR fixes are specified below. It is recommended that you apply hiper APAR fix IC32843 if you use channel send and receive exits. It is recommended that you apply hiper APAR fix IY28347 if you use CICS, Encina or Tuxedo XA applications with MQSeries. PTF U478290 ----------- To use the latest PTF file, perform the following steps: 1) download the file to directory /var/spool/sw in binary mode 2) uncompress U478290.tar.Z 3) tar -xvf U478290.tar APAR IC32843 ------------ After applying V5.2 CSD03, installations that use channel send and receive exits have encountered problems (eg. when changing channel definitions with PCF commands). The APAR fix (IC32843.hpux10.tar.Z) for this problem consists of a single compressed tar file which contains replacements for the following libraries in MQSeries for HP-UX V5.2 (HP-UX V10): libmqmr.sl libmqmr_r.sl PTF U478290 is a pre-requisite for this APAR fix. To apply the fix :- (1) Ensure you are logged in as root. You must be a superuser to apply this efix. (2) Uncompress the IC32843.hpux10.tar.Z file into a temporary directory: uncompress IC32843.hpux10.tar.Z (3) Expand the IC32843.hpux10.tar file in the temporary directory: tar -xvf IC32843.hpux10.tar (4) Stop all MQ channels. (5) End all queue managers and MQ processes on the target machine. (6) Ensure that any shared resources are deleted. (7) Take backup copies of the following libraries on your system: libmqmr.sl libmqmr_r.sl (8) Copy over the two libraries from the temporary directory to replace the existing libraries. (9) Restart the queue managers. (10) Log off as root and log on as mqm before starting the queue manager. APAR IY20727 ------------ A CCSID conversion error occurred together with an FDC with probe id XC076001 if MQSeries for HP-UX V5.2 was used on HP-UX Version 11 with any CCSID other than 819. The APAR fix (IY20727.hpux10.tar.Z) for this problem consists of a single compressed tar file which contains replacements for the following libraries in MQSeries for HP-UX V5.2 (HP-UX V10): libmqmcs.sl libmqmcs_r.sl PTF U478290 is a pre-requisite for this APAR fix. To apply the fix :- (1) Ensure you are logged in as root. You must be a superuser to apply this efix. (2) Uncompress the IY20727.hpux10.tar.Z file into a temporary directory: uncompress IY20727.hpux10.tar.Z (3) Expand the IY20727.hpux10.tar file in the temporary directory: tar -xvf IY20727.hpux10.tar (4) Stop all MQ channels. (5) End all queue managers and MQ processes on the target machine. (6) Ensure that any shared resources are deleted. (7) Take backup copies of the following libraries on your system: libmqmcs.sl libmqmcs_r.sl (8) Copy over the two libraries from the temporary directory to replace the existing libraries. (9) Restart the queue managers. (10) Log off as root and log on as mqm before starting the queue manager. APAR IY28347 ------------ After applying V5.2 CSD03, installations that use CICS, Encina or Tuxedo XA applications have encountered problems where the transactions fail to start. The APAR fix (IY28347.hpux10.tar.Z) for this problem consists of a single compressed tar file which contains replacements for the following libraries in MQSeries for HP-UX V5.2 (HP-UX V10): libmqm.sl libmqm_r.sl PTF U478290 is a pre-requisite for this APAR fix. To apply the fix :- (1) Ensure you are logged in as root. You must be a superuser to apply this efix. (2) Uncompress the IY28347.hpux10.tar.Z file into a temporary directory: uncompress IY28347.hpux10.tar.Z (3) Expand the IY28347.hpux10.tar file in the temporary directory: tar -xvf IY28347.hpux10.tar (4) Stop all MQ channels. (5) End all queue managers and MQ processes on the target machine. (6) Ensure that any shared resources are deleted. (7) Take backup copies of the following libraries on your system: libmqm.sl libmqm_r.sl (8) Copy over the two libraries from the temporary directory to replace the existing libraries. (9) Restart the queue managers. (10) Log off as root and log on as mqm before starting the queue manager. Installation and Maintenance Information ======================================== A) Applying Maintenance for MQSeries for HP-UX V5.2 ------------------------------------------------ Now you will need to use swinstall to install the resulting output file, which is in the form: hp-U478290.v10 +--- PRECAUTIONS ---------------------------------------+ | | | Do not have any queue managers operating during | | installation of maintenance on MQSeries for HP-UX | | V5.2 (Version 10). | | | | Remove any existing MQSeries shared memory and/or | | semaphores before applying or removing maintenance | | updates to MQSeries for HP-UX V5.2 (Version 10). | | | +-------------------------------------------------------+ | | | 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. | | | +-------------------------------------------------------+ B) SPACE REQUIREMENTS ------------------ The installation process for this PTF requires 20MB of disk space for installation. In addition, the installation process requires an additional 20MB 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/adm/sw/patch". 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. C) APPLYING THE MAINTENANCE INFORMATION ------------------------------------ To apply the maintenance information: 1. Log in as root, or use the command su. 2. Use the SWINSTALL command to install the patch from the supplied medium. Details of the SWINSTALL command can be found in the HP-UX Administration Guide or by using the MAN SWINSTALL command. 3. If you have installed an MQI client from your MQSeries for HP-UX installation, and if one or more of these client components have been modified by installing an update, then you MUST specifically update your MQI client installation. D) RESTORING THE PREVIOUS SERVICE LEVEL ------------------------------------ To restore the previous service level: 1. Log in as root, or use the command su. 2. Use the SWREMOVE command to remove the patch from the system. For example, to remove patch "U478290" issue the following command: swremove MQSERIES.U478290 Details of the SWREMOVE command can be found in the HP-UX Administration Guide or by using the MAN SWREMOVE command. 3. If you have installed an MQI client, and the client was updated after installing the PTF which is being removed, then you MUST specifically update your MQI client installation again, after the PTF has been removed.