cjsetresprop（リソースの属性設定）

形式

EJB-JARファイルおよびWARファイルの場合

cjsetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type {ejb|war}
             -resname <リソース表示名>[/<下位リソース表示名>]
             -c <属性ファイルパス>

データソースファイルの場合

cjsetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type datasource -resname <データソース表示名>
             -c <属性ファイルパス>

メールの場合

cjsetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type mail -resname <メール表示名> -c <属性ファイルパス>

RARファイルの場合

cjsetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type rar -resname <リソースアダプタ表示名>
             -c <属性ファイルパス>

ページの先頭へ

機能

EJB-JARファイルに含まれるリソース（EJB-JARファイル，Session Bean，Entity Bean，Message-driven Bean），WARファイルに含まれるリソース（WARファイル，サーブレット／JSP，フィルタ），データソースファイル，メール，またはデプロイ前のRARファイルに含まれるリソースの属性を属性ファイルに指定された値に変更します。

下位リソース表示名が指定されない場合はEJB-JARファイル，WARファイルの指定となります。

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

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

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

ページの先頭へ

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-type {ejb|war|datasource|mail|rar}

設定するリソースの種別を指定します。

• ejb：EJB-JARファイルまたはEJB-JARファイル中のリソースの属性

• war：WARファイルまたはWARファイル中のリソースの属性

• datasource：データソースファイル

• mail：メール

• rar：デプロイ前のRARファイルの属性

-resname <リソース表示名，データソース表示名，メール表示名またはリソースアダプタ表示名>

設定対象リソースの表示名を指定します。

• EJB-JARファイルの場合：<EJB-JARファイルの表示名>

• EJBファイルの場合：<EJB-JARファイルの表示名>[/<Enterprise Beanの表示名>]

• WARファイルの場合：<WARファイルの表示名>

• サーブレット／JSPの場合：<WARファイルの表示名>[/<サーブレット／JSPの表示名>]

• フィルタの場合：<WARの表示名>[/<フィルタの表示名>]

• データソースファイルの場合：<データソースファイルの表示名>

• メールの場合：<メールの表示名>

• RARファイルの場合：<RARファイルの表示名>

-c <属性ファイルパス>

属性ファイルの入力元パスを指定します。

ページの先頭へ

入力例

EJB-JARファイルの場合

cjsetresprop MyServer -type ejb -resname accountJsp/MyAccount -c MyAccountProp.xml

WARファイルの場合

cjsetresprop MyServer -type war -resname account-war/Account -c AccountProp.xml

データソースファイルの場合

cjsetresprop MyServer -type datasource -resname JdbcDbpsv -c JdbcDbpsvProp.xml

メールの場合

cjsetresprop MyServer -type mail -resname Mail -c MailProp.xml

RARファイルの場合

cjsetresprop MyServer -type rar -resname account-ra -c AccountProp.xml

ページの先頭へ

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

ページの先頭へ

注意事項

• コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソース表示名> -resname）やオプション名と値を非対応にすること（例：-resname ejb -type <リソース表示名>）はできません。

• コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

• 属性ファイルに設定されたsecurity-role/link-toの値は無視されます。指定されたリソースがSession Bean，Entity Bean，またはWARファイルの場合はruntimeの値も無視されます。

• データソース表示名は，属性ファイルの<display-name>タグで指定したものに置き換わります。

• リソース表示名は，属性ファイルの<display-name>タグで指定したものに置き換わります。

• データソースの場合，指定した表示名は存在している必要があります。

• メールの場合，指定した表示名が存在しないときは新規登録として扱います。新規登録では，英数字（0〜9，A〜Z，a〜z）または次の特殊文字を使用できます。ただし，先頭または末尾に半角スペースがある名前を指定した場合，半角スペースを除去して使用されます。また，既存のものに設定する場合，メール表示名は，プロパティファイルの<display-name>タグで指定したものに置き換わります。

  スペース（ ），エクスクラメーションマーク（!），シャープ（#），ドル記号（$），パーセント（%），アンパサンド（&），バーレン（(）（)），プラス（+），ハイフン（-），ピリオド（.），セミコロン（;），レスザン（<），グレーターザン（>），単価記号（@），ブラケット（[）（]），円マーク（\），キャレット（^），アンダースコア（_），バッククォート（`），ブレイス（{）（}），ストローク（|），チルダ（~）

• DDファイル（ejb-jar.xml）の<security-role-ref>-<role-link>タグを設定している場合，EJB-JAR属性ファイルを設定すると，DDファイル（ejb-jar.xml）の<security-role-ref>-<role-link>タグの値がクリアされることがあります。

ページの先頭へ