Cosminexus V11 アプリケーションサーバ アプリケーション設定操作ガイド

操作書

3021-3-J13-60

前書き

対象製品

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

輸出時の注意

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

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

商標類

HITACHI，Cosminexus，HiRDB，OpenTP1，TPBroker，uCosminexus，XDMは，株式会社 日立製作所の商標または登録商標です。

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

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

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

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

Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。

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

発行

2024年 9月　3021-3-J13-60

著作権

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

変更内容

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

追加・変更内容 | 変更個所
記載内容は変更なし（リンク情報だけを変更した）。 | -

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

はじめに

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

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

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

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

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

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

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

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

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

[picture]

アプリケーション設定操作はサーバ管理コマンドを使用して実行します。サーバ管理コマンドについては，「2.1　サーバ管理コマンドの機能」を参照してください。

1.2　J2EEリソースの管理

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

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

アプリケーション設定操作で管理する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 | ○ | ×
クラスタ構成 | ○ | ×
TP1 Connector | トランザクションサポートレベル | NoTransaction またはLocalTransaction | ○ | ○
XATransaction | ○ | ×
TP1/Message Queue - Access | ○ | ×
DB Connector for Reliable MessagingおよびReliable Messaging | ○ | ×
そのほかのリソースアダプタ | ○ | ○※

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

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

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

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

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

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

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

JavaBeansリソース

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

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

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

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

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

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

DB Connector

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

DB Connector for Reliable MessagingおよびReliable Messaging

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

DB Connector for Reliable Messagingについては，マニュアル「Reliable Messaging」の「2.7　DB Connector for Reliable Messagingの機能」を参照してください。Reliable Messagingの管理については，マニュアル「Reliable Messaging」の「2.3　メッセージの管理」を参照してください。

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
リソースアダプタのコネクションプールのコネクションを削除します。 | cjclearpool
リソースアダプタの属性をコピーします。 | cjcopyres（-type rar指定）

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

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

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

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

DB Connector

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

グローバルトランザクションおよびクラスタ構成の場合は利用できません。

TP1 Connector

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

グローバルトランザクションの場合は利用できません。

そのほかのリソースアダプタ（Connector 1.5に準拠したリソースアダプタ）

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

J2EEアプリケーションに含めて利用できるリソースアダプタの種類については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「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 ［アプリケーション名］指定）

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

リソースアダプタ以外の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アプリケーション

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

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

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

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

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

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

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

J2EEアプリケーションの形式の詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.　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アプリケーションを入れ替えます。※ | 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アプリケーション」を参照してください。

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

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

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

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

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

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

J2EEサーバへのアクセス権の設定

操作対象のJ2EEサーバへのアクセス権限が必要です。J2EEサーバへのアクセス権を設定するには，J2EEサーバ用のusrconf.propertiesファイルで，webserver.connector.http.permitted.hostsキーを定義します。J2EEサーバ用のusrconf.propertiesファイルの詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

J2EEサーバに対するアクセス権限を持っていないときには，エラーメッセージが出力され，アプリケーション設定操作は実行できません。

ネットワークの設定

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

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

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アプリケーションの入れ替え（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　アプリケーション設定操作で使用するインタフェース

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

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

アプリケーション設定操作では，インタフェースとしてサーバ管理コマンドを提供しています。サーバ管理コマンドは，J2EEサーバで動作するリソースやJ2EEアプリケーションを設定，および管理するためのコマンド群です。

アプリケーション設定操作で使用するサーバ管理コマンドの機能を次の表に示します。

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

機能 | 参照先
リソースアダプタの設定 | データベースと接続するための設定 | 4.2
そのほかのリソースアダプタと接続するための設定 | 4.3
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アプリケーションの入れ替え※2 | 10.5
J2EEアプリケーション名の変更 | 10.6
RMI-IIOPスタブとインタフェースの取得 | 10.7
トランザクション一覧の参照 | 10.8

注※1

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

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

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

注※2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

参照系コマンド

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

更新系コマンド

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

特権系コマンド

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

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

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

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

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

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

（凡例）

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

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

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

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

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

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

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

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

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

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

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

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

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

注意

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

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

排他制御を強制解除する前に，サーバ管理コマンドが実際には実行中でないことを確認します。

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

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

実行形式

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

実行例

cjresetsv MyServer

3.3　サーバ管理コマンドの動作設定のカスタマイズ

ユーザ定義ファイルを編集すると，サーバ管理コマンドの動作設定をカスタマイズできます。必要に応じて，サーバ管理コマンドの動作設定をカスタマイズしてください。なお，UNIXの場合，カスタマイズにはroot権限，またはComponent Container管理者の権限が必要です。

次のディレクトリにあるコマンドがサーバ管理コマンドのコマンドになります。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin

UNIXの場合

/opt/Cosminexus/CC/admin/bin

コマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

3.3.1　カスタマイズ対象のユーザ定義ファイル

サーバ管理コマンドの動作設定をカスタマイズするには，次のユーザ定義ファイルをテキストエディタなどで編集します。

usrconf.properties（サーバ管理コマンド用システムプロパティファイル）

サーバ管理コマンドのプロパティを指定するファイルです。

ファイルの格納場所を次に示します。

Windowsの場合

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

UNIXの場合

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

詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.2.3　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）」を参照してください。

usrconf.bat（サーバ管理コマンド用オプション定義ファイル）

Windowsの場合にサーバ管理コマンドのJavaVMの起動オプションを指定するファイルです。

ファイルの格納場所を次に示します。

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

詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.2.2　usrconf.bat（サーバ管理コマンド用オプション定義ファイル）」を参照してください。

usrconf（サーバ管理コマンド用オプション定義ファイル）

UNIXの場合にサーバ管理コマンドのJavaVMの起動オプションを指定するファイルです。

ファイルの格納場所を次に示します。

/opt/Cosminexus/CC/admin/usrconf/usrconf

詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.2.1　usrconf（サーバ管理コマンド用オプション定義ファイル）」を参照してください。

3.3.2　サーバ管理コマンドのカスタマイズで設定できる主な項目

サーバ管理コマンドのカスタマイズでユーザ定義ファイルを編集して設定できる項目のうち，主な項目とその項目を設定するユーザ定義ファイルおよびキーを次の表に示します。キーの詳細，およびここで説明していないキーについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「5.　サーバ管理コマンドで使用するファイル」を参照してください。

表3‒2　サーバ管理コマンドのカスタマイズで設定できる主な項目

分類 | 項目 | 設定ファイル | 設定方法
JavaVM | JavaVMのヒープサイズ | usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合） | add.jvm.argキーに，JavaVMのヒープサイズを指定します。
ログ | TPBrokerのトレースファイル | usrconf.properties | vbroker.orb.htc.tracePathキーに，TPBrokerのトレースファイル出力先のパスを指定します。
サーバ管理コマンドのログ | usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合） usrconf.properties | サーバ管理コマンドのログは，ログの出力先，ログレベルを変更できます。 詳細は，「3.4　サーバ管理コマンドのログ取得の設定」を参照してください。

（凡例）−：該当しません。

注　ネーミング管理の機能を使用する場合にもサーバ管理コマンドのカスタマイズが必要です。詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3.5　実行環境での設定」を参照してください。

3.4　サーバ管理コマンドのログ取得の設定

サーバ管理コマンドのログは，ログの出力先，ログレベルを変更できます。変更できる項目と，項目に対応するユーザ定義ファイルとキーを次に示します。

項目 | 対応するユーザ定義ファイルとキー
ログの出力先 | usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプション
ログレベル | usrconf.propertiesのejbserver.logger.enabled.*キー

ファイルおよびキーの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.　サーバ管理コマンドで使用するファイル」を参照してください。

注意事項

サーバ管理コマンドのログ出力ディレクトリに必要なディスク容量は，ejbserver.cui.logfile.compatibleキーの指定値によって異なります。

指定値がtrueの場合

51,655KB＋TPBrokerのトレース情報

指定値がfalseの場合

18,624KB＋TPBrokerのトレース情報

TPBrokerのトレース情報を出力するために必要なディスク容量については，マニュアル「TPBroker 運用ガイド」のディスク占有量に関する説明を参照してください。

3.4.1　ログの出力先の変更

サーバ管理コマンドのログの出力先を変更する場合は，サーバ管理コマンド用のusrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）でログの出力先ディレクトリを指定します。

ログの出力先の変更

デフォルトのログ出力先を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs

UNIXの場合

/opt/Cosminexus/CC/admin/logs/

サーバ管理コマンドのログの出力先は，usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプションで変更できます。

設定例

Windowsの場合

set USRCONF_JVM_ARGS="-Dejbserver.log.directory=C:¥CClogs¥admin"

UNIXの場合

set USRCONF_JVM_ARGS="-Dejbserver.log.directory=/CClogs/admin"

カレントディレクトリ

ログ出力先を相対パスで指定する場合のカレントディレクトリは，サーバ管理コマンドを実行したときのカレントディレクトリです。

例えば，ユーザIDが「user1」でユーザのホームディレクトリが「C:¥Documents and Settings¥user1」の場合に，このユーザIDでログインすると，ログイン直後のカレントディレクトリは「C:¥Documents and Settings¥user1」になります。ここで，サーバ管理コマンドを実行すると，カレントディレクトリは「C:¥Documents and Settings¥user1」になります。

注意事項

JavaVMの保守情報およびGCのログの出力先は，ユーザ定義ファイルで設定しても，usrconf.cfgのadd.jvm.arg=-XX:HitachiJavaLog:<ログ出力先>に設定されている値が優先されます。JavaVMの保守情報およびGCのログの出力先を設定する場合は，注意してください。

Management Serverリモート管理機能から操作した場合，サーバ管理コマンドのログ出力先は変更できません。

3.4.2　ログレベルの変更

サーバ管理コマンドのログレベルは，ログの重要度を表します。ログレベルには，「Error」，「Warning」，「Information」，「Debug」の四つがあります。ログレベルを設定すると，設定したレベルのログが出力されます。デフォルトでは，Errorレベルのログだけが取得されます。通常はデフォルトのまま利用してください。

ログレベルは，サーバ管理コマンド用のusrconf.propertiesの次のキーで設定します。

ejbserver.logger.enabled.*=<レベル名>

レベル名には，「Error」，「Warning」，「Information」，「Debug」の文字列を一つ，または複数設定します。複数設定する場合には，レベル名の文字列の間をコンマ（,）で区切ります。

記述例

ejbserver.logger.enabled.*=Error

ejbserver.logger.enabled.*=Error,Warning

ejbserver.logger.enabled.*=Error,Warning,Information

ejbserver.logger.enabled.*=Error,Warning,Information,Debug

注意事項

記述例の1.，2.，3.，4.の順に，取得できるログの件数が増加していきます。複数のログレベルを設定してログを取得すると，性能が劣化し，ログファイルの面の切り替えが頻繁に起こるようになります。

レベル名に「Error」，「Warning」，「Information」，「Debug」以外の文字列，または空の値を設定した場合は，KDJE90009-Wのメッセージが出力されます。Errorレベルのログは取得されます。

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

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

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

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

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

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

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

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

属性ファイルを取得します。

デプロイする前のリソースアダプタの属性ファイルを取得する場合は，cjgetrespropコマンドを実行します。リソースアダプタをデプロイしたあとで，リソースアダプタの属性ファイルを取得する場合は，cjgetrarpropコマンドを実行します。

取得する属性ファイルは，Connector属性ファイルです。

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

プロパティ設定項目を編集します。

取得した属性ファイルをテキストエディタで編集します。属性ファイルの編集項目については，各プロパティの設定の説明を参照してください。

属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

属性を設定します。

デプロイする前のリソースアダプタのプロパティを設定する場合は，cjsetrespropコマンドを実行します。デプロイしているリソースアダプタのプロパティを設定する場合は，cjsetrarpropコマンドを実行します。

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

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

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

属性ファイルを取得します。

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

取得する属性ファイルは，次のとおりです。

JavaBeansリソースの場合

JavaBeansリソース属性ファイル

メールコンフィグレーションの場合

メール属性ファイル

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

プロパティ設定項目を編集します。

取得した属性ファイルをテキストエディタで編集します。属性ファイルの編集項目については，各プロパティの設定の説明を参照してください。

属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「2.2.9　Connector属性の詳細」を参照してください。

属性を設定します。

JavaBeansリソースのプロパティを設定する場合は，cjsetjbpropコマンドを実行します。メールコンフィグレーションのプロパティを設定する場合は，cjsetrespropコマンドを実行します。

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

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

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

属性ファイルを取得します。

アプリケーション属性，およびJ2EEアプリケーションを構成するコンポーネント（サーブレット・JSP，Enterprise Bean，リソースアダプタ）属性の属性ファイルを取得するため，cjgetapppropコマンドを実行します。

取得する属性ファイルは，プロパティを設定する対象となるコンポーネントに応じて異なります。また，そのアプリケーションのコンポーネントの属性情報を一括して編集する場合は，アプリケーション統合属性ファイルを取得します。

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

プロパティ設定項目を編集します。

取得した属性ファイルをテキストエディタで編集します。属性ファイルの編集項目については，各プロパティの設定の説明を参照してください。

属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.　J2EEアプリケーションの設定で使用する属性ファイル」を参照してください。

属性を設定します。

アプリケーション属性，およびJ2EEアプリケーションを構成するコンポーネント（サーブレット・JSP，Enterprise Bean，リソースアダプタ）属性の属性ファイルを設定するため，cjsetapppropコマンドを実行します。

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

参考

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

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

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

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

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

Windowsの場合

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

UNIXの場合

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

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

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

Windowsの場合

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

UNIXの場合

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

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

Windowsの場合

＜Application Serverのインストールディレクトリ＞¥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.7　このマニュアルでのサーバ管理コマンドの記載方法

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

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

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

コマンドの格納先は次のとおりです。

Windowsの場合

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

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

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

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

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

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

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

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

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

J2EEリソースアダプタとして，デプロイして利用できるリソースアダプタを次に示します。

DB Connector

DB Connector for Reliable MessagingおよびReliable Messaging

TP1 Connector

TP1/Message Queue - Access

そのほかのConnector 1.0に準拠したリソースアダプタ，またはConnector 1.5に準拠したリソースアダプタ※

注※　そのほかのConnector 1.0に準拠したリソースアダプタ，またはConnector 1.5に準拠したリソースアダプタについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.3.2　リソースアダプタの種類」を参照してください。

注意事項

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

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

次のリソースアダプタの設定でのアプリケーション設定操作の概要を示します。

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

そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）

リソースアダプタ共通の設定

データベース上のキューと接続するための設定については，マニュアル「Reliable Messaging」を参照してください。

(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)　そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）

リソースアダプタを使用してOpenTP1などの各種リソースに接続する場合に必要な作業です。

表4‒2　そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）の概要

設定項目 | 内容 | 参照先
リソースアダプタのインポート | リソースアダプタ（RARファイル）をインポートして，J2EEサーバから使用できるリソースに追加します。 | 4.3.1

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

リソースとの接続についての次の情報を設定します。

リソースアダプタの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

4.3.2または4.3.3

