STOP DATABASE MANAGER 命令

STOP DATABASE MANAGER 命令停止目标成员或所有成员上的数据库管理器。 在 Db2® pureScale® 环境中,它还用于停止 集群高速缓存设施 (CF)。

作用域

Db2 pureScale 环境或分区数据库环境中,除非指定了 DBPARTITIONNUMMEMBERCF 参数,否则此命令会影响 db2nodes.cfg 文件中列出的所有成员。

如果存在活动数据库连接,那么该命令不会关闭成员。 如果没有活动数据库连接,但存在实例连接,那么将首先强制关闭实例连接,然后停止成员。 此命令还会在停止成员之前取消激活任何未完成的数据库激活。 此命令还可用于停止给定主机上的实例服务。

此命令在客户机上无效。

权限

为下列其中一种权限:
  • SYSADM
  • SYSCTRL
  • SYSMAINT

需要的连接

命令语法

Read syntax diagramSkip visual syntax diagramSTOPDATABASE MANAGERDB MANAGERDBMdb2stop?DBPARTITIONNUMMEMBERCFidentifierINSTANCE ONhostnameFORCEPROFILEprofileDROP DBPARTITIONNUMidentifierFORCE?DBPARTITIONNUMMEMBERCFidentifierQUIESCEminutes

命令参数

INSTANCE ON hostname
指定在 Db2 pureScale 实例的特定主机上停止 Db2 实例以执行维护操作。 此命令暂时阻止使用全局 db2start 命令重新启动主机。 对于轻量级重新启动情况,主机不能再充当访客主机。
要在完成维护操作后在主机上重新启动 Db2 实例,请发出 START DBM INSTANCE ON hostname 命令。 如果活动成员或活动 集群高速缓存工具 (CF) 正在主机上运行,那么此命令将失败。 如果在 Db2 pureScale 环境外部使用,那么将返回 SQL1695N 错误。
FORCE
指定时, FORCE 参数会立即停止主机上的 Db2 实例。 在主机上运行的任何活动成员都将故障转移到其他活动主机,或者强制停止任何活动的 集群高速缓存工具 (CF)。 故障转移到另一个主机的成员称为 轻量级重新启动成员,这意味着它在主机上使用的资源最少,并且不接受数据库连接。 有关更多信息,请参阅 "轻量级重新启动"。
identifier
指定数字标识,而不必指定 DBPARTITIONNUMMEMBERCF 参数。
DBPARTITIONNUM identifier
此参数选项仅在分区数据库环境中有效。 指定要停止的成员。 有效值从 0999 (含)。
注: 如果使用 FORCE 选项而不使用此参数,那么将在停止所有数据库分区之前强制所有数据库分区上的所有应用程序。
注: identifier 值必须存在于实例所有者的 db2nodes.cfg 文件中。 如果未指定数据库分区号,那么将停止配置文件中定义的所有数据库分区。
MEMBER identifier
指定要停止的成员。 在 Db2 pureScale 环境中,有效值从 0127 (含)。
CF identifier
此参数选项仅在 Db2 pureScale 环境中有效。 指定要停止的 集群高速缓存工具 (CF)。 有效值为 128129。 如果在 Db2 pureScale外部使用,那么将返回 SQL1695N 错误。
PROFILE profile
此参数选项仅在分区数据库环境中有效。 指定在启动时为那些已启动的数据库分区定义 Db2 环境而执行的概要文件的名称。 如果指定了 START DATABASE MANAGER 命令的概要文件,那么必须在此处指定相同的概要文件。 概要文件必须位于实例所有者的 sqllib 目录中。
DROP DBPARTITIONNUM identifier
此参数选项仅在分区数据库环境中有效。 指定要从 db2nodes.cfg 配置文件中删除的数据库分区。
注: 在使用 DROP DBPARTITIONNUM 参数之前,请运行 DROP DBPARTITIONNUM VERIFY 命令以确保此数据库分区环境上没有用户数据。
FORCE
指定在每个数据库分区上停止 数据库管理器 时使用 FORCE APPLICATION ALL
QUIESCE minutes
此参数选项仅在 Db2 pureScale 环境中有效,并且仅对 MEMBER 参数子句有效。 它用于在成员关闭之前停止给定成员上的活动工作负载 (不能用于 集群高速缓存工具)。 与活动应用程序立即中断的 db2stop FORCE 命令相反,停顿通过等待成员上的所有应用程序完成其活动事务来为它们提供一个优雅的出口。 可选的 minutes 参数值指定命令在通知应用程序与给定成员断开连接之前等待的时间。 一旦达到此超时值,此时仍处于活动状态的任何工作单元都将中断。 如果未指定超时,那么该命令将无限期等待,直到所有活动应用程序都已结束其工作单元,然后再继续关闭该成员。
重要信息: 要使成员恢复联机状态,需要对该成员发出 db2start 命令。

