Cosminexus　リファレンス　定義編

文法書

3020-3-M11-60

目　　次

前書き

変更内容

はじめに

1.　ファイルの概要

1.1　ファイルの種類

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

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

2.　J2EEサーバで使用するファイル

2.1　J2EEサーバで使用するファイルの一覧

2.2　hitachi_web.properties（J2EEサーバ用Webアプリケーションプロパティファイル）

2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）

2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

2.5　server.policy（J2EEサーバ用セキュリティポリシーファイル）

2.6　criticalList.cfg（保護区リストファイル）

3.　バッチサーバで使用するファイル

3.1　バッチサーバで使用するファイルの一覧

3.2　usrconf.cfg（バッチサーバ用オプション定義ファイル）

3.3　usrconf.properties（バッチサーバ用ユーザプロパティファイル）

3.4　server.policy（バッチサーバ用セキュリティポリシーファイル）

3.5　criticalList.cfg（保護区リストファイル）

3.6　usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

3.7　usrconf.properties（バッチアプリケーション用ユーザプロパティファイル）

4.　サーバ管理コマンドで使用するファイル

4.1　サーバ管理コマンドで使用するファイルの一覧

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

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

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

5.　J2EEアプリケーションとリソースの設定で使用する属性ファイル

5.1　J2EEアプリケーションとリソースの設定で使用する属性ファイルの一覧

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

5.2.1　アプリケーション統合属性ファイルの指定内容

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

5.3.1　アプリケーション属性ファイルの指定内容

5.4　EJB-JAR属性ファイル

5.4.1　EJB-JAR属性ファイルの指定内容

5.4.2　DDとの対応

5.5　Session Bean属性ファイル

5.5.1　Session Bean属性ファイルの指定内容

5.5.2　DDとの対応

5.6　Entity Bean属性ファイル

5.6.1　Entity Bean属性ファイルの指定内容

5.6.2　DDとの対応

5.7　MessageDrivenBean属性ファイル

5.7.1　MessageDrivenBean属性ファイルの指定内容

5.7.2　DDとの対応

5.8　WAR属性ファイル

5.8.1　WAR属性ファイルの指定内容

5.8.2　DDとの対応

5.9　フィルタ属性ファイル

5.9.1　フィルタ属性ファイルの指定内容

5.9.2　DDとの対応

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

5.10.1　サーブレット属性ファイルの指定内容

5.10.2　DDとの対応

5.11　Connector属性ファイル

5.11.1　Connector属性ファイルの指定内容

5.11.2　<config-property>タグに指定できるプロパティ

5.11.3　<property>タグに指定できるプロパティ

5.11.4　Connector属性ファイルのテンプレートファイル

5.11.5　DDとの対応

5.12　JavaBeansリソース属性ファイル

5.12.1　JavaBeansリソース属性ファイルの指定内容

5.13　データソース設定ファイル

5.14　データソース属性ファイル

5.15　プール管理情報設定ファイル

5.16　メール属性ファイル

6.　CTMで使用するファイル

6.1　CTMで使用するファイルの一覧

6.2　CTMユーザ環境変数定義ファイル

6.3　CTMコマンドオプションファイル

7.　Webサーバ連携で使用するファイル

7.1　Webサーバ連携で使用するファイルの一覧

7.2　isapi_redirect.conf（Microsoft IIS用リダイレクタ動作定義ファイル）

7.3　mod_jk.conf（Hitachi Web Server用リダイレクタ動作定義ファイル）

7.4　uriworkermap.properties（Microsoft IIS用マッピング定義ファイル）

7.5　workers.properties（ワーカ定義ファイル）

8.　Cosminexus Managerで使用するファイル

8.1　Cosminexus Managerで使用するファイルの一覧

8.2　adminagent.properties（運用管理エージェントプロパティファイル）

8.3　adminagentuser.cfg（運用管理エージェント用オプション定義ファイル）

8.4　adminagent.xml（運用管理エージェント設定ファイル）

8.5　mngagent.<実サーバ名>.properties （運用監視エージェントプロパティファイル）

8.6　mserver.properties（Management Server環境設定ファイル）

8.7　mserver.cfg（Management Server用オプション定義ファイル）

8.8　mserverenv.cfg（Management Server用環境変数定義ファイル）

8.9　manager.cfg（Manager設定ファイル）

8.10　maction.properties（Managementアクション実行用プロパティファイル）

8.11　Managementイベント発行用プロパティファイル

8.12　Managementイベント発行用メッセージIDリストファイル

8.13　Management Server管理ファイル用退避対象定義ファイル

8.14　.mngsvrutilrc（mngsvrutilコマンドのクライアント側定義ファイル）

8.15　mngsvrutil.properties（mngsvrutilコマンドのサーバ側定義ファイル）

8.16　mngsvrutilcl.properties（mngsvrutilコマンドのクライアント側共通定義ファイル）

8.17　.mngsvrmonitorrc（JP1/IM連携用モニタ起動コマンドの設定ファイル）

8.18　JP1/IM連携用システムログメッセージマッピングファイル

8.18.1　mserver.jp1event.system.mapping.properties（Management Server用メッセージマッピングファイル）

8.18.2　manager.jp1event.system.mapping.properties（J2EEサーバ共通用メッセージマッピングファイル）

8.18.3　manager.<論理サーバ名>.jp1event.system.mapping.properties（J2EEサーバ個別用メッセージマッピングファイル）

8.18.4　JP1イベントへの変換

8.19　論理ユーザサーバ定義ファイル

9.　ログの運用で使用するファイル

9.1　ログの運用で使用するファイルの一覧

9.2　snapshotログ収集対象定義ファイル

10.　監査ログの設定で使用するファイル

10.1　監査ログの設定で使用するファイルの一覧

10.2　監査ログ定義ファイル

11.　統合ユーザ管理で使用するファイル

11.1　統合ユーザ管理で使用するファイルの一覧

11.2　jaas.conf（JAASのコンフィグレーションファイル）

11.3　ua.conf（統合ユーザ管理のコンフィグレーションファイル）

11.4　シングルサインオン用認証情報のCSV形式ファイル

11.4.1　CSV形式ファイルの基本仕様

11.4.2　ユーザ情報を取得するための定義ファイル

11.4.3　ユーザ情報を追加および変更するための定義ファイル

11.4.4　ユーザマッピングと認証情報の定義ファイル

11.4.5　CSV形式ファイルの記述例

11.4.6　ラインオペレーション

12.　Javaアプリケーションで使用するファイル

12.1　Javaアプリケーションで使用するファイルの一覧

12.2　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）

12.3　usrconf.properties（Javaアプリケーション用ユーザプロパティファイル）

12.4　Javaアプリケーションに指定するシステムプロパティ

12.5　Javaアプリケーションのユーザログ用プロパティ設定ファイル

13.　Webアプリケーションで使用するファイル

13.1　Webアプリケーションで使用するファイルの一覧

13.2　コンパイル対象外リストファイル

13.3　実行結果リストファイル

14.　Cosminexus DABroker Libraryで使用するファイル

14.1　Cosminexus DABroker Libraryで使用するファイルの一覧

14.2　Cosminexus DABroker Library動作環境定義ファイル

14.3　共通設定項目

DAB_LANG（LANG環境変数）

DABTMP（作業ディレクトリ）

DABSVLOGSIZE（ログファイルサイズ［dabsv.log］）

DABSELECTCOLCNT（表検索カラム数）

DABSELECTINFCNT（更新・検索条件カラム数）

DABORACLE_TYPE（使用するORACLEのバージョン）

DABSQL_HiRDB_DICTIONARY_DATATYPE（HiRDBのディクショナリ表のデータ属性）

DAB_HIRDB_DBINF_ESC（HiRDB環境変数区切り文字）

DABEXSQL_TRC_LINE（拡張データベースアクセストレースを取得する）

トレースファイルサイズ

DABXA_LOG_ERROR（XAトレースを取得する）

14.4　拡張データベースアクセストレース設定項目

DABSQL_TRC_CANCEL（CANCEL）

DABSQL_TRC_CLOSE（CLOSE）

DABSQL_TRC_COMMIT（COMMIT）

DABSQL_TRC_CONNECT（CONNECT）

DABSQL_TRC_DECLARE（DECLARE）

DABSQL_TRC_DESCRIBE（DESCRIBE）

DABSQL_TRC_DISCONNECT（DISCONNECT）

DABSQL_TRC_EXECUTE（EXECUTE）

DABSQL_TRC_FETCH（FETCH）

DABSQL_TRC_LOGGING（LOGGING）

DABSQL_TRC_LOGLESS（LOGLESS）

DABSQL_TRC_PREPARE（PREPARE）

DABSQL_TRC_ROLLBACK（ROLLBACK）

DABSQL_TRC_OPEN（OPEN）

DABSQL_TRC_ATTACH（ATTACH）

DABSQL_TRC_ATTRGET（ATTRGET）

DABSQL_TRC_ATTRSET（ATTRSET）

DABSQL_TRC_BIND（BIND）

DABSQL_TRC_CHARFORM（CHARFORM）

DABSQL_TRC_CHARID（CHARID）

DABSQL_TRC_DEFINE（DEFINE）

DABSQL_TRC_DESALLOC（DESALLOC）

DABSQL_TRC_DESCANY（DESCANY）

DABSQL_TRC_DESFREE（DESFREE）

DABSQL_TRC_DETACH（DETACH）

DABSQL_TRC_ENVCREATE（ENVCREATE）

DABSQL_TRC_ERRGET（ERRGET）

DABSQL_TRC_GETPIECE（GETPIECE）

DABSQL_TRC_HDLALLOC（HDLALLOC）

DABSQL_TRC_HDLFREE（HDLFREE）

DABSQL_TRC_LOBCLOSE（LOBCLOSE）

DABSQL_TRC_LOBLEN（LOBLEN）

DABSQL_TRC_LOBOPEN（LOBOPEN）

DABSQL_TRC_LOBREAD（LOBREAD）

DABSQL_TRC_LOBWRITE（LOBWRITE）

DABSQL_TRC_PARAMGET（PARAMGET）

DABSQL_TRC_SESBEGIN（SESBEGIN）

DABSQL_TRC_SESEND（SESEND）

DABSQL_TRC_SETPIECE（SETPIECE）

DABSQL_TRC_GETDIAG（GETDIAG）

DABSQL_TRC_AUTO_COMMIT_OFF（AUTO COMMIT OFF）

DABSQL_TRC_AUTO_COMMIT_ON（AUTO COMMIT ON）

DABSQL_TRC_GET_INFO（GET INFO）

DABSQL_TRC_SET_INFO（SET INFO）

DABSQL_TRC_EXECUTE_DIRECT（EXECUTE DIRECT）

14.5　リモートアクセス設定項目

DABHIRDBA_BLOBBUFSIZE（HiRDBのBLOB型データ受取バッファサイズ）

DABORADBA_LONGBUFSIZE（ORACLEのLONG型データ受取バッファサイズ）

DABLANGMODE（漢字コードセット）

14.6　for C++設定項目

DABCPP_EVTTRC_SIZE（トレース取得サイズ）

DABCPP_EVTTRC_LEVEL（トレース取得レベル）

14.7　HiRDBの設定項目

14.8　ORACLEの設定項目

15.　Webコンテナサーバで使用するファイル

15.1　Webコンテナサーバで使用するファイルの一覧

15.2　hitachi_web.properties（Webコンテナサーバ用Webアプリケーションプロパティファイル）

15.3　usrconf.cfg（Webコンテナサーバ用オプション定義ファイル）

15.4　usrconf.properties（Webコンテナサーバ用ユーザプロパティファイル）

15.5　web-users.xml（ユーザ認証情報定義ファイル）

15.6　web.policy（SecurityManager定義ファイル）

16.　JavaVM起動オプション

16.1　日立固有のJavaVM拡張オプションの一覧

16.2　日立固有のJavaVM拡張オプションの詳細

-XX:+Hitachi（一覧表示オプション）

-XX:[+|-]HitachiThreadDump（拡張スレッドダンプ情報出力オプション）

-XX:[+|-]HitachiThreadDumpToStdout（拡張スレッドダンプ標準出力抑止オプション）

-XX:[+|-]HitachiThreadDumpWithHashCode（拡張スレッドダンプハッシュコード出力オプション）

-XX:[+|-]HitachiThreadDumpWithCpuTime（拡張スレッドダンプCPU利用時間出力オプション）

-XX:[+|-]HitachiThreadDumpWithBlockCount（拡張スレッドダンプブロック回数出力オプション）

-XX:HitachiJavaLog（ログファイル名のプリフィックス指定オプション）

-XX:HitachiJavaLogFileSize（最大ログファイルサイズ指定オプション）

-XX:[+|-]HitachiJavaLogNoMoreOutput（ログファイル入出力エラー発生時指定オプション）

-XX:HitachiJavaLogNumberOfFile（最大ログファイル数指定オプション）

-XX:[+|-]HitachiOutputMilliTime（詳細時間出力オプション）

-XX:[+|-]HitachiVerboseGC（拡張verbosegc情報出力オプション）

-XX:[+|-]HitachiCommaVerboseGC（CSV出力オプション）

-XX:HitachiVerboseGCIntervalTime（拡張verbosegc情報出力間隔指定オプション）

-XX:[+|-]HitachiVerboseGCPrintCause（ガーベージコレクション要因内容出力オプション）

-XX:[+|-]HitachiVerboseGCPrintDate（拡張verbosegc情報日付出力オプション）

-XX:[+|-]HitachiVerboseGCCpuTime（拡張verbosegc情報CPU利用時間出力オプション）

-XX:[+|-]HitachiOutOfMemoryCause（例外発生要因種別出力オプション）

-XX:[+|-]HitachiOutOfMemoryStackTrace（スタックトレース出力オプション）

-XX:HitachiOutOfMemoryStackTraceLineSize（スタックトレース行サイズ指定オプション）

-XX:[+|-]HitachiOutOfMemorySize（メモリサイズ出力オプション）

-XX:[+|-]HitachiOutOfMemoryAbort（強制終了オプション）

-XX:[+|-]HitachiOutOfMemoryAbortThreadDump（スレッドダンプ出力オプション）

-XX:[+|-]HitachiJavaClassLibTrace（クラスライブラリのスタックトレース出力オプション）

-XX:HitachiJavaClassLibTraceLineSize（クラスライブラリのスタックトレース行サイズ指定オプション）

-XX:[+|-]HitachiLocalsInThrowable（例外発生時のローカル変数情報収集オプション）

-XX:[+|-]HitachiLocalsInStackTrace（スレッドダンプ出力時のローカル変数出力オプション）

-XX:[+|-]HitachiLocalsSimpleFormat（ローカル変数情報の出力フォーマット変更オプション）

-XX:[+|-]HitachiTrueTypeInLocals（ローカル変数情報の実型名出力オプション）

-XX:HitachiCallToString（ローカル変数情報出力オプション）

-XX:[+|-]HitachiFullCore（システムリソース解除オプション）

-XX:[+|-]HitachiReserveSwapSpace（スワップ領域の予約オプション）

16.3　Java HotSpot VMのオプションのCosminexusでのデフォルト値

付録

付録A　拡張MIBオブジェクト定義ファイル

付録A.1　拡張MIBオブジェクト定義ファイルのテーブル

付録B　Webアプリケーション用DD（web.xml）

付録B.1　拡張子とMIMEタイプの対応づけ

索引

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

All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.

前書き

■ 対象製品

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

P-2443-7D74　 uCosminexus Application Server Standard　 07-60
P-2443-7K74　 uCosminexus Application Server Enterprise　 07-60
P-2443-7M74　 uCosminexus Web Redirector　 07-60
P-2443-7S74　 uCosminexus Service Platform　 07-60※

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Vista，Windows XP

P-2443-7E74　 uCosminexus Developer Standard　 07-60
P-2443-7F74　 uCosminexus Developer Professional　 07-60
P-2443-7T74　 uCosminexus Service Architect　 07-60※
P-2443-7U74　 uCosminexus Operator　 07-60※

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

P-2443-7H74　 uCosminexus Client　 07-60

●適用OS：AIX 5L V5.2，AIX 5L V5.3

P-1M43-7D71　 uCosminexus Application Server Standard　 07-60※
P-1M43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-1M43-7M71　 uCosminexus Web Redirector　 07-60※
P-1M43-7S71　 uCosminexus Service Platform　 07-60※

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

P-1J43-7D71　 uCosminexus Application Server Standard　 07-60※
P-1J43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-1J43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（x86），Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux ES 3（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）

P-9S43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9S43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9S43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（x86），Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux ES 3（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5（AMD/Intel 64）

P-9S43-7S71　 uCosminexus Service Platform　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（IPF），Red Hat Enterprise Linux AS 4（IPF），Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium）

P-9V43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9V43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9V43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Solaris 9，Solaris 10

P-9D43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9D43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9D43-7M71　 uCosminexus Web Redirector　 07-60※
P-9D43-7S71　 uCosminexus Service Platform　 07-60※

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

■ 輸出時の注意

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

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices,Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB（Object Request Broker）間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems,Inc.の商標または登録商標です。
JDKは，米国 Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model　Driven　Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle9iは，米国Oracle Corporationの商標です。
Oracle 10gは，米国Oracle Corporationの商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
Solaris は，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
Sunは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X/Openは，X/Open Company Limited の英国ならびに他の国における登録商標です。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，米国Sun Microsystems,Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。

■ 発行

2006年4月 (第1版) 3020-3-M11
2007年12月 (第4版) 3020-3-M11-60

■ 著作権

All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.

変更内容

変更内容（3020-3-M11-60）uCosminexus Application Server Standard 07-60，uCosminexus Developer Standard 07-60，uCosminexus Developer Professional 07-60，uCosminexus Client 07-60，uCosminexus Application Server Enterprise 07-60，uCosminexus Web Redirector 07-60，uCosminexus Service Platform 07-60，uCosminexus Service Architect 07-60，uCosminexus Operator 07-60

追加・変更内容
変更個所

usrconf.cfg（J2EEサーバ用オプション定義ファイル）の次のキーの説明を変更した。

cpp.library.version

2.3

Solarisの記述を追加した。
2.3，12.2，12.4，14.3，16.2，16.3

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の次のキーの説明を変更した。

ejbserver.container.security.disabled

ejbserver.rmi.remote.listener.port

ejbserver.watch.memory.enabled

ejbserver.watch.memory.threshold

2.4

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）に次のキーを追加した。

webserver.jsp.translation.backcompat.customAction.declareVariable

webserver.jsp.translation.backcompat.taglib.noCheckPrefix

webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue

webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate

webserver.jsp.translation.backcompat.useBean.noCheckClass

webserver.sfo.check_size.mode

webserver.static_content.encoding.extension

2.4

Application Serverで，バッチ処理を実行するアプリケーションの実行基盤をサポートした。これに伴い，バッチアプリケーションおよびバッチサーバに関する説明を追加した。
3章，5.1，8.12

属性ファイルに対応するDTDファイルの格納先を追加した。
5.1

アプリケーション統合属性ファイルのDOCTYPE宣言を変更した。
5.2.1

アプリケーション属性ファイルのDOCTYPE宣言を変更した。
5.3.1

EJB-JAR属性ファイルのDOCTYPE宣言を変更した。
5.4.1

EJB-JAR属性ファイルの<interceptor-binding>タグの説明を変更した。
5.4.1

EJB-JAR属性ファイルに対応するDDに<interceptor-binding>タグ以下のタグを追加した。
5.4.2

Session Bean属性ファイルのDOCTYPE宣言を変更した。
5.5.1

Session Bean属性ファイルに次のタグを追加した。

<mapped-name>タグ

<resource-env-ref>タグ下の<linked-adminobject>以下のタグ

<runtime>タグ下の<local-optional-name>タグ

5.5.1，5.5.2

Session Bean属性ファイルの次のタグの説明を変更した。

<resource-ref>タグ下の<mapped-name>タグ，および<linked-to>タグ

<resource-env-ref>タグ下の<resource-env-ref-type>タグ，および<mapped-name>タグ

<runtime>タグ下の<lookup-name>タグ

<ejb-method-observation-timeout>タグ

<ejb-method-observation-timeout>タグ下の<ejb-transaction-timeout>タグ

5.5.1

Entity Bean属性ファイルのDOCTYPE宣言を変更した。
5.6

Entity Bean属性ファイルの次のタグの説明を変更した。

<resource-ref>タグ下の<linked-to>タグ

<runtime>タグ下の<lookup-name>タグ，および<datasource-name>

<ejb-method-observation-timeout>タグ

<ejb-transaction-timeout>

5.6.1

Entity Bean属性ファイルに次のタグを追加した。

<resource-env-ref>タグ下の<linked-adminobject>タグ以下のタグ

<runtime>タグ下の<local-optional-name>タグ

5.6.1，5.6.2

MessageDrivenBean属性ファイルのDOCTYPE宣言を変更した。
5.7.1

MessageDrivenBean属性ファイルに次のタグを追加した。

<messaging-type>タグ

<activation-config>タグ以下のタグ

<resource-env-ref>タグ下の<linked-adminobject>タグ以下のタグ

5.7.1

MessageDrivenBean属性ファイルの次のタグの説明を変更した。

<message-selector>タグ

<acknowledge-mode>タグ

<message-driven-destination>タグ

<message-ref>タグ

<message-ref>タグ下の<connection-factory>タグ，および<queue>タグ

<resource-ref>タグ下の<linked-to>タグ

<resource-env-ref>タグ下の<resource-env-ref-type>タグ

<start-order>タグ

<start-order>タグ下の<ejb-method-observation-timeout>タグ

<ejb-transaction-timeout>タグ

5.7.1

EJB2.1の場合のMessageDrivenBean属性ファイルとDDとの対応を追加した。
5.7.2

WAR属性ファイルのDOCTYPE宣言を変更した。
5.8.1

WAR属性ファイルの次のタグの説明を変更した。
<resource-ref>タグ下の<linked-to>タグ
<resource-env-ref>タグ下の<resource-env-ref-type>タグ
5.8.1

WAR属性ファイルの<resource-env-ref>タグ下の<linked-adminobject>タグ以下のタグを追加した。
5.8.1，5.8.2

フィルタ属性ファイルのDOCTYPE宣言を変更した。
5.9.1

サーブレット属性ファイルのDOCTYPE宣言を変更した。
5.10.1

Connector属性ファイルのDOCTYPE宣言を変更した。
5.11.1

Connector属性ファイルに次のタグを追加した。

<license>タグ下の<description>タグ

<inbound-resourceadapter>タグ以下のタグ，および<adminobject>タグ以下のタグ

5.11.1，5.11.5

Connector属性ファイルの次のタグの説明を変更した。

<resourceadapter>タグ下の<config-property-value>タグ，<outbound-resourceadapter>タグ，<config-property-value>，<property>タグ，<property-value>タグ，<resource-external-property>タグ，<optional-name>タグ

<resourceadapter-runtime>下の<property>タグ

5.11.1

Connector属性ファイルのテンプレートファイルを使用する場合の注意事項を追加した。
5.11.4

JavaBeansリソース属性ファイルのDOCTYPE宣言を変更した。
5.12.1

JavaBeansリソース属性ファイルの次のタグの説明を変更した。

<runtime>タグ下の<property>タグ

<resource-env-external-property>タグ下の<optional-name>タグ

5.12.1

データソース設定ファイルのDOCTYPE宣言を変更した。また，サンプルファイル使用時の注意事項を追加した。
5.13

データソース属性ファイルのDOCTYPE宣言を変更した。
5.14

データソース属性ファイルの<property>タグの説明を変更した。
5.14

プール属性ファイルのDOCTYPE宣言を変更した。また，サンプルファイル使用時の注意事項を追加した。
5.15

メール属性ファイルのDOCTYPE宣言を変更した。
5.16

<runtime>タグ下の<resource-external-property>タグ，および<optional-name>タグ下の説明を変更した。
5.16

adminagent.properties（運用管理エージェントプロパティファイル）の次のキーの説明を変更した。

adminagent.forcestop.threaddump.timeout

8.2

adminagent.properties（運用管理エージェントプロパティファイル）に次のキーを追加した。

adminagent.rmi.log.filenum

adminagent.rmi.log.filesize

adminagent.rmi.log.level

8.2

mserver.properties（Management Server環境設定ファイル）に次のキーを追加した。

com.cosminexus.mngsvr.management.enabled

com.cosminexus.mngsvr.management.connector.enabled

com.cosminexus.mngsvr.management.port

com.cosminexus.mngsvr.management.host

com.cosminexus.mngsvr.management.listen.port

com.cosminexus.mngsvr.management.read_timeout

8.6

論理ユーザサーバ定義ファイルに<force-watch-time>タグを追加した。
8.19

監査ログ定義ファイルのディレクトリおよびファイルの所有者とアクセス権限について，注意事項を追加した。（UNIXの場合）
10.2

「EJBクライアントアプリケーション」という用語を「Javaアプリケーション」に変更した。
12章

usrconf.properties（Webコンテナサーバ用ユーザプロパティファイル）に次のキーを追加した。

webserver.jsp.translation.backcompat.customAction.declareVariable

webserver.jsp.translation.backcompat.taglib.noCheckPrefix

webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue

webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate

webserver.jsp.translation.backcompat.useBean.noCheckClass

15.4

次の製品の適用OSに，Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），およびRed Hat Enterprise Linux 5（AMD/Intel 64）を追加した。

uCosminexus Service Platform

－

次の製品の適用OSにLinux（IPF）を追加した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

－

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

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

uCosminexus Service Platform

－

HP-UX（PA-RISC）のサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

－

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

uCosminexus Service Platform

－

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

第4版では，章構成を変更しました。第3版との対応は次のようになっています。

第3版
第4版

1.　ファイルの概要
1.　ファイルの概要

2.　J2EEサーバで使用するファイル
2.1　J2EEサーバで使用するファイルの一覧
2.2　hitachi_web.properties（J2EEサーバ用Webアプリケーションプロパティファイル）
2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）
2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）
2.5　server.policy（J2EEサーバ用セキュリティポリシーファイル）
2.6　criticalList.cfg（保護区リストファイル）
2.　J2EEサーバで使用するファイル

2.7　usrconf（サーバ管理コマンド用オプション定義ファイル）
2.8　usrconf.bat（サーバ管理コマンド用オプション定義ファイル）
2.9　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）
4.　サーバ管理コマンドで使用するファイル

3.　CTMで使用するファイル
6.　CTMで使用するファイル

4.　Webサーバ連携で使用するファイル
7.　Webサーバ連携で使用するファイル

5.　Cosminexus Managerで使用するファイル
8.　Cosminexus Managerで使用するファイル

6.　ログの運用で使用するファイル
9.　ログの運用で使用するファイル

7.　統合ユーザ管理で使用するファイル
11.　統合ユーザ管理で使用するファイル

8.　業務アプリケーションとリソースの設定で使用する属性ファイル
5.　J2EEアプリケーションとリソースの設定で使用する属性ファイル

9.　Webアプリケーションで使用するファイル
13.　Webアプリケーションで使用するファイル

10.　EJBクライアントアプリケーションで使用するファイル
12.　Javaアプリケーションで使用するファイル

11.　監査ログの設定で使用するファイル
10.　監査ログの設定で使用するファイル

12.　Cosminexus DABroker Libraryで使用するファイル
14.　Cosminexus DABroker Libraryで使用するファイル

13.　Webコンテナサーバで使用するファイル
15.　Webコンテナサーバで使用するファイル

14.　JavaVM起動オプション
16.　JavaVM起動オプション

付録A　拡張MIBオブジェクト定義ファイル
付録A　拡張MIBオブジェクト定義ファイル

付録B　Webアプリケーション用DD（web.xml）
付録B　Webアプリケーション用DD（web.xml）

変更内容（3020-3-M11-40）uCosminexus Application Server Standard 07-50，uCosminexus Developer Standard 07-50，uCosminexus Developer Professional 07-50，uCosminexus Client 07-50，uCosminexus Application Server Enterprise 07-50，uCosminexus Web Redirector 07-50，uCosminexus Service Platform 07-50，uCosminexus Service Architect 07-50，uCosminexus Operator 07-50

追加・変更内容

Windows Vistaに対応した。

ウィルスチェック動作定義ファイルを削除した。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）に次のキーを追加した。

ejbserver.container.audit_trail.enabled

ejbserver.container.ejbhome.sessionbean.reconnect.enabled

ejbserver.deploy.applications.metadata_complete

webserver.context.reload_delay_timeout

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の次のキーの説明を変更した。

vbroker.se.iiop_tp.scm.iiop_tp.listener.port

usrconf.properties（サーバ管理コマンド用ユーザプロパティファイル）に次のキーを追加した。

ejbserver.cui.checkmethod.compatible

uCosminexus Application Server Standard，uCosminexus Application Server EnterpriseおよびuCosminexus Web Redirectorの適用OSから，Windows 2000 Serverを削除した。

workers.properties（ワーカ定義ファイル）に次のパラメタを追加した。

worker.<ワーカ名>.default_worker

worker.<ワーカ名>.post_data

worker.<ワーカ名>.post_size_workers

workers.properties（ワーカ定義ファイル）の次のパラメタの説明を変更した。

worker.<ワーカ名>.delegate_error_code

worker.<ワーカ名>.port

worker.<ワーカ名>.type

csecanalyz.properties（csecanalyzコマンドの動作定義ファイル）を削除した。

adminagentuser.cfg（運用管理エージェント用オプション定義ファイル）を追加した。

監査ログ定義ファイルを追加した。

Connector 1.5に準拠するリソースアダプタの対応に伴い，記述を変更した。

DB ConnectorのConnector属性のテンプレートファイルを追加した。

アプリケーション開発時に使用するファイルを，Webアプリケーションで使用するファイルに変更した。

AIX 5L V5.1のサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

uCosminexus Web Redirector

Microsoft(R) Windows(R) 2000 Advanced Server Operating System，Microsoft(R) Windows(R) 2000 Datacenter Server Operating System，およびMicrosoft(R) Windows(R) 2000 Server Operating Systemのサポート中止に伴い，これらのOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

uCosminexus Service Platform

uCosminexus Web Redirector

Microsoft(R) Windows(R) 2000 Professional Operating Systemのサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

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

uCosminexus Service Platform

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

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Web Redirector

次の製品の適用OSに，Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），およびRed Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

uCosminexus Web Redirector

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

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

変更内容（3020-3-M11-20）uCosminexus Application Server Standard 07-10，uCosminexus Application Server Enterprise 07-10，uCosminexus Developer Standard 07-10，uCosminexus Developer Professional 07-10，uCosminexus Client 07-10，uCosminexus Web Redirector 07-10，uCosminexus Service Platform 07-10，uCosminexus Service Architect 07-10，uCosminexus Operator 07-10

追加・変更機能

uCosminexus Application Server Standard，uCosminexus Application Server Enterprise，およびuCosminexus Web Redirectorの適用OSに，HP-UX（PA-RISC）を追加した。

usrconf.cfg（J2EEサーバ用オプション定義ファイル）に次のオプションを追加した。

cpp.library.version

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）に次のプロパティを追加した。

ejbserver.container.bmp.backcompatible

ejbserver.rmi.stateless.unique_id.enabled

webserver.http.request.encoding

webserver.http.response.encoding

webserver.jsp.pageEncoding

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の次のプロパティについて，設定範囲外指定時の動作およびデフォルト値を変更した。

ejbserver.deploy.context.reload_scope

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の次のプロパティの説明を変更した。

ejbserver.deploy.stub.generation.scope

ejbserver.ext.method_observation.interval

ejbserver.jndi.cache.interval.clear.option

adminagent.properties（運用管理エージェントプロパティファイル）の次のプロパティの説明を変更した。

adminagent.adapter.allowedHosts

adminagent.finalization.stop_servers

adminagent.hws.group

adminagent.hws.owner

adminagent.hws.watch.method

adminagent.<サーバ種別>.usr_cmd.abnormal_end

adminagent.<サーバ種別>.watch.retry_count

adminagent.process.consolelog.event.queue_size

adminagent.properties（運用管理エージェントプロパティファイル）に次のプロパティを追加した。

adminagent.cluster.localaddress.check

adminagent.<サーバ種別>.process.console_event.enabled

adminagent.<サーバ種別>.process.console_log.enabled

mserver.properties（Management Server環境設定ファイル）に次のプロパティを追加した。

webserver.connector.http.bind_host

mserver.properties（Management Server環境設定ファイル）の次のプロパティの説明を変更した。

mngsvr.myhost.name

Managementイベントとして通知するメッセージIDのデフォルトに，次のメッセージIDを追加した。

KDJE49650-I

KDJE49653-I

KDJE49655-E

KDJE49657-E

KDJE49660-I

KDJE49663-E

KDJE49664-E

KDJE49669-E

KDJE49671-I

.mngsvrutilrc（mngsvrutilコマンドのクライアント側定義ファイル）の次のキーの説明を変更した。

mngsvrutil.connect.host

mngsvrutil.target_name

csecanalyz.properties（csecanalyzコマンドの動作定義ファイル）の次のプロパティの説明を変更した。

csecanalyz.manager.LogFileDir

csecanalyz.command.LogFileDir

csecanalyz.agent.LogFileDir

JP1イベントIDの一覧を追加した。

ua.conf（統合ユーザ管理のコンフィグレーションファイル）のJNDI用パラメタの次のオプションを削除した。

java.naming.factory.initial

次の属性ファイルのDOCTYPE宣言のバージョンを7.1に変更した。

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

EJB-JAR属性ファイル

Session Bean属性ファイル

WAR属性ファイル

次の属性ファイルにアノテーションで設定できるタグを追加した。

EJB-JAR属性ファイル

Session Bean属性ファイル

EJB-JAR属性ファイルおよびSession Bean属性ファイルの次のタグから「-method」を削除した。

<around-invoke-method>

<post-construct-method>

<pre-destroy-method>

<post-activate-method>

<pre-passivate-method>

EJB-JAR属性ファイルおよびSession Bean属性ファイルの<around-invoke>タグに含まれるタグを<class>，<method-name>に変更した。

EJB-JAR属性ファイルおよびSession Bean属性ファイルの<post-construct>，<pre-destroy>，<post-activate>，および<pre-passivate>タグに含まれるタグを<lifecycle-callback-class>，<lifecycle-callback-method>に変更した。

EJB-JAR属性ファイルの<interceptor-binding>タグに含まれる<interceptor-class>タグの出現パターンを変更した。

次の属性ファイルの<optional-name>タグおよび<display-name>タグの説明を変更した。

Session Bean属性ファイル

Entity Bean属性ファイル

Connector属性ファイル

JavaBeansリソース属性ファイル

データソース属性ファイル

メール属性ファイル

Entity Bean属性ファイルの<prim-key-class>タグの説明を変更した。

次の属性ファイルのDOCTYPE宣言を変更した。

MessageDrivenBean属性ファイル

データソース属性ファイル

WAR属性ファイルに次のタグを追加した。

<http-request>

<http-response>

<http-request>タグおよび<http-response>タグに含まれる<encoding>タグ

<jsp>

<jsp>タグに含まれる<page-encoding>タグ

Connector属性ファイルの次のタグの説明を変更した。

<property-value>

<property-default-value>

Cosminexus DABroker Libraryを使用する場合の，Connector属性ファイルの<config-property>タグにbufferPoolSizeを追加した。

Connector属性ファイルの<config-property>タグに指定できるプロパティに，次のRARファイルの説明を追加した。

DBConnector_HiRDB_Type4_CP.rar

DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar

DBConnector_HiRDB_Type4_XA.rar

DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar

ルートリソースアダプタについて，Connector属性ファイルの<config-property>タグのdbCheckIntervalのデフォルト値を変更した。

Oracle JDBC Thin Driverを使用してOracleに接続する場合のloginTimeoutプロパティの説明を変更した。

メール属性ファイルの<reply-to>タグを削除した。

usrconf.cfg（EJBクライアントアプリケーション用オプション定義ファイル）に次のオプションを追加した。

add.library.path

cpp.libary.version

ejb.client.directory.shareable

ejb.client.ejb.log

ejb.client.log.appid

ejb.client.log.directory

ejb.client.log.stdout.enabled

jvm.type

usrconf.properties（EJBクライアントアプリケーション用ユーザプロパティファイル）の次のプロパティのデフォルト値を変更した。

ejbserver.client.ejb.log

ejbserver.client.log.appid

ejbserver.client.log.directory

ejbserver.client.log.directorynum

usrconf.properties（EJBクライアントアプリケーション用ユーザプロパティファイル）の次のプロパティの説明を変更した。

ejbserver.client.ejb.log

usrconf.properties（EJBクライアントアプリケーション用ユーザプロパティファイル）の次のプロパティに指定できるチャネル名を追加した。

ejbserver.logger.channels.define.<チャネル名>.filenum

ejbserver.logger.channels.define.<チャネル名>.filesize

usrconf.cfg（Webコンテナサーバ用オプション定義ファイル）に次のオプションを追加した。

cpp.library.version

uCosminexus Application Server Standard，uCosminexus Application Server Enterprise，およびuCosminexus Web Redirectorの適用OSに，Linux（IPF）を追加した。

Java HotSpot VMのオプションのデフォルト値を変更した。

uCosminexus Service Platformの適用OSに，AIXを追加した。

はじめに

このマニュアルは，Cosminexus（コズミネクサス）の構築・運用・アプリケーション開発で使用するファイルの形式や定義方法について説明したものです。

Cosminexusでは，次に示すプログラムプロダクトを使用してアプリケーションサーバを構築，運用します。なお，これらのプログラムプロダクトを使用して構築したシステムを，Cosminexusシステムといいます。

P-1J43-7D71　uCosminexus Application Server Standard

P-1J43-7K71　uCosminexus Application Server Enterprise

P-1J43-7M71　uCosminexus Web Redirector

P-1M43-7D71　uCosminexus Application Server Standard

P-1M43-7K71　uCosminexus Application Server Enterprise

P-1M43-7M71　uCosminexus Web Redirector

P-1M43-7S71　uCosminexus Service Platform

P-2443-7D74　uCosminexus Application Server Standard

P-2443-7E74　uCosminexus Developer Standard

P-2443-7F74　uCosminexus Developer Professional

P-2443-7H74　uCosminexus Client

P-2443-7K74　uCosminexus Application Server Enterprise

P-2443-7M74　uCosminexus Web Redirector

P-2443-7S74　uCosminexus Service Platform

P-2443-7T74　uCosminexus Service Architect

P-2443-7U74　uCosminexus Operator

P-9D43-7D71　uCosminexus Application Server Standard

P-9D43-7K71　uCosminexus Application Server Enterprise

P-9D43-7M71　uCosminexus Web Redirector

P-9D43-7S71　uCosminexus Service Platform

P-9S43-7D71　uCosminexus Application Server Standard

P-9S43-7K71　uCosminexus Application Server Enterprise

P-9S43-7M71　uCosminexus Web Redirector

P-9S43-7S71　uCosminexus Service Platform

P-9V43-7D71　uCosminexus Application Server Standard

P-9V43-7K71　uCosminexus Application Server Enterprise

P-9V43-7M71　uCosminexus Web Redirector

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

Cosminexus Component Container

Cosminexus Component Container - Client

Cosminexus Operator Plug-in

Cosminexus Component Container - Redirector

Cosminexus Component Transaction Monitor

Cosminexus DABroker Library

Cosminexus Developer's Kit for Java

Cosminexus Performance Tracer

Cosminexus TPBroker

なお，オペレーティングシステム（OS）の種類によって，機能が異なる場合があります。OSごとの違いがある場合の表記方法については，「適用OSの違いによる機能相違点の表記」を参照してください。

対象読者

このマニュアルは，J2EEに準拠したアプリケーションを実行するためのシステムを構築，運用する方，またはアプリケーションを開発する方を対象としています。

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

システムを設計，構築または運用する方

OS（WindowsまたはUNIX）のシステム構築および運用に関する知識

J2EEに関する知識

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

CORBAに関する基本的な知識

JP1連携機能を使用する場合は，次の内容も理解されていることを前提とします。

JP1の統合管理，ジョブ管理，ネットワーク管理およびアベイラビリティ管理に関する基本的な知識

アプリケーションを開発する方

WindowsまたはUNIXの基本操作に関する知識

Javaによるプログラム開発に関する基本的な知識

使用するIDEに関する基本的な知識

また，このマニュアルは，マニュアル「Cosminexus　機能解説」を理解していることを前提としていますので，あらかじめお読みいただくことをお勧めします。

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　ファイルの概要

Cosminexusで使用するファイルの種類，記述規則，文法の記述形式について説明しています。

第2章　J2EEサーバで使用するファイル

J2EEサーバで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第3章　バッチサーバで使用するファイル

バッチサーバで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第4章　サーバ管理コマンドで使用するファイル

サーバ管理コマンドで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第5章　J2EEアプリケーションとリソースの設定で使用する属性ファイル

J2EEアプリケーションとリソースの設定で使用する属性ファイルについて説明しています。

第6章　CTMで使用するファイル

CTMで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第7章　Webサーバ連携で使用するファイル

Webサーバで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第8章　Cosminexus Managerで使用するファイル

Cosminexus Managerで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第9章　ログの運用で使用するファイル

ログの運用で使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第10章　監査ログの設定で使用するファイル

監査ログの設定で使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第11章　統合ユーザ管理で使用するファイル

統合ユーザ管理で使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第12章　Javaアプリケーションで使用するファイル

Javaアプリケーションで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第13章　Webアプリケーションで使用するファイル

Webアプリケーションで使用するファイルについて説明しています。

第14章　Cosminexus DABroker Libraryで使用するファイル

Cosminexus DABroker Libraryで使用するファイルの形式，格納先，機能，指定できる環境変数などについて説明しています。

第15章　Webコンテナサーバで使用するファイル

Webコンテナサーバで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明しています。

第16章　JavaVM起動オプション

JavaVM起動オプションについて説明しています。

付録A　拡張MIBオブジェクト定義ファイル

SNMP連携用形式ファイルをMIBオブジェクトに変換する場合に使用する拡張MIBオブジェクト定義ファイルについて説明しています。

付録B　Webアプリケーション用DD（web.xml）

拡張子とMIMEタイプの対応一覧を示しています。

関連マニュアル

Cosminexusのマニュアル体系について，次の図に示します。

マニュアル体系図で示した関連マニュアルについて，それぞれの位置づけを次に示します。

Cosminexus　概説

Cosminexusの製品概要について説明しています。

Cosminexus　機能解説

Cosminexus Component Containerの機能を中心に，uCosminexus Application Serverの概要と提供する機能について説明しています。

Cosminexus　システム設計ガイド

システム設計時に，システムの目的に応じたシステム構成や運用方法を検討するための指針について説明しています。また，チューニングの方法についても説明しています。

Cosminexus　簡易構築・運用ガイド

セットアップウィザードおよびSmart Composer機能を使用して，システムを構築・運用する手順について説明しています。また，セットアップウィザードおよびSmart Composer機能が提供するコマンドやファイルについても説明しています。

Cosminexus　システム構築ガイド

システム構築時に必要な機能の設定方法について説明しています。

Cosminexus　システム運用ガイド

Cosminexusを使用したシステムの運用方法のうち，Smart Composer機能を使用する運用以外の方法について説明しています。

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

Cosminexus Component Containerのサーバ管理コマンド，およびServer Plug-inを使用した操作について説明しています。

Cosminexus　運用管理操作ガイド

Cosminexus Component Containerの運用管理ポータルの使用方法について説明しています。

Cosminexus　リファレンス　コマンド編

Cosminexusのシステムを構築・運用するときに使用するコマンドについて説明しています。

Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編，Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編，Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編

Cosminexusで出力されるメッセージについて説明しています。

Hitachi Web Server

Hitachi Web Server（Webサーバ）の構築，管理方法について説明しています。

TPBroker　ユーザーズガイド

Cosminexus TPBrokerの概要，機能，運用方法について説明しています。

Cosminexus Reliable Messaging

Cosminexus RMを使用したメッセージの非同期通信によるアプリケーションの連携方法について説明しています。

Cosminexus　アプリケーション開発ガイド

構築したCosminexusのシステムで動作させる，アプリケーションの開発方法について説明しています。

Cosminexus　リファレンス　API編

アプリケーションの開発で使用するAPIおよびタグについて説明しています。

また，マニュアル体系図に示したマニュアル以外で，このマニュアルと関連するマニュアルを次に示します。必要に応じてお読みください。

Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド（3000-3-936）

Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス（3000-3-937）

DABroker for C++（3020-6-032）

スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用）（3000-6-276）

スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド（3020-6-356）

なお，このマニュアルでは，次のマニュアルについて，対象OSおよびバージョン番号を省略して表記しています。マニュアルの正式名称とこのマニュアルでの表記を次の表に示します。

正式名称 | このマニュアルでの表記
スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用） | HiRDB Version 7 UAP開発ガイド | HiRDB UAP開発ガイド
スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド | HiRDB Version 8 UAP開発ガイド

マニュアル体系の変更について

07-00以降では，06-70のマニュアル「Cosminexus Version 6　リファレンス（Windows(R)用）（3020-3-E56）」と「Cosminexus Version 6　リファレンス（UNIX(R)用）（3000-3-987）」の内容を3分冊して，マニュアル体系を変更しました。

目次構成の対応は次のようになっています。

06-70のマニュアル | 07-00以降のマニュアル
第1編　コマンド | マニュアル「Cosminexus　リファレンス　コマンド編」へ移動
第2編　ファイル | マニュアル「Cosminexus　リファレンス　定義編」へ移動
第3編　オプション | マニュアル「Cosminexus　リファレンス　定義編」へ移動
第4編　API／タグライブラリ | マニュアル「Cosminexus　リファレンス　API編」へ移動
付録A　ログ出力のデフォルトの設定 | 削除
付録B　TPBrokerの運用支援機能用定義ファイル | 削除
付録C　Naming Manager定義ファイル | 削除
付録D　拡張MIBオブジェクト定義ファイル | マニュアル「Cosminexus　リファレンス　定義編」へ移動
付録E　CMPのマッピング一覧 | 削除
付録F　Webアプリケーション用DD（web.xml） | マニュアル「Cosminexus　リファレンス　定義編」へ移動
付録G　csecanalyzコマンドによるシステムのセキュリティ設定のチェック内容 | 削除
付録H　dabsetup（Cosminexus DABroker Libraryのセットアップ）※ | マニュアル「Cosminexus　リファレンス　コマンド編」へ移動

注※

マニュアル「Cosminexus Version 6　リファレンス（UNIX(R)用）」だけにある目次項目です。

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

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

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

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

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

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

このマニュアルでの表記

表記 | 製品名
Application Server | Application Server Enterprise | uCosminexus Application Server Enterprise
Application Server Standard | uCosminexus Application Server Standard
Developer | Developer Professional | uCosminexus Developer Professional
Developer Standard | uCosminexus Developer Standard
HiRDBまたはHiRDBサーバ | HiRDB/Parallel Server | HiRDB/Parallel Server Version 7
HiRDB/Parallel Server Version 8
HiRDB/Single Server | HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
HiRDB Run TimeまたはHiRDBクライアント | HiRDB/Run Time Version 7
HiRDB/Run Time Version 8
IPF | Itanium(R) Processor Family
JP1/Cm2 | JP1/Cm2/ESA | JP1/Cm2/Extensible SNMP Agent
JP1/Cm2/ESA for Extension Mib Runtime | JP1/Cm2/Extensible SNMP Agent for Extension Mib Runtime
JP1/IM | JP1/IM - Central Console | JP1/Integrated Manager - Central Console
JP1/IM - CM | JP1/Integrated Management - Central Information Master
JP1/Integrated Manager - Central Information Master
JP1/IM - Central Scope | JP1/Integrated Manager - Central Scope
JP1/IM - Manager | JP1/Integrated Management - Manager
JP1/IM - View | JP1/Integrated Management - View
JP1/Integrated Manager - View
JP1/NETM/Audit | JP1/NETM/Audit - Manager
Microsoft IIS | Microsoft IIS 6.0 | Microsoft(R) Internet Information Services 6.0
Oracle | Oracle9i | Oracle9i
Oracle9i R2
Oracle10g | Oracle 10g
Oracle 10g R2
SQL Server | SQL Server 2000 | Microsoft(R) SQL Server(TM) 2000
SQL Server 2005 | Microsoft(R) SQL Server(TM) 2005
SQL ServerのJDBCドライバ | SQL Server 2000 Driver for JDBC | Microsoft(R) SQL Server(TM) 2000 Driver for JDBC
SQL Server 2005 JDBC Driver | Microsoft(R) SQL Server(TM) 2005 JDBC Driver
UNIX | AIX | AIX 5L V5.2
AIX 5L V5.3
HP-UXまたはHP-UX（IPF） | HP-UX 11i V2（IPF）
HP-UX 11i V3（IPF）
Linux | Linux（IPF） | Red Hat Enterprise Linux AS 3（IPF）
Red Hat Enterprise Linux AS 4（IPF）
Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium）
Linux（x86／AMD64 & Intel EM64T） | Red Hat Enterprise Linux AS 3（x86）
Red Hat Enterprise Linux AS 4（x86）
Red Hat Enterprise Linux 5 Advanced Platform（x86）
Red Hat Enterprise Linux ES 3（x86）
Red Hat Enterprise Linux ES 4（x86）
Red Hat Enterprise Linux 5（x86）
Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64）
Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5（AMD/Intel 64）
Solaris | Solaris 9
Solaris 10
Web Redirector | uCosminexus Web Redirector
Windows Server 2003 | Windows Server 2003 Enterprise Edition | Microsoft(R) Windows Server(R) 2003，Enterprise Edition Operating System（x86）
Windows Server 2003 Standard Edition | Microsoft(R) Windows Server(R) 2003，Standard Edition Operating System（x86）
Windows Server 2003 R2 | Windows Server 2003 R2 Enterprise Edition | Microsoft(R) Windows Server(R) 2003 R2，Enterprise Edition Operating System（x86）
Windows Server 2003 R2 Standard Edition | Microsoft(R) Windows Server(R) 2003 R2，Standard Edition Operating System（x86）
Windows Server 2003（x64） | Windows Server 2003 Enterprise x64 Edition | Microsoft(R) Windows Server(R) 2003，Enterprise x64 Edition Operating System
Windows Server 2003 Standard x64 Edition | Microsoft(R) Windows Server(R) 2003，Standard x64 Edition Operating System
Windows Server 2003 R2（x64） | Windows Server 2003 R2 Enterprise x64 Edition | Microsoft(R) Windows Server(R) 2003 R2，Enterprise x64 Edition Operating System
Windows Server 2003 R2 Standard x64 Edition | Microsoft(R) Windows Server(R) 2003 R2，Standard x64 Edition Operating System
Windows Vista | Windows Vista Business | Microsoft(R) Windows Vista(R) Business
Windows Vista Enterprise | Microsoft(R) Windows Vista(R) Enterprise
Windows Vista Ultimate | Microsoft(R) Windows Vista(R) Ultimate
Windows XP | Microsoft(R) Windows(R) XP Professional Operating System
XDM/RD E2 | VOS3 XDM/RD E2

なお，Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Vista，およびWindows XPを総称してWindowsと表記することがあります。

また，Linuxに関しては，バージョンごとに次のように表記することがあります。

表記 | OS名
Red Hat Enterprise Linux 3 | Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 3（IPF）
Red Hat Enterprise Linux AS 3（x86）
Red Hat Enterprise Linux ES 3（x86）
Red Hat Enterprise Linux 4 | Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 4（IPF）
Red Hat Enterprise Linux AS 4（x86）
Red Hat Enterprise Linux ES 4（x86）

このマニュアルで使用している表記と，対応するCosminexusの機能名を次に示します。

表記 | Cosminexusの機能名
Cosminexus Developer's Kit for Java | Cosminexus Developer's Kit for JavaTM
Cosminexus RM | Cosminexus Reliable Messaging
CTM | Cosminexus Component Transaction Monitor
DB Connector for Cosminexus RM | DB Connector for Cosminexus Reliable Messaging
Management Server | Cosminexus Management Server
PRF | Cosminexus Performance Tracer
Server Plug-in | Cosminexus Server Plug-in
Smart Composer | Cosminexus Smart Composer
TPBroker | Cosminexus TPBroker

このマニュアルで使用している表記と，対応するJava関連用語を次に示します。

表記 | Java関連用語
Connector 1.0 | J2EETM Connector Architecture 1.0
Connector 1.5 | J2EETM Connector Architecture 1.5
DI | Dependency Injection
EAR | Enterprise ARchive
EJBまたはEnterprise JavaBeans | Enterprise JavaBeansTM
EJB QL | EJBTM Query Language
J2EEまたはJava 2 Platform, Enterprise Edition | JavaTM 2 Platform, Enterprise Edition
J2SE | JavaTM 2 Platform, Standard Edition
JAAS | JavaTM Authentication and Authorization Service
JAR | JavaTM Archive
Java | JavaTM
Java 2 Runtime Environment, Standard Edition | JavaTM 2 Runtime Environment, Standard Edition
Java 2 SDK, Standard Edition | JavaTM 2 Software Development Kit, Standard Edition
JavaBeans | JavaBeansTM
JavaMail | JavaMailTM
JAXP | JavaTM API for XML Processing
JCA | J2EETM Connector Architecture
JCE | JavaTM Cryptography Extension
JDBC | JDBCTM
JavaTM Database Connectivity
JDK | JavaTM Development Kit
JMS | JavaTM Message Service
JNDI | Java Naming and Directory InterfaceTM
JNI | JavaTM Native Interface
JSF | JavaServerTM Faces Reference Implementation (RI) Version: 1.1_01 FCS
JSP | JavaServer PagesTM
JTA | JavaTM Transaction API
JTS | JavaTM Transaction Service
Servletまたはサーブレット | JavaTM Servlet
WAR | Web ARchive

適用OSの違いによる機能相違点の表記

このマニュアルは，適用OSがWindows，AIX，HP-UX，Linux，およびSolarisの製品に対応します。OSによって記述を書き分ける場合，次に示す表記を使用して，それぞれの説明にOS名を明記しています。

表記 | 意味
Windowsの場合 | Windowsに該当する表記です。
AIXの場合 | AIXに該当する表記です。
HP-UXの場合 | HP-UXに該当する表記です。
Linuxの場合 | Linuxに該当する表記です。
Solarisの場合 | Solarisに該当する表記です。
UNIXの場合 | UNIX（AIX，HP-UX，Linux，Solaris）に該当する表記です。

このマニュアルで使用している略語

このマニュアルで使用している英略語を次に示します。

英略語 | 英字での表記
API | Application Programming Interface
ASCII | American Standard Code for Information Interchange
BMP | Bean-Managed Persistence
BMT | Bean-Managed Transaction
CA | Certification Authority
CMP | Container-Managed Persistence
CMR | Container-Managed Relationship
CMT | Container-Managed Transaction
CORBA | Common Object Request Broker Architecture
CPU | Central Processing Unit
CR | Carriage Return
CRL | Certificate Revocation List
CSR | Certificate Signing Request
CSV | Comma Separated Value
CUI | Character User Interface
DB | Database
DBMS | Database Management System
DD | Deployment Descriptor
DIT | Directory Information Tree
DMZ | Demilitarized Zone
DN | Distinguished Name
DNS | Domain Name System
DoS | Denial of Service attack
DTD | Document Type Definition
EIS | Enterprise Information System
EJB QL | EJB Query Language
EUC | Extended UNIX Code
FF | Form Feed
GC | Garbage Collection
GUI | Graphical User Interface
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
HTTPS | Hyper Text Transfer Protocol Security
IDE | Integrated Development Environment
IIOP | Internet Inter-Orb Protocol
ISAPI | Internet Server Application Programming Interface
ISO | International Organization for Standardization
JAR | Java Archive
JDBC | Java Database Connectivity
JIS | Japanese Industrial Standards
LAN | Local Area Network
LDAP | Lightweight Directory Access Protocol
LDIF | LDAP Data Interchange Format
LF | Line Feed
MDA | Model Driven Architecture
MIB | Management Information Base
OID | Object Identifier
OMG | Object Management Group
ORB | Object Request Broker
OS | Operating System
OTS | Object Transaction Service
PIM | Platform Independent Model
POA | Portable Object Adapter
PSM | Platform Specific Model
RAC | Real Application Clusters
RDB | Relational Database
RMI | Remote Method Invocation
RPC | Remote Procedure Call
SFO | Session Fail Over
SHA | Secure Hash Algorithm
SOA | Service Oriented Architecture
SOAP | Simple Object Access Protocol
SPI | Service Provider Interface
SPP | Service Providing Program
SSL | Secure Sockets Layer
TCS | Transaction Context Server
UDDI | Universal Description, Discovery and Integration
UNC | Universal Naming Convention
URI | Uniform Resource Identifier
URL | Uniform Resource Locator
UTC | Universal Time Coordinated
UTF | UCS Transformation Format
VM | Virtual Machine
WSDL | Web Service Description Language
XML | Extensible Markup Language

このマニュアルで使用している記号

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

記号
意　味

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

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

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

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

<　>
この記号で囲まれている項目は，該当する要素を指定することを示します。
（例）　<プロパティ>
　プロパティを記述します。

　...
この記号の直前に示す記号を繰り返し，複数個指定できることを示します。
（例）　<プロパティ>...
　プロパティは複数個，繰り返して指定できます。

このマニュアルで使用している構文要素

このマニュアルで使用する構文要素の種類を次に示します。

種類 | 定義
英字 | A～Z　a～z
英小文字 | a～z
英大文字 | A～Z
数字 | 0～9
英数字 | A～Z　a～z　0～9
記号 | !　"　#　$　%　&　'　(　)　+　,　_　・　.　/　:　;　<　=　>　@　[　]　^　－　｛　｝　￣　タブ　空白

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

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次に示す用語については，常用漢字以外の漢字を使用しています。

鍵（かぎ）　個所（かしょ）　伝播（でんぱ）　必須（ひっす）　雛型（ひながた）　閉塞（へいそく）　漏洩（ろうえい）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）は，それぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1.　ファイルの概要

この章では，Cosminexusで使用するファイルの種類，記述規則，文法の記述形式について説明します。

＜この章の構成＞

1.1　ファイルの種類

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

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

1.1　ファイルの種類

ここでは，Cosminexusで使用するファイルの種類について説明します。

Cosminexusでは，実行するアプリケーションの種類によって使用できるファイルが異なります。このマニュアルでは，ファイルを次の四つに分類しています。

J2EEアプリケーションを実行するシステムで使用するファイル

バッチアプリケーションを実行するシステムで使用するファイル

Javaアプリケーションを実行するシステムで使用するファイル

Webアプリケーションを実行するシステムで使用するファイル

それぞれのファイルについて次の表に示します。

表1-1　J2EEアプリケーションを実行するシステムで使用するファイル

ファイルの種類
ファイルの説明
参照先

J2EEサーバで使用するファイル
J2EEサーバが使用するJavaVMのプロパティやJ2EEサーバの起動オプションなどを設定するファイルです。
例：usrconf.properties，usrconf.cfg※
2章

サーバ管理コマンドで使用するファイル
サーバ管理コマンド実行時のJavaVMのプロパティやサーバ管理コマンドの動作を設定するファイルです。
例：usrconf，usrconf.bat
4章

J2EEアプリケーションとリソースの属性ファイル
J2EEアプリケーションやリソースを設定する場合に，属性情報を設定するファイルです。
例：アプリケーション統合属性ファイル
5章

CTMで使用するファイル
CTMを使用してリクエストのスケジューリングや負荷分散をする場合に，CTMで使用する環境変数やコマンドのオプションなどを設定するファイルです。
例：CTMユーザ環境変数定義ファイル

なお，CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。
6章

Webサーバ連携で使用するファイル
Hitachi Web Server，またはMicrosoft IISを利用してWebサーバと連携する場合に，リダイレクタやワーカの動作などを設定するファイルです。
例：mod_jk.conf，workers.properties
7章

Cosminexus Managerで使用するファイル
運用管理ドメインを管理するためのプロパティや，環境変数やログの収集先などを設定するためファイルです。
例：adminagent.properties，mserver.properties
8章

ログの運用で使用するファイル
Cosminexusのログを収集する場合に，snapshotログの収集先などを設定するファイルです。
例：snapshotlog.conf
9章

監査ログの設定で使用するファイル
監査ログのセットアップ時に，監査ログ出力時のログファイルなどを設定するファイルです。
例：auditlog.properties
10章

統合ユーザ管理で使用するファイル
統合ユーザ管理機能を使用する場合に，JAAS対応ユーザ管理やシングルサインオンの情報などを設定するファイルです。
例：jaas.conf，ua.conf
11章

Cosminexus DABroker Libraryで使用するファイル
UNIXでCosminexus DABroker Libraryを使用する場合に，Cosminexus DABroker Libraryの動作環境を設定するファイルです。
例：dasysconf
14章

注※

J2EEサーバのオプション定義ファイル（usrconf.cfg）に設定する日立固有のJavaVM拡張オプションについては，「16.　JavaVM起動オプション」を参照してください。

表1-2　バッチアプリケーションを実行するシステムで使用するファイル

ファイルの種類
ファイルの説明
参照先

バッチサーバで使用するファイル
バッチサーバが使用するJavaVMのプロパティやバッチサーバの起動オプションなどを設定するファイルです。
例：usrconf.properties，usrconf.cfg※
3章

サーバ管理コマンドで使用するファイル
サーバ管理コマンド実行時のJavaVMのプロパティやサーバ管理コマンドの動作を設定するファイルです。
例：usrconf，usrconf.bat
4章

Connector属性ファイル
リソースを設定する場合に，属性情報を設定するファイルです。
5章

Cosminexus Managerで使用するファイル
運用管理ドメインを管理するためのプロパティや，環境変数やログの収集先などを設定するためファイルです。
例：adminagent.properties，mserver.properties
8章

ログの運用で使用するファイル
Cosminexusのログを収集する場合に，snapshotログの収集先などを設定するファイルです。
例：snapshotlog.conf
9章

監査ログの設定で使用するファイル
監査ログのセットアップ時に，監査ログ出力時のログファイルなどを設定するファイルです。
例：auditlog.properties
10章

Cosminexus DABroker Libraryで使用するファイル
UNIXでCosminexus DABroker Libraryを使用する場合に，Cosminexus DABroker Libraryの動作環境を設定するファイルです。
例：dasysconf
14章

注※

バッチサーバのオプション定義ファイル（usrconf.cfg）に設定する日立固有のJavaVM拡張オプションについては，「16.　JavaVM起動オプション」を参照してください。

表1-3　Javaアプリケーションを実行するシステムで使用するファイル

ファイルの種類
ファイルの説明
参照先

Javaアプリケーションで使用するファイル
Javaアプリケーションを使用する場合に，JavaVMのプロパティや起動オプションなどを設定するファイルです。
例：usrconf.properties，usrconf.cfg※
12章

注※

Javaアプリケーションのオプション定義ファイル（usrconf.cfg）に設定する日立固有のJavaVM拡張オプションについては，「16.　JavaVM起動オプション」を参照してください。

表1-4　Webアプリケーションを実行するシステムで使用するファイル

ファイルの種類 | ファイルの説明 | 参照先
Webアプリケーションで使用するファイル | アプリケーション起動時に，アプリケーションに含まれるJSPファイルをコンパイルする場合に，コンパイル対象外にするファイルや実行結果を出力するファイルを設定するファイルです。 | 13章

参考

サーブレットエンジンモードで使用するファイルの種類を次に示します。

Webサーバ連携で使用するファイル

ログの運用で使用するファイル

統合ユーザ管理で使用するファイル

Webアプリケーションで使用するファイル

Cosminexus DABroker Libraryで使用するファイル

Webコンテナサーバで使用するファイル※

注※

サーブレットエンジンモードだけで使用できるファイルです。

サーブレットエンジンモードでWebコンテナサーバを使用する場合に，JavaVMのプロパティや起動オプションなどを設定するファイルです。

例：usrconf.properties，usrconf.cfg

ファイルについては，「15.　Webコンテナサーバで使用するファイル」を参照してください。

Webコンテナサーバのオプション定義ファイル（usrconf.cfg）に設定する日立固有のJavaVM拡張オプションについては，「16.　JavaVM起動オプション」を参照してください。

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

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

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　指定できるパラメタ

(6)　記述例

(7)　注意事項

(1)　形式

ファイルの記述形式を示します。

(2)　ファイルの格納先

ファイルの格納先を示します。

(3)　機能

ファイルの機能について説明します。

(4)　指定できるキー

ファイルの中で指定できるキーについて説明します。

(5)　指定できるパラメタ

ファイルの中で指定できるパラメタについて説明します。

(6)　記述例

ファイルの内容の記述例を示します。

(7)　注意事項

ファイルを設定または使用する際の注意事項を説明します。

参考

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

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

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

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

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

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

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

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

Windows Vistaで追加された文字にはUnicodeの補助文字が含まれます。Cosminexusで使用する定義ファイルに，Unicodeの補助文字は使用できません。

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

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

DD内の各種定義

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

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

2.　J2EEサーバで使用するファイル

この章では，J2EEサーバで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

2.1　J2EEサーバで使用するファイルの一覧

2.2　hitachi_web.properties（J2EEサーバ用Webアプリケーションプロパティファイル）

2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）

2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

2.5　server.policy（J2EEサーバ用セキュリティポリシーファイル）

2.6　criticalList.cfg（保護区リストファイル）

2.1　J2EEサーバで使用するファイルの一覧

J2EEサーバで使用するファイルの一覧を，次の表に示します。

表2-1　J2EEサーバで使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
hitachi_web.properties | J2EEサーバ用Webアプリケーションプロパティファイル | Webアプリケーション個別のプロパティを指定します。 | 2.2
usrconf.cfg | J2EEサーバ用オプション定義ファイル | J2EEサーバを実行するJavaVMの起動オプションを指定します。 | 2.3
usrconf.properties | J2EEサーバ用ユーザプロパティファイル | J2EEサーバを実行するJavaVMのシステムプロパティを指定します。 | 2.4
server.policy | J2EEサーバ用セキュリティポリシーファイル | J2EEサーバを実行するJavaVMのセキュリティポリシーを指定します。 | 2.5
criticalList.cfg | 保護区リストファイル | 保護区としてメソッドキャンセルを禁止するクラスを設定します。 | 2.6

2.2　hitachi_web.properties（J2EEサーバ用Webアプリケーションプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(1)　形式

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

(2)　ファイルの格納先

Windowsの場合
<WebアプリケーションのWEB-INFディレクトリ>¥

UNIXの場合
<WebアプリケーションのWEB-INFディレクトリ>/

(3)　機能

Webアプリケーション個別のプロパティを指定します。なお，J2EEサーバ全体でのシステムプロパティ設定は，usrconf.propertiesで指定します。usrconf.propertiesとWEB-INF/hitachi_web.propertiesで同じキーが指定されている場合は，WEB-INF/hitachi_web.propertiesの値が優先されます。

(4)　指定できるキー

指定できるキーとデフォルト値を次に示します。このキーに不正な値を指定した場合，動作は保証されません。

キー名称
内容
デフォルト値

webserver.jsp.keepgenerated
JSPファイルをコンパイルした結果得られたJavaファイルを保持するかどうかを指定します。

trueを指定した場合：

Javaファイルを保持します。

falseを指定した場合：

Javaファイルを保持しません。

false

webserver.xml.validate
タグライブラリ・ディスクリプタ（TLDファイル）がDTDで記述されたスキーマに沿って書かれているかチェックするかどうかを指定します。

trueを指定した場合：

チェックします。

falseを指定した場合：

チェックをしません。

true

(5)　記述例

webserver.jsp.keepgenerated=false
webserver.xml.validate=true

2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

(3)　機能

J2EEサーバを実行するJavaVMの起動オプションを指定します。

J2EEサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にJ2EEサーバを起動したときに反映されます。

(4)　指定できるキー

指定できるキーとデフォルト値を次の表に示します。

表2-2　usrconf.cfgに指定できるキーとデフォルト値（J2EEサーバ）

キー名称
内容
デフォルト値

add.jvm.arg
指定されたオプションを使ってJavaVMを起動します。次のJavaVMのオプションを指定できます。

-D<property>

-verbose:[class|gc|jni]

-Xloggc:<file>

-Xms<size>

-Xmx<size>

-Xmn<size>

-Xss<size>

-Xprof

-Xrunhprof[:help]|[:<option>=<value>, ...]

-Xrun<libraryName>

-Xdebug

-XX:NewRatio=<value>

-XX:PermSize=<value>

-XX:MaxPermSize=<value>

-XX:SurvivorRatio=<value>

-XX:[+|-]PrintTenuringDistribution

-XX:TargetSurvivorRatio=<value>

-XX:MaxTenuringThreshold=<value>

-XX:HitachiJavaLog:[<name>]※1

-XX:HitachiJavaLogFileSize=<size>※1

-XX:[+|-]HitachiJavaLogNoMoreOutput※1

-XX:HitachiJavaLogNumberOfFile=<size>※1

-XX:[+|-]HitachiOutOfMemoryCause※1

-XX:[+|-]HitachiOutOfMemoryStackTrace※1

-XX:HitachiJavaClassLibTraceLineSize=<size>※1

-XX:[+|-]HitachiOutputMilliTime※1

-XX:[+|-]HitachiThreadDump※1

-XX:[+|-]HitachiVerboseGC※1※2

-XX:[+|-]HitachiCommaVerboseGC※1

-XX:[+|-]HitachiVerboseGCPrintCause※1

-XX:[+|-]HitachiVerboseGCPrintDate※1

-XX:[+|-]HitachiFullCore（UNIX用のオプション）※1

-XX:[+|-]HitachiThreadDumpToStdout※1

-XX:[+|-]HitachiOutOfMemorySize※1

-XX:[+|-]HitachiOutOfMemoryAbort※1

-XX:[+|-]HitachiOutOfMemoryAbortThreadDump※1

-XX:[+|-]HitachiJavaClassLibTrace※1

-XX:HitachiJavaClassLibTraceLineSize=<size>※1

-XX:[+|-]HitachiLocalsInThrowable※1※3

-XX:[+|-]HitachiLocalsSimpleFormat※1

-XX:HitachiCallToString=<適用範囲>※1

-XX:[+|-]HitachiTrueTypeInLocals※1

-XX:[+|-]HitachiLocalsInStackTrace※1

-XX:[+|-]HitachiReserveSwapSpace（UNIX用のオプション）※1

システムプロパティを指定したい場合は，"-D"を利用しないで，usrconf.propertiesファイルに指定します。
複数のオプションを指定する場合，同じキー名称を使用して，次のように複数回指定してください。
（指定例）
add.jvm.arg= -Xms256m
add.jvm.arg= -Xmx512m
なお，次のように複数のオプションを指定できません。指定をした場合，JavaVMの初期化に失敗します。
（指定例）
add.jvm.arg=-Xms256m -Xmx512m

-Xms256m

-Xmx512m

-XX:NewRatio=2

-XX:PermSize=128m

-XX:MaxPermSize=128m

-XX:+HitachiOutOfMemoryStackTrace

-XX:HitachiJavaLog:
・Windowsの場合
<Cosminexusのインストールディレクトリ>¥ejb¥<サーバ名称>¥logs
・UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/logs

-XX:HitachiJavaLogFileSize=4m

-XX:+HitachiVerboseGC

-XX:+HitachiVerboseGCPrintCause

-XX:+HitachiOutputMilliTime

-XX:-HitachiThreadDumpToStdout

-XX:+HitachiOutOfMemoryAbort

-XX:+HitachiJavaClassLibTrace

-XX:HitachiJavaClassLibTraceLineSize =1024

-XX:+HitachiLocalsSimpleFormat

-XX:+HitachiTrueTypeInLocals

-XX:+HitachiLocalsInStackTrace

-XX:+HitachiReserveSwapSpace

add.class.path
コンテナ拡張ライブラリ用のJARを指定します。
なし

add.library.path
JNI用の共有ライブラリを指定します。コンテナ拡張ライブラリがJNIを利用する場合だけ指定します。
なし

cpp.library.version
プロセス内で使用するlibstdc++ライブラリのバージョンを指定します。なお，このキーは，Linux用です。
指定できる文字列を次に示します。

5：

libstdc++.so.5ライブラリを使用します。

6：

libstdc++.so.6ライブラリを使用します。

Red Hat Enterprise Linux 3の場合に設定できるのは「5」だけです。
Red Hat Enterprise Linux 4の場合，x64ネイティブ版を使用するときは「6」を，それ以外のときは「5」か「6」を設定できます。
Red Hat Enterprise Linux 3またはRed Hat Enterprise Linux 4以外のプラットホームで設定しても無効です。

x64ネイティブ版を使用する場合
6

それ以外を使用する場合
5

ejb.public.directory
指定されたディレクトリをJ2EEサーバの作業ディレクトリとしてJ2EEサーバを開始します。J2EEサーバのカレントディレクトリを次に示します。

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>

ディレクトリ名称は絶対パスで指定してください。指定できる文字は，半角英数字，アンダースコア（_），またはハイフン（-）です。パス長は，Cosminexusの作業ディレクトリの見積もり式で算出した範囲内で指定できます。J2EEサーバの作業ディレクトリについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥public

UNIXの場合
/opt/Cosminexus/CC/server/public

ejb.server.corefilenum（UNIX用）
J2EEサーバ再起動時に残すcoreファイルの数を0～16の整数で指定します。なお，このキーは，UNIX用です。
次の対象coreファイルのうち，作成日時が新しいのものから指定した数のファイルを残し，それ以外のファイルは削除されます。通常はJ2EEサーバダウン時に出力するcoreファイル数の1を指定します。

対象coreファイル

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/core*

再起動時にすべてのcoreファイルを削除する場合は，0を指定します。

手動による運用またはManagement Serverを使用する場合は，1以上を指定します。

対象coreファイルのうち，上書き，または削除される可能性のあるcoreファイルについては再起動時にリネームされます。

Linux（プロセスID付きの設定）の場合

core.<core生成プロセスID> → core.<core生成プロセスID>.<coreファイル作成日時>

上記以外の場合

core → core.<coreファイル作成日時>

<coreファイル作成日時>の形式は，yymmddHHMMSSです。
なお，coreファイルのリネーム，または削除に失敗した場合はメッセージKDJE40047-Eを出力し，J2EEサーバ起動処理を中止して異常終了します。
また，次のことに注意してください。

対象coreファイルと同じ名称のファイルを作成した場合はユーザが作成したファイルが削除されます。

coreファイルの削除はJ2EEサーバ再起動時に処理されるため，再起動するまでは定義数以上のcoreファイルが出力されている場合があります。

定義数+n分のcoreファイルが残るためディスク容量に注意してください（n:再起動されるまでにJ2EEサーバが出力するcoreファイル数）。

1

ejb.server.log.directory
指定されているディレクトリをログファイル※4の出力先として使用します。パス長は，1～200バイトで指定します。Windowsの場合，UNC名を含むパスは指定できません。UNIXの場合，nfsマウントされたディスク上へのパスは指定できません。
このキーを指定する場合，サーバ開始前にログ出力先ディレクトリを作成してください。存在しないディレクトリが指定された場合は，J2EEサーバ開始時にKDJE40024-Eのメッセージが出力され，異常終了します。
ほかのJ2EEサーバやWebコンテナサーバとログ出力先が，同じディレクトリにならないように注意してください。同じディレクトリを指定した場合，動作は保証されません。
なお，このキーを指定して，作業ディレクトリ以外にログを出力する場合，変更先ディレクトリ下のログファイルはサーバをアンセットアップする時に削除されません。ログファイルを削除したい場合には，手動で削除してください。

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs

ejb.server.log.mode
ログファイルの出力形態を指定します。
指定できる文字列を次に示します。

6
Version 6互換モードにします。保守用のログファイルをVersion 6以前と同じディレクトリに出力します。

7
Version 7モードにします。

なお，Version 6互換モードからVersion 7モード，またはVersion 7モードからVersion 6互換モードに変更した場合，保守用のログファイルを各モードの出力先に移動しません。ログファイルの出力モードを変更したあと，出力先変更前の保守用のログファイルは必要に応じて削除してください。
7

ejb.server.log.stdout.filesize
cjstdout.logファイルのサイズの上限値を4096～2147483647の範囲（単位：バイト）の整数で指定します。
1048576

ejb.server.log.stderr.filesize
cjstderr.logファイルのサイズの上限値を4096～2147483647の範囲（単位：バイト）の整数で指定します。
1048576

jvm.type
使用するJavaVMのタイプを指定します。指定できる値は次のどちらかです。

server
Java HotSpot(TM) Server VMが使用されます。

client
Java HotSpot(TM) Client VMが使用されます。

J2EEサーバ，またはJ2EEアプリケーションの開始および停止の頻度が高い開発環境などでは，”client”を指定することで性能が向上する場合があります。指定値に誤りがあった場合は，”server”→”client”の順でJavaVMを検索します。なお，このときKDJE40020-Wメッセージが出力されます。
AIXおよびSolarisの場合は，”server”を指定しても”client”になります。
server

注※1

JavaVM拡張オプションについては，「16.　JavaVM起動オプション」を参照してください。なお，サポートされるCosminexus Developer's Kit for Javaのバージョンは，OSによって異なります。

注※2

JavaVMの情報およびガーベージコレクションのログに，拡張verbosegc情報を出力するかどうかを指定します。

拡張verbosegc情報を出力する場合，「-XX:+HitachiVerboseGC」を指定してください。拡張verbosegc情報を出力しない場合は，「-XX:-HitachiVerboseGC」を指定してください。なお，デフォルトでは拡張verbosegc情報は出力されます。

拡張verbosegc情報を出力する場合，ガーベージコレクションの内部領域（Eden領域，Survivor領域，Tenured領域，およびPerm領域）の種別ごとに情報を出力します。なお，拡張Verbosegc情報だけを出力したい場合は，クラスライブラリのスタックトレース出力オプションを一時的に出力しないに設定することを推奨します。

JavaVMの情報およびガーベージコレクションのログに出力される拡張verbosegc情報の詳細については，「16.　JavaVM起動オプション」を参照してください。

注※3

このオプションを有効にした場合，ログファイル（cjexception?.log，user_err?.log）およびデフォルトエラーページなどのスタックトレースにローカル変数名とその内容が出力されます。また，オンライン性能が劣化します。そのため，このオプションはデバッグ時に用いることを推奨します。

注※4

次に示すログファイルが変更の対象になります。

ログの種類
内容
ログ取得ディレクトリおよびログファイル名

メッセージログ
稼働ログ

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjmessage?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjmessage?.log

ログ稼働ログ

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjlogger.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjlogger.log

ユーザログ
Webサーブレットログ

Windowsの場合
<ejb.server.log.directoryキーの値>¥web_servlet?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/web_servlet?.log

ユーザ出力ログ

Windowsの場合
<ejb.server.log.directoryキーの値>¥user_out?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/user_out?.log

ユーザエラーログ

Windowsの場合
<ejb.server.log.directoryキーの値>¥user_err?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/user_err?.log

JavaVMの保守情報およびガーベージコレクションのログ

Windowsの場合
<ejb.server.log.directoryキーの値>¥javalog??.log

UNIXの場合
<ejb.server.log.directoryキーの値>/javalog??.log

例外ログ
障害発生時の例外情報

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjexception?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjexception?.log

保守用ログ
保守情報

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjmaintenance?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjmaintenance?.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cjmaintenance?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cjmaintenance?.log

コンソールメッセージ

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjconsole?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjconsole?.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cjconsole?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cjconsole?.log

EJBコンテナの保守情報

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjejbcontainer?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjejbcontainer?.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cjejbcontainer?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cjejbcontainer?.log

Webコンテナの保守情報

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjwebcontainer?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjwebcontainer?.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cjwebcontainer?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cjwebcontainer?.log

起動プロセス標準出力情報

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjstdout.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjstdout.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cjstdout.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cjstdout.log

起動プロセス標準出力情報バックアップ

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjstdout_save.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjstdout_save.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cjstdout_save.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cjstdout_save.log

起動プロセス標準エラー情報

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjstderr.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjstderr.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cjstderr.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cjstderr.log

起動プロセス標準エラー情報バックアップ

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cjstderr_save.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cjstderr_save.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cjstderr_save.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cjstderr_save.log

終了プロセス情報

Version 6互換モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥cj_shutdown?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/cj_shutdown?.log

Version 7モード

Windowsの場合
<ejb.server.log.directoryキーの値>¥CC¥maintenance¥cj_shutdown?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/CC/maintenance/cj_shutdown?.log

リソースアダプタの保守用ログ
－

Windowsの場合
<ejb.server.log.directoryキーの値>¥connectors¥リソースアダプタの表示名?.log

UNIXの場合
<ejb.server.log.directoryキーの値>/connectors/リソースアダプタの表示名?.log

TPBrokerのトレース
TPBrokerのトレース情報

Windowsの場合
<ejb.server.log.directoryキーの値>¥TPB 配下

UNIXの場合
<ejb.server.log.directoryキーの値>/TPB 配下

（凡例）

－：該当しない。

(5)　記述例

Windowsの場合

# java vm options
add.jvm.arg=-Xms256m
add.jvm.arg=-Xmx512m
add.jvm.arg=-XX:PermSize=128m
add.jvm.arg=-XX:MaxPermSize=128m
add.jvm.arg=-XX:+HitachiVerboseGC
add.jvm.arg=-XX:HitachiVerboseGCIntervalTime=600

# ejb public directory
ejb.public.directory=c:¥workdir

# ejb.server.log.directory
ejb.server.log.directory=c:¥logdir¥servername

UNIXの場合

# java vm options
add.jvm.arg=-Xms256m
add.jvm.arg=-Xmx512m
add.jvm.arg=-XX:PermSize=128m
add.jvm.arg=-XX:MaxPermSize=128m
add.jvm.arg=-XX:+HitachiVerboseGC
add.jvm.arg=-XX:HitachiVerboseGCIntervalTime=600

# ejb public directory
ejb.public.directory=/opt/workdir

# ejb.server.log.directory
ejb.server.log.directory=/CClogs/server/servername

# ejb.server.corefilenum
ejb.server.corefilenum=3

(6)　注意事項

コマンドプロンプトで設定されているCLASSPATH環境変数は，J2EEサーバには渡りませんが，そのほかの環境変数（PATHなど）は渡ります。

OSのロケールと異なる文字エンコーディングで記述しないでください。また，OSのロケールにUTF-8を使用する場合，BOM付きUTF-8では記述しないでください。

usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は，usrconf.propertiesの値が優先されます。

2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　J2EEサーバの予約済みキー

(5)　J2EEサーバのカスタマイズ用キー

(6)　記述例

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

記載する文字はJavaの仕様に従って，ISO 8859-1 文字エンコーディングを使用してください。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

(3)　機能

J2EEサーバを実行するJavaVMのシステムプロパティを指定します。

usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は，usrconf.propertiesの値が優先されます。

J2EEサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にJ2EEサーバを起動したときに反映されます。

なお，日立のJavaVMは，J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。JDK 5.0で使用できるプロパティについては，Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

(4)　J2EEサーバの予約済みキー

J2EEサーバでは，次に示す接頭子で始まるキーを内部的に利用します。このため，アプリケーションでこれらの接頭子で始まるキーを利用してはいけません。

ejbserver.*

webserver.*

appclient.*

j2eeserver.*

(5)　J2EEサーバのカスタマイズ用キー

J2EEサーバでは，次に示すシステムプロパティのキーに値を設定することで，J2EEサーバの動作をカスタマイズできます。なお，Webコンテナ機能のサーブレットエンジンモードを使用している場合のカスタマイズ用キーについては，「15.4　usrconf.properties（Webコンテナサーバ用ユーザプロパティファイル）」を参照してください。

ここでは，キーを次の分類に分けて説明します。

ejbserver.applicationから始まるキー

ejbserver.clientから始まるキー

ejbserver.compilerから始まるキー

ejbserver.connectionpoolから始まるキー

ejbserver.connectorから始まるキー

ejbserver.containerから始まるキー

ejbserver.ctmから始まるキー

ejbserver.deployから始まるキー

ejbserver.distributedtxから始まるキー

ejbserver.DynamicStubLoadingから始まるキー

ejbserver.ejbから始まるキー

ejbserver.extから始まるキー

ejbserver.httpから始まるキー

ejbserver.instrumentationから始まるキー

ejbserver.jdbcから始まるキー

ejbserver.jndiから始まるキー

ejbserver.jtaから始まるキー

ejbserver.loggerから始まるキー

ejbserver.managementから始まるキー

ejbserver.managerから始まるキー

ejbserver.namingから始まるキー

ejbserver.rmiから始まるキー

ejbserver.serverから始まるキー

ejbserver.statefulから始まるキー

ejbserver.watchから始まるキー

ejbserver.webj2eeから始まるキー

javaから始まるキー

vbjから始まるキー

vbrokerから始まるキー

webserver.connectorから始まるキー

webserver.containerから始まるキー

webserver.contextから始まるキー

webserver.errorpageから始まるキー

webserver.httpから始まるキー

webserver.jspから始まるキー

webserver.loggerから始まるキー

webserver.sessionから始まるキー

webserver.sfoから始まるキー

webserver.staticから始まるキー

webserver.workから始まるキー

webserver.xmlから始まるキー

(a)　ejbserver.applicationから始まるキー

キー名称
内容
デフォルト値

ejbserver.application.InitTermProcessClasses
コンテナ拡張ライブラリを使用する場合に，サーバ起動・停止フックのクラス名を指定します。複数のクラスを指定する場合は，","で区切って指定してください。なお，","とクラス名の間には，空白を入れないでください。J2EEサーバ起動時には，指定した順で，サーバ起動・停止フック機能のサーバ起動フックメソッドが呼び出されます。J2EEサーバ終了時には，指定した逆順にサーバ起動・停止フック機能のサーバ停止フックメソッドが呼び出されます。
なし

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.appname
AppNameのフィールドに出力するデフォルトのアプリケーション名を0～16バイトの半角文字セットで指定します。プログラム上で，AppNameのフィールドの値が指定されていない場合，このプロパティの値がAppNameのフィールドに出力されます。
使用できる文字セットの定義を満たしているが，値の長さが制限を超えている場合，警告メッセージが出力されて，制限の長さより大きい部分のデータが切り捨てられ，制限の長さまでのデータが使用されます。
"null"という文字列が指定された場合は，空文字列""の指定として扱われ，appnameフィールドには何も表示されません。また，このプロパティからappnameに"null"という文字列の出力指定はできません。
user_app

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.count
ログファイルの面数を次の範囲の整数で指定します。

CJMessageFileHandlerを使用した場合：

2～16

CJMPMessageFileHandlerを使用した場合：

2～64

ここで指定した面数まで増加し，指定した面数に到達すると，次の番号は初めの"1"に戻ります。
同名の旧ログファイル，または同名のユーザファイルがあった場合は上書きされます。
2

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.encoding
出力する文字列のエンコーディングを0～1024バイトで指定します。省略した場合は，デフォルトのエンコーディングが使用されます。
指定された値が範囲を超えた場合，および"null"という文字列が指定された場合は，encodingの指定なし（encodingにはデフォルト値を使用する）と扱われます。nullという名称のエンコーダは使用できません。
JavaVM上でjava.nio.charset.Charset.isSupported(String charsetName)がtrueとなる文字セットで指定してください。エンコーディングに指定できる文字セットと指定する文字列については，Java標準APIのjava.nio.charset.Charsetなどの仕様に従ってください。次に指定値の例を示します。

US-ASCII：7ビットASCII（ISO646-US/Unicode charsetのBasic Latinブロック）

ISO-8859-1：ISO Latin Alphabet No. 1 （ISO-LATIN-1）

UTF-8：8ビットUCS変換形式

SJIS：Shift-JIS，日本語

EUC_JP：JIS X 0201，0208，0212，EUCエンコーディング，日本語

MS932：Windows 日本語（Windows用の指定値）

JIS0201：JIS X 0201，日本語

JIS0208：JIS X 0208，日本語

JIS0212：JIS X 0212，日本語

なお，性能劣化の原因となるため，不要なエンコーディング処理をしないでください。
null

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.filter
使用するフィルタを，パッケージ名を含むフルネームで指定します。値は0～4096バイトのクラス文字セットで指定してください。
指定されたハンドラ名称のハンドラは，ここで指定されたフィルタをReflection機能で作成して利用します。
指定された値が範囲を超えた場合，フィルタの指定はなしとみなされます。また，"null"という文字列が指定された場合は，フィルタなし（フィルタは使わない）として扱われます。
"null"という名前のフィルタを作成しないでください。
null

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.formatter
使用するフォーマッタを，パッケージ名を含むフルネームで指定します。値は0～4096バイトのクラス文字セットで指定してください。
指定できる値を次に示します。

CJMessageFileHandlerクラスに接続する場合：

com.hitachi.software.ejb.application.userlog.CJSimpleFormatterか，またはユーザ作成のFormatterクラスを指定します。

Java2-1.4標準のSimpleFormatterやXMLFormatterをCJMessageFileHandlerに指定しないでください（セパレータが改行であるため，メッセージレコードが1行で表示されません）。また，ユーザ作成のFormatterクラスを指定する場合は，改行などの制御コードを含まないメッセージを作成するフォーマッタを作成する必要があります。

Java2-1.4のHandlerクラスに接続する場合：

特に決まりはありません。

指定されたハンドラ名称のハンドラは，ここで指定されたフォーマッタをReflection機能で作成して利用します。
指定された値が範囲を超えた場合，フォーマッタの指定はなしとみなされます。また，"null"という文字列が指定された場合は，フォーマッタなし（フォーマッタは使わない）として扱われます。"null"という名前のフォーマッタを作成しないでください。
null

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.level
ログの取得レベルの上限を半角英字で指定します。指定は，Javaの定数で定義されている値で指定します。大文字と小文字は区別されます。
ここで指定した値よりも低いレベルのメッセージだけがログへ出力されます。指定できるレベルを次に示します。

OFF：ロギングをオフにするために使われる特殊なレベル

SEVERE：重大な障害を示すメッセージレベル

WARNING：潜在的な問題を示すメッセージレベル

INFO：メッセージを情報として提供するメッセージレベル

CONFIG：静的な構成メッセージのメッセージレベル

FINE：トレース情報を提供するメッセージレベル

FINER：トレースレベル2（FINEより高い）

FINEST：トレースレベル3（FINERより高い）

ALL：すべてのメッセージのログを取得

OFFとALLは特殊なレベルです。例えば，ロガーとハンドラに対してOFFを指定すると，ログのレベルに関係なくログは一切取得されません。ALLを指定すると，すべてのレベルのログが出力されます。
SEVERE

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.limit
ログファイルの容量（単位：バイト）を次の範囲の整数で指定します。

CJMessageFileHandlerを使用した場合：

8192～2147483647

CJMPMessageFileHandlerを使用した場合：

8192～16777216

ここで指定した容量まで増加し，指定した容量に到達すると次のログファイルに切り替わります。
日立トレース共通ライブラリの場合，容量チェックがメッセージの書き込み前であるため，実際の最大容量が設定値より，最大で約4200バイト超えることがあります（1バイトでも指定した容量に満たなければ，メッセージが書き込まれてしまうため）。
例えば，このキーに8192を指定した場合でout1.logの現在使用中の領域が8000バイト，空き容量が192バイトのときに4000バイトのメッセージが出力されると，メッセージはout1.logに出力されます。このため，out1.logは上限値を超えたサイズになります。
1048576

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.msgid
MsgIDのフィールドに出力するデフォルトのメッセージIDを0～21バイトの半角文字セットで指定します。プログラム上で，MsgIDの値が指定されていない場合，このプロパティの値がMsgIDのフィールドに出力されます。
使用できる文字セットの定義を満たしているが，値の長さが制限を超えている場合，警告メッセージが出力されて，制限の長さより大きい部分のデータが切り捨てられ，制限の長さまでのデータが使用されます。
"null"という文字列が指定された場合は，空文字列""の指定として扱われ，msgidフィールドには何も表示されません。また，このプロパティからmsgidに"null"という文字列の出力指定はできません。
0001

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.path
ログファイル名のプリフィックスを1～255バイトの範囲で指定します。パスは，相対パスで指定します※2。なお，パス名の終端に，半角数値を指定しないでください。
ここで指定したプリフィックスに"xx（1～16の整数）.log"が付加された値が，トレース情報ファイルの名称になります。
パスに指定された半角英文字の大文字と小文字は区別されません。また，パス値の長さは，次のA+B+C値の合計が値の範囲に収まるよう指定してください。

A（Windowsの場合）：<ログ出力先ルート(ejb.server.log.directoryの値)>¥user¥（デフォルトは<Cosminexus作業ディレクトリ>¥ejb¥<J2EEサーバ名>¥logs¥user¥）

A（UNIXの場合）：<ログ出力先ルート(ejb.server.log.directoryの値)>/user/（デフォルトは<Cosminexus作業ディレクトリ>/ejb/<J2EEサーバ名>/logs/user/）

B：ユーザの指定したプリフィックスの長さ

C："xx.log"の6文字

このほか，パスを指定するときには次の点に注意してください。

Propertiesファイルにはnativeの2バイトコードなどは使用できないため，native2asciiなどを利用してUnicodeの文字列を取得して指定してください。

絶対パスで指定しないでください。また，相対パスの"..¥"（UNIXの場合，"../"）は使用しないでください。

パスに日本語文字などを含む場合は，その文字を処理できるロケール設定がされている環境下でJavaVMが動作している必要があります。

パスをほかのハンドラと同一に設定することはできません。そのような設定にした場合，そのハンドラは作成されません。

user_log

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.separator
CJSimpleFormatterを利用して，1文でメッセージを出力するためのセパレータを0～1024バイトの半角文字セットで指定します。セパレータは文字列で指定できます。
使用できる文字セットの定義を満たしているが，値の長さが制限を超えている場合，警告メッセージが出力されて，制限の長さより大きい部分のデータが切り捨てられ，制限の長さまでのデータが使用されます。
日立トレース共通ライブラリ形式の出力の場合，メッセージ内に次の制御文字を指定しないでください。

Windowsの場合："¥r"，"¥n"など

UNIXの場合："/r"，"/n"など

これらの文字を指定した場合，出力内容がずれたり，1レコードが1行で出力されなくなったりします。"null"という文字列が指定された場合は，空文字列""の指定として扱われます。そのため，セパレータに"null"という文字列は使用できません。また，このプロパティからセパレータに"null"という文字列の出力指定はできません。
|（ストローク）

ejbserver.application.userlog.loggers
使用するロガーの名称を宣言するプロパティです。0～65535バイトで指定します。","で区切ることで，複数のロガー名称を指定できます。また，ロガー名称のすぐ後ろに，";"で区切ってそのロガーで使用する地域対応化用リソースバンドル名称を指定できます。
なお，ロガー名称には，java.netまたはjavax.swingのように"."で区切られ，サブシステムのパッケージ名またはクラス名に基づいた名前が推奨されています。※3また，ロガーの名称には","や";"を使用しないでください。
複数のクラス名を定義しており，指定された値の長さが範囲を超えた場合は，長さの範囲内に収まり，値の規則を満たしたクラス名だけが設定されます。
ここで宣言された名称のロガーは，CJLogManagerクラスのロガー構築対象として処理されます（J2EEサーバの起動時にロガーが構築されます）。
ここで指定しなかったロガーについては，自動生成されないため，コード上でロガーを作成してください。
なし

ejbserver.application.userlog.Logger.<ロガー名称>※3.filter
ロガーで使用するフィルタを，パッケージ名を含むフルネームで指定するプロパティです。値は0～4096バイトのクラス文字セットで指定してください。
指定されたロガー名称のロガーは，ここで指定されたフィルタをReflection機能で作成してメッセージの取捨選択に利用します。
指定された値が範囲を超えた場合，フィルタの指定はなしとみなされます。また，"null"という文字列が指定された場合は，フィルタなし（フィルタを使わない）として扱われます。"null"という名前のフィルタを作成しないでください。
null

ejbserver.application.userlog.Logger.<ロガー名称>※3.handlers
指定のロガー名称に対して，ハンドラクラスを接続（addHandler(Handler)）するためのプロパティです。ハンドラクラスは，Reflection機能で作成するため，0～65535バイトのパッケージ名を含むフルネームで指定してください。","で区切ることで複数のハンドラクラスを指定できます。
指定できるハンドラクラスを次に示します。

com.hitachi.software.ejb.application.userlog.CJMessageFileHandler

com.hitachi.software.ejb.application.userlog.CJMPMessageFileHandler

java.util.logging.ConsoleHandler

java.util.logging.FileHandler

java.util.logging.SocketHandler

java.util.logging.StreamHandler

java.util.logging.MemoryHandler

ユーザが独自に作成したHandlerクラスのパッケージ名を含むフルネーム

CJLogHandler系の場合は，ハンドラクラス名の後ろに";"で区切ってハンドラ名称を指定することで，指定のハンドラ名称の設定で初期化してハンドラクラスを作成し，ロガーに接続します。Java2-1.4標準のLoggingクラスについては，";"で区切ってハンドラ名称を指定しても無効になります。Java2-1.4標準のLoggingクラスの設定方法については，該当するクラスの仕様に従ってください。
ハンドラ名称は，半角英数字で始まる1～1024バイトのクラス文字セットで指定してください。
複数のクラス名を定義しており，指定された値の長さが範囲を超えた場合は，長さの範囲内に収まり，値の規則を満たしたクラス名だけが設定されます。
ejbserver.application.userlog.loggersでロガー名称が指定されていない場合，ロガーは作成されません。
なし

ejbserver.application.userlog.Logger.<ロガー名称>※3.level
ロガーのログ出力レベルまたは"null"を半角英字で指定します。大文字と小文字は区別されます。ログメッセージを出力するためには，ロガーのログ出力レベルと出力に利用するハンドラの出力レベルをクリアしている必要があります。指定できる値を次に示します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.levelに指定できる値

"null"

"null"という名称が指定された場合，ロガーのレベルをnullで初期化します。ロガーのレベルが"null"で初期化された場合，そのロガーは親ロガーのレベルを継承します。
SEVERE

ejbserver.application.userlog.Logger.<ロガー名称>※3.useParentHandlers
ログレコードを受け取ったロガーから，親ロガーの接続しているハンドラへログレコードを伝播させるかどうかを半角英字で指定します。伝播させる場合はtrueを，伝播させない場合はfalseを指定してください。
このロガーを通過したログの出力レベルは，親ロガーの接続しているハンドラのレベルにだけ影響されます（親ロガーのレベルがOFF，親ロガーが接続しているハンドラのレベルがALLの場合，すべてのメッセージは表示されます）。
true

注

ユーザログ機能についてのプロパティ定義（ejbserver.application.InitTermProcessClassesキー以外）で使用するそれぞれの文字セットで指定できる値は，次のとおりです。

クラス文字セット（クラス名の定義に使用する文字セット）
半角英数字（a～z，A～Z，0～9），ピリオド（.），ドル記号（$）およびアンダースコア（_）

半角文字セット
半角英数字（a～z，A～Z，0～9），ピリオド（.），ドル記号（$），アンダースコア（_），ハイフン（-），ストローク（|），コロン（:），アンパサンド（&），単価記号（@），シャープ（#）およびパーセント（%）

指定した値が，使用できる文字セットの条件を満たさない，または指定できる値の範囲を満たさない不正な値の場合は，警告メッセージが出力され，その時点で有効なデフォルトの値が採用されます。その時点で有効なデフォルトの値とは，<ハンドラ名称>=defaultの場合のそのキーの値，または「デフォルト値」欄のデフォルト値を指します。

注※1

ハンドラ名称はプロパティの値を区別するために使用します。半角英数字で始まる1～1024バイトのクラス文字セットで指定してください。"default"を指定した場合は，すべてのCJLogHandlerが共通のデフォルト値として認識するプロパティを示します。

注※2

出力先の起点は，次の規則に従ってください。

<ejb.server.log.directoryの値>¥user，または<ejb.server.log.directoryの値>/user

ejb.server.log.directoryの値は，ejb.server.log.directoryの仕様に従ってください。J2EEサーバのejb.server.log.directoryのデフォルトの値を次に示します。

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<J2EEサーバ名>¥user¥<ユーザ指定値>

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<J2EEサーバ名>/user/<ユーザ指定値>

注※3

ロガー名称は，Logger.getLogger(<ロガー名称>)でロガーのインスタンスを取得するときに指定する"."付きの名称で，あらかじめ，ejbserver.application.userlog.loggersプロパティで宣言する必要があります。ロガー名称については，java.util.logging.Loggerの仕様に従ってください。

半角英数字で始まる1～1024バイトのクラス文字セットで指定してください。"default"を指定した場合は，すべてのCJLogHandlerが共通のデフォルト値として認識するプロパティを示します。

なお，ロガー名称で識別されるプロパティは，ユーザログ機能のロガークラスの初期化で使用されます。

ロガー名称の最後を.handlersで終了させた場合，ejbserver.application.userlog.Logger.<ロガー名称>.handlersのプロパティ指定時に紛らわしくなるため，ロガー名称は".handlers"で終了させないことを推奨します。

(b)　ejbserver.clientから始まるキー

キー名称 | 内容 | デフォルト値
ejbserver.client.ctm.RequestPriority | CTM内のキューに滞留したリクエストを引き出す時のプライオリティ（優先順位）を1～8の整数で指定します。指定値が小さいほどプライオリティは高くなります。指定値が誤っている場合，または省略した場合は，4が設定されます。 | 4

(c)　ejbserver.compilerから始まるキー

キー名称
内容
デフォルト値

ejbserver.compiler.jvm.maxHeapSize
J2EEアプリケーション開始時に起動されるjavacコマンドのヒープサイズの最大値を指定します。
指定する値は，javaコマンドの-Xmx，-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。

2048～4294966272の値を指定してください。ただし，ejbserver.compiler.jvm.minHeapSizeに指定した以上の値にしてください。

キロバイト単位で指定する場合は，文字「k」または「K」を付けて指定してください。

メガバイト単位で指定する場合は，文字「m」または「M」を付けて指定してください。

256m

ejbserver.compiler.jvm.minHeapSize
J2EEアプリケーション開始時に起動されるjavacコマンドのヒープサイズの初期値を指定します。
指定する値は，javaコマンドの-Xmx，-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。

1024～-Xmx指定値の値を指定してください。

キロバイト単位で指定するには，文字「k」または「K」を付けて指定してください。

メガバイト単位で指定するには，文字「m」または「M」を付けて指定してください。

32m

(d)　ejbserver.connectionpoolから始まるキー

キー名称
内容
デフォルト値

ejbserver.connectionpool.applicationAuthentication.disabled
コンテナ管理のサインオンの最適化機能を有効にするかどうかを指定します。

trueを指定した場合：

コンテナ管理のサインオンが最適化された動作となります。ただし，これを指定した場合，アプリケーション管理によるサインオンは使用できません。

falseを指定した場合：

コンテナ管理のサインオンは最適化されません。コンテナ管理によるサインオン，およびアプリケーション管理によるサインオンを使用できます。

なお，DB Connector以外のリソースアダプタを使用する場合には，このプロパティにtrueを指定することはできません。
false

ejbserver.connectionpool.association.enabled
1.4モードの場合に，コネクションアソシエーション機能を有効にするかどうかを指定します。

trueを指定した場合：

コネクションアソシエーション機能を有効にします。

falseを指定した場合：

コネクションアソシエーション機能を無効にします。

false

ejbserver.connectionpool.association.enabledDespiteUnshareableSetting
サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合に，コネクションアソシエーションを行うかどうかを指定します。

trueを指定した場合：

サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合でも，コネクションアソシエーションを行います。ただし，ejbserver.connectionpool.association.enabled=trueが指定されている必要があります。

falseを指定した場合：

サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合，コネクションアソシエーションを行いません。

Cosminexus 06-50より前のバージョンで動作実績のあるアプリケーションを，Cosminexus 06-50以降で動作させる場合，次のことに注意してください。
アプリケーションが，<res-sharing-scope>にUnshareableを指定している場合でも，コネクションアソシエーション機能が動作することを期待している場合（具体的には，ローカルトランザクション内でコネクションを2本以上取得する場合など）には，trueを指定する必要があります。
なお，アプリケーションを新規に開発する場合には，このキーは指定しないでください。
false

ejbserver.connectionpool.sharingOutsideTransactionScope.enabled
1.4モードの場合に，アプリケーションサーバが管理するトランザクションの外で複数回コネクションの取得を行ったときのコネクションシェアリングの動作を指定します。なお，リソースアダプタのトランザクションサポートレベルにNoTransactionを指定した場合は，コネクションシェアリングは行われません。

trueを指定した場合：

コネクションシェアリングを行います。なお，trueを指定した場合でも，サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合には，コネクションシェアリングは行いません。

falseを指定した場合：

アプリケーションサーバが管理するトランザクションの外ではコネクションシェアリングを行いません。

false

(e)　ejbserver.connectorから始まるキー

キー名称 | 内容 | デフォルト値
ejbserver.connector.logwriter.filenum | リソースアダプタ用ログファイルの面数を1～16の整数で指定します。 | 4
ejbserver.connector.logwriter.filesize | リソースアダプタ用ログファイルのサイズ（単位：バイト）を4096～2147483647の整数で指定します。 | 2097152

(f)　ejbserver.containerから始まるキー

キー名称
内容
デフォルト値

ejbserver.container.audit_trail.enabled
データベース監査証跡連携機能を有効にするかどうかを指定します。

trueを指定した場合：

データベース監査証跡連携機能を有効にします。

falseを指定した場合：

データベース監査証跡連携機能を無効にします。

false

ejbserver.container.bmp.backcompatible
Entity Bean(BMP)のロック制御の動作を指定します。

trueを指定した場合：

EJBコンテナでロックを制御します。

falseを指定した場合：

EJBコンテナでロックを制御しません。

なお，このプロパティの変更を有効にするには，開始中のJ2EEアプリケーションをいったん削除し，再作成または再インポートしてください。
false

ejbserver.container.ejbhome.sessionbean.reconnect.enabled
EJBホームオブジェクトへの再接続機能を有効にするかどうかを指定します。

trueを指定した場合：

EJBホームオブジェクトへの再接続機能を有効にします。

trueを指定した場合は，必ずvbroker.se.iiop_tp.scm.iiop_tp.listener.portプロパティにポート番号を指定してください。

falseを指定した場合：

EJBホームオブジェクトへの再接続機能を無効にします。

false

ejbserver.container.passivate.scan.interval
Enterprise Beanのタイムアウトやプールの状態を監視するスレッドの起動間隔を，0～2147483の整数（単位：秒）で指定します。
0を指定した場合は監視しません。
0

ejbserver.container.rebindpolicy
EJBメソッドの呼び出し時に通信障害が発生した場合の，EJBクライアント側でのコネクションの再接続動作とリクエストの再送動作を指定します。

VB_TRANSPARENT：

コネクションを再接続してリクエストを再送します。

NO_RECONNECT：

コネクションを再接続しないで，リクエストを再送しません。

この場合，通信障害によってコネクションが切断されると，再接続されないため，そのオブジェクトリファレンスは再利用できなくなります。

VB_TRANSPARENT

ejbserver.container.security.disabled
Enterprise Beanのアクセス制御機能を有効にするかどうかを指定します。Enterprise Beanのアクセス制御機能の詳細についてはマニュアル「Cosminexus　機能解説」のEnterprise Beanへのアクセス制御に関する説明を参照してください。
このプロパティはserver.policy（J2EEサーバ用セキュリティポリシーファイル）で指定するセキュリティポリシーとは関係ありません。

trueを指定した場合：

Enterprise Beanのアクセス制御機能が無効になります。この場合，EJBレベルおよびアプリケーションレベルでのセキュリティ定義が無効となり，EJB実行時のメソッド実行権限のチェックが一切行われません。

falseを指定した場合：

Enterprise Beanのアクセス制御機能が有効になります。

false

ejbserver.container.remove.scan.interval
活性化状態のStateful Session Beanのタイムアウトを監視するスレッドの起動間隔を，0～153722867280912の整数（単位：分）で指定します。
0を指定した場合または0未満を指定した場合，監視しません。
153722867280912より大きい値を指定した場合，153722867280912が設定されます。
数値以外を指定した場合，デフォルト値が設定されます。
5

(g)　ejbserver.ctmから始まるキー

キー名称
内容
デフォルト値

ejbserver.ctm.ActivateTimeOut
CTM機能を使用する場合に必要なプロパティです。CTM機能を使用するJ2EEアプリケーションのデプロイ時，J2EEサーバはスケジュールキューを活性化します。このときの待ち時間（単位：秒）を0～2147483647で指定します。0を指定した場合，無限に待ち続け，省略した場合は，180（秒）が設定されます。
180

ejbserver.ctm.CTMDomain
CTM機能を使用する場合に必要なプロパティです。J2EEサーバが属するCTMドメイン名称を1～31文字の英数字またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTMドメイン名称は指定できません。省略した場合，"CTMDOMAIN"が設定されます。
CTMDOMAIN

ejbserver.ctm.CTMID
CTM機能を使用する場合に必要なプロパティです。J2EEサーバを制御するCTMデーモンのCTM識別子を1～31文字の英数字，アンダースコア（_）またはピリオド（.）で指定します。ただし，IPアドレスで識別子を指定する場合にだけピリオドが使用できます。
"CTM"または"ctm"で始まるCTM識別子は指定できません。またCTMドメイン名称と同じ名称を指定できません。省略した場合，IPアドレスが設定されます。
<IPアドレス>

ejbserver.ctm.CTMMyHost
CTM機能を使用する場合に必要なプロパティです。マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1～64文字の文字列で指定します。
省略した場合は，hostnameコマンドで取得できるホスト名称が設定されます。
ejbserver.ctm.CTMIDプロパティを省略してこのプロパティを指定した場合，デフォルトのCTM識別子は，このプロパティで指定したIPアドレスになります。
<hostnameコマンドで取得されるホスト名称>

ejbserver.ctm.DeactivateTimeOut
CTM機能を使用するJ2EEアプリケーションのアンデプロイ時，J2EEサーバはスケジュールキューを非活性化します。このときの待ち時間（実行中のリクエストの完了待ち）を0～2147483647（単位：秒）で指定します。0を指定した場合，無限に待ち続け，省略した場合は，180（秒）が設定されます。
CTM経由で仕掛かり中のリクエストがある状態でアプリケーションを停止しようとした場合に，強制停止できなくなるため，0は指定しないでください。
180

ejbserver.ctm.enabled
CTM機能の使用の有無を指定します。

trueを指定した場合：

CTM機能を使用します。CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

J2EEサーバ起動時CTMとの接続の確立および初期化をします。これに成功するとCTM機能が使用できる状態でJ2EEサーバが起動します。

CTMとの接続および初期化に失敗した場合，J2EEサーバの起動に失敗します。

falseを指定した場合：

CTM機能を使用しません。

J2EEサーバ起動時に，CTMとの接続の確立および初期化をしないため，J2EEサーバはCTMを使用できる状態で起動しません。この状態でCTMを使用するアプリケーションのデプロイはできません。CTM機能が使用できない状態でもJ2EEサーバを起動したい場合は，falseを指定します。

true

ejbserver.ctm.QueueLength
CTM機能を使用するJ2EEアプリケーションのデプロイ時，J2EEサーバはCTMキューを生成します。このときのCTMキューの長さを，1～32767で指定します。省略した場合，CTMデーモンで保持しているCTMキューの生成時の長さ（-CTMMaxRequestCountオプションで指定した長さ）が有効となります。CTMキューを共有する場合，CTMキューはすでに作成されているため，指定された値ではなく作成済みの長さが有効となります。
なし

(h)　ejbserver.deployから始まるキー

キー名称
内容
デフォルト値

ejbserver.deploy.app.stopforcibly.disabled
J2EEアプリケーションの強制停止を無効にするかどうかを指定します。

trueを指定した場合：

J2EEアプリケーションの強制停止を無効にします。

falseを指定した場合：

J2EEアプリケーションの強制停止を有効にします。

false

ejbserver.deploy.applications.metadata_complete
アノテーションを記述できるアプリケーションのうち，次のアプリケーションでアノテーション参照抑止機能を有効にするかどうかを指定します。

EJB 2.1

Servlet 2.4

trueを指定した場合：

アノテーションを参照しません。

falseを指定した場合：

アノテーションを参照します。

false

ejbserver.deploy.context.check_interval
アプリケーション構成ファイルの更新を検知する間隔を，0～2147483647の整数（単位：秒）で指定します。
0や1～2147483647以外の数字を指定した場合は，自動リロードしません。コマンドリロードだけ受け付けます。
0

ejbserver.deploy.context.reload_scope
J2EEアプリケーションに含まれるEJB-JAR，サーブレット，JSPの単位でリロード機能の適用範囲を指定します。
指定できる値を次に示します。

none：

リロード機能を使用しません。

app：

EJBアプリケーション，サーブレット，JSPでリロード機能を使用します。

web：

サーブレット，JSPでリロード機能を使用します。

jsp：

JSPでリロード機能を使用します。

上記以外：

デフォルト値が設定されます。

app

ejbserver.deploy.context.update.interval
アプリケーション構成ファイルの更新を待つ時間を，0～2147483647の整数（単位：秒）で指定します。
0や1～2147483647以外の数字を指定した場合は，待ち時間なしとなります。
0

ejbserver.deploy.exclusive.lockAliveInterval
サーバ処理終了後，コマンドから送信された次のレスポンスを受け取るまでの最大待ち時間を，1～2147483647の整数（単位：秒）で指定します。
このプロパティの影響を受けるコマンドは，J2EEサーバで使用するコマンドのうち，更新，参照，特権に分類されているコマンドです。更新，参照，特権に分類されるコマンドは，J2EEサーバで使用するコマンドの一覧で確認できます。J2EEサーバで使用するコマンドの一覧については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。
不正な値を指定した場合は，警告メッセージを出力して，デフォルト値が設定されます。
指定した時間以上コマンド側からの通信がない場合，サーバはコマンドが不正終了したとみなし，コマンド排他を強制解除します。
待ち時間とは，コマンドがサーバ間を往復する時間とコマンドの処理時間の合計時間です。
60

ejbserver.deploy.resourcefile.scramble.enabled
作業ディレクトリ以下に展開されるDataSource，JavaMail，ResourceAdapterに関するDDファイルをスクランブルするかどうかを設定します。なお，このプロパティの値を切り替えてJ2EEサーバを起動してもすでにインポート・デプロイされているリソースのDDファイルは定義情報の更新を行わないかぎり状態は変化しません。

trueを指定した場合：

スクランブル化します。

falseを指定した場合：

スクランブル化しません。

false

ejbserver.deploy.session.work.directory
Webアプリケーションのセッション情報ファイルを設定した<ejbserver.deploy.session.work.directoryプロパティ値>¥web¥<コンテキストルート名>配下ディレクトリに出力します。

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>

UNIXの場合
<Cosminexusインストールディレクトリ>/CC/server/repository<サーバ名称>

ejbserver.deploy.stub.generation.scope
スタブなどの通信に必要なクラスを生成する対象範囲を指定します。新規インストール時はejb，アップグレードインストール時はappを指定します。

ejb：

EJB-JARのDDに指定されているホームインタフェース，コンポーネントインタフェースからスタブなどの通信に必要なクラスを生成します。

app：

EJB-JAR，WAR内のjava.rmi.Remoteを継承したクラスからスタブなどの通信に必要なクラスを生成します。

上記以外：

サーバを起動時にKDJE42257-Wのメッセージが出力され，デフォルト値が設定されます。

ejb

(i)　ejbserver.distributedtxから始まるキー

キー名称
内容
デフォルト値

ejbserver.distributedtx.enableXidReuseOptimization
1.4モードの場合に，XIDを再利用する最適化を行うかどうかを指定します。

trueを指定した場合：

XIDを再利用して最適化します。

トランザクション内から同じリソースマネジャのコネクションを二つ以上使用しない場合には，trueを設定することでトランザクション管理パフォーマンスを向上できます。

falseを指定した場合，プロパティを指定しなかった場合または無効な値を指定した場合：

XIDを再利用しません。

false

ejbserver.distributedtx.ots.status.directory1※
インプロセストランザクションサービスのステータスファイルおよび保守資料としてのステータスファイルのバックアップを格納するディレクトリを指定します。パス区切り文字は”/”を使用してください。相対パスを指定した場合は，次のディレクトリからのパスとなります。

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>

otsstatus

ejbserver.distributedtx.ots.status.directory2※
インプロセストランザクションサービスのステータスファイルを二重化する場合，予備ステータスファイルおよび保守資料としての予備ステータスファイルのバックアップを格納するディレクトリを指定します。パス区切り文字は”/”を使用してください。
相対パスを指定した場合，J2EEアプリケーションの実行ディレクトリからのパスとなります。
同一マシン内で稼働するほかのJ2EEサーバやJ2EEアプリケーションのプロセスと重ならないように，別のディレクトリを指定する必要があります。
このプロパティを指定しない場合，予備ステータスファイルは作成されないため，二重化されません。
なし

ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout
グローバルトランザクションを使用する場合に，J2EEサーバ停止時に行われるトランザクション仕掛かり完了確認のタイムアウトを，-1～2147483647の数値（単位：秒）で指定します。ただし，次の場合はタイムアウトしません。

-1を指定した場合

無効な文字列を指定した場合

このキーを指定しない場合

この場合，J2EEサーバまたはリソースマネジャが認識する未決着トランザクションが存在しないことが確認できるまで，J2EEサーバの停止は無限に保留されます。
0以上2147483647までの整数が指定された場合には，指定された時間（秒）が経過した時点でトランザクション仕掛かり完了確認をタイムアウトし，未決着トランザクションが存在しないことが確認できていなくても，J2EEサーバを停止します。
アプリケーションの運用時には，トランザクションのACIDを保証するために，タイムアウトしない設定にする必要があります。また，アプリケーションの開発時の，トランザクションのACIDよりも利便性を優先する場合には，タイムアウトする設定にできます。
-1（タイムアウトしません）

ejbserver.distributedtx.recovery.port
1.4モードの場合に，グローバルトランザクションを使用するとき，トランザクションリカバリで使用する固定ポート番号を1～65535の整数で指定します。無効な値を指定した場合や，指定したポートがすでに使用されていた場合には，起動が中断されます。なお，ライトトランザクションを有効として起動した場合は，このプロパティは無視されます。
20302

ejbserver.distributedtx.rollbackClientTxOnSystemException
システム例外が発生した場合に，呼び出したクライアントトランザクションをロールバックにマークするかどうかを指定します。

trueを指定した場合：

クライアントトランザクションをロールバックにマークします。

falseを指定した場合：

クライアントトランザクションをロールバックにマークしません。

プロパティが指定されていない場合や，無効な値を指定した場合は，falseが設定されます。
J2EEサーバが1.4モードで稼働時に，クライアントのトランザクションを開始してJ2EEサーバにあるリモートインタフェースを実装したEJBを，ローカル呼び出し最適化で呼び出し，呼ばれたEJBで新たなトランザクションを開始するかトランザクションを開始しない場合にだけ，このプロパティが有効になります。
false（1.4モードからの上書きインストールの場合はtrue）

ejbserver.distributedtx.XATransaction.enabled
1.4モードの場合に，グローバルトランザクションを使用するかどうかを指定します。

trueを指定した場合：

ライトトランザクション機能が無効となり，グローバルトランザクションを利用できます。

falseを指定した場合：

ライトトランザクション機能が有効となり，ローカルトランザクションに最適化された環境となります。ただし，グローバルトランザクションは利用できません。

false

注※

インプロセストランザクションサービスのステータスファイルには，J2EEサーバの識別情報としてホスト名またはIPアドレスを取り込んでいます。このため，ホスト名またはIPアドレスを変更する場合には，J2EEサーバの停止などの作業が必要です。ステータスファイルの格納ディレクトリに関するホスト名またはIPアドレスの変更は，J2EEサーバの動作設定のカスタマイズ時に実行します。J2EEサーバの動作設定のカスタマイズについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(j)　ejbserver.DynamicStubLoadingから始まるキー

キー名称
内容
デフォルト値

ejbserver.DynamicStubLoading.Enabled
ダイナミッククラスローディングを使用するかどうかを指定します。

falseを指定した場合：

ダイナミッククラスローディングは機能しません。EJBオブジェクトのスタブ，EJBHomeオブジェクトのスタブ，またはビジネスインタフェースのリファレンスのスタブをダウンロードして，EJBクライアントのユーザクラスパスに指定してください。

trueを指定した場合：

ダイナミッククラスローディングが機能します。EJBオブジェクトのスタブ，EJBHomeオブジェクトのスタブ，またはビジネスインタフェースのリファレンスのスタブをEJBクライアントのユーザクラスパスに指定する必要はありません。

false

(k)　ejbserver.ejbから始まるキー

キー名称
内容
デフォルト値

ejbserver.ejb.cmp20.cmr.use.existing_table
デプロイ時に既存のCMR表を使用するオプションです。通常はデプロイ時にCMR表を生成するので既存のCMR表を使用する必要はありませんが，障害から回復する場合に一時的に指定します。

falseを指定した場合：

デプロイ時にすでにCMR表がある場合はエラーになります。

trueを指定した場合：

デプロイ時にすでにあるCMR表を使用します。

false

ejbserver.ejb.timerservice.maxCallbackThreads
J2EEサーバ全体で，TimerServiceでのタイムアウトメソッドをコールバックする最大スレッド数を，1～100の整数で指定します。
1

ejbserver.ejb.timerservice.retryCount
TimerServiceでの，タイムアウトメソッドのコールバックをリトライする最大回数を，0～2147483646の整数で指定します。
1

ejbserver.ejb.timerservice.retryInterval
TimerServiceでの，タイムアウトメソッドのコールバックをリトライする間隔を，1～604800の整数（単位：秒）で指定します。
5

(l)　ejbserver.extから始まるキー

キー名称
内容
デフォルト値

ejbserver.ext.method_observation.interval
このプロパティの設定には，次の二つの意味があります。

J2EEアプリケーション実行時間監視機能を使用するかどうかを指定します。

動作中のリクエスト処理がタイムアウトしていないかを監視する時間間隔，タイムアウトしたリクエスト（メソッド）をキャンセルする時間間隔として，0～86400の整数（単位：秒）を指定します。

0を指定した場合：

J2EEアプリケーション実行時間監視機能を使用しません。また，タイムアウトを監視しません

0以外の有効値を指定した場合：

J2EEアプリケーション実行時間監視機能を使用します。また，指定された時間間隔で，タイムアウトとメソッドキャンセルを異なるスレッドで実行します。

上記以外の無効な値を指定した場合：

デフォルト値が設定されます。

0

(m)　ejbserver.httpから始まるキー

キー名称
内容
デフォルト値

ejbserver.http.port
簡易Webサーバのポート番号を1～65535の整数で指定します。
すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また，複数のJ2EEサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したJ2EEサーバはcjstartsvコマンドで複数起動できません。
8080

(n)　ejbserver.instrumentationから始まるキー

キー名称
内容
デフォルト値

ejbserver.instrumentation.enabled
Management Serverと連携するかどうかを指定します。

trueを指定した場合：

Management Serverと連携できます。

falseを指定した場合：

Management Serverと連携できません。

true

(o)　ejbserver.jdbcから始まるキー

キー名称
内容
デフォルト値

ejbserver.jdbc.propertyInfo.BUF_SIZE
該当キーに値が指定されている場合，J2EEサーバがJDBCコネクションを取得するとき，BUF_SIZEキーに該当値を設定したプロパティを作成して，構成ソフトウェアであるCosminexus DABroker Libraryのjava.sql.Driver.connectの引数に渡します。
なお，このプロパティは，ベーシックモードでだけ指定できます。
なし

ejbserver.jdbc.propertyInfo.ENCODELANG
該当キーに値が指定されている場合，J2EEサーバがJDBCコネクションを取得するとき，ENCODELANGキーに該当値を設定したプロパティを作成して，構成ソフトウェアであるCosminexus DABroker Libraryのjava.sql.Driver.connectの引数に渡します。
なお，このプロパティは，ベーシックモードでだけ指定できます。
なし

(p)　ejbserver.jndiから始まるキー

キー名称
内容
デフォルト値

ejbserver.jndi.cache
ネーミングでのキャッシングをするかどうかを指定します。
キャッシングをする場合はonを，キャッシングをしない場合はoffを指定します。
on

ejbserver.jndi.cache.interval
ネーミングでのキャッシングをする場合，キャッシュをクリアする間隔（単位：秒）を指定します。
ただし，1～2147483647以外の値を指定した場合，クリアしません。
0

ejbserver.jndi.cache.interval.clear.option
インターバル経過後のネーミングでのキャッシュ領域に対する動作を決定します。

refreshを指定した場合：

キャッシュの全領域をクリアします。

checkを指定した場合：

無効なキャッシュをクリアします。CTMを使用している場合，キャッシュされたグローバルCORBAネーミングサービスのEJBホームオブジェクトのオブジェクトリファレンスは，アプリケーションが停止していても無効なキャッシュとしてクリアされません。詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

refresh

ejbserver.jndi.cache.reference
DataSourceオブジェクトのキャッシング機能を使用するかどうかを指定します。

onを指定した場合：

DataSourceオブジェクトのキャッシング機能が有効になり，検索の要求に対して同じインスタンスが返ります。

offまたは無効な文字列を指定した場合：

通常通りに動作し，検索ごとに異なるインスタンスが返ります。

off

ejbserver.jndi.namingservice.group.list
ラウンドロビン検索をする場合に，検索対象になる論理ネーミングサービスのグループを定義します。指定するグループ名は，英数字（A～Z，a～z，0～9）またはアンダースコア（_）で構成される，ejbserver.jndi.namingservice.group.list内で一意に識別できる名前にします。

指定形式：

<Specify group name>[;<Specify group name>]*

なお，*は繰り返しを示します。

なし

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls
各グループに属するネーミングサービスのルート位置をプロバイダURLで指定します。
<Specify group name>には，ejbserver.jndi.namingservice.group.list内に指定したグループ名を指定します。
プロバイダURLは，URLスキーマ"corbaname"を使用して記述します。

指定形式：

<プロバイダURL>[;<プロバイダURL>]*

なし

ejbserver.jndi.request.timeout
ネーミングサービスとの通信タイムアウト時間（単位：秒）を0～86400の整数で指定します。0を指定した場合，またはこのプロパティを指定しない場合，タイムアウトしません。また，86400を超える値を設定した場合，警告メッセージを出力して，タイムアウトしません。
0

（凡例）*：[]部分の繰り返しを示します。

(q)　ejbserver.jtaから始まるキー

キー名称
内容
デフォルト値

ejbserver.jta.TransactionManager.defaultTimeOut
J2EEサーバ上で開始されるトランザクションのトランザクションタイムアウトのデフォルト値（単位：秒）を次の範囲で指定します。

1.4モードの場合：

1～2147483647

ベーシックモードの場合：

1～2000000

180

ejbserver.jta.TransactionManager.enlist.compatibleMode.enabled
J2EEサーバモードがベーシックモードの場合のトランザクション処理に関する仕様を指定します。

トランザクション中に，複数回データベースコネクションを取得した場合（コネクションシェアリング機能が有効になる条件を満たしているとき）：

該当キーの値による動作の違いはありません。トランザクション中に2回目以降に取得したコネクションも，トランザクションに参加して動作します。

トランザクション中に，複数回DBコネクションを取得した場合（コネクションシェアリング機能が有効になる条件を満たしていないとき）：

trueを指定したとき：
トランザクション中に2回目以降に取得したコネクションは，トランザクションに参加しないで動作します。

falseを指定したとき：
トランザクション中に2回目にコネクションを取得した場合に，java.sql.SQLExceptionが発生します。

複数回データベースコネクションを取得したあとで，トランザクションを開始した場合

trueを指定したとき：
トランザクション開始前に取得したコネクションは，トランザクションに参加しないで動作します。

falseを指定したとき：
トランザクション開始時に，javax.transaction.SystemExceptionが発生します。

true

(r)　ejbserver.loggerから始まるキー

キー名称
内容
デフォルト値

ejbserver.logger.channels.define.<チャネル名>※.filenum
J2EEサーバのログファイルの面数を，1～16の整数で指定します。

チャネル名がWebAccessLogFileの場合
16

チャネル名がMaintenanceLogFileまたはWebServletLogFileの場合
4

チャネル名が上記以外の場合
2

ejbserver.logger.channels.define.<チャネル名>※.filesize
J2EEサーバのログファイルのサイズ（単位：バイト）を，4096～2147483647の整数で指定します。

チャネル名がWebAccessLogFileの場合
2097152

チャネル名がMaintenanceLogFileの場合
16777216

チャネル名がWebServletLogFileの場合
4194304

チャネル名が上記以外の場合
1048576

ejbserver.logger.enabled.*
J2EEサーバのログレベルを指定します。Error，Warning，Information，Debugのうち，一つまたは複数を指定します。一つだけ指定した場合は，該当するログレベルのログだけが出力されます。複数指定する場合は，レベル名の文字列の間をコンマ（,）で区切ります。通常はデフォルトのまま利用してください。
Error，Warning

ejbserver.logger.systemlog.enabled
J2EEサーバの起動，停止および異常終了に関するメッセージを，イベントログ（UNIXの場合は，syslog）へログを出力するかどうかを指定します。

trueを指定した場合：

イベントログ（UNIXの場合は，syslog）へログを出力します。

falseを指定した場合：

イベントログ（UNIXの場合は，syslog）へログを出力しません。

True

注※

チャネル名称として次に示す名称を設定できます。

Cosminexusシステムのログ出力用のチャネル
MessageLogFile，MaintenanceLogFile，ExceptionLogFile，ConsoleLogFile，EJBContainerLogFile，WebContainerLogFile，WebServletLogFile，UserOutLogFile，UserErrLogFile，WebAccessLogFile，CSFLogFile

リソース枯渇監視ログ出力用のチャネル
MemoryWatchLogFile，FileDescriptorWatchLogFile，ThreadWatchLogFile，ThreaddumpWatchLogFile，RequestQueueWatchLogFile，HttpSessionWatchLogFile，ConnectionPoolWatchLogFile

資料の取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(s)　ejbserver.managementから始まるキー

キー名称
内容
デフォルト値

ejbserver.management.JVM.stats_monitor.FullGCCount.enabled
フルガーベージコレクション回数の監視を有効にするかどうかを指定します。

true：

有効にします。

false：

無効にします。

true

ejbserver.management.JVM.stats_monitor.FullGCCount.threshold
フルガーベージコレクション回数の監視でのしきい値となる回数を，1～2147483647の整数で指定します。
10

ejbserver.management.JVM.stats_monitor.FullGCCount.interval
フルガーベージコレクション回数の監視でのしきい値監視間隔を，1～2147483647の整数（単位：秒）で指定します。
600

ejbserver.management.statistics.interval
稼働情報収集間隔を，1～86400の整数（単位：秒）で指定します。
60

ejbserver.management.stats_file.base_time
稼働情報ファイルの時間切り替え運用での基点時刻を，ローカルタイムの1970年1月1日0時0分0秒からの増分として0～1439の整数（単位：分）で指定します。
ローカルタイムの1970年1月1日h時m分を基点にする場合には，h×60＋mを指定します。
0

ejbserver.management.stats_file.dir
稼働情報ファイルの出力先ディレクトリを指定します。出力先ディレクトリを変更する場合は，J2EEサーバごとに別々のディレクトリを指定してください。

Windowsの場合<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥stats

UNIXの場合<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/stats

ejbserver.management.stats_file.enabled
稼働情報ファイル出力機能を有効にするかどうかを指定します。

true：

有効にします。

false：

無効にします。

true

ejbserver.management.stats_file.num
稼働情報ファイルの面数を，2～168の整数で指定します。
7

ejbserver.management.stats_file.period
稼働情報ファイルの時間切り替え運用での切り替え時間を，1～744の整数（単位：時）で指定します。
24

(t)　ejbserver.managerから始まるキー

キー名称
内容
デフォルト値

ejbserver.manager.agent.Agent.conf
Management Serverとの連携に必要な設定をします。なお，この内容はManagement ServerがJ2EEサーバに自動で設定します。Management ServerがJ2EEサーバに自動で設定する内容については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。
なし

ejbserver.manager.agent.Agent.enabled
Management Serverとの連携に必要な設定をします。なお，この内容はManagement ServerがJ2EEサーバに自動で設定します。Management ServerがJ2EEサーバに自動で設定する内容については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。
false

ejbserver.manager.agent.JP1EventAgent.conf
JP1連携に関する設定ファイルのパスを指定します。
なし

ejbserver.manager.agent.JP1EventAgent.enabled
JP1と連携するかどうかを指定します。
false

ejbserver.manager.agent.MEventAgent.conf
Managementイベント発行用プロパティファイルを絶対パスで指定します。指定がない場合，または指定したファイルが存在しない場合はManagementイベントを発行しません。
Managementイベント発行用プロパティファイルの詳細は，「8.11　Managementイベント発行用プロパティファイル」を参照してください。
なし

ejbserver.manager.agent.MEventAgent.enabled
Managementイベント発行機能を有効にするかどうかを指定します。

trueを指定した場合：

Managementイベント発行機能を有効にします。

falseを指定した場合：

Managementイベント発行機能を無効にします。

不正な値が指定された場合は，デフォルト値が設定されます。
false

ejbserver.manager.jp1event.event_server_name
使用するJP1/Baseのイベントサービスのイベントサーバ設定ファイル（conf）に指定した，portsパラメタのアドレスと同じ値を指定します。portsパラメタに複数のアドレスを指定している場合は，指定したアドレスのうちのどれか一つを指定します。なお，portsパラメタのアドレスに「0.0.0.0」（デフォルト値）を指定したイベントサービスを使用する場合は，このキーを省略するか，自マシンのホスト名またはlocalhostを指定します。
localhost

(u)　ejbserver.namingから始まるキー

キー名称
内容
デフォルト値

ejbserver.naming.exec.args
CORBAネーミングサービスを自動起動モード（ejbserver.naming.startupMode=automaticまたはinprocess）で使用する場合に，起動させるCORBAネーミングサービスに付加する実行時オプションを指定します。通常はこのプロパティに値を設定する必要はありません。CORBAネーミングサービス自動起動モード使用時にCORBAネーミングサービスで障害などが発生した場合に，その調査，対策および回避をするために使用します。
実行時オプションは，nameservのコマンドライン引数に指定する形式と同じ文字列を指定します（各プロパティの先頭に"-J"を付加して，スペース区切りで指定します。なお，実際は一行で指定します）。
（指定例）

ejbserver.naming.exec.args=-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=900
-J-Dvbroker.agent.enableLocator=false

ただし，inprocessモードでCORBAネーミングサービスを使用する場合は，次のプロパティを指定できません。

javax.rmi.CORBA.StubClass

javax.rmi.CORBA.UtilClass

javax.rmi.CORBA.PortableRemoteObjectClass

vbroker.serverManager.name

vbroker.orb.enableServerManager

vbroker.agent.enableLocator

vbroker.se.iiop_tp.host

このプロパティ値は，ejbserver.naming.portやvbroker.agent.enableLocatorプロパティで指定された値よりも優先されます。ただし，inprocessモードでCORBAネーミングサービスを起動する場合，ejbserver.naming.exec.argsで指定されたプロパティと同一のプロパティがシステムプロパティで設定されているときは，システムプロパティに設定されている情報が優先されます。
CORBAネーミングサービスの実行時に指定できるプロパティについては，マニュアル「Borland(R) Enterprise Server VisiBroker(R)　デベロッパーズガイド」，およびマニュアル「Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス」を参照してください。
なし

ejbserver.naming.host
J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定します。
ネーミングの切り替え機能を使用する場合，ホスト名称として"localhost"は使用しないでください。CORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定してください。
CORBAネーミングサービスを自動起動モード（ejbserver.naming.startupMode=automaticまたはinprocess）で使用する場合，デフォルト値（"localhost"），またはJ2EEサーバを起動させるホスト名称もしくはIPアドレスを指定してください。
localhost

ejbserver.naming.nameroot
CORBAネーミングサービスを自動起動モード（ejbserver.naming.startupMode=automaticまたはinprocess）で使用する場合に，起動させるCORBAネーミングサービスに名称を付加するときに指定します。英数字（A～Z，a～z，0～9）またはアンダースコア（_）で構成される文字列で指定します。この名称は，VisiBrokerのnsutilコマンドのパラメタなどに使用されます。
省略した場合，VisiBrokerで自動的に"NameService"という名称が設定されます。
なお，nsutilコマンドの使用方法，使用条件などについては，マニュアル「Borland(R) Enterprise Server VisiBroker(R)　デベロッパーズガイド」を参照してください。
なし

ejbserver.naming.port
J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を1～65535の整数で指定します。ポート番号には，すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合，起動処理が完了しないことがあります。
900

ejbserver.naming.protocol
J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスへのアクセスプロトコルを指定します。現状，corbanameだけサポートしています。ただし，旧バージョンで使用されていたプロトコル（iioplocまたはiiopname）でも動作できます。
corbaname

ejbserver.naming.startupMode※
CORBAネーミングサービスの起動モードを指定します。

manualを指定した場合：

CORBAネーミングサービスを手動起動モードで使用する場合に指定します。

J2EEサーバを開始する前にCORBAネーミングサービスを手動で開始する必要があります。

J2EEサーバ開始時にejbserver.naming.host，ejbserver.naming.portで指定したCORBAネーミングサービスを手動で指定します。このプロパティ値が指定された場合には，J2EEサーバ起動処理からはCORBAネーミングサービスの自動起動をしません。

automaticを指定した場合：

CORBAネーミングサービスを自動起動モードで使用する場合に指定します。

J2EEサーバ開始時に自動で，CORBAネーミングサービスをアウトプロセスで開始します。

このモードでは，J2EEサーバ終了時に自動でCORBAネーミングサービスも停止します。ただし，J2EEサーバ開始時にejbserver.naming.portで指定したCORBAネーミングサービスが自ホスト上ですでに開始されている場合には自動開始処理をしないで，そのCORBAネーミングサービスを利用します。また，この場合，J2EEサーバ終了時のCORBAネーミングサービスの自動停止はしません。

inprocessを指定した場合：

CORBAネーミングサービスを自動起動モードで使用する場合に指定します。

J2EEサーバ開始時に自動で，CORBAネーミングサービスをインプロセスで開始するモードです。J2EEサーバ開始時にejbserver.naming.portで指定したCORBAネーミングサービスが自ホスト上ですでに開始されている場合には，エラーメッセージを出力してJ2EEサーバの起動処理が失敗します。

06-00以降での新規インストールの場合：
inprocess

バージョンアップの場合：
既存の指定値が設定されます。省略していた場合は，manualが設定されます。

ejbserver.naming.startupRetryCount
ejbserver.naming.startupWaitTimeで指定したCORBAネーミングサービスの起動待ち時間経過後，CORBAネーミングサービスがまだ起動していない場合に，ejbserver.naming.startupWaitTimeで指定された秒数だけ起動待ちを繰り返す回数を0～2147483647の整数で指定します。
0が指定された場合はCORBAネーミングサービス起動状態チェック処理のリトライをしません。
なお，ejbserver.naming.startupWaitTimeに0が指定されている場合は，このプロパティ値は無効です。

06-00以降での新規インストールの場合：
9

バージョンアップの場合：
0

ejbserver.naming.startupWaitTime
J2EEサーバ起動時にCORBAネーミングサービスが利用可能になるまで待つ時間（単位：秒）を0～2147483647の整数で指定します。0を指定した場合は，CORBAネーミングサービスの起動待ちをしません。

06-00以降での新規インストールの場合：1

バージョンアップの場合：manualモードで使用していた場合には0が設定されます。
automaticモードを使用し，このプロパティ値を設定していた場合は，既存の指定値がデフォルト値となります。省略していた場合10となります。

注※

Management Serverを利用してJ2EEサーバを起動する場合，automatic以外を指定してください。automaticを指定した場合，CORBA Naming ServiceプロセスがTPBroker運用支援機能のプロセス監視対象外となり，プロセスがダウンしても再起動されなくなります。

(v)　ejbserver.rmiから始まるキー

キー名称
内容
デフォルト値

ejbserver.rmi.localinvocation.scope
ローカル呼び出し最適化機能の適用範囲を指定します。

noneを指定した場合：

適用範囲はありません。バージョンアップインストール時は互換性のため，これが指定されます。

appを指定した場合：

同一アプリケーション内が適用範囲になります。

allを指定した場合：

同一J2EEサーバ内が適用範囲になります。

app

ejbserver.rmi.naming.host
マルチホームドホスト環境で，J2EEサーバがサービスプロバイダとして使用するRMIレジストリのホスト名称，またはIPアドレスを指定します。指定した半角英文字の大文字，小文字の区別はしません。
なし

ejbserver.rmi.naming.port
J2EEサーバが利用するRMIレジストリのポート番号を，1～65535の整数で指定します。ポート番号には，すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合，起動処理が完了しないことがあります。
23152

ejbserver.rmi.passbyreference※
trueを指定した場合，リモートインタフェースを持つEJBのメソッド呼び出しで，引数および戻り値を値渡し（pass by value）ではなく参照渡し（pass by reference）にします。ただし，ejbserver.rmi.localinvocation.scopeで設定された範囲を超えた呼び出しをした場合，参照渡しの機能は無効になります。
参照渡しでは，値をコピーして生成するコストを削減できますが，渡された参照を用いて元の値を変更できるため注意が必要です。
false

ejbserver.rmi.remote.listener.port
任意の値を指定して，JMXクライアント（運用管理エージェント，JP1/Performance Management - Agent Option for uCosminexus Application Serverなど）による稼働情報取得時のリクエスト受付ポートを固定できます。0～65535の整数を指定します。
ポート番号には，すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合，起動処理が完了しないことがあります。
このプロパティを設定しない場合，または値に0を指定した場合，ランダムな値が設定されます。
0

ejbserver.rmi.request.timeout
クライアントとサーバ間の通信タイムアウト時間（単位：秒）を0～86400の整数で指定します。
0を指定した場合，またはこのプロパティを指定しない場合，タイムアウトしません。なお，86400を超える値を設定した場合，警告メッセージを出力して，タイムアウトしません。
0（秒）

ejbserver.rmi.stateless.unique_id.enabled
Stateless Session Beanのremoveメソッドの呼び出しに対して，呼び出しを不要とするか，必要とするかを指定します。

trueを指定した場合：

Stateless Session BeanのEJBObjectに対してremoveメソッドの呼び出しを不要とします。

removeメソッドの呼び出し後にビジネスメソッドを呼び出した場合には，java.rmi.NoSuchObjectException例外は発生しないで，ビジネスメソッドが実行されます。

falseを指定した場合：

Stateless Session BeanのEJBObjectに対してremoveメソッドの呼び出しを必要とします。

removeメソッドの呼び出し後にビジネスメソッドを呼び出した場合には，java.rmi.NoSuchObjectException例外が発生します。

false

注※

サーバ管理コマンドからEJB単位での参照渡し（Pass-by-reference）の設定をすることもできます。

(w)　ejbserver.serverから始まるキー

キー名称
内容
デフォルト値

ejbserver.server.j2ee.feature
Component Containerの動作モードを指定します。

1.3basic
ベーシックモード（単一DBだけのリソースをトランザクションで使用するシステムに適用）

1.4
J2EE1.4の先進機能が付加されたモード（DBを含む各種リソースをトランザクションで使用するシステムに適用）
J2EE1.4の先進機能が付加されたモードを使用するには，トランザクション管理サーバなどが必要なため，ベーシックモードに比べ，多量のCPU/メモリリソースが必要です。

1.4

ejbserver.server.mutex.invocation.timeout
同時に同一プライマリキーのEntity Beanにアクセスした場合に掛かる排他のタイムアウト時間（単位：秒）を，45～92233720368547758の整数で指定します。タイムアウト時間は，デフォルト値（45秒）以上java.lang.Long.MAX_VALUE/1000（秒）以下の範囲で指定してください。デフォルト値未満の値を指定した場合，タイムアウト時間は45（秒）で動作します。
java.lang.Long.MAX_VALUE/1000（秒）を超える値を指定した場合，タイムアウト時間はjava.lang.Long.MAX_VALUE（ミリ秒）で動作します。さらに，java.lang.Long.MAX_VALUEを超える値を指定した場合は，デフォルト値になります。
45

ejbserver.server.prf.PRFID
PRF識別子を指定します。
PRFデーモン起動時にPRF識別子を指定した場合に，同じPRF識別子を指定します。
PRFデーモン起動時にPRF識別子を省略した場合は，指定しないでください。PRF識別子が一致しないと，性能解析トレースが取得されません。
なし

ejbserver.server.threaddump.filenum
J2EEサーバが障害を検知して自発的にスレッドダンプを出力する場合のスレッドダンプのファイル数の上限を，1～2147483647の整数で指定します。
範囲外の値を指定した場合は，デフォルト値が設定されます。
また，次に示す外部からのスレッドダンプ出力要求に対しては，このオプションの設定に関係なくスレッドダンプのファイルが出力されます。

cjdumpsvコマンド

cjstopsvコマンドの-fd指定

J2EEサーバ実行コンソールでのCtrl+Break（Windowsの場合）

J2EEサーバプロセスへのkillコマンド -3（SIGTERM）指定（UNIXの場合）

256

(x)　ejbserver.statefulから始まるキー

キー名称
内容
デフォルト値

ejbserver.stateful.passivate.switch
Stateful Session Beanの非活性化，活性化の機能を使用するかどうかを指定します。

trueを指定した場合：

Stateful Session Beanの非活性化，活性化の機能が動作します。

falseを指定した場合：

Stateful Session Beanの非活性化，活性化の機能が動作しません。

false

(y)　ejbserver.watchから始まるキー

キー名称
内容
デフォルト値

ejbserver.watch.enabled
すべてのリソース枯渇監視を有効にするかどうかを指定します。

trueを指定した場合：

すべてのリソース枯渇監視を有効にします。

falseを指定した場合：

すべてのリソース枯渇監視を無効にします。この場合，各リソース枯渇監視が有効に設定されていても，すべてのリソース枯渇監視が無効になります。

true（06-00以前からのバージョンアップの場合は，false）

ejbserver.watch.memory.enabled
メモリ監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合：

メモリ監視のアラート出力を有効にします。

falseを指定した場合：

メモリ監視のアラート出力を無効にします。

trueを指定する場合，次のJavaVMオプションを同じ値で設定することをお勧めします。

-XX:PermSize

-XX:MaxPermSize

異なる値を設定した場合，Permanent領域の領域拡張でもアラートが出力される場合があります。
true

ejbserver.watch.memory.interval
メモリ監視間隔を1～2147483647の整数（単位：秒）で指定します。
60

ejbserver.watch.memory.threshold
メモリの使用状態を監視するしきい値を，1～100の整数（単位：％）で指定します。次の条件のどれかで，フルガーベージコレクションの予兆を検知した場合に，アラートを出力します。

Tenured領域消費サイズのTenured領域合計サイズに対する割合（リソース枯渇監視情報のRate1に出力される値）がしきい値以上

New領域合計サイズのTenured領域最大空きサイズに対する割合（リソース枯渇監視情報のRate2に出力される値）がしきい値以上

Permanent領域消費サイズのPermanent領域合計サイズ（リソース枯渇監視情報のRate3に出力される値）に対する割合がしきい値以上

80

ejbserver.watch.memory.writefile.enabled
メモリ監視結果をファイル出力するかどうかを指定します。

trueを指定した場合：

メモリ監視結果をファイル出力します。

falseを指定した場合：

メモリ監視結果をファイル出力しません。

true

ejbserver.watch.fileDescriptor.enabled
ファイルディスクリプタ監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合：

ファイルディスクリプタ監視のアラート出力を有効にします。

falseを指定した場合：

ファイルディスクリプタ監視のアラート出力を無効にします。

true

ejbserver.watch.fileDescriptor.interval
ファイルディスクリプタ監視間隔を1～2147483647の整数（単位：秒）で指定します。
60

ejbserver.watch.fileDescriptor.threshold
ファイルディスクリプタの使用状態を監視するしきい値を，1～2147483647の整数で指定します。使用中のファイルディスクリプタ数がしきい値以上になった場合にアラートを出力します。指定するしきい値は次のように設定してください。
OSのプロセスに割り当て可能なファイルディスクリプタ数※＞ファイルディスクリプタ見積もり式から求めた値＞ファイルディスクリプタしきい値
注※
プラットフォームによってシステムの上限が存在しない場合があります。
2147483647

ejbserver.watch.fileDescriptor.writefile.enabled
ファイルディスクリプタ監視結果をファイル出力するかどうかを指定します。

trueを指定した場合：

ファイルディスクリプタ監視結果をファイル出力します。

falseを指定した場合：

ファイルディスクリプタ監視結果をファイル出力しません。

true

ejbserver.watch.thread.enabled
スレッド監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合：

スレッド監視のアラート出力を有効にします。

falseを指定した場合：

スレッド監視のアラート出力を無効にします。

true

ejbserver.watch.thread.interval
スレッド監視間隔を，1～2147483647の整数（単位：秒）で指定します。
60

ejbserver.watch.thread.threshold
スレッドの使用状態を監視するしきい値を，1～2147483647の整数で指定します。生成済みのスレッド数がしきい値以上になった場合にアラートを出力します。指定するしきい値は次のように設定してください。
OSのプロセスに割り当て可能なスレッド数※＞スレッド見積もり式より求めた値＞スレッドしきい値
注※
プラットフォームによってシステムの上限が存在しない場合があります。
2147483647

ejbserver.watch.thread.writefile.enabled
スレッド監視結果をファイル出力するかどうかを指定します。

trueを指定した場合：

スレッド監視結果をファイル出力します。

falseを指定した場合：

スレッド監視結果をファイル出力しません。

true

ejbserver.watch.threaddump.enabled
スレッドダンプ監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合：

スレッドダンプ監視のアラート出力を有効にします。

falseを指定した場合：

スレッドダンプ監視のアラート出力を無効にします。

true

ejbserver.watch.threaddump.interval
スレッドダンプ監視時間間隔を，1～2147483647の整数（単位：秒）で指定します。
30

ejbserver.watch.threaddump.threshold
スレッドダンプ監視のしきい値を，最大値に対する割合1～100の整数（単位：％）で指定します。スレッドダンプのファイル数の最大値に対する現在値の割合がしきい値以上になった場合にアラートを出力します。
80

ejbserver.watch.threaddump.writefile.enabled
スレッドダンプ監視結果をファイル出力するかどうかを指定します。

trueを指定した場合：

スレッドダンプ監視結果をファイル出力します。

falseを指定した場合：

スレッドダンプ監視結果をファイル出力しません。

true

ejbserver.watch.defaultRequestQueue.enabled
HTTPリクエスト実行待ちキュー監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合：

HTTPリクエスト実行待ちキュー監視のアラート出力を有効にします。

falseを指定した場合：

HTTPリクエスト実行待ちキュー監視のアラート出力を無効にします。

true

ejbserver.watch.defaultRequestQueue.interval
HTTPリクエスト実行待ちキュー監視間隔を，1～2147483647の整数（単位：秒）で指定します。
30

ejbserver.watch.defaultRequestQueue.threshold
アラートメッセージを出力するしきい値を，1～100の整数（単位：%）で指定します。監視対象のリクエストの実行待ちキューの格納率が，このキーで指定された値以上になるとアラートメッセージを出力します。
80

ejbserver.watch.defaultRequestQueue.writefile.enabled
HTTPリクエスト実行待ちキュー監視結果をファイル出力するかどうかを指定します。

trueを指定した場合：

HTTPリクエスト実行待ちキュー監視結果をファイル出力します。

falseを指定した場合：

HTTPリクエスト実行待ちキュー監視結果をファイル出力しません。

true

(z)　ejbserver.webj2eeから始まるキー

キー名称
内容
デフォルト値

ejbserver.webj2ee.connectionAutoClose.enabled
J2EEサーバの動作モードが1.4モードの場合に，自動クローズ機能を使用するかどうかを指定します。動作モードがベーシックモードの場合，このプロパティは無視され，自動クローズ機能は無効となります。

trueを指定した場合：

自動クローズ機能を有効にします。

falseを指定した場合：

自動クローズ機能を無効にします。

不正な値を指定した場合は，デフォルト値が設定されます。
true

(aa)　javaから始まるキー

キー名称
内容
デフォルト値

java.naming.factory.initial
JNDIのInitialContextがデレゲートするコンテキストの実装クラスのファクトリクラスを指定します。各設定値での動作を次に示します。

com.hitachi.software.ejb.jndi.InsContextFactory ：

JNDIラウンドロビン検索機能を使用しないで，通常の検索機能を使用する場合に指定するコンテキストです。

com.hitachi.software.ejb.jndi.GroupContextFactory ：

J2EEサーバ内アプリケーション（EJB）の実行時に，JNDIラウンドロビン検索機能を使用する場合に指定するコンテキストです。

com.hitachi.software.ejb.jndi.InsContextFactory

(ab)　vbjから始まるキー

キー名称
内容
デフォルト値

vbj.java2iiop.jvm.maxHeapSize
J2EEアプリケーション開始時に起動されるjava2iiopコマンドのヒープサイズの最大値を指定します。
指定する値は，javaコマンドの-Xmx，-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。

2048～4294966272の値を指定してください。ただし，vbj.java2iiop.jvm.minHeapSizeに指定した以上の値を指定してください。

キロバイト単位で指定する場合は，文字「k」または「K」を付けて指定してください。

メガバイト単位で指定する場合は，文字「m」または「M」を付けて指定してください。

128m

vbj.java2iiop.jvm.minHeapSize
J2EEアプリケーション開始時に起動されるjava2iiopコマンドのヒープサイズの初期値を指定します。
指定する値は，javaコマンドの-Xmx，-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。

1024～-Xmx指定値の値を指定してください。

キロバイト単位で指定する場合は文字「k」または「K」を付けて指定してください。

メガバイト単位で指定する場合は，文字「m」または「M」を付けて指定してください。

16m

(ac)　vbrokerから始まるキー

キー名称
内容
デフォルト値

vbroker.agent.enableLocator
スマートエージェントを使用するかどうかを指定します。
通常は設定不要のプロパティです。デフォルトのままご使用ください。
また，CTM連携機能を有効（ejbserver.ctm.enabledキーにtrueを指定）にした場合は，J2EEサーバの起動時に自動的にtrueが設定されます。
この目的以外でスマートエージェントが必要な場合は，trueを設定してください。
なお，このプロパティにtrueを指定した場合は，スマートエージェントを先に起動する必要があります。
スマートエージェントの詳細については，マニュアル「Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス」を参照してください。
false

vbroker.agent.port
スマートエージェントのポート番号を指定します。詳細については，マニュアル「Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス」を参照してください。
14000

vbroker.orb.htc.comt.entryCount
Cosminexus TPBroker通信トレースファイル1個当たりのエントリ数の上限値を100～30000000の範囲で指定します。
120000

vbroker.orb.htc.comt.fileCount
Cosminexus TPBroker通信トレースファイルの個数の上限値を1～256の範囲で指定します。
3

vbroker.orb.htc.tracePath
Cosminexus TPBrokerのトレースファイル出力先のパスを1～210バイトの範囲で指定します。指定したパスのサブディレクトリとしてcomtrcとmdltrcをあらかじめ作成しておく必要があります。デフォルトの出力先の場合，サブディレクトリcomtrcとmdltrcはサーバ初回起動時に自動作成されます。ディレクトリのパスの区切り記号には，"/"を使用してください。
例えば，Windowsの場合，workディレクトリとしてC:¥temp¥workを設定するときは，次のように指定します。
（指定例）
vbroker.orb.htc.tracePath=c:/temp/work

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/TPB/logj

vbroker.se.iiop_tp.host
任意の値を指定して，J2EEサーバ単位でEJBコンテナのIPアドレスを固定します。
なし

vbroker.se.iiop_tp.scm.iiop_tp.listener.port
任意の値を指定して，J2EEサーバ単位で通信ポートを固定できます。ポート番号は，ほかのプログラムなどと重複しないようにしてください。
このプロパティを設定しない場合は，Cosminexus TPBrokerによってランダムな値が設定されます。
また，ejbserver.container.ejbhome.sessionbean.reconnect.enabledにtrueを指定した場合は，必ず値を指定して，ポート番号を固定にしてください。
0

(ad)　webserver.connectorから始まるキー

キー名称
内容
デフォルト値

webserver.connector.ajp12.backlog
旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.backlogとして使用されます。指定できる値については，webserver.connector.ajp13.backlogキーの説明を参照してください。
このキーとwebserver.connector.ajp13.backlogの両方が指定されていた場合，このキーの値が使用されます。
なし

webserver.connector.ajp12.max_threads
旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.max_threadsとして使用されます。指定できる値については，webserver.connector.ajp13.max_threadsキーの説明を参照してください。
このキーとwebserver.connector.ajp13.max_threadsの両方が指定されていた場合，このキーの値が使用されます。
1025以上の値が設定されていた場合，webserver.connector.ajp13.max_threadsのデフォルト値の100が使用されます。
なし

webserver.connector.ajp12.port
旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.portとして使用されます。指定できる値については，webserver.connector.ajp13.portキーの説明を参照してください。
このキーとwebserver.connector.ajp13.portの両方が指定されていた場合，このキーの値が使用されます。
なし

webserver.connector.ajp13.backlog
リダイレクタからの接続要求の最大の待ち行列数を指定します。1～2147483647の整数で指定します。
有効な最大値は実行するプラットフォームで指定できるSocketのListenキューの最大値となります。実際のListenキューの最大値はOSによって異なるため，詳細は各OSのlisten関数についてのマニュアルを参照してください。
このキーに指定した値は，java.net.ServerSocketクラスのコンストラクタのbacklog引数に設定されます。ただし，この指定値がOSの制限値を超えた場合は，OSの制限値が設定されたものと解釈され，エラーにはなりません。制限値はOSによって異なります。制限値を拡張する方法については，OSのマニュアルを参照してください。
100

webserver.connector.ajp13.bind_host
Webサーバ連携で使用するIPアドレスまたはホスト名称を指定します。
IPアドレス，またはホスト名称の前後の半角スペースは無視されます。値を指定しない場合は，ワイルドカードアドレスが使用されます。
このプロパティを指定するときは，ワーカホスト名称にもローカルホスト名称またはIPアドレスを指定する必要があります。
同一ホストで実行しているWebサーバとWebサーバ連携をしている構成の場合に，このプロパティにローカルホスト名称，またはIPアドレスを指定し，リダイレクタのワーカホスト名称にlocalhostなどのループバックアドレスを指定したとき，WebコンテナはWebサーバからのリクエストを受信できません。
なし

webserver.connector.ajp13.max_threads
Webコンテナがリクエストを処理する同時実行数を指定します。※1
1～1024の整数で指定します。
指定されたリクエストの同時実行数分のスレッドがサーバ起動時に生成されます。
10

webserver.connector.ajp13.port
Webサーバとの通信に使用するポート番号を指定します。
１～65535の整数で指定します。
すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また，複数のJ2EEサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したJ2EEサーバはcjstartsvコマンドで複数起動できません。
8007

webserver.connector.ajp13.receive_timeout
リクエスト受信処理のリダイレクタへのデータ要求処理で，リダイレクタからの応答を待つ時間（通信タイムアウト値）を0～3600の整数（単位：秒）で指定します。
0を指定した場合は，リダイレクタからの応答を受け取るまで待ち続け，タイムアウトは発生しません。
600（秒）

webserver.connector.ajp13.send_timeout
レスポンス送信処理のタイムアウト値を0～3600の整数（単位：秒）で指定します。
数値以外の文字列や範囲外の数値を指定した場合は，メッセージを出力し，デフォルト値を使用します。
タイムアウト値に0，またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合，タイムアウト値はTCPの持つタイムアウト値になります。その場合，不正なタイムアウト値が指定されたことを示すメッセージは出力されません。
600

webserver.connector.http.bind_host
簡易Webサーバで使用するローカルIPアドレス，または解決できるローカルホスト名称を指定します。
IPアドレスまたはホスト名称の前後の半角スペースは無視されます。値を指定しない場合は，ワイルドカードアドレスが使用されます。
なし

webserver.connector.http.permitted.hosts
簡易Webサーバへのアクセスを許可するホストのIPアドレス（10進表記）またはホスト名を指定します。
なお，ローカルホストは明記しなくても常にアクセスできます。したがって，このキーの指定を省略した場合，アクセスできるのはローカルホストだけになります。
複数指定する場合にはIPアドレスまたはホスト名の間をコンマ（,）で区切ります。アクセス制限をしない場合はアスタリスク（*）だけを指定します。IPアドレスまたはホスト名の前後の半角スペースは無視されます。
なし

webserver.connector.inprocess_http.backlog
Webクライアントからの接続要求を格納するTCPリスンキューの長さを1～2147483647の整数で指定します。
有効な指定値の最大値や実際に設定されるTCPリスンキューの長さはOSによって異なります。
数値以外の文字列，範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
511

webserver.connector.inprocess_http.bind_host
インプロセスHTTPサーバで使用するIPアドレスまたはホスト名を指定します。
IPアドレスまたはホスト名の前後の半角スペースは無視されます。値を指定しない場合は，ワイルドカードアドレスが使用されます。
指定されたホスト名またはIPアドレスが解決できない場合，ローカルではないホストのホスト名またはIPアドレスを指定した場合はメッセージが出力され，ワイルドカードアドレスが使用されます。
なし

webserver.connector.inprocess_http.enabled
インプロセスHTTPサーバ機能を有効にするかどうかを指定します。

trueを指定した場合：

インプロセスHTTPサーバ機能を有効にします。

falseを指定した場合：

インプロセスHTTPサーバ機能を無効にします。

trueまたはfalse以外の文字列を指定した場合，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
なお，インプロセスHTTPサーバ機能が有効の場合は，Webサーバ連携は使用できません。
false

webserver.connector.inprocess_http.enabled_methods
アクセスを許可するHTTPメソッドを指定します。
複数のメソッドを指定する場合は，コンマ（,）で区切ります。メソッド名にはHTTP/1.1で定義されたメソッドを指定します。
また，アスタリスク（*）を指定した場合は，すべてのメソッドが許可されます。
HTTPメソッドでは大文字，小文字が区別されるため，このプロパティに指定する値も区別されます。
メソッド名にはRFC2616で規定されている値を使用する必要があります。ただし，文字列"*"をメソッド名として指定できません。
各メソッド名の前後の空白文字※2は無視されます。不正な値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
GET,HEAD,POST,PUT,DELETE,OPTIONS

webserver.connector.inprocess_http.error_custom.list
エラーページカスタマイズ機能で使用するエラーページカスタマイズ定義名を指定します。
指定できる値の最大長は1024文字で，英数字（A～Z，a～z，0～9）またはアンダースコア（_）で構成される文字列で指定します。定義名一つの文字列長は1～32文字です。
定義名を複数指定する場合は，コンマ（,）で区切ります。コンマの前後の空白文字※2は無視されます。また，同じエラーページカスタマイズ定義名を複数回指定できません。
不正な値を指定した場合，メッセージが出力され，すべてのエラーページカスタマイズ定義は無効となります。
なし

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.file
エラーページカスタマイズ機能で，エラーページカスタマイズ時のレスポンスボディとして使用するファイルを絶対パスで指定します。
パスの区切り記号には”/”を使用します。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合，プロパティは無効になります。
webserver.connector.inprocess_http.error_custom.listで指定したエラーページカスタマイズ定義名について，このプロパティ，またはwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.redirect_urlのどちらか一方だけを必ず指定してください。両方のプロパティを指定した場合，どちらも指定しなかった場合，絶対パスで指定しなかった場合，または存在しないファイルや読み取り権限のないファイルを指定した場合は，メッセージが出力され，このエラーページカスタマイズ定義は無効となります。
空文字列または空白文字※2を指定した場合，プロパティは無効になります。
なし

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.file.content_type
エラーページカスタマイズ機能で，エラーページカスタマイズ時のレスポンスのContent-Typeヘッダの値を指定します。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合，プロパティは無効となります。
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.fileが設定されていない場合，プロパティは無効になります。
text/html

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.redirect_url
エラーページカスタマイズ機能で，リダイレクトURLを絶対URLで指定します。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合，プロパティは無効となります。
webserver.connector.inprocess_http.error_custom.listで指定したエラーページカスタマイズ定義名について，このプロパティ，またはwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.fileのどちらか一方だけを必ず指定してください。
値が正しいかどうかのチェックは行われないため，実際に動作させて確認する必要があります。
なし

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.request_url
エラーページカスタマイズ機能で，エラーページカスタマイズを適用するリクエストURLをスラッシュ（/）で始まる絶対パスで指定します。ワイルドカード（*）はスラッシュの直後に1回だけ指定できます。"*"は必ずワイルドカードと解釈されるため，通常の文字としては使用できません。
また，このプロパティで指定した値とwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.statusで指定した値は，ほかのエラーページカスタマイズ定義と完全に一致してはいけません。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合，プロパティは無効となります。
不正な値を指定した場合，メッセージが出力され，このエラーページカスタマイズ定義は無効となります。
/*

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.status
エラーページカスタマイズ機能で，エラーページのカスタマイズを行うレスポンスのステータスコードを400～599の整数で指定します。
このプロパティで指定した値，およびwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.request_urlで指定した値は，ほかのエラーページカスタマイズ定義と完全に一致してはいけません。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合，プロパティは無効となります。
webserver.connector.inprocess_http.error_custom.listで指定したエラーページカスタマイズ定義名について，このプロパティは必ず指定してください。指定しなかった場合，または不正な値を指定した場合，メッセージが出力され，このエラーページカスタマイズ定義は無効となります。
なし

webserver.connector.inprocess_http.gateway.host
ゲートウェイのホスト名またはIPアドレスを指定します。Hostヘッダのないリクエストに対してwelcomeファイルなどにリダイレクトするとき，Locationヘッダに指定するURLのホスト名部分が指定値となります。
なし

webserver.connector.inprocess_http.gateway.port
ゲートウェイのポート番号を1～65535の整数で指定します。
Hostヘッダのないリクエストに対してwelcomeファイルなどにリダイレクトするとき，Locationヘッダに指定するURLのポート番号部分が指定値となります。
webserver.connector.inprocess_http.gateway.hostが指定されていない場合は，このプロパティの指定は無視されます。
また，webserver.connector.inprocess_http.gateway.hostを指定し，このプロパティを省略した場合は下記の値が設定されます。

webserver.connector.inprocess_http.gateway.https_schemeにtrueを指定している場合：443

webserver.connector.inprocess_http.gateway.https_schemeにfalseを指定している場合，または未指定の場合：80

数値以外の文字列，または範囲外の数値を指定した場合は，メッセージが出力され，指定されなかったものとみなされます。
なし

webserver.connector.inprocess_http.gateway.https_scheme
クライアントからのリクエストのスキームはhttpsで，SSLアクセラレータなどによってWebサーバへのスキームがhttpとなる場合にtrueを指定します。

trueを指定した場合：

Webサーバへのリクエストのスキームがhttpsとみなされます。

falseを指定した場合：

何もしません。

trueまたはfalse以外の文字列を指定した場合，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
false

webserver.connector.inprocess_http.hostname_lookups
インプロセスHTTPサーバで受信したリクエストに対して，Webコンテナがホスト名のルックアップの逆引きをしてクライアントのIPアドレスをホスト名に変換するかどうかを指定します。
ただし，ホスト名の逆引きをすると，スループットが低下します。
ホスト名を解決しなかった場合，javax.servlet.ServletRequestインタフェースのgetRemoteHost()メソッドの結果や，ログファイルに出力するクライアントのIPアドレスは，ドット（.）で区切られた書式のIPアドレスとなります。

trueを指定した場合：

IPアドレスをホスト名に変換します。

falseを指定した場合：

IPアドレスをホスト名に変換しません。

trueまたはfalse以外の文字列を指定した場合，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
false

webserver.connector.inprocess_http.init_threads
サーバ起動時に生成するインプロセスHTTPサーバのリクエスト処理スレッド数を1～1024の整数で指定します。
指定する値は，Webクライアントとの最大接続数（webserver.connector.inprocess_http.max_connectionsに指定した値）以下である必要があります。これを超える値を指定した場合，メッセージが出力され，Webクライアントとの最大接続数が値として設定されます。
また，有効な最大値は実行するOSによって異なります。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
10

webserver.connector.inprocess_http.keep_start_threads
サーバ起動時に作成したスレッド数を維持するかどうかを指定します。

trueを指定した場合：

サーバ起動時に作成したスレッド数を維持します。プールに保持された予備スレッド数が，予備スレッド数の最大数（webserver.connector.inprocess_http.max_spare_threadsに指定した値）を超えた状態でも，サーバ起動時に作成したスレッド数を下回りません。

falseを指定した場合：

サーバ起動時に作成したスレッド数を維持しません。予備スレッドとして保持する最大数，最小数に従って調節します。

また，サーバ起動時に作成したスレッド数が予備スレッド数の最小数（webserver.connector.inprocess_http.min_spare_threadsに指定した値）よりも小さい場合，このプロパティの設定に関係なく予備スレッドの最小数に指定した値でスレッド数が維持されます。
このプロパティにfalseを指定した場合，サーバ起動時に作成したスレッドは予備スレッド数の最大数以下になるように調整されます。サーバ起動時に予備スレッドの最大数より大きい数のリクエスト処理スレッドを作成した場合，予備スレッドの最大数を超えたスレッドは，サーバ起動後に1秒間隔で一つずつ破棄されます。
trueまたはfalse以外の文字列を指定した場合，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
false

webserver.connector.inprocess_http.limit.max_headers
HTTPリクエストに含まれるHTTPヘッダの個数の上限を0～32767の整数で指定します。上限値を設定しない場合は，0を指定してください。
このプロパティで指定したHTTPヘッダの個数に満たない場合でも，webserver.connector.inprocess_http.limit.max_request_headerで指定したサイズを超えた場合はエラーとなります。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
100

webserver.connector.inprocess_http.limit.max_request_body
HTTPリクエストのリクエストボディの最大サイズ（単位：バイト）を-1～2147483647の整数で指定します。上限値を設定しない場合は，-1を指定してください。また，リクエストボディがチャンク形式で送信された場合，チャンクヘッダのサイズも指定するサイズに含める必要があります。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
-1

webserver.connector.inprocess_http.limit.max_request_header
HTTPリクエストのリクエストヘッダの最大サイズ（単位：バイト）を7～65536の整数で指定します。
このプロパティで設定したリクエストヘッダの最大サイズに満たない場合でも，webserver.connector.inprocess_http.limit.max_headersで指定したHTTPヘッダを超えた場合はエラーとなります。
また，HTTPヘッダの終わりを示す改行文字（CR(0x0d)+LF(0x0a)の2バイト）も指定するサイズに含める必要があります。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
16384

webserver.connector.inprocess_http.limit.max_request_line
リクエストラインの最大長（単位：バイト）を-1または7～8190の整数で指定します。上限値を指定しない場合は，-1を指定してください。リクエストラインは，HTTPメソッドやクエリ文字列を含む，URIおよびHTTPバージョンを含みます。
指定する値は，リクエストヘッダの最大サイズ（webserver.connector.inprocess_http.limit.max_request_headerに指定した値）以下である必要があります。これを超える値を指定した場合は，メッセージが出力され，リクエストヘッダの最大サイズがリクエストラインの最大長として設定されます。
また，リクエストラインの終わりを示す改行文字（CR(0x0d)+LF(0x0a)の2バイト）も指定するサイズに含める必要があります。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
8190

webserver.connector.inprocess_http.max_connections
Webクライアントとの最大接続数を1～1024の整数で指定します。有効な最大値は実行するOSによって異なります。
このパラメタに指定した値がリクエスト処理スレッドの最大値になります。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
100

webserver.connector.inprocess_http.max_execute_threads
Webコンテナがリクエストを処理する同時実行数を1～1024の整数で指定します。
指定する値は，Webクライアントとの最大接続数（webserver.connector.inprocess_http.max_connectionsに指定した値）以下である必要があります。これを超える値を指定した場合は，メッセージが出力され，Webクライアントとの最大接続数が値に設定されます。
数値以外の文字列や範囲外の数値，空文字列または，空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
10

webserver.connector.inprocess_http.max_spare_threads
プールに保存する予備スレッドの最大数を1～1024の整数で指定します。
指定する値は，Webクライアントとの最大接続数（webserver.connector.inprocess_http.max_connectionsに指定した値）以下である必要があります。これを超える値を指定した場合は，メッセージが出力され，Webクライアントとの最大接続数が値に設定されます。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
20

webserver.connector.inprocess_http.min_spare_threads
プールに保持する予備スレッドの最小数を1～1024の整数で指定します。
設定する値はプールに保持する予備スレッドの最大数（webserver.connector.inprocess_http.max_spare_threadsに指定した値）以下である必要があります。プールに保持する予備スレッドの最大数を超える値を設定した場合は，メッセージが出力され，プールに保持する予備スレッドの最大数がプールに保持する予備スレッドの最小数として設定されます。
数値以外の文字列や範囲外の数値，空文字列，または空白文字※2を指定した場合は，メッセージが出力されデフォルト値が設定されます。
5

webserver.connector.inprocess_http.permitted.hosts
インプロセスHTTPサーバへのアクセスを許可するホストのIPアドレス（10進表記），またはホスト名を指定します。複数指定する場合は，IPアドレスまたはホスト名の間をコンマ（,）で区切ります。アクセス制限をしない場合はアスタリスク（*）だけを指定します。
なお，ローカルホストは明記しなくても常にアクセスが許可されます。
空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
指定されたホスト名が解決できない場合は，メッセージが出力され，ローカルホストからのアクセスだけが許可されます。
なお，IPアドレスまたはホスト名の前後の半角スペースは無視されます。
*

webserver.connector.inprocess_http.persistent_connection.max_connections
Persistent Connectionで保持するTCPコネクションの最大数を0～1024の整数で指定します。
設定する値はWebクライアントとの最大接続数（webserver.connector.inprocess_http.max_connectionsに指定した値）以下である必要があります。Webクライアントとの最大接続数を超える値を設定した場合は，メッセージが出力され，Webクライアントとの最大接続数がPersistent Connectionで保持するTCPコネクションの最大数として設定されます。
数値以外の文字列や範囲外の数値を指定した場合は，メッセージが出力され，webserver.connector.inprocess_http.max_connectionsに指定した値がデフォルト値として設定されます。また，空文字列または空白文字※2を指定した場合は，webserver.connector.inprocess_http.max_connectionsに指定した値がデフォルト値として設定されます。
webserver.connector.inprocess_http.max_connectionsに指定した値

webserver.connector.inprocess_http.persistent_connection.max_requests
Persistent ConnectionによるTCPコネクションを持続したままの連続接続回数の上限を0～2147483647の整数で指定します。上限値を設定しない場合は，0を指定してください。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
100

webserver.connector.inprocess_http.persistent_connection.timeout
Persistent ConnectionでTCPコネクションを持続した状態での，リクエスト待ち時間（単位：秒）を0～3600の整数で指定します。0を指定した場合，タイムアウトしません。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
3

webserver.connector.inprocess_http.port
インプロセスHTTPサーバが使用するポート番号を1～65535の整数で指定します。すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号や確保されているポート番号を指定した場合，メッセージが出力され，J2EEサーバが起動されません。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
80

webserver.connector.inprocess_http.receive_timeout
Webクライアントからのリクエスト受信で，タイムアウトするまでの時間（単位：秒）を0～3600の整数で指定します。0を指定した場合，タイムアウトしません。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
300

webserver.connector.inprocess_http.redirect.list
リダイレクト機能で使用するリダイレクト定義名を指定します。
このプロパティに指定できる値の最大長は1024文字です。リダイレクト定義名は，英数字（A～Z，a～z，0～9）またはアンダースコア（_）で構成される文字列で指定します。また，リダイレクト定義名一つの文字列長は1文字～32文字です。
リダイレクト定義名を複数指定する場合は，コンマ（,）で区切ります。コンマの前後の空白文字※2は無視されます。同じリダイレクト定義名は複数回指定できません。
不正な値を指定した場合は，メッセージが出力され，すべてのリダイレクト定義は無効となります。
なし

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.file
リダイレクト機能で，リダイレクト時のレスポンスボディとして使用するファイルを絶対パスで指定します。パスの区切り記号には”/”を使用します。
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.statusに200を指定した場合，必ずこのプロパティを指定します。webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.statusに200を指定し，このプロパティが指定されていない場合，メッセージが出力され，このリダイレクト定義は無効となります。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合，空文字列または空白文字※2を指定した場合，プロパティは無効となります。
絶対パスでない値を指定した場合は，メッセージが出力され，このリダイレクト定義は無効となります。存在しないファイルや読み取り権限のないファイルを指定した場合は，J2EEサーバ起動時にメッセージが出力され，このリダイレクト定義は無効となります。
なし

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.file.content_type
リダイレクト機能で，リダイレクト時のレスポンスのContent-Typeヘッダの値を指定します。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合，プロパティは無効となります。
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.fileを設定していない場合，プロパティは無効となります。
text/html

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.redirect_url
リダイレクト機能で，リダイレクトURLを絶対URLで指定します。
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.status に 200を指定した場合，このプロパティは設定できません。webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.statusに200を指定し，このプロパティを指定した場合，メッセージが出力され，リダイレクト定義は無効となります。
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.statusに200以外を指定した場合，必ずこのプロパティを指定します。webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.status に 200以外を指定し，このプロパティを指定しなかった場合，メッセージが出力され，そのリダイレクト定義は無効となります。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合，プロパティは無効となります。
値が正しいかどうかのチェックは行われないため，実際に動作させて確認する必要があります。
なし

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.request_url
リダイレクト機能で，リダイレクトを行うリクエストURLをスラッシュ（/）で始まる絶対パスで指定します。ワイルドカード（*）はスラッシュの直後に1回だけ指定できます。ワイルドカードは0文字以上の任意の文字列を表します。"*"は必ずワイルドカードと解釈されるため，通常の文字としては使用できません。また，ほかのリダイレクト定義で指定した値と同じ値は指定できません。
webserver.connector.inprocess_http.redirect.listで指定したリダイレクト定義名について，必ずこのプロパティを指定する必要があります。指定しなかった場合，メッセージが出力され，そのリダイレクト定義は無効となります。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合，プロパティは無効となります。
不正な値を指定した場合は，メッセージが出力され，そのリダイレクト定義は無効となります。
なし

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.status
リダイレクト機能で，リダイレクト時のレスポンスのステータスコード（200，300，301，302，303，305，307）を指定します。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合，プロパティは無効となります。
不正な値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
302

webserver.connector.inprocess_http.rejection_threads
アクセスを拒否するリクエスト処理スレッドの数を0～1023の整数で指定します。指定する値は，リクエスト処理スレッドの最大数（webserver.connector.inprocess_http. max_connectionsに指定した値）よりも小さくする必要があります。Webクライアントとの最大接続数以上の値を設定した場合は，メッセージが出力され，Webクライアントとの最大接続数よりも１小さい値がアクセスを拒否するリクエスト処理スレッド数として設定されます。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
1

webserver.connector.inprocess_http.response.header.server
レスポンスに自動的に付加するServerヘッダの値を指定します。
空文字列または空白文字※2を指定した場合，メッセージが出力され，デフォルト値が設定されます。
CosminexusComponentContainer

webserver.connector.inprocess_http.send_timeout
Webクライアントへのレスポンス送信で，タイムアウトするまでの時間（単位：秒）を0～3600の整数で指定します。0を指定した場合，タイムアウトは有効になりません。
数値以外の文字列や範囲外の数値，空文字列または空白文字※2を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
300

webserver.connector.redirect_https.port
Webサーバが使用しているHTTPSのポート番号を指定します。
1～65535の整数で指定します。
指定しない場合，HTTPSポートにリダイレクトしません。
すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また，複数のJ2EEサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したJ2EEサーバはcjstartsvコマンドで複数起動できません。
なし

注※1

有効な最大値は実行するプラットフォームに依存します。

Webサーバに到着するリクエストの一部がWebコンテナに転送されるため，Webサーバの最大同時接続数は，実行待ちキューサイズの総和＋Webコンテナ単位の最大同時実行スレッド数より大きく設定する必要があります。
また，データベース操作をするサーブレットやJSPについては，データベースコネクションの数よりも多くの多重度は得られないため，Webコンテナの同時実行数を増やす場合は，利用できるデータベースコネクションの数も増やす必要があります。
性能のチューニング時には，次に示す関係を常に考慮して，各パラメタの値を調整してください。
<Webサーバの最大同時接続数> ＞ <実行待ちキューサイズの総和>＋<Webコンテナ単位の最大同時実行スレッド数>
<Webコンテナ単位の最大同時実行スレッド数> ≧ <データベースコネクションの数>
Webコンテナでの同時実行スレッド数の制御については，マニュアル「Cosminexus　機能解説」を参照してください。
Webサーバでの処理の同時接続数についてはWebサーバのマニュアルを参照してください。

注※2

空白文字とは，半角スペース，タブ，LF（0x0a），CR（0x0d）またはFF（0x0c）のことを指します。

(ae)　webserver.containerから始まるキー

キー名称
内容
デフォルト値

webserver.container.ac.logEnabled
Webコンテナの保守用のトレースログを出力するかどうかを指定します。

trueを指定した場合：

トレースログを出力します。

falseを指定した場合：

トレースログを出力しません。

false

webserver.container.server_id.enabled
サーバIDのCookieをHTTPレスポンスに付加するかどうかを指定します。

trueを指定した場合：

サーバIDのCookieをHTTPレスポンスに付加します。webserver.container.server_id.valueで，サーバIDを指定してください。

falseを指定した場合：

サーバIDのCookieをHTTPレスポンスに付加しません。

trueまたはfalse以外の文字列を指定した場合，空文字列，または空白文字※を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
false

webserver.container.server_id.name
サーバIDのCookieをHTTPレスポンスに付加する場合に，Cookieの名前を指定します。1～64文字の文字列で指定します。半角英数字（A～Z，a～z，0～9）またはアンダースコア（_）が使用できます。ただし，次の名前はWebコンテナが使用するため，大文字・小文字の区別なく使用できません。

JSESSIONID

不正な値を指定した場合は，警告メッセージが出力されて，デフォルト値が設定されます。
ServerID

webserver.container.server_id.value
サーバIDのCookieをHTTPレスポンスに付加する場合に，Cookieの値を指定します。1～64文字の文字列で指定します。半角英数字（A～Z，a～z，0～9）またはアンダースコア（_）が使用できます。
webserver.container.server_id.enabledにtrueを指定した場合に，このプロパティを省略したとき，または不正な値，空文字列，もしくは空白文字※を指定したときは，メッセージが出力され，デフォルト値が設定されます。
また，プロパティのデフォルト値にはサーバ環境の情報が含まれています。この値はクライアントに送信されるため，サーバ環境の情報を含まない値を明示的に指定することを推奨します。

Webサーバ連携の場合：
Webコンテナを実行するホストのIPアドレスとWebサーバとの通信に使用するポート番号から生成する文字列

インプロセスHTTPサーバの場合：
Webコンテナを実行するホストのIPアドレスとインプロセスHTTPサーバが使用するポート番号から生成する文字列

webserver.container.thread_control.enabled
Webアプリケーション単位の同時実行スレッド数の制御機能を使用するかどうかを指定します。J2EEサーバモードでだけ有効です。

trueを指定した場合：

Webアプリケーション単位の同時実行スレッド数の制御機能を有効にします。

falseを指定した場合：

Webアプリケーション単位の同時実行スレッド数の制御機能を無効にします。

true

webserver.container.thread_control.queue_size
Webアプリケーション単位の同時実行スレッド数の制御機能を使用する場合に，デフォルトの実行待ちキューサイズを0～2147483647の整数で指定します。J2EEサーバモードでだけ有効です。
8192

注※

空白文字とは，半角スペース，タブ，LF（0x0a），CR（0x0d）またはFF（0x0c）のことを指します。

(af)　webserver.contextから始まるキー

キー名称
内容
デフォルト値

webserver.context.check_interval
Webアプリケーションの更新検知インターバルを0～2147483647の範囲（単位：秒）の整数で指定します。
0を指定した場合，更新の自動検知は行われません。
J2EEアプリケーションのリロード機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列，範囲外の数値または空文字列を指定した場合はメッセージを出力し，デフォルト値が設定されます。
ejbserver.deploy.context.check_intervalに設定した値（デフォルト値：0）

webserver.context.reload_delay_timeout
Webアプリケーションのリロードの遅延実行機能の最大遅延期間を，負の整数または0～2147483647（単位：秒）で指定します。
0を指定した場合は，リロードの遅延実行機能は使用されません。
J2EEアプリケーションのリロード機能が無効な場合，このプロパティは設定できません。設定した場合無視されます。
負の整数を指定した場合は，最大遅延期間を設定しないで，リロードの遅延実行機能が使用されます。
0

webserver.context.update.interval
更新するファイルのコピーに必要な時間のインターバルを0～2147483647の範囲（単位：秒）の整数で指定します。なお，インターバルは余裕のある値にしてください。リソースの更新を検知してから指定したインターバルのあとに，処理中リクエストの監視が開始されます。
JSPのリロード機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列，範囲外の数値または空文字列を指定した場合はメッセージを出力し，デフォルト値が設定されます。
ejbserver.deploy.context.update.interval（デフォルト値：0）

(ag)　webserver.errorpageから始まるキー

キー名称
内容
デフォルト値

webserver.errorpage.stack_trace.enabled
例外発生時，デフォルトのエラーページにスタックトレースを出力するかどうかを指定します。

trueを指定した場合：

スタックトレースを出力します。

falseを指定した場合：

スタックトレースを出力しません。

trueまたはfalse以外の文字列を指定した場合，空文字列または空白文字※を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
false

注※

空白文字とは，半角スペース，タブ，LF（0x0a），CR（0x0d）またはFF（0x0c）のことを指します。

(ah)　webserver.httpから始まるキー

キー名称
内容
デフォルト値

webserver.http.request.encoding
リクエストボディおよびクエリのデコードに使用する文字エンコーディングを指定します。
デフォルトの文字エンコーディングとして設定できる文字は，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また，指定できる文字列は，java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング，およびそれらの別名になります。
なし

webserver.http.response.encoding
レスポンスボディのエンコードに使用する文字エンコーディングを指定します。
デフォルトの文字エンコーディングとして設定できる文字は，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また，指定できる文字列は，java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング，およびそれらの別名になります。
なし

(ai)　webserver.jspから始まるキー

キー名称
内容
デフォルト値

webserver.jsp.check_interval
JSPの更新検知インターバルを0～2147483647の範囲（単位：秒）の整数で指定します。
0を指定した場合，更新の自動検知は行われません。
JSPのリロード機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列，範囲外の数値または空文字列を指定した場合はメッセージを出力し，デフォルト値が設定されます。
ejbserver.deploy.context.check_intervalに設定した値（デフォルト値：0）

webserver.jsp.compile.backcompat
JSPから生成されたサーブレットのjavaソースのコンパイル時に，javaソースコードのバージョンを指定します。このプロパティは，旧バージョンで生成されたJSP内のスクリプティングでJavaコードをJSP内に記述しているため，Cosminexusが提供するJavaVMのバージョンではコンパイルできない場合に指定します。Java VMのバージョンに依存しない場合，このプロパティを省略するか，falseを指定します。
指定できる値を次に示します。

1.4：

J2SE 1.4に従ったJavaソースを出力します。J2SE 5.0ではエラーとなるJ2SE 1.4に依存したソースコードをJSPファイルのスクリプティングに記述している場合に指定します。

1.3：

J2SE 1.3に従ったJavaソースを出力します。J2SE 5.0ではエラーとなるJ2SE 1.3に依存したソースコードをJSPファイルのスクリプティングに記述している場合に指定します。

1.2：

J2SE 1.2に従ったJavaソースを出力します。J2SE 5.0ではエラーとなるJ2SE 1.2に依存したソースコードをJSPファイルのスクリプティングに記述している場合に，指定します。

true：

J2SE 1.2に従ったJavaソースを出力します。J2SE 5.0ではエラーとなるJ2SE 1.2に依存したソースコードをJSPファイルのスクリプティングに記述している場合に，指定します。

false：

JSPファイル内にスクリプティングを記述していない場合，スクリプティングを記述している場合でもJ2SEのバージョンに依存しない場合に指定します。

指定可能なパラメタ値以外の文字列，空文字列または空白文字※を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
false

webserver.jsp.keepgenerated
JSPファイル，またはタグファイルのコンパイルで生成されたjavaファイルを保持するかどうかを指定します。
次の値を指定します。

trueを指定した場合：

javaファイルを保持します。

falseを指定した場合：

javaファイルを保持しません。

false

webserver.jsp.pageEncoding
JSPの文字エンコーディングを指定します。デフォルトの文字エンコーディングとして設定できる文字は，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また，指定できる文字列は，java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング，およびそれらの別名になります。
なし

webserver.jsp.precompile.jsp_work_dir
JSP事前コンパイル機能によって生成されたJSPファイルのコンパイル結果の格納先ディレクトリ名を指定します。
ディレクトリ名は，半角の英数字（A～Z，a～z，0～9）またはアンダースコア（_）で構成される文字列で指定します。
不正な値を指定した場合は，メッセージが出力され，デフォルト値が設定されます。また，予約語である次の文字列を指定した場合は，メッセージが出力され，デフォルト値を使用します。

classes

lib

tags

cosminexus_jsp_work

webserver.jsp.translation.backcompat.customAction.declareVariable
複数のカスタムタグで，スクリプト変数名とスクリプト変数のスコープが重複する場合，JSPファイルから生成されたJavaコードで2回目のカスタムタグに対応するスクリプト変数の変数宣言を出力するかどうかを指定します。

true：

2回目以降のスクリプト変数を宣言します。

false：

2回目以降のスクリプト変数を宣言しません。(*)スクリプト変数のスコープは，javax.servlet.jsp.tagext.TagExtraInfoクラスのサブクラス，またはTLDファイルのvariable要素内のscope要素で指定できます。

false

webserver.jsp.translation.backcompat.taglib.noCheckPrefix
taglibディレクティブの前に，taglibディレクティブで指定したprefixを使用したカスタムタグを記述しているかチェックするかどうかを指定します。

true：

チェックしない。

false：

チェックする。

false

webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue
Expressionが指定できないタグの属性値にExpressionが指定されているかどうか検証するかどうかを指定します。

true：

Expressionが指定されているかどうかを検証します。

false

Expressionが指定されているかどうかを検証しません。

false

webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate
タグの属性値が，「"<%=」または「'<%=」で開始しており，「%>"」（「'<%」で開始した場合は「%>'」）で終了していない属性値の「"」（または「'」）で囲まれた値を文字列として扱うかどうかを指定します。

true：

「"」までを文字列として扱います。

false：

「%>"」までを属性値とします。

false

webserver.jsp.translation.backcompat.useBean.noCheckClass
JSPトランスレーション時に<jsp:useBean>タグのクラス属性値のチェック処理を実行するかどうかを指定します。

true：

クラス属性値をチェックしません。

false：

クラス属性値をチェックします。

false

webserver.jsp.update.interval
JSPのリロード監視対象ファイルのコピーに必要な時間のインターバルを0～2147483647の範囲（単位：秒）の整数で指定します。なお，インターバルは余裕のある値にしてください。JSPファイルの更新を検知してから指定したインターバルのあとに，JSPのリロードが実行されます。
JSPのリロード機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列，範囲外の数値または空文字列を指定した場合はメッセージを出力し，デフォルト値が設定されます。
ejbserver.deploy.context.update.intervalに設定した値（デフォルト値：0）

注※

空白文字とは，半角スペース，タブ，LF（0x0a），CR（0x0d）またはFF（0x0c）のことを指します。

(aj)　webserver.loggerから始まるキー

キー名称
内容
デフォルト値

webserver.logger.access_log.inprocess_http.enabled
インプロセスHTTPサーバのアクセスログ機能の有効・無効を設定します。

trueを指定した場合：

アクセスログ機能を有効にします。

falseを指定した場合：

アクセスログ機能を無効にします。

trueまたはfalse以外の文字列を指定した場合，空文字列または空白文字※1を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
true

webserver.logger.access_log.format_list
インプロセスHTTPサーバのアクセスログ機能で使用するフォーマット名を指定します。
指定できる文字列の最大長は1024文字です。フォーマット名は，英数字（A～Z，a～z，0～9）またはアンダースコア（_）で構成される文字列で指定します。また，一つ当たりのフォーマット名の文字列長は最大32文字です。format_listとmode_listは不正なフォーマット名として扱われるため，フォーマット名に指定できません。フォーマット名を複数指定する場合は，コンマ（,）で区切ります。一つ目に設定されたフォーマット名が指すフォーマット名はデフォルトのフォーマット名として扱われます。また，同じフォーマット名を複数回指定できません。commonとcombinedはアクセスログ機能での予約フォーマットのため指定できません。

（設定形式）

<フォーマット名>[,<フォーマット名>]*

（[]*：[ ]部分の0回以上の繰り返しを示します）

次の場合はメッセージが出力され，デフォルト値が設定されます。

文字列が何も指定されていない。

フォーマット名が32文字を超えた。

不正なフォーマット名を指定した。

プロパティに指定できる値の最大長が1024文字を超えた。

同じフォーマット名を複数回指定した。

予約フォーマットのcommon，combinedのどちらか，または両方を削除した。

common,combined

webserver.logger.access_log.<フォーマット名>
<フォーマット名>で定義されるアクセスログのフォーマットの形式※2をフォーマット引数で指定します。
指定できる値の最大長は1024文字です。使用できる文字は，アスキーコードの32（10進数）以上127（10進数）未満の文字です。
webserver.logger.access_log.format_listに定義されたすべてのフォーマット名について，webserver.logger.access_log.<フォーマット名>を設定する必要があります。webserver.logger.access_log.format_listに定義されていないフォーマット名でこのプロティを設定した場合，プロパティは無効となります。ただし，commonとcombinedのフォーマット名は指定する必要はありません。commonとcombinedのフォーマット名を指定した場合は，無効となります。
文字列が何も指定されていない場合，フォーマット形式が1024文字を超えた場合，または範囲外の文字を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
%h %l %u %t "%r" %>s %b

webserver.logger.access_log.inprocess_http.filename
インプロセスHTTPサーバのアクセスログ機能で使用するログを出力するファイル名※3を絶対パスで指定します。指定できる値の最大長は210文字です。
210文字を超えた文字列を指定した場合，範囲外の数値や文字を指定した場合，または文字列が何も指定されていない場合は，メッセージが出力され，デフォルト値が設定されます。
指定したディレクトリが存在しない場合は，ディレクトリが作成されます。ディレクトリが作成されなかった場合は，J2EEサーバの起動に失敗します。

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥http¥cjhttp_access.inprocess_http

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/http/cjhttp_access.inprocess_http

webserver.logger.access_log.inprocess_http.filenum
インプロセスHTTPサーバのWebコンテナのログファイルの面数を1～256の整数で指定します。
数値以外の文字列や範囲外の数値を指定した場合，または文字列が何も指定されていない場合は，メッセージが出力され，デフォルト値が設定されます。
16

webserver.logger.access_log.inprocess_http.filesize
インプロセスHTTPサーバのアクセスログファイルのサイズ（単位：バイト）を4096～2147483647の整数で指定します。
数値以外の文字列や範囲外の数値を指定した場合，または文字列が何も指定されていない場合は，メッセージが出力され，デフォルト値が設定されます。
なお，アクセスログファイルのラップアラウンドの判定はログを書き込む前に行われるため，指定したファイルサイズを超える場合があります。
4194304

webserver.logger.access_log.inprocess_http.usage_format
インプロセスHTTPサーバのアクセスログ機能で使用するフォーマットを選択します。
文字列が何も指定されていない場合，定義されていないフォーマット名を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
common

webserver.logger.communication_trace.inprocess_http.filenum
インプロセスHTTPサーバの通信トレース機能のログファイルの面数を1～256の整数で指定します。
数値以外の文字列や範囲外の数値を指定した場合，または文字列が何も指定されていない場合は，メッセージが出力され，デフォルト値が設定されます。
16

webserver.logger.thread_trace.inprocess_http.filenum
インプロセスHTTPサーバのスレッドトレース機能のログファイルの面数を1～256の整数で指定します。数値以外の文字列や範囲外の数値を指定した場合，または文字列が何も指定されていない場合は，メッセージが出力され，デフォルト値が設定されます。
16

注※1

空白文字とは，半角スペース，タブ，LF（0x0a），CR（0x0d）またはFF（0x0c）のことを指します。

注※2

指定できるフォーマット引数と出力例を次の表に示します。

フォーマット引数
出力内容
出力例

%%
% 記号。
%

%a
WebクライアントのIPアドレス。
10.20.30.40

%A
J2EEサーバのIPアドレス。
10.20.30.100

%b
HTTPヘッダを除く送信バイト数。0バイトのときは「-」となります。
2048

%B
HTTPヘッダを除く送信バイト数。0バイトのときは「0」となります。
1024

%h
Webクライアントのホスト名またはIPアドレス。ホスト名が得られない場合はIPアドレスとなります。
10.20.30.40

%H
リクエストプロトコル。
HTTP/1.1

%l
リモートログ名（RFC 1413で規定されているIdentificationプロトコルによって得られるWebクライアント側のユーザ名）。
-

%m
リクエストメソッド。
GET

%p
Webクライアントからのリクエストを受け付けたポート番号。
80

%q
クエリ文字列。「?」から始まります。クエリ文字列がない場合は空文字となります。
?id=100&page=15

%r
リクエストライン。
GET /index.html HTTP/1.1

%>s
最終ステータスコード（内部リダイレクトされた値は出力しません）。
200

%S
ユーザのセッションID。セッションIDがない場合は「-」となります。
%Sで表示されるセッションIDはクッキー名JSESSIONIDの値であり，セッションフェイルオーバ機能でのグローバルセッションIDとは異なります。グローバルセッションIDを出力する場合は，%{GSESSIONID}cを指定します。GIDCookieNameを変更した場合は，変更したGIDCookieNameの値を指定します。
00455AFE4DA4E7B7789F247B8FE5D605

%t
Webクライアントのリクエストに応答した時刻[dd/MMM/YYYY:HH:mm:ss Z]。
[18/Jan/2005:13:06:10 +0900]

%T
Webクライアントのリクエストの処理に要した時間（単位：秒）。
2

%d
Webクライアントのリクエストに応答した時刻。次の形式で表示します。[dd/MMM/YYYY:HH:mm:ss.nnn Z]（nnnはミリ秒）
[18/Jan/2005:13:06:10.152 +0900]

%D
Webクライアントのリクエストの処理に要した時間（単位：ミリ秒）。
2000

%u
ベーシック認証ユーザ名，またはフォーム認証ユーザ名。認証ユーザ名がない場合は「-」となります。
user

%U
リクエストファイルパス。
/index.html

%v
J2EEサーバのローカルホスト名。
server

%{foo}i
リクエストヘッダfooの内容。fooヘッダが存在しない場合は「-」になります。
一度のHTTPリクエストまたはHTTPレスポンスで同じヘッダ名が複数回送信された場合，最初に読み込んだヘッダの内容を出力します。
%{Host}iの場合
www.example.com:8888

%{foo}c
Webクライアントが送信したCookie情報でCookieの名前がfooの内容。Cookieの名前にfooがない場合は「-」になります。
%{JSESSIONID}cの場合
00455AFE4DA4E7B7789F247B8FE5D605

%{foo}o
レスポンスヘッダfooの内容。fooヘッダが存在しない場合は「-」になります。
一度のHTTPリクエストまたはHTTPレスポンスで同じヘッダ名が複数回送信された場合，最初に読み込んだヘッダの内容を出力します。
%{Server}oの場合
CosminexusComponentContainer

注※3

ファイル名の末尾に<連番>.logが追加されます。

(ak)　webserver.sessionから始まるキー

キー名称
内容
デフォルト値

webserver.session.max.log_interval
HttpSession数の上限値を超えてHttpSessionオブジェクトを生成しようとした場合に出力されるメッセージKDJE39225-Eのインターバルを，0～2147483647の整数（単位：秒）で指定します。
メッセージKDJE39225-Eが出力されてからこのプロパティで指定したインターバルの間，メッセージKDJE39225-Eの出力を抑止します。なお，この設定はWebアプリケーション単位に適用されます。
数値以外の文字列や範囲外の数値を指定した場合は，警告メッセージが出力され，デフォルト値が設定されます。
60

webserver.session.server_id.enabled
セッションIDにサーバIDを付加するかどうかを指定します。

trueを指定した場合：

セッションIDにサーバIDを付加します。

falseを指定した場合：

セッションIDにサーバIDを付加しません。

通常はtrueを指定し，webserver.session.server_id.valueで，サーバIDを指定してください。06-51以前から06-70以降に移行すると，このプロパティのデフォルト値がfalseからtrueに変更になります。trueの場合は，falseの場合に比べてセッションIDの文字列長がサーバIDの長さ分増加します。これによって問題が発生する場合，次の対処をしてください。

負荷分散機によって複数のWebコンテナでシステムを冗長構成にしていない場合：

falseを指定し，サーバIDをセッションIDに付加しないでください。

負荷分散機によって複数のWebコンテナでシステムを冗長構成にしている場合：

trueを指定し，セッションIDの文字列長が増加することで発生する問題を対策してください。falseを指定した場合，動作は保証できません。

trueまたはfalse以外の文字列を指定した場合，空文字列または空白文字※を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
true

webserver.session.server_id.value
セッションIDに付加するサーバIDを，1～64文字の文字列で指定します。半角英数字（A～Z，a～z，0～9）またはアンダースコア（_）が使用できます。
webserver.session.server_id.enabledにtrueを指定し，このプロパティを省略した場合，またはプロパティに不正な値，空文字列，もしくは空白文字※を指定した場合，メッセージが出力され，デフォルト値が設定されます。
また，プロパティのデフォルト値にはサーバ環境の情報が含まれています。この値はクライアントに送信されるため，サーバ環境の情報を含まない値を明示的に指定することを推奨します。

Webサーバ連携の場合：
Webコンテナを実行するホストのIPアドレスとWebサーバとの通信に使用するポート番号から生成する文字列

インプロセスHTTPサーバの場合：
Webコンテナを実行するホストのIPアドレスとインプロセスHTTPサーバが使用するポート番号から生成する文字列

注※

空白文字とは，半角スペース，タブ，LF（0x0a），CR（0x0d）またはFF（0x0c）のことを指します。

(al)　webserver.sfoから始まるキー

キー名称
内容
デフォルト値

webserver.sfo.negotiation.ignore_serverId
ネゴシエーションで，J2EEサーバに設定されたHttpSessionのセッションIDに付加するサーバIDが，すでに接続済みのJ2EEサーバの設定と一致した場合に，エラーとするかどうかを指定します。

trueを指定した場合：

エラーとします。

falseを指定した場合：

エラーとしません。

false

webserver.sfo.sfo_servers
J2EEサーバ上のWebアプリケーションが使用する，すべてのSFOサーバ名を指定します。1024文字までの文字列が指定できます。半角英数字（A～Z，a～z，0～9）またはアンダースコア（_）が使用できます。
SFOサーバを複数指定する場合は，半角コンマ（,）で区切ります。ただし，一つのSFOサーバ名に指定できる文字列長は32文字までです。このとき，一つ目に指定されたSFOサーバ名がデフォルトとなります。

指定形式：

<SFOサーバ名>[,<SFOサーバ名>]

同じSFOサーバ名を複数回指定することはできません。
セッションフェイルオーバ機能を使用しない場合，このプロパティは無効です。
なし

webserver.sfo.sfo_server.<SFOサーバ名>※.naming
<SFOサーバ名>が指すSFOサーバのインプロセスで起動したCORBAネーミングサービスのIPアドレスまたはホスト名，およびポート番号を指定します。
IPアドレスは10進表記で，ポート番号は1～65535の整数で指定します。区切り文字には半角コロン（:）を使用します。

指定形式：

<IPアドレス>:<ポート番号>

<ホスト名>:<ポート番号>

webserver.sfo.sfo_serversキーで指定した，すべてのSFOサーバについて設定が必要です。設定されていないSFOサーバが存在した場合，セッションフェイルオーバを使用するアプリケーションは開始できません。
なし

webserver.sfo.sfo_server.<SFOサーバ名>※.connectionTimeout
J2EEサーバからSFOサーバに通信した際のタイムアウト時間を，1～3600の整数（単位：秒）で指定します。
30

webserver.sfo.check_size.mode
グローバルセッション情報のサイズ見積もり機能を有効にするかどうかを指定します。

onを指定した場合：

グローバルセッション情報のサイズ見積もり機能が有効になります。

offを指定した場合

グローバルセッション情報のサイズ見積もり機能が無効になります。

off

注※

webserver.sfo.sfo_serversキーで指定したSFOサーバ名。webserver.sfo.sfo_serversキーに指定されていないSFOサーバ名を指定した場合，そのキーは無効になります。

(am)　webserver.staticから始まるキー

キー名称
内容
デフォルト値

webserver.static_content.cache.enabled
静的コンテンツキャッシュ機能の有効／無効／強制的な無効を指定します。

trueを指定した場合：

静的コンテンツキャッシュ機能を有効にします。

falseを指定した場合：

静的コンテンツキャッシュ機能を無効にします。

forceoffを指定した場合：

DDファイル（web.xml）またはアプリケーション属性ファイルで静的コンテンツキャッシュが有効と設定されていても，キャッシュ機能を強制的に無効にします。

このプロパティがfalseおよびforceoffの場合，webserver.static_content.cache.size，webserver.static_content.cache.filesize.thresholdの設定は無効となります。
DDファイル（web.xml）またはアプリケーション属性ファイルで，静的コンテンツキャッシュ機能の有効／無効が設定されていないWebアプリケーションでは，このプロパティに指定した値が有効になります。また，静的コンテンツキャッシュ機能の有効／無効が設定されているWebアプリケーションではこのプロパティに指定した値は無効となります。ただし，forceoffを指定した場合は，DDファイル（web.xml）またはアプリケーション属性ファイルの設定に関係なく，このプロパティに指定した値が有効になります。
true，false，forceoff以外の文字列，空文字列または空白文字※を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
false

webserver.static_content.cache.size
静的コンテンツキャッシュ機能が有効な場合，メモリにキャッシュできるサイズ（単位：バイト）の上限を0～2147483647の整数で指定します。
Webアプリケーション単位で，キャッシュの合計サイズが指定した値を超えた場合は，アクセスされていない時間が最も長いキャッシュから削除していき，キャッシュの合計サイズが設定した値以下になるまでキャッシュの削除が繰り返されます。
0を指定した場合，キャッシュできるサイズに上限を設けません。
DD（web.xml）またはアプリケーション属性ファイルで，キャッシュできるメモリサイズが設定されていないWebアプリケーションでは，このプロパティに指定した値が有効となります。また，キャッシュできるメモリサイズが設定されているWebアプリケーションでは，このプロパティに指定した値は無効となります。
無効な値，webserver.static_content.cache.filesize.thresholdで指定した値よりも小さい値，空文字列または空白文字※を指定した場合は，メッセージが出力され，デフォルト値が設定されます。
10485760

webserver.static_content.cache.filesize.threshold
静的コンテンツキャッシュ機能が有効な場合，キャッシュできるファイルサイズ（単位：バイト）を0～2147483647の整数で指定します。
指定した値を超えるサイズのファイルはキャッシュされません。
0を指定した場合，キャッシュできるファイルのサイズに上限を設けません。
DD（web.xml）またはアプリケーション属性ファイルで，キャッシュできるファイルサイズが設定されていないWebアプリケーションでは，このプロパティに指定した値が有効になります。また，キャッシュできるファイルサイズが設定されているWebアプリケーションでは，このプロパティに指定した値は無効となります。
無効な値，webserver.static_content.cache.sizeで指定した値より大きい値，空文字列または空白文字※を設定した場合は，メッセージが出力され，デフォルト値が設定されます。
524288

webserver.static_content.encoding.extension
静的コンテンツに使用する文字エンコーディングを適用させる拡張子を指定します。webserver.http.response.encodingキーが指定されている場合に有効になります。
キーの値に何も設定しない場合，このキーは無効になります。
なし

注※

空白文字とは，半角スペース，タブ，LF（0x0a），CR（0x0d）またはFF（0x0c）のことを指します。

(an)　webserver.workから始まるキー

キー名称
内容
デフォルト値

webserver.work.clean
JSP用テンポラリディレクトリ下に生成したディレクトリをサーバ起動時，および終了時に削除するかどうかを指定します。

trueが指定された場合：

ディレクトリを削除します。

falseが指定された場合：

ディレクトリを削除しません。

false

webserver.work.directory
JSP用テンポラリディレクトリを指定します。絶対パスによるディレクトリ名を指定します。※
ディレクトリのパスの区切り記号には，"/"を使用してください。
例えば，Windowsの場合，workディレクトリとしてC:¥temp¥workを設定するときは，次のように指定します。
（指定例）
webserver.work.directory=c:/temp/work

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>¥web

UNIXの場合
/opt/Cosminexus/CC/server/repository/<サーバ名称>/web

注※

使用するOSによってファイル名長に制限があります。例えば，Windowsでは250バイト程度となっています。このため，ディレクトリ階層の深い場所でサーブレットやJSPを実行できません。特にJSPファイルから生成されるファイル名はWebアプリケーションで配置されたディレクトリ階層の深さに比例して長くなり，JSPファイルに対するJavaファイルを生成できないことがあります。これを回避するためにはWebアプリケーションの配置ディレクトリの階層を浅くしたり，プロパティwebserver.work.directoryに絶対パスで浅いディレクトリ階層を指定したりすることで回避してください。Cosminexusの作業ディレクトリについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(ao)　webserver.xmlから始まるキー

キー名称
内容
デフォルト値

webserver.xml.validate
Servlet 2.3のWebアプリケーションについて，タグライブラリ・ディスクリプタ（TLDファイル）が，DTDで記述されたスキーマに沿って記述されているかチェックするかどうかを指定します。
J2EEサーバモードで起動した場合のweb.xml，およびServlet 2.4のWebアプリケーションのTLDファイルには，このプロパティの指定は無効となります。また，Servlet 2.4のWebアプリケーションに含まれるTLDファイルはTLDのバージョンにかかわらずすべてチェックされます。
次の値を指定します。

trueを指定した場合：

タグライブラリ・ディスクリプタだけをチェックします。

falseを指定した場合：

チェックしません。

true

(6)　記述例

ejbserver.server.j2ee.feature=1.4

ejbserver.deploy.stub.generation.scope=ejb
ejbserver.compiler.jvm.maxHeapSize=256m
ejbserver.compiler.jvm.minHeapSize=32m

ejbserver.naming.host=localhost
ejbserver.naming.port=900
ejbserver.naming.protocol=corbaname
ejbserver.naming.startupMode=inprocess
ejbserver.naming.startupWaitTime=1
ejbserver.naming.startupRetryCount=9

ejbserver.logger.enabled.*=Error,Warning,Information,Debug
ejbserver.logger.channels.define.MessageLogFile.filenum=2
ejbserver.logger.channels.define.MessageLogFile.filesize=1048576

ejbserver.application.InitTermProcessClasses=InitTermClass1,InitTermClass2

webserver.connector.http.permitted.hosts=host1,host2
webserver.work.directory=c:/work
webserver.sfo.sfo_servers=sfo_server1,sfo_server2
webserver.sfo.sfo_server.sfo_server1.naming=host1:910
webserver.sfo.sfo_server.sfo_server1.connectionTimeout=5
webserver.sfo.sfo_server.sfo_server2.naming=host2:911
webserver.sfo.sfo_server.sfo_server2.connectionTimeout=10

2.5　server.policy（J2EEサーバ用セキュリティポリシーファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　記述例

(5)　注意事項

(1)　形式

J2SEのセキュリティポリシーファイル形式に従います。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

(3)　機能

J2EEサーバを実行するJavaVMのセキュリティポリシーを指定します。

J2EEサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にJ2EEサーバを起動したときに反映されます。

(4)　記述例

使用されるポリシーファイルの内容を次に示します。

// (1)
// Grant all permissions to the java extensions
grant codeBase "file:${java.home}/lib/ext/-" {
permission java.security.AllPermission;
};

// (2)
// Grant all permissions to the java tools, etc
// Note: java.home is the jre, not the installation dir for the jdk
grant codeBase "file:${java.home}/../lib/*" {
permission java.security.AllPermission;
};

// (3)
// Grant all permissions to anything loaded from the
// EJB server itself

grant codeBase "file:${ejbserver.install.root}/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${tpbroker.java.home}/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/DABJ/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/manager/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/c4web/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/c4web/exlib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/jaxp/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/CTM/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/PRF/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/wss/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/XMLSEC/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${ejbserver.install.root}/sfo/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${program.files.home}/hitachi/HNTRLib2/classes/*" {
permission java.security.AllPermission;
};

// (4)
// Grant all permissions to the container generated stubs and
// implementation classes
grant codeBase "file:${ejbserver.http.root}/ejb/${ejbserver.serverName}/containers/-" {
permission java.security.AllPermission;
};

// (5)
// Grant all permissions to imported resource (datasource) implementations
// implementation classes
grant codeBase "http://*/ejb/${ejbserver.serverName}/import/resjars/-" {
permission java.security.AllPermission;
};

// (6)
// Grant permissions to resource adapters
//
grant codeBase "file:${ejbserver.http.root}/ejb/${ejbserver.serverName}/rarjars/-" {

// For uCosminexus TP1 Connector & TP1/Client/J
permission java.util.PropertyPermission "*", "read, write";

// For uCosminexus TP1 Connector & TP1/Client/J & Cosminexus Reliable Messaging
permission java.io.FilePermission "<<ALL FILES>>", "read, write, delete";
permission java.net.SocketPermission "*", "connect,listen,accept";

// For TP1/Message Queue - Access
permission java.lang.RuntimePermission "loadLibrary.*";

// For TP1/Message Queue - Access & Cosminexus Reliable Messaging
permission java.lang.RuntimePermission "modifyThreadGroup";
permission java.lang.RuntimePermission "modifyThread";

// For DB Connector
permission java.lang.reflect.ReflectPermission "suppressAccessChecks";

// For authentication (from J2EE RI server.policy file)
permission javax.security.auth.PrivateCredentialPermission "* * ¥"*¥"", "read";

// For Cosminexus Reliable Messaging
permission javax.security.auth.AuthPermission "modifyPrivateCredentials";
permission java.lang.RuntimePermission "getenv.HRMDIR";
};

// (7)
// Grant permissions to JSP/Servlet
//
grant codeBase "file:${ejbserver.http.root}/web/${ejbserver.serverName}/-" {
permission java.lang.RuntimePermission "loadLibrary.*";
permission java.lang.RuntimePermission "queuePrintJob";
permission java.net.SocketPermission "*", "connect";
permission java.io.FilePermission "<<ALL FILES>>", "read, write";
permission java.util.PropertyPermission "*", "read";
};

// (8)
// Grant minimal permissions to everything else:
//  EJBs
//  client implementation classes
grant  {
permission java.util.PropertyPermission "*", "read";
permission java.lang.RuntimePermission "queuePrintJob";
permission java.net.SocketPermission "*", "connect";
};

記述例の（1）～（8）について説明します。

（1）

JDKのextディレクトリ下のクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（2）

JDKのlibディレクトリ下のクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（3）

J2EEサーバが使用するクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（4）

J2EEサーバが生成するスタブとスケルトンなどのクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（5）

J2EEサーバが使用するリソースのクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（6）

J2EEサーバが使用するリソースアダプタのクラスファイルに対して次の権限を許可します。

すべてのプロパティ情報に対して読み取り，および書き込みを許可

すべてのファイルに対して読み取り，書き込み，および削除を許可

すべてのソケット通信に対してネットワークへの接続，接続での待機，および接続の受け付けを許可

すべてのライブラリのロードを許可

スレッドグループの変更を許可

スレッドの変更を許可

すべてのリフレクション操作を許可

任意のSubjectが所有する，すべての非公開Credentialへのアクセスを許可

Subjectに関連づけられた非公開CredentialのSetの変更を許可

環境変数HRMDIRの値の取得を許可

注意事項

リソースアダプタ内のJARファイルの展開先であるJ2EEサーバ管理下のディレクトリが記載されています。

J2EEサーバで動作するすべてのリソースアダプタが有効範囲です。

（7）

JSP／サーブレットのクラスファイルに対して次の権限を許可します。

すべてのライブラリのロードを許可

印刷ジョブ要求を許可

すべてのソケット通信に対してネットワーク接続を許可

すべてのファイルに対して読み取り，および書き込みを許可

すべてのプロパティ情報の読み取りを許可

（8）

すべてのクラスファイルに対して次の権限を許可します。

すべてのプロパティ情報の読み取りを許可

印刷ジョブ要求を許可

すべてのソケット通信に対してネットワーク接続を許可

(5)　注意事項

構文が不正または適切なアクセス権限が設定されていないserver.policyファイルを使用した場合，java.lang.StackOverflowErrorまたはjava.lang.OutOfMemoryErrorが発生してJ2EEサーバが異常終了することがあります。

サーバをセットアップするときに生成されたserver.policyファイルには，J2EEサーバを動作させるために最低限必要な権限が記述されています。生成されたserver.policyファイルの記述行の削除および変更はしないでください。

2.6　criticalList.cfg（保護区リストファイル）

保護区としてメソッドキャンセルを禁止するクラスを設定します。

この保護区リストファイルの設定が必要な場合は，Cosminexus各製品の構成ソフトウェアおよび関連製品で提供されるドキュメントの注意事項に記載されます。記載されている指示に従って設定してください。

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　記述例

(4)　注意事項

(1)　形式

次の形式で指定します。

<要素>

<要素>には，次のどちらかを指定できます。

<クラス名>
保護区に指定するクラス名称を指定します。

<プリフィックス名>
保護区に指定するクラスが含まれるパッケージのプリフィックス名を指定します。指定したプリフィックスを持つクラスは，すべて保護区として指定されます。

指定方法

指定可能な要素を改行で区切って指定します。

空行は無視されます。

シャープ（#）で始まる行はコメントとみなされます。

<要素>の後ろに空白やコメントを追加することはできません。
（例）<クラス名> #<コメント>

クラス名は，パッケージを含めて記述します。ただし，サフィックス".class"は記述しないでください。
（例）pacA.pacB.pacC.pacD.MyTestClass.class
この場合は，pacA.pacB.pacC.pacD.MyTestClassと記述します。

クラス名称のプリフィックスは指定できません。
（例）pacA.pacB.pacC.pacD.My*
"My"をプリフィックスに持つクラス名称（MyTestClass）を保護区指定する場合，クラス名称にアスタリスク（*）は使用できません。
この場合は，pacA.pacB.pacC.*と記述します。

アスタリスク（*）だけの指定はできません。

<要素>の前後にある半角空白は無視されます。

<要素>の前後にある全角空白は文字とみなされ，不正な値と判断されます。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/

(3)　記述例

プリフィックス名を指定する場合

#プリフィックス名指定
pacA.pacB.*

パッケージpacA.pacB以下のクラスおよびパッケージに含まれるクラスが，すべて保護区になります。

例えば，パッケージpacA.pacB.pacC以下に，pacA.pacB.pacC.pacDがある場合，pacA.pacB.pacC.pacD以下のクラスもすべて保護区になります。

クラス名を指定する場合

#クラス名指定
pacX.pacY.pacZ.MyTestpacX.pacY.pacZ.CommonTest

(4)　注意事項

保護区リストファイルは製品単位の定義です。Cosminexus Component Containerをインストールしたマシン上で動作するすべてのJ2EEサーバで有効になります。

保護区リストファイルはJ2EEサーバの起動時に読み込まれます。変更内容を有効にしたい場合は，J2EEサーバを再起動する必要があります。

J2EEサーバ起動時に，保護区リストファイルが存在しない，または設定が不正な場合，J2EEサーバの起動に失敗します。

3.　バッチサーバで使用するファイル

この章では，バッチサーバで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

3.1　バッチサーバで使用するファイルの一覧

3.2　usrconf.cfg（バッチサーバ用オプション定義ファイル）

3.3　usrconf.properties（バッチサーバ用ユーザプロパティファイル）

3.4　server.policy（バッチサーバ用セキュリティポリシーファイル）

3.5　criticalList.cfg（保護区リストファイル）

3.6　usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

3.7　usrconf.properties（バッチアプリケーション用ユーザプロパティファイル）

3.1　バッチサーバで使用するファイルの一覧

バッチサーバで使用するファイルの一覧を，次の表に示します。

表3-1　J2EEサーバで使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
usrconf.cfg | バッチサーバ用オプション定義ファイル | バッチサーバを実行するJavaVMの起動オプションを指定します。 | 3.2
usrconf.properties | バッチサーバ用ユーザプロパティファイル | バッチサーバを実行するJavaVMのシステムプロパティを指定します。 | 3.3
server.policy | バッチサーバ用セキュリティポリシーファイル | バッチサーバを実行するJavaVMのセキュリティポリシーを指定します。 | 3.4
criticalList.cfg | 保護区リストファイル | 保護区としてメソッドキャンセルを禁止するクラスを設定します。 | 3.5
usrconf.cfg | バッチアプリケーション用オプション定義ファイル | cjexecjobコマンド，およびcjkilljobコマンドを実行するJavaVMの起動オプションを指定します。 | 3.6
usrconf.properties | バッチアプリケーション用ユーザプロパティファイル | cjexecjobコマンド，およびcjkilljobコマンドを実行するJavaVMのシステムプロパティを指定します。 | 3.7

3.2　usrconf.cfg（バッチサーバ用オプション定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

(3)　機能

バッチサーバを実行するJavaVMの起動オプションを指定します。

バッチサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にバッチサーバを起動したときに反映されます。

(4)　指定できるキー

指定できるキーの概要とデフォルト値を次の表に示します。キーの詳細については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。なお，参照する場合は「J2EEサーバ」および「J2EEアプリケーション」を「バッチサーバ」および「バッチアプリケーション」と読み替えてください。

注意

ファイル内でマルチバイト文字を使用する場合は，次の個所で使用しているマルチバイト文字とエンコードを統一してください。

usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

cjexecjobコマンド（バッチアプリケーション実行コマンド）の引数

バッチアプリケーションのソースコード（java.lang.System.outまたはjava.lang.System.err）

表3-2　usrconf.cfgに指定できるキーとデフォルト値（バッチサーバ）

キー名称
概要
デフォルト値

add.jvm.arg
指定されたオプションを使ってJavaVMを起動します。

-Xms256m

-Xmx512m

-XX:NewRatio=2

-XX:PermSize=128m

-XX:MaxPermSize=128m

-XX:+HitachiOutOfMemoryStackTrace

-XX:HitachiJavaLog:
Windowsの場合
<Cosminexusのインストールディレクトリ>¥ejb¥<サーバ名称>¥logs
UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/logs

-XX:HitachiJavaLogFileSize=4m

-XX:+HitachiVerboseGC

-XX:+HitachiVerboseGCPrintCause

-XX:+HitachiOutputMilliTime

-XX:-HitachiThreadDumpToStdout

-XX:+HitachiOutOfMemoryAbort

-XX:+HitachiJavaClassLibTrace

-XX:HitachiJavaClassLibTraceLineSize =1024

-XX:+HitachiLocalsSimpleFormat

-XX:+HitachiTrueTypeInLocals

-XX:+HitachiLocalsInStackTrace

-XX:+HitachiReserveSwapSpace

add.class.path
コンテナ拡張ライブラリ用のJARを指定します。
なし

add.library.path
JNI用の共有ライブラリを指定します。コンテナ拡張ライブラリがJNIを利用する場合だけ指定します。
なし

batch.service.enabled
このキーは，手動で編集しないください。
cjsetupコマンドに-batchオプションを指定して実行した場合に，キーの値にtrueが表示されます。
true(-cjsetupコマンドに-batchオプションを指定して実行した場合)

cpp.library.version
プロセス内で使用するlibstdc++ライブラリのバージョンを指定します。
5

ejb.public.directory
指定されたディレクトリをバッチサーバの作業ディレクトリとしてバッチサーバを起動します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥public

UNIXの場合
/opt/Cosminexus/CC/server/public

ejb.server.corefilenum（UNIX用）
バッチサーバ再起動時に残すcoreファイルの数を指定します。
1

ejb.server.log.directory
ログファイルの出力先ディレクトリを指定します。

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs

ejb.server.log.mode
ログファイルの出力形態を指定します。
7

ejb.server.log.stdout.filesize
cjstdout.logファイルのサイズの上限値を指定します。
1048576

ejb.server.log.stderr.filesize
cjstderr.logファイルのサイズの上限値を指定します。
1048576

jvm.type
使用するJavaVMのタイプを指定します。
server

3.3　usrconf.properties（バッチサーバ用ユーザプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　バッチサーバの予約済みキー

(5)　バッチサーバのカスタマイズ用キー

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

記載する文字はJavaの仕様に従って，ISO 8859-1 文字エンコーディングを使用してください。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

(3)　機能

バッチサーバを実行するJavaVMのシステムプロパティを指定します。

usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は，usrconf.propertiesの値が優先されます。

バッチサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にバッチサーバを起動したときに反映されます。

なお，日立のJavaVMは，J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。JDK 5.0で使用できるプロパティについては，Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

(4)　バッチサーバの予約済みキー

バッチサーバでは，次に示す接頭子で始まるキーを内部的に利用します。このため，アプリケーションでこれらの接頭子で始まるキーを利用してはいけません。

ejbserver.*

webserver.*

appclient.*

j2eeserver.*

(5)　バッチサーバのカスタマイズ用キー

バッチサーバでは，次に示すシステムプロパティのキーに値を設定することで，バッチサーバの動作をカスタマイズできます。

ここでは，キーを次の分類に分けて説明します。

ejbserver.applicationから始まるキー

ejbserver.batchから始まるキー

ejbserver.clientから始まるキー

ejbserver.connectionpoolから始まるキー

ejbserver.connectorから始まるキー

ejbserver.containerから始まるキー

ejbserver.deployから始まるキー

ejbserver.extから始まるキー

ejbserver.httpから始まるキー

ejbserver.instrumentationから始まるキー

ejbserver.jndiから始まるキー

ejbserver.jtaから始まるキー

ejbserver.loggerから始まるキー

ejbserver.managementから始まるキー

ejbserver.managerから始まるキー

ejbserver.namingから始まるキー

ejbserver.rmiから始まるキー

ejbserver.serverから始まるキー

ejbserver.watchから始まるキー

javaから始まるキー

vbrokerから始まるキー

webserver.connectorから始まるキー

それぞれに指定できるキーの概要とデフォルト値を次の表に示します。キーの詳細については，「2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。なお，参照する場合は「J2EEサーバ」および「J2EEアプリケーション」を「バッチサーバ」および「バッチアプリケーション」と読み替えてください。

(a)　ejbserver.applicationから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.application.InitTermProcessClasses | コンテナ拡張ライブラリを使用する場合に，サーバ起動・停止フックのクラス名を指定します。 | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname | AppNameのフィールドに出力するデフォルトのアプリケーション名を指定します。 | user_app
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count | ログファイルの面数を指定します。 | 2
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding | 出力する文字列のエンコーディングを指定します。 | null
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter | 使用するフィルタを指定します。 | null
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter | 使用するフォーマッタを指定します。 | null
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level | ログの取得レベルの上限を指定します。 | SEVERE
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit | ログファイルの容量を指定します。 | 1048576
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid | MsgIDのフィールドに出力するデフォルトのメッセージIDを指定します。 | 0001
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path | ログファイル名のプリフィックスを1～255バイトの範囲で指定します。 | user_log
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator | CJSimpleFormatterを利用して，1文でメッセージを出力するためのセパレータを指定します。 | |（ストローク）
ejbserver.application.userlog.loggers | 使用するロガーの名称を指定します。 | なし
ejbserver.application.userlog.Logger.<ロガー名称>.filter | ロガーで使用するフィルタを指定します。 | null
ejbserver.application.userlog.Logger.<ロガー名称>.handlers | 指定のロガー名称に対するハンドラクラスを指定します。 | なし
ejbserver.application.userlog.Logger.<ロガー名称>.level | ロガーのログ出力レベルを指定します。 | SEVERE
ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers | ログレコードを受け取ったロガーから，親ロガーの接続しているハンドラへログレコードを伝播させるかどうかを指定します。 | true

(b)　ejbserver.batchから始まるキー

キー名称
概要
デフォルト値

ejbserver.batch.gc.watch.threshold
ガーベージコレクションを実行するメモリ使用量のしきい値を，0～100（単位：％）の整数で設定します。次の条件のどれかの場合ガーベージコレクションを実行します。

Tenured領域消費サイズのTenured領域合計サイズに対する割合がしきい値以上

New領域合計サイズのTenured領域最大空きサイズに対する割合がしきい値以上

Permanent領域消費サイズのPermanent領域合計サイズに対する割合がしきい値以上

0

注　このキーは，バッチサーバ用ユーザプロパティファイル特有のキーです。J2EEサーバ用ユーザプロパティファイルには存在しません。

(c)　ejbserver.clientから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.client.ctm.RequestPriority | CTM内のキューに滞留したリクエストを引き出す時のプライオリティ（優先順位）を指定します。 | 4

(d)　ejbserver.connectionpoolから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.connectionpool.applicationAuthentication.disabled | コンテナ管理のサインオンの最適化機能を有効にするかどうかを指定します。 | false
ejbserver.connectionpool.association.enabled | コネクションアソシエーション機能を有効にするかどうかを指定します。 | false
ejbserver.connectionpool.sharingOutsideTransactionScope.enabled | アプリケーションサーバが管理するトランザクションの外で複数回コネクションの取得を行ったときのコネクションシェアリングの動作を指定します。 | false

(e)　ejbserver.connectorから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.connector.logwriter.filenum | リソースアダプタ用ログファイルの面数を指定します。 | 4
ejbserver.connector.logwriter.filesize | リソースアダプタ用ログファイルのサイズを指定します。 | 2097152

(f)　ejbserver.containerから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.container.audit_trail.enabled | データベース監査証跡連携機能を有効にするかどうかを指定します。 | false

(g)　ejbserver.deployから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.deploy.exclusive.lockAliveInterval | サーバ処理終了後，コマンドから送信された次のレスポンスを受け取るまでの最大待ち時間を指定します。 | 60
ejbserver.deploy.resourcefile.scramble.enabled | 作業ディレクトリ以下に展開されるDataSource，JavaMail，ResourceAdapterに関するDDファイルをスクランブルするかどうかを設定します。 | false

(h)　ejbserver.extから始まるキー

キー名称
概要
デフォルト値

ejbserver.ext.method_observation.interval
このプロパティの設定には，次の二つの意味があります。

J2EEアプリケーション実行時間監視機能を使用するかどうかを指定します。

動作中のリクエスト処理がタイムアウトしていないかを監視する時間間隔，タイムアウトしたリクエスト（メソッド）をキャンセルする時間間隔を指定します。

0

(i)　ejbserver.httpから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.http.port | 簡易Webサーバのポート番号を指定します。 | 8080

(j)　ejbserver.instrumentationから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.instrumentation.enabled | Management Serverと連携するかどうかを指定します。 | true

(k)　ejbserver.jndiから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.jndi.cache | ネーミングでのキャッシングをするかどうかを指定します。 | on
ejbserver.jndi.cache.interval | ネーミングでのキャッシングをする場合，キャッシュをクリアする間隔を指定します。 | 0
ejbserver.jndi.cache.interval.clear.option | インターバル経過後のネーミングでのキャッシュ領域に対する動作を決定します。 | refresh
ejbserver.jndi.cache.reference | DataSourceオブジェクトのキャッシング機能を使用するかどうかを指定します。 | off
ejbserver.jndi.namingservice.group.list | ラウンドロビン検索をする場合に，検索対象になる論理ネーミングサービスのグループを定義します。 | なし
ejbserver.jndi.namingservice.group.<Specify group name>.providerurls | 各グループに属するネーミングサービスのルート位置をプロバイダURLで指定します。 | なし
ejbserver.jndi.request.timeout | ネーミングサービスとの通信タイムアウト時間を指定します。 | 0

(l)　ejbserver.jtaから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.jta.TransactionManager.defaultTimeOut | バッチサーバ上で開始されるトランザクションのトランザクションタイムアウトのデフォルト値を指定します。 | 180

(m)　ejbserver.loggerから始まるキー

キー名称
概要
デフォルト値

ejbserver.logger.channels.define.<チャネル名>※.filenum
バッチサーバのログファイルの面数を指定します。

チャネル名がMaintenanceLogFileの場合
4

チャネル名が上記以外の場合
2

ejbserver.logger.channels.define.<チャネル名>※.filesize
バッチサーバのログファイルのサイズを指定します。

チャネル名がMaintenanceLogFileの場合
16777216

チャネル名が上記以外の場合
1048576

ejbserver.logger.enabled.*
バッチサーバのログレベルを指定します。
Error，Warning

注※

チャネル名称として次に示す名称を設定できます。

Cosminexusシステムのログ出力用のチャネル
MessageLogFile，MaintenanceLogFile，ExceptionLogFile，ConsoleLogFile，EJBContainerLogFile，UserOutLogFile，UserErrLogFile

リソース枯渇監視ログ出力用のチャネル
MemoryWatchLogFile，FileDescriptorWatchLogFile，ThreadWatchLogFile，ThreaddumpWatchLogFile，ConnectionPoolWatchLogFile

資料の取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(n)　ejbserver.managementから始まるキー

キー名称
概要
デフォルト値

ejbserver.management.JVM.stats_monitor.FullGCCount.enabled
フルガーベージコレクション回数の監視を有効にするかどうかを指定します。
true

ejbserver.management.JVM.stats_monitor.FullGCCount.threshold
フルガーベージコレクション回数の監視でのしきい値となる回数を指定します。
10

ejbserver.management.JVM.stats_monitor.FullGCCount.interval
フルガーベージコレクション回数の監視でのしきい値監視間隔を指定します。
600

ejbserver.management.statistics.interval
稼働情報収集間隔を指定します。
60

ejbserver.management.stats_file.base_time
稼働情報ファイルの時間切り替え運用での基点時刻を指定します。
0

ejbserver.management.stats_file.dir
稼働情報ファイルの出力先ディレクトリを指定します。

Windowsの場合<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥stats

UNIXの場合<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/stats

ejbserver.management.stats_file.enabled
稼働情報ファイル出力機能を有効にするかどうかを指定します。
true

ejbserver.management.stats_file.num
稼働情報ファイルの面数を指定します。
7

ejbserver.management.stats_file.period
稼働情報ファイルの時間切り替え運用での切り替え時間を指定します。
24

(o)　ejbserver.managerから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.manager.agent.Agent.conf | Management Serverとの連携に必要な設定をします。 | なし
ejbserver.manager.agent.Agent.enabled | Management Serverとの連携に必要な設定をします。 | false
ejbserver.manager.agent.JP1EventAgent.conf | JP1連携に関する設定ファイルのパスを指定します。 | なし
ejbserver.manager.agent.JP1EventAgent.enabled | JP1と連携するかどうかを指定します。 | false
ejbserver.manager.agent.MEventAgent.conf | Managementイベント発行用プロパティファイルを指定します。 | なし
ejbserver.manager.agent.MEventAgent.enabled | Managementイベント発行機能を有効にするかどうかを指定します。 | false

(p)　ejbserver.namingから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.naming.host | バッチサーバがネーミングサービスとして利用するCORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定します。 | localhost
ejbserver.naming.nameroot | CORBAネーミングサービスを自動起動モードで使用する場合に，起動させるCORBAネーミングサービスに名称を付加するときに指定します。 | なし
ejbserver.naming.port | バッチサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を指定します。 | 900
ejbserver.naming.startupRetryCount | ejbserver.naming.startupWaitTimeで指定したCORBAネーミングサービスの起動待ち時間経過後，CORBAネーミングサービスがまだ起動していない場合に，ejbserver.naming.startupWaitTimeで指定された秒数だけ起動待ちを繰り返す回数を指定します。 | 9
ejbserver.naming.startupWaitTime | バッチサーバ起動時にCORBAネーミングサービスが利用可能になるまで待つ時間を指定します。 | 1

(q)　ejbserver.rmiから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.rmi.naming.host | マルチホームドホスト環境で，バッチサーバがサービスプロバイダとして使用するRMIレジストリのホスト名称，またはIPアドレスを指定します。 | なし
ejbserver.rmi.naming.port | バッチサーバが利用するRMIレジストリのポート番号を指定します。 | 23152
ejbserver.rmi.remote.listener.port | バッチサーバ内でエクスポートするリモートオブジェクトのポート番号を指定します。 | 0
ejbserver.rmi.request.timeout | クライアントとサーバ間の通信タイムアウト時間を指定します。 | 0

(r)　ejbserver.serverから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.server.prf.PRFID | PRF識別子を指定します。 | なし
ejbserver.server.threaddump.filenum | バッチサーバが障害を検知して自発的にスレッドダンプを出力する場合のスレッドダンプのファイル数の上限を指定します。 | 256

(s)　ejbserver.watchから始まるキー

キー名称 | 概要 | デフォルト値
ejbserver.watch.enabled | すべてのリソース枯渇監視を有効にするかどうかを指定します。 | true
ejbserver.watch.memory.enabled | メモリ監視のアラート出力を有効にするかどうかを指定します。 | true
ejbserver.watch.memory.interval | メモリ監視間隔を指定します。 | 60
ejbserver.watch.memory.threshold | メモリの使用状態を監視するしきい値を指定します。 | 80
ejbserver.watch.memory.writefile.enabled | メモリ監視結果をファイル出力するかどうかを指定します。 | true
ejbserver.watch.fileDescriptor.enabled | ファイルディスクリプタ監視のアラート出力を有効にするかどうかを指定します。 | true
ejbserver.watch.fileDescriptor.interval | ファイルディスクリプタ監視間隔を指定します。 | 60
ejbserver.watch.fileDescriptor.threshold | ファイルディスクリプタの使用状態を監視するしきい値を指定します。 | 2147483647
ejbserver.watch.fileDescriptor.writefile.enabled | ファイルディスクリプタ監視結果をファイル出力するかどうかを指定します。 | true
ejbserver.watch.thread.enabled | スレッド監視のアラート出力を有効にするかどうかを指定します。 | true
ejbserver.watch.thread.interval | スレッド監視間隔を指定します。 | 60
ejbserver.watch.thread.threshold | スレッドの使用状態を監視するしきい値を指定します。 | 2147483647
ejbserver.watch.thread.writefile.enabled | スレッド監視結果をファイル出力するかどうかを指定します。 | true
ejbserver.watch.threaddump.enabled | スレッドダンプ監視のアラート出力を有効にするかどうかを指定します。 | true
ejbserver.watch.threaddump.interval | スレッドダンプ監視時間間隔を指定します。 | 30
ejbserver.watch.threaddump.threshold | スレッドダンプ監視のしきい値を，最大値に対する割合で指定します。 | 80
ejbserver.watch.threaddump.writefile.enabled | スレッドダンプ監視結果をファイル出力するかどうかを指定します。 | true

(t)　javaから始まるキー

キー名称 | 概要 | デフォルト値
java.naming.factory.initial | JNDIのInitialContextがデレゲートするコンテキストの実装クラスのファクトリクラスを指定します。 | com.hitachi.software.ejb.jndi.InsContextFactory

(u)　vbrokerから始まるキー

キー名称
概要
デフォルト値

vbroker.agent.enableLocator
スマートエージェントを使用するかどうかを指定します。
false

vbroker.agent.port
スマートエージェントのポート番号を指定します。
14000

vbroker.orb.htc.comt.entryCount
Cosminexus TPBroker通信トレースファイル1個当たりのエントリ数の上限値を指定します。
120000

vbroker.orb.htc.comt.fileCount
Cosminexus TPBroker通信トレースファイルの個数の上限値を指定します。
3

vbroker.orb.htc.tracePath
Cosminexus TPBrokerのトレースファイル出力先のパスを1～210バイトの範囲で指定します。

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/TPB/logj

vbroker.se.iiop_tp.host
任意の値を指定して，バッチサーバ単位でEJBコンテナのIPアドレスを固定します。
なし

vbroker.se.iiop_tp.scm.iiop_tp.listener.port
任意の値を指定して，バッチサーバ単位で通信ポートを固定します。
0

(v)　webserver.connectorから始まるキー

キー名称 | 概要 | デフォルト値
webserver.connector.ajp13.bind_host | Webサーバ連携で使用するIPアドレスまたはホスト名称を指定します。 | なし
webserver.connector.ajp13.port | Webサーバとの通信に使用するポート番号を指定します。 | 8007
webserver.connector.http.bind_host | 簡易Webサーバで使用するローカルIPアドレス，または解決できるローカルホスト名称を指定します。 | なし
webserver.connector.http.permitted.hosts | 簡易Webサーバへのアクセスを許可するホストのIPアドレス（10進表記）またはホスト名を指定します。 | なし

3.4　server.policy（バッチサーバ用セキュリティポリシーファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　記述例

(5)　注意事項

(1)　形式

J2SEのセキュリティポリシーファイル形式に従います。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

(3)　機能

バッチサーバを実行するJavaVMのセキュリティポリシーを指定します。

バッチサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にバッチサーバを起動したときに反映されます。

(4)　記述例

使用されるポリシーファイルの内容を次に示します。

// (1)
// Grant all permissions to the java extensions
grant codeBase "file:${java.home}/lib/ext/-" {
permission java.security.AllPermission;
};

// (2)
// Grant all permissions to the java tools, etc
// Note: java.home is the jre, not the installation dir for the jdk
grant codeBase "file:${java.home}/../lib/*" {
permission java.security.AllPermission;
};

// (3)
// Grant all permissions to anything loaded from the
// EJB server itself

grant codeBase "file:${ejbserver.install.root}/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${tpbroker.java.home}/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/DABJ/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/manager/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/c4web/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/c4web/exlib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/jaxp/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/CTM/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/PRF/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/wss/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/XMLSEC/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${ejbserver.install.root}/sfo/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${program.files.home}/hitachi/HNTRLib2/classes/*" {
permission java.security.AllPermission;
};

// (4)
// Grant all permissions to the container generated stubs and
// implementation classes
grant codeBase "file:${ejbserver.http.root}/ejb/${ejbserver.serverName}/containers/-" {
permission java.security.AllPermission;
};

// (5)
// Grant all permissions to imported resource (datasource) implementations
// implementation classes
grant codeBase "http://*/ejb/${ejbserver.serverName}/import/resjars/-" {
permission java.security.AllPermission;
};

// (6)
// Grant permissions to resource adapters
//
grant codeBase "file:${ejbserver.http.root}/ejb/${ejbserver.serverName}/rarjars/-" {

// For Cosminexus TP1 Connector & TP1/Client/J
permission java.util.PropertyPermission "*", "read, write";

// For Cosminexus TP1 Connector & TP1/Client/J & Cosminexus Reliable Messaging
permission java.io.FilePermission "<<ALL FILES>>", "read, write, delete";
permission java.net.SocketPermission "*", "connect,listen,accept";

// For TP1/Message Queue - Access
permission java.lang.RuntimePermission "loadLibrary.*";

// For TP1/Message Queue - Access & Cosminexus Reliable Messaging
permission java.lang.RuntimePermission "modifyThreadGroup";
permission java.lang.RuntimePermission "modifyThread";

// For DB Connector
permission java.lang.reflect.ReflectPermission "suppressAccessChecks";

// For authentication (from J2EE RI server.policy file)
permission javax.security.auth.PrivateCredentialPermission "* * ¥"*¥"", "read";

// For Cosminexus Reliable Messaging
permission javax.security.auth.AuthPermission "modifyPrivateCredentials";
permission java.lang.RuntimePermission "getenv.HRMDIR";
};

// (7)
// Grant permissions to JSP/Servlet
//
grant codeBase "file:${ejbserver.http.root}/web/${ejbserver.serverName}/-" {
permission java.lang.RuntimePermission "loadLibrary.*";
permission java.lang.RuntimePermission "queuePrintJob";
permission java.lang.RuntimePermission "modifyThread";
permission java.lang.RuntimePermission "modifyThreadGroup";
permission java.net.SocketPermission "*", "connect";
permission java.io.FilePermission "<<ALL FILES>>", "read, write";
permission java.util.PropertyPermission "*", "read";
};

// (8)
//
// Grant minimal permissions to everything else:
//  Batch applications
//  EJBs
//  client implementation classes
grant  {
permission java.security.AllPermission;
};

記述例の（1）～（8）について説明します。

（1）

JDKのextディレクトリ下のクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（2）

JDKのlibディレクトリ下のクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（3）

バッチサーバが使用するクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（4）

バッチサーバが生成するスタブとスケルトンなどのクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（5）

バッチサーバが使用するリソースのクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（6）

バッチサーバが使用するリソースアダプタのクラスファイルに対して次の権限を許可します。

すべてのプロパティ情報に対して読み取り，および書き込みを許可

すべてのファイルに対して読み取り，書き込み，および削除を許可

すべてのソケット通信に対してネットワークへの接続，接続での待機，および接続の受け付けを許可

すべてのライブラリのロードを許可

スレッドグループの変更を許可

スレッドの変更を許可

すべてのリフレクション操作を許可

任意のSubjectが所有する，すべての非公開Credentialへのアクセスを許可

Subjectに関連づけられた非公開CredentialのSetの変更を許可

環境変数HRMDIRの値の取得を許可

注意事項

リソースアダプタ内のJARファイルの展開先であるバッチサーバ管理下のディレクトリが記載されています。

バッチサーバで動作するすべてのリソースアダプタが有効範囲です。

（7）

JSP／サーブレットのクラスファイルに対して次の権限を許可します。

すべてのライブラリのロードを許可

印刷ジョブ要求を許可

スレッドの変更を許可

スレッドグループの変更を許可

すべてのソケット通信に対してネットワーク接続を許可

すべてのファイルに対して読み取り，および書き込みを許可

すべてのプロパティ情報の読み取りを許可

（8）

すべてのクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

(5)　注意事項

構文が不正または適切なアクセス権限が設定されていないserver.policyファイルを使用した場合，java.lang.StackOverflowErrorまたはjava.lang.OutOfMemoryErrorが発生してバッチサーバが異常終了することがあります。

サーバをセットアップするときに生成されたserver.policyファイルには，バッチサーバを動作させるために最低限必要な権限が記述されています。生成されたserver.policyファイルの記述行の削除および変更はしないでください。ただし，signedBy，codeBase，およびprincipalが指定されていないgrantにあるjava.security.AllPermissionは，次の権限を設定すれば削除できます。

java.util.PropertyPermission "*", "read";

java.lang.RuntimePermission "queuePrintJob";

java.net.SocketPermission "*", "connect";

3.5　criticalList.cfg（保護区リストファイル）

保護区としてメソッドキャンセルを禁止するクラスを設定します。

この保護区リストファイルの設定が必要な場合は，Cosminexus各製品の構成ソフトウェアおよび関連製品で提供されるドキュメントの注意事項に記載されます。記載されている指示に従って設定してください。

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　記述例

(4)　注意事項

(1)　形式

次の形式で指定します。

<要素>

<要素>には，次のどちらかを指定できます。

<クラス名>
保護区に指定するクラス名称を指定します。

<プリフィックス名>
保護区に指定するクラスが含まれるパッケージのプリフィックス名を指定します。指定したプリフィックスを持つクラスは，すべて保護区として指定されます。

指定方法

指定可能な要素を改行で区切って指定します。

空行は無視されます。

シャープ（#）で始まる行はコメントとみなされます。

<要素>の後ろに空白やコメントを追加することはできません。
（例）<クラス名> #<コメント>

クラス名は，パッケージを含めて記述します。ただし，サフィックス".class"は記述しないでください。
（例）pacA.pacB.pacC.pacD.MyTestClass.class
この場合は，pacA.pacB.pacC.pacD.MyTestClassと記述します。

クラス名称のプリフィックスは指定できません。
（例）pacA.pacB.pacC.pacD.My*
"My"をプリフィックスに持つクラス名称（MyTestClass）を保護区指定する場合，クラス名称にアスタリスク（*）は使用できません。
この場合は，pacA.pacB.pacC.*と記述します。

アスタリスク（*）だけの指定はできません。

<要素>の前後にある半角空白は無視されます。

<要素>の前後にある全角空白は文字とみなされ，不正な値と判断されます。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/

(3)　記述例

プリフィックス名を指定する場合

#プリフィックス名指定
pacA.pacB.*

パッケージpacA.pacB以下のクラスおよびパッケージに含まれるクラスが，すべて保護区になります。

例えば，パッケージpacA.pacB.pacC以下に，pacA.pacB.pacC.pacDがある場合，pacA.pacB.pacC.pacD以下のクラスもすべて保護区になります。

クラス名を指定する場合

#クラス名指定
pacX.pacY.pacZ.MyTestpacX.pacY.pacZ.CommonTest

(4)　注意事項

保護区リストファイルは製品単位の定義です。Cosminexus Component Containerをインストールしたマシン上で動作するすべてのバッチサーバで有効になります。

保護区リストファイルはバッチサーバの起動時に読み込まれます。変更内容を有効にしたい場合は，バッチサーバを再起動する必要があります。

バッチサーバ起動時に，保護区リストファイルが存在しない，または設定が不正な場合，バッチサーバの起動に失敗します。

3.6　usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

(2)　ファイルの格納先

環境変数CJBATCHUSRCONFDIRにusrconf.cfg（バッチアプリケーション用オプション定義ファイル）の格納先のパスを設定するか，cjexecjobコマンド（バッチアプリケーション実行コマンド）を実行するディレクトリにusrconf.cfg（バッチアプリケーション用オプション定義ファイル）を格納してください。usrconf.cfg（バッチアプリケーション用オプション定義ファイル）は，cjexecjobコマンド（バッチアプリケーション実行コマンド）実行時に，次の順で検索されます。

環境変数（CJBATCHUSRCONFDIR）に設定したディレクトリ

cjexecjobコマンド（バッチアプリケーション実行コマンド）を実行したディレクトリ

(3)　機能

バッチサーバを実行するJavaVMの起動オプションを指定します。

バッチサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にバッチサーバを起動したときに反映されます。

(4)　指定できるキー

指定できるキーとデフォルト値を次の表に示します。

注意

ファイル内でマルチバイト文字を使用する場合は，次の個所で使用しているマルチバイト文字とエンコードを統一してください。

usrconf.cfg（バッチサーバ用オプション定義ファイル）

cjexecjobコマンド（バッチアプリケーション実行コマンド）の引数

バッチアプリケーションのソースコード（java.lang.System.outまたはjava.lang.System.err）

表3-3　usrconf.cfgに指定できるキーとデフォルト値（バッチサーバ）

キー名称
内容
デフォルト値

add.jvm.arg
指定された値をバッチサーバ上のバッチアプリケーションに渡します。次のオプションを指定できます。

-D<property>

次に示すプロパティは指定できません。

java.endorsed.dirs

java.security.policy

java.class.path

java.library.path

なし

add.class.path
設定されている値をバッチサーバ上にあるバッチアプリケーションクラスローダのクラスパスに追加します。このキーに指定できるJavaVMのオプションは1個だけです。複数指定する場合は，新たにadd.class.pathを追加します。ダブルクォーテーションは指定できません。
なし

batch.log.directory
ログファイルの出力先ディレクトリを指定します。ログ出力先のパスを絶対パス，または相対パスで指定します。次の文字が指定できます。

半角英数字

アンダースコア（_）

ハイフン（-）

パス区切り文字

180バイトを超えるパス（相対パス指定の場合，カレントディレクトリまでの絶対パスと相対パスの合計）を指定した場合は，KDJE40059-Wのメッセージが出力され，デフォルト値が使用されます。デフォルト値が180バイトを超える場合は，ログの初期化に失敗し，異常終了します。ディレクトリにアクセス権がない場合や，ファイル名を指定した場合は，KDJE55039-Wのメッセージが出力され，コマンドが終了します。
Windowsの場合，UNC名を含むパスは指定できません。UNIXの場合，nfsマウントされたディスク上へのパスは指定できません。
なし

batch.log.stdout.enabled
バッチジョブ投入コマンドの標準出力に，バッチジョブ投入コマンドが出すメッセージを出力するかを指定します。

trueを指定した場合：

メッセージを標準出力に出力します。

falseを指定した場合：

メッセージを標準出力に出力しません。

true

3.7　usrconf.properties（バッチアプリケーション用ユーザプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　サーバ管理コマンドの予約済みキー

(5)　cjexecjobコマンド，およびcjkilljobコマンドのカスタマイズ用キー

(1)　形式

J2SEのプロパティファイル形式です。

(2)　ファイルの格納先

環境変数CJBATCHUSRCONFDIRにusrconf.properties（バッチアプリケーション用ユーザプロパティファイル）の格納先のパスを設定するか，cjexecjobコマンド（バッチアプリケーション実行コマンド）を実行するディレクトリにusrconf.properties（バッチアプリケーション用ユーザプロパティファイル）を格納してください。usrconf.cfg（バッチアプリケーション用オプション定義ファイル）は，cjexecjobコマンド（バッチアプリケーション実行コマンド）実行時に次の順で検索されます。

環境変数（CJBATCHUSRCONFDIR）に設定したディレクトリ

cjexecjobコマンド（バッチアプリケーション実行コマンド）を実行したディレクトリ

(3)　機能

cjexecjobコマンド，およびcjkilljobコマンドを実行するJavaVMのシステムプロパティを指定します。

なお，日立のJavaVMは，J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。JDK 5.0で使用できるプロパティについては，Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

(4)　サーバ管理コマンドの予約済みキー

cjexecjobコマンド，およびcjkilljobコマンドでは，次に示す接頭子で始まるキーを内部的に利用します。このため，アプリケーションでこれらの接頭子で始まるキーを利用してはいけません。

ejbserver.*

webserver.*

appclient.*

j2eeserver.*

(5)　cjexecjobコマンド，およびcjkilljobコマンドのカスタマイズ用キー

cjexecjobコマンド，およびcjkilljobコマンドでは，次に示すシステムプロパティのキーに値を設定することで，バッチサーバの動作をカスタマイズできます。

キーの概要とデフォルト値を次の表に示します。キーの詳細については，「2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。なお，参照する場合は「J2EEサーバ」および「J2EEアプリケーション」を「バッチサーバ」および「バッチアプリケーション」と読み替えてください。

キー名称
概要
デフォルト値

ejbserver.client.ctm.RequestPriority
CTM内のキューに滞留したリクエストを引き出す時のプライオリティ（優先順位）を指定します。
4

ejbserver.container.rebindpolicy
EJBメソッドの呼び出し時に通信障害が発生した場合の，EJBクライアント側でのコネクションの再接続動作とリクエストの再送動作を指定します。
VB_TRANSPARENT

ejbserver.jndi.request.timeout
ネーミングサービスとの通信タイムアウト時間を指定します。
0

java.naming.provider.url※
バッチアプリケーションが利用するCORBAネーミングサービスのホスト名称とポート番号を指定します。
なお，旧バージョンで使用されていたプロトコル（iioplocまたはiiopname）と互換性があります。
（指定形式）
corbaname::[ホスト名称]:[ポート番号]
バッチアプリケーションが実行されるバッチサーバが利用するCORBAネーミングサービスと通信する値。

注※　このキーは，バッチアプリケーション用ユーザプロパティファイル特有のキーです。J2EEサーバ用ユーザプロパティファイルには存在しません。

4.　サーバ管理コマンドで使用するファイル

この章では，サーバ管理コマンドで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

4.1　サーバ管理コマンドで使用するファイルの一覧

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

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

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

4.1　サーバ管理コマンドで使用するファイルの一覧

サーバ管理コマンドで使用するファイルの一覧を，次の表に示します。

表4-1　サーバ管理コマンドで使用するファイルの一覧

ファイル名
分類
概要
参照先

usrconf（UNIX用）
サーバ管理コマンド用オプション定義ファイル
サーバ管理コマンドを実行するJavaVMの起動オプションを指定します。
このファイルは，UNIX用です。
4.2

usrconf.bat（Windows用）
サーバ管理コマンド用オプション定義ファイル
サーバ管理コマンドを実行するJavaVMの起動オプションを指定します。
このファイルは，Windows用です。
4.3

usrconf.properties
サーバ管理コマンド用システムプロパティファイル
サーバ管理コマンドを実行するJavaVMのシステムプロパティを指定します。
4.4

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

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

シェルスクリプトファイル形式のファイルです。

次のようにキーを指定します。

set <キー名称>="<値>"

(2)　ファイルの格納先

/opt/Cosminexus/CC/admin/usrconf/

(3)　機能

サーバ管理コマンドを実行するJavaVMの起動オプションを指定します。なお，このファイルは，UNIX用です。

(4)　指定できるキー

指定できるキーとデフォルト値を次の表に示します。

キー名称
内容
デフォルト値

USRCONF_JVM_ARGS
指定されたオプションを使ってJavaVMを起動します。次のJavaVMのオプションを指定できます。

-Xms<size>

-Xmx<size>

-Xss<size>

-Xdebug

-Xrun<libraryName>

システムプロパティを指定したい場合は，"-D"を利用しないで，usrconf.propertiesファイルに指定します。
なし

USRCONF_JVM_CLPATH
設定されている値をクラスパスに追加します。複数指定したい場合は，コロン（:）で区切ってください。
なし

USRCONF_JVM_LIBPATH
設定されている値をライブラリ検索パス環境変数に追加します。複数指定したい場合は，コロン（:）で区切ってください。
なし

(5)　記述例

#!/bin/csh -f

set USRCONF_JVM_ARGS="-Xms64m -Xmx128m"
set USRCONF_JVM_CLPATH=/usr/home/lib/mylib.jar
set USRCONF_JVM_LIBPATH=/usr/home/bin

(6)　注意事項

シェルで設定されているCLASSPATH環境変数は，サーバ管理コマンドには無効ですが，そのほかの環境変数（PATHなど）は有効です。

指定する値に次の文字を使用しないでください。
"，&，|，<，>

Server Plug-inまたはHCSC-Managerを用いて操作を行う場合は，このファイルの指定は無効です。Server Plug-inまたはHCSC-Managerを用いて操作を行う場合は，運用管理エージェント用オプション定義ファイル（adminagentuser.cfg）に指定してください。

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

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

Win32のバッチファイル形式のファイルです。

次のようにキーを指定します。

set <キー名称> <値>

(2)　ファイルの格納先

<Cosminexusのインストールディレクトリ>¥CC¥admin¥usrconf¥

(3)　機能

サーバ管理コマンドを実行するJavaVMの起動オプションを指定します。なお，このファイルは，Windows用です。

(4)　指定できるキー

指定できるキーとデフォルト値を次の表に示します。

キー名称
内容
デフォルト値

USRCONF_JVM_ARGS
指定されたオプションを使ってJavaVMを起動します。次のJavaVMのオプションを指定できます。

-Xms<size>

-Xmx<size>

-Xss<size>

-Xdebug

-Xrun<libraryName>

システムプロパティを指定したい場合は，"-D"を利用しないで，usrconf.propertiesファイルに指定します。
なし

USRCONF_JVM_CLASSPATH
設定されている値をクラスパスに追加します。複数指定したい場合は，セミコロン（;）で区切ってください。
なし

USRCONF_JVM_LIBPATH
設定されている値をライブラリ検索パス環境変数に追加します。複数指定したい場合は，セミコロン（;）で区切ってください。
なし

(5)　記述例

set USRCONF_JVM_ARGS=-Xms64m -Xmx128m
set USRCONF_JVM_CLASSPATH=C:¥home¥lib¥mylib.jar
set USRCONF_JVM_LIBPATH=C:¥home¥bin

(6)　注意事項

コマンドプロンプトで設定されているCLASSPATH環境変数は，サーバ管理コマンドには無効ですが，そのほかの環境変数（PATHなど）は有効です。

指定する値に次の文字を使用しないでください。
"，&，|，<，>

Server Plug-inまたはHCSC-Managerを用いて操作を行う場合は，このファイルの指定は無効です。Server Plug-inまたはHCSC-Managerを用いて操作を行う場合は，運用管理エージェント用オプション定義ファイル（adminagentuser.cfg）に指定してください。

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

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　サーバ管理コマンドの予約済みキー

(5)　サーバ管理コマンドのカスタマイズ用キー

(6)　記述例

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

記載する文字はJavaの仕様に従って，ISO 8859-1 文字エンコーディングを使用してください。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥usrconf¥

UNIXの場合
/opt/Cosminexus/CC/admin/usrconf/

(3)　機能

サーバ管理コマンドを実行するJavaVMのシステムプロパティを指定します。

なお，日立のJavaVMは，J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。JDK 5.0で使用できるプロパティについては，Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

(4)　サーバ管理コマンドの予約済みキー

サーバ管理コマンドでは，次に示す接頭子で始まるキーを内部的に利用します。このため，アプリケーションでこれらの接頭子で始まるキーを利用してはいけません。

ejbserver.*

webserver.*

appclient.*

j2eeserver.*

(5)　サーバ管理コマンドのカスタマイズ用キー

サーバ管理コマンドでは，次に示すシステムプロパティのキーに値を設定することで，J2EEサーバの動作をカスタマイズできます。

ここでは，キーを次の分類に分けて説明します。

ejbserver.cuiから始まるキー

ejbserver.loggerから始まるキー

ejbserver.namingから始まるキー

ejbserver.rmiから始まるキー

vbrokerから始まるキー

(a)　ejbserver.cuiから始まるキー

キー名称
内容
デフォルト値

ejbserver.cui.checkmethod.compatible
cjsetapppropまたはcjsetrespropコマンド実行時に引数で指定された属性ファイル中のメソッドのチェック方法を指定します。チェックの引数になるメソッドは，属性ファイルの次のタグで指定されたメソッドです。

<method-permission>

<container-transaction>

<exclude-list>

<ejb-method-observation-timeout>

<ejb-transaction-timeout>

trueを指定した場合：

07-50より前と同等のチェックを行います。

falseを指定した場合：

07-50以降のチェックを行います。

これら以外の値が指定された場合は，新規インストール時のデフォルト値（false）で動作します。

新規インストールの場合：false

07-50より前からのアップグレードの場合：true

ejbserver.cui.exitcode.compatible
サーバ管理コマンド実行時に排他エラーで実行できなくなった場合に，終了コード「1」を返却するかどうかを指定します。

trueを指定した場合：

排他エラーの場合に終了コード「1」を返却します。

falseを指定した場合：

排他エラーの場合に終了コード「2」を返却します。

タイムアウトエラーの場合に終了コード「3」を返却します。

新規インストールの場合：false

06-00バージョンアップの場合：true

ejbserver.cui.logfile.compatible
07-00以降のログ出力形態にするか06-70以前のログ出力形態にするかを指定します。指定できる値と動作を次に示します。

falseを指定した場合：

07-00以降のログ出力形態にします。

trueを指定した場合：

06-70以前のログ出力形態にします。

不正な値（すべて小文字のtrueまたはfalse以外）を指定した場合は，メッセージを出力し，デフォルト値を設定します。
Server Plug-inまたはHCSC-Managerから操作した場合，この指定は無効となり，falseが仮定されます。
false

ejbserver.cui.optionalname.enabled
JNDIのユーザ指定名前空間管理機能を使用する場合に，サーバ管理コマンドからEJBHomeオブジェクトに別名（Optional Name）を指定するときに指定します。

trueを指定した場合：

サーバ管理コマンドから別名を指定できます。

falseを指定した場合：

サーバ管理コマンドから別名を指定できません。

true

(b)　ejbserver.loggerから始まるキー

キー名称 | 内容 | デフォルト値
ejbserver.logger.enabled.* | サーバ管理コマンドが出力するログレベルを指定します。一つだけ指定した場合は，該当するログレベルのログだけが出力されます。複数指定する場合は，レベル名の文字列の間をコンマ（,）で区切ります。Error，Warning，Information，Debugのうち，一つまたは複数を指定します。通常はデフォルトのまま利用してください。 | Error，Warning

(c)　ejbserver.namingから始まるキー

キー名称
内容
デフォルト値

ejbserver.naming.host
サーバ管理コマンド実行時に，ネーミングサービスとして利用するCORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定します。
ネーミングの切り替え機能を使用する場合，ホスト名称として"localhost"は使用しないでください。CORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定してください。
CORBAネーミングサービスを自動起動モード（ejbserver.naming.startupMode=automaticまたはinprocess）で使用する場合，デフォルト値（"localhost"），またはJ2EEサーバを起動させるホスト名称もしくはIPアドレスを指定してください。
localhost

ejbserver.naming.port
サーバ管理コマンド実行時に，J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を1～65535の整数で指定します。ポート番号には，すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合，起動処理が完了しないことがあります。
900

ejbserver.naming.protocol
サーバ管理コマンド実行時に，ネーミングサービスとして利用するCORBAネーミングサービスへのアクセスプロトコルを指定します。現状，corbanameだけをサポートしています。ただし，旧バージョンで使用されていたプロトコル（iioplocまたはiopname）でも動作できます。
corbaname

(d)　ejbserver.rmiから始まるキー

キー名称
内容
デフォルト値

ejbserver.rmi.request.timeout
サーバ管理コマンドが通信障害によって応答が返らなくなった場合の通信タイムアウト時間（単位：秒）を0～86400の整数で指定します。
0を指定した場合はタイムアウトしません。86400を超える値を設定した場合，警告メッセージが出力されて，デフォルト値が適用されます。
なお，次のコマンドは，このプロパティの影響を受けません。

cjstopapp

cjreplaceapp

これらのコマンドに対してタイムアウト時間を指定する場合は，コマンドの-t引数で指定してください。
180（秒）

(e)　vbrokerから始まるキー

キー名称
内容
デフォルト値

vbroker.agent.port
サーバ管理コマンド実行時に，利用するスマートエージェントのポート番号を指定します。詳細については，マニュアル「Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス」を参照してください。
14000

vbroker.orb.htc.tracePath
Cosminexus TPBrokerのトレースファイル出力先のパスを1～210バイトの範囲で指定します。指定したパスのサブディレクトリとしてcomtrcとmdltrcをあらかじめ作成しておく必要があります。デフォルトの出力先の場合，サブディレクトリcomtrcとmdltrcはサーバ初回起動時に自動作成されます。ディレクトリのパスの区切り記号には，"/"を使用してください。
例えば，workディレクトリとしてC:¥temp¥workを設定する場合，次のように指定します。
（指定例）
vbroker.orb.htc.tracePath=c:/temp/work
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj
または
/opt/Cosminexus/CC/admin/logs/TPB/logj

(6)　記述例

ejbserver.naming.host=localhost
ejbserver.naming.port=900

5.　J2EEアプリケーションとリソースの設定で使用する属性ファイル

この章では，J2EEアプリケーションとリソースの設定で使用する属性ファイルについて説明します。

＜この章の構成＞

5.1　J2EEアプリケーションとリソースの設定で使用する属性ファイルの一覧

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

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

5.4　EJB-JAR属性ファイル

5.5　Session Bean属性ファイル

5.6　Entity Bean属性ファイル

5.7　MessageDrivenBean属性ファイル

5.8　WAR属性ファイル

5.9　フィルタ属性ファイル

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

5.11　Connector属性ファイル

5.12　JavaBeansリソース属性ファイル

5.13　データソース設定ファイル

5.14　データソース属性ファイル

5.15　プール管理情報設定ファイル

5.16　メール属性ファイル

5.1　J2EEアプリケーションとリソースの設定で使用する属性ファイルの一覧

J2EEアプリケーションとリソースの設定では，属性ファイルを使用します。属性ファイルは，サーバ管理コマンドのCUIを実行する場合に，引数に指定するファイルです。

なお，属性ファイルのファイル名は任意です。

属性ファイルの一覧を，次の表に示します。

表5-1　属性ファイルの一覧

ファイルの種類 | 概要 | 参照先
アプリケーション統合属性ファイル | アプリケーション，EJB-JAR，Session Bean，Entity Bean，Message-driven Bean，WAR，フィルタ，サーブレット/JSPおよびリソースアダプタの属性を一括して取得，編集する場合に使用するファイルです。 | 5.2
アプリケーション属性ファイル | アプリケーションの属性を取得，編集する場合に使用するファイルです。 | 5.3
EJB-JAR属性ファイル | EJB-JARの属性を取得，編集する場合に使用するファイルです。 | 5.4
Session Bean属性ファイル | Session Beanの属性を取得，編集する場合に使用するファイルです。 | 5.5
Entity Bean属性ファイル | Entity Beanの属性を取得，編集する場合に使用するファイルです。 | 5.6
MessageDrivenBean属性ファイル | MessageDrivenBeanの属性を取得，編集する場合に使用するファイルです。 | 5.7
WAR属性ファイル | WARの属性を取得，編集する場合に使用するファイルです。 | 5.8
フィルタ属性ファイル | フィルタの属性を取得，編集する場合に使用するファイルです。 | 5.9
サーブレット属性ファイル | サーブレット/JSPの属性を取得，編集する場合に使用するファイルです。 | 5.10
Connector属性ファイル | リソースアダプタの属性を取得，編集する場合に使用するファイルです。 | 5.11
JavaBeansリソース属性ファイル | JavaBeansの属性を取得，編集する場合に使用するファイルです。 | 5.12
データソース設定ファイル | データソースの動作に使用する情報を設定する場合に使用するファイルです。 | 5.13
データソース属性ファイル | データソースの属性を取得，編集する場合に使用するファイルです。 | 5.14
プール管理情報設定ファイル | Webコンテナのコネクションプール機能を設定する場合に使用するファイルです。 | 5.15
メール属性ファイル | メールコンフィグレーションの属性を取得，編集する場合に使用するファイルです。 | 5.16

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

それぞれの属性ファイルに対応するDTDファイルの格納先を次の表に示します。

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

属性ファイル | DTDファイルの格納先
データソース設定ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-datasource-configuration_6_0.dtd
アプリケーション属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-application-property_7_0.dtd
EJB-JAR属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-ejb-jar-property_7_1.dtd
Session Bean属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-session-bean-property_7_6.dtd
Entity Bean属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-entity-bean-property_7_6.dtd
WAR属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-war-property_7_6.dtd
Servlet属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-servlet-property_7_0.dtd
データソース属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-datasource-property_6_0.dtd
メール属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-mail-property_7_1.dtd
Connector属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-connector-property_7_6.dtd
MessageDrivenBean属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-message-bean-property_7_6.dtd
プール管理情報設定ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-webconpool-configuration_6_0.dtd
アプリケーション統合属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-application-all-property_7_6.dtd
Filter属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-filter-property_7_0.dtd
JavaBeansリソース属性ファイル | <Cosminexusのインストールディレクトリ>¥CC¥admin¥dtds¥hitachi-javabeans-resource-property_7_0.dtd

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

属性ファイル | DTDファイルの格納先
データソース設定ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-datasource-configuration_6_0.dtd
アプリケーション属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-application-property_7_0.dtd
EJB-JAR属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-ejb-jar-property_7_1.dtd
Session Bean属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-session-bean-property_7_6.dtd
Entity Bean属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-entity-bean-property_7_6.dtd
WAR属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-war-property_7_6.dtd
Servlet属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-servlet-property_7_0.dtd
データソース属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-datasource-property_6_0.dtd
メール属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-mail-property_7_1.dtd
Connector属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-connector-property_7_6.dtd
MessageDrivenBean属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-message-bean-property_7_6.dtd
プール管理情報設定ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-webconpool-configuration_6_0.dtd
アプリケーション統合属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-application-all-property_7_6.dtd
Filter属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-filter-property_7_0.dtd
JavaBeansリソース属性ファイル | /opt/Cosminexus/CC/admin/dtds/hitachi-javabeans-resource-property_7_0.dtd

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

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

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

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

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

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

＜この節の構成＞

5.2.1　アプリケーション統合属性ファイルの指定内容

5.2.1　アプリケーション統合属性ファイルの指定内容

アプリケーション統合属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-application-all-property PUBLIC '-//Hitachi, Ltd.//DTD Application All Property 7.6//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-application-all-property_7_6.dtd'>

アプリケーション統合属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-application-all-property>
1回
ルートタグ。

┣
┃
┃
┃
┃
┃
<hitachi-application-property>
0または1回※1
アプリケーションの属性。
詳細については，「5.3　アプリケーション属性ファイル」を参照してください。※2

┣
┃
┃
┃
<ejb-jar>
0回以上※1
EJBに関する情報。
ルートアプリケーションに含まれるEJB-JARの数だけ出力されます。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<hitachi-ejb-jar-property>
1回
EJB-JARの属性。
詳細については，「5.4　EJB-JAR属性ファイル」を参照してください。※2※3

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<hitachi-session-bean-property>
0回以上※1
Session Beanの属性。
EJB-JARに含まれるSession Beanの数だけ出力されます。
詳細については，「5.5　Session Bean属性ファイル」を参照してください。※2※3

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<hitachi-entity-bean-property>
0回以上※1
Entity Beanの属性。
EJB-JARに含まれるEntity Beanの数だけ出力されます。
詳細については，「5.6　Entity Bean属性ファイル」を参照してください。※2※3

┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<hitachi-message-bean-property>
0回以上※1
MessageDrivenBeanの属性。
EJB-JARに含まれるMessageDrivenBeanの数だけ出力されます。
詳細については，「5.7　MessageDrivenBean属性ファイル」を参照してください。※2※3

┣
┃
┃
┃
<war>
0回以上※1
WARに関する情報。
ルートアプリケーションに含まれるWARの数だけ出力されます。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<hitachi-war-property>
1回
WARの属性。
詳細については，「5.8　WAR属性ファイル」を参照してください。※2※3

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<hitachi-filter-property>
0回以上※1
フィルタの属性。
WARに含まれるフィルタの数だけ出力されます。
詳細については，「5.9　フィルタ属性ファイル」を参照してください。※2※3

┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<hitachi-servlet-property>
0回以上※1
サーブレット/JSPの属性。
WARに含まれるサーブレット/JSPの数だけ出力されます。
詳細については，「5.10　サーブレット属性ファイル」を参照してください。※2※3

┗
<rar>
0回以上※1
RARに関する情報。
ルートアプリケーションに含まれるRARの数だけ出力されます。

┗
<hitachi-connector-property>
1回
Connectorの属性。
RARに含まれるConnectorの数だけ出力されます。
詳細については，「5.11　Connector属性ファイル」を参照してください。※2※3

注※1

タグの単位で省略できます。この場合，指定していない項目の属性は変更されません。

注※2

各属性ファイルの内容と，一部タグ名やタグの出力順序が異なっている部分があります。タグ名の違いについては，次の表を参照してください。

表5-4　統合属性ファイルで出力されるタグ名

属性ファイル名 | タグ名 | 統合属性ファイルのタグ名
Session Bean属性ファイル | <runtime> | <session-runtime>
Entity Bean属性ファイル | <runtime> | <entity-runtime>
MessageDrivenBean属性ファイル | <runtime> | <message-runtime>
<security-identity> | <message-security-identity>
WAR属性ファイル | <runtime> | <war-runtime>

注※3

display-nameは，変更できません。

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

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

＜この節の構成＞

5.3.1　アプリケーション属性ファイルの指定内容

5.3.1　アプリケーション属性ファイルの指定内容

アプリケーション属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-application-property PUBLIC '-//Hitachi, Ltd.//DTD Application Property 7.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-application-property_7_0.dtd'>

アプリケーション属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-application-property>
1回
ルートタグ。

┣
┃
┃
┃
<description>
0または1回
アプリケーションの説明。

┣
┃
┃
<icon>
0または1回
Deployツール上に表示されるJ2EEアプリケーションのアイコンの定義を行う。

┃
┃
┃
┣
┃
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。

┃
┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<lookup-name>
1回
クライアントからEJBをルックアップするときに使う名前を255文字以下で指定します。
HITACHI_EJB/SERVERS/<サーバ名称>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<アプリケーションのルックアップ名>に相当します。このタグは参照専用です。ルックアップ名はアプリケーション名を基に自動的に作られます。※

┣
┃
<security-prop>
1回
Enterprise Beanのセキュリティの管理方法。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<security-method>
1回
セキュリティの管理方法。
次のどれかを指定します。

disable_methods_without_roles

セキュリティロールを割り当てていないメソッドは実行できません。

map_methods_without_roles

セキュリティロールを割り当てていないメソッドには，default-security-roleで指定したデフォルトセキュリティロールが割り当てられます。

no_security_for_methods_without_roles

セキュリティロールが割り当てられていないメソッドはどのユーザでも実行できます。

セキュリティロールが割り当てられているメソッドはセキュリティロールによって実行が制限されます。

no_security_for_all_methods

セキュリティロールが割り当てられているメソッドも割り当てられていないメソッドもすべてどのユーザでも実行できます。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<default-security-role>
0または1回
security-methodにmap_methods_without_rolesを指定した場合のデフォルトセキュリティロール。
map_methods_without_roles以外を指定している場合は省略できます（設定されていてもcjsetapppropで無視されます）。

┣
┃
┃
┃
┃
┃
<start-order>
0または1回
J2EEアプリケーション開始時および停止時の順番。
開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。
0≦start-order≦2147483647

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<scheduling-unit>
0または1回
キューの配置モデルの指定。
次のどちらかを指定します。

Application

キューをアプリケーションごとに配置します。

デフォルトは，Applicationです。

Bean

キューをBeanごとに配置します。

┣
┃
┃
┃
┃
┃
┃
┃
<scheduling>
0または1回
CTMとの連携についての定義。
なお，このタグは構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけに有効です。それ以外の場合に指定するとエラーになります。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<queue-name>
1回
スケジューリングをするキューの名称を，63文字までの英数字（0～9，A～Z，a～z）およびアンダースコア（_）で指定します。デフォルト値は，アプリケーション名です。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<parallel-count>
1回
CTMがアプリケーションを呼び出すために用意するスレッド数を，1～127の範囲で指定します。デフォルトは，1です。
CTM経由で呼び出されるBeanで，Maximumの値がparallel-countの値より小さい場合エラーとなります。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<queue-length>
0または1回
スケジューリングをするキューの長さを，1～32767の整数値で指定します。
キューを共有する場合，キューを共有するアプリケーション間やBean間で設定値が異なるとき，すでに生成されているキューの長さが有効になります。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<managed-by-ctm>
1回
CTM連携をするかどうかの指定。
次のどちらかを指定します。

true

CTMと連携します。

false

CTMと連携しません。

デフォルト値は，falseです。

┣
┃
┃
<ref-libraries>
0または1回
参照するライブラリの指定。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<classpath>
1回以上
クラスパスの指定。
ref-librariesが指定されていて，このタグが存在しない場合，エラーとなります。
このタグを複数指定した場合，指定した順序でランタイム属性に設定されます。クラスローダに設定されるクラスパスについては，マニュアル「Cosminexus　機能解説」を参照してください。

┗
<method-observation-recovery-mode>
0または1回
J2EEアプリケーションの時間監視機能の障害回復モードの指定。
ここでは，threadだけが指定できます。

thread

スレッドを停止します。

注※

cjgetapppropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

5.4　EJB-JAR属性ファイル

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

＜この節の構成＞

5.4.1　EJB-JAR属性ファイルの指定内容

5.4.2　DDとの対応

5.4.1　EJB-JAR属性ファイルの指定内容

EJB-JAR属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-ejb-jar-property PUBLIC '-//Hitachi, Ltd.//DTD Ejb Jar Property 7.1//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-ejb-jar-property_7_1.dtd'>

EJB-JAR属性ファイルは，次に示すタグを持つxmlファイルです。

なお，設定先のEJB-JARがDD（ejb-jar.xml）を保持していない場合，EJB-JAR属性ファイルのタグは変更できません。

タグ名
出現パターン
説明

<hitachi-ejb-jar-property>
1回
ルートタグ。

┣
┃
┃
┃
<description>※1
0回以上※2
EJB-JARの説明。※3

┣
┃
┃
┃
┃
┃
<display-name>※1
1回以上※2
EJB-JARの表示名。※3
1≦文字列長
変更する場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。

┣
┃
┃
<icon>※1
0回以上※2
GUIツール上に表示されるEJB-JARのアイコンの定義。※3

┃
┃
┃
┣
┃
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。※3

┃
┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。※3

┣
┃
┃
<interceptors>
0または1回
インターセプタの設定。※4

┃
┃
┣
┃
<description>※1
0回以上※2
Interceptorsの説明。※4

┃
┃
┃
┗
<interceptor>
1回以上
インターセプタクラスの設定。※4

┃
┃

┣
┃
<description>※1
0回以上※2
interceptor-classの説明。※4

┃
┃

┣
┃
<interceptor-class>
1回
インターセプタクラスの名称。※4

┃
┃
┃

┣
┃
┃
<around-invoke>
0回以上
インターセプタのaroundinvokeメソッドの定義。※4

┃
┃
┃
┃

┃
┃
┃
┃
┣
┃
┃
┃
<class>
0または1回
インターセプタのaroundinvokeメソッドが存在するクラスをパッケージ名から表示。※4

┃
┃
┃

┃
┃
┃
┗
<method-name>
1回
インターセプタのaroundinvokeメソッドの名称。※4

┃
┃
┃

┣
┃
┃
<post-construct>
0回以上
インターセプタのpost-constructメソッドの定義。※4

┃
┃
┃
┃

┃
┃
┃
┃
┣
┃
┃
┃
<lifecycle-callback-class>
0または1回
インターセプタのpost-constructメソッドが存在するクラスをパッケージ名から表示。※4

┃
┃
┃
┃

┃
┃
┃
┃
┗
<lifecycle-callback-method>
1回
インターセプタのpost-constructメソッド名を表示。※4

┃
┃
┃

┣
┃
┃
<pre-destroy>
0回以上
インターセプタのpre-destroyメソッドの定義。※4

┃
┃
┃
┃

┃
┃
┃
┃
┣
┃
┃
┃
<lifecycle-callback-class>
0または1回
インターセプタのpre-destroyメソッドが存在するクラスをパッケージ名から表示。※4

┃
┃
┃

┃
┃
┃
┗
<lifecycle-callback-method>
1回
インターセプタのpre-destroyメソッド名を表示。※4

┃
┃
┃

┣
┃
┃
<post-activate>
0回以上
インターセプタのpost-activateメソッドの定義。※4

┃
┃
┃
┃

┃
┃
┃
┃
┣
┃
┃
┃
<lifecycle-callback-class>
0または1回
インターセプタのpost-activateメソッドが存在するクラスをパッケージ名から表示。※4

┃
┃┃
┃

┃
┃
┃
┃
┗
<lifecycle-callback-method>
1回
インターセプタのpost-activateメソッド名を表示。※4

┃
┃
┃

┗
<pre-passivate>
0回以上
インターセプタのpre-passivateメソッドの定義。※4

┃
┃
┃
┃

┣
┃
┃
┃
<lifecycle-callback-class>
0または1回
インターセプタのpre-passivateメソッドが存在するクラスをパッケージ名から表示。※4

┃
┃
┃

┗
<lifecycle-callback-method>
1回
インターセプタのpre-passivateメソッド名を表示。※4

┣
┃
┃
<relationships>
0または1回
リレーションシップについての定義。※3

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
relationshipsの説明。※3

┃
┃
┃
┃
┗
<ejb-relation>
1回以上
二つのCMP EntityBean間のリレーションシップについての定義。※3

┃
┃
┃

┣
┃
┃
<description>※1
0回以上※2
ejb-relationの説明。※3

┃
┃
┃

┣
┃
┃
<ejb-relation-name>
0または1回
relationshipsの名称。※3

┃
┃
┃

┣
┃
┃
<ejb1>
1回
ejb2に対するejb1の関連情報。※3

┃
┃
┃

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
ejb1の説明。※3

┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<ejb-relationship-role-name>
0または1回
リレーションシップロール名。※3
二つのCMP EntityBean間のリレーションシップ定義中では，それぞれ一意な名称を指定します。別リレーションシップ定義では，同じ名称であっても指定できます。

┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<multiplicity>
1回
ejb1のインスタンスの多重度。※3
指定できる文字列を次に示します。

One

Many

┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<cascade-delete>
0または1回
ejb2の削除時にejb1の自動削除をするかどうかの指定。※3
ejb2のmultiplicityがoneの場合に有効です。

┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<ejb-name>
1回
ejb1の名称。※3
指定できる文字列は，EJB-JAR中に存在するCMP2.0 Entity BeanのEJB名（<ejb-name>タグの値）です。

┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<cmr-field-name>
1回
ejb2のインスタンスを取得するCMRフィールド。※3
指定できる値は，「No EJB Name」または<ejb name>で指定したEJBが持つCMRフィールドのどれかです。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<cmr-field-type>
0または1回
CMRフィールド用メソッドの戻り値の型。※3
表示される値は，<cmr-field-name>で指定したaccessメソッドの戻り値です。
「java.util.Collection」または「java.util.Set」の場合は，そのまま表示します。それ以外の場合は空文字です。

┃
┃

┗
<ejb2>
1回
ejb1に対するejb2の関連情報。※3

┃
┃
┃

┣
┃
┃
<description>※1
0回以上※2
ejb2の説明。※3

┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
<ejb-relationship-role-name>
0または1回
リレーションシップロール名。※3
二つのCMP EntityBean間のリレーションシップ定義中では，それぞれ一意な名称を指定します。別リレーションシップ定義では，同じ名称であっても指定できます。

┃
┃
┃┃
┃
┃

┣
┃
┃
┃
┃
┃
<multiplicity>
1回
ejb2のインスタンスの多重度。※3
指定できる文字列を次に示します。

One

Many

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<cascade-delete>
0または1回
ejb1の削除時にejb2の自動削除をするかどうかの指定。※3
ejb1のmultiplicityがoneの場合に有効です。

┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
<ejb-name>
1回
Ejb2の名称。※3
指定できる文字列は，EJB-JAR中に存在するCMP2.0 Entity BeanのEJB名（<ejb-name>タグの値）です。

┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
<cmr-field-name>
1回
ejb2のインスタンスを取得するCMRフィールド。※3
指定できる値は，「No EJB Name」または<ejb name>で指定したEJBが持つCMRフィールドのどれかです。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<cmr-field-type>
0または1回
CMRフィールド用メソッドの戻り値の型。※3
表示される値は，<cmr-field-name>で指定したaccessメソッドの戻り値。
「java.util.Collection」または「java.util.Set」の場合は，そのまま表示。それ以外の場合は空文字。

┣
┃
┃
<security-role>
0回以上
セキュリティロールについての定義。※3

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
security-roleの説明。※3

┃
┣
<role-name>
1回
ロール名。※3

┃
┃
┃
┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
cjaddsecコマンドで定義したロール名。
cjsetrespropでは無視されます。
設定先のEJB-JARがDD（ejb-jar.xml）を保持していない場合でも，変更できます。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<interceptor-binding>
0回以上
クラスレベル，インターセプタおよびメソッドレベル・インターセプタに関する設定。※5
cjsetrespropでは無視されます。<ejb-name>にワイルドカードを設定した<interceptor-binding>の指定が複数ある場合，ワーニングメッセージ（KDJE37604-W）が出力され，先に設定された<interceptor-binding>の<interceptor-class>の値が有効になります。
また，設定先がEJB2.1以前の場合は，ワーニングメッセージ（KDJE37603-W）が出力され，設定が無視されます。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
interceptor-bindingの説明。※5

┃
┃
┃
┣
┃
┃
<ejb-name>
1回
ワイルドカード（*）またはEnterprise Beanの<ejb-name>。※5

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<interceptor-class>
0回以上
インターセプタのクラスの名称。※4
<interceptor-class>と<interceptor-order>のどちらか一つを指定します。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<interceptor-order>
1回
インターセプタの順序性またはレベルの設定。※4
<interceptor-class>と<interceptor-order>のどちらか一つを指定します。

┃
┃
┃
┃
┗
<interceptor-class>
1回以上
インターセプタのクラスの名称。※4

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<exclude-default-interceptors>
0または1回
デフォルトインターセプタを除外するかどうか。※4
表示される文字列を次に示します。

true（除外する場合）

false（除外しない場合）

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<exclude-class-interceptors>
0または1回
クラスインターセプタを除外するかどうか。※4
表示される文字列を次に示します。

true（除外する場合）

false（除外しない場合）

┃
┃
┃
┗
<named-method>
0または1回
メソッドの定義。※4

┃
┃

┣
┃
<method-name>
1回
メソッドの名称。※4

┃
┃
┃

┗
<method-params>
0または1回
メソッドの引数。※4

┃
┃

┗
<method-param>
0回以上
メソッドの引数。※4

┣
┃
<application-exception>
0回以上
アプリケーション例外に関する設定。※4

┃
┃
┣
┃
<exception-class>
1回
クライアントに通知する例外クラスの名称。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<rollback>
0または1回
指定した例外が発生したとき，クライアントに通知する前にロールバックを行うかどうか。※4
表示される文字列を次に示します。

true（ロールバックを行う）

false（ロールバックを行わない）

┗
<ejb-client-jar>
0または1回
クライアントJARファイルの名称。※3

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

アノテーションの設定値の場合は，値の変更をしてはいけません。

注※4

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※5

デフォルトインターセプタに関する定義（<ejb-name>タグの指定がワイルドカード（*）の場合）にだけ追加，変更できます。

5.4.2　DDとの対応

EJB-JAR属性ファイルとDeployment Descriptorの対応を次に示します。

EJB-JAR属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-ejb-jar-property>
1回
<ejb-jar>
1回

┣
┃
<description>
0回以上
┣
┃
<description>
0回以上

┣
┃
<display-name>
1回以上
┣
┃
<display-name>
0回以上

┣
┃
<icon>
0回以上
┣
┃
<icon>
0回以上

┃
┃
┣
┃
<small-icon>
0または1回
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回
┃
┃
┗
<large-icon>
0または1回

┃
┃
－
－
┣
┃
<enterprise-beans>
1回

┃
┃
－
－
┃
┃
(省略)
－

┣
┃
<interceptors>
0または1回
┃
┃
－
－

┃
┃
┣
┃
<description>
0回以上
┃
┃
－
－

┃
┃
┗
<interceptor>
1回以上
┃
┃
－
－

┃
┃

┣
┃
<description>
0回以上
┃
┃
－
－

┃
┃

┣
┃
<interceptor-class>
1回
┃
┃
－
－

┃
┃

┣
┃
<around-invoke>
0回以上
┃
┃
－
－

┃
┃

┃
┃
┣
┃
<class>
0または1回
┃
┃
－
－

┃
┃

┃
┃
┗
<method-name>
1回
┃
┃
－
－

┃
┃

┣
┃
<post-construct>
0回以上
┃
┃
－
－

┃
┃

┃
┃
┣
┃
<lifecycle-callback-class>
0または1回
┃
┃
－
－

┃
┃

┃
┃
┗
<lifecycle-callback-method>
1回
┃
┃
－
－

┃
┃

┣
┃
<pre-destroy>
0回以上
┃
┃
－
－

┃
┃

┃
┃
┣
┃
<lifecycle-callback-class>
0または1回
┃
┃
－
－

┃
┃

┃
┃
┗
<lifecycle-callback-method>
1回
┃
┃
－
－

┃
┃

┣
┃
<post-activate>
0回以上
┃
┃
－
－

┃
┃

┃
┃
┣
┃
<lifecycle-callback-class>
0または1回
┃
┃
－
－

┃
┃

┃
┃
┗
<lifecycle-callback-method>
1回
┃
┃
－
－

┃
┃

┗
<pre-passivate>
0回以上
┃
┃
－
－

┃
┃

┣
┃
<lifecycle-callback-class>
0または1回
┃
┃
－
－

┃
┃

┗
<lifecycle-callback-method>
1回
┃
┃
－
－

┣
┃
<relationships>
0または1回
┣
┃
<relationships>
0または1回

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┗
<ejb-relation>
1回以上
┃
┃
┗
<ejb-relation>
1回以上

┃
┃

┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<ejb-relation-name>
0または1回
┃
┃

┣
┃
<ejb-relation-name>
0または1回

┃
┃

┣
┃
<ejb1>
1回
┃
┃

┣
┃
<ejb-relationship-role>
1回

┃
┃

┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃

┃
┃
┣
┃
<ejb-relationship-role-name>
0または1回
┃
┃

┃
┃
┣
┃
<ejb-relationship-role-name>
0または1回

┃
┃

┃
┃
┣
┃
<multiplicity>
1回
┃
┃

┃
┃
┣
┃
<multiplicity>
1回

┃
┃

┃
┃
┣
┃
<cascade-delete>
0または1回
┃
┃

┃
┃
┣
┃
<cascade-delete>
0または1回

┃
┃

┃
┃
┃
┃
－
－
┃
┃

┃
┃
┣
┃
<relationship-role-source>
1回

┃
┃

┃
┃
┃
┃
－
－
┃
┃

┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃

┃
┃
┣
┃
<ejb-name>
1回
┃
┃

┃
┃
┃
┃
┗
<ejb-name>
1回

┃
┃

┃
┃
┃
┃
－
－
┃
┃

┃
┃
┗
<cmr-field>
0または1回

┃
┃

┃
┃
┃
┃
－
－
┃
┃

┃
┃

┣
┃
<description>
0回以上

┃
┃

┃
┃
┣
┃
<cmr-field-name>
1回
┃
┃

┃
┃

┣
┃
<cmr-field-name>
1回

┃
┃

┃
┃
┗
<cmr-field-type>
0または1回
┃
┃

┃
┃

┗
<cmr-field-type>
0または1回

┃
┃

┗
<ejb2>
1回
┃
┃

┗
<ejb-relationship-role>
1回

┃
┃

┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<ejb-relationship-role-name>
0または1回
┃
┃

┣
┃
<ejb-relationship-role-name>
0または1回

┃
┃

┣
┃
<multiplicity>
1回
┃
┃

┣
┃
<multiplicity>
1回

┃
┃

┣
┃
<cascade-delete>
0または1回
┃
┃

┣
┃
<cascade-delete>
0または1回

┃
┃

┃
┃
－
－
┃
┃

┣
┃
<relationship-role-source>
1回

┃
┃

┃
┃
－
－
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃

┣
┃
<ejb-name>
1回
┃
┃

┃
┃
┗
<ejb-name>
1回

┃
┃

┃
┃
－
－
┃
┃

┗
<cmr-field>
0または1回

┃
┃

┃
┃
－
－
┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<cmr-field-name>
1回
┃
┃

┣
┃
<cmr-field-name>
1回

┃
┃

┗
<cmr-field-type>
0または1回
┃
┃

┗
<cmr-field-type>
0または1回

┃
┃
－
－
┣
┃
<assembly-descriptor>
0または1回

┣
┃
<security-role>
0回以上
┃
┃
┣
┃
<security-role>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<role-name>
1回
┃
┃
┃
┃
┗
<role-name>
1回

┃
┃
┗
<linked-to>
0または1回
┃
┃
┃
┃
－
－

┣
┃
<interceptor-binding>
0回以上
┃
┃
┗
<interceptor-binding>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-name>
1回
┃
┃

┣
┃
<ejb-name>
1回

┃
┃
┣
┃
<interceptor-class>※
0回以上
┃
┃

┣
┃
<interceptor-class>
0回以上

┃
┃
┣
┃
<interceptor-order>※
1回
┃
┃

┣
┃
<interceptor-order>
1回

┃
┃
┃
┃
┗
<interceptor-class>
1回以上
┃
┃

┃
┃
┗
<interceptor-class>
1回以上

┃
┃
┣
┃
<exclude-default-interceptors>
0または1回
┃
┃

┣
┃
<exclude-default-interceptors>
0または1回

┃
┃
┣
┃
<exclude-class-interceptors>
0または1回
┃
┃

┣
┃
<exclude-class-interceptors>
0または1回

┃
┃
┗
<named-method>
0または1回
┃
┃

┗
<method>
0または1回

┃
┃

┣
┃
<method-name>
1回
┃
┃

┣
┃
<method-name>
1回

┃
┃

┗
<method-params>
0または1回
┃
┃

┗
<method-params>
0または1回

┃
┃

┗
<method-param>
0回以上
┃
┃

┗
<method-param>
0回以上

┣
┃
<application-exception>
0回以上
┃
┃
－
－

┃
┃
┣
┃
<exception-class>
1回
┃
┃
－
－

┃
┃
┗
<rollback>
0または1回
┃
┃
－
－

┃
┃
－
－
┃
┃
(省略)
－

┗
<ejb-client-jar>
0または1回
┗
<ejb-client-jar>
0または1回

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<interceptor-class>と<interceptor-order>のどちらか一つを指定します。

5.5　Session Bean属性ファイル

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

＜この節の構成＞

5.5.1　Session Bean属性ファイルの指定内容

5.5.2　DDとの対応

5.5.1　Session Bean属性ファイルの指定内容

Session Bean属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-session-bean-property PUBLIC '-//Hitachi, Ltd.//DTD Session Bean Property 7.6//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-session-bean-property_7_6.dtd'>

Session Bean属性ファイルは，次に示すタグを持つxmlファイルです。

なお，設定先のEJB-JARがDD（ejb-jar.xml）を保持していない場合，Session Bean属性ファイルのタグは変更できません。

タグ名
出現パターン
説明

<hitachi-session-bean-property>
1回
ルートタグ。

┣
┃
┃
<description>※1
0回以上※2
Session Beanの説明。※4

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<display-name>※1
1回以上※2
Session Beanの表示名。※4
xml:lang属性が"en"のdisplay-nameを必ず指定します。当該リソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。
1≦文字列長
xml:lang属性が"en"のタグの場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。
xml:lang属性が"en"のタグ以外の場合，文字の制限はありません。

┣
┃
┃
<icon>※1
0回以上※2
GUIツール上に表示されるSession Beanのアイコンの定義。※4

┃
┃
┃
┃
┣
┃
┃
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。※4

┃
┃
┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。※4

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<mapped-name>
0または1回
@Statelessや@StatefulのmappedName属性に設定されているEnterprise Beanの別名。
<optional-name>タグまたは<local-optional-name>タグで別名が設定されている場合は，<optional-name>タグまたは<local-optional-name>タグに設定されている値が優先されます。
<optional-name>タグまたは<local-optional-name>タグに別名が設定されていない場合，デフォルトの別名として使用されます。

┣
┃
┃
<business-local>
0回以上
ローカルビジネスインタフェースを指定。※3，※4

┣
┃
┃
<business-remote>
0回以上
リモートビジネスインタフェースを指定。※3，※4

┣
┃
┃
┃
┃
┃
┃
<session-type>
1回
Session Beanの種別。※3，※4
指定できる文字列を次に示します。

Stateful

Stateless

┣
┃
<around-invoke>
0回以上
around-invokeメソッドの定義。※3，※4

┃
┃
┃
┃
┣
┃
┃
┃
<class>
0または1回
aroundinvokeメソッドが存在するクラスをパッケージ名から表示。※3，※4

┃
┃
┗
<method-name>
1回
around-invokeメソッドの名称。※3，※4

┣
┃
┃
┃
<post-construct>
0回以上
post-constructメソッドの設定。※3，※4

┃
┃
┃
┃
┣
┃
┃
┃
<lifecycle-callback-class>
0または1回
post-constructメソッドが存在するクラスをパッケージ名から表示。※3，※4

┃
┃
┃
┗
<lifecycle-callback-method>
1回
post-constructメソッド名を表示。※3，※4

┣
┃
┃
<pre-destroy>
0回以上
pre-destroyメソッドの設定。※3，※4

┃
┃
┃
┃
┣
┃
┃
┃
<lifecycle-callback-class>
0または1回
pre-destroyメソッドが存在するクラスをパッケージ名から表示。※3，※4

┃
┃
┗
<lifecycle-callback-method>
1回
pre-destroyメソッド名を表示。※3，※4

┣
┃
┃
┃
<post-activate>
0回以上
post-activateメソッドの設定。※3，※4
session-typeがStatefulの場合だけ表示されます。

┃
┃
┃
┃
┣
┃
┃
┃
<lifecycle-callback-class>
0または1回
post-activateメソッドが存在するクラスをパッケージ名から表示。※3，※4

┃
┃
┃
┗
<lifecycle-callback-method>
1回
post-activateメソッド名を表示。※3，※4

┣
┃
┃
┃
┃
<pre-passivate>
0回以上
pre-passivateメソッドの設定。※3，※4
session-typeがStatefulの場合だけ表示されます。

┃
┃
┃
┣
┃
┃
<lifecycle-callback-class>
0または1回
pre-passivateメソッドが存在するクラスをパッケージ名から表示。※3，※4

┃
┃
┃
┗
<lifecycle-callback-method>
1回
pre-passivateメソッド名を表示。※3，※4

┣
┃
┃
<timeout-method>
0または1回
timeoutメソッドの設定。※3，※4
session-typeがStatefulの場合だけ表示されます。

┃
┃
┣
┃
<method-name>
1回
timeoutメソッドの名称。※3，※4

┃
┃
┃
┗
<method-params>
0または1回
timeoutメソッドの引数。※3，※4

┃
┃

┗
<method-param>
0回以上
timeoutメソッドの引数。※3，※4

┣
┃
┃
<init-method>
0回以上
initメソッドの設定。※3，※4
session-typeがStatefulの場合だけ表示されます。

┃
┃
┣
┃
<create-method>
1回
createメソッドの設定。※3，※4

┃
┃
┃
┃
┣
┃
<method-name>
1回
createメソッドの名称。※3，※4

┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
createメソッドの引数。※3，※4

┃
┃
┃
┃

┗
<method-param>
0回以上
createメソッドの引数。※3，※4

┃
┃
┗
<bean-method>
1回
beanメソッドの設定。※3，※4

┃
┃

┣
┃
<method-name>
1回
beanメソッドの名称。※3，※4

┃
┃
┃

┗
<method-params>
0または1回
beanメソッドの引数。※3，※4

┃
┃

┗
<method-param>
0回以上
beanメソッドの引数。※3，※4

┣
┃
┃
<remove-method>
0回以上
removeメソッドの設定。※3，※4
session-typeがStatefulの場合だけ表示されます。

┃
┃
┣
┃
<bean-method>
1回
beanメソッドの設定。※3，※4

┃
┃
┃
┃
┣
┃
<method-name>
1回
beanメソッドの名称。※3，※4

┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
beanメソッドの引数。※3，※4

┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
beanメソッドの引数。※3，※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<retain-if-exception>
1回
アプリケーション例外で異常終了した場合に除去されるかどうか。※3，※4
表示される文字列を次に示します。

true（除去されない）

false（除去される）

┣
┃
┃
┃
┃
┃
┃
<transaction-type>
1回
トランザクション管理種別。※4
指定できる文字列を次に示します。

Bean

Container

┣
┃
<env-entry>
0回以上
環境エントリについての定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
env-entryの説明。※4

┃
┃
┣
┃
<env-entry-name>
1回
環境エントリの名称。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<env-entry-type>
1回
環境エントリのデータ型。※4
指定できる文字列を次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

java.lang.Character

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<env-entry-value>
1回
環境エントリの値。※4
env-entry-typeで指定した型に適合した値を指定します。env-entry-typeにjava.lang.String以外を指定した場合，空文字は指定できません。

┃
┃
┗
<injection-target>
0回以上
Dependency Injectionの設定。※3，※4

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<injection-target-class>
1回
injectionの対象となるクラスの名称。※3，※4
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃

┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※3，※4

┣
┃
┃
┃
<ejb-ref>
0回以上
リモートインタフェースを持つEnterprise Beanへの参照情報についての定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
ejb-refの説明。※4

┃
┃
┣
┃
<ejb-ref-name>
1回
ejb-refの名称。※4

┃
┃
┃
┃┃┃
┣
┃
┃
┃
┃
┃
<ejb-ref-type>
1回
リンク先EJBの種別。※4
指定できる文字列を次に示します。

Entity

Session

┃
┃
┣
┃
<home>
1回
リンク先のホームインタフェースクラスの名称。※4

┃
┃
┣
┃
<remote>
1回
リンク先のコンポーネントインタフェースクラスの名称。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<ejb-link>
0または1回
リンク先のejb-name。※4
ネーミングの切り替え機能でリンク先を設定する場合，次の形式で指定します。

corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBHomeオブジェクトリファレンスのJNDI名>

┃
┃
┗
<injection-target>
0回以上
Dependency Injectionの設定。※3，※4

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<injection-target-class>
1回
injectionの対象となるクラスの名称。※3，※4
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃

┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※3，※4

┣
┃
<ejb-local-ref>
0回以上
EJB参照情報の設定。※4

┃┃
┃
┣
┃
┃
<description>※1
0回以上※2
ejb-local-refの説明。※4

┃┃
┣
┃
<ejb-ref-name>
1回
ejb-local-refの名称。※4

┃┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<ejb-ref-type>
1回
リンク先EJBの種別。※4
指定できる文字列を次に示します。

Session

Entity

┃
┃
┣
┃
<local-home>
1回
リンク先のホームインタフェースクラスの名称。※4

┃
┃
┣
┃
<local>
1回
リンク先のコンポーネントインタフェースクラスの名称。※4

┃
┃
┃
┣
┃
┃
<ejb-link>
0または1回
リンク先のejb-name。※4

┃
┃
┗
<injection-target>
0回以上
Dependency Injectionの設定。※3，※4

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<injection-target-class>
1回
injectionの対象となるクラスの名称。※3，※4
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃

┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※3，※4

┣
┃
┃
<security-role-ref>
0回以上
セキュリティロールについての定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
security-role-refの説明。※4

┃
┃
┣
┃
<role-name>
1回
security-role-refの名称。※4

┃
┃
┃
┃
┗
<role-link>
0または1回
リンク先のセキュリティロール名。※4

┣
┃
┃
┃
<security-identity>
0または1回
セキュリティアイデンティティについての定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
security-identityの説明。※4

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<use-caller-identity>
1回
実行時security-identityを使用するかどうかの指定。※4
<use-caller-identity>と<run-as>のどちらか一つを指定します。なお，このタグは値を持ちません。

┃
┃
┃
┃
┗
<run-as>
1回
実行時security-identityの定義情報。※4
<use-caller-identity>と<run-as>のどちらか一つを指定します。

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<description>※1
0回以上※2
実行時security-identityの説明。※4
<run-as>を指定した場合だけ活性状態になります。

┃
┃
┃
┃

┣
┃
┃
┃
<role-name>
1回
実行時security-identityのroleの名称。※4
<run-as>を指定した場合だけ活性状態になります。

┃
┃

┗
<user-name>
1回
プリンシパル名。※5

┣
┃
┃
┃
<resource-ref>
0回以上
リソース参照についての定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
resource-refの説明。※4

┃
┃
┣
┃
<res-ref-name>
1回
resource-refの名称。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<res-type>
1回
リソース種別。※4
参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子(<connectionfactory-interface>タグの設定値)を指定します。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<res-auth>
1回
認証方式。※4
指定できる文字列を次に示します。

Application

Container

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃┃
┃
┃
┃
<res-sharing-scope>
0または1回
参照したリソースを共有するかどうかの指定。※4
指定できる文字列を次に示します。

Shareable

Unshareable

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<mapped-name>
0または1回
@ResourceのmappedName属性に設定されている，対応するリソースアダプタ表示名またはメール表示名。※3，※4
<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃
┃
┃
┃
┣
┃
┃
┃
<injection-target>
0回以上
Dependency Injectionの設定。※3，※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<injection-target-class>
1回
injectionの対象となるクラスの名称。※3，※4
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃
┃
┃
┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※3，※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
対応するリソースアダプタ表示名，データソース表示名，またはメール表示名。※5
リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

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

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプールのメンバリソースアダプタは指定できません。
cjsetrespropでは無視されます。

┣
┃
┃
┃
<resource-env-ref>
0回以上
リソース環境変数についての定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
resource-env-refの説明。※4

┃
┃
┣
┃
<resource-env-ref-name>
1回
resource-env-refの名称。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<resource-env-ref-type>
1回
リソース環境変数の値のクラスタイプを指定します。※4
指定できる文字列を次に示します。

javax.jms.Queue

javax.jms.Topic

javax.transaction.UserTransaction

javax.ejb.TimerService

javax.ejb.EJBContext

javax.ejb.SessionContext

JavaBeansリソースのクラスの名称

javax.transaction.UserTransaction，javax.ejb.TimerService，javax.ejb.EJBContext，javax.ejb.SessionContextの値は，アノテーションを使用した場合にだけ出力されます。ただし，この値を設定することはできません。
<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<mapped-name>
0または1回
<resource-env-ref-type>が「javax.jms.Queue」の場合，@ResourceのmappedName属性に設定されている，対応するキューを次の形式で表示します。
"<リソースアダプタの表示名>#<Queue名称>"
<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。
<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，@ResourceのmappedName属性に設定されている，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。※3，※4

┃
┃
┃
┃
┣
┃
┃
┃
<injection-target>
0回以上
Dependency Injectionの設定。※3，※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃┃
┃
<injection-target-class>
1回
injectionの対象となるクラスの名称。※3，※4
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃
┃
┃
┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※3，※4

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<linked-queue>
0または1回
queue名称。※5
cjsetrespropでは無視されます。
<resource-env-ref-type>が「javax.jms.Queue」の場合だけ有効となります。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<resource-adapter>
1回
リソースアダプタの表示名を指定します。※5
Connector1.5のリソースアダプタは指定できません。

┃
┃
┃
┃
┗
<queue>
1回
キューの表示名を指定します。※5

┃
┃
┃
┣
┃
┃
<linked-adminobject>
0または1回
管理対象オブジェクト。
cjsetrespropでは無視されます。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<resourceadapter-name>
1回
リソースアダプタの表示名を指定します。
Connector1.0以前のリソースアダプタは指定できません。

┃
┃
┃
┃
┃
┃
┗
<adminobject-name>
1回
管理対象オブジェクト名を指定します。

┃
┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
JavaBeansリソースの表示名。※5
<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合だけ有効となります。
cjsetrespropでは無視されます。

┣
┃
┃
┃
<method-permission>
0回以上
メソッドパーミッションについての定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
method-permissionの説明。※4

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<role-name>
1回以上
メソッドに割り当てるロール名。※4
<role-name>と<unchecked>のどちらか一つを指定します。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<unchecked>
1回
メソッド実行時の認証チェック。※4
このタグを使用する場合，認証チェックはしません。
なお，このタグは値を持ちません。
<role-name>と<unchecked>のどちらか一つを指定します。

┃
┃
┃
┗
<method>
1回以上
メソッドについての定義。※4

┃
┃
┃

┣
┃
┃
<description>※1
0回以上※2
メソッドの説明。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。※4
指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<method-name>
1回
メソッド名。※4
*を指定した場合，すべてのメソッドを表します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-params>
0または1回
method-nameが*以外の場合に有効。※4

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
パラメタのデータ型。※4
プリミティブ型またはクラスの名称を指定します。
配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにします）。
多次元配列の場合は[]を続けて指定します（]と[の間を空けてはいけません）。
配列の内部形式名（int[]の場合は[I，java.lang.String[]の場合は[Ljava.lang.String;）は指定できません。
例

int

short[][]

java.lang.String[]

┣
┃
┃
┃
<container-transaction>
0回以上
コンテナのトランザクションについての定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
container-transactionの説明。※4

┃
┃
┃
┣
┃
┃
<method>
1回以上
メソッドについての定義。※4

┃
┃
┃
┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
メソッドの説明。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。※4
指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┃
┃
┃
┣
┃
┃
<method-name>
1回
メソッド名。※4※7
*を指定した場合，すべてのメソッドを表します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
method-nameが*以外の場合に有効。※4

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
パラメタのデータ型。※4
プリミティブ型またはクラスの名称を指定します。
配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにします）。
多次元配列の場合は[]を続けて指定します（]と[の間を空けてはいけません）。
配列の内部形式名（int[]の場合は[I，java.lang.String[]の場合は[Ljava.lang.String;）は指定できません。
例

int

short[][]

java.lang.String[]

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<trans-attribute>
1回
メソッドに割り当てるトランザクション属性。※4
指定できる文字列を次に示します。

Mandatory

Never

NotSupported

Required

RequiresNew

Supports

┣
┃
┃
┃
┃
┃
<exclude-list>
0または1回
呼び出しをしないメソッドのリストの定義。※4

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
exclude-listの説明。※4

┃
┃
┃
┃
┗
<method>
1回以上
呼び出しをしないメソッド。※4

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<description>※1
0回以上※2
呼び出しをしないメソッドの説明。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。※4
指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃

┣
┃
<method-name>
1回
呼び出しを行わないメソッド名。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-params>
0または1回
method-nameが*以外の場合に有効。※4

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
パラメタのデータ型。※4
プリミティブ型またはクラスの名称を指定します。
配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにします）。
多次元配列の場合は[]を続けて指定します（]と[の間を空けてはいけません）。
配列の内部形式名（int[]の場合は[I，java.lang.String[]の場合は[Ljava.lang.String;）は指定できません。
例

int

short[][]

java.lang.String[]

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<runtime>※5
0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<lookup-name>
1回
クライアントからEJBをルックアップする場合に使う名前。※5
HITACHI_EJB/SERVERS/<サーバ名称>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。
ルックアップ名には，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）が使用できます。ただし，次に示す名前は指定できません。

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

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

文字列の前後に空白，改行がある場合はエラーにならないで，取り除かれて設定されます。また，文字列の途中に空白，改行がある場合はエラーとなります。
1≦文字列長≦255

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<optional-name>
0または1回
リモートインタフェースの別名。※5
設定値は，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）および階層区切り文字としてスラッシュ（/）を使用できます。ただし，次の名前は指定できません。

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

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

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

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

また，文字列の前後に空白，改行がある場合は，エラーとならないで，取り除かれて設定されます。文字列の途中に空白，改行がある場合はエラーとなります。
1≦文字列長≦255

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<local-optional-name>
0または1回
ローカルインターフェースの別名。
設定値は，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）および階層区切り文字としてスラッシュ（/）を使用できます。ただし，次の名前は指定できません。

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

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

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

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

また，文字列の前後に空白，改行がある場合は，エラーとならないで，取り除かれて設定されます。文字列の途中に空白，改行がある場合はエラーとなります。
1≦文字列長≦255

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<maximum-sessions>
1回
セッションの最大数。※5
0（無制限）または1≦maximum-sessions≦2147483647
Stateless Session Beanの場合，この設定値は無効です。

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<stateless>※6
1回
session-typeがStatelessの場合の指定。※5
<stateless>と<stateful>のどちらか一つを指定します。

┃
┃
┃
┃
┣
┃
<pooled-instance>
1回
プール内のインスタンスについての定義。※5

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<minimum>
1回
プール内のインスタンスの最小数。※5
0または1≦minimum≦maximum
maximumに上限を指定した場合，minimumにも上限を指定しなければいけません。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<maximum>
1回
プール内のインスタンスの最大数。※5
0（無制限）または1≦maximum≦maximum-sessions
maximum-sessionsに上限を指定した場合，maximumにも上限を指定しなければいけません。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<instance-timeout>
0または1回
インスタンス取得タイムアウト時間を，0～86400（単位：秒）で指定します。※5
0を指定した場合，タイムアウトしません。デフォルト値は0です。

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<stateful>※6
1回
session-typeがStatefulの場合の指定。※5
<stateless>と<stateful>のどちらか一つを指定します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<maximum-active-sessions>
1回
アクティブセッションの最大数。※5
0（無制限）または1≦maximum-active-sessions≦maximum-sessions
maximum-sessionsに上限を指定した場合，maximum-active-sessionsにも上限を指定しなければいけません。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<inactivity-timeout>
1回
再びアクティブ化するまでに非アクティブ状態に保持しておく時間（分）。※5
0（無制限）または1≦inactivity-timeout≦2147483647

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<removal-timeout>
1回
セッションが削除されるまでに非アクティブ状態に保持しておく時間（分）。※5
0（無制限）または1≦removal-timeout≦2147483647

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<enable-scheduling>
0または1回
該当するBeanをスケジューリングの対象にするかどうか（スケジューラのGateとして使用するかどうか）の指定。※5
CTM経由で呼び出されるBeanで，statelessのMaximumの値がparallel-countの値より小さい場合エラーとなります。
なお，このタグは構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけ有効です。それ以外の場合に指定するとエラーになります。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。
また，リモートコンポーネントインタフェースを提供しないEJB（コンポーネントローカルインタフェースまたはビジネスインタフェースで提供）に対しては指定できません。指定した場合は無視されます。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<pass-by-reference>
0または1回
Bean単位でのデータの参照渡し（pass by reference）を指定します。※5

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<scheduling>
0または1回
CTM連携関連の情報。※5
Bean単位にスケジューラを配置する場合に必要です。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<queue-name>
1回
スケジューリングを行うqueue名称。※5
英数字（0～9，A～Z，a～z）およびアンダースコア（_）が使用できます。デフォルト値は，ejb名（<ejb-name>タグの値）です。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<parallel-count>
1回
CTMがアプリケーションを呼び出すために用意するスレッド数を，1～127の範囲で指定します。※5デフォルトは，1です。
CTM経由で呼び出されるBeanで，Maximumの値がparallel-countの値より小さい場合エラーとなります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<queue-length>
0または1回
スケジューリングをするキューの長さを，1～32767の整数値で指定します。※5
キューを共有する場合，キューを共有するアプリケーション間やBean間で設定値が異なるとき，すでに生成されているキューの長さが有効になります。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<front-ejb>
0または1回
フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。※5フロントEJBの場合はtrueを指定し，フロントEJBでない場合はfalseを指定します。デフォルト値はfalse。

┣
┃
┃
┃
┃
┃
<start-order>
0または1回
J2EEアプリケーション開始時・停止時の順番を指定します。※5開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。
0≦start-order≦2147483647

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

┃
┃
┣
┃
<method>
1回以上
－※5

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<description>
0または1回
メソッドの説明。※5

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別を特定する場合に指定します。※5
次の値が指定できます。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┃
┃
┃
┃┃
┣
┃
┃
┃
<method-name>
1回
対象となるメソッド名を指定します。※5※7
*を指定した場合は，すべてのメソッドを表します。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
メソッドが多重定義されている場合，メソッドを特定するために指定します。※5

┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
引数のデータ型を指定。※5

┃
┃
┃
┃
┃
┃
┗
<method-observation-timeout>
1回
仕掛かり中メソッド監視用タイムアウト時間を，0～86400（単位：秒）で指定します。※50を指定した場合，タイムアウトしません。デフォルト値は0。

┗
<ejb-transaction-timeout>
0回以上
EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。※5
<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効になります。

┣
┃
<method>
1回以上
－※5

┃
┃
┃
┃
┣
┃
┃
┃
<description>
0または1回
メソッドの説明。※5

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別を特定する場合に指定します。※5
次の値が指定できます。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┃
┣
┃
┃
┃
<method-name>
1回
対象となるメソッド名を指定します。※5※7
*を指定した場合は，すべてのメソッドを表します。

┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
メソッドが多重定義されている場合，メソッドを特定するために指定します。※5

┃
┃
┃
┃

┗
<method-param>
0回以上
引数のデータ型を指定。※5

┗
<transaction-timeout>
1回
トランザクションタイムアウト時間を，0～2147483647（単位：秒）で指定します。※5デフォルト値は0。0を指定した場合，またはタグがない場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※4

アノテーションの設定値の場合は，値の変更をしてはいけません。

注※5

設定先のSession Beanを含むEJB-JARがDD（ejb-jar.xml）を保持していない場合でも，変更できます。

注※6

statelessまたはstatefulのどちらかを指定します。

注※7

J2EEサーバ用のusrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleに「false」を指定している場合にこのタグで指定されたメソッドが存在しないとき，属性の設定でエラーになります。usrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleキーについては，「4.4　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）」を参照してください。

5.5.2　DDとの対応

Session Bean属性ファイルとDeployment Descriptorの対応を次に示します。

Session Bean属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-session-bean-property>
1回
<ejb-jar>
1回

┃
┃
－
－
┣
┃
<description>
0または1回

┃
┃
－
－
┣
┃
<display-name>
0または1回

┃
┃
－
－
┣
┃
<icon>
0回以上

┃
┃
－
－
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
－
－
┃
┃
┗
<large-icon>
0または1回

┃
┃
－
－
┣
┃
<enterprise-beans>
1回

┃
┃
－
－
┃
┃
┣
┃
<session>
1回以上

┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┣
┃
<display-name>
1回以上
┃
┃
┃
┃
┣
┃
<display-name>
0回以上

┣
┃
<icon>
0回以上
┃
┃
┃
┃
┣
┃
<icon>
0回以上

┃
┃
┣
┃
<small-icon>
0または1回
┃
┃
┃
┃
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回
┃
┃
┃
┃
┃
┃
┗
<large-icon>
0または1回

┃
┃
－
－
┃
┃
┃
┃
┣
┃
<ejb-name>
1回

┣
┃
<mapped-name>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
－
－
┃
┃
┃
┃
┣
┃
<home>
0または1回

┃
┃
－
－
┃
┃
┃
┃
┣
┃
<remote>
0または1回

┣
┃
<business-local>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<business-remote>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
－
－
┃
┃
┃
┃
┣
┃
<ejb-class>
1回

┣
┃
<session-type>
1回
┃
┃
┃
┃
┣
┃
<session-type>
0または1回

┣
┃
<around-invoke>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<class>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<method-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<post-construct>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<lifecycle-callback-class>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<lifecycle-callback-method>
1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<pre-destroy>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<lifecycle-callback-class>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<lifecycle-callback-method>
1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<post-activate>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<lifecycle-callback-class>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<lifecycle-callback-method>
1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<pre-passivate>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<lifecycle-callback-class>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<lifecycle-callback-method>
1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<timeout-method>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<method-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<method-params>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┗
<method-param>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<init-method>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<create-method>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<method-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┗
<method-params>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃

┗
<method-param>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<bean-method>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┣
┃
<method-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┗
<method-params>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┗
<method-param>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<remove-method>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<bean-method>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<method-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┗
<method-params>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃

┗
<method-param>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<retain-if-exception>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<transaction-type>
1回
┃
┃
┃
┃
┣
┃
<transaction-type>
1回

┣
┃
<env-entry>
0回以上
┃
┃
┃
┃
┣
┃
<env-entry>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<env-entry-name>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<env-entry-name>
1回

┃
┃
┣
┃
<env-entry-type>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<env-entry-type>
1回

┃
┃
┣
┃
<env-entry-value>
1回
┃
┃
┃
┃
┃
┃
┗
<env-entry-value>
0または1回

┃
┃
┗
<injection-target>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┣
┃
<injection-target-class>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┗
<injection-target-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<ejb-ref>
0回以上
┃
┃
┃
┃
┣
┃
<ejb-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-ref-name>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<home>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<home>
1回

┃
┃
┣
┃
<remote>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<remote>
1回

┃
┃
┣
┃
<ejb-link>
0または1回
┃
┃
┃
┃
┃
┃
┗
<ejb-link>
0または1回

┃
┃
┗
<injection-target>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┣
┃
<injection-target-class>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┗
<injection-target-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<ejb-local-ref>
0回以上
┃
┃
┃
┃
┣
┃
<ejb-local-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-ref-name>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<local-home>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<local-home>
1回

┃
┃
┣
┃
<local>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<local>
1回

┃
┃
┣
┃
<ejb-link>
0または1回
┃
┃
┃
┃
┃
┃
┗
<ejb-link>
0または1回

┃
┃
┗
<injection-target>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┣
┃
<injection-target-class>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃

┗
<injection-target-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<security-role-ref>
0回以上
┃
┃
┃
┃
┣
┃
<security-role-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<role-name>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<role-name>
1回

┃
┃
┗
<role-link>
0または1回
┃
┃
┃
┃
┃
┃
┗
<role-link>
0または1回

┣
┃
<security-identity>
0または1回
┃
┃
┃
┃
┣
┃
<security-identity>
0または1回

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<use-caller-identity>
1回※1
┃
┃
┃
┃
┃
┃
┣
┃
<use-caller-identity>
1回※1

┃
┃
┗
<run-as>
1回※1
┃
┃
┃
┃
┃
┃
┗
<run-as>
1回※1

┃
┃

┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<role-name>
1回
┃
┃
┃
┃
┃
┃

┗
<role-name>
1回

┃
┃

┗
<user-name>
1回
┃
┃
┃
┃
┃
┃

－
－

┣
┃
<resource-ref>
0回以上
┃
┃
┃
┃
┣
┃
<resource-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<res-ref-name>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<res-ref-name>
1回

┃
┃
┣
┃
<res-type>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<res-type>
1回

┃
┃
┣
┃
<res-auth>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<res-auth>
1回

┃
┃
┣
┃
<res-sharing-scope>
0または1回
┃
┃
┃
┃
┃
┃
┗
<res-sharing-scope>
0または1回

┃
┃
┣
┃
<mapped-name>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<injection-target>
0回以上
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<injection-target-class>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┗
<injection-target-name>
1回
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<linked-to>
0または1回
┃
┃
┃
┃
┃
┃
－
－

┣
┃
<resource-env-ref>
0回以上
┃
┃
┃
┃
┗
<resource-env-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃

┣
┃
<description>
0回以上

┃
┃
┣
┃
<resource-env-ref-name>
1回
┃
┃
┃
┃

┣
┃
<resource-env-ref-name>
1回

┃
┃
┣
┃
<resource-env-ref-type>
1回
┃
┃
┃
┃

┗
<resource-env-ref-type>
1回

┃
┃
┣
┃
<mapped-name>
0または1回
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<injection-target>
0回以上
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<injection-target-class>
1回
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┗
<injection-target-name>
1回
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<linked-queue>
0または1回
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<resource-adapter>
1回
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┗
<queue>
1回
┃
┃
┃
┃
－
－

┃
┃
┗
<linked-adminobject>
0または1回
┃
┃
┃
┃
－
－

┃
┃

┣
┃
<resourceadapter-name>
1回
┃
┃
┃
┃
－
－

┃
┃

┗
<adminobject-name>
1回
┃
┃
┃
┃
－
－

┃
┃
┃
(省略)
－
┃
┃
┃

(省略)
－

┃
┃
－
－
┣
┃
<assembly-descriptor>
0または1回

┃
┃
－
－
┃
┃
┣
┃
<security-role>
0回以上

┃
┃
－
－
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
－
－
┃
┃
┃
┃
┗
<role-name>
1回

┣
┃
<method-permission>
0回以上
┃
┃
┣
┃
<method-permission>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<role-name>※2
1回以上
┃
┃
┃
┃
┣
┃
<role-name>※2
1回以上

┃
┃
┣
┃
<unchecked>※2
1回
┃
┃
┃
┃
┣
┃
<unchecked>※2
1回

┃
┃
┗
<method>
1回以上
┃
┃
┃
┃
┗
<method>
1回以上

┃
┃

┣
┃
<description>
0回以上
┃
┃
┃
┃

┣
┃
<description>
0回以上

┃
┃

┃
┃
－
－
┃
┃
┃
┃

┣
┃
<ejb-name>
1回

┃
┃

┣
┃
<method-intf>
0または1回
┃
┃
┃
┃

┣
┃
<method-intf>
0または1回

┃
┃

┣
┃
<method-name>
1回
┃
┃
┃
┃

┣
┃
<method-name>
1回

┃
┃

┗
<method-params>
0または1回
┃
┃
┃
┃

┗
<method-params>
0または1回

┃
┃

┗
<method-param>
0回以上
┃
┃
┃
┃

┗
<method-param>
0回以上

┃
┃
<container-transaction>
0回以上
┃
┃
┣
┃
<container-transaction>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<method>
1回以上
┃
┃
┃
┃
┣
┃
<method>
1回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┃
┃
－
－
┃
┃
┃
┃
┃
┃
┣
┃
<ejb-name>
1回

┃
┃
┃
┃
┣
┃
<method-intf>
0または1回
┃
┃
┃
┃
┃
┃
┣
┃
<method-intf>
0または1回

┃
┃
┃
┃
┣
┃
<method-name>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<method-name>
1回

┃
┃
┃
┃
┗
<method-params>
0または1回
┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回

┃
┃
┃
┃

┗
<method-param>
0回以上
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上

┃
┃
┗
<trans-attribute>
1回
┃
┃
┃
┃
┗
<trans-attribute>
1回

┣
┃
<exclude-list>
0または1回
┃
┃
┗
<exclude-list>
0または1回

┃
┃
┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃
┗
<method>
1回以上
┃
┃

┗
<method>
1回以上

┃
┃

┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃

┃
┃
－
－
┃
┃

┣
┃
<ejb-name>
1回

┃
┃

┣
┃
<method-intf>
0または1回
┃
┃

┣
┃
<method-intf>
0または1回

┃
┃

┣
┃
<method-name>
1回
┃
┃

┣
┃
<method-name>
1回

┃
┃

┗
<method-params>
0または1回
┃
┃

┗
<method-params>
0または1回

┃
┃

┗
<method-param>
0回以上
┃
┃

┗
<method-param>
0回以上

┃
┃
－
－
┗
<ejb-client-jar>
0または1回

┗
<runtime>
0または1回
－
－

(省略)
－
－
－

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<use-caller-identity>と<run-as>のどちらか一つを指定します。

注※2

<role-name>と<unchecked>のどちらか一つを指定します。

5.6　Entity Bean属性ファイル

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

＜この節の構成＞

5.6.1　Entity Bean属性ファイルの指定内容

5.6.2　DDとの対応

5.6.1　Entity Bean属性ファイルの指定内容

Entity Bean属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-entity-bean-property PUBLIC '-//Hitachi, Ltd.//DTD Entity Bean Property 7.6//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-entity-bean-property_7_6.dtd'>

Entity Bean属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-entity-bean-property>
1回
ルートタグ。

┣
┃
┃
┃
<description>※1
0回以上※2
Entity Beanの説明。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<display-name>※1
1回以上※2
Entity Beanの表示名。
xml:lang属性が"en"のdisplay-nameを必ず指定します。当該リソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。
1≦文字列長
xml:lang属性が"en"のタグの場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。
xml:lang属性が"en"のタグ以外の場合，文字の制限はありません。

┣
┃
┃
┃
<icon>※1
0回以上※2
GUIツール上に表示されるEntity Beanのアイコンの定義。

┃
┃
┃
┃
┣
┃
┃
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。

┃
┃
┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。

┣
┃
┃
┃
┃
┃
┃
<persistence-type>
1回
永続性管理種別。※3
指定できる文字列を次に示します。

Bean

Container

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<prim-key-class>
1回
プライマリキークラス。
単一プライマリキー，複合プライマリキーとして指定できるクラス・インタフェース，プリミティブ型を指定できます。
永続性管理種別が「Bean」の場合は，具象クラス，抽象クラスおよびインタフェースが指定できます。
永続性管理種別が「Container」の場合は，具象クラスだけが指定できます。
単一プライマリキーとして扱われるクラスを次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Character

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

複合プライマリキーとして扱われるクラスとインタフェースを次に示します。
クラスの場合

java.lang.Object

java.io.Serializableを実装し，boolean equals(Object obj)とint hashCode()をオーバーライドしたクラス（親クラスがjava.io.Serializableを実装していても可）

インタフェースの場合
java.io.Serializableを実装し，boolean equals(Object obj)とint hashCode()をオーバーライドしたクラス（親クラスがjava.io.Serializableを実装していても可）に実装されるインタフェース。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<reentrant>
1回
同一トランザクション内での再帰呼び出しの可否。
指定できる値を次に示します。

true

可

false

不可

┣
┃
┃
┃
<abstract-schema-name>
0または1回
EntityBeanの抽象スキーマ名。
スキーマ名が複数の場合は，それぞれ一意な値にしてください。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<cmp-field>
0回以上

persistence-typeにContainerを指定した場合

必須

persistence-typeにBeanを指定した場合

cjsetappprop，cjsetrespropで無視されます。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
cmp-fieldの説明。

┃
┃
┗
<field-name>
1回
永続性管理をするBeanのフィールド名。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<primkey-field>
0または1回
プライマリキーとなるEntity Beanのフィールド名を指定します。
persistence-typeにContainerが指定されていて，かつprim-key-classに単一プライマリキーとなるクラスが指定された場合は必須。それ以外の場合はcjsetappprop，cjsetrespropで無視されます。
指定できる値はcmp-fieldのfield-nameに指定されている文字列。
primkey-fieldに指定したフィールドのデータ型はprim-key-classの文字列と一致していなければいけません。

┣
┃
┃
<env-entry>
0回以上
環境エントリについての定義。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
環境エントリの説明。

┃
┣
<env-entry-name>
1回
環境エントリの名称。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<env-entry-type>
1回
環境エントリのデータ型。
指定できる文字列を次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

java.lang.Character

┃
┃
┃
┃
┃
┃
┗
<env-entry-value>
1回
環境エントリの値。
env-entry-typeで指定した型に適合した値を指定します。
env-entry-typeにjava.lang.String以外を指定した場合，空文字の指定はできません。

┣
┃
┃
<ejb-ref>
0回以上
リモートインタフェースを持つEnterprise Beanへの参照情報についての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
ejb-refの説明。

┃
┃
┣
┃
<ejb-ref-name>
1回
ejb-refの名称。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<ejb-ref-type>
1回
リンク先のEnterprise Beanの種別。
指定できる文字列を次に示します。

Entity

Session

┃
┃
┣
┃
<home>
1回
リンク先のEnterprise BeanのRemote Homeインタフェース名。

┃
┃
┃
┣
┃
┃
<remote>
1回
リンク先のEnterprise BeanのRemote Componentインタフェース名。

┃
┃
┃
┃
┗
<ejb-link>
0または1回
リンク先のejb-name。

┣
┃
┃
<ejb-local-ref>
0回以上
ローカルインタフェースを持つEnterprise Beanへの参照情報についての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
ejb-local-refの説明。

┃
┣
<ejb-ref-name>
1回
ejb-local-refの名称。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<ejb-ref-type>
1回
リンク先のEnterprise Beanの種別。
指定できる文字列を次に示します。

Session

Entity

┃
┃
┣
┃
<local-home>
1回
リンク先のEnterprise BeanのLocal Homeインタフェース名。

┃
┃
┣
┃
<local>
1回
リンク先のEnterprise BeanのLocal Componentインタフェース名。

┃
┃
┃
┃
┗
<ejb-link>
0または1回
リンク先のejb-name。

┣
┃
┃
<security-role-ref>
0回以上
セキュリティロールについての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
security-role-refの説明。

┃
┃
┣
┃
<role-name>
1回
security-role-refの名称。

┃
┃
┃
┃
┗
<role-link>
0または1回
リンク先のロール名。

┣
┃
┃
┃
<security-identity>
0または1回
セキュリティアイデンティティについての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
security-identityの説明。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<use-caller-identity>
1回
実行時security-identityを使用するかどうかの指定。なお，このタグは値を持ちません。
<use-caller-identity>と<run-as>のどちらか一つを指定します。

┃
┃
┃
┗
<run-as>
1回
実行時security-identityの定義情報。
<use-caller-identity>と<run-as>のどちらか一つを指定します。

┃
┃
┃
┃

┣
┃
┃
┃
<description>※1
0回以上※2
実行時security-identityの説明。

┃
┃

┣
┃
<role-name>
1回
実行時security-identityのroleの名称。

┃
┃
┃
┃

┗
<user-name>
0または1回
プリンシパル名。

┣
┃
┃
<resource-ref>
0回以上
リソースへの参照情報についての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
resource-refの説明。

┃
┣
<res-ref-name>
1回
resource-refの名称。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<res-type>
1回
リソース種別。
参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子(<connectionfactory-interface>タグの設定値)を指定します。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<res-auth>
1回
認証方式。
指定できる文字列を次に示します。

Application

Container

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<res-sharing-scope>
0または1回
参照したリソースを共有するかどうかの指定。
指定できる文字列を次に示します。

Shareable

Unshareable

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<mapped-name>
0または1回
対応するリソースアダプタ表示名，またはメール表示名。※3
<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
対応するリソースアダプタ表示名，データソース表示名，またはメール表示名。
リソースアダプ表示名の指定方法はリソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

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

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプールのメンバリソースアダプタは指定できません。
cjsetrespropでは無視されます。

┣
┃
┃
<resource-env-ref>
0回以上
リソース環境変数への参照情報についての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
resource-env-refの説明。

┃
┃
┣
┃
<resource-env-ref-name>
1回
resource-env-refの名称。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<resource-env-ref-type>
1回
リソース環境変数の値のクラスタイプ。
指定できる文字列を次に示します。

javax.jms.Queue

javax.jms.Topic

JavaBeansリソースのクラス名

<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<mapped-name>
0または1回
<resource-env-ref-type>が「javax.jms.Queue」の場合，対応するキュー※3を次の形式で表示します。
"<リソースアダプタの表示名>#<Queue名称>"
<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。
<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<linked-queue>
0または1回
queue名称。
cjsetrespropでは無視されます。
<resource-env-ref-type>が「javax.jms.Queue」の場合だけ有効となります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<resource-adapter>
1回
リソースアダプタの表示名を指定します。
Connector1.5のリソースアダプタは指定できません。

┃
┃
┗
<queue>
1回
キューの表示名を指定します。

┃
┃
┃
┣
┃
┃
<linked-adminobject>
0または1回
管理対象オブジェクト。
cjsetrespropでは無視されます。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<resourceadapter-name>
1回
リソースアダプタの表示名を指定します。
Connector1.0以前のリソースアダプタは指定できません。

┃
┃
┃
┃
┃
┃
┗
<adminobject-name>
1回
管理対象オブジェクト名を指定します。

┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
JavaBeansリソースの表示名。
<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合だけ有効となります。
cjsetrespropでは無視されます。

┣
┃
┃
<query>
0回以上
EJB QLについての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>
0または1回
queryの説明。

┃
┣
<query-method>
1回
クエリメソッドについての定義。

┃
┃
┃
┃
┣
┃
<method-name>
1回
クエリメソッド（finderまたはselectメソッド）。

┃
┃
┃
┃
┗
<method-params>
1回
クエリメソッドの引数。

┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
finderまたはselectメソッドの引数のJavaタイプ。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<result-type-mapping>
0または1回
selectメソッドでEntityオブジェクトが返される場合のオブジェクトのタイプ。
「Remote」，「Local」のどちらかを指定します。デフォルトはLocalです。

┃
┗
<ejb-ql>
1回
EJB QLのクエリ文。

┣
┃
┃
<method-permission>
0回以上
メソッドパーミッションについての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
method-permissionの説明。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<role-name>
1回以上
メソッドに割り当てるロール名。
<role-name>と<unchecked>のどちらか一つを指定します。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<unchecked>
1回
メソッド実行時の認証チェック。
このタグを使用する場合，認証チェックはしません。メソッドに割り当てるロール名。
<role-name>と<unchecked>のどちらか一つを指定します。
なお，このタグは値を持ちません。

┃
┃
┃
┗
<method>
1回以上
メソッドについての定義。

┃
┃
┃
┃

┣
┃
┃
┃
<description>
0回以上※2
メソッドの説明。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。
指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃

┣
┃
┃
<method-name>
1回
メソッド名。
*を指定した場合，すべてのメソッドを表します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-params>
0または1回
method-nameが*以外の場合に有効。

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
パラメタのデータ型。
プリミティブ型またはクラスの名称を指定します。
配列の場合は名称の後ろに[]を指定します（名称と [ の間，[ と ] の間を空けないようにしてください）。多次元配列の場合は[]を続けて指定します（ ] と [ の間を空けないようにしてください）。配列の内部形式名（int[]の場合[I，java.lang.String[]の場合[Ljava.lang.String;）は指定できません。
例

int

short[][]

java.lang.String[]

┣
┃
┃
<container-transaction>
0回以上
コンテナのトランザクションについての定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
container-transactionの説明。

┃
┃
┃
┣
┃
┃
<method>
1回以上
メソッドについての定義。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
メソッドの説明。

┃
┃┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。
指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┃
┃
┃
┣
┃
┃
<method-name>
1回
メソッド名。
*を指定した場合，すべてのメソッドを表します。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
method-nameが*以外の場合に有効。

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
パラメタのデータ型。
プリミティブ型またはクラスの名称を指定します。
配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにします）。
多次元配列の場合は[]を続けて指定します（]と[の間を空けてはいけません）。
配列の内部形式名（int[]の場合は[I，java.lang.String[]の場合は[Ljava.lang.String;）は指定できません。
例

int

short[][]

java.lang.String[]

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<trans-attribute>
1回
メソッドに割り当てるトランザクション属性。
指定できる文字列を次に示します。

Mandatory

Never

NotSupported

Required

RequiresNew

Supports

┣
┃
┃
┃
<exclude-list>
0または1回
呼び出しをしないメソッドのリストの定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
exclude-listの説明。

┃
┃
┃
┗
<method>
1回以上
呼び出しをしないメソッドの定義。

┃
┃
┃
┃

┣
┃
┃
┃
<description>※1
0回以上※2
呼び出しをしないメソッドの説明。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。
指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┃

┣
┃
┃
┃
<method-name>
0または1回
メソッド名。
*を指定した場合，すべてのメソッドを表します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-params>
0または1回
method-nameが*以外の場合に有効。

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
パラメタのデータ型。
プリミティブ型またはクラスの名称を指定します。
配列の場合は名称の後ろに[]を指定します（名称と [ の間，[ と ] の間を空けないようにしてください）。多次元配列の場合は[]を続けて指定します（ ] と [ の間を空けないようにしてください）。配列の内部形式名（int[]の場合[I，java.lang.String[]の場合[Ljava.lang.String;）は指定できません。
例

int

short[][]

java.lang.String[]

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<runtime>
0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<lookup-name>
1回
クライアントからEJBをルックアップに使う名前。
HITACHI_EJB/SERVERS/<サーバ名称>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。
ルックアップ名には，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）が使用できます。ただし，次に示す名前は指定できません。
・先頭または末尾にピリオド（.）を付けた名前
・ピリオド（.）だけの名前
文字列の前後に空白，改行がある場合はエラーにならないで，取り除かれて設定されます。また，文字列の途中に空白，改行がある場合はエラーとなります。
1≦文字列長≦255

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<optional-name>
0または1回
リモートインタフェースの別名。
設定値には，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）および階層区切り文字としてスラッシュ（/）を使用できます。ただし，次の名前は指定できません。

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

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

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

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

また，文字列の前後に空白，改行がある場合はエラーとならないで，取り除かれて設定されます。文字列の途中に空白，改行がある場合はエラーとなります。
1≦文字列長≦255

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<local-optional-name>
0または1回
ローカルインタフェースの別名。
設定値には，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）および階層区切り文字としてスラッシュ（/）を使用できます。ただし，次の名前は指定できません。

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

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

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

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

また，文字列の前後に空白，改行がある場合はエラーとならないで，取り除かれて設定されます。文字列の途中に空白，改行がある場合はエラーとなります。
1≦文字列長≦255

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<maximum-instances>
1回
Enterprise Beanインスタンスの最大数。
0（無制限）または1≦maximum-instances≦2147483647

┃
┃
┃
┣
┃
┃
<pooled-instance>
1回
インスタンスプールのプロパティ。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<minimum>
1回
プール内のインスタンスの最小数。
0（無制限）または1≦minimum≦maximum
maximumに上限を指定した場合，minimumにも上限を指定しなければいけません。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<maximum>
1回
プール内のインスタンスの最大数。
0（無制限）または1≦maximum≦maximum-instances
maximum-instancesに上限を指定した場合，maximumにも上限を指定しなければいけません。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<caching-model>
1回
データのキャッシュ方法。
次のどれかを指定します。

full-caching

メソッド起動間のすべての状態情報をキャッシュします。

caching

メソッド起動間で最も頻繁に使用された状態情報をキャッシュします。

no-caching

状態情報をキャッシュしません。

┃
┃
┃
┃
┣
┃
┃
┃
<entity-timeout>
0または1回
EJBObjectの存在時間（秒）を指定します。0：タイムアウトなし。1≦設定値≦2147483647

┃
┃
┃
┃
┣
┃
┃
┃
<pass-by-reference>
0または1回
Bean単位でのデータの参照渡し（pass by reference）を指定します。

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<instance-timeout>
0または1回
インスタンス取得タイムアウト時間を，0～86400（単位：秒）で指定します。
0を指定した場合，タイムアウトしません。デフォルト値は0です。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<front-ejb>
0または1回
フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。フロントEJBの場合はtrueを指定し，フロントEJBでない場合はfalseを指定します。デフォルト値はfalse。

┃
┃
┃
┃
┣
┃
┃
┃
<ejb20-cmp>
0または1回
EJB1.1，EJB2.0でのEntityBeanのCMPについて設定します。※3
cjsetapppropでは無視されます。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<sql-statement>
0回以上
メソッドとSQL文を関連づけます。※3
メソッドは「finder」と「ejbSelect」です。

┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
<method>
1回
メソッドについての定義。※3
<method>と<operation>のどちらか一つを指定します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。※3
指定できる文字列を次に示します。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┃
┃
┃

┃
┃
┃
┣
┃
┃
<method-name>
1回
メソッド名。※3
*を指定した場合，すべてのメソッドを表します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
method-nameが*以外の場合に有効。※3

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
パラメタのデータ型。※3
プリミティブ型またはクラスの名称を指定します。
配列の場合は名称の後ろに[]を指定します（名称と [ の間，[ と ] の間を空けないようにしてください）。多次元配列の場合は[]を続けて指定します（ ] と [ の間を空けないようにしてください）。配列の内部形式名（int[]の場合[I，java.lang.String[]の場合[Ljava.lang.String;）は指定できません。
例

int

short[][]

java.lang.String[]

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<operation>
1回
CMPのオペレーション名を指定します。※3
<method>と<operation>のどちらか一つを指定します。

┃
┃

┗
<sql>
1回
SQL文を指定します。※3

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<cmp-map>
0または1回

persistence-typeがBeanの場合

cjsetapppropで無視されます。

persistence-typeがContainerの場合

必須

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<datasource-name>
1回
Enterprise Beanフィールドのマッピング先とするデータソース，または開始されたリソースアダプタの表示名。
リソースアダプ表示名の指定方法はリソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

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

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。
クラスタコネクションプールのメンバリソースアダプタは指定できません。

┃
┃
┃
┃

┣
┃
┃
┃
<catalog-name>
0または1回
Enterprise Beanフィールドのマッピング先とするデータベースのカタログ名。

┃
┃
┃
┃

┣
┃
┃
┃
<schema-name>
0または1回
Enterprise Beanフィールドのマッピング先とするデータベースのスキーマ名。

┃
┃
┃

┣
┃
┃
<table-name>
1回
Enterprise Beanフィールドのマッピング先とするデータベースのテーブル名。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<read-only-access>
1回
アプリケーションからデータベースへの書き込みの許可／禁止。
次のどちらかを指定します。

true

書き込みを禁止します。

false

書き込みを許可します。

┃
┃
┃

┣
┃
┃
<available-transaction-isolations>
1回
指定できるトランザクションについての定義。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<transaction-isolation>
0回以上
指定できるトランザクション遮断レベル。※3
次のどれかが指定されます（cjgetapppropでプロパティファイル生成時にデータベースにアクセスして自動的に生成されます）。

none

トランザクションがサポートされていません。

read committed

ダーティー読み取りが抑制されます。

read uncommitted

ダーティー読み取り，繰り返し不可の読み取り，およびファントム読み取りが起こります。

repeatable_read

ダーティー読み取りおよび繰り返し不可の読み取りが抑制されます。

serializable

ダーティー読み取り，繰り返し不可の読みおよびファントム読み取りが抑制されます。

┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
<transaction-isolation>
0または1回
トランザクション遮断レベル。
available-transaction-isolationsにある中から一つを指定します。
省略した場合，デフォルトのトランザクション遮断レベルが使われます（使用するデータベースおよびJDBCドライバによって異なります）。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<concurrency-protection>
0または1回
データベースに書き込むデータとレコードとの照合方法。
指定できる値を次に示します。

primary-key

プライマリキーと照合してデータを更新します。

modified-data

プライマリキーと照合して変更対象のデータの値が最後の読み出し操作以降に変更されているかどうかをチェックします。

whole-row

プライマリキーと照合して変更対象の値を含む行内のすべての値が最後の読み出し操作以降に変更されているかどうかをチェックします。

read-only-accessがtrueの場合は省略できます。また，値が指定されていても無視します。

┃
┃
┃

┣
┃
┃
<field-impl>
0回以上
Entity Beanのフィールドとテーブルのカラムとのマッピングについての定義。※3

┃
┃

┃
┃
┣
┃
<field-name>
1回
Entity Beanのフィールド名。※3

┃
┃

┃
┃
┗
<column-name>
1回
テーブルのカラム名。

┃
┃
┃
┃

┗
<finder-impl>
0回以上
ejbFindByPrimaryKey以外のFinderメソッドの検索条件。※3

┃
┃

┣
┃
<method-name>
1回
Finderメソッドのメソッド名。※3

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<where-clause>
1回
テーブルの検索条件。

検索条件に指定できる演算子を次に示します。なお，<や>を値に使うことはXMLの構文上許されていないため，テキストエディタで属性ファイルを編集する場合は，表内（）のようにエンティティを使用してください。

IS NULL

NULLです。

IS NOT NULL

NULLではありません。

=

等しい（Finderメソッドのパラメタが1個以上の場合に使用できます）。

!=

等しくない（Finderメソッドのパラメタが1個以上の場合に使用できます）。

< （&lt;）

～より小さい（Finderメソッドのパラメタが1個以上の場合に使用できます）。

> （&gt;）

～より大きい（Finderメソッドのパラメタが1個以上の場合に使用できます）。

<= （&lt;=）

～以下（Finderメソッドのパラメタが1個以上の場合に使用できます）。

>= （&gt;=）

～以上（Finderメソッドのパラメタが1個以上の場合に使用できます）。

LIKE

検索パターンに一致する（Finderメソッドのパラメタが1個以上の場合に使用できます）。

NOT LIKE

検索パターンに一致しない（Finderメソッドのパラメタが1個以上の場合に使用できます）。

BETWEEN

範囲に含まれる（Finderメソッドのパラメタが2個以上の場合に使用できます）。

NOT BETWEEN

範囲に含まれない（Finderメソッドのパラメタが2個以上の場合に使用できます）。

検索条件の構文を次に示します。

IS NULL，IS NOT NULL演算子を使用する場合

フィールド名 演算子

BETWEEN，NOT BETWEEN演算子を使用する場合

フィールド名 演算子 ?番号 AND ?番号

そのほかの演算子を使用する場合

フィールド名 演算子 ?番号

検索条件は，ANDまたはORで接続できます。

検索条件，AND，OR，フィールド名は大文字小文字を区別します。

?番号には，Finderメソッドの引数の場所（左から1,2,...）を指定します。

例

id &lt;= ?1 AND value IS NOT NULL OR name BETWEEN ?3 AND ?4

検索条件，AND，OR，フィールド名，?番号の間は1文字以上の空白を入れてください。

空文字列の場合は，テーブルのすべての行が検索パターンに一致するものとみなします。

DISABLEが指定されている場合はアプリケーションからこのメソッドを使用できません。

┣
┃
┃
┃
┃
┃
<start-order>
0または1回
J2EEアプリケーション開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。
0≦start-order≦2147483647

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

┃
┃
┃
┣
┃
┃
<method>
1回以上
－

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<description>
0または1回
メソッドの説明。このタグは複数指定できません。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別を特定する場合に指定します。
次の値が指定できます。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┃
┃
┃
┣
┃
┃
<method-name>
1回
対象となるメソッド名を指定します。*を指定した場合はすべてのメソッドを表します。※4

┃
┃
┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
メソッドが多重定義されている場合，メソッドを特定するために指定します。

┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
引数のデータ型を指定。

┃
┃
┃
┃┃
┗
<method-observation-timeout>
1回
仕掛かり中メソッド監視用タイムアウト時間を，0～86400（単位：秒）で指定します。0を指定した場合は，タイムアウトしません。デフォルト値は0。

┗
<ejb-transaction-timeout>
0回以上
EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。
<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効になります。

┣
┃
┃
<method>
1回以上
メソッドについての定義

┃
┃
┃
┃
┣
┃
┃
┃
<description>
0または1回
メソッドの説明。このタグは複数指定できません。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別を特定する場合に指定します。
次の値が指定できます。

Home

Remote

LocalHome

Local

省略時は，すべてを表します。

┃
┃
┃
┣
┃
┃
<method-name>
1回
対象となるメソッド名を指定します。*を指定した場合，すべてのメソッドを表します。※4

┃
┃
┃
┃
┗
<method-params>
0または1回
メソッドが多重定義されている場合，メソッドを特定するために指定します。

┃
┃
┃

┗
<method-param>
0回以上
引数のデータ型を指定。

┗
<transaction-timeout>
1回
トランザクションタイムアウト時間を，0～2147483647（単位：秒）で指定します。デフォルト値は0。0を指定した場合，またはタグがない場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※4

J2EEサーバ用のusrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleに「false」を指定している場合にこのタグで指定されたメソッドが存在しないとき，属性の設定でエラーになります。usrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleキーについては，「4.4　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）」を参照してください。

5.6.2　DDとの対応

Entity Bean属性ファイルとDeployment Descriptorの対応を次に示します。

Entity Bean属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-entity-bean-property>
1回
<ejb-jar>
1回

┃
┃
－
－
┣
┃
<description>
0または1回

┃
┃
－
－
┣
┃
<display-name>
0または1回

┃
┃
－
－
┣
┃
<icon>
0回以上

┃
┃
－
－
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
－
－
┃
┃
┗
<large-icon>
0または1回

┃
┃
－
－
┣
┃
<enterprise-beans>
1回

┃
┃
－
－
┃
┃
┣
┃
<session>※1
1回以上

┃
┃
－
－
┃
┃
┃
┃
(省略)
－

┃
┃
－
－
┃
┃
┗
<entity>※1
1回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃
┣
┃
<display-name>
1回以上
┃
┃

┣
┃
<display-name>
0回以上

┃
┃
┣
┃
<icon>
0回以上
┃
┃

┣
┃
<icon>
0回以上

┃
┃
┃
┃
┣
┃
<small-icon>
0または1回
┃
┃

┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┃
┃
┗
<large-icon>
0または1回
┃
┃

┃
┃
┗
<large-icon>
0または1回

┃
┃
┃
┃
－
－
┃
┃

┣
┃
<ejb-name>
1回

┃
┃
┃
┃
－
－
┃
┃

┣
┃
<home>
0または1回

┃
┃
┃
┃
－
－
┃
┃

┣
┃
<remote>
0または1回

┃
┃
┃
┃
－
－
┃
┃

┣
┃
<ejb-class>
1回

┃
┃
┣
┃
<persistence-type>
0または1回
┃
┃

┣
┃
<persistence-type>
0または1回

┃
┃
┣
┃
<prim-key-class>
1回
┃
┃

┣
┃
<prim-key-class>
1回

┃
┃
┣
┃
<reentrant>
1回
┃
┃

┣
┃
<reentrant>
1回

┃
┃
┣
┃
<abstract-schema-name>
0または1回
┃
┃

┣
┃
<abstract-schema-name>
0または1回

┃
┃
┣
┃
<cmp-field>
0回以上
┃
┃

┣
┃
<cmp-field>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┗
<field-name>
1回
┃
┃

┃
┃
┗
<field-name>
1回

┃
┃
┣
┃
<primkey-field>
0または1回
┃
┃

┣
┃
<primkey-field>
0または1回

┃
┃
┣
┃
<env-entry>
0回以上
┃
┃

┣
┃
<env-entry>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<env-entry-name>
1回
┃
┃

┃
┃
┣
┃
<env-entry-name>
1回

┃
┃
┃
┃
┣
┃
<env-entry-type>
1回
┃
┃

┃
┃
┣
┃
<env-entry-type>
1回

┃
┃
┃
┃
┗
<env-entry-value>
1回
┃
┃

┃
┃
┗
<env-entry-value>
0または1回

┃
┃
┣
┃
<ejb-ref>
0回以上
┃
┃

┣
┃
<ejb-ref>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<ejb-ref-name>
1回
┃
┃

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┃
┃
┣
┃
<ejb-ref-type>
1回
┃
┃

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┃
┃
┣
┃
<home>
1回
┃
┃

┃
┃
┣
┃
<home>
1回

┃
┃
┃
┃
┣
┃
<remote>
1回
┃
┃

┃
┃
┣
┃
<remote>
1回

┃
┃
┃
┃
┗
<ejb-link>
0または1回
┃
┃

┃
┃
┗
<ejb-link>
0または1回

┃
┃
┣
┃
<ejb-local-ref>
0回以上
┃
┃

┣
┃
<ejb-local-ref>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<ejb-ref-name>
1回
┃
┃

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┃
┃
┣
┃
<ejb-ref-type>
1回
┃
┃

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┃
┃
┣
┃
<local-home>
1回
┃
┃

┃
┃
┣
┃
<local-home>
1回

┃
┃
┃
┃
┣
┃
<local>
1回
┃
┃

┃
┃
┣
┃
<local>
1回

┃
┃
┃
┃
┗
<ejb-link>
0または1回
┃
┃

┃
┃
┗
<ejb-link>
0または1回

┃
┃
┣
┃
<security-role-ref>
0回以上
┃
┃

┣
┃
<security-role-ref>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<role-name>
1回
┃
┃

┃
┃
┣
┃
<role-name>
1回

┃
┃
┃
┃
┗
<role-link>
0または1回
┃
┃

┃
┃
┗
<role-link>
0または1回

┃
┃
┣
┃
<security-identity>
0または1回
┃
┃

┣
┃
<security-identity>
0または1回

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<use-caller-identity>※1
1回
┃
┃

┃
┃
┣
┃
<use-caller-identity>※1
1回

┃
┃
┃
┃
┗
<run-as>※1
1回
┃
┃

┃
┃
┗
<run-as>※1
1回

┃
┃
┃
┃

┣
┃
<description>
0回以上
┃
┃

┃
┃

┣
┃
<description>
0回以上

┃
┃
┃
┃

┣
┃
<role-name>
1回
┃
┃

┃
┃

┗
<role-name>
1回

┃
┃
┃
┃

┗
<user-name>
0または1回
┃
┃

┃
┃

－
1回

┃
┃
┣
┃
<resource-ref>
0回以上
┃
┃

┣
┃
<resource-ref>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<res-ref-name>
1回
┃
┃

┃
┃
┣
┃
<res-ref-name>
1回

┃
┃
┃
┃
┣
┃
<res-type>
1回
┃
┃

┃
┃
┣
┃
<res-type>
1回

┃
┃
┃
┃
┣
┃
<res-auth>
1回
┃
┃

┃
┃
┣
┃
<res-auth>
1回

┃
┃
┃
┃
┣
┃
<res-sharing-scope>
0または1回
┃
┃

┃
┃
┗
<res-sharing-scope>
0または1回

┃
┃
┃
┃
┣
┃
<mapped-name>
0または1回
┃
┃

┃
┃
－
－

┃
┃
┃
┃
┗
<linked-to>
0または1回
┃
┃

┃
┃
－
－

┃
┃
┣
┃
<resource-env-ref>
0回以上
┃
┃

┣
┃
<resource-env-ref>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<resource-env-ref-name>
1回
┃
┃

┃
┃
┣
┃
<resource-env-ref-name>
1回

┃
┃
┃
┃
┣
┃
<resource-env-ref-type>
1回
┃
┃

┃
┃
┗
<resource-env-ref-type>
1回

┃
┃
┃
┃
┣
┃
<mapped-name>
0または1回
┃
┃

┃
┃
－
－

┃
┃
┃
┃
┣
┃
<linked-queue>
0または1回
┃
┃

┃
┃
－
－

┃
┃
┃
┃
┃
┃
┣
┃
<resource-adapter>
1回
┃
┃

┃
┃
－
－

┃
┃
┃
┃
┃
┃
┗
<queue>
1回
┃
┃

┃
┃
－
－

┃
┃
┃
┃
┗
<linked-adminobject>
0または1回
┃
┃

┃
┃
－
－

┃
┃
┃
┃

┣
┃
<resource-adapter-name>
1回
┃
┃

┃
┃
－
－

┃
┃
┃
┃

┗
<adminobject-name>
1回
┃
┃

┃
┃
－
－

┃
┃
┗
<query>
0回以上
┃
┃

┗
<query>
0回以上

┃
┃

┣
┃
<description>
0または1回
┃
┃

┣
┃
<description>
0または1回

┃
┃

┣
┃
<query-method>
1回
┃
┃

┣
┃
<query-method>
1回

┃
┃

┃
┃
┣
┃
<method-name>
1回
┃
┃

┃
┃
┣
┃
<method-name>
1回

┃
┃

┃
┃
┗
<method-params>
1回
┃
┃

┃
┃
┗
<method-params>
1回

┃
┃

┃
┃

┗
<method-param>
0回以上
┃
┃

┃
┃

┗
<method-param>
0回以上

┃
┃

┣
┃
<result-type-mapping>
0または1回
┃
┃

┣
┃
<result-type-mapping>
0または1回

┃
┃

┗
<ejb-ql>
1回
┃
┃

┗
<ejb-ql>
1回

┃
┃
－
－
┣
┃
<assembly-descriptor>
0または1回

┃
┃
－
－
┃
┃
┣
┃
<security-role>
0回以上

┃
┃
－
－
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
－
－
┃
┃
┃
┃
┗
<role-name>
1回

┣
┃
<method-permission>
0回以上
┃
┃
┣
┃
<method-permission>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<role-name>※3
1回以上
┃
┃
┃
┃
┣
┃
<role-name>※3
1回以上

┃
┃
┣
┃
<unchecked>※3
1回
┃
┃
┃
┃
┣
┃
<unchecked>※3
1回

┃
┃
┗
<method>
1回以上
┃
┃
┃
┃
┗
<method>
1回以上

┃
┃

┣
┃
<description>
0回以上
┃
┃
┃
┃

┣
┃
<description>
0回以上

┃
┃

┃
┃
－
－
┃
┃
┃
┃

┣
┃
<ejb-name>
1回

┃
┃

┣
┃
<method-intf>
0または1回
┃
┃
┃
┃

┣
┃
<method-intf>
0または1回

┃
┃

┣
┃
<method-name>
1回
┃
┃
┃
┃

┣
┃
<method-name>
1回

┃
┃

┗
<method-params>
0または1回
┃
┃
┃
┃

┗
<method-params>
0または1回

┃
┃

┗
<method-param>
0回以上
┃
┃
┃
┃

┗
<method-param>
0回以上

┣
┃
<container-transaction>
0回以上
┃
┃
┣
┃
<container-transaction>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<method>
1回以上
┃
┃
┃
┃
┣
┃
<method>
1回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┃
┃
－
－
┃
┃
┃
┃
┃
┃
┣
┃
<ejb-name>
1回

┃
┃
┃
┃
┣
┃
<method-intf>
0または1回
┃
┃
┃
┃
┃
┃
┣
┃
<method-intf>
0または1回

┃
┃
┃
┃
┣
┃
<method-name>
1回
┃
┃
┃
┃
┃
┃
┣
┃
<method-name>
1回

┃
┃
┃
┃
┗
<method-params>
0または1回
┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回

┃
┃
┃
┃

┗
<method-param>
0回以上
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上

┃
┃
┗
<trans-attribute>
1回
┃
┃
┃
┃
┗
<trans-attribute>
1回

┣
┃
<exclude-list>
0または1回
┃
┃
┗
<exclude-list>
0または1回

┃
┃
┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃
┗
<method>
1回以上
┃
┃

┗
<method>
1回以上

┃
┃

┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃

┃
┃
－
－
┃
┃

┣
┃
<ejb-name>
１回

┃
┃

┣
┃
<method-intf>
0または1回
┃
┃

┣
┃
<method-intf>
0または1回

┃
┃

┣
┃
<method-name>
1回
┃
┃

┣
┃
<method-name>
1回

┃
┃

┗
<method-params>
0または1回
┃
┃

┗
<method-params>
0または1回

┃
┃

┗
<method-param>
0回以上
┃
┃

┗
<method-param>
0回以上

┃
┃
－
－
┗
<ejb-client-jar>
0または1回

┗
<runtime>
0または1回
－
－

(省略)
－
－
－

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<session>と<entity>のどちらか一つを指定します。

注※2

<use-caller-identity>と<run-as>のどちらか一つを指定します。

注※3

<role-name>と<unchecked>のどちらか一つを指定します。

5.7　MessageDrivenBean属性ファイル

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

＜この節の構成＞

5.7.1　MessageDrivenBean属性ファイルの指定内容

5.7.2　DDとの対応

5.7.1　MessageDrivenBean属性ファイルの指定内容

MessageDrivenBean属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-message-bean-property PUBLIC '-//Hitachi, Ltd.//DTD Message Bean Property 7.6//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-message-bean-property_7_6.dtd'>

MessageDrivenBean属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-message-bean-property>
1回
ルートタグ。

┣
┃
┃
┃
┃
<description>※1
0回以上※2
Message-driven Beanについての説明。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<display-name>※1
1回以上※2
Message-driven Beanの名称。
xml:lang属性が"en"のdisplay-nameを必ず指定します。当該リソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。
1≦文字列長
xml:lang属性が"en"のタグの場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。
xml:lang属性が"en"のタグ以外の場合，文字の制限はありません。

┣
┃
┃
┃
┃
<icon>※1
0回以上※2
GUIツール上に表示されるEntity Beanのアイコンの定義。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。

┃
┃
┃
┃
┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。

┣
┃
┃
┃
┃
┃
┃
┃
<messaging-type>
0または1回
Message-driven Beanのメッセージリスナインタフェース。
記述されていない場合には，"javax.jms.MessageListener"が仮定されます。
このタグは，EJB2.1以降のEnterprise Beanに対して指定できます。

┣
┃
┃┃
┃
┃
<transaction-type>
1回
トランザクションの管理方法。
「Container」または「Bean」のどちらかを指定できます。

┣
┃
┃
┃
┃
┃
┃
┃
<activation-config>
0または1回
Message-driven Beanの動作環境。
このタグより下位のタグは，EJB2.1以降のEnterprise Beanに対して指定できます。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上
Message-driven Beanの動作環境の説明。

┃
┃
┃
┗
<activation-config-property>
1回以上
Message-driven Beanの動作環境に関するプロパティ。

┃
┃
┃

┣
┃
┃
<activation-config-property-name>
1回
Message-driven Beanの動作環境に関するプロパティ名。

┃
┃
┃

┗
<activation-config-property-value>
1回
Message-driven Beanの動作環境に関するプロパティの値。

┣
┃
┃┃
┃
┃
<message-selector>
0または1回
Message-driven beanが受信するメッセージを決定するためのJMSメッセージセレクタ。
このタグはEJB2.0以前のEnterprise Beanに対して指定できます。

┣
┃
┃
┃
┃
┃
┃┃
┃
┃
<acknowledge-mode>
0または1回
BMTのMessage-driven beanのonMessageメッセージで使用する通知セマンティクス。
「Auto-acknowledge」または「Dups-ok- acknowledge」のどちらかを指定します。デフォルトは「Auto-acknowledge」です。
このタグはEJB2.0以前のEnterprise Beanに対して指定できます。

┣
┃
┃┃
┃
┃
<message-driven-destination>
0または1回
JMSデスティネーションの定義。
このタグより下位のタグはEJB2.0以前のEnterprise Beanに対して指定できます。

┃
┃
┃
┃
┃┃
┃
┃
┣
┃
┃
┃
┃┃
┃
┃
<destination-type>
1回
JMSデスティネーションのタイプ。
「javax.jms.Queue」または「javax.jms.Topic」のどちらかを指定します。

┃
┃
┃
┃
┃
┃┃
┃
┃
┗
<subscription-durability>
0または1回
JMSデスティネーションが「javax.jms.Topic」の場合のサブスクリプション。
「Durable」または「NonDurable」のどちらかを指定します。デフォルトは後者です。

┣
┃┃
┃
┃
<env-entry>
0回以上
Message-driven Beanから呼び出す環境変数についての定義。

┃
┃┃
┃
┃
┣
┃
┃
┃┃
<description>※1
0回以上※2
環境変数についての説明。

┃
┃┃
┃
┃
┣
┃┃
┃
┃
<env-entry-name>
1回
環境変数の名称。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃┃
┃
┃┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃┃
┃
┃┃
┃
┃
<env-entry-type>
1回
環境変数の値のJavaタイプ。
指定できる値を次に示します。

java.lang.Boolean

java.lang.String

java.lang.Character

java.lang.Integer

java.lang.Double

java.lang.Byte

java.lang.Short

java.lang.Long

java.lang.Float

┃┃
┃
┃
┗
<env-entry-value>
1回
環境変数の値。

┣
┃
┃
┃┃
┃
┃
<ejb-ref>
0回以上
Message-driven Beanからリモートインタフェースを持つEnterprise Beanへの参照情報についての定義。

┃
┃┃
┃
┃
┣
┃┃
┃
┃
<description>※1
0回以上※2
Enterprise Bean参照についての説明。

┃┃
┃
┃
┣┃
┃
┃
<ejb-ref-name>
1回
リンク先のEnterprise Beanの名称。

┃
┃
┃
┃┃
┃
┃
┣
┃
┃
┃┃
┃
┃
<ejb-ref-type>
1回
リンク先のEnterprise Beanの種別。
指定できる値を次に示します。

Session

Entity

┃
┃┃
┃
┃
┣
┃
┃
┃┃
<home>
1回
リンク先のEnterprise BeanのRemote Homeインタフェース名。

┃
┃
┃┃
┃
┃
┣
┃
┃┃
┃
┃
<remote>
1回
リンク先のEnterprise BeanのRemote Componentインタフェース名。

┃
┃
┃
┃
┃
┃
┃
┃┃
┃
┃
┗
<ejb-link>
0または1回
リンク先のEnterprise Beanの名称。ネーミングの切り替え機能でリンク先を設定する場合，次の形式で指定してください。

corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBHomeオブジェクトリファレンスのJNDI名>

┣
┃
┃
┃┃
┃
┃
<ejb-local-ref>
0回以上
Message-driven Beanからローカルインタフェースを持つEnterprise Beanへの参照情報についての定義。

┃
┃
┃┃
┃
┃
┣
┃
┃┃
┃
┃
<description>※1
0回以上※2
ejb-local-refの説明。

┃
┣
<ejb-ref-name>
1回
リンク先のEnterprise Beanの名称。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<ejb-ref-type>
1回
リンク先のEnterprise Beanの種別。
指定できる値を次に示します。

Session

Entity

┃
┃┃
┃
┃
┣
┃┃
┃
┃
<local-home>
1回
リンク先のEnterprise BeanのLocal Homeインタフェース名。

┃
┃┃
┃
┃
┣
┃
┃
┃┃
<local>
1回
リンク先のEnterprise BeanのLocal Componentインタフェース名。

┃
┃
┃┃
┃
┃
┗
<ejb-link>
0または1回
リンク先のEnterprise Beanの名称。

┣
┃
┃
┃
┃
┃
┃
<message-ref>
0または1回
Connector1.0のリソースアダプタを指定する場合，<resource-adapter>と<queue>の組み合わせは，複数のアプリケーション間でユニークにする必要があります。

┃┃
┃
┃
┣┃
┃
┃
<connection-factory>
0または1回
リソースアダプタの表示名を指定します。
Connector1.5以降のリソースアダプタは指定できません。

┃
┃
┗
<connection-destination>
1回
cjsetrespropでは無視されます。

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<resource-adapter>
1回
リソースアダプタの表示名を指定します。

┃┃
┃

┗
<queue>
0または1回
キューの表示名を指定します。
Connector1.5以降のリソースアダプタは指定できません。

┣
┃
┃┃
<security-identity>
0または1回
セキュリティアイデンティティについての定義。

┃
┃┃
┃
┃
┣
┃┃
┃
┃
<description>※1
0回以上※2
security-identityの説明。

┃┃
┃
┗
<run-as>
1回
実行時アイデンティティの定義。

┃
┃┃
┃
┃

┣
┃┃
┃
┃
<description>※1
0回以上※2
run-asの説明。

┃┃

┣
┃
<role-name>
1回
セキュリティロール名。

┃
┃

┗
<user-name>
1回
プリンシパル名。

┣
┃
┃
┃
<resource-ref>
0回以上
Message-Driven Beanから参照するリソースの定義。

┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
resource-refの説明。

┃
┃
┣
┃
<res-ref-name>
1回
リソース参照の名称。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<res-type>
1回
リソース種別。
参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子(<connectionfactory-interface>タグの設定値)を指定します。

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<res-auth>
1回
リソースマネジャへ登録する方法。
指定できる値は，「Container」または「Application」のどちらかです。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<res-sharing-scope>
0または1回
リソースマネジャファクトリリファレンスから取得したコネクションを共有するかどうかの指定。
設定できる値は，「Shareable」または「Unshareable」のどちらかです。デフォルトは「Shareable」です。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<mapped-name>
0または1回
対応するリソースアダプタ表示名またはメール表示名。※3
<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
対応するリソースアダプタ表示名，データソース表示名，またはメール表示名。
リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

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

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプールのメンバリソースアダプタは指定できません。
cjsetrespropでは無視されます。

┣
┃
┃
┃
<resource-env-ref>
0回以上
Message-driven Beanから参照するリソース環境変数の定義。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
resource-env-refの説明。

┃
┃
┣
┃
<resource-env-ref-name>
1回
リソース環境変数参照の名称。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<resource-env-ref-type>
1回
リソース環境変数参照の種別。
次のJavaクラスまたはインタフェース名を指定します。

javax.jms.Queue

javax.jms.Topic

JavaBeansリソースのクラス名

<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<mapped-name>
0または1回
<resource-env-ref-type>が「javax.jms.Queue」の場合，対応するキュー※3を次の形式で表示します。
"<リソースアダプタの表示名>#<Queue名称>"
<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。
<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<linked-queue>
0または1回
queue名称。
cjsetrespropでは無視されます。
<resource-env-ref-type>が「javax.jms.Queue」の場合だけ有効となります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<resource-adapter>
1回
リソースアダプタの表示名を指定します。
Connector1.5のリソースアダプタは指定できません。

┃
┃
┃
┃
┗
<queue>
1回
キューの表示名を指定します。

┃
┃
┃
┃
┣
┃
┃
┃
<linked-adminobject>
0または1回
管理対象オブジェクト。cjsetrespropでは無視されます。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<resourceadapter-name>
1回
リソースアダプタの表示名を指定します。
Connector1.0以前のリソースアダプタは指定できません。

┃
┃
┃
┃
┗
<adminobject-name>
1回
管理対象オブジェクト名を指定します。

┃
┃
┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
JavaBeansリソースの表示名。
<resource-env-ref-type>に「Java.jms.リソースのクラス名」が指定された場合だけ有効となります。
cjsetrespropでは無視されます。

┣
┃
┃
┃
<container-transaction>
0回以上
コンテナのトランザクションについての定義。

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<description>※1
0回以上※2
container-transactionの説明。

┃
┃
┃
┃
┣
┃
┃
┃
<method>
1回以上
メソッドについての定義。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<description>※1
0回以上※2
メソッドの説明。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。
このタグには，値を指定できません。ただし，設定先がEJB2.0以前のEJBの場合は，"Bean"を指定できます。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<method-name>
1回
メソッド名。
*を指定した場合，すべてのメソッドを表します。※4

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<method-params>
0または1回
method-nameが*以外の場合に有効。

method-paramsの指定あり

method-intfで指定したインタフェースにある，method-paramsで指定したパラメタを持つmethod-nameのメソッド。

method-paramsの指定なし

method-intfで指定したインタフェースにある，すべてのmethod-nameのメソッド。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<method-param>
0回以上
パラメタのデータ型。
プリミティブ型またはクラスの名称を指定します。
配列の場合は名称の後ろに[]を指定します（名称と[の間，[と]の間を空けないようにしてください）。多次元配列の場合は[]を続けて指定します（]と[の間を空けないようにしてください）。配列の内部形式名（int[]の場合[I，java.lang.String[]の場合[Ljava.lang.String;）は指定できません。
例

int

short[][]

java.lang.String[]

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<trans-attribute>
1回
メソッドに割り当てるトランザクション属性。
指定できる文字列を次に示します。

Mandatory

Never

NotSupported

Required

RequiresNew

Supports

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<runtime>
0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃
┃┃
┃
┣
┃┃
┃
<pooled-instance>
1回
プール内のインスタンスについての定義。

┃
┃
┃┃
┃
┃
┃
┃┃
┃
┣
┃
┃┃
┃
<minimum>
1回
プール内のインスタンスの最小数。※3
1が表示されます。

┃
┃
┃
┃
┃┃
┃
┃
┃
┃
┃
┃┃
┃
┗
<maximum>
1回
プール内のインスタンスの最大数。
1≦maximum≦2147483647。
0を指定した場合，1が設定されます。

┃
┃
┃
┃
┃
┃┃
┃
┗
<front-ejb>
0または1回
フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。フロントEJBの場合はtrueを指定し，フロントEJBでない場合はfalseを指定します。デフォルト値はfalse。

┣
┃
┃
┃
┃
┃┃
┃
<start-order>
0または1回
J2EEアプリケーション開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。
0≦start-order≦2147483647

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

┃
┃
┃
┣
┃
┃
<method>
1回以上
－

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<description>
0または1回
メソッドの説明。このタグは複数指定できません。

┃
┃
┃
┃
┃
┃┃
┃
┃
┃
┃
┃
┃
┃┃
┃
┣
┃
┃
┃
┃
┃┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別。
このタグには，値を指定できません。ただし，設定先がEJB2.0以前のEJBの場合は，"Bean"を指定できます。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<method-name>
1回
対象となるメソッド名を指定します。*を指定した場合，すべてのメソッドを表します。※4

┃
┃
┃┃
┃
┃
┃
┃
┃┃
┃
┃
┗
<method-params>
0または1回
メソッドが多重定義されている場合，メソッドを特定するために指定します。

┃
┃┃
┃
┃
┃┃
┃

┗
<method-param>
0回以上
引数のデータ型を指定。

┃
┃
┃
┃
┃┃
┃
┗
<method-observation-timeout>
1回
仕掛かり中メソッド監視用タイムアウト時間を，0～86400（単位：秒）で指定します。0を指定した場合，タイムアウトしません。デフォルト値は0。

┗
<ejb-transaction-timeout>
0回以上
EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。
<ejb-transaction-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37601-W）が出力され，先に定義された<ejb-transaction-timeout>の<transaction-timeout>の値が有効になります。

┣
┃
<method>
1回以上
－

┃
┃
┃
┃
┣
┃
┃┃
<description>
0または1回
メソッドの説明。このタグは複数指定できません。

┃
┃
┃
┃
┃
┃
┃┃
┃
┣
┃
┃
┃
┃
┃
┃┃
┃
<method-intf>
0または1回
メソッドが属するインタフェース種別を特定する場合に指定します。
このタグには，値を指定できません。ただし，設定先がEJB2.0以前のEJBの場合は，"Bean"を指定できます。

┃
┃
┃┃
┃
┣
┃
┃┃
┃
<method-name>
1回
対象となるメソッド名を指定します。*を指定した場合はすべてのメソッドを表します。※4

┃
┃
┃┃
┃
┃
┗
<method-params>
0または1回
メソッドが多重定義されている場合，メソッドを特定するために指定します。

┃
┃┃
┃

┗
<method-param>
0回以上
引数のデータ型を指定。

┗
<transaction-timeout>
1回
トランザクションタイムアウト時間を，0～2147483647（単位：秒）で指定します。0を指定した場合，タイムアウトしません。デフォルト値は0。

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

EJB2.0以前のEJBに対して，このタグを複数指定できません。

注※3

cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※4

J2EEサーバ用のusrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleに「false」を指定している場合にこのタグで指定されたメソッドが存在しないとき，属性の設定でエラーになります。usrconf.propertiesファイルのejbserver.cui.checkmethod.compatibleキーについては，「4.4　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）」を参照してください。

5.7.2　DDとの対応

MessageDrivenBean属性ファイルとDeployment Descriptorの対応を次に示します。

＜この項の構成＞

(1)　EJB2.0の場合

(2)　EJB2.1の場合

(1)　EJB2.0の場合

MessageDrivenBean属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-message-bean-property>
1回
<ejb-jar>
1回

┃
┃
－
－
┣
┃
<description>
0または1回

┃
┃
－
－
┗
<enterprise-beans>
1回

┃
┃
－
－

┃
┃
(省略)　
－

┃
┃
－
－

┗
<message-driven>
1回以上

┣
┃
<description>
0回以上

┣
┃
<description>
0回以上

┣
┃
<display-name>
1回以上

┣
┃
<display-name>
0回以上

┣
┃
<icon>
0回以上

┣
┃
<icon>
0回以上

┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回

┣
┃
<transaction-type>
1回

┣
┃
<transaction-type>
1回

┣
┃
<message-selector>
0または1回

┣
┃
<message-selector>
0または1回

┣
┃
<acknowledge-mode>
0または1回

┣
┃
<acknowledge-mode>
0または1回

┣
┃
<message-driven-destination>
0または1回

┣
┃
<message-driven-destination>
0または1回

┃
┃
┣
┃
<destination-type>
1回

┃
┃
┣
┃
<destination-type>
1回

┃
┃
┗
<subscription-durability>
0または1回

┃
┃
┗
<subscription-durability>
0または1回

┣
┃
<env-entry>
0回以上

┣
┃
<env-entry>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<env-entry-name>
1回

┃
┃
┣
┃
<env-entry-name>
1回

┃
┃
┣
┃
<env-entry-type>
1回

┃
┃
┣
┃
<env-entry-type>
1回

┃
┃
┗
<env-entry-value>
1回

┃
┃
┗
<env-entry-value>
0または1回

┣
┃
<ejb-ref>
0回以上

┣
┃
<ejb-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<home>
1回

┃
┃
┣
┃
<home>
1回

┃
┃
┣
┃
<remote>
1回

┃
┃
┣
┃
<remote>
1回

┃
┃
┗
<ejb-link>
0または1回

┃
┃
┗
<ejb-link>
0または1回

┣
┃
<ejb-local-ref>
0回以上

┣
┃
<ejb-local-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<local-home>
1回

┃
┃
┣
┃
<local-home>
1回

┃
┃
┣
┃
<local>
1回

┃
┃
┣
┃
<local>
1回

┃
┃
┗
<ejb-link>
0または1回

┃
┃
┗
<ejb-link>
0または1回

┣
┃
<security-identity>
0または1回

┣
┃
<security-identity>
0または1回

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
－
－

┃
┃
┣
┃
<use-caller-identity>※
1回

┃
┃
┗
<run-as>
1回

┃
┃
┗
<run-as>※
1回

┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<role-name>
1回

┃
┃

┗
<role-name>
1回

┃
┃

┗
<user-name>
1回

┃
┃

－
－

┣
┃
<container-transaction>
0回以上

┣
┃
<container-transaction>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<method>
1回以上

┃
┃
┣
┃
<method>
1回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<method-intf>
0または1回

┃
┃
┃
┃
┣
┃
<method-intf>
0または1回

┃
┃
┃
┃
┣
┃
<method-name>
1回

┃
┃
┃
┃
┣
┃
<method-name>
1回

┃
┃
┃
┃
┗
<method-params>
0または1回

┃
┃
┃
┃
┗
<method-params>
0または1回

┃
┃
┃
┃

┗
<method-param>
0回以上

┃
┃
┃
┃

┗
<method-param>
0回以上

┃
┃
┗
<trans-attribute>
1回

┃
┃
┗
<trans-attribute>
1回

┣
┃
<resource-ref>
0回以上

┣
┃
<resource-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<res-ref-name>
1回

┃
┃
┣
┃
<res-ref-name>
1回

┃
┃
┣
┃
<res-type>
1回

┃
┃
┣
┃
<res-type>
1回

┃
┃
┣
┃
<res-auth>
1回

┃
┃
┣
┃
<res-auth>
1回

┃
┃
┣
┃
<res-sharing-scope>
0または1回

┃
┃
┗
<res-sharing-scope>
0または1回

┃
┃
┣
┃
<mapped-name>
0または1回

┃
┃

－
－

┃
┃
┗
<linked-to>
0または1回

┃
┃

－
－

┣
┃
<resource-env-ref>
0回以上

┗
<resource-env-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上

┣
┃
<description>
0回以上

┃
┃
┣
┃
<resource-env-ref-name>
1回

┣
┃
<resource-env-ref-name>
1回

┃
┃
┣
┃
<resource-env-ref-type>
1回

┗
<resource-env-ref-type>
1回

┃
┃
┣
┃
<mapped-name>
0または1回

－
－

┃
┃
┗
<linked-queue>
0または1回

－
－

┃
┃

┣
┃
<resource-adapter>
1回

－
－

┃
┃

┗
<queue>
1回

－
－

┗
<runtime>
0または1回

－
－

(省略)
－

－
－

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<use-caller-identity>と<run-as>のどちらか一つを指定します。

(2)　EJB2.1の場合

MessageDrivenBean属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-message-bean-property>
1回
<ejb-jar>
1回

┃
┃
－
－
┣
┃
<description>
0または1回

┃
┃
－
－
┣
┃
<enterprise-beans>
1回

┃
┃
－
－
┗
┃
┃
(省略)　
－

┃
┃
－
－

┗
<message-driven>
1回以上

┣
┃
<description>
0回以上

┣
┃
<description>
0回以上

┣
┃
<display-name>
1回以上

┣
┃
<display-name>
0回以上

┣
┃
<icon>
0回以上

┣
┃
<icon>
0回以上

┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回

┣
┃
<messaging-type>
0または1回

┣
┃
<messaging-type>
0または1回

┣
┃
<transaction-type>
1回

┣
┃
<transaction-type>
1回

┣
┃
<activation-config>
0または1回

┣
┃
<activation-config>
0または1回

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┗
<activation-config-property>
1回以上

┃
┃
┗
<activation-config-property>
1回以上

┃
┃

┣
┃
<activation-config-property-name>
1回

┃
┃

┣
┃
<activation-config-property-name>
1回

┃
┃

┗
<activation-config-property-value>
1回

┃
┃

┗
<activation-config-property-value>
1回

┣
┃
<env-entry>
0回以上

┣
┃
<env-entry>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<env-entry-name>
1回

┃
┃
┣
┃
<env-entry-name>
1回

┃
┃
┣
┃
<env-entry-type>
1回

┃
┃
┣
┃
<env-entry-type>
1回

┃
┃
┗
<env-entry-value>
1回

┃
┃
┗
<env-entry-value>
0または1回

┣
┃
<ejb-ref>
0回以上

┣
┃
<ejb-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<home>
1回

┃
┃
┣
┃
<home>
1回

┃
┃
┣
┃
<remote>
1回

┃
┃
┣
┃
<remote>
1回

┃
┃
┗
<ejb-link>
0または1回

┃
┃
┗
<ejb-link>
0または1回

┣
┃
<ejb-local-ref>
0回以上

┣
┃
<ejb-local-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<local-home>
1回

┃
┃
┣
┃
<local-home>
1回

┃
┃
┣
┃
<local>
1回

┃
┃
┣
┃
<local>
1回

┃
┃
┗
<ejb-link>
0または1回

┃
┃
┗
<ejb-link>
0または1回

┣
┃
<security-identity>
0または1回

┣
┃
<security-identity>
0または1回

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
－
－

┃
┃
┣
┃
<use-caller-identity>※
1回

┃
┃
┗
<run-as>
1回

┃
┃
┗
<run-as>※
1回

┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<role-name>
1回

┃
┃

┗
<role-name>
1回

┃
┃

┗
<user-name>
1回

┃
┃

－
－

┣
┃
<container-transaction>
0回以上

┣
┃
<container-transaction>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<method>
1回以上

┃
┃
┣
┃
<method>
1回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<method-intf>
0または1回

┃
┃
┃
┃
┣
┃
<method-intf>
0または1回

┃
┃
┃
┃
┣
┃
<method-name>
1回

┃
┃
┃
┃
┣
┃
<method-name>
1回

┃
┃
┃
┃
┗
<method-params>
0または1回

┃
┃
┃
┃
┗
<method-params>
0または1回

┃
┃
┃
┃

┗
<method-param>
0回以上

┃
┃
┃
┃

┗
<method-param>
0回以上

┃
┃
┗
<trans-attribute>
1回

┃
┃
┗
<trans-attribute>
1回

┣
┃
<resource-ref>
0回以上

┣
┃
<resource-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<res-ref-name>
1回

┃
┃
┣
┃
<res-ref-name>
1回

┃
┃
┣
┃
<res-type>
1回

┃
┃
┣
┃
<res-type>
1回

┃
┃
┣
┃
<res-auth>
1回

┃
┃
┣
┃
<res-auth>
1回

┃
┃
┣
┃
<res-sharing-scope>
0または1回

┃
┃
┗
<res-sharing-scope>
0または1回

┃
┃
┣
┃
<mapped-name>
0または1回

┃
┃

－
－

┃
┃
┗
<linked-to>
0または1回

┃
┃

－
－

┣
┃
<resource-env-ref>
0回以上

┗
<resource-env-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上

┣
┃
<description>
0回以上

┃
┃
┣
┃
<resource-env-ref-name>
1回

┣
┃
<resource-env-ref-name>
1回

┃
┃
┣
┃
<resource-env-ref-type>
1回

┗
<resource-env-ref-type>
1回

┃
┃
┣
┃
<mapped-name>
0または1回

－
－

┃
┃
┣
┃
<linked-queue>
0または1回

－
－

┃
┃
┃
┃
┣
┃
<resource-adapter>
1回

－
－

┃
┃
┃
┃
┗
<queue>
1回

－
－

┃
┃
┗
<linked-adminobject>
0または1回

－
－

┃
┃

┣
┃
<resourceadapter-name>
1回

－
－

┃
┃

┗
<adminobject-name>
1回

－
－

┗
<runtime>
0または1回

－
－

(省略)
－

－
－

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<use-caller-identity>と<run-as>のどちらか一つを指定します。

5.8　WAR属性ファイル

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

＜この節の構成＞

5.8.1　WAR属性ファイルの指定内容

5.8.2　DDとの対応

5.8.1　WAR属性ファイルの指定内容

WAR属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-war-property PUBLIC '-//Hitachi, Ltd.//DTD War Property 7.6//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-war-property_7_6.dtd'>

WAR属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-war-property>
1回
ルートタグ。

┣
┃
┃
┃
<description>※1
0回以上※1
WARの説明。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃┃
┃
<display-name>※1
1回以上※1
WARの表示名。
xml:lang属性が"en"のdisplay-nameを必ず指定します。当該リソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。
1≦文字列長
xml:lang属性が"en"のタグの場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。
xml:lang属性が"en"のタグ以外の場合，文字の制限はありません。

┣
┃
┃
┃
<icon>※1
0回以上※1
Deployツール上に表示されるWebアプリケーションのアイコンの定義。

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。

┃
┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。

┣
┃
┃
┃
┃
┃
┃
<distributable>
0または1回
分散したサーブレットコンテナにデプロイできるようにプログラムされている場合に指定。なお，このタグは値を持ちません。

┣
┃
┃
┃
<context-param>
0回以上
コンテキスト初期化パラメタについての定義。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
Context-paramの説明。

┃
┃
┃
┣
┃
┃
<param-name>
1回
コンテキスト初期化パラメタ名。

┃
┃
┃
┗
<param-value>
1回
コンテキスト初期化パラメタの値。

┣
┃
┃
┃
<filter-mapping>
0回以上
Webアプリケーションのフィルタマッピングの定義。

┃
┃
┃
┣
┃
┃
<filter-name>
1回
マッピングを行うフィルタの名称。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<url-pattern>
1回
マッピングをするサーブレットのURL。
<url-pattern>と<servlet-name>のどちらか一つを指定します。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<servlet-name>
1回
マッピングをするサーブレットの名称。
<url-pattern>と<servlet-name>のどちらか一つを指定します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<dispatcher>
0または4回以下
フィルタの適用条件。
次のどれかを指定します。

FORWARD

RequestDispatcher.forward( )の処理のときだけフィルタを適用します。

INCLUDE

RequestDispatcher.include( )の処理のときだけフィルタを適用します。

REQUEST

通常のクライアントからのアクセスのときだけフィルタを適用します。

ERROR

例外処理のときだけフィルタを適用します。

Servlet2.3以前のWARに対して，このタグを指定できません。

┣
┃
<listener>
0回以上
リスナーについての定義。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<description>※1
0回以上
WebアプリケーションリスナーBeanについての説明。
Servlet2.3以前のWARに対して，このタグを指定できません。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<display-name>※1
0回以上
GUIツール上に表示されるWebアプリケーションリスナーBeanの名称。
指定する文字列は一意である必要はありません。
Servlet2.3以前のWARに対して，このタグを指定できません。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<icon>※1
0回以上※1
GUIツール上に表示されるWebアプリケーションリスナーBeanのアイコンの定義。
Servlet2.3以前のWARに対して，このタグを指定できません。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<small-icon>
0または1回
WebアプリケーションリスナーBeanの小アイコン用の画像ファイル名。
WARファイル中での画像ファイルの場所をルートからの相対パスで指定します。画像ファイルのサイズは16×16です。画像ファイルの形式は，JPEGファイルかGIFファイルです。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<large-icon>
0または1回
WebアプリケーションリスナーBeanの大アイコン用の画像ファイル名。
WARファイル中での画像ファイルの場所をルートからの相対パスで指定します。画像ファイルのサイズは32×32です。画像ファイルの形式は，JPEGファイルかGIFファイルです。

┃
┃
┃
┗
<listener-class>
1回
設定したリスナークラス名。

┣
┃
┃
┃
<session-config>
0回以上
セッションについての定義。
このタグを複数指定できません。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<session-timeout>
0または1回
デフォルトのセッションタイムアウト間隔（分）。
-1（タイムアウトしません），0（-1と等価です），1≦session-timeout≦35791394が指定できます。デフォルトは30です。

┣
┃┃
┃
<mime-mapping>
0回以上
MIMEタイプのマッピングについての定義。※3

┃
┃
┃
┣
┃
┃
<extension>
1回
ファイルの拡張子。※3

┃
┃
┃
┗
<mime-type>
1回
MIMEタイプ。※3

┣
┃
┃
<welcome-file-list>
0回以上※1
welcomeファイルについての定義。

┃
┃
┗
<welcome-file>
1回以上
welcomeファイル名。

┣┃
<error-page>
0回以上
エラーページについての定義。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<error-code>※4
1回
HTTPエラーコード。
HTTPエラーコードとエラーページリソースとをマッピングする場合に指定します。
-2147483648≦error-code≦2147483647になるように指定してください。<error-code>と<exception-type>のどちらか一つを指定します。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<exception-type>※4
1回
例外クラス名（完全修飾名）。
例外タイプとエラーページリソースとをマッピングする場合に指定します。
<error-code>と<exception-type>のどちらか一つを指定します。

┃
┃
┃
┗
<location>
1回
先頭が「/」で始まる値。

┣
┃
┃
┃
┃
┃
┃
<jsp-config>
0回以上
Webアプリケーション内のJSPの定義。
このタグを複数指定できません。また，Servlet2.3以前のWARに対して，このタグを指定できません。

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<taglib>
0回以上
Servlet2.4の場合のタグライブラリについての定義。
Servlet2.3の場合は<hitachi-war-property>タグの下の<taglib>で定義します。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<taglib-uri>
1回
JSPプログラムのtaglibディレクティブのuri属性に指定された値。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<taglib-location>
1回
tldファイルの配置場所（コンテキストルートからの相対パス）。

┃
┃
┃
┃
┗
<jsp-property-group>
0回以上
指定したURLパターンに合致するJSPプログラムの個別の設定。

┃
┃
┃
┃

┣
┃
┃
┃
<description>※1
0回以上
WebアプリケーションリスナーBeanについての説明。

┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
<display-name>※1
0回以上
GUIツール上に表示されるJSPプロパティグループの名称。
指定する文字列は一意である必要はありません。

┃
┃
┃
┃

┣
┃
┃
┃
<icon>※1
0回以上
GUIツール上に表示されるJSPプロパティグループのアイコンの定義。

┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<small-icon>
0または1回
JSPプロパティグループの小アイコン用の画像ファイル名。
WARファイル中での画像ファイルの場所をルートからの相対パスで指定します。画像ファイルのサイズは16×16です。画像ファイルの形式は，JPEGファイルかGIFファイルです。

┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<large-icon>
0または1回
JSPプロパティグループの大アイコン用の画像ファイル名。
WARファイル中での画像ファイルの場所をルートからの相対パスで指定します。画像ファイルのサイズは32×32です。画像ファイルの形式は，JPEGファイルかGIFファイルです。

┃
┃

┣
┃
<url-pattern>
1回以上
パラメータを適用するURLパターン。

┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
<el-ignored>
0または1回
EL（式言語）を無視するかどうかの指定。
指定できる文字列を次に示します。

true（無視する場合）

false（無視しない場合）

┃
┃
┃

┣
┃
┃
<page-encoding>
0または1回
ページエンコーディング名。

┃
┃
┃
┃

┣
┃
┃
┃
<scripting-invalid>
0または1回
スクリプティング要素を無効にするかどうか。

┃
┃
┃
┃

┣
┃
┃
┃
<is-xml>
0または1回
XML構文で記述されているかどうか。

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<include-prelude>
0回以上
各ページのヘッダとしてインクルードするファイルのパス（コンテキストルートからの相対パス）。

┃
┃
┃
┃
┃

┗
<include-coda>
0回以上
各ページのフッタとしてインクルードするファイルのパス（コンテキストルートからの相対パス）。

┣
┃
┃
┃
┃
┃
<taglib>
0回以上
Servlet2.3の場合のタグライブラリについての定義。
Servlet2.4の場合は<jsp-config>タグの下の<taglib>で定義します。

┃
┃
┃
┃
┣
┃
┃
┃
<taglib-uri>
1回
タグライブラリのURI（web.xmlに対する相対的なURI）。

┃
┃
┃
┃
┃
┗
<taglib-location>
1回
タグライブラリ記述ファイル（TLD）の場所（Webアプリケーションのルートからの相対位置）。

┣
┃
<security-constraint>
0回以上
セキュリティ制約についての定義。

┃
┃
┃
┣
┃
┃
<display-name>※1
0回以上※1
セキュリティ制約の名称。

┃
┃
┃
┃
┣
┃
┃
┃
<web-resource-collection>
1回以上
Webリソースコレクションについての定義。

┃
┃
┃
┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
web-resource-collectionの説明。

┃
┃
┃
┃
┣
┃
<web-resource-name>
1回
Webリソースコレクションの名称。

┃
┃
┃
┃
┣
┃
<url-pattern>
0回以上
WebリソースのURL。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<http-method>
0回以上
セキュリティ制約を適用するHTTPメソッド。
指定できる文字列を次に示します。

DELETE

GET

HEAD

OPTIONS

POST

PUT

TRACE

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<auth-constraint>
0または1回
Webリソースコレクションに対してアクセスを許可するロールについての定義。

┃
┃
┃
┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
auth-constraintの説明。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<role-name>
0回以上
Webリソースコレクションに対してアクセスを許可するロール。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<user-data-constraint>
0または1回
クライアントとコンテナ間のデータ通信がどのように保護されるのかの定義。

┃
┃
┃
┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
user-data-constraintの説明。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<transport-guarantee>
1回
クライアントとコンテナ間のデータ通信がどのように保護されるのかの定義。
指定できる文字列を次に示します。

NONE

アプリケーションはトランスポート保証を必要としません。

INTEGRAL

アプリケーションは通信データが伝送中に変更を加えられないような方法でデータ通信をすることを要求します。

CONFIDENTIAL

アプリケーションはほかのエンティティが伝送の内容を見ることができないような方法でデータ通信をすることを要求します。

┃
┃
┃
┃
┃
┃
┃
┗
<original-name>
1回
security-constraintのdisplay-nameの設定値を属性出力時に格納し保管します。※5
このタグの設定内容の変更，およびタグ自体の削除はできません。

┣
┃
┃
┃
<login-config>
0回以上
ログイン方法についての定義。
このタグを複数指定できません。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<auth-method>
0または1回
認証方式。
指定できる文字列を次に示します。

BASIC

FORM

CLIENT-CERT

デフォルトはBASIC（DIGESTは未サポート）。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<realm-name>
0または1回
レルム名。

auth-methodにBASICを指定した場合

必須

auth-methodにBASIC以外を指定した場合

cjsetappprop，cjsetrespropで無視されます。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<form-login-config>
0または1回

auth-methodにFORMを指定した場合

必須

auth-methodにFORM以外を指定した場合

cjsetappprop，cjsetrespropで無視されます。

┃
┃
┃
┃

┣
┃
┃
┃
<form-login-page>
1回
ログイン時に使用するページ。設定する値は先頭を'/'で始めてください。

┃
┃
┃

┗
<form-error-page>
1回
ログインに失敗したときに表示するエラーページ。設定する値は先頭を'/'で始めてください。

┣
┃
<security-role>
0回以上
セキュリティロールについての定義。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
security-roleの説明。

┃
┃
┃
┣
┃
┃
<role-name>
1回
ロール名称。

┃
┃
┃
┃
┗
<linked-to>
0または1回
cjaddsecコマンドで定義したロール名。
cjsetrespropで使用する場合，無視されます。

┣
┃
<env-entry>
0回以上
環境エントリについての定義。※5

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
環境エントリの説明。※5

┃
┃
┣
┃
<env-entry-name>
1回
環境エントリの名称。※5

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<env-entry-type>
1回
環境エントリのデータ型。※5
指定できる文字列を次に示します。

java.lang.Boolean

java.lang.Byte

java.lang.Short

java.lang.Integer

java.lang.Long

java.lang.Float

java.lang.Double

java.lang.String

java.lang.Charactor

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<env-entry-value>
1回
環境エントリの値。※5
env-entry-typeで指定した型に適合した値を指定します。
env-entry-typeにjava.lang.String以外を指定した場合，空文字の指定はできません。

┃
┃
┃
┗
<injection-target>
0回以上
Dependency Injectionの設定。※5

┃
┃
┃

┣
┃
┃
<injection-target-class>
1回
injectionの対象となるクラス名。※5
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃

┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※5

┣
┃
┃
┃
<ejb-ref>
0回以上
リモートインタフェースを持つEnterprise Beanへの参照情報についての定義。※6

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
ejb-refの説明。※6

┃
┃
┃
┣
┃
┃
<ejb-ref-name>
1回
ejb-refの名称。※6

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<ejb-ref-type>
1回
リンク先のEnterprise Beanの種別。※6
指定できる文字列を次に示します。

Entity

Session

┃
┃
┣
┃
<home>
1回
リンク先のHomeインタフェースクラス名。※6

┃
┃
┣
┃
<remote>
1回
リンク先のComponentインタフェースクラス名。※6

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<ejb-link>
0または1回
リンク先のejb-name。※6
ネーミングの切り替え機能でリンク先を設定する場合，次の形式で指定します。

corbaname::<名前空間のホスト名>:<名前空間のポート番号>#<EJBHomeオブジェクトリファレンスのJNDI名>

┃
┃
┗
<injection-target>
0回以上
Dependency Injectionの設定。※5

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<injection-target-class>
1回
injectionの対象となるクラス名。※5
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃

┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※5

┣
┃
┃
┃
<ejb-local-ref>
0回以上
ローカルインタフェースを持つEnterprise Beanへの参照情報についての定義。※6

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
ejb-local-refの説明。※6

┃
┃
┃
┣
┃
┃
<ejb-ref-name>
1回
ejb-local-refの名称。※6

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<ejb-ref-type>
1回
リンク先のEnterprise Beanの種別。※6
指定できる文字列を次に示します。

Entity

Session

┃
┃
┣
┃
<local-home>
1回
リンク先のEnterprise BeanのLocal Homeインタフェース名。※6

┃
┃
┣
┃
<local>
1回
リンク先のEnterprise BeanのLocal Componentインタフェース名。※6

┃
┃
┃
┣
┃
┃
<ejb-link>
0または1回
リンク先のejb-name。※6

┃
┃
┃
┃
┗
<injection-target>
0回以上
Dependency Injectionの設定。※5

┃
┃
┃

┣
┃
┃
<injection-target-class>
1回
injectionの対象となるクラス名。※5
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃

┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※5

┣
┃
<resource-ref>
0回以上
リソース参照についての定義。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
resource-refの説明。※6

┃
┃
┃
┣
┃
┃
<res-ref-name>
1回
resource-refの名称。※6

┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<res-type>
1回
リソース種別。※6
参照先がConnector1.5のリソースアダプタの場合，参照先リソースアダプタのコネクション定義識別子(<connectionfactory-interface>タグの設定値)を指定します。

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<res-auth>
1回
認証方式。※6
指定できる文字列を次に示します。

Application

Container

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<res-sharing-scope>
0または1回
参照したリソースを共有するかどうかを指定します。※6
指定できる文字列を次に示します。

Shareable

Unshareable

┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<mapped-name>
0または1回
対応するリソースアダプタ表示名またはメール表示名。※5
<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃
┃
┣
┃
<injection-target>
0回以上
Dependency Injectionの設定。※5

┃
┃
┃
┃
┃
┃
┣
┃
┃
<injection-target-class>
1回
injectionの対象となるクラス名。※5
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃
┃
┃
┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※5

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
対応するリソースアダプタ表示名，データソース表示名またはメール表示名を指定します。※6
リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって異なります。

Connector1.0以前

<リソースアダプタの表示名>

Connector1.5以降のOutboundリソースアダプタ

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

<コネクション定義識別子>とは，ra.xmlの<connectionfactory-interface>タグで指定した値のことです。

クラスタコネクションプールのメンバリソースアダプタは指定できません。
cjsetrespropで使用する場合は無視されます。

┣
┃
┃
┃
<resource-env-ref>
0回以上
リソース環境変数についての定義。※6

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※1
resource-env-refの説明。※6

┃
┃
┃
┣
┃
┃
<resource-env-ref-name>
1回
resource-env-refの名称。※6

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<resource-env-ref-type>
1回
リソース環境変数の値のクラスタイプ。※6
指定できる文字列を次に示します。

javax.jms.Queue

javax.jms.Topic

javax.transaction.UserTransaction

javax.ejb.TimerService

javax.ejb.EJBContext

JavaBeansリソースのクラス名

javax.transaction.UserTransaction，javax.ejb.TimerService，javax.ejb.EJBContextは，アノテーションを使用した場合にだけ出力されます。ただし，この値を設定することはできません。
<linked-adminobject>を指定した場合は，任意のクラス名が表示されます。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<mapped-name>
0または1回
<resource-env-ref-type>が「javax.jms.Queue」の場合，対応するキュー※5を次の形式で表示します。
"<リソースアダプタの表示名>#<Queue名称>"
<linked-Queue>タグと同時に指定した場合は，<linked-Queue>タグが有効となります。
<resource-env-ref-type>が「JavaBeansリソースのクラス名」の場合，対応するJavaBeansリソースの表示名を表示します。<linked-to>タグと同時に指定した場合は，<linked-to>タグが有効となります。

┃
┃
┃
┃
┣
┃
┃
┃
<injection-target>
0回以上
Dependency Injectionの設定。※5

┃
┃
┃
┃
┃
┃
┣
┃
┃
<injection-target-class>
1回
injectionの対象となるクラス名。※5
パッケージが定義されている場合は，そのパッケージから表示します。

┃
┃
┃
┃
┗
<injection-target-name>
1回
指定したクラスのinjection対象となる識別子。※5

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
<linked-queue>
0または1回
対応するデータソース表示名またはメール表示名。※6
cjsetrespropで使用する場合は無視されます。
<resource-env-ref-type>に「javax.jms.Queue」が指定された場合だけ有効となります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<resource-adapter>
1回
リソースアダプタの表示名を指定します。※6
Connector1.5のリソースアダプタは指定できません。

┃
┃
┃
┃
┃
┃
┗
<queue>
1回
キューの表示名を指定します。※6

┃
┃
┃
┣
┃
┃
<linked-adminobject>
0または1回
管理対象オブジェクト。
cjsetrespropでは無視されます。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<resource-adapter-name>
1回
リソースアダプタの表示名を指定します。
Connector1.0以前のリソースアダプタは指定できません。

┃
┃
┃
┃
┗
<adminobject-name>
1回
管理対象オブジェクト名を指定します。

┃
┃
┃
┃
┃
┃
┃
┃
┗
<linked-to>
0または1回
JavaBeansリソースの表示名を指定します。※6
<resource-env-ref-type>に「JavaBeansリソースのクラス名」が指定された場合だけ有効となります。
cjsetrespropで使用する場合は無視されます。

┣
┃
┃
┃
┃
<locale-encoding-mapping-list>
0回以上※1
ロケールとエンコーディング方法のマッピングの設定。
Servlet2.3以前のWARに対して，このタグを指定できません。

┃
┃
┃
┃
┗
<locale-encoding-mapping>
1回以上
ロケールとエンコーディング方法のマッピングの設定。

┃
┃
┃

┣
┃
┃
<locale>
1回
ロケールを記述。

┃
┃
┃

┗
<encoding>
1回
エンコード方法を記述。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<runtime>
0または1回

cjsetapppropで使用する場合

必須

cjsetrespropで使用する場合

無視されます。

┃
┃
┃
┃
┃
┃
┃
┗
<context-root>
1回
コンテキストルート。
指定できる文字は，URI（RFC3986）で使用できる文字です。ルート指定時は，空文字列またはスラッシュ（/）を指定してください。

┣
┃
┃
┃
┃
┃
<thread-control>
0または1回
スレッド制御グループの設定。
cjsetrespropで使用する場合は無視されます。

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<thread-control-max-threads>
1回
Webアプリケーション単位の最大同時実行スレッド数。
占有スレッド数以上の値を指定してください。
1～1024

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<thread-control-exclusive-threads>
1回
占有スレッド数。
Webアプリケーション単位の最大同時実行スレッド数以下の値を指定してください。
0～1024

┃
┃
┃
┣
┃
┃
<thread-control-queue-size>
1回
実行待ちキューサイズ。
0～2147483647

┃
┃
┃
┃
┣
┃
┃
┃
<resource-watcher>
1回
リクエスト実行待ちキュー格納数の監視に関するプロパティ。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<watcher-threshold>
1回
アラートメッセージを出力するしきい値。
1～100の整数値（単位：%）を指定します。デフォルトは80です。

┃
┃
┃
┃
┃
┃
┣
┃
┃
<watcher-interval>
1回
監視間隔。
1～2147483647の整数値（単位：秒）で指定します。デフォルトは30です。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<watcher-enabled>
1回
リクエスト実行待ちキュー格納数の監視を有効にするかどうかの指定。
指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。ただし，thread-control-queue-sizeに0を指定した場合，監視は無効となります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<watcher-writefile-enabled>
1回
リソース使用状況をファイルに出力するかどうかの指定。
指定できる文字列を次に示します。

true（出力する）

false（出力しない）

デフォルトはtrueです。

┃
┃
┃
┃
┗
<urlgroup-thread-control>
0回以上
URLグループ単位の同時実行スレッド数制御。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<urlgroup-thread-control-name>
1回
URLグループ単位の同時実行スレッド数制御の定義名。
URLグループ単位の同時スレッド数制御の定義名にはWebアプリケーション内で一意となる文字列を指定します。英数字（0～9，A～Z，a～z），ハイフン（-）およびアンダースコア（_）が使用できます。文字列の長さは1≦文字列長≦64で指定してください。

┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<urlgroup-thread-control-max-threads>
1回
URLグループ単位の最大同時実行スレッド数。
1～thread-control-max-threadsの整数値を指定します。デフォルトはthread-control-max-threadsの値です。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<urlgroup-thread-control-exclusive-threads>
1回
URLグループ単位の占有スレッド数。
指定できる値は，0～urlgroup-thread-control-max-threadsかつthread-control-exclusive-threads以下です。なお，<urlgroup-thread-control>を定義している場合は次の設定範囲を満たす必要があります。

thread-control-max-threads ≠ thread-control-exclusive-threadsの場合　thread-control-exclusive-threads　≧ urlgroup-thread-control-exclusive-threadsの総和。

thread-control-max-threads ＝ thread-control-exclusive-threadsの場合　thread-control-exclusive-threads　＞ urlgroup-thread-control-exclusive-threadsの総和。

デフォルトは0です。

┃
┃
┃
┃

┣
┃
┃
┃
<urlgroup-thread-control-queue-size>
1回
URLグループ単位の実行待ちキューのサイズ。
指定できる値は，0～2147483647の整数値です。デフォルトは8192です。

┃
┃
┃
┃

┣
┃
┃
┃
<urlgroup-thread-control-mapping>
0回以上
制御対象となるURLのマッピング情報。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<url-pattern>
1回
制御対象となるURLパターン。
一つのWebアプリケーション内で同じURLパターンを指定することはできません。指定例を次に示します。

/soda/grape/*

/foo/*

/contents

*.foo

┃
┃
┃

┗
<stats-monitor>
1回
稼働統計の設定。

┃
┃
┃

┗
<waiting-request-count>
1回
実行待ちリクエスト数を監視。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<enabled>
1回
実行待ちリクエスト数の監視のしきい値イベントを有効にするかどうかの指定。
指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。

┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
<high-threshold>
1回
しきい値イベントを出力する上限しきい値。
指定できる値は，1～100の整数値（単位：%）です。なお，low-threshold以上の値を指定してください。デフォルトは80です。

┃
┃
┃
┃
┃
┃

┗
<low-threshold>
1回
しきい値イベントを出力する下限しきい値。
指定できる値は，0～99の整数値（単位：%）です。なお，high-threshold以下の値を指定してください。デフォルトは0です。

┣
┃
<http-request>
0または1回
－

┃
┃
┃
┃
┃
┃
┗
<encoding>
0または1回
リクエストボディ，およびクエリのデコードに使用するデフォルトのエンコーディングを指定します。
JavaVMがサポートしている文字エンコーディングを指定します。※7
デフォルトは指定なしです。

┣
┃
<http-response>
0または1回
－

┃
┃
┃
┃
┃
┃
┗
<encoding>
0または1回
レスポンスボディのエンコードに使用するデフォルトのエンコーディングを指定します。
JavaVMがサポートしている文字エンコーディングを指定します。※7
デフォルトは指定なしです。

┣
┃
<jsp>
0または1回
－

┃
┃
┃
┃
┃
┃
┗
<page-encoding>
0または1回
JSPファイルの読み込みに使用するデフォルトのエンコーディングを指定します。
JavaVMがサポートしている文字エンコーディングを指定します。※7
デフォルトは指定なしです。

┣
┃
<http-session>
0または1回
－

┃
┃
┃
┃
┣
┃
┃
┃
<http-session-max-number>
1回
使用可能なHttpSessionの最大数。
指定できる値は，-1～2147483647の整数値です。-1を指定した場合は無制限となります。デフォルトは，-1です。

┃
┃
┗
<resource-watcher>
1回
HttpSession数の監視に関するプロパティを設定。

┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
<watcher-threshold>
1回
アラートメッセージを出力するしきい値。
指定できる値は，1～100の整数値（単位：%）です。デフォルトは80です。

┃
┃
┃
┃

┣
┃
┃
┃
<watcher-interval>
1回
監視間隔。
指定できる値は，1～2147483647の整数値（単位：秒）です。デフォルトは30です。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<watcher-enabled>
1回
HttpSession数の監視を有効にするかどうかの指定。
指定できる文字列を次に示します。

true（有効にする）

false（無効にする）

デフォルトはtrueです。ただし，http-session-max-numberに0を指定した場合，監視は無効となります。

┃
┃
┃
┃
┃
┃
┃

┗
<watcher-writefile-enabled>
1回
リソース使用状況をファイルに出力するかどうかの指定。指定できる文字列を次に示します。

true（出力する）

false（出力しない）

デフォルトはtrueです。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<start-notify-error>
0または1回
J2EEアプリケーション開始時にエラー通知をするかどうかの指定。
J2EEアプリケーションの開始時に，load-on-startupが指定されているサーブレット/JSPの初期化処理中や，taglibの解析中にエラーが発生した場合，エラーを通知してアプリケーションの開始を中断するかどうかを指定します。
指定できる文字列を次に示します。

true（エラーを通知する）

false（エラーを通知しない）

デフォルト値はtrueです。

┗
<start-order>
0または1回
J2EEアプリケーション開始時および停止時の順番。
開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。
0≦start-order≦2147483647

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

Servlet2.3以前のWARに対して，このタグを複数指定できません。

注※3

mime-mappingタグで指定する拡張子とMIMEタイプの対応づけのデフォルト値については，「付録B.1　拡張子とMIMEタイプの対応づけ」を参照してください。

注※4

error-codeまたはexception-typeのどちらかです。

注※5

cjgetappprop，cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※6

アノテーションの設定値の場合は，値の変更をしてはいけません。

注※7

デフォルトの文字エンコーディングとして設定できる文字は，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また，指定できる文字列は，java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング，およびそれらの別名になります。

5.8.2　DDとの対応

WAR属性ファイルとDeployment Descriptorの対応を次に示します。

WAR属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-war-property>
1回
<web-app>
1回

┣
┃
<description>
0回以上
┣
┃
<description>
0回以上

┣
┃
<display-name>
1回以上
┣
┃
<display-name>
0回以上

┣
┃
<icon>
0回以上
┣
┃
<icon>
0回以上

┃
┃
┣
┃
<small-icon>
0または1回
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回
┃
┃
┗
<large-icon>
0または1回

┣
┃
<distributable>
0または1回
┣
┃
<distributable>
0回以上

┣
┃
<context-param>
0回以上
┣
┃
<context-param>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<param-name>
1回
┃
┃
┣
┃
<param-name>
1回

┃
┃
┗
<param-value>
1回
┃
┃
┗
<param-value>
1回

┣
┃
<filter-mapping>
0回以上
┣
┃
<filter-mapping>
0回以上

┃
┃
┣
┃
<filter-name>
1回
┃
┃
┣
┃
<filter-name>
1回

┃
┃
┣
┃
<url-pattern>※1
1回
┃
┃
┣
┃
<url-pattern>※1
1回

┃
┃
┣
┃
<servlet-name>※1
1回
┃
┃
┣
┃
<servlet-name>※1
1回

┃
┃
┗
<dispatcher>
0または4回以下
┃
┃
┗
<dispatcher>
0または4回以下

┣
┃
<listener>
0回以上
┣
┃
<listener>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<display-name>
0回以上
┃
┃
┣
┃
<display-name>
0回以上

┃
┃
┣
┃
<icon>
0回以上
┃
┃
┣
┃
<icon>
0回以上

┃
┃
┃
┃
┣
┃
<small-icon>
0または1回
┃
┃
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┃
┃
┗
<large-icon>
0または1回
┃
┃
┃
┃
┗
<large-icon>
0または1回

┃
┃
┗
<listener-class>
1回
┃
┃
┗
<listener-class>
1回

┃
┃
┃
－
－
┃
┃
┃
(省略)
－

┣
┃
<session-config>
0回以上
┣
┃
<session-config>
0回以上

┃
┃
┗
<session-timeout>
0または1回
┃
┃
┗
<session-timeout>
0または1回

┣
┃
<mime-mapping>
0回以上
┣
┃
<mime-mapping>
0回以上

┃
┃
┣
┃
<extension>
1回
┃
┃
┣
┃
<extension>
1回

┃
┃
┗
<mime-type>
1回
┃
┃
┗
<mime-type>
1回

┣
┃
<welcome-file-list>
0回以上
┣
┃
<welcome-file-list>
0回以上

┃
┃
┗
<welcome-file>
1回以上
┃
┃
┗
<welcome-file>
1回以上

┣
┃
<error-page>
0回以上
┣
┃
<error-page>
0回以上

┃
┃
┣
┃
<error-code>
1回※2
┃
┃
┣
┃
<error-code>
1回※2

┃
┃
┣
┃
<exception-type>
1回※2
┃
┃
┣
┃
<exception-type>
1回※2

┃
┃
┗
<location>
1回
┃
┃
┗
<location>
1回

┣
┃
<jsp-config>
0回以上
┣
┃
<jsp-config>
0回以上

┃
┃
┣
┃
<taglib>
0回以上
┃
┃
┣
┃
<taglib>
0回以上

┃
┃
┃
┃
┣
┃
<taglib-uri>
1回
┃
┃
┃
┃
┣
┃
<taglib-uri>
1回

┃
┃
┃
┃
┗
<taglib-location>
1回
┃
┃
┃
┃
┗
<taglib-location>
1回

┃
┃
┗
<jsp-property-group>
0回以上
┃
┃
┗
<jsp-property-group>
0回以上

┃
┃

┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<display-name>
0回以上
┃
┃

┣
┃
<display-name>
0回以上

┃
┃

┣
┃
<icon>
0回以上
┃
┃

┣
┃
<icon>
0回以上

┃
┃

┃
┃
┣
┃
<small-icon>
0または1回
┃
┃

┃
┃
┣
┃
<small-icon>
0または1回

┃
┃

┃
┃
┗
<large-icon>
0または1回
┃
┃

┃
┃
┗
<large-icon>
0または1回

┃
┃

┣
┃
<url-pattern>
1回以上
┃
┃

┣
┃
<url-pattern>
1回以上

┃
┃

┣
┃
<el-ignored>
0または1回
┃
┃

┣
┃
<el-ignored>
0または1回

┃
┃

┣
┃
<page-encoding>
0または1回
┃
┃

┣
┃
<page-encoding>
0または1回

┃
┃

┣
┃
<scripting-invalid>
0または1回
┃
┃

┣
┃
<scripting-invalid>
0または1回

┃
┃

┣
┃
<is-xml>
0または1回
┃
┃

┣
┃
<is-xml>
0または1回

┃
┃

┣
┃
<include-prelude>
0回以上
┃
┃

┣
┃
<include-prelude>
0回以上

┃
┃

┗
<inclede-coda>
0回以上
┃
┃

┗
<inclede-coda>
0回以上

┣
┃
<taglib>
1回
┣
┃
<taglib>
1回

┃
┃
┣
┃
<taglib-uri>
1回
┃
┃
┣
┃
<taglib-uri>
1回

┃
┃
┗
<taglib-location>
1回
┃
┃
┗
<taglib-location>
1回

┣
┃
<security-constraint>
0回以上
┣
┃
<security-constraint>
0回以上

┃
┃
┣
┃
<display-name>
0回以上
┃
┃
┣
┃
<display-name>
0回以上

┃
┃
┣
┃
<web-resource-collection>
1回以上
┃
┃
┣
┃
<web-resource-collection>
1回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<web-resource-name>
1回
┃
┃
┃
┃
┣
┃
<web-resource-name>
1回

┃
┃
┃
┃
┣
┃
<url-pattern>
0回以上
┃
┃
┃
┃
┣
┃
<url-pattern>
1回以上

┃
┃
┃
┃
┗
<http-method>
0回以上
┃
┃
┃
┃
┗
<http-method>
0回以上

┃
┃
┣
┃
<auth-constraint>
0または1回
┃
┃
┣
┃
<auth-constraint>
0または1回

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┗
<role-name>
0回以上
┃
┃
┃
┃
┗
<role-name>
0回以上

┃
┃
┣
┃
<user-data-constraint>
0または1回
┃
┃
┗
<user-data-constraint>
0または1回

┃
┃
┃
┃
┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃
┃
┃
┗
<transport-guarantee>
1回
┃
┃

┗
<transport-guarantee>
1回

┃
┃
┗
<original-name>
1回
┃
┃

－
－

┣
┃
<login-config>
0回以上
┣
┃
<login-config>
0回以上

┃
┃
┣
┃
<auth-method>
0または1回
┃
┃
┣
┃
<auth-method>
0または1回

┃
┃
┣
┃
<realm-name>
0または1回
┃
┃
┣
┃
<realm-name>
0または1回

┃
┃
┗
<form-login-config>
0または1回
┃
┃
┗
<form-login-config>
0または1回

┃
┃

┣
┃
<form-login-page>
1回
┃
┃

┣
┃
<form-login-page>
1回

┃
┃

┗
<form-error-page>
1回
┃
┃

┗
<form-error-page>
1回

┣
┃
<security-role>
0回以上
┣
┃
<security-role>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<role-name>
1回
┃
┃
┗
<role-name>
1回

┃
┃
┗
<linked-to>
0または1回
┃
┃

－
－

┣
┃
<env-entry>
0回以上
┣
┃
<env-entry>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<env-entry-name>
1回
┃
┃
┣
┃
<env-entry-name>
1回

┃
┃
┣
┃
<env-entry-type>
1回
┃
┃
┣
┃
<env-entry-type>
1回

┃
┃
┣
┃
<env-entry-value>
1回
┃
┃
┗
<env-entry-value>
0または1回

┃
┃
┗
<injection-target>
0回以上
┃
┃

－
－

┃
┃

┣
┃
<injection-target-class>
1回
┃
┃

－
－

┃
┃

┗
<injection-target-name>
1回
┃
┃

－
－

┣
┃
<ejb-ref>
0回以上
┣
┃
<ejb-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-ref-name>
1回
┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回
┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<home>
1回
┃
┃
┣
┃
<home>
1回

┃
┃
┣
┃
<remote>
1回
┃
┃
┣
┃
<remote>
1回

┃
┃
┣
┃
<ejb-link>
0または1回
┃
┃
┗
<ejb-link>
0または1回

┃
┃
┗
<injection-target>
0回以上
┃
┃

－
－

┃
┃

┣
┃
<injection-target-class>
1回
┃
┃

－
－

┃
┃

┗
<injection-target-name>
1回
┃
┃

－
－

┣
┃
<ejb-local-ref>
0回以上
┣
┃
<ejb-local-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<ejb-ref-name>
1回
┃
┃
┣
┃
<ejb-ref-name>
1回

┃
┃
┣
┃
<ejb-ref-type>
1回
┃
┃
┣
┃
<ejb-ref-type>
1回

┃
┃
┣
┃
<local-home>
1回
┃
┃
┣
┃
<local-home>
1回

┃
┃
┣
┃
<local>
1回
┃
┃
┣
┃
<local>
1回

┃
┃
┣
┃
<ejb-link>
0または1回
┃
┃
┗
<ejb-link>
0または1回

┃
┃
┗
<injection-target>
0回以上
┃
┃

－
－

┃
┃

┣
┃
<injection-target-class>
1回
┃
┃

－
－

┃
┃

┗
<injection-target-name>
1回
┃
┃

－
－

┣
┃
<resource-ref>
0回以上
┣
┃
<resource-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<res-ref-name>
1回
┃
┃
┣
┃
<res-ref-name>
1回

┃
┃
┣
┃
<res-type>
1回
┃
┃
┣
┃
<res-type>
1回

┃
┃
┣
┃
<res-auth>
1回
┃
┃
┣
┃
<res-auth>
1回

┃
┃
┣
┃
<res-sharing-scope>
0または1回
┃
┃
┗
<res-sharing-scope>
0または1回

┃
┃
┣
┃
<mapped-name>
0または1回
┃
┃

－
－

┃
┃
┣
┃
<injection-target>
0回以上
┃
┃

－
－

┃
┃
┃
┃
┣
┃
<injection-target-class>
1回
┃
┃

－
－

┃
┃
┃
┃
┗
<injection-target-name>
1回
┃
┃

－
－

┃
┃
┗
<linked-to>
0または1回
┃
┃

－
－

┣
┃
<resource-env-ref>
0回以上
┣
┃
<resource-env-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<resource-env-ref-name>
1回
┃
┃
┣
┃
<resource-env-ref-name>
1回

┃
┃
┣
┃
<resource-env-ref-type>
1回
┃
┃
┗
<resource-env-ref-type>
1回

┃
┃
┣
┃
<mapped-name>
0または1回
┃
┃

－
－

┃
┃
┣
┃
<injection-target>
0回以上
┃
┃

－
－

┃
┃
┃
┃
┣
┃
<injection-target-class>
1回
┃
┃

－
－

┃
┃
┃
┃
┗
<injection-target-name>
1回
┃
┃

－
－

┃
┃
┣
┃
<linked-queue>
0または1回
┃
┃

－
－

┃
┃
┃
┃
┣
┃
<resource-adapter>
1回
┃
┃

－
－

┃
┃
┃
┃
┗
<queue>
1回
┃
┃

－
－

┃
┃
┗
<linked-adminobject>
0または1回
┃
┃

－
－

┃
┃

┣
┃
<resourceadapter-name>
1回
┃
┃

－
－

┃
┃

┗
<adminobject-name>
1回
┃
┃

－
－

┣
┃
<locale-encoding-mapping-list>
0回以上
┗
<locale-encoding-mapping-list>
0回以上

┃
┃
┗
<locale-encoding-mapping>
1回以上

┗
<locale-encoding-mapping>
1回以上

┃
┃

┣
┃
<locale>
1回

┣
┃
<locale>
1回

┃
┃

┗
<encoding>
1回

┗
<encoding>
1回

┗
<runtime>
0または1回

－
－

┗
<context-root>
1回

－
－

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※1

<url-pattern>と<servlet-name>のどちらか一つを指定します。

注※2

<error-code>と<exception-type>のどちらか一つを指定します。

5.9　フィルタ属性ファイル

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

＜この節の構成＞

5.9.1　フィルタ属性ファイルの指定内容

5.9.2　DDとの対応

5.9.1　フィルタ属性ファイルの指定内容

フィルタ属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-filter-property PUBLIC '-//Hitachi, Ltd.//DTD Filter Property 7.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-filter-property_7_0.dtd'>

フィルタ属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-filter-property>
1回
ルートタグ。

┣
┃
<description>※1
0回以上※2
フィルタの説明。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<display-name>※1
1回以上※2
フィルタの表示名。
xml:lang属性が"en"のdisplay-nameを必ず指定します。当該リソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。
1≦文字列長
xml:lang属性が"en"のタグの場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。
xml:lang属性が"en"のタグ以外の場合，文字の制限はありません。
複数のフィルタが存在する場合，それぞれに一意となる文字列を指定します。

┣
┃
┃
<icon>※1
0回以上※2
Deployツール上に表示されるフィルタのアイコンの定義。

┃
┃
┣
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。

┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。

┣
┃
┃
┃
<filter-name>
1回
フィルタ名称。※3
複数のフィルタが存在する場合，それぞれ一意となる文字列を指定します。

┣
┃
┃
┃
<filter-class>
1回
フィルタのクラス名。※3
パッケージが定義されている場合，パッケージ名から指定します。

┣
┃
<init-param>
0回以上
初期化パラメタについての定義。

┃
┃
┣
┃
<description>※1
0回以上※2
パラメタの説明。

┃
┃
┃
┃
┣
┃
┃
┃
<param-name>
1回
初期化パラメタ名称。
複数のフィルタ名が存在する場合，それぞれに一意な文字列を指定します。

┃
┗
<param-value>
1回
初期化パラメタの値。

┗
<method-observation-timeout>
0または1回
フィルタ内のメソッド共通の仕掛かり中メソッド監視用タイムアウト時間。
指定できる値は，0～86400（単位：秒）です。0を指定した場合，タイムアウトしません。デフォルト値は0です。

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

Servlet2.3以前のWARに対して，このタグを複数指定できません。

注※3

cjgetappprop，cjgetrespropコマンドで出力されたものに対して，タグ名の変更，タグの追加・削除，または値の変更をしてはいけません。

5.9.2　DDとの対応

フィルタ属性ファイルとDeployment Descriptorの対応を次に示します。

フィルタ属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-filter-property>
1回
<web-app>
1回

┃
┃
(省略)
－
┃
┃
(省略)
－

┃
┃
－
－
┗
<filter>
0回以上

┣
┃
<icon>
0回以上

┣
┃
<icon>
0回以上

┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回

┣
┃
<filter-name>
1回

┣
┃
<filter-name>
1回

┣
┃
<display-name>
1回以上

┣
┃
<display-name>
0回以上

┣
┃
<description>
0回以上

┣
┃
<description>
0回以上

┣
┃
<filter-class>
1回

┣
┃
<filter-class>
1回

┗
<init-param>
0回以上

┗
<init-param>
0回以上

┣
┃
<param-name>
1回

┣
┃
<param-name>
1回

┣
┃
<param-value>
1回

┣
┃
<param-value>
1回

┗
<description>
0回以上

┗
<description>
0回以上

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

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

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

＜この節の構成＞

5.10.1　サーブレット属性ファイルの指定内容

5.10.2　DDとの対応

5.10.1　サーブレット属性ファイルの指定内容

サーブレット属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-servlet-property PUBLIC '-//Hitachi, Ltd.//DTD Servlet Property 7.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-servlet-property_7_0.dtd'>

サーブレット属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-servlet-property>
1回
ルートタグ。

┣
┃
<description>※1
0回以上※2
サーブレット/JSPの説明。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<display-name>※1
1回以上※2
サーブレット/JSPの表示名。
xml:lang属性が"en"のdisplay-nameを必ず指定します。当該リソースの表示名をコマンドの引数で指定する場合も，xml:lang属性が"en"のdisplay-nameを指定します。
1≦文字列長
xml:lang属性が"en"のタグの場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。
xml:lang属性が"en"のタグ以外の場合，文字の制限はありません。

┣
┃
┃
┃
<icon>※1
0回以上※2
Deployツール上に表示されるServletのアイコンの定義。

┃
┃
┃
┃
┣
┃
┃
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。

┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。

┣
┃
<init-param>
0回以上
初期化パラメタについての定義。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上※2
init-paramの説明。

┃
┃
┃
┣
┃
┃
<param-name>
1回
初期化パラメタの名称。

┃
┃
┃
┗
<param-value>
1回
初期化パラメタの値。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<load-on-startup>
0または1回
スタートアップ時のロード指定。
指定できる整数値を次に示します。

-2147483648≦load-on-startup≦-1

必要になった時点でロードされます。

-1以外を指定しても-1として扱われます。

0

スタートアップ時にロードします。

ロードする順番は，Containerが決定します。

1≦load-on-startup≦2147483647

スタートアップ時にロードします。

ロードする順番は，小さな値から大きな値の順となります。

┣
┃
<run-as>
0または1回
実行時アイデンティティについての定義。

┃
┃
┣
┃
<description>※1
0回以上※2
run-asの説明。

┃
┃
┣
┃
<role-name>
1回
セキュリティロール名。

┃
┃
┗
<user-name>
1回
ユーザ名を指定します。

┣
┃
┃
<security-role-ref>
0回以上
セキュリティロールについての定義。

┃
┃
┣
┃
<description>※1
0回以上※2
security-role-refの説明。

┃
┃
┣
┃
<role-name>
1回
security-role-refの名称。

┃
┃
┗
<role-link>
0または1回
リンク先のロール名。

┣
┃
<url-pattern>
0回以上
サーブレットのURL。

┗
<method-observation-timeout>
0または1回
サーブレット内のメソッド共通の仕掛かり中メソッド監視用タイムアウト時間。
指定できる値は，0～86400（単位：秒）です。0を指定した場合，タイムアウトしません。デフォルト値は0です。

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

Servlet2.3以前のWARに対して，このタグを複数指定できません。

5.10.2　DDとの対応

サーブレット属性ファイルとDeployment Descriptorの対応を次に示します。

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

タグ名
出現パターン
タグ名
出現パターン

<hitachi-servlet-property>
1回
<web-app>
1回

┃
┃
┃
－
－
┃
┃
┃
(省略)
－

┃
┃
－
－
┣
┃
<servlet>
0回以上

┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┣
┃
<display-name>
1回以上
┃
┃
┣
┃
<display-name>
0回以上

┃
┃
－
－
┃
┃
┣
┃
<servlet-name>
1回

┣
┃
<icon>
0回以上
┃
┃
┣
┃
<icon>
0回以上

┃
┃
┣
┃
<small-icon>
0または1回
┃
┃
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回
┃
┃
┃
┃
┗
<large-icon>
0または1回

┃
┃
－
－
┃
┃
┣
┃
<servlet-class>※
1回

┃
┃
－
－
┃
┃
┣
┃
<jsp-file>※
1回

┣
┃
<init-param>
0回以上
┃
┃
┣
┃
<init-param>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<param-name>
1回
┃
┃
┃
┃
┣
┃
<param-name>
1回

┃
┃
┗
<param-value>
1回
┃
┃
┃
┃
┗
<param-value>
1回

┣
┃
<load-on-startup>
0または1回
┃
┃
┣
┃
<load-on-startup>
0または1回

┣
┃
<run-as>
0または1回
┃
┃
┣
┃
<run-as>
0または1回

┃
┃
┣
┃
<description>
0回以上
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┗
<role-name>
1回
┃
┃
┃
┃
┗
<role-name>
1回

┣
┃
<security-role-ref>
0回以上
┃
┃
┗
<security-role-ref>
0回以上

┃
┃
┣
┃
<description>
0回以上
┃
┃

┣
┃
<description>
0回以上

┃
┃
┣
┃
<role-name>
1回
┃
┃

┣
┃
<role-name>
1回

┃
┃
┗
<role-link>
0または1回
┃
┃

┗
<role-link>
0または1回

┃
┃
－
－
┗
<servlet-mapping>
0回以上

┃
┃
－
－

┣
┃
<servlet-name>
1回

┗
<url-pattern>
0回以上

┗
<url-pattern>
1回

－
－

(省略)
－

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

注※

<servlet-class>と<jsp-file>のどちらか一つを指定します。

5.11　Connector属性ファイル

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

＜この節の構成＞

5.11.1　Connector属性ファイルの指定内容

5.11.2　<config-property>タグに指定できるプロパティ

5.11.3　<property>タグに指定できるプロパティ

5.11.4　Connector属性ファイルのテンプレートファイル

5.11.5　DDとの対応

5.11.1　Connector属性ファイルの指定内容

Connector属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-connector-property PUBLIC '-//Hitachi, Ltd.//DTD Connector Property 7.6//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-connector-property_7_6.dtd'>

Connector属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-connector-property>
1回
ルートタグ。

┣
┃
┃
┃
┃
<description>※1
0回以上※4
リソースアダプタDDについての説明。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<display-name>※1
1回以上※4
Deployツール上に表示されるリソースアダプタの名称。
1≦文字列長≦240
変更する場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。
また，リソースアダプタの名称は，マニュアル「Cosminexus　システム構築ガイド」のCosminexusの作業ディレクトリの説明を参照して見積もった範囲内の長さで指定してください。

┣
┃
┃
┃
┃
<icon>※1
0回以上※4
Deployツール上に表示されるリソースアダプタのアイコンの定義。

┃
┃
┃
┣
┃
┃
<small-icon>
0または1回
スモールアイコン（16×16）のファイル名。

┃
┃
┃
┗
<large-icon>
0または1回
ラージアイコン（32×32）のファイル名。

┣
┃
┃
<vendor-name>
1回
リソースアダプタプロバイダベンダ名。※2

┣
┃
┃
┃
<spec-version>
1回
リソースアダプタがサポートしているコネクタアーキテクチャ仕様のバージョン。※2

┣
┃
┃
<eis-type>
1回
EIS（Enterprise Information System）のタイプについての情報。※2

┣
┃
<version>
1回
リソースアダプタのバージョン。※2

┣
┃
┃
┃
<license>
0または1回
リソースアダプタモジュールのライセンス要求についての定義。

┃
┃
┃
┣
┃
┃
<description>※1
0回以上
licenseについての説明。

┃
┃
┃
┃
┃
┗
<license-required>
1回
リソースアダプタのデプロイ，使用時のライセンス要求用フラグ。
指定できる値は，「true」または「false」のどちらかです。※2

┣
┃
<resourceadapter>
1回
リソースアダプタについての情報。

┃
┃
┃
┃
┣
┃
┃
┃
<resourceadapter-class>
0または1回
javax.resource.spi.ResourceAdapterを実装したJavaクラス名。※2

┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<config-property>※3
0回以上
ResourceAdapterインスタンスのためのコンフィグレーションプロパティの定義。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<description>※3
0回以上
コンフィグレーションプロパティについての説明。

┃
┃
┃
┃
┣
┃
<config-property-name>※3
1回
コンフィグレーションプロパティの名称。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<config-property-type>※3
1回
ResourceAdapterによって要求されるコンフィグレーションプロパティのJavaタイプ。
指定できる値を次に示します。

java.lang.Boolean

java.lang.String

java.lang.Integer

java.lang.Double

java.lang.Byte

java.lang.Short

java.lang.Long

java.lang.Float

java.lang.Character

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<config-property-value>※3
0または1回
コンフィグレーションプロパティの値。
<config-property-value>タグが指定されていない場合は，そのプロパティの情報は変更しません。すでに設定されている情報がそのまま残ります。
<config-property-value>タグを指定して，値を指定しない場合は，そのプロパティの情報に空が設定されます。
<config-property-value>タグを指定して，値を指定している場合は，指定した値がプロパティに設定されます。
<config-property-name>タグに「XAOpenString」が設定されていて，<config-property-value>タグに値が設定されている場合，セキュリティ上の理由で，<config-property-value>タグは表示されません。変更する場合は，<config-property-value>タグを追加して，変更後の値を設定してください。
cjgetresprop, cjgetrarprop実行時に，<config-property-name>タグに「XAOpenString」が設定されている場合，タグは次のように表示されます。

値が設定されている場合：

コメントタグ<!-- The config-property-value has already been set. -->

値が設定されていない場合：

空タグ<>

┃
┃
┣
┃
<outbound-resourceadapter>
0または1回
Outbound方向へのリソースアダプタの定義。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<connection-definition>
1回以上※4
コネクションインタフェースクラスに関する定義。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<managedconnectionfactory-class>
1回
javax.resource.spi.ManagedConnectionFactoryインタフェースを実装したJavaクラス名。※2
パッケージが定義されている場合は，パッケージから指定します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<config-property>
0回以上
ManagedConnectionFactoryインスタンスのためのコンフィグレーションプロパティの定義。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<description>
0以上※4
コンフィグレーションプロパティについての説明。

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
<config-property-name>
1回
コンフィグレーションプロパティの名称。※5

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<config-property-type>
1回
ManagedConnectionFactoryインスタンスによって要求されるコンフィグレーションプロパティのJavaタイプ。
指定できる値を次に示します。※5

java.lang.Boolean

java.lang.String

java.lang.Integer

java.lang.Double

java.lang.Byte

java.lang.Short

java.lang.Long

java.lang.Float

java.lang.Character

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<config-property-value>
0または1回
コンフィグレーションプロパティの値。※5
<config-property-value>タグが指定されていない場合は，そのプロパティの情報は変更しません。すでに設定されている情報がそのまま残ります。
<config-property-value>タグを指定して，値を指定しない場合は，そのプロパティの情報に空が設定されます。
<config-property-value>タグを指定して，値を指定している場合は，指定した値がプロパティに設定されます。
<config-property-name>タグに「XAOpenString」が設定されていて，<config-property-value>タグに値が設定されている場合，セキュリティ上の理由で，<config-property-value>タグは表示されません。変更する場合は，<config-property-value>タグを追加して，変更後の値を設定してください。
cjgetresprop, cjgetrarprop実行時に，<config-property-name>タグに「XAOpenString」が設定されている場合，タグは次のように表示されます。

値が設定されている場合：

コメントタグ<!-- The config-property-value has already been set. -->

値が設定されていない場合：

空タグ<>

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<connectionfactory-interface>
1回
リソースでサポートされるConnectionFactoryインタフェースのクラス名。※2
パッケージが定義されている場合は，パッケージから指定します。
Connector1.5のリソースアダプタの場合，このタグの値がコネクション定義識別子となります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
<connectionfactory-impl-class>
1回
ConnectionFactoryインタフェースを実装したJavaクラス名。※2
パッケージが定義されている場合は，パッケージから指定します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
<connection-interface>
1回
リソースアダプタでサポートされるConnectionインタフェースのクラス名。
パッケージが定義されている場合は，パッケージから指定します。※2

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
<connection-impl-class>
1回
Connectionインタフェースを実装したJavaクラス名。
パッケージが定義されている場合は，パッケージから指定します。※2

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<connector-runtime>
0または1回
コネクションインタフェースクラスの実行時情報。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<property>
0回以上
コネクションインタフェースクラスに関する独自情報。
<property>の指定が複数あり，<property-name>の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJW37600-W）が出力され，後ろに定義された<property>の<property-value>の値が有効になります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<property-name>
1回
プロパティ名。
指定できる値を次に示します。※6

MaxPoolSize

MinPoolSize

LogEnabled

User

Password

ValidationType

ValidationInterval

RetryCount

RetryInterval

ConnectionTimeout

SweeperInterval

RequestQueueEnable

RequestQueueTimeout

WatchEnabled

WatchInterval

WatchThreshold

WatchWriteFileEnabled

ConnectionPoolAdjustmentInterval

Warmup

NetworkFailureTimeout

┃
┃
┃
┃
┃
┃

┃
┃
┣
┃
<property-type>
1回
プロパティ値のJavaの型。※6

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<property-value>
0または1回
プロパティ値。※6
<property-value>タグが指定されていない場合，そのプロパティの情報は変更されません。すでに設定されている情報がそのまま残ります。
<property-value>タグが指定されており，値の指定がない場合は，そのプロパティの情報に空が設定されます。
<property-value>タグが指定されており，値が指定されている場合は，指定した値がプロパティに設定されます。
<property-name>タグに「User」または「Password」が設定されており，<property-value>タグに値が設定されている場合は，セキュリティ上の理由で表示されません。変更する場合は，<property-value>タグを追加して，変更後の値を設定してください。
cjgetresprop, cjgetrarprop実行時に，<property-name>タグに「User」または「Password」が設定されている場合，タグは次のように表示されます。

値が設定されている場合：

コメントタグ<!-- The property-value has already been set. -->

値が設定されていない場合：

空タグ<>

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┃
┃
┃
┃
┃
┃
┗
<property-default-value>
0または1回
プロパティ値のデフォルト値。※2
<property-value>タグに値が設定されている場合は<property-default-value>タグの値は無効です。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<resource-external-property>
0回以上
リソースのエクスターナルプロパティの定義。
<resource-external-property>の指定が複数あり，<optional-name>の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJW37600-W）が出力され，後ろに定義された<resource-external-property>の<res-auth>や<res-sharing-scope>の値が有効になります。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
<description>
0回以上※4
リソースの別名の説明。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<optional-name>
1回
リソースの別名。
設定する場合，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）および階層区切り文字としてスラッシュ（/）を使用できます。ただし，次の名前は指定できません。

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

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

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

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

文字列の前後に空白，改行がある場合はエラーとなりませんが，取り除かれます。文字列の途中に空白，改行がある場合はエラーとなります。
同一リソース内に<resource-external-property>の指定が複数あり，<optional-name>の指定値がほかの<optional-name>の指定値の下位階層となるような関係の場合は，ワーニングメッセージ（KDJE37602-W）が出力されます。
（例）
別名１：AAA
別名２：AAA/BBB
1≦文字列長≦255

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
<res-auth>
0または1回
リソースを使用するための認証元を，アプリケーション上で行うか，コンテナに任せるかの指定。
指定できる文字列を次に示します。

Application

Container

デフォルトはContainerです。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<res-sharing-scope>
0または1回
リソース接続を共有するかどうかの指定。
指定できる文字列を次に示します。

Shareable

Unshareable

デフォルトはShareableです。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
<transaction-support>
1回
リソースアダプタで提供されるトランザクションサポートのレベル。
指定できる値を次に示します。

NoTransaction

LocalTransaction

XATransaction

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┗
<reauthentication-support>
1回
ManagedConnectionインスタンスの再認証サポート用フラグ。
指定できる値は，「true」または「false」のどちらかです。

┃
┃
┣
┃
<inbound-resourceadapter>
0または1回
Inbound方向へのリソースアダプタの定義。

┃
┃
┃
┃
┗
<messageadapter>
0または1回
リソースアダプタのメッセージング関連の機能の定義。

┃
┃

┗
<messagelistener>
1回以上
メッセージリスナの定義。

┃
┃
┃
┃

┣
┃
<messagelistener-type>
1回
メッセージリスナのタイプ。

┃
┃
┃
┃

┗
<activationspec>
1回
メッセージエンドポイント活性化のための情報を表示。

┃
┃
┃
┃

┣
┃
<activationspec-class>
1回
ActivationSpecインタフェースを実装するクラスを表示。

┃
┃
┃
┃
┃
┃

┗
<required-config-property>
0回以上
メッセージエンドポイント活性化のために設定が必要なプロパティ。

┃
┃
┃
┃
┃
┃

┣
┃
┃
<description>※1
0回以上
メッセージエンドポイント活性化のために設定が必要なプロパティについての説明。

┃
┃
┃
┃
┃
┃
┃
┃

┗
<config-property-name>
1回
メッセージエンドポイント活性化のために設定が必要なプロパティの名称。

┃
┃
┣
┃
<adminobject>
0回以上
リソースアダプタが提供する管理対象オブジェクトについての定義。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
<adminobject-name>
0または1回
管理対象オブジェクト名。
リソースアダプタ内でユニークである必要があります。英数字（0～9，A～Z，a～z）およびアンダースコア（_）が使用できます。ただし，連続したアンダースコア（_）は使用できません。

┃
┃
┃
┃
┣
┃
<adminobject-interface>
1回
管理対象オブジェクトのクラスが実装するインタフェース。

┃
┃
┃
┃
┣
┃
<adminobject-class>
1回
管理対象オブジェクトのクラス。

┃
┃
┃
┃
┃
┃
┃
┗
<config-property>
0回以上
管理対象オブジェクトのためのコンフィグレーションプロパティの定義。

┃
┃
┃
┃

┣
┃
<description>※1
0回以上
コンフィグレーションプロパティについての説明。

┃
┃
┃
┃

┣
┃
<config-property-name>
1回
コンフィグレーションプロパティの名称。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<config-property-type>
1回
adminobjectインスタンスによって要求されるコンフィグレーションプロパティのJavaタイプ。
指定できる値を次に示します。

java.lang.Boolean

java.lang.String

java.lang.Integer

java.lang.Double

java.lang.Byte

java.lang.Short

java.lang.Long

java.lang.Float

java.lang.Character

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃

┗
<config-property-value>
0または1回
コンフィグレーションプロパティの値。cjsetrespropコマンド，およびcjsetrarpropコマンド実行時の動作を次に示します。

<config-property-value>タグ指定なしの場合：

プロパティの情報を空に設定する。

<config-property-value>タグが指定されていて，値が空の場合：

プロパティの情報を空に設定する。

<config-property-value>タグが指定されていて，値が指定されている場合：

プロパティに指定された値を設定する。

┃
┃
┃
┗
<security-permission>
0回以上
リソースアダプタのコードから要求されるセキュリティパーミッションについての定義。※2

┃
┃
┃
┃

┣
┃
┃
┃
<description>
0以上※4
セキュリティパーミッションについての説明。※2

┃
┃

┗
<security-permission-spec>
1回
セキュリティポリシーファイル上のセキュリティパーミッション。※2

┗
<resourceadapter-runtime>※3
0または1回
リソースアダプタの実行時情報。

┗
<property>※3
0回以上
リソースアダプタに関する独自情報。
<property>の指定が複数あり，<property-name>の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37600-W）が出力され，あとから定義された<property>の<property-value>の値が有効になります。

┣
┃
┃
┃
┃
┃
┃
┃
┃
<property-name>※3
1回
プロパティ名。
指定できる値を次に示します。

MaxTPoolSize

MinTPoolSize

TPoolKeepalive

┣
┃
<property-type>※3
1回
プロパティのタイプ。

┣
┃
┃
<property-value>※3
0または1回
プロパティ値のJava型。

┗
<property-default-value>※3
0または1回
プロパティ値のデフォルト値。※2

注※1

xml:lang属性を指定できます。xml:lang属性を指定しない場合は，「en（英語）」が仮定されます。なお，xml:lang属性が同じタグを複数指定できません。

注※2

cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※3

Connector 1.5の仕様に準拠するリソースアダプタに対してだけ指定できます。

注※4

Connector 1.0の仕様に準拠するリソースアダプタの場合，同じタグを複数指定できません。

注※5

<config-property>タグで指定できる値については，「5.11.2　<config-property>タグに指定できるプロパティ」を参照してください。

注※6

<property>タグに指定できる値については，「5.11.3　<property>タグに指定できるプロパティ」を参照してください。

5.11.2　<config-property>タグに指定できるプロパティ

<config-property>タグに指定できる値について説明します。

＜この項の構成＞

(1)　Cosminexus DABroker Libraryを使用して，OracleまたはHiRDBに接続する場合

(2)　HiRDB Type4 JDBC Driverを使用してHiRDBに接続する場合

(3)　Oracle JDBC Thin Driverを使用してOracleに接続する場合

(4)　SQL Server 2000 Driver for JDBCを使用して，SQL Server 2000に接続する場合

(5)　SQL Server 2005 JDBC Driverを使用して，SQL Server 2005に接続する場合

(6)　クラスタコネクションプールを使用してOracleに接続する場合（ルートリソースアダプタ）

(7)　クラスタコネクションプールを使用してOracleに接続する場合（メンバリソースアダプタ）

(1)　Cosminexus DABroker Libraryを使用して，OracleまたはHiRDBに接続する場合

DBConnector_DABJ_CP.rarまたはDBConnector_DABJ_CP_Cosminexus_RM.rar
トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。また，Cosminexus RMと連携する場合は，DBConnector_DABJ_CP_Cosminexus_RM.rarを使用します。
指定できるプロパティについては，表5-5を参照してください。

DBConnector_DABJ_XA.rarまたはDBConnector_DABJ_XA_Cosminexus_RM.rar
グローバルトランザクションを使用する場合に使用します。また，Cosminexus RMと連携する場合は，DBConnector_DABJ_XA_Cosminexus_RM.rarを使用します。
指定できるプロパティについては，表5-6を参照してください。

なお，Cosminexus DABroker Libraryで使用するAPIについては，マニュアル「Cosminexus　リファレンス　API編」を参照してください。

表5-5　DBConnector_DABJ_CP.rarまたはDBConnector_DABJ_CP_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

linkedResourceAdapterName
java.lang.String
連携するCosminexus RMリソースアダプタの表示名を指定します。
DBConnector_DABJ_CP_Cosminexus_RM.rarを使用する場合に指定できます。

networkProtocol
java.lang.String
Cosminexus DABroker Libraryとの接続種別を設定します。設定された値は，Cosminexus DABroker LibraryのsetNetworkProtocolメソッドに渡されます。

"lib"

databaseName
java.lang.String
接続するデータベースの種別を設定します。設定された値は，Cosminexus DABroker LibraryのsetDatabaseNameメソッドに渡されます。

HIRDB
HiRDBおよびXDM/RD E2に接続する場合に指定します。

ORACLE，ORACLE8I
Oracleに接続する場合に指定します。

DBConnector_DABJ_CP_Cosminexus_RM.rarの場合，デフォルト値はHIRDBです。

description
java.lang.String
接続するデータベースに必要な接続付加情報を設定します。設定された値は，Cosminexus DABroker LibraryのsetDescriptionメソッドに渡されます。

HIRDBの場合
HiRDBシステムのポート番号，またはHiRDBクライアントの環境変数グループ名を指定します。

ORACLEの場合
SQL*Netの接続文字列を指定します。

DBHostName
java.lang.String
接続するHiRDBのホスト名を設定します。設定された値は，Cosminexus DABroker LibraryのsetDBHostNameメソッドに渡されます。

loginTimeout
java.lang.Integer
データベースへの接続試行中に，データソースが待機する最長時間（単位：秒）を設定します。デフォルト値は0です。

serverName
java.lang.String
接続するCosminexus DABroker Libraryのホスト名またはIPアドレスを設定します。設定された値は，Cosminexus DABroker LibraryのsetServerNameメソッドに渡されます。

portNumber
java.lang.Integer
接続するCosminexus DABroker Libraryのポート番号を設定します。設定された値は，Cosminexus DABroker LibraryのsetPortNumberメソッドに渡されます。デフォルト値は40179です。

DBEnv
java.lang.String
Cosminexus DABroker Libraryの接続先データベース定義情報を設定します。設定された値は，Cosminexus DABroker LibraryのsetDBEnvメソッドに渡されます。

encodLang
java.lang.String
エンコード文字形態を設定します。設定された値は，Cosminexus DABroker LibraryのsetEncodLangメソッドに渡されます。

JDBC_IF_TRC
java.lang.Boolean
JDBCインタフェースメソッドトレースの取得の有無を設定します。設定された値は，Cosminexus DABroker LibraryのsetJDBC_IF_TRCメソッドに渡されます。

trueを指定した場合
トレースを取得します。

falseを指定した場合
トレースを取得しません。

なお，trueを指定した場合，Cosminexus Driverが出力するトレースは，Cosminexus Component ContainerからセットされるPrintWriterと，ユーザがコネクションファクトリ（javax.sql.DataSourceクラス）のsetLogWriter()メソッドで指定したPrintWriterに出力します。デフォルト値はfalseです。

SV_EVENT_TRC
java.lang.Boolean
Cosminexus DABroker Libraryとのイベントトレースの取得の有無を設定します。設定された値は，Cosminexus DABroker LibraryのsetSV_EVENT_TRCメソッドに渡されます。

trueを指定した場合
トレースを取得します。

falseを指定した場合
トレースを取得しません。

なお，trueを指定した場合，Cosminexus Driverが出力するトレースは，Cosminexus Component ContainerからセットされるPrintWriterと，ユーザがコネクションファクトリ（javax.sql.DataSourceクラス）のsetLogWriter()メソッドで指定したPrintWriterに出力します。デフォルト値はfalseです。

TRC_NO
java.lang.Integer
トレースのエントリ数を，10～1000の範囲で設定します。設定された値は，Cosminexus DABroker LibraryのsetTRC_NOメソッドに渡されます。デフォルト値は500です。

uapName
java.lang.String
アプリケーション名称を設定します。設定された値は，Cosminexus DABroker LibraryのsetUapNameメソッドに渡されます。

bufSize
java.lang.Integer
Cosminexus DABroker Libraryからの受信データのバッファ長を，1～16000の範囲（単位：キロバイト）で設定します。設定された値は，Cosminexus DABroker LibraryのsetBufSizeメソッドに渡されます。デフォルト値は64です。

rowSize
java.lang.Integer
Cosminexus DABroker LibraryがJDBCで取り扱うバッファ長を，16～512の範囲（単位：メガバイト）で設定します。設定された値は，Cosminexus DABroker LibraryのsetRowSizeメソッドに渡されます。デフォルト値は16です。

OSAuthorize
java.lang.Boolean
OS認証機能を使用してデータベースに接続するかどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetOSAuthorizeメソッドに渡されます。

trueを指定した場合
OS認証機能を使用します。

falseを指定した場合
OS認証機能を使用しません。

デフォルト値はfalseです。

HiRDBCursorMode
java.lang.Boolean
HiRDBで検索時にカーソルがCommit，またはRollbackにわたって有効かどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetHiRDBCursorModeメソッドに渡されます。

trueを指定した場合
カーソルは保持されます。アプリケーションは続けてFetchすることができます。

falseを指定した場合
カーソルはクローズされますが，ステートメントは有効です。アプリケーションは，Prepareしないで，再度Executeできます。

デフォルト値はfalseです。

blockUpdate
java.lang.Boolean
接続データベースがHiRDBの場合，？パラメタを使用したデータベースの更新で，複数のパラメタセットを一度に処理するかどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetBlockUpdateメソッドに渡されます。

trueを指定した場合
複数のパラメタセットを一度に処理します。

falseを指定した場合
複数のパラメタセットを一つずつ分割して処理します。

デフォルト値はfalseです。

executeDirectMode
java.lang.Boolean
接続データベースがHiRDBの場合，Statementクラスを使用したINSERT， UPDATE， DELETEなどのデータベースの更新で，HiRDBのEXECUTE DIRECT機能を使用するかどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetExecuteDirectModeメソッドに渡されます。

trueを指定した場合
Execute Direct機能を使用します。

falseを指定した場合
Execute Direct機能を使用しません。

デフォルト値はfalseです。

SQLWarningIgnore
java.lang.Boolean
データベースから返される警告をConnectionクラスで保持するかどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetSQLWarningIgnoreメソッドに渡されます。

trueを指定した場合
警告を保持しません。

falseを指定した場合
警告を保持します。

デフォルト値はfalseです。

LONGVARBINARY_Access
java.lang.String
LONGVARBINARY（列属性BLOB，列属性BINARY）のデータベースアクセス方法を設定します。設定された値は，Cosminexus DABroker LibraryのsetLONGVARBINARY_Accessメソッドに渡されます。

REAL

LOCATOR

デフォルト値はREALです。

bufferPoolSize
java.lang.Integer
受信データのバッファをプールする最大数を設定します。設定された値は，Cosminexus DABroker LibraryのsetBufferPoolSizeメソッドに渡されます。
デフォルト値は0です。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。0～1024の整数で指定します。デフォルト値は10です。また，PreparedStatementPoolSizeとCallableStatementPoolSizeの合計値は，1024以下に設定してください。有効範囲外の値を指定した場合は，デフォルト値が設定されます。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。0～1024の整数で指定します。デフォルト値は10です。また，PreparedStatementPoolSizeとCallableStatementPoolSizeの合計値は，1024以下に設定してください。有効範囲外の値を指定した場合は，デフォルト値が設定されます。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやアプリケーション強制停止時に，Statementクラス，CallableStatementクラスおよびPreparedStatementクラスで実行中のSQLをキャンセルするかどうかを指定します。

trueを指定した場合
実行中のSQLをキャンセルします。

falseを指定した場合
実行中のSQLをキャンセルしません。

デフォルト値はtrueです。
Oracleに接続する場合で，データベースのサーバまたはクライアントのどちらかがWindowsプラットフォームで，専用サーバ接続をする場合，falseを設定してください。

ConnectionIDUpdate
java.lang.Boolean
コネクションIDをDataSource#getConnectionメソッドごとに更新するかどうかを指定します。

trueを指定した場合
DataSource#getConnectionメソッドのたびにコネクションIDを生成します。

falseを指定した場合
最初のDataSource#getConnectionメソッドでコネクションIDを生成し，そのあとは更新しません。

デフォルト値はfalseです。
このプロパティは，接続するデータベースがOracleの場合に指定できます。

logLevel
java.lang.String
DB Connectorが出力するログ・トレースのレベルを指定します。
次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルトは，0またはERRORです。

表5-6　DBConnector_DABJ_XA.rarまたはDBConnector_DABJ_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

linkedResourceAdapterName
java.lang.String
連携するCosminexus RMリソースアダプタの表示名を指定します。
DBConnector_DABJ_XA_Cosminexus_RM.rarを使用する場合に指定できます。

networkProtocol
java.lang.String
Cosminexus DABroker Libraryとの接続種別を設定します。設定された値は，Cosminexus DABroker LibraryのsetNetworkProtocolメソッドに渡されます。

"lib"

databaseName
java.lang.String
接続するデータベースの種別を設定します。設定された値は，Cosminexus DABroker LibraryのsetDatabaseNameメソッドに渡されます。
次の値が指定できます。

HIRDB
HiRDBに接続する場合に指定します。

ORACLE，ORACLE8I
Oracleに接続する場合に指定します。

DBConnector_DABJ_XA_Cosminexus_RM.rarの場合，デフォルト値はHIRDBです。

description
java.lang.String
接続するデータベースに必要な接続付加情報を設定します。設定された値は，Cosminexus DABroker LibraryのsetDescriptionメソッドに渡されます。

HIRDBの場合
HiRDBクライアントの環境変数グループ名を指定します。

ORACLEの場合
SQL*Netの接続文字列を指定します。

DBHostName
java.lang.String
接続するHiRDBのホスト名を設定します。設定された値は，Cosminexus DABroker LibraryのsetDBHostNameメソッドに渡されます。

XAOpenString
java.lang.String
XA_OPEN文字列を設定します。設定された値は，Cosminexus DABroker LibraryのsetXAOpenStringメソッドに渡されます。

loginTimeout
java.lang.Integer
データベースへの接続試行中に，データソースが待機する最長時間（単位：秒）を設定します。デフォルト値は0です。

serverName
java.lang.String
接続するCosminexus DABroker Libraryのホスト名を設定します。設定された値は，Cosminexus DABroker LibraryのsetServerNameメソッドに渡されます。

portNumber
java.lang.Integer
接続するCosminexus DABroker Libraryのポート番号を設定します。設定された値は，Cosminexus DABroker LibraryのsetPortNumberメソッドに渡されます。デフォルト値は40179です。

DBEnv
java.lang.String
Cosminexus DABroker Libraryの接続先データベース定義情報を設定します。設定された値は，Cosminexus DABroker LibraryのsetDBEnvメソッドに渡されます。

encodLang
java.lang.String
エンコード文字形態を設定します。設定された値は，Cosminexus DABroker LibraryのsetEncodLangメソッドに渡されます。

JDBC_IF_TRC
java.lang.Boolean
JDBCインタフェースメソッドトレースの取得の有無を設定します。設定された値は，Cosminexus DABroker LibraryのsetJDBC_IF_TRCメソッドに渡されます。

trueを指定した場合
トレースを取得します。

falseを指定した場合
トレースを取得しません。

なお，trueを指定した場合，Cosminexus Driverが出力するトレースは，Cosminexus Component ContainerからセットされるPrintWriterと，ユーザがコネクションファクトリ（javax.sql.DataSourceクラス）のsetLogWriter()メソッドで指定したPrintWriterに出力します。デフォルト値はfalseです。

SV_EVENT_TRC
java.lang.Boolean
Cosminexus DABroker Libraryとのイベントトレースの取得の有無を設定します。設定された値は，Cosminexus DABroker LibraryのsetSV_EVENT_TRCメソッドに渡されます。

trueを指定した場合
トレースを取得します。

falseを指定した場合
トレースを取得しません。

なお，trueを指定した場合，Cosminexus Driverが出力するトレースは，Cosminexus Component ContainerからセットされるPrintWriterと，ユーザがコネクションファクトリ（javax.sql.DataSourceクラス）のsetLogWriter()メソッドで指定したPrintWriterに出力します。デフォルト値はfalseです。

TRC_NO
java.lang.Integer
トレースのエントリ数を設定します。設定された値は，Cosminexus DABroker LibraryのsetTRC_NOメソッドに渡されます。デフォルト値は500です。

uapName
java.lang.String
アプリケーション名称を設定します。設定された値は，Cosminexus DABroker LibraryのsetUapNameメソッドに渡されます。

bufSize
java.lang.Integer
Cosminexus DABroker Libraryからの受信データのバッファ長を，1～16000の範囲（単位：キロバイト）で設定します。設定された値は，Cosminexus DABroker LibraryのsetBufSizeメソッドに渡されます。デフォルト値は64です。

rowSize
java.lang.Integer
Cosminexus DABroker LibraryがJDBCで取り扱うバッファ長を，16～512の範囲（単位：メガバイト）で設定します。設定された値は，Cosminexus DABroker LibraryのsetRowSizeメソッドに渡されます。デフォルト値は16です。

OSAuthorize
java.lang.Boolean
OS認証機能を使用してデータベースに接続するかどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetOSAuthorizeメソッドに渡されます。

trueを指定した場合
OS認証機能を使用します。

falseを指定した場合
OS認証機能を使用しません。

デフォルト値はfalseです。

HiRDBCursorMode
java.lang.Boolean
HiRDBで検索時にカーソルがCommit，またはRollbackにわたって有効かどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetHiRDBCursorModeメソッドに渡されます。

trueを指定した場合
カーソルは保持されます。アプリケーションは続けてFetchすることができます。

falseを指定した場合
カーソルはクローズされますが，ステートメントは有効です。アプリケーションは，Prepareしないで，再度Executeできます。

デフォルト値はfalseです。

blockUpdate
java.lang.Boolean
接続データベースがHiRDBの場合，？パラメタを使用したデータベースの更新で，複数のパラメタセットを一度に処理するかどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetBlockUpdateメソッドに渡されます。

trueを指定した場合
複数のパラメタセットを一度に処理します。

falseを指定した場合
複数のパラメタセットを一つずつ分割して処理します。

デフォルト値はfalseです。

executeDirectMode
java.lang.Boolean
接続データベースがHiRDBの場合，Statementクラスを使用したINSERT， UPDATE， DELETEなどのデータベースの更新で，HiRDBのEXECUTE DIRECT機能を使用するかどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetExecuteDirectModeメソッドに渡されます。

trueを指定した場合
Execute Direct機能を使用します。

falseを指定した場合
Execute Direct機能を使用しません。

デフォルト値はfalseです。

SQLWarningIgnore
java.lang.Boolean
データベースから返される警告をConnectionクラスで保持するかどうかを設定します。設定された値は，Cosminexus DABroker LibraryのsetSQLWarningIgnoreメソッドに渡されます。

trueを指定した場合
警告を保持しません。

falseを指定した場合
警告を保持します。

デフォルト値はfalseです。

LONGVARBINARY_Access
java.lang.String
LONGVARBINARY（列属性BLOB，列属性BINARY）のデータベースアクセス方法を設定します。設定された値は，Cosminexus DABroker LibraryのsetLONGVARBINARY_Accessメソッドに渡されます。

REAL

LOCATOR

デフォルト値はREALです。

bufferPoolSize
java.lang.Integer
受信データのバッファをプールする最大数を設定します。設定された値は，Cosminexus DABroker LibraryのsetBufferPoolSizeメソッドに渡されます。
デフォルト値は0です。

XACloseString
java.lang.String
XA_CLOSE文字列を設定します。設定された値は，Cosminexus DABroker LibraryのsetXACloseStringメソッドに渡されます。

RMID
java.lang.Integer
リソースマネジャの識別子を，1以上の正の整数で設定します。設定された値は，Cosminexus DABroker LibraryのsetRMIDメソッドに渡されます。デフォルト値は1です。

XAThreadMode
java.lang.Boolean
XA使用時のスレッドモードを設定します。設定された値は，Cosminexus DABroker LibraryのsetXAThreadModeメソッドに渡されます。

trueを指定した場合
マルチスレッドモード

falseを指定した場合
シングルスレッドモード

デフォルト値はtrueです。

XALocalCommitMode
java.lang.Boolean
XA使用時，トランザクションが分散トランザクションでないとき，データベースのオートコミットモードを有効にするかどうかを設定します。設定された値はCosminexus DABroker LibraryのsetXALocalCommitModeメソッドに渡されます。

trueを指定した場合
データベースのオートコミットを有効にします。

falseを指定した場合
データベースのオートコミットを無効にします。

デフォルト値はtrueです。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。0～1024の整数で指定します。デフォルト値は10です。また，PreparedStatementPoolSizeとCallableStatementPoolSizeの合計値は，1024以下に設定してください。有効範囲外の値を指定した場合は，デフォルト値が設定されます。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。0～1024の整数で指定します。デフォルト値は10です。また，PreparedStatementPoolSizeとCallableStatementPoolSizeの合計値は，1024以下に設定してください。有効範囲外の値を指定した場合は，デフォルト値が設定されます。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやアプリケーション強制停止時に，Statementクラス，CallableStatementクラスおよびPreparedStatementクラスで実行中のSQLをキャンセルするかどうかを指定します。

trueを指定した場合
実行中のSQLをキャンセルします。

falseを指定した場合
実行中のSQLをキャンセルしません。

HiRDBに接続する場合は，falseを指定してください。
Oracleに接続する場合で，データベースのサーバまたはクライアントのどちらかがWindowsプラットフォームで，専用サーバ接続をする場合，falseを設定してください。

ConnectionIDUpdate
java.lang.Boolean
コネクションIDをDataSource#getConnectionメソッドごとに更新するかどうかを指定します。

trueを指定した場合
DataSource#getConnectionメソッドのたびにコネクションIDを生成します。

falseを指定した場合
最初のDataSource#getConnectionメソッドでコネクションIDを生成し，そのあとは更新しません。

デフォルト値はfalseです。
このプロパティは，接続するデータベースがOracleの場合に指定できます。

logLevel
java.lang.String
DB Connectorが出力するログ・トレースのレベルを指定します。
次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルト値は，0またはERRORです。

(2)　HiRDB Type4 JDBC Driverを使用してHiRDBに接続する場合

DBConnector_HiRDB_Type4_CP.rarまたはDBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar
トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。また，Cosminexus RMと連携する場合は，DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用します。
指定できるプロパティについては，表5-7を参照してください。

DBConnector_HiRDB_Type4_XA.rarまたはDBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar
グローバルトランザクションを使用する場合に使用します。また，Cosminexus RMと連携する場合は，DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用します。
指定できるプロパティについては，表5-8を参照してください。

表5-7　DBConnector_HiRDB_Type4_CP.rarまたはDBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

linkedResourceAdapterName
java.lang.String
連携するCosminexus RMリソースアダプタの表示名を指定します。
DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用する場合に指定できます。

description
java.lang.String
データベースへの接続に必要な接続付加情報を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetDescriptionメソッドに渡されます。

DBHostName
java.lang.String
接続するHiRDBおよびXDM/RD E2のホスト名を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetDBHostNameメソッドに渡されます。

environmentVariables
java.lang.String
HiRDBクライアント環境変数を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetEnvironmentVariablesメソッドに渡されます。

loginTimeout
java.lang.Integer
getConnectionメソッドでConnectionオブジェクトを取得する際の，HiRDBサーバとの物理接続確立の最大待ち時間（秒）を指定します。
デフォルト値は8です。

encodeLang
java.lang.String
データ変換時の文字セット名称を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetEncodeLangメソッドに渡されます。

JDBC_IF_TRC
java.lang.Boolean
JDBCインタフェースメソッドトレースの取得の有無を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetJDBC_IF_TRACEメソッドに渡されます。
デフォルト値はfalseです。

TRC_NO
java.lang.Integer
JDBCインタフェースメソッドトレースのエントリ数を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetTRC_NOメソッドに渡されます。
デフォルト値は500です。

uapName
java.lang.String
アプリケーション名称を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetUapNameメソッドに渡されます。

LONGVARBINARY_Access
java.lang.String
JDBC SQL タイプLONGVARBINARY（HiRDBデータ型である列属性BLOB，列属性BINARY）のデータベースアクセス方法を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetLONGVARBINARY_Accessメソッドに渡されます。
デフォルト値はREALです。

SQLInNum
java.lang.Integer
実行するSQLの入力?パラメタの最大数を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetSQLInNumメソッドに渡されます。
デフォルト値は300です。

SQLOutNum
java.lang.Integer
実行するSQLの検索項目の最大数を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetSQLOutNumメソッドに渡されます。
デフォルト値は300です。

SQLWarningLevel
java.lang.String
SQL実行時に発生した警告保持レベルを指定します。設定された値は，HiRDB Type4 JDBC DriverのsetSQLWarningLevelメソッドに渡されます。
デフォルト値はSQLWARNです。
DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用する場合，IGNOREは指定しないでください。

SQLWarningIgnore
java.lang.Boolean
データベースから返される警告をConnectionクラスで保持しないかどうかの情報を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetSQLWarningIgnoreメソッドに渡されます。
デフォルト値はfalseです。

HiRDBCursorMode
java.lang.Boolean
HiRDBがコミットを行った場合にResultSetクラスのオブジェクトを有効とするかを指定します。設定された値は，HiRDB Type4 JDBC DriverのsetHiRDBCursorModeメソッドに渡されます。
デフォルト値はfalseです。

maxBinarySize
java.lang.Integer
JDBC SQLタイプLONGVARBINARY型データ取得時のデータサイズの上限を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetMaxBinarySizeメソッドに渡されます。DBConnector_HiRDB_Type4_CP.rarを使用する場合，デフォルト値は0です。
DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用する場合，デフォルト値は64000です。
DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarを使用する場合，0は指定しないでください。

LONGVARBINARY_AccessSize
java.lang.Integer
HiRDBサーバに対して一度に要求するJDBC SQLタイプLONGVARBIANRY型データの長さを指定します。設定された値は，HiRDB Type4 JDBC DriverのsetLONGVARBINARY_AccessSizeメソッドに渡されます。
デフォルト値は0です。

LONGVARBINARY_TruncError
java.lang.Boolean
JDBC SQLタイプLONGVARBINARY型データ取得時に切り捨てが発生した場合に例外を投入することを指定します。設定された値は，HiRDB Type4 JDBC DriverのsetLONGVARBINARY_TruncErrorメソッドに渡されます。
デフォルト値はtrueです。
DBConnector_HiRDB_Type4_CP.rarを使用する場合に指定できます。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。有効範囲は0～4095です。
デフォルト値は10です。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。有効範囲は0～4095です。
デフォルト値は10です。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやUAP強制停止時にステートメントのキャンセルを実行するかどうかを設定します。

trueを指定した場合：
実行中のSQLをキャンセルします。

falseを指定した場合：
実行中のSQLをキャンセルしません。

デフォルト値はtrueです。

logLevel
java.lang.String
DB Connectorが出力するログトレースのレベルを指定します。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルト値は0またはERRORです。

表5-8　DBConnector_HiRDB_Type4_XA.rarまたはDBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

linkedResourceAdapterName
java.lang.String
連携するCosminexus RMリソースアダプタの表示名を指定します。
DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合に指定できます。

description
java.lang.String
データベースへの接続に必要な接続付加情報を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetDescriptionメソッドに渡されます。

DBHostName
java.lang.String
接続するHiRDBのホスト名を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetDBHostNameメソッドに渡されます。

environmentVariables
java.lang.String
HiRDBクライアント環境変数を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetEnvironmentVariablesメソッドに渡されます。

XAOpenString
java.lang.String
XAオープン文字列を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetXAOpenStringメソッドに渡されます。

loginTimeout
java.lang.Integer
getConnectionメソッドでConnectionオブジェクトを取得する際の，HiRDBサーバとの物理接続確立の最大待ち時間（秒）を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetLoginTimeoutメソッドに渡されます。
デフォルト値は8です。

encodeLang
java.lang.String
データ変換時の文字セット名称を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetEncodeLangメソッドに渡されます。

JDBC_IF_TRC
java.lang.Boolean
JDBCインタフェースメソッドトレースの取得の有無を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetJDBC_IF_TRACEメソッドに渡されます。

TRC_NO
java.lang.Integer
JDBCインタフェースメソッドトレースのエントリ数を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetTRC_NOメソッドに渡されます。
デフォルト値は500です。

uapName
java.lang.String
アプリケーション名称を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetUapNameメソッドに渡されます。

LONGVARBINARY_Access
java.lang.String
JDBC SQL タイプLONGVARBINARY（HiRDBデータ型である列属性BLOB，列属性BINARY）のデータベースアクセス方法を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetLONGVARBINARY_Accessメソッドに渡されます。
デフォルト値はREALです。

SQLInNum
java.lang.Integer
実行するSQLの入力?パラメタの最大数を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetSQLInNumメソッドに渡されます。
デフォルト値は300です。

SQLOutNum
java.lang.Integer
実行するSQLの検索項目の最大数を指定します。設定された値は，HiRDB Type4 JDBC DriverのsetSQLOutNumメソッドに渡されます。
デフォルト値は300です。

SQLWarningLevel
java.lang.String
SQL実行時に発生した警告保持レベルを指定します。設定された値は，HiRDB Type4 JDBC DriverのsetSQLWarningLevelメソッドに渡されます。
デフォルト値はSQLWARNです。
DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合，IGNOREは指定しないでください。

SQLWarningIgnore
java.lang.Boolean
データベースから返される警告をConnectionクラスで保持しないかどうかの情報を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetSQLWarningIgnoreメソッドに渡されます。
デフォルト値はfalseです。

HiRDBCursorMode
java.lang.Boolean
HiRDBがコミットを行った場合にResultSetクラスのオブジェクトを有効とするかを指定します。設定された値は，HiRDB Type4 JDBC DriverのsetHiRDBCursorModeメソッドに渡されます。
デフォルト値はfalseです。

maxBinarySize
java.lang.Integer
JDBC SQLタイプLONGVARBINARY型データ取得時のデータサイズの上限を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetMaxBinarySizeメソッドに渡されます。DBConnector_HiRDB_Type4_XA.rarを使用する場合，デフォルト値は0です。
DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合，デフォルト値は64000です。
DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarを使用する場合，0は指定しないでください。

LONGVARBINARY_AccessSize
java.lang.Integer
HiRDBサーバに対して一度に要求するJDBC SQLタイプLONGVARBIANRY型データの長さを指定します。設定された値は，HiRDB Type4 JDBC DriverのsetLONGVARBINARY_AccessSizeメソッドに渡されます。
デフォルト値は0です。

LONGVARBINARY_TruncError
java.lang.Boolean
JDBC SQLタイプLONGVARBINARY型データ取得時に切り捨てが発生した場合に例外を投入することを指定します。設定された値は，HiRDB Type4 JDBC DriverのsetLONGVARBINARY_TruncErrorメソッドに渡されます。
デフォルト値はtrueです。
DBConnector_HiRDB_Type4_XA.rarを使用する場合に指定できます。

XACloseString
java.lang.String
XAクローズ文字列を設定します。設定された値は，HiRDB Type4 JDBC DriverのsetXACloseStringメソッドに渡されます。

XALocalCommitMode
java.lang.Boolean
トランザクションがグローバルトランザクションでない場合にオートコミット機能を有効にするかを設定します。設定された値はHiRDB Type4 JDBC DriverのsetXALocalCommitModeメソッドに渡されます。
デフォルト値はtrueです。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。有効範囲は0～4095です。
デフォルト値は10です。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。有効範囲は0～4095です。
デフォルト値は10です。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやUAP強制停止時にステートメントのキャンセルを実行するかどうかを設定します。

trueの場合：
実行中のSQLをキャンセルします。

falseの場合：
実行中のSQLをキャンセルしません。

デフォルト値はtrueです。

logLevel
java.lang.String
DB Connectorが出力するログトレースのレベルを指定します。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルト値は0またはERRORです。

(3)　Oracle JDBC Thin Driverを使用してOracleに接続する場合

DBConnector_Oracle_CP.rarまたはDBConnector_Oracle_CP_Cosminexus_RM.rar
トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。また，Cosminexus RMと連携する場合は，DBConnector_Oracle_CP_Cosminexus_RM.rarを使用します。
指定できるプロパティについては，表5-9を参照してください。

DBConnector_Oracle_XA.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rar
グローバルトランザクションを使用する場合に使用します。また，Cosminexus RMと連携する場合は，DBConnector_Oracle_XA_Cosminexus_RM.rarを使用します。
指定できるプロパティについては，表5-10を参照してください。

なお，プロパティで設定可能な値については，Oracleのマニュアルを参照してください。

表5-9　DBConnector_Oracle_CP.rarまたはDBConnector_Oracle_CP_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

linkedResourceAdapterName
java.lang.String
連携するCosminexus RMリソースアダプタの表示名を指定します。
DBConnector_Oracle_CP_Cosminexus_RM.rarを使用する場合に指定できます。

databaseName
java.lang.String
Oracleサーバ上の特定のデータベース名（SID）を指定します。設定された値は，Oracle JDBC Thin DriverのsetDatabaseNameメソッドに渡されます

serverName
java.lang.String
Oracleサーバのホスト名またはIPアドレスを指定します。設定された値は，Oracle JDBC Thin DriverのsetServerNameメソッドに渡されます。

portNumber
java.lang.Integer
Oracleのサーバが要求をリスニングするポート番号を指定します。デフォルトは1521番ポートです。設定された値は，Oracle JDBC Thin DriverのsetPortNumberメソッドに渡されます。

url
java.lang.String
Oracle JDBC Thin Driverがデータベースに接続するために必要なJDBC URLを指定します。
このプロパティに値が設定された場合，databaseName，portNumber，serverNameで指定された値は無視されます。また，ユーザがurlで指定を行う場合はJDBC URLにthinドライバを指定します。
（例）
jdbc:oracle:thin:@ServerA:1521:service1

loginTimeout
java.lang.Integer
データベースへの接続試行のタイムアウト（単位：ミリ秒）を指定します。0を指定するとタイムアウトは無限となり，接続が確立されるかエラーが発生するまでブロックされます。デフォルト値は8000です。設定された値はOracle JDBC Thin DriverのsetLoginTimeoutメソッドに渡されます。Oracle JDBC Thin Driver 9.2.0.8以降，10.1.0.5以降および10.2以降の場合は秒単位に切り上げてsetLoginTimeoutメソッドに渡されます。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。デフォルトは10です。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。デフォルトは10です。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやアプリケーション強制停止時に，Statementクラス，CallableStatementクラスおよびPreparedStatementクラスで実行中のSQLをキャンセルするかどうかを指定します。

trueを指定した場合
実行中のSQLをキャンセルします。

falseを指定した場合
実行中のSQLをキャンセルしません。

デフォルト値はtrueです。
専用サーバ接続をする場合は，falseを指定してください。

ConnectionIDUpdate
java.lang.Boolean
コネクションIDをDataSource#getConnectionメソッドごとに更新するかどうかを指定します。

trueを指定した場合
DataSource#getConnectionメソッドのたびにコネクションIDを生成します。

falseを指定した場合
最初のDataSource#getConnectionメソッドでコネクションIDを生成し，そのあとは更新しません。

デフォルト値はfalseです。

logLevel
java.lang.String
DB Connectorが出力するログ・トレースのレベルを指定します。
次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルトは，0またはERRORです。

表5-10　DBConnector_Oracle_XA.rarまたはDBConnector_Oracle_XA_Cosminexus_RM.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

linkedResourceAdapterName
java.lang.String
連携するCosminexus RMリソースアダプタの表示名を指定します。
DBConnector_Oracle_CP_Cosminexus_RM.rarを使用する場合に指定できます。

databaseName
java.lang.String
Oracleサーバ上の特定のデータベース名（SID）を指定します。設定された値は，Oracle JDBC Thin DriverのsetDatabaseNameメソッドに渡されます。

serverName
java.lang.String
Oracleサーバのホスト名またはIPアドレスを指定します。設定された値は，Oracle JDBC Thin DriverのsetServerNameメソッドに渡されます。

portNumber
java.lang.Integer
Oracleのサーバが要求をリスニングするポート番号を指定します。デフォルトは1521番ポート。設定された値は，Oracle JDBC Thin DriverのsetPortNumberメソッドに渡されます。

url
java.lang.String
Oracle JDBC Thin Driverがデータベースに接続するために必要なJDBC URLを指定します。
このプロパティに値が設定された場合，databaseName,portNumber,serverNameで指定された値は無視されます。また，ユーザがurlで指定を行う場合はJDBC URLにthinドライバを指定します。

loginTimeout
java.lang.Integer
データベースへの接続試行のタイムアウト（単位：ミリ秒）を指定します。0を指定するとタイムアウトは無限となり，接続が確立されるかエラーが発生するまでブロックされます。デフォルト値は8000です。設定された値はOracle JDBC Thin DriverのsetLoginTimeoutメソッドに渡されます。Oracle JDBC Thin Driver 9.2.0.8以降，10.1.0.5以降および10.2以降の場合は秒単位に切り上げてsetLoginTimeoutメソッドに渡されます。

sessionTimeout
java.lang.Integer
Oracleサーバでのセッションタイムアウト（トランザクションブランチがアクティブでない状態でいられる最大時間）を秒単位で指定します。J2EEサーバのトランザクションタイムアウトよりも長い時間を指定する必要があります。デフォルト値は300秒です。設定された値はOracle JDBC Thin DriverのXAResource.setTransactionTimeoutメソッドに渡されます。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。デフォルト値は10です。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。デフォルト値は10です。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやアプリケーション強制停止時に，Statementクラス，CallableStatementクラスおよびPreparedStatementクラスで実行中のSQLをキャンセルするかどうかを指定します。

trueを指定した場合
実行中のSQLをキャンセルします。

falseを指定した場合
実行中のSQLをキャンセルしません。

デフォルト値はtrueです。
専用サーバ接続をする場合は，falseを指定してください。

ConnectionIDUpdate
java.lang.Boolean
コネクションIDをDataSource#getConnectionメソッドごとに更新するかどうかを指定します。

trueを指定した場合
DataSource#getConnectionメソッドのたびにコネクションIDを生成します。

falseを指定した場合
最初のDataSource#getConnectionメソッドでコネクションIDを生成し，そのあとは更新しません。

デフォルト値はfalseです。

logLevel
java.lang.String
DB Connectorが出力するログ・トレースのレベルを指定します。
次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルト値は，0またはERRORです。

(4)　SQL Server 2000 Driver for JDBCを使用して，SQL Server 2000に接続する場合

DBConnector_SQLServer_CP.rar
トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。
指定できるプロパティについては，表5-11を参照してください。

表5-11　DBConnector_SQLServer_CP.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

databaseName
java.lang.String
接続するSQL Server 2000のデータベース名を設定します。設定された値は，SQL Server 2000 Driver for JDBCのsetDatabaseNameメソッドに渡されます。

serverName
java.lang.String
接続するSQL Server 2000のホスト名またはIPアドレスを設定します。名前付きインスタンスに接続する場合は次のように指定します。

<接続先のホスト名またはIPアドレス>¥/<インスタンス名>

設定された値は，SQL Server 2000 Driver for JDBCのsetServerNameメソッドに渡されます。

hostProcess
java.lang.Integer
SQL Server 2000に接続するアプリケーションサーバのプロセスIDを設定します。設定された値は，sysprocessesテーブルのhostprocess列に表示されます。設定された値は，SQL Server 2000 Driver for JDBCのsetHostProcessメソッドに渡されます。デフォルト値は0です。

netAddress
java.lang.String
SQL Server 2000に接続するアプリケーションサーバのネットワークインターフェースカードのMACアドレスを設定します。設定された値は，sysprocessesテーブルのnet_address列に表示されます。設定された値は，SQL Server 2000 Driver for JDBCのsetNetAddressメソッドに渡されます。

loginTimeout
java.lang.Integer
データベースへの接続試行中に，データソースが待機する最長時間（単位：秒）を設定します。設定された値はSQL Server 2000 Driver for JDBCのsetLoginTimeoutメソッドに渡されます。デフォルト値は8です。

portNumber
java.lang.Integer
接続するSQL Server 2000のポート番号を設定します。設定された値は，SQL Server 2000 Driver for JDBCのsetPortNumberメソッドに渡されます。デフォルト値は1433です。

programName
java.lang.String
SQL Server 2000に接続するアプリケーションの名前を設定します。設定された値は，sysprocessesテーブルのprogram_name列に表示されます。設定された値は，SQL Server 2000 Driver for JDBCのsetProgramNameメソッドに渡されます。

selectMethod
java.lang.String
select文でデータベースカーソルを使用するかどうかを指定します。次の文字列のどちらかを指定します。なお，値の大文字と小文字は区別されますので，小文字で設定してください。

cursor
select文の実行時に，データベースカーソルが作成されます。データベースの検索結果を分割してクライアントに返します。

direct
select文の実行時に，データベースカーソルは作成されません。データベースの検索結果を一度の要求ですべてクライアントに返します。
directを設定した場合には，自動コミットモードだけサポートされます。Application Serverが管理するかどうかに関係なく，トランザクションはサポートされません。

設定された値は，SQL Server 2000 Driver for JDBCのsetSelectMethodメソッドに渡されます。デフォルト値はcursorです。
詳細については，SQL Server 2000 Driver for JDBCのマニュアルを参照してください。

sendStringParametersAsUnicode
java.lang.Boolean
SQL Server 2000に送信される文字列パラメタをUnicodeで送るか，データベースのデフォルトの文字エンコーディングで送るかを指定します。

trueを設定した場合
文字列パラメタはUnicodeで送られます。データベースの文字データ型にUnicodeデータ型を使用する場合には，文字化けが発生しません。

falseを設定した場合
文字列パラメタはデータベースのデフォルトの文字エンコーディングで送られます。データベースは，Unicode文字をデフォルトの文字エンコーディングに変換する必要がないので，性能は向上しますが，文字化けが発生するおそれがあります。

設定された値は，SQL Server 2000 Driver for JDBCのsetSendStringParametersAsUnicodeメソッドに渡されます。デフォルト値はtrueです。

WSID
java.lang.String
ワークステーションIDを設定します。通常は，アプリケーションサーバのホスト名です。設定された値は，sysprocessesテーブルのhostname列に表示されます。設定された値は，SQL Server 2000 Driver for JDBCのsetWsidメソッドに渡されます。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。デフォルト値は10です。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。デフォルト値は10です。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやアプリケーションの強制停止時にステートメントのキャンセル機能を実行するかどうかを設定します。

trueを設定した場合
ステートメントのキャンセル機能が実行されます。

falseを設定した場合
ステートメントのキャンセル機能は実行されません。

デフォルト値はtrueです。

logLevel
java.lang.String
DB Connectorが出力するログ・トレースのレベルを指定します。
次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルト値は，0またはERRORです。

(5)　SQL Server 2005 JDBC Driverを使用して，SQL Server 2005に接続する場合

DBConnector_SQLServer2005_CP.rar
トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。
指定できるプロパティについては，表5-12を参照してください。

表5-12　DBConnector_SQLServer2005_CP.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

databaseName
java.lang.String
接続するSQL Server 2005のデータベース名を指定します。値を指定しない場合には，すでに定義されたデータベースに接続されます。設定された値は，SQL Server 2005 JDBC DriverのsetDatabaseNameメソッドに渡されます。

serverName
java.lang.String
接続するSQL Server 2005のホスト名またはIPアドレスを指定します。設定された値は，SQL Server 2005 JDBC DriverのsetServerNameメソッドに渡されます。

applicationName
java.lang.String
SQL Server 2005に接続するアプリケーションの名前を指定します。設定された値は，SQL Server 2005の管理ツールなどに表示されます。設定された値は，SQL Server 2005 JDBC DriverのsetApplicationNameメソッドに渡されます。

instanceName
java.lang.String
接続するSQL Server 2005のインスタンス名を指定します。値を指定しない場合は，既定のインスタンスに接続されます。設定された値は，SQL Server 2005 JDBC DriverのsetInstanceNameメソッドに渡されます。

lastUpdateCount
java.lang.Boolean
トリガからの更新数をアプリケーションに返さないかどうかを指定します。

trueを設定した場合
トリガからの更新数はアプリケーションに返されません。

falseを設定した場合
トリガからの更新数はアプリケーションに返されます。

設定された値は，SQL Server 2005 JDBC DriverのsetLastUpdateCountメソッドに渡されます。
デフォルト値はtrueです。

lockTimeout
java.lang.Integer
データベースがロックタイムアウトを通知するまでに待機する時間（単位：ミリ秒）を指定します。-1を指定するとタイムアウトは無限になります。0を指定すると待機しないことになります。設定された値は，SQL Server 2005 JDBC DriverのsetLockTimeoutメソッドに渡されます。
デフォルト値は-1です。

loginTimeout
java.lang.Integer
データベースへの接続試行中に，データソースが待機する最長時間（単位：秒）を設定します。設定された値は，SQL Server 2005 JDBC DriverのsetLoginTimeoutメソッドに渡されます。
デフォルト値は8です。

portNumber
java.lang.Integer
接続するSQL Server 2005のポート番号を指定します。設定された値は，SQL Server 2005 JDBC DriverのsetPortNumberメソッドに渡されます。
デフォルト値は1433です。

selectMethod
java.lang.String
select文の実行時に，データベースカーソルを使用するかどうかを指定します。
小文字で設定してください。

cursor
データベースカーソルが作成されます。データベースの検索結果を分割してクライアントに返します。

direct
データベースカーソルは作成されません。データベースの検索結果を一度の要求ですべてクライアントに返します。

設定された値は，SQL Server 2005 JDBC DriverのsetSelectMethodメソッドに渡されます。
デフォルト値はcursorです

sendStringParametersAsUnicode
java.lang.Boolean
SQL Server 2005に送信される文字列パラメータをUnicodeで送るか，データベースのデフォルトの文字エンコーディングで送るかを指定します。

trueを設定した場合
文字列パラメータはUnicodeで送られます。

falseを設定した場合
文字列パラメータはデータベースのデフォルトの文字エンコーディングで送られます。

設定された値は，SQL Server 2005 JDBC DriverのsetSendStringParametersAsUnicodeメソッドに渡されます。
デフォルト値はtrueです。

workstationID
java.lang.String
アプリケーションサーバのホスト名を指定します。設定された値は，SQL Server 2005の管理ツールなどに表示されます。設定された値は，SQL Server 2005 JDBC DriverのsetWorkstationIDメソッドに渡されます。

xopenStates
java.lang.Boolean
java.sql.SQLException.getSQLStateメソッドの戻り値のSQL規格を指定します。

trueを設定した場合
getSQLStateメソッドは，X/Open規格で定義された状態コードを返します。

falseを設定した場合
getSQLStateメソッドは，SQL 99規格で定義された状態コードを返します。

設定された値は，SQL Server 2005 JDBC DriverのsetXopenStatesメソッドに渡されます。
デフォルト値はfalseです。

failoverPartner※
java.lang.String
データベースミラーリング構成で使用されるフェールオーバーサーバの名前を指定します。databaseNameプロパティと組み合わせて使用してください。
設定された値は，SQL Server 2005 JDBC DriverのsetFailoverPartnerメソッドに渡されます。

integratedSecurity※
java.lang.Boolean
SQL Server 2005へ接続するための認証方法を指定します。

trueを設定した場合
Windows認証を使用します。

falseを設定した場合
SQL Server 2005認証を使用します。

設定された値は，SQL Server 2005 JDBC DriverのsetIntegratedSecurityメソッドに渡されます。
デフォルト値は，falseです。

packetSize※
java.lang.Integer
SQL Server 2005との通信に使用されるネットワークパケットサイズ（単位：バイト）で指定します。設定された値は，SQL Server 2005 JDBC DriverのsetPacketSizeメソッドに渡されます。
デフォルト値は，4096です。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。
デフォルト値は10です。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。
デフォルト値は10です。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやアプリケーションの強制停止時にステートメントのキャンセル機能を実行するかどうかを設定します。

trueを設定した場合
ステートメントのキャンセル機能が実行されます。

falseを設定した場合
ステートメントのキャンセル機能は実行されません。

デフォルト値はtrueです。

logLevel
java.lang.String
DB Connectorが出力するログ・トレースのレベルを指定します。
次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルト値は，0またはERRORです。

注※　SQL Server 2005 JDBC Driverのバージョンが1.0の場合は無効となるプロパティです。

(6)　クラスタコネクションプールを使用してOracleに接続する場合（ルートリソースアダプタ）

DBConnector_CP_ClusterPool_Root.rar
トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。
指定できるプロパティについては，表5-13を参照してください。

表5-13　DBConnector_CP_ClusterPool_Root.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

memberResourceAdapterName1
ava.lang.String
優先度1のメンバリソースアダプタの表示名を指定します。優先度は値が小さいほど高くなります。

memberResourceAdapterName2
java.lang.String
優先度2のメンバリソースアダプタの表示名を指定します。

memberResourceAdapterName[n]
java.lang.String
優先度nのメンバリソースアダプタの表示名を指定します。このプロパティは，デフォルトでは定義されていないので，必要に応じて追加してください。nは1～100の範囲で指定します。

algorithm
java.lang.String
コネクションプールのクラスタ化機能のコネクションプール選択方式を指定します。

RoundRobin
最後に選択したコネクションプールの次の優先度のコネクションプールから優先度順に，コネクションの取得を試みます。優先度が最も低いコネクションプールに達した場合には，優先度が最も高いコネクションプールが選択されます。すべてのコネクションプールからコネクションが取得できない場合は，例外となります。
クラスタデータベースがアクティブ/アクティブ構成で，各インスタンスで負荷分散を図る場合に指定します。

デフォルト値はRoundRobinです。

enableAutoPoolSuspend
java.lang.Boolean
コネクションプールの自動一時停止機能を有効とするか，無効とするかを指定します。

trueを設定した場合
コネクションプールの自動一時停止機能が有効となります。

falseを設定した場合
コネクションプールの自動一時停止機能が無効となります。

デフォルト値はtrueです。

enableAutoPoolResume
java.lang.Boolean
コネクションプールの自動再開機能を有効とするか，無効とするかを指定します。

trueを設定した場合
コネクションプールの自動再開機能が有効となります。

falseを設定した場合
コネクションプールの自動再開機能が無効となります。

デフォルト値はtrueです。

dbCheckInterval
java.lang.Integer
一時停止状態のコネクションプールで，DBノードの状態をチェックする間隔を，2～2147483647の整数（単位：秒）で指定します。有効範囲外の値を指定した場合には，デフォルト値となります。デフォルト値は30です。
メンバリソースアダプタでOracle JDBC Thin Driverを使用するときは，各メンバリソースアダプタのloginTimeoutプロパティの値よりも長い時間を指定してください。

logLevel
java.lang.String
DB Connectorが出力するログ・トレースのレベルを指定します。
次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルト値は，0またはERRORです。

(7)　クラスタコネクションプールを使用してOracleに接続する場合（メンバリソースアダプタ）

DBConnector_Oracle_CP_ClusterPool_Member.rar
トランザクション管理をしない場合，またはローカルトランザクションを使用する場合に使用します。
指定できるプロパティについては，表5-14を参照してください。

表5-14　DBConnector_Oracle_CP_ClusterPool_Member.rarを使用する場合に指定できるプロパティ

config-property-name
config-property-type
config-property-value

databaseName
java.lang.String
Oracleサーバ上の特定のデータベース名（SID）を指定します。設定された値は，Oracle JDBC Thin DriverのsetDatabaseNameメソッドに渡されます。

portNumber
java.lang.Integer
Oracleのサーバが要求をリスニングするポート番号を指定します。デフォルトは1521番ポートです。設定された値は，Oracle JDBC Thin DriverのsetPortNumberメソッドに渡されます。

serverName
java.lang.String
Oracleサーバのホスト名またはIPアドレスを指定します。設定された値は，Oracle JDBC Thin DriverのsetServerNameメソッドに渡されます。

url
java.lang.String
Oracle JDBC Thin Driverがデータベースに接続するために必要なJDBC URLを指定します。
このプロパティに値が設定された場合，databaseName，portNumber，serverNameで指定された値は無視されます。また，ユーザがurlで指定を行う場合はJDBC URLにthinドライバを指定します。
（例）
jdbc:oracle:thin:@ServerA:1521:service1

loginTimeout
java.lang.Integer
データベースへの接続試行のタイムアウトを，1～2147483647の整数（単位：ミリ秒）で指定します。有効範囲外の値を指定した場合には，デフォルト値が使用されます。デフォルト値は8000です。設定された値はOracle JDBC Thin DriverのsetLoginTimeoutメソッドに渡されます。Oracle JDBC Thin Driver 10.1.0.5以降および10.2以降の場合は秒単位に切り上げてsetLoginTimeoutメソッドに渡されます。

PreparedStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのPreparedStatementのプールサイズを設定します。デフォルトは10です。

CallableStatementPoolSize
java.lang.Integer
コネクションプールに割り当てられるコネクションごとのCallableStatementのプールサイズを設定します。デフォルトは10です。

CancelStatement
java.lang.Boolean
トランザクションタイムアウトやアプリケーション強制停止時に，Statementクラス，CallableStatementクラスおよびPreparedStatementクラスで実行中のSQLをキャンセルするかどうかを指定します。

trueを指定した場合
実行中のSQLをキャンセルします。

falseを指定した場合
実行中のSQLをキャンセルしません。

デフォルト値はtrueです。
専用サーバ接続をする場合は，falseを指定してください。

ConnectionIDUpdate
java.lang.Boolean
コネクションIDをDataSource#getConnectionメソッドごとに更新するかどうかを指定します。

trueを指定した場合
DataSource#getConnectionメソッドのたびにコネクションIDを生成します。

falseを指定した場合
最初のDataSource#getConnectionメソッドでコネクションIDを生成し，そのあとは更新しません。

デフォルト値はfalseです。

logLevel
java.lang.String
DB Connectorが出力するログ・トレースのレベルを指定します。
次の値が指定できます。

0またはERROR

10またはWARNING

20またはINFORMATION

デフォルトは，0またはERRORです。

5.11.3　<property>タグに指定できるプロパティ

<property>タグに指定できる値について説明します。

表5-15　propertyタグに設定する情報一覧

property-name
property-type
property-default-value
意味

MaxPoolSize
int
10
プールの最大値を，0～2147483647の整数，または-1（無制限）で指定します。

MinPoolSize
int
10
プールの最小値を，0～2147483647の整数で指定します。

LogEnabled
boolean
true
LogWriterによるログ出力をするかどうかを指定します。

true：

LogWriterによるログ出力をします。

false：

LogWriterによるログ出力をしません。

User
String
－
ユーザ名

Password
String
－
パスワード

ValidationType
int
1
コネクションチェック契機。指定可能な値は次のとおり。

0：

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

1：

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

2：

一定間隔でチェック

ValidationInterval
int
3600
コネクションチェック間隔を，1～2147483647の整数（単位：秒）で指定します。

RetryCount
int
0
コネクション取得リトライ回数を，0～2147483647の整数（単位：回）で指定します。

RetryInterval
int
10
コネクション取得リトライ間隔を，1～2147483647の整数（単位：秒）で指定します。

ConnectionTimeout
int
0
コネクション解放までのタイムアウト値を，0～2147483647の整数（単位：秒）で指定します。
コネクションの最終利用時刻からタイムアウト判定までの時間が指定値を超えるとコネクションスイーパによる削除対象になります。0を指定した場合はタイムアウトしません。

SweeperInterval
int
0
コネクションスイーパ動作時間間隔を，0～2147483647の整数（単位：秒）で指定します。
指定した間隔でコネクションスイーパが動作して，タイムアウトしたコネクションを削除します。0を指定した場合は動作しません。

RequestQueueEnable
boolean
true
コネクション枯渇時のコネクション取得待ち行列を有効にするかどうかを指定します。

true：

コネクション枯渇時のコネクション取得待ち行列機能を有効にします。

false：

コネクション枯渇時のコネクション取得待ち行列機能を無効にします。

RequestQueueTimeout
int
30
コネクション枯渇時のコネクション取得待ち行列のとどまることのできる時間の最大値を，0～2147483647の整数（単位：秒）で指定します。
0を指定した場合，待ち行列に入った時点でエラーを返却します。

WatchEnabled
boolean
true
コネクションプール監視を有効にするかどうかを指定します。

true：

有効にします。

false：

無効にします。

WatchInterval
int
30
コネクションプール監視間隔を，1～2147483647の整数（単位：秒）で指定します。

WatchThreshold
int
80
コネクションプール使用状態を監視するしきい値を，1～100の整数（単位：％）で指定します。

WatchWriteFileEnabled
boolean
true
コネクションプール監視結果をファイル出力するかどうかを指定します。

true：

ファイル出力します。

false：

ファイル出力しません。

ConnectionPoolAdjustmentInterval
int
600
コネクション数調節機能の動作間隔を，0～2147483647の整数（単位：秒）で指定します。
0を指定した場合は動作しません。

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

true：

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

false：

コネクションプールのウォーミングアップ機能を無効にします。

NetworkFailureTimeout
boolean
true
ネットワーク障害検知機能のタイムアウトを有効にするかどうかを指定します。

true：

ネットワーク障害検知機能のタイムアウトを有効にします。

false：

ネットワーク障害検知機能のタイムアウトを無効にします。

MaxTPoolSize※
int
10
スレッドプールで同時に実行される最大スレッド数を，1～2147483647の整数で指定します。

MinTPoolSize※
int
0
スレッドプールに存在する最小スレッド数を，0～1024の整数で指定します。

TPoolKeepalive※
int
300
スレッドプールのスレッド解放までのタイムアウト値(秒)を，1～2147483647の整数で指定します。

（凡例）－：設定なし

注※　ライフサイクル管理機能が有効でない場合（<resourceadapter-class>が指定されていない場合），プロパティ値は無視されます。

5.11.4　Connector属性ファイルのテンプレートファイル

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

＜この項の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　テンプレートファイル

(5)　注意事項

(1)　形式

xmlファイル形式です。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥admin¥templates¥

UNIXの場合
/opt/Cosminexus/CC/admin/templates/

(3)　機能

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

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

(4)　テンプレートファイル

Cosminexus Component Containerが提供しているテンプレートファイルを次に示します。

表5-16　テンプレートファイル一覧

テンプレートファイル名 | 説明
DBConnector_HiRDB_Type4_CP_cfg.xml | HiRDB Type4 JDBC Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。
DBConnector_HiRDB_Type4_XA_cfg.xml | HiRDB Type4 JDBC Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（グローバルトランザクション用）。
DBConnector_DABJ_CP_cfg.xml | Cosminexus DABroker Library用DB ConnectorのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。
DBConnector_DABJ_XA_cfg.xml | Cosminexus DABroker Library用DB ConnectorのConnector属性ファイルのテンプレートファイル（グローバルトランザクション用）。
DBConnector_Oracle_CP_cfg.xml | Oracle JDBC Thin Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。
DBConnector_Oracle_XA_cfg.xml | Oracle JDBC Thin Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（グローバルトランザクション用）。
DBConnector_SQLServer_CP_cfg.xml | SQL Server 2000 Driver for JDBC用DB ConnectorのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。
DBConnector_SQLServer2005_CP_cfg.xml | SQL Server 2005 JDBC Driver用DB ConnectorのConnector属性のテンプレートファイル（ローカルトランザクション用）。
DBConnector_HiRDB_Type4_CP_Cosminexus_RM_cfg.xml | HiRDB Type4 JDBC Driver用DB Connector for Cosminexus RMのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。
DBConnector_HiRDB_Type4_XA_Cosminexus_RM_cfg.xml | HiRDB Type4 JDBC Driver用DB Connector for Cosminexus RMのConnector属性ファイルのテンプレートファイル（グローバルトランザクション用）。
DBConnector_DABJ_CP_Cosminexus_RM_cfg.xml | Cosminexus DABroker Library用DB Connector for Cosminexus RMのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。
DBConnector_DABJ_XA_Cosminexus_RM_cfg.xml | Cosminexus DABroker Library用DB Connector for Cosminexus RMのConnector属性のテンプレートファイル（グローバルトランザクション用）。
DBConnector_Oracle_CP_Cosminexus_RM_cfg.xml | Oracle JDBC Thin Driver用DB Connector for Cosminexus RMのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）
DBConnector_Oracle_XA_Cosminexus_RM_cfg.xml | Oracle JDBC Thin Driver用DB Connector for Cosminexus Reliable MessagingのConnector属性のテンプレートファイル（グローバルトランザクション用）。
DBConnector_CP_ClusterPool_Root_cfg.xml | クラスタコネクションプールのルートリソースアダプタのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。
DBConnector_Oracle_CP_ClusterPool_Member_cfg.xml | クラスタコネクションプールのメンバリソースアダプタである，Oracle JDBC Thin Driver用DB ConnectorのConnector属性ファイルのテンプレートファイル（ローカルトランザクション用）。

(5)　注意事項

テンプレートファイルで提供している属性ファイルをサーバ管理コマンド以外の方法で使用する場合，DOCTYPE宣言内のURLの指定を，使用している環境に合わせて書き直す必要があります。

例

変更前

C:/Program%20Files/Hitachi/Cosminexus

変更後

<Cosminexusインストールディレクトリ>

5.11.5　DDとの対応

Connector属性ファイルとDeployment Descriptorの対応を次に示します。

＜この項の構成＞

(1)　Connector1.0の場合

(2)　Connector1.5の場合

(1)　Connector1.0の場合

Connector属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-connector-property>
1回
<connector>
1回

┣
┃
<description>
0回以上
┣
┃
<description>
0または1回

┣
┃
<display-name>
0回以上
┣
┃
<display-name>
0または1回

┣
┃
<icon>
0回以上
┣
┃
<icon>
0または1回

┃
┃
┣
┃
<small-icon>
0または1回
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回
┃
┃
┗
<large-icon>
0または1回

┣
┃
<vendor-name>
1回
┣
┃
<vendor-name>
1回

┣
┃
<spec-version>
1回
┣
┃
<spec-version>
1回

┣
┃
<eis-type>
1回
┣
┃
<eis-type>
1回

┣
┃
<version>
1回
┣
┃
<version>
1回

┣
┃
<license>
0または1回
┣
┃
<license>
0または1回

┃
┃
┣
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0または1回

┃
┃
┗
<license-required>
1回
┃
┃
┗
<license-required>
1回

┣
┃
<resourceadapter>
1回
┗
<resourceadapter>
1回

┃
┃
┣
┃
<outbound-resourceadapter>
0または1回

┃
┃
－
－

┃
┃
┃
┃
┣
┃
<connection-definition>
1回以上

┃
┃
－
－

┃
┃
┃
┃
┃
┃
┣
┃
<managedconnectionfactory-class>
1回

┣
┃
<managedconnectionfactory-class>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<config-property>
0回以上

┣
┃
<config-property>
0回以上

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0または1回

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
<config-property-name>
1回

┃
┃
┣
┃
<config-property-name>
1回

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
<config-property-type>
1回

┃
┃
┣
┃
<config-property-type>
1回

┃
┃
┃
┃
┃
┃
┃
┃
┗
<config-property-value>
0または1回

┃
┃
┗
<config-property-value>
0または1回

┃
┃
┃
┃
┃
┃
┣
┃
<connectionfactory-interface>
1回

┣
┃
<connectionfactory-interface>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<connectionfactory-impl-class>
1回

┣
┃
<connectionfactory-impl-class>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<connection-interface>
1回

┣
┃
<connection-interface>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<connection-impl-class>
1回

┣
┃
<connection-impl-class>
1回

┃
┃
┃
┃
┃
┃
┗
<connector-runtime>
0または1回

┃
┃
－
－

┃
┃
┃
┃
┃
┃

(省略)
－

┃
┃
－
－

┃
┃
┃
┃
┣
┃
<transaction-support>
1回

┣
┃
<transaction-support>
1回

┃
┃
┃
┃
┃
┃
－
－

┣
┃
<authentication-mechanism>
0回以上

┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<description>
0または1回

┃
┃
┃
┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┣
┃
┃
<authentication-mechanism-type>
1回

┃
┃
┃
┃
┃
┃
－
－

┃
┃
┗
<credential-interface>
1回

┃
┃
┃
┃
┗
<reauthentication-support>
1回

┣
┃
<reauthentication-support>
1回

┃
┃
┗
<security-permission>
0回以上

┗
<security-permission>
0回以上

┃
┃

┣
┃
<description>
0回以上

┣
┃
<description>
0または1回

┃
┃

┗
<security-permission-spec>
1回

┗
<security-permission-spec>
1回

┗
<resourceadapter-runtime>
0または1回

－
－

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

(2)　Connector1.5の場合

Connector属性ファイル
Deployment Descriptor

タグ名
出現パターン
タグ名
出現パターン

<hitachi-connector-property>
1回
<connector>
1回

┣
┃
<description>
0回以上
┣
┃
<description>
0回以上

┣
┃
<display-name>
0回以上
┣
┃
<display-name>
0回以上

┣
┃
<icon>
0回以上
┣
┃
<icon>
0回以上

┃
┃
┣
┃
<small-icon>
0または1回
┃
┃
┣
┃
<small-icon>
0または1回

┃
┃
┗
<large-icon>
0または1回
┃
┃
┗
<large-icon>
0または1回

┣
┃
<vendor-name>
1回
┣
┃
<vendor-name>
1回

┣
┃
<spec-version>
1回
┃
┃
(<connector>タグのversion属性)
－

┣
┃
<eis-type>
1回
┣
┃
<eis-type>
1回

┣
┃
<version>
1回
┣
┃
<resourceadapter-version>
1回

┣
┃
<license>
0または1回
┣
┃
<license>
0または1回

┃
┃
┃
┃
<description>
0回以上
┃
┃
┣
┃
<description>
0回以上

┃
┃
┗
<license-required>
1回
┃
┃
┗
<license-required>
1回

┣
┃
<resourceadapter>
1回
┗
<resourceadapter>
1回

┃
┃
┣
┃
<resourceadapter-class>
0または1回

┣
┃
<resourceadapter-class>
0または1回

┃
┃
┣
┃
<config-property>
0回以上

┣
┃
<config-property>
0回以上

┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┣
┃
<config-property-name>
1回

┃
┃
┣
┃
<config-property-name>
1回

┃
┃
┃
┃
┣
┃
<config-property-type>
1回

┃
┃
┣
┃
<config-property-type>
1回

┃
┃
┃
┃
┗
<config-property-value>
0または1回

┃
┃
┗
<config-property-value>
0または1回

┃
┃
┣
┃
<outbound-resourceadapter>
0または1回

┣
┃
<outbound-resourceadapter>
0または1回

┃
┃
┃
┃
┣
┃
<connection-definition>
1回以上

┃
┃
┣
┃
<connection-definition>
1回以上

┃
┃
┃
┃
┃
┃
┣
┃
<managedconnectionfactory-class>
1回

┃
┃
┃
┃
┣
┃
<managedconnectionfactory-class>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<config-property>
0回以上

┃
┃
┃
┃
┣
┃
<config-property>
0回以上

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
<config-property-name>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<config-property-name>
1回

┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
<config-property-type>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<config-property-type>
1回

┃
┃
┃
┃
┃
┃
┃
┃
┗
<config-property-value>
0または1回

┃
┃
┃
┃
┃
┃
┗
<config-property-value>
0または1回

┃
┃
┃
┃
┃
┃
┣
┃
<connectionfactory-interface>
1回

┃
┃
┃
┃
┣
┃
<connectionfactory-interface>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<connectionfactory-impl-class>
1回

┃
┃
┃
┃
┣
┃
<connectionfactory-impl-class>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<connection-interface>
1回

┃
┃
┃
┃
┣
┃
<connection-interface>
1回

┃
┃
┃
┃
┃
┃
┣
┃
<connection-impl-class>
1回

┃
┃
┃
┃
┗
<connection-impl-class>
1回

┃
┃
┃
┃
┃
┃
┗
<connector-runtime>
0または1回

┃
┃
┃
┃
－
－

┃
┃
┃
┃
┃
┃

(省略)
－

┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<transaction-support>
1回

┃
┃
┣
┃
<transaction-support>
1回

┃
┃
┃
┃
┃
┃
－
－

┃
┃
┣
┃
<authentication-mechanism>
0回以上

┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<description>
0回以上

┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<authentication-mechanism-type>
1回

┃
┃
┃
┃
┃
┃
－
－

┃
┃
┃
┃
┗
<credential-interface>
1回

┃
┃
┃
┃
┗
<reauthentication-support>
1回

┃
┃
┗
<reauthentication-support>
1回

┃
┃
┣
┃
<inbound-resourceadapter>
0または1回

┣
┃
<inbound-resourceadapter>
0または1回

┃
┃
┃
┃
┗
<messageadapter>
0または1回

┃
┃
┗
<messageadapter>
0または1回

┃
┃
┃
┃

┗
<messagelistener>
1回以上

┃
┃

┗
<messagelistener>
1回以上

┃
┃
┃
┃

┣
┃
<messagelistener-type>
1回

┃
┃

┣
┃
<messagelistener-type>
1回

┃
┃
┃
┃

┗
<activationspec>
1回

┃
┃

┗
<activationspec>
1回

┃
┃
┃
┃

┣
┃
<activationspec-class>
1回

┃
┃

┣
┃
<activationspec-class>
1回

┃
┃
┃
┃

┗
<required-config-property>
0回以上

┃
┃

┗
<required-config-property>
0回以上

┃
┃
┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<description>
0回以上

┃
┃
┃
┃

┗
<config-property-name>
1回

┃
┃

┗
<config-property-name>
1回

┃
┃
┣
┃
<adminobject>
0回以上

┣
┃
<adminobject>
0回以上

┃
┃
┃
┃
┣
┃
<adminobject-name>
0または1回

┃
┃
┃
┃
－
－

┃
┃
┃
┃
┣
┃
<adminobject-interface>
1回

┃
┃
┣
┃
<adminobject-interface>
1回

┃
┃
┃
┃
┣
┃
<adminobject-class>
1回

┃
┃
┣
┃
<adminobject-class>
1回

┃
┃
┃
┃
┗
<config-property>
0回以上

┃
┃
┗
<config-property>
0回以上

┃
┃
┃
┃

┣
┃
<description>
0回以上

┃
┃

┣
┃
<description>
0回以上

┃
┃
┃
┃

┣
┃
<config-property-name>
1回

┃
┃

┣
┃
<config-property-name>
1回

┃
┃
┃
┃

┣
┃
<config-property-type>
1回

┃
┃

┣
┃
<config-property-type>
1回

┃
┃
┃
┃

┣
┃
<config-property-value>
0または1回

┃
┃

┣
┃
<config-property-value>
0または1回

┃
┃
┃
┃

┗
<config-property-value>
0または1回

┃
┃

┗
<config-property-value>
0または1回

┃
┃
┗
<security-permission>
0回以上

┗
<security-permission>
0回以上

┃
┃

┣
┃
<description>
0回以上

┣
┃
<description>
0回以上

┃
┃

┗
<security-permission-spec>
1回

┗
<security-permission-spec>
1回

┗
<resourceadapter-runtime>
0または1回
－
－

（凡例）

－：対応するタグがありません。または，対応するタグがないか，タグを省略しているため，出現パターンの説明を省略しています。

(省略)：タグを省略しています。

5.12　JavaBeansリソース属性ファイル

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

＜この節の構成＞

5.12.1　JavaBeansリソース属性ファイルの指定内容

5.12.1　JavaBeansリソース属性ファイルの指定内容

JavaBeansリソース属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-javabeans-resource-property PUBLIC '-//Hitachi, Ltd.//DTD JavaBeans Resource Property 7.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-javabeans-resource-property_7_0.dtd'>

JavaBeansリソース属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-javabeans-resource-property>
1回
ルートタグ。

┣
┃
┃
<description>
0または1回
JavaBeansリソースの説明を記述。

┣
┃
┃
┃
┃
<display-name>
1回
JavaBeansリソースの表示名。
1≦文字列長≦240。
変更する場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。

┣
┃
┃
┃
<res-type>
0または1回
リソースのタイプ。
JavaBeansリソースのクラス名を指定します。<class-name>と同じ名称の場合は省略できます。

┣
┃
┃
<class-name>
1回
実装クラス名。
JavaBeansリソースの実装クラス名を指定します。

┗
<runtime>
1回
－

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

┃
┃
┃
┣
┃
┃
<property-name>
1回
プロパティ名。
JavaBeansリソースのsetメソッド名やgetメソッド名を指定します。

┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<property-type>
1回
プロパティ値のJavaの型。
指定できる型を次に示します。

int

long

short

byte

double

float

boolean

char

java.lang.Integer

java.lang.Long

java.lang.Short

java.lang.Byte

java.lang.Double

java.lang.Float

java.lang.Boolean

java.lang.Character

java.lang.String

┃
┃
┃
┗
<property-value>
0または1回
プロパティの値。

┗
<resource-env-external-property>
0回以上
－

┣
┃
┃
<description>
0または1回
リソース環境の別名の説明。

┗
<optional-name>
1回
リソース環境の別名。
設定する場合，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）および階層区切り文字としてスラッシュ（/）を使用できます。ただし，次の名前は指定できません。

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

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

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

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

文字列の前後に空白，改行がある場合はエラーとなりませんが，取り除かれます。文字列の途中に空白，改行がある場合はエラーとなります。
同一リソース内に<resource-external-property>の指定が複数あり，<optional-name>の指定値がほかの<optional-name>の指定値の下位階層となるような関係の場合は，ワーニングメッセージ（KDJE37602-W）が出力されます。
（例）
別名１：AAA
別名２：AAA/BBB
1≦文字列長≦255

5.13　データソース設定ファイル

データソース設定ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-datasource-configuration PUBLIC '-//Hitachi, Ltd.//DTD DataSource Configuration 6.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-datasource-configuration_6_0.dtd'>

注意

サンプルファイルで提供している属性ファイルなどをサーバ管理コマンド以外の方法で使用する場合，DOCTYPE宣言内のURLの指定をURIに書き直す必要があります。

例

変更前

<!DOCTYPE hitachi-datasource-configuration PUBLIC '-//Hitachi, Ltd.//DTD DataSource Configuration 6.0//EN' 'file:///C:/Program%20Files/Hitachi/Cosminexus/CC/admin/dtds/hitachi-datasource-configuration_6_0.dtd'>

変更後

<!DOCTYPE hitachi-datasource-configuration PUBLIC '-//Hitachi, Ltd.//DTD DataSource Configuration 6.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-datasource-configuration_6_0.dtd'>

データソース設定ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-datasource-configuration>
1回
ルートタグ。

┗
<XADataSource>
0または1回
トランザクション利用の場合に使用するドライバのクラス名。
指定できる値を次に示します。

javax.sql.XADataSourceインタフェースを実装しているクラス。

java.sql.Driverインタフェースを実装しているクラス。

cjimportresコマンドでデータソースをインポートするときに使用するデータソース設定ファイルは，あらかじめエディタなどを使って作成したものを使用するか，次のディレクトリにあるサンプルファイルを使用します。サンプルファイルでは，デフォルトの設定内容が記述されています。

ディレクトリ
ファイル
接続データベース種別
説明

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥templates

UNIXの場合
/opt/Cosminexus/CC/admin/templates

JdbcDbpsv_cf.xml
OracleまたはHiRDB
ベーシックモード用（JdbcDbpsv.jar）

5.14　データソース属性ファイル

データソース属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-datasource-property PUBLIC '-//Hitachi, Ltd.//DTD DataSource Property 6.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-datasource-property_6_0.dtd'>

データソース属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-datasource-property>
1回
ルートタグ。

┣
┃
<description>
0または1回
データソースの説明。

┣
┃
┃
┃
┃
┃
<display-name>
1回
データソース表示名。
1≦文字列長≦240
変更する場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<property>
0回以上
各種プロパティ。※1
<property>の指定が複数あり，<name>の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37600-W）を出力し，後ろに定義された<XADataSource>の値が有効になります。

┃
┣
<name>
1回
プロパティ名。

┃
┃
┃
┃
┃
┗
<XADataSource>
0または1回
XADataSourceインタフェースのプロパティ値。
値は変更できます。
タグの追加，削除は禁止です。

┗
<PoolConfiguration>
0または1回
コネクションプールの設定。※1※2

┣
┃
┃
<MinimumSize>
1回
最小サイズ。
0≦MinimumSize≦MaximumSize

┣
┃
┃
<MaximumSize>
1回
最大サイズ。
-1（無制限）または0≦MaximumSize

┣
┃
┃
┃
┃
┃
┃
<Threshold>
1回
しきい値。
0または1≦Threshold≦MaximumSize
0を指定した場合，使用できるコネクションがない場合にだけプールにコネクションを追加します。

┣
┃
┃
┃
┃
┃
<GrowthIncrement>
1回
増分値。
0または1≦GrowthIncrement≦2147483647
0を指定した場合，プールは増加しません。

┣
┃
┃
┃
┃
┃
<WaitTimeout>
1回
コネクション取得待ち時間（単位：秒）。
-1または0≦WaitTimeout≦2147483647
-1を指定した場合，取得できるまで待ち続けます。

┣
┃
┃
┃
┃
┃
┃
┃
┃
<ConnectionTimeout>
1回
接続タイムアウト（単位：秒）。
0または1≦ConnectionTimeout≦2147483647
0を指定した場合，アクティブではないコネクションがあってもプールから削除されません。

┣
┃
┃
┃
┃
┃
┃
┃
<SweeperInterval>
1回
スイーパ起動間隔（単位：秒）。
0または1≦SweeperInterval≦2147483647
0を指定した場合，アクティブではないコネクションがあってもプールから削除されません。

┣
┃
┃
<RetryCount>
1回
コネクション取得リトライ回数。
0～2147483647

┗
<RetryInterval>
1回
コネクション取得リトライまでの待ち時間（単位：秒）。
1～2147483647

注※1

cjgetrespropコマンドで出力されたものに対し，タグ名の変更，タグの追加・削除，値の変更をしてはいけません。

注※2

すべてのタグを0に設定した場合，コネクションプールは機能しません。

5.15　プール管理情報設定ファイル

プール管理情報設定ファイルは，次に示すDOCTYPE宣言を持ちます。プール管理情報設定ファイルは，Webコンテナのコネクションプール機能を設定する場合に使用するファイルです。

<!DOCTYPE hitachi-webconpool-configuration PUBLIC '-//Hitachi, Ltd.//DTD webconpool Configuration 6.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-webconpool-configuration_6_0.dtd'>

注意

サンプルファイルで提供している属性ファイルなどをサーバ管理コマンド以外の方法で使用する場合，DOCTYPE宣言内のURLの指定をURIに書き直す必要があります。

例

変更前

<!DOCTYPE hitachi-webconpool-configuration PUBLIC '-//Hitachi, Ltd.//DTD webconpool Configuration 6.0//EN' 'file:///C:/Program%20Files/Hitachi/Cosminexus/CC/admin/dtds/hitachi-webconpool-configuration_6_0.dtd'>

変更後

<!DOCTYPE hitachi-webconpool-configuration PUBLIC '-//Hitachi, Ltd.//DTD webconpool Configuration 6.0//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-webconpool-configuration_6_0.dtd'>

プール管理情報設定ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-webconpool-configuration>
1回
ルートタグ。

┣
┃
┃
┃
┃
┃
<DatabaseID>
1回
DBMS名。
一意の名称で指定します。
DBMS名には，英数字（0～9，A～Z，a～z）およびアンダースコア（_）を使用できます。

┣
┃
<ClassName>
0または1回
利用するJDBC実装クラス名。

┣
┃
┃
<URL>
0または1回
利用するデータベースにアクセスするためのデータベースURL。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
<UserCount>
0または1回
プール機能を使用できるユーザ数。
0～2147483647
ユーザ数≧0となるように指定します。
0を指定するとプール機能を使用できるユーザ数に制限がなくなります。
省略した場合は0が設定されます。

┣
┃
┃
┃
┃
<UserID>
0または1回
コネクション取得要求時に，省略された場合に使用されるユーザID。
省略した場合は空文字が設定されます。

┣
┃
┃
┃
┃
<Password>
0または1回
コネクション取得要求時に，省略された場合に使用されるパスワード。
省略した場合は空文字が設定されます。

┣
┃
┃
┃
┃
┃
<MinimumSize>
0または1回
プールに割り当てるデータベースコネクションの最低数。
0～2147483647
省略した場合は0を設定します。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<MaximumSize>
0または1回
プールで使用できるデータベースコネクションの最大数。
0～2147483647
0を指定すると無制限にコネクションを使用できます。ただし，データベースで許容される最大コネクション数によって最大数は制限されます。
省略した場合は0が設定されます。

┣
┃
┃
┃
┃
┃
┃
┃
<RetryInterval>
0または1回
プールからコネクションを取得するときに，コネクション取得のリトライをするまでのアプリケーションの待ち時間（単位：秒）。
0～2147483647
省略した場合は0が設定されます。

┗
<RetryCount>
0または1回
プールからコネクションを取得できなかった場合のリトライ回数。
0～2147483647
コネクションが取得できない場合に，リトライを行わないようにするには0を指定します。
省略した場合は0が設定されます。

cjwebeditpoolコマンドでプール管理情報を登録･変更するときに使用するプール管理情報設定ファイルは，あらかじめエディタなどを使って作成したものを使用するか，次のディレクトリにあるサンプルファイルを使用します。サンプルファイルでは，デフォルトの設定内容が記述されています。

ディレクトリ
ファイル

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥examples¥webpoolconf

UNIXの場合
/opt/Cosminexus/CC/examples/webpoolconf

Webconpool.xml

5.16　メール属性ファイル

メール属性ファイルは，次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-mail-property PUBLIC '-//Hitachi, Ltd.//DTD Mail Property 7.1//EN' 'file://<Cosminexusのインストールディレクトリ>/CC/admin/dtds/hitachi-mail-property_7_1.dtd'>

メール属性ファイルは，次に示すタグを持つxmlファイルです。

タグ名
出現パターン
説明

<hitachi-mail-property>
1回
ルートタグ。

┣
┃
┃
<description>
0または1回
設定情報についての説明。

┣
┃
┃
┃
┃
┃
┃
┃
┃
<display-name>
1回
メール表示名。
1≦文字列長≦240
変更する場合，英数字（0～9，A～Z，a～z），およびアンダースコア（_）を使用できます。
cjsetrespropコマンドの-resnameで指定した名前が存在しない（新規追加）場合，この文字列は無視されます。

┣
<from>
1回
送信者のメールアドレス。

┣
┃
<server>
1回
メールサーバのホスト名またはIPアドレス。

┗
<runtime>
0または1回
－

┗
<resource-external-property>
0回以上
<resource-external-property>の指定が複数あり，<optional-name>の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE37600-W）が出力され，後ろに定義された<resource-external-property>の<res-auth>や<res-sharing-scope>の値が有効になります。

┣
┃
┃
<description>
0または1回
リソースの別名の説明。

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<optional-name>
1回
リソースの別名（別名）。
設定する場合，英数字（0～9，A～Z，a～z），アンダースコア（_），ピリオド（.）および階層区切り文字としてスラッシュ（/）を使用できます。ただし，次の名前は指定できません。

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

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

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

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

文字列の前後に空白，改行がある場合はエラーとなりませんが，取り除かれます。文字列の途中に空白，改行がある場合はエラーとなります。
同一リソース内に<resource-external-property>の指定が複数あり，<optional-name>の指定値がほかの<optional-name>の指定値の下位階層となるような関係の場合は，ワーニングメッセージ（KDJE37602-W）が出力されます。
（例）
別名１：AAA
別名２：AAA/BBB
1≦文字列長≦255

┣
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
┃
<res-auth>
0または1回
リソースを使用するための認証元を，アプリケーション上で行うか，コンテナに任せるかの指定。
指定できる文字列を次に示します。

Application

Container

デフォルトはContainerです。

┗
<res-sharing-scope>
0または1回
リソース接続を共有するかどうかの指定。
指定できる文字列を次に示します。

Shareable

Unshareable

デフォルトはShareableです。

6.　CTMで使用するファイル

この章では，CTMで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

6.1　CTMで使用するファイルの一覧

6.2　CTMユーザ環境変数定義ファイル

6.3　CTMコマンドオプションファイル

6.1　CTMで使用するファイルの一覧

CTMで使用するファイルの一覧を，次の表に示します。

表6-1　CTMで使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
（任意）※ | CTMユーザ環境変数定義ファイル | ctmstartコマンド（CTMデーモンの開始）を実行するときに必要な環境変数を指定します。 | 6.2
（任意）※ | CTMコマンドオプションファイル | ctmstartコマンド（CTMデーモンの開始）を実行するときに，CTMレギュレータを自動開始するために指定する引数（コマンドオプション）をあらかじめファイルに指定します。 | 6.3

注※

使用できる文字は，Windowsの場合，英数字，ピリオド（.），円符号（¥），コロン（:），プラス（+），またはハイフン（-）です。UNIXの場合，英数字，ピリオド（.），スラッシュ（/），プラス（+），またはハイフン（-）です。

なお，CTMを使用してリクエストのスケジューリングや負荷分散をするためには，表6-1に示したファイルのほかに，J2EEサーバ用usrconf.propertiesファイルで，CTMの使用の有無，CTMドメイン名，CTMデーモンのCTM識別子，CTMが使用するホスト名などを指定する必要があります。J2EEサーバ用usrconf.propertiesファイルのCTMのキーについては，「2.4(5)(g)　ejbserver.ctmから始まるキー」を参照してください。

6.2　CTMユーザ環境変数定義ファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

次の形式で指定します。

<環境変数名称>=<値>

環境変数名称，イコール（=），および値のどれも省略できません。

行の先頭から最初のイコール（=）の直前までが，環境変数名称とみなされます。

最初のイコール（=）の直後からその行またはファイルの終端の直前までが値とみなされます。

シャープ（#）で始まる行はコメントとみなされます。行の途中にシャープ（#）がある場合は，シャープ（#）以降から行の最後までがコメントとみなされます。シャープ（#）の手前の空白およびタブは無視されます。

シャープ（#）は値には指定できません。

一つの定義を複数行に分けて記述する場合は，改行の直前に継続符号（¥）を記述します。継続符号（¥）の直前の空白およびタブは無視されます。行の途中に継続符号（¥）がある場合は，継続記号（¥）以降から行の最後までがコメントとみなされます。このため，継続記号（¥）は行の最後に指定してください。

指定された環境変数と同一の環境変数名称がすでに存在する場合は，指定した値で上書きされます。同一の環境変数名称がない場合は追加されます。

(2)　ファイルの格納先

格納先およびファイル名称は任意です。ファイル名には次の文字が使用できます。

Windowsの場合
英数字，ピリオド（.），円符号（¥），コロン（:），プラス（+），またはハイフン（-）

UNIXの場合
英数字，ピリオド（.），スラッシュ（/），プラス（+），またはハイフン（-）

(3)　機能

ctmstartコマンド（CTMデーモンの開始）を実行するときに必要な環境変数を指定します。

(4)　指定できるキー

任意の環境変数名称を指定できます。ただし，次の環境変数名称は指定できません。

先頭が"CTM"または"ctm"で始まる環境変数名称

(5)　記述例

Windowsの場合

# コメント行
LANG=ja_JP.SJIS                         # 以降コメント
C:¥Program Files¥HITACHI¥Cosminexus¥CTM¥lib¥ctmj2sv.jar:    ¥
C:¥Program Files¥HITACHI¥Cosminexus¥java¥classes.zip        # 継続行

UNIXの場合

# コメント行
LANG=ja_JP.SJIS                         # 以降コメント
CLPATH=/opt/Cosminexus/CTM/lib/ctmj2sv.jar:    ¥
/opt/java/lib/classes.zip               # 継続行

(6)　注意事項

先頭が"CTM"または"ctm"で始まる環境変数名称は使用できません。

環境変数名称には，英数字またはアンダースコア（_）で構成される文字列が指定できます。

行の先頭から環境変数名称までは空白およびタブは記述できません。行の先頭から環境変数名称を記述する必要があります。

環境変数名称とイコール（=）の間，およびイコール（=）と環境変数定義の間に空白およびタブを記述できません。

環境変数定義ファイル中に，%AAA%（Windowsの場合），または$AAA（UNIXの場合）の記述がある場合，これらはそのままの文字列として認識されます。環境変数AAAとしては展開されません。

空行（環境変数定義もコメントもない行）を記述する場合は，空白およびタブを含めないで改行コードだけを指定してください。

次に示す場合は定義内容が不正とみなされます。

環境変数定義内にイコール（=）がない場合

行の先頭または最後にイコール（=）がある場合

環境変数名称の先頭が"CTM"または"ctm"で始まる場合

空白またはタブだけの行がある場合

6.3　CTMコマンドオプションファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

次の形式で指定します。

<引数> ＜値＞

(2)　ファイルの格納先

格納先およびファイル名称は任意です。ファイル名には次の文字が使用できます。

Windowsの場合
英数字，ピリオド（.），円符号（¥），コロン（:），プラス（+），またはハイフン（-）

UNIXの場合
英数字，ピリオド（.），スラッシュ（/），プラス（+），またはハイフン（-）

(3)　機能

ctmstartコマンド（CTMデーモンの開始）を実行するときに，CTMレギュレータを自動開始するために指定する引数（コマンドオプション）をあらかじめファイルに指定しておきます。ctmstartコマンドの-CTMRegOptionオプションにファイル名を指定すると，このファイルに指定した内容を基にCTMレギュレータが自動開始されます。

なお，-CTMRegStartオプションが指定されていない場合，-CTMRegOptionオプションの指定およびこのファイルの指定内容は無視されます。

(4)　指定できるキー

ctmregltdコマンドの引数を指定できます。ctmregltdコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。なお，このファイルの指定を省略した場合，CTMレギュレータは，ctmstartコマンドに指定した引数のうち，-CTMPortと-CTMEjbPort以外の引数をデフォルト値として引き継ぎます。

(5)　記述例

-CTMClientConnectCount 64

(6)　注意事項

コマンドオプションファイルには英数字，空白，ハイフン（-），ピリオド（.），またはスラッシュ（/）を記述できます。

コマンドオプション以外は記述しないでください。

7.　Webサーバ連携で使用するファイル

この章では，Webサーバ連携で使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

7.1　Webサーバ連携で使用するファイルの一覧

7.2　isapi_redirect.conf（Microsoft IIS用リダイレクタ動作定義ファイル）

7.3　mod_jk.conf（Hitachi Web Server用リダイレクタ動作定義ファイル）

7.4　uriworkermap.properties（Microsoft IIS用マッピング定義ファイル）

7.5　workers.properties（ワーカ定義ファイル）

7.1　Webサーバ連携で使用するファイルの一覧

Webサーバ連携で使用するファイルの一覧を，次の表に示します。

表7-1　Webサーバ連携で使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
isapi_redirect.conf | Microsoft IIS用リダイレクタ動作定義ファイル | Microsoft IIS用リダイレクタの動作を定義します。 | 7.2
mod_jk.conf | Hitachi Web Server用リダイレクタ動作定義ファイル | Hitachi Web Server用リダイレクタの動作を定義します。 | 7.3
uriworkermap.properties | Microsoft IIS用マッピング定義ファイル | Microsoft IISへのリクエストでどのURLパターンがWebコンテナサーバに転送されるかを定義します。 | 7.4
workers.properties | ワーカ定義ファイル | リダイレクタの動作を定義します。 | 7.5

7.2　isapi_redirect.conf（Microsoft IIS用リダイレクタ動作定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。キー名称として定義されていないパラメタを定義しても無視されます。

(2)　ファイルの格納先

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥isapi_redirect.conf

(3)　機能

Microsoft IIS用リダイレクタの動作パラメタを定義します。

(4)　指定できるキー

指定できるキーとデフォルト値を次に示します。このキーに不正な値を指定した場合，動作は保証されません。

キー名称
内容
デフォルト値

connection_sharing
ワーカ間でコネクションを共有するかどうかを指定します。

trueを指定した場合：

同一ホスト，同一ポートへ接続するワーカは，ワーカ定義が異なってもコネクションを共有します。

falseを指定した場合：

ワーカ定義が異なるワーカ間のコネクションは共有しません。

true

connect_timeout
リクエスト送信時のWebコンテナに対するコネクション確立のタイムアウト値を0～3600の整数（単位：秒）で指定します。
数値以外の文字列や範囲外の数値を指定した場合は，メッセージを出力し，デフォルト値を使用します。
タイムアウト値に0，またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合，TCPの持つタイムアウト値になります。その場合，不正なタイムアウト値が指定されたことを示すメッセージは出力されません。
30

filter_priority
リダイレクタをISAPIフィルタとして登録する際の，優先順序を指定します。
指定できる文字列を次に示します。

hight（優先順序を「高」にする）

medium（優先順序を「中」にする）

low（優先順序を「低」にする）

high

gateway_host
ゲートウェイのホスト名またはIPアドレスを指定します。
Hostヘッダのないリクエストをwelcomeファイルなどにリダイレクトする場合，Locationヘッダに指定するURLのホスト名部分が指定値になります。
なし

gateway_https_scheme
クライアントからのリクエストのスキームがhttpsであり，かつSSLアクセラレータなどを介すことでWebサーバへのスキームがhttpとなる場合に，trueを指定します。
trueを指定した場合，Webサーバへのリクエストのスキームがhttpsであるとみなされます。falseを指定した場合は，何も実行されません。
false

gateway_port
ゲートウェイのポート番号を指定します。Hostヘッダのないリクエストに対して，welcomeファイルなどにリダイレクトするとき，Locationヘッダに指定するURLのポート番号部分が指定値になります。このパラメタを指定した場合は，gateway_hostも必ず指定してください。
gateway_hostを指定してこのパラメタを省略した場合，httpによるアクセスの場合は80，httpsによるアクセスの場合は443が使用されます。
なし

log_file_dir
ログファイルの出力先ディレクトリを指定します。

相対パスで指定した場合：

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector以下のディレクトリ名を指します。

絶対パスで指定した場合：

記述されたディレクトリ名を指します。

なお，出力先として指定したディレクトリのアクセス権にUsersグループに対する書き込み権限を設定する必要があります。アクセス権を設定していない場合，ログファイルが出力されません。
log_file_prefixとtrace_log_file_prefixに同じ値を指定した場合は，このキーにtrace_log_file_dirとは異なる値を指定する必要があります。同じ値が指定された場合，リダイレクタは動作しません。
logs

log_file_num
リダイレクタ用ログファイルの最大数を指定します。この数を超えると古いログファイルは上書きされます。
1～64の整数値を指定します。
5

log_file_prefix
ログファイル名のプリフィックスです。実際のログファイル名は，このキーの指定値に<通番>.logが付けられたものになります。
log_file_dirとtrace_log_file_dirに同じ値を指定した場合は，このキーにtrace_log_file_prefixとは異なる値を指定する必要があります。同じ値が指定された場合，リダイレクタは動作しません。
isapi_redirect

log_file_size
リダイレクタ用ログファイルの一つ当たりのサイズをバイト単位で指定します。
4096～16777216の整数値を指定します。
4194304

log_level
リダイレクタ用ログファイルの出力レベルを指定します。指定するログレベルを一つだけ指定します。
debug，info，errorを指定できます。
error

prf_id
PRFデーモン起動時にPRF識別子に指定した文字列を指定します。
なし

receive_client_timeout
クライアントからPOSTデータを受信するときのタイムアウト時間を秒単位で指定します。
60～3600の整数値を60（秒）の倍数で指定します。
指定された値が60の倍数になっていない場合は，60の倍数に切り上げた値がタイムアウト時間になります。
300

request_retry_count
リクエスト送信時のWebコンテナに対するコネクション確立，およびリクエスト送信のリトライ回数を，1～16の整数（単位：回）で指定します。
リトライ回数には，初回のコネクション確立およびリクエスト送信処理も含まれます。
タイムアウトが発生した場合，リトライするケースは次のとおりです。

コネクション確立時にタイムアウトした場合

リクエストヘッダ送信時にタイムアウトした場合

上記処理以降の，リクエストボディの送信時にタイムアウトが発生した場合は，リトライは行いません。
リトライ回数に，範囲外の値や，整数値でない値などの異常値を設定した場合，デフォルト値が設定されます。
3

send_timeout
リクエスト送信のタイムアウト値を0～3600の整数（単位：秒）で指定します。
数値以外の文字列や範囲外の数値を指定した場合は，メッセージを出力し，デフォルト値を使用します。
タイムアウト値に0，またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合，TCPの持つタイムアウト値になります。その場合，不正なタイムアウト値が指定されたことを示すメッセージは出力されません。
100

trace_log
リダイレクタの保守用トレースログを出力するかどうかを指定します。出力する場合はtrueを，出力しない場合はfalseを指定します。
true

trace_log_file_dir
保守用トレースログファイルの出力先ディレクトリを指定します。

相対パスで記述した場合：

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector以下のディレクトリ名を指します。

絶対パスで記述した場合：

記述されたディレクトリ名を指します。

なお，出力先として指定したディレクトリのアクセス権にUsersグループに対する書き込み権限を設定する必要があります※。アクセス権を設定していない場合，ログファイルが出力されません。
log_file_prefixとtrace_log_file_prefixに同じ値を指定した場合は，このキーにlog_file_dirとは異なる値を指定する必要があります。同じ値が指定された場合，リダイレクタは動作しません。
logs

trace_log_file_num
保守用トレースログファイルの最大数を指定します。この数を超えると古いログファイルは上書きされます。
1～64の整数値を指定します。
4

trace_log_file_prefix
保守用トレースログファイル名のプリフィックスを指定します。実際のログファイル名は，このキーの指定値に<通番>.logが付加されたものになります。
log_file_dirとtrace_log_file_dirに同じ値を指定した場合は，このキーにlog_file_prefixとは異なる値を指定する必要があります。同じ値が指定された場合，リダイレクタは動作しません。
iis_rd_trace

trace_log_file_size
保守用トレースログファイルの一つ当たりのサイズをバイト単位で指定します。
4096～16777216の整数値を指定します。
16777216

worker_file
ワーカ定義ファイルの位置とファイル名を指定します。

相対パスで指定した場合：

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector以下のファイル名を指します。

絶対パスで指定した場合：

記述されたファイル名を指します。

workers.properties

worker_mount_file
マッピング定義ファイルの位置とファイル名を指定します。

相対パスで指定した場合：

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector以下のファイル名を指します。

絶対パスで指定した場合：

記述されたファイル名を指します。

uriworkermap.properties

注※　IIS6.0と連携する場合

新規インストール時には，デフォルトのログ出力先ディレクトリは存在しません。ディレクトリを作成してアクセス権を設定するか，一つ上のディレクトリredirectorへアクセス権を設定してください。

また，リダイレクタのログ出力先ディレクトリを変更し，そのパスが途中までしか存在しない場合，存在する最下層のディレクトリに対してアクセス権を設定するか，指定したパスをすべて作成し，アクセス権を設定してください。

(5)　記述例

gateway_host=hostA
gateway_https_scheme=true
gateway_port=443

log_level=error
log_file_size=4194304
log_file_num=5
log_file_dir=logs
log_file_prefix=isapi_redirect
prf_id=prfid
trace_log=true
trace_log_file_size=16777216
trace_log_file_num=4
trace_log_file_dir=logs
trace_log_file_prefix=iis_rd_trace
receive_client_timeout=300
worker_file=workers.properties
worker_mount_file=uriworkermap.properties

(6)　注意事項

このファイルを編集してリダイレクタのユーザ定義を変更した場合，Webサーバを再起動する必要があります。変更した定義は，Webサーバを再起動したあとに反映されます。

Web Redirectorを使用する場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCR」と読み替えてください。

7.3　mod_jk.conf（Hitachi Web Server用リダイレクタ動作定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

次のようにキーを指定します。

<キー名称> <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

キー名称と値は半角スペースで区切ります。また，値を複数指定する場合も半角スペースで区切ります。

指定する値がファイルパスでスペースを含む場合は，パス全体を""（ダブルクォーテーション）で囲む必要があります。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥mod_jk.conf

UNIXの場合
/opt/Cosminexus/CC/web/redirector/mod_jk.conf

(3)　機能

リダイレクタの動作を定義します。

(4)　指定できるキー

モジュール定義

WebコンテナサーバとHitachi Web Server間の通信を処理するためにライブラリを定義します。

形式

LoadModule jk_module <ライブラリ名>

ライブラリ名を絶対パスで指定します。なお，複数指定はできません。

指定例

Windowsの場合

LoadModule jk_module "<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥mod_jk.dll"

UNIXの場合

LoadModule jk_module /opt/Cosminexus/CC/web/redirector/mod_jk.so

注意事項

モジュール定義を指定するキーは，ほかのキーよりも前に記述する必要があります。

マッピング定義

Hitachi Web ServerへのリクエストでどのURLパターンがWebコンテナサーバに転送されるかを定義します。

形式

JkMount <URLパターン> <ワーカ名>

workers.propertiesのworker.listで指定されているワーカのどれかを記述します。URLパターンとワーカ名の組み合わせを複数記述できます。このファイルに不正な値を設定した場合，動作は保証されません。

リダイレクタ定義

次に示すキーを指定できます。ただし，このキーに不正な値を指定した場合，動作は保証されません。

キー名称
内容
デフォルト値

JkConnectTimeout
リクエスト送信時のWebコンテナに対するコネクション確立のタイムアウト値を，0～3600の整数（単位：秒）で指定します。
数値以外の文字列や範囲外の数値を指定した場合は，メッセージを出力し，デフォルト値を使用します。
タイムアウト値に0，またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合，TCPの持つタイムアウト値になります。その場合，不正なタイムアウト値が指定されたことを示すメッセージは出力されません。
30

JkGatewayHost
ゲートウェイのホスト名またはIPアドレスを指定します。
Hostヘッダのないリクエストに対してwelcomeファイルなどへリダイレクトする場合，Locationヘッダに指定するURLのホスト名部分が指定値になります。
なし

JkGatewayHttpsScheme
クライアントからのリクエストのスキームがhttpsであり，かつSSLアクセラレータなどを介すことでWebサーバへのスキームがhttpとなる場合に，Onを指定します。
Onを指定した場合，Webサーバへのリクエストのスキームがhttpsであるとみなされます。Offを指定した場合，何も実行されません。
Off

JkGatewayPort
ゲートウェイのポート番号を指定します。Hostヘッダのないリクエストをwelcomeファイルなどにリダイレクトする場合，Locationヘッダに指定するURLのポート番号部分が指定値となります。
このパラメタを指定した場合は，必ずJkGatewayHostも指定してください。
JkGatewayHostを指定してこのパラメタを省略した場合，httpによるアクセスであれば80，httpsによるアクセスであれば443が使用されます。
なし

JkLogFileDir
ログファイルの出力先ディレクトリを指定します。Windowsの場合，相対パスまたは絶対パスで指定してください。UNIXの場合，絶対パスで指定してください。

相対パスで指定した場合：

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector以下のディレクトリ名を指します。

絶対パスで指定した場合：

記述されたディレクトリ名を指します。

なお，出力先として指定したディレクトリのアクセス権にHitachi Web Serverの実行アカウントの書き込み権限を設定する必要があります※1。アクセス権を設定していない場合，ログファイルが出力されません。
JkLogFilePrefixとJkTraceLogFilePrefixに同じ値を指定した場合は，このキーにJkTraceLogFileDirとは異なる値を指定する必要があります。同じ値が指定された場合，リダイレクタは動作しません。

Windowsの場合
logs

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs

JkLogFileNum
リダイレクタ用ログファイルの最大数を指定します。この値を超えると古いログファイルは上書きされます。次の範囲の整数値を指定してください。

Windowsの場合
1≦JkLogFileNum≦16

UNIXの場合
1≦JkLogFileNum≦64

5

JkLogFilePrefix
ログファイル名のプリフィックスです。実際のログファイル名は，指定値に<通番>.logが付加されたものとなります。
JkLogFileDirとJkTraceLogFileDirに同じ値を指定した場合は，このキーにJkTraceLogFilePrefixとは異なる値を指定する必要があります。同じ値が指定された場合，リダイレクタは動作しません。
hws_redirect

JkLogFileSize
リダイレクタ用ログファイルの一つ当たりのサイズ（バイト）を指定します。次の範囲の整数値を指定してください。

Windowsの場合
4096≦JkLogFileSize≦2147483647

UNIXの場合
4096≦JkLogFileSize≦16777216

4194304

JkLogLevel
リダイレクタ用ログファイルの出力レベルを指定します。指定するログレベルを一つだけ指定します。debug，info，error（デフォルト値），およびemergを指定できます。なお，emergは，Windowsの場合だけ指定できる値です。
これら以外の値を指定した場合は，errorが指定されたものとして動作します。
error

JkModulePriority
Hitachi Web Serverへリダイレクタ以外の外部モジュールを登録する場合に，ほかの外部モジュールに対するリダイレクタの実行順位を指定します。
指定できる値を次に示します。

-10～30の整数

REALLY_FIRST（整数値の-10に対応）

FIRST（整数値の0に対応）

MIDDLE（整数値の10に対応）

LAST（整数値の20に対応）

REALLY_LAST（整数値の30に対応）

実行順位は指定する値が小さい程高くなります。
FIRST

JkOptions
リクエストURLのURLデコードを行うかどうかを指定します。なお，このキーはUNIX用です。

ForwardURICompatUnparsed（デフォルト）：

リクエストURLのURLデコードを行いません。

ForwardURICompat：

リクエストURLのURLデコードを行います。

02-00ではURLデコードを行っていたため，URLデコードによって変換される文字列を含むURLを使用する場合，02-00と同様にURLデコードを行う必要があるときだけForwardURICompatを指定してください。
ForwardURICompatUnparsed

JkPrfId
PRFデーモン起動時にPRF識別子に指定した文字列を指定します。
なし

JkRequestRetryCount
リクエスト送信時のWebコンテナに対するコネクション確立，およびリクエスト送信のリトライ回数を，1～16の整数（単位：回）で指定します。
リトライ回数には，初回のコネクション確立およびリクエスト送信処理も含まれます。
タイムアウトが発生した場合，リトライするケースは次のとおりです。

コネクション確立時にタイムアウトした場合

リクエストヘッダ送信時にタイムアウトした場合

上記処理以降の，リクエストボディの送信時にタイムアウトが発生した場合は，リトライは行いません。
リトライ回数に，範囲外の値や，整数値でない値などの異常値を設定した場合，デフォルト値が設定されます。
3

JkSendTimeout
リクエスト送信のタイムアウト値を0～3600の整数（単位：秒）で指定します。
数値以外の文字列や範囲外の数値を指定した場合は，メッセージを出力し，デフォルト値を使用します。
タイムアウト値に0，またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合，TCPの持つタイムアウト値になります。その場合，不正なタイムアウト値が指定されたことを示すメッセージは出力されません。
100

JkTraceLog
リダイレクタの保守用トレースログを出力するかどうかを指定します。出力する場合はOn（デフォルト値）を，出力しない場合はOffを指定します。
On

JkTraceLogFileDir
保守用トレースログファイルの出力先ディレクトリを指定します。Windowsの場合，相対パスまたは絶対パスで指定してください。UNIXの場合，絶対パスで指定してください。

相対パスで記述した場合：

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector以下のディレクトリ名を指します。

絶対パスで記述した場合：

記述されたディレクトリ名を指します。

JkLogFilePrefixとJkTraceLogFilePrefixに同じ値を指定した場合は，このキーにJkLogFileDirとは異なる値を指定する必要があります。同じ値が指定された場合，リダイレクタは動作しません。

Windowsの場合
logs

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs

JkTraceLogFileNum
保守用トレースログファイルの最大数を整数値で指定します。

Windowsの場合
1～16

UNIXの場合
1～64

この数を超えると古いログファイルは上書きされます。
4

JkTraceLogFilePrefix
保守用トレースログファイル名のプリフィックスを指定します。実際のログファイル名は，このキーの指定値に<通番>.logが付加されたものとなります。
JkLogFileDirとJkTraceLogFileDirに同じ値を指定した場合は，このキーにJkLogFilePrefixとは異なる値を指定する必要があります。同じ値が指定された場合，リダイレクタは動作しません。
hws_rd_trace

JkTraceLogFileSize
保守用トレースログファイルの一つ当たりのサイズを整数値（単位：バイト）で指定します。

Windowsの場合
4096～2147483647

UNIXの場合
4096～16777216

16777216

JkTranslateBackcompat
05-05以前のバージョンの互換用のキーです。
Hitachi Web ServerへのリクエストがWebコンテナに転送させるURLパターンであった場合，リダイレクタよりあとに実行されるモジュールのtranslate_handler関数がHitachi Web Serverから呼び出されるようにするかどうかを指定します。
Onを指定した場合，リダイレクタの次に実行されるモジュールのtranslate_handler関数が呼び出されます。
Offを指定した場合，リダイレクタよりあとに実行されるモジュールのtranslate_handler関数は呼び出されません。
Off

JkWorkersFile
ワーカ定義ファイルのファイル名を指定します。Windowsの場合，相対パスまたは絶対パスで指定してください。UNIXの場合，絶対パスで指定してください。

相対パスで指定した場合：

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector以下のファイル名を指します。

絶対パスで指定した場合：

記述されたファイル名を指します。

Windowsの場合
workers.properties

UNIXの場合
/opt/Cosminexus/CC/web/redirector/workers.properties※2

注

キー名称に複数の値を指定した場合，最後に指定した値が有効になります。

注※1　Hitachi Web Serverと連携する場合

新規インストール時には，デフォルトのログ出力先ディレクトリは存在しません。ディレクトリを作成してアクセス権を設定するか，一つ上のディレクトリredirectorにアクセス権を設定してください。

また，リダイレクタのログ出力先ディレクトリを変更し，そのパスが途中までしか存在しない場合，存在する最下層のディレクトリに対してアクセス権を設定するか，指定したパスをすべて作成し，アクセス権を設定してください。

注※2

/opt/Cosminexus/CC/web/redirector/workers.propertiesが存在しない場合，Hitachi Web Serverは起動しません。

(5)　記述例

Windowsの場合

LoadModule jk_module "C:¥Program Files¥Hitachi¥Cosminexus¥CC¥web¥redirector¥mod_jk.dll"※

JkGatewayHost hostA
JkGatewayHttpsScheme On
JkGatewayPort 443

JkLogLevel error
JkLogFileSize 4194304
JkLogFileNum 5
JkLogFileDir logs
JkLogFilePrefix hws_redirect
JkPrfId prfid
JkTraceLog On
JkTraceLogFileSize 16777216
JkTraceLogFileNum 4
JkTraceLogFileDir logs
JkTraceLogFilePrefix hws_rd_trace
JkTranslateBackcompat Off
JkWorkersFile workers.properties

JkMount /examples/* worker1

注※

LoadModuleの指定は，ファイル上では1行で記述してください。

UNIXの場合

LoadModule jk_module /opt/Cosminexus/CC/web/redirector/mod_jk.so
JkWorkersFile /opt/Cosminexus/CC/web/redirector/workers.properties

JkLogLevel error
JkLogFileSize 4194304
JkLogFileNum 5
JkLogFileDir /opt/Cosminexus/CC/web/redirector/logs
JkLogFilePrefix hws_redirect

JkTraceLog On
JkTraceLogFileSize 16777216
JkTraceLogFileNum 4
JkTraceLogFileDir /opt/Cosminexus/CC/web/redirector/logs
JkTraceLogFilePrefix hws_rd_trace

JkMount /examples/* worker1

(6)　注意事項

Windowsの場合，リダイレクタのユーザ定義を変更するには，Webサーバを再起動する必要があります。変更した定義は，Webサーバを再起動したあとに反映されます。

UNIXの場合，リダイレクタのユーザ定義を変更して，変更内容を反映させるには，次の操作が必要です。

ファイルサイズまたはファイル面数を変更する場合

Webサーバを停止します。

ログファイルおよびHNTRLibが使用する管理ファイルを，移動または削除します。
＜HNTRLibが使用する管理ファイル＞
メッセージログファイルの場合：<JkLogFilePrefixの設定値>.mm
保守用トレースログファイルの場合：<JkTraceLogFilePrefixの設定値>.mm

Webサーバを起動します。

ファイルサイズまたはファイル面数を変更しない場合

Webサーバを再起動します。

Web Redirectorを使用する場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC，または/opt/Cosminexus/CC」を，「<Cosminexusのインストールディレクトリ>¥CCR，または/opt/Cosminexus/CCR」と読み替えてください。

7.4　uriworkermap.properties（Microsoft IIS用マッピング定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。キー名称として定義されていないパラメタを定義しても無視されます。

(2)　ファイルの格納先

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥uriworkermap.properties

(3)　機能

uriworkermap.propertiesは，Microsoft IISへのリクエストでどのURLパターンがWebコンテナサーバに転送されるかを定義します。

(4)　指定できるキー

workers.propertiesのworker.listで指定されているワーカのどれかを記述します。URLパターンとワーカ名の組み合わせを複数記述できます。このファイルに不正な値を設定した場合，動作は保証されません。

<URLパターン> = <ワーカ名>

(5)　記述例

/examples/*=worker1

(6)　注意事項

リダイレクタのユーザ定義を変更した場合，Webサーバを再起動する必要があります。変更した定義は，Webサーバを再起動したあとに反映されます。

Web Redirectorを使用する場合は，「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCR」と読み替えてください。

7.5　workers.properties（ワーカ定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。キー名称として定義されていないパラメタを定義しても無視されます。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥workers.properties

UNIXの場合
/opt/Cosminexus/CC/web/redirector/workers.properties

(3)　機能

ワーカを定義し，ワーカごとにパラメタを設定して，リダイレクタの動作を定義します。

(4)　指定できるキー

ワーカ定義ファイルに指定できるキーと，ワーカごとの定義パラメタについて説明します。

(a)　ワーカ定義ファイルに指定できるキー

ワーカ，およびワーカごとの各パラメタを定義します。このキーに不正な値を設定した場合，動作は保証されません。

キー名称
内容
デフォルト値

worker.list
ワーカ名のリストを指定します。複数ある場合は，コンマ（,）で区切ります。一つ以上のワーカ名を必ず指定する必要があります。
なし

worker.<ワーカ名>.<パラメタ>
ワーカごとの定義パラメタを指定します。worker.listに記述されたワーカごとに設定します。
定義パラメタについては，「(b)　ワーカごとの定義パラメタ」を参照してください。
なし

(b)　ワーカごとの定義パラメタ

定義できるパラメタ
内容
デフォルト値

worker.<ワーカ名>.balanced_workers
負荷分散の対象となるワーカのリストを指定します。複数ある場合は，コンマ（,）で区切ります。
なし

worker.<ワーカ名>.cachesize
リダイレクタで再利用するワーカとのコネクション数を，1～2147483647の整数で指定します。なお，このパラメタはWindows用です。
ワーカとのコネクションは，この設定値以内の場合はリダイレクタ内に保持し，該当ワーカへの通信に再利用され，接続先のJ2EEサーバ，またはWebコンテナサーバが終了するまで解放しません。リクエストの多重度が設定値を超えた場合は，設定値を超えたリクエストだけをリクエスト単位にワーカとのコネクションの確立，解放を行います。
この値は次に示す式に従ってメモリを消費します。
（式）
メモリ消費量=（worker.<ワーカ名>.cachesizeの値）×10KB
64

worker.<ワーカ名>.default_worker
デフォルトワーカのワーカ名を指定します。POSTリクエスト転送先ワーカに指定したワーカと同じワーカを指定した場合，指定したワーカには，POSTデータサイズによる振り分け条件を満たすリクエスト，およびデフォルトワーカとして条件を満たすリクエストが転送されます。
なお，このパラメタにPOSTリクエスト転送先ワーカに指定していないワーカを指定し，そのワーカにworker.<ワーカ名>.post_dataが指定されている場合，worker.<ワーカ名>.post_data定義は無視されます。
ワーカ名の前後の空白文字（スペース，タブ，およびフォームフィード）は無視されます。
このパラメタの指定を省略した場合や空文字列を指定した場合など，転送条件を満たすワーカが存在しないリクエストに対してエラーが返されます。
なし

worker.<ワーカ名>.delegate_error_code
エラーページの委任機能を利用するエラーステータスコードを指定します。※複数指定する場合はコンマ（,）で区切って指定します。
なし

worker.<ワーカ名>.host
ワーカのホスト名，またはIPアドレスを指定します。
なし

worker.<ワーカ名>.lbfactor
負荷分散値を指定します。設定する値は0よりも大きくしてください。なお，値として小数値を指定することもできます。
1

worker.<ワーカ名>.port
ワーカのポート番号を，1～65535の整数で指定します。
すでにほかのアプリケーションで使用，または確保されているポート番号は指定できません。
なし

worker.<ワーカ名>.post_data
<ワーカ名>に指定したワーカに転送するリクエストのContent-Lengthヘッダの値の上限値に1を加えた値を次のように指定します。

1～2147483648の整数（単位：バイト）

1～2097152の整数に「k」または「K」を付加した値（単位：キロバイト）

1～2048の整数に「m」または「M」を付加した値（単位：メガバイト）

Content-Lengthヘッダの値が指定値未満のリクエストを，<ワーカ名>に指定したワーカに転送します。
worker.<ワーカ名>.post_size_workersパラメタに複数のワーカを設定している場合，リクエストのContent-Lengthヘッダの値が指定値未満，かつ指定値が最も小さいワーカにリクエストは転送されます。
worker.<POSTリクエスト振り分けワーカのワーカ名>.post_size_workersパラメタで指定した，ほかのワーカと同じ値は設定しないでください。
値の前後の空白文字（スペース，タブ，フォームフィード）は無視されます。
なし

worker.<ワーカ名>.post_size_workers
POSTリクエスト転送先ワーカのワーカ名のリストを指定します。複数指定する場合は，コンマ（,）で区切って指定します。ただし，同じワーカ名は指定できません。
ワーカ名の前後の空白文字（スペース，タブ，フォームフィード）は無視されます。
なし

worker.<ワーカ名>.receive_timeout
通信タイムアウト値を指定します。レスポンスデータを待つ時間を0～3600の整数値（単位：秒）で指定します。0を指定した場合，レスポンスを受け取るまで待ち続け，通信タイムアウトにはしません。
3600

worker.<ワーカ名>.type
ワーカのタイプを次に示すタイプから指定します。タイプごとの設定できるパラメタについては，「(c)　worker.<ワーカ名>.typeごとの定義パラメタ」を参照してください。なお，このパラメタはワーカごとに必ず指定する必要があります。

ajp13：

外部プロセスで動作しているWebコンテナサーバへリクエストを転送するワーカです。

ajp12：

旧バージョンとの互換性を保つためのワーカです。ajp13が指定されたものとして動作します。

lb：

ラウンドロビンに基づく負荷分散機能を持つワーカです。

post_size_lb：

POSTリクエスト振り分けワーカです。Hitachi Web Server使用時だけ指定できます。

なし

注※

指定できるコードがコメント文で記載されています。必要に応じてコメントを外してください。

(c)　worker.<ワーカ名>.typeごとの定義パラメタ

定義できるパラメタ | ワーカのタイプ
ajp13 | lb | post_size_lb
worker.<ワーカ名>.balanced_workers | × | ○ | ×
worker.<ワーカ名>.cachesize※1 | △ | × | ×
worker.<ワーカ名>.default_worker | × | × | △
worker.<ワーカ名>.delegate_error_code | △ | × | ×
worker.<ワーカ名>.host | ○ | × | ×
worker.<ワーカ名>.lbfactor | △ | × | ×
worker.<ワーカ名>.port | ○ | × | ×
worker.<ワーカ名>.post_data | ×/○※2 | × | ×
worker.<ワーカ名>.post_size_workers | × | × | ○
worker.<ワーカ名>.receive_timeout | △ | × | ×

（凡例）

○：必ず指定します。

△：任意に指定します。

×：指定できません。

注1

ajp12で指定できるパラメタは，ajp13と同じです。

注2

UNIXの場合，必ず指定する項目に値を指定しなかったとき，または指定した値が不正のとき，Hitachi Web Serverは起動しません。

注※1

Windowsの場合だけ有効です。UNIXの場合，パラメタは無視されます。

注※2

POSTリクエスト転送先ワーカでは必須です。

(5)　記述例

worker.list=worker1
worker.worker1.port=8007
worker.worker1.host=localhost
worker.worker1.type=ajp13
#worker.worker1.cachesize=64
#worker.worker1.receive_timeout=3600
#worker.worker1.delegate_error_code=400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,422,423,424,500,501,502,503,504,505,507,510

#----------------------------------------------------------------
# Example setting for Loadbalancer.
#----------------------------------------------------------------
#worker.list=loadbalancer1
#
#worker.loadbalancer1.type=lb
#worker.loadbalancer1.balanced_workers=worker1,worker2
#
#worker.worker1.port=8007
#worker.worker1.host=host1
#worker.worker1.type=ajp13
#worker.worker1.cachesize=64
#worker.worker1.lbfactor=1
#worker.worker1.receive_timeout=3600
#worker.worker1.delegate_error_code=400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,422,423,424,500,501,502,503,504,505,507,510

#
#worker.worker2.port=8007
#worker.worker2.host=host2
#worker.worker2.type=ajp13
#worker.worker2.cachesize=64
#worker.worker2.lbfactor=1
#worker.worker2.receive_timeout=3600
#worker.worker2.delegate_error_code=400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,422,423,424,500,501,502,503,504,505,507,510
#----------------------------------------------------------------
# Example setting for post data size based worker.
#----------------------------------------------------------------
#worker.list=postsizelb1#worker.postsizelb1.type=post_size_lb
#worker.postsizelb1.post_size_workers=worker1,worker2
#worker.postsizelb1.default_worker=worker1
#
#worker.worker1.port=8007
#worker.worker1.host=host1
#worker.worker1.type=ajp13
#worker.worker1.post_data=100m
#worker.worker1.receive_timeout=3600
#worker.worker1.delegate_error_code=400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,422,423,424,500,501,502,503,504,505,507,510
#
#worker.worker2.port=8007
#worker.worker2.host=host2
#worker.worker2.type=ajp13
#worker.worker2.post_data=2048m
#worker.worker2.receive_timeout=3600
#worker.worker2.delegate_error_code=400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,422,423,424,500,501,502,503,504,505,507,510

(6)　注意事項

このファイルを編集してリダイレクタのユーザ定義を変更した場合，Webサーバを再起動する必要があります。変更した定義は，Webサーバを再起動したあとに反映されます。

Web Redirectorを使用する場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC，または/opt/Cosminexus/CC」を，「<Cosminexusのインストールディレクトリ>¥CCR，または/opt/Cosminexus/CCR」と読み替えてください。

8.　Cosminexus Managerで使用するファイル

この章では，Cosminexus Managerで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

8.1　Cosminexus Managerで使用するファイルの一覧

8.2　adminagent.properties（運用管理エージェントプロパティファイル）

8.3　adminagentuser.cfg（運用管理エージェント用オプション定義ファイル）

8.4　adminagent.xml（運用管理エージェント設定ファイル）

8.5　mngagent.<実サーバ名>.properties （運用監視エージェントプロパティファイル）

8.6　mserver.properties（Management Server環境設定ファイル）

8.7　mserver.cfg（Management Server用オプション定義ファイル）

8.8　mserverenv.cfg（Management Server用環境変数定義ファイル）

8.9　manager.cfg（Manager設定ファイル）

8.10　maction.properties（Managementアクション実行用プロパティファイル）

8.11　Managementイベント発行用プロパティファイル

8.12　Managementイベント発行用メッセージIDリストファイル

8.13　Management Server管理ファイル用退避対象定義ファイル

8.14　.mngsvrutilrc（mngsvrutilコマンドのクライアント側定義ファイル）

8.15　mngsvrutil.properties（mngsvrutilコマンドのサーバ側定義ファイル）

8.16　mngsvrutilcl.properties（mngsvrutilコマンドのクライアント側共通定義ファイル）

8.17　.mngsvrmonitorrc（JP1/IM連携用モニタ起動コマンドの設定ファイル）

8.18　JP1/IM連携用システムログメッセージマッピングファイル

8.19　論理ユーザサーバ定義ファイル

8.1　Cosminexus Managerで使用するファイルの一覧

Cosminexus Managerで使用するファイルの一覧を，次の表に示します。

表8-1　Cosminexus Managerで使用するファイルの一覧

ファイル名
分類
概要
参照先

adminagent.properties
運用管理エージェントプロパティファイル
運用管理エージェント本体に関する設定をします。
8.2

adminagentuser.cfg
運用管理エージェント用オプション定義ファイル
運用管理エージェントを実行するJavaVMの起動オプションを指定します。
8.3

adminagent.xml
運用管理エージェント設定ファイル
システム管理者の代わりに，論理サーバの起動，または設定ファイルの更新をします。
8.4

mngagent.<実サーバ名>.properties
運用監視エージェントプロパティファイル
運用監視エージェントの動作を定義します。
8.5

mserver.properties
Management Server環境設定ファイル
Management Serverの使用するポート番号を設定します。
8.6

mserver.cfg
Management Server用オプション定義ファイル
Management Server全体でのシステムプロパティを指定します。
8.7

mserverenv.cfg
Management Server用環境変数定義ファイル
Management Serverを操作するときの環境変数を設定します。
8.8

manager.cfg
Manager設定ファイル
Manager共通の設定をします。
8.9

maction.properties
Managementアクション実行用プロパティファイル
Managementイベントで通知されるメッセージIDに対応するManagementアクションを定義します。
8.10

任意
Managementイベント発行用プロパティファイル
Managementイベント発行時の動作を定義します。
8.11

任意
Managementイベント発行用メッセージIDリストファイル
Managementイベントとして通知するメッセージIDを定義します。
8.12

任意
Management Server管理ファイル用退避対象定義ファイル
mstrexportコマンドで退避する対象ファイルを定義します。
8.13

.mngsvrutilrc
mngsvrutilコマンドのクライアント側定義ファイル
mngsvrutilコマンドのオプションのデフォルト値を設定できます。
8.14

mngsvrutil.properties
mngsvrutilコマンドのサーバ側定義ファイル
mngsvrutilコマンドの実行環境を設定します。
8.15

mngsvrutilcl.properties
mngsvrutilコマンドのクライアント側共通定義ファイル
mngsvrutilコマンドのオプションのデフォルト値を共通定義として設定できます。
8.16

.mngsvrmonitorrc
JP1/IM連携用モニタ起動コマンドの設定ファイル
JP1/IM連携をする場合に，JP1/IMの画面からManagement Serverの運用ポータルを起動するために必要な設定をします。
このファイルは，Windows用です。
8.17

mserver.jp1event.system.mapping.properties

manager.jp1event.system.mapping.properties

manager.<論理サーバ名>.jp1event.system.mapping.properties

JP1/IM連携用システムログメッセージマッピングファイル
Cosminexusシステムで出力されるメッセージとJP1イベントの重大度のマッピングを定義します。
8.18

任意
mngsvrutilコマンドの論理ユーザ定義サーバファイル
追加する論理ユーザサーバの内容を定義します。
8.19

8.2　adminagent.properties（運用管理エージェントプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できるキー

(1)　形式

J2SEのプロパティファイル形式です。

運用管理エージェントのプロパティファイルです。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

運用管理エージェント本体に関する設定をします。

(4)　設定できるキー

指定できるキーとデフォルト値を次に示します。

キー名称
内容
デフォルト値

adminagent.adapter.allowedHosts
サーバへのアクセスを許可するホスト名またはIPアドレスを指定します。複数のアドレスを指定する場合はコンマ（,）で空白を入れずに区切ります。省略した場合はすべてのIPアドレスを許可します。
IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスを正規表現で指定した場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスが使用されます。複数のIPアドレスがマッチした場合は，マッチしたすべてのIPアドレスが許可されます。
なお，IPアドレスを正規表現で指定する場合は，コンマ（,）で複数の値を指定することはできません。
なし

adminagent.adapter.bind_host
運用管理エージェントとの通信で使用するホスト名またはIPアドレスを指定します。
複数の物理ネットワークインタフェースを持つホスト，または一つの物理ネットワークインタフェースに対して複数の論理IPアドレスを割り当てているホストで運用管理エージェントを利用するとき，任意のIPアドレスを選択できます。
指定しなかった場合，すべてのローカルアドレスに対する接続を受け付けます。また，不正な値を指定した場合は，運用管理エージェントがエラー終了します。
IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスを採用します。※1
なし

adminagent.adapter.port
サーバ機能の使用するポート番号を，1～65535の数値で指定します。
20295

adminagent.cluster.localaddress.check
アプリケーションサーバの系切り替え実行時に，待機系を停止するかどうかを設定します。
アプリケーションサーバの系切り替え実行時，待機系の論理サーバや運用管理エージェントが停止しなかった場合に，論理サーバと運用管理エージェントを停止します。

trueを指定した場合：

アプリケーションサーバの系切り替え実行時に，停止しなかった待機系の論理サーバおよび運用管理エージェントを停止します。

ローカルアドレスをチェックし，クラスタIPアドレスが設定されていなければ論理サーバを停止して，運用管理エージェントを停止します。

falseを指定した場合：

アプリケーションサーバの系切り替え実行時に，停止しなかった待機系の論理サーバおよび運用管理エージェントを停止しません。

false

adminagent.finalization.stop_servers
運用管理エージェントの終了処理で論理サーバを停止するかどうかを指定します。

trueを指定した場合：

運用管理エージェントの終了処理で，論理サーバをすべて停止します。

falseを指定した場合：

運用管理エージェントの終了処理で論理サーバを停止しません。

false

adminagent.forcestop.threaddump
J2EEサーバおよびSFOサーバの強制停止時にスレッドダンプを出力するかどうかを指定します。この設定が有効な論理サーバはJ2EEサーバおよびSFOサーバだけです。

trueを指定した場合：

スレッドダンプを出力します。この場合，cjstopsvコマンドに-fdオプションを指定して実行した場合と同じ動作で強制停止します。※2

cjstopsvコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

falseを指定した場合：

スレッドダンプを出力しません。

false

adminagent.forcestop.threaddump.interval
J2EEサーバおよびSFOサーバの強制停止時にスレッドダンプを出力する設定にした場合に，スレッドダンプ出力の完了を確認する間隔を，1～2147483647の整数（単位：秒）で指定します。
1～2147483647以外が指定された場合，デフォルト値が設定されます。
1

adminagent.forcestop.threaddump.timeout
J2EEサーバおよびSFOサーバの強制停止時にスレッドダンプを出力する設定にした場合に，タイムアウトするまでの時間を，-1～2147483647の整数（単位：秒）で指定します。
-1を指定した場合，スレッドダンプの出力が終了するまで待機します。-1～2147483647以外が指定された場合，デフォルト値が設定されます。
指定した時間が経過してもスレッドダンプの出力が終了しない場合は，J2EEサーバおよびSFOサーバを強制停止します。※2ただし，強制停止監視時間を設定している場合，このキーは無効になります。また，06-50以降のバージョンからバージョンアップした場合はadminagent.forcestop.threaddump.timeoutの指定値と同じか，それより長い値を強制停止監視時間に設定してください。
45

adminagent.hws.group
Hitachi Web Serverを使用する場合に，Hitachi Web Serverを起動するユーザが所属するグループ名を指定します。
省略した場合は，運用管理エージェントのグループで実行します。
このキーはUNIX用です。
なし

adminagent.hws.owner
Hitachi Web Serverを使用する場合に，Hitachi Web Serverを起動するユーザ名を指定します。
省略した場合は，運用管理エージェントのユーザで実行します。
このキーはUNIX用です。
なし

adminagent.hws.watch.method
adminagent.hws.watch.levelで2を指定したときのHitachi Web Serverの動作確認用HTTPメソッドを指定します。指定可能なメソッドは"HEAD"または"OPTIONS"のどちらかです。※4

"HEAD"を指定した場合：

adminagent.hws.watch.urlで指定されたURLにアクセスして応答が返ることを確認します。

"OPTIONS"を指定した場合：

WebサーバがHTTPメソッドを受け付け可能な状態であることを確認します。

HEAD※3

adminagent.hws.watch.url
adminagent.hws.watch.methodで"HEAD"を指定したときの，Hitachi Web Serverの動作確認用URLを指定します。指定されたURLにアクセスし，レスポンスが返るかどうかで判定するため，実際にアクセスできるURLを指定してください。なお，URLは"http"で始まる絶対パス，またはルートコンテキストからの相対パスで指定します。同一のホストに複数のWebサーバを構築する場合は相対パスで指定してください。

（指定例）http://HostA:80/index.htmlを指定する場合

adminagent.hws.watch.url=http://HostA:80/index.html

http://localhost:<ポート番号>/index.htmlを指定する場合（複数Webサーバ対応）

adminagent.hws.watch.url=index.html

ルートコンテキスト（http://localhost:<ポート番号>/）

adminagent.j2ee.sys_cmd.abnormal_end.threaddump
障害検知時コマンド実行の際にJ2EEサーバのスレッドダンプを収集するかどうかを指定します。

trueを指定した場合：

J2EEサーバのスレッドダンプを収集します。

falseを指定した場合：

J2EEサーバのスレッドダンプを収集しません。

true

adminagent.jp1event.event_server_name
使用するJP1/Baseのイベントサービスのイベントサーバ設定ファイル（conf）に指定した，portsキーのアドレスと同じ値を指定します。portsキーに複数のアドレスを指定している場合は，指定したアドレスのうちのどれか一つを指定します。なお，portsキーのアドレスに「0.0.0.0」（デフォルト値）を指定したイベントサービスを使用する場合は，このキーを省略するか，自マシンのホスト名またはlocalhostを指定します。
localhost

adminagent.jp1event_enabled
運用管理エージェントからJP1イベントを発行するかどうかを指定します。

trueを指定した場合：

JP1イベントを発行します。

falseを指定した場合：

JP1イベントを発行しません。

false

adminagent.log.filenum
ログファイル面数を1～16の整数で指定します。
4

adminagent.log.filesize
ログファイル一つ当たりの上限サイズ（単位：バイト）を，65536～2147483647の数値で指定します。
65536

adminagent.log.level
ログ出力レベルを-1～1000の整数で指定します。

-1：出力しません。

0：通常運用：通常運用。

10：通常運用（verbose）：通常運用に近い形態での再現待ち。

20：再現テスト：システム環境構築時やテストフェーズでの，デバッグレベルの情報の取得。

30：障害調査：原因究明困難な障害発生時，より詳細な障害情報の取得。

0

adminagent.lsinfo_dir
論理サーバ情報ファイルの出力先ディレクトリを指定します。指定したディレクトリが存在しない場合は作成します。
運用管理エージェント再起動後に，停止前に管理していた論理サーバを再び管理下に置き，操作できるようにするための情報です。論理サーバの起動中に作成され，論理サーバの停止後に削除されます。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥spool¥lsinfo

UNIXの場合
/opt/Cosminexus/manager/spool/lsinfo

adminagent.maintenance.log.filenum
保守ログのファイル面数を1～16の整数で指定します。
4

adminagent.maintenance.log.filesize
保守ログのファイル一つ当たりの上限サイズ（単位：バイト）を，65536～2147483647の整数で指定します。
16777216

adminagent.rmi.log.filenum
運用管理エージェントが行うRMI処理での保守ログのファイル面数を数値で指定します。
8

adminagent.rmi.log.filesize
運用管理エージェントが行うRMI処理での保守ログのファイル一つ当たりの上限サイズを数値で指定します。
16777216

adminagent.rmi.log.level
運用管理エージェントが行うRMI処理での保守ログの出力レベルを文字列で指定します。

＜OFF＞

出力しません。

＜SEVERE＞，＜WARNING＞，＜INFO＞，＜CONFIG＞，＜FINE＞，＜FINER＞，＜FINEST＞

SEVEREは深刻な問題だけを出力します。ここに示した順番でより詳細なログが出力されるようになります。

FINER

adminagent.snapshotlog.log_dir
snapshotログの出力先ディレクトリを，文字列で指定します。指定したディレクトリがない場合は作成します。

Windowsの場合
<manager.cfgのcom.cosminexus.manager.log.dir>¥snapshot¥

UNIXの場合
<manager.cfgのcom.cosminexus.manager.log.dir>/snapshot/

adminagent.snapshotlog.num_snapshots
一次資料として収集する，論理サーバごとのsnapshotログファイル数を，-2147483648～2147483647の数値で指定します。指定されたファイル数を超えた場合，作成時刻の古い順にログファイルは削除されます。また，0以下の値を指定した場合，ログファイルは削除されません。
10

adminagent.snapshotlog.listfile.2.num_snapshots
二次資料として収集する，論理サーバごとのsnapshotログファイル数を，-2147483648～2147483647の数値で指定します。指定されたファイル数を超えた場合，作成時刻の古い順にログファイルは削除されます。また，0以下の値を指定した場合，ログファイルは削除されません。
10

adminagent.sys_cmd.abnormal_end.prftrace
障害検知時コマンド実行の際に性能解析トレースファイルを収集するかどうかを指定します。

trueを指定した場合：

性能解析トレースファイルを収集します。

falseを指定した場合：

性能解析トレースファイルを収集しません。

true

adminagent.watch.retry_timeout.enabled
論理サーバの動作確認で，タイムアウトの発生をリトライ対象とするかどうかを指定します。

trueを指定した場合：

リトライ対象とします。

falseを指定した場合：

リトライ対象としません。

新規インストールの場合：true
バージョンアップの場合：既存の指定値が設定されます。

adminagent.<サーバ種別>.process.console_event.enabled
論理サーバのコンソール出力情報をServer Plug-inまたはHCSC-Managerに表示するかどうかを指定します。

trueを指定した場合：

コンソール出力情報をServer Plug-inまたはHCSC-Managerに出力します。

falseを指定した場合：

コンソール出力情報をServer Plug-inまたはHCSC-Managerに出力しません。

<サーバ種別>は，論理サーバの種別を表す，次のどちらかになります。
・j2ee：J2EEサーバ
・userserver：ユーザサーバ

注意事項

adminagent.process.consolelog.enabledをtrueに設定する必要があります。

リソースを消費するため，Server Plug-inまたはHCSC-Managerを使用しない運用ではfalseに設定することを推奨します。

false

adminagent.<サーバ種別>.process.console_log.enabled
論理サーバのコンソール出力情報をコンソールログに出力するかどうかを指定します。

trueを指定した場合：

コンソール出力情報をコンソールログに出力します。

falseを指定した場合：

コンソール出力情報をコンソールログに出力しません。

<サーバ種別>は，論理サーバの種別を表す，次のどちらかになります。
・j2ee：J2EEサーバ
・userserver：ユーザサーバ

注意事項

adminagent.process.consolelog.enabledをtrueに設定する必要があります。

false

adminagent.<サーバ種別>※5.usr_cmd.abnormal_end
障害検知時コマンドを絶対パスで指定します。ファイルセパレータは「/」を使用します。障害が発生した論理サーバの種別に応じてコマンドを変えることができます。<サーバ種別>※5に指定できる値以外の値を指定した場合は，無効になります。

Windowsの場合：

障害検知時コマンドをバッチファイルで作成する場合，コマンド名の前に“%{ComSpec} /C ”を追加する必要があります。“%{ComSpec}”は，cmd.exeの絶対パスに置換されます。“%{ComSpec} /C”が指定されていない場合，コマンドが正常に動作しないことがあります。また，コマンドのパスに半角スペースを含む場合は，コマンドの絶対パスを必ずダブルクォーテーション（""）で囲みます。

（例）J2EEサーバ障害発生時に，d:/my bat/j2eeabnormalend.batを実行する場合

adminagent.j2ee.usr_cmd.abnormal_end=%{ComSpec} /c "d:/my bat/j2eeabnormalend.bat"

UNIXの場合：

障害検知時コマンドをシェルスクリプトで作成する場合，コマンド名の前に“/bin/sh”を追加する必要があります。“/bin/sh”が指定されていない場合，コマンドが正常に動作しないことがあります。

（例）J2EEサーバ障害発生時に，/home/user1/j2eeabnormalend.shを実行する場合

adminagent.j2ee.usr_cmd.abnormal_end=/bin/sh /home/user1/j2eeabnormalend.sh

なし

adminagent.<サーバ種別>※5.watch.interval
論理サーバの動作確認間隔（単位：秒）を1～86400の整数で指定します。
不正な値が指定された場合は，デフォルト値が設定されます。
10

adminagent.<サーバ種別>※5.watch.level
論理サーバの動作確認レベルを指定します。指定できる値は，1または2です。

1を指定した場合：

プロセスの存在確認で論理サーバの動作を確認します。

2を指定した場合：

プロセスの存在確認および論理サーバへのアクセスで論理サーバの動作を確認します。動作を確認できる論理サーバは，ネーミングサービス，SFOサーバ，J2EEサーバおよびWebサーバです。そのほかの論理サーバに2を指定しても，プロセスの存在確認だけになります。

ネーミングサービス，SFOサーバ，J2EEサーバおよびWebサーバの場合：2

上記以外の論理サーバの場合：1

adminagent.<サーバ種別>※5.watch.retry_count
論理サーバの動作確認で，動作確認処理に失敗した場合にリトライする回数を0～86400の整数で指定します。リトライ回数を設定することで，一時的な動作確認の失敗を許容することができます。
リトライする間隔は，adminagent.<サーバ種別>.watch.intervalで指定します。0を指定した場合，動作確認処理に失敗すると，リトライしないで異常発生とみなされます。
動作確認処理に失敗し，リトライする場合はKEOS21033-W，またはKEOS21034-Wが運用管理エージェントのログに出力されます。
動作確認処理に失敗し，リトライしない場合，またはリトライ回数が指定回数を超えた場合はKEOS20511-E，またはKEOS21035-Eが運用管理エージェントのログに出力され，Management Serverに異常が通知されます。
1

adminagent.<サーバ種別>※5.watch.start_time
論理サーバの起動で，起動コマンドを実行してから動作確認（動作確認レベル2）を開始するまでの時間（単位：秒）を0～86400の整数で指定します。
論理サーバを起動した際の論理サーバのログ（J2EEサーバの場合，cjmessage?.logのKDJE30028-I）から実際に起動に掛かる所要時間を求め，その時間から数秒短い時間をこのプロパティに指定しておくことで，起動前に出力される不要なログ出力を減らし，論理サーバの起動完了をManagement Serverに迅速に通知できます。
論理サーバの起動／停止機能で設定する起動監視時間は，このプロパティに指定した値よりも大きい値を指定する必要があります。指定した値よりも小さい値を指定した場合は起動に失敗します。
<サーバ種別>※5によって次のように異なります。

prf：0

smartagent：3

naming：10

ctmdm：0

ctm：0

sfo：45

j2ee：45

hws：0

adminagent.<サーバ種別>※5.watch.timeout
論理サーバの動作確認でタイムアウトするまでの時間を，1～9223372036854775の整数（単位：秒）で指定します。
60

adminagent.j2ee.sys_cmd.abnormal_end.javatrace
障害検知時コマンドの実行の際にJ2EEサーバのスタックトレースを取得するかどうかを指定します。

trueを指定した場合：

スタックトレースを取得します。

falseを指定した場合：

スタックトレースを取得しません。

true

adminagent.hws.sys_cmd.abnormal_end.traceinfo
障害検知時コマンドの実行の際にWebサーバの内部トレースを採取するかどうかを指定します。

trueを指定した場合：

内部トレースを採取します。

falseを指定した場合：

内部トレースを採取しません。

true

adminagent.process.consolelog.enabled
運用管理エージェントが起動したプロセスのコンソール出力情報を取得するかどうかを指定します。ただし，Server Plug-inまたはHCSC-Managerを使用する場合はtrueを指定する必要があります。

trueを指定した場合：

コンソール出力情報を取得します。

falseを指定した場合：

コンソール出力情報を取得しません。

true

adminagent.process.consolelog.filenum
運用管理エージェントが起動したプロセスのコンソール出力情報を出力するログファイル面数を，1～16の整数で指定します。
4

adminagent.process.consolelog.filesize
運用管理エージェントが起動したプロセスのコンソール出力情報を出力するログファイル一つ当たりの上限サイズ（単位：バイト）を，65536～2147483647の整数で指定します。
65536

adminagent.process.consolelog.event.queue_size
運用管理エージェントが起動したプロセスのコンソール出力情報を，Management Serverにイベント通知する際の，イベントキューのサイズを設定します。
キューがいっぱいになった場合は，古いイベントから破棄されます。
このプロパティは，デフォルト値が推奨のため，設定を変更しないでください。
1024

注※1

運用管理ドメイン内で運用管理エージェントとの通信に使用されるIPアドレスのサブネットが一つに決められている場合，指定するIPアドレスを"192¥¥.168¥¥.0¥¥..+"のように記述しておけば，前方が"192.168.0."であるIPアドレス（"192.168.0.32"や"192.168.0.128"など）にマッチするため，設定ファイルを修正しないで，すべてのホストに配布して利用できます。正規表現についての詳細は，Javaのjava.util.regex.Patternクラスの仕様を確認してください。

ただし，"¥¥"は1文字の"¥"に置き換えられてしまうため，"¥"を指定する場合は2文字連続して指定してください。指定した正規表現にマッチするIPアドレスが複数個検出された場合は，最も小さい値のIPアドレスを採用します。例えば，"192.168.0.32"と"192.168.0.128"が検出された場合は"192.168.0.32"を採用します。この場合，採用されたIPアドレスが意図するIPアドレスになるとは限らないため，"192¥¥.168¥¥.0¥¥.1.."のように必ず1個だけマッチする正規表現を記述してください。

注※2

強制停止時にスレッドダンプを出力する場合は，スレッドダンプ出力監視タイムアウト（adminagent.forcestop.threaddump.timeout）に十分な時間を設定してください。また，強制停止にかかる時間が長いため強制停止に失敗する場合は，「論理サーバの起動と停止の設定」の「停止監視時間」を十分な監視時間にする必要があります。また，ワトソン博士を使用している場合，「メッセージボックスによる通知」を設定しないでください。ワトソン博士の詳細はMicrosoft社のホームページなどを参照してください。

注※3

06-50以降のバージョンの設定ファイルには，初期値としてadminagent.hws.watch.method=OPTIONSの行が定義されています。このため，06-50より前のバージョンからバージョンアップした場合の動作確認用HTTPメソッドの初期値はデフォルトの"HEAD"になりますが，新規にインストールした場合または06-50以降のバージョンからバージョンアップした場合の動作確認用HTTPメソッドの初期値は"OPTIONS"になります。

注※4

リダイレクタにマッピングするURLパターンに"/*"を指定した場合，すべてのURLはJ2EEサーバのWebコンテナにリダイレクトされてしまいます。したがって，リダイレクタにマッピングするURLパターンに"/*"を指定する場合は，"OPTIONS"を指定し，URLアクセスを行わないことを推奨します。

注※5

<サーバ種別>は，論理サーバの種別を表す，次のどれかになります。

・smartagent：スマートエージェント

・j2ee：J2EEサーバ

・naming：ネーミングサービス

・hws：Webサーバ（Hitachi Web Server）

・ctm：CTM

・ctmdm：CTMドメインマネジャ

・prf：パフォーマンストレーサ

・sfo：SFOサーバ

・userserver：ユーザサーバ

8.3　adminagentuser.cfg（運用管理エージェント用オプション定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　注意事項

(1)　形式

次のようにキーを指定します。

<キー名称>=<値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

1行に65535バイトまで指定できます。

値が存在しない行を定義した場合，その行は無視されます。

ASCII文字で指定してください。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

運用管理エージェントを実行するJavaVMの起動オプションを指定します。

このファイルが存在し，かつ運用管理エージェントからこのファイルの読み込みができる場合に，ファイルの内容が反映されます。このファイルが存在する場合に，運用管理エージェントからこのファイルの読み込みができないときには，運用管理エージェントの起動に失敗します。

このファイルが存在しない場合は，オプションの設定は行わないで，運用管理エージェントが起動されます。

(4)　指定できるキー

指定できるキーとデフォルト値を次に示します。不正なキーを指定した場合は，運用管理エージェントの起動に失敗します。

キー名称
内容
デフォルト値

add.jvm.arg
JavaVMを起動するときのオプションを指定します。
次のJavaVMのオプションを指定できます。

-Xms<size>

-Xmx<size>

複数のオプションを指定する場合，同じキー名称を使用して，次のように指定してください。
（指定例）
add.jvm.arg=-Xms128m
add.jvm.arg=-Xmx256m
JavaVMが認識できない値を指定した場合，運用管理エージェントの起動は失敗します。
なし

add.class.path
クラスパスに追加する値を指定します。
複数の値を指定する場合，同じキー名称を使用して，クラスパスを指定してください。指定内容には，Cosminexusのインストールディレクトリを「${cosminexus.home}」で指定できます。
（指定例）
add.class.path=C:/home/lib/mylib.jar
なし

add.library.path
ライブラリ検索パスに追加する値を指定します。
複数の値を指定する場合，同じキー名称を使用して，ライブラリ検索パスを指定してください。指定内容には，Cosminexusのインストールディレクトリを「${cosminexus.home}」で指定できます。
（指定例）
add.library.path=C:/home/bin
なし

(5)　注意事項

運用管理エージェントでjava.lang.OutOfMemoryErrorが発生した場合に，このファイルで，次のようにJavaヒープの最大サイズを拡張します。

add.jvm.arg=-Xmx<Javaヒープの最大サイズ>

8.4　adminagent.xml（運用管理エージェント設定ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　ファシリティ名で指定できる論理サーバ種類

(5)　注意事項

(1)　形式

ファシリティ名（論理サーバの種類と起動／停止の動作種別を示す）の設定のあとに，環境変数名および環境変数の値を設定します。

ファシリティ名の設定

<facility>
 <name>「ファシリティ名」</name>
 <class>com.cosminexus.mngsvr.adminagent.impl.CmdExecuter</class>

環境変数名および環境変数名の設定

上記ファシリティ名の設定のあとに，次の記述を追加します。

<init-param>
 <param-name>adminagent.facility.CmdExecuter.env.「環境変数名」</param-name>
 <param-value>「環境変数の値」</param-value>
</init-param>

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

システム管理者の代わりに，論理サーバの起動，または設定ファイルの更新をします。

デフォルトで設定されている環境変数の値を変更する必要がある場合，または環境変数を追加または削除する必要がある場合は，この設定ファイルを編集してください。

(4)　ファシリティ名で指定できる論理サーバ種類

ファシリティ名で指定できる論理サーバ種類と，起動／停止の動作の種別を次の表に示します。

論理サーバ種類
起動／停止種別
ファシリティ名
備考

パフォーマンストレーサ
起動
prf-start
－

停止
prf-stop
－

スマートエージェント
（Windowsの場合）
起動
osagent-start
－

停止
osagent-stop
－

スマートエージェント
（UNIXの場合）
起動
osagent-start
－

ネーミングサービス
起動
naming-service-start
－

CTMドメインマネジャ
起動
ctm-dommng-start
－

停止
ctm-dommng-stop
－

CTM
起動
ctm-start
－

停止
ctm-stop
－

SFOサーバ
起動
sfo-server-start
－

停止
sfo-server-stop
－

J2EEサーバ
起動
j2ee-server-start
J2EEサーバでデータベースを利用する場合には，J2EEサーバ起動時の環境変数にデータベース固有の設定をする必要があります。

停止
j2ee-server-stop

WEBサーバ
（Windowsの場合）
起動
web-server-start
－

停止
web-server-stop
－

WEBサーバ
（UNIXの場合）
起動
web-server-start
－

（凡例）－：ありません。

(5)　注意事項

adminagent.xmlを変更した場合は，運用管理エージェントを再起動してください。

各論理サーバの起動／停止時には，運用管理エージェントの起動時の環境変数を引き継ぎます。環境変数を引き継ぎたくない場合は，該当環境変数を空に設定してください。

adminagent.xmlで設定した環境変数は，該当ホストの運用管理エージェントから起動される論理サーバの種類ごとに有効になります。論理サーバのインスタンス単位に環境変数の設定はできません。

（例1）

J2EEサーバ起動時に，環境変数NLS_LANGにJapanese_japan.ja16sjisを設定する場合

<facility>

<name>j2ee-server-start</name>

<class>com.cosminexus.mngsvr.adminagent.impl.CmdExecuter</class>

<init-param>

<param-name>adminagent.facility.CmdExecuter.env.NLS_LANG</param-name>

<param-value>Japanese_japan.ja16sjis</param-value>

</init-param>

…

…

（例2）

運用管理エージェント起動時に設定された環境変数AIXTHREAD_SCOPEを引き継がない場合

<facility>

…

…

<init-param>

<param-name>adminagent.facility.CmdExecuter.env.AIXTHREAD_SCOPE</param-name>

<param-value></param-value>

</init-param>

…

…

「環境変数名」および「環境変数の値」に設定した値は，コマンドシェルのような環境変数の置換や演算子による処理がされません。このため，「環境変数名」および「環境変数の値」にシステム環境変数は使用できません。

8.5　mngagent.<実サーバ名>.properties （運用監視エージェントプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　運用管理ドメインおよび運用監視エージェントの名称設定で使用できるキー

(4)　ログ・トレースの設定で使用できるキー

(5)　通信ポートおよびIPアドレス固定による運用の設定で使用できるキー

(6)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

運用監視エージェントのプロパティファイルです。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　運用管理ドメインおよび運用監視エージェントの名称設定で使用できるキー

指定できるキーとデフォルト値を次に示します。これらのキーに設定したドメイン名およびエージェント名は，ログファイル名のデフォルト値として使用されます。

キー名称 | 内容 | デフォルト値
mngagent.domain_name | 運用管理ドメイン名を，文字列で指定します。使用できる文字はASCII文字の英数字（A～Z，a～z，0～9），アンダースコア（_），およびハイフン（-）です。 | なし
mngagent.agent_name | 運用監視エージェント名を，文字列で指定します。使用できる文字はASCII文字の英数字（A～Z，a～z，0～9），アンダースコア（_），およびハイフン（-）です。 | なし

(4)　ログ・トレースの設定で使用できるキー

指定できるキーとデフォルト値を次に示します。

キー名称
内容
デフォルト値

mngagent.log.filename
ログファイル名を指定します。空文字列や空白文字を指定した場合，ログは出力されません。実際の出力先ファイル名は，指定したファイル名のあとに「.n.log」が付きます（nは1～16）。

Windowsの場合
<manager.cfgのcom.cosminexus.manager.log.dir>¥mngagent-ドメイン名-Agent名

UNIXの場合
<manager.cfgのcom.cosminexus.manager.log.dir>/mngagent-ドメイン名-Agent名

mngagent.log.filesize
ログファイル一つ当たりの上限サイズ（バイト）を，4096～2147483647で指定します。範囲外の値を指定した場合は，65536を仮定します。
65536

(5)　通信ポートおよびIPアドレス固定による運用の設定で使用できるキー

指定できるキーとデフォルト値を次に示します。

キー名称
内容
デフォルト値

mngagent.connector.port
運用監視エージェントの通信ポートを1～65535までの整数で固定します。ポート番号は，ほかのプログラムなどと重複しないようにしてください。このプロパティを設定しない場合は，vbroker.se.iiop_tp.scm.iiop_tp.listener.portに定義された値が設定されます。
vbroker.se.iiop_tp.scm.iiop_tp.listener.portに定義された値

mngagent.connector.host
任意の値を指定して，運用監視エージェントのIPアドレスを固定します。
このプロパティを設定しない場合は，vbroker.se.iiop_tp.hostに定義された値が設定されます。
vbroker.se.iiop_tp.hostに定義された値

vbroker.se.iiop_tp.scm.iiop_tp.listener.port
任意の値を指定して，運用監視エージェントの通信ポートを固定します。ポート番号は，ほかのプログラムなどと重複しないようにしてください。このプロパティを設定しない場合は，Cosminexus TPBrokerによってランダムな値が設定されます。
このキーは，Cosminexus Version 6以前の製品との互換用です。
なし

vbroker.se.iiop_tp.host
任意の値を指定して，運用監視エージェントのIPアドレスを固定します。
このキーは，Cosminexus Version 6以前の製品との互換用です。
なし

(6)　注意事項

mngagent.<実サーバ名>.propertiesファイルは，次の場合に作成されます。

Smart Composer機能でWebシステムを構築した場合

運用管理ポータルでJ2EEサーバの設定情報を配布した場合

詳細については，マニュアル「Cosminexus　運用管理操作ガイド」または，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。
これらの機能を使用しないで構築したJ2EEサーバの運用監視を行う場合は，設定ファイルmngagent.<実サーバ名>.propertiesを作成し，運用監視エージェント本体に関する設定をしてください。

ファイル名には，サーバインスタンスごとに異なるものを設定してください。

mngagent.domain_name，mngagent.agent_nameの値が同一の運用監視エージェントを複数同時に起動した場合，デフォルトでは同一のログファイルに出力するため，ログファイルの内容が破壊される可能性があります。同一マシン上で複数のJ2EEサーバを起動する場合，mngagent.agent_nameの値が重複しないように定義してください。

8.6　mserver.properties（Management Server環境設定ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

Management Serverのプロパティファイルです。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

Management Serverが使用するポート番号の設定や，障害検知時コマンドの動作の設定をします。Management Serverを起動しないでポート番号を変更する場合は，このファイルを編集します。

(4)　指定できるキー

指定できるキーとその内容，および指定を省略した場合のデフォルト値を次に示します。

キー名称
内容
デフォルト値

adminagent.connector.comm.state.cache_max_time
運用管理エージェントとの通信状態をキャッシュする最大時間を，0～2147483の数値（単位：秒）で指定します。0未満を指定した場合はキャッシュしません。
60

webserver.connector.ajp13.port
Management Server内部通信用ポート番号を，1～65535の数値で指定します。
インストール時は28009が設定されます。
なし※1

webserver.connector.http.port
Management Server接続HTTPポート番号を，1～65535の数値で指定します。
インストール時は28080が設定されます。
なし※1

webserver.shutdown.port
Management Server終了要求受信ポート番号を，1～65535の数値で指定します。
インストール時は28005が設定されます。
なし※1

webserver.connector.http.bind_host
複数の物理ネットワークインタフェースを持つホスト，または一つの物理ネットワークインタフェースに対して複数の論理IPアドレスを割り当てているホストでManagement Serverを利用するとき，任意のIPアドレスを選択できます。ただし，ループバックアドレスは指定できません。
値を指定しなかった場合，すべてのローカルアドレスに対する接続が受け付けられます。
IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスが使用されます。※2
ワイルドカードアドレス

webserver.connector.http.permitted.hosts
Management Serverへのアクセスを許可するホストおよび運用管理エージェント稼働ホストのIPアドレスまたはホスト名を指定します。運用管理ポータル（Webブラウザ）または運用管理コマンド（mngsvrutil）を使用したアクセスが対象です。また，Management Serverで管理するホストのIPアドレス，またはホスト名もすべて指定しなければなりません。指定されていないホストの論理サーバを操作した場合，操作が完了しなかったりタイムアウトが発生したりします。
なお，キーを省略した場合，アクセス制限をしません。値を省略した場合または，入力した値が不正な場合は，アクセスできるのはローカルホストだけです。
複数指定する場合にはIPアドレスまたはホスト名の間をコンマ（,）で区切ります。アクセス制限をしない場合はアスタリスク（*）だけを指定します。IPアドレスまたはホスト名の前後の半角スペースは無視されます。
*

mngsvr.myhost.name
Management Serverが接続するNaming Serviceのホスト名や論理サーバを配置するホスト名にループバックアドレスを示す"localhost"や"127.0.0.1"を指定した場合に使用するIPアドレス，またはそのIPアドレスを示すホスト名を指定します。
省略した場合，および空文字を指定した場合，ループバックアドレスは取得可能な自ホスト名に変換され使用されます。自ホスト名が取得できない場合は，ループバックアドレスが使用されます。
IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスが使用されます。※2

注意事項

webserver.connector.http.bind_hostに値を指定している場合は，このプロパティにも同じ値を指定してください。

なし

com.cosminexus.mngsvr.sys_cmd.abnormal_end.enabled
システムによる障害検知時コマンド実行機能を利用するかどうかを指定します。

trueを指定した場合：

障害検知時コマンド実行機能を利用します。

falseを指定した場合：

障害検知時コマンド実行機能を利用しません。

true

com.cosminexus.mngsvr.usr_cmd.abnormal_end.enabled
ユーザ作成の障害検知時コマンド実行機能を利用するかどうかを指定します。

trueを指定した場合：

障害検知時コマンド実行機能を利用します。

falseを指定した場合：

障害検知時コマンド実行機能を利用しません。

false

com.cosminexus.mngsvr.sys_cmd.abnormal_end.timeout
システムによる障害検知時に実行したコマンドの終了を待つ時間を，-1～2147483647の整数値（単位：秒）で指定します。
指定した時間を経過してもコマンドが終了しない場合は，実行したコマンドを無視して処理を続行します。
-1が指定された場合は，コマンドが終了するまで待機します。
-1～2147483647以外の値が指定された場合，デフォルト値が設定されます。
600

com.cosminexus.mngsvr.usr_cmd.abnormal_end.timeout
ユーザ作成の障害検知時に実行したコマンドの終了を待つ時間を，-1～2147483647の整数値（単位：秒）で指定します。
指定した時間を経過してもコマンドが終了しない場合は，実行したコマンドを無視して処理を続行します。
-1を指定した場合は，コマンドが終了するまで待機します。
-1～2147483647以外の値が指定された場合，デフォルト値が設定されます。
60

com.cosminexus.mngsvr.snapshot.auto_collect.enabled
障害発生時または一括再起動時にsnapshotログを収集するかどうかを指定します。

trueを指定した場合：

snapshotログを収集します。

falseを指定した場合：

snapshotログを収集しません。

true

com.cosminexus.mngsvr.snapshot.collect.point
snapshotログ収集のタイミングを指定します。

before_stopを指定した場合：

論理サーバ停止前にsnapshotログを収集します。

j2ee_restartを指定した場合：

J2EEサーバ再起動前にsnapshotログを収集します。

before_stop

com.cosminexus.mngsvr.compat.monitor_view
運用管理ポータルの「論理サーバの運用監視」画面に次の項目を表示させるかどうかを指定します。

管理用サーバ（簡易Webサーバ）の情報

なお，この項目は互換用の項目です。

trueを指定した場合：

表示項目を表示します。

falseを指定した場合：

表示項目を表示しません。

false

com.cosminexus.mngsvr.maintenance.log.filenum
Management Serverの保守ログファイルの面数を1～16の整数で指定します。
2

com.cosminexus.mngsvr.maintenance.log.filesize
Management Serverの保守ログファイルの最大サイズ（単位：バイト）を65536～2147483647の整数で指定します。
16777216

mngsvr.jp1event.event_server_name
使用するJP1/Baseのイベントサービスのイベントサーバ設定ファイル（conf）に指定した，portsキーのアドレスと同じ値を指定します。portsキーに複数のアドレスを指定している場合は，指定したアドレスのうちのどれか一つを指定します。
なお，portsキーのアドレスに「0.0.0.0」（デフォルト値）を指定したイベントサービスを使用する場合は，このキーを省略するか，自マシンのホスト名またはlocalhostを指定します。
localhost

com.cosminexus.mngsvr.management.enabled
Management Serverリモート管理機能を有効にするかどうかを指定します。

trueを指定した場合：

Management Serverリモート管理機能を有効にします。

falseを指定した場合：

Management Serverリモート管理機能を有効にしません。

false

com.cosminexus.mngsvr.management.connector.enabled
Management Serverリモート管理機能への外部接続を有効にするかどうかを指定します。

trueを指定した場合：

Management Serverリモート管理機能への外部接続を有効にします。

falseを指定した場合：

Management Serverリモート管理機能への外部接続を有効にしません。

false

com.cosminexus.mngsvr.management.port
Management Serverリモート管理機能への外部接続ポート番号を1～65535の整数で指定します。
28099

com.cosminexus.mngsvr.management.host
Management Serverリモート管理機能への外部接続のホスト固定を行う場合に，ホスト名，またはIPアドレスを指定します。
IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスが使用されます。※2
ホストを固定する場合には，mserver.propertiesファイルにjava.rmi.server.hostnameキーを追加して，このキーと同じ値を指定してください。ただし，java.rmi.server.hostnameには，メタキャラクタを用いた正規表現は使用できません。
webserver.connector.http.bind_hostに値を指定している場合は，このプロパティにも同じ値を指定してください。
なし

com.cosminexus.mngsvr.management.listen.port
Management Serverリモート管理機能への外部接続時に作成する，クライアント接続用のポート番号を，0～65535の整数で指定します。0が指定された場合は空いているポート番号を自動的に割り当てます。
0

com.cosminexus.mngsvr.management.read_timeout
Management Serverリモート管理機能への外部接続時の読み込みタイムアウト時間(単位：秒)を，1～2147483の整数で指定します。
180

com.cosminexus.mngsvr.log.level
Management Serverのログの出力レベルを指定します。

0：通常運用。

10：通常運用に近い形態での再現待ち。

20：システム環境構築時やテストフェーズでの，デバッグレベルの情報の取得。

30：原因究明困難な障害発生時，より詳細な障害情報の取得。

0

com.cosminexus.mngsvr.log.rotate
Management Serverのログのファイル面数を次の数値で指定します。
1，2，4，8，16
4

com.cosminexus.mngsvr.log.size
Management Serverのログのファイルサイズを次の数値で指定します。
4096（4キロバイト），65536（64キロバイト），262144（256キロバイト），524288（512キロバイト），1048576（1メガバイト），4194304（4メガバイト），16777216（16メガバイト），67108864（64メガバイト）
65536

com.cosminexus.mngsvr.log.display_number
mngsvr構成機能がログの表示画面でログ情報を表示する最大表示件数を，次の数値で指定します。
20，60，100，200，400
100

com.cosminexus.mngsvr.on_start
Management Serverの開始時に論理サーバの一括起動を行うかどうかを指定します。

trueを指定した場合：

論理サーバを一括起動します。

falseを指定した場合：

論理サーバを一括起動しません。

false

com.cosminexus.mngsvr.trace
Management Serverで保持する性能解析トレースの最大数を次の数値で指定します。
1，2，4，8，16
2

com.cosminexus.mngsvr.jp1event.enabled
システムJP1イベント発行機能を有効にするかどうかを指定します。

trueを指定した場合：

システムJP1イベント発行機能を有効にします。

falseを指定した場合：

システムJP1イベント発行機能を無効にします。

false

com.cosminexus.mngsvr.jp1event.warning
Warningレベルのイベントを発行するかどうかを指定します。

trueを指定した場合：

Warningレベルのイベントを発行します。

falseを指定した場合：

Warningレベルのイベントを発行しません。

false

com.cosminexus.mngsvr.jp1event.emergency
Emergencyレベルのイベントを発行するかどうかを指定します。

trueを指定した場合：

Emergencyレベルのイベントを発行します。

falseを指定した場合：

Emergencyレベルのイベントを発行しません。

false

com.cosminexus.mngsvr.jp1event.alert
Alertレベルのイベントを発行するかどうかを指定します。

trueを指定した場合：

Alertレベルのイベントを発行します。

falseを指定した場合：

Alertレベルのイベントを発行しません。

false

com.cosminexus.mngsvr.jp1event.notice
Noticeレベルのイベントを発行するかどうかを指定します。

trueを指定した場合：

Noticeレベルのイベントを発行します。

falseを指定した場合：

Noticeレベルのイベントを発行しません。

false

com.cosminexus.mngsvr.jp1event.information
Informationレベルのイベントを発行するかどうかを指定します。

trueを指定した場合：

Informationレベルのイベントを発行します。

falseを指定した場合：

Informationレベルのイベントを発行しません。

false

com.cosminexus.mngsvr.jp1event.error
Errorレベルのイベントを発行するかどうかを指定します。

trueを指定した場合：

Errorレベルのイベントを発行します。

falseを指定した場合：

Errorレベルのイベントを発行しません。

false

com.cosminexus.mngsvr.jp1event.critical
Criticalレベルのイベントを発行するかどうかを指定します。

trueを指定した場合：

Criticalレベルレベルのイベントを発行します。

falseを指定した場合：

Criticalレベルのイベントを発行しません。

false

com.cosminexus.mngsvr.agent.read_timeout
運用監視エージェント接続時のタイムアウト時間を，1～2147483の整数値（単位：秒）で指定します。
180

注※1

指定されていない場合，Management Serverの起動に失敗します。

注※2

運用管理ドメイン内で運用管理エージェントとの通信に使用されるIPアドレスのサブネットが一つに決められている場合，指定するIPアドレスを"192¥¥.168¥¥.0¥¥..+"のように記述しておけば，前方が"192.168.0."であるIPアドレス（"192.168.0.32"や"192.168.0.128"など）にマッチするため，設定ファイルを修正しないで，すべてのホストに配布して利用できます。正規表現についての詳細は，Javaのjava.util.regex.Patternクラスの仕様を確認してください。

ただし，"¥¥"は1文字の"¥"に置き換えられてしまうため，"¥"を指定する場合は2文字連続して指定してください。指定した正規表現にマッチするIPアドレスが複数個検出された場合は，最も小さい値のIPアドレスを採用します。例えば，"192.168.0.32"と"192.168.0.128"が検出された場合は"192.168.0.32"を採用します。この場合，採用されたIPアドレスが意図するIPアドレスになるとは限らないため，"192¥¥.168¥¥.0¥¥.1.."のように必ず1個だけマッチする正規表現を記述してください。

(5)　注意事項

Management Server起動後は，運用管理ポータルの「Cosminexus Management Serverの設定」の「ネットワークの設定」からもポート番号を変更できます。ただし，mserver.propertiesファイルにコメントを書いていた場合，変更時に削除されます。

8.7　mserver.cfg（Management Server用オプション定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。
（例）　<キー名称> = <値> #<コメント>

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

Management Serverを実行するJavaVMの起動オプションを指定します。

Management Serverの稼働中に，このファイルの内容を変更しないでください。変更した場合の動作は保証されません。

(4)　指定できるキー

指定できるキーについては，「15.3(4)　指定できるキー」を参照してください。

8.8　mserverenv.cfg（Management Server用環境変数定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　注意事項

(1)　形式

次のようにキーを指定します。

<キー名称>=<値>

指定方法

キーと値の間のセパレータには「=」を使用します。「=」前後の空白は無視されます。

改行までが値になります。改行文字はOSに従います。

1行の最大サイズは65536バイトとします。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

Management Serverを操作（起動，停止およびセットアップ）するときの環境変数を指定します。

(4)　指定できるキー

指定できるキーとデフォルト値を次に示します。

キー名称
内容
デフォルト値

add.env
環境変数を次の形式で設定します。
<環境変数名>=<環境変数値>
複数のキーを指定できます。
環境変数値には特殊変数※も指定できます。

（例）

add.env=AAAHOME=C:¥aaa

add.env=BBBHOME=C:¥bbb

環境変数AAAHOMEの値をC:¥aaaに，BBBHOMEの値をC:¥bbbに設定します。

なし

注※

指定できる特殊変数を次に示します。

特殊変数 | 内容
${cosminexus.home} | Cosminexusインストールディレクトリ
%{XXX} | 環境変数XXXの値

(5)　注意事項

次の環境変数は，Management Serverを起動したときにWebコンテナが上書きするため，設定した値は有効となりません。

PATH

共有ライブラリ検索パス（UNIXの場合だけ）

CLASSPATH

HVI_TRACEPATH

HVI_COMTFILECOUNT

HVI_COMTENTRYCOUNT

TPDIR

TPJDIR

8.9　manager.cfg（Manager設定ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(1)　形式

次のようにキーを指定します。

<キー名称>=<値>

指定方法

キーと値の間のセパレータには「=」を使用します。「=」前後の空白は無視されます。

改行までが値になります。改行文字はOSに従います。

1行は1KB（1024バイト）未満とします。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

行頭行末の空白文字や空行は無視されます。

同じキーを複数指定した場合は，最後のキーの値を有効とします。

ASCII文字だけ使用できます。

ファイルセパレータには「/」を使用します。

キーや値の一部に「¥」は使用できません。

パスセパレータはOSに従います。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

Management Server，運用管理エージェント，それぞれの上で動作するコンポーネントやコマンドに共通の設定を行います。

統合ログとしてManagerの統合メッセージログ，統合トレースログ，コマンド保守ログがあります。

(4)　指定できるキー

指定できるキーとデフォルト値を次に示します。

キー名称
内容
デフォルト値

com.cosminexus.manager.log.dir
Managerのログ出力ディレクトリを指定します。
ファイルセパレータには「/」を使用してください。
なお，指定したログ出力ディレクトリが不正な場合は，Managerは起動されません。
<Cosminexusのインストールディレクトリ>/manager/log

com.cosminexus.manager.messagelog.size
統合メッセージログファイル一つ当たりの上限サイズ（バイト）を，4096～16777216で指定します。範囲外の値を指定した場合は，262144を仮定します。
なお，次の操作をした後に，設定値を変更しても変更は有効になりません。

Management Serverの起動

運用管理エージェントの起動

Managerが提供するコマンドの実行

値を変更する場合は，バックアップ後に次のディレクトリを削除してください。

<Managerのログ出力ディレクトリ>/message

262144

com.cosminexus.manager.messagelog.fnum
統合メッセージログファイルの面数を，1～64で指定します。
なお，次の操作をした後に，設定値を変更しても変更は有効になりません。

Management Serverの起動

運用管理エージェントの起動

Managerが提供するコマンドの実行

値を変更する場合は，バックアップ後に次のディレクトリを削除してください。

<Managerのログ出力ディレクトリ>/message

4

com.cosminexus.manager.tracelog.size
統合トレースログファイル一つ当たりの上限サイズ（バイト）を，4096～16777216で指定します。範囲外の値を指定した場合は，1048576を仮定します。
なお，次の操作をした後に，設定値を変更しても変更は有効になりません。

Management Serverの起動

運用管理エージェントの起動

Managerが提供するコマンドの実行

値を変更する場合は，バックアップ後に次のディレクトリを削除してください。

<Managerのログ出力ディレクトリ>/trace

1048576

com.cosminexus.manager.tracelog.fnum
統合トレースログファイルの面数を，1～64で指定します。
なお，次の操作をした後に，設定値を変更しても変更は有効になりません。

Management Serverの起動

運用管理エージェントの起動

Managerが提供するコマンドの実行

値を変更する場合は，バックアップ後に次のディレクトリを削除してください。

<Managerのログ出力ディレクトリ>/trace

4

com.cosminexus.manager.cmdtracelog.size
コマンド保守ログファイル一つ当たりの上限サイズ（バイト）を，4096～16777216で指定します。範囲外の値を指定した場合は，16777216を仮定します。
なお，次の操作をした後に，設定値を変更しても変更は有効になりません。

Managerが提供するコマンドを実行

値を変更する場合は，バックアップ後に次のディレクトリとログファイルを削除してください。

<Managerのログ出力ディレクトリ>/maintenance/mmap

<Managerのログ出力ディレクトリ>/maintenance/mngcmd[n].log

16777216

com.cosminexus.manager.cmdtracelog.fnum
コマンド保守ログファイルの面数を，1～64で指定します。
なお，次の操作をした後に，設定値を変更しても変更は有効になりません。

Managerが提供するコマンドを実行

値を変更する場合は，バックアップ後に次のディレクトリとログファイルを削除してください。

<Managerのログ出力ディレクトリ>/maintenance/mmap

<Managerのログ出力ディレクトリ>/maintenance/mngcmd[n].log

4

com.cosminexus.manager.log.compatible
Managerのログの上位互換性を指定します。

trueを指定した場合：

Managerの統合ログによって不要になったファイルを出力します。

falseを指定した場合：

Managerの統合ログによって不要になったファイルを出力しません。

true

8.10　maction.properties（Managementアクション実行用プロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　設定例

(6)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

Management Serverのプロパティファイルです。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

Managementイベントで通知されるメッセージIDに対応するManagementアクションを定義します。

(4)　指定できるキー

指定できるキーとその内容および指定を省略した場合のデフォルト値を次に示します。

キー名称
内容
分類
デフォルト値

maction.<ManagementアクションID>.command
Managementアクションとして実行するコマンドを絶対パスで指定します。※1
Managementアクションの定義
なし

maction.<ManagementアクションID>.timeout
実行するコマンドプロセスに対するタイムアウトを，0～86400の整数（単位：秒）で指定します。
0を指定した場合は，タイムアウトしません。
Managementアクションの定義
10

maction.<ManagementアクションID>.timeout.forced_stop
タイムアウト発生時の，実行したコマンドプロセスに対する操作を指定します。

trueを指定した場合：

コマンドプロセスを強制終了します。

falseを指定した場合：

何もしません。

強制終了する場合，コマンドプロセスが作成したサブプロセスについては保証されません。
Managementアクションの定義
false

maction.<ManagementアクションID>.exclusive_time
Managementアクション実行開始後から，同一ManagementアクションIDのManagementアクションの実行を抑止する時間（単位：秒）を0～86400の整数で指定します。
0を指定した場合，抑止しません。
Managementアクションの定義
0

maction.<ManagementアクションID>.max_executable_actions
同一ManagementアクションIDのManagementアクションの同時実行数の最大値を0～1000の整数で指定します。
0を指定した場合，同時実行数を制限しません。
Managementアクションの定義
0

maction.message.<メッセージID>.mactions
Managementイベントで通知するメッセージIDに対するManagementアクションIDを指定します。英数字およびコンマ（,）が使用できます。※2
複数指定する場合はコンマ（,）で区切ります。
指定したManagementアクションに対してコマンドが設定されていない場合，Managementアクションは実行されません。
メッセージIDとManagementアクションのマッピング
なし

maction.server.<論理サーバ名>.mactions
論理サーバに対応するManagementアクションIDを指定します。英数字およびコンマ（,）が使用できます。※2
複数指定する場合はコンマ（,）で区切ります。
キー名称の<論理サーバ名>には，J2EEサーバ，J2EEサーバクラスタ，J2EEサーバクラスタのメンバ，およびSFOサーバが指定できます。指定したManagementアクションに対してコマンドが設定されていない場合，Managementアクションは実行されません。
論理サーバとManagementアクションのマッピング
なし

maction.tier.<Webシステム名>.<物理ティア種別名>.mactions
物理ティアに対応するManagementアクションIDを指定します。英数字およびコンマ（,）が使用できます。※2
指定したManagementアクションに対してコマンドが設定されていない場合，Managementアクションは実行されません。
論理サーバとManagementアクションのマッピング
なし

maction.unit.<Webシステム名>.<サービスユニット名>.mactions
サービスユニットに対応するManagementアクションIDを指定します。英数字およびコンマ（,）が使用できます。※2
指定したManagementアクションに対してコマンドが設定されていない場合，Managementアクションは実行されません。
論理サーバとManagementアクションのマッピング
なし

maction.mevent.receiving_info.keep_size.max
Managementイベントの受信情報を保持する最大数を，0～2147483647の整数で指定します。0を指定した場合，Managementイベント受信情報を保持しません。Managementイベント受信情報を保持することで，ネットワークの高負荷や障害によるManagementアクションの二重実行を防止することができます。Managementイベント受信情報保持数が最大数を超えた場合，保持している受信情報のうち最も古い受信情報を削除します。Managementイベント受信情報は，次の場合に破棄されます。

任意のManagementイベント受信時に，Managementイベントの再送期限が過ぎた受信情報を破棄

Management Server停止時にすべての受信情報を破棄

Managementイベント受信時の設定
100

注※1

Managementアクションとして実行するコマンドはManagement Serverが実行します。また，Management Serverで設定された環境変数を引き継ぎます。

コマンドファイルのサンプルは，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

注※2

コンマ（,）前後の空白文字は無視されます。

(5)　設定例

maction.propertiesファイルの内容を次に示します。

Windowsの場合

# Managementアクションの定義
maction.restart.command=c¥:¥¥tmp¥¥command1.bat
maction.restart.timeout=12
maction.restart.timeout.forced_stop=true
maction.restart.exclusive_time=60
maction.restart.max_executable_actions=1

# メッセージIDとManagementアクションのマッピング
maction.message.KDJE11111-E.mactions=restart
maction.message.KDJE22222-E.mactions=restart

# 論理サーバとManagementアクションのマッピング
maction.server.j2ee1.mactions=restart
maction.server.j2ee2.mactions=restart
maction.server.j2eeClstr1.mactions=restart

UNIXの場合

# Managementアクションの定義
maction.restart.command=/tmp/command1.sh
maction.restart.timeout=12
maction.restart.timeout.forced_stop=true
maction.restart.exclusive_time=60
maction.restart.max_executable_actions=1

# メッセージIDとManagementアクションのマッピング
maction.message.KDJE11111-E.mactions=restart
maction.message.KDJE22222-E.mactions=restart

# 論理サーバとManagementアクションのマッピング
maction.server.j2ee1.mactions=restart
maction.server.j2ee2.mactions=restart
maction.server.j2eeClstr1.mactions=restart

(6)　注意事項

Managementアクション指定重複時の優先
次のプロパティキーについて，指定する論理サーバ，サービスユニットおよび物理ティアには
J2EEサーバ ＜ J2EEサーバクラスタ ＜ サービスユニット ＜ 物理ティア
という包含関係が存在します。

maction.server.<論理サーバ名>.mactions

maction.unit.<Webシステム名>.<サービスユニット名>.mactions

maction.tier.<Webシステム名>.<物理ティア種別名>.mactions

そのため，包含関係を持つ論理サーバ（例えば，J2EEクラスタと，そのJ2EEクラスタの要素となるJ2EEサーバ）それぞれに対して別々のManagementアクションが指定された場合，次の優先順でどれか一つのManagementアクションが実行されます。

Managementイベントを発行したJ2EEサーバ

Managementイベントを発行したJ2EEサーバを含むJ2EEサーバクラスタ

Managementイベントを発行したJ2EEサーバを含むサービスユニット

Managementイベントを発行したJ2EEサーバを含む物理ティア

また，メッセージIDとManagementアクションのマッピング，論理サーバとManagementアクションのマッピングでManagementアクションの指定順序が異なる場合，メッセージIDとManagementアクションのマッピング（maction.message.<メッセージID>.mactionsキー）に指定されたManagementアクションIDの順番を優先します。

（例）"act1"を優先する例

maction.message.KDJE99999-E.mactions=act1,act2

maction.server.J2EE01.mactions=act3,act2,act1

なお，この例では，「KDJE99999-E」がメッセージID，「J2EE01」が論理サーバです。

標準出力／標準エラー出力について
Managementアクションとして実行するコマンドから出力される標準出力／標準エラー出力についてはManagement Serverでは取得しません。そのため，コマンドの標準出力／標準エラー出力を取得する場合は，コマンドの中でファイルに出力する必要があります。

8.11　Managementイベント発行用プロパティファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

Management Serverのプロパティファイルです。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥mevent.<論理サーバ名>.properties

UNIXの場合
/opt/Cosminexus/manager/config/mevent.<論理サーバ名>.properties

(3)　機能

Managementイベント送信元の論理サーバ，送信先のManagement Server，通知するメッセージIDリストファイルなどを定義します。

(4)　指定できるキー

指定できるキーとその内容および指定を省略した場合のデフォルト値を次に示します。

キー名称
内容
デフォルト値

manager.mevent.send.host
送信先ホストを指定します。
Managementイベントの送信先であるManagement Serverのホスト名またはIPアドレスを指定します。英数字および記号が使用できます。
指定がない場合，Managementイベントを発行しません。
なし

manager.mevent.send.port
送信先ポート指定します。
Managementイベントの送信先であるManagement ServerのHTTPポート番号を，1～65535の整数で指定します。
指定がない，または不正である場合はManagementイベントを発行しません。
なし

manager.mevent.logical_server_name
Managementイベントの発行元となる論理サーバ名を指定します。英数字および記号が使用できます。
指定がない場合，Managementイベントを発行しません。
存在しない論理サーバ名を指定した場合，Managementイベントは無視されます。
なし

manager.mevent.send.timeout
送信タイムアウトを指定します。
Managementイベントの発行時に，Management Serverからの応答を待つ時間を，10～600の整数（単位：秒）で指定します。
指定時間内に応答がない場合，Managementイベント発行失敗とみなします。
90

manager.mevent.retry.limit
送信期限を指定します。
Managementイベントの発行に失敗した場合の再送を繰り返す期限を，0～86400の整数（単位：秒）で指定します。
Managementイベントの発行は，発行に成功するか，このキーに指定された時間が過ぎるまで，manager.mevent.retry.intervalキーで指定された再送間隔で繰り返します。
0が指定された場合は，Managementイベントを再送しません。
0

manager.mevent.retry.interval
Managementイベントを再送する場合の再送間隔を，1～86400の整数（単位：秒）で指定します。
10

manager.mevent.message_id.list
Managementイベント発行用メッセージIDリストファイルを絶対パスで指定します。
指定されたファイルが不正である場合はManagementイベントを発行しません。
省略された場合は，デフォルトのManagementイベント発行用メッセージIDリストファイルに登録されているメッセージIDをManagementイベントとして通知します。
Managementイベント発行用メッセージIDリストファイルについては，「8.12　Managementイベント発行用メッセージIDリストファイル」を参照してください。
なし

manager.mevent.send.max
Managementイベントの同時発行最大数を，1～1000の整数で指定します。
10

manager.mevent.sender.bind.host
Managementイベント送信時に使用するローカルアドレスのホスト名またはIPアドレスを指定します。英数字および記号が使用できます。
省略した場合，任意のローカルIPアドレスが割り当てられます。
なし

なお，ファイルを作成する場合は，次のManagementイベント発行用プロパティファイルの雛型を参照してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥mevent.properties

UNIXの場合
/opt/Cosminexus/manager/config/templates/mevent.properties

(5)　注意事項

Managementイベント発行機能の設定ファイルは，J2EEサーバインスタンスごとに指定する必要があります。同時に動作する複数のJ2EEサーバインスタンスの間で同じファイルを指定しないでください。

Managementイベントは，Managementイベント発生順に発行されます。ただし，発行に失敗したManagementイベントは，予定されているManagementイベントの発行後に再発行されます。

8.12　Managementイベント発行用メッセージIDリストファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　デフォルト

(5)　サンプル

(6)　注意事項

(1)　形式

次の形式で指定します。

[<インジケータ>]<メッセージID>

1行に一つのメッセージIDを記述します。

インジケータにシャープ（#）を指定した場合，その行はコメントとみなされます。

インジケータにプラス（+）を指定，またはインジケータを省略した場合，該当メッセージIDをManagementイベントとして通知します。

インジケータにハイフン（-）を指定した場合，該当メッセージIDをManagementイベントとして通知しません。デフォルトのManagementイベント発行用メッセージIDリストに記載されたメッセージIDをManagementイベントとして通知しない場合に使用します。

行頭行末の空白文字や空行は無視されます。

同一のメッセージIDを複数指定した場合，後方に記述されたメッセージIDが有効になります。

メッセージIDがプラス（+）またはハイフン（-）で始まる場合，インジケータは必ず指定してください。

(2)　ファイルの格納先

格納先およびファイル名称は任意です。ファイル名には次の文字が使用できます。

英数字，ピリオド（.），円符号（¥），コロン（:），プラス（+），またはハイフン（-）

(3)　機能

Managementイベントとして通知するメッセージIDを定義します。

(4)　デフォルト

Managementイベントとして通知するメッセージIDのデフォルトを次に示します。

表8-2　Management発行用メッセージID（デフォルト）

機能
監視対象
メッセージID

リソース枯渇監視
メモリ使用状況
KDJE34500-W

ファイルディスクリプタ数
KDJE34520-W

スレッド数
KDJE34540-W

スレッドダンプファイル数
KDJE34580-W
KDJE34581-E

HTTPリクエスト実行待ちキュー
KDJE34621-W

HTTPセッション数
KDJE34640-W

コネクションプールの使用状況
KDJE34660-W
KDJE34661-W

J2EEアプリケーション実行時間監視
J2EEアプリケーション実行時間
KDJE52702-W
KDJE52703-W
KDJE52705-W
KDJE52713-E

コネクション障害検知
コネクション障害検知のタイムアウト
KDJE48602-W

コネクション管理スレッド
KDJE48603-W

フルガーベージコレクション回数の監視
フルガーベージコレクション回数
KDJE53850-W

URLグループ単位の実行待ちリクエスト数の監視
URLグループ単位の実行待ちリクエスト数の上限しきい値
KDJE53860-W

URLグループ単位の実行待ちリクエスト数の下限しきい値
KDJE53861-I

コネクションプールのクラスタ化
コネクションプールの状態
KDJE49650-I
KDJE49653-I
KDJE49655-E
KDJE49657-E
KDJE49660-I
KDJE49663-E
KDJE49664-E
KDJE49669-E

コネクション管理スレッド
KDJE49671-I

(5)　サンプル

KDJE34580-WとKDJE34660-WをManagementイベントとして通知しない場合

# Monitoring of resources
# : Status of memory(Java Heap)
KDJE34500-W

# : Number of file descriptors
KDJE34520-W

# : Number of threads
KDJE34540-W

# : Number of thread dump files
-KDJE34580-W
KDJE34581-E

# : Number of HTTP requests in queue
KDJE34621-W

# : Number of HTTP sessions
KDJE34640-W

# : Status of connection pool
-KDJE34660-W
KDJE34661-W

# Monitoring of execution time of user program
KDJE52702-W
KDJE52703-W
KDJE52705-W
KDJE52713-E

なお，ファイルを作成する場合は，次のManagementイベント発行用メッセージIDリストファイルの雛型を参照してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥mevent.midlist.conf

UNIXの場合
/opt/Cosminexus/manager/config/templates/mevent.midlist.conf

(6)　注意事項

次のメッセージIDはManagementイベントの発行対象外です。これらのメッセージIDを指定した場合，その指定は無視されます。

KDJE90001-E

KDJE90002-E

KDJE90003-E

KDJE90005-W

KDJE90006-W

KDJE90009-W

指定可能なメッセージIDは，Managementイベント発行機能と連携するJ2EEサーバやバッチサーバが出力する特定のメッセージIDだけです。それ以外のシステムメッセージID，J2EEアプリケーション，またはバッチアプリケーションから出力されるメッセージIDを指定してもManagementイベントは発行されません。

8.13　Management Server管理ファイル用退避対象定義ファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　デフォルト

(5)　記述例

(1)　形式

次の形式で指定します。

<ファイル名>

絶対パスで指定します。

シャープ（#）で始まる行はコメントとみなされます。

ファイルセパレータはスラッシュ（/）を使用します。

指定されたパスにファイルが存在しない場合，該当する行を無視して処理を継続します。

使用できる変数は次の変数です。$はシステムプロパティを示します。指定する値には$を含めないでください。
${cosminexus.home}：Cosminexusのインストールディレクトリ
${user.home}：ユーザのホームディレクトリ

(2)　ファイルの格納先

格納先およびファイル名称は任意です。

(3)　機能

運用管理サーバの実行系と待機系を1:1にして系切り替えをする場合，実行系の運用管理サーバのManagement Server管理ファイルとして収集，退避させるファイルを定義します。デフォルトで収集対象となっているファイル以外に収集したいファイルがある場合に指定します。

(4)　デフォルト

Management Server管理ファイルとしてデフォルトで収集されるファイルの対象ディレクトリを次に示します。

種類
対象ディレクトリ

定義ファイル格納ディレクトリ

Windowsの場合
<Cosminexusインストールディレクトリ>/manager/config/

UNIXの場合
/opt/Cosminexus/manager/config/

アプリケーション登録ディレクトリ

Windowsの場合
<Cosminexusインストールディレクトリ>/manager/containers/m/webapps/mngsvr/mportal/mapps/regapps/

UNIXの場合
/opt/Cosminexus/manager/containers/m/webapps/mngsvr/mportal/mapps/regapps/

リソースアダプタ登録ディレクトリ

Windowsの場合
<Cosminexusインストールディレクトリ>/manager/containers/m/webapps/mngsvr/mportal/mwebsystems/regras/

UNIXの場合
/opt/Cosminexus/manager/containers/m/webapps/mngsvr/mportal/mwebsystems/regras/

リポジトリ管理用構成情報定義結果格納ファイル

Windowsの場合
<Cosminexusインストールディレクトリ>/manager/containers/m/webapps/mngsvr/mportal/useradmin/config/data/editusersConfig.xml

UNIXの場合
/opt/Cosminexus/manager/containers/m/webapps/mngsvr/mportal/useradmin/config/data/editusersConfig.xml

(5)　記述例

/home/confdir/message1.confを収集する場合

/home/confdir/message1.conf

<Cosminexusのインストールディレクトリ>/manager/apps/MyApp.ear（Windowsの場合），または/opt/Cosminexus/manager/apps/MyApp.ear（UNIXの場合）を収集する場合

${cosminexus.home}/manager/apps/MyApp.ear

8.14　.mngsvrutilrc（mngsvrutilコマンドのクライアント側定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　反映のタイミング

(5)　指定できるキー

(1)　形式

J2SEのプロパティファイル形式です。

(2)　ファイルの格納先

各OSユーザのホームディレクトリ

(3)　機能

mngsvrutilコマンドのオプションのデフォルト値を設定できます。

(4)　反映のタイミング

設定ファイルの変更後，次回mngsvrutilコマンドの発行時に更新情報が反映されます。

(5)　指定できるキー

クライアント側定義ファイルで指定できるキーとその内容および指定を省略した場合のデフォルト値を次に示します。

キー名称
内容
デフォルト値

mngsvrutil.connect.host
-mオプションに指定するホスト名，およびポート番号を設定します。
（設定例）
mngsvrutil.connect.host=localhost:28080
Management Serverのホスト名とポート番号を指定します。

ホスト名
ドット記法でのIPアドレス指定，または名前解決できるホスト名で指定します。
IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスが使用されます。※1

ポート番号
Management Serverの設定に従います。デフォルト値は28080です。

注意事項

ホスト単位管理モデルで運用する場合に，mserver.propertiesのwebserver.connector.http.bind_hostに値を指定しているときは，同じ値を指定してください。

IPアドレスを表す正規表現にコロン（:）を指定しないでください。コロン（:）が指定された場合，コロン以降はポート番号とみなされます。

なし

mngsvrutil.connect.password
-pオプションに指定するパスワードを設定します。なお，パスワードを設定していない場合，このキーは必要ありません。
（設定例）
mngsvrutil.connect.password=admin
なし

mngsvrutil.connect.userid
-uオプションに指定するユーザIDを設定します。
（設定例）
mngsvrutil.connect.userid=admin
なし

mngsvrutil.output.file
-oオプションに指定する出力ファイル名を設定します。
（設定例）
Windowsの場合
mngsvrutil.output.file=C:/tmp/output.txt
UNIXの場合
mngsvrutil.output.file=/tmp/output.txt
なし

mngsvrutil.output.format
-fオプションに指定する出力形式を設定します。
CSV形式で出力する場合はcsv，SNMP連携形式で出力する場合はsnmpを指定します。
（設定例）
mngsvrutil.output.format=csv
csv

mngsvrutil.output.suppress_header
-hオプションを指定する場合はtrueを，指定しない場合はfalseを設定します。なお，大文字と小文字は区別されません。
（設定例）
mngsvrutil.output.suppress_header=true
false

mngsvrutil.target_name※2
-tオプションに指定する論理サーバ名，またはホスト名を指定します。
（設定例）
mngsvrutil.target_name=myServer
サブコマンドの対象となるターゲット名称（論理サーバ名またはホスト名）を指定します。
運用管理ポータルの「論理サーバの構成定義」の定義に従います。
IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスが使用されます※1

注意事項

-kオプションまたはmngsvrutil.target_kindにhostを指定する場合に，mserver.propertiesのwebserver.connector.http.bind_hostに値を指定しているときは，同じ値を指定してください。

なし

mngsvrutil.target_kind
-kオプションに指定するターゲット種別を指定します。
（設定例）
mngsvrutil.target_kind=host
なし

mngsvrutil.target_server_name※2
-tオプションに指定する論理サーバ名を設定します。ただし，06-00以降のバージョンでは，mngsvrutil.target_nameを使用することを推奨します。mngsvrutil.target_nameと同時に指定した場合は，mngsvrutil.target_nameの指定が有効になります。
（設定例）
mngsvrutil.target_server_name=myServer
なし

注1

各キーが存在しない，または誤っている場合はデフォルト値を仮定します。

注2

パスワードなどの情報が含まれるため，適切にファイルパーミッションを設定してください。

注3

ASCII文字以外の文字を記述する場合は，設定ファイルの文字エンコーディングとmngsvrutilコマンド実行時のOSロケールの文字エンコーディングを合わせてください。また，日本語を使用する場合にエスケープシーケンスを含めた文字列で指定しないでください。

注4

JP1/Cm2/ESA for Extension Mib Runtime，またはJP1/Cm2/Extensible Agent for Extension Mib Runtimeを利用してSNMP連携をする場合，JP1/Cm2/ESA for Extension Mib Runtime，またはJP1/Cm2/Extensible Agent for Extension Mib Runtimeの実行ユーザのホームディレクトリ以下に設定ファイルを準備してください。

注※1

運用管理ドメイン内で運用管理エージェントとの通信に使用されるIPアドレスのサブネットが一つに決められている場合，指定するIPアドレスを"192¥¥.168¥¥.0¥¥..+"のように記述しておけば，前方が"192.168.0."であるIPアドレス（"192.168.0.32"や"192.168.0.128"など）にマッチするため，設定ファイルを修正しないで，すべてのホストに配布して利用できます。正規表現についての詳細は，Javaのjava.util.regex.Patternクラスの仕様を確認してください。

ただし，"¥¥"は1文字の"¥"に置き換えられてしまうため，"¥"を指定する場合は2文字連続して指定してください。指定した正規表現にマッチするIPアドレスが複数個検出された場合は，最も小さい値のIPアドレスを採用します。例えば，"192.168.0.32"と"192.168.0.128"が検出された場合は"192.168.0.32"を採用します。この場合，採用されたIPアドレスが意図するIPアドレスになるとは限らないため，"192¥¥.168¥¥.0¥¥.1.."のように必ず1個だけマッチする正規表現を記述してください。

注※2

mngsvrutil.target_nameキーとmngsvrutil.target_server_nameキーの指定と，mngsvrutilコマンドの-kオプションおよび-tオプションの指定の関係については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

8.15　mngsvrutil.properties（mngsvrutilコマンドのサーバ側定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　反映のタイミング

(5)　指定できるキー

(1)　形式

J2SEのプロパティファイル形式です。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

mngsvrutilコマンドの実行環境を設定します。

(4)　反映のタイミング

Management Server起動中に設定ファイルを更新した場合，Management Serverの再起動後に更新情報が反映されます。

(5)　指定できるキー

サーバ側定義ファイルで指定できるキーとその内容および指定を省略した場合のデフォルト値を次に示します。

キー名称
内容
デフォルト値

mngsvrutil.auth.failed_wait
管理ユーザの認証に失敗した場合に待機する秒数を指定します（指定できる値：0～2147483647）。
（設定例）
mngsvrutil.auth.failed_wait=10
5

mngsvrutil.auth.log_challenged
HTTPによるアクセスがあったことをログに出力するかどうかを指定します。
（true：出力します，false：出力しません）※1
（設定例）
mngsvrutil.auth.log_challenged=false
true

mngsvrutil.auth.log_denied
HTTPによるアクセスを拒否したことをログに出力するかどうかを指定します。
（true：出力します，false：出力しません）※1
（設定例）
mngsvrutil.auth.log_denied=false
true

mngsvrutil.auth.log_failed
管理ユーザの認証に失敗したことをログに出力するかどうかを指定します。
（true：出力します，false：出力しません）※1
（設定例）
mngsvrutil.auth.log_failed=false
true

mngsvrutil.auth.log_succeeded
管理ユーザの認証に成功したことをログに出力するかどうかを指定します。
（true：出力します，false：出力しません）※1
（設定例）
mngsvrutil.auth.log_succeeded=false
true

mngsvrutil.session.max_inactive_interval
サーバがクライアントにセッションを生成して，クライアントから最後にリクエストを受けてからセッションを無効化するまでの最大の秒数を指定します（指定できる値：-2147483648～2147483647）※2。
（設定例）
mngsvrutil.session.max_inactive_interval=10
5

注1

各キーが存在しない，または誤っている場合はデフォルト値を仮定します。

注2

Management Server起動中に設定ファイルを更新した場合，Management Serverの再起動後に更新情報が反映されます。

注※1

設定値（true，false）は，大文字，小文字の区別はしません。

注※2

負の値を指定した場合，セッションを無効化しません。

8.16　mngsvrutilcl.properties（mngsvrutilコマンドのクライアント側共通定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　反映のタイミング

(5)　指定できるキー

(6)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

mngsvrutilコマンドのオプションのデフォルト値を共通定義として設定できます。

また，この定義ファイルを適用するユーザを制限できます。

なお，クライアント側定義ファイル（.mngsvrutilrc）とmngsvrutilcl.properties（mngsvrutilコマンドのクライアント側共通定義ファイル）の両方が設定されている場合，クライアント側定義ファイル（.mngsvrutilrc）が適用されます。

(4)　反映のタイミング

設定ファイルの変更後，次回mngsvrutilコマンドの発行時に更新情報が反映されます。

(5)　指定できるキー

クライアント側共通定義ファイルで指定できるキーとその内容および指定を省略した場合のデフォルト値を次に示します。

キー名称
内容
デフォルト値

mngsvrutil.apply_user
mngsvrutilコマンドまたはアダプタコマンドを実行する時のOSユーザで，クライアント側共通定義ファイルを適用するユーザを指定します。このキーで指定したOSユーザが，mngsvrutilコマンドまたはアダプタコマンドを実行した場合だけ，これ以外に設定したキーが適用されます。
Windowsの場合，大文字と小文字は区別されません。UNIXの場合，大文字と小文字は区別されます。複数のユーザを指定する場合は，コンマ（,）で区切って指定します。
また，Windowsのサービスからmngsvrutilコマンドが呼び出される場合に，この定義ファイルを適用するには，ローカルシステムアカウントの「SYSTEM」を指定してください。
なお，UNIXの場合，SNMP連携およびJP1/IM連携（監視ツリーの自動生成やWebシステムの構成情報の収集）で，この定義ファイルを適用するには，「root」を指定してください。
（設定例）
Windowsの場合
mngsvrutil.apply_user=SYSTEM,Administrator
UNIXの場合
mngsvrutil.apply_user=root,user01
なし

mngsvrutilrc（mngsvrutilコマンドのクライアント側定義ファイル）のキー
指定できるキーについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。
－

(6)　注意事項

クライアント側定義ファイル（.mngsvrutilrc）が存在しない場合，無条件にクライアント側共通定義ファイル（mngsvrutilcl.properties）を読み込むため，このファイルにアクセス権限がないとWarningが発生します。

mngsvrutilコマンドおよびアダプタコマンドを実行するOSユーザには，クライアント側共通定義ファイルへのアクセス権限を付与し，mngsvrutil.apply_userキーでクライアント側共通定義ファイルを適用するユーザを選別することを推奨します。

8.17　.mngsvrmonitorrc（JP1/IM連携用モニタ起動コマンドの設定ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　反映のタイミング

(5)　指定できるキー

(1)　形式

J2SEのプロパティファイル形式です。

(2)　ファイルの格納先

JP1/IM-Viewを操作するOSユーザのホームディレクトリ

(3)　機能

JP1/IM連携をする場合に，JP1/IMの画面からManagement Serverの運用ポータルを起動するために必要な設定をします。なお，このファイルは，Windows用です。

(4)　反映のタイミング

設定ファイルの変更後，次回mngsvrmonitorコマンド実行時に更新情報が反映されます。

(5)　指定できるキー

モニタ起動コマンドの設定ファイルで指定できるキーとその内容および指定を省略した場合のデフォルト値を次に示します。

キー名称
内容
デフォルト値

mngsvrmonitor.browser
起動するWebブラウザのコマンドをフルパスで指定します。このキーを省略した場合はWindowsのレジストリに設定されているデフォルトブラウザを起動します（デフォルトブラウザが設定されていない場合はエラーになります）。
（設定例）
mngsvrmonitor.browser ="C:/Program Files/Internet Explorer/iexplore.exe"
レジストリのデフォルトブラウザ

mngsvrmonitor.connect.host
Cosminexus運用管理のホスト名およびポート番号を次の形式で指定します。
ホスト名[:ポート番号]
（設定例）
mngsvrmonitor.connect.host=h001:28080
ポート番号：28080

mngsvrmonitor.connect.password
運用管理ポータルの「管理ユーザアカウントの設定」で設定した管理ユーザIDに対応する管理ユーザパスワードを指定します。なお，パスワードを設定していない場合，このキーは必要ありません。
（設定例）
mngsvrmonitor.connect.password=p43269
なし

mngsvrmonitor.connect.userid
運用管理ポータルの「管理ユーザアカウントの設定」で設定した管理ユーザIDを指定します。このキーを省略した場合は運用管理ポータルのログイン画面を表示します。
（設定例）
mngsvrmonitor.connect.userid=admin
なし

8.18　JP1/IM連携用システムログメッセージマッピングファイル

JP1/IM連携用システムログメッセージマッピングファイルには，次のファイルがあります。これらのファイルでは，Cosminexusシステムで出力されるメッセージとJP1イベントの重大度のマッピングを定義します。

mserver.jp1event.system.mapping.properties（Management Server用メッセージマッピングファイル）

manager.jp1event.system.mapping.properties（J2EEサーバ共通用メッセージマッピングファイル）

manager.<論理サーバ名>.jp1event.system.mapping.properties（J2EEサーバ個別用メッセージマッピングファイル）

＜この節の構成＞

8.18.1　mserver.jp1event.system.mapping.properties（Management Server用メッセージマッピングファイル）

8.18.2　manager.jp1event.system.mapping.properties（J2EEサーバ共通用メッセージマッピングファイル）

8.18.3　manager.<論理サーバ名>.jp1event.system.mapping.properties（J2EEサーバ個別用メッセージマッピングファイル）

8.18.4　JP1イベントへの変換

8.18.1　mserver.jp1event.system.mapping.properties（Management Server用メッセージマッピングファイル）

＜この項の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　記述例

(1)　形式

J2SEのプロパティファイル形式です。

mserver.jp1event.system.mapping.severity.<メッセージID>=<JP1イベントの重大度>

<メッセージID>

マニュアル「Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編」，マニュアル「Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編」，およびマニュアル「Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編」に記載しているメッセージ一覧中のメッセージIDを指定します。

<JP1イベントの重大度>

Information，Notice，Warning，Error，Critical，Alert，Emergencyのどれかを指定します。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

(3)　機能

Management Serverが出力するログメッセージをJP1イベントに変換する際に使用するメッセージマッピングファイルです。

(4)　記述例

mserver.jp1event.system.mapping.severity.KEOS10001-E=Error
mserver.jp1event.system.mapping.severity.KEOS10010-I=Information

8.18.2　manager.jp1event.system.mapping.properties（J2EEサーバ共通用メッセージマッピングファイル）

＜この項の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　記述例

(1)　形式

J2SEのプロパティファイル形式です。

manager.jp1event.system.mapping.severity.<メッセージID>=<JP1イベントの重大度>

<メッセージID>

マニュアル「Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編」，マニュアル「Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編」，およびマニュアル「Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編」に記載しているメッセージ一覧中のメッセージIDを指定します。

<JP1イベントの重大度>

Information，Notice，Warning，Error，Critical，Alert，Emergencyのどれかを指定します。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

(3)　機能

サーバマシン中のJ2EEサーバ共通用でJ2EEサーバが出力するログメッセージをJP1イベントに変換する際に使用するメッセージマッピングファイルです。

(4)　記述例

manager.jp1event.system.mapping.severity.KDJE42019-E=Error
manager.jp1event.system.mapping.severity.KDJE42040-I=Information

8.18.3　manager.<論理サーバ名>.jp1event.system.mapping.properties（J2EEサーバ個別用メッセージマッピングファイル）

＜この項の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　記述例

(1)　形式

J2SEのプロパティファイル形式です。

manager.jp1event.system.mapping.severity.<メッセージID>=<JP1イベントの重大度>

<メッセージID>

マニュアル「Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編」，マニュアル「Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編」，およびマニュアル「Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編」に記載しているメッセージ一覧中のメッセージIDを指定します。

<JP1イベントの重大度>

Information，Notice，Warning，Error，Critical，Alert，Emergencyのどれかを指定します。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

(3)　機能

J2EEサーバごとにマッピングルールを定義したい場合に作成します。このファイルが定義されている場合，Cosminexusは該当するJ2EEサーバに対して個別用ファイルだけを使用し，J2EEサーバが出力するログメッセージをJP1イベントに変換します。

(4)　記述例

manager.jp1event.system.mapping.severity.KDJE42020-E=Error
manager.jp1event.system.mapping.severity.KDJE42041-I=Information

8.18.4　JP1イベントへの変換

Management Server，J2EEサーバおよびユーザログ機能で出力するログメッセージは，メッセージマッピングファイルを使用してJP1イベントに変換されます。

＜この項の構成＞

(1)　Management Server用JP1イベント

(2)　J2EEサーバ用JP1イベント

(3)　J2EEユーザ用JP1イベント

(1)　Management Server用JP1イベント

Management Server用JP1イベントには，次の二つの種類があります。

Cosminexusで定義されているJP1イベント

Management Server用メッセージマッピングファイルで指定するJP1イベント

●Cosminexusで定義されているJP1イベント

Cosminexusは，次のメッセージIDを持つメッセージが出力されたときに，JP1イベントを発行します。

表8-3　Cosminexusで定義されているManagement Server用JP1イベント

イベントID | 発行契機 | メッセージID
0x00012050 | Management Serverの起動 | KEOS10101-I
0x00012051 | Management Serverの終了 | KEOS10102-I
0x00012060 | ドメインへのWebシステム追加 | KEOS23301-I
0x00012061 | ドメインからのWebシステム削除 | KEOS23302-I
0x0001206A | Webシステムへのユニット追加・削除やJ2EEアプリケーションのデプロイ・アンデプロイなど（Webシステムの変更） | KEOS23303-I
0x00012070 | 運用管理エージェントの起動 | KEOS21100-I
0x00012071 | 運用管理エージェントの終了 | KEOS21101-I

●Management Server用メッセージマッピングファイルで指定するJP1イベント

Management Server用メッセージマッピングファイルのテンプレートファイル（mserver.jp1event.system.mapping.properties）で指定されているメッセージがJP1イベント発行の対象となります。

テンプレートファイルの格納先は，次のとおりです。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥templates

UNIXの場合
/opt/Cosminexus/manager/config/templates

メッセージマッピングファイルの指定によって発行されるManagement Server用JP1イベントを次の表に示します。

表8-4　メッセージマッピングファイルの指定によるManagement Server用JP1イベント

イベントID | 発行契機 | マッピングで指定したJP1イベントの重大度
0x00012000 | Management Serverで検出した論理サーバのEmergencyレベルの障害 | Emergency
0x00012001 | Management Serverで検出した論理サーバのAlertレベルの障害 | Alert
0x00012002 | Management Serverで検出した論理サーバのCriticalレベルの障害 | Critical
0x00012003 | Management Serverで検出した論理サーバのErrorレベルの障害 | Error
0x00012004 | Management Serverで検出した論理サーバのWarningレベルの障害 | Warning
0x00012005 | Management Serverで検出した論理サーバのNoticeレベルの障害 | Notice
0x00012006 | Management Serverで検出した論理サーバのInformationレベルの障害 | Information
0x00012020 | Management ServerのEmergencyレベルの障害 | Emergency
0x00012021 | Management ServerのAlertレベルの障害 | Alert
0x00012022 | Management ServerのCriticalレベルの障害 | Critical
0x00012023 | Management ServerのErrorレベルの障害 | Error
0x00012024 | Management ServerのWarningレベルの障害 | Warning
0x00012025 | Management ServerのNoticeレベルの障害 | Notice
0x00012026 | Management ServerのInformationレベルの障害 | Information

(2)　J2EEサーバ用JP1イベント

次のテンプレートファイルで指定されているメッセージがJ2EEサーバ用JP1イベント発行の対象となります。

J2EEサーバ共通用メッセージマッピングファイル（manager.jp1event.system.mapping.properties）

J2EEサーバ個別用メッセージマッピングファイル（manager.<論理サーバ名>.jp1event.system.mapping.properties）

テンプレートファイルの格納先は，次のとおりです。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥templates

UNIXの場合
/opt/Cosminexus/manager/config/templates

メッセージマッピングファイルの指定によるJ2EEサーバ用JP1イベントを次の表に示します。

表8-5　J2EEサーバ用JP1イベント

イベントID | 発行契機 | マッピングで指定したJP1イベントの重大度
0x00012080 | J2EEサーバのEmergencyレベルの障害 | Emergency
0x00012081 | J2EEサーバのAlertレベルの障害 | Alert
0x00012082 | J2EEサーバのCriticalレベルの障害 | Critical
0x00012083 | J2EEサーバのErrorレベルの障害 | Error
0x00012084 | J2EEサーバのWarningレベルの障害 | Warning
0x00012085 | J2EEサーバのNoticeレベルの障害 | Notice
0x00012086 | J2EEサーバのInformationレベルの障害 | Information
0x00012090 | J2EEサーバで検出したアプリケーションのEmergencyレベルの障害 | Emergency
0x00012091 | J2EEサーバで検出したアプリケーションのAlertレベルの障害 | Alert
0x00012092 | J2EEサーバで検出したアプリケーションのCriticalレベルの障害 | Critical
0x00012093 | J2EEサーバで検出したアプリケーションのErrorレベルの障害 | Error
0x00012094 | J2EEサーバで検出したアプリケーションのWarningレベルの障害 | Warning
0x00012095 | J2EEサーバで検出したアプリケーションのNoticeレベルの障害 | Notice
0x00012096 | J2EEサーバで検出したアプリケーションのInformationレベルの障害 | Information

(3)　J2EEユーザ用JP1イベント

ユーザログ機能で出力するメッセージがJ2EEユーザ用JP1イベント発行の対象となります。ユーザログ用JP1イベントの設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

表8-6　J2EEユーザ用JP1イベント

イベントID | 発行契機 | JP1イベントの重大度
0x000120D0 | アプリケーションのEmergencyレベルの障害 | Emergency
0x000120D1 | アプリケーションのAlertレベルの障害 | Alert
0x000120D2 | アプリケーションのCriticalレベルの障害 | Critical
0x000120D3 | アプリケーションのErrorレベルの障害 | Error
0x000120D4 | アプリケーションのWarningレベルの障害 | Warning
0x000120D5 | アプリケーションのNoticeレベルの通知 | Notice
0x000120D6 | アプリケーションのInformationレベルの通知 | Information

8.19　論理ユーザサーバ定義ファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　定義できる内容

(5)　定義例

(6)　注意事項

(1)　形式

xmlファイル形式です。

(2)　ファイルの格納先

格納先およびファイル名称は任意です。

(3)　機能

mngsvrutilコマンドで論理ユーザサーバを追加するときに作成します。

(4)　定義できる内容

論理ユーザサーバ定義ファイルに記述できる内容を次の表に示します。

要素名
説明
デフォルト値

<user-server-definition>
名前空間として次のパスを指定します。http://www.cosminexus.com/mngsvr/schema/UserServerDefinition-1.0
－

<service>
サービスの定義。
必ず指定してください。
－

<type>
起動方法を直接起動にするか間接起動にするかを指定します。

directを指定した場合：

直接起動します。

indirectを指定した場合：

間接起動します。

direct

<startup-order>
起動順序を-1～999の整数で指定します。-1を指定した場合は，指定なしとなります。
900

<start-watch-time>
起動監視時間を次の数値（単位：秒）で指定します。0を指定した場合は，監視しません。
0，60，300，600，3600
60

<stop-watch-time>
停止監視時間を次の数値（単位：秒）で指定します。0を指定した場合は，監視しません。
0，60，300，600，1800
60

<force-watch-time>
強制停止監視時間を次の数値（単位：秒）で指定します。0を指定した場合は，監視しません。
0，60，300，600，1800
60

<retry-count>
自動再起動回数を次の数値で指定します。
0，1，5，10，1000
1

<retry-interval>
自動再起動リトライ間隔を次の数値（単位：秒）で指定します。0を指定した場合は，即時リトライします。
0，60，300，600，1800
60

<watch-interval>
監視間隔を，1～86400の整数（単位：秒）で指定します。
1

<start-time-watch-interval>
起動時監視間隔を，1～86400の整数（単位：秒）で指定します。
1

<env>
環境変数の定義。
複数指定できます。
－

name
環境変数名を指定します。
必ず指定してください。
－

value
環境変数値を指定します。
必ず指定してください。
環境変数の指定値に次の文字列「${cosminexus.home}」が含まれている場合は，<Cosminexusのインストールディレクトリ>に置換されます。
－

<working-dir>
ワーキングディレクトリを絶対パスで指定します。
<Cosminexusのインストールディレクトリ>/manager/bin

<user-id>
コマンド実行時のユーザIDを指定します。
この要素は，UNIX用です。
－

<group-id>
コマンド実行時のグループIDを指定します。
この要素は，UNIX用です。
－

<command>
コマンドを定義。
必ず指定してください。また，複数指定できます。
－

type
コマンド種別※1を指定します。指定できる値は，次のとおりです。

start：サーバ起動用コマンド

stop：サーバ停止用コマンド

forceStop：サーバ強制停止用コマンド

getProcessID：プロセスID取得用コマンド

isAlive：サービス監視用コマンド

必ず指定してください。
－

timeout
タイムアウト時間を，1～86400の整数（単位：秒）で指定します。
ただし，コマンド種別がgetProcessIDまたはisAliveのときだけ有効となります。
180

<arg>
コマンド引数を指定します。※2
必ず指定してください。また，複数指定できます。
－

<server>
論理ユーザサーバ定義。
必ず指定してください。また，複数指定できます。
－

<logical-server-name>
論理サーバ名を128文字以下で指定します。使用できる文字は半角文字の英数字（A～Z，a～z，0～9），アンダースコア（_），およびハイフン（-）です。
必ず指定してください。
－

<display-name>
論理サーバの表示名を128文字以下で指定します。
－

<description>
論理サーバの説明を1024文字以下で指定します。
－

<host-ref>
あらかじめ定義されたホスト名を255文字以下で指定します。使用できる文字は半角文字の英数字（A～Z，a～z，0～9），アンダースコア（_），ハイフン（-）およびピリオド（.）です。
必ず指定してください。
－

注※1

起動種別によってコマンド種別の指定条件が異なります。起動種別によるコマンド種別の指定条件と要件を次に示します。

起動種別
コマンド種別
指定条件
要件
備考

直接起動
start
必須
サーバ起動用コマンドが監視対象となります。
－

stop
任意
サーバ停止用コマンドの正常終了時には，監視対象プロセスが終了しています。
指定していない場合は次の動作をします。

Windowsの場合
該当プロセスに対しCtrl-Cイベントを発行します。プロセスが停止しない場合は，TerminateProcess()を実行します。

UNIXの場合
該当プロセスに対しSIGTERMを送信します。その1秒後にプロセスが停止しない場合は，SIGKILLを送信します。

forceStop
任意

サーバ強制停止用コマンドの終了時には，監視対象プロセスが終了しています。

サーバ強制停止用コマンド発行後は，サーバ起動用コマンドが実行可能状態となります。

指定していない場合は次の動作をします。

Windowsの場合
該当プロセスに対しCtrl-Cイベントを発行します。プロセスが停止しない場合は，TerminateProcess()を実行します。

UNIXの場合
該当プロセスに対しSIGTERMを送信します。その1秒後にプロセスが停止しない場合は，SIGKILLを送信します。

getProcessID
指定不可
－
指定した場合はエラーとなります。

isAlive
任意
サービスが稼働中の場合は終了コードが0，稼働中ではない場合は終了コードが０以外となります。
指定した場合はサービス監視を行います。

間接起動
start
必須

プロセス起動用コマンドの正常終了時には，すべての監視対象プロセスが起動完了します。

プロセス起動用コマンドの正常終了時には，プロセス停止用コマンドが実行可能状態となります。

正常終了の場合は終了コードが0，異常終了の場合は終了コードが1となります。

－

stop
任意
サーバ停止用コマンドの正常終了時には，監視対象プロセスが終了しています。
指定していない場合は次の動作をします。

Windowsの場合
該当プロセスに対しCtrl-Cイベントを発行します。プロセスが停止しない場合は，TerminateProcess()を実行します。

UNIXの場合
該当プロセスに対しSIGTERMを送信します。その1秒後にプロセスが停止しない場合は，SIGKILLを送信します。

forceStop
任意

サーバ強制停止用コマンドの終了時には，監視対象プロセスが終了しています。

サーバ強制停止用コマンド発行後は，サーバ起動用コマンドが実行可能状態となります。

指定していない場合は次の動作をします。

Windowsの場合
該当プロセスに対しCtrl-Cイベントを発行します。プロセスが停止しない場合は，TerminateProcess()を実行します。

UNIXの場合
該当プロセスに対しSIGTERMを送信します。その1秒後にプロセスが停止しない場合は，SIGKILLを送信します。

getProcessID
必須

サーバ起動用コマンドで起動したプロセスのプロセスIDを10進表現で標準出力に出力します。

複数のプロセスが起動される場合はすべてのプロセスのプロセスIDを出力します。

正常終了の場合は終了コードが0，異常終了の場合は終了コードが1となります。

出力フォーマットは次のようになります。

9 9 9 6 ¥n
1 0 0 2 3 ¥n
1 0 2 5 7 ¥n

－

isAlive
任意
サービスが稼働中の場合は終了コードが0，稼働中ではない場合は終了コードが0以外となります。
指定した場合はサービス監視を行います。

注※2

コマンド引数の指定値に次の文字列が含まれている場合は，対応する値に置換されます。

置換前の文字列 | 置換後の文字列 | 備考
${cosminexus.home} | Cosminexusインストールディレクトリ | －
%{XXX} | 環境変数XXXの値 | 環境変数XXXが存在しない場合は空白文字列に置換されます。
${server.name} | 論理サーバ名 | －

(5)　定義例

<?xml version="1.0" encoding="UTF-8" ?>
<user-server-definition xmlns="http://www.cosminexus.com/mngsvr/schema/UserServerDefinition-1.0">

 <!-- サービス定義 -->
 <service>
   <!-- 起動種別 -->
   <type>direct</type>
   <!-- 起動順序 -->
   <startup-order>900</startup-order>
   <!-- 起動監視時間 -->
   <start-watch-time>60</start-watch-time>
   <!-- 停止監視時間 -->
   <stop-watch-time>60</stop-watch-time>
   <!-- 強制停止監視時間 -->    
   <force-watch-time>60</force-watch-time>
   <!-- 自動再起動回数 -->
   <retry-count>1</retry-count>
   <!-- 自動再起動リトライ間隔 -->
   <retry-interval>60</retry-interval>
   <!-- 監視間隔 -->
   <watch-interval>1</watch-interval>
   <!-- 起動時監視間隔 -->
   <start-time-watch-interval>1</start-time-watch-interval>
   <!-- 環境変数 -->
   <env name="USERSERVER_HOME" value="C:¥UserServer"/>
   <!-- ワーキングディレクトリ -->
   <working-dir>C:¥UserServer</working-dir>
   <!-- ユーザID -->
   <user-id>userserver</user-id>
   <!-- グループID -->
   <group-id>userserver</group-id>
   <!-- サーバ起動用コマンド -->
   <command type="start" timeout="180">
      <arg>C:¥UserServer¥start.exe</arg>
   </command>
   <!-- サーバ停止用コマンド -->
   <command type="stop" timeout="180">
      <arg>C:¥UserServer¥stop.exe</arg>
   </command>
   <!-- サーバ強制停止用コマンド -->
   <command type="forceStop" timeout="180">
      <arg>C:¥UserServer¥forceStop.exe</arg>
   </command>
   <!-- プロセスID取得用コマンド -->
<!--
   <command type="getProcessID" timeout="180">
      <arg>C:¥UserServer¥getProcessID.exe</arg>
   </command>
-->
   <!-- サービス監視用コマンド -->
   <command type="isAlive" timeout="180">
      <arg>C:¥UserServer¥isAlive.exe</arg>
   </command>
 </service>

 <!-- 論理ユーザサーバ定義 -->
 <server>
   <logical-server-name>UserServer01</logical-server-name>
   <display-name>論理ユーザサーバ</display-name>
   <description>これは論理ユーザサーバです</description>
   <host-ref>192.168.1.1</host-ref>
 </server>
</user-server-definition>

(6)　注意事項

stopコマンドおよびforceStopコマンドを指定していない場合に，startコマンドに別のプロセスを起動するようなバッチファイル，またはシェルスクリプトを指定しないでください。指定すると，運用管理エージェントを再起動した場合に，バッチファイルまたはシェルスクリプトから起動したプロセスを，運用管理エージェントの停止操作または強制停止操作の延長で終了できなくなります。

直接起動でstartコマンドに別のプロセスを起動するようなバッチファイル，またはシェルスクリプトを指定する場合は，stopコマンドおよびforceStopコマンドを指定してください。

間接起動でstartコマンドに別のプロセスを起動するようなバッチファイル，またはシェルスクリプトを指定する場合は次のようにしてください。

stopコマンドおよびforceStopコマンドを指定する。

バッチファイルまたはシェルスクリプトから起動したプロセスのプロセスIDを取得するようなgetProcessIDコマンドを指定する。

9.　ログの運用で使用するファイル

この章では，ログの運用で使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

9.1　ログの運用で使用するファイルの一覧

9.2　snapshotログ収集対象定義ファイル

9.1　ログの運用で使用するファイルの一覧

ログの運用で使用するファイルの一覧を，次の表に示します。

表9-1　ログの運用で使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
（任意） | snapshotログ収集対象定義ファイル | snapshotログとして収集する，一次送付資料および二次送付資料の対象ファイルを定義します。 | 9.2

9.2　snapshotログ収集対象定義ファイル

snapshotログは，システム保守に必要な情報およびアプリケーション保守に必要な情報を収集します。

snapshotログ収集対象定義ファイルでは，snapshotログとして収集する，一次送付資料および二次送付資料の対象ファイルを設定します。このファイルを編集することで，snapshotログ収集対象のパスを変更することができます。

＜この節の構成＞

(1)　形式

(2)　格納先およびファイル名

(3)　使用できる変数

(4)　記述例

(1)　形式

次の形式で指定します。

収集対象のパスはフルパスで指定します。

#で始まる行はコメントとみなされます。

ファイルセパレータは「/」を使用します。

ファイルセパレータで分類されたパス要素に対して，正規表現※が使用できます。

不正な正規表現※を含む場合，その指定は無視されます。

指定したパスにファイルが存在しない場合，その指定は無視されます。

注※

正規表現については，java.util.regex.Patternの定義を参照してください。

(2)　格納先およびファイル名

インストール時のデフォルト設定ファイルを編集する場合

次のファイルを編集してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.conf
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.2.conf

UNIXの場合
/opt/Cosminexus/manager/config/snapshotlog.conf
/opt/Cosminexus/manager/config/snapshotlog.2.conf

snapshotlog.confには，一次送付資料として収集する対象を設定します。

snapshotlog.2.confには，二次送付資料として収集する対象を設定します。

snapshotログの収集対象ファイルについては，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

任意のファイルを指定する場合

格納先およびファイル名は任意です。

次の場所にあるテンプレートをコピーして使用してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合
/opt/Cosminexus/manager/config/templates/

(3)　使用できる変数

パスを指定する場合，次の変数が使用できます。

表9-2　snapshotログ収集対象定義ファイルで使用できる変数

変数 | 内容
${cosminexus.home} | Cosminexusのインストールディレクトリ
${user.home} | ユーザのホームディレクトリ
${hws.home} | Hitachi Web Serverのインストールディレクトリ
${com.cosminexus.manager.log.dir} | Managerのログ出力ディレクトリ
&{prfspool} | 論理サーバの環境設定で，パフォーマンストレーサの[設定]タブを選択し，[パフォーマンストレーサの設定]のスプールディレクトリで設定された値
&{ctmspool} | 論理サーバの環境設定で，CTMドメインマネジャの[基本設定]タブを選択し，[CTMドメインマネジャの基本設定]のスプールディレクトリで設定された値
&{ejb.public.directory} | 論理サーバの環境設定で，J2EEサーバの[コンテナ]-[J2EE]タブを選択し，[J2EEコンテナの設定]の作業ディレクトリの定義で設定された値
&{webserver.work.directory} | 論理サーバの環境設定で，J2EEサーバの[コンテナ]-[Web]タブを選択し，JSP用一時ディレクトリで設定された値
&{ejb.server.log.directory} | 論理サーバの環境設定で，J2EEサーバの[サービス]-[ログ]タブを選択し，ログ出力ディレクトリで設定された値
&{webserver.logger.access_log.inprocess_http.filename} | 論理サーバの環境設定で，J2EEサーバの[サービス]-[トランザクション]タブを選択し，[アクセスログの設定]の出力ファイル名で設定された値
&{ejbserver.distributedtx.ots.status.directory1} | 論理サーバの環境設定で，J2EEサーバの[HTTPサーバ]-[ログ]タブを選択し，インプロセスOTSのステータスファイル格納先で設定された値
&{ejbserver.distributedtx.ots.status.directory2} | 論理サーバの環境設定で，J2EEサーバの[HTTPサーバ]-[ログ]タブを選択し，インプロセスOTSのステータスファイル格納先（予備）で設定された値
&{core.dump.directory} | 論理サーバの環境設定で，Webサーバの[設定]タブを選択し，[Webサーバの基本的な設定]のコアダンプ出力先ディレクトリで設定された値
&{hws.logfile.dir} | 論理サーバの環境設定で，Webサーバの[設定]タブを選択し，[Webサーバの出力するログの設定]のログ出力先ディレクトリで設定された値
&{jklogfiledir} | 論理サーバの環境設定で，Webサーバの[リダイレクタ]タブを選択し，ログ出力先ディレクトリで設定された値
&{jktracelogfiledir} | 論理サーバの環境設定で，Webサーバの[リダイレクタ]タブを選択し，保守用のトレースログのログ出力先ディレクトリで設定された値

注

$はシステムプロパティ，&はManagement Serverの内部変数を表します。

値に"$"を含む変数は使用できません。

snapshotログ収集コマンドを使って収集する場合は，&を使用したManagement Serverの内部変数は使用できません。

(4)　記述例

/home/logdir/message1.logを収集する場合

/home/logdir/message1¥※.log

/opt/Cosminexus/manager/logディレクトリ直下のファイルをすべて収集する場合

${cosminexus.home}/manager/log/.+※

J2EEサーバのJavaVMのスレッドダンプを収集する場合（作業ディレクトリ=/home/workdir，J2EEサーバ名=Server1）

/home/workdir/ejb/Server1/javacore.+¥※.txt

注※

"¥"は"."（ピリオド）の打ち消し文字です。

"."（ピリオド）は，任意の文字を表します。

"+"は，1回以上を表します。

10.　監査ログの設定で使用するファイル

この章では，監査ログの設定で使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

10.1　監査ログの設定で使用するファイルの一覧

10.2　監査ログ定義ファイル

10.1　監査ログの設定で使用するファイルの一覧

監査ログの設定で使用するファイルの一覧を，次の表に示します。

表10-1　監査ログの設定で使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
（任意） | 監査ログ定義ファイル | 監査ログに関する設定をします。 | 10.2

10.2　監査ログ定義ファイル

＜この節の構成＞

(1)　形式

(2)　機能

(3)　格納先およびファイル名

(4)　設定できるキー

(5)　監査ログのアクセス権限の設定

(6)　記述例

(7)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。また，行頭や行末の空白は無視されます。

同じ<キー名称>を複数指定した場合，最後に指定した<キー名称>の＜値＞が有効になります。

値の後ろには，コメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。
（誤りの例）　<キー名称> = <値> #<コメント>

記載する文字はJavaの仕様に従って，ISO 8859-1 文字エンコーディングを使用してください。

<キー名称>や＜値＞には，「¥」を使用しないでください。また，＜値＞に指定するディレクトリの区切り文字は「/」を使用してください。

(2)　機能

監査ログ定義ファイルでは，監査ログ出力時のログファイルの設定，監査ログの有効無効の設定，出力を抑止するメッセージの指定など監査ログに関する設定をします。

(3)　格納先およびファイル名

インストール時のデフォルト設定ファイルを編集する場合

次のファイルを編集してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥common¥conf¥auditlog.properties

UNIXの場合
/opt/Cosminexus/common/conf/auditlog.properties

任意のファイルを指定する場合

格納先名は任意です。

環境変数COSMINEXUS_AUDITLOG_CONFに，監査ログ定義ファイルをフルパスで指定してください。

例

COSMINEXUS_AUDITLOG_CONF=D:/auditlog/auditlog.properties

(4)　設定できるキー

指定できるキーとデフォルト値を次に示します。このキーに不正な値を指定した場合，動作は保証されません。

キー名称
内容
デフォルト値

auditlog.enabled
監査ログを出力するかどうかを指定します。

trueを指定した場合：

監査ログを出力します。

falseを指定した場合：

監査ログを出力しません。

false

auditlog.user
監査ログファイルの所有者（ユーザ）を指定します。
<auditsetupコマンドを実行したユーザ>

auditlog.group
監査ログファイルの所有者（グループ）を指定します。
<auditsetupコマンドを実行したユーザのプライマリグループ>

auditlog.mode
監査ログファイルのアクセス権限を，777までの3けたの数値で指定します※1。
UNIXの場合だけ指定します。
666

auditlog.filtered.message.list
出力抑止対象のメッセージIDをコンマ（,）で区切って指定します。512個まで指定できます。
なし

auditlog.filesize
監査ログファイルの1面当たりのファイルサイズ（単位：バイト）を，4096～33554432で指定します。
1048576

auditlog.filenum
監査ログファイルの面数を，2～32で指定します。
4

auditlog.directory
監査ログファイルの出力ディレクトリの絶対パスを指定します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥auditlog

UNIXの場合

/opt/Cosminexus/auditlog

これらのディレクトリが存在しない場合は，新規に作成されます※2。

auditlog.raslog.message.filesize
監査ログのメッセージログを出力するファイルの1面当たりのファイルサイズ（単位：バイト）を，4096～16777216で指定します。
1048576

auditlog.raslog.message.filenum
監査ログのメッセージログを出力するファイルの面数を，2～64で指定します。
4

auditlog.raslog.message.directory
監査ログのメッセージログを出力するファイルの出力ディレクトリを絶対パスで指定します。
監査ログファイルの出力ディレクトリ（auditlog.directory）の値

auditlog.raslog.exception.filesize
監査ログの例外情報を出力するファイルの1面当たりのファイルサイズ（単位：バイト）を，4096～16777216で指定します。
1048576

auditlog.raslog.exception.filenum
監査ログの例外情報を出力するファイルの出力ディレクトリを絶対パスで指定します。
8

auditlog.raslog.exception.directory
監査ログの例外情報を出力するファイルの出力ディレクトリを絶対パスで指定します。
監査ログファイルの出力ディレクトリ（auditlog.directory）の値

注※1　指定値はchmodコマンドで指定する数値モードに従います。ただし，実際に設定される値は，umaskに影響されます。例えば，umask=0222の場合，auditlog.modeに777を指定しても，755が設定されます。

注※2　指定したディレクトリが存在しない場合，新規に作成されるディレクトリの所有者およびアクセス権は次のように設定されます。

Windowsの場合
ディレクトリの所有者やアクセス権限には，上位ディレクトリの設定が引き継がれます。

UNIXの場合
ディレクトリの所有者は監査ログを出力したユーザとそのプライマリグループになります。アクセス権限に777が設定されます。

(5)　監査ログのアクセス権限の設定

WindowsとUNIXで，監査ログ定義ファイルの指定値と監査ログの所有者およびアクセス権限の対応が異なります。

Windowsの場合
監査ログ定義ファイルの指定値と監査ログファイルの所有者およびアクセス権限の対応を，次の表に示します。

表10-2　監査ログ定義ファイルの指定値と監査ログファイルの所有者およびアクセス権限の対応（Windowsの場合）

監査ログ定義ファイル
監査ログファイル

auditlog.user
auditlog.group
所有者
アクセス権限※1

－
－
上位ディレクトリの設定を引き継ぐ
Everyone:RW
Administrators:F
SYSTEM:F

<ユーザ名>
－
<ユーザ名>:RW
Administrators:F
SYSTEM:F

－
<グループ名>
<グループ名>:RW
Administrators:F
SYSTEM:F

<ユーザ名>
<グループ名>
<ユーザ名>:RW
<グループ名>:RW
Administrators:F
SYSTEM:F

（凡例）　－：指定しない。

注※1

Windowsのアクセス権限を，次の形式で記述します。

<ユーザ名またはグループ名>:<許可する権限>

<許可する権限>は次のとおりです。

　F：フルコントロール

　RW：読み取りと書き込みを許可

UNIXの場合
監査ログ定義ファイルの指定値と監査ログファイルの所有者およびアクセス権限の対応を，次の表に示します。

表10-3　監査ログ定義ファイルの指定値と監査ログファイルの所有者およびアクセス権限の対応（UNIXの場合）

監査ログ定義ファイル
監査ログファイル

auditlog.user
auditlog.group
auditlog.mode※1
所有者
（ユーザ）
所有者
（グループ）
アクセス権限※2

－
－
－
root※3
rootのプライマリグループ※3
666※3

－
－
777
root※3
rootのプライマリグループ※3
777

<ユーザ名>
－
－
<ユーザ名>
<ユーザ名>のプライマリグループ※3
666※3

－
<グループ名>
777
root※3
<グループ名>
777

<ユーザ名>
<グループ名>
777
<ユーザ名>
<グループ名>
777

（凡例）　－：指定しない。

注※1

「auditlog.mode」に指定する値を，「777」として説明しています。

注※2

実際に設定される値はumaskによるマスクが実行されます。例えば，umask=0222が設定されている場合，auditlog.mode=777と指定しても，755が設定されます。

注※3

デフォルト値です。

参考

auditsetupコマンドを使用しないで，監査ログファイルを出力した場合，出力ディレクトリおよびファイルのアクセス権限は，次のように設定されます。

Windowsの場合
ディレクトリおよびファイルの所有者やアクセス権限には，上位ディレクトリの設定が引き継がれます。

UNIXの場合
ディレクトリおよびファイルの所有者やアクセス権限は，次のように設定されます。

表10-4　ディレクトリおよびファイルの所有者とアクセス権限（UNIXの場合）

ディレクトリ／ファイル | ログ種別 | 所有者 | アクセス権限
出力ディレクトリ | 監査ログ | 実行ユーザおよびそのプライマリグループ | 777※
メッセージログ | 777
例外情報 | 777
出力ファイル | 監査ログ | 666※
メッセージログ | 666
例外情報 | 666

注※　umaskによるマスクが実行されます。

（例）　umask=0022が設定されている場合，777と指定しても，755が設定されます。ただし，サーバ管理コマンドを実行したことによって監査ログファイルが作成されたときは，umaskの値として0が使用されます。

(6)　記述例

監査ログ定義ファイル（auditlog.properties）の記述内容を次に示します。

auditlog.enabled=true
#auditlog.user=
#auditlog.group=
#auditlog.mode=666
auditlog.filtered.message.list=KDJExxxxxx-E,KDJEyyyyyy-I
auditlog.directory=D:/auditlog/logs
#auditlog.filesize=1048576
#auditlog.filenum=4
#auditlog.raslog.message.directory=${auditlog.directory}
#auditlog.raslog.message.filesize=1048576
#auditlog.raslog.message.filenum=4
#auditlog.raslog.exception.directory=${auditlog.directory}
#auditlog.raslog.exception.filesize=1048576
#auditlog.raslog.exception.filenum=8

(7)　注意事項

監査ログ定義ファイルは監査ログを出力するすべてのプロセスから参照されるため，次の注意が必要です。

監査ログ出力中に監査ログ定義ファイルの格納場所や記述内容を変更しないでください。また，変更した場合には監査ログを出力するすべてのプロセスを停止したあとで，監査ログ出力機能を再セットアップしてください。

監査ログ定義ファイルを参照するすべてのプロセスに対して，読み込み権限を付与してください。付与していない場合，そのプロセスは監査ログ定義ファイルの読み込みに失敗して，監査ログを出力できません。

製品のインストール単位に一つだけ監査ログ定義ファイルを設定してください。

監査ログ出力ライブラリにおいて，COSMINEXUS_AUDITLOG_CONF環境変数を指定しないで，かつ，監査ログ定義ファイルが存在しない場合，標準エラー出力およびメッセージログおよび例外情報には，監査ログ定義ファイル読み込み失敗のメッセージは出力されません。

11.　統合ユーザ管理で使用するファイル

この章では，統合ユーザ管理で使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

11.1　統合ユーザ管理で使用するファイルの一覧

11.2　jaas.conf（JAASのコンフィグレーションファイル）

11.3　ua.conf（統合ユーザ管理のコンフィグレーションファイル）

11.4　シングルサインオン用認証情報のCSV形式ファイル

11.1　統合ユーザ管理で使用するファイルの一覧

統合ユーザ管理で使用するファイルの一覧を，次の表に示します。

表11-1　統合ユーザ管理で使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
jaas.conf | JAASのコンフィグレーションファイル | ユーザ認証ライブラリおよびシングルサインオンライブラリの機能を使用するために必要な設定をします。 | 11.2
ua.conf | 統合ユーザ管理のコンフィグレーションファイル | JAAS対応ユーザ管理，およびシングルサインオンの機能を使用するための設定ファイルです。 | 11.3
（任意） | シングルサインオン用認証情報のCSV形式ファイル | シングルサインオン用の認証情報を設定します。 | 11.4

11.2　jaas.conf（JAASのコンフィグレーションファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるオプション

(5)　WebPasswordLoginModuleに指定するオプション

(6)　WebSSOLoginModuleに指定するオプション

(7)　DelegationLoginModuleに指定するオプション

(8)　WebCertificateLoginModuleに指定するオプション

(9)　WebPasswordJDBCLoginModuleに指定するオプション

(10)　WebPasswordLDAPLoginModuleに指定するオプション

(1)　形式

ユーザ認証ライブラリおよびシングルサインオンライブラリの機能を使用するために必要なJAASのコンフィグレーションファイルです。

次のようにオプションを指定します。

Application {
 ログインモジュール名 Flag ModuleOptions;
};

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

ユーザ認証ライブラリおよびシングルサインオンライブラリの機能を使用するために必要な設定をします。JAASのコンフィグレーションファイルは，運用前に作成し，各ホストに配布する必要があります。その際，盗聴のおそれがあるため，配布の際には注意が必要です。

(4)　指定できるオプション

オプションの名称と内容を次の表に示します。

オプション名
内容

Application
アプリケーション名を指定します。アプリケーションが特定できる名称を使用することを推奨します。なお，ここで指定した名称は，LoginContextクラスのインスタンス化時に使用されます。
Cosminexusでは，次に示す文字列で始まる名称を使用します。そのため，アプリケーション名にこれらの文字列で始まる名称を指定しないでください。

jp.co.hitachi.soft

com.hitachi.software

com.cosminexus

ログインモジュール名
使用する認証エンジンを指定します。
次のどれかのログインモジュールを指定してください。

WebPasswordLoginModule
パスワードを使用してユーザを認証する場合

WebCertificateLoginModule
クライアント証明書を使用してユーザを認証する場合

WebPasswordLDAPLoginModule
LDAPディレクトリサーバの認証機能を使用してユーザを認証する場合

WebPasswordJDBCLoginModule
ユーザ情報リポジトリとしてデータベースを使用する場合

DelegationLoginModule
カスタムログインモジュールを呼び出す場合

WebSSOLoginModule
シングルサインオン機能を使用する場合

Flag
LoginContextが呼び出したログインモジュールの正否によって動作を変えるためのフラグを指定します。指定するフラグの詳細については，JASSのドキュメントを参照してください。

ModuleOptions
ログインモジュールが実行する際に必要なオプションを指定します。指定するオプションの詳細については，「（5）WebPasswordLoginModuleに指定するオプション」～「（10）WebPasswordLDAPLoginModuleに指定するオプション」に示します。

(5)　WebPasswordLoginModuleに指定するオプション

WebPasswordLoginModuleに指定するオプションとデフォルト値を次に示します。

オプション
内容
デフォルト値

com.cosminexus.admin.auth.ldap.r
「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。指定する値は，ユーザ情報リポジトリを参照可能な設定を，識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。ここで指定された値は，WebPasswordLoginModuleを利用してログインする場合などのリポジトリの参照が必要な機能で使用されます。
0

com.cosminexus.admin.auth.ldap.w
「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。指定する値は，ユーザ情報リポジトリを更新可能な設定を，識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。ここで指定された値は，パスワードの変更機能などの，リポジトリの内容を管理するための機能で使用されます。
0

com.cosminexus.admin.auth.sso.ldap.w
「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。このオプションは，PasswordUtilクラスを使ってパスワードを変更するときにシングルサインオン用の認証情報も変更する場合，かつシングルサインオン用の認証情報変更にLDAP接続フェールオーバを利用する場合に指定してください。指定する値は，シングルサインオン情報リポジトリを更新可能な設定を，識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。
なお，この値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.sso.ldap.wで指定した値よりも優先されます。
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

com.cosminexus.admin.auth.realm
認証するレルムを文字列で指定します。
なし

com.cosminexus.admin.auth.keep_password
該当レルムにログインしたユーザのパスワードを統合ユーザ管理のセッションに保持するかどうかを，trueまたはfalseで指定します。大文字と小文字は区別されません。
trueを指定した場合は保持します。falseを指定した場合は保持しません。なお，trueを指定しても，該当レルムですでにログインしている場合，すでに保持しているパスワードを上書きすることはありません。パスワードを保持しない場合，同一セッションの同一レルムに2回目以降WebPasswordLDAPLoginModuleを使用してログインするとき，ユーザIDとパスワードの入力が必要になります。
なお，ここで指定された値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.keep_passwordで指定された値よりも優先されます。
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

com.cosminexus.admin.auth.keep_password.encrypt
com.cosminexus.admin.auth.keep_passwordにtrueを指定した場合，パスワードを保持するときに暗号化するかどうかを，trueまたはfalseで指定します。大文字と小文字は区別されません。
trueを指定した場合はパスワードを暗号化します。
falseを指定した場合は暗号化しません。
なお，ここで指定された値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.keep_password.encryptで指定された値よりも優先されます。
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

com.cosminexus.admin.auth.gsession.keep_password
統合ユーザ管理のセッションフェイルオーバ機能が有効，かつcom.cosminexus.admin.auth.keep_passwordにtrueを指定した場合に，統合ユーザ管理のセッションに保持したパスワードをセッションフェイルオーバの対象にするかどうかを指定します。

trueを指定した場合：

パスワードをグローバルセッションに保持します。

falseを指定した場合：

パスワードをグローバルセッションに保持しません。

セッションフェイルオーバをした場合，同一セッションの同一レルムにWebPasswordLDAPLoginModuleを使用してログインするとき，2回目以降はユーザIDとパスワードの入力が必要になります。
（指定例）
com.cosminexus.admin.auth.gsession.keep_password=true
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

(6)　WebSSOLoginModuleに指定するオプション

WebSSOLoginModuleに指定するオプションとデフォルト値を次に示します。

オプション
内容
デフォルト値

com.cosminexus.admin.auth.sso
WebSSOLoginModuleから呼び出すログインモジュールの識別子を指定します。ここで指定された識別子を基にJAAS対応ユーザ管理の設定ファイルから必要な情報を読み込みます。
なお，この指定が省略されていた場合は，Cosminexus標準のログインモジュール（WebPasswordLoginModule）を仮定します。
WebPasswordLoginModule

com.cosminexus.admin.auth.sso.ldap.r
「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。指定する値は，シングルサインオン情報リポジトリを参照可能な設定を，識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。ここで指定された値は，WebSSOLoginModuleを利用してシングルサインオンをする場合などのリポジトリの参照が必要な機能で使用されます。
なお，この値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.sso.ldap.rで指定した値よりも優先されます。
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

com.cosminexus.admin.auth.sso.ldap.w
「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。指定する値は，シングルサインオン情報リポジトリを更新可能な設定を，識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。ここで指定された値は，パスワードの変更機能などの，リポジトリの更新が必要な機能で使用されます。
なお，この値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.sso.ldap.wで指定した値よりも優先されます。
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

com.cosminexus.admin.auth.realm
認証するレルムを，文字列で指定します。
なし

(7)　DelegationLoginModuleに指定するオプション

DelegationLoginModuleに指定するオプションとデフォルト値を次に示します。

オプション | 内容 | デフォルト値
com.cosminexus.admin.auth.custom.lm | DelegationLoginModuleが呼び出すカスタムログインモジュール名（クラス名）を，文字列で指定します。指定は，完全限定名（fully qualified name）で記述してください。 | なし
com.cosminexus.admin.auth.realm | 認証するレルムを，文字列で指定します。 | なし

(8)　WebCertificateLoginModuleに指定するオプション

WebCertificateLoginModuleに指定するオプションとデフォルト値を次に示します。

オプション | 内容 | デフォルト値
com.cosminexus.admin.auth.ldap.r | 「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。指定する値は，ユーザ情報リポジトリを参照可能な設定を，識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。ここで指定された値は，WebCertificateLoginModuleを利用してログインする場合などのリポジトリの参照が必要な機能で使用されます。 | 0
com.cosminexus.admin.auth.realm | 認証するレルムを，文字列で指定します。 | なし

(9)　WebPasswordJDBCLoginModuleに指定するオプション

WebPasswordJDBCLoginModuleに指定するオプションとデフォルト値を次に示します。

オプション
内容
デフォルト値

com.cosminexus.admin.auth.jdbc.r
「11.3(3)　リポジトリアクセス用パラメタ」で定義したJDBC設定番号を指定します。指定する値は，ユーザ情報リポジトリを参照可能な設定を，識別する番号です。ただし，ここで指定する値は""で囲む必要があります。ここで指定された値は，WebPasswordJDBCLoginModuleを利用してログインする場合などのリポジトリの参照が必要な機能で使用されます。
0

com.cosminexus.admin.auth.realm
認証するレルムを，文字列で指定します。
なし

com.cosminexus.admin.auth.keep_password
該当レルムにログインしたユーザのパスワードを統合ユーザ管理のセッションに保持するかどうかをtrueまたはfalseで指定します。大文字と小文字は区別されません。
trueを指定した場合は保持します。falseを指定した場合は保持しません。なお，trueを指定しても，該当レルムですでにログインしている場合，すでに保持しているパスワードを上書きすることはありません。パスワードを保持しない場合，同一セッションの同一レルムに2回目以降WebPasswordLDAPLoginModuleを使用してログインするとき，ユーザIDとパスワードの入力が必要になります。
ただし，ここで指定された値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.keep_passwordで指定された値よりも優先されます。
＜統合ユーザ管理のコンフィグレーションファイルで指定した値＞

com.cosminexus.admin.auth.keep_password.encrypt
com.cosminexus.admin.auth.keep_passwordにtrueを指定した場合，パスワードを保持するときに暗号化するかどうかをtrueまたはfalseで指定します。大文字と小文字は区別されません。
trueを指定した場合はパスワードを暗号化します。
falseを指定した場合は暗号化しません。
ただし，ここで指定された値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.keep_password.encryptで指定された値よりも優先されます。
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

com.cosminexus.admin.auth.gsession.keep_password
統合ユーザ管理のセッションフェイルオーバ機能が有効，かつcom.cosminexus.admin.auth.keep_passwordにtrueを指定した場合に，統合ユーザ管理のセッションに保持したパスワードをセッションフェイルオーバの対象にするかどうかを指定します。

trueを指定した場合：

パスワードをグローバルセッションに保持します。

falseを指定した場合：

パスワードをグローバルセッションに保持しません。

セッションフェイルオーバをした場合，同一セッションの同一レルムにWebPasswordLDAPLoginModuleを使用してログインするとき，2回目以降はユーザIDとパスワードの入力が必要になります。
（指定例）
com.cosminexus.admin.auth.gsession.keep_password=true
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

(10)　WebPasswordLDAPLoginModuleに指定するオプション

WebPasswordLDAPLoginModuleに指定するオプションとデフォルト値を次に示します。

オプション
内容
デフォルト値

com.cosminexus.admin.auth.ldap.r
「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。指定する値は，ユーザ情報リポジトリを，参照可能な設定を識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。ここで指定された値は，WebPasswordLDAPLoginModuleを利用してログインする場合などのリポジトリの参照が必要な機能で使用されます。
0

com.cosminexus.admin.auth.ldap.w
「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。指定する値は，ユーザ情報リポジトリを，更新可能な設定を識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。ここで指定された値は，パスワードの変更機能などの，リポジトリの内容を管理するための機能で使用されます。
0

com.cosminexus.admin.auth.sso.ldap.w
「11.3(3)　リポジトリアクセス用パラメタ」で定義したLDAP設定番号を指定します。このオプションは，PasswordUtilクラスを使ってパスワードを変更するときにシングルサインオン用の認証情報も変更する場合，かつシングルサインオン用の認証情報変更にLDAP接続フェールオーバを利用する場合に指定してください。指定する値は，シングルサインオン情報リポジトリを更新可能な設定を，識別する番号です。ただし，ここで指定する値は""で囲む必要があります。コンマ（,）で区切ることでLDAP設定番号を複数指定できます。複数指定すると，最初に指定されたLDAPディレクトリサーバがダウンした場合に自動的に切り替えができます。
なお，この値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.sso.ldap.wで指定した値よりも優先されます。
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

com.cosminexus.admin.auth.realm
認証するレルムを，文字列指定します。
なし

com.cosminexus.admin.auth.keep_password
該当レルムにログインしたユーザのパスワードを統合ユーザ管理のセッションに保持するかどうかをtrueまたはfalseで指定します。大文字と小文字は区別されません。
trueを指定した場合は保持します。falseを指定した場合は保持しません。なお，trueを指定しても，該当レルムですでにログインしている場合，すでに保持しているパスワードを上書きすることはありません。パスワードを保持しない場合，同一セッションの同一レルムに2回目以降WebPasswordLDAPLoginModuleを使用してログインするとき，ユーザIDとパスワードの入力が必要になります。
なお，ここで指定された値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.keep_passwordで指定された値よりも優先されます。
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

com.cosminexus.admin.auth.keep_password.encrypt
com.cosminexus.admin.auth.keep_passwordにtrueを指定した場合，パスワードを保持するときに暗号化するかどうかをtrueまたはfalseで指定します。大文字と小文字は区別されません。
trueを指定した場合はパスワードを暗号化します。
falseを指定した場合は暗号化しません。
なお，ここで指定された値は統合ユーザ管理のコンフィグレーションファイルのcom.cosminexus.admin.auth.keep_password.encryptで指定された値よりも優先されます。
＜統合ユーザ管理のコンフィグレーションファイルで指定した値＞

com.cosminexus.admin.auth.gsession.keep_password
統合ユーザ管理のセッションフェイルオーバ機能が有効，かつcom.cosminexus.admin.auth.keep_passwordにtrueを指定した場合に，統合ユーザ管理のセッションに保持したパスワードをセッションフェイルオーバの対象にするかどうかを指定します。

trueを指定した場合：

パスワードをグローバルセッションに保持します。

falseを指定した場合：

パスワードをグローバルセッションに保持しません。

セッションフェイルオーバをした場合，同一セッションの同一レルムにWebPasswordLDAPLoginModuleを使用してログインするとき，2回目以降はユーザIDとパスワードの入力が必要になります。
（指定例）
com.cosminexus.admin.auth.gsession.keep_password=true
<統合ユーザ管理のコンフィグレーションファイルで指定した値>

11.3　ua.conf（統合ユーザ管理のコンフィグレーションファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　リポジトリアクセス用パラメタ

(1)　形式

JAAS対応ユーザ管理，およびシングルサインオンの機能を使用するための設定ファイルです。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　リポジトリアクセス用パラメタ

JAAS対応ユーザ管理のリポジトリ（LDAPディレクトリサーバまたはデータベース）アクセスに関係する情報を定義します。ここで定義する内容は，ログインモジュールや各種コマンドでリポジトリにアクセスする場合に使用されます。

項目は設定番号（LDAP設定番号またはJDBC設定番号）を付加して複数定義できます。設定番号は0から始まり，順番に１ずつ加算していきます。もし，数字が飛んだ場合は，定義がそこで切れます。例えば，次に示す例の場合，0と1が定義されたものとみなされます（3は2が指定されていないため無視されます）。

（例）

java.naming.provider.url.0=ldap://localhost:389
java.naming.provider.url.1=ldap://localhost:389
java.naming.provider.url.3=ldap://localhost:389
#java.naming.probider.url.3の指定は無視されます。

なお，JNDI用とJDBC用の定義は別なので，それぞれ「0」から始めます。

(a)　JNDI用パラメタ

JNDIを使用してLDAPディレクトリサーバにアクセスする場合に定義する項目です。LDAPディレクトリサーバにアクセスするための設定は，LDAP設定番号を0から順に上げることで複数指定できます。

オプション
内容
デフォルト値

java.naming.provider.url
リポジトリ（LDAPディレクトリサーバ）のURLを，文字列で指定します。詳細については，JavaのJNDIの説明を参照してください。
なし

java.naming.security.principal
リポジトリ（LDAPディレクトリサーバ）にアクセスする際の認証者の識別子を，文字列で指定します。詳細については，JavaのJNDIの説明を参照してください。
なし

java.naming.security.credentials
java.naming.security.principal.nに対応するパスワードを，文字列で指定します。詳細については，JavaのJNDIの説明を参照してください。
なし

com.cosminexus.admin.auth.ldap.basedn
JAAS対応ユーザ管理でのリポジトリのベースDNを，文字列で指定します。
なし

com.cosminexus.admin.auth.ldap.attr.userid
ユーザのログインIDを表す属性名を，文字列で指定します。
uid

com.cosminexus.admin.auth.ldap.search.userrdn
JAAS対応ユーザ管理でのリポジトリのユーザエントリ（RDN）を検索する必要があるかどうかをtrueまたはfalseで指定します。ユーザのログインIDを表す属性名とユーザエントリ（RDN）が異なる場合は，trueを指定してください。大文字と小文字は区別されません。
false

com.cosminexus.admin.auth.ldap.search.scope
JAAS対応ユーザ管理でのリポジトリのユーザエントリ（RDN）を検索する必要がある場合，検索のレベルをonelevel（1階層下だけ検索）またはsubtree（すべての下層の検索）で指定します。大文字と小文字は区別されません。
onelevel

com.cosminexus.admin.auth.ldap.attr.password
ユーザのパスワードを表す属性名を，文字列で指定します。
userPassword

com.cosminexus.admin.auth.ldap.pool.enable
LDAP接続プールを利用するかどうかをtrueまたはfalseで指定します。大文字と小文字は区別されません。
false

com.cosminexus.admin.auth.ldap.pool.max
LDAP接続プールの最大数を指定します。最大数を超えて要求が来た場合は，プールが空くのを待ちます。0～2147483647の整数で指定します。0以下を指定した場合は，100を仮定します。
100

com.cosminexus.admin.auth.ldap.pool.max_spare
LDAP接続プールの空きプール数の最大値を指定します。一時的に，指定した最大値を超えることがありますが，com.cosminexus.admin.auth.ldap.pool.gc_intervalで指定した時間間隔で調整されます。0～2147483647の整数で指定します。
ここに指定する値がcom.cosminexus.admin.auth.ldap.pool.maxよりも大きい値の場合，com.cosminexus.admin.auth.ldap.pool.maxで指定した値を仮定します。0以下の値を指定した場合は，com.cosminexus.admin.auth.ldap.pool.maxの1/2を仮定します。com.cosminexus.admin.auth.ldap.pool.maxに奇数値が指定されていた場合は切り捨てられ，1の場合は１とします。
50

com.cosminexus.admin.auth.ldap.pool.min_spare
LDAP接続プールの空きプールの数が0になったとき（初期化時を含みます），新たに確立されるプール数を指定します。0～2147483647の整数で指定します。
ここに指定する値がcom.cosminexus.admin.auth.ldap.pool.max_spareよりも大きい値の場合，com.cosminexus.admin.auth.ldap.pool.max_spareで指定した値を仮定します。0以下の値を指定した場合は，com.cosminexus.admin.auth.ldap.pool.max_spareの1/2を仮定します。com.cosminexus.admin.auth.ldap.pool.max_spareに奇数値が指定されていた場合は切り捨てられ，1の場合は１とします。
10

com.cosminexus.admin.auth.ldap.pool.gc_interval
LDAP接続プールの空きプール数を調整する時間間隔を，0～2147483647の整数（単位：秒）で指定します。com.cosminexus.admin.auth.ldap.pool.max_spareの説明を参照してください。なお，0以下の値を指定した場合は，この機能は実行されません（com.cosminexus.admin.auth.ldap.pool.maxまで増えて削除されません）。
60

com.cosminexus.admin.auth.ldap.conn.retry.count
LDAP接続失敗時のリトライ回数を0～2147483647の整数で指定します。
1

com.cosminexus.admin.auth.ldap.conn.retry.wait
LDAP接続失敗時のリトライ間隔を0～2147483647の整数（単位：ミリ秒）で指定します。
0

com.cosminexus.admin.auth.ldap.certificate.attr.userid
証明書に格納されているDNを分解したあと，ユーザIDとして使用する属性名を，文字列で指定します。大文字と小文字は区別されません。ユーザIDを取り出すときに，同じ属性名が複数あった場合は，最初に見つかった値を使用します。
cn

com.cosminexus.admin.auth.ldap.password.encrypt
リポジトリに格納されているパスワードの形式を指定します。WebPasswordLoginModuleでは，ここで指定した形式でパスワードを比較します。

sha1：SHA-1形式

none：平文

md5：MD5形式

ここで指定する文字列は大文字と小文字は区別されません。また，上記以外の文字列を指定した場合はsha1を仮定します。com.cosminexus.admin.auth.ldap.password.encrypt.exを指定した場合，このパラメタは無視されます。
sha1

com.cosminexus.admin.auth.ldap.password.encrypt.ex
パスワードのフォーマットが標準で用意されているもの以外の形式の場合に，パスワードを変換するためのクラスを完全限定名で指定します。
このパラメタを省略した場合，または指定したが見つからない場合，
com.cosminexus.admin.auth.ldap.password.encryptで指定した形式でパスワードを比較します。
なし

com.cosminexus.admin.auth.ldap.directory.kind
接続するLDAPディレクトリサーバの種類を指定します。

AD：

Active Directoryを使用する場合に指定します。

ETC：

Active Directory以外のLDAPディレクトリサーバを使用する場合に指定します。

上記以外の値を指定した場合は，ETCが設定されます。
ETC

com.cosminexus.admin.auth.ldap.conn.read_timeout
LDAPディレクトリサーバとの読み込みタイムアウト時間を0～3600までの整数（単位：秒）で指定します。0を指定した場合はタイムアウトしません。
3

com.sun.jndi.ldap.connect.timeout
LDAPディレクトリサーバとの接続タイムアウトを0以上の整数（単位：ミリ秒）で指定します。0以下の整数を指定した場合は，TCPなどのネットワークプロトコルのタイムアウト値が使用されます。
LDAPプロバイダの仕様

(b)　JDBC用パラメタ

JDBCを使用してデータベースにアクセスする場合に定義する項目です。データベースと接続するための設定は，JDBC設定番号の値を0から順に上げることで複数指定できます。

オプション
内容
デフォルト値

com.cosminexus.admin.auth.jdbc.conn.url
データベースと接続するためのURLを，文字列で指定します。URLは次の形式で指定します。
（指定例）
jdbc:<subprotocol>:<subname>
なし

com.cosminexus.admin.auth.jdbc.conn.user
代理で接続するデータベースユーザを，文字列で指定します。省略した場合は，接続するデータベースユーザなしで接続します。
代理者なし

com.cosminexus.admin.auth.jdbc.conn.password
代理で接続するデータベースユーザのパスワードを指定します。com.cosminexus.admin.auth.jdbc.conn.userを省略した場合は無視されます。com.cosminexus.admin.auth.jdbc.conn.userを指定してこのパラメタを省略した場合は，空文字を仮定します。
<空文字>

com.cosminexus.admin.auth.jdbc.pool.enable
JDBC接続プールを利用するかどうかをtrueまたはfalseで指定します。大文字と小文字は区別されません。
false

com.cosminexus.admin.auth.jdbc.pool.max
JDBC接続プールの最大数を指定します。最大数を超えて要求が来た場合はプールが空くのを待ちます。0～2147483647の整数で指定します。0以下を指定した場合は100を仮定します。
100

com.cosminexus.admin.auth.jdbc.pool.max_spare
JDBC接続プールの空きプール数の最大値を指定します。一時的に，指定した最大値を超えることがありますが，com.cosminexus.admin.auth.jdbc.pool.gc_intervalで指定した時間間隔で調整されます。0～2147483647の整数で指定します。
ここで指定した値がcom.cosminexus.admin.auth.jdbc.pool.maxよりも大きい値の場合，com.cosminexus.admin.auth.jdbc.pool.maxで指定した値を仮定します。0以下を指定した場合はcom.cosminexus.admin.auth.jdbc.pool.maxの1/2を仮定します。com.cosminexus.admin.auth.jdbc.pool.maxに奇数値が指定されていた場合は切り捨てられ，1の場合は1とします。
50

com.cosminexus.admin.auth.jdbc.pool.min_spare
JDBC接続プールの空きプール数が0になったとき（初期化時も含みます），新たに確立されるプール数を指定します。0～2147483647の整数で指定します。ここで指定した値がcom.cosminexus.admin.auth.jdbc.pool.max_spareよりも大きい値の場合，com.cosminexus.admin.auth.jdbc.pool.max_spareで指定した値を仮定します。0以下を指定した場合はcom.cosminexus.admin.auth.jdbc.pool.max_spareの1/2を仮定します。com.cosminexus.admin.auth.jdbc.pool.max_spareに奇数値が指定されていた場合は切り捨てられ，1の場合は1とします。
10

com.cosminexus.admin.auth.jdbc.pool.gc_interval
JDBC接続プールの空きプール数を調整する時間間隔を0～2147483647の整数（単位：秒）で指定します。com.cosminexus.admin.auth.jdbc.pool.max_spareの説明を参照してください。0以下を指定した場合はこの機能は実行されません。com.cosminexus.admin.auth.jdbc.pool.maxの指定値まで増えて削除されません。
60

com.cosminexus.admin.auth.jdbc.conn.retry.count
JDBC接続失敗時のリトライ回数を，0～2147483647の整数で指定します。
1

com.cosminexus.admin.auth.jdbc.conn.retry.wait
JDBC接続失敗時のリトライ間隔を，0～2147483647の整数（単位：ミリ秒）で指定します。
0

com.cosminexus.admin.auth.jdbc.sql
パスワードを検索するためのSQLのSELECT文を指定します。SELECT文は次の形式で指定してください。
（指定形式）
SELECT　列名　FROM　表名　WHERE　検索条件
なお，検索条件には一つだけ’？’INパラメタプレースホルダーを含められます。この値は，認証時に指定されたユーザIDに置換されます。
なし

com.cosminexus.admin.auth.jdbc.password.type
パスワードが格納されている列の値の型を指定します。Java言語で扱う場合の型を，次に示す値で指定します。

string：
データベースからString型でパスワードの値を取り出します。SQLのデータ型はCHAR/VARCHAR/LONGVARCHARです。

byte：
データベースからbyte[]型でパスワードの値を取り出します。SQLのデータ型はVARBINARY/LONGVARBINARYです。

ここで指定するキーワードは大文字と小文字が区別されません。また，上記のキーワード以外を指定した場合はstringを仮定します。
string

com.cosminexus.admin.auth.jdbc.password.encrypt
リポジトリに格納されているパスワードの形式を指定します。WebPasswordLoginModuleでは，ここで指定した形式でパスワードを比較します。

sha1：SHA-1形式

none：平文

md5：MD5形式

ここで指定するキーワードは大文字と小文字が区別されません。また，上記のキーワード以外を指定した場合はnoneを仮定します。
com.cosminexus.admin.auth.jdbc.password.encrypt.exを指定した場合，このパラメタは無視されます。
このパラメタにsha1またはmd5を指定した場合は，com.cosminexus.admin.auth.jdbc.password.typeパラメタにbyteを指定してください。
none

com.cosminexus.admin.auth.jdbc.password.encrypt.ex
パスワードのフォーマットが標準で用意されているもの以外の形式の場合に，パスワードを変換するためのクラスを完全限定名で指定します。
このパラメタを省略した場合，または指定したが見つからない場合はcom.cosminexus.admin.auth.jdbc.password.encryptで指定した暗号化形式でパスワードを比較します。
なし

(c)　API用パラメタ

LDAPディレクトリサーバ上のユーザ情報リポジトリを参照または更新するAPIで使用する情報を定義する項目です。

項目には「.<name>」を付加します。「.<name>」はユーザ情報リポジトリを参照または更新するAPIを利用するときの識別子として定義します。ここで指定したnameはLdapUserDataManagerのコンストラクタで指定します。

nameの形式

<アプリケーションのJavaパッケージ名>.<内部名>

内部名：英数字（A～Z，a～z，0～9）またはピリオド（.）で構成される文字列

（例）

com.cosminexus.admin.auth.api.repository.ldap.config.<com.cosminexus.admin.auth.Example>=1

nameは値を変えることで複数定義できます。複数定義する場合，それぞれのnameはこのコンフィグレーションファイル内で一意になるようにしてください。また，nameは英数字列（A～Z，a～z，0～9）またはピリオド（.）で指定してください。これ以外の文字を使用した場合，誤認識されることがあります。

オプション | 内容 | デフォルト値
com.cosminexus.admin.auth.api.repository.ldap.config | APIで使用するLDAPディレクトリサーバの定義の識別子（JNDI用パラメタで指定したLDAP設定番号）を指定します。 | なし

(d)　シングルサインオン用パラメタ

シングルサインオン機能を利用する場合に必要な情報です。WebSSOLoginModuleが使用する項目と，カスタムログインモジュールを呼び出すための定義項目の，2種類の情報を指定する必要があります。このうち，カスタムログインモジュールを呼び出すための定義項目（com.cosminexus.admin.auth.sso.lm以後）には，.nameを付加します。nameはWebSSOLoginModuleから呼び出すログインモジュールの識別子です。

この「.name」を変えることで複数の値が指定できます。ここで指定した「.name」は，JAASのコンフィグレーションで使用されます。

形式

WebSSOLoginModuleが使用する項目=値

カスタムログインモジュールを呼び出すための定義項目.name=値

（例）

com.cosminexus.admin.auth.sso.keyfile=d:/tmp/DES3key.key

com.cosminexus.admin.auth.sso.lm.krb5=com.sun.security.module.Krb5LoginModule
com.cosminexus.admin.auth.sso.param.userid.Krb5=javax.security.auth.login.name
…

オプション
内容
デフォルト値

com.cosminexus.admin.auth.sso.keyfile
シングルサインオン用の情報を登録する際に暗号化するための鍵情報が格納されているファイル名を絶対パスで指定します。このファイルが指定されていない場合，シングルサインオン機能を利用してログインするときや，パスワードの変更機能（PasswordUtilクラス）で，LoginException例外が発生します。なお，com.cosminexus.admin.auth.sso.encrypt=noneの場合，ここで指定した値は無視されます。
なし

com.cosminexus.admin.auth.sso.encrypt
シングルサインオン用の認証情報（SecretData）を暗号化するために使用する製品を指定します。

KEYMATECRYPTO：05-00との互換性を保つための値です。この値を指定した場合，JCEが使用されます。

JCE：JCEを使用します。

NONE：暗号化機能を使用しません。

ここで指定するキーワードは大文字と小文字を区別しません。
NONE

com.cosminexus.admin.auth.sso.ldap.r
この項の先頭で定義したLDAP設定番号を指定します。指定する値は，シングルサインオン情報リポジトリを参照可能な設定を，識別する番号です。ここで指定された値は，WebSSOLoginModuleを利用したシングルサインオンをする場合などの，リポジトリの参照が必要な機能で使用されます。
0

com.cosminexus.admin.auth.sso.ldap.w
この項の先頭で定義したLDAP設定番号を指定します。指定する値は，シングルサインオン情報リポジトリを更新可能な設定を，識別する番号です。ここで指定された値は，パスワードの変更機能や，SSOExport/SSOImportコマンドなどのリポジトリの内容を管理するための機能で使用します。
0

com.cosminexus.admin.auth.sso.lm
WebSSOLoginModuleが呼び出す各アプリケーションのログインモジュール名（クラス名）を指定します。記述する場合は，フルパッケージで記述してください。
なし

com.cosminexus.admin.auth.sso.param.userid
シングルサインオン情報リポジトリに登録されているユーザIDを渡すためのパラメタ名を指定します。なお，ここで指定された値は，すでに認証済みの場合だけlogin()メソッドを呼び出す前にWebSSOLoginModuleが設定します。
com.cosminexus.admin.auth.sso.userid

com.cosminexus.admin.auth.sso.param.secdat
シングルサインオン情報リポジトリに登録されている暗号化された情報を渡すためのパラメタ名を指定します。ここで指定したパラメタ名のキー，およびキーに対する値は，login()メソッドを呼び出す前に，WebSSOLoginModuleによって設定されます。ただし，キーおよび値が設定されるのは，認証済みの場合だけです。また，値には，復号化されたデータが設定されます。
com.cosminexus.admin.auth.sso.secdat

com.cosminexus.admin.auth.sso.param.pubdat
シングルサインオン情報リポジトリに登録されている暗号化していない情報を渡すためのパラメタ名を指定します。なお，ここで指定された値は，認証済みの場合だけlogin()メソッドを呼び出す前にWebSSOLoginModuleが設定します。
com.cosminexus.admin.auth.sso.param.userid，com.cosminexus.admin.auth.sso.param.secdat，およびcom.cosminexus.admin.auth.sso.param.pubdatを指定する場合は，パラメタ名が重ならないように指定してください。もし，重なったパラメタを指定した場合，内容の保証はできません。
com.cosminexus.admin.auth.sso.pubdat

(e)　カスタムログインモジュールのパラメタ

DelegationLoginModuleまたはWebSSOLoginModuleからカスタムログインモジュールを呼び出すために必要な情報です。

オプション | 内容 | デフォルト値
com.cosminexus.admin.auth.custom.modules | カスタムログインモジュールおよびカスタムログインモジュールに関連するクラス（PrincipalやCredintialクラスなど）を格納したディレクトリを絶対パスで指定します。 | なし

(f)　Cosminexus標準ログインモジュールのパラメタ

Cosminexus標準ログインモジュール全体に関係する定義情報です。

オプション
内容
デフォルト値

com.cosminexus.admin.auth.keep_password
該当レルムにログインしたユーザのパスワードを統合ユーザ管理のセッションに保持するかどうかをtrueまたはfalseで指定します。大文字と小文字は区別されません。trueを指定した場合は保持します。falseを指定した場合は保持しません。なお，trueを指定しても，該当レルムですでにログインしている場合，すでに保持しているパスワードを上書きすることはありません。パスワードを保持しない場合，同一セッションの同一レルムに2回目以降WebPasswordLDAPLoginModuleを使用してログインするとき，ユーザIDとパスワードの入力が必要になります。
false

com.cosminexus.admin.auth.keep_password.encrypt
com.cosminexus.admin.auth.keep_passwordにtrueを指定した場合，パスワードを保持するときに暗号化するかどうかをtrueまたはfalseで指定します。大文字と小文字は区別されません。
trueを指定した場合はパスワードを暗号化します。
falseを指定した場合は暗号化しません。
true

com.cosminexus.admin.auth.param_check.enable
com.cosminexus.admin.auth.param_check.enableにtrueを指定した場合，次のCosminexus標準ログインモジュールを使用してログインユーザ名の前後に空白を入れてログインすると例外が発生します。

WebPasswordLoginModule

WebPasswordJDBCLoginModule

WebCertificateLoginModule

WebPasswordLDAPLoginModule

true

com.cosminexus.admin.auth.gsession.keep_password
統合ユーザ管理のセッションフェイルオーバ機能が有効な場合，かつ，com.cosminexus.admin.auth.keep_passwordにtrueを指定した場合に，統合ユーザ管理のセッションに保持したパスワードをセッションフェイルオーバの対象にするかどうかを指定します。

trueを指定した場合：

パスワードをグローバルセッションに保持します。

falseを指定した場合：

パスワードをグローバルセッションに保持しません。

セッションフェイルオーバをした場合，同一セッションの同一レルムにWebPasswordLDAPLoginModuleを使用してログインするとき，2回目以降はユーザIDとパスワードの入力が必要になります。
（指定例）
com.cosminexus.admin.auth.gsession.keep_password=true
false

(g)　そのほかのパラメタ

Cosminexus標準ログインモジュールによるユーザ管理全体に関係する定義情報としてトレースファイルがあります。

オプション
内容
デフォルト値

com.cosminexus.admin.auth.trace.prefix
フルパスを含んだトレースファイル名を指定します（拡張子は付けません）。ここに指定した値に”.n.log”という拡張子を付加して出力します（nは1～面数（最大16））。この指定がない場合は，トレースログは出力しません。
なし

com.cosminexus.admin.auth.trace.level
トレースレベルを数字で指定します。指定したレベル以内でトレース情報を出力します。

0：

ログインおよびログアウトで失敗した場合，トレースログを出力します。

5：

ログインおよびログアウトで成功した場合とタイムアウトした場合，トレースログを出力します。

0

com.cosminexus.admin.auth.trace.rotate
トレースファイル面数を，"1"から"16"までの数字で指定します。
4

com.cosminexus.admin.auth.trace.size
１トレースファイル当たりの最大サイズを，"4096"から"2147483647"の数字で指定します。
一つのログファイルのサイズがここで指定したサイズを超えた場合，ログは次の面番号の付いたログファイルに記録されます。最後のログファイル（面数の番号が付いたログファイル）のサイズが1ファイル当たりの最大サイズに達すると，面の番号1のログファイルへ上書きします。
65536

com.cosminexus.admin.auth.sfo.disable
セッションフェイルオーバ用フィルタが設定されていた場合，統合ユーザ管理のセッションフェイルオーバ対応機能を無効にします。

trueを指定した場合：

セッションフェイルオーバ対応機能を無効にします。

falseを指定した場合：

セッションフェイルオーバ対応機能を有効にします。

false

11.4　シングルサインオン用認証情報のCSV形式ファイル

シングルサインオン用の認証情報は，CSV形式ファイルを使用して作成します。CSV形式ファイルについて，次に示します。

＜この節の構成＞

11.4.1　CSV形式ファイルの基本仕様

11.4.2　ユーザ情報を取得するための定義ファイル

11.4.3　ユーザ情報を追加および変更するための定義ファイル

11.4.4　ユーザマッピングと認証情報の定義ファイル

11.4.5　CSV形式ファイルの記述例

11.4.6　ラインオペレーション

11.4.1　CSV形式ファイルの基本仕様

各項目の区切りには半角のコンマ（,）を使用します。また，レコードの区切りは改行です。

各項目は，ダブルクォーテーション（"）で囲んでも囲まなくてもコンマで区切られた文字列を1データとして扱います。ただし，項目にコンマを記述する場合は，項目全体をダブルクォーテーションで囲みます。

（例）RDN名に「ou=Cosminexus,o=Hitachi.」を指定する場合

...,"ou=Cosminexus,o=Hitachi",...

また，項目にダブルクォーテーションを記述する場合は，ダブルクォーテーションを2文字記述し，さらに項目全体をダブルクォーテーションで囲みます。

（例）Aliasに「pass"wd」を指定する場合

...,"pass""wd",...

なお，コンマ（,）の前後のスペースは各項目に含めます。

11.4.2　ユーザ情報を取得するための定義ファイル

＜この項の構成＞

(1)　CSV形式ファイルの追加仕様

(2)　指定方法

(1)　CSV形式ファイルの追加仕様

属性の一覧を指定するファイルのフォーマットでは，「11.4.1　CSV形式ファイルの基本仕様」で示した仕様に次の仕様が付加されます。

項目の指定順序は決められています。

コンマ（,）を続けて指定した場合は，その位置のオプションが省略されたものとします。

(2)　指定方法

改行までを1行として，1行ごとに次に示す項目をコンマで区切って指定します。

形式 | 項目
形式1 | #
形式2 | 属性名 | Alias | サブコンテキスト

形式1

注釈（コメント）を指定します。行の先頭（1カラム目）が”#”であれば行末までを注釈とみなします。

形式2

次の表に示す情報を1行で指定します。

表11-2　指定する情報（ユーザ情報を取得するための定義ファイル）

機能 | 意味 | 属性
属性名 | 英字で始まる，英字（ASCII文字），数字，ハイフンで指定します。英字は，大文字と小文字を区別しません。 | 必須
Alias | プログラムで参照するための名称を指定します。 | 任意
サブコンテキスト | 認証したユーザのエントリ以外のエントリの情報を取得する場合に，取得するエントリに対するユーザのエントリからのRDNを指定します。 | 任意

11.4.3　ユーザ情報を追加および変更するための定義ファイル

LDAPディレクトリサーバのエントリのオブジェクトクラスを指定するファイルです。

＜この項の構成＞

(1)　CSV形式ファイルの追加仕様

(2)　指定方法

(1)　CSV形式ファイルの追加仕様

属性の一覧を指定するファイルのフォーマットでは，「11.4.1　CSV形式ファイルの基本仕様」で示した仕様に次の仕様が付加されます。

項目の指定順序は決められています。

コンマ（,）を続けて指定した場合は，その位置のオプションが省略されたものとします。

(2)　指定方法

改行までを1行として，1行ごとに次に示す項目をコンマで区切って指定します。

形式 | 項目
形式1 | #
形式2 | サブコンテキスト | オブジェクトクラス[,オブジェクトクラス…]

形式1

注釈（コメント）を指定します。行の先頭（1カラム目）が”#”であれば行末までを注釈とみなします。

形式2

次の表に示す情報を1行で指定します。

表11-3　指定する情報（ユーザ情報を追加および変更するための定義ファイル）

機能 | 意味 | 属性
サブコンテキスト | 認証に使用するユーザエントリからのRDNを指定します。省略した場合は，ユーザエントリを仮定します。 | 任意
オブジェクトクラス | サブコンテキストのオブジェクトクラスを指定します。コンマで区切って複数指定できます。 | 必須

11.4.4　ユーザマッピングと認証情報の定義ファイル

＜この項の構成＞

(1)　CSV形式ファイルの追加仕様

(2)　指定方法

(3)　JAAS対応ユーザ管理を持つアプリケーションのユーザ定義

(1)　CSV形式ファイルの追加仕様

属性の一覧を指定するファイルのフォーマットでは，「11.4.1　CSV形式ファイルの基本仕様」で示した仕様に次の仕様が付加されます。

1行目にヘッダ情報，2行目以降に登録するデータの行となります。

各項目の内容はヘッダによって決まります。

コンマ（,）を続けて指定した場合は，その位置のオプションが省略されたものとします。

(2)　指定方法

1行目に指定する内容

次の表に示すヘッダ情報を指定します。各項目はASCII文字で入力し，半角のコンマ（,）で区切ります。項目IDの指定順序は任意です。

表11-4　指定するヘッダ情報（ユーザマッピングと認証情報の定義ファイル）

項目ID | 指定項目 | 指定内容 | 属性
REALMNAME | 登録者の識別子 | レルム名を指定します。ここで指定された名前の下にユーザエントリが作成されます。 | 必須
USERID | ユーザID | 必須
SECRETDATA | 認証情報 | 暗号化して保存するデータ | 任意
PUBLICDATA | 暗号化する必要のない保存データ | 任意
LINK_xxxx | 接続先システムのユーザ | ユーザ管理を持つアプリケーションのユーザ名を指定します（xxxxは各REALMNAMEを指定します）。 | 任意
OPERATION | 行に対するコマンド | ラインオペレーションを指定します。この指定は，一つのファイル内で，追加，変更，および削除を共用して指定できます。 | 任意

項目ID以外の名称が指定された場合は，その欄は無視されます。

LINK_xxxxはシングルサインオン情報リポジトリに登録されているレルムごとに作成される項目IDです。

2行目以降

実際に登録するデータを，半角のコンマ（,）で区切って指定します。

(3)　JAAS対応ユーザ管理を持つアプリケーションのユーザ定義

LINK_xxxx項目IDのxxxx部分に接続先のユーザ管理を持つアプリケーションを表すレルム名が表示されます。この項目欄にユーザIDを指定して接続先を定義します。ここに指定する内容は，次の操作で追加，変更できます。

追加

対象のLINK_xxxx項目に接続先のユーザ管理を持つアプリケーション（レルム）のユーザIDを記述します。

変更

対象のLINK_xxxx項目に接続先のユーザ管理を持つアプリケーション（レルム）のユーザIDに変更します。

解除

対象のLINK_xxxx項目からユーザIDを削除（何も記述しない）します。

11.4.5　CSV形式ファイルの記述例

例えば，レルム名が「Portal」のユーザ「taro」「hanako」「jirou」は，レルム名「RealmA」の「k010000」ユーザを使用します。レルム名「J2EE」のユーザ「hanako」は「Admin」ユーザを，ユーザ「jirou」は「DBMgr」ユーザを使用するとします。この場合，CSV形式ファイルは次のようになります（この例では，ユーザIDとパスワードは同じものであると仮定しています）。

REALMNAME | USERID | SECRETDATA | PUBLICDATA | LINK_J2EE | LINK_REALMA
Portal | taro | taro | developer |  | k010000
Portal | hanako | hanako |  | Admin | k010000
Portal | jirou | jirou |  | DBMgr | k010000
RealmA | k010000 | k010000 |  |  |
J2EE | Admin | Admin |  |  |
J2EE | DBMgr | DBMgr |  |  |

記述例

REALMNAME,USERID,SECRETDATA,PUBLICDATA,LINK_J2EE,LINK_REALMA
Portal,taro,taro,developer,,k010000
Portal,hanako,hanako,,Admin,k010000
Portal,jirou,jirou,,DBMgr,k010000
RealmA,k010000,k010000,,,
J2EE,Admin,Admin,,,
J2EE,DBMgr,DBMgr,,,

11.4.6　ラインオペレーション

ラインオペレーションとはCSV形式ファイルの項目”OPERATION”の項目に指定された値に従ってシングルサインオン情報リポジトリに行を登録，変更，および削除する機能です。項目”OPERATION”は管理者が任意に挿入できますが，有効にしたい場合は必ずssoimportコマンドに-xオプションを指定しなければなりません。また，-xオプションを-a,-m,-dオプションと併用することはできません。

項目”OPERATION”に指定できるオペレーションと用途を次の表に示します。

表11-5　項目”OPERATION”に指定できるオペレーションと用途

オペレーション | 用途
Aまたはa | 指定した行の内容をシングルサインオン情報リポジトリに追加します。もし，シングルサインオン情報リポジトリ内にユーザエントリがある場合は，警告メッセージを出力して処理を継続します。
Mまたはm | 指定した行の内容にシングルサインオン情報リポジトリを上書きします。もし，シングルサインオン情報リポジトリ内にユーザエントリがない場合は，ユーザエントリを追加します。
Dまたはd | 指定した行の内容をシングルサインオン情報リポジトリから削除します。もし，シングルサインオン情報リポジトリ内にユーザエントリがない場合は，警告メッセージを出力して処理を継続します。

注

オペレーションは大文字と小文字の制限はありません。また，オペレーション前後の空文字は無視されますが，タブは使用できません。

オペレーション欄に，A，a，M，m，D，およびd以外が指定された場合は，Warningが発生し該当する行はスキップされます。このような場合は，適切なオペレーションが指定されているかを確認し再度登録処理をする必要があります。

項目”OPERATION”を追加した場合のCSV形式ファイルを次に示します。

OPERATION | REALMNAME | USERID | SECRETDATA | PUBLICDATA | LINK_J2EE
A | Portal | taro | taro | developer |
D | Portal | hanako | hanako |  | Admin
M | Portal | jirou | jirou |  | DBMgr
| RealmA | k010000 | k010000 |  |
M | J2EE | Admin | Admin |  |

記述例

OPERATION,REALMNAME,USERID,SECRETDATA,PUBLICDATA,LINK_J2EE
A,Portal,taro,taro,developer,
D,Portal,hanako,hanako,,Admin
M,Portal,jirou,jirou,,DBMgr
,RealmA,k010000,k010000,,
M,J2EE,Admin,Admin,,

12.　Javaアプリケーションで使用するファイル

この章では，Javaアプリケーションで使用するファイルの形式，機能，指定できるキーなどについて説明します。

＜この章の構成＞

12.1　Javaアプリケーションで使用するファイルの一覧

12.2　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）

12.3　usrconf.properties（Javaアプリケーション用ユーザプロパティファイル）

12.4　Javaアプリケーションに指定するシステムプロパティ

12.5　Javaアプリケーションのユーザログ用プロパティ設定ファイル

12.1　Javaアプリケーションで使用するファイルの一覧

Javaアプリケーションで使用するファイルの一覧を次の表に示します。

表12-1　Javaアプリケーションで使用するファイルの一覧

ファイル名
分類
概要
参照先

usrconf.cfg
Javaアプリケーション用オプション定義ファイル
Javaアプリケーションを実行するJavaVMの起動オプションを指定します。
Javaアプリケーションをcjclstartapコマンドで開始する場合に使用します。
12.2

usrconf.properties
Javaアプリケーション用ユーザプロパティファイル
Javaアプリケーションを実行するJavaVMのシステムプロパティを指定します。
Javaアプリケーションをcjclstartapコマンドで開始する場合に使用します。
12.3

（任意）※
Javaアプリケーションに指定するシステムプロパティ
Javaアプリケーションを実行するJavaVMのシステムプロパティを指定します。
vbjコマンドでJavaアプリケーションを開始する場合に，コマンドの引数としてバッチファイルまたはシェルスクリプトに指定します。
12.4

（任意）
Javaアプリケーションのユーザログ用プロパティ設定ファイル
Javaアプリケーションのユーザログで使用します。
vbjコマンドでJavaアプリケーションを開始する場合に使用します。
12.5

注※

Javaアプリケーションの開始に使用するコマンド（vbjコマンド）ごとに，必要なシステムプロパティを指定します。システムプロパティの指定は，JavaアプリケーションからのEnterprise Bean呼び出しの場合に必要です。WebコンテナサーバからEnterprise Beanを呼び出す場合は，「15.4　usrconf.properties（Webコンテナサーバ用ユーザプロパティファイル）」を参照して，Enterprise Beanを呼び出す場合に必要なプロパティをカスタマイズしてください。

Javaアプリケーションを開始するには，次のどれかのコマンドを使用します。

cjclstartapコマンド
通常使用するコマンドです。コマンドの格納場所を次に示します。

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥client¥bin¥cjclstartap

UNIXの場合
/opt/Cosminexus/CC/client/bin/cjclstartap

vbjコマンド
すでにこのコマンドを使用しているユーザ向けの互換用コマンドです。コマンドの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥TPB¥bin¥vbj

UNIXの場合
/opt/Cosminexus/TPB/bin/vbj

12.2　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

値にスペースを含むパスを指定する場合，パスをダブルクォーテーション（”）で囲む必要はありません。

実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

(2)　ファイルの格納先

Windowsの場合
<ユーザ定義ファイル格納ディレクトリ>※¥usrconf.cfg

UNIXの場合
<ユーザ定義ファイル格納ディレクトリ>※/usrconf.cfg

注※

ユーザ定義ファイル格納先環境変数（CJCLUSRCONFDIR）で指定したディレクトリです。cjclstartapコマンドを実行する前に，必ずこの環境変数を指定してください。EJBクライアントアプリケーションの環境変数の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(3)　機能

cjclstartapコマンドを使用する場合に，Javaアプリケーションを実行するJavaVMの起動オプションを指定します。

Javaアプリケーションを実行中に，このファイルの内容を変更した場合，変更した内容は，次回Javaアプリケーションを起動したときに反映されます。

(4)　指定できるキー

指定できるキーとデフォルト値を次に示します。このキーに不正な値を指定した場合は，動作は保証されません。

ポイント

ここでは，次の内容について説明します。

Javaアプリケーション用usrconf.cfgファイルで指定できるキーの概要
指定できるキーのうち，J2EEサーバ用usrconf.cfgファイルと共通のキーについては，ここでは詳細を説明しません。
共通のキーの詳細については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。参照する場合には，「J2EEサーバ」を「Javaアプリケーション」と読み替えてください。
なお，J2EEサーバ用のキーと指定内容が異なる場合には，ここでキーの詳細について説明します。

J2EEサーバ用のキーとの差異（J2EEサーバ用usrconf.cfgファイルのキーと指定内容が異なる場合）
Javaアプリケーション用のキーとJ2EEサーバ用のキーの指定内容が異なる場合には，キーの詳細について説明します。

表12-2　usrconf.cfgに指定できるキーとデフォルト値（Javaアプリケーション）

キー名称
J2EEサーバ用usrconf.cfgファイルとの差異
内容
デフォルト値

add.jvm.arg
なし
指定されたオプションを使ってJavaVMを起動します。
なし

add.class.path
あり
コンテナ拡張ライブラリ用のJARを指定します。
EJBアプリケーションごとの実行に必要なクラスパス（stubs.jar，<数字>.jar，<ユーザクラス>.jar）を指定します。
－

add.library.path
なし
JNI用の共有ライブラリを指定します。
－

cpp.library.version
なし
プロセス内で使用するlibstdc++ライブラリのバージョンを指定します。
5

ejb.client.directory.shareable
独自
同じカレントディレクトリまたは，同じログ出力先ディレクトリを使用する複数のcjclstartapコマンドを同時に起動するかどうかを指定します。

trueを指定した場合：

同時に起動します。

falseを指定した場合：

同時に起動しません。

true

ejb.client.ejb.log
独自
ejb.client.log.directoryキーに指定したディレクトリの下の，Javaアプリケーションが出力するメッセージのログ出力先のディレクトリ名を，1～16バイトで指定します。
指定できる文字は，半角英数字，アンダースコア（_），およびハイフン（-）です。
16バイトを超える文字列を指定した場合，KDJE40051-Wのメッセージが出力されます。
ディレクトリにアクセス権がない場合や，ファイル名を指定した場合は，KDJE40052-Eのメッセージが出力され，Javaアプリケーションが終了します。
ユーザプロパティファイル（usrconf.properties）にejbserver.client.ejb.logを指定した場合，次のログファイルの出力先はユーザプロパティファイルの指定が優先されます。

稼働ログ

障害発生時の例外情報

保守情報

system

ejb.client.log.appid
独自
Javaアプリケーションが出力するメッセージのログ出力先のサブディレクトリ名を1～16バイトで指定します。
指定できる文字は，半角英数字，アンダースコア（_），およびハイフン（-）です。
16バイトを超える文字列を指定した場合，KDJE40051-Wのメッセージが出力されます。
ディレクトリにアクセス権がない場合や，ファイル名を指定した場合は，KDJE40052-Eのメッセージが出力され，Javaアプリケーションが終了します。
ユーザプロパティファイル（usrconf.properties）にejbserver.client.log.appidを指定した場合，次のログファイルの出力先はユーザプロパティファイルの指定が優先されます。

稼働ログ

障害発生時の例外情報

保守情報

ejbcl

ejb.client.log.directory
独自
Javaアプリケーションのログ出力先のパスを1～180バイトの範囲で指定します。
パスは絶対パスまたはカレントディレクトからの相対パスで指定します。
指定できる文字は，半角英数字，アンダースコア（_），ハイフン（-）およびパス区切り文字です。
180バイトを超えるパス（相対パスを指定したときは，カレントディレクトリまでの絶対パスと相対パスの合計）を指定した場合，KDJE40059-Wのメッセージが出力され，デフォルト値が使用されます。デフォルト値が180バイトを超える場合は，ログの初期化に失敗し，異常終了します。
Windowsの場合，UNC名を含むパスは指定できません。UNIXの場合，nfsマウントされたディスク上へのパスは指定できません。
ディレクトリにアクセス権がない場合や，ファイル名を指定した場合は，KDJE40052-Eのメッセージが出力され，Javaアプリケーションが終了します。
ユーザプロパティファイル（usrconf.properties）にejbserver.client.log.directoryを指定した場合，次のログファイルの出力先はユーザプロパティファイルの指定が優先されます。

稼働ログ

ログ稼働ログ

障害発生時の例外情報

保守情報

カレントディレクトリ/logs

ejb.client.log.stdout.enabled
独自
標準出力へメッセージを出力するかどうかを指定します。

true：

標準出力へ出力します。

false：

標準出力へ出力しません。

標準出力へのメッセージ出力を制御できるログは次のとおりです。

稼働ログ

cjclstartapコマンドログ

起動プロセス標準出力情報

true

jvm.type
独自
使用するJavaVMのタイプを設定します。指定できる値は次のどちらかです。

client
Java HotSpot(TM) Client VMが使用されます。

server
Java HotSpot(TM) Server VMが使用されます。

指定値に誤りがあった場合は，”client”，”server”の順でJavaVMを検索します。なお，このときKDJE40020-Wメッセージが出力されます。
AIX，およびSolarisの場合は，”server”を指定しても”client”になります。
client

（凡例）

あり：

Javaアプリケーション用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Javaアプリケーション用usrconf.cfgファイルとJ2EEサーバ用usrconf.cfgファイルで共通のキー，またはデフォルト値です。キーの詳細については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

独自：

Javaアプリケーション用usrconf.cfgファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Javaアプリケーション用usrconf.cfgファイルとJ2EEサーバ用usrconf.cfgファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

(5)　記述例

# EJB client application classpath
# RMI-IIOP Stubs jar file
add.class.path=<Javaアプリケーション格納パス>¥stubs.jar

# RMI-IIOP interface jar file
add.class.path=<Javaアプリケーション格納パス>¥1.jar

# User class
add.class.path=<Javaアプリケーション格納パス>¥<Javaアプリケーションjar>
#add.class.path=<User classpath>

# java vm options
add.jvm.arg=-Xms256m
add.jvm.arg=-Xmx512m

(6)　注意事項

OSのロケールと異なる文字エンコーディングで記述しないでください。また，OSのロケールにUTF-8を使用する場合，BOM付きUTF-8では記述しないでください。

usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は，usrconf.propertiesの値が優先されます。

12.3　usrconf.properties（Javaアプリケーション用ユーザプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　Javaアプリケーションのカスタマイズ用キー

(5)　記述例

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

記載する文字はJavaの仕様に従って，ISO 8859-1 文字エンコーディングを使用してください。

(2)　ファイルの格納先

Windowsの場合
<ユーザ定義ファイル格納ディレクトリ※>¥usrconf.properties

UNIXの場合
<ユーザ定義ファイル格納ディレクトリ※>/usrconf.properties

注※

ユーザ定義ファイル格納先環境変数（CJCLUSRCONFDIR）で指定したディレクトリです。cjclstartapコマンドを実行する前に，必ずこの環境変数を設定してください。EJBクライアントアプリケーションの環境変数の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(3)　機能

cjclstartapコマンドを使用する場合に，Javaアプリケーションを実行するJavaVMのシステムプロパティを指定します。

usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は，usrconf.propertiesの値が優先されます。

なお，日立のJavaVMは，J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。JDK 5.0で使用できるプロパティについては，Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

Javaアプリケーションを実行中に，このファイルの内容を変更した場合，変更した内容は，次回Javaアプリケーションを起動したときに反映されます。

(4)　Javaアプリケーションのカスタマイズ用キー

Javaアプリケーションの開始コマンドでは，次に示すシステムプロパティのキーに値を設定することで，Javaアプリケーションの動作をカスタマイズできます。

ここでは，キーを次の分類に分けて説明します。

ejbserver.applicationから始まるキー

ejbserver.clientから始まるキー

ejbserver.containerから始まるキー

ejbserver.distributedtxから始まるキー

ejbserver.jndiから始まるキー

ejbserver.jtaから始まるキー

ejbserver.loggerから始まるキー

ejbserver.rmiから始まるキー

ejbserver.securityから始まるキー

ejbserver.serverから始まるキー

javaから始まるキー

orgから始まるキー

vbroker.orbから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるキーを次の表に示します。

注意

ここでは，次の内容について説明します。

Javaアプリケーション用usrconf.propertiesファイルで指定できるキーの概要
指定できるキーのうち，J2EEサーバ用usrconf.propertiesファイルと共通のキーについては，ここでは詳細を説明しません。
共通のキーの詳細については，「2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。Javaアプリケーションの場合には，「J2EEサーバ」を「Javaアプリケーション」と読み替えてください。
なお，J2EEサーバ用のキーと指定内容が異なる場合には，ここでキーの詳細についても説明します。

J2EEサーバ用のキーとの差異（J2EEサーバ用usrconf.propertiesファイルのキーと指定内容が異なる場合）
Javaアプリケーション用のキーとJ2EEサーバ用のキーの指定内容が異なる場合には，キーの詳細について説明します。差異に関する記述が特にない場合には，J2EEサーバ用usrconf.propertiesファイルのキーと同じ内容を指定してください。

Javaアプリケーション用usrconf.propertiesファイル独自のキーの詳細
Javaアプリケーション用usrconf.propertiesファイル独自のキーについては，ここでキーの詳細を説明します。

(a)　ejbserver.applicationから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.applicationから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(a)　ejbserver.applicationから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.appname
なし
AppNameのフィールドに出力するデフォルトのアプリケーション名を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.autoFlush.enabled
独自
メッセージ出力後にflushをするかどうかを指定します。

trueを指定した場合：

メッセージごとにflushをします。

falseを指定した場合：

flushをしません。

CJMPMessageFileHandlerを使用しない場合，指定は不要です。また，アプリケーションプログラムで明示的にjava.util.logging.Handler.flush()を呼び出している場合には，trueを指定しないでください。
false

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.count
なし
ログファイルの面数を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.encoding
なし
出力する文字列のエンコーディングを指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.filter
なし
使用するフィルタを，パッケージ名を含むフルネームで指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.formatter
なし
使用するフォーマッタを，パッケージ名を含むフルネームで指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.level
なし
ログの取得レベルの上限を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.limit
なし
ログファイルの容量を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.msgid
なし
MsgIDのフィールドに出力するデフォルトのメッセージIDを指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.path
あり
ログファイル名のプリフィックスを1～255バイトの範囲で指定します。パスは，相対パスで指定します。なお，パス名の終端に，半角数値を指定しないでください。
ここで指定したプリフィックスに"xx（1～16の整数）.log"が付加された値が，トレース情報ファイルの名称になります。
パスに指定された半角英文字の大文字と小文字は区別されません。また，パス値の長さは，次のA+B+C値の合計が値の範囲に収まるよう指定してください。

A（Windowsの場合）：<ログ出力先ルート(ejbserver.client.log.directoryの値)>¥user¥（デフォルトは<Cosminexusインストールディレクトリ>¥CC¥client¥logs¥user¥）

A（UNIXの場合）：<ログ出力先ルート(ejbserver.client.log.directoryの値)>/user/（デフォルトは/opt/Cosminexus/CC/client/logs/user/）

B：ユーザの指定したプリフィックスの長さ

C："xx.log"の6文字

このほか，パスを指定するときには次の点に注意してください。

Propertiesファイルにはnativeの2バイトコードなどは使用できないため，native2asciiなどを利用してUnicodeの文字列を取得して指定してください。

絶対パスで指定しないでください。また，相対パスの"..¥"（UNIXの場合，"../"）は使用しないでください。

パスに日本語文字などを含む場合は，その文字を処理できるロケール設定がされている環境下でJavaVMが動作している必要があります。

パスをほかのハンドラと同一に設定することはできません。そのような設定にした場合，そのハンドラは作成されません。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.separator
なし
CJSimpleFormatterを利用して，1文でメッセージを出力するためのセパレータを指定します。
－

ejbserver.application.userlog.loggers
なし
使用するロガーの名称を宣言します。
－

ejbserver.application.userlog.Logger.<ロガー名称>※2.filter
なし
ロガーで使用するフィルタを，パッケージ名を含むフルネームで指定します。
－

ejbserver.application.userlog.Logger.<ロガー名称>※2.handlers
なし
指定のロガー名称に対して，ハンドラクラスを指定します。
－

ejbserver.application.userlog.Logger.<ロガー名称>※2.level
なし
ロガーのログ出力レベルを指定します。
－

ejbserver.application.userlog.Logger.<ロガー名称>※2.useParentHandlers
なし
ログレコードを受け取ったロガーから，親ロガーの接続しているハンドラへログレコードを伝播させるかどうかを指定します。
－

（凡例）

あり：

Javaアプリケーション用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(a)　ejbserver.applicationから始まるキー」を参照してください。

独自：

Javaアプリケーション用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(a)　ejbserver.applicationから始まるキー」を参照してください。

注※1

ハンドラ名称はプロパティの値を区別するために使用します。半角英数字で始まる1～1024バイトのクラス文字セットで指定してください。"default"を指定した場合は，すべてのCJLogHandlerが共通のデフォルト値として認識するプロパティを示します。

注※2

ロガー名称は，Logger.getLogger（<ロガー名称>）でロガーのインスタンスを取得するときに指定する"."付きの名称で，あらかじめ，ejbserver.application.userlog.loggersプロパティで宣言する必要があります。ロガー名称については，java.util.logging.Loggerの仕様に従ってください。

半角英数字で始まる1～1024バイトのクラス文字セットで指定してください。"default"を指定した場合は，すべてのCJLogHandlerが共通のデフォルト値として認識するプロパティを示します。

なお，ロガー名称で識別されるプロパティは，ユーザログ機能のロガークラスの初期化で使用されます。

ロガー名称の最後を.handlersで終了させた場合，ejbserver.application.userlog.Logger.<ロガー名称>.handlersのプロパティ指定時に紛らわしくなるため，ロガー名称は".handlers"で終了させないことを推奨します。

(b)　ejbserver.clientから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.clientから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(b)　ejbserver.clientから始まるキー」を参照してください。

なお，uCosminexus Clientを使用する場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCL」と読み替えてください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.client.ctm.RequestPriority
なし
CTM内のキューに滞留したリクエストを引き出す時のプライオリティ（優先順位）を指定します。
－

ejbserver.client.ejb.log
独自
ejbserver.client.log.directoryキーに指定したディレクトリの下のJavaアプリケーションが出力するメッセージのログ出力先のディレクトリ名を1～16バイトの範囲で指定します。指定できる文字は，半角英数字，アンダースコア（_），およびハイフン（-）だけです。ディレクトリのパス区切り文字には，スラッシュ（/）を使用してください。複数のJavaアプリケーションを使用する場合は，EJBアプリケーションごとに，ログ出力先を指定してください。
アクセス権がないディレクトリまたはファイル名を指定した場合は，KDJE51003-Eのメッセージが標準出力とcjlogger.logファイルに出力され，Javaアプリケーションが終了します。

サブディレクトリ専有モードの場合
ejb

サブディレクトリ共有モードの場合
なし

ejbserver.client.log.appid
独自
Javaアプリケーションのログ出力先のサブディレクトリ名を1～16バイトで指定します。
指定できる文字は，半角英数字，アンダースコア（_），およびハイフン（-）だけです。このキーを指定した場合は，毎回同じサブディレクトリが使用されるため，サブディレクトリの削除はされません。一つのJavaアプリケーションを複数起動しない場合に使用すると，専用のサブディレクトリでログファイルを管理できます。複数同時に起動する場合，このキーは指定しないでください。
16バイトを超える文字列を指定した場合は，KDJE51002-Wのメッセージがcjlogger.logファイルに出力され，通常値が使用されます。
サブディレクトリ専有モードの通常値として使用されるEJBクライアントアプリケーション識別IDには，vbjコマンドの場合，Javaアプリケーションの開始時刻とプロセスIDが使用されます。

サブディレクトリ専有モードの場合
<EJBクライアントアプリケーション識別ID>

サブディレクトリ共有モードの場合
なし

ejbserver.client.log.directory
独自
Javaアプリケーションのログ出力先の絶対パスを1～200バイトで指定します。
指定できる文字は，半角英数字，アンダースコア（_），ハイフン（-），およびスペース（ ）だけです。なお，スペースを指定できるのはWindowsの場合だけです。空白文字※を含むディレクトリを指定する場合は，パス名を引用符で囲んでください。例えば，C:¥logs¥ejb clientを設定する場合は，次のように指定します。

ejbserver.client.log.directory="C:¥logs¥ejb client"

200バイトを超えるパスを指定した場合はKDJE51001-Wのメッセージ，指定がない場合はKDJE51002-Wのメッセージがcjlogger.logファイルに出力され，通常値が使用されます。
ディレクトリにアクセス権がない場合や，ファイル名を指定した場合は，KDJE51003-Eのメッセージが標準出力とcjlogger.logファイルに出力され，Javaアプリケーションが終了します。
通常値を使用する場合で，Cosminexus Developer's Kit for Java以外のJavaを使用してJavaアプリケーションを起動した場合は，KDJE51004-Wのメッセージがcjlogger.logファイルに出力され，Javaアプリケーション実行ディレクトリが使用されます。
Windowsの場合，UNC名を含むパスは指定できません。UNIXの場合，nfsマウントされたディスク上へのパスは指定できません。
なし

ejbserver.client.log.directorynum
独自
Javaアプリケーションのログ出力先のサブディレクトリ数を，1～16の整数値で指定します。
指定したサブディレクトリ数を超えた場合は，いちばん古いclient_process_endファイルがあるサブディレクトリが削除されます。なお，0を指定した場合，サブディレクトリ数は無制限になり，サブディレクトリは削除されません。ejbserver.client.log.directoryに通常値のディレクトリを使用する場合は，このキーを指定しないでください。指定がない場合や0～16以外の値を指定した場合は，KDJE51002-Wのメッセージがcjlogger.logファイルに出力され，通常値が使用されます。
Javaアプリケーションを同時に17個以上起動する場合は，このキーには0を指定してください。この場合，サブディレクトリの管理にはcjcldellogコマンドを使用してください。
また，複数のJavaアプリケーションを同時に起動する場合，KDJE51005-Wのメッセージが頻繁に出力されるときには，サブディレクトリ数がこのキー値を超えていることがあります。この場合，このキーに0を指定して，cjcldellogコマンドを使用してサブディレクトリを管理してください。なお，このメッセージが出力される場合も，Javaアプリケーションは問題なく動作します。
cjcldellogコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。
なお，次の場合，このキーの指定は無効になります。
ejbserver.client.log.appidキーを指定した場合
サブディレクトリ共有モードの場合
なし

ejbserver.client.log.lockInterval
独自
ログファイルの排他処理に失敗したときのリトライ間隔（単位：ミリ秒）を0～2147483647の整数値で指定します。範囲外の値や整数値以外を指定した場合は，KDJE51002-Wのメッセージがcjlogger.logファイルに出力されて，デフォルト値が使用されます。サブディレクトリ共有モードで動作するJavaアプリケーションがcjlogger.logファイルにKDJE90002-Eメッセージを出力して終了する場合に使用します。このプロパティは，サブディレクトリ共有モードで有効です。サブディレクトリ専有モードの場合は無視されます。
10

ejbserver.client.log.lockRetryCount
独自
ログファイルの排他処理に失敗したときのリトライ回数（単位：回）を0～2147483647の整数値で指定します。範囲外の値や整数値以外を指定した場合は，KDJE51002-Wのメッセージをcjlogger.logファイルに出力して，デフォルト値を使用します。サブディレクトリ共有モードで動作するJavaアプリケーションがcjlogger.logファイルにKDJE90002-Eメッセージを出力して終了する場合に使用します。このプロパティは，サブディレクトリ共有モードで有効です。サブディレクトリ専有モードの場合は無視されます。
1000

ejbserver.client.transaction.clientName
独自
トランザクションサービスが使用するクライアント名を1～128文字の文字列で指定します。使用できる文字は，半角英数字（0～9，A～Z，a～z），アンダースコア（_）またはハイフン（-）です。
ここに設定するクライアント名は，Javaアプリケーションのプロセスごとに別の名前を設定する必要があります。
また，同一マシン上で動作するJ2EEサーバ名とは別の名前にする必要があります。
なし

ejbserver.client.transaction.enabled
独自
Javaアプリケーションでトランザクションを使用するかどうかを指定します。

trueを指定した場合：

トランザクションを使用できます。

falseを指定した場合：

トランザクションを使用できません。

false

（凡例）

なし：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(b)　ejbserver.clientから始まるキー」を参照してください。

独自：

Javaアプリケーション用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(b)　ejbserver.clientから始まるキー」を参照してください。

注※

空白文字とは，半角スペース，タブ，LF（0x0a），CR（0x0d）またはFF（0x0c）のことを指します。

(c)　ejbserver.containerから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.containerから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(f)　ejbserver.containerから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
ejbserver.container.rebindpolicy | なし | EJBメソッドの呼び出し時に通信障害が発生した場合の，EJBクライアント側でのコネクションの再接続動作とリクエストの再送動作を指定します。 | －

（凡例）

なし：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(f)　ejbserver.containerから始まるキー」を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(f)　ejbserver.containerから始まるキー」を参照してください。

(d)　ejbserver.distributedtxから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.distributedtxから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(i)　ejbserver.distributedtxから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.distributedtx.ots.status.directory1
あり
インプロセストランザクションサービスのステータスファイル，および保守資料としてのステータスファイルのバックアップを格納するディレクトリを指定します。パス区切り文字は”/”を使用してください。
アプリケーションサーバで相対パスを指定した場合，次のディレクトリからのパスとなります。

Windowsの場合
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>

Javaアプリケーションで相対パスを指定した場合，Javaアプリケーションの実行ディレクトリからのパスとなります。
同一マシン内で稼働するほかのJ2EEサーバや，ほかのJavaアプリケーションプロセスと重ならないように，別のディレクトリを指定する必要があります。
なし

ejbserver.distributedtx.ots.status.directory2
なし
インプロセストランザクションサービスのステータスファイルを二重化する場合，予備ステータスファイルおよび保守資料としての予備ステータスファイルのバックアップを格納するディレクトリを指定します。
－

ejbserver.distributedtx.recovery.port
あり
トランザクションリカバリで使用する固定ポート番号を1～65535の整数値で指定します。無効な値を指定した場合や指定したポートがすでに使用されていた場合には，初期化処理がエラーとなります。
なし

（凡例）

あり：

Javaアプリケーション用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(i)　ejbserver.distributedtxから始まるキー」を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(i)　ejbserver.distributedtxから始まるキー」を参照してください。

(e)　ejbserver.jndiから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.jndiから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(p)　ejbserver.jndiから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.jndi.cache
あり
分散オブジェクトのキャッシングをするかどうかを指定します。

キャッシングをする場合：

onを指定します。

キャッシングをしない場合：

offを指定します。

また，javax.rmi.CORBA.PortableRemoteObjectClassキーにcom.hitachi.software.ejb.rmi.PortableRemoteObjectを，javax.rmi.CORBA.UtilClassキーにcom.hitachi.software.ejb.rmi.Utilを指定する必要があります。
off

ejbserver.jndi.cache.interval
あり
分散オブジェクトのキャッシングをする場合，キャッシュをクリアする間隔（単位：秒）を0～2147483647の整数値で指定します。ただし，1～2147483647以外の値を指定した場合，クリアしません。また，javax.rmi.CORBA.PortableRemoteObjectClassキーにcom.hitachi.software.ejb.rmi.PortableRemoteObjectを，javax.rmi.CORBA.UtilClassキーにcom.hitachi.software.ejb.rmi.Utilを指定する必要があります。
－

ejbserver.jndi.cache.interval.clear.option
なし
インターバル経過後のネーミングでのキャッシュ領域に対する動作を決定します。
－

ejbserver.jndi.namingservice.group.list
なし
ラウンドロビン検索をする場合に，検索対象になる論理ネーミングサービスのグループを定義します。
－

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls
なし
各グループに属するネーミングサービスのルート位置を指定します。
－

ejbserver.jndi.request.timeout
なし
ネーミングサービスとの通信タイムアウト時間を指定します。
－

（凡例）

あり：

Javaアプリケーション用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(p)　ejbserver.jndiから始まるキー」を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(p)　ejbserver.jndiから始まるキー」を参照してください。

(f)　ejbserver.jtaから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.jtaから始まるキーを次に示します。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.jta.TransactionManager.defaultTimeOut
あり
Javaアプリケーションで開始されるトランザクションのトランザクションタイムアウトのデフォルト値（単位：秒）を次の範囲で指定します。

1.4モードの場合：

1～2147483647

ベーシックモードの場合：

1～2000000

－

（凡例）

あり：

Javaアプリケーション用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(q)　ejbserver.jtaから始まるキー」を参照してください。

(g)　ejbserver.loggerから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.loggerから始まるキーを次に示します。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.logger.channels.define.<チャネル名>※.filenum
あり
Javaアプリケーションのログファイルの面数を指定します。

サブディレクトリ専有モードの場合：

1～16の整数値で指定します。

サブディレクトリ共有モードの場合：

1～64の整数値で指定します。

面数を変更する場合は，該当するログファイルに出力しているプロセスをすべて停止し，ログファイルとmmapディレクトリ以下のログ管理ファイルを別のディレクトリへ移動，または削除してください。
2

ejbserver.logger.channels.define.<チャネル名>※.filesize
あり
Javaアプリケーションのログファイルのサイズを指定します。

サブディレクトリ専有モードの場合：

4096～2147483647の整数値で指定します。

サブディレクトリ共有モードの場合：

4096～16777216の整数値で指定します。

サイズを変更する場合には，該当するログファイルに出力しているプロセスをすべて停止し，ログファイルとmmapディレクトリ以下のログ管理ファイルを別のディレクトリへ移動，または削除してください。
1048576

ejbserver.logger.enabled.*
あり
ログレベルを指定します。Error，Warning，Information，Debugのうち，一つまたは複数を指定します。
一つだけ指定した場合は，該当するログレベルのログだけが出力されます。複数指定する場合は，レベル名の文字列の間をコンマ（,）で区切ります。
なお，シェルスクリプトを使用してシステムプロパティを設定する場合，このキーは指定できません。
Error

（凡例）

あり：

Javaアプリケーション用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

注※

チャネル名称として次に示す名称を設定できます。

ClientMessageLogFile，ClientExceptionLogFile，ClientMaintenanceLogFile，EJBContainerLogFile，UserOutLogFile，UserErrLogFile

資料の取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(h)　ejbserver.rmiから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.rmiから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(v)　ejbserver.rmiから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
ejbserver.rmi.request.timeout | なし | クライアントとサーバ間の通信タイムアウト時間（単位：秒）を指定します。 | －

（凡例）

なし：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(v)　ejbserver.rmiから始まるキー」を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(v)　ejbserver.rmiから始まるキー」を参照してください。

(i)　ejbserver.securityから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.securityから始まるキーを次に示します。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.security.service.url
独自
セキュリティ認証処理をするJ2EEサーバが接続されているCORBAネーミングサービスを指定します。java.naming.provider.urlで指定されたネーミングサービス以外のネーミングサービスに接続しているJ2EEサーバで認証処理をする場合に指定します。なお，接続するJ2EEサーバ名は，ejbserver.serverNameキーに指定しておく必要があります。
corbaname形式で指定してください。省略した場合は，java.naming.provider.urlで指定されたネーミングサービスが使用されます。
（指定形式）
corbaname::<ネーミングサービスのホスト名>:<ネーミングサービスのポート番号>"
corbaname::localhost:900

（凡例）

独自：

Javaアプリケーション用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

(j)　ejbserver.serverから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるejbserver.serverから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(w)　ejbserver.serverから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
ejbserver.serverName | 独自 | Javaアプリケーションが接続するJ2EEサーバのサーバ名称を指定します。 | なし
ejbserver.server.prf.PRFID | なし | PRF識別子を指定します。 | －

（凡例）

なし：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(w)　ejbserver.serverから始まるキー」を参照してください。

独自：

Javaアプリケーション用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(w)　ejbserver.serverから始まるキー」を参照してください。

(k)　javaから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるjavaから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(aa)　javaから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

java.naming.factory.initial
あり
JNDIのInitialContextがデレゲートするコンテキストの実装クラスのファクトリクラスを指定します。各設定値での動作を次に示します。

com.hitachi.software.ejb.jndi.InsContextFactory ：

JNDIラウンドロビン検索機能を使用しないで，通常の検索機能を使用する場合に指定するコンテキストです。

com.hitachi.software.ejb.jndi.GroupContextFactory ：

J2EEサーバ内アプリケーション（EJB）の実行時に，JNDIラウンドロビン検索機能を使用する場合に指定するコンテキストです。

なお，旧バージョンで使用されていた値（com.hitachi.software.ejb.jndi.spi.cosnaming.CNCtxFactory）と互換性があります。
－

java.naming.provider.url
独自
Javaアプリケーションが利用するCORBAネーミングサービスのホスト名称とポート番号を指定します。このCORBAネーミングサービスは，該当するJavaアプリケーションから呼び出すJ2EEサーバが利用しているものです。
なお，旧バージョンで使用されていたプロトコル（iioplocまたはiiopname）と互換性があります。
（指定形式）
corbaname::[ホスト名称]:[ポート番号]
なし

javax.xml.datatype.DatatypeFactory
独自
javax.xml.datatype.DatatypeFactoryの実装クラス名を指定します。
com.cosminexus.jaxp.impl.parsers.jaxp.datatype.DatatypeFactoryImpl

javax.xml.parsers.DocumentBuilderFactory
独自
javax.xml.parsers.DocumentBuilderFactoryの実装クラス名を指定します。
com.cosminexus.jaxp.impl.parsers.jaxp.DocumentBuilderFactoryImpl

javax.xml.parsers.SAXParserFactory
独自
javax.xml.parsers.SAXParserFactoryの実装クラス名を指定します。
com.cosminexus.jaxp.impl.parsers.jaxp.SAXParserFactoryImpl

javax.xml.transform.TransformerFactory
独自
javax.xml.transform.TransformerFactoryの実装クラス名を指定します。
com.cosminexus.jaxp.impl.transform.processor.TransformerFactoryImpl

javax.xml.xpath.XPathFactory¥:http¥://java.sun.com/jaxp/xpath/dom
独自
javax.xml.xpath.XPathFactoryの実装クラス名を指定します。
com.cosminexus.jaxp.impl.xpath.jaxp.XPathFactoryImpl

javax.xml.validation.SchemaFactory¥:http¥://www.w3.org/2001/XMLSchema
独自
javax.xml.validation.SchemaFactoryの実装クラス名を指定します。
com.cosminexus.jaxp.impl.parsers.jaxp.validation.XMLSchemaFactory

（凡例）

あり：

Javaアプリケーション用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

独自：

Javaアプリケーション用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(aa)　javaから始まるキー」を参照してください。

(l)　orgから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるorgから始まるキーを次に示します。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
org.w3c.dom.DOMImplementationSourceList | 独自 | org.w3c.dom.DOMImplementationSourceListの実装クラス名を指定します。 | com.cosminexus.jaxp.impl.parsers.dom.DOMXSImplementationSourceImpl
org.xml.sax.driver | 独自 | org.xml.sax.driverの実装クラス名を指定します。 | com.cosminexus.jaxp.impl.parsers.parsers.SAXParser
org.xml.sax.parser | 独自 | org.xml.sax.parserの実装クラス名を指定します。 | org.xml.sax.helpers.XMLReaderAdapter

（凡例）

独自：

Javaアプリケーション用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

(m)　vbroker.orbから始まるキー

Javaアプリケーション用usrconf.propertiesファイルで指定できるvbroker.orbから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(ac)　vbrokerから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

vbroker.orb.htc.comt.entryCount
なし
Cosminexus TPBroker通信トレースファイル1個当たりのエントリ数の上限値を指定します。
－

vbroker.orb.htc.comt.fileCount
なし
Cosminexus TPBroker通信トレースファイルの個数の上限値を指定します。
15

vbroker.orb.htc.tracePath
あり
Cosminexus TPBrokerのトレースファイル出力先のパスを1～210バイトの範囲で指定します。指定するパスは，Javaアプリケーションごとにユニークにしてください。指定したパスのサブディレクトリとしてcomtrcとmdltrcをあらかじめ作成しておく必要があります。デフォルトの出力先の場合，サブディレクトリcomtrcとmdltrcはJavaアプリケーション初回起動時に自動作成されます。
ディレクトリのパスの区切り記号には，"/"を使用してください。例えば，workディレクトリとして/temp/workを設定する場合，次のように指定します。
vbroker.orb.htc.tracePath=/temp/work

Windowsの場合
<ejbserver.client.ejb.log directoryの値>¥TPB¥logj

UNIXの場合
<ejbserver.client.ejb.log.directoryの値>/TPB/logj

（凡例）

あり：

Javaアプリケーション用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(ac)　vbrokerから始まるキー」を参照してください。

－：

Javaアプリケーション用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(ac)　vbrokerから始まるキー」を参照してください。

(5)　記述例

java.naming.provider.url=corbaname::localhost:900
ejbserver.serverName=MyServer

12.4　Javaアプリケーションに指定するシステムプロパティ

＜この節の構成＞

(1)　形式

(2)　機能

(3)　指定できるキー

(4)　記述例

(1)　形式

Win32のバッチファイル形式（Windowsの場合），またはシェルスクリプトファイル形式（UNIXの場合）のファイルに指定します。

(2)　機能

vbjコマンドを使用する場合に，Javaアプリケーションを実行するJavaVMのシステムプロパティを指定します。

また，java.lang.System.setProperty()で定義する場合は，該当機能を最初に使う前までにプロパティの定義が必要になります。

Javaアプリケーションを実行中に，このファイルの内容を変更した場合，変更した内容は，次回Javaアプリケーションを起動したときに反映されます。

なお，日立のJavaVMは，J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。JDK 5.0で使用できるプロパティについては，Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

(3)　指定できるキー

vbjコマンドで指定できるキーを次の表に示します。

表12-3　Javaアプリケーションに指定するシステムプロパティ

分類
キー名称
種別
指定可否

共通のキー
ejbserver.client.ctm.RequestPriority
選択
可変
○

ejbserver.client.ejb.log
選択
可変
○

ejbserver.client.log.appid
選択
可変
○

ejbserver.client.log.directory
選択
可変
○

ejbserver.client.log.directorynum
選択
可変
○

ejbserver.client.log.lockInterval
選択
可変
○

ejbserver.client.log.lockRetryCount
選択
可変
○

ejbserver.container.rebindpolicy
選択
可変
○

ejbserver.jndi.cache
選択
可変
○

ejbserver.jndi.cache.interval
選択
可変
○

ejbserver.jndi.cache.interval.clear.option
選択
可変
○

ejbserver.jndi.namingservice.group.list
選択
可変
○

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls
選択
可変
○

ejbserver.jndi.request.timeout
選択
可変
○

ejbserver.logger.channels.define.<チャネル名>※.filenum
選択
可変
○

ejbserver.logger.channels.define.<チャネル名>※.filesize
選択
可変
○

ejbserver.logger.enabled.*
選択
可変
○

ejbserver.rmi.request.timeout
選択
可変
○

ejbserver.security.service.url
選択
可変
○

ejbserver.serverName
可変
○

ejbserver.server.prf.PRFID
選択
可変
○

java.naming.factory.initial
可変
○

java.naming.provider.url
可変
○

vbroker.orb.htc.comt.entryCount
選択
可変
○

vbroker.orb.htc.comt.fileCount
選択
可変
○

vbroker.orb.htc.tracePath
選択
可変
○

独自のキー
ejbserver.jndi.log.message.verbosemode
選択
可変
○

ejbserver.server.prf.processName
選択
可変
○

java.endorsed.dirs
可変
×

java.naming.factory.object
固定
○

java.naming.factory.state
固定
○

javax.rmi.CORBA.UtilClass
固定
○

javax.rmi.CORBA.StubClass
固定
×

javax.rmi.CORBA.PortableRemoteObjectClass
固定
○

org.omg.PortableInterceptor.ORBInitializerClass.com.hitachi.software.ejb.security.std.interceptor.SecurityClientInterceptorInit
固定
○

java.security.policy
固定
○

org.omg.CORBA.ORBClass
固定
×

org.omg.CORBA.ORBSingletonClass
固定
×

vbroker.agent.enableLocator
選択
可変
○

（凡例）

○：コマンドにキーを指定する必要があります。

×：コマンドにキーを指定する必要はありません。

種別

固定の場合，該当するキーに対する値は固定で，必ず指定する必要があります。可変の場合，システムの実行環境に従って値を指定する必要があります。選択可変の場合は，システムの実行環境に従って値を指定するか，または指定を省略します。

注※

チャネル名称として次に示す名称を設定できます。

ClientMessageLogFile，ClientExceptionLogFile，ClientMaintenanceLogFile

資料の取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(a)　共通のキー

Javaアプリケーション用usrconf.propertiesファイルのキーと共通のシステムプロパティのキーです。

共通のキーの詳細については，「12.3　usrconf.properties（Javaアプリケーション用ユーザプロパティファイル）」を参照してください。また，必要に応じて，「2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」も参照してください。

(b)　独自のキー

システムプロパティ独自のキーです。

独自のキーの詳細を次に示します。

ejbserver.jndi.log.message.verbosemode
種別：選択可変
値：onまたはoff
通常値：off

内容：

標準出力にメッセージログ出力を指定します。

ejbserver.server.prf.processName
種別：選択可変
値：任意のクライアント識別子
通常値：EJBClient

内容：

性能解析トレースファイルの編集結果で，プロセス名称として表示させたい名前を指定します。nullを指定した場合またはこのキーを指定しない場合，通常値が使用されます。

java.endorsed.dirs
種別：可変
値：ディレクトリパス
通常値：<Cosminexusのインストールディレクトリ>¥TPB¥lib¥endorsed（Windowsの場合），または/opt/Cosminexus/TPB/lib/endorsed（UNIXの場合）

内容：

Endorsed Standards Override Mechanismを使って置き換えるクラスがあるディレクトリパスを指定します。

java.naming.factory.object
種別：固定
値：com.hitachi.software.ejb.jndi.InsNamingFactory

内容：

JNDIのSPIであるObjectFactoryの実装クラスを指定します。

ObjectFactoryはオブジェクト検索時にオブジェクト変換をします。

なお，旧バージョンで使用されていた値（com.hitachi.software.ejb.jndi.nameserver.spi.cos.wrappers.vbj.WrapperObjectFactory）と互換性があります。

java.naming.factory.state
種別：固定
値：com.hitachi.software.ejb.jndi.InsNamingFactory

内容：

JNDIのSPIであるStateFactoryの実装クラスを指定します。

StateFactoryはオブジェクト登録時のオブジェクト変換をします。

なお，旧バージョンで使用されていた値（com.hitachi.software.ejb.jndi.nameserver.spi.cos.wrappers.vbj.WrapperStateFactory）と互換性があります。

javax.rmi.CORBA.UtilClass
種別：固定
値：com.hitachi.software.ejb.rmi.Util

内容：

javax.rmi.CORBA.Utilの実装クラス名を指定します。

なお，旧バージョンで使用されていた値（com.inprise.vbroker.rmi.CORBA.UtilImpl）と互換性があります。

javax.rmi.CORBA.StubClass
種別：固定
値：com.inprise.vbroker.rmi.CORBA.StubImpl

内容：

javax.rmi.CORBA.Stubの実装クラス名を指定します。

javax.rmi.CORBA.PortableRemoteObjectClass
種別：固定
値：com.hitachi.software.ejb.rmi.PortableRemoteObject

内容：

javax.rmi.PortableRemoteObjectの実装クラス名を指定します。

なお，旧バージョンで使用されていた値（com.inprise.vbroker.rmi.CORBA.PortableRemoteObjectImpl）と互換性があります。

org.omg.PortableInterceptor.ORBInitializerClass.com.hitachi.software.ejb.security.std.interceptor.SecurityClientInterceptorInit
種別：固定
値：1

内容：

セキュリティ機能用のクライアント側インターセプタの初期化クラスを指定します。

JavaアプリケーションがEJBのセキュリティインタフェースを利用し，J2EEサーバにログインをしてEJBを呼び出す場合だけ指定します。

java.security.policy
種別：固定
値：<セキュリティポリシーファイルへの絶対パス>

内容：

<Cosminexusのインストールディレクトリ>¥CC¥client¥cli.policy（Windowsの場合），または/opt/Cosminexus/CC/client/cli.policy（UNIXの場合）をクライアント側の任意のディレクトリにコピーし，そのファイル名を絶対パスで指定します。ファイルの内容は変更しないでください。

org.omg.CORBA.ORBClass
種別：固定
値：com.inprise.vbroker.orb.ORB

内容：

ORBの実装クラス名を指定します。

org.omg.CORBA.ORBSingletonClass
種別：固定
値：com.inprise.vbroker.orb.ORBSingleton

内容：

ORBのシングルトン用の実装クラス名を指定します。

vbroker.agent.enableLocator
種別：選択可変
値：true，またはfalse
通常値：true

内容：

JavaアプリケーションがJ2EEサーバを呼び出すだけの場合は，falseを指定します。J2EEサーバの通信処理を実現しているCosminexus TPBrokerのネーミングサービスには，CORBAネーミングサービスとスマートエージェントがあります。JavaアプリケーションとJ2EEサーバ間の通信は，ネーミングサービスとしてCORBAネーミングサービスだけ利用します。この場合，J2EEサーバ，Javaアプリケーション間にCORBAネーミングサービスだけ開始する必要があり，該当キーはfalseを指定します。

一方，JavaアプリケーションがJ2EEサーバを呼び出すことに加え，スマートエージェントを利用しCosminexus TPBrokerのサーバアプリケーションを呼び出す場合は，CORBAネーミングサービス，およびスマートエージェントを開始する必要があり，該当キーにtrueを指定します。

(4)　記述例

システムプロパティの記述例をOSごとに示します。

(a)　Windowsの場合

Javaアプリケーションを開始するbatファイルの記述例を次に示します。これはvbjコマンドを使ってJavaアプリケーションを開始する場合の例です。なお，CLASS_PATHに指定する環境変数については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

setlocal

rem --- set environment ---
set COSMI_HOME=C:¥Program Files¥Hitachi¥Cosminexus
set SERVERNAME=MyServer
set PRF_HOME=%COSMI_HOME%¥PRF
set TPB_HOME=%COSMI_HOME%¥TPB
set JAVA_HOME=%COSMI_HOME%¥jdk
set VBJ="%TPB_HOME%¥bin¥vbj"
set VBROKER_ADM=%TPB_HOME%¥adm
set PATH=%PRF_HOME%¥bin;%TPB_HOME%¥bin;%JAVA_HOME%¥bin;%PATH%

rem --- set class path ---
set CLASS_PATH=%COSMI_HOME%¥TPB¥lib¥vbjorb.jar
set CLASS_PATH=%CLASS_PATH%;%COSMI_HOME%¥TPB¥lib¥vbsec.jar
set CLASS_PATH=%CLASS_PATH%;%COSMI_HOME%¥PRF¥lib¥cprf.jar
set CLASS_PATH=%CLASS_PATH%;%ProgramFiles%¥Hitachi¥HNTRLib2¥classes¥hntrlibMj.jar
set CLASS_PATH=%CLASS_PATH%;%COSMI_HOME%¥CC¥lib¥hitj2ee.jar
set CLASS_PATH=%CLASS_PATH%;%COSMI_HOME%¥CC¥client¥lib¥HiEJBClientStatic.jar
set CLASS_PATH=%CLASS_PATH%;stubs.jar
set CLASS_PATH="%CLASS_PATH%;1.jar"

rem --- set properties ---
set PROPS=-Djavax.rmi.CORBA.UtilClass=com.hitachi.software.ejb.rmi.Util
set PROPS=%PROPS% -Djavax.rmi.CORBA.PortableRemoteObjectClass=com.hitachi.software.ejb.rmi.PortableRemoteObject
set PROPS=%PROPS% -Djava.naming.factory.initial=com.hitachi.software.ejb.jndi.InsContextFactory
set PROPS=%PROPS% -Djava.naming.factory.object=com.hitachi.software.ejb.jndi.InsNamingFactory
set PROPS=%PROPS% -Djava.naming.factory.state=com.hitachi.software.ejb.jndi.InsNamingFactory
set PROPS=%PROPS% -Djava.naming.provider.url=corbaname::localhost:900
set PROPS=%PROPS% -Dejbserver.jndi.cache=on
set PROPS=%PROPS% -Dejbserver.jndi.cache.interval=0
set PROPS=%PROPS% -Dejbserver.jndi.cache.interval.clear.option=refresh
set PROPS=%PROPS% -Dejbserver.jndi.request.timeout=0
set PROPS=%PROPS% -Dejbserver.rmi.request.timeout=0
set PROPS=%PROPS% -Dejbserver.serverName=%SERVERNAME%
set PROPS=%PROPS% -Dvbroker.agent.enableLocator=false
set PROPS=%PROPS% -Dorg.omg.PortableInterceptor.ORBInitializerClass.com.hitachi.software.ejb.security.std.interceptor.SecurityClientInterceptorInit=1
set PROPS=%PROPS% "-Djava.security.policy==%COSMI_HOME%¥CC¥client¥cli.policy"
set PROPS=%PROPS% -Dejbserver.server.prf.processName=EJBClient
set PROPS=%PROPS% "-Dejbserver.client.log.directory=%COSMI_HOME%¥CC¥client¥logs"
set PROPS=%PROPS% -Dejbserver.logger.enabled.*=Error

rem --- execute client ---
%VBJ% -VBJclasspath %CLASS_PATH% %PROPS% ConverterClient

endlocal

(b)　UNIXの場合

Javaアプリケーションを開始するシェルスクリプトの記述例を次に示します。これはvbjコマンドを使ってJavaアプリケーションを開始する場合の例です。

なお，CLASS_PATHに指定する環境変数については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

#!/bin/csh -f

# --- environment ---
set COSMI_HOME=/opt/Cosminexus
set SERVERNAME="MyServer"
set PRF_HOME="${COSMI_HOME}/PRF"
set TPB_HOME="${COSMI_HOME}/TPB"
set JAVA_HOME="${COSMI_HOME}/jdk"
set VBJ="${TPB_HOME}/bin/vbj"
setenv PSALLOC early
setenv NODISCLAIM true
setenv AIXTHREAD_SCOPE S
setenv AIXTHREAD_MUTEX_DEBUG OFF
setenv AIXTHREAD_RWLOCK_DEBUG OFF
setenv AIXTHREAD_COND_DEBUG OFF
setenv EXTSHM ON
setenv LDR_CNTRL MAXDATA=0x40000000
setenv VBROKER_ADM "${TPB_HOME}/adm"
setenv PATH "${JAVA_HOME}/bin:${PATH}"
set LPATH="${TPB_HOME}/lib:${PRF_HOME}/lib"
if ($?LIBPATH) then
       setenv LIBPATH "${LPATH}:${LIBPATH}"
else
       setenv LIBPATH "${LPATH}"
endif

# --- class path ---
set CLASS_PATH="${COSMI_HOME}/TPB/lib/vbjorb.jar"
set CLASS_PATH="${CLASS_PATH}:${COSMI_HOME}/TPB/lib/vbsec.jar"
set CLASS_PATH="${CLASS_PATH}:${COSMI_HOME}/PRF/lib/cprf.jar"
set CLASS_PATH="${CLASS_PATH}:/opt/hitachi/HNTRLib2/classes/hntrlibMj.jar"
set CLASS_PATH="${CLASS_PATH}:${COSMI_HOME}/CC/lib/hitj2ee.jar"
set CLASS_PATH="${CLASS_PATH}:${COSMI_HOME}/CC/client/lib/HiEJBClientStatic.jar"
set CLASS_PATH="${CLASS_PATH}:stubs.jar"
set CLASS_PATH="${CLASS_PATH}:1.jar"

# --- properties ---
set PROPS="-Djavax.rmi.CORBA.UtilClass=com.hitachi.software.ejb.rmi.Util"
set PROPS="${PROPS} -Djavax.rmi.CORBA.PortableRemoteObjectClass=com.hitachi.software.ejb.rmi.PortableRemoteObject"
set PROPS="${PROPS} -Djava.naming.factory.initial=com.hitachi.software.ejb.jndi.InsContextFactory"
set PROPS="${PROPS} -Djava.naming.factory.object=com.hitachi.software.ejb.jndi.InsNamingFactory"
set PROPS="${PROPS} -Djava.naming.factory.state=com.hitachi.software.ejb.jndi.InsNamingFactory"
set PROPS="${PROPS} -Djava.naming.provider.url=corbaname::localhost:900"
set PROPS="${PROPS} -Dejbserver.jndi.cache=on"
set PROPS="${PROPS} -Dejbserver.jndi.cache.interval=0"
set PROPS="${PROPS} -Dejbserver.jndi.cache.interval.clear.option=refresh"
set PROPS="${PROPS} -Dejbserver.jndi.request.timeout=0"
set PROPS="${PROPS} -Dejbserver.rmi.request.timeout=0"
set PROPS="${PROPS} -Dejbserver.serverName=${SERVERNAME}"
set PROPS="${PROPS} -Dvbroker.agent.enableLocator=false"
set PROPS="${PROPS} -Dorg.omg.PortableInterceptor.ORBInitializerClass.com.hitachi.software.ejb.security.std.interceptor.SecurityClientInterceptorInit=1"
set PROPS="${PROPS} -Djava.security.policy==${COSMI_HOME}/CC/client/cli.policy"
set PROPS="${PROPS} -Dejbserver.server.prf.processName=EJBClient"
set PROPS="${PROPS} -Dejbserver.client.log.directory=${COSMI_HOME}/CC/client/logs"

# --- execute client ---
${VBJ} -VBJclasspath ${CLASS_PATH} ${PROPS} ConverterClient

下線が引かれている部分は，AIXの固有の記述です。

斜体の部分は，OSごとに変数名が異なります。次のとおり置き換えて使用してください。
AIXの場合：LIBPATH
HP-UX，Linux，またはSolarisの場合：LD_LIBRARY_PATH

12.5　Javaアプリケーションのユーザログ用プロパティ設定ファイル

＜この節の構成＞

(1)　形式

(2)　機能

(3)　ファイル名

(4)　指定できるキー

(5)　サンプル

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

(2)　機能

vbjコマンドを使用する場合に，Javaアプリケーションのユーザログ用のシステムプロパティを設定します。

ここで設定したプロパティは，Javaアプリケーションで読み込み，システムプロパティに設定する必要があります。Javaアプリケーションでのユーザログ出力の実装については，マニュアル「Cosminexus　機能解説」を参照してください。

(3)　ファイル名

格納先およびファイル名称は任意です。

(4)　指定できるキー

指定できるキーを次の表に示します。なお，キーの詳細については，「12.3(4)(a)　ejbserver.applicationから始まるキー」を参照してください。また，必要に応じて，「2.4(5)(a)　ejbserver.applicationから始まるキー」も参照してください。

表12-4　Javaアプリケーションのユーザログ用プロパティ設定ファイルで指定できるキー

キー名称 | 内容
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname | AppNameのフィールドに出力するデフォルトのアプリケーション名を指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.autoFlush.enabled | メッセージ出力後にflushをするかどうかを指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count | ログファイルの面数を指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding | 出力する文字列のエンコーディングを指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter | 使用するフィルタを，パッケージ名を含むフルネームで指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter | 使用するフォーマッタを，パッケージ名を含むフルネームで指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level | ログの取得レベルの上限を指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit | ログファイルの容量を指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid | MsgIDのフィールドに出力するデフォルトのメッセージIDを指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path | ログファイル名のプリフィックスを指定します。
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator | CJSimpleFormatterを利用して，1文でメッセージを出力するためのセパレータを指定します。
ejbserver.application.userlog.loggers | 使用するロガーの名称を宣言します。
ejbserver.application.userlog.Logger.<ロガー名称>.filter | ロガーで使用するフィルタを，パッケージ名を含むフルネームで指定します。
ejbserver.application.userlog.Logger.<ロガー名称>.handlers | 指定のロガー名称に対して，ハンドラクラスを指定します。
ejbserver.application.userlog.Logger.<ロガー名称>.level | ロガーの出力レベルを指定します。
ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers | ログレコードを受け取ったロガーから，親ロガーの接続しているハンドラへログレコードを伝播させるかどうかを指定します。

(5)　サンプル

次の場所に格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥examples¥EJBClient¥userlog¥sample.properties

UNIXの場合
/opt/Cosminexus/CC/examples/EJBClient/userlog/sample.properties

サンプルを次に示します。

# user-log handler function
ejbserver.application.userlog.CJLogHandler.conf1.appname=my_app1
ejbserver.application.userlog.CJLogHandler.conf1.path=application1/logfileA
ejbserver.application.userlog.CJLogHandler.conf1.limit=10485760
ejbserver.application.userlog.CJLogHandler.conf1.count=2
ejbserver.application.userlog.CJLogHandler.conf1.level=SEVERE

# user-log logger function
ejbserver.application.userlog.Logger.com.example.userlogger1.handlers=com.hitachi.software.ejb.application.userlog.CJMPMessageFileHandler;conf1
ejbserver.application.userlog.Logger.com.example.userlogger1.useParentHandlers=true
ejbserver.application.userlog.Logger.com.example.userlogger1.level=INFO
ejbserver.application.userlog.loggers=com.example.userlogger1

13.　Webアプリケーションで使用するファイル

この章では，Webアプリケーションで使用するコンパイル対象外リストファイル，実行結果リストファイルについて説明します。

＜この章の構成＞

13.1　Webアプリケーションで使用するファイルの一覧

13.2　コンパイル対象外リストファイル

13.3　実行結果リストファイル

13.1　Webアプリケーションで使用するファイルの一覧

Webアプリケーションで使用するファイルの一覧使用するファイルの一覧を，次の表に示します。

表13-1　Webアプリケーションで使用するファイルの一覧使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
（任意）※ | コンパイル対象外リストファイル | コマンドによるJSP事前コンパイルの対象外とするJSPファイルを定義します。 | 13.2
（任意）※ | 実行結果リストファイル | コンパイル結果を収集するためのファイルです。 | 13.3

注※

使用できる文字は，半角の英数字，ピリオド（.），アンダースコア（_）です。

13.2　コンパイル対象外リストファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　記述例

(1)　形式

次のように対象外リストファイルを指定します。

# コメント
＜コンパイルの対象外とするJSPファイルパス１＞
＜コンパイルの対象外とするJSPファイルパス２＞
…

指定方法

#で始まる行はコメントとみなされます。

コンパイルの対象外とするJSPファイルのパスを1行に一つ，記述します。

(2)　ファイルの格納先

格納先およびファイル名は任意です。

(3)　機能

コマンドによるJSP事前コンパイル実行時，コンパイルの対象外とするJSPファイルパスを設定します。

コンパイル対象外リストファイルをcjjspcコマンドの-excludelistオプションに指定することで，コンパイル対象外リストファイルに記述されたJSPファイルをコンパイルの対象外にできます。cjjspcコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(4)　記述例

JSPファイルを単体で指定する場合

/jsp/title.jsp
/jsp/pieces/pageA.jsp

ディレクトリに含まれるすべてのファイルを指定する場合

/jsp/pieces/*

コンパイル対象外とするファイルの拡張子を指定する場合

/jsp/pieces/*.jsp

コメントを書く場合

# JSP Fragment
/jsp/pieces/pageA.jsp

13.3　実行結果リストファイル

＜この節の構成＞

(1)　形式

(2)　機能

(3)　出力例

(1)　形式

実行結果リストファイルの出力形式を次に示します。

# Excluded JSP files.
＜コンパイル対象外JSPファイルの一覧＞
# Compiled JSP files.
＜コンパイルに成功したJSPファイル＞
# ＜コンパイルに失敗したJSPファイル＞
…

(2)　機能

コマンドによるJSP事前コンパイル実行時，cjjspcコマンドに-resultlistオプションを指定することで，コンパイル対象外JSPファイルのファイルパスの一覧，コンパイルに成功したJSPファイル，およびコンパイルに失敗したJSPファイルのファイルパスの一覧を実行結果リストファイルに出力できます。

実行結果リストファイルには，次の順番でコンパイル結果が出力されます。

コンパイル対象外のJSPファイルパスの一覧

コンパイルに成功，または失敗したJSPファイルパス

コンパイルに失敗したJSPファイルのファイルパスは，コメントとして出力されます。

(3)　出力例

# Excluded JSP files.
/jsp/title.jsp
/jsp/pieces/*.jsp
# Compiled JSP files.
/jsp/confirm.jsp
#/jsp/discorrect.jsp
#/jsp/fail.jsp
/jsp/index.jsp
/jsp/order.jsp
#/jsp/uncomfortable.jsp　

14.　Cosminexus DABroker Libraryで使用するファイル

この章では，Cosminexus DABroker Libraryで使用するファイルの形式，格納先，機能，指定できる環境変数などについて説明します。

＜この章の構成＞

14.1　Cosminexus DABroker Libraryで使用するファイルの一覧

14.2　Cosminexus DABroker Library動作環境定義ファイル

14.3　共通設定項目

14.4　拡張データベースアクセストレース設定項目

14.5　リモートアクセス設定項目

14.6　for C++設定項目

14.7　HiRDBの設定項目

14.8　ORACLEの設定項目

14.1　Cosminexus DABroker Libraryで使用するファイルの一覧

Cosminexus DABroker Libraryで使用するファイルの一覧を，次の表に示します。

表14-1　Cosminexus DABroker Libraryで使用するファイルの一覧

ファイル名称 | 分類 | 概要 | 参照先
dasysconf※ | Cosminexus DABroker Library動作環境定義ファイル | Cosminexus DABroker Libraryの動作に関する情報を定義します。 | 14.2

注※

Windowsの場合は，環境設定ユーティリティを使用してCosminexus DABroker Libraryの動作環境を設定したときに，このファイルが作成されます。Cosminexus DABroker Libraryの動作環境の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

14.2　Cosminexus DABroker Library動作環境定義ファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　注意事項

(1)　形式

Cosminexus DABroker Library動作環境定義ファイルの形式について，OSごとに説明します。

(a)　Windowsの場合

環境設定ユーティリティを使用してCosminexus DABroker Libraryの動作環境を設定したときに，次のように環境変数が設定されます。

<環境変数>=<値>

Cosminexus DABroker Library動作環境定義ファイルに設定される項目については，「14.3　共通設定項目」，「14.4　拡張データベースアクセストレース設定項目」，「14.5　リモートアクセス設定項目」，および「14.6　for C++設定項目」を参照してください。

(b)　UNIXの場合

次のように環境変数を指定します。

<環境変数>=<値>

指定方法

#で始まる行はコメントとみなされます。

「=」の前後にスペースまたはタブがある場合はエラーとなります。

値に半角スペースを使用する場合は，'（シングルクォーテーション）で値を囲んで指定してください。
（例）DABTMP='/tmp/da b'

値の後ろに半角スペース，タブおよび#以外の文字を記載した場合は，エラーとなります。

値には，「$設定項目」で指定する値を引き継ぐことはできません。

このファイルはDABブロックとOTHERSブロックで構成されます。各ブロックの設定内容を次に示します。

DABブロック

Cosminexus DABroker Libraryの動作環境を設定します。

Cosminexus DABroker Libraryでは，設定項目をチェックし，不正な名称などを指定した場合はエラーになります。なお，ここで指定する項目については，「14.3　共通設定項目」，「14.4　拡張データベースアクセストレース設定項目」，および「14.5　リモートアクセス設定項目」を参照してください。

OTHERSブロック

DBMSなどの動作環境を設定します。

Cosminexus DABroker Libraryでは，設定項目をチェックしません。このセクションに指定されたすべての項目を有効とします。なお，ここで指定する項目については，「14.7　HiRDBの設定項目」および「14.8　ORACLEの設定項目」を参照してください。

(2)　ファイルの格納先

Windowsの場合
<Cosminexus DABroker Library運用ディレクトリ>¥conf

UNIXの場合
<Cosminexus DABroker Library運用ディレクトリ>/conf

<Cosminexus DABroker Library運用ディレクトリ>は，<Cosminexus DABroker Libraryインストールディレクトリ>です。

UNIXの場合，サンプルファイル（/opt/DABroker/sample/dasysconf）をコピーしてファイルを作成してください。

(3)　機能

Cosminexus DABroker Libraryの動作に関する情報を定義します。

UNIXの場合，Cosminexus DABroker Library動作環境定義ファイルで定義する内容は，シェルの環境変数として設定することもできます。その場合，Cosminexus DABroker Library動作環境定義ファイルで設定した値よりもシェルの環境変数として設定した値が優先されます。

(4)　注意事項

値を変更しない設定項目は削除しないでください。

設定項目のexportは不要です。

Cosminexus DABroker Libraryの起動中は，Cosminexus DABroker Library動作環境定義ファイルを変更しないでください。

14.3　共通設定項目

接続するデータベースに関係なく，共通に設定する項目です。

「14.5　リモートアクセス設定項目」で設定する，次の項目についても有効になります。

Windowsの場合

HiRDBのBLOB型データ受取バッファサイズ

ORACLEのLONG型データ受取バッファサイズ

UNIXの場合

DABHIRDBA_BLOBBUFSIZE（HiRDBのBLOB型データ受取バッファサイズ）

DABORADBA_LONGBUFSIZE（ORACLEのLONG型データ受取バッファサイズ）

ここでの設定内容を，次に示します。

＜この節の構成＞

DAB_LANG（LANG環境変数）

DABTMP（作業ディレクトリ）

DABSVLOGSIZE（ログファイルサイズ［dabsv.log］）

DABSELECTCOLCNT（表検索カラム数）

DABSELECTINFCNT（更新・検索条件カラム数）

DABORACLE_TYPE（使用するORACLEのバージョン）

DABSQL_HiRDB_DICTIONARY_DATATYPE（HiRDBのディクショナリ表のデータ属性）

DAB_HIRDB_DBINF_ESC（HiRDB環境変数区切り文字）

DABEXSQL_TRC_LINE（拡張データベースアクセストレースを取得する）

トレースファイルサイズ

DABXA_LOG_ERROR（XAトレースを取得する）

DAB_LANG（LANG環境変数）

この項目は，Windowsでは設定されません。

標準値

AIX，またはLinuxの場合
C

HP-UXの場合
ja_JP.SJIS

Solarisの場合
ja_JP.PCK

指定範囲

表14-2　LANG環境変数に指定できる値

言語モード
AIX
の場合
HP-UX
の場合
Linux
の場合
Solaris
の場合

SJISモード
Ja_JP
Ja_JP.IBM-932
Ja_JP.IBM-943
ja_JP.SJIS
ja_JP.SJIS
japanese.sjis
ja_JP.PCK

日本語EUCモード
ja_JP
ja_JP.IBM-eucJP
ja_JP.EUC
ja_JP.UJIS
ja_JP.eucJP
ja_JP
ja_JP.eucjp
ja_JP.ujis
japanese
japanese.euc
Ja_JP
ja
japanese

ASCIIモード
C
C
C
C

UTF-8モード
UTF-8
UTF-8
UTF-8
UTF-8※

注※

HiRDB使用時に指定できます。

説明

HiRDB，またはOracle使用時に使用する母国語（日本語，英語など）および文字コード（SJISコードなど）を設定します。

各データベースで使用する言語モードは，必ずCosminexus DABroker Libraryの言語モードと合わせてください。データベースとCosminexus DABroker Libraryの言語モードが異なっている場合の動作は保証されません。

Cosminexus DABroker Libraryを日本語EUCモード，ASCIIモード，またはUTF-8モードで動作させた場合，メッセージは英文で出力されます。

DABTMP（作業ディレクトリ）

標準値

Windowsの場合
<Cosminexus DABroker Library運用ディレクトリ>¥tmp

UNIXの場合
<Cosminexus DABroker Library運用ディレクトリ>/tmp

指定範囲

パーティションを圧迫しない，任意のディレクトリを指定します。

ただし，Windowsの場合，ネットワークドライブ上のディレクトリは指定できません。また，指定したディレクトリのアクセス権限として，システムにフルコントロールを指定してください。

UNIXの場合，Cosminexus DABroker Libraryの管理ユーザは，ディレクトリにアクセスできる権限（READおよびWRITE）が必要です。

説明

Cosminexus DABroker Libraryの作業ディレクトリを指定します。このディレクトリは，予約処理用のSQLの格納および，処理途中で作成される一時ファイルの格納などに使用されます。

なお，UNIXの場合，ここで/tmpを指定したら，OSの再起動時に，/tmpディレクトリ下に作成されたすべてのファイルは削除されます。

DABSVLOGSIZE（ログファイルサイズ［dabsv.log］）

標準値

64（キロバイト）

指定範囲

0または64～32767（キロバイト）

説明

Cosminexus DABroker Libraryのログを取得するファイルの容量を設定します。ログは，<Cosminexus DABroker Library運用ディレクトリ>¥spool¥dabsv.log（UNIXの場合，<Cosminexus DABroker Library運用ディレクトリ>/spool/dabsv.log）に出力されます。

0を設定した場合
ファイルの容量は無限大になります。

64～32767を設定した場合
設定した値がファイルの容量になります。

注意事項

ログファイルが満杯になったら，ラップアラウンドでログを取得します。ラップアラウンドした場合，１世代前のバックアップファイル（dabsv.logold）を作成し，１世代だけを管理します。

DABSELECTCOLCNT（表検索カラム数）

標準値

0

指定範囲

0または1～2147483647

説明

表検索用の領域として確保する表カラムの個数を指定します。

0を設定した場合
DBMSに対して表カラムの個数を要求するSQLを発行します。DBMSから返された結果を基に，表検索用の領域を確保します。

1～2147483647を設定した場合
表カラムの個数が指定した値より少ない場合，DBMSに対して表カラムの個数を要求するSQLを発行しません。このため，SQLを発行する場合より処理性能が向上します。ただし，検索を実行するたびに次に示す大きさのメモリが必要になるため，動作環境を考慮して値を設定してください。よく検索する表のカラム数を大きく超える値を設定した場合，性能劣化の原因になることがあります。
HiRDB，ORACLEの場合：1カラム当たり128バイト
表カラムの個数が指定した値より多い場合，DBMSに対して表カラムの個数を要求するSQLを発行します。DBMSから返された結果を基に，表検索用の領域を確保します。

DABSELECTINFCNT（更新・検索条件カラム数）

標準値

0

指定範囲

0または1～2147483647

説明

表の更新・検索用の領域として確保する，入力項目（パラメタ）の個数を指定します。

0を設定した場合
DBMSに対して入力項目の個数を要求するSQLを発行します。DBMSから返された結果を基に，表の更新・検索用の領域を確保します。

1～2147483647を設定した場合
入力項目の個数が指定した値より少ない場合，DBMSに対して入力項目の個数を要求するSQLを発行しません。このため，SQLを発行する場合より処理性能が向上します。ただし，更新・検索を実行するたびに次に示す大きさのメモリが必要になるため，動作環境を考慮して値を設定してください。よく更新・検索する表の入力項目の個数を大きく超える値を設定した場合，性能劣化の原因になることがあります。
HiRDB，ORACLEの場合：1カラム当たり128バイト
入力項目の個数が指定した値より多い場合，DBMSに対して入力項目の個数を要求するSQLを発行します。DBMSから返された結果を基に，表の更新・検索用の領域を確保します。

DABORACLE_TYPE（使用するORACLEのバージョン）

標準値

Windowsの場合
ORACLE9i

AIX，またはLinuxの場合
817

HP-UX，またはSolarisの場合
805

指定範囲

Windowsの場合
ORACLE7，ORACLE9iまたはORACLE10g

AIX，またはLinuxの場合
920，または101

HP-UX，またはSolarisの場合
901，920，または101

説明

使用するORACLEのバージョンを設定します。

901：Oracle9i R9.0.1

920：Oracle9i R9.2.0

101：Oracle10g R10.1.0

DABSQL_HiRDB_DICTIONARY_DATATYPE（HiRDBのディクショナリ表のデータ属性）

標準値

C

指定範囲

MまたはC

説明

HiRDBのディクショナリ表の列属性を指定します。

Mを設定した場合
混在文字データ（MVARCHAR）として処理します。

Cを設定した場合
文字データ（VARCHAR）として処理します。

注意事項

ここでの指定とHiRDBで使用されているディクショナリ表のデータ属性が異なる場合は，結果不正やSQLエラーになる場合があります。

DAB_HIRDB_DBINF_ESC（HiRDB環境変数区切り文字）

標準値

@

指定範囲

@　!　$　%　&　*　+　-　/　:　?　¥　|

説明

HiRDB環境変数区切り文字を指定します。

注意事項

特に問題がない場合，区切り文字には@を使用してください。

区切り文字は必ず半角1文字で指定してください。全角文字は指定できません。

Cosminexus DABroker LibraryからHiRDBクライアント環境変数グループを指定してデータベースと接続する場合は，標準値「@」を指定してください。

DABEXSQL_TRC_LINE（拡張データベースアクセストレースを取得する）

標準値

Windowsの場合
OFF

UNIXの場合
-1

指定範囲

Windowsの場合
OFFまたはON

UNIXの場合
-1，0，または1024～32767（行）

説明

拡張データベースアクセストレースを取得するかどうかを設定します。

Windowsの場合

OFF（チェックなし）を設定した場合
拡張データベースアクセストレースを取得しません。

ON（チェックあり）を設定した場合
拡張データベースアクセストレースを取得します。この場合，トレースファイルサイズを指定します。

なお，拡張データベースアクセストレースのファイルの出力行数は，トレースファイルサイズの設定値に従います。

UNIXの場合

-1を設定した場合
拡張データベースアクセストレースを取得しません。

0を設定した場合
拡張データベースアクセストレースを取得します。出力行数は，無限大となります。

1024～32767を設定した場合
拡張データベースアクセストレースを取得します。出力行数は，設定した数値分となります。

拡張データベースアクセストレースファイルは，1行に134バイトまで出力され，出力行数はここでの設定値に従います。ただし，ヘッダは行数に含まれません。

トレースファイルサイズ

この項目は，UNIXでは設定不要です。

標準値

1024（単位：行）

指定範囲

0，または1024～32767

説明

DABEXSQL_TRC_LINE（拡張データベースアクセストレースを取得する）をONにした場合，トレースファイルサイズを指定します。

拡張データベースアクセストレースのトレースファイルサイズを指定します。

0を設定した場合
出力行数は，無限大となります。

1024～32767を設定した場合
拡張データベースアクセストレースを取得します。出力行数は，設定した数値分となります。

なお，拡張データベースアクセストレースのファイルは，1行に134バイトまで出力されます。拡張データベースアクセストレースのファイルの出力行数は，ここでの設定値に従います。ただし，ヘッダは行数に含まれません。

DABXA_LOG_ERROR（XAトレースを取得する）

標準値

ON

指定範囲

ONまたはOFF

説明

XAインタフェースでエラーを検知した場合，エラートレースを取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
エラートレースを取得しません。

ON（チェックあり）を設定した場合
エラートレースを取得します。

XAトレースは，Cosminexus DABroker Library運用ディレクトリ下のspoolディレクトリにdb_xainfo.logというファイル名で取得されます。XAトレースファイル（db_xainfo.log）はテキスト形式なので，任意のテキストエディタで参照してください。

XAトレースファイルは，運用期間に応じてファイルサイズが増加するため，定期的に削除する必要があります。

14.4　拡張データベースアクセストレース設定項目

拡張データベースアクセストレースで取得する項目の設定内容を次に示します。

ここでの設定は，DABEXSQL_TRC_LINE（拡張データベースアクセストレースを取得する）に0または1024～32767を指定した場合に有効になります。

すべての項目を設定する必要はありません。省略した場合，標準値が仮定されます。また，「ON」が設定された項目に該当する，すべてのデータベースへの要求がなかった場合，拡張データベースアクセストレースにはヘッダ（出力項目名）だけが出力されます。

＜この節の構成＞

DABSQL_TRC_CANCEL（CANCEL）

DABSQL_TRC_CLOSE（CLOSE）

DABSQL_TRC_COMMIT（COMMIT）

DABSQL_TRC_CONNECT（CONNECT）

DABSQL_TRC_DECLARE（DECLARE）

DABSQL_TRC_DESCRIBE（DESCRIBE）

DABSQL_TRC_DISCONNECT（DISCONNECT）

DABSQL_TRC_EXECUTE（EXECUTE）

DABSQL_TRC_FETCH（FETCH）

DABSQL_TRC_LOGGING（LOGGING）

DABSQL_TRC_LOGLESS（LOGLESS）

DABSQL_TRC_PREPARE（PREPARE）

DABSQL_TRC_ROLLBACK（ROLLBACK）

DABSQL_TRC_OPEN（OPEN）

DABSQL_TRC_ATTACH（ATTACH）

DABSQL_TRC_ATTRGET（ATTRGET）

DABSQL_TRC_ATTRSET（ATTRSET）

DABSQL_TRC_BIND（BIND）

DABSQL_TRC_CHARFORM（CHARFORM）

DABSQL_TRC_CHARID（CHARID）

DABSQL_TRC_DEFINE（DEFINE）

DABSQL_TRC_DESALLOC（DESALLOC）

DABSQL_TRC_DESCANY（DESCANY）

DABSQL_TRC_DESFREE（DESFREE）

DABSQL_TRC_DETACH（DETACH）

DABSQL_TRC_ENVCREATE（ENVCREATE）

DABSQL_TRC_ERRGET（ERRGET）

DABSQL_TRC_GETPIECE（GETPIECE）

DABSQL_TRC_HDLALLOC（HDLALLOC）

DABSQL_TRC_HDLFREE（HDLFREE）

DABSQL_TRC_LOBCLOSE（LOBCLOSE）

DABSQL_TRC_LOBLEN（LOBLEN）

DABSQL_TRC_LOBOPEN（LOBOPEN）

DABSQL_TRC_LOBREAD（LOBREAD）

DABSQL_TRC_LOBWRITE（LOBWRITE）

DABSQL_TRC_PARAMGET（PARAMGET）

DABSQL_TRC_SESBEGIN（SESBEGIN）

DABSQL_TRC_SESEND（SESEND）

DABSQL_TRC_SETPIECE（SETPIECE）

DABSQL_TRC_GETDIAG（GETDIAG）

DABSQL_TRC_AUTO_COMMIT_OFF（AUTO COMMIT OFF）

DABSQL_TRC_AUTO_COMMIT_ON（AUTO COMMIT ON）

DABSQL_TRC_GET_INFO（GET INFO）

DABSQL_TRC_SET_INFO（SET INFO）

DABSQL_TRC_EXECUTE_DIRECT（EXECUTE DIRECT）

DABSQL_TRC_CANCEL（CANCEL）

標準値

ON

指定範囲

ONまたはOFF

説明

DBMSに対する処理中断要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
取得しません。

ON（チェックあり）を設定した場合
取得します。

DABSQL_TRC_CLOSE（CLOSE）

標準値

ON

指定範囲

ONまたはOFF

説明

カーソルを閉じる要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
取得しません。

ON（チェックあり）を設定した場合
取得します。

DABSQL_TRC_COMMIT（COMMIT）

標準値

ON

指定範囲

ONまたはOFF

説明

トランザクションの正常終了，更新を有効にする要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
取得しません。

ON（チェックあり）を設定した場合
取得します。

DABSQL_TRC_CONNECT（CONNECT）

標準値

ON

指定範囲

ONまたはOFF

説明

データベースとの接続要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
取得しません。

ON（チェックあり）を設定した場合
取得します。

DABSQL_TRC_DECLARE（DECLARE）

標準値

ON

指定範囲

ONまたはOFF

説明

前処理したSELECTに対してカーソルを宣言する要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
取得しません。

ON（チェックあり）を設定した場合
取得します。

DABSQL_TRC_DESCRIBE（DESCRIBE）

標準値

ON

指定範囲

ONまたはOFF

説明

前処理したSQLの情報を取得する要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
取得しません。

ON（チェックあり）を設定した場合
取得します。

DABSQL_TRC_DISCONNECT（DISCONNECT）

標準値

ON

指定範囲

ONまたはOFF

説明

トランザクションを正常終了，切り離し要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_EXECUTE（EXECUTE）

標準値

ON

指定範囲

ONまたはOFF

説明

前処理したSQLの実行要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_FETCH（FETCH）

標準値

ON

指定範囲

ONまたはOFF

説明

行を読み込んでカーソルを進める要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_LOGGING（LOGGING）

標準値

ON

指定範囲

ONまたはOFF

説明

LOGGING要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_LOGLESS（LOGLESS）

標準値

ON

指定範囲

ONまたはOFF

説明

LOGLESS要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_PREPARE（PREPARE）

標準値

ON

指定範囲

ONまたはOFF

説明

SQLの前処理要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_ROLLBACK（ROLLBACK）

標準値

ON

指定範囲

ONまたはOFF

説明

トランザクションを取り消し，更新を無効にする要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_OPEN（OPEN）

標準値

ON

指定範囲

ONまたはOFF

説明

カーソルの位置づけ要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_ATTACH（ATTACH）

標準値

ON

指定範囲

ONまたはOFF

説明

サーバとのアクセスパス作成要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_ATTRGET（ATTRGET）

標準値

ON

指定範囲

ONまたはOFF

説明

ハンドルの属性取得要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_ATTRSET（ATTRSET）

標準値

ON

指定範囲

ONまたはOFF

説明

ハンドルの属性設定要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_BIND（BIND）

標準値

ON

指定範囲

ONまたはOFF

説明

パラメタのバインド要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_CHARFORM（CHARFORM）

標準値

ON

指定範囲

ONまたはOFF

説明

キャラクタセットフォームの取得要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_CHARID（CHARID）

標準値

ON

指定範囲

ONまたはOFF

説明

キャラクタセットIDの取得要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_DEFINE（DEFINE）

標準値

ON

指定範囲

ONまたはOFF

説明

パラメタの定義要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_DESALLOC（DESALLOC）

標準値

ON

指定範囲

ONまたはOFF

説明

記述子の領域確保の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_DESCANY（DESCANY）

標準値

ON

指定範囲

ONまたはOFF

説明

オブジェクトの記述要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_DESFREE（DESFREE）

標準値

ON

指定範囲

ONまたはOFF

説明

記述子の領域解放の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_DETACH（DETACH）

標準値

ON

指定範囲

ONまたはOFF

説明

サーバとのアクセスパス削除要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_ENVCREATE（ENVCREATE）

標準値

ON

指定範囲

ONまたはOFF

説明

環境作成要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_ERRGET（ERRGET）

標準値

ON

指定範囲

ONまたはOFF

説明

エラー情報取得要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_GETPIECE（GETPIECE）

標準値

ON

指定範囲

ONまたはOFF

説明

ピース情報取得要求の情報を取得するかどうかを指定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_HDLALLOC（HDLALLOC）

標準値

ON

指定範囲

ONまたはOFF

説明

ハンドルの領域確保の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_HDLFREE（HDLFREE）

標準値

ON

指定範囲

ONまたはOFF

説明

ハンドルの領域解放の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_LOBCLOSE（LOBCLOSE）

標準値

ON

指定範囲

ONまたはOFF

説明

BFILEデータのクローズ要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_LOBLEN（LOBLEN）

標準値

ON

指定範囲

ONまたはOFF

説明

LOBデータの長さ取得要求の情報を取得するかどうかを指定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_LOBOPEN（LOBOPEN）

標準値

ON

指定範囲

ONまたはOFF

説明

BFILEデータのオープン要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_LOBREAD（LOBREAD）

標準値

ON

指定範囲

ONまたはOFF

説明

LOBデータの読み込み要求の情報を取得するかどうかを指定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_LOBWRITE（LOBWRITE）

標準値

ON

指定範囲

ONまたはOFF

説明

LOBデータの書き込み要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_PARAMGET（PARAMGET）

標準値

ON

指定範囲

ONまたはOFF

説明

パラメタ情報取得要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_SESBEGIN（SESBEGIN）

標準値

ON

指定範囲

ONまたはOFF

説明

セッション開始要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_SESEND（SESEND）

標準値

ON

指定範囲

ONまたはOFF

説明

セッション終了要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_SETPIECE（SETPIECE）

標準値

ON

指定範囲

ONまたはOFF

説明

ピース情報設定要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

この項目は，Cosminexus DABroker Libraryのデータベース種別にOracle8iを設定している場合だけ有効です。

DABSQL_TRC_GETDIAG（GETDIAG）

標準値

ON

指定範囲

ONまたはOFF

説明

エラー情報取得要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_AUTO_COMMIT_OFF（AUTO COMMIT OFF）

標準値

ON

指定範囲

ONまたはOFF

説明

オートコミットモード解除要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_AUTO_COMMIT_ON（AUTO COMMIT ON）

標準値

ON

指定範囲

ONまたはOFF

説明

オートコミットモード設定要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_GET_INFO（GET INFO）

標準値

ON

指定範囲

ONまたはOFF

説明

接続後の動作情報取得要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_SET_INFO（SET INFO）

標準値

ON

指定範囲

ONまたはOFF

説明

接続後の動作情報設定要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

DABSQL_TRC_EXECUTE_DIRECT（EXECUTE DIRECT）

標準値

ON

指定範囲

ONまたはOFF

説明

SQLの前処理後に実行する要求の情報を取得するかどうかを設定します。

OFF（チェックなし）を設定した場合
情報を取得しません。

ON（チェックあり）を設定した場合
情報を取得します。

14.5　リモートアクセス設定項目

「14.3　共通設定項目」で設定した項目以外に設定できる項目です。ここでの設定内容を，次に示します。

＜この節の構成＞

DABHIRDBA_BLOBBUFSIZE（HiRDBのBLOB型データ受取バッファサイズ）

DABORADBA_LONGBUFSIZE（ORACLEのLONG型データ受取バッファサイズ）

DABLANGMODE（漢字コードセット）

DABHIRDBA_BLOBBUFSIZE（HiRDBのBLOB型データ受取バッファサイズ）

標準値

4096（バイト）

指定範囲

0，または1～2147483647（バイト）

説明

HiRDBからBLOB型データを抽出する場合の受け取りサイズを指定します。

このデータ型の場合，HiRDBでは最大2147483647バイトのデータの存在が考えられますが，Cosminexus DABroker Libraryではここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長がわかっている場合は，その値を指定することを推奨します。

DABORADBA_LONGBUFSIZE（ORACLEのLONG型データ受取バッファサイズ）

標準値

4096（バイト）

指定範囲

0，または1～2147483647（バイト）

説明

ORACLEから，LONG型データを抽出する場合の受け取りサイズを指定します。

このデータ型の場合，ORACLEでは最大2147483647バイトのデータの存在が考えられますが，Cosminexus DABroker Libraryではここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長がわかっている場合は，その値を指定することを推奨します。

この項目は，データベース種別にOracle8iを設定している場合は設定しません。

DABLANGMODE（漢字コードセット）

この項目は，UNIXでは設定不要です。

標準値

SJIS（シフトJISモード）

指定範囲

SJIS（シフトJISモード），EUC（日本語EUCモード），ASCII（ASCIIモード），またはUTF-8（UTF-8モード）

説明

Cosminexus DABroker Libraryが稼働する言語モードを設定します。

各言語モードで操作できるデータベースを次に示します。

表14-3　各言語モードで操作できるデータベース

データベース | Cosminexus DABroker Libraryでの設定
シフトJISモード | 日本語EUCモード | ASCIIモード | UTF-8モード
HiRDB | ○ | ○ | ○ | ○
ORACLE | ○ | ○ | ○ | ○

（凡例）

○：操作できます。

各データベースで使用する言語モードは，必ずCosminexus DABroker Libraryの言語モードと合わせてください。データベースとCosminexus DABroker Libraryの言語モードが異なっている場合は動作を保証しません。

Cosminexus DABroker Libraryを日本語EUCモード，ASCIIモード，またはUTF-8モードで動作させた場合，メッセージは英文で出力されます。

14.6　for C++設定項目

DABroker for C++のイベントトレースについて設定します。なお，for C++設定項目は，WindowsでDABroker for C++を使用してデータベースに接続する場合の設定項目です。UNIXでは，この項目は設定不要です。

トレースの取得レベル，取得種別など，イベントトレースの詳細については，マニュアル「DABroker for C++」を参照してください。

＜この節の構成＞

DABCPP_EVTTRC_SIZE（トレース取得サイズ）

DABCPP_EVTTRC_LEVEL（トレース取得レベル）

DABCPP_EVTTRC_SIZE（トレース取得サイズ）

標準値

32（キロバイト）

指定範囲

-1，0，または10～32767（キロバイト）

説明

イベントトレースを取得するかどうかを指定します。また，取得する場合は，トレースを取得するファイルの容量を設定します。なお，トレースファイルは，<Cosminexus DABroker Library運用ディレクトリ>¥spool¥dabevttrccpp1に作成されます。

-1を設定した場合
イベントトレースを取得しません。

0を設定した場合
イベントトレースを取得します。
この場合，ファイルの容量を制限しません。

10～32767を設定した場合
イベントトレースを取得します。
この場合，設定した値がファイルの容量になります。

注意事項

指定した容量のトレースファイルを作成したらラップアラウンドでトレースを取得します。ラップアラウンドした場合は，１世代前のバックアップファイル（dabevttrccpp2）を作成し，常に１世代だけを管理します。

DABCPP_EVTTRC_LEVEL（トレース取得レベル）

標準値

0

指定範囲

0または1

説明

イベントトレースの取得レベルを設定します。

値が大きいほど詳細な情報が取得できます。

14.7　HiRDBの設定項目

接続するデータベースにHiRDBを使用する場合の設定項目です。Windowsでは，この項目は設定されません。

ここでの設定内容を，次に示します。

PDCLTPATH

トレースファイル格納ディレクトリ

PDHOST

ホスト名

ここで設定した値と異なるホスト名でアプリケーションが接続を要求した場合は，アプリケーションで指定されたホスト名が有効になります。

PDNAMEPORT

HiRDBのシステムポート番号

ここで設定した値と異なるポート番号でアプリケーションが接続を要求した場合は，アプリケーションで指定されたポート番号が有効になります。

PDSWAITTIME

サーバ最大待ち時間

PDSQLTRACE

SQLトレースファイルのサイズ

PDUAPERLOG

エラーログファイルのサイズ

注意事項

HiRDBのバージョンによっては，必要な設定項目が異なることがありますのでご注意ください。

PDHOSTとPDNAMEPORTの値は，HiRDBの環境で設定されている値を指定してください。そのほかの設定項目では，Cosminexus DABroker Libraryで設定した値が有効になります。なお，設定内容については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

14.8　ORACLEの設定項目

接続するデータベースにORACLEを使用する場合の設定項目です。Windowsでは，この項目は設定されません。

ここでの設定内容を，次に示します。

ORACLE_HOME

ORACLEのホームディレクトリ

ORACLE_SID

ORACLEのデータベース識別子

ここで設定した値と異なるデータベース識別子でアプリケーションが接続を要求した場合は，アプリケーションで指定されたデータベース識別子が有効になります。

NLS_LANG

母国語指定

注意事項

各設定項目には，ORACLEの環境で設定されている値を指定してください。なお，設定内容については，ORACLEのマニュアルを参照してください。

15.　Webコンテナサーバで使用するファイル

この章では，Webコンテナサーバで使用するファイルの形式，格納先，機能，指定できるキーなどについて説明します。

＜この章の構成＞

15.1　Webコンテナサーバで使用するファイルの一覧

15.2　hitachi_web.properties（Webコンテナサーバ用Webアプリケーションプロパティファイル）

15.3　usrconf.cfg（Webコンテナサーバ用オプション定義ファイル）

15.4　usrconf.properties（Webコンテナサーバ用ユーザプロパティファイル）

15.5　web-users.xml（ユーザ認証情報定義ファイル）

15.6　web.policy（SecurityManager定義ファイル）

15.1　Webコンテナサーバで使用するファイルの一覧

Webコンテナサーバで使用するファイルの一覧を，次の表に示します。

表15-1　Webコンテナサーバで使用するファイルの一覧

ファイル名 | 分類 | 概要 | 参照先
hitachi_web.properties | Webコンテナサーバ用Webアプリケーションプロパティファイル | Webアプリケーション個別のプロパティを指定します。 | 15.2
usrconf.cfg | Webコンテナサーバ用オプション定義ファイル | Webコンテナサーバ全体でのシステムプロパティを指定します。 | 15.3
usrconf.properties | Webコンテナサーバ用ユーザプロパティファイル | Webコンテナサーバ全体でのシステムプロパティを指定します。 | 15.4
web-users.xml | ユーザ認証情報定義ファイル | 各ユーザのユーザ名，パスワード，および所属するロールを記述します。 | 15.5
web.policy | SecurityManager定義ファイル | SecurityManagerを設定して，Java 2から導入されたセキュリティポリシーに基づくWebコンテナの実行時保護をします。 | 15.6

15.2　hitachi_web.properties（Webコンテナサーバ用Webアプリケーションプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(1)　形式

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

(2)　ファイルの格納先

Windowsの場合
<WebアプリケーションのWEB-INFディレクトリ>¥

UNIXの場合
<WebアプリケーションのWEB-INFディレクトリ>/

(3)　機能

Webアプリケーション個別のプロパティを指定します。なお，Webコンテナサーバ全体でのシステムプロパティ設定は，usrconf.propertiesで指定します。usrconf.propertiesとWEB-INF/hitachi_web.propertiesで同じキーが指定されている場合は，WEB-INF/hitachi_web.propertiesの値が優先されます。

(4)　指定できるキー

指定できるキーとデフォルト値を次に示します。このキーに不正な値を指定した場合，動作は保証されません。

キー名称
内容
デフォルト値

webserver.context.reload_delay_timeout
リロードの遅延実行機能を使用するかどうかを，-2147483648～2147483647の整数で指定します。

リロードの遅延実行機能を使用し，最大遅延期間（単位：秒）を設定する場合は，1以上の整数で指定します。

リロードの遅延実行機能を使用し，最大遅延期間（単位：秒）を設定しない場合は，負の整数で指定します。

リロードの遅延実行機能を使用しない場合は，0を指定します。

0

webserver.context.reloadable
Webアプリケーションのクラスファイルの更新を自動検知するかどうかを指定します。

trueを指定した場合：

更新を自動検知します。

falseを指定した場合：

更新を自動検知しません。

false

webserver.context.update.interval
更新するファイルのコピーに必要な時間（単位：秒）をインターバルとして指定します。0～2147483647の整数で指定します。
なお，インターバルは余裕のある値にしてください。
リソースの更新を検知してから指定したインターバルのあとに，処理中リクエストの監視を開始します。
0

webserver.jsp.keepgenerated
JSPファイルをコンパイルした結果得られたJavaファイルを保持するかどうかを指定します。

trueを指定した場合：

Javaファイルを保持します。

falseを指定した場合：

Javaファイルを保持しません。

false

webserver.jsp.recompilable
JSPファイルが更新されたときに自動的に再コンパイルするかどうかを指定します。

trueを指定した場合：

自動的に再コンパイルします。

falseを指定した場合：

自動的に再コンパイルしません。

false

webserver.jsp.update.interval
更新するJSPファイルのコピーに必要な時間（単位：秒）をインターバルとして指定します。0～2147483647の整数で指定します。
なお，インターバルは余裕のある値にしてください。
JSPファイルの更新を検知してから指定したインターバルのあとに，JSPの再コンパイルが実行されます。
0

webserver.session.persistence.enabled
リロード時のセッション継続機能を使用するかどうかを指定します。

trueを指定した場合：

セッション継続機能は有効になります。

falseを指定した場合：

セッション継続機能は無効になります。

false

webserver.xml.validate
Webアプリケーションのデプロイメント・ディスクリプタ（web.xmlファイル），およびタグライブラリ・ディスクリプタ（TLDファイル）がDTDで記述されたスキーマに沿って書かれているかチェックするかどうかを指定します。

trueを指定した場合：

チェックします。

falseを指定した場合：

チェックしません。

true

(5)　記述例

webserver.context.reload_delay_timeout=0
webserver.context.reloadable=false
webserver.context.update.interval=0
webserver.jsp.keepgenerated=false
webserver.jsp.recompilable=false
webserver.jsp.update.interval=0
webserver.session.persistence.enabled=true
webserver.xml.validate=true

15.3　usrconf.cfg（Webコンテナサーバ用オプション定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。
（例）　<キー名称> = <値> #<コメント>

実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/

(3)　機能

Webコンテナサーバを実行するJavaVMの起動オプションを指定します。

Webコンテナサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は，次回Webコンテナサーバを起動したときに反映されます。

(4)　指定できるキー

指定できるキーとデフォルト値を次に示します。このキーに不正な値を指定した場合は，動作は保証されません。

ポイント

ここでは，次の内容について説明します。

Webコンテナサーバ用usrconf.cfgファイルで指定できるキーの概要
指定できるキーのうち，J2EEサーバ用usrconf.cfgファイルと共通のキーについては，ここでは詳細を説明しません。
共通のキーの詳細については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。参照する場合には，「J2EEサーバ」，「J2EEアプリケーション」を「Webコンテナサーバ」，「Webアプリケーション」と読み替えてください。
なお，J2EEサーバ用のキーと指定内容が異なる場合には，ここでキーの詳細について説明します。

J2EEサーバ用のキーとの差異（J2EEサーバ用usrconf.cfgファイルのキーと指定内容が異なる場合）
Webコンテナサーバ用のキーとJ2EEサーバ用のキーの指定内容が異なる場合には，キーの詳細について説明します。

表15-2　usrconf.cfgに指定できるキーとデフォルト値（Webコンテナサーバ）

キー名称
J2EEサーバ用usrconf.cfgファイルとの差異
内容
デフォルト値

add.jvm.arg
あり
指定されたオプションを使ってJavaVMを起動します。次のJavaVMのオプションを指定できます。

-D<property>

-verbose:[class|gc|jni]

-Xloggc:<file>

-Xms<size>

-Xmx<size>

-Xmn<size>

-Xss<size>

-Xprof

-Xrunhprof[:help]|[:<option>=<value>, ...]

-Xrun<libraryName>

-Xdebug

-XX:NewRatio=<value>

-XX:PermSize=<value>

-XX:MaxPermSize=<value>

-XX:SurvivorRatio=<value>

-XX:[+|-]PrintTenuringDistribution

-XX:TargetSurvivorRatio=<value>

-XX:MaxTenuringThreshold=<value>

-XX:HitachiJavaLog:[<name>]※2

-XX:HitachiJavaLogFileSize=<size>※2

-XX:[+|-]HitachiJavaLogNoMoreOutput※2

-XX:HitachiJavaLogNumberOfFile=<size>※2

-XX:[+|-]HitachiOutOfMemoryCause※2

-XX:[+|-]HitachiOutOfMemoryStackTrace※2

-XX:HitachiJavaClassLibTraceLineSize=<size>※2

-XX:[+|-]HitachiOutputMilliTime※2

-XX:[+|-]HitachiThreadDump※2

-XX:[+|-]HitachiVerboseGC※1※2

-XX:[+|-]HitachiCommaVerboseGC※2

-XX:HitachiVerboseGCIntervalTime=<time>※2

-XX:[+|-]HitachiVerboseGCPrintCause※2

-XX:[+|-]HitachiVerboseGCPrintDate※2

-XX:[+|-]HitachiFullCore（UNIX用のオプション）※2

-XX:[+|-]HitachiThreadDumpToStdout※2

-XX:[+|-]HitachiOutOfMemorySize※2

-XX:[+|-]HitachiOutOfMemoryAbort※2

-XX:[+|-]HitachiOutOfMemoryAbortThreadDump※2

-XX:[+|-]HitachiJavaClassLibTrace※2

-XX:HitachiJavaClassLibTraceLineSize=<size>※2

-XX:[+|-]HitachiLocalsInThrowable※2※3

-XX:[+|-]HitachiLocalsSimpleFormat※2

-XX:HitachiCallToString=<適用範囲>※2

-XX:[+|-]HitachiTrueTypeInLocals※2

-XX:[+|-]HitachiLocalsInStackTrace※2

-XX:[+|-]HitachiReserveSwapSpace（UNIX用のオプション）※2

システムプロパティを指定したい場合は，"-D"を利用せずに，usrconf.propertiesファイルに指定します。
複数のオプションを指定する場合，同じキー名称を使用して，次のように複数回指定してください。
（指定例）
add.jvm.arg= -Xms128m
add.jvm.arg= -Xmx256m
なお，次のように複数のオプションを指定できません。指定をした場合，JavaVMの初期化に失敗します。
（指定例）
add.jvm.arg=-Xms128m -Xmx256m

-Xms128m

-Xmx256m

-XX:NewRatio=2

-XX:PermSize=64m

-XX:MaxPermSize=64m

-XX:+HitachiOutOfMemoryStackTrace

-XX:HitachiJavaLog:
・Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs
・UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs

-XX:HitachiJavaLogFileSize=4m

-XX:-HitachiThreadDumpToStdout

-XX:+HitachiOutOfMemoryAbort

-XX:+HitachiVerboseGC

-XX:+HitachiVerboseGCPrintCause

-XX:+HitachiOutputMilliTime

-XX:+HitachiJavaClassLibTrace

-XX:HitachiJavaClassLibTraceLineSize=1024

-XX:+HitachiLocalsSimpleFormat

-XX:+HitachiTrueTypeInLocals

-XX:+HitachiLocalsInStackTrace

-XX:+HitachiReserveSwapSpace

cpp.library.version
なし
プロセス内で使用するlibstdc++ライブラリのバージョンを指定します。
5

web.add.class.path
独自
設定されている値をクラスパスに追加します。複数のオプションを指定する場合，同じキー名称を使用して，複数回指定してください。
コンテナ拡張ライブラリを使用する場合は，コンテナ拡張ライブラリ用のJARを指定します。

注意事項

このキーで追加したクラスパスを使用するWebアプリケーションは，J2EE 1.3仕様に従わないアプリケーションになります。将来的にJ2EE環境での実行を予定しているアプリケーションでは，このキーを使用しないで，WARファイルのWEB-INF/lib以下に，Webアプリケーションで使用するすべてのJARファイルを格納してください。

なし

add.library.path
なし
JNI用の共有ライブラリを指定します。コンテナ拡張ライブラリがJNIを利用する場合だけ指定します。
－

web.server.corefilenum（UNIX用）
独自
Webコンテナサーバ再起動時に残すcoreファイルの数を0～16の整数で指定します。なお，このキーは，UNIX用です。
次に示す対象coreファイルのうち，作成日時が新しいのものから指定した数のファイルを残し，それ以外のファイルは削除されます。通常はWebコンテナサーバダウン時に出力するcoreファイル数の1を指定します。

対象coreファイル

/opt/Cosminexus/CC/web/containers/<サーバ名称>/core*

再起動時にすべてのcoreファイルを削除する場合は，0を指定します。

手動による運用またはManagement Serverを使用する場合は，1以上を指定します。

対象coreファイルのうち，上書き，または削除される可能性のあるcoreファイルについては再起動時にリネームされます。

Linux（プロセスID付きの設定）の場合

core.<core生成プロセスID> → core.<core生成プロセスID>.<coreファイル作成日時>

上記以外の場合

core → core.<coreファイル作成日時>

<coreファイル作成日時>の形式は，yymmddHHMMSSです。
なお，coreファイルのリネーム，または削除に失敗した場合はメッセージKDJE40047-Eを出力し，Webコンテナサーバ起動処理を中止して異常終了します。
また，次のことに注意してください。

対象coreファイルと同じ名称のファイルを作成した場合は削除されます。

coreファイルの削除はWebコンテナサーバ再起動時に処理されるため，再起動するまでは定義数以上のcoreファイルが出力されている場合があります。

定義数+n分のcoreファイルが残るためディスク容量に注意してください（n:再起動されるまでにWebコンテナサーバが出力するcoreファイル数）。

1

web.server.log.directory
独自
指定されているディレクトリをログファイル※4の出力先として使用します。パス長は，1～200バイトで指定します。Windowsの場合，UNC名を含むパスは指定できません。UNIXの場合，nfsマウントされたディスク上へのパスは指定できません。
このキーを指定する場合，サーバ開始前にログ出力先ディレクトリを作成してください。存在しないディレクトリが指定された場合は，J2EEサーバまたはWebコンテナサーバ開始時にKDJE40024-Eのメッセージが出力され，異常終了します。
ほかのJ2EEサーバやWebコンテナサーバとログ出力先が，同じディレクトリにならないように注意してください。同じディレクトリを指定した場合，動作は保証されません。
なお，このキーを指定して，デフォルトの出力先以外にログを出力する場合，変更先ディレクトリ下のログファイルはサーバをアンセットアップする時に削除されません。ログファイルを削除したい場合には，手動で削除してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs

web.server.log.stdout.filesize
独自
cjstdout.logファイルのサイズの上限値を4096～2147483647の範囲（単位：バイト）の整数で指定します。
1048576

web.server.log.stderr.filesize
独自
cjstderr.logファイルのサイズの上限値を4096～2147483647の範囲（単位：バイト）の整数で指定します。
1048576

jvm.type
なし
使用するJavaVMのタイプを指定します。
－

（凡例）

あり：

Webコンテナサーバ用usrconf.cfgファイルのキーとJ2EEサーバ用usrconf.cfgファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Webコンテナサーバ用usrconf.cfgファイルとJ2EEサーバ用usrconf.cfgファイルで共通のキーです。キーの詳細については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

独自：

Webコンテナサーバ用usrconf.cfgファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Webコンテナサーバ用usrconf.cfgファイルとJ2EEサーバ用usrconf.cfgファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

注※1

JavaVMの情報およびガーベージコレクションのログに，拡張verbosegc情報を出力するかどうかを指定します。

拡張verbosegc情報を出力する場合，「-XX:+HitachiVerboseGC」を指定してください。拡張verbosegc情報を出力しない場合は，「-XX:-HitachiVerboseGC」を指定してください。なお，デフォルトでは拡張verbosegc情報は出力されます。

拡張verbosegc情報を出力する場合，ガーベージコレクションの内部領域（Eden領域，Survivor領域，Tenured領域，およびPerm領域）の種別ごとに情報を出力します。なお，拡張Verbosegc情報だけを出力したい場合は，クラスライブラリのスタックトレース出力オプションを一時的に出力しないに設定することを推奨します。

JavaVMの情報およびガーベージコレクションのログに出力される拡張verbosegc情報の詳細については，「16.　JavaVM起動オプション」を参照してください。

注※2

JavaVM拡張オプションについては，「16.　JavaVM起動オプション」を参照してください。なお，サポートされるCosminexus Developer's Kit for Javaのバージョンは，OSによって異なります。

注※3

このオプションを有効にした場合，ログファイル（cjweb_exception?.log，user_err?.log）およびデフォルトエラーページなどのスタックトレースにローカル変数名とその内容が出力されます。また，オンライン性能が劣化します。そのため，このオプションはデバッグ時に用いることを推奨します。

注※4

次に示すログファイルが変更の対象になります。

ログの種類
内容
ログ取得ディレクトリおよびログファイル名

メッセージログ
稼働ログ

Windowsの場合
<web.server.log.directoryキーの値>¥cjweb_message?.logs

UNIXの場合
<web.server.log.directoryキーの値>/cjweb_message?.logs

ログ稼働ログ

Windowsの場合
<web.server.log.directoryキーの値>¥cjlogger.log

UNIXの場合
<web.server.log.directoryキーの値>/cjlogger.log

ユーザログ
Webサーブレットログ

Windowsの場合
<web.server.log.directoryキーの値>¥web_servlet?.log

UNIXの場合
<web.server.log.directoryキーの値>/web_servlet?.log

ユーザ出力ログ

Windowsの場合
<web.server.log.directoryキーの値>¥user_out?.log

UNIXの場合
<web.server.log.directoryキーの値>/user_out?.log

ユーザエラーログ

Windowsの場合
<web.server.log.directoryキーの値>¥user_err?.log

UNIXの場合
<web.server.log.directoryキーの値>/user_err?.log

JavaVMの保守情報およびガーベージコレクションのログ

Windowsの場合
<web.server.log.directoryキーの値>¥javalog??.log

UNIXの場合
<web.server.log.directoryキーの値>/javalog??.log

保守用ログ
保守情報

Windowsの場合
<web.server.log.directoryキーの値>¥cjweb_maintenance?.log

UNIXの場合
<web.server.log.directoryキーの値>/cjweb_maintenance?.log

障害発生時の例外情報

Windowsの場合
<web.server.log.directoryキーの値>¥cjweb_exception?.log

UNIXの場合
<web.server.log.directoryキーの値>/cjweb_exception?.log

Webコンテナの保守情報

Windowsの場合
<web.server.log.directoryキーの値>¥cjwebcontainer?.log

UNIXの場合
<web.server.log.directoryキーの値>/cjwebcontainer?.log

終了プロセス情報

Windowsの場合
<web.server.log.directoryキーの値>¥cjweb_shutdown?.log

UNIXの場合
<web.server.log.directoryキーの値>/cjweb_shutdown?.log

起動プロセス標準出力情報

Windowsの場合
<web.server.log.directoryキーの値>¥cjstdout.log

UNIXの場合
<web.server.log.directoryキーの値>/cjstdout.log

起動プロセス標準出力情報バックアップ

Windowsの場合
<web.server.log.directoryキーの値>¥cjstdout_save.log

UNIXの場合
<web.server.log.directoryキーの値>/cjstdout_save.log

起動プロセス標準エラー情報

Windowsの場合
<web.server.log.directoryキーの値>¥cjstderr.log

UNIXの場合
<web.server.log.directoryキーの値>/cjstderr.log

起動プロセス標準エラー情報バックアップ

Windowsの場合
<web.server.log.directoryキーの値>¥cjstderr_save.log

UNIXの場合
<web.server.log.directoryキーの値>/cjstderr_save.log

Webコンテナ保守用トレースログ

Windowsの場合
<web.server.log.directoryキーの値>¥cjweb_access?.log

UNIXの場合
<web.server.log.directoryキーの値>/cjweb_access?.log

TPBrokerのトレース
TPBrokerのトレース情報

Windowsの場合
<web.server.log.directoryキーの値>¥TPB 配下

UNIXの場合
<web.server.log.directoryキーの値>/TPB 配下

(5)　記述例

Windowsの場合

#java vm options
add.jvm.arg=-Xms128m
add.jvm.arg=-Xmx256m
add.jvm.arg=-XX:PermSize=64m
add.jvm.arg=-XX:MaxPermSize=64m
add.jvm.arg=-XX:+HitachiVerboseGC
add.jvm.arg=-XX:HitachiVerboseGCIntervalTime=600

# system classes
web.add.class.path=c:¥mylib¥classes

# ADM service

# web.server.log.directory
web.server.log.directory=c:¥worklogdir

UNIXの場合

#java vm options
add.jvm.arg=-Xms128m
add.jvm.arg=-Xmx256m
add.jvm.arg=-XX:PermSize=64m
add.jvm.arg=-XX:MaxPermSize=64m
add.jvm.arg=-XX:+HitachiVerboseGC
add.jvm.arg=-XX:HitachiVerboseGCIntervalTime=600

# system classes
web.add.class.path=/opt/mylib/classes

# web.server.log.directory
web.server.log.directory=/CClogs/web/servername

# web.server.corefilenum
web.server.corefilenum=3

(6)　注意事項

コマンドプロンプトで設定されているCLASSPATH環境変数は，Webコンテナサーバに渡りませんが，そのほかの環境変数（PATHなど）は渡ります。

OSのロケールと異なる文字エンコーディングで記述しないでください。また，OSのロケールにUTF-8を使用する場合，BOM付きUTF-8では記述しないでください。

usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は，usrconf.propertiesの値が優先されます。

15.4　usrconf.properties（Webコンテナサーバ用ユーザプロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　Webコンテナサーバの予約済みキー

(5)　Webコンテナサーバのカスタマイズ用キー

(6)　記述例

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

#で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。
（例）　<キー名称> = <値> #<コメント>

記載する文字はJavaの仕様に従って，ISO 8859-1 文字エンコーディングを使用してください。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/

(3)　機能

Webコンテナサーバ全体でのシステムプロパティを指定します。なお，Webアプリケーション個別の定義は，WEB-INF/hitachi_web.propertiesで指定します。usrconf.propertiesとWEB-INF/hitachi_web.propertiesで同じキーが指定されている場合は，WEB-INF/hitachi_web.propertiesの値が優先されます。また，usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は，usrconf.propertiesの値が優先されます。

Webコンテナサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は，次回Webコンテナサーバを起動したときに反映されます。

なお，日立のJavaVMは，J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。JDK 5.0で使用できるプロパティについては，Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

(4)　Webコンテナサーバの予約済みキー

usrconf.properties内では，ユーザが独自のキーを新たに定義することもできます。定義されたキーは，java.util.Propertiesクラスを使用することで，Webアプリケーション内で値を取り出せます。ただし，Webコンテナサーバでは，次に示す接頭子で始まるキーを内部的に利用するため，アプリケーションでこれらの接頭子で始まるキーを利用してはいけません。

ejbserver.*

webserver.*

appclient.*

j2eeserver.*

(5)　Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバでは，次に示すシステムプロパティのキーに値を設定することで，Webコンテナサーバの動作をカスタマイズできます。このキーに不正な値を指定した場合，動作は保証されません。

ここでは，キーを次の分類に分けて説明します。

ejbserver.applicationから始まるキー

ejbserver.clientから始まるキー

ejbserver.containerから始まるキー

ejbserver.jndiから始まるキー

ejbserver.jtaから始まるキー

ejbserver.loggerから始まるキー

ejbserver.rmiから始まるキー

ejbserver.serverから始まるキー

javaから始まるキー

vbrokerから始まるキー

webserver.connectorから始まるキー

webserver.containerから始まるキー

webserver.contextから始まるキー

webserver.errorpageから始まるキー

webserver.jspから始まるキー

webserver.sessionから始まるキー

webserver.shutdownから始まるキー

webserver.staticから始まるキー

webserver.workから始まるキー

webserver.xmlから始まるキー

ポイント

ここでは，次の内容について説明します。

Webコンテナサーバ用usrconf.propertiesファイルで指定できるキーの概要
指定できるキーのうち，J2EEサーバ用usrconf.propertiesファイルと共通のキーについては，ここでは詳細を説明しません。
共通のキーの詳細については，「2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。Webコンテナサーバの場合には，「J2EEサーバ」，「J2EEアプリケーション」を「Webコンテナサーバ」，「Webアプリケーション」と読み替えてください。
なお，J2EEサーバ用のキーと指定内容が異なる場合には，ここでキーの詳細についても説明します。

J2EEサーバ用のキーとの差異（J2EEサーバ用usrconf.propertiesファイルのキーと指定内容が異なる場合）
Webコンテナサーバ用のキーとJ2EEサーバ用のキーの指定内容が異なる場合には，キーの詳細について説明します。

Webコンテナサーバ用usrconf.propertiesファイル独自のキーの詳細
Webコンテナサーバ用usrconf.propertiesファイル独自のキーについては，ここでキーの詳細を説明します。

(a)　ejbserver.applicationから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるejbserver.applicationから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(a)　ejbserver.applicationから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.application.InitTermProcessClasses
なし
コンテナ拡張ライブラリを使用する場合に，サーバ起動・停止フックのクラス名を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.appname
なし
AppNameのフィールドに出力するデフォルトのアプリケーション名を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.count
なし
ログファイルの面数を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.encoding
なし
出力する文字列のエンコーディングを指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.filter
なし
使用するフィルタを指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.formatter
なし
使用するフォーマッタを指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.level
なし
ログの取得レベルの上限を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.limit
なし
ログファイルの容量（単位：バイト）を指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.msgid
なし
MsgIDのフィールドに出力するデフォルトのメッセージIDを指定します。
－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.path
あり
ログファイル名のプリフィックスを1～255バイトの範囲で指定します。パスは，相対パスで指定します※2。なお，パス名の終端に，半角数値を指定しないでください。
ここで指定したプリフィックスに"xx（1～16の整数）.log"が付加された値が，トレース情報ファイルの名称になります。
パスに指定された半角英文字の大文字と小文字は区別されません。また，パス値の長さは，次のA+B+Cの値が範囲に収まるよう指定してください。

A（Windowsの場合）：<ログ出力先ルート(web.server.log.directoryの値)>¥user¥（デフォルトは<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥user¥）

A（UNIXの場合）：<ログ出力先ルート(web.server.log.directoryの値)>/user/（デフォルトは/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/user/）

B：ユーザの指定したプリフィックスの長さ

C："xx.log"の6文字

このほか，パスを指定するときには次の点に注意してください。

Propertiesファイルにはnativeの2バイトコードなどは使用できないため，native2asciiなどを利用してUnicodeの文字列を取得して指定してください。

絶対パスで指定しないでください。また，相対パスの"..¥"（UNIXの場合，"../"）は使用しないでください。

パスに日本語文字などを含む場合は，その文字を処理できるロケール設定がされている環境下でJavaVMが動作している必要があります。

パスをほかのハンドラと同一に設定することはできません。そのような設定にした場合，そのハンドラは作成されません。

－

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.separator
なし
CJSimpleFormatterを利用して，1文でメッセージを出力するためのセパレータを指定します。
－

ejbserver.application.userlog.loggers
なし
使用するロガーの名称を指定します。
－

ejbserver.application.userlog.Logger.<ロガー名称>※3.filter
なし
ロガーで使用するフィルタを指定します。
－

ejbserver.application.userlog.Logger.<ロガー名称>※3.handlers
なし
指定のロガー名称に対して接続（addHandler(Handler)）するハンドラクラスを指定します。
－

ejbserver.application.userlog.Logger.<ロガー名称>※3.level
なし
ロガーのログ出力レベルを指定します。
－

ejbserver.application.userlog.Logger.<ロガー名称>※3.useParentHandlers
なし
ログレコードを受け取ったロガーから，親ロガーの接続しているハンドラへログレコードを伝播させるかどうかを指定します。
－

（凡例）

あり：

Webコンテナサーバ用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細ついては，「2.4(5)(a)　ejbserver.applicationから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(a)　ejbserver.applicationから始まるキー」を参照してください。

注

ユーザログ機能についてのプロパティ定義（ejbserver.application.InitTermProcessClassesキー以外）で使用できるそれぞれの文字セットで指定できる値は，次のとおりです。

クラス文字セット（クラス名の定義に使用する文字セット）
半角英数字（a～z，A～Z，0～9），ピリオド（.），ドル記号（$）およびアンダースコア（_）

半角文字セット
半角英数字（a～z，A～Z，0～9），ピリオド（.），ドル記号（$），アンダースコア（_），ハイフン（-），ストローク（|），コロン（:），アンパサンド（&），単価記号（@），シャープ（#）およびパーセント（%）

指定した値が，使用できる文字セットの条件を満たさない，または指定できる値の範囲を満たさない不正な値の場合は，警告メッセージが出力され，その時点で有効なデフォルトの値が採用されます。その時点で有効なデフォルトの値とは，<ハンドラ名称>=defaultの場合のそのキーの値，または「デフォルト値」欄のデフォルト値を指します。

注※1

ハンドラ名称はプロパティの値を区別するために使用します。半角英数字で始まる1～1024バイトのクラス文字セットで指定してください。"default"を指定した場合は，すべてのCJLogHandlerが共通のデフォルト値として認識するプロパティを示します。

注※2

出力先の起点は，次の規則に従ってください。

<web.server.log.directoryの値>¥userまたは<web.server.log.directoryの値>/user

web.server.log.directoryの値は，web.server.log.directoryの仕様に従ってください。Webコンテナサーバのweb.server.log.directoryのデフォルトの値を次に示します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<コンテナサーバ名>¥logs¥user¥<ユーザ指定値>

UNIXの場合

/opt/Cosminexus/CC/web/containers/<コンテナサーバ名>/logs/user/<ユーザ指定値>

注※3

ロガー名称は，Logger.getLogger（<ロガー名称>）でロガーのインスタンスを取得するときに指定する"."付きの名称で，あらかじめ，ejbserver.application.userlog.loggersプロパティで宣言する必要があります。ロガー名称については，java.util.logging.Loggerの仕様に従ってください。

半角英数字で始まる1～1024バイトのクラス文字セットで指定してください。"default"を指定した場合は，すべてのCJLogHandlerが共通のデフォルト値として認識するプロパティを示します。

なお，ロガー名称で識別されるプロパティは，ユーザログ機能のロガークラスの初期化で使用されます。

ロガー名称の最後を.handlersで終了させた場合，ejbserver.application.userlog.Logger.<ロガー名称>.handlersのプロパティ指定時に紛らわしくなるため，ロガー名称は".handlers"で終了させないことを推奨します。

(b)　ejbserver.clientから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるejbserver.clientから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(b)　ejbserver.clientから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
ejbserver.client.ctm.RequestPriority | なし | CTM内のキューに滞留したリクエストを引き出す時のプライオリティ（優先順位）を指定します。 | －

（凡例）

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(b)　ejbserver.clientから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(b)　ejbserver.clientから始まるキー」を参照してください。

(c)　ejbserver.containerから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるejbserver.containerから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(f)　ejbserver.containerから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
ejbserver.container.rebindpolicy | なし | EJBメソッドの呼び出し時に通信障害が発生した場合の，EJBクライアント側でのコネクションの再接続動作とリクエストの再送動作を指定します。 | －

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(f)　ejbserver.containerから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(f)　ejbserver.containerから始まるキー」を参照してください。

(d)　ejbserver.jndiから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるejbserver.jndiから始まるキーを次に示します。Webコンテナサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(p)　ejbserver.jndiから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.jndi.cache
あり
Enterprise Beanを呼び出す場合だけ指定します。
ネーミングでのキャッシングをするかどうかを指定します。
キャッシングをする場合はonを，キャッシングをしない場合はoffを指定します。
－

ejbserver.jndi.cache.interval
あり
Enterprise Beanを呼び出す場合だけ指定します。
ネーミングでのキャッシングをする場合，キャッシュをクリアする間隔（単位：秒）を指定します。
ただし，1～2147483647以外の値を指定した場合，クリアしません。
－

ejbserver.jndi.cache.interval.clear.option
あり
インターバル経過後のネーミングでのキャッシュ領域に対する動作を決定します。

refreshを指定した場合：

キャッシュの全領域をクリアします。

checkを指定した場合：

無効なキャッシュをクリアします。

－

ejbserver.jndi.cache.reference
なし
DataSourceオブジェクトのキャッシング機能を使用するかどうかを指定します。
－

ejbserver.jndi.namingservice.group.list
なし
ラウンドロビン検索をする場合に，検索対象になる論理ネーミングサービスのグループを定義します。
－

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls
なし
各グループに属するネーミングサービスのルート位置を指定します。
－

ejbserver.jndi.request.timeout
なし
ネーミングサービスとの通信タイムアウト時間（単位：秒）を指定します。
－

（凡例）

あり：

Webコンテナサーバ用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(p)　ejbserver.jndiから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(p)　ejbserver.jndiから始まるキー」を参照してください。

(e)　ejbserver.jtaから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるejbserver.jtaから始まるキーを次に示します。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.jta.pooldeffile.scramble.enabled
独自
DDファイルをスクランブル化するかどうかを指定します。

trueを指定した場合：

スクランブル化します。

falseを設定した場合：

スクランブル化しません。

false

（凡例）

独自：

Webコンテナサーバ用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

(f)　ejbserver.loggerから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるejbserver.loggerから始まるキーを次に示します。Webコンテナサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(r)　ejbserver.loggerから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

ejbserver.logger.channels.define.<チャネル名>※.filenum
なし
Webコンテナサーバのログファイルの面数を指定します。

チャネル名がWebAccessLogFileの場合
16

チャネル名がWebExceptionLogFileまたはWebServletLogFileの場合
4

チャネル名が上記以外の場合
2

ejbserver.logger.channels.define.<チャネル名>※.filesize
なし
Webコンテナサーバのログファイルのサイズ（単位：バイト）を指定します。

チャネル名がWebAccessLogFileの場合
2097152

チャネル名がWebExceptionLogFileの場合
12582912

チャネル名がWebServletLogFileの場合
4194304

チャネル名が上記以外の場合
1048576

ejbserver.logger.enabled.*
なし
Webコンテナサーバのログレベルを指定します。
Error

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(r)　ejbserver.loggerから始まるキー」を参照してください。

注※

チャネル名称として次に示す名称を設定できます。

WebMessageLogFile，WebMaintenanceLogFile，WebExceptionLogFile，WebContainerLogFile，WebShutdownLogFile，WebServletLogFile，UserOutLogFile，UserErrLogFile，WebAccessLogFile，CSFLogFile

資料の取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(g)　ejbserver.rmiから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるejbserver.rmiから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(v)　ejbserver.rmiから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
ejbserver.rmi.request.timeout | なし | クライアントとサーバ間の通信タイムアウト時間（単位：秒）を指定します。 | －

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(v)　ejbserver.rmiから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(v)　ejbserver.rmiから始まるキー」を参照してください。

(h)　ejbserver.serverから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるejbserver.serverから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(w)　ejbserver.serverから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
ejbserver.server.prf.PRFID | なし | PRF識別子を指定します。 | －

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(w)　ejbserver.serverから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(w)　ejbserver.serverから始まるキー」を参照してください。

(i)　javaから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるjavaから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(aa)　javaから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

java.naming.factory.initial
なし
JNDIのInitialContextがデレゲートするコンテキストの実装クラスのファクトリクラスを指定します。
－

java.naming.provider.url
独自
Enterprise Beanを呼び出す場合だけ
J2EEサーバ上のEJBコンテナと通信する場合，CORBAネーミングサービスのホスト名称とポート番号を指定します。このCORBAネーミングサービスは，Webコンテナサーバから呼び出されるJ2EEサーバがネーミングサービスとして利用しているものです。
corbaname::localhost:900

（凡例）

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(aa)　javaから始まるキー」を参照してください。

独自：

Webコンテナサーバ用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(aa)　javaから始まるキー」を参照してください。

(j)　vbrokerから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるvbrokerから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(ac)　vbrokerから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

vbroker.orb.htc.comt.entryCount
なし
Cosminexus TPBroker通信トレースファイル1個当たりのエントリ数の上限値を指定します。
－

vbroker.orb.htc.comt.fileCount
なし
Cosminexus TPBroker通信トレースファイルの個数の上限値を指定します。
－

vbroker.orb.htc.tracePath
なし
Cosminexus TPBrokerのトレースファイル出力先のパスを指定します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/TPB/logj

（凡例）

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(ac)　vbrokerから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(ac)　vbrokerから始まるキー」を参照してください。

(k)　webserver.connectorから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.connectorから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(ad)　webserver.connectorから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

webserver.connector.ajp12.backlog
なし
旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.backlogとして使用されます。指定できる値については，webserver.connector.ajp13.backlogキーの説明を参照してください。
このキーとwebserver.connector.ajp13.backlogの両方が指定されていた場合，このキーの値が使用されます。
－

webserver.connector.ajp12.max_threads
なし
旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.max_threadsとして使用されます。指定できる値については，webserver.connector.ajp13.max_threadsキーの説明を参照してください。
このキーとwebserver.connector.ajp13.max_threadsの両方が指定されていた場合，このキーの値が使用されます。
1025以上の値が設定されていた場合，webserver.connector.ajp13.max_threadsのデフォルト値の100が使用されます。
－

webserver.connector.ajp12.port
なし
旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.portとして使用されます。指定できる値については，webserver.connector.ajp13.portキーの説明を参照してください。
このキーとwebserver.connector.ajp13.portの両方が指定されていた場合，このキーの値が使用されます。
－

webserver.connector.ajp13.backlog
なし
リダイレクタからの接続要求の最大の待ち行列数を指定します。※1　
－

webserver.connector.ajp13.bind_host
なし
Webサーバ連携で使用するIPアドレスまたはホスト名称を指定します。
－

webserver.connector.ajp13.max_threads
あり
Webコンテナがリクエストを処理する同時実行数を指定します。※3
1～1024の整数で指定します。
指定されたリクエストの同時実行数分のスレッドがサーバ起動時に生成されます。
－

webserver.connector.ajp13.port
なし
Webサーバとの通信に使用するポート番号を指定します。※4
－

webserver.connector.ajp13.receive_timeout
なし
リクエスト受信処理のリダイレクタへのデータ要求処理で，リダイレクタからの応答を待つ時間（通信タイムアウト値）を指定します。
－

webserver.connector.ajp13.send_timeout
なし
レスポンス送信処理のタイムアウト値を指定します。
－

webserver.connector.http.bind_host
なし
簡易Webサーバで使用するローカルIPアドレス，または解決できるローカルホスト名称を指定します。
－

webserver.connector.http.enabled
独自
簡易Webサーバを使用するかどうかを指定します。

trueを指定した場合：

簡易Webサーバを有効にします。

falseを指定した場合：

簡易Webサーバを無効にします。

新規インストールの場合：
false

バージョンアップインストールの場合：
true

webserver.connector.http.permitted.hosts
なし
簡易Webサーバへのアクセスを許可するホストのIPアドレスまたはホスト名を指定します。
－

webserver.connector.http.port
独自
簡易Webサーバのポート番号を1～65535の整数で指定します。※4
8080

webserver.connector.redirect_https.port
なし
Webサーバが使用しているHTTPSのポート番号を指定します。※4
－

（凡例）

あり：

Webコンテナサーバ用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(ad)　webserver.connectorから始まるキー」を参照してください。

独自：

Webコンテナサーバ用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(ad)　webserver.connectorから始まるキー」を参照してください。

注※1

有効な最大値は実行するプラットフォームで指定できるSocketのListenキューの最大値となります。実際のListenキューの最大値はOSによって異なるため，詳細は各OSのlisten関数についてのマニュアルを参照してください。

注※2

同一ホストで実行しているWebサーバとWebサーバ連携をしている構成の場合に，このプロパティにローカルホスト名称，またはIPアドレスを指定し，リダイレクタのワーカホスト名称にlocalhostなどのループバックアドレスを指定したとき，WebコンテナはWebサーバからのリクエストを受信できません。

注※3

有効な最大値は実行するプラットフォームに依存します。

Webサーバに到着するリクエストの一部がWebコンテナに転送されるため，Webコンテナの同時実行数はWebサーバの最大同時接続数より小さく設定する必要があります。
また，データベース操作をするサーブレットやJSPについては，データベースコネクションの数よりも多くの多重度は得られないため，Webコンテナの同時実行数を増やす場合は，利用できるデータベースコネクションの数も増やす必要があります。
性能のチューニング時には，次に示す関係を常に考慮して，各パラメタの値を調整してください。
<Webサーバの最大同時接続数> ≧ <Webコンテナ単位の最大同時実行スレッド数> ≧ <データベースコネクションの数>
Webサーバでの処理の同時接続数についてはWebサーバのマニュアル，データベースコネクションについてはCosminexus DABroker Libraryのドキュメントを参照してください。

注※4

すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また，複数のWebコンテナサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したWebコンテナサーバはcjstartwebコマンドで複数起動できません。

(l)　webserver.containerから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.containerから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(ae)　webserver.containerから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
webserver.container.ac.logEnabled | なし | Webコンテナの保守用のトレースログを出力するかどうかを指定します。 | －
webserver.container.server_id.enabled | なし | サーバIDのCookieをHTTPレスポンスに付加するかどうかを指定します。 | －
webserver.container.server_id.name | なし | サーバIDのCookieをHTTPレスポンスに付加する場合に，Cookieの名前を指定します。 | －
webserver.container.server_id.value | なし | サーバIDのCookieをHTTPレスポンスに付加する場合に，Cookieの値を指定します。 | Webコンテナを実行するホストのIPアドレスとWebサーバとの通信に使用するポート番号から生成する文字列

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(ae)　webserver.containerから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(ae)　webserver.containerから始まるキー」を参照してください。

(m)　webserver.contextから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.contextから始まるキーを次に示します。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

webserver.context.check_interval
独自
Webアプリケーションの更新検知インターバルを0～2147483647の範囲（単位：秒）の整数で指定します。
0を指定した場合，更新の自動検知は行われません。
Webアプリケーションのリロード機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列，範囲外の数値または空文字列を指定した場合はメッセージを出力し，デフォルト値が設定されます。
0

webserver.context.reload_delay_timeout
独自
Webアプリケーションのリロードの遅延実行機能を使用するかどうかを指定します。
Webアプリケーションのリロード機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。
リロードの遅延実行機能を使用するかどうかは，-2147483648～2147483647の整数で指定します。

リロードの遅延実行機能を使用し，最大遅延期間（単位：秒）を設定する場合は，1以上の整数で指定します。

リロードの遅延実行機能を使用し，最大遅延期間（単位：秒）を設定しない場合は，負の整数を指定します。

リロードの遅延実行機能を使用しない場合は，0を指定します。

0

webserver.context.reloadable
独自
Webアプリケーションのクラスファイルの更新を自動検知するかどうかを指定します。

trueを指定した場合：

更新を自動検知します。

falseを指定した場合：

更新を自動検知しません。

false

webserver.context.update.interval
独自
更新するファイルのコピーに必要な時間のインターバルを0～2147483647の範囲（単位：秒）の整数で指定します。なお，インターバルは余裕のある値にしてください。リソースの更新を検知してから指定したインターバルのあとに，処理中リクエストの監視が開始されます。
Webアプリケーションのリロード機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列や範囲外の数値を指定した場合はメッセージを出力し，デフォルト値が設定されます。
0

（凡例）

独自：

Webコンテナサーバ用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

(n)　webserver.errorpageから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.errorpageから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(ag)　webserver.errorpageから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
webserver.errorpage.stack_trace.enabled | なし | 例外発生時，デフォルトのエラーページにスタックトレースを出力するかどうかを指定します。 | －

（凡例）

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(ag)　webserver.errorpageから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(ag)　webserver.errorpageから始まるキー」を参照してください。

(o)　webserver.jspから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.jspから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(ai)　webserver.jspから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

webserver.jsp.check_interval
なし
JSPの更新検知インターバルを0～2147483647の範囲（単位：秒）の整数で指定します。
0を指定した場合，更新の自動検知は行われません。
1

webserver.jsp.compile.backcompat
なし
JSPから生成されたサーブレットのjavaソースのコンパイル時に，javaソースコードのバージョンを指定します。
－

webserver.jsp.keepgenerated
あり
JSPファイルのコンパイルで生成されたjavaファイルを保持するかどうかを指定します。
次の値を指定します。

trueを指定した場合：

javaファイルを保持します。

falseを指定した場合：

javaファイルを保持しません。

－

webserver.jsp.recompilable
独自
JSPファイルが更新されたときに自動的に再コンパイルするかどうかを指定します。

trueを指定した場合：

自動的に再コンパイルします。

falseを指定した場合：

自動的に再コンパイルしません。

false

webserver.jsp.translation.backcompat.customAction.declareVariable
なし
複数のカスタムタグで，スクリプト変数名とスクリプト変数のスコープが重複する場合，JSPファイルから生成されたJavaコードで2回目のカスタムタグに対応するスクリプト変数の変数宣言を出力するかどうかを指定します。
－

webserver.jsp.translation.backcompat.taglib.noCheckPrefix
なし
taglibディレクティブの前に，taglibディレクティブで指定したprefixを使用したカスタムタグを記述しているかチェックするかどうかを指定します。
－

webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue
なし
Expressionが指定できないタグの属性値にExpressionが指定されているかどうか検証するかどうかを指定します。
－

webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate
なし
タグの属性値が，「"<%=」（または「'<%=」）で開始しており，「%>"」(「'<%」で開始した場合は「%>'」)で終了していない属性値の「"」(または「'」) で囲まれた値を文字列として扱うかどうかを指定します。
－

webserver.jsp.translation.backcompat.useBean.noCheckClass
なし
JSPトランスレーション時に<jsp:useBean>タグのクラス属性値のチェック処理を実行するかどうかを指定します。
－

webserver.jsp.update.interval
独自
JSPのリロード監視対象ファイルのコピーに必要な時間のインターバルを0～2147483647の範囲（単位：秒）の整数で指定します。
なお，インターバルは余裕のある値にしてください。JSPファイルの更新を検知してから指定したインターバルのあとに，JSPの再コンパイルが実行されます。
JSPの再コンパイル機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列や範囲外の数値を指定した場合はメッセージを出力し，デフォルト値が設定されます。
0

（凡例）

あり：

Webコンテナサーバ用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(ai)　webserver.jspから始まるキー」を参照してください。

独自：

Webコンテナサーバ用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(ai)　webserver.jspから始まるキー」を参照してください。

(p)　webserver.sessionから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.sessionから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(ak)　webserver.sessionから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

webserver.session.persistence.enabled
独自
リロード時のセッション継続機能を使用するかどうかを指定します。

trueを指定した場合：

セッション継続機能は有効になります。

falseを指定した場合：

セッション継続機能は無効になります。

Webアプリケーションのリロード機能が無効の場合，このプロパティは設定できません。設定した場合無視されます。なお，このプロパティはサーブレットエンジンモードでだけ有効です。
false

webserver.session.server_id.enabled
なし
セッションIDにサーバIDを付加するかどうかを指定します。
－

webserver.session.server_id.value
なし
セッションIDに付加するサーバIDを指定します。
Webコンテナを実行するホストのIPアドレスとWebサーバとの通信に使用するポート番号から生成する文字列

webserver.session.work.directory
独自
セッション情報ファイルの出力先ディレクトリを絶対パスで指定します。
指定したディレクトリにはWebアプリケーション単位にコンテキストルート名のディレクトリを作成し，作成したディレクトリ下にセッション情報ファイルを作成します。
作成したセッション情報ファイルは，リロード処理完了後に削除されます。webserver.session.work.clean=falseが設定されている場合は削除されません。
このプロパティを設定する場合，サーバ単位で出力先が重複しないように注意してください。
リロード時のセッション継続機能が無効の場合，このプロパティは設定できません。なお，このプロパティはサーブレットエンジンモードでだけ有効です。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥work

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/work

（凡例）

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(ak)　webserver.sessionから始まるキー」を参照してください。

独自：

Webコンテナサーバ用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(ak)　webserver.sessionから始まるキー」を参照してください。

(q)　webserver.shutdownから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.shutdownから始まるキーを次に示します。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

webserver.shutdown.port
独自
Webコンテナが終了用のメッセージを受信するために使用するポートを指定します。※
1～65535の整数で指定します。
8005

（凡例）

独自：

Webコンテナサーバ用usrconf.propertiesファイル固有のキーです。キーの詳細については，「内容」の列を参照してください。

注※

すでにほかのアプリケーションで使用，または確保されているポート番号は指定できません。また，複数のWebコンテナサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したWebコンテナサーバはcjstartwebコマンドで複数起動できません。

(r)　webserver.staticから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.staticから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(am)　webserver.staticから始まるキー」を参照してください。

キー名称 | J2EEサーバ用usrconf.propertiesファイルとの差異 | 内容 | デフォルト値
webserver.static_content.cache.enabled | なし | 静的コンテンツキャッシュ機能の有効／無効／強制的な無効を指定します。 | －
webserver.static_content.cache.size | なし | 静的コンテンツキャッシュ機能が有効な場合，メモリにキャッシュできるサイズ（単位：バイト）の上限を指定します。 | －
webserver.static_content.cache.filesize.threshold | なし | 静的コンテンツキャッシュ機能が有効な場合，キャッシュできるファイルサイズ（単位：バイト）を指定します。 | －

（凡例）

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(am)　webserver.staticから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(am)　webserver.staticから始まるキー」を参照してください。

(s)　webserver.workから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.workから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(an)　webserver.workから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

webserver.work.clean
なし
JSP用テンポラリディレクトリ下に生成したディレクトリをサーバ起動時，および終了時に削除するかどうかを指定します。
－

webserver.work.directory
あり
JSP用一時ディレクトリを指定します。絶対パスによるディレクトリ名を指定します。※

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥work

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/work

（凡例）

なし：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のキーです。キーの詳細については，「2.4(5)(an)　webserver.workから始まるキー」を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(an)　webserver.workから始まるキー」を参照してください。

注※

ディレクトリのパスの区切り記号には，"/"を使用してください。例えば，workディレクトリとしてC:¥temp¥workを設定する場合，次のように指定します。

webserver.work.directory=c:/temp/work

また，使用するOSによってファイル名長に制限があります。Windowsでは250バイト程度となっています。このため，ディレクトリ階層の深い場所でサーブレットやJSPを実行できません。特にJSPファイルから生成されるファイル名はWebアプリケーションで配置されたディレクトリ階層の深さに比例して長くなり，JSPファイルに対するJavaファイルを生成できないことがあります。これを回避するためにはWebアプリケーションの配置ディレクトリの階層を浅くしたり，プロパティwebserver.work.directoryに絶対パスで浅いディレクトリ階層を指定したりすることで回避してください。Cosminexusの作業ディレクトリについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(t)　webserver.xmlから始まるキー

Webコンテナサーバ用usrconf.propertiesファイルで指定できるwebserver.xmlから始まるキーを次に示します。J2EEサーバ用usrconf.propertiesファイルと共通のキーの詳細については，「2.4(5)(ao)　webserver.xmlから始まるキー」を参照してください。

キー名称
J2EEサーバ用usrconf.propertiesファイルとの差異
内容
デフォルト値

webserver.xml.validate
あり
Servlet 2.2，およびServlet 2.3のWebアプリケーションについて，デプロイメント・ディスクリプタ（web.xmlファイル），およびタグライブラリ・ディスクリプタ（TLDファイル）が，DTDで記述されたスキーマに沿って記述されているかチェックするかどうかを指定します。
次の値を指定します。

trueを指定した場合：

サーブレットエンジンモードのときは，Webアプリケーションのデプロイメント・ディスクリプタ（web.xmlファイル），およびタグライブラリ・ディスクリプタ（TLDファイル）がDTDで記述されたスキーマに沿って書かれているかどうかをチェックします。

falseを指定した場合：

チェックしません。

－

（凡例）

あり：

Webコンテナサーバ用usrconf.propertiesファイルのキーとJ2EEサーバ用usrconf.propertiesファイルのキーに差異があります。詳細については，「内容」の列を参照してください。

－：

Webコンテナサーバ用usrconf.propertiesファイルとJ2EEサーバ用usrconf.propertiesファイルで共通のデフォルト値です。デフォルト値の詳細については，「2.4(5)(ao)　webserver.xmlから始まるキー」を参照してください。

(6)　記述例

ejbserver.logger.enabled.*=Error,Warning,Information,Debug
ejbserver.logger.channels.define.WebMessageLogFile.filenum=2
ejbserver.logger.channels.define.WebMessageLogFile.filesize=1048576

ejbserver.application.InitTermProcessClasses=InitTermClass1,InitTermClass2

webserver.connector.http.enabled=false
webserver.connector.http.port=8080
webserver.shutdown.port=8005
webserver.connector.ajp13.port=8007
webserver.connector.ajp13.max_threads=10
webserver.connector.ajp13.backlog=100
webserver.connector.ajp13.receive_timeout=600
webserver.work.directory=c:/work

15.5　web-users.xml（ユーザ認証情報定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　指定できる属性

(5)　記述例

(1)　形式

XML1.0形式です。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/

(3)　機能

各ユーザのユーザ名，パスワード，および所属するロールを記述します。このファイルに不正な値を設定した場合，動作は保証されません。

(4)　指定できる属性

属性の指定形式

<web-users>
 <user name="ユーザ名" password="パスワード" roles="ロール名"/>
 <user name=・・・/>
</web-users>

属性の説明

name

ユーザのログイン名を記述します。

password

ユーザのパスワードを記述します。

roles

ユーザの所属するロールを記述します。コンマで区切ることで，複数のロールを定義できます。

(5)　記述例

<web-users>
 <user name="admin" password="admin" roles="admin"/>
</web-users>

15.6　web.policy（SecurityManager定義ファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　記述例

(5)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/

(3)　機能

SecurityManagerを設定します。SecurityManager設定ファイルによって，Java 2から導入されたセキュリティポリシーに基づくWebコンテナの実行時保護をします。例えば，次に示す現象を防止します。

内部でSystem.exit()などを発行するような，不正なサーブレット，JSPによって，Webコンテナ全体が勝手に終了する。

システムプロパティなどを勝手に書き替えるような，不正なサーブレット，JSPによって，Webコンテナの実行に不具合が生じる。

なお，cjstartwebコマンドに，-securityオプションを付けることで，Webコンテナ実行時保護機能が有効になります。また，このファイルに不正な値を設定した場合，動作は保証されません。

Webコンテナサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は，次回Webコンテナサーバを起動したときに反映されます。

(4)　記述例

使用されるポリシーファイルの内容を次に示します。

// (1)
// Grant all permissions to the java extensions
grant codeBase "file:${java.home}/lib/ext/-" {
permission java.security.AllPermission;
};

// (2)
// Grant all permissions to the java tools, etc
// Note: java.home is the jre, not the installation dir for the jdk
grant codeBase "file:${java.home}/../lib/*" {
permission java.security.AllPermission;
};

// (3)
// Grant all permissions to anything loaded from the
// EJB server itself
grant codeBase "file:${ejbserver.install.root}/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${tpbroker.java.home}/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/DABJ/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/manager/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/c4web/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/c4web/exlib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/jaxp/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/CTM/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/PRF/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/wss/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${cosminexus.home}/XMLSEC/lib/*" {
permission java.security.AllPermission;
};
grant codeBase "file:${program.files.home}/Hitachi/HNTRLib2/classes/*" {
permission java.security.AllPermission;
};

// (4)
// webapp policy
grant codeBase "file:${webserver.install.root}/containers/${webserver.serverName}
/webapps/-" {
permission java.lang.RuntimePermission "loadLibrary.*";
permission java.lang.RuntimePermission "queuePrintJob";
permission java.net.SocketPermission "*", "connect";
permission java.io.FilePermission "<<ALL FILES>>", "read, write";
permission java.util.PropertyPermission "*", "read";
};

// (5)
// Grant minimal permissions to everything else:
grant  {
permission java.util.PropertyPermission "*", "read";
permission java.lang.RuntimePermission "queuePrintJob";
permission java.net.SocketPermission "*", "connect";
};

記述例の（1）～（5）について説明します。

（1）

JDKのextディレクトリ下のクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（2）

JDKのlibディレクトリ下のクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（3）

Webコンテナサーバが使用するクラスファイルに対して次の権限を許可します。

すべてのアクセス権を許可

（4）

Webアプリケーションのクラスファイルに対して次の権限を許可します。

すべてのライブラリのロードを許可

印刷ジョブ要求を許可

すべてのソケット通信に対してネットワーク接続を許可

すべてのファイルに対し読み取り，および書き込みを許可

すべてのプロパティ情報の読み取りを許可

（5）

すべてのクラスファイルに対して次の権限を許可します。

すべてのプロパティ情報の読み取りを許可

印刷ジョブ要求を許可

すべてのソケット通信に対してネットワーク接続を許可

(5)　注意事項

サーバをセットアップするときに生成されたweb.policyファイルには，Webコンテナサーバを動作させるために最低限必要な権限が記述されています。生成されたweb.policyファイルの記述行の削除および変更はしないでください。

16.　JavaVM起動オプション

この章では，JavaVM起動オプションについて説明します。

CosminexusではJavaVM起動オプションとして，Java HotSpot VM のオプションのほか，日立固有のJavaVM拡張オプションを指定できます。

ここでは，日立固有のJavaVM拡張オプションの詳細について説明します。また，Java HotSpot VMのオプションのCosminexusでのデフォルト値についても説明します。

＜この章の構成＞

16.1　日立固有のJavaVM拡張オプションの一覧

16.2　日立固有のJavaVM拡張オプションの詳細

16.3　Java HotSpot VMのオプションのCosminexusでのデフォルト値

16.1　日立固有のJavaVM拡張オプションの一覧

日立固有のJavaVM拡張オプションの一覧を，次の表に示します。これらのオプションは，オプション定義ファイルで指定できます。

表16-1　日立固有のJavaVM拡張オプションの一覧

分類
オプション名称
概要

一覧表示オプション
-XX:+Hitachi
日立JavaVM拡張オプションの一覧を表示します。

拡張スレッドダンプ機能オプション
-XX:[+|-]HitachiThreadDump
拡張スレッドダンプ情報を出力するかどうかを指定します。

-XX:[+|-]HitachiThreadDumpToStdout
標準出力にスレッドダンプを出力するかどうかを指定します。

-XX:[+|-]HitachiThreadDumpWithHashCode
スレッド情報にハッシュコードを出力するかどうかを指定します。

-XX:[+|-]HitachiThreadDumpWithCpuTime
スレッド情報にユーザCPU時間とカーネルCPU時間を出力するかどうかを指定します。
HP-UXの場合，この機能は使用できません。オプションを指定しても無視されます。

-XX:[+|-]HitachiThreadDumpWithBlockCount
スレッド情報に処理をブロックした回数と待ち状態になった回数を出力するかどうかを指定します。

日立JavaVMログファイルオプション
-XX:HitachiJavaLog※1
ログファイル名のプリフィックスを指定します。

-XX:HitachiJavaLogFileSize※1
1ファイルの最大ファイルサイズを指定します。

-XX:[+|-]HitachiJavaLogNoMoreOutput※1
ログファイル作成時に，入出力エラーが発生した場合の動作について指定します。

-XX:HitachiJavaLogNumberOfFile※1
作成するログファイルの最大ファイル数を指定します。

詳細時間出力オプション
-XX:[+|-]HitachiOutputMilliTime
ミリ秒までの時間を出力するかどうかを指定します。

拡張verbosegc機能オプション
-XX:[+|-]HitachiVerboseGC※2
ガーベージコレクションが発生した時の拡張verbosegc情報を出力するかどうかを指定します。

-XX:[+|-]HitachiCommaVerboseGC
拡張verbosegc情報をCSV形式で出力するかどうかを指定します。

-XX:HitachiVerboseGCIntervalTime
拡張verbosegc情報を出力する時間の間隔を指定します。

-XX:[+|-]HitachiVerboseGCPrintCause
ガーベージコレクションの要因内容を出力するかどうかを指定します。

-XX:[+|-]HitachiVerboseGCPrintDate
拡張verbosegc情報に日付を出力するかどうかを指定します。

-XX:[+|-]HitachiVerboseGCCpuTime
ガーベージコレクションのプロセッサ時間を出力するかどうかを指定します。
HP-UXの場合，この機能は使用できません。オプションを指定しても無視されます。

OutOfMemoryError発生時の拡張機能オプション
-XX:[+|-]HitachiOutOfMemoryCause※2
OutOfMemoryError発生時の発生要因種別を出力するかどうかを指定します。

-XX:[+|-]HitachiOutOfMemoryStackTrace※2
OutOfMemoryError発生時のスタックトレースを出力するかどうかを指定します。

-XX:HitachiOutOfMemoryStackTraceLineSize
OutOfMemoryError発生時に出力するスタックトレースの１行の文字数を指定します。

-XX:[+|-]HitachiOutOfMemorySize※2
OutOfMemoryError発生時に要求したメモリのサイズを出力します。

-XX:[+|-]HitachiOutOfMemoryAbort
OutOfMemoryError発生時，メッセージとメモリダンプを出力して強制終了するかどうかを指定します。

-XX:[+|-]HitachiOutOfMemoryAbortThreadDump
OutOfMemoryError発生時にスレッドダンプを出力かどうかを指定します。

クラスライブラリトレース機能オプション
-XX:[+|-]HitachiJavaClassLibTrace※2
クラスライブラリのスタックトレースを出力するかどうかを指定します。

-XX:HitachiJavaClassLibTraceLineSize
クラスライブラリのスタックトレースの１行の文字数を指定します。

ローカル変数情報出力機能オプション
-XX:[+|-]HitachiLocalsInThrowable
例外発生時のスタックトレースに，ローカル変数情報を出力するかどうかを指定します。

-XX:[+|-]HitachiLocalsInStackTrace
スレッドダンプ出力時のスタックトレースに，ローカル変数情報を出力するかどうかを指定します。

-XX:[+|-]HitachiLocalsSimpleFormat
ローカル変数情報出力を，簡易フォーマットにするかどうかを指定します。

-XX:[+|-]HitachiTrueTypeInLocals
ローカル変数情報出力時に，ローカル変数オブジェクトの実際の型名を文字列として出力するかどうかを指定します。

-XX:HitachiCallToString
ローカル変数情報出力時に，ローカル変数オブジェクトの変数値を文字列として出力するかどうかを指定します。

システムリソース解除オプション
-XX:[+|-]HitachiFullCore
システムリソースRLIMIT_COREの設定を変更するかどうかを指定します。
このオプションはUNIX用です。

スワップ領域の予約オプション
-XX:[+|-]HitachiReserveSwapSpace
JavaVMの実行に必要となる最大のスワップ領域を，JavaVMの起動時に予約するかどうかを指定します。
このオプションはHP-UX用です。

注※1

日立JavaVMログファイルについての設定です。

注※2

次のオプションを指定した場合，日立JavaVMログファイルが出力されます。

-XX:+HitachiOutOfMemoryStackTrace

-XX:+HitachiOutOfMemoryCause

-XX:+HitachiOutOfMemorySize

-XX:+HitachiVerboseGC

-XX:+HitachiJavaClassLibTrace

オプション定義ファイルの指定方法については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」，「12.2　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）」，または「15.3　usrconf.cfg（Webコンテナサーバ用オプション定義ファイル）」を参照してください。

16.2　日立固有のJavaVM拡張オプションの詳細

日立固有のJavaVM拡張オプションの詳細について説明します。

なお，本文中では，次のJavaプログラムを例として使用しています。

Javaプログラム例1

class Example1 {
   public static void main(String[] args) {
       Example1 e1 = new Example1();
       Object obj = new Object();
       e1.method(1, 'Q', obj);  // 5行目
   }

   void method(int l1, char l2, Object l3) {
       float l4 = 4.0f;
       boolean l5 = true;
       double l6 = Double.MAX_VALUE; // double型の最大値
       Object[] l7 = new Object[10];

       try {
         <例外発生!>  // 15行目
       } catch (Exception e) {
         e.printStackTrace();
       }
   }
}

Javaプログラム例2

class Example2 {
   public static void main(String[] args) {
       Example2 e2 = new Example2();
       e2.method();  // 4行目
   }

   synchronized void method() {
       int l1 = 1;
       float l2 = 2.0f;
       String l3 = “local 3”;
       Character l4 = new Character('X');
       Object l5 = new Thread();
       Object[] l6 = new Thread[10];

       <ここでスレッドダンプ出力!>  // 15行目
   }
}

Javaプログラム例3

class Example3 {
   public static void main(String[] args) {
       Example3 e3 = new Example3();
       e3.method();  // 4行目
   }

   void method() {
       String l1 = “local 1”;
       StringBuffer l2 = new StringBuffer(l1);
       l2.append(“ + local 2”);
       Boolean l3 = new Boolean(false);
       Character l4 = new Character('X');
       Long l5 = new Long(Long.MIN_VALUE);  // long型の最小値
       Object l6 = new Thread();
       Object[] l7 = new Thread[10];

       try {
         <例外発生!>  // 18行目
       } catch (Exception e) {
         e.printStackTrace();
       }
   }

   public String toString() {
       return "I am an Example3 instance.";
   }
}

＜この節の構成＞

-XX:+Hitachi（一覧表示オプション）

-XX:[+|-]HitachiThreadDump（拡張スレッドダンプ情報出力オプション）

-XX:[+|-]HitachiThreadDumpToStdout（拡張スレッドダンプ標準出力抑止オプション）

-XX:[+|-]HitachiThreadDumpWithHashCode（拡張スレッドダンプハッシュコード出力オプション）

-XX:[+|-]HitachiThreadDumpWithCpuTime（拡張スレッドダンプCPU利用時間出力オプション）

-XX:[+|-]HitachiThreadDumpWithBlockCount（拡張スレッドダンプブロック回数出力オプション）

-XX:HitachiJavaLog（ログファイル名のプリフィックス指定オプション）

-XX:HitachiJavaLogFileSize（最大ログファイルサイズ指定オプション）

-XX:[+|-]HitachiJavaLogNoMoreOutput（ログファイル入出力エラー発生時指定オプション）

-XX:HitachiJavaLogNumberOfFile（最大ログファイル数指定オプション）

-XX:[+|-]HitachiOutputMilliTime（詳細時間出力オプション）

-XX:[+|-]HitachiVerboseGC（拡張verbosegc情報出力オプション）

-XX:[+|-]HitachiCommaVerboseGC（CSV出力オプション）

-XX:HitachiVerboseGCIntervalTime（拡張verbosegc情報出力間隔指定オプション）

-XX:[+|-]HitachiVerboseGCPrintCause（ガーベージコレクション要因内容出力オプション）

-XX:[+|-]HitachiVerboseGCPrintDate（拡張verbosegc情報日付出力オプション）

-XX:[+|-]HitachiVerboseGCCpuTime（拡張verbosegc情報CPU利用時間出力オプション）

-XX:[+|-]HitachiOutOfMemoryCause（例外発生要因種別出力オプション）

-XX:[+|-]HitachiOutOfMemoryStackTrace（スタックトレース出力オプション）

-XX:HitachiOutOfMemoryStackTraceLineSize（スタックトレース行サイズ指定オプション）

-XX:[+|-]HitachiOutOfMemorySize（メモリサイズ出力オプション）

-XX:[+|-]HitachiOutOfMemoryAbort（強制終了オプション）

-XX:[+|-]HitachiOutOfMemoryAbortThreadDump（スレッドダンプ出力オプション）

-XX:[+|-]HitachiJavaClassLibTrace（クラスライブラリのスタックトレース出力オプション）

-XX:HitachiJavaClassLibTraceLineSize（クラスライブラリのスタックトレース行サイズ指定オプション）

-XX:[+|-]HitachiLocalsInThrowable（例外発生時のローカル変数情報収集オプション）

-XX:[+|-]HitachiLocalsInStackTrace（スレッドダンプ出力時のローカル変数出力オプション）

-XX:[+|-]HitachiLocalsSimpleFormat（ローカル変数情報の出力フォーマット変更オプション）

-XX:[+|-]HitachiTrueTypeInLocals（ローカル変数情報の実型名出力オプション）

-XX:HitachiCallToString（ローカル変数情報出力オプション）

-XX:[+|-]HitachiFullCore（システムリソース解除オプション）

-XX:[+|-]HitachiReserveSwapSpace（スワップ領域の予約オプション）

-XX:+Hitachi（一覧表示オプション）

形式

-XX:+Hitachi

説明

日立JavaVM拡張オプションを一覧表示します。

このオプションは，Javaプログラムを実行しません。また，J2EEサーバの起動オプションに指定した場合，J2EEサーバは起動されません。

-XX:[+|-]HitachiThreadDump（拡張スレッドダンプ情報出力オプション）

形式

-XX:+HitachiThreadDump

-Xrsオプションが指定されていない場合，スレッドダンプ出力時に拡張スレッドダンプ情報を出力します。

-XX:-HitachiThreadDump

スレッドダンプ出力時に標準のスレッドダンプ情報を出力します。

説明

拡張スレッドダンプ情報を出力するかどうかを指定します。

スレッドダンプは，標準出力および，次に示すファイルに出力されます。

デフォルト値

-XX:+HitachiThreadDump

スレッドダンプ出力先

デフォルトでは，JavaVM実行時のカレントディレクトリです。環境変数JAVACOREDIRを指定することで，出力先を変更することができます。

スレッドダンプ出力ファイル名

javacore<プロセス番号>.<YYMMDDhhmmss>※.txt

注※

YY：年（西暦で下2けた），MM：月（2けた），DD：日（2けた）

hh：時間（24時間表記），mm：分（2けた），ss：秒（2けた）

スレッドダンプ情報の構成を，次に示します。

表16-2　スレッドダンプ情報の構成

出力情報
内容

ヘッダ
スレッドダンプを開始した日付および時刻，JavaVMバージョン情報，起動コマンドラインを出力します。

システム設定
次の情報を出力します。

JDKの実行環境のインストールディレクトリ

JDKを構成するライブラリのインストールディレクトリ

システムクラスパス

Javaコマンドオプション

動作環境
次の情報を出力します。

ホスト名

OSバージョン

CPU情報

リソース情報（UNIXの場合だけ）

メモリ情報
Windowsの場合，次の情報を出力します。

メモリ使用状況

物理メモリ使用状況

仮想メモリ使用状況

ページング使用量

Javaヒープ情報
Javaヒープの各世代のメモリ使用状況を出力します。

JavaVM内部メモリマップ情報
JavaVM自身の確保しているメモリの領域情報を出力します。

JavaVM内部メモリサイズ情報
JavaVM自身の確保しているメモリのサイズ情報を出力します。

アプリケーション情報
次の情報を出力します。

シグナルハンドラ

環境変数

カレントディレクトリ情報

ライブラリ情報
ローディングされているライブラリの情報を出力します。

スレッド情報
<スレッド1>
:
<スレッドn>
スレッドごとにスレッド情報を出力します。現存する全スレッドのスタックトレースを出力します。

Javaモニタダンプ
Javaモニタオブジェクトの一覧を表示します。スレッド間の排他待ちの状況を確認できます。

Rawモニタダンプ
Java内部で使われるモニタ情報の一覧を出力します。

フッタ
スレッドダンプを終了した日付および時刻を出力します。

出力形式

ヘッダ

EEE MMM dd hh:mm:ss yyyy※

Full thread dump Java HotSpot(TM) Client VM (1.5.0_05-b05-CDK0700-<ビルド日> mixed mode)
<起動コマンドライン>
…

注※

EEEは曜日，MMMは月，ddは日を表します。また，hhは時間，mmは分，ssは秒，yyyyは年（西暦）を表します。

システム設定

System Properties
-----------------
Java Home Dir  : <JDK実行環境インストールディレクトリ>
Java DLL Dir   : <JDKを構成するライブラリのインストールディレクトリ>
Sys Classpath  : <システムクラスパス>
User Args      :
<Javaコマンドオプション1>
<Javaコマンドオプション2>
…

動作環境（Windowsの場合）

Operating Environment
---------------------
Host    : <ホスト名>:<IPアドレス>
OS      : <OSバージョン>
CPU     : <CPU種別>, <利用可能CPU数/システム全体のCPU数>

動作環境（UNIXの場合）

Operating Environment
---------------------
Host    : <ホスト名>:<IPアドレス>
OS      : <OSバージョン>
CPU     : <CPU種別>, <利用可能CPU数/システム全体のCPU数>

Resource Limits -
        RLIMIT_CPU     :<プロセスで使用可能な秒数>
        RLIMIT_FSIZE   :<最大ファイルサイズ(単位：バイト)>
        RLIMIT_DATA    :<malloc可能なサイズ(単位：バイト)>
        RLIMIT_STACK   :<スタックの最大サイズ(単位：バイト)>
        RLIMIT_CORE    :<coreの最大サイズ(単位：バイト)>
        RLIMIT_RSS     :<プロセスの常駐サイズ(単位：バイト)>
        RLIMIT_AS      :<プロセストータルの利用可能メモリ(単位：バイト)>
        RLIMIT_NOFILE  :<最大のファイルディスクリプタ値>

メモリ情報（Windowsの場合）

Memory Status
-------------
 Memory in use   : <メモリ使用状況(単位：パーセント)>
 Physical memory : <物理メモリ使用量>※ free
 Virtual memory  : <仮想メモリ使用量>※ free
 Paging file     : <ページング使用量>※ free

注※

<利用可能サイズ>/<総サイズ> の形式で表示されます（単位：バイト）。

Javaヒープ情報

Heap Status
-----------
def new generation   max <最大の容量>, total <現在の容量>, used <使用中メモリ> (<最大の容量に対する使用率>% used/max, <現在の容量に対する使用率>% used/total)
                    [<領域先頭アドレス>, <コミット済み領域の末尾アドレス>, <予約済み領域の末尾アドレス>)
 eden space <現在の容量>,  <使用率>% used [<領域先頭アドレス>, <使用中領域の先頭アドレス>, <予約済み領域の末尾アドレス>)
 from space <現在の容量>,   <使用率>% used [<領域先頭アドレス>, <使用中領域の先頭アドレス>, <予約済み領域の末尾アドレス>)
 to   space <現在の容量>,   <使用率>% used [<領域先頭アドレス>, <使用中領域の先頭アドレス>, <予約済み領域の末尾アドレス>)
tenured generation   max <最大の容量>, total <現在の容量>, used <使用中メモリ> (<最大の容量に対する使用率>% used/max, <現在の容量に対する使用率>% used/total)
                     [<領域先頭アドレス>, <コミット済み領域の末尾アドレス>, <予約済み領域の末尾アドレス>)
  the space <現在の容量>,  <使用率>% used [<領域先頭アドレス>, <使用中領域の先頭アドレス>, <次の空きブロックの先頭アドレス>, <予約済み領域の末尾アドレス>)
compacting perm gen  max <最大の容量>, total <現在の容量>, used <使用中メモリ> (<最大の容量に対する使用率>% used/max, <現在の容量に対する使用率>% used/total)
                     [<領域先頭アドレス>, <コミット済み領域の末尾アドレス>, <予約済み領域の末尾アドレス>)
  the space <現在の容量>,  <使用率>% used [<領域先頭アドレス>, <使用中領域の先頭アドレス>, <次の空きブロックの先頭アドレス>, <予約済み領域の末尾アドレス>)

注

容量およびメモリサイズの単位はキロバイトです。

JavaVM内部メモリマップ情報

JVM Internal Memory Map
-----------------------
<メモリ確保関数>:address = <開始アドレス> - <終了アドレス> (size:<サイズ>)

注

<メモリ確保関数>：mmap()かmalloc()のどちらかが出力されます。

<開始アドレス>：メモリ領域の開始アドレスが16進で出力されます。

<終了アドレス>：メモリ領域の終了アドレスが16進で出力されます。

<サイズ>：確保しているメモリ領域のサイズが出力されます（単位：バイト）。

JavaVM内部メモリサイズ情報

JVM Internal Memory Status
--------------------------
 Heap Size      :<確保しているメモリサイズ>※
 Alloc Size     :<使用中のメモリサイズ>※
 Free Size      :<未使用のメモリサイズ>※

注※

単位：バイト

アプリケーション情報（Windowsの場合）

Application Environment
-----------------------
Signal Handlers -
 SIGINT         :<シグナルハンドラ情報>
 SIGILL         :<シグナルハンドラ情報>
…
 SIGBREAK       :<シグナルハンドラ情報>
 SIGABRT        :<シグナルハンドラ情報>

Environment Variables -
<環境変数>=<値>
…
Cueeent Directory -

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥…

アプリケーション環境（UNIXの場合）

Application Environment
-----------------------
Signal Handlers -※¹
 SIGHUP         :<シグナルハンドラ情報>
 SIGINT         :<シグナルハンドラ情報>
…
 SIGSOUND       :<シグナルハンドラ情報>
 SIGSAK         :<シグナルハンドラ情報>

Signal Handlers -
シグナル種別： [シグナルハンドラアドレス], sa_mask[0]=シグナルマスク, sa_flags=特殊フラグ
…

Environment Variables -※²
<環境変数>=<値>
…
Current Directory -
 /opt/Cosminexus/CC/server/…

注※1

次の情報が表示されます。

・シグナルハンドラがインストールされている場合は，そのアドレス。

・SIG_DFLである場合は，default。

・SIG_IGNである場合は，ignored。

注※2

次の情報が表示されます。

・シグナル種別には，/usr/include/sys/signal.hに定義されているシグナル名。

・シグナルハンドラアドレスには，シグナルハンドラのアドレスが16進数で出力されます。ライブラリ名＋オフセットという形式で表示されることもあります。

・シグナルマスクには，sigaction()で取り出せる構造のsa_maskフィールド値が16進数で出力されます。

・特殊フラグには，sigaction()で取り出せる構造のsa_flagsフィールド値が16進数で出力されます。

ライブラリ情報（Windows，Linuxの場合）

Loaded Libraries
----------------
Dynamic libraries :
<開始アドレス>-<終了アドレス>   <コマンド>
<開始アドレス>-<終了アドレス>   <ライブラリ>
…

ライブラリ情報（AIX，HP-UX，Solarisの場合）

Loaded Libraries
----------------
<コマンド>
       text     :<開始アドレス>-<終了アドレス> (サイズ)
       data     :<開始アドレス>-<終了アドレス> (サイズ)
<ライブラリ>
       text     :<開始アドレス>-<終了アドレス> (サイズ)
       data     :<開始アドレス>-<終了アドレス> (サイズ)
…

スレッド情報

-----------
"<スレッド名>" <daemon> prio=<優先度> jid=<ハッシュ値> tid=<スレッドID> nid=<nativeID> <status> [開始アドレス...終了アドレス]
   stack=[<スタック開始アドレス>..<YellowPageアドレス>..<RedPageアドレス>..<スタック終了アドレス>]
   [user cpu time=<ユーザー時間>ms, kernel cpu time=<カーネル時間>ms] [blocked count=<ブロック回数>, waited count=<待機回数>]
        at <クラス名>.<メソッド名>(<メソッド情報>)
…

出力内容を説明します。

<スレッド名>

Threadクラスのコンストラクタに指定されたスレッド名称が出力されます。

<daemon>：デーモンスレッドである場合に，”daemon”と出力されます。

<優先度>：Thread#setPriorityで設定された優先度が出力されます。

<ハッシュ値>：System.identityHashCode()を呼び出して得られる値と同一の値が8けたの16進数で出力されます。

<スレッドID>：スレッドオブジェクトのメモリ上のアドレス。

<nativeID>：OSレベルのスレッドID。

<status>：スレッドの状態。
runnable：実行中または実行可能なスレッド
in Object.wait()，waiting for monitor entryまたはwaiting on condition：モニタロック待ちのスレッド
sleeping：中断状態のスレッド

<開始アドレス>：Javaフレームの最高位スタックアドレスが16進数で出力されます。

<終了アドレス>：JavaLockのある最高位スタックアドレスが16進数で出力されます。

<ユーザー時間>：スレッド開始からのユーザー時間がミリ秒単位で出力されます。

<カーネル時間>：スレッド開始からのカーネル時間がミリ秒単位で出力されます。

<ブロック回数>：スレッド開始から，処理がブロックされた回数が出力されます。

<待機回数>：スレッド開始から，処理が待ち状態になった回数が出力されます。

<スタック開始アドレス>

スタック開始アドレスが16進数で出力されます。

<YellowPageアドレス>

スタックYellowガードページ先頭アドレスが16進数で出力されます。

<RedPageアドレス>

スタックRedガードページ先頭アドレスが16進数で出力されます。

<スタック終了アドレス>

スタック終了アドレスが16進数で出力されます。

<クラス名>

クラス名が出力されます。

<メソッド名>

メソッド名が出力されます。

<メソッド情報>

次のメソッド情報が出力されます。

Native Method
ネイティブメソッドの場合に出力されます。

ファイル名：行番号
Javaメソッドで行番号付きでコンパイルされている場合に出力されます。

Unknown Source
Javaメソッドで行番号なしでコンパイルされている場合に出力されます。

Javaモニタダンプ

Java monitor
------------
<ロックオブジェクト>@<ハッシュコード> <オーナー情報>
  <待機状態>:<待機スレッド数>
     <待機スレッド情報>

出力内容を説明します。

<ロックオブジェクト>

ロック対象オブジェクトのクラス名が出力されます。

<ハッシュコード>

Object.hashCodeで得られるハッシュコードが出力されます。

<オーナー情報>

owner "<スレッド名>"<スレッドID>
オーナーがある場合に出力されます。

no owner
オーナーがない場合に出力されます。

<待機状態>

... waiting to enter
メソッド実行待ちの場合に出力されます。

... waiting to be notified
通知待ちの場合に出力されます。

<待機スレッド数>

スレッド数が出力されます。

<待機スレッド情報>

「"<スレッド名>" <スレッドID>」の形式で出力されます。

Rawモニタダンプ

Raw monitor dump
----------------
<モニタ名称> <モニタアドレス> owner <オーナー情報>
  <待機状態>:<待機スレッド数>
     <待機スレッド情報>

出力内容を説明します。

<モニタ名称>

ロック対象モニタの名称が出力されます。

<モニタアドレス>

ロック対象モニタのアドレスが出力されます。

<オーナー情報>

owner "<スレッド名>"<スレッドID>
オーナーがある場合に出力されます。

no owner
オーナーがない場合に出力されます。

<待機状態>

... waiting to enter
synchronizedブロック/メソッド実行待ちの場合に出力されます。

... waiting to be notified
notify待ちの場合に出力されます。

<待機スレッド数>

スレッド数が出力されます。

<待機スレッド情報>

"<スレッド名>" <スレッドID>

フッタ

Full thread dump completed.   EEE MMM dd hh:mm:ss yyyy※

注※

EEEは曜日，MMMは月，ddは日を表します。また，hhは時間，mmは分，ssは秒，yyyyは年（西暦）を表します。

拡張スレッドダンプ情報との比較を，次に示します。

表16-3　標準スレッドダンプと拡張スレッドダンプの出力情報の比較

出力情報
標準スレッドダンプ
拡張スレッドダンプ

ヘッダ
×
○

システム設定
×
○

動作環境
×
○

メモリ情報（Windowsの場合だけ）
×
○

Javaヒープ情報
×
○

JavaVM内部メモリマップ情報
×
○

JavaVM内部メモリサイズ情報
×
○

アプリケーション環境
×
○

ライブラリ情報
×
○

スレッド情報
○
○※1

Javaモニタダンプ
×
○

Rawモニタダンプ
×
○※2

フッタ
×
○

スレッドダンプ出力先
標準出力
標準出力※3
日立JavaVMログファイル

（凡例）

○：出力されます。

×：出力されません。

注※1

スタックの開始および終了のアドレス情報などが出力されます。

注※2

Raw monitorが使用された場合に出力されます。

注※3

-XX:+HitachiThreadDumpToStdoutオプションが指定された場合に出力されます。

注意事項

環境変数JAVACOREDIRで指定したディレクトリへの出力に失敗した場合，カレントディレクトリに出力されます。

カレントディレクトリへの出力に失敗した場合，標準エラー出力に出力されます。なお，この場合，スレッドダンプは標準出力に出力されません。

次に示すオプションの[+|-]指定が「-」の場合，スレッド情報の一部が出力されないのでご注意ください。

オプション名称 | 出力されない情報
-XX:[+|-]HitachiThreadDumpWithHashCode | <ハッシュ値>
-XX:[+|-]HitachiThreadDumpWithCpuTime | <ユーザー時間>，<カーネル時間>
-XX:[+|-]HitachiThreadDumpWithBlockCount | <ブロック回数>，<待機回数>

-XX:[+|-]HitachiThreadDumpToStdout（拡張スレッドダンプ標準出力抑止オプション）

形式

-XX:+HitachiThreadDumpToStdout

拡張スレッドダンプを標準出力および日立JavaVMログファイルに出力します。

-XX:-HitachiThreadDumpToStdout

拡張スレッドダンプを標準出力に出力しません。日立JavaVMログファイルだけに出力します。

説明

拡張スレッドダンプを標準出力へ出力するかどうかを指定します。

このオプションの指定にかかわらず，次のメッセージは出力されます。また，拡張スレッドダンプは日立JavaVMログファイルへ出力されます。

Writing Java core to <ファイル名（フルパス）>... OK

デフォルト値

-XX:+HitachiThreadDumpToStdout

前提オプション

-XX:+HitachiThreadDump

-XX:[+|-]HitachiThreadDumpWithHashCode（拡張スレッドダンプハッシュコード出力オプション）

形式

-XX:+HitachiThreadDumpWithHashCode

拡張スレッドダンプのスレッド情報にハッシュコードを出力します。

-XX:-HitachiThreadDumpWithHashCode

拡張スレッドダンプのスレッド情報にハッシュコードを出力しません。

説明

拡張スレッドダンプのスレッド情報にハッシュコードを出力するかどうかを指定します。

なお，ハッシュコードは，Javaプログラムを実行しているスレッドに対して出力されます。JavaVMの内部動作用スレッドに対しては出力されません。

デフォルト値

-XX:+HitachiThreadDumpWithHashCode

前提オプション

-XX:+HitachiThreadDump

-XX:[+|-]HitachiThreadDumpWithCpuTime（拡張スレッドダンプCPU利用時間出力オプション）

形式

-XX:+HitachiThreadDumpWithCpuTime

拡張スレッドダンプのスレッド情報に，スレッド開始からのユーザーCPU時間とカーネルCPU時間を出力します。

-XX:-HitachiThreadDumpWithCpuTime

拡張スレッドダンプのスレッド情報に，スレッド開始からのユーザーCPU時間とカーネルCPU時間を出力しません。

説明

拡張スレッドダンプのスレッド情報に，ユーザーCPU時間とカーネルCPU時間を出力するかどうかを指定します。

なお，ユーザーCPU時間とカーネルCPU時間は，Javaプログラムを実行しているスレッドに対して出力されます。JavaVMの内部動作用スレッドに対しては出力されません。

HP-UXの場合，この機能は使用できません。オプションを指定しても無視されます。

デフォルト値

-XX:+HitachiThreadDumpWithCpuTime

前提オプション

-XX:+HitachiThreadDump

-XX:[+|-]HitachiThreadDumpWithBlockCount（拡張スレッドダンプブロック回数出力オプション）

形式

-XX:+HitachiThreadDumpWithBlockCount

拡張スレッドダンプのスレッド情報に，スレッドが処理をブロックした回数と待ち状態になった回数を出力します。

-XX:-HitachiThreadDumpWithBlockCount

拡張スレッドダンプのスレッド情報に，スレッドが処理をブロックした回数と待ち状態になった回数を出力しません。

説明

拡張スレッドダンプのスレッド情報に，スレッドが処理をブロックした回数と待ち状態になった回数を出力するかどうかを指定します。

なお，ハッシュコードは，Javaプログラムを実行しているスレッドに対して出力されます。JavaVMの内部動作用スレッドに対しては出力されません。

デフォルト値

-XX:+HitachiThreadDumpWithBlockCount

前提オプション

-XX:+HitachiThreadDump

-XX:HitachiJavaLog（ログファイル名のプリフィックス指定オプション）

形式

-XX:HitachiJavaLog:<文字列>

説明

日立JavaVMログファイルのプリフィックスおよびログファイルの出力先ディレクトリを指定します。

デフォルト値

-XX:HitachiJavaLog:javalog

前提オプション

次のどれかを指定します。

-XX:+HitachiVerboseGC

-XX:+HitachiOutOfMemoryStackTrace

-XX:+HitachiOutOfMemoryCause

-XX:+HitachiOutOfMemorySize

-XX:+HitachiJavaClassLibTrace

引数

<文字列>

プリフィックスおよびパスを指定します。次の3種類の指定ができます。

プリフィックスを指定する場合

ログファイル名は，<文字列>??.log（??は01～99の通し番号）で生成されます。例えば，<文字列>に"Samp"を指定すると，ログファイル名はSamp01.logになります。このオプションを指定しない場合，<文字列>には，"javalog"が設定されます。また，ログファイルはカレントディレクトリに出力されます。

パスを指定する場合

<文字列>にディレクトリを指定した場合，そのディレクトリにファイルが作成されます。ログファイル名は，<文字列>javalog??.log（??は01～99の通し番号）で生成されます。

パスとプリフィックスを同時に指定する場合

<文字列>にディレクトリとプリフィックスを指定した場合，そのディレクトリにファイルが作成されます。ログファイル名は，<文字列>??.log（??は01～99の通し番号）で生成されます。例えば，<文字列>に"d:¥temp¥Samp"を指定すると，d:¥tempディレクトリに，Samp01.logが生成されます。

-XX:HitachiJavaLogFileSize（最大ログファイルサイズ指定オプション）

形式

-XX:HitachiJavaLogFileSize=<整数値>

説明

ログファイルの単純増加を防ぐため，１ファイルの最大ファイルサイズを指定します。最大ファイルサイズを超えた場合は，そのファイルへの出力は行いません。オプションの指定がない場合は，デフォルトで256キロバイトが設定されます。

デフォルト値

-XX:HitachiJavaLogFileSize=256k

前提オプション

次のどれかを指定します。

-XX:+HitachiVerboseGC

-XX:+HitachiOutOfMemoryStackTrace

-XX:+HitachiOutOfMemoryCause

-XX:+HitachiOutOfMemorySize

-XX:+HitachiJavaClassLibTrace

引数

<整数値>

1024～2147483647の範囲で整数値（単位：バイト）を指定します。範囲外の値が指定された場合は1024が設定されます。負の値を指定した場合はエラーとなります。

-XX:[+|-]HitachiJavaLogNoMoreOutput（ログファイル入出力エラー発生時指定オプション）

形式

-XX:+HitachiJavaLogNoMoreOutput

ログファイル出力時にファイル入出力エラーが発生した場合，次のメッセージを標準エラー出力に出力し，ログ情報の出力を停止します。

Java logfile output failed.(errno=<エラーとなった入出力関数名>:<エラー番号>)

-XX:-HitachiJavaLogNoMoreOutput

ログファイル出力時にファイル入出力エラーが発生した場合，次のメッセージを標準エラー出力に出力し，ログ情報の出力先を標準エラー出力に変更して出力を継続します。

Java logfile output failed.(errno=<エラーとなった入出力関数名>:<エラー番号>) Changing output to stderr

説明

ログファイル作成時に入出力エラーが発生した場合に，ログ情報の出力方法について指定します。なお，どちらを指定した場合も，JavaVMの処理は継続されます。

デフォルト値

-XX:+HitachiJavaLogNoMoreOutput

前提オプション

次のどれかを指定します。

-XX:+HitachiVerboseGC

-XX:+HitachiOutOfMemoryStackTrace

-XX:+HitachiOutOfMemoryCause

-XX:+HitachiOutOfMemorySize

-XX:+HitachiJavaClassLibTrace

-XX:HitachiJavaLogNumberOfFile（最大ログファイル数指定オプション）

形式

-XX:HitachiJavaLogNumberOfFile=<整数値>

説明

ログファイルの単純増加を防ぐため，作成する最大ファイル数を指定します。最大ファイル数を超えた場合は，再度最初に作成したファイルへ出力を開始します。オプションの指定がない場合は，デフォルトで4が設定されます。

デフォルト値

-XX:HitachiJavaLogNumberOfFile=4

前提オプション

次のどれかを指定します。

-XX:+HitachiVerboseGC

-XX:+HitachiOutOfMemoryStackTrace

-XX:+HitachiOutOfMemoryCause

-XX:+HitachiOutOfMemorySize

-XX:+HitachiJavaClassLibTrace

引数

<整数値>

1～99の範囲で指定します。100以上の値が指定された場合は99が，0以下の値が指定された場合は1が設定されます。負の値を指定した場合はエラーとなります。

-XX:[+|-]HitachiOutputMilliTime（詳細時間出力オプション）

形式

-XX:+HitachiOutputMilliTime

日立JavaVMログファイルに出力する日時に，ミリ秒まで出力します。

-XX:-HitachiOutputMilliTime

日立JavaVMログファイルに出力する日時に，秒まで出力します。

説明

ミリ秒までの時間を出力するかどうかを指定します。

デフォルト値

-XX:-HitachiOutputMilliTime

前提オプション

次のどれかを指定します。

-XX:+HitachiVerboseGC

-XX:+HitachiOutOfMemoryStackTrace

-XX:+HitachiOutOfMemoryCause

-XX:+HitachiOutOfMemorySize

-XX:+HitachiJavaClassLibTrace

出力例

拡張verbosegc情報の出力

[VGC]<Wed Mar 17 00:45:55.068 2004>(Skip Full:0,Copy:0)[Full GC 149K->149K(1984K), 0.0786038 secs][DefNew::Eden: 264K->0K(512K)][DefNew::Survivor: 0K->63K(64K)][Tenured: 85K->149K(1408K)][Perm: 1300K->1300K(1536K)]

OutOfMemoryError発生時の出力

[OOM][Thread: 0x00957820]<Wed Mar 17 00:47:00.662 2004>[java.lang.OutOfMemory Error :(C Heap) :340]

クラスライブラリトレースの出力

[CLT][Thread: 0x00286348]<Wed Mar 17 00:47:00.662 2004>
[CLT][Thread: 0x00286348] at java.lang.Shutdown.halt0(Native Method)
[CLT][Thread: 0x00286348] at java.lang.Shutdown.halt(Shutdown.java:145)

-XX:[+|-]HitachiVerboseGC（拡張verbosegc情報出力オプション）

形式

-XX:+HitachiVerboseGC

ガーベージコレクションが発生した場合，拡張verbosegc情報を日立JavaVMログファイルに出力します。

ガーベージコレクションの内部領域であるEden，Survivor，Tenured，Perm種別の情報を拡張verbosegc情報として出力します。

-XX:-HitachiVerboseGC

ガーベージコレクションが発生した場合，拡張verbosegc情報を日立JavaVMログファイルに出力しません。

説明

ガーベージコレクションが発生した時の拡張verbosegc情報を出力するかどうかを指定します。

デフォルト値

-XX:-HitachiVerboseGC

出力形式

[id] <date> (Skip Full:full_count, Copy:copy_count) [gc_kind gc_info, gc_time secs][Eden: eden_info][Survivor: survivor_info][Tenured: tenured_info][Perm: perm_info] [cause:cause_info] [User: user_cpu secs] [Sys: system_cpu secs]

出力内容を次に説明します。

id

VGC（日立JavaVMログファイル識別子）

date

日時。

-XX:-HitachiVerboseGCPrintDateオプションが指定された場合，出力されません。

full_count

full GC情報出力をスキップした回数。

-XX:HitachiVerboseGCIntervalTimeオプションが指定された場合に出力されます。

copy_count

copy GC情報出力をスキップした回数。

-XX:HitachiVerboseGCIntervalTimeオプションが指定された場合に出力されます。

gc_kind

ガーベージコレクション種別。”FullGC”，”GC”が出力されます。

gc_info

ガーベージコレクション情報。次の形式で出力されます。

<ガーベージコレクション前の領域長> -> <ガーベージコレクション後の領域長> (<領域サイズ>)

gc_time

ガーベージコレクション経過時間。

Eden

エデンの種別。”DefNew::Eden”が出力されます。

eden_info

Eden情報。次の形式で出力されます。

<ガーベージコレクション前の領域長> -> <ガーベージコレクション後の領域長> (<領域サイズ>)

Servivor

Survivorの種別。”DefNew:: Survivor”が出力されます。

survivor_info

Survivor情報。次の形式で出力されます。

<ガーベージコレクション前の領域長> -> <ガーベージコレクション後の領域長> (<領域サイズ>)

Tenured

Tenuredの種別。”Tenured”が出力されます。

tenured_info

Tenured情報。次の形式で出力されます。

<ガーベージコレクション前の領域長> -> <ガーベージコレクション後の領域長> (<領域サイズ>)

Perm

Permの種別。”Perm”が出力されます。

perm_info

Perm情報。次の形式で出力されます。

<ガーベージコレクション前の領域長> -> <ガーベージコレクション後の領域長> (<領域サイズ>)

cause_info

ガーベージコレクション要因内容。

-XX:-HitachiVerboseGCPrintCauseオプションが指定された場合，出力されません。

user_cpu

ガーベージコレクションスレッドがユーザーモードで費やしたCPU時間。

-XX:-HitachiVerboseGCCpuTimeオプションが指定された場合，出力されません。

system_cpu

ガーベージコレクションスレッドがカーネルモードで費やしたCPU時間。

-XX:-HitachiVerboseGCCpuTimeオプションが指定された場合，出力されません。

出力例

-XX:HitachiVerboseGCIntervalTimeオプションが指定されている場合

[VGC]<Wed Mar 17 00:42:30 2004>(Skip Full:0,Copy:0)[Full GC 149K->149K(1984K), 0.0786038 secs][DefNew::Eden: 264K->0K(512K)][DefNew::Survivor: 0K->63K(64K)][Tenured: 85K->149K(1408K)][Perm: 1300K->1300K(1536K)][cause:System.gc][User: 0.0156250 secs][Sys: 0.0312500 secs]

-XX:[+|-]HitachiCommaVerboseGC（CSV出力オプション）

形式

-XX:+HitachiCommaVerboseGC

拡張verbosegc情報の出力を，CSVファイルで取得できるようにコンマ形式で出力します。

拡張verbosegc情報に出力される括弧（丸括弧()，角括弧[]，山括弧<>）およびコロン（:）をすべて削除し，コンマ（,）で区切った数値または文字列を出力します。

-XX:-HitachiCommaVerboseGC

拡張verbosegc情報を通常形式で出力します。

説明

拡張verbosegc情報をCSV形式で出力するかどうかを指定します。

デフォルト値

-XX:-HitachiCommaVerboseGC

前提オプション

-XX:+HitachiVerboseGC

出力形式

id, date, full_count, copy_count, inc_count, gc_kind, gc_info, gc_time, eden_info, survivor_info, tenured_info, perm_info, cause_info, user_cpu, system_cpu

出力内容を次に説明します。

id

VGC（日立JavaVMログファイル識別子）

date

日時。

-XX:-HitachiVerboseGCPrintDateオプションが指定された場合，出力されません。

full_count

full GC情報出力をスキップした回数。

-XX:HitachiVerboseGCIntervalTimeオプションが指定された場合に出力されます。

copy_count

copy GC情報出力をスキップした回数。

-XX:HitachiVerboseGCIntervalTimeオプションが指定された場合に出力されます。

inc_count

0を表示。

-XX:HitachiVerboseGCIntervalTimeオプションが指定された場合に出力されます。

gc_kind

ガーベージコレクション種別。”FullGC”または”GC”が出力されます。

gc_info

ガーベージコレクション情報。次の形式で出力されます。

<ガーベージコレクション前の領域長>,<ガーベージコレクション後の領域長>,<領域サイズ>

gc_time

ガーベージコレクション経過時間。

eden_info

Eden情報。次の形式で出力されます。

<ガーベージコレクション前の領域長>,<ガーベージコレクション後の領域長>,<領域サイズ>

survivor_info

Survivor情報。次の形式で出力されます。

<ガーベージコレクション前の領域長>,<ガーベージコレクション後の領域長>,<領域サイズ>

tenured_info

Tenured情報。次の形式で出力されます。

<ガーベージコレクション前の領域長>,<ガーベージコレクション後の領域長>,<領域サイズ>

perm_info

Perm情報。次の形式で出力されます。

<ガーベージコレクション前の領域長>,<ガーベージコレクション後の領域長>,<領域サイズ>

cause_info

ガーベージコレクション要因番号。

-XX:-HitachiVerboseGCPrintCauseオプションが指定された場合，出力されません。

なお，ガーベージコレクション要因番号については，「-XX:[+|-]HitachiVerboseGCPrintCause（ガーベージコレクション要因内容出力オプション）」を参照してください。

user_cpu

ガーベージコレクションスレッドがユーザーモードで費やしたCPU時間。

-XX:-HitachiVerboseGCCpuTimeオプションが指定された場合，出力されません。

system_cpu

ガーベージコレクションスレッドがカーネルモードで費やしたCPU時間。

-XX:-HitachiVerboseGCCpuTimeオプションが指定された場合，出力されません。

出力例

-XX:HitachiVerboseGCIntervalTimeオプションが指定されている場合

VGC,Fri Jan 23 21:37:50 2004,11,41,0,GC,16886,16886,65088,0.0559806,4094,0,4096,447,447,448,12345,16439,60544,1116,1116,4096,0,0.0312500,0.0156250
VGC,Fri Jan 23 21:37:55 2004,6,24,0,Full GC,65082,65082,65088,0.4294532,4094,4094,4096,447,447,448,60541,60541,60544,1116,1116,4096,0,0.0156250,0.0312500

-XX:HitachiVerboseGCIntervalTime（拡張verbosegc情報出力間隔指定オプション）

形式

-XX:HitachiVerboseGCIntervalTime=<整数値>

説明

拡張verbosegc情報を出力する時間（秒）の間隔を指定します。

オプションを指定した場合

拡張verbosegc情報をガーベージコレクションごとに出力するのではなく，指定された時間を超えた次のガーベージコレクションを出力します。このとき，前回の出力から今回の出力までの間に発生した，次に示すガーベージコレクションの回数も出力します。これらは必ず出力されます。

表16-4　回数を出力するガーベージコレクションの一覧

文字列 | 意味
Full | Full GCをスキップした回数
Copy | Copy GCをスキップした回数

オプションを指定しない場合

0秒がデフォルトで設定され，ガーベージコレクション発生ごとに拡張verbosegc情報を出力します。

デフォルト値

-XX:HitachiVerboseGCIntervalTime=0

前提オプション

-XX:+HitachiVerboseGC

引数

<整数値>

0～2147483647の範囲の整数値（単位：秒）を指定します。範囲外の値が指定された場合は0が設定されます。負の値を指定した場合はエラーとなります。

-XX:[+|-]HitachiVerboseGCPrintCause（ガーベージコレクション要因内容出力オプション）

形式

-XX:+HitachiVerboseGCPrintCause

ガーベージコレクションの要因内容を，拡張verbosegc情報の行末に出力します。

-XX:-HitachiVerboseGCPrintCause

拡張verbosegc情報を通常形式で出力します。

説明

ガーベージコレクションの要因内容を出力するかどうかを指定します。

デフォルト値

-XX:+HitachiVerboseGCPrintCause

前提オプション

-XX:+HitachiVerboseGC

-XX:+HitachiCommaVerboseGCオプションが指定されている場合は，次に示す要因番号が出力されます。

表16-5　ガーベージコレクション要因一覧

要因番号 | 要因内容 | 説明
0 | ObjAllocFail | オブジェクトの割り付け失敗によってガーベージコレクションが発生しました。
1 | System.gc | java.lang.System.gcメソッド呼び出しによってガーベージコレクションが発生しました。
2 | PermAllocFail | パーマネントヒープの割り付け失敗によってガーベージコレクションが発生しました。
3 | DelayedGC | JNIやJVMPIによって保留されていたガーベージコレクションが起動されました。
4 | JavaGC Command | JavaGCコマンドによってガーベージコレクションが発生しました。
5 | LasrPermGC | パーマネントヒープのOutOfMemoryErrorを出す前の最後のガーベージコレクションが発生しました。
6 | JheapProf Command | Jheapprofコマンドによってガーベージコレクションが発生しました。

出力例

[VGC]<Wed Mar 17 00:42:30 2004>(Skip Full:0,Copy:0)[Full GC 149K->149K(1984K), 0.0786038 secs][DefNew::Eden: 264K->0K(512K)][DefNew::Survivor: 0K->63K(64K)][Tenured: 85K->149K(1408K)][Perm: 1300K->1300K(1536K)][cause:System.gc]

-XX:[+|-]HitachiVerboseGCPrintDate（拡張verbosegc情報日付出力オプション）

形式

-XX:+HitachiVerboseGCPrintDate

拡張verbosegc情報の各出力行の先頭に日時を出力します。

-XX:-HitachiVerboseGCPrintDate

拡張verbosegc情報の各出力行の先頭に日時を出力しません。

説明

拡張verbosegc情報に日付を出力するかどうかを指定します。

デフォルト値

-XX:+HitachiVerboseGCPrintDate

前提オプション

-XX:+HitachiVerboseGC

-XX:[+|-]HitachiVerboseGCCpuTime（拡張verbosegc情報CPU利用時間出力オプション）

形式

-XX:+HitachiVerboseGCCpuTime

拡張verbosegc情報に，ガーベージコレクションの開始から終了までで，ガーベージコレクション実行スレッドのユーザーモードおよびカーネルモードに費やされたプロセッサ時間を出力します。

-XX:-HitachiVerboseGCCpuTime

拡張verbosegc情報に，ガーベージコレクションの開始から終了までで，ガーベージコレクション実行スレッドのユーザーモードおよびカーネルモードに費やされたプロセッサ時間を出力しません。

説明

拡張verbosegc情報にCPU利用時間を出力するかどうかを指定します。

HP-UXの場合，この機能は使用できません。オプションを指定しても無視されます。

デフォルト値

-XX:+HitachiVerboseGCCpuTime

前提オプション

-XX:+HitachiVerboseGC

出力例

[VGC]<Wed Mar 17 00:42:30 2004>(Skip Full:0,Copy:0)[Full GC 149K->149K(1984K), 0.0786038 secs][DefNew::Eden: 264K->0K(512K)][DefNew::Survivor: 0K->63K(64K)][Tenured: 85K->149K(1408K)][Perm: 1300K->1300K(1536K)][User:0.0156250 secs][Sys: 0.0312500 secs]

-XX:[+|-]HitachiOutOfMemoryCause（例外発生要因種別出力オプション）

形式

-XX:+HitachiOutOfMemoryCause

OutOfMemoryError発生時に，例外発生要因種別を日立JavaVMログファイルに出力します。-XX:+HitachiOutOfMemoryStackTraceオプションが指定されている場合は，このオプションも設定されます。

出力される要因種別を次に示します。

表16-6　例外発生要因種別一覧

項番 | 要因メッセージ | 説明
1 | C Heap | Cヒープ確保時の例外
2 | Java Heap | Javaヒープ確保時の例外
3 | Perm Heap | Permヒープ確保時の例外
4 | Unknown | 上記例外を特定できない場合

-XX:-HitachiOutOfMemoryCause

OutOfMemoryError発生時に，例外発生要因種別を日立JavaVMログファイルに出力しません。

説明

OutOfMemoryError発生時の発生要因種別を出力するかどうかを指定します。

デフォルト値

-XX:-HitachiOutOfMemoryCause

出力例

[OOM][Thread: 0x00062fd0]<Tue Dec 2 16:42:39 2003>[java.lang.OutOfMemoryError :(C Heap) : unable to create thread : 340 threads exist]

-XX:[+|-]HitachiOutOfMemoryStackTrace（スタックトレース出力オプション）

形式

-XX:+HitachiOutOfMemoryStackTrace

OutOfMemoryError発生時に，例外情報とスタックトレースを日立JavaVMログファイルに出力します。

スタックトレースは１スタックごとにバッファに格納し，コード変換した後に出力します。スタックトレースの出力は，OutOfMemoryErrorがスローされるたびに行われるため，OutOfMemoryErrorをキャッチして再スローした場合には複数回出力されます。なお，スレッド作成時にOutOfMemoryErrorとなった場合は，スタックトレースは出力されません。

-XX:-HitachiOutOfMemoryStackTrace

OutOfMemoryError発生時に，スタックトレースを日立JavaVMログファイルに出力しません。

説明

OutOfMemoryError発生時に，例外情報とスタックトレースを日立JavaVMログファイルに出力するかどうかを指定します。

デフォルト値

-XX:-HitachiOutOfMemoryStackTrace

出力形式

[id] [Thread:thread_id]<date>[java.lang.OutOfMemoryError : requested size bytes (cause) : reason : thread_count threads exist]
[id] [Thread:thread_id] stack_trace

出力内容を次に説明します。

id

OOM（日立JavaVMログファイル識別子）

thread_id

スレッドID（スレッドダンプに出力されているtid）

date

日時

size

確保しようとしたメモリのサイズ（単位：バイト）が出力されます。-XX:-HitachiOutOfMemorySizeオプションが指定されている場合，出力されません。

なお，次の場合は要求したメモリサイズが取り出せません。これらの場合は，サイズとして「unknown」が出力されます。

Javaのメモリ確保機能を使用しないで，明示的にOutOfMemoryErrorをスローした場合
標準クラスライブラリによってスローされるものも含みます。例えば，「throw new OutOfMemoryError();」などの処理によってスローされた場合，メモリサイズは出力できません。

クラスロード時のverifierによってOutOfMemoryErrorが発生した場合

cause

例外発生要因種別。ただし，-XX:-HitachiOutOfMemoryCauseオプションが指定されている場合は出力されません。例外発生要因種別については，「-XX:[+|-]HitachiOutOfMemoryCause（例外発生要因種別出力オプション）」を参照してください。

reason

例外発生理由。スレッドの作成に失敗した場合に出力されます。

thread_count

OutOfMemoryError発生時のスレッド数。作成に失敗したスレッド数も含みます。

stack_trace

スタックトレース

出力例

[OOM][Thread: 0x00062fd0] <Wed Mar 17 00:41:17 2004>[java.lang.OutOfMemoryError :requested 400000 bytes.(C Heap): unable to create thread : 1500 threads exist]
[OOM][Thread: 0x00062fd0] at java.lang.Thread.start(Native Method)
[OOM][Thread: 0x00062fd0] at sub1.<init>(Thread0012.java:22)
[OOM][Thread: 0x00062fd0] at Thread0012.test01(Thread0012.java:73)
[OOM][Thread: 0x00062fd0] at Thread0012.main(Thread0012.java:57)

注意事項

JavaVM自身で作成するスレッドが，メモリ不足によってスレッドの作成に失敗した場合は，例外情報だけが出力されます。スタックトレースは出力されません。

-XX:HitachiOutOfMemoryStackTraceLineSize（スタックトレース行サイズ指定オプション）

形式

-XX:HitachiOutOfMemoryStackTraceLineSize=<整数値>

説明

OutOfMemoryError発生時に，出力するスタックトレース1行の文字数をバイト数で指定します。オプションの指定がない場合は，1024バイトがデフォルトで設定されます。指定したバイト数が確保できない場合は警告メッセージが出力され，スタックトレースは出力されません。また，１行の文字数が指定した文字数を超えた場合，「at」以降の文字列の前半部分を削除して，指定された文字数分出力します。

デフォルト値

-XX:HitachiOutOfMemoryStackTraceLineSize=1024

前提オプション

-XX:+HitachiOutOfMemoryStackTrace

引数

<整数値>

1024～2147483647の範囲で整数値（単位：バイト）を指定します。範囲外の値が指定された場合は1024が設定されます。負の値を指定した場合はエラーとなります。

-XX:[+|-]HitachiOutOfMemorySize（メモリサイズ出力オプション）

形式

-XX:+HitachiOutOfMemorySize

OutOfMemoryError発生時に，要求したメモリサイズをバイト単位で出力します。

-XX:+HitachiOutOfMemoryStackTraceオプションが指定されている場合は，このオプションも設定されます。

-XX:-HitachiOutOfMemorySize

OutOfMemoryError発生時に，要求したメモリサイズを出力しません。

説明

OutOfMemoryError発生時に要求したメモリのサイズを出力します。

デフォルト値

-XX:-HitachiOutOfMemorySize

出力例

[OOM][Thread: 0x00062fd0]<Tue Dec 2 16:42:39 2003>[java.lang.OutOfMemoryError :　 requested 1024 bytes. (Java Heap) : 20 threads exist]

注意事項

次の場合，要求したメモリサイズが取り出せません。

Javaのメモリ確保機能を使用してなくて，明示的にOutOfMemoryErrorをスローした（J2SEクラスライブラリがスローするものを含みます）場合。

例:throw new OutOfMemoryError();

クラスロード時のverifierがOutOfMemoryErrorを発生させた場合。

[OOM][Thread: 0x00062fd0]<Tue Dec 2 16:42:39 2003>[java.lang.OutOfMemoryError :　 requested size unknown. (Unknown) : 10 threads exist]

-XX:[+|-]HitachiOutOfMemoryAbort（強制終了オプション）

形式

-XX:+HitachiOutOfMemoryAbort

OutOfMemoryError発生時にメモリダンプを出力して，強制終了します。

-XX:-HitachiOutOfMemoryAbort

OutOfMemoryError発生時に強制終了しません。

説明

次の原因でOutOfMemoryErrorが発生した場合，標準出力にメッセージを，カレントディレクトリにメモリダンプまたはcoreダンプを出力して強制終了します。

Javaヒープ不足の場合

Permヒープ不足の場合

J2SEクラスライブラリ中でのCヒープ不足の場合

なお，JavaVM処理中にCヒープ不足となった場合には，このオプションの指定にかかわらず，強制停止します。

デフォルト値

-XX:-HitachiOutOfMemoryAbort

出力例

java.lang.OutOfMemoryError occurred.
JavaVM aborted because of specified -XX:+HitachiOutOfMemoryAbort options.

注意事項

-XX:+HitachiOutOfMemoryStackTraceオプションが指定されている場合は，日立JavaVMログファイルにスタックトレースを出力したあとに終了します。

メモリダンプは，ワトソンログ生成ディレクトリにuser.dmpとして生成されます。IPFの場合，カレントディレクトリにmemory.dmpとして生成されます。

このオプションが指定されている場合，java.io.File.deleteOnExitメソッドやjava.lang.Runtime.addShutdownHookメソッドで登録している，JavaVM終了時の処理は実行されないで強制終了します。

-XX:[+|-]HitachiOutOfMemoryAbortThreadDump（スレッドダンプ出力オプション）

形式

-XX:+HitachiOutOfMemoryAbortThreadDump

OutOfMemoryError発生時にスレッドダンプを出力します。

-XX:+HitachiOutOfMemoryAbortオプションが指定されている場合に，このオプションは指定できます。

-XX:-HitachiOutOfMemoryAbortThreadDump

OutOfMemoryError発生時にスレッドダンプを出力しません。

説明

OutOfMemoryError発生時にスレッドダンプを出力します。ただし，J2SEクラスライブラリでCヒープ不足の場合は，スレッドダンプを出力によって再度のCヒープ不足発生を避けるため，スレッドダンプは出力しません。

スレッドダンプの出力先は環境変数JAVACOREDIR，または-XX:+HitachiThreadDumpToStdoutオプションで指定します。

デフォルト値

-XX:+HitachiOutOfMemoryAbortThreadDump

前提オプション

-XX:+HitachiOutOfMemoryAbort

-XX:[+|-]HitachiJavaClassLibTrace（クラスライブラリのスタックトレース出力オプション）

形式

-XX:+HitachiJavaClassLibTrace

クラスライブラリのスタックトレースを出力します。

-XX:-HitachiJavaClassLibTrace

クラスライブラリのスタックトレースを出力しません。

説明

次に示すシステム全体に影響を与えるメソッドが使用された場合，これらのAPIのスタックトレースを，日立JavaVMログファイルへ出力します。

java.lang.System.gc

java.lang.System.exit

java.lang.Runtime.exit

java.lang.Runtime.halt

デフォルト値

-XX:-HitachiJavaClassLibTrace

出力形式

[id] [Thread:thread_id]<date>
[id] [Thread:thread_id] stack_trace

出力内容を次に説明します。

id：

CLT（日立JavaＶＭログファイル識別子）

thread_id：

スレッドID（スレッドダンプに出力されているtid）

date：

日時

stack_trace：

スタックトレース

出力例

[CLT][Thread: 0x00062fd0]<Mon Sep 27 12:10:03 2004>
[CLT][Thread: 0x00062fd0] at at java.lang.Shutdown.halt0(Native Method)
[CLT][Thread: 0x00062fd0] at java.lang.Shutdown.halt(Shutdown.java:145)
[CLT][Thread: 0x00062fd0] - locked <0x100101a0> (a java.lang.Shutdown$Lock)
[CLT][Thread: 0x00062fd0] at java.lang.Shutdown.exit(Shutdown.java:222)
[CLT][Thread: 0x00062fd0] - locked <0x1413c0a0> (a java.lang.Class)
[CLT][Thread: 0x00062fd0] at java.lang.Terminator$1.handle(Terminator.java:35)
[CLT][Thread: 0x00062fd0] at sun.misc.Signal$1.run(Signal.java:195)
[CLT][Thread: 0x00062fd0] at java.lang.Thread.run(Thread.java:534)

-XX:HitachiJavaClassLibTraceLineSize（クラスライブラリのスタックトレース行サイズ指定オプション）

形式

-XX:HitachiJavaClassLibTraceLineSize=<整数値>

説明

-XX:+HitachiJavaClassLibTraceオプションを指定した場合に出力される，クラスライブラリのスタックトレースの1行の文字数をバイト数で指定します。

デフォルト値

-XX:HitachiJavaClassLibTraceLineSize=1024

前提オプション

-XX:+HitachiJavaClassLibTrace

引数

<整数値>

1024～2147483647の範囲で整数値（単位：バイト）を指定します。範囲外の値が指定された場合は1024が設定されます。

出力例

[CLT][Thread: 0x00286c58]<Thu Oct 21 14:56:24 2004>
[CLT][Thread: 0x00286c58] at java.lang.Runtime.gc(Native Method)
[CLT][Thread: 0x00286c58] at java.lang.System.gc(System.java:737)
[CLT][Thread: 0x00286c58] at mple.func_012345678～省略～xyz(Sample.java:9)
[CLT][Thread: 0x00286c58] at Sample.main(Sample.java:5)

1行の文字数が指定したバイト数を超える場合，「at」以降の文字列の前半部分が削除されます。出力例の場合，4行目のSampleの前半が削除されてmpleとなります。

-XX:[+|-]HitachiLocalsInThrowable（例外発生時のローカル変数情報収集オプション）

形式

-XX:+HitachiLocalsInThrowable

スタックトレース中のメソッドのローカル変数情報を出力します。

ただし，java.lang.StackOverflowError発生時には，このオプションは無視されます。

-XX:-HitachiLocalsInThrowable

スタックトレース中のメソッドのローカル変数情報を出力しません。

説明

java.lang.Throwable.fillInStackTraceメソッド実行時に，スタックトレース中のメソッドのローカル変数情報を収集します。また，java.lang.Throwable.printStackTraceメソッドを使用した場合，従来のスタックトレース情報にローカル変数情報を追加して出力します。

デフォルト値

-XX:-HitachiLocalsInThrowable

出力形式

   locals:
     name: <name>
     type: <type>
     value: <value>

…

出力内容を次に示します。

1行目に「locals:」という見出しが出力されます。

2行目以降は，収集可能であった各ローカル変数について，次の情報が1行ずつ出力されます。

変数名

型名（基本型名，クラス名または配列型名）

変数値を表現する文字列

なお，各ローカル変数の出力内容は，空行で区切られています。

<name>：

ローカル変数名。

メソッドに渡される引数の場合は，変数名に続いて[arg***]（***は引数番号）が表示されます。

<type>：

ローカル変数の型名（基本型名，クラス名または配列型名）。

<value>：

ローカル変数の値を表現する文字列。

基本型：
値をそのまま文字列化したもの

クラスまたは配列型：
変数値がnullの場合：(null)
それ以外の場合：<オブジェクトの存在するアドレス>

値表現の最大文字列長は64です。これを超える場合は64文字目までを出力した後，「...」という文字列が出力されます。クラスまたは配列型の場合，次の追加オプションを指定することでより詳細な表現が追加できます。

-XX:+HitachiLocalsSimpleFormat

-XX:+HitachiTrueTypeInLocals

-XX:HitachiCallToString

出力例

Javaプログラム例1を使用した出力例を，次に示します。

すべてのローカル変数情報が出力される場合

 at Example1.method(Example1.java:15)
   locals:
     name: this
     type: Example1
     value: <0x922f42d0>

     name: l1 [arg1]
     type: int
     value: 1

     name: l2 [arg2]
     type; char
     value: 'Q'

     name: l3 [arg3]
     type: java.lang.Object
     value: <0xaf112f08>

     name: l4
     type: float
     value: 4.000000

     name: l5
     type: boolean
     value: true

     name: l6
     type: double
     value: 1.79769E+308

     name: l7
     type: java.lang.Object[]
     value: <0x922f42d8>

 at Example1.main(Example1.java:5)
   locals:
…

ローカル変数情報が存在しない場合

-gオプションまたは-g:varsオプションを付加しないでclassファイルを生成した場合

-gオプションまたは-g:varsオプションを付加して生成したclassファイルの，nativeメソッドの場合

 at Example1.method(Example1.java:15)
   locals:
     name: this
     type: Example1
     value: <0x922f42d0>

     name: [arg1]
     type: int
     value: 1

     name: [arg2]
     type; char
     value: 'Q'

     name: [arg3]
     type: java.lang.Object
     value: <0xaf112f08>

 at Example1.main(Example1.java:5)
   locals:
…

注意事項

ローカル変数情報を完全に収集するためには，javacでclassファイルを生成する際に，-gオプションまたは-g:varsオプションを付加してclassファイル内にローカル変数情報を埋め込んでおく必要があります。-gオプションまたは-g:varsオプションを付加しないで作成されたclassファイルについては，収集可能な範囲でローカル変数情報が出力されます。

-gオプションまたは-g:varsオプションを付加して生成されたclassファイルでも，nativeメソッドの場合はローカル変数情報が存在しません。

JITコンパイラがメソッドをJITコンパイルする際，最適化の一環として，不要と判断したローカル変数を除去することがあります。
（例）int not_used = 12345といった宣言および初期化以降未使用のローカル変数
この場合，例外発生時点のローカル変数情報には，次の値が出力されます。

型名
出力情報

boolean型
false

char型
'¥0'

byte型
short型
int型
long型
float型
double型
0

クラス型
配列型
(null)

制御構造が複雑で行数が多いメソッドのローカル変数情報を出力する場合，解析に時間が掛かるため，例外発生時の例外オブジェクト生成処理に時間が掛かることがあります。

-XX:[+|-]HitachiLocalsInStackTrace（スレッドダンプ出力時のローカル変数出力オプション）

形式

-XX:+HitachiLocalsInStackTrace

スレッドダンプ出力時のスタックトレースに，ローカル変数情報を出力します。

-XX:-HitachiLocalsInStackTrace

スレッドダンプ出力時のスタックトレースに，ローカル変数情報を出力しません。

説明

スレッドダンプ出力時のスタックトレースに，各メソッドのローカル変数情報を追加して出力します。ローカル変数情報の出力内容については，「-XX:[+|-]HitachiLocalsInThrowable（例外発生時のローカル変数情報収集オプション）」を参照してください。

デフォルト値

-XX:-HitachiLocalsInStackTrace

出力例

Javaプログラム例2を使用した出力例を，次に示します。

-XX:+HitachiLocalsSimpleFormatオプションおよび-XX:+HitachiTrueTypeInLocalsオプションが指定されている場合

"main" prio=1 tid=0xb6e88d20 nid=0xb7492080 runnable [bfffb000..bfffb474]
       at Example2.method(Example2.java:15)
       - locked <0xab040550> (a Example2)
         locals:
           (Example2) this = <0xab040550> (Example2)
           (int) l1 = 1
           (float) l2 = 2.000000
           (java.lang.String) l3 = <0xaf112cc0> (java.lang.String)
           (java.lang.Character) l4 = <0xab040698> (java.lang.Character)
           (java.lang.Object) l5 = <0xab0407c8> (java.lang.Thread)
           (java.lang.Object[]) l6 = <0xab0408b8> (java.lang.Thread[])
       at Example2.main(Example2.java:4)
         locals:
           (java.lang.String[]) args [arg1] = <0xab040540> (java.lang.String[])
           (Example2) e2 = <0xab040550> (Example2)

注意事項

ローカル変数情報を完全に収集するためには，javacでclassファイルを生成する際に，-gオプションまたは-g:varsオプションを付加してclassファイル内にローカル変数情報を埋め込んでおく必要があります。-gオプションまたは-g:varsオプションを付加しないで作成されたclassファイルについては，収集可能な範囲でローカル変数情報が出力されます。

一般にスタックトレース情報の収集を行うスレッドと収集対象のスレッドは一致しません。このため，情報収集を行うためには，対象スレッドを停止させる必要があり，toStringメソッドを呼び出すことはできません。このため，-XX:HitachiCallToStringオプションの指定は無効になります。

制御構造が複雑で行数が多いメソッドのローカル変数情報を出力する場合，解析に時間が掛かるため，拡張スレッドダンプの出力やスレッドスタックトレースの取得に時間が掛かることがあります。

-XX:[+|-]HitachiLocalsSimpleFormat（ローカル変数情報の出力フォーマット変更オプション）

形式

-XX:+HitachiLocalsSimpleFormat

ローカル変数情報出力を，簡易フォーマットで出力します。

-XX:-HitachiLocalsSimpleFormat

ローカル変数情報出力を，通常フォーマットで出力します。

説明

ローカル変数情報の出力フォーマットを，1変数1行で出力する簡易出力フォーマットに変更します。

デフォルト値

-XX:-HitachiLocalsSimpleFormat

前提オプション

-XX:+HitachiLocalsInThrowable

-XX:+HitachiLocalsInStackTrace

出力形式

   locals:
     (type) name = value
     (type) name = value
…

type，nameおよびvalueの出力内容については，「-XX:[+|-]HitachiLocalsInThrowable（例外発生時のローカル変数情報収集オプション）」を参照してください。

出力例

Javaプログラム例1を使用した出力例を，次に示します。

 at Example1.method(Example1.java:15)
   locals:
     (Example1) this = <0x922f42d0>
     (int) l1 [arg1] = 1
     (char) l2 [arg2] = 'Q'
     (java.lang.Object) l3 [arg3] = <0xaf112f08>
     (float) l4 = 4.000000
     (boolean) l5 = true
     (double) l6 = 1.79769E+308
     (java.lang.Object[]) l7 = <0x922f42d8>
 at Example1.main(Example1.java:5)
   locals:
…

-XX:[+|-]HitachiTrueTypeInLocals（ローカル変数情報の実型名出力オプション）

形式

-XX:+HitachiTrueTypeInLocals

ローカル変数情報に，実際のオブジェクト型名を出力します。

-XX:-HitachiTrueTypeInLocals

ローカル変数情報に，実際のオブジェクト型名を出力しません。

説明

ローカル変数情報収集時に，クラスまたは配列型のローカル変数について，実際に代入されているオブジェクトの型名を出力します。変数値を表現する文字列の後ろの丸括弧内に表示されます。

デフォルト値

-XX:-HitachiTrueTypeInLocals

前提オプション

-XX:+HitachiLocalsInThrowable

-XX:+HitachiLocalsInStackTrace

出力例

Javaプログラム例3を使用した出力例を，次に示します。

-XX:+HitachiLocalsSimpleFormatオプションおよび-XX:HitachiCallToString=fullが指定されている場合

 at Example3.method(Example3.java:18)
   locals:
     (Example3) this = <0xaa07db58> "I am an Example3 instance." (Example3)
     (java.lang.String) l1 = <0xae173a28> "local 1" (java.lang.String)
     (java.lang.StringBuffer) l2 = <0xaa07dca0> "local 1 + local 2" (java.lang.StringBuffer)
     (java.lang.Boolean) l3 = <0xaa07de18> "false" (java.lang.Boolean)
     (java.lang.Character) l4 = <0xaa07df68> "X" (java.lang.Character)
     (java.lang.Long) l5 = <0xaa07e078> "-9223372036854775808" (java.lang.Long)
     (java.lang.Object) l6 = <0xaa07e1a8> "Thread[Thread-0,5,main]" (java.lang.Thread)
     (java.lang.Object[]) l7 = <0xaa07e298> "[Ljava.lang.Thread;@26e431" (java.lang.Thread[])
 at Example3.main(Example3.java:4)
   locals:
…

-XX:HitachiCallToString（ローカル変数情報出力オプション）

形式

-XX:HitachiCallToString=<適用範囲>

説明

<適用範囲>に該当するクラスのローカル変数オブジェクト対して取得したStringオブジェクトの文字列を，変数値を表現する文字列として出力します。

デフォルト値

-XX:HitachiCallToString=minimal

前提オプション

-XX:+HitachiLocalsInThrowable

引数

<適用範囲>

minimalまたはfullを指定します。

minimal：

java.langパッケージ内の次に示すクラスが対象になります。

String

StringBuffer

Boolean

Byte

Character

Short

Integer

Long

Float

Double

なお，空文字（""）を指定した場合も，minimalと同じです。

full：

すべてのクラスおよび配列型が対象になります。

出力例

Javaプログラム例3を使用した出力例（簡易出力フォーマット）を，次に示します。

-XX:HitachiCallToString=minimalの場合

 at Example3.method(Example3.java:18)
   locals:
     (Example3) this = <0xaa07db58>
     (java.lang.String) l1 = <0xae173a28> "local 1"
     (java.lang.StringBuffer) l2 = <0xaa07dca0> "local 1 + local 2"
     (java.lang.Boolean) l3 = <0xaa07de18> "false"
     (java.lang.Character) l4 = <0xaa07df68> "X"
     (java.lang.Long) l5 = <0xaa07e078> "-9223372036854775808"
     (java.lang.Object) l6 = <0xaa07e1a8>
     (java.lang.Object[]) l7 = <0xaa07e298>
 at Example3.main(Example3.java:4)
   locals:
…

-XX:HitachiCallToString=fullの場合

 at Example3.method(Example3.java:18)
   locals:
     (Example3) this = <0xaa07db58> "I am an Example3 instance."
     (java.lang.String) l1 = <0xae173a28> "local 1"
     (java.lang.StringBuffer) l2 = <0xaa07dca0> "local 1 + local 2"
     (java.lang.Boolean) l3 = <0xaa07de18> "false"
     (java.lang.Character) l4 = <0xaa07df68> "X"
     (java.lang.Long) l5 = <0xaa07e078> "-9223372036854775808"
     (java.lang.Object) l6 = <0xaa07e1a8> "Thread[Thread-0,5,main]"
     (java.lang.Object[]) l7 = <0xaa07e298> "[Ljava.lang.Thread;@26e431"
 at Example3.main(Example3.java:4)
   locals:
…

注意事項

ローカル変数情報を完全に収集するためには，javacでclassファイルを生成する際に，-gオプションまたは-g:varsオプションを付加してclassファイル内にローカル変数情報を埋め込んでおく必要があります。-gオプションまたは-g:varsオプションを付加しないで作成されたclassファイルについては，収集可能な範囲でローカル変数情報が出力されます。

-XX:[+|-]HitachiFullCore（システムリソース解除オプション）

このオプションは，UNIX用です。

形式

-XX:+HitachiFullCore

システムリソースRLIMIT_COREを強制的に最大値に引き上げて，障害発生時にユーザーリミットを無視してcoreファイルを作成します。

-XX:-HitachiFullCore

システムリソースRLIMIT_COREは変更しません。

説明

システムリソースRLIMIT_COREの設定を変更するかどうかを指定します。

デフォルト値

-XX:-HitachiFullCore

-XX:[+|-]HitachiReserveSwapSpace（スワップ領域の予約オプション）

このオプションは，HP-UX用です。

形式

-XX:+HitachiReserveSwapSpace

JavaVMの実行に必要となる最大のスワップ領域をすべて予約します。

-XX:-HitachiReserveSwapSpace

JavaVMの実行に必要となる最大のスワップ領域を予約しません。

説明

JavaVMの実行に必要となる最大のスワップ領域を，JavaVM起動時に，OSに対して予約するかどうかを指定します。

なお，必要となる最大のスワップ領域のサイズは，次の式で算出できます。

（-Xmx指定値）※¹＋（-XX:MaxPermSize指定値）※¹＋（JITコンパイルしたコードを格納する領域）※²

注※1

-XmxおよびMaxPermSizeのデフォルト値は次のようになっています。

・-Xmx：64MB

・MaxPermSize：64MB

注※2

OSによって異なります。

・HP-UX（IPF）の場合：128MB

デフォルト値

-XX:-HitachiReserveSwapSpace

注意事項

JavaVMによって予約されたスワップ領域を，ほかのプロセスから利用（予約）できません。JavaVMがその領域を使用していなくても同様に利用できません。このため，JavaVMの実行中にスワップ領域の確保に失敗してJavaVMが停止することはありません。

スワップ領域を予約できなかった場合は，標準出力に次のメッセージが出力され，終了します。

Error occurred during initialization of VM
Could not reserve enough space for object heap

このオプションの指定値によって，JavaVMが異常終了した場合に生成されるcoreのサイズが変わることはありません。

16.3　Java HotSpot VMのオプションのCosminexusでのデフォルト値

Java HotSpot VMのオプションのCosminexusでのデフォルト値を示します。デフォルト値は，OSごとに異なります。

ポイント

ここで説明するデフォルト値は，EJBクライアントアプリケーションの場合に有効になります。J2EEサーバまたはWebコンテナサーバの場合，この表で示したデフォルト値ではなく，J2EEサーバ用オプション定義ファイル（usrconf.cfg）またはWebコンテナサーバ用オプション定義ファイル（usrconf.cfg）のadd.jvm.argキーのデフォルト値が有効になるキーがあります。ファイルの詳細については，「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」，「12.2　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）」，または「15.3　usrconf.cfg（Webコンテナサーバ用オプション定義ファイル）」を参照してください。

Java HotSpot VMのオプションのCosminexusでのデフォルト値を次の表に示します。

表16-7　Java HotSpot VMのオプションのCosminexusでのデフォルト値

項
番
オプション名
使用するOSとJavaVMの種類

Windows Server 2003，Windows Server 2003（x64），Windows Server 2003 R2，Windows Server 2003 R2（x64）
Linux（x86／AMD64 & Intel EM64T）※1
HP-UX（IPF）
AIX，Solaris
Linux（IPF）
Linux(AMD64 & Intel EM64T）※2

［client］※3
［server］※3
［client］※3
［server］※3
［server］
［client］
［server］
[server]

1
-Xmx<size>※4
64M
64M
64M
64M
83M
64M
83M
83M

2
-Xms<size>※4
2048k
2048k
2048k
2048k
4608k
3584k
4608k
4492k

3
-XX:MaxPermSize=<size>※4
64M
64M
64M
64M
83M
64M
83M
83M

4
-XX:PermSize=<size>※4
8M
16M
8M
16M
20M
8M
20M
20M

5
-Xmn<size>
※5
※5
※5
※5
※5
※5
※5
※5

6
-Xss<size>
256k
256k
512k
512k
1M
512k
1M
1M

7
-XX:NewRatio=<value>※4
12
2
12
2
2
8
2
2

8
-XX:SurvivorRatio=<value>
8
32
8
32
8
32
8
32

9
-XX:TargetSurvivorRatio=<value>
50
50
50
50
50
50
50
50

10
-XX:MaxTenuringThreshold=<value>
15
15
31
31
31
31
15
15

（凡例）

[client]：Java HotSpot(TM) Client VMが使用されることを示します。

[server]：Java HotSpot(TM) Server VMが使用されることを示します。

注

<size>の単位はバイトです。

注※1

P-9S3Z-7151 Cosminexus Developer's Kit for Javaを使用した場合です。

注※2

P-9W3Z-7151 Cosminexus Developer's Kit for Javaを使用した場合です。

注※3

オプション定義ファイル（usrconf.cfg）のjvm.typeキーの指定値によって，使用するJavaVMを選択できます。

注※4

J2EEサーバまたはWebコンテナサーバの場合，この表で示したデフォルト値ではなく，J2EEサーバ用オプション定義ファイル（usrconf.cfg）またはWebコンテナサーバ用オプション定義ファイル（usrconf.cfg）のadd.jvm.argキーのデフォルト値が有効になります。

それぞれのオプションの意味を次に示します。

-Xmx<size>

Javaヒープの最大サイズを設定します。

-Xms<size>

Javaヒープの初期サイズを設定します。

-XX:MaxPermSize=<size>

Permanent領域の最大サイズを設定します。

-XX:PermSize=<size>

Permanent領域の初期サイズを設定します。

-Xmn<size>

DefNew領域の初期値および最大値を設定します。

-Xss<size>

１スタック領域の最大サイズを設定します。

-XX:NewRatio=<value>

DefNew領域に対するTenured領域の割合を設定します。

<value>が2の場合は，DefNew領域とTenured領域の割合が，1:2になります。

DefNew領域の使用中サイズ≧Tenured領域の空き領域サイズ　となるとFullGCが発生します。NewRatioに1を設定すると，FullGCが多発するのでご注意ください。

-XX:SurvivorRatio=<value>

DefNew::Survivor領域のFrom空間とTo空間に対するDefNew::Eden領域の割合を設定します。

<value>に8を設定した場合は，DefNew::Eden領域，From空間，To空間の割合が，8:1:1になります。

-XX:TargetSurvivorRatio=<value>

ガーベージコレクション実行後のDefNew::Survivor領域内でJavaオブジェクトが占める割合の目標値を設定します。

-XX:MaxTenuringThreshold=<value>

コピーガーベージコレクション実行時に，From空間とTo空間でJavaオブジェクトを入れ替える回数のしきい値を設定します。

設定した回数を超えて入れ替え対象になったJavaオブジェクトは，Tenured領域に移動されます。

注※5

Javaヒープと-XX:NewRatioによって決まります。

付録

＜この付録の構成＞

付録A　拡張MIBオブジェクト定義ファイル

付録B　Webアプリケーション用DD（web.xml）

付録A　拡張MIBオブジェクト定義ファイル

拡張MIBオブジェクト定義ファイルは，Management Serverが出力する稼働性能などの情報を，MIBオブジェクトとして出力するための定義ファイルです。MIBオブジェクトは，SNMP Manager製品と連携する場合に使用します。

＜この節の構成＞

付録A.1　拡張MIBオブジェクト定義ファイルのテーブル

付録A.1　拡張MIBオブジェクト定義ファイルのテーブル

拡張MIBオブジェクト定義ファイルのテーブルについて説明します。

各テーブルのOIDを次に示します。

.iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).hitachi(116).systemExMib(5).cosminexusMibs(33).manager(1)

＜この項の構成＞

(1)　j2eeContainerTable

(2)　jvmTable

(3)　transactionTable

(4)　httpServerTable

(5)　httpServerConnectorTable

(6)　dataSourceTable

(7)　j2eeApplicationTable

(8)　ejbApplicationTable

(9)　statelessSessionBeanTable

(10)　statelessSessionBeanHomeTable

(11)　statelessSessionBeanRemoteTable

(12)　statefulSessionBeanTable

(13)　statefulSessionBeanHomeTable

(14)　statefulSessionBeanRemoteTable

(15)　entityBeanTable

(16)　entityBeanHomeTable

(17)　entityBeanRemoteTable

(18)　webApplicationTable

(19)　servletTable

(20)　requestUrlTable

(21)　dataSourceFullJTATable

(22)　resourceAdapterTable

(23)　statelessSessionBeanLocalHomeTable

(24)　statelessSessionBeanLocalComponentTable

(25)　statefulSessionBeanLocalHomeTable

(26)　statefulSessionBeanLocalComponentTable

(27)　entityBeanLocalHomeTable

(28)　entityBeanLocalComponentTable

(29)　messageDrivenBeanTable

(30)　queueTable

(31)　statelessSessionBeanHomeMethodTable

(32)　statelessSessionBeanRemoteMethodTable

(33)　statelessSessionBeanLocalHomeMethodTable

(34)　statelessSessionBeanLocalComponentMethodTable

(35)　statefulSessionBeanHomeMethodTable

(36)　statefulSessionBeanRemoteMethodTable

(37)　statefulSessionBeanLocalHomeMethodTable

(38)　statefulSessionBeanLocalComponentMethodTable

(39)　webContainerTable

(40)　inprocHttpSvrTable

(41)　queueAppTable

(1)　j2eeContainerTable

j2eeContainerTableを次の表に示します。

表A-1　j2eeContainerTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

j2eeContainerTable
（1）
j2eeContainerEntry
（1）
j2eeContainerIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
なし

j2eeContainerFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>"

j2eeContainerServerName
（3）
DisplayString
RO
－
J2EEサーバのサーバ名

j2eeContainerNamingServiceHost
（4）
DisplayString
RO
－
J2EEサーバの接続するネーミングサービスのホスト名

j2eeContainerNamingServicePort
（5）
INTEGER
RO
－
J2EEサーバの接続するネーミングサービスのポート番号

j2eeContainerStartedTime
（6）
INTEGER
RO
秒
J2EEサーバの起動時刻※

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

注※

00:00 Jan. 1, 1970 UTCからの経過秒数

(2)　jvmTable

jvmTableを次の表に示します。

表A-2　jvmTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

jvmTable
（2）
jvmEntry
（1）
jvmIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
なし

jvmFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>"

jvmName
（3）
DisplayString
RO
－
JavaVMの実装名

jvmVersion
（4）
DisplayString
RO
－
JavaVMの実装バージョン

jvmCurrentFreeMemory
（5）
Gauge
RO
KB
JavaVMの空きメモリ所要量（現在値）

jvmFreeMemoryHighWaterMark
（6）
Gauge
RO
KB
JavaVMの空きメモリ所要量（最大値）

jvmFreeMemoryLowWaterMark
（7）
Gauge
RO
KB
JavaVMの空きメモリ所要量（最小値）

jvmFreeMemoryAverag
（8）
Gauge
RO
KB
JavaVMの空きメモリ所要量（平均値※1）

jvmFreeMemoryPeak
（9）
Gauge
RO
KB
JavaVMの空きメモリ所要量（ピーク値※2）

jvmCurrentTotalMemory
（10）
Gauge
RO
KB
JavaVMの総メモリ所要量(使用メモリ所要量と空きメモリ所要量の総和)の現在値

jvmTotalMemoryHighWaterMark
（11）
Gauge
RO
KB
JavaVMの総メモリ所要量(使用メモリ所要量と空きメモリ所要量の総和)の最大値

jvmTotalMemoryLowWaterMark
（12）
Gauge
RO
KB
JavaVMの総メモリ所要量(使用メモリ所要量と空きメモリ所要量の総和)の最小値

jvmTotalMemoryAverage
（13）
Gauge
RO
KB
JavaVMの総メモリ所要量(使用メモリ所要量と空きメモリ所要量の総和)の平均値※1

jvmTotalMemoryPeak
（14）
Gauge
RO
KB
JavaVMの総メモリ所要量(使用メモリ所要量と空きメモリ所要量の総和)のピーク値※2

jvmMaxMemory
（15）
INTEGER
RO
KB
JavaVMの使用する最大メモリ所要量
指定されていない場合は，(2⁶³-1)/2¹⁰

jvmStatisticsStartedTime
（16）
INTEGER
RO
秒
統計開始時刻※3

jvmSamplingTime
（17）
INTEGER
RW
秒
統計のサンプリング時間※4

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

値の取得要求時点でのピーク値

このピーク値は，記録されてからサンプリング時間の有効期間を持つ最大値のことを示します。

注※3

00:00 Jan. 1, 1970 UTCからの経過秒数

注※4

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(3)　transactionTable

transactionTableを次の表に示します。

表A-3　transactionTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

transactionTable
（3）
transactionEntry
（1）
transactionIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
トランザクションの開始

transactionFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>"

transactionDefaultTransactionTimeout
（3）
INTEGER
RO
秒
トランザクションタイムアウトのデフォルト値

transactionActiveTransactionCount
（4）
Gauge
RO
－
アクティブトランザクション数（現在値）

transactionAveTime
（5）
Gauge
RO
ミリ秒
トランザクション時間（平均値※1）

transactionStatisticsStartedTime
（6）
INTEGER
RO
秒
統計開始時刻※2

transactionSamplingTime
（7）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(4)　httpServerTable

httpServerTableを次の表に示します。

表A-4　httpServerTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

httpServerTable
（4）
httpServerEntry
（1）
httpServerIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
なし

httpServerFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>"

httpServerPortNumber
（3）
INTEGER
RO
－
管理用サーバのポート番号

httpServerActiveThreadCountHighWaterMark
（4）
Gauge
RO
－
リクエスト処理中のスレッド数（最大値）

httpServerActiveThreadCountLowWaterMark
（5）
Gauge
RO
－
リクエスト処理中のスレッド数（最小値）

httpServerActiveThreadCountAverage
（6）
Gauge
RO
－
リクエスト処理中のスレッド数（平均値※1）

httpServerActiveThreadCountPeak
（7）
Gauge
RO
－
リクエスト処理中のスレッド数（ピーク値※2）

httpServerStatisticsStartedTime
（8）
INTEGER
RO
秒
統計開始時刻※3

httpServerSamplingTime
（9）
INTEGER
RW
秒
統計のサンプリング時間※4

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

値の取得要求時点でのピーク値

このピーク値は，記録されてからサンプリング時間の有効期間を持つ最大値のことを示します。

注※3

00:00 Jan. 1, 1970 UTCからの経過秒数

注※4

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(5)　httpServerConnectorTable

httpServerConnectorTableを次の表に示します。

表A-5　httpServerConnectorTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

httpServer
ConnectorTable
（5）
httpServer
ConnectorEntry
（1）
httpServerConnectorIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Webサーバ連携機能の使用

httpServerConnectorFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>"

httpServerConnectorPortNumber
（3）
INTEGER
RO
－
Webサーバとの通信に使用するポート

httpServerConnectorBackLogUpperBound
（4）
INTEGER
RO
－
Webサーバとの通信ソケットのバックログ

httpServerConnectorConnectionCount
（5）
Gauge
RO
－
WebサーバとWebコンテナとのコネクション数（現在値）

httpServerConnectorConnectionCountHighWaterMark
（6）
Gauge
RO
－
WebサーバとWebコンテナとのコネクション数（最大値）

httpServerConnectorConnectionCountLowWaterMark
（7）
Gauge
RO
－
WebサーバとWebコンテナとのコネクション数（最小値）

httpServerConnectorActiveThreadCountUpperBound
（8）
Gauge
RO
－
リクエスト処理中のスレッド数（上限値）

httpServerConnectorActiveThreadCountHighWaterMark
（9）
Gauge
RO
－
リクエスト処理中のスレッド数（最大値）

httpServerConnectorActiveThreadCountLowWaterMark
（10）
Gauge
RO
－
リクエスト処理中のスレッド数（最小値）

httpServerConnectorActiveThreadCountAverage
（11）
Gauge
RO
－
リクエスト処理中のスレッド数（平均値※1）

httpServerConnectorActiveThreadCountPeak
（12）
Gauge
RO
－
リクエスト処理中のスレッド数（ピーク値※2）

httpServerConnectorWaitingRequestCountHighWaterMark
（13）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（最大値）

httpServerConnectorWaitingRequestCountLowWaterMark
（14）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（最小値）

httpServerConnectorWaitingRequestCountAverage
（15）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（平均値※1）

httpServerConnectorWaitingRequestCountPeak
（16）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（ピーク値※2）

httpServerConnectorStatisticsStartedTime
（17）
INTEGER
RO
秒
統計開始時刻※3

httpServerConnectorSamplingTime
（18）
INTEGER
RW
秒
統計のサンプリング時間※4

httpServerConnectorActiveThreadCount
（19）
Gauge
RO
－
リクエスト処理中のスレッド数

httpServerConnectorWaitingRequestCount
（20）
Gauge
RO
－
実行を待たされているリクエスト数

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

値の取得要求時点でのピーク値

このピーク値は，記録されてからサンプリング時間の有効期間を持つ最大値のことを示します。

注※3

00:00 Jan. 1, 1970 UTCからの経過秒数

注※4

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(6)　dataSourceTable

dataSourceTableを次の表に示します。

表A-6　dataSourceTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

dataSourceTable
（6）
dataSourceEntry
（1）
dataSourceIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
データソースのインポート

dataSourceFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<データソース名>"

dataSourceName
（3）
DisplayString
RO
－
データソース名

dataSourceAuthenticationType
（4）
INTEGER
RO
－
認証タイプ
0：アプリケーションごとの認証
1：コンテナごとの認証

dataSourceLoginTimeout
（5）
INTEGER
RO
秒
ログインタイムアウト値

dataSourceUserID
（6）
DisplayString
RO
－
ユーザID

dataSourcePoolUpperBound
（7）
INTEGER
RO
－
コネクションプール数（上限値）

dataSourcePoolLowerBound
（8）
INTEGER
RO
－
コネクションプール数（下限値）

dataSourceCurrentPoolSize
（9）
Gauge
RO
－
コネクションプール数（現在値）

dataSourceActiveConnectionCount
（10）
Gauge
RO
－
使用中のコネクション数（現在値）

dataSourceFreeConnectionCount
（11）
Gauge
RO
－
未使用のコネクション数（現在値）

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

(7)　j2eeApplicationTable

j2eeApplicationTableを次の表に示します。

表A-7　j2eeApplicationTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

j2eeApplicationTable
（7）
j2eeApplicationEntry
（1）
j2eeApplicationIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
J2EEアプリケーション（EAR）の開始

j2eeApplicationFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>"※

j2eeApplicationName
（3）
DisplayString
RO
－
J2EEアプリケーション名

j2eeApplicationDeployedTime
（4）
INTEGER
RO
秒
デプロイされた時刻

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

注※

アプリケーションがテストモードで開始されている場合

"<論理サーバ名>:<J2EEアプリケーション名>_TEST"となります。

(8)　ejbApplicationTable

ejbApplicationTableを次の表に示します。

表A-8　ejbApplicationTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

ejbApplicationTable
（8）
ejbApplicationEntry
（1）
ejbApplicationIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
EJBアプリケーション（EJB-JAR）の開始

ejbApplicationFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>"

ejbApplicationName
（3）
DisplayString
RO
－
EJBアプリケーション名(EJB-JAR名)

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

(9)　statelessSessionBeanTable

statelessSessionBeanTableを次の表に示します。

表A-9　statelessSessionBeanTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSessionBeanTable
（9）
statelessSessionBeanEntry
（1）
statelessSessionBeanIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Beanの使用

statelessSessionBeanFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statelessSessionBeanName
（3）
DisplayString
RO
－
Enterprise Bean名

statelessSessionBeanHomeInterfaceName
（4）
DisplayString
RO
－
RemoteHomeインタフェースクラス名※1

statelessSessionBeanRemoteInterfaceName
（5）
DisplayString
RO
－
RemoteComponentインタフェースクラス名※1

statelessSessionBeanLocalHomeInterfaceName
（6）
DisplayString
RO
－
LocalHomeインタフェースクラス名(EJB2.0対応)※2

statelessSessionBeanLocalComponentInterfaceName
（7）
DisplayString
RO
－
LocalComponentインタフェースクラス名(EJB2.0対応)※2

statelessSessionBeanEjbClassName
（8）
DisplayString
RO
－
EJBクラス名

statelessSessionBeanPoolUpperBound
（9）
INTEGER
RO
－
インスタンスプール数（上限値）

statelessSessionBeanPoolLowerBound
（10）
INTEGER
RO
－
インスタンスプール数（下限値）

statelessSessionBeanCurrentPoolSize
（11）
Gauge
RO
－
インスタンスプール数（現在値）

statelessSessionBeanWaitingSessionCount
（12）
Gauge
RO
－
接続待ちセッション数（現在値）

statelessSessionBeanActiveSessionBeanCount
（13）
Gauge
RO
－
使用中のStateless Session Bean数（現在値）

statelessSessionBeanFreeSessionBeanCount
（14）
Gauge
RO
－
未使用のStateless Session Bean数（現在値）

statelessSessionBeanFreeSessionTransactionType
（15）
DisplayString
RO
－
トランザクションタイプ
"CMT"または"BMT"

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

注※1

Localインタフェースだけの場合は，""（空文字）を表示します。

注※2

Remoteインタフェースだけの場合は，""（空文字）を表示します。

(10)　statelessSessionBeanHomeTable

statelessSessionBeanHomeTableを次の表に示します。

表A-10　statelessSessionBeanHomeTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSession
BeanHomeTable
（10）
statelessSession
BeanHomeEntry
（1）
statelessSessionBeanHomeIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Bean Remote Home Interfaceの使用

statelessSessionBeanHomeFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statelessSessionBeanHomeName
（3）
DisplayString
RO
－
RemoteHomeインタフェースクラス名

statelessSessionBeanHomeResponseMaxTime
（4）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（最大値）

statelessSessionBeanHomeResponseMinTime
（5）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（最小値）

statelessSessionBeanHomeResponseAveTime
（6）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statelessSessionBeanHomeStatisticsStartedTime
（7）
INTEGER
RO
秒
統計開始時刻※2

statelessSessionBeanHomeSamplingTime
（8）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(11)　statelessSessionBeanRemoteTable

statelessSessionBeanRemoteTableを次の表に示します。

表A-11　statelessSessionBeanRemoteTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSession
BeanRemoteTable
（11）
statelessSession
BeanRemoteEntry
（1）
statelessSessionBeanRemoteIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Bean Remote Component Interfaceの使用

statelessSessionBeanRemoteFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statelessSessionBeanRemoteName
（3）
DisplayString
RO
－
RemoteComponentインタフェースクラス名

statelessSessionBeanRemoteResponseMaxTime
（4）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（最大値）

statelessSessionBeanRemoteResponseMinTime
（5）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（最小値）

statelessSessionBeanRemoteResponseAveTime
（6）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statelessSessionBeanRemoteResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（最大値）

statelessSessionBeanRemoteResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（最小値）

statelessSessionBeanRemoteResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（平均値※1）

statelessSessionBeanRemoteStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

statelessSessionBeanRemoteSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(12)　statefulSessionBeanTable

statefulSessionBeanTableを次の表に示します。

表A-12　statefulSessionBeanTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSession
BeanTable
（12）
statefulSession
BeanEntry
（1）
statefulSessionBeanIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Beanの使用

statefulSessionBeanFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statefulSessionBeanName
（3）
DisplayString
RO
－
Enterprise Bean名

statefulSessionBeanHomeInterfaceName
（4）
DisplayString
RO
－
RemoteHomeインタフェースクラス名※1

statefulSessionBeanRemoteInterfaceName
（5）
DisplayString
RO
－
RemoteComponentインタフェースクラス名※1

statefulSessionBeanLocalHomeInterfaceName
（6）
DisplayString
RO
－
LocalHomeインタフェースクラス名※2

statefulSessionBeanLocalComponentInterfaceName
（7）
DisplayString
RO
－
LocalComponentインタフェースクラス名※2

statefulSessionBeanEjbClassName
（8）
DisplayString
RO
－
EJBクラス名

statefulSessionBeanSessionUpperBound
（9）
INTEGER
RO
－
同時接続数（上限値）

statefulSessionBeanActiveSessionUpperBound
（10）
INTEGER
RO
－
同時実行数（上限値）

statefulSessionBeanPassivateTimeout
（11）
INTEGER
RO
秒
非活性セッションのタイムアウト値

statefulSessionBeanActiveTimeout
（12）
INTEGER
RO
秒
実行中セッションのタイムアウト値

statefulSessionBeanCurrentSessionCount
（13）
Gauge
RO
－
接続セッション数（現在値）

statefulSessionBeanWaitingSessionCount
（14）
Gauge
RO
－
接続待ちセッション数（現在値）

statefulSessionBeanActiveSessionCount
（15）
Gauge
RO
－
実行中セッション数（現在値）

statefulSessionBeanPassiveSessionCount
（16）
Gauge
RO
－
非活性セッション数（現在値）

statefulSessionBeanTransactionType
（17）
DisplayString
RO
－
トランザクションタイプ
"CMT"または"BMT"

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

注※1

Localインタフェースだけの場合は，""（空文字）を表示します。

注※2

Remoteインタフェースだけの場合は，""（空文字）を表示します。

(13)　statefulSessionBeanHomeTable

statefulSessionBeanHomeTableを次の表に示します。

表A-13　statefulSessionBeanHomeTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSession
BeanHomeTable
（13）
statefulSession
BeanHomeEntry
（1）
statefulSessionBeanHomeIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Bean Remote Home Interfaceの使用

statefulSessionBeanHomeFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statefulSessionBeanHomeName
（3）
DisplayString
RO
－
RemoteHomeインタフェースクラス名

statefulSessionBeanHomeResponseMaxTime
（4）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（最大値）

statefulSessionBeanHomeResponseMinTime
（5）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（最小値）

statefulSessionBeanHomeResponseAveTime
（6）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statefulSessionBeanHomeResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対するEJBメソッド実行時間（最大値）

statefulSessionBeanHomeResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対するEJBメソッド実行時間（最小値）

statefulSessionBeanHomeResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対するEJBメソッド実行時間（平均値※1）

statefulSessionBeanHomeStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

statefulSessionBeanHomeSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(14)　statefulSessionBeanRemoteTable

statefulSessionBeanRemoteTableを次の表に示します。

表A-14　statefulSessionBeanRemoteTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSession
BeanRemoteTable
（14）
statefulSession
BeanRemoteEntry
（1）
statefulSessionBeanRemoteIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Bean Remote Component Interfaceの使用

statefulSessionBeanRemoteFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statefulSessionBeanRemoteName
（3）
DisplayString
RO
－
RemoteComponentインタフェースクラス名

statefulSessionBeanRemoteResponseMaxTime
（4）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（最大値）

statefulSessionBeanRemoteResponseMinTime
（5）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（最小値）

statefulSessionBeanRemoteResponseAveTime
（6）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statefulSessionBeanRemoteResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対するEJBメソッド実行時間（最大値）

statefulSessionBeanRemoteResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対するEJBメソッド実行時間（最小値）

statefulSessionBeanRemoteResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対するEJBメソッド実行時間（平均値※1）

statefulSessionBeanRemoteStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

statefulSessionBeanRemoteSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(15)　entityBeanTable

entityBeanTableを次の表に示します。

表A-15　entityBeanTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

entityBeanTable
（15）
entityBeanEntry
（1）
entityBeanIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Entity Beanの使用

entityBeanFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

entityBeanName
（3）
DisplayString
RO
－
Enterprise Bean名

entityBeanHomeInterfaceName
（4）
DisplayString
RO
－
RemoteHomeインタフェースクラス名※1

entityBeanRemoteInterfaceName
（5）
DisplayString
RO
－
RemoteComponentインタフェースクラス名※1

entityBeanLocalHomeInterfaceName
（6）
DisplayString
RO
－
LocalHomeインタフェースクラス名※2

entityBeanLocalComponentInterfaceName
（7）
DisplayString
RO
－
LocalComponentインタフェースクラス名※2

entityBeanEjbClassName
（8）
DisplayString
RO
－
EJBクラス名

entityBeanPersistenceType
（9）
DisplayString
RO
－
永続化タイプ
CMPまたはBMP

entityBeanCacheOption
（10）
DisplayString
RO
－
キャッシュモデル
A：Full Cache
B：Cache
C：No Cache

entityBeanSessionUpperBound
（11）
INTEGER
RO
－
同時接続数（上限値）

entityBeanPoolUpperBound
（12）
INTEGER
RO
－
インスタンスプール数（上限値）

entityBeanPoolLowerBound
（13）
INTEGER
RO
－
インスタンスプール数（下限値）

entityBeanCurrentPoolSize
（14）
Gauge
RO
－
インスタンスプール数（現在値）

entityBeanSessionTimeout
（15）
INTEGER
RO
－
接続タイムアウト値

entityBeanCurrentSessionCount
（16）
Gauge
RO
－
接続セッション数（現在値）

entityBeanWaitingSessionCount
（17）
Gauge
RO
－
接続待ちセッション数（現在値）

entityBeanActiveEntityBeanCount
（18）
Gauge
RO
－
使用中のEntity Bean数（現在値）

entityBeanFreeEntityBeanCount
（19）
Gauge
RO
－
未使用のEntity Bean数（現在値）

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

注※1

Localインタフェースだけの場合は，""（空文字）を表示します。

注※2

Remoteインタフェースだけの場合は，""（空文字）を表示します。

(16)　entityBeanHomeTable

entityBeanHomeTableを次の表に示します。

表A-16　entityBeanHomeTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

entityBeanHomeTable
（16）
entityBeanHomeEntry
（1）
entityBeanHomeIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Entity Bean Remote Home Interfaceの使用

entityBeanHomeFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

entityBeanHomeName
（3）
DisplayString
RO
－
RemoteHomeインタフェースクラス名

entityBeanHomeResponseMaxTime
（4）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（最大値）

entityBeanHomeResponseMinTime
（5）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（最小値）

entityBeanHomeResponseAveTime
（6）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

entityBeanHomeResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対するEJBメソッド実行時間（最大値）

entityBeanHomeResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対するEJBメソッド実行時間（最小値）

entityBeanHomeResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
RemoteHomeインタフェースに対するEJBメソッド実行時間（平均値※1）

entityBeanHomeStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

entityBeanHomeSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(17)　entityBeanRemoteTable

entityBeanRemoteTableを次の表に示します。

表A-17　entityBeanRemoteTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

entityBeanRemoteTable
（17）
entityBeanRemoteEntry
（1）
entityBeanRemoteIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Entity Bean Remote Component Interfaceの使用

entityBeanRemoteFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

entityBeanRemoteName
（3）
DisplayString
RO
－
RemoteComponentインタフェースクラス名

entityBeanRemoteResponseMaxTime
（4）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（最大値）

entityBeanRemoteResponseMinTime
（5）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（最小値）

entityBeanRemoteResponseAveTime
（6）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対する呼び出しのレスポンス時間（平均値※1）

entityBeanRemoteResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対するEJBメソッド実行時間（最大値）

entityBeanRemoteResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対するEJBメソッド実行時間（最小値）

entityBeanRemoteResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
RemoteComponentインタフェースに対するEJBメソッド実行時間（平均値※1）

entityBeanRemoteStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

entityBeanRemoteSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(18)　webApplicationTable

webApplicationTableを次の表に示します。

表A-18　webApplicationTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

webApplicationTable
（18）
webApplicationEntry
（1）
webApplicationIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Webアプリケーション（WAR）の使用

webApplicationFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<コンテキストルート>"

webApplicationContextRoot
（3）
DisplayString
RO
－
コンテキストルート

webApplicationActiveSessionCount
（4）
Gauge
RO
－
使用中のセッション数（現在値）

webApplicationTotalJSPServiceCount
（5）
Counter
RO
－
JSPの実行回数（累積値）

webApplicationTotalJSPServiceFailedCount
（6）
Counter
RO
－
JSPの実行失敗回数（累積値）

webApplicationTotalJSPServiceMaxTime
（7）
Gauge
RO
ミリ秒
JSPの実行時間（最大値）

webApplicationTotalJSPServiceMinTime
（8）
Gauge
RO
ミリ秒
JSPの実行時間（最小値）

webApplicationTotalJSPServiceAveTime
（9）
Gauge
RO
ミリ秒
JSPの実行時間（平均値※1）

webApplicationTotalJSPServicePeak
（10）
Gauge
RO
ミリ秒
JSPの実行時間（ピーク値※2）

webApplicationTotalJSPServiceOutputDataSizeMax
（11）
Gauge
RO
KB
JSPの出力データサイズ（最大値）

webApplicationTotalJSPServiceOutputDataSizeMin
（12）
Gauge
RO
KB
JSPの出力データサイズ（最小値）

webApplicationTotalJSPServiceOutputDataSizeAve
（13）
Gauge
RO
KB
JSPの出力データサイズ（平均値※1）

webApplicationTotalJSPServiceOutputDataSizePeak
（14）
Gauge
RO
KB
JSPの出力データサイズ（ピーク値※2）

webApplicationTotalStaticFileServiceCount
（15）
Counter
RO
－
静的コンテンツのアクセス回数（累積値）

webApplicationTotalStaticFileServiceFailedCount
（16）
Counter
RO
－
静的コンテンツのアクセス失敗回数（累積値）

webApplicationTotalStaticFileServiceMaxTime
（17）
Gauge
RO
ミリ秒
静的コンテンツの取得処理時間（最大値）

webApplicationTotalStaticFileServiceMinTime
（18）
Gauge
RO
ミリ秒
静的コンテンツの取得処理時間（最小値）

webApplicationTotalStaticFileServiceAveTime
（19）
Gauge
RO
ミリ秒
静的コンテンツの取得処理時間（平均値※1）

webApplicationTotalStaticFileServicePeak
（20）
Gauge
RO
ミリ秒
静的コンテンツの取得処理時間（ピーク値※2）

webApplicationTotalStaticFileServiceOutputDataSizeMax
（21）
Gauge
RO
KB
静的コンテンツの出力データサイズ（最大値）

webApplicationTotalStaticFileServiceOutputDataSizeMin
（22）
Gauge
RO
KB
静的コンテンツの出力データサイズ（最小値）

webApplicationTotalStaticFileServiceOutputDataSizeAve
（23）
Gauge
RO
KB
静的コンテンツの出力データサイズ（平均値※1）

webApplicationTotalStaticFileServiceOutputDataSizePeak
（24）
Gauge
RO
KB
静的コンテンツの出力データサイズ（ピーク値※2）

webApplicationStatisticsStartedTime
（25）
INTEGER
RO
秒
統計開始時刻※3

webApplicationSamplingTime
（26）
INTEGER
RW
秒
統計のサンプリング時間※4

webApplicationExclusiveThreadCountUpperBound
（27）
INTEGER
RO
－
占有スレッド数

Webアプリケーション（WAR）の使用

同時実行スレッド数制御機能の使用

webApplicationActiveThreadCountUpperBound
（28）
INTEGER
RO
－
リクエスト処理中のスレッド数（上限値）

webApplicationCurrentThreadCountUpperBound
（29）
Gauge
RO
－
リクエスト処理中のスレッド数（現在上限値※5）

webApplicationActiveThreadCount
（30）
Gauge
RO
－
リクエスト処理中のスレッド数（現在値）

webApplicationActiveThreadCountHighWaterMark
（31）
Gauge
RO
－
リクエスト処理中のスレッド数（最大値）

webApplicationActiveThreadCountLowWaterMark
（32）
Gauge
RO
－
リクエスト処理中のスレッド数（最小値）

webApplicationActiveThreadCountAverage
（33）
Gauge
RO
－
リクエスト処理中のスレッド数（平均値※1）

webApplicationActiveThreadCountPeak
（34）
Gauge
RO
－
リクエスト処理中のスレッド数（ピーク値※2）

webApplicationWaitingRequestCountUpperBound
（35）
INTEGER
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（上限値）

webApplicationWaitingRequestCount
（36）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（現在値）

webApplicationWaitingRequestCountHighWaterMark
（37）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（最大値）

webApplicationWaitingRequestCountLowWaterMark
（38）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（最小値）

webApplicationWaitingRequestCountAverage
（39）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（平均値※1）

webApplicationWaitingRequestCountPeak
（40）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数（ピーク値※2）

webApplicationOverflowRequestCount
（41）
Counter
RO
－
実行待ちリクエストの上限値の設定によって，エラーを返したリクエスト数（累積値）

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

値の取得要求時点でのピーク値

このピーク値は，記録されてからサンプリング時間の有効期間を持つ最大値のことを示します。

注※3

00:00 Jan. 1, 1970 UTCからの経過秒数

注※4

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

注※5

現在の同時実行できるスレッド数の上限

(19)　servletTable

servletTableを次の表に示します。

表A-19　servletTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

servletTable
（19）
servletEntry
（1）
servletIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
サーブレットの使用

servletFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<コンテキストルート>:<Servletクラス名>"

servletName
（3）
DisplayString
RO
－
web.xmlに記述されたサーブレット名
設定されていない場合は，空文字

servletServletClassName
（4）
DisplayString
RO
－
Servletクラス名

servletServiceCount
（5）
Counter
RO
－
サーブレットの実行回数（累積値）

servletServiceFailedCount
（6）
Counter
RO
－
サーブレットの実行失敗回数（累積値）

servletServiceMaxTime
（7）
Gauge
RO
ミリ秒
サーブレットの実行時間（最大値）

servletServiceMinTime
（8）
Gauge
RO
ミリ秒
サーブレットの実行時間（最小値）

servletServiceAveTime
（9）
Gauge
RO
ミリ秒
サーブレットの実行時間（平均値※1）

servletServicePeak
（10）
Gauge
RO
ミリ秒
サーブレットの実行時間（ピーク値※2）

servletServiceOutputDataSizeMax
（11）
Gauge
RO
KB
サーブレットの出力データサイズ（最大値）

servletServiceOutputDataSizeMin
（12）
Gauge
RO
KB
サーブレットの出力データサイズ（最小値）

servletServiceOutputDataSizeAve
（13）
Gauge
RO
KB
サーブレットの出力データサイズ（平均値※1）

servletServiceOutputDataSizePeak
（14）
Gauge
RO
KB
サーブレットの出力データサイズ（ピーク値※2）

servletStatisticsStartTime
（15）
INTEGER
RO
秒
統計開始時刻※3

servletSamplingTime
（16）
INTEGER
RW
秒
統計のサンプリング時間※4

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

値の取得要求時点でのピーク値

このピーク値は，記録されてからサンプリング時間の有効期間を持つ最大値のことを示します。

注※3

00:00 Jan. 1, 1970 UTCからの経過秒数

注※4

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(20)　requestUrlTable

requestUrlTableを次の表に示します。

表A-20　requestUrlTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

requestUrlTable
（20）
requestUrlEntry
（1）
requestUrlIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
requestUrlの統計開始，かつ該当WebアプリケーションへのURLアクセス

requestUrlFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<コンテキストルート>:<リクエストURL>"

requestUrl
（3）
DisplayString
RO
－
リクエストURL

requestUrlServiceCount
（4）
Counter
RO
－
リクエスト実行回数（累積値）

requestUrlServiceFailedCount
（5）
Counter
RO
－
リクエスト失敗回数（累積値）

requestUrlServiceMaxTime
（6）
Gauge
RO
ミリ秒
リクエスト実行時間（最大値）

requestUrlServiceMinTime
（7）
Gauge
RO
ミリ秒
リクエスト実行時間（最小値）

requestUrlServiceAveTime
（8）
Gauge
RO
ミリ秒
リクエスト実行時間（平均値※1）

requestUrlServicePeak
（9）
Gauge
RO
ミリ秒
リクエスト実行時間（ピーク値※2）

requestUrlServiceOutputDataSizeMax
（10）
Gauge
RO
KB
リクエスト出力データサイズ（最大値）

requestUrlServiceOutputDataSizeMin
（11）
Gauge
RO
KB
リクエスト出力データサイズ（最小値）

requestUrlServiceOutputDataSizeAve
（12）
Gauge
RO
KB
リクエスト出力データサイズ（平均値※1）

requestUrlServiceOutputDataSizePeak
（13）
Gauge
RO
KB
リクエスト出力データサイズ（ピーク値※2）

requestUrlStatisticsStartedTime
（14）
INTEGER
RO
秒
統計開始時刻※3

requestUrlSamplingTime
（15）
INTEGER
RW
秒
統計のサンプリング時間※4

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

値の取得要求時点でのピーク値

このピーク値は，記録されてからサンプリング時間の有効期間を持つ最大値のことを示します。

注※3

00:00 Jan. 1, 1970 UTCからの経過秒数

注※4

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(21)　dataSourceFullJTATable

dataSourceFullJTATableを次の表に示します。

表A-21　dataSourceFullJTATable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

dataSourceFullJTATable
（21）
dataSourceFullJTAEntry
（1）
dataSourceFullJTAIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
データソース（XA）のインポート

dataSourceFullJTAFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<データソース名>"

dataSourceFullJTAName
（3）
DisplayString
RO
－
データソース名

dataSourceFullJTALoginTimeout
（4）
INTEGER
RO
秒
ログインタイムアウト値

dataSourceFullJTAUserID
（5）
DisplayString
RO
－
ユーザID

dataSourceFullJTAPoolUpperBound
（6）
INTEGER
RO
－
コネクションプールの数（上限値）

dataSourceFullJTAPoolLowerBound
（7）
INTEGER
RO
－
コネクションプールの数（下限値）

dataSourceFullJTACurrentPoolSize
（8）
Gauge
RO
－
コネクションプールの数（現在値）

dataSourceFullJTAActiveConnectionCount
（9）
Gauge
RO
－
使用中のコネクション数（現在値）

dataSourceFullJTAFreeConnectionCount
（10）
Gauge
RO
－
未使用のコネクション数（現在値）

dataSourceFullJTAGetConnectionMaxTime
（11）
Gauge
RO
ミリ秒
getConnectionメソッドの実行時間（最大値）

dataSourceFullJTAGetConnectionMinTime
（12）
Gauge
RO
ミリ秒
getConnectionメソッドの実行時間（最小値）

dataSourceFullJTAGetConnectionAveTime
（13）
Gauge
RO
ミリ秒
getConnectionメソッドの実行時間（平均値※1）

dataSourceFullJTACreateConnectionMaxTime
（14）
Gauge
RO
ミリ秒
getXAConnectionメソッド実行時間（最大値）

dataSourceFullJTACreateConnectionMinTime
（15）
Gauge
RO
ミリ秒
getXAConnectionメソッド実行時間（最小値）

dataSourceFullJTACreateConnectionAveTime
（16）
Gauge
RO
ミリ秒
getXAConnectionメソッド実行時間（平均値※1）

dataSourceFullJTAGetConnectionFailedCount
（17）
Counter
RO
－
getConnectionメソッドの失敗回数

dataSourceFullJTAConnectionErrorCount
（18）
Counter
RO
－
ConnectionでFATALエラーが発生した回数
ConnectionEventListenerのconnectionErrorOccurredメソッドが呼ばれた回数

dataSourceFullJTAStatisticsStartedTime
（19）
INTEGER
RO
秒
統計開始時刻※2

dataSourceFullJTASamplingTime
（20）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(22)　resourceAdapterTable

resourceAdapterTableを次の表に示します。

表A-22　resourceAdapterTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

resourceAdapterTable
（22）
resourceAdapterEntry
（1）
resourceAdapterIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
リソースアダプタの使用

resourceAdapterFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<リソースアダプタ名>"：コンテナ
"<論理サーバ名>:<J2EEアプリケーション名>:<リソースアダプタ名>"：アプリケーション"

resourceAdapterName
（3）
DisplayString
RO
－
リソースアダプタ名

resourceAdapterVendorName
（4）
DisplayString
RO
－
リソースアダプタ提供ベンダ名

resourceAdapterSpecVersion
（5）
DisplayString
RO
－
リソースアダプタが準拠するJCA使用のバージョン

resourceAdapterEISType
（6）
DisplayString
RO
－
リソースアダプタの接続先EISのタイプ

resourceAdapterVersion
（7）
DisplayString
RO
－
リソースアダプタのバージョン

resourceAdapterConnectionFactoryInterfaceName
（8）
DisplayString
RO
－
ConnectionFactoryのインタフェースクラス名

resourceAdapterConnectionFactoryImplName
（9）
DisplayString
RO
－
ConnectionFactoryの実装クラス名

resourceAdapterManagedConnectionFactoryImplName
（10）
DisplayString
RO
－
ManagedConnectionFactoryの実装クラス名

resourceAdapterConnectionInterfaceName
（11）
DisplayString
RO
－
Connectionのインタフェースクラス名

resourceAdapterConnectionImplName
（12）
DisplayString
RO
－
Connectionの実装クラス名

resourceAdapterTransactionSupport
（13）
DisplayString
RO
－
トランザクションのサポートモデル
NoTransaction：トランザクションなし
LocalTransaction：ローカルトランザクション
XATransaction：XAトランザクション

resourceAdapterConfigProperties
（14）
DisplayString
RO
－
ConfigurationProperty情報※1

resourceAdapterMConCreateCount
（15）
Counter
RO
－
ManagedConnectionFactoryのcreateManagedConnectionメソッドの実行回数※2

resourceAdapterConCreateCount
（16）
Counter
RO
－
ManagedConnectionのgetConnectionメソッドの実行回数※2

resourceAdapterMConCleanupCount
（17）
Counter
RO
－
ManagedConnectionのcleanupメソッドの実行回数※2

resourceAdapterMConDestroyCount
（18）
Counter
RO
－
ManagedConnectionのdestroyメソッドの実行回数※2

resourceAdapterUserId
（19）
DisplayString
RO
－
ユーザID

resourceAdapterPoolUpperBound
（20）
INTEGER
RO
－
コネクションプールの数※2（上限値）

resourceAdapterPoolLowerBound
（21）
INTEGER
RO
－
コネクションプールの数※2（下限値）

resourceAdapterCurrentPoolSize
（22）
Gauge
RO
－
コネクションプールの数※2（現在値）

resourceAdapterActiveConnectionCount
（23）
Gauge
RO
－
使用中のコネクション数※2（現在値）

resourceAdapterFreeConnectionCount
（24）
Gauge
RO
－
未使用のコネクション数※2（現在値）

resourceAdapterGetConnectionMaxTime
（25）
Gauge
RO
ミリ秒
ConnectionManagerのallocateConnectionメソッド実行時間※3,※4（最大値）

resourceAdapterGetConnectionMinTime
（26）
Gauge
RO
ミリ秒
ConnectionManagerのallocateConnectionメソッド実行時間※3,※4（最小値）

resourceAdapterGetConnectionAveTime
（27）
Gauge
RO
ミリ秒
ConnectionManagerのallocateConnectionメソッド実行時間※2,※5（平均値※6）

resourceAdapterCreateConnectionMaxTime
（28）
Gauge
RO
ミリ秒
ManagedConnectionFactoryのcreateManagedConnectionメソッド実行時間※3（最大値）

resourceAdapterCreateConnectionMinTime
（29）
Gauge
RO
ミリ秒
ManagedConnectionFactoryのcreateManagedConnectionメソッド実行時間※3（最小値）

resourceAdapterCreateConnectionAveTime
（30）
Gauge
RO
ミリ秒
ManagedConnectionFactoryのcreateManagedConnectionメソッド実行時間※2（平均値※6）

resourceAdapterGetConnectionFailedCount
（31）
Counter
RO
－
allocateConnectionメソッドの失敗回数※2,※5

resourceAdapterConnectionErrorCount
（32）
Counter
RO
－
ManagedConnectionでFATALエラーが発生した回数
ConnectionEventListenerのconnectionErrorOccurredメソッドが呼ばれた回数※2

resourceAdapterStatisticsStartedTime
（33）
INTEGER
RO
秒
統計開始時刻※7

resourceAdapterSamplingTime
（34）
INTEGER
RW
秒
統計のサンプリング時間※8

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

出力形式は，<プロパティ名>=<プロパティ値>:<プロパティ名>=<プロパティ値>: ・・・とします。プロパティ名，またはプロパティ値に"="，":"，"¥"が含まれる場合は，"¥="，"¥:"，"¥¥"として表示します。

(例)　プロパティ名・・・"abc" プロパティ値・・・"ab:bc=ef¥gh"の場合

　abc=ab¥:bc¥=ef¥¥gh

注※2

ルートリソースアダプタでは0が表示されます。

注※3

メンバリソースアダプタではNot Availableが表示されます。

注※4

ルートリソースアダプタではNot Availableが表示されます。

注※5

メンバリソースアダプタでは0が表示されます。

注※6

値の取得要求時刻から過去サンプリング時間の平均値

注※7

00:00 Jan. 1, 1970 UTCからの経過秒数

注※8

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(23)　statelessSessionBeanLocalHomeTable

statelessSessionBeanLocalHomeTableを次の表に示します。

表A-23　statelessSessionBeanLocalHomeTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSession
BeanLocalHomeTable
（23）
statelessSession
BeanLocalHomeEntry
（1）
statelessSessionBeanLocalHomeIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Bean Local Home Interfaceの使用

statelessSessionBeanLocalHomeFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statelessSessionBeanLocalHomeName
（3）
DisplayString
RO
－
LocalHomeインタフェースクラス名

statelessSessionBeanLocalHomeResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最大値）

statelessSessionBeanLocalHomeResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最小値）

statelessSessionBeanLocalHomeResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statelessSessionBeanLocalHomeStatisticsStartedTime
（7）
INTEGER
RO
秒
統計開始時刻※2

statelessSessionBeanLocalHomeSamplingTime
（8）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(24)　statelessSessionBeanLocalComponentTable

statelessSessionBeanLocalComponentTableを次の表に示します。

表A-24　statelessSessionBeanLocalComponentTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSession
BeanLocalComponentTable
（24）
statelessSession
BeanLocalComponentTable
（1）
statelessSessionBeanLocalComponentIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Bean Local Component Interfaceの使用

statelessSessionBeanLocalComponentFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statelessSessionBeanLocalComponentFullyQualifiedName
（3）
DisplayString
RO
－
LocalComponentインタフェースクラス名

statelessSessionBeanLocalComponentResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最大値）

statelessSessionBeanLocalComponentResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最小値）

statelessSessionBeanLocalComponentResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statelessSessionBeanLocalComponentResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最大値）

statelessSessionBeanLocalComponentResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最小値）

statelessSessionBeanLocalComponentResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（平均値※1）

statelessSessionBeanLocalComponentStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

statelessSessionBeanLocalComponentSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(25)　statefulSessionBeanLocalHomeTable

statefulSessionBeanLocalHomeTableを次の表に示します。

表A-25　statefulSessionBeanLocalHomeTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSession
BeanLocalHomeTable
（25）
statefulSession
BeanLocalHomeEntry
（1）
statefulSessionBeanLocalHomeIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Bean Local Home Interfaceの使用

statefulSessionBeanLocalHomeFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statefulSessionBeanLocalHomeName
（3）
DisplayString
RO
－
LocalHomeインタフェースクラス名

statefulSessionBeanLocalHomeResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最大値）

statefulSessionBeanLocalHomeResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最小値）

statefulSessionBeanLocalHomeResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statefulSessionBeanLocalHomeResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（最大値）

statefulSessionBeanLocalHomeResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（最小値）

statefulSessionBeanLocalHomeResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（平均値※1）

statefulSessionBeanLocalHomeStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

statefulSessionBeanLocalHomeSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(26)　statefulSessionBeanLocalComponentTable

statefulSessionBeanLocalComponentTableを次の表に示します。

表A-26　statefulSessionBeanLocalComponentTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSession
BeanLocalComponentTable
（26）
statefulSession
BeanLocalComponentEntry
（1）
statefulSessionBeanLocalComponentIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Bean Local Component Interfaceの使用

statefulSessionBeanLocalComponentFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

statefulSessionBeanLocalComponentName
（3）
DisplayString
RO
－
LocalComponentインタフェースクラス名

statefulSessionBeanLocalComponentResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最大値）

statefulSessionBeanLocalComponentResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最小値）

statefulSessionBeanLocalComponentResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statefulSessionBeanLocalComponentResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最大値）

statefulSessionBeanLocalComponentResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最小値）

statefulSessionBeanLocalComponentResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（平均値※1）

statefulSessionBeanLocalComponentStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

statefulSessionBeanLocalComponentSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(27)　entityBeanLocalHomeTable

entityBeanLocalHomeTableを次の表に示します。

表A-27　entityBeanLocalHomeTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

entityBeanLocalHomeTable
（27）
entityBeanLocalHomeEntry
（1）
entityBeanLocalHomeIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Entity Bean Local Home Interfaceの使用

entityBeanLocalHomeFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

entityBeanLocalHomeName
（3）
DisplayString
RO
－
LocalHomeインタフェースクラス名

entityBeanLocalHomeResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最大値）

entityBeanLocalHomeResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最小値）

entityBeanLocalHomeResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

entityBeanLocalHomeResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocaHomeインタフェースに対するEJBメソッドの実行時間（最大値）

entityBeanLocalHomeResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocaHomeインタフェースに対するEJBメソッドの実行時間（最小値）

entityBeanLocalHomeResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocaHomeインタフェースに対するEJBメソッドの実行時間（平均値※1）

entityBeanLocalHomeStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

entityBeanLocalHomeSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(28)　entityBeanLocalComponentTable

entityBeanLocalComponentTableを次の表に示します。

表A-28　entityBeanLocalComponentTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

entityBeanLocal
ComponentTable
（28）
entityBeanLocal
ComponentEntry
（1）
entityBeanLocalComponentIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Entity Bean Local Component Interfaceの使用

entityBeanLocalComponentFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

entityBeanLocalComponentName
（3）
DisplayString
RO
－
LocalComponentインタフェースクラス名

entityBeanLocalComponentResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最大値）

entityBeanLocalComponentResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最小値）

entityBeanLocalComponentResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（平均値※1）

entityBeanLocalComponentResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最大値）

entityBeanLocalComponentResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最小値）

entityBeanLocalComponentResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（平均値※1）

entityBeanLocalComponentStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

entityBeanLocalComponentSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(29)　messageDrivenBeanTable

messageDrivenBeanTableを次の表に示します。

表A-29　messageDrivenBeanTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

messageDrivenBeanTable
（29）
messageDrivenBeanEntry
（1）
messageDrivenBeanIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Message-driven Beanの使用

messageDrivenBeanFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>"

messageDrivenBeanName
（3）
DisplayString
RO
－
Enterprise Bean名

messageDrivenBeanEjbClassName
（4）
DisplayString
RO
－
EJBクラス名

messageDrivenBeanTransactionType
（5）
DisplayString
RO
－
トランザクションタイプ
CMTまたはBMT

messageDrivenBeanDestinationType
（6）
DisplayString
RO
－
デスティネーションタイプ
Queue：Point-To-Pointモデルのデスティネーション
Topic：Publish-Subscribeモデルのデスティネーション

messageDrivenBeanPoolUpperBound
（7）
INTEGER
RO
－
インスタンスプールの数（上限値）

messageDrivenBeanCurrentPoolSize
（8）
Gauge
RO
－
インスタンスプールの数（現在値）

messageDrivenBeanCurrentSessionCount
（9）
Gauge
RO
－
接続セッション数（現在値）

messageDrivenBeanResponseEjbMaxTime
（10）
Gauge
RO
ミリ秒
EJBメソッドの実行時間（最大値）

messageDrivenBeanResponseEjbMinTime
（11）
Gauge
RO
ミリ秒
EJBメソッドの実行時間（最小値）

messageDrivenBeanResponseEjbAveTime
（12）
Gauge
RO
ミリ秒
EJBメソッドの実行時間（平均値※1）

messageDrivenBeanStatisticsStartedTime
（10）
INTEGER
RO
秒
統計開始時刻※2

messageDrivenBeanSamplingTime
（11）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(30)　queueTable

queueTableを次の表に示します。

表A-30　queueTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

queueTable
（30）
queueEntry
（1）
queueIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
なし

queueFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<キュー名>"

queueName
（3）
DisplayString
RO
－
キュー名

queueStatus
（4）
DisplayString
RO
－
状態
scheduling：スケジュール可能状態
preparing：準備中
stopping：キュー終了処理中
closing[in]：キュー入り口閉塞中
closing[out]：キュー出口閉塞中

queueSharedApplicationCount
（5）
INTEGER
RO
－
キューを共有しているアプリケーション数

queueStayedRequestCount
（6）
Gauge
RO
－
キューに滞留しているリクエスト数

queueStayedRequestMax
（7）
Gauge
RO
－
キューに滞留した最大リクエスト数

queueLength
（8）
INTEGER
RO
－
同時に登録できるリクエスト数

queueLookupName
（9）
DisplayString
RO
－
キューが管理している登録名情報

queueInterfaceName
（10）
DisplayString
RO
－
キューが管理しているインタフェース情報

queueParallelCount
（11）
INTEGER
RO
－
キューが管理している同時実行数

queueTotalThreadCount
（12）
INTEGER
RO
－
キューが管理している現在の総常駐スレッド数

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

(31)　statelessSessionBeanHomeMethodTable

statelessSessionBeanHomeMethodTableを次の表に示します。

表A-31　statelessSessionBeanHomeMethodTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSessionBean
HomeMethodTable
（31）
statelessSessionBean
HomeMethodEntry
（1）
statelessSessionBeanHomeMethodIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Bean Remote Home Interface Methodの使用

statelessSessionBeanHomeMethodFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>:<Homeインタフェースクラス名>:<メソッド名>"

statelessSessionBeanHomeMethodName
（3）
DisplayString
RO
－
メソッド名

statelessSessionBeanHomeMethodResponseMaxTime
（4）
Gauge
RO
ミリ秒
Homeインタフェースに対する呼び出しのレスポンス時間（最大値）

statelessSessionBeanHomeMethodResponseMinTime
（5）
Gauge
RO
ミリ秒
Homeインタフェースに対する呼び出しのレスポンス時間（最小値）

statelessSessionBeanHomeMethodResponseAveTime
（6）
Gauge
RO
ミリ秒
Homeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statelessSessionBeanHomeMethodResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
Homeインタフェースに対するEJBメソッドの実行時間（最大値）

statelessSessionBeanHomeMethodResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
Homeインタフェースに対するEJBメソッドの実行時間（最小値）

statelessSessionBeanHomeMethodResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
Homeインタフェースに対するEJBメソッドの実行時間（平均値※1）

statelessSessionBeanHomeMethodCallCount
（10）
Counter
RO
－
メソッドの実行回数

statelessSessionBeanHomeMethodStatisticsStartedTime
（11）
INTEGER
RO
秒
統計開始時刻※2

statelessSessionBeanHomeMethodSamplingTime
（12）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(32)　statelessSessionBeanRemoteMethodTable

statelessSessionBeanRemoteMethodTableを次の表に示します。

表A-32　statelessSessionBeanRemoteMethodTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSessionBean
RemoteMethodTable
（32）
statelessSessionBean
RemoteMethodEntry
（1）
statelessSessionBeanRemoteMethodIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Bean Remote Component Interface Methodの使用

statelessSessionBeanRemoteMethodFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>:<Remoteインタフェースクラス名>:<メソッド名>"

statelessSessionBeanRemoteMethodName
（3）
DisplayString
RO
－
メソッド名

statelessSessionBeanRemoteMethodResponseMaxTime
（4）
Gauge
RO
ミリ秒
Remoteインタフェースに対する呼び出しのレスポンス時間（最大値）

statelessSessionBeanRemoteMethodResponseMinTime
（5）
Gauge
RO
ミリ秒
Remoteインタフェースに対する呼び出しのレスポンス時間（最小値）

statelessSessionBeanRemoteMethodResponseAveTime
（6）
Gauge
RO
ミリ秒
Remoteインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statelessSessionBeanRemoteMethodResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（最大値）

statelessSessionBeanRemoteMethodResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（最小値）

statelessSessionBeanRemoteMethodResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（平均値※1）

statelessSessionBeanRemoteMethodCallCount
（10）
Counter
RO
－
メソッドの実行回数

statelessSessionBeanRemoteMethodStatisticsStartedTime
（11）
INTEGER
RO
秒
統計開始時刻※2

statelessSessionBeanRemoteMethodSamplingTime
（12）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(33)　statelessSessionBeanLocalHomeMethodTable

statelessSessionBeanLocalHomeMethodTableを次の表に示します。

表A-33　statelessSessionBeanLocalHomeMethodTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSessionBean
LocalHomeMethodTable
（33）
statelessSessionBean
LocalHomeMethodEntry
（1）
statelessSessionBeanLocalHomeMethodIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Bean Local Home Interface Methodの使用

statelessSessionBeanLocalHomeMethodFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>:<LocalHomeインタフェースクラス名>:<メソッド名>"

statelessSessionBeanLocalHomeMethodName
（3）
DisplayString
RO
－
メソッド名

statelessSessionBeanLocalHomeMethodResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最大値）

statelessSessionBeanLocalHomeMethodResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最小値）

statelessSessionBeanLocalHomeMethodResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statelessSessionBeanLocalHomeMethodResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（最大値）

statelessSessionBeanLocalHomeMethodResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（最小値）

statelessSessionBeanLocalHomeMethodResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（平均値※1）

statelessSessionBeanLocalHomeMethodCallCount
（10）
Counter
RO
－
メソッドの実行回数

statelessSessionBeanLocalHomeMethodStatisticsStartedTime
（11）
INTEGER
RO
秒
統計開始時刻※2

statelessSessionBeanLocalHomeMethodSamplingTime
（12）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(34)　statelessSessionBeanLocalComponentMethodTable

statelessSessionBeanLocalComponentMethodTableを次の表に示します。

表A-34　statelessSessionBeanLocalComponentMethodTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statelessSessionBean
LocalComponentMethodTable
（34）
statelessSessionBean
LocalComponentMethodEntry
（1）
statelessSessionBeanLocalComponentMethodIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateless Session Bean Local Component Interface Methodの使用

statelessSessionBeanLocalComponentMethodFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>:<LocalComponentインタフェースクラス名>:<メソッド名>"

statelessSessionBeanLocalComponentMethodName
（3）
DisplayString
RO
－
メソッド名

statelessSessionBeanLocalComponentMethodResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最大値）

statelessSessionBeanLocalComponentMethodResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最小値）

statelessSessionBeanLocalComponentMethodResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statelessSessionBeanLocalComponentMethodResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最大値）

statelessSessionBeanLocalComponentMethodResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最小値）

statelessSessionBeanLocalComponentMethodResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（平均値※1）

statelessSessionBeanLocalComponentMethodCallCount
（10）
Counter
RO
－
メソッドの実行回数

statelessSessionBeanLocalComponentMethodStatisticsStartedTime
（11）
INTEGER
RO
秒
統計開始時刻※2

statelessSessionBeanLocalComponentMethodSamplingTime
（12）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(35)　statefulSessionBeanHomeMethodTable

statefulSessionBeanHomeMethodTableを次の表に示します。

表A-35　statefulSessionBeanHomeMethodTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSessionBean
HomeMethodTable
（35）
statefulSessionBean
HomeMethodEntry
（1）
statefulSessionBeanHomeMethodIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Bean Remote Home Interface Methodの使用

statefulSessionBeanHomeMethodFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>:<Homeインタフェースクラス名>:<メソッド名>"

statefulSessionBeanHomeMethodName
（3）
DisplayString
RO
－
メソッド名

statefulSessionBeanHomeMethodResponseMaxTime
（4）
Gauge
RO
ミリ秒
Homeインタフェースに対する呼び出しのレスポンス時間（最大値）

statefulSessionBeanHomeMethodResponseMinTime
（5）
Gauge
RO
ミリ秒
Homeインタフェースに対する呼び出しのレスポンス時間（最小値）

statefulSessionBeanHomeMethodResponseAveTime
（6）
Gauge
RO
ミリ秒
Homeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statefulSessionBeanHomeMethodResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
Homeインタフェースに対するEJBメソッドの実行時間（最大値）

statefulSessionBeanHomeMethodResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
Homeインタフェースに対するEJBメソッドの実行時間（最小値）

statefulSessionBeanHomeMethodResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
Homeインタフェースに対するEJBメソッドの実行時間（平均値※1）

statefulSessionBeanHomeMethodCallCount
（10）
Counter
RO
－
メソッドの実行回数

statefulSessionBeanHomeMethodStatisticsStartedTime
（11）
INTEGER
RO
秒
統計開始時刻※2

statefulSessionBeanHomeMethodSamplingTime
（12）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(36)　statefulSessionBeanRemoteMethodTable

statefulSessionBeanRemoteMethodTableを次の表に示します。

表A-36　statefulSessionBeanRemoteMethodTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSessionBean
RemoteMethodTable
（36）
statefulSessionBean
RemoteMethodEntry
（1）
statefulSessionBeanRemoteMethodIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Bean Remote Component Interface Methodの使用

statefulSessionBeanRemoteMethodFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>:<Remoteインタフェースクラス名>:<メソッド名>"

statefulSessionBeanRemoteMethodName
（3）
DisplayString
RO
－
メソッド名

statefulSessionBeanRemoteMethodResponseMaxTime
（4）
Gauge
RO
ミリ秒
Remoteインタフェースに対する呼び出しのレスポンス時間（最大値）

statefulSessionBeanRemoteMethodResponseMinTime
（5）
Gauge
RO
ミリ秒
Remoteインタフェースに対する呼び出しのレスポンス時間（最小値）

statefulSessionBeanRemoteMethodResponseAveTime
（6）
Gauge
RO
ミリ秒
Remoteインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statefulSessionBeanRemoteMethodResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（最大値）

statefulSessionBeanRemoteMethodResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（最小値）

statefulSessionBeanRemoteMethodResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
Remoteインタフェースに対するEJBメソッドの実行時間（平均値※1）

statefulSessionBeanRemoteMethodCallCount
（10）
Counter
RO
－
メソッドの実行回数

statefulSessionBeanRemoteMethodStatisticsStartedTime
（11）
INTEGER
RO
秒
統計開始時刻※2

statefulSessionBeanRemoteMethodSamplingTime
（12）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(37)　statefulSessionBeanLocalHomeMethodTable

statefulSessionBeanLocalHomeMethodTableを次の表に示します。

表A-37　statefulSessionBeanLocalHomeMethodTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSessionBean
LocalHomeMethodTable
（37）
statefulSessionBean
LocalHomeMethodEntry
（1）
statefulSessionBeanLocalHomeMethodIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Bean Local Home Interface Methodの使用

statefulSessionBeanLocalHomeMethodFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>:<LocalHomeインタフェースクラス名>:<メソッド名>"

statefulSessionBeanLocalHomeMethodName
（3）
DisplayString
RO
－
メソッド名

statefulSessionBeanLocalHomeMethodResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最大値）

statefulSessionBeanLocalHomeMethodResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（最小値）

statefulSessionBeanLocalHomeMethodResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statefulSessionBeanLocalHomeMethodResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（最大値）

statefulSessionBeanLocalHomeMethodResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（最小値）

statefulSessionBeanLocalHomeMethodResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocalHomeインタフェースに対するEJBメソッドの実行時間（平均値※1）

statefulSessionBeanLocalHomeMethodCallCount
（10）
Counter
RO
－
メソッドの実行回数

statefulSessionBeanLocalHomeMethodStatisticsStartedTime
（11）
INTEGER
RO
秒
統計開始時刻※2

statefulSessionBeanLocalHomeMethodSamplingTime
（12）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(38)　statefulSessionBeanLocalComponentMethodTable

statefulSessionBeanLocalComponentMethodTableを次の表に示します。

表A-38　statefulSessionBeanLocalComponentMethodTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

statefulSessionBean
LocalComponentMethodTable
（38）
statefulSessionBean
LocalComponentMethodEntry
（1）
statefulSessionBeanLocalComponentMethodIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
Stateful Session Bean Local Component Interface Methodの使用

statefulSessionBeanLocalComponentMethodFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名
"<論理サーバ名>:<J2EEアプリケーション名>:<EJBアプリケーション名>:<Enterprise Bean名>:<LocalComponentインタフェースクラス名>:<メソッド名>"

statefulSessionBeanLocalComponentMethodName
（3）
DisplayString
RO
－
メソッド名

statefulSessionBeanLocalComponentMethodResponseMaxTime
（4）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最大値）

statefulSessionBeanLocalComponentMethodResponseMinTime
（5）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（最小値）

statefulSessionBeanLocalComponentMethodResponseAveTime
（6）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対する呼び出しのレスポンス時間（平均値※1）

statefulSessionBeanLocalComponentMethodResponseEjbMaxTime
（7）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最大値）

statefulSessionBeanLocalComponentMethodResponseEjbMinTime
（8）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（最小値）

statefulSessionBeanLocalComponentMethodResponseEjbAveTime
（9）
Gauge
RO
ミリ秒
LocalComponentインタフェースに対するEJBメソッドの実行時間（平均値※1）

statefulSessionBeanLocalComponentMethodCallCount
（10）
Counter
RO
－
メソッドの実行回数

statefulSessionBeanLocalComponentMethodStatisticsStartedTime
（11）
INTEGER
RO
秒
統計開始時刻※2

statefulSessionBeanLocalComponentMethodSamplingTime
（12）
INTEGER
RW
秒
統計のサンプリング時間※3

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

00:00 Jan. 1, 1970 UTCからの経過秒数

注※3

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(39)　webContainerTable

webContainerTableを次の表に示します。

表A-39　webContainerTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

webContainerTable
（39）
webContainerEntry
（1）
webContainerIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
なし

webContainerFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名"<論理サーバ名>"

webContainerServerName
（3）
DisplayString
RO
－
Webコンテナのサーバ名

webContainerStartedTime
（4）
INTEGER
RO
秒
Webコンテナの起動時刻※1

webContainerStatisticsStartedTime
（5）
INTEGER
RO
秒
統計開始時刻※1

webContainerSamplingTime
（6）
INTEGER
RW
秒
統計のサンプリング時間※2

webContainerActiveThreadCountUpperBound
（7）
INTEGER
RO
－
リクエスト処理中のスレッド数の上限値

Webアプリケーション（WAR）の使用

同時実行スレッド数制御機能の使用

同時実行スレッド数を設定していないWebアプリケーションが存在

webContainerCurrentThreadCountUpperBound
（8）
Gauge
RO
－
リクエスト処理中のスレッド数の現在上限値※3

webContainerActiveThreadCount
（9）
Gauge
RO
－
リクエスト処理中のスレッド数の現在値

webContainerActiveThreadCountHighWaterMark
（10）
Gauge
RO
－
リクエスト処理中のスレッド数の最大値

webContainerActiveThreadCountLowWaterMark
（11）
Gauge
RO
－
リクエスト処理中のスレッド数の最小値

webContainerActiveThreadCountAverage
（12）
Gauge
RO
－
リクエスト処理中のスレッド数の平均値※4

webContainerActiveThreadCountPeak
（13）
Gauge
RO
－
リクエスト処理中のスレッド数のピーク値※5

webContainerWaitingRequestCountUpperBound
（14）
INTEGER
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数の上限値

webContainerWaitingRequestCount
（15）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数の現在値

webContainerWaitingRequestCountHighWaterMark
（16）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数の最大値

webContainerWaitingRequestCountLowWaterMark
（17）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数の最小値

webContainerWaitingRequestCountAverage
（18）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数の平均値※4

webContainerWaitingRequestCountPeak
（19）
Gauge
RO
－
稼働スレッド数の上限値の設定によって，実行を待たされているリクエスト数のピーク値※5

webContainerOverflowRequestCount
（20）
Counter
RO
－
実行待ちリクエストの上限値の設定によって，エラーを返したリクエスト数の累積値

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

00:00 Jan. 1, 1970 UTCからの経過秒数

注※2

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

注※3

現在の同時実行可能なスレッド数の上限

注※4

値の取得要求時刻から過去サンプリング時間の平均値

注※5

値の取得要求時点でのピーク値（記録されてからサンプリング時間の有効期間を持つ最大値）

(40)　inprocHttpSvrTable

inprocHttpSvrTableを次の表に示します。

表A-40　inprocHttpSvrTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

inprocHttpSvrTable
（40）
inprocHttpSvrEntry
（1）
inprocHttpSvrIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
インプロセスHTTPサーバの使用

inprocHttpSvrFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名"<論理サーバ名>"

inprocHttpSvrPortNumber
（3）
INTEGER
RO
－
インプロセスHTTPサーバのポート番号

inprocHttpSvrBackLogUpperBound
（4）
INTEGER
RO
－
通信ソケットのバックログ

inprocHttpSvrThreadCount
（5）
Gauge
RO
－
リクエスト処理用のスレッド数合計の現在値

inprocHttpSvrThreadCountUpperBound
（6）
INTEGER
RO
－
リクエスト処理用のスレッド数合計の上限値

inprocHttpSvrThreadCountLowerBound
（7）
INTEGER
RO
－
リクエスト処理用のスレッド数合計の下限値

inprocHttpSvrThreadCountHighWaterMark
（8）
Gauge
RO
－
リクエスト処理用のスレッド数合計の最大値

inprocHttpSvrThreadCountLowWaterMark
（9）
Gauge
RO
－
リクエスト処理用のスレッド数合計の最小値

inprocHttpSvrThreadCountAverage
（10）
Gauge
RO
－
リクエスト処理用のスレッド数合計の平均値※1

inprocHttpSvrThreadCountPeak
（11）
Gauge
RO
－
リクエスト処理用のスレッド数合計のピーク値※2

inprocHttpSvrActiveThreadCount
（12）
Gauge
RO
－
稼働中スレッド数の現在値

inprocHttpSvrActiveThreadCountUpperBound
（13）
INTEGER
RO
－
稼働中スレッド数の上限値

inprocHttpSvrActiveThreadCountHighWaterMark
（14）
Gauge
RO
－
稼働中スレッド数の最大値

インプロセスHTTPサーバの使用

同時実行スレッド数制御機能の不使用

inprocHttpSvrActiveThreadCountLowWaterMark
（15）
Gauge
RO
－
稼働中スレッド数の最小値

inprocHttpSvrActiveThreadCountAverage
（16）
Gauge
RO
－
稼働中スレッドの平均値※1

inprocHttpSvrActiveThreadCountPeak
（17）
Gauge
RO
－
稼働中スレッドのピーク値※2

inprocHttpSvrPoolingThreadCount
（18）
Gauge
RO
－
プーリングスレッド数の現在値
インプロセスHTTPサーバの使用

inprocHttpSvrPoolingThreadCountUpperBound
（19）
INTEGER
RO
－
プーリングスレッド数の上限値

inprocHttpSvrPoolingThreadCountLowerBound
（20）
INTEGER
RO
－
プーリングスレッド数の下限値

inprocHttpSvrPoolingThreadCountHighWaterMark
（21）
Gauge
RO
－
プーリングスレッド数の最大値

inprocHttpSvrPoolingThreadCountLowWaterMark
（22）
Gauge
RO
－
プーリングスレッド数の最小値

inprocHttpSvrPoolingThreadCountAverage
（23）
Gauge
RO
－
プーリングスレッド数の平均値※1

inprocHttpSvrPoolingThreadCountPeak
（24）
Gauge
RO
－
プーリングスレッド数のピーク値※2

inprocHttpSvrConnectionCount（25）
Gauge
RO
－
コネクション数の現在値

inprocHttpSvrConnectionCountUpperBound
（26）
INTEGER
RO
－
コネクション値の上限値

inprocHttpSvrConnectionCountHighWaterMark
（27）
Gauge
RO
－
コネクション数の最大値

inprocHttpSvrConnectionCountLowWaterMark
（28）
Gauge
RO
－
コネクション数の最小値

inprocHttpSvrConnectionCountAverage
（29）
Gauge
RO
－
コネクション数の平均値※1

inprocHttpSvrConnectionCountPeak
（30）
Gauge
RO
－
コネクション数のピーク値※2

inprocHttpSvrPersistentConnectionCount
（31）
Gauge
RO
－
Persistentコネクション数の現在値

inprocHttpSvrPersistentConnectionCountUpperBound
（32）
INTEGER
RO
－
Persistentコネクション数の上限値

inprocHttpSvrPersistentConnectionCountHighWaterMark
（33）
Gauge
RO
－
Persistentコネクション数の最大値

inprocHttpSvrPersistentConnectionCountLowWaterMark
（34）
Gauge
RO
－
Persistentコネクション数の最小値

inprocHttpSvrPersistentConnectionCountAverage
（35）
Gauge
RO
－
Persistentコネクション数の平均値※1

inprocHttpSvrPersistentConnectionCountPeak
（36）
Gauge
RO
－
Persistentコネクション数のピーク値※2

inprocHttpSvrPersistentConnectionProcessedRequestCountUpperBound
（37）
INTEGER
RO
－
Persistentコネクションが切断されるまでに処理したリクエスト数の上限値

inprocHttpSvrPersistentConnectionProcessedRequestCountMax
（38）
Gauge
RO
－
Persistentコネクションが切断されるまでに処理したリクエスト数の最大値

inprocHttpSvrPersistentConnectionProcessedRequestCountMin
（39）
Gauge
RO
－
Persistentコネクションが切断されるまでに処理したリクエスト数の最小値

inprocHttpSvrPersistentConnectionProcessedRequestCountAve
（40）
Gauge
RO
－
Persistentコネクションが切断されるまでに処理したリクエスト数の平均値※1

inprocHttpSvrPersistentConnectionProcessedRequestCountPeak
（41）
Gauge
RO
－
Persistentコネクションが切断されるまでに処理したリクエスト数のピーク値※2

inprocHttpSvrPersistentConnectionRequestWaitingTimeUpperBound
（42）
INTEGER
RO
ミリ秒
PersistentコネクションでTCPコネクションを持続した状態でのリクエスト待ち時間の上限値

inprocHttpSvrPersistentConnectionRequestWaitingTimeMaxTime
（43）
Gauge
RO
ミリ秒
PersistentコネクションでTCPコネクションを持続した状態でのリクエスト待ち時間の最大値

inprocHttpSvrPersistentConnectionRequestWaitingTimeMinTime
（44）
Gauge
RO
ミリ秒
PersistentコネクションでTCPコネクションを持続した状態でのリクエスト待ち時間の最小値

inprocHttpSvrPersistentConnectionRequestWaitingTimeAveTime
（45）
Gauge
RO
ミリ秒
PersistentコネクションでTCPコネクションを持続した状態でのリクエスト待ち時間の平均値※1

inprocHttpSvrPersistentConnectionRequestWaitingTimePeak
（46）
Gauge
RO
ミリ秒
PersistentコネクションでTCPコネクションを持続した状態でのリクエスト待ち時間のピーク値※2

inprocHttpSvrWaitingRequestCount
（47）
Gauge
RO
－
同時実行スレッド数を超え，実行待ちとなったリクエスト数の現在値

インプロセスHTTPサーバの使用

同時実行スレッド数制御機能の不使用

inprocHttpSvrWaitingRequestCountHighWaterMark
（48）
Gauge
RO
－
同時実行スレッド数を超え，実行待ちとなったリクエスト数の最大値

inprocHttpSvrWaitingRequestCountLowWaterMark
（49）
Gauge
RO
－
同時実行スレッド数を超え，実行待ちとなったリクエスト数の最小値

inprocHttpSvrWaitingRequestCountAverage
（50）
Gauge
RO
－
同時実行スレッド数を超え，実行待ちとなったリクエスト数の平均値※1

inprocHttpSvrWaitingRequestCountPeak
（51）
Gauge
RO
－
同時実行スレッド数を超え，実行待ちとなったリクエスト数のピーク値※2

inprocHttpSvrRejectionRequestCount
（52）
Counter
RO
－
同時接続数制御機能によってアクセスを拒否されたリクエスト数の累積値
インプロセスHTTPサーバの使用

inprocHttpSvrStatisticsStartedTime
（53）
INTEGER
RO
秒
統計開始時刻※3

inprocHttpSvrSamplingTime
（54）
INTEGER
RW
秒
統計のサンプリング時間※4

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

RW：Read-Write

注※1

値の取得要求時刻から過去サンプリング時間の平均値

注※2

値の取得要求時点でのピーク値（記録されてからサンプリング時間の有効期間を持つ最大値）

注※3

00:00 Jan. 1, 1970 UTCからの経過秒数

注※4

サンプリング時間の設定方法

0以下の値が指定された場合は，統計が停止されます。1～9の値を指定した場合は，サンプリング時間がデフォルト（10秒）に設定されて，統計が開始されます。10以上の値を指定した場合は，指定した値をサンプリング時間として，統計が開始されます。

(41)　queueAppTable

queueAppTableを次の表に示します。

表A-41　queueAppTable

テーブル名称
（OID）
エントリ名称
（OID）
メトリック名称
（OID）
TYPE
R/W
単位
説明
前提条件

queueAppTable
（41）
queueAppEntry
（1）
queueAppIndex
（1）
INTEGER
RO
－
シーケンス番号[1, …]
なし

queueAppFullyQualifiedName
（2）
DisplayString
RO
－
インスタンスを一意に識別する完全修飾名"<論理CTMサーバ名>:<キュー名>:<論理J2EEサーバ名>"

queueAppQueueName
（3）
DisplayString
RO
－
キュー名

queueAppJ2EEName
（4）
DisplayString
RO
－
J2EE実サーバ名

queueAppStartParallelCount
（5）
INTEGER
RO
－
J2EEアプリケーション開始時の同時実行数

queueAppResidentThreadCount
（6）
INTEGER
RO
－
J2EEアプリケーションに対する現在の常駐スレッド数

（凡例）

R/W：Read-Only／Read-Write種別

－：該当しない。

RO：Read-Only

付録B　Webアプリケーション用DD（web.xml）

＜この節の構成＞

付録B.1　拡張子とMIMEタイプの対応づけ

付録B.1　拡張子とMIMEタイプの対応づけ

web.xmlにmime-mappingタグで指定する拡張子とMIMEタイプの対応づけのデフォルト値を表B-1に示します。

表B-1　拡張子とMIMEタイプの対応づけ

拡張子 | MIMEタイプ
abs | audio/x-mpeg
ai | application/postscript
aif | audio/x-aiff
aifc | audio/x-aiff
aiff | audio/x-aiff
aim | application/x-aim
art | image/x-jg
asf | video/x-ms-asf
asx | video/x-ms-asf
au | audio/basic
avi | video/x-msvideo
avx | video/x-rad-screenplay
bcpio | application/x-bcpio
bin | application/octet-stream
bmp | image/bmp
body | text/html
cdf | application/x-cdf
cer | application/x-x509-ca-cert
class | application/java
cpio | application/x-cpio
csh | application/x-csh
css | text/css
dib | image/bmp
doc | application/msword
dtd | text/plain
dv | video/x-dv
dvi | application/x-dvi
eps | application/postscript
etx | text/x-setext
exe | application/octet-stream
gif | image/gif
gtar | application/x-gtar
gz | application/x-gzip
hdf | application/x-hdf
hqx | application/mac-binhex40
htc | text/x-component
htm | text/html
html | text/html
ief | image/ief
jad | text/vnd.sun.j2me.app-descriptor
jar | application/octet-stream
java | text/plain
jnlp | application/x-java-jnlp-file
jpe | image/jpeg
jpeg | image/jpeg
jpg | image/jpeg
js | text/javascript
kar | audio/x-midi
latex | application/x-latex
m3u | audio/x-mpegurl
mac | image/x-macpaint
man | application/x-troff-man
me | application/x-troff-me
mid | audio/x-midi
midi | audio/x-midi
mif | application/x-mif
mov | video/quicktime
movie | video/x-sgi-movie
mp1 | audio/x-mpeg
mp2 | audio/x-mpeg
mp3 | audio/x-mpeg
mpa | audio/x-mpeg
mpe | video/mpeg
mpeg | video/mpeg
mpega | audio/x-mpeg
mpg | video/mpeg
mpv2 | video/mpeg2
ms | application/x-wais-source
nc | application/x-netcdf
oda | application/oda
pbm | image/x-portable-bitmap
pct | image/pict
pdf | application/pdf
pgm | image/x-portable-graymap
pic | image/pict
pict | image/pict
pls | audio/x-scpls
png | image/png
pnm | image/x-portable-anymap
pnt | image/x-macpaint
ppm | image/x-portable-pixmap
ps | application/postscript
psd | image/x-photoshop
qt | video/quicktime
qti | image/x-quicktime
qtif | image/x-quicktime
ras | image/x-cmu-raster
rgb | image/x-rgb
rm | application/vnd.rn-realmedia
roff | application/x-troff
rtf | application/rtf
rtx | text/richtext
sh | application/x-sh
shar | application/x-shar
smf | audio/x-midi
snd | audio/basic
src | application/x-wais-source
sv4cpio | application/x-sv4cpio
sv4crc | application/x-sv4crc
swf | application/x-shockwave-flash
t | application/x-troff
tar | application/x-tar
tcl | application/x-tcl
tex | application/x-tex
texi | application/x-texinfo
texinfo | application/x-texinfo
tif | image/tiff
tiff | image/tiff
tr | application/x-troff
tsv | text/tab-separated-values
txt | text/plain
ulw | audio/basic
ustar | application/x-ustar
xbm | image/x-xbitmap
xpm | image/x-xpixmap
xwd | image/x-xwindowdump
wav | audio/x-wav
wbmp | image/vnd.wap.wbmp
wml | text/vnd.wap.wml
wmlc | application/vnd.wap.wmlc
wmls | text/vnd.wap.wmlscript
wmlscriptc | application/vnd.wap.wmlscriptc
wrl | x-world/x-vrml
Z | application/x-compress
z | application/x-compress
zip | application/zip

索引

[記号]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｆ][Ｇ][Ｈ][Ｉ][Ｊ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｑ][Ｒ][Ｓ][Ｔ][Ｕ][Ｖ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ハ行][マ行][ヤ行][ラ行][ワ行]

(記号)

.mngsvrmonitorrc

.mngsvrutilrcのキー

mngsvrutilコマンドのクライアント側共通定義ファイルのキー

-XX:[+|-]HitachiCommaVerboseGC

-XX:[+|-]HitachiFullCore

-XX:[+|-]HitachiJavaClassLibTrace

-XX:[+|-]HitachiJavaLogNoMoreOutput

-XX:[+|-]HitachiLocalsInStackTrace

-XX:[+|-]HitachiLocalsInThrowable

-XX:[+|-]HitachiLocalsSimpleFormat

-XX:[+|-]HitachiOutOfMemoryAbort

-XX:[+|-]HitachiOutOfMemoryAbortThreadDump

-XX:[+|-]HitachiOutOfMemoryCause

-XX:[+|-]HitachiOutOfMemorySize

-XX:[+|-]HitachiOutOfMemoryStackTrace

-XX:[+|-]HitachiOutputMilliTime

-XX:[+|-]HitachiReserveSwapSpace

-XX:[+|-]HitachiThreadDump

-XX:[+|-]HitachiThreadDumpToStdout

-XX:[+|-]HitachiThreadDumpWithBlockCount

-XX:[+|-]HitachiThreadDumpWithCpuTime

-XX:[+|-]HitachiThreadDumpWithHashCode

-XX:[+|-]HitachiTrueTypeInLocals

-XX:[+|-]HitachiVerboseGC

-XX:[+|-]HitachiVerboseGCCpuTime

-XX:[+|-]HitachiVerboseGCPrintCause

-XX:[+|-]HitachiVerboseGCPrintDate

-XX:+Hitachi

-XX:HitachiCallToString

-XX:HitachiJavaClassLibTraceLineSize

-XX:HitachiJavaLog

-XX:HitachiJavaLogFileSize

-XX:HitachiJavaLogNumberOfFile

-XX:HitachiOutOfMemoryStackTraceLineSize

-XX:HitachiVerboseGCIntervalTime

(英字)

(Ａ)

add.class.path

J2EEサーバ用オプション

Javaアプリケーション用のキー

バッチアプリケーション用のキー

バッチサーバ用のキー

add.env

Management Server用環境変数定義ファイルのキー

add.jvm.arg

J2EEサーバ用オプション

Javaアプリケーション用のキー

Webコンテナサーバ用オプション

バッチアプリケーション用のキー

バッチサーバ用のキー

add.library.path

Javaアプリケーション用のキー

Webコンテナサーバ用オプション

バッチサーバ用のキー

adminagent.<サーバ種別>.process.console_event.enabled

運用管理エージェントプロパティファイルのキー

adminagent.<サーバ種別>.process.console_log.enabled

運用管理エージェントプロパティファイルのキー

adminagent.<サーバ種別>.usr_cmd.abnormal_end

運用管理エージェントプロパティファイルのキー

adminagent.<サーバ種別>.watch.interval

運用管理エージェントプロパティファイルのキー

adminagent.<サーバ種別>.watch.level

運用管理エージェントプロパティファイルのキー

adminagent.<サーバ種別>.watch.retry_count

運用管理エージェントプロパティファイルのキー

adminagent.<サーバ種別>.watch.start_time

運用管理エージェントプロパティファイルのキー

adminagent.<サーバ種別>.watch.timeout

運用管理エージェントプロパティファイルのキー

adminagent.adapter.allowedHosts

運用管理エージェントプロパティファイルのキー

adminagent.adapter.bind_host

運用管理エージェントプロパティファイルのキー

adminagent.adapter.port

運用管理エージェントプロパティファイルのキー

adminagent.cluster.localaddress.check

運用管理エージェントプロパティファイルのキー

adminagent.connector.comm.state.cache_max_time

Management Server環境設定ファイルのキー

adminagent.finalization.stop_servers

運用管理エージェントプロパティファイルのキー

adminagent.forcestop.threaddump

運用管理エージェントプロパティファイルのキー

adminagent.forcestop.threaddump.interval

運用管理エージェントプロパティファイルのキー

adminagent.forcestop.threaddump.timeout

運用管理エージェントプロパティファイルのキー

adminagent.hws.group

運用管理エージェントプロパティファイルのキー

adminagent.hws.owner

運用管理エージェントプロパティファイルのキー

adminagent.hws.sys_cmd.abnormal_end.traceinfo

運用管理エージェントプロパティファイルのキー

adminagent.hws.watch.method

運用管理エージェントプロパティファイルのキー

adminagent.hws.watch.url

運用管理エージェントプロパティファイルのキー

adminagent.j2ee.sys_cmd.abnormal_end.javatrace

運用管理エージェントプロパティファイルのキー

adminagent.j2ee.sys_cmd.abnormal_end.threaddump

運用管理エージェントプロパティファイルのキー

adminagent.jp1event.event_server_name

運用管理エージェントプロパティファイルのキー

adminagent.jp1event_enabled

運用管理エージェントプロパティファイルのキー

adminagent.log.filenum

運用管理エージェントプロパティファイルのキー

adminagent.log.filesize

運用管理エージェントプロパティファイルのキー

adminagent.log.level

運用管理エージェントプロパティファイルのキー

adminagent.lsinfo_dir

運用管理エージェントプロパティファイルのキー

adminagent.maintenance.log.filenum

運用管理エージェントプロパティファイルのキー

adminagent.maintenance.log.filesize

運用管理エージェントプロパティファイルのキー

adminagent.process.consolelog.enabled

運用管理エージェントプロパティファイルのキー

adminagent.process.consolelog.event.queue_size

運用管理エージェントプロパティファイルのキー

adminagent.process.consolelog.filenum

運用管理エージェントプロパティファイルのキー

adminagent.process.consolelog.filesize

運用管理エージェントプロパティファイルのキー

adminagent.properties

adminagent.snapshotlog.listfile.2.num_snapshots

運用管理エージェントプロパティファイルのキー

adminagent.snapshotlog.log_dir

運用管理エージェントプロパティファイルのキー

adminagent.snapshotlog.num_snapshots

運用管理エージェントプロパティファイルのキー

adminagent.sys_cmd.abnormal_end.prftrace

運用管理エージェントプロパティファイルのキー

adminagent.watch.retry_timeout.enabled

運用管理エージェントプロパティファイルのキー

adminagent.xml

adminagentuser.cfg

API用パラメタ

Application

JAASのコンフィグレーションファイルのオプション

(Ｂ)

batch.log.directory

バッチアプリケーション用のキー

batch.log.stdout.enabled

バッチアプリケーション用のキー

batch.service.enabled

バッチサーバ用のキー

(Ｃ)

com.cosminexus.admin.auth.api.repository.ldap.config

API用パラメタ

com.cosminexus.admin.auth.custom.lm

DelegationLoginModuleに指定するオプション

com.cosminexus.admin.auth.custom.modules

カスタムログインモジュールのパラメタ

com.cosminexus.admin.auth.gsession.keep_password

Cosminexus標準ログインモジュールのパラメタ

WebPasswordJDBCLoginModuleに指定するオプション

WebPasswordLDAPLoginModuleに指定するオプション

WebPasswordLoginModuleに指定するオプション

com.cosminexus.admin.auth.jdbc.conn.password

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.conn.retry.count

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.conn.retry.wait

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.conn.url

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.conn.user

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.password.encrypt

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.password.encrypt.ex

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.password.type

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.pool.enable

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.pool.gc_interval

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.pool.max

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.pool.max_spare

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.pool.min_spare

JDBC用パラメタ

com.cosminexus.admin.auth.jdbc.r

WebPasswordJDBCLoginModuleに指定するオプション

com.cosminexus.admin.auth.jdbc.sql

JDBC用パラメタ

com.cosminexus.admin.auth.keep_password

Cosminexus標準ログインモジュールのパラメタ

WebPasswordJDBCLoginModuleに指定するオプション

WebPasswordLDAPLoginModuleに指定するオプション

WebPasswordLoginModuleに指定するオプション

com.cosminexus.admin.auth.keep_password.encrypt

Cosminexus標準ログインモジュールのパラメタ

WebPasswordJDBCLoginModuleに指定するオプション

WebPasswordLDAPLoginModuleに指定するオプション

WebPasswordLoginModuleに指定するオプション

com.cosminexus.admin.auth.ldap.attr.password

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.attr.userid

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.basedn

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.certificate.attr.userid

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.conn.read_timeout

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.conn.retry.count

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.conn.retry.wait

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.directory.kind

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.password.encrypt

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.password.encrypt.ex

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.pool.enable

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.pool.gc_interval

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.pool.max

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.pool.max_spare

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.pool.min_spare

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.r

WebCertificateLoginModuleに指定するオプション

WebPasswordLDAPLoginModuleに指定するオプション

WebPasswordLoginModuleに指定するオプション

com.cosminexus.admin.auth.ldap.search.scope

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.search.userrdn

JNDI用パラメタ

com.cosminexus.admin.auth.ldap.w

WebPasswordLDAPLoginModuleに指定するオプション

WebPasswordLoginModuleに指定するオプション

com.cosminexus.admin.auth.param_check.enable

Cosminexus標準ログインモジュールのパラメタ

com.cosminexus.admin.auth.realm

DelegationLoginModuleに指定するオプション

WebCertificateLoginModuleに指定するオプション

WebPasswordJDBCLoginModuleに指定するオプション

WebPasswordLDAPLoginModuleに指定するオプション

WebPasswordLoginModuleに指定するオプション

WebSSOLoginModuleに指定するオプション

com.cosminexus.admin.auth.sfo.disable

セッションフェイルオーバ対応のパラメタ

com.cosminexus.admin.auth.sso

WebSSOLoginModuleに指定するオプション

com.cosminexus.admin.auth.sso.encrypt

シングルサインオン用パラメタ

com.cosminexus.admin.auth.sso.keyfile

シングルサインオン用パラメタ

com.cosminexus.admin.auth.sso.ldap.r

WebSSOLoginModuleに指定するオプション

シングルサインオン用パラメタ

com.cosminexus.admin.auth.sso.ldap.w

WebPasswordLDAPLoginModuleに指定するオプション

WebPasswordLoginModuleに指定するオプション

WebSSOLoginModuleに指定するオプション

シングルサインオン用パラメタ

com.cosminexus.admin.auth.sso.lm

シングルサインオン用パラメタ

com.cosminexus.admin.auth.sso.param.pubdat

シングルサインオン用パラメタ

com.cosminexus.admin.auth.sso.param.secdat

シングルサインオン用パラメタ

com.cosminexus.admin.auth.sso.param.userid

シングルサインオン用パラメタ

com.cosminexus.admin.auth.trace.level

トレースのパラメタ

com.cosminexus.admin.auth.trace.prefix

トレースのパラメタ

com.cosminexus.admin.auth.trace.rotate

トレースのパラメタ

com.cosminexus.admin.auth.trace.size

トレースのパラメタ

com.cosminexus.manager.cmdtracelog.fnum

Manager設定ファイルのキー

com.cosminexus.manager.cmdtracelog.size

Manager設定ファイルのキー

com.cosminexus.manager.log.compatible

Manager設定ファイルのキー

com.cosminexus.manager.log.dir

Manager設定ファイルのキー

com.cosminexus.manager.messagelog.fnum

Manager設定ファイルのキー

com.cosminexus.manager.messagelog.size

Manager設定ファイルのキー

com.cosminexus.manager.tracelog.fnum

Manager設定ファイルのキー

com.cosminexus.manager.tracelog.size

Manager設定ファイルのキー

com.cosminexus.mngsvr.agent.read_timeout

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.compat.monitor_view

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.jp1event.alert

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.jp1event.critical

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.jp1event.emergency

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.jp1event.enabled

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.jp1event.error

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.jp1event.information

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.jp1event.notice

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.jp1event.warning

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.log.display_number

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.log.level

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.log.rotate

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.log.size

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.maintenance.log.filenum

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.maintenance.log.filesize

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.on_start

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.snapshot.auto_collect.enabled

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.snapshot.collect.point

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.sys_cmd.abnormal_end.enabled

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.sys_cmd.abnormal_end.timeout

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.trace

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.usr_cmd.abnormal_end.enabled

Management Server環境設定ファイルのキー

com.cosminexus.mngsvr.usr_cmd.abnormal_end.timeout

Management Server環境設定ファイルのキー

com.sun.jndi.ldap.connect.timeout

JNDI用パラメタ

connect_timeout

Microsoft IIS用リダイレクタ動作定義ファイルのキー

connection_sharing

Microsoft IIS用リダイレクタ動作定義ファイルのキー

Connector属性ファイル

Cosminexus DABroker Library動作環境定義ファイル

Cosminexus Managerで使用するファイル

Cosminexus Managerで使用するファイルの一覧

Cosminexus標準ログインモジュールのパラメタ

cpp.library.version

J2EEサーバ用オプション

Javaアプリケーション用のキー

Webコンテナサーバ用オプション

バッチサーバ用のキー

criticalList.cfg

criticalList.cfg

CSV形式ファイルの記述例

CSV形式ファイルの基本仕様

CTMコマンドオプションファイル

CTMで使用するファイル

CTMユーザ環境変数定義ファイル

(Ｄ)

DAB_HIRDB_DBINF_ESC

DAB_LANG

DABCPP_EVTTRC_LEVEL

DABCPP_EVTTRC_SIZE

DABEXSQL_TRC_LINE

DABHIRDBA_BLOBBUFSIZE

DABLANGMODE

DABORACLE_TYPE

DABORADBA_LONGBUFSIZE

DABSELECTCOLCNT

DABSELECTINFCNT

DABSQL_HiRDB_DICTIONARY_DATATYPE

DABSVLOGSIZE

DABTMP

DABXA_LOG_ERROR

dasysconf

dataSourceFullJTATable

dataSourceTable

DelegationLoginModuleに指定するオプション

DTDファイルの格納先（UNIXの場合）

DTDファイルの格納先（Windowsの場合）

(Ｅ)

ejb.client.directory.shareable

Javaアプリケーション用のキー

ejb.client.ejb.log

Javaアプリケーション用のキー

ejb.client.log.appid

Javaアプリケーション用のキー

ejb.client.log.directory

Javaアプリケーション用のキー

ejb.client.log.stdout.enabled

Javaアプリケーション用のキー

ejb.public.directory

J2EEサーバ用オプション

バッチサーバ用のキー

ejb.server.corefilenum

J2EEサーバ用オプション

バッチサーバ用のキー

ejb.server.log.directory

J2EEサーバ用オプション

バッチサーバ用のキー

ejb.server.log.mode

J2EEサーバ用オプション

バッチサーバ用のキー

ejb.server.log.stderr.filesize

J2EEサーバ用オプション

ejb.server.log.stdout.filesize

J2EEサーバ用オプション

EJB-JAR属性ファイル

ejbApplicationTable

ejbserver.application.InitTermProcessClasses

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.autoFlush.enabled

Javaアプリケーション

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.Logger.<ロガー名称>.filter

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.Logger.<ロガー名称>.handlers

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.Logger.<ロガー名称>.level

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.application.userlog.loggers

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.batch.gc.watch.threshold

バッチサーバ用のキー

ejbserver.client.ctm.RequestPriority

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチアプリケーション用のキー

バッチサーバ用のキー

ejbserver.client.ejb.log

Javaアプリケーション

ejbserver.client.log.appid

Javaアプリケーション

ejbserver.client.log.directory

Javaアプリケーション

ejbserver.client.log.directorynum

Javaアプリケーション

ejbserver.client.log.lockInterval

Javaアプリケーション

ejbserver.client.log.lockRetryCount

Javaアプリケーション

ejbserver.client.transaction.clientName

Javaアプリケーション

ejbserver.client.transaction.enabled

Javaアプリケーション

ejbserver.compiler.jvm.maxHeapSize

J2EEサーバのカスタマイズ用キー

ejbserver.compiler.jvm.minHeapSize

J2EEサーバのカスタマイズ用キー

ejbserver.connectionpool.applicationAuthentication.disabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.connectionpool.association.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.connectionpool.association.enabledDespiteUnshareableSetting

J2EEサーバのカスタマイズ用キー

ejbserver.connectionpool.sharingOutsideTransactionScope.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.connector.logwriter.filenum

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.connector.logwriter.filesize

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.container.audit_trail.enabled

バッチサーバ用のキー

ejbserver.container.bmp.backcompatible

J2EEサーバのカスタマイズ用キー

ejbserver.container.ejbhome.sessionbean.reconnect.enabled

J2EEサーバのカスタマイズキー

ejbserver.container.passivate.scan.interval

J2EEサーバのカスタマイズ用キー

ejbserver.container.rebindpolicy

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチアプリケーション用のキー

ejbserver.container.remove.scan.interval

J2EEサーバのカスタマイズ用キー

ejbserver.container.security.disabled

J2EEサーバのカスタマイズ用キー

ejbserver.ctm.ActivateTimeOut

J2EEサーバのカスタマイズ用キー

ejbserver.ctm.CTMDomain

J2EEサーバのカスタマイズ用キー

ejbserver.ctm.CTMID

J2EEサーバのカスタマイズ用キー

ejbserver.ctm.CTMMyHost

J2EEサーバのカスタマイズ用キー

ejbserver.ctm.DeactivateTimeOut

J2EEサーバのカスタマイズ用キー

ejbserver.ctm.enabled

J2EEサーバのカスタマイズ用キー

ejbserver.ctm.QueueLength

J2EEサーバのカスタマイズ用キー

ejbserver.cui.exitcode.compatible

サーバ管理コマンドのカスタマイズ用キー

ejbserver.cui.logfile.compatible

サーバ管理コマンドのカスタマイズ用キー

ejbserver.cui.optionalname.enabled

サーバ管理コマンドのカスタマイズ用キー

ejbserver.deploy.app.stopforcibly.disabled

J2EEサーバのカスタマイズ用キー

ejbserver.deploy.applications.metadata_complete

J2EEサーバのカスタマイズ用キー

ejbserver.deploy.context.check_interval

J2EEサーバのカスタマイズ用キー

ejbserver.deploy.context.reload_scope

J2EEサーバのカスタマイズ用キー

ejbserver.deploy.context.update.interval

J2EEサーバのカスタマイズ用キー

ejbserver.deploy.exclusive.lockAliveInterval

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.deploy.resourcefile.scramble.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.deploy.session.work.directory

J2EEサーバのカスタマイズ用キー

ejbserver.deploy.stub.generation.scope

J2EEサーバのカスタマイズ用キー

ejbserver.distributedtx.enableXidReuseOptimization

J2EEサーバのカスタマイズ用キー

ejbserver.distributedtx.ots.status.directory1

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

ejbserver.distributedtx.ots.status.directory2

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout

J2EEサーバのカスタマイズ用キー

ejbserver.distributedtx.recovery.port

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

ejbserver.distributedtx.rollbackClientTxOnSystemException

J2EEサーバのカスタマイズ用キー

ejbserver.distributedtx.XATransaction.enabled

J2EEサーバのカスタマイズ用キー

ejbserver.DynamicStubLoading.Enabled

J2EEサーバのカスタマイズ用キー

ejbserver.ejb.cmp20.cmr.use.existing_table

J2EEサーバのカスタマイズ用キー

ejbserver.ejb.timerservice.maxCallbackThreads

J2EEサーバのカスタマイズ用キー

ejbserver.ejb.timerservice.retryCount

J2EEサーバのカスタマイズ用キー

ejbserver.ejb.timerservice.retryInterval

J2EEサーバのカスタマイズ用キー

ejbserver.ext.method_observation.interval

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.http.port

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.instrumentation.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.jdbc.propertyInfo.BUF_SIZE

J2EEサーバのカスタマイズ用キー

ejbserver.jdbc.propertyInfo.ENCODELANG

J2EEサーバのカスタマイズ用キー

ejbserver.jndi.cache

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.jndi.cache.interval

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.jndi.cache.interval.clear.option

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.jndi.cache.reference

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.jndi.log.message.verbosemode

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.jndi.namingservice.group.list

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.jndi.request.timeout

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチアプリケーション用のキー

バッチサーバ用のキー

ejbserver.jta.pooldeffile.scramble.enabled

Webコンテナサーバのカスタマイズ用キー

ejbserver.jta.TransactionManager.defaultTimeOut

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

バッチサーバ用のキー

ejbserver.jta.TransactionManager.enlist.compatibleMode.enabled

J2EEサーバのカスタマイズ用キー

ejbserver.logger.channels.define.<チャネル名>.filenum

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.logger.channels.define.<チャネル名>.filesize

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.logger.enabled.*

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

サーバ管理コマンドのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.logger.systemlog.enabled

J2EEサーバのカスタマイズ用キー

ejbserver.management.JVM.stats_monitor.FullGCCount.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.management.JVM.stats_monitor.FullGCCount.interval

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.management.JVM.stats_monitor.FullGCCount.threshold

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.management.statistics.interval

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.management.stats_file.base_time

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.management.stats_file.dir

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.management.stats_file.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.management.stats_file.num

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.management.stats_file.period

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.manager.agent.Agent.conf

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.manager.agent.Agent.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.manager.agent.JP1EventAgent.conf

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.manager.agent.JP1EventAgent.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.manager.agent.MEventAgent.conf

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.manager.agent.MEventAgent.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.manager.jp1event.event_server_name

J2EEサーバのカスタマイズ用キー

ejbserver.naming.exec.args

J2EEサーバのカスタマイズ用キー

ejbserver.naming.host

J2EEサーバのカスタマイズ用キー

サーバ管理コマンドのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.naming.nameroot

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.naming.port

J2EEサーバのカスタマイズ用キー

サーバ管理コマンドのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.naming.protocol

J2EEサーバのカスタマイズ用キー

サーバ管理コマンドのカスタマイズ用キー

ejbserver.naming.startupMode

J2EEサーバのカスタマイズ用キー

ejbserver.naming.startupRetryCount

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.naming.startupWaitTime

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.rmi.localinvocation.scope

J2EEサーバのカスタマイズ用キー

ejbserver.rmi.naming.host

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.rmi.naming.port

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.rmi.passbyreference

J2EEサーバのカスタマイズ用キー

ejbserver.rmi.remote.listener.port

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.rmi.request.timeout

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

サーバ管理コマンドのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.rmi.stateless.unique_id.enabled

J2EEサーバのカスタマイズ用キー

ejbserver.security.service.url

Javaアプリケーション

ejbserver.server.j2ee.feature

J2EEサーバのカスタマイズ用キー

ejbserver.server.mutex.invocation.timeout

J2EEサーバのカスタマイズ用キー

ejbserver.server.prf.PRFID

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.server.prf.processName

ejbserver.server.threaddump.filenum

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.serverName

Javaアプリケーション

ejbserver.stateful.passivate.switch

J2EEサーバのカスタマイズ用キー

ejbserver.watch.defaultRequestQueue.enabled

J2EEサーバのカスタマイズ用キー

ejbserver.watch.defaultRequestQueue.interval

J2EEサーバのカスタマイズ用キー

ejbserver.watch.defaultRequestQueue.threshold

J2EEサーバのカスタマイズ用キー

ejbserver.watch.defaultRequestQueue.writefile.enabled

J2EEサーバのカスタマイズ用キー

ejbserver.watch.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.fileDescriptor.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.fileDescriptor.interval

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.fileDescriptor.threshold

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.fileDescriptor.writefile.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.memory.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.memory.interval

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.memory.threshold

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.memory.writefile.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.thread.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.thread.interval

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.thread.threshold

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.thread.writefile.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.threaddump.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.threaddump.interval

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.threaddump.threshold

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.watch.threaddump.writefile.enabled

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

ejbserver.webj2ee.connectionAutoClose.enabled

J2EEサーバのカスタマイズ用キー

entityBeanHomeTable

entityBeanLocalComponentTable

entityBeanLocalHomeTable

entityBeanRemoteTable

entityBeanTable

Entity Bean属性ファイル

(Ｆ)

filter_priority

Microsoft IIS用リダイレクタ動作定義ファイルのキー

Flag

JAASのコンフィグレーションファイルのオプション

(Ｇ)

gateway_host

Microsoft IIS用リダイレクタ動作定義ファイルのキー

gateway_https_scheme

Microsoft IIS用リダイレクタ動作定義ファイルのキー

gateway_port

Microsoft IIS用リダイレクタ動作定義ファイルのキー

(Ｈ)

HiRDB環境変数区切り文字

HiRDBのBLOB型データ受取バッファサイズ

HiRDBのディクショナリ表のデータ属性

hitachi_web.properties

hitachi_web.properties

Hitachi Web Server用リダイレクタ動作定義ファイル

httpServerConnectorTable

httpServerTable

(Ｉ)

isapi_redirect.conf

(Ｊ)

j2eeApplicationTable

j2eeContainerTable

J2EEサーバ共通用メッセージマッピングファイル

J2EEサーバ個別用メッセージマッピングファイル

J2EEサーバで使用するファイル

J2EEサーバのカスタマイズ用キー

J2EEサーバ用Webアプリケーションプロパティファイル

J2EEサーバ用オプション

webserver.jsp.keepgenerated

webserver.xml.validate

J2EEサーバ用オプション定義ファイル

J2EEサーバ用セキュリティポリシーファイル

J2EEサーバ用ユーザプロパティファイル

jaas.conf

JAASのコンフィグレーションファイル

java.endorsed.dirs

java.naming.factory.initial

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

java.naming.factory.object

java.naming.factory.state

java.naming.provider.url

Javaアプリケーション

JNDI用パラメタ

Webコンテナサーバのカスタマイズ用キー

バッチアプリケーション用のキー

java.naming.security.credentials

JNDI用パラメタ

java.naming.security.principal

JNDI用パラメタ

java.security.policy

JavaBeansリソース属性ファイル

javax.rmi.CORBA.PortableRemoteObjectClass

javax.rmi.CORBA.StubClass

javax.rmi.CORBA.UtilClass

javax.xml.datatype.DatatypeFactory

Javaアプリケーション

javax.xml.parsers.DocumentBuilderFactory

Javaアプリケーション

javax.xml.parsers.SAXParserFactory

Javaアプリケーション

javax.xml.transform.TransformerFactory

Javaアプリケーション

javax.xml.validation.SchemaFactory¥:http¥://www.w3.org/2001/XMLSchema

Javaアプリケーション

javax.xml.xpath.XPathFactory¥:http¥://java.sun.com/jaxp/xpath/dom

Javaアプリケーション

Javaアプリケーションで使用するファイル

Javaアプリケーション用オプション定義ファイル

Javaアプリケーション用ユーザプロパティファイル

JkConnectTimeout

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkGatewayHost

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkGatewayHttpsScheme

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkGatewayPort

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkLogFileDir

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkLogFileNum

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkLogFilePrefix

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkLogFileSize

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkLogLevel

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkModulePriority

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkOptions

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkPrfId

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkRequestRetryCount

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkSendTimeout

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkTraceLog

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkTraceLogFileDir

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkTraceLogFileNum

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkTraceLogFilePrefix

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkTraceLogFileSize

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkTranslateBackcompat

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JkWorkersFile

Hitachi Web Server用リダイレクタ動作定義ファイルのキー

JNDI用パラメタ

JP1/IM連携用システムログメッセージマッピングファイル

JP1/IM連携用モニタ起動コマンドの設定ファイル

JP1イベントへの変換

jvm.type

J2EEサーバ用オプション

Javaアプリケーション用のキー

Webコンテナサーバ用オプション

jvmTable

(Ｌ)

LANG環境変数

LINK_xxxx

log_file_dir

Microsoft IIS用リダイレクタ動作定義ファイルのキー

log_file_num

Microsoft IIS用リダイレクタ動作定義ファイルのキー

log_file_prefix

Microsoft IIS用リダイレクタ動作定義ファイルのキー

log_file_size

Microsoft IIS用リダイレクタ動作定義ファイルのキー

log_level

Microsoft IIS用リダイレクタ動作定義ファイルのキー

(Ｍ)

maction.<ManagementアクションID>.command

Managementアクション実行用プロパティファイルのキー

maction.<ManagementアクションID>.exclusive_time

Managementアクション実行用プロパティファイルのキー

maction.<ManagementアクションID>.max_executable_actions

Managementアクション実行用プロパティファイルのキー

maction.<ManagementアクションID>.timeout

Managementアクション実行用プロパティファイルのキー

maction.<ManagementアクションID>.timeout.forced_stop

Managementアクション実行用プロパティファイルのキー

maction.message.<メッセージID>.mactions

Managementアクション実行用プロパティファイルのキー

maction.mevent.receiving_info.keep_size.max

Managementアクション実行用プロパティファイルのキー

maction.properties

maction.server.<論理サーバ名>.mactions

Managementアクション実行用プロパティファイルのキー

maction.tier.<Webシステム名>.<物理ティア種別名>.mactions

Managementアクション実行用プロパティファイルのキー

maction.unit.<Webシステム名>.<サービスユニット名>.mactions

Managementアクション実行用プロパティファイルのキー

Management Server環境設定ファイル

Management Server管理ファイル用退避対象定義ファイル

Management Server用オプション定義ファイル

Management Server用環境変数定義ファイル

Management Server用メッセージマッピングファイル

Managementアクション実行用プロパティファイル

Managementイベント発行用プロパティファイル

Managementイベント発行用メッセージIDリストファイル

manager.<論理サーバ名>.jp1event.system.mapping.properties

manager.cfg

manager.jp1event.system.mapping.properties

manager.mevent.logical_server_name

Managementアクション実行用プロパティファイルのキー

manager.mevent.message_id.list

Managementアクション実行用プロパティファイルのキー

manager.mevent.retry.interval

Managementアクション実行用プロパティファイルのキー

manager.mevent.retry.limit

Managementアクション実行用プロパティファイルのキー

manager.mevent.send.host

Managementアクション実行用プロパティファイルのキー

manager.mevent.send.max

Managementアクション実行用プロパティファイルのキー

manager.mevent.send.port

Managementアクション実行用プロパティファイルのキー

manager.mevent.send.timeout

Managementアクション実行用プロパティファイルのキー

manager.mevent.sender.bind.host

Managementアクション実行用プロパティファイルのキー

Manager設定ファイル

messageDrivenBeanTable

MessageDrivenBean属性ファイル

Microsoft IIS用マッピング定義ファイル

Microsoft IIS用リダイレクタ動作定義ファイル

mngagent.<実サーバ名>.properties

mngagent.agent_name

運用監視エージェントプロパティファイルのキー

mngagent.connector.host

運用監視エージェントプロパティファイルのキー

mngagent.connector.port

運用監視エージェントプロパティファイルのキー

mngagent.domain_name

運用監視エージェントプロパティファイルのキー

mngagent.log.filename

運用監視エージェントプロパティファイルのキー

mngagent.log.filesize

運用監視エージェントプロパティファイルのキー

mngsvr.jp1event.event_server_name

Management Server環境設定ファイルのキー

mngsvr.myhost.name

Management Server環境設定ファイルのキー

mngsvrmonitor.browser

JP1/IM連携用モニタ起動コマンドの設定ファイルのキー

mngsvrmonitor.connect.host

JP1/IM連携用モニタ起動コマンドの設定ファイルのキー

mngsvrmonitor.connect.password

JP1/IM連携用モニタ起動コマンドの設定ファイルのキー

mngsvrmonitor.connect.userid

JP1/IM連携用モニタ起動コマンドの設定ファイルのキー

mngsvrutil.apply_user

mngsvrutilコマンドのクライアント側共通定義ファイルのキー

mngsvrutil.auth.failed_wait

mngsvrutilコマンドのサーバ側定義ファイルのキー

mngsvrutil.auth.log_challenged

mngsvrutilコマンドのサーバ側定義ファイルのキー

mngsvrutil.auth.log_denied

mngsvrutilコマンドのサーバ側定義ファイルのキー

mngsvrutil.auth.log_failed

mngsvrutilコマンドのサーバ側定義ファイルのキー

mngsvrutil.auth.log_succeeded

mngsvrutilコマンドのサーバ側定義ファイルのキー

mngsvrutil.connect.host

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutil.connect.password

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutil.connect.userid

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutil.output.file

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutil.output.format

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutil.output.suppress_header

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutil.session.max_inactive_interval

mngsvrutilコマンドのサーバ側定義ファイルのキー

mngsvrutil.target_kind

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutil.target_name

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutil.target_server_name

mngsvrutilコマンドのクライアント側定義ファイルのキー

mngsvrutilcl.properties

mngsvrutilコマンドのクライアント側共通定義ファイル

mngsvrutilコマンドのクライアント側定義ファイル

mngsvrutilコマンドのサーバ側定義ファイル

mod_jk.conf

ModuleOptions

JAASのコンフィグレーションファイルのオプション

mserver.cfg

mserver.jp1event.system.mapping.properties

mserver.properties

mserverenv.cfg

(Ｎ)

NLS_LANG

(Ｏ)

OPERATION

ORACLE_HOME

ORACLE_SID

ORACLEのLONG型データ受取バッファサイズ

org.omg.CORBA.ORBClass

org.omg.CORBA.ORBSingletonClass

org.omg.PortableInterceptor.ORBInitializerClass.com.hitachi.software.ejb.security.std.interceptor.SecurityClientInterceptorInit

org.w3c.dom.DOMImplementationSourceList

Javaアプリケーション

org.xml.sax.driver

Javaアプリケーション

org.xml.sax.parser

Javaアプリケーション

(Ｐ)

PDCLTPATH

PDHOST

PDNAMEPORT

PDSQLTRACE

PDSWAITTIME

PDUAPERLOG

prf_id

PUBLICDATA

(Ｑ)

queueTable

(Ｒ)

REALMNAME

receive_client_timeout

Microsoft IIS用リダイレクタ動作定義ファイルのキー

request_retry_count

Microsoft IIS用リダイレクタ動作定義ファイルのキー

requestUrlTable

resourceAdapterTable

(Ｓ)

SECRETDATA

SecurityManager定義ファイル

send_timeout

Microsoft IIS用リダイレクタ動作定義ファイルのキー

server.policy

server.policy

servletTable

Session Bean属性ファイル

snapshotログ収集対象定義ファイル

snapshotログ収集対象定義ファイルで使用できる変数

statefulSessionBeanHomeMethodTable

statefulSessionBeanHomeTable

statefulSessionBeanLocalComponentMethodTable

statefulSessionBeanLocalComponentTable

statefulSessionBeanLocalHomeMethodTable

statefulSessionBeanLocalHomeTable

statefulSessionBeanRemoteMethodTable

statefulSessionBeanRemoteTable

statefulSessionBeanTable

statelessSessionBeanHomeMethodTable

statelessSessionBeanHomeTable

statelessSessionBeanLocalComponentMethodTable

statelessSessionBeanLocalComponentTable

statelessSessionBeanLocalHomeMethodTable

statelessSessionBeanLocalHomeTable

statelessSessionBeanRemoteMethodTable

statelessSessionBeanRemoteTable

statelessSessionBeanTable

(Ｔ)

trace_log

Microsoft IIS用リダイレクタ動作定義ファイルのキー

trace_log_file_dir

Microsoft IIS用リダイレクタ動作定義ファイルのキー

trace_log_file_num

Microsoft IIS用リダイレクタ動作定義ファイルのキー

trace_log_file_prefix

Microsoft IIS用リダイレクタ動作定義ファイルのキー

trace_log_file_size

Microsoft IIS用リダイレクタ動作定義ファイルのキー

transactionTable

(Ｕ)

ua.conf

uriworkermap.properties

USERID

usrconf

usrconf.bat

usrconf.cfg

usrconf.cfg

usrconf.cfg

usrconf.cfg

usrconf.cfg

usrconf.properties

usrconf.properties

usrconf.properties

usrconf.properties

usrconf.properties

usrconf.properties

USRCONF_JVM_ARGS

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

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

USRCONF_JVM_CLASSPATH

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

USRCONF_JVM_CLPATH

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

USRCONF_JVM_LIBPATH

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

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

(Ｖ)

vbj.java2iiop.jvm.maxHeapSize

J2EEサーバのカスタマイズ用キー

vbj.java2iiop.jvm.minHeapSize

J2EEサーバのカスタマイズ用キー

vbroker.agent.enableLocator

J2EEサーバのカスタマイズ用キー

バッチサーバ用のキー

vbroker.agent.port

J2EEサーバのカスタマイズ用キー

サーバ管理コマンドのカスタマイズ用キー

バッチサーバ用のキー

vbroker.orb.htc.comt.entryCount

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

vbroker.orb.htc.comt.fileCount

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

vbroker.orb.htc.tracePath

J2EEサーバのカスタマイズ用キー

Javaアプリケーション

Webコンテナサーバのカスタマイズ用キー

サーバ管理コマンドのカスタマイズ用キー

バッチサーバ用のキー

vbroker.se.iiop_tp.host

J2EEサーバのカスタマイズ用キー

運用監視エージェントプロパティファイルのキー

バッチサーバ用のキー

vbroker.se.iiop_tp.scm.iiop_tp.listener.port

J2EEサーバのカスタマイズ用キー

運用監視エージェントプロパティファイルのキー

バッチサーバ用のキー

(Ｗ)

WAR属性ファイル

web.add.class.path

Webコンテナサーバ用オプション

web.policy

web.server.corefilenum

Webコンテナサーバ用オプション

web.server.log.directory

Webコンテナサーバ用オプション

web.server.log.stderr.filesize

Webコンテナサーバ用オプション

web.server.log.stdout.filesize

Webコンテナサーバ用オプション

web-users.xml

webApplicationTable

WebCertificateLoginModuleに指定するオプション

webContainerTable

WebPasswordJDBCLoginModuleに指定するオプション

WebPasswordLDAPLoginModuleに指定するオプション

webserver.connector.ajp12.backlog

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.connector.ajp12.max_threads

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.connector.ajp12.port

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.connector.ajp13.backlog

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.connector.ajp13.bind_host

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

webserver.connector.ajp13.max_threads

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.connector.ajp13.port

J2EEサーバのカスタマイズ用キー

Management Server環境設定ファイルのキー

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

webserver.connector.ajp13.receive_timeout

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.connector.ajp13.send_timeout

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.connector.http.bind_host

J2EEサーバのカスタマイズ用キー

Management Server環境設定ファイルのキー

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

webserver.connector.http.enabled

Webコンテナサーバのカスタマイズ用キー

webserver.connector.http.permitted.hosts

J2EEサーバのカスタマイズ用キー

Management Server環境設定ファイルのキー

Webコンテナサーバのカスタマイズ用キー

バッチサーバ用のキー

webserver.connector.http.port

Management Server環境設定ファイルのキー

Webコンテナサーバのカスタマイズ用キー

webserver.connector.inprocess_http.backlog

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.bind_host

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.enabled

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.enabled_methods

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.file

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.file.content_type

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.redirect_url

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.request_url

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.status

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.error_custom.list

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.gateway.host

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.gateway.https_scheme

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.gateway.port

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.hostname_lookups

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.init_threads

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.keep_start_threads

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.limit.max_headers

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.limit.max_request_body

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.limit.max_request_header

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.limit.max_request_line

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.max_connections

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.max_execute_threads

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.max_spare_threads

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.min_spare_threads

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.permitted.hosts

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.persistent_connection.max_connections

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.persistent_connection.max_requests

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.persistent_connection.timeout

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.port

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.receive_timeout

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.file

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.file.content_type

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.redirect_url

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.request_url

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.status

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.redirect.list

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.rejection_threads

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.response.header.server

J2EEサーバのカスタマイズ用キー

webserver.connector.inprocess_http.send_timeout

J2EEサーバのカスタマイズ用キー

webserver.connector.redirect_https.port

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.container.ac.logEnabled

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.container.server_id.enabled

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.container.server_id.name

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.container.server_id.value

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.container.thread_control.enabled

J2EEサーバのカスタマイズ用キー

webserver.container.thread_control.queue_size

J2EEサーバのカスタマイズ用キー

webserver.context.check_interval

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.context.reload_delay_timeout

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバ用

webserver.context.reloadable

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバ用

webserver.context.update.interval

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバ用

webserver.errorpage.stack_trace.enabled

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.http.request.encoding

J2EEサーバのカスタマイズ用キー

webserver.http.response.encoding

J2EEサーバのカスタマイズ用キー

webserver.jsp.check_interval

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.jsp.compile.backcompat

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.jsp.keepgenerated

J2EEサーバのカスタマイズ用キー

J2EEサーバ用オプション

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバ用

webserver.jsp.pageEncoding

J2EEサーバのカスタマイズ用キー

webserver.jsp.precompile.jsp_work_dir

J2EEサーバのカスタマイズ用キー

webserver.jsp.recompilable

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバ用

webserver.jsp.translation.backcompat.customAction.declareVariable

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.jsp.translation.backcompat.taglib.noCheckPrefix

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.jsp.translation.backcompat.useBean.noCheckClass

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.jsp.update.interval

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバ用

webserver.logger.access_log.<フォーマット名>

J2EEサーバのカスタマイズ用キー

webserver.logger.access_log.format_list

J2EEサーバのカスタマイズ用キー

webserver.logger.access_log.inprocess_http.enabled

J2EEサーバのカスタマイズ用キー

webserver.logger.access_log.inprocess_http.filename

J2EEサーバのカスタマイズ用キー

webserver.logger.access_log.inprocess_http.filenum

J2EEサーバのカスタマイズ用キー

webserver.logger.access_log.inprocess_http.filesize

J2EEサーバのカスタマイズ用キー

webserver.logger.access_log.inprocess_http.usage_format

J2EEサーバのカスタマイズ用キー

webserver.logger.communication_trace.inprocess_http.filenum

J2EEサーバのカスタマイズ用キー

webserver.logger.thread_trace.inprocess_http.filenum

J2EEサーバのカスタマイズ用キー

webserver.session.max.log_interval

J2EEサーバのカスタマイズ用キー

webserver.session.persistence.enabled

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバ用

webserver.session.server_id.enabled

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.session.server_id.value

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.session.work.directory

Webコンテナサーバのカスタマイズ用キー

webserver.sfo.check_size.mode

J2EEサーバのカスタマイズ用キー

webserver.sfo.negotiation.ignore_serverId

J2EEサーバのカスタマイズ用キー

webserver.sfo.sfo_server.<SFOサーバ名>.connectionTimeout

J2EEサーバのカスタマイズ用キー

webserver.sfo.sfo_server.<SFOサーバ名>.naming

J2EEサーバのカスタマイズ用キー

webserver.sfo.sfo_servers

J2EEサーバのカスタマイズ用キー

webserver.shutdown.port

Management Server環境設定ファイルのキー

Webコンテナサーバのカスタマイズ用キー

webserver.static_content.cache.enabled

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.static_content.cache.filesize.threshold

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.static_content.cache.size

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.static_content.encoding.extension

J2EEサーバのカスタマイズ用キー

webserver.work.clean

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.work.directory

J2EEサーバのカスタマイズ用キー

Webコンテナサーバのカスタマイズ用キー

webserver.xml.validate

J2EEサーバのカスタマイズ用キー

J2EEサーバ用オプション

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバ用

WebSSOLoginModuleに指定するオプション

Webアプリケーションで使用するファイルの一覧

Webアプリケーション用DD（web.xml）

Webコンテナサーバで使用するファイル

Webコンテナサーバで使用するファイルの一覧

Webコンテナサーバのカスタマイズ用キー

Webコンテナサーバの予約済みキー

Webコンテナサーバ用Webアプリケーションプロパティファイル

Webコンテナサーバ用オプション定義ファイル

Webコンテナサーバ用ユーザプロパティファイル

Webサーバ連携で使用するファイル

Webサーバ連携で使用するファイルの一覧

worker.<ワーカ名>.<パラメタ>

ワーカ定義ファイルのキー

worker.<ワーカ名>.balanced_workers

ワーカごとの定義パラメタ

worker.<ワーカ名>.cachesize

ワーカごとの定義パラメタ

worker.<ワーカ名>.default_worker

ワーカごとの定義パラメタ

worker.<ワーカ名>.delegate_error_code

ワーカごとの定義パラメタ

worker.<ワーカ名>.host

ワーカごとの定義パラメタ

worker.<ワーカ名>.lbfactor

ワーカごとの定義パラメタ

worker.<ワーカ名>.port

ワーカごとの定義パラメタ

worker.<ワーカ名>.post_data

ワーカごとの定義パラメタ

worker.<ワーカ名>.post_size_workers

ワーカごとの定義パラメタ

worker.<ワーカ名>.receive_timeout

ワーカごとの定義パラメタ

worker.<ワーカ名>.type

ワーカごとの定義パラメタ

worker.<ワーカ名>.typeごとの定義パラメタ

worker.list

ワーカ定義ファイルのキー

worker_file

Microsoft IIS用リダイレクタ動作定義ファイルのキー

worker_mount_file

Microsoft IIS用リダイレクタ動作定義ファイルのキー

workers.properties

(Ｘ)

XAトレースを取得する

(ア行)

(あ)

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

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

(う)

運用監視エージェントプロパティファイル

運用管理エージェント設定ファイル

運用管理エージェントプロパティファイル

運用管理エージェント用オプション定義ファイル

(カ行)

(か)

拡張MIBオブジェクト定義ファイル

拡張子とMIMEタイプの対応づけ

拡張データベースアクセストレース設定項目

DABSQL_TRC_ATTACH（ATTACH）

DABSQL_TRC_ATTRGET（ATTRGET）

DABSQL_TRC_ATTRSET（ATTRSET）

DABSQL_TRC_AUTO_COMMIT_OFF（AUTO COMMIT OFF）

DABSQL_TRC_AUTO_COMMIT_ON（AUTO COMMIT ON）

DABSQL_TRC_BIND（BIND）

DABSQL_TRC_CANCEL（CANCEL）

DABSQL_TRC_CHARFORM（CHARFORM）

DABSQL_TRC_CHARID（CHARID）

DABSQL_TRC_CLOSE（CLOSE）

DABSQL_TRC_COMMIT（COMMIT）

DABSQL_TRC_CONNECT（CONNECT）

DABSQL_TRC_DECLARE（DECLARE）

DABSQL_TRC_DEFINE（DEFINE）

DABSQL_TRC_DESALLOC（DESALLOC）

DABSQL_TRC_DESCANY（DESCANY）

DABSQL_TRC_DESCRIBE（DESCRIBE）

DABSQL_TRC_DESFREE（DESFREE）

DABSQL_TRC_DETACH（DETACH）

DABSQL_TRC_DISCONNECT（DISCONNECT）

DABSQL_TRC_ENVCREATE（ENVCREATE）

DABSQL_TRC_ERRGET（ERRGET）

DABSQL_TRC_EXECUTE_DIRECT（EXECUTE DIRECT）

DABSQL_TRC_EXECUTE（EXECUTE）

DABSQL_TRC_FETCH（FETCH）

DABSQL_TRC_GET_INFO（GET INFO）

DABSQL_TRC_GETDIAG（GETDIAG）

DABSQL_TRC_GETPIECE（GETPIECE）

DABSQL_TRC_HDLALLOC（HDLALLOC）

DABSQL_TRC_HDLFREE（HDLFREE）

DABSQL_TRC_LOBCLOSE（LOBCLOSE）

DABSQL_TRC_LOBLEN（LOBLEN）

DABSQL_TRC_LOBOPEN（LOBOPEN）

DABSQL_TRC_LOBREAD（LOBREAD）

DABSQL_TRC_LOBWRITE（LOBWRITE）

DABSQL_TRC_LOGGING（LOGGING）

DABSQL_TRC_LOGLESS（LOGLESS）

DABSQL_TRC_OPEN（OPEN）

DABSQL_TRC_PARAMGET（PARAMGET）

DABSQL_TRC_PREPARE（PREPARE）

DABSQL_TRC_ROLLBACK（ROLLBACK）

DABSQL_TRC_SESBEGIN（SESBEGIN）

DABSQL_TRC_SESEND（SESEND）

DABSQL_TRC_SET_INFO（SET INFO）

DABSQL_TRC_SETPIECE（SETPIECE）

拡張データベースアクセストレースを取得する

カスタムログインモジュールのパラメタ

監査ログ定義ファイル

監査ログの設定で使用するファイル

漢字コードセット

(く)

グローバルトランザクション

(こ)

更新・検索条件カラム数

コンパイル対象外リストファイル

(サ行)

(さ)

サーバ管理コマンドで使用するファイル

サーバ管理コマンドのカスタマイズ用キー

サーバ管理コマンドの予約済みキー

サーバ管理コマンドの予約済みキー

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

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

作業ディレクトリ

作業ディレクトリ

(し)

実行結果リストファイル

使用するORACLEのバージョン

シングルサインオン用認証情報のCSV形式ファイル

シングルサインオン用パラメタ

(タ行)

(て)

データソース設定ファイル

データソース属性ファイル

(と)

統合ユーザ管理で使用するファイル

統合ユーザ管理で使用するファイルの一覧

統合ユーザ管理のコンフィグレーションファイル

トレース取得サイズ

トレース取得レベル

トレースファイルサイズ

(ハ行)

(は)

バッチアプリケーション用オプション定義ファイル

バッチアプリケーション用ユーザプロパティファイル

バッチサーバで使用するファイル

バッチサーバのカスタマイズ用キー

バッチサーバ用オプション定義ファイル

バッチサーバ用セキュリティポリシーファイル

バッチサーバ用ユーザプロパティファイル

(ひ)

表検索カラム数

(ふ)

フィルタ属性ファイル

プール管理情報設定ファイル

(ほ)

保護区リストファイル

保護区リストファイル

(マ行)

(ま)

マッピング定義

(め)

メール属性ファイル

(も)

モジュール定義

(ヤ行)

(ゆ)

ユーザ情報を取得するための定義ファイル

ユーザ情報を追加および変更するための定義ファイル

ユーザ認証情報定義ファイル

ユーザマッピングと認証情報の定義ファイル

(ラ行)

(ら)

ライトトランザクション

ラインオペレーション

(り)

リダイレクタ定義

(ろ)

ログインモジュール名

JAASのコンフィグレーションファイルのオプション

ログの運用で使用するファイル

ログファイルサイズ［dabsv.log］

(ワ行)

(わ)

ワーカごとの定義パラメタ

ワーカ定義ファイル

ワーカ定義ファイルに指定できるキー

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices,Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB（Object Request Broker）間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems,Inc.の商標または登録商標です。
JDKは，米国 Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model　Driven　Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle9iは，米国Oracle Corporationの商標です。
Oracle 10gは，米国Oracle Corporationの商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
Solaris は，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
Sunは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X/Openは，X/Open Company Limited の英国ならびに他の国における登録商標です。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，米国Sun Microsystems,Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。