6 トラブルシューティングとエラー・メッセージ

この章では、PeopleSoftへの接続時の制限事項および回避方法について説明します。項目は次のとおりです。

• トラブルシューティング

• BSEエラー・メッセージ

この章に示すアダプタ固有のエラーは、アダプタをOracleAS Adapter J2CAで使用しているかOracleAS Adapter Business Services Engine（BSE）構成で使用しているかに関係なく発生する可能性があります。

トラブルシューティング

このトピックでは、PeopleSoftのトラブルシューティング情報を次の4つのカテゴリにわけて説明します。

• Application Explorer

• PeopleSoft

• OracleAS Adapter J2CA

• BSE

注意: トラブルシューティングに関連するログ・ファイル情報は、次の場所にあります。 OracleAS Adapter J2CAのトレース情報は、OracleAS_home¥opmn¥logsディレクトリにあります。 BSEのトレース情報は、OracleAS_home¥j2ee¥home¥applications¥ws-app-adapter¥ibse¥ibselogsディレクトリにあります。 Application Explorerのログ・ファイルは、OracleAS_home¥adapters¥application¥toolsディレクトリにあります。

Application Explorer

Windows上でApplication Explorerをデバッグまたはテストに使用するには、次のディレクトリにあるバッチ・スクリプトae.batをロードします。

OracleAS_home\adapters\application\tools

UNIX上では、次のディレクトリにあるシェル・スクリプトae.shをロードします。

OracleAS_home/adapters/application/tools

エラー	解決方法
Application ExplorerからOracleAS Adapter for PeopleSoftに接続できない。 次のエラー・メッセージが表示される。 アダプタのアクティブ化中に問題が発生しました	次のことを確認します。 PeopleSoftが実行中であること。 PeopleSoftのユーザーIDとパスワードが正しいこと。 ポート番号が適切であること。 カスタム・コンポーネント・インタフェースが適切にインストールされていること。
次のエラー・メッセージが表示される。 java.lang.IllegalStateException: java.lang.Exception: PeopleSoftシステムへのログオン・エラー	PeopleSoftに無効な接続情報を指定しているか、libディレクトリに不正なpsjoa.jarがあります。 psjoa.jarファイルのバージョンは、PeopleToolsリリース固有です。
Application Explorerの「アダプタ」ノード・リストにPeopleSoftが表示されない。	PeopleSoftのJARファイルiwpsci84.jar（またはiwpsci81.jar）およびpsjoa.jarがlibディレクトリに追加されていることを確認してください。
実行時にログオンできない。	Application Explorerでターゲットを作成するか「編集」オプションを使用するときに、PeopleSoftシステムへの接続用パスワードが指定されていないと、PeopleSoftに接続できません。 接続パスワードはrepository.xmlに保存されません。 Application Explorerで「編集」オプションを使用してパスワードを更新してから、アプリケーション・サーバーを再起動してください。
次のエラー・メッセージが表示される。 Jolt Session Poolがappserverへの接続を提供できません。これは、使用可能なアプリケーション・サーバー・ドメインがないためと思われます。 [Fri Aug 27 13:06:27 EDT 2004] bea.jolt.ServiceException: 無効なセッション	PeopleSoftのホスト名またはポート番号が正しくありません。
コンポーネント・インタフェースのプロパティが表示されない。	適切なiwpsci8x.jarファイルを使用していません。
スキーマを生成できない。	エラー・メッセージ「索引: -1、サイズ:0」が表示される場合、またはApplication Explorerにログオンできてもコンポーネント・インタフェースまたはメッセージが表示されない場合は、libディレクトリにiwpsci81.jarファイルとiwpsci84.jarファイルの両方が存在する可能性があります。 サーバーを停止して不要なjarファイルを削除してから、サーバーを再起動してください。
Application Explorerの起動時に（iaexplorer.exeではなく）ae.batをアクティブ化すると、次の例外が発生する。 java.lang.ClassNotFoundException: org.bouncycastle.jce.provider.BouncyCastleProvider	これは初期例外です。 アダプタの機能には影響しません。 次のサイトからBouncyCastleファイルをダウンロードしてください。 ftp://ftp.bouncycastle.org/pub
Solaris環境でApplication Explorerを起動できない。 コンソールで次の例外がスローされる。 javax.resource.ResourceException: IWAFManagedConnectionFactory: License violation.at com.ibi.afjca.spi.IWAFManagedConnectionFactory.createConnectionFactory(IWAFManagedConnectionFactory.java:98)at com.iwaysoftware.iwae.common.JCATransport.getConnectionFactory(JCATransport.java:133) at com.iwaysoftware.iwae.common.JCATransport.initJCA(JCATransport.java:69)at com.iwaysoftware.iwae.common.JCATransport.<init>(JCATransport.java:62)at com.iwaysoftware.iwae.common.AdapterClient.<init>(AdapterClient.java:85)at com.ibi.bse.ConfigWorker.run(ConfigWorker.java:41)at java.lang.Thread.run(Thread.java:534) コネクション・ファクトリを作成できませんでした。	ユーザー・システム上でJAVACMDが設定されていません。 Application Explorerを起動する前に、次のようにJAVACMDをエクスポートしてください。 JAVACMD=/<jdk_home>/bin/java <jdk_home>は、マシン上でJDKがインストールされているディレクトリです。

