DBT3500E The db2prereqcheck command failed because the db2prereqcheck utility could not find the XML resource file.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

You can define the releases of DB2 database for which you want to verify installation prerequisites in an XML resource file. This message is returned when the db2prereqcheck utility cannot find the specified XML resource file or the default XML resource file.

User response

Perform one of the following actions:

  • Specify the XML resource file using the -f parameter with the db2prereqcheck command.
  • If you did not specify the XML resource file using the -f parameter, check to see if the default XML resource file exists in the default installation directory.

DBT3501E The db2prereqcheck utility could not open the following file: file-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot open a file during normal processing. Because the db2prereqcheck utility runs with the same privileges as the user who ran the db2prereqcheck command, this message can be returned when the user who ran the db2prereqcheck command does not have read and write permission for the named file.

User response

Respond to this message in one of the following ways:

  • Modify the permissions of the named file so that your user id has read and write permission for the file.
  • Log in to your system with a user ID that has read and write permission on the file.
  • Ask someone who has read and write permission on the file to run the db2prereqcheck command.

DBT3502E The db2prereqcheck utility failed to verify installation prerequisites because an invalid version was specified in the XML resource file.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

You can define the releases of DB2 database for which you want to verify installation prerequisites in an XML resource file. This message is returned when an invalid version is specified in the XML resource file.

User response

Correct the XML resource file and run the db2prereqcheck command again.

DBT3503E The db2prereqcheck command failed because an invalid parameter was specified.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when an invalid parameter is specified with the db2prereqcheck command.

User response

  1. Review the db2prereqcheck command syntax.
  2. Run the db2prereqcheck command again, specifying valid parameters.

DBT3504E The db2prereqcheck utility failed to verify installation prerequisites because the utility was unable to determine the level of the operating system.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot determine the current level of the operating system.

User response

Perform one of the following actions:

  • Review operating systems that are supported with DB2 database and the db2prereqcheck utility.
  • Manually retrieve or look up the operating system level.

DBT3505E The db2prereqcheck utility was unable to determine the Linux distribution level.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot determine the distribution level of the current Linux operating system. There are several reasons why the utility might be unable to determine the distribution level. For example, the utility might be unable to determine the distribution level if the utility cannot find or read the system file called /etc/issue.

The db2prereqcheck utility cannot perform all of the the necessary prerequisite verification steps without knowing the distribution level of the current Linux operating system. In order for the db2prereqcheck utility to be used to verify installation prerequisites, the problem that prevented the utility from determining the distribution level must be resolved.

User response

To enable the db2prereqcheck utility to determine the distribution level of the current Linux operating system, perform the following actions:

  • Ensure that the system file called /etc/issue exists.
  • Ensure that the system file called /etc/issue contains distribution level details.
  • Run the db2prereqcheck command as a user who has read permission for the system file called /etc/issue.

DBT3506E The db2prereqcheck utility encountered errors while running an rpm command.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

While verifying installation prerequisites, the db2prereqcheck utility uses the Resource Package Manager utility. This message is returned when the db2prereqcheck utility call the rpm command and that rpm command fails.

User response

  1. Determine the cause of the rpm failure by reviewing diagnostic information in the db2prereqcheck report file.
  2. Resolve the cause of the rpm failure.
  3. Call the db2prereqcheck command again.

DBT3507E The db2prereqcheck utility failed to find the following package or file: package-or-file-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot find the named package or file while the utility is verifying installation prerequisites.

User response

To review the diagnostic report file, run db2prereqcheck with -o option. By default, prerequisite validation is displayed on screen.

DBT3508E The db2prereqcheck utility encountered an unhandled error.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility encounters an error that the utility cannot classify or resolve.

User response

  1. Run with db2prereqcheck -o option.
  2. Identify the cause of the problem by reviewing diagnostic information in the db2prereqcheck report file.
  3. Resolve the cause of the problem.
  4. Run the db2prereqcheck command again.

DBT3509E The db2prereqcheck utility was unable to determine the version of the following package: package-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility needs to determine the version of a package to verify installation prerequisites, but the utility cannot determine the version of the package.

User response

Review the list of operating systems and software that are supported with DB2 database manually.

DBT3510E The db2prereqcheck utility was unable to find the following required library file: library-file-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot find a library file that is required to verify installation prerequisites.

User response

Manually verify that the installation prerequisites are met.

DBT3511E The db2prereqcheck utility was unable to find the following map file: map-file-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot find a map file that is required to verify installation prerequisites.

User response

Verify manually whether installation prerequisites are met.

DBT3512W The db2prereqcheck utility failed to determine the currently-installed version of the C++ standard library, libstdc++.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The current system might meet installation prerequisites even if the db2prereqcheck utility cannot determine the version of the C++ standard library that is installed.

User response

Manually verify that the system has the required version of C++ standard library.

DBT3513W The db2prereqcheck utility failed to determine the version of the currently-installed C++ standard library, libstdc++, using the ldconfig utility.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility uses several different methods for determining the current version of the C++ standard library. This message is returned when the db2prereqcheck utility attempts to determine the version of the currently-install C++ standard library using the ldconfig utility.

The current system might meet installation prerequisites even if the db2prereqcheck utility cannot determine the version of the C++ standard library that is installed.

User response

Manually verify that the system has the required version of C++ standard library.

DBT3514W The db2prereqcheck utility failed to find the following 32-bit library file: library-file-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot find the 32-bit version of a required library file. If the named file is missing, 32-bit database applications might not function properly.

User response

Respond to this message in one of the following ways:

  • If you do not intend to use 32-bit applications with DB2 database, then no response is required.
  • If you do intend to use 32-bit applications with DB2 database, ensure that the named 32-bit library file exists on the system before installing DB2 database.

DBT3515E The db2prereqcheck utility failed to determine the version of the currently-installed C standard library, glibc.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Verify manually whether installation prerequisites are met.

DBT3516E The db2prereqcheck utility was unable to execute the following command: command.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility attempts to execute a command to verify installation prerequisites, but the command fails.

User response

Verify manually whether the installation prerequisites are met.

DBT3517E The db2prereqcheck utility could not read the following file: file-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot read a file during normal processing. Because the db2prereqcheck utility runs with the same privileges as the user who ran the db2prereqcheck command, this message can be returned when the user who ran the db2prereqcheck command does not have read and write permission for the named file.

User response

Respond to this message in one of the following ways:

  • Modify the permissions of the named file so that your user id has read and write permission for the file.
  • Log in to your system with a user ID that has read and write permission on the file.
  • Ask someone who has read and write permission on the file to run the db2prereqcheck command.

DBT3518E The db2prereqcheck utility was unable to determine the AIX service pack level.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Manually verify that the system has the required AIX service pack level.

DBT3519E The db2prereqcheck utility was unable to determine the AIX Technology Level (TL).

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Manually verify that the system has the required AIX Technology Level (TL).

DBT3520E The db2prereqcheck utility could not find the library file libaio.so.1.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Verify manually whether the installation prerequisites are met.

DBT3521E The db2prereqcheck utility was unable to determine the version of the library libibmc++.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Verify manually whether the prerequisites are met.

DBT3522E The db2prereqcheck utility could not find the following patch: patch-identifier.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Verify manually whether the installation prerequisites are met.

DBT3523E The db2prereqcheck utility could not find the following required HP-UX bundles: bundle-names.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Verify manually whether installation prerequisites are met.

DBT3524E The db2prereqcheck utility determined that the current Windows operating system is not supported by the version that was specified in the XML resource file.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility determines that the version of the currently-install Windows operating system is not supported by one or more versions of DB2 database that were specified in the db2checkprereq XML resource file.

User response

To install DB2 database, change the Windows operating system to a version that is supported by DB2 database.

DBT3525E The db2prereqcheck command failed because the XML resources file is invalid.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

You can define the releases of DB2 database for which you want to verify installation prerequisites in an XML resource file. This message is returned when the db2prereqcheck utility cannot process the contents of the specified XML resource file or the default XML resource file.

User response

Correct the contents of the XML resource file and then run the db2prereqcheck command again.

DBT3526E The db2prereqcheck command failed because the value specified with the -o parameter is invalid.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility produces an output, report file that contains a log of the prerequisites checked and the success of the verification. There is a default report file name, but you can also specify the name of the report file using the -o parameter with the db2prereqcheck command.

This message is returned when the value specified with the -o parameter is not valid for a file name. For example, this message can be returned when the value specified with the -o parameter is not in a format that is valid for a file name.

User response

Respond to this message in one of the following ways:

  • Run the db2prereqcheck command again, specifying a valid file name with the -o parameter.
  • Use the default report file name by runing the db2prereqcheck command again, without specifying the -o parameter.

DBT3527E The db2prereqcheck command failed because the value specified with the -v parameter is invalid.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

You can specify a version using the -v parameter with the db2prereqcheck command.

This message is returned when a value is specified for the -v parameter with the db2prereqcheck command, but the specified value does not match any valid versions of DB2 database defined in the resource XML file.

User response

Call the db2prereqcheck command again, specifying a valid version with the -v parameter.

DBT3528E The db2prereqcheck command failed because the value specified with the -f parameter is invalid.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility reads information about which prerequisites to check from an input XML resource file. There is a default XML resource file name, but you can also specify the name of the XML resource file using the -f parameter with the db2prereqcheck command.

This message is returned when the file specified with the -f parameter is not in valid XML file or its content is not in the format recognized by db2prereqcheck tool.

User response

Respond to this message in one of the following ways:

  • Call the db2prereqcheck command again, specifying a valid XML resource file with the -f parameter.
  • Use the default XML resource file by calling the db2prereqcheck command again, without specifying the -f parameter.

DBT3529E The db2prereqcheck command failed because mutually exclusive parameters were specified. Mutually exclusive parameters that were specified: parameter-list.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

You can control what kinds of tests the db2prereqcheck utilty performs and the output format by specifying various parameters with the db2prereqheck command.

This message is returned when mutually exclusive parameters are specified with the db2prereqcheck command.

User response

Call the db2prereqcheck command again, specifying valid parameters.

DBT3530E The db2prereqcheck command failed because the -i parameter was specified with the command, but the db2prereqcheck utility could not determine the latest DB2 database version that is listed in the XML resource file.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

You can specify a version using the -v parameter with the db2prereqcheck command.

If you use an XML resource file that lists one or more versions of DB2 database, you can cause the db2prereqcheck utility to verify the installation prerequisites for only the latest version that is specified in the XML resource file by specifying the -i parameter with the db2prereqcheck command.

This message is returned when the -i parameter is specified with the db2prereqcheck command, but the db2prereqcheck utility failed to determine what the latest version is that is specified in the XML resource file contents. There are multiple reasons for which the db2prereqcheck utility might be unable to retrieve the latest version from the XML resource file, including the following reasons:

  • No DB2 database versions are specified in the XML resource file.
  • The format of the XML resource file is not valid.
  • The DB2 database versions that are specified in the XML resource file are not valid.

User response

  1. Perform the following troubleshooting steps:
    • Ensure that the format of the XML resource file is valid.
    • Ensure that one or more versions of DB2 database are correctly specified in the XML resource file.
  2. Call the command again in one of the following ways:
    • Verify prerequisites for the latest version that is defined in the resource XML file by calling the db2prereqcheck command with the -i option.
    • Verify prerequisites for all DB2 database versions that are defined in the resource XML file by calling the db2prereqcheck command without the -i option.

