DB2 Connect Version 9
DB2 Connect Version 9
DB2 Connect Version 9
DB2 Connect Version 9
GC10-4243-00
DB2 ®
DB2 Connect Version 9
GC10-4243-00
Before using this information and the product it supports, be sure to read the general information under Notices.
Edition Notice
This document contains proprietary information of IBM. It is provided under a license agreement and is protected
by copyright law. The information contained in this publication does not include any product warranties, and any
statements provided in this manual should not be interpreted as such.
You can order IBM publications online or through your local IBM representative.
v To order publications online, go to the IBM Publications Center at www.ibm.com/shop/publications/order
v To find your local IBM representative, go to the IBM Directory of Worldwide Contacts at www.ibm.com/
planetwide
To order DB2 publications from DB2 Marketing and Sales in the United States or Canada, call 1-800-IBM-4YOU
(426-4968).
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any
way it believes appropriate without incurring any obligation to you.
© Copyright International Business Machines Corporation 1993, 2006. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Part 1. Introduction to DB2 Connect 1 Installation requirements for DB2 Connect server
products (AIX) . . . . . . . . . . . . 39
Installation requirements for DB2 Connect server
Chapter 1. About DB2 Connect . . . . . 3 products (HP-UX) . . . . . . . . . . . 40
DB2 Connect product offerings . . . . . . . . 3 Installation requirements for DB2 Connect server
Host and iSeries support for DB2 Connect . . . . 3 products (Linux) . . . . . . . . . . . . 41
Installation requirements for DB2 Connect server
Chapter 2. DB2 Connect scenarios . . . 5 products (Solaris) . . . . . . . . . . . 41
Accessing host or iSeries DB2 data using DB2
Connect . . . . . . . . . . . . . . . . 5 Chapter 10. Preparing Windows for
Access DB2 data from remote clients . . . . . . 9 LDAP . . . . . . . . . . . . . . . 43
Accessing DB2 host data from the web using Java 10
Extending the directory schema (Windows) . . . . 43
Managing connections to databases using the
Configuration Assistant (Linux and Windows) . . . 11
Understanding the Administration Server . . . . 12 Chapter 11. Preinstallation tasks. . . . 45
Administering instances and databases with the IBM Software Development Kit for Java levels for
DB2 administration tools (Linux and Windows) . . 13 DB2 products . . . . . . . . . . . . . . 45
DB2 Client support for database application Kernel parameters (UNIX) . . . . . . . . . 46
development . . . . . . . . . . . . . . 15 Modifying kernel parameters (HP-UX) . . . . 46
Recommended kernel configuration parameters
(HP-UX) . . . . . . . . . . . . . . 46
Part 2. Migrating DB2 Connect . . . 17 Modifying kernel parameters (Linux) . . . . . 47
Modifying kernel parameters (Solaris Operating
Chapter 3. Migration to DB2 Connect Environment) . . . . . . . . . . . . . 48
Version 9 . . . . . . . . . . . . . . 19
Chapter 12. Installation tasks . . . . . 51
Chapter 4. Migration essentials for DB2 Installing DB2 Connect (Windows) . . . . . . 51
Connect . . . . . . . . . . . . . . 21 Installing a DB2 Connect server product
(Windows). . . . . . . . . . . . . . 51
Installing DB2 Connect (UNIX) . . . . . . . . 52
Chapter 5. Pre-migration tasks for DB2 Installing a DB2 Connect server product (AIX). . 52
Connect servers . . . . . . . . . . 23 Installing a DB2 Connect server product (HP-UX) 54
Installing a DB2 Connect server product (Linux) 55
Chapter 6. Migrating DB2 Connect Preparing to install DB2 for Linux on zSeries . . 56
servers . . . . . . . . . . . . . . 25 Installing a DB2 Connect server product (Solaris) 57
Related tasks:
v “Installing a DB2 Connect server product (AIX)” on page 52
v “Installing a DB2 Connect server product (HP-UX)” on page 54
v “Installing a DB2 Connect server product (Linux)” on page 55
v “Installing a DB2 Connect server product (Solaris)” on page 57
v “Installing a DB2 Connect server product (Windows)” on page 51
v “Installing DB2 Connect Personal Edition (Linux)” in Quick Beginnings for DB2
Connect Personal Edition
v “Installing DB2 Connect Personal Edition (Windows)” in Quick Beginnings for
DB2 Connect Personal Edition
See http://www.ibm.com/servers/eserver/zseries/
zos/servicetst/
Related concepts:
v “DB2 Connect” in DB2 Connect User’s Guide
v “Accessing host or iSeries DB2 data using DB2 Connect” on page 5
Related tasks:
v “Configuring a connection to host or iSeries database servers using the CA
(Linux and Windows)” on page 79
Related reference:
v “Host databases” in DB2 Connect User’s Guide
In organizations with large amounts of data, DB2 UDB for iSeries, DB2 UDB for
OS/390 and z/OS, or DB2 Server for VSE & VM are commonly used to manage
that data. Applications that run on any of the supported platforms can work with
this data transparently, as if a local database server managed it. A DB2 Connect
server product, such as DB2 Connect Enterprise Edition, is required for supporting
applications which access host or iSeries data and exploit transaction monitors as
well as applications that are implemented as Java applets.
A DB2 Connect server product, such as DB2 Connect Enterprise Edition, is most
appropriate for environments where:
v Application is implemented using data-aware Java applets (see Figure 5 on page
11).
v Web servers are used to implement web-based applications (see Figure 4 on page
9 and Figure 5 on page 11).
v Middle-tier application server is employed.
v Transaction monitors such as IBM® TXSeries® CICS® and Encina® Monitor,
WebSphere Application Server, WebSphere MQ, Microsoft Transaction Server
(MTS), and BEA Tuxedo are used. (See Figure 2 on page 7.)
DB2 Connect provides transparent access to host or iSeries data through a standard
architecture for managing distributed data. This standard is known as Distributed
Relational Database Architecture (DRDA). DRDA allows your applications to
establish a fast connection to host and iSeries databases without expensive host or
iSeries components or proprietary gateways.
A DB2 Connect server enables multiple clients to connect to host or iSeries data
and can significantly reduce the effort that is required to establish and maintain
access to enterprise data. Figure 1 illustrates IBM’s solution for environments
where a DB2 client makes an indirect connection to a host or iSeries database
server through a DB2 Connect server product.
To connect to an IBM host or iSeries database server you require a licensed DB2
Connect product. You cannot connect directly to an IBM host or iSeries Data Server
using a DB2 client.
Figure 1. Connecting a client to a host or iSeries data server using DB2 Connect
Related concepts:
v “DB2 Connect server products: installation and configuration overview” on page
33
Related reference:
v “DB2 Connect product offerings” on page 3
Related concepts:
Programming languages containing embedded SQL are called host languages. Java
differs from the traditional host languages C, COBOL, and FORTRAN, in ways
that significantly affect how it embeds SQL:
v SQLJ and JDBC are open standards, enabling you to easily port SQLJ or JDBC
applications from other standards-compliant database systems to the DB2
database.
v All Java types representing composite data, and data of varying sizes, have a
distinguished value, null, which can be used to represent the SQL NULL state,
giving Java programs an alternative to NULL indicators that are a fixture of
other host languages.
v Java is designed to support programs that, by nature, are heterogeneously
portable (also called ″super portable″ or simply ″downloadable″). Along with
Java’s type system of classes and interfaces, this feature enables component
software. In particular, an SQLJ translator written in Java can call components
that are specialized by database vendors in order to leverage existing database
functions such as authorization, schema checking, type checking, transactional,
and recovery capabilities, and to generate code optimized for specific databases.
v Java is designed for binary portability in heterogeneous networks, which
promises to enable binary portability for database applications that use static
SQL.
v You can run JDBC applets inside a web page on any system with a Java-enabled
browser, regardless of the platform of your client. Your client system requires no
additional software beyond this browser. The client and the server share the
processing of JDBC and SQLJ applets and applications.
JDBC and SQLJ applications can be run from any system that has a DB2 client
installed; a Web browser and a Web server are not required.
Related concepts:
v “Managing connections to databases using the Configuration Assistant (Linux
and Windows)” on page 11
v “Supported drivers for JDBC and SQLJ” in Developing Java Applications
Related concepts:
v “Client-to-server communications configuration overview” in Quick Beginnings
for DB2 Clients
Related tasks:
v “Configuring a database connection manually using the Configuration Assistant”
on page 102
v “Configuring database connections using a client profile with the Configuration
Assistant” in Quick Beginnings for DB2 Clients
v Chapter 21, “Binding database utilities on DB2 Connect,” on page 87
v “Configuring a connection to host or iSeries database servers using the CA
(Linux and Windows)” on page 79
Related concepts:
v “DB2 Administration Server” in Administration Guide: Implementation
Related tasks:
v “Creating a DB2 administration server (DAS)” in Administration Guide:
Implementation
Note: In previous releases, the DB2 Administration Tools, such as the Control
Center, were supported on all platforms. As of Version 9, the DB2
Administration Tools are supported only on Windows x86, Windows x64
(AMD64/EM64T), Linux on x86, and Linux on AMD64/EM64T. For all
platforms, you can use the DB2 command line processor (CLP) to administer
instances and databases.
If you want to access DB2 UDB for z/OS functions from the Control Center:
1. Verify that:
v You have a DB2 UDB for z/OS license
v You have a DB2 Connect product installed on the client workstation
v Distributed Data Facility (DDF) is started at the host
v The DB2 subsystem is cataloged on the client
v The DB2 Connect utilities and the DB2 CLI are bound to the host
2. Apply the FMIDs for the DB2 Management Clients Package (a feature of DB2
UDB for z/OS) and DB2 Administration Server (DAS) for OS/390 and z/OS.
DAS is an optional feature that is shipped with DB2 for OS/390 and z/OS
server. Read the DB2 UDB for z/OS, DB2 Management Clients Package, and
DB2 Administration Server for OS/390 and z/OS program directories. The
program directory identifies and describes the contents of FMIDs for each tape
or cartridge. The program directory also provides the installation requirements
and instructions.
3. Apply any additional service to DB2 UDB for z/OS as described in the
program directories.
Detailed instructions for enabling the Control Center to work with DB2 UDB for
z/OS exists at:
http://www.ibm.com/support/docview.wss?rs=64&context=SSEPEK&q1=jdb881d&uid=swg27006262
The Control Center allows you to view, update, and reset server protocol settings
in the database manager configuration file. These functions are accessed by clicking
with the right mouse button on an instance and selecting the Setup
communications option from the pop-up menu. By default, the setup program
automatically detects and configures most communication protocols that it detects
on your system.
You can also perform the following operations with the Control Center:
v Configure database manager parameters by clicking with the right mouse button
on an instance and selecting the Configure option from the pop-up menu.
v Export database information in a profile that can be used to configure clients by
clicking with the right mouse button on a system and selecting the Export
Server Profile option from the pop-up menu.
Related tasks:
v Chapter 21, “Binding database utilities on DB2 Connect,” on page 87
Related concepts:
v “Types of clients - DB2 Runtime Client and DB2 Client” in Quick Beginnings for
DB2 Clients
Related reference:
v “Support for elements of the database application development environment” in
Getting Started with Database Application Development
The migration process consists of all the tasks that you need to perform to have
your environment running successfully on a new release. The migration of each of
the components in your environment to DB2 Connect Version 9 requires that you
perform different tasks:
v Chapter 6, “Migrating DB2 Connect servers,” on page 25 involves migrating
your existing instances, any existing DB2 Connect federated databases, and any
existing transaction manager databases so that they can run in DB2 Connect
Version 9.
v Migrating DB2 servers involves migrating your existing instances and databases
so that they can run in DB2 Version 9. Refer to the Migration overview for DB2
servers topic in the Migration Guide.
v Migrating DB2 clients involves migrating your client instances to keep the
configuration of your existing DB2 clients. Refer to the Migration overview for
DB2 clients topic in the Migration Guide.
v Migrating database applications involves testing them in DB2 Connect Version 9
and modifying them only when you need to support changes in DB2 Connect
Version 9. Review Changes in existing functionality and Discontinued and
deprecated functionality in the What's new for V9.1: DB2 Connect enhancements
summary topic to determine the changes that could impact your database
applications. If your database applications connect to DB2 servers, review also
the Migration overview for database applications and routines topic in the
Migration Guide.
Perform the following pre-migration tasks for DB2 servers that also apply to DB2
Connect servers:
1. Review the Chapter 4, “Migration essentials for DB2 Connect,” on page 21 to
identify the changes or restrictions that can affect your migration and learn
how to address any issues prior to migration.
2. Save configuration information to have a record of your current configuration
that you can compare with the configuration after the migration. You can also
use this information to create new instances or databases using the same
configuration that you had before migration. For details, refer to the Saving
configuration information topic in the Migration Guide.
3. Optional: If you enabled the Syncpoint Manager (SPM) functionality on your
DB2 Connect server, ensure that the DRDA sync point managers do not
contain any indoubt transactions by using the LIST DRDA INDOUBT
TRANSACTIONS command to get a list of indoubt transactions and to
interactively resolve any indoubt transactions.
4. Optional: If you have transaction manager databases, perform the following
pre-migration tasks to prepare your databases for migration:
a. Ensure that the database to be migrated does not contain any indoubt
transactions by using the LIST INDOUBT TRANSACTIONS command to
get a list of indoubt transactions and to interactively resolve any indoubt
transactions.
b. Verify that your databases are ready for DB2 Connect migration to identify
and resolve any problems before the actual migration. For details, refer to
the Verifying that your databases are ready for migration topic in the
Migration Guide.
c. Back up your databases to be able to migrate them to a new migrated
system or restore them in the original pre-migration system. For details,
refer to the Backing up databases before migration topic in the Migration
Guide.
d. Review the Disk space requirements for DB2 server migration topic in the
Migration Guide to ensure that you have enough free disk space, temporary
table space and log space for database migration and increase table space
and log file sizes if necessary. For details, refer to the Increasing table
space and log file sizes before migration topic in the Migration Guide.
e. Linux only: Change raw devices to block devices. For details, refer to the
Changing raw devices to block devices (Linux) topic in the Migration
Guide.
5. Optional: If you have DB2 Connect federated databases, refer to the Preparing
to migrate to federated systems topic in the IBM WebSphere Information
Integration: Migrating to Federation Version 9 for details on pre-migrations tasks
for these databases.
6. Windows only: If you obtained customized code page conversion tables from
the DB2 support service, you need to backup all of the files in the
DB2OLD\conv directory where DB2OLD is the location of your existing DB2
Since DB2 Connect server products are host database connectivity servers, the only
databases that can exist within a DB2 Connect server instance are transaction
manager databases and DB2 Connect federated databases. The DB2 Connect
transaction manager database stores transaction state information for DB2
coordinated transactions. The sole purpose of DB2 Connect federated databases is
to contain information about data sources.
On Linux and UNIX platforms, you should manually migrate your DB2 Connect
instances after installing DB2 Connect Version 9. All the remote nodes and
databases that you cataloged on the DB2 clients refer to these instances. If you
create a new instance, again you will have to catalog nodes, DCS databases, and
databases on the DB2 clients that existed in the DB2 Version 8 instance.
This procedure describes how to migrate by installing a new copy of DB2 Connect
Version 9 and then migrate instances and any existing databases. To automatically
migrate an existing DB2 Connect Version 8 copy on Windows, follow the same
steps specified in the Migrating a DB2 server (Windows) topic in the Migration
Guide.
Prerequisites:
Restrictions:
For DB2 Connect Version 6 or DB2 Connect Version 7, you must migrate to DB2
Connect Version 8 first. Refer to the following topic for details:
http://publib.boulder.ibm.com/infocenter/db2luw/v8/topic/
com.ibm.db2.udb.doc/conn/t0008566.htm
Procedure:
This profile contains all of the instance configuration information, including the
database manager configuration and registry profile because the option backup
is specified. You can use this profile to recreate your connectivity configuration
if necessary.
2. Install DB2 Connect Version 9 by running the DB2 Setup wizard and select the
option Install New on the Install a Product panel.
3. Migrate instances using the db2imigr command.
4. Migrate any existing transaction manager and DB2 Connect federated databases
under your migrated instances using the MIGRATE DATABASE command.
You can also migrate your databases by restoring a DB2 Connect Version 8
backup.
After migrating the DB2 Connect server, perform the recommended Chapter 7,
“Post-migration tasks for DB2 Connect servers,” on page 29 such as resetting the
diagnostic error level, adjusting log space size, and rebinding packages, and
verifying that your migration was successful.
Related concepts:
v “Migration overview for DB2 clients” in Migration Guide
v “Migration recommendations for DB2 servers” in Migration Guide
v “Migration restrictions for DB2 servers” in Migration Guide
Related tasks:
v “Creating links for DB2 files” in Installation and Configuration Supplement
v “Backing up databases before migration” in Migration Guide
v “Migrating a DB2 server (Linux and UNIX)” in Migration Guide
v “Migrating a DB2 server (Windows)” in Migration Guide
v “Migrating databases” in Migration Guide
v “Migrating instances” in Migration Guide
v “Verifying that your databases are ready for migration” in Migration Guide
Related reference:
v “db2imigr - Migrate instance command” in Command Reference
v “MIGRATE DATABASE command” in Command Reference
v “Disk space requirements for DB2 server migration” in Migration Guide
Perform the following post-migration tasks for DB2 servers that also apply to DB2
Connect servers:
1. If you set the diaglevel database manager configuration parameter to 4 as
recommended in the pre-migration tasks for DB2 Connect servers, reset this
parameter to the value set before the migration.
2. Review Changes in DB2 registry variables, configuration parameters, and
database physical design characteristics topic in the Migration Guide. There are
new registry variables, new configuration parameters, and new default values
for registry variables and configuration parameters introduced in DB2 Version 9
that can impact the behavior of your application.
3. Set your DB2 global profile registry variables. The variables that you set at the
global profile level, using the db2set -g command, are not migrated. The global
profile variables apply to all instances pertaining to a specific DB2 Connect
Version 9 copy. Therefore after migration, use the configuration information
that you saved in the pre-migration tasks to restore the values of your global
profile registry variables for every DB2 Connect Version 9 copy. For details,
refer to the Declaring, showing, changing, resetting, and deleting registry and
environment variables topic in the Administration Guide: Implementation.
4. If you obtained customized code page conversion tables from the DB2 support
service, copy all of the files for those tables from the DB2OLD/conv to
DB2DIR/conv, where DB2OLD is the location of your DB2 Connect Version 8
copy and DB2DIR is the location of your DB2 Connect Version 9 copy. You do
not need to copy standard code page conversion tables.
If you migrated your existing DB2 Connect Version 8 copy on Windows
operating systems, you can restore the customized code page conversion tables
that you backed up as part of the pre-migration tasks for DB2 servers to the
DB2PATH\conv directory, where DB2PATH is the location of your DB2 Connect
Version 9 copy.
5. Optional: If you migrated any databases in your DB2 Connect server and
changed the log space setting as recommended in the pre-migration tasks for
DB2 Connect servers, adjust the log space size. Ensure that the amount of log
space that you allocate is adequate for your DB2 Connect server. For details,
refer to the Adjusting the log space size in migrated databases topic in the
Migration Guide.
Also, back up your databases after the migration is complete.
6. Optional: If you have DB2 Connect federated databases, review the Configuring
federated systems after migration topic in the IBM WebSphere Information
Integration: Migrating to Federation Version 9 to determine if you need to perform
any tasks after you migrate your federated databases.
7. Verify that your DB2 Connect server migration was successful. Test connections
to all your cataloged databases. The following example shows how to test a
connection from the Command Line Processor (CLP):
db2 CONNECT TO DATABASE sample user mickey using mouse
At this point, you should resume all of your maintenance activities. You should
also remove any DB2 Connect Version 8 copies that you no longer need.
If you are planning to migrate from a previous version of DB2 Connect, see Part 2,
″Migrating DB2 Connect″.
To manually install your DB2 Connect product, refer to the Installing a DB2
product manually topic in the Installation and Configuration Supplement.
The typical steps to installing and configuring a DB2 Connect server product are as
follows:
1. Determine how you want to use DB2 Connect in your network.
2. Verify that you have the correct hardware and software prerequisites on both
your workstation and the host database server.
3. Verify that your host or iSeries database server is configured to accept
connections from DB2 Connect servers.
4. Install your DB2 Connect software. You will use this workstation to configure
and verify your host and iSeries connections.
5. After installation, establish the connection between DB2 Connect and your
host or iSeries database system. DB2 Connect can locate and configure all
TCP/IP connections for you. You can use the Configuration Assistant (CA) or
the DB2 command line processor (CLP) to configure host or iSeries databases.
6. Bind the programs and utilities provided with DB2 Connect to your host or
iSeries database.
7. Test the connection.
8. (Optional) Enable the Multisite Update feature.
9. If you are planning to use WebSphere®, transaction monitors, or your own
application server software, install these products or applications. For
information on installing WebSphere consult the documentation provided with
these products as part of the DB2 Connect server product package. For other
products consult the installation documentation provided with the product.
10. Install and configure the DB2 client. Use this workstation to test connectivity
from the DB2 client to host and iSeries database servers, as well as to test
applications that use this connectivity.
11. Use the Configuration Assistant to connect the client to the host or iSeries
system through DB2 Connect.
12. Install DB2 clients on all end-user workstations that will use applications that
connect to host and iSeries database servers.
13. You are now ready to use DB2 Connect with all your applications.
Workstations that will be used for application development should have the
DB2 client installed.
14. If you want to use your workstation to administer DB2 UDB for OS/390 and
z/OS or DB2 Database for Linux, UNIX, and Windows, install the DB2 client.
Related tasks:
v Chapter 21, “Binding database utilities on DB2 Connect,” on page 87
The disk space required for your product depends on the type of installation you
choose and the type of file system you have. The DB2 Setup wizard provides
dynamic size estimates based on the components selected during a typical,
compact, or custom installation.
On Windows, you might require significantly more space on FAT (File Allocation
Table) drives with large cluster sizes than with NTFS (New Technology File
System) drives.
Memory requirements:
Related concepts:
v “Self tuning memory” in Performance Guide
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
the following requirements must be met:
Related concepts:
v “Non-Administrator installation of DB2 Connect (Windows)” in Quick Beginnings
for DB2 Connect Personal Edition
Related tasks:
v “Installing a DB2 Connect server product (Windows)” on page 51
Related reference:
v “IBM Software Development Kit for Java levels for DB2 products” on page 45
The installation user account is the account of the user performing the installation.
The installation user account must be defined prior to running the DB2 Setup
wizard. The setup user accounts can be defined prior to installation or you can
have the DB2 Setup wizard create them for you.
DB2 products offer extended Windows security. You can install DB2 with a user ID,
but unless that user ID belongs to either the DB2ADMNS or DB2USERS group,
that user ID won’t be able to run any DB2 commands.
The DB2 installer creates these two new groups. You can either specify a new
name during a custom installation or accept the default names.
To enable this security feature, select the Enable operating system security check
box on the Enable operating system security for DB2 objects panel during the
DB2 installation. Accept the default values for the DB2 Administrators Group field,
and the DB2 Users Group field. The default group names are DB2ADMNS and
DB2USERS. If there is a conflict with existing group names, you will be prompted
to change the group names. If required, you can specify your own values.
If extended security is enabled, then the DB2ADMNS group will have all
these privileges. You can simply add users to that group and you do not
need to add these privileges explicitly. However, the user still needs to be a
member of the Local Administrators group.
If the user account is created by the install program, the user account will
be granted these privileges and if the user account already exists, this
account will also be granted these privileges. If the install grants the
privileges, some of them will only be effective on first log-on by the
account that was granted the privileges or upon reboot.
Related concepts:
v “User, user ID and group naming rules” in Administration Guide: Implementation
Related tasks:
v “An overview of installing your DB2 product (Windows)” in Quick Beginnings for
DB2 Servers
v “Setting up Windows elevated privileges prior to installing a DB2 product
(Windows)” in Quick Beginnings for DB2 Servers
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
the following requirements must be met:
Hardware requirements
v IBM RISC/6000
v eServer™ pSeries®
Related tasks:
v “Installing a DB2 Connect server product (AIX)” on page 52
Related reference:
v “IBM Software Development Kit for Java levels for DB2 products” on page 45
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
on HP-UX, the following operating system, software, and communication
requirements must be met:
Hardware requirements
v HP 9000 Series 700 or 800 system
v HP Integrity Series server
Operating system requirements
DB2 Connect server products can run on HP-UX 11i v2 (11.23.0505) for
Itanium-based systems with:
v May 2005 Base Quality (QPKBASE) bundle
v May 2005 Applications Quality (QPAPPS) bundle
Software requirements
A browser is required to view online help.
Communication requirements
You can use TCP/IP
v For TCP/IP connectivity, no additional software is required.
Related tasks:
v “Installing a DB2 Connect server product (HP-UX)” on page 54
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
the following hardware, distribution, software, and communication requirements
must be met:
Hardware requirements
Your processor can be:
v x86 ( Intel Pentium®, Intel Xeon®, and AMD Athlon)
v x86–64 (Intel EM64T and AMD64)
v POWER™ (any iSeries or pSeries that support Linux)
v eServer zSeries
Distribution requirements
For the latest information on supported Linux distributions, point your
browser to http://www.ibm.com/db2/linux/validate.
You might be required to update your kernel configuration parameters.
The kernel configuration parameters are set in /etc/sysctl.conf. See the
Modifying kernel parameters (Linux) section of the DB2 Information
Center. Refer to your operating system manual for information on setting
and activating these parameters using the sysctl command.
Software requirements
v An X Window System software capable of rendering a graphical user
interface is required if you want to use the DB2 Setup wizard to install
DB2 Connect or if you want to use any DB2 graphical tools.
v A browser is required to view online help.
Communication requirements
For TCP/IP connectivity, no additional software is required.
Related tasks:
v “Installing a DB2 Connect server product (Linux)” on page 55
Related reference:
v “IBM Software Development Kit for Java levels for DB2 products” on page 45
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
the following operating system, software, and communication requirements must
be met:
Related tasks:
v “Installing a DB2 Connect server product (Solaris)” on page 57
Related reference:
v “IBM Software Development Kit for Java levels for DB2 products” on page 45
If you decide to install your DB2 product and create databases before you extend
the directory schema, you will have to manually register the node and catalog the
databases.
Prerequisites:
Procedure:
Related reference:
v “Installation requirements for DB2 clients and servers (Windows)” in Quick
Beginnings for DB2 Servers
v “CATALOG LDAP DATABASE command” in Command Reference
v “REGISTER command” in Command Reference
If the IBM SDK for Java is required by a component being installed and the SDK
for Java is not already installed in that path, the SDK for Java will be installed if
you use either the DB2 Setup wizard or a response file to install the product.
The SDK for Java is not installed with the DB2 Runtime client.
The following table lists the installed SDK for Java levels for DB2 according to
operating system platform:
Notes:
1. With the exception of HP-UX, Linux on IPF, Solaris Operating Environment,
and Windows IA64, although the table above lists the installed SDK for Java
levels, SDK 1.4.2 to SDK 5 is also supported. The SDK for Java levels can be
downloaded from the developerWorks® web page at: http://www.ibm.com/
developerworks/java/jdk/index.html
Note: For Windows operating system platforms, use the IBM Development
Package for Eclipse downloads.
2. DB2 GUI tools only run on Linux on x86, Linux on AMD64/EM64T, Windows
x86, and Windows x64.
3. On Windows x86 and Linux on x86:
v the 32-bit SDK is installed
v 32-bit applications and Java external routines are supported
4. On Linux on IPF:
v only 64-bit applications and Java external routines are supported
5. On all supported platforms (except Windows x86, Linux on x86, and Linux on
IPF):
Related tasks:
v “Installing DB2 servers (Linux and UNIX)” in Quick Beginnings for DB2 Servers
v “Installing DB2 servers (Windows)” in Quick Beginnings for DB2 Servers
Prerequisites:
Procedure:
Related reference:
v “db2osconf - Utility for kernel parameter values command” in Command
Reference
Related tasks:
v “Modifying kernel parameters (HP-UX)” on page 46
Prerequisites:
Procedure:
Beginning with the first section on Shared Memory Limits, SHMMAX and
SHMALL are the parameters that need to be looked at. SHMMAX is the
maximum size of a shared memory segment on a Linux system whereas
SHMALL is the maximum allocation of shared memory pages on a system.
Run sysctl with -p parameter to load in sysctl settings from the default file
/etc/sysctl.conf.
sysctl -p
Related tasks:
v “Installing DB2 servers (Linux and UNIX)” in Quick Beginnings for DB2 Servers
Related reference:
v “Installation requirements for DB2 clients and servers (Linux)” in Quick
Beginnings for DB2 Servers
To use the db2osconf command, you must first install the DB2 database system.
The db2osconf utility can only be run from $DB2DIR/bin, where $DB2DIR is the
directory where you installed your DB2 product.
Procedure:
To set a kernel parameter, add a line at the end of the /etc/system file as follows:
set parameter_name = value
For example, to set the value of the msgsys:msginfo_msgmax parameter, add the
following line to the end of the /etc/system file:
set msgsys:msginfo_msgmax = 65535
Related reference:
v “db2osconf - Utility for kernel parameter values command” in Command
Reference
Prerequisites:
Procedure:
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
on Windows:
1. Log on to the system as a user with administrator authority.
2. Close all programs so the installation program can update files as required.
3. Insert the CD into the drive. The auto-run feature automatically starts the DB2
Setup wizard. The DB2 Setup wizard will determine the system language and
launch the setup program for that language. If you want to run the setup
program in a different language, or the setup program failed to auto-start, you
can run the DB2 Setup wizard manually.
4. The DB2 Launchpad opens. From this window, you can view the installation
prerequisites and the release notes, or you can proceed directly to the
installation.
5. Once you have initiated the installation, proceed by following the setup
program’s prompts. Online help is available to guide you through the
remaining steps. Click Help to invoke the online help. You can click Cancel at
any time to exit the installation.
A log file stores general information and error messages resulting from the install
and uninstall activities. The file name of the log follows the format DB2-<Product
where:
v x: represents your CD drive
v language represents the territory code for your language (for example, EN for
English).
3. Click OK.
If you want your DB2 product to have access to DB2 documentation either on your
local computer or on another computer on your network, then you must install the
DB2 Information Center. The DB2 Information Center contains documentation for
the DB2 database and DB2 related products. See “Installing the DB2 Information
Center using the DB2 Setup wizard (Windows)”.
Related concepts:
v “DB2 installation methods” in Quick Beginnings for DB2 Servers
v “DB2 Information Center installation options” in Quick Beginnings for DB2 Servers
Related tasks:
v “Extending the directory schema (Windows)” on page 43
v “Installing the DB2 Information Center using the DB2 Setup wizard (Windows)”
in Quick Beginnings for DB2 Servers
v “Applying fix packs” on page 63
Related reference:
v “Installation requirements for DB2 Connect server products (Windows)” on page
35
Prerequisites:
Procedure:
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
on AIX:
1. Change to the directory where the CD is mounted:
cd /cdrom
If you want your DB2 product to have access to DB2 documentation either on your
local computer or on another computer on your network, then you must install the
DB2 Information Center. The DB2 Information Center contains documentation for
the DB2 database and DB2 related products. See Installing the DB2 Information
Center using the DB2 Setup wizard (UNIX).
Related concepts:
v “DB2 installation methods” in Quick Beginnings for DB2 Servers
v “DB2 Information Center installation options” in Quick Beginnings for DB2 Servers
v “Multiple CD installation (Linux and UNIX)” in Quick Beginnings for DB2 Servers
Related tasks:
v “Mounting the CD-ROM (AIX)” on page 93
v “Installing the DB2 Information Center using the DB2 Setup wizard (Linux)” in
Quick Beginnings for DB2 Servers
v “Applying fix packs” on page 63
v “Listing DB2 products installed on your system (Linux and UNIX)” in Quick
Beginnings for DB2 Servers
Related reference:
v “Installation requirements for DB2 Connect server products (AIX)” on page 39
Prerequisites:
Procedure:
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
on HP-UX:
1. Change to the directory where the CD is mounted by entering the following
command:
cd /cdrom
Related concepts:
v “DB2 Information Center installation options” in Quick Beginnings for DB2 Servers
v “Multiple CD installation (Linux and UNIX)” in Quick Beginnings for DB2 Servers
v “DB2 installation methods” in Quick Beginnings for DB2 Servers
Related tasks:
v “Mounting the CD-ROM (HP-UX)” on page 94
v “Installing the DB2 Information Center using the DB2 Setup wizard (Linux)” in
Quick Beginnings for DB2 Servers
v “Listing DB2 products installed on your system (Linux and UNIX)” in Quick
Beginnings for DB2 Servers
v “Applying fix packs” on page 63
v “Installing a DB2 product using the db2_install or doce_install command (Linux
and UNIX)” in Installation and Configuration Supplement
Related reference:
v “Installation requirements for DB2 Connect server products (HP-UX)” on page
40
Prerequisites:
Procedure:
If you want your DB2 product to have access to DB2 documentation either on your
local computer or on another computer on your network, then you must install the
DB2 Information Center. The DB2 Information Center contains documentation for
the DB2 database and DB2 related products. See “Installing the DB2 Information
Center using the DB2 Setup wizard (Linux)”.
Related concepts:
v “DB2 installation methods” in Quick Beginnings for DB2 Servers
v “DB2 Information Center installation options” in Quick Beginnings for DB2 Servers
v “Multiple CD installation (Linux and UNIX)” in Quick Beginnings for DB2 Servers
Related tasks:
v “Mounting the CD-ROM (Linux)” on page 94
v “Installing the DB2 Information Center using the DB2 Setup wizard (Linux)” in
Quick Beginnings for DB2 Servers
v “Listing DB2 products installed on your system (Linux and UNIX)” in Quick
Beginnings for DB2 Servers
v “Installing a DB2 product using the db2_install or doce_install command (Linux
and UNIX)” in Installation and Configuration Supplement
Related reference:
v “Installation requirements for DB2 Connect server products (Linux)” on page 41
v “Availability of Asian fonts (Linux)” in Administration Guide: Planning
Prerequisites:
where yourserver.com represents the FTP server where the DB2 product
installation image resides.
2. Enter your user ID and password.
3. Enter the following commands:
bin
get product file
Using the DB2 product CD over NFS to access the installation image:
Related tasks:
v “Installing a DB2 Connect server product (Linux)” on page 55
v “Mounting the CD-ROM (Linux)” on page 94
Prerequisites:
Procedure:
To install a DB2 Connect server product, such as DB2 Connect Enterprise Edition,
on the Solaris operating system:
1. Change to the directory where the CD is mounted by entering the following
command:
cd /cdrom
If you want your DB2 product to have access to DB2 documentation either on your
local computer or on another computer on your network, then you must install the
DB2 Information Center. The DB2 Information Center contains documentation for
the DB2 database and DB2 related products. See Installing the DB2 Information
Center using the DB2 Setup wizard (UNIX).
Related concepts:
v “DB2 installation methods” in Quick Beginnings for DB2 Servers
v “DB2 Information Center installation options” in Quick Beginnings for DB2 Servers
v “Multiple CD installation (Linux and UNIX)” in Quick Beginnings for DB2 Servers
Related tasks:
v “Installing a DB2 product manually” in Installation and Configuration Supplement
v “Mounting the CD-ROM (Solaris Operating Environment)” on page 95
v “Listing DB2 products installed on your system (Linux and UNIX)” in Quick
Beginnings for DB2 Servers
v “Installing the DB2 Information Center using the DB2 Setup wizard (Linux)” in
Quick Beginnings for DB2 Servers
v “Applying fix packs” on page 63
Prerequisites:
v You must have installed a DB2 product.
v You must have selected the Enable operating system security check box on the
Enable operating system security for DB2 object panel during the installation of
your DB2 product.
Procedure:
If you did the install and chose not to enable the new security feature you can still
do so post-install by running the db2extsec.exe command.
Once you enable this security feature using the db2extsec.exe command, you have
two options for backing out:
1. Run the db2extsec.exe command again immediately WITHOUT making any
additional changes to the system. If there have been any changes at all made to
the system you must use option 2.
2. Add the Everyone group to the DB2ADMNS and DB2USERS groups.
Related concepts:
v “Extended Windows security using DB2ADMNS and DB2USERS groups” in
Administration Guide: Implementation
Related reference:
v “Required user accounts for installation of DB2 server products (Windows)” on
page 36
Fix packs are cumulative. This means that the latest fix pack for any given version
of DB2 contains all of the updates from previous fix packs for the same version of
DB2. It is recommended that you keep your DB2 environment running at the latest
fix pack level to ensure problem-free operation.
When installing a fix pack on a multi-partition database system, the system must
be offline and all computers participating in the instance must be upgraded to the
same fix pack level.
Prerequisites:
Each fix pack has specific prerequisites. See the Readme that accompanies the fix
pack for details.
Procedure:
1. Access and download the latest DB2 fix pack by selecting the link for fix pack
downloads from the DB2 Support Web site at http://www.ibm.com/software/
data/db2/udb/support.html.
Related reference:
However, if you need to manually activate a license for your DB2 Connect product,
you can use either the DB2 License Center or the db2licm command.
If you want the product or feature license key added automatically during the
installation, you need to copy the license key to the /db2/license directory of the
installation image before launching the DB2 Setup wizard.
Procedure:
where filename is the full pathname and filename for the license file that
corresponds to the product or feature. The license file is located in the
/db2/license directory located on the Activation CD associated with your DB2
product or feature.
Related concepts:
v “License management” in Administration Guide: Implementation
Related tasks:
v “Checking DB2 license compliance” in Installation and Configuration Supplement
Related reference:
v “DB2 product license files” in Installation and Configuration Supplement
If you want the product or feature license key added automatically during the
installation, you need to copy the license key to the /db2/license directory of the
installation image before launching the DB2 Setup wizard.
Procedure:
Related concepts:
v “License management” in Administration Guide: Implementation
Related tasks:
v “Checking DB2 license compliance” in Installation and Configuration Supplement
v “Registering a DB2 product or feature license key using the db2licm command”
on page 64
Related reference:
v “DB2 product license files” in Installation and Configuration Supplement
Procedure:
To set your license policy, perform one of the following depending on the type of
licenses that you purchased. For example:
v If you purchased a WebSphere Information Integrator Connector Concurrent
User license, enter the following command:
db2licm -c wsiif concurrent
v If you purchased a DB2 Connect Server Concurrent User license, enter the
following command:
db2licm -p db2consv concurrent
Related tasks:
v “Registering a DB2 product or feature license key using the db2licm command”
on page 64
Related reference:
v “db2licm - License management tool command” in Command Reference
Procedure:
To set your license policy using the License Center, perform the following
depending on the type of licenses that you purchased:
1. In the License Center, select Change from the License menu.
2. In the Change License window, select the type of license that you have
purchased. For example:
v If you purchased a WebSphere Information Integrator Connector Concurrent
User license, select Connector and enter the number of user licenses that you
purchased.
v If you purchased a DB2 Connect Server Concurrent User license, select
Concurrent users or Concurrent connect users and enter the number of user
licenses that you have purchased.
Related tasks:
v “Registering a DB2 product or feature license key using the License Center” on
page 65
For more information on configuring host and iSeries database servers, refer to the
DB2 for z/OS installation documentation, available at:
http://www.ibm.com/software/data/db2/zos/v8books.html
The sample values used in this section match those used elsewhere in this book.
When you follow the instructions provided you must substitute your own values
for elements such as network name and mode name.
If you anticipate that DB2 for OS/390 or z/OS will participate in a multisite
update transaction (two-phase commit) then refer to the Enabling Multisite Updates
using the Control Center topic.
Procedure:
To prepare DB2 Universal Database for z/OS and OS/390 to receive connection
requests from DB2 Connect, you need to configure your protocol by:
v Configuring TCP/IP for DB2 Universal Database for OS/390 and z/OS
v Configuring DB2 Universal Database for OS/390 and z/OS
Related tasks:
v “Configuring TCP/IP for DB2 Universal Database for OS/390 and z/OS” on
page 69
v “Configuring DB2 Universal Database for OS/390 and z/OS” on page 72
v “Enabling Multisite Updates using the Control Center” in DB2 Connect User’s
Guide
Configuring TCP/IP for DB2 Universal Database for OS/390 and z/OS
This topic describes how to configure TCP/IP communications between your DB2
Connect workstation and DB2 UDB for OS/390 and z/OS Version 7 or later. The
instructions assume the following conditions:
v You are connecting to a single host database via TCP/IP. Multiple host
connections will be handled in exactly the same way, although the port number
and service number required in each case might be different.
v The target database resides on DB2 UDB for OS/390 and z/OS Version 7 or
later.
v All the necessary software prerequisites are installed.
v DB2 clients have been set up as required.
Collecting information:
Before you can use DB2 Connect over a TCP/IP connection, you must collect
information about both the host database server and the DB2 Connect server. For
each host server that you are connecting to via TCP/IP, you must have the
following information:
v The location of the TCP/IP services and hosts files at the DB2 Connect
workstation:
You might want to add the host information to a domain name server to avoid
maintaining this file on multiple systems.
v The locations of the equivalent files at the target DB2 Universal Database for
z/OS and OS/390 host.
v The TCP/IP port number defined to DB2 Universal Database for z/OS and
OS/390.
Note: The associated service name information is not exchanged between the DB2
Connect workstation and DB2 Universal Database for z/OS and OS/390.
Port number 446 has been registered as the default for communication from a
DB2 Connect workstation.
v The TCP/IP addresses and host names for both the host and the DB2 Connect
workstation.
v The LOCATION NAME of the DB2 for OS/390 database server.
v The user ID and password to be used when issuing CONNECT requests to the
database at the host or iSeries server.
Refer to your local network administrator and your DB2 for OS/390 and z/OS
administrator for help getting this information. Use the tables that follow as a
worksheet to plan each TCP/IP connection between DB2 Connect and a host
database server.
Table 2. User Information
Ref. Description Sample Value Your Value
TCP-1 User name A.D.B.User
TCP-2 Contact info (123)-456-7890
TCP-5 User ID ADBUSER
TCP-6 Database type db2390
TCP-7 Connection type (must be TCPIP TCPIP
TCPIP).
Notes:
1. To obtain the host’s IP address TCP-9, enter at the host:
TSO NETSTAT HOME
Use these steps in this section to complete the configuration and make the
connection.
Update the DB2 Universal Database for z/OS and OS/390 host:
Chapter 15. Preparing DB2 for OS/390 and z/OS databases for DB2 Connect communications 71
7. PING the DB2 Connect server, using the correct port number if that option is
supported by TCP/IP on the host system. For example:
ping remote_host_name -p port_number
Note: DB2 Connect does not support the PING command when issued from a
Version 7 client through a Version 9 gateway to the host.
Related tasks:
v “Configuring a connection to host and iSeries database servers using the CLP”
on page 81
v “Configuring a connection to host or iSeries database servers using the CA
(Linux and Windows)” on page 79
v “Preparing DB2 Universal Database for OS/390 and z/OS for connections from
DB2 Connect” on page 69
For DB2 UDB for OS/390 and z/OS Version 7, apply the fixes for APARs PQ50016,
PQ50017 and PK05198.
Related tasks:
v “Configuring TCP/IP for DB2 Universal Database for OS/390 and z/OS” on
page 69
Procedure:
Position to . . . . . .
Relational Remote
_ ____________________
_ DLHX RCHAS2FA
_ JORMT2FA JORMT2FA
_ JORMT4FD JORMT4FD
_ JOSNAR7B RCHASR7B
_ RCHASR7B *LOCAL
_ RCHASR7C RCHASR7C
_ R7BDH3SNA RCH2PDH3
_ RCHASDH3 RCHASDH3
When you have obtained these parameters from your iSeries server, enter your
values into the worksheet that follows:
Table 6. Configuration parameters from iSeries
Item Parameter Example Your value
A-1 Local network name SPIFNET
A-2 Local adapter address 400009451902
A-4 Hostname SYD2101A
A-5 TCP/IP port or service name X'07F6C4C2'(default)
A-6 Relational database name NEW_YORK3
For more information, refer to the “DRDA Considerations” section of the DB2
Server for VSE & VM SQL Reference (SC09-2989).
Related tasks:
v “Preparing DB2 for VSE & VM for connections from DB2 Connect” on page 75
Note: In previous releases, the DB2 Administration Tools, such as the CA, were
supported on all platforms. As of Version 9, the DB2 Administration Tools
are supported only on Windows x86, Windows x64 (AMD64/EM64T), Linux
on x86, and Linux on AMD64/EM64T. For all platforms, you can use the
DB2 command line processor (CLP) to configuring a connection to a host or
iSeries database server.
Prerequisites:
v The Configuration Assistant must be installed on your DB2 Connect workstation.
The Configuration Assistant is available as part of the DB2 client.
v The remote server must be configured to accept inbound client requests. By
default, the server installation program detects and configures most protocols on
the server for inbound client connections.
Procedure:
Related tasks:
v “Configuring a connection to host and iSeries database servers using the CLP”
on page 81
v “Configuring a database connection manually using the Configuration Assistant”
on page 102
v “Configuring database connections using a client profile with the Configuration
Assistant” in Quick Beginnings for DB2 Clients
v “Testing a database connection using the Configuration Assistant” on page 103
Prerequisites:
Before you manually configure a TCP/IP connection between DB2 Connect and a
host or iSeries database server, ensure that:
v TCP/IP is functional on the DB2 Connect server and host or iSeries system.
v You have identified the following parameter values:
– Hostname (hostname) or IP address (ip_address)
– Connection Service name (svcename) or Port number/Protocol
(port_number/tcp)
– Target database name (target_dbname)
– Local database name (local_dcsname)
– Node name (node_name)
Procedure:
Note: Due to the characteristics of the TCP/IP protocol, TCP/IP might not be
immediately notified of a partner’s failure on another host or iSeries. As a
result, a client application accessing a remote DB2 server using TCP/IP, or
the corresponding agent at the server, might sometimes appear to be hung.
The TCP/IP SO_KEEPALIVE socket option is used to detect when there has
been a failure and the TCP/IP connection has been broken.
Related tasks:
v Chapter 21, “Binding database utilities on DB2 Connect,” on page 87
v “Configuring a connection to host or iSeries database servers using the CA
(Linux and Windows)” on page 79
v “Configuring TCP/IP for DB2 Universal Database for OS/390 and z/OS” on
page 69
Related reference:
On Windows operating systems, the following can also access DB2 databases:
v ActiveX Data Objects (ADO) implemented in Microsoft Visual Basic and
Microsoft Visual C++
v Remote Data Objects (RDO) implemented in Microsoft Visual Basic
v Object Linking and Embedding (OLE) Automation Routines (UDFs and Stored
Procedures)
v Object Linking and Embedding Database (OLE DB) table functions
An application on a DB2 client can access a remote database without knowing its
physical location. The DB2 client determines the location of the database, manages
the transmission of the requests to the database server, and returns the results.
Related concepts:
v “Supported database application programming interfaces” in Getting Started with
Database Application Development
Related tasks:
v “Setting up the CLI environment” in Call Level Interface Guide and Reference,
Volume 1
v “Setting up the UNIX ODBC environment” in Call Level Interface Guide and
Reference, Volume 1
v “Setting up the Windows CLI environment” in Call Level Interface Guide and
Reference, Volume 1
Related reference:
v “DB2 Client support for database application development” on page 15
Binding a utility creates a package, which is an object that includes all of the
information that is needed to process specific SQL statements from a single source
file.
The bind files are grouped together in different .lst files in the bnd directory,
under the installation directory (typically sqllib for Windows). Each file is specific
to a server.
Procedure:
Binding to host or iSeries databases
To bind the utilities and applications to the host or iSeries database server,
connect to the host or iSeries server and use the following example as a
template:
connect to dbalias user userid using password
bind path/bnd/@ddcsmvs.lst blocking all sqlerror continue
messages mvs.msg grant public
connect reset
Related reference:
v “BIND command” in Command Reference
v “DB2 CLI bind files and package names” in Call Level Interface Guide and
Reference, Volume 1
For 3-tier environments where host data is accessed from clients, you can find
information about installing and configuring DB2 clients in the Quick Beginnings for
DB2 clients book.
Procedure:
To mount the CD-ROM on AIX using the System Management Interface Tool
(SMIT), perform the following steps:
1. Log in as a user with root authority.
2. Insert the CD-ROM in the drive.
3. Create a CD-ROM mount point by entering the mkdir -p /cdrom command,
where cdrom represents the CD-ROM mount point directory.
4. Allocate a CD-ROM file system using SMIT by entering the smit storage
command.
5. After SMIT starts, select File Systems —> Add / Change / Show / Delete File
Systems —> CDROM File Systems —> Add CDROM File System.
6. In the Add a File System window:
v Enter a device name for your CD-ROM file system in the DEVICE Name
field. Device names for CD-ROM file systems must be unique. If there is a
duplicate device name, you may need to delete a previously-defined
CD-ROM file system or use another name for your directory. In our example,
we will use /dev/cd0 as the device name.
v Enter the CD-ROM mount point directory in the MOUNT POINT window.
In our example, the mount point directory is /cdrom.
v In the Mount AUTOMATICALLY at system restart field, select yes to enable
automatic mounting of the file system.
v Click OK to close the window, then click Cancel three times to exit SMIT.
7. Next, mount the CD-ROM file system by entering the smit mountfs command.
8. In the Mount a File System window:
v Enter the device name for this CD-ROM file system in the FILE SYSTEM
name field. In our example, the device name is /dev/cd0.
v Enter the CD-ROM mount point in the Directory over which to mount field.
In our example, the mount point is /cdrom.
v Enter cdrfs in the Type of Filesystem field. To view the other kinds of file
systems you can mount, click List.
v In the Mount as READ-ONLY system field, select yes.
v Accept the remaining default values and click OK to close the window.
Your CD-ROM file system is now mounted. To view the contents of the CD-ROM,
place the disk in the drive and enter the cd /cdrom command where cdrom is the
CD-ROM mount point directory.
Related tasks:
v “Installing DB2 servers (Linux and UNIX)” in Quick Beginnings for DB2 Servers
Prerequisites:
Procedure:
Your CD-ROM file system is now mounted. To view the contents of the CD-ROM,
place the CD in the drive and enter the cd /cdrom command where cdrom is the
CD-ROM mount point directory.
Related reference:
v “Installation requirements for DB2 clients and servers (HP-UX)” in Quick
Beginnings for DB2 Servers
v “DB2 product license files” in Installation and Configuration Supplement
Procedure:
Related reference:
v “DB2 product license files” in Installation and Configuration Supplement
If you are mounting the CD-ROM drive from a remote system using NFS, the
CD-ROM file system on the remote computer must be exported with root access.
You must also mount that file system with root access on the local computer.
Procedure:
Note: If you are mounting the CD-ROM drive from a remote system using
NFS, the CD-ROM file system on the remote machine must be
exported with root access. You must also mount that file system with
root access on the local machine.
4. Log out.
Your CD-ROM file system is now mounted. To view the contents of the CD-ROM,
place the disk in the drive and enter the cd /cdrom command where cdrom is the
CD-ROM mount point directory.
Related tasks:
v “Installing DB2 servers (Linux and UNIX)” in Quick Beginnings for DB2 Servers
Related reference:
If you are uninstalling the DB2 default copy, and you have other DB2 copies on
your system, you should use the db2swtch command to choose a new default
copy before you proceed with the uninstallation. Also, if your database
administration server (DAS) is running under the copy being removed, you should
move your DAS to a copy that is not being removed. Otherwise, you will have to
recreate the DAS using db2admin create command after the uninstall and you
might have to reconfigure the DAS for some functionality to work.
Procedure:
Unfortunately, your DB2 product cannot always be removed by using the Control
Panel - Add/Remove Programs facility or using the db2unins /p command or the
db2unins /u command. The following uninstallation option should ONLY be
attempted if the above method fails.
To forcefully remove all DB2 copies from your Windows system, run the db2unins
/f command. This command will perform a brute force uninstallation of ALL DB2
copies on the system. Everything except user data, such as DB2 databases, will be
forcefully deleted.
Related tasks:
Related reference:
v “db2swtch - Switch default DB2 copy command” in Command Reference
v “db2unins - Uninstall DB2 database product command” in Command Reference
v “DROP DATABASE command” in Command Reference
Procedure:
Related concepts:
v “DB2 Administration Server” in Administration Guide: Implementation
Related tasks:
v “Stopping the DB2 administration server (Linux and UNIX)” in Quick Beginnings
for DB2 Servers
v “Removing the DB2 administration server (Linux and UNIX)” in Quick
Beginnings for DB2 Servers
v “Stopping DB2 instances (Linux and UNIX)” in Quick Beginnings for DB2 Servers
v “Removing DB2 instances (Linux and UNIX)” in Quick Beginnings for DB2 Servers
v “Removing DB2 products using the db2_deinstall or doce_deinstall command
(Linux and UNIX)” in Quick Beginnings for DB2 Servers
v “Uninstalling your DB2 product (Windows)” on page 97
Related reference:
v “DROP DATABASE command” in Command Reference
Prerequisites:
Restrictions:
The search method feature may be unable to detect a remote system if:
v The DB2 Administration Server (DAS) is not running on the remote system.
v The search times out. By default, the search will scan the network for 1 second;
this may not be long enough to detect the remote system. You can set the
DB2DISCOVERYTIME registry variable to specify a longer period of time.
v The network that the search is running on is configured so that the search does
not reach the remote system desired.
The following points apply to cases where you want to explicitly configure an IPv6
address on a network that supports IPv6:
v The system must be listed under Known Systems.
v Only the Configuration Assistant Advanced View supports explicitly configure
an IPv6 connection.
Procedure:
Related concepts:
v “Client-to-server communications configuration overview” in Quick Beginnings
for DB2 Clients
Related tasks:
v “Configuring a database connection manually using the Configuration Assistant”
on page 102
v “Testing a database connection using the Configuration Assistant” on page 103
Prerequisites:
Procedure:
Related concepts:
v “Client-to-server communications configuration overview” in Quick Beginnings
for DB2 Clients
Related tasks:
v “Testing a database connection using the Configuration Assistant” on page 103
Procedure:
Appendix A. Configuring and testing database connections using the Configuration Assistant 103
ID and password for the remote database and click Test Connection. If the
connection is successful, a message confirming the connection appears on the
Results page.
If the connection test failed, you will receive a help message. To change any
settings you may have incorrectly specified, select the database in the details
view and select Change Database from the Selected menu item.
Related concepts:
v “Client-to-server communications configuration overview” in Quick Beginnings
for DB2 Clients
Related tasks:
v “Configuring a database connection by searching the network using the
Configuration Assistant” on page 101
v “Configuring a database connection manually using the Configuration Assistant”
on page 102
Do not confuse languages supported by DB2 with languages supported by the DB2
interface. Languages supported by DB2, that is, languages that data can exist in, are
a superset of languages supported by the DB2 interface.
Prerequisites:
The DB2 interface language you want to use must be installed on your system.
DB2 interface languages are selected and installed when you install DB2 using the
DB2 Setup wizard. If you change the interface language of DB2 to a supported
interface language that has not been installed, the DB2 interface language will
default to the operating system language first, and if that is not supported,
English.
Procedure:
Changing the interface language for DB2 on Windows requires that you change the
default language setting for your Windows operating system.
Related tasks:
v “Displaying topics in your preferred language in the DB2 Information Center”
on page 116
Related reference:
v “Supported DB2 interface languages” on page 107
v “Supported territory codes and code pages” in Administration Guide: Planning
Prerequisites:
Support for the DB2 interface language you want to use must be installed on your
system. DB2 interface language support is selected and installed when you install
DB2 using the DB2 Setup wizard. If you change the interface language of the DB2
product to a supported interface language that has not been installed, the DB2
interface language will default to the operating system language first, and if that is
not supported, English.
DB2 interface language support is selected and installed when you install your
DB2 product using the DB2 Setup wizard or by using the National Language
Package.
Procedure:
To check which public locales are available in your system, run the $ locale -a
command.
To change the DB2 interface language, set the LANG environment variable to the
desired locale.
For C shell:
setenv LANG <locale>
For example, to interface with the DB2 product in French, you must have the
French language support installed and you must set the LANG environment
variable to a French locale, for example, fr_FR.
Related tasks:
v “Displaying topics in your preferred language in the DB2 Information Center”
on page 116
Related reference:
v “Supported DB2 interface languages” on page 107
v “Supported territory codes and code pages” in Administration Guide: Planning
Related tasks:
v “Changing the DB2 interface language (Linux and UNIX)” on page 106
v “Changing the DB2 interface language (Windows)” on page 105
v “Capturing error and diagnostic information during migration” in Migration
Guide
Related reference:
v “Conversion table files for euro-enabled code pages” in Administration Guide:
Planning
v “Conversion tables for code pages 923 and 924” in Administration Guide: Planning
v “National language versions” in Administration Guide: Planning
v “Supported territory codes and code pages” in Administration Guide: Planning
Related reference:
v “Displaying the db2setup command in your national language” in Quick
Beginnings for DB2 Servers
For example, when data is transferred between a DB2 Connect server and a host or
iSeries database server, it is usually converted from a server code page to a host
CCSID, and vice versa. If the two machines use different code pages or CCSIDs,
code points are mapped from one code page or CCSID to the other. This
conversion is always performed at the receiver.
Character data sent to a database consists of SQL statements and input data.
Character data sent from a database consists of output data. Output data that is
interpreted as bit data is not converted. For example, data from a column declared
with the FOR BIT DATA clause. Otherwise, all input and output character data is
converted if the two machines have different code pages or CCSIDs.
For example, if DB2 Connect is used to access data, the following happens:
1. DB2 Connect sends an SQL statement and input data to OS/390 or z/OS.
108 DB2 Connect Servers Quick Beginnings
2. DB2 Universal Database for z/OS and OS/390 converts the data to the host
server’s code page and then processes the data.
3. DB2 Universal Database for z/OS and OS/390 sends the result back to the DB2
Connect server.
4. DB2 Connect converts the result to the code page of the user’s environment.
Refer to the Supported territory codes and code pages topic in the National
language support appendix of the Administration Guide: Planning for the supported
conversions between code pages on the DB2 Connect server and CCSIDs on the
host or iSeries server.
For bidirectional languages, a number of special ″BiDi CCSIDS″ have been defined
by IBM and are supported by DB2 Connect.
If the bidirectional attributes of the database server are different from those of the
client you can use these special CCSIDS to manage the difference.
Related concepts:
v “Character-conversion guidelines” in Administration Guide: Planning
Related reference:
v “Supported territory codes and code pages” in Administration Guide: Planning
IBM periodically makes documentation updates available. If you access the online
version on the DB2 Information Center at ibm.com®, you do not need to install
documentation updates because this version is kept up-to-date by IBM. If you have
installed the DB2 Information Center, it is recommended that you install the
documentation updates. Documentation updates allow you to update the
information that you installed from the DB2 Information Center CD or downloaded
from Passport Advantage as new information becomes available.
Note: The DB2 Information Center topics are updated more frequently than either
the PDF or the hard-copy books. To get the most current information, install
the documentation updates as they become available, or refer to the DB2
Information Center at ibm.com.
You can access additional DB2 technical information such as technotes, white
papers, and Redbooks™ online at ibm.com. Access the DB2 Information
Management software library site at http://www.ibm.com/software/data/sw-
library/.
Documentation feedback
We value your feedback on the DB2 documentation. If you have suggestions for
how we can improve the DB2 documentation, send an e-mail to
db2docs@ca.ibm.com. The DB2 documentation team reads all of your feedback, but
cannot respond to you directly. Provide specific examples wherever possible so
that we can better understand your concerns. If you are providing feedback on a
specific topic or help file, include the topic title and URL.
Do not use this e-mail address to contact DB2 Customer Support. If you have a
DB2 technical issue that the documentation does not resolve, contact your local
IBM service center for assistance.
Related tasks:
v “Invoking command help from the command line processor” in Command
Reference
v “Invoking message help from the command line processor” in Command
Reference
v “Updating the DB2 Information Center installed on your computer or intranet
server” on page 117
Related reference:
v “DB2 technical library in hardcopy or PDF format” on page 112
Although the tables identify books available in print, the books might not be
available in your country or region.
The information in these books is fundamental to all DB2 users; you will find this
information useful whether you are a programmer, a database administrator, or
someone who works with DB2 Connect or other DB2 products.
Table 8. DB2 technical information
Name Form Number Available in print
Administration Guide: SC10-4221 Yes
Implementation
Administration Guide: Planning SC10-4223 Yes
Administrative API Reference SC10-4231 Yes
Administrative SQL Routines and SC10-4293 No
Views
Call Level Interface Guide and SC10-4224 Yes
Reference, Volume 1
Call Level Interface Guide and SC10-4225 Yes
Reference, Volume 2
Command Reference SC10-4226 No
Data Movement Utilities Guide SC10-4227 Yes
and Reference
Data Recovery and High SC10-4228 Yes
Availability Guide and Reference
Developing ADO.NET and OLE SC10-4230 Yes
DB Applications
Developing Embedded SQL SC10-4232 Yes
Applications
Note: The DB2 Release Notes provide additional information specific to your
product’s release and fix pack level. For more information, see the related
links.
Related concepts:
v “Overview of the DB2 technical information” on page 111
v “About the Release Notes” in Release notes
Related tasks:
v “Ordering printed DB2 books” on page 114
Printed versions of many of the DB2 books available on the DB2 PDF
Documentation CD can be ordered for a fee from IBM. Depending on where you
are placing your order from, you may be able to order books online, from the IBM
Publications Center. If online ordering is not available in your country or region,
you can always order printed DB2 books from your local IBM representative. Note
that not all books on the DB2 PDF Documentation CD are available in print.
Procedure:
Related concepts:
v “Overview of the DB2 technical information” on page 111
Related reference:
v “DB2 technical library in hardcopy or PDF format” on page 112
Procedure:
To invoke SQL state help, open the command line processor and enter:
? sqlstate or ? class code
where sqlstate represents a valid five-digit SQL state and class code represents the
first two digits of the SQL state.
For example, ? 08003 displays help for the 08003 SQL state, and ? 08 displays help
for the 08 class code.
Related tasks:
v “Invoking command help from the command line processor” in Command
Reference
v “Invoking message help from the command line processor” in Command
Reference
For DB2 Version 8 topics, go to the Version 8 Information Center URL at:
http://publib.boulder.ibm.com/infocenter/db2luw/v8/.
Related tasks:
v “Updating the DB2 Information Center installed on your computer or intranet
server” on page 117
Procedure:
Note: Adding a language does not guarantee that the computer has the fonts
required to display the topics in the preferred language.
v To move a language to the top of the list, select the language and click the
Move Up button until the language is first in the list of languages.
3. Clear the browser cache and then refresh the page to display the DB2
Information Center in your preferred language.
On some browser and operating system combinations, you might have to also
change the regional settings of your operating system to the locale and language of
your choice.
To determine if there is an update available for the entire DB2 Information Center,
look for the 'Last updated' value on the Information Center home page. Compare
the value in your locally installed home page to the date of the most recent
downloadable update at http://www.ibm.com/software/data/db2/udb/support/
icupdate.html. You can then update your locally-installed Information Center if a
more recent downloadable update is available.
Note: Updates are also available on CD. For details on how to configure your
Information Center to install updates from CD, see the related links.
If update packages are available, use the Update feature to download the
packages. (The Update feature is only available in stand-alone mode.)
3. Stop the stand-alone Information Center, and restart the DB2 Information
Center service on your computer.
Procedure:
Note: The help_end batch file contains the commands required to safely
terminate the processes that were started with the help_start batch file.
Do not use Ctrl-C or any other method to terminate help_start.bat.
v On Linux, run the help_end script using the fully qualified path for the DB2
Information Center:
<DB2 Information Center dir>/doc/bin/help_end
Related concepts:
v “DB2 Information Center installation options” in Quick Beginnings for DB2 Servers
Related tasks:
v “Installing the DB2 Information Center using the DB2 Setup wizard (Linux)” in
Quick Beginnings for DB2 Servers
v “Installing the DB2 Information Center using the DB2 Setup wizard (Windows)”
in Quick Beginnings for DB2 Servers
You can view the XHTML version of the tutorial from the Information Center at
http://publib.boulder.ibm.com/infocenter/db2help/.
Some lessons use sample data or code. See the tutorial for a description of any
prerequisites for its specific tasks.
DB2 tutorials:
Related concepts:
v “Visual Explain overview” in Administration Guide: Implementation
Related concepts:
v “Introduction to problem determination” in Troubleshooting Guide
v “Overview of the DB2 technical information” on page 111
Personal use: You may reproduce these Publications for your personal, non
commercial use provided that all proprietary notices are preserved. You may not
distribute, display or make derivative work of these Publications, or any portion
thereof, without the express consent of IBM.
Commercial use: You may reproduce, distribute and display these Publications
solely within your enterprise provided that all proprietary notices are preserved.
You may not make derivative works of these Publications, or reproduce, distribute
or display these Publications or any portion thereof outside your enterprise,
without the express consent of IBM.
IBM reserves the right to withdraw the permissions granted herein whenever, in its
discretion, the use of the Publications is detrimental to its interest or, as
determined by IBM, the above instructions are not being properly followed.
You may not download, export or re-export this information except in full
compliance with all applicable laws and regulations, including all United States
export laws and regulations.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country/region or send inquiries, in
writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other
country/region where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions; therefore, this statement may not apply
to you.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product, and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.
All statements regarding IBM’s future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
This information may contain examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious, and any similarity to the names and addresses used by an actual
business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
Each copy or any portion of these sample programs or any derivative work must
include a copyright notice as follows:
Trademarks
Company, product, or service names identified in the documents of the DB2
Version 9 documentation library may be trademarks or service marks of
International Business Machines Corporation or other companies. Information on
the trademarks of IBM Corporation in the United States, other countries, or both is
located at http://www.ibm.com/legal/copytrade.shtml.
Microsoft, Windows, Windows NT®, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.
Intel, Itanium®, Pentium, and Xeon are trademarks of Intel Corporation in the
United States, other countries, or both.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the
United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
U
uninstalling
DB2 database
Windows 97
UNIX
changing the DB2 interface
language 106
removing
DB2 98
updates
DB2 Information Center 117
Information Center 117
user accounts
DB2 Administration Server
(Windows) 36
instance user (Windows) 36
required for installation
(Windows) 36
user groups
DB2ADMNS 61
DB2USERS 61
security 61
Index 127
128 DB2 Connect Servers Quick Beginnings
Contacting IBM
To contact IBM in your country or region, check the IBM Directory of Worldwide
Contacts at http://www.ibm.com/planetwide
Printed in Ireland.
GC10-4243-00
Spine information:
IBM DB2 DB2 Connect Version 9 DB2 Connect Servers Quick Beginnings