WebOTX Manual V11.1 (第6版) 目次を表示 |
WebOTX Object Broker が提供している以下のコマンドについて説明しています。
Windows版には、環境設定(Windows共通)を行う以下のコマンドがあります。
また、サーバアプリケーションに対してログ出力モードの切り替えを行う以下のコマンドがあります。
また、サーバプロセス情報のリスト表示を行う以下のコマンドがあります
名前orbcustm - 環境設定(Windows共通)形式orbcustm機能説明orbcustmは、WebOTX Object Brokerの環境設定を行います。注意事項
- [サービスの登録]ボタン
このボタンを押すとWebOTX Object Brokerを「サービス」に登録します。インストール直後は「サービス」に登録されているので、通常このボタンを押す必要はありません。
WebOTX Object Brokerのサーバを起動するには「コントロールパネル」の「サービス」を開き、「ObjectBroker<バージョン>」を選択した後に[開始]ボタンを押します。
また、WebOTX Object Brokerのサーバを終了するには「コントロールパネル」の「サービス」を開き、「ObjectBroker<バージョン>」を選択した後に[停止]ボタンを押します。
なお、「サービス」の詳しい使い方はWindows マニュアルをご覧ください。
- [サービスの削除]ボタン
このボタンを押すとWebOTX Object Brokerを「サービス」から削除します。通常このボタンを押す必要はありません。WebOTX Object Brokerを「サービス」から削除する場合は必ずWebOTX Object Brokerの「サービス」が終了していることを確認してください。
WebOTX Object Brokerのサーバを終了するには「コントロールパネル」の「サービス」を開き、「ObjectBroker<バージョン>」を選択した後に[停止]ボタンを押します。
- [OK]ボタン
orbcustmを終了させたいときに押します。「設定変更」の[更新]ボタンを押さなかった場合も変更は保存されます。
- [キャンセル]ボタン
orbcustmを終了さたいときに押します。「設定変更」の[更新]ボタンを押さなかった場合、変更は保存されません。「設定変更」について
WebOTX Object Brokerの設定を変更するときは、必ずWebOTX Object Brokerのサーバが終了していることを確認してください。WebOTX Object Brokerのサーバが動作している最中に設定を変更した場合の動作は保証しません。
WebOTX Object Brokerのサーバを終了するには「コントロールパネル」の「サービス」を開き、「ObjectBroker<バージョン>」を選択した後に[停止]ボタンを押します。
- ORBのインストールされているディレクトリ
WebOTX Object Brokerがインストールされているディレクトリを指定します。通常、インストーラが自動的に設定するので変更する必要はありません。
- oadを動作させる
このチェックボックスをONにすると、WebOTX Object Broker起動時にoadの起動を試みます。
注意 : corbalocサーバ、oadj、IRサーバ、セキュリティ管理サーバを起動する場合、oadを起動してください。
- 名前サーバを動作させる
このチェックボックスをONにすると、WebOTX Object Broker起動時に名前サーバの起動を試みます。
注意 : 「このマシンで名前サーバを動作させる」チェックボックスをONにしても、ホスト名は変更されません。別ホストになっているときは、空白もしくは正しいホスト名またはIPアドレスを設定する必要があります。
- IRサーバを動作させる
このチェックボックスをONにすると、WebOTX Object Broker起動時にインタフェースリポジトリの起動を試みます。
注意 : 「このマシンでIRサーバを動作させる」チェックボックスをONにしても、ホスト名は変更されません。別ホストになっているときは、空欄もしくは正しいホスト名またはIPアドレスを設定する必要があります。
- キャッシュ名前サーバを動作させる
このチェックボックスをONにすると、WebOTX Object Broker起動時にキャッシュ名前サーバの起動を試みます。
キャッシュ名前サーバがインストールされている場合のみ設定出来ます。
- corbalocサーバを動作させる
このチェックボックスをONにすると、WebOTX Object Broker起動時にcorbalocサーバの起動を試みます。
- ロギング
このチェックボックスをONにすると、簡単な動作状況をファイルに保存します。名前サーバやインタフェースリポジトリはWebOTX Object Brokerをインストールしたディレクトリ下のlogディレクトリにファイルを保存します。ファイルは追記されるので、必要がなければOFFにしておくほうがよいでしょう。
- ORBの使用するポート番号を予約する
このチェックボックスをONにすると、WebOTX Object Brokerの各サーバが使用するポート番号を、他プロセスの一時ポートとして使用されないように予約を行います。OADおよび設定変更画面の「〜を動作させる」のチェックがONになっているサーバが予約対象になります。
注意 : 設定変更後はマシンの再起動が必要となります。
- [詳細設定...]ボタン
このボタンを押すとダイアログが表示されます。詳細設定のダイアログでは以下の設定および操作をすることができます。
- OADのポート番号
OADが使用するポートの番号を10進数で指定します。特定のグループ内で同じ番号を割り当ててください。0に設定すると既定値が使われます。
- 名前サーバのホスト名
名前サーバを動作させるマシンの名前またはIPアドレスを指定します。
- 名前サーバのポート番号
名前サーバが利用するポートの番号を10進数で指定します。0に設定すると自動的に割り当てられます。
- IRサーバのホスト名
インタフェースリポジトリを動作させるマシンの名前またはIPアドレスを指定します。
- IRサーバのポート番号
インタフェースリポジトリが利用するポートの番号を10進数で指定します。0に設定すると自動的に割り当てられます。
- corbalocサーバのポート番号
corbalocサーバが利用するポートの番号を10進数で指定します。0に設定すると9827(既定値)が割り当てられます。
- URLのデフォルトポート番号
URLでポート番号を指定しなかったときのポートの番号を10進数で指定します。0に設定すると2809(既定値)が割り当てられます。
- [OK]ボタン
このボタンを押すと、変更内容を記憶してダイアログを閉じます。この時点では変更内容を有効にしません。変更を有効にするには[更新]ボタンを押すか、orbcustmを終了する[OK]ボタンを押す必要があります。
- [キャンセル]ボタン
このボタンを押すと、変更内容を破棄してダイアログを閉じます。
- [更新]ボタン
このボタンを押すことで設定変更を直ちに有効にすることができます。正常動作させるためにはWebOTX Object Brokerが動作していないことを確認してから「更新」ボタンを押す必要があります。
orbcustmは、ドメイン未使用のWebOTX Object Brokerの環境設定を行う事が出来ます。
ドメイン使用時のWebOTX Object Brokerの環境設定方法は、 [リファレンス > 設定 > CORBA通信基盤(Object Broker)] を参照して下さい。
名前chconf - ログ出力モードの切り替え(Windows版)chconf.sh - ログ出力モードの切り替え(UNIX版)形式chconf [Oad|InterfaceRepository|NameService|Corbaloc|CacheNameService] [-oblog none|error|warning|info] [-messagelog on|off] [-syslog on|off] -WOdomain WebOTXinstanceroot機能説明
Memo
- UNIX版では、拡張子(".sh")が付与されたコマンドを必ず使用してください。
- 本バージョンでは、InterfaceRepository、Corbaloc、CacheNameServiceを指定できません。
chconfは引数で指定した情報をもとに、それに対応するサーバアプリケーションに対してログ出力モードの切り替えを行います。
ログ出力モードの切り替えは、すでに起動しているサーバに対してのみ行うことができます。
各オプションの意味は以下のとおりです。
Oad OADサーバのログ出力モードの切り替えを行います。 InterfaceRepository IRサーバのログ出力モードの切り替えを行います。 NameService 名前サーバのログ出力モードの切り替えを行います。 Corbaloc corbalocサーバのログ出力モードの切り替えを行います。 CacheNameService キャッシュ名前サーバのログ出力モードの切り替えを行います。 -oblog ログファイルに出力するレベルを指定します。
none:情報出力を行いません。
error:エラー情報のみ出力します。
warning:エラーとワーニング情報を出力します。
info:すべての情報を出力します。-messagelog 通信相手、通信量のログ出力を指定します。
on:情報出力を行います。
off:情報出力を行いません。-syslog システムログ情報のログ出力を指定します。
on:情報出力を行います。
off:情報出力を行いません。-WOdomain WebOTX instance rootを指定します。例えばunixでdomain1を使用している場合、/opt/WebOTX/domains/domain1となります。
また、以下のプロパティを事前に設定しておく事で、
各オプション-oblog、-messagelog、-syslogと同等の効果が得られます。
- LoggingLevel
- MessagingLog
- MessageBodyLog
- Syslog
- SyslogDetail
- SyslogForOperator
- SyslogForDeveloper
※各設定についての説明は、 [リファレンス > 設定 > CORBA通信基盤(Object Broker)] を参照して下さい。
名前listserv.bat - サーバインプリメンテーションのリスト表示形式listserv.bat機能説明listserv.batは、OAD(Object Activation Daemon : サーバプロセス情報を管理するもの)に登録されている情報を表示します。表示される情報は、OADに登録されているインプリメンテーション名と、それに対応したサーバプロセスの状態です。状態はリストの右側に表示され、サーバが動作中かそうでないかを表します。動作していないとは、インプリメンテーション名は登録されているが、それと一致するサーバプロセスが応答しないことを意味します。注意事項
参照するドメインを変更するには「File」→「Domain」を選択して下さい。
listserv.batはウィンドウの内容を更新しません。最新の情報を表示するには一度終了して再起動する必要があります。
Windows版には、名前サーバのブラウズを行う以下のコマンドがあります。
また、名前サーバのNDFファイルを変換するツールがあります。
名前
orbmanag.bat - 名前サーバのブラウズ(Windows版)形式
orbmanag.bat
機能説明
orbmanag.batは名前サーバに登録されている情報をディレクトリツリーのように表示します。このコマンドを使うには、名前サーバの動作するホスト名およびポート番号が適切に設定され、かつ、既に名前サーバが起動されている必要があります。
参照する名前サーバを変更するには「参照先(R)」→「ホスト名指定(H)」または「参照先(R)」→「URL指定(U)」を選択してください。「ホスト名指定(H)」ではホスト名を指定することができます。「URL指定(U)」ではURLを指定することができます。
URLで指定するには、名前サーバの動作しているホストでcorbalocサーバも動作している必要があります。
初期設定に戻すには「参照先(R)」→「デフォルト設定(D)」を選択してください。
また、参照するドメインを変更するには「参照先(R)」→「ドメイン指定(M)」を選択して下さい。
終了するにはメニューの「ファイル(F)」→「アプリケーションの終了(X)」を選択するか、クローズボックスをクリックしてください。「表示(V)」→「ステータスバー(S)」を選択するとステータスバーの表示/非表示を切り替えることができます。最新の情報に更新するにはメニューの「表示(V)」→「最新の情報に更新(R)F5」を選択してください。「ヘルプ(H)」→「バージョン情報(orbmanag)(A)...」を選択するとorbmanag.batのバージョンが表示されます。
関連項目orbcustm(Windows版)
名前
convndf - 名前サーバのNDF変換ツール(Windows版)convndf.sh - 名前サーバのNDF変換ツール(Unix版)形式
convndf [-h hostname] [-p port-number] [-i ndf-file-path] [-o output-path]※UNIX版では、拡張子(".sh")が付与されたコマンドを必ず使用してください。
機能説明
convndfは名前サーバのNDFファイル内に格納されているIOR情報のホスト名及びポート番号を変換するツールです。
変換元と変換先のファイルパスが同じ場合は、変換元NDFファイルを「namesv.ndf.org」として退避します。
各オプションの意味は以下のとおりです。
-h 変更するホスト名を指定します。 -p 変更するポート番号を指定します。 -i 変換するNDFファイルのパスを指定します。指定されていない場合は、環境変数OrbRootに指定されているパスのNDFファイルを変換対象とみなします。 -o 変換したNDFファイルの出力先パスを指定します。指定されていない場合は、変換対象NDFファイルの格納先を出力先とみなします。
実行例例1)# convndf -h host01 環境変数OrbRootに指定されているパスに存在するNDFファイルのホスト名を変換します。変換元のNDFファイルは、namesv.ndf.orgとして退避されます。
例2)# convndf -p 9999 -i "C:\WebOTX\ObjectBroker\conf"オプション「−i」に指定されているパスのNDFファイルのポート番号を変換します。変換元のNDFファイルは、namesv.ndf.orgとして退避されます。
例3)# convndf -h host02 -p 8888 -i "C:\WebOTX\ObjectBroker\conf" -o "C:\temp"オプション「−i」に指定されているパスのNDFファイルのホスト名とポート番号を変換します。変換したNDFファイルはオプション「−o」に指定されたパスに格納されます。
インタフェースリポジトリを操作する以下のコマンドがあります。
名前instif - インタフェース定義の登録(Windows版)instif.sh - インタフェース定義の登録(UNIX版)形式instif FILENAME -WOdomain WebOTXinstanceroot※UNIX版では、拡張子(".sh")が付与されたコマンドを必ず使用してください。
機能説明instifは、IDLコンパイラが出力したインタフェース定義情報(*.ifファイル)をリポジトリに登録します。各オプションの意味は以下のとおりです。関連項目
FILENAME IDLコンパイラが出力したインタフェース定義情報(*.ifファイル)を指定します。 -WOdomain WebOTX instance rootを指定します。例えばunixでdomain1を使用している場合、/opt/WebOTX/domains/domain1となります。 rmif, listif, IDLコンパイラ
名前rmif - インタフェース定義の削除(Windows版)rmif.sh - インタフェース定義の削除(UNIX版)
形式rmif FILENAME -WOdomain WebOTXinstanceroot※UNIX版では、拡張子(".sh")が付与されたコマンドを必ず使用してください。
機能説明rmifは、IDLコンパイラが出力したインタフェース定義情報(*.ifファイル)をリポジトリから削除します。各オプションの意味は以下のとおりです。
FILENAME IDLコンパイラが出力したインタフェース定義情報(*.ifファイル)を指定します。 -WOdomain WebOTX instance rootを指定します。例えばunixでdomain1を使用している場合、/opt/WebOTX/domains/domain1となります。
関連項目instif, listif, IDLコンパイラ
名前listif - インタフェース定義の表示(Windows版)listif.sh - インタフェース定義の表示(UNIX版)形式listif -WOdomain WebOTXinstanceroot機能説明※UNIX版では、拡張子(".sh")が付与されたコマンドを必ず使用してください。listifは、リポジトリに登録されているインタフェース定義情報を表示します。各オプションの意味は以下のとおりです。関連項目
-WOdomain WebOTX instance rootを指定します。例えばunixでdomain1を使用している場合、/opt/WebOTX/domains/domain1となります。 instif, rmif, IDLコンパイラ
oadj/oadを操作する以下のコマンドがあります。
名前instimpl - インプリメンテーションの登録形式instimpl name command-line activation-policy [-host host-name] [ORB-properties]機能説明instimplはサーバのインプリメンテーション情報を登録します。 nameにはインプリメンテーション名を指定します。 command-lineにはサーバを起動するときのコマンドラインの文字列を指定します。 activation-policyにはサーバの活性化方針を指定します。 活性化方針にはつぎのものがあります。関連項目-host オプションは、リモートホストにインプリメンテーションを登録するときに指定します。host-nameにはホスト名を指定します。
- SharedServer
自動起動サーバ。サーバ内に複数のオブジェクトが存在する。- UnsharedServer
自動起動サーバで、オブジェクトごとにサーバが起動される。- PersistentServer
手動起動サーバ。サーバ内に複数のオブジェクトが存在する。
ORB-propertiesには、必要であればORBプロパティを指定します。
注意: 上記活性化方針の説明でPersistentServerとあるのは、ORBが自動起動を行わないサーバのことを指しています。POAのPersistentObjectポリシーとは独立した概念ですので、混同しないように注意してください。listimpl, rmimpl
名前rmimpl - インプリメンテーションの削除形式rmimpl name [-host host-name] [ORB-properties]機能説明rmimplはサーバのインプリメンテーション情報を削除します。 nameにはインプリメンテーション名を指定します。関連項目
-host オプションは、リモートホストにインプリメンテーションを登録するときに指定します。host-nameにはホスト名を指定します。
ORB-propertiesには、必要であればORBプロパティを指定します。listimpl, instimpl
名前listimpl - インプリメンテーションの一覧形式listimpl [-l] [-host host-name][ORB-properties]機能説明listimplはサーバのインプリメンテーション一覧を表示します。-l オプションを指定すると詳細情報を表示します。関連項目
-host オプションは、リモートホストに登録されているインプリメンテーション情報を一覧するときに指定します。host-nameにはホスト名を指定します。
ORB-propertiesには、必要であればORBプロパティを指定します。instimpl, rmimpl
名前listserv - サーバインプリメンテーションのリスト表示形式listserv機能説明listservは、OAD(Object Activation Daemon : サーバプロセス情報を管理するもの)に登録されている情報を表示します。表示される情報は、OADに登録されているインプリメンテーション名と、それに対応したサーバプロセスの状態です。状態はリストの右側に表示され、サーバが動作中かそうでないかを表します。動作していないとは、インプリメンテーション名は登録されているが、それと一致するサーバプロセスが応答しないことを意味します。注意
listservはウィンドウの内容を更新しません。最新の情報を表示するには一度終了して再起動する必要があります。
IDLコンパイラとしては以下のコマンドがあります。
名前i2j - IDL定義ファイルからJavaソースコードを自動生成(Windows版)i2j.sh - IDL定義ファイルからJavaソースコードを自動生成(UNIX版)形式i2j [-i] [-Idir] [-Dname[=val]] [-Uname] [-Rreffile] [-V] [-nocpp] [-tie] [-lstub] [-rppackage_name] [-noskel] [-ddir] [-notstream] [-oldname] [-nofactory] [-vsskel] [-vsinit] [-lcopy] [-noanycopy] [-Xmnum] FILENAME機能説明※UNIX版では、拡張子(".sh")が付与されたコマンドを必ず使用してください。i2jはFILENAMEで指定されたIDL定義ファイルをもとに、ORBを利用したアプリケーションを作成するために必要なJavaマッピングのJavaソースコードを自動生成します。その他
生成されるファイル中のクラスの詳細は [アプリケーション開発 > CORBA アプリケーション > プログラミング・開発ガイド > Object Broker > Javaマッピング] を参照してください。
各オプションの意味は以下のとおりです。
-i インタフェースリポジトリにインタフェース定義を登録するためのファイル(<FILENAME >.if)を生成します。 -Idir プリプロセッサがインクルードするファイルのディレクトリをdirで指定します。複数指定することも可能です。 -Dname[=val] #define同様にマクロを定義します。valが指定されていないときは値として1が指定されます。 -Uname #undef同様にプリプロセッサで既定義のマクロを無効にします。複数指定することも可能です。 -Rreffile reffileの定義を参照することができます。ただし、reffileのJavaソースコードは生成されません。 -V バージョンを表示します。 -nocpp プリプロセッサによる処理を省略します。 -tie tieクラスを出力します。 -lstub ローカルスタブコードを出力します。実装オブジェクトとそれを呼び出すクライアントが同一プロセス内で動作する時には、このオプションを指定しておくとネットワークを使用しないようになり、高速な呼び出しが可能となります。 -rppackage_name このオプション以降の-Rオプションで指定されるIDL定義が、package_nameで指定されたパッケージに置かれているものとしてコードを生成します。-rpオプションは複数指定することができます。-rpオプションにpackage_nameの指定がない場合にはデフォルトの設定に戻ります。
ex.) i2j -rpfoo.bar -RA.idl -RAA.idl -rp -RB.idl C.idl
上記の例では、A.idlとAA.idlがfoo.barというパッケージにおかれているものとし、B.idlはデフォルトのグローバルなパッケージにあるものとして、C.idlに対するJavaソースコードを生成します。-noskel サーバのスケルトンコードを生成しません。このオプションは、クライアントプログラムの開発者がサーバ作成用のソースコードを必要としないときに使用します。(サーバプログラムはi2jの生成した全てのソースを使用するため、-nostubというようなオプションはありません) -ddir javaソースコードの出力先を、dirで指定したディレクトリ配下に変更します。javaソースコード出力先のデフォルトは、i2jを起動したディレクトリです。 -notstream 従来のDII/DSIを使用したスタブ/スケルトンを生成するときに使用します。このオプションが指定されない場合はStreamベースのスタブ/スケルトンを出力します。パラメータレベルのフックを使用する場合は、本オプションを指定してください。 -oldname スケルトンおよびtieクラスの名前を旧形式の名前(POA_<interface名>, POA_<interface名>_tie)で出力します。このオプションが指定されない場合は、CORBA2.3形式の名前(<interface名>POA, <interface名>POATie)で出力します。 -nofactory valuetypeに対するバリューファクトリの実装クラスの雛形ファイルを生成しません。このオプションが指定されない場合、雛形ファイルは<valuetype名>DefaultFactoryという名前で生成されます。ただし、既にこの名前のファイルが存在する場合は上書きしません。 -vsskel スケルトンのinvokeメソッドに展開されている処理を内部メソッドに分割して出力します。1つのインタフェース内に多数のパラメータを持つメソッドを多量に定義すると、スケルトンのinvokeメソッドのコードが膨大になるためJava実行時に例外が発生する場合があります。このような場合、本オプションでinvokeメソッドのコード量を小さくすることにより、Java例外を避けることができます。 -vsinit パラメータ数が255以上となるstruct/exception定義のコンストラクタの出力を抑制します。1つのstruct/exception内に多数のメンバを定義すると、対応するコンストラクタのパラメータ数がJavaの制限を超え、Java実行時に例外が発生する場合があります。このような場合、本オプションでコンストラクタの出力を抑制することにより、Java例外を避けることができます。ただしこの場合は、メンバの初期化は利用者が直接行う必要があります。 本オプション指定時のコンストラクタ出力例は、-vsinit指定時のコンストラクタ出力例を参照してください。 -lcopy オペレーションのパラメータに対するローカルコピー処理を、スタブに生成します。ローカルコピーの対象となるのはinおよびinout属性のパラメータで、かつその型がvaluetype型、any型、およびそれらの型を含む型(struct、union、sequence、array、typedef)の場合です。 -noanycopy 本オプションは-lcopyオプションと合わせて使用するもので、any型およびany型を含む型のパラメータをローカルコピーの対象外にします。ただし、any型とvaluetype型の両方を含むような型については、本オプションを指定してもローカルコピー処理が展開されます。 -addpkgpackagename Java ソースファイルを packagename に指定したパッケージに生成します。このオプションを指定しても、リポジトリIDには影響はありません。 -not_strict_param オペレーションの引数の型名と大文字小文字のみが異なる名前を引数名として利用する場合に指定します。 -Xmnum プリプロセッサにおけるユーザ定義マクロ識別子数の最大値をnumで指定します。このオプションが指定されない場合の既定値は8191です。 7.5.1.1. -vsinit指定時のコンストラクタ出力例
1. structの例struct定義に対しては、通常以下の2種類のコンストラクタが展開されます。
- 引数なしのコンストラクタ
- structの全メンバを引数に持つコンストラクタ
-vsinitオプションを指定すると、structのメンバが255個以上(注)定義された場合に後者のコンストラクタを展開しません。従って利用者がstructを初期化する場合は、引数なしのコンストラクタでstructのインスタンスを生成して、各メンバに直接値を設定するなどの必要があります。
(注)IDL double型およびlong long型のメンバは、それぞれ2個分にカウントされます。
// IDL struct StructType { long field1; long field2; : long field255; }; // Generated Java final public class StructType implements org.omg.CORBA.portable.IDLEntity { // instance variables public int field1; public int field2; : public int field255; // constructors /* following constructor is deleted by -vsinit option. */ /* public StructType(p1, ... , pN) {} */ public StructType() {} }2. exceptionの例exception定義に対しては、通常以下の3種類のコンストラクタが展開されます。
- 引数なしのコンストラクタ
- exceptionの全メンバを引数に持つコンストラクタ
- exceptionの全メンバとStringを引数に持つコンストラクタ
-vsinitオプションを指定すると、以下のようにコンストラクタの抑制を行います。従って、利用者がexceptionを初期化する場合は、引数なしのコンストラクタでexceptionのインスタンスを生成して、各メンバに直接値を設定するなどの必要があります。
- exceptionの全メンバを引数に持つコンストラクタ
exceptionのメンバが255個以上(注)定義された場合は展開されません。- exceptionの全メンバとStringを引数に持つコンストラクタ
exceptionのメンバが254個以上(注)定義された場合は、String情報のみを引数に持つコンストラクタを展開します。(注)IDL double型およびlong long型のメンバは、それぞれ2個分にカウントされます。
// IDL exception ExceptionType { short field001; short field002; : short field255; }; // Generated Java final public class ExceptionType extends org.omg.CORBA.UserException { /* instance variables*/ public short field001; public short field002; : public short field255; /* constructors*/ /* following constructor is deleted by -vsinit option. */ /* public ExceptionType(p1, ... , pN) {} */ /* instead of following original constructor, output that */ /* has only "reason" parameter by -vsinit option. */ /* public ExceptionType(reason, p1, ... , pN) {} */ public ExceptionType(String reason) { super(ExceptionTypeHelper.id()+" "+reason); } public ExceptionType() { super(ExceptionTypeHelper.id()); } }
名前i2cc - IDL定義ファイルからC++ソースコードを自動生成形式i2cc [-i] [-Idir] [-Dname[=val]] [-Uname] [-Rreffile] [-PC] [-V] [-E] [-EC] [-EI] [-Xdii] [-Xdsi] [-TIE] [-lstub] [-no_env_skel] [-not_strict_param] [-init_member] [-separate_header] [-no_env_operation] [-no_env_cmn_func] [-use_out] [FILENAME]機能説明i2ccはFILENAMEで指定されたIDL定義ファイルをもとに、ORBを利用したアプリケーションを作成するために必要なC++マッピングのスタブ/スケルトンを自動生成します。
i2ccはC++コンパイラのプリプロセッサを使います。したがって、あらかじめC++コンパイラをインストールし、パスを設定しておく必要があります。
パスの設定方法はOSにより異なります。具体的な方法については各OSのマニュアルを参照してください。
各オプションの意味は以下のとおりです。
-i インタフェースリポジトリにインタフェース定義を登録するためのファイル(.if)を生成します。 -I プリプロセッサがインクルードするファイルのディレクトリをdirで指定します。複数指定することも可能です。 -D #define同様にマクロを定義します。valが指定されていないときは値として1が指定されます。 -U #undef同様にプリプロセッサで既定義のマクロを無効にします。複数指定することも可能です。 -R reffileに定義された定義を参照することができます。このオプションを指定することによって、reffileで定義されている型を利用したり、インタフェースを継承したりすることができます。 -PC プリコンパイル済みヘッダを利用するときに指定します。 -V i2ccのバージョンを表示します。 -E cmnファイルとimpファイルをVisual C++で作成するDLLに組み込むときに使用します。 -EC cmnファイルのみをVisual C++で作成するDLLに組み込むときに使用します。 -EI impファイルのみをVisual C++で作成するDLLに組み込むときに使用します。 -Xdii DIIを使用したスタブを生成するときに使用します。DIIを使用すると一般に性能は劣化しますので、このオプションは通常使う必要はありません。クライアントでフックを使用する場合は指定してください。 -Xdsi DSIを使用したスケルトンを生成するときに使用します。DSIを使用すると一般に性能は劣化しますので、このオプションは通常使う必要はありません。 -TIE TIEアプローチを使ったサーバを実現するときに使用します。TIEアプローチとは、スケルトンクラスを継承しないでサーバを実装する方法のひとつです。 -lstub ローカルスタブコードを出力します。実装オブジェクトとそれを呼び出すクライアントが同一プロセス内で動作する時には、このオプションを指定しておくとネットワークを使用しないようになり、高速な呼び出しが可能となります。 -no_env_skel CORBA::Environment引数を付加しないシグネチャのスケルトンを利用する場合に指定します。 -not_strict_param オペレーションの引数の型名と大文字小文字のみが異なる名前を引数名として利用する場合に指定します。 -init_member struct、union、およびexceptionのstring型のメンバ、またはstring型のsequenceの各要素を空文字列("")で初期化する場合に指定します。 -separate_header impファイル用のヘッダファイルを別ファイル(*_sk.h)に分離する場合に指定します。 -no_env_operation CORBA::Environment引数を付加しないシグネチャを持つオペレーションのスタブを利用する場合に指定します。 -no_env_cmn_func 各interface型について生成される共通関数(CORBA::release()、CORBA::is_nil()、_duplicate()、_nil())をCORBA::Environment引数を付加しないシグネチャにする場合に指定します。 -use_out オペレーションのout引数にout型を利用する場合に指定します。
なお、i2ccは文字列定数として2048文字までの大きさしか扱えません。
例)
また、IDL定義に次元数が大変多い多次元配列を定義するときは注意が必要です。たとえば、100次元の多次元配列を定義したとき、IDLコンパイラは正常にソースコードを出力しますが、その出力コードをC++コンパイラがコンパイルできるかどうかはC++コンパイラに依存します。
// IDL
const string str = "abcdefg..."; // 2048文字まで
Object Brokerで障害を検出した場合、ツールを使用し情報の採取、解析を行うことができます。
WindowsコマンドとUNIXコマンドの拡張子がそれぞれ異なります。Windowsの場合は「cmd」UNIXの場合は「sh」です。
各コマンドの詳細については、 [ トラブルシューティング > 障害時の操作 > 情報採取 > 手動で情報採取する場合は > CORBA通信基盤(Object Broker) ] を参照してください。
指定された名前サーバのNDFファイルを解析し、結果をファイルへ出力するコマンドがあります。
Object Broker C++関連のログに出力された、エラーコード(マイナー)を解析し、結果をファイルへ出力するコマンドがあります。
名前
ospi_ndfcheck - NDFファイル解析ツール形式
ospi_ndfcheck [-file filename] [-path dir]
機能説明
ospi_ndfcheckはfilenameで指定されたNDFファイルを解析し結果をファイルに出力します。
出力されるファイル名は、指定されたNDFファイル名に「_check_info.txt」を付加したファイル名です。
例) namesv.ndf_check_info.txt出力される情報は、[Fileversion],[Hostname],[Portnumber],[ContextInfo],[BindingIteraterInfo],[ObjectInfo]です。
[BindingIteraterInfo]が含まれる場合は、警告として「Warning:BindingIterator information is left. There is a possibility that enlargement causes.」が出力されます。
指定されたログファイルが壊れている場合は、コンソールに「Datafile is broken」が出力されます。
また、予期せぬエラーが発生した場合は、コンソールに「An Unexpected Error (has occured)」が出力されます。
各オプションの意味は以下のとおりです。
-file 解析するNDFファイル名を指定します。 -path 解析するNDFファイルのディレクトリ指定。省略時、実行カレントに配置されているNDFファイルを解析します。 -dump IORのダンプを出力します。 -v ospi_ndfcheckのバージョンを表示します。 -h ospi_ndfcheckのヘルプを表示します。
名前
ospi_loganalyze - ログ解析ツール形式
ospi_loganalyze [-file filename] [-path dir]
機能説明
ospi_loganalyzeはfilenameで指定されたログのエラーコード(マイナー)を解析し結果をファイルに出力します。
出力されるファイル名は、指定されたログファイル名に「_convminercode_info.txt」を付加したファイル名です。
出力されるフォーマットは、以下です。例) oad.log_convminercode_info.txt
行数 -> 日付 -> (マイナーコード) -> 例外情報の詳細
予期せぬエラーが発生した場合は、コンソールに「An Unexpected Error (has occured)」が出力されます。※ 「->」はデリミタ。
各オプションの意味は以下のとおりです。
-file 解析するログファイル名を指定します。 -path 解析するログファイルのディレクトリ指定。省略時、実行カレントに配置されているログファイルを解析します。 -v ospi_loganalyzeのバージョンを表示します。 -h ospi_loganalyzeのヘルプを表示します。
ユーティリティコマンドについて説明します。
名前
maskstr - 文字列暗号化ツール形式
maskstr PASSPHRASE
機能説明
maskstrは、OpenSSL利用時に設定するパスフレーズ文字列を暗号化するツールです。 PASSPHRASEには、暗号化する文字列を指定します。
実行例
コマンドを実行すると、暗号化した文字列をコンソールに表示します。
> maskstr ABCDE
MASKED STRING: 90de579a43