DBT3531E The db2prereqcheck utility failed to log the following message to the output report file: message-text.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility produces a report file that contains information about the installation prerequisites that were verified on the current system.

This message is returned when an error occurs while db2prereqcheck is attempting to print information to the report file.

User response

  1. Verify that the user has a write permission to the report file.
  2. Review the information in the message that could not be printed to the report file, and then consider that information when you review the information that is in the report file.

DBT3532E The db2prereqcheck utility determined that the database product that is being installed requires a 64-bit operating environment, but the current environment is a 32-bit environment.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

To install this database product, use a 64-bit operating environment.

DBT3533I The db2prereqcheck utility has confirmed that all installation prerequisites were met.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

No response is required.

DBT3535W The db2prereqcheck utility was unable to find the following InfiniBand support package: package_name.

Explanation

On Linux operating systems on an InfiniBand network or a 10 Gigabit Ethernet (10GE) RoCE network, specific InfiniBand Support packages are required. For a list of required packages, see the DB2 pureScale Feature installation prerequisites for Linux topic.

User response

To install the required InfiniBand software, run a group installation of the InfiniBand Support package using the yum command.

DBT3536E The db2prereqcheck utility was unable to find the following HPN package: package_name.

Explanation

On Linux operating systems on a 10 Gigabit Ethernet (10GE) RoCE network, specific High Performance Networking (HPN) packages are required. For a list of required packages, see the DB2 pureScale Feature installation prerequisites for Linux topic.

User response

To install the required HPN packages, run a group installation of the InfiniBand Support package using the yum command.

DBT3537W The db2prereqcheck utility was unable to find the following RDMA package: package_name.

Explanation

On Linux operating, specific remote direct memory access (RDMA) packages are required.

User response

Install the required RDMA packages.

DBT3538E The db2prereqcheck command failed because the value specified with the -t parameter is invalid.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

You can specify the type of network configuration for which the db2prereqcheck utility should verify prerequisites using the -t parameter. There are four valid values for the -t parameter:

  • SINGLE_IB_PORT_CLUSTER
  • MULTI_IB_PORT_CLUSTER
  • SINGLE_ROCE_PORT_CLUSTER
  • MULTI_ROCE_PORT_CLUSTER

This message is returned when an invalid value is specified for the -t parameter.

User response

Call the db2prereqcheck command again, specifying a valid value with the -t parameter.

DBT3539E The db2prereqcheck command failed because the -t parameter was specified but the -p parameter was not specified.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

You can verify installation prerequisites specifically for the DB2 pureScale environment by specifying the -p parameter. If you specify that the db2prereqcheck utility should verify the prerequisites for the DB2 pureScale environment, you can also specify the type of network configuration for which the db2prereqcheck utility should verify prerequisites using the -t parameter.

If you do not specify the -p parameter, the -t parameter must not be specified.

User response

Respond to this error in one of the following ways:

  • If you are verifying installation prerequisites for a DB2 pureScale environment, call the db2prereqcheck command again, specifying the -p parameter with or without the -t parameter.
  • If you are not verifying installation prerequisites for a DB2 pureScale environment, call the db2prereqcheck command again without specifying the -t parameter.

DBT3540E The db2prereqcheck command failed because the db2prereqcheck command is not supported on the current operating system level.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility requires the following minimum operating system levels:

  • AIX 6.1
  • HP-UX 11iv3
  • Solaris 10

User response

Run the db2prereqcheck command on a system with a supported operating system level.

DBT3541E An instance management task failed because the db2prereqcheck utility encountered an internal error which cannot be resolved.

Explanation

The database manager performs a variety of system validation steps, including using the db2prereqcheck utility, before installing the database product and before creating or managing database manager instances.

This message is returned when an unhandled error is encountered by the db2prereqcheck utility as part of those larger install or instance management operations.

User response

Contact IBM support for help with resolving this problem.

DBT3542E An instance management task failed because the db2prereqcheck utility encountered an internal error. Reason code: reason-code.

Explanation

The database manager performs a variety of system validation steps, including using the db2prereqcheck utility, before installing the database product and before creating or managing database manager instances.

The reason code indicates a specific reason for the error:

1

The database manager or the db2prereqcheck utility failed to open the file called "/etc/hosts".

2

The database manager or the db2prereqcheck utility failed to determine the IP address of the machine on which the cluster caching facility is located.

User response

Respond to this error by performing troubleshooting steps according to the given reason code:

Reason code 1

Ensure the system file called "/etc/hosts" exists, is accessible, and that the file contents are standard for a hosts file.

Reason code 2

Ensure that the host machines in the DB2 cluster are up and running, and the the network in the cluster is functioning normally.

DBT3543E The db2prereqcheck utility encountered an internal error while printing a message. Message number: message-number.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the utility encounters an error while printing a message in the current user language.

The failure to print one message might not affect the usefulness of the db2prereqcheck utility. However, if this error happens multiple times, this might indicate a problem with the installation of the db2prereqcheck utility.

User response

Respond to this error in one or more of the following ways:

  • Run the db2prereqcheck utility in English by setting the locale to English and then calling the db2prereqcheck command.
  • Download a new copy of the db2prereqcheck utility.

DBT3544E The db2prereqcheck utility failed to determine the level of the operating system by using the uname command.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility uses the system command, "uname", to determine the level of the current operating system. There are multiple reasons that the db2prereqcheck utility might be unable to determine the operating system level by using the uname command, including the following examples:

  • The call to the uname system command failed.
  • The output of the uname system command is not what the db2prereqcheck utility was designed to expect.

User response

Manually determine the version of the operating system and verify whether the current operating system version is supported with the database product being installed.

DBT3545E The db2prereqcheck utility encountered an error while opening an internal, temporary file.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility fails to open a temporary file while performing the prerequisite verification.

User response

Run the db2prereqcheck utility again.

DBT3546E The db2prereqcheck utility failed to determine whether the following file or package exists: file-or-package-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility determines details about the current operating environment and system components by using system commands and examining currently installed files. This message is returned when the db2prereqcheck utility is unable to perform the prerequisites validation because the utility cannot find the given file or package.

User response

Manually verify prerequisites for the database product.

DBT3547E The db2prereqcheck utility failed to determine the version of the glibc library by using the 'strings' system command to extract information from the glibc library file.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Verify manually whether installation prerequisites are met.

DBT3548E The db2prereqcheck command failed because the db2prereqcheck utility failed to open the resource XML file: resource-XML-file-name.

Explanation

You can verify whether a system meets the prerequisites for database product releases and fix packs that are defined in a resource XML file. You can cause the db2prereqcheck utility to read from a specified resource XML file by using the -f parameter with the db2prereqcheck command, or you can allow the db2prereqcheck utility to use a default resource XML file.

This message is returned when the db2prereqcheck utility fails to open the resource XML file, either a file specified with the -f parameter, or the default file.

User response

Call the db2prereqcheck command again, specifying a resource XML file that the db2prereqcheck utility can access.

DBT3549E The db2prereqcheck utility failed to extract an expected string from the output of a system command or the contents of a system configuration file. Expected string: expected-string. Source string: source-string.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility verifies system details by using system commands and examining various system configuration files. This message is returned when the db2prereqcheck utility is unable to extract necessary information from the output of a system command or the contents of a system configuration file.

User response

Verify manually whether installation prerequisites are met.

DBT3550E The db2prereqcheck utility failed to determine the package information by using the lslpp command. Package label: package-label. Package identifier: package-identifier.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility verifies system details by using system commands and examining the contents of system configuration files. This message is returned when the db2prereqcheck utility fails to extract the necessary package information from the output of the lslpp command.

User response

Verify manually whether installation prerequisites are met.

DBT3551E The db2prereqcheck utility failed to determine the package version by using the lslpp command. Package label: package-label. Package identifier: package-identifier.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility verifies system details by using system commands and examining the contents of system configuration files. This message is returned when the db2prereqcheck utility fails to extract the necessary package information from the output of the lslpp command.

User response

Verify manually whether installation prerequisites are met.

DBT3552E The db2prereqcheck utility failed to open the libaio.so.1 file. Command output: err-output.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Verify manually whether installation prerequisites are met.

DBT3553I The db2prereqcheck utility successfully loaded the libaio.so.1 file.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility verifies system details using system commands and system configuration files. This message is returned when the db2prereqcheck utility successfully loads a system file.

User response

No user response is required.

DBT3554W The db2prereqcheck utility was unable to find the package for the IOCP on the system.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The Input/Output Completion Port (IOCP) is required by the database server.

User response

To successfully run a database server, install and configure IOCP manually.

DBT3555E The db2prereqcheck utility determined that the current platform is not supported by the following version: version.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

No response is required

DBT3556W The db2prereqcheck utility encountered an internal error while cleaning up temporary resources.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

No response is required.

DBT3557E The db2prereqcheck utility determined that the current platform is not supported with the DB2 pureScale Feature.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

No user response is required.

DBT3558E The db2prereqcheck command failed because two or more of the following mutually exclusive parameters were specified: -c, -u, -g, and -p.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The -c, -u, -g, and -p parameters are mutually exclusive.

User response

Call the db2prereqcheck command again, specifying only one of the parameters -c, -u, -g, or -p.

DBT3559E The db2prereqcheck command failed because the value specified with the -a parameter is invalid.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Call the db2prereqcheck command again, specifying a valid value with the -a parameter.

DBT3560I The db2prereqcheck utility found the following patch: patch-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

No response is required.

DBT3561E The db2prereqcheck utility failed to find the following bundle: bundle-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

User response

Manually verify installation prerequisites.

DBT3562E The db2prereqcheck utility failed to determine whether SELinux is enabled.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

Because some requirements, such as General Parallel File System (GPFS), are not compatible with Security-Enhanced Linux (SELinux) enabled, the db2prereqcheck utility attempts to determine whether SELinux is enabled. This message is returned when the db2prereqcheck utility is unable to determine whether SELinux is enabled.

User response

Manually verify installation prerequisites.

DBT3563E The db2prereqcheck utility determined that SELinux is enabled, which is not supported with GPFS.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

DB2 database requires a General Parallel File System (GPFS.) However, GPFS is not supported with Security-Enhanced Linux (SELinux) enabled.

User response

Disable SELinux and then proceed with the database product installation.

DBT3564E The db2prereqcheck utility was unable to find the package package-name on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility determines details about the current operating environment and system components by using system commands and examining currently installed files. This message is returned when the db2prereqcheck utility is unable to perform the prerequisites validation because the utility cannot find the given file or package on the given host machine.

User response

Manually verify prerequisites for the database product.

DBT3565E The db2prereqcheck utility found that remote root login is not enabled on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

In versions of DB2 database earlier than DB2 Version 10.5, passwordless remote root login must be enabled to install DB2 database. This message is returned when passwordless remote root login needs to be enabled but the db2prereqcheck utility determined that passwordless remote root login is not currently enabled on the named host machine.

User response

Enable passwordless remote root login on all host machines on which the DB2 database install will be performed, and then perform the installation operation.

DBT3566E The db2prereqcheck utility detected that the service named service-name is not enabled on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility attempts to determine whether all system services that are required for successfully installing DB2 database are enabled. This message is returned when the db2prereqcheck utility detects that a required system service is not enabled.

User response

Manually verify installation prerequisites.

