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アプリケーションとリソースの設定で使用する属性ファイルについては,次の個所を参照してください。

展開ディレクトリ形式の場合,コマンド実行ホストと同じホストで稼働している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の場合)。

注意事項