PeopleSoft

エラー	解決方法
PeopleSoftコンポーネント・インタフェースのテスト・ツールを3層モードで使用している場合に、サービスが正常に機能しない。	コンポーネント・インタフェースのテスト・ツールを使用して適切にテストする手順は、次のとおりです。 Application Designerを開きます。 コンポーネント・インタフェースを選択します。 テスト・ツールを使用します。 サービスがテスト・ツールで機能する場合は、XMLを調べ、XMLに冗長フィールドがあるかどうかを調べてください。
次のエラー・メッセージが表示される。 Jolt Session Poolがappserverへの接続を提供できません。これは、使用可能なアプリケーション・サーバー・ドメインがないためと思われます。 [Fri Aug 27 13:06:27 EDT 2004] bea.jolt.ServiceException: 無効なセッション	PeopleSoftのホスト名またはポート番号が正しくありません。
アダプタ・ツリーにコンポーネント・インタフェースとメッセージが表示されない。	PeopleSoftシステムにプロジェクトが正常にインストールされていません。
実行時にPeopleSoftから次のように戻りエラー・コード-1が表示される。 <LOCATIONProcessResponse xmlns="http://xmlns.oracle.com/LOCATION"> <error xmlns="">-1</error> </LOCATIONProcessResponse>	使用しているpsjoa.jarのバージョンが正しくないか、またはlibディレクトリにiwpsci81.jarファイルとiwpsci84.jarファイルの両方が存在します。 後者の場合は、使用しないJARファイルを削除してから、サーバーを再起動する必要があります。 psjoa.jarファイルのバージョンは、PeopleToolsリリース固有です。
Pstools.propertiesファイルが初期化されていない。	このファイルはPeopleSoft 8.1に必須です。 PeopleSoft 8.1を使用している場合は、このファイルを追加する必要があります。 PeopleSoft 8.1を使用していない場合は、このエラー・メッセージが表示されても無視してください。
次のエラー・メッセージが表示される。 コンポーネント・インタフェース {CI名} が見つかりません	次のいずれかが原因の可能性があります。 選択したコンポーネント・インタフェースのJava APIがAPI JARファイル内で見つかりません。 Java APIでCIのクラス・ファイルをチェックしてください。 見つからない場合は、CIのクラス・ファイルを追加してください。 コンポーネント・インタフェース名がリクエスト文書内で正しく指定されていません。
次のエラー・メッセージが表示される。 未許可 (90,6) PSSessionリクエストの実行に失敗しました	コンポーネント・インタフェースに、操作の実行に必要なアクセス権限がありません。 「PeopleSoft」→「セキュリティ」→コンポーネント・インタフェースの「権限」リストで、権限の設定を変更してください。
次のエラー・メッセージが表示される。 キー {キー名} の値も入力する必要があります	次のいずれかが原因の可能性があります。 リクエストXML文書に必須キーの要素がありません。 リクエスト文書にキー名と値を追加してください。 「キー」フィールド名がリクエスト文書内で正しく指定されていません。 Perform操作がリクエストXML文書内で正しく指定されていません。

OracleAS Adapter J2CA