DBT3567E The db2prereqcheck utility found that db2locssh is not configured and passwordless SSH is not enabled between host host-name-1 and host host-name-2.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

To install and configure DB2 pureScale, one of the following communication methods must be configured for all host machines in the DB2 cluster:

  • db2locssh
  • Passwordless SSH

This message is returned when the db2prereqcheck utility determines that neither db2locssh nor passwordless SSH is enabled between the named host machines.

User response

Respond to this error in one of the following ways:

  • Configure db2locssh.
  • Enable passwordless SSH on all host machines on which the DB2 database install will be performed.

Then perform the installation operation.

DBT3568E The db2prereqcheck utility found that the input/output completion Port (IOCP) is not installed on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The input/output Completion Port (IOCP) is required by the database server.

This message is returned when the db2prereqcheck utility detects that no input/output completion ports are installed on the given host machine.

User response

Manually install and configure IOCP on the named host machine.

DBT3569E The db2prereqcheck utility found that the input/output completion Port (IOCP) is not enabled on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The input/output Completion Port (IOCP) is required by the database server.

This message is returned when the db2prereqcheck utility detects that no input/output completion ports are enabled on the given host machine.

User response

Manually install and configure IOCP on the named host machine.

DBT3570W The db2prereqcheck utility found that the specified device (device path: path) does not have an associated identifier of type type. Host: host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility cannot determine either the physical volume identifier (PVID) or the worldwide identifier (WWID) for the specified device path. This information is useful for verifying disk and network prerequisites.

If the db2prereqcheck utility is unable to determine the PVID or WWID, the db2prereqcheck can still successfully perform prerequisite checking. However, if the device path is used for install or instance management runtime operations in the future, the underlying problem that prevented the db2prereqcheck utility from determining the PVID or WWID might also cause errors with install or instance management utilities.

User response

To prevent potential future errors with install or instance management tasks, configure an identifier for the specified device.

DBT3571E The db2prereqcheck utility found that the directory directory-name does not have enough free space on host host-name. Required space: space-needed. Actual space present: space-available.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database.

This message is returned when the db2prereqcheck utility determined that there is insufficient space in the named directory on the given host machine for the installation of the database product to proceed successfully.

User response

Respond to this message in one of the following ways:

  • Allocate more space in the given directory on the given host machine.
  • Specify a different directory that has more available space.

DBT3572W The db2prereqcheck utility found that netname net-name is not pingable from host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck is unable to successfully use the ping command to test connectivity and network response time from the given host machine to the given cluster interconnect netname.

User response

Configure the network so that the specified netname is accessible on the network from the host machine.

DBT3573W The db2prereqcheck utility found that the /etc/hosts file of host host-name associates the hostname with localhost.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck finds that TCP/IP has been configured incorrectly for the named host machine.

User response

Configure TCP/IP for the named host machine.

DBT3574E The db2prereqcheck utility found that the /etc/hosts file is missing an entry for the hostname or netname name on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that the /etc/hosts file has not been configured correctly on the named host machine.

User response

Configure the /etc/hosts file on the host machine.

DBT3575W The db2prereqcheck utility found that the /etc/hosts file of host host-name contains duplication of entry duplicate-host-name-entry.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that the /etc/hosts file has not been configured correctly on the named host machine.

User response

Configure the /etc/hosts file on the host machine.

DBT3576W The db2prereqcheck utility found that the /etc/hosts file contains inconsistent entries for hostname or netname name on the following hosts: host-machine-list.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that the /etc/hosts file has not been configured correctly on the named host machines.

User response

Configure the /etc/hosts file on the listed host machines.

DBT3577E The db2prereqcheck utility found that the library entry library-name is missing in the dat.conf file for netname net-name on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that the direct access transport file, dat.conf, has not been configured correctly on the named host machine.

User response

In the dat.conf file on the host machine, add an entry for the library.

DBT3578E The db2prereqcheck utility found that the dat.conf file is not configured properly for netname net-name on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that the direct access transport file, dat.conf, has not been configured correctly on the named host machine.

User response

In the dat.conf file on the host machine, configure an entry for the netname.

DBT3579E The db2prereqcheck utility detected more than one dat.conf file on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that the direct access transport file, dat.conf, has not been configured correctly on the named host machine.

User response

Configure only one dat.conf file on the host machine.

DBT3580E The db2prereqcheck utility was unable to find the dat.conf file on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that the direct access transport file, dat.conf, has not been configured correctly on the named host machine.

User response

Configure a dat.conf file on the host machine.

DBT3581E The db2prereqcheck utility found that the specified user user-id is either not present or does not have a home directory on host host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. For example, one of the tests that the db2prereqcheck utility performs is to run the simple command "ls <user-id>" to determine whether there is a home directory for the user.

This message is returned when the db2prereqcheck utility encounters a problem with a required user account on a host machine:

  • An account for the user does not exist on the host machine
  • The db2prereqcheck utility cannot find a home directory for the user on the host machine

User response

Create the required user accounts on the host machine.

DBT3582E The db2prereqcheck utility found that the UID of user user-name-1 present on host host-name-1 is not same as the UID of user user-name-2 present on host host-name-2.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that a required user id does not exist on all required host machines.

User response

Create the required user accounts on all host machines.

DBT3583E The db2prereqcheck utility found that the GID of user user-name-1 present on host host-name-1 is not same as the GID of user user-name-2 present on host host-name-2.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that a required user id does not exist on all required host machines.

User response

Create the required user accounts on all host machines.

DBT3584E The db2prereqcheck utility found that either the user account or the group ID for the instance named instance-name is not valid on the following host machine: host-machine-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that a required user id does not exist on the host machine.

User response

Create the required user accounts on all host machines.

DBT3585E The db2prereqcheck utility was unable to find the following Mellanox package: package-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility determines details about the current operating environment and system components by using system commands and examining currently installed files. This message is returned when the db2prereqcheck utility is unable to perform the prerequisites validation because the utility cannot find the given file or package.

User response

Manually verify prerequisites for the database product.

DBT3586E The db2prereqcheck utility detected both of the following packages which cannot coexist: the RHEL server High Performance Networking package (HPN) and the Mellanox adapter driver package.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility determines details about the current operating environment and system components by using system commands and examining currently installed files. This message is returned when the db2prereqcheck utility finds two packages are installed that are not supported together.

User response

Remove either the HPN package or the Mellanox package.

DBT3587E The db2prereqcheck utility failed to verify prerequisites on the host machine host-name.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility determines details about the current operating environment and system components by using system commands and examining currently installed files. This message is returned when the db2prereqcheck utility is unable to perform the prerequisites validation.

User response

Manually verify prerequisites for the database product.

DBT3588W The db2prereqcheck utility was unable to validate the configuration of the log_mtts_per_seg parameter on the following host machine: host-machine-name. Reason code: reason-code.

Explanation

In DB2 pureScale environments, the Mellanox HCA driver mlx4_core parameter named log_mtts_per_seg must be configured in the modprobe configuration file, modprobe.conf, on host machines where any cluster caching facility (CF) resides. If this configuration parameter is not set appropriately, errors could occur when the database manager is started with the db2start command.

This message is returned when the db2prereqcheck utility is unable to validate the setting of log_mtts_per_seg on the given host machine for the reason indicated by the reason code:

1

The db2prereqcheck utility cannot find the file modprobe configuration file on the host machine.

2

The db2prereqcheck utility cannot find an entry for the log_mtts_per_seg parameter in the modprobe configuration file in the host machine.

User response

  • If there is no CF on the host machine, no user response is required.
  • If there is a CF on the host machine, manually verify the configuration of the log_mtts_per_seg parameter.

DBT3589W The db2prereqcheck utility failed to validate that the IOCP is enabled on the following host machine: host-machine-name.

Explanation

Configuring I/O completion ports (IOCPs) on AIX servers is not required for the installation of DB2 for Linux, UNIX, and Windows software. However, this configuration step is recommended for performance purposes.

User response

Optional: Manually configure IOCP.

DBT3590W The db2prereqcheck utility successfully accessed the disk called disk-identifier on the host machine named host-machine-name. However the db2prereqcheck utility failed to verify whether that disk is part of a SAN.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

Part of the prerequisite verification that the db2prereqcheck utility performs includes verifying whether storage prerequisites have been met.

In DB2 pureScale environments, because the DB2 pureScale Feature requires the use of a storage area network (SAN), the db2prereqcheck utility attempts to determine whether a disk on a host machine is a member of a SAN.

User response

  • If you are not using the DB2 pureScale Feature, no response is required.
  • If you are using the DB2 pureScale Feature, manually verify whether the disk is a part of a SAN.

DBT3591E The db2prereqcheck utility failed to verify the dat.conf file on the host machine named host-machine-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility finds that the direct access transport file, dat.conf, has not been configured correctly on the named host machine.

User response

Manually verify the contents of the dat.conf file on the host machine.

DBT3592E The db2prereqcheck utility found that the /etc/hosts file of host host-name associates the hostname with localhost.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck finds that TCP/IP has been configured incorrectly for the named host machine.

User response

Configure TCP/IP for the named host machine.

DBT3593W The db2prereqcheck utility found that the log_mtts_per_seg parameter is not set to the recommended value on the following host machine: host-machine-name.

Explanation

In pureScale environments, the Mellanox HCA driver mlx4_core parameter named log_mtts_per_seg must be configured in the modprobe configuration file, modprobe.conf, on host machines where any cluster caching facility (CF) resides.

This message is returned when the log_mtts_per_seg parameter is not configured to the recommended value of "7" on the host machine.

User response

  • If there is no CF on the host machine, no user response is required.
  • If there is a CF on the host machine, manually configure the log_mtts_per_seg parameter to the recommended value.

DBT3594W The db2prereqcheck utility found that the directory directory-name does not have the recommended amount of free space on host host-name. Recommended amount needed: space-needed. Actual space present: space-available.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database.

This message is returned when the db2prereqcheck utility determines that there is less than the recommended amount of space in the named directory on the given host machine, but that installing the database product could proceed successfully.

Note that although having less than the recommended amount of space on the directory named in the run time token directory-name might not prevent installing the database product from succeeding, having less than the recommended amount of space could cause run time performance problems or other errors in the future.

User response

[Optional] Respond to this message in one of the following ways:

  • Allocate more space in the given directory on the given host machine.
  • Specify a different directory that has more available space.

DBT3595W The db2prereqcheck utility determined that an Intel TCO WatchDog Timer Driver module is loaded but not blocklisted. Module name: module-name.

Explanation

One prerequisite for the DB2 pureScale Feature is that Intel TCO WatchDog Timer Driver modules must be blocklisted with modprobe.

Installing DB2 database might succeed if the Intel TCO WatchDog Timer Driver modules are not blocklisted. However, you will encounter runtime errors creating database manager instances if these modules are not blocklisted.

User response

Blocklist the module by adding an entry in the appropriate configuration file under the /etc/modprobe.d directory.

DBT3596W The db2prereqcheck utility found that the operating system is not the same on all host machines in the cluster. Operating system on the installation-initiating host machine: OS-distribution. Operating system on remote host: OS-distribution. Remote host name: host-name.

Explanation

You can verify that prerequisites for installing DB2 database by using the db2prereqcheck utility.

One requirement for installing the DB2 pureScale Feature is that all machines in the cluster are using the same operating system.

This message is returned when db2prereqcheck determines that not all machines in the cluster are running the same operating system.

User response

Install the same operating system on all host machines in the cluster.

