How to download and install this Corrective Service
---------------------------------------------------
Download on Intel Platforms
===========================
For OS/2, Windows NT, Windows 95 and Windows 3.1 installations,
download the file U200085.zip in binary mode.
Unzip the U200085.zip file into a temporary directory on your hard
drive, ensuring that you preserve the directory structure when you
do so (for example, Use InfoZip's Unzip to extract the files).
This temporary directory includes softcopy installation
instructions to help you install this PTF.
Download on Unix Platforms
==========================
For AIX, HP-UX and Sun Solaris installations, download the file
U200085.tar.Z into a temporary directory in binary mode.
This corrective service file has been processed by the tar program
and then compressed.
To use this PTF file, perform the following steps:
1) download the file in binary mode
2) uncompress U200085.tar.Z
3) tar -xvf U200085.tar
This temporary directory includes softcopy installation
instructions to help you install this PTF.
Installation Instructions
=========================
There is a README.EI file, located in the temporary directory, that
contains the installation instructions. After installation of the
PTF, the README.EI file is renamed as MEMO.PTF in your installed
product.
Before installing this PTF, you are advised to read the README.EI
file which contains:
o installation instructions for applying maintenance for
Windows NT and Windows 95.
o installation instructions for applying maintenance for
OS/2.
o installation instructions for applying maintenance for
AIX.
o installation instructions for applying maintenance for
Sun Solaris.
o installation instructions for applying maintenance for
HP-UX.
o installation instructions for applying maintenance for
Windows 3.1.
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 supported operating system
platforms of IBM MQSeries Enterprise Integrator version 1.0.
If after applying this PTF, you experience problems - please
contact the IBM Support Center (ISC) at 1-800-237-5511
or an authorized IBM Personal Computer dealer,
whichever is applicable.
INSTALLATION AND MAINTENANCE INFORMATION
----------------------------------------
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
INSTALLATION AND MAINTENANCE INFORMATION FOR WINDOWS NT AND WINDOWS 95
----------------------------------------------------------------------
A) Applying Maintenance
--------------------
This PTF requires approximately 11MB of disk space to save the
previous level. This allows a PTF to be removed, and the previous
level automatically restored.
To apply maintenance updates to your MQEI product:
1. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
2. If you are installing from CD then insert the maintenance CD
into the appropriate drive. If you are installing after
downloading the CSD from the World Wide Web then ensure you
are connected to the directory containing the CSD image.
3. On Windows NT V4.0 or Windows 95, select the Start menu then
select "Run".
On Windows NT V3.51, from Windows Program Manager select
the "File" pulldown then select "Run".
Then type "<drive>:\win32\mqeicsd1\setup" where <drive> is the
drive letter you are installing from and click OK. The pathname
may need modifying if you downloaded this CSD from the web and
unzipped into a temporary directory.
4. You will be presented with the "Welcome" dialog. Select the
"Next>" button.
5. When prompted with the prompt "Do you wish to backup the
current version of the product?", it is recommended that you
reply "Yes".
6. Select the backup directory (it is recommended that you leave
the default directory), and then select the "Next>" button.
7. From the "Start Copying Files" dialog, verify that the
information displayed matches your requested choices, and then
select the "Next>" button to proceed.
8. Select the "Finish" button to complete the installation of
the CSD.
B) Restoring the Previous Backup Version
-------------------------------------
If you need to restore from backup, to the previous level of
maintenance:
1. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
2. On Windows NT V4.0 or Windows 95, use the Start menu to navigate
to the "Programs" sub menu, select "MQSeries Enterprise
Integrator", and finally select the "Remove CSD01" icon.
On Windows NT V3.51 open the MQSeries Enterprise Integrator
folder, and double-click on the "Remove CSD01" icon.
3. If the CSD has been applied with rollback, you are given
the option to uninstall the most recent CSD or uninstall
the entire product. Select "Uninstall last APAR" then
select the "Remove" button to remove the most recent CSD
and return the installation to the state it was in before
the CSD was applied.
Notes:
1. The "Remove CSD01" icon is NOT removed from the menu or folder
upon successful completion of the operation.
C) Querying the Service Level
--------------------------
On Windows NT V4.0 or Windows 95, use the Start menu to navigate to
the "Programs" sub menu, select "MQSeries Enterprise Integrator",
and finally select the memo.ptf file.
On Windows NT V3.51 open the MQSeries Enterprise Integrator folder,
and double-click on the memo.ptf file.
This shows the memo.ptf file containing the service level and
details of the maintenance applied (PTF number). This file is
also included in the root directory of the CD.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
INSTALLATION AND MAINTENANCE INFORMATION FOR OS/2
-------------------------------------------------
A) Applying Maintenance
--------------------
This PTF requires approximately 14MB of disk space to save the
previous level. This allows a PTF to be removed, and the previous
level automatically restored.
To apply maintenance updates to your MQEI product:
1. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
2. If you are installing from CD then insert the maintenance CD
into the appropriate drive. If you are installing after
downloading the CSD from the World Wide Web then ensure you
are connected to the network drive containing the CSD.
3. Open the MQSeries Enterprise Integrator folder on the desktop
and double-click on the "Installation and Maintenance" icon.
4. Click on "File".
5. Select "Open catalog", and from the sub-menu displayed select
"Drive".
6. Select the drive containing the maintenance CD, or the network
drive containing the downloaded CSD, from the Drive pulldown.
7. Click on "Search", and a "Directory" list will be displayed.
8. Select and open the os2\mqeicsd1\En_US language directory from the
"Directory" list. Next, select MQEICAT2.ICF from the "File"
list and click on "OK".
9. You will return to the "Open drive catalog" window, with the
selected catalog file displayed in the "Filename" list. You
may verify your selection by clicking on "Description".
10. When you have selected the catalog file which corresponds to
the product you have installed, click on "Open" to open the
catalog file.
11. Click on the "View" choice on the menu bar, and then
select "Current catalog"; the window should display:
01.00.00 IBM MQSeries Enterprise Integrator
12. Click on the "Details" choice on the menu bar, and then
select "Product description". This should query the product
information from files on the CD or the network
drive, and display the product description for 'IBM MQSeries
Enterprise Integrator'. If this fails, then check that you have
selected the correct catalog file in step 7.
13. Click on the "Action" choice on the menu bar.
14. Click on "Update" to display the Update window.
15. It is recommended that you save a backup version of your
installation when you apply this CSD. You do this by
ensuring that the "Save backup version" option is selected.
16. Click on "Update" in the Update window.
17. During update, a status bar is displayed. On completion,
follow the instructions given in the message windows. In
particular, if it says to reboot your system then you must do
this before continuing with any further use or maintenance of
IBM MQSeries Enterprise Integrator.
B) Restoring the Previous Backup Version
-------------------------------------
If you need to restore from backup, to the previous level of
maintenance:
1. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
2. Open the MQSeries Enterprise Integrator folder and double-click
on the "Installation and Maintenance" icon.
3. Click on the "Action" choice on the menu bar.
4. Click on "Restore" to display the Restore window.
5. Click on "Restore" in the Restore window.
6. During restore, a status bar is displayed. On completion,
follow the instructions given in the message windows. In
particular, if it says to reboot your system then you must do
this before continuing with any further use or maintenance of
IBM MQSeries Enterprise Integrator.
Notes:
1. The Restore action is only applicable if, when using the
Update action, the option to save a backup copy was selected.
2. The MQEI folder will be closed and reinitialized. This
means that all folder settings will be reset to their default
values. Due to a bug this means the mqeihelp.pdf icon will be
lost from the folder.
3. All changed files at the current maintenance level will be
overwritten, without requiring confirmation by the user, with
corresponding files saved from the previous maintenance
level. However new files at the current maintenance level
will not be deleted.
C) Querying the Service Level
--------------------------
After initial installation, service level has the value "0000000"
After one or more updates, service level indicates from which CSD
the product was most recently updated. Service level is expressed
in terms of the PTF number for a particular CSD. To query the
service level:
1. Open the MQSeries Enterprise Integrator folder and double-click
on the "Installation and Maintenance" icon.
2. If the current product selected is not IBM MQSeries Enterprise
Integrator then click on the "View" choice on the menu bar, and
then select "Installed products". Now select IBM MQSeries
Enterprise Integrator.
3. Click on "Details" on the menu bar.
4. Click on "Product status" to display the Product status window.
5. Select one of the currently installed components, and click on
"Service level" to display the Service level window. For the
selected component this will show details of Install date,
Origin (source from which MQEI was installed), and Level.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
INSTALLATION AND MAINTENANCE INFORMATION FOR AIX
------------------------------------------------
A) Applying Maintenance
--------------------
This PTF requires approximately 10MB of disk space to save the
previous level. This allows a PTF to be removed, and the previous
level automatically restored.
To apply maintenance updates to your MQEI product:
1. Log in as root (or use the command su).
2. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
3. If you are installing from CD then insert the maintenance CD
into the appropriate drive. If you are installing after
downloading the CSD from the World Wide Web then ensure you
are connected to the server containing the CSD.
4. To display the appropriate SMIT panel, either enter the
fastpath command:
smitty install_selectable_all
or if this is not available enter "smit" and and navigate to the
"Install and Update From All Available Software" panel.
5. On the panel displayed, you need to enter the device name
attached to your CD-ROM reader or server, and the directory in
which the maintenance resides. Use PF4 to get a list of
input devices.
6. Select "SOFTWARE to install". To install the maintenance, press
PF4 for a list and select "mqei".
7. It is recommended that you use the displayed default values for
all other fields, except for "COMMIT software" which you should
set to "no", and "SAVE replaced files" which you should set to
"yes". This will apply the PTF, and save a backup copy of
your installation. At a later time, you will be able to
choose to commit the PTF updates, or reject the PTF updates and
return to the backup level. If you change the "COMMIT software"
value to "yes" then no backup copy is saved and the PTF will be
permanently applied. When you are ready click "OK" or press
ENTER.
8. To start the update click "OK" or press ENTER when the
confirmation message appears. The command will run, terminating
with an Installp Summary table confirming which components of
MQEI have been updated. If the command does not complete
successfully, then a full error log is saved in the file
smit.log in your HOME directory.
B) Restoring the Previous Backup Version
-------------------------------------
If you need to restore from backup, to the previous level of
maintenance:
1. Log in as root (or use the command su).
2. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
3. To display the appropriate SMIT panel, either enter the
fastpath command:
smitty install_reject
or if this is not available enter "smit" and and navigate to the
"Reject Applied Software Updates (Use Previous Version)" panel.
4. Select "SOFTWARE name". To reject the maintenance, press PF4
for a list and select "mqei".
5. It is recommended that you use the displayed default values for
all other fields. This will reject the current PTF level, and
re-inistate the previous install level. When you are ready
click "OK" or press ENTER.
6. To start the reject click "OK" or press ENTER when the
confirmation message appears. The command will run, terminating
with an Installp Summary table confirming which components of
MQEI have been rejected.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
INSTALLATION AND MAINTENANCE INFORMATION FOR SOLARIS
----------------------------------------------------
A) Applying Maintenance
--------------------
The installation process for this PTF requires 5MB of disk space
for the PTF and a further 5MB of disk space in the /var/sadm/pkg
directory to save the previous level. This allows a PTF to be
removed, and the previous level is 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
However, 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 reapply a previous
cumulative PTF image.
To apply maintenance updates to your MQEI product:
1. Log in as root (or use the command su).
2. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
3. If you are installing from CD then insert the maintenance CD
into the appropriate drive. If you are installing after
downloading the CSD from the World Wide Web then ensure you
are connected to the server containing the CSD.
4. If you are installing from CD, check to see if the Volume
Manager is running. If it is running, the CD is mounted on
/cdrom/domino_mq automatically. Otherwise mount the CD by
typing the following commands:
mkdir -p /cdrom/dom_mqcsd1
mount -F hsfs -r /dev/dsk/cntndnsn /cdrom/dom_mqcsd1
substituting cntndnsn with the name of your CD_ROM device.
5. Use the pkgadd command to install the maintenance as follows:
pkgadd -d /<cd_mount_point>/solaris/mqei-U200085.image
substituting <cd_mount_point> with cdrom/dom_mqcsd1 or the
server directory in which the CSD is available to you.
6. When prompted to select package(s) to process, type "1" or
"all" and press ENTER.
B) Restoring the Previous Backup Version
-------------------------------------
If you need to restore from backup, to the previous level of
maintenance:
1. Log in as root (or use the command su).
2. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
3. Use the pkgrm command to remove the latest PTF update:
pkgrm mqei_upd1
Errors displayed of the form <shared pathname not removed>
are of type "warning" and can be ignored.
4. When prompted to remove type "y" and press ENTER.
5. Press ENTER to confirm.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
INSTALLATION AND MAINTENANCE INFORMATION FOR HP-UX
--------------------------------------------------
A) Applying Maintenance
--------------------
This PTF requires approximately 5MB of disk space for
installation. The installation process requires another 5MB of
disk space to save the previous level. This allows a PTF to be
removed, and the previous level is 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
However, 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.
To apply maintenance updates to your MQEI product:
1. Log in as root (or use the command su).
2. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
3. If you are installing from CD then insert the maintenance CD
into the appropriate drive. If you are installing after
downloading the CSD from the World Wide Web then ensure you
are connected to the server containing the CSD.
4. Use the swinstall command to install the maintenance as follows:
swinstall -s/<cd_mount_point>/hp/hp-U200085.v10
substituting <cd_mount_point> with the name you mounted your
CD_ROM device as, or the server directory in which the CSD is
available to you.
5. Select "MQEI", use the "Action" pulldown and select
"Mark for install", then use the "Action" pulldown again and
select "Install".
6. On the next panel displayed select "OK", then select "YES" when
the confirmation panel is displayed.
7. When complete select "Done" to complete the install. If the
command does not complete successfully, you can select "Logfile"
to view any errors reported. To exit the install utility
select the "File" pulldown then select "Exit".
B) Restoring the Previous Backup Version
-------------------------------------
If you need to restore from backup, to the previous level of
maintenance:
1. Log in as root (or use the command su).
2. Ensure that MQEI is not in use by Notes or Domino. You may
have to terminate Notes or Domino to achieve this.
3. Use the swremove command to remove the maintenance from
the system.
4. Select "MQEI update B.10.1000.01", use the "Action" pulldown
and select "Mark for remove", then use the "Action" pulldown
again and select "Remove".
5. On the next panel displayed select "OK", then select "YES" when
the confirmation panel is displayed.
6. When complete select "Done" to complete the remove. If the
command does not complete successfully, you can select "Logfile"
to view any errors reported. To exit the remove utility
select the "File" pulldown then select "Exit".
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
INSTALLATION AND MAINTENANCE INFORMATION FOR WINDOWS 3.1
--------------------------------------------------------
A) Applying Maintenance
--------------------
This PTF requires approximately 11MB of disk space to save the
previous level. This allows a PTF to be removed, and the previous
level automatically restored.
To apply maintenance updates to your MQEI product:
1. Ensure that MQEI is not in use by Notes or Domino.
2. If you are installing from CD then insert the maintenance CD
into the appropriate drive. If you are installing after
downloading the CSD from the World Wide Web then ensure you
are connected to the drive containing the CSD.
3. From Windows Program Manager select the "File" pulldown,
select "Run", then type "<drive>:\win16\mqeicsd1\setup" where
<drive> is the drive letter you are installing from and click OK.
4. You will be presented with the "Welcome" dialog. Select the
"Next>" button.
5. Confirm the directory that MQEI is installed in, then select
the "Next>" button.
6. When prompted with the prompt "Do you wish to backup the
current version of the product?", it is recommended that you
reply "Yes".
7. Select the backup directory (it is recommended that you leave
the default directory), and then select the "Next>" button.
8. From the "Start Copying Files" dialog, verify that the
information displayed matches your requested choices, and then
select the "Next>" button to proceed.
9. Select the "Finish" button to complete the installation of
the CSD.
B) Restoring the Previous Backup Version
-------------------------------------
If you need to restore from backup, to the previous level of
maintenance:
1. Ensure that MQEI is not in use by Notes or Domino.
2. Open the MQSeries Enterprise Integrator folder, and
double-click on the "Remove CSD01" icon.
3. If the CSD has been applied with rollback, you are given
the option to uninstall the most recent CSD or uninstall
the entire product. Select "Uninstall last CSD" then
select the "Remove" button to remove the most recent CSD
and return the installation to the state it was in before
the CSD was applied.
Notes:
1. The "Remove CSD01" icon is NOT removed from the folder
upon successful completion of the operation.
C) Querying the Service Level
--------------------------
Open the MQSeries Enterprise Integrator folder, and select the
memo.ptf file.
This shows the memo.ptf file containing the service level and
details of the maintenance applied (PTF number). This file is
also included in the root directory of the CD-ROM.