Interstage Application Server リファレンスマニュアル（API編）

1.11.11 CORBA_ORB_set_client_timer()

名前

　CORBA_ORB_set_client_timer －サーバメソッド待機時間の設定

形式

　void
　CORBA_ORB_set_client_timer(
        CORBA_ORB              orb, 
        CORBA_Object           obj, 
        CORBA_long             time,
        CORBA_Environment      *env );

機能説明

　クライアントアプリケーションにおいて、objに指定したサーバオブジェクトに対するサーバメソッドが復帰するまでの待機時間をtimeに設定します。ここで設定する待機時間は、objに指定したホスト上で動作するサーバオブジェクトすべてに対して有効となります。

　obj   待機時間を設定するサーバオブジェクトのオブジェクトリファレンスを指定します。
　time  サーバメソッドが復帰するまでの待機時間を秒単位で指定します。
　　　　0を指定する場合はサーバメソッドが復帰するまでの待機時間を監視しません。

復帰値

　正常終了した場合は、復帰値はありません。
　異常終了した場合は、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが設定され、_idと_minorに詳細情報が設定されます。
　_idの意味と値は次のとおりです。_minorの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

　CORBA_INV_OBJREF

　objに不当なオブジェクトを指定しました。

　CORBA_BAD_PARAM

　timeに不当な値を指定しました。

　CORBA_NO_MEMORY

　メモリ不足が発生しました。

注意事項

• 本メソッドは、クライアントプロセスの待機時間をconfigファイルで設定される待機時間（period_receive_timeout×5秒）から変更する必要がある場合に使用します。
• 本メソッドは、サーバオブジェクトのオブジェクトリファレンスの獲得後にサーバへのリクエスト送信に先立って発行することにより、プロセス単位で待機時間を設定します。
• 業務アプリ動作中に待機時間を変更する場合は、CORBA_ORB_net_disconnect()でコネクション情報を解放後、本メソッドを発行することにより新たに待機時間の設定ができます。
• サーバオブジェクトのオブジェクトリファレンスの獲得前、または獲得時に、同じサーバマシンに対してリクエストが発行されていた場合は、本メソッドを発行する前にCORBA_ORB_net_disconnect()によってコネクション情報を解放する必要があります。例えば、サーバオブジェクトのオブジェクトリファレンスの獲得時にCosNaming_NamingContext_resolve()を使用した場合、かつネーミングサービスが動作しているマシンとサーバアプリケーションが動作しているマシンが同一である場合が該当します。