付録F.6 トラブルシューティング

ここでは,カスタムアダプタの運用時に発生する障害と考えられる原因と対処方法を説明します。

<この項の構成>
(1) カスタムアダプタの配備に関するトラブルシューティング
(2) カスタムアダプタの開始に関するトラブルシューティング
(3) プロトコルコンバータからの操作に関するトラブルシューティング

(1) カスタムアダプタの配備に関するトラブルシューティング

カスタムアダプタを配備できない場合の原因,原因の特定および対策を次に示します。

(a) 原因

カスタムアダプタのデプロイに失敗する場合,主に次の原因が考えられます。

  1. カスタムアダプタ用アプリケーション統合属性ファイルの形式または内容に誤りがある。
  2. 5.3.6 カスタムアダプタを定義する」に示す正しい手順に従っていないため,誤りがあるEARファイルを登録した。
(b) 原因の特定

デプロイ時に表示されるコンソールログを確認してください。

(c) 対策

次の対処をしてください。

(2) カスタムアダプタの開始に関するトラブルシューティング

カスタムアダプタを開始できない場合の原因,原因の特定および対策を次に示します。

(a) 原因

カスタムアダプタの開始に失敗する場合,主に次の原因が考えられます。

  1. 登録されているすべてのJARファイルのルートフォルダに,カスタムアダプタ開発フレームワーク動作定義ファイルが配置されていない。
  2. カスタムアダプタ開発フレームワーク動作定義ファイルの形式に誤りがある。
  3. カスタムアダプタプロパティファイルの形式に誤りがある。
  4. プロトコルコンバータJARファイルにプロトコルコンバータのクラスファイルが含まれていない。
  5. カスタムアダプタ開発フレームワーク動作定義ファイルで,プロトコルコンバータの指定に誤りがある,または存在しないプロトコルコンバータを指定している。
  6. プロトコルコンバータにpublicなデフォルトコンストラクタがない。
  7. プロトコルコンバータのstartメソッドで例外が発生した。
(b) 原因の特定

メッセージログファイルを確認してください。

(c) 対策
原因が1.~2.の場合,次の対処をしてください。
  • カスタムアダプタ開発フレームワーク動作定義ファイルの形式または内容に誤りがないか確認してください。誤りがある場合は,ファイルを再作成してください。カスタムアダプタ開発フレームワーク動作定義ファイルの詳細は,「付録F.2(1) カスタムアダプタ開発フレームワーク動作定義ファイル」を参照してください。
  • カスタムアダプタ開発フレームワーク動作定義ファイルをプロトコルコンバータJARファイルの中の指定された場所に配置しているか確認してください。指定された場所に配置されていない場合は,正しい場所に配置し直してください。
原因が3.の場合,次の対処をしてください。
  • カスタムアダプタプロパティファイルの形式または内容に誤りがないか確認してください。誤りがある場合は,ファイルを再作成してください。カスタムアダプタプロパティファイルの詳細は,「付録F.2(2) カスタムアダプタプロパティファイル」を参照してください。
原因が4.~5.の場合,次の対処をしてください。
  • プロトコルコンバータJARファイルにプロトコルコンバータのクラスファイルが含まれているか確認してください。含まれていない場合は,jarコマンドを使用して,プロトコルコンバータクラスファイルとそれが使用するクラスファイルおよび,カスタムアダプタ開発フレームワーク動作定義ファイルをJARファイルにアーカイブしてください。プロトコルコンバータJARファイルの作成方法については,「5.3.6(5)(a) プロトコルコンバータJARファイルの作成」を参照してください。
  • カスタムアダプタ開発フレームワーク動作定義ファイルで,プロトコルコンバータ名をパッケージ名付きで指定しているか確認してください。誤りがある場合は,プロトコルコンバータ名をパッケージ名付きで指定し直してください。
  • カスタムアダプタ開発フレームワーク動作定義ファイルで,プロトコルコンバータ名を指定するentry要素のkey属性の値はclassnameか確認してください。誤りがある場合は,key属性がclassnameであるentryタグに,プロトコルコンバータのクラス名を記述してください。
原因が6.の場合,次の対処をしてください。
  • プロトコルコンバータにpublicなデフォルトコンストラクタを定義しているか確認してください。定義されていない場合は,publicなデフォルトコンストラクタを定義してください。
原因が7.の場合,次の対処をしてください。
  • プロトコルコンバータのstartメソッドの処理を確認してください。処理内容に誤りがある場合は,実装し直してください。startメソッドの形式については,「付録F.1(2)(a) CSCMsgCustomAdapterContextインターフェース」を参照してください。
  • 使用している環境や設定がプロトコルコンバータの開始できる状態か確認してください。

(3) プロトコルコンバータからの操作に関するトラブルシューティング

プロトコルコンバータからファイルの操作をしようとするとjava.security.AccessControlException例外が発生する場合の原因,原因の特定および対策を次に示します。

(a) 原因

Javaのセキュリティ機能によって,ファイルアクセスが禁止された可能性があります。

(b) 原因の特定

プロトコルコンバータの中で,ファイルアクセス時にjava.security.AccessControlExceptionが送出されることを確認してください。

(c) 対策

次の対策をしてください。