cjgetappprop（アプリケーションの属性の取得）

Cosminexus V9 アプリケーションサーバリファレンスコマンド編

アプリケーションの場合

cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名> 
             [-encoding <エンコーディング名>] -c <属性ファイルパス>

EJB-JARファイル，WARファイル，またはRARファイルの場合

cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名> -type {ejb|war|rar}
             -resname <リソース表示名>[/<下位リソース表示名>]
             [-encoding <エンコーディング名>] -c <属性ファイルパス>

すべての情報を取得する場合

cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名> -type all
             [-encoding <エンコーディング名>] -c <属性ファイルパス>

アプリケーション，またはそれぞれに含まれるリソース（EJB-JARファイルの場合：EJB-JARファイル，Session Bean，Entity Bean，Message-driven Bean，WARファイルの場合：WARファイル，サーブレット／JSP，フィルタ）の属性，またはRARファイルの属性を取得して，属性ファイルを生成します。

J2EEアプリケーションとリソースの設定で使用する属性ファイルについては，次の個所を参照してください。

マニュアル「アプリケーションサーバリファレンス定義編(アプリケーション／リソース定義)」の「3.　J2EEアプリケーションの設定で使用する属性ファイル」
マニュアル「アプリケーションサーバリファレンス定義編(アプリケーション／リソース定義)」の「4.　リソースの設定で使用する属性ファイル」

展開ディレクトリ形式の場合，コマンド実行ホストと同じホストで稼働しているJ2EEサーバに対して操作できます。

<サーバ名称>: 接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

 
<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1(2)　プロバイダURLについて」を参照してください。

-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 2012，Windows Server 2008，Windows 8，Windows 7またはWindows Vistaの場合）。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<J2EEアプリケーション名> -name）やオプション名と値を非対応にすること（例：-name ejb -type <J2EEアプリケーション名>）はできません。
コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
指定したパスにすでに属性ファイルが存在する場合，上書きします。