[Windows]

AMQ47xx IBM MQ Windows installation messages

AMQ4xxx messages that relate to installing IBM® MQ on Windows.

AMQ4705
Current maintenance level is '%s'. Re-apply maintenance after Setup completes. (AMQ4705)
Explanation
When adding a new feature to an installation, it will be installed at the original installation's service level (e.g. 9.2.0.0). If you had installed fix pack(s) on top of this, the new and old code will be out of step and this warning prompts you that further action is required.
Response
You must reapply the most recently applied fix pack to get the new installable feature up to the same maintenance level as the rest of the product.
AMQ4716
The MQ update has stopped. You must install the Microsoft Visual Studio 2013 C/C++ runtimes before updating this client installation. Consult IBM Documentation for further information. (AMQ4716)
Explanation
Applying a maintenance update to MQ pre-V9.2, the required Microsoft C/C++ runtimes could not be found or the installer's offer to install them for you was not accepted.
Response
Download the C/C++ Visual Studio 2013 redistributables and install them yourself, before repeating the update. These are required for the continuing operation of MQ.
AMQ4729
You cannot install the MQI Client from the client CD because IBM MQ server components are already installed on this computer. To install the MQI Client on this computer, use the server CD. (AMQ4729)
Explanation
A server installation requires server install media to update, even when adding those features that also exist on the client media.
Response
Retry using the server install media.
AMQ4732
No installation language specified. Use the TRANSFORMS property. (AMQ4732)
Explanation
When using msiexec to run a silent or command line install, you must use the TRANSFORMS property to specify the installation language.
Response
Retry, supplying the TRANSFORMS property value as described in the IBM Documentation page "Using transforms with msiexec". For example, 1033.mst for U.S. English.
AMQ4733
Unable to launch program '%s'. (AMQ4733)
Explanation
After installing MQ, the MQ configuration wizard should immediately start. In this case an error occurred, and it could not start.
Response
Open the installation log, search for AMQ4733 and review the immediately preceding messages to discern the reason for the failure.
AMQ4734
Can't open file '%s'. (AMQ4734)
Explanation
The MQ configuration wizard INI file does not exist.
Response
Correct the INI file name you supplied and retry.
AMQ4740
Unknown feature(s) '%1' in command-line property '%2'. (AMQ4740)
Explanation
One of the properties you supplied contains an invalid feature name. The insert %1 is the name of the invalid feature and the insert %2 is the property if was found in (e.g. 'ADDLOCAL').
Response
Fix your msiexec command and retry.
AMQ4742
Unknown feature(s) '%1' in property '%2' in '%3'. (AMQ4742)
Explanation
One of the properties you supplied contains an invalid feature name. The insert %1 is the name of the invalid feature and the insert %2 is the property if was found in (e.g. 'ADDLOCAL'). The insert %3 is the name of the INI file in which the error was found.
Response
Fix your INI file and retry.
AMQ4752
Install cannot proceed as the Windows version is unsupported and MQ would not function. (AMQ4752)
Explanation
Some Windows versions are reported as not supported and you are strongly advised not to use them, but Windows 7 and earlier versions of Windows are not supported and will definitely not work with MQ v9.1 and above, so MQ will not permit installs on Windows 7 (and earlier versions of Windows).
Response
Consult the System Requirements page for IBM MQ, which lists the supported versions of Windows for this release and install on one of those. The System Requirements can be found here: https://www.ibm.com/support/pages/system-requirements-ibm-mq
AMQ4757
IBM MQ files are in use. Stop activity and select Try Again or select Continue, which will require a reboot in order to complete successfully. (AMQ4757)
Explanation
When applying a fix pack, the system has discovered that IBM MQ files are in use and so cannot be updated.
Response
Either
  • Stop the processes still using IBM MQ and click 'Try Again' or
  • Click 'Continue', but be aware that a reboot will be required to complete the install
