Cosminexus V11 アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)

文法書

3021-3-J17-70

前書き

対象製品

マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」の前書きの対象製品の説明を参照してください。

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

Amazon Web Services，AWS，Powered by AWS ロゴ，Amazon Aurora，Amazon Relational Database Service (Amazon RDS)は，Amazon.com, Inc. またはその関連会社の商標です。

Microsoft，Azure，SQL Server，Windows，Windows Server は，マイクロソフト 企業グループの商標です。

Oracle(R)，Java ，MySQL及びNetSuite は，Oracle，その子会社及び関連会社の米国及びその他の国における登録商標です。

UNIXは，The Open Groupの登録商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

発行

2025年 4月 3021-3-J17-70

著作権

All Rights Reserved. Copyright (C) 2020, 2025, Hitachi, Ltd.

変更内容

変更内容(3021-3-J17-70) uCosminexus Application Server 11-60，uCosminexus Client 11-60，uCosminexus Developer 11-60，uCosminexus Service Architect 11-60，uCosminexus Service Platform 11-60

追加・変更内容

変更個所

記載内容は変更なし（リンク情報だけを変更した）。

-

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルをお読みになる際の前提情報については，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」のはじめにの説明を参照してください。

1　ファイルの概要

この章では，アプリケーションサーバで使用するファイルの種類，記述規則，文法の記述形式について説明します。

なお，このマニュアルでは，アプリケーションサーバで使用するファイルのうち，J2EEアプリケーションやリソースを設定する場合に，属性情報を設定するファイルについて説明します。

アプリケーションサーバで使用するファイルのうち，サーバに関する定義情報を記載するファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「1.　ファイルの概要」を参照してください。

1.1　ファイルの種類

J2EEアプリケーションの設定では，属性ファイルを使用します。なお，属性ファイルのファイル名は任意です。

このマニュアルでは，ファイルを次の二つに分類しています。

アプリケーションに含めて使用するファイル

サーバ管理コマンド実行時の引数に指定するファイル

それぞれの属性ファイルについて説明します。

1.1.1　アプリケーションに含めて使用するファイル

アプリケーションサーバで使用するファイルのうち，アプリケーションに含めて使用するファイルについて説明します。

ファイルの種類

アプリケーション属性ファイル（cosminexus.xml）

概要

アプリケーション，EJB-JAR，Session Bean，Entity Bean，Message-driven Bean，WAR，フィルタ，サーブレット/JSPおよびリソースアダプタのアプリケーションサーバ独自の情報を定義するファイルです。

アプリケーション属性ファイル（cosminexus.xml）の詳細については，「2.　アプリケーション属性ファイル（cosminexus.xml）」を参照してください。

1.1.2　サーバ管理コマンド実行時の引数に指定するファイル

アプリケーションサーバで使用するファイルのうち，サーバ管理コマンドを実行する場合に，引数に指定するファイルについて次の表に示します。

表1‒1　サーバ管理コマンド実行時の引数に指定するファイル

ファイルの種類

概要

参照先マニュアル

参照先

アプリケーション統合属性ファイル

アプリケーション，EJB-JAR，Session Bean，Entity Bean，Message-driven Bean，WAR，フィルタ，サーブレット/JSPおよびリソースアダプタの属性を一括して取得，編集する場合に使用するファイルです。

このマニュアル

3.1

アプリケーション属性ファイル

アプリケーションの属性を取得，編集する場合に使用するファイルです。

3.2

EJB-JAR属性ファイル

EJB-JARの属性を取得，編集する場合に使用するファイルです。

3.3

Session Bean属性ファイル

Session Beanの属性を取得，編集する場合に使用するファイルです。

3.4

Entity Bean属性ファイル

Entity Beanの属性を取得，編集する場合に使用するファイルです。

3.5

MessageDrivenBean属性ファイル

MessageDrivenBeanの属性を取得，編集する場合に使用するファイルです。

3.6

WAR属性ファイル

WARの属性を取得，編集する場合に使用するファイルです。

3.7

フィルタ属性ファイル

フィルタの属性を取得，編集する場合に使用するファイルです。

3.8

サーブレット属性ファイル

サーブレット/JSPの属性を取得，編集する場合に使用するファイルです。

3.9

Connector属性ファイル

リソースアダプタの属性を取得，編集する場合に使用するファイルです。

4.1

JavaBeansリソース属性ファイル

JavaBeansの属性を取得，編集する場合に使用するファイルです。

4.2

メール属性ファイル

メールコンフィグレーションの属性を取得，編集する場合に使用するファイルです。

このマニュアル

4.3

注1　「参照先マニュアル」に示したマニュアル名の「アプリケーションサーバ」は省略しています。

注2　バッチアプリケーションを実行するシステムの場合，使用できるのはこの表で示した属性ファイルのうちConnector属性ファイルだけです。

1.2　属性ファイルに対応するDTDファイルの格納先

属性ファイルに対応するDTDファイルの格納先について説明します。属性ファイルに対応するDTDファイルの格納先をOSごと（WindowsおよびUNIX）に分けて表に示します。

表1‒2　属性ファイルに対応するDTDファイルの格納先（Windowsの場合）

属性ファイル

DTDファイルの格納先

cosminexus.xml（アプリケーション属性ファイル）

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥cosminexus_9_5.dtd

アプリケーション統合属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-application-all-property_9_0.dtd

アプリケーション属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-application-property_8_0.dtd

EJB-JAR属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-ejb-jar-property_9_0.dtd

Session Bean属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-session-bean-property_9_0.dtd

Entity Bean属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-entity-bean-property_7_6.dtd

MessageDrivenBean属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-message-bean-property_7_6.dtd

WAR属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-war-property_9_0.dtd

フィルタ属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-filter-property_7_0.dtd

サーブレット属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-servlet-property_7_0.dtd

Connector属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-connector-property_7_6.dtd

JavaBeansリソース属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-javabeans-resource-property_7_0.dtd

メール属性ファイル

<Application Serverのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-mail-property_7_1.dtd

表1‒3　属性ファイルに対応するDTDファイルの格納先（UNIXの場合）

属性ファイル

DTDファイルの格納先

cosminexus.xml（アプリケーション属性ファイル）

/opt/Cosminexus/CC/admin/dtds/cosminexus9_5.dtd

アプリケーション統合属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-application-all-property_9_0.dtd

アプリケーション属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-application-property_8_0.dtd

EJB-JAR属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-ejb-jar-property_9_0.dtd

Session Bean属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-session-bean-property_9_0.dtd

Entity Bean属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-entity-bean-property_7_6.dtd

MessageDrivenBean属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-message-bean-property_7_6.dtd

WAR属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-war-property_9_0.dtd

フィルタ属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-filter-property_7_0.dtd

サーブレット属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-servlet-property_7_0.dtd

Connector属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-connector-property_7_6.dtd

JavaBeansリソース属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-javabeans-resource-property_7_0.dtd

メール属性ファイル

/opt/Cosminexus/CC/admin/dtds/hitachi-mail-property_7_1.dtd

DTDファイルを使用するときの注意事項を次に示します。

DTDファイルの内容は変更しないでください。

DTDファイルをコピーして使用しないでください。

サーバ管理コマンドを実行したマシン以外の環境で属性ファイルをXMLエディタなどで使用する場合，使用する環境に合わせて属性ファイルのURI指定を書き直してください。

1.3　ファイルの説明の記述形式

ファイルの説明の記述形式ついて説明します。また，文法で使用する記号についても説明します。

1.3.1　記述形式

2章以降，ファイルの説明を次の形式で記述します。

指定内容

属性ファイルの構成を示します。

各属性の詳細

属性ファイルに定義するタグの詳細について説明します。

テンプレートファイル

属性ファイルのテンプレートファイルを示します。

DDとの対応

属性ファイルとDDとの対応を示します。

cosminexus.xmlとの対応

DDとcosminexus.xmlとの対応を示します。次のような場合に，参考情報として参照してください。

既存の属性ファイルからcosminexus.xmlに変更する場合

cosminexus.xmlで設定した内容をサーバ管理コマンドで属性ファイルとして取得する場合

参考

すべてのファイルで上記の項目をすべて説明しているわけではありません。また，上記以外に，各ファイルの固有情報を記載している場合があります。

1.3.2　文法で使用する記号

文法は次の表に示す記号および構文要素を使用して記述します。

表1‒4　文法で使用している記号

記号

意　味

　｜

横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。

（例）　A｜B

　AまたはBを指定することを示します。

［　］

この記号で囲まれている項目は省略してもよいことを示します。複数の項目が横に並べて記述されている場合には，すべてを省略するか，記号｛ ｝と同じくどれか一つを選択します。

（例1）　［A］

　「何も指定しない」か「Aを指定する」ことを示します。

（例2）　［B｜C］

　「何も指定しない」か「BまたはCを指定する」ことを示します。

{ 　 }

この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。

（例）　｛A｜B｜C｝

　A，BまたはCのどれかを指定することを示します。

…

記述が省略されていることを示します。

（例）　ABC…

　ABCの後ろに記述があり，その記述が省略されていることを示します。

<　>

この記号で囲まれている項目は，該当する要素やファイルなどを指定したり，該当する要素が表示されたりすることを示します。

（例1）　<プロパティ>

　プロパティを記述します。またはプロパティが表示されます。

（例2）　<ファイル名>

　ファイル名を指定します。

...

この記号の直前に示す記号を繰り返し，複数個指定できることを示します。

（例）　<プロパティ>...

　プロパティは複数個，繰り返して指定できます。

表1‒5　文法で使用している構文要素

構文要素

定義

英字

A〜Z　a〜z

英小文字

a〜z

英大文字

A〜Z

数字

0〜9

英数字

A〜Z　a〜z　0〜9

記号

!　"　#　$　%　&　'　(　)　+　,　_　・　.　/　:　;　<　=　>　@　[　]　^　−　｛　｝　￣　タブ　空白

注　すべて半角文字を使用してください。

1.4　ファイル編集時の注意事項

Windowsでファイルを編集する場合の注意事項を次に示します。なお，システムドライブをCドライブとして説明します。

定義ファイルを更新する場合

アプリケーションサーバが提供する定義ファイルは，管理者特権で更新する必要があります。管理者特権のないユーザが定義ファイルを更新しても，C:¥Program Files以下のディレクトリにある定義ファイルは更新されません。管理者特権のないユーザが更新したファイルは，次に示すディレクトリ以下に保存されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

なお，アプリケーションサーバは管理者特権で起動されるため，管理者特権のないユーザが更新した定義ファイルの内容は無視されます。

Unicodeの補助文字を使用する場合

アプリケーションサーバで使用する定義ファイルに，Unicodeの補助文字は使用できません。

Unicodeの補助文字を使用できない定義の例を示します。

EAR，WAR，JAR，EJB-JAR，サーブレット，JSP，クラス，メソッド，引数，および変数の名称

DD内の各種定義

そのほか，各種定義ファイルの設定値

また，実行時の文字エンコーディングに変換できない文字をログファイルへ出力した場合，正しく出力されません。

2　アプリケーション属性ファイル（cosminexus.xml）

この章では，アプリケーション属性ファイル（cosminexus.xml）について説明します。

アプリケーション属性ファイル（cosminexus.xml）は，EJB-JAR，Session Bean，Entity Bean，Message-driven Bean，WAR，フィルタ，サーブレット/JSPおよびリソースアダプタに関する，アプリケーションサーバ独自の定義情報を設定するためのファイルです。

2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容

アプリケーション属性ファイル（cosminexus.xml）は，アプリケーションサーバ独自の情報を取得，編集する場合に使用するファイルです。アプリケーション属性ファイル（cosminexus.xml）には，設定値を変更した個所だけが記載されます。サーバ管理コマンドなどでデフォルト値を設定した場合，該当するタグがこのファイルから削除されます。

アプリケーション属性ファイル（cosminexus.xml）で定義する属性を次に示します。

アプリケーションの属性

EJB-JARの属性

Session Beanの属性

Entity Beanの属性

Message-driven Beanの属性

WARの属性

フィルタの属性

サーブレット/JSPの属性

リソースアダプタの属性

アプリケーション属性ファイル（cosminexus.xml）の形式および格納先を記します。

形式

xml形式です。

格納先

<EARのルート>/META-INF/cosminexus.xml

アプリケーション属性ファイル（cosminexus.xml）の表中で定義する項目について説明します。

項目名

説明

タグ名

設定するタグを表します。

出現パターン

タグが出現する回数を示します。

内容

タグに定義する内容を示します。

指定可能値

タグに指定できる値を示します。

デフォルト

タグ，またはタグに指定する内容が省略されている場合に有効になる指定値を示します。デフォルト値がない場合は"なし"を記述します。

特定キー

DDおよびモジュールを特定するためのキーであるかどうかを示します。凡例を次に示します。

D：DDの要素を特定するキーです。

K：モジュールを特定するためのキーです。

−：特定するキーではありません。

各タグの詳細，およびキーの省略，値の省略，ほかのタグとの依存関係については，「2.2　アプリケーション属性ファイル（cosminexus.xml）で指定する各属性の詳細」を参照してください。

アプリケーション属性ファイル（cosminexus.xml）は次に示すDOCTYPE宣言を持ちます。なお，DOCTYPE宣言を編集する必要はありません。

<!DOCTYPE cosminexus-app PUBLIC '-//Hitachi, Ltd.//DTD Cosminexus 9.5//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/cosminexus_9_5.dtd'>

cosminexus.xmlの構成および指定内容について説明します。

タグ名の欄にあるマニュアルの参照先には，そのタグの関連情報があります。マニュアル名に「アプリケーションサーバ」と記載されたマニュアルについては，名称を省略しています。

タグ名

出現パターン

内容

指定可能値

デフォルト

特定キー

<cosminexus-app>

0または1回

ルートタグ。

−

なし

−

┣

┃

┃

<security-prop>

0または1回

cosminexus-appのセキュリティの管理方法を指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃┃

┃

┃

┃┃

┃

┃

┃

<security-method>

1回

セキュリティ設定を有効にするかどうかを指定します。

指定できる文字列を次に示します。

disable_methods_without_roles

map_methods_without_roles

no_security_for_methods_without_roles

no_security_for_all_methods

no_security_for_methods_without_roles

−

┃

┃

┃

┃

┗

<default-security-role>

0または1回

<security-method>にmap_methods_without_rolesを指定した場合のデフォルトセキュリティロールを指定します。

入力は制限されません。

なし

−

┣

┃

┃

┃

┃

┃

<start-order>

0または1回

J2EEアプリケーションの開始および停止の順番を指定します。

開始した場合は昇順で開始処理が実行され，終了した場合は降順に停止処理が実行されます。

0〜2147483647の整数値を指定します。

10

−

┣

┃

┃

┃

<scheduling-unit>

「機能解説 拡張編」−「3.2.5」

0または1回

キューの配置モデルを指定します。

指定できる文字列を次に示します。

Application

Bean

Application

−

┣

┃

┃

<scheduling>

「機能解説 拡張編」−「3.4」

0または1回

CTM連携関連の情報を設定します。

−

なし

−

┃

┃

┃

┃

┣

┃

┃

┃

<queue-name>

「機能解説 拡張編」−「3.2.5」

0または1回

スケジューリングを行うキュー名を指定します。

英数字，およびアンダースコア「_」を指定できます。

指定できる文字数は1〜63文字です。

アプリケーション名※

−

┃

┃

┃

┣

┃

┃

<parallel-count>

「機能解説 拡張編」−「3.4」

0または1回

CTMスケジューラがアプリケーションを呼ぶために用意するスレッド数を指定します。

1〜127の整数値を指定します。

1

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<queue-length>

「機能解説 拡張編」−「3.4」

0または1回

キューの長さを指定します。

1〜32767の整数値を指定します。

CTMデーモンで保持しているCTMキューの生成時の長さ（-CTMMaxRequestCountオプションで指定した長さ）

−

┣

┃

┃

┃

<managed-by-ctm>

「機能解説 拡張編」−「3.4」

0または1回

CTM連携をするかどうかを指定します。

指定できる文字列を次に示します。

true

false

false

−

┣

┃

┃

<ref-libraries>

0または1回

参照するライブラリJARを指定します。

−

なし

−

┃

┃

┗

<classpath>

1回以上

参照ライブラリのクラスパスを指定します。

入力は制限されません。

なし

−

┣

┃

┃

<method-observation-recovery-mode>

0または1回

メソッド時間監視機能の障害回復モードを指定します。

指定できる文字列を次に示します。

thread

なし

−

┣

┃

┃

<ejb-async-props>

0または1回

非同期Session Bean呼び出し用の情報を設定します。

−

なし

−

┃

┃

┣

┃

<min-thread-pool-size>

0または1回

スレッドプールで同時に実行される最小スレッド数を指定します。

1〜2147483647の整数値を指定します。

16

−

┃

┃

┣

┃

<max-thread-pool-size>

0または1回

スレッドプールで同時に実行される最大スレッド数を指定します。

1〜2147483647の整数値を指定します。

32

−

┃

┃

┃

┣

┃

┃

<thread-pool-keep-alive>

0または1回

スレッドプールのスレッド解放までのタイムアウト値（単位：秒）を指定します。

1〜2147483647の整数値を指定します。

60

−

┃

┃

┃

┃

┃

┃

┗

<result-timeout-value>

0または1回

非同期呼び出しの結果を保持する時間（単位：分）を指定します。

0を指定した場合，非同期呼び出しの結果を解放しないで，アプリケーションが終了するまで保持します。

0〜2147483647の整数値を指定します。

30

−

┣

┃

<ejb-jar>

0回以上

EJB-JARについて定義します。

−

なし

−

┃

┃

┣

┃

<module-name>

1回

EJB-JARを特定できるモジュール名を指定します。

入力は制限されません。

なし

K

┃

┃

┣

┃

<security-role>

0回以上

セキュリティロールについて定義します。

−

なし

−

┃

┃

┃

┃

┣

┃

<role-name>

1回

ロール名。

入力は制限されません。

なし

D

┃

┃

┃

┃

┗

<linked-to>

1回

cjaddsecコマンドで定義したロール名を指定します。

−

リンク解決はされません。

−

┃

┃

┣

┃

<session>

0回以上

SessionBeanについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<ejb-name>

1回

ejbの名称を指定します。

なお，このキーはSessionBeanを特定するためのキーとなります。

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<session>-<ejb-name>の設定値を指定します。

ejb-jar.xmlを含まないアプリケーションの場合，@Stateless，@Stateful，または@Singletonのnameの設定値を指定します。

nameが指定されていない場合は，EJB実装クラス名のパッケージ名を取り除いたクラス名を指定します。

−

なし

D

┃

┃

┃

┃

┃

┃

┣

┃

┃

<security-identity>

0または1回

SessionBeanのセキュリティアイデンティティを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┗

<run-as>

1回

実行時アイデンティティを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┗

<user-name>

1回

ユーザ名を指定します。

−

なし

−

┃

┃

┃

┃

┣

┃

<resource-ref>

0回以上

SessionBeanから参照するリソースを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<res-ref-name>

1回

リソース参照の名称を指定します。

−

なし

D

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

対応するリソースアダプタ表示名，メール表示名を指定します。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

入力は制限されません。

リンク解決はされません。

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<resource-env-ref>

0回以上

SessionBeanから参照するリソース環境変数を定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<resource-env-ref-name>

1回

リソース環境変数参照の名称を指定します。

−

なし

D

┃

┃

┃

┃

┃

┃

┣

┃

<linked-queue>

1回

キュー名称を指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┗

<queue>

1回

キュー名称を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<linked-adminobject>

1回

管理対象オブジェクトを指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

JavaBeansリソースの表示名を指定します。

DD要素<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

−

リンク解決はされません。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<lookup-name>

0または1回

クライアントからEJBをルックアップする時に使う名前を指定します。HITACHI_EJB/SERVERS/<サーバ名>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。

このタグを省略した場合，デフォルト値としてリソース名が使用されますが，デフォルト値に含まれる英数字とアンダースコア（_）以外の文字はすべてアンダースコアに変換されます。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

リソース名

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<optional-name>

0または1回

リモートインタフェースの別名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次の名前は指定できません。

予約語のHITACHI_EJB（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

別名は付きません。

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<local-optional-name>

0または1回

ローカルインタフェースの別名を指定します。

指定できる文字に制限はありません。

指定できる文字数は1〜255文字です。

別名は付きません。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<maximum-sessions>

0または1回

セッションの最大数またはBeanインスタンスの最大数を指定します。

Stateless Session Beanの場合，この設定値は無効になります。

0（無制限）または1≦maximum-sessions≦2147483647の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<stateless>

0または1回

Session Beanの種別がStatelessの場合に指定します。

<stateless>または<stateful>のどちらかを指定するか，またはどちらも指定しません。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<pooled-instance>

0または1回

プール内のインスタンスを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<minimum>

「機能解説 基本・開発編(EJBコンテナ)」−「2.9.1」

0または1回

プール内のインスタンスの最小数を指定します。

ただし，プーリングの動作は最大数を指定することでカスタマイズできるため，このタグの設定値は無視されます。

0または1≦minimum≦maximumの整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<maximum>

「機能解説 基本・開発編(EJBコンテナ)」−「2.9.1」

0または1回

プール内のインスタンスの最大数を指定します。

0（無制限）または1≦maximum≦2147483647の整数値。

また，<enable-scheduling>の値がtrueかつアプリケーション属性<managed-by-ctm>の値がtrueの場合は，指定可能範囲が異なります。

アプリケーション属性<scheduling-unit>の指定値がBeanの場合：

0または<scheduling>-<parallel-count>以上の整数値。

アプリケーション属性の<scheduling-unit>の指定値がApplicationの場合：

0またはアプリケーション属性<scheduling>-<parallel-count>以上の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<instance-timeout>

0または1回

インスタンス取得タイムアウト時間（秒）を指定します。

0を指定するとタイムアウトしません。

0〜86400の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<stateful>

0または1回

Session Beanの種別がStatefulの場合に指定します。

<stateless>および<stateful>のどちらか一つを指定するか，もしくはどちらも指定しません。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<maximum-active-sessions>

0または1回

アクティブセッションの最大数を指定します。

maximum-sessionsが0（無制限）の場合，0（無制限）≦maximum-active-sessions≦2147483647の整数値。

maximum-sessionsが0（無制限）以外の場合，1≦maximum-active-sessions≦maximum-sessionsの整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<inactivity-timeout>

0または1回

再びアクティブ化するまでに非アクティブ状態に保持しておく時間（分）を指定します。

0（無制限）または1≦inactivity-timeout≦2147483647の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<removal-timeout>

0または1回

セッションが削除されるまでに非アクティブ状態に保持しておく時間（分）を指定します。

0（無制限）または1≦removal-timeout≦2147483647の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<enable-scheduling>

「機能解説 拡張編」−「3.4」

0または1回

該当するBeanをスケジューラのGateとして使用するかどうかを指定します。

指定できる文字列を次に示します。

true

false

false

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<pass-by-reference>

0または1回

pass-by-referenceでのEJB呼び出しを行うかどうかを指定します。

指定できる文字列を次に示します。

true

false

false

−

┃

┃

┃

┃

┣

┃

<scheduling>

「機能解説 拡張編」−「3.4」

0または1回

CTM連携関連の情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<queue-name>

「機能解説 拡張編」−「3.2.5」

0または1回

スケジューリングを行うキュー名を指定します。

英数字，アンダースコア「_」を使用できます。

指定できる文字数は1〜63文字です。

ejb名

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<parallel-count>

「機能解説 拡張編」−「3.4」

0または1回

CTMスケジューラがアプリケーションを呼ぶために用意するスレッド数を指定します。

1〜127の整数値。

1

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<queue-length>

「機能解説 拡張編」−「3.4」

0または1回

キューの長さを指定します。

1〜32767の整数値。

CTMデーモンで保持しているCTMキューの生成時の長さ（-CTMMaxRequestCountオプションで指定した長さ）

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<front-ejb>

0または1回

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。

指定できる文字列を次に示します。

true

false

false

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<start-order>

0または1回

J2EEアプリケーション開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0〜2147483647の整数値。

10

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<ejb-method-observation-timeout>

「機能解説 運用／監視／連携編」−「5章」

0回以上

EJBメソッドに仕掛中メソッド監視用タイムアウト時間を設定する場合に指定します。<ejb-method-observation-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-method-observation-timeout>の<method-observation-timeout>の値が有効となります。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<method>

1回以上

メソッドについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

Home，Remote，LocalHome，Localのすべて。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<method-name>

1回

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合，すべてのメソッドを意味します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定します。

空白区切り文字，行区切り文字，および段落区切り文字以外を指定します。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-observation-timeout>

1回

仕掛中メソッド監視用タイムアウト時間（秒）を指定します。

0を指定した場合，タイムアウトしません。

0〜86400の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<ejb-transaction-timeout>

「機能解説 基本・開発編(コンテナ共通機能)」−「3.15.8」

0回以上

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効となります。

−

なし

−

┃

┃

┃

┃

┣

┃

<method>

1回以上

メソッドについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

Home，Remote，LocalHome，Localのすべて。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<method-name>

1回

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<transaction-timeout>

1回

トランザクションタイムアウト時間（秒）を指定します。

0（ゼロ）を指定した場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

0〜2147483647の整数値。

0

−

┃

┃

┣

┃

<entity>

0回以上

EntityBeanについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<ejb-name>

1回

ejbの名称を指定します。

なお，このキーはEntityBeanを特定するためのキーとなります。

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<entity>-<ejb-name>の設定値を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┣

┃

┃

<security-identity>

0または1回

EntityBeanのセキュリティアイデンティティを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┗

<run-as>

1回

実行時アイデンティティを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┗

<user-name>

1回

ユーザ名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┣

┃

<resource-ref>

0回以上

EntityBeanから参照するリソースを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<res-ref-name>

1回

リソース参照の名称を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

対応するリソースアダプタ表示名，メール表示名を指定します。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

入力は制限されません。

リンク解決はされないままです。

−

┃

┃

┃

┃

┣

┃

<resource-env-ref>

0回以上

EntityBeanから参照するリソース環境変数を定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<resource-env-ref-name>

1回

resource-env-refの名称を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<linked-queue>

1回

キュー名称を指定します。DD要素<resource-env-ref-type>に「javax.jms.Queue」が指定された場合だけ有効です。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┗

<queue>

1回

キュー名称を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<linked-adminobject>

1回

管理対象オブジェクトを指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

JavaBeansリソースの表示名を指定します。

DDの要素<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

入力は制限されません。

リンク解決はされません。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<lookup-name>

0または1回

クライアントからEJBをルックアップする時に使う名前を指定します。HITACHI_EJB/SERVERS/<サーバ名>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。

このタグを省略した場合，デフォルト値としてリソース名が使用されますが，デフォルト値に含まれる英数字とアンダースコア（_）以外の文字はすべてアンダースコアに変換されます。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

リソース名

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<optional-name>

0または1回

リモートインタフェースの別名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次の名前は指定できません。

予約語のHITACHI_EJB（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

別名は付きません。

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<local-optional-name>

0または1回

ローカルインタフェースの別名を指定します。

指定できる文字に制限はありません。

指定できる文字数は1〜255文字です。

別名は付きません。

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<maximum-instances>

0または1回

Enterprise Beanインスタンスの最大数を指定します。

0（無制限）または1≦maximum-instances≦2147483647の整数値。

0

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<pooled-instance>

0または1回

インスタンスプールのプロパティを指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<minimum>

0または1回

プール内のインスタンスの最小数を指定します。

0（無制限）または1≦minimum≦maximum。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<maximum>

0または1回

プール内のインスタンスの最大数を指定します。

【maximum-instancesが0（無制限）の場合】

0（無制限）≦maximum≦2147483647の整数値。

【maximum-instancesが0（無制限）以外の場合】

1≦maximum≦maximum-instancesの整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<caching-model>

0または1回

キャッシングモデルを指定します。

指定できる文字列を次に示します。

full-caching

caching

no-caching

caching

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<entity-timeout>

0または1回

EJBオブジェクトの存在時間（秒）を指定します。

0を指定した場合はタイムアウトしません。

0〜2147483647の整数値。

0

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<pass-by-reference>

0または1回

pass-by-referenceでのEJB呼び出しをするかどうかを指定します。

指定できる文字列を次に示します。

true

false

false

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<instance-timeout>

0または1回

インスタンス取得タイムアウト時間（秒）を指定します。0を指定した場合はタイムアウトしません。

0〜86400の整数値。

0

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<front-ejb>

0または1回

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。

指定できる文字列を次に示します。

true

false

false

−

┃

┃

┃

┃

┣

┃

<cmp-map>

0または1回

Entity Beanのフィールドをデータベース上にマッピングします。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<datasource-name>

1回

Enterprise Beanフィールドのマッピング先として開始されたリソースアダプタの表示名を指定します。

入力は制限されません。

リンク解決はされません。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<catalog-name>

0または1回

Enterprise Beanフィールドのマッピング先としてデータベースのカタログ名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<schema-name>

0または1回

Enterprise Beanフィールドのマッピング先としてデータベースのスキーマ名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<table-name>

1回

Enterprise Beanフィールドのマッピング先としてデータベースのテーブル名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<read-only-access>

1回

アプリケーションからデータベースへの書き込みを許可するかどうかを指定します。ただし，アプリケーションサーバでは指定しても無効になります。

指定できる文字列を次に示します。

true

false

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<transaction-isolation>

0または1回

トランザクション遮断レベルを指定します。

省略した場合，デフォルトのトランザクション遮断レベルが使われます（使用するデータベースおよびJDBCドライバによって異なります）。

指定できる文字列を次に示します。

none

read_committed

read_uncommitted

repeatable_read

serializable

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<concurrency-protection>

0または1回

データベースに書き込むデータとレコードとの照合方法を指定します。

指定できる文字列を次に示します。

primary-key

primary-key

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<field-impl>

0回以上

Entity Beanのフィールドとテーブルのカラムとのマッピングを指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<field-name>

1回

Entity Beanのフィールド名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┗

<column-name>

1回

テーブルのカラム名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┗

<finder-impl>

0回以上

ejbFindByPrimaryKey以外のFinderメソッドの検索条件を指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<method-name>

1回

Finderメソッドのメソッド名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┗

<where-clause>

1回

テーブルの検索条件を指定します。

指定できる値はシャープ「#」以外です。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<start-order>

0または1回

J2EEアプリケーションの開始および停止の順番を指定します。

開始した場合は昇順で開始処理が実行され，終了した場合は降順に停止処理が実行されます。

0〜2147483647の整数値。

10

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<ejb-method-observation-timeout>

「機能解説 運用／監視／連携編」−「5章」

0回以上

EJBメソッドに仕掛中メソッド監視用タイムアウト時間を設定する場合に指定します。<ejb-method-observation-timeout>の指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-method-observation-timeout>の<method-observation-timeout>の値が有効となります。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<method>

1回以上

メソッドについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

Home，Remote，LocalHome，Localのすべて。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<method-name>

1回

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合に，メソッドを特定するために指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-observation-timeout>

1回

仕掛中メソッド監視用タイムアウト時間（秒）を指定します。0を指定した場合，タイムアウトしません。

0〜86400の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<ejb-transaction-timeout>

「機能解説 基本・開発編(コンテナ共通機能)」−「3.15.8」

0回以上

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効となります。

−

なし

−

┃

┃

┃

┃

┣

┃

<method>

1回以上

メソッドについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

Home，Remote，LocalHome，Localのすべて。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<method-name>

1回

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<transaction-timeout>

1回

トランザクションタイムアウト時間（秒）を指定します。

0（ゼロ）を指定した場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

0〜2147483647の整数値。

0

−

┃

┃

┗

<message>

0回以上

Message-driven Beanについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<ejb-name>

1回

ejbの名称を指定します。

なお，このキーはMessage-driven Beanを特定するためのキーとなります。

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<message-driven>-<ejb-name>の設定値を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┣

┃

┃

<security-identity>

0または1回

Message-driven Beanのセキュリティアイデンティティを定義します。

−

なし

−

┃

┃

┃

┃

┗

<run-as>

1回

実行時アイデンティティを定義します。

−

なし

−

┃

┃

┃

┃

┗

<user-name>

1回

ユーザ名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┣

┃

┃

<message-ref>

0または1回

リソースアダプタを指定します。

−

なし

−

┃

┃

┃

┃

┣

┃

<connection-factory>

0または1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┗

<connection-destination>

1回

リソースアダプタについて定義します。

−

なし

−

┃

┃

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┗

<queue>

0または1回

キュー名称を指定します。

入力は制限されません。

なし

−

┃

┃

┣

┃

<resource-ref>

0回以上

Message-driven Beanから参照するリソースを定義します。

−

なし

−

┃

┃

┃

┃

┣

┃

<res-ref-name>

1回

リソース参照の名称を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

対応するリソースアダプタ表示名，メール表示名を指定します。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

入力は制限されません。

リンク解決はされません。

−

┃

┃

┣

┃

<resource-env-ref>

0回以上

Message-driven Beanから参照するリソース環境変数を定義します。

−

なし

−

┃

┃

┃

┃

┣

┃

<resource-env-ref-name>

1回

resource-env-refの名称を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<linked-queue>

1回

キュー名称を指定します。DDの要素<resource-env-ref-type>に「javax.jms.Queue」が指定された場合だけ有効です。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┗

<queue>

1回

キュー名称を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┣

┃

<linked-adminobject>

1回

管理対象オブジェクトを指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

JavaBeansリソースの表示名を指定します。

DD要素<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

入力は制限されません。

リンク解決はされないままです。

−

┃

┃

┣

┃

<pooled-instance>

0または1回

プール内のインスタンスを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<minimum>

「機能解説 基本・開発編(EJBコンテナ)」−「2.9.3」

0または1回

プール内のインスタンスの最小数を指定します。

入力は制限されません。

1

−

┃

┃

┃

┃

┃

┃

┗

<maximum>

「機能解説 基本・開発編(EJBコンテナ)」−「2.9.3」

0または1回

プール内のインスタンスの最大数を指定します。

1〜2147483647の整数値。

0が指定された場合は1とみなされます。

1

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<front-ejb>

0または1回

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。

指定できる文字列を次に示します。

true

false

false

−

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<start-order>

0または1回

J2EEアプリケーション開始時・停止時の順番を指定します。

開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0〜2147483647の整数値。

10

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<ejb-method-observation-timeout>

「機能解説 運用／監視／連携編」−「5章」

0回以上

EJBメソッドに仕掛中メソッド監視用タイムアウト時間を設定する場合に指定します。<ejb-method-observation-timeout>の指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-method-observation-timeout>の<method-observation-timeout>の値が有効となります。

−

なし

−

┃

┃

┃

┃

┣

┃

<method>

1回以上

メソッドについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

Message-driven Bean属性の設定では，このタグに値を指定できません。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<method-name>

1回

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┗

<method-observation-timeout>

1回

仕掛中メソッド監視用タイムアウト時間（秒）を指定します。0を指定した場合，タイムアウトしません。

0〜86400の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<ejb-transaction-timeout>

「機能解説 基本・開発編(コンテナ共通機能)」−「3.15.8」

0回以上

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効となります。

−

なし

−

┃

┃

┣

┃

<method>

1回以上

メソッドについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

Message-driven Bean属性の設定では，このタグに値を指定できません。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<method-name>

1回

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合，すべてのメソッドを意味します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

−

なし

−

┃

┃

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┗

<transaction-timeout>

1回

トランザクションタイムアウト時間（秒）を指定します。

0（ゼロ）を指定した場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

0〜2147483647の整数値。

0

−

┣

┃

<war>

0回以上

WARについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<module-name>

0または1回

WARを特定するためのキーとなります。ただし，WARアプリケーションの場合，cosminexus.xmlに対しWar属性は必ず一つになるため，このタグの指定は不要です。指定しても無視されます。

次の条件に従い設定値を指定します。

application.xmlを含むアプリケーションの場合

アーカイブ形式・展開ディレクトリ形式共通

application.xmlの<application>-<module>-<web>-<web-uri>に指定した文字列を指定します。

application.xmlを含まないアプリケーションの場合

アーカイブ形式（cjimportappコマンド（-f/-d））

J2EEアプリケーション中のWARファイルの場所をEARのルートからの相対パスで指定します。

展開ディレクトリ形式（cjimportappコマンド（-a））

WARディレクトリの，アプリケーションディレクトリからの相対パスの末尾の"_war"を".war"に置き換えた値を指定します。

入力は制限されません。

なし

K

┃

┃

┣

┃

<security-role>

0回以上

セキュリティロールを定義します。

−

なし

−

┃

┃

┃

┃

┣

┃

<role-name>

1回

セキュリティロール名を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

アクセスコントロールリスト（cjaddsecコマンドで定義したロール名）を指定します。

入力は制限されません。

なし

−

┃

┃

┣

┃

<resource-ref>

0回以上

Servletから参照するリソースを定義します。

−

なし

−

┃

┃

┃

┃

┣

┃

<res-ref-name>

1回

リソース参照の名称を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

対応するリソースアダプタ表示名，メール表示名を指定します。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

入力は制限されません。

なし

−

┃

┃

┣

┃

<resource-env-ref>

0回以上

Servletから参照するリソース環境変数を定義します。

−

なし

−

┃

┃

┃

┃

┣

┃

<resource-env-ref-name>

1回

リソース環境変数参照の名称を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<linked-queue>

1回

キュー名称を指定します。DDの要素<resource-env-ref-type>に「javax.jms.Queue」が指定された場合だけ有効です。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┗

<queue>

1回

キュー名称を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┣

┃

<linked-adminobject>

1回

管理対象オブジェクトを指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

1回

JavaBeansリソースの表示名を指定します。

DDの要素<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

入力は制限されません。

リンク解決はされないままです。

−

┃

┃

┃

┃

┣

┃

┃

┃

<thread-control>

「機能解説 基本・開発編(Webコンテナ)」−「2.15」

0または1回

Webアプリケーションのスレッド制御の設定をします。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<thread-control-max-threads>

1回

Webアプリケーション単位の最大同時実行スレッド数を指定します。

占有スレッド数以上の値を指定します。

1〜1024の整数値。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<thread-control-exclusive-threads>

1回

占有スレッド数を指定します。

Webアプリケーション単位の最大同時実行スレッド数以下を指定します。

0〜1024の整数値。

0

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<thread-control-queue-size>

1回

Webアプリケーション単位の実行待ち行列数を指定します。

0〜2147483647の整数値。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<thread-control-stats-monitor>

「機能解説 運用／監視／連携編」−「3.4」

1回

稼働統計の監視の設定をします。このタグ，<enabled>タグ，<high-threshold>タグ，または<low-threshold>タグを省略した場合，デフォルト値が有効になるため，しきい値イベントは有効となります。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<whole-waiting-request-count>

1回

Webアプリケーション単位の全体実行待ちリクエスト数を監視します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃┃

<enabled>

1回

Webアプリケーション単位の全体実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃┃

<high-threshold>

1回

しきい値イベントを出力する上限のしきい値（単位：%）を指定します。

1〜100の整数値。ただし，<low-threshold>タグの指定値以上の値である必要があります。

80

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<low-threshold>

1回

しきい値イベントを出力する下限しきい値（単位：%）を指定します。

0〜99の整数値。ただし，<high-threshold>タグの指定値以下の値である必要があります。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<waiting-request-count>

1回

Webアプリケーション単位の実行待ちリクエスト数を監視します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃┃

<enabled>

1回

Webアプリケーション単位の実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃┃

<high-threshold>

1回

しきい値イベントを出力する上限のしきい値（単位：%）を指定します。

1〜100の整数値。ただし，<low-threshold>タグの指定値以上の値である必要があります。

80

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<low-threshold>

1回

しきい値イベントを出力する下限しきい値（単位：%）を指定します。

0〜99の整数値。ただし，<high-threshold>タグの指定値以下の値である必要があります。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<resource-watcher>

0または1回

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視に関するプロパティを指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-threshold>

0または1回

アラートメッセージを出力するしきい値を指定します。

1〜100の整数値。

80

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-interval>

0または1回

監視間隔を指定します。

1〜2147483647の整数値。

30

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<watcher-enabled>

0または1回

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視を有効にするかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

0または1回

リソース使用状況をファイルに出力するかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┃

┃

┗

<urlgroup-thread-control>

「機能解説 基本・開発編(Webコンテナ)」−「2.16」

0回以上

URLグループ単位の同時実行スレッド数制御の設定をします。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<urlgroup-thread-control-name>

1回

URLグループ単位の同時実行スレッド数制御の定義名を指定します。

URLグループ単位の同時実行スレッド数制御の定義名はWebアプリケーション内で，一意な名称を指定します。

英数字，ハイフン「-」，アンダースコア「_」を使用できます。

文字の長さは1〜64で指定します。

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<urlgroup-thread-control-max-threads>

1回

URLグループ単位の最大同時実行スレッド数を指定します。

1〜thread-control-max-threadsの整数値。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<urlgroup-thread-control-exclusive-threads>

0または1回

URLグループ単位の占有スレッド数を指定します。

0〜urlgroup-thread-control-max-threadsかつthread-control-exclusive-threads以下の整数値。

0

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<urlgroup-thread-control-queue-size>

0または1回

URLグループ単位の実行待ちキューのサイズを指定します。

0〜2147483647の整数値。

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<urlgroup-thread-control-mapping>

0回以上

制御対象となるURLのマッピング情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<url-pattern>

1回

制御対象となるURLパターンを指定します。

一つのWebアプリケーション内で同じURLパターンを指定することはできません。

指定例を次に示します。

/soda/grape/*

/foo/*

/contents

*.foo

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┗

<stats-monitor>

「機能解説 運用／監視／連携編」−「3.4」

0または1回

稼働統計の監視の設定をします。

−

なし

−

┃

┃

┃

┃

┃

┃

┗

<waiting-request-count>

0または1回

URLグループ単位の実行待ちリクエスト数を監視します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<enabled>

0または1回

URLグループ単位の実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<high-threshold>

0または1回

しきい値イベントを出力する上限しきい値（単位：%）を指定します。

1〜100の整数値。

low-threshold以上でなければなりません。

80

−

┃

┃

┃

┃

┃

┃

┗

<low-threshold>

0または1回

しきい値イベントを出力する下限しきい値（単位：%）を指定します。

0〜99の整数値。

high-threshold以下でなければなりません。

0

−

┃

┃

┃

┣

┃

┃

<http-request>

0または1回

HTTPリクエストに関する各種設定をします。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

1回

リクエストボディ，およびクエリのデコードに使用するデフォルトのエンコーディングを指定します。

ただし，Servlet仕様に準拠した設定（ServletAPIおよびweb.xml）がある場合，無効となります。

JavaVMがサポートしている文字エンコーディングを指定します。

入力は制限されません。

なし

−

┃

┃

┃

┣

┃

┃

<http-response>

0または1回

HTTPレスポンスに関する各種設定をします。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

1回

レスポンスボディのエンコードに使用するデフォルトのエンコーディングを指定します。

ただし，Servlet仕様に準拠した設定（ServletAPIおよびweb.xml）がある場合，無効となります。

JavaVMがサポートしている文字エンコーディングを指定します。

入力は制限されません。

なし

−

┃

┃

┃

┣

┃

┃

<jsp>

0または1回

JSPに関する各種設定をします。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<page-encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

1回

JSPファイルの読み込みに使用するデフォルトのエンコーディングを指定します。

ただし，Servlet仕様に準拠した設定（ServletAPIおよびweb.xml）がある場合，無効となります。

JavaVMがサポートしている文字エンコーディングを指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┣

┃

┃

┃

<http-session>

0または1回

Webアプリケーション単位のHttpSession数の監視に関する情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<http-session-max-number>

「機能解説 基本・開発編(Webコンテナ)」−「2.7.5」

0または1回

使用可能なHttpSessionの最大数を指定します。

-1を指定した場合は無制限となります。

-1〜2147483647の整数値。

-1

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<resource-watcher>

0または1回

HttpSession数の監視に関するプロパティを設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-threshold>

0または1回

アラートメッセージを出力するしきい値を指定します。

1〜100の整数値。

80

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-interval>

0または1回

監視間隔を指定します。

1〜2147483647の整数値。

30

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<watcher-enabled>

0または1回

HttpSession数の監視を有効にするかどうかを指定します。

ただし，<http-session-max-number>に0を指定した場合，この指定に関係なく監視は無効となります。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

0または1回

リソース使用状況をファイルに出力するかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┃

┃

┗

<dbsfo>

「機能解説 拡張編」−「6章」

0または1回

データベースセッションフェイルオーバ機能を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<enabled>

0または1回

データベースセッションフェイルオーバ機能を有効にするかどうかを指定します。

指定できる文字列を次に示します。

true

false

J2EEサーバのプロパティ値（webserver.dbsfo.enabled）

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<application-id>

0または1回

アプリケーション識別子を設定します。

英数字，およびアンダースコア「_」を使用できます。

指定できる文字数は最大16文字です。

アプリケーションのコンテキストルート名から作成します。

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<attribute-data-size-max>

0または1回

グローバルセッション情報に含めることが可能なHTTPセッションの属性情報の最大サイズを設定します。

128〜10485760の整数値。

J2EEサーバのプロパティ値（webserver.dbsfo.attribute_data_size.max）

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<exclude-extensions>

0または1回

データベースセッションフェイルオーバ機能を抑止する拡張子を設定します。

複数の拡張子を指定する場合，コンマ「,」で区切って指定します。

次に示す文字を使って，512文字以内で指定します。

英数字

括弧「(　)」

エクスクラメーション「!」

パーセント「%」

ドル「$」

アンパサンド「&」

シングルクオート「'」

プラス「+」

ハイフン「-」

イコール「=」

単価記号「@」

アンダースコア「_」

チルダ「~」

ピリオド「.」

コンマ「,」

J2EEサーバのプロパティ値（webserver.dbsfo.exclude.extensions）

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<start-notify-error>

0または1回

J2EEアプリケーションの開始時にスタートアップ時のロードが指定されているServlet/JSPの初期化処理中や，taglibの解析中にエラーが発生した場合，エラーを通知してアプリケーションの開始を中断するかどうかを指定します。

新規に作成したJ2EEアプリケーションの初期表示値は，trueとなります。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<start-order>

0または1回

J2EEアプリケーションの開始および停止の順番を指定します。

開始した場合は昇順で開始処理が実行され，終了した場合は降順に停止処理が実行されます。

0〜2147483647の整数値。

10

−

┃

┃

┃

┣

┃

┃

<session-config>

0または1回

Webアプリケーションのセッションパラメタを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<cookie-config>

0または1回

Webアプリケーションで作成されるHTTPセッションのセッションIDを示すHTTP Cookieを指定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<name>

0または1回

Webアプリケーションで作成されるHTTPセッションのセッションIDを示すHTTP Cookieの名称，およびURLのパスパラメタ名を指定します。

英数字（0〜9，A〜Z，a〜z）および次の特殊文字を使用できます。

エクスクラメーションマーク（!），ドル記号（$），パーセント（%），アンパサンド（&），シングルクォーテーション（'），アスタリスク（*），プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_），バッククォート（`），ストローク（|），チルダ（~）

ただし，名前の先頭にドル記号（$）を指定できません。

JSESSIONID

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<http-only>

0または1回

Webアプリケーションで作成されるHTTPセッションのセッションIDを示すHTTP CookieにHttpOnly属性を付けるかどうかを指定します。

指定できる文字を次に示します。

true

false

false

−

┃

┃

┃

┃

┃

┃

┗

<tracking-mode>

0回以上

トラッキングモードを指定します。

指定できる文字を次に示します。

COOKIE

URL

なし

−

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<filter>

0回以上

Filterについて定義します。

web.xmlを含まない場合，このタグは指定できません。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<filter-name>

1回

Filterを特定するためのキーとなります。

web.xmlの<web-app>-<filter>-<filter-name>の設定値を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-observation-timeout>

1回

リクエストの延長で呼び出されるフィルタのdoFilterメソッドの監視用タイムアウト時間（秒）を指定します。

0を指定した場合，タイムアウトしません。

0〜86400の整数値。

0

−

┃

┃

┃

┃

┗

<servlet>

0回以上

Servletについて定義します。

web.xmlを含まない場合，このタグは指定できません。

−

なし

−

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<servlet-name>

1回

Servletを特定するためのキーとなります。

web.xmlの<web-app>-<servlet>-<servlet-name>の設定値を指定します。

入力は制限されません。

なし

D

┃

┃

┣

┃

<run-as>

0または1回

実行時アイデンティティを定義します。

−

なし

−

┃

┃

┃

┃

┗

<user-name>

1回

ユーザ名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┃

┗

<method-observation-timeout>

0または1回

リクエストの延長で呼び出されるサーブレットのserviceメソッド/JSPの_jspServiceメソッドの監視用タイムアウト時間（秒）を指定します。

0を指定した場合，タイムアウトしません。

0〜86400の整数値。

0

−

┗

<rar>

0回以上

rarに関する情報を定義します。

−

なし

−

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<module-name>

1回

リソースアダプタを特定するためのキーとなります。

次の条件に従って，設定値を指定します。

application.xmlを含むアプリケーションの場合

アーカイブ形式・展開ディレクトリ形式共通

application.xmlの<application>-<module>-<connector>に指定した文字列を指定します。

application.xmlを含まないアプリケーションの場合

アーカイブ形式（cjimportappコマンド（-f/-d））

J2EEアプリケーション中のRARファイルの場所をEARのルートからの相対パスで指定します。

展開ディレクトリ形式（cjimportappコマンド（-a））

アプリケーションディレクトリ中のRARファイルの場所をアプリケーションディレクトリからの相対パスで指定します。

入力は制限されません。

なし

K

┣

┃

┃

<resourceadapter>

0または1回

リソースアダプタについての情報を定義します。

−

なし

−

┃

┃

┃

┣

┃

┃

<outbound-resourceadapter>

0または1回

アウトバウンド方向へのリソースアダプタを定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<connection-definition>

1回以上

コネクションインタフェース・クラスを定義します。

補足

下位タグの<connector-property>について

<property-value>は<property-name>ごとに設定値の範囲が異なるため，それぞれのプロパティごとに記載しています。

<property>の指定が複数あり，<property-name>の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<property>の<property-value>の値が有効となります。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<connectionfactory-interface>

1回

リソースによってサポートされるConnectionFactoryインタフェースのクラス名を指定します。

入力は制限されません。

なし

D

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

MaxPoolSizeプロパティを指定します。

指定できる文字列を次に示します。

MaxPoolSize

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，

プールの最大値を指定します。

-1（無制限）または0

〜2147483647の整数値。

10

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<property-name>

1回

MinPoolSizeプロパティを指定します。

指定できる文字列を次に示します。

MinPoolSize

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，

プールの最小値を指定します。

0〜2147483647の整数値。

10

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

LogEnabledプロパティを指定します。

指定できる文字列を次に示します。

LogEnabled

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，

LogWriterによるログ出力の要否を指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

Userプロパティを指定します。

指定できる文字列を次に示します。

User

なし

−

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，

ユーザ名を指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

Passwordプロパティを指定します。

指定できる文字列を次に示します。

Password

なし

−

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，パスワードを指定します。

入力は制限されません。

なし

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

ValidationTypeプロパティを指定します。

指定できる文字列を次に示します。

ValidationType

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクションチェック契機を指定します。

指定できる値を次に示します。

0：コネクションチェック機能オフ

1：コネクション取得時にチェック

2：一定間隔でチェック

1

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

ValidationIntervalプロパティを指定します。

指定できる文字列を次に示します。

ValidationInterval

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，

コネクションチェック間隔（秒）を指定します。

1〜2147483647の整数値。

3600

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

RetryCountプロパティを指定します。

指定できる文字列を次に示します。

RetryCount

なし

−

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクション取得リトライ回数を指定します。

0〜2147483647の整数値。

0

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

RetryIntervalプロパティを指定します。

指定できる文字列を次に示します。

RetryInterval

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクション取得リトライ間隔（秒）を指定します。

1〜2147483647の整数値。

10

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<property-name>

1回

ConnectionTimeoutプロパティを指定します。

指定できる文字列を次に示します。

ConnectionTimeout

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクション解放までのタイムアウト値（秒）を指定します。

0〜2147483647の整数値。

0

−

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<property-name>

1回

ConnectionPoolAdjustmentIntervalプロパティを指定します。

指定できる文字列を次に示します。

ConnectionPoolAdjustmentInterval

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクション数のソフトランディング動作調節間隔（秒）を指定します。

0〜2147483647の整数値。

600

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

SweeperIntervalプロパティを指定します。

指定できる文字列を次に示します。

SweeperInterval

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクションスイーパ動作時間間隔（秒）を指定します。

0〜2147483647の整数値。

0

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<property-name>

1回

RequestQueueEnableプロパティを指定します。

指定できる文字列を次に示します。

RequestQueueEnable

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクション枯渇時のコネクション取得待ち行列の要否を指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<property-name>

1回

RequestQueueTimeoutプロパティを指定します。

指定できる文字列を次に示します。

RequestQueueTimeout

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクション枯渇時のコネクション取得待ち行列のとどまることのできる最大値（秒）を指定します。

0〜2147483647の整数値。

30

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

WatchEnabledプロパティを指定します。

指定できる文字列を次に示します。

WatchEnabled

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，

コネクションプール監視のアラート出力を有効にするかどうかを指定します

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

WatchIntervalプロパティを指定します。

指定できる文字列を次に示します。

WatchInterval

なし

−

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクションプール監視間隔（秒）を指定します。

1〜2147483647の整数値。

30

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

WatchThresholdプロパティを指定します。

指定できる文字列を次に示します。

WatchThreshold

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクションプール使用状態を監視するしきい値（％）を指定します。

1〜100の整数値。

80

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<property-name>

1回

WatchWriteFileEnabledプロパティを指定します。

指定できる文字列を次に示します。

WatchWriteFileEnabled

なし

−

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，コネクションプール監視結果をファイル出力するかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<property-name>

1回

Warmupプロパティを指定します。

指定できる文字列を次に示します。

Warmup

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，

コネクションプールのウォーミングアップ機能を有効にするかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connector-property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<property-name>

1回

NetworkFailureTimeoutプロパティを指定します。

指定できる文字列を次に示します。

NetworkFailureTimeout

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，ネットワーク障害検知機能のタイムアウトを有効にするかどうかを指定します。

指定できる文字列を次に示します。

true

false

true

−

┃

┃

┃

┃

┗

<resource-external-property>

0回以上

リソースについて定義します。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<optional-name>

1回

リソースの別名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次の名前は指定できません。

予約語のHITACHI_EJB（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<res-auth>

0または1回

リソースを使用するための認証元を，アプリケーション上で行うか，コンテナに任せるかを指定します。

指定できる文字列を次に示します。

Application

Container

Container

−

┃

┃

┃

┃

┃

┃

┃

┃

┗

<res-sharing-scope>

0または1回

リソース接続を共有できるようにするかどうかを指定します。

指定できる文字列を次に示します。

Shareable

Unshareable

Shareable

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject>

0回以上

リソースアダプタが提供する管理対象オブジェクトを定義します。

DDの<adminobject>と同じ数分，同じ順番で設定する必要があります（設定しない場合，空タグ<adminobject/>を指定します）。

すべての<adminobject>に<adminobject-name>を設定する必要がなければ省略できます。

−

なし

−

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。リソースアダプタ内でユニークでなければなりません。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

なし

−

┣

┃

┃

<resourceadapter-property>

0回以上

Connector 1.5仕様に対応するリソースアダプタを定義します。

−

なし

−

┃

┃

┃

┣

┃

┃

<property-name>

1回

MaxTPoolSizeプロパティを指定します。

指定できる文字列を次に示します。

MaxTPoolSize

なし

−

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，スレッドプールで同時に実行される最大スレッド数を指定します。

1〜2147483647の整数値。

10

−

┣

┃

┃

<resourceadapter-property>

0回以上

Connector 1.5仕様に対応するリソースアダプタを定義します。

−

なし

−

┃

┃

┃

┣

┃

┃

<property-name>

1回

MinTPoolSizeプロパティを指定します。

指定できる文字列を次に示します。

MinTPoolSize

なし

−

┃

┃

┃

┗

<property-value>

1回

プロパティ値として，スレッドプールに存在する最小スレッド数を指定します。

0〜1024の整数値。

0

−

┗

<resourceadapter-property>

0回以上

Connector 1.5仕様に対応するリソースアダプタを定義します。

−

なし

−

┣

┃

┃

<property-name>

1回

TPoolKeepaliveプロパティを指定します。

指定できる文字列を次に示します。

TPoolKeepalive

なし

−

┗

<property-value>

1回

プロパティ値として，スレッドプールのスレッド解放までのタイムアウト値（秒）を指定します。

1〜2147483647の整数値。

300

−

（凡例）

−：該当なし。

注※

指定可能値以外の文字列を使用している場合は，キュー名を指定してください。

2.2　アプリケーション属性ファイル（cosminexus.xml）で指定する各属性の詳細

アプリケーション属性ファイル（cosminexus.xml）で指定する内容の詳細を属性ごとに説明します。

アプリケーション属性ファイル（cosminexus.xml）で定義する項目について次に示します。

項目名

説明

タグ名

設定するタグを表します。

説明

タグに定義する内容を示します。

ほかのタグとの依存関係

ほかのタグとの依存関係を示します。

タグの省略

タグが省略できるかどうかを示します。

値の省略

タグの値が省略できるかどうかを示します。

2.2.1　アプリケーション統合属性の詳細

cosminexus.xmlのアプリケーション統合属性の詳細について，タグごとに説明します。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<security-prop>

説明

cosminexus-appのセキュリティの管理方法を指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<security-method>

説明

セキュリティ設定を有効にするかどうかを指定します。

指定可能値

disable_methods_without_roles

セキュリティロールを割り当てていないメソッドは実行できません。

map_methods_without_roles

セキュリティロールを割り当てていないメソッドには，default-security-roleで指定したデフォルトセキュリティロールが割り当てられます。

no_security_for_methods_without_roles

セキュリティロールが割り当てられていないメソッドはどのユーザでも実行できます。

セキュリティロールが割り当てられているメソッドはセキュリティロールによって実行が制限されます。

no_security_for_all_methods

セキュリティロールが割り当てられているメソッドも割り当てられていないメソッドもすべてどのユーザでも実行できます。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<default-security-role>

説明

<security-method>にmap_methods_without_rolesを指定した場合のデフォルトセキュリティロールを指定します。

<security-method>にmap_methods_without_roles以外が指定された場合は，このタグの設定値は無視されます。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(4)　<start-order>

説明

J2EEアプリケーション開始時・停止時の順番を指定します。

開始時は昇順で開始処理が実施され，終了時は降順に停止処理が実施されます。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(5)　<scheduling-unit>

説明

キューの配置モデルを指定します。

指定可能値

指定できる文字列を次に示します。

Application

キューをアプリケーションごとに配置する場合に指定します。

Bean

キューをBeanごとに配置する場合に指定します。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(6)　<scheduling>

説明

CTM連携関連の情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(7)　<queue-name>

説明

スケジューリングを実行するキュー名を指定します。

指定可能値

英数字，およびアンダースコア「_」を使用できます。

指定できる文字数は1〜63文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(8)　<parallel-count>

説明

CTMスケジューラがアプリケーションを呼ぶために用意するスレッド数を指定します。

指定可能値

1〜127の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(9)　<queue-length>

説明

キューの長さを指定します。

指定可能値

1〜32767の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(10)　<managed-by-ctm>

説明

CTM連携をするかどうかを指定します。

指定可能値

true

CTM連携をする。

false

CTM連携をしない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(11)　<ref-libraries>

説明

参照するライブラリJARを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(12)　<classpath>

説明

参照ライブラリのクラスパスを指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

<max-thread-pool-size>

タグの省略

省略できません。

値の省略

省略できません。

(13)　<method-observation-recovery-mode>

説明

メソッドキャンセル機能の障害回復モードを指定します。

指定可能値

指定できる文字列を次に示します。

thread

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(14)　<ejb-async-props>

説明

非同期Session Bean呼び出し用の情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(15)　<min-thread-pool-size>

説明

スレッドプールで同時に実行される最小スレッド数を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

<max-thread-pool-size>と依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(16)　<max-thread-pool-size>

説明

スレッドプールで同時に実行される最大スレッド数を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

<min-thread-pool-size>と依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(17)　<thread-pool-keep-alive>

説明

スレッドプールのスレッド解放までのタイムアウト値（単位：秒）を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(18)　<result-timeout-value>

説明

非同期呼び出しの結果を保持する時間（単位：分）を指定します。0を指定した場合，非同期呼び出しの結果を解放しないで，アプリケーションが終了するまで保持します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

2.2.2　EJB-JAR属性の詳細

cosminexus.xmlのEJB-JAR属性の詳細について，タグごとに説明します。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<ejb-jar>

説明

EJB-JARについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<module-name>

説明

EJB-JARを特定するためのキーとなります。

次の条件に従い設定値を指定します。

application.xmlを含むアプリケーションの場合

アーカイブ形式・展開ディレクトリ形式共通

application.xmlの<application>-<module>-<ejb>に指定した文字列を指定します。

application.xmlを含まないアプリケーションの場合

アーカイブ形式（cjimportappコマンド（-f/-d））

J2EEアプリケーション中のEJB-JARファイルの場所をEARのルートからの相対パスで指定します。

展開ディレクトリ形式（cjimportappコマンド（-a））

EJB-JARディレクトリの，アプリケーションディレクトリからの相対パスの末尾の"_jar"を".jar"に置き換えた値を指定します。

相対パスで指定する場合の注意事項

パスの区切り文字には"/"を使用します。

パスの文字列の先頭に"/"は指定できません。

パスの文字列中に，"./"，"../"および"//"は指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<security-role>

説明

セキュリティロールについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(4)　<role-name>

説明

ロール名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<linked-to>

説明

cjaddsecコマンドで定義したロール名を指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

2.2.3　Session Bean属性の詳細

cosminexus.xmlのSession Bean属性の詳細について，タグごとに説明します。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<session>

説明

Session Beanについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<ejb-name>

説明

ejbの名称を指定します。

なお，このキーはSession Beanを特定するためのキーとなります。

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<session>-<ejb-name>の設定値を指定します。

ejb-jar.xmlを含まないアプリケーションの場合，@Stateless，@Stateful，または@Singletonのnameの設定値を指定します。

nameが指定されていない場合は，EJB実装クラス名のパッケージ名を取り除いたクラス名を指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<security-identity>

説明

Session Beanのセキュリティアイデンティティを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(4)　<run-as>

説明

実行時アイデンティティを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<user-name>

説明

ユーザ名を指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(6)　<resource-ref>

説明

Session Beanから参照するリソースを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(7)　<res-ref-name>

説明

リソース参照の名称を指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(8)　<linked-to>

説明

対応するリソースアダプタ表示名，メール表示名を指定します。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

Connector 1.0以前

<リソースアダプタの表示名>

Connector 1.5以降のアウトバウンドリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できます。

(9)　<resource-env-ref>

説明

Session Beanから参照するリソース環境変数を定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(10)　<resource-env-ref-name>

説明

リソース環境変数参照の名称を指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(11)　<linked-queue>

説明

キュー名称を指定します。

DDの<resource-env-ref-type>タグに「javax.jms.Queue」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

DDの<resource-env-ref-type>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できます。

(12)　<resource-adapter>

説明

リソースアダプタの表示名を指定します。

Connector 1.5以降のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(13)　<queue>

説明

キュー名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(14)　<linked-adminobject>

説明

管理対象オブジェクトを指定します。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(15)　<resourceadapter-name>

説明

リソースアダプタの表示名を指定します。

Connector1.0以前のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(16)　<adminobject-name>

説明

管理対象オブジェクト名を指定します。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(17)　<linked-to>

説明

JavaBeansリソースの表示名を指定します。

DDの<resource-env-ref-type>タグに「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

DDの<resource-env-ref-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できます。

(18)　<lookup-name>

説明

クライアントからEJBをルックアップする時に使う名前を指定します。HITACHI_EJB/SERVERS/<サーバ名>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。

このタグを省略した場合，デフォルト値としてリソース名が使用されますが，デフォルト値に含まれる英数字とアンダースコア（_）以外の文字はすべてアンダースコアに変換されます。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(19)　<optional-name>

説明

リモートインタフェースの別名を指定します。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次の名前は指定できません。

予約語のHITACHI_EJB（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(20)　<local-optional-name>

説明

ローカルインタフェースの別名を指定します。

指定可能値

指定できる文字に制限はありません。

指定できる文字数は1〜255文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(21)　<maximum-sessions>

説明

セッションの最大数またはBeanインスタンスの最大数を指定します。

Stateless Session BeanまたはSingleton Session Beanの場合，この設定値は無効になります。

指定可能値

0（無制限）または1≦maximum-sessions≦2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(22)　<stateless>

説明

Session Beanの種別がStatelessの場合に指定します。

<stateless>または<stateful>のどちらかを指定するか，またはどちらも指定しません。

指定可能値

なし。

ほかのタグとの依存関係

DDの<session-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できます。

(23)　<pooled-instance>

説明

プール内のインスタンスについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(24)　<minimum>

説明

プール内のインスタンスの最小数を指定します。

指定可能値

0または1≦minimum≦maximumの整数値。

ほかのタグとの依存関係

<maximum>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(25)　<maximum>

説明

プール内のインスタンスの最大数を指定します。

指定可能値

0（無制限）または1≦maximum≦2147483647の整数値。

また，<enable-scheduling>タグの値がtrue，かつアプリケーション属性<managed-by-ctm>タグの値がtrueの場合は，指定可能範囲が異なります。

アプリケーション属性の<scheduling-unit>タグの指定値がBeanの場合

0または<scheduling>-<parallel-count>以上の整数値。

アプリケーション属性の<scheduling-unit>タグの指定値がApplicationの場合

0またはアプリケーション属性<scheduling>-<parallel-count>タグ以上の整数値。

ほかのタグとの依存関係

<enable-scheduling>タグ，アプリケーション属性の<managed-by-ctm>タグ，アプリケーション属性の<scheduling-unit>タグ，<scheduling>-<parallel-count>タグ，およびアプリケーション属性の<scheduling>-<parallel-count>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(26)　<instance-timeout>

説明

インスタンス取得タイムアウト時間（秒）を指定します。

0を指定した場合，タイムアウトしません。

指定可能値

0〜86400の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(27)　<stateful>

説明

Session Beanの種別がStatefulの場合に指定します。

<stateless>もしくは<stateful>のどちらかを指定するか，またはどちらも指定しません。

指定可能値

なし。

ほかのタグとの依存関係

DDの<session-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できます。

(28)　<maximum-active-sessions>

説明

アクティブセッションの最大数を指定します。

指定可能値

maximum-sessionsが0（無制限）の場合

0（無制限）≦maximum-active-sessions≦2147483647の整数値。

maximum-sessionsが0（無制限）以外の場合

1≦maximum-active-sessions≦maximum-sessionsの整数値。

ほかのタグとの依存関係

DDの<maximum-sessions>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(29)　<inactivity-timeout>

説明

再びアクティブ化するまでに非アクティブ状態に保持しておく時間（分）を指定します。

指定可能値

0（無制限）または1≦inactivity-timeout≦2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(30)　<removal-timeout>

説明

セッションが削除されるまでに非アクティブ状態に保持しておく時間（分）を指定します。

指定可能値

0（無制限）または1≦removal-timeout≦2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(31)　<enable-scheduling>

説明

該当するBeanをスケジューラのGateとして使用するかどうかを指定します。

指定可能値

true

使用する。

false

使用しない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(32)　<pass-by-reference>

説明

pass-by-referenceでEJBを呼び出すかどうかを指定します。

指定可能値

true

EJBを呼び出す。

false

EJBを呼び出さない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(33)　<scheduling>

説明

CTM連携関連の情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

DDの<session-type>タグ，<scheduling-unit>タグ，および<enable-scheduling>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(34)　<queue-name>

説明

スケジューリングを実行するキュー名を指定します。

指定可能値

英数字，アンダースコア「_」を使用できます。

指定できる文字数は1〜63文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(35)　<parallel-count>

説明

CTMスケジューラがアプリケーションを呼ぶために用意するスレッド数を指定します。

指定可能値

1〜127の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(36)　<queue-length>

説明

キューの長さを指定します。

指定可能値

1〜32767の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(37)　<front-ejb>

説明

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。

指定可能値

true

フロントEJBである。

false

フロントEJBでない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(38)　<start-order>

説明

J2EEアプリケーション開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(39)　<ejb-method-observation-timeout>

説明

EJBメソッドにJ2EEアプリケーションの実行時間の監視機能のメソッドタイムアウト時間を設定する場合に指定します。<ejb-method-observation-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-method-observation-timeout>タグの<method-observation-timeout>タグの値が有効となります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(40)　<method>

説明

メソッドについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(41)　<method-intf>

説明

メソッドが属するインタフェース種別を特定する場合に指定します。

指定可能値

Home

Remote

LocalHome

Local

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(42)　<method-name>

説明

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合，すべてのメソッドを意味します。

指定可能値

なし。

ほかのタグとの依存関係

DDの<method-params>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できません。

(43)　<method-params>

説明

メソッドが多重定義されている場合，メソッドを特定するために指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(44)　<method-param>

説明

引数のデータ型を指定します。

指定可能値

空白区切り文字，行区切り文字，および段落区切り文字以外を指定します。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(45)　<method-observation-timeout>

説明

J2EEアプリケーションの実行時間の監視機能のメソッドタイムアウト時間（秒）を指定します。0を指定した場合，タイムアウトしません。

指定可能値

0〜86400の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(46)　<ejb-transaction-timeout>

説明

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>タグの指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-transaction-timeout>タグの<transaction-timeout>タグの値が有効となります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(47)　<method>

説明

メソッドについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(48)　<method-intf>

説明

メソッドが属するインタフェース種別を特定する場合に指定します。

指定可能値

Home

Remote

LocalHome

Local

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(49)　<method-name>

説明

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

指定可能値

なし。

ほかのタグとの依存関係

DDの<method-params>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できません。

(50)　<method-params>

説明

メソッドが多重定義されている場合，メソッドを特定するために指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(51)　<method-param>

説明

引数のデータ型を指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(52)　<transaction-timeout>

説明

トランザクションタイムアウト時間（秒）を指定します。

0を指定した場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

2.2.4　Entity Bean属性の詳細

cosminexus.xmlのEntity Bean属性の詳細について，タグごとに説明します。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<entity>

説明

Entity Beanについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<ejb-name>

説明

ejbの名称を指定します。

なお，このキーはEntity Beanを特定するためのキーとなります。

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<entity>-<ejb-name>の設定値を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<security-identity>

説明

Entity Beanのセキュリティアイデンティティを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(4)　<run-as>

説明

実行時アイデンティティを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<user-name>

説明

ユーザ名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(6)　<resource-ref>

説明

EntityBeanから参照するリソースを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(7)　<res-ref-name>

説明

リソース参照の名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(8)　<linked-to>

説明

対応するリソースアダプタ表示名，メール表示名を指定します。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

Connector 1.0以前

<リソースアダプタの表示名>

Connector 1.5以降のアウトバウンドリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できます。

(9)　<resource-env-ref>

説明

Entity Beanから参照するリソース環境変数を定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(10)　<resource-env-ref-name>

説明

resource-env-refの名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(11)　<linked-queue>

説明

キュー名称を指定します。

このタグはDDの<resource-env-ref-type>に「javax.jms.Queue」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

DDの<resource-env-ref-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(12)　<resource-adapter>

説明

リソースアダプタの表示名を指定します。

Connector 1.5以降のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(13)　<queue>

説明

キュー名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(14)　<linked-adminobject>

説明

管理対象オブジェクトを指定します。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(15)　<resourceadapter-name>

説明

リソースアダプタの表示名を指定します。

Connector 1.0以前のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(16)　<adminobject-name>

説明

管理対象オブジェクト名を指定します。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(17)　<linked-to>

説明

JavaBeansリソースの表示名を指定します。

DDの要素<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

DDの<resource-env-ref-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できます。

(18)　<lookup-name>

説明

クライアントからEJBをルックアップする時に使う名前を指定します。HITACHI_EJB/SERVERS/<サーバ名>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。

このタグを省略した場合，デフォルト値としてリソース名が使用されますが，デフォルト値に含まれる英数字とアンダースコア（_）以外の文字はすべてアンダースコアに変換されます。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(19)　<optional-name>

説明

リモートインタフェースの別名を指定します。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次の名前は指定できません。

予約語のHITACHI_EJB（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(20)　<local-optional-name>

説明

ローカルインタフェースの別名を指定します。

指定可能値

指定できる文字に制限はありません。

指定できる字数は1〜255文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(21)　<maximum-instances>

説明

Enterprise Beanインスタンスの最大数を指定します。

指定可能値

0（無制限）または1≦maximum-instances≦2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(22)　<pooled-instance>

説明

インスタンスプールのプロパティを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(23)　<minimum>

説明

プール内のインスタンスの最小数を指定します。

指定可能値

0（無制限）または1≦minimum≦maximum。

ほかのタグとの依存関係

DDの<maximum>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(24)　<maximum>

説明

プール内のインスタンスの最大数を指定します。

指定可能値

maximum-instancesが0（無制限）の場合

0（無制限）≦maximum≦2147483647の整数値。

maximum-instancesが0（無制限）以外の場合

1≦maximum≦maximum-instancesの整数値。

ほかのタグとの依存関係

<maximum-instances>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(25)　<caching-model>

説明

キャッシングモデルを指定します。

指定可能値

full-caching

メソッド起動間のすべての状態情報をキャッシュします。

caching

メソッド起動間で最も頻繁に使用された状態情報をキャッシュします。

no-caching

状態情報をキャッシュしません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(26)　<entity-timeout>

説明

EJBオブジェクトの存在時間（秒）を指定します。

0を指定した場合，タイムアウトしません。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(27)　<pass-by-reference>

説明

pass-by-referenceでのEJB呼び出しをするかどうかを指定します。

指定可能値

true

EJB呼び出しをする。

false

EJB呼び出しをしない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(28)　<instance-timeout>

説明

インスタンス取得タイムアウト時間（秒）を指定します。0を指定した場合，タイムアウトしません。

指定可能値

0〜86400の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(29)　<front-ejb>

説明

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。

指定可能値

true

フロントEJBの場合。

false

フロントEJBでない場合。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(30)　<cmp-map>

説明

Entity Beanのフィールドをデータベース上にマッピングします。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(31)　<datasource-name>

説明

Enterprise Beanフィールドのマッピング先として開始されたリソースアダプタの表示名を指定します。

Connector 1.0以前

<リソースアダプタの表示名>

Connector 1.5以降のアウトバウンドリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(32)　<catalog-name>

説明

Enterprise Beanフィールドのマッピング先としてデータベースのカタログ名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(33)　<schema-name>

説明

Enterprise Beanフィールドのマッピング先としてデータベースのスキーマ名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(34)　<table-name>

説明

Enterprise Beanフィールドのマッピング先としてデータベースのテーブル名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(35)　<read-only-access>

説明

アプリケーションからデータベースへの書き込みを禁止するかどうかを指定します。ただし，アプリケーションサーバでは指定しても無効になります。

指定可能値

true

書き込みを禁止する。

false

書き込みを許可する。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(36)　<transaction-isolation>

説明

トランザクション遮断レベルを指定します。

省略した場合，デフォルトのトランザクション遮断レベルが使われます（使用するデータベースおよびJDBCドライバによって異なります）。

指定可能値

none

トランザクションがサポートされていません。

read_committed

ダーティー読み取りが抑制されます。

read_uncommitted

ダーティー読み取り，繰り返し不可の読み取り，およびファントム読み取りが起こります。

repeatable_read

ダーティー読み取りおよび繰り返し不可の読み取りが抑制されます。

serializable

ダーティー読み取り，繰り返し不可の読み取り，およびファントム読み取りが抑制されます。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(37)　<concurrency-protection>

説明

データベースに書き込むデータとレコードとの照合方法を指定します。

指定可能値

primary-key

プライマリキーと照合することによってデータを更新します。

modified-data

プライマリキーと照合して変更対象のデータの値が最後の読み出し操作以降に変更されているかどうかをチェックします。

whole-row

プライマリキーと照合して変更対象の値を含む行内のすべての値が最後の読み出し操作以降に変更されているかどうかをチェックします。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(38)　<field-impl>

説明

Entity Beanのフィールドとテーブルのカラムとのマッピングを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(39)　<field-name>

説明

Entity Beanのフィールド名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(40)　<column-name>

説明

テーブルのカラム名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(41)　<finder-impl>

説明

ejbFindByPrimaryKey以外のFinderメソッドの検索条件を指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(42)　<method-name>

説明

Finderメソッドのメソッド名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(43)　<where-clause>

説明

テーブルの検索条件を指定します。

検索条件に指定可能な演算子を次に示します。

なお，山括弧<>は，XMLの構文上値には指定できません。テキストエディタで属性ファイルを編集する場合は，表内の丸括弧()のようにエンティティを使用してください。

演算子

説明

備考

IS NULL

NULLである

−

IS NOT NULL

NULLでない

−

=

等しい

Finderメソッドのパラメタが1個以上のとき使用可

!=

等しくない

< (&lt;)

〜より小さい

> (&gt;)

〜より大きい

<= (&lt;=)

〜以下

>= (&gt;=)

〜以上

LIKE

検索パターンに一致する

NOT LIKE

検索パターンに一致しない

BETWEEN

範囲に含まれる

Finderメソッドのパラメタが2個以上のとき使用可

NOT BETWEEN

範囲に含まれない

（凡例）−：該当なし。

検索条件の構文を次に示します。

IS NULL，IS NOT NULL演算子を使用する場合

フィールド名 演算子

BETWEEN，NOT BETWEEN演算子を使用する場合

フィールド名 演算子 ?番号 AND ?番号

そのほかの演算子を使用する場合

フィールド名 演算子 ?番号

検索条件に関する規則を次に示します。

検索条件は，ANDまたはORで接続できます。

検索条件，AND，OR，フィールド名は大文字小文字を区別します。

?番号には，Finderメソッドの引数の場所（左から1,2,...）を指定します。

例　id &lt;= ?1 AND value IS NOT NULL OR name BETWEEN ?3 AND ?4

検索条件，AND，OR，フィールド名，?番号の間は1文字以上の空白を入れてください。

空文字列の場合は，テーブルのすべての行が検索パターンに一致するものと見なします。

DISABLEが指定されている場合はアプリケーションからこのメソッドを使用できません。

指定可能値

指定できる値はシャープ「#」以外です。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できます。

(44)　<start-order>

説明

J2EEアプリケーション開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(45)　<ejb-method-observation-timeout>

説明

EJBメソッドにJ2EEアプリケーションの実行時間の監視機能のメソッドタイムアウト時間を設定する場合に指定します。<ejb-method-observation-timeout>タグの指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-method-observation-timeout>タグの<method-observation-timeout>タグの値が有効となります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(46)　<method>

説明

メソッドについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(47)　<method-intf>

説明

メソッドが属するインタフェース種別を特定する場合に指定します。

指定可能値

Home

Remote

LocalHome

Local

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(48)　<method-name>

説明

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

<method-params>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できません。

(49)　<method-params>

説明

メソッドが多重定義されている場合，メソッドを特定するために指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(50)　<method-param>

説明

引数のデータ型を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(51)　<method-observation-timeout>

説明

J2EEアプリケーションの実行時間の監視機能のメソッドタイムアウト時間（秒）を指定します。0を指定した場合，タイムアウトしません。

指定可能値

0〜86400の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(52)　<ejb-transaction-timeout>

説明

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>タグの指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-transaction-timeout>タグの<transaction-timeout>タグの値が有効となります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(53)　<method>

説明

メソッドについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(54)　<method-intf>

説明

メソッドが属するインタフェース種別を特定する場合に指定します。

指定可能値

Home

Remote

LocalHome

Local

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(55)　<method-name>

説明

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

<method-params>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できません。

(56)　<method-params>

説明

メソッドが多重定義されている場合，メソッドを特定するために指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(57)　<method-param>

説明

引数のデータ型を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(58)　<transaction-timeout>

説明

トランザクションタイムアウト時間（秒）を指定します。

0を指定した場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

2.2.5　Message-driven Bean属性の詳細

cosminexus.xmlのMessage-driven Bean属性の詳細について，タグごとに説明します。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<message>

説明

Message-driven Beanについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<ejb-name>

説明

ejbの名称を指定します。

なお，このキーはMessage-driven Beanを特定するためのキーとなります。

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<message-driven>-<ejb-name>の設定値を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<security-identity>

説明

Message-driven Beanのセキュリティアイデンティティを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(4)　<run-as>

説明

実行時アイデンティティを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<user-name>

説明

ユーザ名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(6)　<message-ref>

説明

リソースアダプタを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(7)　<connection-factory>

説明

リソースアダプタの表示名を指定します。

Connector 1.5以降のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(8)　<connection-destination>

説明

リソースアダプタについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(9)　<resource-adapter>

説明

リソースアダプタの表示名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(10)　<queue>

説明

キュー名称を指定します。

Connector 1.5以降のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(11)　<resource-ref>

説明

Message-driven Beanから参照するリソースを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(12)　<res-ref-name>

説明

リソース参照の名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(13)　<linked-to>

説明

対応するリソースアダプタ表示名，メール表示名を指定します。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

Connector 1.0以前

<リソースアダプタの表示名>

Connector 1.5以降のアウトバウンドリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(14)　<resource-env-ref>

説明

Message-driven Beanから参照するリソース環境変数を定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(15)　<resource-env-ref-name>

説明

resource-env-refの名称を定義します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(16)　<linked-queue>

説明

キュー名称を指定します。DDの<resource-env-ref-type>タグに「javax.jms.Queue」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

DDの<resource-env-ref-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(17)　<resource-adapter>

説明

リソースアダプタの表示名を指定します。

Connector 1.5以降のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(18)　<queue>

説明

キュー名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(19)　<linked-adminobject>

説明

管理対象オブジェクトを指定します。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(20)　<resourceadapter-name>

説明

リソースアダプタの表示名を指定します。

Connector 1.0以前のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(21)　<adminobject-name>

説明

管理対象オブジェクト名を指定します。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(22)　<linked-to>

説明

JavaBeansリソースの表示名を指定します。

DDの要素<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

DD<resource-env-ref-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できます。

(23)　<pooled-instance>

説明

プール内のインスタンスを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(24)　<minimum>

説明

プール内のインスタンスの最小数を指定します。

ただし，プーリングの動作は最大数を指定することでカスタマイズできるため，このタグの設定値は無視されます。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(25)　<maximum>

説明

プール内のインスタンスの最大数を指定します。

指定可能値

1〜2147483647の整数値。

0が指定された場合は1とみなされます。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(26)　<front-ejb>

説明

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。

指定可能値

true

フロントEJBである。

false

フロントEJBでない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(27)　<start-order>

説明

J2EEアプリケーション開始時・停止時の順番を指定します。

開始時は昇順で開始処理が実行され，終了時は降順に停止処理が実行されます。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(28)　<ejb-method-observation-timeout>

説明

EJBメソッドにJ2EEアプリケーションの実行時間の監視機能のメソッドタイムアウト時間を設定する場合に指定します。<ejb-method-observation-timeout>タグの指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-method-observation-timeout>タグの<method-observation-timeout>タグの値が有効となります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(29)　<method>

説明

メソッドについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(30)　<method-intf>

説明

メソッドが属するインタフェース種別を特定する場合に指定します。

Message-driven Bean属性の設定では，このタグに値を指定できません。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(31)　<method-name>

説明

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

<method-params>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できません。

(32)　<method-params>

説明

メソッドが多重定義されている場合，メソッドを特定するために指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(33)　<method-param>

説明

引数のデータ型を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(34)　<method-observation-timeout>

説明

J2EEアプリケーションの実行時間の監視機能のメソッドタイムアウト時間（秒）を指定します。0を指定した場合，タイムアウトしません。

指定可能値

0〜86400の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(35)　<ejb-transaction-timeout>

説明

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>タグの指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-transaction-timeout>タグの<transaction-timeout>タグの値が有効となります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(36)　<method>

説明

メソッドについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(37)　<method-intf>

説明

メソッドが属するインタフェース種別を特定する場合に指定します。

Message-driven Bean属性の設定では，このタグに値を指定できません。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(38)　<method-name>

説明

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合，すべてのメソッドを意味します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

<method-params>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できません。

(39)　<method-params>

説明

メソッドが多重定義されている場合，メソッドを特定するために指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(40)　<method-param>

説明

引数のデータ型を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(41)　<transaction-timeout>

説明

トランザクションタイムアウト時間（秒）を指定します。

0を指定した場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

2.2.6　War属性の詳細

cosminexus.xmlのWar属性の詳細について，タグごとに説明します。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<war>

説明

WARについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<module-name>

説明

WARを特定するためのキーとなります。ただし，WARアプリケーションの場合，cosminexus.xmlに対しWar属性の設定は必ず一つになるため，このタグの指定は不要です。指定しても無視されます。

次の条件に従い設定値を指定します。

application.xmlを含むアプリケーションの場合

アーカイブ形式・展開ディレクトリ形式共通

application.xmlの<application>-<module>-<web>-<web-uri>に指定した文字列を指定します。

application.xmlを含まないアプリケーションの場合

アーカイブ形式（cjimportappコマンド（-f/-d））

J2EEアプリケーション中のWARファイルの場所をEARのルートからの相対パスで指定します。

展開ディレクトリ形式（cjimportappコマンド（-a））

WARディレクトリの，アプリケーションディレクトリからの相対パスの末尾の"_war"を".war"に置き換えた値を指定します。

相対パスで指定する場合の注意事項

パスの区切り文字にはスラント「/」を使用します。

パスの文字列の先頭にスラント「/」は指定できません。

パスの文字列中に，"./"，"../"および"//"は指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<security-role>

説明

セキュリティロールを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(4)　<role-name>

説明

セキュリティロール名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<linked-to>

説明

アクセスコントロールリスト（cjaddsecコマンドで定義したロール名）を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できます。

(6)　<resource-ref>

説明

Servletから参照するリソースを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(7)　<res-ref-name>

説明

リソース参照の名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(8)　<linked-to>

説明

対応するリソースアダプタ表示名，メール表示名を指定します。

Connector 1.0以前

<リソースアダプタの表示名>

Connector 1.5以降のアウトバウンドリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(9)　<resource-env-ref>

説明

Servletから参照するリソース環境変数を定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(10)　<resource-env-ref-name>

説明

リソース環境変数参照の名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(11)　<linked-queue>

説明

キュー名称を指定します。DDの要素<resource-env-ref-type>タグに「javax.jms.Queue」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

DD<resource-env-ref-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(12)　<resource-adapter>

説明

リソースアダプタの表示名を指定します。

Connector 1.5以降のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(13)　<queue>

説明

キュー名称を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(14)　<linked-adminobject>

説明

管理対象オブジェクトを指定します。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(15)　<resourceadapter-name>

説明

リソースアダプタの表示名を指定します。

Connector 1.0以前のリソースアダプタは指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(16)　<adminobject-name>

説明

管理対象オブジェクト名を指定します。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(17)　<linked-to>

説明

JavaBeansリソースの表示名を指定します。

DDの要素<resource-env-ref-type>タグに「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

DD<resource-env-ref-type>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できます。

(18)　<thread-control>

説明

Webアプリケーションのスレッド制御を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(19)　<thread-control-max-threads>

説明

Webアプリケーション単位の最大同時実行スレッド数を指定します。

占有スレッド数以上の値を指定します。

指定可能値

1〜1024の整数値。

ほかのタグとの依存関係

<thread-control-exclusive-threads>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できません。

(20)　<thread-control-exclusive-threads>

説明

占有スレッド数を指定します。

Webアプリケーション単位の最大同時実行スレッド数以下を指定します。

指定可能値

0〜1024の整数値。

ほかのタグとの依存関係

<thread-control-max-threads>タグ，および<urlgroup-thread-control-exclusive-threads>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(21)　<thread-control-queue-size>

説明

Webアプリケーション単位の実行待ち行列数を指定します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(22)　<thread-control-stats-monitor>

説明

稼働統計の監視の設定をします。このタグ，<enabled>タグ，<high-threshold>タグ，または<low-threshold>タグを省略した場合，デフォルト値が有効になるため，しきい値イベントは有効となります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(23)　<whole-waiting-request-count>

説明

Webアプリケーション単位の全体実行待ちリクエスト数を監視します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(24)　<enabled>

説明

Webアプリケーション単位の全体実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(25)　<high-threshold>

説明

しきい値イベントを出力する上限のしきい値（単位：%）を指定します。

指定可能値

1〜100の整数値。<low-threshold>タグの指定値以上の値である必要があります。

ほかのタグとの依存関係

<low-threshold>タグ

タグの省略

省略できます。

値の省略

省略できません。

(26)　<low-threshold>

説明

しきい値イベントを出力する下限しきい値（単位：%）を指定します。

指定可能値

0〜99の整数値。ただし，<high-threshold>タグの指定値以下の値である必要があります。

ほかのタグとの依存関係

<high-threshold>タグ

タグの省略

省略できます。

値の省略

省略できません。

(27)　<waiting-request-count>

説明

Webアプリケーション単位の実行待ちリクエスト数を監視します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(28)　<enabled>

説明

Webアプリケーション単位の実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(29)　<high-threshold>

説明

しきい値イベントを出力する上限のしきい値（単位：%）を指定します。

指定可能値

1〜100の整数値。ただし，<low-threshold>タグの指定値以下の値である必要があります。

ほかのタグとの依存関係

<low-threshold>タグ

タグの省略

省略できます。

値の省略

省略できません。

(30)　<low-threshold>

説明

しきい値イベントを出力する下限しきい値（単位：%）を指定します。

指定可能値

0〜99の整数値。ただし，<high-threshold>タグの指定値以下の値である必要があります。

ほかのタグとの依存関係

<high-threshold>タグ

タグの省略

省略できます。

値の省略

省略できません。

(31)　<resource-watcher>

説明

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視に関するプロパティを設定します。

このタグか，<watcher-threshold>，<watcher-interval>，<watcher-enabled>，または<watcher-writefile-enabled>を省略した場合，デフォルト値が有効になり，監視イベントが有効になります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(32)　<watcher-threshold>

説明

アラートメッセージを出力するしきい値を指定します。

指定可能値

1〜100の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(33)　<watcher-interval>

説明

監視間隔を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(34)　<watcher-enabled>

説明

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視を有効にするかどうかを指定します。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(35)　<watcher-writefile-enabled>

説明

リソース使用状況をファイルに出力するかどうかを指定します。

指定可能値

true

出力する。

false

出力しない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(36)　<urlgroup-thread-control>

説明

URLグループ単位の同時実行スレッド数制御を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(37)　<urlgroup-thread-control-name>

説明

URLグループ単位の同時実行スレッド数制御の定義名を指定します。

URLグループ単位の同時実行スレッド数制御の定義名はWebアプリケーション内で，一意な名称を指定します。

指定可能値

英数字，ハイフン「-」，アンダースコア「_」を使用できます。

文字の長さは１≦文字列長≦64で指定します。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(38)　<urlgroup-thread-control-max-threads>

説明

URLグループ単位の最大同時実行スレッド数を整数値で指定します。

指定可能値

1〜thread-control-max-threadsの整数値。

ほかのタグとの依存関係

<thread-control-max-threads>タグ，および<urlgroup-thread-control-exclusive-threads>タグと依存関係があります。

タグの省略

省略できません。

値の省略

省略できません。

(39)　<urlgroup-thread-control-exclusive-threads>

説明

URLグループ単位の占有スレッド数を指定します。

指定可能値

0〜urlgroup-thread-control-max-threadsかつthread-control-exclusive-threads以下の整数値。

ほかのタグとの依存関係

<thread-control-max-threads>タグ，<thread-control-exclusive-threads>タグ，および<urlgroup-thread-control-max-threads>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(40)　<urlgroup-thread-control-queue-size>

説明

URLグループ単位の実行待ちキューのサイズを指定します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(41)　<urlgroup-thread-control-mapping>

説明

制御対象となるURLのマッピング情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(42)　<url-pattern>

説明

制御対象となるURLパターンを指定します。

一つのWebアプリケーション内で同じURLパターンを指定することはできません。

指定例を次に示します。

/soda/grape/*
/foo/*
/contents
*.foo

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(43)　<stats-monitor>

説明

稼働統計の監視の設定をします。

このタグか，<enabled>，<high-threshold>，または<low-threshold>を省略した場合，デフォルト値が有効になり，しきい値イベントが有効になります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(44)　<waiting-request-count>

説明

URLグループ単位の実行待ちリクエスト数を監視します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(45)　<enabled>

説明

URLグループ単位の実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(46)　<high-threshold>

説明

しきい値イベントを出力する上限しきい値（単位：%）を指定します。

指定可能値

1〜100の整数値。

low-threshold以上でなければなりません。

ほかのタグとの依存関係

<low-threshold>と依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(47)　<low-threshold>

説明

しきい値イベントを出力する下限しきい値（単位：%）を指定します。

指定可能値

0〜99の整数値。

high-threshold以下でなければなりません。

ほかのタグとの依存関係

<high-threshold>と依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(48)　<http-request>

説明

HTTPリクエストに関する各種設定をします。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(49)　<encoding>

説明

リクエストボディ，およびクエリのデコードに使用するデフォルトのエンコーディングを指定します。

ただし，Servlet仕様に準拠した設定（ServletAPIおよびweb.xml）がある場合，無効となります。

JavaVMがサポートしている文字エンコーディングを指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(50)　<http-response>

説明

HTTPレスポンスに関する各種設定をします。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(51)　<encoding>

説明

レスポンスボディのエンコードに使用するデフォルトのエンコーディングを指定します。

ただし，Servlet仕様に準拠した設定（ServletAPIおよびweb.xml）がある場合，無効となります。

JavaVMがサポートしている文字エンコーディングを指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(52)　<jsp>

説明

JSPに関する各種設定をします。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(53)　<page-encoding>

説明

JSPファイルの読み込みに使用するデフォルトのエンコーディングを指定します。

ただし，Servlet仕様に準拠した設定（ServletAPIおよびweb.xml）がある場合，無効となります。

JavaVMがサポートしている文字エンコーディングを指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(54)　<http-session>

説明

Webアプリケーション単位のHttpSession数の監視に関する情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(55)　<http-session-max-number>

説明

使用可能なHttpSessionの最大数を指定します。

-1を指定した場合は無制限となります。

指定可能値

-1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(56)　<resource-watcher>

説明

HttpSession数の監視に関するプロパティを設定します。

このタグか，<watcher-threshold>，<watcher-interval>，<watcher-enabled>，または<watcher-writefile-enabled>を省略した場合，デフォルト値が有効になり，監視イベントが有効になります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(57)　<watcher-threshold>

説明

アラートメッセージを出力するしきい値を指定します。

指定可能値

1〜100の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(58)　<watcher-interval>

説明

監視間隔を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(59)　<watcher-enabled>

説明

HttpSession数の監視を有効にするかどうかを指定します。

ただし，<http-session-max-number>に0を指定した場合，この指定に関係なく監視は無効となります。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

<http-session-max-number>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できません。

(60)　<watcher-writefile-enabled>

説明

リソース使用状況をファイルに出力するかどうかを指定します。

指定可能値

true

出力する。

false

出力しない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(61)　<dbsfo>

説明

データベースセッションフェイルオーバ機能を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(62)　<enabled>

説明

データベースセッションフェイルオーバ機能を有効にするかどうかを設定します。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(63)　<application-id>

説明

アプリケーション識別子を設定します。

指定可能値

英数字，およびアンダースコア「_」を使用できます。

最大16文字まで指定できます。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(64)　<attribute-data-size-max>

説明

グローバルセッション情報に含めることが可能なHTTPセッションの属性情報の最大サイズを設定します。

指定可能値

128〜10485760の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(65)　<exclude-extensions>

説明

データベースセッションフェイルオーバ機能を抑止する拡張子を設定します。

URLのパスが指定した拡張子と同じ場合に，該当するリクエストでデータベースセッションフェイルオーバ機能は無効となります。指定した拡張子とURLの比較では大文字，小文字の区別はしません。データベースセッションフェイルオーバ機能を抑止する拡張子を設定しない場合は空文字列を設定します。

指定可能値

次に示す文字を512文字以内で指定します。

英数字

括弧「(　)」

エクスクラメーション「!」

パーセント「%」

ドル「$」

アンパサンド「&」

シングルクオート「'」

プラス「+」

ハイフン「-」

イコール「=」

単価記号「@」

アンダースコア「_」

チルダ「~」

ピリオド「.」

コンマ「,」

なお，複数の拡張子を指定する場合，コンマ「,」で区切って指定します。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(66)　<start-notify-error>

説明

J2EEアプリケーションの開始時にスタートアップ時のロードが指定されているServlet/JSPの初期化処理中や，taglibの解析中にエラーが発生した場合，エラーを通知してアプリケーションの開始を中断するかどうかを指定します。

新規に作成したJ2EEアプリケーションの初期表示値は，trueとなります。

指定可能値

true

エラーを通知する。

false

エラーを通知しない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(67)　<start-order>

説明

J2EEアプリケーションの開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(68)　<session-config>

説明

Webアプリケーションのセッションパラメタを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(69)　<cookie-config>

説明

Webアプリケーションで作成されるHTTPセッションのセッションIDを示すHTTP Cookieを指定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できます。

(70)　<name>

説明

Webアプリケーションで作成されるHTTPセッションのセッションIDを示すHTTP Cookieの名称，およびURLのパスパラメタ名を指定します。

指定可能値

英数字（0〜9，A〜Z，a〜z）および次の特殊文字を使用できます。

エクスクラメーションマーク（!），ドル記号（$），パーセント（%），アンパサンド（&），シングルクォーテーション（'），アスタリスク（*），プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_），バッククォート（`），ストローク（|），チルダ（~）

ただし，名前の先頭にドル記号（$）を指定できません。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(71)　<http-only>

説明

Webアプリケーションで作成されるHTTPセッションのセッションIDを示すHTTP CookieにHttpOnly属性を付けるかどうかを指定します。

指定可能値

true

HTTP CookieにHttpOnly属性を付ける。

false

HTTP CookieにHttpOnly属性を付けない。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(72)　<tracking-mode>

説明

トラッキングモードを指定します。

指定可能値

COOKIE

URL

ほかのタグとの依存関係

なし。

タグの省略

省略できます。このタグを省略した場合，COOKIEとURLが指定された場合と同様に動作します。

値の省略

省略できません。

2.2.7　Filter属性の詳細

cosminexus.xmlのFilter属性の詳細について，タグごとに説明します。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<filter>

説明

Filterについて定義します。

なお，web.xmlを含まない場合，このタグは指定できません。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<filter-name>

説明

Filterを特定するためのキーとなります。

web.xmlの<web-app>-<filter>-<filter-name>の設定値を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<method-observation-timeout>

説明

リクエストの延長で呼び出されるフィルタのdoFilterメソッドの監視用タイムアウト時間（秒）を指定します。

0を指定した場合，タイムアウトしません。

指定可能値

0〜86400の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

2.2.8　Servlet属性の詳細

cosminexus.xmlのServlet属性の詳細について，タグごとに説明します。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<servlet>

説明

Servletについて定義します。

なお，web.xmlを含まない場合，このタグは指定できません。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<servlet-name>

説明

Servletを特定するためのキーとなります。

web.xmlの<web-app>-<servlet>-<servlet-name>の設定値を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<run-as>

説明

実行時アイデンティティを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(4)　<user-name>

説明

ユーザ名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<method-observation-timeout>

説明

リクエストの延長で呼び出されるサーブレットのserviceメソッド/JSPの_jspServiceメソッドの監視用タイムアウト時間（秒）を指定します。

0を指定した場合，タイムアウトしません。

指定可能値

0〜86400の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

2.2.9　Connector属性の詳細

cosminexus.xmlのConnector属性の詳細について，タグごとに説明します。<property-value>タグおよび<property-name>タグで指定する値は，設定できる範囲ごとに記載してます。

なお，ここでは，「2.1　アプリケーション属性ファイル（cosminexus.xml）の指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<rar>

説明

rarに関する情報を定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(2)　<module-name>

説明

リソースアダプタを特定するためのキーとなります。

次の条件に従って，設定値を指定します。

application.xmlを含むアプリケーションの場合

アーカイブ形式・展開ディレクトリ形式共通

application.xmlの<application>-<module>-<connector>に指定した文字列を指定します。

application.xmlを含まないアプリケーションの場合

アーカイブ形式（cjimportappコマンド（-f/-d））

J2EEアプリケーション中のRARファイルの場所をEARのルートからの相対パスで指定します。

展開ディレクトリ形式（cjimportappコマンド（-a））

アプリケーションディレクトリ中のRARファイルの場所をアプリケーションディレクトリからの相対パスで指定します。

相対パスで指定する場合の注意事項

パスの区切り文字にはスラント「/」を使用します。

パスの文字列の先頭にスラント「/」は指定できません。

パスの文字列中に，"./"，"../"および"//"は指定できません。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(3)　<resourceadapter>

説明

リソースアダプタについての情報を定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(4)　<outbound-resourceadapter>

説明

アウトバウンド方向へのリソースアダプタを定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(5)　<connection-definition>

説明

コネクションインタフェース・クラスを定義します。

補足

下位タグの<connector-property>タグについて

<property-value>タグは<property-name>タグごとに設定値の範囲が異なるため，それぞれのプロパティごとに記載しています。

<property>タグの指定が複数あり，<property-name>タグの設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<property>タグの<property-value>タグの値が有効となります。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(6)　<connectionfactory-interface>

説明

リソースによってサポートされるConnectionFactoryインタフェースのクラス名を指定します。

Connector 1.5以降のリソースアダプタの場合，このタグの値がコネクション定義識別子となります。

パッケージが定義されている場合は，パッケージから指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(7)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(8)　<property-name>

説明

MaxPoolSizeプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

MaxPoolSize

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(9)　<property-value>

説明

プロパティ値として，プールの最大値を指定します。

指定可能値

-1（無制限）または0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(10)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(11)　<property-name>

説明

MinPoolSizeプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

MinPoolSize

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(12)　<property-value>

説明

プロパティ値として，プールの最小値を指定します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(13)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(14)　<property-name>

説明

LogEnabledプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

LogEnabled

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(15)　<property-value>

説明

プロパティ値として，LogWriterによるログ出力の要否を指定します。

指定可能値

true

ログを出力する。

false

ログを出力しない。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(16)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(17)　<property-name>

説明

Userプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

User

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(18)　<property-value>

説明

プロパティ値として，ユーザ名を指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できます。

(19)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(20)　<property-name>

説明

Passwordプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

Password

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(21)　<property-value>

説明

プロパティ値として，パスワードを指定します。

指定可能値

入力は制限されません。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できます。

(22)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(23)　<property-name>

説明

ValidationTypeプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

ValidationType

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(24)　<property-value>

説明

コネクションチェック契機のプロパティ値を指定します

指定可能値

0：コネクションチェック機能オフ

1：コネクション取得時にチェック

2：一定間隔でチェック

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(25)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(26)　<property-name>

説明

ValidationIntervalプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

ValidationInterval

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(27)　<property-value>

説明

プロパティ値として，コネクションチェック間隔（秒）を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(28)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(29)　<property-name>

説明

RetryCountプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

RetryCount

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(30)　<property-value>

説明

プロパティ値として，コネクション取得リトライ回数を指定します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(31)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(32)　<property-name>

説明

RetryIntervalプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

RetryInterval

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(33)　<property-value>

説明

プロパティ値として，コネクション取得リトライ間隔（秒）を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(34)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(35)　<property-name>

説明

ConnectionTimeoutプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

ConnectionTimeout

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(36)　<property-value>

説明

プロパティ値として，コネクション解放までのタイムアウト値（秒）を指定します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(37)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(38)　<property-name>

説明

ConnectionPoolAdjustmentIntervalプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

ConnectionPoolAdjustmentInterval

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(39)　<property-value>

説明

プロパティ値として，コネクション数のソフトランディング動作調節間隔（秒）を指定します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(40)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(41)　<property-name>

説明

SweeperIntervalプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

SweeperInterval

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(42)　<property-value>

説明

プロパティ値として，コネクションスイーパ動作時間間隔（秒）を指定します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(43)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(44)　<property-name>

説明

RequestQueueEnableプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

RequestQueueEnable

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(45)　<property-value>

説明

プロパティ値として，コネクション枯渇時のコネクション取得待ち行列の要否を指定します。

指定可能値

true

コネクション枯渇時のコネクション取得待ち行列機能を有効にする。

false

コネクション枯渇時のコネクション取得待ち行列機能を無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(46)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(47)　<property-name>

説明

RequestQueueTimeoutプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

RequestQueueTimeout

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(48)　<property-value>

説明

プロパティ値として，コネクション枯渇時のコネクション取得待ち行列のとどまることのできる最大値（秒）を指定します。

指定可能値

0〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(49)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(50)　<property-name>

説明

WatchEnabledプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

WatchEnabled

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(51)　<property-value>

説明

プロパティ値として，コネクションプール監視のアラート出力を有効にするかどうかを指定します。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(52)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(53)　<property-name>

説明

WatchIntervalプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

WatchInterval

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(54)　<property-value>

説明

プロパティ値として，コネクションプール監視間隔（秒）を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(55)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(56)　<property-name>

説明

WatchThresholdプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

WatchThreshold

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(57)　<property-value>

説明

プロパティ値として，コネクションプール使用状態を監視するしきい値（％）を指定します。

指定可能値

1〜100の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(58)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(59)　<property-name>

説明

WatchWriteFileEnabledプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

WatchWriteFileEnabled

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(60)　<property-value>

説明

プロパティ値として，コネクションプール監視結果をファイル出力するかどうかを指定します。

指定可能値

true

出力する。

false

出力しない。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(61)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(62)　<property-name>

説明

Warmupプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

Warmup

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(63)　<property-value>

説明

プロパティ値として，コネクションプールのウォーミングアップ機能を有効にするかどうかを指定します。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(64)　<connector-property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(65)　<property-name>

説明

NetworkFailureTimeoutプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

NetworkFailureTimeout

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(66)　<property-value>

説明

プロパティ値として，ネットワーク障害検知機能のタイムアウトを有効にするかどうかを指定します。

指定可能値

true

有効にする。

false

無効にする。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(67)　<resource-external-property>

説明

リソースについて定義します。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(68)　<optional-name>

説明

リソースの別名を指定します。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

指定できる文字数は1〜255文字です。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(69)　<res-auth>

説明

リソースを使用するための認証元を，アプリケーション上で行うか，コンテナに任せるかを指定します。

指定可能値

指定できる文字列を次に示します。

Application

Container

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(70)　<res-sharing-scope>

説明

リソース接続を共有できるようにするかどうかを指定します。

指定可能値

指定できる文字列を次に示します。

Shareable

Unshareable

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(71)　<adminobject>

説明

リソースアダプタが提供する管理対象オブジェクトを定義します。

DDの<adminobject>と同じ数分，同じ順番で設定する必要があります（設定しない場合，空タグ<adminobject/>を指定します）。

すべての<adminobject>に<adminobject-name>を設定する必要がなければ省略できます。

指定可能値

なし。

ほかのタグとの依存関係

DDの<adminobject>タグと依存関係があります。

タグの省略

省略できます。

値の省略

省略できます。

(72)　<adminobject-name>

説明

管理対象オブジェクト名を指定します。リソースアダプタ内でユニークでなければなりません。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できます。

(73)　<resourceadapter-property>

説明

Connector 1.5仕様に対応するリソースアダプタを定義します。

なお，このタグより下位のタグはConnector 1.5以降のリソースアダプタに対してだけ指定できます。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(74)　<property-name>

説明

MaxTPoolSizeプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

MaxTPoolSize

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(75)　<property-value>

説明

プロパティ値として，スレッドプールで同時に実行される最大スレッド数を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(76)　<resourceadapter-property>

説明

Connector 1.5仕様に対応するリソースアダプタを定義します。

なお，このタグより下位のタグはConnector 1.5以降のリソースアダプタに対してだけ指定できます。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(77)　<property-name>

説明

MinTPoolSizeプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

MinTPoolSize

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(78)　<property-value>

説明

プロパティ値として，スレッドプールに存在する最小スレッド数を指定します。

指定可能値

0〜1024の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(79)　<resourceadapter-property>

説明

Connector 1.5仕様に対応するリソースアダプタを定義します。

なお，このタグより下位のタグはConnector 1.5以降のリソースアダプタに対してだけ指定できます。

指定可能値

なし。

ほかのタグとの依存関係

なし。

タグの省略

省略できます。

値の省略

省略できません。

(80)　<property-name>

説明

TPoolKeepaliveプロパティを指定します。

指定可能値

指定できる文字列を次に示します。

TPoolKeepalive

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

(81)　<property-value>

説明

プロパティ値として，スレッドプールのスレッド解放までのタイムアウト値（秒）を指定します。

指定可能値

1〜2147483647の整数値。

ほかのタグとの依存関係

なし。

タグの省略

省略できません。

値の省略

省略できません。

3　J2EEアプリケーションの設定で使用する属性ファイル

この章では，J2EEアプリケーションの設定で使用する属性ファイルについて説明します。

3.1　アプリケーション統合属性ファイル

アプリケーション統合属性ファイルは，アプリケーション，EJB-JAR，Session Bean，Entity Bean，Message-driven Bean，WAR，フィルタ，サーブレット/JSPおよびリソースアダプタの属性を一括して取得，編集する場合に使用するファイルです。

3.1.1　アプリケーション統合属性ファイルの指定内容

アプリケーション統合属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-application-all-property PUBLIC '-//Hitachi, Ltd.//DTD Application All Property 9.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-application-all-property_9_0.dtd'>

アプリケーション統合属性ファイルは，次に示すタグを持つxmlファイルです。なお，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名

出現パターン

説明

<hitachi-application-all-property>

1回

ルートタグ。

┣

┃

┃

<hitachi-application-property>

0または1回※1

アプリケーションの属性。

詳細については，「3.2　アプリケーション属性ファイル」を参照してください。※2

┣

┃

┃

<ejb-jar>

0回以上※1

EJBに関する情報。

ルートアプリケーションに含まれるEJB-JARの数だけ出力されます。

┃

┃

┃

┣

┃

┃

<hitachi-ejb-jar-property>

1回

EJB-JARの属性。

詳細については，「3.3　EJB-JAR属性ファイル」を参照してください。※2，※3

┃

┃

┃

┃

┣

┃

┃

┃

<hitachi-session-bean-property>

0回以上※1

Session Beanの属性。

EJB-JARに含まれるSession Beanの数だけ出力されます。

詳細については，「3.4　Session Bean属性ファイル」を参照してください。※2，※3

┃

┃

┃

┃

┣

┃

┃

┃

<hitachi-entity-bean-property>

0回以上※1

Entity Beanの属性。

EJB-JARに含まれるEntity Beanの数だけ出力されます。

詳細については，「3.5　Entity Bean属性ファイル」を参照してください。※2，※3

┃

┃

┃

┃

┃

┗

<hitachi-message-bean-property>

0回以上※1

Message-driven Beanの属性。

EJB-JARに含まれるMessage-driven Beanの数だけ出力されます。

詳細については，「3.6　MessageDrivenBean属性ファイル」を参照してください。※2，※3

┣

┃

┃

<war>

0回以上※1

WARに関する情報。

ルートアプリケーションに含まれるWARの数だけ出力されます。

┃

┃

┃

┣

┃

┃

<hitachi-war-property>

1回

WARの属性。

詳細については，「3.7　WAR属性ファイル」を参照してください。※2，※3

┃

┃

┃

┣

┃

┃

<hitachi-filter-property>

0回以上※1

フィルタの属性。

WARに含まれるフィルタの数だけ出力されます。

詳細については，「3.8　フィルタ属性ファイル」を参照してください。※2，※3

┃

┃

┃

┃

┗

<hitachi-servlet-property>※4

0回以上※1

サーブレット/JSPの属性。

WARに含まれるサーブレット/JSPの数だけ出力されます。

詳細については，「3.9　サーブレット属性ファイル」を参照してください。※2，※3

┗

<rar>

0回以上※1

RARに関する情報。

ルートアプリケーションに含まれるRARの数だけ出力されます。

┗

<hitachi-connector-property>

1回

Connectorの属性。

RARに含まれるConnectorの数だけ出力されます。

詳細については，「4.1　Connector属性ファイル」を参照してください。※2，※3

−

−

−

−

−

注※1

タグの単位で省略できます。この場合，指定していない項目の属性は変更されません。

注※2

各属性ファイルの内容と，一部タグ名やタグの出力順序が異なっている部分があります。タグ名の違いについては，次の表を参照してください。

表3‒1　統合属性ファイルで出力されるタグ名

属性ファイル名

タグ名

統合属性ファイルのタグ名

Session Bean属性ファイル

<runtime>

<session-runtime>

Entity Bean属性ファイル

<runtime>

<entity-runtime>

MessageDrivenBean属性ファイル

<runtime>

<message-runtime>

<security-identity>

<message-security-identity>

WAR属性ファイル

<runtime>

<war-runtime>

注※3

display-nameは，変更できません。

注※4

アプリケーション統合属性ファイルをcjsetapppropコマンドで設定すると，サーブレット単位（<hitachi-servlet-property>タグ単位）に設定値の反映処理を実施します。ただし，<hitachi-servlet-property>−<url-pattern>タグについては，すべてのサーブレットで重複がないかどうかのチェックを実施しています。

3.2　アプリケーション属性ファイル

アプリケーション属性ファイルは，アプリケーションの属性を取得，編集する場合に使用するファイルです。

3.2.1　アプリケーション属性ファイルの指定内容

アプリケーション属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-application-property PUBLIC '-//Hitachi, Ltd.//DTD Application Property 8.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-application-property_8_0.dtd'>

アプリケーション属性ファイルは，次に示すタグを持つxmlファイルです。

なお，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名

出現パターン

説明

<hitachi-application-property>

1回

ルートタグ。

┣

┃

<description>

0または1回

アプリケーションの説明。

┣

┃

<icon>

0または1回

Deployツール上に表示されるJ2EEアプリケーションのアイコンの定義を行います。

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。

┣

┃

┃

┃

┃

┃

<lookup-name>

1回

クライアントからEJBをルックアップするときに使う名前を255文字以下で指定します。

HITACHI_EJB/SERVERS/<サーバ名称>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<アプリケーションのルックアップ名>に相当します。このタグは参照専用です。ルックアップ名はアプリケーション名を基に自動的に作られます。※1

┣

┃

┃

┃

<library-directory>

0または1回

ライブラリJARを格納するディレクトリ名を表示します。DD（application.xml）にタグが指定されていないまたは，J2EEアプリケーションにDD（application.xml）が含まれていない場合は，"lib"が表示されます。空タグの場合，J2EEアプリケーションのルート直下を示します。※1

┣

<security-prop>

1回

Enterprise Beanのセキュリティの管理方法。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<security-method>

1回

セキュリティの管理方法。

次のどれかを指定します。

disable_methods_without_roles

セキュリティロールを割り当てていないメソッドは実行できません。

map_methods_without_roles

セキュリティロールを割り当てていないメソッドには，default-security-roleで指定したデフォルトセキュリティロールが割り当てられます。

no_security_for_methods_without_roles

セキュリティロールが割り当てられていないメソッドはどのユーザでも実行できます。

セキュリティロールが割り当てられているメソッドはセキュリティロールによって実行が制限されます。

no_security_for_all_methods

セキュリティロールが割り当てられているメソッドも割り当てられていないメソッドもすべてどのユーザでも実行できます。

┃

┃

┃

┗

<default-security-role>

0または1回

security-methodにmap_methods_without_rolesを指定した場合のデフォルトセキュリティロール。

map_methods_without_roles以外を指定している場合は省略できます（設定されていてもcjsetapppropで無視されます）。

┣

┃

┃

┃

┃

┃

<start-order>

0または1回

J2EEアプリケーション開始時および停止時の順番。

開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0≦start-order≦2147483647

┣

┃

┃

┃

┃

┃

<scheduling-unit>

「機能解説 拡張編」−「3.2.5」

0または1回

キューの配置モデルの指定。

次のどちらかを指定します。

Application

キューをアプリケーションごとに配置します。

デフォルトは，Applicationです。

Bean

キューをBeanごとに配置します。

┣

┃

┃

┃

┃

<scheduling>

「機能解説 拡張編」−「3.4」

0または1回

CTMとの連携についての定義。

なお，このタグは構成ソフトウェアにComponent Transaction Monitorを含む製品だけに有効です。それ以外の場合に指定するとエラーになります。利用できる製品については，マニュアル「アプリケーションサーバ & BPM/ESB基盤概説」の「2.2.1　製品と構成ソフトウェアの対応」を参照してください。

┃

┃

┣

┃

<queue-name>

「機能解説 拡張編」−「3.2.5」

1回

スケジューリングをするキューの名称を，63文字までの英数字（0〜9，A〜Z，a〜z）およびアンダースコア（_）で指定します。デフォルト値は，アプリケーション名です。※2

┃

┃

┃

┣

┃

┃

<parallel-count>

「機能解説 拡張編」−「3.4」

1回

CTMがアプリケーションを呼び出すために用意するスレッド数を，1〜127の範囲で指定します。デフォルトは，1です。

CTM経由で呼び出されるBeanで，Maximumの値がparallel-countの値より小さい場合エラーとなります。

┃

┃

┃

┃

┗

<queue-length>

「機能解説 拡張編」−「3.4」

0または1回

スケジューリングをするキューの長さを，1〜32767の整数値で指定します。

キューを共有する場合，キューを共有するアプリケーション間やBean間で設定値が異なるとき，すでに生成されているキューの長さが有効になります。

┣

┃

┃

┃

┃

┃

<managed-by-ctm>

「機能解説 拡張編」−「3.4」

1回

CTM連携をするかどうかの指定。

次のどちらかを指定します。

true

CTMと連携します。

false

CTMと連携しません。

デフォルト値は，falseです。

┣

<ref-libraries>

0または1回

参照するライブラリの指定。

┃

┃

┃

┃

┃

┃

┃

┗

<classpath>

1回以上

クラスパスの指定。

ref-librariesが指定されていて，このタグが存在しない場合，エラーとなります。

このタグを複数指定した場合，指定した順序でランタイム属性に設定されます。クラスローダに設定されるクラスパスについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「付録B.3　クラスローダに設定されるクラスパス」を参照してください。

┗

<method-observation-recovery-mode>

0または1回

J2EEアプリケーションの時間監視機能の障害回復モードの指定。

ここでは，threadだけが指定できます。

thread

スレッドを停止します。

−

−

−

−

−

注※1

cjgetapppropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※2

<scheduling-unit>にApplicationを設定していて，かつ<queue-name>を省略する場合，application.xmlの<appliction><display-name>には<queue-name>で指定可能な範囲の値を定義してください。

3.2.2　DDとの対応

アプリケーション属性ファイルとDeployment Descriptorの対応を次に示します。

アプリケーション属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-application-property>

1回

<application>

1回

┣

<description>

0または1回

┣

<description>

0または1回

┣

<icon>

0回以上

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回※

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回※

┃

┗

<large-icon>

0または1回

┃

−

−

┣

<display-name>

1回

┣

<lookup-name>

1回

┃

−

−

┣

<library-directory>

0または1回

┣

<library-directory>

0または1回

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

注※

<small-icon>と<large-icon>のどちらか一つを指定します。

3.2.3　cosminexus.xmlとの対応

アプリケーション属性ファイルとcosminexus.xmlの対応を次に示します。

アプリケーション属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

<hitachi-application-property>

1回

<cosminexus-app>

1回

┣

<security-prop>

1回

┣

<security-prop>

0または1回※

┃

┣

<security-method>

1回

┃

┣

<security-method>

0回以上

┃

┗

<default-security-role>

0または1回

┃

┗

<default-security-role>

0または1回

┣

<start-order>

0または1回

┣

<start-order>

0または1回

┣

<scheduling-unit>

0または1回

┣

<scheduling-unit>

0または1回

┣

<scheduling>

0または1回

┣

<scheduling>

0または1回

┃

┣

<queue-name>

1回

┃

┣

<queue-name>

0または1回※

┃

┣

<parallel-count>

1回

┃

┣

<parallel-count>

0または1回※

┃

┗

<queue-length>

0または1回

┃

┗

<queue-length>

0または1回

┣

<managed-by-ctm>

1回

┣

<managed-by-ctm>

0または1回※

┣

<ref-libraries>

0または1回

┣

<ref-libraries>

0または1回

┃

┗

<classpath>

1回以上

┃

┗

<classpath>

1回以上

┗

<method-observation-recovery-mode>

0または1回

┗

<method-observation-recovery-mode>

0または1回

−

−

−

−

−

−

−

−

注※

cosminexus.xmlは，カスタマイズしたい要素だけを記述する形式となるため，属性ファイルと出現パターンが異なります。

3.3　EJB-JAR属性ファイル

EJB-JAR属性ファイルは，EJB-JARの属性を取得，編集する場合に使用するファイルです。

3.3.1　EJB-JAR属性ファイルの指定内容

EJB-JAR属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-ejb-jar-property PUBLIC '-//Hitachi, Ltd.//DTD Ejb Jar Property 9.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-ejb-jar-property_9_0.dtd'>

EJB-JAR属性ファイルは，次に示すタグを持つxmlファイルです。

なお，設定先のEJB-JARがDD（ejb-jar.xml）を保持していない場合，EJB-JAR属性ファイルのタグは変更できません。また，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

(1)　ejb-jar.xmlを含む場合

タグ名

出現パターン

説明

<hitachi-ejb-jar-property>

1回

ルートタグ。

┣

<description>※1

0回以上※2

EJB-JARの説明。※3

┣

┃

┃

┃

┃

<display-name>※1

1回以上※2

EJB-JARの表示名。※3

1≦文字列長

変更する場合，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

┣

┃

<icon>※1

0回以上※2

GUIツール上に表示されるEJB-JARのアイコンの定義。※3

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。※3

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。※3

┣

<interceptors>

0または1回

インターセプタの設定。※4

┃

┣

<description>※1

0回以上※2

Interceptorsの説明。※4

┃

┗

<interceptor>

1回以上

インターセプタクラスの設定。※4

┃

┣

<description>※1

0回以上※2

interceptor-classの説明。※4

┃

┣

<interceptor-class>

1回

インターセプタクラスの名称。※4

┃

┃

┣

┃

<around-invoke>

0回以上

インターセプタのaroundinvokeメソッドの定義。※4

┃

┃

┃

┃

┣

┃

<class>

0または1回

インターセプタのaroundinvokeメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┃

┃

┗

<method-name>

1回

インターセプタのaroundinvokeメソッドの名称。※4

┃

┃

┣

┃

<post-construct>

0回以上

インターセプタのpost-constructメソッドの定義。※4

┃

┃

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

インターセプタのpost-constructメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┃

┃

┗

<lifecycle-callback-method>

1回

インターセプタのpost-constructメソッド名を表示。※4

┃

┃

┣

┃

<pre-destroy>

0回以上

インターセプタのpre-destroyメソッドの定義。※4

┃

┃

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

インターセプタのpre-destroyメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┃

┃

┗

<lifecycle-callback-method>

1回

インターセプタのpre-destroyメソッド名を表示。※4

┃

┃

┣

┃

<post-activate>

0回以上

インターセプタのpost-activateメソッドの定義。※4

┃

┃

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

インターセプタのpost-activateメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┃

┃

┗

<lifecycle-callback-method>

1回

インターセプタのpost-activateメソッド名を表示。※4

┃

┃

┗

<pre-passivate>

0回以上

インターセプタのpre-passivateメソッドの定義。※4

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

インターセプタのpre-passivateメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┗

<lifecycle-callback-method>

1回

インターセプタのpre-passivateメソッド名を表示。※4

┣

┃

┃

<relationships>

0または1回

リレーションシップについての定義。

EJB2.1以前の場合に設定できます。EJB3.0以降の場合は設定できません。※3

┃

┣

<description>※1

0回以上※2

relationshipsの説明。※3

┃

┃

┗

<ejb-relation>

1回以上

二つのCMP EntityBean間のリレーションシップについての定義。※3

┃

┣

<description>※1

0回以上※2

ejb-relationの説明。※3

┃

┣

<ejb-relation-name>

0または1回

relationshipsの名称。※3

┃

┣

<ejb1>

1回

ejb2に対するejb1の関連情報。※3

┃

┃

┣

<description>※1

0回以上※2

ejb1の説明。※3

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<ejb-relationship-role-name>

0または1回

リレーションシップロール名。※3

二つのCMP EntityBean間のリレーションシップ定義中では，それぞれ一意な名称を指定します。別リレーションシップ定義では，同じ名称であっても指定できます。

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<multiplicity>

1回

ejb1のインスタンスの多重度。※3

指定できる文字列を次に示します。

One

Many

┃

┃

┃

┃

┃

┃

┣

┃

┃

<cascade-delete>

0または1回

ejb2の削除時にejb1の自動削除をするかどうかの指定。※3

ejb2のmultiplicityがoneの場合に有効です。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<ejb-name>

1回

ejb1の名称。※3

指定できる文字列は，EJB-JAR中に存在するCMP2.0 Entity BeanのEJB名（<ejb-name>タグの値）です。

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<cmr-field-name>

1回

ejb2のインスタンスを取得するCMRフィールド。※3

指定できる値は，「No EJB Name」または<ejb name>で指定したEJBが持つCMRフィールドのどれかです。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<cmr-field-type>

0または1回

CMRフィールド用メソッドの戻り値の型。※3

表示される値は，<cmr-field-name>で指定したaccessメソッドの戻り値です。

「java.util.Collection」または「java.util.Set」の場合は，そのまま表示します。それ以外の場合は空文字です。

┃

┗

<ejb2>

1回

ejb1に対するejb2の関連情報。※3

┃

┣

<description>※1

0回以上※2

ejb2の説明。※3

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<ejb-relationship-role-name>

0または1回

リレーションシップロール名。※3

二つのCMP EntityBean間のリレーションシップ定義中では，それぞれ一意な名称を指定します。別リレーションシップ定義では，同じ名称であっても指定できます。

┃

┃

┃┃

┣

┃

┃

┃

<multiplicity>

1回

ejb2のインスタンスの多重度。※3

指定できる文字列を次に示します。

One

Many

┃

┃

┣

┃

<cascade-delete>

0または1回

ejb1の削除時にejb2の自動削除をするかどうかの指定。※3

ejb1のmultiplicityがoneの場合に有効です。

┃

┃

┃

┣

┃

┃

<ejb-name>

1回

Ejb2の名称。※3

指定できる文字列は，EJB-JAR中に存在するCMP2.0 Entity BeanのEJB名（<ejb-name>タグの値）です。

┃

┃

┃

┃

┣

┃

┃

┃

<cmr-field-name>

1回

ejb2のインスタンスを取得するCMRフィールド。※3

指定できる値は，「No EJB Name」または<ejb name>で指定したEJBが持つCMRフィールドのどれかです。

┃

┃

┃

┃

┃

┗

<cmr-field-type>

0または1回

CMRフィールド用メソッドの戻り値の型。※3

表示される値は，<cmr-field-name>で指定したaccessメソッドの戻り値。

「java.util.Collection」または「java.util.Set」の場合は，そのまま表示。それ以外の場合は空文字。

┣

┃

┃

<security-role>

0回以上

セキュリティロールについての定義。

EJB2.1以前の場合に設定できます。EJB3.0以降の場合は設定できません。※3

┃

┣

<description>※1

0回以上※2

security-roleの説明。※3

┃

┣

<role-name>

1回

ロール名。※3

┃

┃

┃

┗

<linked-to>

0または1回

cjaddsecコマンドで定義したロール名。

cjsetrespropコマンドでは無視されます。

設定先のEJB-JARがDD（ejb-jar.xml）を保持していない場合でも，変更できます。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<interceptor-binding>※5

0回以上

クラスレベルインターセプタおよびメソッドレベルインターセプタに関する設定。

cjsetrespropコマンドでは無視されます。

次の場合は，ワーニングメッセージ（KDJE37604-W）が出力され，先に設定された<interceptor-binding>の<interceptor-class>の値が有効になります。

<ejb-name>にワイルドカードを設定した<interceptor-binding>の指定が複数ある場合。

<ejb-name>，<named-method>およびその配下の要素すべてが一致する<interceptor-binding>の指定が複数ある場合。

また，設定先がEJB2.1以前の場合は，ワーニングメッセージ（KDJE37613-W）が出力され，設定が無視されます。

┃

┣

<description>※1

0回以上※2

interceptor-bindingの説明。

┃

┃

┃

┣

┃

┃

<ejb-name>

1回

ワイルドカード（*）またはEnterprise Beanの<ejb-name>。デフォルトインターセプタの定義の場合，ワイルドカードを指定します。

┃

┃

┣

┃

<interceptor-class>

0回以上

インターセプタのクラスの名称。

<interceptor-class>と<interceptor-order>のどちらか一つを指定します。

┃

┃

┣

┃

<interceptor-order>

1回

インターセプタの順序性またはレベルの設定。

<interceptor-class>と<interceptor-order>のどちらか一つを指定します。

┃

┃

┗

<interceptor-class>

1回以上

インターセプタのクラスの名称。

┃

┃

┃

┃

┣

┃

┃

┃

<exclude-default-interceptors>

0または1回

デフォルトインターセプタを除外するかどうかの指定。

表示される文字列を次に示します。

true（除外する場合）

false（除外しない場合）

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<exclude-class-interceptors>

0または1回

クラスインターセプタを除外するかどうかの指定。

表示される文字列を次に示します。

true（除外する場合）

false（除外しない場合）

┃

┗

<named-method>

0または1回

メソッドの定義。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<method-name>

1回

EJBのビジネスメソッドの名称。「*」を指定した場合，ワイルドカードとして扱いません。

指定したメソッドが，<ejb-name>に指定したEnterprise Beanにない場合，ワーニングメッセージ（KDJE37612-W）が出力され，指定した値が設定されます。

┃

┗

<method-params>

0または1回

メソッドの引数。

┃

┗

<method-param>

0回以上

メソッドの引数。

┣

┃

┃

┃

┃

┃

┃

┃

<application-exception>

0回以上

アプリケーション例外に関する設定。

cjsetrespropコマンドでは無視されます。

<exception-class>の値が同じ<application-exception>が複数ある場合，ワーニングメッセージ（KDJE37604-W）が出力され，先に設定された値が有効になります。

また，設定先がEJB2.1以前の場合は，ワーニングメッセージ（KDJE37613-W）が出力され，設定が無視されます。

┃

┣

<exception-class>

1回

クライアントに通知する例外クラスの名称。

┃

┃

┃

┃

┣

┃

┃

┃

<rollback>

0または1回

指定した例外が発生したとき，クライアントに通知する前にロールバックを行うかどうかの指定。

表示される文字列を次に示します。

true（ロールバックを行う）

false（ロールバックを行わない）

┃

┃

┃

┗

<inherited>

0または1回

指定したクラスのサブクラスをアプリケーション例外として扱うかどうかの指定。

例外として扱う場合true，例外として扱わない場合false。デフォルトはtrue。

┗

<ejb-client-jar>

0または1回

クライアントJARファイルの名称。※3

−

−

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

アノテーションの設定値の場合は，値の変更をしないでください。

注※4

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしないでください。

注※5

アノテーションの設定値は，属性ファイルで更新できません。属性ファイルで更新できるのは，ejb-jar.xmlに定義した情報だけです。

(2)　ejb-jar.xmlを含まない場合（EJB3.0以降）

タグ名

出現パターン

説明

<hitachi-ejb-jar-property>

1回

ルートタグ。

┣

<description>※1

0回以上※2

EJB-JARの説明。※3

┣

┃

┃

┃

┃

┃

<display-name>※1

1回以上※2

EJB-JARの表示名。※3

1≦文字列長

変更する場合，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

┣

┃

<icon>※1

0回以上※2

GUIツール上に表示されるEJB-JARのアイコンの定義。※3

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。※3

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。※3

┣

<interceptors>

0または1回

インターセプタの設定。※4

┃

┣

<description>※1

0回以上※2

interceptorsの説明。※4

┃

┗

<interceptor>

1回以上

インターセプタクラスの設定。※4

┃

┣

<description>※1

0回以上※2

interceptor-classの説明。※4

┃

┣

<interceptor-class>

1回

インターセプタクラスの名称。※4

┃

┃

┣

┃

<around-invoke>

0回以上

インターセプタのaroundinvokeメソッドの定義。※4

┃

┃

┃

┃

┣

┃

<class>

0または1回

インターセプタのaroundinvokeメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┃

┃

┗

<method-name>

1回

インターセプタのaroundinvokeメソッドの名称。※4

┃

┃

┣

┃

<post-construct>

0回以上

インターセプタのpost-constructメソッドの定義。※4

┃

┃

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

インターセプタのpost-constructメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┃

┃

┗

<lifecycle-callback-method>

1回

インターセプタのpost-constructメソッド名を表示。※4

┃

┃

┣

┃

<pre-destroy>

0回以上

インターセプタのpre-destroyメソッドの定義。※4

┃

┃

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

インターセプタのpre-destroyメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┃

┃

┗

<lifecycle-callback-method>

1回

インターセプタのpre-destroyメソッド名を表示。※4

┃

┃

┣

┃

<post-activate>

0回以上

インターセプタのpost-activateメソッドの定義。※4

┃

┃

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

インターセプタのpost-activateメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┃

┃

┗

<lifecycle-callback-method>

1回

インターセプタのpost-activateメソッド名を表示。※4

┃

┃

┗

<pre-passivate>

0回以上

インターセプタのpre-passivateメソッドの定義。※4

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

インターセプタのpre-passivateメソッドが存在するクラスをパッケージ名から表示。※4

┃

┃

┗

<lifecycle-callback-method>

1回

インターセプタのpre-passivateメソッド名を表示。※4

┣

┃

┃

┃

┃

┃

<interceptor-binding>

0回以上

クラスレベルインターセプタおよびメソッドレベルインターセプタに関する設定を表示します。cjsetrespropでは無視されます。※5

<ejb-name>にワイルドカード（*）を設定した<interceptor-binding>の指定が複数ある場合，ワーニングメッセージ（KDJE37604-W）を出力し，先に設定された<interceptor-binding>の<interceptor-class>の値が有効となります。

┃

┃

┃

┣

┃

┃

<description>※1

0回以上

interceptor-bindingの説明を表示します。デフォルトインターセプタに関する定義の場合interceptor-bindingの説明を記述します。

┃

┃

┃

┣

┃

┃

<ejb-name>

1回

ワイルドカード(*)，またはEnterprise Beanの<ejb-name>を表示。デフォルトインターセプタに関する定義の場合，ワイルドカード(*)を記述。

┃

┃

┃

┃

┣

┃

┃

┃

<interceptor-class>

0回以上

インターセプタのクラス名を表示。デフォルトインターセプタに関する定義の場合。インターセプタクラスのクラス名を記述。

<interceptor-order>を指定した場合は不要です。

┃

┃

┃

┣

┃

┃

<interceptor-order>

0回以上

インターセプタの順序性およびレベルについての設定を表示。

<interceptor-class>を指定した場合は不要です。※4

┃

┃

┗

<interceptor-class>

1回以上

インターセプタのクラス名を表示。※4

┃

┃

┣

┃

<exclude-default-interceptors>

0または1回

デフォルトインターセプタを除外するかどうかを表示。除外する場合true，除外しない場合false。デフォルトはfalse。※4

┃

┃

┣

┃

<exclude-class-interceptors>

0または1回

クラスインターセプタを除外するかどうかを表示。除外する場合true，除外しない場合false。デフォルトはfalse。※4

┃

┗

<named-method>

0または1回

メソッドの定義を表示。

┃

┣

<method-name>

1回

メソッド名を表示。※4

┃

┗

<method-params>

0または1回

メソッドの引数を表示。※4

┃

┗

<method-param>

0回以上

メソッドの引数を表示。※4

┣

<application-exception>

0回以上

アプリケーション例外に関する設定を表示。※4

┃

┣

<exception-class>

1回

クライアントに通知する例外クラス名を表示。※4

┃

┃

┃

┣

┃

┃

<rollback>

0または1回

指定した例外が発生したとき，クライアントに通知する前にロールバックを行うかどうかを表示。ロールバックを行う場合true，ロールバックを行わない場合false。デフォルトはfalse。※4

┃

┃

┃

┗

<inherited>

0または1回

指定したクラスのサブクラスをアプリケーション例外として扱うかどうかの指定。

例外として扱う場合true，例外として扱わない場合false。デフォルトはtrue。※4

┗

<ejb-client-jar>

0または1回

クライアントJARファイル名を表示。

−

−

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

アノテーションの設定値の場合は，値の変更をしないでください。

注※4

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしないでください。

注※5

デフォルトインターセプタに関する定義（<ejb-name>タグの指定がワイルドカード（*）の場合）にだけ追加，変更できます。

3.3.2　DDとの対応

EJB-JAR属性ファイルとDeployment Descriptorの対応を次に示します。

(1)　EJB2.0の場合

EJB-JAR属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-ejb-jar-property>

1回

<ejb-jar>

1回

┣

<description>

0または1回

┣

<description>

0または1回

┣

<display-name>

0または1回

┣

<display-name>

0または1回

┣

<icon>

0または1回

┃

−

−

┃

┃

┣

┃

<small-icon>

0または1回

┣

┃

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┣

┃

<large-icon>

0または1回

┃

−

−

┣

<enterprise-beans>

1回

┃

−

−

┃

(省略)

−

┣

┃

<relationships>

0または1回

┣

┃

<relationships>

0または1回

┃

┃

┣

┃

<description>

0または1回

┃

┃

┣

┃

<description>

0または1回

┃

┗

<ejb-relation>

1回以上

┃

┗

<ejb-relation>

1回以上

┃

┃

┣

┃

<description>

0または1回

┃

┃

┣

┃

<description>

0または1回

┃

┃

┣

┃

<ejb-relation-name>

0または1回

┃

┃

┣

┃

<ejb-relation-name>

0または1回

┃

┣

<ejb1>

1回

┃

┣

<ejb-relationship-role>

1回

┃

┃

┃

┃

┣

┃

<description>

0または1回

┃

┃

┃

┃

┣

┃

<description>

0または1回

┃

┃

┃

┃

┣

┃

<ejb-relationship-role-name>

0または1回

┃

┃

┃

┃

┣

┃

<ejb-relationship-role-name>

0または1回

┃

┃

┣

<multiplicity>

1回

┃

┃

┣

<multiplicity>

1回

┃

┃

┃

┃

┣

┃

<cascade-delete>

0または1回

┃

┃

┃

┃

┣

┃

<cascade-delete>

0または1回

┃

┃

┃

−

−

┃

┃

┣

<relationship-role-source>

1回

┃

┃

┃

−

−

┃

┃

┃

┣

<description>

0回以上

┃

┃

┣

<ejb-name>

1回

┃

┃

┃

┗

<ejb-name>

1回

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┗

<cmr-field>

0または1回

┃

┃

┃

−

−

┃

┃

┣

<description>

0回以上

┃

┃

┣

<cmr-field-name>

1回

┃

┃

┣

<cmr-field-name>

1回

┃

┃

┃

┃

┗

<cmr-field-type>

0または1回

┃

┃

┃

┃

┗

<cmr-field-type>

0または1回

┃

┗

<ejb2>

1回

┃

┗

<ejb-relationship-role>

1回

┃

┃

┣

┃

<description>

0または1回

┃

┃

┣

┃

<description>

0または1回

┃

┃

┣

┃

<ejb-relationship-role-name>

0または1回

┃

┃

┣

┃

<ejb-relationship-role-name>

0または1回

┃

┣

<multiplicity>

1回

┃

┣

<multiplicity>

1回

┃

┃

┣

┃

<cascade-delete>

0または1回

┃

┃

┣

┃

<cascade-delete>

0または1回

┃

┃

−

−

┃

┣

<relationship-role-source>

1回

┃

┃

−

−

┃

┃

┣

<description>

0回以上

┃

┣

<ejb-name>

1回

┃

┃

┗

<ejb-name>

1回

┃

┃

┃

┃

−

−

┃

┃

┗

<cmr-field>

0または1回

┃

┃

−

−

┃

┣

<description>

0回以上

┃

┣

<cmr-field-name>

1回

┃

┣

<cmr-field-name>

1回

┃

┃

┗

<cmr-field-type>

0または1回

┃

┃

┗

<cmr-field-type>

0または1回

┃

┃

−

−

┣

┃

<assembly-descriptor>

0または1回

┣

<security-role>

0回以上

┃

┣

<security-role>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┃

┗

<role-name>

1回

┃

┃

┗

<linked-to>

0または1回

┃

┃

┃

┃

−

−

┃

−

−

┃

(省略)

−

┗

<ejb-client-jar>

0または1回

┗

<ejb-client-jar>

0または1回

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

(2)　EJB2.1の場合

EJB-JAR属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-ejb-jar-property>

1回

<ejb-jar>

1回

┣

<description>

0回以上

┣

<description>

0回以上

┣

<display-name>

1回以上

┣

<display-name>

0回以上

┣

<icon>

0回以上

┣

<icon>

0回以上

┃

┃

┣

┃

<small-icon>

0または1回

┃

┃

┣

┃

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

−

−

┣

<enterprise-beans>

1回

┃

−

−

┃

(省略)

−

┣

┃

<relationships>

0または1回

┣

┃

<relationships>

0または1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┗

<ejb-relation>

1回以上

┃

┗

<ejb-relation>

1回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

┃

<ejb-relation-name>

0または1回

┃

┃

┣

┃

<ejb-relation-name>

0または1回

┃

┣

<ejb1>

1回

┃

┣

<ejb-relationship-role>

1回

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┃

┃

┣

┃

<ejb-relationship-role-name>

0または1回

┃

┃

┃

┃

┣

┃

<ejb-relationship-role-name>

0または1回

┃

┃

┣

<multiplicity>

1回

┃

┃

┣

<multiplicity>

1回

┃

┃

┃

┃

┣

┃

<cascade-delete>

0または1回

┃

┃

┃

┃

┣

┃

<cascade-delete>

0または1回

┃

┃

┃

−

−

┃

┃

┣

<relationship-role-source>

1回

┃

┃

┃

−

−

┃

┃

┃

┣

<description>

0回以上

┃

┃

┣

<ejb-name>

1回

┃

┃

┃

┗

<ejb-name>

1回

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┗

<cmr-field>

0または1回

┃

┃

┃

−

−

┃

┃

┣

<description>

0回以上

┃

┃

┣

<cmr-field-name>

1回

┃

┃

┣

<cmr-field-name>

1回

┃

┃

┃

┃

┗

<cmr-field-type>

0または1回

┃

┃

┃

┃

┗

<cmr-field-type>

0または1回

┃

┗

<ejb2>

1回

┃

┗

<ejb-relationship-role>

1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

┃

<ejb-relationship-role-name>

0または1回

┃

┃

┣

┃

<ejb-relationship-role-name>

0または1回

┃

┣

<multiplicity>

1回

┃

┣

<multiplicity>

1回

┃

┃

┣

┃

<cascade-delete>

0または1回

┃

┃

┣

┃

<cascade-delete>

0または1回

┃

┃

−

−

┃

┣

<relationship-role-source>

1回

┃

┃

−

−

┃

┃

┣

<description>

0回以上

┃

┣

<ejb-name>

1回

┃

┃

┗

<ejb-name>

1回

┃

┃

┃

┃

−

−

┃

┃

┗

<cmr-field>

0または1回

┃

┃

−

−

┃

┣

<description>

0回以上

┃

┣

<cmr-field-name>

1回

┃

┣

<cmr-field-name>

1回

┃

┃

┗

<cmr-field-type>

0または1回

┃

┃

┗

<cmr-field-type>

0または1回

┃

┃

−

−

┣

┃

<assembly-descriptor>

0または1回

┣

<security-role>

0回以上

┃

┣

<security-role>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┃

┗

<role-name>

1回

┃

┃

┗

<linked-to>

0または1回

┃

┃

┃

┃

−

−

┃

−

−

┃

(省略)

−

┗

<ejb-client-jar>

0または1回

┗

<ejb-client-jar>

0または1回

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

(3)　EJB3.0の場合

EJB-JAR属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-ejb-jar-property>

1回

<ejb-jar>

1回

┣

<description>

0回以上

┃

−

−

┣

<display-name>

1回以上

┣

<display-name>

−

┣

<icon>

0回以上

┃

−

−

┃

┣

<small-icon>

0または1回

┃

−

−

┃

┗

<large-icon>

0または1回

┃

−

−

┃

−

−

┣

<enterprise-beans>

1回

┃

−

−

┃

(省略)

−

┣

<interceptors>

0または1回

┃

−

−

┃

┣

<description>

0回以上

┃

−

−

┃

┗

<interceptor>

1回以上

┃

−

−

┃

┣

<description>

0回以上

┃

−

−

┃

┣

<interceptor-class>

1回

┃

−

−

┃

┣

<around-invoke>

0回以上

┃

−

−

┃

┃

┣

<class>

0または1回

┃

−

−

┃

┃

┗

<method-name>

1回

┃

−

−

┃

┣

<post-construct>

0回以上

┃

−

−

┃

┃

┣

<lifecycle-callback-class>

0または1回

┃

−

−

┃

┃

┗

<lifecycle-callback-method>

1回

┃

−

−

┃

┣

<pre-destroy>

0回以上

┃

−

−

┃

┃

┣

<lifecycle-callback-class>

0または1回

┃

−

−

┃

┃

┗

<lifecycle-callback-method>

1回

┃

−

−

┃

┣

<post-activate>

0回以上

┃

−

−

┃

┃

┣

<lifecycle-callback-class>

0または1回

┃

−

−

┃

┃

┗

<lifecycle-callback-method>

1回

┃

−

−

┃

┗

<pre-passivate>

0回以上

┃

−

−

┃

┣

<lifecycle-callback-class>

0または1回

┃

−

−

┃

┗

<lifecycle-callback-method>

1回

┃

−

−

┃

−

−

┣

<assembly-descriptor>

0または1回

┣

<interceptor-binding>

0回以上

┃

┣

<interceptor-binding>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<ejb-name>

1回

┃

┃

┣

<ejb-name>

1回

┃

┣

<interceptor-class>※

0回以上

┃

┃

┗

<interceptor-class>※

1回以上

┃

┣

<interceptor-order>※

1回

┃

┣

<interceptor-order>

1回

┃

┃

┗

<interceptor-class>

1回以上

┃

┃

┗

<interceptor-class>

1回以上

┃

┣

<exclude-default-interceptors>

0または1回

┃

┣

<exclude-default-interceptors>

0または1回

┃

┣

<exclude-class-interceptors>

0または1回

┃

┣

<exclude-class-interceptors>

0または1回

┃

┗

<named-method>

0または1回

┃

┗

<named-method>

0または1回

┃

┣

<method-name>

1回

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┗

<method-param>

0回以上

┣

<application-exception>

0回以上

┣

<application-exception>

0回以上

┃

┣

<exception-class>

1回

┃

┣

<exception-class>

1回

┃

┗

<rollback>

0または1回

┃

┗

<rollback>

0または1回

┃

−

−

┃

(省略)

−

┗

<ejb-client-jar>

0または1回

┗

<ejb-client-jar>

0または1回

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<interceptor-class>と<interceptor-order>のどちらか一つを指定します。

(4)　EJB3.1の場合

EJB-JAR属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-ejb-jar-property>

1回

<ejb-jar>

1回

┣

<description>

0回以上

┃

−

−

┣

<display-name>

1回以上

┣

<display-name>

−

┣

<icon>

0回以上

┃

−

−

┃

┣

<small-icon>

0または1回

┃

−

−

┃

┗

<large-icon>

0または1回

┃

−

−

┃

−

−

┣

<enterprise-beans>

1回

┃

−

−

┃

(省略)

−

┣

<interceptors>

0または1回

┃

−

−

┃

┣

<description>

0回以上

┃

−

−

┃

┗

<interceptor>

1回以上

┃

−

−

┃

┣

<description>

0回以上

┃

−

−

┃

┣

<interceptor-class>

1回

┃

−

−

┃

┣

<around-invoke>

0回以上

┃

−

−

┃

┃

┣

<class>

0または1回

┃

−

−

┃

┃

┗

<method-name>

1回

┃

−

−

┃

┣

<post-construct>

0回以上

┃

−

−

┃

┃

┣

<lifecycle-callback-class>

0または1回

┃

−

−

┃

┃

┗

<lifecycle-callback-method>

1回

┃

−

−

┃

┣

<pre-destroy>

0回以上

┃

−

−

┃

┃

┣

<lifecycle-callback-class>

0または1回

┃

−

−

┃

┃

┗

<lifecycle-callback-method>

1回

┃

−

−

┃

┣

<post-activate>

0回以上

┃

−

−

┃

┃

┣

<lifecycle-callback-class>

0または1回

┃

−

−

┃

┃

┗

<lifecycle-callback-method>

1回

┃

−

−

┃

┗

<pre-passivate>

0回以上

┃

−

−

┃

┣

<lifecycle-callback-class>

0または1回

┃

−

−

┃

┗

<lifecycle-callback-method>

1回

┃

−

−

┃

−

−

┣

<assembly-descriptor>

0または1回

┣

<interceptor-binding>

0回以上

┃

┣

<interceptor-binding>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<ejb-name>

1回

┃

┃

┣

<ejb-name>

1回

┃

┣

<interceptor-class>※

0回以上

┃

┃

┗

<interceptor-class>※

1回以上

┃

┣

<interceptor-order>※

1回

┃

┣

<interceptor-order>

1回

┃

┃

┗

<interceptor-class>

1回以上

┃

┃

┗

<interceptor-class>

1回以上

┃

┣

<exclude-default-interceptors>

0または1回

┃

┣

<exclude-default-interceptors>

0または1回

┃

┣

<exclude-class-interceptors>

0または1回

┃

┣

<exclude-class-interceptors>

0または1回

┃

┗

<named-method>

0または1回

┃

┗

<named-method>

0または1回

┃

┣

<method-name>

1回

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┗

<method-param>

0回以上

┣

<application-exception>

0回以上

┣

<application-exception>

0回以上

┃

┣

<exception-class>

1回

┃

┣

<exception-class>

1回

┃

┣

┃

<rollback>

0または1回

┃

┣

<rollback>

0または1回

┃

┗

<inherited>

0または1回

┃

┗

<inherited>

0または1回

−

−

┃

(省略)

−

┗

<ejb-client-jar>

0または1回

┗

<ejb-client-jar>

0または1回

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<interceptor-class>と<interceptor-order>のどちらか一つを指定します。

3.3.3　cosminexus.xmlとの対応

EJB-JAR属性ファイルとcosminexus.xmlの対応を次に示します。

EJB-JAR属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

┃

−

−

┗

<ejb-jar>

0回以上

┃

−

−

┣

<module-name>※1

1回

┣

<security-role>

0回以上

┗

<security-role>

0回以上

┃

┣

<description>

0回以上

┃

−

−

┃

┣

<role-name>

1回

┣

<role-name>

1回

┃

┗

<linked-to>

0または1回

┗

<linked-to>※2

1回

┣

<interceptor-binding>

0回以上

−

−

┃

┣

<description>

0回以上

−

−

┃

┣

<ejb-name>

1回

−

−

┃

┗

<interceptor-class>

0回以上

−

−

（省略）

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

注※1

application.xmlの<application>-<module>-<ejb>に対応し，属性ファイルには存在しないcosminexus.xml独自のタグとなります。EJB-JARを特定するためのキーとなります。

注※2

cosminexus.xmlは，カスタマイズしたい要素だけを記述する形式となるため，属性ファイルと出現パターンが異なります。

3.4　Session Bean属性ファイル

Session Bean属性ファイルは，Session Beanの属性を取得，編集する場合に使用するファイルです。

3.4.1　Session Bean属性ファイルの指定内容

Session Bean属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-session-bean-property PUBLIC '-//Hitachi, Ltd.//DTD Session Bean Property 9.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-session-bean-property_9_0.dtd'>

Session Bean属性ファイルは，次に示すタグを持つxmlファイルです。

なお，設定先のEJB-JARがDD（ejb-jar.xml）を保持していない場合，Session Bean属性ファイルのタグは変更できません。また，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名の欄にあるマニュアルの参照先には，そのタグの関連情報があります。マニュアル名に「アプリケーションサーバ」と記載されたマニュアルについては，名称を省略しています。

タグ名

出現パターン

説明

<hitachi-session-bean-property>

1回

ルートタグ。

┣

<description>※1

0回以上※2

Session Beanの説明。※4，※8

┣

┃

┃

┃

┃

┃

┃

┃

<display-name>※1

1回以上※2

Session Beanの表示名。※4

xml:lang属性が"en"のdisplay-nameを必ず指定します。該当するリソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。

1≦文字列長

指定できる文字の制限はありません。

文字列の先頭または末尾に，半角スペースや改行がある場合は，取り除かれて設定されます。

┣

┃

<icon>※1

0回以上※2

GUIツール上に表示されるSession Beanのアイコンの定義。※4，※8

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。※4，※8

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。※4，※8

┣

┃

┃

┃

┃

┃

┃

<mapped-name>

0または1回

@Stateless，@Stateful，または@SingletonのmappedName属性に設定されているEnterprise Beanの別名。

<optional-name>タグまたは<local-optional-name>タグで別名が設定されている場合は，<optional-name>タグまたは<local-optional-name>タグに設定されている値が優先されます。

<optional-name>タグまたは<local-optional-name>タグに別名が設定されていない場合，デフォルトの別名として使用されます。※3，※8

┣

<business-local>

0回以上

ローカルビジネスインタフェースを指定。※3，※4

┣

<business-remote>

0回以上

リモートビジネスインタフェースを指定。※3，※4，※8

┣

┃

┃

┃

┃

<session-type>

1回

Session Beanの種別。※3，※4，※8

指定できる文字列を次に示します。

Stateful

Stateless

Singleton

┣

<around-invoke>

0回以上

around-invokeメソッドの定義。※3，※4，※8

┃

┃

┣

┃

<class>

0または1回

aroundinvokeメソッドが存在するクラスをパッケージ名から表示。※3，※4，※8

┃

┗

<method-name>

1回

around-invokeメソッドの名称。※3，※4，※8

┣

<post-construct>

0回以上

post-constructメソッドの設定。※3，※4，※8

┃

┣

<lifecycle-callback-class>

0または1回

post-constructメソッドが存在するクラスをパッケージ名から表示。※3，※4，※8

┃

┗

<lifecycle-callback-method>

1回

post-constructメソッド名を表示。※3，※4，※8

┣

<pre-destroy>

0回以上

pre-destroyメソッドの設定。※3，※4，※8

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

pre-destroyメソッドが存在するクラスをパッケージ名から表示。※3，※4

┃

┗

<lifecycle-callback-method>

1回

pre-destroyメソッド名を表示。※3，※4，※8

┣

┃

<post-activate>

0回以上

post-activateメソッドの設定。※3，※4，※8

session-typeがStatefulの場合だけ表示されます。

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

post-activateメソッドが存在するクラスをパッケージ名から表示。※3，※4，※8

┃

┗

<lifecycle-callback-method>

1回

post-activateメソッド名を表示。※3，※4，※8

┣

┃

<pre-passivate>

0回以上

pre-passivateメソッドの設定。※3，※4，※8

session-typeがStatefulの場合だけ表示されます。

┃

┃

┣

┃

<lifecycle-callback-class>

0または1回

pre-passivateメソッドが存在するクラスをパッケージ名から表示。※3，※4，※8

┃

┗

<lifecycle-callback-method>

1回

pre-passivateメソッド名を表示。※3，※4，※8

┣

┃

┃

<timeout-method>

0または1回

timeoutメソッドの設定。※3，※4，※8

session-typeがStatelessまたはSingletonの場合だけ表示されます。

┃

┣

<method-name>

1回

timeoutメソッドの名称。※3，※4，※8

┃

┗

<method-params>

0または1回

timeoutメソッドの引数。※3，※4，※8

┃

┗

<method-param>

0回以上

timeoutメソッドの引数。※3，※4，※8

┣

┃

<init-method>

0回以上

initメソッドの設定。※3，※4，※8

session-typeがStatefulの場合だけ表示されます。

┃

┣

<create-method>

1回

createメソッドの設定。※3，※4，※8

┃

┃

┣

<method-name>

1回

createメソッドの名称。※3，※4，※8

┃

┃

┗

<method-params>

0または1回

createメソッドの引数。※3，※4，※8

┃

┃

┗

<method-param>

0回以上

createメソッドの引数。※3，※4，※8

┃

┗

<bean-method>

1回

beanメソッドの設定。※3，※4，※8

┃

┣

<method-name>

1回

beanメソッドの名称。※3，※4，※8

┃

┗

<method-params>

0または1回

beanメソッドの引数。※3，※4，※8

┃

┗

<method-param>

0回以上

beanメソッドの引数。※3，※4，※8

┣

┃

<remove-method>

0回以上

removeメソッドの設定。※3，※4，※8

session-typeがStatefulの場合だけ表示されます。

┃

┣

<bean-method>

1回

beanメソッドの設定。※3，※4，※8

┃

┃

┣

<method-name>

1回

beanメソッドの名称。※3，※4，※8

┃

┃

┗

<method-params>

0または1回

beanメソッドの引数。※3，※4，※8

┃

┃

┗

<method-param>

0回以上

beanメソッドの引数。※3，※4，※8

┃

┃

┃

┃

┃

┗

<retain-if-exception>

1回

アプリケーション例外で異常終了した場合に除去されるかどうかの指定。※3，※4，※8

表示される文字列を次に示します。

true（除去されない）

false（除去される）

┣

┃

┃

┃

<transaction-type>

1回

トランザクション管理種別。※4，※8

指定できる文字列を次に示します。

Bean

Container

┣

<env-entry>

0回以上

環境エントリについての定義。※4，※8

┃

┣

<description>※1

0回以上※2

env-entryの説明。※4，※8

┃

┣

<env-entry-name>

1回

環境エントリの名称。※4，※8

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<env-entry-type>

1回

環境エントリのデータ型。※4，※8

指定できる文字列を次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

java.lang.Character

┃

┃

┃

┣

┃

┃

<env-entry-value>

1回

環境エントリの値。※4，※8

env-entry-typeで指定した型に適合した値を指定します。env-entry-typeにjava.lang.String以外を指定した場合，空文字は指定できません。

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※3，※4，※8

┃

┃

┣

┃

<injection-target-class>

1回

injectionの対象となるクラスの名称。※3，※4，※8

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※3，※4，※8

┣

┃

<ejb-ref>

0回以上

リモートインタフェースを持つEnterprise Beanへの参照情報についての定義。※4，※8

┃

┣

<description>※1

0回以上※2

ejb-refの説明。※4，※8

┃

┣

<ejb-ref-name>

1回

ejb-refの名称。※4，※8

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

1回

リンク先EJBの種別。※4，※8

指定できる文字列を次に示します。

Entity

Session

┃

┣

<home>

1回

リンク先のホームインタフェースクラスの名称。※4，※8

┃

┣

<remote>

1回

リンク先のコンポーネントインタフェースクラスの名称。※4，※8

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-link>

0または1回

リンク先のejb-name。※4，※8

ネーミングの切り替え機能でリンク先を設定する場合，次の形式で指定します。

corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBHomeオブジェクトリファレンスのJNDI名>

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※3，※4，※8

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラスの名称。※3，※4，※8

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※3，※4，※8

┣

<ejb-local-ref>

0回以上

EJB参照情報の設定。※4，※8

┃

┣

<description>※1

0回以上※2

ejb-local-refの説明。※4，※8

┃

┣

<ejb-ref-name>

1回

ejb-local-refの名称。※4，※8

┃┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

1回

リンク先EJBの種別。※4，※8

指定できる文字列を次に示します。

Session

Entity

┃

┣

<local-home>

1回

リンク先のホームインタフェースクラスの名称。※4，※8

┃

┣

<local>

1回

リンク先のコンポーネントインタフェースクラスの名称。※4，※8

┃

┣

<ejb-link>

0または1回

リンク先のejb-name。※4，※8

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※3，※4，※8

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラスの名称。※3，※4，※8

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※3，※4，※8

┣

<security-role-ref>

0回以上

セキュリティロールについての定義。※4

┃

┣

<description>※1

0回以上※2

security-role-refの説明。※4，※8

┃

┣

<role-name>

1回

security-role-refの名称。※4，※8

┃

┗

<role-link>

0または1回

リンク先のセキュリティロール名。※4，※8

┣

<security-identity>

0または1回

セキュリティアイデンティティについての定義。※4，※8

┃

┣

<description>※1

0回以上※2

security-identityの説明。※4，※8

┃

┃

┃

┣

┃

┃

<use-caller-identity>

1回

実行時security-identityを使用するかどうかの指定。※4，※8

<use-caller-identity>と<run-as>のどちらか一つを指定します。なお，このタグは値を持ちません。

┃

┃

┃

┗

<run-as>

1回

実行時security-identityの定義情報。※4，※8

<use-caller-identity>と<run-as>のどちらか一つを指定します。

┃

┃

┃

┣

┃

┃

<description>※1

0回以上※2

実行時security-identityの説明。※4，※8

<run-as>を指定した場合だけ活性状態になります。

┃

┃

┣

┃

<role-name>

1回

実行時security-identityのroleの名称。※4，※8

<run-as>を指定した場合だけ活性状態になります。

┃

┗

<user-name>

1回

プリンシパル名。※5

┣

<resource-ref>

0回以上

リソース参照についての定義。※4，※8

┃

┣

<description>※1

0回以上※2

resource-refの説明。※4，※8

┃

┣

<res-ref-name>

1回

resource-refの名称。※4，※8

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<res-type>

1回

リソース種別。※4，※8

指定可能な文字列は以下のとおり。

javax.mail.Session

javax.sql.DataSource

javax.jms.QueueConnectionFactory

javax.jms.ConnectionFactory

javax.resource.cci.ConnectionFactory

org.omg.CORBA_2_3.ORB（DDで定義しなくてもlookupできるリソース）

javax.jms.TopicConnectionFactory

参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子(<connectionfactory-interface>タグの設定値)を指定します。

┃

┃

┃

┃

┣

┃

┃

┃

<res-auth>

1回

認証方式。※4，※8

指定できる文字列を次に示します。

Application

Container

┃

┃

┃

┃

┣

┃

┃

┃

<res-sharing-scope>

0または1回

参照したリソースを共有するかどうかの指定。※4，※8

指定できる文字列を次に示します。

Shareable

Unshareable

┃

┃

┃

┃

┣

┃

┃

┃

<mapped-name>

0または1回

@ResourceのmappedName属性に設定されている，対応するリソースアダプタ表示名またはメール表示名。※3，※4，※8

<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┣

<injection-target>

0回以上

Dependency Injectionの設定。※3，※4，※8

┃

┃

┃

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラスの名称。※3，※4，※8

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※3，※4，※8

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

0または1回

対応するリソースアダプタ表示名，データソース表示名，またはメール表示名。※5

リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

cjsetrespropでは無視されます。

┣

<resource-env-ref>

0回以上

リソース環境変数についての定義。※4，※8

┃

┣

<description>※1

0回以上※2

resource-env-refの説明。※4，※8

┃

┣

<resource-env-ref-name>

1回

resource-env-refの名称。※4，※8

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<resource-env-ref-type>

1回

リソース環境変数の値のクラスタイプを指定します。※4，※8

指定できる文字列を次に示します。

javax.jms.Queue

javax.jms.Topic

javax.transaction.UserTransaction

javax.ejb.TimerService

javax.ejb.EJBContext

javax.ejb.SessionContext

JavaBeansリソースのクラスの名称

javax.transaction.UserTransaction，javax.ejb.TimerService，javax.ejb.EJBContext，javax.ejb.SessionContextの値は，アノテーションを使用した場合にだけ出力されます。ただし，この値を設定することはできません。

<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

<mapped-name>

0または1回

<resource-env-ref-type>が「javax.jms.Queue」の場合，@ResourceのmappedName属性に設定されている，対応するキューを次の形式で表示します。

"<リソースアダプタの表示名>#<Queue名称>"

<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。

<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，@ResourceのmappedName属性に設定されている，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。※3，※4，※8

┃

┣

<injection-target>

0回以上

Dependency Injectionの設定。※3，※4，※8

┃

┃

┃

┃

┣

┃

<injection-target-class>

1回

injectionの対象となるクラスの名称。※3，※4，※8

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※3，※4，※8

┃

┃

┃

┣

┃

┃

<linked-queue>

0または1回

queue名称。※5

cjsetrespropでは無視されます。

<resource-env-ref-type>が「javax.jms.Queue」の場合だけ有効となります。

┃

┃

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。※5

Connector1.5のリソースアダプタは指定できません。

┃

┃

┗

<queue>

1回

キューの表示名を指定します。※5

┃

┃

┣

┃

<linked-adminobject>

0または1回

管理対象オブジェクト。

cjsetrespropでは無視されます。

┃

┃

┃

┃

┣

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

Connector1.0以前のリソースアダプタは指定できません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続した名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

┃

┃

┃

┗

<linked-to>

0または1回

JavaBeansリソースの表示名。※5

<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合だけ有効となります。

cjsetrespropでは無視されます。

┣

<method-permission>

0回以上

メソッドパーミッションについての定義。※4，※8

┃

┣

<description>※1

0回以上※2

method-permissionの説明。※4，※8

┃

┃

┃

┣

┃

┃

<role-name>

1回以上

メソッドに割り当てるロール名。※4，※8

<role-name>と<unchecked>のどちらか一つを指定します。

┃

┃

┃

┃

┣

┃

┃

┃

<unchecked>

1回

メソッド実行時の認証チェック。※4，※8

このタグを使用する場合，認証チェックはしません。

なお，このタグは値を持ちません。

<role-name>と<unchecked>のどちらか一つを指定します。

┃

┗

<method>

1回以上

メソッドについての定義。※4，※8

┃

┣

<description>※1

0回以上※2

メソッドの説明。※4，※8

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。※4，※8

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┣

┃

<method-name>

1回

メソッド名。※4，※8

*を指定した場合，すべてのメソッドを表します。

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

method-nameが*以外の場合に有効。※4，※8

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

パラメタのデータ型。※4，※8

プリミティブ型またはクラスの名称を指定します。

配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにします）。

多次元配列の場合は[]を続けて指定します（]と[の間を空けてはいけません）。

配列の内部形式名（int[]の場合は[I，java.lang.String[]の場合は[Ljava.lang.String;）は指定できません。

例

int

short[][]

java.lang.String[]

┣

<container-transaction>

0回以上

コンテナのトランザクションについての定義。※4，※8

┃

┣

<description>※1

0回以上※2

container-transactionの説明。※4，※8

┃

┣

<method>

1回以上

メソッドについての定義。※4，※8

┃

┃

┣

<description>※1

0回以上※2

メソッドの説明。※4，※8

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。※4，※8

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┃

┃

┣

┃

<method-name>

1回

メソッド名。※4，※7，※8

*を指定した場合，すべてのメソッドを表します。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

method-nameが*以外の場合に有効。※4，※8

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

パラメタのデータ型。※4，※8

プリミティブ型またはクラスの名称を指定します。

配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにします）。

多次元配列の場合は[]を続けて指定します（]と[の間を空けてはいけません）。

配列の内部形式名（int[]の場合は[I，java.lang.String[]の場合は[Ljava.lang.String;）は指定できません。

例

int

short[][]

java.lang.String[]

┃

┃

┃

┃

┃

┃

┃

┃

┗

<trans-attribute>

1回

メソッドに割り当てるトランザクション属性。※4，※8

指定できる文字列を次に示します。

Mandatory

Never

NotSupported

Required

RequiresNew

Supports

┣

<exclude-list>

0または1回

呼び出しをしないメソッドのリストの定義。※4，※8

┃

┣

<description>※1

0回以上※2

exclude-listの説明。※4，※8

┃

┗

<method>

1回以上

呼び出しをしないメソッド。※4，※8

┃

┣

<description>※1

0回以上※2

呼び出しをしないメソッドの説明。※4，※8

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。※4，※8

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┣

<method-name>

1回

呼び出しを行わないメソッド名。※4，※8

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

method-nameが*以外の場合に有効。※4

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

パラメタのデータ型。※4，※8

プリミティブ型またはクラスの名称を指定します。

配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにします）。

多次元配列の場合は[]を続けて指定します（]と[の間を空けてはいけません）。

配列の内部形式名（int[]の場合は[I，java.lang.String[]の場合は[Ljava.lang.String;）は指定できません。

例

int

short[][]

java.lang.String[]

┣

┃

┃

┃

<runtime>※5

0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<lookup-name>

1回

クライアントからEJBをルックアップする場合に使う名前。※5

HITACHI_EJB/SERVERS/<サーバ名称>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。

ルックアップ名には，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定可能な文字数は1〜255文字です。0文字の場合は，タグが省略されたものと見なされます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<optional-name>

0または1回

リモートインタフェースの別名。※5

設定値は，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次の名前は指定できません。

予約語の"HITACHI_EJB"（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）だけ，またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定可能な文字数は1〜255文字です。

┃

┃

┃

┃

┣

┃

┃

┃

<local-optional-name>

0または1回

ローカルインタフェースの別名。

設定値に制限はありません。

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

┃

┃

┃

┃

┣

┃

┃

┃

<maximum-sessions>

1回

セッションの最大数。※5

0（無制限）または1≦maximum-sessions≦2147483647

Stateless Session Beanの場合，この設定値は無効です。

┃

┃

┃

┣

┃

┃

<stateless>※6

どちらか1回，またはどちらもなし

session-typeがStatelessの場合の指定。※5

<stateless>と<stateful>のどちらか一つを指定するか，またはどちらも指定しません。

┃

┃

┣

<pooled-instance>

1回

プール内のインスタンスについての定義。※5

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

<minimum>

「機能解説 基本・開発編(EJBコンテナ)」−「2.9.1」

1回

プール内のインスタンスの最小数。※5

0または1≦minimum≦maximum

maximumに上限を指定した場合，minimumにも上限を指定しなければいけません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<maximum>

「機能解説 基本・開発編(EJBコンテナ)」−「2.9.1」

1回

プール内のインスタンスの最大数。※5

0（無制限）または1≦maximum≦maximum-sessions

maximum-sessionsに上限を指定した場合，maximumにも上限を指定しなければいけません。

┃

┃

┃

┃

┃

┃

┗

<instance-timeout>

0または1回

インスタンス取得タイムアウト時間を，0〜86400（単位：秒）で指定します。※5

0を指定した場合，タイムアウトしません。デフォルト値は0です。

┃

┃

┃

┣

┃

┃

<stateful>※6

どちらか1回，またはどちらもなし

session-typeがStatefulの場合の指定。※5

<stateless>と<stateful>のどちらか一つを指定するか，またはどちらも指定しません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<maximum-active-sessions>

1回

アクティブセッションの最大数。※5

0（無制限）または1≦maximum-active-sessions≦maximum-sessions

maximum-sessionsに上限を指定した場合，maximum-active-sessionsにも上限を指定しなければいけません。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<inactivity-timeout>

1回

再びアクティブ化するまでに非アクティブ状態に保持しておく時間（分）。※5

0（無制限）または1≦inactivity-timeout≦2147483647

┃

┃

┃

┃

┃

┃

┗

<removal-timeout>

1回

セッションが削除されるまでに非アクティブ状態に保持しておく時間（分）。※5

0（無制限）または1≦removal-timeout≦2147483647

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<enable-scheduling>

「機能解説 拡張編」−「3.4」

0または1回

該当するBeanをスケジューリングの対象にするかどうか（スケジューラのGateとして使用するかどうか）の指定。※5

CTM経由で呼び出されるBeanで，statelessのMaximumの値がparallel-countの値より小さい場合エラーとなります。

なお，このタグは構成ソフトウェアにComponent Transaction Monitorを含む製品だけ有効です。それ以外の場合に指定するとエラーになります。利用できる製品については，マニュアル「アプリケーションサーバ & BPM/ESB基盤概説」の「2.2.1　製品と構成ソフトウェアの対応」を参照してください。

また，リモートコンポーネントインタフェースを提供しないEJB（コンポーネントローカルインタフェースまたはビジネスインタフェースで提供）に対しては指定できません。指定した場合は無視されます。

┃

┃

┣

┃

<pass-by-reference>

0または1回

Bean単位でのデータの参照渡し（pass by reference）を指定します。※5

┃

┃

┣

┃

<scheduling>

「機能解説 拡張編」−「3.4」

0または1回

CTM連携関連の情報。※5

Bean単位にスケジューラを配置する場合に必要です。

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<queue-name>

「機能解説 拡張編」−「3.2.5」

1回

スケジューリングを行うqueue名称。※5，※9

英数字（0〜9，A〜Z，a〜z）およびアンダースコア（_）が使用できます。デフォルト値は，ejb名（<ejb-name>タグの値）です。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<parallel-count>

「機能解説 拡張編」−「3.4」

1回

CTMがアプリケーションを呼び出すために用意するスレッド数を，1〜127の範囲で指定します。※5デフォルトは，1です。

CTM経由で呼び出されるBeanで，Maximumの値がparallel-countの値より小さい場合エラーとなります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<queue-length>

「機能解説 拡張編」−「3.4」

0または1回

スケジューリングをするキューの長さを，1〜32767の整数値で指定します。※5

キューを共有する場合，キューを共有するアプリケーション間やBean間で設定値が異なるとき，すでに生成されているキューの長さが有効になります。

┃

┃

┃

┃

┗

<front-ejb>

0または1回

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。※5フロントEJBの場合はtrueを指定し，フロントEJBでない場合はfalseを指定します。デフォルト値はfalse。

┣

┃

┃

<start-order>

0または1回

J2EEアプリケーション開始時・停止時の順番を指定します。※5開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0≦start-order≦2147483647

┣

┃

┃

┃

┃

┃

┃

<ejb-method-observation-timeout>

「機能解説 運用／監視／連携編」−「5章」

0回以上

EJBのメソッドに仕掛かり中メソッド監視用タイムアウト時間を設定する場合に指定します。※5

<ejb-method-observation-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-method-observation-timeout>の<method-observation-timeout>の値が有効になります。

┃

┣

<method>

1回以上

−※5

┃

┃

┣

<description>

0または1回

メソッドの説明。※5

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。※5

次の値が指定できます。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┃

┃

┣

┃

<method-name>

1回

対象となるメソッド名を指定します。※5，※7

*を指定した場合は，すべてのメソッドを表します。

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。※5

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定。※5

┃

┃

┃

┗

<method-observation-timeout>

1回

仕掛かり中メソッド監視用タイムアウト時間を，0〜86400（単位：秒）で指定します。※50を指定した場合，タイムアウトしません。デフォルト値は0。

┗

<ejb-transaction-timeout>

「機能解説 基本・開発編(コンテナ共通機能)」−「3.15.8」

0回以上

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。※5

<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効になります。

┣

<method>

1回以上

−※5

┃

┣

<description>

0または1回

メソッドの説明。※5

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。※5

次の値が指定できます。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┣

┃

<method-name>

1回

対象となるメソッド名を指定します。※5，※7

*を指定した場合は，すべてのメソッドを表します。

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。※5

┃

┗

<method-param>

0回以上

引数のデータ型を指定。※5

┗

<transaction-timeout>

1回

トランザクションタイムアウト時間を，0〜2147483647（単位：秒）で指定します。※5デフォルト値は0。0を指定した場合，またはタグがない場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

−

−

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※4

アノテーションの設定値の場合は，値の変更をしてはいけません。

注※5

設定先のSession Beanを含むEJB-JARがDD（ejb-jar.xml）を保持していない場合でも，変更できます。

注※6

08-70以前のバージョンの場合，statelessまたはstatefulのどちらかを指定します。

注※7

サーバ管理コマンド用のusrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleに「false」を指定している場合にこのタグで指定されたメソッドが存在しないとき，属性の設定でエラーになります。usrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleキーについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「5.2.3　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）」を参照してください。

注※8

設定先がEJB3.0以降の場合，値の変更はできません。

注※9

<hitachi-application-property><scheduling-unit>にBeanを設定していて，かつ<queue-name>を省略する場合，ejb-jar.xmlの<ejb-jar><enterprise-beans><session><ejb-name>には<queue-name>で指定可能な範囲の値を定義してください。

3.4.2　DDとの対応

Session Bean属性ファイルとDeployment Descriptorの対応を次に示します。

Session Bean属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-session-bean-property>

1回

<ejb-jar>

1回

┃

−

−

┣

<description>

0または1回

┃

−

−

┣

<display-name>

0または1回

┃

−

−

┣

<icon>

0回以上

┃

−

−

┃

┣

<small-icon>

0または1回

┃

−

−

┃

┗

<large-icon>

0または1回

┃

−

−

┣

<enterprise-beans>

1回

┃

−

−

┃

┣

<session>

1回以上

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┣

<display-name>

1回以上

┃

┃

┣

<display-name>

0回以上

┣

<icon>

0回以上

┃

┃

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回

┃

┃

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┃

┃

┗

<large-icon>

0または1回

┃

−

−

┃

┃

┣

<ejb-name>

1回

┣

<mapped-name>

0または1回

┃

┃

┃

−

−

┃

−

−

┃

┃

┣

<home>

0または1回

┃

−

−

┃

┃

┣

<remote>

0または1回

┣

<business-local>

0回以上

┃

┃

┃

−

−

┣

<business-remote>

0回以上

┃

┃

┃

−

−

┃

−

−

┃

┃

┣

<ejb-class>

1回

┣

<session-type>

1回

┃

┃

┣

<session-type>

0または1回

┣

<around-invoke>

0回以上

┃

┃

┃

−

−

┃

┣

<class>

0または1回

┃

┃

┃

−

−

┃

┗

<method-name>

1回

┃

┃

┃

−

−

┣

<post-construct>

0回以上

┃

┃

┃

−

−

┃

┣

<lifecycle-callback-class>

0または1回

┃

┃

┃

−

−

┃

┗

<lifecycle-callback-method>

1回

┃

┃

┃

−

−

┣

<pre-destroy>

0回以上

┃

┃

┃

−

−

┃

┣

<lifecycle-callback-class>

0または1回

┃

┃

┃

−

−

┃

┗

<lifecycle-callback-method>

1回

┃

┃

┃

−

−

┣

<post-activate>

0回以上

┃

┃

┃

−

−

┃

┣

<lifecycle-callback-class>

0または1回

┃

┃

┃

−

−

┃

┗

<lifecycle-callback-method>

1回

┃

┃

┃

−

−

┣

<pre-passivate>

0回以上

┃

┃

┃

−

−

┃

┣

<lifecycle-callback-class>

0または1回

┃

┃

┃

−

−

┃

┗

<lifecycle-callback-method>

1回

┃

┃

┃

−

−

┣

<timeout-method>

0または1回

┃

┃

┃

−

−

┃

┣

<method-name>

1回

┃

┃

┃

−

−

┃

┗

<method-params>

0または1回

┃

┃

┃

−

−

┃

┗

<method-param>

0回以上

┃

┃

┃

−

−

┣

<init-method>

0回以上

┃

┃

┃

−

−

┃

┣

<create-method>

1回

┃

┃

┃

−

−

┃

┃

┣

<method-name>

1回

┃

┃

┃

−

−

┃

┃

┗

<method-params>

0または1回

┃

┃

┃

−

−

┃

┃

┗

<method-param>

0回以上

┃

┃

┃

−

−

┃

┗

<bean-method>

1回

┃

┃

┃

−

−

┃

┣

<method-name>

1回

┃

┃

┃

−

−

┃

┗

<method-params>

0または1回

┃

┃

┃

−

−

┃

┗

<method-param>

0回以上

┃

┃

┃

−

−

┣

<remove-method>

0回以上

┃

┃

┃

−

−

┃

┣

<bean-method>

1回

┃

┃

┃

−

−

┃

┃

┣

<method-name>

1回

┃

┃

┃

−

−

┃

┃

┗

<method-params>

0または1回

┃

┃

┃

−

−

┃

┃

┗

<method-param>

0回以上

┃

┃

┃

−

−

┃

┗

<retain-if-exception>

0または1回

┃

┃

┃

−

−

┣

<transaction-type>

1回

┃

┃

┣

<transaction-type>

1回

┣

<env-entry>

0回以上

┃

┃

┣

<env-entry>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┣

<env-entry-name>

1回

┃

┃

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-type>

1回

┃

┃

┃

┣

<env-entry-type>

1回

┃

┣

<env-entry-value>

1回

┃

┃

┃

┗

<env-entry-value>

0または1回

┃

┗

<injection-target>

0回以上

┃

┃

┃

−

−

┃

┣

<injection-target-class>

1回

┃

┃

┃

−

−

┃

┗

<injection-target-name>

1回

┃

┃

┃

−

−

┣

<ejb-ref>

0回以上

┃

┃

┣

<ejb-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┃

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┃

┃

┣

<ejb-ref-type>

1回

┃

┣

<home>

1回

┃

┃

┃

┣

<home>

1回

┃

┣

<remote>

1回

┃

┃

┃

┣

<remote>

1回

┃

┣

<ejb-link>

0または1回

┃

┃

┃

┗

<ejb-link>

0または1回

┃

┗

<injection-target>

0回以上

┃

┃

┃

−

−

┃

┣

<injection-target-class>

1回

┃

┃

┃

−

−

┃

┗

<injection-target-name>

1回

┃

┃

┃

−

−

┣

<ejb-local-ref>

0回以上

┃

┃

┣

<ejb-local-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┃

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┃

┃

┣

<ejb-ref-type>

1回

┃

┣

<local-home>

1回

┃

┃

┃

┣

<local-home>

1回

┃

┣

<local>

1回

┃

┃

┃

┣

<local>

1回

┃

┣

<ejb-link>

0または1回

┃

┃

┃

┗

<ejb-link>

0または1回

┃

┗

<injection-target>

0回以上

┃

┃

┃

−

−

┃

┣

<injection-target-class>

1回

┃

┃

┃

−

−

┃

┗

<injection-target-name>

1回

┃

┃

┃

−

−

┣

<security-role-ref>

0回以上

┃

┃

┣

<security-role-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┃

┃

┣

<role-name>

1回

┃

┗

<role-link>

0または1回

┃

┃

┃

┗

<role-link>

0または1回

┣

<security-identity>

0または1回

┃

┃

┣

<security-identity>

0または1回

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┣

<use-caller-identity>

1回※1

┃

┃

┃

┣

<use-caller-identity>

1回※1

┃

┗

<run-as>

1回※1

┃

┃

┃

┗

<run-as>

1回※1

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┃

┃

┗

<role-name>

1回

┃

┗

<user-name>

1回

┃

┃

┃

−

−

┣

<resource-ref>

0回以上

┃

┃

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┣

<res-ref-name>

1回

┃

┃

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

1回

┃

┃

┃

┣

<res-type>

1回

┃

┣

<res-auth>

1回

┃

┃

┃

┣

<res-auth>

1回

┃

┣

<res-sharing-scope>

0または1回

┃

┃

┃

┗

<res-sharing-scope>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┃

┃

−

−

┃

┣

<injection-target>

0回以上

┃

┃

┃

−

−

┃

┃

┣

<injection-target-class>

1回

┃

┃

┃

−

−

┃

┃

┗

<injection-target-name>

1回

┃

┃

┃

−

−

┃

┗

<linked-to>

0または1回

┃

┃

┃

−

−

┣

<resource-env-ref>

0回以上

┃

┃

┗

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<resource-env-ref-name>

1回

┃

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

1回

┃

┃

┗

<resource-env-ref-type>

1回

┃

┣

<mapped-name>

0または1回

┃

┃

−

−

┃

┣

<injection-target>

0回以上

┃

┃

−

−

┃

┃

┣

<injection-target-class>

1回

┃

┃

−

−

┃

┃

┗

<injection-target-name>

1回

┃

┃

−

−

┃

┣

<linked-queue>

0または1回

┃

┃

−

−

┃

┃

┣

<resource-adapter>

1回

┃

┃

−

−

┃

┃

┗

<queue>

1回

┃

┃

−

−

┃

┗

<linked-adminobject>

0または1回

┃

┃

−

−

┃

┣

<resourceadapter-name>

1回

┃

┃

−

−

┃

┗

<adminobject-name>

1回

┃

┃

−

−

┃

(省略)

−

┃

(省略)

−

┃

−

−

┣

<assembly-descriptor>

0または1回

┃

−

−

┃

┣

<security-role>

0回以上

┃

−

−

┃

┃

┣

<description>

0回以上

┃

−

−

┃

┃

┗

<role-name>

1回

┣

<method-permission>

0回以上

┃

┣

<method-permission>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<role-name>※2

1回以上

┃

┃

┣

<role-name>※2

1回以上

┃

┣

<unchecked>※2

1回

┃

┃

┣

<unchecked>※2

1回

┃

┗

<method>

1回以上

┃

┃

┗

<method>

1回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

−

−

┃

┃

┣

<ejb-name>

1回

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-intf>

0または1回

┃

┣

<method-name>

1回

┃

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┃

┗

<method-param>

0回以上

┣

<container-transaction>

0回以上

┃

┣

<container-transaction>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<method>

1回以上

┃

┃

┣

<method>

1回以上

┃

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┃

┃

−

−

┃

┃

┃

┣

<ejb-name>

1回

┃

┃

┣

<method-intf>

0または1回

┃

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-name>

1回

┃

┃

┃

┣

<method-name>

1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-param>

0回以上

┃

┃

┃

┗

<method-param>

0回以上

┃

┗

<trans-attribute>

1回

┃

┃

┗

<trans-attribute>

1回

┣

<exclude-list>

0または1回

┃

┗

<exclude-list>

0または1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┗

<method>

1回以上

┃

┗

<method>

1回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

−

−

┃

┣

<ejb-name>

1回

┃

┣

<method-intf>

0または1回

┃

┣

<method-intf>

0または1回

┃

┣

<method-name>

1回

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┗

<method-param>

0回以上

┃

−

−

┗

<ejb-client-jar>

0または1回

┗

<runtime>

0または1回

−

−

(省略)

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<use-caller-identity>と<run-as>のどちらか一つを指定します。

注※2

<role-name>と<unchecked>のどちらか一つを指定します。

3.4.3　cosminexus.xmlとの対応

Session Bean属性ファイルとcosminexus.xmlの対応を次に示します。

Session Bean属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

<hitachi-session-bean-property>

1回

┃

┣

<session>

0回以上

┃

−

−

┃

┃

┣

<ejb-name>※1

1回

┣

<security-identity>

0または1回

┃

┃

┣

<security-identity>

0または1回

┃

┗

<run-as>

1回

┃

┃

┃

┗

<run-as>

1回

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<role-name>

1回

┃

┃

┃

┃

−

−

┃

┗

<user-name>

1回

┃

┃

┃

┗

<user-name>

1回

┣

<ejb-ref>

0回以上

┃

┃

┃

−

−

┃

┣

<description>

0回以上

┃

┃

┃

−

−

┃

┣

<ejb-ref-name>

1回

┃

┃

┃

−

−

┃

┣

<ejb-ref-type>

1回

┃

┃

┃

−

−

┃

┣

<home>

1回

┃

┃

┃

−

−

┃

┣

<remote>

1回

┃

┃

┃

−

−

┃

┗

<ejb-link>

0または1回

┃

┃

┃

−

−

┣

<resource-ref>

0回以上

┃

┃

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<res-ref-name>

1回

┃

┃

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<res-auth>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<res-sharing-scope>

0または1回

┃

┃

┃

┃

−

−

┃

┗

<linked-to>

0または1回

┃

┃

┃

┗

<linked-to>※2

1回

┣

<resource-env-ref>

0回以上

┃

┃

┣

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<resource-env-ref-name>

1回

┃

┃

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<linked-queue>

0または1回

┃

┃

┃

┣

<linked-queue>※2

1回

┃

┃

┣

<resource-adapter>※3

1回

┃

┃

┃

┃

┣

<resource-adapter>

1回

┃

┃

┗

<queue>※3

1回

┃

┃

┃

┃

┗

<queue>

1回

┃

┣

<linked-adminobject>

0または1回

┃

┃

┃

┣

<linked-adminobject>※2

1回

┃

┃

┣

<resourceadapter-name>※4

1回

┃

┃

┃

┃

┣

<resourceadapter-name>

1回

┃

┃

┗

<adminobject-name>※4

1回

┃

┃

┃

┃

┗

<adminobject-name>

1回

┃

┗

<linked-to>

0または1回

┃

┃

┃

┗

<linked-to>※2

1回

┣

<runtime>

0または1回

┃

┃

┃

−

−

┃

┣

<lookup-name>

1回

┃

┃

┣

<lookup-name>※2

0または1回

┃

┣

<optional-name>

0または1回

┃

┃

┣

<optional-name>

0または1回

┃

┣

<local-optional-name>

0または1回

┃

┃

┣

<local-optional-name>

0または1回

┃

┣

<maximum-sessions>

1回

┃

┃

┣

<maximum-sessions>※2

0または1回

┃

┣

<stateless>※5

どちらか1回，またはどちらもなし

┃

┃

┣

<stateless>※2

0または1回

┃

┃

┣

<pooled-instance>

1回

┃

┃

┃

┣

<pooled-instance>※2

0または1回

┃

┃

┃

┣

<minimum>

1回

┃

┃

┃

┃

┣

<minimum>※2

0または1回

┃

┃

┃

┗

<maximum>

1回

┃

┃

┃

┃

┗

<maximum>※2

0または1回

┃

┃

┗

<instance-timeout>

0または1回

┃

┃

┃

┗

<instance-timeout>

0または1回

┃

┣

<stateful>※5

どちらか1回，またはどちらもなし

┃

┃

┣

<stateful>※2

0または1回

┃

┃

┣

<maximum-active-sessions>

1回

┃

┃

┃

┣

<maximum-active-sessions>※2

0または1回

┃

┃

┣

<inactivity-timeout>

1回

┃

┃

┃

┣

<inactivity-timeout>※2

0または1回

┃

┃

┗

<removal-timeout>

1回

┃

┃

┃

┗

<removal-timeout>※2

0または1回

┃

┣

<enable-scheduling>

0または1回

┃

┃

┣

<enable-scheduling>

0または1回

┃

┣

<pass-by-reference>

0または1回

┃

┃

┣

<pass-by-reference>

0または1回

┃

┣

<scheduling>

0または1回

┃

┃

┣

<scheduling>

0または1回

┃

┃

┣

<queue-name>

1回

┃

┃

┃

┣

<queue-name>※2

0または1回

┃

┃

┣

<parallel-count>

1回

┃

┃

┃

┣

<parallel-count>※2

0または1回

┃

┃

┗

<queue-length>

0または1回

┃

┃

┃

┗

<queue-length>

0または1回

┃

┗

<front-ejb>

0または1回

┃

┃

┣

<front-ejb>

0または1回

┣

<start-order>

0または1回

┃

┃

┣

<start-order>

0または1回

┣

<ejb-method-observation-timeout>

0回以上

┃

┃

┣

<ejb-method-observation-timeout>

0回以上

┃

┣

<method>

1回以上

┃

┃

┃

┣

<method>

1回以上

┃

┃

┣

<description>

0または1回

┃

┃

┃

┃

−

−

┃

┃

┣

<method-intf>

0または1回

┃

┃

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-name>

1回

┃

┃

┃

┃

┣

<method-name>

1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-param>

0回以上

┃

┃

┃

┃

┗

<method-param>

0回以上

┃

┗

<method-observation-timeout>

1回

┃

┃

┃

┗

<method-observation-timeout>

1回

┗

<ejb-transaction-timeout>

0回以上

┃

┃

┣

<ejb-transaction-timeout>

0回以上

┣

<method>

1回以上

┃

┃

┃

┣

<method>

1回以上

┃

┣

<description>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<method-intf>

0または1回

┃

┃

┃

┃

┣

<method-intf>

0または1回

┃

┣

<method-name>

1回

┃

┃

┃

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┃

┃

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┃

┃

┃

┗

<method-param>

0回以上

┗

<transaction-timeout>

1回

┃

┃

┃

┗

<transaction-timeout>

1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

注※1

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<session>-<ejb-name>に対応し，属性ファイルには存在しないタグとなります。SessionBeanを特定するためのキーとなります。

注※2

cosminexus.xmlはカスタマイズしたい要素だけを記述する形式となるため，属性ファイルと出現パターンが異なります。

注※3

resource-adapterにはリソースアダプタ表示名，<queue>にはQUEUE名が入ります。

注※4

<resourceadapter-name>にはリソースアダプタ表示名，<adminobject-name>には管理対象オブジェクト名が入ります。

注※5

08-70以前のバージョンの場合，statelessまたはstatefulのどちらかを指定します。

3.5　Entity Bean属性ファイル

Entity Bean属性ファイルは，Entity Beanの属性を取得，編集する場合に使用するファイルです。

3.5.1　Entity Bean属性ファイルの指定内容

Entity Bean属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-entity-bean-property PUBLIC '-//Hitachi, Ltd.//DTD Entity Bean Property 7.6//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-entity-bean-property_7_6.dtd'>

Entity Bean属性ファイルは，次に示すタグを持つxmlファイルです。また，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名の欄にあるマニュアルの参照先には，そのタグの関連情報があります。マニュアル名に「アプリケーションサーバ」と記載されたマニュアルについては，名称を省略しています。

タグ名

出現パターン

説明

<hitachi-entity-bean-property>

1回

ルートタグ。

┣

<description>※1

0回以上※2

Entity Beanの説明。

┣

┃

┃

┃

┃

┃

┃

┃

<display-name>※1

1回以上※2

Entity Beanの表示名。

xml:lang属性が"en"のdisplay-nameを必ず指定します。

該当するリソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。

1≦文字列長

指定できる文字の制限はありません。※5

ただし，文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

┣

┃

<icon>※1

0回以上※2

GUIツール上に表示されるEntity Beanのアイコンの定義。

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。

┣

┃

┃

┃

<persistence-type>

1回

永続性管理種別。※3

指定できる文字列を次に示します。

Bean

Container

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<prim-key-class>

1回

プライマリキークラス。

単一プライマリキー，複合プライマリキーとして指定できるクラス・インタフェース，プリミティブ型を指定できます。

永続性管理種別が「Bean」の場合は，具象クラス，抽象クラスおよびインタフェースが指定できます。

永続性管理種別が「Container」の場合は，具象クラスだけが指定できます。

単一プライマリキーとして扱われるクラスを次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Character

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

複合プライマリキーとして扱われるクラスとインタフェースを次に示します。

クラスの場合

java.lang.Object

java.io.Serializableを実装し，boolean equals(Object obj)とint hashCode()をオーバーライドしたクラス（親クラスがjava.io.Serializableを実装していても可）

インタフェースの場合

java.io.Serializableを実装し，boolean equals(Object obj)とint hashCode()をオーバーライドしたクラス（親クラスがjava.io.Serializableを実装していても可）に実装されるインタフェース。

┣

┃

┃

┃

┃

┃

┃

<reentrant>

1回

同一トランザクション内での再帰呼び出しの可否。

指定できる値を次に示します。

true

可

false

不可

┣

<abstract-schema-name>

0または1回

EntityBeanの抽象スキーマ名。

スキーマ名が複数の場合は，それぞれ一意な値にしてください。

┣

┃

┃

<cmp-field>

0回以上

persistence-typeにContainerを指定した場合

必須

persistence-typeにBeanを指定した場合

cjsetappprop，cjsetrespropで無視されます。

┃

┣

<description>※1

0回以上※2

cmp-fieldの説明。

┃

┗

<field-name>

1回

永続性管理をするBeanのフィールド名。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

<primkey-field>

0または1回

プライマリキーとなるEntity Beanのフィールド名を指定します。

persistence-typeにContainerが指定されていて，かつprim-key-classに単一プライマリキーとなるクラスが指定された場合は必須。それ以外の場合はcjsetappprop，cjsetrespropで無視されます。

指定できる値はcmp-fieldのfield-nameに指定されている文字列。

primkey-fieldに指定したフィールドのデータ型はprim-key-classの文字列と一致していなければいけません。

┣

<env-entry>

0回以上

環境エントリについての定義。

┃

┣

<description>※1

0回以上※2

環境エントリの説明。

┃

┣

<env-entry-name>

1回

環境エントリの名称。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<env-entry-type>

1回

環境エントリのデータ型。

指定できる文字列を次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

java.lang.Character

┃

┃

┃

┃

┗

<env-entry-value>

1回

環境エントリの値。

env-entry-typeで指定した型に適合した値を指定します。

env-entry-typeにjava.lang.String以外を指定した場合，空文字の指定はできません。

┣

┃

<ejb-ref>

0回以上

リモートインタフェースを持つEnterprise Beanへの参照情報についての定義。

┃

┣

<description>※1

0回以上※2

ejb-refの説明。

┃

┣

<ejb-ref-name>

1回

ejb-refの名称。

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

1回

リンク先のEnterprise Beanの種別。

指定できる文字列を次に示します。

Entity

Session

┃

┃

┣

┃

<home>

1回

リンク先のEnterprise BeanのRemote Homeインタフェース名。

┃

┃

┣

┃

<remote>

1回

リンク先のEnterprise BeanのRemote Componentインタフェース名。

┃

┗

<ejb-link>

0または1回

リンク先のejb-name。

┣

┃

<ejb-local-ref>

0回以上

ローカルインタフェースを持つEnterprise Beanへの参照情報についての定義。

┃

┣

<description>※1

0回以上※2

ejb-local-refの説明。

┃

┣

<ejb-ref-name>

1回

ejb-local-refの名称。

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

1回

リンク先のEnterprise Beanの種別。

指定できる文字列を次に示します。

Session

Entity

┃

┃

┣

┃

<local-home>

1回

リンク先のEnterprise BeanのLocal Homeインタフェース名。

┃

┃

┣

┃

<local>

1回

リンク先のEnterprise BeanのLocal Componentインタフェース名。

┃

┗

<ejb-link>

0または1回

リンク先のejb-name。

┣

<security-role-ref>

0回以上

セキュリティロールについての定義。

┃

┣

<description>※1

0回以上※2

security-role-refの説明。

┃

┣

<role-name>

1回

security-role-refの名称。

┃

┗

<role-link>

0または1回

リンク先のロール名。

┣

<security-identity>

0または1回

セキュリティアイデンティティについての定義。

┃

┣

<description>※1

0回以上※2

security-identityの説明。

┃

┃

┃

┣

┃

┃

<use-caller-identity>

1回

実行時security-identityを使用するかどうかの指定。なお，このタグは値を持ちません。

<use-caller-identity>と<run-as>のどちらか一つを指定します。

┃

┃

┃

┗

<run-as>

1回

実行時security-identityの定義情報。

<use-caller-identity>と<run-as>のどちらか一つを指定します。

┃

┣

<description>※1

0回以上※2

実行時security-identityの説明。

┃

┣

<role-name>

1回

実行時security-identityのroleの名称。

┃

┗

<user-name>

0または1回

プリンシパル名。

┣

<resource-ref>

0回以上

リソースへの参照情報についての定義。

┃

┣

<description>※1

0回以上※2

resource-refの説明。

┃

┣

<res-ref-name>

1回

resource-refの名称。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<res-type>

1回

リソース種別。

指定可能な文字列は次のとおり。

javax.mail.Session

javax.sql.DataSource

javax.jms.QueueConnectionFactory

javax.jms.ConnectionFactory

javax.resource.cci.ConnectionFactory

org.omg.CORBA_2_3.ORB（DDで定義しなくてもlookupできるリソース）

javax.jms.TopicConnectionFactory

参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子(<connectionfactory-interface>タグの設定値)を指定します。

┃

┃

┃

┣

┃

┃

<res-auth>

1回

認証方式。

指定できる文字列を次に示します。

Application

Container

┃

┃

┃

┃

┣

┃

┃

┃

<res-sharing-scope>

0または1回

参照したリソースを共有するかどうかの指定。

指定できる文字列を次に示します。

Shareable

Unshareable

┃

┃

┃

┣

┃

┃

<mapped-name>

0または1回

対応するリソースアダプタ表示名，またはメール表示名。※3

<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

0または1回

対応するリソースアダプタ表示名，データソース表示名，またはメール表示名。

リソースアダプ表示名の指定方法はリソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

cjsetrespropでは無視されます。

┣

<resource-env-ref>

0回以上

リソース環境変数への参照情報についての定義。

┃

┣

<description>※1

0回以上※2

resource-env-refの説明。

┃

┣

<resource-env-ref-name>

1回

resource-env-refの名称。

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<resource-env-ref-type>

1回

リソース環境変数の値のクラスタイプ。

指定できる文字列を次に示します。

javax.jms.Queue

javax.jms.Topic

JavaBeansリソースのクラス名

<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<mapped-name>

0または1回

<resource-env-ref-type>が「javax.jms.Queue」の場合，対応するキュー※3を次の形式で表示します。

"<リソースアダプタの表示名>#<Queue名称>"

<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。

<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┃

┃

┣

┃

┃

<linked-queue>

0または1回

queue名称。

cjsetrespropでは無視されます。

<resource-env-ref-type>が「javax.jms.Queue」の場合だけ有効となります。

┃

┃

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。

Connector1.5のリソースアダプタは指定できません。

┃

┃

┗

<queue>

1回

キューの表示名を指定します。

┃

┃

┣

┃

<linked-adminobject>

0または1回

管理対象オブジェクト。

cjsetrespropでは無視されます。

┃

┃

┃

┃

┣

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

Connector1.0以前のリソースアダプタは指定できません。

┃

┃┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

┃

┃

┃

┗

<linked-to>

0または1回

JavaBeansリソースの表示名。

<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合だけ有効となります。

cjsetrespropでは無視されます。

┣

<query>

0回以上

EJB QLについての定義。

┃

┣

<description>

0または1回

queryの説明。

┃

┣

<query-method>

1回

クエリメソッドについての定義。

┃

┃

┣

<method-name>

1回

クエリメソッド（finderまたはselectメソッド）。

┃

┃

┗

<method-params>

1回

クエリメソッドの引数。

┃

┃

┃

┃

┗

<method-param>

0回以上

finderまたはselectメソッドの引数のJavaタイプ。

┃

┃

┃

┣

┃

┃

<result-type-mapping>

0または1回

selectメソッドでEntityオブジェクトが返される場合のオブジェクトのタイプ。

「Remote」，「Local」のどちらかを指定します。デフォルトはLocalです。

┃

┗

<ejb-ql>

1回

EJB QLのクエリ文。

┣

<method-permission>

0回以上

メソッドパーミッションについての定義。

┃

┣

<description>※1

0回以上※2

method-permissionの説明。

┃

┃

┣

┃

<role-name>

1回以上

メソッドに割り当てるロール名。

<role-name>と<unchecked>のどちらか一つを指定します。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<unchecked>

1回

メソッド実行時の認証チェック。

このタグを使用する場合，認証チェックはしません。メソッドに割り当てるロール名。

<role-name>と<unchecked>のどちらか一つを指定します。

なお，このタグは値を持ちません。

┃

┗

<method>

1回以上

メソッドについての定義。

┃

┣

<description>

0回以上※2

メソッドの説明。

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┣

┃

<method-name>

1回

メソッド名。

*を指定した場合，すべてのメソッドを表します。

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

method-nameが*以外の場合に有効。

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

パラメタのデータ型。

プリミティブ型またはクラスの名称を指定します。

配列の場合は名称の後ろに[]を指定します（名称と [ の間，[ と ] の間を空けないようにしてください）。多次元配列の場合は[]を続けて指定します（ ] と [ の間を空けないようにしてください）。配列の内部形式名（int[]の場合[I，java.lang.String[]の場合[Ljava.lang.String;）は指定できません。

例

int

short[][]

java.lang.String[]

┣

<container-transaction>

0回以上

コンテナのトランザクションについての定義。

┃

┣

<description>※1

0回以上※2

container-transactionの説明。

┃

┣

<method>

1回以上

メソッドについての定義。

┃

┃

┣

<description>※1

0回以上※2

メソッドの説明。

┃

┃┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┃

┃

┣

┃

<method-name>

1回

メソッド名。

*を指定した場合，すべてのメソッドを表します。※4

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

method-nameが*以外の場合に有効。

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

パラメタのデータ型。

プリミティブ型またはクラスの名称を指定します。

配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにします）。

多次元配列の場合は[]を続けて指定します（]と[の間を空けてはいけません）。

配列の内部形式名（int[]の場合は[I，java.lang.String[]の場合は[Ljava.lang.String;）は指定できません。

例

int

short[][]

java.lang.String[]

┃

┃

┃

┃

┃

┃

┃

┃

┗

<trans-attribute>

1回

メソッドに割り当てるトランザクション属性。

指定できる文字列を次に示します。

Mandatory

Never

NotSupported

Required

RequiresNew

Supports

┣

<exclude-list>

0または1回

呼び出しをしないメソッドのリストの定義。

┃

┣

<description>※1

0回以上※2

exclude-listの説明。

┃

┗

<method>

1回以上

呼び出しをしないメソッドの定義。

┃

┣

<description>※1

0回以上※2

呼び出しをしないメソッドの説明。

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┣

┃

<method-name>

0または1回

メソッド名。

*を指定した場合，すべてのメソッドを表します。

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

method-nameが*以外の場合に有効。

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

パラメタのデータ型。

プリミティブ型またはクラスの名称を指定します。

配列の場合は名称の後ろに[]を指定します（名称と [ の間，[ と ] の間を空けないようにしてください）。多次元配列の場合は[]を続けて指定します（ ] と [ の間を空けないようにしてください）。配列の内部形式名（int[]の場合[I，java.lang.String[]の場合[Ljava.lang.String;）は指定できません。

例

int

short[][]

java.lang.String[]

┣

┃

┃

<runtime>

0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<lookup-name>

1回

クライアントからEJBをルックアップに使う名前。

HITACHI_EJB/SERVERS/<サーバ名称>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。

ルックアップ名には，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

・先頭または末尾にピリオド（.）を付けた名前

・ピリオド（.）だけの名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

1≦文字列長≦255

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<optional-name>

0または1回

リモートインタフェースの別名。

設定値には，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次の名前は指定できません。

予約語の"HITACHI_EJB"（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）だけ，またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

1≦文字列長≦255

0文字の場合は，タグが省略されたものと見なされます。

┃

┃

┃

┃

┣

┃

┃

┃

<local-optional-name>

0または1回

ローカルインタフェースの別名。

設定値に制限はありません。

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

┃

┃

┣

┃

<maximum-instances>

1回

Enterprise Beanインスタンスの最大数。

0（無制限）または1≦maximum-instances≦2147483647

┃

┣

<pooled-instance>

1回

インスタンスプールのプロパティ。

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<minimum>

1回

プール内のインスタンスの最小数。

0（無制限）または1≦minimum≦maximum

maximumに上限を指定した場合，minimumにも上限を指定しなければいけません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<maximum>

1回

プール内のインスタンスの最大数。

0（無制限）または1≦maximum≦maximum-instances

maximum-instancesに上限を指定した場合，maximumにも上限を指定しなければいけません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<caching-model>

1回

データのキャッシュ方法。

次のどれかを指定します。

full-caching

メソッド起動間のすべての状態情報をキャッシュします。

caching

メソッド起動間で最も頻繁に使用された状態情報をキャッシュします。

no-caching

状態情報をキャッシュしません。

┃

┃

┣

┃

<entity-timeout>

0または1回

EJBObjectの存在時間（秒）を指定します。0：タイムアウトなし。1≦設定値≦2147483647

┃

┃

┣

┃

<pass-by-reference>

0または1回

Bean単位でのデータの参照渡し（pass by reference）を指定します。

┃

┃

┃

┣

┃

┃

<instance-timeout>

0または1回

インスタンス取得タイムアウト時間を，0〜86400（単位：秒）で指定します。

0を指定した場合，タイムアウトしません。デフォルト値は0です。

┃

┃

┃

┣

┃

┃

<front-ejb>

0または1回

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。フロントEJBの場合はtrueを指定し，フロントEJBでない場合はfalseを指定します。デフォルト値はfalse。

┃

┃

┃

┣

┃

┃

<ejb20-cmp>

0または1回

EJB1.1，EJB2.0でのEntityBeanのCMPについて設定します。※3

cjsetapppropでは無視されます。

┃

┃

┃

┃

┗

<sql-statement>

0回以上

メソッドとSQL文を関連づけます。※3

メソッドは「finder」と「ejbSelect」です。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<method>

1回

メソッドについての定義。※3

<method>と<operation>のどちらか一つを指定します。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。※3

指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┃

┃

┃

┃

┣

┃

<method-name>

1回

メソッド名。※3

*を指定した場合，すべてのメソッドを表します。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

method-nameが*以外の場合に有効。※3

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

パラメタのデータ型。※3

プリミティブ型またはクラスの名称を指定します。

配列の場合は名称の後ろに[]を指定します（名称と [ の間，[ と ] の間を空けないようにしてください）。多次元配列の場合は[]を続けて指定します（ ] と [ の間を空けないようにしてください）。配列の内部形式名（int[]の場合[I，java.lang.String[]の場合[Ljava.lang.String;）は指定できません。

例

int

short[][]

java.lang.String[]

┃

┃

┃

┃

┃

┃

┣

┃

┃

<operation>

1回

CMPのオペレーション名を指定します。※3

<method>と<operation>のどちらか一つを指定します。

┃

┃

┗

<sql>

1回

SQL文を指定します。※3

┃

┃

┃

┃

┗

<cmp-map>

0または1回

persistence-typeがBeanの場合

cjsetapppropで無視されます。

persistence-typeがContainerの場合

必須

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<datasource-name>

1回

Enterprise Beanフィールドのマッピング先とするデータソース，または開始されたリソースアダプタの表示名。

リソースアダプ表示名の指定方法はリソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

┃

┃

┣

┃

<catalog-name>

0または1回

Enterprise Beanフィールドのマッピング先とするデータベースのカタログ名。

┃

┃

┣

┃

<schema-name>

0または1回

Enterprise Beanフィールドのマッピング先とするデータベースのスキーマ名。

┃

┃

┣

┃

<table-name>

1回

Enterprise Beanフィールドのマッピング先とするデータベースのテーブル名。

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<read-only-access>

1回

アプリケーションからデータベースへの書き込みの許可／禁止。

次のどちらかを指定します。

true

書き込みを禁止します。

false

書き込みを許可します。

┃

┣

<available-transaction-isolations>

1回

指定できるトランザクションについての定義。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<transaction-isolation>

0回以上

指定できるトランザクション遮断レベル。※3

次のどれかが指定されます（cjgetapppropでプロパティファイル生成時にデータベースにアクセスして自動的に生成されます）。

none

トランザクションがサポートされていません。

read committed

ダーティー読み取りが抑制されます。

read uncommitted

ダーティー読み取り，繰り返し不可の読み取り，およびファントム読み取りが起こります。

repeatable_read

ダーティー読み取りおよび繰り返し不可の読み取りが抑制されます。

serializable

ダーティー読み取り，繰り返し不可の読みおよびファントム読み取りが抑制されます。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<transaction-isolation>

0または1回

トランザクション遮断レベル。

available-transaction-isolationsにある中から一つを指定します。

省略した場合，デフォルトのトランザクション遮断レベルが使われます（使用するデータベースおよびJDBCドライバによって異なります）。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<concurrency-protection>

0または1回

データベースに書き込むデータとレコードとの照合方法。

指定できる値を次に示します。

primary-key

プライマリキーと照合してデータを更新します。

modified-data

プライマリキーと照合して変更対象のデータの値が最後の読み出し操作以降に変更されているかどうかをチェックします。

whole-row

プライマリキーと照合して変更対象の値を含む行内のすべての値が最後の読み出し操作以降に変更されているかどうかをチェックします。

read-only-accessがtrueの場合は省略できます。また，値が指定されていても無視します。

┃

┃

┣

┃

<field-impl>

0回以上

Entity Beanのフィールドとテーブルのカラムとのマッピングについての定義。※3

┃

┃

┣

<field-name>

1回

Entity Beanのフィールド名。※3

┃

┃

┗

<column-name>

1回

テーブルのカラム名。

┃

┃

┗

<finder-impl>

0回以上

ejbFindByPrimaryKey以外のFinderメソッドの検索条件。※3

┃

┣

<method-name>

1回

Finderメソッドのメソッド名。※3

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<where-clause>

1回

テーブルの検索条件。指定できる値は"#"以外です。

検索条件に指定できる演算子を次に示します。なお，<や>を値に使うことはXMLの構文上許されていないため，テキストエディタで属性ファイルを編集する場合は，表内（）のようにエンティティを使用してください。

IS NULL

NULLです。

IS NOT NULL

NULLではありません。

=

等しい（Finderメソッドのパラメタが1個以上の場合に使用できます）。

!=

等しくない（Finderメソッドのパラメタが1個以上の場合に使用できます）。

< （&lt;）

〜より小さい（Finderメソッドのパラメタが1個以上の場合に使用できます）。

> （&gt;）

〜より大きい（Finderメソッドのパラメタが1個以上の場合に使用できます）。

<= （&lt;=）

〜以下（Finderメソッドのパラメタが1個以上の場合に使用できます）。

>= （&gt;=）

〜以上（Finderメソッドのパラメタが1個以上の場合に使用できます）。

LIKE

検索パターンに一致する（Finderメソッドのパラメタが1個以上の場合に使用できます）。

NOT LIKE

検索パターンに一致しない（Finderメソッドのパラメタが1個以上の場合に使用できます）。

BETWEEN

範囲に含まれる（Finderメソッドのパラメタが2個以上の場合に使用できます）。

NOT BETWEEN

範囲に含まれない（Finderメソッドのパラメタが2個以上の場合に使用できます）。

検索条件の構文を次に示します。

IS NULL，IS NOT NULL演算子を使用する場合

フィールド名 演算子

BETWEEN，NOT BETWEEN演算子を使用する場合

フィールド名 演算子 ?番号 AND ?番号

そのほかの演算子を使用する場合

フィールド名 演算子 ?番号

検索条件は，ANDまたはORで接続できます。

検索条件，AND，OR，フィールド名は大文字小文字を区別します。

?番号には，Finderメソッドの引数の場所（左から1,2,...）を指定します。

例

id &lt;= ?1 AND value IS NOT NULL OR name BETWEEN ?3 AND ?4

検索条件，AND，OR，フィールド名，?番号の間は1文字以上の空白を入れてください。

空文字列の場合は，テーブルのすべての行が検索パターンに一致するものと見なします。

DISABLEが指定されている場合はアプリケーションからこのメソッドを使用できません。

┣

┃

┃

<start-order>

0または1回

J2EEアプリケーション開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0≦start-order≦2147483647

┣

┃

┃

┃

┃

┃

┃

<ejb-method-observation-timeout>

「機能解説 運用／監視／連携編」−「5章」

0回以上

EJBのメソッドに仕掛かり中メソッド監視用タイムアウト時間を設定する場合に指定。

<ejb-method-observation-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-method-observation-timeout>の<method-observation-timeout>の値が有効になります。

┃

┣

<method>

1回以上

−

┃

┃

┃

┃

┣

┃

<description>

0または1回

メソッドの説明。このタグは複数指定できません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

次の値が指定できます。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┃

┃

┣

┃

<method-name>

1回

対象となるメソッド名を指定します。*を指定した場合はすべてのメソッドを表します。※4

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定。

┃

┃

┃

┗

<method-observation-timeout>

1回

仕掛かり中メソッド監視用タイムアウト時間を，0〜86400（単位：秒）で指定します。0を指定した場合は，タイムアウトしません。デフォルト値は0。

┗

<ejb-transaction-timeout>

「機能解説 基本・開発編(コンテナ共通機能)」−「3.15.8」

0回以上

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効になります。

┣

<method>

1回以上

メソッドについての定義

┃

┃

┣

┃

<description>

0または1回

メソッドの説明。このタグは複数指定できません。

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

次の値が指定できます。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃

┃

┣

┃

<method-name>

1回

対象となるメソッド名を指定します。*を指定した場合，すべてのメソッドを表します。※4

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

┃

┗

<method-param>

0回以上

引数のデータ型を指定。

┗

<transaction-timeout>

1回

トランザクションタイムアウト時間を，0〜2147483647（単位：秒）で指定します。デフォルト値は0。0を指定した場合，またはタグがない場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

−

−

−

−

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※4

サーバ管理コマンド用のusrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleに「false」を指定している場合にこのタグで指定されたメソッドが存在しないとき，属性の設定でエラーになります。usrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleキーについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「5.2.3　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）」を参照してください。

注※5

CMR使用時は，Java識別子に使用できる文字だけ指定できます。

3.5.2　DDとの対応

Entity Bean属性ファイルとDeployment Descriptorの対応を次に示します。

Entity Bean属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-entity-bean-property>

1回

<ejb-jar>

1回

┃

−

−

┣

<description>

0または1回

┃

−

−

┣

<display-name>

0または1回

┃

−

−

┣

<icon>

0回以上

┃

−

−

┃

┣

<small-icon>

0または1回

┃

−

−

┃

┗

<large-icon>

0または1回

┃

−

−

┣

<enterprise-beans>

1回

┃

−

−

┃

┣

<session>※1

1回以上

┃

−

−

┃

┃

(省略)

−

┃

−

−

┃

┗

<entity>※1

1回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<display-name>

1回以上

┃

┣

<display-name>

0回以上

┃

┣

<icon>

0回以上

┃

┣

<icon>

0回以上

┃

┃

┣

<small-icon>

0または1回

┃

┃

┣

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

−

−

┃

┣

<ejb-name>

1回

┃

┃

−

−

┃

┣

<home>

0または1回

┃

┃

−

−

┃

┣

<remote>

0または1回

┃

┃

−

−

┃

┣

<ejb-class>

1回

┃

┣

<persistence-type>

0または1回

┃

┣

<persistence-type>

0または1回

┃

┣

<prim-key-class>

1回

┃

┣

<prim-key-class>

1回

┃

┣

<reentrant>

1回

┃

┣

<reentrant>

1回

┃

┣

<abstract-schema-name>

0または1回

┃

┣

<abstract-schema-name>

0または1回

┃

┣

<cmp-field>

0回以上

┃

┣

<cmp-field>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┗

<field-name>

1回

┃

┃

┗

<field-name>

1回

┃

┣

<primkey-field>

0または1回

┃

┣

<primkey-field>

0または1回

┃

┣

<env-entry>

0回以上

┃

┣

<env-entry>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<env-entry-name>

1回

┃

┃

┣

<env-entry-name>

1回

┃

┃

┣

<env-entry-type>

1回

┃

┃

┣

<env-entry-type>

1回

┃

┃

┗

<env-entry-value>

1回

┃

┃

┗

<env-entry-value>

0または1回

┃

┣

<ejb-ref>

0回以上

┃

┣

<ejb-ref>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<ejb-ref-name>

1回

┃

┃

┣

<ejb-ref-name>

1回

┃

┃

┣

<ejb-ref-type>

1回

┃

┃

┣

<ejb-ref-type>

1回

┃

┃

┣

<home>

1回

┃

┃

┣

<home>

1回

┃

┃

┣

<remote>

1回

┃

┃

┣

<remote>

1回

┃

┃

┗

<ejb-link>

0または1回

┃

┃

┗

<ejb-link>

0または1回

┃

┣

<ejb-local-ref>

0回以上

┃

┣

<ejb-local-ref>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<ejb-ref-name>

1回

┃

┃

┣

<ejb-ref-name>

1回

┃

┃

┣

<ejb-ref-type>

1回

┃

┃

┣

<ejb-ref-type>

1回

┃

┃

┣

<local-home>

1回

┃

┃

┣

<local-home>

1回

┃

┃

┣

<local>

1回

┃

┃

┣

<local>

1回

┃

┃

┗

<ejb-link>

0または1回

┃

┃

┗

<ejb-link>

0または1回

┃

┣

<security-role-ref>

0回以上

┃

┣

<security-role-ref>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<role-name>

1回

┃

┃

┣

<role-name>

1回

┃

┃

┗

<role-link>

0または1回

┃

┃

┗

<role-link>

0または1回

┃

┣

<security-identity>

0または1回

┃

┣

<security-identity>

0または1回

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<use-caller-identity>※2

1回

┃

┃

┣

<use-caller-identity>※2

1回

┃

┃

┗

<run-as>※2

1回

┃

┃

┗

<run-as>※2

1回

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<role-name>

1回

┃

┃

┗

<role-name>

1回

┃

┃

┗

<user-name>

0または1回

┃

┃

−

1回

┃

┣

<resource-ref>

0回以上

┃

┣

<resource-ref>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<res-ref-name>

1回

┃

┃

┣

<res-ref-name>

1回

┃

┃

┣

<res-type>

1回

┃

┃

┣

<res-type>

1回

┃

┃

┣

<res-auth>

1回

┃

┃

┣

<res-auth>

1回

┃

┃

┣

<res-sharing-scope>

0または1回

┃

┃

┗

<res-sharing-scope>

0または1回

┃

┃

┣

<mapped-name>

0または1回

┃

┃

−

−

┃

┃

┗

<linked-to>

0または1回

┃

┃

−

−

┃

┣

<resource-env-ref>

0回以上

┃

┣

<resource-env-ref>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<resource-env-ref-name>

1回

┃

┃

┣

<resource-env-ref-name>

1回

┃

┃

┣

<resource-env-ref-type>

1回

┃

┃

┗

<resource-env-ref-type>

1回

┃

┃

┣

<mapped-name>

0または1回

┃

┃

−

−

┃

┃

┣

<linked-queue>

0または1回

┃

┃

−

−

┃

┃

┃

┣

<resource-adapter>

1回

┃

┃

−

−

┃

┃

┃

┗

<queue>

1回

┃

┃

−

−

┃

┃

┗

<linked-adminobject>

0または1回

┃

┃

−

−

┃

┃

┣

<resource-adapter-name>

1回

┃

┃

−

−

┃

┃

┗

<adminobject-name>

1回

┃

┃

−

−

┃

┗

<query>

0回以上

┃

┗

<query>

0回以上

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┣

<query-method>

1回

┃

┣

<query-method>

1回

┃

┃

┣

<method-name>

1回

┃

┃

┣

<method-name>

1回

┃

┃

┗

<method-params>

1回

┃

┃

┗

<method-params>

1回

┃

┃

┗

<method-param>

0回以上

┃

┃

┗

<method-param>

0回以上

┃

┣

<result-type-mapping>

0または1回

┃

┣

<result-type-mapping>

0または1回

┃

┗

<ejb-ql>

1回

┃

┗

<ejb-ql>

1回

┃

−

−

┣

<assembly-descriptor>

0または1回

┃

−

−

┃

┣

<security-role>

0回以上

┃

−

−

┃

┃

┣

<description>

0回以上

┃

−

−

┃

┃

┗

<role-name>

1回

┣

<method-permission>

0回以上

┃

┣

<method-permission>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<role-name>※3

1回以上

┃

┃

┣

<role-name>※3

1回以上

┃

┣

<unchecked>※3

1回

┃

┃

┣

<unchecked>※3

1回

┃

┗

<method>

1回以上

┃

┃

┗

<method>

1回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

−

−

┃

┃

┣

<ejb-name>

1回

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-intf>

0または1回

┃

┣

<method-name>

1回

┃

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┃

┗

<method-param>

0回以上

┣

<container-transaction>

0回以上

┃

┣

<container-transaction>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<method>

1回以上

┃

┃

┣

<method>

1回以上

┃

┃

┣

<description>

0回以上

┃

┃

┃

┣

<description>

0回以上

┃

┃

┃

−

−

┃

┃

┃

┣

<ejb-name>

1回

┃

┃

┣

<method-intf>

0または1回

┃

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-name>

1回

┃

┃

┃

┣

<method-name>

1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-param>

0回以上

┃

┃

┃

┗

<method-param>

0回以上

┃

┗

<trans-attribute>

1回

┃

┃

┗

<trans-attribute>

1回

┣

<exclude-list>

0または1回

┃

┗

<exclude-list>

0または1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┗

<method>

1回以上

┃

┗

<method>

1回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

−

−

┃

┣

<ejb-name>

１回

┃

┣

<method-intf>

0または1回

┃

┣

<method-intf>

0または1回

┃

┣

<method-name>

1回

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┗

<method-param>

0回以上

┃

−

−

┗

<ejb-client-jar>

0または1回

┗

<runtime>

0または1回

−

−

(省略)

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<session>と<entity>のどちらか一つを指定します。

注※2

<use-caller-identity>と<run-as>のどちらか一つを指定します。

注※3

<role-name>と<unchecked>のどちらか一つを指定します。

3.5.3　cosminexus.xmlとの対応

Entity Bean属性ファイルとcosminexus.xmlの対応を次に示します。

Entity Bean属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

<hitachi-entity-bean-property>

1回

┃

┣

<entity>

0回以上

┃

−

−

┃

┃

┣

<ejb-name>※1

1回

┣

<security-identity>

0または1回

┃

┃

┣

<security-identity>

0または1回

┃

┗

<run-as>

1回

┃

┃

┃

┗

<run-as>

1回

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<role-name>

1回

┃

┃

┃

┃

−

−

┃

┗

<user-name>

0または1回

┃

┃

┃

┗

<user-name>※2

1回

┣

<ejb-ref>

0回以上

┃

┃

┃

−

−

┃

┣

<description>

0回以上

┃

┃

┃

−

−

┃

┣

<ejb-ref-name>

1回

┃

┃

┃

−

−

┃

┣

<ejb-ref-type>

1回

┃

┃

┃

−

−

┃

┣

<home>

1回

┃

┃

┃

−

−

┃

┣

<remote>

1回

┃

┃

┃

−

−

┃

┗

<ejb-link>

0または1回

┃

┃

┃

−

−

┣

<resource-ref>

0回以上

┃

┃

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<res-ref-name>

1回

┃

┃

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

1回

┃

┃

┃

┃

−

−

┃

┣

<res-auth>

1回

┃

┃

┃

┃

−

−

┃

┣

<res-sharing-scope>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┃

┃

┃

−

−

┃

┗

<linked-to>

0または1回

┃

┃

┃

┗

<linked-to>※2

1回

┣

<resource-env-ref>

0回以上

┃

┃

┣

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<resource-env-ref-name>

1回

┃

┃

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

1回

┃

┃

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<linked-queue>

0または1回

┃

┃

┃

┣

<linked-queue>※2

1回

┃

┃

┣

<resource-adapter>※3

1回

┃

┃

┃

┃

┣

<resource-adapter>

1回

┃

┃

┗

<queue>※3

1回

┃

┃

┃

┃

┗

<queue>

1回

┃

┣

<linked-adminobject>

0または1回

┃

┃

┃

┣

<linked-adminobject>※2

1回

┃

┃

┣

<resourceadapter-name>※4

1回

┃

┃

┃

┃

┣

<resourceadapter-name>

1回

┃

┃

┗

<adminobject-name>※4

1回

┃

┃

┃

┃

┗

<adminobject-name>

1回

┃

┗

<linked-to>

0または1回

┃

┃

┃

┗

<linked-to>※2

1回

┣

<runtime>

0または1回

┃

┃

┃

−

−

┃

┣

<lookup-name>

1回

┃

┃

┣

<lookup-name>※2

0または1回

┃

┣

<optional-name>

0または1回

┃

┃

┣

<optional-name>

0または1回

┃

┣

<local-optional-name>

0または1回

┃

┃

┣

<local-optional-name>

0または1回

┃

┣

<maximum-instances>

1回

┃

┃

┣

<maximum-instances>※2

0または1回

┃

┣

<pooled-instance>

1回

┃

┃

┣

<pooled-instance>※2

0または1回

┃

┃

┣

<minimum>

1回

┃

┃

┃

┣

<minimum>※2

0または1回

┃

┃

┗

<maximum>

1回

┃

┃

┃

┗

<maximum>※2

0または1回

┃

┣

<caching-model>

1回

┃

┃

┣

<caching-model>※2

0または1回

┃

┣

<entity-timeout>

0または1回

┃

┃

┣

<entity-timeout>

0または1回

┃

┣

<pass-by-reference>

0または1回

┃

┃

┣

<pass-by-reference>

0または1回

┃

┣

<instance-timeout>

0または1回

┃

┃

┣

<instance-timeout>

0または1回

┃

┣

<front-ejb>

0または1回

┃

┃

┣

<front-ejb>

0または1回

┃

┣

<ejb20-cmp>

0または1回

┃

┃

┃

−

−

┃

┃

┗

<sql-statement>

0回以上

┃

┃

┃

−

−

┃

┃

┣

<method>

1回

┃

┃

┃

−

−

┃

┃

┃

┣

<method-intf>

0または1回

┃

┃

┃

−

−

┃

┃

┃

┣

<method-name>

1回

┃

┃

┃

−

−

┃

┃

┃

┗

<method-params>

0または1回

┃

┃

┃

−

−

┃

┃

┃

┗

<method-param>

0回以上

┃

┃

┃

−

−

┃

┃

┣

<operation>

1回

┃

┃

┃

−

−

┃

┃

┗

<sql>

1回

┃

┃

┃

−

−

┃

┗

<cmp-map>

0または1回

┃

┃

┣

<cmp-map>

0または1回

┃

┣

<datasource-name>

1回

┃

┃

┃

┣

<datasource-name>

1回

┃

┣

<catalog-name>

0または1回

┃

┃

┃

┣

<catalog-name>

0または1回

┃

┣

<schema-name>

0または1回

┃

┃

┃

┣

<schema-name>

0または1回

┃

┣

<table-name>

1回

┃

┃

┃

┣

<table-name>

1回

┃

┣

<read-only-access>

1回

┃

┃

┃

┣

<read-only-access>

1回

┃

┣

<available-transaction-isolations>

1回

┃

┃

┃

┃

−

−

┃

┃

┗

<transaction-isolation>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<transaction-isolation>

0または1回

┃

┃

┃

┣

<transaction-isolation>

0または1回

┃

┣

<concurrency-protection>

0または1回

┃

┃

┃

┣

<concurrency-protection>

0または1回

┃

┣

<field-impl>

0回以上

┃

┃

┃

┣

<field-impl>

0回以上

┃

┃

┣

<field-name>

1回

┃

┃

┃

┃

┣

<field-name>

1回

┃

┃

┗

<column-name>

1回

┃

┃

┃

┃

┗

<column-name>

1回

┃

┗

<finder-impl>

0回以上

┃

┃

┃

┗

<finder-impl>

0回以上

┃

┣

<method-name>

1回

┃

┃

┃

┣

<method-name>

1回

┃

┗

<where-clause>

1回

┃

┃

┃

┗

<where-clause>

1回

┣

<start-order>

0または1回

┃

┃

┣

<start-order>

0または1回

┣

<ejb-method-observation-timeout>

0回以上

┃

┃

┣

<ejb-method-observation-timeout>

0回以上

┃

<method>

1回以上

┃

┃

┃

┣

<method>

1回以上

┃

┃

┣

<description>

0または1回

┃

┃

┃

┃

┃

−

−

┃

┃

┣

<method-intf>

0または1回

┃

┃

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-name>

1回

┃

┃

┃

┃

┣

<method-name>

1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-param>

0回以上

┃

┃

┃

┃

┗

<method-param>

0回以上

┃

┗

<method-observation-timeout>

1回

┃

┃

┃

┗

<method-observation-timeout>

1回

┗

<ejb-transaction-timeout>

0回以上

┃

┃

┗

<ejb-transaction-timeout>

0回以上

┣

<method>

1回以上

┃

┃

┣

<method>

1回以上

┃

┣

<description>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<method-intf>

0または1回

┃

┃

┃

┣

<method-intf>

0または1回

┃

┣

<method-name>

1回

┃

┃

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┃

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┃

┃

┗

<method-param>

0回以上

┗

<transaction-timeout>

1回

┃

┃

┗

<transaction-timeout>

1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

注※1

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<entity>-<ejb-name>に対応し，属性ファイルには存在しないタグとなります。EntityBeanを特定するためのキーとなります。

注※2

cosminexus.xmlはカスタマイズしたい要素だけを記述する形式となるため，属性ファイルと出現パターンが異なります。

注※3

resource-adapterにはリソースアダプタ表示名，<queue>にはキュー名が入ります。

注※4

<resourceadapter-name>にはリソースアダプタ表示名，<adminobject-name>には管理対象オブジェクト名が入ります。

3.6　MessageDrivenBean属性ファイル

MessageDrivenBean属性ファイルは，Message-driven Beanの属性を取得，編集する場合に使用するファイルです。

3.6.1　MessageDrivenBean属性ファイルの指定内容

MessageDrivenBean属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-message-bean-property PUBLIC '-//Hitachi, Ltd.//DTD Message Bean Property 7.6//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-message-bean-property_7_6.dtd'>

MessageDrivenBean属性ファイルは，次に示すタグを持つxmlファイルです。なお，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名の欄にあるマニュアルの参照先には，そのタグの関連情報があります。マニュアル名に「アプリケーションサーバ」と記載されたマニュアルについては，名称を省略しています。

タグ名

出現パターン

説明

<hitachi-message-bean-property>

1回

ルートタグ。

┣

<description>※1

0回以上※2

Message-driven Beanについての説明。

┣

┃

┃

┃

┃

┃

┃

┃

<display-name>※1

1回以上※2

Message-driven Beanの名称。

xml:lang属性が"en"のdisplay-nameを必ず指定します。該当するリソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。

1≦文字列長

指定できる文字の制限はありません。

文字列の先頭または末尾に，半角スペースがある場合，エラーとならずに，取り除かれて設定されます。

┣

┃

<icon>※1

0回以上※2

GUIツール上に表示されるEntity Beanのアイコンの定義。

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。

┣

┃

┃

┃

┃

<messaging-type>

0または1回

Message-driven Beanのメッセージリスナインタフェース。

記述されていない場合には，"javax.jms.MessageListener"が仮定されます。

このタグは，EJB2.1以降のEnterprise Beanに対して指定できます。

┣

┃

<transaction-type>

1回

トランザクションの管理方法。

「Container」または「Bean」のどちらかを指定できます。

┣

┃

┃

<activation-config>

0または1回

Message-driven Beanの動作環境。

このタグより下位のタグは，EJB2.1以降のEnterprise Beanに対して指定できます。

┃

┣

<description>※1

0回以上

Message-driven Beanの動作環境の説明。

┃

┃

┗

<activation-config-property>

1回以上

Message-driven Beanの動作環境に関するプロパティ。

┃

┃

┣

┃

<activation-config-property-name>

1回

Message-driven Beanの動作環境に関するプロパティ名。

┃

┃

┗

<activation-config-property-value>

1回

Message-driven Beanの動作環境に関するプロパティの値。

┣

┃

<message-selector>

0または1回

Message-driven beanが受信するメッセージを決定するためのJMSメッセージセレクタ。

このタグはEJB2.0以前のEnterprise Beanに対して指定できます。

┣

┃

┃

┃

┃

┃

<acknowledge-mode>

0または1回

BMTのMessage-driven beanのonMessageメッセージで使用する通知セマンティクス。

「Auto-acknowledge」または「Dups-ok-acknowledge」のどちらかを指定します。デフォルトは「Auto-acknowledge」です。

このタグはEJB2.0以前のEnterprise Beanに対して指定できます。

┣

┃

<message-driven-destination>

0または1回

JMSデスティネーションの定義。

このタグより下位のタグはEJB2.0以前のEnterprise Beanに対して指定できます。

┃

┃

┣

┃

<destination-type>

1回

JMSデスティネーションのタイプ。

「javax.jms.Queue」または「javax.jms.Topic」のどちらかを指定します。

┃

┃

┃

┗

<subscription-durability>

0または1回

JMSデスティネーションが「javax.jms.Topic」の場合のサブスクリプション。

「Durable」または「NonDurable」のどちらかを指定します。デフォルトは後者です。

┣

┃

<env-entry>

0回以上

Message-driven Beanから呼び出す環境変数についての定義。

┃

┣

<description>※1

0回以上※2

環境変数についての説明。

┃

┣

<env-entry-name>

1回

環境変数の名称。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<env-entry-type>

1回

環境変数の値のJavaタイプ。

指定できる値を次に示します。

java.lang.Boolean

java.lang.String

java.lang.Character

java.lang.Integer

java.lang.Double

java.lang.Byte

java.lang.Short

java.lang.Long

java.lang.Float

┃

┗

<env-entry-value>

1回

環境変数の値。

┣

┃

┃

<ejb-ref>

0回以上

Message-driven Beanからリモートインタフェースを持つEnterprise Beanへの参照情報についての定義。

┃

┣

<description>※1

0回以上※2

Enterprise Bean参照についての説明。

┃

┣

<ejb-ref-name>

1回

リンク先のEnterprise Beanの名称。

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

1回

リンク先のEnterprise Beanの種別。

指定できる値を次に示します。

Session

Entity

┃

┃

┣

┃

<home>

1回

リンク先のEnterprise BeanのRemote Homeインタフェース名。

┃

┃

┣

┃

<remote>

1回

リンク先のEnterprise BeanのRemote Componentインタフェース名。

┃

┃

┃

┃

┃

┗

<ejb-link>

0または1回

リンク先のEnterprise Beanの名称。ネーミングの切り替え機能でリンク先を設定する場合，次の形式で指定してください。

corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBHomeオブジェクトリファレンスのJNDI名>

┣

┃

┃

<ejb-local-ref>

0回以上

Message-driven Beanからローカルインタフェースを持つEnterprise Beanへの参照情報についての定義。

┃

┣

<description>※1

0回以上※2

ejb-local-refの説明。

┃

┣

<ejb-ref-name>

1回

リンク先のEnterprise Beanの名称。

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

1回

リンク先のEnterprise Beanの種別。

指定できる値を次に示します。

Session

Entity

┃

┃

┣

┃

<local-home>

1回

リンク先のEnterprise BeanのLocal Homeインタフェース名。

┃

┃

┣

┃

<local>

1回

リンク先のEnterprise BeanのLocal Componentインタフェース名。

┃

┗

<ejb-link>

0または1回

リンク先のEnterprise Beanの名称。

┣

┃

┃

<message-ref>

0または1回

Connector1.0のリソースアダプタを指定する場合，<resource-adapter>と<queue>の組み合わせは，複数のアプリケーション間でユニークにする必要があります。

┃┃

┣┃

<connection-factory>

0または1回

リソースアダプタの表示名を指定します。

Connector1.5以降のリソースアダプタは指定できません。

┃

┗

<connection-destination>

1回

cjsetrespropでは無視されます。

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。

┃┃

┗

<queue>

0または1回

キューの表示名を指定します。

Connector1.5以降のリソースアダプタは指定できません。

┣

<security-identity>

0または1回

セキュリティアイデンティティについての定義。

┃

┣

<description>※1

0回以上※2

security-identityの説明。

┃

┗

<run-as>

1回

実行時アイデンティティの定義。

┃

┣

<description>※1

0回以上※2

run-asの説明。

┃

┣

<role-name>

1回

セキュリティロール名。

┃

┗

<user-name>

1回

プリンシパル名。

┣

<resource-ref>

0回以上

Message-Driven Beanから参照するリソースの定義。

┃

┣

<description>※1

0回以上※2

resource-refの説明。

┃

┣

<res-ref-name>

1回

リソース参照の名称。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<res-type>

1回

リソース種別。

指定可能な文字列は次のとおり。

javax.mail.Session

javax.sql.DataSource

javax.jms.QueueConnectionFactory

javax.jms.ConnectionFactory

javax.resource.cci.ConnectionFactory

org.omg.CORBA_2_3.ORB（DDで定義しなくてもlookupできるリソース）

javax.jms.TopicConnectionFactory

参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子(<connectionfactory-interface>タグの設定値)を指定します。

┃

┃

┃

┣

┃

┃

<res-auth>

1回

リソースマネジャへ登録する方法。

指定できる値は，「Container」または「Application」のどちらかです。

┃

┃

┃

┃

┣

┃

┃

┃

<res-sharing-scope>

0または1回

リソースマネジャファクトリリファレンスから取得したコネクションを共有するかどうかの指定。

設定できる値は，「Shareable」または「Unshareable」のどちらかです。デフォルトは「Shareable」です。

┃

┃

┃

┣

┃

┃

<mapped-name>

0または1回

対応するリソースアダプタ表示名またはメール表示名。※3

<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

0または1回

対応するリソースアダプタ表示名，データソース表示名，またはメール表示名。

リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

cjsetrespropでは無視されます。

┣

┃

<resource-env-ref>

0回以上

Message-driven Beanから参照するリソース環境変数の定義。

┃

┣

<description>※1

0回以上※2

resource-env-refの説明。

┃

┣

<resource-env-ref-name>

1回

リソース環境変数参照の名称。

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<resource-env-ref-type>

1回

リソース環境変数参照の種別。

次のJavaクラスまたはインタフェース名を指定します。

javax.jms.Queue

javax.jms.Topic

JavaBeansリソースのクラス名

<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<mapped-name>

0または1回

<resource-env-ref-type>が「javax.jms.Queue」の場合，対応するキュー※3を次の形式で表示します。

"<リソースアダプタの表示名>#<Queue名称>"

<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。

<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┃

┃

┣

┃

┃

<linked-queue>

0または1回

queue名称。

cjsetrespropでは無視されます。

<resource-env-ref-type>が「javax.jms.Queue」の場合だけ有効となります。

┃

┃

┃

┃

┣

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。

Connector1.5のリソースアダプタは指定できません。

┃

┃

┗

<queue>

1回

キューの表示名を指定します。

┃

┃

┃

┣

┃

┃

<linked-adminobject>

「機能解説 基本・開発編(コンテナ共通機能)」−「3.16」

0または1回

管理対象オブジェクト。cjsetrespropでは無視されます。

┃

┃

┃

┃

┣

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

Connector1.0以前のリソースアダプタは指定できません。

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

┃

┃

┃

┃

┗

<linked-to>

0または1回

JavaBeansリソースの表示名。

<resource-env-ref-type>に「Java.jms.リソースのクラス名」が指定された場合だけ有効となります。

cjsetrespropでは無視されます。

┣

<container-transaction>

0回以上

コンテナのトランザクションについての定義。

┃

┣

<description>※1

0回以上※2

container-transactionの説明。

┃

┣

<method>

1回以上

メソッドについての定義。

┃

┃

┣

<description>※1

0回以上※2

メソッドの説明。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。

このタグには，値を指定できません。ただし，設定先がEJB2.0以前のEJBの場合は，"Bean"を指定できます。

┃

┃

┃

┃

┣

┃

<method-name>

1回

メソッド名。

*を指定した場合，すべてのメソッドを表します。※4

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-params>

0または1回

method-nameが*以外の場合に有効。

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<method-param>

0回以上

パラメタのデータ型。

プリミティブ型またはクラスの名称を指定します。

配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにしてください）。多次元配列の場合は[]を続けて指定します（]と[の間を空けないようにしてください）。配列の内部形式名（int[]の場合[I，java.lang.String[]の場合[Ljava.lang.String;）は指定できません。

例

int

short[][]

java.lang.String[]

┃

┃

┃

┃

┃

┃

┃

┗

<trans-attribute>

1回

メソッドに割り当てるトランザクション属性。

指定できる文字列を次に示します。

Mandatory

Never

NotSupported

Required

RequiresNew

Supports

┣

┃

┃

<runtime>

0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃

┣

<pooled-instance>

1回

プール内のインスタンスについての定義。

┃

┃

┃

┃

┣

┃

<minimum>

「機能解説 基本・開発編(EJBコンテナ)」−「2.9.3」

1回

プール内のインスタンスの最小数。※3

1が表示されます。

┃

┃

┃

┃

┗

<maximum>

「機能解説 基本・開発編(EJBコンテナ)」−「2.9.3」

1回

プール内のインスタンスの最大数。

1≦maximum≦2147483647。

0を指定した場合，1が設定されます。

┃

┃

┃

┗

<front-ejb>

0または1回

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。フロントEJBの場合はtrueを指定し，フロントEJBでない場合はfalseを指定します。デフォルト値はfalseです。

┣

┃

┃

<start-order>

0または1回

J2EEアプリケーション開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0≦start-order≦2147483647

┣

┃

┃┃

┃

┃┃

┃

<ejb-method-observation-timeout>

「機能解説 運用／監視／連携編」−「5章」

0回以上

EJBのメソッドに仕掛かり中メソッド監視用タイムアウト時間を設定する場合に指定します。

<ejb-method-observation-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-method-observation-timeout>の<method-observation-timeout>の値が有効になります。

┃

┣

<method>

1回以上

−

┃

┃

┣

<description>

0または1回

メソッドの説明。このタグは複数指定できません。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別。

このタグには，値を指定できません。ただし，設定先がEJB2.0以前のEJBの場合は，"Bean"を指定できます。

┃

┃

┃

┃

┣

┃

<method-name>

1回

対象となるメソッド名を指定します。*を指定した場合，すべてのメソッドを表します。※4

┃

┃

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

┃

┃

┗

<method-param>

0回以上

引数のデータ型を指定。

┃

┃

┃

┗

<method-observation-timeout>

1回

仕掛かり中メソッド監視用タイムアウト時間を，0〜86400（単位：秒）で指定します。0を指定した場合，タイムアウトしません。デフォルト値は0。

┗

<ejb-transaction-timeout>

「機能解説 基本・開発編(コンテナ共通機能)」−「3.15.8」

0回以上

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効になります。

┣

<method>

1回以上

−

┃

┣

<description>

0または1回

メソッドの説明。このタグは複数指定できません。

┃

┃

┃

┃

┣

┃

┃

┃

<method-intf>

0または1回

メソッドが属するインタフェース種別を特定する場合に指定します。

このタグには，値を指定できません。ただし，設定先がEJB2.0以前のEJBの場合は，"Bean"を指定できます。

┃

┃

┣

┃

<method-name>

1回

対象となるメソッド名を指定します。*を指定した場合はすべてのメソッドを表します。※4

┃

┃

┗

<method-params>

0または1回

メソッドが多重定義されている場合，メソッドを特定するために指定します。

┃

┗

<method-param>

0回以上

引数のデータ型を指定。

┗

<transaction-timeout>

1回

トランザクションタイムアウト時間を，0〜2147483647（単位：秒）で指定します。0を指定した場合，タイムアウトしません。デフォルト値は0。

−

−

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※4

サーバ管理コマンド用のusrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleに「false」を指定している場合にこのタグで指定されたメソッドが存在しないとき，属性の設定でエラーになります。usrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleキーについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「5.2.3　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）」を参照してください。

3.6.2　DDとの対応

MessageDrivenBean属性ファイルとDeployment Descriptorの対応を次に示します。

(1)　EJB2.0の場合

MessageDrivenBean属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-message-bean-property>

1回

<ejb-jar>

1回

┃

−

−

┣

<description>

0または1回

┃

−

−

┗

<enterprise-beans>

1回

┃

−

−

┃

(省略)　

−

┃

−

−

┗

<message-driven>

1回以上

┣

<description>

0回以上

┣

<description>

0回以上

┣

<display-name>

1回以上

┣

<display-name>

0回以上

┣

<icon>

0回以上

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┗

<large-icon>

0または1回

┣

<transaction-type>

1回

┣

<transaction-type>

1回

┣

<message-selector>

0または1回

┣

<message-selector>

0または1回

┣

<acknowledge-mode>

0または1回

┣

<acknowledge-mode>

0または1回

┣

<message-driven-destination>

0または1回

┣

<message-driven-destination>

0または1回

┃

┣

<destination-type>

1回

┃

┣

<destination-type>

1回

┃

┗

<subscription-durability>

0または1回

┃

┗

<subscription-durability>

0または1回

┣

<env-entry>

0回以上

┣

<env-entry>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-type>

1回

┃

┣

<env-entry-type>

1回

┃

┗

<env-entry-value>

1回

┃

┗

<env-entry-value>

0または1回

┣

<ejb-ref>

0回以上

┣

<ejb-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<home>

1回

┃

┣

<home>

1回

┃

┣

<remote>

1回

┃

┣

<remote>

1回

┃

┗

<ejb-link>

0または1回

┃

┗

<ejb-link>

0または1回

┣

<ejb-local-ref>

0回以上

┣

<ejb-local-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<local-home>

1回

┃

┣

<local-home>

1回

┃

┣

<local>

1回

┃

┣

<local>

1回

┃

┗

<ejb-link>

0または1回

┃

┗

<ejb-link>

0または1回

┣

<security-identity>

0または1回

┣

<security-identity>

0または1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

−

−

┃

┣

<use-caller-identity>※

1回

┃

┗

<run-as>

1回

┃

┗

<run-as>※

1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┗

<role-name>

1回

┃

┗

<user-name>

1回

┃

−

−

┣

<container-transaction>

0回以上

┣

<container-transaction>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<method>

1回以上

┃

┣

<method>

1回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-name>

1回

┃

┃

┣

<method-name>

1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-param>

0回以上

┃

┃

┗

<method-param>

0回以上

┃

┗

<trans-attribute>

1回

┃

┗

<trans-attribute>

1回

┣

<resource-ref>

0回以上

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<res-ref-name>

1回

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

1回

┃

┣

<res-type>

1回

┃

┣

<res-auth>

1回

┃

┣

<res-auth>

1回

┃

┣

<res-sharing-scope>

0または1回

┃

┗

<res-sharing-scope>

0または1回

┃

┣

<mapped-name>

0または1回

┃

−

−

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<resource-env-ref>

0回以上

┗

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┣

<description>

0回以上

┃

┣

<resource-env-ref-name>

1回

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

1回

┗

<resource-env-ref-type>

1回

┃

┣

<mapped-name>

0または1回

−

−

┃

┗

<linked-queue>

0または1回

−

−

┃

┣

<resource-adapter>

1回

−

−

┃

┗

<queue>

1回

−

−

┗

<runtime>

0または1回

−

−

(省略)

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<use-caller-identity>と<run-as>のどちらか一つを指定します。

(2)　EJB2.1以降の場合

MessageDrivenBean属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-message-bean-property>

1回

<ejb-jar>

1回

┃

−

−

┣

<description>

0または1回

┃

−

−

┣

<enterprise-beans>

1回

┃

−

−

┗

┃

(省略)　

−

┃

−

−

┗

<message-driven>

1回以上

┣

<description>

0回以上

┣

<description>

0回以上

┣

<display-name>

1回以上

┣

<display-name>

0回以上

┣

<icon>

0回以上

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┗

<large-icon>

0または1回

┣

<messaging-type>

0または1回

┣

<messaging-type>

0または1回

┣

<transaction-type>

1回

┣

<transaction-type>

1回

┣

<activation-config>

0または1回

┣

<activation-config>

0または1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┗

<activation-config-property>

1回以上

┃

┗

<activation-config-property>

1回以上

┃

┣

<activation-config-property-name>

1回

┃

┣

<activation-config-property-name>

1回

┃

┗

<activation-config-property-value>

1回

┃

┗

<activation-config-property-value>

1回

┣

<env-entry>

0回以上

┣

<env-entry>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-type>

1回

┃

┣

<env-entry-type>

1回

┃

┗

<env-entry-value>

1回

┃

┗

<env-entry-value>

0または1回

┣

<ejb-ref>

0回以上

┣

<ejb-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<home>

1回

┃

┣

<home>

1回

┃

┣

<remote>

1回

┃

┣

<remote>

1回

┃

┗

<ejb-link>

0または1回

┃

┗

<ejb-link>

0または1回

┣

<ejb-local-ref>

0回以上

┣

<ejb-local-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<local-home>

1回

┃

┣

<local-home>

1回

┃

┣

<local>

1回

┃

┣

<local>

1回

┃

┗

<ejb-link>

0または1回

┃

┗

<ejb-link>

0または1回

┣

<security-identity>

0または1回

┣

<security-identity>

0または1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

−

−

┃

┣

<use-caller-identity>※

1回

┃

┗

<run-as>

1回

┃

┗

<run-as>※

1回

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┗

<role-name>

1回

┃

┗

<user-name>

1回

┃

−

−

┣

<container-transaction>

0回以上

┣

<container-transaction>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<method>

1回以上

┃

┣

<method>

1回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-name>

1回

┃

┃

┣

<method-name>

1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-param>

0回以上

┃

┃

┗

<method-param>

0回以上

┃

┗

<trans-attribute>

1回

┃

┗

<trans-attribute>

1回

┣

<resource-ref>

0回以上

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<res-ref-name>

1回

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

1回

┃

┣

<res-type>

1回

┃

┣

<res-auth>

1回

┃

┣

<res-auth>

1回

┃

┣

<res-sharing-scope>

0または1回

┃

┗

<res-sharing-scope>

0または1回

┃

┣

<mapped-name>

0または1回

┃

−

−

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<resource-env-ref>

0回以上

┗

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┣

<description>

0回以上

┃

┣

<resource-env-ref-name>

1回

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

1回

┗

<resource-env-ref-type>

1回

┃

┣

<mapped-name>

0または1回

−

−

┃

┣

<linked-queue>

0または1回

−

−

┃

┃

┣

<resource-adapter>

1回

−

−

┃

┃

┗

<queue>

1回

−

−

┃

┗

<linked-adminobject>

0または1回

−

−

┃

┣

<resourceadapter-name>

1回

−

−

┃

┗

<adminobject-name>

1回

−

−

┗

<runtime>

0または1回

−

−

(省略)

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<use-caller-identity>と<run-as>のどちらか一つを指定します。

3.6.3　cosminexus.xmlとの対応

MessageDrivenBean属性ファイルとcosminexus.xmlの対応を次に示します。

Message Driven Bean属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

<hitachi-message-bean-property>

1回

┃

┣

<message>

0回以上

┃

−

−

┃

┃

┃

<ejb-name>※1

1回

┣

<security-identity>

0または1回

┃

┃

┣

<security-identity>

0または1回

┃

┗

<run-as>

1回

┃

┃

┃

┗

<run-as>

1回

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<role-name>

1回

┃

┃

┃

┃

−

−

┃

┗

<user-name>

1回

┃

┃

┃

┗

<user-name>

1回

┣

<ejb-ref>

0回以上

┃

┃

┃

−

−

┃

┣

<destination>

0回以上

┃

┃

┃

−

−

┃

┣

<ejb-ref-name>

1回

┃

┃

┃

−

−

┃

┣

<ejb-ref-type>

1回

┃

┃

┃

−

−

┃

┣

<home>

1回

┃

┃

┃

−

−

┃

┣

<remote>

1回

┃

┃

┃

−

−

┃

┗

<ejb-link>

0または1回

┃

┃

┃

−

−

┣

<message-ref>

0または1回

┃

┃

┣

<message-ref>

0または1回

┃

┃

Connector1.0の場合

┃

┃

┃

┃

Connector1.0の場合

┃

┣

<connection-factory>

0または1回

┃

┃

┃

┣

<connection-factory>

0または1回

┃

┣

<connection-destination>

1回

┃

┃

┃

┣

<connection-destination>※2

0または1回

┃

┃

┣

<resource-adapter>※3

1回

┃

┃

┃

┃

┣

<resource-adapter>

1回

┃

┃

┗

<queue>※3

0または1回

┃

┃

┃

┃

┗

<queue>※2

0または1回

┃

┃

Connector1.5の場合

┃

┃

┃

┃

Connector1.5の場合

┃

┗

<connection-destination>

1回

┃

┃

┃

┗

<connection-destination>※2

0または1回

┃

┗

<resource-adapter>

1回

┃

┃

┃

┗

<resource-adapter>

1回

┣

<resource-ref>

0回以上

┃

┃

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<res-ref-name>

1回

┃

┃

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

1回

┃

┃

┃

┃

−

−

┃

┣

<res-auth>

1回

┃

┃

┃

┃

−

−

┃

┣

<res-sharing-scope>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┃

┃

┃

−

−

┃

┗

<linked-to>

0または1回

┃

┃

┃

┗

<linked-to>※2

1回

┣

<resource-env-ref>

0回以上

┃

┃

┣

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<resource-env-ref-name>

1回

┃

┃

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

1回

┃

┃

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<linked-queue>

0または1回

┃

┃

┃

┣

<linked-queue>※2

1回

┃

┃

┣

<resource-adapter>※3

1回

┃

┃

┃

┃

┣

<resource-adapter>

1回

┃

┃

┗

<queue>※3

1回

┃

┃

┃

┃

┗

<queue>

1回

┃

┣

<linked-adminobject>

0または1回

┃

┃

┃

┣

<linked-adminobject>※2

1回

┃

┃

┣

<resourceadapter-name>※4

1回

┃

┃

┃

┃

┣

<resourceadapter-name>

1回

┃

┃

┗

<adminobject-name>※4

1回

┃

┃

┃

┃

┗

<adminobject-name>

1回

┃

┗

<linked-to>

0または1回

┃

┃

┃

┗

<linked-to>※2

1回

┣

<runtime>

0または1回

┃

┃

┃

−

−

┃

┣

<pooled-instance>

1回

┃

┃

┣

<pooled-instance>※2

0または1回

┃

┃

┣

<minimum>

1回

┃

┃

┃

┣

<minimum>※2

0または1回

┃

┃

┗

<maximum>

1回

┃

┃

┃

┗

<maximum>※2

0または1回

┃

┗

<front-ejb>

0または1回

┃

┃

┣

<front-ejb>

0または1回

┣

<start-order>

0または1回

┃

┃

┣

<start-order>

0または1回

┣

<ejb-method-observation-timeout>

0回以上

┃

┃

┣

<ejb-method-observation-timeout>

0回以上

┃

┣

<method>

1回以上

┃

┃

┃

┣

<method>

1回以上

┃

┃

┣

<description>

0または1回

┃

┃

┃

┃

┃

−

−

┃

┃

┣

<method-intf>

0または1回

┃

┃

┃

┃

┣

<method-intf>

0または1回

┃

┃

┣

<method-name>

1回

┃

┃

┃

┃

┣

<method-name>

1回

┃

┃

┗

<method-params>

0または1回

┃

┃

┃

┃

┗

<method-params>

0または1回

┃

┃

┗

<method-param>

0回以上

┃

┃

┃

┃

┗

<method-param>

0回以上

┃

┗

<method-observation-timeout>

1回

┃

┃

┃

┗

<method-observation-timeout>

1回

┗

<ejb-transaction-timeout>

0回以上

┃

┃

┗

<ejb-transaction-timeout>

0回以上

┣

<method>

1回以上

┃

┃

┣

<method>

1回以上

┃

┣

<description>

0または1回

┃

┃

┃

┃

−

−

┃

┣

<method-intf>

0または1回

┃

┃

┃

┣

<method-intf>

0または1回

┃

┣

<method-name>

1回

┃

┃

┃

┣

<method-name>

1回

┃

┗

<method-params>

0または1回

┃

┃

┃

┗

<method-params>

0または1回

┃

┗

<method-param>

0回以上

┃

┃

┃

┗

<method-param>

0回以上

┗

<transaction-timeout>

1回

┃

┃

┗

<transaction-timeout>

1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

注※1

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<message-driven>-<ejb-name>に対応し，属性ファイルには存在しないタグとなります。Message-Driven Beanを特定するためのキーとなります。

注※2

cosminexus.xmlはカスタマイズしたい要素だけを記述する形式となるため，属性ファイルと出現パターンが異なります。

注※3

resource-adapterにはリソースアダプタ表示名，<queue>にはキュー名が入ります。

注※4

<resourceadapter-name>にはリソースアダプタ表示名，<adminobject-name>には管理対象オブジェクト名が入ります。

3.7　WAR属性ファイル

WAR属性ファイルは，WARの属性を取得，編集する場合に使用するファイルです。

3.7.1　WAR属性ファイルの指定内容

WAR属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-war-property PUBLIC '-//Hitachi, Ltd.//DTD War Property 9.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-war-property_9_0.dtd'>

WAR属性ファイルは，次に示すタグを持つxmlファイルです。なお，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名の欄にあるマニュアルの参照先には，そのタグの関連情報があります。マニュアル名に「アプリケーションサーバ」と記載されたマニュアルについては，名称を省略しています。

(1)　web.xmlを含む場合

タグ名

出現パターン

説明

<hitachi-war-property>

1回

ルートタグ。

┣

<description>※1

0回以上※1

WARの説明。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<display-name>※1

1回以上※1

WARの表示名。

xml:lang属性が"en"のdisplay-nameを必ず指定します。該当するリソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。

1≦文字列長

xml:lang属性が"en"のタグの場合，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

xml:lang属性が"en"のタグ以外の場合，文字の制限はありません。

┣

┃

<icon>※1

0回以上※1

Deployツール上に表示されるWebアプリケーションのアイコンの定義。

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。

┣

┃

┃

<distributable>

0または1回

分散したサーブレットコンテナにデプロイできるようにプログラムされている場合に指定。なお，このタグは値を持ちません。

┣

<context-param>

0回以上

コンテキスト初期化パラメタについての定義。

┃

┣

<description>※1

0回以上※1

Context-paramの説明。

┃

┣

<param-name>

1回

コンテキスト初期化パラメタ名。

┃

┗

<param-value>

1回

コンテキスト初期化パラメタの値。

┣

┃

<filter-mapping>

0回以上

Webアプリケーションのフィルタマッピングの定義。

┃

┣

<filter-name>

1回

マッピングを行うフィルタの名称。

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<url-pattern>

1回以上

マッピングをするサーブレットのURL。

Servlet2.4以前のWARに対して，このタグを指定できる回数は1回です。<url-pattern>と<servlet-name>のどちらか一つを指定します。

ただし，Servlet2.5のWARに対しては，<url-pattern>と<servlet-name>の両方を指定できます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<servlet-name>

1回以上

マッピングをするサーブレットの名称。

すべてのサーブレットを意味するアスタリスク（*）を指定できます。Servlet2.4以前のWARに対して，このタグを指定できる回数は1回です。<url-pattern>と<servlet-name>のどちらか一つを指定します。

ただし，Servlet2.5のWARに対しては，<url-pattern>と<servlet-name>の両方を指定できます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<dispatcher>

0または5回以下

フィルタの適用条件。

次のどれかを指定します。

FORWARD

RequestDispatcher.forward( )の処理のときだけフィルタを適用します。

INCLUDE

RequestDispatcher.include( )の処理のときだけフィルタを適用します。

REQUEST

通常のクライアントからのアクセスのときだけフィルタを適用します。

ASYNC

AsyncContextからディスパッチされたときだけフィルタを適用します。09-00ではASYNCを指定しても無視します。

ERROR

例外処理のときだけフィルタを適用します。

Servlet2.3以前のWARに対して，このタグを指定できません。

┣

<listener>

0回以上

リスナーについての定義。

┃

┃

┃

┃

┣

┃

┃

┃

<description>※1

0回以上

WebアプリケーションリスナーBeanについての説明。

Servlet2.3以前のWARに対して，このタグを指定できません。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<display-name>※1

0回以上

GUIツール上に表示されるWebアプリケーションリスナーBeanの名称。

指定する文字列は一意である必要はありません。

Servlet2.3以前のWARに対して，このタグを指定できません。

┃

┃

┃

┃

┣

┃

┃

┃

<icon>※1

0回以上※1

GUIツール上に表示されるWebアプリケーションリスナーBeanのアイコンの定義。

Servlet2.3以前のWARに対して，このタグを指定できません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<small-icon>

0または1回

WebアプリケーションリスナーBeanの小アイコン用の画像ファイル名。

WARファイル中での画像ファイルの場所をルートからの相対パスで指定します。画像ファイルのサイズは16×16です。画像ファイルの形式は，JPEGファイルかGIFファイルです。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<large-icon>

0または1回

WebアプリケーションリスナーBeanの大アイコン用の画像ファイル名。

WARファイル中での画像ファイルの場所をルートからの相対パスで指定します。画像ファイルのサイズは32×32です。画像ファイルの形式は，JPEGファイルかGIFファイルです。

┃

┗

<listener-class>

1回

設定したリスナークラス名。

┣

┃

<session-config>

0回以上

セッションについての定義。

このタグを複数指定できません。

┃

┃

┃

┃

┗

<session-timeout>

0または1回

デフォルトのセッションタイムアウト間隔（分）。

-1（タイムアウトしません），0（-1と等価です），1≦session-timeout≦35791394が指定できます。デフォルトは30です。

┣

<mime-mapping>

0回以上

MIMEタイプのマッピングについての定義。※3

┃

┣

<extension>

1回

ファイルの拡張子。※3

┃

┗

<mime-type>

1回

MIMEタイプ。※3

┣

<welcome-file-list>

0回以上※1

welcomeファイルについての定義。

┃

┗

<welcome-file>

1回以上

welcomeファイル名。

┣

<error-page>

0回以上

エラーページについての定義。

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<error-code>※4

どちらか1回，またはどちらもなし

HTTPエラーコード。

HTTPエラーコードとエラーページリソースとをマッピングする場合に指定します。

-2147483648≦error-code≦2147483647になるように指定してください。<error-code>と<exception-type>のどちらか一つを指定するか，どちらも指定しません。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<exception-type>※4

どちらか1回，またはどちらもなし

例外クラス名（完全修飾名）。

例外タイプとエラーページリソースとをマッピングする場合に指定します。

<error-code>と<exception-type>のどちらか一つを指定するか，どちらも指定しません。

┃

┗

<location>

1回

先頭が「/」で始まる値。

┣

┃

┃

┃

<jsp-config>

0回以上

Webアプリケーション内のJSPの定義。

このタグを複数指定できません。また，Servlet2.3以前のWARに対して，このタグを指定できません。

┃

┃

┃

┃

┣

┃

┃

┃

<taglib>

0回以上

Servlet2.4以降の場合のタグライブラリについての定義。

Servlet2.3以前の場合は<hitachi-war-property>タグの下の<taglib>で定義します。

┃

┃

┃

┃

┣

┃

<taglib-uri>

1回

JSPプログラムのtaglibディレクティブのuri属性に指定された値。

┃

┃

┃

┃

┗

<taglib-location>

1回

tldファイルの配置場所（コンテキストルートからの相対パス）。

┃

┃

┗

<jsp-property-group>

0回以上

指定したURLパターンに合致するJSPプログラムの個別の設定。

┃

┃

┣

┃

<description>※1

0回以上

WebアプリケーションリスナーBeanについての説明。

┃

┃

┃

┣

┃

┃

<display-name>※1

0回以上

GUIツール上に表示されるJSPプロパティグループの名称。

指定する文字列は一意である必要はありません。

┃

┃

┣

┃

<icon>※1

0回以上

GUIツール上に表示されるJSPプロパティグループのアイコンの定義。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<small-icon>

0または1回

JSPプロパティグループの小アイコン用の画像ファイル名。

WARファイル中での画像ファイルの場所をルートからの相対パスで指定します。画像ファイルのサイズは16×16です。画像ファイルの形式は，JPEGファイルかGIFファイルです。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<large-icon>

0または1回

JSPプロパティグループの大アイコン用の画像ファイル名。

WARファイル中での画像ファイルの場所をルートからの相対パスで指定します。画像ファイルのサイズは32×32です。画像ファイルの形式は，JPEGファイルかGIFファイルです。

┃

┣

<url-pattern>

1回以上

パラメタを適用するURLパターン。

┃

┃

┃

┃

┣

┃

┃

┃

<el-ignored>

0または1回

EL（式言語）を無視するかどうかの指定。

指定できる文字列を次に示します。

true（無視する場合）

false（無視しない場合）

┃

┣

<page-encoding>

0または1回

ページエンコーディング名。

┃

┃

┣

┃

<scripting-invalid>

0または1回

スクリプティング要素を無効にするかどうかの指定。

┃

┣

<is-xml>

0または1回

XML構文で記述されているかどうかの指定。

┃

┃

┃

┣

┃

┃

<include-prelude>

0回以上

各ページのヘッダとしてインクルードするファイルのパス（コンテキストルートからの相対パス）。

┃

┃

┃

┣

┃

┃

<include-coda>

0回以上

各ページのフッタとしてインクルードするファイルのパス（コンテキストルートからの相対パス）。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<deferred-syntax-allowed-as-literal>

0または1回

ELが使用できない部分で，#{の文字列があった場合にエラーにするかの定義。デフォルトはfalseです。

true

文字列リテラルとして使用します。

false

文字列リテラルとして使用しません。

Servlet 2.4以前のWARに対して，このタグを指定できません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<trim-directive-whitespaces>

0または1回

JSPから余分な空白を出力しないようにするかの定義。デフォルトはfalseです。

true

余分な空白を削除します。

false

余分な空白を削除しません。

Servlet 2.4以前のWARに対して，このタグを指定できません。

┃

┃

┣

┃

<default-content-type>

0または1回

pageディレクティブのcontentType属性のデフォルトを指定します。

┃

┃

┣

┃

<buffer>

0または1回

pageディレクティブのbuffer属性のデフォルトを指定します。

┃

┃

┃

┃

┗

<error-on-undeclared-namespace>

0または1回

JSPページで未知の名前空間を使用した場合にエラーにするかどうかをtrueまたはfalseで指定します。デフォルトはfalseです。

┣

┃

┃

┃

<taglib>

0回以上

Servlet2.3以前の場合のタグライブラリについての定義。

Servlet2.4以降の場合は<jsp-config>タグの下の<taglib>で定義します。

┃

┃

┣

┃

<taglib-uri>

1回

タグライブラリのURI（web.xmlに対する相対的なURI）。

┃

┃

┃

┗

<taglib-location>

1回

タグライブラリ記述ファイル（TLD）の場所（Webアプリケーションのルートからの相対位置）。

┣

<security-constraint>

0回以上

セキュリティ制約についての定義。

┃

┣

<display-name>※1

0回以上※1

セキュリティ制約の名称。

┃

┣

<web-resource-collection>

1回以上

Webリソースコレクションについての定義。

┃

┃

┣

<description>※1

0回以上※1

web-resource-collectionの説明。

┃

┃

┣

<web-resource-name>

1回

Webリソースコレクションの名称。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<url-pattern>

1回以上

WebリソースのURL。

Servlet2.3以前のWARに対して，本タグを指定できる回数は0回以上です。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<http-method>

1回以上

セキュリティ制約を適用するHTTPメソッド。

Servlet2.4以前のWARに対して，このタグに指定できる文字列を次に示します。

DELETE

GET

HEAD

OPTIONS

POST

PUT

TRACE

Servlet2.5以降のWARに対して，このタグには英数字，および特殊文字（!#$%&'*+-.^_`|~）を1回以上指定します。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<http-method-omission>

1回以上

セキュリティ制約を適用しないHTTPメソッド。

Servlet3.0以降のWARに対して，このタグには英数字，および特殊文字（!#$%&'*+-.^_`|~）を1回以上指定します。

┃

┃

┣

┃

<auth-constraint>

0または1回

Webリソースコレクションに対してアクセスを許可するロールについての定義。

┃

┃

┣

<description>※1

0回以上※1

auth-constraintの説明。

┃

┃

┃

┃

┗

<role-name>

0回以上

Webリソースコレクションに対してアクセスを許可するロール。

┃

┃

┣

┃

<user-data-constraint>

0または1回

クライアントとコンテナ間のデータ通信がどのように保護されるのかの定義。

┃

┃

┣

<description>※1

0回以上※1

user-data-constraintの説明。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<transport-guarantee>

1回

クライアントとコンテナ間のデータ通信がどのように保護されるのかの定義。

指定できる文字列を次に示します。

NONE

アプリケーションはトランスポート保証を必要としません。

INTEGRAL

アプリケーションは通信データが伝送中に変更を加えられないような方法でデータ通信をすることを要求します。

CONFIDENTIAL

アプリケーションはほかのエンティティが伝送の内容を見ることができないような方法でデータ通信をすることを要求します。

┃

┃

┃

┃

┗

<original-name>

1回

security-constraintのdisplay-nameの設定値を属性出力時に格納し保管します。※5

このタグの設定内容の変更，およびタグ自体の削除はできません。

┣

┃

<login-config>

0回以上

ログイン方法についての定義。

このタグを複数指定できません。

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<auth-method>

0または1回

認証方式。

指定できる文字列を次に示します。

BASIC

FORM

CLIENT-CERT

デフォルトはBASIC（DIGESTは未サポート）。

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<realm-name>

0または1回

レルム名。

auth-methodにBASICを指定した場合

必須

auth-methodにBASIC以外を指定した場合

cjsetappprop，cjsetrespropで無視されます。

┃

┃

┃

┃

┃

┗

<form-login-config>

0または1回

auth-methodにFORMを指定した場合

必須

auth-methodにFORM以外を指定した場合

cjsetappprop，cjsetrespropで無視されます。

┃

┃

┣

┃

<form-login-page>

1回

ログイン時に使用するページ。設定する値は先頭を'/'で始めてください。

┃

┃

┗

<form-error-page>

1回

ログインに失敗したときに表示するエラーページ。設定する値は先頭を'/'で始めてください。

┣

<security-role>

0回以上

セキュリティロールについての定義。※6

┃

┣

<description>※1

0回以上※1

security-roleの説明。※6

┃

┣

<role-name>

1回

ロール名称。※6

┃

┃

┗

<linked-to>

0または1回

cjaddsecコマンドで定義したロール名。

cjsetrespropで使用する場合，無視されます。

┣

<env-entry>

0回以上

環境エントリについての定義。※5

┃

┣

<description>※1

0回以上※1

環境エントリの説明。※5

┃

┣

<env-entry-name>

1回

環境エントリの名称。※5

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<env-entry-type>

0または1回

環境エントリのデータ型。※6

指定できる文字列を次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

java.lang.Character

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<env-entry-value>

1回

環境エントリの値。※5

env-entry-typeで指定した型に適合した値を指定します。

env-entry-typeにjava.lang.String以外を指定した場合，空文字の指定はできません。

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※6

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┣

┃

<ejb-ref>

0回以上

リモートインタフェースを持つEnterprise Beanへの参照情報についての定義。※6

┃

┣

<description>※1

0回以上※1

ejb-refの説明。※6

┃

┣

<ejb-ref-name>

1回

ejb-refの名称。※6

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

0または1回

リンク先のEnterprise Beanの種別。※6

指定できる文字列を次に示します。

Entity

Session

┃

┃

┣

┃

<home>

0または1回

リンク先のHomeインタフェースクラス名。※6

┃

┃

┣

┃

<remote>

0または1回

リンク先のComponentインタフェースクラス名。※6

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<ejb-link>

0または1回

リンク先のejb-name。※6

ネーミングの切り替え機能でリンク先を設定する場合，次の形式で指定します。

corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBHomeオブジェクトリファレンスのJNDI名>

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※6

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┣

┃

<ejb-local-ref>

0回以上

ローカルインタフェースを持つEnterprise Beanへの参照情報についての定義。※6

┃

┣

<description>※1

0回以上※1

ejb-local-refの説明。※6

┃

┣

<ejb-ref-name>

1回

ejb-local-refの名称。※6

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

1回

リンク先のEnterprise Beanの種別。※6

指定できる文字列を次に示します。

Entity

Session

┃

┃

┣

┃

<local-home>

1回

リンク先のEnterprise BeanのLocal Homeインタフェース名。※6

┃

┃

┣

┃

<local>

1回

リンク先のEnterprise BeanのLocal Componentインタフェース名。※6

┃

┣

<ejb-link>

0または1回

リンク先のejb-name。※6

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※6

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┣

<resource-ref>

0回以上

リソース参照についての定義。

┃

┣

<description>※1

0回以上※1

resource-refの説明。※6

┃

┣

<res-ref-name>

1回

resource-refの名称。※6

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<res-type>

0または1回

リソース種別。※6

指定可能な文字列は次のとおり。

javax.mail.Session

javax.sql.DataSource

javax.jms.QueueConnectionFactory

javax.jms.ConnectionFactory

javax.resource.cci.ConnectionFactory

org.omg.CORBA_2_3.ORB（DDで定義しなくてもlookupできるリソース）

javax.jms.TopicConnectionFactory

参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子(<connectionfactory-interface>タグの設定値)を指定します。

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<res-auth>

0または1回

認証方式。※6

指定できる文字列を次に示します。

Application

Container

Servlet2.5以降の場合，デフォルトはContainerとなります。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<res-sharing-scope>

0または1回

参照したリソースを共有するかどうかを指定します。※6

指定できる文字列を次に示します。

Shareable

Unshareable

┃

┃

┃

┃

┣

┃

┃

┃

<mapped-name>

0または1回

対応するリソースアダプタ表示名またはメール表示名。※6

<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┣

<injection-target>

0回以上

Dependency Injectionの設定。※6

┃

┃

┃

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

0または1回

対応するリソースアダプタ表示名，データソース表示名またはメール表示名を指定します。※6

リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

cjsetrespropで使用する場合は無視されます。

┣

<resource-env-ref>

0回以上

リソース環境変数についての定義。※6

┃

┣

<description>※1

0回以上※1

resource-env-refの説明。※6

┃

┣

<resource-env-ref-name>

1回

resource-env-refの名称。※6

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<resource-env-ref-type>

0または1回

リソース環境変数の値のクラスタイプ。※6

指定できる文字列を次に示します。

javax.jms.Queue

javax.jms.Topic

javax.transaction.UserTransaction

javax.ejb.TimerService

javax.ejb.EJBContext

JavaBeansリソースのクラス名

javax.transaction.UserTransaction，javax.ejb.TimerService，javax.ejb.EJBContextは，アノテーションを使用した場合にだけ出力されます。ただし，この値を設定することはできません。

<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<mapped-name>

0または1回

<resource-env-ref-type>が「javax.jms.Queue」の場合，対応するキュー※6を次の形式で表示します。

"<リソースアダプタの表示名>#<Queue名称>"

<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。

<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┣

<injection-target>

0回以上

Dependency Injectionの設定。※6

┃

┃

┃

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<linked-queue>

0または1回

対応するデータソース表示名またはメール表示名。※6

cjsetrespropで使用する場合は無視されます。

<resource-env-ref-type>に「javax.jms.Queue」が指定された場合だけ有効となります。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。※6

Connector1.5のリソースアダプタは指定できません。

┃

┃

┗

<queue>

1回

キューの表示名を指定します。※6

┃

┃

┣

┃

<linked-adminobject>

0または1回

管理対象オブジェクト。

cjsetrespropでは無視されます。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

Connector1.0以前のリソースアダプタは指定できません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

┃

┃

┃

┃

┃

┃

┗

<linked-to>

0または1回

JavaBeansリソースの表示名を指定します。※6

<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効となります。

cjsetrespropで使用する場合は無視されます。

┣

<persistence-context-ref>

0回以上

永続化コンテキストの設定を記述します。

┃

┃

┣

┃

<description>※1

0回以上※2

永続化コンテキストについての説明を記述します。※6

┃

┃

┃

┣

┃

┃

<persistence-context-ref-name>

1回

永続化コンテキストの参照の名称を設定します。名称はjava:comp/envコンテキストに関連づけられたJNDI名。※6

┃

┣

<persistence-unit-name>

0または1回

永続化ユニットの名前を設定します。※6

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<persistence-context-type>

0または1回

永続化コンテキストの参照のtransactional natureを設定します。指定可能な文字列は以下のとおり。※6

Transaction

Extended

┃

┃

┣

┃

<persistence-property>

0回以上

コンテナまたは，永続化プロバイダのプロパティを設定します。※6

┃

┃

┣

<name>

1回

プロパティの名称を設定します。※6

┃

┃

┗

<value>

1回

プロパティの値を設定します。※6

┃

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定を記述します。※6

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名を指定します。パッケージが定義されている場合は，そのパッケージから指定します。※6

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子を指定します。

┣

<persistence-unit-ref>

0回以上

永続化ユニットの参照の設定を記述します。※6

┃

┃

┣

┃

<description>

0回以上

永続化ユニットの参照についての説明を記述します。※6

┃

┃

┃

┣

┃

┃

<persistence-unit-ref-name>

1回

永続化ユニットの参照の名称を設定します。名称はjava:comp/envコンテキストに関連づけられたJNDI名。※6

┃

┣

<persistence-unit-name>

0または1回

永続化ユニットの名前を設定します。※6

┃

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定を記述します。※6

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名を指定します。パッケージが定義されている場合は，そのパッケージから指定します。※6

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子を指定します。※6

┣

┃

<post-construct>

0回以上

post-constructメソッドの定義を記述します。※6

┃

┃

┃

┣

┃

┃

<lifecycle-callback-class>

0または1回

post-constructメソッドを保持するクラスの名称を記述します。省略時は，<post-construct>タグの指定が無視されます。※6

┃

┗

<lifecycle-callback-method>

1回

post-constructメソッド名を記述します。※6

┣

<pre-destroy>

0回以上

pre-destroyメソッドの定義を記述します。※6

┃

┃

┃

┣

┃

┃

<lifecycle-callback-class>

0または1回

pre-destroyメソッドを保持するクラスの名称を記述します。省略時は，<pre-destroy>タグの指定が無視されます。※6

┃

┗

<lifecycle-callback-method>

1回

pre-destroyメソッド名を記述します。※6

┣

┃

┃

┃

<locale-encoding-mapping-list>

0回以上※1

ロケールとエンコーディング方法のマッピングの設定。

Servlet2.3以前のWARに対して，このタグを指定できません。

┃

┃

┗

<locale-encoding-mapping>

1回以上

ロケールとエンコーディング方法のマッピングの設定。

┃

┣

<locale>

1回

ロケールを記述。

┃

┗

<encoding>

1回

エンコード方法を記述。

┣

┃

┃

┃

<runtime>

0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃

┃

┃

┃

┗

<context-root>

1回

コンテキストルート。

指定できる文字は，URI（RFC3986）で使用できる文字です。ルート指定時は，空文字列またはスラッシュ（/）を指定してください。

┣

┃

┃

<thread-control>

「機能解説 基本・開発編(Webコンテナ)」−「2.15」

0または1回

スレッド制御グループの設定。

cjsetrespropで使用する場合は無視されます。

┃

┃

┃

┃

┣

┃

┃

┃

<thread-control-max-threads>

1回

Webアプリケーション単位の最大同時実行スレッド数。

占有スレッド数以上の値を指定してください。

1〜1024

┃

┃

┃

┃

┣

┃

┃

┃

<thread-control-exclusive-threads>

1回

占有スレッド数。

Webアプリケーション単位の最大同時実行スレッド数以下の値を指定してください。

0〜1024

┃

┃

┃

┣

┃

┃

<thread-control-queue-size>

1回

Webアプリケーション単位の実行待ちキューサイズ。

0〜2147483647

┃

┣

<thread-control-stats-monitor>

「機能解説 運用／監視／連携編」−「3.4」

1回

稼働統計の監視の設定。

┃

┃

┃

┃

┣

┃

<whole-waiting-request-count>

1回

Webアプリケーション単位の全体実行待ちリクエスト数の監視をします。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<enabled>

1回

Webアプリケーション単位の全体実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<high-threshold>

1回

しきい値イベントを出力する上限のしきい値を1〜100の整数値（単位：%）で指定します。デフォルトは80です。

ただし，<low-threshold>タグの指定値以上の値である必要があります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<low-threshold>

1回

しきい値イベントを出力する下限しきい値を0〜99の整数値（単位：%）で指定します。

デフォルトは0です。

ただし，<high-threshold>タグの指定値以下の値である必要があります。

┃

┃

┃

┃

┗

<waiting-request-count>

1回

Webアプリケーション単位の実行待ちリクエスト数の監視をします。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<enabled>

1回

Webアプリケーション単位の実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<high-threshold>

1回

しきい値イベントを出力する上限のしきい値を1〜100の整数値（単位：%）で指定します。デフォルトは80です。

ただし，<low-threshold>タグの指定値以上の値である必要があります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<low-threshold>

1回

しきい値イベントを出力する下限しきい値を0〜99の整数値（単位：%）で指定します。

デフォルトは0です。

ただし，<high-threshold>タグの指定値以下の値である必要があります。

┃

┃

┣

┃

<resource-watcher>

1回

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視に関するプロパティ。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-threshold>

1回

アラートメッセージを出力するしきい値。

1〜100の整数値（単位：%）を指定します。デフォルトは80です。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-interval>

1回

監視間隔。

1〜2147483647の整数値（単位：秒）で指定します。デフォルトは30です。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<watcher-enabled>

1回

リクエスト実行待ちキュー格納数の監視を有効にするかどうかの指定。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。<thread-control-queue-size>に0を指定した場合は監視は無効となります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

1回

リソース使用状況をファイルに出力するかどうかの指定。

指定できる文字列を次に示します。

true（出力する）

false（出力しない）

デフォルトはtrueです。

┃

┃

┃

┗

<urlgroup-thread-control>

「機能解説 基本・開発編(Webコンテナ)」−「2.16」

0回以上

URLグループ単位の同時実行スレッド数制御。

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<urlgroup-thread-control-name>

1回

URLグループ単位の同時実行スレッド数制御の定義名。

URLグループ単位の同時スレッド数制御の定義名にはWebアプリケーション内で一意となる文字列を指定します。英数字（0〜9，A〜Z，a〜z），ハイフン（-）およびアンダースコア（_）が使用できます。文字列の長さは1≦文字列長≦64で指定してください。

┃

┃

┃

┣

┃

┃

<urlgroup-thread-control-max-threads>

1回

URLグループ単位の最大同時実行スレッド数。

1〜thread-control-max-threadsの整数値を指定します。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<urlgroup-thread-control-exclusive-threads>

1回

URLグループ単位の占有スレッド数。

指定できる値は，0〜urlgroup-thread-control-max-threadsかつthread-control-exclusive-threads以下です。なお，<urlgroup-thread-control>を定義している場合は次の設定範囲を満たす必要があります。

thread-control-max-threads ≠ thread-control-exclusive-threadsの場合　thread-control-exclusive-threads　≧ urlgroup-thread-control-exclusive-threadsの総和。

thread-control-max-threads ＝ thread-control-exclusive-threadsの場合　thread-control-exclusive-threads　＞ urlgroup-thread-control-exclusive-threadsの総和。

┃

┃

┃

┣

┃

┃

<urlgroup-thread-control-queue-size>

1回

URLグループ単位の実行待ちキューのサイズ。

指定できる値は，0〜2147483647の整数値です。

┃

┃

┃

┃

┃

┃

<urlgroup-thread-control-mapping>

0回以上

制御対象となるURLのマッピング情報。

省略時は，制御対象となるURLがない状態で動作します。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<url-pattern>

1回

制御対象となるURLパターン。

一つのWebアプリケーション内で同じURLパターンを指定することはできません。指定例を次に示します。

/soda/grape/*

/foo/*

/contents

*.foo

┃

┗

<stats-monitor>

「機能解説 運用／監視／連携編」−「3.4」

1回

稼働統計の設定。

┃

┃

┗

<waiting-request-count>

1回

URLグループ単位の実行待ちリクエスト数を監視。

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<enabled>

1回

URLグループ単位の実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかの指定。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

┃

┃

┃

┃

┣

┃

┃

┃

<high-threshold>

1回

しきい値イベントを出力する上限しきい値。

指定できる値は，1〜100の整数値（単位：%）です。なお，low-threshold以上の値を指定してください。

┃

┃

┃

┃

┗

<low-threshold>

1回

しきい値イベントを出力する下限しきい値。

指定できる値は，0〜99の整数値（単位：%）です。なお，high-threshold以下の値を指定してください。

┣

<http-request>

0または1回

−

┃

┃

┃

┃

┃

┃

┗

<encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

0または1回

リクエストボディ，およびクエリのデコードに使用するデフォルトのエンコーディングを指定します。

JavaVMがサポートしている文字エンコーディングを指定します。※7

デフォルトは指定なしです。

┣

<http-response>

0または1回

−

┃

┃

┃

┃

┃

┗

<encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

0または1回

レスポンスボディのエンコードに使用するデフォルトのエンコーディングを指定します。

JavaVMがサポートしている文字エンコーディングを指定します。※7

デフォルトは指定なしです。

┣

<jsp>

0または1回

−

┃

┃

┃

┃

┃

┗

<page-encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

0または1回

JSPファイルの読み込みに使用するデフォルトのエンコーディングを指定します。

JavaVMがサポートしている文字エンコーディングを指定します。※7

デフォルトは指定なしです。

┣

<http-session>

0または1回

−

┃

┃

┃

┃

┣

┃

┃

┃

<http-session-max-number>

「機能解説 基本・開発編(Webコンテナ)」−「2.7.5」

1回

使用可能なHttpSessionの最大数。

指定できる値は，-1〜2147483647の整数値です。-1を指定した場合は無制限となります。デフォルトは，-1です。

┃

┃

┣

┃

<resource-watcher>

1回

HttpSession数の監視に関するプロパティを設定。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-threshold>

1回

アラートメッセージを出力するしきい値。

指定できる値は，1〜100の整数値（単位：%）です。デフォルトは80です。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-interval>

1回

監視間隔。

指定できる値は，1〜2147483647の整数値（単位：秒）です。デフォルトは30です。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<watcher-enabled>

1回

HttpSession数の監視を有効にするかどうかの指定。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。ただし，http-session-max-numberに0を指定した場合，監視は無効となります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

1回

リソース使用状況をファイルに出力するかどうかの指定。指定できる文字列を次に示します。

true（出力する）

false（出力しない）

デフォルトはtrueです。

┃

┃

┗

<dbsfo>

「機能解説 拡張編」−「6章」

0または1回

データベースセッションフェイルオーバ機能の設定をします。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<enabled>

0または1回

データベースセッションフェイルオーバ機能を有効にするかどうかの指定。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

┃

┃

┃

┣

┃

┃

<application-id>

0または1回

アプリケーション識別子を設定します。英数字（0〜9,A〜Z,a〜z），アンダースコア（_）だけ使用できます。最大16文字まで指定できます。

┃

┃

┃

┃

┣

┃

┃

┃

<attribute-data-size-max>

0または1回

グローバルセッション情報に含めることができるHTTPセッションの属性情報の最大サイズを設定します。設定可能な範囲は128〜10485760の整数値（単位：バイト）です。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<exclude-extensions>

0または1回

データベースセッションフェイルオーバ機能を抑止する拡張子を設定します。

URLのパスが指定した拡張子と同じ場合，該当するリクエストでのデータベースセッションフェイルオーバ機能は無効となります。指定した拡張子とURLの比較では大文字・小文字は区別しません。

データベースセッションフェイルオーバ機能を抑止する拡張子を設定しない場合は，空文字列を設定します。

次に示す文字を，512文字以内で指定します。

英数字

括弧（(），（)）

エクスクラメーション（!）

パーセント（%）

ドル記号（$）

アンパサンド（&）

シングルクオート（'）

プラス（+）

ハイフン（-）

イコール（=）

単価記号（@）

アンダースコア（_）

チルダ（~）

ピリオド（.）

コンマ（,）

拡張子を複数指定する場合は，コンマ（,）で区切って指定します。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<start-notify-error>

0または1回

J2EEアプリケーション開始時にエラー通知をするかどうかの指定。

J2EEアプリケーションの開始時に，load-on-startupが指定されているサーブレット/JSPの初期化処理中や，taglibの解析中にエラーが発生した場合，エラーを通知してアプリケーションの開始を中断するかどうかを指定します。

指定できる文字列を次に示します。

true（エラーを通知する）

false（エラーを通知しない）

デフォルト値はtrueです。

┗

<start-order>

0または1回

J2EEアプリケーション開始時および停止時の順番。

開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0≦start-order≦2147483647

−

−

−

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

Servlet2.3以前のWARに対して，このタグを複数指定できません。

注※3

mime-mappingタグで指定する拡張子とMIMEタイプの対応づけのデフォルト値については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「付録B.1　拡張子とMIMEタイプの対応づけ」を参照してください。

注※4

error-codeまたはexception-typeのどちらかです。

注※5

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※6

アノテーションの設定値の場合は，値の変更をしてはいけません。

注※7

デフォルトの文字エンコーディングとして設定できる文字は，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また，指定できる文字列は，java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング，およびそれらの別名になります。

(2)　web.xmlを含まない場合（Servlet2.5以降）

タグ名

出現パターン

説明

<hitachi-war-property>

1回

ルートタグ。

┣

<description>※1

0回以上※1

WARの説明。※5

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<display-name>※1

1回以上※1

WARの表示名。※5

xml:lang属性が"en"のdisplay-nameを必ず指定します。該当するリソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。

1≦文字列長

xml:lang属性が"en"のタグの場合，英数字（0〜9，A〜Z，a〜z），および特殊文字を使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

xml:lang属性が"en"のタグ以外の場合，文字の制限はありません。

┣

┃

<icon>※1

0回以上※1

Deployツール上に表示されるWebアプリケーションのアイコンの定義。※5

┃

┃

┣

┃

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。

┣

<security-role>

0回以上

セキュリティロールについての定義。

┃

┣

<description>※1

0回以上※1

security-roleの説明。※5

┃

┣

<role-name>

1回

ロール名称。※5

┃

┃

┃

┗

<linked-to>

0または1回

cjaddsecコマンドで定義したロール名。

cjsetrespropで使用する場合，無視されます。

┣

<env-entry>

0または1回

環境エントリについての定義。※5

┃

┣

<description>※1

0回以上※1

環境エントリの説明。※5

┃

┣

<env-entry-name>

1回

環境エントリの名称。※5

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<env-entry-type>

1回

環境エントリのデータ型。※5

指定できる文字列を次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

java.lang.Character

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<env-entry-value>

1回

環境エントリの値。※5

env-entry-typeで指定した型に適合した値を指定します。

env-entry-typeにjava.lang.String以外を指定した場合，空文字の指定はできません。

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※5

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┣

┃

<ejb-ref>

0回以上

リモートインタフェースを持つEnterprise Beanへの参照情報についての定義。※5

┃

┣

<description>※1

0回以上※1

ejb-refの説明。※6

┃

┣

<ejb-ref-name>

1回

ejb-refの名称。※6

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

0または1回

リンク先のEnterprise Beanの種別。※6

指定できる文字列を次に示します。

Entity

Session

┃

┃

┣

┃

<home>

0または1回

リンク先のHomeインタフェースクラス名。※6

┃

┃

┣

┃

<remote>

0または1回

リンク先のComponentインタフェースクラス名。※6

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<ejb-link>

0または1回

リンク先のejb-name。※6

ネーミングの切り替え機能でリンク先を設定する場合，次の形式で指定します。

corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBHomeオブジェクトリファレンスのJNDI名>

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※5

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┣

┃

<ejb-local-ref>

0回以上

ローカルインタフェースを持つEnterprise Beanへの参照情報についての定義。※6

┃

┣

<description>※1

0回以上※1

ejb-local-refの説明。※6

┃

┣

<ejb-ref-name>

1回

ejb-local-refの名称。※6

┃

┃

┃

┃

┣

┃

┃

┃

<ejb-ref-type>

1回

リンク先のEnterprise Beanの種別。※6

指定できる文字列を次に示します。

Entity

Session

┃

┃

┣

┃

<local-home>

1回

リンク先のEnterprise BeanのLocal Homeインタフェース名。※6

┃

┃

┣

┃

<local>

1回

リンク先のEnterprise BeanのLocal Componentインタフェース名。※6

┃

┣

<ejb-link>

0または1回

リンク先のejb-name。※6

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定。※5

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┣

<resource-ref>

0回以上

リソース参照についての定義。※5

┃

┣

<description>※1

0回以上※1

resource-refの説明。※6

┃

┣

<res-ref-name>

1回

resource-refの名称。※6

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<res-type>

0または1回

リソース種別。※6

指定可能な文字列は次のとおり。

javax.mail.Session

javax.sql.DataSource

javax.jms.QueueConnectionFactory

javax.jms.ConnectionFactory

javax.resource.cci.ConnectionFactory

org.omg.CORBA_2_3.ORB（DDで定義しなくてもlookupできるリソース）

javax.jms.TopicConnectionFactory

参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子（<connectionfactory-interface>タグの設定値）を指定します。

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<res-auth>

0または1回

認証方式。※6

指定できる文字列を次に示します。

Application

Container

Servlet2.5以降の場合，デフォルトはContainerとなります。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<res-sharing-scope>

0または1回

参照したリソースを共有するかどうかを指定します。※6

指定できる文字列を次に示します。

Shareable

Unshareable

┃

┃

┃

┃

┣

┃

┃

┃

<mapped-name>

0または1回

対応するリソースアダプタ表示名またはメール表示名。※5

<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┣

<injection-target>

0回以上

Dependency Injectionの設定。※5

┃

┃

┃

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

0または1回

対応するリソースアダプタ表示名，データソース表示名またはメール表示名を指定します。※6

リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

<リソースアダプタ表示名>!<コネクション定義識別子>

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

cjsetrespropで使用する場合は無視されます。

┣

<resource-env-ref>

0回以上

リソース環境変数についての定義。※6

┃

┣

<description>※1

0回以上※1

resource-env-refの説明。※6

┃

┣

<resource-env-ref-name>

1回

resource-env-refの名称。※6

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<resource-env-ref-type>

1回

リソース環境変数の値のクラスタイプ。※6

指定できる文字列を次に示します。

javax.jms.Queue

javax.jms.Topic

javax.transaction.UserTransaction

javax.ejb.TimerService

javax.ejb.EJBContext

JavaBeansリソースのクラス名

javax.transaction.UserTransaction，javax.ejb.TimerService，javax.ejb.EJBContextは，アノテーションを使用した場合にだけ出力されます。ただし，この値を設定することはできません。

<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<mapped-name>

0または1回

<resource-env-ref-type>が「javax.jms.Queue」の場合，対応するキュー※5を次の形式で表示します。

"<リソースアダプタの表示名>#<Queue名称>"

<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。

<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃

┣

<injection-target>

0回以上

Dependency Injectionの設定。※5

┃

┃

┃

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名。※5

パッケージが定義されている場合は，そのパッケージから表示します。

┃

┃

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子。※5

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<linked-queue>

0または1回

対応するデータソース表示名またはメール表示名。※6

cjsetrespropで使用する場合は無視されます。

<resource-env-ref-type>に「javax.jms.Queue」が指定された場合だけ有効となります。

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<resource-adapter>

1回

リソースアダプタの表示名を指定します。※6

Connector1.5のリソースアダプタは指定できません。

┃

┃

┗

<queue>

1回

キューの表示名を指定します。※6

┃

┃

┃

┣

┃

┃

<linked-adminobject>

0または1回

管理対象オブジェクト。

cjsetrespropでは無視されます。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<resourceadapter-name>

1回

リソースアダプタの表示名を指定します。

Connector1.0以前のリソースアダプタは指定できません。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<adminobject-name>

1回

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

┃

┃

┃

┃

┃

┃

┃

┗

<linked-to>

0または1回

JavaBeansリソースの表示名を指定します。※6

<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効となります。

cjsetrespropで使用する場合は無視されます。

┣

<persistence-context-ref>

0回以上

永続化コンテキストの設定を記述。※5

┃

┃

┣

┃

<description>※1

0回以上

永続化コンテキストについての説明を記述。※6

┃

┃

┃

┣

┃

┃

<persistence-context-ref-name>

1回

永続化コンテキストの参照の名称を設定する。名称はjava:comp/envコンテキストに関連づけられたJNDI名。※6

┃

┣

<persistence-unit-name>

0または1回

永続化ユニットの名前を設定する。※6

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<persistence-context-type>

0または1回

永続化コンテキストの参照のtransactional natureを設定する。指定可能な文字列は以下のとおり。※6

Transaction

Extended

┃

┃

┣

┃

<persistence-property>

0回以上

コンテナまたは，永続化プロバイダのプロパティを設定する。※6

┃

┃

┣

<name>

1回

プロパティの名称を設定する。※6

┃

┃

┗

<value>

1回

プロパティの値を設定する。※6

┃

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定を記述。※6

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名を指定。パッケージが定義されている場合は，そのパッケージから指定。※6

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子を指定。

┣

<persistence-unit-ref>

0回以上

永続化ユニットの参照の設定を記述。※5

┃

┃

┣

┃

<description>※1

0回以上

永続化ユニットの参照についての説明を記述。※6

┃

┃

┃

┣

┃

┃

<persistence-unit-ref-name>

1回

永続化ユニットの参照の名称を設定する。名称はjava:comp/envコンテキストに関連づけられたJNDI名。※6

┃

┣

<persistence-unit-name>

0または1回

永続化ユニットの名前を設定する。※6

┃

┃

┗

<injection-target>

0回以上

Dependency Injectionの設定を記述。※6

┃

┃

┃

┣

┃

┃

<injection-target-class>

1回

injectionの対象となるクラス名を指定。パッケージが定義されている場合は，そのパッケージから指定。※6

┃

┃

┗

<injection-target-name>

1回

指定したクラスのinjection対象となる識別子を指定。※6

┣

┃

<post-construct>

0回以上

post-constructメソッドの定義を記述。※5

┃

┃

┃

┃

┣

┃

┃

┃

<lifecycle-callback-class>

0または1回

post-constructメソッドを保持するクラスの名称を記述。省略時は，<post-construct>タグの指定が無視されます。※6

┃

┗

<lifecycle-callback-method>

1回

post-constructメソッド名を記述。※6

┣

<pre-destroy>

0回以上

pre-destroyメソッドの定義を記述。※5

┃

┃

┃

┣

┃

┃

<lifecycle-callback-class>

0または1回

pre-destroyメソッドを保持するクラスの名称を記述。省略時は，<pre-destroy>タグの指定が無視されます。※6

┃

┗

<lifecycle-callback-method>

1回

pre-destroyメソッド名を記述。※6

┣

┃

┃

┃

<runtime>

0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃

┃

┃

┃

┃

┗

<context-root>

1回

コンテキストルート。

指定できる文字は，URI（RFC3986）で使用できる文字です。ルート指定時は，空文字列またはスラッシュ（/）を指定してください。

┣

┃

┃

<thread-control>

「機能解説 基本・開発編(Webコンテナ)」−「2.15」

0または1回

スレッド制御グループの設定。

cjsetrespropで使用する場合は無視されます。

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<thread-control-max-threads>

1回

Webアプリケーション単位の最大同時実行スレッド数。

占有スレッド数以上の値を指定してください。

1〜1024

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<thread-control-exclusive-threads>

1回

占有スレッド数。

Webアプリケーション単位の最大同時実行スレッド数以下の値を指定してください。

0〜1024

┃

┃

┃

┣

┃

┃

<thread-control-queue-size>

1回

Webアプリケーション単位の実行待ちキューサイズ。

0〜2147483647

┃

┣

<thread-control-stats-monitor>

「機能解説 運用／監視／連携編」−「3.4」

1回

稼働統計の監視の設定。

┃

┃

┃

┃

┣

┃

<whole-waiting-request-count>

1回

Webアプリケーション単位の全体実行待ちリクエスト数の監視をします。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<enabled>

1回

Webアプリケーション単位の全体実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<high-threshold>

1回

しきい値イベントを出力する上限のしきい値を1〜100の整数値（単位：%）で指定します。デフォルトは80です。

ただし，<low-threshold>タグの指定値以上の値である必要があります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<low-threshold>

1回

しきい値イベントを出力する下限しきい値を0〜99の整数値（単位：%）で指定します。

デフォルトは0です。

ただし，<high-threshold>タグの指定値以下の値である必要があります。

┃

┃

┃

┃

┗

<waiting-request-count>

1回

Webアプリケーション単位の実行待ちリクエスト数の監視をします。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<enabled>

1回

Webアプリケーション単位の実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかを指定します。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<high-threshold>

1回

しきい値イベントを出力する上限のしきい値を1〜100の整数値（単位：%）で指定します。デフォルトは80です。

ただし，<low-threshold>タグの指定値以上の値である必要があります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<low-threshold>

1回

しきい値イベントを出力する下限しきい値を0〜99の整数値（単位：%）で指定します。

デフォルトは0です。

ただし，<high-threshold>タグの指定値以下の値である必要があります。

┃

┃

┃

┣

┃

┃

<resource-watcher>

1回

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視に関するプロパティ。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-threshold>

1回

アラートメッセージを出力するしきい値。

1〜100の整数値（単位：%）を指定します。デフォルトは80です。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-interval>

1回

監視間隔。

1〜2147483647の整数値（単位：秒）で指定します。デフォルトは30です。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<watcher-enabled>

1回

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視を有効にするかどうかの指定。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。ただし，thread-control-queue-sizeに0を指定した場合，監視は無効となります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

1回

リソース使用状況をファイルに出力するかどうかの指定。

指定できる文字列を次に示します。

true（出力する）

false（出力しない）

デフォルトはtrueです。

┃

┃

┗

<urlgroup-thread-control>

「機能解説 基本・開発編(Webコンテナ)」−「2.16」

0回以上

URLグループ単位の同時実行スレッド数制御。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<urlgroup-thread-control-name>

1回

URLグループ単位の同時実行スレッド数制御の定義名。

URLグループ単位の同時スレッド数制御の定義名にはWebアプリケーション内で一意となる文字列を指定します。英数字（0〜9，A〜Z，a〜z），ハイフン（-）およびアンダースコア（_）が使用できます。文字列の長さは1≦文字列長≦64で指定してください。

┃

┃

┃

┃

┣

┃

┃

┃

<urlgroup-thread-control-max-threads>

1回

URLグループ単位の最大同時実行スレッド数。

1〜thread-control-max-threadsの整数値を指定します。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<urlgroup-thread-control-exclusive-threads>

1回

URLグループ単位の占有スレッド数。

指定できる値は，0〜urlgroup-thread-control-max-threadsかつthread-control-exclusive-threads以下です。なお，<urlgroup-thread-control>を定義している場合は次の設定範囲を満たす必要があります。

thread-control-max-threads ≠ thread-control-exclusive-threadsの場合　thread-control-exclusive-threads　≧ urlgroup-thread-control-exclusive-threadsの総和。

thread-control-max-threads ＝ thread-control-exclusive-threadsの場合　thread-control-exclusive-threads　＞ urlgroup-thread-control-exclusive-threadsの総和。

┃

┃

┃

┃

┣

┃

┃

┃

<urlgroup-thread-control-queue-size>

1回

URLグループ単位の実行待ちキューのサイズ。

指定できる値は，0〜2147483647の整数値です。

┃

┣

<urlgroup-thread-control-mapping>

0回以上

制御対象となるURLのマッピング情報。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<url-pattern>

1回

制御対象となるURLパターン。

一つのWebアプリケーション内で同じURLパターンを指定することはできません。指定例を次に示します。

/soda/grape/*

/foo/*

/contents

*.foo

┃

┗

<stats-monitor>

「機能解説 運用／監視／連携編」−「3.4」

1回

稼働統計の設定。

┃

┃

┗

<waiting-request-count>

1回

URLグループ単位の実行待ちリクエスト数を監視。

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<enabled>

1回

URLグループ単位の実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかの指定。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<high-threshold>

1回

しきい値イベントを出力する上限しきい値。

指定できる値は，1〜100の整数値（単位：%）です。なお，low-threshold以上の値を指定してください。

┃

┃

┃

┃

┃

┗

<low-threshold>

1回

しきい値イベントを出力する下限しきい値。

指定できる値は，0〜99の整数値（単位：%）です。なお，high-threshold以下の値を指定してください。

┣

<http-request>

0または1回

−

┃

┃

┃

┃

┃

┃

┗

<encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

0または1回

リクエストボディ，およびクエリのデコードに使用するデフォルトのエンコーディングを指定します。

JavaVMがサポートしている文字エンコーディングを指定します。※7

デフォルトは指定なしです。

┣

<http-response>

0または1回

−

┃

┃

┃

┃

┃

┃

┗

<encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

0または1回

レスポンスボディのエンコードに使用するデフォルトのエンコーディングを指定します。

JavaVMがサポートしている文字エンコーディングを指定します。※7

デフォルトは指定なしです。

┣

<jsp>

0または1回

−

┃

┃

┃

┃

┃

┗

<page-encoding>

「機能解説 基本・開発編(Webコンテナ)」−「2.6」

0または1回

JSPファイルの読み込みに使用するデフォルトのエンコーディングを指定します。

JavaVMがサポートしている文字エンコーディングを指定します。※7

デフォルトは指定なしです。

┣

<http-session>

0または1回

−

┃

┃

┃

┃

┣

┃

┃

┃

<http-session-max-number>

「機能解説 基本・開発編(Webコンテナ)」−「2.7.5」

1回

使用可能なHttpSessionの最大数。

指定できる値は，-1〜2147483647の整数値です。-1を指定した場合は無制限となります。デフォルトは，-1です。

┃

┃

┣

┃

<resource-watcher>

1回

HttpSession数の監視に関するプロパティを設定。

┃

┃

┃

┃

┃

┃

┣

┃

┃

<watcher-threshold>

1回

アラートメッセージを出力するしきい値。

指定できる値は，1〜100の整数値（単位：%）です。デフォルトは80です。

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<watcher-interval>

1回

監視間隔。

指定できる値は，1〜2147483647の整数値（単位：秒）です。デフォルトは30です。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<watcher-enabled>

1回

HttpSession数の監視を有効にするかどうかの指定。

指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。ただし，http-session-max-numberに0を指定した場合，監視は無効となります。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

1回

リソース使用状況をファイルに出力するかどうかの指定。指定できる文字列を次に示します。

true（出力する）

false（出力しない）

デフォルトはtrueです。

┃

┃

┗

<dbsfo>

「機能解説 拡張編」−「6章」

0または1回

データベースセッションフェイルオーバ機能の設定を行う。

┃

┃

┃

┣

┃

┃

<enabled>

0または1回

データベースセッションフェイルオーバ機能の有効，無効を設定する。有効の場合は"true"，無効の場合は"false"を指定する。

┃

┃

┃

┣

┃

┃

<application-id>

0または1回

アプリケーション識別子を設定する。英数字(0〜9,A〜Z,a〜z)，アンダースコア(_)だけ使用可。最大16文字。

┃

┃

┃

┃

┣

┃

┃

┃

<attribute-data-size-max>

0または1回

グローバルセッション情報に含めることが可能なHTTPセッションの属性情報の最大サイズを設定する。設定可能な範囲は128〜10485760の整数値 (単位：バイト)。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<exclude-extensions>

0または1回

データベースセッションフェイルオーバ機能を抑止する拡張子を設定します。

URLのパスが指定した拡張子と同じ場合，該当するリクエストでデータベースセッションフェイルオーバ機能は無効となります。指定した拡張子とURLの比較では大文字・小文字は区別しません。

データベースセッションフェイルオーバ機能を抑止する拡張子を設定しない場合は，空文字列を設定します。

次に示す文字を，512文字以内で指定します。

英数字

括弧（(），（)）

エクスクラメーション（!）

パーセント（%）

ドル記号（$）

アンパサンド（&）

シングルクオート（'）

プラス（+）

ハイフン（-）

イコール（=）

単価記号（@）

アンダースコア（_）

チルダ（~）

ピリオド（.）

コンマ（,）

拡張子を複数指定する場合は，コンマ（,）で区切って指定します。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<start-notify-error>

0または1回

J2EEアプリケーション開始時にエラー通知をするかどうかの指定。

J2EEアプリケーションの開始時に，load-on-startupが指定されているサーブレット/JSPの初期化処理中や，taglibの解析中にエラーが発生した場合，エラーを通知してアプリケーションの開始を中断するかどうかを指定します。

指定できる文字列を次に示します。

true（エラーを通知する）

false（エラーを通知しない）

デフォルト値はtrueです。

┗

<start-order>

0または1回

J2EEアプリケーション開始時および停止時の順番。

開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0≦start-order≦2147483647

−

−

−

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

Servlet2.3以前のWARに対して，このタグを複数指定できません。

注※3

mime-mappingタグで指定する拡張子とMIMEタイプの対応づけのデフォルト値については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「付録B.1　拡張子とMIMEタイプの対応づけ」を参照してください。

注※4

error-codeまたはexception-typeのどちらかです。

注※5

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※6

アノテーションの設定値の場合は，値の変更をしてはいけません。

注※7

デフォルトの文字エンコーディングとして設定できる文字は，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また，指定できる文字列は，java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング，およびそれらの別名になります。

3.7.2　DDとの対応

WAR属性ファイルとDeployment Descriptorの対応を次に示します。

(1)　Servlet2.3の場合

WAR属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-war-property>

1回

<web-app>

1回

┣

<description>

0または1回

┣

<description>

0または1回

┣

<display-name>

1回

┣

<display-name>

0または1回

┣

<icon>

0または1回

┣

<icon>

0または1回

┃

┣

<small-icon>

0または1回

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┗

<large-icon>

0または1回

┣

<distributable>

0または1回

┣

<distributable>

0回以上

┣

<context-param>

0回以上

┣

<context-param>

0回以上

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┣

<param-name>

1回

┃

┣

<param-name>

1回

┃

┗

<param-value>

1回

┃

┗

<param-value>

1回

┣

<filter-mapping>

0回以上

┣

<filter-mapping>

0回以上

┃

┣

<filter-name>

1回

┃

┣

<filter-name>

1回

┃

┣

<url-pattern>※1

1回

┃

┣

<url-pattern>※1

1回

┃

┗

<servlet-name>※1

1回

┃

┗

<servlet-name>※1

1回

┣

<listener>

0回以上

┣

<listener>

0回以上

┃

┗

<listener-class>

1回

┃

┗

<listener-class>

1回

┃

−

−

┃

(省略)

−

┣

<session-config>

0または1回

┣

<session-config>

0または1回

┃

┗

<session-timeout>

0または1回

┃

┗

<session-timeout>

0または1回

┣

<mime-mapping>

0回以上

┣

<mime-mapping>

0回以上

┃

┣

<extension>

1回

┃

┣

<extension>

1回

┃

┗

<mime-type>

1回

┃

┗

<mime-type>

1回

┣

<welcome-file-list>

0または1回

┣

<welcome-file-list>

0または1回

┃

┗

<welcome-file>

1回以上

┃

┗

<welcome-file>

1回以上

┣

<error-page>

0回以上

┣

<error-page>

0回以上

┃

┣

<error-code>※2

1回

┃

┣

<error-code>※2

1回

┃

┣

<exception-type>※2

1回

┃

┣

<exception-type>※2

1回

┃

┗

<location>

1回

┃

┗

<location>

1回

┣

<taglib>

0回以上

┣

<taglib>

0回以上

┃

┣

<taglib-uri>

1回

┃

┣

<taglib-uri>

1回

┃

┗

<taglib-location>

1回

┃

┗

<taglib-location>

1回

┣

<security-constraint>

0回以上

┣

<security-constraint>

0回以上

┃

┣

<display-name>

0または1回

┃

┣

<display-name>

0または1回

┃

┣

<web-resource-collection>

1回以上

┃

┣

<web-resource-collection>

1回以上

┃

┃

┣

<description>

0または1回

┃

┃

┣

<description>

0または1回

┃

┃

┣

<web-resource-name>

1回

┃

┃

┣

<web-resource-name>

1回

┃

┃

┣

<url-pattern>

0回以上

┃

┃

┣

<url-pattern>

0回以上

┃

┃

┗

<http-method>

0回以上

┃

┃

┗

<http-method>

0回以上

┃

┣

<auth-constraint>

0または1回

┃

┣

<auth-constraint>

0または1回

┃

┃

┣

<description>

0または1回

┃

┃

┣

<description>

0または1回

┃

┃

┗

<role-name>

0回以上

┃

┃

┗

<role-name>

0回以上

┃

┣

<user-data-constraint>

0または1回

┃

┗

<user-data-constraint>

0または1回

┃

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┃

┗

<transport-guarantee>

1回

┃

┗

<transport-guarantee>

1回

┃

┗

<original-name>

1回

┃

−

−

┣

<login-config>

0または1回

┣

<login-config>

0または1回

┃

┣

<auth-method>

0または1回

┃

┣

<auth-method>

0または1回

┃

┣

<realm-name>

0または1回

┃

┣

<realm-name>

0または1回

┃

┗

<form-login-config>

0または1回

┃

┗

<form-login-config>

0または1回

┃

┣

<form-login-page>

1回

┃

┣

<form-login-page>

1回

┃

┗

<form-error-page>

1回

┃

┗

<form-error-page>

1回

┣

<security-role>

0回以上

┣

<security-role>

0回以上

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┣

<role-name>

1回

┃

┗

<role-name>

1回

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<env-entry>

0回以上

┣

<env-entry>

0回以上

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-type>

1回

┃

┣

<env-entry-type>

1回

┃

┗

<env-entry-value>

1回

┃

┗

<env-entry-value>

0または1回

┣

<ejb-ref>

0回以上

┣

<ejb-ref>

0回以上

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<home>

1回

┃

┣

<home>

1回

┃

┣

<remote>

1回

┃

┣

<remote>

1回

┃

┗

<ejb-link>

0または1回

┃

┗

<ejb-link>

0または1回

┣

<ejb-local-ref>

0回以上

┣

<ejb-local-ref>

0回以上

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<local-home>

1回

┃

┣

<local-home>

1回

┃

┣

<local>

1回

┃

┣

<local>

1回

┃

┗

<ejb-link>

0または1回

┃

┗

<ejb-link>

0または1回

┣

<resource-ref>

0回以上

┣

<resource-ref>

0回以上

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┣

<res-ref-name>

1回

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

1回

┃

┣

<res-type>

1回

┃

┣

<res-auth>

1回

┃

┣

<res-auth>

1回

┃

┣

<res-sharing-scope>

0または1回

┃

┗

<res-sharing-scope>

0または1回

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<resource-env-ref>

0回以上

┣

<resource-env-ref>

0回以上

┃

┣

<description>

0または1回

┃

┣

<description>

0または1回

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

1回

┃

┗

<resource-env-ref-type>

1回

┃

┣

<linked-queue>

0または1回

┃

−

−

┃

┃

┣

<resource-adapter>

1回

┃

−

−

┃

┃

┗

<queue>

1回

┃

−

−

┃

┗

<linked-adminobject>

0または1回

┃

−

−

┃

┣

<resourceadapter-name>

1回

┃

−

−

┃

┗

<adminobject-name>

1回

┃

−

−

┗

<runtime>

0または1回

┃

−

−

┗

<context-root>

1回

┃

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<url-pattern>と<servlet-name>のどちらか一つを指定します。

注※2

<error-code>と<exception-type>のどちらか一つを指定します。

(2)　Servlet2.4の場合

WAR属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-war-property>

1回

<web-app>

1回

┣

<description>

0回以上

┣

<description>

0回以上

┣

<display-name>

1回以上

┣

<display-name>

0回以上

┣

<icon>

0回以上

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┗

<large-icon>

0または1回

┣

<distributable>

0または1回

┣

<distributable>

0回以上

┣

<context-param>

0回以上

┣

<context-param>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<param-name>

1回

┃

┣

<param-name>

1回

┃

┗

<param-value>

1回

┃

┗

<param-value>

1回

┣

<filter-mapping>

0回以上

┣

<filter-mapping>

0回以上

┃

┣

<filter-name>

1回

┃

┣

<filter-name>

1回

┃

┣

<url-pattern>※1

1回

┃

┣

<url-pattern>※1

1回

┃

┣

<servlet-name>※1

1回

┃

┣

<servlet-name>※1

1回

┃

┗

<dispatcher>

0または4回以下

┃

┗

<dispatcher>

0または4回以下

┣

<listener>

0回以上

┣

<listener>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<icon>

0回以上

┃

┣

<icon>

0回以上

┃

┃

┣

<small-icon>

0または1回

┃

┃

┣

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┗

<listener-class>

1回

┃

┗

<listener-class>

1回

┃

−

−

┃

(省略)

−

┣

<session-config>

0回以上

┣

<session-config>

0回以上

┃

┗

<session-timeout>

0または1回

┃

┗

<session-timeout>

0または1回

┣

<mime-mapping>

0回以上

┣

<mime-mapping>

0回以上

┃

┣

<extension>

1回

┃

┣

<extension>

1回

┃

┗

<mime-type>

1回

┃

┗

<mime-type>

1回

┣

<welcome-file-list>

0回以上

┣

<welcome-file-list>

0回以上

┃

┗

<welcome-file>

1回以上

┃

┗

<welcome-file>

1回以上

┣

<error-page>

0回以上

┣

<error-page>

0回以上

┃

┣

<error-code>※2

1回

┃

┣

<error-code>※2

1回

┃

┣

<exception-type>※2

1回

┃

┣

<exception-type>※2

1回

┃

┗

<location>

1回

┃

┗

<location>

1回

┣

<jsp-config>

0回以上

┣

<jsp-config>

0回以上

┃

┣

<taglib>

0回以上

┃

┣

<taglib>

0回以上

┃

┃

┣

<taglib-uri>

1回

┃

┃

┣

<taglib-uri>

1回

┃

┃

┗

<taglib-location>

1回

┃

┃

┗

<taglib-location>

1回

┃

┗

<jsp-property-group>

0回以上

┃

┗

<jsp-property-group>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<icon>

0回以上

┃

┣

<icon>

0回以上

┃

┃

┣

<small-icon>

0または1回

┃

┃

┣

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┣

<url-pattern>

1回以上

┃

┣

<url-pattern>

1回以上

┃

┣

<el-ignored>

0または1回

┃

┣

<el-ignored>

0または1回

┃

┣

<page-encoding>

0または1回

┃

┣

<page-encoding>

0または1回

┃

┣

<scripting-invalid>

0または1回

┃

┣

<scripting-invalid>

0または1回

┃

┣

<is-xml>

0または1回

┃

┣

<is-xml>

0または1回

┃

┣

<include-prelude>

0回以上

┃

┣

<include-prelude>

0回以上

┃

┗

<inclede-coda>

0回以上

┃

┗

<inclede-coda>

0回以上

┣

<security-constraint>

0回以上

┣

<security-constraint>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<web-resource-collection>

1回以上

┃

┣

<web-resource-collection>

1回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<web-resource-name>

1回

┃

┃

┣

<web-resource-name>

1回

┃

┃

┣

<url-pattern>

1回以上

┃

┃

┣

<url-pattern>

1回以上

┃

┃

┗

<http-method>

0回以上

┃

┃

┗

<http-method>

0回以上

┃

┣

<auth-constraint>

0または1回

┃

┣

<auth-constraint>

0または1回

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┗

<role-name>

0回以上

┃

┃

┗

<role-name>

0回以上

┃

┣

<user-data-constraint>

0または1回

┃

┗

<user-data-constraint>

0または1回

┃

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

┗

<transport-guarantee>

1回

┃

┗

<transport-guarantee>

1回

┃

┗

<original-name>

1回

┃

−

−

┣

<login-config>

0回以上

┣

<login-config>

0回以上

┃

┣

<auth-method>

0または1回

┃

┣

<auth-method>

0または1回

┃

┣

<realm-name>

0または1回

┃

┣

<realm-name>

0または1回

┃

┗

<form-login-config>

0または1回

┃

┗

<form-login-config>

0または1回

┃

┣

<form-login-page>

1回

┃

┣

<form-login-page>

1回

┃

┗

<form-error-page>

1回

┃

┗

<form-error-page>

1回

┣

<security-role>

0回以上

┣

<security-role>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┗

<role-name>

1回

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<env-entry>

0回以上

┣

<env-entry>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-type>

1回

┃

┣

<env-entry-type>

1回

┃

┣

<env-entry-value>

1回

┃

┗

<env-entry-value>

0または1回

┃

┗

<injection-target>

0回以上

┃

−

−

┃

┣

<injection-target-class>

1回

┃

−

−

┃

┗

<injection-target-name>

1回

┃

−

−

┣

<ejb-ref>

0回以上

┣

<ejb-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<home>

1回

┃

┣

<home>

1回

┃

┣

<remote>

1回

┃

┣

<remote>

1回

┃

┣

<ejb-link>

0または1回

┃

┗

<ejb-link>

0または1回

┃

┗

<injection-target>

0回以上

┃

−

−

┃

┣

<injection-target-class>

1回

┃

−

−

┃

┗

<injection-target-name>

1回

┃

−

−

┣

<ejb-local-ref>

0回以上

┣

<ejb-local-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<ejb-ref-type>

1回

┃

┣

<local-home>

1回

┃

┣

<local-home>

1回

┃

┣

<local>

1回

┃

┣

<local>

1回

┃

┣

<ejb-link>

0または1回

┃

┗

<ejb-link>

0または1回

┃

┗

<injection-target>

0回以上

┃

−

−

┃

┣

<injection-target-class>

1回

┃

−

−

┃

┗

<injection-target-name>

1回

┃

−

−

┣

<resource-ref>

0回以上

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<res-ref-name>

1回

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

1回

┃

┣

<res-type>

1回

┃

┣

<res-auth>

1回

┃

┣

<res-auth>

1回

┃

┣

<res-sharing-scope>

0または1回

┃

┗

<res-sharing-scope>

0または1回

┃

┣

<mapped-name>

0または1回

┃

−

−

┃

┣

<injection-target>

0回以上

┃

−

−

┃

┃

┣

<injection-target-class>

1回

┃

−

−

┃

┃

┗

<injection-target-name>

1回

┃

−

−

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<resource-env-ref>

0回以上

┣

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

1回

┃

┗

<resource-env-ref-type>

1回

┃

┣

<mapped-name>

0または1回

┃

−

−

┃

┣

<injection-target>

0回以上

┃

−

−

┃

┃

┣

<injection-target-class>

1回

┃

−

−

┃

┃

┗

<injection-target-name>

1回

┃

−

−

┃

┣

<linked-queue>

0または1回

┃

−

−

┃

┃

┣

<resource-adapter>

1回

┃

−

−

┃

┃

┗

<queue>

1回

┃

−

−

┃

┗

<linked-adminobject>

0または1回

┃

−

−

┃

┣

<resourceadapter-name>

1回

┃

−

−

┃

┗

<adminobject-name>

1回

┃

−

−

┣

<locale-encoding-mapping-list>

0回以上

┗

<locale-encoding-mapping-list>

0回以上

┃

┗

<locale-encoding-mapping>

1回以上

┗

<locale-encoding-mapping>

1回以上

┃

┣

<locale>

1回

┣

<locale>

1回

┃

┗

<encoding>

1回

┗

<encoding>

1回

┗

<runtime>

0または1回

−

−

┗

<context-root>

1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<url-pattern>と<servlet-name>のどちらか一つを指定します。

注※2

<error-code>と<exception-type>のどちらか一つを指定します。

(3)　Servlet2.5の場合

WAR属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-war-property>

1回

<web-app>

1回

┣

<description>

0回以上

┣

<description>

0回以上

┣

<display-name>

1回以上

┣

<display-name>

0回以上

┣

<icon>

0回以上

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┗

<large-icon>

0または1回

┣

<distributable>

0または1回

┣

<distributable>

0回以上

┣

<context-param>

0回以上

┣

<context-param>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<param-name>

1回

┃

┣

<param-name>

1回

┃

┗

<param-value>

1回

┃

┗

<param-value>

1回

┣

<filter-mapping>

0回以上

┣

<filter-mapping>

0回以上

┃

┣

<filter-name>

1回

┃

┣

<filter-name>

1回

┃

┣

<url-pattern>※1

1回以上

┃

┣

<url-pattern>※1

1回以上

┃

┣

<servlet-name>※1

1回以上

┃

┣

<servlet-name>※1

1回以上

┃

┗

<dispatcher>

0または4回以下

┃

┗

<dispatcher>

0または4回以下

┣

<listener>

0回以上

┣

<listener>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<icon>

0回以上

┃

┣

<icon>

0回以上

┃

┃

┣

<small-icon>

0または1回

┃

┃

┣

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┗

<listener-class>

1回

┃

┗

<listener-class>

1回

┃

−

−

┃

(省略)

−

┣

<session-config>

0回以上

┣

<session-config>

0回以上

┃

┗

<session-timeout>

0または1回

┃

┗

<session-timeout>

0または1回

┣

<mime-mapping>

0回以上

┣

<mime-mapping>

0回以上

┃

┣

<extension>

1回

┃

┣

<extension>

1回

┃

┗

<mime-type>

1回

┃

┗

<mime-type>

1回

┣

<welcome-file-list>

0回以上

┣

<welcome-file-list>

0回以上

┃

┗

<welcome-file>

1回以上

┃

┗

<welcome-file>

1回以上

┣

<error-page>

0回以上

┣

<error-page>

0回以上

┃

┣

<error-code>※2

1回

┃

┣

<error-code>※2

1回

┃

┣

<exception-type>※2

1回

┃

┣

<exception-type>※2

1回

┃

┗

<location>

1回

┃

┗

<location>

1回

┣

<jsp-config>

0回以上

┣

<jsp-config>

0回以上

┃

┣

<taglib>

0回以上

┃

┣

<taglib>

0回以上

┃

┃

┣

<taglib-uri>

1回

┃

┃

┣

<taglib-uri>

1回

┃

┃

┗

<taglib-location>

1回

┃

┃

┗

<taglib-location>

1回

┃

┗

<jsp-property-group>

0回以上

┃

┗

<jsp-property-group>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<icon>

0回以上

┃

┣

<icon>

0回以上

┃

┃

┣

<small-icon>

0または1回

┃

┃

┣

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┣

<url-pattern>

1回以上

┃

┣

<url-pattern>

1回以上

┃

┣

<el-ignored>

0または1回

┃

┣

<el-ignored>

0または1回

┃

┣

<page-encoding>

0または1回

┃

┣

<page-encoding>

0または1回

┃

┣

<scripting-invalid>

0または1回

┃

┣

<scripting-invalid>

0または1回

┃

┣

<is-xml>

0または1回

┃

┣

<is-xml>

0または1回

┃

┣

<include-prelude>

0回以上

┃

┣

<include-prelude>

0回以上

┃

┗

<inclede-coda>

0回以上

┃

┣

<inclede-coda>

0回以上

┃

┣

<deferred-syntax-allowed-as-literal>

0または1回

┃

┣

<deferred-syntax-allowed-as-literal>

0または1回

┃

┗

<trim-directive-whitespaces>

0または1回

┃

┗

<trim-directive-whitespaces>

0または1回

┣

<security-constraint>

0回以上

┣

<security-constraint>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<web-resource-collection>

1回以上

┃

┣

<web-resource-collection>

1回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<web-resource-name>

1回

┃

┃

┣

<web-resource-name>

1回

┃

┃

┣

<url-pattern>

1回以上

┃

┃

┣

<url-pattern>

1回以上

┃

┃

┗

<http-method>

0回以上

┃

┃

┗

<http-method>

0回以上

┃

┣

<auth-constraint>

0または1回

┃

┣

<auth-constraint>

0または1回

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┗

<role-name>

0回以上

┃

┃

┗

<role-name>

0回以上

┃

┣

<user-data-constraint>

0または1回

┃

┗

<user-data-constraint>

0または1回

┃

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

┗

<transport-guarantee>

1回

┃

┗

<transport-guarantee>

1回

┃

┗

<original-name>

1回

┃

−

−

┣

<login-config>

0回以上

┣

<login-config>

0回以上

┃

┣

<auth-method>

0または1回

┃

┣

<auth-method>

0または1回

┃

┣

<realm-name>

0または1回

┃

┣

<realm-name>

0または1回

┃

┗

<form-login-config>

0または1回

┃

┗

<form-login-config>

0または1回

┃

┣

<form-login-page>

1回

┃

┣

<form-login-page>

1回

┃

┗

<form-error-page>

1回

┃

┗

<form-error-page>

1回

┣

<security-role>

0回以上

┣

<security-role>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┗

<role-name>

1回

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<env-entry>

0回以上

┣

<env-entry>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-type>

0または1回

┃

┣

<env-entry-type>

0または1回

┃

┣

<env-entry-value>

1回

┃

┣

<env-entry-value>

0または1回

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<ejb-ref>

0回以上

┣

<ejb-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

0または1回

┃

┣

<ejb-ref-type>

0または1回

┃

┣

<home>

0または1回

┃

┣

<home>

0または1回

┃

┣

<remote>

0または1回

┃

┣

<remote>

0または1回

┃

┣

<ejb-link>

0または1回

┃

┣

<ejb-link>

0または1回

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<ejb-local-ref>

0回以上

┣

<ejb-local-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

0または1回

┃

┣

<ejb-ref-type>

0または1回

┃

┣

<local-home>

0または1回

┃

┣

<local-home>

0または1回

┃

┣

<local>

0または1回

┃

┣

<local>

0または1回

┃

┣

<ejb-link>

0または1回

┃

┣

<ejb-link>

0または1回

┃

┃

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<resource-ref>

0回以上

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<res-ref-name>

1回

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

0または1回

┃

┣

<res-type>

0または1回

┃

┣

<res-auth>

0または1回

┃

┣

<res-auth>

0または1回

┃

┣

<res-sharing-scope>

0または1回

┃

┣

<res-sharing-scope>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┣

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<resource-env-ref>

0回以上

┣

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

0または1回

┃

┣

<resource-env-ref-type>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┣

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┃

┣

<linked-queue>

0または1回

┃

−

−

┃

┃

┣

<resource-adapter>

1回

┃

−

−

┃

┃

┗

<queue>

1回

┃

−

−

┃

┗

<linked-adminobject>

0または1回

┃

−

−

┃

┣

<resourceadapter-name>

1回

┃

−

−

┃

┗

<adminobject-name>

1回

┃

−

−

┣

<persistence-context-ref>

0回以上

┣

<persistence-context-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<persistence-context-ref-name>

1回

┃

┣

<persistence-context-ref-name>

1回

┃

┣

<persistence-unit-name>

0または1回

┃

┣

<persistence-unit-name>

0または1回

┃

┣

<persistence-context-type>

0または1回

┃

┣

<persistence-context-type>

0または1回

┃

┣

<persistence-property>

0回以上

┃

┣

<persistence-property>

0回以上

┃

┃

┣

<name>

1回

┃

┃

┣

<name>

1回

┃

┃

┗

<value>

1回

┃

┃

┗

<value>

1回

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<persistence-unit-ref>

0回以上

┃

<persistence-unit-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<persistence-unit-ref-name>

1回

┃

┣

<persistence-unit-ref-name>

1回

┃

┣

<persistence-unit-name>

0または1回

┃

┣

<persistence-unit-name>

0または1回

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<post-construct>

0回以上

┣

<post-construct>

0回以上

┃

┣

<lifecycle-callback-class>

0または1回

┃

┣

<lifecycle-callback-class>

0または1回

┃

┗

<lifecycle-callback-method>

1回

┃

┗

<lifecycle-callback-method>

1回

┣

<pre-destroy>

0回以上

┣

<pre-destroy>

0回以上

┃

┣

<lifecycle-callback-class>

0または1回

┃

┣

<lifecycle-callback-class>

0または1回

┃

┗

<lifecycle-callback-method>

1回

┃

┗

<lifecycle-callback-method>

1回

┣

<locale-encoding-mapping-list>

0回以上

┗

<locale-encoding-mapping-list>

0回以上

┃

┗

<locale-encoding-mapping>

1回以上

┗

<locale-encoding-mapping>

1回以上

┃

┣

<locale>

1回

┣

<locale>

1回

┃

┗

<encoding>

1回

┗

<encoding>

1回

┗

<runtime>

0または1回

−

−

┗

<context-root>

1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<url-pattern>と<servlet-name>のどちらか一つまたは両方を指定します。

注※2

<error-code>と<exception-type>のどちらか一つを指定します。

(4)　Servlet3.0の場合

WAR属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-war-property>

1回

<web-app>

1回

┣

<description>

0回以上

┣

<description>

0回以上

┣

<display-name>

1回以上

┣

<display-name>

0回以上

┣

<icon>

0回以上

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┗

<large-icon>

0または1回

┣

<distributable>

0または1回

┣

<distributable>

0回以上

┣

<context-param>

0回以上

┣

<context-param>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<param-name>

1回

┃

┣

<param-name>

1回

┃

┗

<param-value>

1回

┃

┗

<param-value>

1回

┣

<filter-mapping>

0回以上

┣

<filter-mapping>

0回以上

┃

┣

<filter-name>

1回

┃

┣

<filter-name>

1回

┃

┣

<url-pattern>※1

1回以上

┃

┣

<url-pattern>※1

1回以上

┃

┣

<servlet-name>※1

1回以上

┃

┣

<servlet-name>※1

1回以上

┃

┗

<dispatcher>

0または5回以下

┃

┗

<dispatcher>

0または5回以下

┣

<listener>

0回以上

┣

<listener>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<icon>

0回以上

┃

┣

<icon>

0回以上

┃

┃

┣

<small-icon>

0または1回

┃

┃

┣

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┗

<listener-class>

1回

┃

┗

<listener-class>

1回

┃

−

−

┃

(省略)

−

┣

<session-config>

0回以上

┣

<session-config>

0回以上

┃

┗

<session-timeout>

0または1回

┃

┗

<session-timeout>

0または1回

┣

<mime-mapping>

0回以上

┣

<mime-mapping>

0回以上

┃

┣

<extension>

1回

┃

┣

<extension>

1回

┃

┗

<mime-type>

1回

┃

┗

<mime-type>

1回

┣

<welcome-file-list>

0回以上

┣

<welcome-file-list>

0回以上

┃

┗

<welcome-file>

1回以上

┃

┗

<welcome-file>

1回以上

┣

<error-page>

0回以上

┣

<error-page>

0回以上

┃

┣

<error-code>※2

どちらか1回，またはどちらもなし

┃

┣

<error-code>※2

どちらか1回，またはどちらもなし

┃

┣

<exception-type>※2

どちらか1回，またはどちらもなし

┃

┣

<exception-type>※2

どちらか1回，またはどちらもなし

┃

┗

<location>

1回

┃

┗

<location>

1回

┣

<jsp-config>

0回以上

┣

<jsp-config>

0回以上

┃

┣

<taglib>

0回以上

┃

┣

<taglib>

0回以上

┃

┃

┣

<taglib-uri>

1回

┃

┃

┣

<taglib-uri>

1回

┃

┃

┗

<taglib-location>

1回

┃

┃

┗

<taglib-location>

1回

┃

┗

<jsp-property-group>

0回以上

┃

┗

<jsp-property-group>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<icon>

0回以上

┃

┣

<icon>

0回以上

┃

┃

┣

<small-icon>

0または1回

┃

┃

┣

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┣

<url-pattern>

1回以上

┃

┣

<url-pattern>

1回以上

┃

┣

<el-ignored>

0または1回

┃

┣

<el-ignored>

0または1回

┃

┣

<page-encoding>

0または1回

┃

┣

<page-encoding>

0または1回

┃

┣

<scripting-invalid>

0または1回

┃

┣

<scripting-invalid>

0または1回

┃

┣

<is-xml>

0または1回

┃

┣

<is-xml>

0または1回

┃

┣

<include-prelude>

0回以上

┃

┣

<include-prelude>

0回以上

┃

┗

<inclede-coda>

0回以上

┃

┣

<inclede-coda>

0回以上

┃

┣

<deferred-syntax-allowed-as-literal>

0または1回

┃

┣

<deferred-syntax-allowed-as-literal>

0または1回

┃

┣

<trim-directive-whitespaces>

0または1回

┃

┣

<trim-directive-whitespaces>

0または1回

┃

┣

<default-content-type>

0または1回

┃

┣

<default-content-type>

0または1回

┃

┣

<buffer>

0または1回

┃

┣

<buffer>

0または1回

┃

┗

<error-on-undeclared-namespace>

0または1回

┃

┗

<error-on-undeclared-namespace>

0または1回

┣

<security-constraint>

0回以上

┣

<security-constraint>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<display-name>

0回以上

┃

┣

<web-resource-collection>

1回以上

┃

┣

<web-resource-collection>

1回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┣

<web-resource-name>

1回

┃

┃

┣

<web-resource-name>

1回

┃

┃

┣

<url-pattern>

0回以上

┃

┃

┣

<url-pattern>

1回以上

┃

┃

┣

<http-method>※3

0回以上

┃

┃

┣

<http-method>※3

0回以上

┃

┃

┗

<http-method-omission>※3

0回以上

┃

┃

┗

<http-method-omission>※3

0回以上

┃

┣

<auth-constraint>

0または1回

┃

┣

<auth-constraint>

0または1回

┃

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┃

┗

<role-name>

0回以上

┃

┃

┗

<role-name>

0回以上

┃

┣

<user-data-constraint>

0または1回

┃

┗

<user-data-constraint>

0または1回

┃

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┃

┗

<transport-guarantee>

1回

┃

┗

<transport-guarantee>

1回

┃

┗

<original-name>

1回

┃

−

−

┣

<login-config>

0回以上

┣

<login-config>

0回以上

┃

┣

<auth-method>

0または1回

┃

┣

<auth-method>

0または1回

┃

┣

<realm-name>

0または1回

┃

┣

<realm-name>

0または1回

┃

┗

<form-login-config>

0または1回

┃

┗

<form-login-config>

0または1回

┃

┣

<form-login-page>

1回

┃

┣

<form-login-page>

1回

┃

┗

<form-error-page>

1回

┃

┗

<form-error-page>

1回

┣

<security-role>

0回以上

┣

<security-role>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┗

<role-name>

1回

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<env-entry>

0回以上

┣

<env-entry>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-name>

1回

┃

┣

<env-entry-type>

0または1回

┃

┣

<env-entry-type>

0または1回

┃

┣

<env-entry-value>

1回

┃

┣

<env-entry-value>

0または1回

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<ejb-ref>

0回以上

┣

<ejb-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

0または1回

┃

┣

<ejb-ref-type>

0または1回

┃

┣

<home>

0または1回

┃

┣

<home>

0または1回

┃

┣

<remote>

0または1回

┃

┣

<remote>

0または1回

┃

┣

<ejb-link>

0または1回

┃

┣

<ejb-link>

0または1回

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<ejb-local-ref>

0回以上

┣

<ejb-local-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-name>

1回

┃

┣

<ejb-ref-type>

0または1回

┃

┣

<ejb-ref-type>

0または1回

┃

┣

<local-home>

0または1回

┃

┣

<local-home>

0または1回

┃

┣

<local>

0または1回

┃

┣

<local>

0または1回

┃

┣

<ejb-link>

0または1回

┃

┣

<ejb-link>

0または1回

┃

┃

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

−

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

−

┣

<resource-ref>

0回以上

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<res-ref-name>

1回

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

0または1回

┃

┣

<res-type>

0または1回

┃

┣

<res-auth>

0または1回

┃

┣

<res-auth>

0または1回

┃

┣

<res-sharing-scope>

0または1回

┃

┗

<res-sharing-scope>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┣

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<linked-to>

0または1回

┃

−

−

┣

<resource-env-ref>

0回以上

┣

<resource-env-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

0または1回

┃

┗

<resource-env-ref-type>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┃

┣

<linked-queue>

0または1回

┃

−

−

┃

┃

┣

<resource-adapter>

1回

┃

−

−

┃

┃

┗

<queue>

1回

┃

−

−

┃

┗

<linked-adminobject>

0または1回

┃

−

−

┃

┣

<resourceadapter-name>

1回

┃

−

−

┃

┗

<adminobject-name>

1回

┃

−

−

┣

<persistence-context-ref>

0回以上

┣

<persistence-context-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<persistence-context-ref-name>

1回

┃

┣

<persistence-context-ref-name>

1回

┃

┣

<persistence-unit-name>

0または1回

┃

┣

<persistence-unit-name>

0または1回

┃

┣

<persistence-context-type>

0または1回

┃

┣

<persistence-context-type>

0または1回

┃

┣

<persistence-property>

0回以上

┃

┣

<persistence-property>

0回以上

┃

┃

┣

<name>

1回

┃

┃

┣

<name>

1回

┃

┃

┗

<value>

1回

┃

┃

┗

<value>

1回

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<persistence-unit-ref>

0回以上

┃

<persistence-unit-ref>

0回以上

┃

┣

<description>

0回以上

┃

┣

<description>

0回以上

┃

┣

<persistence-unit-ref-name>

1回

┃

┣

<persistence-unit-ref-name>

1回

┃

┣

<persistence-unit-name>

0または1回

┃

┣

<persistence-unit-name>

0または1回

┃

┃

−

−

┃

┣

<mapped-name>

0または1回

┃

┗

<injection-target>

0回以上

┃

┗

<injection-target>

0回以上

┃

┣

<injection-target-class>

1回

┃

┣

<injection-target-class>

1回

┃

┗

<injection-target-name>

1回

┃

┗

<injection-target-name>

1回

┣

<post-construct>

0回以上

┣

<post-construct>

0回以上

┃

┣

<lifecycle-callback-class>

0または1回

┃

┣

<lifecycle-callback-class>

0または1回

┃

┗

<lifecycle-callback-method>

1回

┃

┗

<lifecycle-callback-method>

1回

┣

<pre-destroy>

0回以上

┣

<pre-destroy>

0回以上

┃

┣

<lifecycle-callback-class>

0または1回

┃

┣

<lifecycle-callback-class>

0または1回

┃

┗

<lifecycle-callback-method>

1回

┃

┗

<lifecycle-callback-method>

1回

┣

<locale-encoding-mapping-list>

0回以上

┗

<locale-encoding-mapping-list>

0回以上

┃

┗

<locale-encoding-mapping>

1回以上

┗

<locale-encoding-mapping>

1回以上

┃

┣

<locale>

1回

┣

<locale>

1回

┃

┗

<encoding>

1回

┗

<encoding>

1回

┗

<runtime>

0または1回

−

−

┗

<context-root>

1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<url-pattern>と<servlet-name>のどちらか一つまたは両方を指定します。

注※2

<error-code>と<exception-type>のどちらか一つを指定するか，両方とも指定しません。

注※3

<http-method>と<http-method-omission>のどちらか一つを指定します。それぞれのタグは0回以上指定できます。

3.7.3　cosminexus.xmlとの対応

WAR属性ファイルとcosminexus.xmlの対応を次に示します。

WAR属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

<hitachi-war-property>

1回

┣

<war>

0回以上

┃

−

−

┃

┣

<module-name>※1

1回

┃

（省略）

−

┃

┃

（省略）

−

┣

<security-role>

0回以上

┃

┣

<security-role>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

−

−

┃

┣

<role-name>

1回

┃

┃

┣

<role-name>

1回

┃

┗

<linked-to>

0または1回

┃

┃

┗

<linked-to>※2

1回

┃

（省略）

−

┃

┃

（省略）

−

┣

<ejb-ref>

0回以上

┃

┃

−

−

┃

┣

<destination>

0回以上

┃

┃

−

−

┃

┣

<ejb-ref-name>

1回

┃

┃

−

−

┃

┣

<ejb-ref-type>

1回

┃

┃

−

−

┃

┣

<home>

1回

┃

┃

−

−

┃

┣

<remote>

1回

┃

┃

−

−

┃

┗

<ejb-link>

0または1回

┃

┃

−

−

┣

<resource-ref>

0回以上

┃

┣

<resource-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┃

−

−

┃

┣

<res-ref-name>

1回

┃

┃

┣

<res-ref-name>

1回

┃

┣

<res-type>

1回

┃

┃

┃

−

−

┃

┣

<res-auth>

1回

┃

┃

┃

−

−

┃

┗

<linked-to>

0または1回

┃

┃

┗

<linked-to>※2

1回

┣

<resource-env-ref>

0回以上

┃

┣

<resource-env-ref>

0回以上

┃

┣

<description>

0または1回

┃

┃

┃

−

−

┃

┣

<resource-env-ref-name>

1回

┃

┃

┣

<resource-env-ref-name>

1回

┃

┣

<resource-env-ref-type>

1回

┃

┃

┃

−

−

┃

┣

<linked-queue>

0または1回

┃

┃

┣

<linked-queue>※2

1回

┃

┃

┣

<resource-adapter>※3

1回

┃

┃

┃

┣

<resource-adapter>

1回

┃

┃

┗

<queue>※3

1回

┃

┃

┃

┗

<queue>

1回

┃

┣

<linked-adminobject>

0または1回

┃

┃

┣

<linked-adminobject>※2

1回

┃

┃

┃

┃

┣

┃

<resourceadapter-name>※4

1回

┃

┃

┃

┃

┃

┃

┣

┃

<resourceadapter-name>

1回

┃

┃

┗

<adminobject-name>※4

1回

┃

┃

┃

┗

<adminobject-name>

1回

┃

┗

<linked-to>

0または1回

┃

┃

┗

<linked-to>※2

1回

┣

<runtime>

0または1回

┃

┃

−

−

┃

┗

<context-root>

1回

┃

┃

−

−

┣

<thread-control>

0または1回

┃

┣

<thread-control>

0または1回

┃

┃

┣

┃

<thread-control-max-threads>

1回

┃

┃

┃

┃

┣

┃

<thread-control-max-threads>

1回

┃

┃

┣

┃

<thread-control-exclusive-threads>

1回

┃

┃

┃

┃

┣

┃

<thread-control-exclusive-threads>※2

0または1回

┃

┃

┣

┃

<thread-control-queue-size>

1回

┃

┃

┃

┃

┣

┃

<thread-control-queue-size>

1回

┃

┃

┣

┃

<thread-control-stats-monitor>

1回

┃

┃

┃

┃

┣

┃

<thread-control-stats-monitor>

0または1回

┃

┃

┃

┃

┣

┃

<whole-waiting-request-count>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<whole-waiting-request-count>

1回

┃

┃

┃

┣

<enabled>

1回

┃

┃

┃

┃

┣

<enabled>

0または1回

┃

┃

┃

┣

<high-threshold>

1回

┃

┃

┃

┃

┣

<high-threshold>

0または1回

┃

┃

┃

┗

<low-threshold>

1回

┃

┃

┃

┃

┗

<low-threshold>

0または1回

┃

┃

┃

┃

┗

<waiting-request-count>

1回

┃

┃

┃

┃

┃

┃

┗

<waiting-request-count>

1回

┃

┃

┣

<enabled>

1回

┃

┃

┃

┣

<enabled>

0または1回

┃

┃

┣

<high-threshold>

1回

┃

┃

┃

┣

<high-threshold>

0または1回

┃

┃

┗

<low-threshold>

1回

┃

┃

┃

┗

<low-threshold>

0または1回

┃

┣

<resource-watcher>

1回

┃

┃

┣

<resource-watcher>

1回

┃

┃

┣

<watcher-threshold>

1回

┃

┃

┃

┣

<watcher-threshold>

1回

┃

┃

┣

<watcher-interval>

1回

┃

┃

┃

┣

<watcher-interval>

1回

┃

┃

┣

<watcher-enabled>

1回

┃

┃

┃

┣

<watcher-enabled>

1回

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

1回

┃

┃

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

1回

┃

┃

┗

<urlgroup-thread-control>

0回以上

┃

┃

┃

┃

┗

<urlgroup-thread-control>

0回以上

┃

┃

┣

┃

<urlgroup-thread-control-name>

1回

┃

┃

┃

┃

┣

┃

<urlgroup-thread-control-name>

1回

┃

┃

┣

┃

<urlgroup-thread-control-max-threads>

1回

┃

┃

┃

┃

┣

┃

<urlgroup-thread-control-max-threads>

1回

┃

┃

┃

┣

┃

┃

<urlgroup-thread-control-exclusive-threads>

1回

┃

┃

┃

┃

┃

┃

┣

┃

┃

<urlgroup-thread-control-exclusive-threads>※2

0または1回

┃

┃

┣

┃

<urlgroup-thread-control-queue-size>

1回

┃

┃

┃

┃

┣

┃

<urlgroup-thread-control-queue-size>

1回

┃

┃

┣

┃

<urlgroup-thread-control-mapping>

0回以上

┃

┃

┃

┃

┣

┃

<urlgroup-thread-control-mapping>

0回以上

┃

┃

┗

<url-pattern>

1回

┃

┃

┃

┗

<url-pattern>

1回

┃

┗

<stats-monitor>

1回

┃

┃

┗

<stats-monitor>

1回

┃

┃

┗

<waiting-request-count>

1回

┃

┃

┃

┃

┗

<waiting-request-count>

1回

┃

┣

<enabled>

1回

┃

┃

┣

<enabled>

1回

┃

┃

┣

┃

<high-threshold>

1回

┃

┃

┃

┃

┣

┃

<high-threshold>

1回

┃

┃

┗

<low-threshold>

1回

┃

┃

┃

┃

┗

<low-threshold>

1回

┣

<http-request>

0または1回

┃

┣

<http-request>

0または1回

┃

┗

<encoding>

0または1回

┃

┃

┗

<encoding>※2

1回

┣

<http-response>

0または1回

┃

┣

<http-response>

0または1回

┃

┗

<encoding>

0または1回

┃

┃

┗

<encoding>※2

1回

┣

<jsp>

0または1回

┃

┣

<jsp>

0または1回

┃

┗

<page-encoding>

0または1回

┃

┃

┗

<page-encoding>※2

1回

┣

<http-session>

0または1回

┃

┣

<http-session>

0または1回

┃

┃

┣

┃

<http-session-max-number>

1回

┃

┃

┃

┃

┣

┃

<http-session-max-number>※2

0または1回

┃

┣

<resource-watcher>

1回

┃

┃

┣

<resource-watcher>

1回

┃

┃

┣

<watcher-threshold>

1回

┃

┃

┃

┣

<watcher-threshold>

1回

┃

┃

┣

<watcher-interval>

1回

┃

┃

┃

┣

<watcher-interval>

1回

┃

┃

┣

<watcher-enabled>

1回

┃

┃

┃

┣

<watcher-enabled>

1回

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

1回

┃

┃

┃

┃

┃

┃

┗

<watcher-writefile-enabled>

1回

┃

┗

<dbsfo>

0または1回

┃

┃

┗

<dbsfo>

0または1回

┃

┣

<enabled>

0または1回

┃

┃

┣

<enabled>

0または1回

┃

┣

<application-id>

0または1回

┃

┃

┣

<application-id>

0または1回

┃

┃

┣

┃

<attribute-data-size-max>

0または1回

┃

┃

┃

┃

┣

┃

<attribute-data-size-max>

0または1回

┃

┗

<exclude-extensions>

0または1回

┃

┃

┗

<exclude-extensions>

0または1回

┣

<start-notify-error>

0または1回

┃

┣

<start-notify-error>

0または1回

┗

<start-order>

0または1回

┃

┗

<start-order>

0または1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

（省略）：タグを省略しています。

注※1

application.xmlの<application>-<module>-<web>-<web-uri>に対応し，属性ファイルには存在しないcosminexus.xml独自のタグとなります。WARを特定するためのキーとなります。

注※2

cosminexus.xmlはカスタマイズしたい要素だけを記述する形式となるため，属性ファイルと出現パターンが異なります。

注※3

resource-adapterにはリソースアダプタ表示名，<queue>にはQUEUE名が入ります。

注※4

<resourceadapter-name>にはリソースアダプタ表示名，<adminobject-name>には管理対象オブジェクト名が入ります。

3.8　フィルタ属性ファイル

フィルタ属性ファイルは，フィルタの属性を取得，編集する場合に使用するファイルです。

3.8.1　フィルタ属性ファイルの指定内容

フィルタ属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-filter-property PUBLIC '-//Hitachi, Ltd.//DTD Filter Property 7.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-filter-property_7_0.dtd'>

フィルタ属性ファイルは，次に示すタグを持つxmlファイルです。なお，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名

出現パターン

説明

<hitachi-filter-property>

1回

ルートタグ。

┣

<description>※1

0回以上※2

フィルタの説明。

┣

┃

┃

┃

┃

┃

┃

┃

┃

<display-name>※1

1回以上※2

フィルタの表示名。

xml:lang属性が"en"のdisplay-nameを必ず指定します。該当するリソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。

1≦文字列長

文字の制限はありません。

複数のフィルタが存在する場合，それぞれに一意となる文字列を指定します。

┣

<icon>※1

0回以上※2

Deployツール上に表示されるフィルタのアイコンの定義。

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。

┣

┃

┃

<filter-name>

1回

フィルタ名称。※3

複数のフィルタが存在する場合，それぞれ一意となる文字列を指定します。

┣

┃

┃

<filter-class>

1回

フィルタのクラス名。※3

パッケージが定義されている場合，パッケージ名から指定します。

┣

<init-param>

0回以上

初期化パラメタについての定義。

┃

┣

<description>※1

0回以上※2

パラメタの説明。

┃

┃

┃

┣

┃

┃

<param-name>

1回

初期化パラメタ名称。

複数のフィルタ名が存在する場合，それぞれに一意な文字列を指定します。

┃

┗

<param-value>

1回

初期化パラメタの値。

┗

<method-observation-timeout>

0または1回

フィルタ内のメソッド共通の仕掛かり中メソッド監視用タイムアウト時間。

指定できる値は，0〜86400（単位：秒）です。0を指定した場合，タイムアウトしません。デフォルト値は0です。

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

Servlet2.3以前のWARに対して，このタグを複数指定できません。

注※3

cjgetappprop，cjgetrespropコマンドで出力されたものに対して，タグ名の変更，タグの追加・削除，または値の変更をしてはいけません。

3.8.2　DDとの対応

フィルタ属性ファイルとDeployment Descriptorの対応を次に示します。

フィルタ属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-filter-property>

1回

<web-app>

1回

┃

(省略)

−

┃

(省略)

−

┃

−

−

┗

<filter>

0回以上

┣

<icon>

0回以上

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┗

<large-icon>

0または1回

┣

<filter-name>

1回

┣

<filter-name>

1回

┣

<display-name>

1回以上

┣

<display-name>

0回以上

┣

<description>

0回以上

┣

<description>

0回以上

┣

<filter-class>

1回

┣

<filter-class>

1回

┗

<init-param>

0回以上

┗

<init-param>

0回以上

┣

<param-name>

1回

┣

<param-name>

1回

┣

<param-value>

1回

┣

<param-value>

1回

┗

<description>

0回以上

┗

<description>

0回以上

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

3.8.3　cosminexus.xmlとの対応

フィルタ属性ファイルとcosminexus.xmlの対応を次に示します。

フィルタ属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

<hitachi-filter-property>

1回

┣

<war>

0回以上

┃

（省略）

−

┃

┃

−

−

┃

−

−

┃

┣

<filter>

0回以上

┃

−

−

┃

┃

┣

<filter-name>※1

1回

┗

<method-observation-timeout>

0または1回

┃

┃

┃

┃

┗

<method-observation-timeout>※2

1回

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

（省略）：タグを省略しています。

注※1

web.xmlの<web-app>-<filter>-<filter-name>に対応し，属性ファイルには存在しないタグとなります。Filterを特定するためのキーとなります。

注※2

cosminexus.xmlはカスタマイズしたい要素だけを記述する形式となるため，属性ファイルと出現パターンが異なります。

3.9　サーブレット属性ファイル

サーブレット属性ファイルは，サーブレット/JSPの属性を取得，編集する場合に使用するファイルです。

3.9.1　サーブレット属性ファイルの指定内容

サーブレット属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-servlet-property PUBLIC '-//Hitachi, Ltd.//DTD Servlet Property 7.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-servlet-property_7_0.dtd'>

サーブレット属性ファイルは，次に示すタグを持つxmlファイルです。また，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名

出現パターン

説明

<hitachi-servlet-property>

1回

ルートタグ。

┣

┃

<description>※1

0回以上※2

サーブレット/JSPの説明。

┣

┃

┃

┃

┃

┃

<display-name>※1

1回以上※2

サーブレット/JSPの表示名。

xml:lang属性が"en"のdisplay-nameを必ず指定します。該当するリソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。

1≦文字列長

文字の制限はありません。

┣

<icon>※1

0回以上※2

Deployツール上に表示されるServletのアイコンの定義。

┃

┣

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。

┣

<init-param>

0回以上

初期化パラメタについての定義。

┃

┣

<description>※1

0回以上※2

init-paramの説明。

┃

┣

<param-name>

1回

初期化パラメタの名称。

┃

┗

<param-value>

1回

初期化パラメタの値。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<load-on-startup>

0または1回

スタートアップ時のロード指定。

指定できる整数値を次に示します。

-2147483648≦load-on-startup≦-1

必要になった時点でロードされます。

-1以外を指定しても-1として扱われます。

0

スタートアップ時にロードします。

ロードする順番は，Containerが決定します。

1≦load-on-startup≦2147483647

スタートアップ時にロードします。

ロードする順番は，小さな値から大きな値の順となります。

なお，Servlet2.5以降より，空文字も指定できます。

┣

<run-as>

0または1回

実行時アイデンティティについての定義。※3

┃

┣

<description>※1

0回以上※2

run-asの説明。※3

┃

┣

<role-name>

1回

セキュリティロール名。※3

┃

┗

<user-name>

1回

ユーザ名を指定します。

┣

<security-role-ref>

0回以上

セキュリティロールについての定義。

┃

┣

<description>※1

0回以上※2

security-role-refの説明。

┃

┣

<role-name>

1回

security-role-refの名称。

┃

┗

<role-link>

0または1回

リンク先のロール名。

┣

┃

┃

┃

┃

┃

<url-pattern>※4

0回以上

サーブレットのURL。

アプリケーション統合属性ファイルで，このタグの情報を別のサーブレットの情報と入れ替える場合は，登録されているアプリケーション内のすべてのサーブレットの<url-pattern>の情報をcjsetapppropコマンドで削除したあと，正しい情報を設定してください。

┗

<method-observation-timeout>

0または1回

サーブレット内のメソッド共通の仕掛かり中メソッド監視用タイムアウト時間。

指定できる値は，0〜86400（単位：秒）です。0を指定した場合，タイムアウトしません。デフォルト値は0です。

−

−

−

−

−

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

Servlet2.3以前のWARに対して，このタグを複数指定できません。

注※3

アノテーションの設定値だった場合，値の変更は無視されます。

注※4

アプリケーション統合属性ファイルをcjsetapppropコマンドで設定すると，サーブレット単位（<hitachi-servlet-property>タグ単位）に設定値の反映処理を実施します。ただし，<hitachi-servlet-property>−<url-pattern>タグについては，すべてのサーブレットで重複がないかどうかのチェックを実施しています。

3.9.2　DDとの対応

サーブレット属性ファイルとDeployment Descriptorの対応を次に示します。

サーブレット属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-servlet-property>

1回

<web-app>

1回

┃

−

−

┃

(省略)

−

┃

−

−

┣

<servlet>

0回以上

┣

<description>

0回以上

┃

┣

<description>

0回以上

┣

<display-name>

1回以上

┃

┣

<display-name>

0回以上

┃

−

−

┃

┣

<servlet-name>

1回

┣

<icon>

0回以上

┃

┣

<icon>

0回以上

┃

┣

<small-icon>

0または1回

┃

┃

┣

<small-icon>

0または1回

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

−

−

┃

┣

<servlet-class>※

1回

┃

−

−

┃

┣

<jsp-file>※

1回

┣

<init-param>

0回以上

┃

┣

<init-param>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<param-name>

1回

┃

┃

┣

<param-name>

1回

┃

┗

<param-value>

1回

┃

┃

┗

<param-value>

1回

┣

<load-on-startup>

0または1回

┃

┣

<load-on-startup>

0または1回

┣

<run-as>

0または1回

┃

┣

<run-as>

0または1回

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┗

<role-name>

1回

┃

┃

┗

<role-name>

1回

┣

<security-role-ref>

0回以上

┃

┗

<security-role-ref>

0回以上

┃

┣

<description>

0回以上

┃

┃

┣

<description>

0回以上

┃

┣

<role-name>

1回

┃

┃

┣

<role-name>

1回

┃

┗

<role-link>

0または1回

┃

┃

┗

<role-link>

0または1回

┃

−

−

┗

<servlet-mapping>

0回以上

┃

−

−

┣

<servlet-name>

1回

┗

<url-pattern>

0回以上

┗

<url-pattern>

1回以上

−

−

(省略)

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<servlet-class>と<jsp-file>のどちらか一つを指定します。

3.9.3　cosminexus.xmlとの対応

サーブレット属性ファイルとcosminexus.xmlの対応を次に示します。

サーブレット属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

<hitachi-servlet-property>

1回

┣

<war>

1回

┃

−

−

┃

┣

<servlet>

0回以上

┃

−

−

┃

┃

┣

<servlet-name>※

1回

┣

<run-as>

0または1回

┃

┃

┣

<run-as>

0または1回

┃

┣

<description>

0回以上

┃

┃

┃

┃

−

−

┃

┣

<role-name>

1回

┃

┃

┃

┃

−

−

┃

┗

<user-name>

1回

┃

┃

┃

┗

<user-name>

1回

┗

<method-observation-timeout>

0または1回

┃

┃

┃

┃

┗

<method-observation-timeout>

0または1回

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

注※

web.xmlの<web-app>-<servlet>-<servlet-name>に対応し，属性ファイルには存在しないタグとなります。Servletを特定するためのキーとなります。

4　リソースの設定で使用する属性ファイル

この章では，アプリケーションサーバで使用するリソースを設定するファイルについて説明します。

4.1　Connector属性ファイル

Connector属性ファイルは，リソースアダプタの属性を取得，編集する場合に使用するファイルです。

4.1.1　Connector属性ファイルの指定内容

Connector属性ファイルの表中で用いる項目と，その項目の説明を記します。

項目名

説明

タグ名

設定するタグを表します。

出現パターン

タグが出現する回数を示します。

内容

タグに定義する内容を示します。

指定可能値

タグに指定できる値を示します。指定できない場合にはハイフン「-」を記述します。

デフォルト

タグに指定する内容が省略されている場合に有効になる指定値を示します。デフォルト値がない場合は"なし"を記述します。

バージョン

定義できるアプリケーションサーバのバージョンを記述します。

キーの省略，値の省略および内容の詳細については，Connector属性ファイルの各定義の詳細に記載しています。

Connector属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-connector-property PUBLIC '-//Hitachi, Ltd.//DTD Connector Property 7.6//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-connector-property_7_6.dtd'>

Connector属性ファイルは，次に示すタグを持つxmlファイルです。なお，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名

出現パターン

内容

指定可能値

デフォルト

バージョン

<hitachi-connector-property>

0または1回

ルートタグ。

−

なし

05-05

┣

┃

┃

┃

<description>

0回以上

リソースアダプタについての説明。

入力は制限されません。

なし

05-05

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<display-name>

1回以上

Deployツール上に表示されるリソースアダプタの名称。

英数字，アンダースコア「_」だけ使用できます。

1≦文字列長≦240の範囲で指定できます。指定できる文字数は1〜作業ディレクトリのパス長の見積もり式※で見積もった範囲の長さです。

変更する場合，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

「TP1/Message Queue - Access」はTP1/Message Queue - Accessのrarの表示名であるため指定できます。

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

次の名称を指定した場合，J2EEアプリケーションの操作ができなくなるおそれがあります。このため，次の名称を指定しないでください。

記号の前後にアンダースコア(_)を指定している名称（例：abc_+_001）

記号で終わる名称（例：abc+）

なし

05-05

┣

┃

┃

┃

<icon>

0回以上

Deployツール上に表示されるリソースアダプタのアイコンの定義。

−

なし

05-05

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<small-icon>

0または1回

スモールアイコン（16×16）のファイル名。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┗

<large-icon>

0または1回

ラージアイコン（32×32）のファイル名。

入力は制限されません。

なし

05-05

┣

┃

┃

┃

┃

<vendor-name>

1回

リソースアダプタプロバイダベンダ名。

変更不可。

入力は制限されません。

なし

05-05

┣

┃

┃

┃

┃

┃

┃

<spec-version>

1回

リソースアダプタがサポートしているコネクタアーキテクチャ仕様のバージョン。

変更不可。

入力は制限されません。

なし

05-05

┣

┃

┃

┃

┃

┃

┃

<eis-type>

1回

EISのタイプについての情報。

変更不可。

入力は制限されません。

なし

05-05

┣

┃

┃

┃

┃

<version>

1回

リソースアダプタのバージョン。

変更不可。

入力は制限されません。

なし

05-05

┣

┃

┃

┃

┃

┃

<license>

0または1回

リソースアダプタモジュールのライセンス要求についての定義。

−

なし

05-05

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<description>

0回以上

licenseについての説明。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┗

<license-required>

1回

リソースアダプタのデプロイ，使用時のライセンス要求用フラグ。

変更不可。

指定できる文字列を次に示します。

true：要求する

false：要求しない

なし

05-05

┣

┃

┃

<resourceadapter>

1回

リソースアダプタの設定についての定義。

−

なし

05-05

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<resourceadapter-class>

0または1回

javax.resource.spi.ResourceAdapterを実装したJavaクラス名。

変更不可。

入力は制限されません。

なし

07-50

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

<config-property>

0回以上

ResourceAdapterインスタンスのためのコンフィグレーションプロパティの定義。

Connector 1.5の仕様に準拠するリソースアダプタに対してだけ指定できます。

−

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<description>

0回以上

コンフィグレーションプロパティについての説明。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<config-property-name>

1回

コンフィグレーションプロパティの名称。

名称の重複指定はできません。

TP1インバウンドアダプタの設定については，「4.1.10(6)　TP1インバウンドアダプタに設定する<config-property>に指定できるプロパティ」を参照してください。

CJMSプロバイダのリソースアダプタの設定については，「4.1.11　CJMSプロバイダのリソースアダプタに設定する<config-property>タグに指定できるプロパティ」を参照してください。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<config-property-type>

1回

ResourceAdapterによって要求されるコンフィグレーションプロパティのJavaの型。

次のどれかを指定します。

java.lang.Boolean

java.lang.String

java.lang.Integer

java.lang.Double

java.lang.Byte

java.lang.Short

java.lang.Long

java.lang.Float

java.lang.Character

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<config-property-value>

0または1回

コンフィグレーションプロパティの値。

<config-property-value>タグが指定されていない場合は，そのプロパティの情報は変更しません。すでに設定されている情報がそのまま残ります。

<config-property-value>タグを指定して，値を指定しない場合は，そのプロパティの情報に空が設定されます。

<config-property-value>タグを指定して，値を指定している場合は，指定した値がプロパティに設定されます。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┣

┃

┃

┃

<outbound-resourceadapter>

0または1回

Outbound方向へのリソースアダプタの定義を指定します。

−

なし

07-50

┃

┃

┃

┃

┃

┃

┣

┃

┃

<connection-definition>

1回以上

コネクションインタフェースクラスについての定義。

−

なし

07-50

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<managedconnectionfactory-class>

1回

javax.resource.spi.ManagedConnectionFactoryインタフェースを実装したJavaクラス名。

パッケージが定義されている場合は，パッケージから指定します。

変更不可。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<config-property>

0回以上

コンフィグレーションプロパティについての定義。

−

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<description>

0回以上

コンフィグレーションプロパティについての説明。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<config-property-name>

1回

コンフィグレーションプロパティの名称。

名称の重複指定はできません。

DB Connectorの設定については，「4.1.10　DB Connectorに設定する<config-property>タグに指定できるプロパティ」を参照してください。

CJMSプロバイダのリソースアダプタの設定については，「4.1.11　CJMSプロバイダのリソースアダプタに設定する<config-property>タグに指定できるプロパティ」を参照してください。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<config-property-type>

1回

ResourceAdapterによって要求されるコンフィグレーションプロパティのJavaの型。

次のどれかを指定します。

java.lang.Boolean

java.lang.String

java.lang.Integer

java.lang.Double

java.lang.Byte

java.lang.Short

java.lang.Long

java.lang.Float

java.lang.Character

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<config-property-value>

0または1回

コンフィグレーションプロパティの値。

<config-property-value>タグが指定されていない場合は，そのプロパティの情報は変更しません。すでに設定されている情報がそのまま残ります。

<config-property-value>タグを指定して，値を指定しない場合は，そのプロパティの情報に空が設定されます。

<config-property-value>タグを指定して，値を指定している場合は，指定した値がプロパティに設定されます。<config-property-name>タグに「XAOpenString」が設定されていて，<config-property-value>タグに値が設定されている場合，セキュリティ上の理由で，<config-property-value>タグは表示されません。変更する場合は，<config-property-value>タグを追加して，変更後の値を設定してください。

cjgetresprop，cjgetrarprop実行時に，<config-property-name>タグに「XAOpenString」が設定されている場合，タグは次のように表示されます。

値が設定されている場合：

コメントタグ<!-- The config-property-value has already been set. -->

値が設定されていない場合：

空タグ<>

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

<connectionfactory-interface>

1回

リソースでサポートされるConnectionFactoryインタフェースのクラス名。パッケージが定義されている場合は，パッケージから指定します。

Connector1.5のリソースアダプタの場合，このタグの値がコネクション定義識別子となります。

変更不可。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

<connectionfactory-impl-class>

1回

ConnectionFactoryインタフェースを実装したJavaクラス名。パッケージが定義されている場合は，パッケージから指定します。

変更不可。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<connection-interface>

1回

リソースアダプタでサポートされるConnectionインタフェースのクラス名。

パッケージが定義されている場合は，パッケージから指定します。

変更不可。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<connection-impl-class>

1回

Connectionインタフェースを実装したJavaクラス名。パッケージが定義されている場合は，パッケージから指定します。

変更不可。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<connector-runtime>

0または1回

実行時プロパティについての定義。

−

なし

07-50

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<property>

0回以上

コネクションインタフェース・クラスに関する独自情報を設定します。

−

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<property-name>

1回

プロパティ名。

次のどれかを指定します。

MaxPoolSize

MinPoolSize

LogEnabled

User

Password

ValidationType

ValidationInterval

RetryCount

RetryInterval

ConnectionTimeout

SweeperInterval

RequestQueueEnable

RequestQueueTimeout

WatchEnabled

WatchInterval

WatchThreshold

WatchWriteFileEnabled

ConnectionPoolAdjustmentInterval

Warmup

NetworkFailureTimeout

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<property-type>

1回

プロパティ値のJavaの型。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<property-value>

0または1回

プロパティの値。

<property-value>タグが指定されていない場合は，そのプロパティの情報は変更しません。すでに設定されている情報がそのまま残ります。

<property-value>タグを指定して，値を指定しない場合は，そのプロパティの情報に空が設定されます。

<property-value>タグを指定して，値が指定されている場合は，指定した値がプロパティに設定されます。

<property-name>タグに「User」または「Password」が指定されており，<property-value>タグに値が指定されている場合は，セキュリティ上の理由で表示しません。変更する場合は，<property-value>タグを追加して，変更後の値を設定します。

値が設定されている場合：

コメントタグ<!-- The property-value has already been set. -->

値が設定されていない場合：

空タグ<>

入力は制限されません。

「4.1.12　<property>タグに指定できるプロパティ」を参照してください。

−

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<property-default-value>

0または1回

プロパティのデフォルト値。

変更不可。

入力は制限されません。

−

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<resource-external-property>

0回以上

リソースのエクスターナルプロパティの定義。

<resource-external-property>の指定が複数あり，<optional-name>の設定値が同じ場合，一つにマージされます。その場合，警告メッセージ（KDJE37600-W）が出力され，後ろに定義された<resource-external-property>の<res-auth>や<res-sharing-scope>の値が有効になります。

−

なし

07-00

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<description>

0または1回

リソースのオプショナル名の説明。

入力は制限されません。

なし

07-00

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<optional-name>

1回

リソースの別名。

このタグについては，マニュアル

同一リソース内に<resource-external-property>の指定が複数あり，<optional-name>の指定値がほかの<optional-name>の指定値の下位階層となるような関係の場合は，警告メッセージ（KDJE37602-W）が出力されます。

（例）

別名1：AAA

別名2：AAA/BBB

1≦文字列長≦255

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

文字数は1〜255文字です。

次の名前は指定できません。

予約語であるHITACHI_EJB（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）だけ，またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

また，文字列の途中に改行がある場合はエラーとなります。

なし

07-00

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<res-auth>

0または1回

リソースを使用するための認証元を，アプリケーション上で行うか，コンテナに任せるかの指定。

指定できる文字列を次に示します。

Application

Container

Container

07-00

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<res-sharing-scope>

0または1回

リソース接続を共有するかどうかの指定。

指定できる文字列を次に示します。

Shareable

Unshareable

Shareable

07-00

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

<transaction-support>

1回

リソースアダプタで提供されるトランザクションサポートのレベル。

指定できる文字列を次に示します。

NoTransaction

LocalTransaction

XATransaction

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<reauthentication-support>

1回

ManagedConnectionインスタンスの再認証をサポートするかどうかの指定。

指定できる文字列を次に示します。

なお，DB Connectorを使用する場合，trueに設定しても値は有効になりません。

true

false

なし

05-05

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

<inbound-resourceadapter>

0または1回

Inbound方向へのリソースアダプタの定義。

変更不可。

−

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<messageadapter>

0または1回

リソースアダプタのメッセージング関連の機能の定義。

変更不可。

−

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┗

<messagelistener>

1回以上

メッセージリスナの定義。

変更不可。

−

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<messagelistener-type>

1回

メッセージリスナのタイプ。

変更不可。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<activationspec>

1回

メッセージエンドポイント活性化のための情報。

変更不可。

−

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<activationspec-class>

1回

ActivationSpecインタフェースを実装するクラス。

変更不可。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<required-config-property>

0回以上

メッセージエンドポイント活性化のために設定が必要なプロパティ。

変更不可。

−

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<description>

0回以上

メッセージエンドポイント活性化のために設定が必要なプロパティについての説明。

変更不可。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<config-property-name>

1回

メッセージエンドポイント活性化のために設定が必要なプロパティの名称。

変更不可。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┣

┃

┃

┃

<adminobject>

0回以上

リソースアダプタが提供する管理対象オブジェクトについての定義。

管理対象オブジェクトについての定義は，Connector 1.5の仕様に準拠するリソースアダプタに対してだけ指定できます。

−

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃

┃

┃┃

┃

┣

┃

┃

┃

┃

┃

┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃┃┃

┃┃

┃

┃

┃

┃┃

┃

<adminobject-name>

0または1回

管理対象オブジェクト名。

リソースアダプタ内でユニークである必要があります。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

なお，連続したアンダースコア（_）は使用できません。

次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

<adminobject-interface>

1回

管理対象オブジェクトのクラスが実装するインタフェース。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<adminobject-class>

1回

管理対象オブジェクトのクラス。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┗

<config-property>

0回以上

管理対象オブジェクトのためのコンフィグレーションプロパティの定義。

−

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<description>

0回以上

コンフィグレーションプロパティについての説明。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

<config-property-name>

1回

コンフィグレーションプロパティの名称。

名称の重複指定はできません。

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃┃

┃

┃

┃

<config-property-type>

1回

adminobjectインスタンスによって要求されるコンフィグレーションプロパティのJavaの型。

次のどれかを指定します。

java.lang.Boolean

java.lang.String

java.lang.Integer

java.lang.Double

java.lang.Byte

java.lang.Short

java.lang.Long

java.lang.Float

java.lang.Character

なし

07-60

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┗

<config-property-value>

0または1回

コンフィグレーションプロパティの値。cjsetrespropコマンド，およびcjsetrarpropコマンド実行時の動作を次に示します。

<config-property-value>タグ指定なしの場合

プロパティの情報を空に設定します。

<config-property-value>タグが指定されていて，値が空の場合

プロパティの情報を空に設定します。

<config-property-value>タグが指定されていて，値が指定されている場合

プロパティに指定された値を設定します。

入力は制限されません。

なし

07-60

┃

┃

┃

┃

┗

<security-permission>

0回以上

セキュリティパーミッションについての定義。

変更不可。

−

なし

05-05

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

<description>

0回以上

リソースアダプタのコードから要求されるセキュリティパーミッションについての説明。

変更不可。

入力は制限されません。

なし

05-05

┃

┃

┃

┃

┃

┃

┗

<security-permission-spec>

1回

セキュリティポリシーファイル上のセキュリティパーミッション。

変更不可。

入力は制限されません。

なし

05-05

┗

<resourceadapter-runtime>

0または1回

Connector 1.5の仕様に準拠するリソースアダプタに対してだけ指定できます。

−

なし

07-50

┗

<property>

0回以上

リソースアダプタに関する独自情報を設定します。

−

なし

05-05

┣

┃

┃

┃

┃

┃

┃

┃

┃

<property-name>

1回

プロパティ名を指定します。

次のどれかを指定します。

「MaxTPoolSize」

「MinTPoolSize」

「TPoolKeepalive」

なし

05-05

┣

┃

┃

┃

<property-type>

1回

プロパティのタイプ。

入力は制限されません。

なし

05-05

┣

┃

┃

┃

┃

┃

┃

┃

┃

<property-value>

0または1回

プロパティ値のJavaの型。

入力は制限されません。

「4.1.12　<property>タグに指定できるプロパティ」を参照してください。

−

05-05

┗

<property-default-value>

0または1回

プロパティのデフォルト値。

変更不可。

入力は制限されません。

「4.1.12　<property>タグに指定できるプロパティ」を参照してください。

−

05-05

注※

作業ディレクトリのパス長の見積もり式の詳細については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

（凡例）

−：指定できる値はありません。

4.1.2　リソースアダプタの定義

Connector属性ファイルのリソースアダプタの定義に関する情報について，タグごとに説明します。

なお，ここでは，「4.1.1　Connector属性ファイルの指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<hitachi-connector-property>

説明

ルートタグ。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(2)　<description>

説明

リソースアダプタについての説明。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(3)　<display-name>

説明

Deployツール上に表示されるリソースアダプタの名称。

指定可能値

1≦文字列長≦240の範囲で指定できます。指定できる文字数は1〜作業ディレクトリのパス長の見積もり式※で見積もった範囲の長さです。変更する場合，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

また，「TP1/Message Queue - Access」はTP1/Message Queue - Accessのrarの表示名であるため指定できます。

次の名称を指定した場合，J2EEアプリケーションの操作ができなくなるおそれがあります。このため，次の名称を指定しないでください。

記号の前後にアンダースコア(_)を指定している名称（例：abc_+_001）

記号で終わる名称（例：abc+）

注※

作業ディレクトリのパス長の見積もり式の詳細については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

タグの省略

省略できません。

値の省略

省略できません。

(4)　<icon>

説明

Deployツール上に表示されるリソースアダプタのアイコンの定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(5)　<small-icon>

説明

スモールアイコン（16×16）のファイル名。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(6)　<large-icon>

説明

ラージアイコン（32×32）のファイル名。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(7)　<vendor-name>

説明

リソースアダプタプロバイダベンダ名。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(8)　<spec-version>

説明

リソースアダプタがサポートしているコネクタアーキテクチャ仕様のバージョン。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(9)　<eis-type>

説明

EISのタイプについての情報。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(10)　<version>

説明

リソースアダプタのバージョン。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(11)　<license>

説明

リソースアダプタモジュールのライセンス要求についての定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(12)　<description>

説明

licenseについての説明。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(13)　<license-required>

説明

リソースアダプタのデプロイ，使用時のライセンス要求用フラグ。

変更不可。

指定可能値

true：要求する

false：要求しない

タグの省略

省略できません。

値の省略

省略できません。

4.1.3　リソースアダプタの設定

Connector属性ファイルのリソースアダプタの設定の詳細について，タグごとに説明します。

なお，ここでは，「4.1.1　Connector属性ファイルの指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<resourceadapter>

説明

リソースアダプタの設定についての定義。

指定可能値

−

タグの省略

省略できません。

値の省略

省略できません。

(2)　<resourceadapter-class>

説明

javax.resource.spi.ResourceAdapterを実装したJavaクラス名。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

4.1.4　ResourceAdapterインスタンスに関するコンフィグレーションプロパティの定義

Connector属性ファイルのResourceAdapterインスタンスのコンフィグレーションプロパティの詳細について，タグごとに説明します。

なお，ここでは，「4.1.1　Connector属性ファイルの指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<config-property>

説明

ResourceAdapterインスタンスのためのコンフィグレーションプロパティの定義。

Connector 1.5の仕様に準拠するリソースアダプタに対してだけ指定できます。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(2)　<description>

説明

コンフィグレーションプロパティについての説明。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(3)　<config-property-name>

説明

コンフィグレーションプロパティの名称。

指定可能値

名称の重複指定はできません。

TP1インバウンドアダプタの設定については，「4.1.10(6)　TP1インバウンドアダプタに設定する<config-property>に指定できるプロパティ」を参照してください。

CJMSプロバイダのリソースアダプタの設定については，「4.1.11　CJMSプロバイダのリソースアダプタに設定する<config-property>タグに指定できるプロパティ」を参照してください。

タグの省略

省略できません。

値の省略

省略できません。

(4)　<config-property-type>

説明

ResourceAdapterによって要求されるコンフィグレーションプロパティのJavaの型。

指定可能値

次のどれかを指定します。

「java.lang.Boolean」

「java.lang.String」

「java.lang.Integer」

「java.lang.Double」

「java.lang.Byte」

「java.lang.Short」

「java.lang.Long」

「java.lang.Float」

「java.lang.Character」

タグの省略

省略できません。

値の省略

省略できません。

(5)　<config-property-value>

説明

コンフィグレーションプロパティの値。

<config-property-value>タグが指定されていない場合は，そのプロパティの情報は変更しません。すでに設定されている情報がそのまま残ります。<config-property-value>タグを指定して，値を指定しない場合は，そのプロパティの情報に空が設定されます。

<config-property-value>タグを指定して，値を指定している場合は，指定した値がプロパティに設定されます。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

4.1.5　アウトバウンドリソースアダプタの定義

Connector属性ファイルのアウトバウンドリソースアダプタの定義の詳細について，タグごとに説明します。

なお，ここでは，「4.1.1　Connector属性ファイルの指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<outbound-resourceadapter>

説明

Outbound方向へのリソースアダプタの定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(2)　<connection-definition>

説明

コネクションインタフェースクラスについての定義。

指定可能値

−

タグの省略

省略できません。

値の省略

省略できません。

(3)　<managedconnectionfactory-class>

説明

javax.resource.spi.ManagedConnectionFactoryインタフェースを実装したJavaクラス名。

パッケージが定義されている場合は，パッケージから指定します。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(4)　<config-property>

説明

コネクションインタフェースクラスに関するコンフィグレーションプロパティについての定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(5)　<description>

説明

コンフィグレーションプロパティについての説明。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(6)　<config-property-name>

説明

コンフィグレーションプロパティの名称。

指定可能値

名称の重複指定はできません。

DB Connectorの設定については，「4.1.10　DB Connectorに設定する<config-property>タグに指定できるプロパティ」を参照してください。

CJMSプロバイダのリソースアダプタの設定については，「4.1.11　CJMSプロバイダのリソースアダプタに設定する<config-property>タグに指定できるプロパティ」を参照してください。

タグの省略

省略できません。

値の省略

省略できません。

(7)　<config-property-type>

説明

ResourceAdapterによって要求されるコンフィグレーションプロパティのJavaの型。

指定可能値

次のどれかを指定します。

「java.lang.Boolean」

「java.lang.String」

「java.lang.Integer」

「java.lang.Double」

「java.lang.Byte」

「java.lang.Short」

「java.lang.Long」

「java.lang.Float」

「java.lang.Character」

タグの省略

省略できません。

値の省略

省略できません。

(8)　<config-property-value>

説明

コンフィグレーションプロパティの値。

<config-property-value>タグが指定されていない場合は，そのプロパティの情報は変更しません。すでに設定されている情報がそのまま残ります。

<config-property-value>タグを指定して，値を指定しない場合は，そのプロパティの情報に空が設定されます。

<config-property-value>タグを指定して，値を指定している場合は，指定した値がプロパティに設定されます。

<config-property-name>タグに「XAOpenString」が設定されていて，<config-property-value>タグに値が設定されている場合，セキュリティ上の理由で，<config-property-value>タグは表示されません。変更する場合は，<config-property-value>タグを追加して，変更後の値を設定してください。

cjgetresprop，cjgetrarprop実行時に，<config-property-name>タグに「XAOpenString」が設定されている場合，タグは次のように表示されます。

値が設定されている場合：

コメントタグ<!-- The config-property-value has already been set. -->

値が設定されていない場合：

空タグ<>

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(9)　<connectionfactory-interface>

説明

リソースでサポートされるConnectionFactoryインタフェースのクラス名。パッケージが定義されている場合は，パッケージから指定します。

Connector1.5のリソースアダプタの場合，このタグの値がコネクション定義識別子となります。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(10)　<connectionfactory-impl-class>

説明

ConnectionFactoryインタフェースを実装したJavaクラス名。パッケージが定義されている場合は，パッケージから指定します。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(11)　<connection-interface>

説明

リソースアダプタでサポートされるConnectionインタフェースのクラス名。パッケージが定義されている場合は，パッケージから指定します。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(12)　<connection-impl-class>

説明

Connectionインタフェースを実装したJavaクラス名。パッケージが定義されている場合は，パッケージから指定します。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(13)　<connector-runtime>

説明

実行時プロパティについての定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(14)　<property>

説明

コネクションインタフェース・クラスに関する独自情報を設定します。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(15)　<property-name>

説明

プロパティ名。

指定可能値

次のどれかを指定します。

「MaxPoolSize」

「MinPoolSize」

「LogEnabled」

「User」

「Password」

「ValidationType」

「ValidationInterval」

「RetryCount」

「RetryInterval」

「ConnectionTimeout」

「SweeperInterval」

「RequestQueueEnable」

「RequestQueueTimeout」

「WatchEnabled」

「WatchInterval」

「WatchThreshold」

「WatchWriteFileEnabled」

「ConnectionPoolAdjustmentInterval」

「Warmup」

「NetworkFailureTimeout」

タグの省略

省略できません。

値の省略

省略できません。

(16)　<property-type>

説明

プロパティ値のJavaの型。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(17)　<property-value>

説明

プロパティの値。

<property-value>タグが指定されていない場合は，そのプロパティの情報は変更しません。すでに設定されている情報がそのまま残ります。

<property-value>タグを指定して，値を指定しない場合は，そのプロパティの情報に空が設定されます。

<property-value>タグを指定して，値が指定されている場合は，指定した値がプロパティに設定されます。

<property-name>タグに「User」または「Password」が指定されており，<property-value>タグに値が指定されている場合は，セキュリティ上の理由で表示しません。変更する場合は，<property-value>タグを追加して，変更後の値を設定します。

値が設定されている場合：

コメントタグ<!-- The property-value has already been set. -->

値が設定されていない場合：

空タグ<>

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(18)　<property-default-value>

説明

プロパティのデフォルト値。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(19)　<resource-external-property>

説明

リソースのエクスターナルプロパティの定義。

<resource-external-property>の指定が複数あり，<optional-name>の設定値が同じ場合，一つにマージされます。その場合，警告メッセージ（KDJE37600-W）が出力され，後ろに定義された<resource-external-property>の<res-auth>や<res-sharing-scope>の値が有効になります。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(20)　<description>

説明

リソースの別名の説明。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(21)　<optional-name>

説明

リソースの別名。

同一リソース内に<resource-external-property>の指定が複数あり，<optional-name>の指定値がほかの<optional-name>の指定値の下位階層となるような関係の場合は，警告メッセージ（KDJE37602-W）が出力されます。

（例）

別名1：AAA
別名2：AAA/BBB
1≦文字列長≦255

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

文字数は1〜255文字です。

次の名前は指定できません。

予約語である”HITACHI_EJB”（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）だけ，またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

タグの省略

省略できません。

値の省略

省略できません。

(22)　<res-auth>

説明

リソースを使用するための認証元を，アプリケーション上で行うか，コンテナに任せるかの指定。

指定可能値

指定できる文字列を次に示します。

Application

Container

タグの省略

省略できます。

値の省略

省略できません。

(23)　<res-sharing-scope>

説明

リソース接続を共有するかどうかの指定。

指定可能値

指定できる文字列を次に示します。

Shareable

Unshareable

タグの省略

省略できます。

値の省略

省略できません。

(24)　<transaction-support>

説明

リソースアダプタで提供されるトランザクションサポートのレベル。

指定可能値

指定できる文字列を次に示します。

NoTransaction

LocalTransaction

XATransaction

タグの省略

省略できません。

値の省略

省略できません。

(25)　<reauthentication-support>

説明

ManagedConnectionインスタンスの再認証をサポートするかどうかの指定。

指定可能値

true

false

タグの省略

省略できません。

値の省略

省略できません。

4.1.6　インバウンドリソースアダプタの定義

Connector属性ファイルのインバウンドリソースアダプタの定義の詳細について，タグごとに説明します。

なお，ここでは，「4.1.1　Connector属性ファイルの指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<inbound-resourceadapter>

説明

Inbound方向へのリソースアダプタの定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(2)　<messageadapter>

説明

リソースアダプタのメッセージング関連の機能の定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(3)　<messagelistener>

説明

メッセージリスナの定義。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(4)　<messagelistener-type>

説明

メッセージリスナのタイプ。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<activationspec>

説明

メッセージエンドポイント活性化のための情報。

指定可能値

−

タグの省略

省略できません。

値の省略

省略できません。

(6)　<activationspec-class>

説明

ActivationSpecインタフェースを実装するクラス。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(7)　<required-config-property>

説明

メッセージエンドポイント活性化のために設定が必要なプロパティ。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(8)　<description>

説明

メッセージエンドポイント活性化のために設定が必要なプロパティについての説明。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(9)　<config-property-name>

説明

メッセージエンドポイント活性化のために設定が必要なプロパティの名称。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

4.1.7　管理対象オブジェクトの定義

Connector属性ファイルの管理対象オブジェクトについての定義の詳細について，タグごとに説明します。管理対象オブジェクトについての定義は，Connector 1.5の仕様に準拠するリソースアダプタに対してだけ指定できます。

なお，ここでは，「4.1.1　Connector属性ファイルの指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<adminobject>

説明

リソースアダプタが提供する管理対象オブジェクトについての定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(2)　<adminobject-name>

説明

管理対象オブジェクト名。

リソースアダプタ内でユニークである必要があります。

指定可能値

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

アンダースコア（_）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。

タグの省略

省略できます。

値の省略

省略できません。

(3)　<adminobject-interface>

説明

管理対象オブジェクトのクラスが実装するインタフェース。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(4)　<adminobject-class>

説明

管理対象オブジェクトのクラス。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<config-property>

説明

管理対象オブジェクトのためのコンフィグレーションプロパティの定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(6)　<description>

説明

コンフィグレーションプロパティについての説明。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(7)　<config-property-name>

説明

コンフィグレーションプロパティの名称。

指定可能値

名称の重複指定はできません。

「4.1.10　DB Connectorに設定する<config-property>タグに指定できるプロパティ」を参照してください。

タグの省略

省略できません。

値の省略

省略できません。

(8)　<config-property-type>

説明

adminobjectインスタンスによって要求されるコンフィグレーションプロパティのJavaの型。

指定可能値

次のどれかを指定します。

「java.lang.Boolean」

「java.lang.String」

「java.lang.Integer」

「java.lang.Double」

「java.lang.Byte」

「java.lang.Short」

「java.lang.Long」

「java.lang.Float」

「java.lang.Character」

タグの省略

省略できません。

値の省略

省略できません。

(9)　<config-property-value>

説明

コンフィグレーションプロパティの値。

cjsetrespropコマンド，およびcjsetrarpropコマンド実行時の動作を次に示します。

<config-property-value>タグ指定なしの場合

プロパティの情報を空に設定します。

<config-property-value>タグが指定されていて，値が空の場合

プロパティの情報を空に設定します。

<config-property-value>タグが指定されていて，値が指定されている場合

プロパティに指定された値を設定します。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

4.1.8　セキュリティパーミッションの定義

Connector属性ファイルのセキュリティパーミッションの定義の詳細について，タグごとに説明します。

なお，ここでは，「4.1.1　Connector属性ファイルの指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<security-permission>

説明

セキュリティパーミッションについての定義。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(2)　<description>

説明

リソースアダプタのコードから要求されるセキュリティパーミッションについての説明。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(3)　<security-permission-spec>

説明

セキュリティポリシーファイル上のセキュリティパーミッション。

変更不可。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

4.1.9　リソースアダプタの実行時情報

Connector属性ファイルのリソースアダプタの実行時情報の詳細について，タグごとに説明します。

なお，ここでは，「4.1.1　Connector属性ファイルの指定内容」に記載されている順番にタグの詳細について説明しています。

(1)　<resourceadapter-runtime>

説明

Connector 1.5の仕様に準拠するリソースアダプタに対してだけ指定できます。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(2)　<property>

説明

リソースアダプタに関する独自情報を設定します。

指定可能値

−

タグの省略

省略できます。

値の省略

省略できません。

(3)　<property-name>

説明

プロパティ名。

指定可能値

次のどれかを指定します。

「MaxTPoolSize」

「MinTPoolSize」

「TPoolKeepalive」

タグの省略

省略できません。

値の省略

省略できません。

(4)　<property-type>

説明

プロパティのタイプ。

指定可能値

入力は制限されません。

タグの省略

省略できません。

値の省略

省略できません。

(5)　<property-value>

説明

プロパティ値のJavaの型。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

(6)　<property-default-value>

説明

プロパティのデフォルト値。

指定可能値

入力は制限されません。

タグの省略

省略できます。

値の省略

省略できます。

4.1.10　DB Connectorに設定する<config-property>タグに指定できるプロパティ

DB Connectorに設定する<config-property>タグに指定できる値について説明します。

なお，Reliable Messagingを使用する上で必要な情報については，マニュアル「Reliable Messaging」を参照してください。

(1)　HiRDB Type4 JDBC Driverを使用してHiRDBに接続する場合

DBConnector_HiRDB_Type4_CP.rar，DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar，DBConnector_HiRDB_Type4_XA.rarまたはDBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar

トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。また，Reliable Messagingと連携する場合は，DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用します。

指定できるプロパティについては，表4-1を参照してください。

DBConnector_HiRDB_Type4_CP.rarまたはDBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar

グローバルトランザクションを使用する場合に使用します。また，Reliable Messagingと連携する場合は，DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用します。

指定できるプロパティについては，表4-2を参照してください。

DBConnector_HiRDB_Type4_XA.rarまたはDBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar

グローバルトランザクションを使用する場合に使用します。また，Reliable Messagingと連携する場合は，DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用します。

指定できるプロパティについては，表4-3を参照してください。

表4‒1　DBConnector_HiRDB_Type4_CP.rar，DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar，DBConnector_HiRDB_Type4_XA.rarまたはDBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

指定可能値

デフォルト

バージョン

CallableStatementPoolSize

「機能解説 基本・開発編(コンテナ共通機能)」−「3.14.4」

java.lang.Integer

コネクションプールに割り当てられるコネクションごとのCallableStatementのプール数を設定します。有効範囲は0〜4095です。

0を指定した場合，ステートメントをプールしません。

0〜4095の整数で指定します。

10

07-00

CancelStatement

java.lang.Boolean

トランザクションタイムアウトやUAP強制停止時にステートメントのキャンセルを実行するかどうかを設定します。

trueを指定した場合：

実行中のSQLをキャンセルします。

falseを指定した場合：

実行中のSQLをキャンセルしません。

指定できる文字列を次に示します。

true

false

true

07-00

DBHostName

java.lang.String

接続するHiRDBおよびXDM/RD E2のホスト名を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetDBHostNameメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

(空文字列)

07-00

description

java.lang.String

データベースへの接続に必要な接続付加情報を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetDescriptionメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

(空文字列)

07-00

encodeLang

java.lang.String

データ変換時の文字セット名称を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetEncodeLangメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

(空文字列)

07-10

environmentVariables

java.lang.String

HiRDBクライアント環境変数を指定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetEnvironmentVariablesメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

(空文字列)

07-10

HiRDBCursorMode

java.lang.Boolean

HiRDBがコミットを行った場合にResultSetクラスのオブジェクトを有効とするかを指定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetHiRDBCursorModeメソッドに渡されます。

指定できる文字列を次に示します。

true

false

false

07-00

JDBC_IF_TRC

java.lang.Boolean

JDBCインタフェースメソッドトレースの取得の有無を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetJDBC_IF_TRACEメソッドに渡されます。

指定できる文字列を次に示します。

true

false

false

07-00

loginTimeout

java.lang.Integer

getConnectionメソッドでConnectionオブジェクトを取得する際の，HiRDBサーバとの物理接続確立の最大待ち時間（秒）を指定します。

設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetLoginTimeoutメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

8

07-00

logLevel

java.lang.String

DB Connectorが出力するログトレースのレベルを指定します。

0またはERROR

10またはWARNING

20またはINFORMATION

次のどれかを指定します。

0またはERROR

10またはWARNING

20またはINFORMATION

ERROR

07-00

LONGVARBINARY_Access

java.lang.String

JDBC SQLタイプLONGVARBINARY（HiRDBデータ型である列属性BLOB，列属性BINARY）のデータベースアクセス方法を指定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetLONGVARBINARY_Accessメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

REAL

07-00

LONGVARBINARY_AccessSize

java.lang.Integer

HiRDBサーバに対して一度に要求するJDBC SQLタイプLONGVARBINARY型データの長さを指定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetLONGVARBINARY_AccessSizeメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

0

07-00

LONGVARBINARY_TruncError

java.lang.Boolean

JDBC SQLタイプLONGVARBINARY型データ取得時に切り捨てが発生した場合に例外を投入することを指定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetLONGVARBINARY_TruncErrorメソッドに渡されます。

指定できる文字列を次に示します。

true

false

true

07-10

maxBinarySize

java.lang.Integer

JDBC SQLタイプLONGVARBINARY型データ取得時のデータサイズの上限を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetMaxBinarySizeメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

DBConnector_HiRDB_Type4_CP.rar，DBConnector_HiRDB_Type4_XA.rarのデフォルト値：0

DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar，DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarのデフォルト値：64000

07-10

PreparedStatementPoolSize

「機能解説 基本・開発編(コンテナ共通機能)」−「3.14.4」

java.lang.Integer

コネクションプールに割り当てられるコネクションごとのPreparedStatementのプール数を設定します。有効範囲は0〜4095です。

0を指定した場合，ステートメントをプールしません。

0〜4095の整数で指定します。

10

07-00

SQLInNum

java.lang.Integer

実行するSQLの入力?パラメタの最大数を指定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetSQLInNumメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

300

07-10

SQLOutNum

java.lang.Integer

実行するSQLの検索項目の最大数を指定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetSQLOutNumメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

300

07-10

SQLWarningIgnore

java.lang.Boolean

データベースから返される警告をConnectionクラスで保持しないかどうかの情報を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetSQLWarningIgnoreメソッドに渡されます。

指定できる文字列を次に示します。

true

false

false

07-00

SQLWarningLevel

java.lang.String

SQL実行時に発生した警告保持レベルを指定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetSQLWarningLevelメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

SQLWARN

07-10

TRC_NO

java.lang.Integer

JDBCインタフェースメソッドトレースのエントリ数を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetTRC_NOメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

500

07-00

uapName

java.lang.String

アプリケーション名称を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetUapNameメソッドに渡されます。

マニュアル「HiRDB UAP開発ガイド」を参照してください。

(空文字列)

07-10

表4‒2　DBConnector_HiRDB_Type4_CP.rarまたはDBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

linkedResourceAdapterName

java.lang.String

連携するReliable Messagingリソースアダプタの表示名を指定します。

DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用する場合に指定できます。

表4‒3　DBConnector_HiRDB_Type4_XA.rarまたはDBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

linkedResourceAdapterName

java.lang.String

連携するReliable Messagingリソースアダプタの表示名を指定します。

DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合に指定できます。

XACloseString

java.lang.String

XAクローズ文字列を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetXACloseStringメソッドに渡されます。

XALocalCommitMode

java.lang.Boolean

トランザクションがグローバルトランザクションではないときにオートコミット機能を有効にするかどうかを設定します。設定された値はHiRDB Type4 JDBC DriverのDataSource系インタフェースのsetXALocalCommitModeメソッドに渡されます。なお，falseを指定した場合，リソースの接続テスト（cjtestresコマンド），コネクション障害検知機能が正常に動作しません。リソースの接続テスト（cjtestresコマンド），コネクション障害検知機能を使用する場合，falseは指定しないでください。

また，DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarの場合，falseは指定しないでください。

デフォルト値：true

XAOpenString

java.lang.String

XAオープン文字列を設定します。設定された値は，HiRDB Type4 JDBC DriverのDataSource系インタフェースのsetXAOpenStringメソッドに渡されます。

(2)　MySQL Connector/Jを使用して，MySQLに接続する場合

DBConnector_MySQL_CP.rar

トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。

指定できるプロパティについては，次の表を参照してください。

表4‒4　DBConnector_MySQL_CP.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

指定可能値

デフォルト

バージョン

databaseName

java.lang.String

オンプレミス環境，Amazon RDS，またはAmazon AuroraのMySQLサーバ上の特定のデータベース名を指定します。指定した値は，MySQL Connector/JのsetDatabaseNameメソッドに渡されます。詳細については，MySQL Connector/Jのマニュアルを参照してください。

MySQLのマニュアルを参照してください。

(空文字列)

11-30

serverName

java.lang.String

オンプレミス環境の場合，MySQLサーバのホスト名またはIPアドレスを指定します。Amazon RDSまたはAmazon Auroraの場合，接続先のエンドポイント（DNS名）を指定します。指定した値は，MySQL Connector/JのsetServerNameメソッドに渡されます。詳細については，MySQL Connector/Jのマニュアルを参照してください。

MySQLのマニュアルを参照してください。

(空文字列)

11-30

portNumber

java.lang.Integer

オンプレミス環境，Amazon RDS，またはAmazon AuroraのMySQLのポート番号を指定します。指定した値は，MySQL Connector/JのsetPortNumberメソッドに渡されます。詳細については，MySQL Connector/Jのマニュアルを参照してください。

MySQLのマニュアルを参照してください。

3306

11-30

CancelStatement

java.lang.Boolean

トランザクションタイムアウトやUAP強制停止時にステートメントのキャンセルを実行するかどうかを設定します。

trueを指定した場合

実行中のSQLを取り消します。

falseを指定した場合

実行中のSQLを取り消しません。

Amazon AuroraまたはAmazon RDSの場合にRDS Proxyを使用するときは，falseを指定してください。

指定できる文字列を次に示します。

true

false

true

11-30

logLevel

java.lang.String

DB Connectorが出力するログ・トレースのレベルを指定します。

次のどれかを指定します。

0またはERROR

10またはWARNING

20またはINFORMATION

ERROR

11-30

(3)　Oracle JDBC Thin Driverを使用してOracleに接続する場合

DBConnector_Oracle_CP.rar，DBConnector_Oracle_CP_Cosminexus_RM.rar，DBConnector_Oracle_XA.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rar

トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。また，Reliable Messagingと連携する場合は，DBConnector_Oracle_CP_Cosminexus_RM.rarを使用します。

指定できるプロパティについては，表4-5を参照してください。

DBConnector_Oracle_CP.rarまたはDBConnector_Oracle_CP_Cosminexus_RM.rar

トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。また，Reliable Messagingと連携する場合は，DBConnector_Oracle_CP_Cosminexus_RM.rarを使用します。

DBConnector_Oracle_CP.rarで指定できるプロパティについては，表4-6を参照してください。また，DBConnector_Oracle_CP_Cosminexus_RM.rarで指定できるプロパティについては，表4-7を参照してください。

DBConnector_Oracle_XA.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rar

グローバルトランザクションを使用する場合に使用します。また，Reliable Messagingと連携する場合は，DBConnector_Oracle_XA_Cosminexus_RM.rarを使用します。

DBConnector_Oracle_XA.rarで指定できるプロパティについては，表4-6および表4-8を参照してください。また，DBConnector_Oracle_XA_Cosminexus_RM.rarで指定できるプロパティについては，表4-7および表4-8を参照してください。

なお，プロパティで設定可能な値については，Oracleのマニュアルを参照してください。

表4‒5　DBConnector_Oracle_CP.rar，DBConnector_Oracle_CP_Cosminexus_RM.rar，DBConnector_Oracle_XA.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

指定可能値

デフォルト

バージョン

CallableStatementPoolSize

「機能解説 基本・開発編(コンテナ共通機能)」−「3.14.4」

java.lang.Integer

コネクションプールに割り当てられるコネクションごとのCallableStatementのプール数を設定します。

0を指定した場合，ステートメントをプールしません。

0〜2147483647の整数で指定します。

10

07-00

CancelStatement

java.lang.Boolean

トランザクションタイムアウトや業務アプリケーション強制停止時に，Statementクラス，CallableStatementクラスおよびPreparedStatementクラスで実行中のSQLをキャンセルするかどうかを指定します。

trueを指定した場合

実行中のSQLをキャンセルします。

falseを指定した場合

実行中のSQLをキャンセルしません。

専用サーバ接続をする場合は，falseを指定してください。

指定できる文字列を次に示します。

true

false

true

07-00

ConnectionIDUpdate

java.lang.Boolean

コネクションIDをDataSource#getConnectionメソッドごとに更新するかどうかを指定します。

trueを指定した場合

DataSource#getConnectionメソッドのたびにコネクションIDを生成します。

falseを指定した場合

DataSource#getConnectionメソッドで新規の物理コネクションを確立したときにコネクションIDを生成し，そのあとは更新しません。

指定できる文字列を次に示します。

true

false

false

07-00

databaseName

java.lang.String

Oracleサーバ上の特定のデータベース名（SID）を指定します。設定された値は，Oracle JDBC Thin DriverのDataSource系インタフェースのsetDatabaseNameメソッドに渡されます。

Oracleのマニュアルを参照してください。

(空文字列)

07-00

loginTimeout

java.lang.Integer

データベースへの接続試行のタイムアウト（単位：ミリ秒）を指定します。設定された値は秒単位に切り上げて，Oracle JDBC Thin DriverのDataSource系インタフェースのsetLoginTimeoutメソッドに渡されます。

Oracleのマニュアルを参照してください。ただし，秒単位に切り上げた値をsetLoginTimeoutメソッドに渡します。

8000

07-00

logLevel

java.lang.String

DB Connectorが出力するログ・トレースのレベルを指定します。

次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

次のどれかを指定します。

0またはERROR

10またはWARNING

20またはINFORMATION

ERROR

07-00

portNumber

java.lang.Integer

Oracleのサーバが要求をリスニングするポート番号を指定します。設定された値は，Oracle JDBC Thin DriverのDataSource系インタフェースのsetPortNumberメソッドに渡されます。

Oracleのマニュアルを参照してください。

1521

07-00

PreparedStatementPoolSize

「機能解説 基本・開発編(コンテナ共通機能)」−「3.14.4」

java.lang.Integer

コネクションプールに割り当てられるコネクションごとのPreparedStatementのプール数を設定します。

0を指定した場合，ステートメントをプールしません。

0〜2147483647の整数で指定します。

10

07-00

serverName

java.lang.String

Oracleサーバのホスト名またはIPアドレスを指定します。設定された値は，Oracle JDBC Thin DriverのDataSource系インタフェースのsetServerNameメソッドに渡されます。

Oracleのマニュアルを参照してください。

(空文字列)

07-00

url

java.lang.String

Oracle JDBC Thin Driverがデータベースに接続するために必要なJDBC URLを指定します。設定された値はOracle JDBC Thin DriverのDataSource系インタフェースのsetURLメソッドに渡されます。

このプロパティに値が設定された場合，databaseName，portNumber，serverNameで指定された値は無視されます。また，ユーザがurlで指定を行う場合はJDBC URLにthinドライバを指定します。

（例）

jdbc:oracle:thin:@ServerA:1521:service1

Oracleのマニュアルを参照してください。

(空文字列)

07-00

表4‒6　DBConnector_Oracle_CP.rarまたはDBConnector_Oracle_XA.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

指定可能値

デフォルト

バージョン

appendZero

java.lang.Boolean

java.sql.ResultSetインタフェースのgetStringメソッドで，NUMBER型または，FLOAT型の列から，整数部が0である小数を取得する場合，整数部に0を補完するかどうかを指定します。

trueを指定した場合

整数部に0を補完します。

falseを指定した場合

整数部に0を補完しません。

指定できる文字列を次に示します。

true

false

false

09-50

forceFixedString

java.lang.Boolean

java.sql.PreparedStatementインタフェースのsetStringメソッドまたは，setObjectメソッドで，CHAR型（固定長文字列）の列の値を設定する際に，その値が列のサイズよりも小さい場合は，列のサイズに合わせて空白文字を埋め込むかどうかを指定します。

trueを指定した場合

固定長文字列の空白文字を埋め込みます。

falseを指定した場合

固定長文字列の空白文字を埋め込みません。

指定できる文字列を次に示します。

true

false

false

09-50

表4‒7　DBConnector_Oracle_CP_Cosminexus_RM.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

linkedResourceAdapterName

java.lang.String

連携するReliable Messagingリソースアダプタの表示名を指定します。

DBConnector_Oracle_CP_Cosminexus_RM.rarを使用する場合に指定できます。

表4‒8　DBConnector_Oracle_XA.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

sessionTimeout

java.lang.Integer

Oracleサーバでのセッションタイムアウト（トランザクションブランチがアクティブでない状態でいられる最大時間）を秒単位で指定します。J2EEサーバのトランザクションタイムアウトよりも長い時間を指定する必要があります。デフォルト値は300秒です。設定された値はOracle JDBC Thin DriverのXAResource.setTransactionTimeoutメソッドに渡されます。

(4)　PostgreSQL JDBC Driverを使用して，PostgreSQLに接続する場合

DBConnector_PostgreSQL_CP.rar

トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。

指定できるプロパティについては，次の表を参照してください。

表4‒9　DBConnector_PostgreSQL_CP.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

指定可能値

デフォルト

バージョン

databaseName

java.lang.String

オンプレミス環境，Amazon RDS，またはAmazon AuroraのPostgreSQLサーバ上の特定のデータベース名を指定します。指定した値は，PostgreSQL JDBC DriverのsetDatabaseNameメソッドに渡されます。詳細については，PostgreSQL JDBC Driverのマニュアルを参照してください。

PostgreSQLのマニュアルを参照してください。

(空文字列)

11-30

serverName

java.lang.String

オンプレミス環境の場合，PostgreSQLサーバのホスト名またはIPアドレスを指定します。Amazon RDSまたはAmazon Auroraの場合，接続先のエンドポイント（DNS名）を指定します。指定した値は，PostgreSQL JDBC DriverのsetServerNameメソッドに渡されます。詳細については，PostgreSQL JDBC Driverのマニュアルを参照してください。

PostgreSQLのマニュアルを参照してください。

(空文字列)

11-30

portNumber

java.lang.Integer

オンプレミス環境，Amazon RDS，またはAmazon AuroraのPostgreSQLのポート番号を指定します。指定した値は，PostgreSQL JDBC DriverのsetPortNumberメソッドに渡されます。詳細については，PostgreSQL JDBC Driverのマニュアルを参照してください。

PostgreSQLのマニュアルを参照してください。

5432

11-30

PreparedStatementPoolSize

java.lang.Integer

コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。

0〜2147483647の整数で指定します。

10

11-30

CallableStatementPoolSize

java.lang.Integer

コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。

0〜2147483647の整数で指定します。

10

11-30

CancelStatement

java.lang.Boolean

トランザクションタイムアウトやUAP強制停止時にステートメントのキャンセルを実行するかどうかを指定します。

trueを指定した場合

実行中のSQLを取り消します。

falseを指定した場合

実行中のSQLを取り消しません。

指定できる文字列を次に示します。

true

false

true

11-30

logLevel

java.lang.String

DB Connectorが出力するログ・トレースのレベルを指定します。

次のどれかを指定します。

0またはERROR

10またはWARNING

20またはINFORMATION

ERROR

11-30

(5)　SQL Server JDBC Driverを使用して，SQL Serverに接続する場合

DBConnector_SQLServer_CP.rar

トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。

指定できるプロパティについては，次の表を参照してください。なお，プロパティ情報にはパスワードを含むことがあるため，セキュリティポリシーに従って，ファイルのアクセス権を厳重に管理してください。

表4‒10　DBConnector_SQLServer_CP.rarを使用する場合に指定できるプロパティ

config-property-name

config-property-type

config-property-value

指定可能値

デフォルト

バージョン

applicationIntent

java.lang.String

SQL Server可用性グループまたはSQL Serverフェールオーバークラスター機能使用時に，フェールオーバー先のデータベースへの接続を，読み取り専用，または読み取り／書き込みを指定します。

設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetApplicationIntentメソッドに渡されます。詳細については，SQL Server JDBC Driverのマニュアルを参照してください。

SQL Server JDBC Driverを使用する場合に指定できます。

次のどれかを指定します。

ReadOnly

ReadWrite

ReadWrite

09-50

applicationName

java.lang.String

SQL Serverに接続するアプリケーションの名前を指定します。設定された値は，SQL Serverの管理ツールなどに表示されます。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetApplicationNameメソッドに渡されます。

SQL Serverのマニュアルを参照してください。

(空文字列)

07-50

CallableStatementPoolSize

「機能解説 基本・開発編(コンテナ共通機能)」−「3.14.4」

java.lang.Integer

コネクションプールに割り当てられるコネクションごとのCallableStatementのプール数を設定します。

0を指定した場合，ステートメントをプールしません。

0〜2147483647の整数で指定します。

10

07-00

CancelStatement

java.lang.Boolean

トランザクションタイムアウトやアプリケーションの強制停止時にステートメントのキャンセル機能を実行するかどうかを設定します。

trueを設定した場合

ステートメントのキャンセル機能が実行されます。

falseを設定した場合

ステートメントのキャンセル機能は実行されません。

指定できる文字列を次に示します。

true

false

true

07-00

databaseName

java.lang.String

接続するSQL Serverのデータベース名を指定します。値を指定しない場合には，すでに定義されたデータベースに接続されます。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetDatabaseNameメソッドに渡されます。

SQL Serverのマニュアルを参照してください。

(空文字列)

07-00

encrypt

java.lang.String

クライアントとサーバ間で送信されるすべてのデータに対してSQL ServerでTLS暗号化が使用されるかどうかを指定します。

trueを設定した場合

TLS暗号化が使用されます。

falseを設定した場合

TLS暗号化が使用されません。

設定された値は，setEncryptメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

このプロパティは，SQL Server JDBC Driverのバージョンが10.2以降の場合だけ指定できます。

指定できる文字列を次に示します。

true

false

デフォルト値は使用するJDBCドライバに依存するため，詳細については，SQL Server JDBC Driverのマニュアルを参照してください。

11-30

failoverPartner

java.lang.String

データベースミラーリング構成で使用されるフェイルオーバーサーバの名前を指定します。databaseNameプロパティと組み合わせて使用してください。

設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetFailoverPartnerメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

SQL Serverのマニュアルを参照してください。

(空文字列)

07-50

hostNameInCertificate

java.lang.String

SQL ServerのTLS/SSL証明書の検証に使われるホスト名を指定します。このプロパティが指定されていない場合，serverNameプロパティの値をホスト名として使用してSQL ServerのTLS/SSL証明書を検証します。

設定された値は，setHostNameInCertificateメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

このプロパティは，SQL Server JDBC Driverのバージョンが10.2以降の場合だけ指定できます。

入力は制限されません。

(空文字列)

11-30

instanceName

java.lang.String

接続するSQL Serverのインスタンス名を指定します。値を指定しない場合は，既定のインスタンスに接続されます。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetInstanceNameメソッドに渡されます。

SQL Serverのマニュアルを参照してください。

(空文字列)

07-50

integratedSecurity

java.lang.Boolean

SQL Serverへ接続するための認証方法を指定します。

trueを設定した場合

Windows認証を使用します。

falseを設定した場合

SQL Server認証を使用します。

設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetIntegratedSecurityメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

指定できる文字列を次に示します。

true

false

false

07-50

lastUpdateCount

java.lang.Boolean

サーバに渡されたSQL ステートメントから，最終的な更新数だけを返すかどうかを指定します。

trueを設定した場合

サーバに渡されたSQLステートメントから，最終的な更新数だけを返します。

また，SELECT，INSERT，およびDELETEステートメントのどれか一つで使用して，サーバのトリガによって追加された更新数を無視することができます。

falseを設定した場合

サーバのトリガによって返される更新数を含む，すべての更新数が返されます。

設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetLastUpdateCountメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

指定できる文字列を次に示します。

true

false

true

07-50

lockTimeout

java.lang.Integer

データベースがロックタイムアウトを通知するまでに待機する時間（単位：ミリ秒）を指定します。-1を指定するとタイムアウトは無限になります。0を指定すると待機しないことになります。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetLockTimeoutメソッドに渡されます。

SQL Serverのマニュアルを参照してください。

-1

07-50

loginTimeout

java.lang.Integer

データベースへの接続試行中に，データソースが待機する最長時間（単位：秒）を設定します。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetLoginTimeoutメソッドに渡されます。

SQL Serverのマニュアルを参照してください。

8

07-00

logLevel

java.lang.String

DB Connectorが出力するログ・トレースのレベルを指定します。

次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

次のどれかを指定します。

0またはERROR

10またはWARNING

20またはINFORMATION

ERROR

07-00

multiSubnetFailover

java.lang.Boolean

SQL Server可用性グループまたはSQL Serverフェールオーバークラスターインスタンスの可用性グループリスナーに接続する場合，trueを指定します。

設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetMultiSubnetFailoverメソッドに渡されます。詳細については，SQL Server JDBC Driverrのマニュアルを参照してください。

SQL Server JDBC Driverrを使用する場合に指定できます。

指定できる文字列を次に示します。

true

false

false

09-50

packetSize

java.lang.Integer

SQL Serverとの通信に使用されるネットワークパケットサイズ（単位：バイト）を指定します。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetPacketSizeメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

SQL Serverのマニュアルを参照してください。

4096

07-50

portNumber

java.lang.Integer

接続するSQL Serverのポート番号を指定します。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetPortNumberメソッドに渡されます。

SQL Serverのマニュアルを参照してください。

1433

07-00

PreparedStatementPoolSize

「機能解説 基本・開発編(コンテナ共通機能)」−「3.14.4」

java.lang.Integer

コネクションプールに割り当てられるコネクションごとのPreparedStatementのプール数を設定します。

0を指定した場合，ステートメントをプールしません。

0〜2147483647の整数で指定します。

10

07-00

selectMethod

java.lang.String

select文の実行時に，データベースカーソルを使用するかどうかを指定します。

小文字で設定してください。

cursor

データベースカーソルが作成されます。データベースの検索結果を分割してクライアントに返します。

direct

データベースカーソルは作成されません。データベースの検索結果を一度の要求ですべてクライアントに返します。

設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetSelectMethodメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

指定できる文字列を次に示します。

cursor

direct

cursor

07-00

sendStringParametersAsUnicode

java.lang.Boolean

SQL Serverに送信される文字列パラメタをUnicodeで送るか，データベースのデフォルトの文字エンコーディングで送るかを指定します。

trueを設定した場合

文字列パラメタはUnicodeで送られます。

falseを設定した場合

文字列パラメタはデータベースのデフォルトの文字エンコーディングで送られます。

設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetSendStringParametersAsUnicodeメソッドに渡されます。

指定できる文字列を次に示します。

true

false

true

07-00

serverName

java.lang.String

オンプレミス環境の場合，接続するSQL Serverのホスト名またはIPアドレスを指定します。Azure SQLの場合，接続先のエンドポイント（DNS名）を指定します。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetServerNameメソッドに渡されます。

SQL Serverのマニュアルを参照してください。

(空文字列)

07-00

sslProtocol

java.lang.String

SQLサーバ接続時のTLSのプロトコルを指定します。設定された値は，setSSLProtocolメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

このプロパティは，SQL Server JDBC Driverのバージョンが10.2以降の場合だけ指定できます。

指定できる文字列を次に示します。

TLS

TLSv1

TLSv1.1

TLSv1.2

TLS

11-30

trustServerCertificate

java.lang.Boolean

サーバのTLS/SSL証明書を検証するかどうかを指定します。

trueを設定した場合

TLS/SSL証明書を検証しません。

falseを設定した場合

TLS/SSL証明書を検証します。

設定された値は，setTrustServerCertificateメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

このプロパティは，SQL Server JDBC Driverのバージョンが10.2以降の場合だけ指定できます。

指定できる文字列を次に示します。

true

false

false

11-30

trustStore

java.lang.String

trustStoreファイルへのパスを指定します。

設定された値は，setTrustStoreメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

このプロパティは，SQL Server JDBC Driverのバージョンが10.2以降の場合だけ指定できます。

入力は制限されません。

(空文字列)

11-30

trustStorePassword

java.lang.String

trustStoreデータの整合性を確認するために使用するパスワードを指定します（認証機関によって署名された内容から変更されていないか，整合性をチェックします）。

設定された値は，setTrustStorePasswordメソッドに渡されます。詳細については，SQL Server JDBC Driverのドキュメントを参照してください。

このプロパティは，SQL Server JDBC Driverのバージョンが10.2以降の場合だけ指定できます。

入力は制限されません。

(空文字列)

11-30

workstationID

java.lang.String

アプリケーションサーバのホスト名を指定します。設定された値は，SQL Serverの管理ツールなどに表示されます。設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetWorkstationIDメソッドに渡されます。

SQL Serverのマニュアルを参照してください。

(空文字列)

07-50

xopenStates

java.lang.Boolean

java.sql.SQLException.getSQLStateメソッドの戻り値のSQL規格を指定します。

trueを設定した場合

getSQLStateメソッドは，X/Open規格で定義された状態コードを返します。

falseを設定した場合

getSQLStateメソッドは，SQL 99規格で定義された状態コードを返します。

設定された値は，SQL Server JDBC DriverのDataSource系インタフェースのsetXopenStatesメソッドに渡されます。

指定できる文字列を次に示します。

true

false

false

07-50

(6)　TP1インバウンドアダプタに設定する<config-property>に指定できるプロパティ

TP1インバウンドアダプタに設定する<config-property>タグに指定できるプロパティについて説明します。

表4‒11　TP1インバウンドアダプタに設定する<config-property>タグに指定できるプロパティ

config-property-name

config-property-type

config-property-value

backlog_count

java.lang.Integer

RPC要求を待ち受けるポートのListenキューの長さを，1〜4096の整数で指定します。デフォルト値は50です。

指定できるキューの長さの最大値はOSごとに異なります。詳細は各OSのlisten()について説明しているマニュアル，および各OSのTCP/IPについて説明しているドキュメントを参照してください。

connection_timeout

java.lang.Integer

RPC要求の応答を送信するときのコネクション確立処理のタイムアウト時間（秒単位）を，0〜65535の整数で指定します。デフォルト値は8です。

0を指定した場合はタイムアウトしません。

ipc_sockctl_watchtime

java.lang.Integer

一時クローズ応答の待ち時間（秒単位）を，0〜65535の整数で指定します。デフォルト値は180です。

0を指定した場合は動作しません。

ipc_tcpnodelay

java.lang.Boolean

OpenTP1とのコネクションの接続で使用するソケットにTCP_NODELAYオプションを使用するかどうかを指定します。

trueを指定した場合

TCP_NODELAYオプションを使用します。

falseを指定した場合

TCP_NODELAYオプションを使用しません。

デフォルト値はfalseです。

max_connections

java.lang.Integer

RPC要求を待ち受けるポートへの最大同時接続数を，1〜2032の整数で指定します。デフォルト値は64です。

node_id

java.lang.String

ノード識別子を4文字で指定します。

1文字目は英字（A〜Z　a〜z），2文字目以降は，英数字（A〜Z　a〜z　0〜9），またはアンダースコア「_」で指定してください。TP1インバウンドアダプタごとに一意な文字列を指定してください。デフォルトはCos_です。

receive_buffer_size

java.lang.Integer

受信時の受信バッファサイズを，8192〜10485761の整数で指定します。デフォルト値は8192です。

rpc_close_after_send

java.lang.Boolean

OpenTP1へ電文を送信したあとにコネクションを切断するかどうかを指定します。

trueを指定した場合

OpenTP1へ電文を送信したあと，コネクションを切断します。

falseを指定した場合

OpenTP1へ電文を送信したあと，コネクションを切断しません。

デフォルト値はfalseです。08-50と同様にする場合はtrueを指定してください。

rpc_max_thread_count

java.lang.Integer

最大同時RPC要求受け付けスレッド数を，1〜1024の整数で指定します。デフォルト値は10です。

rpc_receive_timeout

java.lang.Integer

RPC要求の受信のタイムアウト時間（秒単位）を，0〜65535の整数で指定します。デフォルトは180です。

0を指定した場合はタイムアウトしません。

rpc_receive_timeout_interval

java.lang.Integer

RPC要求の受信のタイムアウト監視の監視間隔を，1〜65535の整数で指定します。デフォルト値は5です。

rpc_sockctl_highwater

java.lang.Integer

RPC受信コネクションの一時クローズ処理開始のしきい値（パーセント（%）単位）を，0〜100の整数で指定します。デフォルト値は100です。

rpc_sockctl_lowwater

java.lang.Integer

RPC受信コネクションの一時クローズ処理を非対象とするコネクション数の割合（パーセント（%）単位）を，0〜100の整数で指定します。デフォルト値は0です。

scd_port

java.lang.Integer

RPC要求を待ち受けるポートのポート番号を，5001〜65535の整数で指定します。デフォルト値は23700です。

send_buffer_size

java.lang.Integer

応答時の送信バッファサイズを，8192〜10485761の整数で指定します。デフォルト値は8192です。

send_retry_count

java.lang.Integer

サーバの応答送信時にTCP/IPコネクションの接続でエラーが発生した場合のリトライ回数を，0〜65535の整数で指定します。デフォルト値は1です。

0を指定した場合は，リトライしません。

send_retry_interval

java.lang.Integer

サーバの応答送信時にTCP/IPコネクションの接続でエラーが発生した場合のリトライ間隔（ミリ秒単位）を，0〜300000の整数で指定します。デフォルト値は0です。

0を指定した場合，間隔を空けないでリトライします。

このプロパティは，send_retry_countに1〜65535を指定した場合に有効になります。

service_group

java.lang.String

TP1インバウンドアダプタのサービスグループ名を1〜31文字で指定します。

1文字目が英字（A〜Z　a〜z），2文字目以降は英数字（A〜Z　a〜z　0〜9）もしくはアンダースコア「_」で指定してください。

J2EEサーバ内で一意のサービスグループ名を指定してください。

tcp_receive_timeout

java.lang.Integer

コネクションを接続してから，またはデータを受信してから，次のデータを受信するまでのタイムアウト時間（秒単位）を，0〜65535の整数で指定します。デフォルト値は10です。

0を指定した場合はタイムアウトしません。

tcp_send_timeout

java.lang.Integer

RPC要求の応答送信時のタイムアウト時間（秒単位）を，0〜65535の整数で指定します。デフォルト値は10です。

0を指定した場合はタイムアウトしません。

tcp_send_timeout_interval

java.lang.Integer

RPC要求の応答送信時のタイムアウト監視の監視間隔を，1〜65535の整数で指定します。デフォルト値は5です。

なお，08-53以降ではこのプロパティの設定は無視されます。

trn_max_connections

java.lang.Integer

RPC送信コネクションの最大同時接続数を，1〜2032の整数で指定します。デフォルト値は64です。

trn_max_thread_count

java.lang.Integer

最大同時同期点電文送受信スレッド数を，1〜1024の整数で指定します。デフォルト値は1です。

trn_port

java.lang.Integer

同期点待ち受けポートのポート番号を，5001〜65535の整数で指定します。デフォルト値は23900です。

trn_sockctl_highwater

java.lang.Integer

RPC送信コネクションの一時クローズ処理開始のしきい値（パーセント（%）単位）を，0〜100の整数で指定します。デフォルト値は100です。

trn_sockctl_lowwater

java.lang.Integer

RPC送信コネクションの一時クローズ処理を非対象とするコネクション数の割合（パーセント（%）単位）を，0〜100の整数で指定します。デフォルト値は0です。

4.1.11　CJMSプロバイダのリソースアダプタに設定する<config-property>タグに指定できるプロパティ

CJMSプロバイダのリソースアダプタ（CJMSPリソースアダプタ）に設定する<config-property>タグに指定できる値について説明します。

なお，CJMSPリソースアダプタのプロパティの設定では，テンプレートファイルを使用できます。テンプレートファイルについては，「4.1.13　Connector属性ファイルのテンプレートファイル」を参照してください。

(1)　リソースアダプタ（<resourceadapter>）の設定

リソースアダプタに設定できるプロパティについて説明します。

表4‒12　リソースアダプタ（<resourceadapter>）に設定できるプロパティ

config-property-name

config-property-type

config-property-value

connectionURL

java.lang.String

CJMSプロバイダと接続するためのURLを指定します。

URLには，ホスト名，ポート番号およびサービス名が含まれます。

reconnectAttempts

java.lang.Integer

CJMSプロバイダとの接続でエラーが発生した場合のリトライ回数を，1〜2147483647の整数で指定します。デフォルト値は6です。

reconnectEnabled

java.lang.Boolean

CJMSプロバイダとの接続でエラーが発生した場合にリトライを実行するかどうかを，true（リトライする）またはfalse（リトライしない）で指定します。デフォルト値はfalseです。

reconnectInterval

java.lang.Integer

CJMSプロバイダとの接続でエラーが発生した場合のリトライ間隔（ミリ秒単位）を，0〜2147483647の整数で指定します。デフォルト値は30000です。

指定例を次に示します。

<resourceadapter-class>com.cosminexus.jmsprovider.messaging.jms.ra.ResourceAdapter</resourceadapter-class>
  <config-property>
      <description xml:lang="en"/>
      <config-property-name>ConnectionURL</config-property-name>
      <config-property-type>java.lang.String</config-property-type>
      <config-property-value>mq://localhost:7676/</config-property-value>
  </config-property>
    <config-property>
      <description xml:lang="en"/>
      <config-property-name>ReconnectEnabled</config-property-name>
      <config-property-type>java.lang.Boolean</config-property-type>
      <config-property-value>false</config-property-value>
    </config-property>
    <config-property>
      <description xml:lang="en"/>
      <config-property-name>ReconnectAttempts</config-property-name>
      <config-property-type>java.lang.Integer</config-property-type>
      <config-property-value>6</config-property-value>
    </config-property>
   <config-property>
      <description xml:lang="en"/>
      <config-property-name>ReconnectInterval</config-property-name>
      <config-property-type>java.lang.Integer</config-property-type>
      <config-property-value>30000</config-property-value>
   </config-property>

注意事項

リソースアダプタのプロパティの設定で，キューまたはトピックごとの管理対象オブジェクト（AdminObject）の値を編集しないでリソースアダプタを開始しようとすると，例外がスローされます。この例外は，J2EEサーバのログディレクトリ下のcjexceptionN.log（Nはログファイルの面数）に出力されます。

(2)　ManagedConnectionFactory（<managedconnectionfactory-class>の<config-property>）の設定

ManagedConnectionFactory（<managedconnectionfactory-class>の<config-property>）に設定できるプロパティについて説明します。

表4‒13　ManagedConnectionFactory（<managedconnectionfactory-class>の<config-property>）に設定できるプロパティ

config-property-name

config-property-type

config-property-value

clientId

java.lang.String

CJMSプロバイダと接続するためのクライアントのIDを指定します。

reconnectAttempts

java.lang.Integer

CJMSプロバイダとの接続でエラーが発生した場合のリトライ回数を，1〜2147483647の整数で指定します。デフォルト値は6です。

reconnectEnabled

java.lang.Boolean

CJMSプロバイダとの接続でエラーが発生した場合にリトライを実行するかどうかを，true（リトライする）またはfalse（リトライしない）で指定します。デフォルト値はfalseです。

reconnectInterval

java.lang.Integer

CJMSプロバイダとの接続でエラーが発生した場合のリトライ間隔（ミリ秒単位）を，1〜2147483647の整数で指定します。デフォルト値は30000です。

指定例を次に示します。なお，clientIdはデフォルトの状態では設定されていません。必要に応じて，背景色付きの太字の部分を追加してください。

<managedconnectionfactory-class>com.cosminexus.jmsprovider.messaging.jms.ra.ManagedConnectionFactory</managedconnectionfactory-class>
  <config-property>
     <description xml:lang="en"/>
     <config-property-name>ReconnectEnabled</config-property-name>
     <config-property-type>java.lang.Boolean</config-property-type>
     <config-property-value>false</config-property-value>
  </config-property>
  <config-property>
     <description xml:lang="en"/>
     <config-property-name>ReconnectAttempts</config-property-name>
     <config-property-type>java.lang.Integer</config-property-type>
     <config-property-value>6</config-property-value>
  </config-property>
   <config-property>
     <description xml:lang="en"/>
     <config-property-name>ReconnectInterval</config-property-name>
     <config-property-type>java.lang.Integer</config-property-type>
     <config-property-value>30000</config-property-value>
   </config-property>
  <config-property>
     <config-property-name>ClientId</config-property-name>
     <config-property-type>java.lang.String</config-property-type>
     <config-property-value>Test</config-property-value>
  </config-property>

(3)　管理対象オブジェクト（<adminobject>）の設定

管理対象オブジェクト（<adminobject>の<config-property>）に設定できるプロパティについて説明します。

表4‒14　管理対象オブジェクト（<adminobject>の<config-property>）に設定できるプロパティ

config-property-name

config-property-type

config-property-value

Description

java.lang.String

付加情報を指定するプロパティです。必要な説明を指定してください。空白も指定できます。

Name

java.lang.String

<adminobject>タグ下に指定した送信先を作成する際に使用する，送信先の名前を指定します。送信先は，このプロパティに指定した名前で作成されます。

管理対象オブジェクトの設定のタグ情報を次に示します。この例は，キューを作成する例です。トピックを作成する場合は，送信先の種類を変更してください。

<adminobject>
  <adminobject-name>TestQueue</adminobject-name>
  <adminobject-interface>javax.jms.Queue</adminobject-interface>
  <adminobject-class>com.cosminexus.jmsprovider.messaging.Queue</adminobject-class>
  <config-property>
    <description xml:lang="en"></description>
    <config-property-name>Name</config-property-name>
    <config-property-type>java.lang.String</config-property-type>
    <config-property-value>TestQueue</config-property-value>
  </config-property>
  <config-property>
    <description xml:lang="en"></description>
    <config-property-name>Description</config-property-name>
    <config-property-type>java.lang.String</config-property-type>
    <config-property-value></config-property-value>
  </config-property>
</adminobject>

(4)　ログに関する設定

ログについて設定するプロパティについて説明します。

表4‒15　ログについて設定するプロパティ

config-property-name

config-property-type

config-property-value

ExpLogFileNum

java.lang.Integer

例外ログを出力するログファイルの最大数を指定します。1〜16の整数で指定します。デフォルト値は2です。

ExpLogFileSize

java.lang.Integer

例外ログを出力するログファイルの最大サイズをバイトで指定します。8192〜4194304の整数で指定します。デフォルト値は1048576です。

指定したサイズに到達すると，新しいファイルが作成され，ログの出力先が作成したファイルに切り替わります。

MsgLogFileNum

java.lang.Integer

メッセージログを出力するログファイルの最大数を指定します。1〜16の整数で指定します。デフォルト値は2です。

MsgLogFileSize

java.lang.Integer

メッセージログを出力するログファイルの最大サイズをバイトで指定します。8192〜4194304の整数で指定します。デフォルト値は1048576です。

指定したサイズに到達すると，新しいファイルが作成され，ログの出力先が作成したファイルに切り替わります。

MsgLogLevel

java.lang.String

ログのレベルを指定します。

指定したレベルに基づいた情報がログファイルに出力されます。

次のどれかの値を指定できます。

ERROR

WARNING

INFO

デフォルトはERRORです。

注意事項

CJMSPリソースアダプタのログファイルは，<ejb.server.log.directory>ディレクトリ下のcjmsディレクトリに出力されます。cjmsディレクトリがない場合は，<ejb.server.log.directory>ディレクトリ下にcjmsディレクトリが作成され，ログが出力されます。

リソースアダプタのプロパティの検証は，J2EEサーバとCJMSPリソースアダプタの両方で実施されます。J2EEサーバによるプロパティの検証で問題があった場合，J2EEサーバのログファイルにエラーメッセージが出力され，処理が停止します。CJMSPリソースアダプタによるプロパティの検証で問題があった場合，CJMSPリソースアダプタのログファイルに警告メッセージが出力されますが，プロパティの値をデフォルト値として処理は続行されます。

4.1.12　<property>タグに指定できるプロパティ

<property>タグに指定できる値について説明します。

表4‒16　<property>タグに設定する情報一覧

property-name

property-type

property-value

指定可能値

デフォルト

バージョン

ConnectionPoolAdjustmentInterval

int

コネクション数調節機能の動作間隔を整数（単位：秒）で指定します。

0を指定した場合は動作しません。

0〜2147483647の整数で指定します。

600

06-70

ConnectionTimeout

int

コネクション解放までのタイムアウト値を整数（単位：秒）で指定します。

コネクションの最終利用時刻からタイムアウト判定までの時間が指定値を超えるとコネクションスイーパによる削除対象になります。0を指定した場合はタイムアウトしません。

3600以上の値を設定することを推奨しています。

0〜2147483647の整数で指定します。

0

06-50

LogEnabled

boolean

LogWriterによるログ出力をするかどうかを指定します。

trueを指定した場合：

LogWriterによるログ出力をします。

falseを指定した場合：

LogWriterによるログ出力をしません。

指定できる文字列を次に示します。

true

false

true

05-05

MaxPoolSize

「機能解説 基本・開発編(コンテナ共通機能)」−「3.14.1」

int

プール内のコネクションの最大数を指定します。なお，-1を指定した場合は無制限となります。

指定できる値（整数）を次に示します。

-1

0〜2147483647

10

05-05

MaxTPoolSize※

int

スレッドプールで同時に実行される最大スレッド数を整数で指定します。

ライフサイクル管理機能が有効でない場合（<resourceadapter-class>が指定されていない場合），プロパティ値は無視されます。

1〜2147483647の整数で指定します。

10

07-50

MinPoolSize

「機能解説 基本・開発編(コンテナ共通機能)」−「3.14.1」

int

プール内のコネクションの最小数を指定します。

0〜2147483647の整数で指定します。

10

05-05

MinTPoolSize※

int

スレッドプールに存在する最小スレッド数を整数で指定します。

ライフサイクル管理機能が有効でない場合（<resourceadapter-class>が指定されていない場合），プロパティ値は無視されます。

0〜1024の整数で指定します。

0

07-50

NetworkFailureTimeout

boolean

ネットワーク障害検知機能のタイムアウトを有効にするかどうかを指定します。

trueを指定した場合：

ネットワーク障害検知機能のタイムアウトを有効にします。

falseを指定した場合：

ネットワーク障害検知機能のタイムアウトを無効にします。

指定できる文字列を次に示します。

true

false

true

07-00

Password

String

パスワード。

<property-value>タグに値が設定されている場合は，セキュリティ上の理由で表示されません。変更する場合は，<property-value>タグを追加して，変更後の値を設定してください。

cjgetresprop，cjgetrarprop実行時に，<property-name>タグに「User」または「Password」が設定されている場合，タグは次のように表示されます。

値が設定されている場合：

コメントタグ<!-- The property-value has already been set. -->

値が設定されていない場合：

空タグ<>

入力は制限されません。

なし

05-05

RequestQueueEnable

boolean

コネクション枯渇時のコネクション取得待ち行列を有効にするかどうかを指定します。

trueを指定した場合：

コネクション枯渇時のコネクション取得待ち行列機能を有効にします。

falseを指定した場合：

コネクション枯渇時のコネクション取得待ち行列機能を無効にします。

指定できる文字列を次に示します。

true

false

true

06-50

RequestQueueTimeout

int

コネクション枯渇時のコネクション取得待ち行列のとどまることのできる時間の最大値を整数（単位：秒）で指定します。

0を指定した場合，待ち行列で無制限に待ち続けます。

0〜2147483647の整数で指定します。

30

06-50

RetryCount

int

コネクション取得リトライ回数を整数（単位：回）で指定します。

0〜2147483647の整数で指定します。

0

05-05

RetryInterval

int

コネクション取得リトライ間隔を整数（単位：秒）で指定します。

RetryCountが1以上の場合に有効です。

1〜2147483647の整数で指定します。

10

05-05

SweeperInterval

int

コネクションスイーパ動作時間間隔を整数（単位：秒）で指定します。

指定した間隔でコネクションスイーパが動作して，タイムアウトしたコネクションを削除します。0を指定した場合は動作しません。

3600以上の値を設定することを推奨しています。

0〜2147483647の整数で指定します。

0

06-50

TPoolKeepalive※

int

スレッドプールのスレッド解放までのタイムアウト値（秒）を整数で指定します。

ライフサイクル管理機能が有効でない場合（<resourceadapter-class>が指定されていない場合），プロパティ値は無視されます。

1〜2147483647の整数で指定します。

300

07-50

User

String

ユーザ名。

<property-value>タグに値が設定されている場合は，セキュリティ上の理由で表示されません。変更する場合は，<property-value>タグを追加して，変更後の値を設定してください。

cjgetresprop，cjgetrarprop実行時に，<property-name>タグに「User」または「Password」が設定されている場合，タグは次のように表示されます。

値が設定されている場合：

コメントタグ<!-- The property-value has already been set. -->

値が設定されていない場合：

空タグ<>

入力は制限されません。

なし

05-05

ValidationInterval

int

コネクションチェック間隔を整数（単位：秒）で指定します。

1〜2147483647の整数で指定します

3600

05-05

ValidationType

「機能解説 基本・開発編(コンテナ共通機能)」−「3.15.1」

int

コネクションチェック契機。指定可能な値は次のとおりです。

0：コネクションチェック機能オフ

1：コネクション取得時にチェック

2：一定間隔でチェック

指定できる値（整数）を次に示します。

0

1

2

1

05-05

Warmup

boolean

コネクションプールのウォーミングアップ機能を有効にするかどうかを指定します。

trueを指定した場合：

コネクションプールのウォーミングアップ機能を有効にします。

falseを指定した場合：

コネクションプールのウォーミングアップ機能を無効にします。

指定できる文字列を次に示します。

true

false

true

07-00

WatchEnabled

boolean

コネクションプール監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合：

有効にします。

falseを指定した場合：

無効にします。

指定できる文字列を次に示します。

true

false

true

06-50

WatchInterval

int

コネクションプール監視間隔を整数（単位：秒）で指定します。

1〜2147483647の整数で指定します。

30

06-50

WatchThreshold

int

コネクションプール使用状態を監視するしきい値を整数（単位：％）で指定します。

1〜100の整数で指定します。

80

06-50

WatchWriteFileEnabled

boolean

コネクションプール監視結果をファイル出力するかどうかを指定します。

trueを指定した場合：

ファイル出力します。

falseを指定した場合：

ファイル出力しません。

指定できる文字列を次に示します。

true

false

true

06-50

（凡例）−：設定なし

注※　ライフサイクル管理機能が有効でない場合（<resourceadapter-class>が指定されていない場合），プロパティ値は無視されます。

4.1.13　Connector属性ファイルのテンプレートファイル

DB Connector，TP1インバウンドアダプタ，およびCJMSプロバイダのリソースアダプタのプロパティを新規に設定する場合，Component Containerが提供しているテンプレートファイルが利用できます。

このテンプレートファイルを使用すると，DB Connectorをインポートする前に，Connector属性ファイルを編集しておくことができます。テンプレートファイルはコピーして使用してください。テンプレートファイルはxmlファイル形式です。

なお，すでにプロパティが設定されているDB Connector，TP1インバウンドアダプタ，およびCJMSプロバイダのリソースアダプタのプロパティを変更する場合は，テンプレートファイルは使用しないでください。インポートしたDB Connector，TP1インバウンドアダプタ，およびCJMSプロバイダのリソースアダプタのConnector属性を取得して，Connector属性ファイルを編集してください。

ここでは，DB Connector，TP1インバウンドアダプタ，およびCJMSプロバイダのリソースアダプタのテンプレートファイルの格納先と，テンプレートファイルについて説明します。

(1)　DB Connectorのテンプレートファイル

ファイルの格納先

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥templates¥

UNIXの場合

/opt/Cosminexus/CC/admin/templates/

テンプレートファイル

Component Containerが提供しているDB Connectorのテンプレートファイルを次に示します。

表4‒17　DB Connectorのテンプレートファイル一覧

テンプレートファイル名

説明

DBConnector_HiRDB_Type4_CP_cfg.xml

HiRDB Type4 JDBC Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。

DBConnector_HiRDB_Type4_XA_cfg.xml

HiRDB Type4 JDBC Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（グローバルトランザクション用）。

DBConnector_MySQL_CP_cfg.xml

MySQL Connector/J用DB ConnectorのConnector属性ファイルのテンプレート(ローカルトランザクション用)。

DBConnector_Oracle_CP_cfg.xml

Oracle JDBC Thin Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。

DBConnector_Oracle_XA_cfg.xml

Oracle JDBC Thin Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（グローバルトランザクション用）。

DBConnector_PostgreSQL_CP_1130_cfg.xml

PostgreSQL JDBC Driver用DB ConnectorのConnector属性ファイルのテンプレート(ローカルトランザクション用)。

DBConnector_SQLServer_CP_cfg.xml

SQL Server JDBC Driver用DB ConnectorのConnector属性のテンプレートファイル（ローカルトランザクション用）。

DBConnector_HiRDB_Type4_CP_Cosminexus_RM_cfg.xml

HiRDB Type4 JDBC Driver用DB Connector for Reliable MessagingのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。

DBConnector_HiRDB_Type4_XA_Cosminexus_RM_cfg.xml

HiRDB Type4 JDBC Driver用DB Connector for Reliable MessagingのConnector属性ファイルのテンプレートファイル（グローバルトランザクション用）。

DBConnector_Oracle_CP_Cosminexus_RM_cfg.xml

Oracle JDBC Thin Driver用DB Connector for Reliable MessagingのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。

DBConnector_Oracle_XA_Cosminexus_RM_cfg.xml

Oracle JDBC Thin Driver用DB Connector for Reliable MessagingのConnector属性のテンプレートファイル（グローバルトランザクション用）。

(2)　TP1インバウンドアダプタのテンプレートファイル

ファイルの格納先

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥templates¥

UNIXの場合

/opt/Cosminexus/CC/admin/templates/

テンプレートファイル

Component Containerが提供しているTP1インバウンドアダプタのテンプレートファイルを次に示します。

表4‒18　TP1インバウンドアダプタのテンプレートファイル一覧

テンプレートファイル名

説明

TP1InboundAdapter_cfg.xml

TP1インバウンドアダプタのConnector属性ファイルのテンプレートファイル。

(3)　CJMSプロバイダのリソースアダプタのテンプレートファイル

ファイルの格納先

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥cjmsp¥lib¥templates¥

UNIXの場合

/opt/Cosminexus/CC/cjmsp/lib/templates/

テンプレートファイル

Component Containerが提供しているCJMSプロバイダのリソースアダプタのテンプレートファイルを次に示します。

表4‒19　CJMSプロバイダのリソースアダプタのテンプレートファイル一覧

テンプレートファイル名

説明

Cosminexus_JMS_Provider_RA_cfg.xml

Cosminexus_JMS_Provider_RA用の属性ファイルのテンプレートファイル。

(4)　注意事項

テンプレートファイルで提供している属性ファイルをサーバ管理コマンド以外の方法で使用する場合，DOCTYPE宣言内のURLの指定を，使用している環境に合わせて書き直す必要があります。

例

変更前

C:/Program%20Files/Hitachi/Cosminexus

変更後

<Application Serverのインストールディレクトリ>

4.1.14　DDとの対応

Connector属性ファイルとDeployment Descriptorの対応を次に示します。

(1)　Connector1.0の場合

Connector属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-connector-property>

1回

<connector>

1回

┣

┃

<description>

0回以上

┣

┃

<description>

0または1回

┣

┃

<display-name>

0回以上

┣

┃

<display-name>

0または1回

┣

┃

<icon>

0回以上

┣

┃

<icon>

0または1回

┃

┃

┣

┃

<small-icon>

0または1回

┃

┃

┣

┃

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┣

┃

<vendor-name>

1回

┣

┃

<vendor-name>

1回

┣

┃

<spec-version>

1回

┣

┃

<spec-version>

1回

┣

┃

<eis-type>

1回

┣

┃

<eis-type>

1回

┣

┃

<version>

1回

┣

┃

<version>

1回

┣

┃

<license>

0または1回

┣

┃

<license>

0または1回

┃

┃

┣

┃

<description>

0回以上

┃

┃

┣

┃

<description>

0または1回

┃

┃

┗

<license-required>

1回

┃

┃

┗

<license-required>

1回

┣

┃

<resourceadapter>

1回

┗

<resourceadapter>

1回

┃

┃

┣

┃

<outbound-resourceadapter>

0または1回

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<connection-definition>

1回以上

┃

┃

−

−

┃

┃

┃

┃

┃

┃

┣

┃

<managedconnectionfactory-class>

1回

┣

┃

<managedconnectionfactory-class>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<config-property>

0回以上

┣

┃

<config-property>

0回以上

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<description>

0回以上

┃

┃

┣

┃

<description>

0または1回

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<config-property-name>

1回

┃

┃

┣

┃

<config-property-name>

1回

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<config-property-type>

1回

┃

┃

┣

┃

<config-property-type>

1回

┃

┃

┃

┃

┃

┃

┃

┃

┗

<config-property-value>

0または1回

┃

┃

┗

<config-property-value>

0または1回

┃

┃

┃

┃

┃

┃

┣

┃

<connectionfactory-interface>

1回

┣

┃

<connectionfactory-interface>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<connectionfactory-impl-class>

1回

┣

┃

<connectionfactory-impl-class>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<connection-interface>

1回

┣

┃

<connection-interface>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<connection-impl-class>

1回

┣

┃

<connection-impl-class>

1回

┃

┃

┃

┃

┃

┃

┗

<connector-runtime>

0または1回

┃

┃

−

−

┃

┃

┃

┃

┃

┃

(省略)

−

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<transaction-support>

1回

┣

┃

<transaction-support>

1回

┃

┃

┃

┃

┃

┃

−

−

┣

┃

<authentication-mechanism>

0回以上

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┣

┃

<description>

0または1回

┃

┃

┃

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┣

┃

┃

<authentication-mechanism-type>

1回

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┗

<credential-interface>

1回

┃

┃

┃

┃

┗

<reauthentication-support>

1回

┣

┃

<reauthentication-support>

1回

┃

┃

┗

<security-permission>

0回以上

┗

<security-permission>

0回以上

┃

┃

┣

┃

<description>

0回以上

┣

┃

<description>

0または1回

┃

┃

┗

<security-permission-spec>

1回

┗

<security-permission-spec>

1回

┗

<resourceadapter-runtime>

0または1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

(2)　Connector1.5の場合

Connector属性ファイル

Deployment Descriptor

タグ名

出現パターン

タグ名

出現パターン

<hitachi-connector-property>

1回

<connector>

1回

┣

┃

<description>

0回以上

┣

┃

<description>

0回以上

┣

┃

<display-name>

0回以上

┣

┃

<display-name>

0回以上

┣

┃

<icon>

0回以上

┣

┃

<icon>

0回以上

┃

┃

┣

┃

<small-icon>

0または1回

┃

┃

┣

┃

<small-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┃

┃

┗

<large-icon>

0または1回

┣

┃

<vendor-name>

1回

┣

┃

<vendor-name>

1回

┣

┃

<spec-version>

1回

┃

┃

(<connector>タグのversion属性)

−

┣

┃

<eis-type>

1回

┣

┃

<eis-type>

1回

┣

┃

<version>

1回

┣

┃

<resourceadapter-version>

1回

┣

┃

<license>

0または1回

┣

┃

<license>

0または1回

┃

┃

┣

┃

<description>

0回以上

┃

┃

┣

┃

<description>

0回以上

┃

┃

┗

<license-required>

1回

┃

┃

┗

<license-required>

1回

┣

┃

<resourceadapter>

1回

┗

<resourceadapter>

1回

┃

┃

┣

┃

<resourceadapter-class>

0または1回

┣

┃

<resourceadapter-class>

0または1回

┃

┃

┣

┃

<config-property>

0回以上

┣

┃

<config-property>

0回以上

┃

┃

┃

┃

┣

┃

<description>

0回以上

┃

┃

┣

┃

<description>

0回以上

┃

┃

┃

┃

┣

┃

<config-property-name>

1回

┃

┃

┣

┃

<config-property-name>

1回

┃

┃

┃

┃

┣

┃

<config-property-type>

1回

┃

┃

┣

┃

<config-property-type>

1回

┃

┃

┃

┃

┗

<config-property-value>

0または1回

┃

┃

┗

<config-property-value>

0または1回

┃

┃

┣

┃

<outbound-resourceadapter>

0または1回

┣

┃

<outbound-resourceadapter>

0または1回

┃

┃

┃

┃

┣

┃

<connection-definition>

1回以上

┃

┃

┣

┃

<connection-definition>

1回以上

┃

┃

┃

┃

┃

┃

┣

┃

<managedconnectionfactory-class>

1回

┃

┃

┃

┃

┣

┃

<managedconnectionfactory-class>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<config-property>

0回以上

┃

┃

┃

┃

┣

┃

<config-property>

0回以上

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<description>

0回以上

┃

┃

┃

┃

┃

┃

┣

┃

<description>

0回以上

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<config-property-name>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<config-property-name>

1回

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

<config-property-type>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<config-property-type>

1回

┃

┃

┃

┃

┃

┃

┃

┃

┗

<config-property-value>

0または1回

┃

┃

┃

┃

┃

┃

┗

<config-property-value>

0または1回

┃

┃

┃

┃

┃

┃

┣

┃

<connectionfactory-interface>

1回

┃

┃

┃

┃

┣

┃

<connectionfactory-interface>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<connectionfactory-impl-class>

1回

┃

┃

┃

┃

┣

┃

<connectionfactory-impl-class>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<connection-interface>

1回

┃

┃

┃

┃

┣

┃

<connection-interface>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<connection-impl-class>

1回

┃

┃

┃

┃

┗

<connection-impl-class>

1回

┃

┃

┃

┃

┃

┃

┗

<connector-runtime>

0または1回

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┃

┃

(省略)

−

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<transaction-support>

1回

┃

┃

┣

┃

<transaction-support>

1回

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┣

┃

<authentication-mechanism>

0回以上

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<description>

0回以上

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<authentication-mechanism-type>

1回

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┗

<credential-interface>

1回

┃

┃

┃

┃

┗

<reauthentication-support>

1回

┃

┃

┗

<reauthentication-support>

1回

┃

┃

┣

┃

<inbound-resourceadapter>

0または1回

┣

┃

<inbound-resourceadapter>

0または1回

┃

┃

┃

┃

┗

<messageadapter>

0または1回

┃

┃

┗

<messageadapter>

0または1回

┃

┃

┃

┃

┗

<messagelistener>

1回以上

┃

┃

┗

<messagelistener>

1回以上

┃

┃

┃

┃

┣

┃

<messagelistener-type>

1回

┃

┃

┣

┃

<messagelistener-type>

1回

┃

┃

┃

┃

┗

<activationspec>

1回

┃

┃

┗

<activationspec>

1回

┃

┃

┃

┃

┣

┃

<activationspec-class>

1回

┃

┃

┣

┃

<activationspec-class>

1回

┃

┃

┃

┃

┗

<required-config-property>

0回以上

┃

┃

┗

<required-config-property>

0回以上

┃

┃

┃

┃

┣

┃

<description>

0回以上

┃

┃

┣

┃

<description>

0回以上

┃

┃

┃

┃

┗

<config-property-name>

1回

┃

┃

┗

<config-property-name>

1回

┃

┃

┣

┃

<adminobject>

0回以上

┣

┃

<adminobject>

0回以上

┃

┃

┃

┃

┣

┃

<adminobject-name>

0または1回

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<adminobject-interface>

1回

┃

┃

┣

┃

<adminobject-interface>

1回

┃

┃

┃

┃

┣

┃

<adminobject-class>

1回

┃

┃

┣

┃

<adminobject-class>

1回

┃

┃

┃

┃

┗

<config-property>

0回以上

┃

┃

┗

<config-property>

0回以上

┃

┃

┃

┃

┣

┃

<description>

0回以上

┃

┃

┣

┃

<description>

0回以上

┃

┃

┃

┃

┣

┃

<config-property-name>

1回

┃

┃

┣

┃

<config-property-name>

1回

┃

┃

┃

┃

┣

┃

<config-property-type>

1回

┃

┃

┣

┃

<config-property-type>

1回

┃

┃

┃

┃

┣

┃

<config-property-value>

0または1回

┃

┃

┣

┃

<config-property-value>

0または1回

┃

┃

┃

┃

┗

<config-property-value>

0または1回

┃

┃

┗

<config-property-value>

0または1回

┃

┃

┗

<security-permission>

0回以上

┗

<security-permission>

0回以上

┃

┃

┣

┃

<description>

0回以上

┣

┃

<description>

0回以上

┃

┃

┗

<security-permission-spec>

1回

┗

<security-permission-spec>

1回

┗

<resourceadapter-runtime>

0または1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

4.1.15　cosminexus.xmlとの対応

Connector属性ファイルとcosminexus.xmlの対応を次に示します。

Connector属性ファイル

cosminexus.xml

タグ名

出現パターン

タグ名

出現パターン

<hitachi-connector-property>

1回

┗

<rar>

0回以上

┣

┃

<description>

0回以上

┃

┃

−

−

┣

┃

<display-name>

0回以上

┃

┃

−

−

┃

┃

−

−

┣

┃

<module-name>※1

1回

┣

┃

<resourceadapter>

0または1回

┣

┃

<resourceadapter>※2

0または1回

┃

┃

┣

┃

<outbound-resourceadapter>

0または1回

┃

┃

┣

┃

<outbound-resourceadapter>

0または1回

┃

┃

┃

┃

┗

<connection-definition>

1回以上

┃

┃

┃

┃

┗

<connection-definition>

1回以上

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<connectionfactory-interface>

1回

┃

┃

┃

┃

┗

<connector-runtime>

0または1回

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<property>

0回以上

┃

┃

┃

┃

┣

┃

<connector-property>

0回以上

┃

┃

┃

┃

┃

┃

┣

┃

<property-name>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<property-name>

1回

┃

┃

┃

┃

┃

┃

┣

┃

<property-type>

1回

┃

┃

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┃

┃

┣

┃

<property-value>

0または1回

┃

┃

┃

┃

┃

┃

┗

<property-value>※2

1回

┃

┃

┃

┃

┃

┃

┗

<property-default-value>

0または1回

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┗

<resource-external-property>

0回以上

┃

┃

┃

┃

┗

<resource-external-property>

0回以上

┃

┃

┃

┃

┣

┃

<description>

0または1回

┃

┃

┃

┃

┃

┃

−

−

┃

┃

┃

┃

┣

┃

<optional-name>

1回

┃

┃

┃

┃

┣

┃

<optional-name>

1回

┃

┃

┃

┃

┣

┃

<res-auth>

0または1回

┃

┃

┃

┃

┣

┃

<res-auth>

0または1回

┃

┃

┃

┃

┗

<res-sharing-scope>

0または1回

┃

┃

┃

┃

┗

<res-sharing-scope>

0または1回

┃

┃

┣

┃

<adminobject>

0回以上

┃

┃

┗

<adminobject>

0回以上

┃

┃

┃

┃

┗

<adminobject-name>

0または1回

┃

┃

┗

<adminobject-name>※2

1回

┃

┃

┃

┃

（省略）

−

┃

┃

−

−

┃

┃

┗

<security-permission>

0回以上

┃

┃

−

−

┃

┃

（省略）

−

┃

┃

−

−

┗

<resourceadapter-runtime>

0または1回

┃

┃

−

−

┗

<property>

0回以上

┗

<resourceadapter-property>

0回以上

┣

┃

<property-name>

1回

┣

┃

<property-name>

1回

┣

┃

<property-type>

1回

┃

┃

−

−

┣

┃

<property-value>

0または1回

┗

<property-value>※2

1回

┗

<property-default-value>

0または1回

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

−

（凡例）

−：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

（省略）：タグを省略しています。

注※1

application.xmlの<application>-<module>-<connector>に対応し，属性ファイルには存在しないcosminexus.xml独自のタグとなります。リソースアダプタを特定するためのキーとなります。

注※2

cosminexus.xmlはカスタマイズしたい要素だけを記述する形式となるため，属性ファイルと出現パターンが異なります。

4.2　JavaBeansリソース属性ファイル

JavaBeansリソース属性ファイルは，JavaBeansの属性を取得，編集する場合に使用するファイルです。

4.2.1　JavaBeansリソース属性ファイルの指定内容

JavaBeansリソース属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-javabeans-resource-property PUBLIC '-//Hitachi, Ltd.//DTD JavaBeans Resource Property 7.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-javabeans-resource-property_7_0.dtd'>

JavaBeansリソース属性ファイルは，次に示すタグを持つxmlファイルです。なお，属性ファイルのバージョンは，以前のバージョンのものでも使用できます。

タグ名

出現パターン

説明

<hitachi-javabeans-resource-property>

1回

ルートタグ。

┣

┃

┃

<description>

0または1回

JavaBeansリソースの説明を記述。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<display-name>

1回

JavaBeansリソースの表示名。

1≦文字列長≦240

変更する場合，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

また，先頭または末尾に半角スペースがある場合，エラーとならないで取り除かれて設定されます。

┣

┃

┃

┃

<res-type>

0または1回

リソースのタイプ。

JavaBeansリソースのクラス名を指定します。<class-name>と同じ名称の場合は省略できます。

┣

┃

┃

<class-name>

1回

実装クラス名。

JavaBeansリソースの実装クラス名を指定します。

┗

<runtime>

1回

−

┣

┃

┃

┃

┃

<property>

0回以上

<property>の指定が複数あり，<property-name>の設定値が同じ場合，一つにマージされます。その場合，警告メッセージ（KDJE37600-W）が出力され，後ろに定義された<property>の<property-value>の値が有効になります。

┃

┃

┃

┣

┃

┃

<property-name>

1回

プロパティ名。

JavaBeansリソースのsetメソッド名やgetメソッド名を指定します。

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<property-type>

1回

プロパティ値のJavaの型。

指定できる型を次に示します。

int

long

short

byte

double

float

boolean

char

java.lang.Integer

java.lang.Long

java.lang.Short

java.lang.Byte

java.lang.Double

java.lang.Float

java.lang.Boolean

java.lang.Character

java.lang.String

┃

┃

┃

┗

<property-value>

0または1回

プロパティの値。

┗

<resource-env-external-property>

0回以上

−

┣

┃

┃

<description>

0または1回

リソース環境の別名の説明。

┗

<optional-name>

1回

リソース環境の別名。

設定する場合，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次の名前は指定できません。

予約語である”HITACHI_EJB”（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）だけ，またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

文字列の前後に空白，改行がある場合はエラーとなりませんが，取り除かれます。文字列の途中に空白，改行がある場合はエラーとなります。

同一リソース内に<resource-external-property>の指定が複数あり，<optional-name>の指定値がほかの<optional-name>の指定値の下位階層となるような関係の場合は，警告メッセージ（KDJE37602-W）が出力されます。

（例）

別名1：AAA

別名2：AAA/BBB

1≦文字列長≦255

4.3　メール属性ファイル

メール属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-mail-property PUBLIC '-//Hitachi, Ltd.//DTD Mail Property 7.1//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-mail-property_7_1.dtd'>

メール属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名

出現パターン

説明

<hitachi-mail-property>

1回

ルートタグ。

┣

┃

┃

<description>

0または1回

設定情報についての説明。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<display-name>

1回

メール表示名。

1≦文字列長≦240

変更する場合，英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

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

ただし，次に示す名前は指定できません。

先頭または末尾にピリオド（.）を付けた名前

ピリオド（.）だけの名前

また，先頭または末尾に半角スペースがある場合，エラーとならないで取り除かれて設定されます。

┣

<from>

1回

送信者のメールアドレス。

┣

┃

<server>

1回

メールサーバのホスト名またはIPアドレス。

┗

<runtime>

0または1回

−

┗

<resource-external-property>

0回以上

<resource-external-property>の指定が複数あり，<optional-name>の設定値が同じ場合，一つにマージされます。その場合，警告メッセージ（KDJE37600-W）が出力され，後ろに定義された<resource-external-property>の<res-auth>や<res-sharing-scope>の値が有効になります。

┣

┃

┃

<description>

0または1回

リソースの別名の説明。

┣

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

┃

<optional-name>

1回

リソースの別名。

設定する場合，英数字（0〜9，A〜Z，a〜z），アンダースコア（_）

，ハイフン（-），ピリオド（.），および階層区切り文字としてスラッシュ（/）が使用できます。

ただし，次の名前は指定できません。

予約語である”HITACHI_EJB”（大文字・小文字を区別します）で始まる名前

先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

スラッシュ（/）だけ，またはピリオド（.）だけの名前

スラッシュ（/）が連続している名前

文字列の前後に空白，改行がある場合はエラーとなりませんが，取り除かれます。文字列の途中に空白，改行がある場合はエラーとなります。

同一リソース内に<resource-external-property>の指定が複数あり，<optional-name>の指定値がほかの<optional-name>の指定値の下位階層となるような関係の場合は，警告メッセージ（KDJE37602-W）が出力されます。

（例）

別名1：AAA

別名2：AAA/BBB

1≦文字列長≦255

┣

┃

┃

┃

┃

┃

┃

┃

┃

<res-auth>

0または1回

リソースを使用するための認証元を，アプリケーション上で行うか，コンテナに任せるかの指定。

指定できる文字列を次に示します。

Application

Container

デフォルトはContainerです。

┗

<res-sharing-scope>

0または1回

リソース接続を共有するかどうかの指定。

指定できる文字列を次に示します。

Shareable

Unshareable

デフォルトはShareableです。

索引

記号

<property>タグに設定する情報一覧[1]

C

Connector属性の詳細〔cosminexus.xml〕[1]

Connector属性ファイル[1]

Connector属性ファイルの指定内容[1]

Connector属性ファイルのテンプレートファイル[1]

cosminexus.xml[1]

cosminexus.xmlとの対応〔Connector属性ファイル〕[1]

cosminexus.xmlとの対応〔EJB-JAR属性ファイル〕[1]

cosminexus.xmlとの対応〔Entity Bean属性ファイル〕[1]

cosminexus.xmlとの対応〔MessageDrivenBean属性ファイル〕[1]

cosminexus.xmlとの対応〔Session Bean属性ファイル〕[1]

cosminexus.xmlとの対応〔WAR属性ファイル〕[1]

cosminexus.xmlとの対応〔アプリケーション属性ファイル〕[1]

cosminexus.xmlとの対応〔サーブレット属性ファイル〕[1]

cosminexus.xmlとの対応〔フィルタ属性ファイル〕[1]

D

DBConnector_HiRDB_Type4_CP.rar，DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar，DBConnector_HiRDB_Type4_XA.rarまたはDBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ[1]

DBConnector_HiRDB_Type4_CP.rarまたはDBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用する場合に指定できるプロパティ[1]

DBConnector_HiRDB_Type4_XA.rarまたはDBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ[1]

DBConnector_MySQL_CP.rarを使用する場合に指定できるプロパティ[1]

DBConnector_Oracle_CP.rar，DBConnector_Oracle_CP_Cosminexus_RM.rar，DBConnector_Oracle_XA.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ[1]

DBConnector_Oracle_XA.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ[1]

DBConnector_PostgreSQL_CP.rarを使用する場合に指定できるプロパティ[1]

DBConnector_SQLServer_CP.rarを使用する場合に指定できるプロパティ[1]

DDとの対応〔Connector属性ファイル〕[1]

DDとの対応〔EJB-JAR属性ファイル〕[1]

DDとの対応〔Entity Bean属性ファイル〕[1]

DDとの対応〔MessageDrivenBean属性ファイル〕[1]

DDとの対応〔Session Bean属性ファイル〕[1]

DDとの対応〔WAR属性ファイル〕[1]

DDとの対応〔アプリケーション属性ファイル〕[1]

DDとの対応〔サーブレット属性ファイル〕[1]

DDとの対応〔フィルタ属性ファイル〕[1]

E

EJB-JAR属性の詳細〔cosminexus.xml〕[1]

EJB-JAR属性ファイル[1]

EJB-JAR属性ファイルの指定内容[1]

Entity Bean属性の詳細〔cosminexus.xml〕[1]

Entity Bean属性ファイル[1]

Entity Bean属性ファイルの指定内容[1]

F

Filter属性の詳細〔cosminexus.xml〕[1]

J

J2EEアプリケーションの設定で使用する属性ファイル[1]

JavaBeansリソース属性ファイル[1]

JavaBeansリソース属性ファイルの指定内容[1]

M

MessageDrivenBean属性ファイル[1]

MessageDrivenBean属性ファイルの指定内容[1]

Message-driven Bean属性の詳細〔cosminexus.xml〕[1]

R

ResourceAdapterインスタンスに関するコンフィグレーションプロパティの定義〔Connector属性ファイル〕[1]

S

Servlet属性の詳細〔cosminexus.xml〕[1]

Session Bean属性の詳細〔cosminexus.xml〕[1]

Session Bean属性ファイル[1]

Session Bean属性ファイルの指定内容[1]

W

War属性の詳細〔cosminexus.xml〕[1]

WAR属性ファイル[1]

WAR属性ファイルの指定内容[1]

あ

アウトバウンドリソースアダプタの定義〔Connector属性ファイル〕[1]

アプリケーション属性ファイル[1]

アプリケーション属性ファイル（cosminexus.xml）[1]

アプリケーション属性ファイル（cosminexus.xml）で指定する各属性の詳細[1]

アプリケーション属性ファイル（cosminexus.xml）の指定内容[1]

アプリケーション属性ファイルの指定内容[1]

アプリケーション統合属性の詳細〔cosminexus.xml〕[1]

アプリケーション統合属性ファイル[1]

アプリケーション統合属性ファイルの指定内容[1]

い

インバウンドリソースアダプタの定義〔Connector属性ファイル〕[1]

か

管理対象オブジェクトの定義〔Connector属性ファイル〕[1]

さ

サーバ管理コマンド実行時の引数に指定するファイル[1]

サーブレット属性ファイル[1]

サーブレット属性ファイルの指定内容[1]

せ

セキュリティパーミッションの定義〔Connector属性ファイル〕[1]

そ

属性ファイル[1]

属性ファイルに対応するDTDファイルの格納先（UNIXの場合）[1]

属性ファイルに対応するDTDファイルの格納先（Windowsの場合）[1]

ふ

フィルタ属性ファイル[1]

フィルタ属性ファイルの指定内容[1]

め

メール属性ファイル[1]

り

リソースアダプタの実行時情報〔Connector属性ファイル〕[1]

リソースアダプタの設定〔Connector属性ファイル〕[1]

リソースアダプタの定義〔Connector属性ファイル〕[1]