STOP DATABASE MANAGER 指令
STOP DATABASE MANAGER 指令會停止目標成員或所有成員上的資料庫管理程式。 在 Db2® pureScale ® 環境中,也會使用它來停止 叢集快取機能 (CF)。
範圍
在 Db2 pureScale 環境或分割的資料庫環境中,除非指定 DBPARTITIONNUM、 MEMBER或 CF 參數,否則此指令會影響 db2nodes.cfg 檔案中列出的所有成員。
如果有作用中的資料庫連線,指令不會關閉成員。 如果沒有作用中資料庫連線,但有實例連接,則會先強制關閉實例連接,然後停止成員。 此指令也會在停止成員之前取消啟動任何未完成的資料庫啟動。 此指令也可以用來停止給定主機上的實例服務。
此指令在用戶端上無效。
授權
- SYSADM
- SYSCTRL
- SYSMAINT
必要連線
無
指令語法
指令參數
- INSTANCE ON hostname
- 指定要在 Db2 pureScale 實例的特定主機上停止 Db2 實例,以進行維護作業。 此指令暫時阻止使用廣域 db2start 指令重新啟動主機。 在輕量型重新啟動狀況下,主機無法再充當訪客主機。
- identifier
- 指定數值 ID ,而不需要指定 DBPARTITIONNUM、 MEMBER或 CF 參數。
- DBPARTITIONNUM identifier
- 此參數選項僅在分割的資料庫環境中有效。 指定要停止的成員。 有效值從 0 至 999 (含)。附註: 如果使用 FORCE 選項時未指定此參數,則在停止所有資料庫分割區之前,會強制所有資料庫分割區上的所有應用程式。附註: identifier 值必須存在於實例擁有者的 db2nodes.cfg 檔案中。 如果未指定資料庫分割區號碼,則會停止配置檔中定義的所有資料庫分割區。
- MEMBER identifier
- 指定要停止的成員。 在 Db2 pureScale 環境中,有效值為 0 至 127 (含)。
- CF identifier
- 此參數選項僅在 Db2 pureScale 環境中有效。 指定要停止的 叢集快取機能 (CF)。 有效值為 128 和 129。 如果在 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 參數值的有效值是從 -1 到 1440 (含)。 預設值為 -1 ,表示指定的成員會無限期等待,直到所有作用中工作量結束為止。 如果指定值 0 ,則會立即岔斷作用中應用程式,一旦結束,即會關閉成員。
附註: db2stop QUIESCE 指令不可岔斷。 在您發出指令之後,無法直接對該成員執行進一步的 Db2 指令。 如果您想要查詢靜止成員的相關資訊,則需要從另一個作用中成員發出 LIST APPLICATIONS GLOBAL SHOW DETAIL 指令。 如果您要停止在靜止成員上執行的應用程式,則需要從另一個作用中成員發出 FORCE APPLICATION '(<app handle>)' 指令。
範例
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 配置參數僅包括在本端停止任何特定成員所需的時間; 它不包括透過 rsh 或 ssh將停止要求傳送至遠端成員所需的時間。
在 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 參數的值。