エラー	解決方法
Application ExplorerでOracleAS Adapter J2CA構成に接続しようとすると、次のエラー・メッセージが表示される。 JCAを初期化できませんでした	右ペインの「詳細」タブで、「ホーム」フィールドに指定したディレクトリが適切なディレクトリ（OracleAS_home¥adapters¥applicationなど）を指していることを確認してください。

BPEL Process Manager

エラー	解決方法
JDeveloperでPeopleSoftイベント処理プロジェクト（インバウンド）のデプロイ時にエンドポイント・アクティブ化エラーが発生する。	このインバウンドJ2CAサービスに使用しているチャネルが、Application Explorerで停止されていることを確認してください。 このチャネルをテストまたはデバッグのために開始した場合は、BPEL PMサーバーの起動前に停止する必要があります。 エンドポイントのアクティブ化は、BPEL Process Managerにより管理されます。
BPEL PMサーバー・コンソールに次のエラー・メッセージが表示される。 プロセス"TestPSFT" (リビジョン"1.0")のコンパイルに失敗しました。 <2005-05-18 10:49:53,285> <ERROR><default.collaxa.cube.engine.deployment> <Cube ProcessLoader::create> WSDLの読取りに失敗しました "WSDLException: faultCode=INVALID_WSDL: 次の場所にある文書内のXMLが無効です: http://127.0.0.1:7777/BPELConsole/wsil/adapters/applications/CUSTOMER_invoke.wsdl?wsdl: 要素タイプ"P"は対応する終了タグ"</P>で終了する必要があります"の理由により、"http://127.0.0.1:7777/BPELConsole/wsil/adapters/applications/CUSTOMER_invoke.wsdl?wsdl"でWSDLの読取り中にエラーが発生しました。	指定したWSDLがそのURLに存在することと、ファイルが有効であることを確認してください。 回避方法: WSDLのロケーションをlocalhost:7777に変更します。 デフォルトは127.0.0.1:7777です。 代替回避方法: obsetenv.bat（Windows）またはobsetenv.sh（Unix）にあるDhttp.nonProxyHostsリストに、IPアドレスを追加します。
BPELプロセスのデプロイ中に、JDeveloperで次の例外がスローされる。 java.io.FileNotFoundException: ¥BPELConsole¥wsil¥adapters¥applications¥LOCATION_SYNC.VERSION_1_receive.wsdl?wsdl (指定されたパスが見つかりません)	必須パッチをすべてインストール済であることを確認してください。 必須パッチは、Oracle Technology NetworkのWebサイトにリスト表示され、更新されます。

BSEエラー・メッセージ

このトピックでは、Oracle Application Server Adapter Business Services Engine（BSE）を介してWebサービスを処理する際に発生する各種のエラーについて説明します。

BSEでの一般的なエラー処理

BSEには、アダプタ・フレームワークへのSOAPゲートウェイとしての機能、および一部アダプタ用のエンジンとしての機能があります。 設計時および実行時には、アダプタを使用するWebサービスの実行中に、様々な条件が原因となってBSEにエラーが発生する可能性があります。これらの条件とそれに伴うエラーの一部には、アダプタに関係なく同様に表示されるものと、使用中のアダプタに応じて異なる方法で表示されるものがあります。 このトピックでは、いくつかのより一般的なエラー条件が発生した場合に予想できる状況についてアダプタ別に説明します。通常、BSE内のSOAPゲートウェイ（エージェント）は、SOAPリクエスト・メッセージをWebサービスに必要なアダプタに渡します。エラーが発生した場合の表示方法は、アダプタおよびアダプタで使用されているAPIまたはインタフェースに応じて異なります。 各APIはPeopleToolsから生成され、PeopleToolsのリリース固有です。一部の使用例では、SOAPゲートウェイによりSOAP障害が発生します。通常は、BSE内のSOAPエージェントが無効なSOAPリクエストを受信すると、SOAPレスポンス内でSOAP障害要素が生成されます。SOAP障害要素には、障害文字列と障害コードの要素が含まれます。 障害コードには、SOAPエージェント・エラーの説明が含まれています。BSEが無効なSOAPリクエストを受信すると、次のSOAPレスポンス文書が生成されます。

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
 <SOAP-ENV:Body>
      <SOAP-ENV:Fault>
         <faultcode>SOAP-ENV:Client</faultcode>
         <faultstring>Parameter node is missing</faultstring>
      </SOAP-ENV:Fault>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