DBT3597W The db2prereqcheck utility detected that there is less than the recommended amount of free space on one or both of the default installation path (/opt) and the instance home directory path (/home). Available space on /opt: amount-of-free-space. Available space on /home: amount-of-free-space.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

The db2prereqcheck utility verifies many prerequisites, including space requirements.

This message is returned when the db2prereqcheck tool determines that there is less than the recommended amount of free space available for one or both of the following paths:

  • The default installation path (/opt)
  • The instance home directory path (/home)

User response

Optional:

  1. Review space requirements for the product in your environment.
  2. Make the recommended amount of space available on /opt and /home.

DBT3598W The db2prereqcheck tool detected Interface Adapter IA-identifier is RDMA capable but is not configured in both /etc/hosts and dat.conf on the host machine. Host machine name: host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility detects an Interface Adapter (IA) that is not configured in the /etc/hosts and direct access transport file, dat.conf, on the host machine.

User response

If the adapter supports Remote Direct Memory Access(RDMA), configure the adapter in the /etc/hosts file and the dat.conf file on the host machine.

DBT3599W The db2prereqcheck utility was unable to verify one of the netnames that were specified with the -nl parameter. Netname: netname. Host name: host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

You can cause the db2prereqcheck utility to verify communication between all hosts in RDMA over Converged Ethernet (RoCE) and InfiniBand networks by specifying a list of netnames in the network. This message is returned when the the db2prereqcheck utility is unable to verify one of the specified netnames, because the netname is not listed in the etc/hosts file or is not configured in the direct access transport file, dat.conf.

User response

To verify the netname, configure the netname in the etc/hosts file and the dat.conf file and then run the db2prereqcheck command again.

DBT3600W The db2prereqcheck utility detected that the IP address specified in the /etc/hosts file for an Interface Adapter is invalid. Interface Adapter: IA-identifier. Host machine name: host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility detects an invalid IP address for an Interface Adapter in an /etc/hosts file.

User response

Update the /etc/hosts file on each of the hosts in the cluster so that for each host in the planned DB2 pureScale environment, the file includes all the IP addresses of all the communication adapter ports for all hosts in the planned environment.

DBT3601W The db2prereqcheck utility was unable to perform Interface Adapter verification because a required library could not be found. Required library: library. Host machine: host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. The db2prereqcheck utility uses the libstdc++ and xlc libraries to perform some of the verification of Interface Adapters. This message is returned when the db2prereqcheck is unable to use one of these libraries.

User response

Install the libstdc++ and xlc libraries and then run the db2prereqcheck command again.

DBT3602W The db2prereqcheck tool detected interface adapter IA-identifier is not configured in /etc/hosts and dat.conf on the host machine named host-name.

Explanation

You can verify installation prerequisites by using the db2prereqcheck utility.

The db2prereqcheck utility verifies many hardware, software, and configuration prerequisites for successfully installing and running DB2 database. This message is returned when the db2prereqcheck utility detects an interface adapter that is not configured in the /etc/hosts and direct access transport file, dat.conf, on the host machine.

User response

If the adapter supports Remote Direct Memory Access(RDMA), configure the adapter in the /etc/hosts file and the dat.conf file on the host machine.

DBT3603E The db2prereqcheck command failed because the utility failed to copy a file to the temporary directory. File name: file-name. Temporary directory: temporary-directory.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

On Windows operating systems, before verifying prerequisites, the db2prereqcheck utility copies some files from the database product install image directory to the temporary directory configured by the %TEMP% environment variable.

This message is returned when the db2prereqcheck utility fails to copy one of those files to the temporary directory.

User response

Perform the following troubleshooting steps:

  • Issue the db2prereqcheck command as a user with write access to %TEMP%.
  • Make 15MB of free space available in %TEMP% and then issue the db2prereqcheck command again.

DBT3604E The db2prereqcheck utility detected that the currently installed level of uDAPL is not supported by the DB2 pureScale Feature on the current operating system level. uDAPL level currently installed: uDAPL-level. Operating system level: OS-level.

Explanation

In a DB2 pureScale environment, the RDMA is supported through the User Direct Access Programming Library (uDAPL) interface.

This message is returned when the db2prereqcheck utility detects that the level of uDAPL that is currently installed is not supported with the current operating system level.

User response

Ensure that uDAPL is installed and configured at the level specified for your system in the software prerequisites.

DBT3605E Verification of one or more of the devices specified with the -dl parameter failed. Specified devices that do not meet DB2 pureScale requirements: device-list.

Explanation

You can verify installation prerequisites for the database product as well as feature-specific prerequisites, such as requirements for the DB2 pureScale Feature, by using the db2prereqcheck utility.

The DB2 pureScale Feature requires one or more raw devices to be configured for storing files that are shared by the DB2 members and cluster caching facilities (CFs). You can verify the shared devices that will be used by your DB2 pureScale instance by issuing the db2prereqcheck command, and specifying the devices with the -dl parameter.

This message is returned when the db2prereqcheck utility determines that one or more of the devices that were specified with the -dl parameter is not a raw device or is not configured with the same physical volume identifier (PVID) on all the host machines in the cluster.

User response

Configure one or more raw devices that are shared between all the host machines in the DB2 cluster and then issue the db2prereqcheck command.

DBT3606E Verification of the /etc/hosts file failed on one or more host machines because the format of the entries in the file does not meet DB2 pureScale requirements. Host machines with an incorrect /etc/hosts file format: host-machine-list.

Explanation

You can verify installation prerequisites for the database product as well as feature-specific prerequisites, such as requirements for the DB2 pureScale Feature, by using the db2prereqcheck utility.

When you are configuring network settings for a planned DB2 pureScale environment, entries in the /etc/hosts file on each host machine in the cluster must be formatted in the following way:

<IP-address> <full-domain-host-name> <alias>

When verifying DB2 pureScale requirements, the db2prereqcheck utility returns this error message if the /etc/hosts file is not formatted in the required way on all host machines in the cluster.

User response

On every host machine in the cluster, correct the entries in the /etc/hosts file so the entries are in the required format.

DBT3607E The db2prereqcheck utility found that the ping using RDMA between all the netnames failed. Refer to log file log_filename for more details.

Explanation

You can verify installation prerequisites for DB2 database by using the db2prereqcheck utility.

You can use the db2prereqcheck utility to verify communication between all hosts in RDMA over Converged Ethernet (RoCE) and InfiniBand networks by specifying a list of netnames, hostnames and adapternames in the network.

This message is returned when the db2prereqcheck is unable to successfully ping all of the netname using RDMA to test connectivity between all the given host machine and cluster interconnect netnames. For more details refer the log file.

However, if these set of hostname and netname are for used for install or instance management runtime operations in the future, the underlying problem that prevented the db2prereqcheck utility from pinging netname might also cause errors with install or instance management utilities.

User response

To verify the netname, configure the netname in the etc/hosts file and the dat.conf file and then run the db2prereqcheck command again.

DBT3608E The db2prereqcheck utility detected that the package level does not match with the system level. Package level: package-level. System level: system-level.

Explanation

You can verify installation prerequisites using the db2prereqcheck utility.

This message is returned when the db2prereqcheck utility found a software package that is not at the required minimum level for the operating system level.

User response

Install the required version of the software package and then run the db2prereqcheck command again.

DBT3609E Validation of db2ssh failed in db2prereqcheck tool, additional information is logged in this path: log-directory.

Explanation

The "-db2ssh_test" option of the db2prereqcheck tool validates the setup of db2locssh and db2scp among hosts.

This message is returned when the execution of validation failed. You can find more detail and explanation in the detailed log and trace files displayed on the screen for further diagnostics

User response

1

Check the given log for more details and diagnostics

2

Search for the topic db2locssh in IBM Knowledge Center and verify the current db2locssh setup is correct

3

Contact IBM software support for assistance.

DBT4000N No value was specified for the option named option-name.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

You must specify a value for the named option.

For an explanation of the syntax of the db2fedgentf command, use the following command: "db2fedgentf -h".

User response

Call the db2fedgentf command again, specifying a value for the named option.

DBT4001N Neither "-create" nor "-drop" was specified. It is mandatory to specify one of these options.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

You must specify exactly one of the "-create" or "-drop" options with the db2fedgentf command.

For an explanation of the syntax of the db2fedgentf command, use the following command: "db2fedgentf -h".

User response

Call the db2fedgentf command again, specifying either "-create" or "-drop".

DBT4002N An invalid option was specified: option-name.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

The given option is not a valid option for the db2fedgentf command.

For an explanation of the syntax of the db2fedgentf command, use the following command: "db2fedgentf -h".

User response

Call the db2fedgentf command again, specifying valid options.

DBT4003N One of the following required options was missing: "-db", "-u", or "-p".

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

When you call the db2fedgentf command, you must specify a database name, a user name, and a password.

For an explanation of the syntax of the db2fedgentf command, use the following command: "db2fedgentf -h".

User response

Call the db2fedgentf command again, specifying a database, a user name, and a password.

DBT4004N One of the following required options was missing: "-stpn" or "-c".

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

When you call the db2fedgentf command to create a new table function for a given federated stored procedure, you must specify both of the following:

  • The name of the federated stored procedure using the "-stpn" option
  • The column name and type pairs of the signature of the federated stored procedure

For an explanation of the syntax of the db2fedgentf command, use the following command: "db2fedgentf -h".

User response

Call the db2fedgentf command again, specifying the federated stored procedure name and the column name and type pairs of the signature of the stored procedure.

DBT4005N The string value for the "-c" option is not valid. db2fedgentf could not parse the column name and type pairs specified in that string. The string that was passed to the db2fedgentf call is: column-name-type-pairs-list.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

When you call the db2fedgentf command to create a new table function for a given federated stored procedure, you must specify the column name and type pairs of the signature of the federated stored procedure.

The format of that string should be:

"<name1> <type1>, <name2> <type2>, ..."

For example:

"PID CHAR(10), PRICE DOUBLE, QTY INT"

User response

  1. Review the signature of the federated stored procedure for which you want to create the table function.
  2. Review the format of the string you want to pass to the "-c" option of the db2fedgentf command.
  3. Call the db2fedgentf command again, passing the column name and type pairs from the federated stored procedure signature in a string of valid format to the "-c" option.

DBT4006N db2fedgentf could not convert the SQL data type of the column named column-name to a JAVA data type. The SQL data type of the column is: SQL-data-type.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

The db2fedgentdf utility creates JAVA table functions. To accomplish this, the utility performs the following tasks: creates a JAVA file that contains the source for the new table function; compiles that generated JAVA file; and registers the new table function.

Because db2fedgentdf creates JAVA table functions, db2fedgentf must convert the SQL data types of the stored procedure result set columns to JAVA data types. In this case, there is no JAVA data type to which the named column can be converted.

No table function was created.

User response

Modify the federated stored procedure to change the SQL data type of then named column to one that can be converted to a JAVA data type.

DBT4008N db2fedgentf could not find the federated stored procedure called stored-procedure-name.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

The message was returned because db2fedgentf could not find an entry in the catalog for the federated stored procedure specified with the "-stpn" option on the command line.

No table function was created.

User response

Call db2fedgentf again, specifying a federated stored procedure that can be found in the catalog.

DBT4011N The db2fedgentf utility failed to create the JAVA source file for the table function. File name: File-name. Reason: reason-code. Error string: Error-string.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