AMQ4763
Cannot overwrite IBM MQ Version %1 with Version %2. (AMQ4763)
Explanation
An attempt was made to perform an upgrade but the installation media being used to do the upgrade was a lower version than the code already on the system.
Response
Upgrades must be to a higher code level. Retry with suitable install media.
AMQ4765
This is a 32 bit program and cannot write files to the 64 bit program files directory. Please either use '%s' or choose an alternative location. (AMQ4765)
Explanation
This will only seen with IBM MQ v8 32-bit clients (and not the 64-bit client or 64-bit server also available at IBM MQ v8). 32 bit programs cannot install into "Program Files" but should go in "Program Files (x86)" instead.
Response
Install 32-bit programs into a suitable 32-bit location like "Program Files (x86)".
AMQ4769
Invalid Installation Name. The name '%1' is invalid, it must be a maximum of 16, a-z, A-Z, 0-9 characters only. (AMQ4769)
Explanation
The list of characters specified in an Installation name is restricted to those listed in the message.
Response
Correct the requested installation name and retry.
AMQ4770
Invalid Installation Name. The name '%1' is reserved and cannot be specified for the Installation name. (AMQ4770)
Explanation
'Installation0' and 'CurrentVersion' are reserved for system use.
Response
Choose another installation name and retry.
AMQ4771
Invalid Installation Name. The name '%1' is already in use and cannot be specified for the Installation name, select a new unique name. (AMQ4771)
Explanation
The Insert %1 shows the installation name you requested but this name already exists.
Response
Please select a different (unused) installation name and retry.
AMQ4772
Invalid Installation Description. The description is larger than the 64 characters permitted. (AMQ4772)
Explanation
The installation description field has a maximum length of 64 characters.
Response
Select a shorter installation description and retry.
AMQ4773
Setup cannot continue as migration from this earlier release of the product is not supported. (AMQ4773)
Explanation
You cannot upgrade from the version of IBM MQ on the system to the one you are attempting to install. This is not supported.
Response
If you wish to upgrade a very old version of MQ to a very new level, you may have to upgrade to a level in-between them first, for example MQ v7.1.
AMQ4774
Supplied InstallationName '%1' does not match actual name '%2' (AMQ4774)
Explanation
The attempt to upgrade or modify the installation has failed because the installation name was not correct for that installation.
Response
Correct the installation name and retry.
AMQ4776
This installation is not permitted to upgrade installation 'Installation1' (AMQ4776)
Explanation
When attempting to upgrade MQ from one version to another, you are informed that this is not possible. The possible reasons for this are:
  • You attempted to install an MQ version of pre-V7.1 to V7.1+.
  • You attempted to upgrade a server installation with using client install media.
  • You attempted to downgrade an installation using install media from a previous version.
Response
When upgrading MQ, ensure that:
  • You are upgrading from a client to a later client version or
  • You are upgrading from a client to a later server version or
  • You are upgrading from a server to a later server version
AMQ4777
Failed to assign installation identifier to installation '%1', perhaps too many installations already? (AMQ4777)
Explanation
On creation of a new installation, it appears that all 127 installations have been used.
Response
Consider if any of your previous installations may be deleted before installing this new one.
AMQ4778
Cannot proceed as installed product has no associated MQ Installation name (AMQ4778)
Explanation
An error has occurred while trying to read the installation details for the supplied installation name.
Response
Check the installation name was correct and retry.
AMQ4779
Cannot install in same location as WebSphere MQ Telemetry 7.0.1. Either uninstall this before installing IBM MQ or choose a different destination. (AMQ4779)
Explanation
The install location you chose contains a version of WebSphere MQ Telemetry. You may not install there.
Response
Either uninstall WebSphere MQ Telemetry v7.0.1 and retry or select a different install location and retry.
AMQ4780
Invalid Installation Path. The path '%s' is already in use and cannot be specified for the installation path, select a different path. (AMQ4780)
Explanation
You have selected an installation path that is already in use by another MQ installation (or possibly another product).
Response
Please select an empty location and retry.
AMQ4781
No suitable IBM MQ installation found. Fix pack %s may not be applied to any of the IBM MQ installations on this machine. (AMQ4781)
Explanation
While applying a fix pack the fix pack installer has scanned the installations currently on the system (if any exist) and determined that it cannot be applied to any existing MQ installation. Fix packs can only be applied to:
  • MQ installations of the same version and release (i.e. fix pack 9.2.0.1 can only be applied to MQ v9.2)
  • MQ installations of an equal or lower fix pack pack level (i.e. fix pack 9.2.0.2 can only be applied to an installation at levels 9.2.0.2, 9.2.0.1, or 9.2.0.0. It cannot be applied to an installation already at 9.2.0.3 or higher)
