前へ | 次へ | 目次 | 索引 |
障害を発生させて,プログラムをテストします。たとえば,トランシーバ・ケーブルや ThinWire セグメントを切断したり,ブリッジ,DELNI インターコネクト,DEMPR リピータで電源障害を発生させます。その後,OPCOM メッセージを調べて, LAVC$FAILURE_ANALYSIS が障害のあるコンポーネントを正しく報告しているかどうか確認します。障害を報告していない場合は, Network Failure Analysis Program に対して行った編集を確認します。
D.5.8 問題のあるコンポーネントの表示
OpenVMS Cluster ネットワーク・コンポーネントで障害が発生すると, OPCOM は疑いのあるコンポーネントの一覧を表示します。OPCOM を使用して一覧を表示することにより,システム管理者は,これらのメッセージの表示を選択的に有効および無効に設定できます。
以下に表示の例を示します。
%%%%%%%%%%% OPCOM 1-JAN-1994 14:16:13.30 %%%%%%%%%%% (from node BETA at 1-JAN-1994 14:15:55.38) Message from user SYSTEM on BETA LAVC-W-PSUSPECT, component_name %%%%%%%%%%% OPCOM 1-JAN-1994 14:16:13.41 %%%%%%%%%%% (from node BETA at 1-JAN-1994 14:15:55.49) Message from user SYSTEM on BETA %LAVC-W-PSUSPECT, component_name %%%%%%%%%%% OPCOM 1-JAN-1994 14:16:13.50 %%%%%%%%%%% (from node BETA at 1-JAN-1994 14:15:55.58) Message from user SYSTEM on BETA %LAVC-I-ASUSPECT, component_name |
障害の疑いのあるコンポーネントを示す OPCOM 表示では,障害を示すために以下の接頭辞が使用されます。
メッセージ接頭辞の後のテキストは, LAVC$FAILURE_ANALYSIS.MAR を編集するときに指定したネットワーク・コンポーネントの記述です。
付録 D で説明したサンプル・プログラムの他に,サンプル・プログラムの機能を拡張するための方法として,多くのサブルーチンが提供されます。 表 E-1 では,これらのサブルーチンについて説明しています。
サブルーチン | 説明 |
---|---|
LAN アダプタの管理: | |
SYS$LAVC_START_BUS | PEDRIVER に対して,特定の LAN アダプタで NISCA プロトコルを起動するように要求する。 |
SYS$LAVC_STOP_BUS | PEDRIVER に対して,特定の LAN アダプタで NISCA プロトコルを停止するように要求する。 |
ネットワーク障害分析システムの制御: | |
SYS$LAVC_DEFINE_NET_COMPONENT | 物理ネットワーク・コンポーネントの表現を作成する。 |
SYS$LAVC_DEFINE_NET_PATH | 2 つのネットワーク・ノード間のネットワーク・コンポーネントの一覧を作成する。 |
SYS$LAVC_ENABLE_ANALYSIS | ネットワーク障害分析を有効に設定する。この結果,将来のチャネル障害を分析することが可能になる。 |
SYS$LAVC_DISABLE_ANALYSIS | ネットワーク障害分析を停止し,物理ネットワーク記述のために使用されていたメモリの割り当てを解除する。 |
この付録で説明するサブルーチンは,LAN 制御プログラムである LAVC$FAILURE_ANALYSIS.MAR,LAVC$START_BUS.MAR, LAVC$STOP_BUS.MAR で使用されます。これらのプログラムは, LAN ネットワークを制御できるだけの十分な機能を備えていますが, LAN 制御サブルーチンを使用すると,さらに LAN アダプタを管理するのに役立ちます。
E.2 NISCA プロトコルの起動
SYS$LAVC_START_BUS サブルーチンは,指定された LAN アダプタで NISCA プロトコルを起動します。SYS$LAVC_START_BUS ルーチンを使用するには,以下のパラメータを指定します。
パラメータ | 説明 |
---|---|
BUS_NAME | 参照によって渡される LAN アダプタ名バッファを表現する文字列記述子。 LAN アダプタ名は 15 文字以内でなければならない。 |
例: 以下の Fortran サンプル・プログラムでは, SYS$LAVC_START_BUS を使用して, LAN アダプタ XQA で NISCA プロトコルを起動します。
PROGRAM START_BUS EXTERNAL SYS$LAVC_START_BUS INTEGER*4 SYS$LAVC_START_BUS INTEGER*4 STATUS STATUS = SYS$LAVC_START_BUS ( 'XQA0:' ) CALL SYS$EXIT ( %VAL ( STATUS )) END |
SYS$LAVC_START_BUS サブルーチンは, 表 E-2 に示すように,レジスタ R0 に状態値を返します。
状態 | 結果 |
---|---|
Success | PEDRIVER が指定されたアダプタで NISCA プロトコルを起動しようとしていることを示す。 |
Failure | PEDRIVER が指定された LAN アダプタでプロトコルを起動できないことを示す。 |
SYS$LAVC_START_BUS は,以下の表に示すエラー状態コードを返すことがあります。
状態コード | 説明 |
---|---|
SS$_ACCVIO | この状態は以下の場合に返される。
|
SS$_DEVACTIVE | バスがすでに存在する。PEDRIVER は,NISCA プロトコルのためにすでにこの LAN アダプタを使用しようとしている。 |
SS$_INSFARG | 指定された引数の数が不足している。 |
SS$_INSFMEM | バス・データ構造を作成するのに必要な非ページング・プールが不足している。 |
SS$_INVBUSNAM | 指定されたバス名が不正である。指定されたデバイスは,プロトコルに対して使用できる LAN アダプタでない。 |
SS$_IVBUFLEN | この状態値は以下の場合に返される。
|
SS$_NOSUCHDEV | この状態値は以下の場合に返される。
注意: このルーチンを呼び出すことにより,エラー・ログ・メッセージが作成されることがある。 |
SS$_NOTNETDEV | PEDRIVER が指定された LAN デバイスをサポートしない。 |
SS$_SYSVERDIF | 指定された LAN デバイスのドライバは,PEDRIVER で必要とされている VCI インタフェース・バージョンをサポートしない。 |
PEDRIVER は,指定された LAN アダプタへの接続を作成できなかったことを示す他のエラーを返すことがあります。
E.3 NISCA プロトコルの停止
SYS$LAVC_STOP_BUS ルーチンは,指定された LAN アダプタで NISCA プロトコルを停止します。
警告: すべての LAN アダプタで NISCA プロトコルを停止すると,サテライトがハング状態になり,クラスタ・システムが CLUEXIT バグチェックで異常終了することがあります。
このルーチンを使用するには,以下の表に示すパラメータを指定します。
パラメータ | 説明 |
---|---|
BUS_NAME | 参照によって渡される LAN アダプタ名バッファを表す文字列記述子。 LAN アダプタ名は 15 文字以内でなければならない。 |
例: 以下の Fortran サンプル・プログラムでは,SYS$LAVC_STOP_BUS を使用して,LAN アダプタ XQB で NISCA プロトコルを停止する方法を示しています。
PROGRAM STOP_BUS EXTERNAL SYS$LAVC_STOP_BUS INTEGER*4 SYS$LAVC_STOP_BUS INTEGER*4 STATUS STATUS = SYS$LAVC_STOP_BUS ( 'XQB' ) CALL SYS$EXIT ( %VAL ( STATUS )) END |
SYS$LAVC_STOP_BUS サブルーチンは, 表 E-3 に示すように,レジスタ R0 に状態値を返します。
状態 | 結果 |
---|---|
Success | PEDRIVER が,指定されたアダプタで NISCA プロトコルをシャットダウンしようとしていることを示す。 |
Failure | PEDRIVER が,指定された LAN ドライバでプロトコルをシャットダウンできないことを示す。しかし,PEDRIVER はシャットダウンを非同期的に実行するため,他の理由で PEDRIVER がシャットダウンを完了できないことがある。 |
LAVC$STOP_BUS モジュールが正常に実行されると,以下のデバイス・アテンション・エントリがシステム・エラー・ログに書き込まれます。
DEVICE ATTENTION... NI-SCS SUB-SYSTEM... FATAL ERROR DETECTED BY DATALINK... |
さらに,以下の 16 進数がエントリの STATUS フィールドに書き込まれます。
最初のロングワード (00000001)
2 番目のロングワード (00001201)
このエラー・ログ・エントリは,期待される動作を示すもので,無視してもかまいません。しかし,STATUS フィールドの最初のロングワードが 16 進数の 00000001 以外の値の場合は,エラーが発生しているため,さらに調査が必要になることがあります。
E.3.2 エラー・メッセージ
SYS$LAVC_STOP_BUS は,以下の表に示すエラー状態コードを返すことがあります。
状態コード | 説明 |
---|---|
SS$_ACCVIO | この状態は以下の場合に返される。
|
SS$_INVBUSNAM | 指定されたバス名が不正である。指定されたデバイスは, NISCA プロトコルに対して使用できる LAN アダプタでない。 |
SS$_IVBUFLEN | この状態値は以下の場合に返される。
|
SS$_NOSUCHDEV | この状態値は以下の場合に返される。
|
SYS$LAVC_DEFINE_NET_COMPONENT サブルーチンは,物理ネットワーク・コンポーネントの表現を作成します。
パラメータを指定するには,以下の形式を使用します。
STATUS = SYS$LAVC_DEFINE_NET_COMPONENT (
component_description,
nodename_length,
component_type,
lan_hardware_addr,
lan_decnet_addr,
component_id_value )
表 E-4 は, SYS$LAVC_DEFINE_NET_COMPONENT のパラメータについて説明しています。
パラメータ | 説明 |
---|---|
component_description | ネットワーク・コンポーネント名バッファを表す文字列記述子のアドレス。ネットワーク・コンポーネント名の長さは, COMP$C_MAX_NAME_LEN に指定した文字数以下でなければならない。 |
nodename_length | ノード名の長さのアドレス。このアドレスは,COMP$C_NODE タイプの場合は,ネットワーク・コンポーネント名バッファの先頭である。他のコンポーネント・タイプの場合は,0 を使用しなければならない。 |
component_type | コンポーネント・タイプのアドレス。これらの値は, SYS$LIBRARY:LIB.MLB にある $PEMCOMPDEF によって定義される。 |
lan_hardware_addr | コンポーネントの LAN ハードウェア・アドレス (6 バイト) を格納しているバッファの文字列記述子のアドレス。 COMP$C_ADAPTER タイプの場合は,この値を指定しなければならない。他のコンポーネント・タイプの場合は,この値は省略可能である。 |
lan_decnet_addr | コンポーネントの LAN DECnet アドレス (6 バイト) を格納しているバッファの文字列記述子。これはすべてのコンポーネント・タイプで省略可能なパラメータである。 |
component_id_value | コンポーネント ID 値が書き込まれるロングワードのアドレス。 |
正常終了すると, SYS$LAVC_DEFINE_NET_COMPONENT サブルーチンは COMP データ構造を作成し,ID 値を返します。このサブルーチンは,ユーザ指定パラメータをデータ構造にコピーし,参照カウントを 0 に設定します。
コンポーネント ID 値は 32 ビットの値であり,ネットワーク・コンポーネントとの間に 1 対 1 の対応関係があります。これらのコンポーネント ID の一覧は,パケットがあるノードから別のノードに転送されるときに使用されるコンポーネントを指定するために,SYS$LAVC_DEFINE_NET_PATH に渡されます。
E.4.2 エラー・メッセージ
SYS$LAVC_DEFINE_NET_COMPONENT は,以下の表に示すエラー状態コードを返すことがあります。
状態コード | 説明 |
---|---|
SS$_ACCVIO | この状態は以下の場合に返される。
|
SS$_DEVACTIVE | 分析プログラムはすでに実行されている。ネットワーク・コンポーネントおよびネットワーク・コンポーネント・リストを定義する前に, SYS$LAVC_DISABLE_ANALYSIS を呼び出すことにより,分析を停止しなければならない。 |
SS$_INSFARG | 指定された引数の数が不足している。 |
SS$_INVCOMPTYPE | コンポーネント・タイプが 0 であるか,または COMP$C_INVALID 以上の値である。 |
SS$_IVBUFLEN | この状態値は以下の場合に返される。
|
E.5 ネットワーク・コンポーネント・リストの作成
SYS$LAVC_DEFINE_NET_PATH サブルーチンは, 2 つのネットワーク・ノード間にネットワーク・コンポーネントの方向付きリストを指定します。方向付きリスト
とは,パケットがクラスタ・ネットワーク内で,障害分析ノードから他のノードに移動するときに通過するすべてのコンポーネントのリストです。
パラメータを指定するには,以下の形式を使用します。
STATUS = SYS$LAVC_DEFINE_NET_PATH (
network_component_list,
used_for_analysis_status,
bad_component_id )
表 E-5 は, SYS$LAVC_DEFINE_NET_PATH のパラメータについて説明しています。
パラメータ | 説明 |
---|---|
network_component_list | パス内の各コンポーネントのコンポーネント ID 値を格納しているバッファの文字列記述子のアドレス。ネットワーク・メッセージが通過する順に,コンポーネント ID 値を指定する。コンポーネントは以下の順に指定する。
ネットワーク・パス内の 2 つのノードと 2 つの LAN アダプタを指定しなければならない。バッファ長は 15〜509 バイトの範囲でなければならない。 |
used_for_analysis_status | 書き込まれるロングワード状態値のアドレス。この状態は,このネットワーク・パスがネットワーク障害分析を行う価値があるかどうかを示す。 |
bad_component_id | コンポーネント・リストを処理しているときにエラーが検出された場合,エラーのあるコンポーネント ID が格納されるロングワード値のアドレス。 |
前へ | 次へ | 目次 | 索引 |