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
指定數值 ID ,而不需要指定 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 指令。

下列資訊僅適用於分割的資料庫環境:
  • 如果未指定任何參數,則會在配置檔中列出的每一個資料庫分割區上停止 資料庫管理程式 。 管理通知日誌可能包含指出其他資料庫分割區正在關閉的訊息。
  • 自發出前一個 STOP DATABASE MANAGER 指令以來新增至分割資料庫環境的任何資料庫分割區會在 db2nodes.cfg 檔案中更新。
  • 在 UNIX 作業系統上,如果達到 start_stop_time 資料庫管理程式 配置參數指定的值,則會岔斷所有進行中的停止,並將訊息 SQL6037N 從每一個岔斷的資料庫分割區傳回至 $HOME/sqllib/log/db2stop.timestamp.log 錯誤日誌檔。 已停止的資料庫分割區不受影響。
  • 不支援 db2cshrc 檔案,且無法指定為 PROFILE 參數的值。
注意: 請勿使用 UNIX kill 指令來終止 資料庫管理程式 ,因為該指令會突然結束 資料庫管理程式 處理程序,而不會進行控制式終止及清理處理。