タイムアウトを設定できるRMI-IIOP通信を，CTM連携ありの場合となしの場合について図に示し，タイムアウトの設定範囲について説明します。

図5-12　タイムアウトを設定できる通信（CTM連携ありの場合）

図5-13　タイムアウトを設定できる通信（CTM連携なしの場合）

RMI-IIOP通信のタイムアウトは，図のA，B，Cの3か所に設定できます。

• Aの場合
  図5-12または図5-13の，項番1.〜6.のRMI-IIOP通信すべてにタイムアウトが有効になります。タイムアウトの設定は，定義ファイルで行います。定義ファイルでの設定方法については，「(4)(a)　プロパティで設定する方法」を参照してください。
  
• Bの場合
  図5-12または図5-13の，項番1.，2.のCORBAネーミングサービスとの通信にタイムアウトが有効になります。タイムアウトの設定は，定義ファイルで行います。定義ファイルでの設定方法については，「(4)(a)　プロパティで設定する方法」を参照してください。
  
• Cの場合
  図5-12または図5-13の，項番4.〜6.のAPIの通信にタイムアウトが有効になります。
  EJBクライアントアプリケーションでのcreate〜ビジネスメソッド〜removeまでのAPIの通信のタイムアウト時間の設定は，アプリケーション開発時にAPI（RequestTimeoutConfigFactoryクラスおよびRequestTimeoutConfigクラスのメソッド）によって設定します。APIでの設定方法については，「(4)(b)　APIで設定する方法」を参照してください。
  

この機能による通信タイムアウトは，ORBに対して設定します。つまり，ORB配下のすべてのRMI-IIOP通信に対して設定されます。

設定のタイミングは，クライアント起動後の最初のnew javax.naming.InitialContext()実行時です。

CORBAネーミングサービスを利用しない場合でも，この機能を利用するときは，new javax.naming.InitialContext()をクライアントの処理の最初で実行してください。

クライアントからのリクエストに対してプロパティ指定値以内にレスポンスが返らない場合，該当リクエストはタイムアウトとしてキャンセルされます。この機能によって通信タイムアウトが発生した場合，java.rmi.RemoteException（org.omg.CORBA.TIMEOUT）の例外が発生します。この機能を利用するクライアントでは，Enterprise Beanのビジネスメソッド呼び出しなどで，この例外が発生することを考慮する必要があります。

タイムアウトの設定は，設定する範囲によって，定義ファイルのプロパティ，またはCosminexusが提供するAPIのどちらかで行います。プロパティで設定する方法とAPIで設定する方法の概要を説明します。

(a)　プロパティで設定する方法

図5-12，図5-13のAまたはBを設定する方法です。プロパティで設定する場合，タイムアウトの設定方法はEnterprise Beanがどこから呼び出されるかによって異なります。設定は，呼び出し元（EJBクライアント側）のJ2EEサーバ，WebコンテナサーバまたはEJBクライアントアプリケーションのプロパティとして設定します。

次に，Enterprise Beanを呼び出すEJBクライアントの形態ごとの設定方法を示します。

●Enterprise Beanの場合

クライアント側のEnterprise Beanが動作するJ2EEサーバのプロパティをカスタマイズして設定します。J2EEサーバの動作設定のカスタマイズについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

●JSP，サーブレットの場合

クライアント側のJSP，サーブレットが動作するJ2EEサーバのプロパティをカスタマイズして設定します。J2EEサーバの動作設定のカスタマイズについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

●EJBクライアントアプリケーションの場合

EJBクライアントアプリケーションの実行時に有効なプロパティとして設定します。EJBクライアントアプリケーションのプロパティの設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(b)　APIで設定する方法

図5-12，図5-13のCを設定する方法です。APIで設定する場合，com.hitachi.software.ejb.ejbclientパッケージのAPIを利用します。APIの機能と文法については，マニュアル「Cosminexus　リファレンス　API編」を参照してください。

RMI-IIOPの通信タイムアウトは，クライアントのプロセス起動後の，最初のInitialContext生成時にプロパティに指定した値が設定されます。ネーミングサービスを利用しない場合でも，RMI-IIOPの通信タイムアウトを設定する場合は，InitialContextを生成する必要があります。

ネーミングサービスの通信タイムアウトを設定する場合は，InitialContext生成やlookupなどの，JNDIのAPI呼び出し時にプロパティに指定した値が設定されます。

通信タイムアウト設定時の注意事項について説明します。

• 通信タイムアウトの定義が重複している場合の注意事項
  図5-12および図5-13のAの範囲とBの範囲の両方に通信タイムアウトを設定している場合，およびAの範囲とCの範囲に通信タイムアウトを設定している場合は次のように動作します。
  
  • Aの範囲とBの範囲の両方に通信タイムアウトを設定している場合の動作
    Aの範囲とBの範囲の両方に通信タイムアウトを設定している場合，通信タイムアウトは次の図のようになります。
    

    図5-14　Aの範囲とBの範囲の両方に通信タイムアウトを設定している場合の動作

    

  • Aの範囲とCの範囲の両方に通信タイムアウトを設定している場合の動作
    Aの範囲とCの範囲の両方に通信タイムアウトを設定している場合，Cの範囲の通信タイムアウト設定が有効となります。
    
• クライアント実装時の注意事項
  RMI-IIOPの通信タイムアウト，ネーミングサービスの通信タイムアウトと同時に，クライアントからのリクエストに対して指定値以内にレスポンスが返らない場合，該当するリクエストはタイムアウトとしてキャンセルされます。このとき，例外java.rmi.RemoteException（org.omg.CORBA.TIMEOUTなど）やjavax.naming.NamingExceptionが送出されます。通信タイムアウトを利用するクライアントを実装する場合，Enterprise Beanのメソッド呼び出しやJNDIのAPIなどでこれらの例外が発生することを考慮してください。
  
• タイムアウト発生後のサーバ側の動作についての注意事項
  クライアントからのリクエストがサーバ（ネーミングサービスやEnterprise Bean）に到着したあとに，サーバ側の処理中にタイムアウトが発生すると，クライアントに例外が返されます。ただし，タイムアウト発生後もサーバ側では正常に処理が継続されるため，Enterprise Beanのインスタンスの破棄や，リソースコネクションなどの資源の解放はされません。