The db2fedgentdf utility creates JAVA table functions. To accomplish this, the utility performs the following tasks: creates a JAVA file that contains the source for the new table function; compiles that generated JAVA file; and registers the new table function.

The reason this message was returned is indicated by the reason code:

1

db2fedgentf could not allocate a file handle for the JAVA source file.

2

db2fedgentf could not write the table function source to the JAVA source file.

3

db2fedgentf could not open a file handle for the JAVA source file. Refer to the error string for more information.

4

db2fedgentf could not write the table function source code to the JAVA source file. Refer to the error string for more information.

No table function was created.

User response

Respond to this message according to the reason code:

1

Restart db2fedgentf.

2

If the maximum number of file handles has been allocated, close some of the open handles, and then restart db2fedgentf.

3 and 4

Respond according to the contents of the error string. For example, if db2fedgentf does not have the necessary file access permissions, work with your system administrator to grant db2fedgentf the required permission.

DBT4012N The db2fedgentf utility failed to compile the JAVA source file for the table function. File name: File-name. Reason: reason-code.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

The db2fedgentdf utility creates JAVA table functions. To accomplish this, the utility performs the following tasks: creates a JAVA file that contains the source for the new table function; compiles that generated JAVA file; and registers the new table function.

The reason this message was returned is indicated by the reason code:

1

db2fedgentf could not determine the current path in which to create the JAVA source file.

2

db2fedgentf could not determine the database product install path.

3

db2fedgentf could not delete the existing version of the class file.

4

db2fedgentf could not copy the class file to the destination: <DB2-INSTALL-PATH>/function

No table function was created.

User response

Respond to this message according to the reason code:

1

Verify that db2fedgentf has the necessary access authorization for the current directory.

2

Investigate whether there are any errors with the current installation of DB2 database.

3

Manually delete the existing version of the class file from: <DB2-INSTALL-PATH>/function

4

Verify that db2fedgentf has the required access authorization for the following directory: <DB2-INSTALL-PATH>/function. If necessary, work with your system administrator to grant db2fedgentf access to that directory.

DBT4014I db2fedgentf successfully dropped the table function called table-function-name.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

User response

You do not need to respond to this message.

DBT4016N db2fedgentf could not drop the table function called table-function-name because there are multiple table functions with the same name.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

This message is returned when db2fedgentf cannot uniquely identify the table function to drop. This can happen when there are multiple table functions with the same name.

No table function was dropped.

User response

Use -tfsn option with db2fedgentf instead of the -tfn option to drop the table function. The specific name of the table function is unique.

DBT4017N The following error occurred while db2fedgentf was creating the table function. SQLSTATE: sqlstate; SQLCODE: sqlcode; message text: message-text.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

While creating a new table function, db2fedgentf encountered the given SQL error.

No table function was created.

User response

  1. Refer to the details of the SQLCODE.
  2. Respond to the SQL error.
  3. Call db2fedgentf again.

DBT4018N db2fedgentf encountered an internal error while creating the table function. The command that db2fedgentf was running is: command. The value that was returned from that command is: return-code. Diagnostic information is in the file called file-name.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

To perform its tasks, the db2fedgentf utility executes multiple database commands and invokes the JAVA compiler 'javac' to compile the JAVA file for the table function. The db2fedgentf utility will get JDK path by reading DBM configuration parameter JDK_PATH. This message is returned when one of those tasks encountered an error.

No table function was dropped or created.

User response

  1. Review the diagnostic information in the named file.
  2. Check DBM configuration parameter JDK_PATH and ensure it is set correctly.
  3. Respond to the errors in the diagnostic information.
  4. Rerun the db2fedgentf command.

DBT4022N The table function to drop was not specified. Both of the following options were missing: "-tfn", and "-tfsn".

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

When you call the db2fedgentf command to drop a table function for a given federated stored procedure, you must identify the table function using one of the following options:

  • The table function name using the "-tfn" option
  • The table function specific name using "-tfsn" option

For an explanation of the syntax of the db2fedgentf command, use the following command: "db2fedgentf -h".

User response

Call the db2fedgentf command again, specifying the table function using either the table function name or the table function specific name.

DBT4023N db2fedgentf could not drop the table function with specific name specific-name because that table function was not created using db2fedgentf.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures. You can use the db2fedgentf utility to drop only those table functions that were created using the db2fedgentf utility.

This message was returned because the specified table function was not created using db2fedgentf.

No table function was dropped.

User response

Use other methods, such as the DROP statement, to drop the table function.

DBT4024N db2fedgentf could not create a table function for the specified procedure procedure-name because there are multiple procedures with the same name.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

This message is returned when db2fedgentf cannot uniquely identify the procedure. This can happen when there are multiple procedures with the same name.

No table function was created.

User response

Use both -stpn and -stpc to determine a unique procedure.

DBT4025N db2fedgentf could not create a table function for the specified procedure, because a table function has already been created for that procedure. The specific name of the existing table function is: schema-name. specific-name

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

When using db2fedgentf, you can create only one table function for each federated stored procedure.

No table function was created.

User response

Drop the existing table function for the specified procedure and run db2fedgentf again.

DBT4026I The db2fedgentf utility successfully created the table function named table-function-name that you can use to access result sets that are returned from the federated stored procedure named federated-stored-procedure.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

This message is returned when the db2fedgentf utility successfully creates a table function.

User response

Use the new table function to access result sets that are returned from the federated stored procedure.

DBT4027N The db2fedgentf command failed because the utility encountered an error while allocating an environment handle.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

The db2fedgentdf utility creates Java table functions. To accomplish this, the utility must perform a variety of database tasks. This message is returned when the db2fedgentf utility encounters an internal DB2 database error while performing those tasks. Specifically, this message is returned when the db2fedgentf utility fails to allocate an environment handle.

User response

Run the db2fedgentf utility again:

  1. Review available diagnostic information, such as the db2diag log, to determine why the db2fedgentf utility was unable to allocate an environment handle.
  2. Resolve the problem or problems that caused the failure. For example, if the root cause of the handle allocation error was insufficient system memory, reconfigure the system to make more memory available.
  3. Rerun the db2fedgentf command.

If the problem persists, perform the following steps:

  1. Collect the following diagnostic information:
    • db2diag logs
  2. Contact IBM support.

DBT4028N The db2fedgentf command failed because the db2fedgentf utility could not determine the directory under which the Software Developer's Kit (SDK) for Java is installed from the database manager configuration parameter JDK_PATH.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

To perform its tasks, the db2fedgentf utility executes multiple database commands and invokes the Java compiler 'javac' to compile the Java file for the table function. The db2fedgentf utility determines where the Java SDK installed by reading the JDK_PATH configuration parameter.

This message is returned when the db2fedgentf utility cannot determine the location of the Java SDK from the JDK_PATH configuration parameter for some reason, such as because the configuration parameter is NULL.

User response

  1. Set the JDK_PATH database manager configuration parameter to the directory under which the Java SDK is installed.
  2. Run db2fedgentf again.

DBT4029W The db2fedgentf successfully created the table function, but failed to delete the Java source file: Java-source-file-name.

Explanation

You can use the db2fedgentf utility to create or drop table functions that access result sets from federated stored procedures.

The db2fedgentdf utility creates Java table functions. To accomplish this, the utility performs the following tasks:

  • Creates a Java file that contains the source for the new table function
  • Compiles that generated Java file
  • Registers the new table function
  • Deletes the generated Java source file

This message is returned when the db2fedgentf utility was supposed to delete the generated Java source file, but the utility failed to delete the file.

User response

Optional: You can delete the generated Java source file manually.

Because the db2fedgentf utility always generates Java source files with unique names, choosing not to delete the generated source file that the utility failed to delete will not cause problems with future db2fedgentf use. However, it is recommended that you review any available diagnostic information (such as the db2diag log files or operating system diagnostic files) to determine why the utility failed to delete the file. The root cause of this failure to delete the Java source file by the db2fedgentf utility might also cause problems with other activities.

DBT5000I The db2checkSD utility completed successfully. The specified database can be used in a DB2 pureScale environment. The output log file is named file-name.

Explanation

Before converting your instance to a DB2 pureScale instance type, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when the db2checkSD utility did not find any database objects or features in the specified database that are not supported in a DB2 pureScale environment.

User response

Optional: review the contents of the output log file.

You can now convert your instance to a DB2 pureScale instance type.

DBT5001W The db2checkSD utility completed with some warnings. The database or databases can be used in a DB2 pureScale environment, but some database objects or features will have to be converted or disabled. The output log file is named file-name.

Explanation

Before converting your instance to a DB2 pureScale instance type, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when the db2checkSD utility found some database objects or features in the specified database that are not supported in a DB2 pureScale environment which will be automatically converted or disabled when you convert the instance to a DB2 pureScale instance type.

User response

  1. Review the contents of the db2checkSD output log file.
  2. Investigate any issues identified in the db2checkSD output log file that are of concern to you.
  3. Convert the instance to a DB2 pureScale instance type.

DBT5002N The db2checkSD utility completed with errors. The database or databases cannot be used in a DB2 pureScale environment. The output log file is named file-name.

Explanation

Before converting your instance to a DB2 pureScale instance type, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when the db2checkSD utility found some database objects or features in the specified database that are not supported in a DB2 pureScale environment and which cannot be automatically converted or disabled when you convert the instance to a DB2 pureScale instance type.

User response

  1. Review the contents of the db2checkSD output log file.
  2. Convert or disable any unsupported database objects or features that db2checkSD identified.
  3. Run the db2checkSD utility again.

DBT5003N The db2checkSD command failed because the following invalid parameter was specified: parameter-name.

Explanation

Before converting your instance to a DB2 pureScale instance type, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when an invalid parameter was passed to the db2checkSD command.

User response

Run the db2checkSD command again, specifying valid parameters.

DBT5004N The db2checkSD command failed because a database was not specified and the -e parameter was not specified.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

You can pass the name of a specific database to be checked, or you can use the -e parameter to specify that the db2checkSD utility should check all databases in the current database manager instance. This message is returned when no database or databases were specified to be examined by the db2checkSD utility.

User response

Run the db2checkSD command again, specifying which database or databases to check in one of the following ways:

  • Specify one specific database.
  • Pass the -e parameter to cause the db2checkSD utility to examine all databases in the current database manager instance.

DBT5005N The db2checkSD command failed because no output log file name was specified.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

The db2checkSD creates an output log file that contains detailed information about the investigation of the database structure, metadata, objects, and features that the db2checkSD utility performed. You must specify the name of the output log file using the -l parameter.

This message is returned when no name for the db2checkSD output log file was specified using the -l parameter with the db2checkSD command.

User response

Run the db2checkSD command again, specifying an output log file name using the -l parameter.

DBT5006N The db2checkSD command failed because no value was specified for the following parameter: parameter-name.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when a parameter is passed to the db2checkSD command without a value.

User response

Run the db2checkSD command again, specifying a value for the named parameter.

DBT5007N The db2checkSD command failed because the following parameter was specified more than once: parameter-name.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when a parameter is passed to the db2checkSD command more than once.

User response

Run the db2checkSD command again, specifying the named parameter only once.

DBT5008N The db2checkSD command failed because the length of the specified log file name is too long.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

The db2checkSD creates an output log file that contains detailed information about the investigation of the database structure, metadata, objects, and features that the db2checkSD utility performed. You must specify the name of the output log file name using the -l parameter. The log file name cannot be longer than 256 characters.