この例では、BSEはこのWebサービスのWSDLに必須の要素をSOAPリクエスト・メッセージで受信していません。

アダプタ固有のエラー処理

アダプタの実行中に例外が発生すると、BSE内のSOAPエージェントが生成SOAPレスポンスにSOAP障害要素を生成します。SOAP障害要素には、障害コードと障害文字列の要素が含まれます。障害文字列には、アダプタ・ターゲット・システム固有のエラー記述が含まれています。アダプタはターゲット・システムのインタフェースとAPIを使用するため、例外が発生するかどうかは、ターゲット・システムのインタフェースまたはAPIがエラー条件を処理する方法によって決定します。SOAPリクエスト・メッセージがBSE内のSOAPエージェントによりアダプタに渡され、そのリクエストが該当サービスのWSDLに基づいて無効となる場合は、アダプタに例外が発生してSOAP障害となる可能性があります。アダプタに発生するエラー条件をすべて予想するのはほとんど不可能ですが、ここではアダプタにおける一般的なエラー条件の処理方法と、Webサービスのコンシューマ・アプリケーションへの表示方法について説明します。

OracleAS Adapter for PeopleSoftの無効なSOAPリクエスト

PeopleSoftエージェントが実行中のWebサービスのWSDLに準拠しないSOAPリクエスト・メッセージを受信すると、次のSOAPレスポンスが生成されます。

<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/1999/XMLSchema">
  <SOAP-ENV:Body>
   <m:CARRIERResponse xmlns:m="urn:schemas-iwaysoftware-com:iwse"
   xmlns="urn:schemas-iwaysoftware-com:iwse"
   cid="2A3CB42703EB20203F91951B89F3C5AF">
   <PS8>
      <error>Cannot find Component Interface {VARRIER}    (91,2)Initialization
    failed (90,7)Not Authorized (90,6)Failed to execute PSSession request Cannot find Component Interface {VARRIER} (91,2)</error>
        </PS8>
      </m:CARRIERResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

PeopleSoftリクエストからの空の結果

OracleAS Adapter for PeopleSoftがSOAPリクエストで渡された入力パラメータを使用してコンポーネント・インタフェースをWebサービスとして実行する場合に、その入力パラメータがPeopleSoft内のレコードと一致しないと、次のSOAPレスポンスが生成されます。

<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/1999/XMLSchema">
 <SOAP-ENV:Body>
  <m:CARRIERResponse xmlns:m="urn:schemas-iwaysoftware-com:iwse"
xmlns="urn:schemas-iwaysoftware-com:iwse" cid="2A3CB42703EB20203F91951B89F3C5AF">
    <PS8>
        <error>No rows exist for the specified keys. {CARRIER} (91,50)Failed to execute PSBusComp request</error>
    </PS8>
  </m:CARRIERResponse>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

PeopleSoftへの接続失敗

OracleAS Adapter for PeopleSoftがPeopleSoftに接続できない場合は、次のSOAPレスポンスが生成されます。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
  <SOAP-ENV:Fault>
   <faultcode>SOAP-ENV:Server</faultcode>
  <faultstring>java.lang.Exception: Error Logon to PeopleSoft
   System<faultstring>
 </SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

無効なSOAPリクエスト

Oracle Application Server Adapterが実行中のWebサービスのWSDLに準拠しないSOAPリクエスト・メッセージを受信すると、次のSOAPレスポンスが生成されます。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
 <SOAP-ENV:Fault>
  <faultcode>SOAP-ENV:Server</faultcode>
  <faultstring>RPC server connection failed: Connection refused: connect</faultstring>
 </SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Oracle Application Server Adapterのリクエストからの空の結果

渡された入力パラメータを使用してアダプタでSOAPリクエストを実行する場合に、入力パラメータがターゲット・システム内のレコードと一致しないと、次のSOAPレスポンスが生成されます。

注意: このアダプタの条件では、SOAP障害は生成されません。

<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/1999/XMLSchema">
   <SOAP-ENV:Body>
      <m:RunDBQueryResponse xmlns:m="urn:schemas-iwaysoftware-com:iwse"
        xmlns="urn:schemas-iwaysoftware-com:iwse"
        cid="2A3CB42703EB20203F91951B89F3C5AF">
        <RunDBQueryResult run="1" />
     </m:RunDBQueryResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>