Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成の手引


7.2.1 OpenTP1ノードの状態の取得

UAPから関数を呼び出して,クラスタ/並列システムを構成するOpenTP1ノードの状態を取得できます。OpenTP1ノードの状態を取得することで,マルチノードエリア,またはマルチノードサブエリアの状態をUAPで監視できます。

取得できる状態を次に示します。

OpenTP1ノードの状態を取得するには,ノード状態を連続して取得する方法と,指定したOpenTP1ノードの状態だけを取得する方法があります。

〈この項の構成〉

(1) OpenTP1ノードの状態を連続して取得する方法

マルチノードエリア,またはマルチノードサブエリア単位に,そのエリアにあるすべてのOpenTP1ノードの状態を取得します。

連続して状態を取得する場合は,取得したいマルチノードエリア,またはマルチノードサブエリアの識別子を指定したdc_adm_get_nd_status_begin関数を使います。この関数を呼び出すと,指定したエリアにあるOpenTP1ノードの個数がリターンされます。次に,dc_adm_get_nd_status_next関数を呼び出して,OpenTP1ノードの状態を取得します。該当するOpenTP1ノードがなくなるまでdc_adm_get_nd_status_next関数を呼び出してから,最後にdc_adm_get_nd_status_done関数を呼び出して状態の取得を終了します。

dc_adm_get_nd_status_begin関数を呼び出したあとで,もう一度dc_adm_get_nd_status_begin関数を呼び出すこと(dc_adm_get_nd_status_begin関数のネスト)はできません。

OpenTP1ノードの状態を連続して取得する手順を次の図に示します。

図7‒2 OpenTP1ノードの状態を連続して取得する手順

[図データ]

(2) 指定したOpenTP1ノードの状態を取得する方法

一つのOpenTP1ノードの状態を取得する場合は,dc_adm_get_nd_status関数を呼び出します。この関数を呼び出すと,関数に設定したOpenTP1ノードのノード識別子に関する状態を取得できます。