This message is returned when an output log file name was specified using the -l parameter with the db2checkSD command that is longer than 256 characters.

User response

Run the db2checkSD command again, specifying an output log file name that is not longer than 256 characters.

DBT5009N The db2checkSD command failed because the db2checkSD utility is not supported with the current version.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility. The db2checkSD utility is supported with DB2 Version 9.7 for Linux, UNIX, and Windows and later.

This message is returned when an attempt is made to use the db2checkSD utility to examine a database that is older than DB2 Version 9.7.

User response

  1. Upgrade the database to DB2 Version 9.7 or later.
  2. Run the db2checkSD command against the database again once the database is at Version 9.7 or higher.

DBT5010N The db2checkSD utility failed because the utility could not confirm that the current user has sufficient authority to run the db2checkSD utility.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

The following authority is required to run the db2checkSD command: SYSADM or higher. This message is returned when a user without SYSADM authority or higher attempts to run the db2checkSD command.

User response

Respond to this message with one of the following actions:

  • Request that your authorization be upgraded to SYSADM authorization or higher and then rerun the db2checkSD command.
  • Request that a user with SYSADM authorization or higher run the db2checkSD command.

DBT5011N The db2checkSD utility failed because there are table spaces in the database which are not in the 'NORMAL' state. The db2checkSD utility generated a user script named script-name.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

The db2checkSD utility performs the following tasks:

  1. The db2checkSD utility identifies database objects and features that are not supported in a DB2 pureScale environment by examining database structures and metadata, as well as running queries against the database.
  2. The db2checkSD utility generates a user script that you can run to prepare the database to be upgraded to a DB2 pureScale environment.

This message is returned when the db2checkSD utility found some table spaces that are in a state other than 'NORMAL', which would prevent the database from being upgraded successfully to a DB2 pureScale environment.

User response

  1. Identify the table spaces that are not in 'NORMAL' state by running the user script that was generated by the db2checkSD utility.
  2. Move the table spaces that are not in a 'NORMAL' state to a 'NORMAL' state.
  3. Run the db2checkSD utility against the database again.
  4. If the db2checkSD utility succeeds, you can upgrade the database to a DB2 pureScale environment.

DBT5022N The db2checkSD command failed because both a database name was specified and the -e parameter was specified.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

You can pass the name of a specific database to be checked, or you can use the -e parameter to specify that the db2checkSD utility should check all databases in the current database manager instance.

User response

Run the db2checkSD command again, specifying which database or databases to check in one of the following ways:

  • Specify one specific database.
  • Pass the -e parameter to cause the db2checkSD utility to examine all databases in the current database manager instance.

DBT5025N The db2checkSD utility completed with errors. The output log file is named log-file-name.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility. The db2checkSD utility identifies these unsupported database objects and features by examining database structures and metadata, and running queries against the database.

This message is returned in the following situations, among others:

  • An attempt was made to run the db2checkSD command from a computer that is configured to run only a cluster caching facility (CF).
  • The db2checkSD utility was unable to connect to one or more of the databases.
  • The db2checkSD utility encountered an unexpected error condition while running queries against the database.

User response

Respond to this message in one of the following ways:

  • Verify that you can connect to the database successfully.
  • If the db2checkSD command was issued on a computer that is configured to run only a CF, run the command from any computer that is configured to run a DB2 member instead.
  • If the db2checkSD command was not issued on a computer that is configured to run only a CF, perform the following procedure:
    1. Collect the following files:
      • The output log file created by the db2checkSD utility
      • The generated user script created by the db2checkSD utility
      • The db2diag log
    2. Contact IBM support to investigate the problem.

DBT5026I The db2checkSD utility completed processing for database dbname.

Explanation

Before converting your instance to a DB2 pureScale instance type, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

This message is returned after the db2checkSD utility has finished checking each database, when it is invoked with the -e option to check all databases in the instance.

User response

Optional: Review the contents of the log file when the db2checkSD utility has finished checking all databases in the instance.

DBT5027W The db2checkSD utility did not check any databases. The output log file is named file-name.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

The db2checkSD utility identifies these unsupported database objects and features by examining database structures and metadata, as well as running queries against the database. This message is returned when the db2checkSD utility found an empty database directory or when the db2checkSD utility could not find a local database directory.

User response

  1. Catalog the databases that you want to check using the db2checkSD utility.
  2. Run the db2checkSD command again.

DBT5029N The db2checkSD utility could not open or write to the file named file-name.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

The db2checkSD utility generates the following files:

  • An output log file that you can review for details about the db2checkSD utility's investigations
  • A user script that you can use to identify database objects or features that must be removed or disabled before upgrading the database or databases to a DB2 pureScale environment

This message is returned when the db2checkSD utility was unable to create the output log file or the generated user script.

User response

  1. Give the db2checkSD utility write permission for the path where you want the db2checkSD utility to create the output log file and the generated user script.
  2. Run the db2checkSD utility again.

DBT5033W The db2checkSD utility identified one or more features that will be disabled when updating the instance to a DB2 pureScale environment.

Explanation

Before upgrading a database to a DB2 pureScale environment, you can identify any database objects or features in the database that are not supported in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when the db2checkSD utility found some database objects or features in the specified database that are not supported in a DB2 pureScale environment which will be automatically converted or disabled when you upgrade the database to a DB2 pureScale environment.

User response

  1. Review the contents of the db2checkSD output log file.
  2. Investigate any issues identified in the db2checkSD log that are of concern to you.
  3. Upgrade the database to a DB2 pureScale environment.

DBT5034I The db2checkSD utility has already verified that database dbname can be used in a DB2 pureScale environment.

Explanation

The db2checkSD utility has already been run for the database and all checks were successful. The checks were not performed again.

User response

No further action is needed.

DBT5035N The db2checkSD command failed because the db2checkSD utility was not able to access the database manager configuration file.

Explanation

You can verify that a given database can be used in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when the db2checkSD utility is not able to open the database manager configuration file.

User response

Use commands such as db2 get dbm configuration to get more information about the error that occurs when the database manager attempts to read the database manager configuration file.

DBT5036N The db2checkSD command failed because either the db2checkSD utility was unable to connect to the database or the db2checkSD utility was unable to access the database configuration file.

Explanation

You can verify that a given database can be used in a DB2 pureScale environment using the db2checkSD utility.

This message is returned when the db2checkSD utility is not able to open the database configuration file.

User response

Respond to this error by performing the following troubleshooting steps:

  • Verify that you can connect to the database.
  • Get more information about the error that occurs when the database manager attempts to read the database configuration file by performing one or both of the following actions:
    • Connect to the database
    • Run the GET DATABASE CONFIGURATION command for the database

DBT5037N The db2checkSD utility failed because the database is configured as an HADR standby database.

Explanation

The db2checkSD utility verifies that a database can be used in a DB2 pureScale environment. An HADR standby database must be dropped before the instance is converted to a DB2 pureScale instance and reinitialized in the DB2 pureScale environment.

User response

Drop the standby database, convert both instances to DB2 pureScale instances, then reinitialize the standby database.

DBT5038N The db2checkSD utility failed because the HADR_SSL_LABEL database configuration parameter is set.

Explanation

The db2checkSD utility verifies that a database can be used in a DB2 pureScale environment. The database configuration parameter HADR_SSL_LABEL is not supported in DB2 pureScale environment.

User response

Set HADR_SSL_LABEL to NULL.

DBT5500N The current user does not have sufficient authority to run the db2ckupgrade utility.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

The following authority is required to run the db2ckupgrade command: SYSADM or higher. This message is returned when a user with insufficient authority attempts to run the db2ckupgrade command.

The command failed.

User response

Do one of the following:

  1. Request that your authorization be upgraded to SYSADM authorization or higher and then rerun the db2ckupgrade command.
  2. Request that a user with SYSADM authorization or higher run the db2ckupgrade command.

DBT5501N The db2ckupgrade utility could not open or write to the file named log-file-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

The db2ckupgrade utility generates an output log file that you can review for details about the processing done by the utility.

This message is returned when the db2ckupgrade utility was unable to open or write to the output log file.

User response

  • Give the db2ckupgrade utility write permission for the path where you want the db2ckupgrade utility to create the output log file.
  • Run the db2ckupgrade utility again.

DBT5502N The db2ckupgrade utility failed because there was an incorrect number of parameters specified.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the number of parameters specified is incorrect.

User response

Run the db2ckupgrade command again, specifying valid parameters.

DBT5503N The db2ckupgrade utility failed because the following invalid parameter was specified: parameter-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when an invalid parameter was passed to the db2ckupgrade command.

The command failed.

User response

Run the db2ckupgrade command again, specifying valid parameters.

DBT5504N The db2ckupgrade utility failed because a database was not specified and the -e parameter was not specified.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

You can pass the name of a specific database to be checked, or you can use the -e parameter to specify that the db2ckupgrade utility should check all databases in the current database manager instance. This message is returned when no database or databases were specified to be examined.

User response

Run the db2ckupgrade command again, specifying which database or databases to check in one of the following ways:

  • Specify one database name.
  • Pass the -e parameter to cause the db2ckupgrade utility to examine all databases in the current database manager instance.

DBT5505N The db2ckupgrade utility failed because no output log file name was specified.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

The db2ckupgrade creates an output log file that contains detailed information about the investigation that the db2ckupgrade utility performed. You must specify the name of the output log file name using the -l parameter.

This message is returned when no name for the db2ckupgrade output log file was specified.

User response

Run the db2ckupgrade command again, using the -l parameter, to specify an output log file name.

DBT5506N The db2ckupgrade utility failed because no value was specified for the following parameter: parameter-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when a parameter is passed to the db2kupgrade command without a value.

User response

Run the db2ckupgrade command again, specifying a value for the named parameter.

DBT5507N The db2ckupgrade utility failed because the following parameter was specified more than once: parameter-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when a parameter is passed to the db2ckupgrade command more than once.

User response

Run the db2ckupgrade command again, specifying the named parameter only once.

DBT5508I The db2ckupgrade utility completed successfully. The database or databases can be upgraded.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility verifies that all upgrade conditions are met. You can now upgrade the database.

User response

  1. Optional: Review the contents of the output log file.
  2. You can now upgrade the database.

DBT5509N The db2ckupgrade utility failed because it could not connect to the database. Database: database-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility is unable to connect to the specified database.

The command failed.

User response

  1. Ensure that the specified database name is correct
  2. Ensure that the database manager is running.
  3. Try the command again.

DBT5510W The db2ckupgrade utility found that the database contains the following types of objects, which are not supported by the version to which upgrading is being considered: XML global variables; or compiled SQL functions that use XML parameters or that return XML types.

Explanation

You can verify that a given database can successfully be upgraded to a later version using the db2ckupgrade utility.

This message is returned when the db2ckupgrade utility finds database objects which are not supported in the version to which you are upgrading. Specifically, this message is returned when the following database objects are in a database being checked:

  • Global variables of type XML
  • Compiled SQL functions that use parameters of type XML or that return XML types

If you proceed to upgrade the database to the target version, these objects will be invalidated during database upgrade. You will be unable to use these database objects until you upgrade to a version that supports those database objects.

User response

To be able to use the database objects that are invalidated during upgrade, upgrade to a release and fix pack of DB2 database that supports XML global variables and compiled SQL functions that use XML parameters or that return XML types. When you upgrade to a fixpack that supports those database objects, the objects will be automatically revalidated the first time they are referenced after the database has been upgraded.