リソースアダプタのデプロイ | インポートしたリソースアダプタを基にリソースアダプタをデプロイします。 リソースアダプタは，デプロイするとJ2EEリソースアダプタとして利用できます。 | 4.3.4
J2EEリソースアダプタの接続テスト | リソースアダプタに設定した内容が正しいかどうかを検証します。 | 4.3.5
J2EEリソースアダプタの開始 | J2EEリソースアダプタを開始します。 | 4.3.6
J2EEリソースアダプタの停止 | J2EEリソースアダプタを停止します。 | 4.3.7
J2EEリソースアダプタのアンデプロイ | J2EEリソースアダプタを削除します。 リソースアダプタを入れ替えする場合に，必要に応じて実行してください。 | 4.3.8
J2EEリソースアダプタのエクスポート | J2EEリソースアダプタをRARファイルとしてエクスポートします。 必要に応じて実行してください。 | 4.3.9

(3)　リソースアダプタ共通の設定

リソースアダプタに共通の設定です。

表4‒3　リソースアダプタに共通な設定の概要

設定項目 | 内容 | 参照先
J2EEリソースアダプタの状態と一覧の表示 | デプロイされているJ2EEリソースアダプタの状態，コネクション定義識別子の一覧などを参照します。 | 4.4
リソースアダプタの一覧の参照 | インポートされているリソースアダプタの一覧，コネクション定義識別子の一覧などを参照します。 | 4.5
コネクションプールの状態の確認 | リソースアダプタのコネクションプールの状態を参照します。また，必要に応じてコネクションプール内のコネクションを削除します。 | 4.6
JNDI名前空間に登録されるリソースアダプタ名の参照と変更 | リソースアダプタのJNDI名前空間への登録名を参照して，必要に応じて別名を付与します。 | 4.7
リソースアダプタの削除 | リソースアダプタを削除します。 | 4.8
リソースアダプタのコピー | リソースアダプタをほかのフォルダなどにコピーできます。 | 4.9

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

データベースと接続するために，DB Connectorの設定をします。DB Connectorはデータベースと接続するためのリソースアダプタです。

ここで説明するDB Connectorを使用したデータベースへの接続とは，JDBCインタフェースを使用してデータベースのテーブルだけにアクセスすることです。

JMSインタフェースを使用してキューにアクセスする場合は，DB Connector for Reliable MessagingおよびReliable Messagingを使用してデータベースに接続します。詳細は，マニュアル「Reliable Messaging」を参照してください。

DB Connectorの設定をするには，あらかじめ使用するデータベースの環境を設定しておいてください。また，使用するDB Connectorの種類に応じて，HiRDB Type4 JDBC Driver，Oracle JDBC Thin Driver，SQL Server JDBC Driver，MySQL Connector/J，またはPostgreSQL JDBC Driverの設定も必要です。

DB Connectorの設定は次の手順で実施します。

DB Connectorをインポートします。

プロパティを定義します。

DB Connectorをデプロイします。

デプロイとは，DB ConnectorをJ2EEサーバに共有スタンドアロンモジュール（J2EEリソースアダプタ）として配備することです。

接続を確認します。

正しく接続できるかどうかは，接続テストによって確認できます。

デプロイしたDB Connectorは，J2EEアプリケーションのプロパティ設定で，リソースアダプタのリファレンスを解決する必要があります。詳細については，「9.3.3　リソースアダプタのリファレンス定義」を参照してください。

参考

DB Connectorのプロパティを新規に設定する場合，Component Containerが提供しているテンプレートファイルが利用できます。

Connector属性ファイルのテンプレートファイルは，次に示すディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥templates¥

UNIXの場合

/opt/Cosminexus/CC/admin/templates/

このテンプレートファイルを使用すると，DB Connectorをインポートする前に，Connector属性ファイルを編集しておくことができます。テンプレートファイルはコピーして使用してください。

Connector属性ファイルのテンプレートファイル名については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.13　Connector属性ファイルのテンプレートファイル」を参照してください。

なお，すでにプロパティが設定されているDB Connectorのプロパティを変更する場合は，テンプレートファイルは使用しないでください。インポートしたDB ConnectorのConnector属性を取得して，Connector属性ファイルを編集してください。

4.2.1　DB Connectorのインポート

次に示すコマンドを実行してDB Connectorをインポートします。

(1)　実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -f ＜ファイルパス＞

＜ファイルパス＞には，RARファイルを指定してください。

RARファイルは，次のディレクトリに格納されています。

Windowsの場合

＜Application Serverのインストールディレクトリ＞¥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_MySQL_CP.rar

MySQL Connector/J用のDB Connectorです。ローカルトランザクションを使用する場合，またはトランザクション管理なしで使用する場合（トランザクションのサポートレベルにLocalTransactionまたはNoTransactionを指定する場合）に選択します。

MySQL Connector/JのConnectionPoolDataSourceを使用してMySQLに接続します。

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_PostgreSQL_CP.rar

PostgreSQL JDBC Driver用のDB Connectorです。ローカルトランザクションを使用する場合，またはトランザクション管理なしで使用する場合（トランザクションのサポートレベルにLocalTransactionまたはNoTransactionを指定する場合）に選択します。

PostgreSQL JDBC DriverのConnectionPoolDataSourceを使用してPostgreSQLに接続します。

DBConnector_SQLServer_CP.rar

SQL Server JDBC Driver用のDB Connectorです。ローカルトランザクションを使用する場合，またはトランザクション管理なしで使用する場合（トランザクションサポートレベルにNoTransactionまたはLocalTransactionを指定する場合）に選択します。

SQL Server JDBC DriverのConnectionPoolDataSourceを使用して，SQL Serverに接続します。

(2)　実行例

cjimportres MyServer -type rar -f DBConnector_HiRDB_Type4_CP.rar

cjimportresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

4.2.2　DB Connectorのプロパティ定義

DB Connectorのプロパティを定義します。DB Connectorをデプロイしたあとでも実行できます。なお，デプロイ済みのDB Connectorのプロパティを変更する場合は，該当するDB Connectorを停止した状態で実行してください。

プロパティの設定手順については，「3.5　属性ファイルによるプロパティの設定」を参照してください。次にDB Connectorのプロパティ定義について説明します。

