Cosminexus　システム運用ガイド

手引・操作書

3020-3-M07-60

目　　次

前書き

変更内容

はじめに

第1編　概要

1.　システム運用の概要

1.1　Cosminexusのシステム運用

1.2　システム運用の特長

1.3　システムの運用で実行する作業

1.3.1　J2EEアプリケーションを実行するシステムの場合

1.3.2　バッチアプリケーションを実行するシステムの場合

1.4　システムの運用で使用する機能

1.5　システム運用の作業

1.5.1　システムを起動／停止する

1.5.2　システムの運用状況を監視する

1.5.3　システムの処理性能を監視する

1.5.4　J2EEアプリケーションを運用する

1.6　システム保守の作業

1.6.1　J2EEアプリケーションとリソースを保守する

1.6.2　トラブルに対処する

1.7　システム監査の作業

1.7.1　監査ログを使用してシステムを監査する

1.7.2　データベース監査証跡と連携して運用する

1.8　システム運用を始める前に

1.8.1　Component Container管理者による運用に関する留意事項

1.8.2　トラブル発生時に資料を収集するための準備

1.8.3　Windows Vista使用時の注意事項

1.8.4　運用管理コマンド（mngsvrutil）を利用する場合の留意事項

1.8.5　サーバ管理コマンドを利用する場合の留意事項

1.8.6　作業ディレクトリに関する注意事項

1.8.7　RMIレジストリに関する注意事項

1.8.8　コマンド実行時に指定するWebシステム名，サービスユニット名，およびサーバ名に関する注意事項

第2編　システムの監視

2.　システムの運用監視

2.1　運用監視作業の概要

2.2　論理サーバのステータスの監視

2.2.1　ステータスの監視方法

2.2.2　ステータス監視で確認できる項目

2.3　稼働情報の監視（稼働情報ファイル）

2.3.1　稼働情報ファイルで収集できる情報

2.3.2　稼働情報ファイルの出力

2.3.3　稼働情報ファイルの調査

2.4　稼働情報の監視（運用管理コマンド）

2.4.1　サーバの稼働情報の監視方法（J2EEサーバ，SFOサーバ，バッチサーバ）

2.4.2　稼働情報監視で確認できる項目

2.5　リソース枯渇の監視

2.5.1　出力される情報の種類

2.5.2　出力形式と出力内容

2.6　CTMの稼働統計情報の確認

2.6.1　CTMの稼働統計情報の収集方法

2.6.2　CTMの稼働統計情報の出力先と出力情報

2.6.3　CTMの稼働統計情報の出力例

2.7　トランザクション情報の確認

2.7.1　稼働中のトランザクションの確認

2.7.2　停止中のトランザクションの確認

3.　システムの処理性能の解析

3.1　処理性能の解析作業の概要

3.2　性能解析トレースファイルの収集

3.2.1　性能解析トレースファイルの収集方法

3.2.2　性能解析トレースファイルの出力先と出力情報

3.3　性能解析トレースファイルの利用方法

3.3.1　Webサーバのレスポンスタイムの解析

3.3.2　アプリケーションサーバ内でのリクエストの処理状況の調査

3.3.3　セッションのライフサイクルの調査

3.3.4　タイムアウトが発生したトランザクションの特定

3.3.5　タイムアウトが発生したリクエストの特定

3.3.6　ルートアプリケーション情報を利用したログ調査

3.3.7　トラブルが発生したコネクションの特定

3.3.8　性能解析トレースファイルとスレッドダンプを対応づけた問題個所の調査

第3編　システムの保守

4.　J2EEアプリケーションとリソースの管理

4.1　J2EEアプリケーションとリソースの管理の概要

4.2　Webアプリケーションの最大同時実行スレッド数の動的変更

4.2.1　Webアプリケーションの稼働状況の確認

4.2.2　Webアプリケーションの最大同時実行スレッド数の設定変更

4.2.3　最大同時実行スレッド数を動的に変更したときのWebアプリケーションの動作

4.3　CTMのスケジュールキューの稼働状況の確認と最大同時実行数の変更

4.3.1　CTMのスケジュールキューの稼働状況の確認

4.3.2　CTMのスケジュールキューの同時実行数の変更

4.4　J2EEアプリケーションの実行時間の監視とキャンセル

4.4.1　J2EEアプリケーションの実行状態の確認

4.4.2　タイムアウトが発生したリクエストのキャンセル

4.5　J2EEアプリケーションの閉塞と停止

4.5.1　J2EEアプリケーションの停止方法の種類

4.5.2　システムごとに実行できるサービスの閉塞方法およびJ2EEアプリケーションの停止方法

4.5.3　負荷分散機を利用したサービス閉塞

4.5.4　CTMを使用したサービス閉塞

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

4.6　J2EEアプリケーションの入れ替えと保守

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

4.6.2　リデプロイによるJ2EEアプリケーションの入れ替え

4.6.3　リロードによるJ2EEアプリケーションの入れ替え

4.6.4　入れ替えるJ2EEアプリケーション内のJSPの事前コンパイル

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

4.6.6　CTMを使用したオンライン状態でのJ2EEアプリケーションの入れ替え

4.6.7　テストモードでのJ2EEアプリケーションの運用

4.7　JavaBeansリソースの入れ替え

4.8　クラスタコネクションプールの運用

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

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

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

4.8.4　コネクションプールの状態

5.　トラブルシューティング

5.1　対処の手順

5.2　取得が必要な資料の種類

5.2.1　トラブルの種別と取得が必要な資料

5.2.2　取得が必要な資料の一覧

5.2.3　取得方法および調査方法との対応

5.3　資料の取得

5.3.1　資料の取得方法

5.3.2　トラブル発生時に自動的に取得できる資料

5.3.3　snapshotログの収集

5.4　資料の個別取得

5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）

5.4.2　Cosminexusのログの取得（バッチアプリケーションを実行するシステム）

5.4.3　EJBクライアントアプリケーションのシステムログの取得

5.4.4　性能解析トレースの取得

5.4.5　JavaVMのスレッドダンプの取得

5.4.6　JavaVMのガーベージコレクションログの取得

5.4.7　メモリダンプの取得

5.4.8　日立固有のJavaVMログの取得（日立JavaVMログファイル）

5.4.9　JavaVM出力メッセージログの取得（標準出力またはエラーリポートファイル）

5.4.10　OSの状態情報とOSのログの取得

5.4.11　OSの統計情報の取得

5.4.12　Cosminexusの定義情報の取得

5.4.13　Cosminexusの作業ディレクトリの内容の取得

5.4.14　Cosminexusのリソース設定情報の取得

5.4.15　Webサーバログの取得

5.4.16　JavaVMのスタックトレース情報の取得

5.5　資料の調査

5.5.1　Cosminexusのログの調査

5.5.2　EJBクライアントアプリケーションのログの調査

5.5.3　Cosminexus DABroker Libraryのスプール情報の調査

5.5.4　性能解析トレースの調査

5.5.5　JavaVMのスレッドダンプの調査

5.5.6　JavaVMのガーベージコレクションログの調査

5.5.7　日立JavaVM固有のログの調査（日立JavaVMログファイル）

5.5.8　JavaVMが出力するメッセージログの調査（標準出力およびエラーリポートファイル）

5.5.9　OSの状態情報およびOSのログの調査

5.5.10　スタックトレースの調査

5.6　トラブルへの対処と回復

5.6.1　構成ソフトウェアのプロセス（論理サーバ）が異常終了した場合

5.6.2　J2EEアプリケーションの強制停止に失敗した場合

5.6.3　セッションフェイルオーバ機能でトラブルが発生した場合

5.6.4　データベースと接続中にトラブルが発生した場合

5.6.5　JavaVMが異常終了した場合

5.6.6　JP1と連携したシステムでトラブルが発生した場合

5.6.7　1:1系切り替えシステムでトラブルが発生した場合

5.6.8　N:1リカバリシステムでトラブルが発生した場合

5.6.9　EJBクライアントでトラブルが発生した場合

5.7　トラブルシューティングに関連する留意事項

5.7.1　EJBクライアントアプリケーションのシステムログに関する留意事項

5.7.2　Cosminexus DABroker Libraryのトレースファイルの運用時の留意事項

5.7.3　CTM使用時の留意事項

5.7.4　PRF使用時の留意事項

第4編　システムの監査

6.　監査ログを使用したシステムの監査

6.1　監査ログを使用したシステム監査の概要

6.2　監査ログの収集と調査

6.2.1　監査ログの出力先

6.2.2　監査ログの出力形式

6.2.3　メッセージの出力項目

6.3　監査ログを出力するコマンド・操作一覧

6.3.1　J2EEサーバで使用するコマンド一覧

6.3.2　バッチサーバで使用するコマンド一覧

6.3.3　性能解析トレース・CTMで使用するコマンド一覧

6.3.4　Management Serverで使用するコマンド一覧

6.3.5　EJBクライアントアプリケーションで使用するコマンド一覧

6.3.6　Hitachi Web Serverで使用するコマンド・操作一覧（Windowsの場合）

6.3.7　Hitachi Web Serverで使用するコマンド・操作一覧（UNIXの場合）

6.4　監査ログの出力ポイント

6.4.1　J2EEサーバで使用するコマンドの監査ログの出力ポイント

6.4.2　バッチサーバで使用するコマンドの監査ログの出力ポイント

6.4.3　性能解析トレース・CTMで使用するコマンドの監査ログの出力ポイント

6.4.4　Management Serverで使用するコマンドの監査ログの出力ポイント

6.4.5　EJBクライアントアプリケーションで使用するコマンドの監査ログの出力ポイント

6.4.6　Hitachi Web Serverで使用するコマンド，およびHitachi Web Serverに対する操作の監査ログの出力ポイント（Windowsの場合）

6.4.7　Hitachi Web Serverで使用するコマンド，およびHitachi Web Serverに対する操作の監査ログの出力ポイント（UNIXの場合）

7.　データベース監査証跡と連携した運用

7.1　データベース監査証跡と連携した運用の概要

7.2　データベース監査証跡と連携した運用例

7.2.1　アプリケーションのユーザログの取得

7.2.2　データベースの監査証跡情報の取得

7.2.3　性能解析トレースの取得

7.2.4　情報の特定

7.3　注意事項

第5編　システムの起動と停止

8.　クラスタソフトウェアを使用したシステムの起動と停止（Windowsの場合）

8.1　アプリケーションサーバを対象にした1:1系切り替えシステムの起動と停止

8.1.1　アプリケーションサーバを対象にした1:1系切り替えシステムの起動

8.1.2　アプリケーションサーバを対象にした1:1系切り替えシステムの停止

8.1.3　アプリケーションサーバを対象にした1:1系切り替えシステムで計画的に系を切り替えるときの起動と停止

8.1.4　アプリケーションサーバを対象にした1:1系切り替えシステムをメンテナンスする場合の起動と停止

8.2　運用管理サーバを対象にした1:1系切り替えシステムの起動と停止

8.2.1　運用管理サーバを対象にした1:1系切り替えシステムの起動

8.2.2　運用管理サーバを対象にした1:1系切り替えシステムの停止

8.2.3　運用管理サーバを対象にした1:1系切り替えシステムで計画的に系を切り替えるときの起動と停止

8.3　相互系切り替えシステムの起動と停止

8.3.1　相互系切り替えシステムの起動

8.3.2　相互系切り替えシステムの停止

8.3.3　相互系切り替えシステムで計画的に系を切り替える場合の起動と停止

8.4　N:1リカバリシステムの起動と停止

8.4.1　N:1リカバリシステムの起動

8.4.2　N:1リカバリシステムの停止

9.　クラスタソフトウェアを使用したシステムの起動と停止（UNIXの場合）

9.1　1:1系切り替えシステムの起動と停止

9.1.1　1:1系切り替えシステムの起動

9.1.2　1:1系切り替えシステムの停止

9.1.3　1:1系切り替えシステムで計画的に系を切り替える場合の起動と停止

9.1.4　アプリケーションサーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止

9.1.5　運用管理サーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止

9.2　相互系切り替えシステムの起動と停止

9.2.1　相互系切り替えシステムの起動

9.2.2　相互系切り替えシステムの停止

9.2.3　相互系切り替えシステムで計画的に系を切り替える場合の起動と停止

9.2.4　相互系切り替えシステムをメンテナンスする場合の起動と停止

9.3　N:1リカバリシステムの起動と停止

9.3.1　N:1リカバリシステムの起動

9.3.2　N:1リカバリシステムの停止

付録

付録A　トレース取得ポイントとPRFトレース取得レベル

付録A.1　CTMのトレース取得ポイント

付録A.2　リダイレクタのトレース取得ポイント

付録A.3　Webコンテナのトレース取得ポイント（リクエスト処理のトレース）

付録A.4　Webコンテナのトレース取得ポイント（セッショントレース）

付録A.5　Webコンテナのトレース取得ポイント（フィルタのトレース）

付録A.6　Webコンテナのトレース取得ポイント（セッションフェイルオーバ機能のトレース）

付録A.7　EJBコンテナのトレース取得ポイント

付録A.8　JNDIのトレース取得ポイント

付録A.9　JTAのトレース取得ポイント

付録A.10　DB Connector，JCAコンテナのトレース取得ポイント

付録A.11　RMIのトレース取得ポイント

付録A.12　OTSのトレース取得ポイント

付録A.13　標準出力／標準エラー出力／ユーザログのトレース取得ポイント

付録A.14　DIのトレース取得ポイント

付録A.15　バッチアプリケーション実行機能のトレース取得ポイント

付録A.16　J2EEサーバの開始・終了時のトレース取得ポイント

付録B　snapshotログの収集対象一覧

付録B.1　Cosminexus Component Container

付録B.2　Cosminexus Component Transaction Monitor

付録B.3　Cosminexus DABroker Library

付録B.4　Cosminexus Developer's Kit for Java

付録B.5　Cosminexus Performance Tracer

付録B.6　Cosminexus TPBroker

付録B.7　Cosminexus Web Services - Security

付録B.8　Hitachi Web Server

付録B.9　Cosminexus cFramework

付録B.10　uCosminexus Service Adapter for TP1

付録B.11　監査ログ

付録B.12　そのほかの情報

付録C　データベースと接続中にトラブルが発生したコネクションの特定

付録C.1　Cosminexus Component Container

付録C.2　Cosminexus DABroker Library

付録C.3　HiRDBクライアント

付録C.4　HiRDBサーバ

付録C.5　Oracleクライアント

付録C.6　Oracleサーバ

付録D　機能ごとに出力されるログ情報

付録D.1　J2EEアプリケーション実行時間監視で出力されるログ情報

付録E　障害発生時のCMR用の表の回復

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

付録F.1　ベーシックモードの場合のプロセスの依存関係

付録F.2　ベーシックモードの場合のプロセスの再起動方法

付録G　サーブレットエンジンモードでのシステム運用

付録G.1　Component Container管理者による運用に関する留意事項

付録G.2　システムの起動

付録G.3　システムの停止

付録G.4　システムの処理性能の解析

付録G.5　トラブルシューティング

付録G.6　資料の調査

付録G.7　トラブルへの対処と回復

付録G.8　トラブルシューティングに関連する留意事項

付録G.9　資料の取得方法

付録H　代替手段で実行できる運用作業

付録H.1　システムの起動と停止

付録H.2　システムの運用監視

付録H.3　システムの処理性能解析

付録H.4　統合ユーザ管理のリソースの監視

付録H.5　J2EEアプリケーションとリソースの管理

付録H.6　システムの監査

付録H.7　トラブルシューティング

付録I　用語解説

索引

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

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※

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

■ 輸出時の注意

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

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
cBank，cFramework，cContentsTemplate，cInputCheck，cLogWrapper，cPersistence，cSQLBuilder，cValidator，Eclipse Plugin For cFrameworkは，株式会社イーシー・ワンの日本における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JDKは，米国 Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft Office Excelは，米国 Microsoft Corporation の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle8iは，米国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. の米国およびその他の国における商標または登録商標です。
Sunは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun，Sun Microsystems，Javaは，米国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 の英国ならびに他の国における登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
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-M07
2007年12月 (第4版) 3020-3-M07-60

■ 著作権

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

変更内容

変更内容（3020-3-M07-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

追加・変更内容
変更個所

Application Serverで，バッチ処理を実行するアプリケーションの実行基盤をサポートした。これに伴い，バッチアプリケーションおよびバッチサーバに関する説明を追加した。
1.2，1.3.2，1.5，1.5.1，1.7.2，1.8.1，2.1，2.4，2.4.1，2.4.2，3.1，3.2.2，3.3.4，3.3.6，3.3.8，5.4，5.4.2，5.5.3，5.5.5，5.5.10，6.2.3，6.3.2，6.4.2，7.2.1，8.1，8.1.4，9.1，9.1.4，9.2，9.2.4，付録A，付録A.15，付録B.1

Solarisの記述を追加した。
2.3.3(1)，2.5.2(2)，5.4.1(1)(a)，5.4.2(1)(a)，5.4.7(2)(b)，5.4.10(1)(b)，5.4.10(2)(b)，5.4.11(2)，5.5.8(2)(a)，5.6.5(1)，9.1，9.2，9.3，付録G.9(5)(b)

Connector 1.5仕様に準拠したリソースアダプタを使用した場合の稼働情報ファイルでの稼働情報の監視について，情報を追加した。
2.3.3(7)，2.4.2

メモリ枯渇監視情報の計算式を変更した。
2.5.2(1)

トレース情報を出力する次の機能レイヤを追加した。

バッチアプリケーション実行機能

uCosminexus Service Coordinator Interactive Workflow

uCosminexus Service Adapter for Flat Files

3.1，付録A

トラブルシューティングに必要な資料として，運用管理エージェントで行うRMI処理での保守ログを追加した。
5.4.1(1)

セッションフェイルオーバ機能のログに出力される内容を追加した。
5.6.3(3)

Webコンテナのトレース取得ポイント（セッションフェイルオーバ機能のトレース）を追加した。
付録A.6

Message-driven Bean（EJB2.1）のトレース取得ポイントを追加した。
付録A.7(3)

コネクション自動クローズ機能を使用する場合のトレース取得ポイントを追加した。
付録A.10(4)

Connector1.5に準拠したリソースアダプタでワーク管理を使用する場合のトレース取得ポイントを追加した。
付録A.10(6)

snapshotログ収集対象ディレクトリパスを追加した。
付録B.1，付録B.6

次の製品の適用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

－

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

変更内容（3020-3-M07-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

追加・変更内容

Management Serverの運用管理ポータルを使用して構築したシステム，またはファイルの編集とコマンドの実行で構築したシステムに関する記述を削除した。

統合ユーザ管理に関する記述を削除した。

システムの監査を支援する機能を追加した。

運用管理ポータルでの運用作業に関する記述を削除した。

CTMのスケジュールキューの滞留監視に関する記述を削除した。

PRFトレース取得レベルの確認，および変更に関する記述を削除した。

業務アプリケーションの閉塞のうち，次の方法に関する記述を削除した。

Webサーバのサービス閉塞

J2EEサーバの停止によるサービス閉塞

業務アプリケーションの閉塞解除に関する記述を削除した。

Webアプリケーションのサービス部分閉塞を利用した業務アプリケーションの入れ替えに関する記述を削除した。

Windows Vistaを使用している場合の注意事項を追加した。

コマンド実行時に指定するWebシステム名，サービスユニット名，およびサーバ名に関する注意事項を追加した。

CTMコマンドを使用した，CTMの稼働統計情報の確認に関する記述を削除した。

リソースアダプタをJ2EEアプリケーションに含めてデプロイする機能を追加した。

PRFコマンドを使用した性能解析トレースファイルの出力／収集に関する記述を削除した。

セキュリティアナライザ，およびセキュリティフィルタに関する記述を削除した。

CTMのスケジュールキューの稼働状況の確認と変更の手段，手順に関する記述を追加・変更した。

CTMを利用したサービス閉塞の手段のうち，CTMコマンドでの手段に関する記述を削除した。

業務アプリケーションの停止の手段のうち，運用管理コマンド，運用管理ポータルでの手段に関する記述を削除した。

CTMを利用したオンライン状態での業務アプリケーションの入れ替えの手段のうち，CTMのコマンドでの手段に関する記述を削除した。

snapshotログの取得の手段のうち，運用管理ポータルおよびsnapshotlogコマンドでの手段に関する記述を削除した。

usrconfig.properties，usrconfig.cfgで指定するキーを簡易構築定義ファイルのパラメタに置き換えた。

Cosminexusのログに次のログを追加した。

J2EEサーバに直接デプロイしたリソースアダプタの稼働ログ

アプリケーションに含めてデプロイしたリソースアダプタの稼働ログ

監査ログのメッセージログ

監査ログの例外ログ

mngenvsetupコマンドの実行ログ

cosmienvコマンドのログ

PRFトレースを出力する関連プログラムに，uCosminexus Service Adapter for Object Accessを追加した。

セッショントレースの場合のWebコンテナのトレース取得ポイント，取得レベル，および取得できるトレース情報を追加，修正した。

DB Connector RMと連携する場合に，次のイベントIDでコネクションIDを取得できるようにした。

0x8D61

0x8D63

0x8D80

Cosminexusシステムで実行できる運用作業の一覧を追加した。

JP1/PAM，JP1/Cm2/NNM，およびJP1/PFM/SSOと連携する機能を削除した。

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

第3版では，第2版の内容の一部を，マニュアル「Cosminexus　運用管理操作ガイド」または「Cosminexus　リファレンス　コマンド編」に移動し，目次の構成を変更しました。第2版との対応は次のようになっています。

第2版 | 第3版
1.　システム運用の概要 | 1.　システム運用の概要
2.　システムの運用監視 | 2.　システムの運用監視
3.　システムの処理性能の解析 | 3.　システムの処理性能の解析
4.　統合ユーザ管理のリソースの監視 | マニュアル「Cosminexus　運用管理操作ガイド」に移動
5.　業務アプリケーションとリソースの管理 | 4.　業務アプリケーションとリソースの管理
6.　トラブルシューティング | 5.　トラブルシューティング
－ | 6.　監査ログを使用したシステムの監査
－ | 7.　データベース監査証跡と連携した運用
7.　運用管理ポータルで構築したシステムの起動と停止（Windowsの場合） | マニュアル「Cosminexus　運用管理操作ガイド」に移動
8.　運用管理ポータルで構築したシステムの起動と停止（UNIXの場合） | マニュアル「Cosminexus　運用管理操作ガイド」に移動
9.　ファイル編集とコマンド実行で構築したシステムの起動と停止（Windowsの場合） | マニュアル「Cosminexus　リファレンス　コマンド編」に移動
10.　ファイル編集とコマンド実行で構築したシステムの起動と停止（UNIXの場合） | マニュアル「Cosminexus　リファレンス　コマンド編」に移動
11.　クラスタソフトウェアを使用したシステムの起動と停止（Windowsの場合） | 8.　クラスタソフトウェアを使用したシステムの起動と停止（Windowsの場合）
12.　クラスタソフトウェアを使用したシステムの起動と停止（UNIXの場合） | 9.　クラスタソフトウェアを使用したシステムの起動と停止（UNIXの場合）
付録A　トレース取得ポイントとPRFトレース取得レベル | 付録A　トレース取得ポイントとPRFトレース取得レベル
付録B　snapshotログの収集対象一覧 | 付録B　snapshotログの収集対象一覧
付録C　データベースと接続中にトラブルが発生したコネクションの特定 | 付録C　データベースと接続中にトラブルが発生したコネクションの特定
付録D　機能ごとに出力されるログ情報 | 付録D　機能ごとに出力されるログ情報
付録E　障害発生時のCMR用の表の回復 | 付録E　障害発生時のCMR用の表の回復
付録F　ベーシックモードの利用（互換機能） | 付録F　ベーシックモードの利用（互換機能）
付録G　サーブレットエンジンモードでのシステム運用 | 付録G　サーブレットエンジンモードでのシステム運用
－ | 付録H　代替手段で実行できる運用作業
付録H　用語解説 | 付録I　用語解説

変更内容（3020-3-M07-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

追加・変更機能

タイムアウト発生時に，メッセージ「KDJE50080-W」が出力される機能を追加した。

性能解析トレースの取得ポイントに，イベントID「0x8C41」を追加した。

業務アプリケーションでスローダウンやハングアップが発生したときに，性能解析トレースファイルとスレッドダンプを対応づけて問題個所を調査する方法を追加した。

Server Plug-inを使用して業務アプリケーションの名称を変更する機能を追加した。

運用管理エージェントが出力するログに，「運用管理エージェントの標準エラー出力コマンドライン」を追加した。

EJBクライアントアプリケーションが出力するログに，次のログを追加した。

ユーザ出力ログ

ユーザエラーログ

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

EJBコンテナの保守情報

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

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

EJBクライアントアプリケーションのスレッドダンプを取得できる機能を追加した。

EJBクライアントアプリケーションのログの種別についての記述を追加した。

性能解析トレースの取得ポイントに，次のイベントIDを追加した。

0x8490

0x8491

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

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

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

はじめに

このマニュアルは，Cosminexus（コズミネクサス）を使用して構築したアプリケーションサーバの運用のうち，Smart Composer機能を使用する運用以外の方法について説明したものです。

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の違いによる機能相違点の表記」を参照してください。

対象読者

このマニュアルは，Cosminexusのシステムを運用する方を対象にしています。

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

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

J2EEに関する知識

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

CORBAに関する基本的な知識

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

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

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

Microsoft Cluster Serviceを使用したクラスタ構成に関する基本的な知識

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

HAモニタを使用したクラスタ構成に関する基本的な知識

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

マニュアルの構成

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

第1編　概要

Cosminexusシステムの運用方法の種類や運用サイクルなど，システム運用の概要について説明しています。

第2編　システムの監視

システム監視に関する作業について説明しています。

第3編　システムの保守

システム保守に関する作業について説明しています。

第4編　システムの監査

システム監査に関する作業について説明しています。

第5編　システムの起動と停止

クライアントソフトウェアを使用したシステムの起動方法と停止方法について説明しています。

付録A　トレース取得ポイントとPRFトレース取得レベル

トレース情報を取得できる機能レイヤとトレース取得ポイント，およびPRFトレース取得レベルについて説明しています。

付録B　snapshotログの収集対象一覧

snapshotログの収集対象のディレクトリについて説明しています。

付録C　データベースと接続中にトラブルが発生したコネクションの特定

データベース（HiRDB，またはOracle）との接続中にトラブルが発生した場合に，性能解析トレースファイルを利用して，トラブルが発生したコネクションを特定する方法について説明しています。

付録D　機能ごとに出力されるログ情報

特定の機能を利用したときに出力されるログ情報について説明しています。

付録E　障害発生時のCMR用の表の回復

CMRを含むアプリケーションの回復方法について説明しています。

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

ベーシックモードを使用した場合のシステムの運用方法について説明しています。

付録G　サーブレットエンジンモードでのシステム運用

サーブレットエンジンモードを使用した場合のシステムの運用方法について説明しています。

付録H　代替手段で実行できる運用作業

代替手段を利用して実行できる運用作業について説明しています。

付録I　用語解説

このマニュアルで使用している用語の意味について説明しています。

関連マニュアル

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

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

Cosminexus　概説

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

Cosminexus　機能解説

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

Cosminexus　システム設計ガイド

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

Cosminexus　簡易構築・運用ガイド

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

Cosminexus　システム構築ガイド

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

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

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

Cosminexus　運用管理操作ガイド

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

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

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

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およびタグについて説明しています。

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

Cosminexus SOAPアプリケーション開発ガイド（3020-3-M47）

Cosminexus Webサービスセキュリティ　使用の手引（3020-3-M48）

スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（UNIX(R)用）（3000-6-275）

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

スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（UNIX(R)用）（3000-6-354）

スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（UNIX(R)用）（3000-6-355）

スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（Windows(R)用）（3020-6-275）

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

スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（Windows(R)用）（3020-6-354）

スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（Windows(R)用）（3020-6-355）

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

JP1 Version 7i JP1/Base（3020-3-F04）

JP1 Version 7i JP1/Automatic Job Management System 2 操作ガイド（3020-3-F09）

JP1 Version 8 JP1/Automatic Job Management System 2 操作ガイド（3020-3-K24）

高信頼化システム監視機能　HAモニタ　AIX(R)編（3000-9-130）

高信頼化システム監視機能　HAモニタ　HP-UX編（3000-9-131）

高信頼化システム監視機能　HAモニタ　Linux(R)編（3000-9-132）

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

正式名称 | このマニュアルでの表記
TPBroker Version 5　TPBroker　ユーザーズガイド | TPBroker　ユーザーズガイド
JP1 Version 7i JP1/Base | JP1/Base
JP1 Version 8 JP1/Automatic Job Management System 2 操作ガイド | JP1/Automatic Job Management System 2 操作ガイド
JP1 Version 7i JP1/Automatic Job Management System 2 操作ガイド
スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド | HiRDB UAP開発ガイド
スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（UNIX(R)用） | HiRDB システム運用ガイド
スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（UNIX(R)用） | HiRDB コマンドリファレンス
スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（Windows(R)用）
高信頼化システム監視機能　HAモニタ　AIX(R)編 | 高信頼化システム監視機能　HAモニタ
高信頼化システム監視機能　HAモニタ　HP-UX編
高信頼化システム監視機能　HAモニタ　Linux(R)編

読書手順

このマニュアルは，利用目的に合わせて章を選択して読むことができます。利用目的別にお読みいただくことをお勧めします。

マニュアルを読む目的 | 記述個所
システムの運用方法の概要について知りたい。 | システムの運用方法の種類について知りたい。 | 第1編 1章
システムの監視について知りたい。 | システムで運用中に監視できる項目と監視方法について知りたい。 | 第2編 2章
性能解析トレースの収集方法および利用方法について知りたい。 | 第2編 3章
システムの保守について知りたい。 | J2EEアプリケーションとリソースの管理方法について知りたい。 | 第3編 4章
トラブルシューティングについて知りたい。 | 第3編 5章
システムの監査について知りたい。 | システムの監査で利用できる監査ログについて知りたい。 | 第4編 6章
データベースの監査証跡と連携した場合の運用について知りたい。 | 第4編 7章
システムの起動と停止について知りたい。 | Windowsを使用している場合の，クラスタソフトウェアを使用したシステムの起動と停止の手順について知りたい。 | 第5編 8章
UNIXを使用している場合の，クラスタソフトウェアを使用したシステムの起動と停止の手順について知りたい。 | 第5編 9章
トレース取得ポイントとPRFトレース取得レベルについて知りたい。 | システムの処理性能を解析する場合の性能解析トレース取得ポイントとPRFトレースの取得レベルについて知りたい。 | 付録A
障害発生時の回復方法について知りたい。 | snapshotログの収集対象について知りたい。 | 付録B
CMRを含むアプリケーションの回復方法について知りたい。 | 付録E
データベース関連の障害発生時の対処方法について知りたい。 | データベース（HiRDBまたはOracle）との接続中にトラブルが発生したコネクションの確認方法について知りたい。 | 付録C
出力されるログ情報について知りたい。 | 特定の機能を使用している場合に出力されるログ情報について知りたい。 | 付録D
互換用機能について知りたい。 | ベーシックモードでのシステムの運用方法について知りたい。 | 付録F
サーブレットエンジンモードでのシステムの運用方法について知りたい。 | 付録G
運用作業の代替手段について知りたい。 | 運用作業で利用できる代替手段について知りたい。 | 付録H
用語について知りたい。 | このマニュアルで使用している用語について知りたい。 | 付録I

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

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

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

ご利用の製品名 | マニュアルで使用している用語
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
Excel | Microsoft(R) Office Excel
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
Internet Explorer | Microsoft(R) Internet Explorer(R)
IPF | Itanium(R) Processor Family
JP1/AJS2 | JP1/AJS2 - Agent | JP1/Automatic Job Management System 2 - Agent
JP1/AJS2 - Light Edition | JP1/Automatic Job Management System 2 - Light Edition
JP1/AJS2 - Manager | JP1/Automatic Job Management System 2 - Manager
JP1/AJS2 - View | JP1/Automatic Job Management System 2 - View
Microsoft Cluster Service | Microsoft(R) Cluster Service
Microsoft IIS | Microsoft IIS 6.0 | Microsoft(R) Internet Information Services 6.0
Oracle | Oracle9i | Oracle9i
Oracle9i R2
Oracle10g | Oracle 10g
Oracle 10g R2
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と表記することがあります。

このマニュアルで使用している表記と，対応する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
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
JCA | J2EETM Connector Architecture
JDBC | JDBCTM
JavaTM Database Connectivity
JDK | JavaTM Development Kit
JMS | Java Message Service
JNDI | Java Naming and Directory InterfaceTM
JSF | JavaServerTM Faces Reference Implementation (RI) Version: 1.1_01 FCS
JSP | JavaServer PagesTM
JTA | JavaTM Transaction API
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
CMP | Container-Managed Persistence
CMR | Container-Managed Relationship
CMT | Container-Managed Transaction
CORBA | Common Object Request Broker Architecture
CSV | Comma Separated Value
CUI | Character User Interface
DB | Database
DBMS | Database Management System
DD | Deployment Descriptor
DMZ | Demilitarized Zone
DN | Distinguished Name
DNS | Domain Name System
EIS | Enterprise Information System
EL | Expression Language
GUI | Graphical User Interface
HA | High Availability
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
HTTPS | Hyper Text Transfer Protocol Security
IIOP | Internet Inter-Orb Protocol
JIS | Japanese Industrial Standards
JNI | Java Native Interface
LAN | Local Area Network
LDAP | Lightweight Directory Access Protocol
LDIF | LDAP Data Interchange Format
MDA | Model Driven Architecture
MIB | Management Information Base
OID | Object Identifier
OMG | Object Management Group
ORB | Object Request Broker
OS | Operating System
OTM | Object Transaction Monitor
OTS | Object Transaction Service
PIM | Platform Independent Model
PSM | Platform Specific Model
RDB | Relational Database
RMI | Remote Method Invocation
RPC | Remote Procedure Call
SFO | Session Fail Over
SNMP | Simple Network Management Protocol
SOA | Service Oriented Architecture
SOAP | Simple Object Access Protocol
UDDI | Universal Description, Discovery and Integration
UML | Unified Modeling Language
URI | Uniform Resource Identifier
URL | Uniform Resource Locator
VM | Virtual Machine
XML | Extensible Markup Language

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

このマニュアルの図中で使用している記号を，次のように定義します。

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

注意

間違いやすい点，および間違うとトラブルが発生するような項目について説明しています。

ポイント

その説明の要点について説明しています。

参考

補足的な情報を説明しています。

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

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

記号
意　味

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

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

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

<　>
この記号で囲まれている項目は，該当する要素やファイルなどを指定したり，該当する要素が表示されたりすることを示します。
（例1）　<プロパティ>
　プロパティを記述します。またはプロパティが表示されます。
（例2）　<ファイル名>
　ファイル名を指定します。

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

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

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

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

鍵（かぎ）　個所（かしょ）　全て（すべて）　汎用（はんよう）　必須（ひっす）　閉塞（へいそく）

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

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

1.　システム運用の概要

この章では，Cosminexusで構築したシステムの運用方法の種類，およびシステムの運用サイクルについて説明します。

＜この章の構成＞

1.1　Cosminexusのシステム運用

1.2　システム運用の特長

1.3　システムの運用で実行する作業

1.4　システムの運用で使用する機能

1.5　システム運用の作業

1.6　システム保守の作業

1.7　システム監査の作業

1.8　システム運用を始める前に

1.1　Cosminexusのシステム運用

Cosminexusのシステムでは，アプリケーション開発とシステム構築の作業が終了したあと，システムの運用を開始します。システムの運用では，日常的なシステム運用と定期的なシステム保守を繰り返します。

Cosminexusのシステムの運用サイクルを次の図に示します。

図1-1　システムの運用サイクル（概要）

システム運用は，日常的に実施する作業です。システム運用では，システムの起動や停止のほか，システムを安定稼働させるために，システムの稼働状況や性能などを監視します。

システム保守は，システムの動作環境や実行するアプリケーションを変更する場合や，システムにトラブルが発生した場合などに，必要に応じて実施する作業です。システムの保守では，動作環境の設定を変更したり，運用中に発生したトラブルに対処したりします。

システムの運用サイクルを構成する作業を次の表に示します。

表1-1　システムの運用サイクルを構成する作業

分類
作業内容
参照先

システムの起動と停止

システムの起動／停止

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

マニュアル「Cosminexus　簡易構築・運用ガイド」，第5編　システムの起動と停止※1

システムの監視

システムの運用状況の監視

システムの処理性能の監視

第2編　システムの監視

システムの保守

J2EEアプリケーション※2・リソースの保守

システムの動作環境の設定変更

トラブルへの対処

第3編　システムの保守

注※1　Smart Composer機能を使用したシステムの起動と停止の方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」のシステムの起動と停止の説明を参照してください。このマニュアルでは，クラスタソフトウェアを使用したシステムの起動と停止の方法について説明しています。

注※2　J2EEアプリケーションの保守は，バッチアプリケーションを実行するシステムの運用では実施しません。

運用サイクルを図で表すと，次のようになります。

図1-2　システムの運用サイクル（J2EEサーバモードの場合）

なお，運用サイクルに含まれない運用作業として，システムの監査があります。システムの監査に関する運用作業には，監査ログを使用してシステムを監査する場合や，データベースが提供する監査証跡の機能と連携する場合の運用作業があります。

次の節以降では，システム運用，システム保守，およびシステム監査の各作業の概要について説明します。

1.2　システム運用の特長

Cosminexusのシステムでは，Smart Composer機能を使用して構築したシステムに対して，コマンドで一括して運用できます。ここでは，Cosminexusのシステムの一括運用について説明します。

Cosminexusのシステムは，一つのホストだけではなく複数のホストで構成されることがあります。このような複数のホストで構成されるシステムを Management Serverを利用することで一元管理します。Management Serverによる運用管理の概要を次に示します。

図1-3　Management Serverによる運用管理の概要

論理サーバとは，Management Serverの運用管理の対象になる，サーバまたはクラスタです。サーバとはCosminexusのサーバの実体で，WebサーバやJ2EEサーバ，バッチサーバなどがあります。クラスタとは，ある共通の機能を持つ論理サーバの集合で，J2EEサーバクラスタやWebサーバクラスタなどがあります。なお，クラスタに対しては，一括して運用操作を実行できるため，単体の論理サーバと同様に管理できます。

Management Serverでは，複数の論理サーバをまとめて管理します。一つのManagement Serverが管理する範囲のことを，運用管理ドメインといいます。運用管理ドメインは，同一の運用管理ポリシーを適用する論理サーバの集合です。なお，運用管理ドメインは，互いに排他の関係になるため，一つの論理サーバが複数の運用管理ドメインに包含されることはありません。

なお，システムを一括運用するには，Smart Composer機能，または運用管理コマンドを使用します。次に，それぞれの方法の概要について説明します。

＜この節の構成＞

(1)　Smart Composer機能を使用する

(2)　運用管理コマンドを使用する

(1)　Smart Composer機能を使用する

Smart Composer機能とは，システムを簡単に構築・運用するための機能です。

Smart Composer機能を使用すると，次のシステム運用の作業を実行できます。

サービスユニットを一括起動または一括停止する

サービスユニットのステータスを確認する

Webシステム内のサービスユニットの構成を確認する

Smart Composer機能を使用したシステム運用の設定および作業の詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」のシステム運用の説明を参照してください。

(2)　運用管理コマンドを使用する

運用管理コマンド（mngsvrutil）とは，Management Serverを操作するためのインタフェースです。

運用管理コマンドを使用すると，論理サーバ単位，ホスト単位，または運用管理ドメイン単位の操作を実行できるため，システムを多面的に運用・管理できます。運用管理コマンドの概要を次に示します。

運用管理コマンドを使用した運用では，次に示すような論理サーバの運用操作を実行できます。

論理サーバのアプリケーションを管理する

論理サーバの運用監視をする

システム全体の処理性能を監視・解析するための性能情報を収集する

1.3　システムの運用で実行する作業

ここでは，Cosminexusのシステムの運用作業について説明します。

＜この節の構成＞

1.3.1　J2EEアプリケーションを実行するシステムの場合

1.3.2　バッチアプリケーションを実行するシステムの場合

1.3.1　J2EEアプリケーションを実行するシステムの場合

ここでは，J2EEアプリケーションを実行するシステムの運用で実施する作業について説明します。J2EEアプリケーションを実行するシステムでは，次の運用作業を実施します。

システムの起動と停止

システムの運用監視

システムの処理性能解析

J2EEアプリケーションとリソースの管理

システムの監査

システムの変更

システム環境の移行

トラブルシューティング

これらの作業を実行するには，主に次の手段を使用します。

Smart Composer機能のコマンドを使用する

運用管理コマンド（mngsvrutil）を使用する

Cosminexusのコマンドを使用する

なお，ここでは，Cosminexusシステムで推奨する手段で，各運用作業を実行する場合について説明しています。これ以外の手段で実行する運用作業については，「付録H　代替手段で実行できる運用作業」を参照してください。

＜この項の構成＞

(1)　システムの起動と停止で実行できる作業

(2)　システムの運用監視で実行できる作業

(3)　システムの処理性能解析で実行できる作業

(4)　J2EEアプリケーションとリソースの管理で実行できる作業

(5)　システムの監査で実行できる運用作業

(6)　システムの変更でできる運用作業

(7)　システム環境の移行で実行できる運用作業

(8)　トラブルシューティングで実行できる作業

(1)　システムの起動と停止で実行できる作業

システムの起動と停止で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-2　システムの起動と停止で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
サービスユニットを一括起動します。 | 不要 | － | 簡易構築 | cmx_start_targetコマンド
サービスユニットを一括停止します。 | 不要 | － | 簡易構築 | cmx_stop_targetコマンド
クラスタソフトウェアを使用したシステムを起動・停止します。 | 必要 | 構築 | 8章，9章 | Cosminexusのコマンド，クラスタソフトウェアの機能

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

構築：マニュアル「Cosminexus　システム構築ガイド」

(2)　システムの運用監視で実行できる作業

システムの運用監視で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-3　システムの運用監視で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
サービスユニットのステータスを確認します。 | 不要 | － | 簡易構築 | cmx_list_statusコマンド
論理サーバのステータスを確認します。 | 不要 | 構築 | 2.2 | 運用管理コマンド（mngsvrutil）
システム内のサービスユニットの構成を確認します。 | 不要 | － | 簡易構築 | cmx_list_modelコマンド
稼働情報ファイルを参照して，J2EEサーバおよびSFOサーバの稼働情報を監視します。 | 省略可 | 構築 | 2.3 | －
運用管理コマンドを使用して，J2EEサーバおよびSFOサーバの稼働情報を監視します。 | 不要 | － | 2.4 | 運用管理コマンド（mngsvrutil）
リソースの使用率や使用数を監視して，しきい値を超えた場合に原因を調査します。 | 省略可 | 構築 | 2.5 | －
稼働情報ファイルに出力される稼働情報，またはリソースの枯渇状況に応じてメッセージが出力された場合の処理を自動化します（Managementアクション）。 | 必要 | 構築 | － | －
CTMの稼働統計情報を出力します。※ | 不要 | － | 2.6 | 運用管理コマンド（mngsvrutil）
トランザクションの状態を確認します。 | 不要 | － | 2.7 | サーバ管理コマンド（cjlisttrn）

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

構築：マニュアル「Cosminexus　システム構築ガイド」

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

(3)　システムの処理性能解析で実行できる作業

システムの処理性能解析で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-4　システムの処理性能解析で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
性能解析トレースファイルを収集します。 | 不要 | － | 3.2 | 運用管理コマンド（mngsvrutil）
収集した性能解析トレースファイルを利用してシステムの処理性能を解析します。 | 不要 | － | 3.3 | －

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

(4)　J2EEアプリケーションとリソースの管理で実行できる作業

J2EEアプリケーションとリソースの管理で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-5　J2EEアプリケーションとリソースの管理で実行できる作業

運用作業
運用前の設定の要否
運用前の設定方法の参照先
運用方法

参照先
手段

Webアプリケーションの稼働状況を確認します。
不要
－
4.2.1
運用管理コマンド（mngsvrutil）

アクセス状況に応じて，Webアプリケーションの同時実行スレッド数を動的に変更します。
不要
－
4.2.2
運用管理コマンド（mngsvrutil）

CTMのスケジュールキューの稼働状況を確認して，同時実行数を動的に変更します。※1
不要
－
4.3

確認：運用管理コマンド（mngsvrutil）

確認と変更：CTMのコマンド（ctmlsque，ctmchpara）

J2EEアプリケーションの実行状態を確認して，J2EEアプリケーションでタイムアウトが発生したリクエストをキャンセルします（J2EEアプリケーションの実行時間監視機能）。
必要
構築
4.4

確認：サーバ管理コマンド（cjlistthread）

キャンセル：サーバ管理コマンド（cjstopthread）

J2EEアプリケーションを通常開始します。
不要
－
リファレンス
サーバ管理コマンド（cjstartapp）

J2EEアプリケーションを通常停止します。
不要
－
4.5.5
サーバ管理コマンド（cjstopapp）

J2EEアプリケーションを強制停止します。
不要
－
4.5
サーバ管理コマンド（cjstopapp）

負荷分散機を使用してサービスを閉塞します。※2
－
－
4.5.3
負荷分散機の機能

CTMを利用してサービスを閉塞します。※1
不要
－
4.5.4
運用管理コマンド（mngsvrutil）

J2EEアプリケーションを入れ替えます。
リデプロイによる入れ替え
省略可
構築
4.6.2
サーバ管理コマンド（cjreplaceapp）

通常の入れ替え
不要
－
4.6.1
サーバ管理コマンド（cjstopapp，cjimportapp）

リロードによる入れ替え
必要
構築
4.6.3
サーバ管理コマンド（cjreloadapp）

JSPを事前にコンパイルしてから，J2EEアプリケーションを入れ替えます。
省略可／不要
構築
4.6.4
cjjspcコマンド

J2EEアプリケーションの名称を変更します。
不要
－
4.6.5
サーバ管理コマンド（cjrenameapp）

CTMを利用して，オンライン状態でJ2EEアプリケーションを入れ替えます。※1
不要
－
4.6.6
運用管理コマンド（mngsvrutil）

J2EEアプリケーションを本番環境でテストしてから本番運用を開始します。
不要
－
4.6.7
サーバ管理コマンド（cjimportapp，cjstartapp）

コネクションプールの情報を表示します。
不要
－
解説
サーバ管理コマンド（cjlistpool）

コネクションプールをクリアします。
不要
－
解説
サーバ管理コマンド（cjclearpool）

JavaBeansリソースを入れ替えます。
不要
－
4.7
サーバ管理コマンド（cjdeletejb，cjimportjb）

クラスタ構成のデータベースをメンテナンスします。
不要
－
4.8
サーバ管理コマンド（cjlistrar，cjsuspendpool，cjresumepool）

リソースの接続テストをします。
必要
構築
解説
サーバ管理コマンド（cjtestres）

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

解説：マニュアル「Cosminexus　機能解説」

構築：マニュアル「Cosminexus　システム構築ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

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

注※2　負荷分散機をSmart Composer機能で管理していない場合に実行します。負荷分散機をSmart Composer機能で管理している場合は，cmx_stop_targetコマンドを使用してサービスを閉塞してください。cmx_stop_targetコマンドの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(5)　システムの監査で実行できる運用作業

監査ログを使用したシステムの監査，およびデータベース監査証跡と連携した運用で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-6　システムの監査で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
監査ログを出力して，管理します。 | 必要 | 構築 | 6.2 | －
監査ログを収集して調査します。 | 必要 | 構築 | 6.2 | －
データベース監査証跡に出力された情報を基に，データベースにアクセスしたリクエストの情報を特定します。 | 不要 | － | 7.2 | －

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

(6)　システムの変更でできる運用作業

システムの変更で実行できる作業について，次の表に示します。

表1-7　システムの変更で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
設定変更 | システム全体の設定を一括で変更します。 | 不要 | － | 簡易構築 | －
構成変更 | システムをスケールアウトします。 | 不要 | － | 簡易構築 | －
システムをスケールインします。 | 不要 | － | 簡易構築 | －
削除 | システムを削除します。 | 不要 | － | 簡易構築 | －

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

(7)　システム環境の移行で実行できる運用作業

システム環境の移行で実行できる作業について，次の表に示します。

表1-8　システム環境の移行で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
構築済みのシステムの環境を移行します。 | 不要 | － | 簡易構築 | －

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

(8)　トラブルシューティングで実行できる作業

トラブルシューティングで実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-9　トラブルシューティングで実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
トラブルシューティングに必要な資料を収集します。 | 必要／省略可 | 構築 | 5.3.1 | 運用管理コマンド（mngsvrutil）
論理サーバ（構成ソフトウェアのサーバプロセス）に異常が発生した場合の処理を自動化します。 | 省略可 | 構築 | 5.3.2 | －
トラブルシューティングに必要な資料を調査します。 | 不要 | － | 5.5 | －
負荷分散機を閉塞して，システムの部分メンテナンスをします。 | 不要 | － | 簡易構築 | －

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

1.3.2　バッチアプリケーションを実行するシステムの場合

ここでは，バッチアプリケーションを実行するシステムの運用で実施する作業について説明します。バッチアプリケーションを実行するシステムでは，次の運用作業を実施します。

システムの起動と停止

システムの運用監視

システムの処理性能解析

リソースの管理

システムの監査

システムの変更

システム環境の移行

トラブルシューティング

これらの作業を実行するには，主に次の手段を使用します。

Smart Composer機能のコマンドを使用する

運用管理コマンド（mngsvrutil）を使用する

Cosminexusのコマンドを使用する

なお，ここでは，Cosminexusシステムで推奨する手段で，各運用作業を実行する場合について説明しています。これ以外の手段で実行する運用作業については，「付録H　代替手段で実行できる運用作業」を参照してください。

＜この項の構成＞

(1)　システムの起動と停止で実行できる作業

(2)　システムの運用監視で実行できる作業

(3)　システムの処理性能解析で実行できる作業

(4)　リソースの管理で実行できる作業

(5)　システムの監査で実行できる運用作業

(6)　システムの変更で実行できる運用作業

(7)　システム環境の移行で実行できる運用作業

(8)　トラブルシューティングで実行できる作業

(1)　システムの起動と停止で実行できる作業

システムの起動と停止で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-10　システムの起動と停止で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
サービスユニットを一括起動します。 | 不要 | － | 簡易構築 | cmx_start_targetコマンド
サービスユニットを一括停止します。 | 不要 | － | 簡易構築 | cmx_stop_targetコマンド
クラスタソフトウェアを使用したシステムを起動・停止します。 | 必要 | 構築 | 8章，9章 | Cosminexusのコマンド，クラスタソフトウェアの機能

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

構築：マニュアル「Cosminexus　システム構築ガイド」

(2)　システムの運用監視で実行できる作業

システムの運用監視で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-11　システムの運用監視で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
サービスユニットのステータスを確認します。 | 不要 | － | 簡易構築 | cmx_list_statusコマンド
論理サーバのステータスを確認します。 | 不要 | 構築 | 2.2 | 運用管理コマンド（mngsvrutil）
システム内のサービスユニットの構成を確認します。 | 不要 | － | 簡易構築 | cmx_list_modelコマンド
稼働情報ファイルを参照して，バッチサーバの稼働情報を監視します。 | 省略可 | 構築 | 2.3 | －
運用管理コマンドを使用して，バッチサーバの稼働情報を監視します。 | 不要 | － | 2.4 | 運用管理コマンド（mngsvrutil）
リソースの使用率や使用数を監視して，しきい値を超えた場合に原因を調査します。 | 省略可 | 構築 | 2.5 | －
稼働情報ファイルに出力される稼働情報，またはリソースの枯渇状況に応じてメッセージが出力された場合の処理を自動化します（Managementアクション）。 | 必要 | 構築 | － | －

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

構築：マニュアル「Cosminexus　システム構築ガイド」

(3)　システムの処理性能解析で実行できる作業

システムの処理性能解析で実行できる作業について，次の表に示します。

表1-12　システムの処理性能解析で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
性能解析トレースファイルを収集します。 | 不要 | － | 3.2 | 運用管理コマンド（mngsvrutil）
収集した性能解析トレースファイルを利用してシステムの処理性能を解析します。 | 不要 | － | 3.3 | －

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

(4)　リソースの管理で実行できる作業

リソースの管理で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-13　リソースの管理で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
コネクションプールの情報を表示します。 | 不要 | － | 解説 | サーバ管理コマンド（cjlistpool）
コネクションプールをクリアします。 | 不要 | － | 解説 | サーバ管理コマンド（cjclearpool）
クラスタ構成のデータベースをメンテナンスします。 | 不要 | － | 4.8 | サーバ管理コマンド（cjlistrar，cjsuspendpool，cjresumepool）
リソースの接続テストをします。 | 必要 | 構築 | 解説 | サーバ管理コマンド（cjtestres）

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

解説：マニュアル「Cosminexus　機能解説」

構築：マニュアル「Cosminexus　システム構築ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

(5)　システムの監査で実行できる運用作業

監査ログを使用したシステムの監査，およびデータベース監査証跡と連携した運用で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-14　システムの監査で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
監査ログを出力して，管理します。 | 必要 | 構築 | 6.2 | －
監査ログを収集して調査します。 | 必要 | 構築 | 6.2 | －
データベース監査証跡に出力された情報を基に，データベースにアクセスしたリクエストの情報を特定します。 | 不要 | － | 7.2 | －

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

(6)　システムの変更で実行できる運用作業

システムの変更で実行できる作業について，次の表に示します。

表1-15　システムの変更で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
設定変更 | システム全体の設定を一括で変更します。 | 不要 | － | 簡易構築 | －
構成変更 | システムをスケールアウトします。 | 不要 | － | 簡易構築 | －
システムをスケールインします。 | 不要 | － | 簡易構築 | －
削除 | システムを削除します。 | 不要 | － | 簡易構築 | －

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

(7)　システム環境の移行で実行できる運用作業

システム環境の移行で実行できる作業について，次の表に示します。

表1-16　システム環境の移行で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
構築済みのシステムの環境を移行します。 | 不要 | － | 簡易構築 | －

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

(8)　トラブルシューティングで実行できる作業

トラブルシューティングで実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表1-17　トラブルシューティングで実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
トラブルシューティングに必要な資料を収集します。 | 必要／省略可 | 構築 | 5.3.1 | 運用管理コマンド（mngsvrutil）
論理サーバに異常が発生した場合の処理を自動化します。 | 省略可 | 構築 | 5.3.2 | －
トラブルシューティングに必要な資料を調査します。 | 不要 | － | 5.5 | －

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

1.4　システムの運用で使用する機能

ここでは，システムの運用で使用する機能の概要について説明します。システムの運用で使用する機能には，サーバプロセスを操作する機能とアプリケーションを操作する機能の二つがあります。それぞれの機能の概要について次に説明します。

＜この節の構成＞

(1)　サーバプロセスを操作する機能

(2)　アプリケーションを操作する機能

(1)　サーバプロセスを操作する機能

サーバプロセスを操作する機能について説明します。

Smart Composer機能

システムを簡単に構築・運用するための機能です。

Smart Composer機能を使用して構築したシステムでは，J2EEサーバやWebサーバで構成される，業務サービスを提供する閉じた部分系を，サービスユニットとして扱います。Smart Composer機能を使用することで，サービスユニット単位で一括したシステム運用ができます。

運用管理コマンド（mngsvrutil）

Management Serverの運用管理の対象となる，論理サーバの運用操作を実行するコマンドです。

運用管理ポータル

Webブラウザに表示されるポータル画面を通して，Management Serverの運用管理の対象となる論理サーバの運用操作を実行する機能です。

J2EEサーバを操作するコマンド

J2EEサーバを起動，停止するためのコマンドです。cjstartsvコマンド，およびcjstopsvコマンドがあります。

CTMのコマンド

リクエストのスケジューリングをするための機能を提供している，CTMを操作するためのコマンドです。CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

PRFのコマンド

システムの処理性能を解析するときに使用する，性能解析トレース情報を編集してファイルに出力したり，PRFトレースファイルの取得レベルを設定したりするコマンドです。

(2)　アプリケーションを操作する機能

サーバ管理コマンド

J2EEサーバで管理しているアプリケーションおよびリソースの設定をするためのコマンドです。

Server Plug-in

リソースアダプタやJ2EEアプリケーションを設定するためのGUIです。Eclipseのプラグインとして使用できます。

1.5　システム運用の作業

ここでは，日常的なシステムの運用で実施する作業について説明します。

日常的なシステム運用の作業は，次のような作業で構成されます。

システムの起動／停止

システムの運用状況の監視

システムの処理性能の監視

J2EEアプリケーションの運用※

なお，システムの起動以外の運用作業は，すべてシステムが起動した状態で実施する作業です。

注※　J2EEアプリケーションの運用は，バッチアプリケーションを実行するシステムの運用では実施しません。

＜この節の構成＞

1.5.1　システムを起動／停止する

1.5.2　システムの運用状況を監視する

1.5.3　システムの処理性能を監視する

1.5.4　J2EEアプリケーションを運用する

1.5.1　システムを起動／停止する

Cosminexusで構築したシステムを運用するためには，Cosminexusの構成ソフトウェアの複数のサーバプロセスを適切な順序で起動する必要があります。システムの構成によっては，同じ種類のサーバプロセスを複数起動することもあります。また，サービスを開始するためには，J2EEアプリケーションの開始も必要です。

Cosminexusのシステムでは，J2EEサーバやWebサーバで構成される業務サービスを提供する閉じた部分系を，サービスユニットとして管理します。Smart Composer機能を使用して，サービスユニット単位でシステムを一括して起動したり，停止したりできます。Smart Composer機能を使用したシステムの起動・停止方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

参考

このマニュアルでは，クラスタソフトウェアを使用したシステムの起動・停止方法について説明しています。

1.5.2　システムの運用状況を監視する

ここでは，システムの運用状況を監視する作業の概要について説明します。

システムの運用状況を監視する方法の詳細については，「2.　システムの運用監視」を参照してください。

＜この項の構成＞

(1)　論理サーバのステータスを監視する

(2)　論理サーバの稼働情報を監視する

(3)　リソースの使用率または使用数を基にリソースの枯渇を監視する

(4)　CTMの稼働情報を監視する

(5)　トランザクションの状態を確認する

(1)　論理サーバのステータスを監視する

システムを構成するホストおよびサーバのステータスを確認して，システムが正常に稼働しているかどうかを監視できます。この情報を基に，必要に応じて起動，停止，再起動ができます。

(2)　論理サーバの稼働情報を監視する

論理サーバや論理サーバで稼働しているアプリケーションの稼働情報を基に，システムの性能を監視できます。システムの性能を監視することで，システム内の問題個所を発見したり，パフォーマンスチューニングに役立てたりすることができます。

参考

論理サーバの稼働情報を監視するには，稼働情報ファイルを使用できます。稼働情報ファイルに出力されるフルガーベージコレクション回数，またはURLグループ単位の実行待ちリクエスト数がしきい値を超えたときに，メッセージが出力されます。稼働情報ファイルに出力される情報を基にしてメッセージを出力する機能を，しきい値イベントといいます。また，しきい値イベントによってメッセージが出力されたときに，適切な処置を自動実行するように設定できます。しきい値イベントによって出力されたメッセージを基にして自動実行する処理を，Managementアクションといいます。

Managementアクションの設定方法の詳細は，マニュアル「Cosminexus　システム構築ガイド」のManagementイベントによる処理の自動実行の設定に関する説明を参照してください。

(3)　リソースの使用率または使用数を基にリソースの枯渇を監視する

リソースの使用率または使用数の推移を監視して，使用率または使用数がしきい値を超えた場合，メッセージを出力できます。リソースの使用率または使用数の推移は，リソース枯渇監視情報として定期的に出力できます。しきい値を超えた場合，出力されているリソース枯渇監視情報を基に原因を分析して適切に対処することで，トラブルの発生を未然に防げます。また，リソース枯渇監視情報は，トラブル発生後の要因の解析にも役立ちます。

参考

しきい値を超えたときに出力されるメッセージを使用して，システムにトラブルが発生する前に適切な処置を自動実行するように設定できます。例えば，JavaVMのヒープメモリを監視してフルガーベージコレクションの発生を防ぐ設定などができます。このように，リソース枯渇監視情報を基にして自動実行する処理を，Managementアクションといいます。しきい値を超えたときに出力されるメッセージによって発生するイベントのことを， Managementイベントといいます。Managementイベントによる処理の自動実行の設定については，マニュアル「Cosminexus　システム構築ガイド」のManagementイベントによる処理の自動実行の設定に関する説明を参照してください。

(4)　CTMの稼働情報を監視する

CTMを利用しているシステムでは，CTMの稼働情報を出力できます。また，運用管理ドメイン内のCTMの稼働情報をまとめて収集，出力することもできます。

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

(5)　トランザクションの状態を確認する

起動中および停止中のJ2EEサーバのトランザクションの状態を確認することができます。稼働中のトランザクションの状態，未決着のトランザクションがあるかどうかなどを把握できます。

1.5.3　システムの処理性能を監視する

システムを構成する各種ソフトウェアの稼働状況やリクエストの処理過程で各サーバが出力したトレース情報などを監視して，システム全体の処理性能を確認できます。処理性能を監視すると，システムのボトルネックの調査や，パフォーマンスチューニングを実施する必要があるかどうかの判断ができるようになります。

Cosminexusで構築したシステムでは，リクエストの処理過程で各サーバが出力するトレース情報を，パフォーマンストレーサというプロセスを使用してトレースファイルに出力します。このトレースファイルには，クライアントから送信されたリクエストが，データベースなどのEISで処理されて，その処理結果がクライアントに返却されるまでのトレース情報が出力されます。また，セッションのライフサイクルを判断するための情報もこのファイルに出力されます。

システムの運用作業では，このトレース情報を基に，システムの処理性能やボトルネックを解析できます。なお，性能解析時には，性能解析トレースファイルを使用します。性能解析トレースファイルとは，パフォーマンストレーサが出力したバイナリ形式のファイル（PRFトレースファイル）をテキスト形式に編集したファイルです。

トレース情報の収集時には，運用管理ドメイン内のホスト上で動作している，任意のパフォーマンストレーサが出力する性能解析トレースファイルを収集します。運用管理ドメイン内のすべてのホストの性能解析トレースファイルをまとめて収集することもできます。

システムの処理性能を監視する方法については，「3.　システムの処理性能の解析」を参照してください。

1.5.4　J2EEアプリケーションを運用する

ここでは，J2EEアプリケーションを運用する作業の概要を説明します。

J2EEアプリケーションの運用方法の詳細については，「4.　J2EEアプリケーションとリソースの管理」を参照してください。

＜この項の構成＞

(1)　J2EEアプリケーションの稼働状態に応じたパフォーマンスチューニングを実行する

(2)　J2EEアプリケーションを停止する

(1)　J2EEアプリケーションの稼働状態に応じたパフォーマンスチューニングを実行する

J2EEアプリケーションに含まれるWebアプリケーションの稼働状況を監視して，必要に応じて，同時実行スレッド数を変更できます。このとき，J2EEアプリケーションを停止する必要はありません。これによって，クライアントにサービスを提供しながら，J2EEアプリケーションのパフォーマンスをチューニングできます。

(2)　J2EEアプリケーションを停止する

一日のうち特定の時間だけクライアントにサービスを提供するJ2EEアプリケーションでは，毎日決まった時間にJ2EEアプリケーションを停止して，次の日に再度開始する作業が必要です。また，24時間連続稼働させているサービスをメンテナンスする場合は，一度にすべてのJ2EEアプリケーションを停止するのではなく，一部ずつ停止させて，サービスを提供し続けられるような運用を検討する必要があります。J2EEアプリケーションを停止するとき，まず，リクエストの受け付けを停止して，すでに受け付けたリクエストについては処理を実行してからJ2EEアプリケーションを停止させる方法を，サービス閉塞といいます。日常運用の中でJ2EEアプリケーションを停止する場合，サービス閉塞を適切に実行することで，安全にサービスを停止できます。実行できるサービス閉塞の方法は，J2EEアプリケーションの構成やシステムの構成によって異なります。

1.6　システム保守の作業

Cosminexusのシステム上で動作するJ2EEアプリケーションに対して実行できる保守作業を次に示します。

J2EEアプリケーションおよびリソースの保守

システムの動作環境の設定変更

トラブルへの対処

なお，システムの運用形態や業務の変化に応じて，システムの動作環境の設定を変更する場合，システム構築時と同じ手順で設定します。システム構築の方法については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

＜この節の構成＞

1.6.1　J2EEアプリケーションとリソースを保守する

1.6.2　トラブルに対処する

1.6.1　J2EEアプリケーションとリソースを保守する

ここでは，J2EEアプリケーションとリソースを保守する作業の概要を説明します。

J2EEアプリケーションとリソースの保守の詳細については，「4.　J2EEアプリケーションとリソースの管理」を参照してください。

＜この項の構成＞

(1)　タイムアウトしたリクエストをキャンセルする

(2)　J2EEアプリケーションを強制停止する

(3)　J2EEアプリケーションを入れ替える

(4)　リソースをメンテナンスする

(1)　タイムアウトしたリクエストをキャンセルする

J2EEアプリケーションで実行しているリクエストが無限ループなどの原因によって制御できなくなった場合，リクエストを強制的にキャンセルして，リソースを解放する必要があります。あらかじめJ2EEアプリケーション内のメソッドの実行状態を監視しておくことで，予定した時間内に完了しないリクエストに対して，キャンセルを実行できます。

(2)　J2EEアプリケーションを強制停止する

日常運用でJ2EEアプリケーションを停止する場合や，トラブルが発生して即座にJ2EEアプリケーションを停止したい場合などに，J2EEアプリケーション内のリクエストが完了していないことが原因で停止処理が完了しないことがあります。この場合，J2EEアプリケーションを強制的に停止する必要があります。

J2EEアプリケーションの強制停止では，完了しないリクエストを強制的に終了させます。これによって，J2EEアプリケーションを停止できる状態にできます。

(3)　J2EEアプリケーションを入れ替える

運用中のJ2EEアプリケーションをバージョンアップしたりメンテナンスしたりする場合，J2EEアプリケーションの入れ替え作業を実施します。

J2EEアプリケーションを入れ替える場合にサービスを停止したくないときは，適切なサービス閉塞をする必要があります。CTMを利用してJ2EEサーバへのクライアントからのリクエストを制御して，システム全体を停止させないでJ2EEアプリケーションを入れ替えられます。これによって，クライアントからのリクエストを受け付けながら，オンライン状態でJ2EEアプリケーションを入れ替えられます。なお，CTMで制御できるのは，RMI-IIOP通信を使用する，Stateless Session Beanに対するリモートインタフェース呼び出しのリクエストだけです。

また，J2EEアプリケーションを入れ替える場合，新しいJ2EEアプリケーションが本番環境で問題なく動作することを確認してから入れ替えたい場合があります。Cosminexusのシステムでは，テストモードというモードを利用して，J2EEアプリケーションを本番環境でテストしてから本番運用に切り替えられます。

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

(4)　リソースをメンテナンスする

運用中に，システムで使用しているリソースをメンテナンスする場合，システムの運用状況に応じてリソースをメンテナンスします。Cosminexusのシステムでは，JavaBeansリソースやクラスタ構成のデータベースをメンテナンスする場合，リソースを入れ替えるために一時停止・再開したり，状態を確認したりできます。

1.6.2　トラブルに対処する

ここでは，トラブルに対処する作業の概要について説明します。

トラブルに対処する方法の詳細については，「5.　トラブルシューティング」を参照してください。

トラブル発生時，構成ソフトウェアでは，トラブルシュート情報としてその時点の状態をログに出力します。このログを収集・分析して，トラブルの発生要因を調査します。また，性能解析トレースを使用して，リクエストの処理状況からトラブルの発生個所を特定することもできます。

Cosminexusで構築したシステムでは，構成ソフトウェアのトラブル発生時のログと定義ファイルを一括して収集できます。この情報をsnapshotログといいます。運用管理ドメイン内の論理サーバが停止される直前，またはJ2EEサーバを手動で一括再起動する直前に，snapshotログの一括収集が自動で実行されます。

また，CTMを利用すると，J2EEサーバが異常終了した場合でも，すぐにクライアントにエラーが返却されないように設定できます。J2EEサーバが再起動されるまでの間，CTMによってJ2EEアプリケーションのスケジュールキューが閉塞制御され，すでに登録されているリクエストを保持して，さらにクライアントからのリクエストを受け付け続けます。これによって，すぐに再起動すれば，クライアントにトラブルを気づかせないで運用を続けられます。

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

1.7　システム監査の作業

Cosminexusのシステムで実行できるシステム監査の作業を次に示します。

監査ログを使用したシステムの監査

データベース監査証跡と連携した運用

＜この節の構成＞

1.7.1　監査ログを使用してシステムを監査する

1.7.2　データベース監査証跡と連携して運用する

1.7.1　監査ログを使用してシステムを監査する

ここでは，監査ログを使用してシステムを監査する作業の概要について説明します。

監査ログを使用してシステムを監査する作業の詳細については，「6.　監査ログを使用したシステムの監査」を参照してください。

監査ログとは，システム構築者や運用者がCosminexusのプログラムに対して実行した操作，およびその操作に伴うプログラムの動作の履歴が出力されるファイルです。監査者が監査ログを調査することで，「いつ」「だれが」「何をしたか」を知ることができ，システムの運用が法規制やセキュリティ評価基準，または業界ごとの各種の基準に準拠していることを証明できます。

1.7.2　データベース監査証跡と連携して運用する

ここでは，データベース監査証跡と連携した運用の作業の概要について説明します。

データベース監査証跡と連携した運用の詳細については，「7.　データベース監査証跡と連携した運用」を参照してください。

データベース監査証跡とは，データベースの監査に利用するためのデータベースの操作記録です。データベース監査証跡に関する機能はデータベースが提供しています。Cosminexusシステムでは，データベースの監査証跡機能と連携し，J2EEサーバやバッチサーバがデータベースにアクセスした際に記録されるデータベース監査証跡の情報の一部に，Cosminexusシステムが持つ情報を出力させることができます。この機能をデータベース監査証跡連携機能といいます。データベース監査証跡連携機能については，マニュアル「Cosminexus　機能解説」のデータベース監査証跡との連携に関する説明を参照してください。

データベース監査証跡と連携した運用では，データベース監査証跡，性能解析トレースおよびアプリケーションのユーザログを利用して，データベースの監査対象のテーブルにアクセスしたリクエストを特定できます。

1.8　システム運用を始める前に

ここでは，システム運用を始める前に確認，準備しておくことについて説明します。

＜この節の構成＞

1.8.1　Component Container管理者による運用に関する留意事項

1.8.2　トラブル発生時に資料を収集するための準備

1.8.3　Windows Vista使用時の注意事項

1.8.4　運用管理コマンド（mngsvrutil）を利用する場合の留意事項

1.8.5　サーバ管理コマンドを利用する場合の留意事項

1.8.6　作業ディレクトリに関する注意事項

1.8.7　RMIレジストリに関する注意事項

1.8.8　コマンド実行時に指定するWebシステム名，サービスユニット名，およびサーバ名に関する注意事項

1.8.1　Component Container管理者による運用に関する留意事項

UNIXでComponent Container管理者を設定している場合の留意事項について説明します。Component Container管理者とは，UNIXを使用している場合に，J2EEサーバ，またはバッチサーバの構築・運用に関する操作を実行できる権限を持つユーザです。Component Container管理者を設定することで，root権限を持たないユーザでも，J2EEサーバ，またはバッチサーバの起動・停止やサーバ管理コマンドの実行など，システム運用時の操作を実行できるようになります。

注意

Component Container管理者を設定している場合，Component Container管理者が実行できる操作は，一部の操作を除き，スーパーユーザでは操作できなくなるので注意してください。詳細については，マニュアル「Cosminexus　機能解説」の，J2EEサーバの運用とシステムの運用管理者に関する説明を参照してください。

なお，Component Container管理者の設定については，マニュアル「Cosminexus　システム構築ガイド」のComponent Container管理者の設定に関する説明を参照してください。

Component Container管理者が実施できるシステム運用時の操作と，Component Container管理者を設定している場合にパーミッションが変更されるディレクトリについて説明します。

＜この項の構成＞

(1)　Component Container管理者が実施できるシステム運用時の操作

(2)　Component Container管理者を設定している場合にパーミッションが変更されるディレクトリ

(1)　Component Container管理者が実施できるシステム運用時の操作

Component Container管理者を設定した場合に，スーパーユーザおよびComponent Container管理者が実施できるシステム運用時の操作を次の表に示します。

表1-18　Component Container管理者が実施できるシステム運用時の操作

操作
スーパーユーザ
Component Container管理者

J2EEサーバ，バッチサーバ，およびWebコンテナサーバの起動／停止
（cjstartsvコマンド，cjstopsvコマンド）
×
○

サーバ管理コマンドの実行
○
○

スレッドダンプの取得（cjdumpsvコマンド）
○
○

OS状態情報の取得（cjgetsysinfoコマンド）
○
○

バッチアプリケーションの実行（cjexecjobコマンド）
○
○

バッチアプリケーションの強制停止（cjkilljobコマンド）
○
○

（凡例）○：実行できます。　　×：実行できません。

なお，Component Container管理者を設定しない場合は，スーパーユーザが運用管理者となるため，Component Container管理者の操作もスーパーユーザが実施します。

参考

Component Container管理者を設定していても，運用管理コマンドの実行には影響ありません。

Management Serverのセットアップ時に設定した管理ユーザIDで，システム運用時の操作およびコマンドを実行できます。

(2)　Component Container管理者を設定している場合にパーミッションが変更されるディレクトリ

Component Container管理者を設定している場合，次に示すディレクトリ下のサブディレクトリおよびファイルの属性（所有者/グループ）が「Component Container管理者/Component Container管理者グループ」に変更されます。

/opt/Cosminexus/CC

<作業ディレクトリ>/ejb/

<作業ディレクトリ>/web/

ただし，/opt/Cosminexus/CC下の一部のファイル（/opt/Cosminexus/CC/server/bin/cjenvsetup，/opt/Cosminexus/CC/server/bin/cjgetsysinfoや，インストールログなど）の属性は変更されません。

1.8.2　トラブル発生時に資料を収集するための準備

トラブルが発生した場合に備えて，資料を収集するための準備を必要に応じてしてください。

次に示す資料を収集したい場合は，運用開始前の準備が必要です。

日立固有のJavaVMのログ
JavaVMのガーベージコレクションのログなどは，このログに出力されます。

ユーザダンプ（Windowsの場合，J2EEサーバモードの場合）

coreダンプ（UNIXの場合，J2EEサーバモードの場合）

OSの統計情報（Windowsの場合）

また，必要であれば，取得資料のサイズ，出力レベルなどを調整しておきます。

トラブルシューティングの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」のトラブルシューティングの資料取得の設定に関する説明を参照してください。

1.8.3　Windows Vista使用時の注意事項

Windows Vistaを使用する場合には，次の点に留意してください。

Cosminexusが提供するコマンドは，管理者特権で実行する必要があります。Cosminexusが提供するコマンドは，「管理者：コマンドプロンプト」で実行してください。「管理者：コマンドプロンプト」は，Windows Vistaで提供されている機能を使用して起動してください。起動方法の例を次に示します。

［スタート］ボタンをクリックします。

［プログラム］－［アクセサリ］を選択します。

［コマンド プロンプト］を右クリックして，［管理者として実行］をクリックします。

管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力するか，または確認情報を提供してください。

1.8.4　運用管理コマンド（mngsvrutil）を利用する場合の留意事項

運用管理コマンド（mngsvrutil）は，運用操作を実行するコマンドです。

mngsvrutilコマンドは，運用管理エージェントおよびManagement Serverが起動している状態で実行できるコマンドです。運用管理エージェントおよびManagement Serverを起動してから実行してください。

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

1.8.5　サーバ管理コマンドを利用する場合の留意事項

サーバ管理コマンドは，J2EEアプリケーションやリソースの設定およびカスタマイズを実行するコマンドです。

サーバ管理コマンドは，J2EEサーバが起動している状態で実行できるコマンドです。J2EEサーバおよびその前提プロセスを起動してから実行してください。

サーバ管理コマンドには，参照系コマンド，更新系コマンド，および特権系コマンドがあります。これらは，組み合わせによって，同時に実行できるものと，排他処理されるものがあります。実行時には注意してください。サーバ管理コマンドの同時実行についての制約に関しては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のサーバ管理コマンドの処理と制御に関する説明を参照してください。また，参照系コマンド，更新系コマンドおよび特権系コマンドの分類については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

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

1.8.6　作業ディレクトリに関する注意事項

作業ディレクトリとは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.public.directoryキーに指定したディレクトリです。usrconf.cfgファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

作業ディレクトリの運用では，次の点に注意してください。

Cosminexus Component Container以外のアプリケーションで，作業ディレクトリ以下のディレクトリおよびファイルを使用しないでください。J2EEサーバを起動した場合に，例外が発生することがあります。

作業ディレクトリ以下のディレクトリ構成を変更しないでください。また，ファイルを追加，または削除しないでください。

1.8.7　RMIレジストリに関する注意事項

Management Serverは，J2EEサーバの運用監視に，J2EEサーバ上で動作するRMIレジストリを使用します。そのため，Management Serverが管理しているRMIレジストリの情報と実際に動作しているJ2EEサーバのRMIレジストリの情報が一致していないと，運用監視に失敗する場合があります。Management Serverの管理しているRMIレジストリの情報は，次のタイミングで更新されます。J2EEサーバ上で動作するRMIレジストリと異ならないように注意してください。

運用管理ポータルの「Cosminexus Management Serverの設定」で構成情報の回復を実行した場合

運用管理ポータルの「論理サーバの環境設定」で「適用」ボタンを押した場合

運用管理ポータルの「論理サーバの環境設定」からサーバの設定の読み込みを実行した場合

cmx_build_model.exeコマンドを実行した場合

cmx_change_model.exeコマンドを実行した場合

運用管理ポータルの操作については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。cmx_build_model.exeコマンド，およびcmx_change_model.exeコマンドの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

1.8.8　コマンド実行時に指定するWebシステム名，サービスユニット名，およびサーバ名に関する注意事項

運用作業でコマンドを実行する際，コマンドによって次の四つの異なる名称を指定します。各名称の対応を確認するには，コマンドや簡易構築定義ファイルを使用する必要があります。

Webシステム名
Smart Composer機能のコマンドに指定します。
例：cmx_start_target -s <Webシステム名>

サービスユニット名
Smart Composer機能のコマンドに指定します。
例：cmx_start_target -s <Webシステム名> -unit <サービスユニット名>

論理サーバ名
運用管理コマンド（mngsvrutil）に指定します。
例：mngsvrutil start -t <論理サーバ名>

実サーバ名
サーバ管理コマンドに指定します。
例：cjstartsv <実サーバ名>

各名称の対応は，次の方法で確認してください。

cmx_list_modelコマンドを実行することで，次の名称の対応を確認します。

ホスト名

Webシステム名

サービスユニット名

論理サーバ名

実行例

cmx_list_model -m localhost:28080 -u admin -p admin -modeltype SERVEREX
cmx_sample-system_unit1_PRF_01,PerformanceTracer,host1,combined-tier,unit1,sample-system
cmx_sample-system_unit1_J2EE_01,J2EEServer,host1,combined-tier,unit1,sample-system
cmx_sample-system_unit1_HTTP_01,WebServer,host1,combined-tier,unit1,sample-system
cmx_sample-system_unit2_PRF_01,PerformanceTracer,host2,combined-tier,unit2,sample-system
cmx_sample-system_unit2_J2EE_01,J2EEServer,host2,combined-tier,unit2,sample-system
cmx_sample-system_unit2_HTTP_01,WebServer,host2,combined-tier,unit2,sample-system

簡易構築定義ファイルで，次の名称の対応を確認します。

論理サーバ名（logical-server-name）
論理サーバ名が定義されていない場合は，自動生成されます。

実サーバ名（realservername）
実サーバ名が定義されていない場合は，論理サーバ名と同じになります。

2.　システムの運用監視

この章では，システムの運用監視について説明します。

運用開始後のシステムで，システムの稼働状況やトランザクション情報などを適宜確認して，安定した稼働状態を保っていくための運用作業のことを，システムの運用監視といいます。運用監視は，運用管理コマンド（mngsvrutil），およびサーバ管理コマンドで実行できます。

このほか，Cosminexusで構築したシステムでは，J2EEサーバまたはSFOサーバでのリソースの使用率または使用数を基にリソース枯渇を監視して推移をログに出力したり，CTMの稼働統計情報を収集したりできます。これらの情報を監視することで，システムの安定稼働を図ります。

＜この章の構成＞

2.1　運用監視作業の概要

2.2　論理サーバのステータスの監視

2.3　稼働情報の監視（稼働情報ファイル）

2.4　稼働情報の監視（運用管理コマンド）

2.5　リソース枯渇の監視

2.6　CTMの稼働統計情報の確認

2.7　トランザクション情報の確認

2.1　運用監視作業の概要

システムの運用を開始したら，論理サーバのステータスやシステムの稼働情報を適宜確認して，安定した稼働状態を保っていくことが必要です。稼働情報に出力されたシステム性能を基に，チューニングが必要かどうかも判断する必要があります。

システムの運用監視作業について，次の表に示します。

表2-1　システムの運用監視

作業内容
手段
作業概要
参照先

論理サーバのステータス監視
運用管理コマンド（mngsvrutil）
論理サーバのステータスを確認します。論理サーバのステータスは，次の単位で確認できます。

運用管理ドメイン単位

ホスト単位

論理サーバ単位

2.2

システムの稼働監視
稼働情報収集機能※1　※2
J2EEサーバおよびSFOサーバの稼働情報を監視します。
2.3

運用管理コマンド（mngsvrutil）
J2EEサーバ，SFOサーバ，またはバッチサーバの稼働情報を監視します。
2.4

リソース枯渇監視機能※1　※3
リソース枯渇監視ログファイルを調査して，リソースの使用率や使用数を監視します。また，しきい値を超えた場合に原因を調査します。
2.5

運用管理コマンド（mngsvrutil）
運用管理ドメイン内のCTMの稼働統計情報を確認します。次の単位で確認できます。

運用管理ドメイン内のすべてのCTM

運用管理ドメイン内の指定したCTM，または指定したホスト内のCTM

2.6

トランザクション情報の確認
サーバ管理コマンド（cjlisttrn）
稼働中のJ2EEサーバでのトランザクションの状態や，停止中のJ2EEサーバでの未決着のトランザクションの有無などの情報を確認します。
2.7

注※1　システム構築時に設定した一定の間隔ごとにファイルが出力されるため，サーバ管理コマンドや運用管理コマンドなどのツールを使用して出力する必要はありません。

注※2　稼働情報ファイルに出力されるフルガーベージコレクション回数，またはURLグループ単位の実行待ちリクエスト数がしきい値を超えたときに，メッセージが出力されます（しきい値イベント）。このメッセージを利用してManagementイベントを発行し，対処をManagementアクションとして自動化できます。しきい値イベントの設定については，マニュアル「Cosminexus　システム構築ガイド」の，稼働情報ファイルの取得とイベント発行の設定に関する説明を参照してください。また，Managementイベントによる処理の自動実行の設定については，マニュアル「Cosminexus　システム構築ガイド」の，Managementイベントによる処理の自動実行の設定に関する説明を参照してください。

注※3　リソースの使用状況がしきい値を超えた場合，Managementイベントを発行できます。Managementイベントを利用すると，対処をManagementアクションとして自動化できます。Managementイベントによる処理の自動実行の設定については，マニュアル「Cosminexus　システム構築ガイド」の，Managementイベントによる処理の自動実行の設定に関する説明を参照してください。

2.2　論理サーバのステータスの監視

この節では，論理サーバの稼働状態（ステータス）の監視方法と，監視できる項目について説明します。

論理サーバとは，Management Serverの運用管理の対象になる，サーバまたはクラスタです。

論理サーバのステータスの監視には，運用管理コマンド（mngsvrutil）を使用します。

なお，cmx_list_statusコマンドを使用して，サービスユニットのステータスを監視できます。cmx_list_statusコマンドの使用方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

参考

Management Serverおよび運用管理エージェントのステータスを確認するには，次の方法があります。

運用管理コマンド（mngsvrutil）のサブコマンド「check」

adminagentcheckコマンド

運用管理コマンド，およびadminagentcheckコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

＜この節の構成＞

2.2.1　ステータスの監視方法

2.2.2　ステータス監視で確認できる項目

2.2.1　ステータスの監視方法

論理サーバのステータスは，運用管理コマンド（mngsvrutil）で監視できます。

論理サーバのステータスを監視するには，運用管理コマンド（mngsvrutil）にサブコマンド「list」を指定して実行します。これによって，論理サーバのステータス情報を標準出力に出力したり，CSV形式またはSNMP連携用形式にファイル出力したりできます。

「list」の引数に指定する値によって，ステータスを出力する対象を指定できます。

運用管理コマンドおよびそのサブコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

次に，実行形式と実行例を示します。

運用管理ドメイン内の論理サーバ名とステータス情報を出力する場合

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> list status

実行例

mngsvrutil -m mnghost -u user01 -p pw1 list status

指定した論理サーバにインポートされているJ2EEアプリケーション名とステータス情報を出力する場合

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <論理サーバ名> list appStatus

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t J2EEserver1 list appStatus

2.2.2　ステータス監視で確認できる項目

ステータス監視では，論理サーバの起動／停止状態が確認できます。ステータスは，すべての論理サーバで確認できます。

ステータスは，次の単位で確認できます。

運用管理ドメイン単位
運用管理ドメインに含まれるすべての論理サーバのステータスをまとめて確認できます。

ホスト単位
選択したホスト内のすべての論理サーバのステータスをまとめて確認できます。

論理サーバ単位
選択した論理サーバのステータスを確認できます。種類ごとに確認することも，個々の論理サーバだけを確認することもできます。

確認できるステータスの種類と意味を次に示します。

表2-2　稼働状況のステータスの種類と意味

稼働状況の
ステータス
説明

停止
初期状態および停止要求を受け付け停止処理が完了したあとの，論理サーバが停止した状態です。または，通信障害の回復後に運用管理エージェントが停止状態であることを確認できた状態です。

起動中
起動要求を受け付けてから論理サーバが稼働状態になるまでの起動処理中の状態です。

稼働中
起動要求を受け付け起動処理が完了したあとの，論理サーバが稼働している状態です。または，通信障害の回復後に運用管理エージェントが稼働状態であることを確認できた状態です。

停止中
停止要求を受け付けてから論理サーバが停止状態になるまでの停止処理中の状態です。

強制停止中
強制停止要求を受け付けてから論理サーバが停止状態になるまでの強制停止処理中の状態です。

異常停止
停止要求を受け付けていない状態で，論理サーバの停止を検出した状態です。

回復中
異常停止状態で起動要求を受け付けてから稼働状態になるまでの，論理サーバの起動処理中の状態です。

通信障害
運用管理エージェントとの通信で障害が発生し，ステータスの表示ができない状態です。

自動停止中
運用管理エージェントから論理サーバの異常通知（プロセスはあるが動作していない状態の通知）を受けて論理サーバの強制停止中の状態です。

自動再起動中
自動再起動指定ありの論理サーバで，稼働中状態に運用管理エージェントから論理サーバの停止通知を受けて自動再起動処理中の状態です。

計画停止中
計画停止要求を受け付けてから，論理Webサーバが停止状態になるまでの計画停止処理中の状態です。このステータスに遷移するのは，論理Webサーバの場合だけです。

2.3　稼働情報の監視（稼働情報ファイル）

この節では，稼働情報ファイルを使用した，J2EEサーバ，およびSFOサーバの稼働情報の監視について説明します。

稼働情報ファイルとは，J2EEサーバとSFOサーバ内の稼働情報が，定期的に出力されるファイルです。稼働情報ファイルは，J2EEサーバとSFOサーバの機能ごとに出力されます。稼働情報ファイルを参照すると，次のことができます。

J2EEサーバ・SFOサーバの稼働状態を確認する

J2EEサーバ・SFOサーバの稼働実績を統計情報として参照する

J2EEサーバ・SFOサーバの設定パラメタをチューニングするときの参考にする

なお，稼働情報ファイルに出力されるフルガーベージコレクション回数，またはURLグループ単位の実行待ちリクエスト数を監視して，しきい値を超えた場合にメッセージを出力できます（しきい値イベント）。また，出力されたメッセージを利用してManagementイベントを発行し，このアラートに対応して必要な処理を自動実行するように設定できます。Managementイベントによる処理の自動実行の設定については，マニュアル「Cosminexus　システム構築ガイド」のManagementイベントによる処理の自動実行の設定に関する説明を参照してください。

ポイント

稼働情報の監視を行う場合，通常の運用では，ここで説明している稼働情報ファイルを使用した稼働監視を行ってください。稼働情報ファイルで取得できる情報より詳細な情報を取得したい場合だけ，運用管理コマンドを使用した稼働情報の監視を行ってください。運用管理コマンドを使用した稼働情報の監視は，「2.4　稼働情報の監視（運用管理コマンド）」を参照してください。

＜この節の構成＞

2.3.1　稼働情報ファイルで収集できる情報

2.3.2　稼働情報ファイルの出力

2.3.3　稼働情報ファイルの調査

2.3.1　稼働情報ファイルで収集できる情報

稼働情報ファイルを使用すると，J2EEサーバ，およびSFOサーバの機能ごとの稼働情報を収集できます。稼働情報ファイルには，稼働情報として，サーバ性能，およびサーバリソースに関する情報が出力されます。稼働情報ファイルの対象となるJ2EEサーバとSFOサーバの機能，およびそれぞれの機能で取得できる稼働情報の種類を次に示します。

表2-3　機能ごとに取得できる稼働情報の種類

機能
機能の説明
稼働情報の種類

JavaVM
J2EEサーバ・SFOサーバが使用するJavaVM

JavaVMヒープサイズ

コピーガーベージコレクション回数

フルガーベージコレクション回数

ロードされているクラス数

稼働中のスレッド数

モニタロックのためにブロック状態であるスレッド数

プロセスリソース
J2EEサーバ・SFOサーバが使用するプロセスリソース

スレッド数

ファイルディスクリプタ数

Stateful Session Bean
J2EEサーバ上で動作するStateful Session Bean

接続セッション数

Stateless Session Bean
J2EEサーバ上で動作するStateless Session Bean

プールされたインスタンス数

プール内の使用中インスタンス数

実行待ちリクエスト数

Message-driven Bean
J2EEサーバ上で動作するMessage-driven Bean

プールされたインスタンス数

プール内の使用中インスタンス数

受け付けメッセージ数

DB Connector
J2EEサーバ上で動作するDB Connector

プールされたPreparedStatement数

プールされたCallableStatement数

PrepareStatementメソッドが呼び出された回数

PrepareCallメソッドが呼び出された回数

プール内PreparedStatementヒット回数

プール内CallableStatementヒット回数

JCAリソース
リソースアダプタが使用するJCAリソース

プールされたコネクション数

プール内の使用中コネクション数

コネクション取得待ちスレッド数

コネクション取得失敗数

トランザクションサービス
J2EEサーバで使用されるトランザクションサービス

決着済みトランザクション数

トランザクションロールバック数

Webアプリケーション
J2EEサーバ上で動作するWebアプリケーション

同時実行スレッド数

実行待ちリクエスト数

実行待ちリクエスト数の上限からあふれたリクエスト数

受け付けリクエスト数

応答済みリクエスト数

セッション数

Webコンテナ
J2EEサーバ上で動作するWebコンテナ

同時実行スレッド数

実行待ちリクエスト数

実行待ちリクエスト数の上限からあふれたリクエスト数

URLグループ
Webアプリケーションに定義されたURLグループ単位の同時実行数制御

同時実行スレッド数

実行待ちリクエスト数

実行待ちリクエスト数の上限からあふれたリクエスト数

受け付けリクエスト数

応答済みリクエスト数

注　稼働情報監視の対象がSFOサーバの場合，JavaVMとプロセスリソースの稼働情報が取得できます。

2.3.2　稼働情報ファイルの出力

ここでは，稼働統計情報ファイルの出力先，ファイル面数，面の切り替え間隔，およびファイル名について説明します。

＜この項の構成＞

(1)　稼働情報ファイルの出力先

(2)　稼働情報ファイルのファイル面数と面の切り替え間隔

(3)　稼働情報ファイルのファイル名

(1)　稼働情報ファイルの出力先

デフォルトの設定の場合，稼働統計情報ファイルは，J2EEサーバの起動時に次のフォルダに作成されます。

Windowsの場合

<作業ディレクトリ>※¥ejb¥<J2EEサーバ名>¥stats

UNIXの場合

<作業ディレクトリ>※/ejb/<J2EEサーバ名>/stats

注※　<作業ディレクトリ>は，J2EEサーバのユーザ定義（usrconf.cfgファイル中のejb.public.directory）で指定されたディレクトリを指します。デフォルト値は，Windowsの場合，「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」，UNIXの場合，「/opt/Cosminexus/CC/server/public」です。

また，稼働情報ファイルは，出力先を変更することもできます。

稼働情報ファイルの出力先の設定については，マニュアル「Cosminexus　システム構築ガイド」の稼働情報ファイル取得の設定に関する説明を参照してください。

(2)　稼働情報ファイルのファイル面数と面の切り替え間隔

稼働情報ファイルは，出力先に保存するファイルの面数とファイルの面を切り替える時間間隔を設定できます。例えば，保存するファイル面数を「7」，ファイルの面を切り替える時間間隔を「24（時間）」と設定した場合，稼働情報ファイルは1日に1回面が切り替わり，最新の1週間分（7日分）のファイルを保存できることになります。

稼働情報ファイルの面数と面を切り替える時間間隔の設定については，マニュアル「Cosminexus　システム構築ガイド」の稼働情報ファイル取得の設定に関する説明を参照してください。

(3)　稼働情報ファイルのファイル名

稼働情報ファイルのファイル名は，稼働情報を収集する機能ごとに異なります。機能ごとの稼働情報ファイルのファイル名を次の表に示します。

表2-4　稼働情報ファイルのファイル名

機能 | ファイル名
JavaVM | HJVMStats_<YYYYMMDDhhmm><TZ>.csv
プロセスリソース | HOSStats_<YYYYMMDDhhmm><TZ>.csv
Stateful Session Bean | HStatefulSessionBeanStats_<YYYYMMDDhhmm><TZ>.csv
Stateless Session Bean | HStatelessSessionBeanStats_<YYYYMMDDhhmm><TZ>.csv
Message-driven Bean | HMessageDrivenBeanStats_<YYYYMMDDhhmm><TZ>.csv
DB Connector | HDBConnectorStats_<YYYYMMDDhhmm><TZ>.csv
JCAリソース | HJCAConnectionPoolStats_<YYYYMMDDhhmm><TZ>.csv
トランザクションサービス | HJTAStats_<YYYYMMDDhhmm><TZ>.csv
Webアプリケーション | HWebModuleStats_<YYYYMMDDhhmm><TZ>.csv
Webコンテナ | HWebContainerStats_<YYYYMMDDhhmm><TZ>.csv
URLグループ | HWebURLGroupStats_<YYYYMMDDhhmm><TZ>.csv

注

<YYYYMMDDhhmm>には，ファイルが出力された時刻を表す次の値が表示されます。
YYYY：西暦年，MM：月，DD：日，hh：時，mm：分

<TZ>には，タイムゾーンが，GMT（グリニッジ標準時）からの時差で表示されます。日本の場合，「+0900」が表示されます。

2.3.3　稼働情報ファイルの調査

稼働情報ファイルを調査するためには，ヘッダファイルと組み合わせて参照する必要があります。ヘッダファイルは，稼働情報ファイルの対象となるJ2EEサーバやSFOサーバの機能と1対1の関係で出力されて，稼働情報ファイルに出力される情報に対応する項目名が出力されます。そのため，ヘッダファイルと稼働情報ファイルを対応させながら，稼働情報を調査する必要があります。

ヘッダファイルと稼働情報ファイルの対応の例を次に示します。

図2-1　ヘッダファイルと稼働情報ファイルの対応

稼働情報ファイルを調査する場合，まずファイル名に表示される日付などを参考にして，調査したい稼働情報ファイルを選択してください。次に，選択した稼働情報ファイルと，それに対応するヘッダファイルを一つのファイルに編集して，Excelなどのアプリケーションプログラムで参照してください。その場合，グラフや表などの形式に変換して参照することをお勧めします。また，時刻を表す項目をExcelなどのアプリケーションプログラムで参照する場合，セルの表示設定を，時刻を表示する形式に設定することをお勧めします。例えばExcelを使用している場合は，セルの表示形式を「時刻」に設定してください。

ヘッダファイルは，J2EEサーバの起動時に次のフォルダに作成されます。

Windowsの場合

<作業ディレクトリ>※¥ejb¥<J2EEサーバ名>¥stats

UNIXの場合

<作業ディレクトリ>※/ejb/<J2EEサーバ名>/stats

注※　<作業ディレクトリ>は，J2EEサーバのユーザ定義（usrconf.cfgファイル中のejb.public.directory）で指定されたディレクトリを指します。デフォルト値は，Windowsの場合，「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」，UNIXの場合，「/opt/Cosminexus/CC/server/public」です。

稼働情報ファイルとヘッダファイルは，すべての稼働情報ファイルに共通の項目と，個別の項目で構成されます。個別の項目は，対象となる機能ごとに異なります。ヘッダファイルの構成は，次のようになります。

すべての稼働情報ファイルに共通の項目の見方を次の表に示します。

表2-5　すべての稼働情報ファイルに共通の項目の見方

項目（ヘッダファイルに出力される文字列）
説明

Date※
稼働情報ファイルを収集した時刻が，「YYYY/MM/DD hh:mm:ss.nnn」で表示されます。
YYYY：西暦年，MM：月，DD：日，hh：時，mm：分，ss：秒，nnn：ミリ秒

ObjectName
稼働情報ファイルごとに同じ形式の情報が表示されます。

StatsPath
稼働情報ファイルごとに固有の情報が出力されます。

＜稼働情報の種類を表す文字列＞.StartTime※
稼働情報の種類ごとに，稼働情報の収集対象が稼働中になった時刻が表示されます。時刻は，1970年1月1日午前0時から経過した時間がミリ秒単位で表示されます。

注※　ヘッダファイルにはこの情報に加えて，タイムゾーンがGMT（グリニッジ標準時）からの時差で表示されます。

例（日本の場合）：「Date(+0900)」，「HeapSize.StartTime(+0900)」

ただし，リロードによるJ2EEアプリケーションの入れ替えを実行した場合，リロードを実行した時刻が表示されます。

なお，「ObjectName」には，稼働情報ファイルごとに次の形式で情報が出力されます。

表2-6　ObjectNameの形式

稼働情報ファイル（ファイル名） | ObjectNameの形式
JavaVM（HJVMStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:J2EEServer=<J2EEサーバ名>,j2eeType=JVM,name=jvm
プロセスリソース（HOSStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:J2EEServer=<J2EEサーバ名>,j2eeType=OSResource,name=os
Stateful Session Bean（HStatefulSessionBeanStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:EJBModule=<EJBアプリケーション表示名>,J2EEApplication=<J2EEアプリケーション表示名>,J2EEServer=<J2EEサーバ名>,j2eeType=StatefulSessionBean,mode=<アプリケーションの動作モード>※1,name=<Stateful Session Bean名>
Stateless Session Bean（HStatelessSessionBeanStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:EJBModule=<EJBアプリケーション表示名>,J2EEApplication=<J2EEアプリケーション表示名>,J2EEServer=<J2EEサーバ名>,j2eeType=StatelessSessionBean,mode=<アプリケーションの動作モード>※1,name=<Stateless Session Bean名>
Message-driven Bean（HMessageDrivenBeanStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:EJBModule=<EJBアプリケーション表示名>,J2EEApplication=<J2EEアプリケーション表示名>,J2EEServer=<J2EEサーバ名>,j2eeType=MessageDrivenBean,mode=<アプリケーションの動作モード>※1,name=<Message-driven Bean名>
DB Connector（HDBConnectorStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:J2EEApplication=<J2EEアプリケーション表示名>※2,J2EEServer=<J2EEサーバ名>,ResourceAdapterModule=<リソースアダプタ表示名>,j2eeType=ResourceAdapter,mode=<アプリケーションの動作モード>※1,raType=<リソースアダプタの種別>※3,name=<リソースアダプタ表示名>
JCAリソース（HJCAConnectionPoolStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:J2EEServer=<J2EEサーバ名>,ResourceAdapter=<リソースアダプタ表示名>,j2eeType=JCAResource,mode=<アプリケーションの動作モード>※1,raType=<リソースアダプタの種別>※3,app=<J2EEアプリケーションの表示名>※4,name=<リソースアダプタ表示名>
トランザクションサービス（HJTAStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:J2EEServer=<J2EEサーバ名>,j2eeType=JTAResource,name=JTAResource
Webアプリケーション（HWebModuleStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:J2EEApplication=<J2EEアプリケーション表示名>,J2EEServer=<J2EEサーバ名>,j2eeType=WebModule,mode=<アプリケーションの動作モード>※1,name=<Webアプリケーション表示名>
Webコンテナ（HWebContainerStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:J2EEServer=<J2EEサーバ名>,j2eeType=WebContainer,name=WebContainer
URLグループ（HWebURLGroupStats_<YYYYMMDDhhmm><TZ>.csv） | com.cosminexus.management.j2ee:J2EEApplication=<J2EEアプリケーション表示名>,J2EEServer=<J2EEサーバ名>,WebModule=<Webアプリケーション名>,j2eeType=WebURLGroup,mode=<アプリケーションの動作モード>※1,name=<URLグループ単位の同時実行スレッド数制御の定義名>

注※1　<アプリケーションの動作モード>には，次の値が出力されます

test：アプリケーションの動作モードがテストモードの場合

normal：アプリケーションの動作モードが通常モードの場合

注※2　<J2EEアプリケーション表示名>は，リソースアダプタがJ2EEアプリケーションに含まれてデプロイされている場合にだけ出力されます。直接J2EEサーバにデプロイされたリソースアダプタの場合は，「null」が出力されます。

注※3　「raType=<リソースアダプタの種別>」は，ルートリソースアダプタ，またはメンバリソースアダプタを使用している場合にだけ，次の形式で出力されます。

RootResourceAdapter：ルートリソースアダプタの場合

MemberResourceAdapter：メンバリソースアダプタの場合

注※4　「app=<J2EEアプリケーションの表示名>」は，リソースアダプタがJ2EEアプリケーションに含まれてデプロイされている場合にだけ出力されます。

次に，それぞれの稼働情報ファイル個別の項目の見方について説明します。個別の項目は，ヘッダファイルに次の形式で表示されます。

＜稼働情報の種類を表す文字列＞.＜項目名＞

各項目は稼働情報の種類を表す文字列のあとに，「.」で区切られて出力されます。稼働情報の種類を表す文字列，および項目名について次の表に示します。

表2-7　稼働情報の種類を表す文字列

稼働情報の種類 | 稼働情報の種類を表す文字列
JavaVMヒープサイズ | HeapSize
コピーガーベージコレクション回数 | CopyGCCount
フルガーベージコレクション回数 | FullGCCount
ロードされているクラス数 | LoadedClassCount
モニタロックのためにブロック状態であるスレッド数 | ThreadBlockedCount
スレッド数 | ThreadCount
ファイルディスクリプタ数 | FileDescriptorCount
接続セッション数 | ActiveSessionCount
プールされたインスタンス数 | PooledInstanceCount
プール内の使用中インスタンス数 | ActivePooledInstanceCount
受け付けメッセージ数 | MessageCount
実行待ちリクエスト数 | WaitingRequestCount
プールされたPreparedStatement数 | PooledPreparedStatementCount
プールされたCallableStatement数 | PooledCallableStatementCount
PrepareStatementメソッドが呼び出された回数 | InvokedPrepareStatementMethodCount
prepareCallメソッドが呼び出された回数 | InvokedPrepareCallMethodCount
プール内PreparedStatementヒット回数 | PooledPreparedStatementHitCount
プール内CallableStatementヒット回数 | PooledCallableStatementHitCount
プールされたコネクション数 | PoolSize
プール内の使用中コネクション数 | ActivePoolSize
コネクション取得待ちスレッド数 | WaitingThreadCount
コネクション取得失敗数 | FailedRequestCount
決着済みトランザクション数 | CompletionCount
トランザクションロールバック数 | RolledbackCount
応答済みリクエスト数 | ResponseCount
同時実行スレッド数 | ActiveThreadCount
実行待ちリクエスト数の上限からあふれたリクエスト数 | OverflowRequestCount
受け付けリクエスト数 | RequestCount
セッション数 | SessionCount

表2-8　稼働統計情報ファイルの項目名

項目名（ヘッダファイルに出力される文字列） | 説明
Count | 前回の稼働情報ファイルの出力時からの累積回数，または累積個数
HighWaterMark | 前回の稼働情報ファイルの出力時からの最大値
LowWaterMark | 前回の稼働情報ファイルの出力時からの最小値
Current | 現在値
UpperBound | 上限値
LowerBound | 下限値

次に，個別に出力される項目について，稼働情報ファイルごとに説明します。

＜この項の構成＞

(1)　JavaVMの稼働情報ファイルに出力される情報

(2)　プロセスリソースの稼働情報ファイルに出力される情報

(3)　Stateful Session Beanの稼働情報ファイルに出力される情報

(4)　Stateless Session Beanの稼働情報ファイルに出力される情報

(5)　Message-driven Beanの稼働情報ファイルに出力される情報

(6)　DB Connectorの稼働情報ファイルに出力される情報

(7)　JCAリソースの稼働情報ファイルに出力される情報

(8)　トランザクションサービスの稼働情報ファイルに出力される情報

(9)　Webアプリケーションの稼働情報ファイルに出力される情報

(10)　Webコンテナの稼働情報ファイルに出力される情報

(11)　URLグループの稼働情報ファイルに出力される情報

(1)　JavaVMの稼働情報ファイルに出力される情報

JavaVMの稼働情報ファイルに出力される情報について説明します。JavaVMの稼働情報ファイルでは，J2EEサーバが使用するJavaVMの稼働情報を調査することができます。

稼働情報ファイル名

HJVMStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HJVMStats.txt

出力される稼働情報

JavaVMの稼働情報ファイルに出力される内容を次に示します。

表2-9　JavaVMの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列）
JavaVMヒープサイズ | HeapSize.UpperBound
HeapSize.LowerBound
HeapSize.HighWaterMark
HeapSize.LowWaterMark
HeapSize.Current
コピーガーベージコレクション回数 | CopyGCCount.Count
フルガーベージコレクション回数 | FullGCCount.Count
ロードされているクラス数 | LoadedClassCount.HighWaterMark
LoadedClassCount.LowWaterMark
LoadedClassCount.Current
稼働中のスレッド数 | ThreadCount.HighWaterMark
ThreadCount.LowWaterMark
ThreadCount.Current
モニタロックのためにブロック状態であるスレッド数 | ThreadBlockedCount.HighWaterMark
ThreadBlockedCount.LowWaterMark
ThreadBlockedCount.Current

(2)　プロセスリソースの稼働情報ファイルに出力される情報

プロセスリソースの稼働情報ファイルに出力される情報について説明します。プロセスリソースの稼働情報ファイルでは，J2EEサーバプロセスが使用するOSリソースの稼働情報を調査することができます。

稼働情報ファイル名

HOSStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HOSStats.txt

出力される稼働情報

プロセスリソースの稼働情報ファイルに出力される内容を次に示します。

表2-10　プロセスリソースの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列）
J2EEサーバプロセスが生成したスレッド数 | ThreadCount.UpperBound※1
ThreadCount.LowerBound※2
ThreadCount.HighWaterMark※2
ThreadCount.LowWaterMark※2
ThreadCount.Current※2
J2EEサーバプロセスが使用するファイルディスクリプタ数 | FileDescriptorCount.UpperBound※3
FileDescriptorCount.LowerBound※3
FileDescriptorCount.HighWaterMark※4
FileDescriptorCount.LowWaterMark※4
FileDescriptorCount.Current※4

注※1　Windows，Linux，またはSolarisの場合は無効になり，「-1」が出力されます。

注※2　Linuxの場合は無効になり，「-1」が出力されます。

注※3　Windowsの場合は無効になり，「-1」が出力されます。

注※4　Windows，またはAIXの場合は無効になり，「-1」が出力されます。

(3)　Stateful Session Beanの稼働情報ファイルに出力される情報

Stateful Session Beanの稼働情報ファイルに出力される情報について説明します。Stateful Session Beanの稼働情報ファイルでは，Stateful Session Beanの稼働情報を調査することができます。

稼働情報ファイル名

HStatefulSessionBeanStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HStatefulSessionBeanStats.txt

出力される稼働情報

Stateful Session Beanの稼働情報ファイルに出力される内容を次に示します。

表2-11　 Stateful Session Beanの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列） | 備考
接続中のセッション数 | ActiveSessionCount.UpperBound | Stateful Session Beanのアクティブ・セッションの最大数が無制限のとき，「0」が出力されます。
ActiveSessionCount.LowerBound | 下限値を設定できないため，無効になり「-1」が出力されます。
ActiveSessionCount.HighWaterMark | －
ActiveSessionCount.LowWaterMark | －
ActiveSessionCount.Current | －

（凡例）　－：該当なし

(4)　Stateless Session Beanの稼働情報ファイルに出力される情報

Stateless Session Beanの稼働情報ファイルに出力される情報について説明します。Stateless Session Beanの稼働情報ファイルでは，Stateless Session Beanの稼働情報を調査することができます。

稼働情報ファイル名

HStatelessSessionBeanStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HStatelessSessionBeanStats.txt

出力される稼働情報

Stateless Session Beanの稼働情報ファイルに出力される内容を次に示します。

表2-12　Stateless Session Beanの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列） | 備考
プールされたインスタンス数 | PooledInstanceCount.UpperBound | Stateless Session Beanのプール内インスタンスの最大数が無制限のとき，「0」が出力されます。
PooledInstanceCount.LowerBound | －
PooledInstanceCount.HighWaterMark | －
PooledInstanceCount.LowWaterMark | －
PooledInstanceCount.Current | －
プール内の使用中インスタンス数 | ActivePooledInstanceCount.UpperBound | Stateless Session Beanのプール内インスタンスの最大数が無制限のとき，「0」が出力されます。
ActivePooledInstanceCount.LowerBound | 下限値を設定できないため，無効になり「-1」が出力されます。
ActivePooledInstanceCount.HighWaterMark | －
ActivePooledInstanceCount.LowWaterMark | －
ActivePooledInstanceCount.Current | －
実行待ちリクエスト数 | WaitingRequestCount.HighWaterMark | －
WaitingRequestCount.LowWaterMark | －
WaitingRequestCount.Current | －

（凡例）　－：該当なし

(5)　Message-driven Beanの稼働情報ファイルに出力される情報

Message-driven Beanの稼働情報ファイルに出力される情報について説明します。Message-driven Beanの稼働情報ファイルでは，Message-driven Beanの稼働情報を調査することができます。

稼働情報ファイル名

HMessageDrivenBeanStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HMessageDrivenBeanStats.txt

出力される稼働情報

Message-driven Beanの稼働情報ファイルに出力される内容を次に示します。

表2-13　Message-driven Beanの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列） | 備考
プールされたインスタンス数 | PooledInstanceCount.UpperBound | Message-driven Beanのプール内インスタンスの最大数が無制限のとき，「0」が出力されます。
PooledInstanceCount.LowerBound | －
PooledInstanceCount.HighWaterMark | －
PooledInstanceCount.LowWaterMark | －
PooledInstanceCount.Current | －
プール内の使用中インスタンス数 | ActivePooledInstanceCount.UpperBound | Message-driven Beanのプール内インスタンスの最大数が無制限のとき，「0」が出力されます。
ActivePooledInstanceCount.LowerBound | 下限値を設定できないため，無効になり「-1」が出力されます。
ActivePooledInstanceCount.HighWaterMark | －
ActivePooledInstanceCount.LowWaterMark | －
ActivePooledInstanceCount.Current | －
受け付けメッセージ数 | MessageCount.Count | －

（凡例）　－：該当なし

(6)　DB Connectorの稼働情報ファイルに出力される情報

DB Connectorの稼働情報ファイルに出力される情報について説明します。DB Connectorの稼働情報ファイルでは，DB Connectorの稼働情報を調査することができます。

ただし，コネクションプーリング機能を使用していない場合，prepareStatementメソッドが呼び出された回数（InvokedPrepareStatementMethodCount.Count），およびPrepareCallメソッドが呼び出された回数（InvokedPrepareCallMethodCount.Count）以外の値は無効になり，「-1」が出力されます。

稼働情報ファイル名

HDBConnectorStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HDBConnectorStats.txt

出力される稼働情報

DB Connectorの稼働情報ファイルに出力される内容を次に示します。

表2-14　DB Connectorの稼働情報ファイルの出力内容

稼働情報の種類
項目（ヘッダファイルに出力される文字列）
備考

ステートメントプーリング機能によってキャッシュされたPreparedStatement数
PooledPreparedStatementCount.UpperBound※1
次の値が出力されます。

「出力値＝DB Connectorに設定したコネクションごとのPreparedStatementサイズ×コネクションプールの上限値」

コネクションプールの上限値を無制限にしたときは，無効になり「-1」が出力されます。

PooledPreparedStatementCount.LowerBound
下限値を設定できないため，無効になり「-1」が出力されます。

PooledPreparedStatementCount.HighWaterMark※1 ※2
－

PooledPreparedStatementCount.LowWaterMark※1 ※2
－

PooledPreparedStatementCount.Current※1 ※2
－

ステートメントプーリング機能によってキャッシュされたCallableStatement数
PooledCallableStatementCount.UpperBound※3
次の値が出力されます。

「出力値＝DB Connectorに設定したコネクションごとのPooledCallableStatementサイズ×コネクションプールの上限値」

コネクションプールの上限値を無制限にしたときは，無効になり「-1」が出力されます。

PooledCallableStatementCount.LowerBound
下限値を設定できないため，無効になり「-1」が出力されます。

PooledCallableStatementCount.HighWaterMark※2 ※3
－

PooledCallableStatementCount.LowWaterMark※2 ※3
－

PooledCallableStatementCount.Current※2 ※3
－

PrepareStatementメソッドが呼び出された回数
InvokedPrepareStatementMethodCount.Count※2
－

PrepareCallメソッドが呼び出された回数
InvokedPrepareCallMethodCount.Count※2
－

ステートメントプーリング機能によってキャッシュされたPreparedStatementがヒットした回数
PooledPreparedStatementHitCount.Count※1 ※2
－

ステートメントプーリング機能によってキャッシュされたCallableStatementがヒットした回数
PooledCallableStatementHitCount.Count※2 ※3
－

（凡例）　－：該当なし

注※1　DB Connectorの設定であるコネクションごとのPreparedStatementのプールサイズに「0」を設定した場合，PreparedStatementがプールされなくなるため，無効になり「-1」が出力されます。

注※2　接続先データベースにOracleを使用している場合，または接続先データベースにHiRDB以外を使用してコネクションの障害検知を行った場合，ステートメントオブジェクトを作成していなくても，1以上の値が出力されます。

注※3　 DB Connectorの設定であるコネクションごとのCallableStatementのプールサイズに0を設定した場合，CallableStatementがプールされなくなるため，無効になり「-1」が出力されます。

(7)　JCAリソースの稼働情報ファイルに出力される情報

JCAリソースの稼働情報ファイルに出力される情報について説明します。JCAリソースの稼働情報ファイルでは，JCAリソースの稼働情報を調査することができます。ただし，コネクションプールが無効の場合，またはルートリソースアダプタの場合，コネクション取得失敗数だけが出力されます。メンバリソースアダプタの場合，単体のリソースアダプタと同じ稼働情報が出力されます。DB Connector for Cosminexus RMを使用している場合，稼働情報はCosminexus RM側に出力されます。DB Connector for Cosminexus RM側には出力されません。

Connector 1.5仕様に準拠したリソースアダプタを使用した場合は，一つ目のコネクション定義（ra.xml内でいちばん先頭の定義）に対応する稼働情報が出力されます。Outboundのコネクション定義がない場合は，HJCAConnectionPoolStatsの稼働情報は出力されません。

稼働情報ファイル名

HJCAConnectionPoolStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HJCAConnectionPoolStats.txt

出力される稼働情報

JCAリソースの稼働情報ファイルに出力される内容を次に示します。

表2-15　JCAリソースの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列） | 備考
プールされたコネクション数 | PoolSize.UpperBound | －
PoolSize.LowerBound | －
PoolSize.HighWaterMark | －
PoolSize.LowWaterMark | －
PoolSize.Current | －
プール内の使用中コネクション数 | ActivePoolSize.UpperBound | －
ActivePoolSize.LowerBound | 下限値を設定できないため，無効になり「-1」が出力されます。
ActivePoolSize.HighWaterMark | －
ActivePoolSize.LowWaterMark | －
ActivePoolSize.Current | －
コネクション取得待ちスレッド数 | WaitingThreadCount.UpperBound | 上限値を設定できないため，無効になり「-1」が出力されます。
WaitingThreadCount.LowerBound | 下限値を設定できないため，無効になり「-1」が出力されます。
WaitingThreadCount.HighWaterMark | －
WaitingThreadCount.LowWaterMark | －
WaitingThreadCount.Current | －
コネクション取得失敗数 | FailedRequestCount.Count | DB Connector for Cosminexus RMを使用している場合，Cosminexus RM側に出力されます。DB Connector for Cosminexus RM側には常に「0」が出力されます。

（凡例）　－：該当なし

(8)　トランザクションサービスの稼働情報ファイルに出力される情報

トランザクションサービスの稼働情報ファイルに出力される情報について説明します。トランザクションサービスの稼働情報ファイルでは，トランザクションサービスの稼働情報を調査することができます。

稼働情報ファイル名

HJTAStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HJTAStats.txt

出力される稼働情報

トランザクションサービスの稼働情報ファイルに出力される内容を次に示します。

表2-16　トランザクションサービスの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列）
決着したトランザクション数 | CompletionCount.Count
ロールバックしたトランザクション数 | RolledbackCount.Count

(9)　Webアプリケーションの稼働情報ファイルに出力される情報

Webアプリケーションの稼働情報ファイルに出力される情報について説明します。Webアプリケーションの稼働情報ファイルでは，対象のWebアプリケーション全体の稼働情報を調査することができます。

稼働情報ファイル名

HWebModuleStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HWebModuleStats.txt

出力される稼働情報

Webアプリケーションの稼働情報ファイルに出力される内容を次に示します。

表2-17　Webアプリケーションの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列） | 備考
最大同時実行スレッド数 | ActiveThreadCount.UpperBound※1　※2 | －
ActiveThreadCount.LowerBound※3 | －
ActiveThreadCount.HighWaterMark※1 | －
ActiveThreadCount.LowWaterMark※1 | －
ActiveThreadCount.Current※1 | －
実行待ちリクエスト数 | WaitingRequestCount.UpperBound※1　※2　※4 | －
WaitingRequestCount.LowerBound※3　※4 | －
WaitingRequestCount.HighWaterMark※1　※4 | －
WaitingRequestCount.LowWaterMark※1　※4 | －
WaitingRequestCount.Current※1　※4 | －
実行待ちリクエスト数の上限からあふれたリクエスト数 | OverflowRequestCount.Count※1 | －
受け付けリクエスト数 | RequestCount.Count※4 | Webコンテナが受け付けたWebアプリケーション単位のリクエスト数が出力されます。実行待ちリクエスト数もカウントされます。Webサーバでは受信されていても，Webコンテナに転送されていないリクエスト数はカウントされません。
応答済みリクエスト数 | ResponseCount.Count | －
セッション数 | SessionCount.UpperBound | セッション数の上限を設定していない場合，無効になり「-1」が出力されます。
SessionCount.LowerBound※3 | －
SessionCount.HighWaterMark | －
SessionCount.LowWaterMark | －
SessionCount.Current | －

（凡例）　－：該当なし

注※1　Webアプリケーション単位の同時実行数制御機能を使用していない場合，または対象となるWebアプリケーションに，同時実行数制御機能を使用していない場合，無効になり，「-1」が出力されます。

注※2　対象となるWebアプリケーションに最大同時実行スレッド数制御が設定されている場合，Webアプリケーション単位の最大同時実行スレッド数が出力されます。最大同時実行スレッド数を動的に変更した場合，変更後の値が出力されます。

注※3　無効になり「-1」が出力されます。

注※4　リロード機能による入れ替え処理中の場合，Webアプリケーションが受け付けた実行待ちリクエスト数はカウントされません。リロード処理の完了後にカウントされます。

(10)　Webコンテナの稼働情報ファイルに出力される情報

Webコンテナの稼働情報ファイルに出力される情報について説明します。Webコンテナの稼働情報ファイルでは，開始しているWebアプリケーションの稼働情報を調査することができます。

稼働情報ファイル名

HWebContainerStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HWebContainerStats.txt

出力される稼働情報

Webコンテナの稼働情報ファイルに出力される内容を次に示します。

表2-18　Webコンテナの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列）
最大同時実行スレッド数 | ActiveThreadCount.UpperBound※1
ActiveThreadCount.LowerBound※1 ※2
ActiveThreadCount.HighWaterMark※1
ActiveThreadCount.LowWaterMark※1
ActiveThreadCount.Current※1
実行待ちリクエスト数 | WaitingRequestCount.UpperBound※3
WaitingRequestCount.LowerBound※2 ※3
WaitingRequestCount.HighWaterMark※4
WaitingRequestCount.LowWaterMark※4
WaitingRequestCount.Current※4
実行待ちリクエスト数の上限からあふれたリクエスト数 | OverflowRequestCount.Count※3

注※1　Webアプリケーション単位の最大同時実行スレッド数制御を無効に設定している場合，J2EEアプリケーションのリロード中に実行待ちになった新しいリクエストは，稼働中のスレッドとしてカウントされます。

注※2　無効になり「-1」が出力されます。

注※3　Webアプリケーション単位の最大同時実行スレッド数制御を設定していない場合，無効になり「-1」が出力されます。Webアプリケーション単位の最大同時実行スレッド数制御を設定している場合，デフォルトの実行待ちキューの情報が出力されます。

注※4　Webアプリケーション単位の最大同時実行スレッド数制御を設定していない場合，Webコンテナ単位の実行待ちキューの情報が出力されます。Webアプリケーション単位の最大同時実行スレッド数制御を設定している場合，デフォルトの実行待ちキューの情報が出力されます。

(11)　URLグループの稼働情報ファイルに出力される情報

URLグループの稼働情報ファイルに出力される情報について説明します。URLグループの稼働情報ファイルでは，URLグループの稼働情報を調査することができます。

稼働情報ファイル名

HWebURLGroupStats_<YYYYMMDDhhmm><TZ>.csv

対応するヘッダファイル名

HWebURLGroupStats.txt

出力される稼働情報

URLグループの稼働情報ファイルに出力される内容を次に示します。

表2-19　URLグループの稼働情報ファイルの出力内容

稼働情報の種類 | 項目（ヘッダファイルに出力される文字列）
最大同時実行スレッド数 | ActiveThreadCount.UpperBound※1
ActiveThreadCount.LowerBound※2
ActiveThreadCount.HighWaterMark
ActiveThreadCount.LowWaterMark
ActiveThreadCount.Current
実行待ちリクエスト数 | WaitingRequestCount.UpperBound※3
WaitingRequestCount.LowerBound※2 ※3
WaitingRequestCount.HighWaterMark※3
WaitingRequestCount.LowWaterMark※3
WaitingRequestCount.Current※3
実行待ちリクエスト数の上限からあふれたリクエスト数 | OverflowRequestCount.Count
受け付けリクエスト数 | RequestCount.Count※4
応答済みリクエスト数 | ResponseCount.Count

注※1　Webアプリケーション単位の最大同時実行スレッド数を動的に変更した場合，設定値ではなく変更後の情報が出力されます。

注※2　無効になり「-1」が出力されます。

注※3　リロード機能による入れ替え処理中の場合，Webアプリケーションが受け付けた実行待ちリクエスト数はカウントされません。リロード処理の完了後にカウントされます。

注※4　Webコンテナが受け付けたURL単位のリクエスト数が出力されます。実行待ちリクエスト数もカウントされます。Webサーバでは受信されていても，Webコンテナに転送されていないリクエスト数はカウントされません。

2.4　稼働情報の監視（運用管理コマンド）

この節では，J2EEサーバ，SFOサーバ，またはバッチサーバの稼働情報の監視方法と，監視できる項目について説明します。

ポイント

稼働情報の監視を行う場合，通常の運用では，稼働情報ファイルを使用した稼働監視を行ってください。稼働情報ファイルで取得できる情報より詳細な情報を取得したい場合だけ，運用管理コマンドを使用した稼働情報の監視を行ってください。稼働情報ファイルを使用した稼働情報の監視は，「2.3　稼働情報の監視（稼働情報ファイル）」を参照してください。

＜この節の構成＞

2.4.1　サーバの稼働情報の監視方法（J2EEサーバ，SFOサーバ，バッチサーバ）

2.4.2　稼働情報監視で確認できる項目

2.4.1　サーバの稼働情報の監視方法（J2EEサーバ，SFOサーバ，バッチサーバ）

J2EEサーバ，SFOサーバ，またはバッチサーバの稼働情報は，運用管理コマンド（mngsvrutil）で監視できます。

稼働情報を監視するには，運用管理コマンド（mngsvrutil）にサブコマンド「get」を指定して実行します。これによって，J2EEサーバまたはSFOサーバの稼働情報を標準出力に出力したり，CSV形式またはSNMP連携用形式のファイルに出力したりできます。

「get」の引数に稼働情報を出力する対象を指定できます。

J2EEサーバの稼働情報を取得する場合の実行形式と実行例を次に示します。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <J2EEサーバ名> get <ドメイン名または取得するカテゴリ>

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t J2EEServer1 get j2eeContainer

mngsvrutilコマンド，そのサブコマンド，および取得できる情報の詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

2.4.2　稼働情報監視で確認できる項目

稼働情報監視では，J2EEサーバ，バッチサーバおよびSFOサーバの稼働状況が確認できます。

稼働情報として監視できる項目を次の表に示します。

表2-20　稼働情報監視で表示できる項目（J2EEサーバの場合）

監視の対象
監視できる項目

J2EEサーバ
J2EEコンテナ

J2EEサーバ名

Naming Serviceホスト

Naming Serviceポート番号

コンテナ起動時刻

EJBコンテナ

コンテナ名

Webコンテナ
基本情報

コンテナ名

Webコンテナ起動時刻

管理用サーバのポート番号

Webサーバとの通信に使用するポート番号

Webサーバとの通信ソケットのバックログ設定上限値

稼働中（リクエスト処理の実行中）スレッド数設定上限値

インプロセスHTTPサーバのポート番号

インプロセスHTTPサーバとの通信ソケットのバックログ設定上限値

インプロセスHTTPサーバのリクエスト処理用スレッド数の上限値

インプロセスHTTPサーバのリクエスト処理用スレッド数の下限値

インプロセスHTTPサーバの稼働スレッド数の上限値

インプロセスHTTPサーバのプーリングスレッド数

インプロセスHTTPサーバのコネクション数の上限値

インプロセスHTTPサーバのPersistentコネクション数の上限値

インプロセスHTTPサーバのPersistentコネクション切断時のリクエスト処理総数の上限値

インプロセスHTTPサーバのPersistentコネクションリクエスト待ち時間の上限値

最大同時実行スレッド数

実行待ちキューサイズ

稼働情報

WebサーバとWebコンテナとのコネクション数

稼働中スレッド数（HTTPサーバコネクタ）

実行待ちしているリクエスト数

インプロセスHTTPサーバのリクエスト処理用スレッド数

インプロセスHTTPサーバの稼働中スレッド数

インプロセスHTTPサーバのプーリングスレッド数

インプロセスHTTPサーバのコネクション数

インプロセスHTTPサーバのPersistentコネクション数

インプロセスHTTPサーバのPersistentコネクション切断時のリクエスト処理総数

インプロセスHTTPサーバのPersistentコネクションリクエスト待ち時間

インプロセスHTTPサーバの実行待ちしているリクエスト数

インプロセスHTTPサーバのアクセスを拒否されたリクエスト数

同時実行可能スレッド数上限値

稼働スレッド数

実行待ちリクエスト数

実行待ちキューからあふれたリクエスト数

稼働中スレッド数（HTTPサーバ）

JavaVM
基本情報

JavaVM名

JavaVMバージョン

JavaVMの最大メモリ使用量

稼働情報

JavaVMの空きメモリ量

JavaVMの総メモリ容量

アプリケーション
J2EEアプリケーション

アプリケーション名（display name）

説明

デプロイされた時刻

EJBアプリケーション

EJB-JAR名

説明

Enterprise Bean（Stateful Session Bean）
基本情報

Enterprise Bean名

説明

Bean名（内部識別用）

Homeインタフェース名

Local Homeインタフェース名

Componentインタフェース名

Local Componentインタフェース名

EJBクラス名

トランザクションタイプ

同時接続最大値

同時実行最大値

非活性セッションのタイムアウト

実行中セッションのタイムアウト

稼働情報

現在の接続セッション数

実行中のセッション数

非活性セッション数

接続待ちセッション数

Homeインタフェース

Homeインタフェース名

レスポンス

EJBメソッド実行時間

Local Homeインタフェース

Homeインタフェース名

レスポンス

EJBメソッド実行時間

Componentインタフェース

Componentインタフェース名

レスポンス

EJBメソッド実行時間

Local Componentインタフェース

Componentインタフェース名

レスポンス

EJBメソッド実行時間

Enterprise Bean（Stateless Session Bean）
基本情報

Enterprise Bean名

説明

Bean名（内部識別用）

Homeインタフェース名

Local Homeインタフェース名

Componentインタフェース名

Local Componentインタフェース名

EJBクラス名

トランザクションタイプ

Beanインスタンスプール

稼働情報

接続待ちセッション数

Beanインスタンスプール現在値

使用中のSession Bean数

未使用のSession Bean数

Homeインタフェース
Stateful Session Beanと同じ
Local Homeインタフェース
Stateful Session Beanと同じ
Componentインタフェース
Stateful Session Beanと同じ
Local Componentインタフェース
Stateful Session Beanと同じ

Enterprise Bean（Entity Bean）
基本情報

Enterprise Bean名

説明

Bean名（内部識別用）

Homeインタフェース名

Local Homeインタフェース名

Componentインタフェース名

Local Componentインタフェース名

EJBクラス名

EntityBeanの永続化タイプ

EntityBeanのキャッシュモデル

同時接続最大値

Beanインスタンスプール

接続タイムアウト

稼働情報

現在の接続セッション数

接続待ちセッション数

Beanインスタンスプール現在値

使用中のEntity Bean数

未使用のEntity Bean数

Homeインタフェース
Stateful Session Beanと同じ
Local Homeインタフェース
Stateful Session Beanと同じ
Componentインタフェース
Stateful Session Beanと同じ
Local Componentインタフェース
Stateful Session Beanと同じ

Enterprise Bean（Message-driven Bean）
基本情報

Enterprise Bean名

説明

Bean名（内部識別用）

EJBクラス名

トランザクションタイプ

デスティネーションタイプ※1

Beanインスタンスプール

稼働情報

現在の接続セッション数

Beanインスタンスプール現在値

EJBメソッド実行時間

Webアプリケーション
基本情報

コンテキストルート

占有スレッド数

最大同時実行スレッド数

実行待ちキューサイズ

稼働情報

有効なセッション数

同時実行可能スレッド数上限値

稼働スレッド数

実行待ちリクエスト数

実行待ちキューからあふれたリクエスト数

サーブレット

サーブレット名

サーブレットの実装クラス名

サーブレット実行回数

サーブレット失敗回数

サーブレット実行時間

出力データサイズ

URL

URL

URL呼び出し回数

URL呼び出し失敗回数

URL実行時間

出力データサイズ

リソース
データソース（SimpleJTA）
基本情報

リソース名

リソースタイプ

説明

認証タイプ

ログインタイムアウト

ユーザID

コネクションプール

稼働情報

リソース名

プール現在値（総数）

使用中のコネクション数

未使用のコネクション数

データソース（FullJTA）
基本情報

リソース名

リソースタイプ

説明

ログインタイムアウト

ユーザID

コネクションプール

稼働情報

リソース名

プール現在値

使用中のコネクション数

未使用のコネクション数

getConnection()メソッドの実行時間

getXAConnection()メソッドの実行時間

getConnection()メソッドの失敗回数

ConnectionでFATALエラーが発生した回数

リソースアダプタ
基本情報

リソース名

リソースタイプ

説明

リソースアダプタ提供ベンダ名

準拠するJCA仕様のバージョン

リソースアダプタのバージョン

接続先EISのタイプ

ConnectionFactoryのインタフェース名

ConnectionFactoryの実装クラス名

ManagedConnectionFactoryの実装クラス名

Connectionのインタフェース名

Connectionの実装クラス名

トランザクションサポートモデル

設定プロパティ情報

ユーザID

コネクションプール※2　※3

稼働情報

リソース名

プール現在値（総数）※2　※3

使用中のコネクション数※2　※3

未使用のコネクション数※2　※3

ManagedConnectionFactoryのcreateManagedConnection()メソッドの実行回数※2　※3

ManagedConnectionのgetConnection()メソッドの実行回数※2　※3

ManagedConnectionのcleanup()メソッドの実行回数※2　※3

ManagedConnectionのdestroy()メソッドの実行回数※2　※3

ConnectionManagerのallocateConnection()メソッドの実行時間※2　※3　※4

ManagedConnectionFactoryのcreateManagedConnection()メソッドの実行時間※2　※3

ConnectionManagerのallocateConnection()メソッドの失敗回数※2　※3　※4

ManagedConnectionでFATALエラーが発生した回数※2　※3

サービス
トランザクション
基本情報

サービス名

サービスタイプ

トランザクションタイムアウトデフォルト値

稼働情報

アクティブトランザクション数

平均トランザクション時間

注　使用する機能（Webサーバ連携機能，インプロセスHTTPサーバ，最大同時実行スレッド数制御機能などを使用するかどうか），オプションの設定，使用するリソースの違いなどによっては表示されない項目があります。

注※1　Connector 1.5仕様に準拠したリソースアダプタを使用した場合は，「Other」が出力されます。

注※2　ルートリソースアダプタを使用している場合，「0」または「Not Available」が出力されます。

注※3　Cosminexus RMを使用している場合，これらの項目はCosminexus RM側の稼働情報として出力されます。Management Serverの稼働情報監視では確認できません。

注※4　メンバリソースアダプタを使用している場合，「0」または「Not Available」が出力されます。

表2-21　稼働情報監視で表示できる項目（バッチサーバの場合）

監視の対象
監視できる項目

バッチサーバ
J2EEコンテナ

バッチサーバ名

Naming Serviceホスト

Naming Serviceポート番号

コンテナ起動時刻

JavaVM
基本情報

JavaVM名

JavaVMバージョン

JavaVMの最大メモリ使用量

稼働情報

JavaVMの空きメモリ量

JavaVMの総メモリ容量

リソース
データソース（SimpleJTA）
基本情報

リソース名

リソースタイプ

説明

認証タイプ

ログインタイムアウト

ユーザID

コネクションプール

稼働情報

リソース名

プール現在値（総数）

使用中のコネクション数

未使用のコネクション数

データソース（FullJTA）
基本情報

リソース名

リソースタイプ

説明

ログインタイムアウト

ユーザID

コネクションプール

稼働情報

リソース名

プール現在値

使用中のコネクション数

未使用のコネクション数

getConnection()メソッドの実行時間

getXAConnection()メソッドの実行時間

getConnection()メソッドの失敗回数

ConnectionでFATALエラーが発生した回数

リソースアダプタ
基本情報

リソース名

リソースタイプ

説明

リソースアダプタ提供ベンダ名

準拠するJCA仕様のバージョン

リソースアダプタのバージョン

接続先EISのタイプ

ConnectionFactoryのインタフェース名

ConnectionFactoryの実装クラス名

ManagedConnectionFactoryの実装クラス名

Connectionのインタフェース名

Connectionの実装クラス名

トランザクションサポートモデル

設定プロパティ情報

ユーザID

コネクションプール※1　※2

稼働情報

リソース名

プール現在値（総数）※1　※2

使用中のコネクション数※1　※2

未使用のコネクション数※1　※2

ManagedConnectionFactoryのcreateManagedConnection()メソッドの実行回数※1　※2

ManagedConnectionのgetConnection()メソッドの実行回数※2　※3

ManagedConnectionのcleanup()メソッドの実行回数※2　※3

ManagedConnectionのdestroy()メソッドの実行回数※1　※2

ConnectionManagerのallocateConnection()メソッドの実行時間※1　※2　※3

ManagedConnectionFactoryのcreateManagedConnection()メソッドの実行時間※1　※2

ConnectionManagerのallocateConnection()メソッドの失敗回数※1　※2　※3

ManagedConnectionでFATALエラーが発生した回数※1　※2

サービス
トランザクション
基本情報

サービス名

サービスタイプ

トランザクションタイムアウトデフォルト値

稼働情報

アクティブトランザクション数

平均トランザクション時間

注　使用する機能（Webサーバ連携機能，インプロセスHTTPサーバ，最大同時実行スレッド数制御機能などを使用するかどうか），オプションの設定，使用するリソースの違いなどによっては表示されない項目があります。

注※1　ルートリソースアダプタを使用している場合，「0」または「Not Available」が出力されます。

注※2　Cosminexus RMを使用している場合，これらの項目はCosminexus RM側の稼働情報として出力されます。Management Serverの稼働情報監視では確認できません。

注※3　メンバリソースアダプタを使用している場合，「0」または「Not Available」が出力されます。

表2-22　稼働情報監視で表示できる項目（SFOサーバの場合）

監視の対象
監視できる項目

SFOサーバ
J2EEコンテナ

J2EEサーバ名

Naming Serviceホスト

Naming Serviceポート番号

コンテナ起動時刻

JavaVM
基本情報

JavaVM名

JavaVMバージョン

JavaVMの最大メモリ使用量

稼働情報

JavaVMの空きメモリ量

JavaVMの総メモリ容量

アプリケーション（SFO用）
J2EEアプリケーション

アプリケーション名（display name）

説明

デプロイされた時刻

ポイント

統計情報のサンプリング時間の設定

稼働情報を表示する場合，統計情報のサンプリング時間を指定してください。

サンプリング時間を指定すると，画面を表示した時刻または更新した時刻からさかのぼって，サンプリング時間（これをN秒といいます）に指定した時間内のデータを統計情報として表示できます。「N秒ピーク」や「N秒平均値」とはこの統計情報です。また，最大値，最小値などは，サンプリングを開始した以降のデータの中から値が抽出されます。

運用管理コマンド（mngsvrutil）にサブコマンド「set」を指定してサンプリング時間を設定できます。詳細は，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

2.5　リソース枯渇の監視

この節では，J2EEサーバまたはSFOサーバのリソースの使用率または使用数の推移を基に，リソース枯渇を監視する方法について説明します。

J2EEサーバまたはSFOサーバのリソース枯渇を監視する設定にしている場合，監視対象のリソースについての情報が，一定間隔でファイルに出力されます。この情報を，リソース枯渇監視情報といいます。リソース枯渇監視情報は，監視するリソースの種類ごとに出力するかどうかを選択できます。なお，リソース枯渇監視情報を出力したファイルを，リソース枯渇監視ログファイルといいます。

リソース枯渇監視情報を利用すると，リソースの使用率または使用数の変化のしかたを確認できます。また，この情報は，リソースの使用率または使用数がしきい値を超えた場合に，その原因を調査するためにも利用できます。

リソース枯渇監視ログファイルの出力先については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」を参照してください。

リソース枯渇監視の設定については，マニュアル「Cosminexus　システム構築ガイド」のリソース枯渇監視の設定に関する説明を参照してください。

なお，リソースの使用率または使用数にしきい値を設定して監視すると，しきい値を超えた場合にアラートを出力できます。このアラートに対応して必要な処理を自動実行するように設定できます。Managementイベントによる処理の自動実行の設定については，マニュアル「Cosminexus　システム構築ガイド」のManagementイベントによる処理の自動実行の設定に関する説明を参照してください。

＜この節の構成＞

2.5.1　出力される情報の種類

2.5.2　出力形式と出力内容

2.5.1　出力される情報の種類

リソース枯渇監視情報には，次の表に示す情報が出力されます。なお，Windows，またはAIXの場合，ファイルディスクリプタの数は監視できません。また，Linuxの場合，スレッド監視は使用できません。

表2-23　リソース枯渇監視情報に出力される情報

情報の種類
ファイル名
情報の概要

メモリ枯渇監視情報
cjmemorywatch
JavaVMのヒープおよびメモリ領域の使用状況の監視結果が出力されます。
この情報は，usrconf.propertiesのejbserver.watch.memory.writefile.enabledキーにtrueが設定されている場合に出力されます。

ファイルディスクリプタ枯渇監視情報
cjfiledescriptorwatch
J2EEサーバプロセスが使用しているファイルディスクリプタの数の監視結果が出力されます。
この情報は，usrconf.propertiesのejbserver.watch.fileDescriptor.writefile.enabledキーにtrueが設定されている場合に出力されます。

スレッド枯渇監視情報
cjthreadwatch
J2EEサーバプロセスが生成したスレッド数の監視結果が出力されます。
この情報は，usrconf.propertiesのejbserver.watch.thread.writefile.enabledキーにtrueが設定されている場合に出力されます。

スレッドダンプ枯渇監視情報
cjthreaddumpwatch
出力されたスレッドダンプのファイル数の監視結果が出力されます。
この情報は，usrconf.propertiesのejbserver.watch.threaddump.writefile.enabledキーにtrueが設定されている場合に出力されます。

HTTPリクエスト実行待ちキュー枯渇監視情報
cjrequestqueuewatch
HTTPリクエスト実行待ちキューの監視結果として，次の2種類の実行待ちキューが監視され，結果が出力されます。

Webアプリケーション単位の最大同時実行スレッド数が設定されていないWebアプリケーションの実行待ちキューが監視されて，リクエスト格納数の監視結果が出力されます。
この情報は，usrconf.propertiesのejbserver.watch.defaultRequestQueue.writefile.enabledキーにtrueが設定されている場合に出力されます。

Webアプリケーション単位の最大同時実行スレッド数が設定されているWebアプリケーションの実行待ちキューが監視されて，リクエスト格納数の監視結果が出力されます。
この情報は，アプリケーションの属性として，<war><hitachi-war-property><thread-control><resource-watcher>タグ下の<watcher-writefile-enabled>タグにtrueが設定されている場合に出力されます。

なお，Webアプリケーション単位の最大同時実行スレッド数の制御が有効な場合（usrconf.propertiesのwebserver.container.thread_control.enabledキーにtrueが設定されている場合）に，これらの監視が実行されます。

セッション数枯渇監視情報
cjhttpsessionwatch
Webアプリケーション単位のセッション数の監視結果が出力されます。
この情報は，アプリケーションの属性として，<war><hitachi-war-property><http-session><resource-watcher>タグ下の<watcher-writefile-enabled>タグにtrueが設定されている場合に出力されます。

コネクションプール枯渇監視情報
cjconnectionpoolwatch
リソースアダプタ単位のコネクションプール数の監視結果が出力されます。
この情報は，リソースアダプタのプロパティとして，WatchWriteFileEnabledプロパティにtrueが設定されている場合に出力されます。

2.5.2　出力形式と出力内容

リソース枯渇監視情報は，出力レコードがCSV形式ファイルで出力されます。

出力形式を次の図に示します。

図2-2　リソース枯渇監視情報の出力形式

出力形式について説明します。

それぞれのカラムの出力内容がわかるように，タイトル行が，100行ごとに出力されます。

タイトルには，リソース共通の情報として，次の項目が出力されます。これらの項目は，図中の，"Title1"，"Title2"，"Title3"…の個所に出力されます。

Rate：割合（使用率）

Current：現在値

Max：最大値

Threshold：しきい値

このほか，リソースによって，必要な情報が出力されます。詳細は，それぞれのリソースの出力内容を参照してください。

しきい値判定の計算結果，現在値情報，設定したしきい値の順で出力されます。しきい値判定の結果が複数ある場合は，複数出力されます。

しきい値が%で設定されている場合，しきい値の計算結果も%で出力されます。例えば，計算結果が0.752であった場合，しきい値が%で指定されているときには，75.2と出力されます。

しきい値が絶対値の場合は，しきい値の計算結果は出力されません。

しきい値として上限が設定されていない場合，しきい値の計算結果は，「-」と出力されます。

値が小数になる場合は，小数点以下第2位が四捨五入され，小数点以下第1位までが出力されます。なお，しきい値判定にも，小数点以下第2位が四捨五入され，小数点以下第1位までにした値が利用されます。

なお，ファイルに出力される内容については，usrconf.properties，アプリケーションの属性，またはリソースアダプタの属性の設定内容に従います。

それぞれの出力情報について説明します。

＜この項の構成＞

(1)　メモリ枯渇監視情報

(2)　ファイルディスクリプタ枯渇監視情報

(3)　スレッド枯渇監視情報

(4)　スレッドダンプ枯渇監視情報

(5)　HTTPリクエスト実行待ちキュー枯渇監視情報

(6)　セッション数枯渇監視情報

(7)　コネクションプール枯渇監視情報

(1)　メモリ枯渇監視情報

メモリ枯渇監視情報には，次の表に示す情報が出力されます。

表2-24　メモリ枯渇監視情報の出力内容

出力タイトル文字列
出力内容

Rate1
Tenured領域のメモリ使用率が出力されます。
単位は%です。
Tenured領域のメモリ使用率は，次の計算式で算出されます。

Tenured領域のメモリ使用率 = Tenured領域消費サイズ / Tenured領域合計サイズ×100

Rate2
Tenured領域最大空きメモリに対するNew領域の合計メモリ率が出力されます。
単位は%です。
Tenured領域最大空きメモリに対するNew領域の合計メモリ率は，次の計算式で算出されます。

Tenured領域最大空きメモリに対するNew領域の合計メモリ率 = New領域合計サイズ / Tenured領域最大空きサイズ×100

Rate3
Permanent領域のメモリ使用率が出力されます。
単位は%です。
Permanent領域のメモリ使用率は，次の計算式で算出されます。

Permanent領域のメモリ使用率 = Permanent領域消費サイズ / Permanent領域合計サイズ×100

Free [New]
New領域の空きメモリサイズが出力されます。
単位はバイトです。

Total [New]
New領域の合計メモリサイズが出力されます。
単位はバイトです。

Max [New]
New領域の最大メモリサイズが出力されます
単位はバイトです。

Free [Old]
Tenured領域の空きメモリサイズが出力されます。
単位はバイトです。

Total [Old]
Tenured領域の合計メモリサイズが出力されます。
単位はバイトです。

Max [Old]
Tenured領域の最大メモリサイズが出力されます。
単位はバイトです。

Free [Permanent]
Permanent領域の空きメモリサイズが出力されます。
単位はバイトです。

Total [Permanent]
Permanent領域の合計メモリサイズが出力されます。
単位はバイトです。

Max [Permanent]
Permanent領域の最大メモリサイズが出力されます。
単位はバイトです。

Threshold
しきい値が出力されます。
単位は%です。

注意

メモリ枯渇監視機能は，十分にメモリ設計をして，フルガーベージコレクションが起こりにくいようにチューニングされたシステムを前提としています。メモリ枯渇監視機能は，このようにチューニングされたシステムであっても，フルガーベージコレクションが発生してアプリケーションが一時的に停止する予兆を検知することを目的としています。したがって，メモリチューニングが十分でない場合は，不必要にアラートが出力されることがありますので，ご注意ください。

メモリ枯渇監視をする場合は，Permanent領域の最大サイズと初期サイズに同じ値を設定することをお勧めします。具体的にはusrconf.cfgの-XX:MaxPermSizeと-XX:PermSizeを同じ値にします。異なる値を設定した場合，Permanent領域の領域拡張でもアラートが出力される場合があります。そのほかのチューニングパラメタについては，Sun Microsystems, Inc. のWebサイトなどの情報を参照してください。

また，この機能で監視しているメモリ使用率が100%に近づいた場合に必ずフルガーベージコレクションが発生するわけではありません。監視した値は，フルガーベージコレクションが発生する可能性が高いという予兆を検知するために使用されます。

参考

JavaVMでのヒープおよびメモリには，次の3種類の領域があります。

New領域
EdenとSurvivorに該当する領域です。新しいオブジェクトが格納されます。

Tenured領域
Tenuredに該当する領域です。長時間存在するオブジェクトが格納されます。

Permanent領域
JavaVMにロードされたクラスが格納される領域です。

メモリ監視結果情報には，これらの領域ごとに，その時点での空き領域，消費されている領域，および最大領域のサイズが出力されます。

メモリ監視を設定した場合，次の場合にメッセージが出力されます。

Tenured領域の合計サイズに対するTenured領域の消費サイズがしきい値以上の場合
「Tenured領域消費サイズ／Tenured領域合計サイズ×100≧しきい値（%）」の場合に出力されます。

Tenured領域の最大空きサイズに対するNew領域の合計サイズがしきい値以上の場合
「New領域合計サイズ／Tenured領域最大空きサイズ×100≧しきい値（%）」の場合に出力されます。

Permanent領域の合計サイズに対するPermanent領域の消費サイズがしきい値以上の場合
「Permanent領域消費サイズ／Permanent領域合計サイズ×100≧しきい値（%）」の場合に出力されます。

(2)　ファイルディスクリプタ枯渇監視情報

ファイルディスクリプタ監視結果情報には，次の表に示す情報が出力されます。なお，Windows，またはAIXの場合，ファイルディスクリプタの数は監視できません。

表2-25　ファイルディスクリプタ枯渇監視情報の出力内容

出力タイトル文字列 | 出力内容
Current | J2EEサーバプロセスが使用しているファイルディスクリプタ数が出力されます。
Max | プロセスに割り当て可能なファイルディスクリプタの数が出力されます。Solarisの場合，常に"-"が出力されます。
Threshold | しきい値が出力されます。

(3)　スレッド枯渇監視情報

スレッド枯渇監視情報には，次の表に示す情報が出力されます。

表2-26　スレッド枯渇監視情報の出力内容

出力タイトル文字列
出力内容

Current
自プロセスが使用しているスレッド数が出力されます。

Max

Windowsの場合
常に"-"が出力されます。

UNIXの場合
プロセスに生成できるスレッド数が出力されます。

Threshold
しきい値が出力されます。

(4)　スレッドダンプ枯渇監視情報

スレッドダンプ枯渇監視情報には，次の表に示す情報が出力されます。

表2-27　スレッドダンプ枯渇監視情報の出力内容

出力タイトル文字列
出力内容

Rate
現在のスレッドダンプのファイル数が，最大値に占める割合が出力されます。
単位は%です。

Current
スレッドダンプのファイル数の現在値が出力されます。

Max
スレッドダンプのファイル数の上限値が出力されます。

Threshold
しきい値が出力されます。
単位は%です。

(5)　HTTPリクエスト実行待ちキュー枯渇監視情報

HTTPリクエスト実行待ちキューとは，Webアプリケーションの同時実行スレッドに対する，実行待ちキューのことです。

HTTPリクエスト実行待ちキュー枯渇監視情報には，次の表に示す情報が出力されます。なお，この枯渇監視情報には，次の2種類の情報が含まれます。

J2EEサーバ単位のリクエスト実行待ちキュー格納数の監視結果

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視結果

表2-28　HTTPリクエスト実行待ちキュー枯渇監視情報の出力内容

出力タイトル文字列
出力内容

J2eeApplicationName
J2EEアプリケーション名が出力されます。
デフォルトのリクエスト実行待ちキューの監視結果の場合は，"-"が出力されます。

ContextRootName
コンテキストルート名が出力されます。
デフォルトのリクエスト実行待ちキューの監視結果の場合は，"-"が出力されます。

Rate
現在のキュー格納数の最大値に占める割合が出力されます
単位は%です。

Current
キュー格納数の現在値が出力されます。

Max
実行待ちキューのリクエスト格納数の最大値が出力されます。

Threshold
しきい値が出力されます。
単位は%です。

(6)　セッション数枯渇監視情報

セッション数枯渇監視情報には，次の表に示す情報が出力されます。

表2-29　セッション数枯渇監視情報の出力内容

出力タイトル文字列
出力内容

J2eeApplicationName
J2EEアプリケーション名が出力されます。

ContextRootName
コンテキストルート名が出力されます。

Rate
現在のセッション作成数の最大値に占める割合が出力されます。
単位は%です。
最大値が設定されていない場合は，"-"が出力されます。

Current
セッション数の現在値が出力されます。

Max
セッション数の最大値が出力されます。
設定されていない場合は"-"が出力されます。

Threshold
しきい値が出力されます。
単位は%です。

(7)　コネクションプール枯渇監視情報

コネクションプール枯渇監視情報には，次の表に示す情報が出力されます。

表2-30　コネクションプール枯渇監視情報の出力内容

出力タイトル文字列
出力内容

ResourceName
ユーザが付けたリソースアダプタ名が次の形式で出力されます。

リソースアダプタを直接J2EEサーバにデプロイした場合

<リソースアダプタ名>

リソースアダプタをJ2EEアプリケーションに含めてデプロイした場合

<J2EEアプリケーション名>：<リソースアダプタ名>

リソースアダプタをJ2EEアプリケーションに含めてデプロイして，テストモードで開始した場合

TEST#<J2EEアプリケーション名>：<リソースアダプタ名>

Rate
コネクションプールの使用率が出力されます。
単位は%です。
コネクション数の最大値が無制限の場合，"-"が出力されます。

Active
使用中のコネクション数が出力されます。

Free
未使用のコネクション数が出力されます。

Current
コネクション数の現在値が出力されます。

Min
コネクション数の最小値が出力されます。

Max
コネクション数の最大値が出力されます。
コネクションプールが無制限の場合，"-1"が出力されます。

Threshold
しきい値が出力されます。
単位は%です。

All
コネクションの総数（コネクションプール管理内のコネクションとコネクションプール管理外のコネクションの総数）が出力されます。

2.6　CTMの稼働統計情報の確認

この節では，運用管理コマンド（mngsvrutil）を使用して，CTMの稼働統計情報を収集する方法について説明します。また，収集した情報を確認する方法についても説明します。

次の単位でCTMの稼働統計情報を収集できます。

運用管理ドメイン内のすべてのCTM

運用管理ドメイン内の指定したCTM

運用管理ドメイン内の指定したホスト内のCTM

＜この節の構成＞

2.6.1　CTMの稼働統計情報の収集方法

2.6.2　CTMの稼働統計情報の出力先と出力情報

2.6.3　CTMの稼働統計情報の出力例

2.6.1　CTMの稼働統計情報の収集方法

CTMの稼働統計情報の出力と収集は，mngsvrutilコマンドにサブコマンド「collect」を指定して実行します。

CTMの稼働統計情報は，次のどれかの単位で収集できます。

運用管理ドメイン内のすべてのCTM

運用管理ドメイン内の指定したCTM

運用管理ドメイン内の指定したホスト内のCTM

なお，収集対象になるのは稼働中のCTMだけです。

CTMの稼働統計情報を出力，収集する場合のmngsvrutilコマンドの実行形式と実行例を次に示します。

運用管理ドメイン内のすべてのCTMを対象にする場合

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> collect allCtmStatistics

実行例

mngsvrutil -m mnghost -u user01 -p pw1 collect allCtmStatistics

運用管理ドメイン内の指定したCTM，または指定したホスト内のCTMを対象にする場合

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <論理CTM名またはホスト名> [-k host] collect ctmStatistics

実行例

指定したCTMの稼働統計情報を収集する場合
mngsvrutil -m mnghost -u user01 -p pw1 -t ctm01 collect ctmStatistics

指定したホスト内のCTMの稼働統計情報を収集する場合
mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host collect ctmStatistics

コマンドの実行結果は，標準出力またはファイルに出力されます。

mngsvrutilコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

2.6.2　CTMの稼働統計情報の出力先と出力情報

収集した稼働統計情報はCSV形式で出力されて，ZIP形式で圧縮されます。稼働統計情報が出力されるCSVファイルを，稼働統計出力ファイルといいます。

収集した稼働統計出力ファイルの出力先と出力情報について説明します。

収集した稼働統計出力ファイルの出力先

Windowsの場合
<Managerのログ出力ディレクトリ>¥ctm

UNIXの場合
<Managerのログ出力ディレクトリ>/ctm

なお，稼働統計出力ファイルは，稼働統計情報を収集する対象ごとに次の表に示すファイル名で出力されます。

表2-31　収集対象ごとの稼働統計出力ファイル名

稼働統計情報の収集対象 | ファイル名
運用管理ドメイン内のすべてのCTM | <ドメイン名>-<日時>.zip
運用管理ドメイン内の指定したCTM | <論理サーバ名>-<日時>.zip
指定したホスト内のCTM | <ホスト名>-<日時>.zip

注　出力された稼働統計出力ファイル（CSV形式）は，ZIP形式で圧縮されます。

また，CSV形式に出力される稼働統計情報は，CTMノード単位，キュー単位，およびメソッド単位でそれぞれ異なるファイルで出力されます。出力単位ごとの稼働統計情報のファイル名を次に示します。

表2-32　出力単位ごとの稼働統計出力ファイル名

出力単位 | ファイル名
CTMノード単位 | noddata.csv
キュー単位 | quedata.csv
メソッド単位 | mtddata.csv

稼働統計情報の出力情報

稼働統計出力ファイルに出力される情報を次の表に示します。

表2-33　稼働統計出力ファイルに出力される情報

統計情報種別
情報
説明

リクエスト情報
CTMレギュレータレスポンス時間
TPBrokerクライアント，およびEJBクライアントからの要求を受信したCTMレギュレータが，J2EEサーバに対してリクエストを送信してから応答を受信するまでの時間の差です。CTMレギュレータで出力されます。
発生件数，および最大値・最小値・平均値がマイクロ秒単位で出力されます。

CTMレギュレータリクエストタイムアウト
CTMレギュレータがリクエストを送信してから応答が返されるまでの間に発生したタイムアウト障害の発生件数です。CTMレギュレータで出力されます。

CTMレギュレータリクエスト障害
CTMレギュレータがリクエストを送信してからその応答が返されるまでの処理で発生した障害の発生件数です。CTMレギュレータで出力されます。

OTMゲートウェイレスポンス時間
TPBroker OTMクライアントからの要求を受信したOTMゲートウェイが，J2EEサーバに対してリクエストを送信してから，応答を受信するまでの時間の差です。OTMゲートウェイで出力されます。
発生件数，および最大値・最小値・平均値がマイクロ秒単位で出力されます。

OTMゲートウェイリクエストタイムアウト
OTMゲートウェイでのリクエストの応答待ちで発生したタイムアウト障害の件数です。OTMゲートウェイで出力されます。

OTMゲートウェイリクエスト障害
OTMゲートウェイがリクエストを送信してからその応答が返されるまでの処理で発生した障害の件数です。OTMゲートウェイで取得します。

スケジュール情報
スケジュール待ち件数
スケジュールキューに滞留したリクエストの数です。
発生件数，および最大値・最小値・平均値が出力されます。

スケジュール待ち時間
リクエストがスケジュールキューに登録されてから取り出されるまでの滞留時間です。
発生件数，および最大値・最小値・平均値がマイクロ秒単位で出力されます。

スケジュールできなかったリクエスト数
スケジュールキューに同時に登録できる数を超えたため，スケジュールできなかったリクエストの数です。

プロセス情報
CTMレギュレータ異常終了件数
CTMレギュレータの異常終了が発生した件数です。
異常終了が発生するたびに，この情報が出力されます。

OTMゲートウェイ異常終了件数
OTMゲートウェイの異常終了が発生した件数です。
異常終了が発生するたびに，この情報を取得します。

コネクション情報
CTMレギュレータとクライアント間
CTMレギュレータとクライアントとのコネクション情報です。ctmstsstartコマンドの-CTMCheckIntervalオプションに指定した間隔で出力されます。
最大値・最小値・平均値がマイクロ秒単位で出力されます。

OTMゲートウェイとTPBroker OTMクライアント間
OTMゲートウェイとTPBroker OTMクライアントとのコネクション情報です。ctmstsstartコマンドの-CTMCheckIntervalオプションに指定した間隔でこの情報を取得します。
最大値・最小値・平均値がマイクロ秒単位で出力されます。

CTMデーモンとCTMレギュレータ間
CTMデーモンとCTMレギュレータとのコネクション情報です。ctmstsstartコマンドの-CTMCheckIntervalオプションに指定した間隔でこの情報を取得します。
最大値・最小値・平均値がマイクロ秒単位で出力されます。

CTMデーモンとOTMゲートウェイ間
CTMデーモンとOTMゲートウェイとのコネクション情報です。ctmstsstartコマンドの-CTMCheckIntervalオプションに指定した間隔でこの情報を取得します。
最大値・最小値・平均値がマイクロ秒単位で出力されます。

CTMデーモンとJ2EEサーバ間(制御用)
CTMデーモンとJ2EEサーバ間の制御用コネクション情報です。ctmstsstartコマンドの-CTMCheckIntervalオプションに指定した時間間隔でこの情報を取得します。

CTMデーモンとJ2EEサーバ間(リクエスト用)
CTMデーモンとJ2EEサーバ間のリクエスト要求用処理コネクション情報です。ctmstsstartコマンドの-CTMCheckIntervalオプションに指定した時間間隔でこの情報を取得します。

2.6.3　CTMの稼働統計情報の出力例

運用管理コマンド（mngsvrutil）を利用して収集した稼働統計出力ファイルの出力例を次に示します。

CTMノード単位で出力した稼働統計情報の出力例

*** Statistics Information by CTMNode ***
CTMDomain, CTMID, start, end, Event, Count, Maximum, Minimum, Average, unit
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Request Response Time(Reg),      26525,      94000,          0,       9099,(usec)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Request Time Out(Reg),          0,,,,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Request Error(Reg),          2,,,,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Request Response Time(OTM),          0,          0,          0,          0,(usec)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Request Time Out(OTM),          0,,,,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Request Error(OTM),          0,,,,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Schedule Wait Count,      26526,          1,          1,          1,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Schedule Wait Time,      26526,    5688000,          0,        560,(usec)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Request Overflow,          0,,,,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Regulator down,          0,,,,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,OTMGateway down,          0,,,,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,Regulator-Client,,          2,          0,          1,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,OTMGateway-Client,,          0,          0,          0,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,CTMDaemon-J2EEServer(Ctr),,          2,          0,          1,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,CTMDaemon-J2EEServer(Req),,          1,          0,          1,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,CTMDaemon-Regulator,,          1,          1,          1,(count)
CTMDOMAIN,10.209.15.55,2004/11/05 09:57,2004/11/05 10:07,CTMDaemon-OTMGateway,,          5,          5,          5,(count)

キュー単位で出力した稼働統計情報の出力例

*** Statistics Information by Queue ***
CTMDomain, CTMID, QueueName, start, end, Event, Count, Maximum, Minimum, Average, unit
CTMDOMAIN,10.209.15.55,converter,2004/11/05 09:57,2004/11/05 10:07,Schedule Wait Count,      26526,          1,          1,          1,(count)
CTMDOMAIN,10.209.15.55,converter,2004/11/05 09:57,2004/11/05 10:07,Schedule Wait Time,      26526,    5688000,          0,        560,(usec)
CTMDOMAIN,10.209.15.55,converter,2004/11/05 09:57,2004/11/05 10:07,Request Overflow,          0,,,,(count)
CTMDOMAIN,10.209.15.55,converter,2004/11/05 09:57,2004/11/05 10:07,CTMDaemon-J2EEServer(Req),,          1,          1,          1,(count)

メソッド単位で出力した稼働統計情報の出力例

*** Statistics Information by Method ***
CTMDomain, CTMID, Interface, Method, start, end, Event, Count, Maximum, Minimum, Average, unit
CTMDOMAIN,10.209.15.55,Converter,dollarToYen,2004/11/05 09:57,2004/11/05 10:07,Request Response Time(Reg),      10393,      78000,          0,       9143,(usec)
CTMDOMAIN,10.209.15.55,Converter,dollarToYen,2004/11/05 09:57,2004/11/05 10:07,Request Time Out(Reg),          0,,,,(count)
CTMDOMAIN,10.209.15.55,Converter,dollarToYen,2004/11/05 09:57,2004/11/05 10:07,Request Error(Reg),          0,,,,(count)
CTMDOMAIN,10.209.15.55,Converter,dollarToYen,2004/11/05 09:57,2004/11/05 10:07,Request Response Time(OTM),          0,          0,          0,          0,(usec)
CTMDOMAIN,10.209.15.55,Converter,dollarToYen,2004/11/05 09:57,2004/11/05 10:07,Request Time Out(OTM),          0,,,,(count)
CTMDOMAIN,10.209.15.55,Converter,dollarToYen,2004/11/05 09:57,2004/11/05 10:07,Request Error(OTM),          0,,,,(count)
CTMDOMAIN,10.209.15.55,Converter,yenToEuro,2004/11/05 09:57,2004/11/05 10:07,Request Response Time(Reg),      10393,      94000,          0,       9119,(usec)
CTMDOMAIN,10.209.15.55,Converter,yenToEuro,2004/11/05 09:57,2004/11/05 10:07,Request Time Out(Reg),          0,,,,(count)
CTMDOMAIN,10.209.15.55,Converter,yenToEuro,2004/11/05 09:57,2004/11/05 10:07,Request Error(Reg),          2,,,,(count)
CTMDOMAIN,10.209.15.55,Converter,yenToEuro,2004/11/05 09:57,2004/11/05 10:07,Request Response Time(OTM),          0,          0,          0,          0,(usec)
CTMDOMAIN,10.209.15.55,Converter,yenToEuro,2004/11/05 09:57,2004/11/05 10:07,Request Time Out(OTM),          0,,,,(count)
CTMDOMAIN,10.209.15.55,Converter,yenToEuro,2004/11/05 09:57,2004/11/05 10:07,Request Error(OTM),          0,,,,(count)

2.7　トランザクション情報の確認

この節では，稼働中および停止中のJ2EEサーバのトランザクションの情報を確認する方法について説明します。稼働中のJ2EEサーバでのトランザクションの状態や，停止中のJ2EEサーバでの未決着のトランザクションの有無などの情報を確認できます。

＜この節の構成＞

2.7.1　稼働中のトランザクションの確認

2.7.2　停止中のトランザクションの確認

2.7.1　稼働中のトランザクションの確認

J2EEサーバで稼働中のトランザクションの情報を確認できます。トランザクションの状態，グローバルトランザクションID，経過時間，ブランチの種類などの情報を確認できます。

稼働中のトランザクションの確認には，cjlisttrnコマンドを使用します。実行形式と実行例を次に示します。

実行形式

cjlisttrn [<サーバ名称>] -bqual

実行例

cjlisttrn MyServer -bqual

また，未決着のトランザクションの状態も確認できます。未決着のトランザクションについての情報を確認するときは，引数に「-pending」を指定します。未決着のトランザクションについての情報を確認する場合の実行形式と実行例を次に示します。

実行形式

cjlisttrn [<サーバ名称>] -pending -bqual

実行例

cjlisttrn MyServer -pending -bqual

cjlisttrnコマンド，および取得できる情報の詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

2.7.2　停止中のトランザクションの確認

停止中のJ2EEサーバのトランザクションの情報を確認できます。トランザクションの状態，グローバルトランザクションID，経過時間，ブランチの種類等の情報を確認できます。また，未決着のトランザクションが残っているかどうかも確認できます。

停止中のトランザクションの確認には，cjlisttrnfileコマンドを使用します。実行形式と実行例を次に示します。

実行形式

cjlisttrnfile [<サーバ名称>] -bqual

実行例

cjlisttrnfile MyServer -bqual

J2EEサーバが停止中の状態で未決着のトランザクションが存在する場合は，必要に応じて次の処理を実行して，トランザクションを決着させてください。

J2EEサーバを再起動する（cjstartsvコマンド）

J2EEサーバをリカバリモードで起動する（cjstartrecoverコマンド）

cjlisttrnfileコマンド，および取得できる情報の詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

3.　システムの処理性能の解析

この章では，システムでの処理性能の解析方法について説明します。

Cosminexusでは，システムの処理性能の解析に，パフォーマンストレーサという論理サーバを使用します。

＜この章の構成＞

3.1　処理性能の解析作業の概要

3.2　性能解析トレースファイルの収集

3.3　性能解析トレースファイルの利用方法

3.1　処理性能の解析作業の概要

Cosminexusで構築したシステムの処理性能は，クライアントからデータベースなどのEISまでの一連の処理，およびその処理結果がクライアントに返却されるまでのリクエストの一連の処理で，リダイレクタやWebコンテナなどから出力されるトレース情報を基に解析できます。トレース情報を出力するリダイレクタやWebコンテナなどを，機能レイヤといいます。リクエストの処理過程では，次に示す機能レイヤからトレース情報が出力されます。

CTM

リダイレクタ

Webコンテナ

EJBコンテナ

JNDI

JTA

JCAコンテナ

DB Connector

RMI（通信処理）

OTS

標準出力／標準エラー出力／ユーザログ

DI

バッチアプリケーション実行機能

各機能レイヤでは決まった処理のポイント（トレース取得ポイント）でトレース情報を出力します。各機能レイヤが出力するトレース情報は，パフォーマンストレーサ（Cosminexus Performance Tracer）のPRFデーモンによって，トレースファイル（PRFトレースファイル）に出力されます。PRFデーモンにはトレース取得レベル（標準または詳細）を設定できます。PRFデーモンに設定するトレース取得レベルをPRFトレース取得レベルといいます。PRFトレース取得レベルの設定方法については，「付録H.3　システムの処理性能解析」を参照してください。各機能レイヤのトレース取得ポイントおよびPRFトレース取得レベルの詳細については，「付録A　トレース取得ポイントとPRFトレース取得レベル」を参照してください。

なお，RMI（通信処理）の機能レイヤについては，トレース情報の取得を抑止することができます。その場合，トレース取得レベルに「抑止」を設定します。設定方法については，マニュアル「Cosminexus　リファレンス　コマンド編」のcprfstartコマンド（PRFデーモンの開始）の説明，またはcprflevelコマンド（PRFトレース取得レベルの表示と変更）の説明を参照してください。

参考

このほか，次に示すApplication Serverのプロセス，構成ソフトウェアおよび関連プログラムでも，PRFトレースが取得できます。

Cosminexus Web Services - Base

uCosminexus TP1 Connector

Cosminexus RM

TP1/Client/J

TP1/MQ Access

HCSCサーバ

uCosminexus Service Coordinator Interactive Workflow

uCosminexus Service Adapter for Object Access

uCosminexus Service Adapter for Flat Files

なお，各機能レイヤのトレース情報はバイナリ形式でPRFトレースファイルに出力されます。システムの処理性能を解析する際は，PRFトレースファイルをテキスト形式（CSV形式）に変換したファイル（性能解析トレースファイル）を使用します。性能解析トレースファイルの出力先および出力情報については，「3.2.2　性能解析トレースファイルの出力先と出力情報」を参照してください。

システムの処理性能を解析する作業について，次の表に示します。なお，これらの作業は，運用管理コマンド（mngsvrutil）を使用して実行します。

参考

保守レベルのトレース情報について

PRFトレース取得レベルには，標準レベルと詳細レベルのほかに，保守レベルがあります。保守レベルとは，障害発生時などの保守情報を取得するためのレベルを指します。通常は指定しないでください。

PRFトレース取得レベルに保守レベルを設定する方法については，マニュアル「Cosminexus　リファレンス　コマンド編」のcprflevelコマンドについての説明を参照してください。

＜この節の構成＞

(1)　性能解析トレースファイルの収集

(2)　性能解析トレースファイルを利用したシステムの処理性能の解析

(1)　性能解析トレースファイルの収集

性能解析トレースファイルを収集する作業の概要について次の表に示します。

表3-1　性能解析トレースファイルの収集

作業内容
手段
作業概要
参照先

性能解析トレースファイルの出力／収集
運用管理コマンド（mngsvrutil）
PRFトレースファイルをCSV形式に変換した性能解析トレースファイルを出力，収集します。
性能解析トレースファイルの対象範囲は次の中から選択できます。

運用管理ドメイン内のすべてのパフォーマンストレーサ

特定のホスト内のすべてのパフォーマンストレーサ

特定のパフォーマンストレーサ

3.2.1

(2)　性能解析トレースファイルを利用したシステムの処理性能の解析

収集した性能解析トレースファイルを利用してシステムの処理性能を解析する作業の概要について次の表に示します。なお，出力された性能解析トレースファイルは，CSV形式のファイルを編集するアプリケーションプログラムなどを使用して解析します。

表3-2　性能解析トレースファイルを利用したシステムの処理性能の解析

作業内容 | 作業概要 | 参照先
Webサーバのレスポンスタイムの解析 | Webサーバがクライアントからリクエストを受けてから返却するまでに掛かった時間を解析します。 | 3.3.1
アプリケーションサーバ内でのリクエストの処理状況の調査 | Webサーバがクライアントから受けたリクエストがアプリケーションサーバで処理されているかどうか調査します。 | 3.3.2
セッションのライフサイクルの調査 | PRFトレース取得レベルを「詳細」に設定している場合に出力されるトレース（セッショントレース）を利用して，セッションのライフサイクルを調査します。 | 3.3.3
タイムアウトしたトランザクションの特定 | J2EEアプリケーションまたはバッチアプリケーションのトランザクションがタイムアウトした場合に，メッセージまたは性能解析トレースファイルを使用してタイムアウトしたトランザクションを特定します。 | 3.3.4
タイムアウトしたリクエストの特定 | リダイレクタでのレスポンス受信時にタイムアウトが発生した場合に，性能解析トレースを利用してタイムアウトが発生したリクエストを特定します。 | 3.3.5
ルートアプリケーション情報を利用したログの調査 | J2EEアプリケーションまたはバッチアプリケーション内でCosminexusのAPIを使用して，性能解析情報のルートアプリケーション情報の文字列表現を任意のタイミングでログファイルに出力します。 | 3.3.6
トラブルが発生したコネクションの特定 | 性能解析トレースファイルに出力された情報から，トラブルが発生したコネクションを特定します。 | 3.3.7
性能解析トレースとスレッドダンプの対応づけ | J2EEアプリケーションまたはバッチアプリケーションでスローダウンやハングアップが発生したときに，性能解析トレースとスレッドダンプを対応づけることで，問題が発生した個所を調査できます。 | 3.3.8

3.2　性能解析トレースファイルの収集

性能解析トレースファイルの収集方法，および収集したファイルの出力先について説明します。性能解析トレースファイルは，運用管理コマンドを使用して収集します。

＜この節の構成＞

3.2.1　性能解析トレースファイルの収集方法

3.2.2　性能解析トレースファイルの出力先と出力情報

3.2.1　性能解析トレースファイルの収集方法

運用管理コマンド（mngsvrutil）を使用して性能解析トレースファイルを収集する場合，mngsvrutilコマンドに，サブコマンド「collect」を指定して収集します。性能解析トレースファイルの収集時，トレース情報の収集対象を選択します。運用管理コマンドを使用した場合のトレース情報の収集対象を次に示します。

運用管理ドメイン内のすべてのパフォーマンストレーサ

特定のホスト内のすべてのパフォーマンストレーサ

特定のパフォーマンストレーサ

それぞれの場合の実行形式と実行例を次に示します。

運用管理ドメイン内のすべてのパフォーマンストレーサを対象にする場合

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> collect allPrfTrace

実行例

mngsvrutil -m mnghost -u user01 -p pw1 collect allPrfTrace

特定のホスト内のすべてのパフォーマンストレーサを対象にする場合

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <ホスト名> -k host collect prfTrace

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host collect prfTrace

特定のパフォーマンストレーサを対象にする場合

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <論理パフォーマンストレーサ名> -k logicalServer collect prfTrace

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t ID01 -k logicalServer collect prfTrace

3.2.2　性能解析トレースファイルの出力先と出力情報

収集した性能解析トレースファイルの出力先と出力情報について説明します。

＜この項の構成＞

(1)　性能解析トレースファイルの出力先

(2)　性能解析トレースファイルの出力情報

(1)　性能解析トレースファイルの出力先

Windowsの場合
<Managerのログ出力ディレクトリ>¥prf

UNIXの場合
<Managerのログ出力ディレクトリ>/prf

なお，性能解析トレースファイルは，トレース情報の収集対象別に次の表に示すファイル名で出力されます。

表3-3　性能解析トレースファイルのファイル名

トレース情報の収集対象 | ファイル名
運用管理ドメイン内のすべてのパフォーマンストレーサ | <運用管理ドメイン名>-<日時※1>.zip
特定のホスト内のすべてのパフォーマンストレーサ | <ホスト名>-<日時※1>.zip
特定のパフォーマンストレーサ | <論理サーバ名※2>-<日時※1>.zip

注※1

性能解析トレースファイルを収集した日時が表示されます。

注※2

指定したパフォーマンストレーサの名称が表示されます。

(2)　性能解析トレースファイルの出力情報

パフォーマンストレーサから性能解析トレースファイル（CSV形式）に出力される情報を次の表に示します。なお，CTMとそれ以外の機能レイヤでは，取得項目が異なります。また，付加情報の有無など，取得ポイントごとに，出力される項目は異なります。各取得ポイントで出力される項目の詳細については，「付録A　トレース取得ポイントとPRFトレース取得レベル」を参照してください。

表3-4　性能解析トレースファイルに出力する情報

トレース情報のヘッダ
説明
値の範囲

PRF
そのプロセスのレコードの状態（正常または異常）。
次のどちらかが出力されます。
正常：Rec
異常：ErrRec

Process
トレース情報を取得したプロセスのプロセスID。
10けたの10進数が出力されます。

Thread
トレース情報を取得したプロセス内スレッドのスレッドID，およびスレッドのハッシュ値※1。
スレッドID：20けた以内の10進数が出力されます。
ハッシュ値：10けた以内の10進数が出力されます。

Trace
トレース情報を取得したプロセス内スレッドでのトレース通番。
10けたの10進数が出力されます。

ProcessName
プロセス名。
32文字以内のプロセスを表す文字列※2が出力されます。

Event
トレース取得ポイントを示すイベントID。
6けたの16進数（6けたには，"0x"も含みます）が出力されます※3。

Date
トレース情報を取得した年月日。
年月日が「yyyy/mm/dd」のフォーマットで出力されます。
yyyy：年
mm：月
dd：日

Time
トレース情報を取得した時刻（時：分：秒）。
時刻が「hh:mm:ss」のフォーマットで出力されます。
hh：時
mm：分
ss：秒

Time(msec/usec/nsec)
トレース情報を取得した時刻（ミリ秒/マイクロ秒/ナノ秒）。
時刻が「ms/us/ns」のフォーマットで出力されます。
ms：ミリ秒
us：マイクロ秒
ns：ナノ秒

Rc
リターンコード。
16けたの16進数（16けたには，"0x"も含む）が出力されます。
正常：0
異常：1（または0以外）

ClientAP IP※4
トレース情報を取得したクライアントアプリケーションのIPアドレス。
IPアドレスが，「aaa.bbb.ccc.ddd」のフォーマットで出力されます。

ClientAP PID※4
トレース情報を取得したクライアントアプリケーションのプロセスID。
10けたの10進数が出力されます。

ClientAP CommNo.※4
トレース情報を取得したクライアントアプリケーションの通信番号。
18けたの16進数（18けたには，"0x"も含みます）が出力されます。

RootAP IP※5
トレース情報を取得したルートアプリケーションのIPアドレス。
IPアドレスが「aaa.bbb.ccc.ddd」のフォーマットで出力されます。

RootAP PID※5
トレース情報を取得したルートアプリケーションのプロセスID。
10けたの10進数が出力されます。

RootAP CommNo.※5
トレース情報を取得したルートアプリケーションの通信番号。
18けたの16進数（18けたには，"0x"も含む）が出力されます

SendSCD IP※5
リクエスト要求元CTMのIPアドレス。
IPアドレスが「aaa.bbb.ccc.ddd」のフォーマットで出力されます。

SendSCD PID※6
リクエスト要求元CTMのプロセスID。
10けたの10進数が出力されます。

ReceiveSCD IP※6
リクエスト要求先CTMのIPアドレス。
IPアドレスが「aaa.bbb.ccc.ddd」のフォーマットで出力されます。

ReceiveSCD PID※6
リクエスト要求先CTMのプロセスID。
10けたの10進数

INT
取得ポイントごとのインタフェース名。
33文字以内の文字列※7が出力されます。

OPR
取得ポイントに関連するオペレーション情報。
33文字以内の文字列※7が出力されます。

LookupName※6
ルックアップ名。
33文字以内の文字列※7が出力されます。

OPT※8
取得ポイントごとの付加情報。
514文字以内の16進数値文字列が出力されます。

ASCII
取得ポイントごとの付加情報をASCII文字出力。
OPTの内容が258文字以内のASCII文字列として出力されます。

注※1

CTMおよびリダイレクタで取得したトレース情報には，スレッドのハッシュ値は出力されない場合があります。

注※2

プロセス名称は次のように決定されます。

EJBクライアントアプリケーションの場合
EJBクライアントアプリケーションのシステムプロパティejbserver.server.prf.processNameに指定された名称。
このシステムプロパティを指定していない場合，またはこのプロパティにnull文字を指定した場合は，"EJBClient"になります。

J2EEサーバ，バッチサーバ，およびWebコンテナサーバの場合
サーバ名がプロセス名称となります。

リダイレクタの場合
WebサーバとしてHitachi Web Serverを使用している場合は，"RD-{Webサーバ待ち受けポート番号}"がプロセス名称となります。Microsoft IISを使用している場合は，"Redirector"がプロセス名称となります。

CTMの場合
CTMの各プロセス名称となります。

注※3

イベントIDは，機能レイヤのトレース取得ポイントごとに割り当てられています。詳細は，「付録A　トレース取得ポイントとPRFトレース取得レベル」を参照してください。

注※4

クライアントアプリケーション情報の構成要素です。

注※5

ルートアプリケーション情報の構成要素です。Webコンテナで出力されるトレースポイントでは，トレース情報を取得したルートアプリケーションのIPアドレス，プロセスID，および通信番号が「0.0.0. 0/0/0x0000000000000000」と出力される場合があります。詳細は「3.3.6　ルートアプリケーション情報を利用したログ調査」を参照してください。

注※6

CTMの場合だけ出力される情報です。CTM以外のレイヤでは，「****」が表示されます。

注※7

インタフェース名，およびオペレーション名が33文字を超える場合，次のどれかの方法で，33文字になって出力されます。詳細は，「付録A　トレース取得ポイントとPRFトレース取得レベル」を参照してください。

先頭32文字+*

先頭16文字+*+末尾16文字

*+末尾32文字

注※8

機能レイヤによっては，「OPT」に入り口時刻が出力されるトレース取得ポイントがあります。入り口時刻とは，そのトレース取得ポイントのトレースに対応する入り口トレースが出力された時間を示します。例えば，リダイレクタのトレース取得ポイントの場合，WebサーバへのHTTPレスポンスボディ情報の送信完了時（0x8104）のトレース取得ポイントで出力される入り口時刻は，WebコンテナからのHTTPレスポンスボディ情報の送信開始時（0x8004）の時刻になります。

なお，入り口時刻は，「1970年1月1日00:00:00」からの通算時間が16バイトの値で出力されます。前半の8バイトの値は秒単位を，後半の8バイトの値はマイクロ秒単位を示します。ただし，リダイレクタの性能解析トレースの場合は，後半の8バイトはミリ秒単位を示します。

3.3　性能解析トレースファイルの利用方法

性能解析トレースファイルを使用して性能を解析する場合，Microsoft Excelなど，CSV形式のファイルを編集できるアプリケーションプログラムで表示して，目的に合わせてフィルタリングや並べ替えの機能を利用します。

性能解析トレースファイルの利用方法について，例を使用して説明します。ここでは，次の利用方法について説明します。

Webサーバのレスポンスタイムの解析

アプリケーションサーバ内でのリクエストの処理状況の調査

セッションのライフサイクルの調査

タイムアウトが発生したトランザクションの特定

タイムアウトが発生したリクエストの特定

ルートアプリケーション情報を利用したログ調査

トラブルが発生したコネクションの特定

なお，ここでは，次のようなWebクライアント構成の環境で性能解析トレースファイルを収集したことを前提とします。

図3-1　 Webクライアント構成の例

＜この節の構成＞

3.3.1　Webサーバのレスポンスタイムの解析

3.3.2　アプリケーションサーバ内でのリクエストの処理状況の調査

3.3.3　セッションのライフサイクルの調査

3.3.4　タイムアウトが発生したトランザクションの特定

3.3.5　タイムアウトが発生したリクエストの特定

3.3.6　ルートアプリケーション情報を利用したログ調査

3.3.7　トラブルが発生したコネクションの特定

3.3.8　性能解析トレースファイルとスレッドダンプを対応づけた問題個所の調査

3.3.1　Webサーバのレスポンスタイムの解析

ここでは，Webサーバがクライアントからリクエストを受けてから返却するまでに掛かった時間を解析する方法を，例を使用して説明します。

リダイレクタに割り当てられたイベントID「0x8001」および「0x8101」をキーにして，Webサーバで収集した性能解析トレースファイルをフィルタリングします。フィルタリングに使用するイベントIDが示すトレース取得ポイントは次のとおりです。

表3-5　フィルタリングに使用するイベントIDが示すトレース取得ポイント

イベントID | トレース取得ポイント
0x8001 | Webコンテナへのリクエストヘッダ情報の送信
0x8101 | Webコンテナからのレスポンス完了通知の受信

イベントID「0x8001」および「0x8101」をキーにして，性能解析トレースをフィルタリングした例を次に示します。

図3-2　性能解析トレースファイルをフィルタリングした例

「0x8001」および「0x8101」のトレース取得時刻から，リクエストごとのレスポンスタイムを解析できます。図3-2の例では，クライアントアプリケーション情報の通信番号が「0x00000000000000c7」と「0x00000000000000cc」のリクエストのレスポンスタイムを比較すると，「0x00000000000000c7」のリクエストの方が処理に時間が掛かっていることがわかります。

3.3.2　アプリケーションサーバ内でのリクエストの処理状況の調査

ここでは，Webサーバがクライアントから受けたリクエストがアプリケーションサーバで処理されているかどうか調査する方法を，例を使用して説明します。

次に示すWebサーバで収集した性能解析トレースファイルから，2004/2/5 16:32:31にリクエストを受け付けたことがわかります。

図3-3　 Webサーバで収集した性能解析トレースファイルの例

このリクエストのルートアプリケーション情報をキーにして，アプリケーションサーバで収集した性能解析トレースファイルを調査します。

「RootAP IP：10.209.13.123」，「RootAP ID：2200」，および「RootAP CommNo.：0x00000000000000c7」をキーにして，アプリケーションサーバで収集した性能解析トレースファイルをフィルタリングした例を次に示します。

図3-4　アプリケーションサーバで収集した性能解析トレースファイルをフィルタリングした例

このようにアプリケーションサーバで収集した性能解析トレースファイルを，ルートアプリケーション情報をキーにフィルタリングすると，アプリケーションサーバ内でのリクエストの一連の処理を調査できます。

3.3.3　セッションのライフサイクルの調査

ここでは，性能解析トレースを利用したセッションのライフサイクルの調査方法について説明します。

セッションのライフサイクルは，PRFトレース取得レベルを「詳細」に設定している場合に出力されるトレース（セッショントレース）を利用して調査できます。

セッショントレース情報は，出力された性能解析トレースファイルのセッションIDまたはグローバルセッションID（セッションフェイルオーバ機能を使用している場合）をキーにして調査できます。

セッションIDは，セッショントレース情報として出力されたイベントのオプション領域に，次の形式で出力されます。

セッション文字数:セッションID

例えば，「abc123」というセッションIDの場合，オプション領域には「6:abc123」と出力されます。セッションIDが空文字の場合は，セッション文字数として「0:」と出力されます。セッションIDを取得できなかった場合は，何も出力されません。

グローバルセッションIDの場合も同様の形式で出力されます。

また，特定のイベントのセッションIDは，リクエストヘッダのCookieまたはURL書き換えをした場合のURLから取得されます。どちらから取得したのかは，セッションIDの末尾に出力された文字から確認できます。Cookieから取得した場合は，これらのイベントで出力されるセッションIDに続いて「C」が出力されます。URLから取得した場合は，セッションIDに続いて「U」が出力されます。セッションIDの取得元が確認できるイベントを，次に示します。

0x8000（リクエスト処理要求取得後）

0x8002（WebコンテナからHTTPリクエストボディ要求受信）

0x8102（WebコンテナへのHTTPリクエストボディ送信受信）

0x8200（Webサーバ経由のリクエスト取得およびリクエストヘッダ解析完了）

セッショントレース情報が出力されている性能解析トレースファイルの例を次の図に示します。この例は，一つのセッションの有効期間内での，セッションを生成するリクエスト，セッションを利用するリクエスト，およびセッションを破棄するリクエストのトレース情報を出力したものです。また，ここでは，セッションを生成するリクエスト，セッションを利用するリクエスト，およびセッションを破棄するリクエストを分けて示します。実際はこれら三つの出力例は，続けて出力されます。また，これらの画面では，セッショントレースに関係ない出力項目は表示していません。

図3-5　セッショントレース情報が出力されている性能解析トレースファイルの例（セッションを生成するリクエスト部分）

イベント「0x8208」のASCIIの列に，生成されたセッションIDが出力されます。オペレーション列の60は，セッションの有効期間を示します。

イベント「0x8300」のASCIIの列に，生成されたグローバルセッションIDが出力されます。

図3-6　セッショントレース情報が出力されている性能解析トレースファイルの例（セッションを利用するリクエスト部分）

リクエストヘッダのCookieから取得したセッションIDであることを示しています。

図3-7　セッショントレース情報が出力されている性能解析トレースファイルの例（セッションを破棄するリクエスト部分）

イベント「0x8209」のASCII列に，破棄したセッションのセッションIDが出力されます。オペレーション列は，破棄したセッションの生成時刻を示します。

グローバルセッションが破棄されていることを示します。破棄されたグローバルセッションIDは出力されません。

このトレースファイルで確認できることについて説明します。

セッションの有効期間の確認

セッション生成時には，イベント「0x8208」が出力されます。セッション破棄時には，イベント「0x8209」が出力されます。これらの取得時刻から，セッションの有効範囲を確認できます。また，イベント「0x8208」では，オペレーション名から生成されたセッションの有効期間（秒）も確認できます。

セッションIDは，セッションを破棄するリクエスト内のイベント「0x8209」でセッションが破棄されるまで，同じIDが出力されます。なお，イベント「0x8209」のオペレーション名から破棄されたセッションの生成時刻も確認できます。

グローバルセッションの有効期間の確認

グローバルセッションの有効期間は，出力されたグローバルセッションIDを基に確認できます。グローバルセッションIDとは，セッションフェイルオーバ機能を使用している場合に，冗長化されたJ2EEサーバ間で引き継がれたセッションが一意であることを示すためのIDです。詳細は，マニュアル「Cosminexus　機能解説」のセッションフェイルオーバによるセッション情報の引き継ぎに関する説明を参照してください。

グローバルセッションIDが生成されている場合，特定のトレース取得ポイントでセッションIDに続けてグローバルセッションIDが出力されます。

図3-5の場合，セッションを生成するリクエスト内のイベント「0x8300」のタイミングでグローバルセッションIDが生成されて，そのIDが出力されています。グローバルセッションIDは，セッションを破棄するリクエスト内のイベント「0x8209」でリクエスト処理が完了するまで，同じIDが出力されます。

3.3.4　タイムアウトが発生したトランザクションの特定

ここでは，J2EEアプリケーションまたはバッチアプリケーションのトランザクションがタイムアウトした場合に，性能解析トレースの情報を利用してタイムアウトしたトランザクションを特定する方法について説明します。

ここでは，次の2種類の方法について説明します。

メッセージを利用した特定方法

性能解析トレースファイルの出力内容による特定方法

＜この項の構成＞

(1)　メッセージを利用した特定方法

(2)　性能解析トレースファイルの出力内容による特定方法

(1)　メッセージを利用した特定方法

トランザクションでタイムアウトが発生した場合，メッセージKDJE31002-W，およびKDJE50080-Wが出力されます。これらのメッセージには，次の情報が出力されます。

KDJE31002-W

トランザクションを開始したJ2EEアプリケーション名，またはバッチアプリケーションのクラス名

トランザクションを開始したJ2EEコンポーネント（Enterprise Bean，サーブレットまたはJSP）のクラス名とインスタンスのハッシュコード

保守情報

性能解析トレースのルートアプリケーション情報

メッセージに出力された性能解析トレースのルートアプリケーション情報を，性能解析トレースファイルに出力されたルートアプリケーション情報と突き合わせて確認することで，性能解析トレース中のどこでトランザクションタイムアウトが発生したかを確認できます。

また，その前後のトレース情報を確認して，タイムアウトが発生したトランザクションでの処理内容を確認できます。

KDJE50080-W

IPアドレス，プロセスID，ルートアプリケーション情報

SQLを実行したコネクションのコネクションID

SQLを実行したメソッド名

SQLを実行したメソッドが実行中かどうか

最後に実行されたSQL

メッセージに出力されたSQLの情報を参照することで，タイムアウトが発生した原因となった個所を調査できます。

なお，メッセージの詳細については，マニュアル「Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編」を参照してください。

(2)　性能解析トレースファイルの出力内容による特定方法

性能解析トレースファイルには，トランザクションタイムアウトが発生する直前と直後のトレース取得ポイントで，トレース情報が出力されています。

次のイベントIDの処理内容を確認してください。

表3-6　トランザクションタイムアウト時に出力される性能解析トレース

イベントID | 説明
0x8819 | トランザクションタイムアウトの直前の処理で出力される情報です。インタフェース名に，タイムアウトするトランザクションのルートアプリケーション情報が出力されます。
0x8820 | トランザクションタイムアウトの直後の処理で出力される情報です。
0x8C41 | 障害調査用SQLが出力されたときに出力される情報です。

3.3.5　タイムアウトが発生したリクエストの特定

ここでは，リダイレクタでのレスポンス受信時にタイムアウトが発生した場合に，性能解析トレースを利用してタイムアウトが発生したリクエストを特定する方法について説明します。

リダイレクタでのレスポンス受信時にタイムアウトが発生した場合，メッセージKDJE41019-Eが出力されます。このメッセージには，次の情報が出力されます。

リクエストのURI

Webサーバとの通信に使用するWebコンテナが動作するホストのIPアドレス

Webサーバとの通信に使用するWebコンテナのポート番号

Webサーバとの通信に使用するWebコンテナのファイルディスクリプタ

性能解析トレースのルートアプリケーション情報

メッセージに出力された性能解析トレースのルートアプリケーション情報を，性能解析トレースファイルに出力されたルートアプリケーション情報と突き合わせて確認することで，性能解析トレース中のどこでリクエストのタイムアウトが発生したかを確認できます。

タイムアウトが発生したリクエストは，該当するルートアプリケーション情報を出力しているリクエスト処理内の，次の表に示すイベントIDのトレース情報で確認できます。オペレーション名に出力されているURIで，該当するリクエストを特定してください。

表3-7　タイムアウトしたリクエストを確認するために使用できる性能解析トレース

イベントID
説明

0x8000
リクエスト処理要求の取得後に出力された情報です。
オペレーション名として，リクエストのURIが出力されます。

0x8100
リダイレクタ処理の完了後に出力された情報です。
オペレーション名として，リクエストのURIが出力されます。

3.3.6　ルートアプリケーション情報を利用したログ調査

J2EEアプリケーションまたはバッチアプリケーション内でCosminexusのAPIを使用すると，性能解析情報のルートアプリケーション情報の文字列表現を任意のタイミングでログファイルに出力できます。

ルートアプリケーション情報の文字列表現は，次の形式で出力されます（最大48文字）。

IPアドレス/プロセスID/通信番号
（例：10.209.15.130/1234/0x0000000000000001）

APIを使用してログファイルにルートアプリケーション情報を出力すると，ログファイルと性能解析トレースファイルを突き合わせた調査ができるようになります。

Webコンテナでは，新しいリクエストを受け付けた時点で，リクエスト単位で新しいルートアプリケーション情報が割り当てられます。新しいルートアプリケーション情報が割り当てられるトレースポイントを次に示します。

表3-8　新しいルートアプリケーション情報が割り当てられるトレースポイント

条件 | イベントID（処理内容） | 処理内容
インプロセスHTTPサーバを使用している場合 | 0x8211 | リクエスト取得時，リクエストヘッダ解析完了時
Webサーバと連携している場合※ | 0x8200 | リクエスト取得時，リクエストヘッダ解析完了時

注※　Webサーバと連携している場合，リダイレクタで取得したルートアプリケーション情報が割り当てられます。リダイレクタまたはリダイレクタが使用するPRFデーモンに異常が発生して，ルートアプリケーション情報が発行されなかった場合，Webコンテナで新しいルートアプリケーション情報が割り当てられます。

また，次のトレース取得ポイントでは，「IPアドレス/プロセスID/通信番号」が「0.0.0. 0/0/0x0000000000000000」と出力されることがあります。

0x8212
インプロセスHTTPサーバ使用時のWebクライアントからのデータ読み込み開始時

0x8312
インプロセスHTTPサーバ使用時のWebクライアントへのデータ書き込み開始時

「IPアドレス/プロセスID/通信番号」が「0.0.0. 0/0/0x0000000000000000」と出力されるのは，次の場合です。

HTTPリクエストヘッダを受信した場合

HTTPリクエストではない，不正なデータを受信した場合

リクエスト処理中に例外が発生した場合

なお，ルートアプリケーション情報の文字列表現での出力に使用するAPIは，com.hitachi.software.ejb.application.prfパッケージで提供されている，CprfTraceクラスのgetRootApInfoメソッドです。

J2EEアプリケーションまたはバッチアプリケーション開発時のルートアプリケーション情報の取得の実装については，マニュアル「Cosminexus　機能解説」の，性能解析トレースのルートアプリケーション情報の取得のための実装に関する説明を参照してください。APIの詳細については，マニュアル「Cosminexus　リファレンス　API編」を参照してください。

3.3.7　トラブルが発生したコネクションの特定

データベースとしてHiRDBまたはOracleを使用している場合，性能解析トレースファイルに出力されたコネクションIDと，Cosminexus DABroker LibraryやHiRDBクライアントおよびOracleクライアントのログファイルやトレースファイルに出力されたコネクションIDを突き合わせて確認することで，トラブルが発生したコネクションを確認できます。確認方法については，「付録C　データベースと接続中にトラブルが発生したコネクションの特定」を参照してください。

3.3.8　性能解析トレースファイルとスレッドダンプを対応づけた問題個所の調査

J2EEアプリケーションまたはバッチアプリケーションでスローダウンやハングアップが発生したときに，性能解析トレースファイルとスレッドダンプを対応づけることで，問題が発生した個所を調査できます。

性能解析トレースファイルとスレッドダンプの対応づけには，性能解析トレースファイルに出力されたスレッドIDと，スレッドダンプに出力されたスレッド情報のnativeID（OSレベルのスレッドID）を使用します。ここでは，性能解析トレースファイルから対応するスレッドダンプを特定する方法について説明します。

性能解析トレースファイルから対応するスレッドダンプを特定する手順を次に示します。

性能解析トレースファイル，およびスレッドダンプを収集します。
性能解析トレースファイルの収集方法については，「3.2.1　性能解析トレースファイルの収集方法」を参照してください。スレッドダンプの収集方法については，「5.4.5　JavaVMのスレッドダンプの取得」を参照してください。

使用する性能解析トレースファイル，およびスレッドダンプを選びます。
性能解析トレースファイルとスレッドダンプが出力された時刻を基に，調査に使用する性能解析トレースファイル，およびスレッドダンプを選びます。出力された時刻は，次の情報を参考にしてください。

性能解析トレースファイル

「Time」および「Time(msec/usec/nsec)」

性能解析トレースファイルの「Time」および「Time(msec/usec/nsec)」を次の図に示します。

スレッドダンプ

ファイル名，およびファイルの末尾に出力される時刻

ファイルの末尾に出力される時刻の例を次に示します。

　：
　：
Full thread dump completed.   Fri Jul 21 19:22:47 2006

性能解析トレースファイルの調査したいイベントIDに対応する「Thread（hashcode）」のスレッドID（10進数）を16進数に変換します。

スレッドダンプの「nid」が手順.3で16進数に変換したスレッドIDと一致するスレッド情報を探して，対応するスレッド情報を特定します。

　：
　：
"VBJ ThreadPool Worker" daemon prio=5 jid=0x00054f93 tid=0x04cef380 nid=0x1124 in Object.wait() [0x0632f000..0x0632fd18]
 stack=[0x06330000..0x062f5000..0x062f1000..0x062f0000]
 [user cpu time=0ms, kernel cpu time=15ms] [blocked count=1, waited count=29]
at java.lang.Object.wait(Native Method)
　：
　：

4.　J2EEアプリケーションとリソースの管理

この章では，J2EEサーバ上で動作するJ2EEアプリケーション，およびJavaBeansリソースの管理について説明します。また，クラスタ構成のデータベースを管理する方法について説明します。

J2EEアプリケーションの管理では，運用状況に合わせてJ2EEアプリケーションの設定を変更したり，サービスの提供方法やシステムのメンテナンスに応じてJ2EEアプリケーションを開始・停止したり，入れ替えたりします。リクエスト処理が終了しない場合には，必要に応じてキャンセルもできます。

＜この章の構成＞

4.1　J2EEアプリケーションとリソースの管理の概要

4.2　Webアプリケーションの最大同時実行スレッド数の動的変更

4.3　CTMのスケジュールキューの稼働状況の確認と最大同時実行数の変更

4.4　J2EEアプリケーションの実行時間の監視とキャンセル

4.5　J2EEアプリケーションの閉塞と停止

4.6　J2EEアプリケーションの入れ替えと保守

4.7　JavaBeansリソースの入れ替え

4.8　クラスタコネクションプールの運用

4.1　J2EEアプリケーションとリソースの管理の概要

J2EEアプリケーションの管理では，運用状況に合わせてJ2EEアプリケーションの設定を変更したり，サービスの提供方法やシステムのメンテナンスに応じてJ2EEアプリケーションを開始，停止したり，入れ替えたりします。

J2EEアプリケーションの管理の作業について，次の表に示します。

表4-1　アクセス状況に応じたWebアプリケーションの最大同時実行数の動的変更

作業内容 | 手段 | 作業概要 | 参照先
Webアプリケーションの稼働状況の確認 | 運用管理コマンド（mngsvrutil） | その時点のWebアプリケーションの稼働状況を確認します。 | 4.2.1
Webアプリケーションの最大同時実行スレッド数の設定変更 | 運用管理コマンド（mngsvrutil） | Webアプリケーションの同時実行スレッド数を動的に変更します。 | 4.2.2

表4-2　 CTMのスケジュールキューの稼働状況の確認と同時実行数の変更

作業内容 | 手段 | 作業概要 | 参照先
CTMのスケジュールキューの稼働状況の確認 | 運用管理コマンド（mngsvrutil） | CTMのキューに接続されたJ2EEアプリケーションに関する情報を確認します。 | 4.3.1
CTMのスケジュールキューの同時実行数の変更 | CTMのコマンド（ctmchpara） | J2EEアプリケーション（Enterprise Bean）の同時実行数をスケジュールキュー単位で動的に変更します。 | 4.3.2

表4-3　J2EEアプリケーションの実行時間の監視とキャンセル

作業内容 | 手段 | 作業概要 | 参照先
J2EEアプリケーションの実行状態の確認 | サーバ管理コマンド（cjlistthread） | 実行中のJ2EEアプリケーションの実行状態を確認します。 | 4.4.1
タイムアウトが発生したリクエストのキャンセル | サーバ管理コマンド（cjstopthread） | J2EEアプリケーション内で実行されているリクエストのうち，終了しないリクエストをキャンセルします。 | 4.4.2

表4-4　J2EEアプリケーションの閉塞

作業内容
手段
作業概要
参照先

負荷分散機を使用したサービス閉塞
負荷分散機の機能
Webフロントに負荷分散機を使用している場合に，次の方法でサービスを閉塞します。

負荷分散機のリクエストの振り分け先を変更する

負荷分散機を停止する

サービスを構成する一部のWebアプリケーションだけを停止する

4.5.3

CTMを利用したサービス閉塞
運用管理コマンド（mngsvrutil）
CTMを使用しているバックシステムで，ホスト内のJ2EEアプリケーションを一度に停止したり，キューを共有するJ2EEアプリケーションを一度に停止したりする場合，J2EEアプリケーションのスケジュールキューに対して直接閉塞を実行します。
4.5.4

表4-5　J2EEアプリケーションの停止

作業内容 | 手段 | 作業概要 | 参照先
J2EEアプリケーションの停止 | サーバ管理コマンド（cjstopapp） | J2EEアプリケーションを通常停止，または強制停止します。通常停止にタイムアウトを設定して，強制停止を自動で実行することもできます。 | 4.5.5

表4-6　J2EEアプリケーションの入れ替えと保守

作業内容 | 手段 | 作業概要 | 参照先
J2EEアプリケーションの通常入れ替え | サーバ管理コマンド（cjstopapp，cjimportapp） | J2EEアプリケーションを停止してから新しいアプリケーションに入れ替えます。入れ替え後，J2EEアプリケーションを再開始します。 | 4.6.1
リデプロイによるJ2EEアプリケーションの入れ替え | サーバ管理コマンド（cjreplaceapp） | リデプロイによってJ2EEアプリケーションを入れ替えます。アーカイブ形式のJ2EEアプリケーションを入れ替える場合に，少ない手順で入れ替えることができます。 | 4.6.2
リロードによるJ2EEアプリケーションの入れ替え | サーバ管理コマンド（cjreloadapp） | リロードによってJ2EEアプリケーションを入れ替えます。展開ディレクトリ形式のJ2EEアプリケーションを入れ替える場合に，少ない手順で入れ替えることができます。 | 4.6.3
JSPを事前にコンパイルしてから実行するJ2EEアプリケーションの入れ替え | サーバ管理コマンド（cjstartapp）／cjjspcコマンド | JSP事前コンパイル機能を使用して，JSPを事前にコンパイルしてからJ2EEアプリケーションを入れ替えます。 | 4.6.4
J2EEアプリケーションの名称変更 | サーバ管理コマンド（cjrenameapp） | 名称を変更して，入れ替え前や入れ替え後のJ2EEアプリケーションを管理しやすくします。 | 4.6.5
CTMを利用したオンライン状態でのJ2EEアプリケーションの入れ替え | 運用管理コマンド（mngsvrutil） | スケジュールキューの出口を閉じたあと，J2EEアプリケーションを入れ替えます。 | 4.6.6
テストモードでのJ2EEアプリケーションの運用 | サーバ管理コマンド（cjimportapp，cjstartapp） | 本番環境で問題なくJ2EEアプリケーションが動作するかを確認するためのテストモードで，J2EEアプリケーションを運用します。 | 4.6.7

表4-7　 JavaBeansリソースの入れ替え

作業内容 | 手段 | 作業概要 | 参照先
JavaBeansリソースの入れ替え | サーバ管理コマンド（cjdeletejb，cjimportjb） | JavaBeansリソースを入れ替えます。 | 4.7

表4-8　クラスタ構成のデータベースのメンテナンス

作業内容 | 手段 | 作業概要 | 参照先
コネクションプールの状態の確認 | サーバ管理コマンド（cjlistrar） | クラスタ構成のデータベースをメンテナンスする前，およびメンテナンスしたあとに，コネクションプールの状態を確認します。 | 4.8.1
コネクションプールの一時停止 | サーバ管理コマンド（cjsuspendpool） | コネクションプールを一時停止します。 | 4.8.2
コネクションプールの再開 | サーバ管理コマンド（cjresumepool） | コネクションプールを再開します。 | 4.8.3

注意

SFOサーバ上で動作するSFOサーバアプリケーションは，サーバ管理コマンドを利用して直接操作しないでください。

4.2　Webアプリケーションの最大同時実行スレッド数の動的変更

Cosminexusを使用して構築したシステムでは，Webアプリケーション単位の最大同時実行スレッド数，占有スレッド数，および実行待ちキューサイズを，サービスを停止しないで動的に変更できます。Webアプリケーション単位の最大同時実行スレッド数，占有スレッド数，および実行待ちキューサイズは，運用管理コマンド（mngsvrutil）を使用して変更します。

Webアプリケーション単位の最大同時実行スレッド数を変更すると，次のような局面に対応できます。

Webアプリケーション単位の稼働状態でのパフォーマンスチューニング
クライアントにサービスを提供しながらパフォーマンスをチューニングできます。

アクセス状況に応じた一時的なWebアプリケーション単位の最大同時実行スレッド数の変更
アクセス状況に応じて，特定のWebアプリケーションの最大同時実行スレッド数を一時的に増加または減少させたい場合に，対処できます。

時間帯に応じた計画的なWebアプリケーション単位の最大同時実行スレッド数の変更
時間帯に応じて，Webアプリケーションの最大同時実行スレッド数を計画的に増加または減少させたい場合に，対処できます。

なお，ここで設定した項目は，サービスを停止すると無効になり，設定内容はJ2EEサーバに保存されません。また，この方法で動的に変更できるのは，Webアプリケーションについての情報だけです。Webコンテナについての設定を変更する場合は，J2EEサーバを再起動しないと有効になりません。

参考

Webコンテナ単位の最大同時実行スレッド数を変更したい場合，また，Webアプリケーションの最大同時実行スレッド数を一時的ではなく恒常的に変更したい場合は，システムの構築時と同じ手順で設定してください。Webコンテナでの最大同時実行スレッド数の制御の設定については，マニュアル「Cosminexus　システム構築ガイド」の同時実行スレッド数の設定に関する説明を参照してください。

注意

Webアプリケーションの最大同時実行スレッド数を変更した場合，URLグループ単位の最大同時実行スレッド数や占有スレッド数との関係によっては，URLグループ単位の同時実行スレッド数制御の動作へ影響が出ることがあります。URLグループ単位の同時実行スレッド数制御への影響については，マニュアル「Cosminexus　機能解説」を参照してください。

Webアプリケーションの最大同時実行スレッド数を動的に変更するための準備と手順を次に示します。

準備

Webアプリケーションの最大同時実行スレッド数の動的変更は，J2EEサーバおよびWebアプリケーションを含むJ2EEアプリケーションが起動，開始されている状態で実行します。

J2EEサーバの起動，およびJ2EEアプリケーションの開始を含むシステムの起動方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

手順

次の手順で実行します。

Webアプリケーションの稼働状況を監視して，最大同時実行スレッド数を変更する必要があるかどうかを確認する（4.2.1参照）
運用管理コマンドを使用して実行します。

必要と判断した場合，Webアプリケーションの最大同時実行スレッド数を変更する（4.2.2参照）
運用管理コマンドを使用して実行します。

Webアプリケーションの稼働状況を確認して，改善されたことを確認する（4.2.1参照）
運用管理コマンドを使用して実行します。

＜この節の構成＞

4.2.1　Webアプリケーションの稼働状況の確認

4.2.2　Webアプリケーションの最大同時実行スレッド数の設定変更

4.2.3　最大同時実行スレッド数を動的に変更したときのWebアプリケーションの動作

4.2.1　Webアプリケーションの稼働状況の確認

稼働中のWebアプリケーションの稼働状況を確認します。Webアプリケーションの稼働状況は，運用管理コマンド（mngsvrutil）で確認できます。確認した結果，例えば，次のような場合には，最大同時実行スレッド数を変更することを検討してください。

稼働スレッド数に比べて実行待ちスレッド数が極端に多い状況を想定していない場合に，稼働スレッド数に比べて実行待ちスレッド数が極端に多いとき

実行待ちリクエスト数の現在値が実行待ちリクエスト数の最大値に近づいている状況を想定していない場合に，実行待ちリクエスト数の現在値が，実行待ちリクエスト数の最大値に近づいているとき

実行待ちキューからリクエストがあふれる状況を想定していない場合に，実行待ちキューからリクエストがあふれているとき

なお，監視した結果，一時的にではなく恒常的に最大同時実行スレッド数を変更する必要があると判断した場合は，動的変更をするのではなく，Webアプリケーションを停止して，最大同時実行スレッド数の設定をし直してください。Webアプリケーションを停止した状態でのWebコンテナでの最大同時実行スレッド数の制御の設定については，マニュアル「Cosminexus　システム構築ガイド」の同時実行スレッド数の設定に関する説明を参照してください。

Webアプリケーションの稼働状況を確認するには，mngsvrutilコマンドに，サブコマンド「get」を指定して実行します。

実行形式および実行例を次に示します。なお，mngsvrutilコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <ホスト名> -k host get webApps

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host get webApps

コマンドの実行結果は，標準出力またはファイルに出力されます。

Webアプリケーションの稼働情報のうち，Webアプリケーションの最大同時実行スレッド数を変更する場合に参考になる情報は，次に示すヘッダ情報の項目で確認できます。なお，N秒とは，運用監視で設定しているサンプリング時間です。

表4-9　 Webアプリケーションの最大同時実行スレッド数を変更する場合に参考になる情報

ヘッダ情報 | 内容
contextRoot | Webアプリケーションのコンテキストルート。
exclusiveThreadCountUpperBound | Webアプリケーションの占有スレッド数。
activeThreadCountUpperBound | Webアプリケーションの最大同時実行スレッド数。
waitingRequestCountUpperBound | Webアプリケーションの実行待ちキューサイズ。
currentThreadCountUpperBound | Webアプリケーションの同時実行可能スレッド数の上限値。
activeThreadCount | 稼働スレッド数の現在値。
activeThreadCountPeak | 稼働スレッド数のN秒ピーク。
activeThreadCountAverage | 稼働スレッド数のN秒平均値。
activeThreadCountHightWaterMark | 稼働スレッド数の最大値。
activeThreadCountLowWaterMark | 稼働スレッド数の最小値。
waitingRequestCount | 実行待ちリクエスト数の現在値。
waitingRequestCountPeak | 実行待ちリクエスト数のN秒ピーク。
waitingRequestCountAverage | 実行待ちリクエスト数のN秒平均値。
waitingRequestCountHighWaterMark | 実行待ちリクエスト数の最大値。
waitingRequestCountLowWaterMark | 実行待ちリクエスト数の最小値。
overflowRequestCount | 実行待ちキューからあふれたリクエスト数。

4.2.2　Webアプリケーションの最大同時実行スレッド数の設定変更

稼働状況を確認したWebアプリケーションの次の項目を，必要に応じて変更します。

最大同時実行スレッド数

占有スレッド数

実行待ちキューサイズ

これらの項目は，運用管理コマンド（mngsvrutil）を使用して変更できます。ここで設定した値は，Webアプリケーションを停止するまで有効です。

注意

Webアプリケーションの最大同時実行スレッド数の動的変更実行中（mngsvrutilコマンドにサブコマンド「change」を指定して実行している間）は，J2EEアプリケーションのデプロイおよびアンデプロイは実行しないでください。

Webアプリケーションの最大同時実行スレッド数を動的に変更するには，mngsvrutilコマンドに，サブコマンド「change」を指定して実行します。

実行形式を次に示します。なお，mngsvrutilコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <ホスト名> -k host change webAppThreadCtrl <Webアプリケーションのコンテキストルート> <最大同時実行スレッド数>,<占有スレッド数>,<実行待ちキューサイズ>

次に，実行例を示します。この例では，次の表に示すように設定を変更します。なお，Webアプリケーションの名称は，「WebAP1」とします。

表4-10　 Webアプリケーション（WebAP1）の最大同時実行スレッド数の動的変更の設定例

設定対象 | 設定項目 | 変更前の設定値 | 変更後の設定値
Webコンテナ | 最大同時実行スレッド数 | 10 | 10（変更できません）
Webアプリケーション（WebAP1） | 最大同時実行スレッド数 | 7 | 8
占有スレッド数 | 4 | 5
実行待ちキューサイズ | 8 | 10

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host change webAppThreadCtrl "WebAP1" 8,5,10

設定内容は，コマンド実行後，すぐに反映されます。

4.2.3　最大同時実行スレッド数を動的に変更したときのWebアプリケーションの動作

ここでは，Webアプリケーションの最大同時実行スレッド数を動的に変更したときのWebアプリケーションの動作について説明します。

＜この項の構成＞

(1)　最大同時実行スレッドを変更したことによる動作

(2)　占有スレッド数を変更したことによる動作

(3)　実行待ちキューサイズを変更したことによる動作

(1)　最大同時実行スレッドを変更したことによる動作

最大同時実行スレッド数を変更した場合，Webアプリケーションは次のように動作します。

最大同時実行スレッド数を増やした場合

実行待ち状態だったリクエストのうち，実行可能になったリクエストが直ちに実行されます。

例えば，設定変更によって最大同時実行スレッド数を7から8に変更した場合に，実行待ちキューにリクエストがあったときには，実行待ちキューのリクエストの一つがすぐに実行されることになります。

最大同時実行スレッド数を減らした場合

実行可能な最大同時実行スレッド数が減少されます。

ただし，最大同時実行スレッド数のスレッドをすべて使用している状態で設定を変更しようとした場合，実行中のスレッド数は減らないため，一時的に最大同時実行スレッド数を超える数のスレッドが実行されます。

例えば，設定変更によって最大同時実行スレッド数を8から7に変更した場合に，その時点で使用されているスレッド数が8個あったときは，一時的に設定変更後の最大同時実行スレッド数を超える8個のスレッドが実行されます。

稼働中のスレッドの一つが終了したときにスレッド数が減らされ，以降は設定値どおり，最大で7個のスレッドが同時実行されるようになります。

(2)　占有スレッド数を変更したことによる動作

占有スレッド数を変更した場合，Webアプリケーションは次のように動作します。

占有スレッド数を増やした場合

実行待ち状態だったリクエストのうち，該当するWebアプリケーションの占有スレッド数が増えたことで実行可能になったリクエストが，直ちに実行されます。

また，アクセスのピーク時など，Webコンテナ単位の最大同時実行スレッド数に設定されているスレッド数をすべて使用している状態で特定のWebアプリケーションの占有スレッド数を増やした場合，そのWebアプリケーションの実行待ちキューにリクエストがあるときには，実行待ちキューのリクエストがすぐに実行されます。これによって，一時的に，Webコンテナ単位の最大同時実行スレッド数を超える数のスレッドが実行されることがあります。

例えば，Webコンテナ単位の最大同時実行スレッド数が10で，WebアプリケーションであるWebAP1とWebAP2でそれぞれ7個と3個のスレッドを使用している状態でWebAP1の占有スレッド数を8に変更した場合，一時的にWebコンテナ単位で11個のスレッドが実行されます。

占有スレッド数を減らした場合

特定のWebアプリケーションの占有スレッド数を減らすことで，Webコンテナ単位で共有されるスレッド数が増加します。実行待ちキューのリクエストのうち，共有スレッド数が増えることで実行可能になったスレッドがある場合は，直ちに実行されます。

(3)　実行待ちキューサイズを変更したことによる動作

実行待ちキューサイズを変更した場合，Webアプリケーションは次のように動作します。

実行待ちキューサイズを増やした場合

実行待ちキューサイズが直ちに増やされます。

実行待ちキューサイズを減らした場合

実行待ちキューで待っているリクエストの数よりも少ない値に実行待ちキューサイズを変更した場合，実行待ちキューサイズを超えるリクエストはHTTP 503エラーとして返却されます。

4.3　CTMのスケジュールキューの稼働状況の確認と最大同時実行数の変更

ここでは，CTMのスケジュールキューの稼働状況を確認する方法，およびJ2EEアプリケーションの最大同時実行数をスケジュールキュー単位で動的に変更する方法について説明します。J2EEアプリケーションの最大同時実行数の変更では，J2EEアプリケーションの内容によって，同時実行数を一時的に増加させたり減少させたりできます。

CTMのスケジュールキューの稼働状況の確認をするには，「4.3.1　CTMのスケジュールキューの稼働状況の確認」を参照してください。また，J2EEアプリケーションの最大同時実行数をCTMスケジュールキュー単位で動的に変更する場合は，「4.3.2　CTMのスケジュールキューの同時実行数の変更」を参照してください。

＜この節の構成＞

4.3.1　CTMのスケジュールキューの稼働状況の確認

4.3.2　CTMのスケジュールキューの同時実行数の変更

4.3.1　CTMのスケジュールキューの稼働状況の確認

ここでは，CTMのスケジュールキューの稼働状況を確認する方法について説明します。CTMのスケジュールキューの稼働状況は運用管理コマンド（mngsvrutil）を使用して確認できます。

CTMのスケジュールキューの稼働状況を確認するには，運用管理コマンドのサブコマンド「get」の引数に，「queueApps」を指定して実行します。コマンドを実行すると，J2EEアプリケーション開始時の同時実行数，J2EEアプリケーションに対する現在の常駐スレッド数などの情報が取得できます。

次に，実行形式と実行例を示します。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <論理サーバ名> get queueApps

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t myServer get queueApps

mngsvrutilコマンド，そのサブコマンド，および取得できる情報の詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

4.3.2　CTMのスケジュールキューの同時実行数の変更

J2EEアプリケーションの同時実行数をスケジュールキュー単位で動的に変更する方法について説明します。

J2EEアプリケーションの最大同時実行数をCTMスケジュールキュー単位で動的に変更する作業は次の流れで行います。

現在のCTMのスケジュールキューの同時実行数を確認する
CTMのコマンド（ctmlsque）を使用して実行します（「(1)　CTMのスケジュールキューの稼働状況の確認」参照）。

CTMのスケジュールキューの同時実行数を変更する
CTMのコマンド（ctmchpara）を使用して実行します（「(2)　CTMのスケジュールキューの同時実行数の変更」参照）。

変更後のCTMのスケジュールキューの同時実行数を確認する
CTMのコマンド（ctmlsque）を使用して実行します（「(1)　CTMのスケジュールキューの稼働状況の確認」参照）。

なお，CTMのスケジュールキューの同時実行数の変更は，スケジュールキューの状態が次の場合に実行できます。

A：スケジューリング可能状態

H：スケジューリング閉塞中

C：スケジューリング可能閉塞

＜この項の構成＞

(1)　CTMのスケジュールキューの稼働状況の確認

(2)　CTMのスケジュールキューの同時実行数の変更

(1)　CTMのスケジュールキューの稼働状況の確認

CTMのスケジュールキューの稼働状況を確認するには，ctmlsqueコマンドの引数に「-CTMAppInfo」を指定して実行します。このコマンドを実行すると，スケジュールキューを共有しているJ2EEアプリケーションの情報を確認できます。実行形式と実行例を次に示します。

実行形式

ctmlsque -CTMDomain <CTMドメイン名称> -CTMID <CTM識別子> -CTMAppInfo

実行例

ctmlsque -CTMDomain domain01 -CTMID CTM01 -CTMAppInfo

ctmlsqueコマンドの詳細，および出力される情報の詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(2)　CTMのスケジュールキューの同時実行数の変更

CTMのスケジュールキューの同時実行数を変更するには，ctmchparaコマンドを実行します。実行形式と実行例を次に示します。

実行形式

ctmchpara -CTMDomain <CTMドメイン名称> -CTMID <CTM識別子> -CTMQueue <スケジュールキュー登録名称> -CTMChangeCount <同時実行数>

実行例

ctmchpara -CTMDomain domain01 -CTMID CTM01-CTMQueue que01 -CTMChangeCount 10

実行後，変更が反映されていることを確認してください。スケジュールキューの状態を確認する方法については，「(1)　CTMのスケジュールキューの稼働状況の確認」を参照してください。

ctmchparaコマンドの詳細，および出力される情報の詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

4.4　J2EEアプリケーションの実行時間の監視とキャンセル

J2EEアプリケーションの内部で無限ループなどが発生すると，J2EEアプリケーションの動作を制御できなくなります。このようなトラブルへの対策として，J2EEアプリケーションの実行時間にタイムアウト値を設定しておき，一定時間を過ぎたら処理が完了しなくても制御が戻るように設定する方法があります。

Cosminexusで構築したシステムでは，次の2種類の機能が使用できます。

メソッドタイムアウト機能

メソッドキャンセル機能

これらの機能では，J2EEアプリケーション内のメソッド単位にタイムアウト時間を設定して監視し，一定時間内に終了しなかったリクエストのタイムアウトを検知できます（メソッドタイムアウト機能）。また，タイムアウトが発生した場合，強制的にメソッドをキャンセルできます（メソッドキャンセル機能）。このとき，トランザクションも強制決着されます。メソッドキャンセルは，自動的に実行されるように設定できます。

J2EEアプリケーションの実行時間を監視してタイムアウトが発生したリクエストを自動的にキャンセルするための設定は，サーバ管理コマンドを使用して実行します。また，J2EEアプリケーションの実行時間を監視するかどうか，および監視時間間隔は，J2EEサーバの動作設定のカスタマイズで設定します。J2EEアプリケーション実行時間の監視の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

また，J2EEアプリケーションでメソッドタイムアウトが発生した場合や，メソッドキャンセルに失敗したスレッドが存在する場合は，サーバ管理コマンドを使用して，手動でメソッドキャンセルを実行（再実行）する必要があります。

サーバ管理コマンドによってメソッドキャンセルを実行する手順を次に示します。

手順

タイムアウトが発生したことを示すメッセージ，またはスレッドの状態が不正なことを示すメッセージを受け取ったあとで，次の手順で実行します。

J2EEアプリケーションの実行状態を確認する（4.4.1参照）
サーバ管理コマンドを使用して実行します。

タイムアウトが発生している場合，J2EEアプリケーションで実行しているリクエストをキャンセルする（4.4.2参照）
サーバ管理コマンドを使用して実行します。

なお，J2EEアプリケーションを強制的に停止した場合も，メソッドはキャンセルされます。J2EEアプリケーションの強制停止についての詳細は，「4.5.5　J2EEアプリケーションの停止」を参照してください。

＜この節の構成＞

4.4.1　J2EEアプリケーションの実行状態の確認

4.4.2　タイムアウトが発生したリクエストのキャンセル

4.4.1　J2EEアプリケーションの実行状態の確認

J2EEアプリケーション内のメソッドでタイムアウトが発生したことを示すメッセージが出力された場合，またはメソッドキャンセルに失敗したことによってスレッドの状態が不正になったことを示すメッセージが出力された場合に，実行中のJ2EEアプリケーションの実行状態を確認します。確認結果によって，メソッドキャンセルを実行できるかどうかを判断します。

実行状態の確認には，サーバ管理コマンド（cjlistthread）を使用します。

なお，このコマンドは，スレッドの状態が遷移した時に取得したスタックトレースを確認する場合にも使用できます。ただし，スレッドの状態が「running」の場合は，スタックトレースは出力されません。また，スレッドの状態が「stopping」の場合は，複数回スタックトレースが出力されるため，遷移した時点のスタックトレースではなく，最新のスタックトレースが出力されます。

実行形式と実行例を次に示します。なお，cjlistthreadコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

実行形式

cjlistthread <J2EEサーバ名>

-detailオプションを指定すると，動作中のスレッド情報の詳細として，スタックトレースも出力できます。

cjlistthread <J2EEサーバ名> -detail

実行例

cjlistthread MyServer -detail

-detailオプションを指定した場合の実行結果の形式を次に示します。

実行結果

Current Time=HH:MM:SS
ThreadID=11111,RootApInfo=RootAP1,Status=timeout,AppName=AP1,StartTime=HH:MM:SS,TimeOut=60
   com.hitachi.XXXX
    at com.hitachi.YYYY
    at user.code.UserClass1
    at com.hitachi.ZZZZ
             .
             .
             .
ThreadID=22222,RootApInfo=RootAP2,Status=stopping,AppName=AP2,StartTime=HH:MM:SS,TimeOut=60
   com.hitachi.xxxx
    at com.hitachi.yyyy
    at user.code.UserClass2
    at com.hitachi.zzzz

実行結果の，「Status=」の後ろに出力されているのが，スレッドの状態です。

スレッドの状態とメソッドキャンセルの実行可否を，次の表に示します。

表4-11　スレッドの状態とメソッドキャンセルの実行可否

スレッドの状態 | 意味 | メソッドキャンセルの実行可否
running | 実行時間が監視されている状態です。正常に動作しています。 | 実行できます。
timeout | メソッドタイムアウトによって，タイムアウトが検知された状態です。 | 実行できます。
stopping | メソッドキャンセル処理が実行されている状態です。 | 実行できません。
stopped | メソッドキャンセル処理の完了待ちの状態です。 | 実行できません。
failed | メソッドキャンセル処理が失敗した状態です。 | 実行できます。

ただし，スレッドの状態がメソッドキャンセルを実行できる状態の場合でも，そのメソッドが保護区で実行されている場合は，メソッドはキャンセルできません。保護区については，マニュアル「Cosminexus　機能解説」のメソッドキャンセルに関する説明を参照してください。

ポイント

このコマンドで出力されるスレッドの情報は，cjlistthreadコマンドを実行した時点でのスナップショットです。このため，刻々と変化します。正確なスレッドの状態を取得するためには，複数回コマンドを実行して確認することをお勧めします。

また，-detailオプションを指定すると，実行結果の出力量が多くなります。-datailオプションを指定する場合は，出力先をファイルにすることをお勧めします。

4.4.2　タイムアウトが発生したリクエストのキャンセル

J2EEアプリケーションでタイムアウトが発生したリクエストをキャンセルします。この処理をメソッドキャンセルといいます。メソッドキャンセルは，「4.4.1　J2EEアプリケーションの実行状態の確認」の内容に従ってcjlistthreadコマンドを実行してスレッドの実行状態を確認した結果，メソッドキャンセルが可能な状態（running，timeoutまたはfailed）だった場合に実行してください。

メソッドキャンセルには，サーバ管理コマンド（cjstopthread）を使用します。一度のコマンド実行で，複数のスレッドのメソッドをキャンセルできます。

実行形式と実行例を次に示します。なお，cjstopthreadコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

実行形式

cjstopthread <J2EEサーバ名> -tid <スレッドID> [-tid <スレッドID>…]

実行例

cjstopthread MyServer -tid 11111

-tidオプションのオプション引数の<スレッドID>には，タイムアウトが発生したことを示すメッセージ，またはスレッドの状態が不正なことを示すメッセージに出力されていたスレッドIDを指定してください。

なお，このコマンドを実行したときに，すでにメソッドキャンセルが実行中の場合，またはメソッドキャンセルの対象に指定したスレッドが存在しない場合は，メソッドキャンセルは実行されないで，コマンドは正常終了します。コマンド実行後のスレッドの状態は，cjlistthreadコマンドで確認できます。「4.4.1　J2EEアプリケーションの実行状態の確認」に示した手順で確認してください。

4.5　J2EEアプリケーションの閉塞と停止

この節では，J2EEアプリケーションの閉塞方法と停止方法について説明します。なお，J2EEアプリケーションだけでなく，システム全体を停止させる場合の実行手順については，マニュアル「Cosminexus　簡易構築・運用ガイド」の日常運用の操作に関する説明を参照してください。

＜この節の構成＞

4.5.1　J2EEアプリケーションの停止方法の種類

4.5.2　システムごとに実行できるサービスの閉塞方法およびJ2EEアプリケーションの停止方法

4.5.3　負荷分散機を利用したサービス閉塞

4.5.4　CTMを使用したサービス閉塞

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

4.5.1　J2EEアプリケーションの停止方法の種類

J2EEアプリケーションの停止とは，J2EEアプリケーションを構成するWebアプリケーションやEnterprise Beanの終了処理を実行して，J2EEアプリケーションをクライアントからのリクエストを受け付けない状態にすることです。この状態を，停止状態といいます。そのあとで，J2EEアプリケーション自体を停止します。

J2EEアプリケーションの停止方法には，次の2種類があります。

通常停止

強制停止

それぞれについて説明します。

＜この項の構成＞

(1)　通常停止

(2)　強制停止

(1)　通常停止

日常運用の中で，J2EEアプリケーションを停止するときの停止方法です。J2EEアプリケーション内のWebアプリケーションやEnterprise Beanを順番に停止して，サービスを安全に停止させます。なお，J2EEアプリケーション内でリクエストが実行されている場合，リクエストが終了するまでJ2EEアプリケーションは停止しません。ただし，通常停止を実行するときには，タイムアウトを設定できます。タイムアウトを設定しておくと，J2EEアプリケーションが停止していない場合でも，一定時間が経過したらクライアントに制御が戻ります。

通常停止では，まず，サービスを閉塞してリクエストの受け付けを中止してから，J2EEアプリケーションを停止します。サービス閉塞とは，新しいリクエストを受け付けない状態で，すでに受け付けたリクエストを実行することです。

例えば，次のような場合に計画的にJ2EEアプリケーションを停止するときには，まず，サービス閉塞を実行してから，J2EEアプリケーションを停止します。

一日のうち特定の時間内にだけサービスを提供する場合

システムをメンテナンスする場合

(2)　強制停止

J2EEアプリケーションで処理中のリクエストが完了するのを待たないで，リクエストを強制的に停止する方法です。強制停止によって，使用されていたリソースは解放されます。

J2EEアプリケーションでトラブルが発生した場合など，クライアントに制御が戻らないときには，強制停止によってサービスが迅速に停止できるようになります。

ポイント

次の場合にはJ2EEアプリケーションの強制停止を実行できません。

ステートメントキャンセルが実行できない場合
データベースを操作している場合に実行中のSQLの処理が戻らなくなったとき，ステートメントキャンセルが実行されます。ステートメントキャンセルは，実行中のSQLの処理を取り消す処理のことです。
ただし，リソースアダプタの設定，システム構成，使用しているトランザクションの種類などによっては，ステートメントキャンセルができない場合があります。ステートメントキャンセルができない場合，SQLを実行中のトランザクションのタイムアウト，およびSQLの処理が戻らないJ2EEアプリケーションの強制停止は実行できません。
ステートメントキャンセルについては，マニュアル「Cosminexus　機能解説」のトランザクションタイムアウトに関する説明を参照してください。

メソッドキャンセルが実行できない場合
強制停止を実行すると，実行中のスレッドは，メソッドキャンセルによって予期しない場所で中断されます。このため，メソッドキャンセルの対象スレッドとほかのスレッドで更新または削除を実行する共有データがあるJ2EEアプリケーションの場合，メソッドキャンセルを使用できません。
メソッドキャンセルが実行できないJ2EEアプリケーションの構成については，マニュアル「Cosminexus　機能解説」のJ2EEアプリケーション実行時間の監視機能に関する説明を参照してください。

CTMを使用する環境で，J2EEアプリケーションのアンデプロイ時のスケジュールキューを非活性にするための設定に，タイムアウト時間として0（ゼロ）を設定した場合
CTMのスケジュールキューを非活性にするための処理のタイムアウト時間として0を設定した場合，リクエストが終了するまでCTMによる閉塞が完了しません。このため，J2EEアプリケーションを停止できなくなります。
詳細は，マニュアル「Cosminexus　機能解説」のスケジュールキューの閉塞制御に関する説明を参照してください。

4.5.2　システムごとに実行できるサービスの閉塞方法およびJ2EEアプリケーションの停止方法

サービス閉塞は，クライアントから見てリクエストの受け口になる要素（フロント）に対して実行します。フロントを閉塞すると，クライアントから新しいリクエストを受け付けることなく，すでに受け付けたJ2EEアプリケーション内のリクエストを継続実行できます。

Webフロントシステムの場合やCTMを使用したバックシステムの場合，J2EEアプリケーションのフロントに，負荷分散機，WebサーバまたはCTMなどがあります。J2EEアプリケーションを直接停止する前にこれのフロントに当たる要素を閉塞すると，確実なサービス閉塞が実行できます。

なお，サービス閉塞後に実行するJ2EEアプリケーションは，運用管理コマンド（mngsvrutil）で停止してください。

Webフロントシステム，バックシステムなどのシステムの種類の意味については，マニュアル「Cosminexus　システム設計ガイド」のCosminexusのシステム構成の分類に関する説明を参照してください。

＜この項の構成＞

(1)　Webフロントシステムでのサービス閉塞

(2)　バックシステムでのサービス閉塞（CTMを使用しているシステムの場合）

(3)　バックシステムでのサービス閉塞（CTMを使用していないシステムの場合）

(1)　Webフロントシステムでのサービス閉塞

Webフロントシステムとは，フロントエンドであるWebブラウザから送信されるリクエストを受け付けて，そのリクエストを処理するシステムです。

サービス閉塞の対象は，J2EEアプリケーション内のWebアプリケーションです。

このシステムでは，次の表に示す方法でサービス閉塞を実行できます。J2EEアプリケーションの停止を実行する前にほかの方法でサービス閉塞を実行することで，サービスを確実に閉塞できます。

表4-12　 Webフロントシステムで実行できるサービス閉塞

サービスの閉塞方法 | 説明 | 手段 | 参照先
負荷分散機のリクエストの振り分け先を変更する※ | 負荷分散機の設定を変えて，J2EEアプリケーションを停止するJ2EEサーバにリクエストを振り分けないようにします。これによって，J2EEサーバはリクエストを受け付けなくなります。 | 負荷分散機の機能 | 4.5.3
負荷分散機を停止する※ | 負荷分散機を停止して，J2EEサーバへのリクエストの転送を停止します。これによって，J2EEサーバはリクエストを受け付けなくなります。 | 負荷分散機の機能 | 4.5.3
J2EEアプリケーションを通常停止する | J2EEアプリケーションを通常停止すると，そのJ2EEアプリケーションは新たなリクエストを受け付けなくなります。ただし，実行中の処理が終了するまで，停止は完了しません。 | サーバ管理コマンド | 4.5.5

注※

負荷分散機を使用したシステムの場合に実行できます。

(2)　バックシステムでのサービス閉塞（CTMを使用しているシステムの場合）

バックシステムとは，Webフロントシステムの背後などで動作する，複数の業務システムに共通な業務サービスを実行するためのシステムです。

CTMを使用しているシステムの場合，CTMのスケジュールキューを対象にしたサービス閉塞を実行できます。

このシステムでは，次の表に示す方法でサービス閉塞を実行できます。J2EEアプリケーションの停止を実行する前に，ほかの方法でサービス閉塞を実行することで，サービスを確実に閉塞できます。

表4-13　バックシステム（CTMを使用している場合）で実行できるサービス閉塞

サービスの閉塞方法 | 説明 | 手段 | 参照先
CTMの機能を使用してサービス閉塞を実行する | CTMの機能を使用してスケジュールキューを閉塞して，J2EEサーバへのリクエストの転送を停止します。これによって，J2EEサーバはリクエストを受け付けなくなります。 | 運用管理コマンド | 4.5.4
J2EEアプリケーションを通常停止する | J2EEアプリケーションを通常停止すると，そのJ2EEアプリケーションは新たなリクエストを受け付けなくなります。ただし，実行中の処理が終了するまで，停止は完了しません。 | サーバ管理コマンド | 4.5.5

(3)　バックシステムでのサービス閉塞（CTMを使用していないシステムの場合）

CTMを使用していないバックシステムの場合，サービス閉塞の対象は，J2EEアプリケーション内のフロントのEnterprise Bean（フロントEJB）です。

このシステムでは，次の方法でサービス閉塞を実行できます。

表4-14　バックシステム（CTMを使用していない場合）で実行できるサービス閉塞

サービスの閉塞方法 | 説明 | 手段 | 参照先
J2EEアプリケーションを通常停止する | J2EEアプリケーションを通常停止すると，そのJ2EEアプリケーションは新たなリクエストを受け付けなくなります。ただし，実行中の処理が終了するまで，停止は完了しません。 | サーバ管理コマンド | 4.5.5

なお，システム構築時にあらかじめフロントEJBを定義しておく必要があります。

4.5.3　負荷分散機を利用したサービス閉塞

ここでは，負荷分散機を利用したサービス閉塞の実行方法について説明します。負荷分散機を利用したサービス閉塞は，Webフロントシステムの場合に，負荷分散機を利用しているときに実行できます。負荷分散機を利用したサービスの閉塞には，次の二つの方法があります。

通常のサービス閉塞

サービス部分閉塞

ぞれぞれの実行方法について説明します。

ポイント

負荷分散機を利用したサービス閉塞は，Smart Composer機能で負荷分散機を管理していない場合に使用します。Smart Composer機能で負荷分散機を管理している場合のサービス閉塞は，cmx_stop_targetコマンドを使用します。cmx_stop_targetコマンドについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

＜この項の構成＞

(1)　通常のサービス閉塞

(2)　負荷分散機を利用したサービス部分閉塞

(1)　通常のサービス閉塞

負荷分散機を利用した通常のサービス閉塞は，次のどちらかの方法で実行します。

負荷分散機のリクエストの振り分け先を変更する
通常使用するWebサーバのほかにサービス閉塞用のWebサーバを用意しておいて，サービス閉塞するタイミングでリクエストの振り分け先をサービス閉塞用のWebサーバに切り替える方法です。サービス閉塞用のWebサーバには，エラーページ表示の設定などをしておきます。

負荷分散機を停止する
負荷分散機を停止して，リクエストの受け付けを停止する方法です。すでにWebサーバに送られたリクエストはそのまま実行されます。

なお，サービス閉塞を解除する場合は，リクエストの振り分け先を再度変更するか，または負荷分散機を起動します。

手順については，ご使用の負荷分散機の使用方法に従ってください。

(2)　負荷分散機を利用したサービス部分閉塞

リクエストを受け付けるWebサーバ，およびリクエストを実行するJ2EEサーバを負荷分散機を使用して冗長化している構成の場合，サービス全体を停止させないで，サービスを構成する一部のWebアプリケーションだけを停止できます。この閉塞方法を，サービス部分閉塞といいます。

なお，Webアプリケーションのサービス部分閉塞ができるのは，次のような構成のシステムです。

負荷分散機を使用したシステム

WebサーバとJ2EEサーバが冗長化されていて，WebサーバとJ2EEサーバが1:1または1:Nの構成であること（Nは1以上の整数）

Webアプリケーションのサービス部分閉塞は，負荷分散機によるリクエストの振り分け先を変更して，サービスを閉塞する系にリクエストを振り分けないことで実現できます。実行方法については，負荷分散機の使用方法を確認してください。

ポイント

負荷分散機によってサービス部分閉塞を実行する場合，停止するWebサーバに対して作成されたセッションを使用したリクエストについては，セッションが切断されます。この場合，稼働中のWebサーバに対してセッションを接続し直す必要があります。ただし，セッションフェイルオーバ機能を使用している場合は，セッションの一部の情報を引き継げます。セッションフェイルオーバ機能については，マニュアル「Cosminexus　機能解説」のJ2EEサーバ間のセッション情報の引き継ぎに関する説明を参照してください。

4.5.4　CTMを使用したサービス閉塞

ここでは，CTMを使用したサービス閉塞を，運用管理コマンド（mngsvrutil）で実行する方法について説明します。

この方法は，CTMを使用しているときに実行できます。

CTMを使用しているバックシステムで，ホスト内のJ2EEアプリケーションを一度に停止したり，キューを共有するJ2EEアプリケーションを一度に停止したりする場合，J2EEアプリケーションのスケジュールキューに対して直接閉塞を実行します。そのあと，J2EEアプリケーションを停止します。

運用管理コマンドを使用してJ2EEアプリケーションのスケジュールキューを直接閉塞する場合，スケジュールキューを共有するJ2EEアプリケーション単位，ホスト単位，または運用管理ドメイン単位でJ2EEアプリケーションを一度に停止できます。また，スケジュールキューに登録済みのリクエストを破棄するか，一定時間処理を続けるかどうかを選択します。スケジュールキューに登録済みのリクエストを破棄する場合，登録済みのリクエストはすべてエラーとしてクライアントに返却されます。一定時間処理を続ける場合，時間内に終了しなかった処理はエラーとしてクライアントに返却されます。

運用管理コマンドを使用した場合のCTMを使用したサービス閉塞の実行形式および実行例について説明します。ここでは，通常の手順で閉塞する方法と，強制的に閉塞する方法について説明します。強制閉塞は，CTMデーモンの負荷が高い場合などに，すぐにキューを閉塞したいときに実行する方法です。

(a)　通常の閉塞

運用管理コマンド（mngsvrutil）を使用して通常の手順で閉塞する方法について説明します。

CTMの閉塞処理では，次の作業が実行されます。

新規リクエストの受け付けが終了されます。

スケジュールキューに格納されているリクエストのうち，すでにJ2EEサーバに振り分けられて処理中のリクエストは引き続き処理されます。

スケジュールキューに格納されているリクエストのうち，J2EEサーバへの振り分けがされていないリクエストに対しては，java.rmi.RemoteExceptionエラーが返却されます。

特定のホスト内のJ2EEアプリケーションを一括停止する場合の運用管理コマンドの実行形式と実行例を次に示します。なお，運用管理コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <ホスト名> -k host hold queues in:<リクエスト終了待ち時間（秒）>

実行例

サービス閉塞をして，すべてのリクエスト処理の完了を待つ場合
mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host hold queues in:0

サービス閉塞をして，5分間リクエストの処理を続けて，終了しないリクエストは破棄する場合
mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host hold queues in:300

サービス閉塞をして，リクエストはすぐに破棄する場合
mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host hold queues in:-1

スケジュールキューの閉塞を解除するときは，mngsvrutilコマンドにサブコマンド「release」を指定して実行します。mngsvrutilコマンドの実行形式と実行例を次に示します。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <ホスト名> -k host release queues

実行例

mngsvrutil -m mnghost01 -u user01 -p pw1 -t host01 -k host release queues

(b)　強制閉塞

強制閉塞は，CTMデーモンの負荷が高いときにすぐにキューを閉塞するための方法です。通常の閉塞方法では，キューを閉塞するときに，CTMデーモンと通信して，その処理の延長で滞留しているリクエストを破棄しています。しかし，この方法では，CTMデーモンの負荷が高い場合，通信処理に時間が掛かるため，閉塞処理にも時間が掛かってしまいます。

強制閉塞を使用すると，CTMデーモンとの通信処理をしないで，即座にキューを閉塞できます。なお，強制閉塞を使用した場合，滞留しているリクエストの破棄は，CTMデーモン間で負荷情報を監視するタイミングにあわせて実行されます。

なお，閉塞の解除方法については，通常の閉塞をした場合と同じです。コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

強制閉塞を実行する場合のmngsvrutilコマンドの実行例を次に示します。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <ホスト名> -k host hold queues force

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host hold queues force

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

ここでは，サーバ管理コマンドを使用してJ2EEアプリケーションを停止する方法について説明します。

サーバ管理コマンドを使用したJ2EEアプリケーションの停止には，次の五つの方法があります。

デフォルトのタイムアウト時間で通常停止を実行する

任意のタイムアウト時間を設定して通常停止を実行する

デフォルトのタイムアウト時間で通常停止を実行して，停止しなかった場合に強制停止を実行する

任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に強制停止を実行する

任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に自動的に強制停止を実行する

これらの方法以外の順序でコマンドを実行した場合，コマンドが異常終了します。例えば，通常停止をしない状態では，強制停止の形式でコマンドを実行できません。

また，1.，2.，または5.の処理は，一つのJ2EEアプリケーションに対してどれか1回だけ実行できます。

ただし，強制停止は，J2EEサーバの動作設定をカスタマイズして，強制停止が有効になるように設定されているシステムだけで実行できます。J2EEサーバの動作設定のカスタマイズの方法については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

J2EEアプリケーションの停止処理では，次の処理が実行されます。

J2EEアプリケーションのフロントがWebアプリケーションの場合

新規リクエストを受け付けなくなります。

処理中のリクエストは引き続き処理されます。

Webアプリケーションの同時実行数制御のキューに格納されているリクエストのうち，Webコンテナでの処理が開始されていないものに対して，HTTP503エラーが返却されます。

J2EEアプリケーションのフロントがEnterprise Beanの場合

新規リクエストを受け付けなくなります。

処理中のリクエストは引き続き処理されます。

停止後のアプリケーションに含まれているEnterprise Beanのメソッドの呼び出しはできません。停止後のアプリケーションに含まれているEnterprise Beanのメソッドを呼び出そうとすると，「stop could not lock <文字列>」というメッセージがJ2EEサーバの標準エラー出力に出力されることがありますが，問題ありません。

次に，それぞれのパターンについて，サーバ管理コマンドの実行手順を説明します。

＜この項の構成＞

(1)　デフォルトのタイムアウト時間で通常停止を実行する

(2)　任意のタイムアウト時間を設定して通常停止を実行する

(3)　デフォルトのタイムアウト時間で通常停止を実行して，停止しなかった場合に強制停止を実行する

(4)　任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に強制停止を実行する

(5)　任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に自動的に強制停止を実行する

(1)　デフォルトのタイムアウト時間で通常停止を実行する

コマンドの実行手順，実行形式および実行例を次に示します。

J2EEアプリケーションを通常停止します。
cjstopappコマンドを実行します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjstopapp Myserver -name App1

なお，デフォルトのタイムアウト時間でコマンドを実行した場合，停止処理が完了しなくても60秒後にコマンドの制御が戻ります。

コマンドの制御がタイムアウトによって戻った場合は，J2EEアプリケーションの停止状態を確認します。
タイムアウトによってコマンドの制御が戻った場合，J2EEアプリケーションの停止処理は完了していないことがあります。このため，タイムアウトが発生した場合は，J2EEアプリケーションの状態を確認してください。
J2EEアプリケーションの状態は，サーバ管理コマンドのcjlistappコマンド実行して確認します。

実行形式

cjlistapp <サーバ名称>

実行例

cjlistapp MyServer

J2EEアプリケーションの状態として，次のどれかの状態が出力されます。

表4-15　J2EEアプリケーションの状態

出力される文字列 | 状態の意味
running | 開始状態
stopped | 停止状態
stopFailure | 通常停止失敗状態
forceStopFailure | 強制停止失敗状態
blockadeFailure | 閉塞失敗状態
blockading | 閉塞中
blockaded | 閉塞状態
stopping | 通常停止中
forceStopping | 強制停止中

なお，手順の実行後，J2EEサーバの状態を確認してください。次の状態の場合は，J2EEサーバを再起動する必要があります。

閉塞失敗

通常停止失敗

(2)　任意のタイムアウト時間を設定して通常停止を実行する

コマンドの実行手順，実行形式および実行例を次に示します。

J2EEアプリケーションを通常停止します。このとき，コマンドのオプションに，コマンドの制御を戻すためのタイムアウト時間を設定します。
cjstopappコマンドに，-tオプションを指定して実行します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名> -t <タイムアウト時間>

実行例

cjstopapp MyServer -name App1 -t 120

この実行例を実行した場合，停止処理が完了しなくても120秒後にコマンドの制御が戻ります。

タイムアウトによってコマンドの制御が戻った場合は，J2EEアプリケーションの停止状態を確認します。
コマンドの制御がタイムアウトによって戻った場合，J2EEアプリケーションの停止処理は完了していないことがあります。このため，タイムアウトが発生した場合は，J2EEアプリケーションの状態を確認してください。
J2EEアプリケーションの状態は，cjlistappコマンドを実行して確認します。

実行形式

cjlistapp <J2EEサーバ名>

実行例

cjlistapp MyServer

J2EEアプリケーションの状態として出力される内容については，「(1)デフォルトのタイムアウト時間で通常停止を実行する」の手順2.を参照してください。

なお，手順の実行後，J2EEサーバの状態を確認してください。次の状態の場合は，J2EEサーバを再起動する必要があります。

閉塞失敗

通常停止失敗

(3)　デフォルトのタイムアウト時間で通常停止を実行して，停止しなかった場合に強制停止を実行する

コマンドの実行手順，実行形式および実行例を次に示します。

J2EEアプリケーションを通常停止します。
cjstopappコマンドを実行します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjstopapp MyServer -name App1

なお，デフォルトのタイムアウト時間でコマンドを実行した場合，停止処理が完了しなくても60秒後にコマンドの制御が戻ります。

タイムアウトによってコマンドの制御が戻った場合は，J2EEアプリケーションの停止状態を確認します。
コマンドの制御がタイムアウトによって戻った場合，J2EEアプリケーションの停止処理は完了していないことがあります。このため，タイムアウトが発生した場合は，J2EEアプリケーションの状態を確認してください。
J2EEアプリケーションの状態は，cjlistappコマンドを実行して確認します。

実行形式

cjlistapp <J2EEサーバ名>

実行例

cjlistapp MyServer

J2EEアプリケーションの状態として出力される内容については，「(1)デフォルトのタイムアウト時間で通常停止を実行する」の手順2.を参照してください。

J2EEアプリケーションの強制停止を実行します。
J2EEアプリケーションが通常停止で停止しなかった場合，強制停止を実行します。
cjstopappコマンドに，-cancelオプションを指定して実行します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名> -cancel

実行例

cjstopapp MyServer -name App1 -cancel

強制停止が成功すると，J2EEアプリケーションで処理中のリクエストが中止されて，先に実行していた通常停止が終了します。

なお，手順の実行後，J2EEサーバの状態を確認してください。次の状態の場合は，J2EEサーバを再起動する必要があります。

強制停止失敗

閉塞失敗

通常停止失敗

(4)　任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に強制停止を実行する

コマンドの実行手順，実行形式および実行例を次に示します。

J2EEアプリケーションを通常停止します。このとき，コマンドのオプションに，コマンドの制御を戻すためのタイムアウト時間を設定します。
cjstopappコマンドに，-tオプションを指定して実行します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名> -t <タイムアウト時間>

実行例

cjstopapp MyServer -name App1 -t 120

この実行例を実行した場合，停止処理が完了しなくても120秒後にコマンドの制御が戻ります。

タイムアウトによってコマンドの制御が戻った場合は，J2EEアプリケーションの停止状態を確認します。
コマンドの制御がタイムアウトによって戻った場合，J2EEアプリケーションの停止処理は完了していないことがあります。このため，タイムアウトが発生した場合は，J2EEアプリケーションの状態を確認してください。
J2EEアプリケーションの状態は，cjlistappコマンドを実行して，確認します。

実行形式

cjlistapp <J2EEサーバ名>

実行例

cjlistapp MyServer

J2EEアプリケーションの状態として出力される内容については，「(1)デフォルトのタイムアウト時間で通常停止を実行する」の手順2.を参照してください。

J2EEアプリケーションの強制停止を実行します。
J2EEアプリケーションが通常停止で停止しなかった場合，強制停止を実行します。
cjstopappコマンドに，-cancelオプションを指定して実行します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名> -cancel

実行例

cjstopapp Myserver -name App1 -cancel

強制停止が成功すると，J2EEアプリケーションで処理中のリクエストが中止されて，先に実行していた通常停止が終了します。

なお，手順の実行後，J2EEサーバの状態を確認してください。次の状態の場合は，J2EEサーバを再起動する必要があります。

強制停止失敗

閉塞失敗

通常停止失敗

(5)　任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に自動的に強制停止を実行する

コマンドの実行手順，実行形式および実行例を次に示します。

タイムアウト時間後に強制停止を実行する形式で，J2EEアプリケーションを停止します。
この形式では，J2EEアプリケーションをまず通常停止で停止して，指定したタイムアウト時間内に停止しなかった場合に，強制停止を実行します。
cjstopappコマンドに，-tオプションと-forceオプションを指定して実行します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名> -t <タイムアウト時間> -force

実行例

cjstopapp MyServer -name App1 -t 120 -force

なお，手順の実行後，J2EEサーバの状態を確認してください。次の状態の場合は，J2EEサーバを再起動する必要があります。

強制停止失敗

閉塞失敗

通常停止失敗

4.6　J2EEアプリケーションの入れ替えと保守

この節では，J2EEアプリケーションの入れ替えと保守について説明します。また，テストモードでのJ2EEアプリケーションの運用についても説明します。

J2EEアプリケーションのバージョンアップやメンテナンスを実施する場合，J2EEアプリケーションを入れ替えることがあります。

また，24時間サービス提供が必要なJ2EEアプリケーションを入れ替える場合，CTMを使用したオンライン状態でのJ2EEアプリケーションの入れ替えの方法を使用すると，サービスを停止しないでJ2EEアプリケーションを入れ替えられます。

＜この節の構成＞

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

4.6.2　リデプロイによるJ2EEアプリケーションの入れ替え

4.6.3　リロードによるJ2EEアプリケーションの入れ替え

4.6.4　入れ替えるJ2EEアプリケーション内のJSPの事前コンパイル

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

4.6.6　CTMを使用したオンライン状態でのJ2EEアプリケーションの入れ替え

4.6.7　テストモードでのJ2EEアプリケーションの運用

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

ここでは，サーバ管理コマンドを使用してJ2EEアプリケーションを入れ替える手順を説明します。J2EEアプリケーションは，停止して，削除してから新しいアプリケーションに入れ替えます。入れ替え後，J2EEアプリケーションを再開始します。

入れ替えは，次の手順で実行します。

入れ替えるJ2EEアプリケーションを停止します。
cjstopappコマンドを実行します。実行形式と実行例を次に示します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjstopapp MyServer -name App1

J2EEアプリケーションを削除します。
cjdeleteappコマンドを実行します。実行形式と実行例を次に示します。

実行形式

cjdeleteapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjdeleteapp MyServer -name App1

入れ替え後のJ2EEアプリケーションをインポートします。
サーバ管理コマンドを使用する場合，cjimportappコマンドを実行します。実行形式と実行例を次に示します。

実行形式

cjimportapp <J2EEサーバ名> -f <EARファイルのパス>

実行例

cjimportapp MyServer -f App1.ear

J2EEアプリケーションに必要な情報を設定，およびカスタマイズします。
サーバ管理コマンドを使用する場合は，cjgetapppropコマンドで属性ファイルを取得して，属性ファイルを編集してから，cjsetapppropコマンドを実行して設定します。
cjgetapppropコマンドの実行形式と実行例を次に示します。

実行形式

cjgetappprop <J2EEサーバ名> -name <J2EEアプリケーション名> -type all -encoding Shift_JIS -c <アプリケーション統合属性ファイル>

実行例

cjgetappprop MyServer -name App1 -type all -encoding Shift_JIS -c App1.xml

属性ファイルはテキストエディタなどで編集します。
cjsetapppropコマンドの実行形式と実行例を次に示します。

実行形式

cjsetappprop <J2EEサーバ名> -name <J2EEアプリケーション名> -type all -c <アプリケーション統合属性ファイル>

実行例

cjsetappprop MyServer -name App1 -type all -c App1.xml

J2EEアプリケーションを開始します。
サーバ管理コマンドを使用する場合，cjstartappコマンドを実行します。実行形式と実行例を次に示します。

実行形式

cjstartapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjstartapp MyServer -name App1

4.6.2　リデプロイによるJ2EEアプリケーションの入れ替え

ここでは，リデプロイによるJ2EEアプリケーションの入れ替えについて説明します。

リデプロイとは，アーカイブ形式のJ2EEアプリケーションを入れ替える場合に，少ない手順で高速に入れ替えられるデプロイ方法です。ロジックだけを変更したJ2EEアプリケーションを入れ替えたい場合などに利用できます。リデプロイは，サーバ管理コマンドを使用して実行できます。

リデプロイを実行できる条件を次に示します。

リデプロイを実行できる条件

入れ替えられるのは，実行時情報を含まないJ2EEアプリケーション（EARファイル）だけです。実行時情報を含むJ2EEアプリケーション（ZIPファイル）はリデプロイできません。

入れ替え前と入れ替え後のJ2EEアプリケーションの構成が同じである必要があります。J2EEアプリケーションに含まれるEJB-JAR，リソースアダプタおよびWARの数が異なったり，それらのファイル名称が異なったりする場合は，リデプロイはできません。また，J2EEアプリケーションの名称も同じである必要があります。

入れ替え前と入れ替え後のJ2EEアプリケーションに含まれるEJB-JAR内のホームインタフェース（ローカル，リモート），コンポーネントインタフェース（ローカル，リモート），ビジネスインタフェース（ローカル，リモート）のメソッド定義，およびアノテーションの値が同じである必要があります。

ランタイム属性だけを引き継ぐ設定をしている場合に，アプリケーション開発環境で設定済みのDDファイル（application.xml，ejb-jar.xml，ra.xmlおよびweb.xml）の定義内容が同じである必要があります。

また，J2EEアプリケーションを入れ替える時に，入れ替え前のJ2EEアプリケーションを別な名称に変更して退避しておくと，名称によるJ2EEアプリケーションの世代管理が実現できます。ここでは，J2EEアプリケーションの名称変更についてもあわせて説明します。

参考

通常の入れ替えまたはリデプロイによる入れ替えによってJ2EEアプリケーションを入れ替える場合，入れ替え後のJ2EEアプリケーションをテストモードで運用できます。テストモードを使用すると，実運用に入る前に，実際の運用環境でのJ2EEアプリケーションの動作を確認できます。テストモードによる運用については，「4.6.7　テストモードでのJ2EEアプリケーションの運用」を参照してください。

リデプロイでは，入れ替え前のJ2EEアプリケーションの情報を，入れ替え後のJ2EEアプリケーションに引き継げます。次の情報が引き継げます。

Application Serverのバージョンが06-70以降の場合

デフォルトの設定の場合，入れ替え後のJ2EEアプリケーションには，入れ替え前のJ2EEアプリケーションのすべての属性が引き継がれます。06-70よりも前のバージョンと同じように，ランタイム属性だけを引き継ぎたい場合は，オプションを指定してcjreplaceappコマンドを実行する必要があります。コマンドの詳細は，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

Application Serverのバージョンが06-70より前の場合

入れ替え前のJ2EEアプリケーションの属性ファイルに設定したランタイム属性※が引き継がれます。

注※　属性ファイルには，DD(application.xml，ejb-jar.xml，ra.xml，web.xml)の定義と属性ファイル独自の定義が設定できます。属性ファイル独自の定義のことを，ランタイム属性といいます。

リデプロイを実行するとき，J2EEアプリケーションは開始，停止どちらの状態でもかまいません。開始状態のJ2EEアプリケーションを入れ替えた場合，J2EEアプリケーションは入れ替え後に自動的に開始されます。ただし，プールやキャッシュに格納されていたJ2EEアプリケーション関連のオブジェクトは破棄されます。停止状態のJ2EEアプリケーションを入れ替えた場合は，入れ替え後のJ2EEアプリケーションも停止した状態になります。

ポイント

J2EEアプリケーションが開始されている状態でリデプロイを実行した場合，リデプロイ処理の中でJ2EEアプリケーションは停止され，入れ替え後に再開始されます。このとき，停止処理の実行時間がサーバ管理コマンド（cjreplaceapp）で設定したタイムアウト時間を超過した場合，J2EEアプリケーションの強制停止が実行されます。タイムアウト時間を指定しなかった場合は，デフォルトのタイムアウト時間である60秒を超過すると，強制停止が実行されます。強制停止実行後にさらにタイムアウト時間を超過した場合は，コマンドが異常終了します。

また，入れ替え後にJ2EEアプリケーションを再開始するとき，開始処理の実行時間がサーバ管理コマンド用のusrconf.propertiesのejbserver.rmi.request.timeoutキーに指定したタイムアウト時間を超過した場合も，コマンドが異常終了します。

入れ替え作業の実行形式と実行例を次に示します。

実行形式

cjreplaceapp <J2EEサーバ名> -name <J2EEアプリケーション名> -f <入れ替えるEARファイルのパス>

実行例

cjreplaceapp MyServer -name App1 -f App1.ear

4.6.3　リロードによるJ2EEアプリケーションの入れ替え

ここでは，リロードによるJ2EEアプリケーションの入れ替え方法について説明します。

リロードとは，少ない手順で展開ディレクトリ形式のJ2EEアプリケーションの入れ替えを実行できる機能です。リロードによるJ2EEアプリケーションの入れ替えでは，既存のJ2EEアプリケーションの停止，削除，入れ替え後のJ2EEアプリケーションのアーカイブ，インポート，再開などの作業が不要です。クラスファイルを更新してリロードを実行するだけでJ2EEアプリケーションを更新できるため，メンテナンスが頻繁に発生するシステムの運用などで特に有効な機能です。

なお，リロードによるJ2EEアプリケーションの入れ替えを実行するには，事前に設定が必要です。設定方法の詳細については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションの更新検知とリロードの設定に関する説明を参照してください。

リロードによるJ2EEアプリケーションの入れ替えは，サーバ管理コマンド（ cjreloadappコマンド）を使用して実行できます。cjreloadappコマンドの詳細についてはマニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

リロードは，次の手順で実行します。

メンテナンスの内容に従ってJavaソースファイルを編集，または作成して，クラスファイルにコンパイルします。

J2EEアプリケーションのリロードを実行します。
cjreloadappコマンドを実行します。実行形式と実行例を次に示します。

実行形式

cjreloadapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjreloadapp MyServer -name App1

注意

リロードに失敗したアプリケーションを削除するには，リロードの成功後，アプリケーションを停止，削除するか，J2EEサーバを再起動したあとにアプリケーションを削除してください。

4.6.4　入れ替えるJ2EEアプリケーション内のJSPの事前コンパイル

J2EEアプリケーションのメンテナンスでJSPを編集した場合，通常，入れ替え後のJ2EEアプリケーションに最初のリクエストがあったときに，JSPのコンパイルが実行されます。 JSP事前コンパイル機能を使用すると，デプロイ前のJ2EEアプリケーションに対してJSPのコンパイルを実行しておけるため，最初のリクエストに対するレスポンスの時間を短縮することができます。

JSP事前コンパイル機能を実行するには，サーバ管理コマンド，または cjjspcコマンドを使用します。ここでは，JSP事前コンパイル機能の実行タイミングと実行方法について説明します。

システム運用時にJSP事前コンパイル機能を実行するタイミングを次に示します。

J2EEアプリケーション開始時（サーバ管理コマンド）

リロードによるJ2EEアプリケーションの入れ替え時（cjjspcコマンド）

リデプロイによるJ2EEアプリケーションの入れ替え時（cjjspcコマンド）

それぞれのタイミングでの，JSP事前コンパイル機能の実行方法について説明します。

＜この項の構成＞

(1)　J2EEアプリケーションを開始するときのJSPの事前コンパイル

(2)　リロードによってJ2EEアプリケーションを入れ替えるときのJSPの事前コンパイル

(3)　リデプロイによってJ2EEアプリケーションを入れ替えるときのJSPの事前コンパイル

(1)　J2EEアプリケーションを開始するときのJSPの事前コンパイル

J2EEアプリケーションを開始するときにJSP事前コンパイル機能を実行します。この場合，cjstartappコマンドを，-jspcオプションを指定して実行します。

実行形式と実行例を次に示します。

実行形式

cjstartapp ＜サーバ名称＞ -name ＜J2EEアプリケーション名＞ -jspc

実行例

cjstartapp MyServer -name account -jspc

cjstartappコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(2)　リロードによってJ2EEアプリケーションを入れ替えるときのJSPの事前コンパイル

リロードによってJ2EEアプリケーションを入れ替える場合，cjreloadappコマンドを実行する前にJSP事前コンパイル機能を実行します。この場合，cjjspcコマンドを実行します。

実行形式と実行例を次に示します。

実行形式

cjjspc -root <Webアプリケーションのルートディレクトリ>

実行例（Windowsの場合）

cjjspc -root d:¥app¥webapp1

実行例（UNIXの場合）

cjjspc -root /tmp/app/webapp1

cjjspcコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(3)　リデプロイによってJ2EEアプリケーションを入れ替えるときのJSPの事前コンパイル

リデプロイによってJ2EEアプリケーションを入れ替える場合，cjreplaceappコマンドを実行する前にJSP事前コンパイル機能を実行します。この場合，cjjspcコマンドを実行します。

実行形式と実行例を次に示します。

実行形式

cjjspc -root <Webアプリケーションのルートディレクトリ>

実行例（Windowsの場合）

cjjspc -root d:¥app¥webapp1

実行例（UNIXの場合）

cjjspc -root /tmp/app/webapp1

cjjspcコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

注意

リデプロイによって入れ替えるJ2EEアプリケーションに事前コンパイル機能を使用する場合，入れ替えるJ2EEアプリケーションにJSPコンパイル結果が含まれていないとJSP事前コンパイル機能は実行されません。入れ替え後もJSP事前コンパイル機能を使用する場合は，Webアプリケーション単位のJSP事前コンパイルを実行して，入れ替えるJ2EEアプリケーションにJSPコンパイル結果を含めるようにしてください。

タグファイル，静的インクルードされたファイル，またはTLDファイルを更新した場合，更新したファイルを参照するすべてのJSPファイルをコンパイルしてください。

JSP事前コンパイル機能を使用した展開ディレクトリ形式のアプリケーションに，JSPファイル，またはタグファイルを追加した場合，JSP事前コンパイルを再度実施して，JSPファイル，またはタグファイルを参照するすべてのJSPファイルをコンパイルしてください。

展開ディレクトリ形式のアプリケーションのJSPワークディレクトリに含まれるクラスファイルを，開発環境からコピーして更新する場合は，開発環境でJSP事前コンパイルを実施したすべてのクラスファイルをコピーしてください。

cjjspcコマンドを使用してJSPの事前コンパイルを実施した場合，JSPファイルまたはタグファイルのトランスレーション時にエラーが発生すると，エラーメッセージがコンソールに出力されます。また，cjstartappコマンドを使用してJSPの事前コンパイルを実施した場合，JSPファイルまたはタグファイルのトランスレーション時にエラーが発生すると，エラーメッセージがサーブレットログに出力されます。

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

J2EEアプリケーションを入れ替える時，既存のJ2EEアプリケーションの名称を変更して退避しておくと，J2EEアプリケーションの世代管理ができます。また，入れ替え前のJ2EEアプリケーションに戻したい場合などにもスムーズに対処できます。

J2EEアプリケーションの名称変更は，サーバ管理コマンドで実行します。すでに変更後の名称と同じ名称のJ2EEアプリケーションがある場合，その名称には変更できません。大文字，小文字の違いによる区別はできません。ただし，通常モードまたはテストモードなどの運用時のモードが異なる場合，それぞれのモードで一つずつ同じ名称のJ2EEアプリケーションを登録できます。

なお，名称を変更すると，ルックアップ名称の変更も必要になります。J2EEアプリケーションの構成要素に，リモート呼び出しをするホームインタフェースまたはコンポーネントインタフェースを使用したEnterprise Beanが含まれている場合，RMI-IIOPスタブおよびインタフェースを取得し直してください。

RMI-IIOPスタブおよびインタフェースの取得は，サーバ管理コマンド（cjgetstubsjar）を使用して実行します。J2EEアプリケーションを一度も実行していない状態では取得できません。また，次の場合，RMI-IIOPスタブおよびインタフェースの取得はエラーになります。

J2EEアプリケーションにWARしか含まれない場合

Enterprise Beanで使用されているホームインタフェースおよびコンポーネントインタフェースがすべてローカル呼び出しの場合

Enterprise BeanがMessage-driven Beanだけの場合

名称変更は，次の手順で実行します。

名称を変更するJ2EEアプリケーションを停止します。
サーバ管理コマンド（cjstopapp）を実行します。

J2EEアプリケーションの名称を変更します。
サーバ管理コマンド（cjrenameapp）を実行します。
実行形式と実行例を次に示します。

実行形式

cjrenameapp <J2EEサーバ名> -name <変更前のJ2EEアプリケーションの名称> -newname <変更後のJ2EEアプリケーションの名称>

実行例

cjrenameapp MyServer -name App1 -newname App1bak

J2EEアプリケーションを開始します。
サーバ管理コマンド（cjstartapp）を実行します。

J2EEアプリケーションに含まれるEnterprise Bean内のホームインタフェースまたはコンポーネントインタフェースがリモート呼び出しを実行するように定義されている場合，RMI-IIOPスタブおよびインタフェースを取得します。
サーバ管理コマンド（cjgetstubsjar）を実行します。
実行形式と実行例を次に示します。

実行形式

cjgetstubsjar <J2EEサーバ名> -name <変更後のJ2EEアプリケーションの名称> -d <RMI-IIOPスタブおよびインタフェースを格納するディレクトリのパス>

実行例

cjgetstubsjar MyServer -name App1bak -d temp

注意

Application Serverのバージョンが06-50よりも前の場合，Webブラウザでindex.htmlを表示してRMI-IIOPスタブおよびインタフェースを取得できました。06-50以降の場合，次の条件を満たすときだけ，この機能を使用できます。

J2EEサーバに旧バージョンで作成したJ2EEアプリケーションがある状態で，06-50以降のApplication Serverをアップグレードインストールした場合

cjrenameappコマンドで名称を変更していない場合

次の場合は，index.htmlによるRMI-IIOPスタブおよびインタフェースの取得はできませんので，ご注意ください。

06-50以降の環境で，J2EEアプリケーションを新規にインポートした場合
実行時情報を含むJ2EEアプリケーションまたは実行時情報を含まないJ2EEアプリケーションのどちらをインポートした場合も，実行できません。

06-50以降の環境で新規にJ2EEアプリケーションを作成した場合

cjrenameappコマンドで名称を変更した場合

4.6.6　CTMを使用したオンライン状態でのJ2EEアプリケーションの入れ替え

CTMを利用したシステムでは，オンライン状態でJ2EEアプリケーションを入れ替える場合，J2EEアプリケーションのスケジュールキューの出口を閉じたあと，入れ替えを実行します。この操作は，運用管理コマンド（mngsvrutil）で実行できます。

J2EEアプリケーションの入れ替えは，J2EEアプリケーション単位，ホスト単位，または運用管理ドメイン単位で実行できます。

スケジュールキューの出口を閉じるには，mngsvrutilコマンドにサブコマンド「hold」を指定して実行します。mngsvrutilコマンドを実行してスケジュールキューの出口を閉塞している間も，クライアントからのリクエストはスケジュールキューに登録し続けられます。ただし，スケジュールキューの最大リクエスト登録数を超えた場合，クライアントにエラーが返却されます。

J2EEアプリケーションの入れ替えが終了したら，スケジュールキューの閉塞を解除します。スケジュールキューの閉塞解除は，mngsvrutilコマンドにサブコマンド「release」を指定して実行します。スケジュールキューの閉塞を解除すると，J2EEアプリケーションで，スケジュールキューに保持されていたリクエストの処理を再開します。

CTMを使用したオンライン状態でのJ2EEアプリケーションの入れ替え手順を次に示します。

入れ替えるJ2EEアプリケーションに対応するCTMのスケジュールキューの出口を閉じます。
J2EEアプリケーションを入れ替える場合のmngsvrutilコマンドの実行形式と実行例を次に示します。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <CTMの名称> hold queue <キューの名称> out

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t ctm01 hold queue App1 out

J2EEアプリケーションを入れ替えます。
J2EEアプリケーションを停止して，新しいアプリケーションに入れ替えます。そのあとで，J2EEアプリケーションを再開始します。
J2EEアプリケーションの入れ替え方法については，「4.6.1　J2EEアプリケーションの入れ替え」を参照してください。

CTMのスケジュールキューの閉塞を解除するときは，mngsvrutilコマンドにサブコマンド「release」を指定して実行します。
この場合のmngsvrutilコマンドの実行形式と実行例を次に示します。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <CTMの名称> release queue <キューの名称>

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t ctm01 release queue App1

mngsvrutilコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

4.6.7　テストモードでのJ2EEアプリケーションの運用

ここでは，テストモードでのJ2EEアプリケーションの運用について説明します。

J2EEアプリケーションを新しく登録する場合や，すでに動作中のJ2EEアプリケーションを入れ替えるとき，本番運用を開始する前に，本番環境で問題なく動作することを確認したいことがあります。このような場合にテストモードを使用します。

テストモードでの運用は，J2EEアプリケーション単位で実行できます。テストモードから本番運用時のモード（通常モード）に変更する場合，J2EEアプリケーションの設定やカスタマイズをし直す必要はありません。また，一つの本番環境で表示名が同じJ2EEアプリケーションを，通常モードとテストモードで同時に開始できます。これによって，既存のJ2EEアプリケーションでクライアントにサービスを提供しながら，入れ替える予定のJ2EEアプリケーションの動作を同じ環境で確認できます。

テストモードで運用できるのは，J2EEアプリケーションだけです。J2EEアプリケーション内でDB Connectorなどのリソースアダプタを使用する場合は，本番時に使用するものを使用してください。また，Webサーバ上の静的コンテンツについても，本番用に構築したWebサーバ上に配置して使用してください。

＜この項の構成＞

(1)　運用管理コマンド使用時の注意

(2)　J2EEアプリケーションを入れ替える場合にテストモードを使用する手順

(3)　テストモードで実行できるサーバ管理コマンド

(1)　運用管理コマンド使用時の注意

運用管理コマンド（mngsvrutil）では，テストモードで動作しているJ2EEアプリケーションを操作できません。テストモードでJ2EEアプリケーションを操作したい場合は，サーバ管理コマンドを実行してください。ただし，テストモードの場合も，運用管理コマンドで稼働情報を出力できます。

なお，J2EEアプリケーションのモードが，サーバ管理コマンドでテストモードに変更された場合，運用管理コマンドにサブコマンド「get」を指定して取得したJ2EEアプリケーションの稼働情報のfullyQualifiedNameに，「_TEST」という文字列が付いて出力されます。

(2)　J2EEアプリケーションを入れ替える場合にテストモードを使用する手順

J2EEアプリケーションを入れ替えるときに，J2EEアプリケーションをテストモードで開始する手順の例を示します。なお，この手順では，入れ替え元のJ2EEアプリケーションは，J2EEサーバ上で開始されていることを前提としています。

準備

Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，あらかじめ次の作業が必要です。

リダイレクタの設定（URLのマッピング）
通常モードのコンテキストルートを含むURLのマッピングに加えて，テストモードのコンテキストルートを含むURLのマッピングを設定してください。Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，Webアプリケーションのコンテキストルートにプリフィックス「_test_」を付けたものが，コンテキストルートとして使用されます。例えば，通常モードのコンテキストルートが「/jsptobean」の場合，テストモードのコンテキストルートは「/_test_/jsptobean」になります。
URLパターンでのリクエスト振り分けの設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

Webサーバの再起動
Webサーバを再起動して，リダイレクタの設定を有効にしてください。

手順

J2EEアプリケーションをテストモードでインポートします。
J2EEアプリケーションのインポートには，サーバ管理コマンド（cjimportapp）を使用します。
実行形式と実行例を次に示します。

実行形式

cjimportapp <J2EEサーバ名> -test -f <EARファイルのパス>

実行例

cjimportapp MyServer -test -f App1.ear

インポートしたJ2EEアプリケーションのプロパティ設定とカスタマイズを実行します。
サーバ管理コマンド（cjgetapppropおよびcjsetappprop）を使用して実行します。それぞれのコマンドには-testオプションを指定して，テストモードで実行します。
cjgetapppropコマンドの実行形式と実行例を次に示します。

実行形式

cjgetappprop <J2EEサーバ名> -test -name <J2EEアプリケーション名> -type all -c <アプリケーション統合属性ファイルの出力先パス>

実行例

cjgetappprop MyServer -test -name App1 -type all -c App1Prop.xml

属性ファイルはテキストエディタなどで編集します。
cjsetapppropコマンドの実行形式と実行例を次に示します。

実行形式

cjsetappprop <J2EEサーバ名> -test -name <J2EEアプリケーション名> -type all -c <編集したアプリケーション統合属性ファイルのパス>

実行例

cjsetappprop MyServer -test -name App1 -type all -c App1Prop.xml

J2EEアプリケーションをテストモードで開始します。
cjstartappコマンドの実行形式と実行例を次に示します。

実行形式

cjstartapp <J2EEサーバ名> -test -name <J2EEアプリケーション名>

実行例

cjstartapp MyServer -test -name App1

テストを実施します。
テスト用のクライアントから適宜操作を実行して，テストします。問題ないことが確認できたら，手順5.に進みます。
テスト結果に問題があった場合は，J2EEアプリケーションを修正して，手順1.からもう一度実行してください。なお，同じ名称のJ2EEアプリケーションは同じモードで登録できません。このため，テストが失敗したテストモードのJ2EEアプリケーションは削除してください。テストモードのJ2EEアプリケーションの削除は，サーバ管理コマンド（cjdeleteapp）に-testオプションを付けた形式で実行してください。

ポイント

テストモードで動作しているJ2EEアプリケーションは，テストモード用に設定した特定のクライアントからだけ利用できます。Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，Webアプリケーションのコンテキストルートにプリフィックス「_test_」を付けたものが，コンテキストルートとして使用されます。例えば，コンテキストルートが「/jsptobean」で，本番運用でのURLが「http://www.hitachi.co.jp/jsptobean/account.jsp」の場合，テストモードでのURLは，「http://www.hitachi.co.jp/_test_/jsptobean/account.jsp」になります。テスト用のクライアントからはこのURLを使用してJ2EEアプリケーションに対して操作を実行してください。

EJBを含むJ2EEアプリケーションをテストモードで運用する場合，EJBはテスト用の名前空間に登録されます。EJBクライアントアプリケーションからEJBを呼び出す場合には，通常モード用の名前空間のルートコンテキスト名で始まる検索文字列「HITACHI_EJB/…」ではなく，テストモード用の名前空間のルートコンテキスト名で始まる検索文字列「$HITACHI_TEST/…」を指定してlookupを実行してください。

テストモードで運用しているJ2EEアプリケーションを停止します。

実行形式

cjstopapp <J2EEサーバ名> -test -name <J2EEアプリケーション名>

実行例

cjstopapp MyServer -test -name App1

通常モードで運用しているJ2EEアプリケーションを停止します。
なお，J2EEアプリケーションを入れ替えではなく新規にインポートした場合，この操作は不要です。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjstopapp MyServer -name App1

通常モードで運用していたJ2EEアプリケーションの名称を変更します。
なお，J2EEアプリケーションを入れ替えではなく新規にインポートした場合，この操作は不要です。
また，この操作は，インポートしたファイルの世代を管理したい場合などに，必要に応じて実行してください。例えば，「App1」というJ2EEアプリケーションの場合，「App1_bak」などに変更します。

実行形式

cjrenameapp <J2EEサーバ名> -name <変更前のJ2EEアプリケーション名> -newname <変更後のJ2EEアプリケーション名>

実行例

cjrenameapp MyServer -name App1 -newname App1_bak

テストモードで運用していたJ2EEアプリケーションのモードを通常モードに変更します。

実行形式

cjchmodapp <J2EEサーバ名> -test -name <テストモードで動作を確認したJ2EEアプリケーション名> -mode normal

実行例

cjchmodapp MyServer -test -name App1 -mode normal

手順8.でモードを変更したJ2EEアプリケーションを開始します。

実行形式

cjstartapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjstartapp MyServer -name App1

(3)　テストモードで実行できるサーバ管理コマンド

テストモードで実行できるサーバ管理コマンドを示します。

それぞれのコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

表4-16　テストモードで実行できるサーバ管理コマンド

コマンド | テストモードでの動作
cjchmodapp | テストモードでインポートしたJ2EEアプリケーションのモードを通常モードに切り替えられます。また，通常モードでインポートしたJ2EEアプリケーションのモードをテストモードに切り替えられます。
cjdeleteapp | テストモードのJ2EEアプリケーションを削除できます。
cjgetappprop | テストモードのJ2EEアプリケーションのアプリケーション属性，WAR属性およびEJB-JAR属性を取得できます。
cjgetstubsjar | テストモードのJ2EEアプリケーションからRMI-IIOPスタブおよびインタフェースを取得できます。
cjimportapp | J2EEアプリケーションをテストモードでインポートできます。インポートは，実行時情報を含む形式（ZIPファイル）または実行時情報を含まない形式（EARファイル）のどちらも実行できます。
cjlistapp | J2EEサーバに含まれるすべてのJ2EEアプリケーションのうち，テストモードのJ2EEアプリケーションの一覧を表示できます。また，テストモードのJ2EEアプリケーションに含まれるWARファイルおよびEJB-JARファイルの一覧を表示できます。
cjlistthread | テストモードのJ2EEアプリケーションのスレッド一覧を表示できます。
cjreplaceapp | テストモードのJ2EEアプリケーションをリデプロイできます。
cjreloadapp | テストモードのJ2EEアプリケーションをリロードできます。
cjsetappprop | テストモードのJ2EEアプリケーションのアプリケーション属性，WAR属性およびEJB-JAR属性を設定できます。
cjstartapp | J2EEアプリケーションをテストモードで開始できます。
cjstopapp | テストモードで開始したJ2EEアプリケーションを停止できます。
cjstopthread | テストモードのJ2EEアプリケーションに対してメソッドキャンセルを実行できます。

4.7　JavaBeansリソースの入れ替え

この節では，JavaBeansリソースを入れ替える手順について説明します。JavaBeansリソースは，J2EEアプリケーションおよびJavaBeansリソースを停止して，J2EEサーバを再起動してから入れ替えます。JavaBeansリソースの入れ替えには，サーバ管理コマンドを使用します。

手順を次に示します。

入れ替えるJavaBeansリソースを使用しているJ2EEアプリケーションを停止します。
J2EEアプリケーションを停止するには，cjstopappコマンドを実行します。cjstopappコマンドの実行形式と実行例を次に示します。

実行形式

cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjstopapp MyServer -name App1

入れ替えるJavaBeansリソースを停止します。
JavaBeansリソースを停止するには，cjstopjbコマンドを実行します。cjstopjbコマンドの実行形式と実行例を次に示します。

実行形式

cjstopjb <サーバ名称> -resname <JavaBeansリソース表示名>

実行例

cjstopjb MyServer -resname javabeansname

J2EEサーバを再起動します。
いったん開始したJavaBeansリソースを削除するには，J2EEサーバを再起動する必要があります。J2EEサーバを停止するには，cjstopsvコマンドを実行します。cjstopsvコマンドの実行形式と実行例を次に示します。

実行形式

cjstopsv <J2EEサーバ名>

実行例

cjstopsv MyServer

J2EEサーバを停止したあと，もう一度開始します。J2EEサーバを開始するには，cjstartsvコマンドを実行します。cjstartsvコマンドの実行形式と実行例を次に示します。

実行形式

cjstartsv <J2EEサーバ名>

実行例

cjstartsv MyServer

入れ替えるJavaBeansリソースを削除します。
JavaBeansリソースを削除するには，cjdeletejbコマンドを実行します。cjdeletejbコマンドの実行形式と実行例を次に示します。

実行形式

cjdeletejb <サーバ名称> -resname <JavaBeansリソース表示名>

実行例

cjdeletejb MyServer -resname MyJavaBeans

入れ替え後のJavaBeansリソースをインポートします。
JavaBeansリソースをインポートするには，cjimportjbコマンドを実行します。cjimportjbコマンドの実行形式と実行例を次に示します。

実行形式

cjimportjb <サーバ名称> -f <JARファイルパス> -c <JavaBeansリソース属性ファイルパス>

実行例

cjimportjb MyServer -f Myjavabeans.jar -c Myjavabeansprop.xml

JavaBeansリソースを開始します。
JavaBeansリソースを開始するには，cjstartjbコマンドを実行します。cjstartjbコマンドの実行形式と実行例を次に示します。

実行形式

cjstartjb <サーバ名称> -resname <JavaBeansリソース表示名>

実行例

cjstartjb MyServer -resname javabeansname

J2EEアプリケーションを開始します。
J2EEアプリケーションを開始するには，cjstartappコマンドを実行します。cjstartappコマンドの実行形式と実行例を次に示します。

実行形式

cjstartapp <J2EEサーバ名> -name <J2EEアプリケーション名>

実行例

cjstartapp MyServer -name App1

4.8　クラスタコネクションプールの運用

この節では，クラスタコネクションプールの運用について説明します。データベースに発生した障害に対応する場合や，データベースをメンテナンスする場合，一部のコネクションプールを手動で停止，再開始することで，システム全体を止めることなくデータベースをメンテナンスできます。一部のコネクションプールを手動で停止，再開始して，データベースをメンテナンスする作業は次の流れで行います。

コネクションプールの状態を確認する（4.8.1参照）
サーバ管理コマンドを使用して実行します。

コネクションプールを一時停止する（4.8.2参照）
サーバ管理コマンドを使用して実行します。

コネクションプールを再開する（4.8.3参照）
サーバ管理コマンドを使用して実行します。

コネクションプールの状態を確認する（4.8.1参照）
サーバ管理コマンドを使用して実行します。

＜この節の構成＞

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

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

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

4.8.4　コネクションプールの状態

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

クラスタ構成のデータベースをメンテナンスする前，およびメンテナンスしたあとに，コネクションプールの状態を確認します。

コネクションプールの状態の詳細については「4.8.4　コネクションプールの状態」を参照してください。

コネクションプールの状態の確認は，cjlistrarコマンドで実行できます。

cjlistrarコマンドの実行形式と実行例を次に示します。

実行形式

cjlistrar <サーバ名> -clusterpool

実行例

cjlistrar MyServer -clusterpool

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

ここでは，コネクションプールを一時停止する手順について説明します。

コネクションプールの一時停止は，cjsuspendpoolコマンドで実行できます。cjsuspendpoolコマンドを実行すると，コネクションプールが閉塞されて一時停止状態になり，コネクション取得要求を受け付けなくなります。

cjsuspendpoolコマンドは，コネクションプールが次の状態の場合に実行できます。

開始

開始予約

自動一時停止

自動一時停止予約

コネクションプールの状態を確認する方法については，「4.8.1　コネクションプールの状態の確認」を参照してください。

cjsuspendpoolコマンドの実行形式と実行例を次に示します。

実行形式

cjsuspendpool ＜サーバ名＞ -resname ＜一時停止対象となるメンバリソースアダプタの表示名＞

実行例

cjsuspendpool MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

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

ここでは，コネクションプールを再開する手順について説明します。

コネクションプールの再開は，cjresumepoolコマンドで実行できます。cjresumepoolコマンドを実行すると，コネクションプールは手動再開中状態になり，再開処理が実行されます。再開処理が完了すると，コネクションプールは開始状態になり，コネクション取得要求を受け付けるようになります。

cjresumepoolコマンドは，コネクションプールが次の場合に実行できます。

使用されていないコネクション管理スレッドが，コネクションプールのコネクションの最大値以上ある

コネクションプールが，手動一時停止，手動一時停止予約，自動一時停止，または自動一時停止予約の状態である

コネクションプールの状態を確認する方法については，「4.8.1　コネクションプールの状態の確認」を参照してください。

cjresumepoolコマンドの実行形式と実行例を次に示します。

実行形式

cjresumepool ＜サーバ名＞ -resname ＜再開対象となるメンバリソースアダプタの表示名＞

実行例

cjresumepool MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

なお，cjresumepoolコマンドを実行したあと，コネクションプールの状態を確認して，再開処理が正しく実行されたかどうかを確認してください。コネクションプールの状態を確認する方法については，「4.8.1　コネクションプールの状態の確認」を参照してください。

4.8.4　コネクションプールの状態

ここでは，メンバコネクションプールの状態について説明します。

メンバコネクションプールの状態は，J2EEサーバやメンバリソースアダプタを再起動しても維持されます。コネクションプールの状態を確認する方法については，「4.8.1　コネクションプールの状態の確認」を参照してください。

なお，メンバリソースアダプタ以外のコネクションプールには状態はありません。

＜この項の構成＞

(1)　コネクションプールの状態遷移

(2)　コネクションプールの状態によるコマンド実行の可否

(1)　コネクションプールの状態遷移

メンバコネクションプールの状態遷移を次の図に示します。

図4-1　メンバコネクションプールの状態遷移（手動で一時停止を実行する場合）

図4-2　メンバコネクションプールの状態遷移（自動で一時停止が実行される場合）

なお，J2EEサーバの開始時にコネクションプールが再開中状態，または閉塞状態の場合，コネクションプールは一時停止状態に遷移します。

それぞれの状態の詳細について次の表に示します。

表4-17　メンバコネクションプールの状態

番号 | 状態 | 説明
1 | 開始状態 | コネクションプールが処理を受け付けている状態です。ルートリソースアダプタへのコネクション取得要求時には，開始状態のコネクションプールだけに処理が行われます。
2 | 開始予約状態 | コネクションプールが開始状態のときにリソースアダプタが停止された状態です。開始予約状態のコネクションプールは，リソースアダプタの開始時に開始状態になります。リソースアダプタをデプロイした直後は，この状態になります。
3 | 自動再開中状態 | 自動再開機能によって，コネクションプールが再開処理を行っている状態です。再開処理が成功すると開始状態になります。再開処理が失敗すると，自動一時停止状態に戻ります。自動再開中状態のコネクションプールには，ルートリソースアダプタへのコネクション取得要求時に処理が出されません。
4 | 手動再開中状態 | 自動一時停止状態，または手動一時停止状態のときにcjresumepoolコマンドを実行して，コネクションプールが再開処理を行っている状態です。再開処理が成功すると，開始状態になります。再開処理が失敗すると，コマンド実行前の状態に戻ります。手動再開中状態のコネクションプールには，ルートリソースアダプタへのコネクション取得要求時に処理が出されません。
5 | 自動閉塞状態 | 自動一時停止機能によって，コネクションプールが閉塞されて，一時停止処理を行っている状態です。一時停止処理が完了すると，自動一時停止状態になります。自動閉塞状態のコネクションプールには，ルートリソースアダプタへのコネクション取得要求時に処理が出されません。
6 | 手動閉塞状態 | cjsuspendpoolコマンドによって，コネクションプールが閉塞され，一時停止処理を行っている状態です。一時停止処理が完了すると，手動一時停止状態になります。手動閉塞状態のコネクションプールには，ルートリソースアダプタへのコネクション取得要求時に処理が出されません。
7 | 自動一時停止状態 | 自動一時停止機能によって，コネクションプールが一時停止された状態です。コネクションプール内にコネクションは存在しません。自動一時停止状態のコネクションプールには，ルートリソースアダプタへのコネクション取得要求時に処理が出されません。
8 | 手動一時停止状態 | cjsuspendpoolコマンドによって，コネクションプールが一時停止された状態です。コネクションプール内にコネクションは存在しません。手動一時停止状態のコネクションプールには，ルートリソースアダプタへのコネクション取得要求時に処理が出されません。
9 | 自動一時停止予約状態 | コネクションプールが自動一時停止状態のときにリソースアダプタを停止した状態です。自動一時停止予約状態のコネクションプールは，リソースアダプタの開始時に自動一時停止状態になります。なお，このとき，コネクションプールのウォーミングアップ機能は無効になります。
10 | 手動一時停止予約状態 | コネクションプールが手動一時停止状態のときにリソースアダプタを停止した状態です。手動一時停止予約状態のコネクションプールは，リソースアダプタの開始時に手動一時停止状態になります。なお，このとき，コネクションプールのウォーミングアップ機能は無効になります。

注　番号は，図4-1および図4-2中の番号を示します。

(2)　コネクションプールの状態によるコマンド実行の可否

コネクションプールの状態によって，実行できるコマンドと実行できないコマンドがあります。コネクションプールの状態ごとに，それぞれのコマンドの実行の可否を次に示します。

表4-18　コネクションプールの状態によるコマンド実行の可否

コマンド | コネクションプールの状態
開始 | 開始予約 | 自動再開中/手動再開中 | 自動閉塞/手動閉塞 | 自動一時停止 | 手動一時停止 | 自動一時停止予約 | 手動一時停止予約
cjstartrar | × | ○ | × | × | × | × | ○ | ○
cjstoprar | ○ | × | △※1 | △※2 | ○ | ○ | × | ×
cjclearpool | ○ | × | × | × | × | × | × | ×
cjlistrar | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
cjsuspendpool | ○ | ○ | × | × | ○ | × | ○ | ×
cjresumepool | × | × | × | × | ○ | ○ | ○ | ○
cjstopsv(通常停止時) | ○ | ○ | △※1 | △※2 | ○ | ○ | ○ | ○
cjstopsv(強制停止時) | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○

（凡例）　○：実行できる　△：制限あり　×：実行できない

注※1　コマンドは受け付けられますが，開始または一時停止状態になってから処理が実行されます。

注※2　コマンドは受け付けられますが，一時停止状態になってから処理が実行されます。

5.　トラブルシューティング

この章では，システムの運用中に発生したトラブルに対処する方法について説明します。

＜この章の構成＞

5.1　対処の手順

5.2　取得が必要な資料の種類

5.3　資料の取得

5.4　資料の個別取得

5.5　資料の調査

5.6　トラブルへの対処と回復

5.7　トラブルシューティングに関連する留意事項

5.1　対処の手順

この節では，Cosminexusのシステムの運用中にトラブルが発生した場合の，対処の手順について説明します。

なお，トラブル発生時に取得する情報のうち，次に示す情報を取得するためには，運用開始前の準備が必要です。

日立JavaVM固有のログ（日立JavaVMログファイル）
このファイルには，JavaVMのガーベージコレクションのログも出力されます。

ユーザダンプ（Windowsの場合）

coreダンプ（UNIXの場合）

OSの統計情報（Windowsの場合）

これらの情報については，必要に応じてシステム構築時に取得準備をしてください。詳細は，マニュアル「Cosminexus　システム構築ガイド」のトラブルシューティングの資料取得の設定に関する説明を参照してください。

システムの運用中にトラブルが発生した場合，次の図に示す手順で対処します。

図5-1　トラブル発生時の対処の流れ

資料取得
トラブルシューティングに必要な資料をすべて取得します。
取得が必要な資料については，「5.2　取得が必要な資料の種類」を参照してください。なお，メモリダンプは，J2EEサーバまたはCORBAネーミングサービスを再起動する場合にだけ必要な資料です。
また，資料の取得方法については，「5.3　資料の取得」，または「5.4　資料の個別取得」を参照してください。

参考

資料の取得には，snapshotログとして一括して取得する方法と，個別のログを取得する方法があります。

snapshotログの取得には，運用管理コマンドを使用して取得する方法，および設定によって自動で取得する方法があります。

論理サーバに異常が発生した場合の資料取得を自動化できます。詳細は，「5.3.2　トラブル発生時に自動的に取得できる資料」を参照してください。

トラブル原因の判別（一次判別）
トラブルの原因を判別します。判別には，取得した資料を使用します。資料の調査方法については，「5.5　資料の調査」を参照してください。

トラブルへの対処と回復
トラブルに対処して，回復します。
トラブルの種類ごとの対処方法については，「5.6　トラブルへの対処と回復」を参照してください。

トラブル原因の解析（二次解析）
必要に応じてトラブル原因をさらに分析します。なお，この解析作業は保守員が実施します。

5.2　取得が必要な資料の種類

ここでは，トラブル発生時に取得が必要な資料の種類を示します。

取得が必要な資料は，発生したトラブルの種別によって異なります。ここでは，Cosminexusのシステムで想定されるトラブルの種別と，それに応じて取得が必要な資料の一覧を示します。

なお，トラブルの内容によっては，保守員に連絡する必要があります。保守員とは，ご購入契約に基づくお問い合わせ窓口のことです。

次のような場合は，保守員に連絡してください。

保守員に連絡が必要なトラブル

出力されたエラーメッセージの対処に「保守員に連絡してください。」とある場合

トラブルの要因がわからない場合

エラーメッセージの内容に対処できない場合

保守員に連絡する場合には，次の内容をできるだけ正確に伝えてください。

エラーの発生時期

エラー発生の直前に実行した操作

エラー発生時の画面の動作

トラブル発生時に取得した資料

取得した資料を保守員に送付する場合，取得した資料は，次の2種類に分類できます。

メールなどで早急に送付する資料（一次送付資料）
メールの添付資料として送付できるファイルサイズの資料が該当します。

別途送付する資料（二次送付資料）
ファイルサイズが比較的大きく，保守員への送付に時間が掛かるため，メール以外の方法などで別途送付する必要がある資料が該当します。なお，二次送付資料には，一次送付資料の内容が含まれます。

＜この節の構成＞

5.2.1　トラブルの種別と取得が必要な資料

5.2.2　取得が必要な資料の一覧

5.2.3　取得方法および調査方法との対応

5.2.1　トラブルの種別と取得が必要な資料

Cosminexusで想定されるトラブルには，次に示す種別があります。

エラーメッセージ出力
エラーメッセージが出力されます。

システムダウン
Cosminexusのサーバプロセスが異常終了します。

ハングアップ（無応答）
アプリケーション呼び出しの応答が返らなくなります。

スローダウン
アプリケーション呼び出しの応答は返りますが，応答時間が長くなります。

トラブル種別ごとに取得する資料を，次に示します。

表5-1　トラブル種別ごとの取得資料一覧

項番 | 資料の種類 | トラブル種別
エラーメッセージ出力 | システムダウン | ハングアップ（無応答） | スローダウン
1 | メッセージログ※1 | ○ | ○ | ○ | ○
2 | ユーザログ※1 | ○ | ○ | ○ | ○
3 | 例外ログ※1 | ○ | ○ | ○ | ○
4 | 保守用ログ※1 | ○ | ○ | ○ | ○
5 | 性能解析トレース | ○ | ○ | ○ | ○
6 | スレッドダンプ | ○ | ○ | ○ | ○
7 | ガーベージコレクションのログ | △ | ○ | ○ | ○
8 | メモリダンプ | － | ○ | ○ | ○
9 | 日立JavaVMログファイル※2 | － | ○ | ○ | ○
10 | エラーリポートファイル | － | ○ | － | －
11 | OSの状態・ログ | ○ | ○ | ○ | ○
12 | OSの統計情報 | △ | ○ | ○ | ○
13 | 定義情報 | ○ | ○ | ○ | ○
14 | 作業ディレクトリ | △ | △ | △ | △
15 | リソースの設定 | ○ | ○ | ○ | ○
16 | Webサーバのログ | ○ | ○ | ○ | ○
17 | JavaVMのスタックトレース※3 | － | ○ | － | －

（凡例）

○：必須

△：取得するかどうかは，実際のエラーの内容によって異なる

－：取得しない

注※1

Cosminexusの構成ソフトウェアが出力するログです。

注※2

usrconf.cfgのadd.jvm.argキーに特定のオプションを指定している場合に出力されます。取得するためのオプションについては，「5.4.8　日立固有のJavaVMログの取得（日立JavaVMログファイル）」を参照してください。また，オプションの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注※3

UNIXを使用している場合だけ出力されます。

5.2.2　取得が必要な資料の一覧

Cosminexusでトラブルシューティングに必要な資料の一覧を次の表に示します。また，ここではそれぞれの資料を保守員に送付する場合の送付タイミングについても示します。

表5-2　取得資料一覧

項番 | 資料の種類 | 説明 | 送付タイミング
1 | メッセージログ※1 | J2EEサーバなどの稼働状態およびエラー情報が出力されます。 | 一次／二次
2 | ユーザログ※1 | アプリケーション中で出力される標準出力および標準エラー出力の情報が出力されます。 | 一次
3 | 例外ログ※1 | システムでトラブルが発生したときの例外情報が出力されます。 | 一次
4 | 保守用ログ※1 | システムでトラブルが発生したときの障害保守情報が出力されます。保守員が障害解析用に使用します。 | 一次／二次
5 | 性能解析トレース | リクエストの一連の処理で出力されるトレース情報が出力されます。 | 二次
6 | JavaVMのスレッドダンプ | JavaVMの稼働情報やスレッドのスタック状態が出力されます。 | 一次
7 | JavaVMのガーベージコレクションのログ | JavaVMのガーベージコレクションの活動状態が出力されます。 | 一次
8 | メモリダンプ | プロセスのメモリイメージがダンプ出力されます。 | 二次
9 | 日立JavaVMログファイル※2 | Cosminexus Developer's Kit for Javaで提供される日立JavaVMの固有のログが出力されます。 | 一次
10 | エラーリポートファイル | JavaVMがダウンした場合に出力されるログファイルです。 | 一次
11 | OSの状態・ログ | OSの稼働情報の記録です。 | 一次／二次
12 | OSの統計情報 | OSの統計情報の記録です。 | 一次
13 | 定義情報 | Cosminexusの各種設定の定義情報です。 | 一次
14 | 作業ディレクトリ | Cosminexus稼働時に作業ファイルが格納されているディレクトリです。 | 一次／二次
15 | リソースの設定 | Cosminexus上で使用するリソース（データソース，リソースアダプタ）の設定情報です。 | 二次
16 | Webサーバのログ | Hitachi Web Server，Microsoft IISのログです。 | 一次
17 | JavaVMのスタックトレース※3 | JavaVMが異常終了した場合の原因究明に使用する情報です。 | 一次／二次

（凡例）

一次：一次送付資料

二次：二次送付資料

注※1

Cosminexusの構成ソフトウェアが出力するログです。

注※2

usrconf.cfgのadd.jvm.argキーに特定のオプションを指定している場合に出力されます。取得するためのオプションについては，「5.4.8　日立固有のJavaVMログの取得（日立JavaVMログファイル）」を参照してください。また，オプションの詳細について，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注※3

UNIXを使用している場合だけ出力されます。

ログファイルは，各構成ソフトウェアの環境設定ファイルで指定したディレクトリに自動的に作成されます。ファイル名には，1～指定したログファイルの面数の通し番号が付きます。ログファイルのファイルサイズが一面当たりの最大サイズに達すると，次のログファイルに出力先を切り替えます。指定したログファイルの面数分のファイルに出力したあとは，ファイル名の番号が1のログファイルに再度ログを出力します。なお，ログファイルの1レコードの出力が途切れないようするために，ログファイルのファイルサイズが環境設定ファイルに指定したサイズより若干大きくなることがあります。1レコードの最大長は約4キロバイトです。

5.2.3　取得方法および調査方法との対応

ここでは，取得が必要な資料の取得方法と調査方法の参照先を示します。また，snapshotログとして取得できる情報の種類についても示します。

表5-3　取得が必要な資料の取得方法と調査方法の参照先

項番
資料の種類
デフォルト設定のsnapshotログで
取得可※1
参照先

個別の収集方法
調査方法

1
メッセージログ
○
5.4.1
5.4.2　
5.4.3
5.5.1
5.5.2
5.5.3

2
ユーザログ
○

3
例外ログ
○

4
保守用ログ
○

5
性能解析トレース
○
5.4.4
3.3
5.5.4

6
JavaVMのスレッドダンプ
○※2
5.4.5
5.5.5

7
JavaVMのガーベージコレクションのログ
×
5.4.6
5.5.6

8
メモリダンプ
×※2
5.4.7
－※3

9
日立JavaVMログファイル※4
×
5.4.8
5.5.7

10
エラーリポートファイル
×
5.4.9
5.5.8

11
OSの状態・ログ
○
5.4.10
5.5.9

12
OSの統計情報
×
5.4.11
－※3

13
定義情報
○
5.4.12
－※3

14
作業ディレクトリ
×
5.4.13
－※3

15
リソースの設定
×
5.4.14
－※3

16
Webサーバのログ
×
5.4.15
－※3

17
JavaVMのスタックトレース※3 ※5
×
5.4.16
5.5.10

（凡例）○：取得できます。　×：取得できません。

注※1

snapshotログの収集対象ディレクトリを追加すれば取得できます。

注※2

あらかじめ障害検知時コマンドなどによって出力されている場合だけ収集できます（snapshotログ収集時には，これらのダンプを出力するコマンドは実行されません）。

注※3

保守員が使用する資料です。

注※4

usrconf.cfgのadd.jvm.argキーに特定のオプションを指定している場合に出力されます。取得するためのオプションについては，「5.4.8　日立固有のJavaVMログの取得（日立JavaVMログファイル）」を参照してください。また，各オプションの詳細について，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注※5

UNIXを使用している場合だけ出力されます。

5.3　資料の取得

ここでは，トラブル発生時の資料の取得方法について説明します。

＜この節の構成＞

5.3.1　資料の取得方法

5.3.2　トラブル発生時に自動的に取得できる資料

5.3.3　snapshotログの収集

5.3.1　資料の取得方法

トラブルシュートに必要な資料は，次のどれかの方法で取得できます。

トラブル発生時に自動的に取得する

運用管理コマンドを利用して一括取得する

それぞれの情報を個別に収集する

トラブルシュートに必要な情報は，snapshotログとしてまとめて収集できます。snapshotログとは，システムの構成ソフトウェアのトラブル発生時に，そのときの状態を出力したログのことです。Cosminexusで構築したシステムでは，各種構成ソフトウェアのsnapshotログを一括して収集して，ZIP形式のログファイルとして出力できます。また，snapshotログは，一次送付資料と二次送付資料に分けて取得できます。

snapshotログは，次に示すタイミングで自動収集されます。

トラブルが発生した論理サーバが停止する直前

運用管理ドメインで管理しているJ2EEサーバが自動再起動される直前

J2EEサーバを手動で一括再起動する直前

また，運用管理コマンド（mngsvrutil）を使用して，任意のタイミングでsnapshotログを収集することもできます。

それぞれの情報を個別に収集する方法，およびsnapshotログとして取得しない情報については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」または「5.4.2　Cosminexusのログの取得（バッチアプリケーションを実行するシステム）」に示す方法で，個別に収集してください。

5.3.2　トラブル発生時に自動的に取得できる資料

Cosminexusシステムでは，論理サーバに異常が発生した場合に，自動的にトラブルシュートに必要な情報を取得，収集できます。

ポイント

トラブル発生時に資料を自動で取得するためには，システムを構築する段階で必要な設定をしておく必要があります。トラブルシューティングの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

自動で資料を取得する場合の，トラブル発生から資料の取得と収集，システムの回復までの流れを次の図に示します。

図5-2　自動で資料を収集する場合の流れ

2.の障害検知時コマンドによって，トラブルシュートに必要な情報が出力されます。このコマンドで出力した情報，およびそれ以外のトラブルシュートに必要な情報を，3.でsnapshotログとしてまとめて収集します。

このほか，設定によっては，snapshotログは，運用管理ドメインで管理しているJ2EEサーバを手動で一括再起動する直前にも自動収集されます。

ポイント

障害検知時コマンドの実行とsnapshotログの収集によって，トラブルシューティングに必要な情報は，次の情報を除いてすべて自動収集するように設定できます。

OSの統計情報（Windowsの場合）

デフォルトの設定で収集されない情報については，次のように設定して収集します。

ユーザ作成の障害検知時コマンド内で，必要な情報を出力します。

1.の情報の出力先を，snapshotログの収集対象のパスに追加します。

snapshotログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

ここでは，2.の障害検知時コマンド実行時と，3.のsnapshotログ収集時に取得できる資料の種類について説明します。

注意

snapshotログで取得できる構成ソフトウェアのログのうち，次の表に示すログの取得については，このマニュアルでは説明していません。取得方法については，次の表の参照先マニュアルを参照してください。

表5-4　このマニュアルでログの取得方法を記載していない構成ソフトウェア

ログの種類 | 参照先マニュアル名
Cosminexus Component ContainerのSOAPアプリケーション実行基盤のログ | Cosminexus SOAPアプリケーション開発ガイド
Cosminexus TPBrokerのログ | TPBroker　ユーザーズガイド
Cosminexus Web Services - Securityのログ | Cosminexus Webサービスセキュリティ　使用の手引

＜この項の構成＞

(1)　障害検知時コマンドで出力できる資料

(2)　snapshotログとして収集できる資料

(3)　取得した情報の格納先

(1)　障害検知時コマンドで出力できる資料

障害検知時コマンドは，Management Serverで管理している論理サーバにトラブルが発生した場合に，システムによって実行されます。

障害検知時コマンドには，次の2種類があります。

システムで提供されている障害検知時コマンド

ユーザが作成する障害検知時コマンド

ここでは，それぞれで取得できる情報について説明します。

ポイント

障害検知時コマンドは，システム構築時に必要な設定がされていない場合，実行されません。次の設定内容を確認してください。

mserver.properties（Management Server環境設定ファイル）のcom.cosminexus.mngsvr.sys_cmd.abnormal_end.enabledキーに「true」が設定されている場合，システムで提供されている障害検知時コマンドが実行されます。

mserver.properties（Management Server環境設定ファイル）のcom.cosminexus.mngsvr.usr_cmd.abnormal_end.enabledキーに「true」が設定されている場合，ユーザが作成した障害検知時コマンドが実行されます。

障害検知時コマンドによる資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(a)　システムで提供されている障害検知時コマンドで出力できる資料

システムで提供されている障害検知時コマンドで出力できる資料について，次の表に示します。障害検知時コマンドで出力できる資料は，障害の種類（システムダウン，またはハングアップ）および使用しているOSによって異なります。

なお，snapshotログでこれらの情報を取得するためには，adminagent.properties（運用管理エージェントプロパティファイル）に必要な設定がされていることが必要です。

障害検知時コマンドで出力できる資料を次に示します。

表5-5　障害検知時コマンドで出力できる資料

論理サーバ
OS
取得できる情報

プロセスダウンを検出した場合
ハングアップを検出した場合

論理パフォーマンストレーサ
Windows
UNIX

バッファの内容を出力したPRFトレースファイル

－

論理J2EEサーバ
Windows

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

UNIX

JavaVMのスタックトレース情報

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

論理SFOサーバ
Windows

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

UNIX

JavaVMのスタックトレース情報

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

論理Webサーバ
Windows
UNIX

性能解析トレースファイル

内部トレース

性能解析トレースファイル

ほかの論理サーバ
Windows
UNIX

性能解析トレースファイル

性能解析トレースファイル

（凡例）－：何も出力されません。

トラブルが発生したJ2EEサーバまたはSFOサーバのスレッドダンプ
adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.j2ee.sys_cmd.abnormal_end.threaddumpキーに「true」が設定されている場合に取得できます。

性能解析トレース
adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.sys_cmd.abnormal_end.prftraceキーに「true」が設定されている場合に取得できます。

注意

トラブルが発生したJ2EEサーバまたはSFOサーバのプロセスが存在しないと判断された場合，スレッドダンプは出力されません。また，パフォーマンストレーサのプロセスが存在しないと判断された場合，性能解析トレースは出力されません。

(b)　ユーザが作成した障害検知時コマンドで出力できる情報

ユーザが作成した障害検知時コマンドとして，資料取得に必要な任意の処理を記述したバッチファイルまたはシェルスクリプトを実行できます。例えば，ユーザダンプまたはcoreダンプは，このコマンドの中でdrwtsn32コマンドまたはcjdumpsvコマンドなどを実行して取得できます。障害検知時コマンドの作成方法については，マニュアル「Cosminexus　システム構築ガイド」の障害検知時コマンドによる資料取得の設定に関する説明を参照してください。

なお，ユーザ作成の障害検知時コマンドは，adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.<serverkind>.usr_cmd.abnormal_endキーに指定されているものが実行されます。

(2)　snapshotログとして収集できる資料

snapshotログとして収集できる情報を示します。snapshotログには，システム保守に必要な情報とアプリケーション保守に必要な情報が含まれます。

なお，snapshotログとして収集する情報は，リストファイルの設定によって変更できます。例えば，ユーザ作成の障害検知時コマンドで出力した情報を収集したい場合には，設定を変更すれば収集対象に加えられます。リストファイルの設定はシステム構築時に実行します。

実際の運用環境での収集対象は，次のファイルで確認できます。

snapshotlog.conf
一次送付資料として取得する内容が定義されています。
snapshotlog.confの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.conf

UNIXの場合
/opt/Cosminexus/manager/config/snapshotlog.conf

snapshotlog.2.conf
二次送付資料として取得する内容が定義されています。
snapshotlog.2.confの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.2.conf

UNIXの場合
/opt/Cosminexus/manager/config/snapshotlog.2.conf

ただし，adminagent.properties（運用管理エージェントプロパティファイル）の指定内容によっては，収集できる情報が異なる場合があります。snapshotログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

デフォルトの設定の場合，トラブル発生時に自動的に取得されるsnapshotログには，次の情報が含まれます。

一次送付資料

snapshotログの一次送付資料の収集対象として定義されているディレクトリ下の情報※1

J2EEサーバおよびSFOサーバのスレッドダンプ※2

インストール情報

OSの状態ログ

二次送付資料

性能解析トレース※2

snapshotログの二次送付資料の収集対象として定義されているディレクトリ下の情報※1

インストール情報

OSの状態ログ

注※1　snapshotログの収集対象のディレクトリについては，「付録B　snapshotログの収集対象一覧」を参照してください。

注※2　システムで提供されている障害検知時コマンドで，スレッドダンプおよび性能解析トレースを出力する設定にしている場合に収集できます。

次に，デフォルトの状態で取得できる情報と取得できない情報の例を示します。

(a)　デフォルトの状態で取得できる情報

デフォルトの状態で取得できる情報の例を次に示します。

システム保守に必要な情報

システム保守に必要な情報として，次に示す構成ソフトウェアの定義ファイルおよびログファイルが収集されます。

Cosminexus Component Container※

Cosminexus Component Transaction Monitor

Cosminexus DABroker Library

Cosminexus Developer's Kit for Java

Cosminexus Performance Tracer

Cosminexus TPBroker

Cosminexus Web Services - Security

Hitachi Web Server

Cosminexus cFramework

このほか，日立トレース共通ライブラリのログ，およびプログラムプロダクト情報（UNIXの場合）も収集します。

注※　SOAPアプリケーション実行基盤の情報も含みます。

アプリケーション保守に必要な情報

アプリケーション保守に必要な情報として，Cosminexus Component Containerのメッセージログおよびユーザログを収集します。

なお，デフォルトの状態では，構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリがsnapshotログの収集対象として定義されています。ログの出力先を変更している場合は収集先も変更するようにしてください。

snapshotログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」，およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(b)　デフォルトの状態では収集できない情報

次に示す情報は，デフォルトの状態で運用している場合は収集されません。必要に応じて，取得するように設定してください。snapshotログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

Windowsの場合

Cosminexus Component Container関連

<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥import下すべて

<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥rars下すべて

<Cosminexusのインストールディレクトリ>¥CC¥server¥public下すべて

Ear/Jarファイル（デプロイ/インポートできなかった場合）

Microsoft IIS関連

Microsoft IISと連携している場合，次の資料を取得します。

C:¥WINNT¥system32¥LogFiles¥W3SVC1（C:の部分にはシステムドライブを指定します）

OS関連

システムモニタ関連の資料一式（5.4.11参照）

イベントログ（アプリケーション，システム）

OSの稼働資料
winmsd起動画面から［操作］－［テキストファイルとして保存］メニューで資料採取します（5分から10分掛かる場合があります）。

UNIXの場合

Cosminexus Component Container関連

/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/import下すべて

/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/rars下すべて

/opt/Cosminexus/CC/server/public下すべて

Ear/Jarファイル（デプロイ/インポートできなかった場合）

OS関連

OSの稼働資料

(3)　取得した情報の格納先

snapshotログの収集によって自動で取得された情報は，adminagent.properties（運用管理エージェントプロパティファイル）のキー「adminagent.snapshotlog.log_dir」で指定したディレクトリに次の名称で格納されています。

一次送付資料として収集したファイル
snapshot-<論理サーバ名>-log-<yyyyMMddHHmmss※>.zip

二次送付資料として収集したファイル
snapshot-<論理サーバ名>-log-<yyyyMMddHHmmss※>.2.zip

注※　yyyy：西暦　MM：月　dd：日　HH：時　mm：分　ss：秒

なお，出力先ディレクトリのデフォルトは，次のとおりです。

Windowsの場合
<Managerのログ出力ディレクトリ>¥snapshot

UNIXの場合
<Managerのログ出力ディレクトリ>/snapshot

参考

snapshotログとして収集しようとしたファイルの一覧，および実際に収集したファイルの一覧は，次のファイルで確認できます。これらのファイルは，アーカイブされたzipファイルに含まれています。

収集しようとしたファイルの一覧
snapshot-<ホスト名>-log-<yyyyMMddHHmmss※>/filelist_pre.txt
snapshot-<ホスト名>-log-<yyyyMMddHHmmss※>.2/filelist_pre.txt

実際に収集したファイルの一覧
snapshot-<ホスト名>-log-<yyyyMMddHHmmss※>/filelist_post.txt
snapshot-<ホスト名>-log-<yyyyMMddHHmmss※>.2/filelist_post.txt

注※　yyyy：西暦　MM：月　dd：日　HH：時　mm：分　ss：秒

5.3.3　snapshotログの収集

snapshotログは，自動実行されるほか，運用管理コマンド（mngsvrutil）を使用して任意のタイミングで収集できます。

なお，取得できる情報の種類は，トラブル発生時に自動的に収集されるsnapshotログと同じです。「5.3.2(2)　snapshotログとして収集できる資料」を参照してください。

ログの出力先については，adminagent.propertiesファイル（運用管理エージェントプロパティファイル）のadminagent.snapshotlog.log_dirキーの値を参照してください。デフォルトの出力先は次のディレクトリです。

Windowsの場合
<Managerのログ出力ディレクトリ>¥snapshot

UNIXの場合
<Managerのログ出力ディレクトリ>/snapshot

snapshotログを収集するには，運用管理コマンド（mngsvrutil）にサブコマンド「collect」を指定して実行します。-tオプションで指定したホスト内のsnapshotログが収集できます。

コマンドの実行形式と実行例を次に示します。この例では，一次送付ファイルと二次送付ファイルの両方を収集します。<n>には，一次送付資料または二次送付資料のどちらを収集するかを指定します。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <ホスト名> -k host collect snapshot <n>

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host collect snapshot 1
mngsvrutil -m mnghost -u user01 -p pw1 -t host01 -k host collect snapshot 2

5.4　資料の個別取得

Cosminexusの構成ソフトウェアが出力するログなどの資料を，snapshotログを使用しないで個別に取得することもできます。ここでは，トラブル発生時に必要な資料を個別に取得する場合の方法について説明します。

snapshotログを使用しない場合に個別に取得する必要がある資料と参照先を次の表に示します。

表5-6　取得が必要な資料

取得する資料 | 参照先
Cosminexusのログ（J2EEアプリケーションを実行するシステムの場合） | 5.4.1
Cosminexusのログ（バッチアプリケーションを実行するシステムの場合） | 5.4.2
性能解析トレース | 5.4.4
JavaVMのスレッドダンプ | 5.4.5
JavaVMのガーベージコレクションログ | 5.4.6
メモリダンプ | 5.4.7
日立固有のJavaVMログ（日立JavaVMログファイル） | 5.4.8
JavaVM出力メッセージログ（標準出力またはエラーリポートファイル） | 5.4.9
OSの状態情報，OSのログ | 5.4.10
OSの統計情報 | 5.4.11
Cosminexusの定義情報 | 5.4.12
Cosminexusの作業ディレクトリの内容 | 5.4.13
Cosminexusのリソース設定情報 | 5.4.14
Webサーバログ | 5.4.15
JavaVMのスタックトレース情報 | 5.4.16

なお，EJBクライアントアプリケーションを実行するシステムの場合は，EJBクライアントアプリケーションのシステムログも取得してください。EJBクライアントアプリケーションのシステムログの取得方法については「5.4.3　EJBクライアントアプリケーションのシステムログの取得」を参照してください。

＜この節の構成＞

5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）

5.4.2　Cosminexusのログの取得（バッチアプリケーションを実行するシステム）

5.4.3　EJBクライアントアプリケーションのシステムログの取得

5.4.4　性能解析トレースの取得

5.4.5　JavaVMのスレッドダンプの取得

5.4.6　JavaVMのガーベージコレクションログの取得

5.4.7　メモリダンプの取得

5.4.8　日立固有のJavaVMログの取得（日立JavaVMログファイル）

5.4.9　JavaVM出力メッセージログの取得（標準出力またはエラーリポートファイル）

5.4.10　OSの状態情報とOSのログの取得

5.4.11　OSの統計情報の取得

5.4.12　Cosminexusの定義情報の取得

5.4.13　Cosminexusの作業ディレクトリの内容の取得

5.4.14　Cosminexusのリソース設定情報の取得

5.4.15　Webサーバログの取得

5.4.16　JavaVMのスタックトレース情報の取得

5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）

ここでは，Cosminexusの構成ソフトウェアが出力するログを手動で取得する方法について説明します。なお，snapshotログとしてCosminexusのログをすでに収集している場合は，ここで説明する操作は不要です。

ここでは，次のログの取得方法について説明します。

Cosminexus Component Containerのログ

Cosminexus Performance Tracerのログ

Cosminexus Component Transaction Monitorのログ

Cosminexus DABroker Libraryのログ

監査ログで出力するログ

アプリケーションのユーザログ

構築済み実行環境の切り替えで出力するログ

参考

Hitachi Web Serverのログの取得方法については，「5.4.15　Webサーバログの取得」で説明します。

＜この項の構成＞

(1)　Cosminexus Component Containerのログの取得

(2)　Cosminexus Performance Tracerのログの取得

(3)　Cosminexus Component Transaction Monitorのログの取得

(4)　Cosminexus DABroker Libraryのログの取得

(5)　監査ログで出力するログの取得

(6)　アプリケーションのユーザログの取得

(7)　構築済み実行環境の切り替えで出力するログの取得

(1)　Cosminexus Component Containerのログの取得

Cosminexus Component Containerのログの種類とログの出力先について説明します。Cosminexus Component Containerのログには，次の3種類のログがあります。

J2EEサーバ・リダイレクタ・サーバ管理コマンドのログ

運用管理エージェント・運用監視エージェント・Management Serverのログ

統合ユーザ管理のログ

それぞれのログの出力先について説明します。

注意

Web Redirectorを使用する場合は，リダイレクタのログの格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCR」と読み替えてください。

(a)　J2EEサーバ・リダイレクタ・サーバ管理コマンドのログの取得

J2EEサーバ・リダイレクタ・サーバ管理コマンドのログの取得方法について説明します。

また，Cosminexus Component Containerでは，これらのログに加えて，移行コマンドのログが出力されます。インプロセスHTTPサーバを使用している場合はインプロセスHTTPサーバのログが，リソース枯渇監視機能を使用している場合はリソース枯渇監視ログが，Server Plug-inを使用しているときはServer Plug-inのログが出力されます。

J2EEサーバおよびリダイレクタのログには，メッセージログ，ユーザログ，例外ログ，および保守用ログの4種類があります。なお，J2EEサーバでは，これらのログに加えて，起動，停止および異常終了時にイベントログまたはsyslogを出力します。

サーバ管理コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

リソースアダプタのバージョンアップコマンド（cjrarupdate）のログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

インプロセスHTTPサーバのログには，アクセスログ，スレッドトレース，および通信トレースの3種類があります。

移行コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

次にそれぞれのログについて説明します。

メッセージログ

J2EEサーバ，サーバ管理コマンド，移行コマンドなどの稼働状態が出力されます。各種サーバおよびコマンドの稼働監視の情報として使用します。

ユーザログ

アプリケーション中で出力される標準出力および標準エラー出力の情報が出力されます。アプリケーションの開発時の動作確認用に使用します。Solaris以外の場合，JavaVMのメモリ関連ログも含みます。

例外ログ

システムでトラブルが発生したときのCosminexus Component Containerの例外情報が出力されます。なお，例外ログは日常的な運用で監視する必要はありません。ログにメッセージが出力された場合に，例外情報を参照するときにご利用ください。

保守用ログ

システムでトラブルが発生したときのCosminexus Component Containerの障害保守情報が出力されます。保守員がCosminexus Component Containerの障害解析用に使用します。

イベントログ（Windowsの場合）

J2EEサーバが起動，停止または異常終了したことを示す情報が出力されます。出力先はWindowsのイベントログの設定によって異なります。

なお，イベントログは，J2EEサーバの停止のしかたによっては，出力されません。次の場合は，正しくログが出力されないことがあります。

J2EEサーバが動作しているJavaVM自体に問題が発生した場合

J2EEサーバのプロセスをTerminateProcessによって外部から停止した場合

JavaVMの起動オプションとして-XX:+HitachiOutOfMemoryAbortオプションを指定している場合にメモリ不足によってJ2EEサーバが異常終了したとき
なお，-XX:+HitachiOutOfMemoryAbortオプションは，デフォルトで設定されているオプションです。

syslog（UNIXの場合）

J2EEサーバが起動，停止または異常終了したことを示す情報が出力されます。出力先はUNIXのsyslogの設定によって異なります。

なお，syslogは，J2EEサーバの停止のしかたによっては，出力されません。次の場合は，正しくログが出力されないことがあります。

J2EEサーバが動作しているJavaVM自体に問題が発生した場合

J2EEサーバのプロセスをSIGKILLシグナル（kill -9など）によって外部から停止した場合

JavaVMの起動オプションとして-XX:+HitachiOutOfMemoryAbortオプションを指定している場合にメモリ不足によってJ2EEサーバが異常終了したとき
-XX:+HitachiOutOfMemoryAbortオプションは，デフォルトで設定されているオプションです。

インプロセスHTTPサーバのログ

インプロセスHTTPサーバを使用している場合に，保守情報およびリクエストの処理結果が出力されます。保守情報は，保守員がCosminexus Component Containerの障害解析用に使用します。リクエストの処理結果はアクセスログとして，インプロセスHTTPサーバのパフォーマンス情報，セッショントラッキング情報などの分析に使用します。

リソース枯渇監視ログ

リソース枯渇監視機能を使用している場合に，監視対象のリソースについてのリソース枯渇監視情報が出力されます。リソースの使用率または使用数がしきい値を超えた場合の原因調査に使用します。

ログは，若い面番号の付いたログファイルから順に記録されます。一つのログファイルのサイズが1面当たりの最大サイズに達すると，ログは次の面番号の付いたログファイルに記録されます。最後のログファイル（面数の番号が付いたログファイル）のサイズが1面当たりの最大サイズに達すると，面の番号1のログファイルを空にし，そこへログを記録していきます。以降，ログファイルを空にしながら，面番号の順にログファイルへログを記録していきます。

ログの出力先のデフォルトを次の表に示します。Cosminexus Component Containerのログは，サーバ単位またはコマンド単位に取得できます。

ログの出力先に示す<作業ディレクトリ>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public（Windowsの場合），または/opt/Cosminexus/CC/server/public（UNIXの場合）です。

●J2EEサーバおよびリダイレクタのログ

表5-7　J2EEサーバおよびリダイレクタのログの出力先（デフォルト）

分類
内容
ログ出力先およびログファイル名※1
デフォルトのサイズ×面数
チャネル名

メッセージログ
稼働ログ

Windowsの場合
<ejb.server.log.directory>※2¥cjmessage[n].log

UNIXの場合
<ejb.server.log.directory>※2/cjmessage[n].log

1MB×2
MessageLogFile

ログ稼働ログ

Windowsの場合
<ejb.server.log.directory>※2¥cjlogger.log

UNIXの場合
<ejb.server.log.directory>※2/cjlogger.log

－
MessageLogFile

リダイレクタのメッセージログ
ディレクトリ※3

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

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs

4MB×5
－

ファイル名※3

Windowsの場合
isapi_redirect[n].log（Microsoft IIS）
hws_redirect[n].log（Hitachi Web Server）

UNIXの場合
hws_redirect[n].log（Hitachi Web Server）

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの稼働ログ※4

Windowsの場合
（Connector 1.0仕様のリソースアダプタ）
<ejb.server.log.directory>※2¥connectors¥<リソースアダプタの表示名>[n].log
（Connector 1.5仕様のリソースアダプタ）
<ejb.server.log.directory>※2¥connectors¥<リソースアダプタの表示名>_<コネクション定義の並び順>_[n].log

UNIXの場合
（Connector 1.0仕様のリソースアダプタ）
<ejb.server.log.directory>※2/connectors/<リソースアダプタの表示名>[n].log
（Connector 1.5仕様のリソースアダプタ）
<ejb.server.log.directory>※2/connectors/<リソースアダプタの表示名>_<コネクション定義の並び順>_[n].log

1MB×2
－

J2EEアプリケーションに含めて使用するリソースアダプタの稼働ログ※4

Windowsの場合
（通常モード／Connector 1.0仕様のリソースアダプタ）
<ejb.server.log.directory>※2¥connectors¥<J2EEアプリケーション名>¥<リソースアダプタの表示名>[n].log
（テストモード／Connector 1.0仕様のリソースアダプタ）
<ejb.server.log.directory>※2¥connectors¥test#<J2EEアプリケーション名>¥<リソースアダプタの表示名>[n].log
（通常モード／Connector 1.5仕様のリソースアダプタ）
<ejb.server.log.directory>※2¥connectors¥<J2EEアプリケーション名>¥<リソースアダプタの表示名>_<コネクション定義の並び順>_[n].log
（テストモード／Connector 1.5仕様のリソースアダプタ）
<ejb.server.log.directory※2>¥connectors¥test#<J2EEアプリケーション名>¥<リソースアダプタの表示名>_<コネクション定義の並び順>_[n].log

UNIXの場合
（通常モード／Connector 1.0仕様のリソースアダプタ）
<ejb.server.log.directory>※2/connectors/<J2EEアプリケーション名>/<リソースアダプタの表示名>[n].log
（テストモード／Connector 1.0仕様のリソースアダプタ）
<ejb.server.log.directory>※2/connectors/test#<J2EEアプリケーション名>/<リソースアダプタの表示名>[n].log
（通常モード／Connector 1.5仕様のリソースアダプタ）
<ejb.server.log.directory>※2/connectors/<J2EEアプリケーション名>/<リソースアダプタの表示名>_<コネクション定義の並び順>_[n].log
（テストモード／Connector 1.5仕様のリソースアダプタ）
<ejb.server.log.directory>※2/connectors/test#<J2EEアプリケーション名>/<リソースアダプタの表示名>_<コネクション定義の並び順>_[n].log

1MB×2
－

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

Windowsの場合
<ejb.server.log.directory>※2¥web_servlet[n].log

UNIXの場合
<ejb.server.log.directory>※2/web_servlet[n].log

4MB×4
WebServletLogFile

ユーザ出力ログ

Windowsの場合
<ejb.server.log.directory>※2¥user_out[n].log

UNIXの場合
<ejb.server.log.directory>※2/user_out[n].log

1MB×2
UserOutLogFile

ユーザエラーログ

Windowsの場合
<ejb.server.log.directory>※2¥user_err[n].log

UNIXの場合
<ejb.server.log.directory>※2/user_err[n].log

1MB×2
UserErrLogFile

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

Windowsの場合
<ejb.server.log.directory>※2¥javalog[nn].log

UNIXの場合
<ejb.server.log.directory>※2/javalog[nn].log

256KB×4
－

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

Windowsの場合
<ejb.server.log.directory>※2¥cjexception[n].log

UNIXの場合
<ejb.server.log.directory>※2/cjexception[n].log

1MB×2
ExceptionLogFile

保守用ログ
保守情報

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjmaintenance[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjmaintenance[n].log

16MB×4
MaintenanceLogFile

コンソールメッセージ

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjconsole[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjconsole[n].log

1MB×2
ConsoleLogFile

EJBコンテナの保守情報

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjejbcontainer[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjejbcontainer[n].log

1MB×2
EJBContainerLogFile

Webコンテナの保守情報

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjwebcontainer[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjwebcontainer[n].log

1MB×2
WebContainerLogFile

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

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjstdout.log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjstdout.log

－
－

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

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjstderr.log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjstderr.log

－
－

終了プロセス情報

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cj_shutdown[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cj_shutdown[n].log

4KB×2※7
－

リダイレクタの保守用トレースログ
ディレクトリ※3

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

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs/

16MB×4
－

ファイル名※3

Windowsの場合
iis_rd_trace[n].log（Microsoft IIS）
hws_rd_trace[n].log（Hitachi Web Server）

UNIXの場合
hws_rd_trace[n].log（Hitachi Web Server）

イベントログ
J2EEサーバの起動，停止または異常終了を示すログ
Windowsのイベントビューアのアプリケーションログ※8
－
－

syslog
J2EEサーバの起動，停止または異常終了を示すログ
UNIXのsyslogの設定に依存します。※9
－
－

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

ただし，リダイレクタでMicrosoft IIS 6.0を使用する場合，またはEJBクライアントアプリケーションのサブディレクトリ共有モードを使用する場合は，最大面数が64になります。

また，[nn]の部分には，01～99の通し番号が付きます。

注※2

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

簡易構築定義ファイルのejb.server.log.directoryパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注※3

ディレクトリ，ファイル名は，isapi_redirect.conf（Microsoft IIS用リダイレクタ動作定義ファイル），またはmod_jk.conf（Hitachi Web Server用リダイレクタ動作定義ファイル）で設定できます。リダイレクタのログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。各ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

リダイレクタのメッセージログに出力されるメッセージのうち，KDJE21000-Z～KDJE21999-Z（Zは変数で，E（エラーメッセージ），W（警告メッセージ），I（通知メッセージ）を示します）は，保守用のメッセージとなります。

注※4

リソースアダプタのログを取得するかどうかは，サーバ管理コマンド，またはServer Plug-inで指定されている内容に従います。また，リソースアダプタのログは，簡易構築定義ファイルでサイズおよび面数を変更できます。リソースアダプタのログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

注※5

サーブレット，JSPで発生した例外のスタックトレースについても出力されます。

注※6

起動プロセス情報だけを取得するログです。主にJ2EEサーバの起動または終了時に出力されるため，オンライン中に出力されることはほとんどありません。ファイルのサイズが上限に達したときは，<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs下（Windowsの場合），または<作業ディレクトリ>/ejb/<サーバ名称>/logs下（UNIXの場合）のcjstdout_save.logまたはcjstderr_save.logに退避されます。すでにcjstdout_save.logまたはcjstderr_save.logがあったときは，上書きされます。

注※7

サイズおよび面数は，変更できません。

注※8

ログファイルの出力先はWindowsのイベントログの設定によって異なります。

注※9

J2EEサーバの起動，停止および異常終了のメッセージをsyslogに出力するためには，syslogの設定で，facility「daemon」に対するpriorityを「info」または「debug」に設定する必要があります。syslogの設定に関する詳細については，OS付属のマニュアルを参照してください。

注意

WebサーバとしてHitachi Web Server（UNIX）を使用している場合，リダイレクタのログファイルは，Webサーバの起動時に，mod_jk.confで指定したファイルサイズで，指定した面数分，すべて作成されます。このとき，トレースファイルは空白（0x20）で初期化されます。デフォルトのファイルサイズと面数で運用している場合，ログの出力先に指定したディレクトリに，84メガバイトのディスク容量が必要になります。

WebサーバとしてMicrosoft IIS 6.0を使用している場合，リダイレクタのログファイルは，Webサーバへの初回アクセス時に，isapi_redirect.confで指定したファイルサイズで，指定した面数分，すべて作成されます。このとき，トレースファイルは空白（0x20）で初期化されます。デフォルトのファイルサイズと面数で運用している場合，ログの出力先に指定したディレクトリに，84メガバイトのディスク容量が必要になります。

UNIXの場合，リダイレクタの保守用トレースログを取得する前に次のコマンドを実行してください。
/opt/hitachi/HNTRLib2/bin/hntr2sync <JkTraceLogFileDirの指定値>/<JkTraceLogFilePrefixの指定値>
なお，JkTraceLogFileDirおよびJkTraceLogFilePrefixはmod_jk.conf（Hitachi Web Server用リダイレクタ動作定義ファイル）に指定するキーです。

参考

セッションフェイルオーバ機能を使用している場合，セッションフェイルオーバについてのログは次の出力先に出力されます。

セッションフェイルオーバ機能のログ
セッションフェイルオーバ機能を使用しているJ2EEサーバのログとして出力されます。

SFOサーバのログ
SFOサーバとして動作しているJ2EEサーバのログは，J2EEサーバと同じディレクトリに出力ます。また，SFOサーバ上で動作するSFOサーバアプリケーションのログも，SFOサーバアプリケーションが動作しているJ2EEサーバのログに出力されます。

●サーバ管理コマンドのログ

表5-8　サーバ管理コマンドのログの出力先（デフォルト）

分類
内容
ログ出力先およびログファイル名※1
デフォルトのサイズ×面数
チャネル名

メッセージログ
稼働ログ※2　※3

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥cjmessage[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/cjmessage[n].log

1024KB×3
MessageLogFile

ログ稼働ログ※2

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥cjlogger.log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/ cjlogger.log

1024KB×2
－

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥cjexception[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/cjexception[n].log

1024KB×6
ExceptionLogFile

保守用ログ
保守情報※2

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjmaintenance[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjmaintenance[n].log

1024KB×3
MaintenanceLogFile

コンソールメッセージ※2

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjconsole[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjconsole[n].log

32KB×3
ConsoleLogFile

サーバ管理コマンドの保守情報※2

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjserveradmin[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjserveradmin[n].log

32KB×3
ServerAdminLogFile

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

注※2

日立トレース共通ライブラリ形式の出力メッセージ（アプリケーション識別名）には，コマンド名が表示されます。

注※3

互換モードの場合，稼働ログと障害発生時の例外情報の出力先は標準モードと異なります。互換モードの場合の出力先とデフォルトのサイズ・面数は次のようになります。

表5-9　サーバ管理コマンドのログの出力先（互換モード）

内容
ログ出力先およびログファイル名※
デフォルトのサイズ×面数

稼働ログ

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥admin¥logs¥<コマンド名称>message[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/<コマンド名称>message[n].log

128KB×2

障害発生時の例外情報

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥admin¥logs¥<コマンド名称>exception[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/<コマンド名称>exception[n].log

256KB×2

注※

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

サーバ管理コマンドのメッセージログに出力されるメッセージには，メッセージIDフィールドが空白で，メッセージテキストフィールドにメッセージID（KDJEnnnnn-Yなど）が含まれる場合があります。それらはサーバ側で発生したメッセージで，前後に出力されるメッセージの付加情報となります。

●リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

表5-10　リソースアダプタバージョンアップコマンド（cjrarupdate）のログの出力先

分類
内容
ログ出力先およびログファイル名※
デフォルトのサイズ×面数
チャネル名

メッセージログ
稼働ログ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjrarupdatemessage[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjrarupdatemessage[n].log

1MB×2
－

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjrarupdateexception[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjrarupdateexception[n].log

1MB×2
－

保守用ログ
保守情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjrarupdatemaintenance[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjrarupdatemaintenance[n].log

1MB×2
－

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

●インプロセスHTTPサーバのログ

表5-11　インプロセスHTTPサーバのログの出力先（デフォルト）

分類
内容
ログ出力先およびログファイル名
デフォルトのサイズ×面数
チャネル名

アクセスログ
インプロセスHTTPサーバの処理結果

Windowsの場合
<ejb.server.log.directory>※1¥http¥cjhttp_access.inprocess_http[n].log※2

UNIXの場合
<ejb.server.log.directory>※1/http/cjhttp_access.inprocess_http[n].log※2

4MB×16
－

スレッドトレース
スレッドトレースの情報

Windowsの場合
<ejb.server.log.directory>※1¥http¥maintenance¥thr¥cjhttp_thr.<時間情報>.inprocess_http.mm※3

UNIXの場合
<ejb.server.log.directory>※1/http/maintenance/thr/cjhttp_thr.<時間情報>.inprocess_http.mm※3

約3.2MB※4×16
－

通信トレース
通信トレースの情報

Windowsの場合
<ejb.server.log.directory>※1¥http¥maintenance¥comm¥cjhttp_comm.<時間情報>.inprocess_http.mm※3

UNIXの場合
<ejb.server.log.directory>※1/http/maintenance/comm/cjhttp_comm.<時間情報>.inprocess_http.mm※3

約16.6MB※4×16
－

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

簡易構築定義ファイルのejb.server.log.directoryパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注※2

[n]には，面の番号（1から面数（最大16）まで）が付きます。

注※3

<時間情報>には，ファイルを出力した日時が，「YYYYMMDDHHmmSSnnn」形式で表示されます。例えば，ファイルを出力した時間が，2005年1月20日10時50分30.158秒だった場合，ファイル名は「cjhttp_thr.20050120105030158.inprocess_http.mm」または「cjhttp_comm.20050120105030158.inprocess_http.mm」になります。

注※4

起動するたびに新規にトレースファイルが作成されます。面数が最大値（デフォルト値は16）を超えると，最も古い日時のファイルを再利用します。

ファイルサイズは次のように決定されます。

スレッドトレースのファイルサイズ＝(((A+B)×32786)＋32914)バイト

通信トレースのファイルサイズ＝(((A+B)×172050)＋128)バイト

A＝webserver.connector.inprocess_http.max_connectionsの値

B＝webserver.connector.inprocess_http.send_timeoutの値が0の場合0，0以外の場合1

注意

インプロセスHTTPサーバのスレッドトレースと通信トレースを取得する前に，次のコマンドを実行してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtracesync [-thr|-comm] <サーバ名称>

UNIXの場合

/opt/Cosminexus/CC/admin/bin/cjtracesync [-thr|-comm] <サーバ名称>

cjtracesyncコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」のcjtracesyncコマンドに関する説明を参照してください。

●移行コマンド（cjenvupdate）のログ

表5-12　移行コマンド（cjenvupdate）のログの出力先

分類
内容
ログ出力先およびログファイル名※
デフォルトのサイズ×面数
チャネル名

メッセージログ
cjenvupdateコマンドの稼働ログ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjenvupdatemessage[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjenvupdatemessage[n].log

4MB×4
－

例外ログ
cjenvupdateコマンドの例外情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjenvupdateexception[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjenvupdateexception[n].log

4MB×4
－

保守用ログ
cjenvupdateコマンドの保守情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjenvupdatemaintenance[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjenvupdatemaintenance[n].log

4MB×4
－

注※

[n]には，面の番号（1から面数（最大16）まで）が付きます。

●リソース枯渇監視のログ

表5-13　リソース枯渇監視のログの出力先

監視対象
リソース
ログ取得場所およびログファイル名※1
デフォルトのサイズ×面数
チャネル名※2

メモリ

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjmemorywatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjmemorywatch[n].log

1MB×2
MemoryWatchLogFile

ファイルディスクリプタ

UNIXの場合※4
<ejb.server.log.directory>※3/watch/cjfiledescriptorwatch[n].log

1MB×2
FileDescriptorWatchLogFile

スレッド

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjthreadwatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjthreadwatch[n].log

1MB×2
ThreadWatchLogFile

スレッドダンプ

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjthreaddumpwatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjthreaddumpwatch[n].log

1MB×2
ThreaddumpWatchLogFile

HTTPリクエスト実行待ちキュー

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjrequestqueuewatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjrequestqueuewatch[n].log

1MB×2
RequestQueueWatchLogFile

HTTPセッション数

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjhttpsessionwatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjhttpsessionwatch[n].log

1MB×2
HttpSessionWatchLogFile

コネクションプール

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjconnectionpoolwatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjconnectionpoolwatch[n].log

1MB×2
ConnectionPoolWatchLogFile

注※1

[n]には，面の番号（1から面数（最大16）まで）が付きます。

注※2

ログの出力先を識別する名称で，ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※3

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

簡易構築定義ファイルのejb.server.log.directoryパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注※4

Windowsの場合，またはAIXの場合は，ファイルディスクリプタを監視できません。

リソース枯渇監視ログファイルに出力される情報やログファイルの出力形式については，「2.5　リソース枯渇の監視」を参照してください。

●ログの出力先を設定するユーザ定義ファイル

J2EEサーバ，リダイレクタ，およびサーバ管理コマンドのログの出力先を変更している場合は，次の表に示す，ログの出力先を設定するユーザ定義ファイルを参照して出力先を確認してください。なお，ログの出力先を変更した場合，変更後の出力先はsnapshotログの一括収集時に収集対象外となります。必要に応じてsnapshotログの収集先を変更してください。

表5-14　ログの出力先を設定するユーザ定義ファイル

分類
ユーザ定義ファイル

J2EEサーバ
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に指定する，ejb.server.log.directoryパラメタ
デフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/logs」（UNIXの場合）です。

リダイレクタ

Hitachi Web Serverの場合

メッセージログ
簡易構築定義ファイルの論理Webサーバ（web-server）の<configuration>タグ内に指定する，JkLogFileDirパラメタ
デフォルトは，「logs」です。

保守用トレースログ
簡易構築定義ファイルの論理Webサーバ（web-server）の<configuration>タグ内に指定する，JkTraceLogFileDirパラメタ
デフォルトは，「logs」です。

Microsoft IISの場合

メッセージログ
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥isapi_redirect.confのlog_file_dirキー
キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs」です。

保守用トレースログ
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥isapi_redirect.confのtrace_log_file_dirキー
キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs」です。

サーバ管理コマンド
サーバ管理コマンドのusrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のejbserver.log.directoryキー
キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/admin/logs」（UNIXの場合）です。
Management Serverリモート管理機能から操作した場合は，サーバ管理コマンドのログ出力先は変更できません。

ログの出力先の変更方法など，トラブルシューティングの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(b)　運用管理エージェント・運用監視エージェント・Management Serverのログの取得

ここでは，運用管理エージェント，運用監視エージェント，およびManagement Serverのログの出力先について説明します。

運用管理エージェント・運用監視エージェント・Management Serverのログには，個別に取得する以外に，統合ログとしてまとめて取得できるものがあります。統合ログには，次の種類があります。

統合メッセージログ
Managerのメッセージログが統合されて出力されます。

統合トレースログ
Managerのトレースログが統合されて出力されます。

コマンド保守ログ※
運用管理コマンド，Smart Composer機能で使用するコマンド，およびsnapshotlogコマンドのトレースログが統合されて出力されます。

注※　Smart Composer機能で使用するコマンドの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

統合ログの出力先を次の表に示します。

表5-15　統合ログの出力先（Windowsの場合）

ファイル名 | 内容 | 出力先ディレクトリ
mngmessage[n]. ※1log | 統合メッセージログ | <Managerのログ出力ディレクトリ>¥message※2
mngtrace[n] ※1.log | 統合トレースログ | <Managerのログ出力ディレクトリ>¥trace※2
mngcmd[n] ※1.log | コマンド保守ログ | <Managerのログ出力ディレクトリ>¥maintenance※2

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大64）まで）が付きます。

注※2

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）で指定されたディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥manager¥logです。manager.cfgの詳細はマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

表5-16　統合ログの出力先（UNIXの場合）

ファイル名 | 内容 | 出力先ディレクトリ
mngmessage[n] ※1.log | 統合メッセージログ | <Managerのログ出力ディレクトリ>/message※2
mngtrace[n] ※1.log | 統合トレースログ | <Managerのログ出力ディレクトリ>/trace※2
mngcmd[n] ※1.log | コマンド保守ログ | <Managerのログ出力ディレクトリ>/maintenance※2

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大64）まで）が付きます。

注※2

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）で指定されたディレクトリを指します。デフォルト値は，/opt/Cosminexus/manager/logです。manager.cfgの詳細はマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

なお，統合ログに出力したログは，デフォルトでは個別のログとしても出力されます。

また，統合ログに出力した場合には個別に出力しない設定にできるログもあります。統合ログの出力に関する設定については，マニュアル「Cosminexus　システム構築ガイド」のCosminexus Managerのログ取得の設定に関する説明を参照してください。

個別に取得する場合の運用管理エージェント，運用監視エージェント，およびManagement Serverのログの出力先，および統合メッセージログ・統合トレースログへの出力の有無を次の表に示します。

なお，表中の<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）で指定されたディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥manager¥log（Windowsの場合），または/opt/Cosminexus/manager/log（UNIXの場合）です。manager.cfgの詳細はマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

表5-17　運用管理エージェント，運用監視エージェント，およびManagement Serverのログを個別に取得する場合の出力先（Windowsの場合）

分類
ファイル名
内容
出力先ディレクトリ
統合メッセージログ／統合トレースログ

運用管理エージェント
adminagent.err.[1-16].log※2
運用管理エージェントの標準エラー出力
<Managerのログ出力ディレクトリ>
－

adminagent.out.[1-16].log※2
運用管理エージェントの標準出力
－

adminagent.err
運用管理エージェントの標準エラー出力コマンドライン
－

adminagent[1-16].log
運用管理エージェントのログ
○

adminagentctl.exe.[1-2].log
運用管理エージェントの起動・停止コマンドのログ
－

adminagent[n]※1.log
運用管理エージェントの保守ログ
<Managerのログ出力ディレクトリ>¥maintenance
－

mngrmi[n] ※1.log
運用管理エージェントが行うRMI処理での保守ログ
－

processConsole[n]※1.log
コンソールログ
<Managerのログ出力ディレクトリ>
－

adminagentsv.exe.[1-16]log※2
運用管理エージェントサービスのログ
－

adminagentsv.exe.out※2
運用管理エージェントサービスの標準出力
－

adminagentsv.exe.err※2
運用管理エージェントサービスの標準エラー出力
－

運用監視エージェント
mngagent-<ドメイン名>-<Agent名>.[n]※1.log※3

運用監視エージェントのログ・トレース

J2EEサーバ用システムJP1イベントおよびJ2EEサーバ用ユーザJP1イベントのログ※4

Managementイベント発行ログ※5

－

Management Server
mngsvr.exe.[1-2
].log
Management Serverサービスのログ
－

mngsvr.exe.err※2
Management Serverサービスの標準エラー出力
－

mngsvr.exe.out※2
Management Serverサービスの標準出力
－

mngsvrctl.exe.[1-2].log
Management Serverサービス起動・停止コマンドのログ
－

mngsvr[n]※1.log
Management Serverのログ
Cosminexusの運用管理サーバのシステムJP1イベントのログ※4
○

mngsvr[n]※1.log
Management Serverの保守ログ
<Managerのログ出力ディレクトリ>¥maintenance
－

（凡例）　○：統合ログに出力されます　－：統合ログには出力されません

注※1

ファイル名の[n]の部分には，1～指定したログの面数の通し番号が付きます。

注※2

日立トレース共通ライブラリ形式以外の形式でログが出力されます。

注※3

運用監視エージェントのログ・トレースの出力先は変更できます。運用監視エージェントのログ・トレースの出力先を変更している場合は，mngagent.propertiesファイル（運用監視エージェントプロパティファイル）のmngagent.log.filenameキーの値を参照してください。

注※4

JP1と連携してCosminexusで構築したシステムを運用する場合に出力されます。

注※5

Managementイベントを使用している場合に出力されます。

表5-18　運用管理エージェント，運用監視エージェント，およびManagement Serverのログを個別に取得する場合の出力先（UNIXの場合）

分類
ファイル名
内容
出力先ディレクトリ
統合メッセージログ／統合トレースログ

運用管理エージェント
adminagent.err.[1-16].log※2
運用管理エージェントの標準エラー出力
<Managerのログ出力ディレクトリ>
－

adminagent.out.[1-16].log※2
運用管理エージェントの標準出力
－

adminagent.err
運用管理エージェントの標準エラー出力コマンドライン
－

adminagent[1-16].log
運用管理エージェントのログ
○

adminagentctl.[1-16].log
運用管理エージェントの起動・停止コマンドのログ
－

adminagent[n]※1.log
運用管理エージェントの保守ログ
<Managerのログ出力ディレクトリ>/maintenance
－

mngrmi[n] ※1.log
運用管理エージェントが行うRMI処理での保守ログ
－

processConsole[n]※1.log
コンソールログ
<Managerのログ出力ディレクトリ>
－

運用監視エージェント
mngagent-<ドメイン名>-<Agent名>.[n]※1.log※3

運用監視エージェントのログ・トレース

J2EEサーバ用システムJP1イベントおよびJ2EEサーバ用ユーザJP1イベントのログ※4

Managementイベント発行ログ※5

－

Management Server
mngsvrctlstart.[1-2].log
Management Server起動コマンド
－

mngsvrctlstop.[1-2].log
Management Server停止コマンド
－

mngsvrctlsetup.[1-2].log
Management Serverセットアップコマンド
－

mngsvr[n].log
Management Serverのログ
Cosminexusの運用管理サーバのシステムJP1イベントのログ※4
○

mngenvsetup.[1-2].log
mngenvsetupコマンドの実行ログ
<Managerのログ出力ディレクトリ>/maintenance
－

mngsvr[n]※1.log
Management Serverの保守ログ
<Managerのログ出力ディレクトリ>/maintenance
－

（凡例）　○：統合ログに出力されます　－：統合ログには出力されません

注※1

ファイル名の[n]の部分には，1～指定したログの面数の通し番号が付きます。

注※2

日立トレース共通ライブラリ形式以外の形式でログが出力されます。

注※3

運用監視エージェントのログ・トレースの出力先は変更できます。運用監視エージェントのログ・トレースの出力先を変更している場合は，mngagent.propertiesファイル（運用監視エージェントプロパティファイル）のmngagent.log.filenameキーの値を参照してください。

注※4

JP1と連携してCosminexusで構築したシステムを運用する場合に出力されます。

注※5

Managementイベントを使用している場合に出力されます。

注意

コンソールログには，運用管理エージェントが起動したサーバプロセスの標準出力，および標準エラー出力が出力されます。コンソールログについての注意事項を次に示します。

Windowsの場合，次のプロセスに対しては，コンソールログは出力されません。
論理パフォーマンストレーサ
論理Webサーバ
論理CTMドメインマネジャ
論理CTM
間接起動の論理ユーザサーバ
論理ユーザサーバの起動種別については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

コンソールログに出力する情報が一度に複数行出力された場合，コンソールログには1行にまとめて表示されることがあります。

コンソール情報に出力する情報の文字数が2039文字を超えてしまう場合，2039文字以降の情報は次の行に分割されて出力されます。

(c)　統合ユーザ管理のログの取得

統合ユーザ管理のトレースファイルは，ua.confファイル（統合ユーザ管理のコンフィグレーションファイル）のcom.cosminexus.admin.auth.trace.prefixオプションの設定に応じて出力されます。ua.confファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(d)　ログ以外に取得が必要な情報

ここでは，ログ以外に取得する必要がある情報について説明します。

インプロセストランザクションサービスを使用している場合

インプロセストランザクションサービスを使用している場合，インプロセストランザクションサービスのステータスファイルを取得する必要があります。なお，ステータスファイルを二重化している場合は，予備のステータスファイルも取得してください。

ステータスファイルは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.distributedtx.ots.status.directory1パラメタ，およびejbserver.distributedtx.ots.status.directory2パラメタ（二重化している場合）で指定したパスに格納されています。

(2)　Cosminexus Performance Tracerのログの取得

Cosminexus Performance Tracerのログの種類とログの出力先について説明します。

(a)　Cosminexus Performance Tracerのログの種類

Cosminexus Performance Tracerでは，PRF識別子ごとにPRFデーモン，PRFコマンドのログを出力します。また，システムでトラブルが発生したときの保守員による障害解析用に，モジュールトレースおよび構造化例外発生ログも出力します。

(b)　Cosminexus Performance Tracerのログの出力先

Cosminexus Performance Tracerのログの出力先を次に示します。

表5-19　Cosminexus Performance Tracerのログの出力先

内容
出力先ディレクトリ

PRFデーモンおよびPRFコマンドのログ

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>¥log¥<PRF識別子>¥ctmlog[n]

UNIXの場合
$PRFSPOOL/log/<PRF識別子>/ctmlog[n]

モジュールトレース

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥umt

UNIXの場合
$PRFSPOOL/utt/umt

構造化例外発生ログ

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>¥oslttrc

UNIXの場合
$PRFSPOOL/oslttrc

保守情報

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>

UNIXの場合
$PRFSPOOL/

注　

[n]には「01」または「02」が表示されます。

(3)　Cosminexus Component Transaction Monitorのログの取得

ここでは，Cosminexus Component Transaction Monitorのログの出力先について説明します。

Cosminexus Component Transaction Monitorのログは「<環境変数CTMSPOOLの設定ディレクトリ>¥log」（Windowsの場合），または「$CTMSPOOL/log」（UNIXの場合）に出力されます。デフォルトでは，「<Cosminexusのインストールディレクトリ>¥CTM¥spool¥log」（Windowsの場合），または「/opt/Cosminexus/CTM/spool/log」（UNIXの場合）に出力されます。また，システムでトラブルが発生したときの保守員による障害解析用に，各種保守情報を環境変数CTMSPOOLの設定ディレクトリに出力します。ctmlogcatコマンドを実行することで出力メッセージを確認できます。

表5-20　Cosminexus Component Transaction Monitorのログの出力先

内容
出力先ディレクトリ

CTMデーモンおよびCTMコマンドのログ

Windowsの場合
<環境変数CTMSPOOLの設定ディレクトリ>¥log¥<CTMデーモン識別子>¥ctmlog[n]

UNIXの場合
$CTMSPOOL/log/<CTMデーモン識別子>/ctmlog[n]

保守情報

Windowsの場合
<環境変数CTMSPOOLの設定ディレクトリ>

UNIXの場合
$CTMSPOOL

(4)　Cosminexus DABroker Libraryのログの取得

Cosminexus DABroker Libraryのログの取得方法について説明します。Cosminexus DABroker Libraryでは，トラブルシューティングに使用するログとして，スプール情報を取得します。スプール情報として取得できるのは，次の情報です。

メッセージログ

拡張データベースアクセストレース

エラートレース

Exceptionトレースログ

イベントトレース（DABroker for C++をインストールしている場合）

XAトレース

「<Cosminexus DABroker Libraryの運用ディレクトリ>¥spool下」（Windowsの場合），または「<Cosminexus DABroker Libraryの運用ディレクトリ>/spool下」（UNIXの場合）のすべてのファイルをコピーして保存してください。<Cosminexus DABroker Libraryの運用ディレクトリ>とは，「<Cosminexusのインストールディレクトリ>¥DAB」（Windowsの場合），または「/opt/DABroker」（UNIXの場合）のことです。なお，環境設定によって出力先を変更している場合は，変更した出力先のファイルをコピーして保存してください。

なお，Cosminexus DABroker Libraryのスプール情報のうち，Exceptionトレースログは，運用開始前に取得のための設定をしておく必要があります。Exceptionトレースログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(5)　監査ログで出力するログの取得

ここでは，監査ログの機能を使用した場合に出力されるログファイルについて説明します。

監査ログで出力するログの種類と出力先を次の表に示します。

表5-21　監査ログで出力するのログの出力先（デフォルト）

分類
内容
ログ出力先およびログファイル名※
デフォルトのサイズ×面数

メッセージログ
監査ログのメッセージログ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥auditlog¥rasmessage[n].log

UNIXの場合
/opt/Cosminexus/auditlog/rasmessage[n].log

1MB×4

例外ログ
監査ログの例外情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥auditlog¥rasexception[n].log

UNIXの場合
/opt/Cosminexus/auditlog/rasexception[n].log

1MB×8

注※

ログファイル名の[n]の部分には，面の番号（1から面数（最大64）まで）が付きます。

(6)　アプリケーションのユーザログの取得

アプリケーションのユーザログは，日立トレース共通ライブラリ形式で出力するように設定している場合に取得できます。ユーザログには，次の2種類があります。

J2EEサーバ上で動作するJ2EEアプリケーション（J2EEコンポーネント）が出力するユーザログ

EJBクライアントアプリケーションが出力するユーザログ

(a)　J2EEアプリケーションのユーザログの取得

J2EEアプリケーションのログの出力先については，次のディレクトリに，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にejbserver.application.userlog.CJLogHandler.<ハンドラ名>.pathパラメタで指定したプリフィックスを持つファイル名で出力されます。なお，<ハンドラ名>には，キーの値を区別するためのハンドラ名が指定されています。

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

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

なお，J2EEアプリケーションのユーザログ出力の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(b)　EJBクライアントアプリケーションのユーザログの取得

EJBクライアントアプリケーションのユーザログの出力先については，次のディレクトリにEJBクライアントアプリケーションのシステムプロパティのejbserver.application.userlog.CJLogHandler.<ハンドラ名>.pathキーの値で指定したプリフィックスを持つファイル名で出力されます。なお，<ハンドラ名>には，キーの値を区別するためのハンドラ名が指定されています。

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

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

EJBクライアントアプリケーションでユーザログを出力するためのシステムプロパティの設定方法については，マニュアル「Cosminexus　システム構築ガイド」のEJBクライアントアプリケーションのログ出力の設定に関する説明，またはマニュアル「Cosminexus　機能解説」のEJBクライアントアプリケーションでのユーザログ出力の実装に関する説明を参照してください。

(7)　構築済み実行環境の切り替えで出力するログの取得

構築済み実行環境をcosmienvコマンドで切り替えた場合に出力されるログファイルについて説明します。cosmienvコマンドで出力するログファイルは，コマンド実行時に指定する引数（機能）によって異なります。各ログファイルの出力先は「/opt/Cosminexus/env/log」です。ログファイルのファイルサイズは100キロバイト以内です。また，ファイル面数は2面です。コマンド実行時に指定する引数（機能）ごとのログファイルを次に示します。

引数に-sを指定した場合（退避機能の場合）
cosmienv_s[2].log

引数に-dを指定した場合（回復機能の場合）
cosmienv_d[2].log

引数に-rを指定した場合（削除機能の場合）
cosmienv_r[2].log

ログファイルの出力形式および出力項目については，「5.5.1　Cosminexusのログの調査」を参照してください。

5.4.2　Cosminexusのログの取得（バッチアプリケーションを実行するシステム）

ここでは，Cosminexusの構成ソフトウェアが出力するログを手動で取得する方法について説明します。なお，snapshotログとしてCosminexusのログをすでに収集している場合は，ここで説明する操作は不要です。

ここでは，次のログの取得方法について説明します。

Cosminexus Component Containerのログ

アプリケーションのユーザログ

また，バッチアプリケーションを実行するシステムでは，Cosminexusの構成ソフトウェアが出力するログを手動で取得する場合，次のログも取得してください。

Cosminexus Performance Tracerのログ

Cosminexus DABroker Libraryのログ

監査ログで出力するログ

構築済み実行環境の切り替えで出力するログ

これらのログの取得方法については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」を参照してください。それぞれの参照先の詳細を次に示します。

Cosminexus Performance Tracerのログ
「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」の「(2)　Cosminexus Performance Tracerのログの取得」

Cosminexus DABroker Libraryのログ
「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」の「(4)　Cosminexus DABroker Libraryのログの取得」

監査ログで出力するログ
「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」の「(5)　監査ログで出力するログの取得」

構築済み実行環境の切り替えで出力するログ
「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」の「(7)　構築済み実行環境の切り替えで出力するログの取得」

＜この項の構成＞

(1)　Cosminexus Component Containerのログの取得

(2)　アプリケーションのユーザログの取得

(1)　Cosminexus Component Containerのログの取得

Cosminexus Component Containerのログの種類とログの出力先について説明します。Cosminexus Component Containerのログには，次の2種類のログがあります。

バッチサーバ・サーバ管理コマンド・バッチアプリケーションのログ

運用管理エージェント・運用監視エージェント・Management Serverのログ

それぞれのログの出力先について説明します。

(a)　バッチサーバ・サーバ管理コマンド・バッチアプリケーションのログの取得

バッチサーバ，サーバ管理コマンド，およびバッチアプリケーションのログの取得方法について説明します。

また，Cosminexus Component Containerでは，これらのログに加えて，移行コマンドのログが出力されます。また，リソース枯渇監視機能を使用している場合はリソース枯渇監視ログが，Server Plug-inを使用しているときはServer Plug-inのログが出力されます。

バッチサーバのログには，メッセージログ，ユーザログ，例外ログ，および保守用ログの4種類があります。なお，バッチサーバでは，これらのログに加えて，起動，停止および異常終了時にイベントログまたはsyslogを出力します。

サーバ管理コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

バッチアプリケーションのログは，メッセージログの1種類です。

リソースアダプタのバージョンアップコマンド（cjrarupdate）のログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

移行コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

次にそれぞれのログについて説明します。

メッセージログ

バッチサーバ，サーバ管理コマンド，移行コマンドなどの稼働状態が出力されます。各種サーバおよびコマンドの稼働監視の情報として使用します。

ユーザログ

アプリケーション中で出力される標準出力および標準エラー出力の情報が出力されます。アプリケーションの開発時の動作確認用に使用します。Solaris以外の場合，JavaVMのメモリ関連ログも含みます。

例外ログ

システムでトラブルが発生したときのCosminexus Component Containerの例外情報が出力されます。なお，例外ログは日常的な運用で監視する必要はありません。ログにメッセージが出力された場合に，例外情報を参照するときにご利用ください。

保守用ログ

システムでトラブルが発生したときのCosminexus Component Containerの障害保守情報が出力されます。保守員がCosminexus Component Containerの障害解析用に使用します。

イベントログ（Windowsの場合）

バッチサーバが起動，停止または異常終了したことを示す情報が出力されます。出力先はWindowsのイベントログの設定によって異なります。

なお，イベントログは，バッチサーバの停止のしかたによっては，出力されません。次の場合は，正しくログが出力されないことがあります。

バッチサーバが動作しているJavaVM自体に問題が発生した場合

バッチサーバのプロセスをTerminateProcessによって外部から停止した場合

JavaVMの起動オプションとして-XX:+HitachiOutOfMemoryAbortオプションを指定している場合にメモリ不足によってバッチサーバが異常終了したとき
なお，-XX:+HitachiOutOfMemoryAbortオプションは，デフォルトで設定されているオプションです。

syslog（UNIXの場合）

バッチサーバが起動，停止または異常終了したことを示す情報が出力されます。出力先はUNIXのsyslogの設定によって異なります。

なお，syslogは，バッチサーバの停止のしかたによっては，出力されません。次の場合は，正しくログが出力されないことがあります。

バッチサーバが動作しているJavaVM自体に問題が発生した場合

バッチサーバのプロセスをSIGKILLシグナル（kill -9など）によって外部から停止した場合

JavaVMの起動オプションとして-XX:+HitachiOutOfMemoryAbortオプションを指定している場合にメモリ不足によってバッチサーバが異常終了したとき
-XX:+HitachiOutOfMemoryAbortオプションは，デフォルトで設定されているオプションです。

リソース枯渇監視ログ

リソース枯渇監視機能を使用している場合に，監視対象のリソースについてのリソース枯渇監視情報が出力されます。リソースの使用率または使用数がしきい値を超えた場合の原因調査に使用します。

ログは，若い面番号の付いたログファイルから順に記録されます。一つのログファイルのサイズが1面当たりの最大サイズに達すると，ログは次の面番号の付いたログファイルに記録されます。最後のログファイル（面数の番号が付いたログファイル）のサイズが1面当たりの最大サイズに達すると，面の番号1のログファイルを空にし，そこへログを記録していきます。以降，ログファイルを空にしながら，面番号の順にログファイルへログを記録していきます。

ログの出力先のデフォルトを次の表に示します。Cosminexus Component Containerのログは，サーバ単位またはコマンド単位に取得できます。

ログの出力先に示す<作業ディレクトリ>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public（Windowsの場合），または/opt/Cosminexus/CC/server/public（UNIXの場合）です。

●バッチサーバのログ

表5-22　バッチサーバのログの出力先（デフォルト）

分類
内容
ログ出力先およびログファイル名※1
デフォルトのサイズ×面数
チャネル名

メッセージログ
稼働ログ

Windowsの場合
<ejb.server.log.directory>※2¥cjmessage[n].log

UNIXの場合
<ejb.server.log.directory>※2/cjmessage[n].log

1MB×2
MessageLogFile

ログ稼働ログ

Windowsの場合
<ejb.server.log.directory>※2¥cjlogger.log

UNIXの場合
<ejb.server.log.directory>※2/cjlogger.log

－
MessageLogFile

バッチサーバにデプロイして使用するリソースアダプタの稼働ログ※3

Windowsの場合
<ejb.server.log.directory>※2¥connectors¥<リソースアダプタの表示名>[n].log

UNIXの場合
<ejb.server.log.directory>※2/connectors/<リソースアダプタの表示名>[n].log

1MB×2
－

ユーザログ
ユーザ出力ログ

Windowsの場合
<ejb.server.log.directory>※2¥user_out[n].log

UNIXの場合
<ejb.server.log.directory>※2/user_out[n].log

1MB×2
UserOutLogFile

ユーザエラーログ

Windowsの場合
<ejb.server.log.directory>※2¥user_err[n].log

UNIXの場合
<ejb.server.log.directory>※2/user_err[n].log

1MB×2
UserErrLogFile

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

Windowsの場合
<ejb.server.log.directory>※2¥javalog[nn].log

UNIXの場合
<ejb.server.log.directory>※2/javalog[nn].log

256KB×4
－

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

Windowsの場合
<ejb.server.log.directory>※2¥cjexception[n].log

UNIXの場合
<ejb.server.log.directory>※2/cjexception[n].log

1MB×2
ExceptionLogFile

保守用ログ
保守情報

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjmaintenance[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjmaintenance[n].log

16MB×4
MaintenanceLogFile

コンソールメッセージ

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjconsole[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjconsole[n].log

1MB×2
ConsoleLogFile

EJBコンテナの保守情報

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjejbcontainer[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjejbcontainer[n].log

1MB×2
EJBContainerLogFile

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

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjstdout.log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjstdout.log

－
－

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

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cjstderr.log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cjstderr.log

－
－

終了プロセス情報

Windowsの場合
<ejb.server.log.directory>※2¥CC¥maintenance¥cj_shutdown[n].log

UNIXの場合
<ejb.server.log.directory>※2/CC/maintenance/cj_shutdown[n].log

4KB×2※5
－

イベントログ
バッチサーバの起動，停止または異常終了を示すログ
Windowsのイベントビューアのアプリケーションログ※6
－
－

syslog
バッチサーバの起動，停止または異常終了を示すログ
UNIXのsyslogの設定に依存します。※7
－
－

（凡例）　－：該当なし

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

また，[nn]の部分には，01～99の通し番号が付きます。

注※2

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

簡易構築定義ファイルのejb.server.log.directoryパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注※3

リソースアダプタのログを取得するかどうかは，サーバ管理コマンド，またはServer Plug-inで指定されている内容に従います。また，リソースアダプタのログは，簡易構築定義ファイルでサイズおよび面数を変更できます。リソースアダプタのログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

注※4

起動プロセス情報だけを取得するログです。主にバッチサーバの起動または終了時に出力されるため，オンライン中に出力されることはほとんどありません。ファイルのサイズが上限に達したときは，<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs下（Windowsの場合），または<作業ディレクトリ>/ejb/<サーバ名称>/logs下（UNIXの場合）のcjstdout_save.logまたはcjstderr_save.logに退避されます。すでにcjstdout_save.logまたはcjstderr_save.logがあったときは，上書きされます。

注※5

サイズおよび面数は，変更できません。

注※6

ログファイルの出力先はWindowsのイベントログの設定によって異なります。

注※7

バッチサーバの起動，停止および異常終了のメッセージをsyslogに出力するためには，syslogの設定で，facility「daemon」に対するpriorityを「info」または「debug」に設定する必要があります。syslogの設定に関する詳細については，OS付属のマニュアルを参照してください。

●サーバ管理コマンドのログ

表5-23　サーバ管理コマンドのログの出力先（デフォルト）

分類
内容
ログ出力先およびログファイル名※1
デフォルトのサイズ×面数
チャネル名

メッセージログ
稼働ログ※2　※3

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥cjmessage[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/cjmessage[n].log

1024KB×3
MessageLogFile

ログ稼働ログ※2

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥cjlogger.log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/ cjlogger.log

1024KB×2
－

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥cjexception[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/cjexception[n].log

1024KB×6
ExceptionLogFile

保守用ログ
保守情報※2

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjmaintenance[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjmaintenance[n].log

1024KB×3
MaintenanceLogFile

コンソールメッセージ※2

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjconsole[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjconsole[n].log

32KB×3
ConsoleLogFile

サーバ管理コマンドの保守情報※2

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjserveradmin[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjserveradmin[n].log

32KB×3
ServerAdminLogFile

（凡例）　－：該当なし

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

注※2

日立トレース共通ライブラリ形式の出力メッセージ（アプリケーション識別名）には，コマンド名が表示されます。

注※3

互換モードの場合，稼働ログと障害発生時の例外情報の出力先は標準モードと異なります。互換モードの場合の出力先とデフォルトのサイズ・面数は次のようになります。

表5-24　サーバ管理コマンドのログの出力先（互換モード）

内容
ログ出力先およびログファイル名※
デフォルトのサイズ×面数

稼働ログ

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥admin¥logs¥<コマンド名称>message[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/<コマンド名称>message[n].log

128KB×2

障害発生時の例外情報

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥admin¥logs¥<コマンド名称>exception[n].log

UNIXの場合
/opt/Cosminexus/CC/admin/logs/<コマンド名称>exception[n].log

256KB×2

注※

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

サーバ管理コマンドのメッセージログに出力されるメッセージには，メッセージIDフィールドが空白で，メッセージテキストフィールドにメッセージID（KDJEnnnnn-Yなど）が含まれる場合があります。それらはサーバ側で発生したメッセージで，前後に出力されるメッセージの付加情報となります。

●バッチアプリケーションのログ

表5-25　バッチアプリケーションのログの出力先（デフォルト）

分類
内容
ログ出力先およびログファイル名※1
デフォルトのサイズ×面数

メッセージログ
cjexecjobコマンドおよびcjkilljobコマンドの稼働ログ

Windowsの場合
<batch.log.directory>※2¥cjmessage[n].log

UNIXの場合
<batch.log.directory>※2/cjmessage[n].log

1MB×2

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

注※2

<batch.log.directory>は，バッチアプリケーション用オプション定義ファイル（usrconf.cfgファイル）のbatch.log.directoryで指定されたディレクトリを指します。デフォルト値は，次のとおりです。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥batch¥logs

UNIXの場合

/opt/Cosminexus/CC/batch/logs

●リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

表5-26　リソースアダプタバージョンアップコマンド（cjrarupdate）のログの出力先

分類
内容
ログ出力先およびログファイル名※
デフォルトのサイズ×面数
チャネル名

メッセージログ
稼働ログ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjrarupdatemessage[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjrarupdatemessage[n].log

1MB×2
－

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjrarupdateexception[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjrarupdateexception[n].log

1MB×2
－

保守用ログ
保守情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjrarupdatemaintenance[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjrarupdatemaintenance[n].log

1MB×2
－

（凡例）　－：該当なし

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

●移行コマンド（cjenvupdate）のログ

表5-27　移行コマンド（cjenvupdate）のログの出力先

分類
内容
ログ出力先およびログファイル名※
デフォルトのサイズ×面数
チャネル名

メッセージログ
cjenvupdateコマンドの稼働ログ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjenvupdatemessage[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjenvupdatemessage[n].log

4MB×4
－

例外ログ
cjenvupdateコマンドの例外情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjenvupdateexception[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjenvupdateexception[n].log

4MB×4
－

保守用ログ
cjenvupdateコマンドの保守情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs¥cjenvupdatemaintenance[n].log

UNIXの場合
/opt/Cosminexus/CC/logs/cjenvupdatemaintenance[n].log

4MB×4
－

（凡例）　－：該当なし

注※

[n]には，面の番号（1から面数（最大16）まで）が付きます。

●リソース枯渇監視のログ

表5-28　リソース枯渇監視のログの出力先

監視対象
リソース
ログ取得場所およびログファイル名※1
デフォルトのサイズ×面数
チャネル名※2

メモリ

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjmemorywatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjmemorywatch[n].log

1MB×2
MemoryWatchLogFile

ファイルディスクリプタ

UNIXの場合※4
<ejb.server.log.directory>※3/watch/cjfiledescriptorwatch[n].log

1MB×2
FileDescriptorWatchLogFile

スレッド

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjthreadwatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjthreadwatch[n].log

1MB×2
ThreadWatchLogFile

スレッドダンプ

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjthreaddumpwatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjthreaddumpwatch[n].log

1MB×2
ThreaddumpWatchLogFile

HTTPリクエスト実行待ちキュー

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjrequestqueuewatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjrequestqueuewatch[n].log

1MB×2
RequestQueueWatchLogFile

HTTPセッション数

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjhttpsessionwatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjhttpsessionwatch[n].log

1MB×2
HttpSessionWatchLogFile

コネクションプール

Windowsの場合
<ejb.server.log.directory>※3¥watch¥cjconnectionpoolwatch[n].log

UNIXの場合
<ejb.server.log.directory>※3/watch/cjconnectionpoolwatch[n].log

1MB×2
ConnectionPoolWatchLogFile

注※1

[n]には，面の番号（1から面数（最大16）まで）が付きます。

注※2

ログの出力先を識別する名称で，ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※3

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

簡易構築定義ファイルのejb.server.log.directoryパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注※4

Windowsの場合，またはAIXの場合は，ファイルディスクリプタを監視できません。

リソース枯渇監視ログファイルに出力される情報やログファイルの出力形式については，「2.5　リソース枯渇の監視」を参照してください。

●ログの出力先を設定するユーザ定義ファイル

バッチサーバおよびサーバ管理コマンドのログの出力先を変更している場合は，次の表に示す，ログの出力先を設定するユーザ定義ファイルを参照して出力先を確認してください。なお，ログの出力先を変更した場合，変更後の出力先はsnapshotログの一括収集時に収集対象外となります。必要に応じてsnapshotログの収集先を変更してください。

表5-29　ログの出力先を設定するユーザ定義ファイル

分類
ユーザ定義ファイルの指定個所

バッチサーバ
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に指定する，ejb.server.log.directoryパラメタ。
デフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/logs」（UNIXの場合）です。

サーバ管理コマンド
サーバ管理コマンドのusrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のejbserver.log.directoryキー。
キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/admin/logs」（UNIXの場合）です。
Management Serverリモート管理機能から操作した場合は，サーバ管理コマンドのログ出力先は変更できません。

ログの出力先の変更方法など，トラブルシューティングの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(b)　運用管理エージェント・運用監視エージェント・Management Serverのログの取得

ここでは，運用管理エージェント，運用監視エージェント，およびManagement Serverのログの出力先について説明します。

運用管理エージェント・運用監視エージェント・Management Serverのログには，個別に取得する以外に，統合ログとしてまとめて取得できるものがあります。

運用管理エージェント・運用監視エージェント・Management Serverのログを統合ログとしてまとめて取得する場合，および個別に取得する場合の出力先については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」の「(1)(b)　運用管理エージェント・運用監視エージェント・Management Serverのログの取得」を参照してください。

(c)　ログ以外に取得が必要な情報

ログ以外に取得する必要がある情報については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」の「(1)(d)　ログ以外に取得が必要な情報」を参照してください。

(2)　アプリケーションのユーザログの取得

バッチアプリケーションのユーザログは，日立トレース共通ライブラリ形式で出力するように設定している場合に取得できます。

バッチアプリケーションのユーザログの出力先については，次のディレクトリに，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にejbserver.application.userlog.CJLogHandler.<ハンドラ名>.pathパラメタで指定したプリフィックスを持つファイル名で出力されます。なお，<ハンドラ名>には，キーの値を区別するためのハンドラ名が指定されています。

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

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

なお，バッチアプリケーションのユーザログ出力の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

5.4.3　EJBクライアントアプリケーションのシステムログの取得

EJBクライアントアプリケーションのシステムログの種類と出力先について説明します。

なお，EJBクライアントアプリケーションのシステムログを運用するときに留意することについては，「5.7.1　EJBクライアントアプリケーションのシステムログに関する留意事項」を参照してください。

注意

uCosminexus Clientを使用する場合は，EJBクライアントアプリケーションのログの格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCL」と読み替えてください。

＜この項の構成＞

(1)　EJBクライアントアプリケーションのシステムログの種類

(2)　EJBクライアントアプリケーションのシステムログの出力先

(1)　EJBクライアントアプリケーションのシステムログの種類

EJBクライアントアプリケーションでは，EJBクライアントアプリケーションのプロセス単位にシステムログを出力します。EJBクライアントアプリケーションのシステムログの種類を次に示します。

表5-30　EJBクライアントアプリケーションのシステムログの種類

種類 | ログの内容 | ファイル名 | デフォルトのサイズ×面数 | チャネル名
メッセージログ | 稼働ログ | cjclmessage[n].log※1 | 1MB×2 | ClientMessageLogFile
cjclstartapコマンドの稼働ログ | cjclstartap[n].log※2 | 1MB×2 | －
cjcldellogコマンドの稼働ログ | cjcldellog.log | 1MB×2※3 | －
ユーザログ | ユーザ出力ログ | user_out[n].log※1 | 1MB×2 | UserOutLogFile
ユーザエラーログ | user_err[n].log※1 | 1MB×2 | UserErrLogFile
Javaログ | JavaVMの保守情報，ガーベージコレクションのログ | javalog[n].log※1 | 256KB×4 | －
例外ログ | 障害発生時の例外情報 | cjclexception[n].log※1 | 1MB×2 | ClientExceptionLogFile
保守用ログ※4 | 保守情報 | cjclmaintenance[n].log※1 | 1MB×2 | ClientMaintenanceLogFile
EJBコンテナの保守情報 | cjejbcontainer[n].log※1 | 1MB×2 | EJBContainerLogFile
起動プロセス標準出力情報 | cjstdout[n].log※2 | 1MB×2 | －
起動プロセス標準エラー情報 | cjstderr[n].log※2 | 1MB×2 | －
ログの稼働情報 | cjlogger.log | 1MB×2※3 | －

（凡例）　－：該当なし

注※1

ファイル名の[n]の部分には，1～指定したログの面数の通し番号が付きます。

注※2

ファイル名の[n]の部分には指定したログの面数の番号（1または2）が付きます。

注※3

cjcldellog.logのサイズが1MBを超えた場合，cjcldellog_save.logというバックアップファイル名称のログファイルになります。

注※4

このログは，保守員へ送付する場合に必要に応じて収集してください。

(2)　EJBクライアントアプリケーションのシステムログの出力先

EJBクライアントアプリケーションのシステムログは，次のキーに指定したディレクトリに出力されます。

Javaアプリケーション用オプション定義ファイル（usrconf.cfg）のejb.client.log.directoryキー，およびejb.client.ejb.logキーに指定したディレクトリ

システムプロパティのejbserver.client.log.directoryキーおよびejbserver.client.ejb.logキーに指定したディレクトリ

Javaアプリケーション用オプション定義ファイル（usrconf.cfg）とシステムプロパティの両方に異なる値が指定された場合，システムプロパティの設定が有効になります。

なお，システムプロパティで出力先を設定できるのは，次のログだけです。

稼働ログ（cjclmessage[n].log）

障害発生時の例外情報（cjclexception[n].log）

保守情報（cjclmaintenance[n].log）

ログの稼働情報（cjlogger.log）

cjcldellogコマンドの稼働ログ（cjcldellog.log）およびcjclstartapコマンドの稼働ログ（cjclstartap[n].log）は，「<Cosminexusのインストールディレクトリ>¥CC¥client¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/client/logs」（UNIXの場合）の直下に出力されます。

注意

cjclstartapコマンドはサブディレクトリ共有モードだけで使用してください。サブディレクトリ専有モードでcjclstartapコマンドを実行してEJBクライアントを実行した場合，cjclstartapコマンドの稼働ログ（cjclstartap[n].log）が正しく表示されません。

EJBクライアントアプリケーションの標準出力，および標準エラーの内容は，ログファイルには出力されません。ログファイルに出力する場合は，ユーザログ機能を使用するか，リダイレクトしてください。

EJBクライアントアプリケーションのシステムログの出力方法には，次の2種類のモードがあります。モードによって，出力先になるサブディレクトリの構成が異なります。これらのモードは，クラスパスの指定によって選択します。

サブディレクトリ共有モード
複数のプロセスのログを一つのディレクトリ（デフォルトはejbclディレクトリ）下に出力するモードです。

サブディレクトリ専有モード
それぞれのプロセスのログを，プロセス単位に作成されたサブディレクトリに別々に出力するモードです。
Cosminexusの06-50よりも前のバージョンとの互換用に使用するモードです。
サブディレクトリ共有モードとサブディレクトリ専有モードの違いの詳細については，マニュアル「Cosminexus　システム構築ガイド」のEJBクライアントアプリケーションのログの種類に関する説明を参照してください。

(a)　サブディレクトリ共有モードの場合

EJBクライアントアプリケーションのシステムログの出力先を次の図に示します。

図5-3　サブディレクトリ共有モードのEJBクライアントアプリケーションのシステムログの出力先（Javaアプリケーション用オプション定義ファイルで指定した場合）

図5-4　サブディレクトリ共有モードのEJBクライアントアプリケーションのシステムログの出力先（システムプロパティで指定した場合）

(b)　サブディレクトリ専有モードの場合

EJBクライアントアプリケーションのシステムログは，ejbserver.client.log.directoryキーに指定したディレクトリ下の，EJBクライアントアプリケーションのプロセス単位に作成されるサブディレクトリ下に格納されます。EJBクライアントアプリケーションのプロセス単位のサブディレクトリは，ejbserver.client.log.directoryキーに指定したディレクトリ下の，ejbserver.client.ejb.logキーに指定したディレクトリ下に作成されます。デフォルトでは，「<Cosminexusのインストールディレクトリ>¥CC¥client¥logs¥ejb」（Windowsの場合），または「/opt/Cosminexus/CC/client/logs/ejb」（UNIXの場合）の下にサブディレクトリが作成されます。

EJBクライアントアプリケーションのシステムログ出力先のサブディレクトリ名を次に示します。

表5-31　EJBクライアントアプリケーションのシステムログ出力先のサブディレクトリ名

コマンド名 | サブディレクトリ名
vbjコマンド | cjcl<日時>_<プロセスID>

注

<日時>には，EJBクライアントアプリケーションを開始した日時が「mddhhmmssmmm」の形式で表示されます。日時に表示される項目は次のとおりです。なお，月以外は10進数で表示されます。

m：月（16進数）　dd：日付　hh：時間　mm：分　ss：秒　mmm：ミリ秒

EJBクライアントアプリケーションのシステムログ出力先のディレクトリ構成例を次に示します。

図5-5　サブディレクトリ専有モードのEJBクライアントアプリケーションのシステムログの出力先

サブディレクトリは，次のように作成および運用されます。

EJBクライアントアプリケーション単位に作成するサブディレクトリは，上限値を設定できます。EJBクライアントアプリケーションが終了すると，サブディレクトリにclient_process_endという空のファイルが作成されます。上限値を超えた場合は，このファイルの作成時刻が古い順にサブディレクトリが削除されます。なお，サブディレクトリにログを出力しているEJBクライアントアプリケーションがどれも終了していない（client_process_endファイルが作成されていない）場合は，上限値を超えてサブディレクトリが作成されます。作成されたサブディレクトリがあとで上限値まで削除されることはありません。

ejbserver.client.log.directoryキーに指定したディレクトリ下の，ejbserver.client.ejb.logキーに指定したディレクトリ下にユーザ作成のサブディレクトリがある場合，EJBクライアントアプリケーション単位に作成するサブディレクトリと同様に，サブディレクトリとして数えられます。

EJBクライアントアプリケーションが異常終了すると，client_process_endファイルが作成されないことがあるため，異常終了したEJBクライアントアプリケーションのサブディレクトリは上限値を超えても削除されないことがあります。

一つのEJBクライアントアプリケーションを一つだけ起動する場合（同時実行しない場合）には，そのEJBクライアントアプリケーション固有のシステムログ出力先ディレクトリを作成して，常にそのディレクトリに出力する運用ができます。このサブディレクトリは，上限値の指定に関係なく，削除されません。

サブディレクトリを削除する場合，cjcldellogコマンドを使用すると，指定した更新日または更新時間より前に作成されたサブディレクトリを一括して削除できます。なお，cjcldellogコマンドは，Windowsの場合はWindowsのタスク，UNIXの場合はatコマンドまたはcrontabコマンドを利用して定期的に実行してください。

EJBクライアントアプリケーションのログ出力の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

5.4.4　性能解析トレースの取得

性能解析トレースの収集方法については，「3.　システムの処理性能の解析」を参照してください。性能解析トレースには，セッショントレースも出力されている場合があります。

性能解析トレースの格納場所は次のとおりです。

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥prf¥<PRF識別子>

UNIXの場合
$PRFSPOOL/utt/prf/<PRF識別子>

5.4.5　JavaVMのスレッドダンプの取得

ここでは，JavaVMのスレッドダンプを取得する方法について説明します。

JavaVMのスレッドダンプは，次の方法で取得できます。

運用管理コマンド（mngsvrutil）を使用して，J2EEサーバ，SFOサーバ，CORBAネーミングサービス，およびCTMのスレッドダンプを取得する。

個別のコマンドを使用して，J2EEサーバ，CORBAネーミングサービス，およびEJBクライアントアプリケーションのスレッドダンプを取得する。

それぞれの方法について次に説明します。

＜この項の構成＞

(1)　運用管理コマンドを使用する場合

(2)　個別のコマンドを使用する場合

(1)　運用管理コマンドを使用する場合

運用管理コマンド（mngsvrutil）を利用したJavaVMのスレッドダンプの取得は，mngsvrutilコマンドのサブコマンド「dump」の引数にserverを指定して実行します。

次のスレッドダンプを取得できます。

J2EEサーバ（クラスタを含む）

SFOサーバ

CORBAネーミングサービスおよびCTM

mngsvrutilコマンドおよびそのサブコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

実行形式，実行例，および出力先を次に示します。

実行形式

mngsvrutil -m <Management Serverのホスト名> -u <管理ユーザID> -p <管理パスワード> -t <論理サーバ名> dump server

実行例

mngsvrutil -m mnghost -u user01 -p pw1 -t myserver dump server

出力先

J2EEサーバを対象にする場合

Windowsの場合
<作業ディレクトリ>※¥ejb¥<サーバ名称>¥javacore*.txt

UNIXの場合
<作業ディレクトリ>※/ejb/<サーバ名称>/javacore*.txt

注※　<作業ディレクトリ>は，J2EEサーバのユーザ定義（usrconf.cfgファイル中のejb.public.directory）で指定されたディレクトリを指します。デフォルト値は，次のとおりです。

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

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

SFOサーバを対象にする場合

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

UNIXの場合
/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/javacore*.txt

CORBAネーミングサービスおよびCTMを対象にする場合

Windowsの場合
<Cosminexusのインストールディレクトリ>¥TPB¥logj¥javacore*.txt

UNIXの場合
/opt/Cosminexus/TPB/logj/javacore*.txt

(2)　個別のコマンドを使用する場合

スレッドダンプの出力のされ方は，指定しているJ2EEサーバを実行するJavaVMの起動オプションによって異なります。

-XX:+HitachiThreadDumpが設定されている場合，拡張スレッドダンプを取得できます。このオプションはデフォルトで設定されています。

-XX:+HitachiThreadDumpToStdoutが設定されている場合，スレッドダンプは標準出力にも出力されます。このオプションはデフォルトでは設定されていません。必要に応じて設定してください。

-XX:+HitachiOutOfMemoryAbortが設定されている場合に，-XX:+HitachiOutOfMemoryAbortThreadDumpが設定されていると，OutOfMemoryErrorによって強制終了した時に，スレッドダンプが出力されます。ただし，次の場合は除きます。

J2SEクラスライブラリでCヒープ不足が発生した場合

JavaVMの処理中にCヒープ不足が発生した場合

(a)　J2EEサーバのスレッドダンプの取得

J2EEサーバプロセス(cjstartsv)が存在する場合，J2EEサーバのスレッドダンプは，cjdumpsvコマンドを実行して取得します。cjdumpsvコマンドの実行例を次に示します。時間の経過に応じた各スレッドの状態遷移を確認するため，複数回cjdumpsvコマンドを実行します。目安として3秒おきに10回程度実行します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥server¥bin¥cjdumpsv <J2EEサーバ名>

UNIXの場合

/opt/Cosminexus/CC/server/bin/cjdumpsv <J2EEサーバ名>

cjdumpsvコマンドを実行すると，次に示すファイルにJavaVMのスレッドダンプが出力されます。

サーバ標準出力ログ

<作業ディレクトリ>¥ejb¥<サーバ名称>¥javacore<プロセス番号>.<コマンド実行日時>.txt（Windowsの場合）

<作業ディレクトリ>/ejb/<サーバ名称>/javacore<プロセス番号>.<コマンド実行日時>.txt（UNIXの場合）

サーバ標準出力ログのデフォルトの出力先は「<ejb.server.log.directory>¥CC¥maintenance¥cjstdout.log」（Windowsの場合），または「<ejb.server.log.directory>/CC/maintenance/cjstdout.log」（UNIXの場合）です。出力先を変更している場合は，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」または「5.4.2　Cosminexusのログの取得（バッチアプリケーションを実行するシステム）」を参照してください。なお，作業ディレクトリのデフォルトのディレクトリパスは「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」（Windowsの場合），または「/opt/Cosminexus/CC/server/public」（UNIXの場合）です。

また，javacore<プロセス番号>.<コマンド実行日時>.txtファイルの出力先は，環境変数JAVACOREDIRで変更できます。ただし，指定したディレクトリへの書き込みに失敗した場合は，デフォルトの出力先に出力されます。このディレクトリにも出力できなかった場合は，標準エラー出力にだけ出力されます。

cjdumpsvコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

参考

スレッドダンプが出力されると，標準出力に，次のメッセージが出力され，javaプログラムの実行が継続されます。このメッセージは，-XX:+HitachiThreadDumpToStdoutの設定とは関係なく出力されます。

Writing Java core to <ファイル名（フルパス）>...OK

(b)　CORBAネーミングサービスのスレッドダンプの取得

Windowsの場合，CORBAネーミングサービスのプロセス（nameserv）が存在するときは，CORBAネーミングサービスを起動したコマンドプロンプトに対してCtrl+Breakキーを押します。時間の経過に応じた各スレッドの状態遷移を確認するため，複数回実行します。目安として3秒おきに10回程度実行します。なお，CORBAネーミングサービスをManagement Serverから監視している場合はスレッドダンプを取得できません。

UNIXの場合，CORBAネーミングサービスのプロセス（java）が存在するときは，killコマンドを実行してCORBAネーミングサービスのスレッドダンプを取得します。なお，CORBAネーミングサービスをManagement Serverから監視している場合はスレッドダンプを取得できません。

UNIXでのCORBAネーミングサービスのスレッドダンプの取得手順を次に示します。

CORBAネーミングサービスのプロセスIDを取得します。
CORBAネーミングサービスのプロセスIDの取得方法は，次の場合によって異なります。

javaプロセスがほかに起動していない場合

ps -ef | grep java

javaプロセスが複数起動している場合

CORBAネーミングサービスの起動用シェルスクリプトを使用すると，カレントワーキングディレクトリに生成されるnamesv_pidファイルにCORBAネーミングサービスのプロセスIDを出力できます。

CORBAネーミングサービスの起動用シェルスクリプトの例を次に示します。

#!/bin/sh
export VBROKER_ADM=/opt/Cosminexus/TPB/adm
export SHLIB_PATH="${SHLIB_PATH}:/opt/Cosminexus/TPB/lib"

# start name server process
exec /opt/Cosminexus/TPB/bin/nameserv ¥
-J-Dvbroker.agent.enableLocator=false ¥
-J-Djava.security.policy==/opt/Cosminexus/CC/server/sysconf/cli.policy ¥
-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=900 &

# save background java process pid
echo $! > ./namesv_pid

取得したプロセスIDを指定して，killコマンドを実行します。

kill -3 `cat namesv_pid`

(c)　EJBクライアントアプリケーションのスレッドダンプの取得

EJBクライアントアプリケーションのスレッドダンプは，cjcldumpapコマンドを実行して取得します。

cjcldumpapコマンドを実行すると，cjclstartapコマンドを実行して起動したEJBクライアントアプリケーションのスレッドダンプが出力されます。また，特定のプロセスのスレッドダンプを出力することもできます。cjcldumpapコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

cjcldumpapコマンドの実行形式，実行例，およびスレッドダンプの出力先を次に示します。

実行形式

cjclstartapコマンドを使用して起動したEJBクライアントアプリケーションのスレッドダンプを出力する場合

cjcldumpap

特定のプロセスのスレッドダンプを出力する場合

cjcldumpap ＜プロセスID＞

実行例

cjclstartapコマンドを使用して起動したEJBクライアントアプリケーションのスレッドダンプを出力する場合

cjcldumpap

特定のプロセスのスレッドダンプを出力する場合

cjcldumpap 3264

出力先

cjclstartapコマンドを実行しているカレントディレクトリ

5.4.6　JavaVMのガーベージコレクションログの取得

JavaVMのガーベージコレクションログは，JavaVMまたはJ2EEサーバ起動前にログ出力先が設定されている場合にだけ取得できます。

ガーベージコレクションログの出力先は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定します。

また，実行中のJavaプロセスでガーベージコレクションを発生させたい場合は，javagcコマンドを実行してください。javagcコマンドは，トラブル発生時の要因調査のほか，1トランザクション当たりのメモリ使用量の測定，メモリリークの調査，アプリケーションのデバッグなどの目的でも使用できます。

実行中のJavaプロセスを指定してガーベージコレクションを発生させる場合のjavagcコマンドの実行形式を次に示します。なお，これ以外に指定できるオプションについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

実行形式

javagc -p ＜プロセスID＞

実行結果として，次のログが出力されます。なお，これは，オプションとして，-XX:+HitachiVerboseGCPrintCauseが指定されている場合の例です。

[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:JavaGC Command]

5.4.7　メモリダンプの取得

J2EEサーバまたはCORBAネーミングサービスを再起動する場合は，メモリダンプとして次のファイルを取得します。

ユーザダンプ（Windowsの場合）

J2EEサーバのメモリダンプ

CORBAネーミングサービスのメモリダンプ

これらのファイルは，システムでトラブルが発生したときに，保守員が障害を解析するために使用します。

＜この項の構成＞

(1)　ユーザダンプの取得（Windowsの場合）

(2)　J2EEサーバのメモリダンプの取得

(3)　CORBAネーミングサービスのメモリダンプの取得

(1)　ユーザダンプの取得（Windowsの場合）

プロセスダウンが発生した場合に次のファイルがあれば採取します。

<ワトソン博士のクラッシュダンプ出力先指定ディレクトリ>¥user.dmp

<ワトソン博士のクラッシュダンプ出力先指定ディレクトリ>は，ワトソン博士（drwtsn32）を実行してクラッシュダンプ欄のパスを確認してください。

プロセスのハングアップやスローダウンが発生した場合にユーザダンプを取得するときは，プロセスIDを確認してuserdump.exeコマンドを実行します。userdump.exeは，Microsoftによって提供されているコマンドです。

userdump.exe <プロセスID>

userdump.exeコマンドでユーザダンプを取得した場合，ユーザダンプはuserdump.exeを実行したカレントディレクトリに出力されます。

(2)　J2EEサーバのメモリダンプの取得

J2EEサーバのメモリダンプの取得について，OSごとに説明します。

(a)　Windowsの場合

J2EEサーバが稼働している場合（cjstartsvプロセスが存在する場合），タスクマネージャからcjstartsvのプロセスIDを取得します。userdump.exe <プロセスID>を実行し，メモリダンプ（user.dump）を採取します。

(b)　UNIXの場合

cjstartsvプロセスがダウンした場合，「<作業ディレクトリ>/ejb/<サーバ名称>」に出力されたcoreダンプを取得します。

coreダンプのファイル名は，cjstartsvプロセスの再起動時に「core.<出力日時※>」（AIX，HP-UX，Solarisの場合）または「core.<プロセスID>.<出力日時※>」（Linuxの場合）にリネームされます。cjstartsvプロセスの再起動時にcoreダンプが上書き保存されないため，障害発生時のcoreダンプを保存できます。

注※

出力日時は「YYMMDDhhmmss」の形式で出力されます。

YY：西暦（下2けた）　MM：月（2けた）　DD：日（2けた）

hh：時（24時間表記で2けた）　mm：分（2けた）　ss：秒（2けた）

なお，保存するcoreダンプは上限値を設定できます。Windowsの場合，cjstartsvプロセスの再起動時，およびjavacoreコマンド実行時に，出力日時が古い順に削除されます。UNIXの場合，「<作業ディレクトリ>/ejb/<サーバ名称>」に出力されるcoreダンプファイルの合計が上限値を超えたときに，出力日時が古い順に削除されます。上限値は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，J2EEサーバの拡張パラメタのejb.server.corefilenumで指定します。なお，ファイルの削除はcjstartsvプロセスの再起動時に実行されます。coreダンプファイル数の上限値の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

coreダンプを取得したあとに，coreダンプからスタックトレース情報だけを取得する場合は，javatraceコマンドを実行してください。スタックトレース情報は，JavaVMの異常終了の原因を究明するために必要な情報です。スタックトレース情報の取得方法については，「5.4.16　JavaVMのスタックトレース情報の取得」を参照してください。

coreダンプは次のような場合にも取得できます。それぞれの場合の取得方法について説明します。

cjstartsvプロセスが稼働している状態でcoreダンプを取得する場合
cjstartsvプロセス（J2EEサーバ）が稼働している状態でcoreダンプを取得する場合，cjstartsvプロセスのプロセスIDを確認して，killコマンドを実行します。killコマンドは次の形式で実行してください。なお，killコマンドを実行するとプロセスが終了するため，再起動する前にkillコマンドを実行することを推奨します。

kill -6 <cjstartsvのプロセスID>

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合
実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合は，javacoreコマンドを実行してください。javacoreコマンドの実行形式を次に示します。なお，指定できるオプションについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

javacore <-プロセスID>

上記の形式でコマンドを実行すると，次のメッセージが出力されます。

send SIGQUIT to 8662: ? (y/n)

「y」を入力すると，実行中のJavaプログラムのカレントディレクトリに，"javacore<プロセスID>.<出力日時>.core"（coreダンプ），および"javacore<プロセスID>.<出力日時>.txt"（スレッドダンプ）が出力されます。「n」を入力すると，coreダンプおよびスレッドダンプを取得しないでコマンドの実行を終了します。
coreダンプおよびスレッドダンプを取得すると，実行中のJavaプログラムには，次のメッセージが出力されます。なお，斜体の部分は実際には表示されません。

Now generating core file (javacore8662.030806215140.core)...
done

(coreダンプおよびスレッドダンプの出力終了)

Writing Java core to javacore8662.030806215140.txt... OK

(3)　CORBAネーミングサービスのメモリダンプの取得

CORBAネーミングサービスのメモリダンプの取得についてOSごとに説明します。

(a)　Windowsの場合

CORBAネーミングサービスが稼働している場合（CORBAネーミングサービスのプロセスが存在する場合），userdump.exe <プロセスID>を実行し，メモリダンプ（user.dump）を採取します。CORBAネーミングサービスのプロセスIDはあらかじめタスクマネージャで確認します。

(b)　UNIXの場合

CORBAネーミングサービスが稼働している場合（CORBAネーミングサービスのプロセスが存在する場合），CORBAネーミングサービスのプロセスIDを確認して，killコマンドを実行します。killコマンドは次の形式で実行してください。なお，killコマンドを実行するとプロセスが終了するため，再起動する前にkillコマンドを実行することを推奨します。

ps -ef | grep java
kill -6 <CORBAネーミングサービスのプロセスID>

5.4.8　日立固有のJavaVMログの取得（日立JavaVMログファイル）

日立固有のJavaVMログとは，日立が標準のJavaVMに追加した拡張オプションを使用して取得できるログです。標準のJavaVMよりも，多くのトラブルシュート情報が取得できます。日立固有のJavaVMログは，次のどれかのオプションを指定した場合に，ログファイルに出力されます。なお，このログファイルを，日立JavaVMログファイルといいます。

-XX:+HitachiOutOfMemoryStackTrace
なお，このオプションを指定した場合に同時に指定される，-XX:+HitachiOutOfMemorySizeおよび-XX:+HitachiOutOfMemoryCauseが指定された場合も，日立JavaVMログファイルが出力されます。

-XX:+HitachiVerboseGC

-XX:+HitachiJavaClassLibTrace

このほか，出力内容や出力方法についても，オプションに指定しておく必要があります。JavaVMの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

日立JavaVMログファイルは，-XX:HitachiJavaLog:＜パスおよびファイル名称＞オプションに指定した出力先に，指定したファイル名称で出力されます。指定を省略した場合は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリに，「javalogxx.log」という名称で出力されます。xxは01から始まる2けたの通番です。

5.4.9　JavaVM出力メッセージログの取得（標準出力またはエラーリポートファイル）

ここでは，JavaVMが出力するメッセージログの取得について説明します。

JavaVMでクラッシュが発生した場合，JavaVMはデバッグ情報を標準出力とエラーリポートファイルに出力します。

エラーリポートファイルは，次の場合に出力されます。

JNIの中でシグナルが発生したとき

JavaVMでCヒープ不足が発生したとき

JavaVMで予期しないシグナルが発生したとき

JavaVMでInternal Error（内部論理エラー）が発生したとき

ただし，エラーリポートファイルの作成時にシグナルやメモリ不足が発生した場合，このファイルは作成されません。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

エラーリポートファイルの出力先および出力ファイル名は次のとおりです。

<作業ディレクトリ>¥ejb¥<サーバ名>¥hs_err_pid<サーバプロセスのプロセスID>.log

参考

Cヒープが不足した場合，次の順序でメッセージ出力およびダンプ出力が実行されます。必要な情報を取得してください。

Cヒープ不足を示すメッセージログが，エラーリポートファイルおよび標準出力に出力されます。

1.の実行中にメモリ不足が発生した場合，簡易メッセージが標準出力に出力されます。

ワトソンログが起動され，ダンプ出力が実行されます。

(2)　UNIXの場合

エラーリポートファイルの出力先および出力ファイル名は次のとおりです。

<作業ディレクトリ>/ejb/<サーバ名>/hs_err_pid<サーバプロセスのプロセスID>.log

参考

Cヒープが不足した場合，次の順序でメッセージ出力およびcoreダンプの生成が実行されます。必要な情報を取得してください。

Cヒープ不足を示すメッセージログが，エラーリポートファイルおよび標準出力に出力されます。

1.の実行中にメモリ不足が発生した場合，簡易メッセージが標準出力に出力されます。

簡易メッセージの出力処理中にさらにメモリ不足が発生した場合，メッセージおよびエラーログファイルの出力処理を中止して，coreダンプを生成します。

5.4.10　OSの状態情報とOSのログの取得

トラブルシュート情報として必要なOSのログ情報を次に示します。

＜この項の構成＞

(1)　OSの状態情報の取得

(2)　OSのログの取得

(1)　OSの状態情報の取得

トラブルシュート情報として必要なOSの状態情報の取得について，OSごとに説明します。

(a)　Windowsの場合

OSの状態情報は，cjgetsysinfoコマンドを使用して取得できます。-fオプションを指定すると，OS状態出力ファイルに出力できます。

コマンドは，次の形式で実行します。

cjgetsysinfo -f <OS状態出力ファイルパス>

このコマンドによって，OSの次のコマンドを実行した場合と同じ情報が取得できます。

netstat -e
netstat -s
netstat -a
set

なお，cjgetsysinfoコマンドを実行しない場合に，トラブルシュート情報として取得する必要があるOSの状態情報を次に示します。各情報の取得はあらかじめディレクトリを作成し，そこにファイルを生成します。作成するディレクトリのパスは任意です。

表5-32　トラブルシュート情報として必要なOSの状態情報

情報の種類
デフォルトのファイル名

ネットワークの情報
プロトコルの統計情報と現在の TCP/IP ネットワーク接続の情報。次のコマンドで順次取得します。

netstat -e > netstat_e.txt
netstat -s > netstat_s.txt
netstat -a > netstat_a.txt

環境変数
現在設定されている環境変数。次のコマンドで取得します。

set >set.txt

(b)　UNIXの場合

OSの状態情報は，cjgetsysinfoコマンドを使用して取得できます。-fオプションを指定すると，OS状態出力ファイルに出力できます。

コマンドは，次の形式で実行します。

cjgetsysinfo -f <OS状態出力ファイルパス>

このコマンドによって，OSの次の表に示すコマンドを実行した場合と同じ情報が取得できます。

表5-33　 cjgetsysinfoコマンドの実行によって実行されるOSのコマンド

AIXの場合
HP-UXの場合
Linuxの場合
Solarisの場合

df -k

ps -elf

ps -A -m -o THREAD

vmstat -t 1 1

vmstat -s

lsps -s

netstat -i

netstat -m

netstat -a

iostat

svmon -P

svmon -G

sar -A 1

instfix -i

lslpp -hac

uname -a

env

set

ipcs -a

df -kt

top -s 1 -d 1

ps -efl

vmstat

vmstat -s

netstat -i

netstat -a

iostat

sar -A 1

swapinfo -a

kmtune※1

kctune※1

swlist

swlist -l product

uname -a

env

set

ipcs -a

df

ps -eflm

vmstat

netstat -s

netstat -a

iostat※2

top -b -n 1

sysctl -a

sar -A 1※2

rpm -qa

rpm -qai

uname -a

env

set

ipcs

ipcs -t

ipcs -p

ipcs -c

ipcs -u

ipcs -l

df -k

ps -eflL

vmstat

vmstat -s

netstat -i

netstat -m

netstat -a

iostat

mpstat

swap -l

sar -A 1

sysdef

pkginfo

patchadd -p

uname -a

env

set

注※1　HP-UX（IPF）の場合に実行されるコマンドです。

注※2　sarコマンドおよびiostatコマンドを実行するためには，Linuxに含まれているsysstatパッケージをインストールする必要があります。

なお，cjgetsysinfoコマンドを実行しない場合に，トラブルシュート情報として取得する必要があるOSの状態を示す情報の取得方法（コマンド）を次に示します。

AIXの場合

df -k > df_k`date +"%y%m%d%H%M%S"`.txt
ps -efl > ps_efl`date +"%y%m%d%H%M%S"`.txt
ps -A -m -o THREAD > ps_AmoTHREAD`date +"%y%m%d%H%M%S"`.txt
vmstat -t 1 5 > vmstat`date +"%y%m%d%H%M%S"`.txt
vmstat -s > vmstat_s`date +"%y%m%d%H%M%S"`.txt
lsps -s > lsps_s`date +"%y%m%d%H%M%S"`.txt
netstat -i > netstat_i`date +"%y%m%d%H%M%S"`.txt
netstat -m > netstat_m`date +"%y%m%d%H%M%S"`.txt
netstat -a > netstat_a`date +"%y%m%d%H%M%S"`.txt
iostat 1 5 > iostat`date +"%y%m%d%H%M%S"`.txt
svmon -P > svmon_P`date +"%y%m%d%H%M%S"`.txt※1
svmon -G -i 1 5 > svmon_G`date +"%y%m%d%H%M%S"`.txt※1
sar -A 1 5 > sar_A`date +"%y%m%d%H%M%S"`.txt※1
/usr/samples/kernel/vmtune > vmtune`date +"%y%m%d%H%M%S"`.txt
instfix -i > instfix_i`date +"%y%m%d%H%M%S"`.txt
lslpp -hac >  lslpp_hac`date +"%y%m%d%H%M%S"`.txt
uname -a > uname_a`date +"%y%m%d%H%M%S"`.txt
env > env`date +"%y%m%d%H%M%S"`.txt
set > set`date +"%y%m%d%H%M%S"`.txt
ipcs -a > ipcs_a`date +"%y%m%d%H%M%S"`.txt

HP-UXの場合

df -kt > df_kt`date +"%y%m%d%H%M%S"`.txt
top -s 1 -d 10 -f top`date +"%y%m%d%H%M%S"`.txt
ps -efl > ps`date +"%y%m%d%H%M%S"`.txt
vmstat 1 5 > vmstat`date +"%y%m%d%H%M%S"`.txt
vmstat -s > vmstat_s`date +"%y%m%d%H%M%S"`.txt
netstat -i > netstat_i`date +"%y%m%d%H%M%S"`.txt
netstat -a > netstat_a`date +"%y%m%d%H%M%S"`.txt
iostat 1 5 > iostat`date +"%y%m%d%H%M%S"`.txt
sar -A 1 5 > sar_A`date +"%y%m%d%H%M%S"`.txt※1
swapinfo -a > swapinfo_a`date +"%y%m%d%H%M%S"`.txt※1
kmtune > kmtune`date +"%y%m%d%H%M%S"`.txt
swlist > swlist`date +"%y%m%d%H%M%S"`.txt
swlist -l product > swlist_l_product`date +"%y%m%d%H%M%S"`.txt
uname -a > uname_a`date +"%y%m%d%H%M%S"`.txt
env > env`date +"%y%m%d%H%M%S"`.txt
set > set`date +"%y%m%d%H%M%S"`.txt
ipcs -a > ipcs_a`date +"%y%m%d%H%M%S"`.txt

Linuxの場合

df > df`date +"%y%m%d%H%M%S"`.txt
ps -eflm > ps`date +"%y%m%d%H%M%S"`.txt
vmstat 1 5 > vmstat`date +"%y%m%d%H%M%S"`.txt
netstat -s > netstat_s`date +"%y%m%d%H%M%S"`.txt
netstat -a > netstat_a`date +"%y%m%d%H%M%S"`.txt
iostat 1 5 > iostat`date +"%y%m%d%H%M%S"`.txt※2
top n 5 > top`date +"%y%m%d%H%M%S"`.txt
sar -A 1 > sar`date +"%y%m%d%H%M%S"`.txt※2
sysctl -a > sysctl`date +"%y%m%d%H%M%S"`.txt
rpm -qa > rpm_qa`date +"%y%m%d%H%M%S"`.txt
rpm -qai > rpm_qai`date +"%y%m%d%H%M%S"`.txt
uname -a > uname_a`date +"%y%m%d%H%M%S"`.txt
env > env`date +"%y%m%d%H%M%S"`.txt
set > set`date +"%y%m%d%H%M%S"`.txt
ipcs > ipcs`date +"%y%m%d%H%M%S"`.txt
ipcs -t > ipcs_t`date +"%y%m%d%H%M%S"`.txt
ipcs -p > ipcs_p`date +"%y%m%d%H%M%S"`.txt
ipcs -c > ipcs_c`date +"%y%m%d%H%M%S"`.txt
ipcs -u > ipcs_u`date +"%y%m%d%H%M%S"`.txt
ipcs -l > ipcs_l`date +"%y%m%d%H%M%S"`.txt

Solarisの場合

df -k        > df`date +"%y%m%d%H%M%S"`.txt
ps -eflL     > ps_eflL`date +"%y%m%d%H%M%S"`.txt
vmstat 1 5   > vmstat`date +"%y%m%d%H%M%S"`.txt
vmstat -s    > vmstat_s`date +"%y%m%d%H%M%S"`.txt
netstat -i   > netstat_i`date +"%y%m%d%H%M%S"`.txt
netstat -m   > netstat_m`date +"%y%m%d%H%M%S"`.txt
netstat -a   > netstat_a`date +"%y%m%d%H%M%S"`.txt
iostat 1 5   > iostat`date +"%y%m%d%H%M%S"`.txt
mpstat 1 5   > mpstat`date +"%y%m%d%H%M%S"`.txt
swap -l      > swap_l`date +"%y%m%d%H%M%S"`.txt※1
sar -A 1 5   > sar_A`date +"%y%m%d%H%M%S"`.txt
sysdef       > sysdef`date +"%y%m%d%H%M%S"`.txt※1
pkginfo      > pkginfo`date +"%y%m%d%H%M%S"`.txt
patchadd -p  > patchadd_p`date +"%y%m%d%H%M%S"`.txt※1
uname -a     > uname_a`date +"%y%m%d%H%M%S"`.txt
env          > env`date +"%y%m%d%H%M%S"`.txt
set          > set`date +"%y%m%d%H%M%S"`.txt

注※1

コマンドの実行にはroot権限が必要です。

注※2

sarコマンドおよびiostatコマンドを実行するためには，Linuxに含まれているsysstatパッケージをインストールする必要があります。

(2)　OSのログの取得

トラブルシュート情報として必要なOSのログの取得について，OSごとに説明します。

(a)　Windowsの場合

トラブルシュート情報として必要なOSのログを次に示します。

表5-34　トラブルシュート情報として必要なOSのログ情報

情報の種類
デフォルトのファイル名

イベントログ
イベントビューアを開き，アプリケーションとシステムのログを保存します。

ワトソンログ
次のディレクトリに格納されます。
C:¥Documents and Settings¥All Users¥Documents¥DrWatson¥drwtsn32.log

注

「C:」はOSがインストールされているドライブ名です。

なお，ワトソンログの出力先はワトソン博士の設定画面で確認してください。

(b)　UNIXの場合

トラブルシュート情報として必要なOSのログ（syslog）の格納場所を次に示します。

AIXの場合

/var/adm/ras下すべて

HP-UXの場合

/var/adm/syslog下すべて

Linuxの場合

/var/log下すべて

Solarisの場合

dmesg > dmesg`date +"%y%m%d%H%M%S"`.txt

（dmesgコマンドの実行結果を任意のファイルに格納します）

5.4.11　OSの統計情報の取得

OSの統計情報の取得について，OSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

障害発生後のパフォーマンスログを保存しておきます。「パフォーマンス」の操作の詳細については，OS付属のマニュアルなどを参照してください。

ポイント

OSの統計情報は，あらかじめ，OS付属の「パフォーマンス」でパフォーマンスログの取得を開始している場合にだけ取得できます。

J2EEサーバ実行中に次のシステムモニタのログを60秒間隔で採取します。具体的な設定方法は，OS付属のマニュアルなどを確認してください。

表5-35　システムモニタの設定

パフォーマンスオブジェクト | インスタンス | 項目名 | 説明
processor | － | %Processor Time | CPU使用率（非アイドル状態のスレッドを除く合計値）。
%Privileged Time | CPU使用率（カーネルモード分）。
%User Time | CPU使用率（ユーザモード分）。
memory | － | Cache Bytes | ファイルシステム キャッシュが現在使用しているバイト数。
Cache Faults/sec | 1秒間当たりのメモリの別の場所からの取り出しか，ディスクから取り出しの回数。
Page Faults/sec | 1秒間当たりのページフォールトの数。
Transition Faults/sec | 1秒間当たりのフォールトの数。
process | _Total | Handle Count | 現在オープンしているハンドルの総数。
Page Faults/sec | ページフォールトの発生率。
Private Bytes | メモリ使用量（バイト）。
Virtual Bytes | 仮想メモリ使用量（バイト）。
Working Set Bytes | 実メモリ使用量（バイト）。
cjstartsv | %Processor Time | CPU使用率（非アイドル状態のスレッドを除く合計値）。
%Privileged Time | CPU使用率（カーネルモード分）。
%User Time | CPU使用率（ユーザモード分）。
Page Faults/sec | ページフォールトの発生率。
Thread Count | スレッド数。
Private Bytes | メモリ使用量（バイト）。
Virtual Bytes | 仮想メモリ使用量（バイト）。
Working Set Bytes | 実メモリ使用量（バイト）。

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

(2)　UNIXの場合

Cosminexus起動中に次に示すコマンドを実行して，OSの統計情報を取得します。60秒間隔で取得することを推奨しますが，ディスク容量に応じて取得間隔を決めてください。なお，取得間隔を長くすると，OSの統計情報の取得による性能劣化を少なくできますが，OSの統計情報の精度が悪化することがあります。

AIXの場合

ps -efl
ps -A -m -o THREAD
vmstat -t
vmstat -s
lsps -s
svmon -P <cjstartsv，cjstartwebのプロセスID>※1
svmon -G ※1
sar -A 1※1

HP-UXの場合

ps -efl
top -d 1 -f {ファイル名}
vmstat -t
vmstat -s
swapinfo -a※1
sar -A 1※1

Linuxの場合

ps -eflm
top n 1
vmstat
sar -A 1※2

Solarisの場合

ps -eflL
swap -l※1
vmstat
sar -A 1

注※1

コマンドの実行にはroot権限が必要です。

注※2

sarコマンドを実行するためには，Linuxに含まれているsysstatパッケージをインストールする必要があります。

5.4.12　Cosminexusの定義情報の取得

Cosminexusの定義を取得します。この情報を使用して，障害が発生したときに設定されていた定義内容を確認します。

Cosminexus Component Containerに関する定義情報

次のディレクトリ下に格納されているファイル一式を取得します。

Windowsの場合

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

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>

Cosminexus DABroker Libraryに関する定義情報

次のファイルを取得します。

Windowsの場合

<Cosminexus DABroker Library運用ディレクトリ>¥conf¥dasys.conf（Cosminexus DABroker Library動作環境定義ファイル）

<Cosminexus DABroker Library運用ディレクトリ>¥conf¥dabenv（接続先データベース定義ファイル）

UNIXの場合

<Cosminexus DABroker Library運用ディレクトリ>/conf/dasys.conf（Cosminexus DABroker Library動作環境定義ファイル）

<Cosminexus DABroker Library運用ディレクトリ>/conf/dabenv（接続先データベース定義ファイル）

トラブルシューティング用に保存するファイルからは，パスワードなどの公開できない情報を削除することをお勧めします。

5.4.13　Cosminexusの作業ディレクトリの内容の取得

システムでトラブルが発生した場合に，保守員による原因究明のため作業ディレクトリを調査に使用する場合があります。作業ディレクトリは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定したディレクトリです。なお，作業ディレクトリのデフォルトのディレクトリパスは「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」（Windowsの場合），または「/opt/Cosminexus/CC/server/public」（UNIXの場合）です。

設定を確認した上で，トラブルが発生した場合に保存しておいてください。

5.4.14　Cosminexusのリソース設定情報の取得

コネクションプールの設定などリソースの設定を確認するために，リソースの設定情報を取得します。設定情報の格納場所は次のとおりです。

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>¥import

<作業ディレクトリ>¥ejb¥<サーバ名称>¥rars

UNIXの場合

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

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

5.4.15　Webサーバログの取得

システムで使用しているWebサーバ（Hitachi Web ServerまたはMicrosoft IIS）のログを取得します。

Hitachi Web Serverの場合
ログの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥httpsd¥logs

UNIXの場合
/opt/hitachi/httpsd/logs（デフォルト）

Microsoft IISの場合
ログの格納場所を次に示します。
C:¥WINNT¥system32¥LogFiles¥W3SVC1（C:の部分にはシステムドライブを指定します）

5.4.16　JavaVMのスタックトレース情報の取得

UNIXでは，JavaVMが異常終了してcoreダンプが出力された場合，異常終了した原因の究明に必要な情報（スタックトレース情報）を，javatraceコマンドで取得できます。javatraceコマンドでは，出力されたcoreダンプから，スタックトレース情報を取得します。javatraceコマンドは，「/opt/Cosminexus/jdk/jre/bin」にインストールされています。

javatraceコマンドの実行形式を次に示します。

javatrace coreダンプのファイル名称 coreダンプを生成した実行ファイルの名称

JavaVMが異常終了して，「core」というファイル名称でcoreダンプが作成されているときにこのコマンドを実行すると，実行結果として，カレントディレクトリ下に「javatrace.log」というファイルが出力されます。このファイルは保守員に送付してください。

実行例

JavaVMが異常終了してcoreダンプが作成されたときに出力されるメッセージの例を，次に示します。

 ：
# You can get further information from javatrace.log file generated
# by using javatrace command.
# usage: javatrace core-file-name loadmodule-name [out-file-name] [-l(library-name)...]
# Please use javatrace command as follows and submit a bug report
# to Hitachi with javatrace.log file:
# [/opt/Cosminexus/jdk/jre/bin/javatrace core /opt/Cosminexus/CC/server/bin/cjstasrtsv]
#

メッセージ内に表示されるjavatraceコマンドの文字列を実行します。この例の場合は，「/opt/Cosminexus/jdk/jre/bin/javatrace core /opt/Cosminexus/CC/server/bin/cjstasrtsv」を実行してください。実行結果として，カレントディレクトリに「javatrace.log」というファイルが出力されます。

なお，OSによっては実際に出力されるcoreダンプのファイル名が「core.プロセスID」になる場合があります。その場合は，実際に出力されたcoreダンプのファイル名をjavatraceの引数に指定してください。

5.5　資料の調査

この節では，取得した資料に出力される内容について説明します。これらの資料を基に，トラブルの原因を判別してください。

ここでは，次の資料について説明します。

Cosminexusのログ

EJBクライアントアプリケーションのログ

Cosminexus DABroker Libraryのスプール情報

性能解析トレース

JavaVMのスレッドダンプ

JavaVMのガーベージコレクションログ

日立JavaVM固有のログ（日立JavaVMログファイル）

JavaVMが出力するメッセージログ（標準出力およびエラーリポートファイル）

OSの状態情報およびOSのログ

スタックトレース

なお，「5.3　資料の取得」で取得した資料のうち，OSの統計情報については，ご使用のOS付属のマニュアルなどを参照してください。また，メモリダンプは，保守員が確認する情報なので，ここでは説明しません。

注意

Windows Vistaを使用している場合，次の点に注意してください。

ログやPRFトレースに出力する内容にUnicodeの補助文字が含まれている場合，その文字は正しく出力されません。ただし，それ以外の出力内容や，アプリケーションの動作に問題はありません。Unicodeの補助文字は，Internet Explorer 7などのクライアントから送信されたリクエストに含まれることがあります。

＜この節の構成＞

5.5.1　Cosminexusのログの調査

5.5.2　EJBクライアントアプリケーションのログの調査

5.5.3　Cosminexus DABroker Libraryのスプール情報の調査

5.5.4　性能解析トレースの調査

5.5.5　JavaVMのスレッドダンプの調査

5.5.6　JavaVMのガーベージコレクションログの調査

5.5.7　日立JavaVM固有のログの調査（日立JavaVMログファイル）

5.5.8　JavaVMが出力するメッセージログの調査（標準出力およびエラーリポートファイル）

5.5.9　OSの状態情報およびOSのログの調査

5.5.10　スタックトレースの調査

5.5.1　Cosminexusのログの調査

ここでは，Cosminexusのログの調査方法について説明します。

Cosminexusのログのメッセージログ・ユーザログを調査することでエラーの発生原因を調べることができます。また，プロセス障害などの場合も，処理の進行具合や障害の兆候を確認できます。

なお，Cosminexusのログとして収集する資料のうち，Cosminexus DABroker Libraryのスプール情報については形式が異なります。Cosminexus DABroker Libraryのスプール情報については，「5.5.3　Cosminexus DABroker Libraryのスプール情報の調査」を参照してください。また，Cosminexusのログのうち，EJBクライアントアプリケーションのシステムログを参照する場合の留意事項については，「5.7.1　EJBクライアントアプリケーションのシステムログに関する留意事項」を参照してください。

ここでは，次のログの出力形式と出力項目について説明します。

日立トレース共通ライブラリ形式のログ

インプロセスHTTPサーバのアクセスログ

イベントログ

syslog

監査ログで出力するログ

構築済み実行環境の切り替えで出力するログ

また，Cosminexusのログの種別には，次の三つがあります。

日立トレース共通ライブラリ形式（シングルプロセス）

日立トレース共通ライブラリ形式（マルチプロセス）

独自形式

それぞれのCosminexusのログの種別を，次の表に示します。

表5-36　 J2EEサーバおよびリダイレクタのログ種別

分類
内容
種別

メッセージログ
稼働ログ
日立トレース共通ライブラリ形式（シングルプロセス）

ログ稼働ログ
日立トレース共通ライブラリ形式（シングルプロセス）

リダイレクタのメッセージログ

WindowsでHitachi Web Serverを使用する場合
日立トレース共通ライブラリ形式（シングルプロセス）

WindowsでMicrosoft IIS 6.0を使用する場合またはUNIXの場合
日立トレース共通ライブラリ形式（マルチプロセス）

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの稼働ログ
日立トレース共通ライブラリ形式（シングルプロセス）

J2EEアプリケーションに含めて使用するリソースアダプタの稼働ログ
日立トレース共通ライブラリ形式（シングルプロセス）

ユーザログ
Webサーブレットログ
日立トレース共通ライブラリ形式（シングルプロセス）

ユーザ出力ログ
日立トレース共通ライブラリ形式（シングルプロセス）

ユーザエラーログ
日立トレース共通ライブラリ形式（シングルプロセス）

JavaVMの保守情報およびガーベージコレクションのログ
日立トレース共通ライブラリ形式（シングルプロセス）

例外ログ
障害発生時の例外情報
日立トレース共通ライブラリ形式（シングルプロセス）

保守用ログ
保守情報
日立トレース共通ライブラリ形式（シングルプロセス）

コンソールメッセージ
日立トレース共通ライブラリ形式（シングルプロセス）

EJBコンテナの保守情報
日立トレース共通ライブラリ形式（シングルプロセス）

Webコンテナの保守情報
日立トレース共通ライブラリ形式（シングルプロセス）

起動プロセス標準出力情報
日立トレース共通ライブラリ形式（シングルプロセス）

起動プロセス標準エラー情報
日立トレース共通ライブラリ形式（シングルプロセス）

終了プロセス情報
日立トレース共通ライブラリ形式（シングルプロセス）

リダイレクタの保守用トレースログ

WindowsでHitachi Web Serverを使用する場合
日立トレース共通ライブラリ形式（シングルプロセス）

WindowsでMicrosoft IIS 6.0を使用する場合またはUNIXの場合
日立トレース共通ライブラリ形式（マルチプロセス）

イベントログ
J2EEサーバの起動，停止または異常終了を示すログ
日立トレース共通ライブラリ形式（シングルプロセス）

syslog
J2EEサーバの起動，停止または異常終了を示すログ
日立トレース共通ライブラリ形式（シングルプロセス）

表5-37　サーバ管理コマンドのログ

分類 | 内容 | 種別
メッセージログ | 稼働ログ | 日立トレース共通ライブラリ形式（マルチプロセス）
ログ稼働ログ | 独自形式
例外ログ | 障害発生時の例外情報 | 日立トレース共通ライブラリ形式（マルチプロセス）
保守用ログ | 保守情報 | 日立トレース共通ライブラリ形式（マルチプロセス）
コンソールメッセージ | 日立トレース共通ライブラリ形式（マルチプロセス）
サーバ管理コマンドの保守情報 | 日立トレース共通ライブラリ形式（マルチプロセス）

表5-38　リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

分類 | 内容 | 種別
メッセージログ | 稼働ログ | 日立トレース共通ライブラリ形式（マルチプロセス）
例外ログ | 障害発生時の例外情報 | 日立トレース共通ライブラリ形式（マルチプロセス）
保守用ログ | 保守情報 | 日立トレース共通ライブラリ形式（マルチプロセス）

表5-39　インプロセスHTTPサーバのログ

分類 | 内容 | 種別
アクセスログ | インプロセスHTTPサーバの処理結果 | 独自形式
スレッドトレース | スレッドトレースの情報 | 独自形式
通信トレース | 通信トレースの情報 | 独自形式

表5-40　移行コマンド（cjenvupdate）のログ

分類 | 内容 | 種別
メッセージログ | cjenvupdateコマンドの稼働ログ | 日立トレース共通ライブラリ形式（マルチプロセス）
例外ログ | cjenvupdateコマンドの例外情報 | 日立トレース共通ライブラリ形式（マルチプロセス）
保守用ログ | cjenvupdateコマンドの保守情報 | 日立トレース共通ライブラリ形式（マルチプロセス）

表5-41　リソース枯渇監視のログ

監視対象
リソース
種別

メモリ
日立トレース共通ライブラリ形式（シングルプロセス）

ファイルディスクリプタ
日立トレース共通ライブラリ形式（シングルプロセス）

スレッド
日立トレース共通ライブラリ形式（シングルプロセス）

スレッドダンプ
日立トレース共通ライブラリ形式（シングルプロセス）

HTTPリクエスト実行待ちキュー
日立トレース共通ライブラリ形式（シングルプロセス）

HTTPセッション数
日立トレース共通ライブラリ形式（シングルプロセス）

コネクションプール
日立トレース共通ライブラリ形式（シングルプロセス）

表5-42　運用管理エージェント・運用監視エージェント・Management Serverのログ

分類
内容
種別

統合ログ
統合メッセージログ
日立トレース共通ライブラリ形式（マルチプロセス）

統合トレースログ
日立トレース共通ライブラリ形式（マルチプロセス）

コマンド保守ログ
日立トレース共通ライブラリ形式（マルチプロセス）

運用管理エージェント
運用管理エージェントの標準エラー出力
日立トレース共通ライブラリ形式（シングルプロセス）

運用管理エージェントの標準出力
日立トレース共通ライブラリ形式（シングルプロセス）

運用管理エージェントの標準エラー出力コマンドライン
独自形式

運用管理エージェントのログ
日立トレース共通ライブラリ形式（シングルプロセス）

運用管理エージェントの起動・停止コマンドのログ
日立トレース共通ライブラリ形式（シングルプロセス）

運用管理エージェントの保守ログ
日立トレース共通ライブラリ形式（シングルプロセス）

コンソールログ
日立トレース共通ライブラリ形式（シングルプロセス）

運用管理エージェントサービスのログ
日立トレース共通ライブラリ形式（シングルプロセス）

運用管理エージェントサービスの標準出力
独自形式

運用管理エージェントサービスの標準エラー出力
独自形式

運用監視エージェント
運用監視エージェントのログ・トレース
J2EEサーバ用システムJP1イベントおよびJ2EEサーバ用ユーザJP1イベントのログ
Managementイベント発行ログ
日立トレース共通ライブラリ形式（シングルプロセス）

Management Server
Management Serverサービスのログ
日立トレース共通ライブラリ形式（シングルプロセス）

Management Serverサービスの標準エラー出力
独自形式

Management Serverサービスの標準出力
独自形式

Management Serverサービス起動・停止コマンド
日立トレース共通ライブラリ形式（シングルプロセス）

Management Serverのログ
Cosminexusの運用管理サーバのシステムJP1イベントのログ
日立トレース共通ライブラリ形式（シングルプロセス）

mngenvsetupコマンドの実行ログ
日立トレース共通ライブラリ形式（シングルプロセス）

Management Serverの保守ログ
日立トレース共通ライブラリ形式（シングルプロセス）

表5-43　Cosminexus Performance Tracerのログ

内容 | 種別
PRFデーモンおよびPRFコマンドのログ | 独自形式
モジュールトレース | 独自形式
構造化例外発生ログ | 独自形式
保守情報 | 独自形式

表5-44　 Cosminexus Component Transaction Monitorのログ

内容 | 種別
CTMデーモンおよびCTMコマンドのログ | 独自形式
保守情報 | 独自形式

表5-45　 Cosminexus DABroker Libraryのログ

内容 | 種別
メッセージログ | 日立トレース共通ライブラリ形式（マルチプロセス）
拡張データベースアクセストレース | 日立トレース共通ライブラリ形式（マルチプロセス）
エラートレース | 日立トレース共通ライブラリ形式（マルチプロセス）
Exceptionトレースログ | 日立トレース共通ライブラリ形式（マルチプロセス）
イベントトレース（DABroker for C++をインストールしている場合） | 日立トレース共通ライブラリ形式（マルチプロセス）
XAトレース | 日立トレース共通ライブラリ形式（マルチプロセス）

表5-46　監査ログで出力するログ

分類 | 内容 | 種別
メッセージログ | 監査ログのメッセージログ | 日立トレース共通ライブラリ形式（マルチプロセス）
例外ログ | 監査ログの例外情報 | 日立トレース共通ライブラリ形式（マルチプロセス）

表5-47　構築済み実行環境の切り替えで出力するログ

内容 | 種別
cosmienvコマンドのログ | 独自形式

＜この項の構成＞

(1)　日立トレース共通ライブラリ形式のログの出力形式と出力項目

(2)　日立トレース共通ライブラリ形式のログを参照する場合の注意

(3)　インプロセスHTTPサーバのアクセスログの出力形式と出力項目

(4)　イベントログの出力形式と出力項目（Windowsの場合）

(5)　syslogの出力形式と出力項目（UNIXの場合）

(6)　構築済み実行環境の切り替えで出力するログの出力形式と出力項目（UNIXの場合）

(1)　日立トレース共通ライブラリ形式のログの出力形式と出力項目

日立トレース共通ライブラリ形式のログの出力形式と出力項目について説明します。

Cosminexusのログは，日立トレース共通ライブラリ形式で出力されます。

(a)　出力形式

日立トレース共通ライブラリ形式のログの出力形式を次に示します。

番号　日付　時刻　AP名　pid tid メッセージID　種別　メッセージテキスト　CRLF

(b)　出力項目

日立トレース共通ライブラリ形式のログの出力項目を次に示します。

表5-48　日立トレース共通ライブラリ形式のログの出力項目

項目名 | 説明
番号 | トレースレコードの通番を示す4けたの番号が出力されます。
日付 | トレースの取得日付が「yyyy/mm/dd」の形式で出力されます。
時刻 | トレースの取得時刻が「hh:mm:ss.sss」の形式で出力されます。
AP名 | プログラムを示す文字列が出力されます。
pid | プロセスIDが出力されます。
tid | スレッドIDが出力されます。
メッセージID | メッセージIDが「XXXXnnnnn-Y」の形式で出力されます。
種別 | トレース出力の契機となったイベント種別が出力されます。
メッセージテキスト | メッセージテキストが出力されます。付加情報が付くこともあります。
CRLF | レコードの終端符号（0x0D，0x0A）が出力されます。

ログファイルの編集表示について

日立トレース共通ライブラリ形式のログをMicrosoft Excelで表示して，フィルタリングや並べ替えの機能を利用すると，トラブルの発生要因の調査を効率良く進められるようになります。

Microsoft Excelを利用した日立トレース共通ライブラリ形式のログの表示例を次に示します。

図5-6　Microsoft Excelを利用した日立トレース共通ライブラリ形式のログの表示例

参考

区切るデータの形式として，「スペースによって右または左にそろえられた固定長フィールドデータ」を選択してください。

［データのプレビュー］ボックスで不要な矢印を削除してください。

各列の［表示形式］に［文字列］を指定してください。

(2)　日立トレース共通ライブラリ形式のログを参照する場合の注意

日立トレース共通ライブラリ形式のログを使用する場合の注意事項について説明します。

(a)　マルチプロセス・シングルプロセス共通の注意事項

マルチプロセス・シングルプロセス共通の注意事項について説明します。

出力されたログファイルを編集しないでください。

テキストエディタの機能などを使用して，ファイルロックをしないでください。

出力されたログファイルにアクセス権限を手動で設定する場合は，適切なアクセス権を与えてください。

出力されたログファイルの更新時刻を変更しないでください。

トレース出力中に，ログファイルを削除したり，ファイル名を変更したりしないでください。ログファイルの削除，またはファイル名の変更は，すべてのトレース出力プロセスを停止してから実行してください。

(b)　マルチプロセスの日立トレース共通ライブラリ参照時の注意事項

マルチプロセスに対応した日立トレース共通ライブラリ形式のログファイルを参照する場合の注意事項を次に示します。

メッセージ末尾の改行コードは，使用しているOSに関係なくCRLFです。

ログファイルのファイルサイズ，面数，およびモードオプションの変更を有効にするために，ログファイルを削除する必要がある場合があります。ログファイルの削除は，すべてのトレース出力プロセスを停止してから実行してください。

出力したログファイル内で有効なデータは，ファイルの先頭から最初のEOFまでです。ログファイルを参照するときには，最初のEOF以降のデータは無視してください。EOF以降のデータは，ラップアラウンド以前のログファイルの無効なデータです。有効なログファイルのデータの末尾は，次に示すデータになります。

EOF CRLF CRLF CRLF CRLF----------< End of Data >----------CRLF CRLF

EOFはトレースデータの終端を表す文字（0x1A）です。CRLFは，改行（0x0D，0x0A）を表します。

トレースが出力されても，ログファイルの更新時刻が更新されない場合があります。そのため，ファイルの更新時刻を基にトレースが出力されたかどうかを判断することはできません。

(3)　インプロセスHTTPサーバのアクセスログの出力形式と出力項目

インプロセスHTTPサーバのアクセスログの出力形式と出力項目について説明します。

アクセスログには，インプロセスHTTPサーバのリクエストの処理結果が出力されます。また，アクセスログの出力形式には，デフォルトで出力されるデフォルトフォーマットと拡張フォーマットがあります。インプロセスHTTPサーバのアクセスログのカスタマイズについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

出力形式は次のとおりです。

デフォルトフォーマット

クライアントのホスト名　-　認証ユーザ名　アクセス時刻　リクエストライン　ステータスコード　送信バイト数

拡張フォーマット

クライアントのホスト名　-　認証ユーザ名　アクセス時刻　リクエストライン　ステータスコード　送信バイト数　Refererヘッダの内容　User-Agentヘッダの内容

それぞれの項目の内容を次の表に示します

表5-49　アクセスログの出力項目

項番 | 項目名 | 説明
1 | クライアントのホスト名 | クライアントのホスト名が表示されます。ホスト名が設定されていない場合はIPアドレスが表示されます。
2 | 認証ユーザ名 | ベーシックユーザ認証名，またはフォーム認証ユーザ名が表示されます。フォームユーザ認証名および，フォームユーザ認証名が設定されていない場合はハイフン（-）が表示されます。
3 | アクセス時刻 | インプロセスHTTPサーバがクライアントのリクエストに応答した時間が表示されます。
4 | リクエストライン | リクエストラインが表示されます。
5 | ステータスコード | 最終ステータスコードが表示されます。ただし内部でリダイレクトされた値は出力しません。
6 | 送信バイト数 | HTTPヘッダを除く送信バイト数が表示されます。0バイトのときはハイフン（-）が表示されます。
7 | Refererヘッダの内容 | 遷移する前のWebページのURLが表示されます。
8 | User-Agentヘッダの内容 | Webクライアント（ブラウザ名やブラウザのバージョンなど）の情報が含まれたヘッダが表示されます。

なお，アクセスログには，クライアントのIPアドレス，J2EEサーバのIPアドレス，リクエストメソッド，クライアントからのリクエスト処理に掛かった時間などの項目を任意で追加できます。インプロセスHTTPサーバのアクセスログのカスタマイズについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

アクセスログの出力例を次に示します。

デフォルトフォーマットの場合

10.20.30.40 - user1 [18/Jan/2005:13:06:10 +0900] "GET / HTTP/1.0" 200 38
10.20.30.40 - user1 [18/Jan/2005:13:06:25 +0900] "GET /demo/ HTTP/1.0" 500 684

拡張フォーマットの場合

10.20.30.40 - user1 [18/Jan/2005:13:06:10 +0900] "GET / HTTP/1.0" 200 38 "-" "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)"
10.20.30.40 - user1 [18/Jan/2005:13:06:25 +0900] "GET /demo/ HTTP/1.0" 500 684 "-" "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)"

(4)　イベントログの出力形式と出力項目（Windowsの場合）

イベントログの出力形式と出力項目について説明します。

イベントログは，J2EEサーバの起動，停止および異常終了時に出力されるログです。出力形式は次のとおりです。

ID文字列　[pid]:　メッセージテキスト

出力項目を次に示します。

表5-50　イベントログの出力項目

項目名 | 説明
ID文字列 | アプリケーションを示す文字列として，「HEJB」が出力されます。
pid | プロセスIDが出力されます。
メッセージテキスト | メッセージテキストが出力されます。

(5)　syslogの出力形式と出力項目（UNIXの場合）

syslogの出力形式と出力項目について説明します。

syslogは，J2EEサーバの起動，停止および異常終了時に出力されるログです。出力形式は次のとおりです。

日付　時刻　ホスト名　ID文字列　[pid]:メッセージテキスト

出力項目を次に示します。

表5-51　syslogの出力項目

項目名 | 説明
日付 | メッセージを出力した日付です。
時刻 | メッセージを出力した時刻です。
ホスト名 | ホスト名を示す文字列が出力されます。
pid | プロセスIDが出力されます。
ID文字列 | アプリケーションを示す文字列として，「HEJB」が出力されます。
メッセージテキスト | メッセージテキストが出力されます。

(6)　構築済み実行環境の切り替えで出力するログの出力形式と出力項目（UNIXの場合）

構築済み実行環境をcosmienvコマンドで切り替えた場合に出力される，ログファイルの出力形式および出力項目について説明します。

cosmienvコマンド実行時に出力されるログファイルには，cosmienv_s[2].log，cosmienv_d[2].log，およびcosmienv_r[2].logがあります。これらのファイルの出力形式および出力項目はすべて同じです。

cosmienvコマンド実行時に出力されるログファイルの出力形式は次のとおりです。

YYYY/MM/DD HH:MM:SS 製品の形名 製品名 VVRRSS START
YYYY/MM/DD HH:MM:SS 構成ソフトウェアの形名 START 起動時のコマンドと引数
[YYYY/MM/DD HH:MM:SS 構成ソフトウェアの保守情報]
YYYY/MM/DD HH:MM:SS 構成ソフトウェアの形名 END 構成ソフトウェアの戻り値
：
YYYY/MM/DD HH:MM:SS 製品の形名 製品名 VVRRSS END cosmienvコマンドの戻り値

cosmienvコマンドのログの出力項目を次に示します。

表5-52　cosmienvコマンドのログの出力項目

項目名
説明

YYYY/MM/DD
cosmienvコマンドを実行した日付が出力されます。

HH:MM:SS
cosmienvコマンドを実行した時刻が出力されます。

製品の形名
退避，回復，または削除の対象とした実行環境の形名が出力されます。

製品名
退避，回復，または削除の対象とした実行環境の製品名が出力されます。

VVRRSS
退避，回復，または削除の対象とした実行環境の製品のバージョン情報が出力されます。

構成ソフトウェアの形名
退避，回復，または削除の対象とした実行環境の製品に含まれる構成ソフトウェアの形名が出力されます。
構成ソフトウェアの情報は，製品に含まれる構成ソフトウェアの数分出力されます。

起動時のコマンドと引数
内部処理（構成ソフトウェアの処理）を起動したコマンドと，引数が出力されます。

構成ソフトウェアの保守情報
内部処理（構成ソフトウェアの処理）実行時の保守情報が出力されます。

構成ソフトウェアの戻り値※
内部処理（構成ソフトウェアの処理）の実行結果が出力されます。

cosmienvコマンドの戻り値※
cosmienvコマンドの実行結果が出力されます。

注※　構成ソフトウェアおよびcosmienvコマンドの戻り値については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

退避機能を実行した場合の出力例を次に示します。この例では，退避機能実行時に，構成ソフトウェアの処理でディスク容量不足を検出しています。

2007/05/20 14:37:22 P-1M43-7K71 uCosminexus Application Server Enterprise 07-50 START
2007/05/20 14:37:22 P-1M3Z-7151 START 2007/05/20 14:37:22 P-1M43-7K71 uCosminexus Application Server Enterprise 07-50 START
2007/05/20 14:37:22 P-1M3Z-7151 START cosmippenv -s -P/home/CosmiBackup/UCAPSE001 -ZCosmiInside
2007/05/20 14:37:24 P-1M3Z-7151 END 0
2007/05/20 14:37:47 P-1M41-E171 START cosmippenv -s -P/home/CosmiBackup/UCAPSE001 -ZCosmiInside
2007/05/20 14:37:52 httpsd tar: tape write error: No space left on device
2007/05/20 14:37:53 P-1M41-E171 END 128
2007/05/20 14:37:54 P-1M43-7K71 uCosminexus Application Server Enterprise 07-50 END 143

5.5.2　EJBクライアントアプリケーションのログの調査

ここでは，EJBクライアントアプリケーションのログの種別について説明します。ログの種別の詳細，それぞれのログの出力形式と出力項目，および参照する場合の注意事項については，「5.5.1　Cosminexusのログの調査」を参照してください。

EJBクライアントアプリケーションのログの種別を次に示します。

表5-53　EJBクライアントアプリケーションのログの種別

種類 | 内容 | 種別
メッセージログ | 稼働ログ | 日立トレース共通ライブラリ形式（マルチプロセス）
cjclstartapコマンドの稼働ログ | 日立トレース共通ライブラリ形式（マルチプロセス）
cjcldellogコマンドの稼働ログ | 日立トレース共通ライブラリ形式（マルチプロセス）
ユーザログ | ユーザ出力ログ | 日立トレース共通ライブラリ形式（マルチプロセス）
ユーザエラーログ | 日立トレース共通ライブラリ形式（マルチプロセス）
Javaログ | JavaVMの保守情報，ガーベージコレクションのログ | 独自形式
例外ログ | 障害発生時の例外情報 | 日立トレース共通ライブラリ形式（マルチプロセス）

5.5.3　Cosminexus DABroker Libraryのスプール情報の調査

Cosminexus DABroker Libraryのスプール情報の調査方法について説明します。

Cosminexus DABroker Libraryのスプール情報には，次の種類があります。これらの情報は，<Cosminexus DABroker Libraryの運用ディレクトリ>¥spool（Windowsの場合），または<Cosminexus DABroker Libraryの運用ディレクトリ>/spool（UNIXの場合）に出力されています。

表5-54　Cosminexus DABroker Libraryのスプール情報

スプール情報の種類
対応するファイル

メッセージログ
dabsv.log
dabsv.logold

拡張データベースアクセストレース
db_accessディレクトリ下のファイル

エラートレース
dabevttrcerr1.txt（ログ出力用ファイル）
dabevttrcerr2.txt（バックアップ用ファイル）※1

Exceptionトレースログ
J2EEサーバ名称+MTrc.logおよびJ2EEサーバ名称+MTrcOLD.log

イベントトレース※2
dabevttrcXXX1およびdabevttrcXXX2

XAトレース
db_xainfo.log

注※1　これらのほか，ワークファイルが，dabevttrcerr1.txt.lockという名称で作成されます。

注※2　DABroker for C++をインストールしている場合に出力されます。

それぞれの情報について説明します。

また，このほか，Cosminexus DABroker Libraryのログとしては，次のJDBCドライバのトレースが取得できます。これらのトレースは，アプリケーション開発時に設定されている場合だけ出力されます。

JDBCドライバのトレース（JDBCインタフェースメソッドトレース）

JDBCドライバのトレース（Cosminexus DABroker Libraryとのイベントトレース）

＜この項の構成＞

(1)　メッセージログ

(2)　拡張データベースアクセストレース

(3)　エラートレース

(4)　Exceptionトレースログ

(5)　イベントトレース

(6)　XAトレースの取得形式

(7)　JDBCドライバのトレース（JDBCインタフェースメソッドトレース）

(8)　JDBCドライバのトレース（Cosminexus DABroker Libraryとのイベントトレース）

(1)　メッセージログ

Cosminexus DABroker Libraryのメッセージが出力されたファイルです。

(2)　拡張データベースアクセストレース

データベースへの接続から切断までのアクセス情報を出力したトレースです。データベースへの接続ごとに出力されます。

拡張データベースアクセストレースは，次のように利用できます。

データベースのアクセス中に発生したトラブルの迅速な切り分け

24時間稼働に対応するJ2EEアプリケーションの稼働状態でのトラブル調査

マルチスレッド環境でJ2EEアプリケーションが動作している場合のスレッドごとのデータベースアクセス履歴取得

コネクションプーリングなどの機能を使用している場合のデータベースへの接続ごとのデータベースアクセス履歴取得

トラブルが再現調査できない場合の常時トレース取得

なお，出力するイベントの種類や，トレースファイルの最大容量などは，Cosminexus DABroker Libraryの［環境設定ユティリティ］，またはCosminexus DABroker Library動作環境定義ファイルで定義しておきます。Cosminexus DABroker Libraryの動作環境の設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。Cosminexus DABroker Library動作環境定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(a)　出力形式

拡張データベースアクセストレースのファイル出力形式を次に示します。斜体は可変の情報です。拡張データベースアクセストレースは，次の2種類の情報で構成されます。

ヘッダ情報

個々のトレース情報

個々のトレース情報は，出力項目を示すタイトル行の下に出力されます。

Windowsの場合

*-------------------------------------------------------*
*- DataBase Access Information (DRV)                   -*
*- Date  YYYY/MM/DD hh:mm:ss.nnnnnn                    -*
*-------------------------------------------------------*
DABroker Connect ID    : AAAAA(BBBBB)
Process ID             : CCCCC
UserID                 : DDDDD
Client Name            : EEEEE
(DB別出力情報)
Lang Mode              : GGGGG

THREAD-ID  CID   EVT   START-TIME   END-TIME   RETCODE  BLOCKCNT  (Windows QueryPerformance Counter) HiRDB_CONNECTION_ID
（トレース情報）
(SQL)SS…SS
（トレース情報）

UNIXの場合

*-------------------------------------------------------*
*- DataBase Access Information (DRV)                   -*
*- Date  YYYY/MM/DD hh:mm:ss.nnnnnn                    -*
*-------------------------------------------------------*
DABroker Connect ID    : AAAAA(BBBBB)
Process ID             : CCCCC
UserID                 : DDDDD
Client Name            : EEEEE
(DB別出力情報)
Lang Mode              : GGGGG

THREAD-ID  CID   EVT   START-TIME   END-TIME   RETCODE
BLOCKCNT   HiRDB_CONNECTION_ID
（トレース情報）
(SQL)SS・S
（トレース情報）

(b)　出力項目

拡張データベースアクセストレースの出力項目について，次の表に示します。斜体は可変の情報です。

表5-55　拡張データベースアクセストレースの出力項目

項目
内容

ヘッダ情報

DRV
Cosminexus DABroker Libraryのデータベースアクセスドライバの種別に従い，次の識別子が出力されます。

HiRDB接続の場合：HiRDB Driver

Oracle8i接続の場合：ORACLE8i Driver※（Oracle Call Interface 8iを使用）

Oracle7接続の場合：ORACLE7 Driver（Oracle Call Interface 7を使用）

Date:YYYY/MM/DD hh:mm:ss.nnnnnn
ファイル作成日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

DABroker Connect ID:AAAAA(BBBBB)
データベース接続識別子が出力されます。

Process ID:CCCCC
実行プロセスIDが出力されます。

UserID:DDDDD
接続ユーザIDが出力されます。
Cosminexus DABroker LibraryでORACLEのOS認証機能を使用した場合は，「OS authority」となります。

Client Name:EEEEE
J2EEアプリケーション名称が出力されます。名称が設定されていない場合は空白になります。

(DB別出力情報)
接続データベースによって異なる情報が出力されます。

HiRDBの場合

PDHOST：
HiRDB接続時のPDHOSTの設定内容です。
未設定の場合は，"Not Indicator"が出力されます。

PDNAMEPORT：
HiRDB接続時のPDNAMEPORTの設定内容です。
未設定の場合は，"Not Indicator"が出力されます。

Oracleの場合

SQLNET：
Oracleリスナー名が出力されます。
未設定の場合は，"Not Indicator"が出力されます。

Lang Mode:GGGGG
実行言語モードが出力されます。

個々のトレース情報

THREAD-ID
実行スレッドIDが出力されます。

CID
カーソル番号が出力されます。

EVT
Cosminexus DABroker Libraryがデータベースに要求した処理内容を示す文字列が出力されます。データベースアクセストレースおよび拡張データベースアクセストレースの内容が含まれます。
Cosminexus DABroker Libraryの［環境設定ユティリティ］またはCosminexus DABroker Library動作環境定義ファイルで設定された内容のイベントが出力されます。なお，すべてのイベントを出力しない設定にしている場合は，ヘッダだけが出力されます。なお，何か一つでもイベントを出力する設定にしている場合は，GET_DIAGイベントは必ず出力されます。

出力されるイベントを次に示します。

ATTACH：サーバとのアクセスパス作成要求を実行します。

ATTRGET：ハンドル属性の取得要求を実行します。

ATTRSET：ハンドル属性の設定要求を実行します。

AUTOCOMOFF：AUTO COMMITモードの解除要求を実行します。

AUTOCOMON：AUTO COMMITモードの設定要求を実行します。

BIND：パラメタのバインド要求を実行します。

CHARFORM：キャラクタセットフォームの取得要求を実行します。

CHARID：キャラクタセットIDの取得要求を実行します。

DEFINE：パラメタの定義要求を実行します。

DESALLOC：記述子の領域確保を実行します。

DESC_OUT：前処理したSQLの出力情報を返します。

DESC_IN ：前処理したSQLの入力情報を返します。

DESCANY：オブジェクトの記述要求を実行します。

DESFREE：記述子の領域解放を実行します。

DETACH：データベースアクセスパス削除要求を実行します。

ENVCREATE：環境作成要求を実行します。

ERRGET：エラー情報取得要求を実行します。

EXECDIRECT：SQLの前処理後の実行処理です。

GET_DIAG：エラー詳細情報の取得処理を実行します。

GETINFO：接続後の動作情報の取得要求を実行します。

GETPIECE：ピース情報の取得要求を実行します。

HDLALLOC：ハンドルの領域確保を実行します。

HDLFREE：ハンドルの領域解放を実行します。

LOBCLOSE：BFILEデータのクローズ要求を実行します。

LOBLEN：LOBデータの長さ取得要求を実行します。

LOBOPEN：BFILEデータのオープン要求を実行します。

LOBREAD：LOBデータの読み込み要求を実行します。

LOBWRITE：LOBデータの書き込み要求を実行します。

PARAMGET：パラメタ情報の取得要求を実行します。

SESBEGIN：セッション開始要求を実行します。

SESEND：セッション終了要求を実行します。

SETINFO：接続後の動作情報の設定要求を実行します。

SETPIECE：ピース情報の設定要求を実行します。

START-TIME
アクセス開始日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

END-TIME
アクセス終了日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

RETCODE
データベースから返されるリターンコードが出力されます。

BLOCKCNT
FETCH時の行取得件数が出力されます。

(Windows QueryPerformance Counter)
Windowsの場合に，高分解パフォーマンス情報が表示されます。

HiRDB_CONNECTION_ID
コネクションID（aaaa:bbbb:cccc）が出力されます。

aaaa：
フロントエンドサーバ名（HiRDB/Parallel Server使用時）またはシングルサーバ名（HiRDB/Single Server使用時）

bbbb：
aaaaで示すサーバの接続通番

cccc：
aaaaで示すサーバのプロセスID。
コネクションIDは，HiRDBクライアントのバージョンが07-01以降で，かつサーバがHiRDBである場合だけ出力されます。サーバがHiRDBで，かつHiRDBクライアントのバージョンが07-01よりも前の場合は，ヘッダ（HiRDB_CONNECTION_ID）だけが出力され，コネクションIDは出力されません。また，サーバがXDM/RD E2の場合は，ヘッダ（HiRDB_CONNECTION_ID）およびコネクションIDは出力されません。なお，この情報は，CONNECT，COMMIT，ROLLBACK，PREPARE，EXECUTE，DIRECTを実行したとき，最新の情報に更新されます。

(SQL)SS…SS
クライアントから要求のあったSQLの内容が出力されます。この項目は，必要に応じて出力されます。

注※

Cosminexus DABroker LibraryからOracle8i，Oracle9iおよびOracle10gの機能を使用する場合に出力されます。

(c)　ファイル名称規則

拡張データベースアクセストレースのファイルは，次のディレクトリに作成されます。

Windowsの場合
<Cosminexus DABroker Library運用ディレクトリ>¥spool¥db_access

UNIXの場合
<Cosminexus DABroker Library運用ディレクトリ>/spool/db_access

拡張データベースアクセストレースのファイル名称は，次の規則に従います。斜体は可変の情報です。

spdb_XXXXXXXX_YYYYYYYY_HHHHHHHHHHHHHHHH_<接続データベース名称>ZZZZZ.IIIIII

ファイル名称中の文字列について次に示します。

表5-56　拡張データベーストレースのファイル名称の規則

項目
意味

XXXXXXXX
実行プロセスIDが設定されます。

YYYYYYYY
データベース接続識別子が設定されます。

HHHHHHHHHHHHHHHH_
実行プロセスごとにユニークな接続識別子が設定されます。

＜接続データベース名称＞
接続データベース名称です。指定したデータベース種別によって，次のどれかが設定されます。

HiRDBの場合：HiRDB

Oracle8i接続の場合：ORACLE8i

Oracle7の場合：ORACLE7

ZZZZZ
識別順序番号が設定されます。
同じ実行プロセスIDで，かつ同じデータベース接続識別子のファイルがある場合に，00000から32767までの番号を付加します。

IIIIII
ファイル拡張子が設定されます。

log：最新のトレースファイル

logold：1世代前のトレースファイル

(3)　エラートレース

エラートレースは，ログファイルに出力されるCosminexus DABroker Libraryのエラー情報です。

エラートレースとして出力される情報を次に示します。

エラー事象を示す情報
エラーメッセージなどが出力されます。

データベース接続情報
データベース接続に関連する情報が出力されます。

履歴情報
エラーが発生する前に要求を受けた情報，前回コミットまたはロールバックが実行された時間，SQL文の実行要求処理中の実行中カーソルでの要求ごとの履歴情報などが出力されます。

(a)　エラー事象を示す情報

エラー事象を示す情報の出力形式および出力項目について説明します。

出力形式

エラー事象を示す情報のファイル出力形式を次に示します。斜体は可変の情報です。

YYYY/MM/DD hh:mm:ss.sss TID=AAAA SS..SS

エラー事象を示す情報の出力例を次に示します。

2004/05/07 13:30:09.555  TID=4040 KFPA11561-E Specified authorization identifier has no connect privilege

出力項目

エラー事象を示す情報の出力項目について，次の表に示します。

表5-57　エラートレースのエラー事象を示す情報の出力項目

項目
意味

YYYY/MM/DD hh:mm:ss.sss
エラー発生日時が出力されます。
YYYY：西暦年，MM：月，DD：日
hh：時，mm：分，ss：秒，sss：ミリ秒

AAAA
エラー発生スレッドID（16進数値）が出力されます。

SS...SS
エラーメッセージが出力されます。

(b)　データベース接続情報

データベース接続情報の出力形式および出力項目について説明します。

出力形式

エラートレースのデータベース接続情報のファイル出力形式を次に示します。斜体は可変の情報です。

YYYY/MM/DD hh:mm:ss.sss PID=BBBB InitID=CCCC ConID=DDDD CName=EEEE DBID=FFFF CID=GGGG(HHHH,IIII)

エラートレースのデータベース接続情報の出力例を次に示します。

2004/05/07 13:30:21.232 PID=1752 InitID=701 ConID=10701 CName=DABLIBAP DBID=1 CID=1(0,0)

出力項目

エラートレースのデータベース接続情報のファイル出力項目について，次の表に示します。

表5-58　エラートレースのデータベース接続情報の出力項目

項目
意味

YYYY/MM/DD hh:mm:ss.sss
データベース接続日時が出力されます。
YYYY：西暦年，MM：月，DD：日
hh：時，mm：分，ss：秒，sss：ミリ秒

BBBB
プロセスID（10進数値）が出力されます。

CCCC
DABroker Library接続ID（16進数値）が出力されます。

DDDD
データベース接続識別子（16進数値）が出力されます。

EEEE
J2EEアプリケーションの名称が出力されます。ただし，名称なしの場合は空白となります。

FFFF
データベースID（10進数値）が出力されます。
1：HiRDB
7：Oracle8i
8：Oracle9i

GGGG
実行中カーソルID（10進数値）が出力されます。

HHHH
保守用情報が出力されます。

IIII
保守用情報が出力されます。

(c)　履歴情報

履歴情報の出力形式および出力項目について説明します。

出力形式

エラートレースの履歴情報のファイル出力形式を次に示します。

ヘッダ「START-TIME EXEC-TIME TID COUNT REQ-CODE DATA」の下に，次に示す形式でトレース情報が出力されます。斜体は可変の情報です。

YYYY/MM/DD hh:mm:ss.sss mmmm:ss.sss JJJJJJJJ KKKKKKKK LLLL MMMM NNNNNNNN OOOOOOOO PP..PP

エラートレースの履歴情報の出力例を以下に示します。

START-TIME               EXEC-TIME    TID    COUNT  REQ-CODE  DATA
2004/05/07 15:37:16.733  0:00.030     1712        7 1022 NOW  00000000 00000001
2004/05/07 15:36:18.369  0:00.000     1712        6 1022 OLD  00000001 00000002
2004/05/07 15:35:59.191  0:00.281     1712        2 1021 PRE  00000000 00000002
INSERT INTO "HS
2004/05/07 15:36:18.369  0:00.000     1712        6 1022 EXE  00000001 00000002

出力項目

エラートレースの履歴情報のファイル出力項目について，次の表に示します。

表5-59　エラートレースの履歴情報の出力項目

項目
意味

YYYY/MM/DD hh:mm:ss.sss
要求開始日時が出力されます。
YYYY：西暦年，MM：月，DD：日
hh：時，mm：分，ss：秒，sss：ミリ秒

mmmm:ss.sss
要求実行時間が出力されます。
mmmm：分，ss：秒，sss：ミリ秒

JJJJJJJJ
要求元スレッドID（16進数値）が出力されます。

KKKKKKKK
コネクト要求からの累計要求カウント数（16進数値）が出力されます。FETの場合は，SQL文実行時のFETの要求回数0xFFFFFFFFを超えた場合は，0から循環します。

LLLL
要求コード（10進数値）要求コードの詳細は，「表5-60　要求コード・応答コード一覧」を参照してください。

MMMM
大きくわけて次の3種類に分類されます。

共通履歴情報
NOW：実行中の情報
OLD：一つ前の要求の情報

SQL文の実行要求時に指定されたカーソルの履歴情報
SPRE：SQL PREPARE処理
EXE：SQL EXECUTE処理
FET1：SQL FETCH処理初回
FET：SQL FETCH処理
CLS：SQL CLOSE処理

コミット/ロールバック情報
CMT：コミット処理
RBK：ロールバック処理

詳細は，「表5-61　各履歴種別によるDATA内容」を参照してください。

NNNNNNNN
情報1（16進数値）
詳細は，「表5-61　各履歴種別によるDATA内容」を参照してください。

OOOOOOOO
情報2（16進数値）
詳細は，「表5-61　各履歴種別によるDATA内容」を参照してください。

PP..PP
詳細情報（任意文字列）
詳細は，「表5-61　各履歴種別によるDATA内容」を参照してください。

データベース接続情報に出力される，要求コードおよび応答コードの一覧を次の表に示します。

表5-60　要求コード・応答コード一覧

要求コード・応答コード
（LLLL）
種別

1001
コネクション解放

1002
データベース接続

1003
データベース切り離し

1004
Commit

1005
Rollback

1006
表一覧取得準備

1007
表一覧取得

1008
表一覧取得後処理

1009
列一覧取得準備

1010
列一覧取得

1011
列一覧取得後処理

1012
索引一覧取得準備

1013
索引一覧取得

1014
索引一覧取得後処理

1015
表権限一覧取得準備

1016
表権限一覧取得

1017
表権限一覧取得後処理

1018
列権限一覧取得準備

1019
列権限一覧取得

1020
列権限一覧取得後処理

1021
SQL実行準備

1022
SQL実行

1023
SQL実行結果取得

1024
SQL実行後処理

1035
SQL実行結果取得オプション

1036
BLOBファイル削除

1037
プライマリキー一覧取得準備

1038
プライマリキー一覧取得

1039
プライマリキー一覧取得後処理

1040
BLOB,CLOBおよびBFILE分割取得

1041
自動Commit設定

1042
自動Commit解除

1050
XAトランザクション制御

1501
ストアドプロシジャ一覧取得準備

1502
ストアドプロシジャ一覧取得

1503
ストアドプロシジャ一覧取得後処理

1504
ストアドプロシジャ列一覧取得準備

1505
ストアドプロシジャ列一覧取得

1506
ストアドプロシジャ列一覧取得後処理

1507
ストアドプロシジャパラメタ定義情報取得

1508
ストアドプロシジャ実行準備

1509
ストアドプロシジャ実行

1510
ストアドプロシジャ拡張実行

2001
正常応答

2002
異常応答

データベース接続情報に出力される，各履歴種別によるDATA内容の一覧を次の表に示します。

表5-61　各履歴種別によるDATA内容

履歴種別(MMMM) | 情報１(NNNNNNN) | 情報２(OOOOOOO) | 詳細情報(PP..PP)
PRE | 検索カラム数 | ?パラメタ定義数 | SQLの先頭16バイト（マルチバイト文字コードの途中の場合はその文字は出力しません）
EXE | SQL実行件数※ | ?パラメタ指定数 | －
FET1 | 要求時検索件数 | 最大検索件数 | －
FET | 累計検索件数 | 要求時検索件数 | －
CLS | 0固定 | 0固定 | －
CMT | － | － | －
RBK | － | － | －
NOW | 今回の要求コードで取得した情報 | － | －
OLD | 前回の要求コードで取得した情報 | － | －

（凡例）

－：該当なし

注※

INSERT，UPDATE，DELETE実行時の件数

(4)　Exceptionトレースログ

Exceptionトレースログは，メソッド実行時に障害が発生した場合に障害要因を分析するためのトレース情報です。障害発生時の問題個所の切り分けをするときに有効です。メソッドの呼び出し情報，メソッドの戻り値の情報，および例外（Exception）の情報が，製品名称などが出力されたヘッダと合わせて出力されます。

Exceptionトレースログとして出力される情報を次に示します。

表5-62　 Exceptionトレースログとして出力される情報

情報の種類 | 内容
ヘッダ | 出力情報の通番
製品名称
メソッドの呼び出し情報 | ログの取得時間
スレッド識別情報
メソッドの呼び出し識別情報
クラス名，オブジェクトID，メソッド名
コネクションハンドル
セクションID（カーソルIDと同じことを表現しています）
メソッドの引数
メソッドの戻り情報 | ログの取得時間
スレッド識別情報
メソッドの戻り識別情報
クラス名，オブジェクトID，メソッド名
コネクションハンドル
セクションID（カーソルIDと同じことを表現しています）
メソッドの引数
Exceptionの情報 | ログの取得時間
スレッド識別情報
Exceptionのスタックトレース

Exceptionトレースログは，SQLException，BatchUpdateException，またはXAExceptionが発生したときに，環境変数に設定した設定情報を基に，Exceptionがthrowされる前にファイルに出力されます。Exceptionトレースを出力するメソッドと，ログ出力に関連する環境変数については，「5.4.1(4) Cosminexus DABroker Libraryのログの取得」を参照してください。

(a)　出力形式と出力項目

Exceptionトレースログの出力形式を，トレース取得レベル5の場合の出力例を基に説明します。

出力される内容について次の表で示します。項番は出力例中の番号と対応しています。

表5-63　 Exceptionトレースログの出力項目

項番 | 区分 | 表示 | 意味
1 | ヘッダ | [XXXX] | 出力情報の通番を示します。
2 | Cosminexus DABroker for Java , DABroker for Java Version 2 XX-XX-XX | Cosminexus DABroker Libraryのログであることを示します。
3 | 共通 | XXXX/XX/XX XX:XX:XX.XXX | ログの取得時間を示します。
4 | Thread[XXXX,XXXXX,XXXX]@XXXX | スレッド識別情報を示します。
5 | [JdbcDbpsvXXXX@XXXX.XXXX] | クラス名，オブジェクトID，メソッド名を示します。
6 | HANDLE(XXXX) | ConnectionHandleを示します。
7 | SID(XXX) | セクションID（カーソルIDと同じことを表現しています）を示します。
8 | メソッドの呼び出し情報 | [E] | メソッドの呼び出し識別情報を示します。
9 | XXXX=XXXX | メソッドの引数を示します。
10 | メソッドの戻り情報 | [R] | メソッドからの戻り識別情報を示します。
11 | Return=XXXX | メソッドの戻り値を示します。
12 | Exception情報 | JP.co.Hitachi.soft.DBPSV_Driver.XXXXException:XXXX | Exceptionのスタックトレースを表示します。

(b)　解析方法

ここでは，(a)で示した出力例を使用して，Exceptionトレースログの解析方法について説明します。

Exceptionトレースログは，次の手順で解析します。

解析するログの通番から，ログ情報を抜き出します。

ログ情報を，Thread識別情報で分類して，ログごとに分割します。

ログの取得時間によって，ログ情報を時系列に並べます。
手順1.～3.を実施すると，次のような表を作成できます。

時間
スレッド1
スレッド2
スレッド3
スレッド4

Thread[main,5,main]
@1259414
Thread[Thread-0,5,main]
@30090737
Thread[Thread-1,5,main]
@5462872
Thread[Thread-2,5,main]
@25253977

2004/07/06 23:07:09.129
JdbcDbpsvConnection
@82c01f.createStatement(1)
－
－
－

2004/07/06 23:07:09.160
JdbcDbpsvStatement
@1e4cbc4.execute
－
－
－

2004/07/06 23:07:14.285
JdbcDbpsvConnection
@82c01f.commit
－
－
－

2004/07/06 23:07:14.301
JdbcDbpsvConnection
@82c01f.prepareStatement(1)
－
－
－

2004/07/06 23:07:26.567
JdbcDbpsvConnection
@82c01f.commit
－
－
－

2004/07/06 23:07:26.567
JdbcDbpsvStatement
@1e4cbc4.executeQuery
－
－
－

2004/07/06 23:07:26.567
JdbcDbpsvStatement
@1e4cbc4.execute
－
－
－

2004/07/06 23:07:28.332
JdbcDbpsvResultSet
@3eca90.close
JdbcDbpsvConnection
@82c01f.prepareStatement(1)
－
－

2004/07/06 23:07:28.332
JdbcDbpsvConnection
@82c01f.commit
－
－
－

2004/07/06 23:07:28.348
－
－
JdbcDbpsvConnection
@82c01f.prepareStatement(1)
－

2004/07/06 23:07:30.332
－
－
－
JdbcDbpsvConnection
@82c01f.rollback

2004/07/06 23:07:42.098
－
－
－
JdbcDbpsvConnection
@82c01f.close

2004/07/06 23:07:42.535
－
－
SQLException発生
KFDJ00002-E Statement or Connection is closed.
－

（凡例）

－：該当しません。

Exceptionエラーの内容を確認します。
2004/07/06 23:07:42.535のスレッド３でSQLExceptionが発生しています。メッセージの内容から，この時点でStatementオブジェクト，またはConnectionオブジェクトがすでにクローズされていることによるエラーだとわかります。

時系列にオブジェクトの流れを確認します。
2004/07/06 23:07:09.129のスレッド１，2004/07/06 23:07:28.332のスレッド２，2004/07/06 23:07:28.348のスレッド３，2004/07/06 23:07:30.332のスレッド４のConnectionオブジェクトのオブジェクトIDが同じであることから，四つのスレッドが同一コネクションで処理されていることがわかります。

エラーの原因となっている個所を探します。
四つのスレッドが同一コネクションであることがわかったため，Statement.closeメソッド，またはConnection.closeメソッドを実行している個所を探します。この例の場合は，スレッド４が2004/07/06 23:07:42.098でConnection.closeメソッドを実行しています。
このことから，2004/07/06 23:07:42.535のスレッド３で発生したSQLExceptionの原因は，スレッド４が2004/07/06 23:07:42.098でConnection.closeメソッドを実行していたためであることが，わかります。

(c)　トレース取得レベルごとの出力例

トレース取得レベルごとの出力例を次に示します。

トレース取得レベル1の場合の出力例

[1] Cosminexus DABroker for Java , DABroker for Java Version 2 02-11-/D
2004/07/21 17:59:41.001 Thread[main,5,main]@2113601537 [E][JdbcDbpsvXADataSource@59920001.getXAConnection(1)]
                       HANDLE(0) : SID(0)
2004/07/21 17:59:41.020 Thread[main,5,main]@2113601537 [E][JdbcDbpsvXAConnection@8bf8002.getXAResource]
                       HANDLE(0) : SID(0)
2004/07/21 17:59:41.554 Thread[main,5,main]@2113601537 [R][JdbcDbpsvXAConnection@8bf8002.getXAResource]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAResource@33690002
2004/07/21 17:59:41.554 Thread[main,5,main]@2113601537 [R][JdbcDbpsvXADataSource@59920001.getXAConnection(1)]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAConnection@8bf8002
2004/07/21 17:59:41.557 Thread[main,5,main]@2113601537 [E][JdbcDbpsvXAConnection@8bf8002.getXAResource]
                       HANDLE(0) : SID(0)
2004/07/21 17:59:41.557 Thread[main,5,main]@2113601537 [R][JdbcDbpsvXAConnection@8bf8002.getXAResource]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAResource@33690002
2004/07/21 17:59:41.561 Thread[main,5,main]@2113601537 [E][JdbcDbpsvXAConnection@8bf8002.getConnection]
                       HANDLE(0) : SID(0)
2004/07/21 17:59:41.649 Thread[main,5,main]@2113601537 [R][JdbcDbpsvXAConnection@8bf8002.getConnection]
                       HANDLE(883163352) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvConnection@78688002
2004/07/21 17:59:41.649 Thread[main,5,main]@2113601537 [E][JdbcDbpsvConnection@78688002.prepareStatement(1)]
                       HANDLE(883163352) : SID(0)
                       sql=INSERT INTO TRC_ex VALUES(?)
2004/07/21 17:59:41.819 Thread[main,5,main]@2113601537 [R][JdbcDbpsvConnection@78688002.prepareStatement(1)]
                       HANDLE(883163352) : SID(1)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvPreparedStatement@d334002
2004/07/21 17:59:41.977 Thread[main,5,main]@2113601537 [E][JdbcDbpsvConnection@78688002.close]
                       HANDLE(883163352) : SID(0)
2004/07/21 17:59:42.886 Thread[main,5,main]@2113601537 [R][JdbcDbpsvConnection@78688002.close]
                       HANDLE(883163352) : SID(0)
2004/07/21 17:59:42.945 Thread[main,5,main]@2113601537 [E][JdbcDbpsvConnection@78688002.createStatement(1)]
                       HANDLE(883163352) : SID(0)
2004/07/21 17:59:42.946 Thread[main,5,main]@2113601537:JP.co.Hitachi.soft.DBPSV_Driver.SQLException:
KFDJ00006-E Connection is closed.[JdbcDbpsvConnection.createStatement(1)]
       at JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvConnection.createStatement(JdbcDbpsvConnection.java:529)
       at TRC_ex.main(TRC_ex.java:81)

トレース取得レベル2の場合の出力例

[1] Cosminexus DABroker for Java , DABroker for Java Version 2 02-11-/D
2004/07/21 19:00:56.992 Thread[main,5,main]@2113866091 [E][JdbcDbpsvXADataSource@5996096b.getXAConnection(1)]
                       HANDLE(0) : SID(0)
2004/07/21 19:00:57.012 Thread[main,5,main]@2113866091 [E][JdbcDbpsvXAConnection@8bb8968.getXAResource]
                       HANDLE(0) : SID(0)
2004/07/21 19:00:57.561 Thread[main,5,main]@2113866091 [R][JdbcDbpsvXAConnection@8bb8968.getXAResource]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAResource@336d0968
2004/07/21 19:00:57.561 Thread[main,5,main]@2113866091 [R][JdbcDbpsvXADataSource@5996096b.getXAConnection(1)]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAConnection@8bb8968
2004/07/21 19:00:57.565 Thread[main,5,main]@2113866091 [E][JdbcDbpsvXAConnection@8bb8968.getXAResource]
                       HANDLE(0) : SID(0)
2004/07/21 19:00:57.565 Thread[main,5,main]@2113866091 [R][JdbcDbpsvXAConnection@8bb8968.getXAResource]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAResource@336d0968
2004/07/21 19:00:57.569 Thread[main,5,main]@2113866091 [E][JdbcDbpsvXAConnection@8bb8968.getConnection]
                       HANDLE(0) : SID(0)
2004/07/21 19:00:57.660 Thread[main,5,main]@2113866091 [R][JdbcDbpsvXAConnection@8bb8968.getConnection]
                       HANDLE(883163368) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvConnection@7862c968
2004/07/21 19:00:57.660 Thread[main,5,main]@2113866091 [E][JdbcDbpsvConnection@7862c968.prepareStatement(1)]
                       HANDLE(883163368) : SID(0)
                       sql=INSERT INTO TRC_ex VALUES(?)
2004/07/21 19:00:57.779 Thread[main,5,main]@2113866091 [R][JdbcDbpsvConnection@7862c968.prepareStatement(1)]
                       HANDLE(883163368) : SID(1)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvPreparedStatement@d4dc968
2004/07/21 19:00:57.840 Thread[main,5,main]@2113866091 [E][JdbcDbpsvPreparedStatement@d4dc968.executeUpdate(1)]
                       HANDLE(883163368) : SID(1)
                       sql=INSERT INTO TRC_ex VALUES(?)
2004/07/21 19:00:57.854 Thread[main,5,main]@2113866091 [R][JdbcDbpsvPreparedStatement@d4dc968.executeUpdate(1)]
                       HANDLE(883163368) : SID(1)
                       Return=1
2004/07/21 19:00:57.854 Thread[main,5,main]@2113866091 [E][JdbcDbpsvConnection@7862c968.close]
                       HANDLE(883163368) : SID(0)
2004/07/21 19:00:57.886 Thread[main,5,main]@2113866091 [R][JdbcDbpsvConnection@7862c968.close]
                       HANDLE(883163368) : SID(0)
2004/07/21 19:00:57.916 Thread[main,5,main]@2113866091 [E][JdbcDbpsvConnection@7862c968.createStatement(1)]
                       HANDLE(883163368) : SID(0)
2004/07/21 19:00:57.917 Thread[main,5,main]@2113866091:JP.co.Hitachi.soft.DBPSV_Driver.SQLException: KFDJ00006-E Connection is closed.[JdbcDbpsvConnection.createStatement(1)]
       at JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvConnection.createStatement(JdbcDbpsvConnection.java:529)
       at TRC_ex.main(TRC_ex.java:81)

（凡例）

下線は，トレース取得レベル1ではトレースが出力されないメソッドの情報です。

トレースレベル3の場合の出力例

[1] Cosminexus DABroker for Java , DABroker for Java Version 2 02-11-/D
2004/07/21 19:01:28.755 Thread[main,5,main]@2113866075 [E][JdbcDbpsvXADataSource@5996095b.getXAConnection(1)]
                       HANDLE(0) : SID(0)
2004/07/21 19:01:28.774 Thread[main,5,main]@2113866075 [E][JdbcDbpsvXAConnection@8bb8958.getXAResource]
                       HANDLE(0) : SID(0)
2004/07/21 19:01:29.329 Thread[main,5,main]@2113866075 [R][JdbcDbpsvXAConnection@8bb8958.getXAResource]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAResource@336d0958
2004/07/21 19:01:29.329 Thread[main,5,main]@2113866075 [R][JdbcDbpsvXADataSource@5996095b.getXAConnection(1)]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAConnection@8bb8958
2004/07/21 19:01:29.332 Thread[main,5,main]@2113866075 [E][JdbcDbpsvXAConnection@8bb8958.getXAResource]
                       HANDLE(0) : SID(0)
2004/07/21 19:01:29.332 Thread[main,5,main]@2113866075 [R][JdbcDbpsvXAConnection@8bb8958.getXAResource]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAResource@336d0958
2004/07/21 19:01:29.333 Thread[main,5,main]@2113866075 [E][JdbcDbpsvXAResource@336d0958.start]
                       HANDLE(0) : SID(0)
                       xid=MyXid@5ffe4958
                       flags=0
2004/07/21 19:01:29.372 Thread[main,5,main]@2113866075 [R][JdbcDbpsvXAResource@336d0958.start]
                       HANDLE(0) : SID(0)
2004/07/21 19:01:29.389 Thread[main,5,main]@2113866075 [E][JdbcDbpsvXAConnection@8bb8958.getConnection]
                       HANDLE(0) : SID(0)
2004/07/21 19:01:29.477 Thread[main,5,main]@2113866075 [R][JdbcDbpsvXAConnection@8bb8958.getConnection]
                       HANDLE(883163368) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvConnection@78b60958
2004/07/21 19:01:29.478 Thread[main,5,main]@2113866075 [E][JdbcDbpsvConnection@78b60958.prepareStatement(1)]
                       HANDLE(883163368) : SID(0)
                       sql=INSERT INTO TRC_ex VALUES(?)
2004/07/21 19:01:29.571 Thread[main,5,main]@2113866075 [R][JdbcDbpsvConnection@78b60958.prepareStatement(1)]
                       HANDLE(883163368) : SID(1)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvPreparedStatement@13934958
2004/07/21 19:01:29.614 Thread[main,5,main]@2113866075 [E][JdbcDbpsvPreparedStatement@13934958.executeUpdate(1)]
                       HANDLE(883163368) : SID(1)
                       sql=INSERT INTO TRC_ex VALUES(?)
2004/07/21 19:01:29.624 Thread[main,5,main]@2113866075 [R][JdbcDbpsvPreparedStatement@13934958.executeUpdate(1)]
                       HANDLE(883163368) : SID(1)
                       Return=1
2004/07/21 19:01:29.624 Thread[main,5,main]@2113866075 [E][JdbcDbpsvConnection@78b60958.close]
                       HANDLE(883163368) : SID(0)
2004/07/21 19:01:29.656 Thread[main,5,main]@2113866075 [R][JdbcDbpsvConnection@78b60958.close]
                       HANDLE(883163368) : SID(0)
2004/07/21 19:01:29.656 Thread[main,5,main]@2113866075 [E][JdbcDbpsvXAResource@336d0958.end]
                       HANDLE(0) : SID(0)
                       xid=MyXid@5ffe4958
                       flags=67108864
2004/07/21 19:01:29.658 Thread[main,5,main]@2113866075 [R][JdbcDbpsvXAResource@336d0958.end]
                       HANDLE(0) : SID(0)
2004/07/21 19:01:29.659 Thread[main,5,main]@2113866075 [E][JdbcDbpsvXAResource@336d0958.prepare]
                       HANDLE(0) : SID(0)
                       xid=MyXid@5ffe4958
2004/07/21 19:01:29.675 Thread[main,5,main]@2113866075 [R][JdbcDbpsvXAResource@336d0958.prepare]
                       HANDLE(0) : SID(0)
                       Return=0
2004/07/21 19:01:29.675 Thread[main,5,main]@2113866075 [E][JdbcDbpsvXAResource@336d0958.commit]
                       HANDLE(0) : SID(0)
                       xid=MyXid@5ffe4958
                       onePhase=false
2004/07/21 19:01:29.681 Thread[main,5,main]@2113866075 [R][JdbcDbpsvXAResource@336d0958.commit]
                       HANDLE(0) : SID(0)
2004/07/21 19:01:29.681 Thread[main,5,main]@2113866075 [E][JdbcDbpsvConnection@78b60958.createStatement(1)]
                       HANDLE(883163368) : SID(0)
2004/07/21 19:01:29.682 Thread[main,5,main]@2113866075:JP.co.Hitachi.soft.DBPSV_Driver.SQLException: KFDJ00006-E Connection is closed.[JdbcDbpsvConnection.createStatement(1)]
        at JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvConnection.createStatement(JdbcDbpsvConnection.java:529)
        at TRC_ex.main(TRC_ex.java:81)

（凡例）

太字は，トレース取得レベル1ではトレースが出力されないメソッドの情報です。

下線は，トレース取得レベル2ではトレースが出力されないメソッドの情報です。

トレース取得レベル5の場合の出力例

[1] Cosminexus DABroker for Java , DABroker for Java Version 2 02-11-/D
2004/07/21 18:58:47.122 Thread[main,5,main]@2113866026 [E][JdbcDbpsvXADataSource@5996092a.getXAConnection(1)]
                       HANDLE(0) : SID(0)
2004/07/21 18:58:47.141 Thread[main,5,main]@2113866026 [E][JdbcDbpsvXAConnection@8bb8929.getXAResource]
                       HANDLE(0) : SID(0)
2004/07/21 18:58:47.705 Thread[main,5,main]@2113866026 [R][JdbcDbpsvXAConnection@8bb8929.getXAResource]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAResource@336d0929
2004/07/21 18:58:47.706 Thread[main,5,main]@2113866026 [R][JdbcDbpsvXADataSource@5996092a.getXAConnection(1)]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAConnection@8bb8929
2004/07/21 18:58:47.709 Thread[main,5,main]@2113866026 [E][JdbcDbpsvXAConnection@8bb8929.getXAResource]
                       HANDLE(0) : SID(0)
2004/07/21 18:58:47.709 Thread[main,5,main]@2113866026 [R][JdbcDbpsvXAConnection@8bb8929.getXAResource]
                       HANDLE(0) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvXAResource@336d0929
2004/07/21 18:58:47.710 Thread[main,5,main]@2113866026 [E][JdbcDbpsvXAResource@336d0929.start]
                       HANDLE(0) : SID(0)
                       xid=MyXid@5ffe4929
                       flags=0
2004/07/21 18:58:47.750 Thread[main,5,main]@2113866026 [R][JdbcDbpsvXAResource@336d0929.start]
                       HANDLE(0) : SID(0)
2004/07/21 18:58:47.770 Thread[main,5,main]@2113866026 [E][JdbcDbpsvXAConnection@8bb8929.getConnection]
                       HANDLE(0) : SID(0)
2004/07/21 18:58:47.858 Thread[main,5,main]@2113866026 [R][JdbcDbpsvXAConnection@8bb8929.getConnection]
                       HANDLE(883163368) : SID(0)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvConnection@78454929
2004/07/21 18:58:47.858 Thread[main,5,main]@2113866026 [E][JdbcDbpsvConnection@78454929.prepareStatement(1)]
                       HANDLE(883163368) : SID(0)
                       sql=INSERT INTO TRC_ex VALUES(?)
2004/07/21 18:58:47.952 Thread[main,5,main]@2113866026 [R][JdbcDbpsvConnection@78454929.prepareStatement(1)]
                       HANDLE(883163368) : SID(1)
                       Return=JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvPreparedStatement@d2ec929
2004/07/21 18:58:47.994 Thread[main,5,main]@2113866026 [E][JdbcDbpsvPreparedStatement@d2ec929.executeUpdate(1)]
                       HANDLE(883163368) : SID(1)
                       sql=INSERT INTO TRC_ex VALUES(?)
2004/07/21 18:58:47.994 Thread[main,5,main]@2113866026 [E][JdbcDbpsvPreparedStatement@d2ec929.execute(1)]
                       HANDLE(883163368) : SID(1)
                       sql=INSERT INTO TRC_ex VALUES(?)
2004/07/21 18:58:48.004 Thread[main,5,main]@2113866026 [R][JdbcDbpsvPreparedStatement@d2ec929.execute(1)]
                       HANDLE(883163368) : SID(1)
                       Return=false
2004/07/21 18:58:48.004 Thread[main,5,main]@2113866026 [R][JdbcDbpsvPreparedStatement@d2ec929.executeUpdate(1)]
                       HANDLE(883163368) : SID(1)
                       Return=1
2004/07/21 18:58:48.004 Thread[main,5,main]@2113866026 [E][JdbcDbpsvConnection@78454929.close]
                       HANDLE(883163368) : SID(0)
2004/07/21 18:58:48.037 Thread[main,5,main]@2113866026 [R][JdbcDbpsvConnection@78454929.close]
                       HANDLE(883163368) : SID(0)
2004/07/21 18:58:48.037 Thread[main,5,main]@2113866026 [E][JdbcDbpsvXAResource@336d0929.end]
                       HANDLE(0) : SID(0)
                       xid=MyXid@5ffe4929
                       flags=67108864
2004/07/21 18:58:48.039 Thread[main,5,main]@2113866026 [R][JdbcDbpsvXAResource@336d0929.end]
                       HANDLE(0) : SID(0)
2004/07/21 18:58:48.039 Thread[main,5,main]@2113866026 [E][JdbcDbpsvXAResource@336d0929.prepare]
                       HANDLE(0) : SID(0)
                       xid=MyXid@5ffe4929
2004/07/21 18:58:48.053 Thread[main,5,main]@2113866026 [R][JdbcDbpsvXAResource@336d0929.prepare]
                       HANDLE(0) : SID(0)
                       Return=0
2004/07/21 18:58:48.053 Thread[main,5,main]@2113866026 [E][JdbcDbpsvXAResource@336d0929.commit]
                       HANDLE(0) : SID(0)
                       xid=MyXid@5ffe4929
                       onePhase=false
2004/07/21 18:58:48.059 Thread[main,5,main]@2113866026 [R][JdbcDbpsvXAResource@336d0929.commit]
                       HANDLE(0) : SID(0)
2004/07/21 18:58:48.059 Thread[main,5,main]@2113866026 [E][JdbcDbpsvConnection@78454929.createStatement(1)]
                       HANDLE(883163368) : SID(0)
2004/07/21 18:58:48.060 Thread[main,5,main]@2113866026:JP.co.Hitachi.soft.DBPSV_Driver.SQLException: KFDJ00006-E Connection is closed.[JdbcDbpsvConnection.createStatement(1)]
       at JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvConnection.createStatement(JdbcDbpsvConnection.java:529)
       at TRC_ex.main(TRC_ex.java:81)

（凡例）

太字は，トレース取得レベル1ではトレースが出力されないメソッドの情報です。

下線は，トレース取得レベル2ではトレースが出力されないメソッドの情報です。

(5)　イベントトレース

イベントトレースは，DABroker for C++をインストールしている場合に出力されます。

DABroker for C++の機能を使ってデータベースにアクセスする場合のイベントトレースが出力されます。イベントトレースは，次のファイルに取得されます。

Windowsの場合
<Cosminexus DABroker Library運用ディレクトリ>¥spool¥dabevttrccpp1

UNIXの場合
<Cosminexus DABroker Library運用ディレクトリ>/spool/dabevttrccpp1

なお，イベントトレースファイルが満杯になった場合，ラップアラウンドでトレースが出力されます。この場合は，バックアップファイル（dabevttrccpp2）が作成され，1世代だけ（dabevttrccpp1）が管理されます。

取得するイベントトレースの設定については，マニュアル「Cosminexus　システム構築ガイド」のCosminexus DABroker Libraryの動作環境の設定に関する説明を参照してください。

(a)　出力形式

イベントトレースの出力形式について説明します。

ヘッダ「LEVEL VPID PID TID DATE TIME EVENT」の下に，次に示す形式でトレース情報が出力されます。

レベル 仮想プロセスID プロセスID スレッドID 日付 時刻 動作結果

イベントトレースの出力例を次に示します。

LEVEL    VPID     PID  TID  DATE       TIME            EVENT
40000010 00120000 711a 0001 2004/06/01 11:38:29.300000 イベント1
40000010 00120000 711a 0002 2004/06/01 11:38:30.100000 イベント2
40000010 00120000 711b 0001 2004/06/01 11:38:30.150000 イベント3
40000010 00120000 711b 0002 2004/06/01 11:38:30.250000 イベント4

(b)　出力項目

イベントトレースの出力項目について，次の表に示します。

表5-64　 Cosminexus DABroker Libraryのイベントトレースの出力項目

ヘッダ | 項目 | 説明
LEVEL | レベル | トレースに出力したレベルが出力されます。
VPID | 仮想プロセスID | 仮想プロセスIDが出力されます。
PID | プロセスID | プロセスIDが出力されます。
TID | スレッドID | スレッドIDが出力されます。
DATE | 日付 | 取得した日付が出力されます。
TIME | 時刻 | 取得した時刻が出力されます。
EVENT | 動作結果 | 実行時の動作結果のログが出力されます。

(6)　XAトレースの取得形式

XAインタフェースでのトラブルシュート情報は，XAトレースファイルとして次のファイルに出力されます。

Windowsの場合
<Cosminexus DABroker Library運用ディレクトリ>¥spool¥db_xainfo.log

UNIXの場合
<Cosminexus DABroker Library運用ディレクトリ>/spool/db_xainfo.log

(a)　出力形式

XAトレースファイルの出力形式を次に示します。斜体は可変の情報です。

日付 時刻 プロセスID:スレッドID イベント種別:XA関数名 rmid=rrrr flags=ffff RMName="nnnn" xa_info="iiii" xid=[ffff:gggg:bbbb:dddd] count=cccc return code=rrrr

XAトレースファイルの出力例を次に示します。

(b)　出力項目

XAトレースファイルの出力項目について，次の表に示します。

表5-65　Cosminexus DABroker LibraryのXAトレースの出力項目

項目名
説明

日付
出力した年月日（YYYY/MM/DD）が出力されます。

YYYY：西暦年，MM：月，DD：日

時刻
出力した時刻（hh:mm:ss:nnnnnn）が表示されます。

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

[プロセスID：スレッドID]
プロセスIDとスレッドIDが出力されます。

[イベント種別：XA関数名]
イベント種別と，XA関数の名前が出力されます。

イベント種別
次のどちらかが出力されます。
"call"：関数呼び出しであることを示します。
"end"：関数リターンであることを示します。

XA関数名
XA関数名が出力されます。

rmid=rrrr
RMIDが出力されます。

flags=ffff
フラグパラメタが出力されます。

RMName="nnnn"
RM名称が出力されます。

xa_info="iii "
XA文字列が出力されます。
この項目は，XA関数が，xa_open()，またはxa_close()の場合だけ，出力されます。

xid=[ffff:gggg:bbbb:dddd]
XIDが出力されます。
この項目は，XA関数が，xa_open()，またはxa_close()以外の場合だけ，出力されます。
ffff：フォーマットIDが出力されます。
gggg：グローバルトランザクションID長が出力されます。
bbbb：ブランチ修飾子長が出力されます。
dddd：XIDデータが出力されます。

count=cccc
リカバリ情報取得カウントが出力されます。
この項目は，XA関数がxa_recover()の場合だけ，出力されます。

return code = rrrr
XA関数の戻り値が出力されます。
この項目は，イベント種別が"end"の場合だけ出力されます。

(7)　JDBCドライバのトレース（JDBCインタフェースメソッドトレース）

J2EEアプリケーションまたはバッチアプリケーション開発時に，Cosminexus DABroker LibraryのAPIを使用して，JDBCドライバのトレースを出力するように設定できます。

ここでは，JDBCドライバのトレースのうち，JDBCインタフェースメソッドのトレースについて説明します。

(a)　出力形式

JDBCインタフェースメソッドのトレースの出力形式を次に示します。斜体は可変の情報です。

[DABroker for Java Version 2] [JDBC Interface メソッド状態][JdbcDbpsvクラス名.メソッド名] 引数または戻り値=値

JDBCインタフェースメソッドのトレースの出力例を次の図に示します。

(b)　出力項目

JDBCインタフェースメソッドのトレースの出力項目について，次の表に示します。

表5-66　 JDBCインタフェースメソッドのトレースの出力項目

項目
説明

[DABroker for Java Version 2]
Cosminexus DABroker Libraryのトレースであることを示します。

[JDBC Interface メソッド状態]
使用したJDBCインタフェースメソッドの状態を示します。
Entry：メソッドの呼び出し
Return：メソッドの戻り

[JdbcDbpsvクラス名. メソッド名]
使用したJDBCインタフェースメソッドの「クラス名.メソッド名」を示します。

引数または戻り値=値
該当する「クラス名.メソッド名」の引数の値，または戻り値が出力されます。
引数の場合，引数名=値の形式で出力されます。
戻り値の場合，Return=値の形式で出力されます。

(8)　JDBCドライバのトレース（Cosminexus DABroker Libraryとのイベントトレース）

J2EEアプリケーションまたはバッチアプリケーション開発時に，Cosminexus DABroker LibraryのAPIを使用して，JDBCドライバのトレースを出力するように設定できます。

ここでは，JDBCドライバとCosminexus DABroker Libraryとのイベントトレースについて説明します。

(a)　出力形式

Cosminexus DABroker Libraryとのイベントトレースの出力形式を次に示します。

[DABroker for Java Version 2] [Server Event イベント] 送信データ種別

Cosminexus DABroker Libraryとのイベントトレースの出力例を次に示します。

(b)　出力項目

Cosminexus DABroker Libraryとのイベントトレースの出力項目について，次の表に示します。

表5-67　DABrokerとのイベントトレースの出力項目

項目
説明

[DABroker for Java Version 2]
Cosminexus DABroker Libraryのトレースであることを示します。

[Server Event イベント]
Cosminexus DABroker Libraryでのイベントを示します。

送信データ種別
送受信データ種別が，aa…aa <bb…bb>（cc…cc,dd…dd）SIZE：XXXの形式で出力されます

aa…aa
オペレーション種別が出力されます。
表示されるオペレーション種別とその意味は次のとおりです。

Disconnect(Connection)：Cosminexus DABroker Libraryとのコネクション解放要求

Connect(Database)：データベースとの接続要求

Disconnect(Database)：データベースとの接続解放要求

Commit：トランザクションのコミット要求

Rollback：トランザクションのロールバック要求

LIST(Table)：表一覧取得要求

LIST(Column)：列一覧取得要求

LIST(Index)：索引一覧取得要求

LIST(TablePrivileges)：表権限一覧取得要求

LIST(ColumnPrivileges)：列権限一覧取得要求

LIST(Procedure)：プロシジャ一覧取得要求

LIST(ProcedureColumn)：プロシジャ列一覧取得要求

EXT-CMD：SQLの実行要求

EXE(Procedure)：プロシジャの実行要求

Cancel：非同期キャンセル要求

Result：正常応答

Error：エラー応答

Result(Cancel)：正常応答（非同期キャンセル）

Error(Cancel)：エラー応答（非同期キャンセル）

XA：CALL：XAオペレーションの実行

XA：AUTOCOMMIT<ON>：XALocalCommitMode（true）の実行

XA：AUTOCOMMIT<OFF>：XALocalCommitMode（false）の実行

bb…bb
付加情報が出力されます。
オペレーション種別が，LIST（xxxxx）およびEXT-CMDの場合に表示されます。

cc…cc
リターンコードが出力されます。

dd…dd
詳細コードが出力されます。

XXX
Cosminexus DABroker LibraryでのイベントがPutの場合は，送信したデータのサイズが出力されます。
Cosminexus DABroker LibraryでのイベントがGetの場合は，受け取ったデータのサイズが出力されます。

5.5.4　性能解析トレースの調査

性能解析トレースを調査することで，リクエストごとに処理進ちょくやボトルネックになっている処理を解析できます。また，セッショントレースを調査すると，セッションのライフサイクルが確認できます。

これらを基にして，トラブルが発生した個所を特定したり，ボトルネックになっている個所に適切に対処したりできます。必要に応じて確認してください。

性能解析トレースの出力内容については，「3.　システムの処理性能の解析」を参照してください。

5.5.5　JavaVMのスレッドダンプの調査

JavaVMのスレッドダンプを調査すると，システムのデッドロックなどのjavaプログラムレベルでのトラブル要因の調査が容易になります。

出力される情報の種類は，J2EEサーバの起動時に指定しているオプションによって異なります。JavaVMの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

スレッドダンプ情報の構成を，次に示します。

表5-68　スレッドダンプ情報の構成

出力情報
内容

ヘッダ
日付，JavaVMバージョン情報，起動コマンドラインを出力します。

システム設定
次の情報を出力します。

JDKの実行環境のインストール場所を表すJavaホームパス

JDKを構成するライブラリのインストールディレクトリを表すJava DLLパス

システムクラスパス

Javaコマンドオプション

動作環境
次の情報を出力します。

ホスト名

OSバージョン

CPU情報

リソース情報（UNIXの場合）

メモリ情報（Windowsの場合）
現在のメモリ使用量および各未使用サイズ情報を出力します。

Javaヒープ情報
Javaヒープの各世代のメモリ使用状況を出力します。

JavaVM内部メモリマップ情報
JavaVM自身の確保しているメモリの領域情報を出力します。

JavaVM内部メモリサイズ情報
JavaVM自身の確保しているメモリのサイズ情報を出力します。

アプリケーション環境
次の情報を出力します。

シグナルハンドラ

環境変数

ライブラリ情報
ローディングされているライブラリの情報を出力します。

スレッド情報
<スレッド1>
:
<スレッドn>
スレッドごとにスレッド情報を出力します。

Javaモニタダンプ
Javaモニタオブジェクトの一覧を表示します。

Rawモニタダンプ
Java内部で使われるモニタ情報の一覧を出力します。Row monitorが使用された場合だけ出力されます。

フッタ
スレッドダンプが終了した時刻を表示します。

それぞれの出力内容の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

また，J2EEアプリケーションやバッチアプリケーションでスローダウンやハングアップが発生したときに，スレッドダンプと性能解析トレースを対応づけることで，問題が発生した個所を調査できます。

スレッドダンプと性能解析トレースファイルの対応づけには，スレッドダンプに出力されたスレッド情報のnativeID（OSレベルのスレッドID）と性能解析トレースファイルに出力されたスレッドIDを使用します。スレッドダンプから対応する性能解析トレースファイルを特定する手順について説明します。

スレッドダンプ，および性能解析トレースファイルを収集します。
スレッドダンプの収集方法については，「5.4.5　JavaVMのスレッドダンプの取得」を参照してください。性能解析トレースファイルの収集方法については，「3.2.1　性能解析トレースファイルの収集方法」を参照してください。

使用するスレッドダンプ，および性能解析トレースファイルを選びます。
スレッドダンプと性能解析トレースファイルが出力された時刻を基に，調査に使用するスレッドダンプ，および性能解析トレースファイルを選びます。出力された時刻は，次の情報を参考にしてください。

スレッドダンプ

ファイル名，およびファイルの末尾に出力される時刻

ファイルの末尾に出力される時刻の例を次に示します。

　：
　：
Full thread dump completed.   Fri Jul 21 19:22:47 2006

性能解析トレースファイル

「Time」および「Time(msec/usec/nsec)」

性能解析トレースファイルの「Time」および「Time(msec/usec/nsec)」を次の図に示します。

スレッドダンプの「nid」（16進数）を10進数に変換します。

　：
　：
"VBJ ThreadPool Worker" daemon prio=5 jid=0x00054f93 tid=0x04cef380 nid=0x1124 in Object.wait() [0x0632f000..0x0632fd18]
 stack=[0x06330000..0x062f5000..0x062f1000..0x062f0000]
 [user cpu time=0ms, kernel cpu time=15ms] [blocked count=1, waited count=29]
at java.lang.Object.wait(Native Method)
　：
　：

1124（16進数）＝4388（10進数）

性能解析トレースファイルの「Thread（hashcode）」のスレッドID（10進数）が手順3.で10進数に変換した「nid」と一致する行を探して，トレース情報を特定します。

5.5.6　JavaVMのガーベージコレクションログの調査

ガーベージコレクションのログは，日立JavaVMログファイルに出力されます。

詳細は，「5.5.7　日立JavaVM固有のログの調査（日立JavaVMログファイル）」を参照してください。

5.5.7　日立JavaVM固有のログの調査（日立JavaVMログファイル）

日立JavaVMログファイルは，日立が標準のJavaVMに追加した拡張オプションを使用して出力されます。このログを取得するためには，対象のJ2EEサーバを起動するときに必要なオプションを指定しておく必要があります。

＜この項の構成＞

(1)　日立JavaVMログファイルを出力するオプション

(2)　拡張verbosegc情報の取得

(1)　日立JavaVMログファイルを出力するオプション

日立JavaVMログファイルを出力するオプションを次に示します。

-XX:+HitachiOutOfMemoryStackTrace
OutOfMemoryError発生時にスタックトレースを出力するオプションです。なお，このオプションを指定した場合に同時に指定される，-XX:+HitachiOutOfMemorySizeおよび-XX:+HitachiOutOfMemoryCauseが指定された場合も，日立JavaVMログファイルが出力されます。

-XX:+HitachiVerboseGC
ガーベージコレクションが発生した時の拡張verbosegc情報を出力するオプションです。拡張verbosegc情報の取得については，「(2)　拡張verbosegc情報の取得」を参照してください。

-XX:+HitachiJavaClassLibTrace
System.gc()，System.exit()，Runtime.exit()，またはRuntime.halt()のどれかのAPIを実行したときに，これらのAPIの呼び出しトレースを出力するオプションです。
なお，-XX:HitachiJavaClassLibTraceLineSizeオプションを指定している場合，出力されるトレースは，指定した文字数（バイト数）以内で出力されます。1行の文字数が指定した値を超える場合は，「at」以降の文字列の前半部分が削除されて，指定した文字数分出力されます。

それぞれのオプションを指定した場合の出力内容の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　拡張verbosegc情報の取得

J2EEサーバのusrconf.cfgファイルに，次の表に示すオプションを指定すると，拡張verbosegc情報を取得できます。拡張verbosegc情報からは，そのサーバで必要とするJavaヒープ領域サイズ，Perm領域サイズなどを見積もるための情報が取得できます。なお，Javaログには，OutOfMemoryError発生時のスタックトレースも出力されます。

表5-69　拡張verbosegc情報の取得を指定するオプション

オプション
意味

-XX:+HitachiVerboseGC
拡張verbosegc情報を出力するかどうかを指定します。ガーベージコレクションの内部領域であるEden，Survivor，Tenured，Perm種別ごとに情報を出力します。デフォルトでは出力されません。-XX:+HitachiVerboseGCと指定すると拡張verbosegc情報が出力され，-XX:-HitachiVerboseGCと指定すると拡張verbosegc情報は出力されません。

-XX:+HitachiVerboseGCPrintDate
拡張verbosegc情報を出力するログの各行の先頭に，ログを出力した日付を表示するかどうかを指定します。

-XX:+HitachiVerboseGCCpuTime
ガーベージコレクションの開始から終了までの間で，ガーベージコレクションの実行スレッドのユーザモードおよびカーネルモードに費やされた時間だけを表示するか，ガーベージコレクションの開始から終了までの実時間を表示するかを指定します。
ただし，HP-UXを使用している場合，この機能は使用できません。オプションを指定しても無効になります。

-XX:HitachiVerboseGCIntervalTime=<時間間隔>
-XX:+HitachiVerboseGCに対する出力時間の間隔を数値（単位：秒）で指定します。時間間隔のデフォルト値は0（ガーベージコレクション発生のたびに出力）です。なお，時間間隔を指定すると，その時間間隔の間に発生したガーベージコレクション回数も表示されます。

-XX:+HitachiVerboseGCPrintCause
拡張verbosegc情報を出力するログに，ガーベージコレクションが発生した原因を表示するかどうかを指定します。

-XX:+HitachiCommaVerboseGC
拡張verbosegc情報を出力するログをCSV形式で出力するかどうかを指定します。CSV形式で出力する場合，拡張verbosegc情報の括弧「( )」「[ ]」「< >」や，区切り「:」はすべて省略され，数値または文字列が「,」で区切られて出力されます。

ログファイルの出力形式と出力例を次に示します。

出力形式

[id]<date>(Skip Full:full_count, Copy:copy_count)[gc_kind gc_info, gc_time secs][DefNew::Eden: eden_info][DefNew::Survivor: survivor_info][Tenured: tenured_info][Perm: perm_info][cause:cause_info][User: user_cpu secs][Sys: system_cpu secs]

説明

id：日立JavaVMログファイル識別子

date：日時

full_count：Full GCをスキップした回数（-XX:HitachiVerboseGCIntervalTime指定した場合だけ）

copy_count ：Copy GCをスキップした回数（-XX:HitachiVerboseGCIntervalTime指定した場合だけ）

gc_kind：ガーベージコレクション種別（Full GCまたはGC）

gc_info：ガーベージコレクション情報（ガーベージコレクション前の領域長 -> ガーベージコレクション後の領域長(領域サイズ)）
(例)　264K->0K(512K)

gc_time：ガーベージコレクション経過時間（単位：秒）

eden_info：Eden情報

survivor_info：Survivor情報

tenured_info：Tenured情報

perm_info：Perm情報

cause_info：ガーベージコレクションの原因

user_cpu secs：ガーベージコレクションスレッドがユーザモードに費やしたCPU時間（単位：秒）

system_cpu secs：ガーベージコレクションスレッドがカーネルモードに費やしたCPU時間（単位：秒）

出力例

[VGC]<Thu Apr 24 19:24:48 2003>(Skip Full:3,Copy:8)[GC 20641K->4505K(260224K), 0.0108370 secs][DefNew::Eden: 16255K->0K(16256K)][DefNew::Survivor: 351K->471K(1984K)][Tenured: 4033K->4033K(241984K)][Perm: 12071K->12071K(12288K)]
[VGC]<Thu Apr 24 19:35:43 2003>(Skip Full:0,Copy:10)[GC 20550K->4414K(260224K), 0.0086975 secs][DefNew::Eden: 16255K->0K(16256K)][DefNew::Survivor: 260K->381K(1984K)][Tenured: 4033K->4033K(241984K)][Perm: 12071K->12071K(12288K)][cause:System.gc][User: 0.0156250 secs][Sys: 0.0312500 secs]

5.5.8　JavaVMが出力するメッセージログの調査（標準出力およびエラーリポートファイル）

JavaVMでクラッシュが発生した場合，JavaVMによってデバッグ情報が標準出力とエラーリポートファイルに出力されます。

エラーリポートファイルに出力されるのは，次の場合です。

JNIの中でのシグナルが発生したとき

JavaVMでCヒープ不足が発生したとき

JavaVMで予期しないシグナルが発生したとき

JavaVMでInternal Error（内部論理エラー）が発生したとき

ここでは，次の場合のメッセージログの出力内容について説明します。

表5-70　 JavaVMが出力するメッセージログ

メッセージの種類
出力先

JNIの中でのシグナルが発生した場合，またはJavaVMでのメッセージ※
標準出力
エラーリポートファイル

Cヒープが不足した場合のメッセージ※
標準出力
エラーリポートファイル

Internal Errorが発生した場合のメッセージ※
標準出力
エラーリポートファイル

スレッド作成に失敗した場合のメッセージ※
標準出力

注※　日立のJavaVM独自の出力先または出力内容があります。

なお，スレッド作成に失敗した場合のメッセージは，標準出力だけに出力されます。

＜この項の構成＞

(1)　シグナルが発生した場合

(2)　Cヒープが不足した場合

(3)　Internal Errorが発生した場合

(4)　スレッド作成に失敗した場合

(1)　シグナルが発生した場合

シグナルが発生した場合，次に示す項目がログ出力されます。出力内容には，日立のJavaVMとして拡張された内容が含まれます。

異常終了位置とシグナル種別※

カレントスレッド情報

シグナル情報の格納先アドレス※

シグナル情報

siginfo情報※（UNIXの場合）

レジスタ情報

スタックの先頭から格納されている情報

命令コード情報

スタックトレース

スレッド情報

VMの状態

メモリ情報※

Javaヒープの使用状況※

ライブラリ

コマンドおよびVMパラメタ※

環境変数

登録済みシグナルハンドラ

マシン情報※

システム名，CPU，実メモリ，およびVM情報

時間情報※

javatrace起動コマンドのコマンドライン※（UNIXの場合）

注※　日立で拡張された出力内容です。

それぞれの出力内容について説明します。

(a)　異常終了とシグナル種別

異常終了時の状態に応じて，次のどちらかの内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

シグナルを検出した場合

#
# An unexpected error has been detected by HotSpot Virtual Machine:
#
#  <発生したシグナル名>　(<シグナル番号>) at pc=<PCアドレス>, pid=<プロセスID>, tid=<スレッドID>
#
# Java VM: Java HotSpot(TM) Server VM (1.5.0_05-b05-CDK0700-20051129 mixed mode)
# Problematic frame:
# <種別コード>  [<シグナルが発生したライブラリ名>＋<オフセット>]
#

注　シグナルが発生した関数名が取り出せた場合，「<シグナルが発生したライブラリ名>＋<オフセット>」に続いて，その関数名とオフセットが表示されることがあります。

内部論理エラーが発生した場合

#
# An unexpected error has been detected by HotSpot Virtual Machine:
#
#  Internal Error (5448524541440E4350500D8F), pid=<プロセスID>, tid=<スレッドID>
#
# Java VM: Java HotSpot(TM) Server VM (1.5.0_05-b05-CDK0700-20051129 mixed mode)
#
# Error: 内部論理エラーメッセージ

(b)　カレントスレッド情報

次のどちらかの内容が出力されます。

Current thread (<アドレス>):  <スレッド名> "<スレッド名称>" [_<状態>, id=<スレッドID>]

Current thread (<アドレス>):  <スレッド名> [_id=<スレッドID>]

(c)　シグナル情報の格納先アドレス

次の内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

siginfo address: <アドレス>, context address: <アドレス>

(d)　シグナル情報

次の内容が出力されます。

Windowsの場合

EXCEPTION_ACCESS_VIOLATION(読み込み違反)

siginfo: ExceptionCode=<シグナル番号>, reading address <アドレス>

EXCEPTION_ACCESS_VIOLATION(書き込み違反)

siginfo: ExceptionCode=<シグナル番号>, writing address <アドレス>

EXCEPTION_ACCESS_VIOLATION(その他)

siginfo: ExceptionCode=<シグナル番号>, ExceptionInformation=<付加情報>

EXCEPTION_ACCESS_VIOLATION以外

siginfo: ExceptionCode=<シグナル番号>, ExceptionInformation=<付加情報1> <付加情報2> ・・・

UNIXの場合

siginfo:si_signo=<シグナル番号>, si_errno=<番号>, si_code=<番号>, si_addr=<アドレス>

(e)　siginfo情報（UNIXの場合）

次の内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

siginfo structure dump (location: <siginfoのアドレス>)
<siginfoのアドレス> <siginfoのアドレス> <siginfoのアドレス> <siginfoのアドレス>
...
<siginfoのアドレス> <siginfoのアドレス> <siginfoのアドレス> <siginfoのアドレス>

注　<siginfoのアドレス>は16進数で出力されます。

(f)　レジスタ情報

次の内容が出力されます。ただし，内部論理エラーの場合は出力されません。

Registers:<レジスタ情報>
：

注　UNIXの場合，BSPレジスタの値がデバッガ（gdb）の値と異なって出力されます。これは，デバッガではBSPの指すバッキングストア領域の内容を出力しており，BSPの指す位置を修正しているためです。

(g)　スタックの先頭から格納されている情報

次の内容が出力されます。ただし，内部論理エラーの場合は出力されません。

Top of Stack: (sp=<スタックポインタのアドレス>)
<アドレス>:   <格納されている内容>
：

注　<格納されている内容>は16進数で出力されます。

(h)　命令コード情報

次の内容が出力されます。ただし，内部論理エラーの場合は出力されません。

Instructions: (pc=<プログラムカウンタのアドレス>)
<アドレス>:   <命令コード>
：

注　<命令コード>は16進数で出力されます。

(i)　スタックトレース

次の内容が出力されます。ただし，Current threadがJavaThread以外の場合は出力されません。

Java frames: (J=compiled Java code, j=interpreted, Vv=VM code)
<スタックトレース>
：

(j)　スレッド情報

次の内容が出力されます。

Java Threads: ( => current thread )
 <アドレス>　JavaThread “<スレッド名称>“　[<状態>, id=<スレッドID>]
　  ：
=><アドレス>　JavaThread “<スレッド名称>“
Other　Threads:
 <アドレス>　<スレッド名> [id=<スレッドID>]
　  ：

(k)　VMの状態

次の内容が出力されます。

VM state:<現在の状態>

VM Mutex/Monitor currently owned by a thread: <mutexs/moniter>

注　この情報に続いて，ロック情報が出力される場合があります。

(l)　メモリ情報

次の内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

Memory :
<メモリ確保関数>:address<開始アドレス> - <終了アドレス>(size:<サイズ>)
       ：

       Heap Size:<確保しているメモリサイズ>
       Alloc Size:<使用中のメモリサイズ>
       Free Size:<未使用のメモリサイズ>

<メモリ確保関数>は，mmap()またはmalloc()のどちらかです。アドレスは16進数で表示されます。

各種メモリサイズの単位はバイトです。

(m)　Javaヒープの使用状況

次の内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

Heap
<Javaヒープ情報>

(n)　ライブラリ

次の内容に続いて，ローディングされているライブラリの一覧が出力されます。

Dynamic libraries:
<ライブラリ>
：

(o)　コマンドおよびVMパラメタ

次の内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

Command : <コマンドライン>

Java Home Dir   : <JDK実行環境インストールディレクトリ>
Java DLL Dir    : <JDKのライブラリインストールディレクトリ>
Sys Classpath   : <システムクラスパス>
User Args       :
<コマンドオプション1>
<コマンドオプション2>
：

(p)　環境変数

次の内容が出力されます。

Environment Variables:
<環境変数=値>
：

(q)　登録済みシグナルハンドラ

次の内容が出力されます。

Signal Handlers:
<シグナル種別>：
[<シグナルハンドラアドレス>], sa_mask[0]=<シグナルマスク>, sa_flags=<特殊フラグ>
：
Changed Signal Handlers -
<シグナル種別>： [<シグナルハンドラアドレス>], sa_mask[0]=<シグナルマスク>, sa_flags=<特殊フラグ>
：

出力内容の意味は次のとおりです。

<シグナル種別>：/usr/include/sys/signal.hに定義されているシグナル名です。

<シグナルハンドラアドレス>：シグナルハンドラのアドレスが16進で出力された値です。「ライブラリ名＋オフセット」という形式で表示されることもあります。

<シグナルマスク>：sigaction()で取り出せる構造のsa_maskフィールド値が16進で出力された値です。

<特殊フラグ>：sigaction()で取り出せる構造のsa_flagsフィールド値が16進で出力された値です。

(r)　マシン情報

次の内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

Host: <ホスト名>:<IPアドレス>

注　<IPアドレス>には複数のIPアドレスが表示されることがあります。

(s)　システム名，CPU，実メモリ，およびVM情報

次の内容が出力されます。

Windowsの場合

OS: <OSバージョン>

CPU: <利用可能CPU数>,<CPU種別>

Memory: <実メモリ情報>

vm_info: <VM情報>

UNIXの場合

OS: <OSバージョン>

uname:<uname出力>
libc:<libcのバージョン番号>（出力されない場合があります）
rlimit:<リミット値>
load average:<ロードアベレージ>

CPU: <利用可能CPU数>,<CPU種別>

Memory: <実メモリ情報>

vm_info: <VM情報>

(t)　時間情報

次の内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

Local Time = <実行日付>

Elapsed Time = <実行時間>

実行日付には出力内容の例を次に示します。

例：「Wed Aug 25 14:55:04 2004」

(u)　javatrace起動コマンドのコマンドライン（UNIXの場合）

次の内容が出力されます。この内容は，日立のJavaVMで拡張された出力内容です。

# You can get further information from javatrace.log file generated
# by using javatrace command.
# usage: javatrace core-file-name loadmodule-name [out-file-name] [-l(library-name)...]
# Please use javatrace command as follows and submit a bug report
# to Hitachi with javatrace.log file:
#[<インストールディレクトリ>/jre/bin/javatrace <coreファイル>  <ロードモジュール>]

(2)　Cヒープが不足した場合

Cヒープが不足した場合，次の順序でメッセージ出力およびダンプ出力，またはcoreダンプの生成が実行されます。

Cヒープ不足を示すメッセージログが，エラーリポートファイルおよび標準出力に出力されます。

1.の実行中にメモリ不足が発生した場合，簡易メッセージが標準出力に出力されます。

Windowsの場合，ワトソンログが起動され，ダンプ出力が実行されます。UNIXの場合，簡易メッセージの出力処理中にさらにメモリ不足が発生したときに，メッセージおよびエラーログファイルの出力処理を中止して，coreダンプを生成します。

それぞれの出力形式を次に示します。

(a)　Cヒープ不足を示すメッセージログの出力内容

Cヒープ不足を示すメッセージログの出力形式を次に示します。この形式は，エラーリポートファイルと標準出力で共通です。

Windowsの場合

Exception in thread <ThreadName> java.lang.OutOfMemoryError:requested <n> bytes [ for <message>].

Memory Status
-------------
      Memory in use   :使用率%
      Physical memory :空きメモリサイズ /総メモリサイズ free
      Virtual memory  :空きメモリサイズ/総メモリサイズ free
      Paging file     :空き容量/総容量 free

Heap Status
-----------
<Javaヒープ情報>
-----------
Stack Trace
-----------
<スタックトレース>
Insufficient memory for malloc. JVM generates core file.
-----------

AIX，HP-UX，またはLinuxの場合

Exception in thread <ThreadName> java.lang.OutOfMemoryError: requested <n> bytes [for <message>].

Memory Status
-------------
 maximum size of data segment
     soft(current) limit :getrlimit(RLIMIT_DATA)で取得したソフトリミット値 kbytes (16進数)
     hard limit          :getrlimit(RLIMIT_DATA)で取得したハードリミット値 kbytes (16進数)
 current end of the heap :sbrk(0)によって取得した値
 JVM allocation size by malloc :JavaVMが割り当てたメモリサイズ kbytes (16進数)
 malloc information
     total space in arena            :mallinfo.arenaの値
     number of ordinary blocks       :mallinfo.ordblksの値
     number of small blocks          :mallinfo.smblksの値
     number of holding blocks        :mallinfo.hblksの値
     space in holding block headers  :mallinfo.hblkhdの値
     space in small blocks in use    :mallinfo.usmblksの値
     space in free small blocks      :mallinfo.fsmblksの値
     space in ordinary blocks in use :mallinfo.uordblksの値
     space in free ordinary blocks   :mallinfo.fordblksの値
     cost of enabling keep option    :mallinfo.keepcostの値

Heap Status
-----------
<Javaヒープ情報>
-----------
Stack Trace
-----------
<スタックトレース>
-----------

Solarisの場合

Exception in thread <ThreadName> java.lang.OutOfMemoryError: requested <n> bytes [for <message>].

Heap Status
-----------
<Javaヒープ情報>
-----------
Stack Trace
-----------
<スタックトレース>
-----------

このようなメッセージが出力された場合は，Cヒープを減らすなど，適切な対策をしてください。

出力項目について次に示します。

表5-71　 Cヒープが不足した場合のメッセージログの出力項目

出力項目
説明

ThreadName
Thread#getName()メソッドで取り出せるスレッド名称が出力されます。

n
メモリ確保要求サイズが出力されます。

message
保守員による調査に必要な内部メッセージが出力されます。出力されない場合もあります。

Javaヒープ情報
Javaヒープの使用状況が出力されます。

スタックトレース
メモリ不足の発生したスレッドがJava コードを実行しているスレッドである場合に，スタックトレースが出力されます。
コンパイル処理のようなJavaVMの内部処理を実行するスレッドでメモリ不足が発生した場合には出力されません。

(b)　メモリ不足を示すメッセージの出力内容

Cヒープ不足を示すメッセージログが出力されている間にさらにメモリ不足が発生した場合は，処理の続行ができません。この場合は，次の形式の簡易メッセージが標準出力に出力されます。

java.lang.OutOfMemoryError:requested <n> bytes for <message>

出力項目について次に示します。

表5-72　メモリ不足が発生した場合の簡易メッセージの出力項目

出力項目 | 説明
n | メモリ確保要求サイズが出力されます。
message | 保守員による調査に必要な内部メッセージが出力されます。

(c)　ワトソンログが正しく出力されたかどうかを示すメッセージの出力内容（Windowsの場合）

簡易メッセージの出力後は，ワトソンログが起動され，ダンプ出力が実行されます。ただし，ワトソンログが正常に出力できない場合がありますので，標準出力に出力される処理結果のメッセージを確認してください。

次のメッセージは，ワトソンログの起動に失敗した場合に出力されます。

WatosonLog process generated.But couldn't generate dump file,because of resource shortage.

次のメッセージは，ワトソンログの起動後，ダンプ出力に失敗した場合に出力されます。

Couldn't generate dump file,because of resource shortage.

これらの処理に成功した場合は，次に示すメッセージが出力されます。ただし，この場合もワトソンログが正常にダンプ出力しない場合があります。このメッセージが出力された場合も，実際にダンプが出力されているかどうかを確認してください。

Although Dr.Watson process finished successfully,dump file isn't always generated.
Check your directory where dump file is stored.

(d)　coreダンプの生成を示すメッセージの出力内容

簡易メッセージの出力処理中にさらにメモリ不足が発生した場合，メッセージおよびエラーログファイルの出力処理を中止して，coreダンプを生成します。coreダンプが生成されると，次の形式のメッセージが標準出力に出力されます。

Can't create logs because of memory shortage.
Insufficient memory for malloc. JVM generates core file

(3)　Internal Errorが発生した場合

JavaVM内部の論理エラーであるInternal Errorが発生した場合，次の情報が出力されます。

異常終了位置とシグナル種別

カレントスレッド情報

シグナル情報の格納先アドレス※

スレッド情報

VMの状態

メモリ情報※

ヒープ情報※

ライブラリ

コマンド・VMパラメタ※

環境変数

登録済みシグナルハンドラ

マシン情報※

システム名，CPU，実メモリ，およびVM情報

時間情報

javatrace起動コマンドのコマンドライン※（UNIXの場合）

注※　日立で拡張された出力内容です。

それぞれの情報の出力形式については，「（1）シグナルが発生した場合」を参照してください。

(4)　スレッド作成に失敗した場合

メモリ不足（OutOfMemoryError）などが発生して新しくスレッドを作成できなかった場合，その時点でのスレッド数が，標準出力に出力されます。ここには，作成に失敗したスレッド数も含まれます。

メモリ不足などによってスレッドの作成に失敗した場合の出力例を次に示します。

java.lang.OutOfMemoryError:unable to create new native thread.1200 threads exist.
…

JavaVM起動時にスレッド作成に失敗した場合の出力例を次に示します。

Error occurred during initialization of VM
Could not create thread for VM:VM Thread.5 threads exist.

5.5.9　OSの状態情報およびOSのログの調査

取得したOSの状態・ログ情報で異常な傾向の有無を確認します。具体的な資料の見方についてはOS付属のマニュアルなどを参照してください。

5.5.10　スタックトレースの調査

ここでは，スタックトレースに出力される情報のうち，日立のJavaVMで拡張された内容について説明します。

サーバやアプリケーションでトラブルが発生した場合，トラブル発生までのスタックトレースの内容を確認することで，トラブル発生の要因を調査できます。

スタックトレースは，次のどれかのタイミングで出力されます。

J2EEサーバまたはJ2EEアプリケーションで例外が発生した場合

バッチサーバまたはバッチアプリケーションで例外が発生した場合

JavaVMのスレッドダンプが出力された場合

日立のJavaVMでは，サーバを起動するときのオプションの指定によって，スタックトレースにJavaメソッドのローカル変数についての情報を出力できます。例外発生時にJavaメソッドに定義されていたローカル変数の情報は，トラブルの要因を分析するために有効です。

なお，ここで対象にするローカル変数とは，メソッドに渡される引数およびインスタンスメソッドでの呼び出しの対象になるオブジェクト（this）のことです。ローカル変数情報には，これらのローカル変数の変数名，型名，およびローカル変数の値が出力されます。なお，型名は，基本形名，クラス名（インタフェース名を含みます）または配列形名のことです。

スタックトレースにローカル変数情報を出力するためのオプションを，次の表に示します。JavaVMの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

表5-73　スタックトレースにローカル変数情報を出力するためのオプション

起動オプション
スタックトレースを出力するタイミング
同時に指定できるオプション

-XX:+HitachiLocalsInThrowable
サーバまたはアプリケーション内で例外が発生したとき※

-XX:MaxJavaStackTraceDepth=<最大の深さ>

-XX:+HitachiLocalsSimpleFormat

-XX:+HitachiTrueTypeInLocals

-XX:HitachiCallToString=<適用範囲指定>

-XX:+HitachiLocalsInStackTrace
JavaVMのスレッドダンプを出力したとき

-XX:MaxJavaStackTraceDepth=<最大の深さ>

-XX:+HitachiLocalsSimpleFormat

-XX:+HitachiTrueTypeInLocals

注※　ただし，発生した例外が「java.lang.StackOverflowError」または「java.lang.OutOfMemoryError」の場合，スタックトレースにローカル変数は出力されません。

次に，それぞれのオプションを指定した場合に出力される内容について，例を基に説明します。それぞれのオプションを指定した時に出力される項目の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この項の構成＞

(1)　-XX:+HitachiLocalsInThrowableオプションが指定されている場合

(2)　-XX:+HitachiLocalsInStackTraceオプションが指定されている場合

(1)　-XX:+HitachiLocalsInThrowableオプションが指定されている場合

java.lang.Throwable.printStackTraceメソッドで出力されるスタックトレース情報の1スタックフレーム情報ごとに，そのスタックフレームに対応するメソッド内のローカル変数情報が挿入されて出力されます。

(a)　標準の形式および簡易出力フォーマットでの出力例

ローカル変数を出力するための機能として，-XX:+HitachiLocalsInThrowableオプションだけを指定している場合の出力例です。

Javaプログラムの例と，それに対するスタックトレース内のローカル変数情報の出力例を示します。

Javaプログラムの例1

class Example1 {
   public static void main(String[] args) {
       Example1 e1 = new Example1();
       Object obj = new Object();
       e1.method(1, 'Q', obj); // e1.methodメソッドを実行します（5行目）。
   }

   void method(int l1, char l2, Object l3) {
       float l4 = 4.0f;
       boolean l5 = true;
       double l6 = Double.MAX_VALUE;
       Object[] l7 = new Object[10];

       try {
         <例外発生!> // methodメソッドの処理内で例外が発生した場合の処理です（15行目）。
       } catch (Exception e) {
         e.printStackTrace(); // スタックトレース情報を出力します（17行目）。
       }
   }
}

出力例を次に示します。

この例は，Javaプログラムの例1の5行目で実行したe1.methodメソッドの処理内で例外が発生したときに，17行目のe.printStackTraceメソッドによって出力されるスタックトレース情報です。

図5-7　Javaプログラムの例1に対するローカル変数情報の出力例（-gオプションまたは-g:varsオプションを指定して作成されたclassファイルの場合）

出力内容について説明します。

スタックトレースを出力する処理を実行したメソッドの情報が出力されます。この例では，javaプログラム1の15行目で例外が発生したときのスタックトレース情報が出力されることを示しています。

ローカル変数情報として，インスタンスメソッドの呼び出しの対象になるオブジェクトについての情報が出力されます。この例の場合は，Javaプログラムの例1の3行目で作成したExample1クラスのオブジェクトのクラス名とアドレスが出力されます。

ローカル変数情報として，methodメソッドの引数として指定されたローカル変数の値についての情報が出力されます。変数名の後ろの[arg*]は，何番目のメソッド引数かを示す情報です。Javaプログラムの例1の5行目でe1.methodメソッドを実行したときに指定された値が出力されます。
なお，l1およびl2は基本型（int型およびchar型）の変数なので実際の値が出力されます。l3はjava.lang.Objectクラス型の変数なので，アドレスで出力されます。

ローカル変数情報として，methodメソッド内のローカル変数のうち，メソッド引数として指定した以外のローカル変数の値についての情報が出力されます。
なお，l4～l6は基本型（float型，boolean型およびdouble型）の変数なので実際の値が出力されます。l7はjava.lang.Objectクラス型の変数なので，アドレスで出力されます。

次に，-XX:+HitachiLocalsSimpleFormatオプションを指定した場合の，簡易出力フォーマットでの出力例を次に示します。なお，出力内容の説明は，標準の形式と同じです。

図5-8　-XX:+HitachiLocalsSimpleFormatオプションを指定した場合の出力例

また，javacコマンド実行時に，-gオプションまたは-g:varsオプションを指定しなかった場合，ローカル変数情報がないため，出力内容が次のように制限されます。これらは，nativeメソッドを実行した場合も同様です。

出力できるローカル変数が，メソッドに渡される引数とインスタンスメソッド呼び出し対象オブジェクト（this）だけになります。

メソッドに渡される引数は，変数名が出力されません。引数番号だけが出力されます。

nativeメソッドの場合，ローカル変数の値としてnativeメソッドを呼び出した時点での値が出力されます。nativeメソッドの実行結果を反映した出力結果にはなりません。

ローカル変数情報がない場合の，Javaプログラムの例1に対する出力例を次に示します。ここでは，簡易出力フォーマットでの出力例を示します。

図5-9　ローカル変数情報がない場合の出力例（簡易出力フォーマット）

図5-8に比べて，次の違いがあります。

メソッドに渡される引数（l1～l3）の変数名が出力されません。

メソッド呼び出し時点の値が出力されるため，メソッド内で設定されたローカル変数についての情報（l4～l7）が出力されません。

(b)　クラスまたは配列型の変数を文字列として出力する場合の出力例

出力するローカル変数がクラスまたは配列型の場合，アドレスだけの値表現ではトラブルシューティングに必要な情報が取得できない場合があります。このとき，-XX:HitachiCallToStringオプションの指定をしておくと，クラスまたは配列型の変数の値を文字列で取得できます。オプションには，適用範囲として，minimalまたはfullが指定できます。

-XX:HitachiCallToString=minimalオプションが指定されている場合は，java.langパッケージ内のクラスのうち，String，StringBuffer，Boolean，Byte，Character，Short，Integer，Long，Float，またはDoubleが対象になります。-XX:HitachiCallToString=fullオプションが指定されている場合は，すべてのクラスが対象になります。

次に，Javaプログラムの例と，-XX:HitachiCallToStringオプションが指定されている場合の出力例を示します。なお，ここでは簡易出力フォーマットで示します。

Javaプログラムの例2

class Example2 {
   public static void main(String[] args) {
       Example2 e2 = new Example2();
       e2.method();// e2.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);
       Object l6 = new Thread();
       Object[] l7 = new Thread[10];

       try {
         <例外発生!> // methodメソッドの処理内で例外が発生した場合の処理です（18行目）。
       } catch (Exception e) {
         e.printStackTrace(); // スタックトレース情報を出力します（20行目）。
       }
   }

   public String toString() {
       return "I am an Example2 instance.";
   }
}

-XX:HitachiCallToString=minimalオプションを指定した場合の出力例を次に示します。

この例は，Javaプログラムの例1の4行目で実行したe2.methodメソッドの処理内で例外が発生したときに，20行目のe.printStackTraceメソッドによって出力されるスタックトレース情報です。

図5-10　-XX:HitachiCallToString=minimalオプションを指定した場合の出力例（簡易出力フォーマット）

出力内容について説明します。

クラス型のローカル変数のうち，文字列を出力する適用対象のクラスの型のローカル変数情報です。アドレスに続いて，文字列に変換した値が出力されます。

クラス型のローカル変数のうち，文字列を出力する適用対象外のクラスの型のローカル変数情報です。アドレスだけが出力されます。

次に，-XX:HitachiCallToString=fullオプションを指定した場合の出力例を次に示します。

図5-11　-XX:HitachiCallToString=fullオプションを指定した場合の出力例（簡易出力フォーマット）

図5-10に比べて，次の違いがあります。

minimalを指定した場合に適用対象外のクラスだったjava.lang.Objectクラスおよびjava.lang.Objectクラスの配列のローカル変数（l6およびl7）に対しても，文字列が出力されます。

ただし，次の場合は，文字列は出力されないで，アドレスだけが出力されます。

ローカル変数の値がnullだった場合

文字列で出力するときに再度例外が発生して，正常に値が得られなかった場合

注意

ローカル変数情報で出力するオブジェクトは，ほかのスレッドで並行して操作していることがあります。このため，このオプションを指定して出力した文字列は，実際に例外が発生したときのオブジェクトに対応する情報とは異なっているおそれがあります。

(c)　クラスまたは配列型の変数の実際の型名を出力する場合の出力例

出力するローカル変数がクラスまたは配列型の場合，変数の型名と実際に代入されている値の型名が異なる場合があります。例えば，クラスの継承関係やインタフェースの実装関係によっては，異なる型名の値が変数に代入されます。

この場合に，-XX:+HitachiTrueTypeInLocalsオプションの指定によって，クラスまたは配列型の変数に実際に代入されている値の型名を追記して取得できます。

取得した文字列は，値表現の末尾に半角スペース1文字分が追記され，( )で囲まれて出力されます。このとき，出力文字列長に制限はありません。

次に，-XX:+HitachiTrueTypeInLocalsオプションが指定されている場合の出力例を示します。ここでは簡易出力フォーマットで示します。実行するプログラムは，Javaプログラムの例2です。また，この例は，-XX:HitachiCallToString=minimalオプションが指定されている場合の例です。

図5-12　-XX:+HitachiTrueTypeInLocalsオプションを指定した場合の出力例（簡易出力フォーマット）

出力内容について説明します。

変数の型名はjava.lang.Objectクラスまたはjava.lang.Objectクラスの配列ですが，実際に代入されている値の型名はjava.lang.Threadクラスおよびjava.lang.Threadクラスの配列であることが出力されています。

なお，-XX:+HitachiTrueTypeInLocalsオプションは，-XX:HitachiCallToString=fullオプションとも同時に指定できます。

(2)　-XX:+HitachiLocalsInStackTraceオプションが指定されている場合

スレッドダンプ内のスタックトレース情報の1スタックフレーム情報ごとに，そのスタックフレームに対応するメソッド内のローカル変数情報が挿入されて，出力されます。

出力形式および出力内容は，-XX:+HitachiLocalsInThrowableが指定されている場合に標準出力に出力される内容と同じです。

ただし，-XX:+HitachiLocalsInStackTraceオプションでは，次のオプションの指定は無効になります。

-XX:HitachiCallToStringオプション

Javaプログラムの例と，それに対するスタックトレース内のローカル変数情報の出力例を示します。

Javaプログラムの例3

class Example3 {
   public static void main(String[] args) {
       Example3 e3 = new Example3();
       e3.method();
   }

   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];

       <ここでスレッドダンプ出力!>
   }
}

出力例を次に示します。この例は，次の場合の例です。

-gオプションまたは-g:varsオプションを指定して作成されたclassファイルである

-XX:+HitachiLocalSimpleFormatオプションを指定している

-XX:+HitachiTrueTypeInLocalsオプションを指定している

図5-13　Javaプログラムの例3に対するローカル変数情報の出力例

5.6　トラブルへの対処と回復

この節では，次のようなトラブルが発生した場合の対処方法および回復方法について説明します。

構成ソフトウェアのプロセス（論理サーバ）が異常終了した場合

J2EEアプリケーションの強制停止に失敗した場合

セッションフェイルオーバ機能を使用時にトラブルが発生した場合

データベースと接続中にトラブルが発生した場合

JavaVMが異常終了した場合

JP1と連携したシステムでトラブルが発生した場合

1:1系切り替えシステムでトラブルが発生した場合

N:1リカバリシステムでトラブルが発生した場合

EJBクライアントでトラブルが発生した場合

＜この節の構成＞

5.6.1　構成ソフトウェアのプロセス（論理サーバ）が異常終了した場合

5.6.2　J2EEアプリケーションの強制停止に失敗した場合

5.6.3　セッションフェイルオーバ機能でトラブルが発生した場合

5.6.4　データベースと接続中にトラブルが発生した場合

5.6.5　JavaVMが異常終了した場合

5.6.6　JP1と連携したシステムでトラブルが発生した場合

5.6.7　1:1系切り替えシステムでトラブルが発生した場合

5.6.8　N:1リカバリシステムでトラブルが発生した場合

5.6.9　EJBクライアントでトラブルが発生した場合

5.6.1　構成ソフトウェアのプロセス（論理サーバ）が異常終了した場合

ここでは，Cosminexusの構成ソフトウェアのプロセスが異常終了したときに，システムを再起動する方法について説明します。

Cosminexusシステムでは，Cosminexusの構成ソフトウェアのプロセス（論理サーバ）が異常終了したとき，起動順序が設定されていればManagement Serverによって自動的に再起動されます。Management Serverでは，構成ソフトウェアのプロセスを論理サーバとして管理しています。

手動で再起動を実行する場合，異常終了した構成ソフトウェアの起動順序に依存関係があるときは，前提となる構成ソフトウェアが起動していることを確認してから再起動する必要があります。前提となる構成ソフトウェアは，システムの運用形態によって異なります。以降で，構成ソフトウェアの起動順序の依存関係，および構成ソフトウェアの再起動方法について説明します。

ポイント

CTMを利用したシステムでは，CTMによって，すぐに再起動すれば，クライアントにエラーが返却される前にシステムを回復するように設定できます。ただし，リクエストキューの最大登録数を超えた場合は，クライアントにエラーが返却されます。

＜この項の構成＞

(1)　構成ソフトウェアのプロセスの起動順序の依存関係

(2)　プロセスの再起動方法

(1)　構成ソフトウェアのプロセスの起動順序の依存関係

Cosminexusで構築したシステムを構成する構成ソフトウェアのプロセスの起動順序の依存関係について説明します。

以降は，J2EEサーバの動作モード別に，構成ソフトウェアのプロセスの起動順序の依存関係について説明します。

(a)　プロセスの依存関係

プロセスの依存関係を次に示します。

表5-74　プロセスの依存関係

プロセスの種類
前提プロセス

パフォーマンストレーサ
－

スマートエージェント※1，※2
－

CTMドメインマネジャ※1
スマートエージェント※1，※2

CORBAネーミングサービス
－

CTMデーモン※1

パフォーマンストレーサ

スマートエージェント

CTMドメインマネジャ

CORBAネーミングサービス

SFOサーバ

パフォーマンストレーサ

J2EEサーバ

パフォーマンストレーサ

スマートエージェント

CTMドメインマネジャ※3

CORBAネーミングサービス※4

CTMデーモン※3

Webサーバ
パフォーマンストレーサ

（凡例）

－：前提プロセスがない。

注※1

CTMを使用する場合に起動するプロセスです。

注※2

トランザクションサービスを使用する場合に起動するプロセスです。

注※3

CTMを使用する場合に前提となるプロセスです。

注※4

CORBAネーミングサービスをアウトプロセスで使用する場合に起動するプロセスです。CORBAネーミングサービスをインプロセスで使用する場合は必要ありません。

(2)　プロセスの再起動方法

システムでプロセスが異常終了した場合のプロセスの再起動方法について説明します。

なお，CTMに関連するプロセスが異常終了して再起動できない場合は，次の手順で対処してください。

プロセスが再起動できない場合，出力されたエラーメッセージからトラブルの要因を調査する。

ctmrasgetコマンドを実行してCTMの実行環境のバックアップを取得する。

(a)　再起動の手順

プロセスの再起動（回復）の手順を次に示します。

表5-75　プロセスの再起動方法

異常プロセス
開始コマンド
再起動（回復）手順

データベースサーバ
－
DBサーバを再起動してください。

OpenTP1
－
OpenTP1を再起動してください。

パフォーマンストレーサ
cprfstart
パフォーマンストレーサを再起動してください。

スマートエージェント※1，※2
osagent
スマートエージェントを再起動してください。

CTMドメインマネジャ※1
ctmdmstart
CTMドメインマネジャを再起動してください。

CORBAネーミングサービス
nameserv
次に示す手順で対処してください。なお，CTMを使用しない場合，手順1および手順4は不要です。

CTMデーモンの強制停止

J2EEサーバの強制停止

CORBAネーミングサービスの再起動

CTMデーモンの再起動

J2EEサーバ再起動

CTMデーモン※1
ctmstart
次に示す手順で対処してください。

CORBAネーミングサービスの強制停止

J2EEサーバの強制停止

CORBAネーミングサービスの再起動

CTMデーモンの再起動

J2EEサーバの再起動

CTMレギュレータ
－
CTMデーモンによって自動再起動されるため，再起動は不要です。

SFOサーバ※3
cjstartsv
SFOサーバを再起動してください。

J2EEサーバ
cjstartsv
J2EEサーバを再起動してください。

Webサーバ
－
Webサーバを再起動してください。

（凡例）

－：使用する製品によって開始コマンドが異なる，または該当する開始コマンドがない。

注※1

CTMを使用する場合に起動するプロセスです。

注※2

トランザクションサービスを使用する場合に起動するプロセスです。

注※3

セッションフェイルオーバ機能を使用する場合に起動するプロセスです。

5.6.2　J2EEアプリケーションの強制停止に失敗した場合

J2EEアプリケーションの強制停止に失敗した場合，J2EEサーバによって，次の情報が出力されます。

メッセージ
メッセージログに出力されます。メッセージログの出力先については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」を参照してください。

スタックトレース
例外ログとスレッドダンプに出力されます。例外ログの出力先については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」を参照してください。スレッドダンプについては，「5.5.5　JavaVMのスレッドダンプの調査」を参照してください。

なお，J2EEアプリケーションの強制停止では，内部でメソッドキャンセルが実行されています。メソッドキャンセル実行時に出力される障害情報については，「付録D　機能ごとに出力されるログ情報」を参照してください。

5.6.3　セッションフェイルオーバ機能でトラブルが発生した場合

ここでは，セッションフェイルオーバ機能にトラブルが発生した場合の対処方法として，次の2種類のトラブルへの対処について説明します。

J2EEサーバまたはWebサーバでトラブルが発生した場合

SFOサーバでトラブルが発生した場合

＜この項の構成＞

(1)　J2EEサーバまたはWebサーバでトラブルが発生した場合

(2)　SFOサーバにトラブルが発生した場合

(3)　セッションフェイルオーバ機能で出力されるログの確認

(1)　J2EEサーバまたはWebサーバでトラブルが発生した場合

J2EEサーバまたはWebサーバでトラブルが発生した場合は，「5.1　対処の手順」に示した手順に従って対処してから，J2EEサーバまたはWebサーバを起動してください。J2EEサーバまたはWebサーバの起動方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」の日常運用の操作に関する説明を参照してください。

なお，トラブルによってJ2EEサーバが停止した場合は，トラブルが発生したJ2EEサーバに対してリクエストを送信していたWebサーバも再起動してください。再起動しないと，リダイレクタは，すでに無効になっている常設コネクションを使用し続けます。この結果，トラブルが発生したJ2EEサーバにリクエストを転送して通信タイムアウトが発生するまで待ち状態になり，通信タイムアウト後，リクエストはエラーとしてクライアントに返却されることになります。

通信タイムアウトの設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(2)　SFOサーバにトラブルが発生した場合

SFOサーバにトラブルが発生した場合は，J2EEサーバにトラブルが発生した場合と同様に，必要な資料を取得してトラブルの要因を取り除いたあとで，SFOサーバを再起動します。

なお，SFOサーバを再起動すると，J2EEサーバからSFOサーバに再接続する処理が実行されます。このとき，J2EEサーバとSFOサーバ間では，初期化時と同様のネゴシエーション処理が実行されます。

ネゴシエーション処理では，冗長化されたJ2EEサーバ上のJ2EEアプリケーション間で次の情報が共通になっているかが確認されます。

Webアプリケーションのコンテキストルート名

HttpSession数の上限値

セッション情報の最大サイズ

グローバルセッションIDが使用するHTTP Cookieの名称

SFOサーバ内のロック待ちでのタイムアウト時間

冗長化されたJ2EEサーバ上のJ2EEアプリケーション間でこれらの情報が異なっている場合，そのWebアプリケーションはセッションフェイルオーバ機能が無効のまま処理を続けますが，SFOサーバへの再接続を行いません。

この場合は，該当するJ2EEアプリケーションを一度停止して，J2EEアプリケーションのセッションフェイルオーバについての設定を正しく設定し直してから，J2EEアプリケーションを再起動してください。

(3)　セッションフェイルオーバ機能で出力されるログの確認

セッションフェイルオーバ機能を使用している場合，セッションフェイルオーバ機能を使用するJ2EEサーバ，およびSFOサーバでログが出力されます。トラブルが発生した場合に必要に応じて確認してください。

J2EEサーバでのログの出力レベルと出力される内容の対応を，次の表に示します。

表5-76　J2EEサーバでのログの出力レベルと出力される内容の対応

ログ出力レベル
出力される内容

Error

セッションフェイルオーバ機能開始，終了についての情報

SFOサーバとの接続についての情報

SFOサーバでの障害発生についての情報

グローバルセッション情報のサイズ見積もり機能が有効であることを通知する情報

グローバルセッション情報のサイズ見積もり機能によるサイズ情報

Warning

グローバルセッション情報の引き継ぎ処理についての情報

無効なグローバルセッション（有効期限切れ）のリクエストによってグローバルセッションIDが見つからなかったことの通知

Information

ヘルスチェックスレッドのチェック結果

SFOサーバでのログの出力レベルと出力される内容の対応を，次の表に示します。

表5-77　SFOサーバでのログの出力レベルと出力される内容の対応

ログ出力レベル
出力される内容

Error

SFOサーバの起動・停止に関する情報

SFOサーバで発生した障害に関する情報

グローバルセッション数が最大値に対して「0%」，「20%」，「40%」，「60%」，「80％」または「100％」になったことの通知

SFOサーバで有効期限切れによって破棄されたグローバルセッションの数

Warning

SFOサーバで有効期限切れによって破棄されたグローバルセッションのグローバルセッションID

グローバルセッション数の最大値を超えて作成要求があったことの通知

無効なグローバルセッション（有効期限切れ）の取得要求があったことの通知

Information

SFOサーバで有効期限切れによって破棄されたグローバルセッションの詳細情報

5.6.4　データベースと接続中にトラブルが発生した場合

データベースとの接続中に，Cosminexusの構成ソフトウェアであるCosminexus DABroker Libraryでトラブルが発生した場合，Cosminexus DABroker Libraryによってデータベースとの接続は切り離されます。また，Cosminexus DABroker Libraryを強制終了した場合も同様です。

このとき，次の処理が実行されます。

Cosminexus DABroker Libraryが異常終了した場合
データベースで実行中の処理はロールバックされます。

DBMSが異常終了した場合
データベースで実行中の処理は，DBMSの制御に従って処理されます。

トラブルへの対応後，必要に応じてデータベースに再接続してください。

また，データベースアクセス，Cosminexus DABroker LibraryまたはJDBCドライバでエラーが発生した場合，例外としてSQLExceptionがスローされます。このSQLExceptionオブジェクトのreasonには，次の項目が設定されています。トラブルへの対処に利用してください。

JDBCドライバのメッセージ

エラーを検知したクラス名称とメソッド名称

Cosminexus DABroker Libraryからのメッセージ（メッセージがある場合）

なお，次のエラーが発生した場合は，SQLExceptionはスローされません。

Driver.connectionメソッドでデータベースに接続できない場合

URL指定でnullが返却される場合
Cosminexus DABroker Libraryで対象にしていないURLが指定された場合などが該当します。

この場合は，JDBCインタフェースの仕様で決まっている処理が実行されます。

なお，データベースとしてHiRDB，またはOracleを利用している場合，性能解析トレースファイルに出力されたコネクションIDと，Cosminexus DABroker LibraryやHiRDBクライアント，またはOracleクライアントのログファイルやトレースファイルに出力されたコネクションIDを突き合わせて確認することで，トラブルが発生したコネクションを確認できます。確認方法については，「付録C　データベースと接続中にトラブルが発生したコネクションの特定」を参照してください。

5.6.5　JavaVMが異常終了した場合

JavaVMで異常終了が発生した場合の対処方法と，異常終了が発生した場合に出力される情報について説明します。

＜この項の構成＞

(1)　異常終了時の対処方法

(2)　異常終了時に出力される情報

(1)　異常終了時の対処方法

UNIXの場合，異常終了時には，次の手順で対処してください。なお，Windowsの場合には，この対処は不要です。

異常終了が発生したマシン上でjavatraceコマンドを実行します。
javatrace.logファイルが出力されます。javatraceコマンドの実行方法については，「5.4.16　JavaVMのスタックトレース情報の取得」を参照してください。

取得したjavatrace.logファイルを，エラーリポートファイル（hs_err_pid<プロセスID>.log）とあわせて保守員に送付します。
エラーリポートファイルの取得方法については，「5.4.9　JavaVM出力メッセージログの取得（標準出力またはエラーリポートファイル）」を参照してください。

snapcoreコマンド（AIXの場合）またはcar_tar_Zコマンド（HP-UX，Linux，Solarisの場合）を実行します。
JavaVMの実行ファイルやトラブル発生時にロードされていたライブラリ，およびcoreダンプが，pax形式（AIXの場合）またはtar＋compress形式のデータアーカイブファイルとして作成されます。

作成されたアーカイブファイルを，保守員に送付します。

(2)　異常終了時に出力される情報

JavaVMで次の異常終了が発生した場合に出力される情報について説明します。

JavaVM処理中にCヒープ不足が発生した場合

JavaVM処理中のCヒープ不足以外のOutOfMemoryErrorが発生した場合

内部論理エラーが発生した場合

(a)　JavaVM処理中にCヒープ不足が発生した場合

Cヒープが不足すると，次のようなメッセージに続いて，メモリの状態，Javaヒープ情報，およびスタックトレース情報が標準出力およびエラーリポートファイル（hs_err_pid<プロセスID>.log）に出力されます。そのあとで，JavaVMが強制終了されます。

Exception in thread <スレッド名称> java.lang.OutOfMemoryError:requested <メモリ確保要求サイズ> bytes [ for <内部調査用メッセージ>] .

出力された情報を確認して対処してください。

(b)　JavaVM処理中のCヒープ不足以外のOutOfMemoryErrorが発生した場合

J2EEサーバを起動するときのオプションとして-XX:+HitachiOutOfMemoryAbortを設定している場合，次の要因によってOutOfMemoryErrorが発生したときに，メッセージとメモリダンプを出力してJavaVMが強制終了します。出力された情報を確認して対処してください。

強制終了する要因

Javaヒープ不足

Permヒープ不足

J2SEクラスライブラリでのCヒープ不足

なお，JavaVM処理中にCヒープ不足になった場合は，このオプションの指定に関係なく強制終了します。

終了時には，次のメッセージと，メモリダンプが出力されます。

java.lang.OutOfMemoryError occurred.
JavaVM aborted because of specified -XX:+HitachiOutOfMemoryAbort options.

オプションとして-XX:+HitachiOutOfMemoryStackTraceが設定されている場合は，スタックトレースが出力されたあとで終了します。ただし，あらかじめjava.io.File.deleteOnExitメソッドやjava.lang.Runtime.addShutdownHookメソッドによってJavaVM終了時に実行する処理を登録していた場合も，それらは実行されないで強制終了します。

(c)　内部論理エラーが発生した場合

内部論理エラーが発生すると，エラーが発生したJavaVMの情報，調査用のエラーIDおよび問題が発生したスレッドを示すメッセージが，標準出力およびエラーリポートファイル（hs_err_pid<プロセスID>.log）に出力されます。出力された情報を保守員に送付してください。

5.6.6　JP1と連携したシステムでトラブルが発生した場合

JP1と連携したシステムでトラブルが発生した場合，次に示す対処を実施する必要があります。

＜この項の構成＞

(1)　JP1/IMと連携したシステムでのトラブルへの対処

(2)　JP1/AJS2と連携したシステムでのトラブルへの対処

(1)　JP1/IMと連携したシステムでのトラブルへの対処

JP1/IMと連携したシステムで予想されるトラブルとその対処方法を次に示します。

表5-78　JP1/IMと連携したシステムで予想されるトラブルとその対処方法

トラブルの種類
対処方法

監視ツリーの自動生成時にトラブルが発生した
トラブルが発生したら，JP1/Baseのプラグインサービスログファイルに出力されたCosminexusアダプタコマンドのメッセージを基にトラブルの発生要因を調査してください。JP1/Baseのプラグインサービスログファイルの詳細については，マニュアル「JP1/Base」を参照してください。

JP1イベントがJP1/IMに通知されない
Cosminexusで構築したシステムからJP1/IMにJP1イベントが発行されているかどうか，運用管理エージェント・運用監視エージェント・Management Serverのログを確認してください。運用管理エージェント・運用監視エージェント・Management Serverのログの格納場所については，「5.4.1(1) Cosminexus Component Containerのログの取得」，または「5.4.2(1) Cosminexus Component Containerのログの取得」を参照してください。
運用管理エージェント・運用監視エージェント・Management Serverのログの内容に応じて，次の対処を実施してください。

JP1イベント発行のログが出力されていない場合Cosminexusの運用管理サーバでのJP1イベント発行の設定内容を確認してください。

JP1イベント発行のログが出力されている場合，JP1統合運用管理サーバでのJP1/Baseの構成定義の作成内容を確認してください。また，Cosminexusの運用管理サーバおよびJ2EEサーバでのJP1/Baseのイベントサービスの動作環境設定内容を確認してください。

Cosminexusの運用管理サーバおよびJP1統合運用管理サーバでの障害監視の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

JP1/IM-Viewのモニタ起動操作を実行したあとWebブラウザが起動しない
モニタ起動コマンドをコピーしたディレクトリに格納されているmngsvrmonitor.logに出力されたメッセージを基にトラブルの発生要因を調査してください。

(2)　JP1/AJS2と連携したシステムでのトラブルへの対処

JP1/AJS2連携による運用管理コマンド（mngsvrutil）の自動実行でエラーが発生した場合，JP1/AJS2-Viewのジョブネットモニタウィンドウから，トラブルが発生したジョブの詳細情報を表示し，実行結果を確認してください。実行結果詳細に表示されたmngsvrutilコマンドのエラーメッセージを基にトラブルの発生要因を調査してください。JP1/AJS2-Viewでの操作の詳細については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド」を参照してください。

5.6.7　1:1系切り替えシステムでトラブルが発生した場合

1:1系切り替えシステムで，待機系のホストへの系切り替え処理がデータベースサーバの障害（サーバダウンやデッドロックなど）によってタイムアウトした場合の対処について，OSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

ログを取得してから，手動で待機系ホストをオンラインにしてください。

(a)　1:1系切り替えシステムのログの取得

1:1系切り替えシステムでトラブルが発生した場合，クラスタログを取得する必要があります。Windowsを標準パスにインストールした場合のクラスタログの出力先を次に示します。

C:¥WINDOWS¥cluster¥cluster.log

クラスタログには次の情報が出力されます。

クラスタサービスの稼働ログ

VBScriptの構文にエラーがあった場合のエラーメッセージ

汎用スクリプトのResource.LogInformationメソッド

その他のメッセージ

クラスタログの詳細については，Windowsのドキュメントを参照してください。

また，J2EEサーバが動作しない場合は，Cosminexus Component Containerのログも参照してください。

(b)　1:1系切り替えシステムの手動リカバリ

次の手順で，1:1系切り替えシステムを手動でリカバリしてください。

データベースを再起動するなどして，タイムアウトした原因を解消します。

待機系のホストの対象リソースをオンラインにします。

(2)　UNIXの場合

データベースを再起動するなどして，タイムアウトした原因を解消してください。

5.6.8　N:1リカバリシステムでトラブルが発生した場合

N:1リカバリシステムでトラブルが発生した場合のリカバリ手順について，OSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

N:1リカバリシステムで，待機系のホスト（リカバリ専用サーバ）でのリカバリ処理がデータベースサーバの障害（サーバダウンやデッドロックなど）によってタイムアウトした場合，ログを取得して，手動でリカバリを実行してください。リカバリ手順を次に示します。

N:1系切り替えシステムのログを取得します。
N:1リカバリシステムでトラブルが発生した場合，クラスタログを取得する必要があります。取得するログは，1:1系切り替えシステムでトラブルが発生した場合に取得するログと同じです。取得するログの詳細については，「5.6.7　1:1系切り替えシステムでトラブルが発生した場合」を参照してください。

N:1系切り替えシステムを手動でリカバリします。
次のどちらかの方法で，Ｎ:1リカバリシステムを手動でリカバリしてください。

待機系のホストの対象リソースをオンラインにする

J2EEサーバのトランザクション回復コマンド（cjstartrecover）を実行する

(a)　待機系のホストの対象リソースをオンラインにしてリカバリを実行する

待機系のホストの対象リソースをオンラインにしてリカバリを実行する手順について説明します。

データベースを再起動するなどして，タイムアウトした原因を解消します。

待機系のホストの対象リソースをオンラインにします。

(b)　J2EEサーバのトランザクション回復コマンド（cjstartrecover）を実行してリカバリを実行する

J2EEサーバのトランザクション回復コマンド（cjstartrecover）を実行してリカバリを実行する手順について説明します。

データベースを再起動するなどして，タイムアウトした原因を解消します。

待機系のホストの汎用スクリプトの「Dir_Name」に指定したパスにフォルダを作成します。
すでにフォルダが存在する場合は，削除してからフォルダを作成してください。

待機系のホストの汎用スクリプトがオンラインのときに，クラスタのログを参考に，cjstartrecoverを実行します。

リカバリに成功したら，「Dir_Name」に指定したパスに作成したフォルダを削除します。

cjstartrecoverの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(2)　UNIXの場合

N:1リカバリシステムで，待機系のホスト（リカバリ専用サーバ）でのリカバリ処理がデータベースサーバの障害（サーバダウンやデッドロックなど）によりタイムアウトした場合，次の手順に従って手動でリカバリを実行します。

データベースを再起動するなどして，タイムアウトした原因を解消します。

待機系のホストで，ダウンした実行系のホストに対応するmonbeginを実行します。

# monbegin サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されている実行系のサーバの識別名を指定します。

待機系のホストで，ダウンした実行系のホストに対応するmonactを実行します。

# monact サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されている実行系のサーバの識別名を指定します。
これによって，待機系のホスト（リカバリ専用サーバ）で，ダウンした実行系のホストで未決着だったトランザクションのリカバリ処理が実行されます。

参考

serversファイルの定義など，HAモニタでのサーバ対応の環境設定については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの環境設定に関する説明を参照してください。

5.6.9　EJBクライアントでトラブルが発生した場合

グローバルトランザクションを使用しているEJBクライアントがダウンした場合，グローバルトランザクションをリカバリする必要があります。グローバルトランザクションのリカバリは，EJBクライアントを再起動することで実行できます。

グローバルトランザクションのリカバリの処理が完了したかどうかを確認する方法を次に示します。

アプリケーションサーバでcjlisttrnコマンドを実行して，トランザクションがアクティブな状態になっているかを確認します。cjlisttrnコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

リソースアダプタを停止できるかどうかを確認してください。停止できる場合はグローバルトランザクションのリカバリ処理が完了しています。

アプリケーションサーバが正常停止できるかどうかを確認してください。正常停止できる場合はグローバルトランザクションのリカバリ処理が完了しています。

各リソースが提供するツール，コマンドなどを使用して確認してください。

また，複数のEJBクライアントが存在する場合に，どのEJBクライアントがグローバルトランザクションのリカバリに必要なのかを調査する手順を次に示します。

cjlisttrnコマンドを-pendingオプションを指定して実行して未決着のトランザクションを確認します。

実行形式

cjlisttrn [<サーバ名称>] -pending -bqual

実行例

cjlisttrn MyServer -pending -bqual

手順1.で確認した未決着のトランザクションから，次のすべての条件に当てはまるトランザクションがあるかどうかを確認します。

cjlisttrnコマンドを発行するたびに経過時間が増加している

ブランチの種類が「Sub」または「Sub(recovered)」である

グローバルトランザクションIDに，停止したEJBクライアントの起動時に出力されるKFCB40051-IメッセージのTmHashの値が含まれる

これらのすべての条件に当てはまるトランザクションが，グローバルトランザクションのリカバリに必要です。

5.7　トラブルシューティングに関連する留意事項

ここでは，トラブルシューティングに関連する留意事項について説明します。

＜この節の構成＞

5.7.1　EJBクライアントアプリケーションのシステムログに関する留意事項

5.7.2　Cosminexus DABroker Libraryのトレースファイルの運用時の留意事項

5.7.3　CTM使用時の留意事項

5.7.4　PRF使用時の留意事項

5.7.1　EJBクライアントアプリケーションのシステムログに関する留意事項

ここでは，サブディレクトリ共有モードのEJBクライアントアプリケーションで出力されるシステムログを参照する場合，およびサブディレクトリ共有モードのEJBクライアントアプリケーションを運用する場合の留意事項について説明します。

ログファイル内で有効なデータは，ファイルの先頭からEOFまでです。
EJBクライアントアプリケーションのシステムログでは，ログファイルがラップアラウンドしたときにラップアラウンド以前のログのデータが削除されないで，先頭から順番に上書きされていきます。このため，ログファイルを参照するときには，EOF以降のデータは無視してください。EOF以降のデータは，ラップアラウンド以前のログファイルの無効なデータです。
有効なログファイルのデータの末尾は，次に示すデータになります。

EOF CRLF CRLF CRLF CRLF----------< End of Data >----------CRLF CRLF

EOFはトレースデータの終端を表す文字（0x1A）です。CRLFは，改行（0x0D，0x0A）を表します。
出力例を次に示します。なお，トレースの終端を表す文字は，［EOF］と表記します。

Windowsの場合

**** Windows XP 5.1               TZ=GMT+09:00                     xxxx/xx/xx xx:xx:xx.xxx
    yyyy/mm/dd hh:mm:ss.sss               pid      tid      message-id            message(LANG=ja)
0000 xxxx/xx/xx xx:xx:xx.xxx     HEJB       BE3F6FE9 015EE671 KDJEXXXXX-W           xxxxxxxxx
0001 xxxx/xx/xx xx:xx:xx.xxx     HEJB       BE3F6FE9 015EE671 KDJEYYYYY-I           yyyyyyyyy
0002 xxxx/xx/xx xx:xx:xx.xxx     HEJB       BE3F6FE9 015EE671 KDJEZZZZZ-I           zzzzzzzzz
[EOF]

----------< End of Data >----------

<<ラップアラウンド前の無効なデータ>>…
…

…

UNIXの場合

**** "OS名（OSバージョンなど含む）"               TZ=Asia/Tokyo                     xxxx/xx/xx xx:xx:xx.xxx
    yyyy/mm/dd hh:mm:ss.sss                      pid      tid      message-id            message(LANG=ja)
0000 xxxx/xx/xx xx:xx:xx.xxx     HEJB             BE3F6FE9 015EE671 KDJEXXXXX-W           xxxxxxxxx
0001 xxxx/xx/xx xx:xx:xx.xxx     HEJB             BE3F6FE9 015EE671 KDJEYYYYY-I           yyyyyyyyy
0002 xxxx/xx/xx xx:xx:xx.xxx     HEJB             BE3F6FE9 015EE671 KDJEZZZZZ-I           zzzzzzzzz
[EOF]

----------< End of Data >----------

<<ラップアラウンド前の無効なデータ>>…
…
…

EJBクライアントアプリケーションのプロセス起動時に，システムプロパティのejbserver.logger.channels.define.<チャネル名>.filenumキーで指定した面数のトレースファイルはすべて作成されます。このとき，トレースファイルは空白（0x20）で初期化されます。

ユーザログファイルの容量は，システムプロパティのejbserver.logger.channels.define.<チャネル名>.filesizeキーで指定した容量で固定です。指定したサイズのトレースファイルがプロセス起動時に作成されます。このため，ログが出力されるのに伴って，容量が増減することはありません。

ログファイルの容量または面数を変更する場合，該当するログファイルに出力しているプロセスをすべて停止して，ログファイルとmmapディレクトリ以下のログ管理ファイルを別のディレクトリへ移動，または削除する必要があります。

ログファイルの容量または面数を変更する場合以外では，ログファイル，およびログ管理ファイルを変更または削除しないでください。変更または削除した場合，以降のログが正しく出力されなくなるおそれがあります。

サブディレクトリ共有モードで動作するEJBクライアントアプリケーションがログを出力しているサブディレクトリを，cjcldellogコマンドで削除しないでください。削除した場合，以降のログが正しく出力されなくなるおそれがあります。

すでにサブディレクトリ専有モードで動作しているEJBクライアントアプリケーションがある環境でサブディレクトリ共有モードでEJBクライアントアプリケーションを開始する場合，システムプロパティのejbserver.client.ejb.logキーに，サブディレクトリ専有モードで動作しているEJBクライアントアプリケーションとは異なる値を指定してください。同じ値を指定した場合，サブディレクトリ専有モードで動作するEJBクライアントアプリケーションのサブディレクトリ数を正しく管理できません。
また，サブディレクトリ共有モードで動作しているEJBクライアントアプリケーションがある環境では，サブディレクトリ専有モードで開始するEJBクライアントアプリケーションで，システムプロパティのejbserver.client.ejb.logキーに"system"を指定しないでください。サブディレクトリ共有モードではejbserver.client.ejb.logキーのデフォルト値として"system"を使用するため，サブディレクトリ数が正しく管理できなくなります。

すでにCosminexus 06-50よりも前のバージョンで構築した環境で，サブディレクトリ専有モードで動作させているEJBクライアントアプリケーションを，システムプロパティejbserver.client.ejb.logキーに"system"を指定した状態で06-50以降に移行した場合，サブディレクトリ専有モードのEJBクライアントアプリケーションとサブディレクトリ共有モードのEJBクライアントアプリケーションが混在することになります。この場合，次の図のような状態になります。

図5-14　サブディレクトリ専有モードで動作させているEJBクライアントアプリケーションがある環境にサブディレクトリ共有モードで動作するEJBクライアントアプリケーションを混在させた場合のディレクトリ構成

このように，混在した環境では，サブディレクトリ専有モードのEJBクライアントアプリケーションが作成できるサブディレクトリの数が，サブディレクトリ共有モードのEJBクライアントアプリケーションが使用するディレクトリの数（1個）分，少なくなります。なお，すでにdirectorynumで指定した数分のサブディレクトリが作成された状態で移行した場合は，サブディレクトリ専有モードで使用するサブディレクトリの数が減ることはありません。

cjclstartapコマンドはサブディレクトリ共有モードだけで使用してください。サブディレクトリ専有モードでcjclstartapコマンドを実行してEJBクライアントを起動した場合，EJBクライアント起動コマンドの稼働時の情報（cjclstartap[n].log）が正しく表示されません。

5.7.2　Cosminexus DABroker Libraryのトレースファイルの運用時の留意事項

ここでは，Cosminexus DABroker Libraryのトレースファイル運用時の留意事項について説明します。

＜この項の構成＞

(1)　拡張データベースアクセストレースファイル

(2)　エラートレースファイル

(3)　Exceptionトレースログのファイル

(4)　JDBCドライバのトレースファイル

(1)　拡張データベースアクセストレースファイル

拡張データベースアクセストレースファイル運用時の注意事項を次に示します。

拡張データベースアクセストレースでは，Cosminexus DABroker Library動作環境定義ファイルで設定した行数を超える出力があった場合，現在のトレースファイルがバックアップファイルとして別名で保存されます。トレース内容は，トレースファイルの先頭から再び出力されます。

バックアップファイルは1世代前までしか残りません。このため，すでにバックアップファイルがある場合に，現在のトレースファイルが設定した行数を超えると, 既存のバックアップファイルが上書きされます。複数世代のバックアップファイルを保存する必要がある場合は，あらかじめ別のディレクトリに退避してください。

トレースファイルは実行しているコネクションの数だけ作成されます。

トレースファイルは自動的に削除されません。ユーザが不要になった時点で削除してください。

ハードディスクの空き容量が十分でない場合，トレースの出力が停止されることがあります。

(2)　エラートレースファイル

エラートレースファイル運用時の注意事項を次に示します。

dabevttrcerr1.txtファイルのサイズが512キロバイトを超えている場合にログを出力すると，dabevttrcerr1.txtファイルをバックアップ用ファイル（dabevttrcerr2.txt）に名称を変更したあと，新規作成したdabevttrcerr1.txtファイルにログを出力します。

バックアップ用ファイルは1世代前までだけ残せます。バックアップファイルを保存する必要がある場合は，あらかじめ別のディスクに退避してください。

ハードディスクの空き容量が十分でない場合，ログの出力を停止します。

(3)　Exceptionトレースログのファイル

Exceptionトレースログのファイル運用時の注意事項を次に示します。

Exceptionトレースログのファイルは1世代前まで保持されます。ファイル出力時にすでにカレントファイルと１世代前のファイルが存在する場合は，1世代前のファイルが削除され，カレントファイルが1世代前のファイルに置き換えられます。

ファイルの出力先は，環境変数DAB_FILEDIRで設定できます。
デフォルトは，<Cosminexus DABroker Library運用ディレクトリ>¥spool（Windowsの場合），または<Cosminexus DABroker Library運用ディレクトリ>/spool（UNIXの場合）です。
<ファイルの出力先ディレクトリ>¥J2EEサーバ名称+MTrc.logl（Windowsの場合），または<ファイルの出力先ディレクトリ>/J2EEサーバ名称+MTrc.logl（UNIXの場合）のバイト数が259バイトを超えないように注意してください。また，<ファイルの出力先ディレクトリ>¥J2EEサーバ名称+MTrcOLD.log（Windowsの場合），または<ファイルの出力先ディレクトリ>/J2EEサーバ名称+MTrcOLD.log（UNIXの場合）のバイト数が259バイトを超える場合も注意が必要です。
259バイトを超えた場合の動作は，次のようになります。

<ファイルの出力先ディレクトリ>¥J2EEサーバ名称+MTrc.log のバイト数が259バイトを超えた場合，ログファイル，および1世代前のファイルが作成されません。

<ファイルの出力先ディレクトリ>¥<J2EEサーバ名称+MTrc.log>のバイト数が259バイトを超えない場合に，<ファイルの出力先ディレクトリ>¥<J2EEサーバ名称+MTrcOLD.log>のバイト数が259バイトを超えたときは，ログファイルは作成されますが，1世代前のファイルが作成されません。この場合，ファイル出力情報量を超えても1世代前のファイルが作成されないで，カレントファイルへ出力され続けます。

ファイルの作成や出力に失敗した場合，ログファイルに情報が出力されません。このとき，J2EEアプリケーションへのエラーメッセージの返却や，リトライは実行されません。エラーになった要因が解決されると，ログファイルにファイルが出力されるようになります。
ログファイル初回接続時にエラーが発生した場合に考えられる要因を次に示します。

ディレクトリが存在しない，またはディレクトリに対する権限がない

カレントファイルを1世代前のファイルに移動できない

1世代前のファイルを削除できない

ログファイル出力時にエラーが発生した場合に考えられる要因を次に示します。

ディレクトリが存在しない，またはディレクトリに対する権限がない

カレントファイルを作成または出力できない

カレントファイルを1世代前のファイルに移動できない

1世代前のファイルを削除できない

(4)　JDBCドライバのトレースファイル

JDBCドライバのトレースファイル運用時の注意事項を次に示します。

JDBCドライバ内でトレース情報の数がエントリ数を超えた場合は，トレースの古い順にトレース情報が上書きされます。

JDBCインタフェースメソッドトレース（キーワード：JDBC_IF）は，EntryおよびReturnでそれぞれ1エントリのトレース領域を使用します。

DABrokerとのイベントトレース（キーワード：SV_EVENT）は，送信また受信イベントでそれぞれ1エントリのトレース領域を使用します。

5.7.3　CTM使用時の留意事項

ここでは，CTM使用時の留意事項について説明します。CTMでは次のことに注意してください。

CTMの障害情報は，CTMドメイン単位にCTMSPOOL環境変数の下に取得されています。CTMデーモンおよびCTMドメインマネジャのダウンの場合には再開始時にも障害情報を取得するため，障害発生後に障害情報を退避してください。

5.7.4　PRF使用時の留意事項

ここでは，PRF使用時の留意事項について説明します。PRFでは次のことに注意してください。

PRFの障害情報は，PRFデーモン識別子単位にPRFSPOOL環境変数の下に取得されています。PRFデーモンのダウンの場合には再開始時にも障害情報を取得するため，障害発生後に障害情報を退避してください。

6.　監査ログを使用したシステムの監査

この章では，監査ログを使用したシステムの監査について説明します。

＜この章の構成＞

6.1　監査ログを使用したシステム監査の概要

6.2　監査ログの収集と調査

6.3　監査ログを出力するコマンド・操作一覧

6.4　監査ログの出力ポイント

6.1　監査ログを使用したシステム監査の概要

この節では，監査ログを使用したシステムの監査の概要について説明します。

監査ログとは，システム構築者や運用者がCosminexusのプログラムに対して実行した操作，およびその操作に伴うプログラムの動作の履歴が出力されるファイルです。監査者が監査ログを調査することで，「いつ」「だれが」「何をしたか」を知ることができ，システムの運用が法規制やセキュリティ評価基準，または業界ごとの各種の基準に準拠していることを証明できます。

6.2　監査ログの収集と調査

この節では，システムが出力する監査ログの出力先，出力形式，および出力項目の詳細について説明します。

＜この節の構成＞

6.2.1　監査ログの出力先

6.2.2　監査ログの出力形式

6.2.3　メッセージの出力項目

6.2.1　監査ログの出力先

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥auditlog¥audit[n]※.log

UNIXの場合
/opt/Cosminexus/auditlog/audit[n]※.log

注※　[n]の部分には，面の番号が付きます。

デフォルトでは，監査ログの最大ファイルサイズは「32MB」，ファイル面数は「4」に設定されています。最大ファイルサイズ，ファイル面数，および出力先は，監査ログの定義ファイル（auditlog.properties）で変更できます。監査ログの設定については，マニュアル「Cosminexus　システム構築ガイド」の監査ログ取得の設定についての説明を参照してください。

6.2.2　監査ログの出力形式

監査ログは，メッセージとして出力されます。監査ログのメッセージは，次の形式で出力されます。

CALFHM 1.0,出力項目1=値1,出力項目2=値2,出力項目3=値3,・・・出力項目n=値n

先頭の「CALFHM 1.0」は，ヘッダ情報です。監査ログに，共通で出力されます。

システムの監査で使用するメッセージの出力例を次に示します。

出力例

CALFHM 1.0,seqnum=1,msgid=KDJE54400-I,date= 2007-01-22T16:09:59.884+09:00,
progid=Cosminexus,compid=CCC,pid=00EB7859,ocp:host=host01,
ctgry=ConfigurationAccess,result=Occurrence,subj:euid=account01,
obj="Server01",op="Add",to:host=host02,to:port=28080,
msg="account01 executes the request (cjimportapp Server01 -f App1.ear)."

注　実際に出力されるメッセージは，1行で表示されます。この例のように改行されません。

このメッセージは，「2007年1月22日16時9分59.884秒」に，「ホスト01」というホストで，cjimportappコマンドが実行されたことを示しています。また，コマンドを実行したアカウントは「account01」，「Server01」というサーバに対してコマンド実行されたことを示しています。メッセージ内容の詳細については，「6.2.3　メッセージの出力項目」を参照してください。

6.2.3　メッセージの出力項目

監査で使用するメッセージの出力項目には，すべてのメッセージで共通の項目，およびメッセージごとに固有の項目があります。それぞれの項目の意味を次に示します。

すべてのメッセージで共通の項目

すべてのメッセージで同じ意味の可変値が出力されたり，共通の文字列が出力されたりする項目が該当します。

メッセージごとに固有の項目

メッセージごとに固有の意味を持つ可変値が出力されたり，メッセージごとに出力される文字列が決まっていたりする項目が該当します。

監査で使用するメッセージの出力項目の詳細について，次の表に示します。

表6-1　監査で使用するメッセージの出力項目

出力項目名
出力項目の意味
詳細
共通／固有

seqnum
通番
監査ログの通番が出力されます。
出力される値は，1から9999999999までの整数です。
共通

msgid
メッセージID
メッセージIDが出力されます。
固有

date
日付・時刻
メッセージが出力された日時が，次の形式で出力されます。YYYY-MM-DDThh:mm:ss.sssTZD

YYYY：西暦年

MM：月

DD：日

T：日付と時間の区切り

hh：時

mm：分

ss：秒

sss：マイクロ秒

TZD：タイムゾーン※1

共通

progid
発生プログラム名
監査事象が発生したプログラムの名称が出力されます。Cosminexusの場合，「Cosminexus」という文字列が出力されます。
共通

compid
発生構成ソフトウェア名
監査事象が発生した構成ソフトウェアの略称が，次の形式で出力されます。

CCC：Cosminexus Component Container

CTM：Cosminexus Component Transaction Monitor

HWS：Hitachi Web Server

MNG：Management Server

PRF：Cosminexus Performance Tracer

UAP_<任意の名称>※2：ユーザがJ2EEアプリケーション，またはバッチアプリケーション実装時に指定した任意の名称

固有

pid
発生プロセスID
監査事象が発生したプロセスのプロセスIDが出力されます。
共通

ocp:host
発生場所
監査事象が発生したホストの名称が出力されます。ただし，発生場所の情報が取得できなかった場合，「(null)」が出力されます。
共通

ctgry
監査事象の種別
監査事象の種別が，次のとおり分類されて出力されます。

StartStop

サーバ，プロセス，サービスなどの起動・終了を示す事象です。

Authentication

ログイン，ログアウトなど，Management Serverへの管理者IDと管理者パスワードによる認証が実行されたことを示す事象です。

ConfigurationAccess

設定および構成の変更，構成情報の参照を示す事象です。

AccessControl※2

管理者またはエンドユーザが管理リソース，およびセキュリティリソースへのアクセスを試みて，成功または失敗したことを示す事象です。

Failure

ソフトウェアの異常を示す事象です。

LinkStatus※2

機器間のリング状態を示す事象です。

ExternalService※2

外部サービスとの通信結果を示す事象です。

ContentAccess※2

ユーザの重要なデータへのアクセスを試みて，成功または失敗したことを示す事象です。

Maintenance※2

保守作業を実行して，操作が正常終了または失敗したことを示す事象です。

AnomalyEvent※2

しきい値のオーバなどの異常が発生したこと，または異常な通信の発生を示す事象です。

ManagementAction※2

プログラムの重要なアクションが実行されたことを示す事象，またはほかの監査事象を契機として実行されるアクションを示す事象です。

固有

result
監査事象の結果
監査事象の結果（成功・失敗・発生）が，次の形式で出力されます。

Success

監査事象の成功を示します。

Failure

監査事象の失敗を示します。

Occurrence

成功および失敗の区別がない事象の発生を示します。

固有

subj:uid
サブジェクト識別情報（アカウント識別子の場合）
監査事象を発生させたものがアカウント情報に割り付けられている場合，アカウント識別子（ユーザIDなど）が出力されます。
固有

subj:euid
サブジェクト識別情報（OSのアカウントの場合）
監査事象を発生させたものがOSが提供するアカウント情報に割り付けられている場合，OSのアカウント※3が出力されます。ただし，サブジェクト識別情報が取得できなかった場合，「(null)」が出力されます。
固有

obj
オブジェクト情報
監査事象となった操作の対象の情報が，「"」で囲まれた形式で出力されます。
固有

op
動作情報
監査事象となった操作の種別が，「"」で囲まれた次の形式で出力されます。

Start

起動を示します。

Stop

停止を示します。

Login

ログインを示します。

Logout

ログアウトを示します。

Logon

ログオンを示します。

Logoff

ログオフを示します。

Refer

設定情報の参照を示します。

Add

設定情報の追加を示します。

Update

設定情報の更新を示します。

Delete

設定情報の削除を示します。

Occur

障害などの発生を示します。

Enforce※2

処理の実施を示します。

Up※2

リンクの活性を示します。

Down※2

リンクの非活性を示します。

Request※2

要求を示します。

Response※2

応答を示します。

Send※2

発信を示します。

Receive※2

受信を示します。

Install※2

インストールを示します。

Uninstall※2

アンインストールを示します。

Backup※2

バックアップを示します。

Maintain※2

保守作業を示します。

Invoke※2

管理者などの呼び出しを示します。

Notify※2

管理者などへの通知を示します。
固有

objloc
オブジェクトロケーション情報
オブジェクトロケーション情報が出力されます。
固有

to:host
リクエスト送信先ホスト
監査事象が複数のプログラム間で連携して動作するリクエストに関連する場合に，リクエストの送信先のホストの情報が出力されます。
固有

to:port
リクエスト送信先ポート番号
監査事象が複数のプログラム間で連携して動作するリクエストに関連する場合に，リクエストの送信先のポート番号が出力されます。
固有

msg
自由記述
監査事象の内容を示す文章が出力されます。
固有

before※2
変更前情報
変更前の情報が出力されます。
固有

after※2
変更後情報
変更後の情報が出力されます。
固有

auth※2
権限情報
監査事象を発生させたときのサブジェクトの権限が出力されます。
固有

sins※2
サービスインスタンス名
サービスの利用者の識別子が出力されます。
固有

haid※2
冗長化識別情報
監査事象の発生場所が冗長化構成の場合，発生場所の系を表す情報が出力されます。
固有

from:host※2
リクエスト送信元ホスト
監査事象が複数のプログラム間で連携して動作するリクエストに関連する場合に，リクエストの送信元の場所情報が出力されます。
固有

from:port※2
リクエスト送信元ポート番号
監査事象が複数のプログラム間で連携して動作するリクエストに関連する場合に，リクエストの送信元のポート番号が出力されます。
固有

outp:host※2（ホスト名で出力する場合）
出力元の場所
出力元が動作している場所情報が出力されます。
固有

subjp:host※2（ホスト名で出力する場合）
指示元の場所
サブジェクトが指示を出した場所情報が出力されます。
固有

dtp:host※2（ホスト名で出力する場合）
検出場所
検出エンティティが動作している場所情報が出力されます。
固有

loc※2
ロケーション情報
ユーザが設定したロケーション識別情報が出力されます。ユーザが設定しなかった場合は，ルートアプリケーション情報が，「"」で囲まれた形式で出力されます。ただし，ルートアプリケーション情報が取得できなかった場合，「null」が「"」で囲まれた形式で出力されます。
固有

（凡例）

共通：すべてのメッセージで共通の項目であることを示します。

固有：メッセージごとに固有の項目であることを示します。メッセージごとに固有の項目の詳細については，マニュアル「Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編」，マニュアル「Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編」，およびマニュアル「Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編」のそれぞれのメッセージの説明を参照してください。

注※1　タイムゾーンは，UTCからの時差で表示されます。表示形式を次に示します。

+hh:mm：UTCからhh時間mm分進んでいる

-hh:mm：UTCからhh時間mm分遅れている

Z：UTCと同じ
（例）日本の場合：+09:00

注※2　監査ログ出力用のAPIを使用して，J2EEアプリケーション，またはバッチアプリケーションから出力するように実装した場合にだけ出力される情報です。

注※3　OSのアカウントには，Windowsの場合はユーザ名が，UNIXの場合は，実効ユーザIDが出力されます。

6.3　監査ログを出力するコマンド・操作一覧

この節では，監査ログを出力するコマンドおよび操作について説明します。監査ログは，ここで説明するコマンドと操作を実行したタイミング，およびそのコマンドと操作による処理が実行されたタイミングで出力されます。

ここでは，コマンドと操作を次の分類に分けて，それぞれの分類で監査ログを出力するコマンドおよび操作の一覧を示します。

J2EEサーバで使用するコマンド

性能解析トレース・CTMで使用するコマンド

Management Serverで使用するコマンド

EJBクライアントアプリケーションで使用するコマンド

Hitachi Web Serverで使用するコマンド・操作

＜この節の構成＞

6.3.1　J2EEサーバで使用するコマンド一覧

6.3.2　バッチサーバで使用するコマンド一覧

6.3.3　性能解析トレース・CTMで使用するコマンド一覧

6.3.4　Management Serverで使用するコマンド一覧

6.3.5　EJBクライアントアプリケーションで使用するコマンド一覧

6.3.6　Hitachi Web Serverで使用するコマンド・操作一覧（Windowsの場合）

6.3.7　Hitachi Web Serverで使用するコマンド・操作一覧（UNIXの場合）

6.3.1　J2EEサーバで使用するコマンド一覧

J2EEサーバで使用するコマンドのうち，監査ログを出力するコマンドの一覧を次の表に示します。

表6-2　監査ログを出力するコマンドの一覧（J2EEサーバで使用するコマンド）

コマンド名 | 監査ログ出力ポイントの参照先※
cjaddapp | 6.4.1(3)
cjaddsec | 6.4.1(3)
cjchmodapp | 6.4.1(3)
cjclearpool | 6.4.1(3)
cjclosecn | 6.4.1(3)
cjcopyres | 6.4.1(3)
cjdeleteapp | 6.4.1(3)
cjdeletejb | 6.4.1(3)
cjdeletelibjar | 6.4.1(3)
cjdeleteres | 6.4.1(3)
cjdeletesec | 6.4.1(3)
cjdeployrar | 6.4.1(3)
cjdumpsv | 6.4.1(2)
cjenvsetup | 6.4.1(2)
cjenvupdate | 6.4.1(2)
cjexportapp | 6.4.1(3)
cjexportrar | 6.4.1(3)
cjgencmpsql | 6.4.1(3)
cjgetappprop | 6.4.1(3)
cjgetjbprop | 6.4.1(3)
cjgetrarprop | 6.4.1(3)
cjgetresprop | 6.4.1(3)
cjgetstubsjar | 6.4.1(3)
cjimportapp | 6.4.1(3)
cjimportjb | 6.4.1(3)
cjimportlibjar | 6.4.1(3)
cjimportres | 6.4.1(3)
cjlistapp | 6.4.1(3)
cjlistjb | 6.4.1(3)
cjlistlibjar | 6.4.1(3)
cjlistpool | 6.4.1(3)
cjlistrar | 6.4.1(3)
cjlistres | 6.4.1(3)
cjlistsec | 6.4.1(3)
cjlistthread | 6.4.1(3)
cjlisttrn | 6.4.1(3)
cjlisttrnfile | 6.4.1(3)
cjmapsec | 6.4.1(3)
cjrarupdate | 6.4.1(2)
cjreloadapp | 6.4.1(3)
cjrenameapp | 6.4.1(3)
cjreplaceapp | 6.4.1(3)
cjresetsv | 6.4.1(4)
cjresumepool | 6.4.1(3)
cjsetappprop | 6.4.1(3)
cjsetjbprop | 6.4.1(3)
cjsetrarprop | 6.4.1(3)
cjsetresprop | 6.4.1(3)
cjsetup | 6.4.1(2)
cjstartapp | 6.4.1(3)
cjstartjb | 6.4.1(3)
cjstartrar | 6.4.1(3)
cjstartrecover | 6.4.1(2)
cjstartsv | 6.4.1(1)
cjstopapp | 6.4.1(3)
cjstopjb | 6.4.1(3)
cjstoprar | 6.4.1(3)
cjstopsv | 6.4.1(1)
cjstopthread | 6.4.1(3)
cjsuspendpool | 6.4.1(3)
cjtestres | 6.4.1(3)
cjundeployrar | 6.4.1(3)
cjunmapsec | 6.4.1(3)
cjupdateapp | 6.4.1(3)

注※　監査ログが出力されるタイミングについての情報の参照先を示します。

6.3.2　バッチサーバで使用するコマンド一覧

バッチサーバで使用するコマンドのうち，監査ログを出力するコマンドの一覧を次の表に示します。

表6-3　監査ログを出力するコマンドの一覧（バッチサーバで使用するコマンド）

コマンド名 | 監査ログ出力ポイントの参照先※
cjclearpool | 6.4.1(3)
cjcopyres | 6.4.1(3)
cjdeleteres | 6.4.1(3)
cjdeployrar | 6.4.1(3)
cjdumpsv | 6.4.1(2)
cjenvsetup | 6.4.1(2)
cjenvupdate | 6.4.1(2)
cjexecjob | 6.4.2
cjexportrar | 6.4.1(3)
cjgetrarprop | 6.4.1(3)
cjgetresprop | 6.4.1(3)
cjimportres | 6.4.1(3)
cjkilljob | 6.4.2
cjlistpool | 6.4.1(3)
cjlistrar | 6.4.1(3)
cjlistres | 6.4.1(3)
cjlistthread | 6.4.1(3)
cjrarupdate | 6.4.1(2)
cjresetsv | 6.4.1(4)
cjresumepool | 6.4.1(3)
cjsetrarprop | 6.4.1(3)
cjsetresprop | 6.4.1(3)
cjsetup | 6.4.1(2)
cjstartrar | 6.4.1(3)
cjstartrecover | 6.4.1(2)
cjstartsv | 6.4.1(1)
cjstoprar | 6.4.1(3)
cjstopsv | 6.4.1(1)
cjstopthread | 6.4.1(3)
cjsuspendpool | 6.4.1(3)
cjtestres | 6.4.1(3)
cjundeployrar | 6.4.1(3)

注※　監査ログが出力されるタイミングについての情報の参照先を示します。

6.3.3　性能解析トレース・CTMで使用するコマンド一覧

性能解析トレース，およびCTMで使用するコマンドのうち，監査ログを出力するコマンドの一覧を次の表に示します。

表6-4　監査ログを出力するコマンドの一覧（性能解析トレース・CTMで使用するコマンド）

コマンド名 | 監査ログ出力ポイントの参照先※
cprfgetpid | 6.4.3(3)
cprfstart | 6.4.3(1)
cprfstop | 6.4.3(1)
ctmdmstart | 6.4.3(1)
ctmdmstop | 6.4.3(1)
ctmgetpid | 6.4.3(3)
ctmstart | 6.4.3(1)
ctmstop | 6.4.3(1)
ctmstsstart | 6.4.3(2)
ctmstsstop | 6.4.3(2)

注※　監査ログが出力されるタイミングについての情報の参照先を示します。

6.3.4　Management Serverで使用するコマンド一覧

Management Serverで使用するコマンドうち，監査ログを出力するコマンドの一覧を次の表に示します。

表6-5　監査ログを出力するコマンドの一覧（Management Serverで使用するコマンド）

コマンド名（サブコマンド） | 監査ログ出力ポイントの参照先※1
adminagentctl（start） | 6.4.4(3)
adminagentctl（stop） | 6.4.4(3)
cmx_add_serverref | 6.4.4(5)
cmx_admin_passwd | 6.4.4(5)
cmx_build_model | 6.4.4(5)
cmx_build_system※2 | 6.4.4(6)
cmx_change_model | 6.4.4(5)
cmx_define_application | 6.4.4(5)
cmx_define_resource | 6.4.4(5)
cmx_delete_serverref | 6.4.4(5)
cmx_delete_system※2 | 6.4.4(5)
cmx_deploy_application※2 | 6.4.4(5)
cmx_deploy_resource※2 | 6.4.4(5)
cmx_export_model | 6.4.4(4)
cmx_list_model | 6.4.4(4)
cmx_list_status | 6.4.4(4)
cmx_register_application | 6.4.4(5)
cmx_register_resource | 6.4.4(5)
cmx_resume_lb | 6.4.4(5)
cmx_scaleout_host | 6.4.4(5)
cmx_start_application※2 | 6.4.4(4)
cmx_start_resource※2 | 6.4.4(4)
cmx_start_target※2 | 6.4.4(5)
cmx_stop_application※2 | 6.4.4(4)
cmx_stop_resource※2 | 6.4.4(4)
cmx_stop_target※2 | 6.4.4(5)
cmx_test_lb※2 | 6.4.4(4)
cmx_undefine_resource | 6.4.4(5)
cmx_undefined_application | 6.4.4(5)
cmx_undeploy_application※2 | 6.4.4(5)
cmx_undeploy_resource※2 | 6.4.4(5)
cmx_unregister_application | 6.4.4(5)
cmx_unregister_resource | 6.4.4(5)
mngsvrctl（setup） | 6.4.4(1)，6.4.4(5)
mngsvrctl（start）※2 | 6.4.4(2)
mngsvrctl（stop） | 6.4.4(2)
Hitachi Web Serverを操作するコマンド | 6.4.4(7)

注※1　監査ログが出力されるタイミングについての情報の参照先を示します。

注※2　これらのコマンドを実行すると，内部処理のために複数のコマンドが自動で実行される場合があります。監査ログを調査して監査を実施するには，内部処理のために実行されるそれぞれのコマンドが出力する監査ログも調査してください。内部処理のために複数のコマンドが自動で実行されるコマンドと，実行されるコマンドごとの監査ログの出力の可否を次の表に示します。

表6-6　内部処理のために複数のコマンドが自動で実行されるコマンドと実行されるコマンドごとの監査ログの出力の可否

実行するコマンド（サブコマンドまたは引数） | 内部処理で実行されるコマンド（引数） | 監査ログの出力有無
cmx_build_system | mstartupwebsetup | ×
mngsvrssh | ×
mngsvrsetsid※ | ×
cjsetup | ○
hwsserveredit | ○
hwsconfigedit | ○
cmx_delete_system | mngsvrssh | ×
mngsvrsetsid※ | ×
cmx_deploy_application | cjimportapp | ○
cmx_deploy_resource | mappsctl | ×
cmx_deploy_resource（-resname <リソースアダプタ表示名>） | cjimportres | ○
cjsetresprop | ○
cjdeployrar | ○
cmx_deploy_resource（-resname <JavaBeansリソース表示名>） | cjimportjb | ○
cmx_start_application | mappsctl | ×
cjstartapp | ○
cmx_start_resource | mappsctl | ×
cmx_start_resource（-resname <リソースアダプタ表示名>） | cjstartrar | ○
cmx_start_resource（-resname <JavaBeansリソース表示名>） | cjstartjb | ○
cmx_start_target | prfinit | ×
mstartupwebinit | ×
mstartupwebstart | ×
ctdminit | ×
mngsvrssh | ×
mngsvrsetsid※ | ×
cprfstart | ○
cprfgetpid | ○
cjstartsv | ○
httpsd | ○
osagent | ×
nameserv | ×
ctmdmstart | ○
ctmgetpid | ○
ctmstart | ○
cmx_stop_application | mappsctl | ×
cjstopapp | ○
cmx_stop_resource | mappsctl | ×
cmx_stop_resource（-resname <リソースアダプタ表示名>） | cjstoprar | ○
cmx_stop_resource（-resname <JavaBeansリソース表示名>） | cjstopjb | ○
cmx_stop_target | mstartupwebstop | ×
mngsvrssh | ×
mngsvrsetsid※ | ×
cprfstop | ○
cjstopsv | ○
httpsd | ○
ctmdmstop | ○
ctmstop | ○
ctmstsstop | ○
cmx_test_lb | mngsvrssh | ×
mngsvrsetsid※ | ×
cmx_undeploy_application | mappsctl | ×
cjdeleteapp | ○
cmx_undeploy_resource | mappsctl | ×
cmx_undeploy_resource（-resname <リソースアダプタ表示名>） | cjundeployrar | ○
cjdeleteres | ○
cmx_undeploy_resource（-resname <JavaBeansリソース表示名>） | cjdeletejb | ○
mngsvrctl（start） | mngsvrctl（setup） | ○

注※　UNIXの場合にだけ内部処理のために実行されるコマンドです。

6.3.5　EJBクライアントアプリケーションで使用するコマンド一覧

EJBクライアントアプリケーションで使用するコマンドのうち，監査ログを出力するコマンドの一覧を次の表に示します。

表6-7　監査ログを出力するコマンドの一覧（EJBクライアントアプリケーションで使用するコマンド）

コマンド名 | 監査ログ出力ポイントの参照先※
cjcldellog | 6.4.5
cjcldumpap | 6.4.5
cjclstartap | 6.4.5

注※　監査ログが出力されるタイミングについての情報の参照先を示します。

6.3.6　Hitachi Web Serverで使用するコマンド・操作一覧（Windowsの場合）

Windowsの場合のHitachi Web Serverで使用するコマンドおよび操作のうち，監査ログを出力するコマンドおよび操作の一覧を次の表に示します。

表6-8　監査ログを出力するコマンド・操作の一覧（Windowsの場合のHitachi Web Serverで使用するコマンド・操作）

コマンド名（オプション），操作 | 監査ログ出力ポイントの参照先※
httpsd（-k gracefulstop） | 6.4.6(1)
httpsd（-k restart） | 6.4.6(1)
httpsd（-k start） | 6.4.6(1)
httpsd（-k stop） | 6.4.6(1)
コントロールパネルによる操作 | 6.4.6(2)

注※　監査ログが出力されるタイミングについての情報の参照先を示します。

6.3.7　Hitachi Web Serverで使用するコマンド・操作一覧（UNIXの場合）

UNIXの場合のHitachi Web Serverで使用するコマンドおよび操作のうち，監査ログを出力するコマンドおよび操作の一覧を次の表に示します。

表6-9　監査ログを出力するコマンド・操作の一覧（UNIXの場合のHitachi Web Serverで使用するコマンド・操作）

コマンド名，操作 | 監査ログ出力ポイントの参照先※1
httpsd※2 | 6.4.7(2)
httpsdctlによる操作 | 6.4.7(1)
シグナル送信による操作 | 6.4.7(3)

注※1　監査ログが出力されるタイミングについての情報の参照先を示します。

注※2　コマンドを直接実行した場合です。

6.4　監査ログの出力ポイント

ここでは，監査ログを出力するコマンド・操作を実行したとき，およびそのコマンド・操作による処理が実行されたときの，監査ログが出力されるポイントについて説明します。

ここでは，コマンドおよび操作を次の分類に分けて，それぞれのコマンドで監査ログを出力するポイントについて説明します。

J2EEサーバで使用するコマンド

性能解析トレース・CTMで使用するコマンド

Management Serverで使用するコマンド

EJBクライアントアプリケーションで使用するコマンド

Hitachi Web Serverで使用するコマンド

＜この節の構成＞

6.4.1　J2EEサーバで使用するコマンドの監査ログの出力ポイント

6.4.2　バッチサーバで使用するコマンドの監査ログの出力ポイント

6.4.3　性能解析トレース・CTMで使用するコマンドの監査ログの出力ポイント

6.4.4　Management Serverで使用するコマンドの監査ログの出力ポイント

6.4.5　EJBクライアントアプリケーションで使用するコマンドの監査ログの出力ポイント

6.4.6　Hitachi Web Serverで使用するコマンド，およびHitachi Web Serverに対する操作の監査ログの出力ポイント（Windowsの場合）

6.4.7　Hitachi Web Serverで使用するコマンド，およびHitachi Web Serverに対する操作の監査ログの出力ポイント（UNIXの場合）

6.4.1　J2EEサーバで使用するコマンドの監査ログの出力ポイント

J2EEサーバで使用するコマンドの監査ログの出力ポイントについて説明します。

＜この項の構成＞

(1)　サーバプロセスを起動・停止するコマンド（サーバ管理コマンド以外）

(2)　サーバプロセスを起動・停止するコマンド以外のコマンド（サーバ管理コマンド以外）

(3)　サーバ管理コマンド（cjresetsv以外のサーバ管理コマンド）

(4)　サーバ管理コマンド（cjresetsv）

(1)　サーバプロセスを起動・停止するコマンド（サーバ管理コマンド以外）

サーバプロセスを起動・停止する，サーバ管理コマンド以外のコマンドの監査ログの出力ポイントを次の図に示します。

図6-1　監査ログの出力ポイント（サーバプロセスを起動・停止するサーバ管理コマンド以外のコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-10　監査ログの出力ポイントとメッセージIDの対応（サーバプロセスを起動・停止するサーバ管理コマンド以外のコマンド）

コマンド（オプション） | 図中の番号 | 出力される監査ログのメッセージID
cjstartsv | 1 | KDJE54112-I
2 | KDJE54113-I
7 | KDJE54126-I
KDJE54127-E
8 | KDJE54114-I
KDJE54115-E
cjstopsv（-wait） | 3 | KDJE54116-I
6 | KDJE54117-I
KDJE54118-E
9 | KDJE54119-W
cjstopsv（-f，または-fd） | 3 | KDJE54116-I
6 | KDJE54117-I
KDJE54118-E
cjstopsv（-wait -f，または-wait -fd） | 3 | KDJE54116-I
6 | KDJE54117-I
KDJE54118-E
9 | KDJE54119-W
10 | KDJE54117-I
KDJE54118-E
cjstopsv（-wait，-f，-fd，-wait -f，および-wait -fd以外のオプション） | 3 | KDJE54116-I
6 | KDJE54117-I
KDJE54118-E
－※1 | 4 | KDJE54138-I
5 | KDJE54139-I
KDJE54140-E
－※2 | KDJE54155-E

注※1　この表で示しているすべてのコマンドに共通で出力されるメッセージです。ただし，-f，および-fd以外のオプションを指定してコマンドを実行した場合に限ります。

注※2　この表で示しているコマンドを実行して，メモリ不足が発生した場合に出力されることがあります。

(2)　サーバプロセスを起動・停止するコマンド以外のコマンド（サーバ管理コマンド以外）

サーバプロセスを起動・停止するサーバ管理コマンド以外のコマンドの監査ログの出力ポイントを次の図に示します。

図6-2　監査ログの出力ポイント（サーバプロセスを起動・停止するサーバ管理コマンド以外のコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-11　監査ログの出力ポイントとメッセージIDの対応（サーバプロセスを起動・停止するサーバ管理コマンド以外のコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
cjsetup | 1 | KDJE54100-I
2 | KDJE54101-I
KDJE54102-E
cjenvsetup | 1 | KDJE54103-I
2 | KDJE54104-I
KDJE54105-E
cjenvupdate | 1 | KDJE54106-I
2 | KDJE54107-I
KDJE54108-E
cjrarupdate | 1 | KDJE54109-I
2 | KDJE54110-I
KDJE54111-E
cjstartrecover※1 | 1 | KDJE54120-I
2 | KDJE54121-I
KDJE54122-E
cjdumpsv | 1 | KDJE54123-I
2 | KDJE54124-I
KDJE54125-E
－ | －※2 | KDJE54155-E

注※1　cjstartrecoverコマンドは，内部処理でcjstartsvコマンドを実行します。そのため，cjstartrecoverコマンド実行時にはcjstartsvコマンドの監査ログも出力されます。

注※2　この表で示しているコマンドを実行して，メモリ不足が発生した場合に出力されることがあります。

(3)　サーバ管理コマンド（cjresetsv以外のサーバ管理コマンド）

サーバ管理コマンド（cjresetsv以外のサーバ管理コマンド）の監査ログの出力ポイントを次の図に示します。

図6-3　監査ログの出力ポイント（cjresetsv以外のサーバ管理コマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-12　監査ログの出力ポイントとメッセージIDの対応（cjresetsv以外のサーバ管理コマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID | 動作情報
cjaddapp | 3 | KDJE54424-I | Add
4 | KDJE54425-I
KDJE54426-E
5 | KDJE54427-E
cjaddsec | 3 | KDJE54576-I
4 | KDJE54577-I
KDJE54578-E
5 | KDJE54579-E
cjchmodapp | 3 | KDJE54608-I | Update
4 | KDJE54609-I
KDJE54610-E
5 | KDJE54611-E
cjclearpool | 3 | KDJE54600-I | Delete
4 | KDJE54601-I
KDJE54602-E
5 | KDJE54603-E
cjclosecn | 3 | KDJE54604-I
4 | KDJE54605-I
KDJE54606-E
5 | KDJE54607-E
cjcopyres | 3 | KDJE54476-I | Add
4 | KDJE54477-I
KDJE54478-E
5 | KDJE54479-E
cjdeleteapp | 3 | KDJE54428-I | Delete
4 | KDJE54429-I
KDJE54430-E
5 | KDJE54431-E
cjdeletejb | 3 | KDJE54440-I
4 | KDJE54441-I
KDJE54442-E
5 | KDJE54443-E
cjdeletelibjar | 3 | KDJE54436-I
4 | KDJE54437-I
KDJE54438-E
5 | KDJE54439-E
cjdeleteres | 3 | KDJE54432-I
4 | KDJE54433-I
KDJE54434-E
5 | KDJE54435-E
cjdeletesec | 3 | KDJE54580-I
4 | KDJE54581-I
KDJE54582-E
5 | KDJE54583-E
cjdeployrar | 3 | KDJE54568-I | Update
4 | KDJE54569-I
KDJE54570-E
5 | KDJE54571-E
cjexportapp | 3 | KDJE54416-I | Refer
4 | KDJE54417-I
KDJE54418-E
5 | KDJE54419-E
cjexportrar | 3 | KDJE54420-I
4 | KDJE54421-I
KDJE54422-E
5 | KDJE54423-E
cjgencmpsql | 3 | KDJE54620-I | Update
4 | KDJE54621-I
KDJE54622-E
5 | KDJE54623-E
cjgetappprop | 3 | KDJE54444-I | Refer
4 | KDJE54445-I
KDJE54446-E
5 | KDJE54447-E
cjgetjbprop | 3 | KDJE54456-I
4 | KDJE54457-I
KDJE54458-E
5 | KDJE54459-E
cjgetrarprop | 3 | KDJE54452-I
4 | KDJE54453-I
KDJE54454-E
5 | KDJE54455-E
cjgetresprop | 3 | KDJE54448-I
4 | KDJE54449-I
KDJE54450-E
5 | KDJE54451-E
cjgetstubsjar | 3 | KDJE54612-I
4 | KDJE54613-I
KDJE54614-E
5 | KDJE54615-E
cjimportapp | 3 | KDJE54400-I | Add
4 | KDJE54401-I
KDJE54402-E
5 | KDJE54403-E
cjimportjb | 3 | KDJE54412-I
4 | KDJE54413-I
KDJE54414-E
5 | KDJE54415-E
cjimportlibjar | 3 | KDJE54408-I
4 | KDJE54409-I
KDJE54410-E
5 | KDJE54411-E
cjimportres | 3 | KDJE54404-I
4 | KDJE54405-I
KDJE54406-E
5 | KDJE54407-E
cjlistapp | 3 | KDJE54480-I | Refer
4 | KDJE54481-I
KDJE54482-E
5 | KDJE54483-E
cjlistjb | 3 | KDJE54512-I
4 | KDJE54513-I
KDJE54514-E
5 | KDJE54515-E
cjlistlibjar | 3 | KDJE54492-I
4 | KDJE54493-I
KDJE54494-E
5 | KDJE54495-E
cjlistpool | 3 | KDJE54508-I
4 | KDJE54509-I
KDJE54510-E
5 | KDJE54511-E
cjlistrar | 3 | KDJE54488-I
4 | KDJE54489-I
KDJE54490-E
5 | KDJE54491-E
cjlistres | 3 | KDJE54484-I
4 | KDJE54485-I
KDJE54486-E
5 | KDJE54487-E
cjlistsec | 3 | KDJE54584-I
4 | KDJE54585-I
KDJE54586-E
5 | KDJE54587-E
cjlistthread | 3 | KDJE54496-I
4 | KDJE54497-I
KDJE54498-E
5 | KDJE54499-E
cjlisttrn | 3 | KDJE54500-I
4 | KDJE54501-I
KDJE54502-E
5 | KDJE54503-E
cjlisttrnfile | 3 | KDJE54504-I
4 | KDJE54505-I
KDJE54506-E
5 | KDJE54507-E
cjmapsec | 3 | KDJE54588-I | Update
4 | KDJE54589-I
KDJE54590-E
5 | KDJE54591-E
cjreloadapp | 3 | KDJE54556-I
4 | KDJE54557-I
KDJE54558-E
5 | KDJE54559-E
cjrenameapp | 3 | KDJE54616-I
4 | KDJE54617-I
KDJE54618-E
5 | KDJE54619-E
cjreplaceapp | 3 | KDJE54536-I
4 | KDJE54537-I
KDJE54538-E
5 | KDJE54539-E
cjresumepool | 3 | KDJE54564-I | Start
4 | KDJE54565-I
KDJE54566-E
5 | KDJE54567-E
cjsetappprop | 3 | KDJE54460-I | Update
4 | KDJE54461-I
KDJE54462-E
5 | KDJE54463-E
cjsetjbprop | 3 | KDJE54472-I
4 | KDJE54473-I
KDJE54474-E
5 | KDJE54475-E
cjsetrarprop | 3 | KDJE54468-I
4 | KDJE54469-I
KDJE54470-E
5 | KDJE54471-E
cjsetresprop | 3 | KDJE54464-I
4 | KDJE54465-I
KDJE54466-E
5 | KDJE54467-E
cjstartapp | 3 | KDJE54520-I | Start
4 | KDJE54521-I
KDJE54522-E
5 | KDJE54523-E
cjstartjb | 3 | KDJE54548-I
4 | KDJE54549-I
KDJE54550-E
5 | KDJE54551-E
cjstartrar | 3 | KDJE54528-I
4 | KDJE54529-I
KDJE54530-E
5 | KDJE54531-E
cjstopapp | 3 | KDJE54524-I | Stop
4 | KDJE54525-I
KDJE54526-E
5 | KDJE54527-E
cjstopjb | 3 | KDJE54552-I
4 | KDJE54553-I
KDJE54554-E
5 | KDJE54555-E
cjstoprar | 3 | KDJE54532-I
4 | KDJE54533-I
KDJE54534-E
5 | KDJE54535-E
cjstopthread | 3 | KDJE54544-I
4 | KDJE54545-I
KDJE54546-E
5 | KDJE54547-E
cjsuspendpool | 3 | KDJE54560-I
4 | KDJE54561-I
KDJE54562-E
5 | KDJE54563-E
cjtestres | 3 | KDJE54516-I | Refer
4 | KDJE54517-I
KDJE54518-E
5 | KDJE54519-E
cjundeployrar | 3 | KDJE54572-I | Update
4 | KDJE54573-I
KDJE54574-E
5 | KDJE54575-E
cjunmapsec | 3 | KDJE54592-I
4 | KDJE54593-I
KDJE54594-E
5 | KDJE54595-E
cjupdateapp | 3 | KDJE54540-I
4 | KDJE54541-I
KDJE54542-E
5 | KDJE54543-E

なお，それぞれのコマンドが出力する監査ログの動作情報ごとに，図中の「1」，「2」，「6」および「7」で出力されるメッセージが異なります。動作情報と図中の「1」，「2」，「6」および「7」で出力されるメッセージIDの対応を次の表に示します。

表6-13　動作情報とメッセージIDの対応（cjresetsv以外のサーバ管理コマンド）

動作情報 | 図中の番号 | メッセージID
Start | 1 | KDJE54624-I
2 | KDJE54141-I
6 | KDJE54142-I
7 | KDJE54625-I
KDJE54626-E
Stop | 1 | KDJE54627-I
2 | KDJE54143-I
6 | KDJE54144-I
7 | KDJE54628-I
KDJE54629-E
Refer | 1 | KDJE54630-I
2 | KDJE54145-I
6 | KDJE54146-I
7 | KDJE54631-I
KDJE54632-E
Add | 1 | KDJE54633-I
2 | KDJE54147-I
6 | KDJE54148-I
7 | KDJE54634-I
KDJE54635-E
Update | 1 | KDJE54636-I
2 | KDJE54149-I
6 | KDJE54150-I
7 | KDJE54637-I
KDJE54638-E
Delete | 1 | KDJE54639-I
2 | KDJE54151-I
6 | KDJE54152-I
7 | KDJE54640-I
KDJE54641-E

(4)　サーバ管理コマンド（cjresetsv）

サーバ管理コマンド（cjresetsv）の監査ログの出力ポイントを次の図に示します。

図6-4　監査ログの出力ポイント（cjresetsv）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-14　監査ログの出力ポイントとメッセージIDの対応（cjresetsv）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
cjresetsv | 1 | KDJE54642-I
2 | KDJE54596-I
3 | KDJE54153-I
4 | KDJE54154-I
5 | KDJE54597-I
KDJE54598-E
6 | KDJE54599-E
7 | KDJE54643-I
KDJE54644-E

6.4.2　バッチサーバで使用するコマンドの監査ログの出力ポイント

バッチサーバで使用するコマンドの監査ログの出力ポイントについて説明します。

ここでは，バッチサーバで使用するコマンドのうち，cjexecjobコマンド，およびcjkilljobコマンドの監査ログの出力ポイントについて説明します。

バッチサーバで使用するそのほかのコマンドについては，「6.4.1　J2EEサーバで使用するコマンドの監査ログの出力ポイント」の次の表に示した個所を参照してください。

表6-15　バッチサーバで使用するそのほかのコマンドの参照先

バッチサーバで使用するコマンド | 参照先
サーバプロセスを起動・停止するコマンド（サーバ管理コマンド以外） | 6.4.1(1)
サーバプロセスを起動・停止するコマンド以外のコマンド（サーバ管理コマンド以外） | 6.4.1(2)
サーバ管理コマンド（cjresetsv以外のサーバ管理コマンド）※ | 6.4.1(3)
サーバ管理コマンド（cjresetsv） | 6.4.1(4)

注※　「6.4.1(3)　サーバ管理コマンド（cjresetsv以外のサーバ管理コマンド）」で説明しているコマンドのうち，バッチサーバで使用できるのは次のコマンドだけです。

cjclearpool，cjcopyres，cjdeleteres，cjdeployrar，cjexportapp，cjexportrar，cjgetrarprop，cjgetresprop，cjimportres，cjlistpool，cjlistrar，cjlistres，cjlistthread，cjresumepool，cjsetrarprop，cjsetresprop，cjstartrar，cjstoprar，cjstopthread，cjsuspendpool，cjtestres，cjundeployrar，cjunmapsec

cjexecjobコマンド，およびcjkilljobコマンドの監査ログの出力ポイントを次の図に示します。

図6-5　監査ログの出力ポイント（cjexecjobコマンド，およびcjkilljobコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-16　監査ログの出力ポイントとメッセージIDの対応（cjexecjobコマンド，およびcjkilljobコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
cjexecjob | 1 | KDJE54156-I
4 | KDJE54157-I
KDJE54158-E※1
cjkilljob | 1 | KDJE54162-I
4 | KDJE54163-I
KDJE54164-W
cjstartsv（cjexecjobコマンド実行時） | 2 | KDJE54159-I
3 | KDJE54160-I
KDJE54161-E※2
cjstartsv（cjkilljobコマンド実行時） | 2 | KDJE54165-I
3 | KDJE54166-I
KDJE54167-E

注※1　KDJE54158-Eは次の場合に出力されます。

指定したサーバが見つからないなどの原因でバッチの実行に失敗した場合

バッチの実行時，0以外の終了コードが出力された場合

注※2　KDJE54161-Eは次の場合に出力されます。

mainメソッドが見つからないなどの原因でバッチの実行に失敗した場合

バッチの実行時，0以外の終了コードが出力された場合

6.4.3　性能解析トレース・CTMで使用するコマンドの監査ログの出力ポイント

性能解析トレース・CTMで使用するコマンドの監査ログの出力ポイントについて説明します。

＜この項の構成＞

(1)　サーバプロセスを起動・停止するコマンド

(2)　プロセスへの通信・共有メモリへのアクセスを実行するコマンド

(3)　情報を参照するコマンド

(1)　サーバプロセスを起動・停止するコマンド

サーバプロセス(デーモン)を起動・停止するコマンドの監査ログの出力ポイントを次の図に示します。

図6-6　監査ログの出力ポイント（サーバプロセスを起動・停止するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-17　監査ログの出力ポイントとメッセージIDの対応（サーバプロセスを起動・停止するコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
cprfstart | 1 | KFCT81000-I
4 | KFCT81001-I
KFCT81002-E
cprfstop | 1 | KFCT81020-I
4 | KFCT81021-I
KFCT81022-E
ctmdmstart | 1 | KFCT91000-I
4 | KFCT91001-I
KFCT91002-E
ctmdmstop | 1 | KFCT91020-I
4 | KFCT91021-I
KFCT91022-E
ctmstart | 1 | KFCT91040-I
4 | KFCT91041-I
KFCT91042-E
ctmstop | 1 | KFCT91060-I
4 | KFCT91061-I
KFCT91062-E

なお，それぞれのコマンドがリクエストを送信するサーバプロセス（デーモン）ごとに，図中の「2」および「3」で出力されるメッセージが異なります。サーバプロセスの種類と図中の「2」および「3」で出力されるメッセージIDの対応を次の表に示します。

表6-18　サーバプロセス（デーモン）の種類とメッセージIDの対応（サーバプロセスを起動・停止するコマンド）

サーバプロセス（デーモン） | 図中の番号 | メッセージID
PRFデーモン | 2 | KFCT81010-I
KFCT81030-I
3 | KFCT81011-I
KFCT81012-E
KFCT81031-I
KFCT81032-E
CTMドメインマネジャ | 2 | KFCT91010-I
KFCT91030-I
3 | KFCT91011-I
KFCT91012-E
KFCT91031-I
KFCT91032-E
CTMデーモン | 2 | KFCT91050-I
KFCT91070-I
3 | KFCT91051-I
KFCT91052-E
KFCT91071-I
KFCT91072-E

(2)　プロセスへの通信・共有メモリへのアクセスを実行するコマンド

プロセスへの通信・共有メモリへのアクセスを実行するコマンドの監査ログの出力ポイントを次の図に示します。

図6-7　監査ログの出力ポイント（プロセスへの通信・共有メモリへのアクセスを実行するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-19　監査ログの出力ポイントとメッセージIDの対応（プロセスへの通信・共有メモリへのアクセスを実行するコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
ctmstsstart | 1 | KFCT91080-I
3 | KFCT91081-I
KFCT91082-E
ctmstsstop | 1 | KFCT91100-I
3 | KFCT91101-I
KFCT91102-E
－※ | 2 | KFCT91091-I
KFCT91111-I

注※　この表で示しているすべてのコマンドに共通で出力されるメッセージです。

(3)　情報を参照するコマンド

情報を参照するコマンドの監査ログの出力ポイントを次の図に示します。

図6-8　監査ログの出力ポイント（情報を参照するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-20　監査ログの出力ポイントとメッセージIDの対応（情報を参照するコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
cprfgetpid | 1 | KFCT84000-I
2 | KFCT84001-I
KFCT84002-E
ctmgetpid | 1 | KFCT94000-I
2 | KFCT94001-I
KFCT94002-E

6.4.4　Management Serverで使用するコマンドの監査ログの出力ポイント

Management Serverで使用するコマンドの監査ログの出力ポイントについて説明します。

＜この項の構成＞

(1)　Management Serverのセットアップコマンド

(2)　Management Serverを起動・停止するコマンド

(3)　運用管理エージェントの起動・停止を実行するコマンド

(4)　Management Serverによる承認処理を実行するコマンド

(5)　Management Serverによるファイル操作を実行するコマンド

(6)　Management Server・運用管理エージェントによるファイル操作を実行するコマンド

(7)　Hitachi Web Serverを操作するコマンド

(1)　Management Serverのセットアップコマンド

Management Serverのセットアップコマンドの監査ログの出力ポイントを次の図に示します。

図6-9　監査ログの出力ポイント（Management Serverのセットアップコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-21　監査ログの出力ポイントとメッセージIDの対応（Management Serverのセットアップコマンド）

コマンド（オプション） | 図中の番号 | 出力される監査ログのメッセージID
mngsvrctl（setup） | 1 | KEOS80006-I
2 | KEOS80007-I
KEOS80008-E

(2)　Management Serverを起動・停止するコマンド

Management Serverを起動・停止するコマンドの監査ログの出力ポイントを次の図に示します。

図6-10　監査ログの出力ポイント（Management Serverを起動・停止するコマンドコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-22　監査ログの出力ポイントとメッセージIDの対応（Management Serverを起動・停止するコマンド）

コマンド（サブコマンド） | 図中の番号 | 出力される監査ログのメッセージID
mngsvrctl（start） | 1 | KEOS80000-I
2 | KEOS80108-I
3 | KEOS80109-I
KEOS80110-E
4 | KEOS80001-I
KEOS80002-E
mngsvrctl（stop） | 1 | KEOS80003-I
2 | KEOS80111-I
3 | KEOS80112-I
KEOS80113-E
4 | KEOS80004-I
KEOS80005-E

(3)　運用管理エージェントの起動・停止を実行するコマンド

運用管理エージェントの起動・停止の監査ログの出力ポイントを次の図に示します。

図6-11　監査ログの出力ポイント（運用管理エージェントの起動・停止）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-23　監査ログの出力ポイントとメッセージIDの対応（運用管理エージェントの起動・停止）

コマンド（サブコマンド） | 図中の番号 | 出力される監査ログのメッセージID
adminagentctl（start） | 1 | KEOS80009-I
2 | KEOS80114-I
3 | KEOS80115-I
KEOS80116-E
4 | KEOS80010-I
KEOS80011-E
adminagentctl（stop） | 1 | KEOS80012-I
2 | KEOS80117-I
3 | KEOS80118-I
KEOS80119-E
4 | KEOS80013-I
KEOS80014-E

(4)　Management Serverによる承認処理を実行するコマンド

Management Serverによる承認処理を実行するコマンドの監査ログの出力ポイントを次の図に示します。

図6-12　監査ログの出力ポイント（Management Serverによる承認処理を実行するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-24　監査ログの出力ポイントとメッセージIDの対応（Management Serverによる承認処理を実行するコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
cmx_test_lb | 1 | KEOS80036-I
4 | KEOS80037-I
KEOS80038-E
cmx_list_status | 1 | KEOS80045-I
4 | KEOS80046-I
KEOS80047-E
cmx_start_resource | 1 | KEOS80063-I
4 | KEOS80064-I
KEOS80065-E
cmx_stop_resource | 1 | KEOS80066-I
4 | KEOS80067-I
KEOS80068-E
cmx_start_application | 1 | KEOS80087-I
4 | KEOS80088-I
KEOS80089-E
cmx_stop_application | 1 | KEOS80090-I
4 | KEOS80091-I
KEOS80092-E
cmx_list_model | 1 | KEOS80102-I
4 | KEOS80103-I
KEOS80104-E
cmx_export_model | 1 | KEOS80105-I
4 | KEOS80106-I
KEOS80107-E
－※ | 2 | KEOS80120-I
3 | KEOS80121-I
KEOS80122-E

注※　この表で示しているすべてのコマンドに共通で出力されるメッセージです。

(5)　Management Serverによるファイル操作を実行するコマンド

Management Serverによるファイル操作を実行するコマンドの監査ログの出力ポイントを次の図に示します。

図6-13　監査ログの出力ポイント（Management Serverによるファイル操作を実行するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-25　監査ログの出力ポイントとメッセージIDの対応（Management Serverによるファイル操作を実行するコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
mngsvrctl setup | 1 | KEOS80006-I
6 | KEOS80007-I
KEOS80008-E
cmx_admin_passwd | 1 | KEOS80015-I
6 | KEOS80016-I
KEOS80017-E
cmx_build_model | 1 | KEOS80018-I
6 | KEOS80019-I
KEOS80020-E
cmx_change_model | 1 | KEOS80024-I
6 | KEOS80025-I
KEOS80026-E
cmx_delete_system | 1 | KEOS80027-I
6 | KEOS80028-I
KEOS80029-E
cmx_resume_lb | 1 | KEOS80030-I
6 | KEOS80031-I
KEOS80032-E
cmx_scaleout_host | 1 | KEOS80033-I
6 | KEOS80034-I
KEOS80035-E
cmx_add_serverref | 1 | KEOS80039-I
6 | KEOS80040-I
KEOS80041-E
cmx_delete_serverref | 1 | KEOS80042-I
6 | KEOS80043-I
KEOS80044-E
cmx_start_target | 1 | KEOS80048-I
6 | KEOS80049-I
KEOS80050-E
cmx_stop_target | 1 | KEOS80051-I
6 | KEOS80052-I
KEOS80053-E
cmx_define_resource | 1 | KEOS80054-I
6 | KEOS80055-I
KEOS80056-E
cmx_deploy_resource | 1 | KEOS80057-I
6 | KEOS80058-I
KEOS80059-E
cmx_register_resource | 1 | KEOS80060-I
6 | KEOS80061-I
KEOS80062-E
cmx_undefine_resource | 1 | KEOS80069-I
6 | KEOS80070-I
KEOS80071-E
cmx_undeploy_resource | 1 | KEOS80072-I
6 | KEOS80073-I
KEOS80074-E
cmx_unregister_resource | 1 | KEOS80075-I
6 | KEOS80076-I
KEOS80077-E
cmx_define_application | 1 | KEOS80078-I
6 | KEOS80079-I
KEOS80080-E
cmx_deploy_application | 1 | KEOS80081-I
6 | KEOS80082-I
KEOS80083-E
cmx_register_application | 1 | KEOS80084-I
6 | KEOS80085-I
KEOS80086-E
cmx_undefined_application | 1 | KEOS80093-I
6 | KEOS80094-I
KEOS80095-E
cmx_undeploy_application | 1 | KEOS80096-I
6 | KEOS80097-I
KEOS80098-E
cmx_unregister_application | 1 | KEOS80099-I
6 | KEOS80100-I
KEOS80101-E
－※ | 2 | KEOS80120-I
3 | KEOS80121-I
KEOS80122-E
4 | KEOS80123-I
5 | KEOS80124-I
KEOS80125-E

注※　この表で示しているすべてのコマンドに共通で出力されるメッセージです。

(6)　Management Server・運用管理エージェントによるファイル操作を実行するコマンド

Management Server・運用管理エージェントによるファイル操作を実行するコマンドの監査ログの出力ポイントを次の図に示します。

図6-14　監査ログの出力ポイント（Management Server・運用管理エージェントによるファイル操作を実行するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-26　監査ログの出力ポイントとメッセージIDの対応（Management Server・運用管理エージェントによるファイル操作を実行するコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
cmx_build_system | 1 | KEOS80021-I
2 | KEOS80120-I
3 | KEOS80121-I
KEOS80122-E
4 | KEOS80123-I
6 | KEOS80124-I
KEOS80125-E
8 | KEOS80022-I
KEOS80023-E

なお，それぞれのコマンドが操作を実行するファイルごとに，図中の「5」および「7」で出力されるメッセージが異なります。操作を実行するファイルと図中の「5」および「7」で出力されるメッセージIDの対応を次の表に示します。

表6-27　操作を実行するファイルと出力されるメッセージIDの対応

操作を実行するファイル | 図中の番号 | 出力される監査ログのメッセージID
運用監視エージェントの設定ファイル | 5 | KEOS80126-I
7 | KEOS80127-I
KEOS80128-E
J2EEサーバ用JP1イベント発行用プロパティファイル | 5 | KEOS80129-I
7 | KEOS80130-I
KEOS80131-E
Managementイベント発行用プロパティファイル | 5 | KEOS80132-I
7 | KEOS80133-I
KEOS80134-E
J2EEサーバ用ユーザプロパティファイル | 5 | KEOS80135-I
7 | KEOS80136-I
KEOS80137-E
J2EEサーバ用オプション定義ファイル | 5 | KEOS80138-I
7 | KEOS80139-I
KEOS80140-E
Hitachi Web Server用リダイレクタ動作定義ファイル | 5 | KEOS80144-I
7 | KEOS80145-I
KEOS80146-E
ワーカ定義ファイル | 5 | KEOS80147-I
7 | KEOS80148-I
KEOS80149-E

(7)　Hitachi Web Serverを操作するコマンド

Hitachi Web Serverを操作するコマンドの監査ログの出力ポイントを次の図に示します。

図6-15　監査ログの出力ポイント（Hitachi Web Serverを操作するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-28　監査ログの出力ポイントとメッセージIDの対応（Hitachi Web Serverを操作するコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
設定ファイル編集コマンド | 1 | KAWS10501-I
2 | KAWS10502-I
KAWS10503-E
1 | KAWS10504-I
2 | KAWS10505-I
KAWS10506-E
hwsserveredit | 1 | KAWS10601-I
2 | KAWS10602-I
KAWS10603-E
1 | KAWS10604-I
2 | KAWS10605-I
KAWS10606-E
1 | KAWS10607-I
2 | KAWS10608-I
KAWS10609-E

6.4.5　EJBクライアントアプリケーションで使用するコマンドの監査ログの出力ポイント

EJBクライアントアプリケーションで使用するコマンドの監査ログの出力ポイントについて説明します。

図6-16　監査ログの出力ポイント（EJBクライアントアプリケーションで使用するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-29　監査ログの出力ポイントとメッセージIDの対応（EJBクライアントアプリケーションで使用するコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
cjclstartap | 1 | KDJE54129-I
2 | KDJE54130-I
KDJE54131-E※
cjcldumpap | 1 | KDJE54132-I
2 | KDJE54133-I
KDJE54134-E
cjcldellog | 1 | KDJE54135-I
2 | KDJE54136-I
KDJE54137-E

注※　KDJE54131-Eは次の場合に出力されます。

JavaVMの初期化など，コマンドの内部処理が失敗した場合

Javaアプリケーションの実行後に終了コードが0以外の場合

6.4.6　Hitachi Web Serverで使用するコマンド，およびHitachi Web Serverに対する操作の監査ログの出力ポイント（Windowsの場合）

Windowsの場合のHitachi Web Serverで使用するコマンドおよびHitachi Web Serverに対する操作の監査ログの出力ポイントについて説明します。

＜この項の構成＞

(1)　Hitachi Web Serverの起動・停止を実行するコマンド

(2)　Hitachi Web Serverの起動・停止を実行する操作（コントロールパネルから）

(1)　Hitachi Web Serverの起動・停止を実行するコマンド

Hitachi Web Serverの起動・停止を実行するコマンドの監査ログの出力ポイントを次の図に示します。

図6-17　監査ログの出力ポイント（Hitachi Web Serverの起動・停止を実行するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-30　監査ログの出力ポイントとメッセージIDの対応（Hitachi Web Serverの起動・停止を実行するコマンド）

コマンド（オプション） | 図中の番号 | 出力される監査ログのメッセージID
httpsd（-k start） | 1 | KAWS10001-I
2 | KAWS10004-I
3 | KAWS10005-I
KAWS10006-E
4 | KAWS10002-I
KAWS10003-E
httpsd（-k stop） | 1 | KAWS10010-I
2 | KAWS10013-I
3 | KAWS10014-I
KAWS10015-E
4 | KAWS10011-I
KAWS10012-E
httpsd（-k restart） | 1 | KAWS10019-I
2 | KAWS10022-I
3 | KAWS10023-I
KAWS10024-E
4 | KAWS10020-I
KAWS10021-E
httpsd（-k gracefulstop） | 1 | KAWS10025-I
2 | KAWS10028-I
3 | KAWS10029-I
KAWS10030-E
4 | KAWS10026-I
KAWS10027-E

(2)　Hitachi Web Serverの起動・停止を実行する操作（コントロールパネルから）

コントロールパネルからHitachi Web Serverの起動・停止を実行する操作の監査ログの出力ポイントを次の図に示します。

図6-18　監査ログの出力ポイント（コントロールパネルからHitachi Web Serverの起動・停止を実行する操作）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-31　監査ログの出力ポイントとメッセージIDの対応（コントロールパネルからHitachi Web Serverの起動・停止を実行する操作）

図中の番号 | 出力される監査ログのメッセージID
1 | KAWS10004-I
KAWS10007-I
KAWS10013-I
KAWS10016-I
2 | KAWS10005-I
KAWS10006-E
KAWS10008-I
KAWS10009-E
KAWS10014-I
KAWS10015-E
KAWS10017-I
KAWS10018-E

6.4.7　Hitachi Web Serverで使用するコマンド，およびHitachi Web Serverに対する操作の監査ログの出力ポイント（UNIXの場合）

UNIXの場合のHitachi Web Serverで使用するコマンドおよびHitachi Web Serverに対する操作の監査ログの出力ポイントについて説明します。

＜この項の構成＞

(1)　Hitachi Web Serverの起動・停止を実行するコマンド（httpsdctlユティリティから）

(2)　httpsdコマンド（コマンドの直接実行）

(3)　シグナル送信によるデーモンプロセスの操作

(1)　Hitachi Web Serverの起動・停止を実行するコマンド（httpsdctlユティリティから）

httpsdctlユティリティからHitachi Web Serverの起動・停止を実行するコマンドの監査ログの出力ポイントを次の図に示します。

図6-19　監査ログの出力ポイント（httpsdctlユティリティからHitachi Web Serverの起動・停止を実行するコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-32　監査ログの出力ポイントとメッセージIDの対応（httpsdctlユティリティからHitachi Web Serverの起動・停止を実行するコマンド）

コマンド（httpsdctlユティリティの操作） | 図中の番号 | 出力される監査ログのメッセージID
httpsd（httpsdctl start） | 1 | KAWS10101-I
2 | KAWS10102-I
KAWS10103-E
3 | KAWS10151-I
4 | KAWS10152-I
KAWS10153-E
httpsd（httpsdctl restart） | 1 | KAWS10104-I
2 | KAWS10105-I
KAWS10106-E
KAWS10116-I
KAWS10117-E
3 | KAWS10154-I
4 | KAWS10155-I
KAWS10156-E
httpsd（httpsdctl graceful） | 1 | KAWS10107-I
2 | KAWS10108-I
KAWS10109-E
KAWS10118-I
KAWS10119-E
3 | KAWS10157-I
4 | KAWS10158-I
KAWS10159-E
httpsd（httpsdctl stop） | 1 | KAWS10110-I
2 | KAWS10111-I
KAWS10112-E
3 | KAWS10160-I
4 | KAWS10161-I
KAWS10162-E
httpsd（httpsdctl gracefulstop） | 1 | KAWS10113-I
2 | KAWS10114-I
KAWS10115-E
3 | KAWS10163-I
4 | KAWS10164-I
KAWS10165-E

(2)　httpsdコマンド（コマンドの直接実行）

httpsdコマンドを直接実行する場合の監査ログの出力ポイントを次の図に示します。

図6-20　監査ログの出力ポイント（直接実行するhttpsdコマンド）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-33　監査ログの出力ポイントとメッセージIDの対応（直接実行するhttpsdコマンド）

コマンド | 図中の番号 | 出力される監査ログのメッセージID
httpsd | 1 | KAWS10101-I
2 | KAWS10102-I
KAWS10103-E
3 | KAWS10151-I
4 | KAWS10152-I
KAWS10153-E

(3)　シグナル送信によるデーモンプロセスの操作

シグナル送信によってデーモンプロセスを操作するときの監査ログの出力ポイントを次の図に示します。

図6-21　監査ログの出力ポイント（シグナル送信によるデーモンプロセスの操作）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表6-34　監査ログの出力ポイントとメッセージIDの対応（シグナル送信によるデーモンプロセスの操作）

シグナル送信による操作 | 図中の番号 | 出力される監査ログのメッセージID
再起動（SIGHUP） | 1 | KAWS10154-I
2 | KAWS10155-I
KAWS10156-E
再起動（SIGUSR1） | 1 | KAWS10157-I
2 | KAWS10158-I
KAWS10159-E
停止（SIGTERM） | 1 | KAWS10160-I
2 | KAWS10161-I
KAWS10162-E
計画停止（SIGUSR2） | 1 | KAWS10163-I
2 | KAWS10164-I
KAWS10165-E

7.　データベース監査証跡と連携した運用

この章では，データベースが提供する監査証跡の機能と連携して，データベース監査証跡にCosminexusシステムの情報を出力した場合の運用方法について説明します。

＜この章の構成＞

7.1　データベース監査証跡と連携した運用の概要

7.2　データベース監査証跡と連携した運用例

7.3　注意事項

7.1　データベース監査証跡と連携した運用の概要

この節では，データベースが提供する監査証跡の機能と連携し，Cosminexusシステムの情報をデータベース監査証跡として出力した場合の運用の概要について説明します。

データベース監査証跡とは，データベースの監査に利用するためのデータベースの操作記録です。監査者がデータベース監査証跡を調査することによって，監査対象のテーブルに決められた操作権限どおりに運用が行われているか，不正なアクセスがないかをチェックできます。データベース監査証跡の出力，取得，参照などをするための機能は，データベースが提供しています。データベース監査証跡の詳細については，データベースのマニュアルを参照してください。また，Cosminexusシステムと連携できるデータベースについては，マニュアル「Cosminexus　機能解説」のデータベース監査証跡との連携に関する説明を参照してください。

Cosminexusシステムでは，データベース監査証跡連携機能を使用して，Cosminexusシステムの情報（ルートアプリケーション情報）をデータベース監査証跡に出力できます。データベース監査証跡に出力されたルートアプリケーション情報を利用して，データベースの監査対象のテーブルにアクセスしたリクエストを特定できます。

データベース監査証跡連携機能の詳細については，マニュアル「Cosminexus　機能解説」のデータベース監査証跡との連携に関する説明を，データベース監査証跡連携機能を使用するための設定については，マニュアル「Cosminexus　システム構築ガイド」のデータベース監査証跡との連携の設定に関する説明を参照してください。

7.2　データベース監査証跡と連携した運用例

この節では，データベース監査証跡と連携した運用例について説明します。この運用例では，アプリケーションのユーザログ，データベース監査証跡，および性能解析トレースに出力されたルートアプリケーション情報を利用して，データベースの監査対象のテーブルにアクセスしたアプリケーションのログイン名やセッションIDを特定します。この場合，次の作業を実行します。

アプリケーションのユーザログを取得する

データベースの監査証跡情報を取得する

性能解析トレースを取得する

1.～3.で取得した情報を突き合わせて，ログイン名，セッションIDを特定する

それぞれの出力例や作業について説明します。

＜この節の構成＞

7.2.1　アプリケーションのユーザログの取得

7.2.2　データベースの監査証跡情報の取得

7.2.3　性能解析トレースの取得

7.2.4　情報の特定

7.2.1　アプリケーションのユーザログの取得

あらかじめJ2EEアプリケーションやバッチアプリケーションでユーザログを取得するための実装をしておくと，次の情報がユーザログに出力されます。

アプリケーションのログイン名

ルートアプリケーション情報

セッションID

ここでは，J2EEアプリケーションのユーザログの実装例および出力例を示します。

実装例

ログイン名，ルートアプリケーション情報，およびセッションIDをJ2EEアプリケーションのユーザログに出力する場合の実装例を示します。なお，ログイン名はWebコンテナのBasic認証またはForm認証でログインしたユーザIDを取得して出力します。

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;
import com.hitachi.software.ejb.application.prf.CprfTrace;

(中略)
public void doGet (HttpServletRequest req, HttpServletResponse res)
             throws ServletException, IOException {

　HttpSession ses = req.getSession();
　String sessionID = (ses != null) ? ses.getId() : null;　// セッションIDを取得
　String rootAPInfo = CprfTrace.getRootApInfo(); // ルートアプリケーション情報を取得
　String userID = req.getRemoteUser(); // J2EEアプリケーションのログイン名を取得

　ユーザログ出力メソッド(sessionID,rootAPInfo,userID);
　　：

出力例

J2EEアプリケーションのユーザログの出力例を示します。この例では，「セッションID」，「ルートアプリケーション情報」，「ログイン名」の順で出力されています。

7.2.2　データベースの監査証跡情報の取得

データベースが保持する監査証跡の情報を取得します。データベースの監査証跡表にデータ登録（監査証跡表へのデータロード）を行い，監査証跡表の「PRODUCT_INFO_1」列で監査対象のテーブルのルートアプリケーション情報を取得します。データベースの監査証跡の情報の取得方法については，マニュアル「HiRDB システム運用ガイド」を参照してください。監査証跡表の出力例を次に示します。

出力例

HiRDBの監査証跡表の出力例を示します。

この例で出力されている「SQL_SOURCE」列は，オプションを指定することで出力できます。オプションを指定して出力する列については，使用するシステムの要件に合わせて設定してください。オプションの設定方法，および監査証跡表の詳細については，マニュアル「HiRDB システム運用ガイド」を参照してください。

7.2.3　性能解析トレースの取得

性能解析トレースファイルを取得します。性能解析トレースの収集方法，および出力内容の詳細については，「3.2　性能解析トレースファイルの収集」を参照してください。性能解析トレースの出力例を次に示します。

出力例

この例では，性能解析トレースのトレース取得レベル（PRFトレース取得レベル）を「詳細レベル」にしてセッションIDを出力しています。PRFトレース取得レベルについては，使用するシステムの要件に合わせて設定してください。PRFトレース取得レベルの設定方法については，マニュアル「Cosminexus　システム構築ガイド」のトラブルシューティングの資料取得の設定に関する説明を参照してください。また，PRFトレースレベルの変更方法については，マニュアル「Cosminexus　リファレンス　コマンド編」のcprflevelコマンドの説明を参照してください。

7.2.4　情報の特定

アプリケーションのユーザログ，データベースの監査証跡表，および性能解析トレースの情報を突き合わせて，監査対象のテーブルにアクセスしたアプリケーションのログイン名，およびセッションIDを特定します。

データベースの監査証跡表に出力されている実行日時「EXEC_DATE,EXEC_TIME,EXEC_TIME_MICRO」の列の時間と，性能解析トレースの実行時間とを突き合せて，監査対象のテーブルにアクセスしたリクエストのルートアプリケーション情報を特定します。

1.で特定したルートアプリケーション情報と，アプリケーションのユーザログに出力されたルートアプリケーション情報とを突き合わせて，リクエストを実行したアプリケーションのログイン名およびセッションIDを特定します。

7.2.1，7.2.2，7.2.3の例では，セッションID「010D7AE670AEB55C022B6A4DA1C1E8B1CtEPmR9H」のリクエスト「10.209.15.130/1234/0x0000000000000001」（ルートアプリケーション情報）から，ユーザID「USER1」（ログイン名）でBeanの実行中（0x8405～0x8406）に，データベースのテーブル「Table1」にINSERT文を実行したことが確認できます。

7.3　注意事項

ルートアプリケーション情報をデータベースに設定するときに，データベースからエラーが返ってきた場合，KDJE54051-Eのメッセージが出力されます。この場合，リクエストの処理は続行されますが，データベース監査証跡にルートアプリケーション情報は出力されません。

KDJE54051-Eのメッセージが出力された場合は，Cosminexus Component Containerおよびデータベースの保守情報を取得して，保守員に連絡してください。また，KDJE54051-Eのメッセージはデータベースから初めてエラーが返ってきた時だけ出力され，それ以降はエラーが発生しても出力されません。そのため，ログを調査する場合などには注意してください。

8.　クラスタソフトウェアを使用したシステムの起動と停止（Windowsの場合）

この章では，クラスタソフトウェアを使用して，系切り替えシステムを運用する場合の，システムの起動と停止方法について説明します。Windowsの場合，クラスタソフトウェアには，Microsoft Cluster Serviceを使用します。Microsoft Cluster Serviceを使用すると，1:1系切り替えシステム，相互系切り替えシステム，およびN:1リカバリシステムを構築，運用することができます。

＜この章の構成＞

8.1　アプリケーションサーバを対象にした1:1系切り替えシステムの起動と停止

8.2　運用管理サーバを対象にした1:1系切り替えシステムの起動と停止

8.3　相互系切り替えシステムの起動と停止

8.4　N:1リカバリシステムの起動と停止

8.1　アプリケーションサーバを対象にした1:1系切り替えシステムの起動と停止

この節では，アプリケーションサーバを対象にした1:1系切り替えシステムを利用する場合の，システムの起動と停止の手順について説明します。稼働開始後にJ2EEサーバ，またはバッチサーバをメンテナンスするときの，起動と停止の手順についても説明します。

アプリケーションサーバを対象にした1:1系切り替えシステムでは，クラスタサービスを使用します。クラスタサービスの詳細については，OSのマニュアルを参照してください。

1:1系切り替えシステムを利用して運用する場合は，あらかじめ現用系と予備系の2種類のホストの用意や，クラスタサービスの対象となる運用管理エージェントを監視・起動・停止するスクリプトの登録など，必要な環境設定をしておく必要があります。設定方法については，マニュアル「Cosminexus　システム構築ガイド」の1:1系切り替えシステムの設定に関する説明を参照してください。

ポイント

1:1系切り替えシステムを利用する場合，Management Serverは運用管理サーバで起動します。なお，個々のアプリケーションサーバのホストでは，運用管理エージェントをOS起動と同時に起動する設定にしないでください。

参考

動作中の系を区別する場合，「実行系」と「待機系」の2種類の系に分けられます。

実行系
現在実行中のサーバがある系のことです。系切り替えが発生すると，待機系になります。

待機系
現在待機中のサーバがある系のことです。系切り替えが発生すると，実行系になります。

また，起動前の系を区別する場合，「現用系」と「予備系」の2種類の系に分けられます。

現用系
起動したときに，最初に実行系として起動される系のことです。

予備系
起動したときに，最初に待機系として起動される系のことです。

なお，この節では，手順内で計画的な系切り替えを実行する前には，現用系ホストが実行系ホストとして起動されていることを前提にして説明します。

＜この節の構成＞

8.1.1　アプリケーションサーバを対象にした1:1系切り替えシステムの起動

8.1.2　アプリケーションサーバを対象にした1:1系切り替えシステムの停止

8.1.3　アプリケーションサーバを対象にした1:1系切り替えシステムで計画的に系を切り替えるときの起動と停止

8.1.4　アプリケーションサーバを対象にした1:1系切り替えシステムをメンテナンスする場合の起動と停止

8.1.1　アプリケーションサーバを対象にした1:1系切り替えシステムの起動

ここでは，アプリケーションサーバを対象にした1:1系切り替えシステムの起動方法について説明します。

アプリケーションサーバを対象にした1:1系切り替えシステムを起動するには，あらかじめ運用管理サーバを起動しておくことが必要です。運用管理サーバを起動していない場合には，運用管理サーバを先に起動しておいてください。運用管理サーバの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

アプリケーションサーバを対象にした1:1系切り替えシステムの起動手順を次に示します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で現用系ノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
現用系ノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）で予備系ノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
予備系ノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［オンラインにする］を選択します。
1:1系切り替えシステムが起動します。

8.1.2　アプリケーションサーバを対象にした1:1系切り替えシステムの停止

ここでは，アプリケーションサーバを対象にした1:1系切り替えシステムの停止方法について説明します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［オフラインにする］を選択します。
実行系ノードおよび待機系ノードが含まれているリソースグループがオフラインになります。

コンソールツリー（左ペイン）で予備系ノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
予備系ノードのクラスタサービスが停止します。

コンソールツリー（左ペイン）で現用系ノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
現用系ノードのクラスタサービスが停止します。

なお，運用管理サーバは最後に手動で停止します。運用管理サーバの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

8.1.3　アプリケーションサーバを対象にした1:1系切り替えシステムで計画的に系を切り替えるときの起動と停止

トラブル発生時以外で，アプリケーションサーバを対象にした1:1系切り替えシステムの実行系と待機系を切り替える手順を次に示します。系を切り替えるときは，待機系のホストでCosminexusが待機状態になっている必要があります。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［グループの移動］を選択します。
系が切り替わります。

8.1.4　アプリケーションサーバを対象にした1:1系切り替えシステムをメンテナンスする場合の起動と停止

アプリケーションサーバを対象にした1:1系切り替えシステムをメンテナンスする場合の，起動と停止の手順を次に示します。

なお，これらの手順は，すでに実行系のホストでCosminexusが起動している場合の手順です。

＜この項の構成＞

(1)　再起動が不要なメンテナンスの場合の手順

(2)　再起動が必要なメンテナンスの場合（両方の系を同時に停止する方法）

(3)　再起動が必要なメンテナンスの場合（両方の系を同時に停止しない方法）

(1)　再起動が不要なメンテナンスの場合の手順

実行系のホストで，動作中のJ2EEアプリケーションとリソースアダプタを停止します。
バッチサーバの場合は，バッチアプリケーションが実行中でないことを確認してからリソースアダプタを停止してください。
停止方法については，マニュアル「Cosminexus　リファレンス　コマンド編」のコマンドによるシステムの起動と停止に関する説明を参照してください。

サーバ管理コマンドを使用してメンテナンス処理を実行します。
サーバ管理コマンドを使用したJ2EEアプリケーションやリソースの設定方法については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションの設定に関する説明，およびリソースの設定に関する説明を参照してください。

手順1.で停止したJ2EEアプリケーションとリソースアダプタを開始します。
J2EEサーバの場合はJ2EEアプリケーションとリソースアダプタを開始します。また，バッチサーバの場合はリソースアダプタを開始します。
開始方法については，マニュアル「Cosminexus　リファレンス　コマンド編」のコマンドによるシステムの起動と停止に関する説明を参照してください。

必要に応じてJ2EEアプリケーションとリソースアダプタの動作確認をします。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［グループの移動］を選択します。
系が切り替わります。

切り替え後の実行系のホストで手順1.～手順6.の手順を実行します。

切り替え後の実行系のホストを実行系に戻す場合，コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［グループの移動］を選択します。
メンテナンスが完了します。

(2)　再起動が必要なメンテナンスの場合（両方の系を同時に停止する方法）

論理サーバを一括停止する設定にしていない場合は，実行系のホストで各論理サーバを停止します。
Management Serverによって一括停止する設定の場合は，不要な手順です。停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［オフラインにする］を選択します。
実行系ノードおよび待機系ノードが含まれているリソースグループがオフラインになります。

コンソールツリー（左ペイン）で予備系ノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
予備系ノードのクラスタサービスが停止します。

コンソールツリー（左ペイン）で現用系ノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
現用系ノードのクラスタサービスが停止します。

現用系と予備系の両方のホストで，定義ファイルの変更など，メンテナンス作業を実行します。

コンソールツリー（左ペイン）で現用系ノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
現用系ノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）で予備系ノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
予備系ノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）で現用系ノードおよび予備系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［オンラインにする］を選択します。
1:1系切り替えシステムが再起動します。

論理サーバを一括起動する設定にしていない場合は，実行系のホストで各論理サーバを起動します。
Management Serverによって一括起動する設定の場合は，不要な手順です。起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

実行系のホストで，必要に応じて，定義の変更に関連した動作確認を実行します。
メンテナンスが完了します。

(3)　再起動が必要なメンテナンスの場合（両方の系を同時に停止しない方法）

待機系のホストで，定義ファイルの変更など，メンテナンス作業を実行します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［グループの移動］を選択します。
実行系のホストのCosminexusが停止してから，今まで待機していた系でCosminexusが起動します。これによって，メンテナンス済みのホストが実行系ホストになります。

切り替え後の実行系のホストで，必要に応じて，定義の変更に関連した動作確認を実行します。

切り替え後の待機系のホストで定義ファイルの編集など，メンテナンス作業を実行します。

切り替え後の実行系のホストを実行系に戻す場合，コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［グループの移動］を選択します。

切り替え後の実行系のホストで，必要に応じて，定義の変更に関連した動作確認を実行します。
メンテナンスが完了します。

8.2　運用管理サーバを対象にした1:1系切り替えシステムの起動と停止

ここでは，運用管理サーバを対象にした1:1系切り替えシステムを利用する場合の，システムの起動と停止の方法について説明します。

運用管理サーバを対象にした1:1系切り替えシステムでは，クラスタサービスを使用します。クラスタサービスの詳細については，OSのマニュアルを参照してください。

運用管理サーバを対象にした1:1系切り替えシステムを利用するには，あらかじめ現用系と予備系の2種類のホストの用意や，クラスタサービスの対象となるManagement Serverを監視・起動・停止するスクリプトの登録など，必要な環境設定をしておく必要があります。設定方法については，マニュアル「Cosminexus　システム構築ガイド」の1:1系切り替えシステムの設定に関する説明を参照してください。現用系と予備系の詳細については，「8.1　アプリケーションサーバを対象にした1:1系切り替えシステムの起動と停止」を参照してください。

＜この節の構成＞

8.2.1　運用管理サーバを対象にした1:1系切り替えシステムの起動

8.2.2　運用管理サーバを対象にした1:1系切り替えシステムの停止

8.2.3　運用管理サーバを対象にした1:1系切り替えシステムで計画的に系を切り替えるときの起動と停止

8.2.1　運用管理サーバを対象にした1:1系切り替えシステムの起動

ここでは，運用管理サーバを対象にした1:1系切り替えシステムの起動方法について説明します。

運用管理サーバを対象にした1:1系切り替えシステムを起動するには，あらかじめ起動するアプリケーションサーバの運用管理エージェントを起動しておくことが必要です。運用管理エージェントを起動していない場合には，運用管理エージェントを先に起動しておいてください。運用管理エージェントの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

運用管理サーバを対象にした1:1系切り替えシステムの起動手順を次に示します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で運用管理サーバの現用系ノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
現用系ノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）で運用管理サーバの予備系ノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
予備系ノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）で運用管理サーバの現用系ノードおよび予備系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［オンラインにする］を選択します。
運用管理サーバを対象にした1:1系切り替えシステムが起動します。

8.2.2　運用管理サーバを対象にした1:1系切り替えシステムの停止

ここでは，運用管理サーバを対象にした1:1系切り替えシステムの停止方法について説明します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で運用管理サーバの実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［オフラインにする］を選択します。
運用管理サーバの実行系ノードおよび待機系ノードが含まれているリソースグループがオフラインになります。

コンソールツリー（左ペイン）で運用管理サーバの予備系ノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
運用管理サーバの予備系ノードのクラスタサービスが停止します。

コンソールツリー（左ペイン）で運用管理サーバの現用系ノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
運用管理サーバの現用系ノードのクラスタサービスが停止します。

アプリケーションサーバの運用管理エージェントを停止します。
運用管理エージェントの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

8.2.3　運用管理サーバを対象にした1:1系切り替えシステムで計画的に系を切り替えるときの起動と停止

トラブル発生時以外で，運用管理サーバを対象にした1:1系切り替えシステムの実行系と待機系を切り替える手順を次に示します。系を切り替えるときは，待機系のホストでCosminexusが待機状態になっている必要があります。

システムの運用中にManagement Serverの設定情報を変更した場合，実行系のManagement Serverの設定情報を収集して，実行系から待機系へコピーします。また，mstrimportコマンドを実行して，コピーしたManagement Serverの設定情報を待機系に適用します。
実行系のManagement Serverと待機系のManagement Serverが同じ設定になります。
Management Serverの設定情報を実行系から待機系へコピーして，待機系に適用する方法については，マニュアル「Cosminexus　システム構築ガイド」の1:1系切り替えシステムの設定に関する説明を参照してください。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［グループの移動］を選択します。
系が切り替わります。

8.3　相互系切り替えシステムの起動と停止

ここでは，相互系切り替えシステムを利用する場合の，システムの起動と停止方法について説明します。

相互系切り替えシステムは，アプリケーションサーバの実行系と待機系を1:1にする構成の一つです。それぞれのアプリケーションサーバを実行系として稼働させながら，同時にお互いの待機系として構成します。現用系と待機系の詳細については，「8.1　アプリケーションサーバを対象にした1:1系切り替えシステムの起動と停止」を参照してください。

ここでは，それぞれのアプリケーションサーバを，アプリケーションサーバ1，アプリケーションサーバ2として，アプリケーションサーバ1には，J2EEサーバAの実行系とJ2EEサーバBの待機系を，アプリケーションサーバBにはJ2EEサーバAの待機系とJ2EEサーバBの実行系を配置する構成を例にして説明します。例にする構成を次の図に示します。この例では，J2EEサーバAの実行系とJ2EEサーバAの待機系をリソースグループA，J2EEサーバBの実行系とJ2EEサーバBの待機系をリソースグループBと設定しています。

図8-1　相互スタンバイシステムの構成例

＜この節の構成＞

8.3.1　相互系切り替えシステムの起動

8.3.2　相互系切り替えシステムの停止

8.3.3　相互系切り替えシステムで計画的に系を切り替える場合の起動と停止

8.3.1　相互系切り替えシステムの起動

ここでは，相互系切り替えシステムを利用する場合のシステムの起動手順について説明します。

相互系切り替えシステムを起動するには，あらかじめManagement Server，および運用管理エージェントを起動しておくことが必要です。Management Server，および運用管理エージェントを起動していない場合には，これらを先に起動しておいてください。

相互系切り替えシステムの起動手順を次に示します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）でアプリケーションサーバ1のノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
アプリケーションサーバ1のノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）でアプリケーションサーバ2のノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
アプリケーションサーバ2のノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）でリソースグループAを選択して，［ファイル］メニューの［オンラインにする］を選択します。
実行系（アプリケーションサーバＡ）がオンラインになります。

コンソールツリー（左ペイン）でリソースグループBを選択して，［ファイル］メニューの［オンラインにする］を選択します。
実行系（アプリケーションサーバＢ）がオンラインになります。

8.3.2　相互系切り替えシステムの停止

ここでは，相互系切り替えシステムの停止方法について説明します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）でリソースグループＢを選択して，［ファイル］メニューの［オフラインにする］を選択します。
リソースグループＢがオフラインになります。

コンソールツリー（左ペイン）でリソースグループＡを選択して，［ファイル］メニューの［オフラインにする］を選択します。
リソースグループＡがオフラインになります。

コンソールツリー（左ペイン）でアプリケーションサーバ2のノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
アプリケーションサーバ2のノードのクラスタサービスが停止します。

コンソールツリー（左ペイン）でアプリケーションサーバ1のノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
アプリケーションサーバ1のノードのクラスタサービスが停止します。

なお，Management Server，および運用管理エージェントは最後に手動で停止します。これらの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

8.3.3　相互系切り替えシステムで計画的に系を切り替える場合の起動と停止

トラブル発生時以外で，相互系切り替えシステムの実行系と待機系を切り替える手順を次に示します。系を切り替えるときは，待機系のホストでCosminexusが待機状態になっている必要があります。

ここでは，J2EEサーバAの系を切り替える場合について説明します。J2EEサーバBの場合も同じ手順で系を切り替えることができます。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）でリソースグループAを選択して，［ファイル］メニューの［グループの移動］を選択します。
系が切り替わります。

8.4　N:1リカバリシステムの起動と停止

この節では，N:1リカバリシステムを利用する場合の，システムの起動と停止の手順について説明します。

N:1リカバリシステムを利用して運用する場合は，あらかじめ現用系と予備系の2種類のホストの用意や，クラスタサービスの対象となる運用管理エージェントを監視・起動・停止するスクリプトの登録など，必要な環境設定をしておく必要があります。設定方法については，マニュアル「Cosminexus　システム構築ガイド」のN:1リカバリシステムの設定に関する説明を参照してください。

ポイント

N:1リカバリシステムを利用する場合，Management Serverは運用管理サーバで起動します。なお，個々のアプリケーションサーバのホストでは，運用管理エージェントをOS起動と同時に起動する設定にしないでください。

参考

動作中の系を区別する場合，「実行系」と「待機系」の2種類の系に分けられます。

実行系
業務処理を実行するN台のアプリケーションサーバがある系のことです。

待機系
1台のリカバリ専用サーバがある系のことです。

＜この節の構成＞

8.4.1　N:1リカバリシステムの起動

8.4.2　N:1リカバリシステムの停止

8.4.1　N:1リカバリシステムの起動

ここではN:1リカバリシステムを利用する場合のシステムの起動手順について説明します。

Ｎ:1リカバリシステムを利用するには，あらかじめ運用管理サーバを起動しておくことが必要です。運用管理サーバを起動していない場合には，運用管理サーバを先に起動しておいてください。運用管理サーバの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

また，N:1リカバリシステムでは，先に起動したノードが実行系ノードとして，あとに起動したノードが待機系ノードとして動作します。必ず現用系ノードを予備系ノードよりも先に起動してください。

N:1リカバリシステムの起動手順を次に示します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で現用系ノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
選択した現用系ノードのクラスタサービスが開始されます。すべての現用行系ノードに対して実行してください。

コンソールツリー（左ペイン）で予備系ノードを選択し，［ファイル］メニューの［クラスタサービスの開始］を選択します。
予備系ノードのクラスタサービスが開始されます。

コンソールツリー（左ペイン）で現用系ノードおよび予備系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［オンラインにする］を選択します。
選択したリソースグループがオンラインになります。すべてのリソースグループに対して実行してください。

実行系のホストの各論理サーバを起動します。
起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

8.4.2　N:1リカバリシステムの停止

ここでは，N:1リカバリシステムの停止方法について説明します。

［スタート］メニューの［コントロールパネル］－［パフォーマンスとメンテナンス］－［管理ツール］から，［クラスタ アドミニストレータ］を選択します。
クラスタアドミニストレータが開始されます。

コンソールツリー（左ペイン）で実行系ノードおよび待機系ノードが含まれているリソースグループを選択して，［ファイル］メニューの［オフラインにする］を選択します。
選択したリソースグループがオフラインになります。すべてのリソースグループに対して実行してください。

コンソールツリー（左ペイン）で予備系ノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
予備系ノードのクラスタサービスが停止します。

コンソールツリー（左ペイン）で現用系ノードを選択し，［ファイル］メニューの［クラスタサービスの停止］を選択します。
選択した現用系ノードのクラスタサービスが停止します。すべての現用系ノードに対して実行してください。

なお，運用管理サーバは最後に手動で停止します。運用管理サーバの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

9.　クラスタソフトウェアを使用したシステムの起動と停止（UNIXの場合）

この章では，クラスタソフトウェアを使用して，系切り替えシステムを運用する場合の，システムの起動と停止方法について説明します。UNIXの場合，クラスタソフトウェアには，HAモニタを使用します。HAモニタを使用すると，1:1系切り替えシステム，相互系切り替えシステム，およびN:1リカバリシステムを構築，運用することができます。

＜この章の構成＞

9.1　1:1系切り替えシステムの起動と停止

9.2　相互系切り替えシステムの起動と停止

9.3　N:1リカバリシステムの起動と停止

9.1　1:1系切り替えシステムの起動と停止

この節では， HAモニタによる1:1系切り替えシステムを利用する場合の，システムの起動と停止の手順について説明します。稼働開始後にJ2EEサーバ，バッチサーバ，Management Serverなどをメンテナンスする場合の，起動と停止の手順についても説明します。なお，HAモニタを利用できるのは，AIX，HP-UXまたはLinuxの場合だけです。Solarisの場合，HAモニタは利用できません。

1:1系切り替えシステムを利用して運用する場合は，あらかじめ現用系と予備系の2種類のホストの用意や，HAモニタの監視の対象となる運用管理エージェント（アプリケーションサーバの1:1系切り替えシステムの場合）またはManagement Server（運用管理サーバの1:1系切り替えシステムの場合）を監視・起動・停止するスクリプトの登録など，必要な環境設定をしておく必要があります。設定方法については，マニュアル「Cosminexus　システム構築ガイド」のシステムの可用性を高める設定に関する説明を参照してください。

アプリケーションサーバの1:1系切り替えシステムと，運用管理サーバの1:1系切り替えシステムで実行できる運用操作およびその参照先を次の表に示します。

表9-1　1:1系切り替えシステムで実行できる運用操作

運用操作 | アプリケーションサーバの1:1系切り替えシステム | 運用管理サーバの1:1系切り替えシステム
システムの起動 | 9.1.1参照 | 9.1.1参照
システムの停止 | 9.1.2参照 | 9.1.2参照
実行系と待機系を計画的に系切り替えする場合のシステムの起動と停止 | 9.1.3参照 | 9.1.3参照
メンテナンスする場合のシステムの起動と停止 | 9.1.4参照 | 9.1.5参照

また，次のコマンドは，HAモニタが提供しているコマンドです。詳細は，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

monbegin（HAモニタとのインタフェースを持たないサーバを起動）

monend（HAモニタとのインタフェースを持たない実行サーバの停止連絡）

monsbystp（待機サーバの停止）

monswap（計画系切り替え）

参考

HAモニタの動作中の系を区別する場合，「実行系」と「待機系」の2種類の系に分けられます。

実行系
現在実行中のサーバがある系のことです。系切り替えが発生すると，待機系になります。

待機系
現在待機中のサーバがある系のことです。系切り替えが発生すると，実行系になります。

また，起動前のHAモニタを静的に区別する場合，「現用系」と「予備系」の2種類の系に分けられます。

現用系
起動したときに，最初に実行系として起動される系のことです。なお，実行系として起動することは，HAモニタのサーバ対応環境設定用の定義ファイルで定義しておきます。

予備系
起動したときに，最初に待機系として起動される系のことです。なお，待機系として起動することは，HAモニタのサーバ対応環境設定用の定義ファイルで定義しておきます。

＜この節の構成＞

9.1.1　1:1系切り替えシステムの起動

9.1.2　1:1系切り替えシステムの停止

9.1.3　1:1系切り替えシステムで計画的に系を切り替える場合の起動と停止

9.1.4　アプリケーションサーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止

9.1.5　運用管理サーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止

9.1.1　1:1系切り替えシステムの起動

1:1系切り替えシステムを利用する場合のシステム起動時の留意事項，およびシステムの起動手順について説明します。

＜この項の構成＞

(1)　システム起動時の留意事項

(2)　システムの起動手順

(1)　システム起動時の留意事項

1:1系切り替えシステムを利用する場合のシステム起動時の留意事項を次に示します。

現用系と予備系のホストに配置されたHAモニタは，OSの起動と同時に起動されています。

アプリケーションサーバの1:1系切り替えシステムを起動する場合，運用管理サーバを使用するときは，運用管理サーバをあらかじめ起動しておいてください。運用管理サーバの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理サーバの起動の流れに関する説明を参照してください。

運用管理サーバの1:1系切り替えシステムを起動する場合，アプリケーションサーバを別ホストに配置しているときは，運用管理ドメイン内のアプリケーションサーバの運用管理エージェントをあらかじめ起動しておいてください。運用管理エージェントの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

(2)　システムの起動手順

1:1系切り替えシステムを利用する場合のシステムの起動手順を次に示します。

現用系のホストでmonbeginコマンドを実行して，現用系のホストを実行系として起動します。

# monbegin サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
これによって，運用管理エージェントを起動するスクリプトファイルに定義されている処理が実行されて，現用系のホストが実行系として起動します。

予備系のホストでmonbeginコマンドを実行して，予備系のホストを待機系として起動します。

# monbegin サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
これによって，予備系のホストが待機系となり，実行系の障害に備えます。

注意

Management Server起動時に運用管理ドメイン内の論理サーバを一括起動する設定にしていない場合は，現用系のホストの各論理サーバを起動してください。なお，Management Server起動時に運用管理ドメイン内の論理サーバを一括起動するように設定にしている場合，論理サーバの手動起動は不要です。起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

参考

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

9.1.2　1:1系切り替えシステムの停止

1:1系切り替えシステムの停止手順について説明します。

ここでは，次の二つの場合の停止手順について説明します。

実行系と待機系の両方のホストを停止する場合

待機系のホストだけ停止する場合

＜この項の構成＞

(1)　実行系と待機系の両方のホストを停止する場合

(2)　待機系のホストだけ停止する場合

(1)　実行系と待機系の両方のホストを停止する場合

実行系と待機系の両方のホストを停止する場合の手順を次に示します。

運用管理エージェントを停止するスクリプトで，運用管理ドメイン内の論理サーバを一括停止する設定にしていない場合は，実行系のホストの各論理サーバを停止します。
運用管理エージェントを停止するスクリプトで論理サーバを停止する設定にしている場合は，不要な手順です。論理サーバの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

実行系のホストでmonendコマンドを実行して，実行系のホストの運用管理エージェントを停止します。

# monend サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
これによって，実行系のホストの運用管理エージェントが停止します。また，HAモニタによって待機系に自動的に停止指示が出され，待機系のホストの運用管理エージェントも停止します。

なお，アプリケーションサーバの1:1系切り替えシステムの場合，運用管理サーバを使用しているときは，運用管理サーバは最後に手動で停止します。運用管理サーバの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

参考

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

(2)　待機系のホストだけ停止する場合

実行系は停止しないで待機系で待機状態をやめる場合は，待機系のホストで次のコマンドを実行します。

# monsbystp サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。

9.1.3　1:1系切り替えシステムで計画的に系を切り替える場合の起動と停止

1:1系切り替えシステムでトラブル発生時以外の場合に，実行系と待機系を計画的に切り替えるときの手順について説明します。系を切り替えるときには，待機系のホストでCosminexusが待機状態になっている必要があります。

1:1系切り替えシステムで実行系と待機系を計画的に切り替えるときの手順を次に示します。なお，現用系のホストが実行系として起動されていることを前提としています。

運用管理エージェントを停止するスクリプトで，運用管理ドメイン内の論理サーバを一括停止する設定にしていない場合は，実行系のホストで各論理サーバを停止します。
運用管理エージェントを停止するスクリプトで論理サーバを停止する設定にしている場合は，不要な手順です。論理サーバの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

実行系のホストでmonswapコマンドを実行して，系を切り替えます。

# monswap サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
運用管理エージェントを停止するスクリプトに定義されている処理が実行されて，実行系のホストのCosminexusが停止します。そのあと，今まで待機していた系でCosminexusが起動します。これで，計画的な系切り替えの手順は完了です。

参考

1:1系切り替えシステムをメンテナンスする場合の起動と停止の手順については，「9.1.4　アプリケーションサーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止」または「9.1.5　運用管理サーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止」を参照してください。

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

9.1.4　アプリケーションサーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止

アプリケーションサーバの1:1系切り替えシステムをメンテナンスする場合の，起動と停止の手順について説明します。

ここでは，次の三つの場合の停止手順について説明します。

再起動が不要なメンテナンスの場合

再起動が必要なメンテナンスの場合（両方の系を同時に停止する方法）

再起動が必要なメンテナンスの場合（両方の系を同時に停止しない方法）

なお，これらの手順は，すでに実行系のホストでCosminexusが起動している場合の手順です。

＜この項の構成＞

(1)　再起動が不要なメンテナンスの場合

(2)　再起動が必要なメンテナンスの場合（両方の系を同時に停止する方法）

(3)　再起動が必要なメンテナンスの場合（両方の系を同時に停止しない方法）

(1)　再起動が不要なメンテナンスの場合

再起動が不要なメンテナンスをする場合の起動と停止の手順を次に示します。

実行系のホストで，動作中のJ2EEアプリケーションとリソースアダプタを停止します。
バッチサーバの場合は，バッチアプリケーションが実行中でないことを確認してからリソースアダプタを停止してください。
停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

サーバ管理コマンドを使用してメンテナンス処理を実行します。
サーバ管理コマンドを使用したJ2EEアプリケーションやリソースの設定方法については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションに関する説明，およびリソースの設定に関する説明を参照してください。

手順1.で停止したJ2EEアプリケーションとリソースアダプタを開始します。
J2EEサーバの場合はJ2EEアプリケーションとリソースアダプタを開始します。また，バッチサーバの場合はリソースアダプタを開始します。
開始方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

必要に応じてJ2EEアプリケーションとリソースアダプタの動作確認をします。

実行系のホスト（現用系のホスト）で，monswapコマンドを実行して，系を切り替えます。
実行系のホスト（現用系ホスト）が待機系のホストに切り替わり，待機系だったホスト（予備系ホスト）が実行系ホストになります。

切り替え後の実行系のホスト（予備系のホスト）で手順1.～手順4.を実行します。

切り替え後の実行系のホスト（予備系のホスト）で，必要に応じて，再度monswapコマンドを実行します。
現用系のホストを実行系に戻す場合に実行してください。
これで，メンテナンス時の起動と停止の手順は完了です。

(2)　再起動が必要なメンテナンスの場合（両方の系を同時に停止する方法）

再起動が必要なメンテナンスをする場合に，両方の系を同時に停止するときの起動と停止の手順を次に示します。

運用管理エージェントを停止するスクリプトで，運用管理ドメイン内の論理サーバを一括停止する設定にしていない場合は，実行系のホストで各論理サーバを停止します。
運用管理エージェントを停止するスクリプトで論理サーバを停止する設定にしている場合は，不要な手順です。論理サーバの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

実行系のホストでmonendコマンドを実行して，システムを停止します。

# monend サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
実行系のホストが停止します。また，HAモニタによって待機系に自動的に停止指示が出され，待機系のホストも停止します。

現用系と予備系の両方のホストで，定義ファイルの変更など，メンテナンス作業を実行します。

現用系のホストでmonbeginコマンドを実行して，現用系のホストの運用管理エージェントを起動します。

# monbegin サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
これによって，現用系のホストが，実行系として起動します。

予備系のホストでmonbeginコマンドを実行します。

# monbegin サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
これによって，予備系のホストが，待機系として起動します。

運用管理エージェントを起動するスクリプトで運用管理ドメイン内の論理サーバを一括起動する設定にしていない場合は，実行系のホストの各論理サーバを起動します。
運用管理エージェントを起動するスクリプトで論理サーバを起動する設定にしている場合は，不要な手順です。論理サーバの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

実行系のホストで，必要に応じて，定義の変更に関連した動作確認を実行します。

参考

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

(3)　再起動が必要なメンテナンスの場合（両方の系を同時に停止しない方法）

再起動が必要なメンテナンスをする場合に，両方の系を同時に停止しないときの起動と停止の手順を次に示します。

待機系のホストで，定義ファイルの変更など，メンテナンス作業を実行します。

実行系のホストでmonswapコマンドを実行して，系を切り替えます。

# monswap サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
実行系のホストのCosminexusが停止してから，今まで待機していた系でCosminexusが起動します。これによって，メンテナンス済みのホストが実行系ホストになります。

切り替え後の実行系のホスト（予備系のホスト）で，必要に応じて，定義の変更に関連した動作確認を実行します。

切り替え後の待機系のホスト（現用系のホスト）で定義ファイルの編集など，メンテナンス作業を実行します。

切り替え後の実行系のホスト（予備系のホスト）で，必要に応じて，再度monswapコマンドを実行します。
現用系のホストを実行系に戻す場合に実行してください。

切り替え後の実行系のホスト（現用系のホスト）で，必要に応じて，定義の変更に関連した動作確認を実行します。
これで，メンテナンス時の起動と停止の手順は完了です。

参考

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

9.1.5　運用管理サーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止

Management Serverの設定を変更するために，運用管理サーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止の手順について説明します。

なお，これらの手順は，すでに実行系のホストでManagement Serverが起動している場合の手順です。

実行系のホスト（現用系のホスト）で，mstrexportコマンドを実行します。

# mstrexport mstruct.zip

現用系のホストのManagement Serverの設定情報が自動収集されて，収集された情報がZIP形式のファイルに保存されます。
下線部分には，自動収集された設定情報を保存するZIP形式のファイルのパスを指定します。

手順1.で保存されたZIP形式のファイルを，実行系から待機系にコピーします。

待機系のホスト（予備系のホスト）で，mstrimportコマンドを実行します。

# mstrimport mstruct.zip

下線部分には，手順2でコピーしたZIP形式のファイルのパスを指定します。
これによって，手順2.でコピーしたManagement Serverの設定情報が待機系のホストに展開されて，実行系のManagement Serverと待機系のManagement Serverが同じ設定になります。

実行系のホストでmonswapコマンドを実行して，系を切り替えます。

# monswap サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
実行系のホストのManagement Serverが停止してから，今まで待機していた系でManagement Serverが起動します。Management Serverの起動時に実行系の設定情報がシステムに反映されます。

切り替え後の実行系のホスト（予備系のホスト）で，必要に応じて，定義の変更に関連した動作確認を実行します。

切り替え後の実行系のホスト（予備系のホスト）で，必要に応じて，再度monswapコマンドを実行します。
現用系のホストを実行系に戻す場合に実行してください。

切り替え後の実行系のホスト（現用系のホスト）で，必要に応じて，定義の変更に関連した動作確認を実行します。
これで，メンテナンス時の起動と停止の手順は完了です。

参考

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

9.2　相互系切り替えシステムの起動と停止

この節では，HAモニタによる相互系切り替えシステムを利用する場合の，システムの起動と停止の手順について説明します。稼働開始後にJ2EEサーバ，およびバッチサーバをメンテナンスする場合の起動と停止の手順についても説明します。なお，HAモニタが利用できるのは，AIX，HP-UXまたはLinuxの場合だけです。Solarisの場合，HAモニタは利用できません。

相互系切り替えシステムを利用して運用する場合は，あらかじめ現用系と予備系の2種類のホストの用意や，HAモニタの監視の対象となる運用管理エージェントを監視・起動・停止するスクリプトの登録など，必要な環境設定をしておく必要があります。設定方法については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

相互系切り替えシステムのシステム構成例を次の図に示します。この節では，このシステム構成例を基に，相互系切り替えシステムの起動および停止の手順について説明します。

図9-1　相互系切り替えシステムのシステム構成例

図中の各アプリケーションサーバでのserversファイルの定義（HAモニタでのサーバの環境設定）のうち，起動・停止に関連する定義項目を次の表に示します。

表9-2　アプリケーションサーバ1のserversファイルの定義

オペランド
説明
指定値

現用系1
（仮想ホスト1）
予備系2
（仮想ホスト2）

alias
サーバの識別名
CosminexusAP1
CosminexusAP2

initial
HAモニタでのサーバの起動方法
online
standby

表9-3　アプリケーションサーバ2のserversファイルの定義

オペランド
説明
指定値

予備系1
（仮想ホスト1）
現用系2
（仮想ホスト2）

alias
サーバの識別名
CosminexusAP1
CosminexusAP2

initial
HAモニタでのサーバの起動方法
standby
online

なお，serversファイルの定義の詳細については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

また，次のコマンドは，HAモニタが提供しているコマンドです。詳細は，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

monbegin（HAモニタとのインタフェースを持たないサーバを起動）

monend（HAモニタとのインタフェースを持たない実行サーバの停止連絡）

monsbystp（待機サーバの停止）

monswap（計画系切り替え）

参考

HAモニタの動作中の系を区別する場合，「実行系」と「待機系」の2種類の系に分けられます。

実行系
現在実行中のサーバがある系のことです。系切り替えが発生すると，待機系になります。

待機系
現在待機中のサーバがある系のことです。系切り替えが発生すると，実行系になります。

また，起動前のHAモニタを静的に区別する場合，「現用系」と「予備系」の2種類の系に分けられます。

現用系
起動したときに，最初に実行系として起動される系のことです。なお，実行系として起動することは，HAモニタのサーバ対応環境設定用の定義ファイルで定義しておきます。

予備系
起動したときに，最初に待機系として起動される系のことです。なお，待機系として起動することは，HAモニタのサーバ対応環境設定用の定義ファイルで定義しておきます。

＜この節の構成＞

9.2.1　相互系切り替えシステムの起動

9.2.2　相互系切り替えシステムの停止

9.2.3　相互系切り替えシステムで計画的に系を切り替える場合の起動と停止

9.2.4　相互系切り替えシステムをメンテナンスする場合の起動と停止

9.2.1　相互系切り替えシステムの起動

相互系切り替えシステムを利用する場合のシステム起動時の留意事項，およびシステムの起動手順について説明します。

＜この項の構成＞

(1)　システム起動時の留意事項

(2)　システムの起動手順

(1)　システム起動時の留意事項

相互系切り替えシステムを利用する場合のシステム起動時の留意事項を次に示します。

アプリケーションサーバ1とアプリケーションサーバ2のホストに配置されたHAモニタは，OSの起動と同時に起動されています。

アプリケーションサーバ1およびアプリケーションサーバ2の各ホストで仮想ホストを起動する前に，Management Serverをあらかじめ起動しておいてください。

(2)　システムの起動手順

相互系切り替えシステムの起動の流れを次の図に示します。

アプリケーションサーバ1およびアプリケーションサーバ2の各ホストで次の図に示す流れでシステムを起動してください。

図9-2　相互系切り替えシステムの起動の流れ

参考

アプリケーションサーバ1およびアプリケーションサーバ2の各ホストでの仮想ホストの起動順序は任意です。現用系仮想ホストまたは予備系仮想ホストのどちらから起動してもかまいません。なお，このマニュアルでは，仮想ホスト1，仮想ホスト2の順序で起動する場合の手順について説明します。

図中のManagement Serverの起動の手順1.～手順2.については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明の各項を参照してください。なお，自動起動の設定をしている場合，ホストの起動時に，運用管理エージェント，Management Serverも起動されるため，手順1.～手順2.は省略できます。システムの起動方法の設定については，マニュアル「Cosminexus　システム構築ガイド」のシステムの起動と停止の設定に関する説明を参照してください。

ここでは，図中の仮想ホストの起動手順について説明します。アプリケーションサーバ1およびアプリケーションサーバ2の各ホストでの起動手順を次に示します。

アプリケーションサーバ1での起動手順

現用系1（仮想ホスト1）の起動
monbeginコマンドを実行して，現用系1（仮想ホスト1）を実行系として起動します。

# monbegin CosminexusAP1

これによって，現用系の仮想ホストを起動するスクリプトファイルに定義されている処理が実行されて，現用系の仮想ホストが実行系として起動されます。

予備系2（仮想ホスト2）の起動
monbeginコマンドを実行して，予備系2（仮想ホスト2）を待機系として起動します。

# monbegin CosminexusAP2

これによって，予備系の仮想ホストが待機系となり，実行系の障害に備えます。

アプリケーションサーバ2での起動手順

予備系1（仮想ホスト1）の起動
monbeginコマンドを実行して，予備系1（仮想ホスト1）を待機系として起動します。

# monbegin CosminexusAP1

これによって，予備系の仮想ホストが待機系となり，実行系の障害に備えます。

現用系2（仮想ホスト2）の起動
monbeginコマンドを実行して，現用系2（仮想ホスト2）を実行系として起動します。

# monbegin CosminexusAP2

これによって，現用系の仮想ホストを起動するスクリプトファイルに定義されている処理が実行されて，現用系の仮想ホストが実行系として起動されます。

9.2.2　相互系切り替えシステムの停止

相互系切り替えシステムの停止手順について説明します。

ここでは，次の二つの場合の停止手順について説明します。

実行系と待機系の両方の仮想ホストを停止する場合

待機系の仮想ホストだけ停止する場合

＜この項の構成＞

(1)　実行系と待機系の両方の仮想ホストを停止する場合

(2)　待機系の仮想ホストだけ停止する場合

(1)　実行系と待機系の両方の仮想ホストを停止する場合

実行系と待機系の両方の仮想ホストを停止する場合の手順について説明します。

実行系と待機系の両方の仮想ホストを停止する場合の，相互系切り替えシステムの停止の流れを次の図に示します。

図9-3　相互系切り替えシステムの停止の流れ

参考

仮想ホスト1および仮想ホスト2の停止順序は任意です。このマニュアルでは，仮想ホスト1，仮想ホスト2の順序で停止する場合の手順について説明します。

すべての仮想ホストを停止したあと，アプリケーションサーバ1およびアプリケーションサーバ2の各ホストのManagement Serverを停止します。

図中のManagement Serverの停止の手順1.～手順2.については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明の各項を参照してください。なお，自動停止の設定をしている場合，ホストの停止時に，Management Server，および運用管理エージェントも停止されるため，手順1.～手順2.は省略できます。システムの停止方法の設定については，マニュアル「Cosminexus　システム構築ガイド」のシステムの起動と停止の設定に関する説明を参照してください。

ここでは，図中の仮想ホストの停止手順について説明します。アプリケーションサーバ1およびアプリケーションサーバ2の各ホストでの停止手順を次に示します。

アプリケーションサーバ1での停止手順

アプリケーションサーバ1でmonendコマンドを実行して，実行系の仮想ホスト1を停止します。

# monend CosminexusAP1

これによって，アプリケーションサーバ1の実行系1（仮想ホスト1）が停止します。また，HAモニタによって待機系に自動的に停止指示が出され，アプリケーションサーバ2の待機系1（仮想ホスト1）も停止します。

アプリケーションサーバ2での停止手順

アプリケーションサーバ2でmonendコマンドを実行して，実行系の仮想ホスト2を停止します。

# monend CosminexusAP2

これによって，アプリケーションサーバ2の実行系2（仮想ホスト2）が停止します。また，HAモニタによって待機系に自動的に停止指示が出され，アプリケーションサーバ1の待機系2（仮想ホスト2）も停止します。

(2)　待機系の仮想ホストだけ停止する場合

実行系の仮想ホストを停止しないで待機系の仮想ホストで待機状態をやめる場合の手順について説明します。

アプリケーションサーバ1の待機系2（仮想ホスト2）で待機状態をやめる場合
アプリケーションサーバ1のホストで次のコマンドを実行します。

# monsbystp CosminexusAP2

アプリケーションサーバ2の待機系1（仮想ホスト1）で待機状態をやめる場合
アプリケーションサーバ2のホストで次のコマンドを実行します。

# monsbystp CosminexusAP1

9.2.3　相互系切り替えシステムで計画的に系を切り替える場合の起動と停止

相互系切り替えシステムでトラブル発生時以外の場合に，実行系と待機系を計画的に切り替えるときの手順について説明します。系を切り替えるときには，待機系の仮想ホストが待機状態になっている必要があります。

ここでは，仮想ホスト1および仮想ホスト2の実行系と待機系を計画的に切り替える場合の手順について説明します。なお，現用系のホストが実行系として起動されていることを前提にして説明します。

参考

相互系切り替えシステムをメンテナンスする場合の起動と停止の手順については，「9.2.4　相互系切り替えシステムをメンテナンスする場合の起動と停止」を参照してください。

＜この項の構成＞

(1)　仮想ホスト1を計画的に系切り替えする場合

(2)　仮想ホスト2を計画的に系切り替えする場合

(1)　仮想ホスト1を計画的に系切り替えする場合

仮想ホスト1を計画的に系切り替えする場合の手順を次に示します。

アプリケーションサーバ1でmonswapコマンドを実行して，系を切り替えます。

# monswap CosminexusAP1

これによって，次の図に示すように，アプリケーションサーバ1の実行系1（仮想ホスト1）が待機系の仮想ホストに切り替わり，アプリケーションサーバ2の待機系1（仮想ホスト1）が実行系の仮想ホストに切り替わります。

通常運用の実行系と待機系の状態に戻す場合，アプリケーションサーバ2でmonswapコマンドを実行して，系を切り替えます。

# monswap CosminexusAP1

これによって，次の図に示すように，アプリケーションサーバ2の実行系1（仮想ホスト1）が待機系の仮想ホストに切り替わり，アプリケーションサーバ1の待機系1（仮想ホスト1）が実行系の仮想ホストに切り替わります。これで，通常運用の実行系と待機系の状態に戻ります。

(2)　仮想ホスト2を計画的に系切り替えする場合

仮想ホスト2を計画的に系切り替えする場合の手順を次に示します。

アプリケーションサーバ2でmonswapコマンドを実行して，系を切り替えます。

# monswap CosminexusAP2

これによって，次の図に示すように，アプリケーションサーバ2の実行系2（仮想ホスト2）が待機系の仮想ホストに切り替わり，アプリケーションサーバ1の待機系2（仮想ホスト2）が実行系の仮想ホストに切り替わります。

通常運用の実行系と待機系の状態に戻す場合，アプリケーションサーバ1でmonswapコマンドを実行して，系を切り替えます。

# monswap CosminexusAP2

これによって，次の図に示すように，アプリケーションサーバ1の実行系2（仮想ホスト2）が待機系の仮想ホストに切り替わり，アプリケーションサーバ2の待機系2（仮想ホスト2）が実行系の仮想ホストに切り替わります。これで，通常運用の実行系と待機系の状態に戻ります。

9.2.4　相互系切り替えシステムをメンテナンスする場合の起動と停止

相互系切り替えシステムをメンテナンスする場合の，起動と停止の手順を次に示します。

ここでは，次の三つの場合の停止手順について説明します。

再起動が不要なメンテナンスの場合

再起動が必要なメンテナンスの場合（両方の系を同時に停止する方法）

再起動が必要なメンテナンスの場合（両方の系を同時に停止しない方法）

なお，これらの手順は，すでに実行系の仮想ホストが両方とも起動している場合の手順です。

＜この項の構成＞

(1)　再起動が不要なメンテナンスの場合

(2)　再起動が必要なメンテナンスの場合（両方の系を同時に停止する方法）

(3)　再起動が必要なメンテナンスの場合（両方の系を同時に停止しない方法）

(1)　再起動が不要なメンテナンスの場合

再起動が不要なメンテナンスの場合の起動と停止の手順を次に示します。

実行系の仮想ホスト（現用系の仮想ホスト）で，動作中のJ2EEアプリケーションとリソースアダプタを停止します。
バッチサーバの場合は，バッチアプリケーションが実行中でないことを確認してからリソースアダプタを停止してください。
停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

サーバ管理コマンドを使用してメンテナンス処理を実行します。
サーバ管理コマンドを使用したJ2EEアプリケーションやリソースの設定方法については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションの設定に関する説明，およびリソースの設定に関する説明を参照してください。

手順1.で停止したJ2EEアプリケーションとリソースアダプタを開始します。
J2EEサーバの場合はJ2EEアプリケーションとリソースアダプタを開始します。また，バッチサーバの場合はリソースアダプタを開始します。
開始方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

必要に応じてJ2EEアプリケーションとリソースアダプタの動作確認をします。

実行系の仮想ホスト（現用系の仮想ホスト）に対して，monswapコマンドを実行して，系を切り替えます。

# monswap サーバの識別名

下線部分には，実行系の仮想ホストが配置されているアプリケーションサーバの，serversファイルのオペランド「alias」に指定されている実行系の仮想ホストのサーバの識別名を指定します。
実行系の仮想ホスト（現用系の仮想ホスト）が待機系の仮想ホストに切り替わり，待機系だった仮想ホスト（予備系の仮想ホスト）が実行系の仮想ホストになります。

切り替え後の実行系の仮想ホスト（予備系の仮想ホスト）で手順1.～手順4.を実行します。

切り替え後の実行系のホスト（予備系の仮想ホスト）で，必要に応じて，再度monswapコマンドを実行します。

# monswap サーバの識別名

下線部分には，手順5.でmonswapコマンドの引数に指定したサーバの識別名と同じサーバの識別名を指定します。
現用系の仮想ホストを実行系に戻す場合に実行してください。
これで，メンテナンス時の起動と停止の手順は完了です。

(2)　再起動が必要なメンテナンスの場合（両方の系を同時に停止する方法）

再起動が必要なメンテナンスの場合の起動と停止の手順を次に示します。

実行系の仮想ホストに対してmonendコマンドを実行して，システムを停止します。

# monend サーバの識別名

下線部分には，実行系の仮想ホストが配置されているアプリケーションサーバの，serversファイルのオペランド「alias」に指定されている実行系の仮想ホストのサーバの識別名を指定します。
実行系の仮想ホストが停止します。また，HAモニタによって待機系に自動的に停止指示が出され，待機系の仮想ホストも停止します。

現用系と予備系の両方の仮想ホストに対して，定義ファイルの変更など，メンテナンス作業を実行します。

現用系の仮想ホストに対して，monbeginコマンドを実行します。

# monbegin サーバの識別名

下線部分には，手順1.でmonendコマンドの引数に指定したサーバの識別名と同じサーバの識別名を指定します。
これによって，現用系の仮想ホストが，実行系として起動します。

予備系の仮想ホストに対して，monbeginコマンドを実行します。

# monbegin サーバの識別名

下線部分には，手順1.でmonendコマンドの引数に指定したサーバの識別名と同じサーバの識別名を指定します。
これによって，予備系の仮想ホストが，待機系として起動します。

実行系の仮想ホストで，必要に応じて，定義の変更に関連した動作確認を実行します。

参考

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

(3)　再起動が必要なメンテナンスの場合（両方の系を同時に停止しない方法）

再起動が必要なメンテナンスの場合の起動と停止の手順を次に示します。

待機系の仮想ホストで，定義ファイルの変更など，メンテナンス作業を実行します。

実行系の仮想ホストに対してmonswapコマンドを実行して，系を切り替えます。

# monswap サーバの識別名

下線部分には，実行系の仮想ホストが配置されているアプリケーションサーバの，serversファイルのオペランド「alias」に指定されている実行系の仮想ホストのサーバの識別名を指定します。
実行系の仮想ホストが停止してから，待機していた系が起動します。これによって，メンテナンス済みの仮想ホストが実行系の仮想ホストになります。

切り替え後の実行系のホスト（予備系の仮想ホスト）に対して，必要に応じて，定義の変更に関連した動作確認を実行します。

切り替え後の待機系のホスト（現用系の仮想ホスト）で定義ファイルの編集など，メンテナンス作業を実行します。

切り替え後の実行系の仮想ホスト（予備系のホスト）に対して，必要に応じて，再度monswapコマンドを実行します。

# monswap サーバの識別名

下線部分には，手順2.でmonswapコマンドの引数に指定したサーバの識別名と同じサーバの識別名を指定します。
現用系の仮想ホストを実行系に戻す場合に実行してください。

切り替え後の実行系の仮想ホスト（現用系の仮想ホスト）で，必要に応じて，定義の変更に関連した動作確認を実行します。
これで，メンテナンス時の起動と停止の手順は完了です。

9.3　N:1リカバリシステムの起動と停止

この節では，HAモニタによるN:1リカバリシステムを利用する場合の，システムの起動と停止の手順について説明します。なお，HAモニタが利用できるのは，AIX，HP-UXまたはLinuxの場合だけです。Solarisの場合，HAモニタは利用できません。

HAモニタによるN:1リカバリシステムを利用して運用する場合は，あらかじめ実行系と待機系の2種類のホストの用意や，HAモニタの監視の対象となる運用管理エージェントを監視・起動・停止するスクリプトの登録など，必要な環境設定をしておく必要があります。設定方法については，マニュアル「Cosminexus　システム構築ガイド」システムの起動と停止の設定に関する説明を参照してください。

ポイント

HAモニタによるN:1リカバリシステムを利用する場合，Management Serverは運用管理サーバで起動して，個々のアプリケーションサーバのホストでは，運用管理エージェントだけを起動します。なお，個々のアプリケーションサーバのホストでは，運用管理エージェントをOS起動と同時に起動する設定にしないでください。

また，次のコマンドは，HAモニタが提供しているコマンドです。詳細は，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

monbegin（HAモニタとのインタフェースを持たないサーバを起動）

monend（HAモニタとのインタフェースを持たない実行サーバの停止連絡）

参考

HAモニタの動作中の系を区別する場合，「実行系」と「待機系」の2種類の系に分けられます。

実行系
業務処理を実行するN台のアプリケーションサーバがある系のことです。

待機系
1台のリカバリ専用サーバがある系のことです。

＜この節の構成＞

9.3.1　N:1リカバリシステムの起動

9.3.2　N:1リカバリシステムの停止

9.3.1　N:1リカバリシステムの起動

HAモニタによるN:1リカバリシステムを利用する場合のシステム起動時の留意事項，およびシステムの起動手順について説明します。

＜この項の構成＞

(1)　システム起動時の留意事項

(2)　システムの起動手順

(1)　システム起動時の留意事項

HAモニタによるN:1リカバリシステムを利用する場合のシステム起動時の留意事項を次に示します。

実行系と待機系のホストに配置されたHAモニタは，OSの起動と同時に起動されています。

運用管理サーバを起動していない場合は，運用管理サーバをあらかじめ起動しておいてください。運用管理サーバの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

(2)　システムの起動手順

HAモニタによるN:1リカバリシステムを利用する場合のシステムの起動手順を次に示します。

待機系のホストで，各実行系に対応するmonbeginコマンドをN回実行します。

# monbegin サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されている実行系のサーバの識別名を指定します。
これによって，待機系のリカバリ専用サーバが実行系の監視を開始します。

実行系の各ホスト（N台）でmonbeginコマンドを実行して，実行系の各ホストの運用管理エージェントを起動します。

# monbegin サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
これによって，実行系の各ホストの運用管理エージェントが起動します。

注意

Management Server起動時に運用管理ドメイン内の論理サーバを一括起動する設定にしていない場合は，実行系のホストの論理サーバを起動してください。なお，Management Server起動時に運用管理ドメイン内の論理サーバを一括起動するように設定にしている場合，論理サーバの手動起動は不要です。起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

参考

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

9.3.2　N:1リカバリシステムの停止

HAモニタによるN:1リカバリシステムを利用する場合のシステムの停止手順を次に示します。

運用管理エージェントを停止するスクリプトで，運用管理ドメイン内の論理サーバを停止する設定にしていない場合は，実行系のホストで各論理サーバを停止します。
運用管理エージェントを停止するスクリプトで論理サーバを停止する設定にしている場合は，不要な手順です。論理サーバの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

実行系の各ホスト（N台）でmonendコマンドを実行して，実行系のホストの運用管理エージェントを停止します。

# monend サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されているサーバの識別名を指定します。
これによって，実行系の各ホストの運用管理エージェントが停止します。

参考

serversファイルの定義（HAモニタでのサーバの環境設定）については，マニュアル「Cosminexus　システム構築ガイド」のHAモニタの設定に関する説明を参照してください。

なお，運用管理サーバは最後に手動で停止します。運用管理サーバの停止方法については，マニュアル「Cosminexus　運用管理操作ガイド」の運用管理ポータルと運用管理コマンドによるシステムの起動と停止に関する説明を参照してください。

付録

＜この付録の構成＞

付録A　トレース取得ポイントとPRFトレース取得レベル

付録B　snapshotログの収集対象一覧

付録C　データベースと接続中にトラブルが発生したコネクションの特定

付録D　機能ごとに出力されるログ情報

付録E　障害発生時のCMR用の表の回復

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

付録G　サーブレットエンジンモードでのシステム運用

付録H　代替手段で実行できる運用作業

付録I　用語解説

付録A　トレース取得ポイントとPRFトレース取得レベル

ここでは，トレース取得ポイントとPRFトレース取得レベルについて説明します。

トレース取得ポイントは大きく分けて，J2EEサーバの開始・終了時でのトレース取得と，各機能レイヤでの処理中のトレース取得があります。

J2EEサーバの開始・終了時のトレース取得
J2EEサーバの開始処理の完了時，およびJ2EEサーバの終了処理の開始時に，トレース情報を取得できます。取得できるイベントIDと参照先を次に示します。

イベントID
0x8FFE～0x8FFF

参照先
J2EEサーバの開始・終了時のトレース取得の詳細については，「付録A.16　J2EEサーバの開始・終了時のトレース取得ポイント」を参照してください。

各機能レイヤでのトレース取得
取得できるイベントIDと機能レイヤの対応を次の表に示します。

表A-1　取得できるイベントIDと機能レイヤ

イベントID
機能レイヤ
図中の番号※
参照先

0x1101～0x1102
0x1301～0x1302
0x1401～0x1406
0x2002～0x2003
0x2101～0x2104
0x3000～0x3008
CTM
5
付録A.1

0x8000～0x8004
0x8100～0x8104
リダイレクタ
1
付録A.2

0x8200～0x8203
0x8206～0x8218
0x8300～0x8303
0x8306～0x8307
0x8311～0x8318
0x8E01～0x8E06
Webコンテナ
2
付録A.3
付録A.4
付録A.5
付録A.6

0x8401～0x840A
0x8425～0x8428
0x842D～0x8434
0x8453～0x8454
0x8460～0x846D
0x8470～0x8477
0x8490～0x8491
0x8C41
EJBコンテナ
6
付録A.7

0x8603～0x861C
JNDI
4
付録A.8

0x8811～0x8820
0x8C41
JTA
7
付録A.9

0x8B00～0x8B01
0x8B80～0x8B89
0x8B8A～0x8C03
0x8C10～0x8C13
0x8C20～0x8C41
0x8C60～0x8C65
0x8C80～0x8C93
0x8CC0～0x8CD9
0x8D00～0x8D19
0x8D60～0x8D63
0x8D80～0x8D89
0x8D8A～0x8D8F
0x8D90～0x8D99
DB Connector，JCAコンテナ
8
付録A.10

0x8E01～0x8E06
RMI
3
付録A.11

0x9400～0x94FF
OTS
9
付録A.12

0x9C00～0x9C03
標準出力／標準エラー出力／ユーザログ
－
付録A.13

0x9D00，0x9D01
DI
10
付録A.14

0xA100，0xA101
バッチアプリケーション実行機能
11
付録A.15

（凡例）

－：該当しません。

注※

図A-1～図A-3中の番号と対応しています。

機能レイヤとトレース取得ポイントについて，次の図に示します。

図A-1　トレース取得ポイント（Webクライアント構成の場合）

図A-2　トレース取得ポイント（バッチアプリケーションを実行するシステムの場合）

図A-3　トレース取得ポイント（EJBクライアント/CORBAクライアント/OTMクライアント構成の場合）

トレース取得ポイントは，各機能レイヤ内でさらに詳細に分かれており，トレース取得ポイントによって，PRFトレース取得レベルが異なります。各機能レイヤの詳細なトレース取得ポイント，およびPRFトレース取得レベルについては，付録A.1～付録A.15を参照してください。

参考

表A-1に示した機能レイヤのほか，Application Serverのプロセス，構成ソフトウェアおよび関連プログラムでも，PRFトレースが取得できるものがあります。

表A-1に示した以外でPRFトレースを取得できる機能レイヤとイベントIDの対応を，次の表に示します。

表A-2　表A-1に示した以外でPRFトレースを取得できる機能レイヤとイベントIDの対応

イベントID
機能レイヤ

0x9000～0x90FF

Cosminexus Web Services - Base

0x9100～0x91FF

uCosminexus TP1 Connector

TP1/Client/J

0x9200～0x92FF

TP1/MQ Access

0x9300～0x93FF

Cosminexus RM

0x9800～0x9B6E

HCSCサーバ

0x9F00～0x9FFF

uCosminexus Service Adapter for Object Access

0x9E00～0x9EFF

uCosminexus Service Coordinator Interactive Workflow

0xA000～0xA0FF

uCosminexus Service Adapter for Flat Files

なお，ここではトレース取得レベルが標準レベルと詳細レベルのトレース取得ポイントについて説明します。保守レベルは，障害発生時などの保守情報を取得するためのレベルのため，通常は収集する必要はありません。

＜この節の構成＞

付録A.1　CTMのトレース取得ポイント

付録A.2　リダイレクタのトレース取得ポイント

付録A.3　Webコンテナのトレース取得ポイント（リクエスト処理のトレース）

付録A.4　Webコンテナのトレース取得ポイント（セッショントレース）

付録A.5　Webコンテナのトレース取得ポイント（フィルタのトレース）

付録A.6　Webコンテナのトレース取得ポイント（セッションフェイルオーバ機能のトレース）

付録A.7　EJBコンテナのトレース取得ポイント

付録A.8　JNDIのトレース取得ポイント

付録A.9　JTAのトレース取得ポイント

付録A.10　DB Connector，JCAコンテナのトレース取得ポイント

付録A.11　RMIのトレース取得ポイント

付録A.12　OTSのトレース取得ポイント

付録A.13　標準出力／標準エラー出力／ユーザログのトレース取得ポイント

付録A.14　DIのトレース取得ポイント

付録A.15　バッチアプリケーション実行機能のトレース取得ポイント

付録A.16　J2EEサーバの開始・終了時のトレース取得ポイント

付録A.1　CTMのトレース取得ポイント

ここでは，CTMでのトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-3　CTMでのトレース取得ポイントの詳細

イベントID
図中の番号※
トレース取得ポイント
レベル

0x1101
21
OTMゲートウェイからのリクエスト送信直前
A

0x1102
22
OTMゲートウェイからのレスポンス受信直前
A

0x1301
4
EJBレギュレータからのリクエスト送信直前
A

0x1302
13
EJBレギュレータへのレスポンス受信直後
A

0x1401
1
CTM内のCreateメソッドの入り口
A

0x1402
2
CTM内のCreateメソッドの出口
A

0x1403
5
EJBレギュレータからのリクエスト受信直後
A

0x1404
8
CTMからJ2EEサーバへのリクエスト送信直前
A

0x1405
9
CTMでの，J2EEサーバからのリクエスト受信直後
A

0x1406
12
CTMからEJBレギュレータへのレスポンス送信直前
A

0x2002
23
OTMクライアントからのリクエスト受信直前
A

0x2003
24
OTMクライアントからのレスポンス受信直前
A

0x2101
3
EJBクライアントからのリクエスト受信直後
A

0x2102
14
EJBクライアントへのレスポンス送信直前
A

0x2103
15
CTM内のRemoveメソッドの入り口
A

0x2104
16
CTM内のRemoveメソッドの出口
A

0x3000
6
リクエストをキューイングする直前
A

0x3001
7
キューからリクエストを取り出した直後
A

0x3002
17
他CTMへのリクエスト送信直前
A

0x3003
18
他CTMからのリクエスト受信直後
A

0x3004
10
リクエスト応答をキューイングする直前
B

0x3005
11
キューからリクエスト応答を取り出した直後
B

0x3006
19
他CTMへのリクエスト応答送信直前
A

0x3007
20
他CTMからのリクエスト応答受信直後
A

0x3008
－
サーバ状態変更時に取得されます。
（リクエスト処理中には取得されません）
B

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※

図A-4～図A-7中の番号と対応しています。

CTMでのトレース取得ポイントを次の図に示します。

図A-4　CTMのトレース取得ポイント

ほかのCTMと連携している場合は，次の図に示す場所でもトレース情報を取得します。上記の図とあわせて参照してください。なお，この図では，ほかのCTMと連携している個所だけを取り上げています。

図A-5　CTMのトレース取得ポイント（他CTMと連携している場合）

また，OTMゲートウェイまたはORBゲートウェイを使用する場合は，次の図に示す場所でもトレース情報を取得します。上記の図とあわせて参照してください。なお，この図では，ほかのCTMと連携している個所だけを取り上げています。

図A-6　CTMのトレース取得ポイント（OTMゲートウェイを使用する場合）

図A-7　CTMのトレース取得ポイント（ORBゲートウェイを使用する場合）

●取得できるトレース情報

CTMで取得できるトレース情報を次の表に示します。

表A-4　CTMで取得できるトレース情報

図中の番号※ | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x1401 | A | リモートインタフェース名 | メソッド名 | －
2 | 0x1402 | A | リモートインタフェース名 | メソッド名 | 内部情報
3 | 0x2101 | A | リモートインタフェース名 | メソッド名 | －
4 | 0x1301 | A | リモートインタフェース名 | メソッド名 | －
5 | 0x1403 | A | リモートインタフェース名 | メソッド名 | －
6 | 0x3000 | A | － | － | －
7 | 0x3001 | A | － | － | 内部情報
8 | 0x1404 | A | リモートインタフェース名 | メソッド名 | 内部情報
9 | 0x1405 | A | リモートインタフェース名 | メソッド名 | 内部情報
10 | 0x3004 | B | － | － | －
11 | 0x3005 | B | － | － | 内部情報
12 | 0x1406 | A | リモートインタフェース名 | メソッド名 | －
13 | 0x1302 | A | リモートインタフェース名 | メソッド名 | －
14 | 0x2102 | A | リモートインタフェース名 | メソッド名 | －
15 | 0x2103 | A | リモートインタフェース名 | メソッド名 | －
16 | 0x2104 | A | リモートインタフェース名 | メソッド名 | －
17 | 0x3002 | A | － | － | －
18 | 0x3003 | A | － | － | －
19 | 0x3006 | A | － | － | －
20 | 0x3007 | A | － | － | －
21 | 0x1101 | A | リモートインタフェース名 | メソッド名 | －
22 | 0x1102 | A | リモートインタフェース名 | メソッド名 | －
23 | 0x2002 | A | リモートインタフェース名 | メソッド名 | －
24 | 0x2003 | A | リモートインタフェース名 | メソッド名 | －
－ | 0x3008 | B | － | － | 内部情報

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※

図A-4～図A-7中の番号と対応しています。

付録A.2　リダイレクタのトレース取得ポイント

ここでは，リダイレクタのトレース取得ポイントと，取得できるトレース情報について説明します。

なお，PRFトレース取得レベルを「詳細」にしている場合，リクエスト処理のトレースとセッショントレースが出力されます。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。なお，「0x8003」のポイントで，セッショントレースは出力されません。

表A-5　リダイレクタでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8000 | 1 | リクエスト処理要求の取得後 | A／B
0x8001 | 2 | Webコンテナへのリクエストヘッダ情報の送信 | A／B
0x8002 | 3 | WebコンテナからのHTTPリクエストボディ情報の要求受信 | B
0x8003 | 5 | WebコンテナからのHTTPレスポンスヘッダ情報の受信 | B
0x8004 | 7 | WebコンテナからのHTTPレスポンスボディ情報の送信開始 | B
0x8100 | 10 | リダイレクタ処理完了 | A／B
0x8101 | 9 | Webコンテナからのレスポンス完了通知の受信 | A／B
0x8102 | 4 | WebコンテナへのHTTPリクエストボディ情報の送信完了 | B
0x8103 | 6 | WebサーバへのHTTPレスポンスヘッダ情報の設定完了 | B
0x8104 | 8 | WebサーバへのHTTPレスポンスボディ情報の送信完了 | B

（凡例）　　B：詳細　　A／B：標準と詳細で異なる情報を取得

注※

図A-8中の番号と対応しています。

リダイレクタでのトレース取得ポイントを次の図に示します。

図A-8　リダイレクタのトレース取得ポイント

コネクションは，通常，常設コネクションのために使い回されるため，リクエストのたびに切断されることはありません。コネクションは，通信で例外が発生した場合，または常設コネクションの上限数に達していた場合だけ切断されます。

なお，3と4のポイントでは，Webコンテナからリクエストボディ情報の要求があった場合だけトレース情報が出力されます。また，3，4，7，8のポイントでは，リクエストボディ情報とレスポンスボディ情報が複数回クライアントに送信されることがあるため，トレース情報も複数回出力されることがあります。

また，次に示すポイントでは，無効なセッションIDを取得する場合や，セッションIDを取得しない場合があります。

1～4のポイント

セッションIDを取得できます。ただし，リクエストヘッダのCookieまたはURLからセッションIDを取得するため，無効なセッションID（J2EEアプリケーションで破棄されたHttpSessionのIDまたは有効期限切れで破棄されたHttpSessionのID）を取得する場合があります。

また，有効なセッションIDを取得した場合も，J2EEアプリケーションでセッションが破棄されることがあります。

6～10のポイント

セッションを生成した場合だけ，セッションIDを取得できます。

●取得できるトレース情報

リダイレクタで取得できるトレース情報を次の表に示します。

表A-6　リダイレクタで取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8000 | A／B | クライアントのアドレス：HTTPメソッド | URI | ※2
2 | 0x8001 | A／B | コンテナのアドレス：ポート番号 | － | ※2
3 | 0x8002 | B | 要求サイズ | － | <セッションID文字数:セッションID:取得方法>
4 | 0x8102 | B | 読み込んだサイズ | － | <入り口時刻><セッションID文字数:セッションID:取得方法>
5 | 0x8003 | B | － | － | －
6 | 0x8103 | B | － | － | ※3
7 | 0x8004 | B | 送信サイズ | － | セッションID
8 | 0x8104 | B | 送信できたサイズ | － | <入り口時刻><セッションID文字数:セッションID>
9 | 0x8101 | A／B | コンテナのアドレス：ポート番号 | － | ※4
10 | 0x8100 | A／B | クライアントのアドレス：HTTPメソッド | URI | ※5

（凡例）　　B：詳細　　A／B：標準と詳細で異なる情報を取得

－：該当なし

注※1

図A-8中の番号と対応しています。

注※2

レベルが「標準」の場合，何も出力されません。

レベルが「詳細」の場合，セッションID文字数:セッションID:取得方法が出力されます。

注※3

正常に処理された場合，入り口時刻とセッションIDが表示されます。

例外が発生した場合，入り口時刻に加え，4バイトの保守情報，およびセッションID文字数:セッションIDが表示されます。

注※4

レベルが「標準」の場合，入り口時刻が表示されます。

レベルが「詳細」の場合，入り口時刻に加え，セッションID文字数:セッションIDが表示されます。

注※5

レベルがAの場合，常に，入り口時刻とステータスコードが表示されます。

ただし，Microsoft IIS使用時に例外が発生した場合は，入り口時刻とステータスコードに加え，4バイトの保守情報が表示されます。

レベルがBの場合，レベルがAの場合の情報に加え，セッションID文字数:セッションIDが表示されます。

付録A.3　Webコンテナのトレース取得ポイント（リクエスト処理のトレース）

ここでは，Webコンテナのトレース取得ポイントと，取得できるトレース情報について説明します。なお，Webコンテナでは，リクエスト処理のトレースとセッショントレースが出力されます。ここでは，リクエスト処理のトレースについて説明します。また，インプロセスHTTPサーバを使用したときのトレースポイントと取得できるトレース情報についても説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-7　Webコンテナでのトレース取得ポイントの詳細（リクエスト処理のトレース）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8200 | 1 | リクエスト取得・リクエストヘッダ解析完了 | Webサーバ経由の場合 | A
0x8201 | 簡易Webサーバ経由の場合 | A
0x8202 | 3 | サーブレット／JSPの呼び出し | A
0x8203 | 2 | フィルタ呼び出し | B
0x8206 | 4 | RequestDispatcher経由のサーブレット／JSP呼び出し | B
0x8207 | 3 | 静的コンテンツの呼び出し | B
0x8300 | 8 | リクエスト処理完了 | Webサーバ経由の場合 | A
0x8301 | 簡易Webサーバ経由の場合 | A
0x8302 | 6 | サーブレット／JSPの処理完了 | A
0x8303 | 7 | フィルタ処理完了 | B
0x8306 | 5 | RequestDispatcher経由のサーブレット／JSP処理完了 | B
0x8307 | 6 | 静的コンテンツの処理完了 | B

（凡例）　　A：標準　　B：詳細

注※

図A-9中の番号と対応しています。

Webコンテナでのトレース取得ポイントを次の図に示します。

図A-9　Webコンテナのトレース取得ポイント（リクエスト処理のトレース）

●取得できるトレース情報

Webコンテナで取得できるトレース情報を次の表に示します。

表A-8　Webコンテナで取得できるトレース情報（リクエスト処理のトレース）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8200 | A | HTTPメソッド | URI | －
0x8201 | A | HTTPメソッド | URI | －
2 | 0x8203 | B | クラス名 | － | －
3 | 0x8202 | A | クラス名またはJSP名 | － | －
0x8207 | B | － | － | －
4 | 0x8206 | B | クラス名 | ディスパッチのタイプ | －
5 | 0x8306 | B | クラス名 | ディスパッチのタイプ | ※2
6 | 0x8302 | A | クラス名またはJSP名 | － | ※2
0x8307 | B | － | － | ※2
7 | 0x8303 | B | クラス名 | － | ※2
8 | 0x8300 | A | HTTPメソッド | URI | ※3
0x8301 | A | HTTPメソッド | URI | ※3

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-9中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻と例外名が表示されます。

注※3

正常に処理された場合，入り口時刻およびステータスコードが表示されます。

なお，Webサーバ経由の場合（イベントIDが0x8300の場合），レスポンス送信時にリダイレクタとの接続が切れていた場合も，入り口時刻ステータスコードが表示されます。

例外が発生した場合，入り口時刻，ステータスコード，および例外名が表示されます。

参考

SOAPクライアント以外のリクエストを受信した場合，トレース情報のキー情報である「クライアントアプリケーション情報」には，常に0が表示されます。SOAPクライアントのリクエストを受信した場合だけ，「クライアントアプリケーション情報」が出力されます。

●トレース取得ポイントとPRFトレース取得レベル（インプロセスHTTPサーバを使用した場合）

インプロセスHTTPサーバを使用した場合のイベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-9　インプロセスHTTPサーバでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8202 | 5 | サーブレット／JSP呼び出し | A
0x8203 | 4 | フィルタ呼び出し | B
0x8206 | 6 | RequestDispatcher経由のサーブレット／JSP呼び出し | B
0x8207 | 5 | 静的コンテンツの呼び出し | B
0x8211 | 3 | リクエスト取得時，リクエストヘッダ解析完了時 | A
0x8212 | 1 | Webクライアントからのデータ読み込み開始時 | B
0x8213 | 8 | Webクライアントへのデータ書き込み開始時 | B
0x8302 | 10 | サーブレット／JSP処理完了 | A
0x8303 | 11 | フィルタ処理完了 | B
0x8306 | 7 | RequestDispatcher経由のサーブレット／JSP処理完了 | B
0x8307 | 10 | 静的コンテンツの処理完了 | B
0x8311 | 12 | リクエスト処理完了時 | A
0x8312 | 2 | Webクライアントからのデータ読み込み完了時 | B
0x8313 | 9 | Webクライアントへのデータ書き込み完了時 | B

（凡例）　　A：標準　　B：詳細

注※

図A-10中の番号と対応しています。

インプロセスHTTPサーバを使用した場合のトレース取得ポイントを次の図に示します。

図A-10　インプロセスHTTPサーバのトレース取得ポイント

なお，1および2のポイントはリクエスト情報をクライアントから複数回受信することがあるため，トレース情報も複数回出力されることがあります。

8および9のポイントはレスポンス情報が複数回クライアントに送信されることがあるため，トレース情報も複数回出力されることがあります。

フィルタからリクエストボディ情報の要求や，レスポンスの送信を行なった場合も，1および2または8および9のトレースは出力されます。

●取得できるトレース情報

インプロセスHTTPサーバで取得できるトレース情報を次の表に示します。

表A-10　インプロセスHTTPサーバで取得できるトレース情報（リクエスト処理のトレース）

図中の番号※1
イベントID
レベル
取得できる情報

インタフェース名
オペレーション名
オプション

1
0x8212
B
要求サイズ
－
－

2
0x8312
B
読み込んだサイズ
－
※2

3
0x8211
A
HTTPメソッド
URI
－

4
0x8203
B
クラス名
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

5
0x8202
A
クラス名またはJSPファイル名
－
－

0x8207
B
－
－
※2

6
0x8206
B
クラス名
ディスパッチのタイプ
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

7
0x8306
B
クラス名
ディスパッチのタイプ
コンテキストルート名
※3

8
0x8213
B
書き込みサイズ
－
－

9
0x8313
B
書き込んだサイズ
－
※2

10
0x8302
A
クラス名またはJSPファイル名
－
※3

0x8307
B
－
－
※2

11
0x8303
B
クラス名
コンテキストルート名
※3

12
0x8311
A
HTTPメソッド
URI
入り口時刻ステータスコード

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-10中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

注※3

正常に処理された場合，入り口時刻とセッションID文字数:セッションIDが表示されます。

例外が発生した場合，入り口時刻と例外名に加えて，セッションID文字数:セッションIDが表示されます。

付録A.4　Webコンテナのトレース取得ポイント（セッショントレース）

ここでは，Webコンテナのトレースのトレース取得ポイントと，取得できるトレース情報について説明します。なお，Webコンテナでは，リクエスト処理のトレースとセッショントレースが出力されます。ここでは，セッショントレース，およびグローバルセッションについてのトレース取得ポイントと取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル（セッショントレース）

セッショントレースに関連するトレースの，イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。なお，「0x8203」，「0x8202」，「0x8207」，「0x8206」および「0x8300」では，グローバルセッションについての情報も出力されます。

表A-11　Webコンテナでのトレース取得ポイントの詳細（セッショントレース）

イベントID
図中の番号※1
トレース取得ポイント
レベル※2

0x8200
1
リクエスト取得・リクエストヘッダ解析完了時（Webサーバ経由の場合）
A

0x8202
4，9
サーブレット／JSP呼び出し
A

0x8203
2，3
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し
（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略した場合，または<dispatcher>タグで"REQUEST"を指定したフィルタを呼び出した場合）
B

0x8206
7
RequestDispatcher経由のサーブレット／JSP呼び出し
B

0x8207
4，9
静的コンテンツ呼び出し（DefaultServlet）
B

0x8208
5
セッション生成後
B

0x8209
6
セッション破棄後
B

0x8210
17
セッションタイムアウト後
B

0x8211
1
リクエスト取得・リクエストヘッダ解析完了（インプロセスHTTPサーバ経由の場合）
A

0x8214
8
フォワード時に実行されるフィルタの呼び出し
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"FORWARD"を指定したフィルタを呼び出した場合）
B

0x8215
8
インクルード時に実行されるフィルタの呼び出し
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"INCLUDE"を指定したフィルタを呼び出した場合）
B

0x8216
2
エラーページに転送される際に実行されるフィルタの呼び出し
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタを呼び出した場合）
B

0x8300
16
リクエスト処理完了（Webサーバ経由の場合）
A

0x8302
10，13
サーブレット／JSP処理完了
A

0x8303
14，15
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了
（web.xmlの<filter-mapping>タグの<dispatcher>タグで""REQUEST""を指定したフィルタの処理が完了した場合）
B

0x8306
12
RequestDispatcher経由のサーブレット／JSP処理完了
B

0x8307
10，13
静的コンテンツ処理完了（DefaultServlet）
B

0x8311
16
リクエスト処理完了（インプロセスHTTPサーバ経由の場合）
A

0x8314
11
フォワード時に実行されるフィルタの処理完了
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"FORWARD"を指定したフィルタの処理が完了した場合）
B

0x8315
11
インクルード時に実行されるフィルタの処理完了
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"INCLUDE"を指定したフィルタの処理が完了した場合）
B

0x8316
15
エラーページに転送される際に実行されるフィルタの処理完了
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタの処理が完了した場合）
B

（凡例）　　A：標準　　B：詳細

注※1

図A-11中の番号と対応しています。

注※2

セッショントレースについての情報はレベルが「詳細」の場合だけ出力されます。

Webコンテナでのセッショントレースのトレース取得ポイントを次の図に示します。

図A-11　Webコンテナのトレース取得ポイント（セッショントレース）

それぞれのポイントで取得できるセッションIDについて説明します。

1のポイント

セッションIDを取得できます。ただし，リクエストヘッダのCookieまたはURLからセッションIDを取得するため，無効なセッションID（J2EEアプリケーションで破棄されたHttpSessionのIDまたは有効期限切れで破棄されたHttpSessionのID）を取得する場合があります。

また，有効なセッションIDを取得した場合も，J2EEアプリケーションでセッションが破棄される場合があります。

2，3，4，7，8，9のポイント

トレース取得ポイントで有効なセッションIDを取得できます。ただし，J2EEアプリケーションでセッションが破棄される場合があります。

また，これらのポイントでは，グローバルセッションIDも取得できます。取得できるグローバルセッションIDの内容は，トレース取得ポイントごとに異なります。

2のポイントは，一つのリクエストで最初にイベントID「0x8203」が出力されるトレース取得ポイントです。このトレース取得ポイントでは，Webクライアントからリクエストとして送信されたグローバルセッションIDが取得できます。ただし，このポイントでは，すでに無効になっているグローバルセッションIDが出力される場合もあります。

3，4，7，8，9のポイントで出力される，イベントIDが「0x8216」「0x8202」「0x8203」「0x8206」「0x8207」「0x8214」「0x8215」のトレースには，その時点で有効なグローバルセッションIDが取得できます。

5のポイント

J2EEアプリケーションでセッションが生成された場合だけ，トレース取得ポイントで有効なセッションIDを取得できます。ただし，J2EEアプリケーションでセッションが破棄される場合があります。

6のポイント

J2EEアプリケーションでセッションが破棄された場合だけ，トレース取得ポイントで無効になったセッションIDを取得できます。ただし，J2EEアプリケーションでセッションが破棄される場合があります。

10，11，12，13のポイント

トレース取得ポイントで有効なセッションIDを取得できます。ただし，J2EEアプリケーションでセッションが破棄される場合があります。

14，15のポイント

トレース取得ポイントで有効なセッションIDを取得できます。なお，このトレース取得ポイントでリクエスト処理が完了すると，以降のJ2EEアプリケーションでセッションが破棄されることはありません。

16のポイント

トレース取得ポイントで有効なセッションIDを取得できます。なお，このトレース取得ポイントでリクエスト処理が完了すると，以降のJ2EEアプリケーションでセッションが破棄されることはありません。

また，グローバルセッションを生成した場合，リクエスト処理が終了した時点で有効なグローバルセッションIDを取得できます。

17のポイント

有効期限を超えたセッションが破棄された場合だけ，無効になったセッションIDを取得できます。

●取得できるトレース情報

セッショントレースについて，Webコンテナで取得できるトレース情報を次の表に示します。なお，イベントIDが「0x8202」，「0x8203」，「0x8206」，「0x8207」，「0x8214」，「0x8215」，「0x8300」および「0x8311」のトレース取得ポイントでは，グローバルセッションについての情報も出力されます。

表A-12　Webコンテナで取得できるトレース情報（セッショントレース）

図中の番号※1
イベントID
レベル
取得できる情報

インタフェース名
オペレーション名
オプション

1
0x8200
A
HTTPメソッド
URI
<セッションID文字数:セッションID:取得方法>※2

4，9
0x8202
A
クラス名（JSP呼び出し時はJSPファイル名）
コンテキストルート名※2
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>※2

2，3
0x8203
B
クラス名
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

7
0x8206
B
クラス名
ディスパッチのタイプ
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

4，9
0x8207
B
－
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

5
0x8208
B
コンテキストルート名
セッション有効期間
<セッションID文字数:セッションID>

6
0x8209
B
コンテキストルート名
セッション生成時刻
<セッションID文字数:セッションID>

17
0x8210
B
コンテキストルート名
セッション有効期間:セッション生成時刻
<セッションID文字数:セッションID>

1
0x8211
A
HTTPメソッド
URI
<セッションID文字数:セッションID:取得方法>※2

8
0x8214
B
クラス名
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

8
0x8215
B
クラス名
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

2
0x8216
B
クラス名
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

16
0x8300
A
HTTPメソッド
URI
※3

10，13
0x8302
A
クラス名（JSP呼び出し時はJSPファイル名）
コンテキストルート名※2
※4

14，15
0x8303
B
クラス名
コンテキストルート名
※5

12
0x8306
B
クラス名
ディスパッチのタイプ
コンテキストルート名
※5

10，13
0x8307
B
－
コンテキストルート名
※5

16
0x8311
A
HTTPメソッド
URI
※6

11
0x8314
B
クラス名
コンテキストルート名
※5

11
0x8315
B
クラス名
コンテキストルート名
※5

15
0x8316
B
クラス名
コンテキストルート名
※5

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-11中の番号と対応しています。

注※2

レベルとして「詳細」を指定している場合だけ出力されます。

注※3

正常に処理された場合，またはレスポンス送信時にリダイレクタとの接続が切れていた場合は，指定しているレベルに応じて，次のように出力されます。

「標準」を指定しているときには，入り口時刻，ステータスコードが表示されます。

「詳細」を指定しているときには，入り口時刻，ステータスコード，セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションIDが表示されます。

例外が発生した場合，指定しているレベルに応じて，次のように出力されます。

「標準」を指定しているときには，入り口時刻，ステータスコード，例外名が表示されます。

「詳細」を指定しているときには，入り口時刻，ステータスコード，例外名:セッション文字数:セッションID:グローバルセッションID文字数:グローバルセッションIDが表示されます。

注※4

正常に処理された場合，指定しているレベルに応じて，次のように出力されます。

「標準」を指定しているときには，入り口時刻が表示されます。

「詳細」を指定しているときには，入り口時刻とセッションID文字数:セッションIDが表示されます。

例外が発生した場合，指定しているレベルに応じて，次のように出力されます。

「標準」を指定しているときには，入り口時刻と例外名が表示されます。

「詳細」を指定しているときには，入り口時刻と例外名:セッションID文字数:セッションIDが表示されます。

注※5

正常に処理された場合，入り口時刻とセッションID文字数:セッションIDが表示されます。

例外が発生した場合，入り口時刻と例外名:セッションID文字数:セッションIDが表示されます。

注※6

指定しているレベルに応じて，次のように出力されます。

「標準」を指定している場合は，入り口時刻，ステータスコードが表示されます。

「詳細」を指定している場合は，入り口時刻，ステータスコード，セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションIDが表示されます。

付録A.5　Webコンテナのトレース取得ポイント（フィルタのトレース）

ここでは，フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナのトレースのトレース取得ポイントと，取得できるトレース情報について説明します。

なお，フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナでは，正常に処理が終了した場合と障害が発生した場合で取得できるトレース情報が異なります。ここでは，それぞれの場合について説明します。

なお，JSPのpageディレクティブでerrorPage属性を使用しエラーページを設定して，JSPで例外が発生した場合，リクエストのforwardでエラーページが表示されます。したがって，JSPでエラーページを表示する場合も，forward時のトレースが出力されます。

＜この項の構成＞

(1)　正常に処理が終了した場合のWebコンテナのトレース取得ポイント（フィルタのトレース）

(2)　例外が発生した場合のWebコンテナのトレース取得ポイント（フィルタのトレース）

(1)　正常に処理が終了した場合のWebコンテナのトレース取得ポイント（フィルタのトレース）

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-13　正常終了時のWebコンテナでのトレース取得ポイントの詳細（フィルタのトレース）

イベントID
図中の番号※
トレース取得ポイント
レベル

0x8200
1
リクエスト取得・リクエストヘッダ解析完了時（Webサーバ経由）
A

0x8201
1
リクエスト取得時・リクエストヘッダ解析完了時（簡易Webサーバ経由）
A

0x8211
1
リクエスト取得時・リクエストヘッダ解析完了時（インプロセスHTTPサーバ経由）
A

0x8203
2
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼出し（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略，または<dispatcher>タグで"REQUEST"を指定したフィルタ）
B

0x8202
3
サーブレット／JSPの呼び出し
A／B

0x8206
4
RequestDispatcher経由のサーブレット／JSP呼び出し
B

0x8214
5
フォワード時に実行されるフィルタの呼出し時（web.xmlの<filter-mapping>タグの<dispatcher>タグで"FORWARD"を指定したフィルタ）
B

0x9215
5
インクルード時に実行されるフィルタの呼出し
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"INCLUDE"を指定したフィルタ）
B

0x8202
6
サーブレット／JSPの呼び出し
A／B

0x8207
6
静的コンテンツ呼び出し（DefaultServlet）
B

0x8302
7
サーブレット／JSPの処理完了
A／B

0x8307
7
静的コンテンツ処理完了(DefaultServlet)
B

0x8314
8
フォワード時に実行されるフィルタの処理完了時（web.xmlの<filter-mapping>タグの<dispatcher>タグで"FORWARD"を指定したフィルタ）
B

0x8315
8
インクルード時に実行されるフィルタの処理完了時（web.xmlの<filter-mapping>タグの<dispatcher>タグで"INCLUDE"を指定したフィルタ）
B

0x8306
9
RequestDispatcher経由のサーブレット／JSP処理完了
B

0x8302
10
サーブレット／JSPの処理完了
A／B

0x8303
11
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了時（web.xmlの<filter-mapping>タグの<dispatcher>タグで"REQUEST"を指定したフィルタ）
B

0x8300
12
リクエスト処理完了（Webサーバ経由）
A

0x8301
12
リクエスト処理完了（簡易Webサーバ経由）
A

0x8311
12
リクエスト処理完了（インプロセスHTTPサーバ経由）
A

（凡例）　　A：標準　　B：詳細　　A／B：標準と詳細で異なる情報を取得

注※

図A-12中の番号と対応しています。

フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナでのトレース取得ポイントを次の図に示します。

図A-12　正常終了時のWebコンテナでのトレース取得ポイント（フィルタのトレース）

●取得できるトレース情報

フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナで取得できるトレース情報を次の表に示します。

表A-14　正常終了時のWebコンテナで取得できるトレース情報（フィルタのトレース）

図中の番号※1
イベントID
レベル
取得できる情報

インタフェース名
オペレーション名
オプション

1
0x8200
A
HTTPメソッド
URI
－

0x8201
A
HTTPメソッド
URI
－

0x8211
A
HTTPメソッド
URI
－

2
0x8203
B
クラス名
コンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

3
0x8202
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

レベルがAの場合

何も表示されない

レベルがBの場合

＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

4
0x8206
B
クラス名
ディスパッチのタイプコンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

4
0x8214
B
クラス名
コンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

5
0x9215
B
クラス名
コンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

6
0x8202
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

レベルがAの場合

何も表示されない

レベルがBの場合

＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

0x8207
B
－
コンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

7
0x8302
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

※2

0x8307
B
－
コンテキストルート名
※2

8
0x8314
B
クラス名
コンテキストルート名
※2

0x8315
B
クラス名
コンテキストルート名
※2

9
0x8306
B
クラス名
ディスパッチのタイプコンテキストルート名
※2

10
0x8302
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

※2

11
0x8303
B
クラス名
コンテキストルート名
※2

12
0x8300
A
HTTPメソッド
URI
入り口時刻

0x8301
A
HTTPメソッド
URI
入り口時刻

0x8311
A
HTTPメソッド
URI
入り口時刻

（凡例）　　A：標準　　B：詳細　　A／B：標準と詳細で異なる情報を取得　　－：該当なし

注※1

図A-12中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻，セッション文字数:セッションIDが表示されます。

例外が発生した場合，入り口時刻と例外名，セッション文字数:セッションIDが表示されます。

(2)　例外が発生した場合のWebコンテナのトレース取得ポイント（フィルタのトレース）

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-15　例外が発生した場合のWebコンテナでのトレース取得ポイントの詳細（フィルタのトレース）

イベントID
図中の番号※
トレース取得ポイント
レベル

0x8200
1
リクエスト取得・リクエストヘッダ解析完了時（Webサーバ経由）
A

0x8201
1
リクエスト取得時・リクエストヘッダ解析完了時（簡易Webサーバ経由）
A

0x8211
1
リクエスト取得時・リクエストヘッダ解析完了時（インプロセスHTTPサーバ経由）
A

0x8203
2
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼出し（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略，または<dispatcher>タグで"REQUEST"を指定したフィルタ）
B

0x8202
3
サーブレット／JSPの呼び出し
A／B

0x8302
4
サーブレット／JSPの処理完了
A／B

0x8303
5
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了時（web.xmlの<filter-mapping>タグの<dispatcher>タグで"REQUEST"を指定したフィルタ）
B

0x8206
6
RequestDispatcher経由のサーブレット／JSP呼び出し
B

0x8216
7
エラーページに転送される際に実行されるフィルタの呼出し（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタ）
B

0x8202
8
サーブレット／JSPの呼び出し
A／B

0x8207
8
静的コンテンツ呼び出し（DefaultServlet）
B

0x8302
9
サーブレット／JSPの処理完了
A／B

0x8307
9
静的コンテンツ処理完了(DefaultServlet)
B

0x8316
10
エラーページに転送される際に実行されるフィルタの処理完了
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタ）
B

0x8306
11
RequestDispatcher経由のサーブレット／JSP処理完了
B

0x8300
12
リクエスト処理完了（Webサーバ経由）
A

0x8301
12
リクエスト処理完了（簡易Webサーバ経由）
A

0x8311
12
リクエスト処理完了（インプロセスHTTPサーバ経由）
A

（凡例）　　A：標準　　B：詳細　　A／B：標準と詳細で異なる情報を取得

注※

図A-13中の番号と対応しています。

例外が発生した場合のWebコンテナでのトレース取得ポイントを次の図に示します。

図A-13　例外が発生した場合のWebコンテナでのトレース取得ポイント

●取得できるトレース情報

フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナで取得できるトレース情報を次の表に示します。

表A-16　例外が発生した場合のWebコンテナで取得できるトレース情報（フィルタのトレース）

図中の番号※1
イベントID
レベル
取得できる情報

インタフェース名
オペレーション名
オプション

1
0x8200
A
HTTPメソッド
URI
－

0x8201
A
HTTPメソッド
URI
－

0x8211
A
HTTPメソッド
URI
－

2
0x8203
B
クラス名
コンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

3
0x8202
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

レベルがAの場合

何も表示されない

レベルがBの場合

＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

4
0x8302
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

※2

5
0x8303
B
クラス名
コンテキストルート名
※2

6
0x8206
B
クラス名
ディスパッチのタイプコンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

7
0x8216
B
クラス名
コンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

8
0x8202
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

レベルがAの場合

何も表示されない

レベルがBの場合

＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

0x8207
B
－
コンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

9
0x8302
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

※2

0x8307
B
－
コンテキストルート名
※2

10
0x8316
B
クラス名
コンテキストルート名
＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

11
0x8306
B
クラス名
ディスパッチのタイプコンテキストルート名
※2

12
0x8300
A
HTTPメソッド
URI
入り口時刻

0x8301
A
HTTPメソッド
URI
入り口時刻

0x8311
A
HTTPメソッド
URI
入り口時刻

（凡例）　　A：標準　　B：詳細　　A／B：標準と詳細で異なる情報を取得　　－：該当なし

注※1

図A-13中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻，セッション文字数:セッションIDが表示されます。

例外が発生した場合，入り口時刻と例外名，セッション文字数:セッションIDが表示されます。

付録A.6　Webコンテナのトレース取得ポイント（セッションフェイルオーバ機能のトレース）

ここでは，セッションフェイルオーバ機能を使用した場合のWebコンテナのトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-17　Webコンテナでのトレース取得ポイントの詳細（セッションフェイルオーバ機能）

イベントID
図中の番号※1
トレース取得ポイント
レベル

0x8203
1
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し直前
（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略した場合，または<dispatcher>タグで"REQUEST"を指定したフィルタを呼び出した場合）
B

0x8E01
2
スタブでのリクエスト送信処理の始まり
A

0x8E05
3
サーバ側のリクエスト受信処理
A

0x8405
4
EJBコンテナがリクエストを受信した直後
A

0x8406
5
EJBコンテナがレスポンスを送信する直前
A

0x8E06
6
サーバ側のレスポンス送信処理
A

0x8E02
7
スタブでのレスポンス受信処理の終わり
A

0x8218※2
8
セッションフェイルオーバ機能のデシリアライズ開始直前
A

0x8318※2
9
セッションフェイルオーバ機能のデシリアライズ終了直後
A

0x8203
10
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し直前
（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略した場合，または<dispatcher>タグで"REQUEST"を指定したフィルタを呼び出した場合）
B

0x8202
11
サーブレット／JSP呼び出し直前
A／B

0x8207
11
静的コンテンツ呼び出し直前（DefaultServlet）
B

0x8302
12
サーブレット／JSP処理完了直後
A

0x8307
12
静的コンテンツ処理完了直後（DefaultServlet）
B

0x8303
13
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了直前
（web.xmlの<filter-mapping>タグの<dispatcher>タグで"REQUEST"を指定したフィルタの処理が完了した場合）
B

0x8217※2
14
セッションフェイルオーバ機能のシリアライズ開始直前
A

0x8317※2
15
セッションフェイルオーバ機能のシリアライズ終了直後
A

0x8E01
16
スタブでのリクエスト送信処理の始まり
A

0x8E05
17
サーバ側のリクエスト受信処理
A

0x8405
18
EJBコンテナがリクエストを受信した直後
A

0x8406
19
EJBコンテナがレスポンスを送信する直前
A

0x8E06
20
サーバ側のレスポンス送信処理
A

0x8E02
21
スタブでのレスポンス受信処理の終わり
A

0x8203
22
リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し直前
（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略した場合，または<dispatcher>タグで"REQUEST"を指定したフィルタを呼び出した場合）
B

（凡例）　　A：標準　　B：詳細　　A／B：標準と詳細で異なる情報を取得　　－：該当なし

注※1

図A-14中の番号と対応しています。

注※2

次の条件をすべて満たす場合に出力されます。

・直列化可能クラスのオブジェクトの引き継ぎが有効である。

・直列化対象のセッション情報が存在する。

セッションフェイルオーバ機能でのトレース取得ポイントを次の図に示します。

図A-14　Webコンテナでのトレース取得ポイント（セッションフェイルオーバ機能）

●取得できるトレース情報

セッションフェイルオーバ機能で取得できるトレース情報を次の表に示します。

表A-18　Webコンテナで取得できるトレース情報（セッションフェイルオーバ機能）

図中の番号※1
イベントID
レベル
取得できる情報

インタフェース名
オペレーション名
オプション

1
0x8203
B
クラス名
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

2
0x8E01
A
インタフェース名
オペレーション名
－

3
0x8E05
A
－
－
－

4
0x8405
A
Bean名
メソッド名，引数の数
－

5
0x8406
A
Bean名
メソッド名，引数の数
※3

6
0x8E06
A
－
－
－

7
0x8E02
A
インタフェース名※2
オペレーション名※2
※5

8
0x8218※2
A
リクエストURL
デシリアライズ前のグローバルセッション情報のサイズ（バイト）
グローバルセッションID文字数:グローバルセッションID

9
0x8318※2
A
リクエストURL
デシリアライズ前のグローバルセッション情報のサイズ（バイト）
※4

10
0x8203
B
クラス名
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

11
0x8202
A／B
クラス名（JSP呼び出しの場合はJSP名）

レベルがAの場合

何も表示されない

レベルがBの場合

コンテキストルート名

レベルがAの場合

何も表示されない

レベルがBの場合

＜セッションID文字数：セッションID：グローバルセッションID文字数：グローバルセッションID＞

11
0x8207
B
クラス名
コンテキストルート名
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

12
0x8302
A
クラス名またはJSP名
－
※3

12
0x8307
B
－
コンテキストルート名
※3

13
0x8303
B
クラス名
コンテキストルート名
※3

14
0x8217※2
A
リクエストURL
なし
<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

15
0x8317※2
A
リクエストURL
シリアライズ後のグローバルセッション情報のサイズ（バイト）※6
※4

16
0x8E01
A
インタフェース名
オペレーション名
－

17
0x8E05
A
－
－
－

18
0x8405
A
Bean名
メソッド名，引数の数
－

19
0x8406
A
Bean名
メソッド名，引数の数
※4

20
0x8E06
A
－
－
－

21
0x8E02
A
インタフェース名※2
オペレーション名※2
※5

22
0x8303
B
クラス名
コンテキストルート名
※3

（凡例）　　A：標準　　B：詳細　　A／B：標準と詳細で異なる情報を取得　　－：該当なし

注※1

図A-14中の番号と対応しています。

注※2

次の条件をすべて満たす場合に出力されます。

・直列化可能クラスのオブジェクトの引き継ぎが有効である。

・直列化対象のセッション情報が存在する。

注※3

正常に処理された場合，入り口時刻，セッション文字数:セッションIDが表示されます。

例外が発生した場合，入り口時刻と例外名，セッション文字数:セッションIDが表示されます。

注※4

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

注※5

例外が発生した場合，インタフェース名およびオペレーション名は表示されません。また，オプションには発生した例外が表示されます。

注※6

例外が発生した場合，0が表示されます。

付録A.7　EJBコンテナのトレース取得ポイント

ここでは，EJBコンテナのトレース取得ポイントと，取得できるトレース情報について，Session Bean，Entity Beanの場合，Message-driven Beanの場合，Timer Serviceを使用した場合，およびメソッドキャンセルが発生した場合に分けて説明します。

＜この項の構成＞

(1)　Session Bean，Entity Beanの場合

(2)　Message-driven Bean（EJB2.0）の場合

(3)　Message-driven Bean（EJB2.1）の場合

(4)　Timer Serviceの場合

(5)　メソッドキャンセルが発生した場合

(1)　Session Bean，Entity Beanの場合

Session Bean，Entity Beanのトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-19　Session Bean，Entity Beanでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8401 | 1 | リモートホームインタフェースの場合 | EJBコンテナがリクエストを受信した直後 | A
0x8402 | 4 | EJBコンテナがレスポンスを送信する直前 | A
0x8403 | 1 | ローカルホームインタフェースの場合 | EJBコンテナがリクエストを受信した直後 | A
0x8404 | 4 | EJBコンテナがレスポンスを送信する直前 | A
0x8405 | 1 | リモートコンポーネントインタフェースの場合 | EJBコンテナがリクエストを受信した直後 | A
0x8406 | 4 | EJBコンテナがレスポンスを送信する直前 | A
0x8407 | 1 | ローカルコンポーネントインタフェースの場合 | EJBコンテナがリクエストを受信した直後 | A
0x8408 | 4 | EJBコンテナがレスポンスを送信する直前 | A
0x8409 | 2 | EJBコンテナがEJBのビジネスメソッドをコールバックする直前 | B
0x840A | 3 | EJBのビジネスメソッドのコールバックからリターンした直後 | B
0x8453 | 2 | EJBコンテナがEJBのホームメソッドをコールバックする直前 | B
0x8454 | 3 | EJBのホームメソッドのコールバックからリターンした直後 | B
0x8470 | 1 | リモートビジネスインタフェースの場合 | EJBコンテナがリクエストを受信した直後 | A
0x8471 | 4 | EJBコンテナがレスポンスを送信する直前 | A
0x8472 | 1 | ローカルビジネスインタフェースの場合 | EJBコンテナがリクエストを受信した直後 | A
0x8473 | 4 | EJBコンテナがレスポンスを送信する直前 | A
0x8474 | 1 | リモートビジネスインタフェースの場合 | EJBコンテナがStateful Session Beanのインスタンス作成リクエストを受信した直後 | A
0x8475 | 1 | EJBコンテナがStateful Session Beanのインスタンス作成リクエストのレスポンスを送信する直前 | A
0x8476 | 1 | ローカルビジネスインタフェースの場合 | EJBコンテナがStateful Session Beanのインスタンス作成リクエストを受信した直後 | A
0x8477 | 1 | EJBコンテナがStateful Session Beanのインスタンス作成リクエストのレスポンスを送信する直前 | A

（凡例）　　A：標準　　B：詳細

注※

図A-15中の番号と対応しています。

Session Bean，Entity Beanでのトレース取得ポイントを次の図に示します。

図A-15　Session Bean，Entity Beanのトレース取得ポイント

●取得できるトレース情報

Session Bean，Entity Beanで取得できるトレース情報を次の表に示します。

表A-20　Session Bean，Entity Beanで取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8401 | A | Bean名 | メソッド名，引数の数 | －
0x8403 | A | Bean名 | メソッド名，引数の数 | －
0x8405 | A | Bean名 | メソッド名，引数の数 | －
0x8407 | A | Bean名 | メソッド名，引数の数 | －
0x8470 | A | Bean名 | メソッド名，引数の数 | －
0x8472 | A | Bean名 | メソッド名，引数の数 | －
0x8474 | A | Bean名 | － | －
0x8475 | A | Bean名 | － | ※2
0x8476 | A | Bean名 | － | －
0x8477 | A | Bean名 | － | ※2
2 | 0x8409 | B | Bean名 | メソッド名，引数の数 | －
0x8453 | B | Bean名 | メソッド名，引数の数 | －
3 | 0x840A | B | Bean名 | メソッド名，引数の数 | ※2
0x8454 | B | Bean名 | メソッド名，引数の数 | ※2
4 | 0x8402 | A | Bean名 | メソッド名，引数の数 | ※2
0x8404 | A | Bean名 | メソッド名，引数の数 | ※2
0x8406 | A | Bean名 | メソッド名，引数の数 | ※2
0x8408 | A | Bean名 | メソッド名，引数の数 | ※2
0x8471 | A | Bean名 | メソッド名，引数の数 | ※2
0x8473 | A | Bean名 | メソッド名，引数の数 | ※2

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-15中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

(2)　Message-driven Bean（EJB2.0）の場合

Message-driven Bean（EJB2.0）のトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-21　Message-driven Bean（EJB2.0）でのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8425 | 1 | EJBコンテナでのメッセージ処理の始まり | A
0x8426 | 4 | EJBコンテナでのメッセージ処理の終わり | A
0x8427 | 2 | EJBコンテナがMessage-driven BeanのonMessageメソッドをコールバックする直前 | B
0x8428 | 3 | Message-driven BeanのonMessageメソッドのコールバックからリターンした直後 | B

（凡例）　　A：標準　　B：詳細

注※

図A-16中の番号と対応しています。

Message-driven Bean（EJB2.0）でのトレース取得ポイントを次の図に示します。

図A-16　Message-driven Bean（EJB2.0）のトレース取得ポイント

●取得できるトレース情報

Message-driven Bean（EJB2.0）で取得できるトレース情報を次の表に示します。

表A-22　Message-driven Bean（EJB2.0）で取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8425 | A | Bean名 | － | －
2 | 0x8427 | B | － | － | －
3 | 0x8428 | B | － | － | ※2
4 | 0x8426 | A | Bean名 | － | ※2

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-16中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

(3)　Message-driven Bean（EJB2.1）の場合

Message-driven Bean（EJB2.1）のトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-23　Message-driven Bean（EJB2.1）でのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x842D | 1 | Message-driven BeanのbeforeDelivery()メソッドの呼び出し直後 | A
0x842E | 2 | Message-driven BeanのbeforeDelivery()メソッドのリターン直前 | A
0x842F | 3 | リソースアダプタからMessage-driven Beanのメッセージリスナのメソッドを呼び出した直後 | A
0x8431 | 4 | EJBコンテナがMessage-driven Beanのメッセージリスナのメソッドをコールバックする直前 | A
0x8432 | 5 | Message-driven Beanのメッセージリスナのメソッドのコールバックからリターンした直後 | A
0x8430 | 6 | リソースアダプタから呼び出したMessage-driven Beanのメッセージリスナのメソッドのリターン直前 | A
0x8433 | 7 | Message-driven BeanのafterDelivery()メソッドの呼び出し直後 | A
0x8434 | 8 | Message-driven BeanのafterDelivery()メソッドのリターン直前 | A

（凡例）　　A：標準

注※

図A-17，および図A-18中の番号と対応しています。

Message-driven Bean（EJB2.1）でのトレース取得ポイントを次の図に示します。

図A-17　Message-driven Bean（EJB2.1）のトレース取得ポイント（optionA※の場合）

注※　Connector 1.5仕様に記述されるメッセージ配送オプションを示します。

図A-18　Message-driven Bean（EJB2.1）のトレース取得ポイント（optionB※の場合）

注※　Connector 1.5仕様に記述されるメッセージ配送オプションを示します。

●取得できるトレース情報

Message-driven Bean（EJB2.1）で取得できるトレース情報を次の表に示します。

表A-24　Message-driven Bean（EJB2.1）で取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x842D | A | Bean名 | － | －
2 | 0x842E | A | Bean名 | － | ※2
3 | 0x842F | A | Bean名 | メソッド名 | －
4 | 0x8431 | A | Bean名 | メソッド名 | －
5 | 0x8432 | A | Bean名 | メソッド名 | ※2
6 | 0x8430 | A | Bean名 | メソッド名 | ※2
7 | 0x8433 | A | Bean名 | － | －
8 | 0x8434 | A | Bean名 | － | ※2

（凡例）　　A：標準　　－：該当なし

注※1

図A-17，および図A-18中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

(4)　Timer Serviceの場合

Timer Serviceのトレース取得ポイントと，取得できるトレース情報について説明します。

(a)　createTimerの場合

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-25　Timer Serviceでのトレース取得ポイントの詳細（createTimerの場合）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8460 | 1 | TimerService.createTimer(Date initialExpiration, long intervalDuration, Serializable info)処理開始 | A
0x8462 | 1 | TimerService.createTimer(Date expiration, Serializable info) 処理開始 | A
0x8464 | 1 | TimerService.createTimer(long initialDuration, long intervalDuration, Serializable info) 処理開始 | A
0x8466 | 1 | 'TimerService.createTimer(long duration, Serializable info) 処理開始 | A
0x8461 | 2 | TimerService.createTimer(Date initialExpiration, long intervalDuration, Serializable info)処理終了 | A
0x8463 | 2 | TimerService.createTimer(Date expiration, Serializable info) 処理終了 | A
0x8465 | 2 | 'TimerService.createTimer(long initialDuration, long intervalDuration, Serializable info) 処理終了 | A
0x8467 | 2 | TimerService.createTimer(long duration, Serializable info) 処理終了 | A

（凡例）　　A：標準

注※

図A-19中の番号と対応しています。

createTimerの場合のTimer Serviceでのトレース取得ポイントを次の図に示します。

図A-19　Timer Serviceのトレース取得ポイント（createTimerの場合）

●取得できるトレース情報

createTimerの場合のTimer Serviceで取得できるトレース情報を次の表に示します。

表A-26　Timer Serviceで取得できるトレース情報（createTimerの場合）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8460 | A | コールバック対象Beanのクラス名 | － | 引数情報
1 | 0x8462 | A | コールバック対象Beanのクラス名 | － | 引数情報
1 | 0x8464 | A | コールバック対象Beanのクラス名 | － | 引数情報
1 | 0x8466 | A | コールバック対象Beanのクラス名 | － | 引数情報
2 | 0x8461 | A | コールバック対象Beanのクラス名 | － | ※2
2 | 0x8463 | A | コールバック対象Beanのクラス名 | － | ※2
2 | 0x8465 | A | コールバック対象Beanのクラス名 | － | ※2
2 | 0x8467 | A | コールバック対象Beanのクラス名 | － | ※2

（凡例）　　A：標準　　－：該当なし

注※1

図A-19中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，「入り口時刻：例外名：メッセージ」の形式で情報が表示されます。

(b)　cancelの場合

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-27　Timer Serviceでのトレース取得ポイントの詳細（cancelの場合）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8468 | 1 | javax.ejb.Timer.cancel()処理開始 | A
0x8469 | 2 | javax.ejb.Timer.cancel()処理終了 | A

（凡例）　　A：標準

注※

図A-20中の番号と対応しています。

cancelの場合のTimer Serviceでのトレース取得ポイントを次の図に示します。

図A-20　Timer Serviceのトレース取得ポイント（cancelの場合）

●取得できるトレース情報

cancelの場合のTimer Serviceで取得できるトレース情報を次の表に示します。

表A-28　Timer Serviceで取得できるトレース情報（cancelの場合）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8468 | A | コールバック対象Beanのクラス名 | － | －
2 | 0x8469 | A | コールバック対象Beanのクラス名 | － | ※2

（凡例）　　A：標準　　－：該当なし

注※1

図A-20中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，「入り口時刻：例外名：メッセージ」の形式で情報が表示されます。

(c)　コールバックの場合

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-29　Timer Serviceでのトレース取得ポイントの詳細（コールバックの場合）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x846C | 1 | スレッドがコールバック処理開始 | B
0x846A | 2 | Enterprise Beanのタイムアウトコールバックメソッドをコールバック開始 | A
0x846B | 3 | Enterprise Beanのタイムアウトコールバックメソッドをコールバック終了 | A
0x846D | 4 | スレッドがコールバック処理終了 | B

（凡例）　　A：標準　　B：詳細

注※

図A-21中の番号と対応しています。

コールバックの場合のTimer Serviceでのトレース取得ポイントを次の図に示します。

図A-21　Timer Serviceのトレース取得ポイント（コールバックの場合）

●取得できるトレース情報

コールバックの場合のTimer Serviceで取得できるトレース情報を次の表に示します。

なお，ルートアプリケーション情報には，タイムアウトメソッドのコールバック時に取得する情報が出力されます。また，クライアントアプリケーション情報には「0」が出力されます。

表A-30　Timer Serviceで取得できるトレース情報（コールバックの場合）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x846C | B | コールバック対象Beanのクラス名 | － | －
2 | 0x846A | A | コールバック対象Beanのクラス名 | － | －
3 | 0x846B | B | コールバック対象Beanのクラス名 | － | ※2
4 | 0x846D | A | コールバック対象Beanのクラス名 | － | ※2

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-21中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，「入り口時刻：例外名：メッセージ」の形式で情報が表示されます。

(5)　メソッドキャンセルが発生した場合

メソッドキャンセルが発生した場合のトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-31　メソッドキャンセルが発生した場合のトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8490 | 1 | メソッドキャンセル処理開始 | A
0x8C41 | 2 | 障害調査用SQL出力 | A
0x8491 | 3 | メソッドキャンセル処理完了 | A

（凡例）　　A：標準

注※

図A-22中の番号と対応しています。

メソッドキャンセルが発生した場合のトレース取得ポイントを次の図に示します。

図A-22　メソッドキャンセルが発生した場合のトレース取得ポイント

●取得できるトレース情報

メソッドキャンセルが発生した場合に取得できるトレース情報を次の表に示します。

表A-32　メソッドキャンセルが発生した場合に取得できるトレース情報

図中の番号※ | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8490 | A | メソッドキャンセル対象のアプリケーションのルートアプリケーション情報 | － | －
2 | 0x8C41 | A | トランザクションタイムアウト，J2EEアプリケーション強制停止，またはメソッドキャンセルされたコネクションのルートアプリケーション情報 | － | SQL文
3 | 0x8491 | A | － | － | 入り口時刻

（凡例）　　A：標準　　－：該当なし

注※

図A-22中の番号と対応しています。

付録A.8　JNDIのトレース取得ポイント

ここでは，JNDIのトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-33　JNDIでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8603 | 1 | JNDI内部の名前空間，またはCORBAネーミングサービスの検索時 | javax.naming.Context.lookup | 呼び出し直後 | A
0x8604 | 2 | リターン直前 | A
0x8605 | 1 | javax.naming.Context.list | 呼び出し直後 | B
0x8606 | 2 | リターン直前 | B
0x8607 | 1 | javax.naming.Context.listBindings | 呼び出し直後 | B
0x8608 | 2 | リターン直前 | B
0x8609 | 1 | javax.ejb.EJBLocalHomeが保存されている名前空間の検索時 | javax.naming.Context.lookup | 呼び出し直後 | A
0x860A | 2 | リターン直前 | A
0x860B | 1 | javax.naming.Context.list | 呼び出し直後 | B
0x860C | 2 | リターン直前 | B
0x860D | 1 | javax.naming.Context.listBindings | 呼び出し直後 | B
0x860E | 2 | リターン直前 | B
0x860F | 1 | java: 名前空間検索時 | javax.naming.Context.lookup | 呼び出し直後 | A
0x8610 | 2 | リターン直前 | A
0x8611 | 1 | javax.naming.Context.list | 呼び出し直後 | B
0x8612 | 2 | リターン直前 | B
0x8613 | 1 | javax.naming.Context.listBindings | 呼び出し直後 | B
0x8614 | 2 | リターン直前 | B
0x8615 | 1 | ラウンドロビン検索機能利用時 | javax.naming.Context.lookup | 呼び出し直後 | A
0x8616 | 2 | リターン直前 | A
0x8617 | 1 | CORBAネーミングサービス切り替え機能利用時 | javax.naming.Context.lookup | 呼び出し直後 | A
0x8618 | 2 | リターン直前 | A
0x8619 | 1 | javax.naming.Context.list | 呼び出し直後 | B
0x861A | 2 | リターン直前 | B
0x861B | 1 | javax.naming.Context.listBindings | 呼び出し直後 | B
0x861C | 2 | リターン直前 | B

（凡例）　　A：標準　　B：詳細

注※

図A-23中の番号と対応しています。

JNDIでのトレース取得ポイントを次の図に示します。

図A-23　JNDIのトレース取得ポイント

●取得できるトレース情報

JNDIで取得できるトレース情報を次の表に示します。

表A-34　JNDIで取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8603 | A | － | 指定された名前 | －
0x8609 | A
0x860F | A
0x8615 | A
0x8617 | A
0x8605 | B
0x860B | B
0x8611 | B
0x8619 | B
0x8607 | B
0x860D | B
0x8613 | B
0x861B | B
2 | 0x8604 | A | － | ※2
0x860A | A
0x8610 | A
0x8616 | A
0x8618 | A
0x8606 | B
0x860C | B
0x8612 | B
0x861A | B
0x8608 | B
0x860E | B
0x8614 | B
0x861C | B

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-23中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，「入り口時刻：例外名：メッセージ」の形式で情報が表示されます。

参考

JNDIでのトレース情報では，次に示す場合，キー情報である「ルートアプリケーション情報」および「クライアントアプリケーション情報」には，0が表示されます。

クライアントからのlookupメソッドを呼び出す場合

サーバが開始処理中または停止処理中の場合

付録A.9　JTAのトレース取得ポイント

ここでは，JTAのトレース取得ポイントと，取得できるトレース情報について，CMTの場合と，BMTの場合に分けて説明します。

＜この項の構成＞

(1)　CMTの場合

(2)　BMTの場合

(3)　トランザクションタイムアウトの場合

(1)　CMTの場合

CMTの場合のトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-35　CMTでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8811 | 1 | トランザクション開始処理直前 | A
0x8812 | 2 | トランザクション開始処理直後 | A
0x8815 | 3 | トランザクションコミット処理直前 | A
0x8816 | 4 | トランザクションコミット処理直後 | A
0x8817 | 3 | トランザクションロールバック処理直前 | A
0x8818 | 4 | トランザクションロールバック処理直後 | A

（凡例）　　A：標準

注※

図A-24中の番号と対応しています。

CMTのトレース取得ポイントを，次の図に示します。

図A-24　CMTのトレース取得ポイント

●取得できるトレース情報

CMTで取得できるトレース情報を次の表に示します。

表A-36　CMTで取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8811 | A | － | － | －
2 | 0x8812 | A | － | － | ※2
3 | 0x8815 | A | － | － | －
0x8817 | A | － | － | －
4 | 0x8816 | A | － | － | ※2
0x8818 | A | － | － | ※2

（凡例）　　A：標準　　－：該当なし

注※1

図A-24中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

(2)　BMTの場合

BMTの場合のトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-37　BMTでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8813 | 1 | トランザクション開始処理直前 | A
0x8814 | 2 | トランザクション開始処理直後 | A
0x8815 | 3 | トランザクションコミット処理直前 | A
0x8816 | 4 | トランザクションコミット処理直後 | A
0x8817 | 3 | トランザクションロールバック処理直前 | A
0x8818 | 4 | トランザクションロールバック処理直後 | A

（凡例）　　A：標準

注※

図A-25中の番号と対応しています。

BMTのトレース取得ポイントを，次の図に示します。

図A-25　BMTのトレース取得ポイント

●取得できるトレース情報

BMTで取得できるトレース情報を次の表に示します。

表A-38　BMTで取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8813 | A | － | － | －
2 | 0x8814 | A | － | － | ※2
3 | 0x8815 | A | － | － | －
0x8817 | A | － | － | －
4 | 0x8816 | A | － | － | ※2
0x8818 | A | － | － | ※2

（凡例）　　A：標準　　－：該当なし

注※1

図A-25中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

(3)　トランザクションタイムアウトの場合

トランザクションタイムアウトの場合のトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-39　トランザクションタイムアウトでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8819 | 1 | トランザクションタイムアウト処理直前 | A
0x8C41 | 2 | 障害調査用SQL出力 | A
0x8820 | 3 | トランザクションタイムアウト処理直後 | A

（凡例）　　A：標準

注※

図A-26中の番号と対応しています。

トランザクションタイムアウトのトレース取得ポイントを，次の図に示します。

図A-26　トランザクションタイムアウトのトレース取得ポイント

●取得できるトレース情報

トランザクションタイムアウトで取得できるトレース情報を次の表に示します。

表A-40　トランザクションタイムアウトで取得できるトレース情報

図中の番号※ | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8819 | A | タイムアウトしたトランザクションのルートアプリケーション情報 | － | －
2 | 0x8C41 | A | トランザクションタイムアウト，J2EEアプリケーション強制停止，またはメソッドキャンセルされたコネクションのルートアプリケーション情報 | － | SQL文
3 | 0x8820 | A | － | － | 入り口時刻

（凡例）　　A：標準　　－：該当なし

注※

図A-26中の番号と対応しています。

付録A.10　DB Connector，JCAコンテナのトレース取得ポイント

ここでは，DB ConnectorおよびJCAコンテナのトレース取得ポイントと，取得できるトレース情報について説明します。

コネクション関連のトレース取得ポイントには，ローカルトランザクションを使用する場合だけ取得できるものがあります。ここでは，トランザクションサポートレベルに関係なく取得できるトレース取得ポイントと，ローカルトランザクションを使用する場合だけ取得できるトレース取得ポイントの二つに分けて説明します。なお，ここでは，トランザクションサポートレベルに関係なく取得できるトレース取得ポイントを，「コネクション関連のトレース取得ポイント」と呼びます。

＜この項の構成＞

(1)　コネクション関連のトレース取得ポイントと取得できるトレース情報

(2)　ローカルトランザクションを使用する場合のトレース取得ポイントと取得できるトレース情報

(3)　コネクションアソシエーションを使用する場合のトレース取得ポイントと取得できるトレース情報

(4)　コネクション自動クローズ機能を使用する場合のトレース取得ポイントと取得できるトレース情報

(5)　DB Connector for Cosminexus RMと連携する場合のトレース取得ポイントと取得できるトレース情報

(6)　ワーク管理を使用する場合のトレース取得ポイントと取得できるトレース情報

(1)　コネクション関連のトレース取得ポイントと取得できるトレース情報

コネクション関連のトレース取得ポイントと取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，イベントIDごとに，次の四つの表に示します。

0x8B00，0x8B01，0x8B80～0x8B83，0x8C00～0x8C03，0x8C10～0xC13，0x8C20～0x8C29，0x8C2A～0x8C3Fの場合（コネクション関連の処理実行時）
参照先：表A-41

0x8C80～0x8C93の場合（java.sql.Statementインタフェースのメソッド実行時）
参照先：表A-42

0x8CC0～0x8CD9の場合（java.sql.PreparedStatementインタフェースのメソッド実行時）
参照先：表A-43

0x8D00～0x8D19の場合（java.sql.CallableStatementインタフェースのメソッド実行時）
参照先：表A-44

ポイント

イベントID「0x8C41」については，「付録A.7　EJBコンテナのトレース取得ポイント」，および「付録A.9　JTAのトレース取得ポイント」を参照してください。

表A-41　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクション関連の処理実行時）1

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8B00 | 2 | リソースアダプタからのコネクション取得要求呼び出し直後 | B
0x8B01 | 5 | リソースアダプタからのコネクション取得要求リターン直前 | B
0x8B80 | 3 | 物理コネクション作成の呼び出し直前 | B
0x8B81 | 4 | 物理コネクション作成のリターン直後 | B
0x8B82 | 14 | 物理コネクション破棄の呼び出し直前 | B
0x8B83 | 15 | 物理コネクション破棄のリターン直後 | B
0x8C00 | 1 | javax.sql.DataSource.getConnection()での，データベース接続の確立 | 処理開始 | A
0x8C01 | 6 | 処理終了 | A
0x8C02 | 1 | javax.sql.DataSource.getConnection(String username, String password)での，データベース接続の確立 | 処理開始 | A
0x8C03 | 6 | 処理終了 | A
0x8C10 | 1 | コネクションプールのクラスタ化機能使用時のjavax.sql.DataSource.getConnection()での，データベース接続の確立 | 処理開始 | A
0x8C11 | 6 | 処理終了 | A
0x8C12 | 1 | コネクションプールのクラスタ化機能使用時のjavax.sql.DataSource.getConnection(String username, String password)での，データベース接続の確立 | 処理開始 | A
0x8C13 | 6 | 処理終了 | A
0x8C20 | 13 | java.sql.Connection.close()での，ConnectionオブジェクトのデータベースとJDBCリソースの解除 | 処理開始 | A
0x8C21 | 16 | 処理終了 | A
0x8C22 | 11 | java.sql.Connection.commit() | 処理開始 | B
0x8C23 | 12 | 処理終了 | B
0x8C24 | 11 | java.sql.Connection.rollback() | 処理開始 | B
0x8C25 | 12 | 処理終了 | B
0x8C26 | 11 | java.sql.Connection.rollback(Savepoint savepoint) | 処理開始 | B
0x8C27 | 12 | 処理終了 | B
0x8C28 | 7 | java.sql.Connection.createStatement() | 処理開始 | B
0x8C29 | 8 | 処理終了 | B
0x8C2A | 7 | java.sql.Connection.createStatement(int resultSetType, int resultSetConcurrency) | 処理開始 | B
0x8C2B | 8 | 処理終了 | B
0x8C2C | 7 | java.sql.Connection.createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) | 処理開始 | B
0x8C2D | 8 | 処理終了 | B
0x8C2E | 7 | java.sql.Connection.prepareCall(String sql) | 処理開始 | B
0x8C2F | 8 | 処理終了 | B
0x8C30 | 7 | java.sql.Connection.prepareCall(String sql, int resultSetType, int resultSetConcurrency) | 処理開始 | B
0x8C31 | 8 | 処理終了 | B
0x8C32 | 7 | java.sql.Connection.prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) | 処理開始 | B
0x8C33 | 8 | 処理終了 | B
0x8C34 | 7 | java.sql.Connection.prepareStatement(String sql) | 処理開始 | B
0x8C35 | 8 | 処理終了 | B
0x8C36 | 7 | java.sql.Connection.prepareStatement(String sql, int autoGeneratedKeys) | 処理開始 | B
0x8C37 | 8 | 処理終了 | B
0x8C38 | 7 | java.sql.Connection.prepareStatement(String sql, int[] columnIndexes) | 処理開始 | B
0x8C39 | 8 | 処理終了 | B
0x8C3A | 7 | java.sql.Connection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency) | 処理開始 | B
0x8C3B | 8 | 処理終了 | B
0x8C3C | 7 | java.sql.Connection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) | 処理開始 | B
0x8C3D | 8 | 処理終了 | B
0x8C3E | 7 | java.sql.Connection.prepareStatement(String sql, String[] columnNames) | 処理開始 | B
0x8C3F | 8 | 処理終了 | B

（凡例）　　A：標準　　B：詳細

注※

図A-27中の番号と対応しています。

表A-42　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（java.sql.Statementインタフェースのメソッド実行時）2

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8C80 | 9 | execute(String sql) | 処理開始 | B
0x8C81 | 10 | 処理終了 | B
0x8C82 | 9 | execute(String sql, int autoGeneratedKeys) | 処理開始 | B
0x8C83 | 10 | 処理終了 | B
0x8C84 | 9 | execute(String sql, int[] columnIndexes) | 処理開始 | B
0x8C85 | 10 | 処理終了 | B
0x8C86 | 9 | execute(String sql, String[] columnNames) | 処理開始 | B
0x8C87 | 10 | 処理終了 | B
0x8C88 | 9 | executeBatch() | 処理開始 | B
0x8C89 | 10 | 処理終了 | B
0x8C8A | 9 | executeQuery(String sql) | 処理開始 | B
0x8C8B | 10 | 処理終了 | B
0x8C8C | 9 | executeUpdate(String sql) | 処理開始 | B
0x8C8D | 10 | 処理終了 | B
0x8C8E | 9 | executeUpdate(String sql, int autoGeneratedKeys) | 処理開始 | B
0x8C8F | 10 | 処理終了 | B
0x8C90 | 9 | executeUpdate(String sql, int[] columnIndexes) | 処理開始 | B
0x8C91 | 10 | 処理終了 | B
0x8C92 | 9 | executeUpdate(String sql, String[] columnNames) | 処理開始 | B
0x8C93 | 10 | 処理終了 | B

（凡例）　　B：詳細

注※

図A-27中の番号と対応しています。

表A-43　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（java.sql.PreparedStatementインタフェースのメソッド実行時）3

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8CC0 | 9 | execute() | 処理開始 | B
0x8CC1 | 10 | 処理終了 | B
0x8CC2 | 9 | execute(String sql) | 処理開始 | B
0x8CC3 | 10 | 処理終了 | B
0x8CC4 | 9 | execute(String sql, int autoGeneratedKeys) | 処理開始 | B
0x8CC5 | 10 | 処理終了 | B
0x8CC6 | 9 | execute(String sql, int[] columnIndexes) | 処理開始 | B
0x8CC7 | 10 | 処理終了 | B
0x8CC8 | 9 | execute(String sql, String[] columnNames) | 処理開始 | B
0x8CC9 | 10 | 処理終了 | B
0x8CCA | 9 | executeBatch() | 処理開始 | B
0x8CCB | 10 | 処理終了 | B
0x8CCC | 9 | executeQuery() | 処理開始 | B
0x8CCD | 10 | 処理終了 | B
0x8CCE | 9 | executeQuery(String sql) | 処理開始 | B
0x8CCF | 10 | 処理終了 | B
0x8CD0 | 9 | executeUpdate() | 処理開始 | B
0x8CD1 | 10 | 処理終了 | B
0x8CD2 | 9 | executeUpdate(String sql) | 処理開始 | B
0x8CD3 | 10 | 処理終了 | B
0x8CD4 | 9 | executeUpdate(String sql, int autoGeneratedKeys) | 処理開始 | B
0x8CD5 | 10 | 処理終了 | B
0x8CD6 | 9 | executeUpdate(String sql, int[] columnIndexes) | 処理開始 | B
0x8CD7 | 10 | 処理終了 | B
0x8CD8 | 9 | executeUpdate(String sql, String[] columnNames) | 処理開始 | B
0x8CD9 | 10 | 処理終了 | B

（凡例）　　B：詳細

注※

図A-27中の番号と対応しています。

表A-44　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（java.sql.CallableStatementインタフェースのメソッド実行時）4

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8D00 | 9 | execute() | 処理開始 | B
0x8D01 | 10 | 処理終了 | B
0x8D02 | 9 | execute(String sql) | 処理開始 | B
0x8D03 | 10 | 処理終了 | B
0x8D04 | 9 | execute(String sql, int autoGeneratedKeys) | 処理開始 | B
0x8D05 | 10 | 処理終了 | B
0x8D06 | 9 | execute(String sql, int[] columnIndexes) | 処理開始 | B
0x8D07 | 10 | 処理終了 | B
0x8D08 | 9 | execute(String sql, String[] columnNames) | 処理開始 | B
0x8D09 | 10 | 処理終了 | B
0x8D0A | 9 | executeBatch() | 処理開始 | B
0x8D0B | 10 | 処理終了 | B
0x8D0C | 9 | executeQuery() | 処理開始 | B
0x8D0D | 10 | 処理終了 | B
0x8D0E | 9 | executeQuery(String sql) | 処理開始 | B
0x8D0F | 10 | 処理終了 | B
0x8D10 | 9 | executeUpdate() | 処理開始 | B
0x8D11 | 10 | 処理終了 | B
0x8D12 | 9 | executeUpdate(String sql) | 処理開始 | B
0x8D13 | 10 | 処理終了 | B
0x8D14 | 9 | executeUpdate(String sql, int autoGeneratedKeys) | 処理開始 | B
0x8D15 | 10 | 処理終了 | B
0x8D16 | 9 | executeUpdate(String sql, int[] columnIndexes) | 処理開始 | B
0x8D17 | 10 | 処理終了 | B
0x8D18 | 9 | executeUpdate(String sql, String[] columnNames) | 処理開始 | B
0x8D19 | 10 | 処理終了 | B

（凡例）　　B：詳細

注※

図A-27中の番号と対応しています。

DB Connector，JCAコンテナでのトレース取得ポイントを次の図に示します。

図A-27　DB Connector，JCAコンテナのトレース取得ポイント（コネクション関連）

●取得できるトレース情報

DB Connector，JCAコンテナで取得できるトレース情報について，次に示します。ここでは，図A-27の番号と対応づけて説明しています。

番号1～6・9～14に対応するトレース情報
番号1～6・9～14に対応するイベントIDとトレース情報を，次の表に示します。

表A-45　DB Connector，JCAコンテナで取得できるトレース情報（コネクション関連の処理実行時）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8C00 | A | － | － | －
0x8C02 | A | － | － | －
0x8C10 | A | － | － | －
0x8C12 | A | － | － | －
2 | 0x8B00 | B | － | － | －
3 | 0x8B80 | B | － | － | －
4 | 0x8B81 | B | － | － | ※2
5 | 0x8B01 | B | － | － | ※2
6 | 0x8C01 | A | コネクションID | － | ※2
0x8C03 | A | コネクションID | － | ※2
0x8C11 | A | コネクションID | － | ※2
0x8C13 | A | コネクションID | － | ※2
11 | 0x8C22 | B | － | － | －
0x8C24 | B | － | － | －
0x8C26 | B | － | － | －
12 | 0x8C23 | B | － | － | ※2
0x8C25 | B | － | － | ※2
0x8C27 | B | － | － | ※2
13 | 0x8C20 | A | コネクションID | － | －
14 | 0x8B82 | B | － | － | －
15 | 0x8B83 | B | － | － | ※2
16 | 0x8C21 | A | － | － | ※2

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-27中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

番号7に対応するトレース情報
番号7に対応するイベントIDは次のとおりです。
0x8C28，0x8C2A，0x8C2C，0x8C2E，0x8C30，0x8C32，0x8C34，
0x8C36，0x8C38，0x8C3A，0x8C3C，0x8C3E
これらのイベントIDで取得できるトレース情報を示します。

PRFトレース取得レベル
すべて「詳細」です。

インタフェース名，およびオペレーション名
これらのイベントIDでは出力されません。

オプション
メソッドの引数にsqlを持つ場合，SQL文が表示されます。

番号8に対応するトレース情報
番号8に対応するイベントIDは次のとおりです。
0x8C29，0x8C2B，0x8C2D，0x8C2F，0x8C31，0x8C33，0x8C35，
0x8C37，0x8C39，0x8C3B，0x8C3D，0x8C3F
これらのイベントIDで取得できるトレース情報を示します。

PRFトレース取得レベル
すべて「詳細」です。

インタフェース名，オペレーション名
これらのイベントIDでは出力されません。

オプション
これらのイベントIDでは，正常に処理された場合は入り口時刻が表示されます。例外が発生した場合は入り口時刻および例外が表示されます。

番号9に対応するトレース情報
番号9に対応するイベントIDは次のとおりです。
0x8C80，0x8C82，0x8C84，0x8C86，0x8C88，0x8C8A，0x8C8C，0x8C8E，0x8C90，0x8C92，0x8CC0，0x8CC2，0x8CC4，0x8CC6，0x8CC8，0x8CCA，0x8CCC，0x8CCE，0x8CD0，0x8CD2，0x8CD4，0x8CD6，0x8CD8，0x8D00，0x8D02，0x8D04，0x8D06，0x8D08，0x8D0A，0x8D0C，0x8D0E，0x8D10，0x8D12，0x8D14，0x8D16，0x8D18
これらのイベントIDで取得できるトレース情報を示します。

PRFトレース取得レベル
すべて「詳細」です。

インタフェース名，およびオペレーション名
これらのイベントIDでは出力されません。

オプション
メソッドの引数にsqlを持つ場合，SQL文が表示されます。

番号10に対応するトレース情報
番号10に対応するイベントIDは次のとおりです。
0x8C81，0x8C83，0x8C85，0x8C87，0x8C89，0x8C8B，0x8C8D，0x8C8F，0x8C91，0x8C93，0x8CC1，0x8CC3，0x8CC5，0x8CC7，0x8CC9，0x8CCB，0x8CCD，0x8CCF，0x8CD1，0x8CD3，0x8CD5，0x8CD7，0x8CD9，0x8D01，0x8D03，0x8D05，0x8D07，0x8D09，0x8D0B，0x8D0D，0x8D0F，0x8D11，0x8D13，0x8D15，0x8D17，0x8D19
これらのイベントIDで取得できるトレース情報を示します。

PRFトレース取得レベル
すべて「詳細」です。

インタフェース名，オペレーション名
これらのイベントIDでは出力されません。

オプション
これらのイベントIDでは，正常に処理された場合は入り口時刻が表示されます。例外が発生した場合は入り口時刻および例外が表示されます。

(2)　ローカルトランザクションを使用する場合のトレース取得ポイントと取得できるトレース情報

ローカルトランザクションを使用する場合のトレース取得ポイントと取得できるトレース情報トレース取得ポイントと取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-46　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ローカルトランザクションの処理実行時）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8C60 | 1 | ローカルトランザクションの開始 | 処理開始 | B
0x8C61 | 2 | 処理終了 | B
0x8C62 | 3 | ローカルトランザクションのコミット | 処理開始 | B
0x8C63 | 4 | 処理終了 | B
0x8C64 | 3 | ローカルトランザクションのロールバック | 処理開始 | B
0x8C65 | 4 | 処理終了 | B

（凡例）　　B：詳細

注※

図A-28中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図A-28　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ローカルトランザクション関連）

●取得できるトレース情報

取得できるトレース情報を次の表に示します。

表A-47　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ローカルトランザクションの処理実行時）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8C60 | B | － | － | －
2 | 0x8C61 | B | － | － | ※2
3 | 0x8C62 | B | － | － | －
0x8C64 | B | － | － | －
4 | 0x8C63 | B | － | － | ※2
0x8C65 | B | － | － | ※2

（凡例）　　B：詳細　　－：該当なし

注※1

図A-28中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

(3)　コネクションアソシエーションを使用する場合のトレース取得ポイントと取得できるトレース情報

コネクションアソシエーションを使用する場合のトレース取得ポイントと取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-48　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクションアソシエーションの処理実行時）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8C40 | 1 | コネクションアソシエーション機能によって，論理コネクションに対する物理コネクションが差し替えられた時 | A

（凡例）　　A：標準

注※

図A-29中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図A-29　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクションアソシエーション関連）

●取得できるトレース情報

取得できるトレース情報を次の表に示します。

表A-49　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクションアソシエーション処理実行時）

図中の番号※ | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8C40 | A | コネクションID（コネクションアソシエーション機能によって差し替えられた先の物理コネクションのコネクションID） | － | －

（凡例）　　A：標準　　－：該当なし

注※

図A-29中の番号と対応しています。

(4)　コネクション自動クローズ機能を使用する場合のトレース取得ポイントと取得できるトレース情報

コネクション自動クローズ時のトレース取得ポイントと取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-50　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクション自動クローズ時）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8B84 | 1 | コネクション自動クローズ機能によるクローズ処理呼び出し直後 | B
0x8B82 | 2 | 物理コネクション破棄の呼び出し直前 | B
0x8B83 | 3 | 物理コネクション破棄のリターン直後 | B
0x8B85 | 4 | コネクション自動クローズ機能によるクローズ処理リターン直前 | B

（凡例）　　B：詳細

注※

図A-30中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図A-30　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクション自動クローズ時）

●取得できるトレース情報

取得できるトレース情報を次の表に示します。

表A-51　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクション自動クローズ時）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8B84 | B | コネクションID | － | －
2 | 0x8B82 | B | － | － | －
3 | 0x8B83 | B | － | － | ※2
4 | 0x8B85 | B | － | － | 入り口時刻

（凡例）　　B：詳細　　－：該当なし

注※1

図A-30中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

(5)　DB Connector for Cosminexus RMと連携する場合のトレース取得ポイントと取得できるトレース情報

DB Connector for Cosminexus RMと連携する場合のトレース取得ポイントと取得できるトレース情報について説明します。

なお，DB Connector for Cosminexus RMでは，DB Connectorを使用してデータベースに接続しています。そのためDB Connector for Cosminexus RM利用時にはDB Connectorのトレースポイントも取得します。JDBCコネクションの生成物（java.sql.Statementなど）は，DB Connectorと同じトレース取得ポイントになります。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-52　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（DB Connector for Cosminexus RM連携時）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8D60 | 1 | DB Connector for Cosminexus RM利用時のjavax.sql.DataSource.getConnection()でのデータベース接続の確立 | 処理開始 | A
0x8D61 | 2 | 処理終了 | A
0x8D62 | 1 | DB Connector for Cosminexus RM利用時のjavax.sql.DataSource.getConnection(String username, String password)での，データベース接続の確立 | 処理開始 | A
0x8D63 | 2 | 処理終了 | A
0x8D80 | 5 | DB Connector for Cosminexus RM利用時のjava.sql.Connection.close()での，ConnectionオブジェクトのデータベースとJDBCリソースの解除 | 処理開始 | A
0x8D81 | 6 | 処理終了 | A
0x8D82 | 3 | DB Connector for Cosminexus RM利用時のConnection.createStatement() | 処理開始 | B
0x8D83 | 4 | 処理終了 | B
0x8D84 | 3 | DB Connector for Cosminexus RM利用時のConnection.createStatement(int resultSetType, int resultSetConcurrency) | 処理開始 | B
0x8D85 | 4 | 処理終了 | B
0x8D86 | 3 | DB Connector for Cosminexus RM利用時のConnection.createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) | 処理開始 | B
0x8D87 | 4 | 処理終了 | B
0x8D88 | 3 | DB Connector for Cosminexus RM利用時のConnection.prepareCall(String sql) | 処理開始 | B
0x8D89 | 4 | 処理終了 | B
0x8D8A | 3 | DB Connector for Cosminexus RM利用時の(String sql, int resultSetType, int resultSetConcurrency) | 処理開始 | B
0x8D8B | 4 | 処理終了 | B
0x8D8C | 3 | DB Connector for Cosminexus RM利用時のConnection.prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) | 処理開始 | B
0x8D8D | 4 | 処理終了 | B
0x8D8E | 3 | DB Connector for Cosminexus RM利用時のConnection.prepareStatement(String sql) | 処理開始 | B
0x8D8F | 4 | 処理終了 | B
0x8D90 | 3 | DB Connector for Cosminexus RM利用時のConnection.prepareStatement(String sql, int autoGeneratedKeys) | 処理開始 | B
0x8D91 | 4 | 処理終了 | B
0x8D92 | 3 | DB Connector for Cosminexus RM利用時のConnection.prepareStatement(String sql, int[] columnIndexes) | 処理開始 | B
0x8D93 | 4 | 処理終了 | B
0x8D94 | 3 | DB Connector for Cosminexus RM利用時のConnection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency) | 処理開始 | B
0x8D95 | 4 | 処理終了 | B
0x8D96 | 3 | DB Connector for Cosminexus RM利用時のConnection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) | 処理開始 | B
0x8D97 | 4 | 処理終了 | B
0x8D98 | 3 | DB Connector for Cosminexus RM利用時のConnection.prepareStatement(String sql, String[] columnNames) | 処理開始 | B
0x8D99 | 4 | 処理終了 | B

（凡例）　　A：標準　　B：詳細

注※

図A-31中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図A-31　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（DB Connector for Cosminexus RM連携時）

●取得できるトレース情報

取得できるトレース情報を次の表に示します。

表A-53　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（DB Connector for Cosminexus RM連携時）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8D60 | A | － | － | －
2 | 0x8D61 | A | コネクションID | － | ※2
1 | 0x8D62 | A | － | － | －
2 | 0x8D63 | A | コネクションID | － | ※2
5 | 0x8D80 | A | コネクションID | － | －
6 | 0x8D81 | A | － | － | ※2
3 | 0x8D82 | B | － | － | －
4 | 0x8D83 | B | － | － | ※2
3 | 0x8D84 | B | － | － | －
4 | 0x8D85 | B | － | － | ※2
3 | 0x8D86 | B | － | － | －
4 | 0x8D87 | B | － | － | ※2
3 | 0x8D88 | B | － | － | SQL文
4 | 0x8D89 | B | － | － | ※2
3 | 0x8D8A | B | － | － | SQL文
4 | 0x8D8B | B | － | － | ※2
3 | 0x8D8C | B | － | － | SQL文
4 | 0x8D8D | B | － | － | ※2
3 | 0x8D8E | B | － | － | SQL文
4 | 0x8D8F | B | － | － | ※2
3 | 0x8D90 | B | － | － | SQL文
4 | 0x8D91 | B | － | － | ※2
3 | 0x8D92 | B | － | － | SQL文
4 | 0x8D93 | B | － | － | ※2
3 | 0x8D94 | B | － | － | SQL文
4 | 0x8D95 | B | － | － | ※2
3 | 0x8D96 | B | － | － | SQL文
4 | 0x8D97 | B | － | － | ※2
3 | 0x8D98 | B | － | － | SQL文
4 | 0x8D99 | B | － | － | ※2

（凡例）　　A：標準　　B：詳細　　－：該当なし

注※1

図A-31中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

(6)　ワーク管理を使用する場合のトレース取得ポイントと取得できるトレース情報

Connector1.5に準拠したリソースアダプタでワーク管理を使用する場合のトレース取得ポイントと取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-54　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ワーク管理を使用する場合）

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8B86 | 1 | javax.resource.spi.work.WorkManagerのメソッドの呼び出し直後 | A
0x8B88 | 2 | javax.resource.spi.work.WorkListenerのメソッドの呼び出し直前 | B
0x8B89 | 3 | javax.resource.spi.work.WorkListenerのメソッドのリターン直後 | B
0x8B88 | 4 | javax.resource.spi.work.WorkListenerのメソッドの呼び出し直前 | B
0x8B89 | 5 | javax.resource.spi.work.WorkListenerのメソッドのリターン直後 | B
0x8B87 | 6 | javax.resource.spi.work.WorkManagerのメソッドのリターン直前 | A
0x8B88 | 7 | javax.resource.spi.work.WorkListenerのメソッドの呼び出し直前 | B
0x8B89 | 8 | javax.resource.spi.work.WorkListenerのメソッドのリターン直後 | B
0x8B87 | 9 | javax.resource.spi.work.WorkManagerのメソッドのリターン直前 | A
0x8B8A | 10 | javax.resource.spi.work.Workのメソッド呼び出し直前 | A
0x8B8B | 11 | javax.resource.spi.work.Workのメソッドのリターン直後 | A
0x8B88 | 12 | javax.resource.spi.work.WorkListenerのメソッドの呼び出し直前 | B
0x8B89 | 13 | javax.resource.spi.work.WorkListenerのメソッドのリターン直後 | B
0x8B87 | 14 | javax.resource.spi.work.WorkManagerのメソッドのリターン直前 | A

（凡例）　　A：標準　　B：詳細

注※

図A-32～図A-34中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図A-32　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（scheduleWork()呼び出し時）

図A-33　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（startWork()呼び出し時）

図A-34　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（doWork()呼び出し時）

●取得できるトレース情報

取得できるトレース情報を次の表に示します。

表A-55　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ワーク管理を使用する場合）

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8B86 | A | Workのクラス名 | メソッド名 | リソースアダプタの表示名
2 | 0x8B88 | B | Workのクラス名 | メソッド名 | リソースアダプタの表示名※2
3 | 0x8B89 | B | Workのクラス名 | メソッド名 | ※3
4 | 0x8B88 | B | Workのクラス名 | メソッド名 | リソースアダプタの表示名※2
5 | 0x8B89 | B | Workのクラス名 | メソッド名 | ※3
6 | 0x8B87 | A | Workのクラス名 | メソッド名 | ※3
7 | 0x8B88 | B | Workのクラス名 | メソッド名 | リソースアダプタの表示名※2
8 | 0x8B89 | B | Workのクラス名 | メソッド名 | ※3
9 | 0x8B87 | A | Workのクラス名 | メソッド名 | ※3
10 | 0x8B8A | A | Workのクラス名 | メソッド名 | リソースアダプタの表示名
11 | 0x8B8B | A | Workのクラス名 | メソッド名 | ※3
12 | 0x8B88 | B | Workのクラス名 | メソッド名 | リソースアダプタの表示名※2
13 | 0x8B89 | B | Workのクラス名 | メソッド名 | ※3
14 | 0x8B87 | A | Workのクラス名 | メソッド名 | ※3

（凡例）　　A：標準　　B：詳細

注※1

図A-32～図A-34中の番号と対応しています。

注※2

アプリケーションに含まれているリソースアダプタの場合，「アプリケーション名:リソースアダプタの表示名」と表示されます。

注※3

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

付録A.11　RMIのトレース取得ポイント

ここでは，RMIのトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-56　RMIでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x8E01 | 1 | スタブでのリクエスト送信処理の始まり | A
0x8E02 | 6 | スタブでのレスポンス受信処理の終わり | A
0x8E03 | 2 | クライアント側のリクエスト送信処理 | A
0x8E04 | 5 | クライアント側のレスポンス受信処理 | A
0x8E05 | 3 | サーバ側のリクエスト受信処理 | A
0x8E06 | 4 | サーバ側のレスポンス送信処理 | A

（凡例）　　A：標準

注※

図A-35中の番号と対応しています。

RMIでのトレース取得ポイントを次の図に示します。

図A-35　RMIのトレース取得ポイント

●取得できるトレース情報

RMIで取得できるトレース情報を次の表に示します。

表A-57　RMIで取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x8E01 | A | インタフェース名 | オペレーション名 | －
2 | 0x8E03 | A | － | － | －
3 | 0x8E05 | A | － | － | －
4 | 0x8E06 | A | － | － | －
5 | 0x8E04 | A | － | － | －
6 | 0x8E02 | A | インタフェース名※2 | オペレーション名※2 | －※2

（凡例）　　A：標準　　－：該当なし

注※1

図A-35中の番号と対応しています。

注※2

例外が発生した場合，インタフェース名およびオペレーション名は表示されません。また，オプションには発生した例外が表示されます。

付録A.12　OTSのトレース取得ポイント

ここでは，OTSのトレース取得ポイントと，取得できるトレース情報について説明します。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-58　OTSでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x9400 | 1 | トランザクション生成直後 | A
0x9401 | 2 | トランザクションの状態がMarkedRollbackへ遷移した直後 | A
0x9402 | 3 | トランザクションの状態がRollingBackへ遷移した直後 | A
0x9403 | 12 | トランザクション決着直後 | A
0x9404 | 4 | javax.transaction.xa.XAResourceへの決着処理直前 | B
0x9405 | 5 | javax.transaction.xa.XAResourceへの決着処理直後 | B
0x9406 | 6 | サブオーディネートトランザクションへの決着処理直前 | B
0x9407 | 9 | サブオーディネートトランザクションへの決着処理直後 | B
0x9408 | 7 | スペリアトランザクションからの決着処理要求受信直後 | B
0x9409 | 8 | スペリアトランザクションからの決着処理要求返信直前 | B
0x9410 | 13 | javax.transaction.xa.XAResourceオブジェクト取得処理直前 | B
0x9411 | 14 | javax.transaction.xa.XAResourceオブジェクト取得処理直後 | B
0x9412 | 10 | ステータスファイルへの書き込み・読み込み直前 | B
0x9413 | 11 | ステータスファイルへの書き込み・読み込み直後 | B

（凡例）　　A：標準　　B：詳細

注※

図A-36～A-40中の番号と対応しています。

OTSでのトレース取得ポイントを次の図に示します。

図A-36　トランザクション生成から決着までのトレース取得ポイント

図A-37　インプロセスOTS初期化時のステータスファイルへの読み込み・書き込みに関連するトレース取得ポイント

図A-38　javax.transaction.xa.Xidの回復処理でのトレース取得ポイント

図A-39　典型的な1フェーズコミットモデルでのトレース取得ポイント

図A-40　典型的な2フェーズコミットモデルでのトレース取得ポイント

●取得できるトレース情報

OTSで取得できるトレース情報を次の表に示します。なお，次の表の中で，一つの項目に複数の情報が個条書きで記載してある場合は，そのどれかが出力されることを意味します。

表A-59　OTSで取得できるトレース情報

図中の番号※1
イベントID
レベル
取得できる情報

インタフェース名
オペレーション名
オプション

1
0x9400
A
global transaction

| created
トランザクション開始指示を受け，生成されました。

| recreated
別ノードからトランザクション処理への参加指示を受け，生成されました。

| recovered
ステータスファイルから回復されました。

| recovered(orphan)
javax.transaction.xa.XAResourceからXidが回復されましたが，これに対応するトランザクションが存在しないため，トランザクションが新たに生成されました。

<グローバルトランザクションID>

2
0x9401
A
global transaction
| marked rollback(<遷移した理由>※2)
<グローバルトランザクションID>

3
0x9402
A
global transaction
| rolling back(<遷移した理由>※3)
<グローバルトランザクションID>

12
0x9403
A
global transaction

| committed
コミットしました。

| rolled back
ロールバックしました。

| heuristic commit
強制コミットしました。

| heuristic rollback
強制ロールバックしました。

| heuristic mixed
部分的にコミットおよびロールバックされました。

| heuristic hazard
コミットしたかロールバックしたか不明です。

| unknown
コミットしたかロールバックしたか不明です。

| invalid status
上記以外の状態で決着しました。

<グローバルトランザクションID>

4
0x9404
B

<XAResource識別子>

なし

> prepare
prepareを発行します。

> commit(second phase)
2相目のcommitを発行します。

> commit(one phase)
1相目のcommitを発行します。

> rollback
rollbackを発行します。

> forget
forgetを発行します。

> recover
recoverを発行します。

<グローバルトランザクションID>

なし

5
0x9405
B

<XAResource識別子>

なし

正常リターンの場合

< prepare

< commit(second phase)

< commit(one phase)

< rollback

< forget

< recover

異常リターンの場合（想定外の値がリターンされた場合，または例外が発生した場合）

<!prepare

<!commit(second phase)

<!commit(one phase)

<!rollback

<!forget

<!recover

<グローバルトランザクションID>:<結果>※4

なし

6
0x9406
B
resource

> prepare
prepareを発行します。

> commit(second phase)
2相目のcommitを発行します。

> commit(one phase)
1相目のcommitを発行します。

> rollback
rollbackを発行します。

> forget
forgetを発行します。

<グローバルトランザクションID>

9
0x9407
B
resource

正常リターンの場合

< prepare

< commit(second phase)

< commit(one phase)

< rollback

< forget

異常リターンの場合（想定外の値がリターンされた場合，または例外が発生した場合）

<!prepare

<!commit(second phase)

<!commit(one phase)

<!rollback

<!forget

<グローバルトランザクションID>

<グローバルトランザクションID>:<結果>※5

7
0x9408
B
subordinate transaction

> prepare
prepare指示が入ってきました。

> commit(second phase)
2相目のcommit指示が入ってきました。

> commit(one phase)
1相目のcommit指示が入ってきました。

> rollback
rollback指示が入ってきました。

> forget
forget指示が入ってきました。

<グローバルトランザクションID>

8
0x9409
B
subordinate transaction

正常リターンの場合

< prepare

< commit(second phase)

< commit(one phase)

< rollback

< forget

異常リターンの場合（想定外の値がリターンされた場合，または例外が発生した場合）

<!prepare

<!commit(second phase)

<!commit(one phase)

<!rollback

<!forget

<グローバルトランザクションID>

<グローバルトランザクションID>:<結果>※6

13
0x9410
B

なし

<XAResource識別子>

> get xaresource

なし

<グローバルトランザクションID>

14
0x9411
B

なし

<XAResource識別子>

正常リターンの場合

< get xaresource

異常リターン場合（想定外の値がリターンされた場合，または例外が発生した場合）

<!get xaresource

なし

<結果>※7

<グローバルトランザクションID>

<グローバルトランザクションID>:<結果>※7

10
0x9412
B

<ステータスファイル名>

<ステータスファイル名>:<エントリ番号>※8

> write(<書き込む内容>※9)

> read(<読み込む内容>※10)

なし

<グローバルトランザクションID>

11
0x9413
B

<ステータスファイル名>

<ステータスファイル名>:<エントリ番号>※8

正常リターンの場合

< write

< read

異常リターン（想定外の値がリターンされた場合，または例外が発生した場合）

<!write

<!read

なし

<結果>※11

<グローバルトランザクションID>

<グローバルトランザクションID>:<結果>※11

（凡例）　　A：標準　B：詳細

注※1

図A-36～A-40中の番号と対応しています。

注※2

遷移した理由として，次のどれかが出力されます。

operation
インプロセスOTS外部から指示されました。

server call
別ノードにあるサーバへの呼び出しに失敗しました。

superior
別ノードからトランザクション処理への参加指示を受けましたが，すでにそのトランザクションがMarkedRollback状態でした。

sync before
決着処理中のJTAへのコールバック処理に失敗しました。

注※3

遷移した理由として，次のどれかが出力されます。

operation
インプロセスOTS外部から指示されました。

timeout
グローバルトランザクションタイムアウトが発生しました。

superior
スペリアトランザクションから指示されました。

forgotten
サブオーディネートトランザクション，またはjavax.transaction.xa.XAResourceに対して決着指示を出すトランザクションが存在しないと判断しました。

end
javax.transaction.xa.XAResourceに対するendに失敗しました。

prepare
javax.transaction.xa.XAResourceに対するprepareに失敗しました。

write prepared
ステータスファイルへのprepared書き込みに失敗しました。

write committing
ステータスファイルへのcommitting書き込みに失敗しました。

注※4

prepare，commit，rollbackまたはforgetの場合，結果として次のどれかが出力されます。

リターン値

XAExceptionのエラーコード

例外(=XAException以外の例外)のtoString()

recoverの場合，結果として次のどれかが出力されます。

回復されたXidの個数

null（Xid配列自体がnullの場合）

XAExceptionのエラーコード

例外(=XAException以外の例外)のtoString()

注※5

prepareの場合，結果として次のどちらかが出力されます。

リターンされた値

例外のtoString()

prepare以外の場合，結果として例外のtoString()が出力されます。

注※6

prepareの場合，結果として次のどちらかが出力されます。

リターンする値

例外のtoString()

prepare以外の場合，結果として例外のtoString()が出力されます。

注※7

結果として次のどちらかが出力されます。

例外のtoString()

null（リターン値がnullの場合）

注※8

内部情報です。

注※9

書き込み内容として，次のどれかが出力されます。

management info
ステータスファイル管理情報

status file body
ステータスファイル本体

prepared
プリペア完了状態

committing
コミット決定状態

heuristic commit
強制コミットされた状態

heuristic rollback
強制ロールバックされた状態

heuristic mixed
部分的にコミットおよびロールバックされた状態

heuristic hazard
コミットしたかロールバックしたか不明な状態

forgotten
トランザクション決着完了状態

注※10

読み込む内容として，次のどちらかが出力されます。

management info
ステータスファイル管理情報

status file body
ステータスファイル本体

注※11

結果として，次のどれかが出力されます。

書き込みサイズ（単位：バイト）

読み込みサイズ（単位：バイト）

例外のtoString()

付録A.13　標準出力／標準エラー出力／ユーザログのトレース取得ポイント

ここでは，標準出力／標準エラー出力／ユーザログのトレース取得ポイントと，取得できるトレース情報について説明します。

＜この項の構成＞

(1)　標準出力／標準エラー出力のトレース取得ポイント

(2)　ユーザログのトレース取得ポイント

(1)　標準出力／標準エラー出力のトレース取得ポイント

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-60　 標準出力／標準エラー出力でのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x9C00 | 1 | 標準出力/標準エラー出力への出力開始時 | B
0x9C01 | 2 | 標準出力/標準エラー出力への出力完了時 | B

（凡例）　　B：詳細

注※

図A-41中の番号と対応しています。

標準出力／標準エラー出力のトレース取得ポイントを次の図に示します。

図A-41　標準出力／標準エラー出力のトレース取得ポイント

●取得できるトレース情報

標準出力／標準エラー出力で取得できるトレース情報を次の表に示します。

表A-61　 標準出力／標準エラー出力で取得できるトレース情報

図中の番号※ | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x9C00 | B | ストリーム名（「out」／「err」） | － | －
2 | 0x9C01 | B | ストリーム名（「out」／「err」） | － | －

（凡例）　　B：詳細　　－：該当なし

注※

図A-41中の番号と対応しています。

(2)　ユーザログのトレース取得ポイント

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-62　ユーザログのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x9C02 | 1 | ユーザログを使用したメッセージ出力開始時 | B
0x9C03 | 2 | ユーザログを使用したメッセージ出力完了時 | B

（凡例）　　B：詳細

注※

図A-42中の番号と対応しています。

ユーザログのトレース取得ポイントを次の図に示します。

図A-42　ユーザログのトレース取得ポイント

●取得できるトレース情報

ユーザログで取得できるトレース情報を次の表に示します。

表A-63　ユーザログで取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x9C02 | B | アプリケーション出力名 | メッセージID | －
2 | 0x9C03 | B | アプリケーション出力名 | メッセージID | －

（凡例）　　B：詳細　　－：該当なし

注※

図A-42中の番号と対応しています。

付録A.14　DIのトレース取得ポイント

ここでは，DIのトレース取得ポイントと，取得できるトレース情報について説明します。

●PRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-64　DIでのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0x9D00 | 1 | 依存性を注入する直前 | A
0x9D01 | 2 | 依存性を注入した直後 | A

（凡例）　　A：標準

注※

図A-43中の番号と対応しています。

DIのトレース取得ポイントを次の図に示します。

図A-43　 DIのトレース取得ポイント

●取得できるトレース情報

DIで取得できるトレース情報を次の表に示します。

表A-65　DIで取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0x9D00 | A | 依存性を注入する先のターゲット名 | 注入するリファレンス名 | －
2 | 0x9D01 | A | 依存性を注入した先のターゲット名 | 注入したリファレンス名 | ※2

（凡例）　　A：標準　　－：該当なし

注※1

図A-43中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

付録A.15　バッチアプリケーション実行機能のトレース取得ポイント

ここでは，バッチアプリケーション実行機能のトレース取得ポイントと，取得できるトレース情報について説明します。

●PRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-66　バッチアプリケーション実行機能でのトレース取得ポイントの詳細

イベントID | 図中の番号※ | トレース取得ポイント | レベル
0xA100 | 1 | バッチアプリケーションの実行直前 | A
0xA101 | 2 | バッチアプリケーションの終了直後 | A

（凡例）　　A：標準

注※

図A-44中の番号と対応しています。

バッチアプリケーション実行機能のトレース取得ポイントを次の図に示します。

図A-44　バッチアプリケーション実行機能のトレース取得ポイント

●取得できるトレース情報

バッチアプリケーション実行機能で取得できるトレース情報を次の表に示します。

表A-67　バッチアプリケーション実行機能で取得できるトレース情報

図中の番号※1 | イベントID | レベル | 取得できる情報
インタフェース名 | オペレーション名 | オプション
1 | 0xA100 | A | バッチアプリケーションのクラス名（パッケージ名を含む） | － | －
2 | 0xA101 | A | バッチアプリケーションのクラス名（パッケージ名を含む） | － | ※2

（凡例）　　A：標準　　－：該当なし

注※1

図A-44中の番号と対応しています。

注※2

正常に処理された場合，入り口時刻が表示されます。

例外が発生した場合，入り口時刻および例外が表示されます。

付録A.16　J2EEサーバの開始・終了時のトレース取得ポイント

J2EEサーバの開始処理の完了時，およびJ2EEサーバの終了処理の開始時に，トレース情報を取得できます。

●トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表A-68　J2EEサーバでのトレース取得ポイントの詳細

イベントID | トレース取得ポイント | レベル
0x8FFE | J2EEサーバの開始処理完了（KDJE90028-Iメッセージ出力）時 | A
0x8FFF | J2EEサーバのシャットダウン開始（KDJE90031-Iメッセージ出力）時 | A

（凡例）　　A：標準

●取得できるトレース情報

J2EEサーバの開始・終了時に取得できるトレース情報を次に示します。

イベントID
0x8FFE，0x8FFF

PRFトレース取得レベル
すべて「標準」になります。

インタフェース名，オペレーション名，およびオプション
情報は出力されません。

付録B　snapshotログの収集対象一覧

ここでは，snapshotログの一括収集を実行する場合に収集対象となる構成ソフトウェアの実行環境ディレクトリについて説明します。なお，収集したZIPファイルを展開すると，収集元と同じディレクトリ構成で展開されます。

snapshotログの一括収集時，Cosminexusで構築したシステムの構成ソフトウェアおよりライブラリのログファイルおよび定義ファイルが収集されます。収集対象になるディレクトリパスは，次のファイルを編集すると変更できます。snapshotログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

snapshotログは，snapshotlog.confとsnapshotlog.2.confという二つのファイルに分けて収集されます。

snapshotlog.conf
一次送付資料の収集対象ディレクトリが記載されているファイルです。ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.conf

UNIXの場合
/opt/Cosminexus/manager/config/snapshotlog.conf

snapshotlog.2.conf
二次送付資料の収集対象ディレクトリが記載されているファイルです。ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.2.conf

UNIXの場合
/opt/Cosminexus/manager/config/snapshotlog.2.conf

ここでは，デフォルトの状態でのそれぞれの構成ソフトウェアおよびライブラリの収集対象ディレクトリを示します。

収集対象ディレクトリパスの共通の記述方法を次に示します。

ディレクトリパス中の「*」は0文字以上の任意の文字列を示します。

Windowsでの「¥*¥*¥*」やUNIXでの「/*/*/*」のような記述は，何階層下のファイルを収集するかを示します。例えば，Windowsでの「log¥*¥*」やUNIXでの「log/*/*」の場合は，logディレクトリの2階層下のファイルが収集対象になります。

注意

snapshotログの一括収集は，デフォルトの状態では構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリを対象に実行します。ログの出力先および作業ディレクトリを変更している場合は，収集先をカスタマイズしてください。

＜この節の構成＞

付録B.1　Cosminexus Component Container

付録B.2　Cosminexus Component Transaction Monitor

付録B.3　Cosminexus DABroker Library

付録B.4　Cosminexus Developer's Kit for Java

付録B.5　Cosminexus Performance Tracer

付録B.6　Cosminexus TPBroker

付録B.7　Cosminexus Web Services - Security

付録B.8　Hitachi Web Server

付録B.9　Cosminexus cFramework

付録B.10　uCosminexus Service Adapter for TP1

付録B.11　監査ログ

付録B.12　そのほかの情報

付録B.1　Cosminexus Component Container

Cosminexus Component Containerに関連する収集対象ディレクトリパスを次の表に示します。

表B-1　Cosminexus Component Containerに関連する収集対象ディレクトリパス（Windowsの場合）

分類
収集対象ディレクトリパス
一次／二次
収集方法

J2EEサーバ（J2EEサーバモードで実行している場合）
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥*.cfg
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥*.properties
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥*.policy
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥javacore*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥hs_err_*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥**※1
二次
×

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥web¥<サーバ名称>¥**※1
二次
×

<JSP用一時ディレクトリ(webserver.work.directory)>¥**※1
二次
×

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*¥*¥*
二次
○

<インプロセスHTTPサーバのアクセスログファイル名(webserver.logger.access_log.inprocess_http.filename)>¥*.log
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥http¥maintenance¥thr¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥http¥maintenance¥comm¥*
一次
○

<稼働情報ファイル出力先ディレクトリ(ejbserver.management.stats_file.dir)>¥*
二次
△

Webコンテナサーバ（サーブレットエンジンモードで実行している場合）
<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>¥*
一次
△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>¥*¥*
一次
△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>¥*¥*¥*
一次
△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>¥*¥*¥*¥*
一次
△

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥javacore*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥hs_err*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥core*
二次
○

サーバ管理コマンド※2
<Cosminexusのインストールディレクトリ>¥CC¥admin¥usrconf¥*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥*
一次
△

<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥*¥*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥*¥*¥*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥*¥*¥*¥*
二次
○

リダイレクタ（Webサーバ）
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs¥*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥*.conf
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥*.properties
一次
○

<リダイレクタログ出力ディレクトリ(JkLogFileDir)>¥*
一次
○

<リダイレクタログ出力ディレクトリ(JkLogFileDir)>¥*¥*
一次
○

<リダイレクタログ出力ディレクトリ(JkTraceLogFileDir)>¥*
一次
○

<リダイレクタログ出力ディレクトリ(JkTraceLogFileDir)>¥*¥*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥servers¥<Webサーバ名>¥*.conf
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥servers¥<Webサーバ名>¥*.properties
一次
○

JCA/JDBCコネクション管理
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*
一次
○

TP1/Message Queue - Access
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>mqc.api.*.*
一次
○

uCosminexus TP1 Connector
(TP1/Client/J)
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*¥*
一次
○

${jp.co.hitachi_system.tp1connector.logdestination}¥tp1connector*.log
一次
△

${user.home}¥tp1connector*.log
一次
○

${user.home}¥TP1clientJ¥dcClt*.dmp
二次
○

Cosminexus RM
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥*¥*¥*
一次
○

<Cosminexus RMインストールディレクトリ>¥logs¥cmd¥*
一次
△

<Cosminexus RMインストールディレクトリ>¥logs¥cmd¥*¥*¥*
一次
△

<Cosminexus RMインストールディレクトリ>¥logs¥cmd¥*¥*¥*¥*
一次
△

<Cosminexus RMインストールディレクトリ>¥logs¥cmd¥*¥*¥*¥*¥*
一次
△

<Cosminexusインストールディレクトリ(cosminexus.home)>¥RM¥logs¥cmd¥*
一次
△

<Cosminexusインストールディレクトリ(cosminexus.home)>¥RM¥ogs¥cmd¥*¥*¥*
一次
△

<Cosminexusインストールディレクトリ(cosminexus.home)>¥RM/logs¥cmd¥*¥*¥*¥*
一次
△

<Cosminexusインストールディレクトリ(cosminexus.home)>¥RM¥ogs¥cmd¥*¥*¥*¥*¥*
一次
△

<ユーザ指定ディレクトリ(RMLogTraceFileDir)>¥*
一次
△

EJBクライアント
<EJB0クライアントログ出力ディレクトリ(ejbserver.client.log.directory)>¥*
一次
△

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>¥*¥*¥*
一次
△

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>¥*¥*¥*¥*※3
一次
△

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>¥*¥*¥*¥*¥*※3
二次
△

Management Server
<Cosminexusのインストールディレクトリ>¥manager¥config¥*.bak
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥config¥*.cfg
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥config¥*.conf
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥config¥*.xml
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥config¥*.properties
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥config¥*.server_name
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥config¥filterlist
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥config¥.+
二次
○

<Cosminexusのインストールディレクトリ>¥manager¥tmp¥*※4
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥tmp¥*.zip
二次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>¥*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>¥message¥*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>¥message¥mmap¥*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>¥trace¥*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>¥trace¥mmap¥*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>¥maintenance¥*
二次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>¥maintenance¥mmap¥*
二次
○

<HNTRLib2のインストールディレクトリ>¥spool¥hntr2*.log
一次
○

<システム環境変数%SystemRoot%>¥system32¥drivers¥etc¥hosts
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥setup¥config¥*
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥setup¥log¥*.log
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥setup¥log¥maintenance¥*.log
一次
○

<Cosminexusのインストールディレクトリ>¥manager¥setup¥tmp¥*
一次
○

Cosminexus Service Coordinator※5
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥csc¥*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>¥csc¥maintenance¥*
一次
○

<HCSCサーバのプロパティ(requesttrace-filepath)>¥*
一次
△

<HCSCサーバのプロパティ(methodtrace-filepath)>¥*
一次
△

<Cosminexusのインストールディレクトリ>¥CSC¥system¥msg¥*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥apps¥*
二次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥apps¥*¥*
二次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥apps¥*¥*¥*
二次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥apps¥*¥*¥*¥*
二次
○

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥*
一次
○

<リポジトリルート(cscmng.repository.root)>¥**
二次
×

<ログディレクトリ(cscmng.log.dir)>¥message*¥*
一次
×

Server Plug-in
<Eclipseワークスペースディレクトリ>¥.metadata¥.plugins¥com.cosminexus.plugin.server.explorer¥.logs¥*.log
一次
×

<Eclipseワークスペースディレクトリ>¥.metadata¥.plugins¥com.cosminexus.plugin.server.core¥.logs¥*.log
一次
×

<Eclipseワークスペースディレクトリ>¥.metadata¥.log
二次
×

バッチアプリケーション実行コマンド
<Cosminexusのインストールディレクトリ>¥CC¥batch¥logs¥*
一次
△

<Cosminexusのインストールディレクトリ>¥CC¥batch¥logs¥*¥*
一次
△

<Cosminexusのインストールディレクトリ>¥CC¥batch¥logs¥*¥*¥*
一次
△

<Cosminexusのインストールディレクトリ>¥CC¥batch¥logs¥*¥*¥*¥*
一次
△

SOAP
<Cosminexusのインストールディレクトリ>¥c4web¥logs¥*
一次
○

<Cosminexusのインストールディレクトリ>¥c4web¥conf¥*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥web¥<サーバ名称>¥<コンテキストルート>¥WEB-INF¥server-config.xml
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥web¥<サーバ名称>¥<コンテキストルート>¥WEB-INF¥classes¥c4webcl.properties
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps¥<コンテキストルート>¥WEB-INF¥server-config.xml
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps¥<コンテキストルート>¥WEB-INF¥classes¥c4webcl.properties
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥cjmessage*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥cjexception*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥WS¥*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥WS¥maintenance¥*
二次
○

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>¥*¥*¥*
一次
△

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjmessage*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjexception*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥WS¥*
一次
○

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥WS¥maintenance¥*
二次
○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

×：デフォルトでは収集されません。snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，収集対象ディレクトリに設定する必要があります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<Cosminexusのインストールディレクトリ>
Cosminexusのインストールディレクトリです。デフォルトは，「C:¥Program Files¥HITACHI¥Cosminexus」です。

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定したディレクトリです。

<JSP用一時ディレクトリ(webserver.work.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.work.directoryパラメタで指定したディレクトリです。

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリです。

<インプロセスHTTPサーバのアクセスログファイル名(webserver.logger.access_log.inprocess_http.filename)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.logger.access_log.inprocess_http.filenameパラメタで指定したディレクトリです。

<稼働情報ファイル出力先ディレクトリ(ejbserver.management.stats_file.dir)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.management.stats_file.dirパラメタで指定したディレクトリです。

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>
J2EEサーバ用のusrconf.cfgのweb.server.log.directoryキーに指定したディレクトリです。

<リダイレクタログ出力ディレクトリ(JkLogFileDir)>
簡易構築定義ファイルの論理Webサーバ（web-server）の<configuration>タグ内に，JkLogFileDirパラメタで指定したディレクトリです。

<リダイレクタログ出力ディレクトリ(JkTraceLogFileDir)>
簡易構築定義ファイルの論理Webサーバ（web-server）の<configuration>タグ内に，JkTraceLogFileDirパラメタで指定したディレクトリです。

<Cosminexus RMインストールディレクトリ>
環境変数HRMDIRに指定したディレクトリです。

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>
EJBクライアントアプリケーションのシステムプロパティejbserver.client.log.directoryキーに指定したディレクトリ，またはcjclstartapコマンドのカレントディレクトリです。

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>
manager.cfgのcom.cosminexus.manager.log.dirキーに指定したディレクトリです。

<HNTRLib2のインストールディレクトリ>
日立トレース共通ライブラリのインストールディレクトリです。デフォルトは，「C:¥Program Files¥Hitachi¥HNTRLib2」です。

<HCSCサーバのプロパティ(requesttrace-filepath)>
HCSCサーバ定義コマンド（cscsvconfig）でrequesttrace-filepathプロパティに指定したディレクトリです。

<HCSCサーバのプロパティ(methodtrace-filepath)>
HCSCサーバ定義コマンドcscsvconfigでmethodtrace-filepathプロパティに指定したディレクトリです。

<リポジトリルート(cscmng.repository.root)>
HCSC-Manager定義（cscmng.properties）のcscmng.repository.rootキーに指定したリポジトリルートです。

<ログディレクトリ(cscmng.log.dir)>
HCSC-Manager定義（cscmng.properties）のcscmng.log.dirキーに指定したログディレクトリです。

<Eclipseワークスペースディレクトリ>
Eclipseを利用するユーザが任意で作成するディレクトリです。

注※1

21階層分までのディレクトリを収集対象にします。

注※2

環境に合わせて収集対象になるディレクトリパスを変更してから収集してください。

注※3

Cosminexus TPBrokerで環境変数が設定されている場合は，環境変数の設定が優先されます。

注※4

*.zip以外のファイルが収集されます。

注※5

uCosminexus Service Platformの場合だけ出力されます。

表B-2　Cosminexus Component Containerに関連する収集対象ディレクトリパス（UNIXの場合）

分類
収集対象ディレクトリパス
一次／二次
収集方法

J2EEサーバ（J2EEサーバモードで実行している場合）
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/*.cfg
一次
○

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/*.properties
一次
○

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/*.policy
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/javacore*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/hs_err_*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/core*
二次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/**※1
二次
×

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/**※1
二次
×

<JSP用一時ディレクトリ(webserver.work.directory)>/**※1
二次
×

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*/*/*
二次
○

<インプロセスHTTPサーバのアクセスログファイル名(webserver.logger.access_log.inprocess_http.filename)>/*.log
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/http/maintenance/thr/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/http/maintenance/comm/*
一次
○

<稼働情報ファイル出力先ディレクトリ(ejbserver.management.stats_file.dir)>/*
二次
△

Webコンテナサーバ（サーブレットエンジンモードで実行している場合）
<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/*
一次
△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/*/*
一次
△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/*/*/*
一次
△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/*/*/*/*
一次
△

/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/*
一次
○

/opt/Cosminexus/CC/web/containers/<サーバ名称>/javacore*
一次
○

/opt/Cosminexus/CC/web/containers/<サーバ名称>/hs_err*
一次
○

/opt/Cosminexus/CC/web/containers/<サーバ名称>/core*
二次
○

サーバ管理コマンド※2
/opt/Cosminexus/CC/admin/usrconf/*
一次
○

/opt/Cosminexus/CC/admin/logs/*
一次
△

/opt/Cosminexus/CC/admin/logs/*/*
一次
○

/opt/Cosminexus/CC/admin/logs/*/*/*
一次
○

/opt/Cosminexus/CC/admin/logs/*/*/*/*
二次
○

リダイレクタ（Webサーバ）
/opt/Cosminexus/CC/web/redirector/logs/*
一次
○

/opt/Cosminexus/CC/web/redirector/*.conf
一次
○

/opt/Cosminexus/CC/web/redirector/*.properties
一次
○

<リダイレクタログ出力ディレクトリ(JkLogFileDir)>/*
一次
○

<リダイレクタログ出力ディレクトリ(JkLogFileDir)>/*/*
一次
○

<リダイレクタログ出力ディレクトリ(JkTraceLogFileDir)>/*
一次
○

<リダイレクタログ出力ディレクトリ(JkTraceLogFileDir)>/*/*
一次
○

/opt/Cosminexus/CC/web/redirector/servers/<Webサーバ名>/*.conf
一次
○

/opt/Cosminexus/CC/web/redirector/servers/<Webサーバ名>/*.properties
一次
○

JCA/JDBCコネクション管理
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*
一次
○

TP1/Message Queue - Access
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/mqc.api.*.*
一次
○

uCosminexus TP1 Connector
(TP1/Client/J)
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*/*
一次
○

${jp.co.hitachi_system.tp1connector.logdestination}/tp1connector*.log
一次
△

${user.home}/tp1connector*.log
一次
○

${jp.co.hitachi_system.tp1connector.logdestination}/TP1clientJ/dcClt*.dmp
二次
○

Cosminexus RM
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/*/*/*
一次
○

<Cosminexus RMインストールディレクトリ>/logs/cmd/*
一次
△

<Cosminexus RMインストールディレクトリ>/logs/cmd/*/*/*
一次
△

<Cosminexus RMインストールディレクトリ>/logs/cmd/*/*/*/*
一次
△

<Cosminexus RMインストールディレクトリ>/logs/cmd/*/*/*/*/*
一次
△

<Cosminexusインストールディレクトリ(cosminexus.home)>/RM/logs/cmd/*
一次
△

<Cosminexusインストールディレクトリ(cosminexus.home)>/RM/logs/cmd/*/*/*
一次
△

<Cosminexusインストールディレクトリ(cosminexus.home)>/RM/logs/cmd/*/*/*/*
一次
△

<Cosminexusインストールディレクトリ(cosminexus.home)>/RM/logs/cmd/*/*/*/*/*
一次
△

<ユーザ指定ディレクトリ(RMLogTraceFileDir)>/*
一次
△

EJBクライアント
<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/*
一次
△

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/*/*/*
一次
△

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/*/*/*/*※3
一次
△

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/*/*/*/*/*※3
二次
△

Management Server
/opt/Cosminexus/manager/config/*.bak
一次
○

/opt/Cosminexus/manager/config/*.cfg
一次
○

/opt/Cosminexus/manager/config/*.conf
一次
○

/opt/Cosminexus/manager/config/*.xml
一次
○

/opt/Cosminexus/manager/config/*.properties
一次
○

/opt/Cosminexus/manager/config/*.server_name
一次
○

/opt/Cosminexus/manager/config/filterlist
一次
○

/opt/Cosminexus/manager/config/.+
二次
○

/opt/Cosminexus/manager/tmp/*※4
一次
○

/opt/Cosminexus/manager/tmp/*.zip
二次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/message/*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/message/mmap/*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/trace/*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/trace/mmap/*
一次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/*
二次
○

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/mmap/*
二次
○

<コアダンプ出力ディレクトリ(CoreDumpDirectory)>/*
二次
○

<HNTRLib2のインストールディレクトリ>/spool/hntr2*.log
一次
○

/var/opt/hitachi/HNTRLib2/spool/*
一次
○

/etc/hosts
一次
○

/opt/Cosminexus/manager/setup/config/*
一次
○

/opt/Cosminexus/manager/setup/log/*.log
一次
○

/opt/Cosminexus/manager/setup/log/maintenance/*.log
一次
○

/opt/Cosminexus/manager/setup/tmp/*
一次
○

Cosminexus Service Coordinator※5
<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/csc/*
一次
○

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/csc/maintenance/*
一次
○

<HCSCサーバのプロパティ(requesttrace-filepath)>/*
一次
△

<HCSCサーバのプロパティ(methodtrace-filepath)>/*
一次
△

/opt/Cosminexus/CSC/system/msg/*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/apps/*
二次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/apps/*/*
二次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/apps/*/*/*
二次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/apps/*/*/*/*
二次
○

/opt/Cosminexus/CSC/config/manager/*
一次
○

<リポジトリルート(cscmng.repository.root)>/**
二次
×

<ログディレクトリ(cscmng.log.dir)>/*
一次
△

Server Plug-in
<Eclipseワークスペースディレクトリ>/.metadata/.plugins/com.cosminexus.plugin.server.explorer/.logs/*.log
一次
×

<Eclipseワークスペースディレクトリ>/.metadata/.plugins/com.cosminexus.plugin.server.core/.logs/*.log
一次
×

<Eclipseワークスペースディレクトリ>/.metadata/.log
二次
×

バッチアプリケーション実行コマンド
/opt/Cosminexus/CC/batch/logs/*
一次
△

/opt/Cosminexus/CC/batch/logs/*/*
一次
△

/opt/Cosminexus/CC/batch/logs/*/*/*
一次
△

/opt/Cosminexus/CC/batch/logs/*/*/*/*
一次
△

SOAP
/opt/Cosminexus/c4web/logs/*
一次
○

/opt/Cosminexus/c4web/conf/*
一次
○

/opt/Cosminexus/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/server-config.xml
一次
○

/opt/Cosminexus/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/c4webcl.properties
一次
○

/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/server-config.xml
一次
○

/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/c4webcl.properties
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/cjmessage*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/cjexception*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/WS/*
一次
○

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/WS/maintenance/*
二次
○

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/*/*/*
一次
△

/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjmessage*
一次
○

/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjexception*
一次
○

/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/WS/*
一次
○

/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/WS/maintenance/*
二次
○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

×：デフォルトでは収集されません。snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，収集対象ディレクトリに設定する必要があります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定したディレクトリです。

<JSP用一時ディレクトリ(webserver.work.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.work.directoryパラメタで指定したディレクトリです。

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリです。

<インプロセスHTTPサーバのアクセスログファイル名(webserver.logger.access_log.inprocess_http.filename)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.logger.access_log.inprocess_http.filenameパラメタで指定したディレクトリです。

<稼働情報ファイル出力先ディレクトリ(ejbserver.management.stats_file.dir)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.management.stats_file.dirパラメタで指定したディレクトリです。

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>
J2EEサーバ用のusrconf.cfgのweb.server.log.directoryキーに指定したディレクトリです。

<リダイレクタログ出力ディレクトリ(JkLogFileDir)>
簡易構築定義ファイルの論理Webサーバ（web-server）の<configuration>タグ内に，JkLogFileDirパラメタで指定したディレクトリです。

<リダイレクタログ出力ディレクトリ(JkTraceLogFileDir)>
簡易構築定義ファイルの論理Webサーバ（web-server）の<configuration>タグ内に，JkTraceLogFileDirパラメタで指定したディレクトリです。

<Cosminexus RMインストールディレクトリ>
環境変数HRMDIRに指定したディレクトリです。

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>
EJBクライアントアプリケーションのシステムプロパティejbserver.client.log.directoryキーに指定したディレクトリ，またはcjclstartapコマンドのカレントディレクトリです。

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>
manager.cfgのcom.cosminexus.manager.log.dirキーに指定したディレクトリです。

<コアダンプ出力ディレクトリ(CoreDumpDirectory)>
簡易構築定義ファイルの論理Webサーバ（web-server）の<configuration>タグ内に，CoreDumpDirectoryパラメタで指定したディレクトリです。

<HNTRLib2のインストールディレクトリ>
日立トレース共通ライブラリのインストールディレクトリです。デフォルトは，「/opt/Hitachi/HNTRLib2」です。

<HCSCサーバのプロパティ(requesttrace-filepath)>
HCSCサーバ定義コマンド（cscsvconfig）でrequesttrace-filepathプロパティに指定したディレクトリです。

<HCSCサーバのプロパティ(methodtrace-filepath)>
HCSCサーバ定義コマンドcscsvconfigでmethodtrace-filepathプロパティに指定したディレクトリです。

<リポジトリルート(cscmng.repository.root)>
HCSC-Manager定義（cscmng.properties）のcscmng.repository.rootキーに指定したリポジトリルートです。

<ログディレクトリ(cscmng.log.dir)>
HCSC-Manager定義（cscmng.properties）のcscmng.log.dirキーに指定したログディレクトリです。

<Eclipseワークスペースディレクトリ>
Eclipseを利用するユーザが任意で作成するディレクトリです。

注※1

21階層分までのディレクトリを収集対象にします。

注※2

環境に合わせて収集対象になるディレクトリパスを変更してから収集してください。

注※3

Cosminexus TPBrokerで環境変数が設定されている場合は，環境変数の設定が優先されます。

注※4

*.zip以外のファイルが収集されます。

注※5

uCosminexus Service Platformの場合だけ出力されます。

付録B.2　Cosminexus Component Transaction Monitor

Cosminexus Component Transaction Monitorに関連する収集対象ディレクトリパスを次の表に示します。

表B-3　Cosminexus Component Transaction Monitorに関連する収集対象ディレクトリパス（Windowsの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<スプールディレクトリ(ctmspool)>¥log¥ctmdmlog* | 一次 | ○
<スプールディレクトリ(ctmspool)>¥log¥<CTM識別子>¥ctmlog* | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

注　<スプールディレクトリ(ctmspool)>は，環境変数CTMSPOOLに指定したディレクトリです。

表B-4　Cosminexus Component Transaction Monitorに関連する収集対象ディレクトリパス（UNIXの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<スプールディレクトリ(ctmspool)>/log/ctmdmlog* | 一次 | ○
<スプールディレクトリ(ctmspool)>/log/<CTM識別子>/ctmlog* | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

注　<スプールディレクトリ(ctmspool)>は，環境変数CTMSPOOLに指定したディレクトリです。

付録B.3　Cosminexus DABroker Library

Cosminexus DABroker Libraryに関連する収集対象ディレクトリパスを次の表に示します。

表B-5　Cosminexus DABroker Libraryに関連する収集対象ディレクトリパス（Windowsの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<Cosminexusのインストールディレクトリ>¥DAB¥conf¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥DAB¥spool¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥DAB¥spool¥*¥* | 二次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

注　<Cosminexusのインストールディレクトリ>は，Cosminexusのインストールディレクトリです。デフォルトは，「C:¥Program Files¥HITACHI¥Cosminexus」です。

表B-6　Cosminexus DABroker Libraryに関連する収集対象ディレクトリパス（UNIXの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
/opt/DABroker/conf/* | 一次 | ○
/opt/DABroker/spool/* | 一次 | ○
/opt/DABroker/spool/*/* | 二次 | ○
<DABroker運用ディレクトリ>/DAB/conf/* | 一次 | △
<DABroker運用ディレクトリ>/DAB/spool/* | 一次 | △
<DABroker運用ディレクトリ>/DAB/spool/*/* | 二次 | △

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

注　<DABroker運用ディレクトリ>は，デフォルトでは<Cosminexus DABroker Libraryのインストールディレクトリ>です。dabsetupコマンドを使用して変更することもできます。

付録B.4　Cosminexus Developer's Kit for Java

Windowsの場合のCosminexus Developer's Kit for Javaに関連する収集対象ディレクトリパスを次の表に示します。

表B-7　Cosminexus Developer's Kit for Javaに関連する収集対象ディレクトリパス（Windowsの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
C:¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥drwtsn32.log | 一次 | △
C:¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥user.dmp | 二次 | △

（凡例）

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

注　収集対象ディレクトリパスは，drwtsn32のデフォルトです。変更されている可能性があります。

付録B.5　Cosminexus Performance Tracer

Cosminexus Performance Tracerに関連する収集対象ディレクトリパスを次の表に示します。

表B-8　Cosminexus Performance Tracerに関連する収集対象ディレクトリパス（Windowsの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<スプールディレクトリ(prfspool)>¥log¥<PRF識別子>¥* | 一次 | ○
<スプールディレクトリ(prfspool)>¥shm¥* | 二次 | ○
<スプールディレクトリ(prfspool)>¥utt¥prf¥<PRF識別子>¥dcopltrc¥* | 二次 | ○
<スプールディレクトリ(prfspool)>¥utt¥prf¥<PRF識別子>¥spool¥dcopltrcinf¥* | 二次 | ○
<スプールディレクトリ(prfspool)>¥utt¥prf¥<PRF識別子>¥spool¥save¥* | 二次 | ○
<スプールディレクトリ(prfspool)>¥utt¥prf¥<PRF識別子>¥* | 二次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

注　<スプールディレクトリ(prfspool)>は，環境変数PRFSPOOLに指定したディレクトリです。

表B-9　Cosminexus Performance Tracerに関連する収集対象ディレクトリパス（UNIXの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<スプールディレクトリ(prfspool)>/log/<PRF識別子>/* | 一次 | ○
<スプールディレクトリ(prfspool)>/utt/prf/<PRF識別子>/dcopltrc/* | 二次 | ○
<スプールディレクトリ(prfspool)>/utt/prf/<PRF識別子>/spool/dcopltrcinf/* | 二次 | ○
<スプールディレクトリ(prfspool)>/utt/prf/<PRF識別子>/spool/save/* | 二次 | ○
<スプールディレクトリ(prfspool)>/utt/prf/<PRF識別子>/* | 二次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

注　<スプールディレクトリ(prfspool)>は，環境変数PRFSPOOLに指定したディレクトリです。

付録B.6　Cosminexus TPBroker

Cosminexus TPBrokerに関連する収集対象ディレクトリパスを次の表に示します。

表B-10　Cosminexus TPBrokerに関連する収集対象ディレクトリパス（Windowsの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<Cosminexusのインストールディレクトリ>¥TPB¥log¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥log¥*¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥logj¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥logj¥*¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥adm¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥spool¥log¥admlog | 一次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥spool¥admsts | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥spool¥admproc | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥spool¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥spool¥*¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥spool¥*¥*¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥spool¥*¥*¥*¥* | 二次 | ○
<ADMスプールディレクトリ>¥log¥admlog | 一次 | △
<ADMスプールディレクトリ>¥admsts | 二次 | △
<ADMスプールディレクトリ>¥admproc | 二次 | △
<ADMスプールディレクトリ>¥* | 二次 | △
<ADMスプールディレクトリ>¥*¥* | 二次 | △
<ADMスプールディレクトリ>¥*¥*¥* | 二次 | △
<ADMスプールディレクトリ>¥*¥*¥*¥* | 二次 | △
<ADMFSディレクトリ>¥admsts | 二次 | △
<ADMFSディレクトリ>¥admproc | 二次 | △
<ADMFSディレクトリ>¥* | 二次 | △
<Cosminexusのインストールディレクトリ>¥TPB¥otsspool¥log¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥otsspool¥tmshm | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥otsspool¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥otsspool¥*¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥otsspool¥*¥*¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥TPB¥otsspool¥*¥*¥*¥* | 二次 | ○
<スプールディレクトリ(tpspool)>¥log¥* | 一次 | ○
<スプールディレクトリ(tpspool)>¥tmshm | 二次 | ○
<スプールディレクトリ(tpspool)>¥* | 二次 | ○
<スプールディレクトリ(tpspool)>¥*¥* | 二次 | ○
<スプールディレクトリ(tpspool)>¥*¥*¥* | 二次 | ○
<スプールディレクトリ(tpspool)>¥*¥*¥*¥* | 二次 | ○
<TPFSディレクトリ（tpfs）>¥* | 二次 | ○
<VBROKER_ADMディレクトリ>¥..¥log¥* | 一次 | △
<VBROKER_ADMディレクトリ>¥..¥log¥*¥* | 二次 | △
<VBROKER_ADMディレクトリ>¥..¥logj¥* | 一次 | △
<VBROKER_ADMディレクトリ>¥..¥logj¥*¥* | 二次 | △
<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥otsstatus¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥otsstatus¥*¥* | 二次 | ○
<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)※>¥* | 二次 | ○
<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.statusfile.directory1)※>¥*¥* | 二次 | ○
<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.statusfile.directory2)※>¥* | 二次 | ○
<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.statusfile.directory2)※>¥*¥* | 二次 | ○
イベントログ | 一次 | ×

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

×：デフォルトでは収集されません。snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，収集対象ディレクトリに設定する必要があります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<Cosminexusのインストールディレクトリ>
Cosminexusのインストールディレクトリです。デフォルトは，「C:¥Program Files¥HITACHI¥Cosminexus」です。

<ADMスプールディレクトリ>
環境変数ADMSPOOLに指定したディレクトリです。

<ADMFSディレクトリ>
環境変数ADMFSに指定したディレクトリです。

<スプールディレクトリ(tpspool)>
環境変数TPSPOOLに指定したディレクトリです。

<TPFSディレクトリ（tpfs）>
環境変数TPFSに指定したディレクトリです。

<VBROKER_ADMディレクトリ>
環境変数VBROKER_ADMに指定したディレクトリです。

<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.distributedtx.ots.status.directory1パラメタで指定したディレクトリです。

<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.distributedtx.ots.status.directory2パラメタで指定したディレクトリです。

注※

環境に合わせて収集対象になるディレクトリパスを変更してから収集してください。

表B-11　Cosminexus TPBrokerに関連する収集対象ディレクトリパス（UNIXの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
/opt/Cosminexus/TPB/log/* | 一次 | ○
/opt/Cosminexus/TPB/log/*/* | 二次 | ○
/opt/Cosminexus/TPB/logj/* | 一次 | ○
/opt/Cosminexus/TPB/logj/*/* | 二次 | ○
/opt/Cosminexus/TPB/adm/* | 一次 | ○
/opt/Cosminexus/TPB/conf/* | 一次 | ○
/opt/Cosminexus/TPB/conf/*/* | 一次 | ○
/opt/Cosminexus/TPB/conf/*/*/* | 一次 | ○
/opt/Cosminexus/TPB/conf/*/*/*/* | 一次 | ○
/opt/Cosminexus/TPB/spool/log/admlog | 一次 | ○
/opt/Cosminexus/TPB/spool/admsts | 二次 | ○
/opt/Cosminexus/TPB/spool/admproc | 二次 | ○
/opt/Cosminexus/TPB/spool/* | 二次 | ○
/opt/Cosminexus/TPB/spool/*/* | 二次 | ○
/opt/Cosminexus/TPB/spool/*/*/* | 二次 | ○
/opt/Cosminexus/TPB/spool/*/*/*/* | 二次 | ○
<ADMスプールディレクトリ>/log/admlog | 一次 | △
<ADMスプールディレクトリ>/admsts | 二次 | △
<ADMスプールディレクトリ>/admproc | 二次 | △
<ADMスプールディレクトリ>/* | 二次 | △
<ADMスプールディレクトリ>/*/* | 二次 | △
<ADMスプールディレクトリ>/*/*/* | 二次 | △
<ADMスプールディレクトリ>/*/*/*/* | 二次 | △
<ADMFSディレクトリ>/admsts | 二次 | △
<ADMFSディレクトリ>/admproc | 二次 | △
<ADMFSディレクトリ>/* | 二次 | △
/opt/Cosminexus/TPB/otsspool/log/* | 一次 | ○
/opt/Cosminexus/TPB/otsspool/tmshm | 二次 | ○
/opt/Cosminexus/TPB/otsspool/* | 二次 | ○
/opt/Cosminexus/TPB/otsspool/*/* | 二次 | ○
/opt/Cosminexus/TPB/otsspool/*/*/* | 二次 | ○
/opt/Cosminexus/TPB/otsspool/*/*/*/* | 二次 | ○
/opt/Cosminexus/TPB/otsspool/*/*/*/*/* | 二次 | ○
<スプールディレクトリ(tpspool)>/log/* | 一次 | ○
<スプールディレクトリ(tpspool)>/tmshm | 一次 | ○
<スプールディレクトリ(tpspool)>/* | 二次 | ○
<スプールディレクトリ(tpspool)>/*/* | 二次 | ○
<スプールディレクトリ(tpspool)>/*/*/* | 二次 | ○
<スプールディレクトリ(tpspool)>/*/*/*/* | 二次 | ○
<スプールディレクトリ(tpspool)>/*/*/*/*/* | 二次 | ○
<TPFSディレクトリ（tpfs）>/* | 二次 | ○
<VBROKER_ADMディレクトリ>/../log/* | 一次 | △
<VBROKER_ADMディレクトリ>/../log/*/* | 二次 | △
<VBROKER_ADMディレクトリ>/../logj/* | 一次 | △
<VBROKER_ADMディレクトリ>/../logj/*/* | 二次 | △
/opt/Cosminexus/CC/server/public/ejb/< サーバ名称>/otsstatus/* | 二次 | ○
/opt/Cosminexus/CC/server/public/ejb/< サーバ名称>/otsstatus/*/* | 二次 | ○
<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)※>/* | 二次 | ○
<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)※>/*/* | 二次 | ○
<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)※>/* | 二次 | ○
<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)※>/*/* | 二次 | ○
syslog | 一次 | ×

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

×：デフォルトでは収集されません。snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，収集対象ディレクトリに設定する必要があります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<ADMスプールディレクトリ>
環境変数ADMSPOOLに指定したディレクトリです。

<ADMFSディレクトリ>
環境変数ADMFSに指定したディレクトリです。

<TPFSディレクトリ（tpfs）>
環境変数TPFSに指定したディレクトリです。

<VBROKER_ADMディレクトリ>
環境変数VBROKER_ADMに指定したディレクトリです。

<スプールディレクトリ(tpspool)>
環境変数TPSPOOLに指定したディレクトリです。

<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.distributedtx.ots.status.directory1パラメタで指定したディレクトリです。

<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.distributedtx.ots.status.directory2パラメタで指定したディレクトリです。

注※

環境に合わせて収集対象になるディレクトリパスを変更してから収集してください。

付録B.7　Cosminexus Web Services - Security

Cosminexus Web Services - Securityに関連する収集対象ディレクトリパスを次の表に示します。

表B-12　Cosminexus Web Services - Securityに関連する収集対象ディレクトリパス（Windowsの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<Cosminexusのインストールディレクトリ>¥wss¥logs¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥wss¥conf¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥web¥<サーバ名称>¥<コンテキストルート>¥WEB-INF¥classes¥client-config.xml | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥web¥<サーバ名称>¥<コンテキストルート>¥WEB-INF¥classes¥policy-config.xml | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥web¥<サーバ名称>¥<コンテキストルート>¥WEB-INF¥classes¥security-config.xml | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps¥<コンテキストルート>¥WEB-INF¥classes¥client-config.xml | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps¥<コンテキストルート>¥WEB-INF¥classes¥policy-config.xml | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps¥<コンテキストルート>¥WEB-INF¥classes¥security-config.xml | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥cjmessage* | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥cjexception* | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥WS¥* | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥WS¥maintenance¥* | 二次 | ○
<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>¥*¥*¥* | 一次 | △
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjmessage* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjexception* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥WS¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥WS¥maintenance¥* | 二次 | ○
<Cosminexusのインストールディレクトリ>¥XMLSEC¥logs¥* | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<Cosminexusのインストールディレクトリ>
Cosminexusのインストールディレクトリです。デフォルトは，「C:¥Program Files¥HITACHI¥Cosminexus」です。

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定されたディレクトリです。

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>
EJBクライアントアプリケーションのシステムプロパティejbserver.client.log.directoryキーに指定したディレクトリです。

表B-13　Cosminexus Web Services - Securityに関連する収集対象ディレクトリパス（UNIXの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
/opt/Cosminexus/wss/logs/* | 一次 | ○
/opt/Cosminexus/wss/conf/* | 一次 | ○
/opt/Cosminexus/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/client-config.xml | 一次 | ○
/opt/Cosminexus/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/policy-config.xml | 一次 | ○
/opt/Cosminexus/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/security-config.xml | 一次 | ○
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/client-config.xml | 一次 | ○
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/policy-config.xml | 一次 | ○
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/security-config.xml | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/cjmessage* | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/cjexception* | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/WS/* | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/WS/maintenance/* | 二次 | ○
<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/*/*/* | 一次 | △
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjmessage* | 一次 | ○
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjexception* | 一次 | ○
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/WS/* | 一次 | ○
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/WS/maintenance/* | 二次 | ○
/opt/Cosminexus/XMLSEC/logs/* | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定されたディレクトリです。

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>
EJBクライアントアプリケーションのシステムプロパティejbserver.client.log.directoryキーに指定したディレクトリです。

付録B.8　Hitachi Web Server

Hitachi Web Serverに関連する収集対象ディレクトリパスを次の表に示します。

表B-14　Hitachi Web Serverに関連する収集対象ディレクトリパス（Windowsの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<HWSのインストールディレクトリ>¥conf¥*.conf | 一次 | ○
<HWSのインストールディレクトリ>¥logs¥* | 二次 | ○
<HWSのインストールディレクトリ>¥servers¥HWS_<サーバ名称>¥logs¥* | 二次 | ○
<HWSTraceLogFileディレクティブ>¥* | 二次 | △
<HWSログ出力ディレクトリ(hws.logfile.dir)>¥* | 二次 | ○
<HWSのインストールディレクトリ>¥servers¥HWS_<サーバ名称>¥conf¥*.conf | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<HWSのインストールディレクトリ>
Hitachi Web Serverのインストールディレクトリです。デフォルトは，「C:¥Program Files¥HITACHI¥Cosminexus¥httpsd」です。

<HWSTraceLogFileディレクティブ>
httpsd.confのHWSTraceLogFileディレクティブに指定したディレクトリです。

<HWSログ出力ディレクトリ(hws.logfile.dir)>
httpsd.confのHWSTraceLogFile，ErrorLog，CustomLog，およびHWSRequestLogディレクティブに指定したファイル名のディレクトリ部分です。

表B-15　Hitachi Web Serverに関連する収集対象ディレクトリパス（UNIXの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
opt/hitachi/httpsd/conf/*.conf | 一次 | ○
opt/hitachi/httpsd/logs/* | 二次 | ○
opt/hitachi/httpsd/servers/HWS_<サーバ名称>/logs/* | 二次 | ○
<HWSTraceLogFileディレクティブ>/* | 二次 | △
<コアダンプ出力ディレクトリ(CoreDumpDirectory)>/* | 二次 | ○
<HWSログ出力ディレクトリ(hws.logfile.dir)>/* | 二次 | ○
opt/hitachi/httpsd/servers/HWS_<サーバ名称>/conf/*.conf | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<サーバ名称>
Management Serverで設定した値です。

<HWSTraceLogFileディレクティブ>
httpsd.confのHWSTraceLogFileディレクティブに指定したディレクトリです。

<HWSログ出力ディレクトリ(hws.logfile.dir)>
httpsd.confのHWSTraceLogFile，ErrorLog，CustomLog，およびHWSRequestLogディレクティブに指定したファイル名のディレクトリ部分です。

付録B.9　Cosminexus cFramework

Cosminexus cFrameworkに関連する収集対象ディレクトリパスを次の表に示します。

表B-16　Cosminexus cFrameworkに関連する収集対象ディレクトリパス（Windowsの場合）

分類 | 収集対象ディレクトリパス | 一次／二次 | 収集方法
J2EEサーバ（J2EEサーバモードで実行している場合） | <J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥web¥<サーバ名称>¥<コンテキストルート>¥WEB-INF¥props¥* | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥cframework* | 一次 | ○
Webコンテナサーバ（サーブレットエンジンモードで実行している場合） | <Cosminexusのインストールディレクトリ>CC¥web¥containers¥<サーバ名称>¥webapps¥＜コンテキストルート＞¥WEB-INF¥props¥* | 一次 | ○
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥cframework* | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

注　表内のそれぞれのディレクトリの意味は次のとおりです。

<Cosminexusのインストールディレクトリ>
Cosminexusのインストールディレクトリです。デフォルトは，「C:¥Program Files¥HITACHI¥Cosminexus」です。

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定されたディレクトリです。

表B-17　Cosminexus cFrameworkに関連する収集対象ディレクトリパス（UNIXの場合）

分類 | 収集対象ディレクトリパス | 一次／二次 | 収集方法
J2EEサーバ（J2EEサーバモードで実行している場合） | <J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/<コンテキストルート>/WEB-INF/props/* | 一次 | ○
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/cframework* | 一次 | ○
Webコンテナサーバ（サーブレットエンジンモードで実行している場合） | /opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps/＜コンテキストルート＞/WEB-INF/props/* | 一次 | ○
/opt/Cosminexus/CC/web/containers/<サーバ名称>/cframework* | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

注　表内の<J2EEサーバ作業ディレクトリ(ejb.public.directory)>は簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定されたディレクトリです。

付録B.10　uCosminexus Service Adapter for TP1

uCosminexus Service Adapter for TP1の情報に関連する収集対象ディレクトリパスを次の表に示します。

表B-18　uCosminexus Service Adapter for TP1の情報に関連する収集対象ディレクトリパス（Windowsの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>¥ejb¥<サーバ名称>¥logs¥CSCADP¥TP1ADP¥maintenance¥* | 二次 | △

（凡例）

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

注　表内の<J2EEサーバ作業ディレクトリ(ejb.public.directory)>は簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定されたディレクトリです。

表B-19　uCosminexus Service Adapter for TP1の情報に関連する収集対象ディレクトリパス（UNIXの場合）

収集対象ディレクトリパス | 一次／二次 | 収集方法
<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/< サーバ名称>/logs/CSCADP/TP1ADP/maintenance/* | 二次 | △

（凡例）

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

注　表内の<J2EEサーバ作業ディレクトリ(ejb.public.directory)>は簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定されたディレクトリです。

付録B.11　監査ログ

監査ログの情報に関連する収集対象ディレクトリパスを次の表に示します。

表B-20　監査ログ（Windowsの場合）

分類 | 収集対象ディレクトリパス | 一次／二次 | 収集方法
監査ログの例外情報 | <Cosminexusのインストールディレクトリ>¥auditlog¥rasexception*.log | 一次 | △
監査ログのメッセージログ | <Cosminexusのインストールディレクトリ>¥auditlog¥rasmessage*.log | 一次 | △
監査ログ | <Cosminexusのインストールディレクトリ>¥auditlog¥* | 二次 | △
<Cosminexusのインストールディレクトリ>¥auditlog¥*¥* | 二次 | △

（凡例）

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

表B-21　監査ログ（UNIXの場合）

分類 | 収集対象ディレクトリパス | 一次／二次 | 収集方法
監査ログの例外情報 | /opt/Cosminexus/auditlog/rasexception*.log | 一次 | △
監査ログのメッセージログ | /opt/Cosminexus/auditlog/rasmessage*.log | 一次 | △
監査ログ | /opt/Cosminexus/auditlog/* | 二次 | △
/opt/Cosminexus/auditlog/*/* | 二次 | △

（凡例）

△：デフォルトで収集されます。ただし，出力ディレクトリの設定を変更した場合，snapshotログとして収集するには，snapshotログ収集対象定義ファイル（snapshotlog.conf，またはsnapshotlog.2.conf）を編集して，変更後の出力ディレクトリを収集対象ディレクトリとして設定し直す必要があります。

付録B.12　そのほかの情報

そのほかの情報に関連する収集対象ディレクトリパスを次の表に示します。

表B-22　そのほかの情報に関連する収集対象ディレクトリパス（UNIXの場合）

内容 | 収集対象のディレクトリパス | 一次／二次 | 収集方法
プログラムプロダクト情報 | /etc/.hitachi/pplistd | 一次 | ○

（凡例）

○：デフォルトで収集されます。出力ディレクトリを変更した場合も，収集対象になります。

付録C　データベースと接続中にトラブルが発生したコネクションの特定

データベース関連のトラブルに対処するためには，どのコネクションを使用してデータベースと接続しているかを特定することが重要です。

ここでは，データベース（HiRDBまたはOracle）と接続中にトラブルが発生した場合に，Cosminexusから出力される情報（性能解析トレースやログなど）とデータベースから出力される情報（トレース情報やpdlsコマンドの実行結果，動的パフォーマンスビューの内容など）を使用して，トラブルが発生したコネクションを特定する方法について説明します。

Cosminexusでは，HiRDBおよびOracleとの接続に使用しているコネクションを一意に識別するための接続情報（コネクションID）を性能解析トレースに出力しています。J2EEサーバからデータベースに至るまで，およびデータベースからJ2EEサーバに処理結果が返却されるまでの一連の処理では，関連する構成ソフトウェアのログやトレース情報などにコネクションIDやデータベースサーバで割り振られるコネクト通番などが出力されます。これらの情報を突き合わせて確認することで，トラブルが発生したコネクションを特定できます。

HiRDBを使用する場合，およびOracleを使用する場合のコネクションIDの出力の概要，およびトラブルが発生したコネクションの特定に使用する情報を次に示します。

HiRDBを使用する場合
コネクションIDの出力の概要を次に示します。

図C-1　コネクションIDの出力の概要（HiRDBの場合）

トラブルが発生したコネクションの特定に使用する情報を次の表に示します。

表C-1　トラブルが発生したコネクションの特定に使用する情報（HiRDBの場合）

項番 | 出力元 | 情報の種類 | 参照先
1 | Cosminexus Component Container | 性能解析トレースファイル | 付録C.1
2 | SQLException発生時の例外メッセージ
3 | Cosminexus DABroker Library | 拡張データベースアクセストレース | 付録C.2
4 | HiRDBクライアント | SQLトレースファイル | 付録C.3
5 | エラーログ情報
6 | 再接続トレース
7 | HiRDBサーバ | pdlsコマンドの実行結果 | 付録C.4

コネクションIDには次に示す情報が含まれています。

サーバ名称
フロントエンドサーバ名（HiRDB/Parallel Server使用時）またはシングルサーバ名（HiRDB/Single Server使用時）が表示されます。

コネクト通番
サーバ名称に表示されたHiRDBサーバで割り振られるコネクト通番が表示されます。

サーバのプロセスID
サーバ名称に表示されたHiRDBサーバのプロセスIDが表示されます。

コネクションIDの出力形式と出力例を次に示します。

コネクションIDの出力形式（HiRDBの場合）

サーバ名称：コネクト通番：サーバのプロセスID

コネクションIDの出力例（HiRDBの場合）

fes01:15:2351

注意

07-01以前のバージョンのHiRDBに接続していて，グローバルトランザクションとローカルトランザクションが混在している場合，性能解析トレースに出力されるコネクションIDと実際の接続状態に不整合が生じます。

例えば，コネクションの障害検知機能を無効にして，次のようなグローバルトランザクションとローカルトランザクションが混在している処理を実行する場合，6.～8.および9.～13.の処理で性能解析トレースに出力される情報と実際の接続状態に不整合が生じます。

6.～8.の処理では，ローカルトランザクションのコネクションIDは出力されずに，グローバルトランザクションのコネクションIDが出力されます。

9.～13.の処理では，グローバルトランザクションのコネクションIDは出力されずに，ローカルトランザクションのコネクションIDが出力されます。

このように，ローカルトランザクションのコネクションIDや，ローカルトランザクション実行後のグローバルトランザクションのコネクションIDを追跡することはできません。なお，7.のローカルトランザクションの処理で，コネクションが切り替わりますがCosminexusには通知されません。

グローバルトランザクションとローカルトランザクションの混在は，使用するDBConnectorのトランザクションサポートレベルがXATransactionの場合に，トランザクションを開始する前にコネクションを取得してSQLを実行したときにも発生します。

参考

グローバルトランザクションの処理中に，エラーが発生してコネクションが切断されると自動的に再接続されます。しかし，この再接続処理は再接続トレースには出力されません。この場合，再接続トレースに出力されるコネクションIDと実際の接続情報に不整合が生じます。ただし，基本的にグローバルトランザクションの処理中にコネクションが切断されることはありません。

Oracleを使用する場合
コネクションIDの出力の概要を次に示します。

図C-2　コネクションIDの出力の概要（Oracleの場合）

トラブルが発生したコネクションの特定に使用する情報を次の表に示します。

表C-2　トラブルが発生したコネクションの特定に使用する情報（Oracleの場合）

項番 | 出力元 | 情報の種類 | 参照先
1 | Cosminexus Component Container | 性能解析トレースファイル | 付録C.1
2 | SQLException発生時の例外メッセージ
3 | Cosminexus DABroker Library | 拡張データベースアクセストレース | 付録C.2
4 | Oracleクライアント | Netクライアントトレース | 付録C.5
5 | Oracleサーバ | アラートファイル | 付録C.6
6 | ユーザトレース
7 | Netサーバトレース
8 | 動的パフォーマンスビュー

コネクションIDには次に示す情報が含まれています。

インスタンス名
Oracleサーバのインスタンス名が表示されます。

セッションID
Oracleサーバで割り振られるセッションIDが表示されます。

セッションシリアル番号
Oracleサーバで割り振られるセッションのシリアル番号が表示されます。

OSプロセスID
OSのプロセスIDが表示されます。

コネクションIDの出力形式（Oracleの場合）

インスタンス名：セッションID：セッションシリアル番号：OSプロセス名

コネクションIDの出力例（Oracleの場合）

ORCL:17:5:920

コネクションIDの生成にはOracleの動的パフォーマンスビューを使用するため，Oracleに接続するユーザが動的パフォーマンスビューの参照権を持っている必要があります。次のどちらかの方法でOracleに接続するユーザに参照権を設定してください。

「GRANT SELECT_CATALOG_ROLE TO <ユーザ名>;」を実行する。

「GRANT SELECT ON V_$INSTANCE TO <ユーザ名>;」，「GRANT SELECT ON V_$PROCESS TO <ユーザ名>;」，および「GRANT SELECT ON V_$SESSION TO <ユーザ名>;」を実行する。

また，Oracleを使用する場合，DB Connectorのプロパティ定義で，プロパティ項目「ConnectionIDUpdate」の値に「true」を設定すると，コネクションを取得するたびにコネクションIDを生成することができます。ただし，コネクションを取得するたびにコネクションID生成用のSQLが発行されるため，性能に影響を与える可能性があります。再接続が行われない環境では「false」を設定してください。DB Connectorのプロパティ定義の設定方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のJ2EEリソースの設定に関する説明を参照してください。

注意

Oracleの透過的アプリケーションフェイルオーバーを使用している場合，PRFトレースに出力されるコネクションIDと実際に接続しているコネクションIDが異なることがあります。これはOracle内でコネクションが再接続されているためです。PRFトレースに出力されるコネクションIDと実際に接続しているコネクションIDが異なる場合，コネクションIDでOracleのトレース情報を追跡することはできません。

＜この節の構成＞

付録C.1　Cosminexus Component Container

付録C.2　Cosminexus DABroker Library

付録C.3　HiRDBクライアント

付録C.4　HiRDBサーバ

付録C.5　Oracleクライアント

付録C.6　Oracleサーバ

付録C.1　Cosminexus Component Container

トランザクション処理の状態（正常または異常）によって，Cosminexus Component Containerから出力されるコネクションIDの出力先が異なります。

正常の場合

性能解析トレースファイルに出力されます。

異常の場合

SQLException発生時の例外メッセージに出力されます。

性能解析トレースファイルには，次の三つのタイミングでコネクションIDが出力されます。

データベースとのコネクション取得時
HiRDBを使用している場合，DataSource.getConnection()メソッドまたはDataSource.getConnection(String username, String password)メソッドの終了直前に，取得したコネクションのコネクションIDを出力します。
Oracleを使用している場合，DataSource.getConnection()メソッドの終了直前に，取得したコネクションのコネクションIDを出力します。

データベースのコネクション解放時
Connection.close()メソッドの開始直後に，このメソッドに対応するgetConnectionメソッドで取得したコネクションのコネクションIDを出力します。

アソシエーション機能によってデータベースとのコネクションが差し替えられた時
ManagedConnection.associateConnection()メソッドの呼び出し時に，アソシエーション機能によって差し替えられた先のコネクションのコネクションIDを出力します。

上記のタイミングで取得したコネクションIDは，次の表に示すイベントIDのトレース情報のインタフェース名に出力されています。

表C-3　コネクションIDが出力される性能解析トレース

イベントID | 説明
0x8C01 | DataSource.getConnection()メソッドの終了直前の処理で出力された情報です。
0x8C03 | DataSource.getConnection(String username, String password)メソッドの終了直前の処理で出力された情報です。
0x8C20 | Connection.close()メソッドの開始直後の処理で出力された情報です。
0x8C40 | ManagedConnection.associateConnection()メソッドの呼び出し時の処理で出力された情報です。

なお，トレース取得ポイントと取得できるトレース情報の詳細については，「付録A.10　DB Connector，JCAコンテナのトレース取得ポイント」を参照してください。

性能解析トレース，およびSQLException発生時の例外メッセージの取得方法と出力形式について説明します。

＜この項の構成＞

(1)　性能解析トレースファイル

(2)　SQLException発生時の例外メッセージ

(1)　性能解析トレースファイル

PRFトレースファイルに出力された，クライアントからデータベースなどのEISに至るまで，およびその処理結果がクライアントに返却されるまでのリクエストの一連の処理で出力されるトレース情報をCSV形式で編集出力したファイルです。

コネクションIDが出力される条件

次の条件をすべて満たしている場合，性能解析トレースファイルにコネクションIDが出力されます。

使用しているデータベースが，次のどれかである。
バージョンが07-01以降のHiRDB
Oracle9i
Oracle 10g

論理パフォーマンストレーサが起動中である。

リソースアダプタとしてDB Connectorを使用している。

(a)　留意事項

性能解析トレースを参照するときに留意することを次に示します。

コネクションの解放に関する留意事項
同一コネクションに対してConnection.close()メソッドを複数回呼び出した場合，その数だけ性能解析トレースが出力されます。

アソシエーション機能を使用する場合の留意事項
アソシエーション機能によってデータベースとのコネクションが差し替えられた場合，getConnection()メソッドで出力されたコネクションIDとは異なる物理コネクションでデータベースに接続されます。この場合，性能解析トレースには，ManagedConnection.associateConnection()メソッドの呼び出し時に，アソシエーション機能によって差し替えられた先の物理コネクションに対応するコネクションIDが出力されます。したがって，実際にデータベースに接続しているコネクションIDを特定するためには，イベントIDが「0x8C40」の性能解析トレースに出力されたコネクションIDも追跡する必要があります。
なお，ManagedConnection.associateConnection()メソッドを呼び出しても，コネクションが差し替えられない場合があります。この場合，コネクションIDは性能解析トレースに出力されません。

参考

アソシエーション機能は，通常，1:1で対応する論理コネクションと物理コネクションの対応を差し替えて，複数の論理コネクションで一つの物理コネクションを共有する機能です。

自動再接続機能を使用する場合の留意事項
HiRDBの自動再接続機能を使用する場合，性能解析トレースファイルに出力されるコネクションIDと，実際の接続に使用しているコネクションのコネクションIDが異なることがあります。この場合，HiRDBクライアントの再接続トレースも参照する必要があります。

(b)　取得方法

運用管理コマンド（mngsvrutil）を実行して性能解析トレースファイルを取得します。性能解析トレースファイルは，「<Managerのログ出力ディレクトリ>¥prf」（Windowsの場合），または「<Managerのログ出力ディレクトリ>/prf」（UNIXの場合）に出力されます。取得方法については，「3.2.1　性能解析トレースファイルの収集方法」を参照してください。

(c)　出力形式

性能解析トレースの出力例を次に示します。コネクションIDはインタフェース名（「INT」欄）に出力されます。

図C-3　性能解析トレースの出力例

(2)　SQLException発生時の例外メッセージ

データベースアクセス，Cosminexus DABroker LibraryまたはJDBCドライバでエラーが発生した場合に，例外としてSQLExceptionがスローされたことを示すメッセージです。

コネクションIDが出力される条件

使用しているデータベースが次のどれかである場合，SQLException発生時の例外メッセージにコネクションIDが出力されます。

バージョンが07-01以降のHiRDB

Oracle9i

Oracle 10g

(a)　留意事項

SQLException発生時の例外メッセージを参照するときに留意することを次に示します。

出力されるコネクションIDに関する留意事項
SQLException発生時の例外メッセージに出力されるコネクションIDは常に最新です。HiRDBの自動再接続機能によって再接続が実行された場合，再接続後のコネクションIDが出力されます。

(b)　取得方法

SQLException発生時に，次のログファイルに例外メッセージが出力されます。

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥cjexception[n].log

<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥connectors¥<リソースアダプタの表示名>[n].log

UNIXの場合

<作業ディレクトリ>/ejb/<サーバ名称>/logs/cjexception[n].log

<作業ディレクトリ>/ejb/<サーバ名称>/logs/connectors/<リソースアダプタの表示名>[n].log

ログファイル名の[n]の部分には，面の番号（1から面数（最大16）まで）が付きます。

(c)　出力形式

HiRDBの場合

メッセージKFDJ00001-EのErrMsgの最後にコネクションIDが出力されます。出力例を次に示します。太字はコネクションIDです。

JP.co.Hitachi.soft.DBPSV_Driver.SQLException: KFDJ00001-E Error occurred at server.
[JdbcDbpsvResultSQLExecute.SQLExecute]
OperationType : 2002
ReturnCode    : -100
ErrorCode     : -404
WarningInfo   : 0
ErrorMsg    : KFPA11404-E Input data too long for column or assignment target in variable 1 [HiRDB_CONNECTION_ID(sds01:7:2988)]

Oracleの場合

メッセージORA-00942のErrMsgの最後にコネクションIDが出力されます。出力例を次に示します。太字はコネクションIDです。

JP.co.Hitachi.soft.DBPSV_Driver.SQLException: KFDJ00001-E Error occurred at server.
[JdbcDbpsvResultSQLExecute.SQLPrepare]
OperationType : 2002
ReturnCode    : -200
ErrorCode     : 942
WarningInfo   : 0
ErrorMsg      : ORA-00942: 表またはビューが存在しません。[ORACLE_CONNECTION_ID(ORCL:17:5:920)]
PreparedSQL   : selectSectionID     : 2

付録C.2　Cosminexus DABroker Library

Cosminexus DABroker Libraryでは，拡張データベースアクセストレースにコネクションIDが出力されます。

拡張データベースアクセストレースの取得方法と出力形式について説明します。

＜この項の構成＞

(1)　拡張データベースアクセストレース

(1)　拡張データベースアクセストレース

データベースへの接続から切断までのアクセス情報を出力したトレースです。データベースへの接続ごとに出力されます。

拡張データベースアクセストレースにコネクションIDが出力されるためには，次の条件を満たしている必要があります。

コネクションIDが出力される条件（HiRDBの場合）

HiRDBクライアントのバージョンが07-01以降である。

Cosminexus DABroker Library動作環境定義ファイルのDABEXSQL_TRC_LINEに0以上の値を指定している。

なお，Cosminexus DABroker Libraryの動作環境の設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。Cosminexus DABroker Library動作環境定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

コネクションIDが出力される条件（Oracleの場合）

Oracle9i，またはOracle10gを使用している。

Cosminexus DABroker Library動作環境定義ファイルのDABEXSQL_TRC_LINE Eに-1，0，または1024から32767の値を指定している。

なお，Windowsの場合，Cosminexus DABroker Library動作環境定義ファイルの設定は，環境設定ユティリティを使用します。環境設定ユティリティを使用したCosminexus DABroker Libraryの動作環境の設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。Cosminexus DABroker Library動作環境定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(a)　取得方法

拡張データベースアクセストレースの格納場所は次のとおりです。

Windowsの場合
<Cosminexus DABroker Libraryの運用ディレクトリ>¥spool¥db_accessディレクトリ下のファイル

UNIXの場合
/opt/DABroker/spool/db_accessディレクトリ下のファイル

(b)　出力形式

拡張データベースアクセストレースの出力形式を次に示します。

なお，拡張データベースアクセストレースの出力形式の詳細については，「5.5.3(2)　拡張データベースアクセストレース」を参照してください。

HiRDBの場合

「HiRDB_CONNECTION_ID」欄にコネクションIDが出力されます。

Windowsの場合

*-------------------------------------------------------*
*- DataBase Access Information (DRV)                   -*
*- Date  YYYY/MM/DD hh:mm:ss.nnnnnn                    -*
*-------------------------------------------------------*
DABroker Connect ID    : AAAAA(BBBBB)
Process ID             : CCCCC
UserID                 : DDDDD
Client Name            : EEEEE
(DB別出力情報)
Lang Mode              : GGGGG

THREAD-ID  CID   EVT   START-TIME   END-TIME   RETCODE  BLOCKCNT  (Windows QueryPerformance Counter) HiRDB_CONNECTION_ID
（トレース情報）
(SQL)SS…SS
（トレース情報）

UNIXの場合

*-------------------------------------------------------*
*- DataBase Access Information (DRV)                   -*
*- Date  YYYY/MM/DD hh:mm:ss.nnnnnn                    -*
*-------------------------------------------------------*
DABroker Connect ID    : AAAAA(BBBBB)
Process ID             : CCCCC
UserID                 : DDDDD
Client Name            : EEEEE
(DB別出力情報)
Lang Mode              : GGGGG

THREAD-ID  CID   EVT   START-TIME   END-TIME   RETCODE
BLOCKCNT   HiRDB_CONNECTION_ID
（トレース情報）
(SQL)SS・S
（トレース情報）

Oracleの場合

「ORACLE_CONNECTION_ID」欄にコネクションIDが出力されます。

*--------------------------------------------------------------------------*
*- DataBase Access Infomation (ORACLE8i Driver)                           -*
*- Date  YYYY/MM/DD hh:mm:ss.nnnnnn                                       -*
*--------------------------------------------------------------------------*
DABroker Connect ID    : AAAAAAAA(BBBBB)
Process ID             : CCCC
UserID                 : DDDDDD
Client Name            : EEEEEE
SQLNET                 : FFFFFF
Lang Mode              : GGGG
*--------------------------------------------------------------------------*
THREAD-ID    CID  EVT         START-TIME                   END-TIME                       RETCODE    BLOCKCNT  ORACLE_CONNECTION_ID
（トレース情報）
(SQL) SELECT H FROM I
（トレース情報）

付録C.3　HiRDBクライアント

HiRDBクライアントでは，SQLトレースファイル，エラーログファイル，および再接続トレースファイルに，コネクションIDやコネクト通番などの情報が出力されます。

SQLトレースファイル，エラーログファイル，および再接続トレースファイルの取得方法と出力形式について説明します。

＜この項の構成＞

(1)　SQLトレースファイル

(2)　エラーログファイル

(3)　再接続トレースファイル

(1)　SQLトレースファイル

実行したUAPのSQLトレース情報を出力したトレースファイルです。SQLの実行終了時に出力されます。

UAP実行時にSQLエラーが発生した場合，SQLトレースファイルを参照すると，エラーの原因となるSQLを特定できます。

コネクションIDが出力される条件

次の条件を満たしている場合，SQLトレースファイルにコネクションIDが出力されます。

クライアント環境定義のPDCLTPATHおよびPDSQLTRACEに値を指定している。

なお，クライアント環境定義の設定方法については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

(a)　取得方法

クライアント環境定義のPDCLTPATHに指定したディレクトリに格納されます。

(b)　出力形式

次に示す形式で，サーバ名称，コネクト通番，およびサーバのプロセスIDが出力されます。

（省略）
　 ：
CONNECTION STATUS：
　CURHOST（接続先ホスト名）　CURPORT（接続ポート番号）　SRVNAME（サーバ名称）
　CNCTNO（コネクト通番）　SVRPID（サーバのプロセスID）　CLTPID（UAPのプロセスID）　CLTTID（UAPのスレッド番号）
　 ：
（省略）

SQLトレースファイルには，SQL文，SQL実行時刻やSQL文中の変数に設定した値なども出力されます。出力形式の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

(2)　エラーログファイル

クライアントとHiRDBサーバ間の通信処理中，またはX/Openで規定したXAインタフェースでエラーが発生した場合のエラー情報を出力したログファイルです。SQL実行時，通信処理時，またはX/Openで規定したXAインタフェース関数実行時でエラーが発生したときに出力されます。

コネクションIDが出力される条件

次の条件を満たしている場合，エラーログファイルにコネクションIDが出力されます。

クライアント環境定義のPDCLTPATHおよびPDUAPERLOGに値を指定している。

なお，設定方法については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

(a)　取得方法

クライアント環境定義のPDCLTPATHに指定したディレクトリに格納されます。

(b)　出力形式

次に示す形式で，SQLトレースにサーバのプロセスIDが出力されます。

エラーログ先頭識別子（'>>'または'>'）　UAPのプロセスID　UAPのスレッド番号　サーバのプロセスID　エラーログカウンタ　（以降省略）

出力形式の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

エラーログ情報には，接続情報のほか，エラー取得時刻，SQLCODEやエラーが発生したSQLのオペレーションコードなどが出力されます。

(3)　再接続トレースファイル

HiRDBクライアントの自動再接続機能で再接続が実行された場合，HiRDBが内部的に管理している接続ハンドルの値，再接続前の接続情報，再接続後の接続情報，および再接続時刻を出力したトレースファイルです。自動再接続機能で自動的に接続が実行された場合に出力されます。

コネクションIDが出力される条件

次の条件を満たしている場合，再接続トレースファイルにコネクションIDが出力されます。

クライアント環境定義のPDCLTPATHおよびPDSQLTRACEに値を指定している。

HiRDBの自動再接続機能を使用している。

なお，設定方法については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

(a)　取得方法

クライアント環境定義PDCLTPATHに指定したディレクトリに再接続トレースファイルが格納されます。格納されるファイル名称は，pdrcnct1.trcおよびpdrcnct2.trcです。

(b)　出力形式

再接続トレースは次の形式で出力されます。

接続ハンドルの値　再接続結果（SまたはF）　再接続開始日時 - 再接続完了日時　再接続前の接続情報 => 再接続後の接続情報

コネクションIDは再接続後の接続情報として出力されます。

出力形式の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

再接続トレースファイルの出力例を次に示します。太字はコネクションIDです。

40004250 S 2004/04/12 11:10:36.766 - 2004/04/12 11:10:41.846 sds:9:23763 => sds:10:23750
40004250 S 2004/04/12 11:11:07.491 - 2004/04/12 11:11:12.547 sds:10:23750 => sds:11:23765
40004850 F 2004/04/12 11:17:58.285 - 2004/04/12 11:18:23.395 sds:14:23751 =>
40005050 S 2004/04/12 11:27:35.098 - 2004/04/12 11:27:40.152 sds:1:24414 => sds:2:24418

付録C.4　HiRDBサーバ

HiRDBサーバでは，pdlsコマンドの実行結果を参照してサーバの状態を確認します。

pdlsコマンドの実行結果に表示されるサーバ名称やサーバのプロセスIDと，コネクションIDに含まれる情報を突き合わせて，接続したHiRDBサーバの状態を確認します。

pdlsコマンドの実行形式と，実行結果の出力形式について説明します。

＜この項の構成＞

(1)　pdlsコマンドの実行結果

(1)　pdlsコマンドの実行結果

HiRDBサーバの排他制御の状態，プロセスの状態，通信制御情報などを表示できるコマンドです。

(a)　実行形式

次に示すpdlsコマンドを実行して，サーバの状態を確認します。

サーバの排他制御の状態表示する場合

pdls -d lck

サーバのプロセスの状態表示する場合

pdls -d prc

サーバの通信制御情報の表示する場合

pdls -d rpc

pdlsコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(b)　出力形式

実行結果の「SVID」欄にサーバ名称が出力されて，「PID」欄にサーバのプロセスIDが出力されます。

出力形式の詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

付録C.5　Oracleクライアント

Oracleクライアントでは，Netクライアントトレースファイルに，実行されたネットワークイベントの詳細が出力されます。Netクライアントトレースファイルのファイル名にはクライアントのOSクライアントプロセスIDが含まれています。

Netクライアントトレースファイルは次の場所に出力されます。

Windowsの場合
<sqlnet.oraファイルで指定した場所※>¥CLI_<OSクライアントプロセスID>.trc

UNIXの場合
<sqlnet.oraファイルで指定した場所※>/CLI_<OSクライアントプロセスID>.trc

注※　Netクライアントトレースファイルの出力先は，Oracleのsqlnet.oraファイルで設定します。sqlnet.oraファイルの記述形式を次に示します。なお，sqlnet.oraファイルの詳細については，Oracleのドキュメントを参照してください。

TRACE_LEVEL_CLIENT=16
TRACE_DIRECTORY_CLIENT=＜ディレクトリ名＞
TRACE_UNIQUE_CLIENT=ON
TRACE_TIMESTAMP_CLIENT=ON

Netクライアントトレースファイルを参照するには，出力されたNetクライアントトレースファイルの中から，目的のNetクライアントトレースファイルを特定する必要があります。目的のNetクライアントトレースファイルを特定する手順を次に示します。

次のSQLを実行して，OSクライアントプロセスIDを取得します。

SELECT PROCESS FROM V$SESSION WHERE (SID = <セッションID>) AND (SERIAL# = <セッションシリアル番号>);

取得したOSクライアントプロセスIDとNetクライアントトレースファイルのファイル名に含まれるOSクライアントプロセスIDを突き合わせて，目的のNetクライアントトレースファイルを特定します。

なお，Netクライアントトレースファイルの出力内容の詳細については，Oracleのドキュメントを参照してください。

注意

Netクライアントトレースは，大量のディスク領域を消費するため，システムの性能が低下する場合があります。必要なときにだけNetクライアントトレースを参照してください。

付録C.6　Oracleサーバ

Oracleサーバでは，次の方法でOracleサーバのエラー情報，サーバの状態などの情報が出力されます。

アラートファイルの取得

ユーザトレースの取得

Netサーバトレースファイルの取得

動的パフォーマンスビューの使用

＜この項の構成＞

(1)　アラートファイル

(2)　ユーザトレース

(3)　Netサーバトレースファイル

(4)　動的パフォーマンスビュー

(1)　アラートファイル

アラートファイルでは，性能解析トレースのインスタンス名をキーにして，次の情報を確認できます。

発生したすべての内部エラー，ブロック破損エラー，およびデッドロックエラー

CREATE/ALTER/DROP文，STARTUP/SHUTDOWN文，ARCHIVELOG文などの管理，操作

共有サーバとディスパッチャプロセスの機能に関するメッセージ，およびエラー

マテリアライズドビューの自動リフレッシュ中に発生したエラー

データベースおよびインスタンス起動時の，すべての初期化パラメタの値

アラートファイルは，次の場所に出力されます。

Windowsの場合
<BACKGROUND_DUMP_DESTで指定した場所※>¥ALERT_<インスタンス名>.LOG

UNIXの場合
<BACKGROUND_DUMP_DESTで指定した場所※>/ALERT_<インスタンス名>.LOG

注※　Oracleの初期化パラメタUSER_DUMP_DESTで設定します。USER_DUMP_DESTの詳細については，Oracleのドキュメントを参照してください。

出力されたアラートファイルの中から，性能解析トレースに出力されたインスタンス名とアラートファイル名に含まれるインスタンス名を突き合わせて，目的のアラートファイルを特定してください。

(2)　ユーザトレース

ユーザトレースでは，性能解析トレースのインスタンス名，OSプロセスID，セッションID，セッションシリアル番号をキーにして，次の情報を確認できます。

サーバプロセスで発生したエラー情報

SQL分の実行計画と統計情報

(3)　Netサーバトレースファイル

Oracleサーバでは，Netサーバトレースファイルに，実行されたネットワークイベントの詳細が出力されます。Netサーバトレースファイルのファイル名にはサーバのOSプロセスIDが含まれています。

Netサーバトレースファイルは次の場所に出力されます。

Windowsの場合
<sqlnet.oraファイルで指定した場所※>¥CLI_<OSプロセスID>.TRC

UNIXの場合
<sqlnet.oraファイルで指定した場所※>/CLI_<OSプロセスID>.TRC

注※　Netサーバトレースファイルの出力先は，Oracleのsqlnet.oraファイルで設定します。sqlnet.oraファイルの記述形式を次に示します。なお，sqlnet.oraファイルの詳細については，Oracleのドキュメントを参照してください。

TRACE_LEVEL_CLIENT=16
TRACE_DIRECTORY_CLIENT=<ディレクトリ名>
TRACE_UNIQUE_CLIENT=ON
TRACE_TIMESTAMP_CLIENT=ON

出力されたNetサーバトレースファイルの中から，性能解析トレースのOSプロセスIDとNetサーバトレースファイル名に含まれるOSプロセスID名を突き合わせて，目的のNetサーバトレースファイルを特定してください。

なお，Netサーバトレースファイルの出力内容の詳細については，Oracleのドキュメントを参照してください。

注意

Netサーバトレースファイルは，大量のディスク領域を消費するため，システムの性能が低下する場合があります。必要なときにだけNetクライアントトレースを参照してください。

(4)　動的パフォーマンスビュー

動的パフォーマンスビューを調査して，セッションを特定したり，プロセスの詳細についての情報を参照したりできます。動的パフォーマンスビューは，性能解析トレースファイルに出力されるコネクションIDと突き合わせて調査します。

動的パフォーマンスビューと性能解析トレースのコネクションIDの関係を次の表に示します。

表C-4　動的パフォーマンスビューと性能解析トレースのコネクションIDの関係

項番 | 動的パフォーマンスビューに表示される項目 | 性能解析トレースのコネクションIDの項目
1 | V$INSTANCE　INSTANCE_NAME | インスタンス名
2 | V$SESSION　SID | セッションID
3 | V$SESSION　SERIAL# | セッションシリアル番号
4 | V$PROCESS　SPID | OSプロセスID

動的パフォーマンスビューの詳細については，Oracleのドキュメントを参照してください。

付録D　機能ごとに出力されるログ情報

特定の機能を利用したときに出力されるログ情報について説明します。

ここでは，次の機能を利用したときに出力されるログ情報について説明します。

J2EEアプリケーション実行時間監視

＜この節の構成＞

付録D.1　J2EEアプリケーション実行時間監視で出力されるログ情報

付録D.1　J2EEアプリケーション実行時間監視で出力されるログ情報

ここでは，J2EEアプリケーションの実行時間監視機能で出力されるログ情報について説明します。

＜この項の構成＞

(1)　J2EEサーバ起動時に出力されるログ情報

(2)　タイムアウトの延長でメソッドキャンセルを実行した場合に出力されるログ情報

(3)　コマンドによってメソッドキャンセルを実行した場合に出力されるログ情報

(4)　注意事項

(1)　J2EEサーバ起動時に出力されるログ情報

J2EEサーバ起動時には，プロパティの読み込み，JavaVMのバージョンチェック，保護区リストファイルの読み込みが実行されます。

このときに出力されるログ情報を次の図に示します。

図D-1　J2EEサーバ起動時に出力されるログ情報

(2)　タイムアウトの延長でメソッドキャンセルを実行した場合に出力されるログ情報

タイムアウトが発生して，その処理の延長でメソッドキャンセルが実行された場合に出力されるログ情報を次の図に示します。どのメッセージが出力された場合も，処理は続行されます。なお，メソッドキャンセルモードが有効か無効かによって，スレッドダンプの出力回数が異なります。

メソッドキャンセルモードが有効の場合
タイムアウト発生時と，メソッドキャンセルの成功時または失敗時に，2回出力されます。

メソッドキャンセルモードが無効の場合
タイムアウト発生時に1回だけ出力されます。

また，タイムアウトを検知したメソッドが終了した場合には，KDJE52716-Iが出力されます。これは，メソッドキャンセルの実行が成功したかどうかとは関係ありません。また，実行しないで終了した場合にも出力されます。つまり，一つのメソッドの実行についてKDJE52703-WとKDJE52716-Iは，1対1で出力されます。

図D-2　タイムアウトの延長でメソッドキャンセルを実行した場合に出力されるログ情報

(3)　コマンドによってメソッドキャンセルを実行した場合に出力されるログ情報

タイムアウトが発生したメソッドを，J2EEアプリケーションの強制停止またはメソッドキャンセルコマンド（cjstopthread）を実行してキャンセルする場合に出力されるログ情報を次の図に示します。どのメッセージが出力された場合も，処理は続行されます。

なお，スレッドダンプはメソッドキャンセルが失敗した場合に1回だけ出力されます。また，メソッドキャンセルコマンドの実行に失敗した場合は，メッセージKDJE52713-Eが出力されます。

図D-3　コマンドによってメソッドキャンセルを実行した場合に出力されるログ情報

(4)　注意事項

J2EEサーバでのスレッドダンプファイル数の上限チェック後，スレッドダンプ出力要求とJavaVMでのスレッドダンプ出力処理は非同期に実行されるため，タイムラグが発生することがあります。このため，スレッドダンプファイルが上限値を超えて出力されることがあります。

スレッドダンプの出力数の上限値は，「設定したスレッドダンプの上限値+9」になります。

また，JavaVMのスレッドダンプ出力処理では，同時に複数の出力要求があった場合，スレッドダンプを出力できないことがあります。この場合には，スレッドダンプの数が，実際に出力しようとした数よりも少なくなります。

付録E　障害発生時のCMR用の表の回復

ここでは，CMRを含むアプリケーションをデプロイしたあとJ2EEサーバで障害が発生した場合に，障害発生前に使用していたCMR用の表を回復させる手順について説明します。なお，CMR用の表の詳細については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

CMRを含むアプリケーションがデプロイされ，運用していた状態で保守などのためにJ2EEサーバを停止，起動したときに障害が発生すると，CMRを含むアプリケーションがデプロイされた状態で立ち上がらないことが考えられます。障害を解決し，再度CMRを含むアプリケーションをデプロイしようとしても，作成する表と同名の表がデータベース上にある場合，デプロイができません（アプリケーション間で表の共有を避けるため）。

ここで，SQL生成を再度実行すると，新しいCMR用の表名を使用したSQLが生成され，新しいCMR用の表を使用するようにデプロイができます。しかし，J2EEサーバを停止する以前に使用していた関係を使用したい場合，データベースに残っている表を使うようにデプロイする必要があります。

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にejbserver.ejb.cmp20.cmr.use.existing_tableパラメタで指定します。ejbserver.ejb.cmp20.cmr.use.existing_tableは，アプリケーションの起動障害発生時，それまで使用していた関係の情報を回復させるためのオプションです。trueを指定すると，データベース既存の表を使用するようにデプロイができます。このオプションを使用して，既存の表を使用する場合の手順を次に示します。

障害発生前に使用していたCMR用の表がデータベース上に残っていることを，SQLを使用して確認してください。

J2EEサーバを停止します（アプリケーションがデプロイ状態で立ち上がることに失敗した原因の対処をしてください）。

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にejbserver.ejb.cmp20.cmr.use.existing_tableパラメタで次のように指定します。

<param-name>タグ

ejbserver.ejb.cmp20.cmr.use.existing_table

<param-value>タグ

true

J2EEサーバを起動します。

デプロイ状態での開始に失敗したCMRを含むアプリケーションを再度デプロイします。

注意

ここでSQL生成を再実行しないでください。再実行すると新しい表名でSQLが生成され，以前の表が使用できなくなります。

J2EEサーバを停止します。

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にejbserver.ejb.cmp20.cmr.use.existing_tableパラメタでfalseを指定するか，またはこのオプションを設定しない状態に戻します。

再度J2EEサーバを起動します。

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

ベーシックモードの場合，プロセスの依存関係とプロセスの再起動方法がJ2EEサーバモードの場合と異なります。プロセスの依存関係とプロセスの再起動方法を次に示します。

＜この節の構成＞

付録F.1　ベーシックモードの場合のプロセスの依存関係

付録F.2　ベーシックモードの場合のプロセスの再起動方法

付録F.1　ベーシックモードの場合のプロセスの依存関係

ベーシックモードの場合のプロセスの依存関係を次の表に示します。

表F-1　ベーシックモードの場合のプロセスの依存関係

プロセスの種類
前提プロセス

パフォーマンストレーサ
－

スマートエージェント※1
－

CTMドメインマネジャ※1
スマートエージェント

CORBAネーミングサービス
－

CTMデーモン※1

パフォーマンストレーサ

スマートエージェント

CTMドメインマネジャ

ネーミングサービス

SFOサーバ

パフォーマンストレーサ

J2EEサーバ

パフォーマンストレーサ

スマートエージェント※2

CTMドメインマネジャ※2

CORBAネーミングサービス

CTMデーモン※2

Webサーバ
－

（凡例）

－：前提プロセスがない。

注※1

CTMを使用する場合に起動するプロセスです。

注※2

CTMを使用する場合に前提となるプロセスです。

付録F.2　ベーシックモードの場合のプロセスの再起動方法

ベーシックモードの場合のシステムでプロセスが異常終了時のプロセスの再起動方法について説明します。

なお，CTMに関連するプロセスが異常終了して再起動できない場合は，次の手順で対処してください。

ベーシックモードの場合のプロセスの再起動（回復）の手順を次に示します。

表F-2　ベーシックモードの場合の再起動の手順

異常プロセス
開始コマンド
再起動（回復）手順

データベースサーバ
－
DBサーバを再起動してください。

パフォーマンストレーサ
cprfstart
パフォーマンストレーサを再起動してください。

スマートエージェント※1
osagent
スマートエージェントを再起動してください。

CTMドメインマネジャ※1
ctmdmstart
CTMドメインマネジャを再起動してください。

CORBAネーミングサービス
nameserv
次に示す手順で対処してください。なお，CTMを使用しない場合，手順1および手順4は不要です。

CTMデーモンの強制停止

J2EEサーバの強制停止

CORBAネーミングサービスの再起動

CTMデーモンの再起動

J2EEサーバ再起動

CTMデーモン※1
ctmstart
次に示す手順で対処してください。

CORBAネーミングサービスの強制停止

J2EEサーバの強制停止

CORBAネーミングサービスの再起動

CTMデーモンの再起動

J2EEサーバの再起動

CTMレギュレータ
－
CTMデーモンによって自動再起動されるため，再起動は不要です。

SFOサーバ※2
cjstartsv
SFOサーバを再起動してください。

J2EEサーバ
cjstartsv
J2EEサーバを再起動してください。

Webサーバ
－
Webサーバを再起動してください。

（凡例）

－：使用する製品によって開始コマンドが異なる，または該当する開始コマンドがない。

注※1

CTMを使用する場合に起動するプロセスです。

注※2

セッションフェイルオーバ機能を使用する場合に起動するプロセスです。

付録G　サーブレットエンジンモードでのシステム運用

ここでは，サーブレットエンジンモードを使用してシステムを運用する場合の方法について説明します。

＜この節の構成＞

付録G.1　Component Container管理者による運用に関する留意事項

付録G.2　システムの起動

付録G.3　システムの停止

付録G.4　システムの処理性能の解析

付録G.5　トラブルシューティング

付録G.6　資料の調査

付録G.7　トラブルへの対処と回復

付録G.8　トラブルシューティングに関連する留意事項

付録G.9　資料の取得方法

付録G.1　Component Container管理者による運用に関する留意事項

UNIXでComponent Container管理者を設定している場合の留意事項について説明します。Component Container管理者とは，UNIXを使用している場合に，Webコンテナサーバの構築・運用に関する操作を実行できる権限を持つユーザです。Component Container管理者を設定することで，root権限を持たないユーザでも， Webコンテナサーバの起動・停止やサーバ管理コマンドの実行など，システム運用時の操作を実行できるようになります。

注意

Component Container管理者を設定している場合，Component Container管理者が実行できる操作は，一部の操作を除き，スーパーユーザでは操作できなくなるので注意してください。詳細については，マニュアル「Cosminexus　機能解説」の，J2EEサーバの運用とシステムの運用管理者に関する説明を参照してください。

なお，Component Container管理者の設定については，マニュアル「Cosminexus　システム構築ガイド」のComponent Container管理者の設定に関する説明を参照してください。

また，Component Container管理者を設定している場合にパーミッションが変更されるディレクトリについては，「1.8.1（2）　Component Container管理者を設定している場合にパーミッションが変更されるディレクトリ」を参照してください。

Component Container管理者が実施できるシステム運用時の操作について説明します。

＜この項の構成＞

(1)　Component Container管理者が実施できるシステム運用時の操作

(1)　Component Container管理者が実施できるシステム運用時の操作

Component Container管理者を設定した場合に，スーパーユーザおよびComponent Container管理者が実施できるシステム運用時の操作を次の表に示します。

表G-1　Component Container管理者が実施できるシステム運用時の操作

操作
スーパーユーザ
Component Container管理者

Webコンテナサーバの起動／停止
（cjstartwebコマンド， cjstopwebコマンド）
×
○

サーバ管理コマンドの実行
○
○

スレッドダンプの取得（cjdumpwebコマンド）
○
○

OS状態情報の取得（cjgetsysinfoコマンド）
○
○

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

なお，Component Container管理者を設定しない場合は，スーパーユーザが運用管理者となるため，Component Container管理者の操作もスーパーユーザが実施します。

付録G.2　システムの起動

ここでは，サーブレットエンジンモードでのシステムの起動の手順について説明します。

なお，データベース，LDAPディレクトリサーバなどの関連製品は起動済みであることを前提に説明します。データベース，LDAPディレクトリサーバなどを使用している場合は，必要に応じてあらかじめ起動しておいてください。システムの起動手順を次に示します。

PRFデーモンを起動します。
cprfstartコマンドでPRFデーモンを起動します。起動方法については，「（1）　PRFデーモンの起動」を参照してください。

Webコンテナサーバを起動します。
cjstartwebコマンドでWebコンテナサーバを起動します。起動方法については，「（2）　Webコンテナサーバの起動」を参照してください。

Webサーバを起動します。
起動方法については，ご使用のWebサーバのマニュアルを参照してください。

Webアプリケーションの動作を確認します。
システムが起動できたら，Webアプリケーションが正常に動作することを確認してください。

＜この項の構成＞

(1)　PRFデーモンの起動

(2)　Webコンテナサーバの起動

(1)　PRFデーモンの起動

PRFデーモンの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

Windowsの場合

cd "<Cosminexusのインストールディレクトリ>¥PRF¥bin"

UNIXの場合

# cd /opt/Cosminexus/PRF/bin

cprfstartコマンドでPRFデーモンを起動します。

Windowsの場合

cprfstart

UNIXの場合

# cprfstart

なお，cprfstartコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(2)　Webコンテナサーバの起動

Webコンテナサーバの起動方法について説明します。

Webコンテナサーバを起動するには，次に示すコマンドを実行します。

Windowsの場合

"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjstartweb サーバ名称"

なお，Windowsの場合，コマンドの実行には，Administrator権限が必要です。

UNIXの場合

"/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>"

なお，UNIXの場合，コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

同一ホストで複数のWebコンテナを同時に起動する場合のポート番号については，Webコンテナサーバのセットアップで設定します。Webコンテナサーバのセットアップについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

なお，SecurityManagerによるWebコンテナの保護をするには，-securityオプションを追加してください。

cjstartwebコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

付録G.3　システムの停止

ここでは，サーブレットエンジンモードのシステムの停止手順について説明します。

なお，データベース，LDAPディレクトリサーバなどを使用している場合は，必要に応じて停止してください。システムの停止手順を次に示します。

Webサーバを停止します。
停止方法については，ご使用のWebサーバのマニュアルを参照してください。

Webコンテナサーバを停止します。
cjstopwebコマンドでWebコンテナサーバを停止します。停止方法については，「（1）　Webコンテナサーバの停止」を参照してください。

PRFデーモンを停止します。
cprfstopコマンドでPRFデーモンを停止します。停止方法については，「（2）　PRFデーモンの停止」を参照してください。

＜この項の構成＞

(1)　Webコンテナサーバの停止

(2)　PRFデーモンの停止

(1)　Webコンテナサーバの停止

Webコンテナサーバの停止方法について説明します。

Webコンテナサーバを停止するには，次に示すコマンドを実行します。

Windowsの場合

"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjstopweb サーバ名称"

なお，Windowsの場合，コマンドの実行には，Administrator権限が必要です。

UNIXの場合

"/opt/Cosminexus/CC/web/bin/cjstopweb <サーバ名称>"

なお，UNIXの場合，コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

Webコンテナサーバを停止しても，Webコンテナサーバの停止処理が完了しない場合があります。この場合，Webコンテナサーバを強制的に停止する必要があります。Webコンテナサーバを強制停止する場合，cjstopwebコマンドに-fオプションまたは-fdオプションを指定して実行します。-fdオプションを指定すると，Webコンテナサーバの障害情報を取得したあと，Webコンテナサーバを強制停止します。

なお，cjstopwebコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(2)　PRFデーモンの停止

PRFデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

Windowsの場合

cd "<Cosminexusのインストールディレクトリ>¥PRF¥bin"

UNIXの場合

# cd /opt/Cosminexus/PRF/bin

cprfstopコマンドでPRFデーモンを停止します。
cprfstartコマンドを実行したユーザが実行してください

Windowsの場合

cprfstop

UNIXの場合

# cprfstop

PRFデーモンを停止しても，PRFデーモンの停止処理が完了しない場合があります。この場合，PRFデーモンを強制的に停止する必要があります。PRFデーモンを強制停止する場合，cprfstopコマンドに-Forceオプションを指定して実行します。

なお，cprfstopコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

付録G.4　システムの処理性能の解析

ここでは，サーブレットエンジンモードで動作するシステムでの処理性能の解析方法について説明します。

Cosminexusで構築したシステムの処理性能は，クライアントからデータベースなどのEISまで，およびその処理結果がクライアントに返却されるまでのリクエストの一連の処理で，リダイレクタやWebコンテナなどから出力されるトレース情報を基に解析できます。トレース情報を出力するリダイレクタやWebコンテナなどを，機能レイヤといいます。サーブレットエンジンモードで動作するシステムでのリクエストの処理過程では，次に示す機能レイヤからトレース情報が出力されます。

リダイレクタ

Webコンテナ

各機能レイヤでは決まった処理のポイント（トレース取得ポイント）でトレース情報を出力します。各機能レイヤが出力するトレース情報は，パフォーマンストレーサ（Cosminexus Performance Tracer）のPRFデーモンによって，トレースファイル（PRFトレースファイル）に出力されます。PRFデーモンにはトレース取得レベル（標準または詳細）を設定できます。PRFデーモンに設定するトレース取得レベルをPRFトレース取得レベルといいます。各機能レイヤのトレース取得ポイントおよびPRFトレース取得レベルの詳細については，「付録A　トレース取得ポイントとPRFトレース取得レベル」を参照してください。

なお，各機能レイヤのトレース情報はバイナリ形式でPRFトレースファイルに出力されます。システムの処理性能を解析する際は，PRFトレースファイルをテキスト形式（CSV形式）に変換したファイル（性能解析トレースファイル）を使用します。

サーブレットエンジンモードの場合，システムの処理性能を解析する作業は，パフォーマンストレーサのコマンドで実行します。

システムの処理性能を解析する場合に実施する作業を次に示します。詳細については，参照先の説明を参照してください。

表G-2　システムの処理性能を解析する場合に実施する作業（サーブレットエンジンモードの場合）

作業の目的
作業の概要
パフォーマンストレーサのコマンド
参照先

性能解析トレースファイルを収集する
PRFトレースファイルを出力して，CSV形式に変換します。
cprfflush
cprfed
－

収集した性能解析トレースファイルを利用してシステムの処理性能を解析する
Webサーバのレスポンスタイムを解析します。
－※
3.3.1

アプリケーションサーバ内でのリクエストの処理状況を調査します。
－※
3.3.2

セッションのライフサイクルを調査します。
－※
3.3.3

タイムアウトしたトランザクションを特定します。
－※
3.3.4

タイムアウトしたリクエストを特定します。
－※
3.3.5

ルートアプリケーション情報を利用してログを調査します。
－※
3.3.6

データベースとの接続中にトラブルが発生したコネクションを特定します。
－※
3.3.7

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

注※　cprfedコマンドを使用して出力された性能解析トレースファイルを使用します。

各コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

付録G.5　トラブルシューティング

ここでは，サーブレットエンジンモードでシステムを運用している場合に発生したトラブルに対処する方法について説明します。

＜この項の構成＞

(1)　対処の手順（サーブレットエンジンモードの場合）

(2)　取得が必要な資料の種類

(3)　資料の取得

(1)　対処の手順（サーブレットエンジンモードの場合）

ここでは，Cosminexusのシステムの運用中にトラブルが発生した場合の，対処の手順について説明します。

なお，トラブル発生時に取得する情報のうち，次に示す情報を取得するためには，運用開始前の準備が必要です。

日立JavaVM固有ログ
このファイルには，JavaVMのガーベージコレクションのログも出力されます。

ユーザダンプ（Windowsの場合）

coreダンプ（UNIXの場合）

OSの統計情報（Windowsの場合）

これらの情報については，必要に応じてシステム構築時に取得準備をしてください。トラブルシューティングの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

システムの運用中にトラブルが発生した場合，次の図に示す手順で対処します。

図G-1　トラブル発生時の対処の流れ

資料取得
トラブルシューティングに必要な資料をすべて取得します。
取得が必要な資料については，「（2）　取得が必要な資料の種類」を参照してください。なお，メモリダンプは，Webコンテナサーバを再起動する場合にだけ必要な資料です。
また，資料の取得方法については，「（3）　資料の取得」を参照してください。

トラブル原因の判別（一次判別）
トラブルの原因を判別します。判別には，取得した資料を使用します。資料の調査方法については，「付録G.6　資料の調査」を参照してください。

トラブルへの対処と回復
トラブルに対処して，回復します。
なお，トラブルの種類ごとの対処方法については，「付録G.7　トラブルへの対処と回復」を参照してください。

トラブル原因の解析（二次解析）
必要に応じてトラブル原因をさらに分析します。なお，この解析作業は保守員が実施します。

(2)　取得が必要な資料の種類

ここでは，トラブル発生時に取得が必要な資料の種類を示します。

トラブル発生時に取得が必要な資料の種類については，「5.2　取得が必要な資料の種類」を参照してください。

ただし，サーブレットエンジンモードの場合，snapshotログの取得方法と，デフォルトの設定でsnapshotログとして取得できる情報の種類が異なります。

また，資料を個別で取得するとき，次の資料の取得内容または取得方法が，運用管理ポータルを使用して構築したシステムの場合と異なります。

Cosminexusのログ

性能解析トレース

(3)　資料の取得

ここでは，トラブル発生時の資料の取得方法について説明します。

トラブルシュートに必要な資料は，次のどちらかの方法で取得できます。

snapshotlogコマンドを利用して一括取得する

それぞれの情報を個別に収集する

snapshotログはsnapshotlogコマンドを実行して収集します。snapshotlogコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

それぞれの情報を個別に収集する場合，次の資料を取得します。

Cosminexusのログ

Cosminexus Component Containerのログ

Cosminexus Performance Tracerのログ

Cosminexus DABroker Libraryのログ

Webアプリケーションのログ

性能解析トレース

JavaVMのスレッドダンプ

JavaVMのガーベージコレクションログ

メモリダンプ

Cosminexusの定義情報

Cosminexusの作業ディレクトリの内容

Webサーバログ

そのほかの情報

それぞれの情報の取得方法については「付録G.9　資料の取得方法」を参照してください。

付録G.6　資料の調査

ここでは，トラブルシューティングで，取得した資料を調査して，トラブルの原因を判別する方法について説明します。

トラブルシューティングに必要な資料の調査方法は，J2EEサーバモードの場合と同様です。

資料の調査方法については，「5.5　資料の調査」を参照してください。

付録G.7　トラブルへの対処と回復

ここでは，発生したトラブルの内容に応じた対処方法および回復方法について説明します。

ここでは，次のようなトラブルが発生した場合の対処について説明します。

構成ソフトウェアのプロセスが異常終了した場合

データベースと接続中にトラブルが発生した場合

JavaVMが異常終了した場合

＜この項の構成＞

(1)　構成ソフトウェアのプロセスが異常終了した場合（サーブレットエンジンモードの場合）

(2)　データベースと接続中にトラブルが発生した場合（サーブレットエンジンモードの場合）

(3)　JavaVMが異常終了した場合（サーブレットエンジンモードの場合）

(1)　構成ソフトウェアのプロセスが異常終了した場合（サーブレットエンジンモードの場合）

システムの運用中に構成ソフトウェアが異常終了して再起動を実行する場合，異常終了した構成ソフトウェアの起動順序に依存関係があるときは，前提となる構成ソフトウェアが起動していることを確認してから再起動する必要があります。前提となる構成ソフトウェアは，システムの運用形態によって異なります。以降で，構成ソフトウェアの起動順序の依存関係，および構成ソフトウェアの再起動方法について説明します。

(a)　構成ソフトウェアの起動順序の依存関係

Cosminexusで構築したシステムを構成する構成ソフトウェアの起動順序の依存関係について説明します。

サーブレットエンジンモードの場合のプロセスの依存関係を次に示します。

表G-3　サーブレットエンジンモードの場合のプロセスの依存関係

プロセスの種類 | 前提プロセス
PRFデーモン | －
Webコンテナサーバ | PRFデーモン
Webサーバ | －

（凡例）

－：前提プロセスがない。

(b)　プロセスの再起動方法

システムでプロセスが異常終了した場合のプロセスの再起動方法について説明します。

サーブレットエンジンモードの場合のプロセスの再起動（回復）の手順は次のとおりです。

表G-4　サーブレットエンジンモードの場合の再起動の手順

異常プロセス | 開始コマンド | 再起動（回復）手順
データベースサーバ | － | DBサーバを再起動してください。
PRFデーモン | cprfstart | パフォーマンストレーサを再起動してください。
Webコンテナサーバ | cjstartweb | Webコンテナサーバを再起動してください。
Webサーバ | － | Webサーバを再起動してください。

（凡例）

－：使用する製品によって開始コマンドが異なる，または該当する開始コマンドがない。

(2)　データベースと接続中にトラブルが発生した場合（サーブレットエンジンモードの場合）

データベースとの接続中に，Cosminexusの構成ソフトウェアであるCosminexus DABroker Libraryでトラブルが発生した場合，Cosminexus DABroker Libraryによってデータベースとの接続は切り離されます。また，Cosminexus DABroker Libraryを強制終了した場合も同様です。

これらのトラブルへの対処方法は，J2EEサーバモードの場合と同様です。対処方法については，「5.6.4　データベースと接続中にトラブルが発生した場合」を参照してください。

(3)　JavaVMが異常終了した場合（サーブレットエンジンモードの場合）

JavaVMでは，次のようなトラブルが発生する場合があります。

Cヒープ不足

内部論理エラー

OutOfMemoryError

これらのトラブルへの対処方法は，J2EEサーバモードの場合と同様です。対処方法については，「5.6.5　JavaVMが異常終了した場合」を参照してください。

付録G.8　トラブルシューティングに関連する留意事項

トラブルシューティングに関連する留意事項は，J2EEサーバモードの場合と同様です。留意事項については，「5.7　トラブルシューティングに関連する留意事項」を参照してください。

付録G.9　資料の取得方法

＜この項の構成＞

(1)　Cosminexus Component Containerのログ

(2)　性能解析トレースの取得（サーブレットエンジンモードの場合）

(3)　JavaVMのスレッドダンプの取得（サーブレットエンジンモードの場合）

(4)　JavaVMのガーベージコレクションログの取得（サーブレットエンジンモードの場合）

(5)　メモリダンプの取得（Webコンテナサーバを再起動する場合）

(6)　Cosminexusの定義情報の取得（サーブレットエンジンモードの場合）

(7)　Cosminexusの作業ディレクトリの内容の取得（サーブレットエンジンモードの場合）

(8)　Webサーバログの取得

(9)　そのほかの情報の取得（サーブレットエンジンモードの場合）

(1)　Cosminexus Component Containerのログ

Cosminexus Component Containerのログとして取得する資料の出力先を次に示します。それぞれの資料の詳細については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」または「5.4.2　Cosminexusのログの取得（バッチアプリケーションを実行するシステム）」を参照してください。

表G-5　Webコンテナサーバおよびリダイレクタのログの出力先（デフォルト）

分類
内容
ログ出力先およびログファイル名※1
デフォルトのサイズ×面数
チャネル名

メッセージログ
稼働ログ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjweb_message[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjweb_message[n].log

1MB×2
WebMessageLogFile

リダイレクタのメッセージログ
ディレクトリ※2

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

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs

4MB×5
－

ファイル名

Windowsの場合
isapi_redirect[n].log（Microsoft IIS）
hws_redirect[n].log（Hitachi Web Server）

UNIXの場合
hws_redirect[n].log（Hitachi Web Server）

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥web_servlet[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/web_servlet[n].log

4MB×4
WebServletLogFile

ユーザ出力ログ※4

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥user_out[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/user_out[n].log

1MB×2
UserOutLogFile

ユーザエラーログ※4

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥user_err[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/user_err[n].log

1MB×2
UserErrLogFile

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥javalog[nn].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/javalog[nn].log

256KB×4
－

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjweb_exception[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjweb_exception[n].log

12MB×4
WebExceptionLogFile

保守用ログ
保守情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjweb_maintenance[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjweb_maintenance[n].log

1MB×2
WebMaintenanceLogFile

Webコンテナの保守情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjwebcontainer[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjwebcontainer[n].log

1MB×2
WebContainerLogFile

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjstdout.log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjstdout.log

－
－

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjstderr.log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjstderr.log

－
－

終了プロセス情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjweb_shutdown[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjweb_shutdown[n].log

1MB×2
WebShutdownLogFile

Webコンテナ保守用トレースログ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥cjweb_access[n].log

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/cjweb_access[n].log

2MB×16
WebAccessLogFile

リダイレクタの保守用トレースログ
ディレクトリ※2

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

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs

16MB×2
－

ファイル名※2

Windowsの場合
hws_rd_trace[n].log（Hitachi Web Server）
isapi_rd_trace[n].log（Microsoft IIS）

UNIXの場合
hws_rd_trace[n].log

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

［n］：ログファイル名の［n］部分には，面の番号（1から面数（最大16）まで）が付きます。また，［nn］の部分には01～99の通し番号が付きます。

注※2

ディレクトリ，ファイル名は，isapi_redirect.conf（Microsoft IIS用リダイレクタ動作定義ファイル），またはmod_jk.conf（Hitachi Web Server用リダイレクタ動作定義ファイル）で設定できます。リダイレクタのログ取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。各ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注※3

サーブレット，JSPで発生した例外のスタックトレースについても出力されます。

注※4

標準出力にも出力されます。また，サーブレット，JSPでのSystem.out，およびSystem.errへの出力はユーザ出力ログ，およびユーザエラーログに出力されます。

注※5

起動プロセス情報だけを取得するログです。主にWebコンテナサーバの起動または終了時に出力されるため，オンライン中に出力されることはほとんどありません。ファイルのサイズが上限に達したときは，<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs下（Windowsの場合），または/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs下（UNIXの場合）のcjstdout_save.logまたはcjstderr_save.logに退避されます。すでにcjstdout_save.logまたはcjstderr_save.logがあったときは，上書きされます。

注意

WebサーバとしてMicrosoft IIS 6.0を使用している場合，リダイレクタのログファイルは，Webサーバへの初回アクセス時に，isapi_redirect.confで指定したファイルサイズで，指定した面数分，すべて作成されます。このとき，トレースファイルは空白(0x20)で初期化されます。デフォルトのファイルサイズと面数で運用している場合，ログの出力先に指定したディレクトリに，52メガバイトのディスク容量が必要になります。

なお，Webコンテナサーバおよびリダイレクタのログの出力先を変更している場合は，次の表に示す，ログの出力先を設定するユーザ定義ファイルを参照して出力先を確認してください。

表G-6　ログの出力先を設定するユーザ定義ファイル（サーブレットエンジンモードの場合）

分類
ユーザ定義ファイルの格納場所

Webコンテナサーバ
格納場所は，usrconf.cfgファイルのweb.server.log.directoryキーで指定します。キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥cosmi_m¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/web/containers/cosmi_m/logs」（UNIXの場合）です。

リダイレクタ（Windowsの場合）

Hitachi Web Serverの場合

［メッセージログ］

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥mod_jk.confのJkLogFileDirキー

キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs」です。

［保守用トレースログ］

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥mod_jk.confのJkTraceLogFileDirキー

キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs」です。

Microsoft IISの場合

［メッセージログ］

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥isapi_redirect.confのlog_file_dirキー

キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs」です。

［保守用トレースログ］

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥isapi_redirect.confのtrace_log_file_dirキー

キーのデフォルトは，「<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs」です。

リダイレクタ（UNIXの場合）

メッセージログ

/opt/Cosminexus/CC/web/redirector/mod_jk.confのJkLogFileDirキー

キーのデフォルトは，「/opt/Cosminexus/CC/web/redirector/logs」です。

保守用トレースログ

/opt/Cosminexus/CC/web/redirector/mod_jk.confのJkTraceLogFileDirキー

キーのデフォルトは，「/opt/Cosminexus/CC/web/redirector/logs」です。

ログの出力先の変更方法など，トラブルシューティングの資料取得の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(a)　Cosminexus Performance Tracerのログ

Cosminexus Performance Tracerのログの出力先を次に示します。

それぞれの資料の詳細については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」または「5.4.2　Cosminexusのログの取得（バッチアプリケーションを実行するシステム）」を参照してください。

表G-7　Cosminexus Performance Tracerのログの出力先

内容
出力先ディレクトリ

PRFデーモンおよびPRFコマンドのログ

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>¥log¥<PRF識別子>¥ctmlog[n]

UNIXの場合
$PRFSPOOL/log/<PRF識別子>/ctmlog[n]

モジュールトレース

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥umt

UNIXの場合
$PRFSPOOL/utt/umt

構造化例外発生ログ

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>¥oslttrc

UNIXの場合
$PRFSPOOL/oslttrc

注

[n]には「01」または「02」が表示されます。

(b)　Cosminexus DABroker Libraryのログ

それぞれの資料の詳細については，「5.4.1　Cosminexusのログの取得（J2EEアプリケーションを実行するシステム）」または「5.4.2　Cosminexusのログの取得（バッチアプリケーションを実行するシステム）」を参照してください。

Cosminexus DABroker Libraryでは，トラブルシューティングに使用するログとして，スプール情報を取得します。

次のディレクトリ下のすべてのファイルをコピーして保存してください。

Windowsの場合
<Cosminexus DABroker Libraryの運用ディレクトリ>¥spool

UNIXの場合
<Cosminexus DABroker Libraryの運用ディレクトリ>/spool

参考

Cosminexus DABroker Libraryでは，スプール情報のほかに次のJDBCドライバのトレースも取得できます。

JDBCインタフェースメソッドトレース

Cosminexus DABroker Libraryとのイベントトレース

ただし，JDBCドライバで次のトレースを取得するためには，アプリケーション開発時にあらかじめ指定されている必要があります。トレースを取得するための情報の設定については，マニュアル「Cosminexus　機能解説」のCosminexus DABroker Library を使用したデータベース接続の実装に関する説明を参照してください。

(c)　Webアプリケーションのログ

Webアプリケーションのログは，日立トレース共通ライブラリ形式で出力するように設定している場合に取得できます。

Webアプリケーションのログの出力先については，usrconf.properties（Webコンテナサーバ用ユーザプロパティファイル）のejbserver.application.userlog.CJLogHandler.<ハンドラ名>.pathキーの値を参照してください。なお，<ハンドラ名>には，キーの値を区別するためのハンドラ名が指定されています。

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

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

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.properties

なお，Webアプリケーションのユーザログ出力の設定については，マニュアル「Cosminexus　システム構築ガイド」のサーブレットエンジンモードの利用に関する説明を参照してください。

(2)　性能解析トレースの取得（サーブレットエンジンモードの場合）

性能解析トレースの収集方法については，「3.　システムの処理性能の解析」を参照してください。セッショントレースも同様に取得できます。

性能解析トレースの格納場所は次のとおりです。

Windowsの場合
<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥prf¥<PRF識別子>

UNIXの場合
$PRFSPOOL/utt/prf/<PRF識別子>

(3)　JavaVMのスレッドダンプの取得（サーブレットエンジンモードの場合）

ここでは，JavaVMのスレッドダンプを取得する方法について説明します。

なお，Webコンテナサーバの起動オプションとして-XX:+HitachiThreadDumpが設定されている場合，拡張スレッドダンプを取得できます。-XX:+HitachiThreadDumpToStdoutが設定されている場合，スレッドダンプは標準出力にも出力されます。

また，-XX:+HitachiOutOfMemoryAbortが設定されている場合に，-XX:+HitachiOutOfMemoryAbortThreadDumpが設定されていると，OutOfMemoryErrorによって強制終了した時に，スレッドダンプが出力されます。ただし，次の場合は除きます。

J2SEクラスライブラリ内でCヒープ不足が発生した場合

JavaVMの処理中にCヒープ不足が発生した場合

cjstartwebプロセスが存在する場合のスレッドダンプの取得方法を次に示します。

Windowsの場合
cjstartwebプロセスが存在する場合，次を実行します（3秒おきに10回程度）。

<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjdumpweb <Webコンテナサーバ名>

UNIXの場合
cjstartwebプロセスが存在する場合，cjdumpwebコマンドまたはkillコマンドを使用してWebコンテナサーバのスレッドダンプを取得します（3秒おきに10回程度）。

cjdumpwebコマンドを使用する場合

/opt/Cosminexus/CC/web/bin/cjdumpweb <Webコンテナサーバ名>

killコマンドを使用する場合

ps -ef | grep cjstartweb
kill -3 <WebコンテナサーバのプロセスID>

スレッドダンプは，「/opt/Cosminexus/CC/web/containers/<サーバ名称>/javacore*.txt」，およびサーバ標準出力ログ（cjstdout.log）に出力されます。

また，javacore<プロセス番号>.<コマンド実行日時>.txtファイルの出力先は，環境変数JAVACOREDIRで変更できます。ただし，指定したディレクトリへの書き込みに失敗した場合は，カレントディレクトリに出力されます。このディレクトリにも出力できなかった場合は，標準エラー出力にだけ出力されます。

cjdumpwebコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

参考

スレッドダンプが出力されると，標準出力に，次のメッセージが出力されます。そのあと，javaプログラムの実行が継続されます。このメッセージは，-XX:+HitachiThreadDumpToStdoutの設定とは関係なく出力されます。

Writing Java core to <ファイル名（フルパス）>...OK

(4)　JavaVMのガーベージコレクションログの取得（サーブレットエンジンモードの場合）

JavaVMのガーベージコレクションログは，JavaVMまたはWebコンテナサーバ起動前にログ出力先が設定されている場合にだけ取得できます。

ユーザ定義ファイルを使用して設定している場合は，usrconf.cfgファイルのweb.server.log.directoryのキーを確認してください。

また，実行中のJavaプロセスでガーベージコレクションを発生させたい場合は，javagcコマンドを実行してください。javagcコマンドは，トラブル発生時の要因調査のほか，1トランザクション当たりのメモリ使用量の測定，メモリリークの調査，アプリケーションのデバッグなどの目的でも使用できます。

実行中のJavaプロセスを指定してガーベージコレクションを発生させる場合，javagcコマンドは，次の形式で実行します。なお，これ以外に指定できるオプションについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

javagc -p プロセスID

実行結果として，次のログが出力されます。なお，これは，オプションとして，-XX:+HitachiVerboseGCPrintCauseが指定されている場合の例です。

Windowsの場合

[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]

UNIXの場合

[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:JavaGC Command]

javagcコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

なお，-XX:+HitachiVerboseGCPrintCauseオプションは，usrconf.cfgに指定します。オプションの設定方法については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(5)　メモリダンプの取得（Webコンテナサーバを再起動する場合）

メモリダンプの取得の取得方法についてOSごとに説明します。

(a)　Windowsの場合

Webコンテナサーバを再起動するときに，メモリダンプを取得します。メモリダンプは，システムでトラブルが発生したときに，保守員が障害解析するために使用します。

Webコンテナサーバが稼働している場合（cjstartwebプロセスが存在する場合），タスクマネージャからcjstartwebのプロセスIDを取得します。userdump.exe <プロセスID> を実行し，メモリダンプ（user.dump）を採取します。

(b)　UNIXの場合

Webコンテナサーバを再起動するときに，メモリダンプとして，Webコンテナサーバのcoreダンプを取得します。メモリダンプは，システムでトラブルが発生したときに，保守員が障害解析するために使用します。

cjstartwebプロセスがダウンした場合，「/opt/Cosminexus/CC/web/containers/cosmi_m/core*」に出力されたcoreダンプを取得します。

coreダンプのファイル名は，cjstartwebプロセスの再起動時に「core.<出力日時※>」（AIX，HP-UX，Solarisの場合）または「core.<プロセスID>.<出力日時※>」（Linuxの場合）にリネームされます。cjstartwebプロセスの再起動時にcoreダンプが上書き保存されないため，障害発生時のcoreダンプを保存できます。

注※

出力日時は「YYMMDDhhmmss」の形式で出力されます。

YY：西暦（下2けた）　MM：月（2けた）　DD：日（2けた）

hh：時（2けた[24時間表記]）　mm：分（2けた）　ss：秒（2けた）

なお，保存するcoreダンプは上限値を設定できます。cjstartwebプロセスの再起動時に「/opt/Cosminexus/CC/web/containers/<サーバ名称>/」に出力されるcoreダンプファイルの合計が上限値を超えた場合，出力日時が古い順に削除されます。上限値は，usrconf.cfgのweb.server.corefilenumキーに指定します。なお，ファイルの削除はcjstartwebプロセスの再起動時に実行されます。usrconf.cfgの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

coreダンプを取得したあとに，coreダンプからスタックトレース情報だけを取得する場合は，javatraceコマンドを実行してください。スタックトレース情報は，JavaVMの異常終了の原因を究明するために必要な情報です。スタックトレース情報の取得方法は，J2EEサーバモードの場合と同様です。「5.4.16　JavaVMのスタックトレース情報の取得」を参照してください。

coreダンプは次のような場合にも取得できます。それぞれの場合の取得方法について説明します。

cjstartwebプロセスが稼働している状態でcoreダンプを取得する場合

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合

cjstartwebプロセスが稼働している状態でcoreダンプを取得する場合

cjstartwebプロセス（Webコンテナサーバ）が稼働している状態でcoreダンプを取得する場合，cjstartwebプロセスのプロセスIDを確認して，killコマンドを実行します。killコマンドは次の形式で実行してください。なお，killコマンドを実行するとプロセスが終了するため，再起動する前にkillコマンドを実行することを推奨します。

kill -6 <cjstartwebプロセスID>

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する方法は，J2EEサーバモードの場合と同様です。「5.4.7(2)　J2EEサーバのメモリダンプの取得」を参照してください。

(6)　Cosminexusの定義情報の取得（サーブレットエンジンモードの場合）

Cosminexusの定義を取得します。この情報を使用して，発生した障害によって定義の設定を確認します。

Webコンテナサーバに関する定義情報

次のディレクトリ下に格納されているファイル一式を取得します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf下すべて

UNIXの場合

/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf下すべて

Cosminexus DABroker Libraryに関する定義情報

次のファイルを取得します。

Windowsの場合

<Cosminexus DABroker Library運用ディレクトリ>¥conf¥dasys.conf（Cosminexus DABroker Library動作環境定義ファイル）

<Cosminexus DABroker Library運用ディレクトリ>¥conf¥dabenv（接続先データベース定義ファイル）

UNIXの場合

<Cosminexus DABroker Library運用ディレクトリ>/conf/dasys.conf（Cosminexus DABroker Library動作環境定義ファイル）

<Cosminexus DABroker Library運用ディレクトリ>/conf/dabenv（接続先データベース定義ファイル）

なお，トラブルシューティング用に保存するファイルからは，パスワードなどの公開できない情報を削除することをお勧めします。

(7)　Cosminexusの作業ディレクトリの内容の取得（サーブレットエンジンモードの場合）

システムでトラブルが発生した場合に，保守員による原因究明のため作業ディレクトリを調査に使用する場合があります。

環境変数「PRFSPOOL」の設定ディレクトリ下すべて※

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps下すべて（Windowsの場合）

/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps下すべて（UNIXの場合）

注※

環境変数「PRFSPOOL」未設定の場合は，「<Cosminexusのインストールディレクトリ>¥PRF¥spool下すべて」（Windowsの場合），または「/opt/Cosminexus/PRF/spool下すべて」（UNIXの場合）になります。

設定を確認の上，トラブルが発生した場合に保存しておいてください。

(8)　Webサーバログの取得

システムで使用しているWebサーバ（Hitachi Web ServerまたはMicrosoft IIS）のログを取得します。

Hitachi Web Serverを使用している場合，ログの格納場所は「<Cosminexusのインストールディレクトリ>¥httpsd¥logs」（Windowsの場合），「/opt/hitachi/httpsd/logs」（UNIXの場合）です。

Microsoft IISを使用している場合，ログの格納場所は「C:¥WINNT¥system32¥LogFiles¥W3SVC1」です（C:の部分にはシステムドライブを指定します）。

(9)　そのほかの情報の取得（サーブレットエンジンモードの場合）

そのほかの情報を取得するための方法は，すべてJ2EEサーバモードの場合と同様です。参照先を次に示します。

表G-8　取得する情報の種類と参照先

取得する情報 | 参照先
日立固有のJavaVMログ | 5.4.8
JavaVM出力メッセージログ（標準出力またはエラーリポートファイル） | 5.4.9
OSの状態情報とOSのログ | 5.4.10
OSの統計情報 | 5.4.11

付録H　代替手段で実行できる運用作業

ここでは，Cosminexusのシステムで実行できる運用作業を一覧で示します。実行できる運用作業には，システムで推奨する手段での作業，推奨外の作業および代替手段での作業を含みます。各運用作業の詳細やコマンドの使用方法については，参照先に示す個所，マニュアルを確認してください。

＜この節の構成＞

付録H.1　システムの起動と停止

付録H.2　システムの運用監視

付録H.3　システムの処理性能解析

付録H.4　統合ユーザ管理のリソースの監視

付録H.5　J2EEアプリケーションとリソースの管理

付録H.6　システムの監査

付録H.7　トラブルシューティング

付録H.1　システムの起動と停止

システムの起動と停止で実行できる運用作業とその手段について，次の表に示します。

表H-1　システムの起動と停止で実行できる運用作業とその手段

運用作業 | 手段 | 推奨 | 参照先
サービスユニットを一括起動する | cmx_start_targetコマンド | ◎ | 簡易構築
サービスユニットを一括停止する | cmx_stop_targetコマンド | ◎ | 簡易構築
論理サーバを個別に，または一括で起動する | 運用管理ポータル，運用管理コマンド（mngsvrutil） | ○ | 運用管理操作
論理サーバを個別に，または一括で停止する | 運用管理ポータル，運用管理コマンド（mngsvrutil） | ○ | 運用管理操作
コマンドでサーバを起動する | サーバ管理コマンド（cjstartsv） | ○ | リファレンス
コマンドでサーバを停止する | サーバ管理コマンド（cjstopsv） | ○ | リファレンス
クラスタソフトウェアを使用したシステムを起動する | Cosminexusのコマンド，クラスタソフトウェアの機能 | ◎ | 8章，9章
クラスタソフトウェアを使用したシステムを停止する | Cosminexusのコマンド，クラスタソフトウェアの機能 | ◎ | 8章，9章

（凡例）

◎：推奨する作業

○：推奨外の作業，または代替手段での作業

運用管理操作：マニュアル「Cosminexus　運用管理操作ガイド」

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

付録H.2　システムの運用監視

システムの運用監視で実行できる運用作業とその手段について，次の表に示します。

表H-2　システムの運用監視で実行できる運用作業とその手段

運用作業 | 手段 | 推奨 | 参照先
サービスユニットのステータスを確認する | cmx_list_statusコマンド | ○ | 簡易構築
論理サーバのステータスを確認する | 運用管理コマンド（mngsvrutil） | ◎ | 2.2
運用管理ポータル | ○ | 運用管理操作
Webシステム内のサービスユニットの構成を確認する | cmx_list_modelコマンド | ◎ | 簡易構築
稼働情報ファイルを参照して，J2EEサーバおよびSFOサーバの稼働情報を監視する | － | ◎ | 2.3
J2EEサーバおよびSFOサーバの稼働情報を監視する※1 | 運用管理コマンド（mngsvrutil） | ○ | 2.4
運用管理ポータル | ○ | 運用管理操作
リソースの使用率や使用数を監視して，しきい値を超えた場合に原因を調査する | － | ◎ | 2.5
稼働情報ファイルに出力される稼働情報，またはリソースの枯渇状況に応じてメッセージが出力された場合の処理を自動化する（Managementアクション） | － | ◎ | －
運用管理ドメイン内のCTMの稼働統計情報を確認する※2 | 運用管理コマンド（mngsvrutil） | ◎ | 2.6
CTMデーモン単位の稼働統計情報を確認する※2 | CTMのコマンド（ctmstsed） | ○ | リファレンス
CTMのスケジュールキューの滞留状況を監視する※2　※3 | CTMのコマンド（ctmstart） | ○ | リファレンス
トランザクションの状態を確認する | サーバ管理コマンド（cjlisttrn） | ◎ | 2.7

（凡例）

◎：推奨する作業

○：推奨外の作業，または代替手段での作業

－：該当しない

運用管理操作：マニュアル「Cosminexus　運用管理操作ガイド」

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

注※1　稼働情報ファイルを参照した稼働情報の監視で取得できる情報よりも詳細な情報を参照したい場合に，運用管理コマンドを使用した稼働情報の監視を行ってください。

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

注※3　Smart Composer機能を使用してCTMのスケジュールキューの滞留監視をする場合は，簡易構築定義ファイルで定義します。そのため，運用時の作業は必要ありません。

付録H.3　システムの処理性能解析

システムの処理性能解析で実行できる運用作業とその手段について，次の表に示します。

表H-3　システムの処理性能解析で実行できる運用作業とその手段

運用作業 | 手段 | 推奨 | 参照先
性能解析トレースファイルを収集する | 運用管理コマンド（mngsvrutil） | ◎ | 3.2
PRFのコマンド（cprfed） | ○ | リファレンス
収集した性能解析トレースファイルを利用してシステムの処理性能を解析する | － | ◎ | 3.3
PRFトレース取得レベルを確認する | 運用管理ポータル | ○ | 運用管理操作
PRFのコマンド（cprflevel） | ○ | リファレンス
PRFトレース取得レベルを変更する | 運用管理コマンド（mngsvrutil） | ○ | リファレンス
運用管理ポータル | ○ | 運用管理操作
PRFのコマンド（cprflevel） | ○ | リファレンス

（凡例）

◎：推奨する作業

○：推奨外の作業，または代替手段での作業

－：該当しない

運用管理操作：マニュアル「Cosminexus　運用管理操作ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

付録H.4　統合ユーザ管理のリソースの監視

統合ユーザ管理のリソースの監視で実行できる運用作業とその手段について，次の表に示します。

表H-4　統合ユーザ管理のリソースの監視で実行できる運用作業とその手段

運用作業 | 手段 | 推奨 | 参照先
統合ユーザ管理のリソースの使用状況を監視する | 運用管理ポータル | ○ | 運用管理操作

（凡例）

○：推奨外の作業，または代替手段での作業

運用管理操作：マニュアル「Cosminexus　運用管理操作ガイド」

付録H.5　J2EEアプリケーションとリソースの管理

J2EEアプリケーションとリソースの管理で実行できる運用作業とその手段について，次の表に示します。

表H-5　J2EEアプリケーションとリソースの管理で実行できる運用作業とその手段

運用作業 | 手段 | 推奨 | 参照先
Webアプリケーションの稼働状況を確認する | 運用管理コマンド（mngsvrutil） | ◎ | 4.2.1
運用管理ポータル | ○ | 運用管理操作
アクセス状況に応じて，Webアプリケーションの同時実行スレッド数を動的に変更する | 運用管理コマンド（mngsvrutil） | ◎ | 4.2.2
CTMのスケジュールキューの稼働状況を確認する※1 | 運用管理コマンド（mngsvrutil） | ◎ | 4.3.1
CTMのコマンド（ctmlsque） | ○ | 4.3.2
CTMのスケジュールキューの同時実行数を動的に変更する※1 | CTMのコマンド（ctmchpara） | ◎ | 4.3.2
J2EEアプリケーションの実行状態を確認する | サーバ管理コマンド（cjlistthread） | ◎ | 4.4.1
J2EEアプリケーションでタイムアウトが発生したリクエストをキャンセルする | サーバ管理コマンド（cjstopthread） | ◎ | 4.4.2
J2EEアプリケーションを通常開始する | サーバ管理コマンド（cjstartapp） | ◎ | リファレンス
運用管理コマンド（mngsvrutil） | ○ | リファレンス
Smart Composer機能のコマンド（cmx_stop_applicationコマンド） | ○ | 簡易構築
運用管理ポータル | ○ | 運用管理操作
J2EEアプリケーションを通常停止する | サーバ管理コマンド（cjstopapp） | ◎ | 4.5
運用管理コマンド（mngsvrutil） | ○ | リファレンス
Smart Composer機能のコマンド（cmx_stop_applicationコマンド） | ○ | 簡易構築
運用管理ポータル | ○ | 運用管理操作
J2EEアプリケーションを強制停止する | サーバ管理コマンド（cjstopapp） | ◎ | 4.5.5
運用管理コマンド（mngsvrutil） | ○ | リファレンス
負荷分散機を使用してサービスを閉塞する※2 | 負荷分散機の機能 | ○ | 4.5.3
Webサーバのサービスを閉塞する | 運用管理コマンド（mngsvrutil） | ○ | リファレンス
運用管理ポータル | ○ | 運用管理操作
Hitachi Web Serverの機能 | ○ | Hitachi Web Server
CTMを利用してサービスを閉塞する※1 | 運用管理コマンド（mngsvrutil） | ○ | 4.5.4
CTMのコマンド（ctmholdque） | ○ | リファレンス
J2EEサーバを停止してサービスを閉塞する | 運用管理コマンド（mngsvrutil） | ○ | リファレンス
運用管理ポータル | ○ | 運用管理操作
cjstopsvコマンド | ○ | リファレンス
J2EEアプリケーションの閉塞を解除する | サーバ管理コマンド（cjstartapp） | ○ | リファレンス
運用管理コマンド（mngsvrutil） | ○ | リファレンス
運用管理ポータル | ○ | 運用管理操作
J2EEアプリケーションを入れ替える | 通常の入れ替え | サーバ管理コマンド（cjstopapp，cjimportappなど） | ◎ | 4.6.1
運用管理ポータル | ○ | 運用管理操作
リデプロイによる入れ替え | サーバ管理コマンド（cjreplaceapp） | ◎ | 4.6.2
リロードによる入れ替え | サーバ管理コマンド（cjreloadapp） | ◎ | 4.6.3
JSPを事前にコンパイルしてから，J2EEアプリケーションを入れ替える | cjjspcコマンド | ◎ | 4.6.4
J2EEアプリケーションの名称を変更する | サーバ管理コマンド（cjrenameapp） | ◎ | 4.6.5
Server Plug-in | ○ | 運用管理操作
Webアプリケーションのサービス部分閉塞を利用してJ2EEアプリケーションを入れ替える | 運用管理ポータル | ○ | 運用管理操作
CTMを利用して，オンライン状態でJ2EEアプリケーションを入れ替える※1 | 運用管理コマンド（mngsvrutil） | ◎ | 4.6.6
J2EEアプリケーションを本番環境でテストしてから本番運用を開始する | サーバ管理コマンド（cjimportapp，cjstartapp） | ◎ | 4.6.7
コネクションプールの情報を表示する | サーバ管理コマンド（cjlistpool） | ◎ | 解説，リファレンス
コネクションプールをクリアする | サーバ管理コマンド（cjclearpool） | ◎ | 解説，リファレンス
JavaBeansリソースを入れ替える | サーバ管理コマンド（cjdeletejb，cjimportjb） | ◎ | 4.7
クラスタ構成のデータベースの場合に，コネクションプールの状態を表示する | サーバ管理コマンド（cjlistrar） | ◎ | 4.8.1
クラスタ構成のデータベースの場合に，コネクションプールを一時停止する | サーバ管理コマンド（cjsuspendpool） | ◎ | 4.8.2
クラスタ構成のデータベースの場合に，コネクションプールを再開する | サーバ管理コマンド（cjresumepool） | ◎ | 4.8.3
リソースの接続テストをする | サーバ管理コマンド（cjtestres） | ◎ | 解説，リファレンス

（凡例）

◎：推奨する作業

○：推奨外の作業，または代替手段での作業

Hitachi Web Server：マニュアル「Hitachi Web Server」

運用管理操作：マニュアル「Cosminexus　運用管理操作ガイド」

解説：マニュアル「Cosminexus　機能解説」

簡易構築：マニュアル「Cosminexus　簡易構築・運用ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

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

注※2　負荷分散機をSmart Composer機能で管理していない場合に実行します。負荷分散機をSmart Composer機能で管理している場合は，cmx_stop_targetコマンドを使用してサービスを閉塞してください。cmx_stop_targetコマンドの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

付録H.6　システムの監査

システムの監査で実行できる運用作業とその手段について，次の表に示します。

表H-6　システムの監査で実行できる運用作業とその手段

運用作業 | 手段 | 推奨 | 参照先
監査ログを出力して，管理する | － | ◎ | 6.2
監査ログを収集して調査する | － | ◎ | 6.2
データベース監査証跡に出力された情報を基に，データベースにアクセスしたリクエストの情報を特定する | － | ◎ | 7.2

（凡例）

◎：推奨する作業

－：該当しない

付録H.7　トラブルシューティング

トラブルシューティングで実行できる運用作業とその手段について，次の表に示します。

表H-7　トラブルシューティングで実行できる運用作業とその手段

運用作業 | 手段 | 推奨 | 参照先
トラブルシューティングに必要な資料を収集する | 運用管理コマンド（mngsvrutil） | ◎ | 5.3.1
運用管理ポータル | ○ | 運用管理操作
snapshotlogコマンド | ○ | リファレンス
論理サーバに異常が発生した場合の処理を自動化する | － | ◎ | 5.3.2
トラブルシューティングに必要な資料を調査する | － | ◎ | 5.5

（凡例）

◎：推奨する作業

○：推奨外の作業，または代替手段での作業

－：該当しない

運用管理操作：マニュアル「Cosminexus　運用管理操作ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

付録I　用語解説

Application Server，uCosminexus Client，Web Redirector，およびuCosminexus Operatorで使用する用語について説明します。

（数字）

1.4モード

サーバの動作モードです。J2EE 1.4の機能を使用できます。データベースを含む複数のリソースのトランザクション管理ができます。

1:1系切り替えシステム

実行系のアプリケーションサーバと待機系のアプリケーションサーバが1:1で対応しているシステムです。実行系のアプリケーションサーバに障害が発生すると，待機系のアプリケーションサーバで処理を引き継ぎます。

（英字）

Application Server

Cosminexusの実行環境を構築する基盤製品です。Application Server Standardと，Application Server Enterpriseの総称です。

BJEX

uCosminexus Batch Job Execution Serverのことです。

BMP（Bean-Managed Persistence）

Enterprise Beanのビジネスメソッド内でデータの永続化を管理するモデルです。

BMT（Bean-Managed Transaction）

Enterprise Beanでトランザクションを管理するモデルです。Session BeanおよびMessage-driven Beanが対象になります。Entity Beanは対象外です。

CMP（Container-Managed Persistence）

EJBコンテナがデータの永続化を管理するモデルです。

CMT（Container-Managed Transaction）

EJBコンテナがトランザクションを管理するモデルです。Session Bean，Entity BeanおよびMessage-driven Beanが対象になります。

Component Container管理者

スーパーユーザ以外の，J2EEサーバやバッチサーバのセットアップ，J2EEサーバやバッチサーバの起動・停止などを実施できるユーザを指します。Component Container管理者はUNIXの場合に設定できます。

Cookieスイッチング機能

負荷分散機で提供しているサーバスイッチング機能の一つです。Cookieスイッチング機能を使用すると，クライアントからのリクエストパケット内のCookie情報に基づいて，同じサーバにセッションをリダイレクトします。

CORBAネーミングサービス

CORBAの仕様に準拠した，リモートオブジェクトの格納場所を管理するためのネーミングサービスです。Application Serverの構成ソフトウェアであるCosminexus TPBrokerによって提供される機能です。

Cosminexus

アプリケーションサーバを中核とした，性能および信頼性の高いアプリケーションを実行および開発するためのシステム構築基盤製品です。

Cosminexus Component Container

サーバ・サイドの業務処理プログラム（ビジネスロジック）をコンポーネントとして実行するための構成ソフトウェアです。また，Cosminexusシステムの運用管理をするためのManagement Server，統合ユーザ管理，snapshotログ収集などの機能も提供しています。

Cosminexus Component Transaction Monitor

クライアントからのリクエストのスケジューリングを実現するための構成ソフトウェアです。

Cosminexus Operator Plug-in

実行環境を運用管理操作するための構成ソフトウェアです。Server Plug-inとHCSC-Managerを提供しています。HCSC-Managerとは，Cosminexusサービスプラットフォームの運用環境で利用する運用管理機能です。なお，HCSC-Managerについては，マニュアル「Cosminexus　サービスプラットフォーム　システム構築・運用ガイド」を参照してください。

Cosminexus Performance Tracer

リクエストが処理されるときに，決められたポイントごとに各機能が出力する性能解析情報をファイルに出力するための構成ソフトウェアです。

Cosminexus Reliable Messaging

Cosminexus システム上のJ2EEアプリケーションがメッセージを使用して非同期に通信するためのミドルウェアです。JMSインタフェースでのメッセージ通信機能をJ2EEアプリケーションに提供します。

Cosminexusシステム

Application Serverを実行基盤として構築されているシステムのことです。

Cosminexus標準ログインモジュール

統合ユーザ管理のユーザ認証処理で使用するログインモジュールです。javax.security.auth.spiに含まれるLoginModuleインタフェースの実装クラスです。

次のログインモジュールがあります。

WebPasswordLoginModule
パスワードを使用してユーザを認証します。

WebCertificateLoginModule
クライアント証明書を使用してユーザを認証します。

WebPasswordLDAPLoginModule
LDAPディレクトリサーバの認証機能を使用してユーザを認証します。

WebPasswordJDBCLoginModule
RDBに格納された情報を使用してユーザを認証します。

DelegationLoginModule
カスタムログインモジュールを呼び出します。

WebSSOLoginModule
シングルサインオンをするときに，ほかのログインモジュールを呼び出します。

CTM

Cosminexus Component Transaction Monitorのことです。リクエストのスケジューリングをするための構成ソフトウェアです。

CTMデーモン

クライアントからのリクエストを制御するスケジュールキューを管理するプロセスです。リクエストのスケジューリングを実現する，スケジューラとして機能します。

Management Serverを利用している場合，CTMデーモンは論理サーバとして扱えます。

CTMドメイン

複数のCTMデーモンで構成される，情報共有と負荷分散の対象になる範囲です。CTMデーモンはCTMドメイン内で，それぞれに登録された業務処理プログラムの情報やスケジュールキューの負荷情報を交換してリクエストを振り分けます。

CTMドメインマネジャ

CTMドメインを管理するプロセスです。ホスト内のCTMデーモンの情報を，CTMドメイン内のほかのCTMドメインマネジャに配布します。

Management Serverを利用している場合，CTMドメインマネジャは論理サーバとして扱えます。

CTMレギュレータ

EJBクライアントからCTMデーモンに集中するリクエストを，分散集約するためのプロセスです。TPBrokerクライアント（CORBAクライアント）からJ2EEサーバ内で動作しているEJBアプリケーションを直接呼び出しできるゲートウェイ機能も提供します。

DB Connector

データベースに接続するためのリソースアダプタです。

DD

アプリケーションを運用環境に配置するときの定義情報を記述したものです。EJB用，Webアプリケーション用，Enterpriseアプリケーション用などがSun Microsystems, Inc.からの仕様で規定されています。

Dependency Injection

EJBやインターセプタクラスのフィールドやsetterメソッドに，@EJBや@Resourceアノテーションを指定することで，EJBやリソースへの参照をEJBコンテナが自動的にセットする機能です。Dependency Injectionを使用すると，EJBやリソースへの参照をJNDIを使用してルックアップする必要がなくなります。

DIターゲット

Dependency Injection機能を使用して参照を注入する対象のことです。DIターゲット名と名前が一致するフィールド，またはDIターゲット名をプロパティとして持つsetterメソッドに対して，Dependency Injectionが実行されます。

DTD

XMLで使用するタグの属性や階層構造や出現順序などを定義したものです。

EARファイル

J2EEアプリケーションを構成する複数のEJB-JARファイル，WARファイル，およびDDをEARファイル形式でパッケージ化したものです。

EIS

データベースやトランザクションサーバなど，企業内に構築されているバックエンドシステムです。

EJB（Enterprise JavaBeans）

業務ロジックをプログラムとして記述したビジネスロジック，および永続的データを格納するオブジェクトであるエンティティをJavaコンポーネント化したものです。Sun Microsystems, Inc.からEJB仕様が公開されています。

EJB-JARファイル

Enterprise Bean，DDなどをJARファイル形式に圧縮したものです。

EJBクライアント

J2EEサーバ上で開始されているEnterprise Beanを呼び出すクライアントプログラムです。次の3種類があります。

EJBクライアントアプリケーション

サーブレットまたはJSPなどのWebアプリケーション

ほかのEnterprise Bean

EJBクライアントアプリケーション

Enterprise Beanを呼び出すJavaアプリケーションです。

EJBコンテナ

Enterprise Beanを制御すると同時に，通信，トランザクション管理などのシステムレベルのサービスを提供する実行環境です。Enterprise Beanの実体は，EJBコンテナの中で実行されます。

EJBタイマ

EJBコンテナのTimer Serviceの機能を利用して，タイムアウト時間を管理するタイマです。指定された時刻または間隔で，タイムアウトメソッドをコールバックし，イベントを実行します。

Enterprise Bean

ビジネスロジックをEJBアーキテクチャに従って作成したものです。業務処理プログラムに該当します。

Entity Bean

永続化されたデータそのものを表すBeanです。Entity Beanは，さらにCMP Entity BeanとBMP Entity Beanに分類されます。

HAモニタ

クラスタソフトウェアの一つです。

システムを監視し，障害発生時などにシステムの切り替えを実行するプログラムです。HAモニタと連携することで，Cosminexusシステムの信頼性や稼働率を向上できます。AIX，HP-UXまたはLinuxを使用しているときに連携できます。

HAモニタと連携することで，1：1系切り替えシステム，相互系切り替えシステム，N：1リカバリシステムが実現できます。

Inbound

Connector 1.5仕様で定められたJ2EEサーバとリソースアダプタ間の通信モデルの一つです。リソースアダプタからJ2EEサーバにアクセスする通信モデルです。

J2EE

JavaTM 2 Platform, Enterprise Editionの略です。Sun Microsystems, Inc.からJ2EE仕様が公開されています。

J2EEアプリケーション

JSP，サーブレット，EnterpriseBeanなどで構成されるアプリケーションです。Cosminexusで扱うJ2EEアプリケーションの形式には，EARファイル形式でパッケージ化されたアーカイブ形式のアプリケーションと，アーカイブ化しない展開ディレクトリ形式のアプリケーションがあります。EARファイル形式でパッケージ化されたアプリケーションの場合，複数のEJB-JARファイル，複数のWARファイル，および一つのDDから構成されます。

J2EEアプリケーション実行時間の監視機能

EJBおよびWebアプリケーションのリクエスト実行時間を監視する機能です。実行時間監視中に障害を検知すると，メソッドタイムアウト機能およびメソッドキャンセル機能が動作します。

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

J2EEアプリケーションの停止での強制停止とは，J2EEアプリケーションで処理中のリクエストがある場合でも，強制的に処理を中止する方法です。

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

J2EEアプリケーションの停止での通常停止とは，WebアプリケーションやEJBの停止処理を順番に実施して，J2EEアプリケーションを安全に停止させる方法です。

J2EEコンテナ

J2EEアプリケーションを実行するためのサーバ基盤です。

J2EEコンポーネントへ各種APIを提供する，Webコンテナ，EJBコンテナから構成されます。

J2EEコンポーネント

サーブレット，JSP，Enterprise Beanなどのユーザアプリケーションプログラムのことです。

J2EEサーバ

J2EEコンテナを生成，実行する環境です。

J2EEサーバモード

J2EEサーバの動作モードの一つです。このモードの場合，J2EEコンテナ上で動作するアプリケーションから，J2EE関連のAPIを利用できます。なお，J2EEサーバモードには，1.4モードと，互換用の動作モードであるベーシックモードがあります。

J2EEサービス

J2EEコンテナの部品機能として利用されます。J2EEコンポーネントにJNDI，JDBC，JTA，RMI-IIOPおよびJavaMailのAPIを提供します。

J2EEリソース

サーバから利用できるリソースです。J2EEサーバの場合，データベース，OpenTP1，SMTPサーバなどを利用できます。また，バッチサーバの場合，データベースを利用できます。

J2EEリソースアダプタ

J2EEサーバに共有スタンドアロンモジュールとして配備したリソースアダプタのことです。

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

ユーザ認証ライブラリおよびシングルサインオンライブラリの機能を使用するために必要なJAAS認証用の設定ファイルです。

Java

1991年にSun Microsystems, Inc.内の研究グループが開発したインタプリタ言語を基に，C++をより移植性と信頼性が高くなるように改良した言語です。Webの普及によってブラウザに応用されています。

JavaロギングAPI

J2SEで提供されているコアロギング機能のクラスおよびインタフェースです。Application Serverでは，JavaロギングAPIを使用してユーザログを日立トレース共通ライブラリ形式で出力する機能を提供しています。

JCAコンテナ

J2EEサーバやバッチサーバと，EISを接続するためのシステムレベルのプラグイン機能を提供するコンテナです。

JDBC（Java Database Connectivity）

Javaのプログラムでデータベースを利用するためのAPIです。

JavaSoftが1996年前半に仕様を公開しました。Javaプログラムから，JDBC APIを経由して「JDBCドライバ」を呼び出し，ドライバがデータベース・サーバへの接続機能を提供します。

JNDI（Java Naming and Directory Interface）

Javaプラットフォーム用の標準拡張機能で，Java テクノロジに対応したアプリケーションに，企業内の複数のネーミングおよびディレクトリサービスへの統一したインタフェースを提供します。

Application Serverでは，Cosminexus TPBrokerのCORBAネーミングサービスを利用して，JNDIの機能を実現しています。

JNDI名前空間

JNDIによってアクセスする名前情報が管理されている名前空間です。Application Serverでは，J2EEアプリケーションをデプロイした時に，EJBオブジェクトリファレンスがJNDI名前空間の名前にバインドされます。

Application Serverで使用するJNDI名前空間の名前には，別名を付けることができます。これによって，Enterprise BeanやJ2EEリソースを別名でルックアップできるようになります。

JP1

日立の統合システム運用管理ソフトウェアです。

JP1/AJS2

日々の業務の中から，定型的・定期的なものを自動化して，システム運用に掛かるコストを削減し，少ない人員で確実な運用を実現するめたのプログラム群です。JP1/AJS2 - Manager，JP1/AJS2 - Agent，JP1/AJS2 - Viewの製品で構成されます。

JP1/AJS2 - SO

一つ一つの運用手順を蓄積し，ライブラリとして統合する運用管理の基盤機能を提供するプログラムです。立案したシナリオに合う運用手順をライブラリから選択し，運用環境に合わせてカスタマイズすることで，業務運用の設計を容易に，かつ高品質で実現することができます。

JP1/Cm2/NC - Manager

負荷分散機の設定をしたり，負荷分散機の制御をしたりするためのプログラムプロダクトです。

JP1/Cm2/NC - Manager for Cosminexus

Cosminexusと連携して，負荷分散機を制御するためのプログラムプロダクトです。Management Serverから負荷分散機を動的に制御できます。

JP1/IM

企業情報システム全体を統合管理する基盤になるプログラム群です。JP1 Version 8の場合は，JP1/IM - Manager，JP1/IM - View，およびJP1/IM - CMの三つの製品で構成されます。JP1 Version 7iの場合は，JP1/IM - Central ConsoleおよびJP1/IM - Central Scope，JP1/IM - View，およびJP1/IM - CMの四つの製品で構成されます。

JP1/IM - CM

業務システムを構成する各種のリソース（サーバ，ストレージなど）やシステム構成に関する情報を集約して管理するためのプログラムです。管理対象のリソースを任意にグルーピングできるため，システムの監視（性能，障害）や運用（設定配布，構成変更）の際に，グループ単位で管理したり操作したりできます。

JP1/NETM/Audit

システム内の製品が出力した監査ログを自動収集して，一括管理するためのプログラムプロダクトです。JP1/Baseと連携して，Cosminexusのアプリケーションサーバ，運用管理サーバ，連携する日立オープンミドルウェア製品などが出力した監査ログを監査ログ管理サーバで自動収集できます。また，収集した監査ログを，監査ログ管理サーバのデータベースで一元管理できます。

JP1/SC/DPM

デプロイメント操作を実行するためのソフトウェアです。ディスクイメージをバックアップしたり，OSやアプリケーションのインストールを一括して実施したりできます。

JP1イベント

システム内で何らかの事象が発生した際に，その事象に関してJP1/Baseに通知される情報です。

JP1ジョブ運用管理サーバ

JP1/AJS2と連携してシステムの自動運転をする場合に，JP1/AJS2 - Managerを配置するホストのことです。

JP1統合運用管理サーバ

JP1/IMと連携してシステムの集中監視をする場合に，JP1/IM - Manager（JP1 Version 8の場合）を配置するホストのことです。JP1 Version 7iの場合は，JP1/IM - Central ConsoleおよびJP1/IM - Central Scopeを配置するホストのことです。

JSP（JavaServer Pages）

Webページを作成するHTMLの中にJSP固有のタグを埋め込んでEnterprise Beanを呼び出すことや，サーブレットから値を受け取ることができます。また，簡単なJava言語を直接記述することもできます。

JSP EL

JSP 2.0で定義された式言語です。JSPファイルやタグファイル内に

JavaBeansの属性へのアクセスなどを記述できます。また，APIも提供されています。

JSPコンパイル結果

JSPファイルおよびタグファイルのコンパイルで生成されるJavaソースファイルやクラスファイルです。

JSP事前コンパイル

Webアプリケーションに含まれるJSPファイルおよびタグファイルをデプロイ前にコンパイルし，Javaソースファイルやクラスファイルを生成する機能です。JSP事前コンパイル機能を使用してあらかじめJavaソースファイルやクラスファイルを生成しておくと，Webアプリケーション実行時の初回リクエストでのレスポンスタイムを短縮できます。

JSPタグライブラリ

JSPタグを作成するためのもので，JSP仕様で規定されています。Cosminexusでは，統合ユーザ管理をする場合に，Cosminexus標準ログインモジュールを使用してユーザ認証をするためのJSPタグライブラリを提供しています。

Management Server

運用管理ドメインを構成するサーバプログラムです。運用管理ドメイン単位に一つ配置します。

Management Serverは運用管理ドメイン内の各ホストに配置した運用管理エージェントに指示を出して，運用管理ドメイン全体の運用管理を実行します。

Managementアクション

Managementイベント発生時に自動的に実行される処理です。Managementアクションとしてどのような処理をするかは，Management Server側であらかじめ定義しておきます。

Managementイベント

Management Serverを利用して運用している場合に，運用管理ドメイン内の論理サーバで発生した事象に応じてManagement Serverで発行するイベントです。論理サーバでメッセージが出力されたタイミングで発行できます。例えば，リソース監視中に設定したしきい値を超えた場合などに発行できます。

Managementイベントに対してManagementアクションを定義しておくと，発生した事象に応じたアクションを自動的に実行できます。

Message-driven Bean

JMSと連携するメッセージ駆動タイプのBeanです。EJBコンテナはJMSのDestinationからのJMSメッセージ受信を契機にBeanを起動します。

MIBオブジェクト

SNMPプロトコルで使用するオブジェクトです。

MIBファイル

SNMPプロトコルで使うオブジェクトの構造体を記述したテキストファイルです。すべてのオブジェクト（情報）は，オブジェクトIDで一意に決まります。

Microsoft Cluster Service

クラスタソフトウェアの一つです。

システムを監視し，障害発生時などにシステムの切り替えを実行するプログラムです。Microsoft Cluster Serviceと連携することで，Cosminexusシステムの信頼性や稼働率を向上できます。Windows Server 2003で使用できます。

Microsoft Cluster Serviceと連携したシステムでは，1：1系切り替えシステム，相互系切り替えシステム，N：1リカバリシステムが実現できます。

N:1リカバリシステム

クラスタ構成の実行系のアプリケーションサーバに対して，1台のリカバリ専用サーバを待機系として配置したシステムです。リカバリ専用サーバでは，障害が発生した実行系のアプリケーションサーバのトランザクションの決着をします。

Oracle RAC

Oracleデータベースのクラスタ機能です。Cosminexusでは，Oracle RAC機能を使用してクラスタ化されたOracleデータベースに接続できます。

ORBゲートウェイ

CORBAクライアントからJ2EEサーバ内で動作しているEJBアプリケーションを直接呼び出しできるゲートウェイ機能です。CTMレギュレータプロセスによって提供されます。

OTMゲートウェイ

TPBroker OTMのクライアントからJ2EEサーバ内で動作しているEJBアプリケーションを直接呼び出しできるゲートウェイ機能です。OTMゲートウェイプロセスによって提供されます。

OTS（Object Transaction Service）

1.4モードで，TPBroker OTSによる分散トランザクションを使用するために必要なサービスです。

Outbound

Connector 1.5仕様で定められたJ2EEサーバとリソースアダプタ間の通信モデルの一つです。J2EEサーバからリソースアダプタにアクセスする通信モデルです。

PRFデーモン

バッファに出力されたPRFトレースをPRFトレースファイルに出力するIOプロセスです。

Management Serverでは，論理サーバとして扱えます。Management Serverで扱う場合は，パフォーマンストレーサといいます。

PRFトレース

リクエストを処理する時にCosminexusシステムの各機能で出力されたトレース情報です。バッファに出力されて，一定量たまったらPRFトレースファイルに出力されます。

PRFトレース出力ライブラリ

Cosminexusシステムの各機能に組み込まれているライブラリです。機能レイヤごとのPRFトレースをバッファに出力する機能を提供しています。

PRFトレース取得レベル

PRFトレースを取得するレベルです。「標準レベル」，「詳細レベル」，「保守レベル」があります。「詳細レベル」または「保守レベル」を指定した場合，「標準レベル」に比べてトレース取得ポイントが多くなります。

PRFトレースファイル

PRFトレースを出力したバイナリ形式のファイルです。性能解析トレースファイル（CSV形式）に変換する基になるファイルです。

RMI-IIOP

JavaRMI とJavaIDLを統合したAPIです。

SecurityManager

セキュリティポリシーに基づいたWebコンテナの実行時保護をするJ2EEサーバの機能です。

Server Plug-in

Eclipseのプラグインです。Server Plug-inを使用すると次の操作ができます。

リソースアダプタのプロパティを設定したり，設定したリソースアダプタをJ2EEサーバやバッチサーバにデプロイしたりする。

J2EEアプリケーションのプロパティを設定したり，設定したJ2EEアプリケーションをJ2EEサーバにインポートしたりする。

論理サーバを起動・停止する。

Session Bean

主に業務処理を実行するためのBeanです。Session Beanは，クライアントを一つだけ持つことができます。クライアントが終了すると，対応するSession Bean も終了します。クライアントとのセッションの間だけ動作するため，一時的であり，非永続的なBeanです。Session Beanは，Stateful Session Beanと，Stateless Session Beanに分類されます。

SFOサーバ

システム内のJ2EEサーバのJ2EEアプリケーション内で生成されたグローバルセッション情報を管理するJ2EEサーバです。セッションフェイルオーバ機能を使用するときにシステム構成に含めます。

SFOサーバアプリケーション

SFOサーバ上で稼働するJ2EEアプリケーションを，SFOサーバアプリケーションといいます。SFOサーバアプリケーションはEJBで実装されています。なお，SFOサーバアプリケーションはCosminexusで提供しています。

Smart Composer機能

Cosminexusを使用してアプリケーションサーバを構築する場合に，一般的な3階層モデルのアプリケーションサーバのシステムを，簡単に構築および運用できるよう支援する機能です。システム全体に対して，システムの設定，およびJ2EEアプリケーションやリソースアダプタのデプロイを一括で実行できるので，簡単，迅速にシステム構築ができます。

構築したシステムを一括で起動したり，一括でシステムの設定を変更したりなど，運用機能についてもサポートしています。

snapshotログ

ある時点でのJ2EEサーバやバッチサーバの状態が出力されたログファイルです。

トラブルシューティングに必要な情報が自動的に出力されます。

Management Serverを利用している場合は，次のタイミングで出力されます。

論理サーバに異常が発生した時

運用管理ポータルまたは運用管理コマンドによってsnapshotログの収集を要求した時

Management Serverを利用していない場合は，コマンド（snapshotlog）を実行した時に出力されます。このコマンドで出力できるのは，そのコマンドを実行したホストの情報だけです。

SNMP連携用形式ファイル

SNMP Manager製品と連携するためのファイルです。MIBファイルに変換する基になる形式のファイルです。Management Serverの運用管理コマンド（mngsvrutil）で出力できます。

Stateful Session Bean

内部的な状態を保持できるBeanです。Stateless Session Beanとは異なり，ホームインタフェースからの生成によってインスタンス化されたあとは，メソッドの呼び出しごとに生成，消滅することはありません。セッション単位で連続した処理をする場合に適したBeanです。

Stateless Session Bean

状態を保持しないBeanです。Beanのインスタンスの生成・消滅は，すべてEJBコンテナが独自に管理しています。同じBeanのメソッドを続けて呼び出した場合にも，それらが同じインスタンスである保証はありません。そのため，Stateless Session Beanでは，内部状態を保持して，複数メソッドで連続した処理をすることはできません。1メソッドで完結するような処理を記述する場合に適しています。

Timer Service

EJBコンテナで提供される機能です。指定した時刻，経過時間，または間隔で，EJBコンテナがタイムアウトメソッドをコールバックします。

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

JAAS対応ユーザ管理，およびシングルサインオンの機能を使用するための設定ファイルです。

uCosminexus Batch Job Execution Server

オープン環境で基幹系のバッチ業務を実行・運用するためのバッチジョブ実行基盤を提供する製品です。JP1/AJS2とあわせて使用します。

uCosminexus Client

EJBクライアント環境を構築するための製品です。

uCosminexus Operator

Application Serverをインストールしたマシンとは別のマシンから，GUI（Eclipseプラグイン）画面を使用して運用操作を実行するための製品です。例えば，実行環境がUNIXの場合に，別のWindowsのマシンでEclipseプラグインのGUIによる運用管理操作を実行したいときに，この製品を使用します。

usrconf.properties（ユーザプロパティファイル）

J2EEサーバ，バッチサーバ，Webコンテナサーバ，またはサーバ管理コマンドで使用するJavaVMのシステムプロパティを定義するファイルです。

WARファイル

Webアプリケーションの構成要素をJARファイル形式に圧縮したファイルです。

Webアプリケーション実行に必要なHTMLファイル，JSPページ，Javaクラスファイル，JARファイル，およびWebアプリケーション配置記述子が含まれます。

Webアプリケーション

Webブラウザを備えたクライアントを対象に作成されたアプリケーションです。具体的には，サーブレットプログラム，JSPページ，HTML/XMLドキュメントなどの集合体です。

Webコンテナ

J2EEアーキテクチャのWebコンポーネント規約を実装するコンテナです。セキュリティ，トランザクションなどの各種サービスを提供する実行環境です。Webアプリケーションは，Webコンテナ上で動作します。

Java Servlet2.4仕様，およびJavaServer Pages Specification v2.0仕様に準拠したWebアプリケーションを実行できます。

Webコンテナサーバ

サーブレットエンジンモードで動作するサーバを指します。

Webサーバ

Webブラウザからのリクエスト受信およびWebブラウザへのデータ送信に関連する処理を実行するプログラムです。Cosminexusでは，Hitachi Web Server，Microsoft IIS，またはインプロセスHTTPサーバを使用できます。インプロセスHTTPサーバは，J2EEサーバプロセス内で動作するWebサーバです。

なお，Management Serverを利用する場合，Hitachi Web Serverは論理サーバとして扱えます。

Webサーバ連携

アプリケーションサーバで使用するWebサーバとして，Hitachi Web ServerまたはMicrosoft IISを使用する方法です。

Hitachi Web ServerまたはMicrosoft IISにCosminexus Component Containerが提供するリダイレクタモジュールを組み込んで使用します。

Webシステム

1台の負荷分散機（ロードバランサ）と複数のWebサーバおよびアプリケーションサーバで構築されるWebクラスタシステムで，単一の業務サービスを提供します。

（ア行）

アーカイブ形式

EJBやサーブレットなどのアプリケーションの実体をJ2EEサーバの作業ディレクトリに持つJ2EEアプリケーションの形式です。

アウトプロセス

プロセスの起動のしかたです。アウトプロセスで起動させると，J2EEサーバのプロセス外で実行します。アウトプロセスでネーミングサービスを使用する場合，CORBAネーミングサービスはユーザが起動する必要があります。

アセンブル

単体では動作しないEJB-JARをアプリケーションの1構成要素として位置づけるための組み立て作業のことです。

アノテーション

ソースコードにクラスやメソッドの付加情報などを埋め込むための記述方式です。

アプリケーションサーバ

情報システムの中間に位置し，ユーザの要求（プレゼンテーション層）とデータベースなどの業務システム（データ層）の処理を橋渡しするためのアプリケーション層を構築するためのミドルウェアです。

日立のアプリケーションサーバCosminexusは，業務の開発から運用まで一貫した環境を提供します。

アプレット

Web経由で読み手のマシンのブラウザ上にダウンロードされるJavaプログラムです。

イベントリスナ

イベントを受け取って処理するオブジェクトです。Application Serverでは，Webアプリケーション単位でサーブレットコンテキストオブジェクトまたはセッションオブジェクトの状態変化イベントを受け取ります。

インプロセス

プロセスの起動のしかたです。インプロセスで起動させると，J2EEサーバのプロセス内で実行するように最適化されるので，パフォーマンスの高いシステムが実現できます。ネーミングサービス，トランザクションサービスおよびHTTPサーバ機能をインプロセスで起動できます。このとき，CORBAネーミングサービス，インプロセスOTSおよびインプロセスHTTPサーバは，J2EEサーバ起動時に自動で起動されます。

インプロセスHTTPサーバ

J2EEサーバのインプロセスで動作するWebサーバ機能です。Webコンテナの機能の一部として提供されます。

運用監視エージェント

ホスト上で動作する論理サーバの稼働状況を監視して，稼働情報を収集するエージェントプログラムです。

運用管理エージェント

運用管理者の代わりに，それぞれのホスト上の論理サーバを起動したり，設定ファイルを更新したりするエージェントプログラムです。

運用管理コマンド（mngsvrutil）

Management Serverを操作するためのCUIです。

運用管理サーバ

Smart Composer機能または運用管理ポータルでシステムを構築している場合に，Management Serverを配置したホストです。運用管理ドメイン内の各ホストに配置されている運用管理エージェントに対して，管理操作を指示します。

運用管理サーバモデル

Smart Composer機能または運用管理ポータルでシステムを構築している場合に，アプリケーションサーバとは別の運用管理用のホストにManagement Serverを配置するシステム構成モデルです。

運用管理ドメイン

Management Serverが管理する論理サーバの集合です。同じ運用管理ポリシーが適用されます。

運用管理ポータル

Management Serverを操作するためのGUIです。Webブラウザで表示します。

運用管理ポリシー

運用，監視，セキュリティなど，運用管理に関するポリシーです。

エラーページのカスタマイズ

Webクライアントから存在しないリソースへのアクセスなどがあった場合に，Webコンテナから返却されるエラーページをユーザが作成した任意のページに変更して表示させる機能です。

（カ行）

ガーベージコレクション制御機能

リソースの排他中にガーベージコレクションの実行を待ち状態にする機能です。リソースの排他中にフルガーベージコレクションが発生し，処理が長時間中断されるのを回避できます。ガーベージコレクション制御機能は，バッチサーバの場合に使用できます。

カスタムジョブ

JP1/AJS2以外のプログラムとJP1/AJS2が連携するジョブを定義する場合に，目的のジョブを容易に作成するために使用できるジョブのテンプレートです。Windowsの場合，Cosminexusでは，「論理サーバ制御用カスタムジョブ」と「アプリケーション制御用カスタムジョブ」の2種類を提供しています。

カスタムログインモジュール

Cosminexus標準ログインモジュール以外を使用して，各アプリケーションのユーザ認証をしたい場合に作成する実装クラスです。

仮想サーバ

負荷分散機で複数の実サーバを管理するための仮想的なサーバです。負荷分散機では，クライアントから仮想サーバにアクセスされたトラフィックを，実サーバに自動分配します。

稼働情報収集機能

J2EEサーバやバッチサーバ内の各機能の稼働情報を定期的に収集し，ファイルに出力する機能です。出力されたファイルを稼働情報ファイルといいます。

簡易Webサーバ

WebコンテナをHTTPサーバとして使用して，スタブなどのダウンロードに利用する機能です。インプロセスHTTPサーバとは異なり，実運用時にはスタブのダウンロード以外の目的では使用できません。

Management Serverを利用する場合は，「管理用サーバ」という名称で扱います。

監査証跡

データベースの機能で出力する，データベースに対する操作記録のことです。データベースに対する権限の運用が適切に行われているかどうかをチェックするために使用します。Cosminexusでは，監査証跡にCosminexusシステムの情報を出力するためのデータベース監査証跡連携機能を提供しています。

監査ログ

システム構築者やシステム運用者がCosminexusのプログラムに対して実行した操作，およびその操作に伴うプログラムの動作の履歴が出力されるファイルです。監査者が監査ログを調査することで，「いつ」「だれが」「何をしたか」を知ることができて，システムの運用が法規制，セキュリティ評価基準，または業界ごとの各種の基準に準拠していることを証明できます。

監視ツリー

JP1/IM連携をしている場合に，統合スコープに表示するツリーのことです。Cosminexusシステムでは，監視ツリーとして，Cosminexus業務指向ツリーとサーバ指向ツリーの2種類を作成する機能を提供しています。

管理対象オブジェクト（AdminObject）

Connector 1.5仕様で定義された，キューやトピックなどを使用したメッセージの送受信で使用するオブジェクトです。メッセージ送信や，同期または非同期でのメッセージ受信でのメッセージ変換で使用します。

管理対象オブジェクトは，メッセージプロバイダごとに特有のオブジェクトです。リソースアダプタが使用する管理対象オブジェクトは，リソースアダプタのDD（ra.xml）の<adminobject>タグで指定します。

機能レイヤ

性能解析トレース収集をする場合に，PRFトレースを出力する機能の層です。EJBクライアント，リダイレクタ，Webコンテナ，CTM，EJBコンテナ，JNDI，JTA，JCA/JDBCなどがあります。

業務指向ツリー

JP1/IMと連携している場合に統合スコープに表示する監視ツリーの一つです。Cosminexusシステム上で稼働しているJ2EEアプリケーションを主体に構成されている監視ツリーです。どの業務で問題が発生しているか，業務の視点でトラブルを監視できます。

業務処理プログラム

ビジネスロジックを実装したEnterprise Beanのことです。

共有スレッド数

Webコンテナ上にデプロイされているWebアプリケーションで共有されるスレッド数です。

クライアントアプリケーション情報

性能解析トレースに出力される情報です。次に示すEnterprise Beanを呼び出す単位で設定される情報です。

WebコンテナからEJBコンテナの呼び出し

EJBクライアントからEJBコンテナの呼び出し

EJBコンテナからEJBコンテナの呼び出し

クラスタ

ある共通の機能を提供するサーバの集合です。

Management Serverでは，J2EEサーバクラスタまたはWebサーバクラスタを論理サーバとして扱えます。

クラスタソフトウェア

システムの信頼性向上，稼働率向上を目的として，システムの切り替えを実現するプログラムです。

実行中のサーバシステムに障害が発生した場合，事前に待機しているサーバシステムに，直ちに自動で切り替えることができます。そのため，オペレータが特に意識することなく，システムの信頼性や稼働率を高められます。

Cosminexusでは，クラスタソフトウェアを使用して，1:1系切り替えシステム，N:1リカバリシステム，および相互系切り替えシステムを実現できます。

AIX，HP-UXまたはLinuxを使用している場合は，クラスタソフトウェアとしてHAモニタが使用できます。Windowsの場合は，クラスタソフトウェアとしてMicrosoft Cluster Serviceが使用できます。

グローバルCORBAネーミングサービス

CTMによってリクエストをスケジューリングする場合に，CTMドメイン内に含まれる複数のJ2EEサーバに登録されている業務処理プログラム（Stateless Session Bean）の情報を共有管理するネーミングサービスです。

グローバルセッション

セッションフェイルオーバ機能では，障害発生前のHTTPセッションと，障害発生後に引き継がれたHTTPセッションを一つのセッションとして扱います。これをグローバルセッションといいます。

グローバルセッションID

グローバルセッションを管理するIDです。システム内でグローバルセッション情報を一意に識別するために，グローバルセッションに付けられます。

グローバルセッション情報

グローバルセッションが持つ情報をグローバルセッション情報といいます。グローバルセッション情報はSFOサーバで管理されます。

グローバルトランザクション

J2EEサーバが提供するトランザクションマネジャによって管理されるトランザクションです。2フェーズコミットプロトコルを使用できるので，トランザクションに複数のリソースを参加させることができます。

系

系とは，業務処理に必要なハードウェアのほか，実行するプログラムや通信機器を含めたシステム全体の総称です。系の種類には，実行系と待機系があります。

計画系切り替え

系切り替えの方法の一つで，オペレータが系を保守する際に，計画的に系を切り替える方法です。

系切り替え

システムに障害が発生した場合やシステムの保守のために，システムを切り替えることをいいます。系切り替えが行われると，待機系は業務処理を引き継いで実行系となります。一方，実行系は，さらに障害が発生した場合に備えて待機系となります。以降，系切り替えのたびに，実行と待機を交代して，どちらかの系で常に業務処理を実行するようにします。

系障害

サーバを除いた系に発生する障害を指します。系のハードウェア障害やHAモニタの障害などがあります。なお，サーバに発生する障害はサーバ障害といいます。

ゲートウェイ指定機能

クライアントとWebサーバとの間に，SSLアクセラレータや負荷分散機などのゲートウェイを配置している場合に，Webコンテナにゲートウェイ情報を通知し，welcomeファイルやForm認証画面に正しくリダイレクトできるようにするための機能です。

現用系

最初に実行系として動作させる系を現用系といいます。系切り替えによって，実行系が待機系になった場合でも，呼び方は変わりません。

コネクションスイーパ

一定の間隔でコネクションプール内の未使用コネクションを破棄する機能です。

コネクションプーリング

サーブレット，JSP，Enterprise BeanなどのJ2EEコンポーネントや，バッチアプリケーションからリソースへのアクセス量に応じて，リソースコネクションをメモリ上にプーリングする機能です。リソースコネクションには，JDBCコネクション，リソースアダプタのコネクションなどがあります。コネクションをプーリングしておくことで，アプリケーションからのリソース接続要求を高速に処理できます。

コミットオプション

CMPフィールドのキャッシュ方法とEntity Beanの状態遷移のキャッシュモデルを指定するオプションです。

Full cachingの場合，Entity Beanは前回のトランザクションコミット時と同じ状態で開始されます。

Cachingの場合，Entity Beanはデータベースの最新状態と同じ状態で開始されます。

No cachingの場合，Entity Beanはデータベースの最新状態と同じ状態で開始され，かつ，トランザクションコミット時にEntity Beanは非活性になります。

コンテキスト

Webアプリケーションをまとめた管理単位です。

コンテキストルート

コンテキストのルートパスです。コンテキスト内のWebアプリケーションにアクセスするときにURL上に指定します。コンテキストパスとも呼びます。

コンテナ拡張ライブラリ

ユーザ作成ライブラリのインタフェースおよび機能を，J2EEコンテナ，Webコンテナ，またはバッチサーバから利用できるように拡張したライブラリです。Enterprise Bean，サーブレットおよびJSPから共通して利用できます。

（サ行）

サーバ管理コマンド

サーバで管理しているアプリケーションおよびリソースの設定をするためのコマンド群です。

サーバ起動・停止フック機能

J2EEサーバ，バッチサーバまたはWebサーバの起動・停止時に，コンテナ拡張ライブラリを使用するための初期化処理および停止処理を自動的に呼び出す機能です。J2EEサーバまたはWebサーバが異常終了した場合には機能しません。

サーバ指向ツリー

JP1/IMと連携している場合に統合スコープに表示する監視ツリーの一つです。サーバマシン（ホスト）を主体に構成されている監視ツリーです。

サービス閉塞

J2EEアプリケーションの運用中に特定の業務処理プログラムを入れ替えたい場合などに，システム全体は稼働させたまま，該当サービスだけを安全に閉塞させる機能です。

サービスユニット

J2EEサーバやWebサーバで構成される業務サービスを提供する閉じた部分系を，サービスユニットといいます。Smart Composer機能では，サービスユニット単位でシステムを構築したり，一括起動や一括停止をしたりできます。

Smart Composer機能を利用してシステムを構築するときの概念です。

サーブレット

サーバ側でJavaを実行させる方法の一つです。

サーブレットは，Webサーバに対して，単にHTML文書や画像ファイルを送るだけではなく，Webサーバと連携して，アプリケーションを実行し，その結果をHTML文書として送り返す機能を提供します。

サーブレットエンジンモード

サーバの動作モードの一つです。Webコンテナ部分だけを使用して，サーブレットエンジンを単独で動作させます。Enterprise Beanは動作しません。

サーブレットエンジンとは，サーブレット実行機能およびJSP実行機能を持つサーバのことです。

なお，サーブレットエンジンモードは互換用の動作モードとなります。

サーブレットフィルタ

サーブレット/JSPへのリクエストや，サーブレット/JSPからのレスポンスを，フィルタリングする機能です。サーブレットフィルタによって，サーブレット/JSPの実行前のリクエスト，または実行後のレスポンスをラップして，データの変更，リソースに対するトレースの取得などができます。

Cosminexusの機能を実現するためのサーブレットフィルタとしては，セッションフェイルオーバ用フィルタ，およびHTTPレスポンス圧縮用フィルタが提供されています。

実行系

業務処理を実行させる系（実行中のサーバ）を指します。

実行待ちキュー

同時実行スレッドの最大値を設定している場合に，実行スレッド数が最大に達したときに，リクエストをためておくキューのことです。

実パラメタ

Cosminexusの定義ファイルに設定するパラメタです。Smart Composer機能では，抽象パラメタを一つ設定することで，互いに関連のある複数の実パラメタに，一括で値を設定できます。

自動系切り替え

系切り替えの方法の一つで，クラスタソフトウェアが自動的に系を切り替える方法です。

シナリオ

JP1/AJS2 - SOで扱う，シナリオジョブに実行順序を付けてネットワーク化したオブジェクトです。シナリオジョブとは，シナリオ中に定義されたコマンド，シェルスクリプト，Windows実行ファイルなどを定義したオブジェクトです。

シナリオはJP1/AJS2に登録して実行できます。

ジョブ

JP1/AJS2で扱うシステム運用の各作業のことです。

ジョブネット

JP1/AJS2で扱うジョブの実行順序を関連づけたものです。

シングルサインオン

一度のログイン処理で，ユーザIDが異なる複数のシステムをシームレスに利用できるようにする機能です。

シングルサインオン情報リポジトリ

統合ユーザ管理フレームワークのユーザマッピングを実行して，シングルサインオンでユーザ認証するための各システムの認証情報とマッピング情報を格納するリポジトリです。

シングルサインオンライブラリ

ユーザマッピング情報の格納されたシングルサインオン情報リポジトリの情報を基にユーザマッピングをして，シングルサインオンを実現するライブラリです。

スケールアウト

システム全体の処理性能を向上させることを目的として，サーバの台数を増やすことをいいます。

スケールイン

システムの規模を縮小する場合などに，サーバの台数を減らすことをいいます。

スケジュールキュー

CTMによってリクエストをスケジューリングする場合に，リクエストをためておくキューです。J2EEアプリケーション単位で作成され，CTMデーモンによって管理されます。

スケジュールポリシー

CTMによってリクエストをスケジューリングする場合に，振り分ける基準を決めるポリシーです。負荷が軽いCTMデーモンに振り分ける方法と，リクエストを受け付けたCTMデーモンに優先的に処理させる方法のどちらかを選択できます。

スマートエージェント

1.4モードでグローバルトランザクションを使用する場合，またはCTMを使用する場合に，動的な分散ディレクトリサービスを提供するプロセスです。

Management Serverを利用する場合，スマートエージェントは論理サーバとして扱えます。CTMはスマートエージェントによって管理されます。

なお，グローバルトランザクションの場合でも，インプロセストランザクションサービスを利用するときは，スマートエージェントは不要です。

静的コンテンツ

HTMLファイルや画像ファイルなど，クライアントからの要求に対する応答に使用するファイルのうち，リクエスト内容に影響されないで常に同じ内容になるコンテンツのことです。

性能解析トレース

Cosminexusシステムの性能解析をするためのトレース情報です。

性能解析トレースファイル

Cosminexusシステムの性能解析をするためのトレース情報をCSV形式で編集出力したテキストファイルです。

セキュリティアイデンティティ

J2EEサーバによるユーザ認証が成功した時にWebコンテナやEJBコンテナに伝達される認証情報です。

セッション

Webアプリケーションに対する一連の作業を示す単位です。セッションは通常，WebクライアントからWebサーバへの複数のリクエストの集合から構成されます。

セッションフェイルオーバ機能

J2EEアプリケーション実行中のHttpSessionオブジェクトに登録されたオブジェクトをセッション情報として管理し，J2EEサーバで障害が発生した場合には，管理しているセッション情報をほかのJ2EEサーバに引き渡す機能です。J2EEサーバで障害が発生し，ほかのJ2EEサーバにリクエストが転送された場合でも，障害発生前の状態で業務を続行できます。

セッションフェイルオーバサーバ

セッションフェイルオーバ機能を使用する場合に，J2EEサーバを配置しないで，SFOサーバを配置して使用するホストです。

セットアップウィザード

対話形式のウィザードプログラムを使用してシステムを構築するための機能です。必要最低限の項目を設定するだけで，J2EEアプリケーションを実行するためのシステムを構築できます。できるだけ少ない手順で実行環境を構築したい場合にお勧めの機能です。ただし，セットアップウィザードで実行できるのは，1台のマシンを対象にしたシステム構築だけです。

占有スレッド数

利用できるスレッド数のうち，同時実行スレッド数制御の対象となるリクエストを確実に実行できるスレッド数です。Webコンテナ上にデプロイされているWebアプリケーションごと，またはWebアプリケーション内の業務処理ロジックごとに指定できます。

相互系切り替えシステム

クラスタソフトウェアを使用して実現できるシステムの一つです。アプリケーションサーバの実行系と待機系を1：1にする構成で，それぞれのアプリケーションサーバを実行系として稼働させながら，お互いの待機系にするシステムです。

相互スタンバイ

クラスタソフトウェアを使用した運用をする場合に，アプリケーションサーバの実行系と待機系を1:1にする構成で，それぞれのアプリケーションサーバを実行系として稼働させながら，お互いの待機系にすることです。

（タ行）

待機系

障害に備えて待機させている系（待機中のサーバ）を指します。

抽象パラメタ

互いに関連のあるパラメタを一つのパラメタとしてまとめたものです。Smart Composer機能で使用します。Smart Composer機能のコマンドを使用してパラメタを展開すると，一度に複数の実パラメタに値が展開されます。

通常モード

J2EEアプリケーションの動作モードです。通常モードは，本番稼働するJ2EEアプリケーションを動作させるためのモードです。

データソース

JDBCを使用してデータベースに接続する機能です。

テストモード

J2EEアプリケーションの動作モードです。テストモードは，テスト用のJ2EEアプリケーションを本番環境と同じように動作させるためのモードです。

デプロイ

J2EEアプリケーションの場合，J2EEサーバ内にインポートしたJ2EEアプリケーションを，クライアントから実行可能な状態にすることです。

J2EEリソースアダプタの場合，J2EEサーバ内にインポートしたJ2EEリソースアダプタを，そのJ2EEサーバ上で動作するすべてのJ2EEアプリケーションから使用可能な状態にすることです。

展開ディレクトリ形式

EJBやサーブレットなどのアプリケーションの実体を，J2EEサーバの外部にある一定のルールに従ったファイル／ディレクトリに持つJ2EEアプリケーションの形式です。

統合コンソール

JP1/IMと連携している場合に，システムで発生した事象に関するエラーメッセージなどを表示する画面です。

統合スコープ

JP1/IMと連携している場合に，システムの監視画面として管理者の目的に合った監視ツリーを表示する画面です。

統合ネーミングスケジューラサーバ

CTMによるリクエストのスケジューリングをする場合に，J2EEサーバを配置しないで，グローバルCORBAネーミングサービスを配置して使用するホストです。統合ネーミングスケジューラサーバのレプリカを作成することで，可用性を向上できます。なお，統合ネーミングスケジューラサーバにもCTMデーモンは必要です。

統合ネーミングスケジューラサーバモデル

CTMによるリクエストのスケジューリングをする場合に，J2EEサーバを配置しないでグローバルCORBAネーミングサービスを配置するホストを作成するシステム構成モデルです。

統合ユーザ管理

Cosminexusシステムにログインするユーザを統合管理するための仕組みです。ユーザ認証を実現する統合ユーザ管理フレームワークと，リポジトリ管理およびリソース監視を実現する統合ユーザ管理GUIが使用できます。

統合ユーザ管理GUI

Management Serverの運用管理ポータルから，統合ユーザ管理の対象になるユーザ情報を格納したリポジトリを管理したり，統合ユーザ管理に関連するリソースを監視したりするためのGUIです。

統合ユーザ管理フレームワーク

統合ユーザ管理でのユーザ認証を実現するフレームワークです。Java標準仕様（JAAS）に従ったAPIが提供されています。

動作モード

サーバの動作モードです。J2EEサーバモードとサーブレットエンジンモードがあります。J2EEサーバモードには，さらに，1.4モード，ベーシックモードがあります。

ただし，ベーシックモードおよびサーブレットエンジンモードは旧バージョンとの互換用の動作モードとなります。

動的コンテンツ

サーブレットやJSPのように，クライアントからの要求に応じて動的に生成されるコンテンツのことです。

トランザクションサービス

グローバルトランザクションを使用する場合に，トランザクションを管理するサービスです。TPBroker OTSによって提供されるサービス全体を表します。トランザクションサービスは，J2EEサーバのインプロセスで起動されます。

トランザクションマネジャ

トランザクションを管理する機能です。Application Serverが提供しています。グローバルトランザクションの場合は，トランザクションマネジャのバックエンドでTPBroker OTSが使用されています。

トレース取得ポイント

Cosminexusシステムの各機能レイヤでPRFトレースを出力するポイントのことです。PRFトレース取得レベルの指定によって，トレース取得ポイントの数は異なります。

（ナ行）

ネーミング切り替え

JNDIを介してEJBホームオブジェクトの登録，削除，検索をする時に，JNDIが接続するCORBAネーミングサービスを切り替えることです。

ネーミングサービス

オブジェクトに名前を付けて格納場所を管理しておくことで，格納先を知らなくても名前からそのオブジェクトを利用できるようにするサービスです。Application ServerではCORBAネーミングサービスを利用します。

Management Serverでは，ネーミングサービスを論理サーバとして扱えます。

（ハ行）

バインド先アドレス設定機能

Webサーバ連携および簡易Webサーバで利用するIPアドレスを，Webコンテナで明示的に指定する機能をバインド先アドレス設定機能といいます。複数の物理ネットワークインタフェースを持つホストまたは一つの物理ネットワークインタフェースに対して，ホストで実行する場合に，この機能を使用することで，任意のIPアドレスを設定できます。

バッチアプリケーション

バッチ処理を実装したJavaアプリケーションです。バッチ実行コマンドを使用して，バッチサーバ上で実行します。バッチ実行コマンドをJP1/AJS2のジョブとして定義しておくと，JP1/AJS2からバッチアプリケーションを実行できます。

バッチサーバ

バッチアプリケーションを実行するためのサーバです。バッチアプリケーションの実行機能のほかに，バッチアプリケーションからデータベースに接続したり，EJBにアクセスしたりする機能も提供しています。

パフォーマンストレーサ

PRFデーモンのことです。

Management Serverでは，パフォーマンストレーサを論理サーバとして扱えます。

ハンドラ

ロガーから受け取ったアプリケーションのログをファイルやコンソールに出力する，JavaロギングAPIのHandlerオブジェクトです。J2EEアプリケーション，バッチアプリケーション，EJBクライアントアプリケーションで使用できます。

Application Serverでは，日立トレース共通ライブラリ形式のログをファイルに出力するためのファイルハンドラである，CJMessageFileHandlerを提供しています。

ビジネスインタフェース

Enterprise Beanを呼び出すためのビジネスメソッドを定義するインタフェースです。

日立トレース共通ライブラリ

日立が提供するトレース採取用のライブラリです。複数の製品で共通のライブラリを利用するので，各製品のトレース形式が統一できます。

非保護区

メソッドキャンセルができる領域を指します。ユーザプログラムのコードが非保護区に該当します。メソッドキャンセルとは，J2EEアプリケーション実行時間の監視で提供される機能の一つです。また，バッチ強制停止コマンドでも使用されます。

負荷分散機

Webブラウザなどからのリクエストを一元的に受け付けて，同等の機能を持つ複数のサーバに転送して各サーバの負荷を分散させるための装置です。

物理コネクション

接続先リソースのコネクションです。通常はJ2EEコンテナが操作します。リソースアダプタの場合は，javax.resource.spi.ManagedConnection，JDBCの場合はjavax.sql.XAConnectionに該当します。

物理ティア

同一のデプロイメント（プロセスの配置，J2EEアプリケーションやリソースアダプタのデプロイ，定義）を適用するサーバマシンの集合を物理ティアといいます。

Smart Composer機能を利用してシステムを構築するときの概念です。

フロントEJB

リクエストの受け口となるEnterprise BeanをフロントEJBといいます。

ベーシックモード

旧バージョンとの互換性を確保するためのサーバの動作モードの一つです。

単一リソースとのトランザクション管理ができます。

別名

JNDI名前空間に登録するEJBホームオブジェクトリファレンスや，J2EEリソースに付けられる任意の名前です。ユーザ指定名前空間機能を使用している場合，別名を付けられます。Optional Nameともいいます。

保護区

メソッドキャンセルができない領域を指します。J2EEサービスのソースなどが保護区に該当します。メソッドキャンセルとは，J2EEアプリケーション実行時間の監視で提供される機能の一つです。また，バッチ強制停止コマンドでも使用されます。

ホスト単位管理モデル

Smart Composer機能または運用管理ポータルでシステムを構築している場合に，Management Serverをアプリケーションサーバと同じホストに配置するシステム構成モデルです。

（マ行）

未決着トランザクション

決着していない，仕掛かり中のトランザクションです。

メソッドキャンセル機能

J2EEアプリケーション実行時間の監視機能の機能の一つです。メソッドタイムアウト機能でタイムアウトが通知されたあと，メソッドのキャンセルを実施する機能です。キャンセル時にデータベースにアクセスしている場合は，トランザクションの強制決着もします。

また，メソッドキャンセル機能は，バッチ強制停止コマンド実行時にも使用されます。

メソッドタイムアウト機能

J2EEアプリケーション実行時間の監視機能の機能の一つです。監視基盤にあるリクエストのうち，一定時間内に終了しなかったメソッド処理を，タイムアウトとしてユーザに通知します。

メッセージインフロー

メッセージプロバイダがアプリケーションサーバ上のメッセージエンドポイントにメッセージを配送する場合の規約です。Connector 1.5のInboundの通信モデルを使用する場合に使用できる機能です。

メッセージプロバイダにはEISなどが該当します。アプリケーションサーバ上のメッセージエンドポイントにはMessage-driven Beanが該当します。

面数

ログファイルを保持する数です。ログファイルは面数分作成され，循環して使用されます。

メンバリソースアダプタ

コネクションプールをクラスタ構成にしている場合に，データベースノードに接続するリソースアダプタです。メンバリソースアダプタは，必ずルートリソースアダプタを経由してアクセスされます。

（ヤ行）

ユーザ指定名前空間機能

JNDI名前空間に登録するEJBホームオブジェクトリファレンスやJ2EEリソースの名前に，ユーザが任意の別名を付けられる機能です。別名を付与することによって，CTMによってリクエストを振り分けたり，負荷分散機やロードバランサによって負荷分散したりする場合に，サーバ名やアプリケーション名に依存しない名前でルックアップできるようになります。

ユーザ情報

Cosminexusシステムにユーザがログインするための情報です。

ユーザ情報リポジトリ

統合ユーザ管理をする場合に，ログイン時のユーザ認証に使用する情報を格納するリポジトリです。LDAPディレクトリサーバまたはデータベース（RDB）が使用できます。

ユーザスレッド

ユーザがプログラムの中で明示して生成するスレッドのことです。

ユーザ認証ライブラリ

LDAPディレクトリサーバで構築されたユーザ情報リポジトリの情報を基にユーザ認証をして，認証したユーザの情報をアプリケーションに提供する，JAAS対応ユーザ管理用ライブラリです。

ユーザプロパティファイル

usrconf.propertiesのことです。J2EEサーバ，Webコンテナサーバまたはサーバ管理コマンドを実行するJavaVMのシステムプロパティを指定します。なお，J2EEサーバ，Webコンテナサーバおよびサーバ管理コマンドで使用するユーザプロパティファイルは，それぞれ格納先および指定できるキーが異なります。

ユーザマッピング

異なるユーザ情報リポジトリに格納した同じユーザについての情報を対応づけることです。

ユーザログ

J2EEアプリケーション，バッチアプリケーション，またはEJBクライアントアプリケーションが出力するログのことです。

予備系

最初に待機系として起動する系を予備系といいます。系切り替えによって，待機系が実行系になった場合でも，呼び方は変わりません。

（ラ行）

ライトトランザクション

ローカルトランザクションを最適化した状態で使用できる機能です。

ライブラリJAR

JARファイル形式でパッケージされた，共通ライブラリです。J2EEアプリケーション内のJ2EEコンポーネントから共通に使用できます。

ラウンドロビン検索

複数のCORBAネーミングサービス上にある同一名称のEJBホームオブジェクトを，ラウンドロビンポリシーに従ってルックアップする検索機能のことです。

ラウンドロビンポリシー

複数のCORBAネーミングサービス上にある同一名称のEJBホームオブジェクトをルックアップする場合に適用されるポリシーです。

EJBホームオブジェクトリファレンスをラウンドロビン検索によって取得できるので，EJBクライアントでは意識しないでJ2EEサーバに送信するリクエストの負荷分散を実現できます。

リカバリ専用サーバ

クラスタソフトウェアを使用してN:1リカバリシステムを構築している場合に待機系として機能するアプリケーションサーバです。

障害が発生した実行系のアプリケーションサーバに未決着のトランザクションがあった場合に，系が切り替えられ，該当するトランザクションを解決してリソースを解放します。

リクエスト処理スレッド

Webブラウザなどのクライアントからのリクエストを受け付けて処理するためにWebサーバで生成されるスレッドです。インプロセスHTTPサーバの場合は，Webコンテナで生成されます。

リクエストのスケジューリング

クライアントからのリクエストを実行するサーバを負荷に応じて的確に振り分けたり，サーバに送信するリクエストの数を制限したりする機能です。

リソースアダプタ

J2EE Connector Architectureによって，J2EEサーバまたはバッチサーバと，EISを接続するための接続機能です。

Cosminexusシステムでは，データベースに接続するためのリソースアダプタであるDB ConnectorおよびDB Connector for Cosminexus RMを提供しています。また，OpenTP1のSPPと接続するためのリソースアダプタであるuCosminexus TP1 Connector，TP1/Message Queueと接続するためのリソースアダプタであるTP1/Message Queue - Access，データベース上に実現したキューに接続するためのリソースアダプタであるCosminexus RMも使用できます。

リソースマネジャ

リソースを管理する機能です。DBMSなどが該当します。

リダイレクタ

Webサーバに登録しWebコンテナへの接続を可能にするプラグインコンポーネント（ライブラリ）です。Webサーバに登録したリダイレクタによって，リクエストをURLパターンまたはラウンドロビン方式で複数のWebコンテナに振り分けて処理できます。

リデプロイ機能

J2EEアプリケーションを入れ替えるときに使用する機能です。リデプロイ機能による入れ替えは，J2EEアプリケーションのテスト時などに，修正したJ2EEアプリケーションと動作中のJ2EEアプリケーションを入れ替えたいときに使用します。

リバースプロキシサーバ

インターネットなどの外部ネットワークとアプリケーションサーバが配置されている内部ネットワークの間のDMZに配置され，外部ネットワークからのリクエストを内部ネットワークに中継するための機能を持つWebサーバです。

Cosminexusでは，Hitachi Web Serverをリバースプロキシサーバとして使用できます。リバースプロキシサーバには，リバースプロキシモジュールが組み込まれて動作します。

リモートインタフェース

Java RMIのインタフェース規定に従い，RMI-IIOP通信によってEnterprise Beanの呼び出しをするインタフェースです。

リモートホームインタフェースとリモートビジネスインタフェースが含まれます。

リロード機能

開始状態にあるアプリケーションを停止させないで，アプリケーションを構成するクラスやJSPを，少ない手順で動的に入れ替える機能です。

ルートアプリケーション情報

性能解析トレースに出力される情報です。イベントで一連の処理の先頭になるプロセスで取得した情報です。

ルートコンテキスト

コンテキストルートが空文字（コンテキストルートに名称が指定されていない）の，WARファイル内のルートパスです。

ルートリソースアダプタ

コネクションプールをクラスタ構成にしている場合に，メンバリソースアダプタを束ね，ユーザプログラムからのリクエストを受け付けるアダプタのことです。

レルム

統合ユーザ管理をしているシステムで，同一の認証ポリシーを適用する範囲のことです。

ローカルインタフェース

Enterprise Beanの呼び出しをJavaのメソッド呼び出しで実行するインタフェースです。通信は発生しません。

ローカルホームインタフェースとローカルビジネスインタフェースが含まれます。

ローカルトランザクション

接続先のリソースマネジャによって管理されるトランザクションです。単一のリソースだけがトランザクションに参加できます。

ロードバランサ

リダイレクタを使用してリクエストを振り分ける場合に使用するワーカ定義のうち，クラスタ構成の場合に使用する特殊なワーカ定義です。振り分け先のWebコンテナのリストが定義されています。リダイレクタでは，この定義を基に，ラウンドロビン方式でリクエストの振り分け処理をします。

ロール

コンテキストに対し，アクセス制御するときに使用される単位です。ロールはグループごとに定義されます。また，アクセス制御するコンテキストについては，そのコンテキストにアクセスするのに必要なロールが定義されます。アクセスしたユーザの持つロールがコンテキストに定義されたロールと一致した場合，そのコンテキストへのアクセスは成功します。

ロガー

J2EEアプリケーション，バッチアプリケーション，またはEJBクライアントアプリケーションのログを取得する，JavaロギングAPIのLoggerオブジェクトです。

ログインモジュール

JAASに準拠した統合ユーザ管理のユーザ認証に使用する，JAAS APIのLoginModuleインタフェースの実装クラスです。

論理コネクション

サーブレットやEnterprise BeanなどのJ2EEコンポーネントが直接操作するコネクションです。

リソースアダプタの場合はjavax.resource.cci.Connection，JDBCの場合はjava.sql.Connectionに該当します。

論理サーバ

Management Serverの運用管理の対象になる，サーバまたはクラスタです。サーバには，Webサーバ，J2EEサーバなどがあります。クラスタとは，ある共通の機能を提供するサーバの集合です。

論理ネーミングサービス

JNDIがラウンドロビン検索の対象にする複数のCORBAネーミングサービスのことです。

論理ユーザサーバ

任意のサービスやプロセスをManagement Serverの管理対象として定義した論理サーバです。Management Serverで起動・停止したり，ステータス監視したりできるようになります。

（ワ行）

ワーカプロセス

Webサーバの背後で動作するWebコンテナのプロセスです。リダイレクタから見た場合のWebコンテナ実行プロセスになります。具体的には，J2EEサーバまたはWebコンテナサーバに当たります。

索引

[記号]
[数字]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｈ][Ｉ][Ｊ][Ｍ][Ｎ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｖ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行][ワ行]

(記号)

-XX:+HitachiJavaClassLibTrace

-XX:+HitachiLocalsInThrowableオプションが指定されている場合

-XX:+HitachiOutOfMemoryStackTrace

-XX:+HitachiVerboseGC

(数字)

1.4モード

1:1系切り替えシステム

1:1系切り替えシステムで計画的に系を切り替える場合の起動と停止

1:1系切り替えシステムで実行できる運用操作

1:1系切り替えシステムでトラブルが発生した場合

1:1系切り替えシステムの起動

1:1系切り替えシステムの起動と停止

1:1系切り替えシステムの停止

(英字)

(Ａ)

Application Server

(Ｂ)

Bean-Managed Persistence

Bean-Managed Transaction

BJEX

BMP

BMT

(Ｃ)

cjgetsysinfoコマンドの実行によって実行されるOSのコマンド

cjjspcコマンド

cjreloadappコマンド

CMP

CMT

Component Container管理者

Component Container管理者

Component Container管理者

Component Container管理者が実施できるシステム運用時の操作

Component Container管理者による運用に関する留意事項

Component Container管理者を設定している場合にパーミッションが変更されるディレクトリ

Container-Managed Persistence

Container-Managed Transaction

Cookieスイッチング機能

CORBAネーミングサービス

CORBAネーミングサービスのスレッドダンプの取得

coreダンプの生成を示すメッセージの出力内容

Cosminexus

Cosminexus Component Container

Cosminexus Component Transaction Monitor

Cosminexus Component Transaction Monitorのログ

Cosminexus Component Transaction Monitorのログの取得

Cosminexus DABroker Libraryのイベントトレースの出力項目

Cosminexus DABroker Libraryのスプール情報の調査

Cosminexus DABroker Libraryのトレースファイルの運用時の留意事項

Cosminexus DABroker Libraryのログ

Cosminexus DABroker Libraryのログの取得

Cosminexus Operator Plug-in

Cosminexus Performance Tracer

Cosminexus Performance Tracerのログ

Cosminexus Performance Tracerのログの出力先

Cosminexus Performance Tracerのログの取得

Cosminexus Performance Tracerのログの種類

Cosminexus Reliable Messaging

Cosminexusシステム

Cosminexusの作業ディレクトリの内容の取得

Cosminexusのシステムの運用サイクル

Cosminexusの定義情報の取得

Cosminexusのリソース設定情報の取得

Cosminexusのログの調査

Cosminexus標準ログインモジュール

CTM

CTMデーモン

CTMドメイン

CTMドメインマネジャ

CTMの稼働情報を監視する

CTMの稼働統計情報の確認

CTMの稼働統計情報の収集方法

CTMの稼働統計情報の出力先と出力情報

CTMの稼働統計情報の出力例

CTMのコマンド

CTMのスケジュールキューの稼働状況の確認

CTMのスケジュールキューの稼働状況の確認と最大同時実行数の変更

CTMのスケジュールキューの稼働状況の確認と同時実行数の変更

CTMのスケジュールキューの同時実行数の変更

CTMのトレース取得ポイント

CTMレギュレータ

CTMを使用したオンライン状態でのJ2EEアプリケーションの入れ替え

CTMを使用したサービス閉塞

Cヒープが不足した場合

Cヒープが不足した場合のメッセージログの出力項目

Cヒープ不足を示すメッセージログの出力内容

(Ｄ)

DB Connector

DB Connector，JCAコンテナのトレース取得ポイント

DB Connectorの稼働情報ファイルに出力される情報

DD

Dependency Injection

DIターゲット

DTD

(Ｅ)

EARファイル

EIS

EJB

EJB-JARファイル

EJBクライアント

EJBクライアントアプリケーション

EJBクライアントアプリケーションのシステムログに関する留意事項

EJBクライアントアプリケーションのシステムログの出力先

EJBクライアントアプリケーションのシステムログの取得

EJBクライアントアプリケーションのシステムログの種類

EJBクライアントアプリケーションのユーザログの取得

EJBクライアントアプリケーションのログの調査

EJBクライアントでトラブルが発生した場合

EJBコンテナ

EJBコンテナのトレース取得ポイント

EJBタイマ

Enterprise Bean

Enterprise JavaBeans

Entity Bean

Exceptionトレースログ

Exceptionトレースログとして出力される情報

Exceptionトレースログの出力項目

Exceptionトレースログのファイル

(Ｈ)

HAモニタ

HAモニタによる1:1系切り替えシステム

HTTPリクエスト実行待ちキュー枯渇監視情報

(Ｉ)

Inbound

Internal Errorが発生した場合

(Ｊ)

J2EE

J2EEアプリケーション

J2EEアプリケーション実行時間監視で出力されるログ情報

J2EEアプリケーション実行時間の監視機能

J2EEアプリケーションとリソースの管理

J2EEアプリケーションとリソースの管理の概要

J2EEアプリケーションとリソースを保守する

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

J2EEアプリケーションの入れ替えと保守

J2EEアプリケーションの入れ替えと保守

J2EEアプリケーションの稼働状態に応じたパフォーマンスチューニングを実行する

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

J2EEアプリケーションの強制停止に失敗した場合

J2EEアプリケーションの実行時間の監視とキャンセル

J2EEアプリケーションの実行時間の監視とキャンセル

J2EEアプリケーションの実行状態の確認

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

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

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

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

J2EEアプリケーションの停止方法の種類

J2EEアプリケーションの閉塞

J2EEアプリケーションの閉塞と停止

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

J2EEアプリケーションのユーザログ

J2EEアプリケーションを入れ替える

J2EEアプリケーションを入れ替える場合にテストモードを使用する手順

J2EEアプリケーションを運用する

J2EEアプリケーションを開始するときのJSPの事前コンパイル

J2EEアプリケーションを強制停止する

J2EEアプリケーションを停止する

J2EEコンテナ

J2EEコンポーネント

J2EEサーバ

J2EEサーバ・リダイレクタ・サーバ管理コマンドのログの取得

J2EEサーバおよびリダイレクタのログ

J2EEサーバおよびリダイレクタのログ種別

J2EEサーバ起動時に出力されるログ情報

J2EEサーバのスレッドダンプの取得

J2EEサーバのメモリダンプの取得

J2EEサーバモード

J2EEサーバを操作するコマンド

J2EEサービス

J2EEリソース

J2EEリソースアダプタ

jaas.conf

JAASのコンフィグレーションファイル

Java

JavaBeansリソースの入れ替え

JavaBeansリソースの入れ替え

Java Database Connectivity

javagcコマンド

javagcコマンド

Java Naming and Directory Interface

JavaServer Pages

javatrace起動コマンドのコマンドライン

JavaVMが異常終了した場合

JavaVMが出力するメッセージログ

JavaVMが出力するメッセージログの調査（標準出力およびエラーリポートファイル）

JavaVMのガーベージコレクションのログ

JavaVMのガーベージコレクションログの取得

JavaVMのガーベージコレクションログの調査

JavaVMの稼働情報ファイルに出力される情報

JavaVMのスタックトレース

JavaVMのスタックトレース情報の取得

JavaVMのスレッドダンプ

JavaVMのスレッドダンプの取得

JavaVMのスレッドダンプの調査

Javaヒープの使用状況

JavaロギングAPI

JCAコンテナ

JCAリソースの稼働情報ファイルに出力される情報

JDBC

JDBCインタフェースメソッドのトレースの出力項目

JDBCドライバのトレース（Cosminexus DABroker Libraryとのイベントトレース）

JDBCドライバのトレース（JDBCインタフェースメソッドトレース）

JDBCドライバのトレースファイル

JNDI

JNDI名前空間

JNDIのトレース取得ポイント

JP1

JP1/AJS2

JP1/AJS2 - SO

JP1/AJS2と連携したシステムでのトラブルへの対処

JP1/Cm2/NC - Manager

JP1/Cm2/NC - Manager for Cosminexus

JP1/IM

JP1/IM - CM

JP1/IMと連携したシステムでのトラブルへの対処

JP1/NETM/Audit

JP1/SC/DPM

JP1イベント

JP1ジョブ運用管理サーバ

JP1統合運用管理サーバ

JP1と連携したシステムでトラブルが発生した場合

JSP

JSP EL

JSPコンパイル結果

JSP事前コンパイル

JSP事前コンパイル機能

JSPタグライブラリ

JTAのトレース取得ポイント

(Ｍ)

Management Server

Management Server

Management Serverによる運用管理の概要

Managementアクション

Managementアクション

Managementアクション

Managementイベント

Managementイベント

Managementイベント

Managementイベント発行ログ

Managementイベント発行ログ

Message-driven Bean

Message-driven Beanの稼働情報ファイルに出力される情報

MIBオブジェクト

MIBファイル

Microsoft Cluster Service

mngsvrutil

(Ｎ)

N:1リカバリシステム

N:1リカバリシステムでトラブルが発生した場合

N:1リカバリシステムの起動

N:1リカバリシステムの起動

N:1リカバリシステムの起動と停止

N:1リカバリシステムの起動と停止

N:1リカバリシステムの停止

N:1リカバリシステムの停止

N秒

(Ｏ)

Object Transaction Service

Oracle RAC

ORBゲートウェイ

OSの状態・ログ

OSの状態情報およびOSのログの調査

OSの状態情報とOSのログの取得

OSの統計情報

OSの統計情報の取得

OSのログの取得

OTMゲートウェイ

OTS

OTSのトレース取得ポイント

Outbound

(Ｐ)

PRFデーモン

PRFトレース

PRFトレース出力ライブラリ

PRFトレース取得レベル

PRFトレース取得レベル

PRFトレース取得レベル

PRFトレース取得レベル

PRFトレース取得レベル〔BMT〕

PRFトレース取得レベル〔CMT〕

PRFトレース取得レベル〔CTM〕

PRFトレース取得レベル〔DB Connector〕

PRFトレース取得レベル〔DB Connector〕

PRFトレース取得レベル〔DB Connector for Cosminexus RM〕

PRFトレース取得レベル〔J2EEサーバ〕

PRFトレース取得レベル〔JNDI〕

PRFトレース取得レベル〔Message-driven Bean（EJB2.0）〕

PRFトレース取得レベル〔Message-driven Bean（EJB2.1）〕

PRFトレース取得レベル〔OTS〕

PRFトレース取得レベル〔RMI〕

PRFトレース取得レベル〔Session Bean・Entity Bean〕

PRFトレース取得レベル〔Webコンテナ〕

PRFトレース取得レベル〔Webコンテナ〕

PRFトレース取得レベル〔インプロセスHTTPサーバ〕

PRFトレース取得レベル〔コネクションアソシエーション〕

PRFトレース取得レベル〔コネクション自動クローズ時〕

PRFトレース取得レベル〔セッションフェイルオーバ機能〕

PRFトレース取得レベル〔トランザクションタイムアウト〕

PRFトレース取得レベル〔バッチアプリケーション実行機能〕

PRFトレース取得レベル〔フィルタのトレース（正常に処理が終了した場合）〕

PRFトレース取得レベル〔フィルタのトレース（例外が発生した場合）〕

PRFトレース取得レベル〔リダイレクタ〕

PRFトレース取得レベル〔ワーク管理〕

PRFトレースファイル

PRFトレースファイル

PRFトレースファイル

PRFトレースファイル

PRFのコマンド

(Ｒ)

RMI-IIOP

RMIのトレース取得ポイント

(Ｓ)

SecurityManager

Server Plug-in

Server Plug-in

Session Bean

SFOサーバ

SFOサーバアプリケーション

siginfo情報（UNIXの場合）

Smart Composer機能

Smart Composer機能

Smart Composer機能

snapshotlog.2.conf

snapshotlog.conf

snapshotログ

snapshotログ

snapshotログ

snapshotログとして収集できる資料

snapshotログの収集

snapshotログの収集対象一覧

SNMP連携用形式ファイル

Stateful Session Bean

Stateful Session Beanの稼働情報ファイルに出力される情報

Stateless Session Bean

Stateless Session Beanの稼働情報ファイルに出力される情報

syslog

syslog

syslogの出力形式と出力項目（UNIXの場合）

(Ｔ)

Timer Service

(Ｕ)

ua.conf

uCosminexus Batch Job Execution Server

uCosminexus Client

uCosminexus Operator

URLグループの稼働情報ファイルに出力される情報

usrconf.properties

(Ｖ)

VMの状態

(Ｗ)

WARファイル

Webアプリケーション

Webアプリケーション（WebAP1）の最大同時実行スレッド数の動的変更の設定例

Webアプリケーション単位の稼働状態でのパフォーマンスチューニング

Webアプリケーションの稼働状況の確認

Webアプリケーションの稼働情報ファイルに出力される情報

Webアプリケーションの最大同時実行スレッド数の設定変更

Webアプリケーションの最大同時実行スレッド数の動的変更

Webアプリケーションの最大同時実行スレッド数を変更する場合に参考になる情報

Webクライアント構成の例

Webコンテナ

Webコンテナサーバ

Webコンテナサーバの起動

Webコンテナサーバの停止

Webコンテナの稼働情報ファイルに出力される情報

Webコンテナのトレース取得ポイント

Webコンテナのトレース取得ポイント

Webコンテナのトレース取得ポイント（セッションフェイルオーバ機能のトレース）

Webサーバ

Webサーバで収集した性能解析トレースファイルの例

Webサーバのレスポンスタイムの解析

Webサーバのログ

Webサーバ連携

Webサーバログの取得

Webシステム

Webフロントシステムで実行できるサービス閉塞

Webフロントシステムでのサービス閉塞

(Ｘ)

XAトレースの取得形式

(ア行)

(あ)

アーカイブ形式

アウトプロセス

アクセス状況に応じたWebアプリケーションの最大同時実行数の動的変更

アクセス状況に応じた一時的なWebアプリケーション単位の最大同時実行スレッド数の変更

アクセスログの出力項目

アセンブル

アノテーション

アプリケーションサーバ

アプリケーションサーバで収集した性能解析トレースファイルをフィルタリングした例

アプリケーションサーバ内でのリクエストの処理状況の調査

アプリケーションサーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止

アプリケーションサーバを対象にした1:1系切り替えシステム

アプリケーションサーバを対象にした1:1系切り替えシステムで計画的に系を切り替えるときの起動と停止

アプリケーションサーバを対象にした1:1系切り替えシステムの起動

アプリケーションサーバを対象にした1:1系切り替えシステムの起動と停止

アプリケーションサーバを対象にした1:1系切り替えシステムの停止

アプリケーションサーバを対象にした1:1系切り替えシステムをメンテナンスする場合の起動と停止

アプリケーションのユーザログの取得

アプリケーションのユーザログの取得

アプレット

(い)

移行コマンド（cjenvupdate）のログ

移行コマンド（cjenvupdate）のログ

移行コマンド（cjenvupdate）のログ

異常終了とシグナル種別

異常停止

一次送付資料

一次送付資料

イベントトレース

イベントリスナ

イベントログ

イベントログ

イベントログの出力形式と出力項目（Windowsの場合）

入れ替えるJ2EEアプリケーション内のJSPの事前コンパイル

インプロセス

インプロセスHTTPサーバ

インプロセスHTTPサーバのアクセスログの出力形式と出力項目

インプロセスHTTPサーバのログ

インプロセスHTTPサーバのログ

インプロセスHTTPサーバのログ

インプロセストランザクションサービスを使用している場合

(う)

運用監視エージェント

運用監視作業の概要

運用管理エージェント

運用管理エージェント，運用監視エージェント，およびManagement Serverのログの出力先

運用管理エージェント・運用監視エージェント・Management Serverのログ

運用管理エージェント・運用監視エージェント・Management Serverのログの取得

運用管理エージェント・運用監視エージェント・Management Serverのログの取得

運用管理コマンド

運用管理コマンド（mngsvrutil）

運用管理コマンド（mngsvrutil）

運用管理コマンド（mngsvrutil）を利用する場合の留意事項

運用管理サーバ

運用管理サーバの1:1系切り替えシステムをメンテナンスする場合の起動と停止

運用管理サーバモデル

運用管理サーバを対象にした1:1系切り替えシステム

運用管理サーバを対象にした1:1系切り替えシステムで計画的に系を切り替えるときの起動と停止

運用管理サーバを対象にした1:1系切り替えシステムの起動

運用管理サーバを対象にした1:1系切り替えシステムの起動と停止

運用管理サーバを対象にした1:1系切り替えシステムの停止

運用管理ドメイン

運用管理ドメイン

運用管理ポータル

運用管理ポータル

運用管理ポリシー

(え)

エラートレース

エラートレースのエラー事象を示す情報の出力項目

エラートレースのデータベース接続情報の出力項目

エラートレースの履歴情報の出力項目

エラートレースファイル

エラーページのカスタマイズ

エラーメッセージ出力

エラーリポートファイル

エラーリポートファイル

エラーリポートファイルの出力先

エラーリポートファイルの出力先

(カ行)

(か)

ガーベージコレクション制御機能

回復中

拡張verbosegc情報の取得

拡張verbosegc情報の取得を指定するオプション

拡張スレッドダンプ

拡張スレッドダンプ

拡張データベースアクセストレース

拡張データベースアクセストレースの出力項目

拡張データベースアクセストレースファイル

拡張データベーストレースのファイル名称の規則

カスタムジョブ

カスタムログインモジュール

仮想サーバ

稼働情報監視で確認できる項目

稼働情報監視で表示できる項目（J2EEサーバの場合）

稼働情報監視で表示できる項目（SFOサーバの場合）

稼働情報監視で表示できる項目（バッチサーバの場合）

稼働情報収集機能

稼働情報として監視できる項目

稼働情報の監視（運用管理コマンド）

稼働情報の監視（稼働情報ファイル）

稼働情報ファイル

稼働情報ファイルで収集できる情報

稼働情報ファイルの出力

稼働情報ファイルの出力間隔とファイル面数

稼働情報ファイルの出力先

稼働情報ファイルの調査

稼働情報ファイルのファイル名

稼働中

稼働中のトランザクションの確認

稼働統計出力ファイル

稼働統計出力ファイルに出力される情報

稼働統計出力ファイルの出力先

稼働統計出力ファイル名

稼働統計出力ファイル名

稼働統計情報の出力情報

カレントスレッド情報

簡易Webサーバ

環境変数

監査証跡

監査ログ

監査ログで出力するログ

監視ツリー

管理対象オブジェクト（AdminObject）

(き)

起動順序の依存関係

起動順序の依存関係

起動中

機能ごとに取得できる稼働情報の種類

機能レイヤ

機能レイヤ

機能レイヤ

強制停止

強制停止中

強制閉塞

業務指向ツリー

業務処理プログラム

共有スレッド数

(く)

クライアントアプリケーション情報

クラスタ

クラスタ構成のデータベースのメンテナンス

クラスタコネクションプールの運用

クラスタソフトウェア

クラスタソフトウェアを使用したシステムの起動と停止（UNIXの場合）

クラスタソフトウェアを使用したシステムの起動と停止（Windowsの場合）

クラスまたは配列型の変数の実際の型名を出力する場合の出力例

クラスまたは配列型の変数を文字列として出力する場合の出力例

グローバルCORBAネーミングサービス

グローバルセッション

グローバルセッションID

グローバルセッションID

グローバルセッション情報

グローバルセッションの有効期間の確認

グローバルトランザクション

(け)

系

計画系切り替え

計画停止中

系切り替え

系障害

ゲートウェイ指定機能

現用系

現用系

現用系

現用系

(こ)

構成ソフトウェアのプロセス（論理サーバ）が異常終了した場合

構築済み実行環境の切り替えで出力するログ

構築済み実行環境の切り替えで出力するログの出力形式と出力項目（UNIXの場合）

構築済み実行環境の切り替えで出力するログの取得

コネクションID

コネクションスイーパ

コネクションプーリング

コネクションプール枯渇監視情報

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

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

コネクションプールの状態によるコマンド実行の可否

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

コマンドおよびVMパラメタ

コマンドによってメソッドキャンセルを実行した場合に出力されるログ情報

コミットオプション

コンソールログ

コンテキスト

コンテキストルート

コンテナ拡張ライブラリ

(サ行)

(さ)

サーバ管理コマンド

サーバ管理コマンド

サーバ管理コマンドのログ

サーバ管理コマンドのログ

サーバ管理コマンドのログ

サーバ管理コマンドのログの出力先（互換モード）

サーバ管理コマンドのログの出力先（互換モード）

サーバ管理コマンドを利用する場合の留意事項

サーバ起動・停止フック機能

サーバ指向ツリー

サーバの稼働情報の監視方法（J2EEサーバ，SFOサーバ，バッチサーバ）

サーバプロセスを操作する機能

サービス部分閉塞

サービス閉塞

サービス閉塞

サービスユニット

サーブレット

サーブレットエンジンモード

サーブレットフィルタ

最大同時実行スレッド数を動的に変更したときのWebアプリケーションの動作

作業ディレクトリ

作業ディレクトリ

サンプリング時間

(し)

時間情報

時間帯に応じた計画的なWebアプリケーション単位の最大同時実行スレッド数の変更

シグナル情報

シグナル情報の格納先アドレス

システム運用の概要

システム運用の作業

システム運用の特長

システムごとに実行できるサービスの閉塞方法およびJ2EEアプリケーションの停止方法

システムダウン

システムで提供されている障害検知時コマンドで出力できる資料

システムの運用サイクル（J2EEサーバモードの場合）

システムの運用サイクルを構成する作業

システムの運用状況を監視する

システムの運用で使用する機能

システムの処理性能の解析

システムの処理性能を監視する

システム保守の作業

システム名，CPU，実メモリ，およびVM情報

システムモニタの設定

システムを起動／停止する

実行系

実行系

実行系

実行系

実行系

実行系

実行待ちキュー

実パラメタ

自動系切り替え

自動再起動中

自動停止中

自動で資料を収集する場合の流れ

シナリオ

出力される情報の種類

取得が必要な資料の一覧

取得が必要な資料の取得方法と調査方法の参照先

取得が必要な資料の種類

取得できるイベントIDと機能レイヤ

取得できるトレース情報〔BMT〕

取得できるトレース情報〔CMT〕

取得できるトレース情報〔CTM〕

取得できるトレース情報〔DB Connector〕

取得できるトレース情報〔DB Connector〕

取得できるトレース情報〔DB Connector for Cosminexus RM〕

取得できるトレース情報〔J2EEサーバ〕

取得できるトレース情報〔JNDI〕

取得できるトレース情報〔Message-driven Bean（EJB2.0）〕

取得できるトレース情報〔Message-driven Bean（EJB2.1）〕

取得できるトレース情報〔OTS〕

取得できるトレース情報〔RMI〕

取得できるトレース情報〔Session Bean・Entity Bean〕

取得できるトレース情報〔Webコンテナ〕

取得できるトレース情報〔Webコンテナ〕

取得できるトレース情報〔インプロセスHTTPサーバ〕

取得できるトレース情報〔コネクションアソシエーション〕

取得できるトレース情報〔コネクション自動クローズ時〕

取得できるトレース情報〔セッションフェイルオーバ機能〕

取得できるトレース情報〔トランザクションタイムアウト〕

取得できるトレース情報〔バッチアプリケーション実行機能〕

取得できるトレース情報〔フィルタのトレース（正常に処理が終了した場合）〕

取得できるトレース情報〔フィルタのトレース（例外が発生した場合）〕

取得できるトレース情報〔リダイレクタ〕

取得できるトレース情報〔ワーク管理〕

障害検知時コマンド

障害検知時コマンドで出力できる資料

障害発生時のCMR用の表の回復

ジョブ

ジョブネット

処理性能の解析作業の概要

資料の個別取得

資料の取得方法

資料の調査

シングルサインオン

シングルサインオン情報リポジトリ

シングルサインオンライブラリ

(す)

スケールアウト

スケールイン

スケジュールキュー

スケジュールポリシー

スタックトレース

スタックトレース情報

スタックトレースにローカル変数情報を出力するためのオプション

スタックトレースの調査

スタックの先頭から格納されている情報

ステータス監視で確認できる項目

ステータスの監視方法

ステートメントキャンセル

スマートエージェント

スレッド枯渇監視情報

スレッド作成に失敗した場合

スレッド情報

スレッドダンプ枯渇監視情報

スレッドダンプ情報の構成

スレッドの状態とメソッドキャンセルの実行可否

スローダウン

(せ)

静的コンテンツ

性能解析トレース

性能解析トレース

性能解析トレースの取得

性能解析トレースの調査

性能解析トレースファイル

性能解析トレースファイル

性能解析トレースファイル

性能解析トレースファイル

性能解析トレースファイルとスレッドダンプを対応づけた問題個所の調査

性能解析トレースファイルに出力する情報

性能解析トレースファイルの収集

性能解析トレースファイルの収集

性能解析トレースファイルの収集方法

性能解析トレースファイルの出力先

性能解析トレースファイルの出力先と出力情報

性能解析トレースファイルの出力情報

性能解析トレースファイルのファイル

性能解析トレースファイルをフィルタリングした例

性能解析トレースファイルを利用したシステムの処理性能の解析

セキュリティアイデンティティ

セッション

セッション数枯渇監視情報

セッショントレース

セッショントレース情報が出力されている性能解析トレースファイルの例（セッションを生成するリクエスト部分）

セッショントレース情報が出力されている性能解析トレースファイルの例（セッションを破棄するリクエスト部分）

セッショントレース情報が出力されている性能解析トレースファイルの例（セッションを利用するリクエスト部分）

セッションの有効期間の確認

セッションのライフサイクルの調査

セッションフェイルオーバ機能

セッションフェイルオーバ機能でトラブルが発生した場合

セッションフェイルオーバサーバ

セットアップウィザード

占有スレッド数

(そ)

相互系切り替えシステム

相互系切り替えシステムで計画的に系を切り替える場合の起動と停止

相互系切り替えシステムで計画的に系を切り替える場合の起動と停止

相互系切り替えシステムの起動

相互系切り替えシステムの起動

相互系切り替えシステムの起動と停止

相互系切り替えシステムの起動と停止

相互系切り替えシステムの起動の流れ

相互系切り替えシステムのシステム構成例

相互系切り替えシステムの停止

相互系切り替えシステムの停止

相互系切り替えシステムの停止の流れ

相互スタンバイ

(タ行)

(た)

待機系

待機系

待機系

待機系

待機系

待機系

タイムアウトが発生したトランザクションの特定

タイムアウトが発生したリクエストのキャンセル

タイムアウトが発生したリクエストの特定

タイムアウトしたリクエストを確認するために使用できる性能解析トレース

タイムアウトしたリクエストをキャンセルする

タイムアウトの延長でメソッドキャンセルを実行した場合に出力されるログ情報

(ち)

抽象パラメタ

(つ)

通常停止

通常のサービス閉塞

通常の閉塞

通常モード

通常モード

通信障害

(て)

定義情報

停止

停止中

停止中のトランザクションの確認

データソース

データベースと接続中にトラブルが発生したコネクションの特定

データベースと接続中にトラブルが発生した場合

テストモード

テストモード

テストモードで実行できるサーバ管理コマンド

テストモードで実行できるサーバ管理コマンド

テストモードでのJ2EEアプリケーションの運用

デフォルトのタイムアウト時間で通常停止を実行して，停止しなかった場合に強制停止を実行する

デフォルトのタイムアウト時間で通常停止を実行する

デプロイ

展開ディレクトリ形式

(と)

統合コンソール

統合スコープ

統合ネーミングスケジューラサーバ

統合ネーミングスケジューラサーバモデル

統合ユーザ管理

統合ユーザ管理GUI

統合ユーザ管理のコンフィグレーションファイル

統合ユーザ管理のログの取得

統合ユーザ管理フレームワーク

統合ログ

統合ログの出力先

動作モード

動的コンテンツ

登録済みシグナルハンドラ

トラブルが発生したコネクションの特定

トラブルシューティング

トラブルシューティングに関連する留意事項

トラブル種別ごとの取得資料一覧

トラブルに対処する

トラブル発生時に自動的に取得できる資料

トラブル発生時に資料を収集するための準備

トラブル発生時の対処の流れ

トラブルへの対処と回復

トランザクションサービス

トランザクションサービスの稼働情報ファイルに出力される情報

トランザクション情報の確認

トランザクションタイムアウト時に出力される性能解析トレース

トランザクションの状態を確認する

トランザクションマネジャ

トレース取得ポイント

トレース取得ポイント

トレース取得ポイント

トレース取得ポイント

トレース取得ポイント〔BMT〕

トレース取得ポイント〔CMT〕

トレース取得ポイント〔CTM〕

トレース取得ポイント〔DB Connector〕

トレース取得ポイント〔DB Connector〕

トレース取得ポイント〔DB Connector for Cosminexus RM〕

トレース取得ポイント〔J2EEサーバ〕

トレース取得ポイント〔JNDI〕

トレース取得ポイント〔Message-driven Bean（EJB2.0）〕

トレース取得ポイント〔Message-driven Bean（EJB2.1）〕

トレース取得ポイント〔OTS〕

トレース取得ポイント〔RMI〕

トレース取得ポイント〔Session Bean・Entity Bean〕

トレース取得ポイント〔Webコンテナ〕

トレース取得ポイント〔Webコンテナ〕

トレース取得ポイント〔インプロセスHTTPサーバ〕

トレース取得ポイント〔コネクションアソシエーション〕

トレース取得ポイント〔コネクション自動クローズ時〕

トレース取得ポイント〔セッションフェイルオーバ機能〕

トレース取得ポイント〔トランザクションタイムアウト〕

トレース取得ポイント〔フィルタのトレース（正常に処理が終了した場合）〕

トレース取得ポイント〔フィルタのトレース（例外が発生した場合）〕

トレース取得ポイント〔リダイレクタ〕

トレース取得ポイント〔ワーク管理〕

(ナ行)

(に)

二次送付資料

二次送付資料

任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に強制停止を実行する

任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に自動的に強制停止を実行する

任意のタイムアウト時間を設定して通常停止を実行する

(ね)

ネーミング切り替え

ネーミングサービス

(ハ行)

(は)

バインド先アドレス設定機能

バックシステム（CTMを使用している場合）で実行できるサービス閉塞

バックシステムでのサービス閉塞（CTMを使用しているシステムの場合）

バッチアプリケーション

バッチアプリケーションのユーザログの出力先

バッチサーバ

バッチサーバのログ

パフォーマンストレーサ

パフォーマンストレーサ

パフォーマンストレーサ

ハングアップ（無応答）

ハンドラ

(ひ)

ビジネスインタフェース

日立JavaVM固有のログの調査（日立JavaVMログファイル）

日立JavaVMログファイル

日立JavaVMログファイル

日立JavaVMログファイルを出力するオプション

日立トレース共通ライブラリ

日立トレース共通ライブラリ形式

日立トレース共通ライブラリ形式（シングルプロセス）

日立トレース共通ライブラリ形式（マルチプロセス）

日立トレース共通ライブラリ形式のログの出力形式と出力項目

日立トレース共通ライブラリ形式のログの出力項目

日立トレース共通ライブラリ形式のログを参照する場合の注意

非保護区

標準出力／標準エラー出力／ユーザログのトレース取得ポイント

標準の形式および簡易出力フォーマットでの出力例

(ふ)

ファイルディスクリプタ枯渇監視情報

フィルタリングに使用するイベントIDが示すトレース取得ポイント

負荷分散機

負荷分散機を利用したサービス部分閉塞

負荷分散機を利用したサービス閉塞

物理コネクション

物理ティア

プロセスの再起動方法

プロセスリソースの稼働情報ファイルに出力される情報

フロント

フロントEJB

フロントEJB

(へ)

ベーシックモード

ヘッダファイル

ヘッダファイルと稼働情報ファイルの対応

別名

(ほ)

保護区

保護区

保守員

保守員に連絡が必要なトラブル

保守用ログ

保守用ログ

保守用ログ

保守レベル

ホスト単位管理モデル

(マ行)

(ま)

マシン情報

(み)

未決着トランザクション

(め)

命令コード情報

メソッドキャンセル機能

メソッドタイムアウト機能

メッセージインフロー

メッセージログ

メッセージログ

メッセージログ

メッセージログ

メモリ枯渇監視情報

メモリ情報

メモリダンプ

メモリダンプの取得

メモリ不足を示すメッセージの出力内容

面数

メンバコネクションプールの状態

メンバコネクションプールの状態遷移（自動で一時停止が実行される場合）

メンバコネクションプールの状態遷移（手動で一時停止を実行する場合）

メンバリソースアダプタ

(ヤ行)

(ゆ)

ユーザが作成した障害検知時コマンドで出力できる情報

ユーザ指定名前空間機能

ユーザ情報

ユーザ情報リポジトリ

ユーザスレッド

ユーザダンプの取得

ユーザ認証ライブラリ

ユーザプロパティファイル

ユーザプロパティファイル

ユーザマッピング

ユーザログ

ユーザログ

ユーザログ

ユーザログ

(よ)

予備系

予備系

予備系

予備系

(ラ行)

(ら)

ライトトランザクション

ライブラリ

ライブラリJAR

ラウンドロビン検索

ラウンドロビンポリシー

(り)

リカバリ専用サーバ

リクエスト処理スレッド

リクエストのスケジューリング

リソースアダプタ

リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

リソース枯渇監視情報

リソース枯渇監視情報に出力される情報

リソース枯渇監視情報の出力形式

リソース枯渇監視のログ

リソース枯渇監視のログ

リソース枯渇監視のログ

リソース枯渇監視ログ

リソース枯渇監視ログ

リソース枯渇監視ログファイル

リソース枯渇の監視

リソースの使用率または使用数を基にリソースの枯渇を監視する

リソースの設定

リソースマネジャ

リソースをメンテナンスする

リダイレクタ

リダイレクタのトレース取得ポイント

リデプロイ

リデプロイ機能

リデプロイによるJ2EEアプリケーションの入れ替え

リバースプロキシサーバ

リモートインタフェース

リロード

リロード機能

リロードによってJ2EEアプリケーションを入れ替えるときのJSPの事前コンパイル

リロードによるJ2EEアプリケーションの入れ替え

(る)

ルートアプリケーション情報

ルートアプリケーション情報を利用したログ調査

ルートコンテキスト

ルートリソースアダプタ

(れ)

例外ログ

例外ログ

例外ログ

レジスタ情報

レルム

(ろ)

ローカルインタフェース

ローカルトランザクション

ローカル変数

ローカル変数情報

ロードバランサ

ロール

ロガー

ログ以外に取得が必要な情報

ログ以外に取得が必要な情報

ログインモジュール

ログの出力先

ログの出力先

ログの出力先

ログの出力先

ログの出力先

ログの出力先を設定するユーザ定義ファイル

ログの出力先を設定するユーザ定義ファイル

ログの出力先を設定するユーザ定義ファイル（サーブレットエンジンモードの場合）

論理コネクション

論理サーバ

論理サーバ

論理サーバのステータスの監視

論理ネーミングサービス

論理ユーザサーバ

(ワ行)

(わ)

ワーカプロセス

ワトソンログが正しく出力されたかどうかを示すメッセージの出力内容

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
cBank，cFramework，cContentsTemplate，cInputCheck，cLogWrapper，cPersistence，cSQLBuilder，cValidator，Eclipse Plugin For cFrameworkは，株式会社イーシー・ワンの日本における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JDKは，米国 Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft Office Excelは，米国 Microsoft Corporation の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle8iは，米国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. の米国およびその他の国における商標または登録商標です。
Sunは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun，Sun Microsystems，Javaは，米国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 の英国ならびに他の国における登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
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.が著作権を有している部分が含まれています。