Response
Download the correct fix pack for your release and retry.
AMQ4782
Cannot remove fix pack '%s'. This machine does not have a IBM MQ installation at service level '%s'. (AMQ4782)
Explanation
You attempted to remove fix pack n.n.n.n, however, no installation on the system is at level n.n.n.n.
Response
Remove the correct fix pack level. (Note: only the most recently applied service update level can be removed from an installation. So if you have installed 9.2.0.0 and updated to fix pack 9.2.0.1 and then 9.2.0.2, you can only remove 9.2.0.2. Once that has been removed you may then remove the 9.2.0.1 fix pack.)
AMQ4783
Supplied installation path '%1' does not match actual installed path '%2' (AMQ4783)
Explanation
It is likely that you are uninstalling a multiversion MQ installation but have incorrectly specified the TRANSFORMS parameter. This error is a check to ensure that you do not accidentally remove the wrong MQ installation.
Response
Correct the TRANSFORMS parameter and try again.
AMQ4784
The existing pre-7.0.1.6 installation cannot coexist or be upgraded by this installation (AMQ4784)
Explanation
A single installation of MQ v7.0.1 must be updated at least to v7.0.1.6 before it will allow a multi-version installation alongside it.
Response
Update your existing v7.0.1 server to v7.0.1.6 or higher before trying to install another MQ installation alongside it.
AMQ4785
Cannot change installation name (AMQ4785)
Explanation
The Installation name cannot be changed as part of an upgrade to a later MQ release except when the original installation name was Installation0 which is reserved for the single allowed MQ v7.0.1 installation.
Response
Do not specify a new Installation name on upgrade unless upgrading from MQ v7.0.1.
AMQ4786
Cannot upgrade multiple products. Please provide an installation name (AMQ4786)
Explanation
When performing an upgrade, you must specify which installation you wish to upgrade.
Response
Retry, selecting which installation you wish to upgrade.
AMQ4794
After reboot you should issue the following command to make installation '%s' primary again: '%s\\%s\\setmqinst -n %s -i' (AMQ4794)
Explanation
At a patch, files were in use and a reboot is required. As the installation was a primary installation, the user must set it to primary again after reboot, using the command supplied in this message.
Response
After reboot, run the specified command.
AMQ4795
Installation '%s' appears to be in use. Please close down any queue managers, listeners and applications using this installation then click 'Try Again'. Click 'Continue' to continue without stopping (may require reboot) or 'Cancel' to exit. (AMQ4795)
Explanation
The fix pack applier (amqicsdn.exe) has found that files requiring an update are in use and cannot be updated. You have the choice of:
  • Stopping the active processes yourself and then clicking 'Try Again' (which runs the scan for in use files again.) or
  • Clicking Continue to go ahead with the update anyway (Note: this will require a reboot to complete the fix pack update).
  • Clicking Exit to stop running the fix pack applier.
Response
Choose one of the above options.
AMQ4796
Install failed, unable to open log file %s (%d). (AMQ4796) Press any key to continue.
Explanation
The log did not open successfully. Silent install cannot continue without a log file and so the install fails.
Response
Check the value specified in the response file for MQPLOG. Correct this to a file name and location that can be written to and retry.
AMQ4797
Unable to open log file %s (%d). Please ensure that there is only one copy of this program running. Do you wish to continue without a log? (AMQ4797)
Explanation
If you are running two copies of the fix pack applier program (amqicsdn.exe) then the second will be unable to open the log.
Response
Do not run two copies of the fix pack applier program at the same time (this is unsupported and probably harmful to your MQ installation(s).)