Responding to errors

Table 7 below describes error messages generated by the Installer. The middle column explains the message. The last column suggests responses to the error message.

Table 7. Installer error messages
Message Explanation Potential Solution
BIA01001: Installation aborted. Product_name is not supported on this operating system. You attempted to perform a silent installation to an unsupported platform. This message is written to the installationError.log file. Run installer on a supported platform.
BIA01002: You have attempted to install Product_name on an unsupported platform. Refer to Installing WebSphere Business Integration Adapters. You attempted to perform an interactive installation to an unsupported platform. This message is displayed on an Installer panel. Run installer on a supported platform.
BIA01003: Installation aborted. The user name does not belong to the local "Administrators" group or the user login exceeds 20 characters. This message is written to the installation Error.log file during silent installation on Windows machines. Log in using a user name that belongs to an Administrator group and does not exceed 20 characters before performing silent installation.
BIA01004: The installation program cannot continue for one of the following reasons: 1. The user name does not belong to the local "Administrators" group. 2. The user login exceeds 20 characters (The 20-character limit is required for use with IBM WebSphere MQ 5.3) Refer to the System Installation Guide for Windows for more information. This message is displayed on an Installer panel during an interactive installation. Log in using a user name that belongs to an Administrator group and does not exceed 20 characters before performing an interactive installation.
BIA01005: The directory path must not contain any spaces. This message is displayed on an error dialog during an interactive install. Remove the space character from directory path.
BIA01006: The directory you selected does not contain a compatible version of the Adapter Framework. This message is displayed on an error dialog during an interactive adapter/data handler installation. Adapters and Data Handlers are required to install to the location where Adapter Framework is installed. Enter the fully qualified path to an installed, compatible version of Adapter Framework.
BIA01007: Installation aborted. IBM WebSphere Business Integration Data Handler for XML must be installed prior to the installation of Product_name. This message is written to the installation Error.log file during a silent installation. The XML data handler is a prerequisite for some adapters. Install the data handler before installing the adapter.
BIA01008: You must install IBM WebSphere Business Integration Data Handler for XML before installing Product_name. This message is displayed on an installer panel during an interactive installation. The XML data handler is a prerequisite for some adapters. Install the data handler before installing the adapter.
BIA01009: The InterChange Server name cannot exceed 80 characters. This message is displayed on an error dialog during an interactive installation. (ICS server name panel). Enter an ICS name that is less than 80 characters.
BIA01010: The InterChange Server name cannot contain spaces. Please enter a valid InterChange Server name. This message is displayed on an error dialog during an interactive installation (ICS server name panel). Enter an ICS name that does not contain space characters.
BIA01011: The InterChange Server name cannot begin with a number. This message is displayed on an error dialog during an interactive installation (ICS server name panel). Use an ICS name that starts with an English alphabetical character.
BIA01012: The InterChange Server name must begin with a English alphabet. This message is displayed on an error dialog during an interactive installation (ICS server name panel). Use an ICS name that starts with an English alphabetical character.
BIA01013: Only English alphabets and numeric characters are allowed in the InterChange Server name. This message is displayed on an error dialog during an interactive installation (ICS server name panel). Use an ICS name that contains numbers 0 through 9 and English alphabetical characters only.
BIA01014: Product_name successfully installed. Return code: installer_return_code Written to installation log file.
BIA01015: Product_name installation failed. Return code: installer_return_code Written to installation log file.
BIA01016: Product_name successfully uninstalled. Return code: installer_return_code Written to installation log file.
BIA01017: Product_name uninstall failed. Return code: installer_return_code Written to installation log file.
BIA01018: This installation program requires Java Runtime Environment 1.4 or later to run correctly. Please install the required JRE and then launch this installation program again. This message is displayed on an error dialog during an interactive installation. Use a Java 1.4 or higher JRE to launch the installer. For example:<jre 1.4>/bin/java -jar setup.jar
BIA01019: Installation aborted. This installation program requires Java Runtime Environment 1.4 or later to run correctly. Please install the required JRE and then launch this installation program again. This message is written to the installation Error.log file during a silent installation. Use a Java 1.4 or higher JRE to launch the installer. For example:<jre 1.4>/bin/java -jar setup.jar -options settings.txt -silent
BIA01020: The install location does not contain a compatible version of the Adapter Framework. This message is written to the installation Error.log file during a silent installation. Adapters and data handlers are required to install to a location where a compatible version of Adapter Framework is installed. Enter the fully qualified path to an installed and compatible version of Adapter Framework in the silent response file.
BIA01021: The install location path must not contain any spaces. This message is written to installation Error.log file during a silent installation. Remove space character(s) from the install location property in the silent response file.
BIA01022: Installation aborted. The user name does not belong to the local "Administrators" group. This message is written to the installation Error.log file during a silent installation. Log in using a user id that belongs to an Admin group on Windows before performing the installation.
BIA01023: The installation cannot continue because the user name does not belong to the local "Administrators" group. This message is displayed on an installer panel during an interactive installation. Log in using a user id that belongs to an Admin group on Windows before performing the installation.
BIA01024: Installation aborted. IBM WebSphere Business Integration Adapter for WebSphere MQ must be installed prior to the installation of Product_name. This message is written to the installation Error.log file during a silent installation. Install the Adapter for WebSphere MQ before running this installer.
BIA01025: You must install IBM WebSphere Business Integration Adapter for WebSphere MQ before installing Product_name. This message is displayed on an installer panel during an interactive installation. Install the Adapter for WebSphere MQ before running this installer.
BIA01026: No component was selected for installation. Click the "Back" button to return to the product feature panel or click Cancel to exit this installation. This message is displayed on an installer panel during an interactive installation. Select a component to install on the feature panel.
BIA01027: Installation aborted. No component was selected for installation. This message is written to the installation Error.log file during a silent installation. Set at least one product component to active in the silent installation response file.
BIA01028: A previous version to IBM WebSphere Business Integration Adapter Framework 2.6.0 is installed on your system. It is recommended that you uninstall the existing Adapter Framework version before you install version 2.6.0. Click Cancel to exit this installation to uninstall the earlier version, or click Next to continue. For instructions on how to migrate adapters to this new version, see the guide Migrating Adapters to Adapter Framework, Version 2.6.0. This message is displayed on an installer panel during an interactive installation.
BIA01029: IBM WebSphere InterChange Server 4.2.2 is installed on your system. It is recommended that you installProduct_name on a separate system. Click Cancel to exit the installation or click Next to continue. For instructions on how to migrate adapters to this new version, see the guide Migrating Adapters to Adapter Framework, Version 2.6.0 This message is displayed on an installer panel during an interactive installation.
BIA01030: Product_name is not compatible with the version of IBM WebSphere InterChange Server installed on your system. Product_name is compatible with IBM WebSphere InterChange Server 4.2.2 or higher. If using IBM WebSphere InterChange Server 4.2.2 then it is recommended that you install Product_name on a separate system. This message is displayed on an installer panel during an interactive installation.
BIA01031: Installation aborted. Product_name is not compatible with the version of IBM WebSphere InterChange Server installed on your system. Product_name is compatible with IBM WebSphere InterChange Server 4.2.2 or higher. If using IBM WebSphere InterChange Server 4.2.2 then it is recommended that you install Product_name on a separate system. This message is written to the installation Error.log file during a silent installation.
BIA01032: IBM WebSphere Business Integration Adapters, Development Kit and Data Handlers must be uninstalled before uninstalling the IBM WebSphere Business Integration Adapter Framework. Ensure these components are removed from your system before continuing with this uninstall program. This message is displayed on an installer panel during an interactive uninstall. Uninstall all other adapter components before uninstalling the adapter framework.
BIA01033: A previous version to IBM WebSphere Business Integration Adapter Framework 2.6.0 is installed in this location. You must select an alternate install location. This message is displayed on an installer panel during an interactive uninstall. Change the install location of the adapter framework.
BIA01034: Installation aborted. A previous version to IBM WebSphere Business Integration Adapter Framework 2.6.0 is installed in this location. You must select an alternate install location. This message is written to the installation Error.log file during a silent installation. Change the install location of adapter framework in the silent installation response file.
BIA01035: IBM WebSphere InterChange Server is installed in this location. You must select an alternate install location. This message is displayed on an installer panel during an interactive uninstall. Change the install location of the adapter framework.
BIA01036: Installation aborted. IBM WebSphere InterChange Server is installed in this location. You must select an alternate install location. This message is written to the installation Error.log file during a silent installation. Change the install location of adapter framework in the silent installation response file.
BIA01037: The directory you entered is not valid. Enter a valid directory. This message is displayed on an installer panel during an interactive uninstall. Enter an existing valid directory path.
BIA01038: Installation aborted. IBM WebSphere MQ 5.3 Java library path option in the silent installation response file is invalid. This message is written to the installation Error.log file during a silent installation. Enter an existing valid directory path for MQ 5.3 Java library option in the silent installation response file.
BIA01039: Installation aborted. IBM WebSphere Studio Workbench location option in the silent installation response file is invalid. This message is written to the installation Error.log file during a silent installation. Enter an existing valid directory path for the Workbench option in the silent installation response file.
BIA01040: Installation aborted. IBM WebSphere Application Server Application Clients location option in the silent installation response file is invalid. This message is written to the installation Error.log file during a silent installation. Enter an existing valid directory path for the WAS client option in the silent installation response file.
BIA01041: Installation aborted. IBM Tivoli Monitoring for Transaction Performance Management Agent location option in the silent installation response file is invalid. This message is written to the installation Error.log file during a silent installation. Enter an existing valid directory path for the ITMTP agent option in the silent installation response file.
BIA01042: IBM WebSphere Adapter Framework 2.6.0 is not found in the location you entered. Adapter Framework 2.6.0 must be installed before installing this Adapter Framework 2.6.0.3 (Fixpack 3). Please select a valid directory. Adapter Framework 2.6.0.3 must be applied to the same directory as Adapter Framework 2.6.0, which you must install first. Apply the fix pack to the directory where Adapter Framework 2.6 is installed, or install Adapter Framework 2.6 first.
BIA01045: Adapter Framework 2.6 is installed on this machine. If you choose to continue installing this version of Adapter Framework, Adapter Framework 2.6 may no longer work. Click Yes to continue installation. The new version of Adapter Framework will overwrite some files of the older version. It's prudent to back up the older version files.
BIA01046: The configuration file path you specified is not valid. Usage: reg_<adapter_name>.bat <absolute path to config file> <dependent services> The configuration file you provided does not reside in the file system. Provide a valid configuration file.
BIA01047: Usage: reg_<adapter_name>.bat <path to config file> <optional dependent service> You need to enter one or two parameters after the .bat file name. The first parameter is the configuration file, which is required. The second, optional, parameter is the prerequsite windows service. Provide the first parameter--the name of the configuration file.
BIA01048: The login name does not belong to the local "Administrators" group. You do not have the permission to register a Windows service. You did not login as a member of a Windows administrators group, so you do not have the permission to register a Windows service. Login in as an administrator.
BIA01049: Register Windows service failed. Register Windows service failed. Was the Adapter Framework Fix Pack 2.6.0.3 applied correctly? Has the Windows service already been registered?
BIA01050: Register Windows service succeeded. The Windows service was successfully registered.
BIA01044: This IBM WebSphere InterChange Server name field cannot be blank if you selected "Create Windows Service (IBM WebSphere InterChange Server)". If you are using a different broker and want to register a Windows Service for the adapter, see the note on this installation panel. If you want to register a Windows service for InterChange Server, you must provide the InterChange Server name during installation. If you want to register Windows service for other brokers, you can do so after installation. Provide the InterChange Server name, or deselect the check box.

Copyright IBM Corporation 2003, 2005. All Rights Reserved.