Cosminexus アプリケーションサーバ V8 リファレンス コマンド編
cjgetappprop(アプリケーションの属性の取得)
形式
- アプリケーションの場合
cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
-name <J2EEアプリケーション名>
[-encoding <エンコーディング名>] -c <属性ファイルパス>
- EJB-JARファイル,WARファイル,またはRARファイルの場合
cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>][-test]
-name <J2EEアプリケーション名> -type {ejb|war|rar}
-resname <リソース表示名>[/<下位リソース表示名>]
[-encoding <エンコーディング名>] -c <属性ファイルパス>
- すべての情報を取得する場合
cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
-name <J2EEアプリケーション名> -type all
[-encoding <エンコーディング名>] -c <属性ファイルパス>
機能
アプリケーション,またはそれぞれに含まれるリソース(EJB-JARファイルの場合:EJB-JARファイル,Session Bean,Entity Bean,Message-driven Bean,WARファイルの場合:WARファイル,サーブレット/JSP,フィルタ)の属性,またはRARファイルの属性を取得して,属性ファイルを生成します。
J2EEアプリケーションとリソースの設定で使用する属性ファイルについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」を参照してください。
展開ディレクトリ形式の場合,コマンド実行ホストと同じホストで稼働しているJ2EEサーバに対して操作できます。
引数
- <サーバ名称>
- 接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは,ホスト名称がサーバ名称として使用されます。
- -nameserver <プロバイダURL>
- CORBAネーミングサービスへのアクセスプロトコル,CORBAネーミングサービスが稼働しているホスト名,およびそれが使用しているポート番号を次に示す形式で指定します。
<プロトコル名称>::<ホスト名称>:<ポート番号>
- 指定内容の詳細については,「2.1(2) プロバイダURLについて」を参照してください。
- -test
- テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは,通常モードのアプリケーションに対してコマンドが実行されます。
- -name <J2EEアプリケーション名>
- 取得対象のJ2EEアプリケーション名を指定します。
- -type {ejb|war|rar|all}
- 取得するリソースの種別を指定します。
- ejb:EJB-JARファイルまたはEJB-JARファイル内のEJBファイル
- war:WARファイル,WARファイル内のサーブレット/JSPまたは,フィルタ
- rar:RARファイル
- all:すべての情報
- -resname <リソース表示名>
- 取得対象となるリソースの表示名を指定します。
- ejb-jar:<EJB-JARファイルの表示名>
- ejb:<EJB-JARファイルの表示名>[/<Enterprise Beanの表示名>]
- war:<WARファイルの表示名>
- rar:<RARファイルの表示名>
- Servlet/JSP:<WARファイルの表示名>[/<サーブレット/JSPの表示名>]
- filter:<WARの表示名>[/<フィルタの表示名>]
- なお,下位リソース表示名を指定しなかった場合は,それぞれEJB-JARファイル,またはWARファイルの指定となります。
- -encoding <エンコーディング名>
- 属性ファイル出力時のエンコーディング名を指定します。指定できるエンコーディング名を次に示します。
- UTF8
- UTF-8
- ASCII
- US-ASCII
- ISO-8859-1
- EUC_JP
- Shift_JIS
- SJIS
- windows-31j
- MS932
- JavaVMがサポートしているエンコーディング名
- 省略した場合は,JavaVMのデフォルトエンコーディング名を使用します。使用されたエンコーディング名を確認するには,このコマンドで取得した属性ファイルの先頭行のXML宣言部分を参照してください。
<?xml version="<XML規格のバージョン番号>" encoding="<エンコーディング名>"?>
- -c <属性ファイルパス>
- 属性ファイルの出力先パスを指定します。
入力例
- アプリケーションの場合
cjgetappprop MyServer -name App1 -encoding Shift_JIS -c App1Prop.xml
- EJB-JARファイルの場合
cjgetappprop MyServer -name App1 -type ejb -resname accountJsp/MyAccount -encoding UTF-8 -c MyAccountProp.xml
- WARファイルの場合
cjgetappprop MyServer -name App1 -type war -resname account-war/Account -c AccountProp.xml
- RARファイルの場合
cjgetappprop MyServer -name App1 -type rar -resname account-rar -c AccountProp.xml
- すべての情報を取得する場合
cjgetappprop MyServer -name App1 -type all -encoding Shift_JIS -c App1AllProp.xml
戻り値
- 0:
- 正常終了しました。
- 1:
- 異常終了しました。
- 2:
- 排他エラーによってコマンドを実行できません。
- 3:
- タイムアウトが発生しました。
- 9:
- 管理者特権がないため,コマンドが実行できません(Windows Server 2008 x86,Windows Server 2008 x64,Windows Server 2008 R2,Windows 7またはWindows Vistaの場合)。
注意事項
- コマンドの引数にサーバ名称を指定する場合,コマンド名の直後にする必要があります。そのほかの引数は,サーバ名称より後ろ(サーバ名称を省略した場合はコマンド名の後ろ)にあれば順序は任意です。ただし,オプション名と値の順序の入れ替え(例:<J2EEアプリケーション名> -name)やオプション名と値を非対応にすること(例:-name ejb -type <J2EEアプリケーション名>)はできません。
- コマンドの引数にサーバ名称を指定する場合,cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
- 指定したパスにすでに属性ファイルが存在する場合,上書きします。
All Rights Reserved. Copyright (C) 2008, 2010, Hitachi, Ltd.