(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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンスコマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。cjsetrarpropコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjsetrarprop（RAR属性設定）」を参照してください。

(3)　編集する属性設定項目

DB Connectorのプロパティ設定項目を次に示します。

DB Connectorの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

(a)　DB Connectorの一般情報

設定できるDB Connectorの一般情報属性（<outbound-resourceadapter>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
トランザクションサポートのレベル | ○ | <transaction-support>
再認証のサポート有無 | ○ | <reauthentication-support>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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>タグに設定できるプロパティについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.10　DB Connectorに設定する<config-property>タグに指定できるプロパティ」を参照してください。

なお，<config-property-name>タグに「XAOpenString」および「trustStorePassword」が設定されている場合，cjgetrespropコマンドを実行すると，コンフィグレーションプロパティの値（<config-property-value>）は次のように表示されます。

プロパティの値が設定されている場合

コンフィグレーションプロパティの値（<config-property-value>）は取得されないで，「<!-- The config-property-value has already been set. -->」と表示されます。

「XAOpenString」および「trustStorePassword」の値を変更する場合には，<config-property-value>タグを追加して，変更後の値を設定してください。

プロパティの値が設定されていない場合

空タグ（<config-property-value></config-property-value>）が表示されます。

「XAOpenString」および「trustStorePassword」の値を設定する場合には，<config-property-value>タグに値を追加してください。

ステートメントプーリング機能を使用する場合の，ステートメントプーリングの動作，および注意事項については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「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>タグに値を追加してください。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

コネクションプーリング機能を使用する場合のコネクションプールの動作，および注意事項については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.1　コネクションプーリング」を参照してください。

(d)　別名情報

DB Connectorの別名情報（<outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <resource-external-property>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
リソースの別名 | ○ | <optional-name>
リソース認証方式 | △ | <res-auth>
リソース共有の有無 | △ | <res-sharing-scope>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

DB Connectorの別名の使用法については，「4.7　JNDI名前空間に登録されるリソースアダプタ名の参照と変更」を参照してください。

(4)　コンフィグレーションプロパティの設定例

次のDB Connectorについて，コンフィグレーションプロパティの設定例を示します。

DBConnector_HiRDB_Type4_CP.rarで，HiRDB，またはXDM/RD E2を使用する場合

DBConnector_HiRDB_Type4_XA.rarで，HiRDBを使用する場合

DBConnector_MySQL_CP.rarで，MySQLを使用する場合

DBConnector_Oracle_CP.rarで，Oracleを使用する場合

DBConnector_Oracle_XA.rarで，Oracleを使用する場合

DBConnector_PostgreSQL_CP.rarで，PostgreSQLを使用する場合

DBConnector_SQLServer_CP.rarで，SQL Serverを使用する場合

(a)　DBConnector_HiRDB_Type4_CP.rarで，HiRDBまたはXDM/RD E2を使用する場合

DBConnector_HiRDB_Type4_CP.rarで，HiRDBまたはXDM/RD E2を使用する場合の，コンフィグレーションプロパティの設定例を次の表に示します。

表4‒4　データベースとして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‒5　データベースとして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の環境変数グループの設定ファイルのパスを指定します。詳細については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.6　データベース接続環境を設定する（HiRDBの設定）」を参照してください。

(c)　DBConnector_MySQL_CP.rarで，MySQLを使用する場合

DBConnector_MySQL_CP.rarで，MySQLを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表4‒6　データベースとしてMySQLを使用する場合

項目名 | MySQLの場合の設定例
databaseName | ＜MySQLのデータベース名＞
serverName | ＜MySQLのホスト名またはIPアドレス＞
portNumber | 3306
CancelStatement | true
logLevel | ERROR

(d)　DBConnector_Oracle_CP.rarで，Oracleを使用する場合

DBConnector_Oracle_CP.rarで，Oracleを使用する場合の，コンフィグレーションプロパティの設定例を次の表に示します。

表4‒7　データベースとしてOracleを使用する場合のコンフィグレーションプロパティの設定例（DBConnector_Oracle_CP.rarの場合）

項目名 | urlで設定しない場合の例 | urlで設定する場合の例
databaseName | ＜Oracle SID＞ | −
serverName | ＜Oracleのホスト名称，またはIPアドレス＞ | −
portNumber | 1521 | −
url | − | jdbc:oracle:thin:@//＜Oracleのホスト名称，またはIPアドレス＞:1521/＜Oracle SID＞
loginTimeout | 8000
PreparedStatementPoolSize | 10
CallableStatementPoolSize | 10
CancelStatement | true
ConnectionIDUpdate | false
logLevel | ERROR

（凡例）　−：設定は不要

(e)　DBConnector_Oracle_XA.rarで，Oracleを使用する場合

DBConnector_Oracle_XA.rarで，Oracleを使用する場合の，コンフィグレーションプロパティの設定例を次の表に示します。

表4‒8　データベースとしてOracleを使用する場合のコンフィグレーションプロパティの設定例（DBConnector_Oracle_XA.rarの場合）

項目名 | urlで設定しない場合の例 | urlで設定する場合の例
databaseName | ＜Oracle SID＞ | −
serverName | ＜Oracleのホスト名称，またはIPアドレス＞ | −
portNumber | 1521 | −
url | − | jdbc:oracle:thin:@//＜Oracleのホスト名称，またはIPアドレス＞:1521/＜Oracle SID＞
loginTimeout | 8000
sessionTimeout | 300
PreparedStatementPoolSize | 10
CallableStatementPoolSize | 10
CancelStatement | true
ConnectionIDUpdate | false
logLevel | ERROR

（凡例）　−：設定は不要

(f)　DBConnector_PostgreSQL_CP.rarで，PostgreSQLを使用する場合

DBConnector_PostgreSQL_CP.rarで，PostgreSQLを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表4‒9　データベースとしてPostgreSQLを使用する場合

項目名 | PostgreSQLの場合の設定例
databaseName | ＜PostgreSQLのデータベース名＞
serverName | ＜PostgreSQLのホスト名またはIPアドレス＞
portNumber | 5432
PreparedStatementPoolSize | 10
CallableStatementPoolSize | 10
CancelStatement | true
logLevel | ERROR

(g)　DBConnector_SQLServer_CP.rarで，SQL Serverを使用する場合

DBConnector_SQLServer_CP.rarで，SQL Serverを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表4‒10　データベースとしてSQL Serverを使用する場合

項目名 | SQL Serverの場合の設定例
databaseName | ＜SQL Serverのデータベース名＞
serverName | ＜SQL Serverのホスト名またはIPアドレス＞
applicationName | ＜SQL Serverに接続するアプリケーション名＞
instanceName | ＜接続するSQL Serverのインスタンス名＞
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
applicationIntent | ReadWrite
multiSubnetFailover | false
encrypt | false
hostNameInCertificate | ＜SQL ServerのTLS/SSL証明書の検証に使われるホスト名＞
sslProtocol | TLS
trustServerCertificate | false
trustStore | ＜trustStoreファイルへのパス名＞
trustStorePassword | ＜trustStoreデータの整合性を確認するために使用するパスワード＞

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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjexportrar（リソースアダプタのエクスポート）」を参照してください。

注意事項

Management Serverを利用して運用している場合，サーバ管理コマンドとManagement Serverの実行ホストが異なるときは，DB Connectorをエクスポートして，Management Serverの実行ホストに格納する必要があります。

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

OpenTP1などのリソースとの接続には，リソースアダプタを使用します。ここでは，DB Connector，DB Connector for Reliable Messaging，およびReliable Messaging以外のリソースアダプタと接続するための基本的な設定について説明します。

リソースアダプタは，次の手順で設定します。

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

プロパティを定義します。

リソースアダプタをデプロイします。

リソースアダプタのデプロイとは，リソースアダプタをJ2EEサーバに共有スタンドアロンモジュール（J2EEリソースアダプタ）として配備することです。

接続を確認します。

正しく接続できるかどうかは，接続テストによって確認できます。

デプロイをしたJ2EEリソースアダプタは，J2EEアプリケーションのプロパティ設定で，リソースアダプタのリファレンスを解決する必要があります。詳細については，「9.3.3　リソースアダプタのリファレンス定義」を参照してください。

ポイント

そのほかのリソースと接続するリソースアダプタとして，次のリソースアダプタを使用できます。

Connector 1.0に準拠するリソースアダプタ

Connector 1.5に準拠するリソースアダプタ

Connector 1.0の仕様に準拠するリソースアダプタのプロパティの定義については，「4.3.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」を，Connector 1.5の仕様に準拠するリソースアダプタのプロパティの定義については，「4.3.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」を参照してください。

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

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

なお，アプリケーションサーバで提供されていない独自のリソースアダプタをインポートする場合は，注意事項に記載されている内容に従ってインポートしてください。

次に示すコマンドを実行してリソースアダプタをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -f ＜ファイルパス＞

実行例

cjimportres MyServer -type rar -f mqcadpt.rar

cjimportresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

注意事項

Connector 1.0以降の仕様に準拠しないDDを持つRARはインポートできません。インポートできるのは，Connector 1.0以降の仕様に準拠したDDを持つRARだけです。DDがDTDに従っていることを確認してから，インポートを実行してください。

インポート手順を次に示します。

図4‒1　リソースアダプタ（RAR）のインポート手順

[picture]

注※1

DDは検証済みXML文書として扱われます。このため，DD中のDOCTYPE宣言が誤っていた場合，またはDDがDTDの仕様に従っていない場合はエラーになります。

注※2

J2EE Connectorの仕様に従った値がDDに指定されていない場合はエラーとなります。詳細は，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.26　DB Connectorを設定する（CUI利用時）」を参照してください。

また，メッセージが出力された場合は，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照して対処ください。

インポート時に指定したRARファイル名は作業ディレクトリ中のディレクトリ名として使用されます。また，RARファイル内のJARファイルやネイティブライブラリは作業ディレクトリ内に展開されます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにRARファイル名およびRARファイル中のファイル名を指定してください。J2EEアプリケーションを実行するシステムの場合の作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。バッチアプリケーションを実行するシステムの場合の作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.2　バッチサーバの作業ディレクトリ」を参照してください。

ra.xmlのdisplay-nameタグが設定されていない場合，RARファイル名を基にDisplay nameが付与されます。

RARファイルには，次の名称のファイルを含めないでください。

rar.properties

fileinfo.properties

META-INF/hitachi-ra.xml

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

Connector 1.0の仕様に準拠するリソースアダプタのプロパティを定義します。リソースアダプタのプロパティ定義は，J2EEリソースアダプタをデプロイしたあとでも実行できます。なお，設定済みのリソースアダプタのプロパティを変更する場合は，該当するリソースアダプタを停止した状態で実行してください。

プロパティの設定手順の概要については，「3.5　属性ファイルによるプロパティの設定」を参照してください。次にリソースアダプタのプロパティ定義について説明します。

(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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンスコマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。cjsetrarpropコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjsetrarprop（RAR属性設定）」を参照してください。

(3)　編集する属性設定項目

リソースアダプタのプロパティ設定項目を次に示します。

リソースアダプタの一般情報

コンフィグレーションプロパティ

実行時プロパティ

別名情報

(a)　リソースアダプタの一般情報

リソースアダプタの一般情報（<outbound-resourceadapter>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
トランザクションサポートのレベル | ○ | <transaction-support>
再認証のサポート有無 | ○ | <reauthentication-support>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

リソースアダプタの別名の使用法については，「4.7　JNDI名前空間に登録されるリソースアダプタ名の参照と変更」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタに接続する場合のプロパティを定義します。

リソースアダプタのプロパティ定義は，J2EEリソースアダプタをデプロイしたあとでも実行できます。なお，リソースアダプタの設定済みのプロパティを変更する場合は，該当するリソースアダプタを停止した状態で実行してください。

プロパティの設定手順の概要については，「3.5　属性ファイルによるプロパティの設定」を参照してください。次にリソースアダプタのプロパティ定義について説明します。

(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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンスコマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。cjsetrarpropコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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>タグ）の設定項目を次に示します。

項目 | 必須 | 対応するタグ
コネクション単位でのプロパティ設定※ | △ | <connection-definition>
トランザクションサポートのレベル | ○ | <transaction-support>
再認証のサポート有無 | ○ | <reauthentication-support>

（凡例）　○：必須　△：任意

注※　Outboundリソースアダプタのコネクション単位のプロパティ設定については，「(5)　Outboundリソースアダプタのコネクション単位のプロパティ設定」を参照してください。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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>）は無視されます。ライフサイクル管理機能については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(コンテナ共通機能)」の「3.16.1　リソースアダプタのライフサイクル管理」を参照してください。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

リソースアダプタの別名の使用方法については，「4.7　JNDI名前空間に登録されるリソースアダプタ名の参照と変更」を参照してください。

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

リソースアダプタは，デプロイするとJ2EEリソースアダプタとして使用できます。

サーバ管理コマンドでインポートしたリソースアダプタをデプロイすると，そのJ2EEサーバ上で動作するすべてのJ2EEアプリケーションから使用できるようになります。なお，リソースアダプタをデプロイしたあとで，リソースアダプタのプロパティを定義することもできます。プロパティを定義する方法については，リソースアダプタが対応しているコネクタアーキテクチャの仕様に応じて，「4.3.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」または「4.3.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」を参照してください。

次に示すコマンドを実行してリソースアダプタをデプロイします。

実行形式

cjdeployrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞ ［-resname ＜リソースアダプタの表示名＞］

実行例

cjdeployrar MyServer -resname Rar1

cjdeployrarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjdeployrar（リソースアダプタのデプロイ）」を参照してください。

注意事項

開始状態の実行時情報を含んだリソースアダプタを指定すると，デプロイ完了後に自動開始されます。自動開始処理に失敗した場合でも，このJ2EEリソースアダプタは削除されません。

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

リソースアダプタに設定した情報が正しいかどうか，接続テストによって検証します。

次に示すコマンドを実行してリソースアダプタの接続テストを実施します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜リソースアダプタの表示名＞ ［-resname ＜リソースアダプタの表示名＞］

実行例

cjtestres MyServer -type rar -resname Rar1

cjtestresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

注意事項

一度接続テストをしたリソースアダプタは，J2EEサーバを再起動するまで削除できません。リソースアダプタを削除する場合は，リソースアダプタを停止してから，J2EEサーバを再起動してください。

Connector 1.5の仕様に準拠するリソースアダプタにコネクション定義が複数ある場合，すべてのコネクション定義に対して接続テストが実行されます。コネクション定義のどれかでエラーが発生した場合でも，すべてのコネクション定義に対して接続テストが実行されます。ただし，その場合，接続テスト結果は「失敗」となります。

Connector 1.5の仕様に準拠するリソースアダプタの場合は，Outboundリソースアダプタを含むときだけ，接続テストを実施できます。

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

J2EEリソースアダプタを開始します。

次に示すコマンドを実行してJ2EEリソースアダプタを開始します。

実行形式

cjstartrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjstartrar MyServer -resname Rar1

cjstartrarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjstartrar（リソースアダプタの開始）」を参照してください。

注意事項

J2EEアプリケーション中のJ2EEリソースがJ2EEリソースアダプタを参照している場合は，J2EEリソースアダプタを開始してから，J2EEアプリケーションを開始してください。

一度開始したJ2EEリソースアダプタは，J2EEサーバを再起動するまで削除できません。J2EEリソースアダプタを削除するには，J2EEリソースアダプタを停止してから，J2EEサーバを再起動し，削除しようとするJ2EEリソースアダプタがJ2EEアプリケーションの参照解決の対象外であることを確認してください。

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

J2EEリソースアダプタを停止します。

次に示すコマンドを実行してJ2EEリソースアダプタを停止します。

実行形式

cjstoprar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjstoprar MyServer -resname Rar1

cjstoprarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjstoprar（リソースアダプタの停止）」を参照してください。

注意事項

J2EEアプリケーション中のJ2EEリソースがJ2EEリソースアダプタを参照している場合は，J2EEアプリケーションを停止してから，J2EEリソースアダプタを停止してください。

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

デプロイされているJ2EEリソースアダプタを削除します。

準備

J2EEリソースアダプタを削除する前に，J2EEリソースアダプタを停止してJ2EEサーバを再起動してください。また，J2EEリソースアダプタに対し，一度でも開始または接続テストを試みた場合も同様にJ2EEサーバを再起動してください。

次に示すコマンドを実行してJ2EEリソースアダプタをアンデプロイします。

実行形式

cjundeployrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjundeployrar MyServer -resname Rar1

cjundeployrarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjundeployrar（リソースアダプタのアンデプロイ）」を参照してください。

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

J2EEリソースアダプタの内容をRARファイルとして出力（エクスポート）します。

次に示すコマンドを実行してJ2EEリソースアダプタをエクスポートします。

実行形式

cjexportrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -f ＜ファイルパス＞ -resname ＜J2EEリソースアダプタの表示名＞

実行例

cjexportrar MyServer -f res1.rar -resname Rar1

cjexportrarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjexportrar（リソースアダプタのエクスポート）」を参照してください。

注意事項

Management Serverを利用して運用している場合，サーバ管理コマンドとManagement Serverの実行ホストが異なる場合，J2EEリソースアダプタをエクスポートして，Management Serverの実行ホストに格納する必要があります。

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

デプロイされているリソースアダプタのアダプタ名と状態を参照できます。また，Connector 1.5の仕様に準拠するリソースアダプタの場合，コネクション定義識別子の一覧や，メッセージリスナのタイプの一覧などの情報も参照できます。

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

次に示すコマンドを実行して，デプロイされているすべてのリソースアダプタの名称と状態（開始状態または停止状態）を参照します。

実行形式

cjlistrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-spec］

実行例

cjlistrar MyServer

-specオプションを指定すると，リソースアダプタの状態表示一覧にコネクタアーキテクチャの仕様バージョンが表示されます。

cjlistrarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，デプロイされているOutboundリソースアダプタのコネクション定義識別子の一覧を参照できます。

実行形式

cjlistrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜RARの表示名＞ -outbound

実行例

cjlistrar MyServer -resname account-rar -outbound

cjlistrarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，デプロイされているInboundリソースアダプタのメッセージリスナのタイプの一覧を参照できます。

実行形式

cjlistrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜RARの表示名＞ -inbound

実行例

cjlistrar MyServer -resname account-rar -inbound

cjlistrarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，デプロイされているInboundリソースアダプタのメッセージリスナのアクティブ化に必要なプロパティ名の一覧を参照できます。

実行形式

cjlistrar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜RARの表示名＞ -listenertype ＜メッセージリスナのタイプ名＞

実行例

cjlistrar MyServer -resname account-rar -listenertype javax.jms.MessageListener

cjlistrarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistrar（リソースアダプタの一覧表示）」を参照してください。

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

インポートされているリソースアダプタの一覧を参照できます。また，Connector 1.5の仕様に準拠するリソースアダプタの場合，コネクション定義識別子の一覧や，メッセージリスナのタイプの一覧などの情報も参照できます。

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

次に示すコマンドを実行して，インポートされているリソースアダプタの一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar ［-spec］

実行例

cjlistres MyServer -type rar

-specオプションを指定すると，一覧にコネクタアーキテクチャの仕様バージョンが表示されます。

cjlistresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEリソースアダプタとしてデプロイするOutboundリソースアダプタのコネクション定義識別子の一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜RARの表示名＞ -outbound

実行例

cjlistres MyServer -type rar -resname account-rar -outbound

cjlistresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEリソースアダプタとしてデプロイするInboundリソースアダプタのメッセージリスナのタイプの一覧を参照できます。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜RARの表示名＞ -inbound

実行例

cjlistres MyServer -type rar -resname account-rar -inbound

cjlistresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

4.5.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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

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

リソースアダプタのコネクションプールの情報およびコネクションの状態（使用中，未使用）を参照します。また，必要に応じて，リソースアダプタのコネクションを削除します。

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

次に示すコマンドを使用して，リソースアダプタのコネクションプールの情報および状態を表示します。

実行形式

cjlistpool ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜リソースアダプタの表示名＞

実行例

cjlistpool MyServer -resname Rar1

cjlistpoolコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistpool（コネクションプールの一覧表示）」を参照してください。

参考

Connector 1.5の仕様に準拠するリソースアダプタの場合，-resnameオプションの＜リソースアダプタの表示名＞は次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

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

次に示すコマンドを使用して，リソースアダプタのコネクションプールを削除します。未使用のコネクションプールはすべて削除されます。

実行形式

cjclearpool ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type connector -resname ＜リソースアダプタの表示名＞

実行例

cjclearpool MyServer -type connector -resname Rar1

cjclearpoolコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjclearpool（コネクションプール内のコネクション削除）」を参照してください。

参考

Connector 1.5の仕様に準拠するリソースアダプタの場合，-resnameオプションの＜リソースアダプタの表示名＞は次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

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

JNDI名前空間に登録されるリソースアダプタ名を変更します。

リソースアダプタ名には別名も付けられます。別名を付けることで，JNDI名前空間から任意の名前でリソースアダプタを参照できるようになります。なお，この機能をユーザ指定名前空間機能といいます。

リソースアダプタのJNDI名前空間については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3　JNDI名前空間へのオブジェクトのバインドとルックアップ」を参照してください。ユーザ指定名前空間機能については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.6　Enterprise BeanまたはJ2EEリソースへの別名付与（ユーザ指定名前空間機能）」を参照してください。

別名は，Connector属性ファイルの<resource-external-property>タグで追加できます。ただし，JMSインタフェースを使用するリソースアダプタには，別名は付与できません。

Connector属性ファイルの<resource-external-property>タグの編集については，使用するリソースアダプタの種類に応じて，「4.2.2　DB Connectorのプロパティ定義」，「4.3.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」または「4.3.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」の別名情報の設定を参照してください。

注意事項

開始状態のJ2EEアプリケーションがある場合，別名を設定しているリソースアダプタの停止および削除はできません。J2EEサーバで開始されているすべてのJ2EEアプリケーションを停止させてください。

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

次に示すコマンドを実行してリソースアダプタを削除します。

実行形式

cjdeleteres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -resname ＜リソースアダプタの表示名＞

実行例

cjdeleteres MyServer -type rar -resname account-rar

cjdeleteresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjdeleteres（リソースの削除）」を参照してください。

注意事項

cosminexus.xmlを含むアプリケーションからJ2EEリソースを削除した場合，cosminexus.xmlに含まれている削除対象のJ2EEリソースに関するアプリケーションサーバ独自の定義情報は削除されません。cosminexus.xmlを含むアプリケーションからJ2EEリソースを削除する場合の詳細は，マニュアル「アプリケーションサーバ機能解説 基本・開発編(コンテナ共通機能)」の「16.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

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

次に示すコマンドを実行してリソースアダプタのプロパティをコピーします。

実行形式

cjcopyres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type rar -src ＜コピー元のリソースアダプタの表示名＞ -dst ＜コピー先のリソースアダプタの表示名＞

実行例

cjcopyres MyServer -type rar -src account-rar -dst account-rar2

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

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

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

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

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

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

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

J2EEアプリケーションに含めて利用できるリソースアダプタを次に示します。

DB Connector

TP1 Connector

そのほかのConnector 1.0に準拠したリソースアダプタ，またはConnector 1.5に準拠したリソースアダプタ※

注※　そのほかのConnector 1.0に準拠したリソースアダプタ，またはConnector 1.5に準拠したリソースアダプタについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「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.2.3　リソースアダプタ（RAR）のインポート」を参照してください。

J2EEアプリケーションにインポートしたRARを追加します。

J2EEアプリケーションへのリソースアダプタ（RAR）の追加については，「7.2.4　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.5　属性ファイルによるプロパティの設定」を参照してください。

5.4.1　編集する属性ファイル

次のどちらかの属性ファイルを利用して，J2EEアプリケーションに含まれるリソースアダプタのプロパティを設定できます。

Connector属性ファイルを利用します。

アプリケーション統合属性ファイルを利用します。

J2EEアプリケーション統合属性ファイルを構成するコンポーネントの属性ファイルのうち，Connector属性の要素でプロパティを設定します。

J2EEアプリケーションを構成するコンポーネントのプロパティの設定では，Connector属性ファイルとアプリケーション統合属性ファイルを個々に利用することも，あわせて利用することもできます。

この章では，Connector属性ファイルを使用してのプロパティ設定について説明しています。アプリケーション統合属性ファイルを使用してのプロパティ設定の手順については，「9.2　アプリケーション統合属性ファイルによるプロパティ設定」を参照してください。

5.4.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

5.4.3　編集する属性設定項目

リソースアダプタの種類に応じて，プロパティを定義します。

Connector 1.0の仕様に準拠するリソースアダプタの場合

Connector 1.0の仕様に準拠するリソースアダプタの属性設定項目については，「4.3.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」の「(3)　編集する属性設定項目」を参照してください。

Connector 1.5の仕様に準拠するリソースアダプタの場合

Connector 1.5の仕様に準拠するリソースアダプタの属性設定項目については，「4.3.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」の「(3)　編集する属性設定項目」を参照してください。

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

J2EEアプリケーションに含まれるリソースアダプタに設定した情報が正しいかどうか，接続テストによって検証します。

次に示すコマンドを実行してJ2EEアプリケーションに含まれるリソースアダプタの接続テストを実行します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタの表示名＞

実行例

cjtestres -name App1 -type rar -resname DB_Connector_for_Cosminexus_Driver

J2EEアプリケーションに含まれるリソースアダプタを接続テストする場合の注意事項については，次の説明を参照してください。

データベースと接続するための設定（DB Connectorを使用する場合）

「4.2.4　DB Connectorの接続テスト」

そのほかのリソースと接続するための設定（ほかのリソースアダプタを使用する場合）

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

cjtestresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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　リソースアダプタの一覧の参照

次に示すコマンドを実行して，J2EEアプリケーションに含まれるリソースアダプタの一覧を参照します。

実行形式

cjlistapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name
＜J2EEアプリケーション名＞ -type rar ［-spec］

実行例

cjlistapp MyServer -name App1 -type rar

-specオプションを指定すると，一覧にコネクタアーキテクチャの仕様バージョンが表示されます。

cjlistappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEアプリケーションに含まれるOutboundリソースアダプタのコネクション定義識別子の一覧を参照します。

実行形式

cjlistapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタの表示名＞ -outbound

実行例

cjlistapp MyServer -name App1 -type rar -resname account-rar -outbound

cjlistappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEアプリケーションに含まれるInboundリソースアダプタのメッセージリスナのタイプの一覧を参照します。

実行形式

cjlistapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタの表示名＞ -inbound

実行例

cjlistapp MyServer -name App1 -type rar -resname account-rar -inbound

cjlistappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

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

Connector 1.5の仕様に準拠するリソースアダプタの場合，次に示すコマンドを実行して，J2EEアプリケーションに含まれるInboundリソースアダプタのメッセージリスナのアクティブ化に必要なプロパティ名の一覧を参照します。

実行形式

cjlistapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -type rar -resname ＜リソースアダプタの表示名＞ -listenertype ＜メッセージリスナのタイプ名＞

実行例

cjlistapp MyServer -name App1 -type rar -resname account-rar -listenertype javax.jms.MessageListener

cjlistappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

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

J2EEアプリケーションに含まれるリソースアダプタの，コネクションプールの情報およびコネクションの状態（使用中，未使用）を参照します。また，必要に応じて，リソースアダプタのコネクションを削除します。

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

次に示すコマンドを使用して，J2EEアプリケーションに含まれるリソースアダプタの，コネクションプールの情報および状態を表示します。

実行形式

cjlistpool ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -resname ＜リソースアダプタの表示名＞

実行例

cjlistpool MyServer -name App1 -resname Rar1

cjlistpoolコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistpool（コネクションプールの一覧表示）」を参照してください。

参考

Connector 1.5の仕様に準拠するリソースアダプタの場合，-resnameオプションの＜リソースアダプタの表示名＞は次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

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

次に示すコマンドを使用して，必要に応じて，J2EEアプリケーションに含まれるリソースアダプタのコネクションプールを削除します。なお，未使用のコネクションプールはすべて削除されます。

実行形式

cjclearpool ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type connector -name ＜J2EEアプリケーション名＞ -resname ＜リソースアダプタの表示名＞

実行例

cjclearpool MyServer -type connector -name App1 -resname Rar1

cjclearpoolコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjclearpool（コネクションプール内のコネクション削除）」を参照してください。

参考

Connector 1.5の仕様に準拠するリソースアダプタの場合，-resnameオプションの＜リソースアダプタの表示名＞は次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

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

この章では，サーバ管理コマンドを使用した，リソースアダプタ以外のJ2EEリソースの設定方法について説明します。

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

次のJ2EEリソースについて，設定作業の概要を示します。

JavaBeansリソースの設定

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

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の場合

＜Application Serverのインストールディレクトリ＞¥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リソースのインポート

次に示すコマンドを実行して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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportjb（JavaBeansリソースのインポート）」を参照してください。

注意事項

cjimportjbコマンドの-dオプションには，インポートするディレクトリの最上位を指定してください。また，指定したディレクトリ下にあるすべてのファイルがインポートされるので，不要なファイルは指定したディレクトリ内に含めないようにしてください。

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

JavaBeansリソースのプロパティを定義します。

プロパティの設定手順の概要については，「3.5　属性ファイルによるプロパティの設定」を参照してください。次にJavaBeansリソースのプロパティ定義について説明します。

(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>）の設定項目については，マニュアル「アプリケーションサーバリファレンス 定義編(アプリケーション／リソース定義)」の「4.1.12　<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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjstartjb（JavaBeansリソースの開始）」を参照してください。

6.2.4　JavaBeansリソースの停止

次に示すコマンドを実行してJavaBeansリソースを停止します。

実行形式

cjstopjb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜JavaBeansリソース表示名＞

実行例

cjstopjb MyServer -resname javabeansname

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

注意事項

JavaBeansリソースを停止する前に，停止するJavaBeansリソースを使用しているアプリケーションはすべて停止させてください。

6.2.5　JavaBeansリソースの削除

インポートされているJavaBeansリソースを削除します。

準備

JavaBeansリソースを削除する前に，JavaBeansリソースを停止してJ2EEサーバを再起動してください。

次に示すコマンドを実行してJavaBeansリソースを削除します。

実行形式

cjdeletejb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -resname ＜JavaBeansリソース表示名＞

実行例

cjdeletejb MyServer -resname MyJavaBeans

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

6.2.6　JavaBeansリソースの状態表示

すべてのJavaBeansリソースのJavaBeansリソース名と状態（開始状態または停止状態）を表示します。

次に示すコマンドを実行してJavaBeansリソースの状態を表示します。

実行形式

cjlistjb ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］

実行例

cjlistjb MyServer

cjlistjbコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistjb（JavaBeansリソースの一覧表示）」を参照してください。

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

JavaMailを使用してSMTPサーバに接続する場合に必要な設定です。

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

メールコンフィグレーションを新規作成します。

次に示すコマンドを実行してメール属性ファイルを基にメールコンフィグレーションを新規作成します。

実行形式

cjsetresprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -resname ＜メールの表示名＞ -c ＜メール属性ファイルパス＞

実行例

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

cjsetrespropコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjsetresprop（リソースの属性設定）」を参照してください。属性ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.3　メール属性ファイル」を参照してください。

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

メールコンフィグレーションのプロパティを定義します。新規作成時に定義した内容を変更できます。

プロパティの設定手順の概要については，「3.5　属性ファイルによるプロパティの設定」を参照してください。次にメールコンフィグレーションのプロパティ定義について説明します。

(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>

（凡例）○：必須　△：任意

プロパティの設定項目の説明については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.3　メール属性ファイル」を参照してください。

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

メールコンフィグレーションに設定した内容が正しいかどうか，メールサーバのコネクションをチェックします。

次に示すコマンドを実行してメールコンフィグレーションの接続テストを実施します。

実行形式

cjtestres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -resname ＜メールコンフィグレーションの表示名＞

実行例

cjtestres MyServer -type mail -resname Mymail1

cjtestresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

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

次に示すコマンドを実行してメールコンフィグレーションを削除します。

実行形式

cjdeleteres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -resname ＜メールコンフィグレーションの表示名＞

実行例

cjdeleteres MyServer -type mail -resname Mail

cjdeleteresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjdeleteres（リソースの削除）」を参照してください。

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

次に示すコマンドを実行してメールコンフィグレーションのプロパティをコピーします。

実行形式

cjcopyres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail -src ＜コピー元のメールコンフィグレーションの表示名＞ -dst ＜コピー先のメールコンフィグレーションの表示名＞

実行例

cjcopyres MyServer -type mail -src Mail -dst Mail2

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

6.4　J2EEリソース一覧の参照

J2EEリソースについて，次の一覧を参照します。

インポートされているEJB-JARと，EJB-JARに含まれるJ2EEリソース

インポートされているWARと，WARに含まれるJ2EEリソース

インポートされているメールコンフィグレーション

●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

●WARファイルに含まれるJ2EEリソースの一覧の参照

次に示すコマンドを実行して，WARファイルに含まれるJ2EEリソースの一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type war ［-resname ＜WARファイルの表示名＞］

-resnameオプションを指定すると，特定のWARファイルに含まれるリソース（サーブレット，JSPおよびフィルタ）の一覧が表示されます。

-resnameオプションを指定しないと，インポートされているWARファイルの一覧が表示されます。

実行例

cjlistres MyServer -type war

●メールコンフィグレーションの一覧の参照

次に示すコマンドを実行して，インポートされているメールコンフィグレーションの一覧を参照します。

実行形式

cjlistres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type mail

実行例

cjlistres MyServer -type mail

cjlistresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistres（リソースの一覧表示）」を参照してください。

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

JNDI名前空間に登録されるJ2EEリソース名を変更します。

J2EEリソース名には別名も付けられます。別名を付けることで，JNDI名前空間から任意の名前でJ2EEリソースを参照できるようになります。なお，この機能をユーザ指定名前空間機能といいます。

なお，J2EEリソースのJNDI名前空間については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3　JNDI名前空間へのオブジェクトのバインドとルックアップ」を参照してください。ユーザ指定名前空間機能については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.6　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アプリケーションの作成の概要

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.1
サーブレットとJSP（WAR）のインポート | J2EEアプリケーションの構成にサーブレット・JSP（WAR）が含まれる場合に必要な作業です。 J2EEサーバにサーブレット・JSPをインポートします。 | 7.2.2
リソースアダプタ（RAR）のインポート | J2EEアプリケーションにリソースアダプタ（RAR）を含める場合，含めるリソースアダプタをJ2EEサーバにインポートします。 | 7.2.3
J2EEアプリケーションの新規作成 | インポートしたEJB-JAR，WARを基にEARを作成します。また，必要に応じて，J2EEアプリケーションにRARを含めます。 | 7.2.4
J2EEアプリケーションへのライブラリJARファイルの追加 | J2EEアプリケーションにライブラリJAR（ファイル拡張子は小文字の「.jar」）を追加します。 | 7.2.5
ライブラリJARファイルの一覧の参照 | J2EEアプリケーションに含まれているライブラリJARファイルの一覧を参照します。 | 7.2.6
J2EEアプリケーションからのライブラリJARファイルの削除 | J2EEアプリケーションに含まれているライブラリJARファイルを削除します。 | 7.2.7
J2EEアプリケーションへの参照ライブラリの設定 | J2EEアプリケーションに参照ライブラリを設定します。 | 7.2.8
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ファイルどちらも扱うことができます。

ejb-jar.xml，またはweb.xmlに記載したクラス，メソッド（引数，戻り値，例外），アノテーション情報を読み込むためにロードするクラス※，およびそれらの参照解決に必要なクラスを，J2EEアプリケーション内の各モジュールから参照できる共通ライブラリに含める場合は，ライブラリJARを使用する必要があります。これらのクラスを参照ライブラリとして使用した場合，アプリケーションのインポート時にjava.lang.NoClassDefFoundErrorやjava.lang.ClassNotFoundExceptionが発生し，アノテーション情報の取得に失敗（KDJE42380-Wが出力），または，インポートに失敗します。

注※　

アノテーション情報を読み込むためにロードするクラスの詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「17.3　ロード対象のクラスとロード時に必要なクラスパス」を参照してください。

7.2　J2EEアプリケーションの作成の詳細

7.2.1　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の場合

＜Application Serverのインストールディレクトリ＞¥CC¥examples¥

UNIXの場合

/opt/Cosminexus/CC/examples/

DDを持ったEJB-JARの場合，DDがDTDに従っていることを確認してから，インポートを実行してください。DDがDTDの仕様に従っていないEJB-JARをインポートした場合，メッセージが出力されます。メッセージが出力された場合は，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照してください。

次に示すコマンドを実行してEJB-JARをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type ejb -f ＜EJB-JARファイルパス＞

実行例

cjimportres MyServer -type ejb -f account.jar

cjimportresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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を実装したクラスのパッケージ名やクラス名を指定してください。

作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

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

J2EEサーバモードでWebコンポーネントを利用してJ2EEアプリケーションを実行する前に，サーブレットおよびJSP（WAR）をインポートします。

なお，インポートできるのは，Servlet標準仕様に準拠したDDを持つWAR，またはアノテーションを指定したWARです。このため，DDがDTDに従っていることを確認してから，インポートを実行してください。DDがDTDの仕様に従っていないWARをインポートした場合，メッセージが出力されます。メッセージが出力された場合は，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照してください。

次に示すコマンドを実行してWARをインポートします。

実行形式

cjimportres ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -type war -f ＜WARファイルパス＞

実行例

cjimportres MyServer -type war -f account.war

cjimportresコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

注意事項

DDのバージョンが2.2のWARをインポートするとJ2EEサーバ内でDDのバージョンが2.3に変更されます。

Servlet標準仕様に準拠しないDDを持つWARはインポートできません。

インポート時に指定したWARファイル名は作業ディレクトリ中のディレクトリ名として使用されます。また，WARファイル内のファイルは，デプロイ・スタート時に作業ディレクトリ内に展開されます。WARファイル内に，ホームインタフェースなど，java.rmi.Remoteを実装したクラスがあると，usrconf.propertiesファイルの定義内容に応じて，デプロイ・スタート時に作業ディレクトリ内にスタブが生成されます。usrconf.propertiesファイルのejbserver.deploy.stub.generation.scopeキーにappを指定した場合は，WARファイルに含まれるリモートインタフェースを実装したすべてのインタフェースのスタブが生成されます。

これらのことを考慮して，作業ディレクトリのパス長がプラットフォームの上限に達しないようにWARファイル名，WARファイル中のパッケージ名やクラス名およびjava.rmi.Remoteを実装したクラスのパッケージ名やクラス名を指定してください。

作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

「hitachi-runtime.jar」の名称のWARはインポートしないでください。

7.2.3　リソースアダプタ（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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportres（リソースのインポート）」を参照してください。

注意事項

Connector 1.0以降の仕様に準拠するDDを持つRARであることを確認してから，インポートを実行してください。J2EE Connector 1.0以降の仕様に準拠しないDDを持つRARはインポートできません。

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

インポートしたEJB-JAR，WARを基にJ2EEアプリケーションを作成します。また，EJB-JAR，WARで使用するRARを追加します。

(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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjaddapp（リソースの追加）」を参照してください。

(4)　注意事項

J2EEアプリケーション作成時には，EJBホームオブジェクトのJNDI名前空間（HITACHI_EJB/SERVERS/＜サーバ名称＞/EJB/＜J2EE APP名称＞/＜Enterprise Bean名称＞）の＜J2EE APP名称＞に該当する名前が自動的に割り当てられます。JNDI名前空間については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(コンテナ共通機能)」の「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アプリケーション名を変更できません。

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

J2EEアプリケーションにライブラリJARファイルを追加します。

次に示すコマンドを実行してJ2EEアプリケーションへライブラリJARファイルを追加します。

実行形式

cjimportlibjar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -f ＜ライブラリJAR名＞

実行例

cjimportlibjar MyServer -name App1 -f applib.jar

cjimportlibjarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportlibjar（ライブラリJARのインポート）」を参照してください。

注意事項

インポート時に指定したJARファイル名は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにJARファイル名を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

ライブラリJARファイルの拡張子には小文字の「.jar」を指定してください。

展開ディレクトリ形式のJ2EEアプリケーションへのライブラリJARの追加・削除はできません。

「hitachi-runtime.jar」の名称のライブラリJARはインポートしないでください。

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

J2EEアプリケーションにインポートされているライブラリJARファイルの一覧を参照します。

次に示すコマンドを実行してJ2EEアプリケーションにインポートされているライブラリJARファイルの一覧を参照します。

実行形式

cjlistlibjar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞

実行例

cjlistlibjar MyServer -name App1

cjlistlibjarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistlibjar（ライブラリJARの一覧表示）」を参照してください。

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

J2EEアプリケーションにインポートされているライブラリJARファイルを削除します。

次に示すコマンドを実行してJ2EEアプリケーションからライブラリJARファイルを削除します。

実行形式

cjdeletelibjar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -f ＜ライブラリJARファイル名称＞

実行例

cjdeletelibjar MyServer -name App1 -f applib.jar

cjdeletelibjarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjdeletelibjar（ライブラリJARの削除）」を参照してください。

注意事項

展開ディレクトリ形式のJ2EEアプリケーションへのライブラリJARの追加・削除はできません。

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

J2EEアプリケーションに参照ライブラリを設定します。

J2EEアプリケーションへの参照ライブラリの設定は，J2EEアプリケーション属性ファイルで設定します。プロパティを設定する手順については，「3.5　属性ファイルによるプロパティの設定」を参照してください。

(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アプリケーションのインポート

J2EEアプリケーションをインポートします。インポートできるのは，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.5　J2EEアプリケーションの入れ替え」を参照してください。

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

次に示すコマンドを実行して，アーカイブ形式のJ2EEアプリケーションをインポートします。

実行形式

cjimportapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -f ＜EARファイルのパス＞

実行例

cjimportapp MyServer -f C:¥home¥bank.ear

cjimportappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportapp（J2EEアプリケーションのインポート）」を参照してください。

(1)　実行時情報に関する注意事項

実行時情報はアプリケーションサーバの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に関する注意事項

Java EEの仕様に準拠しない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名前空間については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(コンテナ共通機能)」の「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を実装したクラスのパッケージ名，およびクラス名を指定してください。

なお，作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

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」となります。

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

展開ディレクトリ形式のJ2EEアプリケーションは，J2EEサーバの作業ディレクトリ以下に各コンポーネントのclassファイルやJARファイルを持ちません。DDと展開ディレクトリのパス情報だけを持ち，EARファイルまたはZIPファイルが展開ディレクトリのパスに展開されているJ2EEアプリケーションです。ただし，J2EEアプリケーションに含まれるRARファイルはアーカイブ形式で格納されています。

展開ディレクトリ形式のJ2EEアプリケーションのインポートには，次の二つの方法があります。

アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポートします。

J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポートします。

注意事項

展開ディレクトリ形式のアプリケーションをインポートした場合，J2EEサーバの起動処理中またはサーバ管理コマンド実行中に，アプリケーションディレクトリ以下のディレクトリおよびファイルの追加，削除および上書きはしないでください。

展開ディレクトリ形式のアプリケーションのインポート手順を，次に示します。

(1)　アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポート

次の手順で，J2EEサーバにアプリケーションディレクトリを登録します。

アプリケーションディレクトリを作成します。

展開ディレクトリ形式のJ2EEアプリケーションを新規に作成する場合は，アプリケーションディレクトリを作成します。アプリケーションディレクトリの構成については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.4.2　アプリケーションディレクトリの構成」を参照してください。

アプリケーションディレクトリをインポートします。

上記1.で作成した，アプリケーションディレクトリをJ2EEサーバに登録します。

次に示すコマンドを実行して，アプリケーションディレクトリをインポートします。

(a)　実行形式

cjimportapp ［＜サーバ名＞］ -a ＜アプリケーションディレクトリパス＞

(b)　実行例

cjimportapp MyServer -a AppDirPath

cjimportappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportapp（J2EEアプリケーションのインポート）」を参照してください。

(c)　注意事項

リモート環境では実行できません。

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オプションを使用して，EARファイルまたはZIPファイルを展開して作成されたアプリケーションディレクトリが，次の条件のどれかと一致する場合，-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

展開ディレクトリ形式のJ2EEアプリケーションをインポートする際に，EJB-JARディレクトリとWARディレクトリを除くアプリケーションディレクトリ以下を対象にライブラリJARを検索します。このため，EJB-JARディレクトリとWARディレクトリを除くアプリケーションディレクトリ以下に多数のファイルが存在する場合，インポートに時間が掛かることがあります。

(2)　J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポート

EARファイルまたはエクスポートした実行時情報付きEARファイルを展開ディレクトリ形式でインポートします。

次に示すコマンドを実行して，アプリケーションを展開ディレクトリ形式でインポートします。

(a)　実行形式

cjimportapp ［＜サーバ名＞］-f ＜ファイルパス＞ -d ＜展開ディレクトリパス＞

EARファイルまたはZIPファイルの内容は，展開ディレクトリパスに展開されます。

(b)　実行例

cjimportapp MyServer -f App1.zip -d ApplicationDir

cjimportappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportapp（J2EEアプリケーションのインポート）」を参照してください。

(c)　注意事項

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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjexportapp（J2EEアプリケーションのエクスポート）」を参照してください。

J2EEアプリケーションのエクスポート時の注意事項を，次に示します。

実行時情報に関する注意事項

EARのDDに関する注意事項

●実行時情報に関する注意事項

J2EEアプリケーションをエクスポートする場合，次に示すどちらかを選択できます。デフォルトは実行時情報付きファイルの形式（ZIP形式）になります。

実行時情報付きファイル（ZIP形式）

実行時情報を含んだZIP形式のファイルです。なお，実行時情報付きファイルは，アプリケーションサーバ独自のファイルです。

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を含むアプリケーションのエクスポートについては，マニュアル「アプリケーションサーバ機能解説 基本・開発編(コンテナ共通機能)」の「16.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

●EARのDDに関する注意事項

EARのDDのバージョンは，J2EEアプリケーションのバージョンによって，1.4以降になります。

EARに含まれるEJB-JARのDDのバージョンは，EJB-JARのバージョンによって，2.0以降になります。

EARに含まれるWARのDDのバージョンは，WARのバージョンによって，2.3以降になります。

EARに含まれる各種コンポーネントのDDはUTF-8エンコーディングになります。

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

この章では，サーバ管理コマンドを使用したJ2EEアプリケーションのプロパティの設定方法について説明します。

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

J2EEアプリケーションのプロパティ設定とは，インポートしたJ2EEアプリケーションの属性や動作を定義することです。この節では，次の説明をします。

J2EEアプリケーションのプロパティ設定と属性ファイル

Enterprise Beanのプロパティ設定項目

サーブレットとJSPのプロパティ設定項目

J2EEアプリケーション（共通）のプロパティ設定項目

注意事項

アノテーションで指定した項目は変更できません。また，cosminexus.xmlを含むアプリケーションのプロパティを変更するには，サーバ管理コマンドを使って設定する方法と，MyEclipce使って設定する方法があります。サーバ管理コマンドでcosminexus.xmlにある定義情報を変更したあとでリデプロイ機能を使用すると，サーバ管理コマンドで変更した情報は失われます。

MyEclipceを使ったcosminexus.xmlを含むアプリケーションのプロパティの変更については，マニュアル「アプリケーションサーバ アプリケーション開発ガイド」の「5.3.2　cosminexus.xmlエディタの操作方法」を参照してください。また，cosminexus.xmlを含むアプリケーションの運用については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「16.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

J2EEアプリケーションに含まれるリソースアダプタのプロパティ設定と属性ファイルについては，「5.4　リソースアダプタのプロパティ定義」を参照してください。

9.1.1　J2EEアプリケーションのプロパティ設定と属性ファイル

プロパティの設定手順の概要については，「3.5　属性ファイルによるプロパティの設定」を参照してください。

次の属性ファイルを利用して，J2EEアプリケーションのプロパティを設定できます。

固有の属性ファイルを利用します。

J2EEアプリケーションを構成するコンポーネントの固有属性ファイルごとに，プロパティを設定します。

アプリケーション統合属性ファイルを利用します。

固有の属性ファイルの内容を一括して，プロパティを設定します。

J2EEアプリケーションのプロパティの設定では，固有の属性ファイルとアプリケーション統合属性ファイルを個々に利用することも，合わせて利用することもできます。

この章では，主に，固有の属性ファイルを使用してのプロパティ設定について説明しています。アプリケーション統合属性ファイルを使用してのプロパティ設定については，「9.2　アプリケーション統合属性ファイルによるプロパティ設定」を参照してください。

9.1.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.17

（凡例）

◎：必須。対応するEnterprise Beanが含まれるJ2EEアプリケーションのカスタマイズで必ず設定する。

○：任意。J2EEアプリケーションに応じて設定する。

9.1.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アプリケーションに応じて設定する。

9.1.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.2
| ユーザの設定 | ユーザを登録します。ロールとの対応づけもできます。 | ○ | 機能解説 セキュリティ管理機能編 | 9.2.1
ロールの設定 | ロールを登録します。ユーザとの対応づけもできます。 | ○ | 機能解説 セキュリティ管理機能編 | 9.2.2
セキュリティロールのリファレンス定義 | セキュリティロールへのリファレンスについて定義します。 | ○ | 機能解説 セキュリティ管理機能編 | 9.3
| Enterprise Beanのセキュリティロールリファレンスの定義 | セキュリティロールを参照している個所に，実際にJ2EEサーバが管理しているセキュリティロールをマッピングします。 | ○ | 機能解説 セキュリティ管理機能編 | 9.3.1
サーブレットとJSPのセキュリティロールリファレンスの定義 | セキュリティロールへのリファレンスについて定義します。 | ○ | 機能解説 セキュリティ管理機能編 | 9.3.2
セキュリティの定義（メソッドパーミッション） | セキュリティロールによるアクセス権を設定する場合のメソッドのパーミッションを定義します。 すべてのユーザに対してアクセス権限を設定する場合のメソッドのパーミッションを定義します。 | ○ | 機能解説 セキュリティ管理機能編 | 9.4
セキュリティの定義（セキュリティアイデンティティ） | セキュリティの情報であるセキュリティアイデンティティとしてUseCallerIdentityを設定します。 セキュリティの情報であるセキュリティアイデンティティとしてRun asを設定します。 | ○ | 機能解説 セキュリティ管理機能編 | 9.5
| Enterprise Beanのセキュリティアイデンティティ | J2EEアプリケーション内で参照しているセキュリティアイデンティティ情報に，J2EEサーバが実際に管理しているユーザIDをマッピングします。 | ○ | 機能解説 セキュリティ管理機能編 | 9.5.1
サーブレットとJSPのセキュリティアイデンティティ | セキュリティアイデンティティを定義します。 | ○ | 機能解説 セキュリティ管理機能編 | 9.5.2

（凡例）

○：任意。J2EEアプリケーションに応じて設定する。

注※

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

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

9.2.1　設定手順

サーバ管理コマンドでアプリケーション統合属性ファイルを取得して，固有の属性ファイルの内容を一括して編集できます。

アプリケーション統合属性ファイルに含まれる，固有の属性ファイルの要素を次に示します。

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

（<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>

アプリケーション統合属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.1　アプリケーション統合属性ファイル」を参照してください。

アプリケーション統合属性ファイルによる，J2EEアプリケーションのプロパティ設定手順を次に示します。

(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.3　セキュリティロールのリファレンス定義」を参照してください。

なお，プロパティの設定項目については，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」

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

J2EEアプリケーションを構成するEnterprise Beanが，ほかのEnterprise Beanを呼び出している場合，リファレンスを解決するためのプロパティを設定します。

(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がアプリケーションサーバ上で動作している場合，ネーミングの切り替え機能を利用して，次に示すような形式でマッピング先を指定できます。

指定形式

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)　編集する属性ファイル

編集する属性ファイルについては，「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)　編集する属性ファイル

編集する属性ファイルについては，「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)　編集する属性ファイル

編集する属性ファイルについては，「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のメッセージ参照定義

9.4.1　定義方法

Message-driven Beanのメッセージ参照を定義します。

(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で共有することは推奨しません。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」を参照してください。

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

9.5.1　定義方法

コンテナによるトランザクションの管理方法を定義します。

トランザクション属性はEnterprise Bean単位，インタフェース単位，メソッド単位にそれぞれ指定できます。指定がない場合は上位の単位で指定されたトランザクション属性が有効になります。

Enterprise Beanごとの適用

割り当てたトランザクション属性を，Enterprise Bean内のメソッドに適用します。

インタフェースごとの適用

割り当てたトランザクション属性を，インタフェース内のメソッドに適用します。

メソッドごとの適用

割り当てたトランザクション属性を，一つのメソッドに適用します。

(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>

（凡例）　○：必須　△：任意

プロパティの設定項目については，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」

トランザクション属性の指定とトランザクション管理の動作を，次に示します。

NotSupported

コンテナ管理トランザクション内でメソッドを実行しません。

Supports

メソッドのトランザクションの処理は場合によって異なります。トランザクション内およびトランザクション外で正しく実行するメソッドに対してだけ，この属性を使用してください。

Required

コンテナはメソッドを常にトランザクション内で実行します。

RequiresNew

メソッドは，常に新しいトランザクションで実行します。

Mandatory

メソッドは，常にクライアントのトランザクションを使用しなければなりません。つまり，クライアントはトランザクション内でメソッドを呼び出さなければなりません。

Never

メソッドはトランザクション内で実行できません。つまり，クライアントは，トランザクションの外でメソッドを呼び出さなければなりません。

(4)　注意事項

Enterprise Beanの種類によって設定できるトランザクション属性が異なります。設定できるトランザクション属性およびトランザクション管理の動作については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」を参照してください。

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の設定

(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のクラス定義にも追加しておく必要があります。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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のクラス定義にも追加しておく必要があります。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」を参照してください。

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

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

(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>）プロパティ設定項目を次に示します。

項目 | 必須 | 対応するタグ名
リソースアダプタの表示名 | ○ | <datasource-name>
データベースのカタログ名 | △ | <catalog-name>
データベースのスキーマ名 | △ | <schema-name>
データベースのテーブル名 | ○ | <table-name>
データベースへの書き込み許可／禁止 | ○ | <read-only-access>
トランザクション遮断レベル※1 | △ | <transaction-isolation>
データベース書き込みデータ照合方法 | △ | <concurrency-protection>
フィールドとテーブルのカラムとのマッピング情報※2 | ○ | <field-impl>
finderメソッドの検索条件※3 | ○ | <finder-impl>

（凡例）　○：必須　△：任意

注※1

使用できるトランザクション遮断レベル（<transaction-isolation>）の値は，データベースおよびJDBCドライバでサポートされるオプションによって異なります。

注※2

プライマリキーに対してデータベーステーブルの列を設定します。同じデータベーステーブルのフィールドのマッピングにも使用されます。

EntityBeanのフィールド名（<field-name>）の値は変更できません。EntityBeanのフィールド名（<field-name>）のマッピング先のデータベースの列（<column-name>）を設定してください。

フィールドとテーブルのカラムとのマッピング情報（<field-impl>）は，次の項目で構成されています。

項目 | 対応するタグ名
EntityBeanのフィールド名 | <field-name>
テーブルのカラム名 | <column-name>

注※3　

finderメソッドのメソッド名（<method-name>）の値は変更できません。finderメソッドのメソッド名（<method-name>）のテーブルの検索条件（<where-clause>）を設定してください。

Enterprise Bean内のfinderメソッド情報（<finder-impl>）は，次の項目で構成されています。

項目 | 対応するタグ名
finderメソッドのメソッド名 | <method-name>
テーブルの検索条件 | <where-clause>

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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の定義

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>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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>）プロパティ設定項目を次に示します。

項目 | 必須 | 対応するタグ名
リソースアダプタの表示名 | ○ | <datasource-name>
データベースのカタログ名 | △ | <catalog-name>
データベースのスキーマ名 | △ | <schema-name>
データベースのテーブル名 | ○ | <table-name>
データベースへの書き込み許可／禁止 | ○ | <read-only-access>
トランザクション遮断レベル※1 | △ | <transaction-isolation>
データベース書き込みデータ照合方法 | △ | <concurrency-protection>
フィールドとテーブルのカラムとのマッピング情報※2 | ○ | <field-impl>

（凡例）　○：必須　△：任意

注※1

使用できるトランザクション遮断レベル（<transaction-isolation>）の値は，データベースおよびJDBCドライバでサポートされるオプションによって異なります。

注※2

プライマリキーに対してデータベーステーブルの列を設定します。同じデータベーステーブルのフィールドのマッピングにも使用されます。

EntityBeanのフィールド名（<field-name>）の値は変更できません。EntityBeanのフィールド名（<field-name>）のマッピング先のデータベースの列（<column-name>）を設定してください。

フィールドとテーブルのカラムとのマッピング情報（<field-impl>）は，次の項目で構成されています。

項目 | 対応するタグ名
EntityBeanのフィールド名 | <field-name>
テーブルのカラム名 | <column-name>

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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，双方向の関係の場合）

[picture]

(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のリファレンス定義

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）がEnterprise Beanを呼び出している場合，リファレンスを解決するためのプロパティを設定します。

(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)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの所得と属性の設定については，「9.7.1　Enterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

Enterprise Beanがメールコンフィグレーションを参照している場合のプロパティ設定項目と同じです。「9.3.2　メールコンフィグレーションのリファレンス定義」の「(3)　編集する属性設定項目」を参照してください。

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

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）が，リソースアダプタを参照している場合，リファレンスを定義するためのプロパティを設定します。

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの所得と属性の設定については，「9.7.1　Enterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

Enterprise Beanがリソースアダプタを参照している場合のプロパティ設定項目と同じです。「9.3.3　リソースアダプタのリファレンス定義」の「(3)　編集する属性設定項目」を参照してください。

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

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）がリソース環境を参照している場合，リファレンスを定義するためのプロパティを設定します。

(1)　編集する属性ファイル

WAR属性ファイル

(2)　編集する属性ファイルの取得と属性の設定

編集する属性ファイルの所得と属性の設定については，「9.7.1　Enterprise Beanのリファレンス定義」の「(2)　編集する属性ファイルの取得と属性の設定」を参照してください。

(3)　編集する属性設定項目

Enterprise Beanがリソース環境を参照している場合のプロパティ設定項目と同じです。「9.3.4　リソース環境のリファレンス定義」の「(3)　編集する属性設定項目」を参照してください。

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

9.8.1　定義方法

サーブレットおよびJSPのマッピングを定義します。

(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>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.9.1　サーブレット属性ファイルの指定内容」を参照してください。

9.9　フィルタの設定

フィルタの設定方法について説明します。フィルタを設定するには，フィルタをWARファイルに追加して，マッピングを定義します。

9.9.1　フィルタの追加

次の手順で，WARファイルにフィルタを追加します。

フィルタ属性ファイルを作成します。

テキストエディタなどを使用して，フィルタ属性ファイルを作成します。フィルタ属性ファイルには，フィルタ名称およびフィルタのクラス名を指定します。また，必要に応じて，初期化パラメタの名称および初期化パラメタの値を指定します。

フィルタ属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjaddapp（リソースの追加）」を参照してください。

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

フィルタの追加後，フィルタのマッピングを定義します。

(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パターンまたはサーブレット名のどちらかを指定してください。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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の実行時プロパティの設定

アプリケーションを構成する個々のStateful Session Beanに対して，アプリケーション実行時のプロパティを設定します。

(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ファイルのどちらかで設定されていれば，参照渡しの設定は有効になります。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

(b)　Stateful Session Bean固有の属性

Stateful Session Bean固有の実行時属性（<runtime> - <stateful>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
アクティブセッションの最大数 | ○ | <maximum-active-sessions>
再び活性化するまでに，非活性化状態に保持している時間 | ○ | <inactivity-timeout>
セッションが削除されるまでに非活性化状態に保持している時間 | ○ | <removal-timeout>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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)　編集する属性ファイル

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ファイルのどちらかで設定されていれば，参照渡しの設定は有効になります。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」を参照してください。

(b)　Stateless Session Bean固有の属性

Stateless Session Bean固有の実行時属性（<runtime> - <stateless>）のプロパティ設定項目を，次に示します。

項目 | 必須 | 対応するタグ名
プール内のインスタンスの最小値 | ○ | <pooled-instance> - <minimum>
プール内のインスタンスの最大値 | ○ | <pooled-instance> - <maximum>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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)　編集する属性ファイル

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ファイルのどちらかで設定されていれば，参照渡しの設定は有効になります。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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)　編集する属性ファイル

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セッション数に合わせて定義します。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」を参照してください。

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

J2EEアプリケーションを構成するWebアプリケーション（サーブレットおよびJSP）の実行時属性を定義します。次に示す定義があります。

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

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

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

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

それぞれの定義で設定するプロパティ項目を次に示します。

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

J2EEアプリケーションのコンテキストルートを定義します。

コンテキストルートには，ルートコンテキストも定義できます。ルートコンテキストとは，コンテキストルートが空文字""のコンテキストです。ルートコンテキストにwelcomeファイルを作成すると，「http://www.xxx.com/」のようなドメイン名だけのURLからJ2EEアプリケーションのトップページを表示できるようになります。

(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>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

(4)　注意事項

コンテキストルートには，"ejb/"，または"web/"から始まる文字列を指定しないでください。

複数のJ2EEアプリケーションでコンテキストルートのパスの構成要素が包含関係（例："test"と"test/jsp"）にある場合で，包含する方のパスを含むURL（例："/test/jsp/test.jsp"）を指定してアクセスしたときは，包含する方のアプリケーション（例では，"test/jsp"をコンテキストルートに持つ方）が有効になり，包含される方のアプリケーション（例では，"test"をコンテキストルートに持つ方）にはアクセスできません。

コンテキストルートは，作業ディレクトリ中のディレクトリ名として用いられます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにコンテキストルートを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

ルートコンテキストを使用して開始するWebアプリケーションでは，URLが"ejb"または"web"で始まる構成にしないでください。

コンソールおよびログファイルに出力されるメッセージでは，ルートコンテキストのコンテキストルートは，空文字「""」で表示されます。

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

Webコンテナで同時実行スレッド数を制御するための定義をします。

(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>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

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

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

URLグループ単位での同時実行スレッド数制御を有効にするためは，Webアプリケーション単位での同時実行スレッド数制御の定義を設定してください。Webアプリケーション単位での同時実行スレッド数制御については，「9.11.2　Webアプリケーション単位での同時実行スレッド数制御の定義」を参照してください。

(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>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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)　編集する属性ファイル

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>

（凡例）　○：必須

注※　「しきい値イベントを出力する上限しきい値≧しきい値イベントを出力する下限しきい値」となるよう指定してください。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

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

9.12.1　設定方法

Webアプリケーション単位にデフォルトの文字エンコーディングを設定します。

次の文字エンコーディングについて，デフォルトのエンコーディングが設定できます。

リクエストボディおよびクエリの文字エンコーディング

レスポンスボディの文字エンコーディング

JSPファイルの文字エンコーディング

(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>

（凡例）　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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名前空間については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.3　JNDI名前空間へのオブジェクトのバインドとルックアップ」を参照してください。ユーザ指定名前空間機能については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「2.6　Enterprise BeanまたはJ2EEリソースへの別名付与（ユーザ指定名前空間機能）」を参照してください。

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

J2EEアプリケーション名の参照は，次の手順で実行します。

アプリケーション属性ファイルを取得します。

次に示すコマンドを実行して，アプリケーション属性ファイルを取得します。

実行形式

cjgetappprop ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -c ＜アプリケーション属性ファイルパス＞

実行例

cjgetappprop MyServer -name account -c C:¥home¥accountAPP.xml

テキストエディタなどでアプリケーション属性ファイルを開きます。

アプリケーション属性ファイルのJ2EEアプリケーション名（<lookup-name>）を参照します。

cjgetapppropコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjgetappprop（アプリケーションの属性の取得）」を参照してください。属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.2　アプリケーション属性ファイル」を参照してください。

注意事項

JNDI名前空間に登録されるJ2EEアプリケーション名はJ2EEアプリケーション名を基に自動的に割り当てられます。変更はできません。

9.13.2　Enterprise Bean名の参照と変更

次のEnterprise BeanのEnterprise Bean名を参照および変更します。

Session Bean

Entity Bean

(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>

（凡例）　○：必須　△：任意

プロパティの設定項目については，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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は，構成ソフトウェアにComponent Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「アプリケーションサーバ & BPM/ESB基盤概説」の「2.2.1　製品と構成ソフトウェアの対応」を参照してください。

次の手順で，CTMのスケジューリングを設定します。

アプリケーション単位のスケジューリングを設定します。

スケジューリングの対象にしたいStateless Session Beanのスケジューリングを設定します。

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

J2EEアプリケーション単位のCTMとの連携にかかわる設定をします。

アプリケーションの属性とSession Beanの属性の両方を設定する必要があるので，アプリケーション統合属性ファイルを使用して設定することを推奨します。

(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>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.2.1　アプリケーション属性ファイルの指定内容」を参照してください。

(b)　Session Beanの属性

J2EEアプリケーション単位のCTMとの連携にかかわる実行時属性設定項目（<session-runtime>）を次に示します。

項目 | 必須 | 対応するタグ名
スケジューリングの設定 | ○ | <enable-scheduling>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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)　編集する属性ファイルの取得と属性の設定

属性ファイルの取得

次に示すコマンドを実行してアプリケーション統合属性ファイルを取得します。

実行形式

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>

（凡例）　○：必須

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.2.1　アプリケーション属性ファイルの指定内容」を参照してください。

(b)　Session Beanの属性

CTMに連携するための実行時属性設定項目（<session-runtime>）を次に示します。

項目 | 必須 | 対応するタグ名
スケジューリングの設定 | ○ | <enable-scheduling>
キュー名 | ○ | <scheduling> - <queue-name>
スレッド数 | ○ | <scheduling> - <parallel-count>
キューの長さ | △ | <scheduling> - <queue-length>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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アプリケーションの起動順序の設定

J2EEアプリケーションの起動順序を設定します。

(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アプリケーションに対して同じ値を指定した場合，それらの間の起動順序は保証されません。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.2.1　アプリケーション属性ファイルの指定内容」を参照してください。

9.15.2　Enterprise Beanの起動順序の設定

Enterprise Beanの起動順序を設定します。

(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に対して同じ値を指定した場合，それらの間の起動順序は保証されません。

プロパティの設定項目については，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.4.1　Session Bean属性ファイルの指定内容」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.5.1　Entity Bean属性ファイルの指定内容」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.6.1　MessageDrivenBean属性ファイルの指定内容」

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

サーブレット，JSPが含まれるWARの起動順序を設定します。

(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に対して同じ値を指定した場合，それらの間の起動順序は保証されません。

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.7.1　WAR属性ファイルの指定内容」を参照してください。

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

9.16.1　設定方法

次のタイミングでエラーが発生した場合に，エラーを通知してJ2EEアプリケーションの開始処理を中止するかどうかを指定します。

J2EEアプリケーションの開始時にロードするように設定されている（<load-on-startup>が設定されている）サーブレットまたはJSPの初期化処理中にエラーが発生した場合

タグライブラリ解析時にエラーが発生した場合

(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　インターセプタの設定

9.17.1　設定方法

インターセプタの設定方法について説明します。アプリケーションサーバでインターセプタを使用する場合は，EJB-JARの属性として設定してください。

(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>

（凡例）　○：必須　△：任意

プロパティの設定項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.3.1　EJB-JAR属性ファイルの指定内容」を参照してください。

インターセプタの設定方法や注意事項については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」の「2.15　インターセプタの使用」を参照してください。

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

J2EEアプリケーションの作成およびカスタマイズで設定する，そのほかのプロパティ項目については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」を参照してください。

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

この章では，サーバ管理コマンドを使用したJ2EEアプリケーションの実行について説明します。

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アプリケーションの入れ替え | J2EEサーバ上の，次のJ2EEアプリケーションを入れ替えます。 アーカイブ形式のアプリケーション 展開ディレクトリ形式のアプリケーション | △※2 | △※2 | 10.5
J2EEアプリケーション名の変更 | J2EEアプリケーションの名前を変更します。 | ○ | ○ | 10.6
RMI-IIOPスタブとインタフェースの取得 | J2EEアプリケーションのRMI-IIOPスタブおよびインタフェースを取得します。 | ○ | ○ | 10.7
トランザクション一覧の参照 | トランザクションの情報の一覧を参照します。 J2EEサーバが稼働中の場合は，稼働状況や，開始してからの経過時間などのトランザクションの情報を表示します。 J2EEサーバが停止中の場合は，ステータスファイルにある，仕掛かり中のまま残っている未決着トランザクションの状況を表示します。 | ○ | ○ | 10.8

（凡例）　○：実行できる　△：実行条件がある

注※1　アプリケーションからコンポーネントの削除はできません。

なお，フィルタの追加は，アプリケーションの属性変更であるため実行できます。

注※2　J2EEアプリケーションの入れ替えは，次のコマンドを使用します。

アーカイブ形式の場合　cjreplaceappコマンド

展開ディレクトリ形式の場合　cjreloadappコマンド

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

ここでは，J2EEアプリケーションの開始と停止について説明します。

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

ここでは，次のJ2EEアプリケーションの開始方法について説明します。

通常開始

JSPをコンパイルして開始

(1)　J2EEアプリケーションの通常開始

次に示すコマンドを実行してJ2EEアプリケーションを開始します。J2EEアプリケーションにリソースアダプタが含まれている場合，J2EEアプリケーションに含まれるすべてのリソースアダプタも自動で開始されます。

実行形式

cjstartapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞

実行例

cjstartapp MyServer -name account

cjstartappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjstartapp（J2EEアプリケーションの開始）」を参照してください。

注意事項

アーカイブ形式のアプリケーションの場合，アプリケーションの開始時にJSP事前コンパイルを実施して生成されたJSPコンパイル結果は，アプリケーションの停止時に削除されます。

アプリケーション開始時のJSP事前コンパイルで生成したJSPコンパイル結果をアプリケーションの停止後も利用する場合，次の手順を実行します。

JSPの事前コンパイルを指定してアプリケーションを開始します。

アプリケーションをエクスポートします。

リデプロイ機能などを使用して，JSPコンパイル結果を含むアプリケーションに入れ替えます。

J2EEアプリケーションの入れ替えについては，「10.5　J2EEアプリケーションの入れ替え」を参照してください。

また，アプリケーション開始時のJSP事前コンパイルを実行したあとに，アプリケーションの開始に失敗した場合，アプリケーションは停止し，JSPコンパイル結果は削除されます。アプリケーション開始時のJSP事前コンパイルを実行する前に，アプリケーションが正常に開始できることを確認してください。

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

ここでは，J2EEアプリケーションの通常停止と強制停止について説明します。

(1)　J2EEアプリケーションの通常停止

次に示すコマンドを実行して，J2EEアプリケーションを通常停止します。J2EEアプリケーションにリソースアダプタが含まれている場合，J2EEアプリケーションに含まれるすべてのリソースアダプタも自動で停止されます。

実行形式

cjstopapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞

実行例

cjstopapp MyServer -name account

cjstopappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjstopapp（J2EEアプリケーションの停止）」を参照してください。

(b)　J2EEアプリケーションの自動強制停止オプションを指定して，通常停止を実行する

J2EEアプリケーションの通常停止を実行してもJ2EEアプリケーションが正常に停止しなかった場合，タイムアウト時間が経過すると自動的に強制停止を実行できます。

次のコマンドを実行して，通常停止しないJ2EEアプリケーションを自動的に強制停止します。

実行形式

cjstopapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞ -t ＜タイムアウト時間（秒）＞ -force

実行例

cjstopapp MyServer -name account -t 120 -force

cjstopappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjstopapp（J2EEアプリケーションの停止）」を参照してください。

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

次のコマンドを実行して，インポートされているJ2EEアプリケーションの一覧を参照します。

J2EEアプリケーションが展開ディレクトリ形式の場合，アプリケーションディレクトリのパスを表示します。

実行形式

cjlistapp ［＜サーバ名称＞］

実行例

cjlistapp MyServer

cjlistappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistapp（アプリケーションの一覧表示）」を参照してください。

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

J2EEアプリケーションを削除します。

次に示すコマンドを実行してJ2EEアプリケーションを削除します。

実行形式

cjdeleteapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜J2EEアプリケーション名＞

実行例

cjdeleteapp MyServer -name account

cjdeleteappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjdeleteapp（J2EEアプリケーションの削除）」を参照してください。

注意事項

展開ディレクトリ形式のJ2EEアプリケーションを削除する場合，削除対象のJ2EEアプリケーションのアプリケーションディレクトリは削除されません。J2EEサーバへの登録が解除されます。

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

J2EEサーバモード上で動作するJ2EEアプリケーションの入れ替えには，次の方法があります。

J2EEアプリケーションを再デプロイします。

J2EEアプリケーションをJ2EEサーバから削除し，別のJ2EEアプリケーションを入れ替え，開始します。

リデプロイ機能を使用します。

J2EEアプリケーションがアーカイブ形式の場合に使用できます。

リロード機能を使用します。

展開ディレクトリ形式の場合に使用できます。

この節では，次のJ2EEアプリケーションの入れ替えについて説明します。

リデプロイ機能を使用した，アーカイブ形式のJ2EEアプリケーションの入れ替え

リロード機能を使用した，展開ディレクトリ形式のJ2EEアプリケーションの入れ替え

10.5.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コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjreplaceapp（アプリケーションの入れ替え）」を参照してください。

注意事項

この操作はJ2EEアプリケーションが開始，停止のどちらの状態であっても実行できます。開始状態のJ2EEアプリケーションを入れ替える場合，cjreplaceappコマンドを実行すると，処理の中でJ2EEアプリケーションはいったん停止され，入れ替え後に再開始されます。

なお，開始中状態のJ2EEアプリケーションが正常に停止されなかった場合，J2EEアプリケーションは強制停止されます。-tオプションにタイムアウト時間を指定すると，J2EEアプリケーションの強制停止に移行するまでの時間を設定できます。-tオプションにタイムアウト時間を指定しなかった場合，強制停止に移行するまでの時間は60秒です。

JSP事前コンパイルを実行したアプリケーションの入れ替えで，入れ替え後もJSP事前コンパイル機能を使用する場合，入れ替えるアプリケーションにJSPコンパイル結果が含まれていなければなりません。入れ替えるアプリケーションにJSPコンパイル結果が含まれていない場合，Webアプリケーション単位のJSP事前コンパイルを実行し，入れ替えるアプリケーションにJSPコンパイル結果を含めてください。

cosminexus.xmlを含むアプリケーションにリデプロイ機能を使用した場合，入れ替え前のcosminexus.xmlの定義情報を破棄してデフォルト値に戻したあと，入れ替え後のcosminexus.xmlの定義情報を上書きします。そのため，実行環境でサーバ管理コマンドを使って変更したアプリケーションサーバ独自の定義情報は失われます。

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

リロード機能を使用する場合は，アプリケーションの再生成（EARファイル作成）が不要となり，直接クラスファイルを置き換えるだけでよいため，アプリケーションの入れ替えが容易になります。

リロード機能は，展開ディレクトリ形式を使用し，開始状態およびリロードに失敗して停止状態にあるJ2EEアプリケーションに対してだけ実行できます。

リロード機能を実現するには，次の二つの手段があります。

J2EEサーバが更新を自動的に検知することによるリロード機能

コマンドの実行によるリロード機能

ここでは，コマンドの実行によるリロード機能について説明します。

リロード機能によって，J2EEアプリケーションに入れ替える手順を次に示します。

更新するJavaプログラムをコンパイルします。

リロードコマンドを実行します。

次のリロードコマンドを実行して，展開ディレクトリ形式のJ2EEアプリケーションを入れ替えます。

(1)　実行形式

cjreloadapp ［サーバ名］ -name アプリケーション名 ［-t 強制リロード開始までのタイムアウト時間］

(2)　実行例

cjreloadapp MyServer -name App1

cjreloadappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjreloadapp（アプリケーションのリロード）」を参照してください。

リロード機能の詳細および更新検知によるリロード機能については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.8　J2EEアプリケーションの更新検知とリロード」を参照してください。

(3)　注意事項

デフォルトの設定（app）では，リロード機能は有効になっています。なお，更新検知によるリロード機能を使用するためには，プロパティ設定ファイル（usrconf.properties）のキーを，次のように設定してください。

リロード機能の適用範囲の設定

ejbserver.deploy.context.reload_scope=app

更新検知インターバルの設定

ejbserver.deploy.context.check_interval=1

J2EEアプリケーションの更新検知とリロードの設定については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.8.12　J2EEアプリケーションの更新検知とリロードの設定」を参照してください。

リソースアダプタを含むJ2EEアプリケーションの場合，RARファイルはアーカイブ形式で格納されています。アプリケーションディレクトリ下にあるRARファイルが変更されてもリロードは実行されません。

cosminexus.xmlを含むアプリケーションにリロード機能を使った場合，cosminexus.xmlの定義情報についてはリロードされません。

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

J2EEサーバにインポートしたJ2EEアプリケーションの名称を変更します。

J2EEアプリケーションの名称を変更するには，J2EEアプリケーションを停止しておく必要があります。J2EEアプリケーションを停止する方法については「10.2.2　J2EEアプリケーションの停止」を参照してください。

次に示すコマンドを実行してJ2EEアプリケーション名を変更します。

実行形式

cjrenameapp ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜アプリケーション名＞ -newname ＜変更後のアプリケーション名＞

実行例

cjrenameapp MyServer -name App1 -newname App2

cjrenameappコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjrenameapp（アプリケーション名の変更）」を参照してください。

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

10.7.1　実行形式と説明

J2EEサーバにインポートしたJ2EEアプリケーションのRMI-IIOPスタブとインタフェースを取得します。

J2EEサーバにインポートしたJ2EEアプリケーションのRMI-IIOPスタブおよびインタフェースは，J2EEアプリケーションを一度も開始していない状態では取得できません。

また，J2EEアプリケーション内に，リモートインタフェースを持つEnterprise Beanが存在しない場合，RMI-IIOPスタブおよびインタフェースの取得はエラーになります。

次に示すコマンドを実行してRMI-IIOPスタブおよびインタフェースを取得します。

(1)　実行形式

cjgetstubsjar ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ -name ＜アプリケーション名＞ -d ＜RMI-IIOPスタブおよびインタフェースの格納パス＞

(2)　実行例

cjgetstubsjar MyServer -name App1 -d temp

(3)　注意事項

次の条件を満たすときだけ，この機能を使用できます。

J2EEサーバに旧バージョンで作成したJ2EEアプリケーションが存在する状態で，アプリケーションサーバをアップグレードインストールした場合

cjrenameappコマンドで名称を変更していない場合

次の場合は，index.htmlによるRMI-IIOPスタブおよびインタフェースの取得はできません。

実行時情報を含むJ2EEアプリケーションまたは実行時情報を含まないJ2EEアプリケーションのどちらをインポートした場合も，実行できません。

新規にJ2EEアプリケーションを作成した場合

cjrenameappコマンドで名称を変更した場合

application.xmlを省略したアプリケーションの名前を変更した場合，application.xmlが作成されます。そのため，アプリケーション名を変更したJ2EEアプリケーションはapplication.xmlのあるアプリケーションとなります。

cjgetstubsjarコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjgetstubsjar（アプリケーションのRMI-IIOPスタブおよびインタフェースの取得）」を参照してください。

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

10.8.1　実行形式と説明

トランザクション情報の一覧を参照します。稼働中のJ2EEサーバで動作しているトランザクション情報，および停止中のJ2EEサーバに残っている未決着トランザクション情報を参照できます。

(1)　稼働中のJ2EEサーバでのトランザクション情報の表示

稼働状況や開始してからの経過時間など，トランザクションの情報の一覧を参照します。

(a)　実行形式

cjlisttrn ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-gid ＜グローバルトランザクションID＞］ ［-pending］ ［-time ＜経過時間＞］ ［-bqual］

(b)　実行例

トランザクションに関連しているすべてのXidのブランチIDを表示する例

cjlisttrn MyServer -bqual

cjlisttrnコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlisttrn（稼働中のJ2EEサーバのトランザクション情報の表示）」を参照してください。

(2)　停止中のJ2EEサーバでのトランザクション情報の表示

停止中のJ2EEサーバのステータスファイルに残っている，未決着トランザクション情報の一覧を参照します。

次に示すコマンドを実行してトランザクションの一覧を参照します。

(a)　実行形式

cjlisttrnfile ［＜サーバ名称＞］ ［-nameserver ＜プロバイダURL＞］ ［-gid ＜グローバルトランザクションID＞］ ［-bqual］

(b)　実行例

指定のグローバルトランザクションIDに関する情報を表示する例

cjlisttrnfile MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001

cjlisttrnfileコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlisttrnfile（停止中のJ2EEサーバのトランザクション情報の表示）」を参照してください。

付録

付録A　Server Plug-inからの移行

旧バージョンで使用していたServer Plug-inでの操作は，運用管理ポータル，標準DD，cosminexus.xmlなどを代替手段として利用できます。

ここでは，次のServer Plug-inの操作について，利用できる代替手段を説明します。

論理サーバの運用管理

論理サーバの起動や停止，稼働状況の表示などの操作について説明します。

リソースアダプタの操作

リソースアダプタのインポートやエクスポート，デプロイなどの操作について説明します。

J2EEアプリケーションの操作

J2EEアプリケーションのインポートやエクスポート，開始や停止などの操作について説明します。

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

リソースアダプタを含むJ2EEアプリケーションのインポート，開始や停止などの操作について説明します。

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

次に示す項目について説明します。

Enterprise Beanのプロパティ設定項目

サーブレットとJSPのプロパティ設定項目

J2EEアプリケーション（共通）のプロパティ設定項目

なお，表中の参照先を示す「参照先マニュアル」に記載したマニュアル名の「アプリケーションサーバ」は省略しています。それぞれについて説明します。

付録A.1　論理サーバの運用管理

Server Plug-inに代わって，論理サーバの運用管理は次に示す手段が利用できます。

表A‒1　論理サーバの運用管理の操作方法および参照先

Server Plug-inの操作 | 代替手段 | 参照先マニュアル | 参照個所
操作概要 | 操作詳細
論理サーバの起動 | 開始オプションの設定 | 運用管理ポータル | 運用管理ポータル操作ガイド | 10.8.2
ドメイン単位の論理サーバの一括起動 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.3.2
ホスト単位の論理サーバの一括起動 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.2.2
個別の論理サーバの起動 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.4.2，11.5.2，11.6.2，11.7.2，11.8.2，11.9.2，11.10.2，11.10.6，11.11.2，11.12.2，11.12.6，11.13.2
アプリケーション起動なしでJ2EEサーバを起動 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.9.2
論理サーバの停止 | ドメイン単位の論理サーバの一括停止 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.3.3
ホスト単位の論理サーバの一括停止 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.2.3
個別の論理サーバの停止 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.4.3，11.5.3，11.6.3，11.7.3，11.8.3，11.9.3，11.10.3，11.10.7，11.11.3，11.12.3，11.12.7，11.13.3
論理J2EEサーバの強制停止 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.10.7
論理サーバの稼働状態表示 | 運用管理ドメイン内のすべての論理サーバの稼働状態 | 運用管理ポータル | 運用管理ポータル操作ガイド | 11.3.1

付録A.2　リソースアダプタの操作

リソースアダプタの操作は，Server Plug-inに代わって次の手段が利用できます。

表A‒2　リソースアダプタの操作方法および参照先

Server Plug-inの操作 | 代替手段 | 参照先マニュアル | 参照個所
リソースアダプタのインポート | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.4.4
リソースアダプタのプロパティ定義 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.4.5
リソースアダプタのデプロイ | なし（インポート後に自動的に実行されます）。 | − | −
リソースアダプタの接続テスト | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.4.3
リソースアダプタの開始 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.4.1
リソースアダプタの停止 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.4.2
リソースアダプタの削除 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.4.6
リソースアダプタの稼働状態一覧 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.4.1
リソースアダプタのエクスポート | コマンド（cjexportrar） | リファレンス コマンド編 | cjexportrar（リソースアダプタのエクスポート）
Connector属性のインポートとエクスポート※ | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.4.5

（凡例）

−：該当なし。

注※

運用管理ポータルの［リソースアダプタのConnector属性ファイル編集］画面で，Connector属性を指定，参照できます。

付録A.3　J2EEアプリケーションの操作

J2EEアプリケーションの操作は，Server Plug-inに代わって次の手段が利用できます。

表A‒3　J2EEアプリケーションの操作方法および参照先

Server Plug-inの操作 | 代替手段 | 参照先マニュアル | 参照個所
J2EEアプリケーションのインポート（アーカイブ形式） | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.3
J2EEアプリケーションのインポート（展開ディレクトリ形式） | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.4
J2EEアプリケーションの開始 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.1
J2EEアプリケーションの通常停止 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.2
J2EEアプリケーションの強制停止 | コマンド（cjstopapp） | リファレンス コマンド編 | cjstopapp（J2EEアプリケーションの停止）
J2EEアプリケーションの一覧の参照 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.1
J2EEアプリケーションの削除 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.5
J2EEアプリケーションの入れ替え（アーカイブ形式） | 運用管理ポータル | 運用管理ポータル操作ガイド | 4.3
J2EEアプリケーションの入れ替え（展開ディレクトリ形式） | 運用管理ポータル | 運用管理ポータル操作ガイド | 4.3
J2EEアプリケーション名の変更 | コマンド（cjrenameapp） | リファレンス コマンド編 | cjrenameapp（アプリケーション名の変更）
RMI-IIOPスタブとインタフェースの取得 | コマンド（cjgetstubsjar） | リファレンス コマンド編 | cjgetstubsjar（アプリケーションのRMI-IIOPスタブおよびインタフェースの取得）
アプリケーション統合属性のインポート | コマンド（cjsetappprop）※ | リファレンス コマンド編 | cjsetappprop（アプリケーションの属性設定）
アプリケーション統合属性のエクスポート | コマンド（cjgetappprop）※ | リファレンス コマンド編 | cjgetappprop（アプリケーションの属性の取得）
J2EEアプリケーションのエクスポート | コマンド（cjexportapp） | リファレンス コマンド編 | cjexportapp（J2EEアプリケーションのエクスポート）

注※

cosminexus.xmlを利用してアプリケーションの情報を管理することを推奨します。cosminexus.xmlを含んだJ2EEアプリケーションの詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「16.　アプリケーションの属性管理」を参照してください。

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

J2EEアプリケーションに含まれるリソースアダプタの設定は，Server Plug-inに代わって次の手段が利用できます。

表A‒4　リソースアダプタの設定の操作方法および参照先

Server Plug-inの操作 | 代替手段 | 参照先マニュアル | 参照個所
リソースアダプタを含むJ2EEアプリケーションのインポート | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.3
リソースアダプタのプロパティ定義 | cosminexus.xml （rarタグなど） | リファレンス 定義編(アプリケーション／リソース定義) | 2.2
リソースアダプタの接続テスト | コマンド（cjtestres） | リファレンス コマンド編 | cjtestres（リソースの接続テスト）
リソースアダプタを含むJ2EEアプリケーションの開始 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.1
リソースアダプタを含むJ2EEアプリケーションの停止 | 運用管理ポータル | 運用管理ポータル操作ガイド | 12.3.2
Connector属性のインポートとエクスポート | コマンド（cjgetappprop） | リファレンス コマンド編 | cjgetappprop（アプリケーションの属性の取得）
コマンド（cjsetappprop） | リファレンス コマンド編 | cjsetappprop（アプリケーションの属性設定）

付録A.5　J2EEアプリケーションのプロパティ設定

ここでは，次に示す項目について説明します。

Enterprise Beanのプロパティ設定項目

サーブレットとJSPのプロパティ設定項目

J2EEアプリケーション（共通）のプロパティ設定項目

(1)　Enterprise Beanのプロパティ設定項目

Enterprise Beanのプロパティ設定項目は，Server Plug-inに代わって次の手段が利用できます。

表A‒5　Enterprise Beanのプロパティ設定項目の操作方法および参照先

Server Plug-inの操作 | 代替手段 | 参照個所
ほかのEnterprise Beanのリファレンス定義（ejb-ref） | DD（ejb-jar.xml） | 9.3.1
リソースアダプタのリファレンス定義（resource-ref） | cosminexus.xml，DD（ejb-jar.xml） | 9.3.3
リソース環境のリファレンス定義（resource-env-ref） | cosminexus.xml，DD（ejb-jar.xml） | 9.3.4
Message-driven Beanのメッセージ参照定義（message-ref） | cosminexus.xml | 9.4
トランザクション属性の定義（trans-attribute） | DD（ejb-jar.xml） | 9.5
Stateful Session Beanの実行時プロパティの設定 | cosminexus.xml | 9.10.1
Stateless Session Beanの実行時プロパティの設定 | cosminexus.xml | 9.10.2
Entity Beanの実行時プロパティの設定 | cosminexus.xml | 9.10.3
Message-driven Beanの実行時プロパティの設定 | cosminexus.xml | 9.10.4

(2)　サーブレットとJSPのプロパティ設定項目

サーブレットとJSPのプロパティ設定項目は，Server Plug-inに代わって次の手段が利用できます。

表A‒6　サーブレットとJSPのプロパティ設定項目の操作方法および参照先

Server Plug-inの操作 | 代替手段 | 参照個所
Enterprise Beanのリファレンス定義（ejb-ref） | DD（web.xml） | 9.7.1
リソースアダプタのリファレンス定義（resource-ref） | cosminexus.xml，DD（web.xml） | 9.7.3
リソース環境のリファレンス定義（resource-env-ref） | cosminexus.xml，DD（web.xml） | 9.7.4
サーブレットとJSPのマッピング定義（url-pattern） | DD（web.xml） | 9.8
フィルタのマッピング定義（filter-mapping） | DD（web.xml） | 9.9.2
J2EEアプリケーションのコンテキストルート定義（context-root） | DD（application.xml） | 9.11.1
Webアプリケーション単位での同時実行スレッド数制御の定義（thread-control） | cosminexus.xml | 9.11.2
URLグループ単位での同時実行スレッド数制御の定義 （urlgroup-thread-control） | cosminexus.xml | 9.11.3
URLグループ単位の実行待ちリクエスト数の監視の定義 （urlgroup-thread-controlタグ - stats-monitorタグ - waiting-request-countタグ） | cosminexus.xml | 9.11.4
デフォルトの文字エンコーディングの設定 （http-requestタグ - encodingタグ，http-responseタグ - encodingタグ，jspタグ - page-encodingタグ） | cosminexus.xml | 9.12
サーブレットとJSPのエラー通知の設定 | cosminexus.xml | 9.16

(3)　J2EEアプリケーション（共通）のプロパティ設定項目

J2EEアプリケーション（共通）のプロパティ設定項目は，Server Plug-inに代わって次の手段が利用できます。

表A‒7　J2EEアプリケーション（共通）のプロパティ設定項目の操作方法および参照先

Server Plug-inの操作 | 代替手段 | 参照個所
操作概要 | 操作詳細
CTMのスケジューリング | J2EEアプリケーション単位のスケジューリング | cosminexus.xml | 9.14.1
Stateless Session Bean単位のスケジューリング | cosminexus.xml | 9.14.2
起動順序の設定 | J2EEアプリケーションの起動順序の設定 | cosminexus.xml | 9.15.1
Enterprise Beanの起動順序の設定 | cosminexus.xml | 9.15.2
サーブレットとJSPの起動順序の設定 | cosminexus.xml | 9.15.3

索引

C

CMP1.xとデータベースのマッピング[1]

CMP2.xとデータベースのマッピング[1]、[2]

CMP定義[1]

CMPの設定[1]

CMR[1]

CMRについての注意事項[1]

CMRの定義[1]

CMR用の表[1]

CMR用の表の概要[1]

CMR用の表の生成と削除[1]

CMR用の表の命名規則[1]

CTMのスケジューリング[1]

D

DB Connectorのアンデプロイ[1]

DB Connectorのインポート[1]

DB Connectorのエクスポート[1]

DB Connectorの開始[1]

DB Connectorの接続テスト[1]

DB Connectorの停止[1]

DB Connectorのデプロイ[1]

DB Connectorのプロパティ定義[1]

E

EJBホームオブジェクト[1]

EJB-JARファイルの追加[1]

Enterprise Bean（EJB-JAR）のインポート[1]

Enterprise Beanの起動順序の設定[1]

Enterprise Beanの実行時属性の定義[1]

Enterprise Beanのプロパティ設定項目[1]

Enterprise Beanのリファレンス定義[1]、[2]

Enterprise Bean名の参照と変更[1]

Entity BeanのCMP定義[1]

Entity Beanの実行時プロパティの設定[1]

J

J2EEアプリケーション（共通）のプロパティ設定項目[1]

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

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

J2EEアプリケーション管理の流れ[1]

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

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

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

J2EEアプリケーションの一覧の参照[1]

J2EEアプリケーションの入れ替え[1]

J2EEアプリケーションのインポート[1]

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

J2EEアプリケーションの開始[1]

J2EEアプリケーションの管理[1]

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

J2EEアプリケーションの強制停止[1]

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

J2EEアプリケーションの削除[1]

J2EEアプリケーションの作成[1]

J2EEアプリケーションの作成で実施する作業[1]

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

J2EEアプリケーションの新規作成[1]

J2EEアプリケーションの通常開始[1]

J2EEアプリケーションの通常停止[1]

J2EEアプリケーションの停止[1]

J2EEアプリケーションのプロパティ設定と属性ファイル[1]

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

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

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

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

J2EEアプリケーション名の参照[1]

J2EEアプリケーション名の変更[1]

J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポート[1]

J2EEリソースアダプタのアンデプロイ（そのほかのリソースと接続するための設定）[1]

J2EEリソースアダプタのエクスポート（そのほかのリソースと接続するための設定）[1]

J2EEリソースアダプタの開始（そのほかのリソースと接続するための設定）[1]

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

J2EEリソースアダプタの状態の参照[1]

J2EEリソースアダプタの接続テスト（そのほかのリソースと接続するための設定）[1]

J2EEリソースアダプタの停止（そのほかのリソースと接続するための設定）[1]

J2EEリソース一覧の参照[1]

J2EEリソース管理の流れ[1]

J2EEリソースの管理[1]

J2EEリソースのプロパティの設定手順[1]

JavaBeansリソース属性ファイルのテンプレートファイル[1]

JavaBeansリソースのインポート[1]

JavaBeansリソースの開始[1]

JavaBeansリソースの削除[1]

JavaBeansリソースの状態表示[1]

JavaBeansリソースの停止[1]

JavaBeansリソースのプロパティ定義[1]

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

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

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

JSPをコンパイルして開始[1]

M

Message-driven Beanの実行時プロパティの設定[1]

Message-driven Beanのメッセージ参照定義[1]

R

RMI-IIOPスタブとインタフェースの取得[1]

S

SQL文の生成[1]

Stateful Session Beanの実行時プロパティの設定[1]

Stateless Session Bean単位のスケジューリング[1]

Stateless Session Beanの実行時プロパティの設定[1]

U

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

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

usrconf.bat〔サーバ管理コマンド用〕[1]

usrconf.propertiesファイル[1]

usrconf.properties〔サーバ管理コマンド用〕[1]

usrconf〔サーバ管理コマンド用〕[1]

W

WARファイルの追加[1]

Webアプリケーション初期化失敗時のエラー通知の設定可否[1]

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

あ

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

アプリケーション設定操作[1]

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

アプリケーション設定操作の制約[1]

アプリケーション設定操作の目的[1]

アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポート[1]

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

い

インターセプタの設定[1]

か

稼働中のJ2EEサーバでのトランザクション情報の表示[1]

管理するJ2EEアプリケーション[1]

き

起動順序の設定[1]

共通ライブラリ[1]

こ

更新系コマンド[1]

コネクション定義識別子の一覧の参照（Outboundリソースアダプタ）[1]、[2]、[3]

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

コネクションプールの削除[1]、[2]

コネクションプールの状態の確認[1]

コネクションプールの状態表示[1]、[2]

コミットオプション[1]

コンフィグレーションプロパティの設定例[1]

さ

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

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

サーバ管理コマンドの機能一覧[1]

サーバ管理コマンドの系統[1]、[2]

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

サーバ管理コマンドの動作設定のカスタマイズ[1]

サーバ管理コマンドの排他制御[1]、[2]

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

サーバ管理コマンドのログ取得の設定[1]

サーブレットとJSP（WAR）のインポート[1]

サーブレットとJSPのエラー通知の設定[1]

サーブレットとJSPの起動順序の設定[1]

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

サーブレットとJSPのプロパティ設定項目[1]

サーブレットとJSPのマッピング定義[1]

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

参照系コマンド[1]

参照ライブラリ[1]

し

実行時情報[1]

実行時情報付きファイル[1]

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

障害発生時のCMR用の表の回復[1]

そ

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

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

そのほかのリソースと接続するための設定（リソースアダプタを使用する場合）[1]

た

単一プライマリキーの場合の属性設定[1]

て

停止中のJ2EEサーバでのトランザクション情報の表示[1]

データベースと接続するための設定[1]、[2]

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

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

と

特権系コマンド[1]

特権系コマンドを使用する場合の制御[1]

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

トランザクション管理の動作[1]

トランザクション属性[1]

トランザクション属性の定義[1]

トランザクションの管理方法[1]

ふ

フィルタの削除[1]

フィルタの設定[1]

フィルタの追加[1]

フィルタのマッピング定義[1]

複合プライマリキーの場合の属性設定[1]

プロバイダURL[1]

へ

別名[1]

ほ

ほかのEnterprise Beanのリファレンス定義[1]

め

メールコンフィグレーションのコピー[1]

メールコンフィグレーションの削除[1]

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

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

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

メールコンフィグレーションのリファレンス定義[1]、[2]

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

メッセージリスナのタイプの一覧の参照（Inboundリソースアダプタ）[1]、[2]、[3]

ゆ

ユーザ指定名前空間機能[1]、[2]、[3]

ら

ライブラリJAR[1]

ライブラリJARファイルの一覧の参照[1]

り

リソースアダプタの一覧の参照[1]、[2]、[3]

リソースアダプタの一般情報[1]

リソースアダプタのインポート（そのほかのリソースと接続するための設定）[1]

リソースアダプタのコピー[1]

リソースアダプタの削除[1]

リソースアダプタの接続テスト[1]

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

リソースアダプタのデプロイ（そのほかのリソースと接続するための設定）[1]

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

リソースアダプタのリファレンス定義[1]、[2]

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

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

リソース環境のリファレンス定義[1]、[2]

リデプロイコマンド[1]

リモートインタフェースのEnterprise Beanのリファレンス定義[1]

リロードコマンド[1]

る

ルートコンテキスト[1]

ろ

ローカルインタフェースのEnterprise Beanのリファレンス定義[1]