minutes 参数值的有效值从 -11440 (含)。 缺省值为 -1 ,这意味着指定的成员将无限期等待直到所有活动工作负载结束。 如果指定了值 0 ,那么将立即中断活动应用程序,并且一旦这些应用程序结束,该成员将关闭。

注: db2stop QUIESCE 命令不可中断。 发出该命令后,不能再对该成员直接运行其他 Db2 命令。 如果要查询有关已停顿成员的信息,那么需要从另一个活动成员发出 LIST APPLICATIONS GLOBAL SHOW DETAIL 命令。 如果要停止在已停顿成员上运行的应用程序,那么需要从另一个活动成员发出 FORCE APPLICATION '(<app handle>)' 命令。

示例

以下示例是针对成员为 10,20 和 30 的 Db2 实例发出的 db2stop 样本输出:
04-07-1997 10:32:53    10   0   SQL1064N  DB2STOP processing was successful.
04-07-1997 10:32:54    20   0   SQL1064N  DB2STOP processing was successful.
04-07-1997 10:32:55    30   0   SQL1064N  DB2STOP processing was successful.
SQL1064N  DB2STOP processing was successful.

使用说明

在 UNIX 操作系统上,多成员 Db2 实例上的 start_stop_time 配置参数仅包含在本地停止任何特定成员所需的时间; 不包括通过 rshssh向远程成员发送停止请求所需的时间。

在 Microsoft Windows上,必须从使用完全管理员特权运行的 Db2 命令窗口执行此命令。

不必在客户机节点上发出此命令。 它是为了与较旧的客户机兼容而提供的,但对 数据库管理器没有任何影响。

一旦启动, 数据库管理器 实例就会运行,直到用户停止它为止,即使使用它的所有应用程序都已结束。

如果 数据库管理器 已停止,那么会向标准输出设备发送成功完成消息。 如果发生错误,那么处理将停止,并且会向标准输出设备发送一条错误消息。

如果由于应用程序仍连接到数据库而无法停止 数据库管理器 ,请使用 FORCE APPLICATION 命令先断开所有用户的连接,或者重新发出带有 FORCE 选项的 STOP DATABASE MANAGER 命令。

以下信息仅适用于分区数据库环境:
  • 如果未指定任何参数,那么将在配置文件中列出的每个数据库分区上停止 数据库管理器 。 管理通知日志可能包含指示其他数据库分区正在关闭的消息。
  • 将在 db2nodes.cfg 文件中更新自发出先前的 STOP DATABASE MANAGER 命令以来添加到分区数据库环境的任何数据库分区。
  • 在 UNIX 操作系统上,如果达到为 start_stop_time 数据库管理器 配置参数指定的值,那么将中断所有进行中的停止,并将消息 SQL6037N 从每个中断的数据库分区返回到 $HOME/sqllib/log/db2stop.timestamp.log 错误日志文件。 已停止的数据库分区不受影响。
  • db2cshrc 文件不受支持,无法指定为 PROFILE 参数的值。
注意: 请勿使用 UNIX kill 命令来终止 数据库管理器 ,因为该命令会突然终止 数据库管理器 进程而不进行受控终止和清除处理。