DBT5511N The db2ckupgrade utility failed because a parameter was too long. Parameter: parameter-name. Max length: max-length.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when one of the parameters passed to the db2ckupgrade utility is longer than the maximum allowed length for that parameter.

User response

Run the db2ckupgrade command again, specifying the parameter with the correct length.

DBT5512E The db2ckupgrade utility determined that the following workload management object cannot be upgraded because the ID of that object conflicts with a system-reserved ID. Object name: object-name.

Explanation

Some workload management objects are assigned default, system-reserved identifiers (ID).

This message is returned when the db2ckupgrade utility determines that an existing workload management object has an ID that happens to fall in the range of default, system-reserved IDs. The database cannot be upgraded while the workload management object with the conflicting ID exists in the database.

User response

  1. Extract the DDL statements that would reproduce your workload management objects by using the db2look utility, specifying the -wlm option.
  2. Drop all of the workload management objects from the database.
  3. Verify whether the database can be upgraded by using the db2ckupgrade utility, and resolve any other problems that are blocking the database from being upgraded.
  4. After the db2ckupgrade utility determines that the database can be upgraded, perform the following steps:
    1. Upgrade the database.
    2. Recreate the workload management objects in the upgraded database by running the DDL statements that the db2look utility generated.

DBT5513N The db2ckupgrade utility failed because the SYSCATSPACE table space requires more space in order to complete the upgrade.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

Typically, amount of free space defined by SYSCATSPACE should be at least the same as the current amount of used space.

This message is returned when SYSCATSPACE has less than 50% free pages left.

User response

  • Increase the size of existing containers. You can also add additional containers although this might trigger data rebalancing.
  • Optional: You can reduce the size of the containers after upgrade.

DBT5514N The db2ckupgrade utility failed because the database is in a restore pending state.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the database being checked is found to be in a restore pending state.

User response

Complete the restore and run the db2ckupgrade command again.

DBT5515N The db2ckupgrade utility failed because the database is in a backup pending state.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the database being checked is in the process of having a backup taken to provide a starting point for roll-forward recovery, but is still in a backup pending state.

User response

Wait until the backup has completed and run the db2ckupgrade command again.

DBT5516N The db2ckupgrade utility failed because the database is in a rollforward pending state.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the database being checked is enabled for roll-forward recovery and it has been restored but not rolled forward.

User response

  1. Roll forward the database or indicate that you do not wish to roll forward by using the ROLLFORWARD command. Note that if you do not roll forward the database, the records written since the last backup of the database will not be applied to the database.
  2. Run the db2ckupgrade command again.

DBT5517N The db2ckupgrade utility failed because the database is in an inconsistent state.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the database being checked is found to be in an inconsistent state.

The possible causes of this inconsistent state include

  • The database is online and SQL has been issued which modified data in the database.

User response

  1. Perform a clean shutdown of the database.
  2. Re-issue the db2ckupgrade command.

DBT5518W The db2ckupgrade utility completed with one or more warnings but the database can still be upgraded. Log file: log-file.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility completes with one or more warnings but the database can still be upgraded

User response

  1. Optional: Review the contents of the output log file.
  2. You can now upgrade the database.

DBT5519N The db2ckupgrade utility failed because the the utility failed to deactivate the database. SQLCODE: sqlcode.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

The db2ckupgrade command attempts to deactivate the specified database and stop all necessary database services. This message is returned when the db2ckupgrade utility failed to deactivate the database.

User response

Perform the following:

  1. Review the SQLCODE to determine the reasons why the database could not be deactivated and take corrective action.
  2. Run the db2ckupgrade command again.

DBT5520N The db2ckupgrade utility failed because an error occurred while setting the bypass flag for Query Patroller. SQLCODE: sqlcode.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility attempted to set the DB2_QP_BYPASS_COST variable but failed.

User response

Perform the following:

  1. Review the SQLCODE and take corrective action.
  2. Run the db2ckupgrade command again.

DBT5521N The db2ckupgrade utility failed because the version of the db2ckupgrade utility is not higher than the version of the specified database.

Explanation

While upgrading your database product to a higher version, you can verify whether the databases are ready to be upgraded by using the db2ckupgrade utility.

The db2ckupgrade command must be invoked from the higher version product install media or installation path.

This message is returned when the version of the db2ckupgrade utility is not higher than the database being tested, which could happen in different scenarios:

  • The db2ckupgrade command was invoked from the same product as the database being tested, instead of being invoked from the higher version product.
  • The database was upgraded to the higher version, and then db2ckupgrade was run against the already-upgraded database.

User response

To verify whether a database at a lower DB2 version, X, can be upgraded to a higher DB2 version, Y, invoke the db2ckupgrade command from the higher version Y product install media or installation path.

DBT5522N The db2ckupgrade utility failed because the database has one or more tables in a load pending state.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when a previous LOAD attempt on one or more tables in the database did not complete successfully. The upgrade cannot proceed until the LOAD operation is restarted or terminated.

User response

Restart or terminate the previously failed LOAD operation on this table by issuing LOAD with the RESTART or TERMINATE option respectively.

To find out what tables are in a load pending state run the following command:

select tabname from SYSIBMADM.ADMINTABINFO
    where load_status is not NULL

DBT5523N The db2ckupgrade utility failed because the database has one or more tables in a redistribute pending state.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This messages is returned when the REDISTRIBUTE utility has not completed for one or more tables in the database. The upgrade cannot proceed until the REDISTRIBUTE is finished.

User response

Perform one of the following:

  1. If the REDISTRIBUTE utility is in progress, wait until it completes. You can use the LIST UTILITIES command to monitor the progress of the REDISTRIBUTE utility.
  2. If a previous REDISTRIBUTE operation failed and left the table in redistribute pending state, issue the REDISTRIBUTE utility again with the CONTINUE or ABORT option and let it complete.

DBT5524N The db2ckupgrade utility failed because upgrading databases enabled for VARCHAR2 support from DB2 Version 9.5 is not supported.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility determines that the database to be upgraded is enabled for VARCHAR2 support. Upgrading from DB2 Version 9.5 with VARCHAR2 is not supported.

User response

No action is needed. The database cannot be upgraded.

DBT5525N The db2ckupgrade utility failed with an unhandled error.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned in the following situations, among others:

  • An attempt was made to run the db2ckupgrade command from a computer that is configured to run only a cluster caching facility (CF).
  • The db2ckupgrade utility encountered an unhandled error condition while examining database structures and metadata, and running queries against the database.

User response

Respond to this message in one of the following ways:

  1. If the db2ckupgrade command was issued on a computer that is configured to run only a CF, run the command from any computer that is configured to run a DB2 member instead.
  2. If the db2ckupgrade command was not issued on a computer that is configured to run only a CF, collect the output log file created by the db2ckupgrade utility, the generated user script created by the db2ckupgrade utility, and the db2diag log. Then contact IBM support to investigate the problem.

DBT5526W The db2ckupgrade utility did not check any databases. The output log file is named file-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility finds an empty database directory or when the db2ckupgrade utility could not find a local database directory.

User response

Perform the following actions:

  • Catalog the databases that you want to check using the db2ckupgrade utility.
  • Run the db2ckupgrade command again.

DBT5527N The db2ckupgrade command failed because the database manager could not be started. sqlcode: sqlcode.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

The db2ckupgrade command must start the database manager in order to perform the verifications. This message is returned when db2ckupgrade is unable to start the database manager.

The token sqlcode contains the sqlcode that was returned from the underlying start database manager call.

The command failed.

User response

  1. Determine the cause of the failure by referring to the SQL message for the returned sqlcode.
  2. Resolve the underlying problem.
  3. Invoke the db2ckupgrade command again.

DBT5528N The db2ckupgrade utility failed because the I/O write operations for the database are suspended or are being suspended.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility cannot operate because I/O writes are suspended for the database.

User response

If write operations for the database are in the process of being suspended, monitor the state of the database using the suspend_io configuration parameter, and wait until the SET WRITE SUSPEND operation completes before you continue, then reissue the db2ckupgrade command again.

DBT5529N The db2ckupgrade utility did not complete successfully. The database cannot be upgraded. The output log file is named log-file-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility has completed but not all upgrade conditions were met. The database cannot be upgraded.

User response

  1. Review the contents of the output log file and fix any issues.
  2. Run the db2ckupgrade command again.

DBT5530N The db2ckupgrade command failed because the tablespace is not in normal state. Tablespace: tablespace-name. State: state. Member: member-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned then the db2ckupgrade utility attempted to access a table space which is in an invalid state, for which the intended access is not allowed.

The possible causes of the inconsistent state include:

  • The database is online and SQL has been issued which modified data in the database.
  • The database is online and HADR has been enabled.

User response

Perform the following actions:

  1. Perform a clean shutdown of the database.
  2. After shutdown, if HADR has been enabled on the database, issue the STOP HADR command on the database.
  3. Re-issue the db2ckupgrade command.

DBT5531W The db2ckupgrade utility failed because it could not find any local database to process.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the -e parameter is specified but the db2ckupgrade utility is unable to find any local databases.

The command failed.

User response

Check whether any database names exist in the system database directory. If there are no database names in the system database directory, then either no databases exist or the database names have not been cataloged.

If a database name appears in the system database directory and the entry type is INDIRECT, ensure that the database exists in the specified local database directory

DBT5532N The db2ckupgrade utility failed because there are one or more MQTs that depend on system views.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This messages is returned when the db2ckupgrade utility finds MQTs that depend on system views. During database upgrade all system views will be recreated, so any MQTs that depend on the system views will be automatically dropped.

User response

Perform the following actions:

  • Generate and backup the DDL needed to create the MQTs
  • Drop the MQTs
  • Upgrade the database
  • Recreate the MQTs

DBT5533N The db2ckupgrade utility failed because the utility failed to activate the database. SQLCODE: sqlcode.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the db2ckupgrade utility could not perform the verification because it failed to activate the database.

User response

  1. Review the SQLCODE to determine the reasons why the database could not be activated and take corrective action.
  2. Run the db2ckupgrade command again.

DBT5534W The db2ckupgrade command found a database object which has a dependency on system built-in routines that are discontinued. Object name: schema-name.object-name. Object type: object-type. Discontinued routine upon which the object depends: schema-name.routine-name.

Explanation

Some system built-in routines such as table functions, views, or stored procedures, are discontinued in the target version of the database upgrade due to the introduction of new functionality or changes to the existing functionality.

The database upgrade to that target version drops any system built-in routines that are discontinued. To continue to use database objects that have a dependency on these system built-in routines, you have to alter these database objects and remove the dependency before the database upgrade.

This message is returned when the db2ckupgrade command detects a database object such as a view, trigger, or a user-defined stored procedure, that has a dependency on system built-in routines that are discontinued in the target version of the database upgrade.

User response

Perform one of the following actions:

  • If you no longer need the database object which depends on system built-in routines that are discontinued, drop this object.
  • Alter the database object so that the object does not depend on system built-in routines that are discontinued. Use the replacement routines provided for system built-in routines that are discontinued.

DBT5535N The db2ckupgrade utility failed because the HADR primary's log shipping position does not match the HADR standby's log replay position.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when the HADR primary's log shipping position does not match some HADR standby's log replay position.

Before the upgrade process can begin all data produced on the primary database must be shipped and replayed by each standby database configured in the cluster.

User response

