Cosminexus アプリケーションサーバ V8

アプリケーション設定操作ガイド

操作書

3020-3-U12-40

目　　次

前書き

変更内容

はじめに

第1編　概要

1.　アプリケーション設定操作の概要

1.1　アプリケーション設定操作の目的

1.2　J2EEリソースの管理

1.2.1　管理するJ2EEリソースの種類

1.2.2　リソースアダプタのアプリケーション設定操作

1.2.3　J2EEアプリケーションに含まれるリソースアダプタのアプリケーション設定操作

1.2.4　リソースアダプタ以外のJ2EEリソースのアプリケーション設定操作

1.3　J2EEアプリケーションの管理

1.3.1　管理するJ2EEアプリケーション

1.3.2　J2EEアプリケーション管理の流れ

1.3.3　J2EEアプリケーション管理に使用するアプリケーション設定操作

1.4　アプリケーション設定操作の制約

1.4.1　アプリケーション設定操作の実行ホストについての制約

1.4.2　J2EEアプリケーションの状態による操作の制約

1.4.3　そのほかの制約

2.　アプリケーション設定操作で使用するインタフェース

2.1　インタフェースの種類

2.1.1　インタフェースの特長

2.1.2　機能の比較

2.2　サーバ管理コマンドの機能

2.3　Server Plug-inの機能

第2編　サーバ管理コマンドによる操作

3.　サーバ管理コマンドの基本操作

3.1　サーバ管理コマンドの実行の前提条件

3.2　サーバ管理コマンドの排他制御

3.2.1　サーバ管理コマンドの系統

3.2.2　サーバ管理コマンドの排他制御

3.2.3　サーバ管理コマンドの排他制御の強制解除

3.3　属性ファイルによるプロパティの設定

3.3.1　J2EEリソースのプロパティの設定手順

3.3.2　J2EEアプリケーションのプロパティの設定手順

3.4　サーバ管理コマンドで指定するプロバイダURL

3.5　このマニュアルでのサーバ管理コマンドの記載方法

4.　リソースアダプタの設定

4.1　リソースアダプタの設定の概要

4.1.1　利用できるリソースアダプタ

4.1.2　設定する項目と操作の概要

4.2　データベースと接続するための設定

4.2.1　DB Connectorのインポート

4.2.2　DB Connectorのプロパティ定義

4.2.3　DB Connectorのデプロイ

4.2.4　DB Connectorの接続テスト

4.2.5　DB Connectorの開始

4.2.6　DB Connectorの停止

4.2.7　DB Connectorのアンデプロイ

4.2.8　DB Connectorのエクスポート

4.3　データベースと接続するための設定（コネクションプールのクラスタ化の場合）

4.3.1　コネクションプールのクラスタ化の概要

4.3.2　メンバリソースアダプタ用DB Connectorの設定

4.3.3　ルートリソースアダプタ用DB Connectorの設定

4.3.4　メンバリソースアダプタ用DB Connectorの開始と停止

4.3.5　ルートリソースアダプタ用DB Connectorの開始と停止

4.3.6　コネクションプールの状態の確認

4.3.7　コネクションプールの一時停止

4.3.8　コネクションプールの再開

4.4　そのほかのリソースと接続するための設定

4.4.1　リソースアダプタのインポート

4.4.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）

4.4.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）

4.4.4　リソースアダプタのデプロイ

4.4.5　J2EEリソースアダプタの接続テスト

4.4.6　J2EEリソースアダプタの開始

4.4.7　J2EEリソースアダプタの停止

4.4.8　J2EEリソースアダプタのアンデプロイ

4.4.9　J2EEリソースアダプタのエクスポート

4.5　J2EEリソースアダプタの状態と一覧の参照

4.5.1　J2EEリソースアダプタの状態の参照

4.5.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

4.5.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

4.5.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

4.6　リソースアダプタの一覧の参照

4.6.1　リソースアダプタの一覧の参照

4.6.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

4.6.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

4.6.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

4.7　コネクションプールの状態の確認

4.7.1　コネクションプールの状態表示

4.7.2　コネクションプールの削除

4.8　JNDI名前空間に登録されるリソースアダプタ名の参照と変更

4.9　リソースアダプタの削除

4.10　リソースアダプタのコピー

5.　J2EEアプリケーションに含まれるリソースアダプタの設定

5.1　J2EEアプリケーションに含まれるリソースアダプタの設定の概要

5.1.1　利用できるリソースアダプタ

5.1.2　設定する項目と操作の概要

5.2　J2EEアプリケーションへのリソースアダプタの追加

5.3　リソースアダプタを含むJ2EEアプリケーションのインポート

5.4　リソースアダプタのプロパティ定義

5.5　リソースアダプタの接続テスト

5.6　リソースアダプタを含むJ2EEアプリケーションの開始と停止

5.7　J2EEアプリケーションに含まれるリソースアダプタの一覧の参照

5.7.1　リソースアダプタの一覧の参照

5.7.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

5.7.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

5.7.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

5.8　コネクションプールの一覧表示と削除

5.8.1　コネクションプールの状態表示

5.8.2　コネクションプールの削除

6.　リソースアダプタ以外のJ2EEリソースの設定

6.1　リソースアダプタ以外のJ2EEリソースの設定概要

6.1.1　JavaBeansリソースの設定の概要

6.1.2　メールコンフィグレーションの設定の概要

6.1.3　J2EEリソース共通の設定の概要

6.2　JavaBeansリソースの設定

6.2.1　JavaBeansリソースのインポート

6.2.2　JavaBeansリソースのプロパティ定義

6.2.3　JavaBeansリソースの開始

6.2.4　JavaBeansリソースの停止

6.2.5　JavaBeansリソースの削除

6.2.6　JavaBeansリソースの状態表示

6.3　メールコンフィグレーションの設定

6.3.1　メールコンフィグレーションの新規作成

6.3.2　メールコンフィグレーションのプロパティ定義

6.3.3　メールコンフィグレーションの接続テスト

6.3.4　メールコンフィグレーションの削除

6.3.5　メールコンフィグレーションのコピー

6.4　J2EEリソース一覧の参照

6.5　JNDI名前空間に登録されるJ2EEリソース名の参照と変更

7.　J2EEアプリケーションの作成

7.1　J2EEアプリケーションの作成の概要

7.2　Enterprise Bean（EJB-JAR）のインポート

7.3　サーブレットとJSP（WAR）のインポート

7.4　リソースアダプタ（RAR）のインポート

7.5　J2EEアプリケーションの新規作成

7.6　J2EEアプリケーションへのライブラリJARファイルの追加

7.7　ライブラリJARファイルの一覧の参照

7.8　J2EEアプリケーションからのライブラリJARファイルの削除

7.9　J2EEアプリケーションへの参照ライブラリの設定

8.　J2EEアプリケーションのインポートとエクスポート

8.1　J2EEアプリケーションのインポート

8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート

8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート

8.2　J2EEアプリケーションのエクスポート

9.　J2EEアプリケーションのプロパティ設定

9.1　J2EEアプリケーションのプロパティ設定の概要

9.2　アプリケーション統合属性ファイルによるプロパティ設定

9.3　Enterprise Beanのリファレンス定義

9.3.1　ほかのEnterprise Beanのリファレンス定義

9.3.2　メールコンフィグレーションのリファレンス定義

9.3.3　リソースアダプタのリファレンス定義

9.3.4　リソース環境のリファレンス定義

9.4　Message-driven Beanのメッセージ参照定義

9.5　トランザクション属性の定義

9.6　Entity BeanのCMP定義

9.6.1　CMPの設定

9.6.2　CMP1.xとデータベースのマッピング

9.6.3　CMP2.xとデータベースのマッピング

9.7　サーブレットとJSPのリファレンス定義

9.7.1　Enterprise Beanのリファレンス定義

9.7.2　メールコンフィグレーションのリファレンス定義

9.7.3　リソースアダプタのリファレンス定義

9.7.4　リソース環境のリファレンス定義

9.8　サーブレットとJSPのマッピング定義

9.9　フィルタの設定

9.9.1　フィルタの追加

9.9.2　フィルタのマッピング定義

9.9.3　フィルタの削除

9.10　Enterprise Beanの実行時属性の定義

9.10.1　Stateful Session Beanの実行時プロパティの設定

9.10.2　Stateless Session Beanの実行時プロパティの設定

9.10.3　Entity Beanの実行時プロパティの設定

9.10.4　Message-driven Beanの実行時プロパティの設定

9.11　サーブレットとJSPの実行時属性の定義

9.11.1　J2EEアプリケーションのコンテキストルート定義

9.11.2　Webアプリケーション単位での同時実行スレッド数制御の定義

9.11.3　URLグループ単位での同時実行スレッド数制御の定義

9.11.4　URLグループ単位の実行待ちリクエスト数の監視の定義

9.12　デフォルトの文字エンコーディングの設定

9.13　JNDI名前空間に登録される名称の参照と変更

9.13.1　J2EEアプリケーション名の参照

9.13.2　Enterprise Bean名の参照と変更

9.14　CTMのスケジューリング

9.14.1　J2EEアプリケーション単位のスケジューリング

9.14.2　Stateless Session Bean単位のスケジューリング

9.15　起動順序の設定

9.15.1　J2EEアプリケーションの起動順序の設定

9.15.2　Enterprise Beanの起動順序の設定

9.15.3　サーブレットとJSPの起動順序の設定

9.16　サーブレットとJSPのエラー通知の設定

9.17　セキュリティロールの設定

9.17.1　ユーザの設定

9.17.2　ロールの設定

9.18　セキュリティロールのリファレンス定義

9.18.1　Enterprise Beanのセキュリティロールリファレンスの定義

9.18.2　サーブレットとJSPのセキュリティロールリファレンスの定義

9.19　セキュリティの定義（メソッドパーミッション）

9.20　セキュリティの定義（セキュリティアイデンティティ）

9.20.1　Enterprise Beanのセキュリティアイデンティティ

9.20.2　サーブレットとJSPのセキュリティアイデンティティ

9.21　インターセプタの設定

9.22　そのほかのプロパティの設定

10.　J2EEアプリケーションの実行

10.1　J2EEアプリケーションの実行の概要

10.2　J2EEアプリケーションの開始と停止

10.2.1　J2EEアプリケーションの開始

10.2.2　J2EEアプリケーションの停止

10.3　J2EEアプリケーションの一覧の参照

10.4　J2EEアプリケーションの削除

10.5　テストモードによるJ2EEアプリケーションの実行

10.6　J2EEアプリケーションの入れ替え

10.6.1　アーカイブ形式のアプリケーション

10.6.2　展開ディレクトリ形式のアプリケーション

10.7　J2EEアプリケーション名の変更

10.8　RMI-IIOPスタブとインタフェースの取得

10.9　トランザクション一覧の参照

第3編　Server Plug-inによる操作

11.　Server Plug-inの基本操作

11.1　Server Plug-inパースペクティブ

11.1.1　Server Plug-inの環境設定

11.1.2　Management Serverリモート管理機能への接続

11.1.3　サーバー・エクスプローラーの構成

11.1.4　サーバー・エクスプローラーの操作

11.1.5　コンソールおよび操作実行時のダイアログ表示

11.2　表示の更新

11.3　プロパティの設定

11.3.1　プロパティの設定操作

11.3.2　属性ファイル編集エディタ

11.3.3　リソース参照の自動解決

11.4　Server Plug-inの注意事項

12.　論理サーバの運用管理

12.1　論理サーバの運用管理の概要

12.2　論理サーバの起動

12.2.1　開始オプションの設定

12.2.2　論理サーバの通常起動

12.2.3　アプリケーションを起動しないでJ2EEサーバを起動

12.3　論理サーバの停止

12.3.1　論理サーバの通常停止

12.3.2　論理J2EEサーバの強制停止

12.4　論理サーバの稼働状況表示

13.　Server Plug-inによるJ2EEリソースの設定の概要

13.1　J2EEリソース設定機能

13.2　ビューツールバーでのJ2EEリソース設定操作

13.3　J2EEリソースアダプタの状態表示

14.　リソースアダプタの設定

14.1　リソースアダプタの設定の概要

14.2　リソースアダプタのインポート

14.2.1　Server Plug-in環境にあるリソースアダプタのインポート

14.2.2　J2EEサーバ環境にあるリソースアダプタのインポート

14.3　リソースアダプタのプロパティ定義

14.3.1　属性ファイル編集エディタの起動

14.3.2　プロパティ設定手順（Connector 1.0の場合）

14.3.3　プロパティ設定手順（Connector 1.5の場合）

14.3.4　対応するサーバ管理コマンド

14.4　リソースアダプタのデプロイ

14.5　J2EEリソースアダプタの接続テスト

14.6　J2EEリソースアダプタの開始と停止

14.6.1　J2EEリソースアダプタの開始

14.6.2　J2EEリソースアダプタの停止

14.7　リソースアダプタの削除

14.8　J2EEリソースアダプタのエクスポート

14.9　Connector属性のインポートとエクスポート

14.9.1　Connector属性のインポート

14.9.2　Connector属性のエクスポート

15.　J2EEアプリケーションに含まれるリソースアダプタの設定

15.1　J2EEアプリケーションに含まれるリソースアダプタの設定の概要

15.2　リソースアダプタを含むJ2EEアプリケーションのインポート

15.3　リソースアダプタのプロパティ定義

15.3.1　属性ファイル編集エディタの起動

15.3.2　プロパティ設定手順

15.4　リソースアダプタの接続テスト

15.5　リソースアダプタを含むJ2EEアプリケーションの開始と停止

15.6　Connector属性のインポートとエクスポート

15.6.1　Connector属性のインポート

15.6.2　Connector属性のエクスポート

16.　Server Plug-inによるJ2EEアプリケーションの設定の概要

16.1　J2EEアプリケーション設定の機能一覧

16.2　ビューツールバーでのJ2EEアプリケーション設定操作

16.3　J2EEアプリケーションの状態表示

17.　J2EEアプリケーションのインポートとエクスポート

17.1　J2EEアプリケーションのインポート

17.1.1　アーカイブ形式のJ2EEアプリケーションのインポート

17.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート

17.2　J2EEアプリケーションのエクスポート

18.　J2EEアプリケーションのプロパティ設定

18.1　J2EEアプリケーションのプロパティ設定の概要

18.2　Enterprise Beanのリファレンス定義

18.2.1　ほかのEnterprise Beanのリファレンス定義

18.2.2　リソースアダプタのリファレンス定義

18.2.3　リソース環境のリファレンス定義

18.3　Message-driven Beanのメッセージ参照定義

18.4　トランザクション属性の定義

18.5　サーブレットとJSPのリファレンス定義

18.5.1　Enterprise Beanリファレンス定義

18.5.2　リソースアダプタリファレンス定義

18.5.3　リソース環境リファレンス定義

18.6　サーブレットとJSPのマッピング定義

18.7　フィルタの設定

18.7.1　フィルタの追加と削除

18.7.2　フィルタのマッピング

18.8　Enterprise Beanの実行時属性の定義

18.8.1　Stateful Session Beanの実行時プロパティの設定

18.8.2　Stateless Session Beanの実行時プロパティの設定

18.8.3　Entity Beanの実行時プロパティの設定

18.8.4　Message-driven Beanの実行時プロパティの設定

18.9　サーブレットとJSPの実行時属性の定義

18.9.1　J2EEアプリケーションのコンテキストルート定義

18.9.2　Webアプリケーション単位での同時実行スレッド数制御の定義

18.9.3　URLグループ単位での同時実行スレッド数制御の定義

18.9.4　URLグループ単位の実行待ちリクエスト数の監視の定義

18.10　デフォルトの文字エンコーディングの設定

18.11　CTMのスケジューリング

18.11.1　J2EEアプリケーション単位のスケジューリング

18.11.2　Stateless Session Bean単位のスケジューリング

18.12　起動順序の設定

18.12.1　J2EEアプリケーションの起動順序の設定

18.12.2　Enterprise Beanの起動順序の設定

18.12.3　サーブレットとJSPの起動順序の設定

18.13　サーブレットとJSPのエラー通知の設定

18.14　そのほかのプロパティの設定

19.　J2EEアプリケーションの実行

19.1　J2EEアプリケーションの実行の概要

19.2　J2EEアプリケーションの開始

19.3　J2EEアプリケーションの停止

19.3.1　J2EEアプリケーションの通常停止

19.3.2　J2EEアプリケーションの強制停止

19.4　J2EEアプリケーションの削除

19.5　J2EEアプリケーションの入れ替え

19.5.1　アーカイブ形式のJ2EEアプリケーション

19.5.2　展開ディレクトリ形式のJ2EEアプリケーション

19.6　J2EEアプリケーション名の変更

19.7　RMI-IIOPスタブとインタフェースの取得

19.7.1　RMI-IIOPインタフェースページの表示

19.7.2　RMI-IIOPインタフェースのエクスポートの実行

20.　アプリケーション統合属性のインポートとエクスポート

20.1　アプリケーション統合属性のインポートとエクスポートの概要

20.2　アプリケーション統合属性のインポート

20.3　アプリケーション統合属性のエクスポート

21.　Server Plug-inで使用する画面

21.1　Server Plug-inの操作で使用する画面

21.1.1　サーバー・エクスプローラーの基本操作

21.1.2　Management Serverリモート管理機能へのログイン

21.1.3　Management Serverリモート管理機能からのログアウト

21.1.4　開始

21.1.5　アプリケーションを起動しない場合のJ2EEサーバの開始

21.1.6　論理J2EEサーバの開始オプションの設定

21.1.7　停止

21.1.8　強制停止

21.1.9　削除

21.1.10　リロード

21.1.11　J2EEアプリケーションの入れ替え

21.1.12　J2EEアプリケーション名の変更

21.1.13　表示の更新

21.1.14　プロパティの設定

21.1.15　アプリケーション統合属性のインポート

21.1.16　Connector属性のインポート

21.1.17　展開ディレクトリ形式のJ2EEアプリケーションのインポート

21.1.18　アーカイブ形式J2EEアプリケーションのインポート

21.1.19　リソースアダプタ（Connector）のインポート

21.1.20　リソースアダプタのインポート

21.1.21　アプリケーション統合属性のエクスポート

21.1.22　Connector属性のエクスポート

21.1.23　Cosminexusアプリケーションのエクスポート

21.1.24　Cosminexus RMI-IIOPインタフェースのエクスポート

21.1.25　Cosminexusリソースアダプタのエクスポート

21.1.26　J2EEアプリケーションのエクスポート

21.1.27　J2EEリソースアダプタのエクスポート

21.1.28　接続テスト

21.1.29　リソースアダプタのデプロイ

21.2　リソースアダプタの属性編集画面

21.2.1　Connector属性のツリー

21.2.2　Connector属性設定ページ

21.3　J2EEアプリケーションの属性編集画面

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

21.4.1　アプリケーション属性のツリー

21.4.2　アプリケーション属性設定ページ

21.5　アプリケーション統合属性ファイル（EJB-JAR属性）

21.5.1　EJB-JAR属性のツリー

21.5.2　EJB-JAR属性設定ページ

21.6　アプリケーション統合属性ファイル（Session Bean属性）

21.6.1　Session Bean属性のツリー

21.6.2　Session Bean属性設定ページ

21.7　アプリケーション統合属性ファイル（Entity Bean属性）

21.7.1　Entity Bean属性のツリー

21.7.2　Entity Bean属性設定ページ

21.8　アプリケーション統合属性ファイル（Message-driven Bean属性）

21.8.1　Message-driven Bean属性のツリー

21.8.2　Message-driven Bean属性設定ページ

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

21.9.1　WAR属性のツリー

21.9.2　WAR属性設定ページ

21.10　アプリケーション統合属性ファイル（フィルタ属性）

21.10.1　フィルタ属性のツリー

21.10.2　フィルタ属性設定ページ

21.11　アプリケーション統合属性ファイル（サーブレット属性）

21.11.1　サーブレット属性のツリー

21.11.2　サーブレット属性設定ページ

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

付録

付録A　ベーシックモードの利用（互換用機能）

付録A.1　ベーシックモードの概要

付録A.2　データベースと接続するための設定（データソースを使用する場合）

付録A.3　コネクションプーリングとコネクションスイーパの動作

付録A.4　データソースへのリファレンス定義

付録B　このマニュアルの参考情報

付録B.1　関連マニュアル

付録B.2　このマニュアルでの表記

付録B.3　英略語

付録B.4　KB（キロバイト）などの単位表記について

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.

前書き

■ 対象製品

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64）※¹，Windows Server 2003 R2（x64）※¹，Windows Server 2008 x86，Windows Server 2008 x64※¹，Windows Server 2008 R2※¹

P-2443-7B84　 uCosminexus Application Server Standard-R　 08-70
P-2443-7D84　 uCosminexus Application Server Standard　 08-70
P-2443-7K84　 uCosminexus Application Server Enterprise　 08-70
P-2443-7M84　 uCosminexus Web Redirector　 08-70
P-2443-7S84　 uCosminexus Service Platform　 08-70※2

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Vista，Windows XP，Windows 7（32bit），Windows 7（x64）※¹

P-2443-7E84　 uCosminexus Developer Standard　 08-70
P-2443-7F84　 uCosminexus Developer Professional　 08-70
P-2443-7T84　 uCosminexus Service Architect　 08-70※2

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64）※¹，Windows Server 2003 R2（x64）※¹，Windows Server 2008 x86，Windows Server 2008 x64※¹，Windows Server 2008 R2※¹，Windows Vista，Windows XP，Windows 7（32bit），Windows 7（x64）※¹

P-2443-7H84　 uCosminexus Client　 08-70

●適用OS：Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Server 2008 x64，Windows Server 2008 R2

P-2943-7B84　 uCosminexus Application Server Standard-R　 08-70
P-2943-7D84　 uCosminexus Application Server Standard　 08-70
P-2943-7K84　 uCosminexus Application Server Enterprise　 08-70
P-2943-7S84　 uCosminexus Service Platform　 08-70※2

●適用OS：AIX 5L V5.3，AIX V6.1，AIX V7.1

P-1M43-7D81　 uCosminexus Application Server Standard　 08-70※2
P-1M43-7K81　 uCosminexus Application Server Enterprise　 08-70※2
P-1M43-7S81　 uCosminexus Service Platform　 08-70※2

●適用OS：HP-UX 11i V2（IPF），HP-UX 11i V3（IPF）

P-1J43-7D81　 uCosminexus Application Server Standard　 08-70
P-1J43-7K81　 uCosminexus Application Server Enterprise　 08-70
P-1J43-7S81　 uCosminexus Service Platform　 08-70※2

●適用OS：Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），Red Hat Enterprise Linux 5（AMD/Intel 64），Red Hat Enterprise Linux Server 6（32-bit x86），Red Hat Enterprise Linux Server 6（64-bit x86_64）

P-9S43-7B81　 uCosminexus Application Server Standard-R　 08-70※2
P-9S43-7D81　 uCosminexus Application Server Standard　 08-70※2
P-9S43-7K81　 uCosminexus Application Server Enterprise　 08-70※2
P-9S43-7M81　 uCosminexus Web Redirector　 08-70※2
P-9S43-7S81　 uCosminexus Service Platform　 08-70※2

※印の製品については，サポート時期をご確認ください。
これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。
本製品では日立トレース共通ライブラリをインストールします。

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
GIFは，米国CompuServe Inc.のサービス名称です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
J2EEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDBCは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JSPは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JSTLは，The Jakarta Projectのタグライブラリ名称です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model　Driven　Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle8iは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle9iは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 11gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
SQL Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Sunは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Sun Microsystemsは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

■ マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

製品名 | 表記
Microsoft(R) SQL Server 2000 | SQL Server 2000 | SQL Server
Microsoft(R) SQL Server 2005 | SQL Server 2005
Microsoft(R) SQL Server 2008 | SQL Server 2008
Microsoft(R) SQL Server 2000 Driver for JDBC | SQL Server 2000 Driver for JDBC | SQL ServerのJDBCドライバ
Microsoft(R) SQL Server 2005 JDBC Driver | SQL Server 2005 JDBC Driver
Microsoft(R) SQL Server JDBC Driver 2.0 | SQL Server JDBC Driver
Microsoft(R) SQL Server JDBC Driver 3.0
Microsoft(R) Windows(R) 7 Enterprise（32bit） | Windows 7（32bit） | Windows 7 | Windows
Microsoft(R) Windows(R) 7 Professional（32bit）
Microsoft(R) Windows(R) 7 Ultimate（32bit）
Microsoft(R) Windows(R) 7 Enterprise（x64） | Windows 7（x64）
Microsoft(R) Windows(R) 7 Professional（x64）
Microsoft(R) Windows(R) 7 Ultimate（x64）
Microsoft(R) Windows Server(R) 2003，Enterprise Edition 日本語版 | Windows Server 2003 Enterprise Edition | Windows Server 2003
Microsoft(R) Windows Server(R) 2003，Standard Edition 日本語版 | Windows Server 2003 Standard Edition
Microsoft(R) Windows Server(R) 2003 R2，Enterprise Edition 日本語版 | Windows Server 2003 R2 Enterprise Edition | Windows Server 2003 R2
Microsoft(R) Windows Server(R) 2003 R2，Standard Edition 日本語版 | Windows Server 2003 R2 Standard Edition
Microsoft(R) Windows Server(R) 2003，Enterprise x64 Edition 日本語版 | Windows Server 2003 Enterprise x64 Edition | Windows Server 2003（x64）
Microsoft(R) Windows Server(R) 2003，Standard x64 Edition 日本語版 | Windows Server 2003 Standard x64 Edition
Microsoft(R) Windows Server(R) 2003 R2，Enterprise x64 Edition 日本語版 | Windows Server 2003 R2 Enterprise x64 Edition | Windows Server 2003 R2（x64）
Microsoft(R) Windows Server(R) 2003 R2，Standard x64 Edition 日本語版 | Windows Server 2003 R2 Standard x64 Edition
Microsoft(R) Windows Server(R) 2008 Enterprise 32-bit 日本語版 | Windows Server 2008 x86
Microsoft(R) Windows Server(R) 2008 Standard 32-bit 日本語版
Microsoft(R) Windows Server(R) 2008 Enterprise 日本語版 | Windows Server 2008 x64
Microsoft(R) Windows Server(R) 2008 Standard 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Enterprise 日本語版 | Windows Server 2008 R2
Microsoft(R) Windows Server(R) 2008 R2 Standard 日本語版
Microsoft(R) Windows Vista(R) Business | Windows Vista Business | Windows Vista
Microsoft(R) Windows Vista(R) Enterprise | Windows Vista Enterprise
Microsoft(R) Windows Vista(R) Ultimate | Windows Vista Ultimate
Microsoft(R) Windows(R) XP Professional Operating System | Windows XP

■ 発行

2011年 7月 3020-3-U12-40

■ 著作権

All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.

変更内容

変更内容（3020-3-U12-40）uCosminexus Application Server Enterprise 08-70，uCosminexus Application Server Standard 08-70，uCosminexus Application Server Standard-R 08-70，uCosminexus Client 08-70，uCosminexus Developer Professional 08-70，uCosminexus Developer Standard 08-70，uCosminexus Service Architect 08-70，uCosminexus Service Platform 08-70，uCosminexus Web Redirector 08-70

追加・変更内容
変更個所

インターセプタの設定に関する説明を変更・追加した。
9.1(2)，9.21

SPIの注意事項を追加した。
11.4

次の属性設定ページの別名に指定できる文字にハイフン（-）を追加した。

Connector属性設定

Session Bean属性設定

Entity Bean属性設定

21.2.2(12)，21.6.2(21)，21.7.2(2)

次の製品の適用OSにAIX，HP-UX（IPF）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

－

次の製品の適用OSにRed Hat Enterprise Linux Server 6（32-bit x86），Red Hat Enterprise Linux Server 6（64-bit x86_64）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Application Server Standard-R

uCosminexus Service Platform

uCosminexus Web Redirector

－

uCosminexus Application Server Enterprise 08-53，uCosminexus Application Server Standard 08-53，uCosminexus Application Server Standard-R 08-53，uCosminexus Client 08-53，uCosminexus Developer Professional 08-53，uCosminexus Developer Standard 08-53，uCosminexus Service Architect 08-53，uCosminexus Service Platform 08-53，uCosminexus Web Redirector 08-53

追加・変更内容
変更個所

SQL Server 2008に対応した。これに伴い，使用できるJDBCドライバにSQL Server JDBC Driver 2.0，およびSQL Server JDBC Driver 3.0を追加した。
4.2，4.2.1，4.2.2(4)

HiRDB Version 9に対応した。
－

対象製品としてuCosminexus Application Server Standard-Rを追加した。
－

次の製品の適用OSからAIX，HP-UX，Linux（IPF）を削除した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Service Platform

－

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

変更内容（3020-3-U12-20）uCosminexus Application Server Enterprise 08-50，uCosminexus Application Server Standard 08-50，uCosminexus Client 08-50，uCosminexus Developer Professional 08-50，uCosminexus Developer Standard 08-50，uCosminexus Service Architect 08-50，uCosminexus Service Platform 08-50，uCosminexus Web Redirector 08-50

追加・変更内容

Connector 1.5対応のリソースアダプタを提供したため，アプリケーションサーバで提供しているリソースアダプタの仕様についての説明を変更した。

Management Serverリモート管理機能へのログインで，管理ユーザアカウントの入力を省略できるように変更した。

次の製品の適用OSにWindows 7を追加した。

uCosminexus Developer Standard

uCosminexus Developer Professional

uCosminexus Service Architect

uCosminexus Client

次の製品の適用OSにWindows Server 2008 R2を追加した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

uCosminexus Service Platform

uCosminexus Client

次の製品の適用OSからSolarisを削除した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

はじめに

このマニュアルはサーバ管理コマンドまたはServer Plug-inを使用してCosminexus（コズミネクサス）のアプリケーションサーバを構築する際に必要な，サーバ管理コマンドの操作方法およびServer Plug-inの画面の詳細について説明したものです。

アプリケーションサーバでは，次に示すプログラムプロダクトを使用してシステムを構築，運用します。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Application Server Standard-R

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Service Architect

uCosminexus Service Platform

uCosminexus Web Redirector

このマニュアルでは，これらのプログラムプロダクトの構成ソフトウェアのうち，次に示す構成ソフトウェアについて説明しています。

Cosminexus Component Container

Cosminexus Component Container - Client

Cosminexus Component Container - Redirector

Cosminexus Component Transaction Monitor

Cosminexus Developer's Kit for Java

Cosminexus Performance Tracer

Cosminexus Server Plug-in

Cosminexus TPBroker

なお，オペレーティングシステム（OS）の種類によって，機能が異なる場合があります。

対象読者

このマニュアルは，アプリケーションサーバのシステムを構築する方を対象にしています。

次の内容を理解されていることを前提としています。

Windowsまたはご使用のUNIXのシステム構築に関する知識

Java EEに関する知識

SQLおよびリレーショナルデータベースに関する基本的な知識

CORBAに関する基本的な知識

Eclipseに関する基本的な知識

ご利用製品ごとの用語の読み替えについて

ご利用の製品によっては，マニュアルで使用している用語を，ご利用の製品名に読み替える必要があります。

次の表に従って，マニュアルで使用している用語をご利用の製品名に読み替えてください。

ご利用の製品名 | マニュアルで使用している用語
uCosminexus Application Server Standard-R | Application Server
uCosminexus Developer Professional※1 | Application ServerおよびApplication Server Enterprise
uCosminexus Developer Standard※1，※2 | Application Server
uCosminexus Service Architect※1 | Application ServerおよびApplication Server Enterprise
uCosminexus Service Platform

注※1　テスト環境で使用している場合にだけ読み替えが必要です。

注※2　uCosminexus Developer StandardとApplication Serverには一部機能差があります。機能差については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション開発ガイド」の「付録D　Developer Standard使用時の注意事項」を参照してください。

図中で使用している記号

このマニュアルの図中で使用している記号について次に示します。

文法で使用している記号

このマニュアルの文法で使用している記号について次に示します。

記号
意　味

　｜
横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
（例）　A｜B
　AまたはBを指定することを示します。

{ 　 }
この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。
（例）　｛A｜B｜C｝
　A，BまたはCのどれかを指定することを示します。

［　］
この記号で囲まれている項目は省略してもよいことを示します。複数の項目が横に並べて記述されている場合には，すべてを省略するか，記号｛ ｝と同じくどれか一つを選択します。
（例１）　［A］
　「何も指定しない」か「Aを指定する」ことを示します。
（例２）　［B｜C］
　「何も指定しない」か「BまたはCを指定する」ことを示します。

< >
この記号で囲まれている項目は，属性ファイルの該当する要素（タグ）を示します。
（例）　<abc-xyz>
　abc-xyzタグを示します。

< > - < >
タグの階層を示します。-の前に上位のタグを示します。

＜　　＞
この記号で囲まれている項目は，ユーザの環境によって異なることを示します。
（例）　＜プロパティ名＞
　プロパティを示す名称を示します。

CUIおよびGUIの説明で使用している記号

このマニュアルのCUIおよびGUIの説明で使用している記号について次に示します。

記号 | 意味
［　　］ | 画面の名称および画面に表示されている項目を示します。
［　　］ - ［　　］ | -の前に示したメニューから，-の後ろのメニューを選択することを示します。
＜　　＞ | ＜＞内の名称がユーザの環境によって異なることを示します。
「　　」 | 入力値，可変値，またはメッセージなどを示します。

1.　アプリケーション設定操作の概要

この章では，アプリケーション設定操作の目的と位置づけについて説明します。また，アプリケーション設定操作でできることについても説明します。

＜この章の構成＞

1.1　アプリケーション設定操作の目的

1.2　J2EEリソースの管理

1.3　J2EEアプリケーションの管理

1.4　アプリケーション設定操作の制約

1.1　アプリケーション設定操作の目的

アプリケーション設定操作とは，アプリケーションやリソースをJ2EEサーバ上で動作させるために必要な設定およびカスタマイズ操作のことです。次のような場合に実行します。

Cosminexusシステムの動作環境の構築，運用で，リソースやJ2EEアプリケーションを設定する場合

J2EEアプリケーションの開発で，リソースやJ2EEアプリケーションを設定する場合

J2EEサーバの構成およびアプリケーション設定操作で管理するアーキテクチャの範囲を次の図に示します。

図1-1　アプリケーション設定操作で管理するアーキテクチャの範囲

次のインタフェースを使用して，アプリケーション設定操作を実行できます。

サーバ管理コマンド（CUI）

Server Plug-in（GUI）

サーバ管理コマンドについては，「2.2　サーバ管理コマンドの機能」および「第2編　サーバ管理コマンドによる操作」を参照してください。Server Plug-inについては，「2.3　Server Plug-inの機能」および「第3編　Server Plug-inによる操作」を参照してください。

なお，インタフェースによって提供している機能に差異があります。機能の差異については，「13.1　J2EEリソース設定機能」および「16.1　J2EEアプリケーション設定の機能一覧」を参照してください。

1.2　J2EEリソースの管理

この節では，アプリケーション設定操作でのJ2EEリソースの管理の概要について説明します。

＜この節の構成＞

1.2.1　管理するJ2EEリソースの種類

1.2.2　リソースアダプタのアプリケーション設定操作

1.2.3　J2EEアプリケーションに含まれるリソースアダプタのアプリケーション設定操作

1.2.4　リソースアダプタ以外のJ2EEリソースのアプリケーション設定操作

1.2.1　管理するJ2EEリソースの種類

アプリケーション設定操作で管理するJ2EEリソースを次に示します。

＜この項の構成＞

(1)　リソースアダプタ

(2)　リソースアダプタ以外のJ2EEリソース

(1)　リソースアダプタ

リソースアダプタは，次のどちらかの方法で管理します。

J2EEリソースアダプタとしてデプロイして使用する。
J2EEサーバにインポートしたリソースアダプタを，共有スタンドアロンモジュールとしてデプロイします。そのJ2EEサーバ上で動作するすべてのJ2EEアプリケーションで使用できるようになります。J2EEサーバ上にデプロイされたリソースアダプタをJ2EEリソースアダプタといいます。
J2EEリソースアダプタのアプリケーション設定操作については，「1.2.2　リソースアダプタのアプリケーション設定操作」を参照してください。

J2EEアプリケーションに含めて使用する。
J2EEアプリケーションに含まれるリソースアダプタを，そのJ2EEアプリケーションで使用できるようにします。
J2EEアプリケーションに含まれるリソースアダプタのアプリケーション設定操作については，「1.2.3　J2EEアプリケーションに含まれるリソースアダプタのアプリケーション設定操作」を参照してください。

注意

J2EEアプリケーションは，これらのどちらのリソースアダプタも使用できます。ただし，同じ表示名のリソースアダプタを同時に使用することはできません。同じ表示名に設定するとエラーとなります。

J2EEリソースアダプタとして使用するリソースアダプタとJ2EEアプリケーションに含めて使用するリソースアダプタの比較を次に示します。

表1-1　管理するリソースアダプタの種類

リソースアダプタ
J2EEリソースアダプタとして使用
J2EEアプリケーションに含めて使用

DB Connector
トランザクションサポートレベル
NoTransaction
またはLocalTransaction
○
○

XATransaction
○
×

クラスタ構成
○
×

uCosminexus TP1 Connector
トランザクションサポートレベル
NoTransaction
またはLocalTransaction
○
○

XATransaction
○
×

TP1/Message Queue - Access
○
×

DB Connector for Cosminexus RMおよびCosminexus RM
○
×

そのほかのリソースアダプタ
○
○※

（凡例）　○：使用できる　×：使用できない

注※　次のリソースアダプタは，J2EEアプリケーションに含めて管理することはできません。

トランザクションサポートレベルにグローバルトランザクション管理（XATransaction）が設定されたリソースアダプタ

ネイティブライブラリを含むリソースアダプタ

起動順序の制御が必要なリソースアダプタ

(2)　リソースアダプタ以外のJ2EEリソース

リソースアダプタ以外に，次のJ2EEリソースを管理します。

JavaBeansリソース

メールコンフィグレーション

リソースアダプタ以外のJ2EEリソースのアプリケーション設定操作については，「1.2.4　リソースアダプタ以外のJ2EEリソースのアプリケーション設定操作」を参照してください。

1.2.2　リソースアダプタのアプリケーション設定操作

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの，アプリケーション設定操作について説明します。

＜この項の構成＞

(1)　リソースアダプタの種類

(2)　リソースアダプタの管理の流れ

(3)　リソースアダプタのアプリケーション設定操作

(1)　リソースアダプタの種類

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの種類は次のとおりです。

DB Connector
JDBCインタフェースを使用してデータベースに接続する場合に使用します。

DB Connector for Cosminexus RMおよびCosminexus RM
JMSインタフェースを使用してデータベースに接続する場合に使用します。
DB Connector for Cosminexus RMについては，マニュアル「Cosminexus Reliable Messaging」の「2.7　DB Connector for Cosminexus RMの機能」を参照してください。Cosminexus RMの管理については，マニュアル「Cosminexus Reliable Messaging」の「2.3　メッセージの管理」を参照してください。

uCosminexus TP1 Connector
OpenTP1のSPPに接続する場合に使用します。

TP1/Message Queue - Access
TP1/Message Queueに接続する場合に使用します。

そのほかのリソースアダプタ
任意のリソースに接続するためのリソースアダプタとして，Connector 1.5に準拠したリソースアダプタを使用できます。

(2)　リソースアダプタの管理の流れ

リソースアダプタを管理する基本的な流れを次に示します。

リソースアダプタのインポート

リソースアダプタのプロパティ定義

リソースアダプタのデプロイ

J2EEリソースアダプタの接続テスト

J2EEリソースアダプタの開始・停止

J2EEリソースアダプタのエクスポート

各手順について説明します。

●リソースアダプタのインポート

リソースアダプタをインポートします。

●リソースアダプタのプロパティ定義

データベースと接続するための情報を定義します。

●リソースアダプタのデプロイ

インポートしたリソースアダプタをJ2EEリソースアダプタとしてデプロイします。J2EEリソースアダプタとしてデプロイされたリソースアダプタは，J2EEサーバ上で動作するすべてのJ2EEアプリケーションから使用できます。

●J2EEリソースアダプタの接続テスト

接続テストを実施して，J2EEリソースアダプタが正しく動くことを確認します。

●J2EEリソースアダプタの開始・停止

設定が完了したJ2EEリソースアダプタを開始します。また，運用に応じてJ2EEリソースアダプタを停止します。

●J2EEリソースアダプタのエクスポート

J2EEリソースアダプタを，運用に応じてエクスポートします。

データベースと接続する場合，データベースの設定が必要になります。

また，リソースアダプタを使用する場合，J2EEアプリケーションでリソースアダプタのリファレンスを解決する必要があります。リソースアダプタのリファレンス解決は，J2EEアプリケーションのカスタマイズで実行します。J2EEアプリケーションのカスタマイズの概要については，「1.3　J2EEアプリケーションの管理」を参照してください。

(3)　リソースアダプタのアプリケーション設定操作

リソースアダプタの管理で使用する，アプリケーション設定操作の機能を次に示します。

表1-2　リソースアダプタの管理に使用するアプリケーション設定操作

J2EEリソース管理の操作 | 機能 | コマンド
リソースアダプタのインポート | リソースアダプタをJ2EEサーバにインポートします。 | cjimportres（-type rar指定）
リソースアダプタのプロパティ定義 | デプロイ前のリソースアダプタの属性を取得して，属性ファイルを生成します。 | cjgetresprop（-type rar指定）
デプロイ前のリソースアダプタの属性を，属性ファイルに指定された値に変更します。 | cjsetresprop（-type rar指定）
デプロイされているJ2EEリソースアダプタの属性を取得して，属性ファイルを生成します。 | cjgetrarprop
デプロイされているJ2EEリソースアダプタの属性を，属性ファイルに指定された値に変更します。 | cjsetrarprop
リソースアダプタのデプロイ | リソースアダプタをデプロイします。 | cjdeployrar
J2EEリソースアダプタの接続テスト | J2EEリソースアダプタの接続テストをします。 | cjtestres（-type rar指定）
J2EEリソースアダプタの開始と停止 | J2EEリソースアダプタを開始します。 | cjstartrar
開始されているJ2EEリソースアダプタを停止します。 | cjstoprar
J2EEリソースアダプタのエクスポート | J2EEサーバ上のリソースアダプタをエクスポートします。 | cjexportrar
リソースの一覧表示 | インポート済みのリソースアダプタの一覧を表示します。 | cjlistres（-type rar指定）
J2EEリソースアダプタの一覧を表示します。 | cjlistrar
リソースの削除 | リソースアダプタを削除します。 | cjdeleteres（-type rar指定）
J2EEリソースアダプタをアンデプロイします。 | cjundeployrar
そのほかの操作 | リソースアダプタのコネクションプールの状態を表示します。 | cjlistpool※1
リソースアダプタのコネクションプールのコネクションを削除します。 | cjclearpool※1
クラスタコネクションプールのメンバコネクションプールを一時停止します。 | cjsuspendpool※2
一時停止したクラスタコネクションプールのメンバコネクションプールを再開します。 | cjresumepool※2
リソースアダプタの属性をコピーします。 | cjcopyres（-type rar指定）

注※1　DB Connectorを使用してコネクションプールをクラスタ化した場合，ルートリソースアダプタには使用できません。メンバリソースアダプタに使用できます。

注※2　DB Connectorを使用してコネクションプールをクラスタ化した場合のメンバリソースアダプタだけに使用できます。

GUIインタフェースのServer Plug-inは，サーバ管理コマンドに対応しています。サーバ管理コマンドとの対応については，「第3編　Server Plug-inによる操作」の各章の「対応するサーバ管理コマンド」を参照してください。

1.2.3　J2EEアプリケーションに含まれるリソースアダプタのアプリケーション設定操作

J2EEアプリケーションに含まれるリソースアダプタのアプリケーション設定操作について説明します。

＜この項の構成＞

(1)　リソースアダプタの種類

(2)　リソースアダプタの管理の流れ

(3)　リソースアダプタのアプリケーション設定操作

(1)　リソースアダプタの種類

アプリケーション設定操作で管理する，J2EEアプリケーションに含めて使用するリソースアダプタの種類は次のとおりです。

DB Connector
JDBCインタフェースを使用してデータベースに接続する場合に使用します。
グローバルトランザクションおよびクラスタ構成の場合は利用できません。

uCosminexus TP1 Connector
OpenTP1のSPPに接続する場合に使用します。
グローバルトランザクションの場合は利用できません。

そのほかのリソースアダプタ（Connector 1.5に準拠したリソースアダプタ）
任意のリソースに接続するためのリソースアダプタとして，Connector 1.5に準拠したリソースアダプタを使用できます。
J2EEアプリケーションに含めて利用できるリソースアダプタの種類については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.3.2　リソースアダプタの種類」を参照してください。

(2)　リソースアダプタの管理の流れ

J2EEアプリケーションに含まれるリソースアダプタを管理する基本的な流れを次に示します。

J2EEアプリケーションへのリソースアダプタの追加

J2EEアプリケーションに含まれるリソースアダプタのプロパティ定義

J2EEアプリケーションに含まれるリソースアダプタの接続テスト

J2EEアプリケーションの開始・停止

J2EEアプリケーションのエクスポート

各手順について説明します。

●J2EEアプリケーションへのリソースアダプタの追加

次のどちらかの方法で，J2EEアプリケーションにリソースアダプタを追加します。

アプリケーション開発環境で，リソースアダプタを追加したJ2EEアプリケーションを作成します。そのJ2EEアプリケーションをJ2EEサーバにインポートします。

リソースアダプタをJ2EEサーバにインポートして，J2EEアプリケーションに追加します。

●J2EEアプリケーションに含まれるリソースアダプタのプロパティ定義

データベースと接続するための情報を定義します。

●J2EEアプリケーションに含まれるリソースアダプタの接続テスト

接続テストを実施して，J2EEアプリケーションに含まれるリソースアダプタが正しく動くことを確認します。

●J2EEアプリケーションの開始・停止

設定が完了したリソースアダプタを含むJ2EEアプリケーションを開始します。J2EEアプリケーションの開始で，J2EEアプリケーションに含まれるリソースアダプタが開始されます。

また，運用に応じてJ2EEアプリケーションを停止します。J2EEアプリケーションの停止で，J2EEアプリケーションに含まれるリソースアダプタが停止されます。

●J2EEアプリケーションのエクスポート

運用に応じて，リソースアダプタをJ2EEアプリケーションに含めてエクスポートします。

データベースと接続する場合，データベースの設定が必要になります。

また，リソースアダプタを使用する場合，J2EEアプリケーションでリソースアダプタのリファレンスを解決する必要があります。リソースアダプタのリファレンス解決は，J2EEアプリケーションのカスタマイズで実行します。J2EEアプリケーションのカスタマイズの概要については，「1.3　J2EEアプリケーションの管理」を参照してください。

(3)　リソースアダプタのアプリケーション設定操作

J2EEアプリケーションに含まれるリソースアダプタの管理で使用する，アプリケーション設定操作の機能を次に示します。

表1-3　J2EEアプリケーションに含まれるリソースアダプタの管理に使用するアプリケーション設定操作

J2EEリソース管理の操作 | 機能 | コマンド
リソースアダプタのインポート | リソースアダプタをJ2EEサーバにインポートします。 | cjimportres（-type rar指定）
J2EEアプリケーションへのリソースアダプタの追加 | J2EEアプリケーションに，リソースアダプタを追加します。 | cjaddapp（-type rar指定）
J2EEアプリケーションのインポート | リソースアダプタを含むJ2EEアプリケーションをインポートします。 | cjimportapp
リソースアダプタのプロパティ定義 | J2EEアプリケーションに含まれるリソースアダプタの属性を取得して，属性ファイルを生成します。 | cjgetappprop（-type rar指定）
J2EEアプリケーションに含まれるリソースアダプタの属性を，属性ファイルに指定された値に変更します。 | cjsetappprop（-type rar指定）
リソースアダプタの接続テスト | J2EEアプリケーションに含まれるリソースアダプタの接続テストをします。 | cjtestres（-name ［アプリケーション名］ -type rar指定）
J2EEアプリケーションの開始と停止 | J2EEアプリケーションを開始します。J2EEアプリケーションの開始で，J2EEアプリケーションに含まれるすべてのリソースアダプタが開始されます。リソースアダプタ単位の開始はできません。 | cjstartapp
開始されているJ2EEアプリケーションを停止します。J2EEアプリケーションの停止で，J2EEアプリケーションに含まれるすべてのリソースアダプタが停止されます。リソースアダプタ単位の停止はできません。 | cjstopapp
J2EEアプリケーションのエクスポート | J2EEアプリケーションに含めて，リソースアダプタをエクスポートします。 | cjexportapp
J2EEアプリケーションからリソースアダプタの削除 | J2EEアプリケーションから，J2EEリソースのリソースアダプタを削除します。 | cjdeleteapp（-type rar指定）
リソースの一覧表示 | J2EEアプリケーションに含まれるリソースアダプタの一覧を表示します。 | cjlistapp（-type rar指定）
そのほかの操作 | J2EEアプリケーションに含まれるリソースアダプタのコネクションプールの状態を表示します。 | cjlistpool（-name ［アプリケーション名］指定）
J2EEアプリケーションに含まれるリソースアダプタのコネクションプールのコネクションを削除します。 | cjclearpool（-name ［アプリケーション名］指定）

GUIインタフェースのServer Plug-inは，サーバ管理コマンドに対応しています。サーバ管理コマンドとの対応については，「第3編　Server Plug-inによる操作」の各章の「対応するサーバ管理コマンド」を参照してください。

1.2.4　リソースアダプタ以外のJ2EEリソースのアプリケーション設定操作

リソースアダプタ以外のJ2EEリソースの，アプリケーション設定操作について説明します。

＜この項の構成＞

(1)　リソースアダプタ以外のJ2EEリソースの種類

(2)　J2EEリソース管理の流れ

(3)　J2EEリソースのアプリケーション設定操作

(1)　リソースアダプタ以外のJ2EEリソースの種類

アプリケーション設定操作で管理する，リソースアダプタ以外のJ2EEリソースは次のとおりです。

JavaBeansリソース

メールコンフィグレーション

(2)　J2EEリソース管理の流れ

J2EEリソースの管理の基本的な流れを次に示します。

J2EEリソースのインポート

J2EEリソースのプロパティ定義

J2EEリソースの接続テスト

J2EEリソースの開始・停止

サーバ管理コマンドを使用したJ2EEリソースの管理では，J2EEリソースの種別によって，必要な設定および操作方法が異なります。

J2EEリソースの種別ごとに，それぞれの手順で必要な作業を次の表に示します。手順の列に記載されている番号に従った順序で作業を実施してください。

表1-4　J2EEリソースの管理で行う必要な作業

手順 | JavaBeansリソース | メールコンフィグレーション
1. | J2EEリソースのインポート | ○ | －
2. | J2EEリソースのプロパティ定義 | ○ | ○※
3. | J2EEリソースの接続テスト | － | ○
4. | J2EEリソースの開始・停止 | ○ | －

（凡例）　○：必要　－：該当項目なし

注※　メールコンフィグレーションのプロパティ定義には，メールコンフィグレーションの新規作成が含まれます。

各手順について説明します。

●J2EEリソースのインポート

JavaBeansリソースをインポートします。

●J2EEリソースのプロパティ定義

JavaBeansリソースやメールコンフィグレーションを管理する情報を定義します。

●J2EEリソースの接続テスト

メールコンフィグレーションが正しく動くことを確認します。

●J2EEリソースの開始・停止

設定が完了したJavaBeansリソースを開始します。また，運用に応じてJavaBeansリソースを停止します。

(3)　J2EEリソースのアプリケーション設定操作

J2EEリソース管理で使用する，アプリケーション設定操作の機能を次に示します。

表1-5　J2EEリソースの管理に使用するアプリケーション設定操作

J2EEリソース管理の操作 | 機能 | コマンド
J2EEリソースのインポート | JavaBeansリソースをJ2EEサーバにインポートします。 | cjimportjb
J2EEリソースのプロパティ定義 | JavaBeansリソースの属性を取得して，属性ファイルを生成します。 | cjgetjbprop
JavaBeansリソースの属性を，属性ファイルに指定された値に変更します。 | cjsetjbprop
メールに含まれるリソースの属性を取得して，属性ファイルを生成します。 | cjgetresprop（-type mail指定）
メールに含まれるリソースの属性を，属性ファイルに指定された値に変更します。 | cjsetresprop（-type mail指定）
J2EEリソースの接続テスト | メールの接続テストをします。 | cjtestres（-type mail指定）
J2EEリソースの開始と停止 | JavaBeansリソースを開始します。 | cjstartjb
JavaBeansリソースを停止します。 | cjstopjb
リソースの一覧表示 | インポート済みのJavaBeansリソースの一覧を表示します。 | cjlistjb
インポート済みのメール一覧を表示します。 | cjlistres（-type mail指定）
リソースの削除 | JavaBeansリソースを削除します。 | cjdeletejb
メールを削除します。 | cjdeleteres（-type mail指定）
そのほかの操作 | メールの属性をコピーします。 | cjcopyres（-type mail指定）

1.3　J2EEアプリケーションの管理

この節では，アプリケーション設定操作でのJ2EEアプリケーションの管理の概要について説明します。

＜この節の構成＞

1.3.1　管理するJ2EEアプリケーション

1.3.2　J2EEアプリケーション管理の流れ

1.3.3　J2EEアプリケーション管理に使用するアプリケーション設定操作

1.3.1　管理するJ2EEアプリケーション

管理するJ2EEアプリケーションの形式と，J2EEアプリケーションを構成するコンポーネントについて説明します。

＜この項の構成＞

(1)　J2EEアプリケーションの形式

(2)　J2EEアプリケーションを構成するコンポーネント

(1)　J2EEアプリケーションの形式

アプリケーション設定操作で管理するのは，次のどちらかの形式のアプリケーションです。

アーカイブ形式のJ2EEアプリケーション
J2EEサーバの作業ディレクトリ下に，J2EEアプリケーションのコンポーネントの構成ファイルを持つ形式です。

展開ディレクトリ形式のJ2EEアプリケーション
J2EEサーバの作業ディレクトリ下に，J2EEアプリケーションのコンポーネントの構成ファイルを持たないで，J2EEサーバの外部にある構成ファイルを論理的なJ2EEアプリケーションとして使用する形式です。

J2EEアプリケーションの形式の詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.　J2EEアプリケーションの形式とデプロイ」を参照してください。

(2)　J2EEアプリケーションを構成するコンポーネント

アプリケーション設定操作では，次のコンポーネントで構成されるJ2EEアプリケーションを管理します。

サーブレット・JSPで構成されたJ2EEアプリケーション

Enterprise Beanで構成されたJ2EEアプリケーション

サーブレット・JSPとEnterprise Beanで構成されたJ2EEアプリケーション

また，J2EEアプリケーションのコンポーネントにリソースアダプタを含めて，管理することもできます。

アーカイブ形式のJ2EEアプリケーションの場合は，コンポーネントは，J2EEアプリケーションへの追加や新規J2EEアプリケーションの作成で使うことができます。J2EEアプリケーションの作成については，「7.　J2EEアプリケーションの作成」を参照してください。

1.3.2　J2EEアプリケーション管理の流れ

J2EEアプリケーションの管理の流れを次に示します。

ファイルのインポート

J2EEアプリケーションの作成※

J2EEアプリケーションのプロパティ定義

J2EEアプリケーションの開始・停止

J2EEアプリケーションのエクスポート

注※　すでにアプリケーション開発ツールなどを使用して作成，設定されているJ2EEアプリケーションの場合は実施しません。

J2EEアプリケーションの管理で必要な作業を次の表に示します。手順の列に記載されている番号に従った順序で作業を実施してください。

表1-6　J2EEアプリケーションの管理で行う必要な作業

手順 | 新規に作成するJ2EEアプリケーション | 作成済みのJ2EEアプリケーション※1
アーカイブ形式 | 展開ディレクトリ形式
1. | ファイルのインポート | ○※2 | ○ | ○
2. | J2EEアプリケーションの作成 | ○ | －※3 | －
3. | J2EEアプリケーションのプロパティ定義 | ○ | ○ | ○※4
4. | J2EEアプリケーションの開始・停止 | ○ | ○ | ○
5. | J2EEアプリケーションのエクスポート | ○ | ○ | ○

（凡例）　○：必要　－：該当項目なし

注※1　アプリケーション開発ツールなどを使用して作成したJ2EEアプリケーションです。J2EEアプリケーションの形式によって，インポート方法が異なります。

アーカイブ形式のJ2EEアプリケーションを設定する場合，アーカイブファイルのパスを指定してJ2EEアプリケーションをインポートしてください。

展開ディレクトリ形式のJ2EEアプリケーションを設定する場合，アプリケーションディレクトリパスまたは展開ディレクトリパスを指定して，J2EEアプリケーションをインポートしてください。

注※2　コンポーネントの構成ごとに，次のファイルをインポートします。

サーブレット・JSPが含まれるJ2EEアプリケーションを作成する場合，サーブレット・JSPをインポートしてください。

Enterprise Beanが含まれるJ2EEアプリケーションを作成する場合，Enterprise Beanをインポートしてください。

リソースアダプタが含まれるJ2EEアプリケーションを作成する場合，リソースアダプタをインポートしてください。

注※3　作成済みのアーカイブ形式のJ2EEアプリケーションに，コンポーネントやライブラリJARを追加・削除できます。

注※4　サーバ管理コマンドを実行するホストと異なるホストで稼働しているJ2EEサーバの展開ディレクトリ形式のJ2EEアプリケーションについては，J2EEアプリケーションの設定およびカスタマイズはできません。

各手順について説明します。

●ファイルのインポート

J2EEアプリケーションを構成するコンポーネント（サーブレット・JSP，Enterprise Bean，リソースアダプタおよびライブラリJAR）や，作成済みのJ2EEアプリケーションをインポートします。

●J2EEアプリケーションの作成

インポートしたファイルで，J2EEアプリケーションを作成します。

●J2EEアプリケーションのプロパティ定義

作成したJ2EEアプリケーションまたはインポートした作成済みのJ2EEアプリケーションに対して，J2EEアプリケーションを構成するコンポーネントに応じた属性を設定します。

DD文に対応する属性の定義

実行時プロパティや動作の設定

J2EEリソースのリファレンス解決

●J2EEアプリケーションの開始・停止

設定やカスタマイズの完了したJ2EEアプリケーションを開始します。また，運用に応じて停止します。

●J2EEアプリケーションのエクスポート

運用に応じて，J2EEアプリケーションをエクスポートします。

1.3.3　J2EEアプリケーション管理に使用するアプリケーション設定操作

J2EEアプリケーション管理で使用する，アプリケーション設定操作の機能を次に示します。

表1-7　J2EEアプリケーションの管理に使用するサーバ管理コマンド

J2EEアプリケーション管理の操作 | 機能 | コマンド
ファイルのインポート | J2EEアプリケーションを構成するコンポーネント（WARファイル，EJB-JARファイル，RARファイル）を，J2EEサーバにインポートします。 | cjimportres
ライブラリJARファイルを，J2EEサーバにインポートします。 | cjimportlibjar
J2EEアプリケーションを，J2EEサーバにインポートします。 | cjimportapp
J2EEアプリケーションの作成 | インポート済みのEJB-JARファイル，WARファイル，RARファイルをJ2EEアプリケーションに追加します。 | cjaddapp
J2EEアプリケーションのプロパティ定義 | J2EEアプリケーションまたはJ2EEアプリケーションに含まれるコンポーネントの属性を取得して，属性ファイルを生成します。 | cjgetappprop
J2EEアプリケーションまたはJ2EEアプリケーションに含まれるコンポーネントの属性を，指定されたアプリケーション属性ファイルの値に変更します。 | cjsetappprop
J2EEアプリケーションの開始と停止 | J2EEアプリケーションを開始して，クライアントからのリクエストを受け取ることができるようにします。 | cjstartapp
J2EEアプリケーションを停止して，クライアントからのリクエストを受け取らないようにします。 | cjstopapp
J2EEアプリケーションのエクスポート | J2EEサーバ上のJ2EEアプリケーションをエクスポートします。 | cjexportapp
J2EEアプリケーションの一覧表示 | すべてのJ2EEアプリケーションについての名称と状態，J2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，またはRARファイルの一覧を表示します。 | cjlistapp
J2EEアプリケーションに含まれるライブラリJARの一覧を表示します。 | cjlistlibjar
J2EEサーバで稼働しているトランザクション情報の一覧を表示します。 | cjlisttrn
J2EEサーバで停止中のトランザクション情報の一覧を表示します。 | cjlisttrnfile
J2EEアプリケーションの削除 | J2EEアプリケーションまたはJ2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，RARファイルを，指定されたJ2EEサーバから削除します。 | cjdeleteapp
ライブラリJARをJ2EEアプリケーションから削除します。 | cjdeletelibjar
そのほかの操作 | J2EEアプリケーションの動作モードを変更します。 | cjchmodapp
展開ディレクトリ形式のJ2EEアプリケーションを入れ替えます。※ | cjreloadapp
アーカイブ形式のJ2EEアプリケーションを入れ替えます。※ | cjreplaceapp
J2EEアプリケーションの名称を変更します。 | cjrenameapp
起動されているリソースアダプタのコネクションプールの状態を表示します。 | cjlistpool
CMP2.x Entity Bean用のSQL文を生成します。 | cjgencmpsql
ロールにユーザを追加します。 | cjmapsec
ユーザまたはロールを追加します。 | cjaddsec
ユーザまたはロールを削除します。 | cjdeletesec
ユーザまたはロールの一覧を表示します。 | cjlistsec
J2EEアプリケーションについて，RMI-IIOPスタブおよびインタフェースを取得します。 | cjgetstubsjar

注※　J2EEアプリケーションの形式については，「1.3.1　管理するJ2EEアプリケーション」を参照してください。

GUIインタフェースのServer Plug-inは，サーバ管理コマンドに対応しています。サーバ管理コマンドとの対応については，「第3編　Server Plug-inによる操作」の各章の「対応するサーバ管理コマンド」を参照してください。

1.4　アプリケーション設定操作の制約

この節では，J2EEアプリケーション設定操作を実行する場合の，実行時ホストおよびJ2EEアプリケーションの状態による制約について説明します。

＜この節の構成＞

1.4.1　アプリケーション設定操作の実行ホストについての制約

1.4.2　J2EEアプリケーションの状態による操作の制約

1.4.3　そのほかの制約

1.4.1　アプリケーション設定操作の実行ホストについての制約

アプリケーション設定操作は，J2EEサーバおよびCORBAネーミングサービスとは別のホストから実行できます。

ただし，展開ディレクトリ形式のJ2EEアプリケーションの場合，J2EEアプリケーションの設定とカスタマイズについてはJ2EEサーバと同じホストだけで実行できます。

別のホストのJ2EEサーバを操作する場合，あらかじめ次の設定が必要です。

J2EEサーバへのアクセス権の設定
操作対象のJ2EEサーバへのアクセス権限が必要です。J2EEサーバへのアクセス権を設定するには，J2EEサーバ用のusrconf.propertiesファイルで，webserver.connector.http.permitted.hostsキーを定義します。J2EEサーバ用のusrconf.propertiesファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。
J2EEサーバに対するアクセス権限を持っていないときには，エラーメッセージが出力され，アプリケーション設定操作は実行できません。

ネットワークの設定
サーバ管理コマンド実行ホストからJ2EEサーバ実行ホストのホスト名称を解決できるよう，あらかじめネットワークを設定しておく必要があります。

アプリケーション設定操作，J2EEサーバおよびCORBAネーミングサービスを別のホストで実行する場合，それぞれにインストールされているCosminexusのバージョンが異なると正常に実行できないときがあります。それぞれに同じバージョンのCosminexusがインストールされている環境で使用してください。

1.4.2　J2EEアプリケーションの状態による操作の制約

J2EEアプリケーションの操作には，J2EEアプリケーションの状態によって実行できるものと実行できないものがあります。

J2EEアプリケーションの状態を次の表に示します。

表1-8　J2EEアプリケーションの状態

項番 | 状態※ | 説明
1 | 開始 | J2EEアプリケーションが開始されています。
2 | 閉塞中 | 閉塞処理が実施されています。
3 | 閉塞 | 閉塞処理が正常終了しました。
4 | 通常停止中 | 通常停止処理が実施されています。
5 | 強制停止中 | 強制停止操作で強制停止処理が実施されています。
6 | 停止 | J2EEアプリケーションが停止されています。
7 | 閉塞失敗 | 閉塞処理が異常終了しました。
8 | 通常停止失敗 | 通常停止処理が異常終了しました。
9 | 強制停止失敗 | 強制停止処理が異常終了しました。

注※　J2EEアプリケーションの状態を参照する方法については「10.3　J2EEアプリケーションの一覧の参照」を参照してください。

J2EEアプリケーションがそれぞれの状態の場合に実行できる操作，および実行できない操作を次の表に示します。

表1-9　J2EEアプリケーションの状態と実行できる操作

操作（コマンド） | J2EEアプリケーションの状態
1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
ファイルのインポート | WARファイル，EJB-JARファイルおよびRARファイルのインポート（cjimportres） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
ライブラリJARファイルのインポート（cjimportlibjar） | － | － | － | － | － | ○ | － | － | －
J2EEアプリケーションの作成（cjaddapp） | － | － | － | － | － | ○ | － | － | －
J2EEアプリケーションの設定とカスタマイズ | 属性ファイルの取得（cjgetappprop）※1 | ○ | － | － | － | － | ○ | － | － | －
属性の設定（cjsetappprop）※1 | － | － | － | － | － | ○ | － | － | －
J2EEアプリケーションの開始と停止 | J2EEアプリケーションの開始（cjstartapp） | － | － | － | － | － | ○ | － | － | －
J2EEアプリケーションの通常停止（cjstopapp） | ○ | － | － | － | － | － | － | － | －
J2EEアプリケーションの手動強制停止（cjstopapp） | － | － | ○ | ○ | － | － | － | － | －
J2EEアプリケーションの自動強制停止（cjstopapp） | ○ | － | － | － | － | － | － | － | －
J2EEアプリケーションのエクスポート（cjexportapp） | ○ | － | － | － | － | ○ | － | － | －
J2EEアプリケーションの一覧表示 | J2EEアプリケーションの状態表示（cjlistapp） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
ライブラリJARの一覧表示（cjlistlibjar） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
稼働中のトランザクション情報一覧表示（cjlisttrn） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
停止中のトランザクション情報一覧表示（cjlisttrnfile） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
J2EEアプリケーションの削除 | J2EEアプリケーションおよび構成コンポーネントの削除（cjdeleteapp） | － | － | － | － | － | ○ | － | － | －
ライブラリJARの削除（cjdeletelibjar） | － | － | － | － | － | ○ | － | － | －
そのほかの操作 | J2EEアプリケーションの動作モード変更（cjchmodapp） | － | － | － | － | － | ○ | － | － | －
展開ディレクトリ形式のJ2EEアプリケーションの入れ替え（cjreloadapp） | ○ | － | － | － | － | ○ | － | － | －
アーカイブ形式のJ2EEアプリケーションの入れ替え（cjreplaceapp） | ○ | － | － | － | － | ○ | － | － | －
J2EEアプリケーション名称の変更（cjrenameapp） | － | － | － | － | － | ○ | － | － | －
リソースアダプタのコネクションプールの状態表示（cjlistpool） | ○ | － | － | － | － | － | － | － | －
SQL文の生成（cjgencmpsql） | － | － | － | － | － | ○ | － | － | －
ロールにユーザを登録（cjmapsec） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
ユーザまたはロールの追加（cjaddsec） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
ユーザまたはロールの削除（cjdeletesec） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
ユーザまたはロールの一覧表示（cjlistsec） | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
RMI-IIOPスタブおよびインタフェースの取得（cjgetstubsjar） | ○ | ○ | ○ | ○ | ○ | ○※2 | ○ | ○ | ○

（凡例）

数字：表1-8の項番に対応した，J2EEアプリケーションの状態

○：実行できる

－：実行できない

注※1　J2EEアプリケーションのカスタマイズおよび各コンポーネントのプロパティを変更する場合，J2EEアプリケーションが開始されていても属性ファイルは取得できます。変更内容に編集した属性ファイルの値を反映するためには，J2EEアプリケーションを停止させてください。

注※2　J2EEアプリケーションが一度も開始されていない場合は，実行できません。

1.4.3　そのほかの制約

サーバ管理コマンドによる処理が実行されているときに別のサーバ管理コマンドを実行した場合，処理の実行はサーバ単位および処理を実行しているサーバ管理コマンドの系統ごとに制御されます。サーバ管理コマンドを同時に実行した場合の制御については，「3.2　サーバ管理コマンドの排他制御」を参照してください。

2.　アプリケーション設定操作で使用するインタフェース

この章では，アプリケーション設定操作のインタフェースである，サーバ管理コマンドとServer Plug-inの概要について説明します。

＜この章の構成＞

2.1　インタフェースの種類

2.2　サーバ管理コマンドの機能

2.3　Server Plug-inの機能

2.1　インタフェースの種類

アプリケーション設定操作で使用するインタフェースの種類および各インタフェースの使い方と機能の相違について説明します。

アプリケーション設定操作では，インタフェースとしてサーバ管理コマンド（CUI）とServer Plug-in（GUI）を提供しています。

＜この節の構成＞

2.1.1　インタフェースの特長

2.1.2　機能の比較

2.1.1　インタフェースの特長

それぞれのインタフェースの特長について説明します。

●サーバ管理コマンドを利用する場合

サーバ管理コマンドは，J2EEサーバで動作するリソースやJ2EEアプリケーションを設定，および管理するためのコマンド群です。GUIでの対話処理が不要な運用環境の操作などに適しています。

サーバ管理コマンドの機能については，「2.2　サーバ管理コマンドの機能」を参照してください。

●Server Plug-inを利用する場合

Server Plug-inは論理サーバ，J2EEリソース，およびJ2EEアプリケーションの操作をGUIで対話的に実行します。J2EEアプリケーションの開発を支援するMyEclipseと連携して，J2EEアプリケーションの開発を円滑に行えます。

アプリケーション設定操作の機能のうち，提供していないものもあります。Server Plug-inの機能については，「2.3　Server Plug-inの機能」を参照してください。

MyEclipseについては，マニュアル「Cosminexus アプリケーションサーバ アプリケーション開発ガイド」を参照してください。

2.1.2　機能の比較

サーバ管理コマンドとServer Plug-inで異なる機能を次に示します。

＜この項の構成＞

(1)　リソースの設定

(2)　J2EEアプリケーションの設定

(3)　ほかの機能

(1)　リソースの設定

Server Plug-inでは，次の機能は提供していません。

JavaBeansリソースの設定

メールコンフィグレーションの設定

J2EEリソースのコピー

リソース設定についてのサーバ管理コマンドとServer Plug-inの比較詳細は，「13.1　J2EEリソース設定機能」を参照してください。

(2)　J2EEアプリケーションの設定

サーバ管理コマンドに比べて，Server Plug-inでは，次の機能に差異があります。

J2EEアプリケーション（EAR）の作成
Server Plug-inでは，作成済みのJ2EEアプリケーションだけがインポートできます。J2EEアプリケーションの構成コンポーネント（EJB-JAR，WAR，RAR）をインポートして，新規にJ2EEアプリケーションを作成することはできません。

展開ディレクトリ形式のJ2EEアプリケーションのインポート
Server Plug-inでは，アプリケーションディレクトリパスを指定して，展開ディレクトリ形式のアプリケーションをインポートできます。
展開ディレクトリパスを指定して，アーカイブ形式のJ2EEアプリケーションを展開ディレクトリに変換してインポートすることはできません。
展開ディレクトリ形式のJ2EEアプリケーションについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.4　展開ディレクトリ形式のJ2EEアプリケーション」を参照してください。

プロパティの定義
Server Plug-inでは，次のプロパティは定義できません。

セキュリティアイデンティティの設定

Entity BeanのCMP定義

J2EEアプリケーションの操作
Server Plug-inでは，J2EEアプリケーションに次の操作はできません。

JSPをコンパイルしてJ2EEアプリケーションを開始

J2EEアプリケーションの自動強制停止

トランザクション一覧の参照

J2EEアプリケーションの設定についての，サーバ管理コマンドとServer Plug-inの比較詳細は，「16.1　J2EEアプリケーション設定の機能一覧」を参照してください。

(3)　ほかの機能

Server Plug-inでは，Management Serverリモート管理機能と接続しているホストについて，次の単位で起動，停止ができます。

運用管理ドメイン

運用管理ドメイン内のホスト

各論理サーバ

また，各論理サーバの稼働状態も監視できます。

Server Plug-inを使用しない場合のこれらの起動，停止については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.7.2　Management Serverの起動／停止と設定」，およびマニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「2.2　日常運用での起動と停止」を参照してください。Server Plug-inを使用しない場合のこれらの稼働状態の監視の方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「3.　稼働情報の監視（稼働情報収集機能）」を参照してください。

2.2　サーバ管理コマンドの機能

サーバ管理コマンドの機能を次の表に示します。サーバ管理コマンドの操作については，「第2編　サーバ管理コマンドによる操作」を参照してください。

表2-1　サーバ管理コマンドの機能一覧

機能 | 参照先
リソースアダプタの設定 | データベースと接続するための設定 | 4.2
データベースと接続するための設定（コネクションプールのクラスタ化の場合） | 4.3
そのほかのリソースアダプタと接続するための設定 | 4.4
J2EEアプリケーションに含まれるリソースアダプタの設定 | 5章
リソースアダプタ以外のJ2EEリソースの設定 | JavaBeansリソースの設定 | 6.2
メールコンフィグレーションの設定 | 6.3
J2EEアプリケーション（EAR）の作成 | 7章
J2EEアプリケーションのインポート※1とエクスポート | 8章
J2EEアプリケーションのプロパティの設定 | 9章
J2EEアプリケーションの実行 | J2EEアプリケーションの開始と停止 | 10.2
J2EEアプリケーションの一覧の参照 | 10.3
J2EEアプリケーションの削除 | 10.4
テストモードによるJ2EEアプリケーションの実行 | 10.5
J2EEアプリケーションの入れ替え※2 | 10.6
J2EEアプリケーション名の変更 | 10.7
RMI-IIOPスタブとインタフェースの取得 | 10.8
トランザクション一覧の参照 | 10.9

注※1

次の形式のJ2EEアプリケーションをインポートできます。

アーカイブ形式のJ2EEアプリケーション（EARファイル）

展開ディレクトリ形式のJ2EEアプリケーション（アプリケーションディレクトリ）

注※2

インポート時のJ2EEアプリケーションの形式によって，デプロイしたJ2EEアプリケーションを入れ替える場合，次のように操作が異なります。

デプロイしたアーカイブ形式のJ2EEアプリケーションを入れ替える場合，一度J2EEアプリケーションを再起動（停止，入れ替え，開始）する必要があります。

展開ディレクトリ形式のJ2EEアプリケーションを入れ替える場合，開始中のJ2EEアプリケーションを再起動（停止，入れ替え，開始）しないで，サーバ管理コマンドを実行して，アプリケーションを入れ替えることができます（リロード機能）。

アプリケーションの入れ替えについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「5.6　J2EEアプリケーションの入れ替え」を参照してください。

2.3　Server Plug-inの機能

Server Plug-inの機能一覧を次に示します。Server Plug-inの操作については，「第3編　Server Plug-inによる操作」を参照してください。

表2-2　Server Plug-inの機能一覧

機能 | 参照先
論理サーバ※1の運用管理 | 運用管理ドメイン単位の論理サーバの起動 | 12.2
運用管理ドメイン単位の論理サーバの停止 | 12.3
ホスト単位の論理サーバの起動 | 12.2
ホスト単位の論理サーバの停止 | 12.3
リソースアダプタの設定※2 | 14章
J2EEアプリケーションに含まれるリソースアダプタの設定 | 15章
J2EEアプリケーションのインポート※3とエクスポート | 17章
J2EEアプリケーションのプロパティ設定※4 | 18章
J2EEアプリケーションの実行 | J2EEアプリケーションの開始 | 19.2
J2EEアプリケーションの停止 | 19.3
J2EEアプリケーションの入れ替え※3 | 19.5
J2EEアプリケーション名の変更 | 19.6
RMI-IIOPスタブとインタフェースの取得 | 19.7
J2EEアプリケーションの削除 | 19.4
アプリケーション統合属性のインポートとエクスポート | 20章

注※1

運用管理（起動・停止）を実行する運用管理ドメインの種類については，「12.1　論理サーバの運用管理の概要」を参照してください。

注※2

Server Plug-inで設定できるJ2EEリソースは，リソースアダプタだけです。

注※3

Server Plug-inでは，MyEclipseでのJ2EEアプリケーションの作成と連携して，運用環境で，次の形式のJ2EEアプリケーションをインポートできます。

アーカイブ形式のJ2EEアプリケーション（EARファイル）

展開ディレクトリ形式のJ2EEアプリケーション（アプリケーションディレクトリ）

注※4

J2EEアプリケーションのプロパティの設定項目には，Server Plug-inで設定できない項目もあります。設定できない項目についてはサーバ管理コマンドで設定してください。サーバ管理コマンドとのプロパティ設定項目の相違については，「18.1　J2EEアプリケーションのプロパティ設定の概要」を参照してください。

3.　サーバ管理コマンドの基本操作

この章では，サーバ管理コマンドでアプリケーションを設定する場合の基本的な操作について説明します。

＜この章の構成＞

3.1　サーバ管理コマンドの実行の前提条件

3.2　サーバ管理コマンドの排他制御

3.3　属性ファイルによるプロパティの設定

3.4　サーバ管理コマンドで指定するプロバイダURL

3.5　このマニュアルでのサーバ管理コマンドの記載方法

3.1　サーバ管理コマンドの実行の前提条件

サーバ管理コマンドを使用する場合，次のことを確認してください。

サーバ管理コマンドは，J2EEサーバが起動している状態で実行できるコマンドです。使用する場合は，J2EEサーバおよびその前提プロセスを起動してから実行してください。J2EEサーバおよびその前提プロセスの起動については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「2.3　論理サーバの起動・停止の仕組み」を参照してください。

サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。実行に必要な権限を設定してください。

Windows 7またはWindows VistaでCosminexusのコマンドを使用する場合,管理者特権で実行する必要があります。Windows 7またはWindows VistaでCosminexusのコマンドを使用する場合の注意事項については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「1.4　コマンド使用時の注意事項」を参照してください。

サーバ管理コマンドを使用する場合の注意事項については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「1.4　コマンド使用時の注意事項」を参照してください。

3.2　サーバ管理コマンドの排他制御

サーバ管理コマンドの系統とサーバ管理コマンドの排他制御について説明します。

＜この節の構成＞

3.2.1　サーバ管理コマンドの系統

3.2.2　サーバ管理コマンドの排他制御

3.2.3　サーバ管理コマンドの排他制御の強制解除

3.2.1　サーバ管理コマンドの系統

サーバ管理コマンドによる処理が実行されている場合に別のサーバ管理コマンドを実行したとき，処理の実行はサーバ単位および処理を実行しているサーバ管理コマンドの系統ごとに制御されます。

サーバ管理コマンドには次の三つの系統があります。

参照系コマンド
インポートしたJ2EEアプリケーションの数や状態，含まれるリソース名など，J2EEサーバの構成状態を表示するサーバ管理コマンドです。J2EEサーバの内容は更新しません。

更新系コマンド
J2EEサーバの内容を更新したり，構成情報を取得したりするサーバ管理コマンドです。

特権系コマンド
J2EEサーバの内容を更新するコマンドで，常にほかのコマンドよりも優先して処理が実施されるサーバ管理コマンドです。

なお，それぞれのサーバ管理コマンドの系統については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」を参照してください。

3.2.2　サーバ管理コマンドの排他制御

コマンド実行の排他制御の条件を，サーバ管理コマンドの系統ごとに次の表に示します。

表3-1　コマンド実行の排他制御の条件

実行中のコマンド | あとから実行するコマンド
更新系コマンド | 参照系コマンド | 特権系コマンド
更新系コマンド | ○ | ◎ | ◎
参照系コマンド | ◎ | ○ | ◎
特権系コマンド | ◎ | ◎ | ×

（凡例）

◎：コマンドの実行が許可される。

○：あとから実行するコマンドは実行中のコマンドが終了するまで待つ。

×：コマンドの実行を中止する。排他エラーが返る。

ほかのコマンドの実行中に別のサーバ管理コマンドを実行しようとした場合，実行するコマンドの種類によって，異なる形で制御されます。

＜この項の構成＞

(1)　サーバ管理コマンドが処理をしているJ2EEサーバに対して異なるサーバ管理コマンドを実行した場合の制御

(2)　Server Plug-inが処理をしているJ2EEサーバに対してサーバ管理コマンドを実行した場合の制御

(3)　シャットダウンコマンドの処理中にサーバ管理コマンドを使用する場合の制御

(4)　特権系コマンドを使用する場合の制御

(1)　サーバ管理コマンドが処理をしているJ2EEサーバに対して異なるサーバ管理コマンドを実行した場合の制御

サーバ管理コマンドが処理をしているJ2EEサーバに対して異なる系統のサーバ管理コマンドを実行した場合，それぞれのサーバ管理コマンドの処理は並行して実行されます。また，サーバ管理コマンドが処理をしているJ2EEサーバに対して，同じ系統のサーバ管理コマンドを同時に実行した場合，あとに実行したサーバ管理コマンドの処理要求は，実行された順番で待ち状態になり，先に実行したサーバ管理コマンドの処理が終了してから開始されます。したがって，同時に処理を実行できるサーバ管理コマンドの数は，それぞれの系統のサーバ管理コマンドで一つずつです。また，待ち状態にあるサーバ管理コマンドには最大数の制限はありません。処理の実行が待ち状態になると，J2EEサーバ側にメッセージKDJE42211-Iが表示されます。

(2)　Server Plug-inが処理をしているJ2EEサーバに対してサーバ管理コマンドを実行した場合の制御

Server Plug-inが処理をしているJ2EEサーバに対しては，参照系と更新系に分類されるサーバ管理コマンドを実行することはできません。あとに実行したサーバ管理コマンドは排他エラーとなります。Server Plug-inの処理が終了してから次のサーバ管理コマンドを実行してください。なお，特権系に分類されるコマンドは実行できます。

(3)　シャットダウンコマンドの処理中にサーバ管理コマンドを使用する場合の制御

シャットダウンコマンドが処理中，または実行待ち状態にあるJ2EEサーバに対しては，更新系と参照系に分類されるサーバ管理コマンドは実行できません。シャットダウン処理時に，参照系と更新系に分類されるサーバ管理コマンドを実行した場合は排他エラーとなり，メッセージKDJE42212-Eが表示されます。なお，特権系に分類されるサーバ管理コマンドは実行できます。

(4)　特権系コマンドを使用する場合の制御

特権系コマンドは，ほかのすべてのコマンドより優先して実行できます。また，特権系コマンドの実行中であっても，ほかのコマンドの実行に対して影響することはありません。ただし，一つのJ2EEサーバに対して，同時に実行できる特権系コマンドは一つです。二つ以上の特権系コマンドを一つのJ2EEサーバに実行した場合はエラーとなり，メッセージKDJE42230-Eが表示されます。

3.2.3　サーバ管理コマンドの排他制御の強制解除

しばらく時間を置いて，何度かサーバ管理コマンドを実行しても同じ排他エラーメッセージ（実行中コマンドの情報も同じ）が表示される場合，サーバ管理コマンドの異常終了などによって，サーバ管理コマンドの排他情報に矛盾が生じているおそれがあります。この場合，メッセージ中に示されている実行中コマンドが，実際には実行されていないことをよく確認した上で，サーバ管理コマンドの排他制御を強制解除し，排他情報をリセットしてください。

排他制御の強制解除を実施するには，強制解除の対象にするJ2EEサーバを指定する必要があります。

注意

サーバ管理コマンド実行中に排他制御を解除すると，複数のサーバ管理コマンドが同時に実行され，J2EEサーバに矛盾が生じることがあります。このため，これらのサーバ管理コマンドが正常に実行されているときに誤って排他情報を解除しないように注意してください。

サーバ管理コマンドの排他制御を強制解除する手順を次に示します。

排他制御を強制解除する前に，サーバ管理コマンドが実際には実行中でないことを確認します。
サーバ管理コマンドを実行しようとすると，メッセージKDJE37057-EまたはKDJE37301-Eが表示されます。これらのメッセージに示されるサーバ管理コマンドが実際には実行されていないことをよく確認してください。

cjresetsvコマンドを実行して，排他制御を強制解除します。
実行形式

cjresetsv ［＜J2EEサーバ名＞］ ［-nameserver ＜プロバイダURL＞］

実行例
cjresetsv MyServer

3.3　属性ファイルによるプロパティの設定

サーバ管理コマンドでは，属性ファイルを使って，J2EEリソースおよびJ2EEアプリケーションのプロパティを設定します。

なお，cosminexus.xmlを使用した属性の設定方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「10.2　属性の管理」を参照してください。

＜この節の構成＞

3.3.1　J2EEリソースのプロパティの設定手順

3.3.2　J2EEアプリケーションのプロパティの設定手順

3.3.1　J2EEリソースのプロパティの設定手順

リソースアダプタとリソースアダプタ以外のJ2EEリソースのプロパティ設定手順について説明します。

＜この項の構成＞

(1)　リソースアダプタのプロパティの設定手順

(2)　リソースアダプタ以外のJ2EEリソースのプロパティ設定手順

(1)　リソースアダプタのプロパティの設定手順

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタのプロパティの設定手順を次に示します。

なお，J2EEアプリケーションに含まれるリソースアダプタのプロパティの設定手順については，「3.3.2　J2EEアプリケーションのプロパティの設定手順」を参照してください。

属性ファイルを取得します。
デプロイする前のリソースアダプタの属性ファイルを取得する場合は，cjgetrespropコマンドを実行します。リソースアダプタをデプロイしたあとで，リソースアダプタの属性ファイルを取得する場合は，cjgetrarpropコマンドを実行します。
取得する属性ファイルは，Connector属性ファイルです。
cjgetrespropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetresprop（リソースの属性の取得）」を参照してください。cjgetrarpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。

プロパティ設定項目を編集します。
取得した属性ファイルをテキストエディタで編集します。属性ファイルの編集項目については，各プロパティの設定の説明を参照してください。
属性ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

属性を設定します。
デプロイする前のリソースアダプタのプロパティを設定する場合は，cjsetrespropコマンドを実行します。デプロイしているリソースアダプタのプロパティを設定する場合は，cjsetrarpropコマンドを実行します。
cjsetrespropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetresprop（リソースの属性設定）」を参照してください。cjsetrarpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetrarprop（RAR属性設定）」を参照してください。

(2)　リソースアダプタ以外のJ2EEリソースのプロパティ設定手順

JavaBeansリソースおよびメールコンフィグレーションのプロパティの設定手順を次に示します。

属性ファイルを取得します。
JavaBeansリソースの属性ファイルを取得する場合は，cjgetjbpropコマンドを実行します。メールコンフィグレーションの属性ファイルを取得する場合は，cjgetrespropコマンドを実行します。
取得する属性ファイルは，次のとおりです。

JavaBeansリソースの場合
JavaBeansリソース属性ファイル

メールコンフィグレーションの場合
メール属性ファイル

cjgetjbpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetjbprop（JavaBeansリソースの属性の取得）」を参照してください。cjgetrespropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetresprop（リソースの属性の取得）」を参照してください。

プロパティ設定項目を編集します。
取得した属性ファイルをテキストエディタで編集します。属性ファイルの編集項目については，各プロパティの設定の説明を参照してください。
属性ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「2.2.9　Connector属性の詳細」を参照してください。

属性を設定します。
JavaBeansリソースのプロパティを設定する場合は，cjsetjbpropコマンドを実行します。メールコンフィグレーションのプロパティを設定する場合は，cjsetrespropコマンドを実行します。
cjsetjbpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetjbprop（JavaBeansリソースの属性設定）」を参照してください。cjsetrespropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetresprop（リソースの属性設定）」を参照してください。

3.3.2　J2EEアプリケーションのプロパティの設定手順

J2EEアプリケーションのプロパティの設定手順を次に示します。

属性ファイルを取得します。
アプリケーション属性，およびJ2EEアプリケーションを構成するコンポーネント（サーブレット・JSP，Enterprise Bean，リソースアダプタ）属性の属性ファイルを取得するため，cjgetapppropコマンドを実行します。
取得する属性ファイルは，プロパティを設定する対象となるコンポーネントに応じて異なります。また，そのアプリケーションのコンポーネントの属性情報を一括して編集する場合は，アプリケーション統合属性ファイルを取得します。
cjgetapppropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetappprop（アプリケーションの属性の取得）」を参照してください。

プロパティ設定項目を編集します。
取得した属性ファイルをテキストエディタで編集します。属性ファイルの編集項目については，各プロパティの設定の説明を参照してください。
属性ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.　J2EEアプリケーションの設定で使用する属性ファイル」を参照してください。

属性を設定します。
アプリケーション属性，およびJ2EEアプリケーションを構成するコンポーネント（サーブレット・JSP，Enterprise Bean，リソースアダプタ）属性の属性ファイルを設定するため，cjsetapppropコマンドを実行します。
cjsetapppropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetappprop（アプリケーションの属性設定）」を参照してください。

参考

J2EEアプリケーションにJ2EEアプリケーションを構成するコンポーネント（サーブレット・JSP，Enterprise Bean，リソースアダプタ）を追加して，新たにJ2EEアプリケーションを作成する場合，追加する前のコンポーネントのプロパティ定義は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。cjgetrespropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetresprop（リソースの属性の取得）」を参照してください。cjsetrespropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetresprop（リソースの属性設定）」を参照してください。

3.4　サーバ管理コマンドで指定するプロバイダURL

サーバ管理コマンドでは，オプションに＜プロバイダURL＞という値を指定できます。

＜プロバイダURL＞を省略して，サーバ管理コマンドを実行した場合，usrconf.propertiesファイルに設定した値がデフォルトで指定されます。

usrconf.propertiesファイルは次の場所に格納されています。

Windowsの場合

＜Cosminexusのインストールディレクトリ＞¥CC¥admin¥usrconf¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/admin/usrconf/usrconf.properties

usrconf.propertiesファイルに設定した値で実行する場合，およびcjlistappコマンドで，プロバイダURLを指定して実行する場合の例を次に示します。

usrconf.propertiesファイルに設定した値で実行する場合の例

Windowsの場合

＜Cosminexusのインストールディレクトリ＞¥CC¥admin¥bin¥cjlistapp ［＜サーバ名称＞］

UNIXの場合

/opt/Cosminexus/CC/admin/bin/cjlistapp ［＜サーバ名称＞］

プロバイダURLを指定して実行する場合の例

Windowsの場合

＜Cosminexusのインストールディレクトリ＞¥CC¥admin¥bin¥cjlistapp ［＜サーバ名称＞］ -nameserver ＜プロバイダURL＞

UNIXの場合

/opt/Cosminexus/CC/admin/bin/cjlistapp ［＜サーバ名称＞］ -nameserver ＜プロバイダURL＞

プロバイダURLは，次の形式で指定します。

実行形式

＜プロトコル名＞::＜ホスト名＞:＜ポート番号＞

＜プロトコル名＞

CORBAネーミングサービスのプロトコル名。corbaname固定です。iioplocまたはiiopnameを指定した場合，corbanameに読み替えられます。

＜ホスト名＞

CORBAネーミングサービスの稼働しているホスト名。

＜ポート番号＞

CORBAネーミングサービスの稼働しているポート番号。

プロバイダURLで指定したCORBAネーミングサービス上のサーバ管理コマンド排他情報が解除されます。

3.5　このマニュアルでのサーバ管理コマンドの記載方法

このマニュアルでは，サーバ管理コマンドを使用する場合，次のように記載しています。

実行形式および実行例では，その操作に主に関連する引数だけを示して説明しています。指定できる引数の詳細など，コマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」を参照してください。

実行するコマンドについては，コマンド名だけを表示しています。パスを指定してコマンドを実行する場合，コマンドの格納先を含めたパスを指定してください。
コマンドの格納先は次のとおりです。

Windowsの場合

＜Cosminexusのインストールディレクトリ＞¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

4.　リソースアダプタの設定

この章では，J2EEリソースアダプタとしてデプロイして使用するリソースアダプタのアプリケーション設定操作について説明します。J2EEリソースアダプタは，J2EEサーバに共有スタンドアロンモジュールとしてデプロイしたリソースアダプタです。

J2EEアプリケーションに含まれるリソースアダプタのアプリケーション設定操作については，「5.　J2EEアプリケーションに含まれるリソースアダプタの設定」を参照してください。

＜この章の構成＞

4.1　リソースアダプタの設定の概要

4.2　データベースと接続するための設定

4.3　データベースと接続するための設定（コネクションプールのクラスタ化の場合）

4.4　そのほかのリソースと接続するための設定

4.5　J2EEリソースアダプタの状態と一覧の参照

4.6　リソースアダプタの一覧の参照

4.7　コネクションプールの状態の確認

4.8　JNDI名前空間に登録されるリソースアダプタ名の参照と変更

4.9　リソースアダプタの削除

4.10　リソースアダプタのコピー

4.1　リソースアダプタの設定の概要

リソースアダプタの設定とは，リソースアダプタを，J2EEアプリケーションから利用できる状態にするための操作です。

J2EEリソースアダプタとしてデプロイして使用できるリソースアダプタの種類とアプリケーション設定操作の概要について説明します。

＜この節の構成＞

4.1.1　利用できるリソースアダプタ

4.1.2　設定する項目と操作の概要

4.1.1　利用できるリソースアダプタ

J2EEリソースアダプタとして，デプロイして利用できるリソースアダプタを次に示します。

DB Connector

DB Connector for Cosminexus RMおよびCosminexus RM

uCosminexus TP1 Connector

TP1/Message Queue - Access

そのほかのConnector 1.0に準拠したリソースアダプタ，またはConnector 1.5に準拠したリソースアダプタ※

注※　そのほかのConnector 1.0に準拠したリソースアダプタ，またはConnector 1.5に準拠したリソースアダプタについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.3.2　リソースアダプタの種類」を参照してください。

注意

J2EEリソースアダプタとJ2EEアプリケーションに含まれるリソースアダプタは，J2EEアプリケーションから同時に使用できます。ただし，J2EEリソースアダプタとJ2EEアプリケーションに含まれるリソースアダプタを，同じ表示名で同時に使用することはできません。同じ表示名に設定するとエラーとなります。

4.1.2　設定する項目と操作の概要

次のリソースアダプタの設定でのアプリケーション設定操作の概要を示します。

データベースと接続するための設定

データベースと接続するための設定（コネクションプールのクラスタ化の場合）

そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）

リソースアダプタ共通の設定

データベース上のキューと接続するための設定については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

＜この項の構成＞

(1)　データベースと接続するための設定

(2)　データベースと接続するための設定（コネクションプールのクラスタ化の場合）

(3)　そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）

(4)　リソースアダプタ共通の設定

(1)　データベースと接続するための設定

DB Connectorを使用してデータベースに接続する場合に必要な作業です。

表4-1　データベースと接続するための設定の概要

設定項目
内容
参照先

DB Connectorのインポート
DB ConnectorのRARファイルをインポートして，J2EEサーバから使用できるリソースに追加します。
4.2.1

DB Connectorのプロパティ定義
データベースとの接続についての次の情報を設定します。

DB Connectorの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

4.2.2

DB Connectorのデプロイ
インポートしたRARファイルを基にDB Connectorをデプロイします。DB Connectorは，デプロイするとJ2EEリソースアダプタとして利用できます。
4.2.3

DB Connectorの接続テスト
DB Connectorに設定した内容が正しいことを検証します。
4.2.4

DB Connectorの開始
DB Connectorを開始します。
4.2.5

DB Connectorの停止
DB Connectorを停止します。
4.2.6

DB Connectorのアンデプロイ
デプロイされているDB Connectorを削除します。リソースアダプタを入れ替えする場合に，必要に応じて実行してください。
4.2.7

DB Connectorのエクスポート
J2EEリソースアダプタをRARファイルとしてエクスポートします。
必要に応じて実行してください。
4.2.8

(2)　データベースと接続するための設定（コネクションプールのクラスタ化の場合）

DB Connectorのコネクションプールをクラスタ化で使用する場合に必要な作業です。

表4-2　データベースと接続するための設定（コネクションプールのクラスタ化の場合）の概要

設定項目 | 内容 | 参照先
メンバリソースアダプタ用DB Connectorの設定 | メンバリソースアダプタ用DB Connectorをインポート，設定，接続テストまで実行します。 | 4.3.2
ルートリソースアダプタ用DB Connectorの設定 | ルートリソースアダプタ用DB Connectorをインポート，設定，接続テストまで実行します。 | 4.3.3
メンバリソースアダプタ用DB Connectorの開始と停止 | メンバリソースアダプタ用DB Connectorを開始します。また，開始状態にあるメンバリソースアダプタ用DB Connectorを停止します。 | 4.3.4
ルートリソースアダプタ用DB Connectorの開始と停止 | ルートリソースアダプタ用DB Connectorを開始します。また，開始状態にあるルートリソースアダプタ用DB Connectorを停止します。 | 4.3.5
コネクションプールの状態の確認 | メンバコネクションプールの状態を参照します。 | 4.3.6
コネクションプールの一時停止 | メンバコネクションプールを一時停止の状態にします。 | 4.3.7
コネクションプールの再開 | 一時停止の状態のメンバコネクションプールを再開します。 | 4.3.8

(3)　そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）

リソースアダプタを使用してOpenTP1などの各種リソースに接続する場合に必要な作業です。

表4-3　そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）の概要

設定項目
内容
参照先

リソースアダプタのインポート
リソースアダプタ（RARファイル）をインポートして，J2EEサーバから使用できるリソースに追加します。
4.4.1

リソースアダプタのプロパティ定義
リソースとの接続についての次の情報を設定します。

リソースアダプタの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

4.4.2または4.4.3

リソースアダプタのデプロイ
インポートしたリソースアダプタを基にリソースアダプタをデプロイします。
リソースアダプタは，デプロイするとJ2EEリソースアダプタとして利用できます。
4.4.4

J2EEリソースアダプタの接続テスト
リソースアダプタに設定した内容が正しいかどうかを検証します。
4.4.5

J2EEリソースアダプタの開始
J2EEリソースアダプタを開始します。
4.4.6

J2EEリソースアダプタの停止
J2EEリソースアダプタを停止します。
4.4.7

J2EEリソースアダプタのアンデプロイ
J2EEリソースアダプタを削除します。
リソースアダプタを入れ替えする場合に，必要に応じて実行してください。
4.4.8

J2EEリソースアダプタのエクスポート
J2EEリソースアダプタをRARファイルとしてエクスポートします。
必要に応じて実行してください。
4.4.9

(4)　リソースアダプタ共通の設定

リソースアダプタに共通の設定です。

表4-4　リソースアダプタに共通な設定の概要

設定項目 | 内容 | 参照先
J2EEリソースアダプタの状態と一覧の表示 | デプロイされているJ2EEリソースアダプタの状態，コネクション定義識別子の一覧などを参照します。 | 4.5
リソースアダプタの一覧の参照 | インポートされているリソースアダプタの一覧，コネクション定義識別子の一覧などを参照します。 | 4.6
コネクションプールの状態の確認 | リソースアダプタのコネクションプールの状態を参照します。また，必要に応じてコネクションプール内のコネクションを削除します。 | 4.7
JNDI名前空間に登録されるリソースアダプタ名の参照と変更 | リソースアダプタのJNDI名前空間への登録名を参照して，必要に応じて別名を付与します。 | 4.8
リソースアダプタの削除 | リソースアダプタを削除します。 | 4.9
リソースアダプタのコピー | リソースアダプタをほかのフォルダなどにコピーできます。 | 4.10

4.2　データベースと接続するための設定

データベースと接続するために，DB Connectorの設定をします。DB Connectorはデータベースと接続するためのリソースアダプタです。

ここで説明するDB Connectorを使用したデータベースへの接続とは，JDBCインタフェースを使用してデータベースのテーブルだけにアクセスすることです。

JMSインタフェースを使用してキューにアクセスする場合は，DB Connector for Cosminexus RMおよびCosminexus RMを使用してデータベースに接続します。詳細は，マニュアル「Cosminexus Reliable Messaging」を参照してください。

データベースをコネクションプールのクラスタ化で使用する場合は，「4.3　データベースと接続するための設定（コネクションプールのクラスタ化の場合）」を参照してください。

DB Connectorの設定をするには，あらかじめ使用するデータベースの環境を設定しておいてください。また，使用するDB Connectorの種類に応じて，HiRDB Type4 JDBC Driver，Oracle JDBC Thin Driver，SQL Server 2000 Driver for JDBC，SQL Server 2005 JDBC Driver，またはSQL Server JDBC Driverの設定も必要です。DB Connectorの設定の詳細については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.5　データベースを使用するための設定」を参照してください。

DB Connectorの設定は次の手順で実施します。

DB Connectorをインポートします。

プロパティを定義します。

DB Connectorをデプロイします。
デプロイとは，DB ConnectorをJ2EEサーバに共有スタンドアロンモジュール（J2EEリソースアダプタ）として配備することです。

接続を確認します。
正しく接続できるかどうかは，接続テストによって確認できます。

デプロイしたDB Connectorは，J2EEアプリケーションのプロパティ設定で，リソースアダプタのリファレンスを解決する必要があります。詳細については，「9.3.3　リソースアダプタのリファレンス定義」を参照してください。

参考

DB Connectorのプロパティを新規に設定する場合，Cosminexus Component Containerが提供しているテンプレートファイルが利用できます。

Connector属性ファイルのテンプレートファイルは，次に示すディレクトリに格納されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥admin¥templates¥

UNIXの場合
/opt/Cosminexus/CC/admin/templates/

このテンプレートファイルを使用すると，DB Connectorをインポートする前に，Connector属性ファイルを編集しておくことができます。テンプレートファイルはコピーして使用してください。

Connector属性ファイルのテンプレートファイル名については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.14　Connector属性ファイルのテンプレートファイル」を参照してください。

なお，すでにプロパティが設定されているDB Connectorのプロパティを変更する場合は，テンプレートファイルは使用しないでください。インポートしたDB ConnectorのConnector属性を取得して，Connector属性ファイルを編集してください。

＜この節の構成＞

4.2.1　DB Connectorのインポート

4.2.2　DB Connectorのプロパティ定義

4.2.3　DB Connectorのデプロイ

4.2.4　DB Connectorの接続テスト

4.2.5　DB Connectorの開始

4.2.6　DB Connectorの停止

4.2.7　DB Connectorのアンデプロイ

4.2.8　DB Connectorのエクスポート

4.2.1　DB Connectorのインポート

次に示すコマンドを実行してDB Connectorをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -f ＜ファイルパス＞

＜ファイルパス＞には，RARファイルを指定してください。

RARファイルは，次のディレクトリに格納されています。

Windowsの場合
＜Cosminexusのインストールディレクトリ＞¥CC¥DBConnector¥

UNIXの場合
/opt/Cosminexus/CC/DBConnector/

DB Connectorをリソースアダプタとしてインポートする場合，トランザクションの管理方法，および使用するJDBCドライバの種類によって，次のどれかのRARファイルを指定します。なお，XDM/RD E2，SQL Serverに接続する場合，グローバルトランザクションは使用できません。

DBConnector_HiRDB_Type4_CP.rar
HiRDB Type4 JDBC Driver用のDB Connectorです。ローカルトランザクションを使用する場合，またはトランザクション管理なしで使用する場合（トランザクションのサポートレベルにLocalTransactionまたはNoTransactionを指定する場合）に選択します。
HiRDB Type4 JDBC DriverのConnectionPoolDataSourceを使用してHiRDBおよびXDM/RD E2に接続します。

DBConnector_HiRDB_Type4_XA.rar
HiRDB Type4 JDBC Driver用のDB Connectorです。グローバルトランザクションを使用する場合（トランザクションサポートレベルにXATransactionを指定する場合）に選択します。
HiRDB Type4 JDBC DriverのXADataSourceを使用してHiRDBに接続します。

DBConnector_Oracle_CP.rar
Oracle JDBC Thin Driver用のDB Connectorです。ローカルトランザクションを使用する場合，またはトランザクション管理なしで使用する場合（トランザクションのサポートレベルにLocalTransactionまたはNoTransactionを指定する場合）に選択します。
Oracle JDBC Thin DriverのConnectionPoolDataSourceを使用してOracleに接続します。

DBConnector_Oracle_XA.rar
Oracle JDBC Thin Driver用のDB Connectorです。グローバルトランザクションを使用する場合（トランザクションのサポートレベルにXATransactionを指定する場合）に選択します。
Oracle JDBC Thin DriverのXADataSourceを使用してOracleに接続します。

DBConnector_SQLServer_CP.rar
SQL Server 2000 Driver for JDBC用のDB Connectorです。ローカルトランザクションを使用する場合，またはトランザクション管理なしで使用する場合（トランザクションサポートレベルにLocalTransactionまたはNoTransactionを指定する場合）に選択します。
SQL Server 2000 Driver for JDBCのConnectionPoolDataSourceを使用してSQL Server 2000に接続します。

DBConnector_SQLServer2005_CP.rar
SQL Server 2005 JDBC Driver用のDB Connectorです。ローカルトランザクションを使用する場合，またはトランザクション管理なしで使用する場合（トランザクションサポートレベルにNoTransactionまたはLocalTransactionを指定する場合）に選択します。
SQL Server 2005 JDBC DriverのConnectionPoolDataSourceを使用して，SQL Server 2005に接続します。または，SQL Server JDBC DriverのConnectionPoolDataSourceを使用して，SQL Server 2008に接続します。

実行例

cjimportres MyServer -type rar -f DBConnector_DABJ_CP.rar

cjimportresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

4.2.2　DB Connectorのプロパティ定義

DB Connectorのプロパティを定義します。DB Connectorをデプロイしたあとでも実行できます。なお，デプロイ済みのDB Connectorのプロパティを変更する場合は，該当するDB Connectorを停止した状態で実行してください。

プロパティの設定手順については，「3.3　属性ファイルによるプロパティの設定」を参照してください。次にDB Connectorのプロパティ定義について説明します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　コンフィグレーションプロパティの設定例

(1)　編集する属性ファイル

Connector属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行して，DB ConnectorのConnector属性ファイルを取得します。

実行形式

cjgetresprop ＜サーバ名称＞ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜DB Connectorの表示名＞ -c ＜Connector属性ファイルパス＞

実行例

cjgetresprop MyServer -type rar -resname account-rar -c AccountProp.xml

●属性の設定

次に示すコマンドを実行して，Connector属性ファイルの値を反映します。

実行形式

cjsetresprop ＜サーバ名称＞ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜DB Connectorの表示名＞ -c ＜Connector属性ファイルパス＞

実行例

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

注意

リソースアダプタをデプロイしたあとでプロパティを定義する場合は，cjgetrarpropコマンドとcjsetrarpropコマンドを使用してください。cjgetrarpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。cjsetrarpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetrarprop（RAR属性設定）」を参照してください。

(3)　編集する属性設定項目

DB Connectorのプロパティ設定項目を次に示します。

DB Connectorの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

(a)　DB Connectorの一般情報

設定できるDB Connectorの一般情報属性（<outbound-resourceadapter>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
トランザクションサポートのレベル | ○ | <transaction-support>
再認証のサポート有無 | ○ | <reauthentication-support>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

(b)　コンフィグレーションプロパティ

DB Connectorのコンフィグレーションプロパティ（<outbound-resourceadapter> - <connection-definition> - <config-property>タグ）の設定項目を次に示します。

項目 | 対応するタグ
コンフィグレーションプロパティ名 | <config-property-name>
コンフィグレーションプロパティのデータ型 | <config-property-type>
コンフィグレーションプロパティの値 | <config-property-value>※

注※

コンフィグレーションプロパティの値をクリアする場合，空タグ（<config-property-value></config-property-value>）を指定します。

<config-property-value>タグ自体がない場合は，コンフィグレーションプロパティの値は変更されません。

定義するコンフィグレーションプロパティの数だけ，<config-property>タグ下の設定を繰り返してください。

設定する必要がある項目は，インポートしたDB Connectorの種類によって一部異なります。<config-property>タグに設定できるプロパティについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.10　DB Connectorに設定する<config-property>タグに指定できるプロパティ」を参照してください。

なお，<config-property-name>タグに「XAOpenString」が設定されている場合，cjgetrespropコマンドを実行すると，コンフィグレーションプロパティの値（<config-property-value>）は次のように表示されます。

プロパティの値が設定されている場合
コンフィグレーションプロパティの値（<config-property-value>）は取得されないで，「<!-- The config-property-value has already been set. -->」と表示されます。
「XAOpenString」の値を変更する場合には，<config-property-value>タグを追加して，変更後の値を設定してください。

プロパティの値が設定されていない場合
空タグ（<config-property-value></config-property-value>）が表示されます。
「XAOpenString」の値を設定する場合には，<config-property-value>タグに値を追加してください。

ステートメントプーリング機能を使用する場合の，ステートメントプーリングの動作，および注意事項については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.4　ステートメントプーリング」を参照してください。

使用するDB Connectorのコンフィグレーションプロパティの設定例については，「(4)　コンフィグレーションプロパティの設定例」を参照してください。

(c)　実行時プロパティ

DB Connectorの実行時プロパティ（<outbound-resourceadapter> - <connection-definition> - <connector-runtime>タグ）の設定項目を次に示します。

項目 | 対応するタグ
プロパティ名 | <property-name>
プロパティのデータ型 | <property-type>
プロパティの値 | <property-value>※

注※

プロパティの値をクリアする場合，空タグ（<property-value></property-value>）を指定します。

<property-value>タグ自体がない場合は，プロパティの値は変更されません。

定義するプロパティの数だけ，上記の設定を繰り返してください。

プロパティの値（<property-value>）を設定した場合，プロパティ値のデフォルト（<property-default-value>）で設定されている値は無効となります。

プロパティ名（<property-name>）には，次の項目を設定します。

プロパティ項目 | プロパティ名（<property-name>）の項目名
ユーザ名※ | User
パスワード※ | Password
コネクションプールにプールするコネクションの最小値 | MinPoolSize
コネクションプールにプールするコネクションの最大値 | MaxPoolSize
プール内のコネクションに障害が発生しているかどうかをチェックする方法の選択 | ValidationType
プール内のコネクションに障害が発生しているかどうかのチェックを定期的に実行する場合の間隔 | ValidationInterval
コネクションの取得に失敗した場合の，再取得する回数 | RetryCount
コネクションの取得に失敗した場合の，再取得する間隔 | RetryInterval
ログを出力するかどうかの選択 | LogEnabled
コネクションの最終利用時刻から，コネクションを自動破棄（コネクションスイーパ）するかを判定するまでの時間 | ConnectionTimeout
コネクションの自動破棄（コネクションスイーパ）が動作する間隔 | SweeperInterval
コネクション枯渇時にコネクション取得要求をキューで管理するかどうかの選択 | RequestQueueEnable
コネクション枯渇時のコネクション取得要求をキューで管理する場合の待ち時間の最大値 | RequestQueueTimeout
コネクションプールを監視するかどうかの選択 | WatchEnabled
コネクションプールを監視する間隔 | WatchInterval
コネクションプール使用状態を監視するしきい値 | WatchThreshold
コネクションプール監視結果のファイルを出力するかどうかの選択 | WatchWriteFileEnabled
コネクション数調節機能が動作する間隔 | ConnectionPoolAdjustmentInterval
コネクションプールのウォーミングアップ機能を有効にするかどうかの選択 | Warmup
ネットワーク障害検知機能のタイムアウトを有効にするかどうかの選択 | NetworkFailureTimeout

注※

<property-name>タグに「User」，「Password」が設定されている場合，cjgetrespropコマンドを実行すると，プロパティの値（<property-value>）は次のように表示されます。

プロパティの値が設定されている場合
プロパティの値（<property-value>）は取得されないで，「<!-- The property-value has already been set. -->」と表示されます。
「User」および「Password」の値を変更する場合には，<property-value>タグを追加して，変更後の値を設定してください。

プロパティの値が設定されていない場合
空タグ（<property-value></property-value>）が表示されます。
「User」および「Password」の値を設定する場合には，<property-value>タグに値を追加してください。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

コネクションプーリング機能を使用する場合のコネクションプールの動作，および注意事項については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.1　コネクションプーリング」を参照してください。

(d)　別名情報

DB Connectorの別名情報（<outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <resource-external-property>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
リソースの別名 | ○ | <optional-name>
リソース認証方式 | △ | <res-auth>
リソース共有の有無 | △ | <res-sharing-scope>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

DB Connectorの別名の使用法については，「4.8　JNDI名前空間に登録されるリソースアダプタ名の参照と変更」を参照してください。

(4)　コンフィグレーションプロパティの設定例

次のDB Connectorについて，コンフィグレーションプロパティの設定例を示します。

DBConnector_HiRDB_Type4_CP.rarで，HiRDB，またはXDM/RD E2を使用する場合

DBConnector_HiRDB_Type4_XA.rarで，HiRDBを使用する場合

DBConnector_Oracle_CP.rarで，Oracleを使用する場合

DBConnector_Oracle_XA.rarで，Oracleを使用する場合

DBConnector_SQLServer_CP.rarで，SQL Server 2000を使用する場合

DBConnector_SQLServer2005_CP.rarで，SQL Server 2005，またはSQL Server 2008を使用する場合

(a)　DBConnector_HiRDB_Type4_CP.rarで，HiRDBまたはXDM/RD E2を使用する場合

DBConnector_HiRDB_Type4_CP.rarで，HiRDBまたはXDM/RD E2を使用する場合の，コンフィグレーションプロパティの設定例を次の表に示します。

表4-5　データベースとしてHiRDBまたはXDM/RD E2を使用する場合のコンフィグレーションプロパティの設定例（DBConnector_HiRDB_Type4_CP.rarの場合）

項目名 | HiRDBの場合の設定例 | XDM/RD E2の場合の設定例
description | ＜HiRDBポート番号＞※ | ＜データベースコネクションサーバのサーバスケジュール番号＞※
DBHostName | ＜HiRDBホスト名＞ | ＜XDM/RD E2ホスト名＞
environmentVariables | ＜HiRDBクライアント環境変数名＞ | ＜HiRDBクライアント環境変数名＞
loginTimeout | 8 | 8
encodeLang | － | －
JDBC_IF_TRC | false | false
TRC_NO | 500 | 500
uapName | － | －
LONGVARBINARY_Access | REAL | REAL
SQLInNum | 300 | 300
SQLOutNum | 300 | 300
SQLWarningLevel | SQLWARN | SQLWARN
SQLWarningIgnore | false | false
HiRDBCursorMode | false | false
maxBinarySize | 0 | 0
LONGVARBINARY_AccessSize | 0 | 0
LONGVARBINARY_TruncError | true | true
PreparedStatementPoolSize | 10 | 10
CallableStatementPoolSize | 10 | 10
CancelStatement | true | true
logLevel | ERROR | ERROR

（凡例）　－：設定は不要

注※　HiRDBクライアントの環境変数グループ名（Windowsの場合）または環境変数グループの設定ファイルのパス（UNIXの場合）も指定できます。

(b)　DBConnector_HiRDB_Type4_XA.rarで，HiRDBを使用する場合

DBConnector_HiRDB_Type4_XA.rarで，HiRDBを使用する場合の，コンフィグレーションプロパティの設定例を次の表に示します。

表4-6　データベースとしてHiRDBを使用する場合のコンフィグレーションプロパティの設定例（DBConnector_HiRDB_Type4_XA.rarの場合）

項目名 | HiRDBの場合の設定例
description | ＜環境変数グループ識別子＞
DBHostName | ＜HiRDBホスト名＞
environmentVariables | ＜HiRDBクライアント環境変数名＞
XAOpenString | ＜環境変数グループ識別子※1＞＋＜環境変数グループの設定ファイルのパス※2＞
loginTimeout | 8
encodeLang | －
JDBC_IF_TRC | false
TRC_NO | 500
uapName | －
LONGVARBINARY_Access | REAL
SQLInNum | 300
SQLOutNum | 300
SQLWarningLevel | SQLWARN
SQLWarningIgnore | false
HiRDBCursorMode | false
maxBinarySize | 0
LONGVARBINARY_AccessSize | 0
LONGVARBINARY_TruncError | true
XACloseString | －
XALocalCommitMode | true
PreparedStatementPoolSize | 10
CallableStatementPoolSize | 10
CancelStatement | true
logLevel | ERROR

（凡例）　－：設定は不要

注※1　［Description］フィールドに入力した値を指定します。

注※2　HiRDBの環境変数グループの設定ファイルのパスを指定します。詳細については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.5.1　HiRDBの設定（HiRDB Type4 JDBC Driverの場合）」を参照してください。

(c)　DBConnector_Oracle_CP.rarで，Oracleを使用する場合

DBConnector_Oracle_CP.rarで，Oracleを使用する場合の，コンフィグレーションプロパティの設定例を次の表に示します。

表4-7　データベースとしてOracleを使用する場合のコンフィグレーションプロパティの設定例（DBConnector_Oracle_CP.rarの場合）

項目名 | Oracleの場合の設定例
databaseName | ＜Oracle SID＞
serverName | ＜Oracleのホスト名称，またはIPアドレス＞
portNumber | 1521
url | －
loginTimeout | 8000
PreparedStatementPoolSize | 10
CallableStatementPoolSize | 10
CancelStatement | true
ConnectionIDUpdate | false
logLevel | ERROR

（凡例）　－：設定は不要

(d)　DBConnector_Oracle_XA.rarで，Oracleを使用する場合

DBConnector_Oracle_XA.rarで，Oracleを使用する場合の，コンフィグレーションプロパティの設定例を次の表に示します。

表4-8　データベースとしてOracleを使用する場合のコンフィグレーションプロパティの設定例（DBConnector_Oracle_XA.rarの場合）

項目名 | Oracleの場合の設定例
databaseName | ＜Oracle SID＞
serverName | ＜Oracleのホスト名称，またはIPアドレス＞
portNumber | 1521
url | －
loginTimeout | 8000
sessionTimeout | 300
PreparedStatementPoolSize | 10
CallableStatementPoolSize | 10
CancelStatement | true
ConnectionIDUpdate | false
logLevel | ERROR

（凡例）　－：設定は不要

(e)　DBConnector_SQLServer_CP.rarで，SQL Server 2000を使用する場合

DBConnector_SQLServer_CP.rarで，SQL Server 2000を使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表4-9　データベースとしてSQL Server 2000を使用する場合

項目名 | SQL Server 2000の場合の設定例
databaseName | ＜SQL Server 2000のデータベース名＞
serverName | ＜SQL Server 2000のホスト名またはIPアドレス＞
hostProcess | 0
netAddress | －
loginTimeout | 8
portNumber | ＜SQL Server 2000のポート番号＞
programName | －
selectMethod | cursor
sendStringParametersAsUnicode | true
WSID | －
PreparedStatementPoolSize | 10
CallableStatementPoolSize | 10
CancelStatement | true
logLevel | ERROR

（凡例）　－：設定は不要

(f)　DBConnector_SQLServer2005_CP.rarで，SQL Server 2005，またはSQL Server 2008を使用する場合

DBConnector_SQLServer2005_CP.rarで，SQL Server 2005，またはSQL Server 2008を使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表4-10　データベースとしてSQL Server 2005，またはSQL Server 2008を使用する場合

項目名 | SQL Server 2005，またはSQL Server 2008の場合の設定例
databaseName | ＜SQL Server 2005，またはSQL Server 2008のデータベース名＞
serverName | ＜SQL Server 2005，またはSQL Server 2008のホスト名またはIPアドレス＞
applicationName | ＜SQL Server 2005，またはSQL Server 2008に接続するアプリケーション名＞
instanceName | ＜接続するSQL Server 2005，またはSQL Server 2008のインスタンス名＞
lastUpdateCount | true
lockTimeout | -1
loginTimeout | 8
portNumber | 1433
selectMethod | cursor
sendStringParametersAsUnicode | true
workstationID | ＜アプリケーションサーバのホスト名＞
xopenStates | false
failoverPartner | ＜データベースミラーリング構成で使用されるフェイルオーバサーバ名＞
integratedSecurity | false
packetSize | 4096
PreparedStatementPoolSize | 10
CallableStatementPoolSize | 10
CancelStatement | true
logLevel | ERROR

4.2.3　DB Connectorのデプロイ

DB Connectorは，デプロイするとJ2EEリソースアダプタとして使用できます。J2EEリソースアダプタとは，J2EEサーバに共有スタンドアロンモジュールとして配備したリソースアダプタのことです。サーバ管理コマンドでインポートした，リソースアダプタをデプロイすると，そのJ2EEサーバ上で動作するすべてのJ2EEアプリケーションから使用できるようになります。なお，デプロイしたあとで，プロパティを定義することもできます。デプロイ後に定義する場合は，該当するDB Connectorを停止した状態で実行してください。プロパティを定義する方法については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。

次に示すコマンドを実行してDB Connectorをデプロイします。

実行形式

cjdeployrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜DB Connectorの表示名＞

実行例

cjdeployrar MyServer -resname account-rar

cjdeployrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeployrar（リソースアダプタのデプロイ）」を参照してください。

4.2.4　DB Connectorの接続テスト

DB Connectorに設定した情報が正しいかどうか，接続テストによって検証します。

次に示すコマンドを実行してDB Connectorの接続テストを実施します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜DB Connectorの表示名＞

実行例

cjtestres MyServer -type rar -resname account-rar

cjtestresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

注意事項

一度接続テストをしたDB Connectorは，J2EEサーバを再起動するまで削除できません。DB Connectorを削除する場合は，DB Connectorを停止してから，J2EEサーバを再起動してください。

4.2.5　DB Connectorの開始

次に示すコマンドを実行してDB Connectorを開始します。

実行形式

cjstartrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜DB Connectorの表示名＞

実行例

cjstartrar MyServer -resname account-rar

cjstartrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartrar（リソースアダプタの開始）」を参照してください。

注意事項

J2EEアプリケーション中のJ2EEリソースがDB Connectorを参照している場合は，DB Connectorを開始してから，J2EEアプリケーションを開始してください。

一度開始したDB Connectorは，J2EEサーバを再起動するまで削除できません。DB Connectorを削除する場合は，DB Connectorを停止してから，J2EEサーバを再起動してください。

4.2.6　DB Connectorの停止

次に示すコマンドを実行してDB Connectorを停止します。

実行形式

cjstoprar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜DB Connectorの表示名＞

実行例

cjstoprar MyServer -resname account-rar

cjstoprarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstoprar（リソースアダプタの停止）」を参照してください。

注意事項

J2EEアプリケーション中のJ2EEリソースがDB Connectorを参照している場合は，J2EEアプリケーションを停止してから，DB Connectorを停止してください。

4.2.7　DB Connectorのアンデプロイ

準備

デプロイされているDB Connectorを削除する前に，DB Connectorを停止して，J2EEサーバを再起動してください。また，DB Connectorに対し，一度でも開始または接続テストを試みた場合も同様にJ2EEサーバを再起動してください。

次に示すコマンドを実行してDB Connectorをアンデプロイします。

実行形式

cjundeployrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜DB Connectorの表示名＞

実行例

cjundeployrar MyServer -resname account-rar

cjundeployrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjundeployrar（リソースアダプタのアンデプロイ）」を参照してください。

4.2.8　DB Connectorのエクスポート

DB Connectorの内容をRARファイルとして出力（エクスポート）します。

次に示すコマンドを実行してDB Connectorをエクスポートします。

実行形式

cjexportrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -f ＜ファイルパス＞ -resname ＜DB Connectorの表示名＞

実行例

cjexportrar MyServer -f res1.rar -resname account-rar

cjexportrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjexportrar（リソースアダプタのエクスポート）」を参照してください。

注意事項

Management Serverを利用して運用している場合，サーバ管理コマンドとManagement Serverの実行ホストが異なるときは，DB Connectorをエクスポートして，Management Serverの実行ホストに格納する必要があります。

4.3　データベースと接続するための設定（コネクションプールのクラスタ化の場合）

DB Connectorで，Oracle10g RACのクラスタ化されたデータベースに接続する場合，コネクションプールをクラスタ化して使うことができます。コネクションプールのクラスタ化の詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.17　コネクションプールのクラスタ化機能」を参照してください。

この節では，DB Connectorのコネクションプールをクラスタ化するための設定について説明します。

＜この節の構成＞

4.3.1　コネクションプールのクラスタ化の概要

4.3.2　メンバリソースアダプタ用DB Connectorの設定

4.3.3　ルートリソースアダプタ用DB Connectorの設定

4.3.4　メンバリソースアダプタ用DB Connectorの開始と停止

4.3.5　ルートリソースアダプタ用DB Connectorの開始と停止

4.3.6　コネクションプールの状態の確認

4.3.7　コネクションプールの一時停止

4.3.8　コネクションプールの再開

4.3.1　コネクションプールのクラスタ化の概要

クラスタ化されたコネクションプールをクラスタコネクションプールといいます。ルートリソースアダプタとメンバリソースアダプタで構成されます。メンバリソースアダプタのコネクションプールをメンバコネクションプールといいます。

DB Connectorのクラスタコネクションプールを使用するための作業と状態の制御方法を次に示します。

＜この項の構成＞

(1)　クラスタコネクションプールの設定

(2)　クラスタコネクションプールの状態と実行できる操作

(3)　リソースアダプタの種類による機能差異

(1)　クラスタコネクションプールの設定

クラスタコネクションプールを使用するためには，クラスタコネクションプールを使用できるリソースアダプタの設定が必要です。

クラスタコネクションプール用のDB Connectorの設定は，次の手順で実施します。

なお，手順1，2は，必要なメンバリソースアダプタの数だけ繰り返してください。

メンバリソースアダプタ用DB Connectorを設定します。
メンバリソースアダプタ用DB Connectorを，次の手順で設定します。

メンバリソースアダプタ用のDB ConnectorのRARファイルをインポートします。

プロパティを定義します。

DB Connectorをデプロイします。

接続を確認します。
正しく接続できるかどうかは，接続テストで確認できます。

メンバリソースアダプタ用DB Connectorを開始します。

ルートリソースアダプタ用DB Connectorを設定します。
ルートリソースアダプタ用DB Connectorを，次の手順で設定します。

ルートリソースアダプタ用のDB ConnectorのRARファイルをインポートします。

プロパティを定義します。

DB Connectorをデプロイします。

接続を確認します。
正しく接続できるかどうかは，接続テストで確認できます。

ルートリソースアダプタ用DB Connectorを開始します。

ルートリソースアダプタは，J2EEアプリケーションから直接アクセスされるので，デプロイしたルートリソースアダプタは，J2EEアプリケーションのプロパティ設定でリファレンスを解決する必要があります。詳細については，「9.3.3　リソースアダプタのリファレンス定義」を参照してください。

参考

DB Connectorのプロパティを新規に設定する場合，Cosminexus Component Containerが提供しているテンプレートファイルが利用できます。

Connector属性ファイルのテンプレートファイルは，次に示すディレクトリに格納されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥admin¥templates¥

UNIXの場合
/opt/Cosminexus/CC/admin/templates/

このテンプレートファイルを使用すると，DB Connectorをインポートする前に，Connector属性ファイルを編集しておくことができます。なお，テンプレートファイルはコピーして使用してください。

Connector属性ファイルのテンプレートファイル名については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.14　Connector属性ファイルのテンプレートファイル」を参照してください。

なお，すでにプロパティが設定されているDB Connectorのプロパティを変更する場合は，テンプレートファイルは使用しないでください。インポートしたDB ConnectorのConnector属性を取得して，Connector属性ファイルを編集してください。

(2)　クラスタコネクションプールの状態と実行できる操作

メンバコネクションプールは，データベースの障害や保守などの場合，手動で一時停止できます。一時停止状態になると，ルートリソースアダプタへのコネクション取得要求時に処理が実行されません。

また，一時停止したメンバコネクションプールは，手動で再開できます。ルートリソースアダプタへのコネクション取得要求時には，開始状態のコネクションプールだけ処理が実行されます。

コネクションプールの状態制御については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.17.3　クラスタコネクションプールの動作」を参照してください。

(3)　リソースアダプタの種類による機能差異

リソースアダプタの種類で，使用できる機能を次に示します。

表4-11　リソースアダプタの種類による機能一覧

機能 | リソースアダプタの種類
ルートリソースアダプタ | メンバリソースアダプタ
コネクションプーリング | × | ◎
コネクションプールのウォーミングアップ | × | ○
コネクションシェアリング・アソシエーション | × | ○
ステートメントプーリング | × | ○
DataSourceオブジェクトのキャッシング | ○ | ×
DB Connectorのコンテナ管理でのサインオンの最適化 | × | ○
コネクション障害検知 | × | ◎
コネクション障害検知のタイムアウト | × | ◎
コネクション枯渇時のコネクション取得待ち | × | ◎
コネクション取得リトライ | × | ×
コネクションプール情報表示 | × | ○
コネクションプールクリア | × | ○
コネクション自動クローズ | × | ○
コネクションスイーパ | × | ○
接続テスト | ○ | ○
コネクションプール数調節機能 | × | ○
コネクションプール情報の表示 | × | ○
コネクションプールの一時停止※ | × | ○
コネクションプールの再開※ | × | ○
J2EEリソースのユーザ指定名前空間機能 | ○ | ×

（凡例）　◎：必ず有効になる　○：使用できる　×：使用できない

注※　コネクションプールをクラスタで使用しない場合，コネクションプールの一時停止および再開は実行できません。

DB Connectorの属性を設定するリソースアダプタの種類を次に示します。

表4-12　リソースアダプタの種類と属性設定

設定項目 | リソースアダプタの種類
ルートリソースアダプタ | メンバリソースアダプタ
トランザクションサポートレベル | × | ○
ログ取得可否 | ○ | ○
データベース接続情報 | － | ○
DB Connector固有の設定（ステートメントプールなど） | － | ○
セキュリティ情報（ユーザ名，パスワード） | × | ○
コネクションプールサイズ | × | ○
クラスタコネクションプール固有の設定 | ○ | －

（凡例）　○：設定要　×：設定不要　－：設定項目なし

4.3.2　メンバリソースアダプタ用DB Connectorの設定

メンバリソースアダプタ用DB Connectorを，次の手順で設定します。

メンバリソースアダプタ用のDB Connectorをインポートします。

プロパティを定義します。

メンバリソースアダプタ用のDB Connectorをデプロイします。

接続を確認します。

＜この項の構成＞

(1)　メンバリソースアダプタ用のDB Connectorのインポート

(2)　メンバリソースアダプタ用のDB Connectorのプロパティ定義

(3)　メンバリソースアダプタ用のDB Connectorのデプロイ

(4)　メンバリソースアダプタ用のDB Connectorの接続テスト

(1)　メンバリソースアダプタ用のDB Connectorのインポート

次に示すコマンドを実行してメンバリソースアダプタ用のDB Connectorをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -f ＜ファイルパス＞

＜ファイルパス＞には，RARファイルを指定してください。

RARファイルは，次のディレクトリに格納されています。

Windowsの場合
＜Cosminexusのインストールディレクトリ＞¥CC¥DBConnector¥ClusterPool¥

UNIXの場合
/opt/Cosminexus/CC/DBConnector/ClusterPool/

メンバリソースアダプタとしてインポートするRARファイルについて説明します。

DBConnector_Oracle_CP_ClusterPool_Member.rar

クラスタコネクションプールのメンバリソースアダプタです。ローカルトランザクションまたはトランザクションなし（トランザクションサポートレベルにLocalTransactionまたはNoTransactionを指定する）で使用します。Oracle JDBC Thin DriverのConnectionPoolDataSourceを使用して，Oracleに接続します。

J2EEアプリケーションのリソースリファレンスに設定して使用することはできません。

実行例

cjimportres MyServer -type rar -f "c:¥Program Files¥Hitachi¥Cosminexus¥CC¥DBConnector¥ClusterPool¥DBConnector_Oracle_CP_ClusterPool_Member.rar"

cjimportresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

(2)　メンバリソースアダプタ用のDB Connectorのプロパティ定義

メンバリソースアダプタ用のDB Connectorのプロパティを定義します。プロパティを定義する手順については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。ここでは，メンバリソースアダプタ用のDB Connectorのプロパティの設定項目を説明します。

(a)　メンバリソースアダプタ用DB Connectorの一般情報

設定できるDB Connectorの一般情報属性（<outbound-resourceadapter>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
トランザクションサポートのレベル※ | ○ | <transaction-support>
再認証のサポート有無 | ○ | <reauthentication-support>

（凡例）　○：必須

注※　一つのクラスタコネクションプールを構成するメンバリソースアダプタのトランザクションサポートレベルは，すべて同じにしてください。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

(b)　メンバリソースアダプタ用コンフィグレーションプロパティ

メンバリソースアダプタ用DB Connectorのコンフィグレーションプロパティ（<config-property>タグ）と設定内容は，対応するリソースアダプタ（DBConnector_Oracle_CP.rar）と同じです。対応するリソースアダプタのコンフィグレーションプロパティについては，「4.2.2　DB Connectorのプロパティ定義」を参照してください。

(c)　実行時プロパティ

メンバリソースアダプタ用DB Connectorの実行時プロパティ（<outbound-resourceadapter> - <connection-definition> - <connector-runtime>タグ）の設定項目を次に示します。

項目 | 対応するタグ
プロパティ名 | <property-name>
プロパティのデータ型 | <property-type>
プロパティの値 | <property-value>

定義するプロパティの数だけ，上記の設定を繰り返してください。

プロパティ名（<property-name>）には，次の項目を設定します。

プロパティ項目 | プロパティ名（<property-name>）の設定項目
ユーザ名※ | User
パスワード※ | Password
コネクションプールにプールするコネクションの最小値 | MinPoolSize
コネクションプールにプールするコネクションの最大値 | MaxPoolSize
ログを出力するかどうかの選択 | LogEnabled
コネクションの最終利用時刻から，コネクションを自動破棄（コネクションスイーパ）するかを判定するまでの時間 | ConnectionTimeout
コネクションの自動破棄（コネクションスイーパ）が動作する間隔 | SweeperInterval
コネクション枯渇時のコネクション取得要求をキューで管理する場合の待ち時間の最大値 | RequestQueueTimeout
コネクションプールを監視するかどうかの選択 | WatchEnabled
コネクションプールを監視する間隔 | WatchInterval
コネクションプール使用状態を監視するしきい値 | WatchThreshold
コネクションプール監視結果のファイルを出力するかどうかの選択 | WatchWriteFileEnabled
コネクション数調節機能が動作する間隔 | ConnectionPoolAdjustmentInterval
コネクションプールのウォーミングアップ機能を有効にするかどうかの選択 | Warmup

注※　一つのクラスタコネクションプールを構成するメンバリソースアダプタのユーザ名は，すべて同じにしてください。

注意事項

メンバリソースアダプタでは，次の項目は設定の有無に関係なく，常に「有効」になります。

プロパティ項目
有効値
プロパティ名（<property-name>）の設定項目

コネクションプールにプールするコネクションの最小値
コネクションプーリング機能は常に有効
「MinPoolSize」，「MaxPoolSize」に「0」を設定しても，デフォルト値の「10」が仮定されます。
MinPoolSize

コネクションプールにプールするコネクションの最大値
MaxPoolSize

プール内のコネクションに障害が発生しているかどうかをチェックする方法の選択
常に「1」（コネクション取得時の障害検知）
ValidationType

コネクション枯渇時にコネクション取得要求をキューで管理するかどうかの選択
常に「true」
RequestQueueEnable

ネットワーク障害検知機能のタイムアウトを有効にするかどうかの選択
常に「true」
NetworkFailureTimeout

また，実行時プロパティのコネクションリトライ回数（「RetryCount」）とコネクションリトライ待ち時間（「RetryInterval」）の設定に関係なく，コネクション取得リトライ機能は，常に無効となります。

(3)　メンバリソースアダプタ用のDB Connectorのデプロイ

メンバリソースアダプタ用のDB Connectorは，デプロイするとJ2EEリソースアダプタとして使用できます。なお，デプロイしたあとで，プロパティを定義することもできます。デプロイ後に定義する場合は，該当するメンバリソースアダプタ用のDB Connectorが所属するルートリソースアダプタと，メンバリソースアダプタ用のDB Connectorを停止した状態で実行してください。プロパティを定義する方法については，「(2)　メンバリソースアダプタ用のDB Connectorのプロパティ定義」を参照してください。

次に示すコマンドを実行してメンバリソースアダプタ用のDB Connectorをデプロイします。

実行形式

cjdeployrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜メンバリソースアダプタ用のDB Connector表示名＞

実行例

cjdeployrar MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

cjdeployrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeployrar（リソースアダプタのデプロイ）」を参照してください。

(4)　メンバリソースアダプタ用のDB Connectorの接続テスト

メンバリソースアダプタ用のDB Connectorに設定した情報が正しいかどうか，接続テストで検証します。

次に示すコマンドを実行して，メンバリソースアダプタ用のDB Connectorの接続テストを実施します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜メンバリソースアダプタ用のDB Connectorの表示名＞

実行例

cjtestres -type rar -resname DB_Connector_for_Oracle_ClusterPool_Member

cjtestresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

注意事項

一度接続テストをしたメンバリソースアダプタ用のDB Connectorは，J2EEサーバを再起動するまで削除できません。メンバリソースアダプタ用のDB Connectorを削除する場合は，そのメンバリソースアダプタ用のDB Connectorが所属するルートリソースアダプタとメンバリソースアダプタ用のDB Connectorを停止してから，J2EEサーバを再起動してください。

4.3.3　ルートリソースアダプタ用DB Connectorの設定

ルートリソースアダプタ用DB Connectorを，次の手順で設定します。

ルートリソースアダプタ用のDB Connectorをインポートします。

プロパティを定義します。

ルートリソースアダプタ用のDB Connectorをデプロイします。

接続を確認します。

＜この項の構成＞

(1)　ルートリソースアダプタ用のDB Connectorのインポート

(2)　ルートリソースアダプタ用のDB Connectorのプロパティ定義

(3)　ルートリソースアダプタ用のDB Connectorのデプロイ

(4)　ルートリソースアダプタ用のDB Connectorの接続テスト

(1)　ルートリソースアダプタ用のDB Connectorのインポート

次に示すコマンドを実行してルートリソースアダプタ用のDB Connectorをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -f ＜ファイルパス＞

＜ファイルパス＞には，RARファイルを指定してください。

RARファイルは，次のディレクトリに格納されています。

Windowsの場合
＜Cosminexusのインストールディレクトリ＞¥CC¥DBConnector¥ClusterPool¥

UNIXの場合
/opt/Cosminexus/CC/DBConnector/ClusterPool/

ルートリソースアダプタとしてインポートするRARファイルについて説明します。

DBConnector_CP_ClusterPool_Root.rar

クラスタコネクションプールのルートリソースアダプタです。属するメンバリソースアダプタがローカルトランザクションまたはトランザクションなし（トランザクションサポートレベルにLocalTransactionまたはNoTransactionを指定する）で，データベースに接続する場合に使用します。

J2EEアプリケーションのリソースリファレンスに設定して使用します

実行例

cjimportres MyServer -type rar -f "c:¥Program Files¥Hitachi¥Cosminexus¥CC¥DBConnector¥ClusterPool¥DBConnector_CP_ClusterPool_Root.rar"

cjimportresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

(2)　ルートリソースアダプタ用のDB Connectorのプロパティ定義

ルートリソースアダプタ用のDB Connectorのプロパティを定義します。プロパティを定義する手順については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。ここでは，ルートリソースアダプタ用のDB Connectorのプロパティの設定項目を説明します。

ルートリソースアダプタ用のDB Connectorで，有効なプロパティを次に示します。下記以外の項目は，設定しても無視されます。

ルートリソースアダプタ用のDB Connectorの説明（<description>）

ルートリソースアダプタ用のDB Connector名称（<display-name>）

コンフィグレーションプロパティ（<outbound-resourceadapter> - <connection-definition> - <config-property>）

実行時プロパティ（<outbound-resourceadapter> - <connection-definition> - <connector-runtime>）のログを出力するかどうかの選択（<LogEnabled>）

別名情報（<outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <resource-external-property>）

コンフィグレーションプロパティの設定項目を次に示します。

項目 | 対応するタグ
コンフィグレーションプロパティ名 | <config-property-name>
コンフィグレーションプロパティのデータ型 | <config-property-type>
コンフィグレーションプロパティの値 | <config-property-value>

定義するコンフィグレーションプロパティの数だけ，上記の設定を繰り返してください。

DBConnector_CP_ClusterPool_Root.rarを使用する場合の，コンフィグレーションプロパティの設定項目と設定例を次の表に示します。

表4-13　 DBConnector_CP_ClusterPool_Root.rarを使用する場合のコンフィグレーションプロパティの設定例

項目名 | 設定例
algorithm | RoundRobin
enableAutoPoolSuspend | true
enableAutoPoolResume | true
dbCheckInterval | 30
memberResourceAdapterName1 | DB_Connector_for_Oracle_ClusterPool_Member1
memberResourceAdapterName2 | DB_Connector_for_Oracle_ClusterPool_Member2
logLevel | ERROR

コンフィグレーションプロパティ名（<config-property-name>）の「memberResourceAdapterName[n]」プロパティは，メンバリソースアダプタの表示名を設定します。memberResourceAdapterName[n]は，デフォルトでは優先度2まで定義してあります。さらに，メンバリソースアダプタを指定する場合には，プロパティを追加してください。優先度nは，1～100の範囲で指定してください。nは，連続している必要はありません。

(3)　ルートリソースアダプタ用のDB Connectorのデプロイ

ルートリソースアダプタ用のDB Connectorは，デプロイするとJ2EEリソースアダプタとして使用できます。なお，デプロイしたあとで，プロパティを定義することもできます。デプロイ後に定義する場合は，該当するルートリソースアダプタ用のDB Connectorを停止した状態で実行してください。プロパティを定義する方法については，「(2)　ルートリソースアダプタ用のDB Connectorのプロパティ定義」を参照してください。

次に示すコマンドを実行してルートリソースアダプタ用のDB Connectorをデプロイします。

実行形式

cjdeployrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜ルートリソースアダプタ用のDB Connector表示名＞

実行例

cjdeployrar MyServer -resname DB_Connector_for_ClusterPool_Root

cjdeployrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeployrar（リソースアダプタのデプロイ）」を参照してください。

(4)　ルートリソースアダプタ用のDB Connectorの接続テスト

ルートリソースアダプタ用のDB Connectorに設定した情報が正しいかどうか，接続テストで検証します。

次に示すコマンドを実行して，ルートリソースアダプタ用のDB Connectorの接続テストを実施します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜ルートリソースアダプタ用のDB Connectorの表示名＞

実行例

cjtestres -type rar -resname DB_Connector_for_ClusterPool_Root

cjtestresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

注意事項

一度接続テストをしたルートリソースアダプタ用のDB Connectorは，J2EEサーバを再起動するまで削除できません。ルートリソースアダプタ用のDB Connectorを削除する場合は，ルートリソースアダプタ用のDB Connectorを停止してから，J2EEサーバを再起動してください。

4.3.4　メンバリソースアダプタ用DB Connectorの開始と停止

＜この項の構成＞

(1)　メンバリソースアダプタ用のDB Connectorの開始

(2)　メンバリソースアダプタ用のDB Connectorの停止

(1)　メンバリソースアダプタ用のDB Connectorの開始

次に示すコマンドを実行してメンバリソースアダプタ用のDB Connectorを開始します。

実行形式

cjstartrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜メンバリソースアダプタ用のDB Connectorの表示名＞

実行例

cjstartrar MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

cjstartrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartrar（リソースアダプタの開始）」を参照してください。

(2)　メンバリソースアダプタ用のDB Connectorの停止

次に示すコマンドを実行して，メンバリソースアダプタ用のDB Connectorを停止します。

実行形式

cjstoprar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜メンバリソースアダプタ用のDB Connectorの表示名＞

実行例

cjstoprar MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

cjstoprarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstoprar（リソースアダプタの停止）」を参照してください。

注意事項

メンバリソースアダプタが所属するルートリソースアダプタを停止してから，メンバリソースアダプタを停止してください。

4.3.5　ルートリソースアダプタ用DB Connectorの開始と停止

＜この項の構成＞

(1)　ルートリソースアダプタ用のDB Connectorの開始

(2)　ルートリソースアダプタ用のDB Connectorの停止

(1)　ルートリソースアダプタ用のDB Connectorの開始

次に示すコマンドを実行してルートリソースアダプタ用のDB Connectorを開始します。

実行形式

cjstartrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜ルートリソースアダプタ用のDB Connectorの表示名＞

実行例

cjstartrar MyServer -resname DB_Connector_for_ClusterPool_Root

cjstartrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartrar（リソースアダプタの開始）」を参照してください。

注意事項

ルートリソースアダプタに所属するメンバリソースアダプタを開始してから，ルートリソースアダプタを開始してください。

(2)　ルートリソースアダプタ用のDB Connectorの停止

次に示すコマンドを実行して，ルートリソースアダプタ用のDB Connectorを停止します。

実行形式

cjstoprar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜ルートリソースアダプタ用のDB Connectorの表示名＞

実行例

cjstoprar MyServer -resname DB_Connector_for_ClusterPool_Root

cjstoprarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstoprar（リソースアダプタの停止）」を参照してください。

注意事項

J2EEアプリケーション中のJ2EEリソースがルートリソースアダプタ用のDB Connectorを参照している場合は，J2EEアプリケーションを停止してから，ルートリソースアダプタ用のDB Connectorを停止してください。

4.3.6　コネクションプールの状態の確認

コネクションプールのクラスタ化で使用しているコネクションプールの状態は，次の二つの方法で参照できます。

cjlistrarコマンドで，デプロイされているすべてのリソースアダプタの，リソースアダプタ名とメンバコネクションプールの状態を参照します。

cjlistpoolコマンドで，メンバコネクションプールの情報を参照します。
メンバコネクションプールの情報を参照して，必要に応じてメンバコネクションプールを閉塞/一時停止/再開します。コネクションプールの状態定義については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.17.3　クラスタコネクションプールの動作」を参照してください。

＜この項の構成＞

(1)　コネクションプールの状態の参照

(2)　メンバコネクションプールの情報の参照

(1)　コネクションプールの状態の参照

デプロイされているすべてのリソースアダプタについて，リソースアダプタ名とリソースアダプタの状態が表示されます。リソースアダプタがクラスタコネクションプールのメンバリソースアダプタの場合には，コネクションプールの状態も表示されます。

次に示すコマンドを実行して，コネクションプールの状態を参照します。

実行形式

cjlistrar ［＜サーバ名＞］ ［-nameserver ＜プロバイダURL＞］ -clusterpool

実行例

cjlistrar MyServer -clusterpool

cjlistrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

(2)　メンバコネクションプールの情報の参照

コネクションプールの情報が表示されます。リソースアダプタがクラスタコネクションプールのメンバリソースアダプタの場合には，メンバコネクションプールの情報も表示されます。

次に示すコマンドを実行して，すべてのリソースアダプタのコネクションプール情報を参照します。

実行形式

cjlistpool ［＜サーバ名＞］ ［-nameserver ＜プロバイダURL＞］ -resall

実行例

cjlistpool MyServer -resall

特定のリソースアダプタについて，コネクションプールの情報を表示する場合は次のコマンドを実行します。

実行形式

cjlistpool ［＜サーバ名＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjlistpool MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

リソースアダプタのコネクションプール情報が表示されます。

cjlistpoolコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistpool（コネクションプールの一覧表示）」を参照してください。

注意事項

cjlistpoolコマンドは，ルートリソースアダプタに対しては実行できません。

4.3.7　コネクションプールの一時停止

データベースの障害や保守などの場合，メンバコネクションプールを手動で一時停止できます。一時停止したコネクションプールは，コネクション取得要求を受け付けません。

次のコマンドを実行して，クラスタコネクションプールのメンバコネクションプールを一時停止します。

実行形式

cjsuspendpool ［＜サーバ名＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜一時停止対象となるメンバリソースアダプタの表示名＞

実行例

cjsuspendpool MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

cjsuspendpoolコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsuspendpool（メンバコネクションプールの一時停止）」を参照してください。

注意事項

cjsuspendpoolコマンドを使用して，手動で一時停止したコネクションプールは，自動再開はできません。cjresumepoolコマンドで手動再開してください。

4.3.8　コネクションプールの再開

一時停止したメンバコネクションプールは手動で再開できます。J2EEアプリケーションがルートリソースアダプタにコネクション取得要求をしたときに，再開したコネクションプールは，再びコネクション取得要求を受け付けることができるようになります。

次のコマンドを実行して，クラスタコネクションプールのメンバコネクションプールを再開します。

実行形式

cjresumepool ［＜サーバ名＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜再開対象となるメンバリソースアダプタの表示名＞

実行例

cjresumepool MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

cjresumepoolコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjresumepool（メンバコネクションプールの再開始）」を参照してください。

4.4　そのほかのリソースと接続するための設定

OpenTP1などのリソースとの接続には，リソースアダプタを使用します。ここでは，DB Connector，DB Connector for Cosminexus RM，およびCosminexus RM以外のリソースアダプタと接続するための基本的な設定について説明します。

リソースアダプタは，次の手順で設定します。

リソースアダプタをインポートします。

プロパティを定義します。

リソースアダプタをデプロイします。
リソースアダプタのデプロイとは，リソースアダプタをJ2EEサーバに共有スタンドアロンモジュール（J2EEリソースアダプタ）として配備することです。

接続を確認します。
正しく接続できるかどうかは，接続テストによって確認できます。

デプロイをしたJ2EEリソースアダプタは，J2EEアプリケーションのプロパティ設定で，リソースアダプタのリファレンスを解決する必要があります。詳細については，「9.3.3　リソースアダプタのリファレンス定義」を参照してください。

ポイント

そのほかのリソースと接続するリソースアダプタとして，次のリソースアダプタを使用できます。

Connector 1.0に準拠するリソースアダプタ

Connector 1.5に準拠するリソースアダプタ

Connector 1.0の仕様に準拠するリソースアダプタのプロパティの定義については，「4.4.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」を，Connector 1.5の仕様に準拠するリソースアダプタのプロパティの定義については，「4.4.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」を参照してください。

＜この節の構成＞

4.4.1　リソースアダプタのインポート

4.4.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）

4.4.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）

4.4.4　リソースアダプタのデプロイ

4.4.5　J2EEリソースアダプタの接続テスト

4.4.6　J2EEリソースアダプタの開始

4.4.7　J2EEリソースアダプタの停止

4.4.8　J2EEリソースアダプタのアンデプロイ

4.4.9　J2EEリソースアダプタのエクスポート

4.4.1　リソースアダプタのインポート

リソースアダプタをインポートします。

なお，アプリケーションサーバで提供されていない独自のリソースアダプタをインポートする場合は，注意事項に記載されている内容に従ってインポートしてください。

次に示すコマンドを実行してリソースアダプタをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -f ＜ファイルパス＞

実行例

cjimportres MyServer -type rar -f mqcadpt.rar

cjimportresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

注意事項

Connector 1.0以降の仕様に準拠しないDDを持つRARはインポートできません。インポートできるのは，Connector 1.0以降の仕様に準拠したDDを持つRARだけです。DDがDTDに従っていることを確認してから，インポートを実行してください。
インポート手順を次に示します。

図4-1　リソースアダプタ（RAR）のインポート手順

注※1

DDは検証済みXML文書として扱われます。このため，DD中のDOCTYPE宣言が誤っていた場合，またはDDがDTDの仕様に従っていない場合はエラーになります。

注※2

J2EE Connectorの仕様に従った値がDDに指定されていない場合はエラーとなります。詳細は，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「8.8.3　リソースアダプタのインポートと開始」を参照してください。

また，メッセージが出力された場合は，マニュアル「Cosminexus アプリケーションサーバ メッセージ 2」を参照して対処ください。

インポート時に指定したRARファイル名は作業ディレクトリ中のディレクトリ名として使用されます。また，RARファイル内のJARファイルやネイティブライブラリは作業ディレクトリ内に展開されます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにRARファイル名およびRARファイル中のファイル名を指定してください。J2EEアプリケーションを実行するシステムの場合の作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。バッチアプリケーションを実行するシステムの場合の作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.11.2　作業ディレクトリのパス長の見積もり式」を参照してください。

ra.xmlのdisplay-nameタグが設定されていない場合，RARファイル名を基にDisplay nameが付与されます。

RARファイルには，次の名称のファイルを含めないでください。
rar.properties
fileinfo.properties
META-INF/hitachi-ra.xml

4.4.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）

Connector 1.0の仕様に準拠するリソースアダプタのプロパティを定義します。リソースアダプタのプロパティ定義は，J2EEリソースアダプタをデプロイしたあとでも実行できます。なお，設定済みのリソースアダプタのプロパティを変更する場合は，該当するリソースアダプタを停止した状態で実行してください。

プロパティの設定手順の概要については，「3.3　属性ファイルによるプロパティの設定」を参照してください。次にリソースアダプタのプロパティ定義について説明します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

Connector属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行して，リソースアダプタのConnector属性ファイルを取得します。

実行形式

cjgetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜リソースアダプタの表示名＞ -c ＜Connector属性ファイルパス＞

実行例

cjgetresprop MyServer -type rar -resname Rar1 -c AccountProp.xml

●属性の設定

次に示すコマンドを実行して，Connector属性ファイルの値を反映します。

実行形式

cjsetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜リソースアダプタ表示名＞ -c ＜Connector属性ファイルパス＞

実行例

cjsetresprop MyServer -type rar -resname Rar1 -c AccountProp.xml

注意

リソースアダプタをデプロイしたあとでプロパティを定義する場合は，cjgetrarpropコマンドとcjsetrarpropコマンドを使用してください。cjgetrarpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。cjsetrarpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetrarprop（RAR属性設定）」を参照してください。

(3)　編集する属性設定項目

リソースアダプタのプロパティ設定項目を次に示します。

リソースアダプタの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

(a)　リソースアダプタの一般情報

リソースアダプタの一般情報（<outbound-resourceadapter>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
トランザクションサポートのレベル | ○ | <transaction-support>
再認証のサポート有無 | ○ | <reauthentication-support>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

(b)　コンフィグレーションプロパティ

リソースアダプタのコンフィグレーションプロパティ（<outbound-resourceadapter> - <connection-definition> - <config-property>タグ）の設定項目を次に示します。

項目 | 対応するタグ
コンフィグレーションプロパティ名 | <config-property-name>
コンフィグレーションプロパティのデータ型 | <config-property-type>
コンフィグレーションプロパティの値 | <config-property-value>

定義するコンフィグレーションプロパティの数だけ上記の設定を繰り返してください。

定義するコンフィグレーションプロパティ名（<config-property-name>）については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。

(c)　実行時プロパティ

リソースアダプタの実行時プロパティ（<outbound-resourceadapter> - <connection-definition> - <connector-runtime>タグ）の設定項目を次に示します。

項目 | 対応するタグ
プロパティ名 | <property-name>
プロパティのデータ型 | <property-type>
プロパティの値 | <property-value>

定義するプロパティの数だけ，上記の設定を繰り返してください。

定義する実行時プロパティ名（<property-name>）およびコネクションプールの動作と注意事項については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。

(d)　別名情報

リソースアダプタの別名情報（<outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <resource-external-property>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
リソースの別名 | ○ | <optional-name>
リソース認証方式 | △ | <res-auth>
リソース共有の有無 | △ | <res-sharing-scope>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

リソースアダプタの別名の使用法については，「4.8　JNDI名前空間に登録されるリソースアダプタ名の参照と変更」を参照してください。

4.4.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）

Connector 1.5の仕様に準拠するリソースアダプタに接続する場合のプロパティを定義します。

リソースアダプタのプロパティ定義は，J2EEリソースアダプタをデプロイしたあとでも実行できます。なお，リソースアダプタの設定済みのプロパティを変更する場合は，該当するリソースアダプタを停止した状態で実行してください。

プロパティの設定手順の概要については，「3.3　属性ファイルによるプロパティの設定」を参照してください。次にリソースアダプタのプロパティ定義について説明します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　リソースアダプタのプロパティ設定

(5)　Outboundリソースアダプタのコネクション単位のプロパティ設定

(1)　編集する属性ファイル

Connector属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行して，リソースアダプタのConnector属性ファイルを取得します。

実行形式

cjgetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜リソースアダプタの表示名＞ -c ＜Connector属性ファイルパス＞

実行例

cjgetresprop MyServer -type rar -resname Rar1 -c AccountProp.xml

●属性の設定

次に示すコマンドを実行して，Connector属性ファイルの値を反映します。

実行形式

cjsetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜リソースアダプタ表示名＞ -c ＜Connector属性ファイルパス＞

実行例

cjsetresprop MyServer -type rar -resname Rar1 -c AccountProp.xml

注意

リソースアダプタをデプロイしたあとでプロパティを定義する場合は，cjgetrarpropコマンドとcjsetrarpropコマンドを使用してください。cjgetrarpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。cjsetrarpropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetrarprop（RAR属性設定）」を参照してください。

(3)　編集する属性設定項目

Connector 1.5の仕様に準拠するリソースアダプタは，コネクション定義を複数持つ場合があります。

プロパティ項目は，次のように分けて設定します。

リソースアダプタのプロパティ設定
次のプロパティを設定します。

コンフィグレーションプロパティ

Outboundリソースアダプタのプロパティ

Inboundリソースアダプタのプロパティ

管理対象オブジェクトのプロパティ

実行時プロパティ

プロパティ設定項目については，「(4)　リソースアダプタのプロパティ設定」を参照してください。

Outboundリソースアダプタのコネクション単位のプロパティ設定
Outboundリソースアダプタを使用する場合は，次のプロパティを設定します。

コンフィグレーションプロパティ

実行時プロパティ

別名情報

Outboundリソースアダプタのコネクション単位のプロパティ設定項目については，「(5)　Outboundリソースアダプタのコネクション単位のプロパティ設定」を参照してください。

(4)　リソースアダプタのプロパティ設定

リソースアダプタのプロパティ設定項目を次に示します。

(a)　コンフィグレーションプロパティ

リソースアダプタのコンフィグレーションプロパティ（<resourceadapter> - <config-property>タグ）の設定項目を次に示します。

項目 | 対応するタグ
コンフィグレーションプロパティ名 | <config-property-name>
コンフィグレーションプロパティのデータ型 | <config-property-type>
コンフィグレーションプロパティの値 | <config-property-value>

定義するコンフィグレーションプロパティの数だけ上記の設定を繰り返してください。

定義するコンフィグレーションプロパティ名（<config-property-name>）については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。

(b)　Outboundリソースアダプタのプロパティ

Outboundリソースアダプタのプロパティ（<outbound-resourceadapter>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
コネクション単位でのプロパティ設定※1 | △ | <connection-definition>
トランザクションサポートのレベル※2 | ○ | <transaction-support>
再認証のサポート有無 | ○ | <reauthentication-support>

（凡例）　○：必須　△：任意

注※1　Outboundリソースアダプタのコネクション単位のプロパティ設定については，「(5)　Outboundリソースアダプタのコネクション単位のプロパティ設定」を参照してください。

注※2　Connector 1.5の仕様に準拠するリソースアダプタの場合，グローバルトランザクション（XATransaction）は指定できません。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

(c)　Inboundリソースアダプタのプロパティ

Inboundリソースアダプタのプロパティ（<inbound-resourceadapter> - <messageadapter> - <messagelistener>タグ）の設定項目を次に示します。

項目 | 対応するタグ
メッセージリスナのタイプ | <messagelistener-type>
ActivationSpecの情報 | <activationspec>

(d)　管理対象オブジェクトのプロパティ

リソースアダプタの管理対象オブジェクトのプロパティ（<adminobject> - <config-property>タグ）の設定項目を次に示します。

項目 | 対応するタグ
管理対象オブジェクトのプロパティ名 | <config-property-name>
管理対象オブジェクトのプロパティのデータ型 | <config-property-type>
管理対象オブジェクトのプロパティの値 | <config-property-value>

(e)　実行時プロパティ

リソースアダプタの実行時プロパティ（<resourceadapter-runtime> - <property>タグ）の設定項目を次に示します。

項目 | 対応するタグ
プロパティ名 | <property-name>
プロパティのデータ型 | <property-type>
プロパティの値 | <property-value>※

注※　プロパティの値の設定方法については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。

定義するプロパティの数だけ，上記の設定を繰り返してください。

プロパティ名（<property-name>）には，次の項目を設定します。

プロパティ項目 | プロパティ名（<property-name>）の項目名
スレッドプールで同時に実行される最大スレッド数 | MaxTPoolSize
スレッドプールに存在する最小スレッド数 | MinTPoolSize
スレッドプールのスレッド解放までのタイムアウト値(秒) | TPoolKeepalive

注　ライフサイクル管理機能が有効な場合に設定します。ライフサイクル管理機能を使用していない（<resourceadapter-class>を指定していない）場合，プロパティ値（<property-value>）は無視されます。ライフサイクル管理機能については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.16.1　リソースアダプタのライフサイクル管理」を参照してください。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

(5)　Outboundリソースアダプタのコネクション単位のプロパティ設定

Outboundリソースアダプタのコネクション単位のプロパティ設定項目を次に示します。

(a)　コンフィグレーションプロパティ

Outboundリソースアダプタのコンフィグレーションプロパティ（<outbound-resourceadapter> - <connection-definition> - <config-property>タグ）の設定項目を次に示します。

項目 | 対応するタグ
コンフィグレーションプロパティ名 | <config-property-name>
コンフィグレーションプロパティのデータ型 | <config-property-type>
コンフィグレーションプロパティの値 | <config-property-value>

定義するコンフィグレーションプロパティの数だけ上記の設定を繰り返してください。

定義するコンフィグレーションプロパティ名（<config-property-name>）については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。

なお，コネクション単位のコンフィグレーションプロパティには，コネクション単位に設定されたコンフィグレーションプロパティ（<outbound-resourceadapter> - <connection-definition> - <config-property>タグ）とリソースアダプタに設定されたコンフィグレーションプロパティ（<resourceadapter> - <config-property>タグ）を合わせたものが設定されます。同じコンフィグレーションプロパティ名が設定されている場合は，コネクション単位に設定されたコンフィグレーションプロパティが優先されます。

(b)　実行時プロパティ

Outboundリソースアダプタの実行時プロパティ（<outbound-resourceadapter> - <connection-definition> - <connector-runtime>タグ）の設定項目を次に示します。

項目 | 対応するタグ
プロパティ名 | <property-name>
プロパティのデータ型 | <property-type>
プロパティの値 | <property-value>

定義するプロパティの数だけ，上記の設定を繰り返してください。

定義する実行時プロパティ名（<property-name>）およびコネクションプールの動作と注意事項については，「4.2.2　DB Connectorのプロパティ定義」を参照してください。

(c)　別名情報

Outboundリソースアダプタの別名情報（<outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <resource-external-property>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
リソースの別名 | ○ | <optional-name>
リソース認証方式 | △ | <res-auth>
リソース共有の有無 | △ | <res-sharing-scope>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

リソースアダプタの別名の使用方法については，「4.8　JNDI名前空間に登録されるリソースアダプタ名の参照と変更」を参照してください。

4.4.4　リソースアダプタのデプロイ

リソースアダプタは，デプロイするとJ2EEリソースアダプタとして使用できます。

サーバ管理コマンドでインポートしたリソースアダプタをデプロイすると，そのJ2EEサーバ上で動作するすべてのJ2EEアプリケーションから使用できるようになります。なお，リソースアダプタをデプロイしたあとで，リソースアダプタのプロパティを定義することもできます。プロパティを定義する方法については，リソースアダプタが対応しているコネクタアーキテクチャの仕様に応じて，「4.4.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」または「4.4.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」を参照してください。

次に示すコマンドを実行してリソースアダプタをデプロイします。

実行形式

cjdeployrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞ ［-resname ＜リソースアダプタの表示名＞］

実行例

cjdeployrar MyServer -resname Rar1

cjdeployrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeployrar（リソースアダプタのデプロイ）」を参照してください。

注意事項

開始状態の実行時情報を含んだリソースアダプタを指定すると，デプロイ完了後に自動開始されます。自動開始処理に失敗した場合でも，このJ2EEリソースアダプタは削除されません。

4.4.5　J2EEリソースアダプタの接続テスト

リソースアダプタに設定した情報が正しいかどうか，接続テストによって検証します。

次に示すコマンドを実行してリソースアダプタの接続テストを実施します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜リソースアダプタの表示名＞ ［-resname ＜リソースアダプタの表示名＞］

実行例

cjtestres MyServer -type rar -resname Rar1

cjtestresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

注意事項

一度接続テストをしたリソースアダプタは，J2EEサーバを再起動するまで削除できません。リソースアダプタを削除する場合は，リソースアダプタを停止してから，J2EEサーバを再起動してください。

Connector 1.5の仕様に準拠するリソースアダプタにコネクション定義が複数ある場合，すべてのコネクション定義に対して接続テストが実行されます。コネクション定義のどれかでエラーが発生した場合でも，すべてのコネクション定義に対して接続テストが実行されます。ただし，その場合，接続テスト結果は「失敗」となります。

Connector 1.5の仕様に準拠するリソースアダプタの場合は，Outboundリソースアダプタを含むときだけ，接続テストを実施できます。

4.4.6　J2EEリソースアダプタの開始

J2EEリソースアダプタを開始します。

次に示すコマンドを実行してJ2EEリソースアダプタを開始します。

実行形式

cjstartrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjstartrar MyServer -resname Rar1

cjstartrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartrar（リソースアダプタの開始）」を参照してください。

注意事項

J2EEアプリケーション中のJ2EEリソースがJ2EEリソースアダプタを参照している場合は，J2EEリソースアダプタを開始してから，J2EEアプリケーションを開始してください。

一度開始したJ2EEリソースアダプタは，J2EEサーバを再起動するまで削除できません。J2EEリソースアダプタを削除するには，J2EEリソースアダプタを停止してから，J2EEサーバを再起動し，削除しようとするJ2EEリソースアダプタがJ2EEアプリケーションの参照解決の対象外であることを確認してください。

4.4.7　J2EEリソースアダプタの停止

J2EEリソースアダプタを停止します。

次に示すコマンドを実行してJ2EEリソースアダプタを停止します。

実行形式

cjstoprar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjstoprar MyServer -resname Rar1

cjstoprarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstoprar（リソースアダプタの停止）」を参照してください。

注意事項

J2EEアプリケーション中のJ2EEリソースがJ2EEリソースアダプタを参照している場合は，J2EEアプリケーションを停止してから，J2EEリソースアダプタを停止してください。

4.4.8　J2EEリソースアダプタのアンデプロイ

デプロイされているJ2EEリソースアダプタを削除します。

準備

J2EEリソースアダプタを削除する前に，J2EEリソースアダプタを停止してJ2EEサーバを再起動してください。また，J2EEリソースアダプタに対し，一度でも開始または接続テストを試みた場合も同様にJ2EEサーバを再起動してください。

次に示すコマンドを実行してJ2EEリソースアダプタをアンデプロイします。

実行形式

cjundeployrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjundeployrar MyServer -resname Rar1

cjundeployrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjundeployrar（リソースアダプタのアンデプロイ）」を参照してください。

4.4.9　J2EEリソースアダプタのエクスポート

J2EEリソースアダプタの内容をRARファイルとして出力（エクスポート）します。

次に示すコマンドを実行してJ2EEリソースアダプタをエクスポートします。

実行形式

cjexportrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -f ＜ファイルパス＞ -resname ＜J2EEリソースアダプタの表示名＞

実行例

cjexportrar MyServer -f res1.rar -resname Rar1

cjexportrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjexportrar（リソースアダプタのエクスポート）」を参照してください。

注意事項

Management Serverを利用して運用している場合，サーバ管理コマンドとManagement Serverの実行ホストが異なる場合，J2EEリソースアダプタをエクスポートして，Management Serverの実行ホストに格納する必要があります。

4.5　J2EEリソースアダプタの状態と一覧の参照

デプロイされているリソースアダプタのアダプタ名と状態を参照できます。また，Connector 1.5の仕様に準拠するリソースアダプタの場合，コネクション定義識別子の一覧や，メッセージリスナのタイプの一覧などの情報も参照できます。

＜この節の構成＞

4.5.1　J2EEリソースアダプタの状態の参照

4.5.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

4.5.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

4.5.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

4.5.1　J2EEリソースアダプタの状態の参照

次に示すコマンドを実行して，デプロイされているすべてのリソースアダプタの名称と状態（開始状態または停止状態）を参照します。

実行形式

cjlistrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-spec］

実行例

cjlistrar MyServer

-specオプションを指定すると，リソースアダプタの状態表示一覧にコネクタアーキテクチャの仕様バージョンが表示されます。

cjlistrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

4.5.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，デプロイされているOutboundリソースアダプタのコネクション定義識別子の一覧を参照できます。

実行形式

cjlistrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜RARの表示名＞ -outbound

実行例

cjlistrar MyServer -resname account-rar -outbound

cjlistrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

4.5.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，デプロイされているInboundリソースアダプタのメッセージリスナのタイプの一覧を参照できます。

実行形式

cjlistrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜RARの表示名＞ -inbound

実行例

cjlistrar MyServer -resname account-rar -inbound

cjlistrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

4.5.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，デプロイされているInboundリソースアダプタのメッセージリスナのアクティブ化に必要なプロパティ名の一覧を参照できます。

実行形式

cjlistrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜RARの表示名＞ -listenertype ＜メッセージリスナのタイプ名＞

実行例

cjlistrar MyServer -resname account-rar -listenertype javax.jms.MessageListener

cjlistrarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

4.6　リソースアダプタの一覧の参照

インポートされているリソースアダプタの一覧を参照できます。また，Connector 1.5の仕様に準拠するリソースアダプタの場合，コネクション定義識別子の一覧や，メッセージリスナのタイプの一覧などの情報も参照できます。

＜この節の構成＞

4.6.1　リソースアダプタの一覧の参照

4.6.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

4.6.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

4.6.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

4.6.1　リソースアダプタの一覧の参照

次に示すコマンドを実行して，インポートされているリソースアダプタの一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar ［-spec］

実行例

cjlistres MyServer -type rar

-specオプションを指定すると，一覧にコネクタアーキテクチャの仕様バージョンが表示されます。

cjlistresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

4.6.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEリソースアダプタとしてデプロイするOutboundリソースアダプタのコネクション定義識別子の一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜RARの表示名＞ -outbound

実行例

cjlistres MyServer -type rar -resname account-rar -outbound

cjlistresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

4.6.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEリソースアダプタとしてデプロイするInboundリソースアダプタのメッセージリスナのタイプの一覧を参照できます。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜RARの表示名＞ -inbound

実行例

cjlistres MyServer -type rar -resname account-rar -inbound

cjlistresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

4.6.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEリソースアダプタとしてデプロイするInboundリソースアダプタのメッセージリスナのアクティブ化に必要なプロパティ名の一覧を参照できます。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜RARの表示名＞ -listenertype ＜メッセージリスナのタイプ名＞

実行例

cjlistres MyServer -type rar -resname account-rar -listenertype javax.jms.MessageListener

cjlistresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

4.7　コネクションプールの状態の確認

リソースアダプタのコネクションプールの情報およびコネクションの状態（使用中，未使用）を参照します。また，必要に応じて，リソースアダプタのコネクションを削除します。

＜この節の構成＞

4.7.1　コネクションプールの状態表示

4.7.2　コネクションプールの削除

4.7.1　コネクションプールの状態表示

次に示すコマンドを使用して，リソースアダプタのコネクションプールの情報および状態を表示します。

実行形式

cjlistpool ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjlistpool MyServer -resname Rar1

cjlistpoolコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistpool（コネクションプールの一覧表示）」を参照してください。

参考

Connector 1.5の仕様に準拠するリソースアダプタの場合，-resnameオプションの＜リソースアダプタの表示名＞は次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

4.7.2　コネクションプールの削除

次に示すコマンドを使用して，リソースアダプタのコネクションプールを削除します。未使用のコネクションプールはすべて削除されます。

実行形式

cjclearpool ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type connector -resname ＜リソースアダプタの表示名＞

実行例

cjclearpool MyServer -type connector -resname Rar1

cjclearpoolコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjclearpool（コネクションプール内のコネクション削除）」を参照してください。

参考

Connector 1.5の仕様に準拠するリソースアダプタの場合，-resnameオプションの＜リソースアダプタの表示名＞は次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

4.8　JNDI名前空間に登録されるリソースアダプタ名の参照と変更

JNDI名前空間に登録されるリソースアダプタ名を変更します。

リソースアダプタ名には別名も付けられます。別名を付けることで，JNDI名前空間から任意の名前でリソースアダプタを参照できるようになります。なお，この機能をユーザ指定名前空間機能といいます。

リソースアダプタのJNDI名前空間については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3　JNDI名前空間へのオブジェクトのバインドとルックアップ」を参照してください。ユーザ指定名前空間機能については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.4　Enterprise BeanまたはJ2EEリソースへの別名付与（ユーザ指定名前空間機能）」を参照してください。

別名は，Connector属性ファイルの<resource-external-property>タグで追加できます。ただし，JMSインタフェースを使用するリソースアダプタには，別名は付与できません。

Connector属性ファイルの<resource-external-property>タグの編集については，使用するリソースアダプタの種類に応じて，「4.2.2　DB Connectorのプロパティ定義」，「4.4.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」または「4.4.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」の別名情報の設定を参照してください。

注意事項

開始状態のJ2EEアプリケーションがある場合，別名を設定しているリソースアダプタの停止および削除はできません。J2EEサーバで開始されているすべてのJ2EEアプリケーションを停止させてください。

4.9　リソースアダプタの削除

次に示すコマンドを実行してリソースアダプタを削除します。

実行形式

cjdeleteres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜リソースアダプタの表示名＞

実行例

cjdeleteres MyServer -type rar -resname account-rar

cjdeleteresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeleteres（リソースの削除）」を参照してください。

注意事項

cosminexus.xmlを含むアプリケーションからJ2EEリソースを削除した場合，cosminexus.xmlに含まれている削除対象のJ2EEリソースに関するCosminexus独自の定義情報は削除されません。cosminexus.xmlを含むアプリケーションからJ2EEリソースを削除する場合の詳細は，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「10.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

4.10　リソースアダプタのコピー

次に示すコマンドを実行してリソースアダプタのプロパティをコピーします。

実行形式

cjcopyres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -src ＜コピー元のリソースアダプタの表示名＞ -dst ＜コピー先のリソースアダプタの表示名＞

実行例

cjcopyres MyServer -type rar -src account-rar -dst account-rar2

cjcopyresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjcopyres（リソースのコピー）」を参照してください。

5.　J2EEアプリケーションに含まれるリソースアダプタの設定

この章では，J2EEアプリケーションに含まれるリソースアダプタのアプリケーション設定操作について説明します。

＜この章の構成＞

5.1　J2EEアプリケーションに含まれるリソースアダプタの設定の概要

5.2　J2EEアプリケーションへのリソースアダプタの追加

5.3　リソースアダプタを含むJ2EEアプリケーションのインポート

5.4　リソースアダプタのプロパティ定義

5.5　リソースアダプタの接続テスト

5.6　リソースアダプタを含むJ2EEアプリケーションの開始と停止

5.7　J2EEアプリケーションに含まれるリソースアダプタの一覧の参照

5.8　コネクションプールの一覧表示と削除

5.1　J2EEアプリケーションに含まれるリソースアダプタの設定の概要

J2EEアプリケーションに含まれるリソースアダプタの設定とは，J2EEアプリケーションに含まれるリソースアダプタを，そのJ2EEアプリケーションで利用できる状態にするための操作です。

J2EEアプリケーションに含めて使用できるリソースアダプタの種類と，アプリケーション設定操作の概要について説明します。

＜この節の構成＞

5.1.1　利用できるリソースアダプタ

5.1.2　設定する項目と操作の概要

5.1.1　利用できるリソースアダプタ

J2EEアプリケーションに含めて利用できるリソースアダプタを次に示します。

DB Connector

uCosminexus TP1 Connector

そのほかのConnector 1.0に準拠したリソースアダプタ，またはConnector 1.5に準拠したリソースアダプタ※

注※　そのほかのConnector 1.0に準拠したリソースアダプタ，またはConnector 1.5に準拠したリソースアダプタについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.3.2　リソースアダプタの種類」を参照してください。

注意

J2EEリソースアダプタとJ2EEアプリケーションに含まれるリソースアダプタは，J2EEアプリケーションから同時に使用できます。ただし，J2EEリソースアダプタとJ2EEアプリケーションに含まれるリソースアダプタを，同じ表示名で同時に使用することはできません。同じ表示名に設定するとエラーとなります。

5.1.2　設定する項目と操作の概要

J2EEアプリケーションに含まれるリソースアダプタの設定の概要について，次の表に示します。

表5-1　J2EEアプリケーションに含まれるリソースアダプタの設定の概要

設定項目
内容
参照先

リソースアダプタを含んだJ2EEアプリケーションの作成※
J2EEアプリケーションへのリソースアダプタの追加
RARファイルをJ2EEサーバにインポートして，J2EEアプリケーションに追加します。
5.2

リソースアダプタを含むJ2EEアプリケーションのインポート
アプリケーション開発環境で作成した，RARファイルを含んだJ2EEアプリケーションをJ2EEサーバにインポートします。
5.3

リソースアダプタのプロパティ定義
データベースとの接続についての情報を設定します。

リソースアダプタの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

5.4

リソースアダプタの接続テスト
リソースアダプタに設定した内容が正しいかどうかを検証します。
5.5

リソースアダプタを含むJ2EEアプリケーションの開始と停止
リソースアダプタを含むJ2EEアプリケーションを開始または停止します。
5.6

J2EEアプリケーションに含まれるリソースアダプタの一覧の参照
J2EEアプリケーションに含まれるリソースアダプタの一覧，コネクション定義識別子の一覧などを参照します。
5.7

コネクションプールの一覧表示と削除
J2EEアプリケーションに含まれるリソースアダプタのコネクションプールの状態を参照します。また，必要に応じてコネクションを削除します。
5.8

注※　リソースアダプタを含んだJ2EEアプリケーションは次のどちらかの方法で作成します。

J2EEアプリケーションにリソースアダプタを追加します。
EJB-JARまたはWARをJ2EEアプリケーションに追加する場合と同じ方法で，RARをJ2EEアプリケーションに追加します。

リソースアダプタを含むJ2EEアプリケーションをインポートします。
アプリケーション開発環境でリソースアダプタを含むJ2EEアプリケーションを成して，そのJ2EEアプリケーションをJ2EEサーバにインポートします。

5.2　J2EEアプリケーションへのリソースアダプタの追加

J2EEアプリケーションにリソースアダプタを追加します。

追加を実行する前に，追加するリソースアダプタと同じ表示名，または同じ別名のリソースアダプタが，デプロイされていないことを確認してください。同じ表示名，または同じ別名のリソースアダプタがデプロイされている場合，そのリソースアダプタはJ2EEアプリケーションに追加できません。なお，別のJ2EEアプリケーションに含まれるリソースアダプタと同じ表示名，別名は使用できます。

手順を次に示します。

リソースアダプタのRARファイルをJ2EEサーバにインポートします。
J2EEアプリケーションに追加するRARファイルのインポートについては，「7.4　リソースアダプタ（RAR）のインポート」を参照してください。

J2EEアプリケーションにインポートしたRARを追加します。
J2EEアプリケーションへのリソースアダプタ（RAR）の追加については，「7.5　J2EEアプリケーションの新規作成」の「(3)　RARファイルの追加」を参照してください。

5.3　リソースアダプタを含むJ2EEアプリケーションのインポート

リソースアダプタを含むJ2EEアプリケーションをインポートします。

インポートを実行する前に，J2EEアプリケーションに含まれるリソースアダプタと同じ表示名，または同じ別名のリソースアダプタが，デプロイされていないことを確認してください。同じ表示名，または同じ別名のリソースアダプタがデプロイされている場合，そのリソースアダプタを含むJ2EEアプリケーションはインポートできません。なお，別のJ2EEアプリケーションに含まれるリソースアダプタと同じ表示名，別名は使用できます。

次のJ2EEアプリケーションをインポートします。

アーカイブ形式のJ2EEアプリケーション
J2EEサーバの作業ディレクトリ以下に，EJB-JAR/WAR/RARファイルのコンポーネントを持つJ2EEアプリケーションです。アーカイブ形式のJ2EEアプリケーションのインポートについては，「8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート」を参照してください。

展開ディレクトリ形式のJ2EEアプリケーション
EJB-JARやWARなどのアプリケーションの実体を，J2EEサーバの外部にある一定のルールに従ったファイル／ディレクトリに持つJ2EEアプリケーションです。ただし，展開ディレクトリ形式のJ2EEアプリケーションに含まれるRARファイルは展開ファイル形式ではなく，アーカイブ形式で格納されます。展開ディレクトリ形式のJ2EEアプリケーションのインポートについては，「8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。

5.4　リソースアダプタのプロパティ定義

J2EEアプリケーションに含まれるリソースアダプタのプロパティを設定します。

リソースアダプタのプロパティの設定は，リソースアダプタを含むJ2EEアプリケーションを停止した状態で実行してください。

プロパティの設定手順については，「3.3　属性ファイルによるプロパティの設定」を参照してください。

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

次のどちらかの属性ファイルを利用して，J2EEアプリケーションに含まれるリソースアダプタのプロパティを設定できます。

Connector属性ファイルを利用します。

アプリケーション統合属性ファイルを利用します。
J2EEアプリケーション統合属性ファイルを構成するコンポーネントの属性ファイルのうち，Connector属性の要素でプロパティを設定します。

J2EEアプリケーションを構成するコンポーネントのプロパティの設定では，Connector属性ファイルとアプリケーション統合属性ファイルを個々に利用することも，あわせて利用することもできます。

この章では，Connector属性ファイルを使用してのプロパティ設定について説明しています。アプリケーション統合属性ファイルを使用してのプロパティ設定の手順については，「9.2　アプリケーション統合属性ファイルによるプロパティ設定」を参照してください。

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してリソースアダプタの属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタ表示名＞ -c ＜Connctor属性ファイルパス＞

実行例

cjgetappprop MyServer -name App1 -type rar -resname account-rar -c AccountProp.xml

●属性の設定

次に示すコマンドを実行して，リソースアダプタの属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタ表示名＞ -c ＜Connector属性ファイルパス＞

実行例

cjsetappprop MyServer -name App1 -type rar -resname account-rar -c AccountProp.xml

(3)　編集する属性設定項目

リソースアダプタの種類に応じて，プロパティを定義します。

Connector 1.0の仕様に準拠するリソースアダプタの場合
Connector 1.0の仕様に準拠するリソースアダプタの属性設定項目については，「4.4.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」の「(3)　編集する属性設定項目」を参照してください。

Connector 1.5の仕様に準拠するリソースアダプタの場合
Connector 1.5の仕様に準拠するリソースアダプタの属性設定項目については，「4.4.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」の「(3)　編集する属性設定項目」を参照してください。

5.5　リソースアダプタの接続テスト

J2EEアプリケーションに含まれるリソースアダプタに設定した情報が正しいかどうか，接続テストによって検証します。

次に示すコマンドを実行してJ2EEアプリケーションに含まれるリソースアダプタの接続テストを実行します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-test］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタの表示名＞

実行例

cjtestres -name App1 -type rar -resname DB_Connector_for_Cosminexus_Driver

J2EEアプリケーションをテストモードにして，リソースアダプタの接続テストを実行する場合は，-testオプションを指定します。

J2EEアプリケーションに含まれるリソースアダプタを接続テストする場合の注意事項については，次の説明を参照してください。

データベースと接続するための設定（DB Connectorを使用する場合）
「4.2.4　DB Connectorの接続テスト」

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）
「4.4.5　J2EEリソースアダプタの接続テスト」

cjtestresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

5.6　リソースアダプタを含むJ2EEアプリケーションの開始と停止

J2EEアプリケーションを開始すると，J2EEアプリケーションに含まれるすべてのリソースアダプタは開始されます。また，J2EEアプリケーションを停止すると，J2EEアプリケーションに含まれるすべてのリソースアダプタは停止されます。リソースアダプタの開始順序および停止順序の制御はできません。

J2EEアプリケーションの開始については，「10.2.1　J2EEアプリケーションの開始」を参照してください。

J2EEアプリケーションの停止については，「10.2.2　J2EEアプリケーションの停止」を参照してください。

注意事項

J2EEアプリケーションがリソースアダプタを含み，application.xmlの<module>タグ以下でRARを記述している場合，EJB-JARやWARが，リソースアダプタを参照していなくても，J2EEアプリケーション開始時にリソースアダプタは開始されます。

5.7　J2EEアプリケーションに含まれるリソースアダプタの一覧の参照

J2EEアプリケーションに含まれるリソースアダプタの一覧を参照できます。また，Connector 1.5の仕様に準拠するリソースアダプタの場合，コネクション定義識別子の一覧や，メッセージリスナのタイプの一覧などの情報も参照できます。

＜この節の構成＞

5.7.1　リソースアダプタの一覧の参照

5.7.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

5.7.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

5.7.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

5.7.1　リソースアダプタの一覧の参照

次に示すコマンドを実行して，J2EEアプリケーションに含まれるリソースアダプタの一覧を参照します。

実行形式

cjlistapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-test］ -name
＜J2EEアプリケーション名＞ -type rar ［-spec］

実行例

cjlistapp MyServer -name App1 -type rar

テストモードのJ2EEアプリケーションに対してコマンドを実行する場合，-testオプションを指定します。

-specオプションを指定すると，一覧にコネクタアーキテクチャの仕様バージョンが表示されます。

cjlistappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

5.7.2　コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEアプリケーションに含まれるOutboundリソースアダプタのコネクション定義識別子の一覧を参照します。

実行形式

cjlistapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-test］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタの表示名＞ -outbound

実行例

cjlistapp MyServer -name App1 -type rar -resname account-rar -outbound

テストモードのJ2EEアプリケーションに対してコマンドを実行する場合，-testオプションを指定します。

cjlistappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

5.7.3　メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEアプリケーションに含まれるInboundリソースアダプタのメッセージリスナのタイプの一覧を参照します。

実行形式

cjlistapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-test］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタの表示名＞ -inbound

実行例

cjlistapp MyServer -name App1 -type rar -resname account-rar -inbound

テストモードのJ2EEアプリケーションに対してコマンドを実行する場合，-testオプションを指定します。

cjlistappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

5.7.4　メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEアプリケーションに含まれるInboundリソースアダプタのメッセージリスナのアクティブ化に必要なプロパティ名の一覧を参照します。

実行形式

cjlistapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-test］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタの表示名＞ -listenertype ＜メッセージリスナのタイプ名＞

実行例

cjlistapp MyServer -name App1 -type rar -resname account-rar -listenertype javax.jms.MessageListener

テストモードのJ2EEアプリケーションに対してコマンドを実行する場合，-testオプションを指定します。

cjlistappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

5.8　コネクションプールの一覧表示と削除

J2EEアプリケーションに含まれるリソースアダプタの，コネクションプールの情報およびコネクションの状態（使用中，未使用）を参照します。また，必要に応じて，リソースアダプタのコネクションを削除します。

＜この節の構成＞

5.8.1　コネクションプールの状態表示

5.8.2　コネクションプールの削除

5.8.1　コネクションプールの状態表示

次に示すコマンドを使用して，J2EEアプリケーションに含まれるリソースアダプタの，コネクションプールの情報および状態を表示します。

実行形式

cjlistpool ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-test］
-name ＜J2EEアプリケーション名＞ -resname ＜リソースアダプタの表示名＞

実行例

cjlistpool MyServer -name App1 -resname Rar1

テストモードのJ2EEアプリケーションに対してコマンドを実行する場合，-testオプションを指定します。

cjlistpoolコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistpool（コネクションプールの一覧表示）」を参照してください。

参考

Connector 1.5の仕様に準拠するリソースアダプタの場合，-resnameオプションの＜リソースアダプタの表示名＞は次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

5.8.2　コネクションプールの削除

次に示すコマンドを使用して，必要に応じて，J2EEアプリケーションに含まれるリソースアダプタのコネクションプールを削除します。なお，未使用のコネクションプールはすべて削除されます。

実行形式

cjclearpool ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type connector ［-test］ -name ＜J2EEアプリケーション名＞ -resname ＜リソースアダプタの表示名＞

実行例

cjclearpool MyServer -type connector -name App1 -resname Rar1

cjclearpoolコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjclearpool（コネクションプール内のコネクション削除）」を参照してください。

参考

Connector 1.5の仕様に準拠するリソースアダプタの場合，-resnameオプションの＜リソースアダプタの表示名＞は次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

6.　リソースアダプタ以外のJ2EEリソースの設定

この章では，サーバ管理コマンドを使用した，リソースアダプタ以外のJ2EEリソースの設定方法について説明します。

＜この章の構成＞

6.1　リソースアダプタ以外のJ2EEリソースの設定概要

6.2　JavaBeansリソースの設定

6.3　メールコンフィグレーションの設定

6.4　J2EEリソース一覧の参照

6.5　JNDI名前空間に登録されるJ2EEリソース名の参照と変更

6.1　リソースアダプタ以外のJ2EEリソースの設定概要

次のJ2EEリソースについて，設定作業の概要を示します。

JavaBeansリソースの設定

メールコンフィグレーションの設定

J2EEリソース共通の設定

＜この節の構成＞

6.1.1　JavaBeansリソースの設定の概要

6.1.2　メールコンフィグレーションの設定の概要

6.1.3　J2EEリソース共通の設定の概要

6.1.1　JavaBeansリソースの設定の概要

JavaBeansリソースを利用する場合に必要な設定です。

表6-1　JavaBeansリソースの設定の概要

設定項目 | 内容 | 参照先
JavaBeansリソースのインポート | JavaBeansリソースをインポートして，JavaBeansリソース属性の値を設定します。 | 6.2.1
JavaBeansリソースのプロパティの定義 | JavaBeansリソースの実行に必要な情報を設定します。 | 6.2.2
JavaBeansリソースの開始 | JavaBeansリソースを開始します。 | 6.2.3
JavaBeansリソースの停止 | JavaBeansリソースを停止します。 | 6.2.4
JavaBeansリソースの削除 | JavaBeansリソースを削除します。JavaBeansリソースを入れ替える場合は，必要に応じて実行してください。 | 6.2.5
JavaBeansリソースの状態表示 | インポートされているすべてのJavaBeansリソースの状態を表示します。 | 6.2.6

6.1.2　メールコンフィグレーションの設定の概要

JavaMailを使用してSMTPサーバに接続する場合に必要な設定です。メールサーバおよびメールのヘッダに入れる情報を設定します。

表6-2　メールコンフィグレーションの設定の概要

設定項目
内容
参照先

メールコンフィグレーションの新規作成
メールコンフィグレーションを新規作成します。
6.3.1

メールコンフィグレーションのプロパティ定義
メールコンフィグレーションの次の情報を設定します。

SMTPメールサーバのホスト名またはIPアドレス

メールのヘッダに入れる情報

6.3.2

メールコンフィグレーションの接続テスト
メールコンフィグレーションに設定した内容が正しいかどうかを検証します。
6.3.3

メールコンフィグレーションの削除
作成したメールコンフィグレーションを削除します。
6.3.4

メールコンフィグレーションのコピー
メールコンフィグレーションのプロパティをコピーします。
6.3.5

6.1.3　J2EEリソース共通の設定の概要

J2EEリソースに共通の設定です。

表6-3　J2EEリソースに共通な設定の概要

設定項目
内容
参照先

J2EEリソース一覧の参照
次のJ2EEリソースについて一覧を参照します。

EJB-JARファイルに含まれるJ2EEリソース

WARファイルに含まれるJ2EEリソース

メールコンフィグレーション

6.4

JNDI名前空間に登録されるJ2EEリソース名の参照と変更
J2EEリソースのJNDI名前空間への登録名を参照して，必要に応じて別名を付与します。
6.5

6.2　JavaBeansリソースの設定

JavaBeansリソースの設定とはJavaBeansリソースを利用できる状態にすることです。

JavaBeansリソースの設定をするには，あらかじめ，JavaBeansリソース属性ファイルのテンプレートファイルを参考に，JavaBeansリソース属性ファイルを編集しておいてください。JavaBeansリソース属性ファイルのテンプレートファイル（jb_template.xml）は，次のディレクトリに格納されています。

Windowsの場合

＜Cosminexusのインストールディレクトリ＞¥CC¥admin¥templates¥

UNIXの場合

/opt/Cosminexus/CC/admin/templates/

JavaBeansリソースは，次の手順で設定します。

JavaBeansリソースを新規に設定する場合

JavaBeansリソースをインポートします。

JavaBeansリソースを開始します。

JavaBeansリソースのプロパティ属性を変更する場合

JavaBeansリソースを停止します。

JavaBeansリソースのプロパティ定義を変更します。

JavaBeansリソースを開始します。

JavaBeansリソースを入れ替える場合

JavaBeansリソースを停止します。

J2EEサーバを再起動します。

JavaBeansリソースを削除します。

JavaBeansリソースをインポートします。

JavaBeansリソースを開始します。

＜この節の構成＞

6.2.1　JavaBeansリソースのインポート

6.2.2　JavaBeansリソースのプロパティ定義

6.2.3　JavaBeansリソースの開始

6.2.4　JavaBeansリソースの停止

6.2.5　JavaBeansリソースの削除

6.2.6　JavaBeansリソースの状態表示

6.2.1　JavaBeansリソースのインポート

次に示すコマンドを実行してJavaBeansリソースをインポートします。

実行形式

cjimportjb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -f ＜JARファイルパス＞ -c ＜JavaBeansリソース属性ファイルパス＞

実行例

cjimportjb MyServer -f Myjavabeans.jar -c Myjavabeansprop.xml

JavaBeansリソースは，cjimportjbコマンドの-dオプションで，ディレクトリパスを指定すると，次のようにインポートすることもできます。

アーカイブの作成をしないで，ディレクトリ構成でインポートします。

指定したディレクトリ下のすべてのアーカイブされたJavaBeansリソースをインポートします。

コマンドの指定方法を次に示します。

実行形式

cjimportjb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -d ＜ディレクトリパス＞ -c ＜JavaBeansリソース属性ファイルパス＞

実行例

cjimportjb MyServer -d MydirectoryPath -c Myjavabeansprop.xml

cjimportjbコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportjb（JavaBeansリソースのインポート）」を参照してください。

注意事項

cjimportjbコマンドの-dオプションには，インポートするディレクトリの最上位を指定してください。また，指定したディレクトリ下にあるすべてのファイルがインポートされるので，不要なファイルは指定したディレクトリ内に含めないようにしてください。

6.2.2　JavaBeansリソースのプロパティ定義

JavaBeansリソースのプロパティを定義します。

プロパティの設定手順の概要については，「3.3　属性ファイルによるプロパティの設定」を参照してください。次にJavaBeansリソースのプロパティ定義について説明します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

JavaBeansリソース属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行して，JavaBeansリソース属性ファイルを取得します。

実行形式

cjgetjbprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜JavaBeansリソース表示名＞ -c ＜JavaBeansリソース属性ファイルパス＞

実行例

cjgetjbprop MyServer -resname MyJavaBeansName -c MyJavaBeansProp.xml

●属性の設定

次に示すコマンドを実行して，JavaBeansリソース属性ファイルの値を反映します。

実行形式

cjsetjbprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜JavaBeansリソース表示名＞ -c ＜JavaBeansリソース属性ファイルパス＞

実行例

cjsetjbprop MyServer -resname MyJavaBeansName -c MyJavaBeansProp.xml

(3)　編集する属性設定項目

JavaBeansリソースのプロパティ設定項目を次に示します。

実行時プロパティ

別名情報

(a)　実行時プロパティ

JavaBeansリソースの実行時プロパティ（<property>タグ）の設定項目を次に示します。

項目 | 対応するタグ
プロパティ名 | <property-name>
プロパティのデータ型 | <property-type>
プロパティの値 | <property-value>

定義するプロパティの数だけ，上記の設定を繰り返してください。

プロパティ名（<property-name>）の設定項目に，JavaBeansリソースのsetメソッドやgetメソッドのメソッド名を指定します。プロパティ名（<property-name>）の設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.13　<property>タグに指定できるプロパティ」を参照してください。

(b)　別名情報

JavaBeansリソースの別名情報（<resource-env-external-property>タグ）の別名（<optional-name>）を設定します。

JavaBeansリソースの別名の使用法については，「6.5　JNDI名前空間に登録されるJ2EEリソース名の参照と変更」を参照してください。

6.2.3　JavaBeansリソースの開始

次に示すコマンドを実行してJavaBeansリソースを開始します。

実行形式

cjstartjb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜JavaBeansリソース表示名＞

実行例

cjstartjb MyServer -resname javabeansname

cjstartjbコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartjb（JavaBeansリソースの開始）」を参照してください。

6.2.4　JavaBeansリソースの停止

次に示すコマンドを実行してJavaBeansリソースを停止します。

実行形式

cjstopjb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜JavaBeansリソース表示名＞

実行例

cjstopjb MyServer -resname javabeansname

cjstopjbコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstopjb（JavaBeansリソースの停止）」を参照してください。

注意事項

JavaBeansリソースを停止する前に，停止するJavaBeansリソースを使用しているアプリケーションはすべて停止させてください。

6.2.5　JavaBeansリソースの削除

インポートされているJavaBeansリソースを削除します。

準備

JavaBeansリソースを削除する前に，JavaBeansリソースを停止してJ2EEサーバを再起動してください。

次に示すコマンドを実行してJavaBeansリソースを削除します。

実行形式

cjdeletejb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜JavaBeansリソース表示名＞

実行例

cjdeletejb MyServer -resname MyJavaBeans

cjdeletejbコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeletejb（JavaBeansリソースの削除）」を参照してください。

6.2.6　JavaBeansリソースの状態表示

すべてのJavaBeansリソースのJavaBeansリソース名と状態（開始状態または停止状態）を表示します。

次に示すコマンドを実行してJavaBeansリソースの状態を表示します。

実行形式

cjlistjb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］

実行例

cjlistjb MyServer

cjlistjbコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistjb（JavaBeansリソースの一覧表示）」を参照してください。

6.3　メールコンフィグレーションの設定

JavaMailを使用してSMTPサーバに接続する場合に必要な設定です。

＜この節の構成＞

6.3.1　メールコンフィグレーションの新規作成

6.3.2　メールコンフィグレーションのプロパティ定義

6.3.3　メールコンフィグレーションの接続テスト

6.3.4　メールコンフィグレーションの削除

6.3.5　メールコンフィグレーションのコピー

6.3.1　メールコンフィグレーションの新規作成

メールコンフィグレーションを新規作成します。

次に示すコマンドを実行してメール属性ファイルを基にメールコンフィグレーションを新規作成します。

実行形式

cjsetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -resname ＜メールの表示名＞ -c ＜メール属性ファイルパス＞

実行例

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

cjsetrespropコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetresprop（リソースの属性設定）」を参照してください。属性ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.6　メール属性ファイル」を参照してください。

6.3.2　メールコンフィグレーションのプロパティ定義

メールコンフィグレーションのプロパティを定義します。新規作成時に定義した内容を変更できます。

プロパティの設定手順の概要については，「3.3　属性ファイルによるプロパティの設定」を参照してください。次にメールコンフィグレーションのプロパティ定義について説明します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

メール属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してメール属性ファイルを取得します。

実行形式

cjgetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -resname ＜メールの表示名＞ -c ＜メール属性ファイルパス＞

実行例

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

●属性の設定

次に示すコマンドを実行して，メール属性ファイルを反映します。

実行形式

cjsetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -resname ＜メールの表示名＞ -c ＜メール属性ファイルパス＞

実行例

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

(3)　編集する属性設定項目

メールコンフィグレーションのプロパティ設定項目を次に示します。

項目 | 対応するタグ
Eメール送信者のEメールアドレス | <from>
SMTPメールサーバのホスト名，またはIPアドレス | <server>
別名情報※ | <resource-external-property>

注※　別名情報（<resource-external-property>）には，次の項目を設定します。

別名情報の項目 | 必須 | 対応するタグ
リソースの別名 | ○ | <optional-name>
リソース認証方式 | △ | <res-auth>
リソース共有の有無 | △ | <res-sharing-scope>

（凡例）○：必須　△：任意

プロパティの設定項目の説明については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.6　メール属性ファイル」を参照してください。

6.3.3　メールコンフィグレーションの接続テスト

メールコンフィグレーションに設定した内容が正しいかどうか，メールサーバのコネクションをチェックします。

次に示すコマンドを実行してメールコンフィグレーションの接続テストを実施します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -resname ＜メールコンフィグレーションの表示名＞

実行例

cjtestres MyServer -type mail -resname Mymail1

cjtestresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

6.3.4　メールコンフィグレーションの削除

次に示すコマンドを実行してメールコンフィグレーションを削除します。

実行形式

cjdeleteres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -resname ＜メールコンフィグレーションの表示名＞

実行例

cjdeleteres MyServer -type mail -resname Mail

cjdeleteresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeleteres（リソースの削除）」を参照してください。

6.3.5　メールコンフィグレーションのコピー

次に示すコマンドを実行してメールコンフィグレーションのプロパティをコピーします。

実行形式

cjcopyres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -src ＜コピー元のメールコンフィグレーションの表示名＞ -dst ＜コピー先のメールコンフィグレーションの表示名＞

実行例

cjcopyres MyServer -type mail -src Mail -dst Mail2

cjcopyresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjcopyres（リソースのコピー）」を参照してください。

6.4　J2EEリソース一覧の参照

J2EEリソースについて，次の一覧を参照します。

インポートされているEJB-JARと，EJB-JARに含まれるJ2EEリソース

インポートされているWARと，WARに含まれるJ2EEリソース

インポートされているメールコンフィグレーション

＜この節の構成＞

(1)　EJB-JARファイルに含まれるJ2EEリソースの一覧の参照

(2)　WARファイルに含まれるJ2EEリソースの一覧の参照

(3)　メールコンフィグレーションの一覧の参照

(1)　EJB-JARファイルに含まれるJ2EEリソースの一覧の参照

次に示すコマンドを実行して，EJB-JARファイルに含まれるJ2EEリソースの一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type ejb ［-resname ＜EJB-JARファイルの表示名＞］

-resnameオプションを指定すると，特定のEJB-JARファイルに含まれるリソース（SessionBean，EntityBean，MessageDrivenBean）の一覧が表示されます。

-resnameオプションを指定しないと，インポートされているEJB-JARファイルの一覧が表示されます。

実行例

cjlistres MyServer -type ejb

(2)　WARファイルに含まれるJ2EEリソースの一覧の参照

次に示すコマンドを実行して，WARファイルに含まれるJ2EEリソースの一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type war ［-resname ＜WARファイルの表示名＞］

-resnameオプションを指定すると，特定のWARファイルに含まれるリソース（サーブレット，JSPおよびフィルタ）の一覧が表示されます。

-resnameオプションを指定しないと，インポートされているWARファイルの一覧が表示されます。

実行例

cjlistres MyServer -type war

(3)　メールコンフィグレーションの一覧の参照

次に示すコマンドを実行して，インポートされているメールコンフィグレーションの一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail

実行例

cjlistres MyServer -type mail

cjlistresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

6.5　JNDI名前空間に登録されるJ2EEリソース名の参照と変更

JNDI名前空間に登録されるJ2EEリソース名を変更します。

J2EEリソース名には別名も付けられます。別名を付けることで，JNDI名前空間から任意の名前でJ2EEリソースを参照できるようになります。なお，この機能をユーザ指定名前空間機能といいます。

なお，J2EEリソースのJNDI名前空間については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3　JNDI名前空間へのオブジェクトのバインドとルックアップ」を参照してください。ユーザ指定名前空間機能については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.4　Enterprise BeanまたはJ2EEリソースへの別名付与（ユーザ指定名前空間機能）」を参照してください。

別名は，次の属性ファイルに追加できます。

属性ファイル | 対応するタグ名
メール属性ファイル | <resource-external-property>
JavaBeansリソース属性ファイル | <resource-env-external-property>

メール属性ファイルの<resource-external-property>タグの編集については，「6.3.2　メールコンフィグレーションのプロパティ定義」を，JavaBeansリソース属性ファイルの<resource-env-external-property>タグの編集については，「6.2.2　JavaBeansリソースのプロパティ定義」の別名情報の設定を参照してください。

注意事項

開始状態のJ2EEアプリケーションがある場合，別名を設定しているJ2EEリソースの停止および削除はできません。J2EEサーバで開始されているすべてのJ2EEアプリケーションを停止させてください。

7.　J2EEアプリケーションの作成

この章では，サーバ管理コマンドを使用したJ2EEアプリケーションの作成方法について説明します。

＜この章の構成＞

7.1　J2EEアプリケーションの作成の概要

7.2　Enterprise Bean（EJB-JAR）のインポート

7.3　サーブレットとJSP（WAR）のインポート

7.4　リソースアダプタ（RAR）のインポート

7.5　J2EEアプリケーションの新規作成

7.6　J2EEアプリケーションへのライブラリJARファイルの追加

7.7　ライブラリJARファイルの一覧の参照

7.8　J2EEアプリケーションからのライブラリJARファイルの削除

7.9　J2EEアプリケーションへの参照ライブラリの設定

7.1　J2EEアプリケーションの作成の概要

J2EEアプリケーションの作成とは，アプリケーション開発環境で作成したEnterprise Bean（EJB-JAR）およびサーブレットとJSP（WAR）を，一つのJ2EEアプリケーション（EAR）にすることです。また，J2EEアプリケーションに，そのJ2EEアプリケーションで使用するリソースアダプタを含めることもできます。

J2EEアプリケーションの作成に必要な作業の概要を次の表に示します。

表7-1　J2EEアプリケーションの作成で実施する作業

実施項目
内容
参照先

Enterprise Bean（EJB-JAR）のインポート
J2EEアプリケーションの構成にEnterprise Bean（EJB-JAR）が含まれる場合に必要な作業です。
J2EEサーバにEnterprise Beanをインポートします。
7.2

サーブレットとJSP（WAR）のインポート
J2EEアプリケーションの構成にサーブレット・JSP（WAR）が含まれる場合に必要な作業です。
J2EEサーバにサーブレット・JSPをインポートします。
7.3

リソースアダプタ（RAR）のインポート
J2EEアプリケーションにリソースアダプタ（RAR）を含める場合，含めるリソースアダプタをJ2EEサーバにインポートします。
7.4

J2EEアプリケーションの新規作成
インポートしたEJB-JAR，WARを基にEARを作成します。また，必要に応じて，J2EEアプリケーションにRARを含めます。
7.5

J2EEアプリケーションへのライブラリJARファイルの追加
J2EEアプリケーションにライブラリJAR（ファイル拡張子は小文字の「.jar」）を追加します。
7.6

ライブラリJARファイルの一覧の参照
J2EEアプリケーションに含まれているライブラリJARファイルの一覧を参照します。
7.7

J2EEアプリケーションからのライブラリJARファイルの削除
J2EEアプリケーションに含まれているライブラリJARファイルを削除します。
7.8

J2EEアプリケーションへの参照ライブラリの設定
J2EEアプリケーションに参照ライブラリを設定します。
7.9

J2EEアプリケーションのプロパティの設定
作成したJ2EEアプリケーションのプロパティを設定します。
9.

J2EEアプリケーションの実行
設定が完了したJ2EEアプリケーションを実行します。また，運用に応じて，停止します。
10.

cosminexus.xmlを使用したJ2EEアプリケーションを作成する場合は，あらかじめ作成したcosminexus.xmlを，EJB-JAR，WARなどと一緒にJ2EEアプリケーションに含めて使用してください。

ライブラリJARと参照ライブラリは，J2EEアプリケーション内の各モジュールから参照できる共通ライブラリです。

ライブラリJARと参照ライブラリの特長を次に示します。

ライブラリJAR

J2EEアプリケーションにJAR（ファイル拡張子は小文字の「.jar」）を含めます。

複数のJ2EEアプリケーションで使用する場合，それぞれのJ2EEアプリケーションに追加する必要があります。

classファイルを含めることはできません。必ずJARファイル形式にまとめて使用します。

参照ライブラリ

参照するライブラリファイルの絶対パスを指定します。

複数のJ2EEアプリケーションで使用する場合，同じ参照先を指定するだけで利用できます。

JARファイル，classファイルどちらも扱うことができます。

7.2　Enterprise Bean（EJB-JAR）のインポート

EJBコンポーネントを利用してJ2EEアプリケーションを実行する前に，Enterprise Bean（EJB-JAR）をインポートします。インポートできるのは，EJB 1.1，2.0，2.1，または3.0の仕様に準拠したDDを持つEJB-JAR，またはアノテーションを使用したEJB-JARです。

なお，次のディレクトリにEJBの各種サンプルプログラムが格納されています。

Windowsの場合

＜Cosminexusのインストールディレクトリ＞¥CC¥examples¥

UNIXの場合

/opt/Cosminexus/CC/examples/

DDを持ったEJB-JARの場合，DDがDTDに従っていることを確認してから，インポートを実行してください。DDがDTDの仕様に従っていないEJB-JARをインポートした場合，メッセージが出力されます。メッセージが出力された場合は，マニュアル「Cosminexus アプリケーションサーバ メッセージ 2」を参照してください。

次に示すコマンドを実行してEJB-JARをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type ejb -f ＜EJB-JARファイルパス＞

実行例

cjimportres MyServer -type ejb -f account.jar

cjimportresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

注意事項

DDのバージョンが1.1のEJB-JARをインポートすると，J2EEサーバ内でDDのバージョンが2.0に変更されます。

EJB 1.1，2.0，2.1，または3.0の仕様に準拠しないDDを持つEJB-JARはインポートできません。

「hitachi-runtime.jar」の名称のEJB-JARはインポートしないでください。

インポート時に指定したJARファイル名は作業ディレクトリ中のディレクトリ名として使用されます。また，JARファイル中に，ホームインタフェースなど，java.rmi.Remoteを実装したクラスがあると，usrconf.propertiesファイルの定義内容に応じて，デプロイ・スタート時に作業ディレクトリ内にスタブが生成されます。デフォルトの設定の場合，スタブは，ejb-jar.xmlの<remote>および<home>に記述されたインタフェースに対して作成されます。usrconf.propertiesファイルのejbserver.deploy.stub.generation.scopeキーにappを指定した場合は，JARファイルに含まれるリモートインタフェースを実装したすべてのインタフェースのスタブが生成されます。
これらのことを考慮して，作業ディレクトリのパス長がプラットフォームの上限に達しないようにJARファイル名およびjava.rmi.Remoteを実装したクラスのパッケージ名やクラス名を指定してください。
作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

7.3　サーブレットとJSP（WAR）のインポート

J2EEサーバモードでWebコンポーネントを利用してJ2EEアプリケーションを実行する前に，サーブレットおよびJSP（WAR）をインポートします。

なお，インポートできるのは，Servlet 2.2，2.3，2.4，または2.5の仕様に準拠したDDを持つWAR，またはアノテーションを指定したWARです。このため，DDがDTDに従っていることを確認してから，インポートを実行してください。DDがDTDの仕様に従っていないWARをインポートした場合，メッセージが出力されます。メッセージが出力された場合は，マニュアル「Cosminexus アプリケーションサーバ メッセージ 2」を参照してください。

次に示すコマンドを実行してWARをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type war -f ＜WARファイルパス＞

実行例

cjimportres MyServer -type war -f account.war

cjimportresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

注意事項

DDのバージョンが2.2のWARをインポートするとJ2EEサーバ内でDDのバージョンが2.3に変更されます。

Servlet 2.2，2.3，2.4，または2.5の仕様に準拠しないDDを持つWARはインポートできません。

インポート時に指定したWARファイル名は作業ディレクトリ中のディレクトリ名として使用されます。また，WARファイル内のファイルは，デプロイ・スタート時に作業ディレクトリ内に展開されます。WARファイル内に，ホームインタフェースなど，java.rmi.Remoteを実装したクラスがあると，usrconf.propertiesファイルの定義内容に応じて，デプロイ・スタート時に作業ディレクトリ内にスタブが生成されます。usrconf.propertiesファイルのejbserver.deploy.stub.generation.scopeキーにappを指定した場合は，WARファイルに含まれるリモートインタフェースを実装したすべてのインタフェースのスタブが生成されます。
これらのことを考慮して，作業ディレクトリのパス長がプラットフォームの上限に達しないようにWARファイル名，WARファイル中のパッケージ名やクラス名およびjava.rmi.Remoteを実装したクラスのパッケージ名やクラス名を指定してください。
作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

「hitachi-runtime.jar」の名称のWARはインポートしないでください。

7.4　リソースアダプタ（RAR）のインポート

J2EEアプリケーションに含めるリソースアダプタ（RAR）をインポートします。J2EEアプリケーションにリソースアダプタを含めると，同じJ2EEアプリケーションのEnterprise Bean（EJB-JAR），サーブレットおよびJSP（WAR）からリソースアダプタが使用できます。

インポートできるリソースアダプタについては，「5.1.1　利用できるリソースアダプタ」を参照してください。

次に示すコマンドを実行してRARをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -f ＜RARファイルパス＞

実行例

cjimportres MyServer -type rar -f account.rar

cjimportresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

注意事項

Connector 1.0以降の仕様に準拠するDDを持つRARであることを確認してから，インポートを実行してください。J2EE Connector 1.0以降の仕様に準拠しないDDを持つRARはインポートできません。

7.5　J2EEアプリケーションの新規作成

インポートしたEJB-JAR，WARを基にJ2EEアプリケーションを作成します。また，EJB-JAR，WARで使用するRARを追加します。

＜この節の構成＞

(1)　EJB-JARファイルの追加

(2)　WARファイルの追加

(3)　RARファイルの追加

(4)　注意事項

(1)　EJB-JARファイルの追加

次に示すコマンドを実行してEJB-JARファイルを追加します。J2EEアプリケーションがない場合は，J2EEアプリケーションが新規作成されます。

実行形式

cjaddapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type ejb -name ＜J2EEアプリケーション名＞ -resname ＜EJB-JAR表示名＞

実行例

cjaddapp MyServer -type ejb -name adder -resname adder

cjaddappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjaddapp（リソースの追加）」を参照してください。

(2)　WARファイルの追加

次に示すコマンドを実行してWARファイルを追加します。J2EEアプリケーションがない場合は，J2EEアプリケーションが新規作成されます。

実行形式

cjaddapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type war -name ＜J2EEアプリケーション名＞ -resname ＜WAR表示名＞

実行例

cjaddapp MyServer -type war -name adder -resname adder_war

cjaddappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjaddapp（リソースの追加）」を参照してください。

(3)　RARファイルの追加

次に示すコマンドを実行してRARファイルを追加します。J2EEアプリケーションがない場合は，J2EEアプリケーションが新規作成されます。

実行形式

cjaddapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -name ＜J2EEアプリケーション名＞ -resname ＜RAR表示名＞

実行例

cjaddapp MyServer -type rar -name adder -resname account-rar

cjaddappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjaddapp（リソースの追加）」を参照してください。

(4)　注意事項

J2EEアプリケーション作成時には，EJBホームオブジェクトのJNDI名前空間（HITACHI_EJB/SERVERS/＜サーバ名称＞/EJB/＜J2EE APP名称＞/＜Enterprise Bean名称＞）の＜J2EE APP名称＞に該当する名前が自動的に割り当てられます。JNDI名前空間については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3　JNDI名前空間へのオブジェクトのバインドとルックアップ」を参照してください。

展開ディレクトリ形式のアプリケーションに対しては，EJB-JARファイル，WARファイルおよびRARファイルの追加はできません。

拡張子が".jar"ではないEJB-JARファイル，拡張子が".war"ではないWARファイル，および拡張子が".rar"ではないRARファイルは，application.xmlを省略したアプリケーションに追加できません。

フィルタは，web.xmlを省略したWARファイルに追加できません。

J2EEアプリケーション名には，半角英数字（0～9，A～Z，a～z），アンダースコア（_）だけを指定してください。

J2EEアプリケーションを作成したあとでは，J2EEアプリケーション名を変更できません。

J2EEアプリケーションを含んだまま06-50よりも前のバージョンからアップグレードインストールした場合，Display nameに指定した名前が作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにDisplay nameを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

7.6　J2EEアプリケーションへのライブラリJARファイルの追加

J2EEアプリケーションにライブラリJARファイルを追加します。

次に示すコマンドを実行してJ2EEアプリケーションへライブラリJARファイルを追加します。

実行形式

cjimportlibjar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -f ＜ライブラリJAR名＞

実行例

cjimportlibjar MyServer -name App1 -f applib.jar

cjimportlibjarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportlibjar（ライブラリJARのインポート）」を参照してください。

注意事項

インポート時に指定したJARファイル名は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにJARファイル名を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

ライブラリJARファイルの拡張子には小文字の「.jar」を指定してください。

展開ディレクトリ形式のJ2EEアプリケーションへのライブラリJARの追加・削除はできません。

「hitachi-runtime.jar」の名称のライブラリJARはインポートしないでください。

7.7　ライブラリJARファイルの一覧の参照

J2EEアプリケーションにインポートされているライブラリJARファイルの一覧を参照します。

次に示すコマンドを実行してJ2EEアプリケーションにインポートされているライブラリJARファイルの一覧を参照します。

実行形式

cjlistlibjar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞

実行例

cjlistlibjar MyServer -name App1

cjlistlibjarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistlibjar（ライブラリJARの一覧表示）」を参照してください。

7.8　J2EEアプリケーションからのライブラリJARファイルの削除

J2EEアプリケーションにインポートされているライブラリJARファイルを削除します。

次に示すコマンドを実行してJ2EEアプリケーションからライブラリJARファイルを削除します。

実行形式

cjdeletelibjar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -f ＜ライブラリJARファイル名称＞

実行例

cjdeletelibjar MyServer -name App1 -f applib.jar

cjdeletelibjarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeletelibjar（ライブラリJARの削除）」を参照してください。

注意事項

展開ディレクトリ形式のJ2EEアプリケーションへのライブラリJARの追加・削除はできません。

7.9　J2EEアプリケーションへの参照ライブラリの設定

J2EEアプリケーションに参照ライブラリを設定します。

J2EEアプリケーションへの参照ライブラリの設定は，J2EEアプリケーション属性ファイルで設定します。プロパティを設定する手順については，「3.3　属性ファイルによるプロパティの設定」を参照してください。

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

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

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してアプリケーション属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -c ＜アプリケーション属性ファイルパス＞

実行例

cjgetappprop MyServer -name App1 -c C:¥home¥app1.xml

●属性の設定

次に示すコマンドを実行してアプリケーション属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -c ＜アプリケーション属性ファイルパス＞

実行例

cjsetappprop MyServer -name App1 -c C:¥home¥app1.xml

(3)　編集する属性設定項目

参照するライブラリJARの指定（<ref-libraries>）のクラスパス（<classpath>）を設定します。

ここで設定した参照ライブラリのクラスを属性ファイルの中で指定する場合，サーバ管理コマンドを実行するマシン上にその参照ライブラリファイルをコピーし，サーバ管理コマンド用オプション定義ファイルのUSRCONF_JVM_CLASSPATHに，コピーした参照ライブラリファイルのパスを設定する必要があります。

8.　J2EEアプリケーションのインポートとエクスポート

この章では，サーバ管理コマンドを使用したJ2EEアプリケーションのインポートとエクスポートの方法について説明します。

＜この章の構成＞

8.1　J2EEアプリケーションのインポート

8.2　J2EEアプリケーションのエクスポート

8.1　J2EEアプリケーションのインポート

J2EEアプリケーションをインポートします。インポートできるのは，J2EEアプリケーション 1.2，1.3，1.4，およびJava EE 5の仕様に準拠したDDを持つJ2EEアプリケーション，またはアノテーションを使用したJ2EEアプリケーションです。DDを持ったJ2EEアプリケーションの場合，EAR，EJB-JAR，WAR，およびRARのDDがDTDに従っていることを確認してから，インポートを実行してください。

インポートするJ2EEアプリケーションには，次の形式があります。

アーカイブ形式のJ2EEアプリケーション
J2EEサーバの作業ディレクトリ以下に，EJB-JAR/WAR/RARファイルのコンポーネントを持つJ2EEアプリケーションです。

展開ディレクトリ形式のJ2EEアプリケーション
J2EEサーバの外部に置かれている構成ファイルを，論理的なJ2EEアプリケーションとして使用するJ2EEアプリケーションです。また，リロードによるJ2EEアプリケーションの入れ替えを実施する場合は，この形式でのインポートが必要になります。J2EEアプリケーションの入れ替えについては，「10.6　J2EEアプリケーションの入れ替え」を参照してください。

＜この節の構成＞

8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート

8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート

8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート

次に示すコマンドを実行して，アーカイブ形式のJ2EEアプリケーションをインポートします。

実行形式

cjimportapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -f ＜EARファイルのパス＞

実行例

cjimportapp MyServer -f C:¥home¥bank.ear

cjimportappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportapp（J2EEアプリケーションのインポート）」を参照してください。

＜この項の構成＞

(1)　実行時情報に関する注意事項

(2)　EARのDDに関する注意事項

(3)　そのほかの注意事項

(1)　実行時情報に関する注意事項

実行時情報はCosminexusのJ2EEサーバ独自の情報です。次の情報が含まれています。

表8-1　実行時情報一覧

項目
情報

J2EEアプリケーションの状態
開始／停止状態の情報

J2EEアプリケーションの各種設定

Enterprise Beanの実行時プロパティ

各種リファレンスとJ2EEリソースのマッピング

CMPフィールドのデータベースのマッピング

など

自動生成実装クラス

EJBホームオブジェクト

EJBオブジェクト

リモートインタフェースのstubクラス，tieクラス

EJBホームオブジェクト

EJBオブジェクト

実行時情報付きEARファイルをインポートした場合の注意事項を，次に説明します。

エクスポートされたときのJ2EEアプリケーションの状態が復元されます。したがって，開始済みのJ2EEアプリケーションをインポートした場合，すぐにJ2EEアプリケーションが開始されます。

J2EEアプリケーションの各種設定が復元されます。インポートするJ2EEサーバ上に，エクスポートしたJ2EEサーバと同じ名称でJ2EEリソースアダプタ，JDBCデータソース，またはJavaMailコンフィグレーションを作成しておくと，インポート時に参照が解決されます。このため，開始済みのJ2EEアプリケーションをインポートする場合は，エクスポートしたJ2EEサーバと同じ名称でJ2EEリソースアダプタ，JDBCデータソースまたはJavaMailコンフィグレーションを事前に作成しておいてください。また，J2EEリソースアダプタを開始させた状態で，J2EEアプリケーションをインポートしてください。

実行時情報付きEARファイルに含まれる，自動生成実行クラス，リモートインタフェースのstubクラス，tieクラスは再利用されます。ただし，旧バージョンでエクスポートしたEARファイルをインポートした場合は，再作成されます。

実行環境情報ファイルは変更しないようにしてください。

(2)　EARのDDに関する注意事項

J2EEアプリケーション 1.2，1.3，1.4，およびJava EE 5の仕様に準拠しないDDを持つEARはインポートできません。

DDのバージョンが古い場合，バージョンを次のように変更します。

表8-2　DDのバージョンの変更

DD | インポート前のバージョン | インポート後のバージョン
application.xml | 1.2 | 1.4
1.3
ejb-jar.xml | 1.1 | 2.0
web.xml | 2.2 | 2.3

(3)　そのほかの注意事項

インポートするファイルが，J2EEサーバからエクスポートしたJ2EEアプリケーションでない場合，次の名称のファイルを含めないでください。

hitachi-runtime.jar

rar.properties

fileinfo.properties

META-INF/hitachi-ra.xml

J2EEアプリケーション開始時には，EJBホームオブジェクトのJNDI名前空間（HITACHI_EJB/SERVERS/＜サーバ名称＞/EJB/＜J2EE APP名称＞/＜Enterprise Bean名称＞）の＜J2EE APP名称＞に該当する名前が自動的に割り当てられます。JNDI名前空間については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3　JNDI名前空間へのオブジェクトのバインドとルックアップ」を参照してください。

EARファイル中のEJB-JARファイル名は作業ディレクトリ中のディレクトリ名として使用されます。また，EJB-JARファイル中に，ホームインタフェースなど，java.rmi.Remoteを実装したクラスがあると，usrconf.propertiesファイルの定義内容に応じて，デプロイ・スタート時に作業ディレクトリ内にスタブが生成されます。デフォルトの設定の場合，スタブは，ejb-jar.xmlの<remote>および<home>に記述されたインタフェースに対して作成されます。usrconf.propertiesファイルのejbserver.deploy.stub.generation.scopeキーにappを指定した場合は，EJB-JARファイルに含まれるリモートインタフェースを実装したすべてのインタフェースのスタブが生成されます。
これらのことを考慮して，作業ディレクトリのパス長がプラットフォームの上限に達しないようにEJB-JARファイル名，java.rmi.Remoteを実装したクラスのパッケージ名，およびクラス名を指定してください。
なお，作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

EARファイル中のWARファイル名は作業ディレクトリ中のディレクトリ名として使用されます。また，WARファイル内のファイルは作業ディレクトリ内に展開されます。WARファイル中に，ホームインタフェースなど，java.rmi.Remoteを実装したクラスがあると，usrconf.propertiesファイルの定義内容に応じて，デプロイ・スタート時に作業ディレクトリ内にスタブが生成されます。usrconf.propertiesファイルのejbserver.deploy.stub.generation.scopeキーにappを指定した場合は，WARファイルに含まれるリモートインタフェースを実装したすべてのインタフェースのスタブが生成されます。
これらのことを考慮して，作業ディレクトリのパス長がプラットフォームの上限に達しないようにWARファイル名，WARファイル中のパッケージ名やクラス名，およびjava.rmi.Remoteを実装したクラスのパッケージ名やクラス名を指定してください。

EARファイル中のライブラリJARファイル名は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにJARファイル名を指定してください。

EARファイル中のEJB-JAR同士，WAR同士で表示名が重複している場合はインポートできません。表示名が空文字または指定されていない場合は，ファイル名を変換した文字列が指定されます。この値が重複した場合もインポートできません。

インポートした実行時情報付きのJ2EEアプリケーションの実行時情報にエラーがある場合，J2EEアプリケーションのインポートに失敗します。このとき，J2EEアプリケーションは自動開始されないで削除されます。J2EEアプリケーションが削除されないようにするには，cjimportappコマンドの-nodeleteオプションを指定してJ2EEアプリケーションをインポートしてください。このとき，J2EEアプリケーションは削除されないでインポートできますが，自動開始されないので，必要に応じてエラーを取り除き，J2EEアプリケーションを開始してください。

インポートするアプリケーションにapplication.xmlがある場合の表示名，およびディレクトリ名の変換規則は次のとおりです。

application.xmlの<display-name>タグの値が表示名となります。

<display-name>タグの値がない場合，-fオプションに指定したEARファイル名を変換した文字列が表示名になります。
なお，ファイル名に汎用文字と数字以外の文字が含まれている場合，その文字はアンダースコア(_)に置き換えられます。
置換対象の文字が続けて出現する場合は一つのアンダースコア(_)に纏められます。

application.xmlの<module>タグに記述されたパス名から拡張子を除いた名称がEJB-JARディレクトリ名，またはWARディレクトリ名となります。

インポートするアプリケーションにapplication.xmlがない場合の表示名，およびディレクトリ名の変換規則は次のとおりです。

-fオプションに指定したファイル名から拡張子を除き，変換した文字列が表示名になります。
なお，半角英数字（0～9，A～Z，a～z），アンダースコア(_)以外の文字はアンダースコア(_)に置き換えられます。

ピリオド（.）が最初に現れるファイル名の場合は，ピリオド（.）を除かないで変換した文字列が表示名になります。

EJB-JARディレクトリ名の最後は「_jar」，WARディレクトリ名の最後は「_war」となります。

06-50より前のバージョンのCosminexus Component Containerからアップグレードインストールした場合，J2EEサーバ上にあるデータソースは，J2EEリソースアダプタに自動変換されます。
J2EEリソースアダプタに自動変換される前のデータソースとリファレンスを解決したJ2EEアプリケーションを，実行時情報を含む状態でエクスポートし，06-50以降のバージョンのCosminexus Component Containerにインポートする場合，インポートされたJ2EEアプリケーションはリファレンス解決されていません。このため，次の2点に注意してください。

インポートされたJ2EEアプリケーションのリファレンス解決はされていないので，エクスポートしたJ2EEアプリケーションが開始状態の場合でも，J2EEアプリケーションは自動開始に失敗します。この場合は，cjimportappコマンドの-nodeleteオプションを指定してJ2EEアプリケーションをインポートしてください。

インポート後は，リファレンス解決を実施してから，J2EEアプリケーションを開始してください。

8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート

展開ディレクトリ形式のJ2EEアプリケーションは，J2EEサーバの作業ディレクトリ以下に各コンポーネントのclassファイルやJARファイルを持ちません。DDと展開ディレクトリのパス情報だけを持ち，EARファイルまたはZIPファイルが展開ディレクトリのパスに展開されているJ2EEアプリケーションです。ただし，J2EEアプリケーションに含まれるRARファイルはアーカイブ形式で格納されています。

展開ディレクトリ形式のJ2EEアプリケーションのインポートには，次の二つの方法があります。

アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポートします。

J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポートします。

注意

展開ディレクトリ形式のアプリケーションをインポートした場合，J2EEサーバの起動処理中またはサーバ管理コマンド実行中に，アプリケーションディレクトリ以下のディレクトリおよびファイルの追加，削除および上書きはしないでください。

展開ディレクトリ形式のアプリケーションのインポート手順を，次に示します。

＜この項の構成＞

(1)　アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポート

(2)　J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポート

(1)　アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポート

次の手順で，J2EEサーバにアプリケーションディレクトリを登録します。

アプリケーションディレクトリを作成します。
展開ディレクトリ形式のJ2EEアプリケーションを新規に作成する場合は，アプリケーションディレクトリを作成します。アプリケーションディレクトリの構成については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.4.2　アプリケーションディレクトリの構成」を参照してください。

アプリケーションディレクトリをインポートします。
上記1.で作成した，アプリケーションディレクトリをJ2EEサーバに登録します。

次に示すコマンドを実行して，アプリケーションディレクトリをインポートします。

実行形式

cjimportapp ［＜サーバ名＞］ -a ＜アプリケーションディレクトリパス＞

実行例

cjimportapp MyServer -a AppDirPath

cjimportappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportapp（J2EEアプリケーションのインポート）」を参照してください。

注意事項

リモート環境では実行できません。

application.xmlに<alt-dd>タグを指定している，アプリケーションディレクトリを展開ディレクトリ形式で使用できません。

インポートするアプリケーションにapplication.xmlがある場合の表示名，およびディレクトリ名の変換規則は次のとおりです。

application.xmlの<display-name>タグの値が表示名となります。

<display-name>タグの値がない場合，-fオプションに指定したEARファイル名を変換した文字列が表示名になります。
なお，ファイル名に汎用文字と数字以外の文字が含まれている場合，その文字はアンダースコア(_)に置き換えられます。
置換対象の文字が続けて出現する場合は一つのアンダースコア(_)に纏められます。

application.xmlの<module>タグに記述されたパス名から拡張子を除いた名称がEJB-JARディレクトリ名，またはWARディレクトリ名となります。

インポートするアプリケーションにapplication.xmlがない場合の表示名，およびディレクトリ名の変換規則は次のとおりです。

-fオプションに指定したファイル名から拡張子を除き，変換した文字列が表示名になります。
なお，半角英数字（0～9，A～Z，a～z），アンダースコア(_)以外の文字はアンダースコア(_)に置き換えられます。

ピリオド（.）が最初に現れるファイル名の場合は，ピリオド（.）を除かないで変換した文字列が表示名になります。

EJB-JARディレクトリ名の最後は「_jar」，WARディレクトリ名の最後は「_war」となります。

J2EEサーバ内で，同じディレクトリをアプリケーションディレクトリとするJ2EEアプリケーションがすでにある場合，インポートできません。

-dオプションを指定したインポートで展開ディレクトリに展開されたアプリケーションディレクトリが，次の場合，-aオプションを指定してインポートできません。

EJB-JARのモジュール名が「.jar」で終わっていない。

WARのモジュール名が「.war」で終わっていない。

拡張子を含まないモジュール名称が，拡張子を含まないほかのモジュール名称と同一である。

拡張子を含まないモジュールの名称が，EARファイル内のディレクトリと同一である。

アプリケーションディレクトリ配下の各種コンポーネントのDDはUTF-8エンコーディングになります。

DDのバージョンが古い場合，バージョンを次のように変更します。

表8-3　DDのバージョンの変更

DD | インポート前のバージョン | インポート後のバージョン
application.xml | 1.2 | 1.4
1.3
ejb-jar.xml | 1.1 | 2.0
web.xml | 2.2 | 2.3

(2)　J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポート

EARファイルまたはエクスポートした実行時情報付きEARファイルを展開ディレクトリ形式でインポートします。

次に示すコマンドを実行して，アプリケーションを展開ディレクトリ形式でインポートします。

実行形式

cjimportapp ［＜サーバ名＞］-f ＜ファイルパス＞ -d ＜展開ディレクトリパス＞

EARファイルまたはZIPファイルの内容は，展開ディレクトリパスに展開されます。

実行例

cjimportapp MyServer -f App1.zip -d ApplicationDir

cjimportappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportapp（J2EEアプリケーションのインポート）」を参照してください。

注意事項

J2EEサーバを起動したユーザに対して，展開先ディレクトリパスに指定したディレクトリの書き込み権限が必要です。

application.xmlに<alt-dd>タグを指定している，J2EEアプリケーションを展開ディレクトリ形式で使用することはできません。

J2EEサーバ内で，同じディレクトリを展開ディレクトリとするJ2EEアプリケーションがすでにある場合，インポートできません。

そのほかの注意事項は，アーカイブ形式のJ2EEアプリケーションのインポートと同じです。アーカイブ形式のJ2EEアプリケーションのインポートについては，「8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート」の注意事項を参照してください。

アプリケーションディレクトリ配下の各種コンポーネントのDDはUTF-8エンコーディングになります。

8.2　J2EEアプリケーションのエクスポート

次に示すコマンドを実行してJ2EEアプリケーションをエクスポートします。

実行形式

cjexportapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -f ＜EARファイルパス＞ ［-raw|-normal］

実行時情報を含める場合

-normalを指定してください（デフォルト値）。

実行時情報を含めない場合

-rawを指定してください。

実行例

cjexportapp MyServer -name account -f C:¥home¥account.zip

この例の場合は，EARファイルの実行時情報が含まれます。

cjexportappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjexportapp（J2EEアプリケーションのエクスポート）」を参照してください。

J2EEアプリケーションのエクスポート時の注意事項を，次に示します。

実行時情報に関する注意事項

EARのDDに関する注意事項

＜この節の構成＞

(1)　実行時情報に関する注意事項

(2)　EARのDDに関する注意事項

(1)　実行時情報に関する注意事項

J2EEアプリケーションをエクスポートする場合，次に示すどちらかを選択できます。デフォルトは実行時情報付きファイルの形式（ZIP形式）になります。

実行時情報付きファイル（ZIP形式）
実行時情報を含んだZIP形式のファイルです。なお，実行時情報付きファイルは，Cosminexus独自のファイルです。

EAR
Java 2 Platform, Enterprise Editionで規定されたEARです。実行時情報を含みません。

実行時情報を含んだ形式でエクスポートしたJ2EEアプリケーションには，下位の互換性はありません。J2EEアプリケーションの内容は，変更しないでください。
複数のJ2EEサーバから構成されるシステムで，J2EEサーバ間でJDBCリソースの設定，利用するデータベース，およびJ2EEアプリケーションの実行時プロパティを同じにする場合は，実行時情報付きEARファイルを使用します。このとき一方のJ2EEサーバで作成したJ2EEアプリケーションをエクスポートし，他方のJ2EEサーバ上にインポートさせることを推奨します。
J2EEサーバ上に作成したJ2EEアプリケーションを別のシステムのJ2EEサーバや同じシステムでも実行環境が異なるJ2EEサーバにインポートする場合，またはほかのJ2EEサーバ製品でも使用する場合には，EARファイル形式を使用してJ2EEアプリケーションをエクスポートしてください。

J2EEサーバに登録されている展開ディレクトリ形式のアプリケーションをエクスポートすると，EARファイルまたは実行時情報付きZIPファイルを生成します。

アプリケーション開始時にJSP事前コンパイルを実行したアプリケーションをエクスポートすると，エクスポートされたEARファイルにはJSPコンパイル結果が含まれます。JSPコンパイル結果が含まれたEARファイルを，ほかのJ2EEサーバにインポートすると，EARファイルに含まれるJSPファイルのコンパイル結果を使用できます。

インポートしたJ2EEアプリケーションがcosminexus.xmlを含んでいる場合，cosminexus.xmlを含んだ状態でエクスポートします。cosminexus.xmlを含むアプリケーションのエクスポートについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「10.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

(2)　EARのDDに関する注意事項

EARのDDのバージョンは，J2EEアプリケーションのバージョンによって，1.4以降になります。

EARに含まれるEJB-JARのDDのバージョンは，EJB-JARのバージョンによって，2.0以降になります。

EARに含まれるWARのDDのバージョンは，WARのバージョンによって，2.3以降になります。

07-00より前のバージョンのCosminexus Component ContainerのJ2EEアプリケーションで，コンポーネントの追加，削除およびプロパティの変更を実施していない場合，EAR，EJB-JAR，WARのDDはアップグレードインストールのときのバージョンとなります。

EARに含まれる各種コンポーネントのDDはUTF-8エンコーディングになります。

9.　J2EEアプリケーションのプロパティ設定

この章では，サーバ管理コマンドを使用したJ2EEアプリケーションのプロパティの設定方法について説明します。

＜この章の構成＞

9.1　J2EEアプリケーションのプロパティ設定の概要

9.2　アプリケーション統合属性ファイルによるプロパティ設定

9.3　Enterprise Beanのリファレンス定義

9.4　Message-driven Beanのメッセージ参照定義

9.5　トランザクション属性の定義

9.6　Entity BeanのCMP定義

9.7　サーブレットとJSPのリファレンス定義

9.8　サーブレットとJSPのマッピング定義

9.9　フィルタの設定

9.10　Enterprise Beanの実行時属性の定義

9.11　サーブレットとJSPの実行時属性の定義

9.12　デフォルトの文字エンコーディングの設定

9.13　JNDI名前空間に登録される名称の参照と変更

9.14　CTMのスケジューリング

9.15　起動順序の設定

9.16　サーブレットとJSPのエラー通知の設定

9.17　セキュリティロールの設定

9.18　セキュリティロールのリファレンス定義

9.19　セキュリティの定義（メソッドパーミッション）

9.20　セキュリティの定義（セキュリティアイデンティティ）

9.21　インターセプタの設定

9.22　そのほかのプロパティの設定

9.1　J2EEアプリケーションのプロパティ設定の概要

J2EEアプリケーションのプロパティ設定とは，インポートしたJ2EEアプリケーションの属性や動作を定義することです。この節では，次の説明をします。

J2EEアプリケーションのプロパティ設定と属性ファイル

Enterprise Beanのプロパティ設定項目

サーブレットとJSPのプロパティ設定項目

J2EEアプリケーション（共通）のプロパティ設定項目

注意

アノテーションで指定した項目は変更できません。また，cosminexus.xmlを含むアプリケーションのプロパティを変更するには，サーバ管理コマンドを使って設定する方法と，MyEclipce使って設定する方法があります。サーバ管理コマンドでcosminexus.xmlにある定義情報を変更したあとでリデプロイ機能を使用すると，サーバ管理コマンドで変更した情報は失われます。

MyEclipceを使ったcosminexus.xmlを含むアプリケーションのプロパティの変更については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション開発ガイド」の「5.3.2　cosminexus.xmlエディタの操作方法」を参照してください。また，cosminexus.xmlを含むアプリケーションの運用については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「10.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

J2EEアプリケーションに含まれるリソースアダプタのプロパティ設定と属性ファイルについては，「5.4　リソースアダプタのプロパティ定義」を参照してください。

＜この節の構成＞

(1)　J2EEアプリケーションのプロパティ設定と属性ファイル

(2)　Enterprise Beanのプロパティ設定項目

(3)　サーブレットとJSPのプロパティ設定項目

(4)　J2EEアプリケーション（共通）のプロパティ設定項目

(1)　J2EEアプリケーションのプロパティ設定と属性ファイル

プロパティの設定手順の概要については，「3.3　属性ファイルによるプロパティの設定」を参照してください。

次の属性ファイルを利用して，J2EEアプリケーションのプロパティを設定できます。

固有の属性ファイルを利用します。
J2EEアプリケーションを構成するコンポーネントの固有属性ファイルごとに，プロパティを設定します。

アプリケーション統合属性ファイルを利用します。
固有の属性ファイルの内容を一括して，プロパティを設定します。

J2EEアプリケーションのプロパティの設定では，固有の属性ファイルとアプリケーション統合属性ファイルを個々に利用することも，合わせて利用することもできます。

この章では，主に，固有の属性ファイルを使用してのプロパティ設定について説明しています。アプリケーション統合属性ファイルを使用してのプロパティ設定については，「9.2　アプリケーション統合属性ファイルによるプロパティ設定」を参照してください。

(2)　Enterprise Beanのプロパティ設定項目

Enterprise Beanが含まれるJ2EEアプリケーションを作成する場合およびカスタマイズする場合，必要に応じて設定してください。

Enterprise Beanのプロパティ設定項目を次に示します。

表9-1　Enterprise Beanのプロパティ編集項目

編集項目
内容
必須／
任意
固有属性ファイルの編集参照先

Enterprise Beanのリファレンス定義
J2EEアプリケーションを構成する，次のEnterprise Beanのリファレンスを定義します。

Session Bean

Entity Bean

Message-driven Bean

○
9.3

ほかのEnterprise Beanのリファレンス定義
ほかのEnterprise Beanへのリファレンスについて定義します。
○
9.3.1

メールコンフィグレーションのリファレンス定義
メールサーバへのリファレンスについて定義します。
○
9.3.2

リソースアダプタのリファレンス定義
リソースアダプタへのリファレンスについて定義します。
○
9.3.3

リソース環境のリファレンス定義
リソース環境へのリファレンスを定義します。
○
9.3.4

Message-driven Beanのメッセージ参照定義
Message-driven BeanのConnection FactoryとDestinationを参照する個所に，実際のConnection FactoryとDestinationをマッピングします。
○
9.4

トランザクション属性の定義
トランザクション属性について定義します。
○
9.5

Entity BeanのCMP定義
Entity Beanの永続性管理をコンテナに任せる場合に定義します。
○
9.6

CMPの設定
単一プライマリキーを使用してEntity Beanの永続性管理をコンテナに任せる場合に定義します。
複合プライマリキーを使用してEntity Beanの永続性管理をコンテナに任せる場合に定義します。
○
9.6.1

CMP1.xとデータベースのマッピング
CMP1.x Entity Beanのフィールドをデータベース上の表にマッピングします。
○
9.6.2

CMP2.xとデータベースのマッピング
CMP2.x Entity Beanのフィールドをデータベース上の表にマッピングします。
○
9.6.3

Enterprise Beanの実行時属性の定義
Enterprise Beanの実行時の動作について設定します。必要に応じて設定してください。
◎
9.10

Stateful Session Beanの実行時プロパティの設定
Stateful Session Beanの実行時の動作についてのプロパティを設定します。
◎
9.10.1

Stateless Session Beanの実行時プロパティの設定
Stateless Beanの実行時の動作についてのプロパティを設定します。
◎
9.10.2

Entity Beanの実行時プロパティの設定
Entity Beanの実行時の動作についてのプロパティを設定します。
◎
9.10.3

Message-driven Beanの実行時プロパティの設定
Message-driven Beanの実行時の動作についてのプロパティを設定します。
◎
9.10.4

インターセプタの設定
インターセプタを使用する場合に定義します。
○
9.21

（凡例）

◎：必須。対応するEnterprise Beanが含まれるJ2EEアプリケーションのカスタマイズで必ず設定する。

○：任意。J2EEアプリケーションに応じて設定する。

(3)　サーブレットとJSPのプロパティ設定項目

サーブレットおよびJSPを含むJ2EEアプリケーションを作成する場合に，必要に応じて設定してください。

サーブレットとJSPのプロパティ設定項目を次に示します。

表9-2　サーブレットとJSPのプロパティ編集項目

編集項目
内容
必須／
任意
固有属性ファイルの編集参照先

サーブレットとJSPのリファレンス定義
Enterprise Bean，セキュリティロール，リソース（データベースまたはメールサーバ）へのリファレンス（リソース参照）について定義します。
○
9.7

Enterprise Beanのリファレンス定義
Enterprise Beanへのリファレンスについて定義します。
○
9.7.1

メールコンフィグレーションのリファレンスの定義
メールサーバへのリファレンスについて定義します。
○
9.7.2

リソースアダプタのリファレンス定義
リソースアダプタへのリファレンスについて定義します。
○
9.7.3

リソース環境のリファレンス定義
リソース環境リファレンスを定義します。
○
9.7.4

サーブレットとJSPのマッピング定義
サーブレットとJSPのマッピングを定義します。
○
9.8

フィルタの設定
フィルタを追加し，マッピングを定義します。
○
9.9

フィルタの追加
フィルタを追加します。
○
9.9.1

フィルタのマッピング定義
フィルタへのマッピングを定義します。
○
9.9.2

フィルタの削除
フィルタを削除します。
○
9.9.3

サーブレットとJSPの実行時属性の定義
サーブレットおよびJSPの実行時属性を定義します。
○
9.11

J2EEアプリケーションのコンテキストルート定義
J2EEアプリケーションのコンテキストルートを設定します。
◎
9.11.1

Webアプリケーション単位での同時実行スレッド数制御の定義
WebコンテナでWebアプリケーション単位での同時実行スレッド数を制御するかどうか，およびスレッド数などを設定します。
○
9.11.2

URLグループ単位での同時実行スレッド数制御の定義
URLグループ単位での同時実行スレッド数を制御するための定義をします。
○
9.11.3

URLグループ単位の実行待ちリクエスト数の監視の定義
URLグループ単位の実行待ちリクエスト数を監視するための定義をします。
○
9.11.4

デフォルトの文字エンコーディングの設定
Webアプリケーションのデフォルトの文字エンコーディングを設定します。
○
9.12

サーブレットとJSPのエラー通知の設定
サーブレット，JSPでエラーが発生した場合に，J2EEアプリケーションにエラーを通知するための設定をします。
○
9.16

（凡例）

◎：必須。サーブレットとJSPが含まれるJ2EEアプリケーションのカスタマイズでは必ず設定する。

○：任意。J2EEアプリケーションに応じて設定する。

(4)　J2EEアプリケーション（共通）のプロパティ設定項目

J2EEアプリケーションの構成に関係なく，必要に応じて設定してください。

表9-3　J2EEアプリケーション（共通）のプロパティ編集項目

編集項目
内容
必須／
任意
固有属性ファイルの編集参照先

JNDI名前空間に登録される名称の参照と変更
J2EEアプリケーションのJNDI名前空間への登録名を参照して，必要に応じて別名を付与します。
○
9.13

J2EEアプリケーション名の参照
J2EEアプリケーション名を参照するための設定をします。
○
9.13.1

Enterprise Bean名の参照と変更
Enterprise Bean名を参照するための設定およびEnterprise Bean名の変更をします。
○
9.13.2

CTMのスケジューリング
CTMを利用してキューのスケジューリングをするかどうかと，スケジューリング方法について設定します。
○
9.14

J2EEアプリケーション単位のスケジューリング
J2EEアプリケーション単位のCTMとの連携にかかわる設定をします。
○
9.14.1

Stateless Session Bean単位のスケジューリング
Stateless Session Bean単位のスケジューリングの設定をします。
○
9.14.2

起動順序の設定
J2EEアプリケーションの起動順序，およびJ2EEアプリケーションに含まれるEnterprise Bean（EJB-JAR）やサーブレットまたはJSP（WAR）の起動順序を設定します。
○
9.15

J2EEアプリケーションの起動順序の設定
J2EEアプリケーションの起動順序を設定します。
○
9.15.1

Enterprise Beanの起動順序の設定
J2EEアプリケーションに含まれるEnterprise Bean（EJB-JAR）の起動順序を設定します。
○
9.15.2

サーブレットとJSPの起動順序の設定
J2EEアプリケーションに含まれるサーブレットまたはJSP（WAR）の起動順序を設定します。
○
9.15.3

セキュリティロールの設定
セキュリティロールを使用したユーザ管理をする場合に必要な設定です。
ユーザとロールの登録と対応づけができます。
○
9.17

ユーザの設定
ユーザを登録します。ロールとの対応づけもできます。
○
9.17.1

ロールの設定
ロールを登録します。ユーザとの対応づけもできます。
○
9.17.2

セキュリティロールのリファレンス定義
セキュリティロールへのリファレンスについて定義します。
○
9.18

Enterprise Beanのセキュリティロールリファレンスの定義
セキュリティロールを参照している個所に，実際にJ2EEサーバが管理しているセキュリティロールをマッピングします。
○
9.18.1

サーブレットとJSPのセキュリティロールリファレンスの定義
セキュリティロールへのリファレンスについて定義します。
○
9.18.2

セキュリティの定義（メソッドパーミッション）
セキュリティロールによるアクセス権を設定する場合のメソッドのパーミッションを定義します。
すべてのユーザに対してアクセス権限を設定する場合のメソッドのパーミッションを定義します。
○
9.19

セキュリティの定義（セキュリティアイデンティティ）
セキュリティの情報であるセキュリティアイデンティティとしてUseCallerIdentityを設定します。
セキュリティの情報であるセキュリティアイデンティティとしてRun asを設定します。
○
9.20

Enterprise Beanのセキュリティアイデンティティ
J2EEアプリケーション内で参照しているセキュリティアイデンティティ情報に，J2EEサーバが実際に管理しているユーザIDをマッピングします。
○
9.20.1

サーブレットとJSPのセキュリティアイデンティティ
セキュリティアイデンティティを定義します。
○
9.20.2

（凡例）

○：任意。J2EEアプリケーションに応じて設定する。

9.2　アプリケーション統合属性ファイルによるプロパティ設定

サーバ管理コマンドでアプリケーション統合属性ファイルを取得して，固有の属性ファイルの内容を一括して編集できます。

アプリケーション統合属性ファイルに含まれる，固有の属性ファイルの要素を次に示します。

アプリケーション属性ファイル
（<hitachi-application-property></hitachi-application-property>）

EJB-JAR属性ファイル
（<hitachi-ejb-jar-property></hitachi-ejb-jar-property>）

Session Bean属性ファイル
<hitachi-session-bean-property></hitachi-session-bean-property>

Entity Bean属性ファイル
<hitachi-entity-bean-property></hitachi-entity-bean-property>

Message-driven Bean属性ファイル
<hitachi-message-bean-property></hitachi-message-bean-property>

WAR属性ファイル
<hitachi-war-property></hitachi-war-property>

フィルタ属性ファイル
<hitachi-filter-property></hitachi-filter-property>

サーブレット属性ファイル
<hitachi-servlet-property></hitachi-servlet-property>

Connector属性ファイル
<hitachi-connector-property></hitachi-connector-property>

アプリケーション統合属性ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.1　アプリケーション統合属性ファイル」を参照してください。

アプリケーション統合属性ファイルによる，J2EEアプリケーションのプロパティ設定手順を次に示します。

＜この節の構成＞

(1)　アプリケーション統合属性ファイルの取得

(2)　プロパティ設定項目の編集

(3)　アプリケーション属性の設定

(1)　アプリケーション統合属性ファイルの取得

アプリケーション統合属性ファイルを取得するために，アプリケーション統合属性ファイルパスを指定して，cjgetapppropコマンドを実行します。

実行形式

cjgetappprop ＜サーバ名称＞ -name ＜J2EEアプリケーション名＞ -type all -c ＜アプリケーション統合属性ファイルパス＞

実行例

cjgetappprop Myserver -name App1 -type all -c App1prop.xml

(2)　プロパティ設定項目の編集

上記(1)で出力されたアプリケーション統合属性ファイルをテキストエディタで編集します。J2EEアプリケーションのプロパティ編集項目については，「9.1　J2EEアプリケーションのプロパティ設定の概要」を参照してください。アプリケーション統合属性ファイルの編集項目は，固有の属性ファイルの編集項目と同じです。

(3)　アプリケーション属性の設定

アプリケーション統合属性ファイルで指定した項目をアプリケーション属性に反映するために，cjsetapppropコマンドを実行します。

実行形式

cjsetappprop ＜サーバ名称＞ -name ＜J2EEアプリケーション名＞ -type all -c ＜アプリケーション統合属性ファイルパス＞

実行例

cjsetappprop MyServer -name App1 -type all -c App1Prop.xml

9.3　Enterprise Beanのリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanのリファレンス（リソース参照）を定義します。Enterprise Beanには，次の種類があります。

Session Bean

Entity Bean

Message-driven Bean

それぞれのEnterprise Beanには，次に示す3種類のリファレンスがあります。

Enterprise Beanリファレンス
ほかのEnterprise Bean呼び出しのための参照です。

リソースリファレンス
リソースへの参照です。メールリファレンス，リソースアダプタリファレンス，およびリソース環境リファレンスがあります。

セキュリティロールリファレンス
Enterprise Beanのメソッド呼び出しのアクセス制御をするために使用するロール名称の参照です。

この節では，Enterprise Beanリファレンスとリソースリファレンスについて説明します。セキュリティロールのリファレンスについては，「9.18　セキュリティロールのリファレンス定義」を参照してください。

なお，プロパティの設定項目については，次の個所を参照してください。

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」

＜この節の構成＞

9.3.1　ほかのEnterprise Beanのリファレンス定義

9.3.2　メールコンフィグレーションのリファレンス定義

9.3.3　リソースアダプタのリファレンス定義

9.3.4　リソース環境のリファレンス定義

9.3.1　ほかのEnterprise Beanのリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanが，ほかのEnterprise Beanを呼び出している場合，リファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

J2EEアプリケーションを構成するEnterprise Beanの種類に対応する属性ファイルを編集します。

Session Bean属性ファイル

Entity Bean属性ファイル

Message-driven Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEnterprise Beanの属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder/adder_eb -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，Enterprise Beanの属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder/adder_eb -c C:¥home¥adder_ejb.xml

(3)　編集する属性設定項目

参照するEnterprise Beanのアクセスタイプには，次の2種類があります。

参照するEnterprise Beanのアクセスタイプ | 対応するタグ名
リモートインタフェース | <ejb-ref>
ローカルインタフェース | <ejb-local-ref>

注　ビジネスインタフェース（<business-local>および<business-remote>）は，アノテーションで設定しているため変更できません。

それぞれの設定項目について説明します。

(a)　リモートインタフェースのEnterprise Beanのリファレンス定義

リモートEnterprise Beanのリファレンス設定項目（<ejb-ref>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
Enterprise Bean参照名 | ○ | <ejb-ref-name>
参照するEnterprise Beanの種別 | ○ | <ejb-ref-type>
リモートホームインタフェース | ○ | <home>
リモートインタフェース | ○ | <remote>
リンク先の<ejb-name> | △ | <ejb-link>

（凡例）　○：必須　△：任意

(b)　ローカルインタフェースのEnterprise Beanのリファレンス定義

ローカルEnterprise Beanのリファレンス設定項目（<ejb-local-ref>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
Enterprise Bean参照名 | ○ | <ejb-ref-name>
参照するEnterprise Beanの種別 | ○ | <ejb-ref-type>
ローカルホームインタフェース | ○ | <local-home>
ローカルインタフェース | ○ | <local>
リンク先の<ejb-name> | △ | <ejb-link>

（凡例）　○：必須　△：任意

(4)　注意事項

リモートインタフェースのEnterprise Beanを呼び出す場合には，別アプリケーションにあるEnterprise Beanをマッピング先として，「リンク先の<ejb-name>」（<ejb-link>）に設定できます。
マッピング先のEnterprise BeanがCosminexus上で動作している場合，ネーミングの切り替え機能を利用して，次に示すような形式でマッピング先を指定できます。
指定形式

corbaname::＜名前空間のホスト名＞:＜名前空間のポート番号＞#＜EJBホームオブジェクトリファレンスのJNDI名＞

＜名前空間のホスト名＞

マッピング先Enterprise Beanが使用する名前空間が動作する，ホスト名称を指定します。

＜名前空間のポート番号＞

マッピング先Enterprise Beanが使用する名前空間が動作する，ポート番号を指定します。

＜EJBホームオブジェクトリファレンスのJNDI名＞

次に示す形式に従って，JNDI名を指定します。

HITACHI_EJB/SERVERS/＜サーバ名称＞/EJB/＜J2EE APP名称＞/＜Enterprise Bean名称＞

＜サーバ名称＞：J2EEサーバのサーバ名称

＜J2EE APP名称＞：J2EEアプリケーションのルックアップ名称

＜Enterprise Bean名称＞：Enterprise Beanのルックアップ名称

指定例
corbaname::MyHost:900#HITACHI_EJB/SERVERS/MyServer/EJB/MyApplication/MyBean

ネーミングサービスがローカルホスト上で動作する場合，J2EEサーバ用のusrconf.propertiesファイルのejbserver.naming.hostキーには，「localhost」の文字列を使用しないで，マシン名またはIPアドレスを指定してください。

9.3.2　メールコンフィグレーションのリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanが，メールコンフィグレーションを参照している場合，リファレンスを定義するためのプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

編集する属性ファイルについては，「9.3.1　ほかのEnterprise Beanのリファレンス定義」の「(1)　編集する属性ファイル」を参照してください。

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの取得と属性の設定については，「9.3.1　ほかのEnterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

メールコンフィグレーションのリファレンス設定項目（<resource-ref>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
リソース参照名 | ○ | <res-ref-name>
リソースタイプ | ○ | <res-type>
リソース認証方式 | ○ | <res-auth>
リソース共有可否 | △ | <res-sharing-scope>
リンク先のメールコンフィグレーション名 | △ | <linked-to>

（凡例）　○：必須　△：任意

9.3.3　リソースアダプタのリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanが，リソースアダプタを参照している場合，リファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

編集する属性ファイルについては，「9.3.1　ほかのEnterprise Beanのリファレンス定義」の「(1)　編集する属性ファイル」を参照してください。

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの取得と属性の設定については，「9.3.1　ほかのEnterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

リソースアダプタのリファレンス設定項目（<resource-ref>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
リソース参照名 | ○ | <res-ref-name>
リソースタイプ | ○ | <res-type>
リソース認証方式 | ○ | <res-auth>
リソース共有可否 | △ | <res-sharing-scope>
リンク先のリソースアダプタ表示名※ | △ | <linked-to>

（凡例）　○：必須　△：任意

注※　クラスタコネクションプールを使用している場合，ルートリソースアダプタの表示名を指定してください。メンバリソースアダプタは指定できません。

9.3.4　リソース環境のリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanのリソース環境のリファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

編集する属性ファイルについては，「9.3.1　ほかのEnterprise Beanのリファレンス定義」の「(1)　編集する属性ファイル」を参照してください。

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの取得と属性の設定については，「9.3.1　ほかのEnterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

リソース環境のリファレンス設定項目（<resource-env-ref>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
リソース環境変数名 | ○ | <resource-env-ref-name>
リソース環境変数値のタイプ | ○ | <resource-env-ref-type>
リンク先キュー情報 | △ | <linked-queue>
| リソースアダプタの表示名 | △ | <resource-adapter>
キュー名 | △ | <queue>
リンク先のJavaBeansリソース表示名 | △ | <linked-to>

（凡例）　○：必須　△：任意

9.4　Message-driven Beanのメッセージ参照定義

Message-driven Beanのメッセージ参照を定義します。

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

Message-driven Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してMessage-driven Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Message-driven Bean表示名＞ -c ＜Message-driven Bean属性ファイルパス＞

実行例

cjgetappprop MyServer -name message -type ejb -resname message/MyMessage -c C:¥home¥MyMessageBean.xml

●属性の設定

次に示すコマンドを実行して，Message-driven Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Message-driven Bean表示名＞ -c ＜Message-driven Bean属性ファイルパス＞

実行例

cjsetappprop MyServer -name message -type ejb -resname message/MyMessage -c C:¥home¥MyMessageBean.xml

(3)　編集する属性設定項目

メッセージ参照の設定項目（<message-ref>）を次に示します。

項目 | 必須 | 対応するタグ名
Connection Factory名 | ○ | <connection-factory>
リソースアダプタ表示名 | ○ | <connction-destination> - <resource-adapter>
キューの表示名※ | ○ | <connction-destination> - <queue>

（凡例）　○：必須

注※　JMSのキューを複数の異なるMessage-driven Beanで共有することは推奨しません。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」を参照してください。

9.5　トランザクション属性の定義

コンテナによるトランザクションの管理方法を定義します。

トランザクション属性はEnterprise Bean単位，インタフェース単位，メソッド単位にそれぞれ指定できます。指定がない場合は上位の単位で指定されたトランザクション属性が有効になります。

Enterprise Beanごとの適用
割り当てたトランザクション属性を，Enterprise Bean内のメソッドに適用します。

インタフェースごとの適用
割り当てたトランザクション属性を，インタフェース内のメソッドに適用します。

メソッドごとの適用
割り当てたトランザクション属性を，一つのメソッドに適用します。

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

次の属性ファイルのうち，トランザクション属性を設定するEnterprise Beanの種類に対応する属性ファイルを編集します。

Session Bean属性ファイル

Entity Bean属性ファイル

Message-driven Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEnterprise Beanの属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder/adder_eb -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，Enterprise Beanの属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder/adder_eb -c C:¥home¥adder_ejb.xml

(3)　編集する属性設定項目

コンテナトランザクション属性（<container-transaction>）の設定項目を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
メソッドの説明 | △ | <method> - <description>
インタフェース種別 | △ | <method> - <method-intf>
メソッド名 | ○ | <method> - <method-name>
トランザクション属性 | ○ | <trans-attribute>

（凡例）　○：必須　△：任意

プロパティの設定項目については，次の個所を参照してください。

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」

トランザクション属性の指定とトランザクション管理の動作を，次に示します。

NotSupported
コンテナ管理トランザクション内でメソッドを実行しません。

Supports
メソッドのトランザクションの処理は場合によって異なります。トランザクション内およびトランザクション外で正しく実行するメソッドに対してだけ，この属性を使用してください。

Required
コンテナはメソッドを常にトランザクション内で実行します。

RequiresNew
メソッドは，常に新しいトランザクションで実行します。

Mandatory
メソッドは，常にクライアントのトランザクションを使用しなければなりません。つまり，クライアントはトランザクション内でメソッドを呼び出さなければなりません。

Never
メソッドはトランザクション内で実行できません。つまり，クライアントは，トランザクションの外でメソッドを呼び出さなければなりません。

(4)　注意事項

Enterprise Beanの種類によって設定できるトランザクション属性が異なります。設定できるトランザクション属性およびトランザクション管理の動作については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」を参照してください。

Session Beanのプロパティ（<transaction-type>）で，Session Beanが自身のトランザクションを管理するよう指定されている場合，この設定でトランザクション属性を変更できません。

Message-driven Beanの場合は，onMessageのメソッドだけ設定できます。

9.6　Entity BeanのCMP定義

Entity BeanのCMP定義をします。CMPを定義すると，Enterprise BeanであるEntity Beanの永続性管理をコンテナに任せることができます。

＜この節の構成＞

9.6.1　CMPの設定

9.6.2　CMP1.xとデータベースのマッピング

9.6.3　CMP2.xとデータベースのマッピング

9.6.1　CMPの設定

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

Entity Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEntity Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Entity Bean表示名＞ -c ＜Entity Bean属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname account/MyAccoub -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，Entity Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Entity Bean表示名＞-c ＜Entity Bean属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname account/MyAccoub -c C:¥home¥adder_ejb.xml

(3)　編集する属性設定項目

CMPの定義は，プライマリキーが単一プライマリキーの場合と複合プライマリキーの場合で，設定方法が異なります。

(a)　単一プライマリキーの場合の属性設定

プライマリキーが単一プライマリキーの場合のプロパティ項目を設定します。

永続性管理種別（<persistence-type>）を確認します。CMP Entity Beanの場合は「Container」が設定されています。

単一プライマリキーのプロパティ設定項目を次に示します。

項目 | 必須 | 対応するタグ名
プライマリキーのクラス※1 | ○ | <prim-key-class>
リエントラント可否 | ○ | <reentrant>
永続性管理フィールドの説明 | △ | <cmp-field> - <description>
永続性管理フィールドのフィールド名※2 | △ | <cmp-field> - <field-name>
プライマリキーフィールドのフィールド名 | △ | <primkey-field>

（凡例）　○：必須　△：任意

注※1　このEntity Beanのプライマリキーを含むクラスまたはインタフェースを入力します。プライマリキークラスは，java.lang.Objectクラス，またはコンテナ管理フィールドと同じクラスもしくはインタフェースでなければなりません。

注※2　通常は不要です。追加する場合はあらかじめEntity Beanのクラス定義にも追加しておく必要があります。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」を参照してください。

(b)　複合プライマリキーの場合の属性設定

プライマリキーが複合プライマリキーの場合のプロパティ項目を設定します。

永続性管理種別（<persistence-type>）を確認します。CMP Entity Beanの場合は「Container」が設定されています。

複合プライマリキーのプロパティ設定項目を次に示します。

項目 | 必須 | 対応するタグ名
プライマリキーのクラス※1 | ○ | <prim-key-class>
リエントラント可否 | ○ | <reentrant>
永続性管理フィールドの説明 | △ | <cmp-field> - <description>
永続性管理フィールドのフィールド名※2 | △ | <cmp-field> - <field-name>

（凡例）　○：必須　△：任意

注※1　このEntity Beanのプライマリキーを含むクラスまたはインタフェースを入力します。プライマリキークラスは，java.lang.Objectクラス，またはコンテナ管理フィールドと同じクラスもしくはインタフェースでなければなりません。

注※2　通常は不要です。追加する場合はあらかじめEntity Beanのクラス定義にも追加しておく必要があります。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」を参照してください。

9.6.2　CMP1.xとデータベースのマッピング

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

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

Entity Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEntity Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Entity Bean表示名＞-c ＜Entity Bean属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname account/MyAccoub -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，Entity Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Entity Bean表示名＞-c ＜Entity Bean属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname account/MyAccoub -c C:¥home¥adder_ejb.xml

(3)　編集する属性設定項目

CMP1.x Entity Beanのフィールドをデータベース上の表にマッピングする（<cmp-map>）プロパティ設定項目を次に示します。

項目 | 必須 | 対応するタグ名
リソースアダプタの表示名※1 | ○ | <datasource-name>
データベースのカタログ名 | △ | <catalog-name>
データベースのスキーマ名 | △ | <schema-name>
データベースのテーブル名 | ○ | <table-name>
データベースへの書き込み許可／禁止 | ○ | <read-only-access>
トランザクション遮断レベル※2 | △ | <transaction-isolation>
データベース書き込みデータ照合方法 | △ | <concurrency-protection>
フィールドとテーブルのカラムとのマッピング情報※3 | ○ | <field-impl>
finderメソッドの検索条件※4 | ○ | <finder-impl>

（凡例）　○：必須　△：任意

注※1

クラスタコネクションプールを使用している場合，ルートリソースアダプタの表示名を指定してください。メンバリソースアダプタは指定できません。

注※2

使用できるトランザクション遮断レベル（<transaction-isolation>）の値は，データベースおよびJDBCドライバでサポートされるオプションによって異なります。

注※3

プライマリキーに対してデータベーステーブルの列を設定します。同じデータベーステーブルのフィールドのマッピングにも使用されます。

EntityBeanのフィールド名（<field-name>）の値は変更できません。EntityBeanのフィールド名（<field-name>）のマッピング先のデータベースの列（<column-name>）を設定してください。

フィールドとテーブルのカラムとのマッピング情報（<field-impl>）は，次の項目で構成されています。

項目 | 対応するタグ名
EntityBeanのフィールド名 | <field-name>
テーブルのカラム名 | <column-name>

注※4　

finderメソッドのメソッド名（<method-name>）の値は変更できません。finderメソッドのメソッド名（<method-name>）のテーブルの検索条件（<where-clause>）を設定してください。

Enterprise Bean内のfinderメソッド情報（<finder-impl>）は，次の項目で構成されています。

項目 | 対応するタグ名
finderメソッドのメソッド名 | <method-name>
テーブルの検索条件 | <where-clause>

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」を参照してください。

(4)　注意事項

Entity BeanのCMPフィールドをデータベースの複数の表にマッピングする機能は提供していません。

マッピングで利用するDB Connectorの定義で指定されているユーザと，CMPのマッピング先となるデータベースの表の所有者が異なる場合，DB Connectorの定義で指定されているユーザには次に示す権限が必要です。
マッピング時：SELECT
実行時：SELECT，INSERT，UPDATE，DELETE

9.6.3　CMP2.xとデータベースのマッピング

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

また，ここでは，CMPを定義した二つのCMP2.x Entity Beanの間に関連（CMR）を定義する方法についても説明します。

CMP2.xとデータベースのマッピング手順を，次に示します。

CMP2.x Entity Bean間にCMRの関係がある場合，CMP2.x Entity Bean間にCMRを定義します。

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

CMP2.x Entity Beanに対してcjgencmpsqlコマンドを実行してSQL文を生成します。

＜この項の構成＞

(1)　CMRの定義

(2)　CMP2.xとデータベースのマッピング

(3)　SQL文の生成

(4)　CMR用の表

(1)　CMRの定義

CMPを定義した二つのCMP2.x Entity Beanの間にCMRの関係がある場合，CMP2.x Entity Bean間にCMRを定義します。

(a)　編集する属性ファイル

EJB-JAR属性ファイル

(b)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEJB-JAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞ -c ＜EJB-JAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，EJB-JAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞ -c ＜EJB-JAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder -c C:¥home¥adder_ejb.xml

注意事項

開始状態のアプリケーションに含まれるEJB-JAR属性ファイルの取得はできますが，定義された関連情報の反映はできません。

(c)　編集する属性設定項目

二つのCMP2.x Entity Bean間の関係を定義する（<relationships> - <ejb-relation>）プロパティ設定項目を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
関連定義名 | ○ | <ejb-relation-name>
Enterprise Bean（EJB1）情報 | ○ | <ejb1>
Enterprise Bean（EJB2）情報 | ○ | <ejb2>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.3.1　EJB-JAR属性ファイルの指定内容」を参照してください。

Enterprise Bean（EJB1）情報（<ejb1>）とEnterprise Bean（EJB2）情報（<ejb2>）について，それぞれ，設定側のEnterprise Beanと相手側のEnterprise Beanの関連についての項目を指定します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
関連のロール名 | △ | <ejb-relationship-role-name>
設定側の多重度 | ○ | <multiplicity>
カスケードデリートの設定 | ○ | <cascade-delete>
設定側の<ejb-name> | ○ | <ejb-name>
CMRフィールドの名称 | ○ | <cmr-field-name>
CMRフィールドの型 | △ | <cmr-field-type>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.3.1　EJB-JAR属性ファイルの指定内容」を参照してください。

(2)　CMP2.xとデータベースのマッピング

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

(a)　編集する属性ファイル

編集する属性ファイルについては，「9.6.2　CMP1.xとデータベースのマッピング」の「(1)　編集する属性ファイル」を参照してください。

(b)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの所得と属性の設定については，「9.6.2　CMP1.xとデータベースのマッピング」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(c)　編集する属性設定項目

CMP2.x Entity Beanのフィールドをデータベース上の表にマッピングする（<cmp-map>）プロパティ設定項目を次に示します。

項目 | 必須 | 対応するタグ名
リソースアダプタの表示名※1 | ○ | <datasource-name>
データベースのカタログ名 | △ | <catalog-name>
データベースのスキーマ名 | △ | <schema-name>
データベースのテーブル名 | ○ | <table-name>
データベースへの書き込み許可／禁止 | ○ | <read-only-access>
トランザクション遮断レベル※2 | △ | <transaction-isolation>
データベース書き込みデータ照合方法 | △ | <concurrency-protection>
フィールドとテーブルのカラムとのマッピング情報※3 | ○ | <field-impl>

（凡例）　○：必須　△：任意

注※1

クラスタコネクションプールを使用している場合，ルートリソースアダプタの表示名を指定してください。メンバリソースアダプタは指定できません。

注※2

使用できるトランザクション遮断レベル（<transaction-isolation>）の値は，データベースおよびJDBCドライバでサポートされるオプションによって異なります。

注※3

プライマリキーに対してデータベーステーブルの列を設定します。同じデータベーステーブルのフィールドのマッピングにも使用されます。

EntityBeanのフィールド名（<field-name>）の値は変更できません。EntityBeanのフィールド名（<field-name>）のマッピング先のデータベースの列（<column-name>）を設定してください。

フィールドとテーブルのカラムとのマッピング情報（<field-impl>）は，次の項目で構成されています。

項目 | 対応するタグ名
EntityBeanのフィールド名 | <field-name>
テーブルのカラム名 | <column-name>

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」を参照してください。

(d)　注意事項

Entity BeanのCMPフィールドをデータベースの複数の表にマッピングする機能は提供していません。

マッピングで利用するDB Connectorの定義で指定されているユーザと，CMPのマッピング先となるデータベースの表の所有者が異なる場合，DB Connectorの定義で指定されているユーザには次に示す権限が必要です。
マッピング時：SELECT
実行時：SELECT，INSERT，UPDATE，DELETE

CMPフィールドのマッピングが終わっていない場合，およびアプリケーションが開始状態の場合は，SQLを生成できません。

CMRの関係を結ぶ二つのBeanのテーブルは同じデータベース製品のデータベース上になくてはいけません。

(3)　SQL文の生成

finder/selectメソッドが実行されたときに使用されるSQL文を生成します。

CMP2.x Entity Bean間にCMRの関係がない場合

定義されたEJB QL（<query>）を基にSQL文を生成します。

CMP2.x Entity Bean間にCMRの関係がある場合

SQL文の生成をする前に，まず，すべてのCMP2.x Entity Beanについてフィールドを表の列にマッピングします。すべてのBeanについてマッピング操作の終了後，すべてのCMP2.x Entity BeanについてSQL文を生成してください。Entity Beanにfinder/selectメソッドがない場合でも同様にSQL文を生成してください。

なお，Entity Bean間にCMRの関係がある場合は，finder/selectメソッドが実行されたときに使用されるSQL文のほかに，CMR用の表を操作するためのSQL文も生成されます。一度SQLを生成したあとにCMRの設定を変更した場合は，開始する前に，変更したCMRに関するEntity BeanについてSQL文を生成してください。CMR用の表の詳細については，「(4)　CMR用の表」を参照してください。

次に示すコマンドを実行してSQL文を生成します。

J2EEアプリケーションに含まれるすべてのCMP2.x Entity BeanのSQL文を生成する場合

実行形式

cjgencmpsql ［＜サーバ名称＞］ -name J2EEアプリケーション名

実行例

cjgencmpsql MyServer -name App1

J2EEアプリケーションに含まれる，特定のCMP2.x Entity BeanのSQL文を生成する場合

実行形式

cjgencmpsql ［＜サーバ名称＞］ -name J2EEアプリケーション名 -resname ＜EJB-JARの表示名/Entity Beanの表示名＞

実行例

cjgencmpsql MyServer -name App1 -resname EjbJar1/Ejb1

cjgencmpsqlコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgencmpsql（CMP2.x Entity Bean用SQL文の生成）」を参照してください。

(4)　CMR用の表

ここでは，CMR用の表について説明します。

なお，以降の説明では，EJB-JARの<ejb1> - <ejb-name>で設定されているEntity Beanを「Bean1」，<ejb2> - <ejb-name>で設定されているEntity Beanを「Bean2」と呼びます。

(a)　CMR用の表の概要

EJBコンテナでは，CMP2.x Entity Beanの間にCMRの関係があった場合，データベース上に表を作り，CMRの状態の保持のために利用します。

次の図に示すようにCMR用の表には関係を結ぶ二つのEntity Beanのプライマリキーが格納されます。

図9-1　CMR用の表（1対1，双方向の関係の場合）

(b)　CMR用の表の生成と削除

CMRを含むアプリケーションを開始すると，CMR用の表が生成されます。生成される場所はBean1の表があるスキーマです。この表はアプリケーションの停止時に削除されます。表の生成，削除，操作のためのSQLは，アプリケーションをカスタマイズするときのデータベースマッピングのあとで生成されたSQLを使用します。

アプリケーションが開始状態のままサーバを停止させた場合はCMR用の表はデータベース上に残ります。また，アプリケーションが開始状態のままサーバが再起動された場合は，CMR用の表がデータベース上にあるかどうかをチェックします。アプリケーションの開始時およびサーバ起動時のCMR用の表生成処理を次の表に示します。

表9-4　アプリケーションの開始時およびサーバ起動時のCMR用の表生成処理

状態 | 作成する表と同名の表がデータベース上にあるかどうか | 同名の表がある場合，列の数，名前，JDBC型が同じかどうか | 動作 | 出力メッセージID
開始時※1 | なし | 該当しない | 表を生成し，利用します。 | KDJE43007-I
あり | 同じまたは同じでない | 開始を中断します。※2 | KDJE43003-E
J2EEサーバ起動時 | なし | 該当しない | 開始を中断します。※3 | KDJE43008-E
あり | 同じ | 開始時にCMR用として作ったものであると判断し，利用します。 | KDJE43006-I
同じでない | 開始を中断します。※3 | KDJE43008-E

注※1

CMRを含むアプリケーションの開始時のオプションを特に設定していないデフォルトの場合です。開始時のオプションについては，「(e)　障害発生時のCMR用の表の回復」を参照してください。

注※2

同じ名前の表がすでにデータベース上にあるとアプリケーションの開始に失敗します。すでにある表が不要の場合，データベース製品で提供しているツールを使用して手動で削除するか，SQL生成を再度実行してください。SQL生成を再度実行すると，データベーススキーマ上の表と重複しない名前が表に付けられ，SQLが生成し直されます（SQL生成は，EJB-JAR内のすべてのEJBのすべてのメソッドについて行ってください。これを行わないと表名の変更がすべてのSQLに反映されないおそれがあります）。そのあと，再度アプリケーションを開始してください。

注※3

対象アプリケーションが開始されていない状態でJ2EEサーバが起動します。

(c)　CMR用の表の命名規則

CMR用の表の名前は次のようになります。

双方向の関係の場合
［Bean1の<ejb-name>］_［Bean1の<cmr-field-name>］_［Bean2の<ejb-name>］_［Bean2の<cmr-field-name>］

単方向の関係の場合（方向はBean1からBean2とします）
［Bean1の<ejb-name>］_［Bean1の<cmr-field-name>］_［Bean2の<ejb-name>］

ただし，この方法で決めた名前が29文字以上になった場合は，28文字になるように切ります。28文字になるように切った名前がデータベース上の既存の表の名前や同じEJB-JAR内のほかのCMR用の表の名前と重なる場合は，0～99の番号を末尾に付けて区別します。

(d)　CMRについての注意事項

ユーザはBean1の表があるスキーマで，CREATE TABLEを行う権限が必要です。

データベースやOSの種別によってはプライマリキーのサイズの制限で，CMR用の表の生成に失敗することがあります。図9-1に示すように，CMR用の表にはEntity Beanのプライマリキーを格納するので，Entity Beanのプライマリキーのサイズを調整してください。

アプリケーションの停止時にCMR用の表は削除されるため，それまでに結んだrelationの情報が失われてしまいます。また，CMR用の表を手動で削除した場合もrelationの情報は失われます。

CMR用の表の名前を付ける場合に0～99の100種類の番号を使い切ったときは，CMR用の表が生成できません。データベース上の不要な表を削除してその名前を使用できるようにするか，または「(c)　CMR用の表の命名規則」を参考にして異なる名前を付けられるようにしてください。

relationを結ぶEntity Beanのプライマリキーはデータベースの表のプライマリキーにできる型へマッピングしてください。

CMRを含むアプリケーションの停止時にCMR用の表は削除されますが，データベースへアクセスできないような障害発生などでCMR用の表の削除に失敗する場合があります。この場合は，表がデータベース上に残るため，不要なときはデータベース製品で提供しているツールを使用して手動で削除してください。

(e)　障害発生時のCMR用の表の回復

CMRを含むアプリケーションが開始され，運用していた状態で保守などのためにJ2EEサーバを停止，起動したときに障害が発生すると，CMRを含むアプリケーションが開始された状態で立ち上がらないことが考えられます。障害を解決し，再度CMRを含むアプリケーションを開始しようとしても，表9-4に示されるように作成する表と同名の表がデータベース上にある場合，開始ができません（アプリケーション間で表の共有を避けるため）。

ここで，SQL生成を再度実行すると，新しいCMR用の表名を使用したSQLが生成され，新しいCMR用の表を使用するように開始ができます。しかし，J2EEサーバを停止する以前に使用していた関係を継続させたい場合，データベースに残っている表を使うように開始する必要があります。

usrconf.propertiesファイルのejbserver.ejb.cmp20.cmr.use.existing_tableキーは，アプリケーションの起動障害発生時，それまで使用していた関係の情報を回復させるためのオプションです。このキーにtrueを指定すると，データベース既存の表を使用するように開始できます。このキーに何も指定しない，またはfalseを指定した場合は，表9-4の動作をします。このオプションを使用して，既存の表を使用する場合の手順を次に示します。

障害発生前に使用していたCMR用の表がデータベース上に残っていることを，データベース製品で提供しているツールなどを使用して確認してください。

J2EEサーバを停止します（アプリケーションが開始状態で立ち上がることに失敗した原因の対処をしてください）。

usrconf.propertiesファイルにejbserver.ejb.cmp20.cmr.use.existing_table=trueを設定します。

J2EEサーバを起動します。

開始に失敗したCMRを含むアプリケーションを再度開始します。

注意事項

ここでSQL生成を再実行しないでください。再実行すると新しいテーブル名でSQLが生成され，以前の表が使用できなくなります。

J2EEサーバを停止します。

usrconf.propertiesファイルにejbserver.ejb.cmp20.cmr.use.existing_table=falseを設定するか，またはこのオプションを設定しない状態に戻します。

再度J2EEサーバを起動します。

9.7　サーブレットとJSPのリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）のリファレンス（リソース参照）を定義します。次に示すリファレンスがあります。

Enterprise Beanリファレンス
Enterprise Bean呼び出しのための参照です。

リソースリファレンス
データベースまたはメールサーバへの参照です。メールリファレンス，リソースアダプタリファレンス，およびリソース環境リファレンスがあります。

＜この節の構成＞

9.7.1　Enterprise Beanのリファレンス定義

9.7.2　メールコンフィグレーションのリファレンス定義

9.7.3　リソースアダプタのリファレンス定義

9.7.4　リソース環境のリファレンス定義

9.7.1　Enterprise Beanのリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）がEnterprise Beanを呼び出している場合，リファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

Enterprise Beanが，ほかのEnterprise Beanを呼び出している場合のプロパティ設定項目と同じです。「9.3.1　ほかのEnterprise Beanのリファレンス定義」の「(3)　編集する属性設定項目」を参照してください。

9.7.2　メールコンフィグレーションのリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）が，メールコンフィグレーションを参照している場合，リファレンスを定義するためのプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの所得と属性の設定については，「9.7.1　Enterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

Enterprise Beanがメールコンフィグレーションを参照している場合のプロパティ設定項目と同じです。「9.3.2　メールコンフィグレーションのリファレンス定義」の「(3)　編集する属性設定項目」を参照してください。

9.7.3　リソースアダプタのリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）が，リソースアダプタを参照している場合，リファレンスを定義するためのプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの所得と属性の設定については，「9.7.1　Enterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

Enterprise Beanがリソースアダプタを参照している場合のプロパティ設定項目と同じです。「9.3.3　リソースアダプタのリファレンス定義」の「(3)　編集する属性設定項目」を参照してください。

9.7.4　リソース環境のリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）がリソース環境を参照している場合，リファレンスを定義するためのプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの所得と属性の設定については，「9.7.1　Enterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

Enterprise Beanがリソース環境を参照している場合のプロパティ設定項目と同じです。「9.3.4　リソース環境のリファレンス定義」の「(3)　編集する属性設定項目」を参照してください。

9.8　サーブレットとJSPのマッピング定義

サーブレットおよびJSPのマッピングを定義します。

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

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

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してサーブレット属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞/＜サーブレットおよびJSPの表示名＞ -c ＜サーブレット属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder/adder_sv -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，サーブレット属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞/＜サーブレットおよびJSPの表示名＞ -c ＜サーブレット属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder/adder_sv -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

項目 | 必須 | 対応するタグ名
URLパターン | ○ | <url-pattern>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.9.1　サーブレット属性ファイルの指定内容」を参照してください。

9.9　フィルタの設定

フィルタの設定方法について説明します。フィルタを設定するには，フィルタをWARファイルに追加して，マッピングを定義します。

＜この節の構成＞

9.9.1　フィルタの追加

9.9.2　フィルタのマッピング定義

9.9.3　フィルタの削除

9.9.1　フィルタの追加

次の手順で，WARファイルにフィルタを追加します。

フィルタ属性ファイルを作成します。
テキストエディタなどを使用して，フィルタ属性ファイルを作成します。フィルタ属性ファイルには，フィルタ名称およびフィルタのクラス名を指定します。また，必要に応じて，初期化パラメタの名称および初期化パラメタの値を指定します。
フィルタ属性ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.8　フィルタ属性ファイル」を参照してください。

次に示すコマンドを実行してJ2EEアプリケーション内のWARファイルにフィルタを登録します。

実行形式

cjaddapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type filter -name ＜J2EEアプリケーション名＞ -warname ＜フィルタを追加するWARの表示名＞ -c ＜フィルタ属性ファイルパス＞

実行例

cjaddapp MyServer -type filter -name App1 -warname account-war -c FilterProp.xml

cjaddappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjaddapp（リソースの追加）」を参照してください。

9.9.2　フィルタのマッピング定義

フィルタの追加後，フィルタのマッピングを定義します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WARの表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WARの表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

Webアプリケーション（サーブレットおよびJSP）のフィルタマッピング定義（<filter-mapping>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
フィルタ名 | ○ | <filter-name>
URLパターン | ○※2 | <url-pattern>
サーブレット名 | ○※2 | <servlet-name>
フィルタの適用条件※1 | △ | <dispatcher>

（凡例）　○：必須　△：任意

注※1　Servlet2.3以前のWARには，この属性は設定できません。

注※2　フィルタのマッピングは，URLパターンまたはサーブレット名のどちらかを指定してください。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

9.9.3　フィルタの削除

次に示すコマンドを実行してフィルタを削除します。

実行形式

cjdeleteapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type filter -resname ＜削除するWARの表示名＞/＜削除するフィルタの表示名＞

WARファイルごとフィルタを削除する場合は，削除するWARの表示名を指定します。フィルタだけを削除する場合は，削除するWARの表示名とフィルタの表示名を指定します。

実行例

cjdeleteapp MyServer -name App1 -type filter -resname account-war/account-filter

cjdeleteappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeleteapp（J2EEアプリケーションの削除）」を参照してください。

9.10　Enterprise Beanの実行時属性の定義

次に示すEnterprise Beanの実行時属性を定義します。

Stateful Session Bean

Stateless Session Bean

Entity Bean

Message-driven Bean

＜この節の構成＞

9.10.1　Stateful Session Beanの実行時プロパティの設定

9.10.2　Stateless Session Beanの実行時プロパティの設定

9.10.3　Entity Beanの実行時プロパティの設定

9.10.4　Message-driven Beanの実行時プロパティの設定

9.10.1　Stateful Session Beanの実行時プロパティの設定

アプリケーションを構成する個々のStateful Session Beanに対して，アプリケーション実行時のプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

Session Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してSession Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Stateful Session Bean表示名＞ -c ＜Session Bean属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder/MyAdder -c C:¥home¥MyAdder.xml

●属性の設定

次に示すコマンドを実行して，Session Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Stateful Session Bean表示名＞ -c ＜Session Bean属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder/MyAdder -c C:¥home¥MyAdder.xml

(3)　編集する属性設定項目

Stateful Session Beanの実行時プロパティは，次の二つに分けられます。

Session Bean共通の実行時属性

Stateful Session Bean固有の属性

ぞれぞれの設定項目を次に示します。

(a)　Session Bean共通の実行時属性

Session Bean共通の実行時属性（<runtime>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
Enterprise Beanのルックアップ名※1 | ○ | <lookup-name>
リモートインタフェースを持つEnterprise Bean名の別名※1 | △ | <optional-name>
ローカルインタフェースを持つEnterprise Bean名の別名※1 | △ | <local-optional-name>
セッション最大数※2 | △ | <maximum-sessions>
参照渡しの設定※3 | △ | <pass-by-reference>

（凡例）　○：必須　△：任意

注※1

JNDI名前空間に登録される名称の参照と変更については，「9.13.2　Enterprise Bean名の参照と変更」を参照してください。

注※2

Stateful Session Beanに指定された最大セッション数は，EJBクライアントアプリケーションから利用できるStateful Session Beanの最大数です。「0」を指定した場合，同時に生成できるStateful Session Beanのセッション（EJBオブジェクト）の数は無制限（実際の最大値は2147483647）になります。

注※3

参照渡しの設定は，usrconf.propertiesファイルでも実施できます。プロパティまたはusrconf.propertiesファイルのどちらかで設定されていれば，参照渡しの設定は有効になります。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

(b)　Stateful Session Bean固有の属性

Stateful Session Bean固有の実行時属性（<runtime> - <stateful>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
アクティブセッションの最大数 | ○ | <maximum-active-sessions>
再び活性化するまでに，非活性化状態に保持している時間 | ○ | <inactivity-timeout>
セッションが削除されるまでに非活性化状態に保持している時間 | ○ | <removal-timeout>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

プロパティ項目の設定と動作について，次に説明します。

アクティブセッションの最大数

生成されたStateful Session Beanの状態には，次の二つの状態があります。

method-ready状態

passive状態

method-ready状態のStateful Session Beanは，EJBクライアントアプリケーションからアクセスされた時点ですでに実行できるようになっています。

passive状態のStateful Session Beanは，活性化されmethod-ready状態になってから実行できます。

アクティブセッションの最大数に，同時にmethod-ready状態になることができるStateful Session Beanの最大数を指定します。この値は，複数のEJBクライアントアプリケーションからアクセスされたときに，すぐに実行開始できるStateful Session Beanの最大数です。ここで指定した数以上のStateful Session Beanが生成された場合，method-ready状態のStateful Session Beanが幾つか非活性化されpassive状態になります。ただし，このとき，method-ready状態のStateful Session Beanの中でトランザクション中のものについては，非活性化の対象になりません。セッション最大数，またはアクティブセッションの最大数に「0」を指定した場合は，非活性化の機能は動作しません（Stateful Session Beanがmethod-ready状態からpassive状態に移りません）。

再び活性化するまでに，非活性化状態に保持している時間（デフォルト：0（分））

タイムアウト値を分単位で指定します。ここで指定された時間が経過するまでにpassive状態のStateful Session Beanが活性化されない場合，このBeanは削除されます。再び活性化するまでに，非活性化状態に保持している時間に「0」を設定した場合は，タイムアウトは発生しません。また，Stateful Session Beanのインスタンスの削除は，指定した<inactivity-timeout>値に対し，最大でejbserver.container.passivate.scan.intervalに指定した時間分の遅延が生じることがあります。この起動間隔を変更したい場合は，usrconf.propertiesファイルのシステムプロパティejbserver.container.passivate.scan.intervalに起動間隔を秒単位で指定してください。デフォルトでは0秒が設定されています。ejbserver.container.passivate.scan.intervalの指定例を次に示します。

10分間隔でpassive状態のStateful Session Beanの削除機能を起動したい場合

ejbserver.container.passivate.scan.interval=600

セッションが削除されるまでに非活性化状態に保持している時間（デフォルト：0（分））

タイムアウト値を分単位で指定します。method-ready状態のStateful Session Beanがここで指定された時間の間，一度も使用されない場合，このBeanは削除されます。ただし，このとき，method-ready状態のStateful Session Beanの中でトランザクション中のものについては，削除の対象になりません。

セッションが削除されるまでに非活性化状態に保持している時間に「0」を設定した場合は，タイムアウトは発生しません。また，Stateful Session Beanのインスタンスの削除は，指定した<removal-timeout>値に対し，最大でejbserver.container.remove.scan.intervalに指定した時間分の遅延が生じることがあります。この起動間隔を変更したい場合は，J2EEサーバ用のusrconf.propertiesファイルのejbserver.container.remove.scan.intervalに起動間隔を分位で指定してください。デフォルト値には5分が仮定されています。ejbserver.container.remove.scan.intervalの指定例を次に示します。

10分間隔でmethod-ready状態のStateful Session Beanの削除機能を起動したい場合

ejbserver.container.remove.scan.interval=10

(4)　注意事項

デフォルトのユーザ定義では，「ejbActivate，ejbPassivateを呼び出し，Stateful Session Beanの状態を保存，復元する機能」であり，デフォルトでは，Stateful Session Beanの活性化，非活性化は動作しません。したがって，Stateful Session BeanのEnterprise Bean実行時プロパティとして設定できる，<maximum-active-sessions>の設定は有効になりません。また，非活性化されたStateful Session Beanをタイムアウトで削除する機能は，動作しません。したがって，Stateful Session BeanのEnterprise Bean実行時プロパティとして設定できる，<inactivity-timeout>の設定は有効になりません。

活性化，非活性化の機能を利用する場合は，J2EEサーバ用のusrconf.propertiesファイルで，ejbserver.stateful.passivate.switchキーに対し「true」を指定します。

非活性化が動作するとき，Stateful Session Beanの状態はファイルに書き込むことで保存され，インスタンスは破棄されます。逆に活性化が動作するときはファイルからStateful Session Beanの状態が読み込まれインスタンスが復元されます。活性化，非活性化が動作する場合，Stateful Session Bean（またはそれが参照するクラス）のメンバ変数に設定されているオブジェクトも保存，復元の対象になります。このとき，保存，復元ができるものを次に示します。

直列化できるオブジェクト

EJBオブジェクトリファレンス

EJBホームオブジェクトリファレンス

"java:comp/env"のルックアップで取得したjavax.naming.Context

javax.ejb.SessionContext

なお，javax.jta.UserTransactionは保存，復元できないため，メンバ変数に保持しないでください。保存，復元ができないオブジェクトをメンバ変数に保持している場合は，ejbPassivateで解放し（メンバ変数にnull代入），ejbActivateで再取得してください。

同時に生成できるStateful Session Beanのセッションの最大数とmethod-ready状態のStateful Session Beanの最大数は次の条件を満たすように指定してください。

method-ready状態のStateful Session Beanの最大数≦同時に生成できるStateful Session Beanのセッションの最大数

また，同時に生成できるStateful Session Beanのセッションの最大数を指定した場合，method-ready状態のStateful Session Beanの最大数も指定する必要があります。

9.10.2　Stateless Session Beanの実行時プロパティの設定

アプリケーションを構成する個々のStateless Session Beanに対して，アプリケーション実行時のプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

Session Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してSession Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Stateless Session Bean表示名＞ -c ＜Session Bean属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder/MyAdder -c C:¥home¥MyAdder.xml

●属性の設定

次に示すコマンドを実行して，Session Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Stateless Session Bean表示名＞ -c ＜Session Bean属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder/MyAdder -c C:¥home¥MyAdder.xml

(3)　編集する属性設定項目

Stateless Session Beanの実行時プロパティは，次の三つに分けられます。

Session Bean共通の実行時属性

Stateless Session Bean固有の属性

CTM連携の実行時属性

ぞれぞれの設定項目を次に示します。

(a)　Session Bean共通の実行時属性

Session Bean共通の実行時属性（<runtime>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
Enterprise Beanのルックアップ名※1 | ○ | <lookup-name>
リモートインタフェースを持つEnterprise Bean名の別名※1 | △ | <optional-name>
ローカルインタフェースを持つEnterprise Bean名の別名※1 | △ | <local-optional-name>
セッション最大数※2 | △ | <maximum-sessions>
スケジューリングの設定※3 | △ | <enable-scheduling>
参照渡しの設定※4 | △ | <pass-by-reference>

（凡例）　○：必須　△：任意

注※1

JNDI名前空間に登録される名称の参照と変更については，「9.13.2　Enterprise Bean名の参照と変更」を参照してください。

注※2

Stateless Session Beanに指定された最大セッション数は，クライアントが使用できるStateless Session Beanインスタンス数を定義します。ただし，この指定値は有効にはなりません。

注※3

CTMのスケジューリングについては，「9.14　CTMのスケジューリング」を参照してください。

注※4

参照渡しの設定は，usrconf.propertiesファイルでも実施できます。プロパティまたはusrconf.propertiesファイルのどちらかで設定されていれば，参照渡しの設定は有効になります。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

(b)　Stateless Session Bean固有の属性

Stateless Session Bean固有の実行時属性（<runtime> - <stateless>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
プール内のインスタンスの最小値 | ○ | <pooled-instance> - <minimum>
プール内のインスタンスの最大値 | ○ | <pooled-instance> - <maximum>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

プロパティ項目の設定と動作について，次に説明します。

プール内のインスタンスの最小値

J2EEアプリケーション起動時にここで指定した数のStateless Session Beanが生成され，プーリングされます。プーリングされるStateless Session Beanの数は，EJBクライアントアプリケーションからのアクセス量に応じて，最大数と最小数の間になります。プール内のインスタンスの最小値に「0」を指定した場合は，J2EEアプリケーション起動時にStateless Session Beanが生成されません。

この値は，アプリケーションが開始されたときに作成するStateless Session Beanインスタンスの数も指定します。

プール内のインスタンスの最大値

生成されたStateless Session Beanは，method-readyでプーリングされます。プーリングされたStateless Session Beanは，EJBクライアントアプリケーションからアクセスされた時点ですでに実行できるようになっています。プール内のインスタンスの最大値に，プーリングされるStateless Session Beanの最大数を指定します。この値は，複数のEJBクライアントアプリケーションからアクセスされたときに，すぐに実行開始できるStateless Session Beanの最大数です。プール内のインスタンスの最大値に0を指定した場合は，プーリングされるStateless Session Beanの数に制限はありません。

(c)　CTM連携の実行時属性

CTM連携の実行時属性（<runtime> - <scheduling>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
キュー名 | ○ | <queue-name>
スレッド数 | ○ | <parallel-count>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

CTMのスケジューリングについては，「9.14　CTMのスケジューリング」を参照してください。

(4)　注意事項

クライアント側からアクセスできるStateless Session Beanの上限数をチェックする機能は動作しません。代わりに＜プール内のインスタンスの最大値＞で設定します。

プーリングされるStateless Session Beanの最小数とプーリングされるStateless Session Beanの最大数は，次の条件を満たすように指定してください。

プーリングされるStateless Session Beanの最小数≦プーリングされるStateless Session Beanの最大数

また，プーリングされるStateless Session Beanの最大数を指定した場合，プーリングされるStateless Session Beanの最小数も指定する必要があります。

9.10.3　Entity Beanの実行時プロパティの設定

アプリケーションを構成する個々のEntity Beanに対して，アプリケーション実行時のプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

Entity Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEntity Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Entity Bean表示名＞ -c ＜Entity Bean属性ファイルパス＞

実行例

cjgetappprop MyServer -name account -type ejb -resname account/MyAccount -c C:¥home¥MyAccount.xml

●属性の設定

次に示すコマンドを実行して，Entity Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Entity Bean表示名＞ -c ＜Entity属性ファイルパス＞

実行例

cjsetappprop MyServer -name account -type ejb -resname account/MyAccount -c C:¥home¥MyAccount.xml

(3)　編集する属性設定項目

Entity Beanの実行時属性（<runtime>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
Enterprise Beanのルックアップ名※1 | ○ | <lookup-name>
リモートインタフェースを持つEnterprise Bean名の別名※1 | △ | <optional-name>
ローカルインタフェースを持つEnterprise Bean名の別名※1 | △ | <local-optional-name>
セッション最大数※2 | △ | <maximum-instances>
参照渡しの設定※3 | △ | <pass-by-reference>
プール内のインスタンスの最大値 | ○ | <pooled-instance> - <maximum>
プール内のインスタンスの最小値 | ○ | <pooled-instance> - <minimum>
データのキャッシュ方法 | ○ | <caching-model>
EJBオブジェクトの存在期限 | △ | <entity-timeout>

（凡例）　○：必須　△：任意

注※1

JNDI名前空間に登録される名称の参照と変更については，「9.13.2　Enterprise Bean名の参照と変更」を参照してください。

注※2

Entity Beanに指定された最大セッション数は，EJBクライアントアプリケーションから利用できるEntity Beanの最大値です。0を指定した場合は，同時に生成できるEntity Beanのリモートオブジェクトの数は無制限（実際の最大値は2147483647）になります。

注※3

参照渡しの設定は，usrconf.propertiesファイルでも実施できます。プロパティまたはusrconf.propertiesファイルのどちらかで設定されていれば，参照渡しの設定は有効になります。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」を参照してください。

プロパティ項目の設定と動作について，次に説明します。

プール内のインスタンスの最大値

メモリ上でプーリングされるEntity Beanには，次の二つの状態があります。

ready状態
ready状態のEntity Beanは，データがデータベース上からインスタンス中に読み込まれた状態のもので，Entity Beanとしてのアイデンティティを持っています。ready状態のものはEJBクライアントアプリケーションからアクセスされた時点ですでに実行できるようになっています。

pool状態
pool状態のEntity Beanは，データがデータベース上からインスタンス中に読み込まれていない状態のもので，Entity Beanとしてのアイデンティティを持っていません。pool状態のものは，一度活性化されready状態になってから実行できます。

ready状態のEntity Beanが多くなると，幾つかが非活性化されpool状態になります。ただし，このとき，ready状態のEntity Beanの中でトランザクション処理中のものについては，非活性化の対象になりません。

プール内のインスタンスの最大値（<pooled-instance> - <maximum>）には，プーリングされるready状態とpool状態のEntity Beanの最大数を指定します。これは，メモリ上に展開されるEntity Beanインスタンスの上限です。

プール内のインスタンスの最大値に「0」を指定した場合は，プーリングされるEntity Beanインスタンスの数は無制限になります。

プールされたインスタンスの数がこの値を超えると，J2EEサーバは，最も活性でないインスタンスを非活性化します。

プール内のインスタンスの最小値

プーリングされるready状態とpool状態のEntity Beanの最小数を指定します。この値は，メモリ上に展開されるEntity Beanインスタンスの下限です。J2EEアプリケーション起動時にここで指定した数のEntity Beanが生成され，pool状態，またはready状態になりプーリングされます。プーリングされるEntity Beanの数は，EJBクライアントアプリケーションからのアクセス量に応じて，最大数と最小数の間になります。

プール内のインスタンスの最小値（<pooled-instance> - <minimum>）に0を指定した場合は，J2EEアプリケーション起動時にEntity Beanが生成されません。クライアントに参照されないEntity Beanインスタンスを，最低幾つメモリに保持しておくかを指定します。この値は，プール内のインスタンスの最大値（<pooled-instance> - <maximum>）の値を超えてはいけません。

データのキャッシュ方法

Entity Beanのキャッシュモデル（コミットオプション）を指定します。

Full caching（commit option A）
トランザクション開始時にデータベースからEntity Beanインスタンスにデータが読み込まれないため，Entity Beanが前回のトランザクションコミット時と同じ状態のままでトランザクションが開始されます（例えば，前回のトランザクションコミット時からトランザクション開始時の間にほかのJ2EEサーバがEntity Beanを更新した場合，Entity Beanの状態の一貫性が保たれません）。Full cachingは参照系のEntity Bean用のキャッシュモデルです。

Caching（commit cache option B）
トランザクション開始時にデータベースからEntity Beanインスタンスにデータが読み込まれるため，Entity Beanがデータベースの最新状態と同じ状態でトランザクションが開始されます。Cachingは更新系のEntity Bean用のキャッシュモデルです。

No caching（commit cache option C）
トランザクションコミット時にEntity Beanが非活性化されます。トランザクション開始時には，一度活性化され，データベースからEntity Beanインスタンスにデータが読み込まれます。このため，Entity Beanがデータベースの最新状態と同じ状態でトランザクションが開始されます。No cachingは更新系のEntity Bean用です。また，トランザクションコミット時に必ず非活性化されるため，多数のEntity Beanを利用する場合のキャッシュモデルです。

EJBオブジェクトの存在期限

タイムアウト値を秒単位で指定します。値は，0または正の整数値で指定します。パッシベイトされたEntity BeanのEJBオブジェクトは，最小でこのタイムアウト値に指定した時間，最大でこのタイムアウト値に指定した時間+usrconf.propertiesファイルのejbserver.container.passivate.scan.intervalに指定した値の時間だけ存在します。クライアントからタイムアウト値の時間を経過してもアクセスされない場合，該当するEJBオブジェクトは削除されます。

EJBオブジェクトの存在期限（<entity-timeout>）に「0」を指定した場合は，タイムアウトは発生しません。

(4)　注意事項

同時に生成できるEntity BeanのEJBオブジェクトの最大数に上限を指定した場合，プーリングされるEntity Beanの最大数にも上限を指定しなければいけません。

同時に生成できるEntity BeanのEJBオブジェクトの最大数，プーリングされるEntity Beanの最大数，プーリングされるEntity Beanの最小数の値は，次の条件を満たすように指定してください。

プーリングされるEntity Beanの最小数≦プーリングされるEntity Beanの最大数≦同時に生成できるEntity BeanのEJBオブジェクトの最大数

9.10.4　Message-driven Beanの実行時プロパティの設定

アプリケーションを構成する個々のMessage-driven Beanに対して，アプリケーション実行時のプロパティを設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

Message-driven Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してMessage-driven Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Message-driven Bean表示名＞ -c ＜Message-driven Bean属性ファイルパス＞

実行例

cjgetappprop MyServer -name message -type ejb -resname message/MyMessageBean -c C:¥home¥MyMessageBean.xml

●属性の設定

次に示すコマンドを実行して，Message-driven Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Message-driven Bean表示名＞ -c ＜Message-driven Bean属性ファイルパス＞

実行例

cjsetappprop MyServer -name message -type ejb -resname message/MyMessageBean -c C:¥home¥MyMessageBean.xml

(3)　編集する属性設定項目

Message-driven Beanの実行時属性（<runtime>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
プール内のインスタンスの最大値※ | ○ | <pooled-instance> - <maximum>

（凡例）　○：必須

注※　Server Sessionプールの初期化時に指定値までBeanを生成します。1～2147483647（int型の最大値）を指定できます。デフォルト値は1です。指定数分のJMSセッションを生成するため，JMSプロバイダで生成できるJMSセッション数に合わせて定義します。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」を参照してください。

9.11　サーブレットとJSPの実行時属性の定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）の実行時属性を定義します。次に示す定義があります。

J2EEアプリケーションのコンテキストルートの定義

Webアプリケーション単位での同時実行スレッド数制御の定義

URLグループ単位での同時実行スレッド数制御の定義

URLグループ単位の実行待ちリクエストの監視の定義

それぞれの定義で設定するプロパティ項目を次に示します。

＜この節の構成＞

9.11.1　J2EEアプリケーションのコンテキストルート定義

9.11.2　Webアプリケーション単位での同時実行スレッド数制御の定義

9.11.3　URLグループ単位での同時実行スレッド数制御の定義

9.11.4　URLグループ単位の実行待ちリクエスト数の監視の定義

9.11.1　J2EEアプリケーションのコンテキストルート定義

J2EEアプリケーションのコンテキストルートを定義します。

コンテキストルートには，ルートコンテキストも定義できます。ルートコンテキストとは，コンテキストルートが空文字""のコンテキストです。ルートコンテキストにwelcomeファイルを作成すると，「http://www.cosminexus.com/」のようなドメイン名だけのURLからJ2EEアプリケーションのトップページを表示できるようになります。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

J2EEアプリケーションのコンテキストルート定義（<runtime>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
コンテキストルート | ○ | <context-root>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

(4)　注意事項

コンテキストルートには，"ejb/"，または"web/"から始まる文字列を指定しないでください。
複数のJ2EEアプリケーションでコンテキストルートのパスの構成要素が包含関係（例："test"と"test/jsp"）にある場合で，包含する方のパスを含むURL（例："/test/jsp/test.jsp"）を指定してアクセスしたときは，包含する方のアプリケーション（例では，"test/jsp"をコンテキストルートに持つ方）が有効になり，包含される方のアプリケーション（例では，"test"をコンテキストルートに持つ方）にはアクセスできません。

コンテキストルートは，作業ディレクトリ中のディレクトリ名として用いられます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにコンテキストルートを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

ルートコンテキストを使用して開始するWebアプリケーションでは，URLが"ejb"または"web"で始まる構成にしないでください。

コンソールおよびログファイルに出力されるメッセージでは，ルートコンテキストのコンテキストルートは，空文字「""」で表示されます。

9.11.2　Webアプリケーション単位での同時実行スレッド数制御の定義

Webコンテナで同時実行スレッド数を制御するための定義をします。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

Webコンテナで同時実行スレッド数を制御するためのプロパティ設定項目（<thread-control>）を次に示します。

項目 | 必須 | 対応するタグ名
最大同時実行スレッド数 | ○ | <thread-control-max-threads>
占有して使用するスレッド数 | ○ | <thread-control-exclusive-threads>
Webアプリケーション単位の実行待ちキューサイズ | ○ | <thread-control-queue-size>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

(4)　注意事項

Webアプリケーション単位での同時実行スレッド数制御を有効にするためには，J2EEサーバ用のusrconf.propertiesファイルのwebserver.container.thread_control.enabledキーに「true」を指定してください。

9.11.3　URLグループ単位での同時実行スレッド数制御の定義

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

URLグループ単位での同時実行スレッド数制御を有効にするためは，Webアプリケーション単位での同時実行スレッド数制御の定義を設定してください。Webアプリケーション単位での同時実行スレッド数制御については，「9.11.2　Webアプリケーション単位での同時実行スレッド数制御の定義」を参照してください。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

URLグループ単位で同時実行スレッド数を制御するためのプロパティ設定項目（<urlgroup-thread-control>）を次に示します。

項目 | 必須 | 対応するタグ名
定義名 | ○ | <urlgroup-thread-control-name>
最大同時実行スレッド数 | ○ | <urlgroup-thread-control-max-threads>
占有スレッド数 | ○ | <urlgroup-thread-control-exclusive-threads>
URLグループ単位の実行待ちキューサイズ | ○ | <urlgroup-thread-control-queue-size>
URLパターン | ○ | <urlgroup-thread-control-mapping> - <url-pattern>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

(4)　注意事項

URLグループ単位での同時実行スレッド数制御で実行されるスレッド数は，Webアプリケーション単位で実行されるスレッド数に含まれています。したがって，URLグループ単位で一つスレッドが実行されている場合，このWebアプリケーションのWebアプリケーション単位でも一つスレッドが実行されていることになります。

URLグループ単位での同時実行スレッド数は，次の範囲で設定します。

最大同時実行スレッド数
最大同時実行スレッド数の指定範囲を次に示します。

1　≦　URLグループ単位の最大同時実行スレッド数の総和　≦　Webアプリケーション単位の最大同時実行スレッド数

占有スレッド数
占有スレッド数の指定範囲を次に示します。
条件1と条件2は，すべて満たしている必要があります。

条件1：

Webアプリケーション単位の最大同時実行スレッド数＝Webアプリケーション単位の占有スレッド数の場合
0　≦　URLグループ単位の占有スレッド数　≦　URLグループ単位の最大同時実行スレッド数

Webアプリケーション単位の最大同時実行スレッド数≠Webアプリケーション単位の占有スレッド数の場合
0　≦　URLグループ単位の占有スレッド数　<　URLグループ単位の最大同時実行スレッド数

条件2：

URLグループ単位の占有スレッド数の総和　≦　Webアプリケーション単位の占有スレッド数

9.11.4　URLグループ単位の実行待ちリクエスト数の監視の定義

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

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

URLグループ単位の実行待ちリクエスト数を監視するためのプロパティ設定項目（<urlgroup-thread-control> - <stats-monitor> - <waiting-request-count>）を次に示します。

項目 | 必須 | 対応するタグ名
しきい値イベント監視有無 | ○ | <enabled>
しきい値イベントの出力上限しきい値※ | ○ | <high-threshold>
しきい値イベントの出力下限しきい値※ | ○ | <low-threshold>

（凡例）　○：必須

注※　「しきい値イベントを出力する上限しきい値≧しきい値イベントを出力する下限しきい値」となるよう指定してください。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

9.12　デフォルトの文字エンコーディングの設定

Webアプリケーション単位にデフォルトの文字エンコーディングを設定します。

次の文字エンコーディングについて，デフォルトのエンコーディングが設定できます。

リクエストボディおよびクエリの文字エンコーディング

レスポンスボディの文字エンコーディング

JSPファイルの文字エンコーディング

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

●属性ファイルの設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder_war -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

デフォルトの文字エンコーディングのプロパティ設定項目を次に示します。

項目 | 必須 | 対応するタグ名
リクエストボディおよびクエリの文字エンコーディング | △ | <http-request> - <encoding>
レスポンスボディの文字エンコーディング | △ | <http-response> - <encoding>
JSPファイルの文字エンコーディング | △ | <jsp> - <page-encoding>

（凡例）　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

9.13　JNDI名前空間に登録される名称の参照と変更

JNDI名前空間に登録されるJ2EEアプリケーション名やEnterprise Bean名を変更します。Enterprise Bean名には，別名も付けられます。

EJBホームオブジェクトは，J2EEアプリケーション開始時にJNDI名前空間（HITACHI_EJB/SERVERS/＜サーバ名称＞/EJB/＜J2EEアプリケーション名＞/＜Enterprise Bean名＞）に割り当てられます。この名前は，EJBクライアントアプリケーションから参照する場合やネーミングの切り替え機能を使って参照する場合に使用します。

EJBホームオブジェクトには，別名（Optional Name）が付けられます。別名を付けることで，EJBクライアントアプリケーションはJNDI名前空間から任意の名前でEJBホームオブジェクトを取得できるようになります。なお，この機能をユーザ指定名前空間機能といいます。

なお，EJBホームオブジェクトのJNDI名前空間については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3　JNDI名前空間へのオブジェクトのバインドとルックアップ」を参照してください。ユーザ指定名前空間機能については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.4　Enterprise BeanまたはJ2EEリソースへの別名付与（ユーザ指定名前空間機能）」を参照してください。

＜この節の構成＞

9.13.1　J2EEアプリケーション名の参照

9.13.2　Enterprise Bean名の参照と変更

9.13.1　J2EEアプリケーション名の参照

J2EEアプリケーション名の参照は，次の手順で実行します。

アプリケーション属性ファイルを取得します。
次に示すコマンドを実行して，アプリケーション属性ファイルを取得します。
実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -c ＜アプリケーション属性ファイルパス＞

実行例

cjgetappprop MyServer -name account -c C:¥home¥accountAPP.xml

テキストエディタなどでアプリケーション属性ファイルを開きます。
アプリケーション属性ファイルのJ2EEアプリケーション名（<lookup-name>）を参照します。

cjgetapppropコマンドについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetappprop（アプリケーションの属性の取得）」を参照してください。属性ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.2　アプリケーション属性ファイル」を参照してください。

注意事項

JNDI名前空間に登録されるJ2EEアプリケーション名はJ2EEアプリケーション名を基に自動的に割り当てられます。変更はできません。

9.13.2　Enterprise Bean名の参照と変更

次のEnterprise BeanのEnterprise Bean名を参照および変更します。

Session Bean

Entity Bean

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

Session Bean属性ファイル

Entity Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次のコマンドを実行して，Enterprise Bean属性ファイル（Session Bean属性ファイルまたはEntity Bean属性ファイル）を取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Bean属性ファイルパス※＞

注※　Enterprise Bean属性ファイルパスには，Session Bean属性ファイルまたはEntity Bean属性ファイルのファイルパスを指定します。

実行例

cjgetappprop MyServer -name account -type ejb -resname account/MyAccount -c C:¥home¥MyAccount.xml

●属性ファイルの設定

次のコマンドを実行して，Enterprise Bean属性ファイル（Session Bean属性ファイルまたはEntity Bean属性ファイル）の値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Bean属性ファイルパス※＞

注※　Enterprise Bean属性ファイルパスには，Session Bean属性ファイルまたはEntity Bean属性ファイルのファイルパスを指定します。

実行例

cjsetappprop MyServer -name account -type ejb -resname account/MyAccount -c C:¥home¥MyAccount.xml

(3)　編集する属性設定項目

Enterprise Bean属性ファイル（Session Bean属性ファイルまたはEntity Bean属性ファイル）のEnterprise Bean名を，実行時属性（<runtime>）で参照および変更します。

項目 | 必須 | 対応するタグ名
Enterprise Beanのルックアップ名 | ○ | <lookup-name>
リモートインタフェースを持つEnterprise Bean名の別名 | △ | <optional-name>
ローカルインタフェースを持つEnterprise Bean名の別名 | △ | <local-optional-name>

（凡例）　○：必須　△：任意

プロパティの設定項目については，次の個所を参照してください。

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

(4)　注意事項

usrconf.propertiesファイルのejbserver.cui.optionalname.enabledキーにtrueが設定されていて，かつEJBがリモートインタフェースを実装している場合にだけ指定できます。

JNDI名前空間に登録されるEnterprise Bean名の初期値は，Enterprise Beanのejb-nameが使われます。

Message-driven BeanにはJNDI名前空間に登録されるEnterprise Bean名がありません。

9.14　CTMのスケジューリング

CTMを利用する場合の，スケジューリングについて設定します。CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus アプリケーションサーバ 概説」の「2.3.1　製品と構成ソフトウェアの対応」を参照してください。

次の手順で，CTMのスケジューリングを設定します。

アプリケーション単位のスケジューリングを設定します。

スケジューリングの対象にしたいStateless Session Beanのスケジューリングを設定します。

＜この節の構成＞

9.14.1　J2EEアプリケーション単位のスケジューリング

9.14.2　Stateless Session Bean単位のスケジューリング

9.14.1　J2EEアプリケーション単位のスケジューリング

J2EEアプリケーション単位のCTMとの連携にかかわる設定をします。

アプリケーションの属性とSession Beanの属性の両方を設定する必要があるので，アプリケーション統合属性ファイルを使用して設定することを推奨します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

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

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してアプリケーション統合属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type all -c ＜アプリケーション統合属性ファイルパス＞

実行例

cjgetappprop MyServer -name account -type all -c C:¥home¥account.xml

●属性ファイルの設定

次に示すコマンドを実行して，アプリケーション統合属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type all -c ＜アプリケーション統合属性ファイルパス＞

実行例

cjsetappprop MyServer -name account -type all -c C:¥home¥account.xml

(3)　編集する属性設定項目

編集する属性設定項目を次に示します。

アプリケーションの属性

Session Beanの属性

ぞれぞれの設定項目を次に示します。

(a)　アプリケーションの属性

J2EEアプリケーション単位のCTMとの連携にかかわる設定項目を次に示します。

項目 | 必須 | 対応するタグ名
CTM連携有無 | ○ | <managed-by-ctm>
キューの配置モデル | ○ | <scheduling-unit>
キュー名 | ○ | <scheduling> - <queue-name>
スレッド数 | ○ | <scheduling> - <parallel-count>
キューの長さ | △ | <scheduling> - <queue-length>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.2.1　アプリケーション属性ファイルの指定内容」を参照してください。

(b)　Session Beanの属性

J2EEアプリケーション単位のCTMとの連携にかかわる実行時属性設定項目（<session-runtime>）を次に示します。

項目 | 必須 | 対応するタグ名
スケジューリングの設定 | ○ | <enable-scheduling>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

(4)　注意事項

アプリケーション統合属性ファイルを使用しないで，アプリケーション属性ファイルおよびSession Bean属性ファイルを使用して設定する場合は，次の順に設定する必要があります。

次に示すコマンドを実行して，Session Bean属性ファイルの<enable-scheduling>タグの値を反映します。

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Stateless Session Bean表示名＞ -c ＜Session Bean属性ファイルパス＞

次に示すコマンドを実行して，アプリケーション属性ファイルの<managed-by-ctm>タグ，<scheduling-unit>タグ，および<scheduling>タグの下位のタグの値を反映します。

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -c ＜アプリケーション属性ファイルパス＞

9.14.2　Stateless Session Bean単位のスケジューリング

CTMによるスケジューリングの対象に設定したJ2EEアプリケーションに含まれているStateless Session BeanをCTMによるスケジューリングの対象にする場合，Stateless Session Bean単位のスケジューリングの設定をします。

スケジューリングの対象となるのは，リモートホームインタフェースを実装しているStateless Session Beanだけです。

スケジューリング機能を利用する場合，Stateless Session Beanの実行時プロパティを設定します。Stateless Session Beanの実行時プロパティの設定については，「9.10.2　Stateless Session Beanの実行時プロパティの設定」を参照してください。

また，アプリケーションの属性でCTMに連携するための設定をします。

アプリケーションの属性とSession Beanの属性の両方を設定する必要があるので，アプリケーション統合属性ファイルを使用して設定することを推奨します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

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

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してアプリケーション統合属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type all -c ＜アプリケーション統合属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type all -c C:¥home¥Adder.xml

●属性の設定

次に示すコマンドを実行して，アプリケーション統合属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type all -c ＜アプリケーション統合属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type all -c C:¥home¥Adder.xml

(3)　編集する属性設定項目

編集する属性設定項目を次に示します。

アプリケーションの属性

Session Beanの属性

ぞれぞれの設定項目を次に示します。

(a)　アプリケーションの属性

CTMに連携するための設定項目を次に示します。

項目 | 必須 | 対応するタグ名
CTM連携有無 | ○ | <managed-by-ctm>
キューの配置モデル | ○ | <scheduling-unit>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.2.1　アプリケーション属性ファイルの指定内容」を参照してください。

(b)　Session Beanの属性

CTMに連携するための実行時属性設定項目（<session-runtime>）を次に示します。

項目 | 必須 | 対応するタグ名
スケジューリングの設定 | ○ | <enable-scheduling>
キュー名 | ○ | <scheduling> - <queue-name>
スレッド数 | ○ | <scheduling> - <parallel-count>
キューの長さ | △ | <scheduling> - <queue-length>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

(4)　注意事項

アプリケーション統合属性ファイルを使用しないで，アプリケーション属性ファイルおよびSession Bean属性ファイルを使用して設定する場合は，次の順に設定する必要があります。

次に示すコマンドを実行して，Session Bean属性ファイルの<enable-scheduling>タグの値を反映します。

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Stateless Session Bean表示名＞ -c ＜Session Bean属性ファイルパス＞

次に示すコマンドを実行して，アプリケーション属性ファイルの<managed-by-ctm>タグおよび<scheduling-unit>タグの値を反映します。

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -c ＜アプリケーション属性ファイルパス＞

次に示すコマンドを実行して，Session Bean属性ファイルの<scheduling>タグの下位のタグの値を反映します。

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Stateless Session Bean表示名＞ -c ＜Session Bean属性ファイルパス＞

9.15　起動順序の設定

J2EEアプリケーションの起動順序，およびJ2EEアプリケーションに含まれるEnterprise BeanおよびWARの起動順序を設定します。

＜この節の構成＞

9.15.1　J2EEアプリケーションの起動順序の設定

9.15.2　Enterprise Beanの起動順序の設定

9.15.3　サーブレットとJSPの起動順序の設定

9.15.1　J2EEアプリケーションの起動順序の設定

J2EEアプリケーションの起動順序を設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

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

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してアプリケーション属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -c ＜アプリケーション属性ファイルパス＞

実行例

cjgetappprop MyServer -name account -c C:¥home¥MyAccount.xml

●属性の設定

次に示すコマンドを実行して，アプリケーション属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -c ＜アプリケーション属性ファイルパス＞

実行例

cjsetappprop MyServer -name account -c C:¥home¥MyAccount.xml

(3)　編集する属性設定項目

J2EEアプリケーションの起動順序設定項目を次に示します。

項目 | 必須 | 対応するタグ名
開始・停止順※ | △ | <start-order>

（凡例）　△：任意

注※　値が小さいほど，先に起動します。また，値が大きいほど，先に停止します。なお，複数のJ2EEアプリケーションに対して同じ値を指定した場合，それらの間の起動順序は保証されません。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.2.1　アプリケーション属性ファイルの指定内容」を参照してください。

9.15.2　Enterprise Beanの起動順序の設定

Enterprise Beanの起動順序を設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

Session Bean属性ファイル

Entity Bean属性ファイル

Message-driven Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次のコマンドを実行して，編集するEnterprise Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Bean属性ファイルパス※＞

注※　Enterprise Bean属性ファイルパスには，編集する属性ファイルパスを指定します。

実行例

cjgetappprop MyServer -name account_eb -type ejb -resname account/account -c C:¥home¥MyAccount.xml

●属性の設定

次のコマンドを実行して，編集したEnterprise Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Bean属性ファイルパス※＞

注※　Enterprise Bean属性ファイルパスには，値を反映する属性ファイルパスを指定します。

実行例

cjsetappprop MyServer -name account -type ejb -resname account/account_eb -c C:¥home¥MyAccount.xml

(3)　編集する属性設定項目

Enterprise Beanの起動順序設定項目を次に示します。

項目 | 必須 | 対応するタグ名
開始・停止順※ | △ | <start-order>

（凡例）　△：任意

注※　値が小さいほど，先に起動します。また，値が大きいほど，先に停止します。なお，Enterprise Beanに対して同じ値を指定した場合，それらの間の起動順序は保証されません。

プロパティの設定項目については，次の個所を参照してください。

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」

9.15.3　サーブレットとJSPの起動順序の設定

サーブレット，JSPが含まれるWARの起動順序を設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次のコマンドを実行して，次のWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name account -type war -resname account_war -c C:¥home¥account_war.xml

●属性の設定

次のコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name account -type war -resname account_war -c C:¥home¥account_war.xml

(3)　編集する属性設定項目

サーブレット，JSPが含まれるWARの起動順序設定項目を次に示します。

項目 | 必須 | 対応するタグ名
開始・停止順※ | △ | <start-order>

（凡例）　△：任意

注※　値が小さいほど，先に起動します。また，値が大きいほど，先に停止します。なお，サーブレットとJSPに対して同じ値を指定した場合，それらの間の起動順序は保証されません。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

9.16　サーブレットとJSPのエラー通知の設定

次のタイミングでエラーが発生した場合に，エラーを通知してJ2EEアプリケーションの開始処理を中止するかどうかを指定します。

J2EEアプリケーションの開始時にロードするように設定されている（<load-on-startup>が設定されている）サーブレットまたはJSPの初期化処理中にエラーが発生した場合

タグライブラリ解析時にエラーが発生した場合

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(4)　注意事項

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次のコマンドを実行して，次のWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name account -type war -resname account_war -c C:¥home¥account_war.xml

●属性の設定

次のコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name account -type war -resname account_war -c C:¥home¥account_war.xml

(3)　編集する属性設定項目

サーブレット，JSPが含まれるWARのエラー通知の設定項目を次に示します。

項目 | 必須 | 対応するタグ名
開始時のエラー通知有無 | △ | <start-notify-error>

（凡例）　△：任意

(4)　注意事項

Webアプリケーション初期化失敗時のエラー通知の設定可否
J2EEサーバモードでは，Webアプリケーションの初期化で失敗した場合に，J2EEアプリケーションの開始処理を継続するか，エラーを通知してJ2EEアプリケーションの開始処理を中止するかを設定できます。ただし，Webアプリケーションを利用不可とする必要があるエラーが発生した場合は，エラー通知の設定はできません。エラー通知の設定内容に関係なく，J2EEアプリケーションの開始処理が中止されます。
ここでは，Webアプリケーションの初期化失敗の内容とエラー通知設定の可否について説明します。Webアプリケーションの初期化中に発生するエラーの内容と，J2EEアプリケーションの開始処理を継続するか，またはエラーとして中止するかのエラー通知の設定可否を次の表に示します。

表9-5　Webアプリケーションの初期化失敗の内容とエラー通知の設定可否

項目
Webアプリケーション初期化失敗の内容
エラー通知の設定可否

JSP用テンポラリディレクトリ
JSP用テンポラリディレクトリのアクセス権がないため，ディレクトリの生成に失敗した場合。
不可

JSP用テンポラリディレクトリのアクセス権がないため，ディレクトリの削除に失敗した場合。
可

web.xml
web.xmlの解析でエラーが発生した場合。
不可

フィルタ
web.xmlのfilter-class要素に指定したフィルタクラスまたはそれが依存するクラスを見つけることができなかった場合。
不可

web.xmlのfilter-class要素に，次に示す不正なフィルタクラスが指定された場合。

javax.servlet.Filterインタフェースを実装していないクラス

引数を取らないコンストラクタを持っていないクラス

不可

フィルタクラスの初期化で例外が発生した場合。
不可

リスナ
web.xmlのlistener-class要素に指定したリスナクラス，またはそれが依存するクラスを見つけることができなかった場合。
不可

web.xmlのlistener-class要素に，次に示す不正なリスナクラスが指定された場合。

次に示すインタフェースを一つも実装していないクラス
javax.servlet.ServletContextListener
javax.servlet.ServletContextAttributeListener
javax.servlet.ServletRequestListener
javax.servlet.ServletRequestAttributeListener
javax.servlet.http.HttpSessionListener
javax.servlet.http.HttpSessionAttributeListener

引数を取らないコンストラクタを持っていないクラス

不可

リスナクラスの初期化で例外が発生した場合。
不可

web.xmlで<load-on-startup>を指定したサーブレット
web.xmlのservlet-class要素に指定したサーブレットクラス，またはそれが依存するクラスを見つけることができなかった場合。
可

サーブレットの初期化で例外が発生した場合。
可

web.xmlで<load-on-startup>を指定したJSP
web.xmlのjsp-file要素に指定したJSPファイルを見つけることができなかった場合。
可

JSP用テンポラリディレクトリにサブディレクトリを作成する権限がないため，JSPからJavaソースファイルを生成できなかった場合。
可

JSP用テンポラリディレクトリのサブディレクトリにアクセスする権限がないため，JSPからJavaソースファイルを生成できなかった場合。
可

JSPからJavaソースファイルを生成する際にエラーが発生した場合。
可

JSPから生成されたサーブレットのソースコードのコンパイルで，エラーが発生した場合。
可

Servlet2.3以前のWebアプリケーションで，web.xmlの<taglib>タグでtaglibをマッピングしていない，かつJSPのtaglibディレクティブのuri属性に絶対URIを指定した場合。
可

JSPドキュメントの解析中にエラーが発生した場合。
可

JSPの初期化で例外が発生した場合。
可

タグライブラリ
（<load-on-startup>を指定したJSPの延長で実行される場合）
TLDファイルの読み込みができなかった場合。
可

TLDファイルの解析中にエラーが発生した場合。
可

タグライブラリバリデータクラスまたはそれが依存するクラスを見つけることができなかった場合。
可

次に示す不正なタグライブラリバリデータクラスが指定された場合。

javax.servlet.jsp.tagext.TagLibraryValidatorクラスを継承していないクラス

引数を取らないコンストラクタを持っていないクラス

可

タグライブラリバリデータクラスの初期化で例外が発生した場合。
可

タグライブラリバリデータによるJSPの検証で例外が発生した場合。
可

TagExtraInfoクラス，またはそれが依存するクラスを見つけることができなかった場合。
可

不正なTagExtraInfoクラスが指定された場合。不正なTagExtraInfoクラスとは，Tei-class要素またはteiclass要素に指定するクラスが，次のどれかの条件に一致するクラスを指す。

TagExtraInfoクラスを継承していない

インタフェースやabstractクラスである

publicなコンストラクタを持っていない

可

TLDファイルのtei-class要素またはteiclass要素で定義したクラスの初期化で例外が発生した場合。
可

タグライブラリバリデータクラスがJSPページの検証で発見したエラーを報告した場合。
可

TagExtraInfoクラスが属性の検証で発見したエラーを報告した場合。
可

TagExtraInfoクラスによる属性の検証で例外が発生した場合。
可

TLDファイルのfunction-class要素で定義したクラスを見つけることができなかった場合。
可

TLDファイルのfunction-class要素で定義したクラスのロードで例外が発生した場合。
可

TLDファイルのfunction-signature要素で定義したparameterクラスを見つけることができなかった場合。
可

TLDファイルのfunction-signature要素で定義したメソッドを見つけることができなかった場合。
可

TLDファイルのfunction-signature要素で定義したparameterクラスのロード，またはfunction-class要素で指定したクラスへのアクセス時に例外が発生した場合。
可

TLDファイルのtype要素で定義したクラスを見つけることができなかった場合。
可

TLDファイルのtype要素で定義したクラスのロードで例外が発生した場合。
可

9.17　セキュリティロールの設定

セキュリティロールを使用したユーザ管理をする場合に必要な設定です。

設定したユーザおよびロールの情報は，J2EEサーバごとに管理されます。

＜この節の構成＞

9.17.1　ユーザの設定

9.17.2　ロールの設定

9.17.1　ユーザの設定

ユーザを設定します。

次に示すコマンドを実行して，J2EEサーバにユーザを登録します。

実行形式

cjaddsec ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type user -name ＜ユーザ名＞ -password ＜パスワード＞

実行例

cjaddsec MyServer -type user -name cosmi -password tiger

cjaddsecコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjaddsec（ユーザとロールの追加）」を参照してください。

9.17.2　ロールの設定

ロールを設定して，ユーザと関連づけます。また，Enterprise BeanおよびサーブレットとJSPに参照するセキュリティロールを設定します。

＜この項の構成＞

(1)　ロールの登録

(2)　ロールにユーザを登録

(3)　Enterprise Beanへのセキュリティロールの設定

(4)　サーブレットおよびJSPへのセキュリティロールの設定

(1)　ロールの登録

次に示すコマンドを実行して，J2EEサーバにロールを登録します。

実行形式

cjaddsec ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type role -name ＜ロール名＞

実行例

cjaddsec MyServer -type role -name manage

cjaddsecコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjaddsec（ユーザとロールの追加）」を参照してください。

(2)　ロールにユーザを登録

次に示すコマンドを実行してロールにユーザを追加します。

実行形式

cjmapsec ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -role ＜ロール名＞ -user ＜ユーザ名＞ ［-user ＜ユーザ名＞］

実行例

cjmapsec MyServer -role manager -user cosmi

cjmapsecコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjmapsec（ユーザとロールのマッピング）」を参照してください。

(3)　Enterprise Beanへのセキュリティロールの設定

Enterprise Beanへのセキュリティロールの設定を定義します。

(a)　編集する属性ファイル

EJB-JAR属性ファイル

(b)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEJB-JAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞ -c ＜EJB-JAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，EJB-JAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞ -c ＜EJB-JAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder -c C:¥home¥adder_ejb.xml

(c)　編集する属性設定項目

Enterprise Beanのセキュリティロール（<security-role>）の設定項目を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
ロール名 | ○ | <role-name>
セキュリティロール名 | △ | <linked-to>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.3.1　EJB-JAR属性ファイルの指定内容」を参照してください。

(4)　サーブレットおよびJSPへのセキュリティロールの設定

サーブレットおよびJSPへのセキュリティロールの設定を定義します。

(a)　編集する属性ファイル

WAR属性ファイル

(b)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder -c C:¥home¥adder_war.xml

(c)　編集する属性設定項目

Webアプリケーション（サーブレットおよびJSP）のセキュリティロールのリファレンス（<security-role>）の設定項目を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
ロール名 | ○ | <role-name>
セキュリティロール名 | △ | <linked-to>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

9.18　セキュリティロールのリファレンス定義

J2EEアプリケーションに含まれるEnterprise BeanおよびWARの，一つまたは複数のメソッドに対するセキュリティロールチェックの参照を定義します。このセキュリティチェックは，コンテナで提供されるセキュリティサービスとは別のものです。

＜この節の構成＞

9.18.1　Enterprise Beanのセキュリティロールリファレンスの定義

9.18.2　サーブレットとJSPのセキュリティロールリファレンスの定義

9.18.1　Enterprise Beanのセキュリティロールリファレンスの定義

Enterprise Beanのセキュリティロールのリファレンスを定義します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

Enterprise Beanの種類に対応する属性ファイルを編集します。

Session Bean属性ファイル

Entity Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次のコマンドを実行して，Enterprise Bean属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder/adder_eb -c C:¥home¥adder_ejb.xml

●属性の設定

次のコマンドを実行して，Enterprise Bean属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder/adder_eb -c C:¥home¥adder_ejb.xml

(3)　編集する属性設定項目

Enterprise Beanのセキュリティロールリファレンス（<security-role-ref>）の設定項目を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
セキュリティロール参照名 | ○ | <role-name>
リンク先のセキュリティロール名※ | △ | <role-link>

（凡例）　○：必須　△：任意

注※　設定したロール名を指定します。ロール名の設定については，「9.17.2　ロールの設定」を参照してください。また，<role-link>を設定後，EJB-JAR属性ファイルの設定を行うと<role-link>の値がクリアされますので，再度，セキュリティロールリファレンスを設定してください。

プロパティの設定項目については，次の個所を参照してください。

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

9.18.2　サーブレットとJSPのセキュリティロールリファレンスの定義

Webアプリケーション（サーブレットおよびJSP）のセキュリティロールのリファレンスを定義します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

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

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してサーブレット属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞/＜サーブレットおよびJSPの表示名＞ -c ＜サーブレット属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder/adder_sv -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞/＜サーブレットおよびJSPの表示名＞ -c ＜サーブレット属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder/adder_sv -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

Webアプリケーション（サーブレットおよびJSP）のセキュリティロールのリファレンス（<security-role-ref>）の設定項目を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
セキュリティロール参照名 | ○ | <role-name>
リンク先のセキュリティロール名※ | △ | <role-link>

（凡例）　○：必須　△：任意

注※　設定したロール名を指定します。ロール名の設定については，「9.17.2　ロールの設定」を参照してください。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.9.1　サーブレット属性ファイルの指定内容」を参照してください。

9.19　セキュリティの定義（メソッドパーミッション）

メソッドパーミッションの設定方法について説明します。メソッドパーミッションの定義では，セキュリティロールによるアクセス制御を定義します。すべてのユーザにアクセス権限を与えることや，どのユーザにもアクセス権限を与えないこともできます。

メソッドパーミッションを設定できるメソッドは次のとおりです。

Session Bean

ホームインタフェースのcreateメソッド

コンポーネントインタフェースのビジネスメソッド，removeメソッド

Entity Bean

ホームインタフェースのcreateメソッド，finderメソッド，homeメソッド

コンポーネントインタフェースのビジネスメソッド，removeメソッド

なお，次に示すメソッドにパーミッションを設定しても使用されません。これらのメソッドのアクセス権限チェックには，コンポーネントインタフェースのremoveメソッドに設定したメソッドパーミッションが使用されます。

javax.ejb.EJBHomeのremove(javax.ejb.Handle handle)メソッド

javax.ejb.EJBHomeのremove(Object primaryKey)メソッド

javax.ejb.EJBLocalHomeのremove(Object primaryKey)メソッド

注意

CTMを使用するアプリケーションで<Enable Scheduling>プロパティが指定されたStateless Session Beanでは，ホームインタフェースのcreateメソッドにセキュリティロールによるアクセス権限を設定しないでください。設定した場合，デプロイに失敗します。

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

次のEnterprise Beanの種類に対応する属性ファイルを編集します。

Session Bean属性ファイル

Entity Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEnterprise Beanの属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder/adder-eb -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，Enterprise Beanの属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder/adder-eb -c C:¥home¥adder_ejb.xml

(3)　編集する属性設定項目

セキュリティの定義（メソッドパーミッション）の設定項目（<method-permission>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
ロール名 | △※ | <role-name>
メソッド認証有無 | △※ | <unchecked>
メソッドの説明 | △ | <method> - <description>
インタフェース種別 | △ | <method> - <intf>
メソッド名 | △ | <method> - <name>

（凡例）　△：任意

注　セキュリティの定義（メソッドパーミッション）の設定項目（<method-permission>）は，アノテーションで設定している場合，変更できません。

注※　セキュリティ管理をする場合，ロール名とメソッド認証有無は，次のように，どちらか一つ設定します。

セキュリティロールによるアクセス権限を設定する場合
ロール名（<role-name>）を指定します。

すべてのユーザにアクセス権限を与える場合
メソッド認証有無（<unchecked>）を指定します。

どのユーザにもアクセス権限を与えない場合は，<method-permission>で指定するのではなく，<exclude-list>の下の<method>にアクセス権を与えないメソッドの情報を指定します。

プロパティの設定項目については，，次の個所を参照してください。

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

9.20　セキュリティの定義（セキュリティアイデンティティ）

セキュリティアイデンティティの設定には，次の二つの場合があります。

Enterprise Beanが使用する実行時アイデンティティ情報を設定します。

サーブレットが使用する実行時アイデンティティ情報を設定します。

＜この節の構成＞

9.20.1　Enterprise Beanのセキュリティアイデンティティ

9.20.2　サーブレットとJSPのセキュリティアイデンティティ

9.20.1　Enterprise Beanのセキュリティアイデンティティ

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

セキュリティアイデンティティとしては，「UseCallerIdentity」と「RunAs」の二つのタイプを設定できます。

UseCallerIdentity
メソッド実行時に呼び出し元セキュリティアイデンティティを使用し，動作します。
Enterprise Beanのホームインタフェースやコンポーネントインタフェースのメソッド実行時に，その実行スレッドに関連づけるセキュリティアイデンティティを設定します。

RunAs
Role nameで指定したロールのアイデンティティに従い，動作します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

次のEnterprise Beanの種類に対応する属性ファイルを編集します。

Session Bean属性ファイル

Entity Bean属性ファイル

Message-driven Bean属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEnterprise Beanの属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞-c ＜Enterprise Bean属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname addr/adder_eb -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，Enterprise Beanの属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Bean属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder/adder_eb -c C:¥home¥adder_ejb.xml

(3)　編集する属性設定項目

Enterprise Beanのセキュリティの定義（セキュリティアイデンティティ）の設定項目（<security-identity>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
セキュリティアイデンティティ設定有無 | △※ | <use-caller-identity>
ロールのアイデンティティの説明 | △ | <run-as> - <description>
セキュリティロールの名称 | △※ | <run-as> - <role-name>
セキュリティロールに設定された名称 | △ | <run-as> - <user-name>

（凡例）　△：任意

注※　セキュリティアイデンティティの設定をする場合，メソッド実行時に呼び出し元セキュリティアイデンティティを使用するかどうかで，次のように，どちらか一つ設定します。

メソッド実行時に呼び出し元セキュリティアイデンティティを使用する場合
セキュリティアイデンティティ設定有無（<use-caller-identity>）を設定します。

メソッド実行時に呼び出し元セキュリティアイデンティティを使用しない場合
ロールのアイデンティティ（<run-as>）情報を設定します。

Message-driven Beanの場合は，ロールのアイデンティティ（<run-as>）情報だけ設定できます。

プロパティの設定項目については，次の個所を参照してください。

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」

9.20.2　サーブレットとJSPのセキュリティアイデンティティ

サーブレットとJSPのセキュリティアイデンティティを定義します。

サーブレットがEJB呼び出し時に使用する実行時アイデンティティ情報を設定します。

＜この項の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

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

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してサーブレット属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞/＜サーブレットおよびJSPの表示名＞ -c ＜サーブレット属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder/adder_sv -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，サーブレット属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞/＜サーブレットおよびJSPの表示名＞ -c ＜サーブレット属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder/adder_sv -c C:¥home¥adder_war.xml

(3)　編集する属性設定項目

Webアプリケーション（サーブレットおよびJSP）のセキュリティの定義（セキュリティアイデンティティ）の設定項目（<security-identity>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
ロールのアイデンティティの説明 | △ | <run-as> - <description>
セキュリティロールの名称 | ○ | <run-as> - <role-name>
セキュリティロールに設定された名称 | △ | <run-as> - <name>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.9.1　サーブレット属性ファイルの指定内容」を参照してください。

9.21　インターセプタの設定

インターセプタの設定方法について説明します。Cosminexusでインターセプタを使用する場合は，EJB-JARの属性として設定してください。

＜この節の構成＞

(1)　編集する属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

(3)　編集する属性設定項目

(1)　編集する属性ファイル

EJB-JAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEJB-JAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞ -c ＜EJB-JAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname adder -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，EJB-JAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞ -c ＜EJB-JAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname adder -c C:¥home¥adder_ejb.xml

注意事項

開始状態のアプリケーションに含まれるEJB-JAR属性ファイルの取得はできますが，定義された関連情報の反映はできません。

(3)　編集する属性設定項目

インターセプタの設定項目（<interceptor-binding>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
インターセプタのEJB名 | ○ | <ejb-name>
インターセプタクラスのクラス名 | △ | <interceptor-class>
インターセプタの実行順序の設定（インターセプタクラスのクラス名） | △ | <interceptor-order>-<interceptor-class>
デフォルトインターセプタの呼び出し抑止の設定 | △ | <exclude-default-interceptors>
クラスレベルインターセプタの呼び出し抑止の設定 | △ | <exclude-class-interceptors>
EJBのビジネスメソッド名 | △ | <named-method>-<method-name>
メソッドの引数 | △ | <named-method>-<method-params>-<method-param>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.3.1　EJB-JAR属性ファイルの指定内容」を参照してください。

インターセプタの設定方法や注意事項については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」の「2.15　インターセプタの使用」を参照してください。

9.22　そのほかのプロパティの設定

J2EEアプリケーションの作成およびカスタマイズで設定する，そのほかのプロパティ項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」を参照してください。

10.　J2EEアプリケーションの実行

この章では，サーバ管理コマンドを使用したJ2EEアプリケーションの実行について説明します。

＜この章の構成＞

10.1　J2EEアプリケーションの実行の概要

10.2　J2EEアプリケーションの開始と停止

10.3　J2EEアプリケーションの一覧の参照

10.4　J2EEアプリケーションの削除

10.5　テストモードによるJ2EEアプリケーションの実行

10.6　J2EEアプリケーションの入れ替え

10.7　J2EEアプリケーション名の変更

10.8　RMI-IIOPスタブとインタフェースの取得

10.9　トランザクション一覧の参照

10.1　J2EEアプリケーションの実行の概要

J2EEアプリケーションとして必要なプロパティや動作の定義が終わったら，J2EEアプリケーションは実行できます。

J2EEアプリケーションの実行の概要について次に示します。

表10-1　J2EEアプリケーションの実行の概要

設定項目
内容
J2EEアプリケーションの形式
参照先

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

J2EEアプリケーションの開始と停止
J2EEアプリケーションを，通常開始またはJSPをコンパイルして開始します。
J2EEアプリケーションを，通常停止または強制停止します。
○
○
10.2

J2EEアプリケーションの一覧の参照
インポートされているアプリケーションの一覧を参照します。
○
○
10.3

J2EEアプリケーションの削除
J2EEアプリケーションを削除します。
○
△※1
10.4

テストモードによるJ2EEアプリケーションの実行
実行中のアプリケーションをテストモードに切り替えます。
○
○
10.5

J2EEアプリケーションの入れ替え
J2EEサーバ上の，次のJ2EEアプリケーションを入れ替えます。

アーカイブ形式のアプリケーション

展開ディレクトリ形式のアプリケーション

△※2
△※2
10.6

J2EEアプリケーション名の変更
J2EEアプリケーションの名前を変更します。
○
○
10.7

RMI-IIOPスタブとインタフェースの取得
J2EEアプリケーションのRMI-IIOPスタブおよびインタフェースを取得します。
○
○
10.8

トランザクション一覧の参照
トランザクションの情報の一覧を参照します。
J2EEサーバが稼働中の場合は，稼働状況や，開始してからの経過時間などのトランザクションの情報を表示します。
J2EEサーバが停止中の場合は，ステータスファイルにある，仕掛かり中のまま残っている未決着トランザクションの状況を表示します。
○
○
10.9

（凡例）　○：実行できる　△：実行条件がある

注※1　アプリケーションからコンポーネントの削除はできません。

なお，フィルタの追加は，アプリケーションの属性変更であるため実行できます。

注※2　J2EEアプリケーションの入れ替えは，次のコマンドを使用します。

アーカイブ形式の場合　cjreplaceappコマンド

展開ディレクトリ形式の場合　cjreloadappコマンド

10.2　J2EEアプリケーションの開始と停止

ここでは，J2EEアプリケーションの開始と停止について説明します。

＜この節の構成＞

10.2.1　J2EEアプリケーションの開始

10.2.2　J2EEアプリケーションの停止

10.2.1　J2EEアプリケーションの開始

ここでは，次のJ2EEアプリケーションの開始方法について説明します。

通常開始

JSPをコンパイルして開始

＜この項の構成＞

(1)　J2EEアプリケーションの通常開始

(2)　JSPをコンパイルして開始

(1)　J2EEアプリケーションの通常開始

次に示すコマンドを実行してJ2EEアプリケーションを開始します。J2EEアプリケーションにリソースアダプタが含まれている場合，J2EEアプリケーションに含まれるすべてのリソースアダプタも自動で開始されます。

実行形式

cjstartapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞

実行例

cjstartapp MyServer -name account

cjstartappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartapp（J2EEアプリケーションの開始）」を参照してください。

注意事項

J2EEアプリケーションが，J2EEリソースアダプタを参照している場合，J2EEリソースアダプタを開始してから，J2EEアプリケーションを開始してください。

J2EEアプリケーションに含まれるリソースアダプタは，開始順序を制御はできません。

ほかのJ2EEアプリケーションに含まれるEnterprise Beanを呼び出す場合，呼び出し先のJ2EEアプリケーションを開始してから，呼び出し元のJ2EEアプリケーションを開始してください。

(2)　JSPをコンパイルして開始

J2EEアプリケーションに含まれるすべてのJSPファイルのコンパイルを実行して，J2EEアプリケーションを開始します。

次に示すコマンドを実行します。

実行形式

cjstartapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -jspc

実行例

cjstartapp MyServer -name App1 -jspc

cjstartappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartapp（J2EEアプリケーションの開始）」を参照してください。

注意事項

アーカイブ形式のアプリケーションの場合，アプリケーションの開始時にJSP事前コンパイルを実施して生成されたJSPコンパイル結果は，アプリケーションの停止時に削除されます。

アプリケーション開始時のJSP事前コンパイルで生成したJSPコンパイル結果をアプリケーションの停止後も利用する場合，次の手順を実行します。

JSPの事前コンパイルを指定してアプリケーションを開始します。

アプリケーションをエクスポートします。

リデプロイ機能などを使用して，JSPコンパイル結果を含むアプリケーションに入れ替えます。
J2EEアプリケーションの入れ替えについては，「10.6　J2EEアプリケーションの入れ替え」を参照してください。

また，アプリケーション開始時のJSP事前コンパイルを実行したあとに，アプリケーションの開始に失敗した場合，アプリケーションは停止し，JSPコンパイル結果は削除されます。アプリケーション開始時のJSP事前コンパイルを実行する前に，アプリケーションが正常に開始できることを確認してください。

10.2.2　J2EEアプリケーションの停止

ここでは，J2EEアプリケーションの通常停止と強制停止について説明します。

＜この項の構成＞

(1)　J2EEアプリケーションの通常停止

(2)　J2EEアプリケーションの強制停止

(1)　J2EEアプリケーションの通常停止

次に示すコマンドを実行して，J2EEアプリケーションを通常停止します。J2EEアプリケーションにリソースアダプタが含まれている場合，J2EEアプリケーションに含まれるすべてのリソースアダプタも自動で停止されます。

実行形式

cjstopapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞

実行例

cjstopapp MyServer -name account

cjstopappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstopapp（J2EEアプリケーションの停止）」を参照してください。

注意事項

J2EEアプリケーションがJ2EEリソースアダプタとしてデプロイしたリソースアダプタを参照している場合，J2EEアプリケーションを停止してから，J2EEリソースアダプタを停止してください。

J2EEアプリケーションに含まれるリソースアダプタは，停止順序を制御はできません。

ほかのJ2EEアプリケーションに含まれるEnterprise Beanを呼び出す場合，呼び出し元のJ2EEアプリケーションを停止してから，呼び出し先のJ2EEアプリケーションを停止してください。

アーカイブ形式のアプリケーションの場合，アプリケーション開始時のJSP事前コンパイルを実行して生成されたコンパイル結果は，アプリケーションの停止時に削除されます。

(2)　J2EEアプリケーションの強制停止

J2EEアプリケーションを強制停止します。

J2EEアプリケーションの強制停止には，次の二つがあります。

J2EEアプリケーションの通常停止を実行して，J2EEアプリケーションが停止しなかった場合に強制停止を実行します。

停止しなかった場合に自動に強制停止を実行するオプションを指定して，J2EEアプリケーションの通常停止を実行します。

それぞれの強制停止の手順について，次に示します。

(a)　J2EEアプリケーションの通常停止を実行してJ2EEアプリケーションが停止しなかった場合に強制停止を実行する

「(1)　J2EEアプリケーションの通常停止」の手順で，J2EEアプリケーションの通常停止を実行してもJ2EEアプリケーションが正常に停止しなかった場合，次の手順でJ2EEアプリケーションを強制停止できます。

なお，J2EEアプリケーションの強制停止は，通常停止を実行してもJ2EEアプリケーションが正常に停止しなかった場合にだけ実行してください。

次に示すコマンドを実行してJ2EEアプリケーションを強制停止します。

実行形式

cjstopapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -cancel

実行例

cjstopapp MyServer -name account -cancel

cjstopappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstopapp（J2EEアプリケーションの停止）」を参照してください。

(b)　J2EEアプリケーションの自動強制停止オプションを指定して，通常停止を実行する

J2EEアプリケーションの通常停止を実行してもJ2EEアプリケーションが正常に停止しなかった場合，タイムアウト時間が経過すると自動的に強制停止を実行できます。

次のコマンドを実行して，通常停止しないJ2EEアプリケーションを自動的に強制停止します。

実行形式

cjstopapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -t ＜タイムアウト時間（秒）＞ -force

実行例

cjstopapp MyServer -name account -t 120 -force

cjstopappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstopapp（J2EEアプリケーションの停止）」を参照してください。

10.3　J2EEアプリケーションの一覧の参照

次のコマンドを実行して，インポートされているJ2EEアプリケーションの一覧を参照します。

J2EEアプリケーションが展開ディレクトリ形式の場合，アプリケーションディレクトリのパスを表示します。

実行形式

cjlistapp ［＜サーバ名称＞］

実行例

cjlistapp MyServer

cjlistappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

10.4　J2EEアプリケーションの削除

J2EEアプリケーションを削除します。

次に示すコマンドを実行してJ2EEアプリケーションを削除します。

実行形式

cjdeleteapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞

実行例

cjdeleteapp MyServer -name account

cjdeleteappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeleteapp（J2EEアプリケーションの削除）」を参照してください。

注意事項

展開ディレクトリ形式のJ2EEアプリケーションを削除する場合，削除対象のJ2EEアプリケーションのアプリケーションディレクトリは削除されません。J2EEサーバへの登録が解除されます。

10.5　テストモードによるJ2EEアプリケーションの実行

テストモードでJ2EEアプリケーションを実行することで，J2EEアプリケーションを本番環境で問題なく実行できるかを確認します。

次の二つの場合について説明します。

新規作成したJ2EEアプリケーションをテストモードで実行します。

J2EEアプリケーションを入れ替える場合にテストモードを使用します。

＜この節の構成＞

(1)　新規作成したJ2EEアプリケーションをテストモードで実行する

(2)　J2EEアプリケーションを入れ替える場合にテストモードを使用する

(1)　新規作成したJ2EEアプリケーションをテストモードで実行する

新規作成したJ2EEアプリケーションをテストモードで実行します。また，本番環境で問題なく実行できることを確認してから通常モードに切り替えます。

J2EEアプリケーションをテストモードでインポートします。
J2EEアプリケーションをテストモードでインポートするには，-testオプションを指定したcjimportappコマンドを実行します。J2EEアプリケーションのインポート方法については，「8.1　J2EEアプリケーションのインポート」を参照してください。

J2EEアプリケーションをテストモードで開始します。
J2EEアプリケーションをテストモードで開始するには，-testオプションを指定したcjstartappコマンドを実行します。J2EEアプリケーションの開始方法については「10.2.1　J2EEアプリケーションの開始」を参照してください。

テストを実施します。
実際にJ2EEアプリケーションを操作してテストします。問題がないことを確認したら次の手順に進みます。
テスト結果に問題があった場合は，J2EEアプリケーションを修正して，手順1.からもう一度実行してください。なお，同じ名称のJ2EEアプリケーションは同じモードで登録できません。このため，テストが失敗したテストモードのJ2EEアプリケーションは削除してください。テストモードのJ2EEアプリケーションを削除するには，-testオプションを指定したcjdeleteappコマンドを実行します。

テストモードで実行しているJ2EEアプリケーションを停止します。
テストモードで実行中のJ2EEアプリケーションを停止するには，-testオプションを指定したcjstopappコマンドを実行します。J2EEアプリケーションの停止方法については「10.2.2　J2EEアプリケーションの停止」を参照してください。

次に示すコマンドを実行して，J2EEアプリケーションのモードを，テストモードから通常モードへ切り替えます。

実行形式

cjchmodapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -test -name ＜アプリケーション名＞ -mode normal

実行例

cjchmodapp MyServer -test -name App1 -mode normal

cjchmodappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjchmodapp（アプリケーションのモード切り替え）」を参照してください。

テストモードから通常モードへ切り替えたJ2EEアプリケーションを開始します。
J2EEアプリケーションの開始方法については「10.2.1　J2EEアプリケーションの開始」を参照してください。

(2)　J2EEアプリケーションを入れ替える場合にテストモードを使用する

J2EEアプリケーションを入れ替える前に，入れ替えるJ2EEアプリケーションをテストモードで実行します。また，本番環境で問題なく実行できることを確認してから，既存のJ2EEアプリケーションと入れ替えます。

注意

J2EEサーバ内で同じアプリケーションディレクトリを持つ複数のJ2EEアプリケーションは共存できません。展開ディレクトリ形式のアプリケーションの場合はテストモードのアプリケーションと通常モードのアプリケーションでアプリケーションディレクトリを分けてください。

J2EEアプリケーションをテストモードでインポートします。
J2EEアプリケーションをテストモードでインポートするには，-testオプションを指定したcjimportappコマンドを実行します。J2EEアプリケーションのインポート方法については，「8.1　J2EEアプリケーションのインポート」を参照してください。

J2EEアプリケーションをテストモードで開始します。
J2EEアプリケーションをテストモードで開始するには，-testオプションを指定したcjstartappコマンドを実行します。J2EEアプリケーションの開始方法については「10.2.1　J2EEアプリケーションの開始」を参照してください。

テストを実施します。
実際にアプリケーションを操作してテストします。問題がないことを確認したら次の手順に進みます。
テスト結果に問題があった場合は，J2EEアプリケーションを修正して，手順1.からもう一度実行してください。なお，同じ名称のJ2EEアプリケーションは同じモードで登録できません。このため，テストが失敗したテストモードのJ2EEアプリケーションは削除してください。テストモードのJ2EEアプリケーションの削除は，-testオプションを指定したcjdeleteappコマンドを実行します。

テストモードで実行しているJ2EEアプリケーションを停止します。
テストモードで実行中のJ2EEアプリケーション停止するには，-testオプションを指定したcjstopappコマンドを実行します。J2EEアプリケーションの停止方法については「10.2.2　J2EEアプリケーションの停止」を参照してください。

通常モードで実行しているJ2EEアプリケーションを停止します。
J2EEアプリケーションの停止方法については「10.2.2　J2EEアプリケーションの停止」を参照してください。

通常モードで実行していたJ2EEアプリケーションの名称を変更します。
この操作は，インポートしたファイルの世代を管理したい場合などに，必要に応じて実行してください。例えば，「App1」というJ2EEアプリケーションの場合，「App1_bak」などに変更します。
J2EEアプリケーション名の変更方法については，「10.7　J2EEアプリケーション名の変更」を参照してください。

次に示すコマンドを実行して，テストモードで実行していたJ2EEアプリケーションのモードを，テストモードから通常モードへ切り替えます。

実行形式

cjchmodapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -test -name ＜アプリケーション名＞ -mode normal

実行例

cjchmodapp MyServer -test -name App1 -mode normal

cjchmodappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjchmodapp（アプリケーションのモード切り替え）」を参照してください。

テストモードから通常モードへ切り替えたJ2EEアプリケーションを開始します。
J2EEアプリケーションの開始方法については「10.2.1　J2EEアプリケーションの開始」を参照してください。

10.6　J2EEアプリケーションの入れ替え

J2EEサーバモード上で動作するJ2EEアプリケーションの入れ替えには，次の方法があります。

J2EEアプリケーションを再デプロイします。
J2EEアプリケーションをJ2EEサーバから削除し，別のJ2EEアプリケーションを入れ替え，開始します。

リデプロイ機能を使用します。
J2EEアプリケーションがアーカイブ形式の場合に使用できます。

リロード機能を使用します。
展開ディレクトリ形式の場合に使用できます。

この節では，次のJ2EEアプリケーションの入れ替えについて説明します。

リデプロイ機能を使用した，アーカイブ形式のJ2EEアプリケーションの入れ替え

リロード機能を使用した，展開ディレクトリ形式のJ2EEアプリケーションの入れ替え

＜この節の構成＞

10.6.1　アーカイブ形式のアプリケーション

10.6.2　展開ディレクトリ形式のアプリケーション

10.6.1　アーカイブ形式のアプリケーション

リデプロイ機能によって，J2EEサーバにインポートしたアーカイブ形式のJ2EEアプリケーションを，別のJ2EEアプリケーションに入れ替える手順を次に示します。

更新するJavaプログラムをコンパイルします。

EJB-JAR，WARファイルを再生成します。

EARを再生成します。

リデプロイコマンドを実行します。

次のリデプロイコマンドを実行して，アーカイブ形式のJ2EEアプリケーション（EARファイル）を入れ替えます。

実行形式

cjreplaceapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜アプリケーション名＞ -f ＜EARファイルのパス＞ ［-t ＜タイムアウト時間（秒）＞］ ［-replaceDD］

実行例

cjreplaceapp MyServer -name App1 -f App1.ear -t 120

J2EEアプリケーションの入れ替え時には，J2EEアプリケーションのすべての属性を引き継ぐことも，ランタイム属性（属性ファイルの独自の定義）だけを引き継ぐこともできます。ランタイム属性だけを引き継ぎたい場合は-replaceDDオプションを指定します。

cjreplaceappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjreplaceapp（アプリケーションの入れ替え）」を参照してください。

注意事項

この操作はJ2EEアプリケーションが開始，停止のどちらの状態であっても実行できます。開始状態のJ2EEアプリケーションを入れ替える場合，cjreplaceappコマンドを実行すると，処理の中でJ2EEアプリケーションはいったん停止され，入れ替え後に再開始されます。
なお，開始中状態のJ2EEアプリケーションが正常に停止されなかった場合，J2EEアプリケーションは強制停止されます。-tオプションにタイムアウト時間を指定すると，J2EEアプリケーションの強制停止に移行するまでの時間を設定できます。-tオプションにタイムアウト時間を指定しなかった場合，強制停止に移行するまでの時間は60秒です。

JSP事前コンパイルを実行したアプリケーションの入れ替えで，入れ替え後もJSP事前コンパイル機能を使用する場合，入れ替えるアプリケーションにJSPコンパイル結果が含まれていなければなりません。入れ替えるアプリケーションにJSPコンパイル結果が含まれていない場合，Webアプリケーション単位のJSP事前コンパイルを実行し，入れ替えるアプリケーションにJSPコンパイル結果を含めてください。

cosminexus.xmlを含むアプリケーションにリデプロイ機能を使用した場合，入れ替え前のcosminexus.xmlの定義情報を破棄してデフォルト値に戻したあと，入れ替え後のcosminexus.xmlの定義情報を上書きします。そのため，実行環境でサーバ管理コマンドを使って変更したCosminexus アプリケーションサーバ独自の定義情報は失われます。

10.6.2　展開ディレクトリ形式のアプリケーション

リロード機能を使用する場合は，アプリケーションの再生成（EARファイル作成）が不要となり，直接クラスファイルを置き換えるだけでよいため，アプリケーションの入れ替えが容易になります。

リロード機能は，展開ディレクトリ形式を使用し，開始状態およびリロードに失敗して停止状態にあるJ2EEアプリケーションに対してだけ実行できます。

リロード機能を実現するには，次の二つの手段があります。

J2EEサーバが更新を自動的に検知することによるリロード機能

コマンドの実行によるリロード機能

ここでは，コマンドの実行によるリロード機能について説明します。

リロード機能によって，J2EEアプリケーションに入れ替える手順を次に示します。

更新するJavaプログラムをコンパイルします。

リロードコマンドを実行します。

次のリロードコマンドを実行して，展開ディレクトリ形式のJ2EEアプリケーションを入れ替えます。

実行形式

cjreloadapp ［サーバ名］ -name アプリケーション名 ［-t 強制リロード開始までのタイムアウト時間］

実行例

cjreloadapp MyServer -name App1

cjreloadappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjreloadapp（アプリケーションのリロード）」を参照してください。

リロード機能の詳細および更新検知によるリロード機能については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.8　J2EEアプリケーションの更新検知とリロード」を参照してください。

注意事項

デフォルトの設定では，リロード機能は無効になっています。リロード機能を使用するためには，プロパティ設定ファイル（usrconf.properties）のキーを，次のように設定してください。

リロード機能の適用範囲の設定
ejbserver.deploy.context.reload_scope=app

更新検知インターバルの設定
ejbserver.deploy.context.check_interval=1

J2EEアプリケーションの更新検知とリロードの設定については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.8.12　J2EEアプリケーションの更新検知とリロードの設定」を参照してください。

リソースアダプタを含むJ2EEアプリケーションの場合，RARファイルはアーカイブ形式で格納されています。アプリケーションディレクトリ下にあるRARファイルが変更されてもリロードは実行されません。

cosminexus.xmlを含むアプリケーションにリロード機能を使った場合，cosminexus.xmlの定義情報についてはリロードされません。

10.7　J2EEアプリケーション名の変更

J2EEサーバにインポートしたJ2EEアプリケーションの名称を変更します。

J2EEアプリケーションの名称を変更するには，J2EEアプリケーションを停止しておく必要があります。J2EEアプリケーションを停止する方法については「10.2.2　J2EEアプリケーションの停止」を参照してください。

次に示すコマンドを実行してJ2EEアプリケーション名を変更します。

実行形式

cjrenameapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜アプリケーション名＞ -newname ＜変更後のアプリケーション名＞

実行例

cjrenameapp MyServer -name App1 -newname App2

cjrenameappコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjrenameapp（アプリケーション名の変更）」を参照してください。

10.8　RMI-IIOPスタブとインタフェースの取得

J2EEサーバにインポートしたJ2EEアプリケーションのRMI-IIOPスタブとインタフェースを取得します。

J2EEサーバにインポートしたJ2EEアプリケーションのRMI-IIOPスタブおよびインタフェースは，J2EEアプリケーションを一度も開始していない状態では取得できません。

また，J2EEアプリケーション内に，リモートインタフェースを持つEnterprise Beanが存在しない場合，RMI-IIOPスタブおよびインタフェースの取得はエラーになります。

次に示すコマンドを実行してRMI-IIOPスタブおよびインタフェースを取得します。

実行形式

cjgetstubsjar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜アプリケーション名＞ -d ＜RMI-IIOPスタブおよびインタフェースの格納パス＞

実行例

cjgetstubsjar MyServer -name App1 -d temp

注意事項

次の条件を満たすときだけ，この機能を使用できます。

J2EEサーバに旧バージョンで作成したJ2EEアプリケーションが存在する状態で，06-50以降のアプリケーションサーバをアップグレードインストールした場合

cjrenameappコマンドで名称を変更していない場合

次の場合は，index.htmlによるRMI-IIOPスタブおよびインタフェースの取得はできません。

実行時情報を含むJ2EEアプリケーションまたは実行時情報を含まないJ2EEアプリケーションのどちらをインポートした場合も，実行できません。

06-50以降の環境で新規にJ2EEアプリケーションを作成した場合

cjrenameappコマンドで名称を変更した場合

application.xmlを省略したアプリケーションの名前を変更した場合，application.xmlが作成されます。そのため，アプリケーション名を変更したJ2EEアプリケーションはapplication.xmlのあるアプリケーションとなります。

cjgetstubsjarコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetstubsjar（アプリケーションのRMI-IIOPスタブおよびインタフェースの取得）」を参照してください。

10.9　トランザクション一覧の参照

トランザクション情報の一覧を参照します。稼働中のJ2EEサーバで動作しているトランザクション情報，および停止中のJ2EEサーバに残っている未決着トランザクション情報を参照できます。

＜この節の構成＞

(1)　稼働中のJ2EEサーバでのトランザクション情報の表示

(2)　停止中のJ2EEサーバでのトランザクション情報の表示

(1)　稼働中のJ2EEサーバでのトランザクション情報の表示

稼働状況や開始してからの経過時間など，トランザクションの情報の一覧を参照します。

実行形式

cjlisttrn ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-gid ＜グローバルトランザクションID＞］ ［-pending］ ［-time ＜経過時間＞］ ［-bqual］

実行例

トランザクションに関連しているすべてのXidのブランチIDを表示する例

cjlisttrn MyServer -bqual

cjlisttrnコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlisttrn（稼働中のJ2EEサーバのトランザクション情報の表示）」を参照してください。

(2)　停止中のJ2EEサーバでのトランザクション情報の表示

停止中のJ2EEサーバのステータスファイルに残っている，未決着トランザクション情報の一覧を参照します。

次に示すコマンドを実行してトランザクションの一覧を参照します。

実行形式

cjlisttrnfile ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-gid ＜グローバルトランザクションID＞］ ［-bqual］

実行例

指定のグローバルトランザクションIDに関する情報を表示する例

cjlisttrnfile MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001

cjlisttrnfileコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlisttrnfile（停止中のJ2EEサーバのトランザクション情報の表示）」を参照してください。

11.　Server Plug-inの基本操作

この章では，Server Plug-inで論理サーバ，J2EEアプリケーション，リソースアダプタを操作するための基本操作について説明します。

＜この章の構成＞

11.1　Server Plug-inパースペクティブ

11.2　表示の更新

11.3　プロパティの設定

11.4　Server Plug-inの注意事項

11.1　Server Plug-inパースペクティブ

Server Plug-inを使用してリソースアダプタやJ2EEアプリケーションの設定をする場合，あらかじめ，Server Plug-inをEclipseに組み込み，Server Plug-inを使用するための設定が必要です。Server Plug-inのEclipseへの組み込み手順については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.8.2　Server Plug-inの組み込み手順」を参照してください。Server Plug-inを使用するための設定手順については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.8.3　Server Plug-inを使用するためのManagement Serverの設定」を参照してください。

Server Plug-inでは，サーバの起動・停止，J2EEアプリケーションやリソースアダプタの操作を行う作業環境として，［Cosminexus Server Plug-in］パースペクティブ（Server Plug-inパースペクティブ）を提供しています。作業の目的によって必要なビューなどを初期設定した作業環境をパースペクティブといいます。

次の手順で，Server Plug-inパースペクティブを開きます。

Eclipseを起動して，Eclipse画面を表示します。

次のどちらかの操作で，Server Plug-inパースペクティブを開きます。

［ショートカットバー］ - ［Cosminexus Server Plug-in］メニューを実行します。

［ウィンドウ］ - ［パースペクティブを開く］ - ［Cosminexus Server Plug-in］メニューを実行します。

注意事項

Server Plug-inを起動するとワークスペース内に「.cad」というプロジェクトが作成されます。これは，Server Plug-inが作業用に使用するプロジェクトです。このプロジェクトおよびプロジェクト内のファイルの削除，追加，内容の変更およびプロジェクトを閉じるなどの操作をした場合，Server Plug-inの動作は保証できません。

［Cosminexus Server Plug-in］パースペクティブの構成を次に示します。

図11-1　［Cosminexus Server Plug-in］パースペクティブの構成

［Cosminexus Server Plug-in］パースペクティブの構成要素について説明します。

［サーバー・エクスプローラー］ビュー

Server Plug-inの操作の中心となるビューです。論理サーバの起動・停止，J2EEアプリケーションやリソースアダプタの操作で使用します。

エディタエリア

エディタを表示する領域です。属性ファイル編集エディタで使用します。属性ファイル編集エディタについては，「11.3　プロパティの設定」を参照してください。

［コンソール］ビュー

サーバの起動・停止やJ2EEアプリケーションの操作など，サーバと通信するプロセスの出力を表示します。

［問題］ビュー

属性ファイル編集エディタの構文エラーなどのエラー情報を表示します。

この節では，Server Plug-inパースペクティブとServer Plug-inの環境設定，および［サーバー・エクスプローラー］ビューの操作について説明します。

＜この節の構成＞

11.1.1　Server Plug-inの環境設定

11.1.2　Management Serverリモート管理機能への接続

11.1.3　サーバー・エクスプローラーの構成

11.1.4　サーバー・エクスプローラーの操作

11.1.5　コンソールおよび操作実行時のダイアログ表示

11.1.1　Server Plug-inの環境設定

Server Plug-inを使用するためには，次の設定が必要です。

リモート管理機能に接続するための環境設定

コンソールの共通の設定

アプリケーション統合属性ファイルのエディタの設定

＜この項の構成＞

(1)　前提条件

(2)　リモート管理機能に接続するための環境設定

(3)　コンソールの共通の設定

(4)　アプリケーション統合属性ファイルのエディタの設定

(1)　前提条件

Server Plug-inを使用するためには，次のことを確認してください。

Management Serverがセットアップされているか

Management Serverのセットアップについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.6.1　Management Serverのセットアップ」を参照してください。

接続先のManagement ServerでServer Plug-inを使用するための設定がされているか

Server Plug-inを使用するためのManagement Serverの設定については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.8.3　Server Plug-inを使用するためのManagement Serverの設定」を参照してください。

運用管理ドメイン内のすべてのホストの運用管理エージェント，および接続先のManagement Serverが起動されているか

運用管理エージェント，およびManagement Serverの起動方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.7　システムの起動と停止の設定」を参照してください。

(2)　リモート管理機能に接続するための環境設定

Server Plug-inでは，［設定］ダイアログの［Cosminexus Server Plug-in］ページでリモート管理機能に接続するための環境設定をします。［設定］ダイアログの［Cosminexus Server Plug-in］ページを次に示します。

図11-2　［設定］ダイアログの［Cosminexus Server Plug-in］ページ

［Cosminexus Server Plug-in］ページは，次の手順で表示します。

メニューから［ウィンドウ］ - ［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインにあるツリービューで，［Cosminexus Server Plug-in］を選択します。
［Cosminexus Server Plug-in］ページが表示されます。

［Cosminexus Server Plug-in］ページの構成は，次のとおりです。

［Cosminexus Server Plug-in］ページ
　│
　├─［接続ホスト］タブ
　│　　├─［接続ホストの追加］ダイアログ　　
　│　　└─［接続ホストの編集］ダイアログ　　
　│
　└─［詳細設定］タブ

［Cosminexus Server Plug-in］ページの各要素について説明します。

(a)　［接続ホスト］タブ

［Cosminexus Server Plug-in］ページの［接続ホスト］タブについては，図11-2を参照してください。

［接続ホスト］タブの設定項目およびボタンについて説明します。

接続ホスト一覧

接続ホスト一覧には，複数のリモート管理機能に接続するための接続先ホストを登録できます。

接続ホスト名のチェックボックス

接続するホストを選択します。選択できるホストは一つです。同時に複数のホストを選択することはできません。

接続ホスト名

接続ホストのホスト名またはIPアドレスが表示されています。ローカルホストの場合は，「localhost」が表示されています。

接続ポート番号

接続ホストのポート番号が表示されています。

ローカル/リモート

リモートホストとして設定されている場合に「リモート・ホスト」と表示されています。ローカルホストの場合は空欄です。

［追加］ボタン

［追加］ボタンをクリックすると，［接続ホストの追加］ダイアログが開きます。接続ホスト一覧に接続ホストを追加します。

［編集］ボタン

接続ホスト一覧でホストを選択して，［編集］ボタンをクリックすると，［接続ホストの編集］ダイアログが開きます。接続ホスト一覧で選択されたホストを編集します。

編集対象とするホストが選択されていない場合または複数のホストが選択されている場合は，［編集］ボタンは不活性になっています。

［除去］ボタン

接続ホスト一覧で一つまたは複数のホストを選択して，［除去］ボタンをクリックすると，接続ホスト一覧で選択されたホストは一覧から除去されます。

除去対象とするホストが選択されていない場合，またはすべてのホストが選択されている場合は，ボタンは不活性になっています。接続ホストとして選択されていたホストが削除された場合は，一覧の先頭にあるホストが選択された状態となります。

［デフォルトの復元］ボタン

［Cosminexus Server Plug-in］ページの各設定値をインストール時のデフォルト値に戻します。復元された値は［適用］ボタンをクリックすると保存されます。

［接続ホスト］タブのデフォルトは，次のとおりです。

項目 | デフォルト
接続ホストのチェックボックス | 選択
接続ホスト名 | localhost
接続ポート番号 | 28099
ローカル／リモート | （空欄）

［適用］ボタン

画面を終了しないで，入力値を保存します。

(b)　［接続ホストの追加］ダイアログ

Management Serverのリモート管理機能に接続するホストを追加します。追加された接続ホストは，［接続ホスト］タブの接続ホスト一覧の末尾に表示されます。

［接続ホストの追加］ダイアログを，次に示します。

［接続ホストの追加］ダイアログの設定項目とボタンについて次に説明します。

リモート管理機能への接続

［ローカル・ホスト］／［リモート・ホスト］

Management Serverのリモート管理機能への接続が，ローカルホストなのか，リモートホストなのか選択します。

［ローカル・ホスト］または［リモート・ホスト］の選択によって，項目は次のように，活性または不活性になります。

［接続ホスト］タブの接続ホスト一覧にローカルホストが設定済みの場合は，［ローカル・ホスト］は不活性になっていて，選択できません。

「ローカル・ホスト」を選択すると，「ホスト名またはIPアドレス」に，「localhost」が表示され，不活性になります。

「リモート・ホスト」を選択すると，「ホスト名またはIPアドレス」は活性になり，ホスト名またはIPアドレスを指定できます。

［ホスト名またはIPアドレス］

接続ホストのホスト名またはIPアドレスを指定します。256文字以内の文字を指定してください。

［ポート番号］

接続ホストのポート番号を指定します。接続先ホストのManagement Server環境設定ファイル（mserver.properties）のcom.cosminexus.mngsvr.management.portに指定したポート番号を5文字以内の半角数字で指定してください。

［OK］ボタン

接続ホストを追加して，ダイアログを閉じます。

［キャンセル］ボタン

接続ホストを追加しないで，ダイアログを閉じます。

エラーメッセージ表示領域

「接続ホストの追加」の下に，エラーメッセージが表示されます。

(c)　［接続ホストの編集］ダイアログ

［接続ホストの編集］ダイアログで，Management Serverのリモート管理機能に接続するホストの編集をします。

［接続ホストの編集］ダイアログを，次に示します。

［接続ホストの編集］ダイアログの設定項目およびボタンについて説明します。

リモート管理機能への接続

［ローカル・ホスト］／［リモート・ホスト］

追加時の設定で，「ローカル・ホスト」または「リモート・ホスト」が活性になっています。変更することはできません。

［ホスト名またはIPアドレス］

「リモート・ホスト」が選択されている場合だけ，ホスト名またはIPアドレスを指定できます。256文字以内の文字を指定してください。

［ポート番号］

接続ホストのポート番号を指定します。5文字以内の半角数字を指定してください。

［OK］ボタン

接続ホストを編集して，ダイアログを閉じます。

［キャンセル］ボタン

接続ホストを編集しないで，ダイアログを閉じます。

エラーメッセージ表示領域

「接続ホストの編集」の下に，エラーメッセージが表示されます。

(d)　［詳細設定］タブ

［詳細設定］タブで，Management Serverのリモート管理機能に接続するための詳細な設定をします。

［Cosminexus Server Plug-in］ページの［詳細設定］タブを，次に示します。

図11-3　［詳細設定］タブ

［詳細設定］タブの設定項目およびボタンについて説明します。

［ソケット読み込み監視時間(秒)］

Management Serverのリモート管理機能への接続で，ソケットの読み込みを監視する時間（秒単位）に，0または180～99999の半角数字を指定します。0（秒）を指定した場合は，監視は実施されません。ソケット読み込み監視時間の入力がない場合は，180（秒）が仮定されます。

注意

ソケット読み込み監視時間は，Management Serverのリモート管理機能にログインするときに設定されます。リモート管理機能に接続中に，ソケット読み込み監視時間を変更した場合，変更した監視時間は，次回，リモート管理機能にログインした時から有効になります。

リモート管理機能を使用した処理の実行中に，「Read timed out」のメッセージが表示されたあとも，処理が続行されている場合があります。

［デフォルトの復元］ボタン

［Cosminexus Server Plug-in］ページの各設定値をインストール時のデフォルト値に戻します。復元された値は［適用］ボタンをクリックすると保存されます。

ソケット読み込み監視時間のデフォルト値は180（秒）です。

［適用］ボタン

画面を終了しないで，入力値を保存します。

(3)　コンソールの共通の設定

サーバー・エクスプローラー操作用のコンソールやJ2EEアプリケーション実行用のコンソールなど，Server Plug-inでは複数のコンソールを使用します。［設定］ダイアログの［コンソール］ページで，各種コンソールの共通の設定をします。

［設定］ダイアログの［コンソール］ページを次に示します。

図11-4　［設定］ダイアログの［コンソール］ページ

［コンソール］ページは，次の手順で表示します。

メニューから［ウィンドウ］-［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインにあるツリービューで，［Cosminexus Server Plug-in］-［コンソール］を選択します。
［コンソール］ページが表示されます。

［コンソール］ページの設定項目およびボタンについて説明します。

［コンソール出力の制限］のチェックボックス

コンソール出力を制限するかどうかを選択します。出力を制限する場合，チェックを入れます。チェックを外すと出力制限は解除されます。

出力制限が選択されている場合，出力された行までの文字数がバッファサイズを超えると，先頭から超えた分の出力行が消去されます。消去されたメッセージは次のファイルで確認できます。

<Eclipseワークスペースディレクトリ>/.metadata/.log

［コンソールのバッファー・サイズ（文字）］

［コンソール出力の制限］のチェックボックスにチェックを入れている場合，必ず入力してください。チェックを外している場合，入力値は無効です。

一つのコンソールのバッファサイズ（文字数）を，20000～1000000の半角数字で指定します。

バッファサイズは，必要に応じて調整してください。

［メッセージ出力時にコンソールを前面に表示］のチェックボックス

メッセージを出力するときに，出力対象のコンソールを前面表示するかどうかを選択します。コンソールを前面に表示する場合，チェックを入れます。チェックを外すとコンソールは前面表示されません。ただし，コンソールに初めてメッセージが出力された場合は，そのコンソールは前面表示されます。

［デフォルトの復元］ボタン

［コンソール］ページの各設定値をデフォルト値に戻します。復元された値は［適用］ボタンをクリックすると保存されます。

［コンソール］ページのデフォルトは，次のとおりです。

項目 | デフォルト
［コンソール出力の制限］のチェックボックス | チェック済み
［コンソールのバッファー・サイズ（文字）］ | 300000
［メッセージ出力時にコンソールを前面に表示］のチェックボックス | チェック済み

［適用］ボタン

画面を終了しないで，入力値を保存します。

(4)　アプリケーション統合属性ファイルのエディタの設定

Server Plug-inでは，［設定］ダイアログの［アプリケーション統合属性］ページで，アプリケーション統合属性ファイルの属性ファイル編集エディタの設定をします。属性ファイル編集エディタについては，「11.3.2　属性ファイル編集エディタ」を参照してください。

［設定］ダイアログの［アプリケーション統合属性］ページを次に示します。

［アプリケーション統合属性］ページは，次の手順で表示します。

メニューから［ウィンドウ］-［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインにあるツリービューで，［Cosminexus Server Plug-in］-［アプリケーション統合属性］を選択します。
［アプリケーション統合属性］ページが表示されます。

［アプリケーション統合属性］ページの設定項目およびボタンについて説明します。

［リソース参照のリンク先を自動で解決する］のチェックボックス

アプリケーション統合属性ファイルの属性編集エディタを起動したときに，J2EEアプリケーションのリソース参照を自動解決するかどうかを選択します。リソース参照を自動解決する場合，チェックを入れます。チェックを外すと，リソース参照は自動解決されません。

リソース参照の自動解決については，「11.3.3　リソース参照の自動解決」を参照してください。

［デフォルトの復元］ボタン

［アプリケーション統合属性］ページの設定値をデフォルト値に戻します。復元された値は［適用］ボタンをクリックすると保存されます。

［アプリケーション統合属性］ページのデフォルトは，次のとおりです。

項目 | デフォルト
［リソース参照のリンク先を自動で解決する］のチェックボックス | チェック済み

［適用］ボタン

画面を終了しないで，入力値を保存します。

11.1.2　Management Serverリモート管理機能への接続

Management Serverリモート管理機能へ接続する場合，Management Serverリモート管理機能へのログインを実行します。また，Management Serverリモート管理機能への接続を切断する場合，Management Serverリモート管理機能からのログアウトを実行します。

＜この項の構成＞

(1)　Management Serverリモート管理機能へのログイン

(2)　Management Serverリモート管理機能からのログアウト

(3)　Management Serverリモート管理機能への接続先変更

(1)　Management Serverリモート管理機能へのログイン

次のどちらかの操作でManagement Serverリモート管理機能へ接続します。

［サーバー・エクスプローラー］ビューの＜リモート管理機能と接続しているホスト名＞以下のツリーを展開します。

［サーバー・エクスプローラー］ビューで，［Cosminexus Management Server リモート管理機能へログイン］操作を実行します。
［Cosminexus Management Server リモート管理機能へログイン］操作については，「21.1.2　Management Serverリモート管理機能へのログイン」を参照してください。

Management Serverリモート管理機能に接続すると，［Cosminexus Management Serverリモート管理機能へログイン］ダイアログが表示されます。［Cosminexus Management Serverリモート管理機能へログイン］ダイアログで，管理ユーザIDとパスワードを指定してログインします。

なお，管理ユーザアカウントの省略機能を有効にしている場合，［OK］ボタンをクリックするとログインできます。［管理ユーザーID］および［パスワード］の入力は不要です。

図11-5　［Cosminexus Management Serverリモート管理機能へログイン］ダイアログ

［Cosminexus Management Serverリモート管理機能へログイン］ダイアログの設定項目およびボタンについて説明します。

［管理ユーザーID］

Management Serverへログインするための管理ユーザIDを指定します。管理ユーザアカウントの省略機能を有効にしている場合，この項目は省略できます。

［パスワード］

Management Serverへログインするためのパスワードを指定します。パスワードが設定されていない場合，または管理ユーザアカウントの省略機能を有効にしている場合，この項目は省略できます。

［OK］ボタン

ダイアログを閉じて，Management Serverに接続します。

［キャンセル］ボタン

ダイアログを閉じて，Management Serverには接続しません。

Management Serverのリモート管理機能への接続手順を次に示します。

図11-6　Management Serverのリモート管理機能への接続手順

ログイン中は，「Cosminexus Management Serverリモート管理機能へ接続中」のプログレスダイアログが表示されます。

Management Serverリモート管理機能に接続すると，［サーバー・エクスプローラー］ビューのManagement Serverリモート管理機能に接続しているホストの状態が「（未接続）」から「（接続済）」に変更されます。＜リモート管理機能と接続しているホスト名＞以下のツリーは展開されません。［サーバー・エクスプローラー］ビューのツリービューの状態表示については，「11.2　表示の更新」を参照してください。

Management Serverのリモート管理機能への接続に失敗した場合，エラーメッセージが表示されます。

(2)　Management Serverリモート管理機能からのログアウト

Management Serverリモート管理機能からログアウトするには，［サーバー・エクスプローラー］ビューで，［Cosminexus Management Server リモート管理機能からログアウト］操作を実行します。［Cosminexus Management Server リモート管理機能からログアウト］操作については，「21.1.3　Management Serverリモート管理機能からのログアウト」を参照してください。

ログアウト中は，「Cosminexus Management Serverリモート管理機能との接続を切断中」のプログレスダイアログが表示されます。

Management Serverリモート管理機能との接続が切断されると，［サーバー・エクスプローラー］ビューは初期状態またはリモート管理機能への接続先変更後と同じ状態になります。［サーバー・エクスプローラー］ビューのManagement Serverリモート管理機能に接続しているホストの状態は，「（接続済）」から「（未接続）」に変更されます。［サーバー・エクスプローラー］ビューのツリーの状態表示については，「11.2　表示の更新」を参照してください。

また，リモート管理機能の接続先のホストを変更すると，Management Serverリモート管理機能からログアウトされます。接続先のホストの変更については，「(3)　Management Serverリモート管理機能への接続先変更」を参照してください。

(3)　Management Serverリモート管理機能への接続先変更

［設定］ダイアログの［Cosminexus Server Plug-in］ページで，リモート管理機能への接続先を変更できます。リモート管理機能への接続先を変更した場合，パースペクティブを構成する各ウィンドウは，次の状態になります。

［サーバー・エクスプローラー］ビュー

展開されているノードはすべて閉じられ，接続先のノードだけが表示されます。ノードについては，「11.1.3　サーバー・エクスプローラーの構成」を参照してください。

エディタエリア

編集中の属性ファイル編集エディタは閉じます。属性ファイル編集エディタ以外はそのままの状態です。

［コンソール］ビュー

リモート管理機能にログインするまで，変更前の接続先のログは表示されたままです。リモート管理機能にログインすると，変更前の接続先のログは破棄されます。

［問題］ビュー

そのままの状態です。

［Cosminexus Server Plug-in］パースペクティブの構成については，図11-1を参照してください。

11.1.3　サーバー・エクスプローラーの構成

［Cosminexus Server Plug-in］パースペクティブの，［サーバー・エクスプローラー］ビューは，Server Plug-inの操作の中心となるビューです。Management Serverリモート管理機能への接続，論理サーバの起動・停止，J2EEアプリケーションやリソースアダプタの起動・停止・実行属性の設定などの操作で使用します。

［サーバー・エクスプローラー］ビューの構成を次に示します。

図11-7　［サーバー・エクスプローラー］ビューの構成

ツリービュー

論理サーバやJ2EEアプリケーションやリソースアダプタをツリーで表示するビューです。ツリービューで表示されている項目をノードといいます。

ノードを選択して，右クリックで操作のコンテキストメニュー（ポップアップメニュー）が表示されます。

ビューツールバー

ツリービューで選択したノードの操作を表示するビューです。

ビュープルダウンメニュー

ツリービューで選択したノードの操作を表示するメニューです。

11.1.4　サーバー・エクスプローラーの操作

Server Plug-inでは，［サーバー・エクスプローラー］ビューを使用して，Management Serverリモート管理機能への接続，論理サーバの起動・停止およびアプリケーション設定操作を実行します。

［サーバー・エクスプローラー］ビューの操作手順を次に示します。

ツリービューで，操作の対象となるノードを選択します。
ツリービューで表示するノードの種類については，「21.1　Server Plug-inの操作で使用する画面」を参照してください。

ビューツールバー，ビュープルダウンメニューまたは右クリックで表示されるコンテキストメニューで操作を選択します。
各操作の詳細については，「21.1.1　サーバー・エクスプローラーの基本操作」を参照してください。
選択した操作の実行経過はコンソールビューに表示されます。
操作の実行経過および実行結果の表示については，「11.1.5　コンソールおよび操作実行時のダイアログ表示」を参照してください。

ビューツールバー，ビュープルダウンメニューまたは右クリックで表示されるコンテキストメニューでの各操作は，上記操作の1.で選択したノードによって，実行できるもの（活性）と実行できないもの（不活性）があります。また，ノードの状態によっても実行できるものと実行できないものがあります。ノードと操作の活性・不活性の関係については，「21.1.1　サーバー・エクスプローラーの基本操作」を参照してください。

ノードの状態は，ツリービューに表示されています。ツリービューの表示の確認については，「11.2　表示の更新」を参照してください。

11.1.5　コンソールおよび操作実行時のダイアログ表示

操作が実行されると，［コンソール］ビューに実行経過が表示されます。また，操作の実行中にプログレスダイアログが表示されます。［コンソール］ビューおよびプログレスダイアログの表示について説明します。

＜この項の構成＞

(1)　［コンソール］ビュー

(2)　プログレスダイアログ

(1)　［コンソール］ビュー

操作の実行経過は，［Cosminexus Server Plug-in］パースペクティブの［コンソール］ビューに表示されます。コンソールは，接続しているManagement Server単位に，一つだけ提供されています。また，コンソールには，Eclipseのエラーログも出力されています。

図11-8　［コンソール］ビューの実行経過表示

［コンソール］ビューには，Server Plug-inのコンソールであることが識別できるように，次の形式でタイトルが表示されています。

タイトルの形式

［＜リモート管理機能と接続しているホスト名＞］ （＜リモート管理機能への接続した日時＞） - Cosminexus Server Plug-in

コンソールには，次の情報が表示されます。

［サーバー・エクスプローラー］ビューの操作メッセージ
Server Plug-inから通知される，［サーバー・エクスプローラー］ビューで選択した操作が実行されたときのメッセージです。メッセージの形式を次に示します。

メッセージの形式

［Server Plug-in］ ＜日時＞ ＜操作メッセージ＞ （＜操作対象＞）

メッセージ例

［Server Plug-in］ yyyy/mm/dd hh:MM:ss '開始'を開始します （ホスト'MyHost'）

［Server Plug-in］ yyyy/mm/dd hh:MM:ss '開始'を終了します （ホスト'MyHost'）

Management Serverから通知されるメッセージ
Management Serverから通知されるManagement Serverのメッセージです。メッセージの形式を次に示します。

メッセージの形式

［＜出力コンポーネント＞］ ＜日時＞ ＜通知されたメッセージID＞ ＜通知されたメッセージ＞

メッセージ例

［Management Server］ yyyy/mm/dd hh:MM:KEOS2009-I 一括起動を開始します。

Management Serverを経由して起動されたCUIなどのエラーメッセージ
Management Serverを経由して起動されたCUIなどの標準出力／標準エラーのメッセージです。メッセージの形式を次に示します。

メッセージの形式

［リモート管理機能］ ＜日時＞ ＜投入されたエラーメッセージ＞

Management Serverから通知される論理サーバの標準出力／標準エラー出力
Management Serverから通知される論理サーバの標準出力／標準エラーのメッセージです。メッセージの形式を次に示します。

メッセージの形式

［リモート管理機能］ ＜日時＞ （＜論理サーバ名＞）＜通知されたエラーメッセージ＞

注意事項

Server Plug-inの環境設定の［コンソール］ページで，［メッセージ出力時にコンソールを前面に表示］がチェック済みのとき，メッセージを出力するたびにコンソールが前面に表示されます。［コンソール］ビューに複数のコンソールがある場合，閲覧中のコンソールがServer Plug-inのコンソールに切り替わります。自動的なコンソールの切り替えを抑止するには，［コンソール］ページの［メッセージ出力時にコンソールを前面に表示］のチェックを外すか，［コンソール］ビューの[図データ]（［コンソールのピン留め］）をONにしてください。

(2)　プログレスダイアログ

次の場合，プログレスダイアログが表示され，［サーバー・エクスプローラー］ビューの操作は抑止されます。

操作の実行で前処理が必要な場合，前処理実行中のプログレスダイアログが表示されます。前処理が完了するまで表示されています。

操作実行中は，実行が進行中であることを示すプログレスダイアログが表示されています。操作の実行が終了するまで表示されています。
操作実行中にエラーが発生した場合，エラーメッセージダイアログが表示されます。エラーメッセージダイアログの［詳細］ボタンをクリックすると，エラーの状況が表示されます。エラー内容は［コンソール］ビューで確認してください。

11.2　表示の更新

この節では，リモート管理機能の接続先の状態表示および論理サーバやJ2EEアプリケーションの状態表示について説明します。

［サーバー・エクスプローラー］ビューに，次のどちらかの形式でノードの状態は表示されます。

ステータスアイコン
ノードのアイコンの左上に表示されます。

文字列
ノードの表示名の横に括弧で囲んで表示されます。
文字列での状態表示の形式を次に示します。

＜アイコン＞ ＜表示名＞ （＜状態文字列＞）

リモート管理機能に接続済みのとき，［サーバー・エクスプローラー］ビューでは，次のノードの状態を参照できます。

リモート管理機能の接続先

論理サーバ

J2EEアプリケーション

J2EEリソースアダプタ

リソースアダプタ

＜この節の構成＞

(1)　リモート管理機能の接続先の状態表示

(2)　論理サーバの状態表示

(3)　J2EEアプリケーションの状態表示

(4)　J2EEリソースアダプタの状態表示

(5)　リソースアダプタの状態表示

(1)　リモート管理機能の接続先の状態表示

リモート管理機能の接続先への接続の状態は，文字列で表示されています。状態を表示する（＜状態文字列＞）は，次のとおりです。

未接続の場合：（未接続）

接続済みの場合：（接続済）

リモート管理機能の接続先に未接続の場合，［Cosminexus Management Serverリモート管理機能へのログイン］ダイアログでログインして，リモート管理機能に接続してください。リモート管理機能への接続については，「11.1.2　Management Serverリモート管理機能への接続」を参照してください。

(2)　論理サーバの状態表示

各論理サーバの稼働状態によって，［サーバー・エクスプローラー］ビューの［＜論理サーバ名＞］にステータスアイコンが付加されています。

ステータスアイコンは，次の場合に更新されます。

Management Serverの通知によって自動的に更新された場合

［サーバー・エクスプローラー］ビューのビュープルダウンメニューの［表示の更新］を選択して，手動で［サーバー・エクスプローラー］ビューを最新の状態に更新した場合

付加されるステータスアイコンを次に示します。

表11-1　各論理サーバの稼働状態

稼働状態 | ステータスアイコン
停止 | [図データ]　
稼働中 | [図データ]　
異常停止 | [図データ]　
停止中 | [図データ]　
起動中
回復中
自動停止中
自動再起動中
自動停止中(回復中)
自動停止中(異常停止)
自動停止中(再起動中)
強制停止中
計画停止中
通信障害 | [図データ]　
不明 | [図データ]　

論理J2EEサーバの稼働状態が［停止］の場合，［サーバー・エクスプローラー］ビューでは，［+］が付加されないで，下位ノード（J2EEアプリケーション，J2EEリソースアダプタ，J2EEリソース）が展開されません。

(3)　J2EEアプリケーションの状態表示

J2EEアプリケーションの稼働状態によって，［サーバー・エクスプローラー］ビューの［＜J2EEアプリケーション名＞］にステータスアイコンが付加されています。

［サーバー・エクスプローラー］ビューのビュープルダウンメニューの［表示の更新］を選択して，手動で［サーバー・エクスプローラー］ビューのステータスアイコンを最新の状態に更新します。自動的には更新されません。

付加されるステータスアイコンを次に示します。

表11-2　J2EEアプリケーションの稼働状態

稼働状態 | ステータスアイコン※
開始状態 | [図データ]　
停止状態 | [図データ]　
通常停止失敗状態 | [図データ]　
強制停止失敗状態
閉塞失敗状態
閉塞中 | [図データ]　
通常停止中
強制停止中
閉塞状態 | [図データ]　

注※　次の場合，ステータスアイコンに加えて，その状態が表示されています。

J2EEアプリケーションが展開ディレクトリ形式の場合，ステータスアイコンの右下に展開ディレクトリ形式を示すアイコン（[図データ]）が付加されています。

J2EEアプリケーションのプロパティを設定中（アプリケーション統合属性の設定中）の場合，「（プロパティー設定中）」の状態文字列が表示されています。

(4)　J2EEリソースアダプタの状態表示

デプロイされたJ2EEリソースアダプタの稼働状態によって，［サーバー・エクスプローラー］ビューの［＜J2EEリソースアダプタ名＞］にステータスアイコンが付加されています。

［サーバー・エクスプローラー］ビューのビュープルダウンメニューの［表示の更新］を選択して，手動で［サーバー・エクスプローラー］ビューのステータスアイコンを最新の状態に更新します。自動的には更新されません。

付加されるステータスアイコンを次に示します。

表11-3　J2EEリソースアダプタの稼働状態

稼働状態 | ステータスアイコン※
開始状態 | [図データ]　
停止状態 | [図データ]　

注※　J2EEリソースアダプタのプロパティを設定中（Connector属性の設定中）の場合，ステータスアイコンに加えて，「（プロパティー設定中）」の状態文字列が表示されています。

(5)　リソースアダプタの状態表示

次のリソースアダプタのプロパティを設定中（Connector属性の設定中）の場合，対応する［＜リソースアダプタ名＞］に，「（プロパティー設定中）」の状態文字列が付加されています。

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタ
［サーバー・エクスプローラー］ビューの［J2EEリソース］ - ［リソース・アダプター］以下の［＜リソースアダプタ名＞］

J2EEアプリケーションに含めて使用するリソースアダプタ
［サーバー・エクスプローラー］ビューの［＜J2EEアプリケーション名＞］下の［＜リソースアダプタ名＞］

11.3　プロパティの設定

J2EEアプリケーションやリソースアダプタの属性（プロパティ）を設定する操作について説明します。

＜この節の構成＞

11.3.1　プロパティの設定操作

11.3.2　属性ファイル編集エディタ

11.3.3　リソース参照の自動解決

11.3.1　プロパティの設定操作

Server Plug-inは，リソースアダプタやJ2EEアプリケーションのプロパティを編集するためのエディタとして，属性ファイル編集エディタを提供しています。

なお，Server Plug-inのバージョンとCosminexus Component Containerのバージョンが合致していない場合，属性ファイル編集エディタで属性ファイルの編集はできません。属性ファイル編集エディタを使用しないで，属性ファイルを編集する操作については，「11.3.2　属性ファイル編集エディタ」の「(5)　属性ファイル編集エディタを使用しない属性ファイルの編集」を参照してください。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

リソースアダプタやJ2EEアプリケーションのプロパティを設定する手順を次に示します。

［サーバー・エクスプローラー］ビューで，プロパティを設定するリソースアダプタまたはJ2EEアプリケーションを選択します。

次のどれかの方法で，属性ファイル編集エディタを起動します。

［サーバー・エクスプローラー］ビューで選択したノードをダブルクリックします。

ビュープルダウンメニューの［[図データ]プロパティ］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]プロパティ］を選択します。

手順1.で選択したノードによって，次の属性ファイル編集エディタが起動されます。

リソースアダプタを選択した場合
Connector属性ファイル編集エディタ

J2EEアプリケーションを選択した場合
アプリケーション統合属性ファイル編集エディタ

J2EEアプリケーションにリソースアダプタが含まれる場合，ツリービューでJ2EEアプリケーション下のリソースアダプタを選択すると，Connector属性ファイル編集エディタが起動されます。J2EEアプリケーションを選択すると，アプリケーション統合属性ファイル編集エディタが起動されます。
属性ファイル編集エディタは，［Cosminexus Server Plug-in］パースペクティブのエディタエリアに表示されます。

各属性ファイルに対応したエディタを開いて，プロパティを設定します。
属性ファイル編集エディタの操作については，「11.3.2　属性ファイル編集エディタ」を参照してください。
プロパティの定義項目については，次の説明を参照してください。

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタのプロパティ定義
「14.3.2　プロパティ設定手順（Connector 1.0の場合）」，および「14.3.3　プロパティ設定手順（Connector 1.5の場合）」

J2EEアプリケーションに含めて使用するリソースアダプタのプロパティ定義
「15.3　リソースアダプタのプロパティ定義」

J2EEアプリケーションのプロパティ定義
「18.　J2EEアプリケーションのプロパティ設定」

プロパティの設定後，属性ファイルを保管します。
属性ファイルは，次のどれかの操作で保管されます。

Eclipseのメニューの［ファイル］ - ［保管］を選択

Eclipseの[図データ]（保管）をクリック

ソースページで右クリックして表示される，コンテキストメニューの［保管］を選択

属性ファイル編集エディタを閉じる※

注※　編集状態で，属性ファイル編集エディタを閉じると，変更を保管するかどうかの確認メッセージが表示されます。［はい］をクリックすると保管処理が実行されます。［いいえ］をクリックすると編集は破棄されます。
属性ファイルを保管すると，属性ファイルの値はJ2EEアプリケーションやリソースアダプタの属性に設定されます。
属性ファイルの保管については，「11.3.2　属性ファイル編集エディタ」を参照してください。

(2)　画面表示

J2EEアプリケーションやリソースアダプタのプロパティ設定で使用する画面については，「21.1.14　プロパティの設定」を参照してください。

(3)　対応するサーバ管理コマンド

J2EEアプリケーションやリソースアダプタのプロパティを設定する場合のサーバ管理コマンドについては，「3.3　属性ファイルによるプロパティの設定」を参照してください。

11.3.2　属性ファイル編集エディタ

属性ファイル編集エディタは，Server Plug-inが提供する属性ファイル編集用のエディタです。

属性ファイル編集エディタには，次の2種類があります。

アプリケーション統合属性ファイルエディタ
J2EEアプリケーションに含まれるコンポーネントの属性を一括して表示します。

Connector属性ファイルエディタ
Connector属性を表示します。

属性ファイル編集エディタは，フォームページおよびソースページから構成されています。次に，属性ファイル編集エディタの画面構成を示します。

図11-9　属性ファイル編集エディタの画面構成

＜この項の構成＞

(1)　フォームページ

(2)　ソースページ

(3)　属性ファイルの保管

(4)　属性ファイル編集エディタのエラー表示

(5)　属性ファイル編集エディタを使用しない属性ファイルの編集

(1)　フォームページ

フォームページは属性ファイルを編集するためのページです。属性ファイル編集エディタを起動すると，次のフォームページが初期表示されます。

J2EEアプリケーションのプロパティ設定の場合
アプリケーション統合属性ファイルのフォームページ

リソースアダプタのプロパティ設定の場合
Connector属性ファイルのフォームページ

(a)　フォームページでのプロパティ設定操作

フォームページは，ツリー（エレメント）と編集エリア（エレメント詳細）で構成されています。フォームページの構成については，図11-9を参照してください。

ツリー（エレメント）

編集中の属性ファイルの構成がツリー形式で表示されています。属性ファイル（XMLファイル）の複合要素が一つのノードで表示されていますが，複数回出現する要素については，要素をまとめる仮想ノードが使用されています。仮想ノードにはアイコン[図データ]が付加されています。

編集エリア（エレメント詳細）

ツリーでの選択に対応した編集項目を編集するためのページが表示されています。ページの各項目は属性ファイル（XMLファイル）の一つの要素に対応しています。

フォームページで，プロパティを編集および設定するための基本操作を次に示します。

ツリーで，属性ファイルの編集するノードを選択します。
ツリーでの選択に対応したプロパティ設定ページが編集エリアに表示されます。

編集エリアのプロパティ設定ページで，プロパティを指定します。
指定したプロパティは，次の操作でソースページに反映されます。

ツリーで選択中のノードを切り替えた場合

ソースタブを選択して，ソースページの表示に切り替えた場合

ツリーを選択して右クリックするとコンテキストメニューが表示されます。コンテキストメニューで，ツリーのノードの追加および削除ができます。

ツリーおよび編集エリアの詳細については，「21.2　リソースアダプタの属性編集画面」および「21.3　J2EEアプリケーションの属性編集画面」を参照してください。

(b)　アプリケーション統合属性ファイルのフォームページ

J2EEアプリケーションのプロパティ設定には，アプリケーション統合属性ファイル用エディタのフォームページを使用します。アプリケーション統合属性ファイル用エディタのフォームページは，次の属性ファイル種別タブに分けて表示されています。各タブをクリックすると，編集対象のフォームページが表示されます。

アプリケーション属性
アプリケーション属性のフォームページについては，「21.4　アプリケーション統合属性ファイル（アプリケーション属性）」を参照してください。

EJB-JAR
J2EEアプリケーションにEJB-JARが含まれる場合，アプリケーション統合属性ファイルの「<ejb-jar>」タグ下の属性が表示されます。
EJB-JAR属性のフォームページについては，「21.5　アプリケーション統合属性ファイル（EJB-JAR属性）」を参照してください。

WAR
J2EEアプリケーションにWARが含まれる場合，アプリケーション統合属性ファイルの「<war>」タグ下の属性が表示されます。
WAR属性のフォームページについては，「21.9　アプリケーション統合属性ファイル（WAR属性）」を参照してください。

RAR
J2EEアプリケーションにRARが含まれる場合，アプリケーション統合属性ファイルの「<rar>」タグ下の属性が表示されます。
RAR属性のフォームページは，Connector属性のフォームページと同じです。Connector属性のフォームページについては，「21.2　リソースアダプタの属性編集画面」を参照してください。

(c)　Connector属性ファイルのフォームページ

リソースアダプタのプロパティ設定には，Connector属性ファイル用エディタのフォームページを使用します。Connector属性ファイル用エディタのフォームページにはConnector属性ページが表示されています。

Connector属性のフォームページについては，「21.2　リソースアダプタの属性編集画面」を参照してください。

(2)　ソースページ

［ソース］タブをクリックすると，ソースページが表示されます。ソースページには，属性ファイル（XMLファイル）の内容が表示されています。アプリケーション統合属性ファイルおよびConnector属性ファイルの内容を直接編集する場合に使用します。ソースページを次に示します。

図11-10　属性ファイル編集エディタのソースページ

ソースページで属性ファイルを編集して，属性ファイルの定義（スキーマ）に従わない不正な構文となった場合，エラーとなります。この場合，属性ファイルの保管時に［問題］ビューに構文エラー個所が表示されるので，［問題］ビューを確認してソースページで修正してください。

(3)　属性ファイルの保管

属性ファイル編集エディタで属性ファイルを保管すると，属性ファイルの内容は，J2EEアプリケーションやリソースアダプタの属性が反映されます。

属性ファイル設定中は，「J2EEアプリケーション'＜J2EEアプリケーション名＞'を操作中」のプログレスダイアログが表示されています。

ただし，次の場合はJ2EEアプリケーションやリソースアダプタの属性は設定されません。

属性ファイルにエラーがある場合
［問題］ビューでエラーが表示されます。

属性ファイル編集時にエラーが発生した場合
属性ファイル編集中のエラーは，エラーダイアログおよび［コンソール］ビューに表示されます。また，サーバで属性ファイル（XMLファイル）にエラーが検知された場合も，［コンソール］ビューにエラーが表示されます。

Eclipseが終了した場合
次回，Eclipseを起動したときに属性ファイル編集エディタが再開されます。

リモート管理機能への接続先を変更した場合
次回，リモート管理機能への接続先を変更したときに属性ファイル編集エディタが再開されます。

論理J2EEサーバが停止した場合
次回，論理J2EEサーバが開始したときに属性ファイル編集エディタが再開されます。

保管に失敗して，J2EEアプリケーションやリソースアダプタの属性が設定されなかった場合，属性ファイルの内容を修正して，保管し直すことができます。

(4)　属性ファイル編集エディタのエラー表示

属性ファイル編集エディタでは，属性ファイル編集エディタの起動時や属性ファイルの保管時などで，属性ファイル（XMLファイル）の正当性をチェックしています。エラーの内容は，エラーの種類に応じて，次のように表示されます。

ダイアログが表示されます。
XMLファイルとして不正なソースの場合，エラーメッセージダイアログが表示されます。

［問題］ビューにエラーの位置が表示されます。
属性ファイルのタグの並びや出現回数など，XMLスキーマ定義に一致していない場合，エラーの位置が［問題］ビューに表示されます。ソースページでマーキングされたエラー行を確認できます。

属性ファイル編集のエディタエリアに警告メッセージが表示されます。
属性ファイルの編集時に妥当性エラーがある場合，エディタエリアの［エレメント詳細］の先頭行に，「このページにエラーがあります。」という警告メッセージが表示され，妥当性エラーとなっている項目にマウスポインタが合わされています。

［コンソール］ビューにエラーが表示されます。
サーバから返されたエラーが表示されます。

エラーが表示された場合，エラー内容に応じて属性ファイルの定義内容を確認してください。属性ファイルの定義については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」を参照してください。

(5)　属性ファイル編集エディタを使用しない属性ファイルの編集

Server Plug-inのバージョンとCosminexus Component Containerのバージョンが合致していない場合など，属性ファイル編集エディタで属性の編集ができない場合，属性を属性ファイルに取得（エクスポート）し，プロパティ設定項目を編集します。編集した属性ファイルの値を属性に設定（インポート）してください。

操作手順を次に示します。

属性を取得します。
Connector属性またはアプリケーション統合属性をエクスポートします。
Connector属性のエクスポートについては，「14.9.2　Connector属性のエクスポート」を，アプリケーション統合属性のエクスポートについては，「20.3　アプリケーション統合属性のエクスポート」を参照してください。

プロパティ設定項目を編集します。
エクスポートした属性ファイルを，テキストエディタなどで開き，編集します。

属性を設定します。
Connector属性またはアプリケーション統合属性をインポートします。
Connector属性のインポートについては，「14.9.1　Connector属性のインポート」を，アプリケーション統合属性のインポートについては，「20.2　アプリケーション統合属性のインポート」を参照してください。

11.3.3　リソース参照の自動解決

Server Plug-inでは，J2EEアプリケーションのリソース参照を自動解決できます。

リソース参照の自動解決とは，統合属性ファイルの属性ファイル編集エディタを起動したときに，編集対象のJ2EEアプリケーションのリソース参照を自動で設定することです。

リソース参照の自動解決を実行するかどうかは，［設定］ダイアログの［アプリケーション統合属性］ページで，［リソース参照のリンク先を自動で解決する］のチェックボックスで設定します。［設定］ダイアログの［アプリケーション統合属性］ページについては，「11.1.1　Server Plug-inの環境設定」の「(4)　アプリケーション統合属性ファイルのエディタの設定」を参照してください。

＜この項の構成＞

(1)　自動解決の対象リソースアダプタ

(2)　自動解決で設定される属性ファイルの定義項目

(3)　リソース参照の自動解決の条件

(4)　リソース参照の自動解決例

(1)　自動解決の対象リソースアダプタ

リソース参照の自動解決は，次のリソースアダプタに対して実行されます。

J2EEリソースアダプタ

J2EEアプリケーションに含まれるリソースアダプタ

(2)　自動解決で設定される属性ファイルの定義項目

次の属性のリンク先（<resource-ref> - <linked-to>タグ）が自動で設定されます。

Session Bean属性

Entity Bean属性

Message-driven Bean属性

WAR属性

(3)　リソース参照の自動解決の条件

次の順番で自動解決されます。

Connector 1.0の仕様に準拠するリソースアダプタ

Connector 1.5の仕様に準拠するリソースアダプタ

リソースの自動解決の条件は，リソースアダプタのバージョンによって，次のように異なります。

Connector 1.0の仕様に準拠するリソースアダプタの場合
次の条件を満たす場合，リンク先（<resource-ref> - <linked-to>タグ）に＜リソースアダプタの表示名＞が設定されます。

Connector 1.0の仕様に準拠するリソースアダプタが一つだけデプロイされている。

リソース参照のタイプ（<resource-ref> - <res-type>タグ）の値が「javax.sql.DataSource」である場合に，「＜Cosminexusのインストールディレクトリ＞¥CC¥DBConnector」で提供されるリソースアダプタがデプロイされている。

リソース参照のタイプ（<resource-ref> - <res-type>タグ）の値が「javax.jms.QueueConnectionFactory」である場合に，「＜Cosminexusのインストールディレクトリ＞¥RM¥lib」で提供されるリソースアダプタがデプロイされている。

コネクション定義識別子が「javax.sql.DataSource」または「javax.jms.QueueConnectionFactory」である，Connector 1.5の仕様に準拠するリソースアダプタがデプロイされていない。

リソース参照のタイプ（<resource-ref> - <res-type>タグ）の値と，自動解決の対象とするリソースアダプタの関係を次の表に示します。なお，リソースアダプタの判別には表示名が使用されます。

表11-4　リソース参照のタイプの値と自動解決の対象とするリソースアダプタの関係

<resource-ref> - <res-type>タグの値 | 自動解決の対象とするリソースアダプタの表示名
javax.sql.DataSource | DB_Connector_for_Cosminexus_Driver
DB_Connector_for_Cosminexus_Driver_XA
DB_Connector_for_HiRDB_Type4
DB_Connector_for_HiRDB_Type4_XA
DB_Connector_for_Oracle
DB_Connector_for_Oracle_XA
DB_Connector_for_SQLServer
DB_Connector_for_SQLServer2005
DB_Connector_for_ClusterPool_Root
DB_Connector_for_Oracle_ClusterPool_Member
DB_Connector_for_Cosminexus_Driver_Cosminexus_RM
DB_Connector_for_Cosminexus_Driver_XA_Cosminexus_RM
DB_Connector_for_HiRDB_Type4_Cosminexus_RM
DB_Connector_for_HiRDB_Type4_XA_Cosminexus_RM
DB_Connector_for_Oracle_Cosminexus_RM
DB_Connector_for_Oracle_XA_Cosminexus_RM
javax.jms.QueueConnectionFactory | Cosminexus_Reliable_Messaging

Connector 1.5の仕様に準拠するリソースアダプタの場合
Connector 1.0の仕様に準拠するリソースアダプタのリソース参照が解決できなかった場合に実行されます。
次の条件を満たす場合，リンク先（<resource-ref> - <linked-to>タグ）に，＜リソースアダプタ名＞!＜コネクション定義識別子＞が設定されます。

Outboundリソースアダプタがデプロイされている。

リソース参照のタイプ（<resource-ref> - <res-type>タグ）の値とコネクション定義識別子が一致するリソースアダプタが一つだけデプロイされている。

リソース参照のタイプ（<resource-ref> - <res-type>タグ）の値が「javax.sql.DataSource」である場合に，Connector 1.0の仕様に準拠するリソースアダプタがデプロイされていない。

注意

アノテーションを使用している場合でも，リンク先（<linked-to>）の設定値は自動で解決されます。アノテーションと属性ファイルで同時に指定した場合の実行は，属性ファイルの仕様に従います。

(4)　リソース参照の自動解決例

次のJ2EEアプリケーションの例で，リソース参照の自動解決の流れを示します。

前提

Connector 1.0の仕様に準拠するリソースアダプタ（DB_Connector_for_Cosminexus_Driver）だけがJ2EEリソースアダプタとしてデプロイされています。J2EEアプリケーション（Bank）にはリソースアダプタは含まれていません。

J2EEアプリケーション（Bank）のSession Bean属性のリソース参照は，次のように設定されています。

リソースタイプ（res-type）：「javax.sql.DataSource」

リンク先（<linked-to>）：空タグ

［サーバー・エクスプローラー］ビューでJ2EEアプリケーション（Bank）を選択し，プロパティ設定操作で属性ファイル編集エディタを起動すると，次のようにリンク先が自動設定されます。

図11-11　リソース参照の自動解決の流れ

属性ファイル編集エディタで，［EJB-JAR］フォームページのリソース参照のプロパティページを表示すると，［リンク先］に，リソースアダプタの表示名が設定されています。なお，アプリケーション統合属性ファイルは自動解決で変更されているため，属性ファイル編集エディタのステータスは「編集済み」となっています。

11.4　Server Plug-inの注意事項

Server Plug-inを使用する際の注意事項を次に示します。

＜この節の構成＞

(1)　Windows 7またはWindows Vista使用時の注意事項

(2)　Server Plug-inを使用する場合の注意事項

(1)　Windows 7またはWindows Vista使用時の注意事項

Windows 7またはWindows Vistaを使用している場合で，管理者特権で実行する必要がある操作について説明します。なお，システムドライブをCドライブとして説明します。

C:¥Program Files以下のディレクトリまたはC:¥windows以下のディレクトリに対する操作には制限があります。これらの制限されたディレクトリに対して，ファイルをエクスポートしたり，Eclipseのワークスペースを保存したりすると，リダイレクション機能によって，操作対象のファイルはリダイレクトされ，次の場所に格納されます。

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

エクスポートまたは保存したファイルの実体は上記の場所に格納されていますが，Eclipse上からはC:¥Program Files以下に実ファイルがあるかのように，ファイルを読み込んだり，書き込んだりできます。

(2)　Server Plug-inを使用する場合の注意事項

EJB-JAR属性の<interceptor-order>タグに複数の<interceptor-class>タグを指定した場合，または次に示すタグにハイフン（-）を指定した場合，エラーが発生します。この場合，Server Plug-inではなく，サーバ管理コマンドを使用して属性ファイルを直接編集して対処してください。

Session Bean属性およびEntity Bean属性の<optional-name>タグ，<local-optional-name>タグ

Connector属性の<optional-name>タグ

12.　論理サーバの運用管理

この章では，Server Plug-inを使用した，論理サーバの起動や停止，稼働状況の確認などの操作について説明します。なお，この章の操作に対応するサーバ管理コマンドはありません。Management Serverの運用管理コマンドなどが対応します。

＜この章の構成＞

12.1　論理サーバの運用管理の概要

12.2　論理サーバの起動

12.3　論理サーバの停止

12.4　論理サーバの稼働状況表示

12.1　論理サーバの運用管理の概要

この節では，Server Plug-inで管理できる論理サーバと，論理サーバの運用で使用する操作について説明します。

［サーバー・エクスプローラー］ビューには，次の論理サーバが表示されます。

　[図データ]＜Cosminexus Management Serverリモート管理機能と接続しているホスト＞
　│
　└─[図データ]＜運用管理ドメイン名＞
　    └─[図データ]＜ホスト名＞（運用管理ドメイン内）
　        ├─[図データ]＜論理パフォーマンストレーサ名＞
　        ├─[図データ]＜論理スマートエージェント名＞
　        ├─[図データ]＜論理ネーミングサービス名＞
　        ├─[図データ]＜論理CTMドメインマネジャ名＞
　        ├─[図データ]＜論理CTM名＞
　        ├─[図データ]＜論理SFOサーバ名＞
　        ├─[図データ]＜論理J2EEサーバ名＞
　        ├─[図データ]＜論理Webサーバ名＞
　        └─[図データ]＜論理ユーザサーバ名＞

［サーバー・エクスプローラー］ビューで表示される論理サーバは，起動順に並んでいます。論理サーバの起動順については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「11.　論理サーバの起動／停止」を参照してください。

論理サーバの概要と論理サーバの運用で使用する操作を次の表に示します。

表12-1　論理サーバの概要

論理サーバ
操作※
概要

起動／停止
運用監視

Cosminexus Management Serverリモート管理機能と接続しているホスト
×
○
Management Serverリモート管理機能と接続しているホストです。次のように表示されます。
＜ホスト名またはIPアドレス＞：＜ポート番号＞
初期表示のときは，このノードだけが表示されています。

運用管理ドメイン
○
×
運用管理ドメイン名が表示されています。

ホスト名（運用管理ドメイン内）
○
×
運用管理ドメインに定義されているホスト名が表示されています。

論理パフォーマンストレーサ
○
○
論理パフォーマンストレーサ名が表示されています。

論理スマートエージェント
○
○
論理スマートエージェント名が表示されています。

論理ネーミングサービス
○
○
論理ネーミングサービス名が表示されています。

論理CTMドメインマネジャ
○
○
論理CTMドメインマネジャ名が表示されています。

論理CTM
○
○
論理CTM名が表示されています。

論理SFOサーバ
○
○
論理SFOサーバ名が表示されています。

論理J2EEサーバ
○
○
論理J2EEサーバ名が表示されています。

論理Webサーバ
○
○
論理Webサーバ名が表示されています。

論理ユーザサーバ
○
○
論理ユーザサーバ名が表示されています。

（凡例）　○：実行できる　×：実行できない

注　論理サーバについては，マニュアル「Cosminexus アプリケーションサーバ システム設計ガイド」を参照してください。

注※　論理サーバの起動／停止については，「12.2　論理サーバの起動」および「12.3　論理サーバの停止」を参照してください。論理サーバの運用監視については，「12.4　論理サーバの稼働状況表示」を参照してください。

12.2　論理サーバの起動

この節では，論理サーバを起動するときの，次の操作について説明します。

論理J2EEサーバに開始オプションを設定する。

論理サーバを起動する。

アプリケーションを起動しないでJ2EEサーバを起動する。

＜この節の構成＞

12.2.1　開始オプションの設定

12.2.2　論理サーバの通常起動

12.2.3　アプリケーションを起動しないでJ2EEサーバを起動

12.2.1　開始オプションの設定

論理J2EEサーバでは，デフォルト設定で，セキュリティマネジャが動作しています。展開ディレクトリ形式のJ2EEアプリケーションを使用する場合，セキュリティに関する設定を変更して運用することが推奨されています。

セキュリティマネジャの使用有無を，［開始オプションの設定］ダイアログで設定します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　注意事項

(1)　手順

開始オプションを設定する手順を次に示します。

［サーバー・エクスプローラー］ビューで，開始オプションを設定する［＜論理J2EEサーバ名＞］を選択します。

次のどちらかの方法で，開始オプションの設定操作を実行します。

ビュープルダウンメニューの［開始オプションの設定］を選択します。

右クリックで表示されるコンテキストメニューの［開始オプションの設定］を選択します。

開始オプションの設定操作が実行されると，［開始オプションの設定］ダイアログが表示されます。

［セキュリティー・マネージャーの使用］について，セキュリティマネージャを使用する場合は，［する］を選択します。セキュリティマネージャを使用しない場合は，［しない］を選択します。

論理J2EEサーバの開始オプションを更新する場合は，［OK］ボタンをクリックします。更新しない場合は，［キャンセル］ボタンをクリックします。
［開始オプションの設定］ダイアログが閉じます。

(2)　画面表示

論理J2EEサーバの開始オプションの設定で使用する画面については，「21.1.6　論理J2EEサーバの開始オプションの設定」を参照してください。

(3)　注意事項

開始オプションの設定について
開始オプションの設定は，Management Serverの設定情報として配布されます。運用管理ポータルなどで変更した場合，その設定が有効になります。セキュリティマネジャを使用しない設定にする場合，J2EEサーバ起動時のコマンドオプションに-nosecurityオプションを付加します。J2EEサーバ起動時のコマンドオプションについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartsv（J2EEサーバの開始）」を参照してください。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）などの更新について
Server Plug-inを使用してJ2EEサーバの開始オプションを設定する場合，Management Serverを使用してJ2EEサーバの設定情報を配布します。
このため，usrconf.cfg（J2EEサーバ用オプション定義ファイル），usrconf.properties（J2EEサーバ用ユーザプロパティファイル）などを直接編集して指定した設定情報については破棄されます。J2EEサーバの設定は，Management Serverを使用して指定してください。
設定情報の配布で設定されるファイルについては，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.11　論理サーバの設定ファイルの配布」を参照してください。

12.2.2　論理サーバの通常起動

Server Plug-inで論理サーバを通常起動するには，次の方法があります。

ドメイン単位の論理サーバの一括起動
運用管理ドメイン内のすべての論理サーバを一括起動します。起動順序は，［サーバー・エクスプローラー］ビューで表示された順序に従います。なお，［サーバー・エクスプローラー］ビューに表示されていない論理サーバは一括起動の対象外になります。

ホスト単位の論理サーバの一括起動
ホスト内のすべての論理サーバを一括起動します。起動順序は，［サーバー・エクスプローラー］ビューで表示された順序に従います。なお，［サーバー・エクスプローラー］ビューに表示されていない論理サーバは一括起動の対象外になります。

個別の論理サーバの起動
論理サーバを個別に起動します。J2EEアプリケーションを開始したあとにWebサーバを起動する場合や，異常終了した論理サーバだけ再起動する場合などに，論理サーバを個別に起動します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(1)　手順

論理サーバを起動する手順を次に示します。

［サーバー・エクスプローラー］ビューで，起動する論理サーバを選択します。
論理サーバの起動方法によって，次のノードを選択します。

ドメイン単位の論理サーバを一括起動する場合
［＜運用管理ドメイン名＞］を選択します。

ホスト単位の論理サーバを一括起動する場合
［＜ホスト名＞］を選択します。

個別の論理サーバを起動する場合
次の論理サーバのどれかを選択します。
論理パフォーマンストレーサ
論理スマートエージェント
論理ネーミングサービス
論理CTMドメインマネジャ
論理CTM
論理SFOサーバ
論理J2EEサーバ
論理Webサーバ
論理ユーザサーバ

次のどれかの方法で，開始操作を実行します。

ビューツールバーの［[図データ]］（開始）をクリックします。

ビュープルダウンメニューの［[図データ]開始］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]開始］を選択します。

個別の論理サーバを起動する場合，上記1.で選択した論理サーバが開始状態のときは，不活性になっていて選択できません。
指定した論理サーバが，すべて起動されます。

(2)　画面表示

論理サーバの開始で使用する画面については，「21.1.4　開始」を参照してください。

12.2.3　アプリケーションを起動しないでJ2EEサーバを起動

J2EEアプリケーションを起動しないで，論理J2EEサーバを起動します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(1)　手順

J2EEアプリケーションを起動しないで，論理J2EEサーバを開始する手順を次に示します。

［サーバー・エクスプローラー］ビューで，［＜論理J2EEサーバ名＞］を選択します。

次のどちらかの方法で，アプリケーションを起動しないで開始する操作を実行します。

ビュープルダウンメニューの［アプリケーションを起動しないで開始］を選択します。

右クリックで表示されるコンテキストメニューの［アプリケーションを起動しないで開始］を選択します。

アプリケーションを起動しないで，論理J2EEサーバが起動されます。

(2)　画面表示

アプリケーションを起動しないでJ2EEサーバを起動する画面については，「21.1.5　アプリケーションを起動しない場合のJ2EEサーバの開始」を参照してください。

12.3　論理サーバの停止

この節では，論理サーバを停止するときの，次の操作について説明します。

論理サーバを通常停止する。

論理J2EEサーバを強制停止する。

＜この節の構成＞

12.3.1　論理サーバの通常停止

12.3.2　論理J2EEサーバの強制停止

12.3.1　論理サーバの通常停止

Server Plug-inで論理サーバを通常停止するには，次の方法があります。

ドメイン単位の論理サーバの一括停止
運用管理ドメイン内のすべての論理サーバを一括停止します。停止順序は，［サーバー・エクスプローラー］ビューで表示された順序の逆順になります。なお，［サーバー・エクスプローラー］ビューに表示されていない論理サーバは一括停止の対象外になります。

ホスト単位の論理サーバの一括停止
ホスト内のすべての論理サーバを一括停止します。停止順序は，［サーバー・エクスプローラー］ビューで表示された順序の逆順になります。なお，［サーバー・エクスプローラー］ビューに表示されていない論理サーバは一括停止の対象外になります。

個別の論理サーバの停止
論理サーバを個別に停止します。J2EEアプリケーションを停止する前にWebサーバを停止する場合などに，論理サーバを個別に停止します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(1)　手順

論理サーバを停止する手順を次に示します。

［サーバー・エクスプローラー］ビューで，停止する論理サーバを選択します。
論理サーバの停止方法によって，次のノードを選択します。

ドメイン単位の論理サーバを一括停止する場合
［＜運用管理ドメイン名＞］を選択します。

ホスト単位の論理サーバを一括停止する場合
［＜ホスト名＞］を選択します。

個別の論理サーバを停止する場合
次の論理サーバのどれかを選択します。
論理パフォーマンストレーサ
論理スマートエージェント
論理ネーミングサービス
論理CTMドメインマネジャ
論理CTM
論理SFOサーバ
論理J2EEサーバ
論理Webサーバ
論理ユーザサーバ

次のどれかの方法で，停止操作を実行します。

ビューツールバーの［[図データ]］（停止）をクリックします。

ビュープルダウンメニューの［[図データ]停止］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]停止］を選択します。

個別の論理サーバを停止する場合，上記1.で選択した論理サーバが停止状態のときは，不活性になっていて選択できません。
指定した論理サーバが，すべて停止されます。

(2)　画面表示

論理サーバの停止で使用する画面については，「21.1.7　停止」を参照してください。

12.3.2　論理J2EEサーバの強制停止

論理J2EEサーバを強制停止します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(1)　手順

論理J2EEサーバを強制停止する手順を次に示します。

［サーバー・エクスプローラー］ビューで，強制停止する［＜論理J2EEサーバ名＞］を選択します。

次のどちらかの方法で，強制停止をする操作を実行します。

ビュープルダウンメニューの［強制停止］を選択します。

右クリックで表示されるコンテキストメニューの［強制停止］を選択します。

論理J2EEサーバが強制停止されます。

(2)　画面表示

論理J2EEサーバを強制停止する画面については，「21.1.8　強制停止」を参照してください。

12.4　論理サーバの稼働状況表示

［サーバー・エクスプローラー］ビューのステータスアイコンで，次の論理サーバの稼働状態を確認できます。ステータスアイコンは，論理サーバのアイコンの左上に付加されます。

Management Serverリモート管理機能との接続状態
Management Serverリモート管理機能との接続状態の表示については，「11.2　表示の更新」の「(1)　リモート管理機能の接続先の状態表示」を参照してください。

運用管理ドメイン内のすべての論理サーバの稼働状態
論理サーバの状態表示と付加されるステータスアイコンについては，「11.2　表示の更新」の「(2)　論理サーバの状態表示」を参照してください。

13.　Server Plug-inによるJ2EEリソースの設定の概要

この章では，Server Plug-inを使用した，J2EEリソースの管理の概要について説明します。

＜この章の構成＞

13.1　J2EEリソース設定機能

13.2　ビューツールバーでのJ2EEリソース設定操作

13.3　J2EEリソースアダプタの状態表示

13.1　J2EEリソース設定機能

リソースアダプタは，次のどちらかの方法で管理します。

J2EEリソースアダプタとしてデプロイして，そのJ2EEサーバ上で動作するすべてのJ2EEアプリケーションで使用できるようにします。

リソースアダプタをアプリケーションに含めて，そのJ2EEアプリケーションで使用できるようにします。

J2EEアプリケーションは，これらのどちらのリソースアダプタも使用できます。ただし，同じ表示名のリソースアダプタを同時に使用することはできません。同時に使用すると，J2EEアプリケーションは使用するリソースアダプタを区別できません。

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタのアプリケーション設定操作については，「14.　リソースアダプタの設定」を参照してください。J2EEアプリケーションに含めて使用するリソースアダプタのアプリケーション設定操作については，「15.　J2EEアプリケーションに含まれるリソースアダプタの設定」を参照してください。

また，次の機能は，Server Plug-inでは使用できません。

JavaBeansリソースの設定

メールコンフィグレーションの設定

J2EEリソースのコピー

13.2　ビューツールバーでのJ2EEリソース設定操作

Server Plug-inでのJ2EEリソースの設定操作を次に示します。

［サーバー・エクスプローラー］ビューに表示されたツリー項目（ノード）を選択します。
選択するノードを次に示します。

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの場合
［J2EEアプリケーション］フォルダ以下のノードを選択します。

J2EEアプリケーションに含めて使用するリソースアダプタの場合
［J2EEリソース・アダプター］フォルダ以下のノードまたは［J2EEリソース］フォルダ以下のノードを選択します。

ビューツールバーなどで操作を指定します。

［サーバー・エクスプローラー］ビューの構成については，「11.1.3　サーバー・エクスプローラーの構成」を参照してください。

［サーバー・エクスプローラー］ビューでの操作については，「11.1.4　サーバー・エクスプローラーの操作」を参照してください。

［サーバー・エクスプローラー］ビューに表示されたノードと，そのノードが実行できる操作について「21.1.1　サーバー・エクスプローラーの基本操作」を参照してください。

13.3　J2EEリソースアダプタの状態表示

J2EEリソースアダプタの稼働状態は，［サーバー・エクスプローラー］ビューのステータスアイコンで表示します。ステータスアイコンは，アイコンの左上に付加されます。J2EEリソースアダプタの状態表示と付加されるステータスアイコンについては，「11.2　表示の更新」の「(4)　J2EEリソースアダプタの状態表示」を参照してください。

14.　リソースアダプタの設定

この章では，Server Plug-inを使用したリソースアダプタの設定について説明します。

J2EEアプリケーションに含まれるリソースアダプタの設定については，「15.　J2EEアプリケーションに含まれるリソースアダプタの設定」を参照してください。

＜この章の構成＞

14.1　リソースアダプタの設定の概要

14.2　リソースアダプタのインポート

14.3　リソースアダプタのプロパティ定義

14.4　リソースアダプタのデプロイ

14.5　J2EEリソースアダプタの接続テスト

14.6　J2EEリソースアダプタの開始と停止

14.7　リソースアダプタの削除

14.8　J2EEリソースアダプタのエクスポート

14.9　Connector属性のインポートとエクスポート

14.1　リソースアダプタの設定の概要

J2EEリソースアダプタとしてデプロイして利用するリソースアダプタの種類と，アプリケーション設定操作の概要について説明します。

＜この節の構成＞

(1)　利用できるリソースアダプタ

(2)　リソースアダプタの設定操作

(1)　利用できるリソースアダプタ

次のリソースアダプタについて設定操作ができます。

データベースと接続するための設定（DB Connectorを使用する場合）

データベース上のキューと接続するための設定（DB Connector for Cosminexus RMおよびCosminexus RMを使用する場合）

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）

(2)　リソースアダプタの設定操作

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの設定に必要な作業は次のとおりです。

リソースアダプタのインポート
Server Plug-in環境にあるリソースアダプタ，またはJ2EEサーバが稼働するホストにあるリソースアダプタをインポートします。

リソースアダプタのプロパティ定義

リソースアダプタのデプロイ

J2EEリソースアダプタの接続テスト

J2EEリソースアダプタの開始

J2EEリソースアダプタの停止

リソースアダプタの削除

J2EEリソースアダプタのエクスポート

また，必要に応じてJ2EEリソースアダプタとしてデプロイして使用するリソースアダプタのConnector属性をインポートおよびエクスポートします。

データベース上のキューと接続するための設定（DB Connector for Cosminexus RMおよびCosminexus RMを使用する場合）については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

Server Plug-inを使用したJ2EEリソースの管理（GUI）の機能と，サーバ管理コマンド（CUI）の対応を次の表に示します。

表14-1　Server Plug-inを使用したJ2EEリソースの管理の機能とサーバ管理コマンドの対応

機能
対応するコマンド
参照先

リソースアダプタのインポート
Server Plug-in環境にあるリソースアダプタ
cjimportres
14.2.1

J2EEサーバ環境にあるリソースアダプタ
14.2.2

リソースアダプタのプロパティ定義
cjgetresprop，cjsetresprop
または
cjgetrarprop，cjsetrarprop
14.3

リソースアダプタのデプロイ
cjdeployrar
14.4

J2EEリソースアダプタの接続テスト
cjtestres
14.5

J2EEリソースアダプタの開始
cjstartrar
14.6.1

J2EEリソースアダプタの停止
cjstoprar
14.6.2

リソースアダプタの削除
cjundeployrar，
cjdeleteres
14.7

J2EEリソースアダプタのエクスポート
cjexportrar
14.8

J2EEリソースアダプタの状態表示※1
（cjlistrar）
11.2

リソースアダプタの一覧表示※2
（cjlistres）
11.2

Connector属性のインポートとエクスポート
cjgetresprop，cjsetresprop
または
cjgetrarprop，cjsetrarprop
14.9

（凡例）　（　）：類似機能に対応するサーバ管理コマンド（CUI）

注※1　［表示の更新］操作を実行すると，［サーバー・エクスプローラー］ビューの［J2EEリソース・アダプター］フォルダ内の［＜J2EEリソースアダプタ名＞］に，デプロイされているリソースアダプタの状態が表示されます。

注※2　［サーバー・エクスプローラー］ビューの［J2EEリソース・アダプター］フォルダ内の［リソース・アダプター］フォルダに，インポートされている［＜リソースアダプタ名＞］が表示されています。

［サーバー・エクスプローラー］ビューについては，「11.1.3　サーバー・エクスプローラーの構成」を参照してください。

J2EEリソースアダプタの設定の注意事項については，サーバ管理コマンドによるJ2EEリソースの設定（「4.　リソースアダプタの設定」）を参照してください。

14.2　リソースアダプタのインポート

次のリソースアダプタをインポートします。

Server Plug-in環境にあるリソースアダプタ
Server Plug-inが実行されている環境にあるRARファイルをインポートします。

J2EEサーバが稼働するホストにあるリソースアダプタ
J2EEサーバが稼働するホストにある，RARファイルをインポートします。

＜この節の構成＞

14.2.1　Server Plug-in環境にあるリソースアダプタのインポート

14.2.2　J2EEサーバ環境にあるリソースアダプタのインポート

14.2.1　Server Plug-in環境にあるリソースアダプタのインポート

Server Plug-inが実行されているホスト（ローカルホスト）にあるリソースアダプタをインポートします。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

ローカルホストのリソースアダプタをインポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース］フォルダ下の［リソース・アダプター］フォルダを選択します。

次の操作のどちらかで，リソースアダプタをインポートします。

ビューツールバーの［[図データ]］（インポート）をクリックして，サブメニューの［[図データ]リソース・アダプター］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]リソース・アダプターのインポート］を選択します。

操作が実行されると，［リソース・アダプターのインポート］ダイアログが表示されます。

インポートするリソースアダプタファイルを指定して，［開く］を実行します。
インポートが開始されます。

(2)　画面表示

リソースアダプタのインポートで使用する画面については，「21.1.20　リソースアダプタのインポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjimportresコマンドです。

リソースアダプタをインポートする場合の，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースと接続するための設定（DB Connectorを使用する場合）
「4.2.1　DB Connectorのインポート」

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）
「4.4.1　リソースアダプタのインポート」

14.2.2　J2EEサーバ環境にあるリソースアダプタのインポート

J2EEサーバが稼働するホスト（接続先ホスト）にあるリソースアダプタをインポートします。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

接続先ホストのリソースアダプタをインポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース］フォルダ下の［リソース・アダプター］フォルダを選択します。

次の操作のどちらかで，接続先ホストのリソースアダプタをインポートします。

ビューツールバーの［[図データ]］（インポート）をクリックして，サブメニューの［[図データ]リソース・アダプター（Connector）］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]リソース・アダプター（Connector）のインポート］を選択します。

操作が実行されると，［リソース・アダプター（Connector）のインポート］ダイアログが表示されます。

接続先ホストのリソースアダプタファイルを絶対パスで指定して，［OK］を実行します。
インポートが開始されます。

(2)　画面表示

接続先ホストのリソースアダプタのインポートで使用する画面については，「21.1.19　リソースアダプタ（Connector）のインポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjimportresコマンドです。

リソースアダプタをインポートする場合の，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースと接続するための設定（DB Connectorを使用する場合）
「4.2.1　DB Connectorのインポート」

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）
「4.4.1　リソースアダプタのインポート」

14.3　リソースアダプタのプロパティ定義

属性ファイル編集エディタを起動して，次のリソースアダプタの属性や動作を定義します。

インポートしたリソースアダプタ

J2EEリソースアダプタとしてデプロイしたリソースアダプタ

＜この節の構成＞

14.3.1　属性ファイル編集エディタの起動

14.3.2　プロパティ設定手順（Connector 1.0の場合）

14.3.3　プロパティ設定手順（Connector 1.5の場合）

14.3.4　対応するサーバ管理コマンド

14.3.1　属性ファイル編集エディタの起動

リソースアダプタのプロパティ定義には，Connector属性ファイル編集エディタを使用します。

Connector属性ファイル編集エディタは次の方法で起動します。

［サーバー・エクスプローラー］ビューで，属性を編集する［＜J2EEリソースアダプタ名＞］または［＜リソースアダプタ名＞］（J2EEリソースフォルダ内）を選択します。

次のどれかの方法で，Connector属性ファイル編集エディタを起動します。

［サーバー・エクスプローラー］ビューで選択したノードをダブルクリックします。

ビュープルダウンメニューの［[図データ]プロパティ］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]プロパティ］を選択します。

Connector属性ファイル編集エディタが起動されると，画面のエディタエリアに，Connector属性ファイルを編集するためのフォームページが表示されます。

エディタエリアのフォームページでプロパティを設定します。
設定手順はリソースアダプタが対応するコネクタのアーキテクチャのバージョンによって異なります。

Connector 1.0の仕様に準拠するリソースアダプタ
プロパティ設定手順については，「14.3.2　プロパティ設定手順（Connector 1.0の場合）」を参照してください。

Connector 1.5の仕様に準拠するリソースアダプタ
プロパティ設定手順については，「14.3.3　プロパティ設定手順（Connector 1.5の場合）」を参照してください。

なお，アプリケーションサーバで提供されているリソースアダプタは，Connector 1.0の仕様に準拠しています。

プロパティの設定操作および属性ファイル編集エディタについては，「11.3　プロパティの設定」を参照してください。

14.3.2　プロパティ設定手順（Connector 1.0の場合）

プロパティ操作が実行されると，画面のエディタエリアに，Connector属性ファイルを編集するためのフォームページが表示されます。エディタエリアのフォームページで，次のプロパティを設定します。

リソースアダプタの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

＜この項の構成＞

(1)　一般情報

(2)　コンフィグレーションプロパティ

(3)　実行時プロパティ

(4)　別名情報

(1)　一般情報

エディタエリアに表示されたConnector属性ツリーで，［リソース・アダプター］を選択します。
リソースアダプタのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
一般情報のプロパティページについては，「21.2.2　Connector属性設定ページ」の「(3)　リソースアダプタのプロパティページ」を参照してください。

(2)　コンフィグレーションプロパティ

エディタエリアに表示されたConnector属性ツリーで，［＜コネクション定義識別子＞］または［＜コネクション定義識別子＞］下の［コンフィグレーション・プロパティー］を選択して，マウスで右クリックします。
コンテキストメニューが表示されます。

コンテキストメニューで［追加］を選択します。
コンフィグレーションプロパティのプロパティページが表示されます。

コンフィグレーションプロパティを変更する場合は，表示されたツリーで，［＜コンフィグレーションプロパティ名＞］を選択します。
コンフィグレーションプロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
コンフィグレーションプロパティのページは，コンフィグレーションプロパティ名によって，次の2種類があります。

XAOpenString以外のコンフィグレーションプロパティのページ

XAOpenStringのコンフィグレーションプロパティのページ

XAOpenString以外のコンフィグレーションプロパティのページについては，「21.2.2　Connector属性設定ページ」の「(8)　コンフィグレーションプロパティのプロパティページ（XAOpenString以外）」を参照してください。XAOpenStringのコンフィグレーションプロパティのページについては，「21.2.2　Connector属性設定ページ」の「(9)　コンフィグレーションプロパティのプロパティページ（XAOpenString）」を参照してください。
表示されたプロパティページで，これらのコンフィグレーションプロパティ名を変更した場合は，手順3.の操作を実行して画面を再表示してください。

(3)　実行時プロパティ

エディタエリアに表示されたConnector属性ツリーで，［コネクター・ランタイム］下の［プロパティー］を選択します。
実行時プロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
実行時プロパティのプロパティページについては，「21.2.2　Connector属性設定ページ」の「(10)　プロパティのプロパティページ（Outboundリソースアダプタ）」を参照してください。

(4)　別名情報

エディタエリアに表示されたConnector属性ツリーで，［コネクター・ランタイム］または［コネクター・ランタイム］下の［リソース外部プロパティー］をマウスで右クリックします。
コンテキストメニューが表示されます。

コンテキストメニューで［追加］を選択します。
リソース外部プロパティのプロパティページが表示されます。

別名を変更する場合は，表示されたツリーで，［コネクター・ランタイム］下の［＜リソース外部プロパティ名＞］を選択します。
リソース外部プロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
別名情報のプロパティページについては，「21.2.2　Connector属性設定ページ」の「(12)　リソース外部プロパティのプロパティページ」を参照してください。

14.3.3　プロパティ設定手順（Connector 1.5の場合）

プロパティ操作が実行されると，画面のエディタエリアに，Connector属性ファイルを編集するためのフォームページが表示されます。エディタエリアのフォームページで，プロパティを設定します。

次のプロパティを設定します。

コンフィグレーションプロパティ

Outboundリソースアダプタのプロパティ

Inboundリソースアダプタのプロパティ

管理対象オブジェクトのプロパティ

実行時プロパティ

＜この項の構成＞

(1)　コンフィグレーションプロパティ

(2)　Outboundリソースアダプタのプロパティ

(3)　Inboundリソースアダプタのプロパティ

(4)　管理対象オブジェクトのプロパティ

(5)　実行時プロパティ

(1)　コンフィグレーションプロパティ

エディタエリアに表示されたConnector属性ツリーで，［リソース・アダプター］または［リソース・アダプター］下の［コンフィグレーション・プロパティー］を選択して，マウスで右クリックします。
コンテキストメニューが表示されます。

コンテキストメニューで［追加］を選択します。
コンフィグレーションプロパティのプロパティページが表示されます。

コンフィグレーションプロパティを変更する場合は，表示されたツリーで，［＜コンフィグレーションプロパティ名＞］を選択します。
コンフィグレーションプロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
コンフィグレーションプロパティのページは，コンフィグレーションプロパティ名によって，次の2種類があります。

XAOpenString以外のコンフィグレーションプロパティのページ

XAOpenStringのコンフィグレーションプロパティのページ

XAOpenString以外のコンフィグレーションプロパティのページについては，「21.2.2　Connector属性設定ページ」の「(8)　コンフィグレーションプロパティのプロパティページ（XAOpenString以外）」を参照してください。XAOpenStringのコンフィグレーションプロパティのページについては，「21.2.2　Connector属性設定ページ」の「(9)　コンフィグレーションプロパティのプロパティページ（XAOpenString）」を参照してください。
表示されたプロパティページで，これらのコンフィグレーションプロパティ名を変更した場合は，手順3.の操作を実行して画面を再表示してください。

(2)　Outboundリソースアダプタのプロパティ

Connector 1.5の仕様に準拠するOutboundリソースアダプタは，コネクション定義を複数持つ場合があります。プロパティ項目は，次のように分けて設定します。

リソースアダプタ単位のプロパティ設定

コネクション単位のプロパティ設定

(a)　リソースアダプタ単位のプロパティ設定

エディタエリアに表示されたConnector属性ツリーで，［アウトバウンド・リソース・アダプター］を選択します。
Outboundリソースアダプタのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
Outboundリソースアダプタのプロパティページについては，「21.2.2　Connector属性設定ページ」の「(4)　Outboundリソースアダプタのプロパティページ」を参照してください。

(b)　コネクション単位のプロパティ設定

次のプロパティを設定します。

コンフィグレーションプロパティ

実行時プロパティ

別名情報

●コンフィグレーションプロパティ

エディタエリアに表示されたConnector属性ツリーで，［＜コネクション定義識別子＞］または［＜コネクション定義識別子＞］下の［コンフィグレーション・プロパティー］を選択して，マウスで右クリックします。
コンテキストメニューが表示されます。

コンテキストメニューで［追加］を選択します。
コンフィグレーションプロパティのプロパティページが表示されます。

コンフィグレーションプロパティを変更する場合は，表示されたツリーで，［＜コンフィグレーションプロパティ名＞］を選択します。
コンフィグレーションプロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
コンフィグレーションプロパティのページは，コンフィグレーションプロパティ名によって，次の2種類があります。

XAOpenString以外のコンフィグレーションプロパティのページ

XAOpenStringのコンフィグレーションプロパティのページ

XAOpenString以外のコンフィグレーションプロパティのページについては，「21.2.2　Connector属性設定ページ」の「(8)　コンフィグレーションプロパティのプロパティページ（XAOpenString以外）」を参照してください。「21.2.2　Connector属性設定ページ」のXAOpenStringのコンフィグレーションプロパティのページについては，「(9)　コンフィグレーションプロパティのプロパティページ（XAOpenString）」を参照してください。

表示されたプロパティページで，これらのコンフィグレーションプロパティ名を変更した場合は，手順3.の操作を実行して画面を再表示してください。

●実行時プロパティ

エディタエリアに表示されたConnector属性ツリーで，［コネクター・ランタイム］下の［プロパティー］を選択します。
実行時プロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。

実行時プロパティのプロパティページについては，「21.2.2　Connector属性設定ページ」の「(10)　プロパティのプロパティページ（Outboundリソースアダプタ）」を参照してください。

●別名情報

エディタエリアに表示されたConnector属性ツリーで，［コネクター・ランタイム］または［コネクター・ランタイム］下の［リソース外部プロパティー］をマウスで右クリックします。
コンテキストメニューが表示されます。

コンテキストメニューで［追加］を選択します。
リソース外部プロパティのプロパティページが表示されます。

別名を変更する場合は，表示されたツリーで，［コネクター・ランタイム］下の［＜リソース外部プロパティ名＞］を選択します。
リソース外部プロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
別名情報のプロパティページについては，「21.2.2　Connector属性設定ページ」の「(12)　リソース外部プロパティのプロパティページ」を参照してください。

(3)　Inboundリソースアダプタのプロパティ

Inboundリソースアダプタのプロパティは変更できません。プロパティページを表示して，設定されているプロパティ項目を参照してください。

エディタエリアに表示されたConnector属性ツリーで，［インバウンド・リソース・アダプター］を選択します。

［インバウンド・リソース・アダプター］下の各ノードを選択します。

メッセージリスナのプロパティを参照する場合
［＜メッセージリスナ名＞］を選択すると，メッセージリスナのプロパティページが表示されます。

ActivationSpecのプロパティを参照する場合
［アクティベーション・スペック］を選択すると，ActivationSpecのプロパティページが表示されます。

必須コンフィグレーションプロパティを参照する場合
［＜必須コンフィグレーションプロパティ名＞］を選択すると，必須コンフィグレーションプロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を参照します。
各プロパティページについては，「21.2.2　Connector属性設定ページ」の「(14)　メッセージリスナのプロパティページ」，「(15)　ActivationSpecのプロパティページ」，または「(17)　必須コンフィグレーションプロパティのプロパティページ」を参照してください。

(4)　管理対象オブジェクトのプロパティ

エディタエリアに表示されたConnector属性ツリーで，［リソース・アダプター］下の［管理対象オブジェクト］を選択して，マウスで右クリックします。
コンテキストメニューが表示されます。

コンテキストメニューで［追加］を選択します。
管理対象オブジェクトのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
管理対象オブジェクトのプロパティページについては，「21.2.2　Connector属性設定ページ」の「(19)　管理対象オブジェクトのプロパティページ」を参照してください。

(5)　実行時プロパティ

エディタエリアに表示されたConnector属性ツリーで，［リソース・アダプター・ランタイム］下の［プロパティー］を選択します。
実行時プロパティのプロパティページが表示されます。

表示されたプロパティページで，プロパティ項目を設定します。
実行時プロパティのプロパティページについては，「21.2.2　Connector属性設定ページ」の「(20)　プロパティのプロパティページ（リソースアダプタ）」を参照してください。

14.3.4　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，次のコマンドです。

cjgetresprop

cjsetresprop

cjgetrarprop

cjsetrarprop

リソースアダプタのプロパティを設定する場合の，設定例，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースと接続するための設定（DB Connectorを使用する場合）
「4.2.2　DB Connectorのプロパティ定義」

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）
リソースアダプタのバージョンに対応して，次の説明を参照してください。

「4.4.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」

「4.4.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」

14.4　リソースアダプタのデプロイ

リソースアダプタをデプロイします。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

リソースアダプタをデプロイする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース］フォルダ内の［リソース・アダプター］フォルダ下の［＜リソースアダプタ名＞］を選択します。

次のどちらかの操作で，リソースアダプタをデプロイします。

ビュープルダウンメニューの［[図データ]デプロイ］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]デプロイ］を選択します。

デプロイが実行されます。

注意

実行時情報を含んだJ2EEリソースアダプタをインポートしてデプロイすると，［サーバー・エクスプローラー］ビューではデプロイされたJ2EEリソースアダプタの稼働状態として，「停止」が仮定されて表示されます。このため，デプロイされたJ2EEリソースアダプタの実際の状態と表示が不一致になる場合があります。実際の状態と一致させるためには，［表示の更新］を実行してください。［表示の更新］については，「11.2　表示の更新」の「(4)　J2EEリソースアダプタの状態表示」を参照してください。

(2)　画面表示

リソースアダプタのデプロイで使用する画面については，「21.1.29　リソースアダプタのデプロイ」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjdeployrarコマンドです。

リソースアダプタをデプロイする場合の，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースと接続するための設定（DB Connectorを使用する場合）
「4.2.3　DB Connectorのデプロイ」

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）
「4.4.4　リソースアダプタのデプロイ」

14.5　J2EEリソースアダプタの接続テスト

J2EEリソースアダプタの接続テストをします。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEリソースアダプタの接続テストの手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース・アダプター］フォルダ下の［＜J2EEリソースアダプタ名＞］を選択します。

次のどちらかの操作で，J2EEリソースアダプタの接続テストをします。

ビュープルダウンメニューの［[図データ]接続テスト］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]接続テスト］を選択します。

操作が実行され，接続テストに成功した場合は，テスト成功のメッセージダイアログが表示されます。

(2)　画面表示

J2EEリソースアダプタの接続テストで使用する画面については，「21.1.28　接続テスト」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjtestresコマンドです。

リソースアダプタを接続テストする場合の，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースと接続するための設定（DB Connectorを使用する場合）
「4.2.4　DB Connectorの接続テスト」

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）
「4.4.5　J2EEリソースアダプタの接続テスト」

14.6　J2EEリソースアダプタの開始と停止

J2EEアプリケーションを実行する前に，J2EEアプリケーションで利用するすべてのJ2EEリソースアダプタを開始してください。また，J2EEアプリケーションを停止する場合，J2EEアプリケーションが停止してから，J2EEリソースアダプタを停止してください。J2EEリソースアダプタの開始と停止の手順を，次に示します。

＜この節の構成＞

14.6.1　J2EEリソースアダプタの開始

14.6.2　J2EEリソースアダプタの停止

14.6.1　J2EEリソースアダプタの開始

リソースアダプタを開始します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

リソースアダプタを開始する手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース・アダプター］フォルダ下の［＜J2EEリソースアダプタ名＞］を選択します。

次の操作のどれかで，リソースアダプタを開始します。

ビューツールバーの［[図データ]］（開始）をクリックします。

ビュープルダウンメニューの［[図データ]開始］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]開始］を選択します。

J2EEリソースアダプタの開始が実行されます。

(2)　画面表示

リソースアダプタの開始で使用する画面については，「21.1.4　開始」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjstartrarコマンドです。

リソースアダプタを開始する場合の，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースを開始するための設定（DB Connectorを使用する場合）
「4.2.5　DB Connectorの開始」

そのほかのリソースを開始するための設定（ほかのリソースアダプタを使用する場合）
「4.4.6　J2EEリソースアダプタの開始」

14.6.2　J2EEリソースアダプタの停止

J2EEリソースアダプタを停止します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEリソースアダプタを停止する手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース・アダプター］フォルダ下の［＜J2EEリソースアダプタ名＞］を選択します。

次の操作のどれかで，リソースアダプタを停止します。

ビューツールバーの［[図データ]］（停止）をクリックします。

ビュープルダウンメニューの［[図データ]停止］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]停止］を選択します。

J2EEリソースアダプタの停止が実行されます。

(2)　画面表示

リソースアダプタの停止で使用する画面については，「21.1.7　停止」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjstoprarコマンドです。

リソースアダプタを停止する場合の，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースを停止するための設定（DB Connectorを使用する場合）
「4.2.6　DB Connectorの停止」

そのほかのリソースを停止するための設定（ほかのリソースアダプタを使用する場合）
「4.4.7　J2EEリソースアダプタの停止」

14.7　リソースアダプタの削除

J2EEリソースアダプタまたはリソースアダプタを削除します。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEリソースアダプタまたはリソースアダプタの削除手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース・アダプター］フォルダ下の［＜J2EEリソースアダプタ名＞］または［J2EEリソース］フォルダ下にある［リソース・アダプター］フォルダ下の［＜リソース・アダプタ＞］を選択します。

次の操作のどちらかで，リソースアダプタを削除します。

ビュープルダウンメニューの［[図データ]削除］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]削除］を選択します。

［サーバー・エクスプローラー］ビューで，［＜J2EEリソースアダプタ名＞］を選択した場合，［＜J2EEリソースアダプタ名＞］が停止状態のときだけ操作は活性となっています。
［削除の確認］ダイアログが表示されます。

［削除の確認］ダイアログで，［はい］または［いいえ］を選択します。
［はい］を選択すると，削除は実行されます。［いいえ］を選択すると，削除は中止されます。

(2)　画面表示

リソースアダプタの削除で使用する画面については，「21.1.9　削除」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjundeployrarコマンドまたはcjdeleteresコマンドです。

リソースアダプタを削除する場合の，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースを削除するための設定（DB Connectorを使用する場合）
「4.2.7　DB Connectorのアンデプロイ」（J2EEリソースアダプタの削除の場合）
「4.9　リソースアダプタの削除」（リソースアダプタの削除の場合）

そのほかのリソースを削除するための設定
「4.4.8　J2EEリソースアダプタのアンデプロイ」（J2EEリソースアダプタの削除の場合）
「4.9　リソースアダプタの削除」（リソースアダプタの削除の場合）

14.8　J2EEリソースアダプタのエクスポート

J2EEリソースアダプタのエクスポートします。J2EEリソースアダプタのエクスポートには，実行時情報を含める場合と実行時情報を含めない場合があります。

注意

Windows 7またはWindows Vistaで管理者特権のないユーザが，エクスポート先に，C:¥Program Files以下のディレクトリを指定した場合の対応については，「11.4　Server Plug-inの注意事項」の「(1)　Windows 7またはWindows Vista使用時の注意事項」を参照してください。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

●実行時情報を含めて，J2EEリソースアダプタをエクスポートする場合

実行時情報を含んだJ2EEリソースアダプタをエクスポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース・アダプター］フォルダの［＜J2EEリソースアダプタ名＞］を選択します。

次のどちらかの方法で，J2EEリソースアダプタをエクスポートします。

ビューツールバーの［[図データ]］（エクスポート）をクリックすると表示される，サブメニューの［[図データ]Cosminexusリソース・アダプター］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]Cosminexusリソース・アダプターのエクスポート］を選択します。

エクスポートが実行されると，［Cosminexusリソース・アダプターのエクスポート］ダイアログが表示されます。

エクスポートするJ2EEリソースアダプタ用ファイル（RARファイル）を指定して，［保存］を実行します。
エクスポートが開始されます。

●実行時情報を含めないで，J2EEリソースアダプタをエクスポートする場合

実行時情報を含めないで，J2EEリソースアダプタをエクスポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース・アダプター］フォルダの［＜J2EEリソースアダプタ名＞］を選択します。

次のどちらかの方法で，J2EEリソースアダプタをエクスポートします。

ビューツールバーの［[図データ]］（エクスポート）をクリックすると表示される，サブメニューの［[図データ]J2EEリソース・アダプター］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]J2EEリソース・アダプターのエクスポート］を選択します。

エクスポートが実行されると，［J2EEリソース・アダプターのエクスポート］ダイアログが表示されます。

エクスポートするJ2EEリソースアダプタ用ファイル（RARファイル）を指定して，［保存］を実行します。
エクスポートが開始されます。

(2)　画面表示

●実行時情報を含めて，J2EEリソースアダプタをエクスポートする場合

実行時情報を含めて，J2EEリソースアダプタをエクスポートする場合，使用する画面については，「21.1.25　Cosminexusリソースアダプタのエクスポート」を参照してください。

●実行時情報を含めないで，J2EEリソースアダプタをエクスポートする場合

実行時情報を含めないで，J2EEリソースアダプタをエクスポートする場合，使用する画面については，「21.1.27　J2EEリソースアダプタのエクスポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjexportrarコマンドです。

リソースアダプタをエクスポートする場合の，注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースをエクスポートするための設定（DB Connectorを使用する場合）
「4.2.8　DB Connectorのエクスポート」

そのほかのリソースをエクスポートするための設定（ほかのリソースアダプタを使用する場合）
「4.4.9　J2EEリソースアダプタのエクスポート」

14.9　Connector属性のインポートとエクスポート

この節では，Server Plug-inを使用したConnector属性のインポートとエクスポートについて説明します。

Server Plug-inでは，J2EEリソースアダプタのプロパティを設定する方法として，次の二つの方法を提供しています。

属性ファイル編集エディタのフォームページでプロパティを設定します。属性ファイル編集エディタは，Server Plug-inのプロパティ操作で起動されます。
Server Plug-inのプロパティ操作については，「11.3　プロパティの設定」を参照してください。

Connector属性をConnector属性ファイルに取得し，プロパティ設定項目を編集します。編集したConnector属性ファイルの値を，J2EEリソースアダプタの属性に反映します。

この節で，Connector属性の取得（エクスポート）とConnector属性の設定（インポート）の操作について説明します。

プロパティの設定項目については，「14.3　リソースアダプタのプロパティ定義」を参照してください。

＜この節の構成＞

14.9.1　Connector属性のインポート

14.9.2　Connector属性のエクスポート

14.9.1　Connector属性のインポート

J2EEリソースアダプタの属性を，Connector属性ファイルの値に変更します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

Connector属性をインポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース・アダプター］フォルダ下の［＜J2EEリソースアダプタ名＞］または［J2EEリソース］フォルダ下にある［リソース・アダプター］フォルダの［＜リソースアダプタ名＞］を選択します。

次の操作のどちらかで，Connector属性をインポートします。

ビューツールバーの［[図データ]］（インポート）をクリックします。表示されるサブメニューの［[図データ]Connector属性］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]Connector属性のインポート］を選択します。

［サーバー・エクスプローラー］ビューで，［＜J2EEリソースアダプタ名＞］を選択した場合，［＜J2EEリソースアダプタ名＞］が停止状態のときだけ操作が活性となっています。
Connector属性のインポートが実行されると，［Connector属性のインポート］ダイアログが表示されます。

インポートするConnector属性ファイルを指定して，［開く］を実行します。
インポートが開始されます。

(2)　画面表示

Connector属性のインポートで使用する画面については，「21.1.16　Connector属性のインポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，次のコマンドです。

cjsetrespropコマンド

cjsetrarpropコマンド

Connector属性をインポートして，Connector属性を設定する場合のサーバ管理コマンドについては，「3.3　属性ファイルによるプロパティの設定」を参照してください。

14.9.2　Connector属性のエクスポート

J2EEリソースアダプタの属性をConnector属性ファイルに取得します。

注意

Windows 7またはWindows Vistaで管理者特権のないユーザが，エクスポート先に，C:¥Program Files以下のディレクトリを指定した場合の対応については，「11.4　Server Plug-inの注意事項」の「(1)　Windows 7またはWindows Vista使用時の注意事項」を参照してください。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

Connector属性をエクスポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEリソース・アダプター］フォルダ下の［＜J2EEリソースアダプタ名＞］を選択します。

次の操作のどちらかで，Connector属性をConnector属性ファイルにエクスポートします。

ビューツールバーの［[図データ]］（エクスポート）をクリックして，表示されるサブメニューの［[図データ]Connector属性］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]Connector属性のエクスポート］を選択します。

エクスポートが実行されると，［Connector属性のエクスポート］ダイアログが表示されます。

エクスポートする属性ファイルを指定して，［保存］を実行します。
エクスポートが開始されます。

(2)　画面表示

Connector属性のエクスポートで使用する画面については，「21.1.22　Connector属性のエクスポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，次のコマンドです。

cjgetrespropコマンド

cjgetrarpropコマンド

Connector属性をエクスポートして，Connector属性を取得する場合のサーバ管理コマンドについては，「3.3　属性ファイルによるプロパティの設定」を参照してください。

15.　J2EEアプリケーションに含まれるリソースアダプタの設定

この章では，Server Plug-inを使用した，J2EEアプリケーションに含まれるリソースアダプタの設定について説明します。

＜この章の構成＞

15.1　J2EEアプリケーションに含まれるリソースアダプタの設定の概要

15.2　リソースアダプタを含むJ2EEアプリケーションのインポート

15.3　リソースアダプタのプロパティ定義

15.4　リソースアダプタの接続テスト

15.5　リソースアダプタを含むJ2EEアプリケーションの開始と停止

15.6　Connector属性のインポートとエクスポート

15.1　J2EEアプリケーションに含まれるリソースアダプタの設定の概要

J2EEアプリケーションに含めて使用するリソースアダプタの種類と，アプリケーション設定操作の概要について説明します。

＜この節の構成＞

(1)　利用できるリソースアダプタ

(2)　リソースアダプタの設定操作

(1)　利用できるリソースアダプタ

J2EEアプリケーションに含めて使用するリソースアダプタの種類は，サーバ管理コマンドを使用して，リソースアダプタを設定する場合と同じです。J2EEアプリケーションに含めて使用できるリソースアダプタの種類については，「5.1.1　利用できるリソースアダプタ」を参照してください。

(2)　リソースアダプタの設定操作

J2EEアプリケーションに含めて使用するリソースアダプタの設定に必要な作業は次のとおりです。

リソースアダプタを含むJ2EEアプリケーションのインポート

リソースアダプタのプロパティ定義

リソースアダプタの接続テスト

リソースアダプタを含むJ2EEアプリケーションの開始

リソースアダプタを含むJ2EEアプリケーションの停止

また，必要に応じてJ2EEアプリケーションに含まれるリソースアダプタのConnector属性をインポートおよびエクスポートします。

Server Plug-inを使用したJ2EEリソースの管理（GUI）の機能と，サーバ管理コマンド（CUI）の対応を次の表に示します。

表15-1　Server Plug-inを使用したJ2EEリソースの管理の機能とサーバ管理コマンドの対応

機能
対応するコマンド
参照先

リソースアダプタを含むJ2EEアプリケーションのインポート
cjimportapp
15.2

リソースアダプタのプロパティ定義
cjgetappprop（-type rar指定），
cjsetappprop（-type rar指定）
15.3

リソースアダプタの接続テスト
cjtestres（-name ＜J2EEアプリケーション名＞-type rar指定）
15.4

リソースアダプタを含むJ2EEアプリケーションの開始
cjstartapp
15.5

リソースアダプタを含むJ2EEアプリケーションの停止
cjstopapp
15.5

Connector属性のインポートとエクスポート
cjgetappprop（-type rar指定），
cjsetappprop（-type rar指定）
15.6

J2EEアプリケーションに含まれるリソースアダプタの設定の注意事項については，サーバ管理コマンドによるリソースアダプタの設定（「5.　J2EEアプリケーションに含まれるリソースアダプタの設定」）を参照してください。

15.2　リソースアダプタを含むJ2EEアプリケーションのインポート

リソースアダプタを含むJ2EEアプリケーションをインポートします。

インポートを実行する前に，J2EEアプリケーションに含まれるリソースアダプタと同じ表示名，または別名のリソースアダプタがJ2EEリソースアダプタとしてデプロイされていないことを確認してください。デプロイされているリソースアダプタは，［サーバー・エクスプローラー］ビューの［J2EEリソース・アダプター］フォルダ内の［＜J2EEリソースアダプタ名＞］に表示されています。

次のJ2EEアプリケーションをインポートできます。

アーカイブ形式のJ2EEアプリケーション
J2EEサーバの作業ディレクトリ以下に，EJB-JAR/WAR/RARファイルのコンポーネントを持つJ2EEアプリケーションです。
アーカイブ形式のJ2EEアプリケーションのインポート操作については，「17.1.1　アーカイブ形式のJ2EEアプリケーションのインポート」を参照してください。

展開ディレクトリ形式のJ2EEアプリケーション
EJB-JARやWARなどのアプリケーションの実体を，J2EEサーバの外部にある一定のルールに従ったファイル／ディレクトリに持つJ2EEアプリケーションです。ただし，展開ディレクトリ形式のJ2EEアプリケーションに含まれるRARファイルはアーカイブ形式で格納されます。
展開ディレクトリ形式のJ2EEアプリケーションのインポート操作については，「17.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。

15.3　リソースアダプタのプロパティ定義

属性ファイル編集エディタを起動して，J2EEアプリケーションに含まれるリソースアダプタの属性や動作を定義します。

＜この節の構成＞

15.3.1　属性ファイル編集エディタの起動

15.3.2　プロパティ設定手順

15.3.1　属性ファイル編集エディタの起動

リソースアダプタのプロパティ定義には，属性ファイル編集エディタを使用します。

属性ファイル編集エディタには，次の二つのエディタがあります。

アプリケーション統合属性ファイル編集エディタ

Connector属性ファイル編集エディタ

J2EEアプリケーションに含まれるリソースアダプタは，どちらのエディタを使用してもリソースアダプタのプロパティ定義ができます。ただし，これらの属性ファイル編集エディタを，同時に起動することはできません。

＜この項の構成＞

(1)　アプリケーション統合属性ファイル編集エディタの起動

(2)　Connector属性ファイル編集エディタの起動

(1)　アプリケーション統合属性ファイル編集エディタの起動

アプリケーション統合属性ファイル編集エディタは，次の方法で起動します。

［サーバー・エクスプローラー］ビューで，プロパティを設定するリソースアダプタが含まれている［＜J2EEアプリケーション＞］を選択します。

次のどれかの方法で，アプリケーション統合属性ファイル編集エディタを起動します。

［サーバー・エクスプローラー］ビューで選択したノードをダブルクリックします。

ビュープルダウンメニューの［[図データ]プロパティ］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]プロパティ］を選択します。
アプリケーション統合属性ファイル編集エディタが起動されると，画面のエディタエリアに，アプリケーション統合属性ファイルを編集するためのフォームページが表示されます。

フォームページの「RAR」タブをクリックしてください。
画面のエディタエリアに，J2EEアプリケーションに含まれるリソースアダプタの［Connector属性］フォームページが表示されます。フォームページで，リソースアダプタのプロパティを設定してください。

(2)　Connector属性ファイル編集エディタの起動

Connector属性ファイル編集エディタは，次の方法で起動します。

［サーバー・エクスプローラー］ビューで，［＜J2EEアプリケーション＞］下の［＜リソースアダプタ名＞］を選択します。

次のどれかの方法で，Connector属性ファイル編集エディタを起動します。

［サーバー・エクスプローラー］ビューで選択したノードをダブルクリックします。

ビュープルダウンメニューの［[図データ]プロパティ］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]プロパティ］を選択します。
Connector属性ファイル編集エディタが起動されると，画面のエディタエリアに，Connector属性ファイルを編集するためのフォームページが表示されます。フォームページで，リソースアダプタのプロパティを設定してください。

15.3.2　プロパティ設定手順

属性ファイル編集エディタのフォームページで，プロパティを設定します。

なお，設定手順は，リソースアダプタが対応するコネクタアーキテクチャのバージョンによって異なります。

Connector 1.0の仕様に準拠するリソースアダプタ
プロパティ設定手順については，「14.3.2　プロパティ設定手順（Connector 1.0の場合）」を参照してください。

Connector 1.5の仕様に準拠するリソースアダプタ
プロパティ設定手順については，「14.3.3　プロパティ設定手順（Connector 1.5の場合）」を参照してください。

15.4　リソースアダプタの接続テスト

J2EEアプリケーションに含まれるリソースアダプタの接続テストをします。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEアプリケーションに含まれるリソースアダプタの接続テストの手順を次に示します。

［サーバー・エクスプローラー］ビューで，［＜J2EEアプリケーション＞］下の［＜リソースアダプタ名＞］を選択します。

次のどちらかの操作で，リソースアダプタの接続テストをします。

ビュープルダウンメニューの［[図データ]接続テスト］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]接続テスト］を選択します。

操作が実行され，接続テストに成功した場合は，テスト成功のメッセージダイアログが表示されます。

(2)　画面表示

リソースアダプタの接続テストで使用する画面については，「21.1.28　接続テスト」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjtestres（-name ＜J2EEアプリケーション名＞-type rar指定）コマンドです。

J2EEアプリケーションに含まれるリソースアダプタを接続テストする場合の注意事項およびサーバ管理コマンドについては，次の説明を参照してください。

データベースと接続するための設定（DB Connectorを使用する場合）
「4.2.4　DB Connectorの接続テスト」

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）
「4.4.5　J2EEリソースアダプタの接続テスト」

15.5　リソースアダプタを含むJ2EEアプリケーションの開始と停止

J2EEアプリケーションを開始すると，J2EEアプリケーションに含まれるすべてのリソースアダプタは開始されます。また，J2EEアプリケーションを停止すると，J2EEアプリケーションに含まれるすべてのリソースアダプタは停止されます。リソースアダプタの開始順序および停止順序の制御はできません。

J2EEアプリケーションの開始については，「19.2　J2EEアプリケーションの開始」を参照してください。

J2EEアプリケーションの停止については，「19.3　J2EEアプリケーションの停止」を参照してください。

注意事項

J2EEアプリケーションがリソースアダプタを含み，application.xmlの<module>タグ以下でRARを記述している場合，EJB-JARやWARが，リソースアダプタを参照していなくても，J2EEアプリケーション開始時にリソースアダプタは開始されます。

15.6　Connector属性のインポートとエクスポート

J2EEアプリケーションに含まれるリソースアダプタのConnector属性の取得（エクスポート）とConnector属性の設定（インポート）の手順について説明します。

＜この節の構成＞

15.6.1　Connector属性のインポート

15.6.2　Connector属性のエクスポート

15.6.1　Connector属性のインポート

J2EEアプリケーションに含まれるリソースアダプタの属性を，Connector属性ファイルの値に変更します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

Connector属性をインポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［＜J2EEアプリケーション＞］下の［＜リソースアダプタ名＞］を選択します。

次の操作のどちらかで，Connector属性をインポートします。

ビューツールバーの［[図データ]］（インポート）をクリックします。表示されるサブメニューの［[図データ]Connector属性］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]Connector属性のインポート］を選択します。

［サーバー・エクスプローラー］ビューで，［＜J2EEアプリケーション＞］が停止状態のときだけ操作が活性となっています。
Connector属性のインポートが実行されると，［Connector属性のインポート］ダイアログが表示されます。

インポートするConnector属性ファイルを指定して，［開く］を実行します。
インポートが開始されます。

(2)　画面表示

Connector属性のインポートで使用する画面については，「21.1.16　Connector属性のインポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjsetappprop（-type rar指定）コマンドです。

15.6.2　Connector属性のエクスポート

J2EEアプリケーションに含まれるリソースアダプタの属性を，Connector属性ファイルに取得します。

注意

Windows 7またはWindows Vistaで管理者特権のないユーザが，エクスポート先に，C:¥Program Files以下のディレクトリを指定した場合の対応については，「11.4　Server Plug-inの注意事項」の「(1)　Windows 7またはWindows Vista使用時の注意事項」を参照してください。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

Connector属性をエクスポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［＜J2EEアプリケーション＞］下の［＜リソースアダプタ名＞］を選択します。

次の操作のどちらかで，Connector属性をConnector属性ファイルにエクスポートします。

ビューツールバーの［[図データ]］（エクスポート）をクリックして，表示されるサブメニューの［[図データ]Connector属性］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]Connector属性のエクスポート］を選択します。

エクスポートが実行されると，［Connector属性のエクスポート］ダイアログが表示されます。

エクスポートする属性ファイルを指定して，［保存］を実行します。
エクスポートが開始されます。

(2)　画面表示

Connector属性のエクスポートで使用する画面については，「21.1.22　Connector属性のエクスポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjsetappprop（-type rar指定）コマンドです。

16.　Server Plug-inによるJ2EEアプリケーションの設定の概要

この章では，Server Plug-inを使用した，J2EEアプリケーションの設定の概要について説明します。

＜この章の構成＞

16.1　J2EEアプリケーション設定の機能一覧

16.2　ビューツールバーでのJ2EEアプリケーション設定操作

16.3　J2EEアプリケーションの状態表示

16.1　J2EEアプリケーション設定の機能一覧

サーバ管理コマンド（CUI）の機能と比較して，Server Plug-inを使用したJ2EEアプリケーションの管理（GUI）で使用できる機能を次に示します。

表16-1　J2EEアプリケーション設定操作の機能比較

機能 | 対応するコマンド | Server Plug-inでの操作 | 参照先
J2EEアプリケーション／属性のインポート | アーカイブ形式のJ2EEアプリケーション | cjimportapp | ○ | 17.1.1
展開ディレクトリ形式のJ2EEアプリケーション（アプリケーションディレクトリパス指定） | cjimportapp（-a ＜アプリケーションディレクトリパス＞オプション指定） | ○ | 17.1.2
展開ディレクトリ形式のJ2EEアプリケーション（展開ディレクトリパス指定） | cjimportapp（-d ＜展開ディレクトリパス＞オプション指定） | × | －
アプリケーション統合属性のインポート | cjsetappprop | ○ | 20.2
J2EEアプリケーション／属性のエクスポート | 標準のJ2EEアプリケーションのエクスポート | cjexportapp（-rawオプション指定） | ○ | 17.2
実行時情報付きのJ2EEアプリケーションのエクスポート | cjexportapp（-normalオプション指定） | ○ | 17.2
アプリケーション統合属性のエクスポート | cjgetappprop | ○ | 20.3
J2EEアプリケーションの実行 | J2EEアプリケーションの通常開始 | cjstartapp | ○ | 19.2
JSPをコンパイルして開始 | cjstartapp（-jspオプション指定） | × | －
J2EEアプリケーションの通常停止 | cjstopapp | ○ | 19.3.1
J2EEアプリケーションの通常停止実行後，自動強制停止 | cjstopapp（-cancelオプション指定） | × | －
J2EEアプリケーションの強制停止 | cjstopapp（-forceオプション指定） | ○ | 19.3.2
J2EEアプリケーションのプロパティの設定※1 | cjgetappprop，cjsetappprop | ○ | 18.1
J2EEアプリケーションの一覧の参照 | （cjlistapp） | △※2 | －
J2EEアプリケーションの削除 | cjdeleteapp | ○ | 19.4
アーカイブ形式のアプリケーションの入れ替え | cjreplaceapp | ○ | 19.5.1
展開ディレクトリ形式のアプリケーションの入れ替え | cjreloadapp | ○ | 19.5.2
J2EEアプリケーション名の変更 | cjrenameapp | ○ | 19.6
RMI-IIOPスタブとインタフェースの取得 | cjgetstubsjar | ○ | 19.7

（凡例）

○：使用できる　△：類似機能　×：使用できない　－：該当なし　

（　）：類似機能に対応するサーバ管理コマンド（CUI）

注※1　J2EEアプリケーションのプロパティ設定項目の比較については，「18.1　J2EEアプリケーションのプロパティ設定の概要」を参照してください。

注※2　［サーバー・エクスプローラー］ビューの［J2EEアプリケーション］フォルダに，インポートされているJ2EEアプリケーションの状態が表示されています。［サーバー・エクスプローラー］ビューについては，「11.1.3　サーバー・エクスプローラーの構成」を参照してください。

次の機能は，Server Plug-inでは使用できません。

J2EEアプリケーションの作成

Enterprise Bean（EJB-JAR）のインポート

サーブレットとJSPのインポート

J2EEアプリケーションの新規作成

J2EEアプリケーションへのライブラリJARファイルの追加

ライブラリJARファイルの一覧の参照

J2EEアプリケーションからのライブラリJARファイルの削除

J2EEアプリケーションへの参照ライブラリの設定

トランザクション一覧の参照

16.2　ビューツールバーでのJ2EEアプリケーション設定操作

Server Plug-inでのJ2EEアプリケーション設定は，次のように操作します。

［サーバー・エクスプローラー］ビューに表示されたツリー項目（ノード）を選択します。
J2EEアプリケーション設定操作で選択するノードを次に示します。

［J2EEアプリケーション］フォルダ

［＜J2EEアプリケーション名＞］

ビューツールバーで操作を指定します。

［サーバー・エクスプローラー］ビューの構成については，「11.1.3　サーバー・エクスプローラーの構成」を参照してください。

［サーバー・エクスプローラー］ビューに表示されたノードと，そのノードが実行できる操作については，「21.1.1　サーバー・エクスプローラーの基本操作」を参照してください。

16.3　J2EEアプリケーションの状態表示

J2EEアプリケーションの稼働状態は，［サーバー・エクスプローラー］ビューのステータスアイコンで表示します。ステータスアイコンは，アイコンの左上に付加されます。J2EEアプリケーションの状態表示と付加されるステータスアイコンについては，「11.2　表示の更新」の「(3)　J2EEアプリケーションの状態表示」を参照してください。

17.　J2EEアプリケーションのインポートとエクスポート

この章では，Server Plug-inを使用したJ2EEアプリケーションのインポートとエクスポートについて説明します。

＜この章の構成＞

17.1　J2EEアプリケーションのインポート

17.2　J2EEアプリケーションのエクスポート

17.1　J2EEアプリケーションのインポート

J2EEアプリケーションをインポートします。

インポートするJ2EEアプリケーションには，次の形式があります。

アーカイブ形式のJ2EEアプリケーション

展開ディレクトリ形式のJ2EEアプリケーション

インポートするJ2EEアプリケーションの形式およびインポートを実行するときの注意事項については，サーバ管理コマンドの場合と同じです。詳細は「8.1　J2EEアプリケーションのインポート」を参照してください。

＜この節の構成＞

17.1.1　アーカイブ形式のJ2EEアプリケーションのインポート

17.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート

17.1.1　アーカイブ形式のJ2EEアプリケーションのインポート

アーカイブ形式のJ2EEアプリケーションをインポートします。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

アーカイブ形式のJ2EEアプリケーションをインポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEアプリケーション］フォルダを選択します。

次のどちらかの方法で，アーカイブ形式のJ2EEアプリケーションをインポートします。

ビューツールバーの［[図データ]］（インポート）をクリックします。表示されるサブメニューの［[図データ]J2EEアプリケーション（アーカイブ形式）］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]J2EEアプリケーション(アーカイブ形式)のインポート］を選択します。

インポートが実行されると，［J2EEアプリケーション（アーカイブ形式）のインポート］ダイアログが表示されます。

表示されたダイアログで，インポートするアーカイブ形式のJ2EEアプリケーションファイルを指定して，［開く］を実行します。
インポートが開始されます。

(2)　画面表示

アーカイブ形式のJ2EEアプリケーションのインポートで使用する画面については，「21.1.18　アーカイブ形式J2EEアプリケーションのインポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjimportappコマンドです。

アーカイブ形式のJ2EEアプリケーションをインポートする場合の，サーバ管理コマンドについては，「8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート」を参照してください。

17.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート

展開ディレクトリ形式のJ2EEアプリケーションをインポートします。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

展開ディレクトリ形式のJ2EEアプリケーションをインポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，［J2EEアプリケーション］フォルダを選択します。

次のどちらかの方法で，展開ディレクトリ形式のJ2EEアプリケーションをインポートします。

ビューツールバーの［[図データ]］（インポート）をクリックします。表示されるサブメニューの［[図データ]J2EEアプリケーション（展開ディレクトリー形式）］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]J2EEアプリケーション(展開ディレクトリー形式)のインポート］を選択します。

インポートが実行されると，［J2EEアプリケーション（展開ディレクトリー形式）のインポート］ダイアログが表示されます。

表示されたダイアログで，インポートするJ2EEアプリケーションのアプリケーションディレクトリパスを指定して，［開く］を実行します。
インポートが開始されます。

注意事項

J2EEアプリケーションのディレクトリに，UNC名を含むパスを指定した場合，展開ディレクトリ形式のJ2EEアプリケーションのインポートはできません。

(2)　画面表示

展開ディレクトリ形式のJ2EEアプリケーションのインポートで使用する画面については，「21.1.17　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，-aオプションを指定したcjimportappコマンドです。

展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合の，サーバ管理コマンドについては，「8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」の「(1)　アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポート」を参照してください。

17.2　J2EEアプリケーションのエクスポート

J2EEアプリケーションをエクスポートします。

注意

Windows 7またはWindows Vistaで管理者特権のないユーザが，エクスポート先に，C:¥Program Files以下のディレクトリを指定した場合の対応については，「11.4　Server Plug-inの注意事項」の「(1)　Windows 7またはWindows Vista使用時の注意事項」を参照してください。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEアプリケーションのエクスポートには，実行時情報を含める場合と実行時情報を含めない場合があります。

●実行時情報を含めて，J2EEアプリケーションをエクスポートする場合

実行時情報を含んだJ2EEアプリケーションをエクスポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，エクスポートする［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，J2EEアプリケーションをエクスポートします。

ビューツールバーの［[図データ]］（エクスポート）をクリックします。表示されるサブメニューの［[図データ]Cosminexusアプリケーション］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]Cosminexusアプリケーションのエクスポート］を選択します。

エクスポートが実行されると，［Cosminexusアプリケーションのエクスポート］ダイアログが表示されます。

エクスポートするJ2EEアプリケーション用ファイル（ZIPファイル）を指定して，［保存］を実行します。
エクスポートが開始されます。

●実行時情報を含めないで，J2EEアプリケーションをエクスポートする場合

実行時情報を含めないで，J2EEアプリケーションをエクスポートする手順を次に示します。

［サーバー・エクスプローラー］のビューで，エクスポートする［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，J2EEアプリケーションをエクスポートします。

ビューツールバーの［[図データ]］（エクスポート）をクリックします。表示されるサブメニューの［[図データ]J2EEアプリケーション］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]J2EEアプリケーションのエクスポート］を選択します。

エクスポートが実行されると，［J2EEアプリケーションのエクスポート］ダイアログが表示されます。

エクスポートするJ2EEアプリケーション用ファイル（EARファイル）を指定して，［保存］を実行します。
エクスポートが開始されます。

(2)　画面表示

●実行時情報を含めて，J2EEアプリケーションをエクスポートする場合

実行時情報を含めて，J2EEアプリケーションをエクスポートする場合，使用する画面については，「21.1.23　Cosminexusアプリケーションのエクスポート」を参照してください。

●実行時情報を含めないで，J2EEアプリケーションをエクスポートする場合

実行時情報を含めないで，J2EEアプリケーションをエクスポートする場合，使用する画面については，「21.1.26　J2EEアプリケーションのエクスポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjexportappコマンドです。

J2EEアプリケーションをエクスポートする場合の，サーバ管理コマンドについては，「8.2　J2EEアプリケーションのエクスポート」を参照してください。

18.　J2EEアプリケーションのプロパティ設定

この章では，Server Plug-inを使用したJ2EEアプリケーションのプロパティの設定方法について説明します。

＜この章の構成＞

18.1　J2EEアプリケーションのプロパティ設定の概要

18.2　Enterprise Beanのリファレンス定義

18.3　Message-driven Beanのメッセージ参照定義

18.4　トランザクション属性の定義

18.5　サーブレットとJSPのリファレンス定義

18.6　サーブレットとJSPのマッピング定義

18.7　フィルタの設定

18.8　Enterprise Beanの実行時属性の定義

18.9　サーブレットとJSPの実行時属性の定義

18.10　デフォルトの文字エンコーディングの設定

18.11　CTMのスケジューリング

18.12　起動順序の設定

18.13　サーブレットとJSPのエラー通知の設定

18.14　そのほかのプロパティの設定

18.1　J2EEアプリケーションのプロパティ設定の概要

J2EEアプリケーションのプロパティ設定とは，インポートしたJ2EEアプリケーションの属性や動作を定義することです。この節では，次の説明をします。

属性ファイル編集エディタによるJ2EEアプリケーションのプロパティ設定操作

Enterprise Beanのプロパティ設定項目

サーブレットとJSPのプロパティ設定項目

J2EEアプリケーション（共通）のプロパティ設定項目

＜この節の構成＞

(1)　属性ファイル編集エディタによるJ2EEアプリケーションのプロパティ設定操作

(2)　Enterprise Beanのプロパティ設定項目

(3)　サーブレットとJSPのプロパティ設定項目

(4)　J2EEアプリケーション（共通）のプロパティ設定項目

(1)　属性ファイル編集エディタによるJ2EEアプリケーションのプロパティ設定操作

J2EEアプリケーションのプロパティの設定は，属性ファイル編集エディタを使用します。属性ファイル編集エディタは次の方法で起動します。

［サーバー・エクスプローラー］ビューで，属性を編集する［＜J2EEアプリケーション名＞］を選択します。

プロパティ操作を実行します。

プロパティの設定操作および属性ファイル編集エディタについては，「11.3　プロパティの設定」を参照してください。

プロパティ操作が実行されると，画面のエディタエリアに，属性ファイルを編集するためのフォームページが表示されます。エディタエリアのフォームページで，プロパティを設定します。

プロパティの設定操作に対応するサーバ管理コマンドは，cjgetapppropコマンドおよびcjsetapppropコマンドです。J2EEアプリケーションのプロパティ設定のサーバ管理コマンドについては，「3.3　属性ファイルによるプロパティの設定」を参照してください。

(2)　Enterprise Beanのプロパティ設定項目

Enterprise Beanが含まれるJ2EEアプリケーションを作成する場合およびカスタマイズする場合に，必要に応じて設定してください。

サーバ管理コマンド（CUI）のプロパティ設定と比較して，Server Plug-inを使用したJ2EEアプリケーションの管理（GUI）で設定できるEnterprise Beanのプロパティ項目を次に示します。

表18-1　Enterprise Beanのプロパティ編集項目

編集項目
内容
Server Plug-inでのプロパティ設定
参照先

Enterprise Beanのリファレンス定義
J2EEアプリケーションを構成する，次のEnterprise Beanのリファレンスを定義します。

Session Bean

Entity Bean

Message-driven Bean

△
18.2

ほかのEnterprise Beanのリファレンス定義
ほかのEnterprise Beanへのリファレンスについて定義します。
○
18.2.1

メールコンフィグレーションのリファレンス定義
メールサーバへのリファレンスについて定義します。
×
－

リソースアダプタのリファレンス定義
リソースアダプタへのリファレンスについて定義します。
○
18.2.2

リソース環境のリファレンス定義
リソース環境へのリファレンスについて定義します。
○
18.2.3

Message-driven Beanのメッセージ参照定義
Message-driven BeanのConnection FactoryとDestinationを参照する個所に，実際のConnection FactoryとDestinationをマッピングします。
○
18.3

トランザクション属性の定義
トランザクション属性について定義します。
△
18.4

Entity BeanのCMP定義
Entity Beanの永続性管理をコンテナに任せる場合に定義します。
×
－

CMPの設定
単一プライマリキーまたは
複合プライマリキーを使用してEntity Beanの永続性管理をコンテナに任せる場合に定義します。
×
－

CMP1.xとデータベースのマッピング
CMP1.x Entity Beanのフィールドをデータベース上の表にマッピングします。
×
－

CMP2.xとデータベースのマッピング
CMP2.x Entity Beanのフィールドをデータベース上の表にマッピングします。
×
－

Enterprise Beanの実行時属性の定義
Enterprise Beanの実行時の動作について設定します。必要に応じて設定してください。
○
18.8

Stateful Session Beanの実行時プロパティの設定
Stateful Session Beanの実行時の動作についてのプロパティを設定します。
○
18.8.1

Stateless Session Beanの実行時プロパティの設定
Stateless Beanの実行時の動作についてのプロパティを設定します。
○
18.8.2

Entity Beanの実行時プロパティの設定
Entity Beanの実行時の動作についてのプロパティを設定します。
○
18.8.3

Message-driven Beanの実行時プロパティの設定
Message-driven Beanの実行時の動作についてのプロパティを設定します。
○
18.8.4

（凡例）

○：設定できる　△：一部設定できない　×：設定できない　－：該当なし

(3)　サーブレットとJSPのプロパティ設定項目

サーブレットおよびJSPを含むJ2EEアプリケーションを作成する場合に，必要に応じて設定してください。

サーバ管理コマンド（CUI）のプロパティ設定と比較して，Server Plug-inを使用したJ2EEアプリケーションの管理（GUI）で設定できるサーブレットとJSPのプロパティ項目を次に示します。

表18-2　サーブレットとJSPのプロパティ編集項目

編集項目
内容
Server Plug-inでのプロパティ設定
参照先

サーブレットとJSPのリファレンス定義
Enterprise Bean，リソース（データベースまたはメールサーバ）へのリファレンス（リソース参照）について定義します。
△
18.5

Enterprise Beanリファレンス定義
Enterprise Beanへのリファレンスについて定義します。
○
18.5.1

メールコンフィグレーションのリファレンスの定義
メールサーバへのリファレンスについて定義します。
×
－

リソースアダプタリファレンス定義
リソースアダプタへのリファレンスについて定義します。
○
18.5.2

リソース環境リファレンス定義
リソース環境リファレンスを定義します。
○
18.5.3

サーブレットとJSPのマッピング定義
サーブレットとJSPのマッピングを定義します。
○
18.6

フィルタの設定
フィルタを追加し，マッピングを定義します。
△
18.7

フィルタの追加
フィルタを追加します。
×
18.7.1

フィルタのマッピング定義
フィルタへのマッピングを定義します。
○
18.7.2

フィルタの削除
フィルタを削除します。
×
18.7.1

サーブレットとJSPの実行時属性の定義
サーブレットおよびJSPの実行時属性を定義します。
○
18.9

J2EEアプリケーションのコンテキストルート定義
J2EEアプリケーションのコンテキストルートを設定します。
○
18.9.1

Webアプリケーション単位での同時実行スレッド数制御の定義
WebコンテナでWebアプリケーション単位での同時実行スレッド数を制御するための定義をします。
○
18.9.2

URLグループ単位での同時実行スレッド数制御の定義
URLグループ単位での同時実行スレッド数を制御するための定義をします。
○
18.9.3

URLグループ単位の実行待ちリクエスト数の監視の定義
URLグループ単位の実行待ちリクエスト数を監視するための定義をします。
○
18.9.4

デフォルトの文字エンコーディングの設定
次の文字エンコーディングを設定します。

リクエストボディおよびクエリの文字エンコーディング

レスポンスボディの文字エンコーディング

JSPファイルの文字エンコーディング

○
18.10

サーブレットとJSPのエラー通知の設定
サーブレット，JSPでエラーが発生した場合に，J2EEアプリケーションにエラーを通知するための設定をします。
○
18.13

（凡例）

○：設定できる　△：一部設定できない　×：設定できない　－：該当なし

(4)　J2EEアプリケーション（共通）のプロパティ設定項目

J2EEアプリケーションの構成に関係なく，必要に応じて設定してください。

サーバ管理コマンド（CUI）のプロパティ設定と比較して，Server Plug-inを使用したJ2EEアプリケーションの管理（GUI）で設定できるJ2EEアプリケーション（共通）のプロパティ項目を次に示します。

表18-3　J2EEアプリケーション（共通）のプロパティ編集項目

編集項目
内容
Server Plug-inでのプロパティ設定
参照先

JNDI名前空間に登録される名称の参照と変更
J2EEアプリケーションのJNDI名前空間への登録名を参照して，必要に応じて別名を付与します。
×
－

J2EEアプリケーション名の参照
J2EEアプリケーション名を参照するための設定をします。
×
－

Enterprise Bean名の参照と変更
Enterprise Bean名を参照するための設定およびEnterprise Bean名を変更します。
×
－

CTMのスケジューリング
CTMを利用してキューのスケジューリングをするかどうかと，スケジューリング方法について設定します。
○
18.11

J2EEアプリケーション単位のスケジューリング
J2EEアプリケーション単位のCTMとの連携についての設定をします。
○
18.11.1

Stateless Session Bean単位のスケジューリング
Stateless Session Bean単位のスケジューリングの設定をします。
○
18.11.2

起動順序の設定
J2EEアプリケーションの起動順序，およびJ2EEアプリケーションに含まれるEnterprise Bean（EJB-JAR）やサーブレットまたはJSP（WAR）の起動順序を設定します。
○
18.12

J2EEアプリケーションの起動順序の設定
J2EEアプリケーションの起動順序を設定します。
○
18.12.1

Enterprise Beanの起動順序の設定
J2EEアプリケーションに含まれるEnterprise Bean（EJB-JAR）の起動順序を設定します。
○
18.12.2

サーブレットとJSPの起動順序の設定
J2EEアプリケーションに含まれるサーブレットまたはJSP（WAR）の起動順序を設定します。
○
18.12.3

セキュリティロールの設定
セキュリティロールを使用したユーザ管理をする場合に必要な設定です。
ユーザとロールの登録と対応づけができます。
×
－

ユーザの設定
ユーザを登録します。ロールとの対応づけもできます。
×
－

ロールの設定
ロールを登録します。ユーザとの対応づけもできます。
×
－

セキュリティロールのリファレンス定義
セキュリティロールへのリファレンスについて定義します。
×
－

Enterprise Beanのセキュリティロールリファレンスの定義
セキュリティロールを参照している個所に，実際にJ2EEサーバが管理しているセキュリティロールをマッピングします。
×
－

サーブレットとJSPのセキュリティロールリファレンスの定義
セキュリティロールへのリファレンスについて定義します。
×
－

セキュリティの定義（メソッドパーミッション）
セキュリティロールによるアクセス権を設定する場合のメソッドのパーミッションを定義します。また，すべてのユーザに対してアクセス権限を設定する場合のメソッドのパーミッションを定義します。
×
－

セキュリティの定義（セキュリティアイデンティティ）
セキュリティの情報であるセキュリティアイデンティティとしてUseCallerIdentityまたはRun asを設定します。
×
－

Enterprise Beanのセキュリティアイデンティティ
J2EEアプリケーション内で参照しているセキュリティアイデンティティ情報に，J2EEサーバが実際に管理しているユーザIDをマッピングします。
×
－

サーブレットとJSPのセキュリティアイデンティティ
セキュリティアイデンティティを定義します。
×
－

（凡例）　○：設定できる　×：設定できない　－：該当なし

18.2　Enterprise Beanのリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanのリファレンス（リソース参照）を定義します。Enterprise Beanには，次の種類があります。

Session Bean

Entity Bean

Message-driven Bean

それぞれのEnterprise Beanには，次に示すリファレンスがあります。

Enterprise Beanリファレンス
ほかのEnterprise Bean呼び出しのための参照です。

リソースリファレンス
データベースへの参照です。リソースアダプタリファレンス，およびリソース環境リファレンスがあります。

＜この節の構成＞

18.2.1　ほかのEnterprise Beanのリファレンス定義

18.2.2　リソースアダプタのリファレンス定義

18.2.3　リソース環境のリファレンス定義

18.2.1　ほかのEnterprise Beanのリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanが，ほかのEnterprise Beanを呼び出している場合，リファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティ設定

(1)　手順

ほかのEnterprise Beanのリファレンス定義を設定する手順を次に示します。

参照するEnterprise Beanのアクセスタイプには，次の2種類があります。

リモートインタフェース

ローカルインタフェース

●リモートインタフェースの場合

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，J2EEアプリケーションを構成するEnterprise Beanの種類に対応する属性を選択します。
Enterprise Beanの種類に対応する属性を次に示します。

［＜Session Bean属性名＞］

［＜Entity Bean属性名＞］

［＜Message-driven Bean属性名＞］

選択した属性のツリーが表示されます。

ほかのEnterprise Beanのリファレンス定義を追加する場合は，上記2.で表示されたツリーで，［リモートEJBへの参照］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。リモートEJBへの参照のプロパティページが表示されます。

ほかのEnterprise Beanのリファレンス定義を変更する場合は，上記2.で表示されたツリーで，［＜リモートEJBへの参照名＞］を選択します。
リモートEJBへの参照のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

●ローカルインタフェースの場合

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，J2EEアプリケーションを構成するEnterprise Beanの種類に対応する属性を選択します。
Enterprise Beanの種類に対応する属性を次に示します。

［＜Session Bean属性名＞］

［＜Entity Bean属性名＞］

［＜Message-driven Bean属性名＞］

選択した属性のツリーが表示されます。

ほかのEnterprise Beanのリファレンス定義を追加する場合は，上記2.で表示されたツリーで，［ローカルEJBへの参照］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。ローカルEJBへの参照のプロパティページが表示されます。

ほかのEnterprise Beanのリファレンス定義を変更する場合は，上記2.で表示されたツリーで，［＜ローカルEJBへの参照名＞］を選択します。
ローカルEJBへの参照のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

●リモートEJBへの参照の場合

リモートEJBへの参照のプロパティページに表示された項目を設定します。リモートEJBへの参照のプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(6)　リモートEJBへの参照のプロパティページ」を参照してください。

●ローカルEJBへの参照の場合

ローカルEJBへの参照のプロパティページに表示された項目を設定します。ローカルEJBへの参照のプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(8)　ローカルEJBへの参照のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティ設定

対応するサーバ管理コマンドでの，ほかのEnterprise Beanのリファレンス定義については，「9.3.1　ほかのEnterprise Beanのリファレンス定義」を参照してください。

18.2.2　リソースアダプタのリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanが，リソースアダプタを参照している場合，リファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティ設定

(1)　手順

リソースアダプタのリファレンス定義を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，J2EEアプリケーションを構成するEnterprise Beanの種類に対応する属性を選択します。
Enterprise Beanの種類に対応する属性を次に示します。

［＜Session Bean属性名＞］

［＜Entity Bean属性名＞］

［＜Message-driven Bean属性名＞］

選択した属性のツリーが表示されます。

リソースアダプタのリファレンス定義を追加する場合は，上記2.で表示されたツリーで，［リソース参照］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。リソース参照のプロパティページが表示されます。

リソースアダプタのリファレンス定義を変更する場合は，上記2.で表示されたツリーで，［＜リソース参照名＞］を選択します。
［リソース参照］ページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

［リソース参照］ページに表示された項目を設定します。［リソース参照］ページについては，「21.6.2　Session Bean属性設定ページ」の「(10)　リソース参照のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティ設定

対応するサーバ管理コマンドでの，リソースアダプタのリファレンス定義については，「9.3.3　リソースアダプタのリファレンス定義」を参照してください。

18.2.3　リソース環境のリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanのリソース環境のリファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

リソース環境のリファレンス定義を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，J2EEアプリケーションを構成するEnterprise Beanの種類に対応する属性を選択します。
Enterprise Beanの種類に対応する属性を次に示します。

［＜Session Bean属性名＞］

［＜Entity Bean属性名＞］

［＜Message-driven Bean属性名＞］

選択した属性のツリーが表示されます。

リソース環境のリファレンス定義を追加する場合は，上記2.で表示されたツリーで，［リソース環境変数］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。［リソース環境変数］のプロパティページが表示されます。

リソース環境のリファレンス定義を変更する場合は，上記2.で表示されたツリーで，［＜リソース環境変数名＞］を選択します。
リソース環境変数のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

リソース環境のリファレンス定義にリンク先キューを追加する場合，上記2.で表示されたツリーで，［＜リソース環境変数名＞］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。［リンク先キュー］のプロパティページが表示されます。

リソース環境のリファレンス定義のリンク先キューを変更する場合，上記2.で表示されたツリーで，［＜リンク先キュー名＞］を選択します。
リンク先キューのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

リソース環境変数のプロパティページおよびリンク先キューのプロパティページに表示された項目を設定します。

リソース環境変数のプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(12)　リソース環境変数のプロパティページ」を参照してください。

リンク先キューのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(13)　リンク先キューのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，リソース環境のリファレンス定義については，「9.3.4　リソース環境のリファレンス定義」を参照してください。

18.3　Message-driven Beanのメッセージ参照定義

Message-driven Beanのメッセージ参照を定義します。

＜この節の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Message-driven Beanのメッセージ参照定義を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，［＜Message-driven Bean属性名＞］を選択します。
Message-driven Bean属性ツリーが表示されます。

Message-driven Beanのメッセージ参照定義を，新規に追加する場合は，上記2.で表示されたツリーで，［＜Message-driven Bean属性名＞］を選択して，右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］ - ［メッセージ参照］を選択します。メッセージ参照のプロパティページが表示されます。

Message-driven Beanのメッセージ参照定義を変更する場合，上記2.で表示されたツリーで，［メッセージ参照］を選択します。
メッセージ参照のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

メッセージ参照のプロパティページに表示された項目を設定します。メッセージ参照ページについては，「21.8.2　Message-driven Bean属性設定ページ」の「(6)　メッセージ参照のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，Message-driven Beanのメッセージ参照定義については，「9.4　Message-driven Beanのメッセージ参照定義」を参照してください。

18.4　トランザクション属性の定義

コンテナのトランザクション属性のトランザクション種別を定義します。

＜この節の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

コンテナのトランザクション種別を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，J2EEアプリケーションを構成するEnterprise Beanの種類に対応する属性を選択します。
Enterprise Beanの種類に対応する属性を次に示します。

［＜Session Bean属性名＞］

［＜Entity Bean属性名＞］

［＜Message-driven Bean属性名＞］

選択した属性のツリーが表示されます。

トランザクションコンテナのトランザクション属性を追加する場合は，上記2.で表示されたツリーで，［コンテナー・トランザクション］を右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。コンテナトランザクションのプロパティページが表示されます。

トランザクションコンテナのトランザクション属性を変更する場合は，上記2.で表示されたツリーで，［＜コンテナトランザクション名＞］を選択します。
コンテナトランザクションのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

コンテナトランザクションのプロパティページに表示された項目を設定します。コンテナトランザクションのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(16)　コンテナトランザクションのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，トランザクション属性の定義については，「9.5　トランザクション属性の定義」を参照してください。

18.5　サーブレットとJSPのリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）のリファレンス（リソース参照）を定義します。次に示すリファレンスがあります。

Enterprise Beanリファレンス
Enterprise Bean呼び出しのための参照です。

リソースリファレンス
データベースへの参照です。リソースアダプタリファレンス，およびリソース環境リファレンスがあります。

＜この節の構成＞

18.5.1　Enterprise Beanリファレンス定義

18.5.2　リソースアダプタリファレンス定義

18.5.3　リソース環境リファレンス定義

18.5.1　Enterprise Beanリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）がEnterprise Beanを呼び出している場合，リファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Enterprise Beanへの参照定義を設定する手順を次に示します。

参照するEnterprise Beanのアクセスタイプには，次の2種類があります。

リモートインタフェース

ローカルインタフェース

●リモートインタフェースの場合

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

［WAR］フォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

Enterprise Beanのリファレンス定義を追加する場合は，上記2.で表示されたツリーで，［リモートEJBへの参照］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。リモートEJBへの参照のプロパティページが表示されます。

Enterprise Beanのリファレンス定義を変更する場合は，上記2.で表示されたツリーで，［＜リモートEJBへの参照名＞］を選択します。
リモートEJBへの参照のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

●ローカルインタフェースの場合

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

［WAR］フォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

Enterprise Beanのリファレンス定義を追加する場合は，上記2.で表示されたツリーで，［ローカルEJBへの参照］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。ローカルEJBへの参照のプロパティページが表示されます。

Enterprise Beanのリファレンス定義を変更する場合は，上記2.で表示されたツリーで，［＜ローカルEJBへの参照名＞］を選択します。
ローカルEJBへの参照のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

●リモートEJBへの参照の場合

リモートEJBへの参照のプロパティページに表示された項目を設定します。リモートEJBへの参照のプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(6)　リモートEJBへの参照のプロパティページ」を参照してください。

●ローカルEJBへの参照の場合

ローカルEJBへの参照のプロパティページに表示された項目を設定します。ローカルEJBへの参照のプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(8)　ローカルEJBへの参照のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，Enterprise Beanのリファレンス定義については，「9.7.1　Enterprise Beanのリファレンス定義」を参照してください。

18.5.2　リソースアダプタリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）が，リソースアダプタを参照している場合，リファレンスを定義するためのプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

リソースアダプタの参照定義を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

WARフォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

リソースアダプタのリファレンス定義を追加する場合は，上記2.で表示されたツリーで，［リソースの参照］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。リソースの参照のプロパティページが表示されます。

リソースアダプタのリファレンス定義を変更する場合は，上記2.で表示されたツリーで，［＜リソースの参照名＞］を選択します。
リソースの参照のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

リソースの参照のプロパティページに表示された項目を設定します。リソースの参照の参照ページについては，「21.6.2　Session Bean属性設定ページ」の「(10)　リソース参照のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，リソースアダプタのリファレンス定義については，「9.7.3　リソースアダプタのリファレンス定義」を参照してください。

18.5.3　リソース環境リファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）のリソース環境のリファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

リソース環境のリファレンス定義を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

WARフォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

リソース環境のリファレンス定義を追加する場合は，上記2.で表示されたツリーで，［リソース環境変数］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。リソース環境変数のプロパティページが表示されます。

リソース環境のリファレンス定義を変更する場合は，上記2.で表示されたツリーで，［＜リソース環境変数名＞］を選択します。
リソース環境変数のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

リソース環境のリファレンス定義にリンク先キューを追加する場合，上記2.で表示されたツリーで，［＜リソース環境変数名＞］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。［リンク先キュー］のプロパティページが表示されます。

リソース環境のリファレンス定義のリンク先キューを変更する場合，上記2.で表示されたツリーで，［＜リンク先キュー名＞］を選択します。
リンク先キューのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

リソース環境変数のプロパティページおよびリンク先キューのプロパティページに表示された項目を設定します。

リソース環境変数のプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(12)　リソース環境変数のプロパティページ」を参照してください。

リンク先キューのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(13)　リンク先キューのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，リソースアダプタのリファレンス定義については，「9.7.4　リソース環境のリファレンス定義」を参照してください。

18.6　サーブレットとJSPのマッピング定義

サーブレットおよびJSPのマッピングを定義します。

＜この節の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

サーブレットおよびJSPのマッピング定義を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

WARフォームページで，［＜サーブレット属性名＞］を選択します。
サーブレット属性ツリーが表示されます。

サーブレットおよびJSPのマッピング定義を追加する場合，上記2.で表示されたツリーで，［URLパターン］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。URLパターンのプロパティページが表示されます。

サーブレットおよびJSPのマッピング定義を削除する場合，上記2.で表示されたツリーで，［URLパターン］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［削除］を選択します。

サーブレットおよびJSPのマッピング定義を変更する場合，上記2.で表示されたツリーで，［＜URLパターン名＞］を選択します。
URLパターンのプロパティページが表示されます。

サーブレットおよびJSPのマッピング定義を追加および変更する場合，表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

URLパターンのプロパティページに表示された項目を設定します。URLパターンのプロパティページについては，「21.11.2　サーブレット属性設定ページ」の「(5)　URLパターンのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，サーブレットとJSPのマッピング定義については，「9.8　サーブレットとJSPのマッピング定義」を参照してください。

18.7　フィルタの設定

フィルタの設定方法について説明します。フィルタを設定するには，フィルタをWARファイルに追加して，マッピングを定義します。

＜この節の構成＞

18.7.1　フィルタの追加と削除

18.7.2　フィルタのマッピング

18.7.1　フィルタの追加と削除

フィルタの作成および削除は，サーバ管理コマンドで実行します。フィルタの作成については，「9.9.1　フィルタの追加」を参照してください。フィルタの削除については，「9.9.3　フィルタの削除」を参照してください。

18.7.2　フィルタのマッピング

フィルタの追加後，フィルタのマッピングを定義します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

フィルタのマッピング定義を設定する手順を，次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
［WAR］フォームページが表示されます。

WARフォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

フィルタマッピングを追加する場合は，上記2で表示されたツリーで，［フィルター・マッピング］をマウスで右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］ - ［フィルターマッピング(URLパターン)］または［追加］ - [フィルターマッピング(サーブレット名)]を選択します。フィルタマッピングのプロパティページが表示されます。

フィルタマッピングを変更する場合は，上記2.で表示されたツリーで，［＜フィルタ名＞］を選択します。
フィルタのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

フィルタマッピングのプロパティページに表示された項目を設定します。フィルタマッピングのプロパティページについては，「21.9.2　WAR属性設定ページ」の「(6)　フィルタマッピング（URLパターン）のプロパティページ」または「(7)　フィルタマッピング（サーブレット名）のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，フィルタのマッピング定義については，「9.9.2　フィルタのマッピング定義」を参照してください。

18.8　Enterprise Beanの実行時属性の定義

次に示すEnterprise Beanの実行時属性を定義します。

Stateful Session Bean

Stateless Session Bean

Entity Bean

Message-driven Bean

＜この節の構成＞

18.8.1　Stateful Session Beanの実行時プロパティの設定

18.8.2　Stateless Session Beanの実行時プロパティの設定

18.8.3　Entity Beanの実行時プロパティの設定

18.8.4　Message-driven Beanの実行時プロパティの設定

18.8.1　Stateful Session Beanの実行時プロパティの設定

アプリケーションを構成する個々のStateful Session Beanに対して，アプリケーション実行時のプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Stateful Session Beanの実行時のプロパティを設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，［＜Session Bean属性名＞］を選択します。
Session Bean属性ツリーが表示されます。

上記2.で表示されたツリーで，［ランタイム］を選択します。
ランタイムのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

上記2.で表示されたツリーで，［ランタイム］下の［ステートフル・セッション・ビーン］を選択します。
Stateful Session Beanのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

ランタイムのプロパティページおよびStateful Session Beanのプロパティページに表示された項目を設定します。

ランタイムのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(21)　ランタイムのプロパティページ」を参照してください。

Stateful Session Beanのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(23)　Stateful Session Beanのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでのStateful Session Beanの実行時プロパティの設定については，「9.10.1　Stateful Session Beanの実行時プロパティの設定」を参照してください。

18.8.2　Stateless Session Beanの実行時プロパティの設定

アプリケーションを構成する個々のStateless Session Beanに対して，アプリケーション実行時のプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Stateless Session Beanの実行時のプロパティを設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，［＜Session Bean属性名＞］を選択します。
Session Bean属性ツリーが表示されます。

上記2.で表示されたツリーで，［ランタイム］を選択します。
ランタイムのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

上記2.で表示されたツリーで，［ランタイム］下の［ステートレス・セッション・ビーン］を選択します。
Stateless Session Beanのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

ランタイムのプロパティページおよびStateless Session Beanのプロパティページに表示された項目を設定します。

ランタイムのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(21)　ランタイムのプロパティページ」を参照してください。

Stateless Session Beanのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(22)　Stateless Session Beanのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでのStateless Session Beanの実行時プロパティの設定については，「9.10.2　Stateless Session Beanの実行時プロパティの設定」を参照してください。

18.8.3　Entity Beanの実行時プロパティの設定

アプリケーションを構成する個々のEntity Beanに対して，アプリケーション実行時のプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Entity Beanの実行時のプロパティを設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，［＜Entity Bean属性名＞］を選択します。
Entity Bean属性ツリーが表示されます。

上記2.で表示されたツリーで，［ランタイム］を選択します。
ランタイムのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

ランタイムのプロパティページに表示された項目を設定します。ランタイムのプロパティページについては，「21.7.2　Entity Bean属性設定ページ」の「(2)　ランタイムのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，Entity Beanの実行時プロパティの設定については，「9.10.3　Entity Beanの実行時プロパティの設定」を参照してください。

18.8.4　Message-driven Beanの実行時プロパティの設定

アプリケーションを構成する個々のMessage-driven Beanに対して，アプリケーション実行時のプロパティを設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Message-Driven Beanの実行時のプロパティを設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，［＜Message-driven Bean属性名＞］を選択します。
Message-driven Bean属性ツリーが表示されます。

上記2.で表示されたツリーで，［ランタイム］を選択します。
ランタイムのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

ランタイムのプロパティページに表示された項目を設定します。ランタイムのプロパティページについては，「21.8.2　Message-driven Bean属性設定ページ」の「(7)　ランタイムのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，Message-driven Beanの実行時プロパティの設定については，「9.10.4　Message-driven Beanの実行時プロパティの設定」を参照してください。

18.9　サーブレットとJSPの実行時属性の定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）の実行時属性を定義します。次に示す定義があります。

J2EEアプリケーションのコンテキストルートの定義

Webアプリケーション単位での同時実行スレッド数制御の定義

URLグループ単位での同時実行スレッド数制御の定義

URLグループ単位の実行待ちリクエストの監視の定義

それぞれの定義で設定するプロパティ項目を次に示します。

＜この節の構成＞

18.9.1　J2EEアプリケーションのコンテキストルート定義

18.9.2　Webアプリケーション単位での同時実行スレッド数制御の定義

18.9.3　URLグループ単位での同時実行スレッド数制御の定義

18.9.4　URLグループ単位の実行待ちリクエスト数の監視の定義

18.9.1　J2EEアプリケーションのコンテキストルート定義

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

J2EEアプリケーションのコンテキストルート定義を設定します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

WARフォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

上記2.で表示されたツリーで，［＜WAR属性名＞］を選択します。
WAR属性のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

WAR属性のプロパティページに表示された項目を設定します。WAR属性のプロパティページについては，「21.9.2　WAR属性設定ページ」の「(1)　WARのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでのJ2EEアプリケーションのコンテキストルート定義については，「9.11.1　J2EEアプリケーションのコンテキストルート定義」を参照してください。

18.9.2　Webアプリケーション単位での同時実行スレッド数制御の定義

Webコンテナで同時実行スレッド数を制御するための定義をします。

なお，Webアプリケーション単位での同時実行スレッド数制御を有効にするためには，J2EEサーバ用のusrconf.propertiesファイルのwebserver.container.thread_control.enabledキーに「true」を指定してください。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Webコンテナで同時実行スレッド数を制御するための定義を，設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

WARフォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

スレッド数制御情報を追加する場合は，上記2.で表示されたツリーで，［＜WAR属性名＞］を右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。スレッド数制御のプロパティページが表示されます。

スレッド数制御情報を変更する場合は，上記2.で表示されたツリーで，［スレッド数制御］を選択します。
スレッド数制御のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

スレッド数制御のプロパティページに表示された項目を設定します。スレッド数制御のプロパティページについては，「21.9.2　WAR属性設定ページ」の「(55)　スレッド数制御のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，Webアプリケーション単位での同時実行スレッド数制御の定義については，「9.11.2　Webアプリケーション単位での同時実行スレッド数制御の定義」を参照してください。

18.9.3　URLグループ単位での同時実行スレッド数制御の定義

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

URLグループ単位での同時実行スレッド数制御を有効にするためは，Webアプリケーション単位での同時実行スレッド数制御の定義を設定してください。Webアプリケーション単位での同時実行スレッド数制御については，「18.9.2　Webアプリケーション単位での同時実行スレッド数制御の定義」を参照してください。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

URLグループ単位での同時実行スレッド数を制御するための設定手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

WARフォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

URLグループ単位での同時実行スレッド数を制御する情報を，スレッド情報に新規に追加する場合は，上記2.で表示されたツリーで，［スレッド数制御］を右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。URLグループのスレッド数制御のプロパティページが表示されます。

すでにあるスレッド情報に，URLグループ単位での同時実行スレッド数を制御する情報を追加する場合は，上記2.で表示されたツリーで，［URLグループのスレッド数制御］を右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。URLグループのスレッド数制御のプロパティページが表示されます。

URLグループ単位での同時実行スレッド数を制御する情報を変更する場合は，上記2.で表示されたツリーで，［＜URLグループのスレッド数制御定義名＞］を選択します。
URLグループのスレッド数制御のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

URLグループのスレッド数制御のプロパティページに表示された項目を設定します。URLグループのスレッド数制御のプロパティページについては，「21.9.2　WAR属性設定ページ」の「(57)　URLグループのスレッド数制御のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでのURLグループ単位での同時実行スレッド数制御の定義については，「9.11.3　URLグループ単位での同時実行スレッド数制御の定義」を参照してください。

18.9.4　URLグループ単位の実行待ちリクエスト数の監視の定義

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

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

URLグループ単位の実行待ちリクエスト数を監視するための定義を，設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

WARフォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

［＜URLグループのスレッド数制御定義名＞］，［状態モニター］の順で選択して，展開されたツリーで，［実行待ちリクエスト数の監視］を選択します。
実行待ちリクエスト数の監視のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

実行待ちリクエスト数の監視のプロパティページに表示された項目を設定します。［実行待ちリクエスト数の監視］ページについては，「21.9.2　WAR属性設定ページ」の「(60)　実行待ちリクエスト数の監視のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，URLグループ単位の実行待ちリクエスト数の監視の定義については，「9.11.4　URLグループ単位の実行待ちリクエスト数の監視の定義」を参照してください。

18.10　デフォルトの文字エンコーディングの設定

Webアプリケーション単位にデフォルトの文字エンコーディングを設定します。

次の文字エンコーディングについて，デフォルトのエンコーディングが設定できます。

リクエストボディおよびクエリの文字エンコーディング

レスポンスボディの文字エンコーディング

JSPファイルの文字エンコーディング

＜この節の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

デフォルトの文字エンコーディングを設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WARフォームページが表示されます。

WARフォームページで，［＜WAR属性名＞］を選択します。
WAR属性ツリーが表示されます。

デフォルトの文字エンコーディングを追加する場合は，上記2.で表示されたツリーで，［＜WAR属性名＞］を右クリックします。
コンテキストメニューが表示されます。コンテキストメニューの［追加］で，次の文字エンコーディングのどれかを選択します。

リクエストボディおよびクエリの文字エンコーディング：［HTTPリクエスト］

レスポンスボディの文字エンコーディング：［HTTPレスポンス］

JSPファイルの文字エンコーディング：［JSP］

選択した文字エンコーディングのプロパティページが表示されます。

デフォルトの文字エンコーディングを変更する場合は，上記2.で表示されたツリーで，次のどれかを選択します。

リクエストボディおよびクエリの文字エンコーディング：［HTTPリクエスト］

レスポンスボディの文字エンコーディング：［HTTPレスポンス］

JSPファイルの文字エンコーディング：［JSP］

選択した文字エンコーディングのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

選択した文字エンコーディングのプロパティページに表示された項目を設定します。

選択した文字エンコーディングのプロパティページについては，「21.9.2　WAR属性設定ページ」の，次のページを参照してください。

リクエストボディおよびクエリの文字エンコーディング
「(61)　HTTPリクエストのプロパティページ」

レスポンスボディの文字エンコーディング
「(62)　HTTPレスポンスのプロパティページ」

JSPファイルの文字エンコーディング
「(63)　JSPのプロパティページ」

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，デフォルトの文字エンコーディングについては，「9.12　デフォルトの文字エンコーディングの設定」を参照してください。

18.11　CTMのスケジューリング

CTMを利用する場合の，スケジューリングについて設定します。CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus アプリケーションサーバ 概説」の「2.3.1　製品と構成ソフトウェアの対応」を参照してください。

次の手順で，CTMのスケジューリングを設定します。

アプリケーション単位のスケジューリングを設定します。

スケジューリングの対象にしたいStateless Session Beanのスケジューリングを設定します。

＜この節の構成＞

18.11.1　J2EEアプリケーション単位のスケジューリング

18.11.2　Stateless Session Bean単位のスケジューリング

18.11.1　J2EEアプリケーション単位のスケジューリング

J2EEアプリケーション単位のCTMとの連携にかかわる設定をします。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

J2EEアプリケーション単位のCTMとの連携にかかわる設定の手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［アプリケーション属性］タブを選択します。
アプリケーション属性フォームページに，アプリケーション属性のツリーが表示されます。

アプリケーション属性にCTM連携を新規に設定する場合，＜アプリケーション属性名＞を右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。CTM連携のプロパティページが表示されます。

すでに設定したCTM連携情報を変更する場合，上記1.で表示されたツリーで［CTM連携］を選択します。
CTM連携のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

CTM連携のプロパティページに表示された項目を設定します。CTM連携のプロパティページについては，「21.4.2　アプリケーション属性設定ページ」の「(4)　CTM連携のプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，J2EEアプリケーション単位のスケジューリングについては，「9.14.1　J2EEアプリケーション単位のスケジューリング」を参照してください。

18.11.2　Stateless Session Bean単位のスケジューリング

CTMによるスケジューリングの対象に設定したJ2EEアプリケーションに含まれているStateless Session BeanをCTMによるスケジューリングの対象にする場合，Stateless Session Bean単位のスケジューリングの設定をします。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Stateless Session Bean単位のCTMとの連携にかかわる設定の手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，［＜Session Bean属性名＞］を選択します。
Session Bean属性ツリーが表示されます。

ランタイム属性にCTM連携情報を新規に設定する場合，［ランタイム］を右クリックします。
コンテキストメニューが表示されます。コンテキストメニューで［追加］を選択します。CTM連携のプロパティページが表示されます。

すでに設定したCTM連携情報を変更する場合，上記2.で表示されたツリーで，［ランタイム］，［CTM連携］の順で選択します。
CTM連携のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

CTM連携のプロパティページに表示された項目を設定します。CTM連携のプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(24)　CTM連携のプロパティページ」を参照してください。

また，Stateless Session Bean単位でCTMを利用するかどうかの設定は，実行時のプロパティで設定します。Stateless Session Beanの実行時プロパティの設定については，「18.8.2　Stateless Session Beanの実行時プロパティの設定」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，Stateless Session Bean単位のスケジューリングについては，「9.14.2　Stateless Session Bean単位のスケジューリング」を参照してください。

18.12　起動順序の設定

J2EEアプリケーションの起動順序，およびJ2EEアプリケーションに含まれるEnterprise BeanおよびWARの起動順序を設定します。

＜この節の構成＞

18.12.1　J2EEアプリケーションの起動順序の設定

18.12.2　Enterprise Beanの起動順序の設定

18.12.3　サーブレットとJSPの起動順序の設定

18.12.1　J2EEアプリケーションの起動順序の設定

J2EEアプリケーションの起動順序を設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

J2EEアプリケーションの起動順序を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［アプリケーション属性］タブを選択します。
アプリケーション属性フォームページが表示されます。

アプリケーション属性フォームページで，［＜アプリケーション属性名＞］を選択します。
アプリケーション属性のプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

アプリケーション属性ページに表示された項目を設定します。アプリケーション属性ページについては，「21.4.2　アプリケーション属性設定ページ」の「(1)　アプリケーションのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，J2EEアプリケーションの起動順序の設定については，「9.15.1　J2EEアプリケーションの起動順序の設定」を参照してください。

18.12.2　Enterprise Beanの起動順序の設定

Enterprise Beanの起動順序を設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

Enterprise Beanの起動順序を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［EJB-JAR］タブを選択します。
EJB-JAR属性フォームページが表示されます。

EJB-JAR属性フォームページで，J2EEアプリケーションを構成するEnterprise Beanの種類に対応する属性を選択します。
Enterprise Beanの種類に対応する属性を次に示します。

［＜Session Bean属性名＞］

［＜Entity Bean属性名＞］

［＜Message-driven Bean属性名＞］

選択したEnterprise Beanの属性のツリーが表示されます。

上記2.で表示されたツリーで，Enterprise Bean名を選択します。
Enterprise Beanのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

Enterprise Beanプロパティページに表示された項目を設定します。

Enterprise Beanの種類によって，次のEnterprise Beanのプロパティページを参照してください。

Session Beanの場合
「21.6.2　Session Bean属性設定ページ」の「(1)　Session Beanのプロパティページ」

Entity Beanの場合
「21.7.2　Entity Bean属性設定ページ」の「(1)　Entity Beanのプロパティページ」

Message-driven Beanの場合
「21.8.2　Message-driven Bean属性設定ページ」の「(1)　Message-driven Beanのプロパティページ」

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，Enterprise Beanの起動順序の設定については，「9.15.2　Enterprise Beanの起動順序の設定」を参照してください。

18.12.3　サーブレットとJSPの起動順序の設定

サーブレット，JSPが含まれるWARの起動順序を設定します。

＜この項の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

サーブレット，JSPが含まれるWARの起動順序を設定する手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WAR属性フォームページが表示されます。

WAR属性フォームページで表示されたツリーで，［＜WAR属性名＞］を選択します。
WARのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

WARのプロパティページに表示された項目を設定します。WARのプロパティページについては，「21.9.2　WAR属性設定ページ」の「(1)　WARのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，サーブレットとJSPの起動順序の設定については，「9.15.3　サーブレットとJSPの起動順序の設定」を参照してください。

18.13　サーブレットとJSPのエラー通知の設定

次のタイミングでエラーが発生した場合に，エラーを通知してJ2EEアプリケーションの開始処理を中止するかどうかを指定します。

J2EEアプリケーションの開始時にロードするように設定されている（<load-on-startup>が設定されている）サーブレットまたはJSPの初期化処理中にエラーが発生した場合

タグライブラリ解析時にエラーが発生した場合

＜この節の構成＞

(1)　手順

(2)　プロパティ設定項目

(3)　対応するサーバ管理コマンドでのプロパティの設定

(1)　手順

サーブレット，JSPが含まれるWARのエラー通知の設定手順を次に示します。

エディタエリアに表示されている，アプリケーション統合属性（＜J2EEアプリケーション名＞）の［WAR］タブを選択します。
WAR属性フォームページが表示されます。

WAR属性フォームページで表示されたツリーで，［＜WAR属性名＞］を選択します。
WARのプロパティページが表示されます。

表示されたプロパティページで，(2)のプロパティ項目を設定します。

(2)　プロパティ設定項目

WARのプロパティページに表示された項目を設定します。WARのプロパティページについては，「21.9.2　WAR属性設定ページ」の「(1)　WARのプロパティページ」を参照してください。

(3)　対応するサーバ管理コマンドでのプロパティの設定

対応するサーバ管理コマンドでの，サーブレットとJSPのエラー通知の設定については，「9.16　サーブレットとJSPのエラー通知の設定」を参照してください。

18.14　そのほかのプロパティの設定

J2EEアプリケーションの作成およびカスタマイズで設定する，そのほかのプロパティ項目については，「21.3　J2EEアプリケーションの属性編集画面」を参照してください。

19.　J2EEアプリケーションの実行

この章では，Server Plug-inを使用したJ2EEアプリケーションの実行について説明します。

＜この章の構成＞

19.1　J2EEアプリケーションの実行の概要

19.2　J2EEアプリケーションの開始

19.3　J2EEアプリケーションの停止

19.4　J2EEアプリケーションの削除

19.5　J2EEアプリケーションの入れ替え

19.6　J2EEアプリケーション名の変更

19.7　RMI-IIOPスタブとインタフェースの取得

19.1　J2EEアプリケーションの実行の概要

J2EEアプリケーションとして必要なプロパティや動作の定義が終わったら，J2EEアプリケーションを実行できます。

J2EEアプリケーションの形式とJ2EEアプリケーションの実行の概要について次に示します。

表19-1　J2EEアプリケーションの実行の概要

設定項目
内容
J2EEアプリケーションの形式
参照先

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

J2EEアプリケーションの開始
J2EEアプリケーションを開始します。
○
○
19.2

J2EEアプリケーションの停止
J2EEアプリケーションを，通常停止または強制停止します。
○
○
19.3

J2EEアプリケーションの削除
J2EEアプリケーションを削除します。
○
○
19.4

J2EEアプリケーションの入れ替え
J2EEサーバ上の，次のJ2EEアプリケーションを入れ替えます。

アーカイブ形式のアプリケーション

展開ディレクトリ形式のアプリケーション

△※
△※
19.5

J2EEアプリケーション名の変更
J2EEアプリケーションの名前を変更します。
○
○
19.6

RMI-IIOPスタブとインタフェースの取得
J2EEアプリケーションのRMI-IIOPスタブおよびインタフェースを取得します。
○
○
19.7

（凡例）　○：実行できる　△：実行条件がある

注※　J2EEアプリケーションの入れ替えは，入れ替え先のJ2EEアプリケーションの形式と同じ形式のJ2EEアプリケーションを指定します。

19.2　J2EEアプリケーションの開始

J2EEアプリケーションを開始します。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEアプリケーションを開始する手順を次に示します。

［サーバー・エクスプローラー］ビューで，開始する［＜J2EEアプリケーション名＞］を選択します。

次のどれかの方法で，J2EEアプリケーションの開始を実行します。

ビューツールバーの［[図データ]］（開始）をクリックします。

ビュープルダウンメニューの［[図データ]開始］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]開始］を選択します。

J2EEアプリケーションが開始されます。

(2)　画面表示

J2EEアプリケーションの開始で使用する画面については，「21.1.4　開始」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjstartappコマンドです。

注意事項およびJ2EEアプリケーションを開始する場合のサーバ管理コマンドについては，「10.2.1　J2EEアプリケーションの開始」の「(1)　J2EEアプリケーションの通常開始」を参照してください。

19.3　J2EEアプリケーションの停止

J2EEアプリケーションを停止します。

J2EEアプリケーションの停止には，次の二つの方法があります。

J2EEアプリケーションを通常停止させる方法

J2EEアプリケーションを強制停止させる方法

＜この節の構成＞

19.3.1　J2EEアプリケーションの通常停止

19.3.2　J2EEアプリケーションの強制停止

19.3.1　J2EEアプリケーションの通常停止

J2EEアプリケーションを通常停止します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEアプリケーションを通常停止する手順を次に示します。

［サーバー・エクスプローラー］ビューで，停止する［＜J2EEアプリケーション名＞］を選択します。

次のどれかの方法で，J2EEアプリケーションの通常停止を実行します。

ビューツールバーの［[図データ]］（停止）をクリックします。

ビュープルダウンメニューの［[図データ]停止］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]停止］を選択します。

J2EEアプリケーションが停止されます。

(2)　画面表示

J2EEアプリケーションの通常停止で使用する画面については，「21.1.7　停止」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjstopappコマンドです。

注意事項およびJ2EEアプリケーションを停止する場合のサーバ管理コマンドについては，「10.2.2　J2EEアプリケーションの停止」の「(1)　J2EEアプリケーションの通常停止」を参照してください。

19.3.2　J2EEアプリケーションの強制停止

J2EEアプリケーションを強制停止します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEアプリケーションを強制停止する手順を次に示します。

［サーバー・エクスプローラー］ビューで，強制停止する［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，J2EEアプリケーションの強制停止を実行します。

ビュープルダウンメニューの［強制停止］を選択します。

右クリックで表示されるコンテキストメニューの［強制停止］を選択します。

J2EEアプリケーションが強制停止されます。

(2)　画面表示

J2EEアプリケーションの強制停止で使用する画面については，「21.1.8　強制停止」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，-forceオプションを指定したcjstopappコマンドです。

注意事項およびJ2EEアプリケーションを強制停止する場合のサーバ管理コマンドについては，「10.2.2　J2EEアプリケーションの停止」の「(2)　J2EEアプリケーションの強制停止」を参照してください。

19.4　J2EEアプリケーションの削除

J2EEアプリケーションを削除します。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEアプリケーションを削除する手順を次に示します。

［サーバー・エクスプローラー］ビューで，削除する［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，J2EEアプリケーションの削除を実行します。

ビュープルダウンメニューの［[図データ]削除］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]削除］を選択します。

J2EEアプリケーションの削除が実行されると，次のメッセージダイアログが表示されます。

J2EEアプリケーション‘＜J2EEアプリケーション名＞’を削除しますか？

J2EEアプリケーションを削除する場合は，メッセージダイアログで［はい］をクリックします。
J2EEアプリケーションが削除されます。［いいえ］をクリックすると，J2EEアプリケーションの削除は中止されます。

(2)　画面表示

J2EEアプリケーションの削除で使用する画面については，「21.1.9　削除」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjdeleteappコマンドです。

注意事項およびJ2EEアプリケーションを削除するサーバ管理コマンドについては，「10.4　J2EEアプリケーションの削除」を参照してください。

19.5　J2EEアプリケーションの入れ替え

J2EEアプリケーションを入れ替えます。

J2EEアプリケーションの入れ替えには，次の二つの場合があります。

アーカイブ形式でインポートされたJ2EEアプリケーションを入れ替える場合

展開ディレクトリ形式のJ2EEアプリケーションを再ロードする場合

入れ替えるJ2EEアプリケーションの形式および注意事項については，サーバ管理コマンドによるJ2EEアプリケーションの入れ替え（「10.6　J2EEアプリケーションの入れ替え」）を参照してください。

＜この節の構成＞

19.5.1　アーカイブ形式のJ2EEアプリケーション

19.5.2　展開ディレクトリ形式のJ2EEアプリケーション

19.5.1　アーカイブ形式のJ2EEアプリケーション

アーカイブ形式のJ2EEアプリケーションを入れ替えます。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

アーカイブ形式でインポートされたJ2EEアプリケーションを入れ替える手順を次に示します。

［サーバー・エクスプローラー］ビューで，入れ替える［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，アーカイブ形式のJ2EEアプリケーションを入れ替えます。

ビュープルダウンメニューの［入れ替え］を選択します。

右クリックで表示されるコンテキストメニューの［入れ替え］を選択します。

J2EEアプリケーションの入れ替えが実行されると，［J2EEアプリケーションの入れ替え］ダイアログが表示されます。

入れ替えるアーカイブ形式のJ2EEアプリケーションを指定して，［開く］を実行します。
アーカイブ形式のJ2EEアプリケーションの入れ替えが開始されます。

(2)　画面表示

アーカイブ形式のJ2EEアプリケーションの入れ替えで使用する画面については，「21.1.11　J2EEアプリケーションの入れ替え」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjreplaceappコマンドです。

アーカイブ形式のJ2EEアプリケーションの入れ替えで使用するサーバ管理コマンド，およびcosminexus.xmlを含むアプリケーションの入れ替えの注意事項については，「10.6.1　アーカイブ形式のアプリケーション」を参照してください。

19.5.2　展開ディレクトリ形式のJ2EEアプリケーション

展開ディレクトリ形式のJ2EEアプリケーションをリロードします。リロードする展開ディレクトリ形式のJ2EEアプリケーションが開始状態の場合に操作できます。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

展開ディレクトリ形式でインポートされたJ2EEアプリケーションをリロードする手順を次に示します。

［サーバー・エクスプローラー］ビューで，リロードする［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，展開ディレクトリ形式のJ2EEアプリケーションをリロードします。

ビュープルダウンメニューの［[図データ]リロード］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]リロード］を選択します。

展開ディレクトリ形式のJ2EEアプリケーションがリロードされます。

(2)　画面表示

展開ディレクトリ形式のJ2EEアプリケーションのリロードで使用する画面については，「21.1.10　リロード」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjreloadappコマンドです。

展開ディレクトリ形式のJ2EEアプリケーションをリロードするサーバ管理コマンド，およびcosminexus.xmlを含むアプリケーションの入れ替えの注意事項については，「10.6.2　展開ディレクトリ形式のアプリケーション」を参照してください。

19.6　J2EEアプリケーション名の変更

J2EEアプリケーションのアプリケーション名を変更します。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

J2EEアプリケーションのアプリケーション名を変更する手順を次に示します。

［サーバー・エクスプローラー］ビューで，アプリケーション名を変更する［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，J2EEアプリケーションのアプリケーション名を変更します。

ビュープルダウンメニューの［アプリケーション名の変更］を選択します。

右クリックで表示されるコンテキストメニューの［アプリケーション名の変更］を選択します。

［アプリケーション名の変更］ダイアログが表示されます。

［新しい名前］に新しいアプリケーション名を入力し，［OK］をクリックします。
アプリケーション名を変更しない場合は，［キャンセル］をクリックしてください。

(2)　画面表示

J2EEアプリケーション名の変更で使用する画面については，「21.1.12　J2EEアプリケーション名の変更」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjrenameappコマンドです。

注意事項およびJ2EEアプリケーション名を変更するサーバ管理コマンドについては，「10.7　J2EEアプリケーション名の変更」を参照してください。

19.7　RMI-IIOPスタブとインタフェースの取得

次の手順で，J2EEアプリケーションからRMI-IIOPインタフェースをエクスポートします。

［Cosminexus RMI-IIOP インターフェース］ページを表示します。

RMI-IIOPインタフェースのエクスポートを実行します。

＜この節の構成＞

19.7.1　RMI-IIOPインタフェースページの表示

19.7.2　RMI-IIOPインタフェースのエクスポートの実行

19.7.1　RMI-IIOPインタフェースページの表示

［Cosminexus RMI-IIOP インターフェース］ページを表示します。［Cosminexus RMI-IIOP インターフェース］ページは，J2EEアプリケーションのRMI-IIOPインタフェースをエクスポートするためのダイアログです。

Management Serverリモート管理機能に未接続の状態でも，［Cosminexus RMI-IIOP インタフェース］ページは表示されます。Management Serverリモート管理機能に未接続の場合，［Cosminexus RMI-IIOP インターフェース］ページが表示される前に，［Cosminexus Management Server リモート管理機能へログイン］ダイアログが表示されます。［Cosminexus Management Server リモート管理機能へログイン］ダイアログで，Management Serverリモート管理機能に接続してください。Management Serverリモート管理機能への接続については，「11.1.2　Management Serverリモート管理機能への接続」を参照してください。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

次のどちらかの方法で，［Cosminexus RMI-IIOP インターフェース］ページを表示します。

［エクスポート］ダイアログから表示

［サーバー・エクスプローラー］ビューから表示

●［エクスポート］ダイアログから表示

［エクスポート］ダイアログから［Cosminexus RMI-IIOP インターフェース］ページを表示する手順を次に示します。

メニューから［ファイル］ - ［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［エクスポート先の選択］の［Cosminexus RMI-IIOP インターフェース］を選択し，［次へ］をクリックします。
［Cosminexus RMI-IIOP インターフェース］ページが表示されます。

●［サーバー・エクスプローラー］ビューから表示

［サーバー・エクスプローラー］ビューから［Cosminexus RMI-IIOP インターフェース］ページを表示する手順を次に示します。

［サーバー・エクスプローラー］ビューで，RMI-IIOPインタフェースをエクスポートする［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，［Cosminexus RMI-IIOP インターフェース］ページを表示します。

ビューツールバーの［[図データ]］（エクスポート）をクリックします。表示されるサブメニューの［[図データ]Cosminexus RMI-IIOPインターフェース］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]Cosminexus RMI-IIOPインターフェースのエクスポート］を選択します。

［Cosminexus RMI-IIOPインターフェース］ページが表示されます。

注意事項

［サーバー・エクスプローラー］ビューで，［＜J2EEアプリケーション名＞］を選択しないで，ビューツールバーの［[図データ]］（エクスポート）をクリックして表示されるサブメニューの［[図データ]Cosminexus RMI-IIOPインターフェース］を選択しても，［Cosminexus RMI-IIOP インタフェース］ページは表示されます。

(2)　画面表示

［Cosminexus RMI-IIOP インターフェース］ページの表示で使用する画面については，「21.1.24　Cosminexus RMI-IIOP インタフェースのエクスポート」の「(1)　［Cosminexus RMI-IIOP インタフェース］ページの表示」を参照してください。

(3)　対応するサーバ管理コマンド

［Cosminexus RMI-IIOP インターフェース］ページを表示する操作のため，対応するサーバ管理コマンドはありません。

19.7.2　RMI-IIOPインタフェースのエクスポートの実行

［Cosminexus RMI-IIOP インターフェース］ページで，RMI-IIOPインタフェースのエクスポートを実行します。

＜この項の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

RMI-IIOPインタフェースをエクスポートする手順を次に示します。

［エクスポート元アプリケーション］を選択します。
［サーバー・エクスプローラー］ビューのノードが表示されます。J2EEアプリケーションが表示されていない場合，J2EEサーバのノードを展開してJ2EEアプリケーションを表示してください。
RMI-IIOPインタフェースをエクスポートするJ2EEアプリケーションを選択します。

［エクスポート先］ - ［プロジェクト］または［エクスポート先］ - ［フォルダー］を指定します。
RMI-IIOPインタフェースのエクスポート先のプロジェクトまたはフォルダを入力します。
［参照］をクリックすると，［プロジェクトの参照］ダイアログまたは［フォルダの参照］ダイアログが表示されます。［プロジェクトの参照］ダイアログまたは［フォルダの参照］ダイアログで，RMI-IIOPインタフェースのエクスポート先を選択してください。

注意

Windows 7またはWindows Vistaで管理者特権のないユーザが，エクスポート先に，C:¥Program Files以下のディレクトリを指定した場合の対応については，「11.4　Server Plug-inの注意事項」の「(1)　Windows 7またはWindows Vista使用時の注意事項」を参照してください。

［終了］をクリックしてください。
［Cosminexus RMI-IIOP インターフェース］ページが閉じ，［エクスポート先］で指定したプロジェクトまたはフォルダに，RMI-IIOPインタフェースをエクスポートします。

(2)　画面表示

RMI-IIOPスタブとインタフェースの取得で使用する画面については，「21.1.24　Cosminexus RMI-IIOPインタフェースのエクスポート」の「(2)　［Cosminexus RMI-IIOP インタフェース］ページの操作」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjgetstubsjarコマンドです。

注意事項およびRMI-IIOPスタブとインタフェースを取得するサーバ管理コマンドについては，「10.8　RMI-IIOPスタブとインタフェースの取得」を参照してください。

20.　アプリケーション統合属性のインポートとエクスポート

この章では，Server Plug-inを使用したアプリケーション統合属性のインポートとエクスポートについて説明します。

＜この章の構成＞

20.1　アプリケーション統合属性のインポートとエクスポートの概要

20.2　アプリケーション統合属性のインポート

20.3　アプリケーション統合属性のエクスポート

20.1　アプリケーション統合属性のインポートとエクスポートの概要

Server Plug-inでは，J2EEアプリケーションのプロパティを設定する方法として，次の二つの方法を提供しています。

属性ファイル編集エディタのフォームページでプロパティを設定します。属性ファイル編集エディタは，Server Plug-inのプロパティ操作で起動されます。
Server Plug-inのプロパティ操作については，「11.3　プロパティの設定」を参照してください。

アプリケーション統合属性をアプリケーション統合属性ファイルに取得（エクスポート）し，プロパティ設定項目を編集します。編集したアプリケーション統合属性のファイルの値を，J2EEアプリケーションの属性に反映（インポート）します。

この章で，アプリケーション属性の取得（エクスポート）とアプリケーション属性の設定（インポート）の操作について説明します。

プロパティの設定項目については，「18.　J2EEアプリケーションのプロパティ設定」を参照してください。

20.2　アプリケーション統合属性のインポート

J2EEアプリケーションの属性を，アプリケーション統合属性ファイルの値に変更します。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

アプリケーション統合属性をインポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，アプリケーション属性ファイルの値にJ2EEアプリケーションの属性を変更する［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，アプリケーション統合属性をインポートします。

ビューツールバーの［[図データ]］（インポート）をクリックして，表示されるサブメニューの［アプリケーション統合属性］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]アプリケーション統合属性のインポート］を選択します。

アプリケーション統合属性のインポートが実行されると，［アプリケーション統合属性のインポート］ダイアログが表示されます。

インポートするアプリケーション統合属性ファイルを指定して，［開く］を実行します。
インポートが開始されます。

(2)　画面表示

アプリケーション統合属性のインポートで使用する画面については，「21.1.15　アプリケーション統合属性のインポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjsetapppropコマンドに対応します。

アプリケーション統合属性をインポートする場合の，サーバ管理コマンドについては，「3.3　属性ファイルによるプロパティの設定」を参照してください。

20.3　アプリケーション統合属性のエクスポート

J2EEアプリケーションの属性をアプリケーション統合属性ファイルに取得します。

注意

Windows 7またはWindows Vistaで管理者特権のないユーザが，エクスポート先に，C:¥Program Files以下のディレクトリを指定した場合の対応については，「11.4　Server Plug-inの注意事項」の「(1)　Windows 7またはWindows Vista使用時の注意事項」を参照してください。

＜この節の構成＞

(1)　手順

(2)　画面表示

(3)　対応するサーバ管理コマンド

(1)　手順

アプリケーション統合属性をエクスポートする手順を次に示します。

［サーバー・エクスプローラー］ビューで，アプリケーション統合属性をエクスポートする［＜J2EEアプリケーション名＞］を選択します。

次のどちらかの方法で，アプリケーション統合属性をエクスポートします。

ビューツールバーの［[図データ]］（エクスポート）をクリックします。表示されるサブメニューの［[図データ]アプリケーション統合属性］を選択します。

右クリックで表示されるコンテキストメニューの［[図データ]アプリケーション統合属性のエクスポート］を選択します。

エクスポートが実行されると，［アプリケーション統合属性のエクスポート］ダイアログが表示されます。

エクスポートするアプリケーション統合属性ファイルを指定して，［保存］を実行します。
エクスポートが開始されます。

(2)　画面表示

アプリケーション統合属性のエクスポートで使用する画面については，「21.1.21　アプリケーション統合属性のエクスポート」を参照してください。

(3)　対応するサーバ管理コマンド

対応するサーバ管理コマンドは，cjgetapppropコマンドに対応します。

アプリケーション統合属性をエクスポートする場合の，サーバ管理コマンドについては，「3.3　属性ファイルによるプロパティの設定」を参照してください。

21.　Server Plug-inで使用する画面

この章では，Server Plug-inの操作や属性の編集など，Server Plug-inで使用する画面について説明します。

＜この章の構成＞

21.1　Server Plug-inの操作で使用する画面

21.2　リソースアダプタの属性編集画面

21.3　J2EEアプリケーションの属性編集画面

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

21.5　アプリケーション統合属性ファイル（EJB-JAR属性）

21.6　アプリケーション統合属性ファイル（Session Bean属性）

21.7　アプリケーション統合属性ファイル（Entity Bean属性）

21.8　アプリケーション統合属性ファイル（Message-driven Bean属性）

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

21.10　アプリケーション統合属性ファイル（フィルタ属性）

21.11　アプリケーション統合属性ファイル（サーブレット属性）

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

21.1　Server Plug-inの操作で使用する画面

Server Plug-inでは，サーバを起動・停止したり，J2EEアプリケーションやJ2EEリソースアダプタの設定を行ったりするために，［サーバー・エクスプローラー］ビューを提供しています。［サーバー・エクスプローラー］ビューを使用して，サーバの起動・停止，J2EEアプリケーションやJ2EEリソースアダプタの起動・停止・プロパティの設定などの操作を実行します。

［サーバー・エクスプローラー］ビューの構成例を次に示します。

図21-1　［サーバー・エクスプローラー］ビューの構成例

［サーバー・エクスプローラー］ビューの構成について次に説明します。

ツリービュー

論理サーバ，J2EEアプリケーション，J2EEリソースアダプタなど，操作の対象がノードとして表示される，ツリー形式のビューです。

ツリービューに表示されるノードの種類を次に示します。なお，論理サーバは，起動する順で並べられています。それ以外のノードは，アルファベット順で並べられています。

ツリービューで表示するノードの種類

　[図データ]＜Cosminexus Management Serverリモート管理機能と接続しているホスト＞
　│
　└─[図データ]＜運用管理ドメイン名＞
　    └─[図データ]＜ホスト名＞（運用管理ドメイン内）
　        ├─[図データ]＜論理パフォーマンストレーサ名＞
　        ├─[図データ]＜論理スマートエージェント名＞
　        ├─[図データ]＜論理ネーミングサービス名＞
　        ├─[図データ]＜論理CTMドメインマネジャ名＞
　        ├─[図データ]＜論理CTM名＞
　        ├─[図データ]＜論理SFOサーバ名＞
　        ├─[図データ]＜論理J2EEサーバ名＞
　        │    ├─[図データ]［J2EEアプリケーション］
　        │    │    └─[図データ]＜J2EEアプリケーション＞
　        │    │         └─[図データ]＜J2EEリソースアダプタ＞
　        │    ├─[図データ]［J2EEリソース・アダプター］
　        │    │    └─[図データ]＜J2EEリソースアダプタ＞
　        │    └─[図データ]［J2EEリソース］
　        │          └─[図データ]［リソース・アダプター］
　        │                └─[図データ]＜リソースアダプタ＞
　        ├─[図データ]＜論理Webサーバ名＞
　        └─[図データ]＜論理ユーザサーバ名＞

表21-1　ツリービューで表示されるノード一覧

種類
説明

Management Serverリモート管理機能と接続しているホスト
Management Serverリモート管理機能に接続しているホストです。
名前は，「＜ホスト名またはIPアドレス＞：＜ポート番号＞」で表示されます。初期表示は，このノードだけが表示されています。

運用管理ドメイン
運用管理ドメイン名(デフォルトドメイン)が表示されています。

ホスト(運用管理ドメイン内)
運用管理ドメイン名に定義されたホストが表示されています。

論理パフォーマンストレーサ
論理パフォーマンストレーサ名が表示されています。

論理スマートエージェント
論理スマートエージェント名が表示されています。

論理ネーミングサービス
論理ネーミングサービス名が表示されています。

論理CTMドメインマネジャ
論理CTMドメインマネジャ名が表示されています。

論理CTM
論理CTM名が表示されています。

論理SFOサーバ
SFOサーバ名が表示されています。

論理J2EEサーバ
論理J2EEサーバ名が表示されています。

［J2EEアプリケーション］フォルダ
デプロイされたJ2EEアプリケーションをまとめるフォルダを表します。

J2EEアプリケーション
J2EEアプリケーション名が表示されています。

J2EEリソースアダプタ（J2EEアプリケーション内）
J2EEアプリケーションに含めてデプロイされるリソースアダプタ名が表示されています。

［J2EEリソース・アダプター］フォルダ
J2EEリソースアダプタをまとめるフォルダを表します。

J2EEリソースアダプタ
J2EEリソースアダプタとしてデプロイされているリソースアダプタ名が表示されています。

［J2EEリソース］フォルダ
J2EEリソースをまとめるフォルダを表します。

［リソース・アダプター］フォルダ（［J2EEリソース］フォルダ内）
J2EEリソース内のJ2EEリソースアダプタをまとめるフォルダを表します。

リソースアダプタ
J2EEリソース内のリソースアダプタ名が表示されています。

論理Webサーバ
論理Webサーバ名が表示されています。

論理ユーザサーバ
論理ユーザサーバ名が表示されています。

ビューツールバー

ツリービューで選択した対象に対して実行できる操作がアイコンで表示されるビューです。

ビュープルダウンメニュー

ツリービューで選択した対象に対して実行できる操作がプルダウンメニューで表示されるビューです。

＜この節の構成＞

21.1.1　サーバー・エクスプローラーの基本操作

21.1.2　Management Serverリモート管理機能へのログイン

21.1.3　Management Serverリモート管理機能からのログアウト

21.1.4　開始

21.1.5　アプリケーションを起動しない場合のJ2EEサーバの開始

21.1.6　論理J2EEサーバの開始オプションの設定

21.1.7　停止

21.1.8　強制停止

21.1.9　削除

21.1.10　リロード

21.1.11　J2EEアプリケーションの入れ替え

21.1.12　J2EEアプリケーション名の変更

21.1.13　表示の更新

21.1.14　プロパティの設定

21.1.15　アプリケーション統合属性のインポート

21.1.16　Connector属性のインポート

21.1.17　展開ディレクトリ形式のJ2EEアプリケーションのインポート

21.1.18　アーカイブ形式J2EEアプリケーションのインポート

21.1.19　リソースアダプタ（Connector）のインポート

21.1.20　リソースアダプタのインポート

21.1.21　アプリケーション統合属性のエクスポート

21.1.22　Connector属性のエクスポート

21.1.23　Cosminexusアプリケーションのエクスポート

21.1.24　Cosminexus RMI-IIOPインタフェースのエクスポート

21.1.25　Cosminexusリソースアダプタのエクスポート

21.1.26　J2EEアプリケーションのエクスポート

21.1.27　J2EEリソースアダプタのエクスポート

21.1.28　接続テスト

21.1.29　リソースアダプタのデプロイ

21.1.1　サーバー・エクスプローラーの基本操作

ここでは，［サーバー・エクスプローラー］ビューを使用した，操作の実行方法について説明します。［サーバー・エクスプローラー］ビューの操作は，次の手順で実行します。

［サーバー・エクスプローラー］ビューのツリービューで，操作を実行したいノードを選択します。

ツリービューで，選択したノードに，起動，停止，実行時属性の設定などの操作を実行します。
次のどれかの方法で，選択したノードに対する操作を実行します。

ビューツールバーのアイコンをクリックする

ビュープルダウンメニューでメニュー項目を選択する

ツリービューのノードを右クリックして，表示されるコンテキストメニューのメニュー項目を選択する

ビューツールバー，ビュープルダウンメニュー，および右クリックで表示されるコンテキストメニューで実行できる操作については，「(1)　実行できる操作の表示」を参照してください。

選択した処理が実行されている間は，処理状況を示すプログレスダイアログが表示されます。その間，［サーバー・エクスプローラー］ビューを使用したほかの操作は実行できません。

また，処理の実行経過は，パースペクティブウィンドウのコンソールビューにも表示されます。

＜この項の構成＞

(1)　実行できる操作の表示

(2)　ツリービューに表示されるノードと実行できる操作

(1)　実行できる操作の表示

ビューツールバー，ビュープルダウンメニュー，および右クリックで表示されるコンテキストメニューでは，実行できる操作が異なります。また，操作を実行する対象（ツリービューで，選択したノード）によっても実行できる操作が異なります。

ビューツールバー，ビュープルダウンメニュー，および右クリックで表示されるコンテキストメニューで実行できる操作の一覧を次に示します。

表21-2　ビューツールバーでできる操作

アイコン
説明

[図データ]　
Management Serverリモート管理機能と接続したり，接続を切断したりします。
次のサブメニューを選択します。

［ログイン］
Management Serverリモート管理機能に接続します。

［ログアウト］
Management Serverリモート管理機能との接続を切断します。

[図データ]　
論理サーバ，J2EEアプリケーション，J2EEリソースアダプタを開始します。

[図データ]　
論理サーバ，J2EEアプリケーション，J2EEリソースアダプタを停止します。

[図データ]　
サブメニューで選択した対象をインポートします。
サブメニューでは次の対象を選択できます。

［アプリケーション統合属性］
アプリケーション統合属性をインポートします。

［Connector属性］
Connector属性をインポートします。

［J2EEアプリケーション（展開ディレクトリ形式）］
展開ディレクトリ形式のJ2EEアプリケーションをインポートします。

［J2EEアプリケーション（アーカイブ形式）］
アーカイブ形式のJ2EEアプリケーションをインポートします。

［リソース・アダプター（Connector）］
接続先ホストにあるリソースアダプタをインポートします。

［リソース・アダプター］
Server Plug-in環境にあるリソースアダプタをインポートします。

[図データ]　
サブメニューで選択した対象をエクスポートします。
サブメニューでは次の対象を選択できます。

［アプリケーション統合属性］
アプリケーション統合属性をエクスポートします。

［Connector属性］
Connector属性をエクスポートします。

［Cosminexusアプリケーション］
実行時情報を含めてJ2EEアプリケーションをエクスポートします。

［Cosminexusリソース・アダプター］
実行時情報を含めてリソースアダプタをエクスポートします。

［J2EEアプリケーション］
実行時情報を含めないでJ2EEアプリケーションをエクスポートします。

［J2EEリソース・アダプター］
実行時情報を含めないでリソースアダプタをエクスポートします。

［Cosminexus RMI-IIOPインターフェース］
J2EEアプリケーションからRMI-IIOPインタフェースをエクスポートします。

表21-3　ビュープルダウンメニューでできる操作

メニュー | 説明
[図データ]開始 | 論理サーバ，J2EEアプリケーション，リソースアダプタを開始します。
アプリケーションを起動しないで開始 | J2EEアプリケーションを起動しないで，論理J2EEサーバを開始します。
[図データ]停止 | 論理サーバ，J2EEアプリケーション，J2EEリソースアダプタを停止します。
強制停止 | 論理サーバ，J2EEアプリケーションを強制停止します。
開始オプションの設定 | 論理J2EEサーバの起動パラメタを設定します。
[図データ]リロード | 展開ディレクトリ形式でインポートされたJ2EEアプリケーションを手動でリロードします。
入れ替え | アーカイブ形式でインポートされたJ2EEアプリケーションを入れ替えます。
アプリケーション名の変更 | J2EEアプリケーション名を変更します。
[図データ]接続テスト | J2EEリソースアダプタの接続をテストします。
[図データ]デプロイ | リソースアダプタをデプロイします。
[図データ]削除 | J2EEアプリケーション，リソースアダプタを削除します。
[図データ]表示の更新 | ［サーバー・エクスプローラー］ビューの表示を更新します。
[図データ]プロパティー | J2EEアプリケーションやリソースアダプタの属性を編集します。

表21-4　右クリックで表示されるコンテキストメニューでできる操作

種類
コンテキストメニュー
説明

Cosminexus Management Serverリモート管理機能と接続しているホスト
[図データ]ログイン
Management Serverリモート管理機能に接続します。

[図データ]ログアウト
Management Serverリモート管理機能との接続を切断します。

運用管理ドメイン
[図データ]開始
運用管理ドメイン下の論理サーバを一括起動します。

[図データ]停止
運用管理ドメイン下の論理サーバを一括停止します。

ホスト(運用管理ドメイン内)
[図データ]開始
ホスト下の論理サーバを一括起動します。

[図データ]停止
ホスト下の論理サーバを一括停止します。

論理J2EEサーバ
[図データ]開始
論理J2EEサーバを起動します。

アプリケーションを起動しないで開始
アプリケーションを起動しないで，論理J2EEサーバを起動します。

[図データ]停止
論理J2EEサーバを停止します。

強制停止
論理J2EEサーバを強制停止します。

開始オプションの設定
論理J2EEサーバの起動パラメタを設定します。

［J2EEアプリケーション］フォルダ
[図データ]J2EEアプリケーション(展開ディレクトリー形式)のインポート
展開ディレクトリ形式のJ2EEアプリケーションをインポートします。

[図データ]J2EEアプリケーション(アーカイブ形式)のインポート
アーカイブ形式のJ2EEアプリケーションをインポートします。

J2EEアプリケーション
[図データ]開始
J2EEアプリケーションを開始します。

[図データ]停止
J2EEアプリケーションを停止します。

強制停止
J2EEアプリケーションを強制停止します。

[図データ]リロード
展開ディレクトリ形式のJ2EEアプリケーションをリロードします。

入れ替え
アーカイブ形式のJ2EEアプリケーションを入れ替えます。

アプリケーション名の変更
J2EEアプリケーション名を変更します。

[図データ]削除
J2EEアプリケーションを削除します。

[図データ]アプリケーション統合属性のインポート
アプリケーション統合属性をインポートします。

[図データ]アプリケーション統合属性のエクスポート
アプリケーション統合属性をエクスポートします。

[図データ]Cosminexusアプリケーションのエクスポート
実行時情報を含めて，J2EEアプリケーションをエクスポートします。

[図データ]J2EEアプリケーションのエクスポート
実行時情報を含めないで，J2EEアプリケーションをエクスポートします。

[図データ]Cosminexus RMI-IIOPインターフェースのエクスポート
J2EEアプリケーションからRMI-IIOPインタフェースをエクスポートします。

[図データ]プロパティー
アプリケーション統合属性を設定します。

J2EEリソースアダプタ（J2EEアプリケーション内）
[図データ]接続テスト
J2EEアプリケーションに含まれるリソースアダプタの接続をテストします。

[図データ]Connector属性のインポート
J2EEアプリケーションに含まれるリソースアダプタのConnector属性をインポートします。

[図データ]Connector属性のエクスポート
J2EEアプリケーションに含まれるリソースアダプタのConnector属性をエクスポートします。

[図データ]プロパティー
J2EEアプリケーションに含まれるリソースアダプタのConnector属性を設定します。

［J2EEリソース・アダプター］フォルダ
なし
コンテキストメニューは提供されていません。

J2EEリソースアダプタ
[図データ]開始
J2EEリソースアダプタとしてデプロイされたリソースアダプタを開始します。

[図データ]停止
J2EEリソースアダプタとしてデプロイされたリソースアダプタを停止します。

[図データ]接続テスト
J2EEリソースアダプタとしてデプロイされたリソースアダプタの接続をテストします。
なお，Connector 1.5の仕様に準拠するリソースアダプタの場合は，Outboundリソースアダプタを含むときだけ，このコンテキストメニューが活性になります。

[図データ]削除
J2EEリソースアダプタとしてデプロイされたリソースアダプタを削除します。

[図データ]Connector属性のインポート
J2EEリソースアダプタとしてデプロイされたリソースアダプタのConnector属性をインポートします。

[図データ]Connector属性のエクスポート
J2EEリソースアダプタとしてデプロイされたリソースアダプタのConnector属性をエクスポートします。

[図データ]Cosminexusリソース・アダプターのエクスポート
実行時情報を含めて，デプロイされたリソースアダプタをエクスポートします。

[図データ]J2EEリソース・アダプターのエクスポート
実行時情報を含めないで，J2EEリソースアダプタとしてデプロイされたリソースアダプタをエクスポートします。

[図データ]プロパティー
J2EEリソースアダプタとしてデプロイされたリソースアダプタのConnector属性を設定します。

［J2EEリソース］フォルダ
なし
コンテキストメニューは提供されていません。

［リソース・アダプター］フォルダ（［J2EEリソース］フォルダ内）
[図データ]リソース・アダプター（Connector）のインポート
J2EEサーバ環境にあるリソースアダプタをインポートします。

[図データ]リソース・アダプターのインポート
Server Plug-in環境にあるリソースアダプタをインポートします。

リソースアダプタ
[図データ]デプロイ
リソースアダプタをJ2EEリソースアダプタとしてデプロイします。

[図データ]削除
リソースアダプタを削除します。

[図データ]Connector属性のインポート
Connector属性をインポートします。

[図データ]Connector属性のエクスポート
Connector属性エクスポートします。

[図データ]プロパティー
Connector属性を設定します。

論理J2EEサーバ以外の論理サーバ
[図データ]開始
論理サーバを起動します。

[図データ]停止
論理サーバを停止します。

強制停止
論理サーバを強制停止します。

(2)　ツリービューに表示されるノードと実行できる操作

ビューツールバー，ビュープルダウンメニュー，および右クリックで表示されるコンテキストメニューで実行できる操作は，ツリービューで選択したノード（操作の対象）によって異なります。次に示すServer Plug-inの機能別に，ツリービューに表示されるノード，および選択したノードで実行できる操作を説明します。

論理サーバの運用管理

J2EEサーバでのアプリケーション設定操作

また，どのノードも選択していない場合に実行できる操作についても説明します。

なお，処理の実行中は，［サーバー・エクスプローラ］ビューで，ほかの操作は実行できません。

(a)　論理サーバの運用管理

論理サーバのノード，および選択したノードごとに実行できる操作を次の表に示します。

表21-5　ツリービューで選択するノードの種類（論理サーバの運用管理の場合）

項番 | 種類 | 説明
1 | Management Serverリモート管理機能と接続しているホスト | Management Serverリモート管理機能に接続しているホスト
2 | 運用管理ドメイン | 運用管理ドメイン(デフォルトドメイン)
3 | ホスト(運用管理ドメイン内) | 運用管理ドメインに定義されたホスト
4 | 論理J2EEサーバ | 論理J2EEサーバ
5 | 論理J2EEサーバ以外の論理サーバ | 論理J2EEサーバ以外の論理サーバ

表21-6　ノードごとの操作の可否（論理サーバの運用管理の場合）

操作 | 操作手段の有無 | ノード
ビューツールバー | ビュープルダウンメニュー | コンテキストメニュー | 1 | 2 | 3 | 4 | 5
［Cosminexus Management Server リモート管理機能］ | － | － | － | － | － | － | － | －
| ［ログイン］ | ○ | － | ○ | ○1 | ○1 | ○1 | ○1 | ○1
［ログアウト］ | ○ | － | ○ | ○2 | ○2 | ○2 | ○2 | ○2
［開始］ | ○ | ○ | ○ | × | ◎ | ◎ | ○6 | ○6
［停止］ | ○ | ○ | ○ | × | ◎ | ◎ | ○4 | ○4
［インポート］ | － | － | － | － | － | － | － | －
| ［アプリケーション統合属性］ | ○ | － | ○ | × | × | × | × | ×
［Connector属性］ | ○ | － | ○ | × | × | × | × | ×
［J2EEアプリケーション(展開ディレクトリー形式)］ | ○ | － | ○ | × | × | × | × | ×
［J2EEアプリケーション (アーカイブ形式)］ | ○ | － | ○ | × | × | × | × | ×
［リソース・アダプター(Connector)］ | ○ | － | ○ | × | × | × | × | ×
［リソース・アダプター］ | ○ | － | ○ | × | × | × | × | ×
［エクスポート］ | － | － | － | － | － | － | － | －
| ［アプリケーション統合属性］ | ○ | － | ○ | × | × | × | × | ×
［Connector属性］ | ○ | － | ○ | × | × | × | × | ×
［Cosminexusアプリケーション］ | ○ | － | ○ | × | × | × | × | ×
［Cosminexusリソース・アダプター］ | ○ | － | ○ | × | × | × | × | ×
［J2EEアプリケーション］ | ○ | － | ○ | × | × | × | × | ×
［J2EEリソース・アダプター］ | ○ | － | ○ | × | × | × | × | ×
［Cosminexus RMI-IIOP インターフェース］ | ○ | － | ○ | ◎ | ◎ | ◎ | ◎ | ◎
［強制停止］ | － | ○ | ○ | × | × | × | ○5 | ○5
［削除］ | － | ○ | ○ | × | × | × | × | ×
［表示の更新］ | － | ○ | － | ○2 | ○2 | ○2 | ○2 | ○2
［プロパティー］ | － | ○ | ○ | × | × | × | × | ×
［アプリケーションを起動しないで開始］ | － | ○ | ○ | × | × | × | ○3 | ×
［開始オプションの設定］ | － | ○ | ○ | × | × | × | ◎ | ×
［リロード］ | － | ○ | ○ | × | × | × | × | ×
［入れ替え］ | － | ○ | ○ | × | × | × | × | ×
［アプリケーション名の変更］ | － | ○ | ○ | × | × | × | × | ×
［接続テスト］ | － | ○ | ○ | × | × | × | × | ×
［デプロイ］ | － | ○ | ○ | × | × | × | × | ×

（凡例）

数字：表21-5の項番に対応するノードの種類を示す。

○：操作手段を提供する。

◎：常に実行できる。

○1：Management Serverリモート管理機能への接続が切断されているときだけ実行できる。

○2：Management Serverリモート管理機能に接続されているときだけ実行できる。

○3：停止状態のときだけ実行できる。

○4：開始状態のときだけ実行できる。

○5：停止状態および異常停止状態のどちらでもないときに実行できる。

○6：停止状態または異常停止状態のときだけ実行できる。

×：常に実行できない。

－：該当なし。

(b)　J2EEサーバでのアプリケーション設定操作

論理J2EEサーバ内のノード，および選択したノードごとに，実行できる操作を次の表に示します。

表21-7　ツリービューで選択するノードの種類（アプリケーション設定操作の場合）

項番 | 種類 | 説明
1 | ［J2EEアプリケーション］フォルダ | （固定値）
2 | J2EEアプリケーション | J2EEアプリケーション
3 | J2EEリソースアダプタ（J2EEアプリケーション内） | J2EEアプリケーションに含まれるリソースアダプタ
4 | ［J2EEリソース・アダプター］フォルダ | （固定値）
5 | J2EEリソースアダプタ | デプロイされたリソースアダプタ
6 | ［J2EEリソース］フォルダ | （固定値）
7 | ［リソース・アダプター］フォルダ | （固定値）
8 | リソースアダプタ | J2EEリソース内のリソースアダプタ

表21-8　ノードごとの操作の可否（アプリケーション設定操作の場合）

操作 | 操作手段の有無 | ノード
ビューツールバー | ビュープルダウンメニュー | コンテキストメニュー | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8
［Cosminexus Management Server リモート管理機能］ | － | － | － | － | － | － | － | － | － | － | －
| ［ログイン］ | ○ | － | ○ | ○1 | ○1 | ○1 | ○1 | ○1 | ○1 | ○1 | ○1
［ログアウト］ | ○ | － | ○ | ○2 | ○2 | ○2 | ○2 | ○2 | ○2 | ○2 | ○2
［開始］ | ○ | ○ | ○ | × | ○3 | × | × | ○3 | × | × | ×
［停止］ | ○ | ○ | ○ | × | ○4 | × | × | ○4 | × | × | ×
［インポート］ | － | － | － | － | － | － | － | － | － | － | －
| ［アプリケーション統合属性］ | ○ | － | ○ | × | ○3 | × | × | × | × | × | ×
［Connector属性］ | ○ | － | ○ | × | × | ○3※5 | × | ○3 | × | × | ◎
［J2EEアプリケーション(展開ディレクトリー形式)］ | ○ | － | ○ | ◎※3 | × | × | × | × | × | × | ×
［J2EEアプリケーション (アーカイブ形式)］ | ○ | － | ○ | ◎ | × | × | × | × | × | × | ×
［リソース・アダプター(Connector)］ | ○ | － | ○ | × | × | × | × | × | × | ◎ | ×
［リソース・アダプター］ | ○ | － | ○ | × | × | × | × | × | × | ◎ | ×
［エクスポート］ | － | － | － | － | － | － | － | － | － | － | －
| ［アプリケーション統合属性］ | ○ | － | ○ | × | ○5 | × | × | × | × | × | ×
［Connector属性］ | ○ | － | ○ | × | × | ◎ | × | ○5 | × | × | ◎
［Cosminexusアプリケーション］ | ○ | － | ○ | × | ○5 | × | × | × | × | × | ×
［Cosminexusリソース・アダプター］ | ○ | － | ○ | × | × | × | × | ○5 | × | × | ×
［J2EEアプリケーション］ | ○ | － | ○ | × | ○5 | × | × | × | × | × | ×
［J2EEリソース・アダプター］ | ○ | － | ○ | × | × | × | × | ○5 | × | × | ×
［Cosminexus RMI-IIOP インターフェース］ | ○ | － | ○ | ◎ | ◎ | ◎ | ◎ | ◎ | ◎ | ◎ | ◎
［強制停止］ | － | ○ | ○ | × | ○6 | × | × | × | × | × | ×
［削除］ | － | ○ | ○ | × | ○3 | × | × | ○3 | × | × | ◎
［表示の更新］ | － | ○ | － | ○2 | ○2 | ○2 | ○2 | ○2 | ○2 | ○2 | ○2
［プロパティー］ | － | ○ | ○ | × | ○3※6 | ○3※4 | × | ○3 | × | × | ○3
［アプリケーションを起動しないで開始］ | － | ○ | ○ | × | × | × | × | × | × | × | ×
［開始オプションの設定］ | － | ○ | ○ | × | × | × | × | × | × | × | ×
［リロード］ | － | ○ | ○ | × | ○4※1 | × | × | × | × | × | ×
［入れ替え］ | － | ○ | ○ | × | ○5※2 | × | × | × | × | × | ×
［アプリケーション名の変更］ | － | ○ | ○ | × | ○3※4，※6 | × | × | × | × | × | ×
［接続テスト］ | － | ○ | ○ | × | × | ◎ | × | ○5 | × | × | ×
［デプロイ］ | － | ○ | ○ | × | × | × | × | × | × | × | ◎

（凡例）

数字：表21-7の項番に対応するノードの種類を示す。

○：操作手段を提供する。

◎：常に実行できる。

○1：Management Serverリモート管理機能への接続が切断されているときだけ実行できる。

○2：Management Serverリモート管理機能に接続されているときだけ実行できる。

○3：停止状態のときだけ実行できる。

○4：開始状態のときだけ実行できる。

○5：開始状態および停止状態のときだけ実行できる。

○6：通常停止中および閉塞状態のときだけ実行できる。

×：常に実行できない。

－：該当なし。

注※1　展開ディレクトリ形式のJ2EEアプリケーションだけを対象とします。

注※2　アーカイブ形式のJ2EEアプリケーションだけを対象とします。

注※3　ローカルホストの論理J2EEサーバだけを対象とします。

注※4　J2EEアプリケーションの属性エディタが開いている場合は実行できません。

注※5　リソースアダプタが含まれるJ2EEアプリケーションが停止状態の場合に実行できます。

注※6　J2EEアプリケーションに含まれるリソースアダプタの属性エディタが開いている場合は実行できません。

(c)　ノードも選択されていない場合

ツリービューで，どのノードも選択されていない場合，実行できる操作を次の表に示します。

表21-9　ノードが選択されていない場合の操作

操作 | 操作手段の有無 | ノードが選択されていない場合
ビューツールバー | ビュープルダウンメニュー | コンテキストメニュー
［Cosminexus Management Server リモート管理機能］ | － | － | － | －
| ［ログイン］ | ○ | － | ○ | ○1
［ログアウト］ | ○ | － | ○ | ○2
［エクスポート］ | － | － | － | －
| ［Cosminexus RMI-IIOP インターフェース］ | ○ | － | ○ | ◎
［表示の更新］ | － | ○ | － | ○2

（凡例）

○：操作手段を提供する。

◎：常に実行できる。

○1：Management Serverリモート管理機能への接続が切断されているときだけ実行できる。

○2：Management Serverリモート管理機能に接続されているときだけ実行できる

－：該当なし。

21.1.2　Management Serverリモート管理機能へのログイン

Management Serverリモート管理機能と接続する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-2　Management Serverリモート管理機能と接続する場合の［サーバー・エクスプローラー］ビュー

次のどちらかの方法で，Management Serverリモート管理機能に接続します。

ビューツールバーを使用
ビューツールバーの［[図データ]］（Management Serverリモート管理機能）のサブメニュー［[図データ]ログイン］を選択します。ツリービューのノードの選択は不要です。

コンテキストメニューを使用

ツリービューで，Management Serverリモート管理機能と接続するホストを選択します。

右クリックで表示されるコンテキストメニューの［[図データ]ログイン］を選択します。

操作が実行されると，［Cosminexus Management Serverリモート管理機能へログイン］ダイアログが表示されます。［Cosminexus Management Serverリモート管理機能へログイン］ダイアログについては，「11.1.2　Management Serverリモート管理機能への接続」を参照してください。

21.1.3　Management Serverリモート管理機能からのログアウト

Management Serverリモート管理機能との接続を切断する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-3　Management Serverリモート管理機能との接続を切断する場合の［サーバー・エクスプローラー］ビュー

次のどちらかの方法で，Management Serverリモート管理機能との接続を切断します。

ビューツールバーを使用
ビューツールバーの［[図データ]］（Management Serverリモート管理機能）のサブメニュー［[図データ]ログアウト］を選択します。ツリービューのノードの選択は不要です。

コンテキストメニューを使用

ツリービューで，Management Serverリモート管理機能と接続しているホストを選択します。

右クリックで表示されるコンテキストメニューの［[図データ]ログアウト］を選択します。

Management Serverリモート管理機能からのログアウトが実行されると，確認メッセージが表示されます。ログアウトを続行する場合は，メッセージダイアログで［はい］をクリックします。中止する場合は［いいえ］を選択します。

21.1.4　開始

論理サーバやJ2EEアプリケーションを開始する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

［サーバー・エクスプローラー］ビューで開始できる対象を次の表に示します。

表21-10　［サーバー・エクスプローラー］ビューで開始できる対象

開始対象 | 開始動作
運用管理ドメイン | 運用管理ドメインのすべての論理サーバを一括起動します。
ホスト | 選択したホストのすべての論理サーバを一括起動します。
論理サーバ | 選択した論理サーバを起動します。
J2EEアプリケーション | 選択したJ2EEアプリケーションを開始します。
［J2EEリソースアダプタ］フォルダ下のリソースアダプタ | 選択されたリソースアダプタを開始します。

対象を開始する場合の［サーバー・エクスプローラー］ビューと操作手順を次に示します。

図21-4　対象を開始する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，開始する対象を選択します。

選択した対象を開始します。
次のどれかの方法で，開始の操作を実行します。

ビューツールバーの［[図データ]］を選択

ビュープルダウンメニューの［[図データ]開始］を選択

右クリックで表示されるコンテキストメニューの［[図データ]開始］を選択

21.1.5　アプリケーションを起動しない場合のJ2EEサーバの開始

J2EEアプリケーションを起動しないで論理J2EEサーバを開始する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-5　アプリケーションを起動しないでJ2EEサーバを開始する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，開始するJ2EEサーバを選択します。

選択したJ2EEサーバを開始します。
次のどちらかの方法で，開始の操作を実行します。

ビュープルダウンメニューの［アプリケーションを起動しないで開始］を選択

右クリックで表示されるコンテキストメニューの［アプリケーションを起動しないで開始］を選択

21.1.6　論理J2EEサーバの開始オプションの設定

論理J2EEサーバの開始オプションを設定する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-6　論理J2EEサーバの開始オプションを設定する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，開始オプションを設定する論理J2EEサーバを選択します。

［開始オプションの設定］ダイアログを表示させます。
次のどちらかの方法で，［開始オプションの設定］ダイアログを表示させます。

右クリックで表示されるコンテキストメニューの［開始オプションの設定］を選択

ビュープルダウンメニューの［開始オプションの設定］を選択

表示された［開始オプションの設定］ダイアログで開始オプションを設定します。

図21-7　［開始オプションの設定］ダイアログ

［開始オプションの設定］ダイアログに表示される項目，およびボタンについて次に示します。

表21-11　［開始オプションの設定］ダイアログに表示される項目，およびボタン

項目
説明

［セキュリティー・マネージャーの使用］ラジオボタン
セキュリティマネジャを使用するかどうかを，［する(Y)］，または［しない(N)］から選択してください。
［しない(N)］を選択すると，論理J2EEサーバの起動パラメタに-nosecurityオプションが設定されます。［する(Y)］を選択すると，論理J2EEサーバの起動パラメタの-nosecurityオプションは解除されます。

［OK］ボタン
論理J2EEサーバの開始パラメタが更新されて，［開始オプションの設定］ダイアログが閉じます。

［キャンセル］ボタン
論理J2EEサーバの開始パラメタが更新されずに，［開始オプションの設定］ダイアログが閉じます。

21.1.7　停止

論理サーバやJ2EEアプリケーションを停止する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

［サーバー・エクスプローラー］ビューで停止できる対象を次の表に示します。

表21-12　［サーバー・エクスプローラー］ビューで停止できる対象

停止対象 | 停止動作
運用管理ドメイン | 運用管理ドメインのすべての論理サーバが一括停止します。
ホスト | 選択したホストのすべての論理サーバが一括停止します。
論理サーバ | 選択した論理サーバが停止します。
J2EEアプリケーション | 選択したJ2EEアプリケーションが停止します。
［J2EEリソースアダプタ］フォルダのリソースアダプタ | 選択されたリソースアダプタが停止します。

対象を停止する場合の［サーバー・エクスプローラー］ビューと操作手順を次に示します。

図21-8　［停止］する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，停止する対象を選択します。

選択した対象を停止します。
次のどれかの方法で，停止の操作を実行します。

ビューツールバーの［[図データ]］を選択

ビュープルダウンメニューの［[図データ]停止］を選択

右クリックで表示されるコンテキストメニューの［[図データ]停止］を選択

21.1.8　強制停止

論理サーバやJ2EEアプリケーションを強制停止する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-9　対象を強制停止する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，強制停止する論理サーバ，またはJ2EEアプリケーションを選択します。

選択した対象を強制停止します。
次のどちらかの方法で，強制停止の操作を実行します。

ビュープルダウンメニューの［強制停止］を選択

右クリックで表示されるコンテキストメニューの［強制停止］を選択

21.1.9　削除

ツリービューで選択した対象を削除する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-10　対象を削除する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，削除する対象を選択します。

選択した対象を削除します。
次のどちらかの方法で，削除の操作を実行します。

ビュープルダウンメニューの［[図データ]削除］を選択

右クリックで表示されるコンテキストメニューの［[図データ]削除］を選択

削除の操作を実行したあと，削除を確認するためのメッセージダイアログが表示されます。削除する場合は，［はい］を選択してください。削除を中止する場合は，［いいえ］を選択してください。

21.1.10　リロード

展開ディレクトリ形式でインポートされたJ2EEアプリケーションをリロードする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-11　J2EEアプリケーションをリロードする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，リロードするJ2EEアプリケーションを選択します。

選択したJ2EEアプリケーションをリロードします。
次のどちらかの方法で，リロードの操作を実行します。

ビュープルダウンメニューの［[図データ]リロード］を選択

右クリックで表示されるコンテキストメニューの［[図データ]リロード］を選択

21.1.11　J2EEアプリケーションの入れ替え

アーカイブ形式でインポートされたJ2EEアプリケーションを入れ替える場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-12　J2EEアプリケーションを入れ替える場合の［サーバー・エクスプローラー］ビュー

ツリービューで，入れ替えるJ2EEアプリケーションを選択します。

選択したJ2EEアプリケーションを入れ替えます。
次のどちらかの方法で，入れ替えの操作を実行します。

ビュープルダウンメニューの［入れ替え］を選択

右クリックで表示されるコンテキストメニューの［入れ替え］を選択

［J2EEアプリケーションの入れ替え］ダイアログが表示されます。

［J2EEアプリケーションの入れ替え］ダイアログで，入れ替えるアプリケーション（EARファイル）を選択します。

［J2EEアプリケーションの入れ替え］ダイアログで［開く］ボタンをクリックします。
アプリケーションの入れ替えが開始されます。

21.1.12　J2EEアプリケーション名の変更

J2EEアプリケーションのアプリケーション名を変更する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-13　アプリケーション名を変更する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，アプリケーション名を変更するJ2EEアプリケーションを選択します。

選択したJ2EEアプリケーションのアプリケーション名を変更します。
次のどちらかの方法で，アプリケーション名変更の操作を実行します。

ビュープルダウンメニューの［アプリケーション名の変更］を選択

右クリックで表示されるコンテキストメニューの［アプリケーション名の変更］を選択

［アプリケーション名の変更］ダイアログが表示されます。

図21-14　［アプリケーション名の変更］ダイアログ

［アプリケーション名の変更］ダイアログで，［新しい名前］に変更後のアプリケーション名を入力します。
デフォルトとして，変更前のアプリケーション名が表示され，［OK］ボタンは不活性となっています。
新しいアプリケーション名には，英数字およびアンダースコアの文字が指定できます。また，同じ名前のアプリケーションがすでにある場合は，そのアプリケーション名は指定できません。

［アプリケーション名の変更］ダイアログで［OK］ボタンをクリックします。
J2EEアプリケーションのアプリケーション名の変更が実行されます。
アプリケーション名を変更しない場合，［キャンセル］ボタンをクリックしてください。
［アプリケーション名の変更］ダイアログが閉じます。

［新しい名前］で指定した値に誤りがある場合，［アプリケーション名の変更］ダイアログのタイトル行にエラーメッセージが表示されます。

21.1.13　表示の更新

ツリービューの表示を最新の状態に更新する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-15　表示を更新する場合の［サーバー・エクスプローラー］ビュー

ビュープルダウンメニューから［[図データ]表示の更新］を選択します。
［サーバー・エクスプローラー］ビューの最新の状態が表示されます。

21.1.14　プロパティの設定

J2EEアプリケーションやリソースアダプタのプロパティを設定する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

プロパティの設定の操作を実行すると，次の処理が行われます。

アプリケーション統合属性，またはConnector属性が取得されます。

属性ファイル編集エディタが起動されます。

プロパティ設定項目を編集します。

属性ファイルを保管します。

プロパティを設定する場合の［サーバー・エクスプローラー］ビューと操作手順を次に示します。

図21-16　プロパティを設定する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，プロパティを設定するJ2EEアプリケーション，またはリソースアダプタを選択します。

属性ファイル編集エディタを起動します。
次のどれかの方法で，属性ファイル編集エディタを起動します。

ツリービューで選択したノードをダブルクリック

ビュープルダウンメニューの［[図データ]プロパティー］を選択

右クリックで表示されるコンテキストメニューの［[図データ]プロパティー］を選択

上記1.のツリービューで選択したプロパティ設定対象によって，次の属性ファイル編集エディタが起動されます。

ツリービューで選択したプロパティ設定対象 | 属性ファイル編集エディタ
［＜J2EEアプリケーション名＞］※1 | アプリケーション統合属性ファイル編集エディタ
［＜リソースアダプタ名＞］（［＜J2EEアプリケーション名＞］内）※1 | Connector属性ファイル編集エディタ
［＜J2EEリソースアダプタ名＞］（［J2EEリソース・アダプター］フォルダ内）※2 | Connector属性ファイル編集エディタ
［＜リソースアダプタ名＞］（［リソース・アダプター］フォルダ内）※3 | Connector属性ファイル編集エディタ

注※1　J2EEアプリケーションに含まれるリソースアダプタのプロパティを設定します。

J2EEアプリケーションに含まれるリソースアダプタのプロパティを設定する場合，アプリケーション統合属性ファイル編集エディタとConnector属性ファイル編集エディタのどちらも使用できます。ただし，どちらかの属性ファイル編集エディタが開いている場合，一方の属性ファイル編集エディタは開くことができません。属性ファイル編集エディタの選択方法については，「(1)　J2EEアプリケーションに含まれるリソースアダプタに使用する属性ファイル編集エディタ」を参照してください。

注※2　J2EEリソースアダプタとしてデプロイされているリソースアダプタのプロパティを設定します。

注※3　J2EEリソースアダプタとしてデプロイされていないリソースアダプタのプロパティを設定します。

属性ファイル編集エディタで，属性ファイルを更新します。
リソースアダプタの属性編集については，「21.2　リソースアダプタの属性編集画面」を参照してください。J2EEアプリケーションの属性編集については，「21.3　J2EEアプリケーションの属性編集画面」を参照してください。

属性ファイル編集エディタで保存，または属性ファイル編集エディタを終了して，属性ファイルをサーバへアップロードします。
属性ファイルを編集した状態で，属性ファイル編集エディタを閉じると，保管するかどうかの確認メッセージが表示されます。「はい」をクリックすると，保管処理が実行され，エラーがなければサーバへ更新情報が設定されます。「いいえ」をクリックすると，編集は破棄されます。「キャンセル」をクリックするとエディタはそのままの状態で，保管処理も実行されません。
属性ファイルの保管方法については，「11.3.1　プロパティの設定操作」を参照してください。
また，次の場合はメッセージダイアログが表示され，サーバへアップロードしません。

属性ファイルにエラーがある（XML検証でエラー）

サーバ側のコマンドの失敗

属性ファイル編集エディタについては，「11.3.2　属性ファイル編集エディタ」を参照してください。

注意事項

属性ファイル編集エディタのフォームページでは，属性ファイルで「xml:lang」属性が設定できる項目については，「xml:lang="en"」が設定されているか，または「xml:lang」が設定されていない場合だけ，表示，追加，更新ができます。

「xml:lang」属性が設定できる項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」を参照してください。

＜この項の構成＞

(1)　J2EEアプリケーションに含まれるリソースアダプタに使用する属性ファイル編集エディタ

(1)　J2EEアプリケーションに含まれるリソースアダプタに使用する属性ファイル編集エディタ

J2EEアプリケーションに含まれるリソースアダプタのプロパティ設定操作では，アプリケーション統合属性ファイル編集エディタとConnector属性ファイル編集エディタのどちらも使用できます。

アプリケーション統合属性ファイル編集エディタを使用する場合，アプリケーション統合属性ファイルのConnector属性を編集します。また，Connector属性ファイル編集エディタを使用する場合，リソースアダプタごとのConnector属性を編集します。それぞれの属性ファイル編集エディタを起動する操作を，次の図に示します。

図21-17　J2EEアプリケーションに含まれるリソースアダプタの属性ファイル編集エディタの起動

21.1.15　アプリケーション統合属性のインポート

J2EEアプリケーションの属性を，アプリケーション統合属性ファイルの値に変更する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-18　J2EEアプリケーションの属性を，アプリケーション統合属性ファイルの値に変更する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，属性を変更するJ2EEアプリケーションを選択します。

［アプリケーション統合属性のインポート］ダイアログを表示させます。
次のどちらかの方法で，［アプリケーション統合属性のインポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（インポート）のサブメニュー［[図データ]アプリケーション統合属性］を選択

右クリックで表示されるコンテキストメニューの［[図データ]アプリケーション統合属性］を選択

［アプリケーション統合属性のインポート］ダイアログが表示されます。

［アプリケーション統合属性のインポート］ダイアログでアプリケーション統合属性ファイルを選択します。

［アプリケーション統合属性のインポート］ダイアログで［開く］ボタンをクリックします。
アプリケーション統合属性のインポートが開始されます。

インポートダイアログで指定したファイルに，次のエラーがある場合，メッセージダイアログが表示されます。ダイアログの［OK］ボタンをクリックして，上記操作の3.に戻ります。

インポートダイアログで指定したファイルが存在しない

インポートダイアログで指定したファイルに読み取り権限がない

インポートダイアログで指定したファイルに読み取り権限がない場合，表示されたメッセージダイアログの［詳細］ボタンをクリックすると，発生した例外情報が表示されます。

21.1.16　Connector属性のインポート

リソースアダプタの属性をConnector属性ファイルの値に変更する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-19　リソースアダプタの属性をConnector属性ファイルの値に変更する場合の［サーバー・エクスプローラー］ビュー

ツリービューで，属性を変更するリソースアダプタを選択します。

次のどちらかの方法で，［Connector属性のインポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（インポート）のサブメニュー［[図データ]Connector属性］を選択

右クリックで表示されるコンテキストメニューの［[図データ]Connector属性のインポート］を選択

［Connector属性のインポート］ダイアログが表示されます。

［Connector属性のインポート］ダイアログでConnector属性ファイルを選択します。

［Connector属性のインポート］ダイアログで［開く］ボタンを選択します。
Connector属性のインポートが開始されます。

インポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.15　アプリケーション統合属性のインポート」を参照してください。

21.1.17　展開ディレクトリ形式のJ2EEアプリケーションのインポート

展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-20　展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，［J2EEアプリケーション］フォルダを選択します。

次のどちらかの方法で，［J2EEアプリケーション(展開ディレクトリー形式)のインポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（インポート）のサブメニュー［[図データ]J2EEアプリケーション(展開ディレクトリー形式)］を選択

右クリックで表示されるコンテキストメニューの［[図データ]J2EEアプリケーション(展開ディレクトリー形式)のインポート］を選択

図21-21　［J2EEアプリケーション(展開ディレクトリー形式)のインポート］ダイアログ

［J2EEアプリケーション(展開ディレクトリー形式)のインポート］ダイアログでアプリケーションディレクトリを選択します。

［J2EEアプリケーション(展開ディレクトリー形式)のインポート］ダイアログで［OK］ボタンをクリックします。
展開ディレクトリ形式のJ2EEアプリケーションのインポートが開始されます。

J2EEアプリケーションのディレクトリに，UNC名を含むパスを指定した場合，メッセージダイアログが表示されます。メッセージダイアログで［OK］をクリックすると，上記の操作3.に戻ります。

インポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.15　アプリケーション統合属性のインポート」を参照してください。

21.1.18　アーカイブ形式J2EEアプリケーションのインポート

アーカイブ形式のJ2EEアプリケーションをインポートする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-22　アーカイブ形式のJ2EEアプリケーションをインポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，［J2EEアプリケーション］フォルダを選択します。

次のどちらかの方法で，［J2EEアプリケーション(アーカイブ形式)のインポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（インポート）のサブメニュー［[図データ]J2EEアプリケーション(アーカイブ形式)］を選択

右クリックで表示されるコンテキストメニューの［[図データ]J2EEアプリケーション(アーカイブ形式)のインポート］を選択

［J2EEアプリケーション(アーカイブ形式)のインポート］ダイアログが表示されます。

［J2EEアプリケーション(アーカイブ形式)のインポート］ダイアログで，アプリケーションのアーカイブファイル(ZIP，またはEAR)を選択します。

［J2EEアプリケーション(アーカイブ形式)のインポート］ダイアログで［開く］を選択します。
アーカイブ形式のJ2EEアプリケーションのインポートが開始されます。

インポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.15　アプリケーション統合属性のインポート」を参照してください。

21.1.19　リソースアダプタ（Connector）のインポート

J2EEサーバが稼働するホスト（接続先ホスト）にあるリソースアダプタをインポートする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-23　接続先ホストにあるリソースアダプタをインポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，［リソース・アダプター］フォルダを選択します。

次のどちらかの方法で，［リソース・アダプター(Connector)のインポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（インポート）のサブメニュー［[図データ]リソース・アダプター(Connector)］を選択

右クリックで表示されるコンテキストメニューの［[図データ]リソース・アダプター(Connector)のインポート］を選択

［リソース・アダプター(Connector)のインポート］ダイアログが表示されます。

図21-24　［リソース・アダプター(Connector)のインポート］ダイアログ

［リソース・アダプター(Connector)のインポート］ダイアログで，接続先ホストにあるRARファイルを指定します。
［ファイル・パス］にRARファイルを直接入力するか，またはドロップダウンリストから選択します。
RARファイルを直接入力する場合，格納ディレクトリを含めた絶対パスで指定してください。ドロップダウンリストに表示されているRARファイルが指定できます。なお，「${cosminexus.home}」は，Cosminexusインストールディレクトリを示します。

［リソース・アダプター(Connector)のインポート］ダイアログで，［OK］を選択します。
接続先ホストのリソースアダプタのインポートが開始されます。

［ファイル・パス］で指定した値に誤りがある場合，［リソース・アダプター(Connector)のインポート］ダイアログのタイトル行にエラーメッセージが表示されます。

21.1.20　リソースアダプタのインポート

Server Plug-in環境にあるリソースアダプタをインポートする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-25　リソースアダプタをインポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，［リソース・アダプター］フォルダを選択します。

次のどちらかの方法で，［リソース・アダプターのインポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（インポート）のサブメニュー［[図データ]リソース・アダプター］を選択

右クリックで表示されるコンテキストメニューの［[図データ]リソース・アダプターのインポート］を選択

［リソース・アダプターのインポート］ダイアログが表示されます。

［リソース・アダプターのインポート］ダイアログで，インポートするリソースアダプタを選択します。

［リソース・アダプターのインポート］ダイアログで［開く］を選択します。
Server Plug-in環境のリソースアダプタのインポートが開始されます。

インポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.15　アプリケーション統合属性のインポート」を参照してください。

21.1.21　アプリケーション統合属性のエクスポート

J2EEアプリケーションの属性をアプリケーション統合属性ファイルとして出力する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-26　J2EEアプリケーションの属性をエクスポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，属性を出力するJ2EEアプリケーションを選択します。

次のどちらかの方法で，［アプリケーション統合属性のエクスポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（エクスポート）のサブメニュー［[図データ]アプリケーション統合属性］を選択

右クリックで表示されるコンテキストメニューの［[図データ]アプリケーション統合属性のエクスポート］を選択

［アプリケーション統合属性のエクスポート］ダイアログが表示されます。

［アプリケーション統合属性のエクスポート］ダイアログで，出力するアプリケーション統合属性のファイル名を指定します。

［アプリケーション統合属性のエクスポート］ダイアログで，［保存］ボタンをクリックします。
アプリケーション統合属性のエクスポートが開始されます。

エクスポートダイアログで指定したファイルに，次のエラーがある場合，メッセージダイアログが表示されます。

エクスポートダイアログで指定したファイルが，すでに存在する

エクスポートダイアログで指定したファイルに書き込み権限がない
エクスポートダイアログで指定したファイルに書き込み権限がない場合，［詳細］ボタンをクリックすると，発生した例外情報が表示されます。

［OK］ボタンまたは「はい」ボタンをクリックすると，アプリケーション統合属性のエクスポート操作の3.に戻ります。

注意

Windows 7またはWindows Vistaで管理者特権のないユーザが，エクスポート先に，C:¥Program Files以下のディレクトリを指定した場合の対応については，「11.4　Server Plug-inの注意事項」の「(1)　Windows 7またはWindows Vista使用時の注意事項」を参照してください。

参考

属性ファイルのエンコードは，Eclipseの環境設定の，［エディター］で設定します。設定画面を次に示します。

図21-27　Eclipseのエンコード設定画面

Eclipseのエンコード設定は，次の手順で表示します。

メニューから［ウィンドウ］ - ［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインにあるツリービューで，［一般］ - ［エディター］を選択します。
［エディター］ページが表示されます。

［エディター］ページの［テキスト・ファイル・エンコード］から，エクスポートする属性ファイルのエンコードを選択します。

21.1.22　Connector属性のエクスポート

リソースアダプタの属性を，Connector属性ファイルに取得する場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-28　リソースアダプタの属性をエクスポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，属性を取得するリソースアダプタを選択します。

次のどちらかの方法で，［Connector属性のエクスポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（エクスポート）のサブメニュー［[図データ]Connector属性］を選択

右クリックで表示されるコンテキストメニューの［[図データ]Connector属性のエクスポート］を選択

［Connector属性のエクスポート］ダイアログが表示されます。

［Connector属性のエクスポート］ダイアログで，Connector属性を出力するファイル名を指定します。

［Connector属性のエクスポート］ダイアログで，［保存］ボタンをクリックします。
Connector属性のエクスポートが開始されます。

エクスポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.21　アプリケーション統合属性のエクスポート」を参照してください。

参考

属性ファイルのエンコードは，Eclipseの環境設定の，［エディター］で設定します。設定画面については，「21.1.21　アプリケーション統合属性のエクスポート」を参照してください。

21.1.23　Cosminexusアプリケーションのエクスポート

実行時情報を含んだJ2EEアプリケーションをエクスポートする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-29　実行時情報を含んだJ2EEアプリケーションをエクスポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，エクスポートするJ2EEアプリケーションを選択します。

次のどちらかの方法で，［Cosminexusアプリケーションのエクスポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（エクスポート）のサブメニュー［[図データ]Cosminexusアプリケーション］を選択

右クリックで表示されるコンテキストメニューの［[図データ]Cosminexusアプリケーションのエクスポート］を選択

［Cosminexusアプリケーションのエクスポート］ダイアログが表示されます。

［Cosminexusアプリケーションのエクスポート］ダイアログで，エクスポートするJ2EEアプリケーションのアーカイブファイルを選択します。

［Cosminexusアプリケーションのエクスポート］ダイアログで，［保存］ボタンをクリックします。
J2EEアプリケーションのエクスポートが開始されます。

エクスポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.21　アプリケーション統合属性のエクスポート」を参照してください。

21.1.24　Cosminexus RMI-IIOPインタフェースのエクスポート

［Cosminexus RMI-IIOP インタフェース］ページで，J2EEアプリケーションのRMI-IIOPインタフェースをエクスポートします。［Cosminexus RMI-IIOP インタフェース］ページの表示と操作について説明します。

＜この項の構成＞

(1)　［Cosminexus RMI-IIOP インタフェース］ページの表示

(2)　［Cosminexus RMI-IIOP インタフェース］ページの操作

(1)　［Cosminexus RMI-IIOP インタフェース］ページの表示

［Cosminexus RMI-IIOP インタフェース］ページは，次のどちらかの方法で表示します。

［エクスポート］ダイアログから表示

［サーバー・エクスプローラー］ビューから表示

●［エクスポート］ダイアログから表示

［エクスポート］ダイアログを次に示します。

図21-30　［エクスポート］ダイアログ

［Cosminexus RMI-IIOP インタフェース］ページは次の手順で表示します。

メニューから［ファイル］ - ［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［エクスポート］ダイアログの［エクスポート先の選択］の［Cosminexus RMI-IIOP インターフェース］を選択して，［次へ］をクリックします。
［Cosminexus RMI-IIOP インタフェース］ページが表示されます。

●［サーバー・エクスプローラー］ビューから表示

［サーバー・エクスプローラー］ビューを次に示します。

図21-31　［Cosminexus RMI-IIOP インタフェース］ページを表示する場合の［サーバー・エクスプローラー］ビュー

［Cosminexus RMI-IIOP インタフェース］ページは次の手順で表示します。

ツリービューで，RMI-IIOPインタフェースをエクスポートするJ2EEアプリケーションを選択します。

次のどちらかの方法で，［Cosminexus RMI-IIOP インタフェース］ページを表示させます。

ビューツールバーの［[図データ]］（エクスポート）のサブメニュー［[図データ]Cosminexus RMI-IIOP インターフェース］を選択

右クリックで表示されるコンテキストメニューの［[図データ]Cosminexus RMI-IIOP インターフェースのエクスポート］を選択

［Cosminexus RMI-IIOP インタフェース］ページが表示されます。

(2)　［Cosminexus RMI-IIOP インタフェース］ページの操作

［Cosminexus RMI-IIOP インタフェース］ページを次に示します。

図21-32　［Cosminexus RMI-IIOP インタフェース］ページ

［エクスポート元アプリケーション］のツリービューからRMI-IIOPインタフェースをエクスポートするJ2EEアプリケーションを選択します。
J2EEアプリケーションが表示されていない場合，J2EEサーバのノードを展開して，J2EEアプリケーションを表示します。表示処理中はプログレスバーが表示され，キャンセルできません。

RMI-IIOPインタフェースをプロジェクトにエクスポートする場合は，［プロジェクト］を選択します。
RMI-IIOPインタフェースのエクスポート先プロジェクトを次のように指定します。

ワークスペースからの相対パスで指定する。

パスのセパレータは，「¥」または「/」で指定する。

大文字・小文字の区別はしない。

入力値の長さに制限はない。

［参照］をクリックすると，［プロジェクトの参照］ダイアログが表示されます。［プロジェクトの参照］ダイアログには，ワークスペース内のプロジェクトおよびプロジェクト以下のフォルダが表示されています。RMI-IIOPインタフェースのエクスポート先プロジェクトを選択して，［OK］をクリックしてください。

RMI-IIOPインタフェースをフォルダにエクスポートする場合は，［フォルダー］を選択します。
RMI-IIOPインタフェースのエクスポート先フォルダを次のように指定します。

ファイルシステムの絶対パスで指定する。

パスのセパレータは，「¥」または「/」で指定する。

大文字・小文字の区別はしない。

最大文字数は248文字とする。

［参照］をクリックすると，［フォルダ－の参照］ダイアログが表示されます。［フォルダーの参照］ダイアログで，RMI-IIOPインタフェースのエクスポート先フォルダを指定して，［OK］をクリックしてください。

［終了］をクリックします。
［エクスポート元アプリケーション］でJ2EEアプリケーションが選択されている場合に活性となり，クリックできます。
RMI-IIOPインタフェースのエクスポートが開始されます。

［プロジェクト］または［フォルダー］で指定した値に誤りがある場合，［Cosminexus RMI-IIOP インタフェース］ページのタイトル行に，エラーメッセージが表示されます。

注意

Windows 7またはWindows Vistaで管理者特権のないユーザが，エクスポート先に，C:¥Program Files以下のディレクトリを指定した場合の対応については，「11.4　Server Plug-inの注意事項」の「(1)　Windows 7またはWindows Vista使用時の注意事項」を参照してください。

21.1.25　Cosminexusリソースアダプタのエクスポート

実行時情報を含んだリソースアダプタをエクスポートする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-33　実行時情報を含んだリソースアダプタをエクスポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，エクスポートするリソースアダプタを選択します。

次のどちらかの方法で［Cosminexusリソース・アダプターのエクスポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（エクスポート）のサブメニュー［[図データ]Cosminexusリソース・アダプター］を選択

右クリックで表示されるコンテキストメニューの［[図データ]Cosminexusリソース・アダプターのエクスポート］を選択

［Cosminexusリソース・アダプターのエクスポート］ダイアログが表示されます。

［Cosminexusリソース・アダプターのエクスポート］ダイアログで，エクスポートするリソースアダプタ（RARファイル）を選択します。

［Cosminexusリソース・アダプターのエクスポート］ダイアログで，［保存］ボタンをクリックします。
リソースアダプタのエクスポートが開始されます。

エクスポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.21　アプリケーション統合属性のエクスポート」を参照してください。

21.1.26　J2EEアプリケーションのエクスポート

J2EEアプリケーションをエクスポートする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-34　J2EEアプリケーションをエクスポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，エクスポートするJ2EEアプリケーションを選択します。

次のどちらかの方法で，［J2EEアプリケーションのエクスポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（エクスポート）のサブメニュー［[図データ]J2EEアプリケーション］を選択

右クリックで表示されるコンテキストメニューの［[図データ]J2EEアプリケーションのエクスポート］を選択

［J2EEアプリケーションのエクスポート］ダイアログが表示されます。

［J2EEアプリケーションのエクスポート］ダイアログで，エクスポートするJ2EEアプリケーションのアーカイブファイルを選択します。

［J2EEアプリケーションのエクスポート］ダイアログで，［保存］ボタンをクリックします。
J2EEアプリケーションのエクスポートが開始されます。

エクスポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.21　アプリケーション統合属性のエクスポート」を参照してください。

21.1.27　J2EEリソースアダプタのエクスポート

J2EEリソースアダプタをエクスポートする場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-35　J2EEリソースアダプタをエクスポートする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，エクスポートするJ2EEリソースアダプタを選択します。

次のどちらかの方法で［J2EEリソース・アダプターのエクスポート］ダイアログを表示させます。

ビューツールバーの［[図データ]］（エクスポート）のサブメニュー［[図データ]J2EEリソース・アダプター］を選択

右クリックで表示されるコンテキストメニューの［[図データ]J2EEリソース・アダプターのエクスポート］を選択

［J2EEリソース・アダプターのエクスポート］ダイアログが表示されます。

［J2EEリソース・アダプターのエクスポート］ダイアログで，エクスポートするリソースアダプタ（RARファイル）を選択します。

［J2EEリソース・アダプターのエクスポート］ダイアログで，［保存］ボタンをクリックします。
リソースアダプタのエクスポートが開始されます。

エクスポートダイアログで指定したファイルにエラーがある場合の対応については，「21.1.21　アプリケーション統合属性のエクスポート」を参照してください。

21.1.28　接続テスト

J2EEリソースアダプタの接続テストを行う場合の［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-36　リソースアダプタの接続テストを行う場合の［サーバー・エクスプローラー］ビュー

ツリービューで，接続テストを行うJ2EEリソースアダプタを選択します。

右クリックで表示されるコンテキストメニューの［[図データ]接続テスト］を選択して，接続テストの操作を実行します。
接続テストが開始されます。
接続テストに成功すると，接続テスト成功のメッセージダイアログが表示されます。

21.1.29　リソースアダプタのデプロイ

リソースアダプタをJ2EEリソースアダプタとしてデプロイする場合の，［サーバー・エクスプローラー］ビューと操作手順について説明します。

図21-37　リソースアダプタをJ2EEリソースアダプタとしてデプロイする場合の［サーバー・エクスプローラー］ビュー

ツリービューで，デプロイするリソースアダプタを選択します。

右クリックで表示されるコンテキストメニューの［[図データ]デプロイ］を選択して，デプロイの操作を実行します。

21.2　リソースアダプタの属性編集画面

ここでは，リソースアダプタの属性編集画面について説明します。リソースアダプタの属性編集画面は，次の手順で表示します。

［サーバー・エクスプローラー］ビューで，属性を編集するリソースアダプタのノードを選択します。
リソースアダプタの属性を編集する場合，次のノードを選択してください。

J2EEアプリケーションに含まれるリソースアダプタの場合
［J2EEアプリケーション］フォルダ - ［＜J2EEアプリケーション名＞］内の［＜リソースアダプタ＞］

J2EEリソースアダプタとしてデプロイされるリソースアダプタの場合
［J2EEリソース・アダプター］フォルダ内のJ2EEリソースアダプタ

J2EEリソースアダプタとしてデプロイしていないリソースアダプタの場合
［J2EEリソース］-［リソース・アダプター］フォルダ内のリソースアダプタ

属性ファイル編集エディタを起動します。
次のどれかの方法で，属性ファイル編集エディタを起動します。

ツリービューで選択したノードをダブルクリック

ビュープルダウンメニューの［[図データ]プロパティー］を選択

右クリックで表示されるコンテキストメニューの［[図データ]プロパティー］を選択

属性ファイル編集エディタが起動されると，パースペクティブのエディタエリアに，Connector属性のフォームページが表示されます。

図21-38　Connector属性のフォームページ例

フォームページの［エレメント］の下に，Connector属性の構成のツリーが展開されます。

＜この節の構成＞

21.2.1　Connector属性のツリー

21.2.2　Connector属性設定ページ

21.2.1　Connector属性のツリー

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。エディタエリアの［エレメント］の下に，Connector属性の構成がツリー形式で表示されます。

Connector属性のツリー構成を次に示します。

[図データ]＜Connector属性名＞
　├─アイコン
　│
　├─ライセンス
　│
　├─リソース・アダプター
　│　　├─[図データ]コンフィグレーション・プロパティー※
　│　　│　└─＜コンフィグレーションプロパティ名＞
　│　　│
　│　　├─アウトバウンド・リソース・アダプター
　│　　│　└─[図データ]コネクション定義
　│　　│　　　└─＜コネクション定義識別子＞
　│　　│　　　　　　├─[図データ]コンフィグレーション・プロパティー
　│　　│　　　　　　│　└─＜コンフィグレーションプロパティ名＞
　│　　│　　　　　　│
　│　　│　　　　　　└─コネクター・ランタイム
　│　　│　　　　　　　　　├─プロパティー
　│　　│　　　　　　　　　│
　│　　│　　　　　　　　　│
　│　　│　　　　　　　　　└─[図データ]リソース外部プロパティー
　│　　│　　　　　　　　　　　└─＜リソースアダプタの別名＞
　│　　│
　│　　├─インバウンド・リソース・アダプター
　│　　│　└─メッセージ・アダプター
　│　　│　　　└─[図データ]メッセージ・リスナー
　│　　│　　　　　└─＜メッセージリスナ名＞
　│　　│　　　　　　　└─アクティベーション・スペック
　│　　│　　　　　　　　　└─[図データ]必須コンフィグレーション・プロパティー
　│　　│　　　　　　　　　　　└─＜必須コンフィグレーションプロパティ名＞
　│　　│
　│　　└─[図データ]管理対象オブジェクト
　│　　　　├─＜管理対象オブジェクト名＞
　│　　　　│
　│　　　　└─[図データ]コンフィグレーション・プロパティー
　│　　　　　　└─＜コンフィグレーションプロパティ名＞
　│
　└─リソース・アダプター・ランタイム※
　　　　└─プロパティー※

注※　このノード以下のノードは，Connector 1.5の仕様に準拠するリソースアダプタの場合に指定できます。

Connector属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。

次に，Connector属性のツリーノードとコンテキストメニューについて説明します。

＜この項の構成＞

(1)　Connector属性のツリーノード

(2)　コンテキストメニュー

(1)　Connector属性のツリーノード

Connector属性のツリービューに表示されるノードを次の表に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。

表21-13　Connector属性ファイルのツリーのノード

ノード | 説明 | 対応するタグ名 | プロパティページ
＜Connector属性名＞ | Connector属性を示すノードです。選択すると，Connector属性のプロパティページが表示されます。 | <hitachi-connector-property> | 21.2.2　(1)
アイコン | アイコンを示すノードです。選択すると，アイコンのプロパティページが表示されます。 | <icon> | 21.4.2　(2)
ライセンス | ライセンスを示すノードです。選択すると，ライセンスのプロパティページが表示されます。 | <license> | 21.2.2　(2)
リソース・アダプター | リソースアダプタを示すノードです。選択すると，リソースアダプタのプロパティページが表示されます。 | <resourceadapter> | 21.2.2　(3)
コンフィグレーション・プロパティー（リソース・アダプター） | ResourceAdapter実装クラスのインスタンスに対するコンフィグレーションプロパティをまとめるノードです。選択すると，コンフィグレーションプロパティの一覧ページが表示されます。 | － | 21.2.2　(7)
＜コンフィグレーションプロパティ名＞（リソース・アダプター） | ResourceAdapter実装クラスのインスタンスに対するコンフィグレーションプロパティを示すノードです。選択すると，コンフィグレーションプロパティのプロパティページが表示されます。 | <resourceadapter> - <config-property> | 21.2.2　(8)，21.2.2　(9)
アウトバウンド・リソース・アダプター | Outboundリソースアダプタのプロパティを示すノードです。選択すると，Outboundリソースアダプタのプロパティページが表示されます。 | <resourceadapter> - <outbound-resourceadapter> | 21.2.2　(4)
コネクション定義 | Outboundリソースアダプタのコネクション定義をまとめるノードです。選択すると，コネクション定義の一覧ページが表示されます。 | － | 21.2.2　(5)
＜コネクション定義識別子＞ | コネクション定義を示すノードです。選択すると，コネクション定義のプロパティページが表示されます。 | <resourceadapter> - <outbound-resourceadapter> - <connection-definition> | 21.2.2　(6)
コンフィグレーション・プロパティー（コネクション定義） | Outboundリソースアダプタに対するコンフィグレーションプロパティをまとめるノードです。選択すると，コンフィグレーションプロパティの一覧ページが表示されます。 | － | 21.2.2　(7)
＜コンフィグレーションプロパティ名＞（コネクション定義） | Outboundリソースアダプタに対するコンフィグレーションプロパティを示すノードです。選択すると，コンフィグレーションプロパティのプロパティページが表示されます。 | <resourceadapter> - <outbound-resourceadapter> - <connection-definition> - <config-property> | 21.2.2　(8)，21.2.2　(9)
コネクター・ランタイム | Outboundリソースアダプタに対するランタイムのプロパティ，およびリソースの外部プロパティをまとめるノードです。 | <resourceadapter> - <outbound-resourceadapter> - <connection-definition> -<connector-runtime> | －
プロパティー（コネクション定義） | Outboundリソースアダプタに対するランタイムのプロパティを示すノードです。選択すると，プロパティのプロパティページが表示されます。 | <resourceadapter> - <outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <property> | 21.2.2　(10)
リソース外部プロパティー | Outboundリソースアダプタに対するリソース外部プロパティをまとめるノードです。選択すると，リソース外部プロパティの一覧ページが表示されます。 | － | 21.2.2　(11)
＜リソースアダプタの別名＞ | Outboundリソースアダプタに対するリソースアダプタの別名を示すノードです。選択すると，リソース外部プロパティのプロパティページが表示されます。 | <resourceadapter> - <outbound-resourceadapter> - <connection-definition> - <resource-external-property> | 21.2.2　(12)
インバウンド・リソース・アダプター | Inboundリソースアダプタのプロパティを示すノードです。 | <resourceadapter> - <inbound-resourceadapter> | －
メッセージ・アダプター | Inboundリソースアダプタに対するメッセージアダプタを示すノードです。 | <resourceadapter> - <inbound-resourceadapter> - <messageadapter> | －
メッセージ・リスナー | Inboundリソースアダプタに対するメッセージリスナをまとめるノードです。選択すると，メッセージリスナの一覧ページが表示されます。 | － | 21.2.2　(13)
＜メッセージリスナ名＞ | Inboundリソースアダプタに対するメッセージリスナを示すノードです。選択すると，メッセージリスナのプロパティページが表示されます。 | <resourceadapter> - <inbound-resourceadapter> - <messageadapter> - <messagelistener> - <messagelistener-type> | 21.2.2　(14)
アクティベーション・スペック | Inboundリソースアダプタに対するActivationSpecを示すノードです。選択すると，ActivationSpecのプロパティページが表示されます。 | <resourceadapter> - <inbound-resourceadapter> - <messageadapter> - <messagelistener> - <activationspec> | 21.2.2　(15)
必須コンフィグレーション・プロパティー | Inboundリソースアダプタに対する必須コンフィグレーションプロパティをまとめるノードです。選択すると，必須コンフィグレーションプロパティの一覧ページが表示されます。 | － | 21.2.2　(16)
＜必須コンフィグレーションプロパティ名＞ | Inboundリソースアダプタに対する必須コンフィグレーションプロパティを示すノードです。選択すると，必須コンフィグレーションプロパティのプロパティページが表示されます。 | <resourceadapter> - <inbound-resourceadapter> - <messageadapter> - <messagelistener> - <activationspec> - <required-config-property> - <config-property-name> | 21.2.2　(17)
管理対象オブジェクト | リソースアダプタに対する管理対象オブジェクトをまとめるノードです。選択すると，管理対象オブジェクトの一覧ページが表示されます。 | － | 21.2.2　(18)
＜管理対象オブジェクト名＞ | リソースアダプタに対する管理対象オブジェクトを示すノードです。選択すると，管理対象オブジェクトのプロパティページが表示されます。 | <resourceadapter> - <adminobject> - <adminobject-name> | 21.2.2　(19)
コンフィグレーション・プロパティー（管理対象オブジェクト） | リソースアダプタに対する管理対象オブジェクトのコンフィグレーションプロパティをまとめるノードです。選択すると，コンフィグレーションプロパティの一覧ページが表示されます。 | － | 21.2.2　(7)
＜コンフィグレーションプロパティ名＞ | リソースアダプタに対する管理対象オブジェクトのコンフィグレーションプロパティを示すノードです。選択すると，コンフィグレーションプロパティのプロパティページが表示されます。 | <resourceadapter> - <adminobject> - <config-property> - <config-property-name> | 21.2.2　(8)，21.2.2　(9)
リソース・アダプター・ランタイム | リソースアダプタに対するランタイムプロパティをまとめるノードです。 | <resourceadapter-runtime> | －
プロパティー（リソース・アダプター） | リソースアダプタに対するランタイムプロパティを示すノードです。選択すると，プロパティのプロパティページが表示されます。 | <resourceadapter-runtime> - <property> | 21.2.2　(20)

（凡例）　－：該当なし

(2)　コンテキストメニュー

Connector属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-14　Connector属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

＜Connector属性名＞
［追加］ - ［アイコン］
Connector属性にアイコンが追加されます。アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.4.2　(2)

アイコン
［削除］
Connector属性からアイコンが削除されます。
－

リソース・アダプター
［追加］ - ［コンフィグレーション・プロパティー］
リソースアダプタにコンフィグレーションプロパティが追加されます。コンフィグレーションプロパティのプロパティページが表示されます。
21.2.2　(8)，21.2.2　(9)

［追加］ - ［管理対象オブジェクト］
リソースアダプタに管理対象オブジェクトが追加されます。管理対象オブジェクトの一覧ページが表示されます。
21.2.2　(18)

コンフィグレーション・プロパティー（リソース・アダプター）
［追加］ - ［コンフィグレーション・プロパティー］
コンフィグレーションプロパティが追加されます。コンフィグレーションプロパティのプロパティページが表示されます。
21.2.2　(8)，21.2.2　(9)

［削除］
リソースアダプタから，すべてのコンフィグレーションプロパティが削除されます。
－

＜コンフィグレーションプロパティ名＞（リソース・アダプター）
［削除］
リソースアダプタから，選択したコンフィグレーションプロパティが削除されます。
－

＜コネクション定義識別子＞
［追加］ - ［コンフィグレーション・プロパティー］
コンフィグレーションプロパティ（コネクション定義）が追加されます。コンフィグレーションプロパティのプロパティページが表示されます。
21.2.2　(8)，21.2.2　(9)

コンフィグレーション・プロパティー（コネクション定義）
［追加］ - ［コンフィグレーション・プロパティー］
コンフィグレーションプロパティ（コネクション定義）が追加されます。コンフィグレーションプロパティのプロパティページが表示されます。
21.2.2　(8)，21.2.2　(9)

［削除］
＜コネクション定義識別子＞からすべてのコンフィグレーションプロパティが削除されます。
－

＜コンフィグレーションプロパティ名＞（コネクション定義）
［削除］
＜コネクション定義識別子＞から選択したコンフィグレーションプロパティが削除されます。
－

コネクター・ランタイム
［追加］ - ［リソース外部プロパティー］
リソースアダプタの別名が追加されます。リソース外部プロパティのプロパティページが表示されます。
21.2.2　(12)

リソース外部プロパティー
［追加］ - ［リソース外部プロパティー］
リソースアダプタの別名が追加されます。リソース外部プロパティのプロパティページが表示されます。
21.2.2　(12)

［削除］
ランタイムから，すべてのリソースアダプタの別名が削除されます。
－

＜リソースアダプタの別名＞
［削除］
ランタイムから，選択したリソースアダプタの別名が削除されます。
－

管理対象オブジェクト
［追加］ - ［管理対象オブジェクト］
リソースアダプタに管理対象オブジェクトが追加されます。管理対象オブジェクトのプロパティページが表示されます。
21.2.2　(19)

［削除］
リソースアダプタからすべての管理対象オブジェクトが削除されます。
－

＜管理対象オブジェクト名＞
［追加］ - ［コンフィグレーション・プロパティー］
管理対象オブジェクトのコンフィグレーションプロパティ（管理対象オブジェクト）が追加されます。コンフィグレーションプロパティのプロパティページが表示されます。
21.2.2　(8)，21.2.2　(9)

［削除］
リソースアダプタから選択した管理対象オブジェクトが削除されます。
－

コンフィグレーション・プロパティー（管理対象オブジェクト）
［追加］ - ［コンフィグレーション・プロパティー］
管理対象オブジェクトのコンフィグレーションプロパティ（管理対象オブジェクト）が追加されます。コンフィグレーションプロパティのプロパティページが表示されます。
21.2.2　(8)，21.2.2　(9)

［削除］
管理対象オブジェクトからすべてのコンフィグレーションプロパティ（管理対象オブジェクト）が削除されます。
－

＜コンフィグレーションプロパティ名＞
［削除］
管理対象オブジェクトから選択したコンフィグレーションプロパティ（管理対象オブジェクト）が削除されます。
－

（凡例）　－：該当なし

21.2.2　Connector属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。［エレメントの詳細］に，編集するConnector属性のプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアに，選択したノードに対応するプロパティページが表示されます。

Connector属性には，次のプロパティページがあります。

Connector属性のプロパティページ

ライセンスのプロパティページ

リソースアダプタのプロパティページ

Outboundリソースアダプタのプロパティページ

コネクション定義の一覧ページ

コネクション定義のプロパティページ

コンフィグレーションプロパティの一覧ページ

コンフィグレーションプロパティのプロパティページ（XAOpenString以外）

コンフィグレーションプロパティのプロパティページ（XAOpenString）

プロパティのプロパティページ（Outboundリソースアダプタ）

リソース外部プロパティの一覧ページ

リソース外部プロパティのプロパティページ

メッセージリスナの一覧ページ

メッセージリスナのプロパティページ

ActivationSpecのプロパティページ

必須コンフィグレーションプロパティの一覧ページ

必須コンフィグレーションプロパティのプロパティページ

管理対象オブジェクトの一覧ページ

管理対象オブジェクトのプロパティページ

プロパティのプロパティページ（リソースアダプタ）

注意事項

プロパティページで，設定が必須の項目には「*」が付与されています。

＜この項の構成＞

(1)　Connector属性のプロパティページ

(2)　ライセンスのプロパティページ

(3)　リソースアダプタのプロパティページ

(4)　Outboundリソースアダプタのプロパティページ

(5)　コネクション定義の一覧ページ

(6)　コネクション定義のプロパティページ

(7)　コンフィグレーションプロパティの一覧ページ

(8)　コンフィグレーションプロパティのプロパティページ（XAOpenString以外）

(9)　コンフィグレーションプロパティのプロパティページ（XAOpenString）

(10)　プロパティのプロパティページ（Outboundリソースアダプタ）

(11)　リソース外部プロパティの一覧ページ

(12)　リソース外部プロパティのプロパティページ

(13)　メッセージリスナの一覧ページ

(14)　メッセージリスナのプロパティページ

(15)　ActivationSpecのプロパティページ

(16)　必須コンフィグレーションプロパティの一覧ページ

(17)　必須コンフィグレーションプロパティのプロパティページ

(18)　管理対象オブジェクトの一覧ページ

(19)　管理対象オブジェクトのプロパティページ

(20)　プロパティのプロパティページ（リソースアダプタ）

(1)　Connector属性のプロパティページ

Connector属性のプロパティページを次に示します。

図21-39　Connector属性のプロパティページ

表21-15　Connector属性のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
リソースアダプタの説明を指定します。
<description>
説明
</description>

表示名
－
リソースアダプタ名が表示されます。
<display-name>
表示名
</display-name>

プロバイダー・ベンダー名
－
リソースアダプタのプロバイダベンダ名が表示されます。
<vender-name>
プロバイダー・ベンダー名
</vender-name>

コネクター・アーキテクチャーのバージョン
－
リソースアダプタがサポートしているコネクタアーキテクチャ仕様のバージョンが表示されます。
<spec-version>
コネクター・アーキテクチャーのバージョン
</spec-version>

EISのタイプ
－
EISのタイプが表示されます。
<eis-type>
EISのタイプ
</eis-type>

バージョン
－
リソースアダプタのバージョンが表示されます。
<version>
バージョン
</version>

（凡例）　×：任意　－：変更不可

(2)　ライセンスのプロパティページ

ライセンスのプロパティページを次に示します。

図21-40　ライセンスのプロパティページ

表21-16　ライセンスのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
ライセンスの説明を指定します。
<description>
説明
</description>

ライセンスを要求する
－
リソースアダプタのデプロイ時にライセンスを要求する設定にしているかどうかが表示されます。

true：ライセンスを要求する

false：ライセンスを要求しない

<license-required>
ライセンスを要求する
</license-required>

（凡例）　×：任意　－：変更不可

(3)　リソースアダプタのプロパティページ

リソースアダプタのプロパティページを次に示します。

図21-41　リソースアダプタのプロパティページ

表21-17　リソースアダプタのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

ResourceAdapter実装クラス
－
javax.resource.spi.ResourceAdapterクラスを実装したJavaクラス名が表示されます。
<resourceadapter-class>クラス名
</resourceadapter-class >

（凡例）　－：変更不可

(4)　Outboundリソースアダプタのプロパティページ

Outboundリソースアダプタのプロパティページを次に示します。

図21-42　Outboundリソースアダプタのプロパティページ

表21-18　Outboundリソースアダプタのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

トランザクション・サポートのレベル
○
リソースアダプタで提供されるトランザクションサポートのレベルを指定します。
指定できる値を次に示します。

NoTransaction

LocalTransaction

XATransaction

<transaction-support>
トランザクションサポートのレベル
</transaction-support>

再認証をサポートする
○
ManagedConnectionインスタンスの再認証をサポートするかどうかを指定します。
指定できる値を次に示します。

true：再認証をサポートする

false：再認証をサポートしない

<reauthentication-support>
再認証をサポートする
</reauthentication-support>

（凡例）　○：必須

(5)　コネクション定義の一覧ページ

コネクション定義の一覧ページには，設定されたコネクション定義の一覧が表示されます。

コネクション定義の一覧ページを次に示します。

図21-43　コネクション定義の一覧ページ

表21-19　コネクション定義の一覧の表示項目

項目
説明
対応するタグ

Managed Connection Factory 実装クラス
javax.resource.spi.ManagedConnectionFactoryインタフェースを実装したクラスが表示されます。選択すると，コネクション定義のプロパティページが表示されます。
<managedconnectionfactory-class>
クラス名
</managedconnectionfactory-class>

コネクション定義識別子
リソースアダプタによってサポートされるConnectionFactoryインタフェースが表示されます。
<connectionfactory-interface>
コネクション定義識別子
</connectionfactory-interface>

Connection Factory実装クラス
ConnectionFactoryインタフェースを実装したクラスが表示されます。
<connectionfactory-impl-class>
クラス名
</connectionfactory-impl-class>

Connectionインターフェース
リソースアダプタによってサポートされるConnectionインタフェースが表示されます。
<connection-interface>
インタフェース名
</connection-interface>

Connection 実装クラス
Connectionインタフェースを実装したクラスが表示されます。
<connection-impl-class>
クラス名
</connection-impl-class>

(6)　コネクション定義のプロパティページ

コネクション定義のプロパティページを次に示します。

図21-44　コネクション定義のプロパティページ

表21-20　コネクション定義のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

Managed Connection Factory実装クラス
－
javax.resource.spi.ManagedConnectionFactoryインタフェースを実装したJavaクラス名が表示されます。
<managedconnectionfactory-class>
クラス名
</managedconnectionfactory-class>

コネクション定義識別子
－
リソースでサポートされるConnectionFactoryインタフェースのクラス名が表示されます。
<connectionfactory-interface>
コネクション定義識別子
</connectionfactory-interface>

Connection Factory実装クラス
－
ConnectionFactoryインタフェースを実装したJavaクラス名が表示されます。
<connectionfactory-impl-class>クラス名
</connectionfactory-impl-class>

Connectionインターフェース
－
リソースアダプタでサポートされるConnectionインタフェースのクラス名
<connection-interface>インタフェース名
</connection-interface>

Connection実装クラス
－
Connectionインタフェースを実装したJavaクラス名が表示されます。
<connection-impl-class>
クラス名
</connection-impl-class>

（凡例）　－：変更不可

(7)　コンフィグレーションプロパティの一覧ページ

コンフィグレーションプロパティの一覧ページには，設定されたコンフィグレーションのプロパティの一覧が表示されます。

コンフィグレーションプロパティの一覧ページを次に示します。

図21-45　コンフィグレーションプロパティの一覧ページ

表21-21　コンフィグレーションプロパティの一覧ページの表示項目

項目
説明
対応するタグ

コンフィグレーション・プロパティー名
コンフィグレーションプロパティ名が表示されます。選択すると，コンフィグレーションプロパティのプロパティページが表示されます。
<config-property-name>
コンフィグレーションプロパティ名
</config-property-name>

タイプ
コンフィグレーションプロパティのJavaタイプが表示されます。
<config-property-type>
タイプ
</config-property-type>

値
コンフィグレーションのプロパティに設定されている値が表示されます。※
<config-property-value>
値
</config-property-value>

注※　J2EEサーバから取得したConnector属性ファイルの「XAOpenString」に値が設定されている場合，一覧ではアスタリスク（「*」）が表示されます。

(8)　コンフィグレーションプロパティのプロパティページ（XAOpenString以外）

「XAOpenString」以外のコンフィグレーションプロパティのプロパティページについて説明します。「XAOpenString」のプロパティページについては，「(9)　コンフィグレーションプロパティのプロパティページ（XAOpenString）」を参照してください。

コンフィグレーションプロパティのプロパティページで，次の実装クラスのインスタンスに対するコンフィグレーションプロパティを設定します。

ResourceAdapter実装クラス

Managed Connection Factory実装クラス

「XAOpenString」以外のコンフィグレーションプロパティのプロパティページを次に示します。

図21-46　コンフィグレーションプロパティのプロパティページ（XAOpenString以外の場合）

表21-22　コンフィグレーションプロパティのプロパティページの設定項目（XAOpenString以外の場合）

項目
必須／任意
説明
対応するタグ

説明
×
コンフィグレーションプロパティについての説明が表示されます。
<description>
説明
</description>

コンフィグレーション・プロパティー名
○
コンフィグレーションプロパティ名が表示されます。※1
<config-property-name>
XAOpenString以外※2
</config-property-name>

コンフィグレーション・プロパティーのタイプ
○
コンフィグレーションプロパティのJavaタイプを指定します。
指定できる値を次に示します。※1

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

<config-property-type>
コンフィグレーションプロパティのタイプ
</config-property-type>

コンフィグレーション・プロパティーの値
×
コンフィグレーションプロパティの値が表示されます。※1
<config-property-value>
コンフィグレーションプロパティの値
</config-property-value>

（凡例）　○：必須　×：任意

注※1

指定できる値の詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.4　ResourceAdapterインスタンスに関するコンフィグレーションプロパティの定義」，「4.1.5　アウトバウンドリソースアダプタの定義」または「4.1.7　管理対象オブジェクトの定義」を参照してください。

注※2

「XAOpenString」以外のコンフィグレーションプロパティ名が表示されます。コンフィグレーションプロパティ名を「XAOpenString」に変更した場合，ページを再表示してください。XAOpenStringのコンフィグレーションプロパティのプロパティページが表示されます。XAOpenStringのコンフィグレーションプロパティのプロパティページについては，「(9)　コンフィグレーションプロパティのプロパティページ（XAOpenString）」を参照してください。

(9)　コンフィグレーションプロパティのプロパティページ（XAOpenString）

「XAOpenString」のコンフィグレーションプロパティのプロパティページについて説明します。「XAOpenString」以外のプロパティページについては，「(8)　コンフィグレーションプロパティのプロパティページ（XAOpenString以外）」を参照してください。

コンフィグレーションプロパティのプロパティページで，次の実装クラスのインスタンスに対するコンフィグレーションプロパティを設定します。

ResourceAdapter実装クラス

Managed Connection Factory実装クラス

「XAOpenString」のコンフィグレーションプロパティのプロパティページを次に示します。

図21-47　コンフィグレーションプロパティのプロパティページ（XAOpenStringの場合）

表21-23　コンフィグレーションプロパティのプロパティページの設定項目（XAOpenStringの場合）

項目
必須／任意
説明
対応するタグ

説明
×
コンフィグレーションプロパティについての説明が表示されます。
<description>
説明
</description>

コンフィグレーション・プロパティー名
○
コンフィグレーションプロパティ名（XAOpenString）が表示されます。※
<config-property-name>
XAOpenString
</config-property-name>

コンフィグレーション・プロパティーのタイプ
○
コンフィグレーションプロパティのJavaタイプ（java.lang.String）を指定します。
<config-property-type>
java.lang.String
</config-property-type>

コンフィグレーション・プロパティーの値
×
チェックボックスで，コンフィグレーションプロパティ（XAOpenString）の値を変更するかどうかを指定します。変更する場合，チェックボックスにチェックを入れて，入力フィールドにコンフィグレーションプロパティ（XAOpenString）の値を指定します。
<config-property-value>
XAOpenStringの値
</config-property-value>

（凡例）　○：必須　×：任意

注※　コンフィグレーションプロパティ名を「XAOpenString」から「XAOpenString」以外に変更した場合，ページを再表示してください。XAOpenString以外の場合のプロパティページが表示されます。「XAOpenString」以外のコンフィグレーションプロパティのプロパティページについては，「(8)　コンフィグレーションプロパティのプロパティページ（XAOpenString以外）」を参照してください。

J2EEサーバから取得したConnector属性ファイルの状態によって，コンフィグレーションプロパティ名（XAOpenString）の値は次のように表示されます。

Connector属性ファイルの状態
コンフィグレーションプロパティの値（<config-property-value）
チェックボックスのチェック
入力フィールド

コンフィグレーションプロパティの値が設定されていない
空タグ（<config-property-value></config-property-value>）
あり
入力可能。

コンフィグレーションプロパティの値が設定されている
<!--The config-property-value has already been set.-->
なし
入力不可。
アスタリスク（「*」）で表示。

チェックボックスのチェックを変更した場合，コンフィグレーションプロパティページの入力フィールドおよびConnector属性ファイルは次のように変更されます。

チェックボックスのチェック | コンフィグレーションプロパティページの入力フィールド | Connector属性ファイル
「なし」から「あり」に変更 | 入力フィールドが表示されます。 | 空タグ（<config-property-value></config-property-value>）が設定されます。
「あり」から「なし」に変更 | 入力フィールドが削除されます。 | <config-property-value>タグが削除されます。

(10)　プロパティのプロパティページ（Outboundリソースアダプタ）

Outboundリソースアダプタのプロパティのプロパティページを次に示します。

図21-48　プロパティのプロパティページ（Outboundリソースアダプタ）

表21-24　プロパティのプロパティページ（Outboundリソースアダプタ）の設定項目

項目
必須／任意
説明
対応するタグ

ユーザー名※1
×
チェックボックスでユーザ名を変更するかどうかを指定します。変更する場合，チェックを入れてユーザ名を指定します。※2
<property>
<property-name>
User
</property-name>
<property-type>
String
</property-type>
<property-value>
ユーザ名
</property-value>
</property>

パスワード※1
×
チェックボックスでパスワードを変更するかどうかを指定します。変更する場合，チェックを入れてパスワードを指定します。※2
<property>
<property-name>
Password
</property-name>
<property-type>
String
</property-type>
<property-value>
パスワード
</property-value>
</property>

コネクション・プールの最小値
×
コネクションプールの最小値を，「0」から「2147483647」の整数で指定します。ただし，［コネクション・プールの最大値］に指定した値以下の値を指定してください。
指定がない場合，「10」が仮定されます。
<property>
<property-name>
MinPoolSize
</property-name>
<property-type>
int
</property-type>
<property-value>
コネクションプールの最小値
</property-value>
</property>

コネクション・プールの最大値
×
コネクションプールの最大値を，「0」から「2147483647」の整数，または「-1」で指定します。「-1」を指定した場合，コネクションプールの最大値は無制限になります。
指定がない場合，「10」が仮定されます。
<property>
<property-name>
MaxPoolSize
</property-name>
<property-type>
int
</property-type>
<property-value>
コネクションプールの最大値
</property-value>
</property>

コネクションのチェック
×
リソースアダプタのコネクションをチェックするタイミングを選択します。

（空白）

コネクションのチェックをしない

コネクションの取得時にチェックする

一定の間隔でチェックする

（空白）は，「コネクションの取得時にチェックする」が仮定されます。
<property>
<property-name>
ValidationType
</property-name>
<property-type>
int
</property-type>
<property-value>
コネクションのチェック</property-value>
</property>

コネクションのチェック間隔
×
コネクションをチェックする間隔を，「1（秒）」から「2147483647（秒）」の整数で指定します。
指定がない場合，「3600」が仮定されます。
「コネクションのチェック」で「一定間隔でチェックする」を指定した場合にだけ指定できます。
<property>
<property-name>
ValidationInterval
</property-name>
<property-type>
int
</property-type>
<property-value>
コネクションのチェック間隔
</property-value>
</property>

コネクションを再取得する回数
×
コネクションの取得に失敗したときに，何回取得をやり直すのかを，「0（回）」から「2147483647（回）」の整数で指定します。
指定がない場合，「0」が仮定されます。
<property>
<property-name>
RetryCount
</property-name>
<property-type>
int
</property-type>
<property-value>
コネクションを再取得する回数
</property-value>
</property>

コネクションを再取得する間隔
×
コネクションの取得をやり直す間隔を，「1（秒）」から「2147483647I（秒）」の整数で指定します。
指定がない場合，「10」が仮定されます。
<property>
<property-name>
RetryInterval
</property-name>
<property-type>
int
</property-type>
<property-value>
コネクションを再取得する間隔
</property-value>
</property>

ログを出力する
×
LogWriterによるログ出力をするかどうかを指定します。
指定できる値を次に示します。

true：出力する

false：出力しない

指定がない場合，「true」が仮定されます。
<property>
<property-name>
LogEnabled
</property-name>
<property-type>
boolean
</property-type>
<property-value>
ログを出力する
</property-value>
</property>

（凡例）　×：任意

注※1　J2EEサーバから取得したConnector属性ファイルの状態によって，ユーザ名およびパスワードは次のように表示されます。

Connector属性ファイルの状態
プロパティの値（<property-value>）
チェックボックスのチェック
入力フィールド

ユーザ名およびパスワードが設定されていない
空タグ（<property-value></property-value>）
あり
入力可能。

ユーザ名およびパスワードが設定されている
<!--The property-value has already been set.-->
なし
入力不可。
アスタリスク（「*」）で表示。

注※2　チェックボックスのチェックを変更した場合，プロパティページの入力フィールドおよびConnector属性ファイルは次のように変更されます。

チェックボックスのチェック | プロパティページの入力フィールド | Connector属性ファイル
「なし」から「あり」に変更 | 入力フィールドが表示される | 空タグ（<property-value></property-value>）が設定される
「あり」から「なし」に変更 | 入力フィールドが削除される | <property-value>タグが削除される

(11)　リソース外部プロパティの一覧ページ

リソース外部プロパティの一覧ページを次に示します。

リソース外部プロパティの一覧ページには，設定されたリソース外部プロパティの一覧が表示されます。

図21-49　リソース外部プロパティの一覧ページ

表21-25　リソース外部プロパティの一覧ページの表示項目

項目
説明
対応するタグ

別名
リソースの別名が表示されます。選択すると，コンフィグレーションプロパティのプロパティページが表示されます。
<optional-name>
別名
</optional-name>

リソース認証方式
リソース外部プロパティに設定されている，リソース認証方式が表示されます。
<res-auth>
リソース認証方式
</res-auth>

リソース共有
リソース外部プロパティに設定されている，リソース接続を共有できるようにするかどうかどうかが表示されます。
<res-sharing-scope>
リソース共有
<res-sharing-scope>

(12)　リソース外部プロパティのプロパティページ

リソース外部プロパティのプロパティページを次に示します。

図21-50　リソース外部プロパティのプロパティページ

表21-26　リソース外部プロパティのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
リソース外部プロパティの説明を指定します。
<description>
説明
</description>

別名
○
リソースの別名を指定します。
最大255文字で指定してください。
指定できる文字は，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.），ハイフン（-），および区切り文字としてスラッシュ（/）です。ただし，予約語の「HITACHI_EJB」（大文字と小文字を区別する）で始まる文字列は指定できません。
名前の先頭や末尾にピリオドは使用できません。また，ピリオドだけの名前も使用できません。
指定値の前後に指定した空白，または改行は無視されます。
文字列の途中に空白，または改行を指定した場合，エラーになります。
<optional-name>
別名
</optional-name>

リソース認証方式
×
リソースを使用するための認証を，アプリケーションで行うか，コンテナで行うかを指定します。
指定できる値を次に示します。

「Application」：アプリケーションで認証する

「Container」：コンテナで認証する

<res-auth>
リソース認証方式
</res-auth>
<res-auth>
Application
</res-auth>
<res-auth>
Container
</res-auth>

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

「Shareable」：共有する

「Unshareable」：共有しない

指定がない場合，「Shareable」が仮定されます。
<res-sharing-scope>
リソース共有
<res-sharing-scope>
<res-sharing-scope>
Shareable
<res-sharing-scope>
<res-sharing-scope>
Unshareable
<res-sharing-scope>

（凡例）　○：必須　×：任意

(13)　メッセージリスナの一覧ページ

メッセージリスナの一覧ページには，設定されたメッセージリスナのプロパティの一覧が表示されます。

メッセージリスナの一覧ページを次に示します。

図21-51　メッセージリスナの一覧ページ

表21-27　メッセージリスナの一覧ページの表示項目

項目
説明
対応するタグ

メッセージ・リスナーのタイプ
メッセージリスナのタイプが表示されます。
<messagelistener-type>
メッセージリスナのタイプ
</messagelistener-type>

(14)　メッセージリスナのプロパティページ

メッセージリスナのプロパティページを次に示します。

図21-52　メッセージリスナのプロパティページ

表21-28　メッセージリスナのプロパティページの表示項目

項目
説明
対応するタグ

メッセージ・リスナーのタイプ
メッセージリスナのタイプが表示されます。
<messagelistener-type>
メッセージリスナのタイプ
</messagelistener-type>

(15)　ActivationSpecのプロパティページ

ActivationSpecのプロパティページを次に示します。

図21-53　ActivationSpecのプロパティページ

表21-29　ActivationSpecのプロパティページの表示項目

項目
説明
対応するタグ

アクティベーション・スペック実装クラス
ActivationSpecのインタフェースを実装するクラスが表示されます。
<activationspec-class>
ActivationSpecのインタフェースを実装するクラス
</activationspec-class>

(16)　必須コンフィグレーションプロパティの一覧ページ

必須コンフィグレーションプロパティの一覧ページを次に示します。

図21-54　必須コンフィグレーションプロパティの一覧ページ

表21-30　必須コンフィグレーションプロパティの一覧ページの表示項目

項目
説明
対応するタグ

必須コンフィグレーション・プロパティー名
必須コンフィグレーションプロパティ名が表示されます。
<config-property-name>
必須コンフィグレーションプロパティ名
</config-property-name>

(17)　必須コンフィグレーションプロパティのプロパティページ

必須コンフィグレーションプロパティのプロパティページを次に示します。

図21-55　必須コンフィグレーションプロパティのプロパティページ

表21-31　必須コンフィグレーションプロパティのプロパティページの表示項目

項目
説明
対応するタグ

説明
必須コンフィグレーションプロパティの説明が表示されます。
<description>
説明
</description>

必須コンフィグレーション・プロパティー名
必須コンフィグレーションプロパティ名が表示されます。
<config-property-name>
必須コンフィグレーションプロパティ名
</config-property-name>

(18)　管理対象オブジェクトの一覧ページ

管理対象オブジェクトの一覧ページを次に示します。

図21-56　管理対象オブジェクトの一覧ページ

表21-32　管理対象オブジェクトの一覧ページの表示項目

項目
説明
対応するタグ

管理対象オブジェクト名
管理対象オブジェクト名が表示されます。
<adminobject-name>
管理対象オブジェクト名
</adminobject-name>

管理対象オブジェクト実装インターフェース
管理対象オブジェクトを実装するインタフェースが表示されます。
<adminobject-interface>
管理対象オブジェクト実装インタフェース
</adminobject-interface>

管理対象オブジェクト実装クラス
管理対象オブジェクトを実装するクラスが表示されます。
<adminobject-class>
管理対象オブジェクト実装クラス
</adminobject-class>

(19)　管理対象オブジェクトのプロパティページ

管理対象オブジェクトのプロパティページを次に示します。

図21-57　管理対象オブジェクトのプロパティページ

表21-33　管理対象オブジェクトのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

管理対象オブジェクト名
×
管理対象オブジェクト名を指定します。リソースアダプタ内で一意な名称を指定します。
指定できる文字は，英数字（0～9，A～Z，a～z），およびアンダースコア（_）です。
<adminobject-name>
管理対象オブジェクト名
</adminobject-name>

管理対象オブジェクト実装インターフェース
○
管理対象オブジェクトを実装するインタフェースを指定します。
コンボボックスには，次のインタフェースが表示されます。

javax.jms.Queue

javax.jms.Topic

<adminobject-interface>
管理対象オブジェクト実装インタフェース
</adminobject-interface>

<adminobject-interface>
javax.jms.Queue
</adminobject-interface>

<adminobject-interface>
javax.jms.Topic
</adminobject-interface>

管理対象オブジェクト実装クラス
○
管理対象オブジェクトを実装するクラスを指定します。
<adminobject-class>
管理対象オブジェクト実装クラス
</adminobject-class>

（凡例）　○：必須　×：任意

(20)　プロパティのプロパティページ（リソースアダプタ）

リソースアダプタのプロパティのプロパティページを次に示します。

図21-58　プロパティのプロパティページ（リソースアダプタ）

表21-34　プロパティのプロパティページ（リソースアダプタ）の設定項目

項目
必須／任意
説明
対応するタグ

スレッド・プールの最小スレッド数
×
スレッドプールの最小スレッド数を「0」から「1024」の整数で指定します。指定がない場合，「0」が仮定されます。
<property>
<property-name>
MinTPoolSize
</property-name>
<property-type>
int
</property-type>
<property-value>
スレッドプールの最小スレッド数
</property-value>
</property>

スレッド・プールの最大スレッド数
×
スレッドプールで同時に実行される最大スレッド数を「1」から「2147483647」の整数で指定します。指定がない場合，「10」が仮定されます。
<property>
<property-name>
MaxTPoolSize
</property-name>
<property-type>
int
</property-type>
<property-value>
スレッドプールの最大スレッド数
</property-value>
</property>

スレッド・プールのタイムアウト値
×
スレッドプールのスレッド解放までのタイムアウト値（秒）を「1」から「2147483647」の整数で指定します。指定がない場合，「300」が仮定されます。
<property>
<property-name>
TPoolKeepalive
</property-name>
<property-type>
int
</property-type>
<property-value>
スレッドプールのタイムアウト値
</property-value>
</property>

（凡例）　×：任意

21.3　J2EEアプリケーションの属性編集画面

ここでは，J2EEアプリケーションの属性編集画面について説明します。

J2EEアプリケーションの属性編集画面は，次の手順で表示します。

［サーバー・エクスプローラー］ビューで［J2EEアプリケーション］フォルダ内のJ2EEアプリケーションを選択します。

属性ファイル編集エディタを起動します。
属性ファイル編集エディタを起動する方法については，「21.1.14　プロパティの設定」を参照してください。属性ファイル編集エディタが起動されると，パースペクティブのエディタエリアに，アプリケーション統合属性ファイルのフォームページが表示されます。

図21-59　アプリケーション統合属性ファイルのフォームページ

アプリケーション統合属性ファイルのフォームタブで属性ファイルの種別を分けて，各ページが表示されています。アプリケーション統合属性ファイル（<hitachi-application-all-property>）のフォームページの種別を次に示します。

表21-35　アプリケーション統合属性ファイルのフォームページの種別

フォームタブ | 属性 | 対応するタグ名 | 参照先
アプリケーション属性 | アプリケーション属性 | <hitachi-application-property> | 21.4
EJB-JAR | － | <ejb-jar> | －
EJB-JAR属性 | <hitachi-ejb-jar-property> | 21.5
Session Bean属性 | <hitachi-session-bean-property> | 21.6
Entity Bean属性 | <hitachi-entity-bean-property> | 21.7
Message-driven Bean属性 | <hitachi-message-bean-property> | 21.8
WAR | － | <war> | －
WAR属性 | <hitachi-war-property> | 21.9
フィルタ属性 | <hitachi-filter-property> | 21.10
サーブレット属性 | <hitachi-servlet-property> | 21.11
RAR | － | <rar> | －
Connector属性 | <hitachi-Connector-property> | 21.12

（凡例）　－：該当なし

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

アプリケーション統合属性ファイルの［アプリケーション属性］タブを選択すると，［アプリケーション属性］フォームページが表示されます。

図21-60　［アプリケーション属性］フォームページ例

フォームページの［エレメント］の下に，アプリケーション属性の構成のツリーが展開されます。

＜この節の構成＞

21.4.1　アプリケーション属性のツリー

21.4.2　アプリケーション属性設定ページ

21.4.1　アプリケーション属性のツリー

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。エディタエリアの［エレメント］に，編集するアプリケーション属性の構成がツリー形式で表示されます。

アプリケーション属性のツリー構成を次に示します。

[図データ]＜アプリケーション属性名＞
　│
　├アイコン
　│
　├セキュリティー
　│
　└CTM連携

アプリケーション属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。アプリケーション属性のツリーノードとコンテキストメニューについて，次に説明します。

＜この項の構成＞

(1)　アプリケーション属性のツリーノード

(2)　コンテキストメニュー操作

(1)　アプリケーション属性のツリーノード

アプリケーション属性のツリービューに表示されるノードを次に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。

表21-36　アプリケーション属性ファイルのツリーのノード

ノード
説明
対応するタグ名
プロパティページ

＜アプリケーション属性名＞
アプリケーション属性を示すノードです。
選択すると，アプリケーションのプロパティページが表示されます。
アプリケーション属性がない場合，「アプリケーション属性はありません」が表示されます。
<hitachi-application-property>
21.4.2　(1)

アイコン
GUIツール上に表示されるEARのアイコンの定義を示すノードです。
選択すると，アイコンのプロパティページが表示されます。
<icon>
21.4.2　(2)

セキュリティー
セキュリティの管理情報を示すノードです。
選択すると，セキュリティのプロパティページが表示されます。
<security-prop>
21.4.2　(3)

CTM連携
CTM連携の設定情報を示すノードです。
選択すると，CTM連携のプロパティページが表示されます。
<scheduling>
21.4.2　(4)

(2)　コンテキストメニュー操作

アプリケーション属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-37　アプリケーション属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

＜アプリケーション属性名＞
［追加］ - ［アイコン］
アプリケーション属性にアイコンが追加されます。選択すると，アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.4.2　(2)

［追加］ - ［CTM連携］
アプリケーション属性にCTM連携が追加されます。選択すると，CTM連携のプロパティページが表示されます。すでにCTM連携がある場合は選択できません。
21.4.2　(4)

アイコン
［削除］
アプリケーション属性から，アイコンが削除されます。
－

CTM連携
［削除］
アプリケーション属性から，CTM連携が削除されます。
－

（凡例）　－：該当なし

21.4.2　アプリケーション属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されます。［エレメントの詳細］に，編集するアプリケーション属性のプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアに，選択したノードに対応するプロパティページが表示されます。

アプリケーション属性には，次のプロパティページがあります。

アプリケーションのプロパティページ

アイコンのプロパティページ

セキュリティのプロパティページ

CTM連携のプロパティページ

注意事項

プロパティページで，設定が必須の項目には「*」が付与されています。

＜この項の構成＞

(1)　アプリケーションのプロパティページ

(2)　アイコンのプロパティページ

(3)　セキュリティのプロパティページ

(4)　CTM連携のプロパティページ

(1)　アプリケーションのプロパティページ

アプリケーションのプロパティページを次に示します。

図21-61　アプリケーションのプロパティページ

表21-38　アプリケーションのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
アプリケーションの説明を指定します。
<description>
説明
</description>

ルックアップ名
－
アプリケーションのルックアップ名が表示されます。
<lookup-name>
ルックアップ名
</lookup-name>

ライブラリーJARの格納ディレクトリー
－
ライブラリJARを格納するディレクトリ名が表示されます。
<library-directory>
ライブラリJARの格納ディレクトリ
</library-directory>

開始・停止順
×
アプリケーションの開始および停止の順序を，「0」から「2147483647」の整数で指定してください。
指定がない場合，「10」が仮定されます。
<start-order>
開始・停止順
</start-order>

CTM と連携する
○
CTMとの連携をするかどうかを指定してください。指定できる値を次に示します。

「true」：CTMと連携する

「false」：CTMと連携しない

<managed-by-ctm>
CTMと連携する
</managed-by-ctm>

（凡例）　○：必須　×：任意　－：変更不可

(2)　アイコンのプロパティページ

各属性ファイルの<icon>タグで囲まれたアイコンのプロパティを設定する共通のプロパティページを次に示します。

図21-62　アイコンのプロパティページ

表21-39　アイコンのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

スモール・アイコン
×
サイズが16×16ピクセル以下のアイコン(GIFファイルまたはJPGファイル)を指定します。
<small-icon>
スモールアイコン
</small-icon>

ラージ・アイコン
×
サイズが32×32ピクセル以下のアイコン(GIFファイルまたはJPGファイル)を指定します。
<large-icon>
ラージアイコン
</large-icon>

（凡例）　×：任意

(3)　セキュリティのプロパティページ

セキュリティのプロパティページを次に示します。

図21-63　セキュリティのプロパティページ

表21-40　セキュリティのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

セキュリティーの管理方法
－
セキュリティの管理方法が表示されます。
<security-method>
セキュリティの管理方法
<security-method>

デフォルト・セキュリティー・ロール
－
セキュリティの管理方法に「map_methods_without_roles」が指定されている場合のデフォルトのセキュリティロールが表示されます。
<default-security-role>
デフォルトセキュリティロール
</default-security-role>

（凡例）　－：変更不可

(4)　CTM連携のプロパティページ

CTM連携のプロパティページを次に示します。

図21-64　CTM連携のプロパティページ

表21-41　CTM連携のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

キュー名
○
スケジューリングをするキューの名称を指定します。CTM連携の追加で，CTM連携のプロパティページが表示された場合，初期値としてアプリケーションの表示名が設定されています。
不活性の場合も，指定されている値がそのまま表示されます。
<queue-name>
キュー名
</queue-name>

スレッド数
○
CTMがアプリケーションを呼び出すために用意するスレッド数を，「1」から「127」の範囲で指定します。CTM連携の追加で，CTM連携のプロパティページが表示された場合，初期値として「1」が設定されています。
不活性の場合も，指定されている値がそのまま表示されます。
<parallel-count>
スレッド数
</parallel-count>

（凡例）　○：必須

21.5　アプリケーション統合属性ファイル（EJB-JAR属性）

アプリケーション統合属性ファイルの［EJB-JAR］タブを選択すると，［EJB-JAR］フォームページが表示されます。

図21-65　［EJB-JAR］フォームページ例

フォームページの［エレメント］の下に，EJB-JARの構成によって，次のツリーが展開されます。

EJB-JAR属性
＜EJB-JAR属性名＞を選択すると，EJB-JAR属性のツリーが表示されます。EJB-JAR属性のツリーとプロパティの設定項目については，この節で説明しています。

Session Bean属性
＜Session Bean属性名＞を選択すると，Session Bean属性のツリーが表示されます。Session Bean属性のツリーとプロパティの設定項目については，「21.6　アプリケーション統合属性ファイル（Session Bean属性）」を参照してください。

Entity Bean属性
＜Entity Bean属性名＞を選択すると，Entity Bean属性のツリーが表示されます。Entity Bean属性のツリーとプロパティの設定項目については，「21.7　アプリケーション統合属性ファイル（Entity Bean属性）」を参照してください。

Message-driven Bean属性
＜Message-driven Bean属性名＞を選択すると，Message-driven Bean属性のツリーが表示されます。Message-driven Bean属性のツリーとプロパティの設定項目については，「21.8　アプリケーション統合属性ファイル（Message-driven Bean属性）」を参照してください。

＜この節の構成＞

21.5.1　EJB-JAR属性のツリー

21.5.2　EJB-JAR属性設定ページ

21.5.1　EJB-JAR属性のツリー

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。エディタエリアの［エレメント］に，編集するEJB-JAR属性ファイルの構成がツリー形式で表示されます。

EJB-JAR属性のツリー構成を次に示します。

[図データ]＜EJB-JAR属性名＞
　│
　├アイコン

　│
　└─[図データ]インターセプター連携
　　　└─＜インターセプタ連携＞
　　　　└─[図データ]インターセプター・クラス名
　　　　　　└─＜インターセプタクラス名＞

EJB-JAR属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。EJB-JAR属性のツリーノードとコンテキストメニューについて，次に説明します。

＜この項の構成＞

(1)　EJB-JAR属性のツリーノード

(2)　コンテキストメニュー操作

(1)　EJB-JAR属性のツリーノード

EJB-JAR属性のツリービューに表示されるノードを次に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。

表21-42　EJB-JAR属性ファイルのツリーのノード

ノード
説明
対応するタグ名
プロパティページ

＜EJB-JAR属性名＞
EJB-JAR属性を示すノードです。
選択すると，EJB-JAR属性のプロパティページが表示されます。
EJB-JAR属性がない場合，「EJB-JARはありません」が表示されます。
<hitachi-ejb-jar-property>
21.5.2　(1)

アイコン
アイコンを示すノードです。
選択すると，アイコンのプロパティページが表示されます。
<icon>
21.4.2　(2)

インターセプター連携
インターセプタ連携をまとめるノードです。インターセプタ連携は，クラスレベル・インターセプタおよびメソッドレベル・インターセプタに関する設定を表します。
選択すると，インターセプタ連携の一覧ページが表示されます。
－
21.5.2　(3)

＜インターセプタ連携＞
インターセプタ連携を示すノードです。
選択すると，インターセプタ連携のプロパティページが表示されます。
<interceptor-binding>
21.5.2　(4)

インターセプター・クラス名
インターセプタクラス名をまとめるノードです。
選択すると，インターセプタクラス名の一覧ページが表示されます。
－
21.5.2　(5)

＜インターセプタクラス名＞
インターセプタクラス名を示すノードです。
選択すると，インターセプタクラス名のプロパティページが表示されます。
<interceptor-class>
21.5.2　(6)

(2)　コンテキストメニュー操作

EJB-JAR属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-43　EJB-JAR属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

＜EJB-JAR属性名＞
［追加］ - ［アイコン］
EJB-JAR属性にアイコンが追加されます。アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.4.2　(2)

［追加］ - ［インターセプター連携］
インターセプタ連携が追加されます。インターセプタ連携のプロパティページが表示されます。
21.5.2　(4)

アイコン
［削除］
EJB-JAR属性からアイコンが削除されます。
－

インターセプター連携
［追加］ - ［インターセプター連携］
インターセプタ連携が追加されます。インターセプタ連携のプロパティページが表示されます。
21.5.2　(4)

［削除］
選択しているノードが削除されます。
<ejb-name>要素がワイルドカード（*）以外の場合，不活性となり削除できません。
－

＜インターセプタ連携＞
［追加］ - ［インターセプター・クラス名］
インターセプタクラス名が追加されます。インターセプタクラス名のプロパティページが表示されます。
<ejb-name>要素がワイルドカード（*）以外の場合，不活性となり追加できません。
21.5.2　(6)

［削除］
選択しているノードが削除されます。
<ejb-name>要素がワイルドカード（*）以外の場合，不活性となり削除できません。
－

インターセプター・クラス名
［追加］ - ［インターセプター・クラス名］
インターセプタクラス名が追加されます。インターセプタクラス名のプロパティページが表示されます。
<ejb-name>要素がワイルドカード（*）以外の場合，不活性となり追加できません。
21.5.2　(6)

［削除］
選択しているノードが削除されます。
<ejb-name>要素がワイルドカード（*）以外の場合，不活性となり削除できません。
－

＜インターセプタクラス名＞
［削除］
選択しているノードが削除されます。
－

21.5.2　EJB-JAR属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。［エレメントの詳細］に編集するEJB-JAR属性ファイルのプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアの表示が切り替わります。

EJB-JAR属性ファイルには，次のプロパティページがあります。

EJB-JARのプロパティページ

アイコンのプロパティページ

インターセプタ連携の一覧ページ

インターセプタ連携のプロパティページ

インターセプタクラス名の一覧ページ

インターセプタクラス名のプロパティページ

＜この項の構成＞

(1)　EJB-JARのプロパティページ

(2)　アイコンのプロパティページ

(3)　インターセプタ連携の一覧ページ

(4)　インターセプタ連携のプロパティページ

(5)　インターセプタクラス名の一覧ページ

(6)　インターセプタクラス名のプロパティページ

(1)　EJB-JARのプロパティページ

EJB-JARのプロパティページを次に示します。

図21-66　EJB-JARのプロパティページ

表21-44　EJB-JARのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

表示名
－
EJB-JARに設定した表示名が表示されます。
<display-name>
表示名
</display-name>

クライアントJARファイル
－
クライアントJARファイル名が表示されます。
<ejb-client-jar>
クライアントJARファイル
</ejb-client-jar>

（凡例）　×：任意　－：変更不可

(2)　アイコンのプロパティページ

アイコンのプロパティページの詳細については，「21.4.2　アプリケーション属性設定ページ」の「(2)　アイコンのプロパティページ」を参照してください。

(3)　インターセプタ連携の一覧ページ

インターセプタ連携の一覧ページを次に示します。

図21-67　インターセプタ連携の一覧ページ

表21-45　インターセプタ連携の一覧ページの表示項目

項目
説明
対応するタグ

EJB名
インターセプタ連携のEJB名が表示されます。
<ejb-name>
EJB名
</ejb-name>

(4)　インターセプタ連携のプロパティページ

インターセプタ連携のプロパティページを次に示します。

図21-68　インターセプタ連携のプロパティページ

表21-46　インターセプタ連携のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
インターセプタ連携のEJB名の説明を指定します。
EJB名がワイルドカード（*）以外の場合，説明は指定できません。
<description>
説明
</description>

EJB名
－
インターセプタ連携のEJB名が表示されます。
<ejb-name>
EJB名
</ejb-name>

（凡例）　×：任意　－：変更不可

(5)　インターセプタクラス名の一覧ページ

インターセプタクラス名の一覧ページを次に示します。

図21-69　インターセプタクラス名の一覧ページ

表21-47　インターセプタクラス名の一覧ページの表示項目

項目
説明
対応するタグ

インターセプター・クラス名
インターセプタ連携のクラス名が表示されます。
<interceptor-class>
インターセプタクラス名
</interceptor-class>

(6)　インターセプタクラス名のプロパティページ

インターセプタクラス名のプロパティページを次に示します。

図21-70　インターセプタクラス名のプロパティページ

表21-48　インターセプタクラス名のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

インターセプター・クラス名
×
インターセプタ連携のクラス名を指定します。
EJB名がワイルドカード（*）以外の場合，クラス名は指定できません。
<interceptor-class>
インターセプタクラス名
</interceptor-class>

（凡例）　×：任意

21.6　アプリケーション統合属性ファイル（Session Bean属性）

アプリケーション統合属性ファイルの［EJB-JAR］タブを選択すると，［EJB-JAR］フォームページが表示されます。［EJB-JAR］フォームページの［エレメント］に表示されている，［＜Session Bean属性名＞］を選択して，Session Bean属性のツリーを表示します。

＜この節の構成＞

21.6.1　Session Bean属性のツリー

21.6.2　Session Bean属性設定ページ

21.6.1　Session Bean属性のツリー

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。エディタエリアの［エレメント］に，編集するSession Bean属性ファイルの構成がツリー形式で表示されます。

Session Bean属性のツリー構成を次に示します。

[図データ]＜Session Bean属性名＞
　│
　├─アイコン
　│
　├─[図データ]環境エントリー
　│　　└─＜環境エントリ名＞
　│
　├─[図データ]リモートEJBへの参照
　│　　└─＜リモートEJBへの参照名＞
　│
　├─[図データ]ローカルEJBへの参照
　│　　└─＜ローカルEJBへの参照名＞
　│
　├─[図データ]リソース参照
　│　　└─＜リソース参照名＞
　│
　├─[図データ]リソース環境変数
　│　　└─＜リソース環境変数名＞
　│　　　　├─リンク先キュー
　│　　　　└─リンク先の管理対象オブジェクト
　│
　├─[図データ]コンテナー・トランザクション
　│　　└─＜トランザクション属性＞
　│　　　　└─[図データ]メソッド
　│　　　　　　└─＜メソッド名＞
　│　　　　　　　　└─メソッド・パラメーター
　│　　　　　　　　　　└─＜パラメタのデータ型＞
　│
　└─ランタイム
　　　　├─ステートレス・セッション・ビーン
　　　　├─ステートフル・セッション・ビーン
　　　　└─CTM連携

Session Bean属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。Session Bean属性のツリーノードとコンテキストメニューについて，次に説明します。

＜この項の構成＞

(1)　Session Bean属性のツリーノード

(2)　コンテキストメニュー操作

(1)　Session Bean属性のツリーノード

Session Bean属性のツリービューに表示されるノードを次に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。

表21-49　Session Bean属性ファイルのツリーのノード

ノード
説明
対応するタグ名
プロパティページ

＜Session Bean属性名＞
Session Beanの属性を示すノードです。選択すると，Session Beanのプロパティページが表示されます。
<hitachi-session-bean-property>
21.6.2　(1)

アイコン
アイコンを示すノードです。選択すると，アイコンのプロパティページが表示されます。
<icon>
21.4.2　(2)

環境エントリー
環境エントリをまとめるノードです。
選択すると，環境エントリの一覧ページが表示されます。
－
21.6.2　(3)

＜環境エントリ名＞
環境エントリを示すノードです。選択すると，環境エントリのプロパティページが表示されます。
<env-entry>
21.6.2　(4)

リモートEJBへの参照
リモートEJBへの参照をまとめるノードです。
選択すると，リモートEJBへの参照の一覧ページが表示されます。
－
21.6.2　(5)

＜リモートEJBへの参照名＞
リモートEJBへの参照を示すノードです。
選択すると，リモートEJBへの参照のプロパティページが表示されます。
<ejb-ref>
21.6.2　(6)

ローカルEJBへの参照
ローカルEJBへの参照をまとめるノードです。
選択すると，ローカルEJBへの参照の一覧ページが表示されます。
－
21.6.2　(7)

＜ローカルEJBへの参照名＞
ローカルEJBへの参照を示すノードです。
選択すると，ローカルEJBへの参照のプロパティページが表示されます。
<ejb-local-ref>
21.6.2　(8)

リソース参照
リソース参照をまとめるノードです。
選択すると，リソース参照の一覧ページが表示されます。
－
21.6.2　(9)

＜リソース参照名＞
リソース参照を示すノードです。
選択すると，リソース参照のプロパティページが表示されます。
<resource-ref>
21.6.2　(10)

リソース環境変数
リソース環境変数をまとめるノードです。
選択すると，リソース環境変数の一覧ページが表示されます。
－
21.6.2　(11)

＜リソース環境変数名＞
リソース環境変数名を示すノードです。
選択すると，リソース環境変数のプロパティページが表示されます。
<resource-env-ref>
21.6.2　(12)

リンク先キュー
リンク先キューを示すノードです。
選択すると，リンク先キューのプロパティページが表示されます。
<linked-queue>
21.6.2　(13)

リンク先の管理対象オブジェクト
リンク先の管理対象オブジェクトを示すノードです。
選択すると，リンク先の管理対象オブジェクトのプロパティページが表示されます。
<linked-adminobject>
21.6.2　(14)

コンテナー・トランザクション
コンテナトランザクションをまとめるノードです。
選択すると，コンテナトランザクションの一覧ページが表示されます。
－
21.6.2　(15)

＜トランザクション属性＞
コンテナトランザクションを示すノードです。
選択すると，コンテナトランザクションのプロパティページが表示されます。
<container-transaction>
21.6.2　(16)

メソッド
メソッドをまとめるノードです。
選択すると，メソッドの一覧ページが表示されます。
－
21.6.2　(17)

＜メソッド名＞
メソッドを示すノードです。
選択すると，メソッドのプロパティページが表示されます。
<method>
21.6.2　(18)

メソッド・パラメーター
メソッドパラメタを表します。
選択すると，メソッドパラメタの一覧ページが表示されます。
<method-params>
21.6.2　(19)

＜パラメタのデータ型＞
パラメタのデータ型を示すノードです。
選択すると，パラメタのデータ型プロパティページが表示されます。
<method-param>
21.6.2　(20)

ランタイム
ランタイムを示すノードです。
選択すると，ランタイムのプロパティページが表示されます。
<session-runtime>
21.6.2　(21)

ステートレス・セッション・ビーン
Stateless Session Beanを示すノードです。
選択すると，Stateless Session Beanのプロパティページが表示されます。
<stateless>
21.6.2　(22)

ステートフル・セッション・ビーン
Stateful Session Beanを示すノードです。
選択すると，Stateful Session Beanのプロパティページが表示されます。
<stateful>
21.6.2　(23)

CTM連携
CTM連携を示すノードです。
選択すると，CTM連携のプロパティページが表示されます。
<scheduling>
21.6.2　(24)

（凡例）　－：該当なし

(2)　コンテキストメニュー操作

Session Bean属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-50　Session Bean属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

＜Session Bean属性名＞
［追加］ - ［アイコン］
アイコンが追加されます。アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.4.2　(2)

［追加］ - ［環境エントリー］
環境エントリが追加されます。環境エントリのプロパティページが表示されます。
21.6.2　(4)

［追加］ - ［リモートEJBへの参照］
リモートEJBへの参照が追加されます。リモートEJBへの参照のプロパティページが表示されます。
21.6.2　(6)

［追加］ - ［ローカルEJBへの参照］
ローカルEJBへの参照が追加されます。ローカルEJBへの参照のプロパティページが表示されます。
21.6.2　(8)

［追加］ - ［リソース参照］
リソース参照が追加されます。リソース参照のプロパティページが表示されます。
21.6.2　(10)

［追加］ - ［リソース環境変数］
リソース環境変数が追加されます。リソース環境変数のプロパティページが表示されます。
21.6.2　(12)

［追加］ - ［コンテナー・トランザクション］
コンテナトランザクションが追加されます。コンテナトランザクションのプロパティページが表示されます。
21.6.2　(16)

アイコン
［削除］
選択しているノードが削除されます。
－

環境エントリー
［追加］ - ［環境エントリー］
環境エントリが追加されます。環境エントリのプロパティページが表示されます。
21.6.2　(4)

［削除］
環境エントリがすべて削除されます。
－

＜環境エントリー名＞
［削除］
選択しているノードが削除されます。
－

リモートEJBへの参照
［追加］ - ［リモートEJBへの参照］
「リモートEJBへの参照」が追加されます。
リモートEJBへの参照のプロパティページが表示されます。
21.6.2　(6)

［削除］
リモートEJBへの参照がすべて削除されます。
－

＜リモートEJBへの参照名＞
［削除］
選択しているノードが削除されます。
－

ローカルEJBへの参照
［追加］ - ［ローカルEJBへの参照］
「ローカルEJBへの参照」が追加されます。
ローカルEJBへの参照のプロパティページが表示されます。
21.6.2　(8)

［削除］
ローカルEJBへの参照がすべて削除されます。
－

＜ローカルEJBへの参照名＞
［削除］
選択しているノードが削除されます。
－

リソース参照
［追加］ - ［リソース参照］
リソース参照が追加されます。
リソース参照のプロパティページが表示されます。
21.6.2　(10)

［削除］
リソース参照がすべて削除されます。
－

＜リソース参照名＞
［削除］
選択しているノードが削除されます。
－

リソース環境変数
［追加］ - ［リソース環境変数］
リソース環境変数が追加されます。
リソース環境変数のプロパティページが表示されます。
21.6.2　(12)

［削除］
リソース環境変数がすべて削除されます。
－

＜リソース環境変数＞
［追加］ - ［リンク先キュー］
リソース環境変数にリンク先キューが追加されます。
リンク先キューのプロパティページが表示されます。
21.6.2　(13)

［追加］ - ［リンク先の管理対象オブジェクト］
リソース環境変数にリンク先の管理対象オブジェクトが追加されます。
リンク先の管理対象オブジェクトのプロパティページが表示されます。
21.6.2　(14)

［削除］
選択しているノードが削除されます。
－

リンク先キュー
［削除］
選択しているノードが削除されます。
－

リンク先の管理対象オブジェクト
［削除］
選択しているノードが削除されます。
－

コンテナー・トランザクション
［追加］ - ［コンテナー・トランザクション］
コンテナトランザクションが追加されます。
コンテナトランザクションのプロパティページが表示されます。
21.6.2　(16)

［削除］
コンテナトランザクションがすべて削除されます。
－

＜コンテナトランザクション＞
［追加］ - ［メソッド］
メソッドが追加されます。
メソッドのプロパティページが表示されます。
21.6.2　(18)

［削除］
選択しているノードが削除されます。
－

メソッド
［追加］ - ［メソッド］
「メソッド」が追加されます。
メソッドのプロパティページが表示されます。
21.6.2　(18)

＜メソッド名＞
［追加］ - ［メソッド・パラメーター］
［メソッド］にメソッドパラメタが追加されます。
［メソッド・パラメーター］のノードが作成され，メソッドパラメタの一覧ページが表示されます。
すでにメソッドパラメタがある場合は選択できません。
21.6.2　(19)

［削除］
選択しているノードが削除されます。
－

メソッド・パラメーター
［追加］ - ［パラメーターのデータ型］
メソッドパラメタにパラメタのデータ型が追加されます。
パラメタのデータ型プロパティページが表示されます。
21.6.2　(20)

［削除］
選択しているノードが削除されます。
－

＜パラメタのデータ型＞
［削除］
選択しているノードが削除されます。
－

ランタイム
［追加］ - ［CTM連携］
ランタイムにCTM連携が追加されます。
CTM連携のプロパティページが表示されます。
すでにCTM連携がある場合は選択できません。
21.6.2　(24)

ステートレス・セッション・ビーン
－
－
－

ステートフル・セッション・ビーン
－
－
－

CTM連携
［削除］
選択しているノードが削除されます。
－

（凡例）　－：該当なし

21.6.2　Session Bean属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。［エレメントの詳細］に編集するSession Bean属性ファイルのプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアの表示が切り替わります。

Session Bean属性ファイルには，次のプロパティページがあります。

Session Beanのプロパティページ

アイコンのプロパティページ

環境エントリの一覧ページ

環境エントリのプロパティページ

リモートEJBへの参照の一覧ページ

リモートEJBへの参照のプロパティページ

ローカルEJBへの参照の一覧ページ

ローカルEJBへの参照のプロパティページ

リソース参照の一覧ページ

リソース参照のプロパティページ

リソース環境変数の一覧ページ

リソース環境変数のプロパティページ

リンク先キューのプロパティページ

リンク先の管理対象オブジェクトのプロパティページ

コンテナトランザクションの一覧ページ

コンテナトランザクションのプロパティページ

メソッドの一覧ページ

メソッドのプロパティページ

メソッドパラメタの一覧ページ

パラメタのデータ型プロパティページ

ランタイムのプロパティページ

Stateless Session Beanのプロパティページ

Stateful Session Beanのプロパティページ

CTM連携のプロパティページ

注意事項

プロパティページで，設定が必須の項目には「*」が付与されています。

＜この項の構成＞

(1)　Session Beanのプロパティページ

(2)　アイコンのプロパティページ

(3)　環境エントリの一覧のページ

(4)　環境エントリのプロパティページ

(5)　リモートEJBへの参照の一覧ページ

(6)　リモートEJBへの参照のプロパティページ

(7)　ローカルEJBへの参照の一覧ページ

(8)　ローカルEJBへの参照のプロパティページ

(9)　リソース参照の一覧ページ

(10)　リソース参照のプロパティページ

(11)　リソース環境変数の一覧ページ

(12)　リソース環境変数のプロパティページ

(13)　リンク先キューのプロパティページ

(14)　リンク先の管理対象オブジェクトのプロパティページ

(15)　コンテナトランザクションの一覧ページ

(16)　コンテナトランザクションのプロパティページ

(17)　メソッドの一覧ページ

(18)　メソッドのプロパティページ

(19)　メソッドパラメタの一覧ページ

(20)　パラメタのデータ型プロパティページ

(21)　ランタイムのプロパティページ

(22)　Stateless Session Beanのプロパティページ

(23)　Stateful Session Beanのプロパティページ

(24)　CTM連携のプロパティページ

(1)　Session Beanのプロパティページ

Session Beanのプロパティページを次に示します。

図21-71　Session Beanのプロパティページ

表21-51　Session Beanのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
Session Bean属性の説明を指定します。
<description>
説明
</description>

表示名
－
Session Bean属性の表示名が表示されます。
<display-name>
表示名
</display-name>

対応するエンタープライズ・ビーンの別名
－
対応するEnterprise Beanの別名が表示されます。
<mapped-name>
対応するEnterprise Beanの別名
</mapped-name>

セッション種別
－
セッション種別が表示されます。
セッション種別がStateful Session Beanの場合，「Stateful」が表示されます。
セッション種別がStateless Session Beanの場合，「Stateless」が表示されます。
<session-type>
セッション種別
</session-type>

トランザクション管理種別
○
トランザクション管理種別を指定します。
指定できる値を次に示します。

Bean

Container

<transaction-type>
トランザクション管理種別
</transaction-type>

開始・停止順
×
開始・停止順を，「0」から「2147483647」の整数で指定します。
指定がない場合，「10」が仮定されます。
<start-order>
開始・停止順
</start-order>

（凡例）　○：必須　×：任意　－：変更不可

(2)　アイコンのプロパティページ

Session Bean属性のアイコンのプロパティページについては，「21.4.2　アプリケーション属性設定ページ」の「(2)　アイコンのプロパティページ」を参照してください。

(3)　環境エントリの一覧のページ

環境エントリの一覧のページを次に示します。

環境エントリの一覧には，設定された環境エントリがリストで表示されます。

図21-72　環境エントリの一覧のページ

表21-52　環境エントリの一覧の表示項目

項目
説明
対応するタグ

環境エントリー名
環境エントリ名が表示されます。
<env-entry-name>
環境エントリ名
</env-entry-name>

値
環境エントリの値が表示されます。
<env-entry-value>
値
</env-entry-value>

(4)　環境エントリのプロパティページ

環境エントリのプロパティページを次に示します。

図21-73　環境エントリのプロパティページ

表21-53　環境エントリのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

環境エントリー名
○
環境エントリ名を指定します。※1
<env-entry-name>
環境エントリ名
</env-entry-name>

データ型
○
環境エントリのデータ型を選択します。
選択できる値を次に示します。

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

<env-entry-type>
データ型
</env-entry-type>

値
×※2
環境エントリの値を指定します。
データ型に指定した型に適合した値を指定します。
<env-entry-value>
値
</env-entry-value>

（凡例）　○：必須　×：任意

注※1　同一属性内に複数の環境エントリがある場合，同一の環境エントリ名（<env-entry-name>）は指定できません。

注※2　データ型が「java.lang.String」以外の場合は，必須です。

(5)　リモートEJBへの参照の一覧ページ

リモートEJBへの参照の一覧ページを次に示します。

リモートEJBへの参照の一覧には，設定されたリモートEJBへの参照がリストで表示されます。

図21-74　リモートEJBへの参照の一覧ページ

表21-54　リモートEJBへの参照の一覧の表示項目

項目
説明
対応するタグ

EJB参照名
EJB参照名が表示されます。
<ejb-ref-name>
EJB参照名
</ejb-ref-name>

EJB参照タイプ
EJB参照タイプが表示されます。
<ejb-ref-type>
EJB参照タイプ
</ejb-ref-type>

リンク先のEJB名
リンク先のEJB名が表示されます。
<ejb-link>
リンク先のEJB名
</ejb-link>

(6)　リモートEJBへの参照のプロパティページ

リモートEJBへの参照のプロパティページを次に示します。

図21-75　リモートEJBへの参照のプロパティページ

表21-55　リモートEJBへの参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

EJB参照名
○
EJB参照名を指定します。※1
<ejb-ref-name>
EJB参照名
</ejb-ref-name>

EJB参照タイプ
○
EJB参照タイプを指定します。
指定できる値を次に示します。

Session

Entity

<ejb-ref-type>
EJB参照タイプ
</ejb-ref-type>
<ejb-ref-type>
Entity
</ejb-ref-type>
<ejb-ref-type>
Session
</ejb-ref-type>

リモート・ホーム・インターフェース
○※2
リモートホームインタフェースを完全修飾クラス名で指定します。
<home>
リモートホームインタフェース
</home>

リモート・コンポーネント・インターフェース
○※2
リモートコンポーネントインタフェースを完全修飾クラス名で指定します。
<remote>
リモートコンポーネントインタフェース
</remote>

リンク先のEJB名
×
参照するEJBのEJB名を入力するか，またはリスト項目を選択します。

EJBがほかのejb-jarファイルにある場合は，次の形式で入力します。
「ファイル名#EJB名」

ネーミングの切り替え機能でリンク先を設定する場合，次の形式で入力します。
corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBホームオブジェクトリファレンスのJNDI名

アプリケーション統合属性ファイルにあるEnterprise Bean表示名をリスト項目から選択します。

<ejb-link>
リンク先のEJB名
</ejb-link>

（凡例）　○：必須　×：任意

注※1　同一属性内にリモートEJBへの参照とローカルEJBへの参照が両方ある場合や，リモートEJBへの参照が複数ある場合，同じEJB参照名（<ejb-ref-name>）は指定できません。

注※2　アノテーションで値が空に設定されている場合があります。アノテーションでの設定以外は，値の設定が必要となります。

(7)　ローカルEJBへの参照の一覧ページ

ローカルEJBへの参照の一覧ページを次に示します。

ローカルEJBへの参照の一覧ページでは，設定されたローカルEJBへの参照がリストで表示されます。

図21-76　ローカルEJBへの参照の一覧ページ

表21-56　ローカルEJBへの参照の一覧の表示項目

項目
説明
対応するタグ

EJB参照名
EJB参照名が表示されます。
<ejb-ref-name>
EJB参照名
</ejb-ref-name>

EJB参照タイプ
EJB参照タイプが表示されます。
<ejb-ref-type>
EJB参照タイプ
</ejb-ref-type>

リンク先のEJB名
リンク先のEJB名が表示されます。
<ejb-link>
リンク先のEJB名
</ejb-link>

(8)　ローカルEJBへの参照のプロパティページ

ローカルEJBへの参照のプロパティページを次に示します。

図21-77　ローカルEJBへの参照のプロパティページ

表21-57　ローカルEJBへの参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

EJB参照名
○
EJB参照名を指定します。※1
<ejb-ref-name>
EJB参照名
</ejb-ref-name>

EJB参照タイプ
○
EJB参照タイプを指定します。
指定できる値を次に示します。

Session

Entity

<ejb-ref-type>
EJB参照タイプ
</ejb-ref-type>

ローカル・ホーム・インターフェース
○※2
ローカルホームインタフェースを完全修飾クラス名で指定します。
<local-home>
ローカルホームインタフェース
</local-home>

ローカル・コンポーネント・インターフェース
○※2
ローカルコンポーネントインタフェースを完全修飾クラス名で指定します。
<local>
ローカルコンポーネントインタフェース
</local>

リンク先のEJB名
×
参照するEJBのEJB名を入力するか，またはリスト項目を選択します。

EJBがほかのejb-jarファイルにある場合は，次の形式で入力します。
「ファイル名#EJB名」

アプリケーション統合属性ファイルにあるEnterprise Bean表示名をリスト項目から選択します。

<ejb-link>
リンク先のEJB名
</ejb-link>

（凡例）　○：必須　×：任意

注※1　同一属性内にリモートEJBへの参照とローカルEJBへの参照が両方ある場合や，ローカルEJBへの参照が複数ある場合，同じEJB参照名（<ejb-ref-name>）は指定できません。

注※2　アノテーションで値が空に設定されている場合があります。アノテーションでの設定以外は，値の設定が必要となります。

(9)　リソース参照の一覧ページ

リソース参照の一覧ページを次に示します。

リソース参照の一覧では，設定されたリソース参照がリストで表示されます。

図21-78　リソース参照の一覧ページ

表21-58　リソース参照の一覧の表示項目

項目
説明
対応するタグ

リソース参照名
リソース参照名が表示されます。
<res-ref-name>
リソース参照名
</res-ref-name>

リソース・タイプ
リソースタイプが表示されます。
<res-type>
リソースタイプ
</res-type>

リンク先
リンク先が表示されます。
<linked-to>
リンク先
</linked-to>

(10)　リソース参照のプロパティページ

リソース参照のプロパティページを次に示します。

図21-79　リソース参照のプロパティページ

表21-59　リソース参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

リソース参照名
○
リソース参照名を指定します。※1
<res-ref-name>
リソース参照名
</res-ref-name>

リソース・タイプ
○
ソース種別を完全修飾クラス名で入力するか，または次のリスト項目を選択します。

javax.jms.ConnectionFactory

javax.jms.QueueConnectionFactory

javax.jms.TopicConnectionFactory

javax.mail.Session

javax.resource.cci. ConnectionFactory

javax.sql.DataSource

org.omg.CORBA_2_3.ORB

<res-type>
リソースタイプ
</res-type>

リソース認証方式
○
リソース認証方式を指定します。
選択できる値を次に示します。

Application

Container

<res-auth>
リソース認証方式
</res-auth>

リソース共有
×
リソース共有を指定します。
選択できる値を次に示します。

（空白）

Shareable

Unshareable

<res-sharing-scope>
リソース共有
</res-sharing-scope>

対応するリソース名
－
対応するリソースアダプタ名，またはメール表示名が表示されます。
<mapped-name>
対応するリソース名
</mapped-name>※2

リンク先
×
リンク先を指定します。
リンク先として，対応するJ2EEリソースアダプタの表示名を入力するか，またはリスト項目を選択します。
J2EEサーバにデプロイされているJ2EEリソースアダプタの表示名がリスト項目※4として表示されます。［サーバー・エクスプローラー］ビューでもJ2EEリソースアダプタの表示名一覧を参照できます。
<linked-to>
リンク先※3
</linked-to>

（凡例）　○：必須　×：任意　－：変更不可

注※1　同一属性内に複数のリソース参照名がある場合，同一のリソース参照名（<res-ref-name>）は指定できません。

注※2　<linked-to>タグに値が設定されている場合，<linked-to>タグの指定が有効になり，<mapped-name>タグの値は無効になります。

注※3　<linked-to>タグのリンク先の指定方法は，リソースアダプタのバージョンによって，次のように異なります。

Connector 1.0の仕様に準拠する場合：＜リソースアダプタの表示名＞

Connector 1.5の仕様に準拠する場合：＜リソースアダプタの表示名＞!＜コネクション定義識別子＞

注※4　リスト項目には，デプロイ済みのリソースアダプタが表示されます。なお，Connector1.5の仕様に準拠するリソースアダプタの場合は，［リソース・タイプ］の値とコネクション定義識別子が一致するOutboundリソースアダプタが表示されます。

(11)　リソース環境変数の一覧ページ

リソース環境変数の一覧ページを次に示します。

リソース環境変数の一覧には，設定されたリソース環境変数がリストで表示されます。

図21-80　リソース環境変数の一覧ページ

表21-60　リソース環境変数の一覧の表示項目

項目
説明
対応するタグ

リソース環境変数名
リソース環境変数名が表示されます。
<resource-env-ref-name>
リソース環境変数名
</resource-env-ref-name>

リソース環境変数値のタイプ
リソース環境変数値のタイプが表示されます。
<resource-env-ref-type>
リソース環境変数値のタイプ
</resource-env-ref-type>

リソース・アダプター名
リソースアダプタ名が表示されます。
<resource-adapter>
リソースアダプタ名
</resource-adapter>

キュー名
キュー名が表示されます。
<queue>
キュー名
</queue>

(12)　リソース環境変数のプロパティページ

リソース環境変数のプロパティページを次に示します。

図21-81　リソース環境変数のプロパティページ

表21-61　リソース環境変数のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

リソース環境変数名
○
リソース環境変数名を指定します。※1
<resource-env-ref-name>
リソース環境変数名
</resource-env-ref-name>

リソース環境変数値のタイプ
○
リソース環境変数値のタイプを指定します。
＜JavaBeansリソースのクラス名＞を完全修飾クラス名で入力するか，または次のリスト項目を選択します。

javax.jms.Queue

javax.jms.Topic

javax.transaction.UserTransaction※2

javax.ejb.TimerService※2

javax.ejb.EJBContext※2

<resource-env-ref-type>
リソース環境変数値のタイプ
</resource-env-ref-type>

対応するリソース名
－
リソース環境変数値のタイプが「javax.jms.Queue」または「JavaBeansリソースのクラス名」の場合，対応するリソース名が表示されます。

「javax.jms.Queue」の場合
対応するキューが「<リソースアダプタの表示名>#<Queue名称>」の形式で表示されます。

「JavaBeansリソースのクラス名」の場合
対応するJavaBeansリソースの表示名で表示されます。

<mapped-name>
対応するリソース名
</mapped-name>

（凡例）　○：必須　×：任意　－：変更不可

注※1　同一属性内に複数のリソース環境変数がある場合，同じリソース環境変数名（<resource-env-ref-name>）は指定できません。

注※2　Session Bean属性の場合，アノテーションで設定された値です。リスト項目として表示されますが，アノテーションで設定された値は変更できないため，J2EEアプリケーションサーバへの保管時にサーバ側で変更前の設定値に戻されます。

(13)　リンク先キューのプロパティページ

リンク先キューのプロパティページを次に示します。

図21-82　リンク先キューのプロパティページ

表21-62　リンク先キューのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

リソース・アダプター名
○
J2EEリソースアダプタの表示名を入力※，または選択します。
J2EEサーバにデプロイされているJ2EEリソースアダプタの表示名※がリスト項目として表示されます。［サーバー・エクスプローラー］ビューでもJ2EEリソースアダプタの表示名一覧を参照できます。
<resource-adapter>
リソースアダプタ名
</resource-adapter>

キュー名
○
キューの表示名を指定します。
<queue>
キュー名
</queue>

（凡例）　○：必須

注※　Connector 1.5の仕様に準拠するリソースアダプタは指定できません。また，リスト項目にも表示されません。

(14)　リンク先の管理対象オブジェクトのプロパティページ

リンク先の管理対象オブジェクトのプロパティページを次に示します。

図21-83　リンク先の管理対象オブジェクトのプロパティページ

表21-63　リンク先の管理対象オブジェクトのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

リソース・アダプター名
○
J2EEリソースアダプタの表示名を入力※，または選択します。
J2EEサーバにデプロイされているJ2EEリソースアダプタの表示名※がリスト項目として表示されます。［サーバー・エクスプローラー］ビューでもJ2EEリソースアダプタの表示名一覧を参照できます。
<resourceadapter-name>
リソースアダプタ名
</resourceadapter-name>

管理対象オブジェクト名
○
管理対象オブジェクト名を指定します。
指定できる文字は，英数字（0～9，A～Z，a～z），およびアンダースコア（_）です。
<adminobject-name>
管理対象オブジェクト名
</adminobject-name>

（凡例）　○：必須

注※　Connector 1.0の仕様に準拠するリソースアダプタは指定できません。また，リスト項目にも表示されません。

(15)　コンテナトランザクションの一覧ページ

コンテナトランザクションの一覧ページを次に示します。

コンテナトランザクションの一覧には，設定されたコンテナトランザクションがリストで表示されます。

図21-84　コンテナトランザクションの一覧ページ

表21-64　コンテナトランザクションの一覧の表示項目

項目
説明
対応するタグ

トランザクション属性
トランザクション属性が表示されます。
<trans-attribute>
トランザクション属性
</trans-attribute>

(16)　コンテナトランザクションのプロパティページ

コンテナトランザクションのプロパティページを次に示します。

図21-85　コンテナトランザクションのプロパティページ

表21-65　コンテナトランザクションのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

トランザクション属性
○
トランザクション属性を指定します。
指定できる値を次に示します。

Mandatory

Never

NotSupported

Required

RequiresNew

Supports

<trans-attribute>
トランザクション属性
</trans-attribute>

（凡例）　○：必須　×：任意

(17)　メソッドの一覧ページ

メソッドの一覧ページを次に示します。

メソッドの一覧には，設定されたメソッドがリストで表示されます。

図21-86　メソッドの一覧ページ

表21-66　メソッドの一覧ページの表示項目

項目
説明
対応するタグ

インターフェース種別
インタフェース種別が表示されます。
<method-intf>
インタフェース種別
</method-intf>

メソッド名
メソッド名が表示されます。
<method-name>
メソッド名
</method-name>

(18)　メソッドのプロパティページ

メソッドのプロパティページを次に示します。

図21-87　メソッドのプロパティページ

表21-67　メソッドのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

インタフェース種別
×
インタフェース種別を指定します。
選択できる値を次に示します。

Session BeanまたはEntity Beanの場合

（空白）

Home

Remote

LocalHome

Local

Message-driven Beanの場合

（空白）

Bean

<method-intf>
インタフェース種別
</method-intf>

メソッド名
○
メソッド名を指定します。すべてのメソッドを指定する場合は，「*」を選択してください。
メソッド名に，「*」を指定した場合，［メソッド・パラメーター］の指定は無効になります。
<method-name>
メソッド名
</method-name>

（凡例）　○：必須　×：任意

(19)　メソッドパラメタの一覧ページ

メソッドパラメタの一覧ページを次に示します。

図21-88　メソッドパラメタの一覧ページ

表21-68　メソッドパラメタの一覧ページの表示項目

項目
説明
対応するタグ

メソッド・パラメーターのデータ型
パラメタのデータ型が表示されます。
<method-param>
パラメタのデータ型
</method-param>

(20)　パラメタのデータ型プロパティページ

パラメタのデータ型プロパティページを次に示します。

図21-89　パラメタのデータ型プロパティページ

表21-69　パラメタのデータ型プロパティページの設定項目

項目
必須／任意
説明
対応するタグ

メソッド・パラメーターのデータ型
○
パラメタのデータ型タイプを完全修飾クラス名で指定します。
配列の場合は，名称の後ろに[]を指定します。多次元配列は[]を続けて指定します。
例：short[][]
<method-param>
パラメタのデータ型
</method-param>

（凡例）　○：必須

(21)　ランタイムのプロパティページ

ランタイムのプロパティページを次に示します。

図21-90　ランタイムのプロパティページ

表21-70　ランタイムのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

ルックアップ名
○
クライアントからEJBをルックアップする場合に使う名前を指定します。
最大255文字で指定してください。
指定できる文字は，英数字（0～9，A～Z，a～z），アンダースコア（_），およびピリオド（.）です。
名前の先頭や末尾にピリオドは指定できません。
<lookup-name>
ルックアップ名
</lookup-name>

別名
×
別名を指定します。
最大255文字で指定してください。
指定できる文字は，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.），ハイフン（-），および区切り文字としてスラッシュ（/）です。
サーバで，usrconf.propertiesファイルのejbserver.cui.optionalname.enabledキーがtrueに設定されていない場合，指定値は無効となります。
また，次の文字列は使用できません。

「/」だけ，または「/」が連続している文字列

先頭または末尾に「.」および「/」が指定されている文字列

「/」の前や後に「.」が指定されている文字

「HITACHI_EJB」で始まる文字列

<optional-name>
別名
</optional-name>

ローカル・インターフェースの別名
×
ローカルインタフェースの別名を指定します。
指定できる文字は，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.），ハイフン（-），および区切り文字としてスラッシュ（/）です。
また，次の文字列は使用できません。

「/」だけ，または「/」が連続している文字列

先頭または末尾に「.」および「/」が指定されている文字列

「/」の前や後に「.」が指定されている文字

「HITACHI_EJB」で始まる文字列

<local-optional-name>
ローカルインタフェースの別名
</local-optional-name>

セッションの最大数
○※1
セッションの最大数を，「0（無制限）」または「1」から「2147483647」の整数で指定します。
ただし，Stateless Session Beanの場合は指定できません。
<maximum-sessions>
セッションの最大数
</maximum-sessions>

スケジューリングの対象にする
×
Beanをスケジューリングの対象にするかどうかを指定します。CTMを使用している場合にだけ指定できます。※2
指定できる値を次に示します。

（空白）

true

false

<enable-scheduling>
スケジューリングの対象にする
</enable-scheduling>

参照渡しの設定
×
Bean単位でのデータの参照渡しを行うかどうかを指定します。
指定できる値を次に示します。

（空白）

true

false

<pass-by-reference>
参照渡しの設定
</pass-by-reference>

（凡例）　○：必須　×：任意

注※1　Stateless Session Beanの場合は表示されるだけで，編集はできません。

注※2　CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus アプリケーションサーバ 概説」の「2.3.1　製品と構成ソフトウェアの対応」を参照してください。

(22)　Stateless Session Beanのプロパティページ

Stateless Session Beanのプロパティページを次に示します。

図21-91　Stateless Session Beanのプロパティページ

表21-71　Stateless Session Beanのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

プール内のインスタンスの最小数
○
プール内のインスタンスの最小数を，「0（無制限）」または「1」以上の整数で指定します。
ただし，［プール内のインスタンスの最小数］は［プール内のインスタンスの最大数］に指定した値以下の値を設定してください。
<minimum>
プール内のインスタンスの最小数
</minimum>

プール内のインスタンスの最大数
○
プール内のインスタンスの最大数を，「0（無制限）」または「1」以上の整数で指定します。
ただし，［プール内のインスタンスの最大数］は［プール内のインスタンスの最小数］に指定した値以上の値を設定してください。
<maximum>
プール内のインスタンスの最大数
</maximum>

（凡例）　○：必須

(23)　Stateful Session Beanのプロパティページ

Stateful Session Beanのプロパティページを次に示します。

図21-92　Stateful Session Beanのプロパティページ

表21-72　Stateful Session Beanのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

アクティブ・セッションの最大数
○
アクティブセッションの最大数を，「0（無制限）」または「1」以上の整数で指定します。
ただし，［アクティブ・セッションの最大数］は［セッションの最大数］に指定した値以下の値を設定してください。
<maximum-active-sessions>
アクティブセッションの最大数
</maximum-active-sessions>

再びアクティブ化するまでに非アクティブ状態に保持しておく時間
○
再びアクティブ化するまでに非アクティブ状態に保持しておく時間を，「1（分）」から「2147483647（分）」の整数で指定します。
無制限の時間を設定する場合は，「0」を指定します。
ここで指定した時間が経過するまでにpassive状態のStateful Session Beanが活性化されない場合，このBeanは削除されます。
<inactivity-timeout>
再びアクティブ化するまでに非アクティブ状態に保持しておく時間
</inactivity-timeout>

セッションが削除されるまでに非アクティブ状態に保持しておく時間
○
セッションが削除されるまでに非アクティブ状態に保持しておく時間を，「1（分）」から「2147483647（分）」の整数で指定します。
無制限の時間を設定する場合は，「0」を指定します。
ここで指定された時間の間，method-ready状態のStateful Session Beanが一度も使用されない場合，このBeanは削除されます。
<removal-timeout>
セッションが削除されるまでに非アクティブ状態に保持しておく時間
</removal-timeout>

（凡例）　○：必須

(24)　CTM連携のプロパティページ

CTM連携のプロパティページを次に示します。このページは，CTMを使用していない場合には不活性になります。CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus アプリケーションサーバ 概説」の「2.3.1　製品と構成ソフトウェアの対応」を参照してください。

図21-93　CTM連携のプロパティページ

表21-73　CTM連携のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

キュー名
○
CTM連携を行うキュー名称を指定します。
CTM連携の追加で，CTM連携のプロパティページが表示された場合，初期値としてSession Beanの表示名（<display-name>タグの値）が設定されています。
<queue-name>
キュー名
</queue-name>

スレッド数
○
CTMがアプリケーションを呼び出すために用意するスレッド数を，「1」から「127」の範囲で指定します。
<parallel-count>
スレッド数
</parallel-count>

（凡例）　○：必須

21.7　アプリケーション統合属性ファイル（Entity Bean属性）

アプリケーション統合属性ファイルの［EJB-JAR］タブを選択すると，［EJB-JAR］フォームページが表示されます。［EJB-JAR］フォームページの［エレメント］に表示されている，［＜Entity Bean名＞］を選択して，Entity Bean属性のツリーを表示します。

＜この節の構成＞

21.7.1　Entity Bean属性のツリー

21.7.2　Entity Bean属性設定ページ

21.7.1　Entity Bean属性のツリー

エディタエリアの［エレメント］下に，編集するEntity Bean属性の構成がツリー形式で表示されます。

Entity Bean属性のツリー構成を次に示します。

[図データ]＜Entity Bean属性名＞
　│
　├─アイコン
　│
　├─[図データ]環境エントリー
　│　　└─＜環境エントリ名＞
　│
　├─[図データ]リモートEJBへの参照
　│　　└─＜リモートEJBへの参照名＞
　│
　├─[図データ]ローカルEJBへの参照
　│　　└─＜ローカルEJBへの参照名＞
　│
　├─[図データ]リソース参照
　│　　└─＜リソース参照名＞
　│
　├─[図データ]リソース環境変数
　│　　└─＜リソース環境変数名＞
　│　　　　├─リンク先キュー
　│　　　　└─リンク先の管理対象オブジェクト
　│
　├─[図データ]コンテナー・トランザクション
　│　　└─＜トランザクション属性＞
　│　　　　└─[図データ]メソッド
　│　　　　　　└─＜メソッド名＞
　│　　　　　　　　└─メソッド・パラメーター
　│　　　　　　　　　　└─＜パラメタのデータ型＞
　│
　└─ランタイム

Entity Bean属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。Entity Bean属性のツリーノードとコンテキストメニューについて，次に説明します。

＜この項の構成＞

(1)　Entity Bean属性のツリーノード

(2)　コンテキストメニュー操作

(1)　Entity Bean属性のツリーノード

Entity Bean属性のツリービューに表示されるノードを次に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。なお，下記以外のノードの詳細については，「21.6　アプリケーション統合属性ファイル（Session Bean属性）」を参照してください。

表21-74　Entity Bean属性ファイルのツリーノード

ノード
説明
対応するタグ名
プロパティページ

＜Entity Bean属性名＞
Entity Bean属性を示すノードです。
選択すると，Entity Beanのプロパティページが表示されます。
<hitachi-entity-bean-property>
21.7.2　(1)

ランタイム
ランタイムを示すノードです。
選択すると，ランタイムのプロパティページが表示されます。
<entity-runtime>
21.7.2　(2)

(2)　コンテキストメニュー操作

Entity Bean属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-75　Entity Bean属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

＜Entity Bean属性名＞
［追加］ - ［アイコン］
Entity Bean属性にアイコンが追加されます。
アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.4.2　(2)

［追加］ - ［環境エントリー］
Entity Bean属性に環境エントリが追加されます。
環境エントリのプロパティページが表示されます。
21.6.2　(4)

［追加］ - ［リモートEJB］
Entity Bean属性にリモートEJBへの参照が追加されます。
リモートEJBへの参照のプロパティページが表示されます。
21.6.2　(6)

［追加］ - ［ローカルEJB］
Entity Bean属性にローカルEJBへの参照が追加されます。
ローカルEJBへの参照のプロパティページが表示されます。
21.6.2　(8)

［追加］ - ［リソース参照］
Entity Bean属性にリソース参照が追加されます。
リソース参照のプロパティページが表示されます。
21.6.2　(10)

［追加］ - ［リソース環境変数］
Entity Bean属性にリソース環境変数が追加されます。
リソース環境変数のプロパティページが表示されます。
21.6.2　(12)

［追加］ - ［コンテナー・トランザクション］
Entity Bean属性にコンテナトランザクションが追加されます。
コンテナトランザクションのプロパティページが表示されます。
21.6.2　(16)

アイコン
［削除］
選択しているノードが削除されます。
－

（凡例）　－：該当なし

21.7.2　Entity Bean属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。［エレメントの詳細］に，編集するEntity Bean属性のプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアの表示が切り替わります。

Entity Bean属性ファイルには，次のプロパティページがあります。

Entity Beanのプロパティページ

ランタイムのプロパティページ

そのほかのプロパティページ

注意事項

プロパティページで，設定が必須の項目には「*」が付与されています。

＜この項の構成＞

(1)　Entity Beanのプロパティページ

(2)　ランタイムのプロパティページ

(3)　そのほかのプロパティページ

(1)　Entity Beanのプロパティページ

Entity Beanのプロパティページを次に示します。

図21-94　Entity Beanのプロパティページ

表21-76　Entity Beanのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

表示名
－
表示名が表示されます。
<display-name>
表示名
</display-name>

永続性管理種別
－
永続性管理種別が表示されます。
永続性管理種別が「Bean」の場合は，［Bean］が表示されます。
永続性管理種別が「Container」の場合は，［Container］が表示されます。
<persistence-type>
永続性管理種別
</persistence-type>

プライマリー・キー・クラス
○
単一プライマリキーまたは複合プライマリキーとして指定できるクラスまたはインタフェースを指定します。
永続性管理種別が「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.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を実装していてもよい）

<prim-key-class>
プライマリキークラス
</prim-key-class>

再帰呼び出しが可能
○
再帰呼び出しが可能かどうかを指定します。
指定できる値を次に示します。

True

False

<reentrant>
再帰呼び出しが可能
</reentrant>

開始・停止順
×
開始・停止順を「0」から「2147483647」の整数で指定します。
指定がない場合，「10」が仮定されます。
<start-order>
開始・停止順
</start-order>

（凡例）　○：必須　×：任意　－：変更不可

(2)　ランタイムのプロパティページ

ランタイムのプロパティページを次に示します。

図21-95　ランタイムのプロパティページ

表21-77　ランタイムのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

ルックアップ名
○
クライアントからEJBをルックアップする場合に使う名前を指定します。
最大255文字で指定してください。
指定できる文字は，英数字（0～9，A～Z，a～z），アンダースコア（_），およびピリオド（.）です。
名前の先頭や末尾にピリオドは指定できません。
<lookup-name>
ルックアップ名
</lookup-name>

別名
×
別名を指定します。
最大255文字で指定してください。
指定できる文字は，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.），ハイフン（-），および区切り文字としてスラッシュ（/）です。
サーバで，usrconf.propertiesファイルのejbserver.cui.optionalname.enabledキーにtrueに設定されていていない場合，指定した別名は無効となります。
また，次の文字列は使用できません。

「/」だけ，または「/」が連続している文字列

先頭または末尾に「.」および「/」が指定されている文字列

「/」の前や後に「.」が指定されている文字

「HITACHI_EJB」で始まる文字列

<optional-name>
別名
</optional-name>

ローカル・インターフェースの別名
×
ローカルインタフェースの別名を指定します。
指定できる文字は，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.），ハイフン（-），および区切り文字としてスラッシュ（/）です。
また，次の文字列は使用できません。

「/」だけ，または「/」が連続している文字列

先頭または末尾に「.」および「/」が指定されている文字列

「/」の前や後に「.」が指定されている文字

「HITACHI_EJB」で始まる文字列

<local-optional-name>
ローカルインタフェースの別名
</local-optional-name>

インスタンスの最大数
○
インスタンスの最大数を，「0（無制限）」または「1」から「2147483647」の整数で指定します。
<maximum-instances>
インスタンスの最大数
</maximum-instances>

プール内のインスタンスの最小数
○
プール内のインスタンスの最小数を，「0（無制限）」または「1」以上の整数で指定します。ただし，［プール内のインスタンスの最小数］は［プール内のインスタンスの最大数］に指定した値以下の値を設定してください。
<minimum>
プール内のインスタンスの最小数
</minimum>

プール内のインスタンスの最大数
○
プール内のインスタンスの最大数を，「0（無制限）」または「1」以上の整数で指定します。ただし，［プール内のインスタンスの最大数］は［プール内のインスタンスの最小数］に指定した値以上の値を設定してください。
また，［プール内のインスタンスの最大数］は［インスタンスの最大数］に指定した値以下の値を設定してください。
<maximum>
プール内のインスタンスの最大数
</maximum>

データのキャッシュ方法
○
データのキャッシュ方法を指定します。
指定できる値を次に示します。

full-caching

caching

no-caching

<caching-model>
データのキャッシュ方法
</caching-model>

EJBオブジェクトの存在時間
×
EJBオブジェクトの存在時間を「0（秒）」から「2147483647（秒）」の整数で指定します。
「0」を指定した場合，タイムアウトが実行されません。
指定がない場合，「0」が仮定されます。
<entity-timeout>
EJBノードの存在時間
</entity-timeout>

参照渡しの設定
×
Bean単位でのデータの参照渡しを行うかどうかを指定します。
指定できる値を次に示します。

（空白）

true

false

<pass-by-reference>
参照渡しの設定
</pass-by-reference>

（凡例）　○：必須　×：任意

(3)　そのほかのプロパティページ

Entity Beanのプロパティページ，およびランタイムのプロパティページ以外のプロパティページは，Session Beanのプロパティの設定と同じです。プロパティページの詳細については，「21.6.2　Session Bean属性設定ページ」を参照してください。

21.8　アプリケーション統合属性ファイル（Message-driven Bean属性）

アプリケーション統合属性ファイルの［EJB-JAR］タブを選択すると，［EJB-JAR］フォームページが表示されます。［EJB-JAR］フォームページの［エレメント］に表示されている，［＜Message-driven Bean名＞］を選択して，Message-driven Bean属性のツリーを表示します。

＜この節の構成＞

21.8.1　Message-driven Bean属性のツリー

21.8.2　Message-driven Bean属性設定ページ

21.8.1　Message-driven Bean属性のツリー

エディタエリアの［エレメント］下に編集するMessage-driven Bean属性の構成が，ツリー形式で表示されます。

Message-driven Bean属性のツリー構成を次に示します。

[図データ]＜Message-driven Bean属性名＞
　│
　├─アイコン
　│
　├─アクティベーションの設定
　│　　└─[図データ]アクティベーションのプロパティー
　│　　　　└─＜Activationのプロパティ＞
　│
　├─メッセージ・ドリブン・デスティネーション
　│
　├─[図データ]環境エントリー
　│　　└─＜環境エントリ名＞
　│
　├─[図データ]リモートEJBへの参照
　│　　└─＜リモートEJBへの参照名＞
　│
　├─[図データ]ローカルEJBへの参照
　│　　└─＜ローカルEJBへの参照名＞
　│
　├─メッセージ参照
　│
　├─[図データ]リソース参照
　│　　└─＜リソース参照名＞
　│
　├─[図データ]リソース環境変数
　│　　└─＜リソース環境変数名＞
　│　　　　├─リンク先キュー
　│　　　　└─リンク先の管理対象オブジェクト
　│
　├─[図データ]コンテナー・トランザクション
　│　　└─＜トランザクション属性＞
　│　　　　└─[図データ]メソッド
　│　　　　　　└─＜メソッド名＞
　│　　　　　　　　└─メソッド・パラメーター
　│　　　　　　　　　　└─＜パラメタのデータ型＞
　│
　└─ランタイム

Message-driven Bean属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。Message-driven Bean属性のツリーノードとコンテキストメニューについて，次に説明します。

＜この項の構成＞

(1)　Message-driven Bean属性のツリーノード

(2)　コンテキストメニュー操作

(1)　Message-driven Bean属性のツリーノード

Message-driven Bean属性のツリービューに表示されるノードを次に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。なお，下記以外のノードの詳細については，「21.6　アプリケーション統合属性ファイル（Session Bean属性）」を参照してください。

表21-78　Message-driven Bean属性ファイルのツリーのノード

ノード
説明
対応するタグ名
プロパティページ

＜Message-driven Bean属性名＞
Message-driven Bean属性を示すノードです。
選択すると，Message-driven Bean属性のプロパティページが表示されます。
<hitachi-message-bean-property>
21.8.2　(1)

アクティベーションの設定
Activationの設定を示すノードです。
選択すると，Activationの設定のプロパティページが表示されます。
<activation-config>
21.8.2　(2)

アクティベーションのプロパティー
Activationのプロパティをまとめるノードです。
選択すると，Activationのプロパティの一覧ページが表示されます。
－
21.8.2　(3)

＜Activationのプロパティ＞
Activationのプロパティを示すノードです。
選択すると，Activationのプロパティのプロパティページが表示されます。
<activation-config-property>
21.8.2　(4)

メッセージ・ドリブン・デスティネーション
Message-driven Beanのデスティネーション定義を示すノードです。選択すると，Message-driven Beanのデスティネーション定義のプロパティページが表示されます。
<message-driven-destination>
21.8.2　(5)

メッセージ参照
メッセージ参照を示すノードです。
選択すると，メッセージ参照のプロパティページが表示されます。
<message-ref>
21.8.2　(6)

ランタイム
ランタイムを示すノードです。選択すると，ランタイムのプロパティページが表示されます。
<message-runtime>
21.8.2　(7)

(2)　コンテキストメニュー操作

Message-driven Bean属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。なお，下記以外のノードの詳細については，「21.6　アプリケーション統合属性ファイル（Session Bean属性）」を参照してください。

表21-79　Message-driven Bean属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

＜Message-driven Bean属性名＞
［追加］ - ［アイコン］
Message-driven Bean属性にアイコンが追加されます。
アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.4.2　(2)

［追加］ - ［アクティベーションの設定］
Message-driven Bean属性にActivationの設定が追加されます。
Activationの設定のプロパティページが表示されます。
21.8.2　(2)

［追加］ - ［メッセージ・ドリブン・デスティネーション］
Message-driven Bean属性にMessage-driven Beanのデスティネーション定義のプロパティページが追加されます。
Message-driven Beanのデスティネーション定義のプロパティページが表示されます。すでに，Message-driven Beanのデスティネーション定義がある場合は選択できません。
21.8.2　(5)

［追加］ - ［環境エントリー］
Message-driven Bean属性に環境エントリが追加されます。
環境エントリのプロパティページが表示されます。
21.6.2　(4)

［追加］ - ［リモートEJBへの参照］
Message-driven Bean属性にリモートEJBへの参照が追加されます。
リモートEJBへの参照のプロパティページが表示されます。
21.6.2　(6)

［追加］ - ［ローカルEJBへの参照］
Message-driven Bean属性にローカルEJBへの参照が追加されます。
ローカルEJBへの参照のプロパティページが表示されます。
21.6.2　(8)

［追加］ - ［メッセージ参照］
Message-driven Bean属性にメッセージ参照が追加されます。
メッセージ参照のプロパティページが表示されます。
すでに，メッセージ参照がある場合は不活性となり追加できません。
21.8.2　(6)

［追加］ - ［リソース参照］
Message-driven Bean属性にリソース参照が追加されます。
リソース参照のプロパティページが表示されます。
21.6.2　(10)

［追加］ - ［リソース環境変数］
Message-driven Bean属性にリソース環境変数が追加されます。
リソース環境変数のプロパティページが表示されます。
21.6.2　(12)

［追加］ - ［コンテナー・トランザクション］
Message-driven Bean属性にコンテナトランザクションが追加されます。
コンテナトランザクションのプロパティページが表示されます。
21.6.2　(16)

アイコン
［削除］
選択しているノードが削除されます。
－

アクティベーションの設定
［追加］ - ［アクティベーションのプロパティー］
Message-driven Bean属性にActivationのプロパティが追加されます。
Activationのプロパティのプロパティページが表示されます。
21.8.2　(4)

［削除］
選択しているノードが削除されます。
－

アクティベーションのプロパティー
［追加］ - ［アクティベーションのプロパティー］
Message-driven Bean属性にActivationのプロパティが追加されます。
Activationのプロパティのプロパティページが表示されます。
21.8.2　(4)

＜Activationのプロパティ＞
［削除］
選択しているノードが削除されます。
－

メッセージ・ドリブン・デスティネーション
［削除］
選択しているノードが削除されます。
－

メッセージ参照
［削除］
選択しているノードが削除されます。
－

ランタイム
－
－
－

（凡例）　－：該当なし

21.8.2　Message-driven Bean属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。［エレメントの詳細］に編集するMessage-driven Bean属性ファイルのプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアの表示が切り替わります。

Message-driven Bean属性には，次のプロパティページがあります。

Message-driven Beanのプロパティページ

Activationの設定のプロパティページ

Activationのプロパティの一覧ページ

Activationのプロパティのプロパティページ

Message-driven Beanのデスティネーション定義のプロパティページ

メッセージ参照のプロパティページ

ランタイムのプロパティページ

そのほかのプロパティページ

注意事項

プロパティページで，設定が必須の項目には「*」が付与されています。

＜この項の構成＞

(1)　Message-driven Beanのプロパティページ

(2)　Activationの設定のプロパティページ

(3)　Activationのプロパティの一覧ページ

(4)　Activationのプロパティのプロパティページ

(5)　Message-driven Beanのデスティネーション定義のプロパティページ

(6)　メッセージ参照のプロパティページ

(7)　ランタイムのプロパティページ

(8)　そのほかのプロパティページ

(1)　Message-driven Beanのプロパティページ

Message-driven Beanのプロパティページを次に示します。

図21-96　Message-driven Beanのプロパティページ

表21-80　Message-driven Beanのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

表示名
－
表示名が表示されます。
<display-name>
表示名
</display-name>

メッセージングのタイプ
×
Message-driven Beanのメッセージリスナインタフェースを指定します。指定がない場合，サーバ側で実行時に「javax.jms.MessageListener」が仮定されます。
指定できる値は，<message-ref> - <connection-destination> - <resource-adapter>に指定されたInboundリソースアダプタに含まれるメッセージリスナのタイプです。メッセージリスナのタイプは，Connector属性の<inbound-resourceadapter> - <messageadapter> - <message-listener> - <message-listener-type>の値になります。
<messaging-type>
メッセージングのタイプ
<messaging-type>

トランザクション管理種別
○
トランザクション管理種別を指定します。
指定できる値を次に示します。

Bean

Container

<transaction-type>
トランザクション管理種別
</transaction-type>

メッセージ・セレクター
×
メッセージセレクタを指定します。
<message-selector>
メッセージセレクタ
</message-selector>

通知モード
×
通知モードを指定します。
デフォルトの場合，または指定を省略した場合，「Auto-acknowledge」が仮定されます。
指定できる値を次に示します。

（空白）

Auto-acknowledge

Dups-ok-acknowledge

<acknowledge-mode>
通知モード
</acknowledge-mode>

開始・停止順
×
開始・停止順を，「0」から「2147483647」の整数で指定します。
指定がない場合，「10」が仮定されます。
<start-order>
開始・停止順
</start-order>

（凡例）　○：必須　×：任意　－：変更不可

(2)　Activationの設定のプロパティページ

Activationの設定のプロパティページを次に示します。

図21-97　Activationの設定のプロパティページ

表21-81　Activationの設定のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

（凡例）　×：任意

(3)　Activationのプロパティの一覧ページ

Activationのプロパティの一覧ページを次に示します。

図21-98　Activationのプロパティの一覧ページ

表21-82　Activationのプロパティの一覧ページの表示項目

項目
説明
対応するタグ

プロパティー名
Activationのプロパティ名が表示されます。
<activation-config-property-name>
Activationのプロパティ名
</activation-config-property-name>

プロパティーの値
Activationのプロパティの値が表示されます。
<activation-config-property-value>
Activationのプロパティの値
</activation-config-property-value>

(4)　Activationのプロパティのプロパティページ

Activationのプロパティのプロパティページを次に示します。

図21-99　Activationのプロパティのプロパティページ

表21-83　Activationのプロパティのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

プロパティー名
○
Activationのプロパティ名を指定します。
指定できる値を次に示します。

destination

destinationType

必須コンフィグレーションプロパティ名※

<activation-config-property-name>
Activationのプロパティ名
</activation-config-property-name>

プロパティーの値
○
Activationのプロパティの値を指定します。
<activation-config-property-value>
Activationのプロパティの値
</activation-config-property-value>

（凡例）　○：必須

注※　<messaging-type>に指定されたメッセージングのタイプに含まれる必須コンフィグレーションプロパティ名が表示されます。ただし，destinationおよびdestinationTypeと重複する値は表示されません。大文字と小文字が異なる値は，重複しない値として扱われます。

(5)　Message-driven Beanのデスティネーション定義のプロパティページ

Message-driven Beanのデスティネーション定義のプロパティページを次に示します。

図21-100　Message-driven Beanのデスティネーション定義のプロパティページ

表21-84　Message-driven Beanのデスティネーション定義のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

デスティネーション・タイプ
○
デスティネーションタイプを選択します。
選択できる値を次に示します。

javax.jms.Queue

javax.jms.Topic

<destination-type>
デスティネーションタイプ
</destination-type>

サブスクリプション永続性
×※
デスティネーションタイプが「javax.jms.Topic」の場合，サブスクリプション永続性を選択します。
「javax.jms.Topic」が指定されていない場合は，選択できません。
選択できる値を次に示します。

（空白）

Durable

NonDurable

<subscription-durability>
サブスクリプション永続性
</subscription-durability>

（凡例）　○：必須　×：任意

注※　デスティネーションタイプが「javax.jms.Topic」の場合は，設定は必須です。

(6)　メッセージ参照のプロパティページ

メッセージ参照のプロパティページを次に示します。

図21-101　メッセージ参照のプロパティページ

表21-85　メッセージ参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

Connection Factory名
○
Connection Factory名を指定します。
<connection-factory>
Connection Factory名
</connection-factory>

リソース・アダプター名
○
J2EEリソースアダプタの表示名を入力するか，またはリスト項目を選択します。
J2EEサーバにデプロイされているJ2EEリソースアダプタの表示名がリスト項目として表示されます。［サーバー・エクスプローラー］ビューでもJ2EEリソースアダプタの表示名一覧を参照できます。
<resource-adapter>
リソースアダプタ名
</resource-adapter>

キュー名
○
キューの表示名を指定します。
<queue>
キュー名
</queue>

（凡例）　○：必須

(7)　ランタイムのプロパティページ

ランタイムのプロパティページを次に示します。

図21-102　ランタイムのプロパティページ

表21-86　ランタイムのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

プール内のインスタンスの最小数
－
プール内のインスタンスの最小数「1」が表示されます。
<minimum>
プール内のインスタンスの最小数
</minimum>

プール内のインスタンスの最大数
○
プール内のインスタンスの最大数を「1」から「2147483647」の整数で指定します。
<maximum>
プール内のインスタンスの最大数
</maximum>

（凡例）　○：必須　－：変更不可

(8)　そのほかのプロパティページ

Message-driven Beanのプロパティページ，Message-driven Beanのデスティネーション定義のプロパティページ，メッセージ参照のプロパティページ，およびランタイムのプロパティページ以外のプロパティページは，Session Bean属性の場合と同じです。プロパティページの詳細については，「21.6.2　Session Bean属性設定ページ」を参照してください。

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

アプリケーション統合属性ファイルの［WAR］タブを選択すると，［WAR］フォームページが表示されます。

図21-103　［WAR］フォームページ例

フォームページの［エレメント］の下に，WARの構成によって，次のツリーが展開されます。

WAR属性
＜WAR属性名＞を選択すると，WAR属性のツリーが表示されます。WAR属性のツリーとプロパティの設定項目については，この節で説明しています。

フィルタ属性
＜フィルタ属性名＞を選択すると，フィルタ属性のツリーが表示されます。フィルタ属性のツリーとプロパティの設定項目については，「21.10　アプリケーション統合属性ファイル（フィルタ属性）」を参照してください。

サーブレット属性
＜サーブレット属性名＞を選択すると，サーブレット属性のツリーが表示されます。サーブレット属性のツリーとプロパティの設定項目については，「21.11　アプリケーション統合属性ファイル（サーブレット属性）」を参照してください。

＜この節の構成＞

21.9.1　WAR属性のツリー

21.9.2　WAR属性設定ページ

21.9.1　WAR属性のツリー

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。エディタエリアの［エレメント］下に編集するWAR属性ファイルの構成がツリー形式で表示されます。

WAR属性のツリー構成を次に示します。

[図データ]＜WAR属性名＞
　│
　├─アイコン
　├─[図データ]コンテキスト・パラメーター
　│　　└─＜パラメタ＞
　│
　├─[図データ]フィルター・マッピング
　│　　└─＜フィルタ名＞
　│
　├─[図データ]リスナー
　│　　└─＜リスナクラス＞
　│　　　　└─アイコン
　│
　├─セッションの設定
　│
　├─[図データ]MIMEタイプのマッピング
　│　　└─＜拡張子＞
　│
　├─[図データ]ウェルカム・ファイル・リスト
　│　　└─ウェルカム・ファイル・リスト
　│　　　　└─＜ウェルカムファイル＞
　│
　├─[図データ]エラー・ページ
　│　　└─＜エラーコード＞または＜例外クラス＞
　│
　├─JSPの設定
　│　├─[図データ]タグ・ライブラリー※1
　│　│　　└─＜タグライブラリのURI＞
　│　└─[図データ]JSPプロパティー・グループ
　│　　　└─先頭の＜URLパターン＞
　│　　　　　├─アイコン
　│　　　　　├─[図データ]URLパターン
　│　　　　　│　　└─＜URLパターン＞
　│　　　　　├─[図データ]ヘッダーにインクルードするファイル
　│　　　　　│　　└─＜ヘッダにインクルードするファイル＞
　│　　　　　└─[図データ]フッターにインクルードするファイル
　│　　　　　　　└─＜フッタにインクルードするファイル＞
　├─[図データ]タグ・ライブラリー※2
　│　　└─＜タグライブラリのURI＞
　│
　├─ログインの設定
　│
　├─[図データ]環境エントリー
　│　　└─＜環境エントリ名＞
　│　　　　　└─[図データ]インジェクション・ターゲット※3
　│　　　　　　　　└─＜インジェクションターゲット名＞
　│
　├─[図データ]リモートEJBへの参照
　│　　└─＜リモートEJBへの参照名＞
　│　　　　　└─[図データ]インジェクション・ターゲット※3
　│　　　　　　　　└─＜インジェクションターゲット名＞
　│
　├─[図データ]ローカルEJBへの参照
　│　　└─＜ローカルEJBへの参照名＞
　│　　　　　└─[図データ]インジェクション・ターゲット※3
　│　　　　　　　　└─＜インジェクションターゲット名＞
　│
　├─[図データ]リソース参照
　│　　└─＜リソース参照名＞
　│　　　　　└─[図データ]インジェクション・ターゲット※3
　│　　　　　　　　└─＜インジェクションターゲット名＞
　│
　├─[図データ]リソース環境変数
　│　　└─＜リソース環境変数名＞
　│　　　　　├─[図データ]インジェクション・ターゲット※3
　│　　　　　│　　└─＜インジェクションターゲット名＞
　│　　　　　├─リンク先キュー
　│　　　　　└─リンク先の管理対象オブジェクト
　│
　├─[図データ]永続化コンテキスト参照※3
　│　　└─＜永続化コンテキスト参照名＞
　│　　　　　├─[図データ]永続化のプロパティー
　│　　　　　│　　└─＜永続化のプロパティ名＞
　│　　　　　└─[図データ]インジェクション・ターゲット
　│　　　　　　　　└─＜インジェクションターゲット名＞
　│
　├─[図データ]永続化ユニット参照※3
　│　　└─＜永続化ユニット参照名＞
　│　　　　　└─[図データ]インジェクション・ターゲット
　│　　　　　　　　└─＜インジェクションターゲット名＞
　│
　├─[図データ]PostConstructメソッド※3
　│　　└─＜PostConstructメソッド名＞
　│
　├─[図データ]PreDestroyメソッド※3
　│　　└─＜PreDestroyメソッド名＞
　│
　├─[図データ]ロケール・エンコーディング・マッピング・リスト
　│　　└─ロケール・エンコーディング・マッピング・リスト
　│　　　　└─＜ロケール＞
　│
　├─スレッド数制御
　│　　└─[図データ]URLスレッド数制御
　│　　　　└─＜URLグループのスレッド数制御定義名＞
　│　　　　　　├─[図データ]URLグループのスレッド数制御マッピング
　│　　　　　　│　└─＜URLパターン＞
　│　　　　　　└─状態モニター
　│　　　　　　　　└─実行待ちリクエスト数の監視
　├─HTTPリクエスト
　├─HTTPレスポンス
　└─JSP

注※1　Servlet2.4以降用のタグライブラリをまとめるノードです。

注※2　Servlet2.3以前用のタグライブラリをまとめるノードです。

注※3　Servlet2.5の場合に表示されます。

WAR属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。WAR属性のツリーノードとコンテキストメニューについて，次に説明します。

＜この項の構成＞

(1)　WAR属性のツリーノード

(2)　コンテキストメニュー操作

(1)　WAR属性のツリーノード

WAR属性のツリービューに表示されるノードを次に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。

表21-87　WAR属性ファイルのツリーのノード

ノード
説明
対応するタグ名
プロパティページ

＜WAR属性名＞
WAR属性を示すノードです。
選択すると，WARのプロパティページが表示されます。
WAR属性がない場合，「WARはありません」が表示されます。
<hitachi-war-property>
21.9.2　(1)

アイコン
WAR属性のアイコンを示すノードです。
選択すると，アイコンのプロパティページが表示されます。
<icon>
21.9.2　(2)

コンテキスト・パラメーター
コンテキストパラメタをまとめるノードです。
選択すると，パラメタの一覧ページが表示されます。
－
21.9.2　(3)

＜パラメタ＞
コンテキストパラメタを示すノードです。
選択すると，パラメタのプロパティページが表示されます。
<context-param>
21.9.2　(4)

フィルター・マッピング
フィルタマッピングをまとめるノードです。
選択すると，フィルタマッピングの一覧ページが表示されます。
－
21.9.2　(5)

＜フィルタ名＞
フィルタマッピングを示すノードです。
選択すると，<url-pattern>が指定されている場合はフィルタマッピング（URLパターン）のプロパティページが，<servlet-name>が指定されている場合はフィルタマッピング(サーブレット名)のプロパティページが表示されます。
<filter-mapping>
21.9.2　(6)，21.9.2　(7)

リスナー
リスナをまとめるノードです。
選択すると，リスナの一覧ページが表示されます。
－
21.9.2　(8)

＜リスナクラス＞
リスナを示すノードです。
選択すると，リスナのプロパティページが表示されます。
<listener>
21.9.2　(9)

アイコン
リスナのアイコンを示すノードです。
選択すると，アイコンのプロパティページが表示されます。
<icon>
21.9.2　(2)

セッションの設定
セッションの設定を示すノードです。
選択すると，セッションの設定のプロパティページが表示されます。
<session-config>
21.9.2　(10)

MIME タイプのマッピング
MIMEタイプのマッピングをまとめるノードです。
選択すると，MIMEタイプのマッピングの一覧ページが表示されます。
－
21.9.2　(11)

＜拡張子＞
MIMEタイプのマッピングを示すノードです。
選択すると，MIMEタイプのマッピングのプロパティページが表示されます。
<mime-mapping>
21.9.2　(12)

ウェルカム・ファイル・リスト
ウェルカムファイルリストをまとめるノードです。
－
－

ウェルカム・ファイル・リスト
ウェルカムファイルリストを示すノードです。
選択すると，ウェルカムファイルリストのプロパティページが表示されます。
<welcome-file-list>
21.9.2　(13)

＜ウェルカムファイル＞
ウェルカムファイルを示すノードです。
選択すると，ウェルカムファイルのプロパティページが表示されます。
<welcome-file>
21.9.2　(14)

エラー・ページ
エラーページをまとめるノードです。
選択すると，エラーページの一覧ページが表示されます。
－
21.9.2　(15)

＜エラーコード＞または＜例外クラス＞
エラーページを示すノードです。
選択すると，<error-code>が指定されている場合はエラーページ(エラーコード)のプロパティページが，<exception-type>が指定されている場合は，エラーページ(例外クラス)のプロパティページが表示されます。
<error-page>
21.9.2　(16)，
21.9.2　(17)

JSPの設定
JSPの設定を示すノードです。
<jsp-config>
－

タグ・ライブラリー※
タグライブラリをまとめるノードです。
選択すると，タグライブラリの一覧ページが表示されます。
－
21.9.2　(18)

＜タグライブラリのURI＞
タグライブラリを示すノードです。
選択すると，タグライブラリのプロパティページが表示されます。
<taglib>
21.9.2　(19)

JSPプロパティー・グループ
JSPプロパティグループをまとめるノードです。
選択すると，JSPプロパティグループの一覧ページが表示されます。
－
21.9.2　(20)

先頭の＜URLパターン＞
JSPプロパティグループを示すノードです。
選択すると，JSPプロパティグループのプロパティページが表示されます。
<jsp-property-group>
21.9.2　(21)

アイコン
JSPプロパティグループのアイコンを示すノードです。
選択すると，アイコンのプロパティページが表示されます。
<icon>
21.9.2　(2)

URLパターン
URLパターンをまとめるノードです。
選択すると，URLパターンの一覧ページが表示されます。
－
21.9.2　(22)

＜URLパターン＞
URLパターンを示すノードです。
選択すると，URLパターンのプロパティページが表示されます。
<url-pattern>
21.9.2　(23)

ヘッダーにインクルードするファイル
ヘッダにインクルードするファイルをまとめるノードです。
選択すると，ヘッダにインクルードするファイルの一覧ページが表示されます。
－
21.9.2　(24)

＜ヘッダにインクルードするファイル＞
ヘッダにインクルードするファイルを示すノードです。
選択すると，ヘッダにインクルードするファイルのプロパティページが表示されます。
<include-prelude>
21.9.2　(25)

フッターにインクルードするファイル
フッタにインクルードするファイルをまとめるノードです。
選択すると，フッタにインクルードするファイルの一覧ページが表示されます。
－
21.9.2　(26)

＜フッタにインクルードするファイル＞
フッタにインクルードするファイルを示すノードです。
選択すると，フッターにインクルードするファイルのプロパティページが表示されます。
<include-coda>
21.9.2　(27)

タグ・ライブラリー※
タグライブラリをまとめるノードです。
選択すると，タグライブラリの一覧ページが表示されます。
－
21.9.2　(18)

＜タグライブラリのURI＞
タグライブラリを示すノードです。
選択すると，タグライブラリのプロパティページが表示されます。
<taglib>
21.9.2　(19)

ログインの設定
ログインの設定を示すノードです。
選択すると，ログインの設定のプロパティページが表示されます。
<login-config>
21.9.2　(28)

環境エントリー
環境エントリをまとめるノードです。
選択すると，環境エントリの一覧のページが表示されます。
－
21.9.2　(29)

＜環境エントリ名＞
環境エントリを示すノードです。
選択すると，環境エントリのプロパティページが表示されます。
<env-entry>
21.9.2　(30)

インジェクション・ターゲット
インジェクションターゲットをまとめるノードです。
選択すると，インジェクションターゲットの一覧のページが表示されます。
－
21.9.2　(31)

＜インジェクションターゲット名＞
インジェクションターゲットを示すノードです。
選択すると，インジェクションターゲットのプロパティページが表示されます。
<injection-target>
21.9.2　(32)

リモートEJBへの参照
リモートEJBへの参照をまとめるノードです。
選択すると，リモートEJBへの参照の一覧ページが表示されます。
－
21.9.2　(33)

＜リモートEJBへの参照名＞
リモートEJBへの参照を示すノードです。
<ejb-ref>内の<ejb-ref-name>の内容が表示されます。
選択すると，リモートEJBへの参照のプロパティページが表示されます。
<ejb-ref>
21.9.2　(34)

インジェクション・ターゲット
インジェクションターゲットをまとめるノードです。
選択すると，インジェクションターゲットの一覧のページが表示されます。
－
21.9.2　(31)

＜インジェクションターゲット名＞
インジェクションターゲットを示すノードです。
選択すると，インジェクションターゲットのプロパティページが表示されます。
<injection-target>
21.9.2　(32)

ローカルEJBへの参照
ローカルEJBへの参照をまとめるノードです。
選択すると，ローカルEJBへの参照の一覧ページが表示されます。
－
21.9.2　(35)

＜ローカルEJBへの参照名＞
ローカルEJBへの参照を示すノードです。
選択すると，ローカルEJBへの参照のプロパティページが表示されます。
<ejb-local-ref>
21.9.2　(36)

インジェクション・ターゲット
インジェクションターゲットをまとめるノードです。
選択すると，インジェクションターゲットの一覧のページが表示されます。
－
21.9.2　(31)

＜インジェクションターゲット名＞
インジェクションターゲットを示すノードです。
選択すると，インジェクションターゲットのプロパティページが表示されます。
<injection-target>
21.9.2　(32)

リソース参照
リソース参照をまとめるノードです。
「リソース参照」が表示されます。
選択すると，リソース参照の一覧ページが表示されます。
－
21.9.2　(37)

＜リソース参照名＞
リソース参照を示すノードです。
選択すると，リソース参照のプロパティページが表示されます。
<resource-ref>
21.9.2　(38)

インジェクション・ターゲット
インジェクションターゲットをまとめるノードです。
選択すると，インジェクションターゲットの一覧のページが表示されます。
－
21.9.2　(31)

＜インジェクションターゲット名＞
インジェクションターゲットを示すノードです。
選択すると，インジェクションターゲットのプロパティページが表示されます。
<injection-target>
21.9.2　(32)

リソース環境変数
リソース環境変数をまとめるノードです。
選択すると，リソース環境変数の一覧ページが表示されます。
－
21.9.2　(39)

＜リソース環境変数名＞
リソース環境変数を示すノードです。
選択すると，リソース環境変数のプロパティページが表示されます。
<resource-env-ref>
21.9.2　(40)

インジェクション・ターゲット
インジェクションターゲットをまとめるノードです。
選択すると，インジェクションターゲットの一覧のページが表示されます。
－
21.9.2　(31)

＜インジェクションターゲット名＞
インジェクションターゲットを示すノードです。
選択すると，インジェクションターゲットのプロパティページが表示されます。
<injection-target>
21.9.2　(32)

リンク先キュー
リンク先キューを示すノードです。
選択すると，リンク先キューのプロパティページが表示されます。
<linked-queue>
21.9.2　(41)

リンク先の管理対象オブジェクト
リンク先の管理対象オブジェクトを示すノードです。
選択すると，リンク先の管理対象オブジェクトのプロパティページが表示されます。
<linked-adminobject>
21.9.2　(42)

永続化コンテキスト参照
永続化コンテキスト参照をまとめるノードです。
選択すると，永続化コンテキスト参照の一覧ページが表示されます。
－
21.9.2　(43)

＜永続化コンテキスト参照名＞
永続化コンテキスト参照を示すノードです。
選択すると，永続化コンテキスト参照のプロパティページが表示されます。
<persistence-context-ref>
21.9.2　(44)

永続化のプロパティー
永続化のプロパティをまとめるノードです。
選択すると，永続化のプロパティのプロパティページが表示されます。
－
21.9.2　(45)

＜永続化のプロパティ名＞
永続化のプロパティを示すノードです。
選択すると，永続化プロパティのプロパティページが表示されます。
<persistence-property>
21.9.2　(46)

インジェクション・ターゲット
インジェクションターゲットをまとめるノードです。
選択すると，インジェクションターゲットの一覧のページが表示されます。
－
21.9.2　(31)

＜インジェクションターゲット名＞
インジェクションターゲットを示すノードです。
選択すると，インジェクションターゲットのプロパティページが表示されます。
<injection-target>
21.9.2　(32)

永続化ユニット参照
永続化ユニットをまとめるノードです。
選択すると，永続化ユニット参照の一覧のページが表示されます。
－
21.9.2　(47)

＜永続化ユニット参照名＞
永続化ユニットを示すノードです。
選択すると，永続化ユニット参照のプロパティページが表示されます。
<persistence-unit-ref-name>
21.9.2　(48)

インジェクション・ターゲット
インジェクションターゲットをまとめるノードです。
選択すると，インジェクションターゲットの一覧のページが表示されます。
－
21.9.2　(31)

＜インジェクションターゲット名＞
インジェクションターゲットを示すノードです。
選択すると，インジェクションターゲットのプロパティページが表示されます。
<injection-target>
21.9.2　(32)

PostConstructメソッド
PostConstructメソッドをまとめるノードです。
選択すると，PostConstructメソッドの一覧のページが表示されます。
－
21.9.2　(49)

＜PostConstructメソッド名＞
PostConstructメソッドを示すノードです。
選択すると，PostConstructメソッドのプロパティページが表示されます。
<post-construct>
21.9.2　(50)

PreDestroyメソッド
PreDestroyメソッドをまとめるノードです。
選択すると，PreDestroyメソッドの一覧のページが表示されます。
－
21.9.2　(51)

＜PreDestroyメソッド名＞
PreDestroyメソッドを示すノードです。
選択すると，PreDestroyメソッドのプロパティページが表示されます。
<pre-destroy>
21.9.2　(52)

ロケール・エンコーディング・マッピング・リスト
ロケールエンコーディングマッピングリストをまとめるノードです。
－
－

ロケール・エンコーディング・マッピング・リスト
ロケールエンコーディングマッピングリストを示すノードです。
選択すると，ロケールエンコーディングマッピングの一覧ページが表示されます。
<locale-encoding-mapping-list>
21.9.2　(53)

＜ロケール＞
ロケールを示すノードです。
選択すると，ロケールエンコーディングマッピングのプロパティページが表示されます。
<local-encoding- mapping >
21.9.2　(54)

スレッド数制御
スレッド数制御を示すノードです。
選択すると，スレッド数制御のプロパティページが表示されます。
<thread-control>
21.9.2　(55)

URLグループのスレッド数制御
URLグループのスレッド数制御をまとめるノードです。
「URLグループのスレッド数制御」が表示されます。
選択すると，URLグループのスレッド数制御の一覧ページが表示されます。
－
21.9.2　(56)

＜URLグループのスレッド数制御定義名＞
URLグループのスレッド数制御を示すノードです。
選択すると，URLグループのスレッド数制御のプロパティページが表示されます。
<urlgroup-thread-control>
21.9.2　(57)

URLグループのスレッド数制御マッピング
URLグループのスレッド数制御マッピングをまとめるノードです。
選択すると，URLグループの スレッド数制御のマッピングの一覧ページが表示されます。
－
21.9.2　(58)

＜URLパターン＞
URLグループのスレッド数制御マッピングを示すノードです。
選択すると，URLグループのスレッド数制御マッピングのプロパティページが表示されます。
<urlgroup-thread-control-mapping>
21.9.2　(59)

状態モニター
状態モニタを示すノードです。
<stats-monitor>
－

実行待ちリクエスト数の監視
URLグループ単位の実行待ちリクエスト数の監視を示すノードです。
選択すると，実行待ちリクエスト数の監視のプロパティページが表示されます。
<waiting-request-count>
21.9.2　(60)

HTTPリクエスト
HTTPリクエストを示すノードです。
選択すると，HTTPリクエストのプロパティページが表示されます。
<http-request>
21.9.2　(61)

HTTPレスポンス
HTTPレスポンスを示すノードです。
選択すると，HTTPレスポンスのプロパティページが表示されます。
<http-response>
21.9.2　(62)

JSP
JSPを示すノードです。
選択すると，JSPのプロパティページが表示されます。
<jsp>
21.9.2　(63)

（凡例）　－：該当なし

注※　Servlet2.3以前の場合は，WAR属性直下の［タグ・ライブラリー］を設定してください。Servlet2.4以降の場合は，［JSPの設定］下の［タグ・ライブラリー］などを設定してください。

(2)　コンテキストメニュー操作

WAR属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-88　WAR属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

＜WAR属性名＞
［追加］ - ［アイコン］
アイコンが追加されます。アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.9.2　(2)

［追加］ - ［コンテキスト・パラメーター］
コンテキストパラメタが追加されます。パラメタのプロパティページが表示されます。
21.9.2　(4)

［追加］ - ［フィルター・マッピング（URLパターン）］
フィルタマッピング（URLパターン）が追加されます。フィルタマッピング（URLパターン）のプロパティページが表示されます。
ただし，アプリケーション統合属性ファイルにフィルタ属性がない場合は選択できません。
21.9.2　(6)

［追加］ - ［フィルター・マッピング（サーブレット名）］
フィルタマッピング（サーブレット名）が追加されます。フィルタマッピング（サーブレット名）のプロパティページが表示されます。
ただし，アプリケーション統合属性ファイルにフィルタ属性またはサーブレット属性がない場合は選択できません。
21.9.2　(7)

［追加］ - ［リスナー］
リスナが追加されます。リスナのプロパティページが表示されます。
21.9.2　(9)

［追加］ - ［セッションの設定］
セッションの設定が追加されます。セッションの設定のプロパティページが表示されます。
ただし，すでにセッションの設定がある場合は選択できません。
21.9.2　(10)

［追加］ - ［MIME タイプのマッピング］
MIMEタイプのマッピングが追加されます。MIMEタイプのマッピングの一覧ページが表示されます。
21.9.2　(11)

［追加］ - ［ウェルカム・ファイル・リスト］
ウェルカムファイルリスト，およびウェルカムファイルが追加されます。ウェルカムファイルのプロパティページが表示されます。
21.9.2　(14)

［追加］ - ［エラー・ページ（エラー・コード）］
エラーページ（エラーコード）が追加されます。エラーページ（エラーコード）のプロパティページが表示されます。
21.9.2　(16)

［追加］ - ［エラー・ページ（例外クラス）］
エラーページ（例外クラス）が追加されます。エラーページ（例外クラス）のプロパティページが表示されます。
21.9.2　(17)

［追加］ - ［JSPの設定］
ツリービューに「JSPの設定」が追加されます。
ただし，すでにJSPの設定がある場合は選択できません。
－

［追加］ - ［タグ・ライブラリー］※
タグライブラリが追加されます。タグライブラリのプロパティページが表示されます。
ただし，すでに＜WAR属性名＞，または「JSPの設定」の直下にタグライブラリがある場合は選択できません。
21.9.2　(19)

［追加］ - ［ログインの設定］
ログインの設定が追加されます。ログインの設定のプロパティページが表示されます。
ただし，すでにログインの設定がある場合は選択できません。
21.9.2　(28)

［追加］ - ［環境エントリー］
環境エントリが追加されます。環境エントリのプロパティページが表示されます。
21.9.2　(30)

［追加］ - ［リモートEJBへの参照］
リモートEJBへの参照が追加されます。リモートEJBへの参照のプロパティページが表示されます。
21.9.2　(34)

［追加］ - ［ローカルEJBへの参照］
ローカルEJBへの参照が追加されます。ローカルEJBへの参照のプロパティページが表示されます。
21.9.2　(36)

［追加］ - ［リソース参照］
WAR属性にリソース参照が追加されます。リソース参照のプロパティページが表示されます。
21.9.2　(38)

［追加］ - ［リソース環境変数］
リソース環境変数が追加されます。リソース環境変数のプロパティページが表示されます。
21.9.2　(40)

［追加］ - ［永続化コンテキスト参照］
永続化コンテキスト参照が追加されます。永続化コンテキスト参照のプロパティページが表示されます。
21.9.2　(44)

［追加］ - ［永続化ユニット参照］
永続化ユニット参照が追加されます。永続化ユニット参照のプロパティページが表示されます。
21.9.2　(48)

［追加］ - ［PostConstructメソッド］
PostConstructメソッドが追加されます。PostConstructメソッドのプロパティページが表示されます。
21.9.2　(50)

［追加］ - ［PreDestroyメソッド］
PreDestroyメソッドが追加されます。PreDestroyメソッドのプロパティページが表示されます。
21.9.2　(52)

［追加］ - ［ロケール・エンコーディング・マッピング・リスト］
ロケールエンコーディングマッピングリストおよびロケールエンコーディングマッピングが追加されます。
ロケールエンコーディングマッピングのプロパティページが表示されます。
21.9.2　(54)

［追加］ - ［スレッド数制御］
スレッド数制御が追加されます。スレッド数制御のプロパティページが表示されます。
ただし，すでにスレッド数制御がある場合は選択できません。
21.9.2　(55)

［追加］ - ［HTTPリクエスト］
HTTPリクエストが追加されます。HTTPリクエストのプロパティページが表示されます。
ただし，すでにHTTPリクエストがある場合は選択できません。
21.9.2　(61)

［追加］ - ［HTTPレスポンス］
HTTPレスポンスが追加されます。HTTPレスポンスのプロパティページが表示されます。
ただし，すでにHTTPレスポンスがある場合は選択できません。
21.9.2　(62)

［追加］ - ［JSP］
JSPが追加されます。JSPのプロパティページが表示されます。
ただし，すでにJSPがある場合は選択できません。
21.9.2　(63)

アイコン
［削除］
WAR属性からアイコンが削除されます。
－

コンテキスト・パラメーター
［追加］ - ［コンテキスト・パラメーター］
コンテキストパラメタが追加されます。パラメタのプロパティページが表示されます。
21.9.2　(4)

［削除］
WAR属性から，すべてのコンテキストパラメタが削除されます。
－

＜パラメタ＞
［削除］
WAR属性から，選択したコンテキストパラメタが削除されます。
－

フィルター・マッピング
［追加］ - ［フィルター・マッピング（URLパターン）］
フィルタマッピング（URLパターン）が追加されます。フィルタマッピング（URLパターン）のプロパティページが表示されます。
ただし，アプリケーション統合属性ファイルにフィルタ属性がない場合は選択できません。
21.9.2　(6)

［追加］ - ［フィルター・マッピング（サーブレット名）］
フィルタマッピング（サーブレット名）が追加されます。フィルタマッピング（サーブレット名）のプロパティページが表示されます。
ただし，アプリケーション統合属性ファイルにフィルタ属性がない場合は選択できません。
21.9.2　(7)

［削除］
WAR属性から，すべてのフィルタマッピングが削除されます。
－

＜フィルタ名＞
［削除］
WAR属性から，選択したフィルタマッピングが削除されます。
－

リスナー
［追加］ - ［リスナー］
リスナが追加されます。リスナのプロパティページが表示されます。
21.9.2　(9)

［削除］
WAR属性から，すべてのリスナが削除されます。
－

＜リスナクラス＞
［追加］ - ［アイコン］
アイコンが追加されます。アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.9.2　(2)

［削除］
WAR属性から，選択したリスナが削除されます。
－

アイコン
［削除］
リスナからアイコンが削除されます。
－

セッションの設定
［削除］
WAR属性からセッションの設定が削除されます。
－

MIMEタイプのマッピング
［追加］ - ［MIMEタイプのマッピング］
MIMEタイプのマッピングが追加されます。MIMEタイプのマッピングの一覧ページが表示されます。
21.9.2　(11)

［削除］
WAR属性から，すべてのMIMEタイプのマッピングが削除されます。
－

＜拡張子＞
［削除］
選択したMIMEタイプのマッピングが削除されます。
－

ウェルカム・ファイル・リスト
［追加］ - ［ウェルカム・ファイル・リスト］
「ウェルカム・ファイル・リスト」と＜ウェルカムファイル＞が追加されます。
ウェルカムファイルのプロパティページが表示されます。
21.9.2　(14)

［削除］
WAR属性から，すべてのウェルカムファイルリストが削除されます。
－

ウェルカム・ファイル・リスト
［追加］ - ［ウェルカム・ファイル］
ウェルカムファイルが追加されます。ウェルカムファイルのプロパティページが表示されます。
21.9.2　(14)

［削除］
WAR属性から，ウェルカムファイルリストとリストに含まれるすべてのウェルカムファイルが削除されます。
－

＜ウェルカムファイル＞
［削除］
ウェルカムファイルリストから，選択したウェルカムファイルが削除されます。
ただし，ウェルカムファイルリストにウェルカムファイルが一つもない場合は選択できません。
－

エラー・ページ
［追加］ - ［エラー・ページ（エラー・コード）］
エラーページ（エラーコード）が追加されます。エラーページ（エラーコード）のプロパティページが表示されます。
21.9.2　(16)

［追加］ - ［エラー・ページ（例外クラス）］
エラーページ（例外クラス）が追加されます。エラーページ（例外クラス）のプロパティページが表示されます。
21.9.2　(17)

［削除］
WAR属性から，すべてのエラーページが削除されます。
－

＜エラーコード＞または＜例外クラス＞
［削除］
WAR属性から，選択したエラーページが削除されます。
－

JSPの設定
［追加］ - ［タグ・ライブラリー］※
Servlet2.4以降用のタグライブラリが追加されます。
タグライブラリのプロパティページが表示されます。
ただし，すでにJSPの設定にタグライブラリがある場合は選択できません。
21.9.2　(19)

［追加］ - ［JSPプロパティー・グループ］
JSPプロパティグループが追加されます。JSPプロパティグループのプロパティページが表示されます。
21.9.2　(21)

［削除］
WAR属性からJSPの設定が削除されます。
－

タグ・ライブラリー
［追加］ - ［タグ・ライブラリー］
タグライブラリが追加されます。タグライブラリのプロパティページが表示されます。
21.9.2　(19)

［削除］
JSPの設定から，すべてのタグライブラリが削除されます。
－

＜タグライブラリのURI＞
［削除］
JSPの設定から，選択したタグライブラリが削除されます。
－

JSPプロパティー・グループ
［追加］ - ［JSPプロパティー・グループ］
JSPプロパティグループが追加されます。JSPプロパティグループのプロパティページが表示されます。
21.9.2　(21)

［削除］
JSPの設定から，すべてのJSPプロパティグループが削除されます。
－

先頭の＜URLパターン＞
［追加］ - ［アイコン］
アイコンが追加されます。
アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.9.2　(2)

［追加］ - ［URLパターン］
URLパターンが追加されます。URLパターンのプロパティページが表示されます。
21.9.2　(23)

［追加］ - ［ヘッダーにインクルードするファイル］
ヘッダにインクルードするファイルが追加されます。
ヘッダにインクルードするファイルのプロパティページが表示されます。
21.9.2　(25)

［追加］ - ［フッターにインクルードするファイル］
フッタにインクルードするファイルが追加されます。
フッタにインクルードするファイルのプロパティページが表示されます。
21.9.2　(27)

［削除］
JSPの設定から，選択したJSPプロパティグループが削除されます。
－

アイコン
［削除］
JSPプロパティグループからアイコンが削除されます。
－

URLパターン
［追加］ - ［URLパターン］
URLパターンが追加されます。URLパターンのプロパティページが表示されます。
21.9.2　(23)

＜URLパターン＞
［削除］
JSPプロパティグループから，選択したURLパターンが削除されます。ただし，URLパターンが一つだけの場合は選択できません。
－

ヘッダーにインクルードするファイル
［追加］ - ［ヘッダーにインクルードするファイル］
ヘッダにインクルードするファイルが追加されます。
ヘッダにインクルードするファイルのプロパティページが表示されます。
21.9.2　(25)

［削除］
JSPプロパティグループから，ヘッダにインクルードするファイルがすべて削除されます。
－

＜ヘッダにインクルードするファイル＞
［削除］
JSPプロパティグループから，選択したヘッダにインクルードするファイルが削除されます。
－

フッターにインクルードするファイル
［追加］ - ［フッターにインクルードするファイル］
フッタにインクルードするファイルが追加されます。
フッタにインクルードするファイルのプロパティページが表示されます。
21.9.2　(27)

［削除］
JSPプロパティグループから，フッタにインクルードするファイルがすべて削除されます。
－

＜フッタにインクルードするファイル＞
［削除］
JSPプロパティグループから，選択したフッタにインクルードするファイルが削除されます。
－

タグ・ライブラリー
［追加］ - ［タグ・ライブラリー］
Servlet2.3以前用のタグライブラリが追加されます。タグライブラリのプロパティページが表示されます。
21.9.2　(19)

［削除］
WAR属性から，すべてのタグライブラリ(Servlet2.3以前用)が削除されます。
－

＜タグライブラリのURI＞
［削除］
タグライブラリのURI（Servlet2.3以前用）から，選択したタグライブラリが削除されます。
－

ログインの設定
［削除］
WAR属性からログインの設定が削除されます。
－

環境エントリー
［追加］ - ［環境エントリー］
環境エントリが追加されます。環境エントリのプロパティページが表示されます。
21.9.2　(30)

［削除］
WAR属性から，すべての環境エントリーが削除されます。
－

＜環境エントリ名＞
［追加］ - ［インジェクション・ターゲット］
＜環境エントリ名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
WAR属性から，選択した環境エントリが削除されます。
－

インジェクション・ターゲット
［追加］ - ［インジェクション・ターゲット］
＜環境エントリ名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
＜環境エントリ名＞から，すべてのインジェクションターゲットが削除されます。
－

＜インジェクションターゲット名＞
［削除］
＜環境エントリ名＞から，選択したインジェクションターゲットが削除されます。
－

リモートEJBへの参照
［追加］ - ［リモートEJBへの参照］
リモートEJBへの参照が追加されます。
リモートEJBへの参照のプロパティページが表示されます。
21.9.2　(34)

［削除］
WAR属性から，すべてのリモートEJBへの参照が削除されます。
－

＜リモートEJBへの参照＞
［追加］ - ［インジェクション・ターゲット］
＜リモートEJBへの参照＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
WAR属性から，選択したリモートEJBへの参照が削除されます。
－

インジェクション・ターゲット
［追加］ - ［インジェクション・ターゲット］
＜リモートEJBへの参照＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
＜リモートEJBへの参照＞から，すべてのインジェクションターゲットが削除されます。
－

＜インジェクションターゲット名＞
［削除］
＜リモートEJBへの参照＞から，選択したインジェクションターゲットが削除されます。
－

ローカルEJBへの参照
［追加］ - ［ローカルEJBへの参照］
ローカルEJBへの参照が追加されます。
ローカルEJBへの参照のプロパティページが表示されます。
21.9.2　(36)

［削除］
WAR属性から，すべてのローカルEJBへの参照が削除されます。
－

＜ローカルEJBへの参照名＞
［追加］ - ［インジェクション・ターゲット］
＜ローカルEJBへの参照名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
WAR属性から，選択したローカルEJBへの参照が削除されます。
－

インジェクション・ターゲット
［追加］ - ［インジェクション・ターゲット］
＜ローカルEJBへの参照名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
＜ローカルEJBへの参照名＞から，すべてのインジェクションターゲットが削除されます。
－

＜インジェクションターゲット名＞
［削除］
＜ローカルEJBへの参照名＞から，選択したインジェクションターゲットが削除されます。
－

リソース参照
［追加］ - ［リソース参照］
リソース参照が追加されます。
リソース参照のプロパティページが表示されます。
21.9.2　(38)

［削除］
WAR属性から，すべてのリソース参照が削除されます。
－

＜リソース参照名＞
［追加］ - ［インジェクション・ターゲット］
＜リソース参照名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
WAR属性から，選択したリソース参照が削除されます。
－

インジェクション・ターゲット
［追加］ - ［インジェクション・ターゲット］
＜リソース参照名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
＜リソース参照名＞から，すべてのインジェクションターゲットが削除されます。
－

＜インジェクションターゲット名＞
［削除］
＜リソース参照名＞から，選択したインジェクションターゲットが削除されます。
－

リソース環境変数
［追加］ - ［リソース環境変数］
リソース環境変数が追加されます。リソース環境変数のプロパティページが表示されます。
21.9.2　(40)

［削除］
WAR属性から，すべてのリソース環境変数が削除されます。
－

＜リソース環境変数名＞
［追加］ - ［インジェクション・ターゲット］
＜リソース環境変数名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［追加］ - ［リンク先キュー］
リンク先キューが追加されます。リンク先キューのプロパティページが表示されます。
21.9.2　(41)

［追加］ - ［リンク先の管理対象オブジェクト］
リンク先の管理対象オブジェクトが追加されます。リンク先の管理対象オブジェクトのプロパティページが表示されます。
21.9.2　(42)

［削除］
WAR属性から，選択したリソース環境変数が削除されます。
－

インジェクション・ターゲット
［追加］ - ［インジェクション・ターゲット］
＜リソース環境変数名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
＜リソース環境変数名＞から，すべてのインジェクションターゲットが削除されます。
－

＜インジェクションターゲット名＞
［削除］
＜リソース環境変数名＞から，選択したインジェクションターゲットが削除されます。
－

リンク先キュー
［削除］
リソース環境変数からリンク先キューが削除されます。
－

リンク先の管理対象オブジェクト
［削除］
リソース環境変数から，選択したリンク先の管理対象オブジェクトが削除されます。
－

永続化コンテキスト参照
［追加］ - ［永続化コンテキスト参照］
永続化コンテキスト参照が追加されます。永続化コンテキスト参照のプロパティページが表示されます。
21.9.2　(44)

＜永続化コンテキスト参照名＞
［追加］ - ［永続化のプロパティー］
永続化のプロパティが追加されます。永続化のプロパティのプロパティページが表示されます。
21.9.2　(46)

［追加］ - ［インジェクション・ターゲット］
＜永続化コンテキスト参照名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
WAR属性から，選択した永続化コンテキスト参照が削除されます。
－

永続化のプロパティ－
［追加］ - ［永続化のプロパティ－］
永続化のプロパティ－が追加されます。永続化のプロパティのプロパティページが表示されます。
21.9.2　(46)

＜永続化のプロパティ名＞
［削除］
永続化コンテキスト参照から，選択した永続化のプロパティが削除されます。
－

インジェクション・ターゲット
［追加］ - ［インジェクション・ターゲット］
＜永続化コンテキスト参照名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
＜永続化コンテキスト参照名＞から，すべてのインジェクションターゲットが削除されます。
－

＜インジェクションターゲット名＞
［削除］
＜永続化コンテキスト参照名＞から，選択したインジェクションターゲットが削除されます。
－

永続化ユニット参照
［追加］ - ［永続化ユニット］
永続化ユニット参照が追加されます。永続化ユニット参照のプロパティページが表示されます。
21.9.2　(48)

＜永続化ユニット参照名＞
［追加］ - ［インジェクション・ターゲット］
＜永続化ユニット参照名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
WAR属性から，選択した永続化ユニットが削除されます。
－

インジェクション・ターゲット
［追加］ - ［インジェクション・ターゲット］
＜永続化ユニット参照名＞にインジェクションターゲットが追加されます。インジェクションターゲットのプロパティページが表示されます。
21.9.2　(32)

［削除］
＜永続化ユニット参照名＞から，すべてのインジェクションターゲットが削除されます。
－

＜インジェクションターゲット名＞
［削除］
＜永続化ユニット参照名＞から，選択したインジェクションターゲットが削除されます。
－

PostConstructメソッド
［追加］ - ［PostConstructメソッド］
PostConstructメソッドが追加されます。PostConstructメソッドのプロパティページが表示されます。
21.9.2　(50)

［削除］
WAR属性から，すべてのPostConstructメソッドが削除されます。
－

＜PostConstructメソッド名＞
［削除］
WAR属性から，選択したPostConstructメソッドが削除されます。
－

PreDestroyメソッド
［追加］ - ［PreDestroyメソッド］
PreDestroyメソッドが追加されます。PreDestroyメソッドのプロパティページが表示されます。
21.9.2　(52)

［削除］
WAR属性から，すべてのPreDestroyメソッドが削除されます。
－

＜PreDestroyメソッド名＞
［削除］
WAR属性から，選択したPreDestroyメソッドが削除されます。
－

ロケール・エンコーディング・マッピング・リスト
［追加］ - ［ロケール・エンコーディング・マッピング・リスト］
ロケールエンコーディングマッピングリストとロケールエンコーディングマッピングを追加します。ロケールエンコーディングマッピングのプロパティページが表示されます。
21.9.2　(54)

［削除］
WAR属性から，すべてのロケールエンコーディングマッピングリストが削除されます。
－

ロケール・エンコーディング・マッピング・リスト
［追加］ - ［ロケール・エンコーディング・マッピング］
ロケールエンコーディングマッピングが追加されます。ロケールエンコーディングマッピングのプロパティページが表示されます。
21.9.2　(54)

［削除］
WAR属性から，選択したロケールエンコーディングマッピングリストが削除されます。
－

＜ロケール＞
［削除］
ロケール・エンコーディング・マッピング・リストから選択したロケールエンコーディングマッピングが削除されます。
ただし，ロケールエンコーディングマッピングが一つしかない場合は選択できません。
－

スレッド数制御
［追加］ - ［URLグループのスレッド数制御］
URLグループのスレッド数制御が追加されます。URLグループのスレッド数制御のプロパティページが表示されます。
21.9.2　(57)

［削除］
WAR属性からスレッド数制御が削除されます。
－

URLグループのスレッド数制御
［追加］ - ［URLグループのスレッド数制御］
URLグループのスレッド数制御が追加されます。URLグループのスレッド数制御のプロパティページが表示されます。
21.9.2　(57)

［削除］
URLグループのスレッド数制御から，すべてのURLグループのスレッド数制御が削除されます。
－

＜URLグループのスレッド数制御定義名＞
［追加］ - ［URLグループのスレッド数制御マッピング］
URLグループのスレッド数制御マッピングが追加されます。URLグループのスレッド数制御マッピングのプロパティページが表示されます。
21.9.2　(59)

［削除］
スレッド数制御から，選択したURLグループのスレッド数制御が削除されます。
－

URLグループのスレッド数制御マッピング
［追加］ - ［URLグループのスレッド数制御マッピング］
URLグループのスレッド数制御マッピングが追加されます。URLグループのスレッド数制御マッピングのプロパティページが表示されます。
21.9.2　(59)

［削除］
URLグループのスレッド数制御から，すべてのURLグループのスレッド数制御マッピングが削除されます。
－

＜URLパターン＞
［削除］
URLグループのスレッド数制御から，選択したURLグループのスレッド数制御御マッピングが削除されます。
－

HTTPリクエスト
［削除］
WAR属性からHTTPリクエストが削除されます。
－

HTTPレスポンス
［削除］
WAR属性からHTTPレスポンスが削除されます。
－

JSP
［削除］
WAR属性からJSPが削除されます。
－

（凡例）　－：該当なし

注※　Servlet2.3以前の場合は，WAR属性直下の［タグ・ライブラリー］に追加してください。Servlet2.4以降の場合は，［JSPの設定］下の［タグ・ライブラリー］に追加してください。

21.9.2　WAR属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。［エレメントの詳細］に編集するWAR属性ファイルのプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアの表示が切り替わります。

WAR属性ファイルには，次のプロパティページがあります。

WARのプロパティページ

アイコンのプロパティページ

パラメタの一覧ページ

パラメタのプロパティページ

フィルタマッピングの一覧ページ

フィルタマッピング（URLパターン）のプロパティページ

フィルタマッピング（サーブレット名）のプロパティページ

リスナの一覧ページ

リスナのプロパティページ

セッションの設定のプロパティページ

MIMEタイプのマッピングの一覧ページ

MIMEタイプのマッピングのプロパティページ

ウェルカムファイルリストのプロパティページ

ウェルカムファイルのプロパティページ

エラーページの一覧ページ

エラーページ（エラーコード）のプロパティページ

エラーページ（例外クラス）のプロパティページ

タグライブラリの一覧ページ

タグライブラリのプロパティページ

JSPプロパティグループの一覧ページ

JSPプロパティグループのプロパティページ

URLパターンの一覧ページ

URLパターンのプロパティページ

ヘッダにインクルードするファイルの一覧ページ

ヘッダにインクルードするファイルのプロパティページ

フッタにインクルードするファイルの一覧ページ

フッタにインクルードするファイルのプロパティページ

ログインの設定のプロパティページ

環境エントリの一覧のページ

環境エントリのプロパティページ

インジェクションターゲットの一覧のページ

インジェクションターゲットのプロパティページ

リモートEJBへの参照の一覧ページ

リモートEJBへの参照のプロパティページ

ローカルEJBへの参照の一覧ページ

ローカルEJBへの参照のプロパティページ

リソース参照の一覧のページ

リソース参照のプロパティページ

リソース環境変数の一覧ページ

リソース環境変数のプロパティページ

リンク先キューのプロパティページ

リンク先の管理対象オブジェクトのプロパティページ

永続化コンテキスト参照の一覧ページ

永続化コンテキスト参照のプロパティページ

永続化プロパティの一覧のページ

永続化プロパティのプロパティページ

永続化ユニット参照の一覧のページ

永続化ユニット参照のプロパティページ

PostConstructメソッドの一覧のページ

PostConstructメソッドのプロパティページ

PreDestroyメソッドの一覧のページ

PreDestroyメソッドのプロパティページ

ロケールエンコーディングマッピングの一覧ページ

ロケールエンコーディングマッピングのプロパティページ

スレッド数制御のプロパティページ

URLグループのスレッド数制御の一覧ページ

URLグループのスレッド数制御のプロパティページ

URLグループのスレッド数制御マッピングの一覧ページ

URLグループのスレッド数制御マッピングのプロパティページ

実行待ちリクエスト数の監視のプロパティページ

HTTPリクエストのプロパティページ

HTTPレスポンスのプロパティページ

JSPのプロパティページ

注意事項

プロパティページで，設定が必須の項目には「*」が付与されています。

＜この項の構成＞

(1)　WARのプロパティページ

(2)　アイコンのプロパティページ

(3)　パラメタの一覧ページ

(4)　パラメタのプロパティページ

(5)　フィルタマッピングの一覧ページ

(6)　フィルタマッピング（URLパターン）のプロパティページ

(7)　フィルタマッピング（サーブレット名）のプロパティページ

(8)　リスナの一覧ページ

(9)　リスナのプロパティページ

(10)　セッションの設定のプロパティページ

(11)　MIMEタイプのマッピングの一覧ページ

(12)　MIMEタイプのマッピングのプロパティページ

(13)　ウェルカムファイルリストのプロパティページ

(14)　ウェルカムファイルのプロパティページ

(15)　エラーページの一覧ページ

(16)　エラーページ（エラーコード）のプロパティページ

(17)　エラーページ（例外クラス）のプロパティページ

(18)　タグライブラリの一覧ページ

(19)　タグライブラリのプロパティページ

(20)　JSPプロパティグループの一覧ページ

(21)　JSPプロパティグループのプロパティページ

(22)　URLパターンの一覧ページ

(23)　URLパターンのプロパティページ

(24)　ヘッダにインクルードするファイルの一覧ページ

(25)　ヘッダにインクルードするファイルのプロパティページ

(26)　フッタにインクルードするファイルの一覧ページ

(27)　フッタにインクルードするファイルのプロパティページ

(28)　ログインの設定のプロパティページ

(29)　環境エントリの一覧のページ

(30)　環境エントリのプロパティページ

(31)　インジェクションターゲットの一覧のページ

(32)　インジェクションターゲットのプロパティページ

(33)　リモートEJBへの参照の一覧ページ

(34)　リモートEJBへの参照のプロパティページ

(35)　ローカルEJBへの参照の一覧ページ

(36)　ローカルEJBへの参照のプロパティページ

(37)　リソース参照の一覧ページ

(38)　リソース参照のプロパティページ

(39)　リソース環境変数の一覧ページ

(40)　リソース環境変数のプロパティページ

(41)　リンク先キューのプロパティページ

(42)　リンク先の管理対象オブジェクトのプロパティページ

(43)　永続化コンテキスト参照の一覧ページ

(44)　永続化コンテキスト参照のプロパティページ

(45)　永続化プロパティの一覧のページ

(46)　永続化プロパティのプロパティページ

(47)　永続化ユニット参照の一覧のページ

(48)　永続化ユニット参照のプロパティページ

(49)　PostConstructメソッドの一覧のページ

(50)　PostConstructメソッドのプロパティページ

(51)　PreDestroyメソッドの一覧のページ

(52)　PreDestroyメソッドのプロパティページ

(53)　ロケールエンコーディングマッピングの一覧ページ

(54)　ロケールエンコーディングマッピングのプロパティページ

(55)　スレッド数制御のプロパティページ

(56)　URLグループのスレッド数制御の一覧ページ

(57)　URLグループのスレッド数制御のプロパティページ

(58)　URLグループのスレッド数制御マッピングの一覧ページ

(59)　URLグループのスレッド数制御マッピングのプロパティページ

(60)　実行待ちリクエスト数の監視のプロパティページ

(61)　HTTPリクエストのプロパティページ

(62)　HTTPレスポンスのプロパティページ

(63)　JSPのプロパティページ

(1)　WARのプロパティページ

WARのプロパティページを次に示します。

図21-104　WARのプロパティページ

表21-89　WARのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
WARファイルについての説明を指定します。
<description>
説明
</description>

表示名
－
WARファイルの表示名が表示されます。
<display-name>
表示名
</display-name>

分散したサーブレットコンテナーへデプロイ可能
×
WARファイルが分散化されたサーブレットコンテナに配布できるかどうかを指定します。指定できる値を次に示します。
チェック済み：デプロイ可能
チェック解除：デプロイ不可
<distributable/>
<distributable/>
タグ自体削除

コンテキスト・ルート
○
コンテキストルートを，空文字，またURIで指定します。ルートは，空文，または「/」を指定します。
<war-runtime>
<context-root>
コンテキスト・ルート
</context-root>
</war-runtime>

開始時のエラー通知
×
J2EEアプリケーション開始時にスタートアップ時のロードが指定されているサーブレットの初期化処理中や，タグライブラリの解析中にエラーが発生した場合に，エラーを通知してアプリケーションの開始を中断するかどうかを指定します。指定できる値を次に示します。

（空白）
指定なし

true
開始時のエラーを通知する

false
開始時のエラーを通知しない

<start-notify-error>
</start-notify-error>

開始・停止順
×
J2EEアプリケーションの開始・停止順を「0」から「2147483647」の整数で指定します。
開始時は昇順，停止時は降順に処理が行われます。
指定がない場合，「10」が仮定されます。
<start-order>
開始・停止順
</start-order >

（凡例）　○：必須　×：任意　－：変更不可

(2)　アイコンのプロパティページ

アイコンのプロパティページで次のアイコンを設定できます。

WAR属性のアイコン

リスナのアイコン

JSPプロパティグループのアイコン

アイコンのプロパティページについては，「21.4.2　アプリケーション属性設定ページ」の「(2)　アイコンのプロパティページ」を参照してください。

(3)　パラメタの一覧ページ

パラメタの一覧には，設定されたコンテキストパラメタ(WAR属性)または初期化パラメタ(フィルタ属性・サーブレット属性)がリストで表示されます。

パラメタの一覧ページを次に示します。

図21-105　パラメタの一覧ページ

表21-90　パラメタの一覧の表示項目

項目
説明
対応するタグ

パラメーター名
パラメタの名前が表示されます。
<context-param>
<param-name>
パラメタ名
</param-name>
</context-param>※

値
パラメタの値が表示されます。
<context-param>
<param-value>
値
</param-value>
</context-param>※

注※　対応するタグは，初期化パラメタの場合<context-param></context-param>の部分は，<init-param></init-param>になります。

(4)　パラメタのプロパティページ

パラメタのプロパティページを次に示します。

パラメタのプロパティページで，コンテキストパラメタ(WAR属性)または初期化パラメタ(フィルタ属性・サーブレット属性)を設定します。

図21-106　パラメタのプロパティページ

表21-91　パラメタのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
パラメタついての説明を指定します。
<description>
説明
</description>

パラメーター名
○
パラメタの名前を指定します。※
<param-name>
パラメタ名
</param-name>

値
○
パラメタの値を指定します。
<param-value>
値
</param-value>

（凡例）　○：必須　×：任意

注※　次の場合，同じパラメタの名前は指定できません。

WAR属性内に「コンテキストパラメタ」が複数ある場合のコンテキストパラメタ名

フィルタ属性内に「初期化パラメタ」が複数ある場合の初期化パラメタ名

サーブレット属性内に「初期化パラメタ」が複数ある場合の初期化パラメタ名

(5)　フィルタマッピングの一覧ページ

フィルタマッピングの一覧には，設定されたフィルタマッピングがリストで表示されます。

フィルタマッピングの一覧ページを次に示します。

図21-107　フィルタマッピングの一覧のページ

表21-92　フィルタマッピングの一覧の表示項目

項目
説明
対応するタグ

フィルター名
フィルタの名前が表示されます。
<filter-mapping>
<filter-name>
フィルタ名
</filter-name>
</filter-mapping>

URLパターン/サーブレット名
フィルタを対応づけるURLパターンまたはサーブレット名が表示されます。
<filter-mapping>
<url-pattern>
URLパターン
</url-pattern >
</filter-mapping>
または
<filter-mapping>
<servlet-name>
サーブレット名
</servlet-name>
</filter-mapping >

(6)　フィルタマッピング（URLパターン）のプロパティページ

フィルタマッピング（URLパターン）のプロパティページを次に示します。

図21-108　フィルタマッピング（URLパターン）のプロパティページ

表21-93　フィルタマッピング（URLパターン）のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

フィルター名
○
マッピングするフィルタの名称を選択します。
ドロップダウンリストには統合属性ファイルに定義済みのフィルタ名の一覧が表示されます。
<filter-name>
フィルタ名
</filter-name >

URLパターン
○
指定したフィルタを適用するURLパターンを指定します。
<url-pattern>
URLパターン
</url-pattern >

ディスパッチャー
×
フィルタの適用ディスパッチャを選択します。
次の値から，複数選択できます。

FORWARD
RequestDispatcher.forward()が呼び出された場合だけにフィルタを適用する

INCLUDE
RequestDispatcher.include()が呼び出された場合だけにフィルタを適用する

REQUEST
通常のクライアントからのアクセスのときだけにフィルタを適用する

ERROR
例外処理の場合だけにフィルタを適用する

<dispatcher>
</dispatcher>

（凡例）　○：必須　×：任意

(7)　フィルタマッピング（サーブレット名）のプロパティページ

フィルタマッピング（サーブレット名）のプロパティページを次に示します。

図21-109　フィルタマッピング（サーブレット名）のプロパティページ

表21-94　フィルタマッピング（サーブレット名）のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

フィルター名
○
マッピングするフィルタの名称を選択します。
ドロップダウンリストには統合属性ファイルに定義されているフィルタ名の一覧が表示されます。
<filter-name>
フィルタ名
</filter-name >

サーブレット名
○
対応づけるサーブレットの名称を指定します。
<servlet-name>
サーブレット名
</servlet-name>

ディスパッチャー
×
フィルタの適用ディスパッチャを次から選択します。複数選択できます。

FORWARD
RequestDispatcher.forward()が呼び出された場合だけにフィルタを適用する

INCLUDE
RequestDispatcher.include()が呼び出された場合だけにフィルタを適用する

REQUEST
通常のクライアントがアクセスした場合だけにフィルタを適用する

ERROR
例外処理の場合だけにフィルタを適用する

<dispatcher>
</dispatcher>
<dispatcher>
FORWARD
</dispatcher>
<dispatcher>
INCLUDE
</dispatcher>
<dispatcher>
REQUEST
</dispatcher>
<dispatcher>
ERROR
</dispatcher>

（凡例）　○：必須　×：任意

(8)　リスナの一覧ページ

リスナの一覧には，設定されたリスナがリストで表示されます。

リスナの一覧ページを次に示します。

図21-110　リスナの一覧ページ

表21-95　リスナの一覧の表示項目

項目
説明
対応するタグ

表示名
表示名が表示されます。
<listener>
<display-name>
表示名
</display-name>
</listener >

リスナー・クラス
リスナクラスが表示されます。
<listener>
<listener-class>
リスナクラス
</listener-class>
</listener >

(9)　リスナのプロパティページ

リスナのプロパティページを次に示します。

図21-111　リスナのプロパティページ

表21-96　リスナのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
リスナついての説明を指定します。
<description>
説明
</description>

表示名
×
リスナの表示名を指定します。
<display-name>
表示名
</display-name>

リスナー・クラス
○
リスナの実装クラスを完全修飾名で指定します。
WAR属性に複数のリスナがある場合，同じリスナクラスは指定できません。
<listener-class>
リスナクラス
</listener-class>

（凡例）　○：必須　×：任意

(10)　セッションの設定のプロパティページ

セッションの設定のプロパティページを次に示します。

図21-112　セッションの設定のプロパティページ

表21-97　セッションの設定のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

デフォルトのセッション・タイムアウト間隔
×
セッションタイムアウトまでの時間を，「-1」，「0」，または「1（分）」から「35791394（分）」の整数で指定します。
セッションタイムアウトまでの時間に，「-1」，「0」を指定すると，タイムアウトしません。
指定がない場合，30（分）が仮定されます。
<session-config>
<session-timeout>
セッションタイムアウト間隔
</session-timeout>
</session-config>

（凡例）×：任意

(11)　MIMEタイプのマッピングの一覧ページ

MIMEタイプのマッピングの一覧には，設定されたMIMEタイプのマッピングがリストで表示されます。

MIMEタイプのマッピングの一覧ページを次に示します。

図21-113　MIMEタイプのマッピングの一覧ページ

表21-98　MIMEタイプのマッピングの一覧の表示項目

項目
説明
対応するタグ

拡張子
拡張子が表示されます。
<mime-mapping>
<extension>
拡張子
</extension>
</mime -mapping>

MIMEタイプ
拡張子に対応づけるMIMEタイプが表示されます。
<mime-mapping>
<mime-type>
MIMEタイプ
</mime-type>
</mime-mapping>

(12)　MIMEタイプのマッピングのプロパティページ

MIMEタイプのマッピングのプロパティページを次に示します。

図21-114　MIMEタイプのマッピングのプロパティページ

表21-99　MIMEタイプのマッピングのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

拡張子
○
マッピングするファイル拡張子を指定します。
WAR属性に複数のMIMEタイプのマッピングがある場合，同じ拡張子は指定できません。
<extension>
拡張子
</extension>

MIMEタイプ
○
拡張子に対応するコンテンツのタイプを指定します。
<mime-type>
MIMEタイプ
</mime-type>

（凡例）　○：必須

(13)　ウェルカムファイルリストのプロパティページ

ウェルカムファイルリストのプロパティページを次に示します。

図21-115　ウェルカムファイルリストのプロパティページ

表21-100　ウェルカムファイルリストのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

ウェルカム・ファイル
○
ウェルカムファイルを指定します。インライン入力ができます。※
WAR属性のすべてのウェルカムファイルリストで，同じウェルカムファイルは指定できません。
<welcome-file-list>
<welcome-file>
ウェルカムファイル
</welcome-file>
<welcome-file-list>

（凡例）　○：必須

注※　［ウェルカム・ファイル］は，インライン入力のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-101　インライン入力のコンテキストメニュー

コンテキストメニュー | 説明
［追加］ | リストの末尾および属性ファイルに項目を追加します。常に活性状態です。
［削除］ | リストの選択行の項目をリストおよび属性ファイルから削除します。リストの表示項目が一つの場合は不活性状態です。

(14)　ウェルカムファイルのプロパティページ

ウェルカムファイルのプロパティページを次に示します。

図21-116　ウェルカムファイルのプロパティページ

表21-102　ウェルカムファイルのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

ウェルカム・ファイル
○
ウェルカムファイルを指定します。
WAR属性のすべてのウェルカムファイルリストで，同じウェルカムファイルは指定できません。
<welcome-file>
ウェルカムファイル
</welcome-file>

（凡例）　○：必須

(15)　エラーページの一覧ページ

エラーページの一覧には，設定されたエラーページがリストで表示されます。

エラーページの一覧ページを次に示します。

図21-117　エラーページの一覧ページ

表21-103　エラーページの一覧の表示項目

項目
説明
対応するタグ

エラー・コード／例外クラス
エラーページを設定するHTTPエラーコードまたは例外クラスが表示されます。
<error-page>
<error-code>
エラーコード
</error-code>
</error-page>
または
<error-page>
<exception-type>
例外クラス
</exception-type>
</error-page>

エラー・ページ
HTTPエラーコードまたは例外クラスに対応づけられたエラーページが表示されます。
<error-page>
<location>
エラーページ
</location>
</error-page>

(16)　エラーページ（エラーコード）のプロパティページ

エラーページ（エラーコード）のプロパティページを次に示します。

図21-118　エラーページ（エラーコード）のプロパティページ

表21-104　エラーページ（エラーコード）のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

エラー・コード
○
エラーページを設定するHTTPエラーコードを指定します。
「-2147483648」から「2147483647」の整数で指定するか，ドロップダウンリストから選択してください。ドロップダウンリストで選択できる値を次に示します。

400

401

403

404

500

501

502

WAR属性に複数のエラーページがある場合，同じエラーコードは指定できません。
<error-code>
エラーコード
</error-code>

エラー・ページ
○
エラーコードに対応づけるページのWARを指定します。
「/」で始まる値を指定します。
<location>
エラーページ
</location>

（凡例）　○：必須

(17)　エラーページ（例外クラス）のプロパティページ

エラーページ（例外クラス）のプロパティページを次に示します。

図21-119　エラーページ（例外クラス）のプロパティページ

表21-105　エラーページ（例外クラス）のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

例外クラス
○
エラーページを設定する例外クラスを完全修飾名で指定します。
WAR属性に複数のエラーページがある場合，同じ例外クラスは指定できません。
<exception-type>
例外クラス
</exception-type>

エラー・ページ
○
指定した例外が発生した場合に表示するページを指定します。「/」で始まる値を指定します。
<location>
エラーページ
</location>

（凡例）　○：必須

(18)　タグライブラリの一覧ページ

タグライブラリの一覧には，設定されたタグライブラリがリストで表示されます。

タグライブラリの一覧ページを次に示します。

図21-120　タグライブラリの一覧ページ

表21-106　タグライブラリの一覧の表示項目

項目
説明
対応するタグ

タグ・ライブラリーのURI
タグライブラリのURIが表示されます。
<taglib>
<taglib-uri>
タグライブラリのURI
</taglib-uri>
</taglib>

タグ・ライブラリーのファイル・パス
タグライブラリのファイルパスが表示されます。
<taglib>
<taglib-location>
タグライブラリのファイルパス
</taglib-location>
</taglib>

(19)　タグライブラリのプロパティページ

タグライブラリのプロパティページを次に示します。

図21-121　タグライブラリのプロパティページ

表21-107　タグライブラリのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

タグ・ライブラリーのURI
○
タグライブラリのweb.xmlに対する相対的なURIを指定します。
WAR属性に，タグライブラリ（［JSPの設定］下，または［WAR属性］直下）が複数ある場合，同じタグライブラリのURIは指定できません。
<taglib-uri>
タグライブラリーのURI
</taglib-uri>

タグ・ライブラリーのファイル・パス
○
タグライブラリのファイルの場所を，WARのルートからの相対位置のURLで指定します。
<taglib-location>
タグライブラリーのファイルパス
</taglib-location>

（凡例）　○：必須

(20)　JSPプロパティグループの一覧ページ

JSPプロパティグループの一覧には，設定されたJSPプロパティグループがリストで表示されます。

JSPプロパティグループの一覧ページを次に示します。

図21-122　JSPプロパティグループの一覧ページ

表21-108　JSPプロパティグループの一覧の表示項目

項目
説明
対応するタグ

表示名
JSPプロパティグループの表示名が表示されます。
<jsp-property-group>
<display-name>
表示名
</display-name>
</jsp-property-group >

URLパターン
JSPプロパティグループを適用するURLパターンが表示されます。
<jsp-property-group>
<url-pattern>
URLパターン
</url-pattern>
</jsp-property-group >

EL式を無視する
JSP内のEL式を無視するかどうかが，次の形式で表示されます。

（空白）
［EL式を無視する］が指定されていない

true
EL式を使用しない

false
EL式を使用する

<jsp-property-group>
<el-ignored>
EL式を無視する
</el-ignored>
</jsp-property-group >

ページ・エンコーディング
JSP内のページエンコーディングが表示されます。
<jsp-property-group>
<page-encoding>
ページエンコーディング
</page-encoding>
</jsp-property-group >

スクリプトレットを無効にする
JSP内のスクリプトレットを無効にするかどうかが，次の形式で表示されます。

（空白）
falseが仮定される

true
スクリプトを無効にする

false
スクリプトを有効にする

<jsp-property-group>
<scripting-invalid>
スクリプトレットを無効にする
</scripting-invalid>
</jsp-property-group>

JSPの形式がXML構文
JSPの形式がXML構文かどうか，次の形式で表示されます。

（空白）
「JSPの形式がXML構文」の指定がされていない

true
JSPドキュメントである

false
従来のJSPである

<jsp-property-group>
<is-xml>
JSPの形式がXML構文
</is-xml>
</jsp-property-group>

(21)　JSPプロパティグループのプロパティページ

JSPプロパティグループのプロパティページを次に示します。

図21-123　JSPプロパティグループのプロパティページ

表21-109　JSPプロパティグループのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
JSPプロパティグループの説明を指定します。
<description>
説明
</description>

表示名
×
JSPプロパティグループの表示名を指定します。
<display-name>
表示名
</display-name>

URLパターン
○
JSPプロパティグループを適用するURLパターンを指定します。インライン入力ができます。※
<url-pattern>
URLパターン
</url-pattern>

EL式を無視する
×
EL式を無視するかどうかを指定します。指定できる値を次に示します。

（空白）
falseが仮定される。

true
EL式を使用しない。

false
EL式を使用する。

<el-ignored>
</el-ignored>

ページ・エンコーディング
×
ページエンコーディングを指定します。
<page-encoding>
ページエンコーディング
</page-encoding>

スクリプトレットを無効にする
×
JSP内のスクリプトレットを無効にするかどうかを指定します。指定できる値を次に示します。

true：スクリプトレットを無効にする

false，（空白）：スクリプトレットを有効にする

<scripting-invalid>
</scripting-invalid>

JSPの形式がXML構文
×
JSPがXML構文のJSP（JSPドキュメント形式）であるかどうかを指定します。指定できる値を次に示します。

（空白）：JSPの形式の指定がない

true：JSPドキュメントである

false：従来のJSPである

<is-xml>
</is-xml>
<is-xml>
true
</is-xml>
<is-xml>
false
</is-xml>

（凡例）　○：必須　×：任意

注※　［URLパターン］は，インライン入力のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

インライン入力のコンテキストメニューについては，「(13)　ウェルカムファイルリストのプロパティページ」を参照してください。

(22)　URLパターンの一覧ページ

URLパターンの一覧には，設定されたURLパターンがリストで表示されます。

URLパターンの一覧ページを次に示します。

図21-124　URLパターンの一覧ページ

表21-110　URLパターンの一覧の表示項目

項目
説明
対応するタグ

URLパターン
JSPプロパティグループを設定するURLパターンが表示されます。
<jsp-property-group>
<url-pattern>
URLパターン
</url-pattern>
</jsp-property-group>

(23)　URLパターンのプロパティページ

URLパターンのプロパティページを次に示します。

図21-125　URLパターンのプロパティページ

表21-111　URLパターンのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

URLパターン
○
設定したプロパティグループに対応づけるURLパターンを指定します。
<url-pattern>
URLパターン
</url-pattern>

（凡例）　○：必須

(24)　ヘッダにインクルードするファイルの一覧ページ

ヘッダにインクルードするファイルの一覧には，設定されたヘッダにインクルードするファイルがリストで表示されます。

ヘッダにインクルードするファイルの一覧ページを次に示します。

図21-126　ヘッダにインクルードするファイルの一覧ページ

表21-112　ヘッダにインクルードするファイルの一覧の表示項目

項目
説明
対応するタグ

ヘッダーにインクルードするファイル
ヘッダにインクルードするファイルが表示されます。
<include-prelude>
ヘッダにインクルードするファイル
</include-prelude>

(25)　ヘッダにインクルードするファイルのプロパティページ

ヘッダにインクルードするファイルのプロパティページを次に示します。

図21-127　ヘッダにインクルードするファイルのプロパティページ

表21-113　ヘッダにインクルードするファイルのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

ヘッダーにインクルードするファイル
○
ページのヘッダにインクルードするファイルを相対パスで指定します。
<include-prelude>
ヘッダにインクルードするファイル
</include-prelude>

（凡例）　○：必須

(26)　フッタにインクルードするファイルの一覧ページ

フッタにインクルードするファイルの一覧には，設定されたフッタにインクルードするファイルがリストで表示されます。

フッタにインクルードするファイルの一覧ページを次に示します。

図21-128　フッタにインクルードするファイルの一覧ページ

表21-114　フッタにインクルードするファイルの一覧の表示項目

項目
説明
対応するタグ

フッターにインクルードするファイル
フッタにインクルードするファイルが表示されます。
<include-coda>
フッタにインクルードするファイル
</include-coda>

(27)　フッタにインクルードするファイルのプロパティページ

フッターにインクルードするファイルのプロパティページを次に示します。

図21-129　フッターにインクルードするファイルのプロパティページ

表21-115　フッターにインクルードするファイルのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

フッターにインクルードするファイル
○
ページのフッタにインクルードするファイルを相対パスで指定します。
<include-coda>
フッタにインクルードするファイル
</include-coda>

（凡例）　○：必須

(28)　ログインの設定のプロパティページ

ログインの設定のプロパティページを次に示します。

図21-130　ログインの設定のプロパティページ

表21-116　ログインの設定のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

認証方式
○
ログインの認証方式を指定します。指定できる値を次に示します。

BASIC
HTTP Basic認証を使用する

FORM
フォーム認証を使用する

CLIENT－CERTSSL
クライアント認証を要求する

<login-config>
<auth-method>
</auth-method>
</login-config>

レルム名
×
BASIC認証で使用するレルム名を指定します。
［認証方法］で「BASIC」を指定した場合は必ず指定してください。
ただし，認証方法で［BASIC］以外を指定した場合は指定できません。
<login-config>
<realm-name>
レルム名
</realm-name>
</login-config>

ログイン・ページ
×
FORM認証で使用するログインページの，WARのルートからのURLを指定します。「/」で始まる値を指定します。
［認証方法］で「FORM」を指定した場合は，必ず指定してください。
ただし，［認証方法］で「FORM」以外を指定した場合は指定できません。
<login-config>
<form-login-config>
<form-login-page>
ログインページ
</form-login-page>
</form-login-config>
</login-config>

エラー・ページ
×
FORM認証でログインに失敗したときのエラーページの，WARのルートからのURLを指定します。「/」で始まる値を指定します。
［認証方法］で「FORM」を選択した場合は，必ず指定してください。
ただし，［認証方法］で「FORM」以外を指定した場合は指定できません。
<login-config>
<form-login-config>
<form-error-page>
エラーページ
</form-error-page>
</form-login-config>
</login-config>

（凡例）　○：必須　×：任意

(29)　環境エントリの一覧のページ

環境エントリの一覧には，設定された環境エントリがリストで表示されます。なお，表示されるリストの内容はSession Beanの場合と同じです。

環境エントリの一覧のページについては，「21.6.2　Session Bean属性設定ページ」の「(3)　環境エントリの一覧のページ」を参照してください。

(30)　環境エントリのプロパティページ

環境エントリのプロパティページを次に示します。

図21-131　環境エントリのプロパティページ

表21-117　環境エントリのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

環境エントリー名
○
環境エントリ名を指定します。※1
<env-entry-name>
環境エントリ名
</env-entry-name>

データ型
×
環境エントリのデータ型を選択します。
選択できる値を次に示します。

（空白）

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

<env-entry-type>
データ型
</env-entry-type>

値
×※2
環境エントリの値を指定します。
データ型に指定した型に適合した値を指定します。
<env-entry-value>
値
</env-entry-value>

（凡例）　○：必須　×：任意

注※1　同一属性内に複数の環境エントリがある場合，同一の環境エントリ名（<env-entry-name>）は指定できません。

注※2　「java.lang.String」以外のデータ型を指定している場合は，必須です。

(31)　インジェクションターゲットの一覧のページ

インジェクションターゲットの一覧には設定されたインジェクションターゲットがリストで表示されます。

インジェクションターゲットの一覧のページを次に示します。

図21-132　インジェクションターゲットの一覧のページ

表21-118　インジェクションターゲットの一覧の表示項目

項目
説明
対応するタグ

インジェクション・ターゲット・クラス
インジェクションターゲットクラスが表示されます。
<injection-target-class>
インジェクションターゲットクラス
</injection-target-class>

インジェクション・ターゲット名
インジェクションターゲット名が表示されます。
<injection-target-name>
インジェクションターゲット名
</injection-target-name>

(32)　インジェクションターゲットのプロパティページ

インジェクションターゲットのプロパティページを次に示します。

図21-133　インジェクションターゲットのプロパティページ

表21-119　インジェクションターゲットのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

インジェクション・ターゲット・クラス
○
インジェクションターゲットクラスを完全修飾クラス名で指定します。
<injection-target-class>
インジェクションターゲットクラス
</injection-target-class>

インジェクション・ターゲット名
○
インジェクションターゲット名を指定します。
<injection-target-name>
インジェクションターゲット名
</injection-target-name>

（凡例）　○：必須

(33)　リモートEJBへの参照の一覧ページ

リモートEJBへの参照の一覧には，設定されたリモートEJBへの参照がリストで表示されます。なお，表示されるリストの内容はSession Beanの場合と同じです。

リモートEJBへの参照の一覧ページについては，「21.6.2　Session Bean属性設定ページ」の「(5)　リモートEJBへの参照の一覧ページ」を参照してください。

(34)　リモートEJBへの参照のプロパティページ

リモートEJBへの参照のプロパティページを次に示します。

図21-134　リモートEJBへの参照のプロパティページ

表21-120　リモートEJBへの参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

EJB参照名
○
EJB参照名を指定します。※
<ejb-ref-name>
EJB参照名
</ejb-ref-name>

EJB参照タイプ
×
EJB参照タイプを指定します。
指定できる値を次に示します。

（空白）

Session

Entity

<ejb-ref-type>
EJB参照タイプ
</ejb-ref-type>

リモート・ホーム・インターフェース
×
リモートホームインタフェースを完全修飾クラス名で指定します。
<home>
リモートホームインタフェース
</home>

リモート・コンポーネント・インターフェース
×
リモートコンポーネントインタフェースを完全修飾クラス名で指定します。
<remote>
リモートコンポーネントインタフェース
</remote>

リンク先のEJB名
×
参照するEJBのEJB名を入力するか，またはリスト項目から選択します。

EJBがほかのejb-jarファイルにある場合は，次の形式で入力します。
「ファイル名#EJB名」

ネーミングの切り替え機能でリンク先を設定する場合，次の形式で入力します。
corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBホームオブジェクトリファレンスのJNDI名

アプリケーション統合属性ファイルにあるEnterprise Bean表示名をリスト項目から選択します。

<ejb-link>
リンク先のEJB名
</ejb-link>

（凡例）　○：必須　×：任意

注※　同一属性内にリモートEJBへの参照とローカルEJBへの参照が両方ある場合や，リモートEJBへの参照が複数ある場合，同じEJB参照名（<ejb-ref-name>）は指定できません。

(35)　ローカルEJBへの参照の一覧ページ

ローカルEJBへの参照の一覧ページでは，設定されたローカルEJBへの参照がリストで表示されます。なお，表示されるリストの内容はSession Beanの場合と同じです。

ローカルEJBへの参照の一覧ページについては，「21.6.2　Session Bean属性設定ページ」の「(7)　ローカルEJBへの参照の一覧ページ」を参照してください。

(36)　ローカルEJBへの参照のプロパティページ

ローカルEJBへの参照のプロパティページを次に示します。

図21-135　ローカルEJBへの参照のプロパティページ

表21-121　ローカルEJBへの参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

EJB参照名
○
EJB参照名を指定します。※
<ejb-ref-name>
EJB参照名
</ejb-ref-name>

EJB参照タイプ
×
EJB参照タイプを指定します。
指定できる値を次に示します。

（空白）

Session

Entity

<ejb-ref-type>
EJB参照タイプ
</ejb-ref-type>

ローカル・ホーム・インターフェース
×
ローカルホームインタフェースを完全修飾クラス名で指定します。
<local-home>
ローカルホームインタフェース
</local-home>

ローカル・コンポーネント・インターフェース
×
ローカルコンポーネントインタフェースを完全修飾クラス名で指定します。
<local>
ローカルコンポーネントインタフェース
</local>

リンク先のEJB名
×
参照するEJBのEJB名を入力するか，またはリスト項目を選択します。

EJBがほかのejb-jarファイルにある場合は，次の形式で入力します。
「ファイル名#EJB名」

アプリケーション統合属性ファイルにあるEnterprise Bean表示名をリスト項目から選択します。

<ejb-link>
リンク先のEJB名
</ejb-link>

（凡例）　○：必須　×：任意

注※　同一属性内にリモートEJBへの参照とローカルEJBへの参照が両方ある場合や，ローカルEJBへの参照が複数ある場合，同じEJB参照名（<ejb-ref-name>）は指定できません。

(37)　リソース参照の一覧ページ

リソース参照の一覧では，設定されたリソース参照がリストで表示されます。なお，表示されるリストの内容はSession Beanの場合と同じです。

リソース参照の一覧ページについては，「21.6.2　Session Bean属性設定ページ」の「(9)　リソース参照の一覧ページ」を参照してください。

(38)　リソース参照のプロパティページ

リソース参照のプロパティページを次に示します。

図21-136　リソース参照のプロパティページ

表21-122　リソース参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

リソース参照名
○
リソース参照名を指定します。※1
<res-ref-name>
リソース参照名
</res-ref-name>

リソース・タイプ
×
リソース種別を指定します。
完全修飾クラス名で入力するか，または次のリスト項目を選択します。

（空白）

javax.jms.ConnectionFactory

javax.jms.QueueConnectionFactory

javax.jms.TopicConnectionFactory

javax.mail.Session

javax.resource.cci. ConnectionFactory

javax.sql.DataSource

org.omg.CORBA_2_3.ORB

<res-type>
リソースタイプ
</res-type>

リソース認証方式
×
リソース認証方式を指定します。
選択できる値を次に示します。

（空白）

Application

Container

<res-auth>
リソース認証方式
</res-auth>

リソース共有
×
リソース共有を指定します。
選択できる値を次に示します。

（空白）

Shareable

Unshareable

<res-sharing-scope>
リソース共有
</res-sharing-scope>

対応するリソース名
×
対応するリソースアダプタ名，またはメール表示名が表示されます。
<mapped-name>
対応するリソース名
</mapped-name>※2

リンク先
×
リンク先を指定します。
リンク先として，対応するJ2EEリソースアダプタの表示名を入力するか，またはリスト項目を選択します。
J2EEサーバにデプロイされているJ2EEリソースアダプタの表示名がリスト項目※4として表示されます。［サーバー・エクスプローラー］ビューでもJ2EEリソースアダプタの表示名一覧を参照できます。
<linked-to>
リンク先※3
</linked-to>

（凡例）　○：必須　×：任意

注※1　同一属性内に複数のリソース参照名がある場合，同一のリソース参照名（<res-ref-name>）は指定できません。

注※2　<linked-to>タグに値が設定されている場合，<linked-to>タグの指定が有効になり，<mapped-name>タグの値は無効になります。

注※3　<linked-to>タグのリンク先の指定方法は，リソースアダプタのバージョンによって，次のように異なります。

Connector 1.0の仕様に準拠する場合：＜リソースアダプタの表示名＞

Connector 1.5の仕様に準拠する場合：＜リソースアダプタの表示名＞!＜コネクション定義識別子＞

注※4　リスト項目には，デプロイ済みのリソースアダプタを表示されます。なお，Connector1.5の仕様に準拠するリソースアダプタの場合は，［リソース・タイプ］の値とコネクション定義識別子が一致するOutboundリソースアダプタが表示されます。

(39)　リソース環境変数の一覧ページ

リソース環境変数の一覧には，設定されたリソース環境変数がリストで表示されます。なお，表示されるリストの内容はSession Beanの場合と同じです。

リソース環境変数の一覧ページについては，「21.6.2　Session Bean属性設定ページ」の「(11)　リソース環境変数の一覧ページ」を参照してください。

(40)　リソース環境変数のプロパティページ

リソース環境変数のプロパティページを次に示します。

図21-137　リソース環境変数のプロパティページ

表21-123　リソース環境変数のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

リソース環境変数名
○
リソース環境変数名を指定します。※1
<resource-env-ref-name>
リソース環境変数名
</resource-env-ref-name>

リソース環境変数値のタイプ
×
リソース環境変数値のタイプを指定します。
＜JavaBeansリソースのクラス名＞を完全修飾クラス名で入力するか，または次のリスト項目を選択します。

（空白）

javax.jms.Queue

javax.jms.Topic

javax.transaction.UserTransaction※2

javax.ejb.TimerService※2

javax.ejb.EJBContext※2

<resource-env-ref-type>
リソース環境変数値のタイプ
</resource-env-ref-type>

対応するリソース名
×
リソース環境変数値のタイプが「javax.jms.Queue」または「JavaBeansリソースのクラス名」の場合，対応するリソース名を指定します。

「javax.jms.Queue」の場合
対応するキューを「<リソースアダプタの表示名>#<Queue名称>」の形式で指定します。

「JavaBeansリソースのクラス名」の場合
対応するJavaBeansリソースの表示名を指定します。

<mapped-name>
対応するリソース名
</mapped-name>

（凡例）　○：必須　×：任意

注※1　同一属性内に複数のリソース環境変数がある場合，同じリソース環境変数名（<resource-env-ref-name>）は指定できません。

注※2　アノテーションで設定された値です。リスト項目として表示されますが，アノテーションで設定された値は変更できないため，J2EEアプリケーションサーバへの保管時にサーバ側で変更前の設定値に戻されます。

(41)　リンク先キューのプロパティページ

リンク先キューの設定はSession Beanのプロパティの設定と同じです。

リンク先キューのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(13)　リンク先キューのプロパティページ」を参照してください。

(42)　リンク先の管理対象オブジェクトのプロパティページ

リンク先の管理対象オブジェクトの設定はSession Beanのプロパティの設定と同じです。

リンク先キューのプロパティページについては，「21.6.2　Session Bean属性設定ページ」の「(14)　リンク先の管理対象オブジェクトのプロパティページ」を参照してください。を参照してください。

(43)　永続化コンテキスト参照の一覧ページ

永続化コンテキスト参照の一覧には，設定された永続化コンテキスト参照がリストで表示されます。

永続化コンテキスト参照の一覧ページを次に示します。

図21-138　永続化コンテキスト参照の一覧ページ

表21-124　永続化コンテキスト参照の一覧の表示項目

項目
説明
対応するタグ

永続化コンテキスト参照名
永続化コンテキストの参照名が表示されます。
<persistence-context-ref-name>
永続化コンテキストの参照名
</persistence-context-ref-name>

永続化ユニット名
永続化ユニット名が表示されます。
<persistence-unit-name>
永続化ユニット名
</persistence-unit-name>

永続化コンテキストタイプ
永続化コンテキストのタイプが表示されます。
<persistence-context-type>
永続化コンテキストタイプ
</persistence-context-type>

(44)　永続化コンテキスト参照のプロパティページ

永続化コンテキスト参照のプロパティページを次に示します。

図21-139　永続化コンテキスト参照のプロパティページ

表21-125　永続化コンテキスト参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

永続化コンテキスト参照名
○
永続化コンテキストの参照名を指定します。
<persistence-context-ref-name>
永続化コンテキストの参照名
</persistence-context-ref-name>

永続化ユニット名
×
永続化ユニットの名前を指定します。
<persistence-unit-name>
永続化ユニット名
</persistence-unit-name>

永続化コンテキストタイプ
×
永続化コンテキストのタイプを選択します。

（空白）

Transaction

Extended

<persistence-context-type>
永続化コンテキストタイプ
</persistence-context-type>

（凡例）　○：必須　×：任意

(45)　永続化プロパティの一覧のページ

永続化プロパティの一覧には，設定されたプロパティがリストで表示されます。

永続化プロパティの一覧ページを次に示します。

図21-140　永続化プロパティの一覧ページ

表21-126　永続化プロパティの一覧の表示項目

項目
説明
対応するタグ

プロパティー名
永続化プロパティの名前が表示されます。
<name>
永続化プロパティ名
</name>

プロパティーの値
永続化プロパティの値が表示されます。
<value>
永続化プロパティの値
</value>

(46)　永続化プロパティのプロパティページ

永続化プロパティのプロパティページを次に示します。

図21-141　永続化プロパティのプロパティページ

表21-127　永続化プロパティのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

プロパティー名
○
永続化プロパティの名前を指定します。
<name>
永続化プロパティ名
</name>

プロパティーの値
○
永続化プロパティの値を指定します。
<value>
永続化プロパティの値
</value>

（凡例）　○：必須

(47)　永続化ユニット参照の一覧のページ

永続化ユニット参照の一覧には，設定された永続化ユニット参照がリストで表示されます。

永続化ユニット参照の一覧ページを次に示します。

図21-142　永続化ユニット参照の一覧ページ

表21-128　永続化ユニット参照の一覧の表示項目

項目
説明
対応するタグ

永続化ユニット参照名
永続化ユニットの参照名が表示されます。
<persistence-unit-ref-name>
永続化ユニットの参照名
</persistence-unit-ref-name>

永続化ユニット名
永続化ユニット名が表示されます。
<persistence-unit-name>
永続化ユニット名
</persistence-unit-name>

(48)　永続化ユニット参照のプロパティページ

永続化ユニット参照のプロパティページを次に示します。

図21-143　永続化ユニット参照のプロパティページ

表21-129　永続化ユニット参照のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
説明を指定します。
<description>
説明
</description>

永続化ユニット参照名
○
永続化ユニットの参照名を指定します。
<persistence-unit-ref-name>
永続化ユニットの参照名
</persistence-unit-ref-name>

永続化ユニット名
×
永続化ユニット名を指定します。
<persistence-unit-name>
永続化ユニット名
</persistence-unit-name>

（凡例）　○：必須　×：任意

(49)　PostConstructメソッドの一覧のページ

PostConstructメソッドの一覧には，設定されたPostConstructメソッドがリストで表示されます。

PostConstructメソッドの一覧ページを次に示します。

図21-144　PostConstructメソッドの一覧ページ

表21-130　PostConstructメソッドの一覧の表示項目

項目
説明
対応するタグ

クラス名
PostConstructメソッドが存在するクラスが表示されます。
<lifecycle-callback-class>
クラス名
</lifecycle-callback-class>

PostConstructメソッド名
PostConstructメソッド名が表示されます。
<lifecycle-callback-method>
PostConstructメソッド名
</lifecycle-callback-method>

(50)　PostConstructメソッドのプロパティページ

PostConstructメソッドのプロパティページを次に示します。

図21-145　PostConstructメソッドのプロパティページ

表21-131　PostConstructメソッドのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

クラス名
×
PostConstructメソッドが存在するクラスを完全修飾名で指定します。
<lifecycle-callback-class>
クラス名
</lifecycle-callback-class>

PostConstructメソッド名
○
PostConstructメソッド名を指定します。
<lifecycle-callback-method>
PostConstructメソッド名
</lifecycle-callback-method>

（凡例）　○：必須　×：任意

(51)　PreDestroyメソッドの一覧のページ

PreDestroyメソッドの一覧には，設定されたPreDestroyメソッドがリストで表示されます。

PreDestroyメソッドの一覧ページを次に示します。

図21-146　PreDestroyメソッドの一覧ページ

表21-132　PreDestroyメソッドの一覧の表示項目

項目
説明
対応するタグ

クラス名
PreDestroyメソッドが存在するクラスが完全修飾名で表示されます。
<lifecycle-callback-class>
クラス名
</lifecycle-callback-class>

PreDestroyメソッド名
PreDestroyメソッド名が表示されます。
<lifecycle-callback-method>
PreDestroyメソッド名
</lifecycle-callback-method>

(52)　PreDestroyメソッドのプロパティページ

PreDestroyメソッドのプロパティページを次に示します。

図21-147　PreDestroyメソッドのプロパティページ

表21-133　PreDestroyメソッドのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

クラス名
×
PreDestroyメソッドが存在するクラスを完全修飾名で指定します。
<lifecycle-callback-class>
クラス名
</lifecycle-callback-class>

PreDestroyメソッド名
○
PreDestroyメソッド名を指定します。
<lifecycle-callback-method>
PreDestroyメソッド名
</lifecycle-callback-method>

（凡例）　○：必須　×：任意

(53)　ロケールエンコーディングマッピングの一覧ページ

ロケールエンコーディングマッピングの一覧ページを次に示します。

ロケールエンコーディングマッピングの一覧には，設定されたロケールエンコーディングマッピングがリストで表示されます。

図21-148　ロケールエンコーディングマッピングの一覧ページ

表21-134　ロケールエンコーディングマッピングの一覧の表示項目

項目
説明
対応するタグ

ロケール
ロケールが表示されます。
<locale-encoding-mapping-list>
<locale-encoding-mapping>
<locale>
ロケール
</locale>
<locale-encoding-mapping>
</local-encoding-mapping-list>

エンコーディング
エンコーディングが表示されます。
<locale-encoding-mapping -list>
<locale-encoding-mapping>
<encoding>
エンコーディング
</encoding>
<locale-encoding-mapping>
</local-encoding-mapping-list>

(54)　ロケールエンコーディングマッピングのプロパティページ

ロケールエンコーディングマッピングのプロパティページを次に示します。

図21-149　ロケールエンコーディングマッピングのプロパティページ

表21-135　ロケールエンコーディングマッピングのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

ロケール
○
ISO-639-1およびISO-3166で定義されているロケールを指定します。
<locale>
ロケール
</locale>

エンコーディング
○
ロケールに対応したエンコーディングを指定します。
<encoding>
エンコーディング
</encoding>

（凡例）　○：必須

(55)　スレッド数制御のプロパティページ

スレッド数制御のプロパティページを次に示します。

図21-150　スレッド数制御のプロパティページ

表21-136　スレッド数制御のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

最大同時実行スレッド数
○
最大同時実行スレッド数を「1」から「1024」の整数で指定します。
［占有スレッド数］に指定した値以上の値を指定してください。
<thread-control>
<thread-control-max-threads>
最大同時実行スレッド数
</thread-control-max-threads>
</thread-control>

占有スレッド数
○
占有スレッド数を「0」から「1024」の整数で指定します。占有スレッド数を使用しない場合は「0」を指定します。
［最大同時実行スレッド数］以下の値を指定てください。
<thread-control>
<thread-control-exclusive-threads>
占有スレッド数
</thread-control- exclusive-threads>
</thread-control>

実行待ちキュー・サイズ
○
Webアプリケーション単位の実行待ちキューサイズを「0」から「2147483647」の整数で指定します。
<thread-control>
<thread-control-queue-size>
Webアプリケーション単位の実行待ちキューサイズ
</thread-control-queue-size>
</thread-control>

（凡例）　○：必須

WAR属性のツリービューで＜WAR属性名＞を選択して，右クリックでコンテキストメニュー［追加］ - ［スレッド数制御］を選択したときに，Webアプリケーション単位の実行待ちキューサイズ(<thread-control-queue-size>タグ)のあとに，リソース監視（<resource-watcher>タグ）が自動設定されます。スレッド数制御設定時のリソース監視の設定項目を次の表に示します。

表21-137　スレッド数制御設定時のリソース監視の設定項目

設定項目
説明
対応するタグ

アラートメッセージを出力するしきい値
アラートメッセージを出力するしきい値（単位：%）を，「1」から「100」の整数で設定します。
指定がない場合，「80」が仮定されます。
<watcher-threshold>
</watcher-threshold>

監視間隔
監視間隔を「1（秒）」から「2147483647（秒）」の整数で指定します。
指定がない場合，「30」が仮定されます。
<watcher-interval>
</watcher-interval>

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

true：有効にする

false：無効にする

ただし，実行待ちキュー・サイズの指定が0の場合は，「true」が指定されていても無効になります。
指定がない場合，「true」が仮定されます。
<watcher-enabled>
</watcher-enabled>

リソース使用状況の出力有無
リソース使用状況をファイルに出力するかどうかを指定します。指定できる値を次に示します。

true：出力する

false：出力しない

指定がない場合，「true」が仮定されます。
<watcher-writefile-enabled>
</watcher-writefile-enabled>

(56)　URLグループのスレッド数制御の一覧ページ

URLグループのスレッド数制御の一覧ページを次に示します。

URLグループのスレッド数制御の一覧には，設定されたURLグループのスレッド数制御がリストで表示されます。

図21-151　URLグループのスレッド数制御の一覧ページ

表21-138　URLグループのスレッド数制御の一覧の表示項目

項目
説明
対応するタグ

URLグループのスレッド数制御定義名
URLグループのスレッド数制御定義名が表示されます。
<urlgroup-thread-control>
<urlgroup-thread-control-name>
URLグループのスレッド数制御定義名
</urlgroup-thread-control-name >
</urlgroup-thread-control>

URLグループの最大同時実行スレッド数
URLグループ単位の最大同時実行スレッド数が表示されます。
<urlgroup-thread-control>
<urlgroup-thread-control-max-threads>
URLグループの最大同時実行スレッド数
</urlgroup-thread-control-max-threads>
</thread-control>

URLグループの占有スレッド数
URLグループ単位の占有スレッド数が表示されます。
<urlgroup-thread-control>
<urlgroup-thread-control-exclusive-threads>
URLグループの占有スレッド数
</urlgroup-thread-control- exclusive-threads>
</urlgroup-thread-control>

URLグループの実行待ちキュー・サイズ
URLグループ単位の実行待ちキューのサイズが表示されます。
<urlgroup-thread-control>
<urlgroup-thread-control-queue-size>
URLグループの実行待ちキューサイズ
</urlgroup-thread-control-queue-size>
</urlgroup-thread-control>

(57)　URLグループのスレッド数制御のプロパティページ

URLグループのスレッド数制御のプロパティページを次に示します。

図21-152　URLグループのスレッド数制御のプロパティページ

表21-139　URLグループのスレッド数制御のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

URLグループのスレッド数制御定義名
○
URLグループのスレッド数制御の定義名を英数字(0～9，A～Z，a～z)，ハイフン（-），アンダースコア（_）で指定します。
Webアプリケーション内で一意な名称を，最大64文字で指定します。
WAR属性内に，複数のURLグループのスレッドがある場合，同じURLグループのスレッド数制御定義名は指定できません。
<urlgroup-thread-control>
<urlgroup-thread-control-name>
URLグループのスレッド数制御定義名
</urlgroup-thread-control-name >
</urlgroup-thread-control>

URLグループの最大同時実行スレッド数
○
URLグループの最大同時実行スレッド数を，「1」から［最大同時実行スレッド数］までの値を指定します。
<urlgroup-thread-control>
<urlgroup-thread-control-max-threads>
URLグループの最大同時実行スレッド数
</urlgroup-thread-control-max-threads>
</thread-control>

URLグループの占有スレッド数
○
URLグループの占有スレッド数を指定します。
URLグループのスレッド数制御の［URLグループの最大スレッド数］および［URLグループの占有スレッド数］に指定した値以下の値で指定してください。
なお，URLグループの占有スレッド数を使用しない場合は「0」を指定します。
複数指定する場合は，次の範囲の値を指定してください。

WARのスレッド数制御の最大同時実行スレッド数とWARのスレッド数制御の占有スレッド数（<thread-control-exclusive-threads>）が等しくない場合
WARのスレッド数制御の占有スレッド数 ≧ URLグループの占有スレッド数の総和

WARのスレッド数制御の最大同時実行スレッド数とWARのスレッド数制御の占有スレッド数（<thread-control-exclusive-threads>）が等しい場合
WARのスレッド数制御の占有スレッド数 > URLグループの占有スレッド数の総和

<urlgroup-thread-control>
<urlgroup-thread-control-exclusive-threads>
URLグループの占有スレッド数
</urlgroup-thread-control- exclusive-threads>
</urlgroup-thread-control>

URLグループの実行待ちキュー・サイズ
○
URLグループの実行待ちキューのサイズを「0」から「2147483647」の数値で指定します。
<urlgroup-thread-control>
<urlgroup-thread-control-queue-size>
URLグループの実行待ちキュー・サイズ
</urlgroup-thread-control-queue-size>
</urlgroup-thread-control>

（凡例）　○：必須

(58)　URLグループのスレッド数制御マッピングの一覧ページ

URLグループのスレッド数制御マッピングの一覧ページを次に示します。

URLグループのスレッド数制御マッピングの一覧には，設定されたURLパターンがリストで表示されます。

図21-153　URLグループのスレッド数制御マッピングの一覧ページ

表21-140　URLグループのスレッド数制御マッピングの一覧の表示項目

項目
説明
対応するタグ

URLグループのスレッド数制御マッピング
URLグループのスレッド数制御の対象となるURLパターンが表示されます。
<urlgroup-thread-control-mapping>
<url-pattern>
URLグループのスレッド数制御マッピング
</url-pattern>
</urlgroup-thread-control-mapping>

(59)　URLグループのスレッド数制御マッピングのプロパティページ

URLグループのスレッド数制御マッピングのプロパティページを次に示します。

図21-154　URLグループのスレッド数制御マッピングのプロパティページ

表21-141　URLグループのスレッド数制御マッピングのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

URLパターン
○
スレッド数制御対象となるURLパターンを指定します。
一つのWebアプリケーション内で同じURLパターンを指定することはできません。
Servlet2.4以降の規定に従って指定してください。
<urlgroup-thread-control-mapping>
<url-pattern>
URLパターン
</url-pattern>
</urlgroup-thread-control-mapping>

（凡例）　○：必須

(60)　実行待ちリクエスト数の監視のプロパティページ

実行待ちリクエスト数の監視のプロパティページを次に示します。

図21-155　実行待ちリクエスト数の監視のプロパティページ

表21-142　実行待ちリクエスト数の監視のプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

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

true
有効にする

false
無効にする

<enabled>
</enabled>

しきい値イベントの出力上限しきい値
○
しきい値イベントを出力する上限しきい値を，「1（％）」から「100（％）」の整数で指定します。
指定がない場合，「80（％）」が仮定されます。
［しきい値イベントを出力する下限しきい値］に指定した値以上の値を指定してください。
<high-threshold>
しきい値イベントの出力上限しきい値
</high-threshold>

しきい値イベントの出力下限しきい値
○
しきい値イベントを出力する下限しきい値を「0（％）」から「99（％）」の整数で指定します。
指定がない場合，「0（％）」が仮定されます。
［しきい値イベントを出力する上限しきい値］に指定した値以下の値を指定してください。
<low-threshold>
しきい値イベントの出力下限しきい値
</low-threshold>

（凡例）　○：必須

(61)　HTTPリクエストのプロパティページ

HTTPリクエストのプロパティページを次に示します。

図21-156　HTTPリクエストのプロパティページ

表21-143　HTTPリクエストのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

エンコーディング
×
リクエストボディ，およびクエリのデコードに使用するデフォルトのエンコーディングを指定します。指定できる文字列は，java.nio API用の正準名およびjava.ioとjava.lang API用の正準名に記載されている文字エンコーディングです。
J2EEアプリケーションで文字エンコーディングが指定されていない場合に適用されます。
<encoding>
エンコーディング
</encoding>

（凡例）　×：任意

(62)　HTTPレスポンスのプロパティページ

HTTPレスポンスのプロパティページを次に示します。

図21-157　HTTPレスポンスのプロパティページ

表21-144　HTTPレスポンスのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

エンコーディング
×
レスポンスボディに使用するデフォルトのエンコーディングを指定します。指定できる文字列は，java.nio API用の正準名およびjava.ioとjava.lang API用の正準名に記載されている文字エンコーディングです。
J2EEアプリケーションで文字エンコーディングが指定されていない場合に適用されます。
<encoding>
エンコーディング
</encoding>

（凡例）　×：任意

(63)　JSPのプロパティページ

JSPのプロパティページを次に示します。

図21-158　JSPのプロパティページ

表21-145　JSPレスポンスのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

ページ・エンコーディング
×
JSPファイルの読み込みに使用するデフォルトのエンコーディングを指定します。指定できる文字列は，java.nio API用の正準名およびjava.ioとjava.lang API用の正準名に記載されている文字エンコーディングです。
J2EEアプリケーションで文字エンコーディングが指定されていない場合に適用されます。
<page-encoding>
エンコーディング
</page-encoding>

（凡例）　×：任意

21.10　アプリケーション統合属性ファイル（フィルタ属性）

アプリケーション統合属性ファイルの［WAR］タブを選択すると，［WAR属性］フォームページが表示されます。［WAR］フォームページについては，「21.9　アプリケーション統合属性ファイル（WAR属性）」を参照してください。

［WAR属性］フォームページの［エレメント］に表示されている，［＜フィルタ属性名＞］を選択すると，フィルタ属性のツリーが表示されます。

＜この節の構成＞

21.10.1　フィルタ属性のツリー

21.10.2　フィルタ属性設定ページ

21.10.1　フィルタ属性のツリー

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。エディタエリアの［エレメント］下に編集するフィルタ属性ファイルの構成がツリー形式で表示されます。

フィルタ属性のツリー構成を次に示します。

[図データ]＜フィルタ属性名＞
　│
　├─アイコン
　│
　└─[図データ]初期化パラメーター
　　　　└─＜初期化パラメタ名＞

フィルタ属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。フィルタ属性のツリーノードとコンテキストメニューについて，次に説明します。

＜この項の構成＞

(1)　フィルタ属性のツリーノード

(2)　コンテキストメニュー操作

(1)　フィルタ属性のツリーノード

フィルタ属性のツリービューに表示されるノードを次に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。

表21-146　フィルタ属性ファイルのツリーのノード

ノード
説明
対応するタグ名
プロパティページ

＜フィルタ属性名＞
フィルタ属性を示すノードです。
選択すると，フィルタのプロパティページが表示されます。
<hitachi-filter-property>
21.10.2　(3)

アイコン
アイコンを示すノードです。
選択すると，アイコンのプロパティページが表示されます。
<icon>
21.4.2　(2)

初期化パラメーター
初期化パラメタをまとめるノードです。
選択すると，パラメタの一覧ページが表示されます。
－
21.9.2　(3)

＜初期化パラメタ名＞
初期化パラメタを示すノードです。
選択すると，パラメタのプロパティページが表示されます。
<init-param>
21.9.2　(4)

（凡例）　－：該当なし

(2)　コンテキストメニュー操作

フィルタ属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-147　フィルタ属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

＜フィルタ属性名＞
［追加］ - ［アイコン］
フィルタ属性にアイコンが追加されます。
アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.4.2　(2)

［追加］ - ［初期化パラメタの追加］
フィルタ属性に初期化パラメタが追加されます。
パラメタのプロパティページが表示されます。
21.9.2　(4)

アイコン
［削除］
フィルタ属性からアイコンが削除されます。
－

初期化パラメーター
［追加］ - ［初期化パラメーター］
［初期化パラメーター］に初期化パラメタが追加されます。
パラメタのプロパティページが表示されます。
21.9.2　(4)

［削除］
フィルタ属性からすべての初期化パラメタが削除されます。
－

＜初期化パラメタ名＞
［削除］
フィルタ属性から選択した初期化パラメタが削除されます。
－

（凡例）　－：該当なし

21.10.2　フィルタ属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。［エレメントの詳細］に，編集するフィルタ属性のプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアの表示が切り替わります。

フィルタ属性には，次のプロパティページがあります。

アイコンのプロパティページ

フィルタの一覧ページ

フィルタのプロパティページ

注意事項

プロパティページで，設定が必須の項目には「*」が付与されています。

＜この項の構成＞

(1)　アイコンのプロパティページ

(2)　フィルタの一覧ページ

(3)　フィルタのプロパティページ

(1)　アイコンのプロパティページ

フィルタ属性のアイコンのプロパティページについては，「21.4.2　アプリケーション属性設定ページ」の「(2)　アイコンのプロパティページ」を参照してください。

(2)　フィルタの一覧ページ

フィルタの一覧ページを次に示します。

フィルタの一覧ページには，設定されたフィルタがリストで表示されます。

図21-159　フィルタの一覧ページ

表21-148　フィルタの一覧の表示項目

項目
説明
対応するタグ

フィルター
フィルタの表示名が表示されます。
<hitachi-filter-property>
<display-name>
フィルタ
</display-name>
</hitachi-filter-property>

(3)　フィルタのプロパティページ

フィルタのプロパティページを次に示します。

図21-160　フィルタのプロパティページ

表21-149　フィルタのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
フィルタについての説明を指定します。
<description>
説明
</description>

表示名
－
フィルタの表示名が表示されます。
<display-name>
表示名
</display-name>

フィルター名
－
フィルタの名前が表示されます。
<filter-name>
フィルタ名
</filter-name>

フィルター・クラス
－
フィルタの実装クラスが表示されます。
<filter-class>
フィルタクラス
</filter-class>

（凡例）×：任意　－：変更不可

21.11　アプリケーション統合属性ファイル（サーブレット属性）

アプリケーション統合属性ファイルの［WAR］タブを選択すると，［WAR属性］フォームページが表示されます。［WAR］フォームページについては，「21.9　アプリケーション統合属性ファイル（WAR属性）」を参照してください。

［WAR属性］フォームページの［エレメント］に表示されている，［＜サーブレット属性名＞］を選択すると，サーブレット属性のツリーが表示されます。

＜この節の構成＞

21.11.1　サーブレット属性のツリー

21.11.2　サーブレット属性設定ページ

21.11.1　サーブレット属性のツリー

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。エディタエリアの［エレメント］下に編集するサーブレット属性ファイルの構成がツリー形式で表示されます。

サーブレット属性のツリー構成を次に示します。

[図データ]＜サーブレット属性名＞
　│
　├─アイコン
　│
　├─[図データ]初期化パラメーター
　│　　└─＜初期化パラメタ名＞
　│
　└─[図データ]URLグループのパターン
　　　　└─＜URLパターン＞

サーブレット属性のツリー項目（ノード）を右クリックすると，コンテキストメニューが表示されます。サーブレット属性のツリーノードとコンテキストメニューについて，次に説明します。

＜この項の構成＞

(1)　サーブレット属性のツリーノード

(2)　コンテキストメニュー操作

(1)　サーブレット属性のツリーノード

サーブレット属性のツリービューに表示されるノードを次に示します。表示されているノードを選択すると，対応するプロパティページが表示されます。

表21-150　サーブレット属性ファイルのツリーのノード

ノード
説明
対応するタグ名
プロパティページ

＜サーブレット属性名＞
サーブレット属性を示すノードです。
選択すると，サーブレットのプロパティページが表示されます。
<hitachi-servlet-property>
21.11.2　(3)

アイコン
アイコンを示すノードです。
選択すると，アイコンのプロパティページが表示されます。
<icon>
21.4.2　(2)

初期化パラメーター
初期化パラメタをまとめるノードです。
選択すると，パラメタの一覧ページが表示されます。
－
21.9.2　(3)

＜初期化パラメタ名＞
初期化パラメタを示すノードです。
選択すると，パラメタのプロパティページが表示されます。
<init-param>
21.9.2　(4)

URLパターン
URLパターンをまとめるノードです。
選択すると，URLパターンの一覧ページが表示されます。
－
21.11.2　(4)

＜URLパターン＞
URLパターンを示すノードです。
選択すると，URLパターンのプロパティページが表示されます。
<url-pattern>
21.11.2　(5)

（凡例）　－：該当なし

(2)　コンテキストメニュー操作

サーブレット属性のツリービューに表示されるノードは，次のコンテキストメニューを持ちます。コンテキストメニューは，マウスの右クリックで表示します。

表21-151　サーブレット属性のコンテキストメニュー

ノード
コンテキストメニュー
説明
プロパティページ

サーブレット属性
［追加］ - ［アイコン］
サーブレット属性にアイコンが追加されます。
アイコンのプロパティページが表示されます。
すでにアイコンがある場合は選択できません。
21.4.2　(2)

［追加］ - ［初期化パラメーター］
サーブレット属性に初期化パラメタが追加されます。
パラメタのプロパティページが表示されます。
21.9.2　(4)

［追加］ - ［URLパターン］
サーブレット属性にURLパターンが追加されます。
URLパターンのプロパティページが表示されます。
21.11.2　(5)

アイコン
［削除］
サーブレット属性からアイコンが削除されます。
－

初期化パラメーター
［追加］ - ［初期化パラメーター］
［初期化パラメーター］に初期化パラメタが追加されます。
パラメタのプロパティページが表示されます。
21.9.2　(4)

削除
サーブレット属性からすべての初期化パラメタが削除されます。
－

＜初期化パラメーター名＞
削除
サーブレット属性から選択した初期化パラメタが削除されます。
－

URLパターン
［追加］ - ［URLパターン］
［URLパターン］にURLパターンが追加されます。
URLパターンのプロパティページが表示されます。
21.11.2　(5)

削除
サーブレット属性からすべてのURLパターンが削除されます。
－

＜URLパターン＞
削除
サーブレット属性から選択したURLパターンが削除されます。
－

（凡例）　－：該当なし

21.11.2　サーブレット属性設定ページ

エディタエリアには，［エレメント］と［エレメントの詳細］が表示されています。［エレメントの詳細］に編集するサーブレット属性ファイルのプロパティページが表示されます。

エディタエリアの［エレメント］のツリーのノードを選択すると，エディタエリアの表示が切り替わります。

サーブレット属性ファイルには，次のプロパティページがあります。

アイコンのプロパティページ

サーブレットの一覧ページ

サーブレットのプロパティページ

URLパターンの一覧ページ

URLパターンのプロパティページ

注意事項

プロパティページで，設定が必須の項目には「*」が付与されています。

＜この項の構成＞

(1)　アイコンのプロパティページ

(2)　サーブレットの一覧ページ

(3)　サーブレットのプロパティページ

(4)　URLパターンの一覧ページ

(5)　URLパターンのプロパティページ

(1)　アイコンのプロパティページ

サーブレット属性のアイコンのプロパティページについては，「21.4.2　アプリケーション属性設定ページ」の「(2)　アイコンのプロパティページ」を参照してください。

(2)　サーブレットの一覧ページ

サーブレットの一覧ページを次に示します。

サーブレットの一覧には，設定されたサーブレットがリストで表示されます。

図21-161　サーブレットの一覧ページ

表21-152　サーブレットの一覧の表示項目

項目
説明
対応するタグ

サーブレット
サーブレットの表示名が表示されます。
<hitachi-servlet-property>
<display-name>
サーブレット
</display-name>
</hitachi-servlet-property>

スタートアップ時のロード
スタートアップ時にロードするかどうかの指定が表示されます。
<hitachi-servlet-property>
<load-on-startup>
スタートアップ時のロード
</load-on-startup>
</hitachi-servlet-property>

(3)　サーブレットのプロパティページ

サーブレットのプロパティページを次に示します。

図21-162　サーブレットのプロパティページ

表21-153　サーブレットのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

説明
×
サーブレットについての説明を指定します。
<description>
説明
</description>

表示名
－
サーブレットの表示名が表示されます。
<display-name>
表示名
</display-name>

スタートアップ時のロード
×
webアプリケーションのスタートアップ時にサーブレットをロードするかどうか，およびサーブレットのロード順を「-2147483648」から「2147483647」の整数で指定します。
正の整数を指定した場合は，その昇順でロードされます。
負の整数を指定した場合は，必要になった時にロードされます。
ロード順を指定しない場合，「-1」が仮定されます。
<load-on-startup>
スタートアップ時のロード
</load-on-startup>

（凡例）　×：任意　－：変更不可

(4)　URLパターンの一覧ページ

URLパターンの一覧ページを次に示します。

URLパターンの一覧には，設定されたURLパターンがリストで表示されます。

図21-163　URLパターンの一覧ページ

表21-154　URLパターンの一覧の表示項目

項目
説明
対応するタグ

URLパターン
サーブレットをマッピングするURLパターンが表示されます。
サーブレット属性に，複数のURLパターンがある場合，同じURLパターンは指定できません。
<url-pattern>
URLパターン
</url-pattern>

(5)　URLパターンのプロパティページ

URLパターンのプロパティページを次に示します。

図21-164　URLパターンのプロパティページ

表21-155　URLパターンのプロパティページの設定項目

項目
必須／任意
説明
対応するタグ

URLパターン
○
サーブレットをマッピングするURLパターンを指定します。
<url-pattern>
URLパターン
</url-pattern>

（凡例）　○：必須

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

アプリケーション統合属性ファイルの［RAR］タブを選択すると，エディタエリアに，J2EEアプリケーションに含まれるリソースアダプタの［RAR］フォームページが表示されます。

図21-165　［RAR］フォームページ例

フォームページの［エレメント］には，Connector属性ファイルの構成がツリーで表示されます。［エレメントの詳細］に編集するConnector属性ファイルのプロパティページが表示されます。アプリケーション統合属性ファイルで編集できるConnector属性は，Connector属性ファイルと同じです。Connector属性ファイルのツリーについては，「21.2.1　Connector属性のツリー」を，Connector属性ファイルのプロパティページについては，「21.2.2　Connector属性設定ページ」を参照してください。

付録

＜この付録の構成＞

付録A　ベーシックモードの利用（互換用機能）

付録B　このマニュアルの参考情報

付録A　ベーシックモードの利用（互換用機能）

J2EEサーバの動作モードには，ベーシックモードと1.4モード（06-71までのスタンダードモードまたはアドバンスドモード）があります。

ここでは，旧バージョンとの互換用機能としてのベーシックモードについて説明します。また，ベーシックモードで使用できる機能の一覧を示します。

＜この節の構成＞

付録A.1　ベーシックモードの概要

付録A.2　データベースと接続するための設定（データソースを使用する場合）

付録A.3　コネクションプーリングとコネクションスイーパの動作

付録A.4　データソースへのリファレンス定義

付録A.1　ベーシックモードの概要

ベーシックモードは，単一のデータベースだけのリソースをトランザクションで使用するシステムに適用できます。旧バージョンとの互換性を重視したモードです。

ベーシックモードでは，データソースを使用してデータベースに接続します。データソースを使用してデータベースと接続するための設定については，「付録A.2　データベースと接続するための設定（データソースを使用する場合）」を参照してください。

J2EEアプリケーションがデータソースを呼び出す場合のリファレンスの定義については，「付録A.4　データソースへのリファレンス定義」を参照してください。

なお，1.4モードとベーシックモードでは使用できる機能に差異があります。ベーシックモードで使用できる機能については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「9.2　使用できる機能の一覧」を参照してください。差異のない機能については，本文を参照してください。

付録A.2　データベースと接続するための設定（データソースを使用する場合）

ここでは，ベーシックモードでのリソース接続について説明します。

データベースと接続するために必要なデータソースの設定をします。データソースの設定は，サーバ管理コマンドで実行します。

データソースを使用してデータベースと接続するには，J2EEサーバをベーシックモードで動作させる必要があります。

データソースの設定の流れを次に示します。

Cosminexus DABroker Libraryの環境設定をします。

データソースをインポートします。

プロパティを定義します。

接続を確認します。

インポートしたデータソースは，削除およびコピーができます。データソースの削除については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeleteres（リソースの削除）」を参照してください。データソースのコピーについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjcopyres（リソースのコピー）」を参照してください。

＜この項の構成＞

(1)　Cosminexus DABroker Libraryの環境設定

(2)　データソースのインポート

(3)　データソースのプロパティ定義

(4)　データソースの接続テスト

(1)　Cosminexus DABroker Libraryの環境設定

Cosminexus DABroker Libraryは，Cosminexus DABroker Libraryの環境設定ユティリティ（Windowsの場合），またはCosminexus DABroker Library動作環境定義ファイル（UNIXの場合）で設定します。設定方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「11.　Cosminexus DABroker Libraryを使用したデータベース接続」を参照してください。

(2)　データソースのインポート

データソースまたはJDBCドライバをJ2EEサーバにインポートします。

次に示すコマンドを実行してデータソースをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type datasource -resname ＜データソースの表示名＞ -c ＜データソース設定ファイルパス＞ -f ＜JDBCドライバファイルパス＞

実行例

cjimportres MyServer -type datasource -resname JdbcDbpsv -c JdbcDbpsvConf.xml -f JdbcDbpsv.jar

cjimportresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

注意事項

JDBCのデータソースとしてインポートできるCosminexus DABroker LibraryのJARファイルは，JdbcDbpsv.jarだけです。JdbcDbpsvEX.jarはサポートされていません。また，JdbcDbpsv.jarは，「＜Cosminexusのインストールディレクトリ＞¥DABJ」ディレクトリ（Windowsの場合）または「/opt/Cosminexus/DABJ」ディレクトリ（UNIXの場合）に配置されている必要があります。

データソースの表示名には，すでにあるデータソースの名前やメールサーバ構成情報の名前を指定しないでください。

インポート時に指定したJARファイル名は，作業ディレクトリ中のディレクトリ名として用いられます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにJARファイル名を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

データソースを削除するまで，J2EEサーバ用ユーザプロパティファイル（usrconf.properties）のejbserver.http.portキーの値は変更しないでください。変更した場合は，データソースを再作成してください。

(3)　データソースのプロパティ定義

データソースのプロパティを定義します。プロパティの設定手順については，「3.3　属性ファイルによるプロパティの設定」を参照してください。

(a)　編集する属性ファイル

データソース属性ファイル

(b)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行して，データソースのデータソース属性ファイルを取得します。

実行形式

cjgetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type datasource -resname ＜データソースの表示名＞ -c ＜属性ファイルパス＞

実行例

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

●属性の設定

次に示すコマンドを実行して，データソース属性ファイルの値を反映します。

実行形式

cjsetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type datasource -resname ＜データソースの表示名＞ -c ＜属性ファイルパス＞

実行例

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

(c)　編集する属性設定項目

データソースのプロパティ設定項目を次に示します。

データソースの一般情報

実行時プロパティ

コネクションプーリング情報

●データソースの一般情報

データソースの一般情報の設定項目を次に示します。

項目 | 対応するタグ
データソースの説明 | <description>
データソース名 | <display-name>

●実行時プロパティ

データソースの実行時プロパティ（<property>タグ）の設定項目を次に示します。

項目 | 対応するタグ
プロパティ名 | <name>
XADataSourceインタフェースのプロパティ値 | <XADataSource>

注　データソースについて設定する項目は，インポートしたデータベースの種類によって異なります。データベースに固有の項目については，そのデータベースのマニュアルを参照してください。

定義するプロパティの数だけ，<property>タグの設定を繰り返してください。

プロパティの設定項目については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.4　データソース属性ファイル」を参照してください。

●コネクションプーリング情報

プーリングとはデータソースとデータベースのコネクションをあらかじめ確立しておき，接続時のオーバーヘッドを減らす手法です。データソースがデータベースコネクションプーリングをサポートする場合，データベースコネクションプールの管理方法を指定できます。コネクションプーリング情報は，プールにあらかじめどのくらいのコネクションを用意しておくのか，また，プールにある不要なコネクションを削除するタイミングなどを指定します。

コネクション取得時にエラーとなった場合に，アプリケーションにエラーを返さないで，繰り返し取得を試みることができます。プーリングしてあるすべてのコネクションが使用中で一時的に取得失敗になる場合など，本機能によってアプリケーションにエラーを返すことなくコネクションを再取得できます。

データソースのコネクションプーリング情報，およびコネクション再取得情報（<PoolConfiguration>タグ）の設定項目を次に示します。

項目
説明
対応するタグ

コネクションプールにプールするコネクションの最小値
データベースコネクションプールに割り当てるデータベースコネクションの最小数を指定します。この最小値に達すると，データベースコネクションはそれ以上削除されません。
定常状態の同時コネクション数を指定してください。
<MinimumSize>

コネクションプールにプールするコネクションの最大値
データベースコネクションプールで使用できるデータベースコネクションの最大数を指定します。この最大値に達すると，それ以上のデータベースコネクションは追加されません。-1を指定すると，無制限にコネクションを使用できます。この場合，データベースで許容される最大コネクション数によって最大数は制限されます。
同時コネクション数の最大値を指定してください。
<MaximumSize>

コネクションプールにプールするコネクションのしきい値
データベースコネクションプールにデータベースコネクションを追加するしきい値を指定します。つまり，プールにある未使用コネクションの数がここで指定した値以下になった場合，データベースコネクションをプールに追加します。
<Threshold>

コネクションプールにプールするコネクションの増分値
しきい値に達した場合にデータベースコネクションプールに追加するデータベースコネクションの数を指定します。
<GrowthIncrement>

コネクション取得待ち時間（秒）
データベースコネクションプールからデータベースコネクションを取得しようとするときに，コネクション取得のリトライをするまでのアプリケーションの待ち時間を秒単位で指定します。指定した時間が経過してもリトライしない場合，エラーが返されます。コネクションが使用できない場合に待たないようにするときは0を指定し，コネクションを取得できるまで待つようにするときは-1を指定します。
<WaitTimeout>

コネクション接続タイムアウト値（秒）
データベースコネクションの保持時間を秒単位で指定します。指定した時間が経過すると，次のスイーパサイクルでデータベースコネクションを削除します。コネクションタイムアウトの経過後，最小数よりも多く使用できるコネクションがプール内にある場合，そのコネクションは削除されます。プール内に最小数のコネクションだけがある場合，そのコネクションはリオープンされます。
<ConnectionTimeout>

スイーパ起動時間
スイーパサイクルの間隔を秒単位で指定します。スイーパサイクルは，すべてのデータベースコネクションをチェックし，<ConnectionTimeout>で指定した時間よりも古いコネクションを削除します。
<SweeperInterval>

コネクション取得のリトライ回数
コネクションの取得に失敗して，再度取得を行う場合のリトライ回数を指定します。
<RetryCount>

コネクション取得をリトライするまでの時間（秒）
コネクションの取得に失敗して，再度取得を行う場合のリトライ間隔を指定します。
<RetryInterval>

プーリングを使用しない場合，すべてのフィールドに0を指定します。この場合，データソースは，非プーリングデータソースのように動作します。つまり，データベースコネクションを保持しません。また，データベースコネクションが必要な場合，要求側は，データソースがインタフェースを取得するまで待たなければなりません。したがって，性能にかなりの影響を与えることになります。

コネクションプーリング機能を使用する場合の，コネクションプーリングとコネクションスイーパの動作については，「付録A.3　コネクションプーリングとコネクションスイーパの動作」を参照してください。

(4)　データソースの接続テスト

データソースに設定した内容が正しいかどうか，接続テストによって検証します。

次に示すコマンドを実行してデータソースの接続を確認します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type datasource -resname＜データソースの表示名＞ ［-resname ＜データソースの表示名＞］

実行例

cjtestres -type datasource -resname Myds1

cjtestresコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

付録A.3　コネクションプーリングとコネクションスイーパの動作

データソースのプロパティで設定するコネクションプーリングとコネクションスイーパの動作，コネクションを共有する場合の留意点について説明します。

コネクションプーリングについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.1　コネクションプーリング」を参照してください。コネクションスイーパについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.15.7　コネクションスイーパ」を参照してください。

＜この項の構成＞

(1)　コネクションプーリングの動作

(2)　コネクションスイーパの動作

(3)　コネクションを共有する場合の留意点

(4)　注意事項

(1)　コネクションプーリングの動作

サーバ上での最初のアクセス時（具体的には最初のjavax.sql.DataSource#getConnectionメソッド発行時），コネクションプールにプールするコネクションの最小値（<MinimumSize>）の値のJDBCコネクションを確立（接続）しプールします。データベースサーバの制限によって<MinimumSize>の値のコネクションが確立できない場合，<MinimumSize>の値以下の状態になります。

ユーザアプリケーションプログラムがJDBCコネクションを取得（javax.sql.DataSource#getConnectionメソッド）すると，プール内の未使用状態のコネクションが一つ選択され，ユーザアプリケーションプログラムに渡されます。選択された該当コネクションは，プール内で使用中状態となります。

ユーザアプリケーションプログラムがJDBCコネクションを解放（java.sql.Connection#closeメソッド）すると，解放したJDBCコネクションに異常がなく，再利用できる場合，該当するJDBCコネクションはプール内で未使用状態に戻ります。解放したコネクションが再利用できない場合，該当するJDBCコネクションは破棄されます。

未使用状態のコネクションが，コネクションプールにプールするコネクションのしきい値（<Threshold>）の値以下になると，プール内のコネクションを，コネクションプールにプールするコネクションの増分値（<GrowthIncrement>）の値ずつ増加させます。DBサーバの制限によって<GrowthIncrement>の値のコネクションが確立できない場合は，増分は<GrowthIncrement>の値以下になります。

ユーザアプリケーションプログラムがJDBCコネクションを取得しようとしたときにプールに未使用コネクションがない場合，コネクション取得待ち時間（<WaitTimeout>）の値の間，待たされます。このあと，まだプールに未使用コネクションがない場合，ユーザアプリケーションプログラムに例外が通知されます。

(2)　コネクションスイーパの動作

前回のコネクションスイーパの動作が終了してから，スイーパ起動時間（<SweeperInterval>）の値の経過後，コネクションスイーパが動作します。

コネクションスイーパは，プール内の未使用状態コネクションを次の観点で監視します。

該当コネクションの生成時点からの経過時間が，コネクション接続タイムアウト値（<ConnectionTimeout>）の値未満の場合は何もしません。

該当コネクションの生成時点からの経過時間が，<ConnectionTimeout>の値以上の場合はコネクションを破棄します。

プールに残ったコネクション数が，<MinimumSize>の値以下の場合，コネクションスイーパは<MinimumSize>の値までコネクションを確立します。

(3)　コネクションを共有する場合の留意点

コネクションシェア機能は，同一JavaVM内という条件で，同一トランザクション（ここでのトランザクションとはjavax.transaction.UserTransactionによるトランザクションまたはEJBでのCMTによるトランザクションだけ）中での同一データソース（javax.sql.DataSource）へのコネクション取得要求（getConnectionメソッド）に対して，アプリケーションが同一の物理コネクションを共有できるようにするものです。これによって，アプリケーションがトランザクション中で同じデータソースから複数回コネクションを取得してSQLを発行した場合，トランザクションコミット時にそれぞれのSQLの処理結果をデータベースにまとめて反映できます。この機能を利用するには，コネクションプールの設定でコネクション数<MinimumSize>を1以上に設定する必要があります。なお，コネクションシェア機能は，同一データソース（javax.sql.DataSource）に対し，パラメタなしgetConnectionメソッドと，パラメタありgetConnection（java.lang.String username，java.lang.String password）メソッド間では，同一トランザクション中でもコネクションを共有できません。また，パラメタありのgetConnection（java.lang.String username，java.lang.String password）メソッド間でusernameが異なる場合，同一トランザクション中でもコネクションを共有できません。

(4)　注意事項

データソースの表示名（<display-name>）には，すでにあるデータソースの名前やメールサーバ構成情報の名前を指定しないでください。

コネクションプーリングの設定を変更した場合，設定内容を有効にするためにJ2EEサーバを再起動してください。

コネクションプーリング機能を利用する場合には，データベースサーバ側からコネクションを強制的に切断する機能（タイムアウトなど）を利用しないでください。

付録A.4　データソースへのリファレンス定義

J2EEアプリケーションを構成する，Enterprise BeanおよびWebアプリケーション（サーブレットおよびJSP）がデータソースを呼び出す場合，データソースのリファレンスを解決するためのプロパティを設定します。

＜この項の構成＞

(1)　Enterprise Beanのリファレンス定義

(2)　サーブレットとJSPのリファレンス定義

(1)　Enterprise Beanのリファレンス定義

J2EEアプリケーションを構成するEnterprise Beanが，データソースを参照している場合，リファレンスを解決するためのプロパティを設定します。

(a)　編集する属性ファイル

J2EEアプリケーションを構成するEnterprise Beanの種類に対応する属性ファイルを編集します。

Session Bean属性ファイル

Entity Bean属性ファイル

Message-driven Bean属性ファイル

(b)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してEnterprise Beanの属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type ejb -resname addr/cadder_eb -c C:¥home¥adder_ejb.xml

●属性の設定

次に示すコマンドを実行して，Enterprise Beanの属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type ejb -resname ＜EJB-JAR表示名＞/＜Enterprise Bean表示名＞ -c ＜Enterprise Beanの属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type ejb -resname addr/adder_eb -c C:¥home¥adder_ejb.xml

(c)　編集する属性設定項目

データソースのリファレンス設定項目（<resource-ref>）を次に示します。

項目 | 必須 | 対応するタグ名
説明 | △ | <description>
リソース参照名 | ○ | <res-ref-name>
リソースタイプ | ○ | <res-type>
リソース認証方式 | ○ | <res-auth>
リソース共有 | △ | <res-sharing-scope>
リンク先のデータソース名 | △ | <linked-to>

（凡例）　○：必須　△：任意

プロパティの設定項目については，次の個所を参照してください。

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」

(2)　サーブレットとJSPのリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）がデータソースを呼び出す場合，データソースのリファレンスを解決するためのプロパティを設定します。

(a)　編集する属性ファイル

WAR属性ファイル

(b)　編集する属性ファイルの取得と属性の設定

●属性ファイルの取得

次に示すコマンドを実行してWAR属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjgetappprop MyServer -name adder -type war -resname adder -c C:¥home¥adder_war.xml

●属性の設定

次に示すコマンドを実行して，WAR属性ファイルの値を反映します。

実行形式

cjsetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type war -resname ＜WAR表示名＞ -c ＜WAR属性ファイルパス＞

実行例

cjsetappprop MyServer -name adder -type war -resname adder -c C:¥home¥adder_war.xml

(c)　編集する属性設定項目

Enterprise Beanが，データソースを参照している場合のプロパティ設定項目と同じです。「(1)　Enterprise Beanのリファレンス定義」の「(c)　編集する属性設定項目」を参照してください。

付録B　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

＜この節の構成＞

付録B.1　関連マニュアル

付録B.2　このマニュアルでの表記

付録B.3　英略語

付録B.4　KB（キロバイト）などの単位表記について

付録B.1　関連マニュアル

アプリケーションサーバのマニュアルについて次に示します。

Cosminexus アプリケーションサーバ V8 概説（3020-3-U01）
アプリケーションサーバの概要について説明しています。

Cosminexus アプリケーションサーバ V8 ファーストステップガイド（3020-3-U02）
Application ServerまたはDeveloperを使用して，サンプルプログラムを動かすためのシステムを構築する手順について説明しています。

Cosminexus アプリケーションサーバ V8 システム設計ガイド（3020-3-U03）
システム設計時に，システムの目的に応じたシステム構成や運用方法を検討するための指針について説明しています。また，チューニングの方法についても説明しています。

Cosminexus アプリケーションサーバ V8 システム構築・運用ガイド（3020-3-U04）
セットアップウィザードおよびSmart Composer機能を使用したシステムの構築・運用の手順について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(Webコンテナ)（3020-3-U05）
アプリケーションサーバで提供するWebコンテナの機能，およびWebコンテナに関連する機能（Webサーバ，サーブレット／JSPなど）について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(EJBコンテナ)（3020-3-U06）
アプリケーションサーバで提供するEJBコンテナの機能，およびEJBコンテナに関連する機能（EJB，EJBクライアントなど）について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(コンテナ共通機能)（3020-3-U07）
WebコンテナおよびEJBコンテナで共通して利用する機能について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 拡張編（3020-3-U08）
アプリケーションサーバで提供する拡張機能（セッションフェイルオーバ機能，バッチサーバ，CTMなど）について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 運用／監視／連携編（3020-3-U09）
アプリケーションサーバで提供する運用・監視機能，およびほかのプログラムとの連携について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 保守／移行／互換編（3020-3-U10）
アプリケーションサーバで構築したシステムの保守に関する機能，移行情報，および互換用機能について説明しています。

Cosminexus アプリケーションサーバ V8 運用管理ポータル操作ガイド（3020-3-U13）
運用管理ポータルの使用方法について説明しています。

Cosminexus アプリケーションサーバ V8 リファレンス コマンド編（3020-3-U14）
アプリケーションサーバを構築・運用するときに使用するコマンドについて説明しています。

Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義)（3020-3-U15）
アプリケーションサーバを構築・運用するとき，またはアプリケーションを開発するときに使用するファイルのうち，J2EEサーバやManagement Serverなどのサーバの定義に使用するファイルの形式について説明しています。

Cosminexus アプリケーションサーバ V8 リファレンス 定義編(アプリケーション／リソース定義)（3020-3-U16）
アプリケーションサーバを構築・運用するとき，またはアプリケーションを開発するときに使用するファイルのうち，アプリケーションやリソースの属性設定に使用するファイルの形式について説明しています。

Cosminexus アプリケーションサーバ V8 仮想化システム構築・運用ガイド（3020-3-U18）
アプリケーションサーバを仮想化したサーバ上に構築する場合の，設計，構築，運用の手順について説明しています。

Cosminexus アプリケーションサーバ V8 アプリケーション開発ガイド（3020-3-U25）
アプリケーションサーバで動作させるアプリケーションの開発方法について説明しています。

Cosminexus アプリケーションサーバ V8 リファレンス API編（3020-3-U26）
アプリケーションを開発するときに使用するAPIの形式について説明しています。

Cosminexus アプリケーションサーバ V8 メッセージ 1 KDAL-KDCGおよびHitachi Web Server編（3020-3-U41）
アプリケーションサーバで出力されるKDALからKDCGまでのメッセージ，およびHitachi Web Serverのメッセージについて説明しています。

Cosminexus アプリケーションサーバ V8 メッセージ 2 KDJE-KDJW編（3020-3-U42）
アプリケーションサーバで出力されるKDJEからKDJWまでのメッセージについて説明しています。

Cosminexus アプリケーションサーバ V8 メッセージ 3 KECX-KEDT／KEOS02000-29999／KEUC-KFRM編（3020-3-U43）
アプリケーションサーバで出力されるKECXからKEDTまでのメッセージ，KEOS02000からKEOS29999までのメッセージ，およびKEUCからKFRMまでのメッセージについて説明しています。

Cosminexus アプリケーションサーバ V8 メッセージ 4 監査ログ編（3020-3-U44）
アプリケーションサーバで出力される監査ログメッセージについて説明しています。

また，このマニュアルと関連するこのほかのマニュアルを次に示します。必要に応じてお読みください。

Cosminexus アプリケーションサーバ V8 Cosminexus Reliable Messaging（3020-3-U21）

VisiBroker Version 5 Borland(R) Enterprise Server VisiBroker(R)　デベロッパーズガイド（3020-3-U28）

VisiBroker Version 5 Borland(R) Enterprise Server VisiBroker(R)　プログラマーズリファレンス（3020-3-U29）

スケーラブルデータベースサーバ HiRDB Version 8 解説（UNIX(R)用）（3000-6-351）

スケーラブルデータベースサーバ HiRDB Version 8 システム定義（UNIX(R)用）（3000-6-353）

スケーラブルデータベースサーバ HiRDB Version 8 解説（Windows(R)用）（3020-6-351）

スケーラブルデータベースサーバ HiRDB Version 8 システム定義（Windows(R)用）（3020-6-353）

HiRDB Version 9 解説（UNIX(R)用）（3000-6-451）

HiRDB Version 9 システム定義（UNIX(R)用）（3000-6-453）

HiRDB Version 9 解説（Windows(R)用）（3020-6-451）

HiRDB Version 9 システム定義（Windows(R)用）（3020-6-453）

なお，このマニュアルでは，次のマニュアルについて，対象OSおよびバージョン番号を省略して表記しています。マニュアルの正式名称とこのマニュアルでの表記を次の表に示します。

正式名称 | このマニュアルでの表記
Cosminexus アプリケーションサーバ V8 概説 | Cosminexus アプリケーションサーバ 概説
Cosminexus アプリケーションサーバ V8 ファーストステップガイド | Cosminexus アプリケーションサーバ ファーストステップガイド
Cosminexus アプリケーションサーバ V8 システム設計ガイド | Cosminexus アプリケーションサーバ システム設計ガイド
Cosminexus アプリケーションサーバ V8 システム構築・運用ガイド | Cosminexus アプリケーションサーバ システム構築・運用ガイド
Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(Webコンテナ) | Cosminexus アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)
Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(EJBコンテナ) | Cosminexus アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)
Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(コンテナ共通機能) | Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)
Cosminexus アプリケーションサーバ V8 機能解説 拡張編 | Cosminexus アプリケーションサーバ 機能解説 拡張編
Cosminexus アプリケーションサーバ V8 機能解説 運用／監視／連携編 | Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編
Cosminexus アプリケーションサーバ V8 機能解説 保守／移行／互換編 | Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編
Cosminexus アプリケーションサーバ V8 運用管理ポータル操作ガイド | Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド
Cosminexus アプリケーションサーバ V8 リファレンス コマンド編 | Cosminexus アプリケーションサーバ リファレンス コマンド編
Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義) | Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)
Cosminexus アプリケーションサーバ V8 リファレンス 定義編(アプリケーション／リソース定義) | Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)
Cosminexus アプリケーションサーバ V8 仮想化システム構築・運用ガイド | Cosminexus アプリケーションサーバ 仮想化システム構築・運用ガイド
Cosminexus アプリケーションサーバ V8 アプリケーション開発ガイド | Cosminexus アプリケーションサーバ アプリケーション開発ガイド
Cosminexus アプリケーションサーバ V8 リファレンス API編 | Cosminexus アプリケーションサーバ リファレンス API編
Cosminexus アプリケーションサーバ V8 メッセージ 1 KDAL-KDCGおよびHitachi Web Server編 | Cosminexus アプリケーションサーバ メッセージ 1
Cosminexus アプリケーションサーバ V8 メッセージ 2 KDJE-KDJW編 | Cosminexus アプリケーションサーバ メッセージ 2
Cosminexus アプリケーションサーバ V8 メッセージ 3 KECX-KEDT／KEOS02000-29999／KEUC-KFRM編 | Cosminexus アプリケーションサーバ メッセージ 3
Cosminexus アプリケーションサーバ V8 メッセージ 4 監査ログ編 | Cosminexus アプリケーションサーバ メッセージ 4
Cosminexus アプリケーションサーバ V8 Cosminexus Reliable Messaging | Cosminexus Reliable Messaging
スケーラブルデータベースサーバ HiRDB Version 8 システム定義（UNIX(R)用） | HiRDB システム定義
スケーラブルデータベースサーバ HiRDB Version 8 システム定義（Windows(R)用）
HiRDB Version 9 システム定義（UNIX(R)用）
HiRDB Version 9 システム定義（Windows(R)用
スケーラブルデータベースサーバ HiRDB Version 8 解説（UNIX(R)用） | HiRDB 解説
スケーラブルデータベースサーバ HiRDB Version 8 解説（Windows(R)用）
HiRDB Version 9 解説（UNIX(R)用）
HiRDB Version 9 解説（Windows(R)用）

付録B.2　このマニュアルでの表記

このマニュアルでは，製品名を次のように表記しています。

表記 | 製品名
Application Server | Application Server Enterprise | uCosminexus Application Server Enterprise
Application Server Standard | uCosminexus Application Server Standard
Cosminexus Developer's Kit for Java | Cosminexus Developer's Kit for JavaTM
Developer | Developer Professional | uCosminexus Developer Professional
Developer Standard | uCosminexus Developer Standard
Eclipse | Eclipse 3.6.1
HiRDBまたはHiRDBサーバ | HiRDB/Parallel Server | HiRDB/Parallel Server Version 8
HiRDB/Single Server | HiRDB/Single Server Version 8
HiRDB Server | HiRDB Server Version 9
HiRDB Run TimeまたはHiRDBクライアント | HiRDB/Developer's Kit Version 8
HiRDB/Developer's Kit Version 9
HiRDB/Run Time Version 8
HiRDB/Run Time Version 9
IPF | Itanium(R) Processor Family
Oracle | Oracle10g | Oracle 10g
Oracle 10g R2
Oracle Database 10g
Oracle11g | Oracle Database 11g
Oracle Database 11g R2
Oracle9i | Oracle9i
Oracle9i R2
UNIX | AIX | AIX 5L V5.3
AIX V6.1
AIXV7.1
HP-UXまたはHP-UX（IPF） | HP-UX 11i V2（IPF）
HP-UX 11i V3（IPF）
Linux | Linux（IPF） | Red Hat Enterprise Linux(R) AS 4（IPF）
Red Hat Enterprise Linux(R) 5 Advanced Platform（Intel Itanium）
Red Hat Enterprise Linux(R) 5（Intel Itanium）
Linux（x86/AMD64 & Intel EM64T） | Red Hat Enterprise Linux(R) AS 4（x86）
Red Hat Enterprise Linux(R) ES 4（x86）
Red Hat Enterprise Linux(R) AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux(R) ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux(R) 5 Advanced Platform（x86）
Red Hat Enterprise Linux(R) 5（x86）
Red Hat Enterprise Linux(R) 5 Advanced Platform（AMD/Intel 64）
Red Hat Enterprise Linux(R) 5（AMD/Intel 64）
Red Hat Enterprise Linux(R) Server 6（32-bit x86）
Red Hat Enterprise Linux(R) Server 6（64-bit x86_64）
Solaris | Solaris 10（SPARC）
Solaris 10（x64）
Solaris 9（SPARC）
XDM/RD E2 | VOS3 XDM/RD E2

なお，Application ServerおよびDeveloperを総称して，アプリケーションサーバと表記します。

また，Linuxに関しては，バージョンごとに次のように表記することがあります。

表記 | OS名
Red Hat Enterprise Linux 4 | Red Hat Enterprise Linux(R) AS 4（IPF）
Red Hat Enterprise Linux(R) AS 4（x86）
Red Hat Enterprise Linux(R) ES 4（x86）
Red Hat Enterprise Linux(R) AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux(R) ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5 | Red Hat Enterprise Linux(R) 5 Advanced Platform（Intel Itanium）
Red Hat Enterprise Linux(R) 5（Intel Itanium）
Red Hat Enterprise Linux(R) 5 Advanced Platform（x86）
Red Hat Enterprise Linux(R) 5（x86）
Red Hat Enterprise Linux(R) 5 Advanced Platform（AMD/Intel 64）
Red Hat Enterprise Linux(R) 5（AMD/Intel 64）
Red Hat Enterprise Linux Server 6 | Red Hat Enterprise Linux(R) Server 6（32-bit x86）
Red Hat Enterprise Linux(R) Server 6（64-bit x86_64）

このマニュアルで使用している表記と，対応するアプリケーションサーバの機能名を次に示します。

表記 | アプリケーションサーバの機能名
Cosminexus Developer's Kit for Java | Cosminexus Developer's Kit for JavaTM
Cosminexus RM | Cosminexus Reliable Messaging
CTM | Cosminexus Component Transaction Monitor
Management Server | Cosminexus Management Server
MyEclipse | MyEclipse for Cosminexus
PRF | Cosminexus Performance Tracer
Server Plug-in | Cosminexus Server Plug-in
Smart Composer | Cosminexus Smart Composer

このマニュアルで使用している表記と，対応するJava関連用語を次に示します。

表記 | Java関連用語
Connector 1.0 | J2EETM Connector Architecture 1.0
Connector 1.5 | J2EETM Connector Architecture 1.5
EAR | Enterprise ARchive
EJBまたはEnterprise JavaBeans | Enterprise JavaBeansTM
EJB QL | EJBTM Query Language
J2EEまたはJava 2 Platform, Enterprise Edition | J2EETM
JavaTM 2 Platform, Enterprise Edition
J2SE | JavaTM 2 Platform, Standard Edition
JAAS | JavaTM Authentication and Authorization Service
JAR | JavaTM Archive
Java | JavaTM
JavaBeans | JavaBeansTM
Java EEまたはJava Platform, Enterprise Edition | JavaTM Platform, Enterprise Edition
JavaMail | JavaMailTM
JavaVM | JavaTM Virtual Machine
JCA | J2EETM Connector Architecture
JDBC | JDBCTM
JavaTM Database Connectivity
JDK | JDKTM
JavaTM Development Kit
JMS | JavaTM Message Service
JNDI | Java Naming and Directory InterfaceTM
JSP | JSPTM
JavaServer PagesTM
JSTL | JavaServer PagesTM Standard Tag Library
JTA | JavaTM Transaction API
Servletまたはサーブレット | JavaTM Servlet
WAR | Web ARchive

付録B.3　英略語

このマニュアルで使用している英略語を次に示します。

英略語 | 英字での表記
API | Application Programming Interface
BMP | Bean-Managed Persistence
BMT | Bean-Managed Transaction
CMP | Container-Managed Persistence
CMR | Container-Managed Relationship
CMT | Container-Managed Transaction
CORBA | Common Object Request Broker Architecture
CSV | Comma Separated Value
CUI | Character User Interface
DB | Database
DBMS | Database Management System
DD | Deployment Descriptor
DIT | Directory Information Tree
DMZ | Demilitarized Zone
DN | Distinguished Name
DNS | Domain Name System
DTD | Document Type Definition
EIS | Enterprise Information System
EL | Expression Language
EUC | Extended UNIX Code
GUI | Graphical User Interface
HA | High Availability
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
HTTPS | Hyper Text Transfer Protocol Security
IIOP | Internet Inter-Orb Protocol
JNI | Java Native Interface
LAN | Local Area Network
MDA | Model Driven Architecture
MIB | Management Information Base
OID | Object Identifier
OMG | Object Management Group
ORB | Object Request Broker
OS | Operating System
OTM | Object Transaction Monitor
OTS | Object Transaction Service
RAC | Real Application Clusters
RDB | Relational Database
RMI | Remote Method Invocation
RPC | Remote Procedure Call
SFO | Session Fail Over
SHA | Secure Hash Algorithm
SNMP | Simple Network Management Protocol
SPI | Service Provider Interface
SPP | Service Providing Program
UML | Unified Modeling Language
URI | Uniform Resource Identifier
URL | Uniform Resource Locator

付録B.4　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

索引

[記号]
[Ｃ][Ｄ][Ｅ][Ｈ][Ｊ][Ｍ][Ｐ][Ｒ][Ｓ][Ｕ][Ｗ]
[ア行][カ行][サ行][タ行][ハ行][マ行][ヤ行][ラ行]

(記号)

［Cosminexus Management Serverリモート管理機能へログイン］ダイアログ

［Cosminexus RMI-IIOP インタフェース］ページの操作

［Cosminexus RMI-IIOP インタフェース］ページの表示

［Cosminexus Server Plug-in］パースペクティブの構成

［コンソール］ビュー

［コンソール］ビュー

［コンソール］ビュー

［サーバー・エクスプローラー］ビュー

［サーバー・エクスプローラー］ビュー

［サーバー・エクスプローラー］ビュー

［サーバー・エクスプローラー］ビューの構成

［サーバー・エクスプローラー］ビューの構成

［サーバー・エクスプローラー］ビューの操作メッセージ

［詳細設定］タブ

［接続ホスト］タブ

［接続ホストの追加］ダイアログ

［接続ホストの編集］ダイアログ

［問題］ビュー

［問題］ビュー

(英字)

(Ｃ)

CMP1.xとデータベースのマッピング

CMP2.xとデータベースのマッピング

CMP2.xとデータベースのマッピング

CMP定義

CMPの設定

CMR

CMRについての注意事項

CMRの定義

CMR用の表

CMR用の表の概要

CMR用の表の生成と削除

CMR用の表の命名規則

Connector属性設定ページ

Connector属性のインポート

Connector属性のインポート（サーバー・エクスプローラーの操作）

Connector属性のインポートとエクスポート

Connector属性のエクスポート

Connector属性のエクスポート（サーバー・エクスプローラーの操作）

Connector属性のツリー

Connector属性のプロパティページ

Connector属性ファイルのフォームページ

Cosminexus RMI-IIOPインタフェースのエクスポート

Cosminexusアプリケーションのエクスポート（サーバー・エクスプローラーの操作）

Cosminexusリソースアダプタのエクスポート（サーバー・エクスプローラーの操作）

CTMのスケジューリング

CTMのスケジューリング

CTM連携のプロパティページ

CTM連携のプロパティページ

(Ｄ)

DB Connectorのアンデプロイ

DB Connectorのインポート

DB Connectorのエクスポート

DB Connectorの開始

DB Connectorの接続テスト

DB Connectorの停止

DB Connectorのデプロイ

DB Connectorのプロパティ定義

(Ｅ)

EJB-JAR属性設定ページ

EJB-JAR属性のツリー

EJB-JARのプロパティページ

EJB-JARファイルの追加

EJBホームオブジェクト

Enterprise Bean（EJB-JAR）のインポート

Enterprise Beanの起動順序の設定

Enterprise Beanの起動順序の設定

Enterprise Beanの実行時属性の定義

Enterprise Beanの実行時属性の定義

Enterprise Beanのセキュリティアイデンティティ

Enterprise Beanのセキュリティロールリファレンスの定義

Enterprise Beanのプロパティ設定項目

Enterprise Beanのリファレンス定義

Enterprise Beanのリファレンス定義

Enterprise Beanのリファレンス定義

Enterprise Bean名の参照と変更

Enterprise Beanリファレンス定義

Entity Bean属性設定ページ

Entity Bean属性のツリー

Entity BeanのCMP定義

Entity Beanの実行時プロパティの設定

Entity Beanの実行時プロパティの設定

Entity Beanのプロパティページ

(Ｈ)

HTTPリクエストのプロパティページ

HTTPレスポンスのプロパティページ

(Ｊ)

J2EEアプリケーション（共通）のプロパティ設定項目

J2EEアプリケーションからのライブラリJARファイルの削除

J2EEアプリケーション管理に使用するアプリケーション設定操作

J2EEアプリケーション管理の流れ

J2EEアプリケーション単位のスケジューリング

J2EEアプリケーション単位のスケジューリング

J2EEアプリケーションに含まれるリソースアダプタの一覧の参照

J2EEアプリケーションに含まれるリソースアダプタの設定の概要

J2EEアプリケーションの一覧の参照

J2EEアプリケーションの入れ替え

J2EEアプリケーションの入れ替え

J2EEアプリケーションの入れ替え（サーバー・エクスプローラーの操作）

J2EEアプリケーションのインポート

J2EEアプリケーションのインポート

J2EEアプリケーションのエクスポート

J2EEアプリケーションのエクスポート

J2EEアプリケーションのエクスポート（サーバー・エクスプローラーの操作）

J2EEアプリケーションの開始

J2EEアプリケーションの開始

J2EEアプリケーションの管理

J2EEアプリケーションの起動順序の設定

J2EEアプリケーションの起動順序の設定

J2EEアプリケーションの強制停止

J2EEアプリケーションの強制停止

J2EEアプリケーションのコンテキストルート定義

J2EEアプリケーションのコンテキストルート定義

J2EEアプリケーションの削除

J2EEアプリケーションの削除

J2EEアプリケーションの作成

J2EEアプリケーションの作成で実施する作業

J2EEアプリケーションの状態による操作の制約

J2EEアプリケーションの状態表示

J2EEアプリケーションの状態表示

J2EEアプリケーションの新規作成

J2EEアプリケーションの属性編集画面

J2EEアプリケーションの通常開始

J2EEアプリケーションの通常停止

J2EEアプリケーションの通常停止

J2EEアプリケーションの停止

J2EEアプリケーションの停止

J2EEアプリケーションのプロパティ設定と属性ファイル

J2EEアプリケーションのプロパティの設定手順

J2EEアプリケーションへの参照ライブラリの設定

J2EEアプリケーションへのライブラリJARファイルの追加

J2EEアプリケーションへのリソースアダプタの追加

J2EEアプリケーション名の参照

J2EEアプリケーション名の変更

J2EEアプリケーション名の変更（サーバー・エクスプローラーの操作）

J2EEアプリケーションを入れ替える場合にテストモードを使用する

J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポート

J2EEリソースアダプタのアンデプロイ（そのほかのリソースと接続するための設定）

J2EEリソースアダプタのエクスポート

J2EEリソースアダプタのエクスポート（サーバー・エクスプローラーの操作）

J2EEリソースアダプタのエクスポート（そのほかのリソースと接続するための設定）

J2EEリソースアダプタの開始

J2EEリソースアダプタの開始（そのほかのリソースと接続するための設定）

J2EEリソースアダプタの状態と一覧の参照

J2EEリソースアダプタの状態の参照

J2EEリソースアダプタの状態表示

J2EEリソースアダプタの接続テスト

J2EEリソースアダプタの接続テスト（そのほかのリソースと接続するための設定）

J2EEリソースアダプタの停止

J2EEリソースアダプタの停止（そのほかのリソースと接続するための設定）

J2EEリソース一覧の参照

J2EEリソース管理の流れ

J2EEリソースの管理

J2EEリソースのプロパティの設定手順

JavaBeansリソース属性ファイルのテンプレートファイル

JavaBeansリソースのインポート

JavaBeansリソースの開始

JavaBeansリソースの削除

JavaBeansリソースの状態表示

JavaBeansリソースの停止

JavaBeansリソースのプロパティ定義

JNDI名前空間に登録されるJ2EEリソース名の参照と変更

JNDI名前空間に登録される名称の参照と変更

JNDI名前空間に登録されるリソースアダプタ名の参照と変更

JSPのプロパティページ

JSPプロパティグループの一覧ページ

JSPプロパティグループのプロパティページ

JSPをコンパイルして開始

(Ｍ)

Management Serverから通知されるメッセージ

Management Serverリモート管理機能からのログアウト（サーバー・エクスプローラーの操作）

Management Serverリモート管理機能との接続状態

Management Serverリモート管理機能への接続

Management Serverリモート管理機能へのログイン（サーバー・エクスプローラーの操作）

Management Serverを経由して起動されたCUIなどのエラーメッセージ

Message-driven Bean属性設定ページ

Message-driven Bean属性のツリー

Message-driven Beanの実行時プロパティの設定

Message-driven Beanの実行時プロパティの設定

Message-driven Beanのデスティネーション定義のプロパティページ

Message-driven Beanのプロパティページ

Message-driven Beanのメッセージ参照定義

Message-driven Beanのメッセージ参照定義

MIMEタイプのマッピングの一覧ページ

MIMEタイプのマッピングのプロパティページ

(Ｐ)

PostConstructメソッドの一覧のページ

PostConstructメソッドのプロパティページ

PreDestroyメソッドの一覧のページ

PreDestroyメソッドのプロパティページ

(Ｒ)

RMI-IIOPスタブとインタフェースの取得

(Ｓ)

Server Plug-inが処理をしているJ2EEサーバに対してサーバ管理コマンドを実行した場合の制御

Server Plug-inで管理できる論理サーバ

Server Plug-inでのJ2EEアプリケーション設定

Server Plug-inの環境設定

Server Plug-inの機能一覧

Server Plug-inの操作で使用する画面

Server Plug-inパースペクティブ

Session Bean属性設定ページ

Session Bean属性のツリー

Session Beanのプロパティページ

SQL文の生成

Stateful Session Beanの実行時プロパティの設定

Stateful Session Beanの実行時プロパティの設定

Stateful Session Beanのプロパティページ

Stateless Session Bean単位のスケジューリング

Stateless Session Bean単位のスケジューリング

Stateless Session Beanの実行時プロパティの設定

Stateless Session Beanの実行時プロパティの設定

Stateless Session Beanのプロパティページ

(Ｕ)

URLグループ単位での同時実行スレッド数制御の定義

URLグループ単位での同時実行スレッド数制御の定義

URLグループ単位の実行待ちリクエスト数の監視の定義

URLグループ単位の実行待ちリクエスト数の監視の定義

URLグループのスレッド数制御の一覧ページ

URLグループのスレッド数制御のプロパティページ

URLグループのスレッド数制御マッピングの一覧ページ

URLグループのスレッド数制御マッピングのプロパティページ

URLパターンの一覧ページ

URLパターンの一覧ページ

URLパターンのプロパティページ

URLパターンのプロパティページ

usrconf.propertiesファイル

(Ｗ)

WAR属性設定ページ

WAR属性のツリー

WARのプロパティページ

WARファイルの追加

Webアプリケーション初期化失敗時のエラー通知の設定可否

Webアプリケーション単位での同時実行スレッド数制御の定義

Webアプリケーション単位での同時実行スレッド数制御の定義

Windows 7またはWindows Vista使用時の注意事項

(ア行)

(あ)

アーカイブ形式J2EEアプリケーションのインポート（サーバー・エクスプローラーの操作）

アーカイブ形式のJ2EEアプリケーションのインポート

アーカイブ形式のJ2EEアプリケーションのインポート

アイコンのプロパティページ

アイコンのプロパティページ

アイコンのプロパティページ

アイコンのプロパティページ

アプリケーション設定操作

アプリケーション設定操作の実行ホストについての制約

アプリケーション設定操作の制約

アプリケーション設定操作の目的

アプリケーション属性設定ページ

アプリケーション属性のツリー

アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポート

アプリケーション統合属性のインポート

アプリケーション統合属性のインポート（サーバー・エクスプローラーの操作）

アプリケーション統合属性のエクスポート

アプリケーション統合属性のエクスポート（サーバー・エクスプローラーの操作）

アプリケーション統合属性ファイルによるプロパティ設定

アプリケーション統合属性ファイルのエディタの設定

アプリケーション統合属性ファイルのフォームページ

アプリケーションのプロパティページ

アプリケーションを起動しないでJ2EEサーバを起動

アプリケーションを起動しない場合のJ2EEサーバの開始（サーバー・エクスプローラーの操作）

(い)

インジェクションターゲットの一覧のページ（WAR属性）

インジェクションターゲットのプロパティページ（WAR属性）

インターセプタの設定

インタフェースの種類

(う)

ウェルカムファイルのプロパティページ

ウェルカムファイルリストのプロパティページ

運用管理ドメイン内のすべての論理サーバの稼働状態

(え)

永続化コンテキスト参照の一覧ページ

永続化コンテキスト参照のプロパティページ

永続化プロパティの一覧のページ

永続化プロパティのプロパティページ

永続化ユニット参照の一覧のページ

永続化ユニット参照のプロパティページ

エディタエリア

エディタエリア

エラーページ（エラーコード）のプロパティページ

エラーページ（例外クラス）のプロパティページ

エラーページの一覧ページ

(カ行)

(か)

開始（サーバー・エクスプローラーの操作）

開始オプションの設定

稼働中のJ2EEサーバでのトランザクション情報の表示

環境エントリの一覧のページ

環境エントリの一覧のページ（WAR属性）

環境エントリのプロパティページ（EJB-JAR属性）

環境エントリのプロパティページ（WAR属性）

管理するJ2EEアプリケーション

(き)

起動順序の設定

起動順序の設定

強制停止（サーバー・エクスプローラーの操作）

共通ライブラリ

(く)

クラスタコネクションプールの設定

(こ)

更新系コマンド

コネクションスイーパの動作

コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）

コネクションプーリングとコネクションスイーパの動作

コネクションプーリングの動作

コネクションプールの一時停止

コネクションプールの一覧表示と削除

コネクションプールの再開

コネクションプールの削除

コネクションプールの削除

コネクションプールの状態の確認

コネクションプールの状態の確認

コネクションプールの状態表示

コネクションプールの状態表示

コネクションを共有する場合の留意点

個別の論理サーバの起動

個別の論理サーバの停止

コミットオプション

コンソールの共通の設定

コンテナトランザクションの一覧ページ

コンテナトランザクションのプロパティページ

コンフィグレーションプロパティの一覧ページ

コンフィグレーションプロパティの設定例

(サ行)

(さ)

サーバー・エクスプローラーの基本操作

サーバー・エクスプローラーの構成

サーバー・エクスプローラーの操作

サーバ管理コマンドが処理をしているJ2EEサーバに対して異なるサーバ管理コマンドを実行した場合の制御

サーバ管理コマンドで指定するプロバイダURL

サーバ管理コマンドの機能一覧

サーバ管理コマンドの系統

サーバ管理コマンドの系統

サーバ管理コマンドの実行の前提条件

サーバ管理コマンドの排他制御

サーバ管理コマンドの排他制御

サーバ管理コマンドの排他制御の強制解除

サーブレット属性設定ページ

サーブレット属性のツリー

サーブレットとJSP（WAR）のインポート

サーブレットとJSPのエラー通知の設定

サーブレットとJSPのエラー通知の設定

サーブレットとJSPの起動順序の設定

サーブレットとJSPの起動順序の設定

サーブレットとJSPの実行時属性の定義

サーブレットとJSPの実行時属性の定義

サーブレットとJSPのセキュリティアイデンティティ

サーブレットとJSPのセキュリティロールリファレンスの定義

サーブレットとJSPのプロパティ設定項目

サーブレットとJSPのマッピング定義

サーブレットとJSPのマッピング定義

サーブレットとJSPのリファレンス定義

サーブレットとJSPのリファレンス定義

サーブレットの一覧ページ

サーブレットのプロパティページ

削除（サーバー・エクスプローラーの操作）

参照系コマンド

参照ライブラリ

(し)

実行時情報

実行時情報付きファイル

実行時情報を含めて，J2EEアプリケーションをエクスポートする場合

実行時情報を含めないで，J2EEアプリケーションをエクスポートする場合

実行待ちリクエスト数の監視のプロパティページ

シャットダウンコマンドを使用する場合の制御

障害発生時のCMR用の表の回復

新規作成したJ2EEアプリケーションをテストモードで実行する

(す)

ステータスアイコン

スレッド数制御のプロパティページ

(せ)

セキュリティアイデンティティの設定

セキュリティの定義（セキュリティアイデンティティ）

セキュリティの定義（メソッドパーミッション）

セキュリティのプロパティページ

セキュリティロールの設定

セキュリティロールのリファレンス定義

セッションの設定のプロパティページ

接続テスト（サーバー・エクスプローラーの操作）

(そ)

ソースページ

ソースページ

属性ファイルによるプロパティの設定

属性ファイルの保管

属性ファイル編集エディタ

属性ファイル編集エディタ

属性ファイル編集エディタによるJ2EEアプリケーションのプロパティ設定操作

属性ファイル編集エディタのエラー表示

そのほかのリソースと接続するための設定

そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）

(タ行)

(た)

タグライブラリの一覧ページ

タグライブラリのプロパティページ

単一プライマリキーの場合の属性設定

(つ)

ツリー（エレメント）

ツリービュー

ツリービューに表示されるノードと実行できる操作

(て)

停止（サーバー・エクスプローラーの操作）

停止中のJ2EEサーバでのトランザクション情報の表示

データベースと接続するための設定

データベースと接続するための設定

データベースと接続するための設定（コネクションプールのクラスタ化の場合）

データベースと接続するための設定（コネクションプールのクラスタ化の場合）

テストモードによるJ2EEアプリケーションの実行

デフォルトの文字エンコーディングの設定

デフォルトの文字エンコーディングの設定

展開ディレクトリ形式のJ2EEアプリケーションのインポート

展開ディレクトリ形式のJ2EEアプリケーションのインポート

展開ディレクトリ形式のJ2EEアプリケーションのインポート（サーバー・エクスプローラーの操作）

(と)

特権系コマンド

特権系コマンドを使用する場合の制御

ドメイン単位の論理サーバの一括起動

ドメイン単位の論理サーバの一括停止

トランザクション一覧の参照

トランザクション管理の動作

トランザクション属性

トランザクション属性の定義

トランザクション属性の定義

トランザクションの管理方法

(ハ行)

(は)

パラメタの一覧ページ

パラメタのデータ型プロパティページ

パラメタのプロパティページ

(ひ)

ビューツールバー

ビューツールバー

ビューツールバーでできる操作

ビュープルダウンメニュー

ビュープルダウンメニュー

ビュープルダウンメニューでできる操作

表示の更新（サーバー・エクスプローラーの操作）

(ふ)

フィルタ属性設定ページ

フィルタ属性のツリー

フィルタの一覧ページ

フィルタの削除

フィルタの設定

フィルタの設定

フィルタの追加

フィルタの追加と削除

フィルタのプロパティページ

フィルタのマッピング

フィルタのマッピング定義

フィルタマッピング（URLパターン）のプロパティページ

フィルタマッピング（サーブレット名）のプロパティページ

フィルタマッピングの一覧ページ

フォームページ

フォームページ

複合プライマリキーの場合の属性設定

フッタにインクルードするファイルの一覧ページ

フッタにインクルードするファイルのプロパティページ

プログレスダイアログ

プロバイダURL

プロパティの設定（サーバー・エクスプローラーの操作）

プロパティの設定操作（Server Plug-in）

(へ)

ヘッダにインクルードするファイルの一覧ページ

ヘッダにインクルードするファイルのプロパティページ

別名

編集エリア（エレメント詳細）

(ほ)

ほかのEnterprise Beanのリファレンス定義

ほかのEnterprise Beanのリファレンス定義

ホスト単位の論理サーバの一括起動

ホスト単位の論理サーバの一括停止

(マ行)

(み)

右クリックで表示されるコンテキストメニューでできる操作

(め)

メールコンフィグレーションのコピー

メールコンフィグレーションの削除

メールコンフィグレーションの新規作成

メールコンフィグレーションの接続テスト

メールコンフィグレーションのプロパティ定義

メールコンフィグレーションのリファレンス定義

メールコンフィグレーションのリファレンス定義

メソッドの一覧ページ

メソッドのプロパティページ

メソッドパーミッションの設定方法

メソッドパラメタの一覧ページ

メッセージ参照のプロパティページ

メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

メッセージリスナのアクティブ化に必要なプロパティ名の一覧の参照（Inboundリソースアダプタ）

メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）

メンバコネクションプール

メンバコネクションプールの情報の参照

メンバリソースアダプタ用DB Connectorの一般情報

メンバリソースアダプタ用DB Connectorの設定

メンバリソースアダプタ用コンフィグレーションプロパティ

メンバリソースアダプタ用のDB Connectorのインポート

メンバリソースアダプタ用のDB Connectorの開始

メンバリソースアダプタ用のDB Connectorの接続テスト

メンバリソースアダプタ用のDB Connectorの停止

メンバリソースアダプタ用のDB Connectorのデプロイ

メンバリソースアダプタ用のDB Connectorのプロパティ定義

(ヤ行)

(ゆ)

ユーザ指定名前空間機能

ユーザ指定名前空間機能

ユーザ指定名前空間機能

ユーザの設定

(ラ行)

(ら)

ライブラリJAR

ライブラリJARファイルの一覧の参照

ランタイムのプロパティページ

ランタイムのプロパティページ

ランタイムのプロパティページ

(り)

リスナの一覧ページ

リスナのプロパティページ

リソースアダプタ（Connector）のインポート（サーバー・エクスプローラーの操作）

リソースアダプタの一覧の参照

リソースアダプタの一覧の参照

リソースアダプタの一覧の参照

リソースアダプタの一般情報

リソースアダプタのインポート（サーバー・エクスプローラーの操作）

リソースアダプタのインポート（そのほかのリソースと接続するための設定）

リソースアダプタのコピー

リソースアダプタの削除

リソースアダプタの削除

リソースアダプタの状態表示

リソースアダプタの接続テスト

リソースアダプタの属性編集画面

リソースアダプタのデプロイ

リソースアダプタのデプロイ

リソースアダプタのデプロイ（サーバー・エクスプローラーの操作）

リソースアダプタのデプロイ（そのほかのリソースと接続するための設定）

リソースアダプタのプロパティ定義

リソースアダプタのプロパティページ

リソースアダプタのリファレンス定義

リソースアダプタのリファレンス定義

リソースアダプタのリファレンス定義

リソースアダプタリファレンス定義

リソースアダプタを含むJ2EEアプリケーションのインポート

リソースアダプタを含むJ2EEアプリケーションの開始と停止

リソース外部プロパティの一覧ページ

リソース外部プロパティのプロパティページ

リソース環境のリファレンス定義

リソース環境のリファレンス定義

リソース環境のリファレンス定義

リソース環境変数の一覧ページ

リソース環境変数の一覧ページ（WAR属性）

リソース環境変数のプロパティページ（EJB-JAR属性）

リソース環境変数のプロパティページ（WAR属性）

リソース環境リファレンス定義

リソース参照の一覧ページ

リソース参照の一覧ページ（WAR属性）

リソース参照の自動解決

リソース参照のプロパティページ（EJB-JAR属性）

リソース参照のプロパティページ（WAR属性）

リデプロイコマンド

リモートEJBへの参照の一覧ページ

リモートEJBへの参照の一覧ページ（WAR属性）

リモートEJBへの参照のプロパティページ（EJB-JAR属性）

リモートEJBへの参照のプロパティページ（WAR属性）

リモートインタフェースのEnterprise Beanのリファレンス定義

リモート管理機能に接続するための環境設定

リモート管理機能の接続先の状態表示

リロード（サーバー・エクスプローラーの操作）

リロードコマンド

リンク先キューのプロパティページ

リンク先キューのプロパティページ（WAR属性）

リンク先の管理対象オブジェクトのプロパティページ（WAR属性）

(る)

ルートコンテキスト

ルートリソースアダプタ用DB Connectorの設定

ルートリソースアダプタ用のDB Connectorのインポート

ルートリソースアダプタ用のDB Connectorの開始

ルートリソースアダプタ用のDB Connectorの接続テスト

ルートリソースアダプタ用のDB Connectorの停止

ルートリソースアダプタ用のDB Connectorのデプロイ

ルートリソースアダプタ用のDB Connectorのプロパティ定義

(ろ)

ローカルEJBへの参照の一覧ページ

ローカルEJBへの参照の一覧ページ（WAR属性）

ローカルEJBへの参照のプロパティページ（EJB-JAR属性）

ローカルEJBへの参照のプロパティページ（WAR属性）

ローカルインタフェースのEnterprise Beanのリファレンス定義

ロールにユーザを登録

ロールの設定

ロールの登録

ログインの設定のプロパティページ

ロケールエンコーディングマッピングの一覧ページ

ロケールエンコーディングマッピングのプロパティページ

論理J2EEサーバの開始オプションの設定（サーバー・エクスプローラーの操作）

論理J2EEサーバの強制停止

論理サーバの稼働状況表示

論理サーバの起動

論理サーバの状態表示

論理サーバの通常起動

論理サーバの通常停止

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
GIFは，米国CompuServe Inc.のサービス名称です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
J2EEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDBCは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JSPは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JSTLは，The Jakarta Projectのタグライブラリ名称です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model　Driven　Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle8iは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle9iは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 11gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
SQL Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Sunは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Sun Microsystemsは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).