IBM - What is causing DBA1177N a Database connection to the Tools Catalog Databa...

Página 1 de 2

What is causing DBA1177N a Database connection to the

Tools Catalog Database " " cannot be made. SQLCODE=1013

Technote (FAQ) Document

Product categories:
Problem
Starting DB2 Task Center gives the following error Software
DBA1177N a Database connection to the Tools Catalog Database " " cannot be
made. SQLCODE=1013. Data & Information
Management
Cause
Tasks created by the Task Center are stored in the tools catalog database.
Databases
These tasks are managed by the DB2 Administrator Server's (DAS) Scheduler.
The Scheduler acts as an agent to read the tools catalog database and runs DB2 Universal
the tasks at their respective times. The DB2 administration server Database for Linux
Configuration file tells the Scheduler the location of the tools catalog database, UNIX and
and whether or not the Scheduler should be enabled. When the tools catalog
database is created, DB2 implicitly updates the corresponding DAS
configuration parameters SCHED_ENABLE, TOOLSCAT_DB,
General
TOOLSCAT_INST and TOOLSCAT_SCHEMA in order to enable the questions or
Scheduler and define the location of the database without the need to restart information or
the DAS. For example: unlisted category
Execute Expired Tasks Operating system(s):
(EXEC_EXP_TASK) = NO Platform
Scheduler Mode (SCHED_ENABLE) = ON Independent
SMTP Server
(SMTP_SERVER) = Software version:
8
Tools Catalog Database (TOOLSCAT_DB) = TOOLSDB
Tools Catalog Database Instance (TOOLSCAT_INST) = DB2 Software edition:
Tools Catalog Database Schema (TOOLSCAT_SCHEMA) = Enterprise
TOOLSDB
Scheduler User ID Reference #:
= 1187847
IBM Group:
If the DAS instance was dropped then recreated, the DAS parameters above Software Group
are reset to their default values and any attempt to start the Task Center will
generate the error message: Modified date:
DBA1177N a Database connection to the Tools Catalog Database " " cannot be 2005-04
made. SQLCODE=1013.

Values of parameters after dropping and recreating the DAS instance: Rate this page
Help us improve this
Execute Expired Tasks page. Your response
(EXEC_EXP_TASK) = NO will be used to improv
Scheduler Mode (SCHED_ENABLE) = OFF our document
Requests for assistan
SMTP Server
should be submitted
(SMTP_SERVER) = through your normal
Tools Catalog Database (TOOLSCAT_DB) = support channel as w
Tools Catalog Database Instance (TOOLSCAT_INST) = cannot respond from
this site.
Tools Catalog Database Schema (TOOLSCAT_SCHEMA) =
Scheduler User ID
=

http://www-1.ibm.com/support/docview.wss?rs=71&context=SSEPGG&q1=toolsdb+creat... 28/4/2005
IBM - What is causing DBA1177N a Database connection to the Tools Catalog Databa... Página 2 de 2

SCHED_ENABLE - Specifies whether or not the Scheduler is started by

the administration server.

TOOLSCAT_DB - Specifies the tools catalog database used by the

Scheduler. This database must be in the database directory of the instance
specified by TOOLSCAT_INST.

TOOLSCAT_INST - Specifies the instance name that is used by the

Scheduler, along with toolscat_db and toolscat_schema, to identify the
tools catalog database.

TOOLSCAT_SCHEMA - Specifies the schema of the tools catalog

database used by the Scheduler. The schema is used to uniquely identify a
set of tools catalog tables and views within the database.

To display the content of the DB2 Administrator configuration file, use the
following command
db2 get admin cfg

Solution
To resolve the error message, manually update the DAS configuration file
to locate the tools catalog database, enable the scheduler and restart the
DAS instance. For example:
1. db2 update admin cfg using SCHED_ENABLE on

2. db2 update admin cfg using TOOLSCAT_DB toolsdb

3. db2 update admin cfg using TOOLSCAT_INST db2

4. db2 update admin cfg using TOOLSCAT_SCHEMA toolsdb

5. db2admin stop
6. db2admin start
The end user can also drop and recreate the tools catalog database which
will dynamically update the DAS configuration parameters and enable the
scheduler without restating the DAS instance. For example
1. db2 drop db toolsdb
2. db2 create tools catalog toolsdb create new db toolsdb

Note: Dropping the tools catalog database will result in destroying the tasks
information in the database. The user must exercise caution before dropping
this database.

Related information
Configuration Parameters Summary
Get Admin Configuration Command

http://www-1.ibm.com/support/docview.wss?rs=71&context=SSEPGG&q1=toolsdb+creat... 28/4/2005