Using HADR monitoring tools, verify that the primary database is properly connected to all standby databases configured in the HADR_TARGET_LIST and that log shipping and log replaying functionality is healthy.

If multiple standby databases are configured and some standby's log replay position is not able to catch up to the primary's log shipping position, either attempt to resolve the issue blocking the shipping or replaying from proceeding or remove the standby from the HADR_TARGET_LIST. This standby can be re-initialized from a backup image post-upgrade.

Once all possible issues have been addressed re-issue the db2ckupgrade command.

If the problem cannot be resolved then issue STOP HADR on the primary database to change the database role back to standard then re-issue the db2ckupgrade command. The standby database(s) will have to be re-initialized from a backup image post-upgrade.

DBT5536W The db2ckupgrade utility did not find any audit policies associated with the database database-name.

Explanation

You can verify whether a database can be upgraded by using the db2ckupgrade utility. Before upgrading to a new version, you can identify any database objects or features in the database that are not supported in the new version using the db2ckupgrade utility.

The security administrator uses audit policies to configure the audit facility to gather information about a database. This message is returned when the db2ckupgrade utility finds audit policies that are associated with a database (entries in the SYSCAT.AUDITUSE catalog view with a blank OBJECTTYPE), but none of the entries is associated with the current database. There is no entry that has an OBJECTNAME that matches the current database name.

An audit policy is not required to upgrade the database.

User response

Optional:
  1. Audit the database using the following command:
    AUDIT DATABASE USING POLICY <policy-ID>
  2. Run the db2ckupgrade command again.

If you do not audit the database and rerun db2ckupgrade, the SYSCAT.AUDITUSE catalog view will be cleared when the database is upgraded.

DBT5537I The db2ckupgrade utility has completed processing for database database-name.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned after the db2ckupgrade utility has finished checking each database, when it is invoked with the -e option to check all databases in the instance.

User response

Optional: Review the contents of the log file when the db2ckupgrade utility has finished checking all databases in the instance.

DBT5538N The db2ckupgrade utility found an unexpected mount point configuration.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded. When upgrading from DB2 V9.8 the database upgrade moves certain table space files to a new location. If the table space containers use an unexpected mount point configuration the table space data cannot be moved by the upgrade processing.

User response

Contact IBM support. If possible, have the details from the log file associated with the db2ckupgrade command available.

DBT5539N The db2ckupgrade utility found a discrepancy in the database control files.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded. When upgrading from DB2 9.8 the files under /MEMBERnnnn/sqldbdir are consolidated to a single location. If the files in /sqldbdir are not identical on all members the upgrade processing cannot consolidate them.

User response

Contact IBM support. If possible, have the log file associated with the db2ckupgrade command available.

DBT5540I The db2ckupgrade command completed successfully. The database is no longer in upgrade pending state.

Explanation

You can verify whether a database is ready to be upgraded by issuing the db2ckupgrade command. If the database is ready to be upgraded, the db2ckupgrade utility puts the database in "upgrade pending" state. When a database is in upgrade pending state, all connections are blocked.

There are two ways to bring a database out of upgrade pending state:

  • Upgrade the database
  • Issue the db2ckupgrade command with the -resetUpgradePending parameter

This message is returned when the db2ckupgrade utility has successfully reset the upgrade pending state of the database. No upgrade conditions were checked. Applications may connect to the database.

User response

No user response is required.

DBT5541N The db2ckupgrade utility failed to reset the upgrade pending state of the database. SQLCODE: sqlcode.

Explanation

You can verify whether a database is ready to be upgraded by issuing the db2ckupgrade command. If the database is ready to be upgraded, the db2ckupgrade utility puts the database in "upgrade pending" state. When a database is in upgrade pending state, all connections are blocked.

There are two ways to bring a database out of upgrade pending state:

  • Upgrade the database
  • Issue the db2ckupgrade command with the -resetUpgradePending parameter

This message is returned when the db2ckupgrade utility fails to reset the upgrade pending state of the database because of the error given in the runtime token sqlcode.

User response

  1. Review the message for the underlying sqlcode.
  2. Correct the source of the underlying problem.
  3. Reissue the db2ckupgrade command with "-resetUpgradePending" parameter.

DBT5542I The db2ckupgrade utility has successfully put the database in upgrade pending state.

Explanation

You can verify whether a database is ready to be upgraded by using the db2ckupgrade utility.

The db2iupgrade utility internally calls db2ckupgrade. If the database is ready to be upgraded, the database is put into upgrade pending state. When a database is in upgrade pending state, attempts to connect to the database are blocked.

This message is returned when the db2ckupgrade command is issued internally by the db2iupgrade utility and the database has been put in upgrade pending state. The database can be upgraded.

User response

Respond in one of the following ways:

  • You can now upgrade the database.
  • If you will not be upgrading the database immediately, and if you want applications to be able to continue to connect to the database, you can reset the state of the database by issuing the db2ckupgrade command with the "-resetUpgradePending" parameter.

DBT5543N The db2ckupgrade utility failed to put the database in upgrade pending state. SQLCODE: sqlcode

Explanation

You can verify whether a database is ready to be upgraded by using the db2ckupgrade utility. The db2iupgrade utility internally calls db2ckupgrade.

If the db2ckupgrade utility determines that the database is ready to be upgraded, the db2ckupgrade utility puts the database into upgrade pending state.

This message is returned when the db2ckupgrade utility is called internally by the db2iupgrade utility, and an error occurs when the db2ckupgrade utility attempts to put the database into upgrade pending state. The database cannot be upgraded.

User response

Issue the db2iupgrade command again.

DBT5544W The db2ckupgrade command failed because incompatible input parameters were specified: parameter1 and parameter2.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when incompatible input parameters were passed to the db2ckupgrade command.

User response

Reissue the db2ckupgrade command, specifying valid parameters.

DBT5545I The db2ckupgrade utility did not perform any verification tests because the database is in upgrade pending state. The database is ready to be upgraded.

Explanation

You can verify whether a database is ready to be upgraded by using the db2ckupgrade utility. The db2iupgrade utility calls the db2ckupgrade command internally.

If the db2ckupgrade utility determines that the database is ready to be upgraded, the db2ckupgrade utility puts the database in upgrade pending state.

This message is returned when the db2ckupgrade command is issued to verify a database that is already in upgrade pending state.

You can upgrade the database.

User response

Upgrade the database.

DBT5546W The db2ckupgrade utility completed successfully, however on some databases exclusive access database checks could not be completed.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded. The db2ckupgrade utility requires an exclusive database connection to run all upgrade condition checks.

It tries to get exclusive database connection, but if it fails, it gets shared database connection. Under such a circumstance, it does not check all upgrade conditions.

This message is returned when the db2ckupgrade utility verifies the upgrade condition under shared database connection.

User response

  1. Stop all applications.
  2. Run the db2ckupgrade command again.
  3. To enforce running in exclusive database connection, issue db2ckupgrade with -allChecks parameter.

DBT5547I The db2ckupgrade utility completed successfully. No upgrade conditions were checked. Output log file: log-file.

Explanation

You can verify whether a database is ready to be upgraded by using the db2ckupgrade utility.

The db2ckupgrade utility can also be used to perform some operations other than verifying whether a database is ready to be upgraded. For example: -resetUpgradePending parameter.

This message is returned when the db2ckupgrade utility successfully ran one of those operations and no upgrade conditions were checked.

User response

Optional: Review the contents of the output log file.

DBT5548N The db2ckupgrade utility did not complete successfully. Output log file: log-file.

Explanation

You can verify whether a database is ready to be upgraded by using the db2ckupgrade utility.

The db2ckupgrade utility can also be used to perform some operations other than verifying if a database can be upgraded. For example: resetting upgrade pending state.

This message is returned when the db2ckupgrade utility successfully run those operations, which does no upgrade condition checks.

User response

Review the contents of the output log file.

DBT5549N No upgrade verification tests were performed because the db2ckupgrade utility failed to get an exclusive database connection.

Explanation

You can verify whether or not a database is ready to be upgraded by using the db2ckupgrade utility.

You can control which verification tests the db2ckupgrade utility performs by specifying different command parameters with the db2ckupgrade command. For example, specifying the -allChecks parameter causes the db2ckupgrade utility to perform all tests.

When the -allChecks parameter is specified with the db2ckupgrade command, the db2ckupgrade utility requires an exclusive database connection.

This message is returned when the -allChecks parameter is specified with the db2ckupgrade command but the db2ckupgrade utility failed to get an exclusive database connection.

User response

  1. Review the contents of the output log file.
  2. Stop all applications.
  3. Run the db2ckupgrade command again.

DBT5550W The db2ckupgrade utility failed to complete checks requiring exclusive database access.

Explanation

You can verify whether a database is ready to be upgraded by using the db2ckupgrade utility. The db2ckupgrade utility requires an exclusive database connection to run all upgrade condition checks.

If the db2ckupgrade utility fails to get an exclusive connection, the utility will fall back to using a shared connection. When the db2ckupgrade utility uses a shared connection, it does not test all upgrade conditions.

This message is returned when the db2ckupgrade utility tests only some upgrade conditions because it could only use a shared database connection.

User response

To test all upgrade conditions, perform the following steps:

  1. Stop all applications.
  2. Run the db2ckupgrade command again, specifying the -allChecks parameter.

DBT5551I The db2ckupgrade utility has detected an HADR primary database and has successfully stopped HADR services. The HADR role has been changed to STANDARD.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when database upgrade on an HADR primary database is not supported. In order to proceed with the upgrade procedure, the db2ckupgrade command must stop HADR services and change the HADR role back to STANDARD.

User response

Proceed to continue with the upgrade procedure. The standby database(s) will have to be re-initialized from a backup image post-upgrade.

DBT5552W The db2ckupgrade utility has detected that a table space is in an invalid state on the HADR standby database and needs attention.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

This message is returned when on the HADR standby database a table space is in an invalid or error state. This can be a result of a container or disk problem. A decision must be made how this impacts the upgrade procedure.

User response

A table space error may or may not interfere with the upgrade procedure. Using the DB2 diagnostics log on the standby database, determine what table space is in an invalid state and what error condition exists. Assess whether this table space error will affect your upgrade procedure.

It is possible to proceed with the upgrade procedure but once in the new DB2 version the table space in error cannot be recovered. Post upgrade the table space in error must be dropped and re-created.

Alternatively, issue STOP HADR on the primary database to change the database role back to standard and proceed with the upgrade procedure. The HADR environment will have to be reinitialized post upgrade.

DBT5553N The db2ckupgrade utility failed because the database has one or more tablespaces with file system caching on and has at least one container on raw device.

User response

DBT5554N The db2ckupgrade utility failed because the database has one or more tables in admin move table in progress state.

User response

DBT5555N The db2ckupgrade utility failed because the database has one or more invalid objects.

User response

DBT5556W One or more table(s) might encounter APAR IV53366. Execute db2checkCOL tool to determine if your database is affected.

User response

DBT5557N The db2ckupgrade utility failed because the SYSTEMP table space requires more space in order to complete the upgrade.

Explanation

The db2ckupgrade command is used to verify if a database can be upgraded.

Typically, amount of free space defined by SYSTEMP should be at least the same as the current amount of used space.

This message is returned when SYSTEMP has less than 50% free pages left.

User response

  • Increase the size of existing containers. You can also add additional containers although this might trigger data rebalancing.
  • Optional: You can reduce the size of the containers after upgrade.