Cosminexus V11 アプリケーションサーバ 機能解説 保守／移行編

解説書

3021-3-J11-30

前書き

対象製品

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

輸出時の注意

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

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

商標類

HITACHI，Cosminexus，DABroker，HAモニタ，HiRDB，JP1，OpenTP1，TPBroker，uCosminexusは，株式会社 日立製作所の商標または登録商標です。

Active Directoryは，マイクロソフト 企業グループの商標です。

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

AMDは，Advanced Micro Devices,Inc.の商標です。

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

Internet Explorerは，マイクロソフト 企業グループの商標です。

Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。

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

OracleおよびJavaは，オラクルおよびその関連会社の登録商標です。

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hatは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

Red Hat Enterprise Linux is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hat Enterprise Linuxは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

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

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

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

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

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

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

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

マイクロソフト製品のスクリーンショットの使用について

マイクロソフトの許可を得て使用しています。

発行

2022年 3月 3021-3-J11-30

著作権

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

変更内容

変更内容(3021-3-J11-30) uCosminexus Application Server 11-20，uCosminexus Client 11-20，uCosminexus Developer 11-20，uCosminexus Service Architect 11-20，uCosminexus Service Platform 11-20

追加・変更内容

変更個所

Java EE 8に対応した。

1.1，12.1，12.2.2

アプリケーションサーバが対応している標準仕様に，JAX-RS 2.1を追加した。

1.1.3，8.26.2，10.3.4，12.2.2，12.3.4

アプリケーションサーバが対応している標準仕様に，JPA 2.2を追加した。

1.1.3，10.3.3，10.3.4，12.3.5

アプリケーションサーバが対応している標準仕様に，JSON-B 1.0を追加した。

1.1.3，10.3.4，12.2.2

アプリケーションサーバ 11-20での主な機能変更についての説明を追加した。

1.4

アプリケーションサーバが対応している標準仕様に，JSF 2.3を追加した。

7.2.1(2)，8.1，8.2.1(2)，8.2.2，8.22，8.22.1，8.22.2，8.23.1，10.3.4，12.2.2，12.3.6(1)

アプリケーションサーバが対応している標準仕様に，Servlet 4.0を追加した。

8.4.1，8.4.2，10.3.3(3)

旧バージョンのアプリケーションサーバからの移行に関する記載を変更した。

10.1，10.1.1，10.1.2，10.2.1，10.2.2，10.13.3

CDI Managed BeanでのJPA利用に対応した。

10.3.3(2)

アプリケーションサーバが対応している標準仕様に，WebSocket 1.1を追加した。

10.3.4，12.2.1，12.2.2

アプリケーションサーバが対応している標準仕様に，JSON-P 1.1を追加した。

10.3.4，12.2.2

アプリケーションサーバが対応している標準仕様に，CDI 2.0を追加した。

10.3.4，12.2.2，12.3.3

J2EEサーバのusrconf.propertiesに自動的に追加される定義について，説明を追加した。

10.13.2

アプリケーションサーバが対応している標準仕様に，Bean Validation 2.0を追加した。

12.2.2

マニュアル訂正の内容を反映した。

−

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

はじめに

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

1　アプリケーションサーバの機能

この章では，アプリケーションサーバの機能の分類と目的，および機能とマニュアルの対応について説明します。また，このバージョンで変更した機能についても説明しています。

1.1　機能の分類

アプリケーションサーバは，Java EE 8に対応したJ2EEサーバを中心としたアプリケーションの実行環境を構築したり，実行環境上で動作するアプリケーションを開発したりするための製品です。Java EEの標準仕様に準拠した機能や，アプリケーションサーバで独自に拡張された機能など，多様な機能を使用できます。目的や用途に応じた機能を選択して使用することで，信頼性の高いシステムや，処理性能に優れたシステムを構築・運用できます。

アプリケーションサーバの機能は，大きく分けて，次の二つに分類できます。

アプリケーションの実行基盤としての機能

アプリケーションの実行基盤を運用・保守するための機能

二つの分類は，機能の位置づけや用途によって，さらに詳細に分類できます。アプリケーションサーバのマニュアルは，機能の分類に合わせて提供しています。

アプリケーションサーバの機能の分類と対応するマニュアルについて，次の図に示します。

図1‒1　アプリケーションサーバの機能の分類と対応するマニュアル

注※1

マニュアル名称の「アプリケーションサーバ」を省略しています。

注※2

アプリケーションサーバでは，SOAP WebサービスとRESTful Webサービスを実行できます。目的によっては，マニュアル「アプリケーションサーバ Webサービス開発ガイド」以外の次のマニュアルも参照してください。

SOAPアプリケーションを開発・実行する場合

アプリケーションサーバ SOAPアプリケーション開発の手引

SOAP WebサービスやSOAPアプリケーションのセキュリティを確保する場合

XML Security - Core ユーザーズガイド

アプリケーションサーバ Webサービスセキュリティ構築ガイド

XMLの処理について詳細を知りたい場合

XML Processor ユーザーズガイド

ここでは，機能の分類について，マニュアルとの対応と併せて説明します。

1.1.1　アプリケーションの実行基盤としての機能

アプリケーションとして実装されたオンライン業務やバッチ業務を実行する基盤となる機能です。システムの用途や求められる要件に応じて，使用する機能を選択します。

アプリケーションの実行基盤としての機能を使用するかどうかは，システム構築やアプリケーション開発よりも前に検討する必要があります。

アプリケーションの実行基盤としての機能について，分類ごとに説明します。

(1)　アプリケーションを動作させるための基本的な機能（基本・開発機能）

アプリケーション（J2EEアプリケーション）を動作させるための基本的な機能が該当します。主にJ2EEサーバの機能が該当します。

アプリケーションサーバでは，Java EE 8に対応したJ2EEサーバを提供しています。J2EEサーバでは，標準仕様に準拠した機能のほか，アプリケーションサーバ独自の機能も提供しています。

基本・開発機能は，機能を使用するJ2EEアプリケーションの形態に応じて，さらに三つに分類できます。アプリケーションサーバの機能解説のマニュアルは，この分類に応じて分冊されています。

それぞれの分類の概要を説明します。

Webアプリケーションを実行するための機能（Webコンテナ）

Webアプリケーションの実行基盤であるWebコンテナの機能，およびWebコンテナとWebサーバが連携して実現する機能が該当します。

Enterprise Beanを実行するための機能（EJBコンテナ）

Enterprise Beanの実行基盤であるEJBコンテナの機能が該当します。また，Enterprise Beanを呼び出すEJBクライアントの機能も該当します。

WebアプリケーションとEnterprise Beanの両方で使用する機能（コンテナ共通機能）

Webコンテナ上で動作するWebアプリケーションおよびEJBコンテナ上で動作するEnterprise Beanの両方で使用できる機能が該当します。

(2)　Webサービスを開発するための機能

Webサービスの実行環境および開発環境としての機能が該当します。

アプリケーションサーバでは，次のエンジンを提供しています。

JAX-WS仕様に従ったSOAPメッセージのバインディングを実現するJAX-WSエンジン

JAX-RS仕様に従ったRESTful HTTPメッセージのバインディングを実現するJAX-RSエンジン

(3)　信頼性や性能などを向上させるために拡張されたアプリケーションサーバ独自の機能（拡張機能）

アプリケーションサーバで独自に拡張された機能が該当します。バッチサーバ，CTM，データベースなど，J2EEサーバ以外のプロセスを使用して実現する機能も含まれます。

アプリケーションサーバでは，システムの信頼性を高め，安定稼働を実現するための多様な機能が拡張されています。また，J2EEアプリケーション以外のアプリケーション（バッチアプリケーション）をJavaの環境で動作させる機能も拡張しています。

(4)　システムのセキュリティを確保するための機能（セキュリティ管理機能）

アプリケーションサーバを中心としたシステムのセキュリティを確保するための機能が該当します。不正なユーザからのアクセスを防止するための認証機能や，通信路での情報漏えいを防止するための暗号化機能などがあります。

1.1.2　アプリケーションの実行基盤を運用・保守するための機能

アプリケーションの実行基盤を効率良く運用したり，保守したりするための機能です。システムの運用開始後に，必要に応じて使用します。ただし，機能によっては，あらかじめ設定やアプリケーションの実装が必要なものがあります。

アプリケーションの実行基盤を運用・保守するための機能について，分類ごとに説明します。

(1)　システムの起動・停止など日常的な運用をするための機能（運用機能）

システムの起動や停止，アプリケーションの開始や停止，入れ替えなどの，日常運用で使用する機能が該当します。

(2)　システムの利用状況を監視するための機能（監視機能）

システムの稼働状態や，リソースの枯渇状態などを監視するための機能が該当します。また，システムの操作履歴など，監査で使用する情報を出力する機能も該当します。

(3)　ほかの製品と連携して運用するための機能（連携機能）

JP1やクラスタソフトウェアなど，ほかの製品と連携して実現する機能が該当します。

(4)　トラブル発生時などに対処するための機能（保守機能）

トラブルシューティングのための機能が該当します。トラブルシューティング時に参照する情報を出力するための機能も含みます。

(5)　旧バージョンの製品から移行するための機能（移行機能）

旧バージョンのアプリケーションサーバから新しいバージョンのアプリケーションサーバに移行するための機能が該当します。

(6)　旧バージョンの製品との互換のための機能（互換機能）

旧バージョンのアプリケーションサーバとの互換用の機能が該当します。なお，互換機能については，対応する推奨機能に移行することをお勧めします。

1.1.3　機能とマニュアルの対応

アプリケーションサーバの機能解説のマニュアルは，機能の分類に合わせて分冊されています。

機能の分類と，それぞれの機能について説明しているマニュアルとの対応を次の表に示します。

表1‒1　機能の分類と機能解説のマニュアルの対応

分類

機能

マニュアル※1

基本・開発機能

Webコンテナ

基本・開発編(Webコンテナ)

JSFおよびJSTLの利用

JAX-RS 2.1の利用

WebSocket

NIO HTTPサーバ

サーブレットおよびJSPの実装

セッションマネージャの指定機能

EJBコンテナ

基本・開発編(EJBコンテナ)

EJBクライアント

Enterprise Bean実装時の注意事項

ネーミング管理

基本・開発編(コンテナ共通機能)

リソース接続とトランザクション管理

OpenTP1からのアプリケーションサーバの呼び出し（TP1インバウンド連携機能）

JPA 2.2の利用

CJMSプロバイダ

JavaMailの利用

アプリケーションサーバでのCDIの利用

アプリケーションサーバでのBean Validationの利用

Java Batch

JSON-P

JSON-B

Concurrency Utilities

アプリケーションの属性管理

アノテーションの使用

J2EEアプリケーションの形式とデプロイ

コンテナ拡張ライブラリ

ライブラリ競合回避機能

拡張機能

バッチサーバによるアプリケーションの実行

拡張編

CTMによるリクエストのスケジューリングと負荷分散

バッチアプリケーションのスケジューリング

J2EEサーバ間のセッション情報の引き継ぎ（セッションフェイルオーバ機能）

データベースセッションフェイルオーバ機能

明示管理ヒープ機能を使用したFullGCの抑止

アプリケーションのユーザログ出力

セキュリティ管理機能

統合ユーザ管理による認証

セキュリティ管理機能編

アプリケーションの設定による認証

SSL/TLS通信でのTLSv1.2の使用

APIによる直接接続を使用する負荷分散機の運用管理機能からの制御

運用機能

システムの起動と停止

運用／監視／連携編

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

監視機能

稼働情報の監視（稼働情報収集機能）

リソースの枯渇監視

監査ログ出力機能

データベース監査証跡連携機能

運用管理コマンドによる稼働情報の出力

Managementイベントの通知とManagementアクションによる処理の自動実行

CTMの稼働統計情報の収集

コンソールログの出力

連携機能

JP1と連携したシステムの運用

システムの集中監視（JP1/IMとの連携）

ジョブによるシステムの自動運転（JP1/AJSとの連携）

監査ログの収集および一元管理（JP1/Audit Management - Managerとの連携）

クラスタソフトウェアとの連携

1:1系切り替えシステム（クラスタソフトウェアとの連携）

相互系切り替えシステム（クラスタソフトウェアとの連携）

N:1リカバリシステム（クラスタソフトウェアとの連携）

ホスト単位管理モデルを対象にした系切り替えシステム（クラスタソフトウェアとの連携）

保守機能

トラブルシューティング関連機能

保守／移行編※2

性能解析トレースを使用した性能解析

製品のJavaVM（以降，JavaVMと略す場合があります）の機能

移行機能

旧バージョンのアプリケーションサーバからの移行

推奨機能への移行

互換機能

基本・開発機能の互換機能

互換編

拡張機能の互換機能

注※1　マニュアル名称の「アプリケーションサーバ 機能解説」を省略しています。

注※2　このマニュアルです。

1.2　システムの目的と機能の対応

アプリケーションサーバでは，構築・運用するシステムの目的に合わせて，適用する機能を選択する必要があります。

この節では，このマニュアルで説明している次の機能をどのような場合に使用するとよいかを説明します。なお，これらの機能は，アプリケーションサーバが独自に拡張した機能です。

システムの保守のための機能

JavaVMの機能

旧バージョンの製品から移行するための機能

機能ごとに，次の項目への対応を示しています。

性能

性能を重視したシステムの場合に使用するとよい機能です。

システムのパフォーマンスチューニングで使用する機能などが該当します。

運用・保守

効率の良い運用・保守をしたい場合に使用するとよい機能です。

そのほか

そのほかの個別の目的に対応するための機能です。

1.2.1　システムの保守のための機能

システムの保守のための機能を次の表に示します。システムの目的に合った機能を選択してください。機能の詳細については，参照先を確認してください。

表1‒2　システムの保守のための機能

機能

システムの目的

参照先

性能

運用・

保守

そのほか

トラブルシューティング

−

○

−

2章，3章，4章，5章，6章

性能解析トレースを使用した性能解析

○

○

−

7章，8章

（凡例）　○：対応する　　−：対応しない

1.2.2　製品のJavaVMの機能

製品のJavaVMの機能を次の表に示します。システムの目的に合った機能を選択してください。機能の詳細については，参照先を確認してください。

表1‒3　製品のJavaVMの機能

機能

システムの目的

参照先

性能

運用・

保守

そのほか

クラス別統計機能

○

○

−

9.3

インスタンス統計機能

○

○

−

9.4

STATICメンバ統計機能

○

○

−

9.5

参照関係情報出力機能

○

○

−

9.6

統計前のGC選択機能

○

○

−

9.7

Tenured領域内不要オブジェクト統計機能

○

○

−

9.8

Tenured増加要因の基点オブジェクトリスト出力機能

○

○

−

9.9

クラス別統計情報解析機能

○

○

−

9.10

Survivor領域の年齢分布情報出力機能

○

○

−

9.11

hndlwrap機能

−

○

−

9.12

JITコンパイル時のCヒープ確保量の上限値設定機能

−

○

−

9.13

スレッド数の上限値設定機能

−

○

−

9.14

（凡例）　○：対応する　　−：対応しない

1.2.3　旧バージョンの製品から移行するための機能

旧バージョンの製品から移行するための機能を次の表に示します。システムの目的に合った機能を選択してください。機能の詳細については，参照先を確認してください。

表1‒4　旧バージョンの製品から移行するための機能

機能

システムの目的

参照先

性能

運用・

保守

そのほか

旧バージョンのアプリケーションサーバからの移行

−

−

○

10章

（凡例）　○：対応する　　−：対応しない

1.3　このマニュアルに記載している機能の説明

ここでは，このマニュアルで機能を説明するときの分類の意味と，分類を示す表の例について説明します。

1.3.1　分類の意味

このマニュアルでは，各機能について，次の五つに分類して説明しています。マニュアルを参照する目的によって，必要な個所を選択して読むことができます。

解説

機能の解説です。機能の目的，特長，仕組みなどについて説明しています。機能の概要について知りたい場合にお読みください。

実装

コーディングの方法やDDの記載方法などについて説明しています。アプリケーションを開発する場合にお読みください。

設定

システム構築時に必要となるプロパティなどの設定方法について説明しています。システムを構築する場合にお読みください。

運用

運用方法の説明です。運用時の手順や使用するコマンドの実行例などについて説明しています。システムを運用する場合にお読みください。

注意事項

機能を使用するときの全般的な注意事項について説明しています。注意事項の説明は必ずお読みください。

1.3.2　分類を示す表の例

機能説明の分類については，表で説明しています。表のタイトルは，「この章の構成」または「この節の構成」となっています。

次に，機能説明の分類を示す表の例を示します。

機能説明の分類を示す表の例

表X-1　この章の構成（○○機能）

分類

タイトル

参照先

解説

○○機能とは

X.1

実装

アプリケーションの実装

X.2

DDおよびcosminexus.xml※での定義

X.3

設定

実行環境での設定

X.4

運用

○○機能を使用した運用

X.5

注意事項

○○機能使用時の注意事項

X.6

注※

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

ポイント

cosminexus.xmlを含まないアプリケーションのプロパティ設定

cosminexus.xmlを含まないアプリケーションでは，実行環境へのインポート後にプロパティを設定，または変更します。設定済みのプロパティも実行環境で変更できます。

実行環境でのアプリケーションの設定は，サーバ管理コマンドおよび属性ファイルで実施します。サーバ管理コマンドおよび属性ファイルでのアプリケーションの設定については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.5.2　J2EEアプリケーションのプロパティの設定手順」を参照してください。

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

なお，各属性ファイルで設定するプロパティは，アプリケーション統合属性ファイルでも設定できます。

1.4　アプリケーションサーバ 11-20での主な機能変更

この節では，アプリケーションサーバ 11-20での主な機能の変更について，変更目的ごとに説明します。

説明内容は次のとおりです。

アプリケーションサーバ 11-20で変更になった主な機能と，その概要を説明しています。機能の詳細については参照先の記述を確認してください。「参照先マニュアル」および「参照個所」には，その機能についての主な記載個所を記載しています。

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

1.4.1　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表1‒5　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

JSF 2.3への対応

JSF 2.3に対応しました。

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

3章

JAX-RS 2.1への対応

JAX-RS 2.1に対応しました。

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

4章

WebSocket 1.1への対応

WebSocket 1.1に対応しました。

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

5章

Servlet 4.0への対応

Servlet 4.0に対応しました。これに伴い，NIO HTTPサーバでHTTP/2に対応しました。

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

8章

CDI Managed BeanでのJPA利用

CDI Managed BeanでのJPA利用に対応しました。

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

5章

JPA 2.2への対応

JPA 2.2に対応しました。

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

6章

CDI 2.0への対応

CDI 2.0に対応しました。

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

9章

WEB-INF/lib内のCDIへの対応

WARファイルのWEB-INF/lib以下のJARファイルからCDIを利用できるようにしました。

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

9章

BV 2.0への対応

BV 2.0に対応しました。

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

10章

JSON-P 1.1への対応

JSON-P 1.1に対応しました。

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

12章

JSON-B 1.0への対応

JSON-B 1.0に対応しました。

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

13章

2　トラブルシューティング

アプリケーションサーバでは，システムの運用中に発生したトラブルの対処で利用できる，さまざまな資料を出力する機能を提供しています。この章では，トラブルが発生した場合に使用する資料の取得方法，対処手順，トラブルシューティングに関する留意事項などについて説明します。

2.1　この章の構成

トラブルシューティングに関する説明のうち，トラブルシューティングの資料取得と対処の概要について説明します。

運用中のシステムでトラブルが発生した場合，発生したトラブルの種別に応じて資料を収集する必要があります。アプリケーションサーバでは，システムの保守に利用できる資料として，ログを出力する機能を提供しています。

この章の構成を次の表に示します。

表2‒1　この章の構成（トラブルシューティング（資料取得と対処の概要））

分類

タイトル

参照先

解説

トラブルシューティングの概要

2.2

資料の取得

2.3

取得が必要な資料の種類

2.4

運用

トラブルへの対処と回復

2.5

注意事項

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

2.6

なお，トラブルシューティングの資料の取得や出力に関する設定，資料を個別に出力する方法，資料の出力先や出力内容，およびトラブルシューティングの手順については，それぞれ次の個所を参照してください。

資料の取得や出力に関する設定

「3.　トラブルシューティングのための準備」

資料のデフォルトでの出力先と，資料を個別に出力する方法

「4.　トラブルシューティングで必要な資料の出力先と出力方法」

資料に出力される内容

「5.　トラブルの分析」

トラブルシューティングの手順

「6.　トラブルシューティングの手順」

2.2　トラブルシューティングの概要

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

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

また，CTMを利用すると，J2EEサーバが異常終了した場合でも，すぐにクライアントにエラーが返却されないように設定できます。J2EEサーバが再起動されるまでの間，CTMによってJ2EEアプリケーションのスケジュールキューが閉塞制御され，すでに登録されているリクエストを保持して，さらにクライアントからのリクエストを受け付け続けます。これによって，すぐに再起動すれば，クライアントにトラブルを気づかせないで運用を続けられます。なお，CTMは，構成ソフトウェアにComponent Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」の「2.2.2　構成ソフトウェアの機能概要」を参照してください。

この節では，トラブル発生時の対処手順と，資料取得の流れについて説明します。

2.2.1　トラブルへの対処の手順

この節では，アプリケーションサーバのシステムの運用中にトラブルが発生した場合の，対処の手順について説明します。

なお，トラブル発生時に取得する情報のうち，次に示す情報を取得するためには，運用開始前の準備が必要です。

JavaVMログ（JavaVMログファイル）

このファイルには，JavaVMのGCのログも出力されます。

ユーザダンプ（Windowsの場合）

coreダンプ（UNIXの場合）

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

これらの情報については，必要に応じてシステム構築時に取得準備をしてください。詳細は，「3.2　資料取得の設定の概要」および「3.3　実行環境での設定」を参照してください。

システムの運用中にトラブルが発生した場合は，次の図に示す手順で対処します。トラブル発生時の対処の流れを次の図に示します。

図2‒1　トラブル発生時の対処の流れ

資料取得

トラブルシューティングに必要な資料をすべて取得します。

取得が必要な資料については，「2.4　取得が必要な資料の種類」を参照してください。なお，メモリダンプは，J2EEサーバまたはCORBAネーミングサービスを再起動する場合にだけ必要な資料です。

また，資料の取得方法については，「2.3　資料の取得」，または「4.　トラブルシューティングで必要な資料の出力先と出力方法」を参照してください。

参考

資料の取得には，snapshotログとして一括して取得する方法と，個別のログを取得する方法があります。

snapshotログの取得には，運用管理コマンドを使用して取得する方法，および設定によって自動で取得する方法があります。

論理サーバに異常が発生した場合の資料取得を自動化できます。詳細は，「2.3.1　トラブル発生時に自動的に取得できる資料」を参照してください。

トラブル原因の判別（一次判別）

トラブルの原因を判別します。判別には，取得した資料を使用します。資料の調査方法については，「5.　トラブルの分析」を参照してください。

トラブルへの対処と回復

トラブルに対処して，回復します。

トラブルの種類ごとの対処方法については，「2.5　トラブルへの対処と回復」を参照してください。

トラブル原因の解析（二次解析）

必要に応じてトラブル原因をさらに分析します。なお，この解析作業は保守員が実施します。

ポイント

トラブルが発生したタイミングごとのトラブルシューティングについては，「6.　トラブルシューティングの手順」を参照してください。

2.2.2　トラブル発生時の資料取得の流れ

アプリケーションサーバで構築したシステムでは，自動でトラブルシューティングの資料を取得できます。論理サーバを起動すると，運用管理エージェントは論理サーバの監視を開始します。論理サーバに異常が発生すると，運用管理エージェントは異常を検知し，Management Serverに通知します。Management Serverは資料を取得および収集し，論理サーバを停止して再起動します。

自動で資料を取得する場合の流れを次の図に示します。

図2‒2　自動で資料を取得する場合の流れ

2.の障害検知時コマンドによって，トラブルシューティングに必要な情報が出力されます。このコマンドで出力した情報，およびそれ以外のトラブルシューティングに必要な情報を，3.でsnapshotログとしてまとめて収集します。なお，障害検知時コマンドを使用しないで，4.の論理サーバの停止後にsnapshotログを取得することもできますが，このとき取得できる情報はJ2EEサーバだけとなります。このため，障害検知時コマンドを使用して，3.でsnapshotログを収集することをお勧めします。障害検知時コマンドを使用した資料の取得については，「2.3.2　障害検知時コマンドによる資料取得」を，snapshotログについては，「2.3.3　snapshotログの収集」を参照してください。

また，Management Serverの運用管理コマンド（mngsvrutil）を使用して，snapshotログを任意のタイミングで収集することもできます。運用管理コマンドを使用したsnapshotログの収集については，「2.3.3(4)　運用管理コマンドを使用したsnapshotログの収集」を参照してください。

論理サーバのプロセスがダウンしたとき，および論理サーバのプロセスがハングアップしたときの処理の流れについて説明します。

(1)　論理サーバのプロセスがダウンしたときの処理の流れ

論理サーバの起動後，運用管理エージェントのプロセス監視では，論理サーバプロセスのプロセスIDを使用して定期的にプロセスを監視します。論理サーバプロセスがダウンしたときの処理の流れを次の図に示します。

図2‒3　論理サーバのプロセスがダウンしたときの処理の流れ

論理サーバプロセスのプロセスIDで，定期的にプロセスを監視します。

論理サーバプロセスが異常終了すると，運用管理エージェントはプロセスダウンを検知して，Management Serverに通知します。

プロセス監視では，プロセスIDの存在確認をします。確認内容は，論理サーバの種類によって異なります。詳細については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「2.3.1　論理サーバの起動と稼働確認」，およびマニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「2.3.2　論理サーバの停止」を参照してください。

Management Serverではプロセスダウンを検知すると，障害検知時コマンドを実行し，snapshotログを収集します。

障害検知時コマンドとsnapshotログ収集後，論理サーバを自動再起動します。

(2)　論理サーバのプロセスがハングアップしたときの処理の流れ

論理サーバの起動後，運用管理エージェントのプロセス監視では，論理サーバプロセスに対して定期的に，論理サーバが動作しているかを確認します。動作確認中に論理サーバプロセスがハングアップしたときの処理の流れを次の図に示します。

図2‒4　論理サーバのプロセスがハングアップしたときの処理の流れ

定期的に論理サーバプロセスの動作確認をします。

動作確認は，プロセス監視でプロセスIDが存在することが確認されてから，実施されます。確認内容は，論理サーバの種類によって異なります。詳細については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「2.3.1　論理サーバの起動と稼働確認」，およびマニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「2.3.2　論理サーバの停止」を参照してください。

連続して動作確認に2回失敗すると（デフォルト値），運用管理エージェントはハングアップと判断して，Management Serverに通知します。なお，ハングアップと判断する，動作確認の失敗回数は変更できます。

Management Serverではハングアップを検知すると，障害検知時コマンドを実行し，snapshotログを収集します。

ハングアップの場合，プロセスは稼働中であるため，自動停止処理を実行します。

運用管理エージェントでは論理サーバの停止コマンドを実行します。

なお，一定時間経っても停止しない場合は，強制停止コマンドが実行されます。

障害検知時コマンドとsnapshotログ収集後，論理サーバを自動再起動します。

2.3　資料の取得

トラブルシューティングに必要な資料は，次のどれかの方法で取得できます。

トラブル発生時に自動的に取得する

運用管理コマンドを利用して一括取得する

それぞれの情報を個別に収集する

トラブルシューティングに必要な情報は，snapshotログとしてまとめて収集できます。snapshotログとは，システムの構成ソフトウェアのトラブル発生時に，そのときの状態を出力したログのことです。アプリケーションサーバで構築したシステムでは，各種構成ソフトウェアのsnapshotログを一括して収集して，ZIP形式のログファイルとして出力できます。snapshotログは，一次送付資料，二次送付資料に分けて取得できます。また，snapshotlogコマンドを使用して定義送付資料を収集することもできます。

この節では，トラブル発生時に必要な資料の取得方法として，資料を取得するときに実行する障害検知時コマンドと，資料を一括収集するsnapshotログについて説明します。

snapshotログとして取得しない情報については，「2.4.3　取得方法および調査方法との対応」を，それぞれの情報を個別に収集する方法ついては，「4.　トラブルシューティングで必要な資料の出力先と出力方法」を参照してください。

なお，資料によっては，事前に取得のための設定をしておく必要があります。例えば，OSの統計情報，ユーザダンプなどは，システム構築時に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。

デフォルトの設定で取得できる資料についても，ログファイルの出力先，ログファイルの面数や1ファイル当たりの最大サイズなどを変更できます。必要に応じて，資料取得の設定を変更してください。

また，デフォルトの設定ではsnapshotログとして収集できない資料でも，その資料の取得先をsnapshotログの収集対象として定義することで，snapshotログとして一括収集できるようになります。

注意事項

Windowsの場合に資料取得の設定をするときの注意事項

Windowsでは，障害発生時の調査資料を取得するために，レジストリの設定が必要です。レジストリの設定はシステム全体に対して影響を与えるため，設定するときは十分に注意してください。

トラブルシューティングに必要な資料取得の設定については，「3.　トラブルシューティングのための準備」を参照してください。

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

アプリケーションサーバで構築したシステムでは，論理サーバに異常が発生した場合に，自動的にトラブルシューティングに必要な情報を取得，収集できます。

ポイント

トラブル発生時に資料を自動で取得するためには，システムを構築する段階で必要な設定をしておく必要があります。トラブルシューティングの資料取得の設定については，「3.2　資料取得の設定の概要」，および「3.3　実行環境での設定」を参照してください。

障害検知時コマンドの実行とsnapshotログの収集によって，トラブルシューティングに必要な情報は，次の情報を除いてすべて自動収集するように設定できます。

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

デフォルトの設定で収集されない情報については，次のように設定して収集します。

ユーザ作成の障害検知時コマンド内で，必要な情報を出力します。

1.の情報の出力先を，snapshotログの収集対象のパスに追加します。

snapshotログ取得の設定については，「3.3.3　snapshotログ収集の設定（J2EEアプリケーションを実行するシステム）」，または「3.3.4　snapshotログ収集の設定（バッチアプリケーションを実行するシステム）」を参照してください。

注意事項

snapshotログで取得できる構成ソフトウェアのログのうち，次の表に示すログの取得については，このマニュアルでは説明していません。取得方法については，次の表の参照先マニュアルを参照してください。

表2‒2　このマニュアルでログの取得方法を記載していない構成ソフトウェア

ログの種類

参照先マニュアル

参照個所

Component ContainerのSOAPアプリケーション実行基盤のログ

アプリケーションサーバ SOAPアプリケーション開発の手引

14章

Web Services - Securityのログ

アプリケーションサーバ Webサービスセキュリティ構築ガイド

6章

TPBrokerのログ

TPBroker ユーザーズガイド

2.3.2　障害検知時コマンドによる資料取得

障害検知時コマンドは，Management Serverが論理サーバの障害を検知したときに，システムによって実行されるコマンドです。障害検知時コマンドは，システム構築時にmserver.properties（Management Server環境設定ファイル）のキーに値を指定することで実行されます。

注意事項

運用管理エージェントが停止している状態で，論理サーバのプロセスが異常終了した場合，そのあとに運用管理エージェントを起動しても障害検知時コマンドは実行されません。この場合，運用管理エージェントの起動時に，詳細情報が「The command is not defined.」のKEOS20071-Eメッセージが出力されます。メッセージについては，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照してください。

障害検知時コマンドを利用して，トラブル発生時のスレッドダンプやユーザダンプの取得などの取得処理を実行することで，トラブル発生時のタイムリーな資料を取得できるようになります。また，障害検知時コマンドを利用すると，次のどちらかのタイミングでsnapshotログを自動収集することもできます。収集するタイミングは設定によって決められます。

論理サーバにトラブルが発生した場合，障害検知時コマンドが実行されて，論理サーバの停止前にsnapshotログが収集されます。

J2EEサーバまたはバッチサーバにトラブルが発生した場合，障害検知時コマンドが実行されて，J2EEサーバまたはバッチサーバの再起動前にsnapshotログが収集されます。

障害検知時コマンドには，システム提供の障害検知時コマンドとユーザ作成の障害検知時コマンドの2種類があります。

システム提供の障害検知時コマンド

あらかじめアプリケーションサーバで定義されているコマンドです。システム提供の障害検知時コマンドでは，論理サーバにトラブルが発生した場合に，トラブルが発生した論理サーバのJavaVMのスレッドダンプや性能解析トレースなどを取得します。システム提供の障害検知時コマンドで取得した資料は，snapshotログとして収集できます。

デフォルトの設定では，論理サーバにトラブルが発生した場合にシステム提供の障害検知時コマンドが実行されて，トラブルが発生した論理サーバの停止前にsnapshotログが収集されます。

ユーザ作成の障害検知時コマンド

障害検知時コマンドはユーザが作成することもできます。資料取得に必要な任意の処理を記述したバッチファイルやシェルスクリプトを，障害検知時コマンドとして実行できます。

なお，ユーザ作成の障害検知時コマンドで取得した資料をsnapshotログとして収集するためには，その資料の取得先をsnapshotログの収集先として定義しておく必要があります。

システム提供の障害検知時コマンドの動作設定を変更する場合，またはユーザ作成の障害検知時コマンドを利用する場合に必要な設定については，「3.3.1　障害検知時コマンドによる資料取得の設定（J2EEアプリケーションを実行するシステム）」または「3.3.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」が設定されている場合，ユーザが作成した障害検知時コマンドが実行されます。

ここでは，それぞれで取得できる情報について説明します。

(1)　システムで提供されている障害検知時コマンドで取得できる情報

システムで提供されている障害検知時コマンドで取得できる情報について，次の表に示します。障害検知時コマンドで取得できる情報は，障害の種類（システムダウン，またはハングアップ）および使用しているOSによって異なります。

なお，snapshotログでこれらの情報を取得するためには，adminagent.properties（運用管理エージェントプロパティファイル）に必要な設定がされていることが必要です。

障害検知時コマンドで取得できる情報を次に示します。

表2‒3　障害検知時コマンドで取得できる情報

論理サーバ

OS

取得できる情報

J2EEアプリケーション

バッチアプリケーション

プロセスダウンを検出した場合

ハングアップを検出した場合

論理パフォーマンストレーサ

Windows

UNIX

バッファの内容を出力したPRFトレースファイル

−

○

○

論理J2EEサーバ※

Windows

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

○

○

UNIX

JavaVMのスタックトレース情報

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

○

○

論理Webサーバ

Windows

UNIX

性能解析トレースファイル

内部トレース

性能解析トレースファイル

○

−

ほかの論理サーバ

Windows

UNIX

性能解析トレースファイル

性能解析トレースファイル

○

−

（凡例）

J2EEアプリケーション：J2EEアプリケーションを実行するシステム

バッチアプリケーション：バッチアプリケーションを実行するシステム

−：該当しない

○：取得できる

注※　バッチサーバは論理J2EEサーバとして定義します。

トラブルが発生したJ2EEサーバまたはバッチサーバのスレッドダンプ

adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.j2ee.sys_cmd.abnormal_end.threaddumpキーに「true」が設定されている場合に取得できます。

性能解析トレース

adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.sys_cmd.abnormal_end.prftraceキーに「true」が設定されている場合に取得できます。性能解析トレースファイルは<Application Serverのインストールディレクトリ>/manager/tmpに出力されます。なお，出力先はadminagent.properties（運用管理エージェントプロパティファイル）のadminagent.prftrace_dirキーで変更できます。

注意事項

トラブルが発生したJ2EEサーバのプロセスが存在しないと判断された場合，スレッドダンプは出力されません。また，パフォーマンストレーサのプロセスが存在しないと判断された場合，性能解析トレースは出力されません。

(2)　ユーザが作成した障害検知時コマンドで取得できる情報

ユーザが作成した障害検知時コマンドとして，資料取得に必要な任意の処理を記述したバッチファイルまたはシェルスクリプトを実行できます。例えば，ユーザダンプまたはcoreダンプは，このコマンドの中でdrwtsn32コマンドなどを実行して取得できます。障害検知時コマンドの作成方法については，「3.3.1　障害検知時コマンドによる資料取得の設定（J2EEアプリケーションを実行するシステム）」または「3.3.2　障害検知時コマンドによる資料取得の設定（バッチアプリケーションを実行するシステム）」を参照してください。

なお，ユーザ作成の障害検知時コマンドは，adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.<serverkind>.usr_cmd.abnormal_endキーに指定されているものが実行されます。

2.3.3　snapshotログの収集

システムの構成ソフトウェアがトラブル発生時にそのときの状態を出力したログを，snapshotログといいます。snapshotログには，各種構成ソフトウェアのログのほかに，スレッドダンプ，性能解析トレースなど，システム保守に必要な情報とアプリケーション保守に必要な情報が含まれます。アプリケーションサーバで構築したシステムでは，これらの情報をsnapshotログとして一括収集し，ZIP形式のログファイルとして取得できます。運用管理者は，snapshotログを収集・分析することで，トラブルに対処できます。

障害検知時コマンドの実行とsnapshotログの収集によって，トラブルシューティングに必要な資料は自動収集するように設定されています。デフォルトの設定で収集されない情報をsnapshotログとして収集したい場合には，その資料の取得先をsnapshotログの収集対象として定義してください。デフォルトの設定で収集されない情報については，「付録A　snapshotログの収集対象一覧」のsnapshotログの収集可否や収集に関する設定変更の説明を参照してください。

snapshotログの収集対象，出力先ディレクトリや面数などは，システム構築時に設定を変更できます。

ここでは，snapshotログの収集タイミング，収集できる資料，および収集の流れについて説明します。また，任意のタイミングで収集する方法として，運用管理コマンドを使用したsnapshotログの収集についても説明します。なお，snapshotログ収集の設定については，「3.3.3　snapshotログ収集の設定（J2EEアプリケーションを実行するシステム）」，または「3.3.4　snapshotログ収集の設定（バッチアプリケーションを実行するシステム）」を参照してください。

(1)　snapshotログの収集タイミング

snapshotログは，自動または任意のタイミングで収集できます。snapshotログの収集のタイミングを次の表に示します。なお，収集できるのは，論理サーバが稼働しているホスト内のsnapshotログです。

表2‒4　snapshotログの収集のタイミング

分類

収集のタイミング

自動的に収集する※1

論理サーバが障害時に自動停止される直前※2

運用管理ドメインで管理しているJ2EEサーバまたはバッチサーバが障害時に自動再起動される直前※2

J2EEサーバまたはバッチサーバを手動で一括再起動する直前

任意のタイミングで収集する

Management Serverの運用管理コマンド（mngsvrutil）でsnapshotログの収集を実行したとき（実行方法については，「2.3.3(4)　運用管理コマンドを使用したsnapshotログの収集」を参照してください）

注※1

次に示すどちらのタイミングでsnapshotログを収集するかは，システム構築時に設定を変更できます。デフォルトの設定では，論理サーバの停止前にsnapshotログが収集されます。

・論理サーバの停止前

・J2EEサーバの再起動前

注※2

このタイミングでsnapshotログを収集する場合には，Management Serverによって障害検知時コマンドが実行されます。

参考

snapshotログは，次のタイミングでも収集できます。

運用管理ポータルの「論理サーバの起動／停止」にある［snapshotログ］画面で［収集］ボタンをクリックした時※1

snapshotlogコマンド実行時※2

注※1

収集できるのは，収集を実行したJ2EEサーバまたはバッチサーバ内のsnapshotログです。

注※2

Management Serverを使用しているかどうかに関係なく，コマンドは実行できます。

［snapshotログ］画面については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「11.9.5　J2EEサーバのsnapshotログの収集」を，snapshotlogコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「snapshotlog（snapshotログの収集）」を参照してください。

(2)　snapshotログとして収集できる資料

snapshotログとして収集できる資料について説明します。snapshotログには，システム保守に必要な情報とアプリケーション保守に必要な情報が含まれます。

トラブルシューティングに必要な資料は，資料を保守員へ送付するときのタイミングによって，一次送付資料と二次送付資料に分類されます。snapshotログでは，一次送付資料および二次送付資料を収集できます。また，snapshotlogコマンドを使用して定義送付資料を収集できます。

一次送付資料

メールの添付資料として送付できるファイルサイズの資料が該当します。メールなどで早急に保守員に送付できます。

二次送付資料

一次送付資料に加えて，ファイルサイズが比較的大きい資料が該当します。ファイルサイズが比較的大きい資料は資料の送付に時間が掛かるため，別途，保守員に送付する必要があります。

定義送付資料

定義ファイルの設定誤りを調査するため，定義ファイルだけを収集した資料です。ファイルサイズが小さく，メールなどで早急に保守員に送付できます。なお，この資料はsnapshotlogコマンドを使用して，Management ServerやJ2EEサーバが起動していない状態でも収集できます。

注意事項

定義送付資料で収集される定義情報中にユーザIDおよびパスワードが含まれる場合があります。

snapshotログとして収集する資料は，snapshotログ収集対象定義ファイルの設定によって変更できます。例えば，ユーザ作成の障害検知時コマンドで出力した情報を収集したい場合には，設定を変更すれば収集対象に加えられます。snapshotログ収集対象定義ファイルはシステム構築時に設定します。

実際の運用環境での収集対象は，次のファイルで確認できます。

snapshotlog.conf

一次送付資料として取得する内容が定義されています。

snapshotlog.confの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥snapshotlog.conf

UNIXの場合

/opt/Cosminexus/manager/config/snapshotlog.conf

snapshotlog.2.conf

二次送付資料として取得する内容が定義されています。

snapshotlog.2.confの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥snapshotlog.2.conf

UNIXの場合

/opt/Cosminexus/manager/config/snapshotlog.2.conf

snapshotlog.param.conf

定義送付資料として取得する内容が定義されています。

snapshotlog.param.confの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥snapshotlog.param.conf

UNIXの場合

/opt/Cosminexus/manager/config/snapshotlog.param.conf

ただし，adminagent.properties（運用管理エージェントプロパティファイル）の指定内容によっては，収集できる情報が異なる場合があります。

デフォルトの設定の場合，トラブル発生時に自動的に取得されるsnapshotログには，次の情報が含まれます。

一次送付資料

snapshotログの一次送付資料の収集対象として定義されているディレクトリ下の情報※1

J2EEサーバのスレッドダンプ※2

インストール情報

OSの状態ログ

二次送付資料

性能解析トレース※2

snapshotログの二次送付資料の収集対象として定義されているディレクトリ下の情報※1

インストール情報

OSの状態ログ

注※1　snapshotログの収集対象については，「付録A　snapshotログの収集対象一覧」を参照してください。

注※2　システムで提供されている障害検知時コマンドで，スレッドダンプおよび性能解析トレースを出力する設定にしている場合に収集できます。

参考

snapshotlogコマンドで収集できるsnapshotログと，Management Serverの運用管理コマンド（mngsvrutil）などで収集できるsnapshotログでは，デフォルトの状態で収集できるファイルが異なります。Management Serverの運用管理コマンド（mngsvrutil）などで収集できるsnapshotログは，デフォルトの状態でインストール情報やOSの状態・ログなどを収集できますが，snapshotlogコマンドでインストール情報やOSの状態・ログなどを収集するためには，コマンド実行時に指定するsnapshotログ収集対象定義ファイルを編集して，snapshotログの収集先を追加する必要があります。

デフォルトの状態で収集できる情報と収集できない情報の例を次に示します。

(a)　デフォルトの状態で収集できる情報

デフォルトの状態で収集できる情報の例を次に示します。

システム保守に必要な情報

システム保守に必要な情報として，次に示す構成ソフトウェアの定義ファイルおよびログファイルが収集されます。

Component Container※

Component Transaction Monitor

Developer's Kit for Java

Performance Tracer

TPBroker

Web Services - Security

HTTP Server

このほか，トレース共通ライブラリのログ，およびプログラムプロダクト情報（UNIXの場合）も収集します。

注※　SOAPアプリケーション実行基盤の情報も含みます。

アプリケーション保守に必要な情報

アプリケーション保守に必要な情報として，Component Containerのメッセージログおよびユーザログを収集します。

次に示す情報についても，デフォルトの状態で収集されます。

Component Container関連の情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥public下すべて

UNIXの場合

/opt/Cosminexus/CC/server/public下すべて

なお，デフォルトの状態では，構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリがsnapshotログの収集対象として定義されています。ログの出力先を変更している場合は収集先も変更するようにしてください。

(b)　デフォルトの状態では収集できない情報

次に示す情報は，デフォルトの状態で運用している場合は収集されません。必要に応じて，取得するように設定してください。

Windowsの場合

Component Container関連

EAR/JARファイル（デプロイ/インポートできなかった場合）

Microsoft IIS関連

Microsoft IISと連携している場合，次の資料を取得します。

C:¥inetpub¥logs（C:の部分にはシステムドライブを指定します）

OS関連

システムモニタ関連の資料一式（4.13参照）

イベントログ（アプリケーション，システム）

OSの稼働資料

winmsd起動画面から［操作］−［テキストファイルとして保存］メニューで資料採取します（5分から10分掛かる場合があります）。

UNIXの場合

Component Container関連

EAR/JARファイル（デプロイ/インポートできなかった場合）

OS関連

OSの稼働資料

(3)　snapshotログ収集の流れ

論理サーバに異常が発生すると，Management Serverから運用管理エージェントに対してsnapshotログ収集のサービス要求が実行されます。snapshotログ収集時に実行される処理の流れを次に示します。なお，設定によって，実行される処理は異なります。

システム提供の障害検知時コマンドの実行

ユーザ作成の障害検知時コマンドの実行

snapshotログ（一次送付資料）の収集

snapshotログ（二次送付資料）の収集

マシンの動作環境や，障害の発生状況（想定外の障害が発生した場合など）によっては，snapshotログの収集に時間が掛かることがあります。このため，これらの処理に対して，それぞれタイムアウトが設定できます。

なお，snapshotログの収集に対するタイムアウトは，想定外の障害発生によってsnapshotログの収集に時間が掛かり過ぎる場合に，論理サーバの再起動を優先しなくてはならないような状況が見込まれるときなどに設定してください。snapshotログの収集時にタイムアウトが実行されると，収集処理は強制的に中断され，トラブルシューティングに必要な情報が取得できなくなります。

(4)　運用管理コマンドを使用したsnapshotログの収集

snapshotログは，自動実行されるほか，運用管理コマンド（mngsvrutil）を使用して任意のタイミングで収集できます。

なお，取得できる情報の種類は，トラブル発生時に自動的に収集されるsnapshotログと同じです。「2.3.3(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

2.3.4　取得した情報の格納先

snapshotログの収集によって自動で取得された情報は，adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.snapshotlog.log_dirキーで指定したディレクトリに次の名称で格納されています。

一次送付資料として収集したファイル

snapshot-<ホスト名※1>-log-<yyyyMMddHHmmss※2>.zip

二次送付資料として収集したファイル

snapshot-<ホスト名※1>-log-<yyyyMMddHHmmss※2>.2.zip

注

定義送付資料は収集されません。

注※1

論理サーバを指定して収集した場合は，論理サーバ名になります。

注※2

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：秒

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

この節では，アプリケーションサーバのシステムで想定されるトラブルの種別と，それに応じて取得が必要な資料について説明します。

トラブルシューティングに必要な資料は，発生したトラブルの種別によって異なります。例えば，エラーメッセージが出力されたのか，アプリケーションサーバのサーバプロセスが異常終了したのかによって，必要な資料は異なります。

また，トラブルの内容によっては保守員に連絡する必要があります。保守員とは，ご購入契約に基づくお問い合わせ窓口のことです。

保守員に連絡が必要なトラブル

出力されたエラーメッセージの対処に「保守員に連絡してください。」とある場合

トラブルの要因がわからない場合

エラーメッセージの内容に対処できない場合

保守員に連絡する場合には，次の内容をできるだけ正確に伝えてください。

エラーの発生時期

エラー発生の直前に実行した操作

エラー発生時の画面の動作

トラブル発生時に取得した資料

トラブルシューティングに必要な資料は，資料を保守員へ送付するときのタイミングによって，一次送付資料，二次送付資料，および定義送付資料に分類されます。

メールなどで早急に送付する資料（一次送付資料および定義送付資料）

メールの添付資料として送付できるファイルサイズの資料が該当します。メールなどで早急に保守員に送付できます。

例えば，次の資料が一次送付資料として取得できます。

メッセージログ

J2EEサーバなどの稼働状態およびエラー情報が出力されます。

ユーザログ

アプリケーション中で出力される標準出力および標準エラー出力の情報が出力されます。

例外ログ

システムでトラブルが発生したときの例外情報が出力されます。

保守用ログ

システムでトラブルが発生したときの障害保守情報が出力されます。保守員が障害解析用に使用します。

また，定義送付資料として，定義ファイルだけを収集した情報が出力されます。定義誤りの調査に使用します。

別途送付する資料（二次送付資料）

ファイルサイズが比較的大きく，保守員への送付に時間が掛かるため，メール以外の方法などで別途送付する必要がある資料が該当します。なお，二次送付資料には，一次送付資料の内容が含まれます。

例えば，次の資料が二次送付資料として取得できます。

性能解析トレース

リクエストの一連の処理で出力されるトレース情報が出力されます。

メモリダンプ

プロセスのメモリイメージがダンプ出力されます。

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

アプリケーションサーバで想定されるトラブルには，次に示す種別があります。

エラーメッセージ出力

エラーメッセージが出力されます。

システムダウン

アプリケーションサーバのサーバプロセスが異常終了します。

ハングアップ（無応答）

アプリケーション呼び出しの応答が返らなくなります。

スローダウン

アプリケーション呼び出しの応答は返りますが，応答時間が長くなります。

トラブル種別ごとに取得する資料を，次に示します。

表2‒5　トラブル種別ごとの取得資料一覧

項番

資料の種類

トラブル種別

エラーメッセージ出力

システムダウン

ハングアップ（無応答）

スローダウン

1

メッセージログ※1

○

○

○

○

2

ユーザログ※1

○

○

○

○

3

例外ログ※1

○

○

○

○

4

保守用ログ※1

○

○

○

○

5

性能解析トレース

○

○

○

○

6

JavaVMのスレッドダンプ

○

○

○

○

7

JavaVMのGCのログ

△

○

○

○

8

メモリダンプ

−

○

○

○

9

JavaVMログファイル※2

−

○

○

○

10

エラーリポートファイル

−

○

−

−

11

OSの状態・ログ

○

○

○

○

12

OSの統計情報

△

○

○

○

13

定義情報

○

○

○

○

14

作業ディレクトリ※4

△

△

△

△

15

リソースの設定

○

○

○

○

16

Webサーバのログ

○

○

○

○

17

JavaVMのスタックトレース※3

−

○

−

−

18

JavaVMの明示管理ヒープ機能のイベントログ※2

−

○

○

○

（凡例）

○：必須

△：取得するかどうかは，実際のエラーの内容によって異なる

−：取得しない

注※1

アプリケーションサーバの構成ソフトウェアが出力するログです。

注※2

JavaVM起動オプションを指定している場合に出力されます。取得するためのオプションについては，「4.10　JavaVMログ（JavaVMログファイル）」を参照してください。また，オプションの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。

注※3

UNIXを使用している場合だけ出力されます。

注※4

作業ディレクトリのデフォルトは，<Application Serverのインストールディレクトリ>¥CC¥server¥public（Windowsの場合），または/opt/Cosminexus/CC/server/public（UNIXの場合）です。

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

アプリケーションサーバで，トラブルシューティングに必要な資料の一覧を次の表に示します。また，それぞれの資料を保守員に送付する場合の送付タイミングについても示します。

表2‒6　取得資料一覧

項番

資料の種類

説明

送付タイミング

1

メッセージログ※1

J2EEサーバなどの稼働状態およびエラー情報が出力されます。

一次／二次

2

ユーザログ※1

アプリケーション中で出力される標準出力および標準エラー出力の情報が出力されます。

一次

3

例外ログ※1

システムでトラブルが発生したときの例外情報が出力されます。

一次

4

保守用ログ※1

システムでトラブルが発生したときの障害保守情報が出力されます。保守員が障害解析用に使用します。

一次／二次

5

性能解析トレース

リクエストの一連の処理で出力されるトレース情報が出力されます。

二次

6

JavaVMのスレッドダンプ

JavaVMの稼働情報やスレッドのスタック状態が出力されます。

一次

7

JavaVMのGCのログ

JavaVMのGCの活動状態が出力されます。

一次

8

メモリダンプ

プロセスのメモリイメージがダンプ出力されます。

二次

9

JavaVMログファイル※2

Developer's Kit for Javaで提供されるJavaVMのログが出力されます。

一次

10

エラーリポートファイル

JavaVMがダウンした場合に出力されるログファイルです。

一次

11

OSの状態・ログ

OSの稼働情報の記録です。

一次／二次

12

OSの統計情報

OSの統計情報の記録です。

一次

13

定義情報

アプリケーションサーバの各種設定の定義情報です。

一次／定義

14

作業ディレクトリ

アプリケーションサーバ稼働時に作業ファイルが格納されているディレクトリです。

一次／二次／定義

15

リソースの設定

アプリケーションサーバ上で使用するリソース（データソース，リソースアダプタ）の設定情報です。

二次／定義

16

Webサーバのログ

HTTP Server，Microsoft IISのログです。

一次／二次

17

JavaVMのスタックトレース※3

JavaVMが異常終了した場合の原因究明に使用する情報です。

一次／二次

18

JavaVMの明示管理ヒープ機能のイベントログ※2

明示管理ヒープ機能で発生するイベント（Explicitメモリブロックの初期化，Explicitメモリブロックへのオブジェクトの生成，Explicitメモリブロックの解放処理など）の情報が出力されます。

一次

（凡例）

一次：一次送付資料

二次：二次送付資料

定義：定義送付資料

注※1

アプリケーションサーバの構成ソフトウェアが出力するログです。

注※2

JavaVM起動オプションを指定している場合に出力されます。取得するためのオプションについては，「4.10　JavaVMログ（JavaVMログファイル）」を参照してください。また，オプションの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。

注※3

UNIXを使用している場合だけ出力されます。

ログファイルは，各構成ソフトウェアの環境設定ファイルで指定したディレクトリに自動的に作成されます。ファイル名には，1〜指定したログファイルの面数の通し番号が付きます。ログファイルのファイルサイズが一面当たりの最大サイズに達すると，次のログファイルに出力先を切り替えます。指定したログファイルの面数分のファイルに出力したあとは，ファイル名の番号が1のログファイルに再度ログを出力します。なお，ログファイルの1レコードの出力が途切れないようするために，ログファイルのファイルサイズが環境設定ファイルに指定したサイズより若干大きくなることがあります。1レコードの最大長は約4キロバイトです。

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

ここでは，取得が必要な資料の取得方法と調査方法の参照先を示します。また，snapshotログとして取得できる情報の種類についても示します。

表2‒7　取得が必要な資料の取得方法と調査方法の参照先

項番

資料の種類

デフォルト設定のsnapshotログで取得可※1

参照先

個別の収集方法

調査方法

1

メッセージログ

○

4.3，4.4，4.5

5.2，5.3

2

ユーザログ

○

3

例外ログ

○

4

保守用ログ

○

5

性能解析トレース

○

4.6

5.4，7.7

6

JavaVMのスレッドダンプ

○※2

4.7

5.5

7

JavaVMのGCのログ

×

4.8

5.6

8

メモリダンプ

×※2

4.9

−※3

9

JavaVMログファイル※4

×

4.10

5.7

10

エラーリポートファイル

×

4.11

5.8

11

OSの状態・ログ

○

4.12

5.9

12

OSの統計情報

×

4.13

−※3

13

定義情報

○

4.14

−※3

14

作業ディレクトリ

×

4.15

−※3

15

リソースの設定

×

4.16

−※3

16

Webサーバのログ

×

4.17

−※3

17

JavaVMのスタックトレース※3，※5

×

4.18

5.10

18

JavaVMの明示管理ヒープ機能のイベントログ※4

×

4.19

5.11

（凡例）○：取得できる　×：取得できない

注※1

snapshotログの収集対象ディレクトリを追加すれば取得できます。

注※2

あらかじめ障害検知時コマンドなどによって出力されている場合だけ収集できます（snapshotログ収集時には，これらのダンプを出力するコマンドは実行されません）。

注※3

保守員が使用する資料です。

注※4

JavaVM起動オプションを指定している場合に出力されます。取得するためのオプションについては，「4.10　JavaVMログ（JavaVMログファイル）」を参照してください。また，各オプションの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。

注※5

UNIXを使用している場合だけ出力されます。

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

この節では，次のようなトラブルが発生した場合の対処方法および回復方法について説明します。

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

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

データベースセッションフェイルオーバ機能を使用時にトラブルが発生した場合

JPAアプリケーションでトラブルが発生した場合

JavaVMが異常終了した場合

OutOfMemoryError発生時に運用管理エージェントが強制終了した場合

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

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

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

ホスト単位管理モデルを対象とした系切り替えシステムでトラブルが発生した場合

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

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

ここでは，アプリケーションサーバの構成ソフトウェアのプロセスが異常終了したときに，システムを再起動する方法について説明します。

アプリケーションサーバで構築したシステムでは，アプリケーションサーバの構成ソフトウェアのプロセス（論理サーバ）が異常終了したとき，起動順序が設定されていればManagement Serverによって自動的に再起動されます。Management Serverでは，構成ソフトウェアのプロセスを論理サーバとして管理しています。

手動で再起動を実行する場合，異常終了した構成ソフトウェアの起動順序に依存関係があるときは，前提となる構成ソフトウェアが起動していることを確認してから再起動する必要があります。前提となる構成ソフトウェアは，システムの運用形態によって異なります。以降で，構成ソフトウェアの起動順序の依存関係，および構成ソフトウェアの再起動方法について説明します。

ポイント

CTMを利用したシステムでは，CTMによって，すぐに再起動すれば，クライアントにエラーが返却される前にシステムを回復するように設定できます。ただし，リクエストキューの最大登録数を超えた場合は，クライアントにエラーが返却されます。

CTMを利用したシステムについては，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「3.　CTMによるリクエストのスケジューリングと負荷分散」を参照してください。

(1)　構成ソフトウェアのプロセスの起動順序の依存関係

アプリケーションサーバで構築したシステムを構成する構成ソフトウェアの，プロセスの起動順序の依存関係について説明します。

以降は，構成ソフトウェアのプロセスの起動順序の依存関係について説明します。

(a)　プロセスの依存関係

プロセスの依存関係を次の表に示します。

表2‒8　プロセスの依存関係

プロセスの種類

前提プロセス

パフォーマンストレーサ

−

スマートエージェント※1，※2

−

CTMドメインマネジャ※1

スマートエージェント※1，※2

CORBAネーミングサービス

−

CTMデーモン※1

パフォーマンストレーサ

スマートエージェント

CTMドメインマネジャ

CORBAネーミングサービス

J2EEサーバ

パフォーマンストレーサ

スマートエージェント

CTMドメインマネジャ※3

CORBAネーミングサービス※4

CTMデーモン※3

Webサーバ

パフォーマンストレーサ

（凡例）

−：前提プロセスがない

注※1

CTMを使用する場合に起動するプロセスです。

注※2

トランザクションサービスを使用する場合に起動するプロセスです。

注※3

CTMを使用する場合に前提となるプロセスです。

注※4

CORBAネーミングサービスをアウトプロセスで使用する場合に起動するプロセスです。CORBAネーミングサービスをインプロセスで使用する場合は必要ありません。

(2)　プロセスの再起動方法

システムでプロセスが異常終了した場合のプロセスの再起動方法について説明します。

ポイント

CTMに関連するプロセスが異常終了して再起動できない場合は，次の手順で対処してください。

プロセスが再起動できない場合，出力されたエラーメッセージからトラブルの要因を調査する。

ctmrasgetコマンドを実行してCTMの実行環境のバックアップを取得する。

(a)　再起動の手順

プロセスの再起動（回復）手順を次の表に示します。

表2‒9　プロセスの再起動（回復）手順

異常プロセス

開始コマンド

再起動（回復）手順

データベースサーバ

−

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デーモンによって自動再起動されるため，再起動は不要です。

J2EEサーバ

cjstartsv

J2EEサーバを再起動してください。

Webサーバ

−

Webサーバを再起動してください。

（凡例）

−：使用する製品によって開始コマンドが異なる，または該当する開始コマンドがない

注※1

CTMを使用する場合に起動するプロセスです。

注※2

トランザクションサービスを使用する場合に起動するプロセスです。

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

J2EEアプリケーションの強制停止に失敗した場合，J2EEサーバによって，次の情報が出力されます。

メッセージ

メッセージログに出力されます。メッセージログの出力先については，「4.3　アプリケーションサーバのログ（J2EEアプリケーションを実行するシステム）」を参照してください。

スタックトレース

例外ログとスレッドダンプに出力されます。例外ログの出力先については，「4.3　アプリケーションサーバのログ（J2EEアプリケーションを実行するシステム）」を参照してください。スレッドダンプについては，「5.5　JavaVMのスレッドダンプ」を参照してください。

なお，J2EEアプリケーションの強制停止では，内部でメソッドキャンセルが実行されています。メソッドキャンセル実行時に出力される障害情報については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「5.3.13　J2EEアプリケーション実行時間監視で出力されるログ情報」を参照してください。

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

ここでは，データベースセッションフェイルオーバ機能にトラブルが発生した場合の対処方法として，次の2種類のトラブルへの対処について説明します。

J2EEサーバでトラブルが発生した場合

データベースでトラブルが発生した場合

(1)　J2EEサーバでトラブルが発生した場合

データベース上のデータへの変更を含む処理中に，J2EEサーバの障害でプロセスがダウンした場合，データベースのロールバックで障害前の状態に戻るため，システムの整合性が保たれます。J2EEサーバの障害を取り除き，Webアプリケーションを再開することでトラブルを回復できます。

J2EEサーバのホストがハングアップした場合や，ネットワークに障害が発生した場合，データベースの操作が中断されレコードの排他（グローバルセッション情報のロック）が未解放の状態となるときがあります。この場合，J2EEサーバが回復しWebアプリケーションを再開する前に，未解放の排他を解放する必要があります。

参考

未解放の排他の解放には，クライアントからデータベースへの無効接続を検出し，接続セッションを強制終了させるなどの方法があります。未解放の排他の解放について，HiRDBを使用する場合は，マニュアル「HiRDB UAP開発ガイド」のUAP処理時間監視機能に関する説明を参照してください。Oracleを使用する場合は，Oracleのマニュアルを参照してください。

(2)　データベースでトラブルが発生した場合

データベースで障害が発生した場合，データベースを回復すればロールバックで障害前の状態に戻るため，データベースセッションフェイルオーバ機能を使用したWebアプリケーションは業務を再開できます。Webアプリケーションの再起動は必要ありません。

そのほかのデータベース障害時の対応については，各データベースのマニュアルを参照してください。

2.5.4　JavaVMが異常終了した場合

JavaVMで異常終了が発生した場合の対処方法と，異常終了が発生した場合に出力される情報について説明します。

(1)　異常終了時の対処方法

UNIXの場合，異常終了時には，次の手順で対処してください。なお，Windowsの場合には，この対処は不要です。

異常終了が発生したマシン上でjavatraceコマンドを実行します。

javatrace.logファイルが出力されます。javatraceコマンドの実行方法については，「4.18　JavaVMのスタックトレース情報」を参照してください。

取得したjavatrace.logファイルを，エラーリポートファイル（hs_err_pid<プロセスID>.log）とあわせて保守員に送付します。

エラーリポートファイルの取得方法については，「4.11　JavaVM出力メッセージログ（標準出力またはエラーリポートファイル）」を参照してください。

次のコマンドを実行して，JavaVMの実行ファイルやトラブル発生時にロードされていたライブラリ，およびcoreダンプのアーカイブファイルを作成します。

AIXの場合

snapcoreコマンドを実行してください。paxコマンドで圧縮されたアーカイブファイルが作成されます。

Linuxの場合

compressコマンドがインストールされている場合はcar_tar_Zコマンドを実行してください。compressコマンドで圧縮されたアーカイブファイルが作成されます。

gzipコマンドがインストールされている場合はcar_tar_gzコマンドを実行してください。gzipコマンドで圧縮されたアーカイブファイルが作成されます。

作成されたアーカイブファイルを，保守員に送付します。

(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が強制終了します。出力された情報を確認して対処してください。

また，OutOfMemoryハンドリング機能が有効の場合（-XX:+HitachiOutOfMemoryHandlingを設定している場合），OutOfMemoryError発生の要因がJavaヒープ不足またはMetaspace領域不足のときには，強制終了しないことがあります。

強制終了する要因

Javaヒープ不足

Metaspace領域不足

J2SEクラスライブラリでのCヒープ不足

なお，JavaVM処理中にCヒープ不足になった場合は，このオプションの指定に関係なく強制終了します。

終了時には，次のメッセージが出力されます。

java.lang.OutOfMemoryError occurred.
JavaVM aborted because of specified -XX:+HitachiOutOfMemoryAbort options.

強制終了するタイミング

JavaVMが強制終了するタイミングは，オプションの設定によって異なります。

オプションとして-XX:+HitachiOutOfMemoryStackTraceが指定されている場合は，スタックトレースが出力されたあとで終了します。ただし，あらかじめjava.io.File.deleteOnExitメソッドやjava.lang.Runtime.addShutdownHookメソッドによってJavaVM終了時に実行する処理を登録していた場合も，それらは実行されないで強制終了します。

オプションとして-XX:+HitachiOutOfMemoryAbortThreadDumpが指定されている場合は，スレッドダンプを出力したあとで終了します。特に，「Javaヒープ不足」または「Metaspace領域不足」の場合は，オプションとして-XX:+HitachiOutOfMemoryAbortThreadDumpWithJHeapProfも設定されているときには，クラス別統計情報付きスレッドダンプを出力したあとで終了します。

OutOfMemoryハンドリング機能が有効な場合の動作

J2EEサーバを起動するときのオプションとして-XX:+HitachiOutOfMemoryAbortに加えて-XX:+HitachiOutOfMemoryHandlingを設定すると，OutOfMemoryハンドリング機能が有効になります。この場合，JavaヒープまたはMetaspace領域不足が発生した際に，OutOfMemoryのハンドリングによって強制終了するかどうかの判定処理が実行されます。判定処理の結果，次に示すOutOfMemoryErrorスロー条件のすべてに合致した場合は，強制終了が実行されません。

OutOfMemoryErrorスロー条件

Javaヒープ不足，またはMetaspace領域不足が原因のOutOfMemoryである。

Webコンテナ上のWebアプリケーション（Servlet／JSP）が実行中のリクエスト処理，EJBクライアントアプリケーションから呼び出されたEnterprise Beanが実行中の処理，Message-driven Beanが実行中の処理，またはTimer Serviceから呼び出されたEnterprise Beanが実行中の処理で発生したOutOfMemoryである。

OutOfMemoryErrorスロー除外条件に該当しない。

OutOfMemoryErrorスロー除外条件

今回のOutOfMemoryが発生した時刻から過去1時間以内のJavaヒープ不足が原因のOutOfMemoryの発生回数と，Metaspace領域不足が原因のOutOfMemoryの発生回数の合計値（今回のOutOfMemoryを含む）が，-XX:HitachiOutOfMemoryHandlingMaxThrowCountオプションに指定した値よりも大きい。

詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]HitachiOutOfMemoryHandling（OutOfMemoryハンドリングオプション）」を参照してください。

OutOfMemoryハンドリング機能が有効な場合，Javaヒープ不足，およびMetaspace領域不足が原因のOutOfMemory発生時に，OutOfMemoryの発生頻度に関する情報がJavaVMログファイルに出力されます。

(c)　内部論理エラーが発生した場合

内部論理エラーが発生すると，エラーが発生したJavaVMの情報，調査用のエラーIDおよび問題が発生したスレッドを示すメッセージが，標準出力およびエラーリポートファイル（hs_err_pid<プロセスID>.log）に出力されます。出力された情報を保守員に送付してください。

2.5.5　OutOfMemoryError発生時に運用管理エージェントが強制終了した場合

運用管理エージェント稼働中にjava.lang.OutOfMemoryErrorが発生した場合，ログを出力して，運用管理エージェントは強制終了されます。ログは次の場所に出力されます。

Windowsの場合

<Managerのログ出力ディレクトリ>¥adminagent.javalog[nn].log

UNIXの場合

<Managerのログ出力ディレクトリ>/adminagent.javalog[nn].log

注　[nn]は0〜99の番号を示します。

なお，運用管理エージェントの終了処理ですべての論理サーバを停止する設定をしている場合に，運用管理エージェントが強制終了しても論理サーバは停止しません。運用管理エージェントの終了処理で論理サーバを停止する設定は，adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.finalization.stop_serversキーに「true」を設定します。

また，アプリケーションサーバで提供しているJDK以外を使用している場合は，OutOfMemoryErrorの発生による運用管理エージェントの強制終了はしません。

OutOfMemoryErrorの発生によって運用管理エージェントが強制終了した場合は次の作業を実施してください。

adminagentuser.cfgの次のオプションの設定値を見直します。

次のオプションの設定値を見直してください。

add.jvm.arg=-Xmx

運用管理エージェントを再起動します。

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

JP1と連携したシステムでトラブルが発生した場合，次に示す対処を実施する必要があります。

(1)　JP1/IMと連携したシステムでのトラブルへの対処

JP1/IMと連携したシステムで予想されるトラブルとその対処方法を次に示します。

表2‒10　JP1/IMと連携したシステムで予想されるトラブルとその対処方法

トラブルの種類

対処方法

監視ツリーの自動生成時にトラブルが発生した

トラブルが発生したら，JP1/Baseのプラグインサービスログのファイルに出力されたアダプタコマンドのメッセージを基にトラブルの発生要因を調査してください。JP1/Baseのプラグインサービスログのファイルの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1イベントがJP1/IMに通知されない

アプリケーションサーバで構築したシステムからJP1/IMにJP1イベントが発行されているかどうか，運用管理エージェント・運用監視エージェント・Management Serverのログを確認してください。運用管理エージェント・運用監視エージェント・Management Serverのログの格納場所については，「4.3.1　Component Containerのログの取得」，または「4.4.1　Component Containerのログの取得（バッチアプリケーションを実行するシステム）」を参照してください。

運用管理エージェント・運用監視エージェント・Management Serverのログの内容に応じて，次の対処を実施してください。

JP1イベント発行のログが出力されていない場合，運用管理サーバ※でのJP1イベント発行の設定内容を確認してください。

JP1イベント発行のログが出力されている場合，JP1統合運用管理サーバでのJP1/Baseの構成定義の作成内容を確認してください。また，運用管理サーバ※およびJ2EEサーバでのJP1/Baseのイベントサービスの動作環境設定内容を確認してください。

JP1/IM-Viewのモニタ起動操作を実行したあとWebブラウザが起動しない

モニタ起動コマンドをコピーしたディレクトリに格納されているmngsvrmonitor.logに出力されたメッセージを基にトラブルの発生要因を調査してください。

注※　アプリケーションサーバの運用管理サーバのことです。

(2)　JP1/AJSと連携したシステムでのトラブルへの対処

JP1/AJS連携による運用管理コマンド（mngsvrutil）の自動実行でエラーが発生した場合，JP1/AJS-Viewのジョブネットモニタウィンドウから，トラブルが発生したジョブの詳細情報を表示し，実行結果を確認してください。実行結果詳細に表示されたmngsvrutilコマンドのエラーメッセージを基にトラブルの発生要因を調査してください。JP1/AJS-Viewでの操作の詳細については，マニュアル「JP1/Automatic Job Management System 操作ガイド」を参照してください。

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

1:1系切り替えシステムで，待機系のホストへの系切り替え処理がデータベースサーバの障害（サーバダウンやデッドロックなど）によってタイムアウトした場合の対処について，OSごとに説明します。

(1)　Windowsの場合

ログを取得してから，手動で待機系ホストをオンラインにしてください。

(a)　1:1系切り替えシステムのログの取得

1:1系切り替えシステムでトラブルが発生した場合，クラスタログを取得する必要があります。Windowsを標準パスにインストールした場合のクラスタログの出力先を次に示します。

C:¥WINDOWS¥cluster¥cluster.log

クラスタログには次の情報が出力されます。

クラスタサービスの稼働ログ

VBScriptの構文にエラーがあった場合のエラーメッセージ

汎用スクリプトのResource.LogInformationメソッド

その他のメッセージ

クラスタログの詳細については，Windowsのドキュメントを参照してください。

また，J2EEサーバが動作しない場合は，Component Containerのログも参照してください。

(b)　1:1系切り替えシステムの手動リカバリ

次の手順で，1:1系切り替えシステムを手動でリカバリしてください。

データベースを再起動するなどして，タイムアウトした原因を解消します。

待機系のホストの対象リソースをオンラインにします。

(2)　UNIXの場合

データベースを再起動するなどして，タイムアウトした原因を解消してください。

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

N:1リカバリシステムでトラブルが発生した場合のリカバリ手順について，OSごとに説明します。

(1)　Windowsの場合

N:1リカバリシステムで，待機系のホスト（リカバリ専用サーバ）でのリカバリ処理がデータベースサーバの障害（サーバダウンやデッドロックなど）によってタイムアウトした場合，ログを取得して，手動でリカバリを実行してください。リカバリ手順を次に示します。

N:1系切り替えシステムのログを取得します。

N:1リカバリシステムでトラブルが発生した場合，クラスタログを取得する必要があります。取得するログは，1:1系切り替えシステムでトラブルが発生した場合に取得するログと同じです。取得するログの詳細については，「2.5.7　1:1系切り替えシステムでトラブルが発生した場合」を参照してください。

N:1系切り替えシステムを手動でリカバリします。

次のどちらかの方法で，N:1リカバリシステムを手動でリカバリしてください。

待機系のホストの対象リソースをオンラインにする

J2EEサーバのトランザクション回復コマンド（cjstartrecover）を実行する

(a)　待機系のホストの対象リソースをオンラインにしてリカバリを実行する

待機系のホストの対象リソースをオンラインにしてリカバリを実行する手順について説明します。

データベースを再起動するなどして，タイムアウトした原因を解消します。

待機系のホストの対象リソースをオンラインにします。

(b)　J2EEサーバのトランザクション回復コマンド（cjstartrecover）を実行してリカバリを実行する

J2EEサーバのトランザクション回復コマンド（cjstartrecover）を実行してリカバリを実行する手順について説明します。

データベースを再起動するなどして，タイムアウトした原因を解消します。

待機系のホストの汎用スクリプトの「Dir_Name」に指定したパスにフォルダを作成します。

すでにフォルダが存在する場合は，削除してからフォルダを作成してください。

待機系のホストの汎用スクリプトがオンラインのときに，クラスタのログを参考に，cjstartrecoverを実行します。

リカバリに成功したら，「Dir_Name」に指定したパスに作成したフォルダを削除します。

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

(2)　UNIXの場合

N:1リカバリシステムで，待機系のホスト（リカバリ専用サーバ）でのリカバリ処理がデータベースサーバの障害（サーバダウンやデッドロックなど）によってタイムアウトした場合，次の手順に従って手動でリカバリを実行します。

データベースを再起動するなどして，タイムアウトした原因を解消します。

待機系のホストで，ダウンした実行系のホストに対応するmonbeginを実行します。

# monbegin サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されている実行系のサーバの識別名を指定します。

待機系のホストで，ダウンした実行系のホストに対応するmonactを実行します。

# monact サーバの識別名

下線部分には，serversファイルのオペランド「alias」に指定されている実行系のサーバの識別名を指定します。

これによって，待機系のホスト（リカバリ専用サーバ）で，ダウンした実行系のホストで未決着だったトランザクションのリカバリ処理が実行されます。

参考

serversファイルの定義など，HAモニタでのサーバ対応の環境設定については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「19.5.4　HAモニタの環境設定」を参照してください。

2.5.9　ホスト単位管理モデルを対象とした系切り替えシステムでトラブルが発生した場合

ホスト単位管理モデルを対象とした系切り替えシステムでトラブルが発生した場合の対処は，1:1系切り替えシステムでトラブルが発生した場合と同じです。詳細については，「2.5.7　1:1系切り替えシステムでトラブルが発生した場合」を参照してください。

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

グローバルトランザクションを使用しているEJBクライアントがダウンした場合，グローバルトランザクションをリカバリする必要があります。グローバルトランザクションのリカバリは，EJBクライアントを再起動することで実行できます。

グローバルトランザクションのリカバリの処理が完了したかどうかを確認する方法を次に示します。

アプリケーションサーバでcjlisttrnコマンドを実行して，トランザクションがアクティブな状態になっているかを確認します。cjlisttrnコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlisttrn（稼働中のJ2EEサーバのトランザクション情報の表示）」を参照してください。

リソースアダプタを停止できるかどうかを確認してください。停止できる場合はグローバルトランザクションのリカバリ処理が完了しています。

アプリケーションサーバが正常停止できるかどうかを確認してください。正常停止できる場合はグローバルトランザクションのリカバリ処理が完了しています。

各リソースが提供するツール，コマンドなどを使用して確認してください。

また，複数のEJBクライアントが存在する場合に，どのEJBクライアントがグローバルトランザクションのリカバリに必要なのかを調査する手順を次に示します。

cjlisttrnコマンドを-pendingオプションを指定して実行して未決着のトランザクションを確認します。

実行形式

cjlisttrn [<サーバ名称>] -pending -bqual

実行例

cjlisttrn MyServer -pending -bqual

手順1.で確認した未決着のトランザクションから，次のすべての条件に当てはまるトランザクションがあるかどうかを確認します。

cjlisttrnコマンドを発行するたびに経過時間が増加している

ブランチの種類が「Sub」または「Sub(recovered)」である

グローバルトランザクションIDに，停止したEJBクライアントの起動時に出力されるKFCB40051-IメッセージのTmHashの値が含まれる

これらのすべての条件に当てはまるトランザクションが，グローバルトランザクションのリカバリに必要です。

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

ここでは，トラブルシューティングに関連する留意事項について説明します。

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

**** "OS名（OSバージョンなど含む）"               TZ="タイムゾーン名"                     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クライアントアプリケーションのサブディレクトリ数を正しく管理できません。なお，サブディレクトリ専有モードは，旧バージョンとの互換用のモードです。

2.6.2　CTM使用時の留意事項

ここでは，CTM使用時の留意事項について説明します。CTMでは次のことに注意してください。

CTMの障害情報は，CTMドメイン単位にCTMSPOOL環境変数の下に取得されています。CTMデーモンおよびCTMドメインマネジャのダウンの場合には再開始時にも障害情報を取得するため，障害発生後に障害情報を退避してください。

CTMSPOOL環境変数下のディレクトリは，製品の運用ディレクトリのため，ファイルやディレクトリを削除しないでください。

2.6.3　PRF使用時の留意事項

ここでは，PRF使用時の留意事項について説明します。PRFでは次のことに注意してください。

PRFの障害情報は，PRF識別子単位にPRFSPOOL環境変数の下に取得されています。PRFデーモンのダウンの場合には再開始時にも障害情報を取得するため，障害発生後に障害情報を退避してください。

PRFSPOOL環境変数下のディレクトリは，製品の運用ディレクトリのため，ファイルやディレクトリを削除しないでください。

2.6.4　JavaVMの資料に関する留意事項

ここでは，JavaVMの資料に関する留意事項について説明します。

次に示すJavaVMの資料は，マルチバイト文字をサポートしていません。日本語のクラス名称など，該当する文字の部分は文字化けします。

JavaVMのスレッドダンプログファイル

JavaVMログファイル

エラーリポートファイル（JavaVM出力メッセージログ）

明示管理ヒープ機能のイベントログファイル

次に示すオプションでJIS X0213:2004の第三水準および第四水準の文字が含まれる名称を指定すると，製品のJavaVMログファイルや明示管理ヒープ機能のイベントログファイルは出力されません。

-XX:HitachiJavaLogオプション

-XX:HitachiExplicitMemoryJavaLogオプション

また，拡張スレッドダンプのファイルの出力先ディレクトリに，JIS X0213:2004の第三水準および第四水準の文字が含まれる場合，拡張スレッドダンプはファイルに出力されません。

3　トラブルシューティングのための準備

アプリケーションサーバで構築したシステムでは，トラブル発生時に自動でトラブルシューティングに必要な情報を取得できます。トラブルシューティングに必要な資料には，運用開始前に準備が必要なものもあります。この章では，それぞれの資料取得の設定方法について説明します。

3.1　この章の構成

トラブルシューティングに関する説明のうち，トラブルシューティングに必要な資料を取得するための設定について説明します。

トラブルシューティングに必要な資料の一部は，運用を開始する前に設定が必要です。また，デフォルトで設定されているログの出力先，サイズなどを変更することもできます。

トラブル発生時に取得する情報のうち，次に示す情報を取得するためには，運用を開始する前に設定が必要です。

JavaVMログ（JavaVMログファイル）

このファイルには，JavaVMのGCのログも出力されます。

ユーザダンプ（Windowsの場合）

coreダンプ（UNIXの場合）

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

これらの情報については，必要に応じてシステム構築時に取得するための設定をしてください。

この章の構成を次の表に示します。

表3‒1　この章の構成（トラブルシューティング（資料取得の設定））

分類

タイトル

参照先

解説

資料取得の設定の概要

3.2

設定

実行環境での設定

3.3

なお，トラブルシューティングの概要，資料の出力方法および出力内容については，それぞれ次の個所を参照してください。

トラブルシューティングの概要と，資料を自動で出力する方法

「2.　トラブルシューティング」

収集する資料の出力先と，資料を個別に出力する方法

「4.　トラブルシューティングで必要な資料の出力先と出力方法」

資料に出力される内容

「5.　トラブルの分析」

3.2　資料取得の設定の概要

トラブルシューティングに必要な資料のうち，一部の資料は，運用を開始する前に資料取得のための設定をしておく必要があります。例えば，OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合），JavaVMのGCのログなどは，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。

また，デフォルトの設定で取得できるようになっている資料については，特に設定は不要ですが，ログの出力先やサイズなどを変更したい場合には，簡易構築定義ファイルやユーザ定義ファイルを編集して，設定を変更してください。

トラブルシューティングに必要な資料と，事前設定または設定変更の対象となる資料との対応を次の表に示します。

表3‒2　トラブルシューティングに必要な資料と，事前設定または設定変更の対象となる資料との対応

トラブルシューティングに必要な資料

事前設定または設定変更の対象となる資料

アプリケーションサーバのログ

メッセージログ

snapshotログ

Management Serverのログ

J2EEサーバのログ

バッチサーバのログ

Webサーバのログ

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

Managerのログ

コンソールログ

リソースアダプタのログ

TPBrokerのトレースファイル

CJMSプロバイダのログ

サーバ管理コマンドのログ

NIO HTTPサーバのログ

ユーザログ

例外ログ

保守用ログ

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

メッセージログ

システムログ※

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

ユーザログ

例外ログ

保守用ログ

性能解析トレース

性能解析トレースファイル

JavaVMのスレッドダンプ

JavaVMの資料

JavaVMのGCのログ

JavaVMの資料

メモリダンプ

ユーザダンプ（Windowsの場合）

coreダンプ（UNIXの場合）

JavaVMログファイル

JavaVMの資料

エラーリポートファイル

−

コンパイルリプレイファイル

−

OSの状態・ログ

−

OSの統計情報

OSの統計情報

定義情報

−

作業ディレクトリ

−

リソースの設定

−

Webサーバのログ

−

JavaVMのスタックトレース

−

明示管理ヒープ機能のイベントログ

JavaVMの資料

（凡例）−：事前設定，設定変更の対象となる資料なし

注

この表のほかに，事前設定または設定変更の対象となる資料に，稼働情報ファイルがあります。稼働情報ファイルは，機能ごとにサーバ性能，リソースの情報などの稼働情報を取得できるファイルで，システムの運用監視に利用できます。稼働情報ファイルはデフォルトで取得できます。

注※

EJBクライアントアプリケーションのシステムログについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」の「3.8　EJBクライアントアプリケーションのシステムログ出力」を参照してください。

この節では，アプリケーションを実行するシステムごとに，事前設定または設定変更の対象となる資料の種類と設定の概要について説明します。

3.2.1　設定できる内容

ここでは，資料取得方法として設定できる内容について説明します。

トラブルシューティングで使用する資料の一部では，取得方法として次の内容を設定できます。設定できる内容は，資料によって異なります。

資料を取得するかどうか

資料の出力先

出力先ファイルの面数

出力先ファイルの切り替え方法

なお，次のプロセスが出力する資料の一部では，出力先ファイルを切り替えるタイミング，および切り替えの際のファイル名の付与規則を選択できます。

J2EEサーバ

運用管理エージェント

Management Server※

仮想サーバマネージャの内部構築ツール

サーバ通信エージェント

注※　統合ログに対してシフトモードを設定した場合に対象になります。

ここでは，これらのプロセスで選択できる出力先ファイルを切り替えるタイミング，およびファイル名の付与規則について説明します。

(1)　出力先ファイルを切り替えるタイミング

一部の資料では，資料の出力先ファイルを切り替える方法を次の2種類から選択できます。

ファイルサイズで切り替える方法

出力先ファイルのファイルサイズが一定のサイズになったタイミングで，ログの出力先を次のファイルに切り替える方法です。ファイルサイズは資料ごとに指定できます。ただし，一部の資料ではファイルサイズは固定です。

時刻とファイルサイズで切り替える方法

指定した時刻になったタイミング，または出力先のファイルサイズが一定のサイズになったタイミングで，ログの出力先を次のファイルに切り替える方法です。

切り替え方法は，プロセス単位で設定できます。

時刻とファイルサイズで切り替える方法を選択した場合に，時刻だけで切り替えるようにしたいときは，ファイルサイズとして，想定しているログの出力量よりも大きい値を指定してください。また，時刻で出力先ファイルが切り替わった場合に作成される新しいファイルのヘッダ情報は，ログを出力するプロセスがログの初期化を行った日時になります。

なお，時刻とファイルサイズで切り替える方法の対象になるファイルについては，「5.2　アプリケーションサーバのログ」を参照してください。

注意事項

時刻とファイルサイズで切り替える方法を選択した場合，OSのリソースの負荷状況によって，出力先ファイルを切り替えるタイミングが，指定した時刻よりも数ミリ秒〜数秒遅れることがあります。

また，指定した時刻にログ出力を行うプロセス（J2EEサーバなど）が起動していない場合，指定した時刻を過ぎたあとの次回起動時に切り替えは行わず，既存ファイルに追加書きします。例えば，切り替える時刻を12:00:00に指定し，11:00:00にプロセスを停止した場合，13:00:00に起動したプロセスは，既存のファイルにログを追加書きします。

(2)　出力先ファイル切り替え時のファイル名付与規則

出力先ファイルには，資料ごとに固有の文字列と通番で構成されたファイル名が設定されます。通番の付与規則は，次の2種類のモードから選択できます。

ラップアラウンドモード

資料固有の文字列がxxxの場合，xxx1.log，xxx2.log…のように通番が付与されたファイルが作成されます。通番の範囲は，1〜（出力先ファイル面数）です。出力先ファイル面数分のファイルが作成されたあとで出力先変更が発生すると，資料の出力先が通番1のファイルに切り替わります。

ラップアラウンドモードの場合のファイル名付与規則を次の図に示します。

図3‒1　ラップアラウンドモードの場合のファイル名付与規則

シフトモード

その時点で資料が出力されているファイルは，資料固有の文字列だけのファイル名になります。通番は付与されません。指定した時刻に出力先が切り替わったあとで，過去のファイルに対して通番が付与されます。

資料固有の文字列がxxxの場合，その時点で資料が出力されるファイルは，xxx.log（通番なしのファイル名）になります。過去の出力先ファイル名は，xxx1.log，xxx2.log…のように通番が付与されたファイル名に変更（リネーム）されます。このとき，通番が小さいファイルから順に，新しいファイルとなります。

通番の範囲は，1〜（出力先ファイル面数）です。このため，ファイルの合計数は，指定した出力先ファイル面数＋1（現在の出力先ファイル分）となります。

シフトモードの場合の出力先切り替えの流れを次の図に示します。

図3‒2　シフトモードの場合の出力先切り替えの流れ

シフトモードの対象になるファイルについては，「5.2　アプリケーションサーバのログ」を参照してください。

なお，Windowsの場合，ファイルが削除される際に，ほかのプロセスが使用中のファイルが一時的に退避されることがあります。この場合，元のファイル名の末尾に「#removed#[n]」（nは0以上の整数）が付与されたファイルが一時的に作成されます。このファイルは，すべてのプロセスからのそのファイルに対する処理が完了したあとで，自動的に削除されます。

3.2.2　資料取得の設定の概要（J2EEアプリケーションを実行するシステム）

資料のデフォルトの設定（ログの出力先やサイズ）を変更する場合や，デフォルトで取得できない資料を取得する場合には，簡易構築定義ファイルやユーザ定義ファイルを編集して設定します。ここでは，J2EEアプリケーションを実行するシステムで，事前に資料（ログ）を取得するための設定が必要かどうかについて説明します。また，設定方法の概要についても説明します。

資料の種類ごとに資料取得のために設定が必要なもの，デフォルトの資料取得の設定を変更する場合だけ設定が必要なものに分けて，次の表に示します。

資料取得のために設定が必要な資料

表3‒3　資料取得のための設定（J2EEアプリケーションを実行するシステム）

資料の種類

資料取得のための設定

参照先マニュアル

参照個所

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

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ロガーやハンドラの設定，ログの出力レベル，サイズ，面数などを設定します。また，server.policyで，セキュリティポリシーを設定します。

アプリケーションサーバ 機能解説 拡張編

8章

OSの統計情報

Windowsの場合，Windowsのシステムモニタでシステムリソースのパフォーマンスデータ取得の設定をします。

このマニュアル

3.3.14

ユーザダンプ

Windowsの場合，タスクマネージャ，Windowsのデバッグツール，または環境変数（CJMEMDUMP_PATH）で，ユーザダンプ取得の設定をします。

このマニュアル

3.3.15

coreダンプ

UNIXの場合，簡易構築定義ファイルやシェルコマンドで，coreファイル取得の設定をします。

このマニュアル

3.3.16

JavaVMの資料

簡易構築定義ファイルで，JavaVMのスレッドダンプやJavaVMログ（JavaVMログファイル）の出力方法や出力内容などの設定をします。また，明示管理ヒープ機能のイベントログを出力するファイル名や，ログの出力レベルなどを設定します。

このマニュアル

3.3.17

デフォルトの資料取得の設定を変更する場合だけ設定が必要な資料

表3‒4　資料取得のための設定（J2EEアプリケーションを実行するシステム）

資料の種類

資料取得のための設定

参照先マニュアル

参照個所

snapshotログ

snapshotログの収集先，収集方法や収集のタイミングを変更する場合には，ユーザ定義ファイルを編集します。

このマニュアル

3.3.1，3.3.3

Management Serverのログ

mserver.properties（Management Server環境設定ファイル）で，ログの出力レベルや，ログファイルの面数などを設定します。

このマニュアル

3.3.5

性能解析トレースファイル

mserver.properties（Management Server環境設定ファイル）で，性能解析トレースファイルの面数を設定します。

また，簡易構築定義ファイルで，論理パフォーマンストレーサ（performance-tracer）の<configuration>タグ内に，パフォーマンストレーサのトレース取得レベルや，PFRトレースファイルの面数などを指定します。

このマニュアル

7.5

J2EEサーバのログ

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数などを設定します。

また，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledで，システムログ出力の設定が有効になっている場合，J2EEサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合，syslog）に出力されます。

このマニュアル

3.3.6

Webサーバのログ

簡易構築定義ファイルで，論理Webサーバ（web-server）の<configuration>タグ内に，Webサーバのログの出力レベル，出力先などを設定します。

このマニュアル

3.3.8

NIO HTTPサーバのログ

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，NIO HTTPサーバのログ出力の有無，ファイル面数などを設定します。また，アクセスログは，フォーマットを定義することで，出力形式をカスタマイズできます。

NIO HTTPサーバのアクセスログのカスタマイズについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「7.11.2　NIO HTTPサーバのアクセスログのカスタマイズ」を参照してください。

このマニュアル

3.3.9

稼働情報ファイル

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，稼働情報ファイルの出力先や面数などを設定します。

アプリケーションサーバ 機能解説 運用／監視／連携編

3.3.3

Managerのログ

manager.cfgで統合ログの面数やサイズを指定します。

このマニュアル

3.3.10

コンソールログ

adminagent.propertiesでコンソールログの出力の有無，面数やサイズを設定します。

アプリケーションサーバ 機能解説 運用／監視／連携編

11.3

リソースアダプタのログ

サーバ管理コマンドを使用して，リソースアダプタ単位でのログ出力の有無を設定します。

また，簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数を設定します。

このマニュアル

3.3.11

TPBrokerのトレースファイル

簡易構築定義ファイル（論理J2EEサーバ（j2ee-server）の<configuration>タグ内），サーバ管理コマンド用のusrconf.bat（UNIXの場合はusrconf）とusrconf.propertiesで，トレースファイルの出力先や面数などを設定します。

このマニュアル

3.3.12

CJMSプロバイダのログ

commonconfig.propertiesまたはconfig.propertiesと，admin.propertiesで，CJMSPブローカーおよび管理コマンド（cjmsicmd）のログの出力レベル，面数，ログファイルサイズを設定します。

また，Connector属性ファイルで，CJMSPリソースアダプタのログの出力レベル，面数，ログファイルサイズを設定します。

このマニュアル

3.3.13

サーバ管理コマンドのログ

サーバ管理コマンド用のusrconf.bat（UNIXの場合はusrconf）とusrconf.propertiesで，ログの出力レベルなどを設定できます。

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

3.4

ここに示したログは，snapshotログで一括収集できます。ただし，TPBrokerのトレースファイルについては，収集できるものと収集できないものが混在しています。このほかにも，snapshotログのデフォルトの設定で取得できないログについては，取得のための設定をしたり，snapshotログの収集先に追加したりする必要があります。また，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）については，固定のファイル名に対して収集します。障害発生時に収集するためには，ユーザ作成の障害検知時コマンドを利用する必要があります。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合

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

ログの種類やデフォルト値，チャネル名，取得できるログの詳細や取得方法については，「2.4　取得が必要な資料の種類」を参照してください。

3.2.3　資料取得の設定の概要（バッチアプリケーションを実行するシステム）

資料のデフォルトの設定（ログの出力先やサイズ）を変更する場合や，デフォルトで取得できない資料を取得する場合には，簡易構築定義ファイルやユーザ定義ファイルを編集して設定します。ここでは，バッチアプリケーションを実行するシステムで，事前に資料（ログ）を取得するための設定が必要かどうかについて説明します。また，設定方法の概要についても説明します。

資料の種類ごとに資料取得のために設定が必要なもの，デフォルトの資料取得の設定を変更する場合だけ設定が必要なものに分けて，次の表に示します。

資料取得のために設定が必要な資料

表3‒5　資料取得のための設定（バッチアプリケーションを実行するシステム）

資料の種類

資料取得のための設定

参照先マニュアル

参照個所

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

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ロガーやハンドラの設定，ログの出力レベル，サイズ，面数などを設定します。また，server.policyで，セキュリティポリシーを設定します。

アプリケーションサーバ 機能解説 拡張編

8章

OSの統計情報

Windowsの場合，Windowsのシステムモニタでシステムリソースのパフォーマンスデータ取得の設定をします。

このマニュアル

3.3.14※

ユーザダンプ

Windowsの場合，Windowsのデバッグツールで，ユーザダンプ取得の設定をします。

このマニュアル

3.3.15※

coreダンプ

UNIXの場合，簡易構築定義ファイルやシェルコマンドで，coreファイル取得の設定をします。

このマニュアル

3.3.16※

JavaVMの資料

簡易構築定義ファイルで，JavaVMのスレッドダンプやJavaVMログ（JavaVMログファイル）の出力方法や出力内容などの設定をします。また，明示管理ヒープ機能のイベントログを出力するファイル名や，ログの出力レベルなどを設定します。

このマニュアル

3.3.17※

注※

J2EEサーバの場合と設定方法に差異はありません。参照先の記述の「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

デフォルトの資料取得の設定を変更する場合だけ設定が必要な資料

表3‒6　資料取得のための設定（バッチアプリケーションを実行するシステム）

資料の種類

資料取得のための設定

参照先マニュアル

参照個所

snapshotログ

snapshotログの収集先，収集方法や収集のタイミングを変更する場合には，ユーザ定義ファイルを編集します。

このマニュアル

3.3.2，3.3.4

Management Serverのログ

mserver.properties（Management Server環境設定ファイル）で，ログの出力レベルや，ログファイルの面数などを設定します。

このマニュアル

3.3.5※

性能解析トレースファイル

mserver.properties（Management Server環境設定ファイル）で，性能解析トレースファイルの面数を設定します。

また，簡易構築定義ファイルで，論理パフォーマンストレーサ（performance-tracer）の<configuration>タグ内に，パフォーマンストレーサのトレース取得レベルや，PFRトレースファイルの面数などを指定します。

このマニュアル

7.5※

バッチサーバのログ

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数などを設定します。

また，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledで，システムログ出力の設定が有効になっている場合，バッチサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合，syslog）に出力されます。

このマニュアル

3.3.7

稼働情報ファイル

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，稼働情報ファイルの出力先や面数などを設定します。

アプリケーションサーバ 機能解説 運用／監視／連携編

3.3.3

Managerのログ

manager.cfgで統合ログの面数やサイズを指定します。

このマニュアル

3.3.10※

コンソールログ

adminagent.propertiesでコンソールログの出力の有無，面数やサイズを設定します。

アプリケーションサーバ 機能解説 運用／監視／連携編

11.3※

リソースアダプタのログ

サーバ管理コマンドを使用して，リソースアダプタ単位でのログ出力の有無を設定します。

また，簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数を設定します。

このマニュアル

3.3.11※

TPBrokerのトレースファイル

簡易構築定義ファイル（論理J2EEサーバ（j2ee-server）の<configuration>タグ内），サーバ管理コマンド用のusrconf.bat（UNIXの場合はusrconf）とusrconf.propertiesで，トレースファイルの出力先や面数などを設定します。

このマニュアル

3.3.12※

サーバ管理コマンドのログ

サーバ管理コマンド用のusrconf.bat（UNIXの場合はusrconf）とusrconf.propertiesで，ログの出力レベルなどを設定できます。

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

3.4

注※

J2EEサーバの場合と設定方法に差異はありません。参照先の記述の「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

ここに示したログは，snapshotログで一括収集できます。ただし，TPBrokerのトレースファイルについては，収集できるものと収集できないものが混在しています。このほかにも，snapshotログのデフォルトの設定で取得できないログについては，取得のための設定をしたり，snapshotログの収集先に追加したりする必要があります。また，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）については，固定のファイル名に対して収集します。障害発生時に収集するためには，ユーザ作成の障害検知時コマンドを利用する必要があります。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合

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

ログの種類やデフォルト値，チャネル名，取得できるログの詳細や取得方法については，「2.4　取得が必要な資料の種類」を参照してください。

3.3　実行環境での設定

トラブルシューティングに必要な資料のうち，運用を開始する前に設定が必要な資料や，デフォルトの設定を変更できる資料があります。この節では，各資料の設定方法について説明します。なお，事前設定または設定変更の対象となる資料については，「3.2　資料取得の設定の概要」を参照してください。

3.3.1　障害検知時コマンドによる資料取得の設定（J2EEアプリケーションを実行するシステム）

ここでは，トラブルシューティングの資料を障害検知時コマンドで取得するための設定について説明します。障害検知時コマンドで取得した資料はsnapshotログとして収集できます。

障害検知時コマンドには，システムで提供しているコマンドとユーザが作成したコマンドの2種類があります。デフォルトの設定では，論理サーバにトラブルが発生した場合にシステム提供の障害検知時コマンドが実行されて，スレッドダンプや性能解析トレースなどが取得されます。また，トラブルが発生した論理サーバの停止前にsnapshotログが収集されます。システム提供の障害検知時コマンドで取得できる情報については，「2.3.2(1)　システムで提供されている障害検知時コマンドで取得できる情報」を参照してください。

システム提供の障害検知時コマンドの動作設定を変更する場合には，「3.3.1(1)　Management Serverでの環境設定」および「3.3.1(2)　運用管理エージェントでの環境設定」が必要です。また，ユーザ作成の障害検知時コマンドを利用する場合は，「3.3.1(1)　Management Serverでの環境設定」，「3.3.1(2)　運用管理エージェントでの環境設定」および「3.3.1(3)　ユーザ作成の障害検知時コマンドのコマンドファイル作成」が必要です。それぞれの設定内容について，(1)〜(3)で説明します。

注意事項

ユーザ作成の障害検知時コマンドで取得した資料をsnapshotログとして収集するためには，その資料の取得先をsnapshotログの収集先に追加する必要があります。snapshotログの収集先の追加については，「3.3.3(3)　snapshotログの収集先のカスタマイズ」を参照してください。

(1)　Management Serverでの環境設定

mserver.properties（Management Server環境設定ファイル）で，障害検知時コマンドの動作を設定します。

次のキーで，障害検知時コマンドの動作を設定します。

キー

説明

設定の要否

システム

ユーザ

com.cosminexus.mngsvr.sys_cmd.abnormal_end.enabled

システム提供の障害検知時コマンドを利用するかどうかを指定します。デフォルトは，true（利用する）です。

△

−

com.cosminexus.mngsvr.usr_cmd.abnormal_end.enabled

ユーザ作成の障害検知時コマンドを利用するかどうかを指定します。デフォルトは，false（利用しない）です。

−

○

com.cosminexus.mngsvr.sys_cmd.abnormal_end.timeout

システム提供の障害検知時コマンドの終了を待つ時間を指定します。指定時間を経過してもコマンドが終了しない場合は，ユーザ回復処理を続行します。

△

−

com.cosminexus.mngsvr.usr_cmd.abnormal_end.timeout

ユーザ作成の障害検知時コマンドの終了を待つ時間を指定します。

−

△

com.cosminexus.mngsvr.snapshot.auto_collect.enabled

障害発生時，または一括再起動時にsnapshotログを取得するかどうかを指定します。デフォルトは，true（snapshotログを取得する）です。

△

△

com.cosminexus.mngsvr.snapshot.collect.point

snapshotログの収集タイミングとして，次のどちらかを指定します。

論理サーバの停止前

J2EEサーバの再起動前

デフォルトは，論理サーバの停止前です。

△

△

（凡例）

システム：システム提供の障害検知時コマンドでの設定の要否を示す

ユーザ：ユーザ作成の障害検知時コマンドでの設定の要否を示す

○：設定は必要

△：デフォルトの設定を変更する場合だけ必要

−：設定は不要

(2)　運用管理エージェントでの環境設定

adminagent.properties（運用管理エージェントプロパティファイル）で，障害検知時コマンドで取得する資料を設定します。

adminagent.propertiesの次のキーで，障害検知時コマンドで取得する資料の数や取得の有無，障害検知時コマンドのパスなどを設定します。なお，snapshotログの収集先を定義するためのsnapshotログ収集対象定義ファイルについては，「3.3.3(3)　snapshotログの収集先のカスタマイズ」を参照してください。

キー

説明

設定の要否

システム

ユーザ

adminagent.snapshotlog.num_snapshots

一次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。

△

△

adminagent.snapshotlog.listfile.2.num_snapshots

二次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。

△

△

adminagent.j2ee.sys_cmd.abnormal_end.threaddump

システム提供の障害検知時コマンドで，スレッドダンプを取得するかどうかを指定します。

△

−

adminagent.sys_cmd.abnormal_end.prftrace

システム提供の障害検知時コマンドで，性能解析トレースファイルを取得するかどうかを指定します。

△

−

adminagent.<論理サーバの種類>.usr_cmd.abnormal_end

論理サーバの種類ごとに，実行する障害検知時コマンドのパスを指定します。

−

○

（凡例）

システム：システム提供の障害検知時コマンドでの設定の要否を示す

ユーザ：ユーザ作成の障害検知時コマンドでの設定の要否を示す

○：設定は必要

△：デフォルトの設定を変更する場合だけ必要

−：設定は不要

(3)　ユーザ作成の障害検知時コマンドのコマンドファイル作成

ユーザ作成の障害検知時コマンドは，コマンドファイル（バッチファイルまたはシェルスクリプトファイル）に記述できます。このとき，次の表に示す環境変数をコマンドファイルに記述しておくことで，障害の発生した論理サーバの情報や障害に関する情報を利用してコマンドを実行できます。

表3‒7　ユーザ作成の障害検知時コマンドのコマンドファイルに記述できる環境変数

環境変数

説明

COSMI_MNG_LSNAME

障害の発生した論理サーバの論理サーバ名。なお，論理CTM内のネーミングサービスで障害が発生した場合は，論理CTMの論理サーバ名が設定されます。

COSMI_MNG_RSNAME

障害の発生した論理サーバの実サーバ名。J2EEサーバ以外の論理サーバの場合，論理サーバ名が設定されます。

COSMI_MNG_LSPID

論理サーバ起動時に監視対象となったプロセスID。間接起動の論理ユーザサーバで複数のプロセスIDが監視対象である場合，論理ユーザサーバ起動時に実行されるプロセスID取得用コマンドで取得された順に，コンマ（,）で区切って設定されます。

COSMI_MNG_LSARGS

論理サーバを起動したときのコマンドライン。

COSMI_MNG_TIME_SUSPENDED

ハングアップを検知した時刻。万国標準時（UTC）の1970年1月1日午前0時からの経過時間（単位：ms）。なお，無応答を検知しない場合，値は設定されません。

COSMI_MNG_TIME_TERMINATED

異常停止（プロセスダウン）を検知した時刻。万国標準時（UTC）の1970年1月1日午前0時からの経過時間（単位：ms）。なお，ハングアップの場合，値は設定されません。

COSMI_MNG_WEB_SYSTEM

障害が発生した論理サーバが所属するWebシステム。Smart Composer機能を使用しない場合，値は設定不要です。

COSMI_MNG_TIER

障害が発生した論理サーバが所属する物理ティア。Smart Composer機能を使用しない場合，値は設定不要です。

COSMI_MNG_UNIT

障害が発生した論理サーバが所属するサービスユニット。Smart Composer機能を使用しない場合，値は設定不要です。

COSMI_MNG_HWS

HTTP Serverのインストールディレクトリ。

なお，障害検知コマンドとして実行するコマンドから出力される標準出力，標準エラー出力は，Management Serverでは取得しません。このため，コマンドの標準出力，標準エラー出力を取得する場合は，コマンドの中でファイルに出力する必要があります。

(a)　coreダンプの取得例

J2EEサーバの障害発生時にkillコマンドを実行してcoreダンプを取得する場合の例を次に示します。

UNIXの場合

#!/bin/sh

# 障害がプロセスダウンかハングアップかを，プロセスダウンを検知した時刻から判断する。
if [ "$COSMI_MNG_TIME_TERMINATED" = "" ] ; then

# 障害がハングアップであるため，coreダンプを取得する。
/bin/kill -6 $COSMI_MNG_LSPID
fi

(b)　スレッドダンプの取得例

Webサーバの障害発生時に，cjdumpsvコマンドを実行してJ2EEサーバ（実サーバ名：J2EEServer）のスレッドダンプを取得する場合の例を次に示します。

この例では，時間の経過に応じた各スレッドの状態遷移を確認するため，複数回cjdumpsvコマンドを実行しています。cjdumpsvコマンドは，目安として3秒おきに10回程度実行します。

Windowsの場合

rem 障害がプロセスダウンかハングアップかを環境変数から判断する。
if defined COSMI_MNG_TIME_TERMINATED goto END

rem 障害がハングアップであるため，スレッドダンプを取得する。
set COUNT=10
set INTERVAL=3000
for /l %%n in (1,1,%COUNT%) do (
"C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin¥cjdumpsv.exe" J2EEServer
   if not "%%n" == "%COUNT%" (
       rem 次のスレッドダンプ取得まで待機する。(ミリ秒)
       echo WScript.sleep %INTERVAL% > sleep.vbs
       "C:¥WINDOWS¥¥system32¥cscript.exe" sleep.vbs > NUL
       del sleep.vbs
   )
)
:END

UNIXの場合

#!/bin/sh

# 障害がプロセスダウンかハングアップかを環境変数から判断する。
if [ "$COSMI_MNG_TIME_TERMINATED" = "" ] ; then

# 障害がハングアップであるため，スレッドダンプを取得する。
COUNT=10
INTERVAL=3
for num in `seq $COUNT`
do
  /opt/Cosminexus/CC/server/bin/cjdumpsv J2EEServer
  if [ "$num" -ne  "$COUNT" ]; then
      # 次のスレッドダンプ取得まで待機する。(秒)
      sleep $INTERVAL
  fi
done
fi

(c)　ユーザ作成の障害検知時コマンドの動作

論理CTMでは，グローバルCORBAネーミングサービスとCTMデーモンの二つのプロセスが起動，停止，監視されます。そのため，論理CTM内のグローバルCORBAネーミングサービスの障害を検知した場合とCTMデーモンの障害を検知した場合とでは，実行するコマンドが異なります。

グローバルCORBAネーミングサービスの障害を検出した場合

adminagent.naming.usr_cmd.abnormal_endキーで指定したコマンドが実行されます。

CTMデーモンの障害を検出した場合

adminagent.ctm.usr_cmd.abnormal_endキーで指定したコマンドが実行されます。

また，論理CTM内の二つのプロセス（CTMデーモン，グローバルCORBAネーミングサービス）のどちらのプロセスで障害を検知しても，Management Serverのログには，論理サーバ（CTM）の障害検知時コマンドの開始を通知するログが出力されます。

3.3.2　障害検知時コマンドによる資料取得の設定（バッチアプリケーションを実行するシステム）

ここでは，トラブルシューティングの資料を障害検知時コマンドで取得するための設定について説明します。障害検知時コマンドで取得した資料はsnapshotログとして収集できます。

障害検知時コマンドには，システムで提供しているコマンドとユーザが作成したコマンドの2種類があります。デフォルトの設定では，論理サーバにトラブルが発生した場合にシステム提供の障害検知時コマンドが実行されて，スレッドダンプや性能解析トレースなどが取得されます。また，トラブルが発生した論理サーバの停止前にsnapshotログが収集されます。システム提供の障害検知時コマンドで取得できる情報については，「2.3.2(1)　システムで提供されている障害検知時コマンドで取得できる情報」を参照してください。

システム提供の障害検知時コマンドの動作設定を変更する場合には，Management Serverおよび運用管理エージェントでの環境設定が必要です。また，ユーザ作成の障害検知時コマンドを利用する場合は，Management Serverおよび運用管理エージェントでの環境設定と，ユーザ作成の障害検知時コマンドのコマンドファイル作成が必要です。それぞれの設定内容については，「3.3.1　障害検知時コマンドによる資料取得の設定（J2EEアプリケーションを実行するシステム）」を参照してください。その際に，「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

注意事項

ユーザ作成の障害検知時コマンドで取得した資料をsnapshotログとして収集するためには，その資料の取得先をsnapshotログの収集先に追加する必要があります。snapshotログの収集先の追加については，「3.3.3(3)　snapshotログの収集先のカスタマイズ」を参照してください。

3.3.3　snapshotログ収集の設定（J2EEアプリケーションを実行するシステム）

ここでは，snapshotログ収集のための設定について説明します。snapshotログとして収集するファイルの設定や，収集したsnapshotログの格納先などの設定を変更できます。

(1)　snapshotログを収集するタイミングごとに収集できる資料

snapshotログの収集方法を変更するための設定を収集タイミングごとに次の表に示します。

表3‒8　snapshotログ収集を変更するための設定（J2EEアプリケーションを実行するシステムの場合）

分類

収集のタイミング

デフォルトの設定を変更するために必要な設定

自動的に収集する※

論理サーバが障害時に自動停止される直前

障害検知時コマンドの設定

snapshotログの収集先のカスタマイズ

snapshotログ収集のタイムアウトの設定

J2EEサーバが障害時に自動再起動される直前

J2EEサーバを手動で一括再起動する直前

snapshotログの収集先のカスタマイズ

任意のタイミングで収集する

Management Serverの運用管理コマンド（mngsvrutil）でsnapshotログの収集を実行したとき

注※　論理サーバの停止前，またはJ2EEサーバの再起動前のどちらのタイミングでsnapshotログを収集するかは，mserver.propertiesのcom.cosminexus.mngsvr.snapshot.collect.pointキーで変更できます。デフォルトの設定では，論理サーバの停止前にsnapshotログが収集されます。

次に，タイミングごとに収集できる資料について説明します。

(a)　自動的に収集する場合

次に示すどちらかのタイミングでsnapshotログを自動的に収集する場合には，Management Serverによって障害検知時コマンドが実行されて，スレッドダンプと性能解析トレースなどの資料が取得されます。

論理サーバが障害時に自動停止される直前（デフォルトの設定）

J2EEサーバが障害時に自動再起動される直前

障害検知時コマンドで取得された資料は，snapshotログとして収集できます。障害検知時コマンドの動作や設定の変更については，「3.3.1　障害検知時コマンドによる資料取得の設定（J2EEアプリケーションを実行するシステム）」を参照してください。

(b)　任意のタイミングで収集する場合

任意のタイミングでsnapshotログを収集する場合には，スレッドダンプファイルやユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）が出力されているときだけ，snapshotログとして収集できます。任意のタイミングでsnapshotログを収集する際に，コマンドが実行されてスレッドダンプファイルやユーザダンプまたはcoreダンプが出力されることはありません。

Management Serverの運用管理コマンド（mngsvrutil）を実行して任意のタイミングでsnapshotログを収集する場合は，コマンド実行時に収集先の種別（種別1，種別2）を指定して収集できます。それ以外のタイミングでは，種別1と種別2それぞれの収集対象として定義されているファイルがすべて収集されます。

(2)　snapshotログで収集できるファイル

トラブルシューティングに必要な資料は，資料を保守員へ送付するときのタイミングによって，一次送付資料と二次送付資料に分類されます。snapshotログでは，一次送付資料と二次送付資料を収集できます。各資料については，「2.3.3(2)　snapshotログとして収集できる資料」を参照してください。

一次送付資料としてどのファイルを収集するかは，一次送付資料用のsnapshotログ収集対象定義ファイル（snapshotlog.conf）で指定します。mngsvrutilコマンドで引数snapshot 1を指定してsnapshotログを収集する場合は，snapshotlog.confに指定されているファイルが収集されます。二次送付資料としてどのファイルを収集するかは，二次送付資料用のsnapshotログ収集対象定義ファイル（snapshotlog.2.conf）で指定します。mngsvrutilコマンドで引数snapshot 2を指定してsnapshotログを収集する場合は，snapshotlog.confとsnapshotlog.2.confに指定されているファイルが収集されます。

デフォルトでsnapshotログの収集先として定義されていないファイルをsnapshotログとして収集したい場合には，そのファイルの出力先をsnapshotログ収集対象定義ファイルに追加してください。また，資料によっては，次のような設定も必要になります。

運用開始前の資料取得のための設定

運用開始前に，資料取得のための設定をしておく必要があります。

コマンドなどによる資料の取得

snapshotログとして収集する前に，コマンドを実行して収集対象の資料を取得しておく必要があります。資料の取得については，「4.　トラブルシューティングで必要な資料の出力先と出力方法」を参照してください。

（例）

Windowsの場合

ユーザダンプは，運用開始前に環境変数（CJMEMDUMP_PATH）の設定が必要です。また，環境変数（CJMEMDUMP_PATH）を設定した場合にはsnapshotログの収集先を変更する必要があります。

UNIXの場合

coreダンプは，運用開始前にcoreファイルのサイズの設定が必要です。運用開始前に取得のための設定をした上で，ユーザ作成の障害検知時コマンドを使用して障害発生時のcoreダンプを取得し，そのcoreダンプをsnapshotログとして収集することをお勧めします。また，デフォルトのsnapshotログ収集対象定義ファイルには，coreダンプのデフォルトの出力先が指定されています。

運用開始前に実施する取得のための設定については，「3.3.15　ユーザダンプ取得の設定」，または「3.3.16　coreダンプ取得の設定」を参照してください。ユーザ作成の障害検知時コマンドについては，「3.3.1　障害検知時コマンドによる資料取得の設定（J2EEアプリケーションを実行するシステム）」を参照してください。

snapshotlog.confおよびsnapshotlog.2.confの指定については，「3.3.3(3)　snapshotログの収集先のカスタマイズ」を参照してください。デフォルトの設定で一次送付資料および二次送付資料として収集できる資料については，「付録A　snapshotログの収集対象一覧」を参照してください。

(3)　snapshotログの収集先のカスタマイズ

snapshotログの収集先は，snapshotログ収集対象定義ファイルでカスタマイズできます。また，adminagent.propertiesでは，論理サーバごとのsnapshotログのファイル数を指定できます。ファイルの詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「10.2.1　snapshotログ収集対象定義ファイル」を参照してください。

(a)　snapshotログの収集先の指定

snapshotログ収集対象定義ファイルを編集して，snapshotログの収集先を指定してください。snapshotログ収集対象定義ファイルの格納場所を次に示します。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config¥snapshotlog.conf

<製品のインストールディレクトリ>¥manager¥config¥snapshotlog.2.conf

UNIXの場合

/opt/Cosminexus/manager/config/snapshotlog.conf

/opt/Cosminexus/manager/config/snapshotlog.2.conf

snapshotlog.confでは，一次送付資料として収集するファイルの格納ディレクトリを指定します。また，snapshotlog.2.confでは，二次送付資料として収集するファイルの格納ディレクトリを指定します。

snapshotログ収集対象定義ファイルでは，収集対象のパスに変数を使用できます。例えば，製品のインストールディレクトリを表す変数「${cosminexus.home}」を使用して，snapshotログ収集対象定義ファイルに「${cosminexus.home}/manager/log/.+」（ピリオド（.）は任意の文字，プラス（+）は1回以上を表します）と指定すると，<製品のインストールディレクトリ>¥manager¥log（Windowsの場合），または/opt/Cosminexus/manager/logディレクトリ（UNIXの場合）直下のファイルがすべて収集されます。なお，snapshotログ収集対象定義ファイルの変数の値には，ドル記号（$）を含めないでください。

(b)　snapshotログのファイル数の指定

論理サーバごとのsnapshotログファイルの数は，adminagent.propertiesの次のキーで変更できます。デフォルトの設定は10です。adminagent.propertiesについては，マニュアル「アプリケーションサーバ リファレンス定義編(サーバ定義)」の「8.2.1　adminagent.properties（運用管理エージェントプロパティファイル）」を参照してください。

adminagent.snapshotlog.num_snapshots

一次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。

adminagent.snapshotlog.listfile.2.num_snapshots

二次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。

(c)　snapshotログの格納先の指定

snapshotログの収集によって自動で取得された情報の格納先は，adminagent.propertiesのadminagent.snapshotlog.log_dirキーで変更できます。デフォルトの設定では，次のディレクトリに格納されます。

Windowsの場合

<Managerのログ出力ディレクトリ>¥snapshot

UNIXの場合

<Managerのログ出力ディレクトリ>/snapshot

adminagent.propertiesについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.1　adminagent.properties（運用管理エージェントプロパティファイル）」を参照してください。

(4)　snapshotログ収集のタイムアウトの設定

snapshotログ収集時に実行する処理に対してタイムアウトを設定できます。タイムアウトは，mserver.propertiesで設定します。snapshotログ収集時に実行する処理とタイムアウトの設定を次の表に示します。

表3‒9　snapshotログ収集時に実行する処理とタイムアウトの設定

処理

タイムアウトの設定（mserver.propertiesのキー）

説明

システム提供の障害検知時コマンドの実行

com.cosminexus.mngsvr.sys_cmd.abnormal_end.timeout

次に示すそれぞれの処理の終了を待つ時間です。

システム提供の障害検知時に実行したコマンド

性能解析トレースの収集

指定した時間を経過してもコマンド，または性能解析トレースの収集が終了しない場合は，実行したコマンド，または性能解析トレースの収集を無視して処理を続行します。

ユーザ作成の障害検知時コマンドの実行

com.cosminexus.mngsvr.usr_cmd.abnormal_end.timeout

ユーザ作成の障害検知時に実行したコマンドの終了を待つ時間です。指定した時間を経過してもコマンドが終了しない場合は，実行したコマンドを無視して処理を続行します。

snapshotログ（一次送付資料）の収集

com.cosminexus.mngsvr.snapshot.auto_collect.timeout

一次送付資料および二次送付資料の収集の終了を待つ時間です。指定した時間を経過しても収集が終了しない場合は，Management Serverから運用管理エージェントにsnapshotログ収集中止のサービス要求が実行され，Management ServerのログにKEOS20052-Eメッセージが出力されます。

snapshotログ（二次送付資料）の収集

mserver.propertiesについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.6　mserver.properties（Management Server環境設定ファイル）」を参照してください。

3.3.4　snapshotログ収集の設定（バッチアプリケーションを実行するシステム）

ここでは，バッチサーバを使用している場合の，snapshotログ収集のための設定について説明します。snapshotログとして収集するファイルの設定や，収集したsnapshotログの格納先などの設定を変更できます。snapshotログの収集方法を変更するための設定を収集タイミングごとに次の表に示します。なお，このほかの説明については，J2EEサーバの場合と同じです。詳細は，「3.3.3　snapshotログ収集の設定（J2EEアプリケーションを実行するシステム）」を参照してください。

表3‒10　snapshotログ収集を変更するための設定（バッチアプリケーションを実行するシステムの場合）

分類

収集のタイミング

デフォルトの設定を変更するために必要な設定

自動的に収集する※

論理サーバが障害時に自動停止される直前

障害検知時コマンドの設定

snapshotログの収集先のカスタマイズ

snapshotログ収集のタイムアウトの設定

バッチサーバが障害時に自動再起動される直前

バッチサーバを手動で一括再起動する直前

snapshotログの収集先のカスタマイズ

任意のタイミングで収集する

Management Serverの運用管理コマンド（mngsvrutil）でsnapshotログの収集を実行したとき

注※　論理サーバの停止前，またはバッチサーバの再起動前のどちらのタイミングでsnapshotログを収集するかは，mserver.propertiesのcom.cosminexus.mngsvr.snapshot.collect.pointキーで変更できます。デフォルトの設定では，論理サーバの停止前にsnapshotログが収集されます。

3.3.5　Management Serverのログ取得の設定

ここでは，Management Serverが出力するログを取得するための設定について説明します。

Management Serverのログの出力先ディレクトリを次に示します。Management Serverの出力先はmanager.cfg（Managerログ設定ファイル）で変更できます。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥log

UNIXの場合

/opt/Cosminexus/manager/log

Management Serverのログの出力レベルや，ログファイルの面数などを変更する場合は，mserver.properties（Management Server環境設定ファイル）で，次のキーを指定します。

com.cosminexus.mngsvr.log.level

Management Serverのログの出力レベルを指定します。

com.cosminexus.mngsvr.log.rotate

Management Serverのログのファイル面数を指定します。

com.cosminexus.mngsvr.log.size

Management Serverのログのファイルサイズを指定します。

mserver.propertiesおよび各キーの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.6　mserver.properties（Management Server環境設定ファイル）」を参照してください。

注意事項

UNIXの場合，Managerのログ出力ディレクトリは，アクセス権に777（rwxrwxrwx）が設定されて，自動的に作成されます。あらかじめ手動で作成したディレクトリをログ出力先に指定する場合は，ディレクトリのアクセス権に777（rwxrwxrwx）を設定してください。ログ出力先に指定したディレクトリのアクセス権に777（rwxrwxrwx）が設定されていない場合，コマンド実行時にログが出力されないことがあります。

3.3.6　J2EEサーバのログ取得の設定

ここでは，J2EEサーバのログ取得で設定できる項目について説明します。

J2EEサーバのログは，ログの出力先，ログサイズ，ログレベル，ログの出力先ファイルの切り替え方法およびログの出力先ファイルの切り替え時刻を変更できます。変更できる項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。

表3‒11　J2EEサーバのログ取得の設定項目

項目

対応する簡易構築定義ファイルのパラメタ

ログの出力先

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejb.server.log.directory

ログサイズ

ログファイル面数

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filenum

ログファイル1面当たりの最大サイズ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filesize

ログレベル

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.enabled.*

ログの出力先ファイルの切り替え方法

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.rotationStyle

ログの出力先ファイルの切り替え時刻

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.rotationTime

なお，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledパラメタでtrue（デフォルト値）を指定した場合，またはこのパラメタの指定を省略した場合は，J2EEサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合は，syslog）に出力されます。

注意事項（UNIXの場合）

J2EEサーバの起動，停止および異常終了のメッセージをsyslogに出力するためには，syslogの設定で，facility「daemon」に対するpriorityを「info」または「debug」に設定する必要があります。また，syslogのログ出力先およびログファイル名は，syslogの設定に依存します。

syslogおよびsyslogの設定に関する詳細については，OS付属のマニュアルで，syslogdまたはsyslog.confの説明を参照してください。

簡易構築定義ファイルに指定するパラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

(1)　ログの出力先の変更

J2EEサーバのログの出力先を変更する場合は，簡易構築定義ファイルでログの出力先ディレクトリを指定します。

ログの出力先の変更

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

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名>¥logs

UNIXの場合

<作業ディレクトリ>/ejb/<サーバ名>/logs

なお，作業ディレクトリのデフォルトは，<製品のインストールディレクトリ>¥CC¥server¥public（Windowsの場合），または/opt/Cosminexus/CC/server/public（UNIXの場合）です。

作業ディレクトリおよびJ2EEサーバのログの出力先は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定すると変更できます。

ejb.public.directory

J2EEサーバの作業ディレクトリのパスを指定します。

ejb.server.log.directory

J2EEサーバのログの出力先ディレクトリを指定します。

設定例（物理ティアの定義の場合）

Windowsの場合

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejb.server.log.directory</param-name>
    <param-value>C:¥CClogs¥server¥MyServer</param-value>
  </param>
  ：
</configuration>

UNIXの場合

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejb.server.log.directory</param-name>
    <param-value>/CClogs/server/MyServer</param-value>
  </param>
  ：
</configuration>

カレントディレクトリ

ログ出力先を相対パスで指定する場合のカレントディレクトリを次に示します。

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合

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

注意事項

ログの出力先を変更した場合は，J2EEサーバを起動する前に，変更後のログの出力先ディレクトリを作成しておいてください。

変更後のログの出力先ディレクトリがない場合は，J2EEサーバの起動時にKDJE40024-Eのメッセージが出力されて異常終了します。また，サーバ管理コマンドの実行時にKDJE37209-E，KDJE37210-E，KDJE37211-Eのメッセージが出力されて異常終了します。

同一ホスト内で複数のJ2EEサーバを起動させている場合は，ログ出力先が同じディレクトリにならないように，ディレクトリにサーバ名称を含めるなど，サーバごとにユニークなディレクトリ名になるようにしてください。なお，パラメタの値に同じディレクトリを指定した場合は，動作の保証はしません。

ログの出力先を変更して作業ディレクトリ以外にログを出力する場合，ログファイルはサーバのアンセットアップ時に削除されません。ログファイルを削除したい場合には，手動で削除してください。

簡易構築定義ファイルでログの出力先を設定していても，JavaVM起動パラメタでJavaVMの保守情報およびGCのログ出力先が設定されていると，JavaVM起動パラメタの設定が優先されますので，注意してください。

JavaVM起動パラメタは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

XX:HitachiJavaLog:<JavaVMの保守情報およびGCのログ出力先>

JavaVM起動パラメタを指定している場合は，JavaVMの保守情報およびGCのログ出力先に設定したディレクトリに，JavaVMの保守情報およびGCのログファイルが出力されます。

ログ出力先には，UNC名を含むパスは指定できません。

(2)　ログサイズの変更

J2EEサーバのログサイズを変更する場合は，簡易構築定義ファイルで，ログファイルの面数，およびログファイル1面当たりの最大サイズを設定します。

ログファイル面数の変更

J2EEサーバのログファイルの面数は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.channels.define.<チャネル名>.filenumパラメタで指定します。

設定例（物理ティアの定義の場合）

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.channels.define.MessageLogFile.filenum</param-name>
    <param-value>3</param-value>
  </param>
  ：
</configuration>

ログファイル1面当たりの最大サイズの変更

J2EEサーバのログファイル1面当たりの最大サイズ（単位：バイト）は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.channels.define.<チャネル名>.filesizeパラメタで指定します。

設定例（物理ティアの定義の場合）

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.channels.define.MessageLogFile.filesize</param-name>
    <param-value>2097152</param-value>
  </param>
  ：
</configuration>

(3)　ログレベルの変更

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

ログレベルは，簡易構築定義ファイルの論理J2EEサーバの<configuration>タグ内に，ejbserver.logger.enabled.*パラメタで設定します。ejbserver.logger.enabled.*の<param-value>タグにはレベル名を，「Error」，「Warning」，「Information」，「Debug」の文字列で一つ，または複数設定します。複数設定する場合には，レベル名の文字列の間をコンマ（,）で区切ります。

設定例（物理ティアの定義の場合）

1.

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.enabled.*</param-name>
    <param-value>Error</param-value>
  </param>
  ：
</configuration>

2.

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.enabled.*</param-name>
    <param-value>Error,Warning</param-value>
  </param>
  ：
</configuration>

3.

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.enabled.*</param-name>
    <param-value>Error,Warning,Information</param-value>
  </param>
  ：
</configuration>

4.

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.enabled.*</param-name>
    <param-value>Error,Warning,Information,Debug</param-value>
  </param>
  ：
</configuration>

注意事項

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

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

ログレベルの推奨設定

ログレベルの推奨設定を次に示します。

通常運用時

レベル名に「Error」を指定します。

通常運用時（verbose）

通常運用時よりも詳細な情報を取得する場合には，レベル名に「Error,Warning」を指定します。

テスト時

レベル名に「Error,Warning,Information」を指定します。

障害調査時

レベル名に「Error,Warning,Information,Debug」を指定します。

3.3.7　バッチサーバのログ取得の設定

バッチサーバのログは，ログの出力先，ログサイズ，ログレベルを変更できます。変更できる項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。なお，これらのパラメタは，簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

表3‒12　バッチサーバのログ取得の設定項目

項目

対応する簡易構築定義ファイルのパラメタ

ログの出力先

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejb.server.log.directory

ログサイズ

ログファイル面数

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filenum

ログファイル1面当たりの最大サイズ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filesize

ログレベル

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.enabled.*

なお，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledパラメタでtrue（デフォルト値）を指定した場合，またはこのパラメタの指定を省略した場合は，バッチサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合は，syslog）に出力されます。

それぞれの設定項目の詳細については，「3.3.6　J2EEサーバのログ取得の設定」を参照してください。その際に，「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

また，簡易構築定義ファイルに指定するパラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

注意事項（UNIXの場合）

バッチサーバの起動，停止および異常終了のメッセージをsyslogに出力するためには，syslogの設定で，facility「daemon」に対するpriorityを「info」または「debug」に設定する必要があります。また，syslogのログ出力先およびログファイル名は，syslogの設定に依存します。

syslogおよびsyslogの設定に関する詳細については，OS付属のマニュアルで，syslogdまたはsyslog.confの説明を参照してください。

3.3.8　Webサーバのログ取得の設定

ここでは，Webサーバのログ取得で設定できる項目について説明します。ログ取得の設定対象となるWebサーバは，HTTP Serverです。

Webサーバが出力するログには，エラーログ，アクセスログ，リクエストログなどがあります。出力するログの詳細については，マニュアル「HTTP Server」を参照してください。Webサーバの出力するログのうち，エラーログ，アクセスログおよびリクエストログは，出力先やログの出力方式などを簡易構築定義ファイルで変更できます。

Webサーバのログ取得で変更できる設定項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。

表3‒13　Webサーバのログ取得の設定項目

ログ

項目

対応する簡易構築定義ファイルのパラメタ

エラーログ

出力するエラーログのレベル

論理Webサーバ（web-server）の<configuration>タグ内のLogLevel

エラーログの出力方式

論理Webサーバ（web-server）の<configuration>タグ内のHttpsdErrorMethod

エラーログの出力先ディレクトリ

論理Webサーバ（web-server）の<configuration>タグ内のHttpsdErrorLogFileDir

アクセスログ

アクセスログの出力方式

論理Webサーバ（web-server）の<configuration>タグ内のHttpsdCustomMethod

アクセスログの出力先ディレクトリ

論理Webサーバ（web-server）の<configuration>タグ内のHttpsdCustomLogFileDir

アクセスログ出力時のフォーマット

論理Webサーバ（web-server）の<configuration>タグ内のHttpsdCustomlogFormat

リクエストログ

トレースの採取有無

論理Webサーバ（web-server）の<configuration>タグ内のHWSRequestLogLevel

リクエストログの出力方式

論理Webサーバ（web-server）の<configuration>タグ内のHttpsdRequestMethod

リクエストログの出力先ディレクトリ

論理Webサーバ（web-server）の<configuration>タグ内のHttpsdRequestLogFileDir

また，エラーログ，アクセスログおよびリクエストログに出力する時刻ならびに時間の単位を，論理Webサーバ（web-server）の<configuration>タグ内のHWSLogTimeVerboseパラメタで指定できます。

注意事項

Management Serverを利用してWebサーバの動作確認をする場合に，動作確認用のログを通常のログ（アクセスログ）と別に出力するときには，簡易構築定義ファイルでの設定が必要です。論理Webサーバ（web-server）の<configuration>タグ内でSetByパラメタに「item」を指定して，AppendDirectivesパラメタとHttpsdCustomlogFormatパラメタを設定してください。

AppendDirectivesパラメタとHttpsdCustomlogFormatパラメタの設定例を次に示します。ここでは，動作確認用のログをラップアラウンド方式で取得する場合を例にして説明します。ログの出力方式に応じて，AppendDirectivesパラメタ内のCustomLogディレクティブの記述を変更してください。

AppendDirectivesパラメタの設定例

Windowsの場合

<param>
  <param-name>AppendDirectives</param-name>
  <param-value>
<![CDATA[
SetEnvIf Remote_Addr ^127¥.0¥.0¥.1$ Env_ManagerHealthCheck
CustomLog "|¥"¥"<製品のインストールディレクトリ>/httpsd/sbin/rotatelogs2.exe¥" ¥"<製品のインストールディレクトリ>/httpsd/servers/HWS_<論理Webサーバの実サーバ名>/logs/access_manager¥" 8192 5¥"" hws_std env=Env_ManagerHealthCheck
]]>
  </param-value>
</param>

UNIXの場合

<param>
  <param-name>AppendDirectives</param-name>
  <param-value>
<![CDATA[
SetEnvIf Remote_Addr ^127¥.0¥.0¥.1$ Env_ManagerHealthCheck
CustomLog "|/opt/hitachi/httpsd/sbin/rotatelogs2 ¥"/opt/hitachi/httpsd/servers/HWS_<論理Webサーバの実サーバ名>/logs/access_manager¥" 8192 5" hws_std env=Env_ManagerHealthCheck
]]>
  </param-value>
</param>

HttpsdCustomlogFormatパラメタの設定例

<param>
  <param-name>HttpsdCustomlogFormat</param-name>
  <param-value>hws_std env=!Env_ManagerHealthCheck</param-value>
</param>

3.3.9　NIO HTTPサーバのログ取得の設定

ここでは，NIO HTTPサーバのログ取得で設定できる項目について説明します。

NIO HTTPサーバのログ取得で変更できる設定項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。

表3‒14　NIO HTTPサーバのログ取得の設定項目

ログおよびトレース

項目

対応する簡易構築定義ファイルのパラメタ

アクセスログ

アクセスログのフォーマットの形式

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.access_log.nio_http.format※

アクセスログのファイルサイズ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.NIOHTTPAccessLogFile.filesize

アクセスログのファイル面数

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.NIOHTTPAccessLogFile.filenum

性能解析トレース

−

ほかの性能解析トレースと同様に，日常的なシステム運用の作業で，cprfedコマンドを実行するときに取得条件などを指定します。性能解析トレースファイルの取得については，「7.　性能解析トレースを使用した性能解析」を参照してください。

（凡例）−：該当しない

注※　アクセスログでは，これらのキーでフォーマットを定義することで，ログの出力形式をカスタマイズできます。NIO HTTPサーバのアクセスログのカスタマイズについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「7.11.2　NIO HTTPサーバのアクセスログのカスタマイズ」を参照してください。

3.3.10　Managerのログ取得の設定

運用管理エージェント，運用監視エージェント，およびManagement Serverのログには，個別に取得する以外に，統合ログとしてまとめて取得できるものがあります。統合ログとして取得できるのは，統合メッセージログファイル，統合トレースログファイル，コマンド保守ログファイルです。なお，統合ログとして取得できるログの詳細については，「4.3　アプリケーションサーバのログ（J2EEアプリケーションを実行するシステム）」を参照してください。

ここでは，統合ログの設定の変更について説明します。統合ログは，manager.cfgで設定します。manager.cfgの格納場所を次に示します。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config¥manager.cfg

UNIXの場合

/opt/Cosminexus/manager/config/manager.cfg

統合ログの設定を変更する場合には，manager.cfgで次のキーを設定してください。

com.cosminexus.manager.log.dir

統合ログの出力先を指定します。なお，デフォルトの設定では，次の場所に出力されます。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥log

UNIXの場合

/opt/Cosminexus/manager/log

com.cosminexus.manager.messagelog.size

統合メッセージログファイルの1ファイル当たりの最大サイズを指定します。

com.cosminexus.manager.messagelog.fnum

統合メッセージログファイルの面数を指定します。

com.cosminexus.manager.messagelog.style

統合メッセージログファイルの出力先の切り替え方法を指定します。SHIFT（シフトモード）を指定した場合，com.cosminexus.manager.messagelog.timeが有効になります。

com.cosminexus.manager.messagelog.time

統合メッセージログファイルの出力先を切り替える時刻を指定します。

com.cosminexus.manager.tracelog.size

統合トレースログファイルの1ファイル当たりの最大サイズを指定します。

com.cosminexus.manager.tracelog.fnum

統合トレースログファイルの面数を指定します。

com.cosminexus.manager.tracelog.style

統合トレースログファイルの出力先の切り替え方法を指定します。SHIFT（シフトモード）を指定した場合，com.cosminexus.manager.tracelog.timeが有効になります。

com.cosminexus.manager.tracelog.time

統合トレースログファイルの出力先を切り替える時刻を指定します。

com.cosminexus.manager.cmdtracelog.size

コマンド保守ログファイルの1ファイル当たりの最大サイズを指定します。

com.cosminexus.manager.cmdtracelog.fnum

コマンド保守ログファイルの面数を指定します。

com.cosminexus.manager.log.compatible

運用管理エージェント，およびManagement Serverのログを個別で出力するかどうかを指定します。デフォルトの設定では，統合ログと同時に個別のログも出力されます。個別のログを出力しない場合には，falseを指定してください。

3.3.11　リソースアダプタのログ取得の設定

ここでは，リソースアダプタログを取得するための設定について説明します。リソースアダプタのログを取得するために必要な設定は次の二つです。

ログ出力の有無の設定

サーバ管理コマンドで，リソースアダプタ単位でのログ出力の有無を設定します。cjgetrarpropコマンドでConnector属性ファイルを取得し，<property>タグでLogEnabledにtrueを指定します。ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。なお，リソースアダプタをデプロイする前にプロパティを定義する場合は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。

Connector属性ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。コマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。サーバ管理コマンドの操作については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.　サーバ管理コマンドの基本操作」を参照してください。

ログのサイズ，面数，ログレベルの設定

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで，リソースアダプタのログのサイズ，面数を設定します。

ejbserver.connector.logwriter.filesize

リソースアダプタのログファイル1面当たりの最大サイズ（単位：バイト）を指定します。

ejbserver.connector.logwriter.filenum

リソースアダプタのログファイルの面数を指定します。

また，J2EEサーバのログの出力レベル（ログレベル）がリソースアダプタのログレベルになります。J2EEサーバのログレベルの設定については，「3.3.6(3)　ログレベルの変更」を参照してください。

注意事項

CJMSPリソースアダプタの場合，ログサイズ，面数，ログレベルの設定方法が，ほかのリソースアダプタと異なります。詳細は，「3.3.13　CJMSプロバイダのログ取得の設定」を参照してください。

リソースアダプタのログ出力先ディレクトリのパスの長さと，リソースアダプタ表示名の長さを加えた長さがOSのパス長の制限を超えた場合，リソースアダプタのログの初期化に失敗し，KDJE90002-Eメッセージを出力後サーバが停止します。これは，ログファイルが別のプロセスでロックされている場合などに発生します。

次のどちらかの手段で，リソースアダプタのログが最大パス長を超えないようにしてください。詳細は，マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

・リソースアダプタ表示名の長さを変更

・ログ出力先ディレクトリ，または作業ディレクトリを変更

また，ログファイルを別のプロセスでロックしないでください。

リソースアダプタのログの初期化に失敗した場合，KDJE90002-Eメッセージを出力したあと，J2EEサーバが停止します。これは，リソースアダプタのログ出力先ディレクトリのパスの長さと，リソースアダプタ表示名の長さを加えた長さがOSのパス長の制限を超えた場合や，ログファイルがほかのプロセスでロックされている場合などに発生します。

リソースアダプタ表示名の長さを変更するか，またはログ出力先ディレクトリもしくは作業ディレクトリを変更して，リソースアダプタのログが最大パス長を超えないようにしてください。また，ほかのプロセスでログファイルをロックしないようにしてください。

3.3.12　TPBrokerのログ取得の設定

ここでは，TPBrokerのトレースファイルの出力先，ファイル数，エントリ数の変更について説明します。

TPBrokerのトレースファイルのデフォルトの出力先は次のとおりです。

J2EEサーバのトレース情報の場合

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合

<作業ディレクトリ>/ejb/<サーバ名称>/logs/TPB/logj

サーバ管理コマンドのトレース情報の場合

Windowsの場合

<製品のインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj

UNIXの場合

/opt/Cosminexus/CC/admin/logs/TPB/logj

EJBクライアントアプリケーションのトレース情報の場合

Windowsの場合

<EJBクライアントログ出力ディレクトリ>※¥system¥TPB¥logj

UNIXの場合

<EJBクライアントログ出力ディレクトリ>※/system/TPB/logj

注※　EJBクライアントログ出力ディレクトリの出力先については，「4.5.2　EJBクライアントアプリケーションのシステムログの出力先」を参照してください。

CTMのトレース情報の場合

Windowsの場合

<製品のインストールディレクトリ>¥TPB¥log

<製品のインストールディレクトリ>¥TPB¥logj

UNIXの場合

/opt/Cosminexus/TPB/log

/opt/Cosminexus/TPB/logj

変更できる項目と，項目に対応する簡易構築定義ファイルのパラメタまたはユーザ定義ファイルとキーを次の表に示します。

表3‒15　TPBrokerのログ取得の設定項目

項目

分類

対応する簡易構築定義ファイルのパラメタまたはユーザ定義ファイルとキー

トレースファイルの出力先

J2EEサーバ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejb.server.log.directory

または

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のvbroker.orb.htc.tracePath

サーバ管理コマンド

usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプション

または

サーバ管理コマンド用のusrconf.propertiesのvbroker.orb.htc.tracePathキー※

EJBクライアントアプリケーション

cjclstartapコマンドの場合，Javaアプリケーション用のusrconf.propertiesのvbroker.orb.htc.tracePathキー

vbjコマンドの場合，vbjコマンドで指定するJavaVMのシステムプロパティのvbroker.orb.htc.tracePathキー

CTM

グローバルCORBAネーミングサービスは，adminagent.xml（運用管理エージェント設定ファイル）の論理サーバ種類がネーミングサービスの個所で，環境変数HVI_TRACEPATHを設定。

CTMドメインマネジャは，論理CTMドメインマネジャ（ctm-domain-manager）の<configuration>タグ内のuser.env.variableで，環境変数HVI_TRACEPATHを設定。

CTMは，論理CTM（component-transaction-monitor）の<configuration>タグ内のuser.env.variableで，環境変数HVI_TRACEPATHを設定。

トレースファイルの面数

J2EEサーバ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のvbroker.orb.htc.comt.fileCount

EJBクライアントアプリケーション

cjclstartapコマンドの場合，Javaアプリケーション用のusrconf.propertiesvbroker.orb.htc.comt.fileCountキー

vbjコマンドの場合，vbjコマンドで指定するJavaVMのシステムプロパティのvbroker.orb.htc.comt.fileCountキー

CTM

グローバルCORBAネーミングサービスは，adminagent.xml（運用管理エージェント設定ファイル）の論理サーバ種類がネーミングサービスの個所で，環境変数HVI_COMTFILECOUNTを設定。

CTMドメインマネジャは，論理CTMドメインマネジャ（ctm-domain-manager）の<configuration>タグ内のuser.env.variableで，環境変数HVI_COMTFILECOUNTを設定。

CTMは，論理CTM（component-transaction-monitor）の<configuration>タグ内のuser.env.variableで，環境変数HVI_COMTFILECOUNTを設定。

トレースファイルのエントリ数

J2EEサーバ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のvbroker.orb.htc.comt.entryCount

EJBクライアントアプリケーション

cjclstartapコマンドの場合，Javaアプリケーション用のusrconf.propertiesvbroker.orb.htc.comt.entryCountキー

vbjコマンドの場合，vbjコマンドで指定するJavaVMのシステムプロパティのvbroker.orb.htc.comt.entryCountキー

CTM

グローバルCORBAネーミングサービスは，adminagent.xml（運用管理エージェント設定ファイル）の論理サーバ種類がネーミングサービスの個所で，環境変数HVI_COMTENTRYCOUNTを設定。

CTMドメインマネジャは，論理CTMドメインマネジャ（ctm-domain-manager）の<configuration>タグ内のuser.env.variableで，環境変数HVI_COMTENTRYCOUNTを設定。

CTMは，論理CTM（component-transaction-monitor）の<configuration>タグ内のuser.env.variableで，環境変数HVI_COMTENTRYCOUNTを設定。

注※　サーバ管理コマンド用のusrconf.batファイル（Windowsの場合）またはusrconfファイル（UNIXの場合），およびusrconf.propertiesについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.3　サーバ管理コマンドの動作設定のカスタマイズ」を参照してください。サーバ管理コマンド用の各ファイルおよびキーの詳細については，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.1　サーバ管理コマンドで使用するファイルの一覧」

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.2.1　usrconf（サーバ管理コマンド用オプション定義ファイル）」

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.2.2　usrconf.bat（サーバ管理コマンド用オプション定義ファイル）」

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.2.3　usrconf.properties（サーバ管理コマンド用システムプロパティファイル）」

簡易構築定義ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

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

vbjコマンドで指定するJavaVMのシステムプロパティの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「12.2.3　Javaアプリケーションに指定するシステムプロパティ」

adminagent.xml（運用管理エージェント設定ファイル）の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.4　adminagent.xml（運用管理エージェント設定ファイル）」を参照してください。

通信トレースの詳細については，マニュアル「TPBroker 運用ガイド」を参照してください。

注意事項

トレースファイルの出力先を変更する場合は，変更後のトレースファイル出力先ディレクトリのサブディレクトリとしてcomtrcとmdltrcをあらかじめ作成しておく必要があります。出力先を変更すると，変更後のログ出力先ディレクトリ下のcomtrcとmdltrcにトレースファイルが出力されます。

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内で，<param-name>にejb.server.log.directoryと，vbroker.orb.htc.tracePathの両方を設定した場合は，vbroker.orb.htc.tracePathの設定が優先されます。

usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプションと，サーバ管理コマンド用のusrconf.propertiesのvbroker.orb.htc.tracePathキーをどちらも設定した場合は，サーバ管理コマンド用のusrconf.propertiesのvbroker.orb.htc.tracePathキーの設定が優先されます。

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

CTMドメインマネジャとCTMでトレースファイルの面数やエントリ数を設定すると，CTMドメインマネジャやCTMデーモンだけでなく，CTMレギュレータやctmstartコマンドなどのプロセスにも有効となります。トレースファイルの面数やエントリ数を大きくする場合は，ディスク使用量の増加に注意してください。

通信トレースファイルのトレースファイルのエントリ数を大きくする場合は，メモリ使用量の増加に注意してください。

3.3.13　CJMSプロバイダのログ取得の設定

ここでは，CJMSプロバイダで使用する，CJMSPブローカー，管理コマンド（cjmsicmd）およびCJMSPリソースアダプタのログの出力レベル，面数，ログファイルサイズなどを変更するための設定について説明します。

CJMSプロバイダでは，次の3種類のログを出力します。

CJMSPブローカーのログ

管理コマンド（cjmsicmd）のログ

CJMSPリソースアダプタのログ

それぞれのデフォルトの出力先を次の表に示します。

表3‒16　CJMSプロバイダのログのデフォルトの出力先

ログの種類

デフォルトの出力先

CJMSPブローカーのログ

Windowsの場合

<CJMSP_HOME>※1¥var¥instances¥<instanceName>¥log

UNIXの場合

<CJMSP_HOME>※1/var/instances/<instanceName>/log

管理コマンド（cjmsicmd）のログ

Windowsの場合

<CJMSP_HOME>※1¥var¥admin¥log

UNIXの場合

<CJMSP_HOME>※1/var/admin/log

CJMSPリソースアダプタのログ

Windowsの場合

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)> ※2¥cjms¥Cosminexus_JMS_Provider_RA

UNIXの場合

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)> ※2/cjms/Cosminexus_JMS_Provider_RA

注※1

<CJMSP_HOME>は，次のディレクトリです。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥cjmsp

UNIXの場合

/opt/Cosminexus/CC/cjmsp

注※2

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>は，J2EEサーバのオプション定義で指定したディレクトリです。デフォルトでは，次のディレクトリになります。

Windowsの場合

<ejb.public.directoryで指定したディレクトリ>¥ejb¥<J2EEサーバ名>¥logs

UNIXの場合

<ejb.public.directoryで指定したディレクトリ>/ejb/<J2EEサーバ名>/logs

なお，デフォルトの出力先がない場合，ログ出力時にディレクトリが作成されます。

(1)　CJMSPブローカーのログ取得の設定

CJMSPブローカーでは，ログ取得の設定のうち，ログの出力レベル，面数，ファイルサイズを変更できます。

変更方法について次の表に示します。

表3‒17　CJMSPブローカーのログ取得の設定の変更方法

項目

変更方法

ログの出力レベル

commonconfig.propertiesまたはconfig.propertiesの次のプロパティで指定します。

broker.logger.MessageLogFile.trace.level

面数

commonconfig.propertiesまたはconfig.propertiesの次のプロパティで指定します。

broker.logger.MessageLogFile.filenum

broker.logger.ExceptionLogFile.filenum

ファイルサイズ

commonconfig.propertiesまたはconfig.propertiesの次のプロパティで指定します。

broker.logger.MessageLogFile.filesize

broker.logger.ExceptionLogFile.filesize

注

CJMSPブローカーでは，cjmsbrokerコマンドの-varhomeオプションでログの出力先を設定できます。ただし，<CJMSP_HOME>¥varディレクトリ（Windowsの場合）または<CJMSP_HOME>/varディレクトリ（UNIXの場合）以外のディレクトリについては，ログの出力先の変更はできません。

なお，指定したディレクトリがない場合，デフォルトの設定が有効になります。

各プロパティの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「6.2.2　commonconfig.properties（CJMSPブローカー共通プロパティファイル）」，およびマニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「6.2.3　config.properties（CJMSPブローカー個別プロパティファイル）」を参照してください。

(2)　管理コマンド（cjmsicmd）のログ取得の設定

管理コマンド（cjmsicmd）では，ログ取得の設定のうち，ログの出力レベル，出力先，面数，ファイルサイズを変更できます。

変更方法について次の表に示します。

表3‒18　管理コマンド（cjmsicmd）のログ取得の設定の変更方法

項目

変更方法

ログの出力レベル

admin.propertiesの次のプロパティで指定します。

admin.logger.MessageLogFile.trace.level

出力先

admin.propertiesの次のプロパティで指定します。

admin.logger.MessageLogFile.filepath

admin.logger.ExceptionLogFile.filepath

面数

admin.propertiesの次のプロパティで指定します。

admin.logger.MessageLogFile.filenum

admin.logger.ExceptionLogFile.filenum

ファイルサイズ

admin.propertiesの次のプロパティで指定します。

admin.logger.MessageLogFile.filesize

admin.logger.ExceptionLogFile.filesize

なお，指定したディレクトリがない場合，デフォルトの設定が有効になります。

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

(3)　CJMSPリソースアダプタのログ取得の設定

CJMSPリソースアダプタでは，ログ取得の設定のうち，ログの出力レベル，面数，ファイルサイズを変更できます。

変更方法について次の表に示します。

表3‒19　CJMSPリソースアダプタのログ取得の設定の変更方法

項目

変更方法

ログの出力レベル

Connector属性ファイルの<resourceadapter>下の<config-property>で，次のプロパティを指定します。

MsgLogLevel

面数

Connector属性ファイルの<resourceadapter>下の<config-property>で，次のプロパティを指定します。

MsgLogFileNum

ExpLogFileNum

ファイルサイズ

Connector属性ファイルの<resourceadapter>下の<config-property>で，次のプロパティを指定します。

MsgLogFileSize

ExpLogFileSize

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

3.3.14　OSの統計情報取得の設定

ここでは，Windowsの場合に，OSの統計情報を取得するための設定について説明します。

Windowsのシステムモニタを使用して，システムリソースのパフォーマンスデータを取得できます。トラブル発生時またはトラブルの兆候が見られる場合には，Windowsのシステムモニタでパフォーマンスデータの取得を開始し，トラブル発生後にパフォーマンスデータのログを保存します。システムモニタの操作の詳細については，OS付属のマニュアルなどを参照してください。

次の表に示すシステムモニタのログを60秒間隔で採取します。なお，具体的な設定方法は，OS付属のマニュアルなどを確認してください。

表3‒20　システムモニタの設定内容

パフォーマンスオブジェクト

インスタンス

項目名

説明

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

実メモリ使用量(バイト)

（凡例）−：該当しない

3.3.15　ユーザダンプ取得の設定

ここでは，Windowsの場合に，ユーザダンプを取得するための設定について説明します。

(1)　タスクマネージャまたはWindowsのデバッグツールを使用する場合

製品がハングアップした場合，トラブルシューティングに必要な資料としてユーザダンプが必要となります。ユーザダンプを取得する場合は，タスクマネージャまたはWindowsのデバッグツールを使用します。詳細は，Microsoft社のホームページを参照してください。

なお，JavaVMの異常終了時にユーザダンプを即座に取得したい場合は，製品を起動する前に，レジストリで次の設定をしておいてください。レジストリの設定は，システム全体に影響を与えることがあるため，設定時には十分注意してください。ただし，cjstartsv.exe，cjstartweb.exe，cjclstartap.exe，およびadminagent.exeについては，製品のインストール時に自動的に設定されます。

レジストリキー

¥¥HKEY_LOCAL_MACHINE¥SOFTWARE¥Microsoft¥Windows¥Windows Error Reporting¥LocalDumps

レジストリ値

DumpCount：<保存するダンプの数>

DumpType：2

(2)　cjstopsvコマンドを使用する場合

cjstopsvコマンドの-fdオプションを使用してユーザダンプを取得する場合は，環境変数「CJMEMDUMP_PATH」にユーザダンプの出力先ディレクトリを指定しておいてください。ユーザダンプのファイル名は，cjmemdump.dmpです。

環境変数「CJMEMDUMP_PATH」の設定例を次に示します。

環境変数「CJMEMDUMP_PATH」の設定例

set CJMEMDUMP_PATH=C:¥temp

この例の場合，C:¥tempの下にcjmemdump.dmpが作成されます。

なお，環境変数「CJMEMDUMP_PATH」を指定する場合には，次の点に注意してください。

保存先のディスクに十分な空き容量があることを確認してください。ユーザダンプのファイルサイズはJ2EEサーバの実メモリ所要量以上になります。

日本語などのマルチバイト文字を含むディレクトリを指定しないでください。ユーザダンプの出力に失敗する場合があります。

ユーザダンプの出力先ディレクトリには，存在するディレクトリを指定してください。

(3)　論理サーバの強制停止時に取得する場合

Management Serverを使用してシステムを構築する場合，論理サーバの強制停止時にユーザダンプを取得するときは，環境変数「CJMEMDUMP_PATH」にユーザダンプの出力先ディレクトリを指定しておいてください。この環境変数を指定しておくと，論理J2EEサーバが強制停止されたときに，この環境変数で指定したディレクトリ下にユーザダンプを取得できます。ユーザダンプのファイル名は，cjmemdump.dmpです。詳細は，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「4.1.11　システムの環境変数を設定する」を参照してください。

3.3.16　coreダンプ取得の設定

ここでは，UNIXの場合に，coreダンプを取得するための設定について説明します。

注意事項

Linuxの仕様によって，coreファイル内のサイズ情報が不正となる場合があります。

(1)　coreファイルのサイズの上限値の設定

システムの動作環境によっては，coreファイルのサイズの上限値が0になっている場合があります。この場合，プロセスのcoreダンプを取得できないため，あらかじめcoreファイルのサイズの上限値を無制限に設定しておく必要があります。coreファイルのサイズの上限値を無制限にするためには，簡易構築定義ファイルまたはオプション定義ファイルでJavaVM起動パラメタにオプションを指定するか，またはシェルコマンドを実行します。

なお，簡易構築定義ファイルまたはオプション定義ファイルでJavaVM起動パラメタに指定するメモリプールサイズが大きいほど，coreファイルのサイズも大きくなるため，十分空きディスク容量を確保してください。

簡易構築定義ファイルでJavaVM起動パラメタにオプションを指定する場合

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，JavaVM起動パラメタを定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-XX:+HitachiFullCore

指定例（物理ティアの定義の場合）

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>add.jvm.arg</param-name>
    <param-value>-XX:+HitachiFullCore</param-value>
  </param>
  ：
</configuration>

オプション定義ファイルでJavaVM起動パラメタにオプションを指定する場合

オプション定義ファイルにJavaVM起動パラメタを定義します。

指定例（Management Server用オプション定義ファイルの場合）

add.jvm.arg=-XX:+HitachiFullCore

シェルコマンドを実行する場合

シェルコマンドを実行して，coreファイルの上限値を無制限にしてください。

csh（Cシェル）の場合の実行例

limit coredumpsize unlimit

sh（標準シェル）の場合の実行例

ulimit -c unlimited

また，これらの設定に加え，シェルコマンドを実行して，一つのファイルサイズの上限値を無制限にしておくことをお勧めします。

csh（Cシェル）の場合の実行例

limit filesize unlimit

sh（標準シェル）の場合の実行例

ulimit -f unlimited

参考

coreファイルのサイズの見積もり式

JavaVMがプロセスダウンした場合に生成されるcoreファイルサイズは，仮想メモリの使用量と同じになります。仮想メモリの使用量の計算式については，次に示すマニュアルを参照してください。coreファイル生成先であるJavaVMプロセスのカレントディレクトリがあるディスクには，常に，このcoreファイルサイズ以上の空き領域が必要です。

J2EEアプリケーション実行基盤の場合

マニュアル「アプリケーションサーバ システム設計ガイド」の「5.3　プロセスごとに使用するメモリの見積もり」

バッチアプリケーション実行基盤の場合

マニュアル「アプリケーションサーバ システム設計ガイド」の「6.3　仮想メモリの使用量の見積もり」

Management Serverと運用管理エージェントの場合

マニュアル「アプリケーションサーバ システム設計ガイド」の「5.3　プロセスごとに使用するメモリの見積もり」およびリリースノートのCosminexus Component Containerが使用するメモリ所要量の「標準」の所要量

(2)　coreファイルのファイル数の上限値の設定

論理J2EEサーバのcoreファイルのファイル数の上限値は，簡易構築定義ファイルの「j2ee-server」の<configuration>タグ内に，ejb.server.corefilenumパラメタで定義できます。ejb.server.corefilenumパラメタは，J2EEサーバの拡張パラメタで定義します。

cjstartsvプロセスの再起動時に「<作業ディレクトリ>/ejb/<サーバ名称>/」に出力されるcoreダンプファイルの合計が上限値を超えた場合，出力日時が古い順に削除されます。

Management Serverのcoreファイルのファイル数の上限値は，Management Server用オプション定義ファイルに，ejb.server.corefilenumパラメタで定義できます。

Management Serverプロセスの再起動時に「<Application Serverのインストールディレクトリ>/manager/containers/m/ejb/<Management Serverのサーバ名>/」に出力されるcoreダンプファイルの合計が上限値を超えた場合，出力日時が古い順に削除されます。

3.3.17　JavaVMの資料取得の設定

ここでは，次に示すJavaVMの資料を取得するための設定について説明します。

JavaVMのスレッドダンプ

JavaVMログ（JavaVMログファイル）

明示管理ヒープ機能のイベントログ

JavaVM起動オプションについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。

なお，JavaVMのスレッドダンプは，デフォルトでは次のディレクトリ下に出力されます。

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合

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

JavaVMログは，デフォルトでは次のディレクトリ下に出力されます。

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs

UNIXの場合

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

出力先を変更したい場合は，JavaVMまたはJ2EEサーバ起動前に，簡易構築定義ファイルで論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで，ログ出力ディレクトリを変更しておく必要があります。

次に，JavaVMのスレッドダンプ，JavaVMログ（JavaVMログファイル）および明示管理ヒープ機能のイベントログについて，それぞれの取得の設定を説明します。

(1)　JavaVMのスレッドダンプ取得の設定

JavaVMのスレッドダンプを取得するための設定について説明します。

JavaVMのスレッドダンプに出力される内容は，簡易構築定義ファイルでJavaVM起動パラメタに指定しているJavaVM起動オプションによって異なります。JavaVM起動オプションは，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，JavaVM起動パラメタで定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

<JavaVM起動オプション>

JavaVM起動オプションに指定するオプションを次の表に示します。なお，オプションの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。

表3‒21　JavaVM起動オプションに指定するオプション（JavaVMのスレッドダンプ取得の設定）

オプション

説明

-XX:+HitachiThreadDump

拡張スレッドダンプを出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpToStdout

拡張スレッドダンプを標準出力に出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithHashCode

スレッド情報にスレッドのハッシュコードを出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithCpuTime

スレッド情報にスレッドを開始してからのユーザCPU時間，およびカーネルCPU時間を出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithBlockCount

スレッド情報にスレッドが処理をブロックした回数，および処理が待ち状態になった回数を出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiOutOfMemoryAbort

-XX:+HitachiOutOfMemoryAbortThreadDump

どちらも設定されている場合は，OutOfMemoryErrorによって強制終了した時に，スレッドダンプを出力します。ただし，J2SEクラスライブラリでCヒープ不足が発生した場合，およびJavaVMの処理中にCヒープ不足が発生した場合は，スレッドダンプを出力しません。

-XX:+HitachiOutOfMemoryAbortThreadDumpWithJHeapProf

OutOfMemoryErrorによって強制終了した時に出力されるスレッドダンプに，クラス別統計情報を出力します。デフォルトでは出力されません。

スレッドダンプファイルの出力先を変更する場合は，JAVACOREDIR環境変数に出力先を指定してください。JAVACOREDIR環境変数の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.7　JavaVMで使用する環境変数の詳細」を参照してください。

(2)　JavaVMログ取得の設定

JavaVMログを取得するための設定について説明します。

JavaVMログとは，製品が標準のJavaVMに追加した拡張オプションを使用して取得できるログです。標準のJavaVMよりも，多くのトラブルシュート情報が取得できます。このログファイルを，JavaVMログファイルといいます。このファイルには，JavaVMのGCのログも出力されます。

JavaVMログファイルを取得するためには，簡易構築定義ファイルでJavaVM起動パラメタにJavaVM起動オプションを指定します。JavaVM起動オプションは，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，JavaVM起動パラメタで定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

<JavaVM起動オプション>

JavaVM起動オプションに指定するオプションを次の表に示します。なお，オプションの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。

表3‒22　JavaVM起動オプションに指定するオプション（JavaVMログ取得の設定）

オプション

説明

-XX:+HitachiOutOfMemoryStackTrace

-XX:+HitachiVerboseGC

-XX:+HitachiOutOfMemoryHandling

-XX:+HitachiJavaClassLibTrace

-XX:+JITCompilerContinuation

次のオプションのうちどれかを指定している場合に，JavaVMログファイルを出力します。

-XX:+HitachiOutOfMemoryStackTraceを指定している場合は，例外情報とスタックトレースをJavaVMログファイルに出力します。なお，このオプションを指定すると，-XX:+HitachiOutOfMemorySizeおよび-XX:+HitachiOutOfMemoryCauseも同時に指定されます。

-XX:+HitachiVerboseGCを指定している場合は，GCが発生したときに，拡張verbosegc情報をJavaVMログファイルに出力します。

-XX:+HitachiOutOfMemoryHandlingを指定している場合は，Javaヒープ不足またはMetaspace領域不足が原因のOutOfMemory発生時に，OutOfMemoryの発生頻度に関する情報をJavaVMログファイルに出力します。

-XX:+HitachiJavaClassLibTraceを指定している場合は，クラスライブラリのスタックトレースをJavaVMログファイルに出力します。

-XX:+JITCompilerContinuationを指定している場合は，JITコンパイラ稼働継続機能が有効になるため，JITコンパイルがアプリケーションを構成するメソッドの論理矛盾で失敗すると，JITコンパイラ稼働継続機能のログをJavaVMログファイルに出力します。

必要に応じて，次の拡張オプションを指定して，JavaVMログファイルの出力方法や出力内容を設定してください。

JavaVMログファイルのファイルサイズやファイル数

拡張verbosegc機能オプション

OutOfMemoryError発生時の拡張機能オプション

クラスライブラリトレース機能オプション

ローカル変数情報出力機能オプション

ログファイルの非同期出力機能オプション　など

次に，JavaVMの保守情報（Javaヒープの情報）およびGCのログに拡張verbosegc情報を出力するための設定について説明します。次の表に示すオプションで，拡張verbosegc情報の出力を有効にして，拡張verbosegc情報の出力形式を指定してください。

表3‒23　拡張verbosegc情報を出力するために指定するオプション

オプション

説明

-XX:+HitachiVerboseGC

拡張verbosegc情報をJavaVMログファイルに出力します。

-XX:+HitachiVerboseGCPrintDate

拡張verbosegc情報の各行に日付を出力します。

-XX:+HitachiVerboseGCCpuTime

GCの開始から終了までの間で，GCを実行したスレッドのCPU利用時間を出力します。CPU利用時間は，ユーザモードで費やしたCPU時間とカーネルモードで費やしたCPU時間に分けて出力されます。

-XX:HitachiVerboseGCIntervalTime=<時間間隔(秒)>

拡張verbosegc情報の出力間隔を指定します。

-XX:+HitachiVerboseGCPrintCause

拡張verbosegc情報に，GCが発生した要因を出力します。

-XX:+HitachiOutputMilliTime

拡張verbosegc情報の各行に日時（ミリ秒まで）を出力します。

-XX:+HitachiCommaVerboseGC

拡張verbosegc情報をCSV形式で出力します。

-XX:+HitachiVerboseGCPrintTenuringDistribution

Survivor領域の年齢分布情報を出力します。出力形式や出力情報については，「9.11　Survivor領域の年齢分布情報出力機能」を参照してください。

-XX:+HitachiVerboseGCPrintJVMInternalMemory

JavaVM内部で管理しているヒープ情報をJavaVMログファイルに出力します。

-XX:+HitachiVerboseGCPrintThreadCount

Javaスレッドの数を監視するために，Javaスレッドの数をJavaVMログファイルに出力します。

-XX:+HitachiVerboseGCPrintDeleteOnExit

java.io.File.deleteOnExit()を呼び出したことによってJavaVMが確保した累積のヒープサイズとメソッドの呼び出し回数を，JavaVMログファイルに出力します。

拡張verbosegc情報から，そのサーバで必要とするJavaヒープ領域サイズ，Metaspace領域サイズなどを見積もるための情報を取得できます。

(3)　明示管理ヒープ機能のイベントログ取得の設定

ここでは，明示管理ヒープ機能のイベントログを取得するための設定について説明します。また，JavaVMログファイルとの関連についても説明します。

明示管理ヒープ機能のイベントログを取得するために必要な設定を次に示します。

ログ出力レベルの設定

目的に応じたログを出力するために，ログ出力レベルを設定します。「none」「normal」「verbose」「debug」の4段階で指定できます。J2EEサーバのデフォルトは「normal」です。「none」＜「normal」＜「vervose」＜「debug」の順でログが詳細になり，出力量も多くなります。

例えば，通常は「normal」を指定して運用し，障害が発生した場合には「verbose」を指定して詳細なログを取得する，といった運用ができます。

ログを出力するファイルについての設定

明示管理ヒープ機能のログは，ほかのJavaVMのログとは別のファイルに出力されます。想定する運用に応じて，出力先のファイル，ファイルのサイズ，およびファイルの個数を設定してください。

J2EEサーバまたはバッチサーバの場合，これらの設定は，簡易構築定義ファイルでJavaVM起動パラメタに指定しているJavaVM起動オプションによって設定できます。JavaVM起動オプションは，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，JavaVM起動パラメタで定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

<JavaVM起動オプション>

JavaVM起動オプションに指定するオプションを次の表に示します。なお，オプションの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。

表3‒24　JavaVM起動オプションに指定するオプション（明示管理ヒープ機能のイベントログ取得の設定）

設定内容

オプション

説明

出力レベルの設定

-XX:HitachiExplicitMemoryLogLevel:＜文字列＞

ログ出力レベルを指定します。

none

明示管理ヒープ機能のイベントログが出力されません。

normal

通常運用の場合に指定します。Explicitヒープのサイズが大きく変化するイベントが発生した場合や，GC発生時のExplicitヒープの状態が出力されます。

verbose

障害が発生した場合など，詳細なログが必要なときに指定します。

debug

verboseよりもさらに詳細なログが必要な場合に指定します。システムのパフォーマンスは低下します。

出力するファイルについての設定

-XX:HitachiExplicitMemoryJavaLog:＜文字列＞

イベントログを出力するファイルのファイル名を指定します。

-XX:HitachiExplicitMemoryJavaLogFileSize=<自然数>

1ファイル当たりの最大ファイルサイズを指定します。

-XX:HitachiExplicitMemoryJavaLogNumberOfFile=<自然数>

作成するログファイルの最大数を指定します。指定値を超えると，ラップアラウンドされ，ログは最初に作成したファイルに出力されます。

なお，明示管理ヒープ機能のイベントログは，JavaVMログファイルとは異なるファイルに出力されます。ただし，一部のオプションについては，JavaVMログファイルに設定した値が引き継がれます。

JavaVMログファイルの設定を引き継ぐ項目を次の表に示します。

表3‒25　JavaVMログファイルの設定を引き継ぐ項目

オプション名

意味

デフォルト値

-XX:+HitachiJavaLogNoMoreOutput

ログファイルの出力に失敗した場合の挙動を指定するオプションです。

有効

-XX:+HitachiOutputMilliTime

ログファイルに出力する時間の単位をミリ秒にするかどうかを指定するオプションです。

無効

JavaVM拡張オプションの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.2　JavaVM拡張オプションの詳細」を参照してください。

3.3.18　WebSocketコンテナのログ取得の設定

ここでは，WebSocketコンテナのログ取得で設定できる項目について説明します。

WebSocketコンテナのログ取得で変更できる設定項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。

表3‒26　WebSocketコンテナのログ取得の設定項目

ログおよびトレース

項目

対応する簡易構築定義ファイルのパラメタ

アクセスログ

アクセスログの出力の有無

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.access_log.websocket.enabled

（デフォルトではアクセスログが出力されません）

アクセスログ出力時のフォーマット

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.access_log.websocket.format※

アクセスログのファイルサイズ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.WebSocketAccessLogFile.filesize

アクセスログのファイル面数

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.WebSocketAccessLogFile.filenum

性能解析トレース

−

ほかの性能解析トレースと同様に，日常的なシステム運用の作業で，cprfedコマンドを実行するときに取得条件などを指定します。性能解析トレースファイルの取得については，「7.　性能解析トレースを使用した性能解析」を参照してください。

（凡例）−：該当しない

注※　アクセスログでは，このキーでフォーマットを定義することで，ログの出力形式をカスタマイズできます。NIO HTTPサーバのアクセスログのカスタマイズについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「7.11.2　NIO HTTPサーバのアクセスログのカスタマイズ」を参照してください。

4　トラブルシューティングで必要な資料の出力先と出力方法

トラブルシューティングで使用する資料は，資料ごとに任意のタイミングで取得できます。この章では，ログやスレッドダンプなどの資料を個別に出力する方法や，これらのデフォルトの出力先について説明します。また，トラブルシューティングで使用するディレクトリについても説明します。

4.1　この章の構成

トラブルシューティングに関する説明のうち，トラブルシューティングの資料の出力先と出力方法について説明します。

トラブルシューティングで使用する資料には，それぞれデフォルトの出力先があります。また，トラブルシューティングに必要な資料は，snapshotログを使用しないで，それぞれの情報を個別に取得できます。

この章の構成を次の表に示します。

表4‒1　この章の構成（トラブルシューティングで使用する資料の出力先と出力方法）

分類

タイトル

参照先

解説

トラブルシューティングで使用する資料の種類（snapshotログを使用しない場合）

4.2

アプリケーションサーバのログ（J2EEアプリケーションを実行するシステム）

4.3

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

4.4

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

4.5

性能解析トレース

4.6

JavaVMのスレッドダンプ

4.7

JavaVMのGCログ

4.8

メモリダンプ

4.9

JavaVMログ（JavaVMログファイル）

4.10

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

4.11

OSの状態情報とOSのログ

4.12

OSの統計情報

4.13

アプリケーションサーバの定義情報

4.14

J2EEサーバまたはバッチサーバの作業ディレクトリの内容

4.15

アプリケーションサーバのリソース設定情報

4.16

Webサーバログ

4.17

JavaVMのスタックトレース情報

4.18

明示管理ヒープ機能のイベントログ

4.19

Component Container管理者のセットアップコマンドの実行情報（UNIXの場合）

4.20

なお，トラブルシューティングの概要，資料を自動で出力する方法，資料の取得や出力に関する設定，および資料の出力内容については，それぞれ次の個所を参照してください。

トラブルシューティングの概要と，資料を自動で出力する方法

「2.　トラブルシューティング」

資料の取得や出力に関する設定

「3.　トラブルシューティングのための準備」

資料に出力される内容

「5.　トラブルの分析」

4.2　トラブルシューティングで使用する資料の種類（snapshotログを使用しない場合）

アプリケーションサーバの構成ソフトウェアが出力するログなどの資料を，snapshotログを使用しないで個別に取得することもできます。この節では，トラブル発生時に必要な資料を個別に取得する場合の方法について説明します。snapshotログを使用した資料の取得については，「2.3.3　snapshotログの収集」を参照してください。

snapshotログを使用しない場合に，個別に取得する必要がある資料と参照先を次の表に示します。

表4‒2　取得が必要な資料（snapshotログを使用しない場合）

取得する資料

参照先

アプリケーションサーバのログ（J2EEアプリケーションを実行するシステムの場合）

4.3

アプリケーションサーバのログ（バッチアプリケーションを実行するシステムの場合）

4.4

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

4.5

性能解析トレース

4.6

JavaVMのスレッドダンプ

4.7

JavaVMのGCログ

4.8

メモリダンプ

4.9

JavaVMログ（JavaVMログファイル）

4.10

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

4.11

OSの状態情報とOSのログ

4.12

OSの統計情報

4.13

アプリケーションサーバの定義情報

4.14

J2EEサーバまたはバッチサーバの作業ディレクトリの内容

4.15

アプリケーションサーバのリソース設定情報

4.16

Webサーバログ

4.17

JavaVMのスタックトレース情報

4.18

明示管理ヒープ機能のイベントログ

4.19

Component Container管理者のセットアップコマンドの実行情報（UNIXの場合）

4.20

注※

EJBクライアントアプリケーションを実行するシステムの場合に取得してください。

4.3　アプリケーションサーバのログ（J2EEアプリケーションを実行するシステム）

この節では，J2EEアプリケーションを実行するシステムで，アプリケーションサーバの構成ソフトウェアが出力するログを手動で取得する方法について説明します。なお，snapshotログとしてアプリケーションサーバのログをすでに収集している場合は，ここで説明する操作は不要です。

ここでは，次のログの取得方法について説明します。

Component Containerのログ

Performance Tracerのログ

Component Transaction Monitorのログ

監査ログで出力するログ

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

参考

HTTP Serverのログの取得方法については，「4.17　Webサーバログ」で説明します。

4.3.1　Component Containerのログの取得

Component Containerのログの種類とログの出力先について説明します。Component Containerのログには，次のログがあります。

J2EEサーバ・サーバ管理コマンドのログ

運用管理エージェント・運用監視エージェント・Management Serverのログ

仮想サーバマネージャの内部構築ツールおよびサーバ通信エージェントのログ

統合ユーザ管理のログ

CJMSプロバイダのログ

それぞれのログの出力先について説明します。

(1)　J2EEサーバ・サーバ管理コマンドのログの取得

J2EEサーバ・サーバ管理コマンドのログの取得方法について説明します。

また，Component Containerでは，これらのログに加えて，移行コマンドのログが出力されます。リソース枯渇監視機能を使用している場合はリソース枯渇監視ログが出力されます。

J2EEサーバのログには，メッセージログ，ユーザログ，例外ログ，アクセスログ，および保守用ログの5種類があります。なお，J2EEサーバでは，これらのログに加えて，起動，停止および異常終了時にイベントログまたはsyslogを出力します。

サーバ管理コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

リソースアダプタのバージョンアップコマンド（cjrarupdate）のログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

移行コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

次にそれぞれのログについて説明します。

メッセージログ

J2EEサーバ，サーバ管理コマンド，移行コマンドなどの稼働状態が出力されます。各種サーバおよびコマンドの稼働監視の情報として使用します。

ユーザログ

アプリケーション中で出力される標準出力および標準エラー出力の情報が出力されます。アプリケーションの開発時の動作確認用に使用します。なお，java.security.debugプロパティを指定してサーバを起動した場合，標準出力および標準エラー出力の情報はユーザログに出力されません。JavaVMのメモリ関連ログも含みます。

例外ログ

システムでトラブルが発生したときのComponent Containerの例外情報が出力されます。なお，例外ログは日常的な運用で監視する必要はありません。ログにメッセージが出力された場合に，例外情報を参照するときにご利用ください。

アクセスログ

Webアプリケーションへのリクエストの処理結果や，WebSocketの通信履歴が出力されます。

保守用ログ

システムでトラブルが発生したときのComponent Containerの障害保守情報が出力されます。保守員が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オプションは，デフォルトで設定されているオプションです。

リソース枯渇監視ログ

リソース枯渇監視機能を使用している場合に，監視対象のリソースについてのリソース枯渇監視情報が出力されます。リソースの使用率または使用数がしきい値を超えた場合の原因調査に使用します。

ログは，若い面番号の付いたログファイルから順に記録されます。一つのログファイルのサイズが1面当たりの最大サイズに達すると，ログは次の面番号の付いたログファイルに記録されます。最後のログファイル（面数の番号が付いたログファイル）のサイズが1面当たりの最大サイズに達すると，面の番号1のログファイルを空にし，そこへログを記録していきます。以降，ログファイルを空にしながら，面番号の順にログファイルへログを記録していきます。

ログの出力先のデフォルトを次の表に示します。Component Containerのログは，サーバ単位またはコマンド単位に取得できます。

ログの出力先に示す<作業ディレクトリ>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥CC¥server¥public（Windowsの場合），または/opt/Cosminexus/CC/server/public（UNIXの場合）です。

(a)　J2EEサーバのログ

表4‒3　J2EEサーバのログの出力先（デフォルト）

分類

内容

ログ出力先およびログファイル名※1

デフォルトのサイズ×面数

チャネル名

メッセージログ

稼働ログ

Windowsの場合

<ejb.server.log.directory>※2¥cjmessage[n].log

UNIXの場合

<ejb.server.log.directory>※2/cjmessage[n].log

1MB×2

MessageLogFile

ログ稼働ログ※3

Windowsの場合

<ejb.server.log.directory>※2¥cjlogger.log

UNIXの場合

<ejb.server.log.directory>※2/cjlogger.log

1MB×2

−

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

2MB×4

−

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

2MB×4

−

ユーザログ

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の保守情報およびGCのログ

Windowsの場合

<ejb.server.log.directory>※2¥javalog[nn].log

UNIXの場合

<ejb.server.log.directory>※2/javalog[nn].log

4MB×4

−

明示管理ヒープ機能のイベントログ

Windowsの場合

<ejb.server.log.directory>※2¥ehjavalog[nn].log

UNIXの場合

<ejb.server.log.directory>※2/ehjavalog[nn].log

4MB×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

−

Webコンテナ保守用トレースログ

Windowsの場合

<ejb.server.log.directory>※2¥CC¥maintenance¥cjweb_access[n].log

UNIXの場合

<ejb.server.log.directory>※2/CC/maintenance/cjweb_access[n].log

4MB×16

WebAccessLogFile

J2EEサーバのRMI通信ログ

Windowsの場合

<ejb.server.log.directory>※2¥CC¥rmi¥cjrmi[n].log

UNIXの場合

<ejb.server.log.directory>※2/CC/rmi/cjrmi[n].log

1MB×4

−

イベントログ

J2EEサーバの起動，停止または異常終了を示すログ

Windowsのイベントビューアのアプリケーションログ※8

−

−

syslog

J2EEサーバの起動，停止または異常終了を示すログ

UNIXのsyslogの設定に依存します。※9

−

−

デバッグ用ログ

開発調査ログ

Windowsの場合

<ejb.server.log.directory>※2¥cjdevelopment[n].log

UNIXの場合

<ejb.server.log.directory>※2/cjdevelopment[n].log

1MB×4

DevelopmentLogFile

アクセスログ

HTTP通信の処理結果

Windowsの場合

<ejb.server.log.directory>※2¥cj_access_niohttp[n].log

UNIXの場合

<ejb.server.log.directory>※2/cj_access_niohttp[n].log

4MB×16

NIOHTTPAccessLogFile

WebSocket通信の処理結果

Windowsの場合

<ejb.server.log.directory>※2¥cj_access_websocket[n].log

UNIXの場合

<ejb.server.log.directory>※2/cj_access_websocket[n].log

4MB×16

WebSocketAccessLogFile

（凡例）　−：該当しない

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大16まで））が付きます。

ただし，EJBクライアントアプリケーションのサブディレクトリ共有モードを使用する場合は，最大面数が64になります。

また，[nn]の部分には，01〜99の通し番号が付きます。

注※2

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

簡易構築定義ファイルのejb.server.log.directoryパラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.11.3　J2EEサーバ用オプション定義を設定するパラメタ」およびマニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

注※3

ファイル出力時にファイル容量をチェックします。チェック時に最大容量を超えた場合，cjlogger.logファイルの名称をバックアップファイルの名称（cjlogger_save.log）に変更します。

注※4

リソースアダプタのログを取得するかどうかは，サーバ管理コマンドで指定されている内容に従います。また，リソースアダプタのログは，簡易構築定義ファイルでサイズおよび面数を変更できます。リソースアダプタのログ取得の設定については，「3.3.11　リソースアダプタのログ取得の設定」を参照してください。

注※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付属のマニュアルを参照してください。

参考

セッションフェイルオーバ機能を使用している場合，セッションフェイルオーバについてのログは，セッションフェイルオーバ機能を使用しているJ2EEサーバのログとして出力されます。

(b)　サーバ管理コマンドのログ

表4‒4　サーバ管理コマンドのログの出力先（デフォルト）

分類

内容

ログ出力先およびログファイル名※1

デフォルトのサイズ×面数

チャネル名

メッセージログ

稼働ログ※2，※3

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥cjmessage[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/cjmessage[n].log

1024KB×3

MessageLogFile

ログ稼働ログ※2

Windowsの場合

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

UNIXの場合

/opt/Cosminexus/CC/admin/logs/ cjlogger.log

1024KB×2

−

例外ログ

障害発生時の例外情報※2，※3

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥cjexception[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/cjexception[n].log

1024KB×6

ExceptionLogFile

保守用ログ

保守情報※2

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjmaintenance[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjmaintenance[n].log

1024KB×3

MaintenanceLogFile

コンソールメッセージ※2

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjconsole[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjconsole[n].log

32KB×3

ConsoleLogFile

サーバ管理コマンドの保守情報※2

Windowsの場合

<Application Serverのインストールディレクトリ>¥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から各ログの最大面数まで）が付きます。

注※2

トレース共通ライブラリ形式の出力メッセージ（アプリケーション識別名）には，コマンド名が表示されます。トレース共通ライブラリ形式のログについては，「5.2　アプリケーションサーバのログ」を参照してください。

注※3

互換モードの場合，稼働ログと障害発生時の例外情報の出力先は標準モードと異なります。互換モードの場合の出力先とデフォルトのサイズ・面数は次のようになります。

表4‒5　サーバ管理コマンドのログの出力先（互換モード）

内容

ログ出力先およびログファイル名※

デフォルトのサイズ×面数

稼働ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥<コマンド名称>message[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/<コマンド名称>message[n].log

128KB×2

障害発生時の例外情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥<コマンド名称>exception[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/<コマンド名称>exception[n].log

256KB×2

注※

ログファイル名の[n]の部分には，面の番号（1から各ログの最大面数まで）が付きます。

サーバ管理コマンドのメッセージログに出力されるメッセージには，メッセージIDフィールドが空白で，メッセージテキストフィールドにメッセージID（KDJEnnnnn-Yなど）が含まれる場合があります。それらはサーバ側で発生したメッセージで，前後に出力されるメッセージの付加情報となります。

(c)　リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

表4‒6　リソースアダプタバージョンアップコマンド（cjrarupdate）のログの出力先

分類

内容

ログ出力先およびログファイル名※

デフォルトのサイズ×面数

メッセージログ

稼働ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjrarupdatemessage[n].log※1

UNIXの場合

/opt/Cosminexus/CC/logs/cjrarupdatemessage[n].log※1

1MB×2

例外ログ

障害発生時の例外情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjrarupdateexception[n].log※1

UNIXの場合

/opt/Cosminexus/CC/logs/cjrarupdateexception[n].log※1

1MB×2

保守用ログ

保守情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjrarupdatemaintenance[n].log※2

UNIXの場合

/opt/Cosminexus/CC/logs/cjrarupdatemaintenance[n].log※2

16MB×4

注※1

ログファイル名の[n]の部分には，面の番号（1または2）が付きます。

注※2

ログファイル名の[n]の部分には，面の番号（1から4まで）が付きます。

(d)　移行コマンド（cjenvupdate）のログ

表4‒7　移行コマンド（cjenvupdate）のログの出力先

分類

内容

ログ出力先およびログファイル名※

デフォルトのサイズ×面数

メッセージログ

cjenvupdateコマンドの稼働ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjenvupdatemessage[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjenvupdatemessage[n].log

4MB×4

例外ログ

cjenvupdateコマンドの例外情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjenvupdateexception[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjenvupdateexception[n].log

4MB×4

保守用ログ

cjenvupdateコマンドの保守情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjenvupdatemaintenance[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjenvupdatemaintenance[n].log

4MB×4

注※

[n]には，面の番号（1から4まで）が付きます。

(e)　リソース枯渇監視のログ

表4‒8　リソース枯渇監視のログの出力先

監視対象

リソース

ログ取得場所およびログファイル名※1

デフォルトのサイズ×面数

チャネル名

メモリ

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjmemorywatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjmemorywatch[n].log

1MB×2

MemoryWatchLogFile

ファイルディスクリプタ

UNIXの場合※3

<ejb.server.log.directory>※2/watch/cjfiledescriptorwatch[n].log

1MB×2

FileDescriptorWatchLogFile

スレッド

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjthreadwatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjthreadwatch[n].log

1MB×2

ThreadWatchLogFile

スレッドダンプ

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjthreaddumpwatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjthreaddumpwatch[n].log

1MB×2

ThreaddumpWatchLogFile

HTTPリクエスト実行待ちキュー

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjrequestqueuewatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjrequestqueuewatch[n].log

1MB×2

RequestQueueWatchLogFile

HTTPセッション数

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjhttpsessionwatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjhttpsessionwatch[n].log

1MB×2

HttpSessionWatchLogFile

コネクションプール

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjconnectionpoolwatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjconnectionpoolwatch[n].log

1MB×2

ConnectionPoolWatchLogFile

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

[n]には，面の番号（1から面数（最大16まで））が付きます。

注※2

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

簡易構築定義ファイルのejb.server.log.directoryパラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.11.3　J2EEサーバ用オプション定義を設定するパラメタ」およびマニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

注※3

Windowsの場合，またはAIXの場合は，ファイルディスクリプタを監視できません。

リソース枯渇監視ログファイルに出力される情報やログファイルの出力形式については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「4.3　リソース枯渇監視機能とリソース枯渇監視情報の出力」を参照してください。

(f)　ログの出力先を設定するユーザ定義ファイル

J2EEサーバおよびサーバ管理コマンドのログの出力先を変更している場合は，次の表に示す，ログの出力先を設定するユーザ定義ファイルを参照して出力先を確認してください。なお，ログの出力先を変更した場合，変更後の出力先はsnapshotログの一括収集時に収集対象外となります。必要に応じてsnapshotログの収集先を変更してください。

表4‒9　ログの出力先を設定するユーザ定義ファイル

分類

ユーザ定義ファイル

J2EEサーバ

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に指定する，ejb.server.log.directoryパラメタ

デフォルトは，「<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/logs」（UNIXの場合）です。

サーバ管理コマンド

サーバ管理コマンドのusrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のejbserver.log.directoryキー

キーのデフォルトは，「<Application Serverのインストールディレクトリ>¥CC¥admin¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/admin/logs」（UNIXの場合）です。

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

ログの出力先の変更方法など，トラブルシューティングの資料取得の設定については，「3.　トラブルシューティングのための準備」を参照してください。

(2)　運用管理エージェント・運用監視エージェント・Management Serverのログの取得

ここでは，運用管理エージェント，運用監視エージェント，およびManagement Serverのログの出力先について説明します。

運用管理エージェント・運用監視エージェント・Management Serverのログには，個別に取得する以外に，統合ログとしてまとめて取得できるものがあります。統合ログには，次の種類があります。

統合メッセージログ

Managerのメッセージログが統合されて出力されます。

統合トレースログ

Managerのトレースログが統合されて出力されます。

コマンド保守ログ※

運用管理コマンド，Smart Composer機能で使用するコマンド，およびsnapshotlogコマンドのトレースログが統合されて出力されます。

注※　Smart Composer機能で使用するコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「8.　Smart Composer機能で使用するコマンド」を参照してください。

統合ログの出力先を次の表に示します。

表4‒10　統合ログの出力先（Windowsの場合）

ファイル名

内容

出力先ディレクトリ

デフォルトのサイズ×面数

mngmessage[n]. ※1log

統合メッセージログ

<Managerのログ出力ディレクトリ>¥message※2

256KB×4

mngtrace[n] ※1.log

統合トレースログ

<Managerのログ出力ディレクトリ>¥trace※2

1MB×4

mngcmd[n] ※1.log

コマンド保守ログ

<Managerのログ出力ディレクトリ>¥maintenance※2

16MB×4

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大64まで））が付きます。

注※2

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）で指定されたディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥manager¥logです。manager.cfgの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.9　manager.cfg（Manager設定ファイル）」を参照してください。

表4‒11　統合ログの出力先（UNIXの場合）

ファイル名

内容

出力先ディレクトリ

デフォルトのサイズ×面数

mngmessage[n] ※1.log

統合メッセージログ

<Managerのログ出力ディレクトリ>/message※2

256KB×4

mngtrace[n] ※1.log

統合トレースログ

<Managerのログ出力ディレクトリ>/trace※2

1MB×4

mngcmd[n] ※1.log

コマンド保守ログ

<Managerのログ出力ディレクトリ>/maintenance※2

16MB×4

注※1

ログファイル名の[n]の部分には，面の番号（1から面数（最大64まで））が付きます。

注※2

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）で指定されたディレクトリを指します。デフォルト値は，/opt/Cosminexus/manager/logです。manager.cfgの詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「8.2.9　manager.cfg（Manager設定ファイル）」を参照してください。

なお，統合ログに出力したログは，デフォルトでは個別のログとしても出力されます。

また，統合ログに出力した場合には個別に出力しない設定にできるログもあります。統合ログの出力に関する設定については，「3.3.10　Managerのログ取得の設定」を参照してください。

個別に取得する場合の運用管理エージェント，運用監視エージェント，およびManagement Serverのログの出力先，および統合メッセージログ・統合トレースログへの出力の有無を次の表に示します。

表4‒12　運用管理エージェント，運用監視エージェント，およびManagement Serverのログを個別に取得する場合の出力先（Windowsの場合）

分類

ファイル名

内容

出力先ディレクトリ

デフォルトのサイズ×面数

統合メッセージログ／統合トレースログ

運用管理エージェント

adminagent.err.[1-16].log※1

運用管理エージェントの標準エラー出力

<Managerのログ出力ディレクトリ>

64KB×4

×

adminagent.out.[1-16].log※1

運用管理エージェントの標準出力

64KB×4

×

adminagent.err

運用管理エージェントの標準エラー出力コマンドライン

−

×

adminagent[1-16].log

運用管理エージェントのログ

64KB×4

○

adminagentctl.exe.[1-2].log

運用管理エージェントの起動・停止コマンドのログ

64KB×2

×

adminagent[n]※2.log

運用管理エージェントの保守ログ

<Managerのログ出力ディレクトリ>¥maintenance

16MB×4

×

mngrmi[n] ※2.log

運用管理エージェントが行うRMI処理での保守ログ

16MB×8

×

processConsole[n]※2.log

コンソールログ

<Managerのログ出力ディレクトリ>

64KB×4

×

adminagentsv.exe.[1-16]log※1

運用管理エージェントサービスのログ

64KB×2

×

adminagentsv.exe.out※1

運用管理エージェントサービスの標準出力

−

×

adminagentsv.exe.err※1

運用管理エージェントサービスの標準エラー出力

−

×

adminagent.javalog[01-04].log

運用管理エージェントのJavaVMログファイル

256KB×4

×

運用監視エージェント

mngagent-<ドメイン名>-<Agent名>.[n]※2.log※3

運用監視エージェントのログ・トレース

J2EEサーバ用システムJP1イベントおよびJ2EEサーバ用ユーザJP1イベントのログ※4

Managementイベント発行ログ※5

64KB×4

×

Management Server

mngsvr.exe.[1-2].log

Management Serverサービスのログ

64KB×2

×

mngsvr.exe.err※1

Management Serverサービスの標準エラー出力

−

×

mngsvr.exe.out※1

Management Serverサービスの標準出力

−

×

mngsvrctl.exe.[1-2].log

Management Serverサービス起動・停止コマンドのログ

64KB×2

×

mngsvr[n]※2.log

Management Serverのログ

運用管理サーバ※6のシステムJP1イベントのログ※4

64KB×4

○

mngsvr[n]※2.log

Management Serverの保守ログ

<Managerのログ出力ディレクトリ>¥maintenance

16MB×2

×

cjmessage[n].log

稼働ログ

<Managerのログ出力ディレクトリ>

1MB×2

×

cjexception[n].log

障害発生時の例外情報

<Managerのログ出力ディレクトリ>¥maintenance

1MB×2

×

cjmaintenance[n].log

保守情報

16MB×4

×

cjconsole[n].log

コンソールメッセージ

1MB×2

×

cjejbcontainer[n].log

EJBコンテナの保守情報

1MB×2

×

web_servlet[n].log

Webサーブレットログ

4MB×4

×

user_out[n].log

ユーザ出力ログ

1MB×2

×

user_err[n].log

ユーザエラーログ

1MB×2

×

cjlogger.log

ログ稼働ログ

1MB×2

×

javalog[nn].log

JavaVMの保守情報およびGCのログ

4MB×4

×

ehjavalog[nn].log

明示管理ヒープ機能のイベントログ

4MB×4

×

cjwebcontainer[n].log

Webコンテナの保守情報

1MB×2

×

cjstdout.log

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

<Managerのログ出力ディレクトリ>¥maintenance/CC/maintenance

−

×

cjstderr.log

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

−

×

cj_shutdown[n].log

終了プロセス情報

4KB×4

×

cjrmi[n].log

Management Serverが行うRMI処理でのJ2EEサーバのRMI通信ログ

<Managerのログ出力ディレクトリ>¥maintenance¥CC¥rmi

1MB×4

×

cjhttp_thr.<時間情報>.inprocess_http.mm

スレッドトレースの情報

<Managerのログ出力ディレクトリ>¥maintenance¥http¥maintenance¥thr

約3.2MB×16

×

cjhttp_comm.<時間情報>.inprocess_http.mm

通信トレースの情報

<Managerのログ出力ディレクトリ>¥maintenance¥http¥maintenance¥comm

約16.6MB×16

×

cjmemorywatch[n].log

リソース枯渇監視のログ（メモリ）

<Managerのログ出力ディレクトリ>¥maintenance¥watch

1MB×2

×

cjthreadwatch[n].log

リソース枯渇監視のログ（スレッド）

1MB×2

×

cjthreaddumpwatch[n].log

リソース枯渇監視のログ（スレッドダンプ）

1MB×2

×

cjrequestqueuewatch[n].log

リソース枯渇監視のログ（HTTPリクエスト実行待ちキュー）

1MB×2

×

cjhttpsessionwatch[n].log

リソース枯渇監視のログ（HTTPセッション数）

1MB×2

×

（凡例）

○：統合ログに出力される

×：統合ログには出力されない

[1-n]：1〜nのログの面数の通し番号が付くことを示す

−：該当しない

注

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）で指定されたディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥manager¥log（Windowsの場合），または/opt/Cosminexus/manager/log（UNIXの場合）です。manager.cfgの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.9　manager.cfg（Manager設定ファイル）」を参照してください。

注※1

トレース共通ライブラリ形式以外の形式でログが出力されます。トレース共通ライブラリ形式のログについては，「5.2　アプリケーションサーバのログ」を参照してください。

注※2

ファイル名の[n]の部分には，1〜指定したログの面数の通し番号が付きます。

注※3

運用監視エージェントのログ・トレースの出力先は変更できます。運用監視エージェントのログ・トレースの出力先を変更している場合は，mngagent.propertiesファイル（運用監視エージェントプロパティファイル）のmngagent.log.filenameキーの値を参照してください。

注※4

JP1と連携してアプリケーションサーバで構築したシステムを運用する場合に出力されます。

注※5

Managementイベントを使用している場合に出力されます。

注※6

アプリケーションサーバの運用管理サーバのことです。

表4‒13　運用管理エージェント，運用監視エージェント，およびManagement Serverのログを個別に取得する場合の出力先（UNIXの場合）

分類

ファイル名

内容

出力先ディレクトリ

デフォルトのサイズ×面数

統合メッセージログ／統合トレースログ

運用管理エージェント

adminagent.err.[1-16].log※1

運用管理エージェントの標準エラー出力

<Managerのログ出力ディレクトリ>

64KB×4

×

adminagent.out.[1-16].log※1

運用管理エージェントの標準出力

64KB×4

×

adminagent.err

運用管理エージェントの標準エラー出力コマンドライン

−

×

adminagent[1-16].log

運用管理エージェントのログ

64KB×4

○

adminagentctl.[1-16].log

運用管理エージェントの起動・停止コマンドのログ

64KB×2

×

adminagent[n]※2.log

運用管理エージェントの保守ログ

<Managerのログ出力ディレクトリ>/maintenance

16MB×4

×

mngrmi[n] ※2.log

運用管理エージェントが行うRMI処理での保守ログ

16MB×8

×

processConsole[n]※2.log

コンソールログ

<Managerのログ出力ディレクトリ>

64KB×4

×

adminagent.javalog[01-04].log

運用管理エージェントのJavaVMログファイル

256KB×4

×

運用監視エージェント

mngagent-<ドメイン名>-<Agent名>.[n]※2.log※3

運用監視エージェントのログ・トレース

J2EEサーバ用システムJP1イベントおよびJ2EEサーバ用ユーザJP1イベントのログ※4

Managementイベント発行ログ※5

64KB×4

×

Management Server

mngsvrctlstart.[1-2].log

Management Server起動コマンド

64KB×2

×

mngsvrctlstop.[1-2].log

Management Server停止コマンド

64KB×2

×

mngsvrctlsetup.[1-2].log

Management Serverセットアップコマンド

64KB×2

×

mngsvr[n].log

Management Serverのログ

運用管理サーバ※6のシステムJP1イベントのログ※4

64KB×4

○

mngenvsetup.[1-2].log

mngenvsetupコマンドの実行ログ

<Managerのログ出力ディレクトリ>/maintenance

512KB×2

×

mngsvr[n]※2.log

Management Serverの保守ログ

<Managerのログ出力ディレクトリ>/maintenance

16MB×2

×

cjmessage[n].log

稼働ログ

<Managerのログ出力ディレクトリ>

1MB×2

×

cjexception[n].log

障害発生時の例外情報

<Managerのログ出力ディレクトリ>/maintenance

1MB×2

×

cjmaintenance[n].log

保守情報

16MB×4

×

cjconsole[n].log

コンソールメッセージ

1MB×2

×

cjejbcontainer[n].log

EJBコンテナの保守情報

1MB×2

×

web_servlet[n].log

Webサーブレットログ

4MB×4

×

user_out[n].log

ユーザ出力ログ

1MB×2

×

user_err[n].log

ユーザエラーログ

1MB×2

×

cjlogger.log

ログ稼働ログ

1MB×2

×

javalog[nn].log

JavaVMの保守情報およびGCのログ

4MB×4

×

ehjavalog[nn].log

明示管理ヒープ機能のイベントログ

4MB×4

×

cjwebcontainer[n].log

Webコンテナの保守情報

1MB×2

×

cjstdout.log

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

<Managerのログ出力ディレクトリ>/maintenance/CC/maintenance

−

×

cjstderr.log

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

−

×

cj_shutdown[n].log

終了プロセス情報

4KB×4

×

cjrmi[n].log

Management Serverが行うRMI処理でのJ2EEサーバのRMI通信ログ

<Managerのログ出力ディレクトリ>/maintenance/CC/rmi

1MB×4

×

cjhttp_thr.<時間情報>.inprocess_http.mm

スレッドトレースの情報

<Managerのログ出力ディレクトリ>/maintenance/http/maintenance/thr

約3.2MB×16

×

cjhttp_comm.<時間情報>.inprocess_http.mm

通信トレースの情報

<Managerのログ出力ディレクトリ>/maintenance/http/maintenance/comm

約16.6MB×16

×

cjmemorywatch[n].log

リソース枯渇監視のログ（メモリ）

<Managerのログ出力ディレクトリ>/maintenance/watch

1MB×2

×

cjfiledescriptorwatch[n].log

リソース枯渇監視のログ（ファイルディスクリプタ）

1MB×2

×

cjthreadwatch[n].log

リソース枯渇監視のログ（スレッド）

1MB×2

×

cjthreaddumpwatch[n].log

リソース枯渇監視のログ（スレッドダンプ）

1MB×2

×

cjrequestqueuewatch[n].log

リソース枯渇監視のログ（HTTPリクエスト実行待ちキュー）

1MB×2

×

cjhttpsessionwatch[n].log

リソース枯渇監視のログ（HTTPセッション数）

1MB×2

×

（凡例）

○：統合ログに出力される

×：統合ログには出力されない

[1-n]：1〜nのログの面数の通し番号が付くことを示す

−：該当しない

注※1

トレース共通ライブラリ形式以外の形式でログが出力されます。トレース共通ライブラリ形式のログについては，「5.2　アプリケーションサーバのログ」を参照してください。

注※2

ファイル名の[n]の部分には，1〜指定したログの面数の通し番号が付きます。

注※3

運用監視エージェントのログ・トレースの出力先は変更できます。運用監視エージェントのログ・トレースの出力先を変更している場合は，mngagent.propertiesファイル（運用監視エージェントプロパティファイル）のmngagent.log.filenameキーの値を参照してください。

注※4

JP1と連携してアプリケーションサーバで構築したシステムを運用する場合に出力されます。

注※5

Managementイベントを使用している場合に出力されます。

注※6

アプリケーションサーバの運用管理サーバのことです。

注意事項

コンソールログには，運用管理エージェントが起動したサーバプロセスの標準出力，および標準エラー出力が出力されます。コンソールログについての注意事項を次に示します。

Windowsの場合，次のプロセスに対しては，コンソールログは出力されません。

論理パフォーマンストレーサ

論理Webサーバ

論理CTMドメインマネジャ

論理CTM

間接起動の論理ユーザサーバ

論理ユーザサーバの起動種別については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.19　論理ユーザサーバ定義ファイル」を参照してください。

コンソールログに出力する情報が一度に複数行出力された場合，コンソールログには1行にまとめて表示されることがあります。

コンソール情報に出力する情報の文字数が2039文字を超えてしまう場合，2039文字以降の情報は次の行に分割されて出力されます。

(3)　仮想サーバマネージャの内部構築ツールおよびサーバ通信エージェントのログの取得

ここでは，仮想サーバマネージャの内部構築ツールおよびサーバ通信エージェントのログの出力先について説明します。

仮想サーバマネージャの内部構築ツールおよびサーバ通信エージェントのログの出力先，および統合メッセージログ・統合トレースログへの出力の有無を次の表に示します。

表4‒14　仮想サーバマネージャの内部構築ツールおよびサーバ通信エージェントのログの出力先

分類

ファイル名

内容

出力先ディレクトリ

デフォルトのサイズ×面数

統合メッセージログ／統合トレースログ

仮想サーバマネージャの内部構築ツール

rasetup[n]※2.log

仮想サーバマネージャの内部構築ツールのログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥setup¥log

UNIXの場合

/opt/Cosminexus/manager/setup/log

262144バイト×4

×

rasetup[n]※2.log

仮想サーバマネージャの内部構築ツールの保守ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥setup¥log¥maintenance

UNIXの場合

/opt/Cosminexus/manager/setup/log/maintenance

16777216バイト×4

×

サーバ通信エージェント

sinaviagent[n]※2.log

サーバ通信エージェントのログ

<サーバ通信エージェントのログ出力ディレクトリ>※1

524288バイト×4

×

sinaviagentsv[n]※2.log

サーバ通信エージェントサービスのログ

65536バイト×4

×

snactl[n]※2.log

サーバ通信エージェントの起動・停止コマンドのログ

65536バイト×4

×

sinaviagent.err

サーバ通信エージェントの標準エラー出力

65536バイト×1

×

sinaviagent.out

サーバ通信エージェントの標準出力

65536バイト×1

×

processConsole[n]※2.log

コンソールログ

65536バイト×4

×

sinaviagent[n]※2.log

サーバ通信エージェントの保守ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥sinagent¥log¥maintenance

UNIXの場合

/opt/Cosminexus/sinagent/log/maintenance

1048576バイト×4

×

sinaviagentsv[n]※2.log

サーバ通信エージェントサービスの保守ログ

65536バイト×4

×

snactl[n]※2.log

サーバ通信エージェントの起動・停止コマンドの保守ログ

65536バイト×4

×

sinaviagent.javalog[n].※2log

サーバ通信エージェントのJavaVMログファイル

256KB×4

×

（凡例）×：統合ログには出力されない　[n]：1〜nのログの面数の通し番号が付くことを示す

注※1

<サーバ通信エージェントのログ出力ディレクトリ>は，sinaviagent.cfg（サーバ通信エージェント用オプション定義ファイル）で指定されたディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥sinagent¥log（Windowsの場合），または/opt/Cosminexus/sinagent/log（UNIXの場合）です。

注※2

ファイル名の[n]の部分には，1から順に指定したログの面数の通し番号が付きます。

(4)　統合ユーザ管理のログの取得

統合ユーザ管理のトレースファイルは，ua.confファイル（統合ユーザ管理のコンフィグレーションファイル）のcom.cosminexus.admin.auth.trace.prefixオプションの設定に応じて出力されます。ua.confファイルの詳細については，マニュアル「アプリケーションサーバ機能解説 セキュリティ管理機能編」の「14.2.2　ua.conf（統合ユーザ管理のコンフィグレーションファイル）」を参照してください。

(5)　CJMSプロバイダのログの取得

CJMSプロバイダのログの取得について説明します。CJMSプロバイダで取得できるログの種類には，CJMSPブローカーのログ，管理コマンド（cjmsicmd）のログ，およびCJMSPリソースアダプタのログがあります。ログの出力先のデフォルトを次の表に示します。

表4‒15　CJMSプロバイダのログの出力先（デフォルト）

ログの種類

分類

デフォルトの出力先

デフォルトのサイズ×面数

CJMSPブローカーのログ

メッセージログ

Windowsの場合

<CJMSP_HOME>※1¥var¥instances¥<instanceName>¥log¥cjmsbroker_msg[n].log

UNIXの場合

<CJMSP_HOME>※1/var/instances/<instanceName>/log/cjmsbroker_msg[n].log

1MB×2

エラーログ

Windowsの場合

<CJMSP_HOME>※1¥var¥instances¥<instanceName>¥log¥cjmsbroker_err[n].log

UNIXの場合

<CJMSP_HOME>※1/var/instances/<instanceName>/log/cjmsbroker_err[n].log

1MB×2

管理コマンド（cjmsicmd）のログ※2

メッセージログ

Windowsの場合

<CJMSP_HOME>※1¥var¥admin¥log¥cjmsadmin_msg[n].log

UNIXの場合

<CJMSP_HOME>※1/var/admin/log/cjmsadmin_msg[n].log

1MB×2

エラーログ

Windowsの場合

<CJMSP_HOME>※1¥var¥admin¥log¥cjmsadmin_err[n].log

UNIXの場合

<CJMSP_HOME>※1/var/admin/log/cjmsadmin_err[n].log

1MB×2

CJMSPリソースアダプタのログ

メッセージログ

Windowsの場合

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>※3¥cjms¥Cosminexus_JMS_Provider_RA¥cjmsra_msg[n].log

UNIXの場合

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>※3/cjms/Cosminexus_JMS_Provider_RA/cjmsra_msg[n].log

1MB×2

エラーログ

Windowsの場合

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>※3¥cjms¥Cosminexus_JMS_Provider_RA¥cjmsra_err[n].log

UNIXの場合

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>※3/cjms/Cosminexus_JMS_Provider_RA/cjmsra_err[n].log

1MB×2

注

[n]には，面の番号（1から面数（最大16まで））が付きます。

注※1

<CJMSP_HOME>は，次のディレクトリです。

Windowsの場合

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

UNIXの場合

/opt/Cosminexus/CC/cjmsp

注※2

ログ出力の結果，指定した最大ファイルサイズになると，ログの出力先が次のファイルに切り替わります。ファイル数が指定した面数に達した場合，ラップアラウンドによって出力先が最初のファイルに切り替わり，元の情報は上書きされます。なお，ファイルは作成時にだけ初期化され，ラップアラウンドの際には初期化されません。ファイルサイズを拡張した場合は，拡張部分に対してだけ初期化されます。初期化とは，空白文字（0x20）をEOF（ファイルの最後）から指定したファイルサイズまでの領域に書き込むことです。既存のデータに影響はありません。

注※3

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>は，J2EEサーバのオプション定義で指定したディレクトリです。デフォルトでは，次のディレクトリになります。

Windowsの場合

<ejb.public.directoryで指定したディレクトリ>¥ejb¥<J2EEサーバ名>¥logs

UNIXの場合

<ejb.public.directoryで指定したディレクトリ>/ejb/<J2EEサーバ名>/logs

(6)　ログ以外に取得が必要な情報

ここでは，ログ以外に取得する必要がある情報について説明します。

インプロセストランザクションサービスを使用している場合

インプロセストランザクションサービスを使用している場合，インプロセストランザクションサービスのステータスファイルを取得する必要があります。なお，ステータスファイルを二重化している場合は，予備のステータスファイルも取得してください。

ステータスファイルは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.distributedtx.ots.status.directory1パラメタ，およびejbserver.distributedtx.ots.status.directory2パラメタ（二重化している場合）で指定したパスに格納されています。

4.3.2　Performance Tracerのログの取得

Performance Tracerのログの種類とログの出力先について説明します。

(1)　Performance Tracerのログの種類

Performance Tracerでは，PRF識別子ごとにPRFデーモン，PRFコマンドのログを出力します。また，システムでトラブルが発生したときの保守員による障害解析用のログ（各種保守情報）を環境変数PRFSPOOLの設定ディレクトリに出力します。

日常的な運用で監視する場合はイベントログ，およびsyslogを監視します。

(2)　Performance Tracerのログの出力先

Performance Tracerのログの出力先を次に示します。

表4‒16　Performance Tracerのログの出力先

内容

出力先ディレクトリ※1

PRFデーモンおよびPRFコマンドのログ

Windowsの場合

<環境変数PRFSPOOLの設定ディレクトリ>¥log¥<PRF識別子>¥ctmlog[n]

およびイベントログ※2

UNIXの場合

$PRFSPOOL/log/<PRF識別子>/ctmlog[n]

およびsyslog※3

モジュールトレース

Windowsの場合

<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥umt

UNIXの場合

$PRFSPOOL/utt/umt

構造化例外発生ログ

（Windowsの場合）

<環境変数PRFSPOOLの設定ディレクトリ>¥oslttrc

保守情報

Windowsの場合

<環境変数PRFSPOOLの設定ディレクトリ>

UNIXの場合

$PRFSPOOL/

注※1　

[n]には「01」または「02」が表示されます。

注※2　

運用に必要なメッセージが出力されます。ログファイルの出力先はWindowsのイベントログの設定によって異なります。

注※3　

運用に必要なメッセージが出力されます。syslogの設定に関する詳細については，OS付属のマニュアルを参照してください。

4.3.3　Component Transaction Monitorのログの取得

ここでは，Component Transaction Monitorのログの出力先について説明します。

(1)　Component Transaction Monitorのログの種類

Component Transaction Monitorでは，CTM識別子ごとにCTMデーモン，CTMコマンドのログを出力します。また，システムでトラブルが発生したときの保守員による障害解析用に，各種保守情報を環境変数CTMSPOOLの設定ディレクトリに出力します。ctmlogcatコマンドを実行することで出力メッセージを確認できます。

日常的な運用で監視する場合はイベントログ，およびsyslogを監視します。

(2)　Component Transaction Monitorのログの出力先

Component Transaction Monitorのログの出力先を次に示します。

表4‒17　Component Transaction Monitorのログの出力先

内容

出力先ディレクトリ※1

CTMデーモンおよびCTMコマンドのログ

Windowsの場合

<環境変数CTMSPOOLの設定ディレクトリ>¥log¥<CTMデーモン識別子>¥ctmlog[n]

およびイベントログ※2

UNIXの場合

$CTMSPOOL/log/<CTMデーモン識別子>/ctmlog[n]

およびsyslog※3

CTMドメインデーモンのログ

Windowsの場合

<環境変数CTMSPOOLの設定ディレクトリ>¥log¥ctmdmlog[n]

UNIXの場合

$CTMSPOOL/log/ctmdmlog[n]

モジュールトレース

Windowsの場合

<環境変数CTMSPOOLの設定ディレクトリ>¥utt¥umt

UNIXの場合

$CTMSPOOL/utt/umt

構造化例外発生ログ

（Windowsの場合）

<環境変数PRFSPOOLの設定ディレクトリ>¥oslttrc

保守情報

Windowsの場合

<環境変数CTMSPOOLの設定ディレクトリ>

UNIXの場合

$CTMSPOOL

注※1　

[n]には「01」または「02」が表示されます。

注※2　

運用に必要なメッセージが出力されます。ログファイルの出力先はWindowsのイベントログの設定によって異なります。

注※3　

運用に必要なメッセージが出力されます。syslogの設定に関する詳細については，OS付属のマニュアルを参照してください。

4.3.4　監査ログで出力するログの取得

ここでは，監査ログの機能を使用した場合に出力されるログファイルについて説明します。

監査ログで出力するログの種類と出力先を次の表に示します。

表4‒18　監査ログで出力するのログの出力先（デフォルト）

分類

内容

ログ出力先およびログファイル名※

デフォルトのサイズ×面数

メッセージログ

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

Windowsの場合

<Application Serverのインストールディレクトリ>¥auditlog¥rasmessage[n].log

UNIXの場合

/opt/Cosminexus/auditlog/rasmessage[n].log

1MB×4

例外ログ

監査ログの例外情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥auditlog¥rasexception[n].log

UNIXの場合

/opt/Cosminexus/auditlog/rasexception[n].log

1MB×8

注※

ログファイル名の[n]の部分には，面の番号（1から面数（最大64まで））が付きます。

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

アプリケーションのユーザログは，トレース共通ライブラリ形式で出力するように設定している場合に取得できます。ユーザログには，次の2種類があります。

J2EEサーバ上で動作するJ2EEアプリケーション（J2EEコンポーネント）が出力するユーザログ

EJBクライアントアプリケーションが出力するユーザログ

なお，トレース共通ライブラリ形式のログについては，「5.2　アプリケーションサーバのログ」を参照してください。

(1)　J2EEアプリケーションのユーザログの取得

J2EEアプリケーションのログの出力先については，次のディレクトリに，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にejbserver.application.userlog.CJLogHandler.<ハンドラ名>.pathパラメタで指定したプリフィックスを持つファイル名で出力されます。なお，<ハンドラ名>には，キーの値を区別するためのハンドラ名が指定されています。

Windowsの場合

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

UNIXの場合

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

なお，J2EEアプリケーションのユーザログ出力の設定については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「8.8　J2EEアプリケーションのユーザログ出力の設定」を参照してください。

(2)　EJBクライアントアプリケーションのユーザログの取得

EJBクライアントアプリケーションのユーザログの出力先については，次のディレクトリにEJBクライアントアプリケーションのシステムプロパティのejbserver.application.userlog.CJLogHandler.<ハンドラ名>.pathキーの値で指定したプリフィックスを持つファイル名で出力されます。なお，<ハンドラ名>には，キーの値を区別するためのハンドラ名が指定されています。

Windowsの場合

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

UNIXの場合

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

EJBクライアントアプリケーションでユーザログを出力するためのシステムプロパティの設定方法については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「8.10　EJBクライアントアプリケーションのユーザログ出力の設定（cjclstartapコマンドを使用する場合）」，またはマニュアル「アプリケーションサーバ 機能解説 拡張編」の「8.11　EJBクライアントアプリケーションのユーザログ出力の実装と設定（vbjコマンドを使用する場合）」を参照してください。

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

この節では，バッチアプリケーションを実行するシステムで，アプリケーションサーバの構成ソフトウェアが出力するログを手動で取得する方法について説明します。なお，snapshotログとしてアプリケーションサーバのログをすでに収集している場合は，ここで説明する操作は不要です。

ここでは，次のログの取得方法について説明します。

Component Containerのログ

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

また，バッチアプリケーションを実行するシステムでは，アプリケーションサーバの構成ソフトウェアが出力するログを手動で取得する場合，次のログも取得してください。

Performance Tracerのログ

監査ログで出力するログ

これらのログの取得方法については，「4.3　アプリケーションサーバのログ（J2EEアプリケーションを実行するシステム）」を参照してください。それぞれの参照先の詳細を次に示します。

Performance Tracerのログ

「4.3.2　Performance Tracerのログの取得」

監査ログで出力するログ

「4.3.4　監査ログで出力するログの取得」

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

Component Containerのログの種類とログの出力先について説明します。Component Containerのログには，次の2種類のログがあります。

バッチサーバ・サーバ管理コマンド・バッチアプリケーションのログ

運用管理エージェント・運用監視エージェント・Management Serverのログ

それぞれのログの出力先について説明します。

(1)　バッチサーバ・サーバ管理コマンド・バッチアプリケーションのログの取得

バッチサーバ，サーバ管理コマンド，およびバッチアプリケーションのログの取得方法について説明します。

また，Component Containerでは，これらのログに加えて，移行コマンドのログが出力されます。また，リソース枯渇監視機能を使用している場合はリソース枯渇監視ログが出力されます。

バッチサーバのログには，メッセージログ，ユーザログ，例外ログ，および保守用ログの4種類があります。なお，バッチサーバでは，これらのログに加えて，起動，停止および異常終了時にイベントログまたはsyslogを出力します。

サーバ管理コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

バッチアプリケーションのログは，メッセージログの1種類です。

リソースアダプタのバージョンアップコマンド（cjrarupdate）のログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

移行コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。

次にそれぞれのログについて説明します。

メッセージログ

バッチサーバ，サーバ管理コマンド，移行コマンドなどの稼働状態が出力されます。各種サーバおよびコマンドの稼働監視の情報として使用します。

ユーザログ

アプリケーション中で出力される標準出力および標準エラー出力の情報が出力されます。アプリケーションの開発時の動作確認用に使用します。なお，java.security.debugプロパティを指定してサーバを起動した場合，標準出力および標準エラー出力の情報はユーザログに出力されません。JavaVMのメモリ関連ログも含みます。

例外ログ

システムでトラブルが発生したときのComponent Containerの例外情報が出力されます。なお，例外ログは日常的な運用で監視する必要はありません。ログにメッセージが出力された場合に，例外情報を参照するときにご利用ください。

保守用ログ

システムでトラブルが発生したときのComponent Containerの障害保守情報が出力されます。保守員が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のログファイルを空にし，そこへログを記録していきます。以降，ログファイルを空にしながら，面番号の順にログファイルへログを記録していきます。

ログの出力先のデフォルトを次の表に示します。Component Containerのログは，サーバ単位またはコマンド単位に取得できます。

ログの出力先に示す<作業ディレクトリ>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥CC¥server¥public（Windowsの場合），または/opt/Cosminexus/CC/server/public（UNIXの場合）です。

(a)　バッチサーバのログ

表4‒19　バッチサーバのログの出力先（デフォルト）

分類

内容

ログ出力先およびログファイル名※1

デフォルトのサイズ×面数

チャネル名

メッセージログ

稼働ログ

Windowsの場合

<ejb.server.log.directory>※2¥cjmessage[n].log

UNIXの場合

<ejb.server.log.directory>※2/cjmessage[n].log

1MB×2

MessageLogFile

ログ稼働ログ※3

Windowsの場合

<ejb.server.log.directory>※2¥cjlogger.log

UNIXの場合

<ejb.server.log.directory>※2/cjlogger.log

1MB×2

−

バッチサーバにデプロイして使用するリソースアダプタの稼働ログ※4

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の保守情報およびGCのログ

Windowsの場合

<ejb.server.log.directory>※2¥javalog[nn].log

UNIXの場合

<ejb.server.log.directory>※2/javalog[nn].log

4MB×4

−

明示管理ヒープ機能のイベントログ

Windowsの場合

<ejb.server.log.directory>※2¥ehjavalog[nn].log

UNIXの場合

<ejb.server.log.directory>※2/ehjavalog[nn].log

4MB×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

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

Windowsの場合

<ejb.server.log.directory>※2¥CC¥maintenance¥cjstdout.log

UNIXの場合

<ejb.server.log.directory>※2/CC/maintenance/cjstdout.log

−

−

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

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※6

−

イベントログ

バッチサーバの起動，停止または異常終了を示すログ

Windowsのイベントビューアのアプリケーションログ※7

−

−

syslog

バッチサーバの起動，停止または異常終了を示すログ

UNIXのsyslogの設定に依存します。※8

−

−

（凡例）　−：該当しない

注

チャネル名は，ログの出力先を識別する名称です。

注※1

ログファイル名の[n]の部分には，面の番号（1から各ログの最大面数まで）が付きます。

また，[nn]の部分には，01〜99の通し番号が付きます。

注※2

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

ejb.server.log.directoryパラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「3.2.1　usrconf.cfg（バッチサーバ用オプション定義ファイル）」を参照してください。

注※3

ファイル出力時にファイル容量をチェックします。チェック時に最大容量を超えた場合，cjlogger.logファイルの名称をバックアップファイルの名称（cjlogger_save.log）に変更します。

注※4

リソースアダプタのログを取得するかどうかは，サーバ管理コマンドで指定されている内容に従います。また，リソースアダプタのログは，簡易構築定義ファイルでサイズおよび面数を変更できます。リソースアダプタのログ取得の設定については，「3.3.11　リソースアダプタのログ取得の設定」を参照してください。

注※5

起動プロセス情報だけを取得するログです。主にバッチサーバの起動または終了時に出力されるため，オンライン中に出力されることはほとんどありません。ファイルのサイズが上限に達したときは，<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs下（Windowsの場合），または<作業ディレクトリ>/ejb/<サーバ名称>/logs下（UNIXの場合）のcjstdout_save.logまたはcjstderr_save.logに退避されます。すでにcjstdout_save.logまたはcjstderr_save.logがあったときは，上書きされます。

注※6

サイズおよび面数は，変更できません。

注※7

ログファイルの出力先はWindowsのイベントログの設定によって異なります。

注※8

バッチサーバの起動，停止および異常終了のメッセージをsyslogに出力するためには，syslogの設定で，facility「daemon」に対するpriorityを「info」または「debug」に設定する必要があります。syslogの設定に関する詳細については，OS付属のマニュアルを参照してください。

(b)　サーバ管理コマンドのログ

表4‒20　サーバ管理コマンドのログの出力先（デフォルト）

分類

内容

ログ出力先およびログファイル名※1

デフォルトのサイズ×面数

チャネル名

メッセージログ

稼働ログ※2，※3

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥cjmessage[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/cjmessage[n].log

1024KB×3

MessageLogFile

ログ稼働ログ※2

Windowsの場合

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

UNIXの場合

/opt/Cosminexus/CC/admin/logs/ cjlogger.log

1024KB×2

−

例外ログ

障害発生時の例外情報※2，※3

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥cjexception[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/cjexception[n].log

1024KB×6

ExceptionLogFile

保守用ログ

保守情報※2

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjmaintenance[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjmaintenance[n].log

1024KB×3

MaintenanceLogFile

コンソールメッセージ※2

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥cjconsole[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/CC/maintenance/cjconsole[n].log

32KB×3

ConsoleLogFile

サーバ管理コマンドの保守情報※2

Windowsの場合

<Application Serverのインストールディレクトリ>¥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から各ログの最大面数まで）が付きます。

注※2

トレース共通ライブラリ形式の出力メッセージ（アプリケーション識別名）には，コマンド名が表示されます。トレース共通ライブラリ形式のログについては，「5.2　アプリケーションサーバのログ」を参照してください。

注※3

互換モードの場合，稼働ログと障害発生時の例外情報の出力先は標準モードと異なります。互換モードの場合の出力先とデフォルトのサイズ・面数は次のようになります。

表4‒21　サーバ管理コマンドのログの出力先（互換モード）

内容

ログ出力先およびログファイル名※

デフォルトのサイズ×面数

稼働ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥<コマンド名称>message[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/<コマンド名称>message[n].log

128KB×2

障害発生時の例外情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥<コマンド名称>exception[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/<コマンド名称>exception[n].log

256KB×2

注※

ログファイル名の[n]の部分には，面の番号（1から面数（最大16まで））が付きます。

サーバ管理コマンドのメッセージログに出力されるメッセージには，メッセージIDフィールドが空白で，メッセージテキストフィールドにメッセージID（KDJEnnnnn-Yなど）が含まれる場合があります。それらはサーバ側で発生したメッセージで，前後に出力されるメッセージの付加情報となります。

(c)　バッチアプリケーションのログ

表4‒22　バッチアプリケーションのログの出力先（デフォルト）

分類

内容

ログ出力先およびログファイル名※1

デフォルトのサイズ×面数

メッセージログ

cjexecjobコマンド，cjkilljobコマンドおよびcjlistjobコマンドの稼働ログ

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

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

UNIXの場合

/opt/Cosminexus/CC/batch/logs

(d)　リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

表4‒23　リソースアダプタバージョンアップコマンド（cjrarupdate）のログの出力先

分類

内容

ログ出力先およびログファイル名※

デフォルトのサイズ×面数

メッセージログ

稼働ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjrarupdatemessage[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjrarupdatemessage[n].log

1MB×2

例外ログ

障害発生時の例外情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjrarupdateexception[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjrarupdateexception[n].log

1MB×2

保守用ログ

保守情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjrarupdatemaintenance[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjrarupdatemaintenance[n].log

1MB×2

注※

ログファイル名の[n]の部分には，面の番号（1から面数（最大16まで））が付きます。

(e)　移行コマンド（cjenvupdate）のログ

表4‒24　移行コマンド（cjenvupdate）のログの出力先

分類

内容

ログ出力先およびログファイル名※

デフォルトのサイズ×面数

メッセージログ

cjenvupdateコマンドの稼働ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjenvupdatemessage[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjenvupdatemessage[n].log

4MB×4

例外ログ

cjenvupdateコマンドの例外情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjenvupdateexception[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjenvupdateexception[n].log

4MB×4

保守用ログ

cjenvupdateコマンドの保守情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥logs¥cjenvupdatemaintenance[n].log

UNIXの場合

/opt/Cosminexus/CC/logs/cjenvupdatemaintenance[n].log

4MB×4

注※

[n]には，面の番号（1から面数（最大16まで））が付きます。

(f)　リソース枯渇監視のログ

表4‒25　リソース枯渇監視のログの出力先

監視対象

リソース

ログ取得場所およびログファイル名※1

デフォルトのサイズ×面数

チャネル名

メモリ

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjmemorywatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjmemorywatch[n].log

1MB×2

MemoryWatchLogFile

ファイルディスクリプタ

UNIXの場合※3

<ejb.server.log.directory>※2/watch/cjfiledescriptorwatch[n].log

1MB×2

FileDescriptorWatchLogFile

スレッド

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjthreadwatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjthreadwatch[n].log

1MB×2

ThreadWatchLogFile

スレッドダンプ

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjthreaddumpwatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjthreaddumpwatch[n].log

1MB×2

ThreaddumpWatchLogFile

HTTPリクエスト実行待ちキュー

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjrequestqueuewatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjrequestqueuewatch[n].log

1MB×2

RequestQueueWatchLogFile

HTTPセッション数

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjhttpsessionwatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjhttpsessionwatch[n].log

1MB×2

HttpSessionWatchLogFile

コネクションプール

Windowsの場合

<ejb.server.log.directory>※2¥watch¥cjconnectionpoolwatch[n].log

UNIXの場合

<ejb.server.log.directory>※2/watch/cjconnectionpoolwatch[n].log

1MB×2

ConnectionPoolWatchLogFile

注

チャネル名は，ログの出力先を識別する名称です。ログの属性（サイズ，面数）を変更する場合のキー値として使用します。

注※1

[n]には，面の番号（1から面数（最大16まで））が付きます。

注※2

<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

ejb.server.log.directoryパラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「3.2.1　usrconf.cfg（バッチサーバ用オプション定義ファイル）」を参照してください。

注※3

Windowsの場合，またはAIXの場合は，ファイルディスクリプタを監視できません。

リソース枯渇監視ログファイルに出力される情報やログファイルの出力形式については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「4.3　リソース枯渇監視機能とリソース枯渇監視情報の出力」を参照してください。

(g)　ログの出力先を設定するユーザ定義ファイル

バッチサーバおよびサーバ管理コマンドのログの出力先を変更している場合は，次の表に示す，ログの出力先を設定するユーザ定義ファイルを参照して出力先を確認してください。なお，ログの出力先を変更した場合，変更後の出力先はsnapshotログの一括収集時に収集対象外となります。必要に応じてsnapshotログの収集先を変更してください。

表4‒26　ログの出力先を設定するユーザ定義ファイル

分類

ユーザ定義ファイルの指定個所

バッチサーバ

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に指定する，ejb.server.log.directoryパラメタ。

デフォルトは，「<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/logs」（UNIXの場合）です。

サーバ管理コマンド

サーバ管理コマンドのusrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のejbserver.log.directoryキー。

キーのデフォルトは，「<Application Serverのインストールディレクトリ>¥CC¥admin¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/admin/logs」（UNIXの場合）です。

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

ログの出力先の変更方法など，トラブルシューティングの資料取得の設定については，「3.　トラブルシューティングのための準備」を参照してください。

(2)　運用管理エージェント・運用監視エージェント・Management Serverのログの取得

ここでは，運用管理エージェント，運用監視エージェント，およびManagement Serverのログの出力先について説明します。

運用管理エージェント・運用監視エージェント・Management Serverのログには，個別に取得する以外に，統合ログとしてまとめて取得できるものがあります。

運用管理エージェント・運用監視エージェント・Management Serverのログを統合ログとしてまとめて取得する場合，および個別に取得する場合の出力先については，「4.3.1(2)　運用管理エージェント・運用監視エージェント・Management Serverのログの取得」を参照してください。

(3)　ログ以外に取得が必要な情報

ログ以外に取得する必要がある情報については，「4.3.1(6)　ログ以外に取得が必要な情報」を参照してください。

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

バッチアプリケーションのユーザログは，トレース共通ライブラリ形式で出力するように設定している場合に取得できます。トレース共通ライブラリ形式のログについては，「5.2　アプリケーションサーバのログ」を参照してください。

バッチアプリケーションのユーザログの出力先については，次のディレクトリに，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にejbserver.application.userlog.CJLogHandler.<ハンドラ名>.pathパラメタで指定したプリフィックスを持つファイル名で出力されます。なお，<ハンドラ名>には，キーの値を区別するためのハンドラ名が指定されています。

Windowsの場合

<ログ出力先ルート（ejb.server.log.directoryの値）>¥user¥（デフォルトは<バッチサーバの作業ディレクトリ>¥ejb¥<バッチサーバ名>¥logs¥user）

UNIXの場合

<ログ出力先ルート（ejb.server.log.directoryの値）>/user/（デフォルトは<バッチサーバの作業ディレクトリ>/ejb/<バッチサーバ名>/logs/user）

なお，バッチアプリケーションのユーザログ出力の設定については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「2.3.5　バッチアプリケーションのログ出力」を参照してください。

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

EJBクライアントアプリケーションのシステムログの種類と出力先について説明します。

なお，EJBクライアントアプリケーションのシステムログを運用するときに留意することについては，「2.6.1　EJBクライアントアプリケーションのシステムログに関する留意事項」を参照してください。

注意事項

Clientを使用する場合は，EJBクライアントアプリケーションのログの格納ディレクトリを示す「<Application Serverのインストールディレクトリ>¥CC」を，「<Application Serverのインストールディレクトリ>¥CCL」と読み替えてください。

4.5.1　EJBクライアントアプリケーションのシステムログの種類

EJBクライアントアプリケーションでは，EJBクライアントアプリケーションのプロセス単位にシステムログを出力します。EJBクライアントアプリケーションのシステムログの種類を次に示します。

表4‒27　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の保守情報，GCのログ

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

このログは，保守員へ送付する場合に必要に応じて収集してください。

4.5.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）は，「<Application Serverのインストールディレクトリ>¥CC¥client¥logs」（Windowsの場合），または「/opt/Cosminexus/CC/client/logs」（UNIXの場合）の直下に出力されます。

注意事項

EJBクライアントアプリケーションの標準出力，および標準エラーの内容は，ログファイルには出力されません。ログファイルに出力する場合は，ユーザログ機能を使用するか，リダイレクトしてください。

複数のプロセスのログは，一つのディレクトリ（デフォルトはejbclディレクトリ）下に出力します。なお，プロセス単位（アプリケーション単位）でログの出力先を別々にしたい場合，usrconf.cfgのejb.client.log.directoryキーにそれぞれの出力先ディレクトリを指定してください。

EJBクライアントアプリケーションのシステムログの出力先を次の図に示します。

図4‒1　EJBクライアントアプリケーションのシステムログの出力先（Javaアプリケーション用オプション定義ファイルで指定した場合）

図4‒2　EJBクライアントアプリケーションのシステムログの出力先（システムプロパティで指定した場合）

4.6　性能解析トレース

性能解析トレースの格納場所は次のとおりです。

Windowsの場合

<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥prf¥<PRF識別子>

UNIXの場合

$PRFSPOOL/utt/prf/<PRF識別子>

性能解析トレースの収集方法については，「7.　性能解析トレースを使用した性能解析」を参照してください。性能解析トレースには，セッショントレースも出力されている場合があります。

4.7　JavaVMのスレッドダンプ

ここでは，JavaVMのスレッドダンプを取得する方法について説明します。

JavaVMのスレッドダンプは，次の方法で取得できます。

運用管理コマンド（mngsvrutil）を使用して，J2EEサーバ，CORBAネーミングサービス，およびCTMのスレッドダンプを取得する。

個別のコマンドを使用して，J2EEサーバ，CORBAネーミングサービス，およびEJBクライアントアプリケーションのスレッドダンプを取得する。

JavaVMのコマンドを使用して，クラス別統計情報またはExplicitヒープ詳細情報を拡張スレッドダンプに取得する。

注意事項

スレッドダンプを取得する場合は，前回のスレッドダンプの出力が終了してから取得してください。

それぞれの方法について次に説明します。

4.7.1　運用管理コマンドを使用する場合

運用管理コマンド（mngsvrutil）を利用したJavaVMのスレッドダンプの取得は，mngsvrutilコマンドのサブコマンド「dump」の引数にserverを指定して実行します。

次のスレッドダンプを取得できます。

J2EEサーバ（クラスタを含む）

CORBAネーミングサービスおよびCTM

mngsvrutilコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「mngsvrutil（Management Serverの運用管理コマンド）」を参照してください。mngsvrutilコマンドのサブコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「7.3　mngsvrutilコマンドのサブコマンドの詳細」を参照してください。

実行形式，実行例，および出力先を次に示します。

実行形式

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

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

UNIXの場合

/opt/Cosminexus/CC/server/public

CORBAネーミングサービスおよびCTMを対象にする場合

Windowsの場合

<Application Serverのインストールディレクトリ>¥TPB¥logj¥javacore*.txt

UNIXの場合

/opt/Cosminexus/TPB/logj/javacore*.txt

4.7.2　個別のコマンドを使用する場合

スレッドダンプの出力のされ方は，指定しているJ2EEサーバを実行するJavaVMの起動オプションによって異なります。

-XX:+HitachiThreadDumpが設定されている場合，拡張スレッドダンプを取得できます。このオプションはデフォルトで設定されています。

-XX:+HitachiThreadDumpToStdoutが設定されている場合，スレッドダンプは標準出力にも出力されます。このオプションはデフォルトでは設定されていません。必要に応じて設定してください。

次に示す起動オプションが設定されている場合に，-XX:+HitachiOutOfMemoryAbortThreadDumpが設定されていると，OutOfMemoryErrorによって強制終了した時に，スレッドダンプが出力されます。

-XX:+HitachiOutOfMemoryAbort

-XX:+HitachiThreadDump

ただし，次の場合は除きます。

J2SEクラスライブラリでCヒープ不足が発生した場合

JavaVMの処理中にCヒープ不足が発生した場合

次に示す起動オプションが設定されている場合に，-XX:+HitachiOutOfMemoryAbortThreadDumpWithJHeapProfが設定されていると，OutOfMemoryErrorによって強制終了した時に，スレッドダンプにクラス別統計情報が出力されます。クラス別統計情報については，「9.3　クラス別統計機能」を参照してください。このオプション設定時に出力されるクラス別統計情報は，jheapprofコマンド実行時に取得する情報と同じです。

-XX:+HitachiOutOfMemoryAbort

-XX:+HitachiOutOfMemoryAbortThreadDump

-XX:+HitachiThreadDump

(1)　J2EEサーバのスレッドダンプの取得

J2EEサーバプロセス(cjstartsv)が存在する場合，J2EEサーバのスレッドダンプは，cjdumpsvコマンドを実行して取得します。cjdumpsvコマンドの実行例を次に示します。時間の経過に応じた各スレッドの状態遷移を確認するため，複数回cjdumpsvコマンドを実行します。目安として3秒おきに10回程度実行します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥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の場合）です。出力先を変更している場合は，「4.3　アプリケーションサーバのログ（J2EEアプリケーションを実行するシステム）」または「4.4　アプリケーションサーバのログ（バッチアプリケーションを実行するシステム）」を参照してください。なお，作業ディレクトリのデフォルトのディレクトリパスは「<Application Serverのインストールディレクトリ>¥CC¥server¥public」（Windowsの場合），または「/opt/Cosminexus/CC/server/public」（UNIXの場合）です。

また，javacore<プロセス番号>.<コマンド実行日時>.txtファイルの出力先は，環境変数JAVACOREDIRで変更できます。ただし，指定したディレクトリへの書き込みに失敗した場合は，デフォルトの出力先に出力されます。このディレクトリにも出力できなかった場合は，標準エラー出力にだけ出力されます。

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

参考

スレッドダンプが出力されると，標準出力に，次のメッセージが出力され，javaプログラムの実行が継続されます。このメッセージは，-XX:+HitachiThreadDumpToStdoutの設定とは関係なく出力されます。

Writing Java core to <ファイル名（フルパス）>...OK

(2)　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`

(3)　EJBクライアントアプリケーションのスレッドダンプの取得

EJBクライアントアプリケーションのスレッドダンプは，cjcldumpapコマンドを実行して取得します。

cjcldumpapコマンドを実行すると，cjclstartapコマンドを実行して起動したEJBクライアントアプリケーションのスレッドダンプが出力されます。また，特定のプロセスのスレッドダンプを出力することもできます。cjcldumpapコマンドの詳細については，マニュアル「アプリケーションサーバリファレンス コマンド編」の「cjcldumpap（Javaアプリケーションのスレッドダンプの取得）」を参照してください。

cjcldumpapコマンドの実行形式，実行例，およびスレッドダンプの出力先を次に示します。

実行形式

cjclstartapコマンドを使用して起動したEJBクライアントアプリケーションのスレッドダンプを出力する場合

cjcldumpap

特定のプロセスのスレッドダンプを出力する場合

cjcldumpap ＜プロセスID＞

実行例

cjclstartapコマンドを使用して起動したEJBクライアントアプリケーションのスレッドダンプを出力する場合

cjcldumpap

特定のプロセスのスレッドダンプを出力する場合

cjcldumpap 3264

出力先

cjclstartapコマンドを実行しているカレントディレクトリ

4.7.3　JavaVMのコマンドを使用する場合

JavaVMのコマンドを使用すると，拡張スレッドダンプにクラス別統計情報やExplicitヒープ詳細情報を取得できます。

(1)　クラス別統計情報の拡張スレッドダンプへの取得

クラス別統計情報を含む拡張スレッドダンプは，jheapprofコマンドを実行して取得します。クラス別統計情報は，クラス別統計機能で出力する情報で，GCによるJavaオブジェクトの変化や，Javaオブジェクトの参照関係などを調査する場合に使用します。クラス別統計機能については，「9.3　クラス別統計機能」を，クラス別統計情報の出力方法については，「9.3.3　クラス別統計情報の出力」を参照してください。jheapprofコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「jheapprof（クラス別統計情報付き拡張スレッドダンプの出力）」を参照してください。

(2)　Explicitヒープ詳細情報の拡張スレッドダンプへの取得

Explicitヒープ詳細情報のうち，次の情報は明示管理ヒープ機能が有効な場合に，拡張スレッドダンプに必ず取得されます。

Explicitヒープ情報

Explicitメモリブロック情報

Explicitヒープ詳細情報のオブジェクト統計情報，およびExplicitメモリブロックの解放率情報は，eheapprofコマンドを実行して拡張スレッドダンプに取得します。オブジェクト統計情報は，Explicitメモリブロック内の詳細情報です。解放率情報は，Explicitメモリブロックの自動解放処理で解放されたオブジェクトの割合です。明示管理ヒープ機能を使用するシステムのデバッグや障害解析に使用します。

明示管理ヒープ機能については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「7.　明示管理ヒープ機能を使用したFullGCの抑止」を参照してください。eheapprofコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「eheapprof（Explicitヒープ詳細情報付き拡張スレッドダンプの出力）」を参照してください。

実行形式

Windowsの場合

eheapprof [-f|-i] [-freeratio] -p <プロセスID>

UNIXの場合

eheapprof [-f|-i] [-freeratio] [-force] -p <プロセスID>

実行例

ここでは，プロセスIDが2463のJavaプロセスのクラス別統計情報を出力します。

-pオプションに，クラス別統計情報を出力したいJavaプロセスのプロセスIDを指定して，eheapprofコマンドを実行します。

% eheapprof -p 2463

eheapprofコマンドで-fオプションを省略している場合，次の確認メッセージが表示されます。

Windowsの場合

クラス別統計情報付き拡張スレッドダンプを出力するかどうかを確認するメッセージが次の形式で表示されます。

Force VM to output ExplicitHeapProf: ? (y/n)

UNIXの場合

プロセスIDを確認するメッセージが次の形式で表示されます。

send SIGQUIT to 2463: ? (y/n)

yを入力します。

クラス別統計情報付き拡張スレッドダンプを出力すると，実行中のjavaプログラムでは次のメッセージが出力されます。

Writing Java core to javacore2463.030806215140.txt... OK

実行中のjavaプログラムは，カレントディレクトリにクラス別統計情報付き拡張スレッドダンプ（javacore<プロセスID>.<日時>.txt）を作成し，プログラムを継続します。

4.7.4　スレッドダンプにクラス別統計情報を出力する場合の注意事項

JavaVMの起動オプションに-XX:+HitachiOutOfMemoryAbortThreadDumpWithJHeapProfが設定されていると，OutOfMemoryErrorによって強制終了した時に，スレッドダンプにクラス別統計情報が出力されます。

大量のヒープ（Javaヒープ，ExplicitヒープまたはMetaspace領域）を使用している場合に，スレッドダンプにクラス別統計情報が出力されると時間が掛かります。このため，OutOfMemoryError発生時にJavaVMを即時に強制終了して回復させることができないことがあります。

注意事項

次のJavaVMの起動オプションが設定されていない場合，スレッドダンプにクラス別統計情報は出力されません。

-XX:+HitachiOutOfMemoryAbort

-XX:+HitachiOutOfMemoryAbortThreadDump

-XX:+HitachiThreadDump

4.8　JavaVMのGCログ

JavaVMのGCログは，JavaVMまたはJ2EEサーバ起動前にログ出力先が設定されている場合にだけ取得できます。

GCログの出力先は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定します。

また，実行中のJavaプロセスでFullGCを発生させたい場合は，javagcコマンドを実行してください。javagcコマンドは，トラブル発生時の要因調査のほか，1トランザクション当たりのメモリ使用量の測定，メモリリークの調査，アプリケーションのデバッグなどの目的でも使用できます。

実行中のJavaプロセスを指定してFullGCを発生させる場合のjavagcコマンドの実行形式を次に示します。なお，これ以外に指定できるオプションについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「javagc（GCの強制発生）」を参照してください。

実行形式

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)] [Metaspace: 3634K(4492K, 4492K)->3634K(4492K, 4492K)][class space: 356K(388K, 388K)->356K(388K, 388K)] [ cause:JavaGC Command]

4.9　メモリダンプ

J2EEサーバまたはCORBAネーミングサービスを再起動する場合は，メモリダンプとして次のファイルを取得します。

ユーザダンプ（Windowsの場合）

J2EEサーバのメモリダンプ

CORBAネーミングサービスのメモリダンプ

Management Serverのメモリダンプ

運用管理エージェントのメモリダンプ

これらのファイルは，システムでトラブルが発生したときに，保守員が障害を解析するために使用します。

4.9.1　ユーザダンプの取得（Windowsの場合）

ユーザダンプの取得について説明します。

タスクマネージャまたはWindowsのデバッグツールを使用して，ユーザダンプを取得します。詳細は，Microsoft社のホームページを参照してください。

またはcjstopsvコマンドの-fdオプションを使用して次のファイルを取得します。

<ユーザダンプの出力先ディレクトリ>¥cjmemdump.dmp

<ユーザダンプの出力先ディレクトリ>は，環境変数CJMEMDUMP_PATHで指定しておいてください。

4.9.2　J2EEサーバのメモリダンプの取得

J2EEサーバのメモリダンプの取得について，OSごとに説明します。

(1)　Windowsの場合

J2EEサーバが稼働している場合（cjstartsvプロセスが存在する場合），タスクマネージャ※からメモリダンプを採取します。

J2EEサーバが稼働していて，かつ，強制停止してメモリダンプを取得する場合，cjstopsvコマンドに-fdオプションを指定して実行し，メモリダンプを取得します。

J2EEサーバがダウンしている場合，Windowsのデバッグツール※からメモリダンプを採取します。

注※

詳細は，Microsoft社のホームページを参照してください。

ダウンしている場合のメモリダンプを取得するためには，事前に設定を行う必要があります。設定方法については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「3.3.15　ユーザダンプ取得の設定」を参照してください。

(2)　UNIXの場合

cjstartsvプロセスがダウンした場合，「<作業ディレクトリ>/ejb/<サーバ名称>」に出力されたcoreダンプを取得します。

coreダンプのファイル名は，cjstartsvプロセスの再起動時に「core.<出力日時※>」（AIXの場合）または「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ファイルのファイル数の上限値の設定については，「3.3.16　coreダンプ取得の設定」を参照してください。

coreダンプを取得したあとに，coreダンプからスタックトレース情報だけを取得する場合は，javatraceコマンドを実行してください。スタックトレース情報は，JavaVMの異常終了の原因を究明するために必要な情報です。スタックトレース情報の取得方法については，「4.18　JavaVMのスタックトレース情報」を参照してください。

coreダンプは次のような場合にも取得できます。それぞれの場合の取得方法について説明します。

cjstartsvプロセスが稼働している状態でcoreダンプを取得する場合

cjstartsvプロセス（J2EEサーバ）が稼働している状態でcoreダンプを取得する場合，cjstartsvプロセスのプロセスIDを確認して，killコマンドを実行します。killコマンドは次の形式で実行してください。なお，killコマンドを実行するとプロセスが終了するため，再起動する前にkillコマンドを実行することを推奨します。

kill -6 <cjstartsvのプロセスID>

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合は，javacoreコマンドを実行してください。javacoreコマンドの実行形式を次に示します。なお，指定できるオプションについては，マニュアル「アプリケーションサーバリファレンス コマンド編」の「javacore（coreファイルとスレッドダンプの取得／UNIXの場合）」を参照してください。

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

4.9.3　CORBAネーミングサービスのメモリダンプの取得

CORBAネーミングサービスのメモリダンプの取得についてOSごとに説明します。

(1)　Windowsの場合

CORBAネーミングサービスが稼働している場合（CORBAネーミングサービスのプロセスが存在する場合），タスクマネージャ※からメモリダンプを採取します。

CORBAネーミングサービスがダウンしている場合，Windowsのデバッグツール※からメモリダンプを採取します。

注※

詳細は，Microsoft社のホームページを参照してください。

ダウンしている場合のメモリダンプを取得するためには，事前に設定を行う必要があります。設定方法については，「3.3.15　ユーザダンプ取得の設定」を参照してください。

(2)　UNIXの場合

CORBAネーミングサービスが稼働している場合（CORBAネーミングサービスのプロセスが存在する場合），CORBAネーミングサービスのプロセスIDを確認して，killコマンドを実行します。killコマンドは次の形式で実行してください。なお，killコマンドを実行するとプロセスが終了するため，再起動する前にkillコマンドを実行することを推奨します。

ps -ef | grep java
kill -6 <CORBAネーミングサービスのプロセスID>

4.9.4　Management Serverのメモリダンプの取得

Management Serverのメモリダンプの取得について，OSごとに説明します。

(1)　Windowsの場合

Management Serverが稼働している場合（cjstartsv.exeプロセスが存在する場合），タスクマネージャ※からメモリダンプを採取します。

Management Serverがダウンしている場合，Windowsのデバッグツール※からメモリダンプを採取します。

注※

詳細は，Microsoft社のホームページを参照してください。

Management Serverがダウンしている場合のメモリダンプを取得するためには，事前に設定をする必要があります。設定方法については，「3.3.15　ユーザダンプ取得の設定」を参照してください。

(2)　UNIXの場合

Management Server（cjstartsvプロセス）がダウンした場合，「<Application Serverのインストールディレクトリ>/manager/containers/m/ejb/<Management Serverのサーバ名>」に出力されたcoreダンプを取得します。

coreダンプのファイル名は，Management Serverの再起動時に「core.<出力日時※>」（AIXの場合）または「core.<プロセスID>.<出力日時※>」（Linuxの場合）にリネームされます。Management Serverの再起動時にcoreダンプが上書き保存されないため，障害発生時のcoreダンプを保存できます。

注※

出力日時は「YYMMDDhhmmss」の形式で出力されます。

YY：西暦（下2けた）　MM：月（2けた）　DD：日（2けた）

hh：時（24時間表記で2けた）　mm：分（2けた）　ss：秒（2けた）

coreダンプを取得したあとに，coreダンプからスタックトレース情報だけを取得する場合は，javatraceコマンドを実行してください。スタックトレース情報は，JavaVMの異常終了の原因を究明するために必要な情報です。スタックトレース情報の取得方法については，「4.18　JavaVMのスタックトレース情報」を参照してください。

coreダンプは次のような場合にも取得できます。それぞれの場合の取得方法について説明します。

Management Serverが稼働している状態でcoreダンプを取得する場合

Management Serverが稼働している状態でcoreダンプを取得する場合，cjstartsvプロセスのプロセスIDを確認して，killコマンドを実行します。killコマンドは次の形式で実行してください。なお，killコマンドを実行するとプロセスが終了するため，Management Serverが再起動する前にkillコマンドを実行することを推奨します。

kill -6 <Management Server（cjstartsv）のプロセスID>

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合は，javacoreコマンドを実行してください。javacoreコマンドの実行形式を次に示します。なお，指定できるオプションについては，マニュアル「アプリケーションサーバリファレンス コマンド編」の「javacore（coreファイルとスレッドダンプの取得／UNIXの場合）」を参照してください。

javacore -p <プロセス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

4.9.5　運用管理エージェントのメモリダンプの取得

運用管理エージェントのメモリダンプの取得について，OSごとに説明します。

(1)　Windowsの場合

運用管理エージェントが稼働している場合（adminagentプロセスが存在する場合），タスクマネージャ※からメモリダンプを採取します。

運用管理エージェントがダウンしている場合，Windowsのデバッグツール※からメモリダンプを採取します。

注※

詳細は，Microsoft社のホームページを参照してください。

運用管理エージェントがダウンしている場合のメモリダンプを取得するためには，事前に設定をする必要があります。設定方法については，「3.3.15　ユーザダンプ取得の設定」を参照してください。

(2)　UNIXの場合

運用管理エージェント（adminagentプロセス）がダウンした場合，「<Application Serverのインストールディレクトリ>/manager/bin」に出力されたcoreダンプを取得します。

coreダンプを取得したあとに，coreダンプからスタックトレース情報だけを取得する場合は，javatraceコマンドを実行してください。スタックトレース情報は，JavaVMの異常終了の原因を究明するために必要な情報です。スタックトレース情報の取得方法については，「4.18　JavaVMのスタックトレース情報」を参照してください。

coreダンプは次のような場合にも取得できます。それぞれの場合の取得方法について説明します。

運用管理エージェントが稼働している状態でcoreダンプを取得する場合

運用管理エージェントが稼働している状態でcoreダンプを取得する場合，adminagentプロセスのプロセスIDを確認して，killコマンドを実行します。killコマンドは次の形式で実行してください。なお，killコマンドを実行するとプロセスが終了するため，運用管理エージェントが再起動する前にkillコマンドを実行することを推奨します。

kill -6 <運用管理エージェント（adminagent）のプロセスID>

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合

実行中のJavaプロセスでcoreダンプとスレッドダンプを同時に取得する場合は，javacoreコマンドを実行してください。javacoreコマンドの実行形式を次に示します。なお，指定できるオプションについては，マニュアル「アプリケーションサーバリファレンス コマンド編」の「javacore（coreファイルとスレッドダンプの取得／UNIXの場合）」を参照してください。

javacore -p <プロセス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

4.9.6　メモリダンプ取得時の注意事項

(1)　Windowsの場合

次の場合，ユーザダンプが出力されません。

-XX:+HitachiOutOfMemoryAbortオプションの指定による強制停止の場合

JavaVM処理中のCヒープ不足発生による強制終了の場合

4.10　JavaVMログ（JavaVMログファイル）

JavaVMログとは，製品が標準のJavaVMに追加した拡張オプションを使用して取得できるログです。標準のJavaVMよりも，多くのトラブルシュート情報が取得できます。JavaVMログは，次のどれかのオプションを指定した場合に，ログファイルに出力されます。なお，このログファイルを，JavaVMログファイルといいます。

-XX:+HitachiOutOfMemoryStackTrace

なお，このオプションを指定した場合に同時に指定される，-XX:+HitachiOutOfMemorySizeおよび-XX:+HitachiOutOfMemoryCauseが指定された場合も，JavaVMログファイルが出力されます。

-XX:+HitachiVerboseGC

-XX:+HitachiOutOfMemoryHandling

-XX:+HitachiJavaClassLibTrace

-XX:+JITCompilerContinuation

このほか，出力内容や出力方法についても，オプションに指定しておく必要があります。JavaVMの資料取得の設定については，「3.3.17　JavaVMの資料取得の設定」を参照してください。

JavaVMログファイルは，-XX:HitachiJavaLog:＜パスおよびファイル名称＞オプションに指定した出力先に，指定したファイル名称で出力されます。指定を省略した場合は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリに，「javalogxx.log」という名称で出力されます。xxは01から始まる2けたの通番です。

参考

JavaVMログファイルの出力が設定されている場合に，JavaVM起動時にファイルを作成します。このため，JavaVM終了時までにJavaVMログが何も出力されない場合には，何も情報がないJavaVMログファイルが残ります。

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

ここでは，JavaVMが出力するメッセージログの取得について説明します。

JavaVMでクラッシュが発生した場合，JavaVMはデバッグ情報を標準出力とエラーリポートファイルに出力します。

エラーリポートファイルは，次の場合に出力されます。

JNIの中でシグナルが発生したとき

JavaVMでCヒープ不足が発生したとき

JavaVMで予期しないシグナルが発生したとき

JavaVMでInternal Error（内部論理エラー）が発生したとき

ただし，エラーリポートファイルの作成時にシグナルやメモリ不足が発生した場合，このファイルは作成されません。

4.11.1　Windowsの場合

エラーリポートファイルの出力先および出力ファイル名は次のとおりです。

<作業ディレクトリ>¥ejb¥<サーバ名>¥hs_err_pid<サーバプロセスのプロセスID>.log

参考

Cヒープが不足した場合，次の順序でメッセージ出力およびダンプ出力が実行されます。必要な情報を取得してください。

Cヒープ不足を示すメッセージログが，エラーリポートファイルおよび標準出力に出力されます。

1.の実行中にメモリ不足が発生した場合，簡易メッセージが標準出力に出力されます。

4.11.2　UNIXの場合

エラーリポートファイルの出力先および出力ファイル名は次のとおりです。

<作業ディレクトリ>/ejb/<サーバ名>/hs_err_pid<サーバプロセスのプロセスID>.log

参考

Cヒープが不足した場合，次の順序でメッセージ出力およびcoreダンプの生成が実行されます。必要な情報を取得してください。

Cヒープ不足を示すメッセージログが，エラーリポートファイルおよび標準出力に出力されます。

1.の実行中にメモリ不足が発生した場合，簡易メッセージが標準出力に出力されます。

簡易メッセージの出力処理中にさらにメモリ不足が発生した場合，メッセージおよびエラーログファイルの出力処理を中止して，coreダンプを生成します。

4.12　OSの状態情報とOSのログ

トラブルシュート情報として必要なOSのログ情報を次に示します。

4.12.1　OSの状態情報の取得

トラブルシュート情報として必要なOSの状態情報の取得について，OSごとに説明します。

(1)　Windowsの場合

OSの状態情報は，cjgetsysinfoコマンドを使用して取得できます。-fオプションを指定すると，OS状態出力ファイルに出力できます。

コマンドは，次の形式で実行します。

cjgetsysinfo -f <OS状態出力ファイルパス>

このコマンドによって，OSの次のコマンドを実行した場合と同じ情報が取得できます。

netstat -e
netstat -s
netstat -an
set

なお，cjgetsysinfoコマンドを実行しない場合に，トラブルシュート情報として取得する必要があるOSの状態情報を次に示します。各情報の取得はあらかじめディレクトリを作成し，そこにファイルを生成します。作成するディレクトリのパスは任意です。

表4‒28　トラブルシュート情報として必要なOSの状態情報

情報の種類

デフォルトのファイル名

ネットワークの情報

プロトコルの統計情報と現在の TCP/IP ネットワーク接続の情報。次のコマンドで順次取得します。

netstat -e > netstat_e.txt

netstat -s > netstat_s.txt

netstat -an > netstat_an.txt

環境変数

現在設定されている環境変数。次のコマンドで取得します。

set >set.txt

(2)　UNIXの場合

OSの状態情報は，cjgetsysinfoコマンドを使用して取得できます。-fオプションを指定すると，OS状態出力ファイルに出力できます。

コマンドは，次の形式で実行します。

cjgetsysinfo -f <OS状態出力ファイルパス>

このコマンドによって，OSの次の表に示すコマンドを実行した場合と同じ情報が取得できます。

表4‒29　 cjgetsysinfoコマンドの実行によって実行されるOSのコマンド

AIXの場合

Linuxの場合

df -k

ps -elf

ps -A -m -o THREAD

vmstat -t 1 1

vmstat -s

lsps -s

netstat -i

netstat -m

netstat -an

iostat

svmon -P

svmon -G

sar -A 1

instfix -i

lslpp -hac

uname -a

env

set

ipcs -a

df

ps -eflm

vmstat

netstat -s

netstat -an

iostat※

top -b -n 1

sysctl -a

sar -A 1 1※

rpm -qa

rpm -qai

uname -a

env

set

ipcs

ipcs -t

ipcs -p

ipcs -c

ipcs -u

ipcs -l

注※　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 -an > netstat_an`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

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 -an > netstat_an`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 5 > 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

注※1

コマンドの実行にはroot権限が必要です。

注※2

sarコマンドおよびiostatコマンドを実行するためには，Linuxに含まれているsysstatパッケージをインストールする必要があります。

4.12.2　OSのログの取得

トラブルシュート情報として必要なOSのログの取得について，OSごとに説明します。

(1)　Windowsの場合

トラブルシュート情報として必要なOSのログを次に示します。

表4‒30　トラブルシュート情報として必要なOSのログ情報

情報の種類

デフォルトのファイル名

イベントログ

イベントビューアを開き，アプリケーションとシステムのログを保存します。

(2)　UNIXの場合

トラブルシュート情報として必要なOSのログ（syslog）の格納場所を次に示します。

AIXの場合

/var/adm/ras下すべて

Linuxの場合

/var/log下すべて

4.13　OSの統計情報

OSの統計情報の取得について，OSごとに説明します。

4.13.1　Windowsの場合

障害発生後のパフォーマンスログを保存しておきます。「パフォーマンス」の操作の詳細については，OS付属のマニュアルなどを参照してください。

ポイント

OSの統計情報は，あらかじめ，OS付属の「パフォーマンス」でパフォーマンスログの取得を開始している場合にだけ取得できます。

J2EEサーバ実行中に次のシステムモニタのログを60秒間隔で採取します。具体的な設定方法は，OS付属のマニュアルなどを確認してください。

表4‒31　システムモニタの設定

パフォーマンスオブジェクト

インスタンス

項目名

説明

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

実メモリ使用量（バイト）。

（凡例）　−：該当しない

4.13.2　UNIXの場合

アプリケーションサーバ起動中に次に示すコマンドを実行して，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

Linuxの場合

ps -eflm
top n 1
vmstat
sar -A 1 1※2

注※1

コマンドの実行にはroot権限が必要です。

注※2

sarコマンドを実行するためには，Linuxに含まれているsysstatパッケージをインストールする必要があります。

4.14　アプリケーションサーバの定義情報

アプリケーションサーバの定義を取得します。この情報を使用して，障害が発生したときに設定されていた定義内容を確認します。

Component Containerに関する定義情報

次のディレクトリ下に格納されているファイル一式を取得します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>

トラブルシューティング用に保存するファイルからは，パスワードなどの公開できない情報を削除することをお勧めします。

4.15　J2EEサーバまたはバッチサーバの作業ディレクトリの内容

システムでトラブルが発生した場合に，保守員による原因究明のため作業ディレクトリを調査に使用する場合があります。作業ディレクトリは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定したディレクトリです。なお，作業ディレクトリのデフォルトのディレクトリパスは「<Application Serverのインストールディレクトリ>¥CC¥server¥public」（Windowsの場合），または「/opt/Cosminexus/CC/server/public」（UNIXの場合）です。

設定を確認した上で，トラブルが発生した場合に保存しておいてください。

4.16　アプリケーションサーバのリソース設定情報

コネクションプールの設定などリソースの設定を確認するために，リソースの設定情報を取得します。設定情報の格納場所は次のとおりです。

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>¥import

<作業ディレクトリ>¥ejb¥<サーバ名称>¥rars

UNIXの場合

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

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

4.17　Webサーバログ

システムで使用しているWebサーバ（HTTP ServerまたはMicrosoft IIS）のログを取得します。

HTTP Serverの場合

ログの格納場所を次に示します。

Windowsの場合

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

UNIXの場合

/opt/hitachi/httpsd/logs（デフォルト）

Microsoft IISの場合

ログの格納場所を次に示します。

C:¥inetpub¥logs（C:の部分にはシステムドライブを指定します）

4.18　JavaVMのスタックトレース情報

UNIXでは，JavaVMが異常終了してcoreダンプが出力された場合，異常終了した原因の究明に必要な情報（スタックトレース情報）を，javatraceコマンドで取得できます。javatraceコマンドでは，出力されたcoreダンプから，スタックトレース情報を取得します。javatraceコマンドは，「/opt/Cosminexus/jdk/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/bin/javatrace core /opt/Cosminexus/CC/server/bin/cjstartsv]
#

メッセージ内に表示されるjavatraceコマンドの文字列を実行します。この例の場合は，「/opt/Cosminexus/jdk/bin/javatrace core /opt/Cosminexus/CC/server/bin/cjstartsv」を実行してください。実行結果として，カレントディレクトリに「javatrace.log」というファイルが出力されます。

なお，OSによっては実際に出力されるcoreダンプのファイル名が「core.プロセスID」になる場合があります。その場合は，実際に出力されたcoreダンプのファイル名をjavatraceの引数に指定してください。

4.19　明示管理ヒープ機能のイベントログ

明示管理ヒープ機能が出力するイベントログは，JavaVM起動オプションである-XX:HitachiExplicitMemoryJavaLogオプションで指定したファイルに出力されます。また，出力される内容は，-XX:HitachiExplicitMemoryLogLevelオプションに指定したログ出力レベルによって異なります。

これらのオプションの設定方法については，「3.3.17(3)　明示管理ヒープ機能のイベントログ取得の設定」を参照してください。

JavaVM起動オプションについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。

4.20　Component Container管理者のセットアップコマンドの実行情報（UNIXの場合）

Component Container管理者を設定している場合，Component Container管理者のセットアップ（cjenvsetupコマンド）の実行情報はメッセージログおよびテキストファイルに出力されます。過去の実行情報が存在する場合，種別ごとに4世代前まで保存され最新の実行情報を含め最大5ファイルまで保存されます。

また，上書きインストールで，上書きインストール前にComponent Container管理者のセットアップを行っていた場合は，Component Container管理者のセットアップ（cjenvsetupコマンド）は，インストール時に自動的に実行されます。

実行情報の出力先を次に示します。

表4‒32　Component Container管理者のセットアップ（cjenvsetupコマンド）の実行情報の出力先

分類

内容

ログ出力先およびログファイル名

メッセージログ

cjenvsetupコマンドの稼働ログ

/opt/Cosminexus/CC/logs/cjenvsetupmessage[n]※.log

テキストファイル

変更前ファイル（ディレクトリ）情報

/opt/Cosminexus/CC/logs/before_cjenvsetup_files[n]※.txt

テキストファイル

変更後ファイル（ディレクトリ）情報

/opt/Cosminexus/CC/logs/after_cjenvsetup_files[n]※.txt

注※　[n]には，世代数（1から4まで）が付きます。最新の実行情報には世代数は付きません。ログファイルは最大5ファイルが保存されます。

出力される内容の詳細については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.4　Component Container管理者を設定するときの注意事項（UNIXの場合）」を参照してください。

5　トラブルの分析

この章では，トラブルシューティングで使用するログやトレース情報について説明します。

5.1　この章の構成

トラブルシューティングに関する説明のうち，トラブルシューティングの資料の出力内容について説明します。

取得した資料に出力される内容を基に，トラブルの原因を判別してください。なお，「2.3　資料の取得」で取得した資料のうち，OSの統計情報については，ご使用のOS付属のマニュアルなどを参照してください。また，メモリダンプは，保守員が確認する情報なので，ここでは説明しません。

注意事項

Windowsの場合，大きいサイズのログファイル（3メガバイト以上）をテキストエディタなどで開くと，マシンに負担が掛かり，システムに影響を与えるおそれがあります。ログファイルを参照する際には，十分に注意してください。

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

ログやPRFトレースに出力する内容にUnicodeの補助文字が含まれている場合，その文字は正しく出力されません。ただし，それ以外の出力内容や，アプリケーションの動作に問題はありません。Unicodeの補助文字は，Internet Explorerなどのクライアントから送信されたリクエストに含まれることがあります。

この章の構成を次の表に示します。

表5‒1　この章の構成（トラブルシューティングで使用する資料の出力内容）

分類

タイトル

参照先

解説

アプリケーションサーバのログ

5.2

EJBクライアントアプリケーションのログの内容

5.3

性能解析トレースの内容

5.4

JavaVMのスレッドダンプの内容

5.5

JavaVMのGCログの内容

5.6

JavaVMログ（JavaVMログファイル）

5.7

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

5.8

OSの状態情報およびOSのログの内容

5.9

JavaVMスタックトレース情報の内容

5.10

明示管理ヒープ機能のイベントログの内容

5.11

なお，トラブルシューティングの概要，資料の出力先と出力方法，および資料の取得や出力に関する設定については，それぞれ次の個所を参照してください。

トラブルシューティングの概要と，資料を自動で出力する方法

「2.　トラブルシューティング」

資料の取得や出力に関する設定

「3.　トラブルシューティングのための準備」

資料のデフォルトでの出力先と，資料を個別に出力する方法

「4.　トラブルシューティングで必要な資料の出力先と出力方法」

5.2　アプリケーションサーバのログ

この節では，アプリケーションサーバのログの調査方法について説明します。

アプリケーションサーバのログのメッセージログ・ユーザログを調査することでエラーの発生原因を調べることができます。また，プロセス障害などの場合も，処理の進行具合や障害の兆候を確認できます。

アプリケーションサーバのログのうち，EJBクライアントアプリケーションのシステムログを参照する場合の留意事項については，「2.6.1　EJBクライアントアプリケーションのシステムログに関する留意事項」を参照してください。

アプリケーションサーバのログには，次の三つの種別があります。

トレース共通ライブラリ形式（シングルプロセス）

トレース共通ライブラリ形式（マルチプロセス）

独自形式

トレース共通ライブラリ形式とは，トレース共通ライブラリを使用して出力するログです。トレース共通ライブラリ形式については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「8.2.2　ユーザログ出力の仕組み」を参照してください。

独自形式は，トレース共通ライブラリ形式以外の形式で出力されるログです。

ここでは，アプリケーションサーバのログについて，種別ごとに分類して説明します。説明するアプリケーションサーバのログは次のログです。

トレース共通ライブラリ形式のログ

イベントログ

syslog

監査ログで出力するログ

CJMSプロバイダで出力するログ

なお，トレース共通ライブラリ形式のログには，時刻による出力先の切り替えおよびシフトモードでのファイル名付与が有効になるものがあります。詳細は，「3.2.1　設定できる内容」を参照してください。

出力されるログと対応するログの種別，ならびに時刻指定切り替えおよびシフトモードに対応しているかどうかを，ログの取得対象ごとに示します。

表5‒2　 J2EEサーバのログ種別

分類

内容

種別

時刻指定切り替えおよびシフトモードへの対応

メッセージログ

稼働ログ

トレース共通ライブラリ形式（シングルプロセス）

○

ログ稼働ログ

独自形式

−

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの稼働ログ

トレース共通ライブラリ形式（シングルプロセス）

○

J2EEアプリケーションに含めて使用するリソースアダプタの稼働ログ

トレース共通ライブラリ形式（シングルプロセス）

○

Webサーブレットログ

トレース共通ライブラリ形式（シングルプロセス）

○

ユーザログ

ユーザ出力ログ

トレース共通ライブラリ形式（シングルプロセス）

○

ユーザエラーログ

トレース共通ライブラリ形式（シングルプロセス）

○

JavaVMの保守情報およびGCのログ

独自形式

−

明示管理ヒープ機能のイベントログ

独自形式

−

例外ログ

障害発生時の例外情報

トレース共通ライブラリ形式（シングルプロセス）

○

保守用ログ

保守情報

トレース共通ライブラリ形式（シングルプロセス）

○

コンソールメッセージ

トレース共通ライブラリ形式（シングルプロセス）

○

EJBコンテナの保守情報

トレース共通ライブラリ形式（シングルプロセス）

○

Webコンテナの保守情報

トレース共通ライブラリ形式（シングルプロセス）

○

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

独自形式

−

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

独自形式

−

終了プロセス情報

トレース共通ライブラリ形式（シングルプロセス）

−

イベントログ

J2EEサーバの起動，停止または異常終了を示すログ

トレース共通ライブラリ形式（シングルプロセス）

−

syslog

J2EEサーバの起動，停止または異常終了を示すログ

トレース共通ライブラリ形式（シングルプロセス）

−

アクセスログ

HTTP通信の処理結果およびWebSocket通信の処理結果

アクセスログ形式

○

（凡例）○：対応している　−：対応していない，または該当しない

表5‒3　サーバ管理コマンドのログ

分類

内容

種別

時刻指定切り替えおよびシフトモードへの対応

メッセージログ

稼働ログ

トレース共通ライブラリ形式（マルチプロセス）

−

ログ稼働ログ

独自形式

−

例外ログ

障害発生時の例外情報

トレース共通ライブラリ形式（マルチプロセス）

−

保守用ログ

保守情報

トレース共通ライブラリ形式（マルチプロセス）

−

コンソールメッセージ

トレース共通ライブラリ形式（マルチプロセス）

−

サーバ管理コマンドの保守情報

トレース共通ライブラリ形式（マルチプロセス）

−

（凡例）−：対応していない，または該当しない

表5‒4　リソースアダプタバージョンアップコマンド（cjrarupdate）のログ

分類

内容

種別

時刻指定切り替えおよびシフトモードへの対応

メッセージログ

稼働ログ

トレース共通ライブラリ形式（マルチプロセス）

−

例外ログ

障害発生時の例外情報

トレース共通ライブラリ形式（マルチプロセス）

−

保守用ログ

保守情報

トレース共通ライブラリ形式（マルチプロセス）

−

（凡例）−：対応していない，または該当しない

表5‒5　移行コマンド（cjenvupdate）のログ

分類

内容

種別

時刻指定切り替えおよびシフトモードへの対応

メッセージログ

cjenvupdateコマンドの稼働ログ

トレース共通ライブラリ形式（マルチプロセス）

−

例外ログ

cjenvupdateコマンドの例外情報

トレース共通ライブラリ形式（マルチプロセス）

−

保守用ログ

cjenvupdateコマンドの保守情報

トレース共通ライブラリ形式（マルチプロセス）

−

（凡例）−：対応していない，または該当しない

表5‒6　リソース枯渇監視のログ

監視対象

リソース

種別

時刻指定切り替えおよびシフトモードへの対応

メモリ

トレース共通ライブラリ形式（シングルプロセス）

○

ファイルディスクリプタ

トレース共通ライブラリ形式（シングルプロセス）

○

スレッド

トレース共通ライブラリ形式（シングルプロセス）

○

スレッドダンプ

トレース共通ライブラリ形式（シングルプロセス）

○

HTTPリクエスト実行待ちキュー

トレース共通ライブラリ形式（シングルプロセス）

○

HTTPセッション数

トレース共通ライブラリ形式（シングルプロセス）

○

コネクションプール

トレース共通ライブラリ形式（シングルプロセス）

○

（凡例）○：対応している

表5‒7　運用管理エージェント・運用監視エージェント・Management Serverのログ

分類

内容

種別

時刻指定切り替えおよびシフトモードへの対応

統合ログ

統合メッセージログ

トレース共通ライブラリ形式（マルチプロセス）

○

統合トレースログ

トレース共通ライブラリ形式（マルチプロセス）

○

コマンド保守ログ

トレース共通ライブラリ形式（マルチプロセス）

−

運用管理エージェント

運用管理エージェントの標準エラー出力

トレース共通ライブラリ形式（シングルプロセス）

−

運用管理エージェントの標準出力

トレース共通ライブラリ形式（シングルプロセス）

−

運用管理エージェントの標準エラー出力コマンドライン

独自形式

−

運用管理エージェントのログ

トレース共通ライブラリ形式（シングルプロセス）

−

運用管理エージェントの起動・停止コマンドのログ

トレース共通ライブラリ形式（シングルプロセス）

−

運用管理エージェントの保守ログ

トレース共通ライブラリ形式（シングルプロセス）

−

コンソールログ

トレース共通ライブラリ形式（シングルプロセス）

○

運用管理エージェントサービスのログ

トレース共通ライブラリ形式（シングルプロセス）

−

運用管理エージェントサービスの標準出力

独自形式

−

運用管理エージェントサービスの標準エラー出力

独自形式

−

運用監視エージェント

運用監視エージェントのログ・トレース

J2EEサーバ用システムJP1イベントおよびJ2EEサーバ用ユーザJP1イベントのログ

Managementイベント発行ログ

トレース共通ライブラリ形式（シングルプロセス）

−

Management Server

Management Serverサービスのログ

トレース共通ライブラリ形式（シングルプロセス）

−

Management Serverサービスの標準エラー出力

独自形式

−

Management Serverサービスの標準出力

独自形式

−

Management Serverサービス起動・停止コマンド

トレース共通ライブラリ形式（シングルプロセス）

−

Management Serverのログ

運用管理サーバ※のシステムJP1イベントのログ

トレース共通ライブラリ形式（シングルプロセス）

−

mngenvsetupコマンドの実行ログ

トレース共通ライブラリ形式（シングルプロセス）

−

Management Serverの保守ログ

トレース共通ライブラリ形式（シングルプロセス）

−

（凡例）○：対応している　−：対応していない，または該当しない

注※　アプリケーションサーバの運用管理サーバのことです。

表5‒8　仮想サーバマネージャの内部構築ツールおよびサーバ通信エージェントのログ

分類

内容

種別

時刻指定切り替えおよびシフトモードへの対応

仮想サーバマネージャの内部構築ツール

仮想サーバマネージャの内部構築ツールのログ

トレース共通ライブラリ形式（シングルプロセス）

○

仮想サーバマネージャの内部構築ツールの保守ログ

トレース共通ライブラリ形式（シングルプロセス）

−

サーバ通信エージェント

サーバ通信エージェントのログ

トレース共通ライブラリ形式（シングルプロセス）

○

サーバ通信エージェントサービスのログ

トレース共通ライブラリ形式（シングルプロセス）

−

サーバ通信エージェントの起動・停止コマンドのログ

トレース共通ライブラリ形式（シングルプロセス）

−

サーバ通信エージェントの標準エラー出力

トレース共通ライブラリ形式（シングルプロセス）

−

サーバ通信エージェントの標準出力

トレース共通ライブラリ形式（シングルプロセス）

−

コンソールログ

トレース共通ライブラリ形式（シングルプロセス）

○

サーバ通信エージェントの保守ログ

トレース共通ライブラリ形式（シングルプロセス）

−

サーバ通信エージェントサービスの保守ログ

トレース共通ライブラリ形式（シングルプロセス）

−

サーバ通信エージェントの起動・停止コマンドの保守ログ

トレース共通ライブラリ形式（シングルプロセス）

−

サーバ通信エージェントのJavaVMログファイル

トレース共通ライブラリ形式（シングルプロセス）

−

（凡例）○：対応している　−：対応していない，または該当しない

表5‒9　Performance Tracerのログ

内容

種別

PRFデーモンおよびPRFコマンドのログ

独自形式

モジュールトレース

独自形式

構造化例外発生ログ

独自形式

保守情報

独自形式

表5‒10　Component Transaction Monitorのログ

内容

種別

CTMデーモンおよびCTMコマンドのログ

独自形式

保守情報

独自形式

表5‒11　監査ログで出力するログ

分類

内容

種別

時刻指定切り替えおよびシフトモードへの対応

メッセージログ

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

トレース共通ライブラリ形式（マルチプロセス）

−

例外ログ

監査ログの例外情報

トレース共通ライブラリ形式（マルチプロセス）

−

（凡例）−：対応していない，または該当しない

表5‒12　CJMSプロバイダで出力するログ

分類

内容

種別

時刻指定切り替えおよびシフトモードへの対応

メッセージログ

CJMSPブローカーのメッセージログ

トレース共通ライブラリ形式（シングルプロセス）

−

管理コマンド（cjmsicmdコマンド）のメッセージログ

トレース共通ライブラリ形式（マルチプロセス）

−

CJMSPリソースアダプタのメッセージログ

トレース共通ライブラリ形式（シングルプロセス）

○

例外ログ

CJMSPブローカーの例外ログ

トレース共通ライブラリ形式（シングルプロセス）

−

管理コマンド（cjmsicmdコマンド）の例外ログ

トレース共通ライブラリ形式（マルチプロセス）

−

CJMSPリソースアダプタの例外ログ

トレース共通ライブラリ形式（シングルプロセス）

○

（凡例）○：対応している　−：対応していない，または該当しない

5.2.1　トレース共通ライブラリ形式のログの出力形式と出力項目

トレース共通ライブラリ形式のログの出力形式と出力項目について説明します。

アプリケーションサーバのログは，トレース共通ライブラリ形式で出力されます。

(1)　出力形式

トレース共通ライブラリ形式のログの出力形式を次に示します。

番号　日付　時刻　AP名　pid tid メッセージID　種別　メッセージテキスト　CRLF

(2)　出力項目

トレース共通ライブラリ形式のログの出力項目を次に示します。

表5‒13　トレース共通ライブラリ形式のログの出力項目

項目名

説明

番号

トレースレコードの通番を示す4けたの番号が出力されます。

日付

トレースの取得日付が「yyyy/mm/dd」の形式で出力されます。

時刻

トレースの取得時刻が「hh:mm:ss.sss」の形式で出力されます。

AP名

プログラムを示す文字列が出力されます。

pid

プロセスIDが出力されます。

tid

スレッドIDが出力されます。

メッセージID

メッセージIDが「XXXXnnnnn-Y」の形式で出力されます。

種別

トレース出力の契機となったイベント種別が出力されます。

メッセージテキスト

メッセージテキストが出力されます（最大4,095バイト）。4,095バイトを超える場合は切り捨てられます。また，付加情報が出力されることもあります。

CRLF

レコードの終端符号（0x0D，0x0A）が出力されます。

ログファイルの編集表示について

トレース共通ライブラリ形式のログをMicrosoft Excelで表示して，フィルタリングや並べ替えの機能を利用すると，トラブルの発生要因の調査を効率良く進められるようになります。

Microsoft Excelを利用したトレース共通ライブラリ形式のログの表示例を次に示します。

図5‒1　Microsoft Excelを利用したトレース共通ライブラリ形式のログの表示例

参考

区切るデータの形式として，「スペースによって右または左にそろえられた固定長フィールドデータ」を選択してください。

［データのプレビュー］ボックスで不要な矢印を削除してください。

各列の［表示形式］に［文字列］を指定してください。

5.2.2　トレース共通ライブラリ形式のログを参照する場合の注意

トレース共通ライブラリ形式のログを使用する場合の注意事項について説明します。

(1)　マルチプロセス・シングルプロセス共通の注意事項

マルチプロセス・シングルプロセス共通の注意事項について説明します。

出力されたログファイルを編集しないでください。

テキストエディタの機能などを使用して，ファイルロックをしないでください。

出力されたログファイルにアクセス権限を手動で設定する場合は，適切なアクセス権を与えてください。

出力されたログファイルの更新時刻を変更しないでください。

トレース出力中に，ログファイルを削除したり，ファイル名を変更したりしないでください。ログファイルの削除，またはファイル名の変更は，すべてのトレース出力プロセスを停止してから実行してください。

ログファイルとともに，管理ファイル「xxxxxx.conf」が出力されます。トレース出力プロセスの稼働中，このファイルを変更，削除しないでください。

ログファイルのサイズ，面数などの設定変更は，トレース出力プロセスを停止してから実施してください。その際，ログ出力ディレクトリ配下(サブディレクトリ含む)のすべてのログファイルと管理ファイル「xxxxxx.conf」を，退避または削除してください。

ログファイルの所有者や所有グループを変更する場合は，管理ファイル「xxxxxx.conf」も同じ所有者および所有グループに変更してください。

(2)　マルチプロセスのトレース共通ライブラリ参照時の注意事項

マルチプロセスに対応したトレース共通ライブラリ形式のログファイルを参照する場合の注意事項を次に示します。

メッセージ末尾の改行コードは，使用しているOSに関係なくCRLFです。

ログファイルのファイルサイズ，面数，およびモードオプションの変更を有効にするために，ログファイルを削除する必要がある場合があります。ログファイルの削除は，すべてのトレース出力プロセスを停止してから実行してください。

トレースが出力されても，ログファイルの更新時刻が更新されない場合があります。そのため，ファイルの更新時刻を基にトレースが出力されたかどうかを判断することはできません。

(3)　マルチプロセスに対応したトレース共通ライブラリの旧バージョンからの変更点

マルチプロセスに対応したトレース共通ライブラリのログファイルを旧バージョンから変更しています。変更点を次に示します。

表5‒14　マルチプロセスに対応したトレース共通ライブラリの旧バージョンとの差異

項目

アプリケーションサーバ V9

アプリケーションサーバ V9より前

ファイルサイズ

可変（指定サイズを超える場合があります）

固定（指定サイズ）

ファイル切り替えのタイミング

切り替えのタイミングを次に示します。

ファイルサイズが指定サイズを超えた場合

時刻指定ローテーションの場合

プロセス起動中に指定した時刻に達した場合

ファイルサイズ＋出力しようとしているサイズが指定サイズを超えた場合

ファイル切り替え時のサイズ

0（全行削除します）

固定（上書き保存）

ファイル切り替え動作（ラップアラウンド方式）

ファイルの先頭からトレースデータを上書き出力（ラップアラウンド前の情報はそのまま残ります）

ファイルの先頭からトレースデータを上書き出力（ラップアラウンド前の情報はそのまま残ります）

ファイル切り替え動作（シフト方式）

全行削除し，ファイルの先頭からトレースデータを出力

−

ログファイル名通番規則（ラップアラウンド方式）

xxxxxx1.log，

xxxxxx2.log，

xxxxxx3.log，

…

xxxxxx1.log，

xxxxxx2.log，

xxxxxx3.log，

…

ログファイル名通番規則（シフト方式）

xxxxxx.log，

xxxxxx1.log，

xxxxxx2.log，

…

−

終端識別子

なし（ファイルの終端）

あり※

管理ファイル

作成する

作成する

プロセス再起動時の出力ファイル判定

タイムスタンプ

管理ファイル，またはタイムスタンプ

（凡例）

−：該当なし。

注※

旧バージョンのマルチプロセスに対応したトレース共通ライブラリでの終端識別子を次に示します。

EOF CRLF CRLF CRLF CRLF----------< End of Data >----------CRLF CRLF

EOFはトレースデータの終端を表す文字（0x1A）です。CRLFは，改行（0x0D，0x0A）を表します。

表5‒15　マルチプロセスに対応したトレース共通ライブラリ形式の変更ファイル一覧

ログ分類

ログ種別

ログファイルと標準のファイル出力先

共通ログ

監査ログ

<製品のインストールディレクトリ>/auditlog/audit?.log

<製品のインストールディレクトリ>/auditlog/rasexception?.log

<製品のインストールディレクトリ>/auditlog/rasmessage?.log

機能固有の公開ログ

性能，障害解析トレース

<製品の作業ディレクトリ>/ejb/<J2EEサーバ名称>/logs/RM/maintenance/mtd_<RMの表示名>_??.log

<製品の作業ディレクトリ>/ejb/<J2EEサーバ名称>/logs/RM/maintenance/shq_<RMの表示名>_??.log

<製品の作業ディレクトリ>/ejb/<J2EEサーバ名称>/logs/RM/maintenance/lin_<RMの表示名>_??.log

<製品のインストールディレクトリ>/CC/server/public/ejb/<J2EEサーバ名称>csmxsec_trace?.log

メッセージログ

<製品の作業ディレクトリ>/ejb/<J2EEサーバ名称>/logs/CJW/cjwmessage?.log

<製品の作業ディレクトリ>/ejb/<J2EEサーバ名称>/logs/CJR/cjrmessage?.log

<製品の作業ディレクトリ>/ejb/<J2EEサーバ名称>/logs/WS/ <log_file_prefix>-j2ee-<J2EEサーバのサーバ名>-<log_file_num>.log

<製品の作業ディレクトリ>/ejb/<J2EEサーバ名称>/logs/WS/ c4webcl-default-?.log

Managerのログ

統合メッセージログ

<製品のインストールディレクトリ>/manager/log/message/mngmessage?.log

統合トレースログ

<製品のインストールディレクトリ>/manager/log/trace/mngtrace?.log

コンソールログ

<製品のインストールディレクトリ>/manager/log/processConsole?.log

仮想化機能の内部構築ツールのログ

<製品のインストールディレクトリ>/manager/setup/log/rasetup?.log

サーバ通信エージェントのログ

<製品のインストールディレクトリ>/sinagent/log/sinaviagent?.log

サーバ通信エージェントのコンソールログ

<製品のインストールディレクトリ>/sinagent/log /processConsole?.log

5.2.3　NIO HTTPサーバのアクセスログの出力形式と出力項目

NIO HTTPサーバのアクセスログの出力形式と出力項目について説明します。

アクセスログには，NIO HTTPサーバのリクエストの処理結果が出力されます。NIO HTTPサーバで扱う，HTTP通信とWebSocket通信に分けて，それぞれの出力形式と出力項目について説明します。

(1)　HTTP通信のアクセスログ

出力内容を次の表に示します。

表5‒16　HTTP通信の出力内容

フォーマット引数

出力内容

出力例

%a

WebクライアントのIPアドレス。

10.20.30.40

%A

J2EEサーバのIPアドレス。

10.20.30.100

%b

レスポンスボディの送信バイト数。

0バイトのときは「-」になる。

2048

%B

レスポンスボディの送信バイト数。

0バイトのときは「0」になる。

1024

%h

Webクライアントのホスト名またはIPアドレス。

ホスト名が得られない場合はIPアドレスになる。

10.20.30.40

%H

リクエストプロトコル。

HTTP/1.1

%l

リモートログ名。

常に「-」になる※1。

-

%m

リクエストメソッド

GET

%p

Webクライアントからのリクエストを受け付けたポート番号。

80

%q

クエリ文字列。

「?」から始まる。

クエリ文字列がない場合は空文字になる。

?id=100&page=15

%r

リクエストライン。

GET /index.html HTTP/1.0

%s

最終ステータスコード。

200

%S※2

クッキー名JSESSIONIDの値を出力する。

クッキー名JSESSIONIDの値がない場合は「-」になる。

00455AFE4DA4E7B7789F247B8FE5D605

%t

Webクライアントのリクエスト処理を開始した時刻を秒精度で表示。

[dd/MMM/YYYY:HH:mm:ss Z]

[18/Jan/2005:13:06:10 +0900]

%T

Webクライアントのリクエストの処理に要した時間（秒単位）。

2

%d

Webクライアントのリクエスト処理を開始した時刻をミリ秒精度で表示。

[dd/MMM/YYYY:HH:mm:ss.nnn Z]（nnnはミリ秒）

[18/Jan/2005:13:06:10.152 +0900]

%D

Webクライアントのリクエストの処理に要した時間（ミリ秒単位）。

38

%u

ベーシック認証ユーザ名，フォーム認証ユーザ名。

認証ユーザ名がない場合は「-」になる。

user

%U

リクエストファイルパス。

/index.html

%v

J2EEサーバのローカルホスト名。

server

%{foo}i※3

リクエストヘッダfooの内容。

fooヘッダが存在しない場合は「-」になる。

%{Host}iの場合

www.example.com:8888

%{foo}c

Webクライアントが送信したCookie情報でCookieの名前がfooの内容を表示する。

Cookieの名前にfooがない場合は「-」になる。

%{MYSESSIONID}cの場合

00455AFE4DA4E7B7789F247B8FE5D605

%{foo}o※3

レスポンスヘッダfooの内容。

fooヘッダが存在しない場合は「-」になる。

%{Server}oの場合

CosminexusComponentContainer

%rootap

ルートアプリケーション情報。

10.100.10.100/1234/0x0000000000000001

%clport

Webクライアントからのリクエストを送信したポート番号。

888

注

上記の表以外の%から始まる文字（%Gなど）を指定した場合は，メッセージKDJE39401-Wを出力し，デフォルトフォーマットを使用します。また，%{foo}i，%{foo}c，%{foo}oで指定するヘッダの内容，またはCookie名で0文字（%{}iなど）を指定した場合は，メッセージKDJE39401-Wを出力し，デフォルトフォーマットを使用します。

フォーマット形式に使用できる文字列長は1024文字までです。1024文字を超えた場合は，メッセージKDJE39400-Wを出力しデフォルト値を使用します。

フォーマット形式に使用できる文字は，ASCIIコードの32（10進数）から127（10進数）未満の文字です。

文字列が何も指定されていない場合は，メッセージKDJE39009-Wを出力し，デフォルト値を使用します。

範囲外の文字を指定した場合は，メッセージKDJE39401-Wを出力しデフォルト値を使用します。

注※1

リモートログ名は，RFC1413で規定されているIdentificationプロトコルによって得られるWebクライアント側のユーザ名です。

注※2

%Sで表示される値は，標準でHTTPセッションIDとして使用するクッキー名JSESSIONIDの値です。Servlet3.0以降でクッキー名JSESSIONIDの名前を変更した場合は，%{foo}cを使用します。

注※3

一度のHTTPリクエストまたはHTTPレスポンスで同じヘッダ名を複数回送信する場合があります。この場合，すべてのヘッダの内容を「，」（コンマ）区切りで出力します。

フォーマット引数で記述した表記を次に示します。

%h %{X-Forwarded-For}i %l %u %d %rootap "%r" %s %b %D %S

出力形式を次に示します。

Webクライアントのホスト名またはIPアドレス△X-Forwarded-Forヘッダ△リモートログ名△認証ユーザ名△Webクライアントのリクエスト処理を開始した時刻△ルートアプリケーション情報△”リクエストライン”△最終ステータスコード△HTTPヘッダを除く送信バイト数△Webクライアントのリクエストの処理に要した時間△HTTPセッションID

注

HTTPセッションIDのあとに改行されます。

（凡例）

△：半角スペース

出力例を次に示します。

10.20.30.40 50.60.70.80 - user [18/Jan/2005:13:06:10.152 +0900] 10.100.10.100/1234/0x0000000000000001 "GET /index.html HTTP/1.0" 200 1024 38 00455AFE4DA4E7B7789F247B8FE5D605

(2)　WebSocket通信のアクセスログ

出力内容を次の表に示します。

表5‒17　WebSocket通信の出力内容

フォーマット引数

出力内容

出力例

%TS

WebSocketフレームの送受信時刻。

2001/01/01 01:01:01.111 +0900

%IO

WebSocketフレームの送受信方向。INまたはOUTが出力される。

IN：

サーバインスタンスがWebSocketフレームを受信したことを示す。

OUT：

サーバインスタンスがWebSocketフレームを送信したことを示す。

IN

%OPCODE

WebSocketフレームの種別。Text，Binary，Ping，Pong，またはCloseが出力される。

Text

%URI

リクエストURI。

/websocket_server/test001

%FIN

WebSocketフレームの終端を示す識別子。CONTまたはFINALが出力される。

CONT：

WebSocketフレームの継続。

FINAL：

WebSocketフレームの終端。

CONT

%PAYLOADDATALEN

ペイロードデータ長。

100

%ROOTAP

ルートアプリケーション情報。

10.100.10.100/1234/0x0000000000000001

%CLIENTAP

クライアントアプリケーション情報。

10.100.10.100/1234/0x0000000000000001

%CLOSEREASON

WebSocketコネクションが切断された理由。

NORMAL_CLOSURE:closereason specified by WebSocketClient001

%CLIENTADDR

WebクライアントのIPアドレスとポート番号。

10.20.30.40:55555

%SERVERADDR

J2EEサーバのIPアドレスとポート番号。

10.20.30.100:44444

%SESSIONID

WebSocketセッションID。

11111111-2222-3333-4444-555555555555

%MASK

WebSocketフレームの情報に設定されたMASKを表す。

MASK：

MASKされている。

NOMASK：

MASKされていない。

MASK

%MASKKEY

WebSocketフレームの情報をMASKするためのキー。

MASKしない場合は「-」になる。

EEEEEEEE

%ISEXTENDED

エンドポイントがメッセージの送受信に設定されたフレームを表す。

BASE：

基本フレームを使用している。

EXTENDED：

拡張フレームを使用している。

BASE

%RSV

拡張のネゴシエーション中にクライアントエンドポイントによって設定された予約ビットを表す。

RSV-000

%FRAMEMAINTYPE

WebSocketフレームがデータフレームかコントロールフレームかを指定する。

Data：

データフレームを使用する。

Control：

コントロールフレームを使用する。

Data

%PAYLOADDATA

ペイロードデータ。

aaaaaa

%PAYLOADDATA(n)

メッセージの最初と最後を示す一定数の文字だけを表示する場合のペイロードデータ。

バイナリの場合は常に「-」になる。

aaaaaaaaaa....aaaaaaaaaa

注

フォーマット形式に使用できる文字列長は1024文字までです。1024文字を超えた場合は，メッセージKDJE39400-Wを出力しデフォルト値を使用します。

文字列が何も指定されていない場合は，メッセージKDJE39009-Wを出力し，デフォルト値を使用します。

表内で定義されているフォーマット引数を半角スペースでつなげたものだけ指定できます。その際，次の点に注意してください。

・半角スペースの個数は保持されません。

・先頭，末尾のスペースは保持されません。

・フォーマット引数の順序に制限はありません。

・出現回数（同じものを複数回使用するなど）に制限があり，同じフォーマット引数を繰り返し定義した場合，初めに定義したフォーマット引数だけが有効になります。二つ目以降で定義したフォーマット引数は有効になりません。

フォーマット引数で記述した表記を次に示します。

%TS %IO %OPCODE %ROOTAP %URI %FIN %PAYLOADDATALEN %CLIENTAP %CLOSEREASON

出力形式を次に示します。

WebSocketフレームの送受信時刻△WebSocketフレームの送受信方向△WebSocketフレームの種別△ルートアプリケーション情報△リクエストURI△WebSocketフレームの終端を示す識別子△ペイロードデータ長△クライアントアプリケーション情報△WebSocketコネクションが切断された理由

注

ペイロードデータ長のあとに改行されます。

（凡例）

△：半角スペース

出力例を次に示します。

2001/01/01 01:01:01.111 +0900 IN Text10.100.10.100/1234/0x0000000000000001  /websocket_server/test001 CONT 100 10.100.10.100/1234/0x0000000000000003 -

5.2.4　イベントログの出力形式と出力項目（Windowsの場合）

イベントログの出力形式と出力項目について説明します。

イベントログは，J2EEサーバの起動，停止および異常終了時に出力されるログです。出力形式は次のとおりです。

ID文字列　[pid]:　メッセージテキスト

出力項目を次に示します。

表5‒18　イベントログの出力項目

項目名

説明

ID文字列

アプリケーションを示す文字列として，「HEJB」が出力されます。

pid

プロセスIDが出力されます。

メッセージテキスト

メッセージテキストが出力されます。

5.2.5　syslogの出力形式と出力項目（UNIXの場合）

syslogの出力形式と出力項目について説明します。

syslogは，J2EEサーバの起動，停止および異常終了時に出力されるログです。出力形式は次のとおりです。

日付　時刻　ホスト名　ID文字列　[pid]:メッセージテキスト

出力項目を次に示します。

表5‒19　syslogの出力項目

項目名

説明

日付

メッセージを出力した日付です。

時刻

メッセージを出力した時刻です。

ホスト名

ホスト名を示す文字列が出力されます。

pid

プロセスIDが出力されます。

ID文字列

アプリケーションを示す文字列として，「HEJB」が出力されます。

メッセージテキスト

メッセージテキストが出力されます。

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

ここでは，EJBクライアントアプリケーションのログの種別について説明します。ログの種別の詳細，それぞれのログの出力形式と出力項目，および参照する場合の注意事項については，「5.2　アプリケーションサーバのログ」を参照してください。

EJBクライアントアプリケーションのログの種別を次に示します。

表5‒20　EJBクライアントアプリケーションのログの種別

種類

内容

種別

メッセージログ

稼働ログ

トレース共通ライブラリ形式（マルチプロセス）

cjclstartapコマンドの稼働ログ

トレース共通ライブラリ形式（マルチプロセス）

cjcldellogコマンドの稼働ログ

トレース共通ライブラリ形式（マルチプロセス）

ユーザログ

ユーザ出力ログ

トレース共通ライブラリ形式（マルチプロセス）

ユーザエラーログ

トレース共通ライブラリ形式（マルチプロセス）

Javaログ

JavaVMの保守情報，GCのログ

独自形式

例外ログ

障害発生時の例外情報

トレース共通ライブラリ形式（マルチプロセス）

なお，EJBクライアントアプリケーションのログは，ファイルサイズごとに出力先を切り替えるラップアラウンドモードだけに対応しています。

5.4　性能解析トレース

性能解析トレースを調査することで，リクエストごとに処理進ちょくやボトルネックになっている処理を解析できます。また，セッショントレースを調査すると，セッションのライフサイクルが確認できます。

これらを基にして，トラブルが発生した個所を特定したり，ボトルネックになっている個所に適切に対処したりできます。必要に応じて確認してください。

性能解析トレースの出力内容については，「7.　性能解析トレースを使用した性能解析」を参照してください。

5.5　JavaVMのスレッドダンプ

JavaVMのスレッドダンプを調査すると，システムのデッドロックなどのjavaプログラムレベルでのトラブル要因の調査が容易になります。

出力される情報の種類は，J2EEサーバの起動時に指定しているオプションによって異なります。JavaVMの資料取得の設定については，「3.3.17　JavaVMの資料取得の設定」を参照してください。

5.5.1　スレッドダンプ情報の構成

JavaVMのスレッドダンプ情報の構成を次の表に示します。

表5‒21　スレッドダンプ情報の構成

出力情報

内容

ヘッダ

日付，JavaVMバージョン情報，起動コマンドラインを出力します。

システム設定

次の情報を出力します。

JDKの実行環境のインストール場所を表すJavaホームパス

JDKを構成するライブラリのインストールディレクトリを表すJava DLLパス

システムクラスパス

Javaコマンドオプション

動作環境

次の情報を出力します。

ホスト名

OSバージョン

CPU情報

リソース情報（UNIXの場合）

メモリ情報（Windowsの場合）

現在のメモリ使用量および各未使用サイズ情報を出力します。

Javaヒープ情報

Javaヒープの各世代のメモリ使用状況を出力します。

JavaVM内部メモリマップ情報

JavaVM自身の確保しているメモリの領域情報を出力します。

JavaVM内部メモリサイズ情報

JavaVM自身の確保しているメモリのサイズ情報を出力します。

アプリケーション環境

次の情報を出力します。

シグナルハンドラ

環境変数

ライブラリ情報

ローディングされているライブラリの情報を出力します。

スレッド情報

<スレッド1>

:

<スレッドn>

スレッドごとにスレッド情報を出力します。

Javaモニタダンプ※

Javaモニタオブジェクトの一覧を表示します。

JNIグローバル参照情報

JavaVMが保持しているJNIのグローバル参照の数を出力します。

Explicitヒープ詳細情報

明示管理ヒープ機能使用時には，Javaプロセスのクラスごとに次の情報を出力します。

Explicitヒープ全体の利用状況

Explicitメモリブロックごとの利用状況

また，明示管理ヒープ機能使用時に，eheapprofコマンドを実行すると，Explicitメモリブロック内のオブジェクトの統計情報，およびExplicitメモリブロックの解放率情報を出力します。

クラス別統計情報

jheapprofコマンドで指定したJavaプロセスのクラスごとに次の情報を出力します。

インスタンスがメンバとして持つインスタンスの合計サイズ，およびインスタンスの参照関係

staticメンバが持つインスタンスの合計サイズ

Tenured領域の増加原因となるオブジェクトのクラス，およびインスタンスの合計サイズ

フッタ

スレッドダンプが終了した時刻を表示します。

注※　UNIXの場合，notify待ちの一覧が表示されないことがあります。

JavaVMのスレッドダンプ情報の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]HitachiThreadDump（拡張スレッドダンプ情報出力オプション）」を参照してください。なお，クラス別統計情報については，「9.3　クラス別統計機能」を参照してください。Explicitヒープ詳細情報については，「5.5.3　Explicitヒープ詳細情報の出力内容」を参照してください。

5.5.2　スレッドダンプと性能解析トレースファイルとの対応

J2EEアプリケーションやバッチアプリケーションでスローダウンやハングアップが発生した時に，スレッドダンプと性能解析トレースを対応づけることで，問題が発生した個所を調査できます。

スレッドダンプと性能解析トレースファイルの対応づけには，スレッドダンプに出力されたスレッド情報のnativeID（OSレベルのスレッドID）と性能解析トレースファイルに出力されたスレッドIDを使用します。スレッドダンプから対応する性能解析トレースファイルを特定する手順について説明します。

スレッドダンプ，および性能解析トレースファイルを収集します。

スレッドダンプの収集方法については，「4.7　JavaVMのスレッドダンプ」を参照してください。性能解析トレースファイルの収集方法については，「7.3.1　性能解析トレースファイルの収集方法」を参照してください。

使用するスレッドダンプ，および性能解析トレースファイルを選びます。

スレッドダンプと性能解析トレースファイルが出力された時刻を基に，調査に使用するスレッドダンプ，および性能解析トレースファイルを選びます。出力された時刻は，次の情報を参考にしてください。

スレッドダンプ

ファイル名，およびファイルの末尾に出力される時刻

ファイルの末尾に出力される時刻の例を次に示します。

　：
　：
Full thread dump completed.   Fri Jul 21 19:22:47 2006

性能解析トレースファイル

「Time」および「Time(msec/usec/nsec)」

性能解析トレースファイルの「Time」および「Time(msec/usec/nsec)」の例を次の図に示します。

スレッドダンプの「nid」（16進数）または「jid」（16進数）を10進数に変換します。

Windows，AIXの場合

スレッドダンプの「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進数）

Linuxの場合

スレッドダンプの「jid」（16進数）を10進数に変換します。

　：
　：
"main" prio=1 jid=0x00006d75 tid=0x00201d70 nid=0x1e51 waiting on condition [0x00000000..0xbfe80488]  stack=[0xbfe87000..0xbfc8c000..0xbfc88000..0xbfc87000]   [user cpu time=1320ms, kernel cpu time=4280ms] [blocked count=5, waited count=4]
　：
　：

6d75（16進数）＝28021（10進数）

性能解析トレースファイルの「Thread（hashcode）」の値（10進数）が手順3.で10進数に変換した値と一致する行を探して，トレース情報を特定します。

Windows，AIXの場合

Thread（スレッドID）の値が，10進数に変換した値と一致する行を探します。

Linuxの場合

hashcode（ハッシュコード）の値が，10進数に変換した値と一致する行を探します。

5.5.3　Explicitヒープ詳細情報の出力内容

Explicitヒープ詳細情報には，Explicitヒープ情報およびExplicitメモリブロック情報が出力されます。Explicitメモリブロック情報は，Explicitメモリブロックが一つ以上ある場合に，その個数分出力されます。Explicitメモリブロック情報には，Explicitメモリブロック内のオブジェクト統計情報，およびExplicitメモリブロックの解放率情報も出力されます。

Explicitヒープ詳細情報の出力形式，出力項目および出力例を次に示します。

出力形式

eheapprofコマンドを実行しているかどうかによって出力形式が異なります。

eheapprofコマンドを実行している場合

Explicit Heap Status
--------------------
 max <EH_MAX>, total <EH_TOTAL>, used <EH_USED>, garbage <EH_GARB> (<EH_PER1> used/max, <EH_PER2> ¥
used/total, <EH_PER3> garbage/used), <EM_NUMS> spaces exist

 Explicit Memories(<EM_MGR_PTR>)
...
  "<EM_NAME>" eid=<EID>(<EM_PTR>)/<EM_TYPE>, total <EM_TOTAL>, used <EM_USED>, garbage <EM_GARB> ¥
(<EM_PER1> used/total, <EM_PER2> garbage/used, <FL_BLOCKS> blocks) <EM_STAT>
    deployed objects
    ________________Size__Instances__FreeRatio__Class________________
                 <ISIZE>     <INUM>   <FRATIO> <CNAME>
                 ...
                <AISIZE>    <AINUM> total
...

注　出力形式で使用している記号については，「5.11.2(3)　イベントログの出力形式の説明で使用する記号」を参照してください。

eheapprofコマンドを実行していない場合

Explicit Heap Status
--------------------
 max <EH_MAX>, total <EH_TOTAL>, used <EH_USED>, garbage <EH_GARB> (<EH_PER1> used/max, <EH_PER2> ¥
used/total, <EH_PER3> garbage/used), <EM_NUMS> spaces exist

 Explicit Memories(<EM_MGR_PTR>)
...
  "<EM_NAME>" eid=<EID>(<EM_PTR>)/<EM_TYPE>, total <EM_TOTAL>, used <EM_USED>, garbage <EM_GARB> ¥
(<EM_PER1> used/total, <EM_PER2> garbage/used, <FL_BLOCKS> blocks) <EM_STAT>
...

注　出力形式で使用している記号については，「5.11.2(3)　イベントログの出力形式の説明で使用する記号」を参照してください。

出力項目

出力形式で示した各項目について説明します。

表5‒22　出力項目（Explicitヒープ詳細情報）

分類

出力項目

出力内容

意味

Explicitヒープ情報

<EH_MAX>

<const>K

Explicitヒープの最大サイズが出力されます。単位はキロバイトです。

<EH_TOTAL>

<const>K

確保済みExplicitヒープサイズが出力されます。単位はキロバイトです。

<EH_USED>

<const>K

利用済みExplicitヒープサイズが出力されます。単位はキロバイトです。

<EH_GARB>

<const>K

Explicitヒープの内部状態が出力されます。

<EH_PER1>

<decimal>%

Explicitヒープ利用率（<EH_USED>/<EH_MAX>）が%表記で出力されます。

<EH_PER2>

<decimal>%

Explicitヒープ利用率（<EH_USED>/<EH_TOTAL>）が%表記で出力されます。

<EH_PER3>

<decimal>%

Explicitヒープの内部状態が出力されます。

<EM_NUMS>

<const>

有効なExplicitメモリブロックの数が出力されます。

<EM_MGR_PTR>

<ptr>

Explicitヒープ制御のための内部情報があるメモリアドレスが出力されます。障害調査時などに利用します。

Explicitメモリブロック情報

<EM_NAME>

<letters>

Explicitメモリブロックの名称が出力されます。

Explicitメモリブロックの名称に多バイト文字が含まれている場合，出力内容は不定です（通常は文字化けして出力されます）。

Explicitメモリブロックの初期化とほぼ同時に出力された場合や，JavaVMが内部で生成したExplicitメモリブロックの場合は，"NULL"が出力されることがあります。

<EID>

<const>

ExplicitメモリブロックのIDが出力されます。

<EM_PTR>

<ptr>

Explicitメモリブロック内部構造があるメモリアドレスが出力されます。障害調査時などに利用します。

<EM_TYPE>

R|B|A

Explicitの種別が出力されます。Rは，アプリケーションサーバの内部で利用されているExplicitメモリブロックを示します。Bは，アプリケーションが利用しているExplicitメモリブロックを示します。Aは，自動配置設定ファイルを使って指定したExplicitメモリブロックを示します。

<EM_TOTAL>

<const>K

Explicitメモリブロックのメモリ確保済みサイズが出力されます。単位はキロバイトです。

<EM_USED>

<const>K

Explicitメモリブロックの利用済みサイズが出力されます。単位はキロバイトです。

<EM_GARB>

<const>K

Explicitメモリブロックの内部状態が出力されます。単位はキロバイトです。

<EM_PER1>

<decimal>%

Explicitメモリブロック利用率（<EM_USED>/<EM_TOTAL>）が%表記で出力されます。

<EM_PER2>

<decimal>%

Explicitメモリブロックの内部状態が出力されます。

<FL_BLOCKS>

<const>

常に0が出力されます。

<EM_STAT>

Enable|Disable

Explicitメモリブロックのサブ状態が出力されます。

オブジェクト統計情報※1

<ISIZE>

<const>

あるクラスをインスタンス化したオブジェクトのExplicitメモリブロック内のサイズが出力されます。

<INUM>

<const>

あるクラスをインスタンス化したオブジェクトのExplicitメモリブロック内の個数が出力されます。

<CNAME>

<letters>

<ISIZE>および<INUM>が示すクラスの完全クラス名が出力されます。

<AISIZE>

<const>

Explicitメモリブロック内の全オブジェクトの合計サイズが出力されます。

<AINUM>

<const>

Explicitメモリブロック内の全オブジェクトの個数が出力されます。

オブジェクト解放率情報※2

<FRATIO>

<decimal>%

Explicitメモリブロックの自動解放処理で解放されたオブジェクトの割合（オブジェクト解放率）が%表記で出力されます。

オブジェクト解放率＝

（自動解放処理前のクラスのオブジェクト数−自動解放処理後のクラスのオブジェクト数）／自動解放処理前のクラスのオブジェクト数×100

なお，オブジェクト解放率情報出力時に，自動解放処理の対象とならなかったExplicitメモリブロックには，「−」が出力されます。

注　出力内容で使用している記号については，「5.11.2(3)　イベントログの出力形式の説明で使用する記号」を参照してください。

注※1　オブジェクト統計情報は，eheapprofコマンドを実行している場合に出力されます。なお，オブジェクト統計情報には，実際に作成したサイズ，個数よりも多く，int型配列を示す"［I"が出力されることがあります。この場合，"［I"は，Explicitメモリブロック内で使用されていないオブジェクトを示します。Explicitメモリブロック内で使用されていないオブジェクトは，JavaVMの内部処理でint型配列化されます。

注※2　オブジェクト解放率情報は，-freeratioオプションを指定したeheapprofコマンドを実行している場合に出力されます。

出力例

eheapprofコマンドを実行しているかどうかによって出力形式が異なります。

eheapprofコマンドを実行している場合

Explicit Heap Status
--------------------
 max 31415926K, total 162816K, used 150528K, garbage 10004K (0.0% used/max, 91.1% used/total, 6.6% garbage/used), 3 spaces exist

 Explicit Memories(0x12345678)

  "EJBMgrData" eid=1(0x02f25610)/R, total 54272K, used 50176K, garbage 0K (91.2% used/total, 0.0% garbage/used, 0 blocks)
    deployed objects
    ________________Size__Instances__FreeRatio__Class________________
                35234568      10648          - java.util.HashMap
                 5678900      10668          - [Ljava.util.HashMap$Entry;
                 4456788       7436          - java.util.HashMap$Entry
                 4321000        200          - java.util.WeakHashMap
                 1234568        190          - [Ljava.util.WeakHashMap$Entry;
                  454400          4          - java.util.WeakHashMap$Entry
                51380224      29146 total

  "VJBStored" eid=3(0x02f25910)/B, total 54272K, used 50176K, garbage 10004K (90.7% used/total, 19.9% garbage/used, 5 blocks)
    deployed objects
    ________________Size__Instances__FreeRatio__Class________________
                35234568      10648         49 java.util.HashMap
                 5678900      10668         43 [Ljava.util.HashMap$Entry;
                 4456788       7436         50 java.util.HashMap$Entry
                 4321000        200         32 java.util.WeakHashMap
                 1234568        190         45 [Ljava.util.WeakHashMap$Entry;
                  454400          4         22 java.util.WeakHashMap$Entry
                51380224      29146 total

  "ExplicitMemory-2" eid=2(0x02f25700)/B, total 54272K, used 50176K,  garbage 0K (91.1% used/total, 0.0% garbage/used, 0 blocks)
    deployed objects
    ________________Size__Instances__FreeRatio__Class________________
                35234568      10648          - java.util.HashMap
                 5678900      10668          - [Ljava.util.HashMap$Entry;
                 4456788       7436          - java.util.HashMap$Entry
                 4321000        200          - java.util.WeakHashMap
                 1234568        190          - [Ljava.util.WeakHashMap$Entry;
                  454400          4          - java.util.WeakHashMap$Entry
                51380224      29146 total

eheapprofコマンドを実行していない場合

Explicit Heap Status
--------------------
 max 31415926K, total 213971K, used 205369K, garbage 1234K (1.1% used/max, 96.2% used/total, 0.0% garbage/used), 3 spaces exist

 Explicit Memories(0x12345678)

  "EJBMgrData" eid=1(0x02f25610)/R, total 154272K, used 150176K, garbage 1234K (97.0% used/total, 1.2% garbage/used, 0 blocks) Enable

  "VJBStored" eid=3(0x02f25910)/B, total 54272K, used 50176K, garbage 0K (90.9% used/total, 0.0% garbage/used, 2 blocks) Enable

  "ExplicitMemory-2" eid=2(0x02f25700)/R, total 5427K, used 5017K, garbage 0K (92.1% used/total, 0.0% garbage/used, 0 blocks) Enable

5.6　JavaVMのGCログ

GCのログは，JavaVMログファイルに出力されます。

詳細については，「5.7　JavaVMログ（JavaVMログファイル）」を参照してください。

5.7　JavaVMログ（JavaVMログファイル）

JavaVMログファイルは，製品が標準のJavaVMに追加した拡張オプションを使用して出力されます。このログを取得するためには，対象のJ2EEサーバを起動するときに必要なオプションを指定しておく必要があります。

5.7.1　JavaVMログファイルを出力するオプション

JavaVMログファイルを出力するオプションを次に示します。

-XX:+HitachiOutOfMemoryStackTrace

OutOfMemoryError発生時にスタックトレースを出力するオプションです。なお，このオプションを指定した場合に同時に指定される，-XX:+HitachiOutOfMemorySizeおよび-XX:+HitachiOutOfMemoryCauseが指定された場合も，JavaVMログファイルが出力されます。

-XX:+HitachiVerboseGC

GCが発生した時の拡張verbosegc情報を出力するオプションです。拡張verbosegc情報の取得については，「5.7.2　拡張verbosegc情報の取得」を参照してください。

-XX:+HitachiJavaClassLibTrace

System.gc()，System.exit()，System.runFinalizersOnExit()，Runtime.exit()，Runtime.halt()，またはRuntime.runFinalizersOnExit()のどれかのAPIを実行したときに，これらのAPIの呼び出しトレースを出力するオプションです。

なお，-XX:HitachiJavaClassLibTraceLineSizeオプションを指定している場合，出力されるトレースは，指定した文字数（バイト数）以内で出力されます。1行の文字数が指定した値を超える場合は，「at」以降の文字列の前半部分が削除されて，指定した文字数分出力されます。

-XX:+JITCompilerContinuation

JITコンパイラ稼働継続機能を有効にするオプションです。JITコンパイルがアプリケーションを構成するメソッドの論理矛盾で失敗すると，JITコンパイラ稼働継続機能のログがJavaVMログファイルに出力されます。

それぞれのオプションを指定した場合の出力内容の詳細については，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]HitachiOutOfMemoryStackTrace（スタックトレース出力オプション）」

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]HitachiVerboseGC（拡張verbosegc情報出力オプション）」

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]HitachiJavaClassLibTrace（クラスライブラリのスタックトレース出力オプション）」

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]JITCompilerContinuation（JITコンパイラ稼働継続機能オプション）」

5.7.2　拡張verbosegc情報の取得

J2EEサーバのusrconf.cfgファイルに，次の表に示すオプションを指定すると，拡張verbosegc情報を取得できます。拡張verbosegc情報からは，そのサーバで必要とするJavaヒープ領域サイズ，Metaspace領域サイズなどを見積もるための情報が取得できます。なお，Javaログには，OutOfMemoryError発生時のスタックトレースも出力されます。

表5‒23　拡張verbosegc情報の取得を指定するオプション

オプション

意味

-XX:+HitachiVerboseGC

拡張verbosegc情報を出力するかどうかを指定します。GCの内部領域であるEden，Survivor，Tenured，Metaspace領域種別ごとに情報を出力します。デフォルトでは出力されません。-XX:+HitachiVerboseGCと指定すると拡張verbosegc情報が出力され，-XX:-HitachiVerboseGCと指定すると拡張verbosegc情報は出力されません。

-XX:+HitachiVerboseGCPrintDate

拡張verbosegc情報を出力するログの各行の先頭に，ログを出力した日付を表示するかどうかを指定します。

-XX:+HitachiVerboseGCCpuTime

GCの開始から終了までの間で，GCの実行スレッドのユーザモードおよびカーネルモードに費やされた時間だけを表示するか，GCの開始から終了までの実時間を表示するかを指定します。

-XX:HitachiVerboseGCIntervalTime=<時間間隔>

-XX:+HitachiVerboseGCに対する出力時間の間隔を数値（単位：秒）で指定します。時間間隔のデフォルト値は0（GC発生のたびに出力）です。なお，時間間隔を指定すると，その時間間隔の間に発生したGC回数も表示されます。

-XX:+HitachiVerboseGCPrintCause

拡張verbosegc情報を出力するログに，GCが発生した原因を表示するかどうかを指定します。

-XX:+HitachiCommaVerboseGC

拡張verbosegc情報を出力するログをCSV形式で出力するかどうかを指定します。CSV形式で出力する場合，拡張verbosegc情報の括弧「( )」「[ ]」「< >」や，区切り「:」はすべて省略され，数値または文字列が「,」で区切られて出力されます。

-XX:+HitachiVerboseGCPrintTenuringDistribution

Survivor領域の年齢分布情報を出力するかどうかを指定します。デフォルトでは出力されません。出力形式や出力情報については，「9.11　Survivor領域の年齢分布情報出力機能」を参照してください。

-XX:+HitachiVerboseGCPrintJVMInternalMemory

JavaVM内部で管理しているヒープ情報をJavaVMログファイルに出力するかどうかを指定します。

-XX:+HitachiVerboseGCPrintThreadCount

Javaスレッドの数を監視するために，Javaスレッドの数をJavaVMログファイルに出力するかどうかを指定します。

-XX:+HitachiVerboseGCPrintDeleteOnExit

java.io.File.deleteOnExit()を呼び出したことによってJavaVMが確保した累積のヒープサイズとメソッドの呼び出し回数を，JavaVMログファイルに出力するかどうかを指定します。

-XX:+PrintCodeCacheInfo

コードキャッシュ領域の使用量を出力するかどうか，また，使用量がしきい値に達したことを知らせるメッセージを出力するかどうかを指定します。

ログファイルの出力形式と出力例を次に示します。

出力形式

[id] <date> (Skip Full:full_count, Copy:copy_count) [gc_kind gc_info, gc_time secs][Eden: eden_info][Survivor: survivor_info][Tenured: tenured_info][Metaspace: metaspace_info][class space: class_space_info]  [cause:cause_info] [User: user_cpu secs] [Sys: system_cpu secs][IM: jvm_alloc_size, mmap_total_size, malloc_total_size][TC: thread_count][DOE: doe_alloc_size, called_count][CCI: cc_used_sizeK, cc_max_sizeK, cc_infoK]

説明

id：JavaVMログファイル識別子

JavaVMログファイル識別子を次の表に示します。この識別子は，ログをログの内容（機能）ごとにフィルタリングして調査する場合に利用できます。

表5‒24　JavaVMログファイル識別子

識別子

ログの内容

CCI

コードキャッシュ領域情報

CLT

クラスライブラリのスタックトレース

JCC

JITコンパイル失敗情報

JMS

JITコンパイルを抑制したJITコンパイラスレッドに関する情報

OMH

OutOfMemoryの発生頻度に関する情報

OOM

OutOfMemoryError発生時の例外情報とスタックトレース

PTD

Survivor領域の年齢分布情報

VGC

拡張verbosegc情報

date：日時

full_count：FullGCをスキップした回数（-XX:HitachiVerboseGCIntervalTimeを指定した場合だけ）

copy_count ：CopyGCをスキップした回数（-XX:HitachiVerboseGCIntervalTimeを指定した場合だけ）

gc_kind：GC種別（Full GCまたはGC）

gc_info：GC情報（GC前の領域長 -> GC後の領域長(領域サイズ)）

(例)　264K->0K(512K)

gc_time：GC経過時間（単位：秒）

eden_info：Eden情報

survivor_info：Survivor情報

tenured_info：Tenured情報

metaspace_info：Metaspace領域情報

class_space_info：CompressedClassSpace情報

cause_info：GCの原因

user_cpu secs：GCスレッドがユーザモードに費やしたCPU時間（単位：秒）

system_cpu secs：GCスレッドがカーネルモードに費やしたCPU時間（単位：秒）

jvm_alloc_size：JavaVM内部で管理している領域のうち，現在使用中の領域のサイズ（mmap_total_sizeとmalloc_total_sizeの合計サイズのうち，現在使用中の領域のサイズ）（-XX:+HitachiVerboseGCPrintJVMInternalMemoryを指定した場合だけ）

mmap_total_size：JavaVM内部で管理している領域のうち，mmap（Windowsの場合はVirtualAlloc）で割り当てたCヒープの総サイズ（-XX:+HitachiVerboseGCPrintJVMInternalMemoryを指定した場合だけ）

malloc_total_size：JavaVM内部で管理している領域のうち，mallocで割り当てたCヒープの総サイズ（-XX:+HitachiVerboseGCPrintJVMInternalMemoryを指定した場合だけ）

thread_count：Javaスレッドの数（-XX:+HitachiVerboseGCPrintThreadCountを指定した場合だけ）

doe_alloc_size：java.io.File.deleteOnExit()を呼び出して確保した累積のヒープサイズ（-XX:+HitachiVerboseGCPrintDeleteOnExitを指定した場合だけ）

called_count：java.io.File.deleteOnExit()の呼び出し回数（-XX:+HitachiVerboseGCPrintDeleteOnExitを指定した場合だけ）

cc_used_size：GC時のコードキャッシュ領域の使用サイズ（単位：キロバイト）（-XX:+PrintCodeCacheInfoを指定した場合だけ）

cc_max_size：コードキャッシュ領域の最大サイズ（単位：キロバイト）（-XX:+PrintCodeCacheInfoを指定した場合だけ）

cc_info：保守情報（-XX:+PrintCodeCacheInfoを指定した場合だけ）

出力例

-XX:+HitachiCommaVerboseGCオプションを指定した場合の出力例を次に示します。

VGC,Fri Jan 23 21:37:50 2004,11,41,0,GC,16886,16886,65088,0.0559806,
4094,0,4096,447,447,448,12345,16439,60544,1116,1116,4096,0,0.0312500, 0.0156250,729,928,0,509,2167,2054,2301,49152,2304
VGC,Fri Jan 23 21:37:55 2004,6,24,0,Full GC,65082,65082,65088,0.4294532,
4094,4094,4096,447,447,448,60541,60541,60544,1116,1116,4096,0,0.0156250, 0.0312500,729,928,0,509,16,170,2301,49152,2304

5.7.3　コードキャッシュ領域に関するログの内容

JavaVMは，呼び出し回数やループ回数が多いJavaメソッドをJITコンパイルして実行することで，処理の高速化を行います。JITコンパイルによって生成されたJITコンパイルコードは，コードキャッシュ領域に配置されます。

通常，コードキャッシュ領域のサイズはデフォルト値で問題ありません。しかし，実行環境やJavaアプリケーションの規模によっては，コードキャッシュ領域のサイズがデフォルト値では枯渇する場合があります。

コードキャッシュ領域が枯渇すると，JavaVMはJITコンパイルを実行できなくなり，Javaアプリケーションの実行で十分な性能が得られないおそれがあります。この場合は，「-XX:[+|-]PrintCodeCacheInfo（コードキャッシュ領域情報出力オプション）」や「-XX:[+|-]PrintCodeCacheFullMessage（コードキャッシュ領域枯渇メッセージ出力オプション）」を有効にして，コードキャッシュ領域の使用量や出力されるメッセージを監視するようにしてください。

これらのオプションについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]PrintCodeCacheInfo（コードキャッシュ領域情報出力オプション）」および「-XX:[+|-]PrintCodeCacheFullMessage（コードキャッシュ領域枯渇メッセージ出力オプション）」を参照してください。

(1)　コードキャッシュ領域の使用量がしきい値に達したことを知らせるメッセージの出力内容

コードキャッシュ領域の使用量がしきい値に達したことを知らせるメッセージの出力形式を次に示します。

[cc_id]<cc_date>CodeCache usage has exceeded the threshold.[cc_used_sizeK, cc_max_sizeK, cc_infoK]

出力項目について次に示します。

出力項目

説明

cc_id

CCI（JavaVMログファイル識別子）が出力されます。

cc_date

JITコンパイルを実行した日時が出力されます。

cc_used_size

JITコンパイル後のコードキャッシュ領域の使用サイズが出力されます（単位：キロバイト）。

cc_max_size

コードキャッシュ領域の最大サイズが出力されます（単位：キロバイト）。

cc_info

保守情報が出力されます。

(2)　コードキャッシュ領域が枯渇したことを知らせるメッセージの出力内容

コードキャッシュ領域が枯渇したことを知らせるメッセージの出力形式を次に示します。

[cc_id]<cc_date>CodeCache is full. Compiler has been disabled.[cc_used_sizeK, cc_max_sizeK, cc_infoK]

出力項目について次に示します。

出力項目

説明

cc_id

CCI（JavaVMログファイル識別子）が出力されます。

cc_date

JavaメソッドがJITコンパイルの対象になった日時が出力されます。

cc_used_size

JavaメソッドがJITコンパイルの対象になったときのコードキャッシュ領域の使用サイズが出力されます（単位：キロバイト）。

cc_max_size

コードキャッシュ領域の最大サイズが出力されます（単位：キロバイト）。

cc_info

保守情報が出力されます。

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

JavaVMでクラッシュが発生した場合，JavaVMによってデバッグ情報が標準出力とエラーリポートファイルに出力されます。

エラーリポートファイルに出力されるのは，次の場合です。

JNIの中でのシグナルが発生したとき

JavaVMでCヒープ不足が発生したとき

JavaVMで予期しないシグナルが発生したとき

JavaVMでInternal Error（内部論理エラー）が発生したとき

ここでは，次の場合のメッセージログの出力内容について説明します。

表5‒25　 JavaVMが出力するメッセージログ

メッセージの種類

出力先

JNIの中でのシグナルが発生した場合，またはJavaVMでのメッセージ※

標準出力

エラーリポートファイル

Cヒープが不足した場合のメッセージ※

標準出力

エラーリポートファイル

Internal Errorが発生した場合のメッセージ※

標準出力

エラーリポートファイル

スレッド作成に失敗した場合のメッセージ※

標準出力

注※　JavaVM独自の出力先または出力内容があります。

なお，スレッド作成に失敗した場合のメッセージは，標準出力だけに出力されます。

5.8.1　シグナルが発生した場合

シグナルが発生した場合，次に示す項目がログ出力されます。出力内容には，JavaVMとして拡張された内容が含まれます。

異常終了位置とシグナル種別※

カレントスレッド情報

シグナル情報の格納先アドレス※

シグナル情報

siginfo情報※（UNIXの場合）

レジスタ情報

スタックの先頭から格納されている情報

命令コード情報

スタックトレース

スレッド情報

VMの状態

メモリ情報※

Javaヒープの使用状況※

Card tableマップアドレスの表示

Polling pageアドレスの表示

Large pages 確保失敗情報

CodeCache情報

Event情報

ライブラリ

コマンドおよびVMパラメタ※

環境変数

登録済みシグナルハンドラ

マシン情報※

システム名，CPU，実メモリ，およびVM情報

時間情報※

javatrace起動コマンドのコマンドライン※（UNIXの場合）

注※　製品で拡張された出力内容です。

それぞれの出力内容について説明します。

(1)　異常終了位置とシグナル種別

異常終了時の状態に応じて，次のどちらかの内容が出力されます。この内容は，JavaVMで拡張された出力内容です。

(a)　シグナルを検出した場合

次のメッセージが出力されます。

#
# A fatal error has been detected by the Java Runtime Environment:

次の内容が出力されます。

シグナルを検出した場合の出力内容

#
# A fatal error has been detected by the Java Runtime Environment:
#
#  <発生したシグナル名>　(<シグナル番号>) at pc=<PCアドレス>, pid=<プロセスID>, tid=<スレッドID>
#
# JRE version: <jreバージョン情報>
# Java VM: Java HotSpot(TM) <VM種別> (<Sunバージョン情報>-<バージョン情報>-<ビルド年月日> mixed mode<OS名>-<CPU種別>)
# Problematic frame:
# <種別コード>  [<シグナルが発生したライブラリ名>＋<オフセット>]
#

注

シグナルが発生した関数名が取り出せた場合，「<シグナルが発生したライブラリ名>＋<オフセット>」に続いて，その関数名とオフセットが表示されることがあります。

(b)　内部論理エラーが発生した場合

次の内容が出力されます。

内部論理エラーが発生した場合の出力内容

#
#  Internal Error (<ファイル名>:<行数> または，Internal Errorのコード), pid=<プロセスID>, tid=<スレッドID>
#  <内部論理エラー種別>: 内部論理エラーメッセージ
#
#  JRE version: <jreバージョン情報>
#  Java VM: Java HotSpot(TM) <VM種別> (<Sunバージョン情報>-<バージョン情報>-<ビルド年月日> mixed mode<OS名>-<CPU種別> <圧縮OOP>)
#
#　<coreファイル情報>

注

Internal Errorには，ファイル名および行数の組み合わせ，またはInternal Errorのコードが出力されます。<内部論理エラー種別>には，発生した内部論理エラーの種類によって，"fatal error"，"guarantee(<論理式>) failed"，または"Error"のどれかが出力されます。

(2)　カレントスレッド情報

スレッドの種類に応じて次の3種類の情報が出力されます。

Current thread (<アドレス>):  <スレッド名> "<スレッド名称>" [_<状態>, id=<スレッドID>, stack(<開始アドレス>,<終了アドレス>)]

または
Current thread (<アドレス>):  <スレッド名> [_id=<スレッドID>, stack(<開始アドレス>,<終了アドレス>)]

または
Current thread is native thread

(3)　シグナル情報の格納先アドレス

次の内容が出力されます。この内容は，JavaVMで拡張された出力内容です。

siginfo address: <アドレス>, context address: <アドレス>

(4)　シグナル情報

次の内容が出力されます。

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: <アドレス>

(5)　siginfo情報（UNIXの場合）

次の内容が出力されます。この内容は，JavaVMで拡張された出力内容です。

siginfo structure dump (location: <siginfoのアドレス>)
<siginfoのアドレス> <siginfoのアドレス> <siginfoのアドレス> <siginfoのアドレス>
：
<siginfoのアドレス> <siginfoのアドレス> <siginfoのアドレス> <siginfoのアドレス>

注

<siginfoのアドレス>は16進数で出力されます。

(6)　レジスタ情報

次の内容が出力されます。ただし，内部論理エラーの場合は出力されません。

Registers:<レジスタ情報>
：

注

UNIXの場合，BSPレジスタの値がデバッガ（gdb）の値と異なって出力されます。これは，デバッガではBSPの指すバッキングストア領域の内容を出力しており，BSPの指す位置を修正しているためです。

(7)　スタックの先頭から格納されている情報

次の内容が出力されます。ただし，内部論理エラーの場合は出力されません。

Top of Stack: (sp=<スタックポインタのアドレス>)
<アドレス>:   <格納されている内容>
：

注

<格納されている内容>は16進数で出力されます。

(8)　スタックトレース

次の内容が出力されます。ただし，Current threadがJavaThread以外の場合は出力されません。

Java frames: (J=compiled Java code, j=interpreted, Vv=VM code)
 <スタックトレース>
：

(9)　スレッド情報

次の内容が出力されます。

Java Threads: ( => current thread )
  <アドレス>　JavaThread “<スレッド名称>“　[<状態>, id=<スレッドID>, stack(<開始アドレス>,<終了アドレス>)]
　  ：
=><アドレス>　JavaThread “<スレッド名称>“　[<状態>, id=<スレッドID>, stack(<開始アドレス>,<終了アドレス>)]
Other　Threads:
  <アドレス>　<スレッド名> [stack(<開始アドレス>,<終了アドレス>)] [id=<スレッドID>]
　  ：

(10)　VMの状態

次の内容が出力されます。

VM state:<現在の状態>

VM Mutex/Monitor currently owned by a thread: <mutexs/moniter>

注

この情報に続いて，ロック情報が出力される場合があります。

(11)　メモリ情報

次の内容が出力されます。この内容は，JavaVMで拡張された出力内容です。

Memory :
<メモリ確保関数>:address<開始アドレス> - <終了アドレス>(size:<サイズ>)
        ：

        Heap Size:<確保しているメモリサイズ>
        Alloc Size:<使用中のメモリサイズ>
        Free Size:<未使用のメモリサイズ>

<メモリ確保関数>は，mmap()またはmalloc()のどちらかです。アドレスは16進数で表示されます。

各種メモリサイズの単位はバイトです。

(12)　Javaヒープの使用状況

次の内容が出力されます。この内容は，JavaVMで拡張された出力内容です。

Heap※
<Javaヒープ情報>

注※

見出し部分は拡張スレッドダンプとエラーリポートファイルで次のように異なる。

拡張スレッドダンプの場合

Heap Status

-----------

エラーリポートファイルの場合

Heap

(13)　Card tableマップアドレスの表示

次の内容が出力されます。

Card table byte_map: [<アドレス>,<アドレス>] byte_map_base: <アドレス>

(14)　Polling pageアドレスの表示

次の内容が出力されます。

Polling page: <アドレス>

(15)　Large pages 確保失敗情報

mmap()関数でのメモリ確保に失敗した場合に，失敗回数が出力されます。

Large page allocation failures have occurred　<回数> times

(16)　CodeCache情報

次の内容が出力されます。

CodeCache: size=<全体サイズ> used=<使用済みサイズ> max_used=<最大サイズ> free=<空きサイズ>
 bounds [<bottom>, <commit addr>, <reserve addr>]
 total_blobs=<CodeBlobの総数> nmethods=<nmethodsの総数> adapters=<adapterの総数>
 compilation: <enabled/disabled>

(17)　Event情報

イベントバッファの内容がすべて出力されます。

<イベント種別名> (<イベント数> events):
<イベントレコード>
　　：

イベント情報はリングバッファで管理していて，イベント種別ごとに保持するイベント数の最大値は10です。イベント数が0の場合は<イベントレコード>には"No events"が出力されます。

出力できる<イベント種別>の出力例を次に示します。

Compilation events

JITコンパイル情報

Compilation events (10 events):
Event: 0.923 Thread 0x00002aaab2f01800  389    b        java.io.FileOutputStream::write (12 bytes)
Event: 0.923 Thread 0x00002aaab2f01800 nmethod 389 0x00002aaaac3ea490 code [0x00002aaaac3ea5e0, 0x00002aaaac3ea668]
　　：

GC Heap History

before GC，after GC情報

GC Heap History (4 events):
Event: 23.719 GC heap before
{Heap before GC invocations=0 (full 0):
 def new generation   max 154880K, total 9664K, used 345K (0.2% used/max, 3.6% used/total)
　　：

Deoptimization events

Deopt情報

Deoptimization events (10 events):
Event: 0.818 Thread 0x00002aaaaba7e000 Uncommon trap 24 fr.pc 0x00002aaaac3d1eec
Event: 0.818 Thread 0x00002aaaaba7e000 Uncommon trap 54 fr.pc 0x00002aaaac3d0dd8
　　：

Internal exceptions

internal exception情報

Internal exceptions (2 events):
Event: 0.025 Thread 0x00002aaaaba7e000 Threw 0x00000000db606140 at /hotspot/src/share/vm/prims/jni.cpp:4008
Event: 0.061 Thread 0x00002aaaaba7e000 Threw 0x00000000db649980 at /hotspot/src/share/vm/prims/jvm.cpp:1167
　　：

Events

クラスローダ情報など

Events (10 events):
Event: 0.080 loading class 0x00002aaab302e990
Event: 0.080 loading class 0x00002aaab302e990 done
Event: 4.286 Executing VM operation: EnableBiasedLocking
Event: 4.286 Executing VM operation: EnableBiasedLocking done
　　：

(18)　ライブラリ

次の内容に続いて，ローディングされているライブラリの一覧が出力されます。

Dynamic libraries:
<ライブラリ>
：

(19)　コマンドおよびVMパラメタ

次の内容が出力されます。この内容は，JavaVMで拡張された出力内容です。

Command : <コマンドライン>

Java Home Dir   : <JDK実行環境インストールディレクトリ>
Java DLL Dir    : <JDKのライブラリインストールディレクトリ>
Sys Classpath   : <システムクラスパス>
User Args       :
<コマンドオプション1>
<コマンドオプション2>
：

(20)　環境変数

次の内容が出力されます。

Environment Variables:
<環境変数=値>
：

(21)　登録済みシグナルハンドラ

次の内容が出力されます。

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進で出力された値です。

(22)　マシン情報

次の内容が出力されます。この内容は，JavaVMで拡張された出力内容です。

Host: <ホスト名>:<IPアドレス>

注

<IPアドレス>には複数のIPアドレスが表示されることがあります。

(23)　システム名，CPU，実メモリ，およびVM情報

次の内容が出力されます。

Windowsの場合

OS: <OSバージョン>

CPU: <利用可能CPU数>,<CPU種別>

Memory: <実メモリ情報>

vm_info: <VM情報>

UNIXの場合

OS: <OSバージョン>

[uname:<uname出力>]
[libc:<libcのバージョン番号>]
[rlimit:<リミット値>]
[load average:<ロードアベレージ>]
[/proc/meminfo:</proc/meminfoの内容>]

CPU: <利用可能CPU数>[,<CPU種別>]

Memory: <実メモリ情報>

vm_info: <VM情報>

時間情報

次の内容が出力されます。

time: <実行日付>

elapsed time: <実行時間> seconds <(実行時間 形式出力)>

注

実行日付の例を次に示します。

例：「Wed Aug 25 14:55:04 2004」

秒単位だけでは実行時間が把握しづらいため，<(実行時間 形式出力)>ではユーザが読みやすいように，(DAYS HOURS MINS SECS)フォーマットで出力します。

(例) elapsed time: 900 seconds (0d 0h 15m 0s)

(24)　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:
#[<インストールディレクトリ>/bin/javatrace <coreファイル>  <ロードモジュール>]

5.8.2　Cヒープが不足した場合

Cヒープが不足した場合，次の順序でメッセージ出力およびダンプ出力，またはcoreダンプの生成が実行されます。

Cヒープ不足を示すメッセージログが，エラーリポートファイルおよび標準出力に出力されます。

1.の実行中にメモリ不足が発生した場合，簡易メッセージが標準出力に出力されます。

UNIXの場合，簡易メッセージの出力処理中にさらにメモリ不足が発生したときに，メッセージおよびエラーログファイルの出力処理を中止して，coreダンプを生成します。

それぞれの出力形式を次に示します。

(1)　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
-----------
<スタックトレース>
JVM Internal Memory Status
--------------------------
<独自メモリ管理機能で管理している領域情報>
Insufficient memory for malloc. JVM generates core file.
-----------

AIX，または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
-----------
<スタックトレース>
-----------

JVM Internal Memory Status
--------------------------
<独自メモリ管理機能で管理している領域情報>

このようなメッセージが出力された場合は，Cヒープを減らすなど，適切な対策をしてください。

出力項目について次に示します。

表5‒26　 Cヒープが不足した場合のメッセージログの出力項目

出力項目

説明

ThreadName

Thread#getName()メソッドで取り出せるスレッド名称が出力されます。

n

メモリ確保要求サイズが出力されます。

message

保守員による調査に必要な内部メッセージが出力されます。出力されない場合もあります。

Javaヒープ情報

Javaヒープの使用状況が出力されます。

スタックトレース

メモリ不足の発生したスレッドがJava コードを実行しているスレッドである場合に，スタックトレースが出力されます。

コンパイル処理のようなJavaVMの内部処理を実行するスレッドでメモリ不足が発生した場合には出力されません。

(2)　メモリ不足を示すメッセージの出力内容

Cヒープ不足を示すメッセージログが出力されている間にさらにメモリ不足が発生した場合は，処理の続行ができません。この場合は，次の形式の簡易メッセージが標準出力に出力されます。

java.lang.OutOfMemoryError:requested <n> bytes for <message>

出力項目について次に示します。

表5‒27　メモリ不足が発生した場合の簡易メッセージの出力項目

出力項目

説明

n

メモリ確保要求サイズが出力されます。

message

保守員による調査に必要な内部メッセージが出力されます。

(3)　coreダンプの生成を示すメッセージの出力内容

簡易メッセージの出力処理中にさらにメモリ不足が発生した場合，メッセージおよびエラーログファイルの出力処理を中止して，coreダンプを生成します。coreダンプが生成されると，次の形式のメッセージが標準出力に出力されます。

Can't create logs because of memory shortage.
Insufficient memory for malloc. JVM generates core file

5.8.3　Internal Errorが発生した場合

JavaVM内部の論理エラーであるInternal Errorが発生した場合，次の情報が出力されます。

異常終了位置とシグナル種別

カレントスレッド情報

シグナル情報の格納先アドレス※

スレッド情報

VMの状態

メモリ情報※

ヒープ情報※

Card tableマップアドレス

Polling pageアドレス

Large pages 確保失敗情報

CodeCache情報

Event情報

ライブラリ

コマンド・VMパラメタ※

環境変数

登録済みシグナルハンドラ

マシン情報※

システム名，CPU，実メモリ，およびVM情報

時間情報

javatrace起動コマンドのコマンドライン※（UNIXの場合）

注※　製品で拡張された出力内容です。

それぞれの情報の出力形式については，「5.8.1　シグナルが発生した場合」を参照してください。

5.8.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.9　OSの状態情報およびOSのログ

取得したOSの状態・ログ情報で異常な傾向の有無を確認します。具体的な資料の見方についてはOS付属のマニュアルなどを参照してください。

5.10　JavaVMスタックトレース情報

ここでは，スタックトレースに出力される情報のうち，JavaVMで拡張された内容について説明します。

サーバやアプリケーションでトラブルが発生した場合，トラブル発生までのスタックトレースの内容を確認することで，トラブル発生の要因を調査できます。

スタックトレースは，次のどれかのタイミングで出力されます。

J2EEサーバまたはJ2EEアプリケーションで例外が発生した場合

バッチサーバまたはバッチアプリケーションで例外が発生した場合

JavaVMのスレッドダンプが出力された場合

JavaVMでは，サーバを起動するときのオプションの指定によって，スタックトレースにJavaメソッドのローカル変数についての情報を出力できます。例外発生時にJavaメソッドに定義されていたローカル変数の情報は，トラブルの要因を分析するために有効です。

なお，ここで対象にするローカル変数とは，メソッドに渡される引数およびインスタンスメソッドでの呼び出しの対象になるオブジェクト（this）のことです。ローカル変数情報には，これらのローカル変数の変数名，型名，およびローカル変数の値が出力されます。なお，型名は，基本形名，クラス名（インタフェース名を含みます）または配列形名のことです。

スタックトレースにローカル変数情報を出力するためのオプションを，次の表に示します。JavaVMの資料取得の設定については，「3.3.17　JavaVMの資料取得の設定」を参照してください。

表5‒28　スタックトレースにローカル変数情報を出力するためのオプション

起動オプション

スタックトレースを出力するタイミング

同時に指定できるオプション

-XX:+HitachiLocalsInThrowable

サーバまたはアプリケーション内で例外が発生したとき※

-XX:+HitachiLocalsSimpleFormat

-XX:+HitachiTrueTypeInLocals

-XX:HitachiCallToString=<適用範囲指定>

-XX:+HitachiLocalsInStackTrace

JavaVMのスレッドダンプを出力したとき

-XX:+HitachiLocalsSimpleFormat

-XX:+HitachiTrueTypeInLocals

注※　ただし，発生した例外が「java.lang.StackOverflowError」または「java.lang.OutOfMemoryError」の場合，スタックトレースにローカル変数は出力されません。

次に，それぞれのオプションを指定した場合に出力される内容について，例を基に説明します。それぞれのオプションを指定した時に出力される項目の詳細については，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]HitachiLocalsInThrowable（例外発生時のローカル変数情報収集オプション）」

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:[+|-]HitachiLocalsInStackTrace（スレッドダンプ出力時のローカル変数出力オプション）」

5.10.1　-XX:+HitachiLocalsInThrowableオプションが指定されている場合

java.lang.Throwable.printStackTraceメソッドで出力されるスタックトレース情報の1スタックフレーム情報ごとに，そのスタックフレームに対応するメソッド内のローカル変数情報が挿入されて出力されます。

(1)　標準の形式および簡易出力フォーマットでの出力例

ローカル変数を出力するための機能として，-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‒2　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‒3　-XX:+HitachiLocalsSimpleFormatオプションを指定した場合の出力例

また，javacコマンド実行時に，-gオプションまたは-g:varsオプションを指定しなかった場合，ローカル変数情報がないため，出力内容が次のように制限されます。これらは，nativeメソッドを実行した場合も同様です。

出力できるローカル変数が，メソッドに渡される引数とインスタンスメソッド呼び出し対象オブジェクト（this）だけになります。

メソッドに渡される引数は，変数名が出力されません。引数番号だけが出力されます。

nativeメソッドの場合，ローカル変数の値としてnativeメソッドを呼び出した時点での値が出力されます。nativeメソッドの実行結果を反映した出力結果にはなりません。

ローカル変数情報がない場合の，Javaプログラムの例1に対する出力例を次に示します。ここでは，簡易出力フォーマットでの出力例を示します。

図5‒4　ローカル変数情報がない場合の出力例（簡易出力フォーマット）

図5-3に比べて，次の違いがあります。

メソッドに渡される引数（l1〜l3）の変数名が出力されません。

メソッド呼び出し時点の値が出力されるため，メソッド内で設定されたローカル変数についての情報（l4〜l7）が出力されません。

(2)　クラスまたは配列型の変数を文字列として出力する場合の出力例

出力するローカル変数がクラスまたは配列型の場合，アドレスだけの値表現ではトラブルシューティングに必要な情報が取得できない場合があります。このとき，-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‒5　-XX:HitachiCallToString=minimalオプションを指定した場合の出力例（簡易出力フォーマット）

出力内容について説明します。

クラス型のローカル変数のうち，文字列を出力する適用対象のクラスの型のローカル変数情報です。アドレスに続いて，文字列に変換した値が出力されます。

クラス型のローカル変数のうち，文字列を出力する適用対象外のクラスの型のローカル変数情報です。アドレスだけが出力されます。

次に，-XX:HitachiCallToString=fullオプションを指定した場合の出力例を次に示します。

図5‒6　-XX:HitachiCallToString=fullオプションを指定した場合の出力例（簡易出力フォーマット）

図5-5に比べて，次の違いがあります。

minimalを指定した場合に適用対象外のクラスだったjava.lang.Objectクラスおよびjava.lang.Objectクラスの配列のローカル変数（l6およびl7）に対しても，文字列が出力されます。

ただし，次の場合は，文字列は出力されないで，アドレスだけが出力されます。

ローカル変数の値がnullだった場合

文字列で出力するときに再度例外が発生して，正常に値が得られなかった場合

注意事項

ローカル変数情報で出力するオブジェクトは，ほかのスレッドで並行して操作していることがあります。このため，このオプションを指定して出力した文字列は，実際に例外が発生したときのオブジェクトに対応する情報とは異なっているおそれがあります。

(3)　クラスまたは配列型の変数の実際の型名を出力する場合の出力例

出力するローカル変数がクラスまたは配列型の場合，変数の型名と実際に代入されている値の型名が異なる場合があります。例えば，クラスの継承関係やインタフェースの実装関係によっては，異なる型名の値が変数に代入されます。

この場合に，-XX:+HitachiTrueTypeInLocalsオプションの指定によって，クラスまたは配列型の変数に実際に代入されている値の型名を追記して取得できます。

取得した文字列は，値表現の末尾に半角スペース1文字分が追記され，( )で囲まれて出力されます。このとき，出力文字列長に制限はありません。

次に，-XX:+HitachiTrueTypeInLocalsオプションが指定されている場合の出力例を示します。ここでは簡易出力フォーマットで示します。実行するプログラムは，Javaプログラムの例2です。また，この例は，-XX:HitachiCallToString=minimalオプションが指定されている場合の例です。

図5‒7　-XX:+HitachiTrueTypeInLocalsオプションを指定した場合の出力例（簡易出力フォーマット）

出力内容について説明します。

変数の型名はjava.lang.Objectクラスまたはjava.lang.Objectクラスの配列ですが，実際に代入されている値の型名はjava.lang.Threadクラスおよびjava.lang.Threadクラスの配列であることが出力されています。

なお，-XX:+HitachiTrueTypeInLocalsオプションは，-XX:HitachiCallToString=fullオプションとも同時に指定できます。

5.10.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‒8　Javaプログラムの例3に対するローカル変数情報の出力例

5.11　明示管理ヒープ機能のイベントログ

この節では，明示管理ヒープ機能のイベントログの内容について説明します。

明示管理ヒープ機能のイベントログは，GC発生，Explicitメモリブロックの初期化・解放・拡張，Explicitメモリブロックへのオブジェクトの移動など，明示管理ヒープ機能に関連するイベントが発生したタイミングで出力されます。出力される内容は，JavaVM起動オプションで指定したログ出力レベルの設定によって異なります。

明示管理ヒープ機能のイベントログは，次の用途で使用できます。

Explicitヒープのチューニング

明示管理ヒープ機能を実装したアプリケーションのデバッグ

稼働情報の収集

イベントログを参照すると，Explicitヒープのサイズの変化，Explicitメモリブロックの数，Javaヒープの各領域サイズの変化などがわかります。なお，イベントログは，テキストファイルとして出力されます。

5.11.1　明示管理ヒープ機能のイベントログの出力契機

ここでは，明示管理ヒープ機能のイベントログの出力契機について説明します。設定しているログ出力レベルに応じて，契機となるイベントは異なります。

ログ出力レベルには，normal，verbose，debugの3種類があります。なお，verboseを指定した場合，normalで出力される内容に加えて，verboseに対応する内容が出力されます。debugを指定した場合，verboseで出力される内容に加えて，debugに対応する内容が出力されます。

ログ出力レベルと出力契機となるイベントの対応を次の表に示します。イベントに対応して出力される接頭語についてもあわせて示します。各イベントで出力される内容については，参照先を参照してください。

表5‒29　ログ出力レベルと出力契機となるイベントの対応

ログ出力レベル

出力契機となるイベント

接頭語※

参照先

normal

GC発生（Explicitヒープの利用状況出力）

ENS

5.11.3(1)

Explicitメモリブロックの明示解放処理

ENS

5.11.3(2)

Explicitメモリブロックの明示解放処理時のJavaヒープあふれ

ENS

5.11.3(3)

Explicitメモリブロックの自動解放処理

ENS

5.11.3(4)

Explicitメモリブロックの自動解放処理時のJavaヒープあふれ

ENS

5.11.3(5)

明示管理ヒープ自動配置設定ファイルオープンエラー

ENA

5.11.3(6)

明示管理ヒープ自動配置設定ファイルパースエラー

ENA

5.11.3(7)

明示管理ヒープ自動配置エラー

ENA

5.11.3(8)

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルオープンエラー

ENO

5.11.3(9)

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルパースエラー

ENO

5.11.3(10)

verbose

Explicitメモリブロックの初期化

EVO

5.11.4(1)

Explicitメモリブロックの初期化失敗

EVO

5.11.4(2)

Explicitメモリブロックのサブ状態のDisable化

EVO

5.11.4(3)

Explicitメモリブロックへのオブジェクト生成

EVS

5.11.4(4)

Explicitメモリブロックへの移動（詳細情報出力）

EVS

5.11.4(5)

Explicitメモリブロックの明示解放処理（詳細情報出力）

EVS

5.11.4(6)

ファイナライザによるExplicitメモリブロックの解放予約

EVO

5.11.4(7)

明示管理ヒープへの自動配置

EVA

5.11.4(8)

debug

Explicitメモリブロックの明示解放によるJavaヒープへのオブジェクトの移動

EDO

5.11.5(1)

Explicitメモリブロックの初期化（詳細情報出力）

EDO

5.11.5(2)

Explicitメモリブロックの自動解放処理の詳細（詳細情報出力）

EDO

5.11.5(3)

注※

接頭語は，ログ行の最初に出力する「[」と「]」で囲まれたアルファベット（3文字）です。

各イベントの詳細は，マニュアル「アプリケーションサーバ 機能解説 拡張編」を参照してください。

5.11.2　明示管理ヒープ機能のイベントログの確認方法

ここでは，明示管理ヒープ機能が出力するイベントログの参照方法について説明します。

(1)　出力契機の確認方法

ログ出力の契機となったイベントは，[cause:<CAUSE>]の形式で出力されます。この項目を確認することで，契機となったイベントを確認できます。

<CAUSE>に出力される文字列の意味を次の表に示します。

表5‒30　<CAUSE>に出力される文字列の意味

<CAUSE>

意味

GC

CopyGC発生

Full GC

FullGC発生

Reclaim

Explicitメモリブロックの明示解放処理

Reclaiming

Explicitメモリブロックの明示解放処理中のJavaヒープあふれ

New

Explicitメモリブロックへのオブジェクト生成

Migrate

Explicitメモリブロックの自動解放処理

Migrating

Explicitメモリブロックの自動解放処理中のJavaヒープあふれ

ただし，一部のログでは，<CAUSE>が出力されません。

(2)　ログの接頭語を使用した調査方法

[ENS]，[EVO]などのログの接頭語は，ログをフィルタリングして調査するために利用できます。

明示管理ヒープ機能の接頭語の意味は次のとおりです。

1文字目の"E"は，明示管理ヒープ機能のログであることを示します。

2文字目は，ログ出力レベルを示します。normalレベルの場合は「N」，verboseレベルの場合は「V」，debugレベルの場合は「D」が出力されます。

3文字目は，ExplicitヒープまたはJavaヒープのメモリサイズが変化するかどうかを示します。「S」の場合はメモリサイズが変化します。「O」の場合は変化しません。「O」の場合，ログには発生したイベントの名称も出力されます。また，「A」の場合は明示管理ヒープ自動配置設定ファイルのログであることを示します。

例えば，各ヒープサイズの変化を調査したい場合に「S」でフィルタリングしたり，発生したイベントを調査したい場合に「O」でフィルタリングしたりできます。

(3)　イベントログの出力形式の説明で使用する記号

出力形式の説明で使用する記号を次の表に示します。

表5‒31　出力形式の説明で使用する記号

記号

使用例

意味

*

X*

左辺を0回以上繰り返します。

使用例の場合，Xを0回以上繰り返すことを意味します。

?

X?

左辺を1回以上繰り返します。

使用例の場合，Xを1回以上繰り返すことを意味します。

{n,m}

X{1,5}

左辺をn回以上m回以下繰り返します。

使用例の場合，Xを1回以上5回以下繰り返すことを意味します。

{

{ABC}*

"{"と"}"で囲まれた範囲を"*"，"?"，"{n,m}"の左辺の参照単位にします。

使用例の場合，"ABC"を0回以上繰り返すことを意味します。

}

¥

なし

マニュアル上では見やすさのために改行した個所を示します。

実際の出力内容に改行は入りません。

|

X|Y

左辺または右辺を表します。

使用例の場合，XまたはYを意味します。

.

なし

任意の文字を示します。

...

X|Y...

この行の前方直近の同一インデントの行から，この行前の行までを1回以上繰り返します。

使用例の場合，XまたはYの行を1回以上繰り返すことを意味します。

また，出力形式の説明では，数値などを表5-32で示した記号に表5-33で示す記号を組み合わせて表します。

数値などを表すときに使用する記号を次の表に示します。

表5‒32　数値などを表すときに使用する記号

記号

定義

意味

<digit>

0|1|2|3|4|5|6|7|8|9

0〜9を表します。

<hex>

<digit>|a|b|c|d|e|f

16進数を表します。

<const>

<const><digit>|<digit>

正の自然数を表します。

<decimal>

<const>.<digit>

正の整数（小数点第1位まで）を表します。

<ptr64>

0x<hex><hex><hex><hex><hex><hex><hex><hex><hex><hex><hex><hex><hex><hex><hex><hex>

64ビットポインタ値を表します。

<ptr32>

0x<hex><hex><hex><hex><hex><hex><hex><hex>

32ビットポインタ値を表します。

<ptr>

<ptr64>|<ptr32>

ポインタ値を表します。

<letters>

.?

任意の文字または任意の文字列を表します。

注　この表で示す記号は，"*"，"?"または"|"の左辺または右辺の参照単位になります。例えば，「<digit>|<hex>」と表記されている場合は，0〜9の数値，または16進数であることを意味します。

5.11.3　出力レベルがnormalの場合に出力される内容

ここでは，ログ出力レベルにnormalを指定した場合に出力される内容をイベントごとに説明します。

normalは，通常運用時に指定するログ出力レベルです。

(1)　GC発生（Explicitヒープ利用状況出力）

GC発生時に，Explicitヒープの利用状況が出力されます。

このログは，JavaヒープからExplicitヒープに移動するオブジェクトがない場合にも出力されます。Explicitヒープに移動するオブジェクトがない場合，<EH_USED_BF>と<EH_USED_AF>は同じ値になります。

(a)　出力の契機

GCの終了です。

(b)　出力形式

[ENS]<ctime>[EH: <EH_USED_BF>-><EH_USED_AF>(<EH_TOTAL>/<EH_MAX>)][E/F/D: <AC_NUM>/<FL_NUM>/<DA_NUM>][cause:<CAUSE>][CF: <CF_CNT>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒33　出力項目（GC発生（Explicitヒープ利用状況出力））

出力項目

出力内容

意味

<ctime>

<letters>

GCの発生日時を示します。拡張verbosegc情報と同じ形式で出力されます。

-XX:+HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EH_USED_BF>

<const>K

GCが実行される前のExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_USED_AF>

<const>K

GCが実行されたあとのExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_TOTAL>

<const>K

GCが実行されたあとのExplicitヒープの確保済みメモリサイズが出力されます。単位はキロバイトです。

<EH_MAX>

<const>K

Explicitヒープ最大サイズが出力されます。単位はキロバイトです。

<AC_NUM>

<const>

GC実行後にサブ状態がEnableであるExplicitメモリブロックの数が出力されます。

<FL_NUM>

<const>

常に0が出力されます。

<DA_NUM>

<const>

GC実行後にサブ状態がDisableであるExplicitメモリブロックの数が出力されます。

<CAUSE>

GC|Full GC

契機となったGCの種類が出力されます。

"GC"はCopyGC，"Full GC"はFullGCを示します。

<CF_CNT>

<const>

前回のGCが発生してから今回のGCが発生するまでの間にExplicitメモリブロックの初期化に失敗した回数が出力されます。

(d)　出力例

出力例を示します。

[ENS]<Thu Oct 21 14:55:50 2007>[EH: 150528K->162816K(162816K/1048576K)][E/F/D: 200/0/0][cause:GC][CF: 0]

この出力例では次の内容が確認できます。

出力契機は2007年10月21日(木)14時55分50秒に発生したCopyGCです。

GCでExplicitヒープへの移動が発生して，Explicitヒープの利用済みサイズが150,528Kから162,816Kに変化しました。

GC発生後のExplicitヒープの確保済みサイズは162,816Kです。Explicitヒープの最大サイズは1,048,576Kです。

GC発生後，サブ状態がEnableであるExplicitメモリブロックは200個あります。

(2)　Explicitメモリブロックの明示解放処理

Explicitメモリブロックの明示解放処理終了後に，ExplicitヒープおよびJavaヒープの利用状況が出力されます。

(a)　出力の契機

Explicitメモリブロックの明示解放処理です。

Explicitメモリブロックの明示解放は，GC直後に発生します。このため，ここで示すログは，「(1)　GC発生（Explicitヒープ利用状況出力）」で示したログのあとに出力されます。

(b)　出力形式

[ENS]<ctime>[EH: <EH_USED_BF>-><EH_USED_AF>(<EH_TOTAL>/<EH_MAX>), <ELAPSED> secs][E/F/D: <AC_NUM>/<FL_NUM>/<DA_NUM>]¥
[DefNew::Eden: <ED_USED_BF>-><ED_USED_AF>(<ED_TOTAL>)][DefNew::Survivor: <SV_USED_BF>-><SV_USED_AF>(<SV_TOTAL>)]¥
[Tenured: <TN_USED_BF>-><TN_USED_AF>(<TN_TOTAL>)][User: <USERCPU> secs][Sys: <SYSCPU> secs][cause:<CAUSE>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒34　出力項目（Explicitメモリブロックの明示解放処理）

出力項目

出力内容

意味

<ctime>

<letters>

Explicitメモリブロックの明示解放処理の発生日時を示します。拡張verbosegc情報と同じ形式で出力されます。

-XX:+HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EH_USED_BF>

<const>K

Explicitメモリブロックの明示解放処理前のExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_USED_AF>

<const>K

Explicitメモリブロックの明示解放処理後のExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_TOTAL>

<const>K

Explicitメモリブロックの明示解放処理後のExplicitヒープの確保済みサイズが出力されます。単位はキロバイトです。

<EH_MAX>

<const>K

Explicitヒープ最大サイズが出力されます。単位はキロバイトです。

<ELAPSED>

<time>

Explicitメモリブロックの明示解放処理に掛かった時間が出力されます。単位は秒です。

<AC_NUM>

<const>

Explicitメモリブロックの明示解放処理実行後にサブ状態がEnableであるExplicitメモリブロックの数が出力されます。

<FL_NUM>

<const>

常に0が出力されます。

<DA_NUM>

<const>

Explicitメモリブロックの明示解放処理実行後にサブ状態がDisableであるExplicitメモリブロックの数が出力されます。

<ED_USED_BF>

<const>K

Explicitメモリブロックの明示解放処理実行前のEden領域の利用済みサイズが出力されます。単位はキロバイトです。

<ED_USED_AF>

<const>K

Explicitメモリブロックの明示解放処理実行後のEden領域の利用済みサイズが出力されます。単位はキロバイトです。

<ED_TOTAL>

<const>K

Explicitメモリブロックの明示解放処理実行後のEden領域の確保済みサイズが出力されます。単位はキロバイトです。

<SV_USED_BF>

<const>K

Explicitメモリブロックの明示解放処理実行前のSurvivor領域の利用済みサイズが出力されます。単位はキロバイトです。

<SV_USED_AF>

<const>K

Explicitメモリブロックの明示解放処理実行後のSurvivor領域の利用済みサイズが出力されます。単位はキロバイトです。

<SV_TOTAL>

<const>K

Explicitメモリブロックの明示解放処理実行後のSurvivor領域の確保済みサイズが出力されます。単位はキロバイトです。

<TN_USED_BF>

<const>K

Explicitメモリブロックの明示解放処理実行前のTenured領域の利用済みサイズが出力されます。単位はキロバイトです。

<TN_USED_AF>

<const>K

Explicitメモリブロックの明示解放処理実行後のTenured領域の利用済みサイズが出力されます。単位はキロバイトです。

<TN_TOTAL>

<const>K

Explicitメモリブロックの明示解放処理実行後のTenured領域の確保済みサイズが出力されます。単位はキロバイトです。

<USERCPU>

<time>

Explicitメモリブロックの明示解放処理に掛かったユーザCPU時間が出力されます。単位は秒です。

<SYSCPU>

<time>

Explicitメモリブロックの明示解放処理に掛かったシステムCPU時間が出力されます。単位は秒です。

<CAUSE>

Reclaim

"Reclaim"と出力されます。Explicitメモリブロックの明示解放処理によって出力されたログであることを示します。

(d)　出力例

出力例を示します。

[ENS]<Tue Jul 24 01:23:51 2007>[EH: 150528K->149528K(162816K/1048576K), 0.1129602 secs][E/F/D: 523/0/0]¥
[DefNew::Eden: 0K->0K(243600K)][DefNew::Survivor: 0K->0K(17400K)][Tenured: 103400K->103400K(556800K)]¥
[User: 0.0900000 secs][Sys: 0.0200000 secs][cause:Reclaim]

この出力例では次の内容が確認できます。

出力契機は2007年7月24日(火)1時23分51秒に発生したExplicitメモリブロックの明示解放処理です。

Explicitメモリブロックの明示解放処理によって，Explicitヒープ利用済みサイズが150,528Kから149,528Kに減少しました。

Explicitメモリブロックの明示解放処理後のExplicitヒープの確保済みサイズは162,816Kです。Explicitヒープの最大サイズは1,048,576Kです。

Explicitメモリブロックの明示解放処理に，0.1129602秒掛かりました。

Explicitメモリブロックの明示解放処理後，サブ状態がEnableであるExplicitメモリブロックは523個あります。

Explicitメモリブロックの明示解放処理によるJavaヒープの各領域の変化はありません。つまり，Javaヒープに移動したオブジェクトはありません。

Explicitメモリブロックの明示解放処理に，ユーザCPU時間が0.0900000秒，システムCPU時間が0.0200000秒掛かりました。

(3)　Explicitメモリブロックの明示解放処理時のJavaヒープあふれ

Explicitメモリブロックの明示解放処理時にJavaヒープへのオブジェクトの移動が発生し，Javaヒープがあふれた場合に出力されます。あふれた時点でのExplicitヒープおよびJavaヒープの利用状況が出力されます。

(a)　出力の契機

Explicitメモリブロックの明示解放処理時にExplicitヒープからJavaヒープへのオブジェクトの移動が発生し，Javaヒープがあふれた場合です。

(b)　出力形式

[ENS]<ctime>[EH: <EH_USED_BF>-><EH_USED_AF>(<EM_TOTAL>/<EH_MAX>), <ELAPSED> secs][E/F/D: <AC_NUM>/<FL_NUM>/<DA_NUM>]¥
[DefNew::Eden: <ED_USED_BF>-><ED_USED_AF>(<ED_TOTAL>)][DefNew::Survivor: <SV_USED_BF>-><SV_USED_AF>(<SV_TOTAL>)]¥
[Tenured: <TN_USED_BF>-><TN_USED_AF>(<TN_TOTAL>)][User: <USERCPU> secs][Sys: <SYSCPU> secs][cause:<CAUSE>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒35　出力項目（Explicitメモリブロックの明示解放処理時のJavaヒープあふれ）

出力項目

出力内容

意味

<ctime>

<letters>

Explicitメモリブロックの明示解放処理の発生日時を示します。拡張verbosegc情報と同じ形式で出力されます。

-XX:+HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EH_USED_BF>

<const>K

Explicitメモリブロックの明示解放処理前のExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_USED_AF>

<const>K

JavaヒープがあふれたあとのExplicitヒープの利用済みサイズが出力されます。Javaヒープがあふれた場合は，Explicitメモリブロックの明示解放処理が実行されないため，必ず<EH_USED_BF>と同じ値になります。単位はキロバイトです。

<EH_TOTAL>

<const>K

JavaヒープがあふれたあとのExplicitヒープの確保済みサイズが出力されます。単位はキロバイトです。

<EH_MAX>

<const>K

Explicitヒープ最大サイズが出力されます。単位はキロバイトです。

<ELAPSED>

<time>

Explicitメモリブロックの明示解放処理開始から，Javaヒープがあふれるまでの時間が出力されます。単位は秒です。

<AC_NUM>

<const>

Javaヒープがあふれたあとでサブ状態がEnableであるExplicitメモリブロックの数が出力されます。

<FL_NUM>

<const>

常に0が出力されます。

<DA_NUM>

<const>

Javaヒープがあふれたあとでサブ状態がDisableであるExplicitメモリブロックの数が出力されます。

<ED_USED_BF>

<const>K

Explicitメモリブロックの明示解放処理実行前のEden領域の利用済みサイズが出力されます。単位はキロバイトです。

<ED_USED_AF>

<const>K

JavaヒープがあふれたあとのEden領域の利用済みサイズが出力されます。単位はキロバイトです。

<ED_TOTAL>

<const>K

JavaヒープがあふれたあとのEden領域の確保済みサイズが出力されます。単位はキロバイトです。

<SV_USED_BF>

<const>K

Explicitメモリブロックの明示解放処理実行前のSurvivor領域の利用済みサイズが出力されます。単位はキロバイトです。

<SV_USED_AF>

<const>K

JavaヒープがあふれたあとのSurvivor領域の利用済みサイズが出力されます。単位はキロバイトです。

<SV_TOTAL>

<const>K

JavaヒープがあふれたあとのSurvivor領域の確保済みサイズが出力されます。単位はキロバイトです。

<TN_USED_BF>

<const>K

Explicitメモリブロックの明示解放処理実行前のTenured領域の利用済みサイズが出力されます。単位はキロバイトです。

<TN_USED_AF>

<const>K

JavaヒープがあふれたあとのTenured領域の利用済みサイズが出力されます。単位はキロバイトです。

<TN_TOTAL>

<const>K

JavaヒープがあふれたあとのTenured領域の確保済みサイズが出力されます。単位はキロバイトです。

<USERCPU>

<time>

Explicitメモリブロックの明示解放処理開始から，JavaヒープがあふれるまでのユーザCPU時間が出力されます。単位は秒です。

<SYSCPU>

<time>

Explicitメモリブロックの明示解放処理開始から，JavaヒープがあふれるまでのシステムCPU時間が出力されます。単位は秒です。

<CAUSE>

Reclaiming

"Reclaiming"と出力されます。Explicitメモリブロックの明示解放処理時のJavaヒープあふれによって出力されたログであることを示します。

(d)　出力例

出力例を示します。

[ENS]<Tue Jul 24 01:23:51 2007>[EH: 706728K->706728K(706728K/1048576K), 0.1129602 secs][E/F/D: 523/0/0]¥
[DefNew::Eden: 0K->243600K(243600K)][DefNew::Survivor: 0K->17400K(17400K)][Tenured: 278000K->556800K(556800K)]¥
[User: 0.0900000 secs][Sys: 0.0200000 secs][cause:Reclaiming]
[ENS]<Tue Jul 24 01:23:51 2007>[EH: 706728K->706728K(706728K/1048576K)][E/F/D: 523/0/0][cause:Full GC][CF: 0]
[ENS]<Tue Jul 24 01:23:53 2007>[EH: 706728K->148528K(148528K/1048576K), 0.0123405 secs][E/F/D: 521/0/0]¥
[DefNew::Eden: 0K->0K(243600K)][DefNew::Survivor: 0K->0K(17400K)][Tenured: 551800K->552800K(556800K)]¥
[User: 0.0090000 secs][Sys: 0.0020000 secs][cause:Reclaim]

この出力例では次の内容が確認できます。

出力契機は2007年7月24日(火)1時23分51秒に発生したExplicitメモリブロックの明示解放処理でのJavaヒープあふれです。

Explicitメモリブロックの明示解放処理開始からJavaヒープがあふれるまでに，0.1129602秒掛かりました。

Javaヒープがあふれたあとでサブ状態がEnableであるExplicitメモリブロックは523個あります。

Explicitメモリブロックの明示解放処理によって，5,398,00KがJavaヒープに移動したため，Javaヒープがあふれました。

Explicitメモリブロックの明示解放処理開始からJavaヒープがあふれるまでに，ユーザCPU時間が0.0900000秒，システムCPU時間が0.020000秒掛かりました。

また，出力例の3行目の[ENS]以降の出力内容は，Explicitメモリブロックの明示解放処理によって出力されたログです。Javaヒープあふれによって出力されたログのあとには，必ずExplicitメモリブロックの明示解放処理によってログが出力されます。この例では，次の内容が出力されています。

2007年7月24日(火)1時23分53秒にExplicitメモリブロックの明示解放処理を再開して，このログを出力しました。

再開したExplicitメモリブロックの明示解放処理によって，Explicitヒープの利用済みサイズが706,728Kから148,528Kに減少しました。

再開したExplicitメモリブロックの明示解放処理を実行したあとでのExplicitヒープの確保済みサイズは148,528Kです。Explicitヒープの最大サイズは1,048,576Kです。

再開したExplicitメモリブロックの明示解放処理に，0.0123405秒掛かりました。

再開したExplicitメモリブロックの明示解放処理後，サブ状態がEnableであるExplicitメモリブロックは521個あります。

再開したExplicitメモリブロックの明示解放処理によって，JavaヒープのTenured領域の使用サイズが，551,800Kから552,800Kに増加しました。

再開したExplicitメモリブロックの明示解放処理に，ユーザCPU時間が0.0090000秒，システムCPU時間が0.0020000秒掛かりました。

(4)　Explicitメモリブロックの自動解放処理

Explicitメモリブロックの自動解放自動予約または自動解放明示予約から，Explicitメモリブロックの自動解放処理までの，ExplicitヒープおよびExplicitメモリブロックの利用状況が出力されます。

(a)　出力の契機

Explicitメモリブロックの自動解放自動予約，自動解放明示予約，およびExplicitメモリブロックの自動解放処理が起きた場合です。

(b)　出力形式

[ENS]<ctime>[EH: <EH_USED_BF>-><EH_USED_AF>(<EH_TOTAL>/<EH_MAX>), <ELAPSED> secs][E/F/D: <AC_NUM>/<FL_NUM>/<DA_NUM>]¥
[DefNew::Eden: <ED_USED_BF>-><ED_USED_AF>(<ED_TOTAL>)]
[DefNew::Survivor: <SV_USED_BF>-><SV_USED_AF>(<SV_TOTAL>)]¥
[Tenured: <TN_USED_BF>-><TN_USED_AF>(<TN_TOTAL>)][target:<EH_MIG_TRG>/<EH_MIG_DED>/<EH_MIG_LIV>]¥
[User: <USERCPU> secs][Sys: <SYSCPU> secs][cause:<CAUSE>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒36　出力項目（Explicitメモリブロックの自動解放処理）

出力項目

出力内容

意味

<ctime>

<letters>

Explicitメモリブロックの自動解放自動予約が発生した日時を示します。拡張verboseGC機能で出力しているものと同一の時刻形式で出力されます。HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EH_USED_BF>

<const>K

Explicitメモリブロックの自動解放処理前のExplicitヒープ利用済みサイズが出力されます。単位はキロバイトです。

<EH_USED_AF>

<const>K

Explicitメモリブロックの自動解放処理後のExplicitヒープ利用済みサイズが出力されます。単位はキロバイトです。

<EH_TOTAL>

<const>K

Explicitメモリブロックの自動解放処理後の確保済みExplicitヒープサイズが出力されます。単位はキロバイトです。

<EH_MAX>

<const>K

Explicitヒープ最大サイズが出力されます。単位はキロバイトです。

<ELAPSED>

<time>

Explicitメモリブロックの自動解放自動予約の処理の開始から，自動解放処理終了までの時間が出力されます。単位は秒です。

<AC_NUM>

<const>

Explicitメモリブロックの自動解放処理後の，サブ状態がEnableである有効なExplicitメモリブロックの数が出力されます。

<FL_NUM>

<const>

常に0が出力されます。

<DA_NUM>

<const>

Explicitメモリブロックの自動解放処理後の，サブ状態がDisableであるExplicitメモリブロックの数が出力されます。

<ED_USED_BF>

<const>K

Explicitメモリブロックの自動解放処理前の，Eden領域利用済みサイズが出力されます。単位はキロバイトです。

<ED_USED_AF>

<const>K

Explicitメモリブロックの自動解放処理後の，Eden領域利用済みサイズが出力されます。単位はキロバイトです。

<ED_TOTAL>

<const>K

Explicitメモリブロックの自動解放処理後の，Eden領域確保済みサイズが出力されます。単位はキロバイトです。

<SV_USED_BF>

<const>K

Explicitメモリブロックの自動解放処理前の，Survivor領域利用済みサイズが出力されます。単位はキロバイトです。

<SV_USED_AF>

<const>K

Explicitメモリブロックの自動解放処理後の，Survivor領域利用済みサイズが出力されます。単位はキロバイトです。

<SV_TOTAL>

<const>K

Explicitメモリブロックの自動解放処理後の，Survivor領域確保済みサイズが出力されます。単位はキロバイトです。

<TN_USED_BF>

<const>K

Explicitメモリブロックの自動解放処理前の，Tenured領域利用済みサイズが出力されます。単位はキロバイトです。

<TN_USED_AF>

<const>K

Explicitメモリブロックの自動解放処理後の，Tenured領域利用済みサイズが出力されます。単位はキロバイトです。

<TN_TOTAL>

<const>K

Explicitメモリブロックの自動解放処理後の，Tenured領域確保済みサイズが出力されます。単位はキロバイトです。

<EH_MIG_TRG>

<const>K

Explicitメモリブロックの自動解放処理をしたExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_MIG_DED>

<const>K

Explicitメモリブロックの自動解放処理をしたことによって減少した，Explicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_MIG_LIV>

<const>K

Explicitメモリブロックの自動解放処理をしても減少しなかった，Explicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<USERCPU>

<time>

Explicitメモリブロックの自動解放自動予約の処理の開始から，自動解放処理終了までのユーザCPU時間が出力されます。単位は秒です。

<SYSCPU>

<time>

Explicitメモリブロックの自動解放自動予約の処理の開始から，自動解放処理終了までのシステムCPU時間が出力されます。単位は秒です。

<CAUSE>

Migrate

"Migrate"が出力されます。Explicitメモリブロックの自動解放処理によって出力されたログであることを示します。

(d)　出力例

出力例を示します。

[ENS]<Tue Jul 14 02:31:22 2009>[EH: 256512K->256128K(256256K/1048576K), 0.1124626 secs][E/F/D: 423/0/0]¥
[DefNew::Eden: 0K->0K(243600K)][DefNew::Survivor: 0K->0K(17400K)][Tenured: 103400K->103400K(556800K)][target:584K/384K/200K]¥
[User: 0.0900000 secs][Sys: 0.0200000 secs][cause:Migrate]

この出力例では次の内容が確認できます。

出力契機は2009年7月14日（火）2時31分22秒に発生したGCでのExplicitメモリブロックの自動解放処理です。

自動解放処理によってExplicitヒープの利用済みサイズが256,512Kから256,128Kに変化しました。

自動解放処理後のExplicitヒープの確保済みサイズは256,256K，最大サイズは1,048,576Kです。

自動解放処理に，0.1124626秒掛かりました。

自動解放処理後の，サブ状態がEnableであるExplicitメモリブロックは423個です。

自動解放処理によって，Explicitヒープの利用済みサイズのうち584Kに対して自動解放が行われました。減少したサイズは384K，減少しなかったサイズは200Kでした。

Explicitメモリブロックの自動解放処理による，Javaヒープ各領域の変化はありませんでした。

自動解放処理に，ユーザCPU時間が0.0900000秒，システムCPU時間が0.0200000秒掛かりました。

(5)　Explicitメモリブロックの自動解放処理時のJavaヒープあふれ

Explicitメモリブロックの自動解放処理時には，Javaヒープへのオブジェクトの移動が発生します。このとき，Javaヒープがあふれた場合には，その時点でのExplicitヒープおよびJavaヒープの利用状況が出力されます。

Javaヒープがあふれた場合とは，Javaヒープへのオブジェクト移動時にJavaヒープに空き領域がなかった場合を指します。詳細については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「7.　明示管理ヒープ機能を使用したFullGCの抑止」を参照してください。

(a)　出力の契機

Explicitメモリブロックの自動解放処理中に，Explicitヒープ領域の空き領域が不足すると，Javaヒープへのオブジェクトの移動が発生します。このとき，Javaヒープがあふれた場合です。

(b)　出力形式

[ENS]<ctime>[EH: <EH_USED_BF>-><EH_USED_AF>(<EH_TOTAL>/<EH_MAX>), <ELAPSED> secs][E/F/D: <AC_NUM>/<FL_NUM>/<DA_NUM>]¥
[DefNew::Eden: <ED_USED_BF>-><ED_USED_AF>(<ED_TOTAL>)]
[DefNew::Survivor: <SV_USED_BF>-><SV_USED_AF>(<SV_TOTAL>)]¥
[Tenured: <TN_USED_BF>-><TN_USED_AF>(<TN_TOTAL>)][target:<EH_MIG_TRG>/<EH_MIG_DED>/<EH_MIG_LIV>]¥
[User: <USERCPU> secs][Sys: <SYSCPU> secs][cause:<CAUSE>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒37　出力項目（Explicitメモリブロックの自動解放処理時のJavaヒープあふれ）

出力項目

出力内容

意味

<ctime>

<letters>

Explicitメモリブロックの自動解放処理が発生した日時を示します。拡張verboseGC機能で出力しているものと同一の時刻形式で出力されます。HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EH_USED_BF>

<const>K

Explicitメモリブロックの自動解放処理前のExplicitヒープ利用済みサイズが出力されます。単位はキロバイトです。

<EH_USED_AF>

<const>K

JavaヒープがあふれたあとのExplicitヒープ利用済みサイズが出力されます。単位はキロバイトです。

<EH_TOTAL>

<const>K

Javaヒープがあふれたあとの確保済みExplicitヒープサイズが出力されます。単位はキロバイトです。

<EH_MAX>

<const>K

Explicitヒープ最大サイズが出力されます。単位はキロバイトです。

<ELAPSED>

<time>

Explicitメモリブロックの自動解放処理開始から，Javaヒープがあふれるまでの時間が出力されます。単位は秒です。

<AC_NUM>

<const>

Explicitメモリブロックの自動解放処理後の，サブ状態がEnableであるExplicitメモリブロックの数が出力されます。

<FL_NUM>

<const>

常に0が出力されます。

<DA_NUM>

<const>

Javaヒープがあふれたあとの，サブ状態がDisableであるExplicitメモリブロックの数が出力されます。

<ED_USED_BF>

<const>K

Explicitメモリブロックの自動解放処理前の，Eden領域利用済みサイズが出力されます。単位はキロバイトです。

<ED_USED_AF>

<const>K

JavaヒープがあふれたあとのEden領域利用済みサイズが出力されます。単位はキロバイトです。

<ED_TOTAL>

<const>K

JavaヒープがあふれたあとのEden領域確保済みサイズが出力されます。単位はキロバイトです。

<SV_USED_BF>

<const>K

Explicitメモリブロックの自動解放処理前のSurvivor領域利用済みサイズが出力されます。単位はキロバイトです。

<SV_USED_AF>

<const>K

JavaヒープがあふれたあとのSurvivor領域利用済みサイズが出力されます。単位はキロバイトです。

<SV_TOTAL>

<const>K

JavaヒープがあふれたあとのSurvivor領域確保済みサイズが出力されます。単位はキロバイトです。

<TN_USED_BF>

<const>K

Explicitメモリブロックの自動解放処理前のTenured領域利用済みサイズが出力されます。単位はキロバイトです。

<TN_USED_AF>

<const>K

JavaヒープがあふれたあとのTenured領域利用済みサイズが出力されます。単位はキロバイトです。

<TN_TOTAL>

<const>K

JavaヒープがあふれたあとのTenured領域確保済みサイズが出力されます。単位はキロバイトです。

<EH_MIG_TRG>

<const>K

Explicitメモリブロックの自動解放処理をしたExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_MIG_DED>

<const>K

Javaヒープがあふれる前までにExplicitメモリブロックの自動解放処理によって減少した，Explicitヒープの利用済みサイズが出力されます。単位はキロバイトです。常にOKが出力されます。

<EH_MIG_LIV>

<const>K

Javaヒープがあふれる前までにExplicitメモリブロックの自動解放処理によって減少しなかった，Explicitヒープの利用済みサイズが出力されます。単位はキロバイトです。Javaヒープあふれの発生原因となったオブジェクトのサイズは含みません。

<USERCPU>

<time>

Explicitメモリブロックの自動解放処理開始から，JavaヒープがあふれるまでのユーザCPU時間が出力されます。単位は秒です。

<SYSCPU>

<time>

Explicitメモリブロックの自動解放処理開始から，JavaヒープがあふれるまでのシステムCPU時間が出力されます。単位は秒です。

<CAUSE>

Migrating

"Migrating"が出力されます。Explicitメモリブロックの自動解放処理時のJavaヒープあふれによって出力されたログであることを示します。

(d)　出力例

出力例を示します。

[ENS]<Tue Jul 14 02:31:22 2009>[EH: 706728K->706728K(706728K/706728K), 0.1129602 secs][E/F/D: 522/0/1]¥
[DefNew::Eden: 0K->243600K(243600K)][DefNew::Survivor: 0K->17400K(17400K)][Tenured: 278000K->556800K(556800K)]¥
[target:372000K/0K/339800K] [User: 0.0900000 secs][Sys: 0.0200000 secs][cause:Migrating]

この出力例では次の内容が確認できます。

出力契機は2009年7月14日(火)2時31分22秒に発生したGCでのExplicitメモリブロックの自動解放処理時のJavaヒープあふれです。

自動解放処理によってExplicitヒープの利用済みサイズが706,728Kから変化ありません。

自動解放処理後のExplicitヒープの確保済みサイズは706,728K，最大サイズは706,728Kです。

自動解放処理に，0.1129602秒掛かりました。

自動解放処理後の，サブ状態がEnableであるExplicitメモリブロックは522個です。サブ状態がDisableであるExplicitメモリブロックは1個です。

自動解放処理によって，Explicitヒープの利用済みサイズのうち372,000Kに対して自動解放が実行されました。Javaヒープあふれの時点までに339,800Kが減少しませんでした。

自動解放処理時のJavaヒープあふれによって，Javaヒープの利用済みサイズが各領域の上限に到達しました。

Explicitメモリブロックの自動解放処理開始からJavaヒープがあふれるまでに，ユーザCPU時間が0.0900000秒，システムCPU時間が0.0200000秒掛かりました。

(6)　明示管理ヒープ自動配置設定ファイルオープンエラー

明示管理ヒープ自動配置設定ファイルのオープンや読み込みに失敗した場合，エラーメッセージが出力されます。

(a)　出力の契機

明示管理ヒープ自動配置設定ファイルのオープンや読み込みに失敗した場合です。例えば，ファイルが存在しない場合，ファイルの読み込み権限がない場合，ファイル読み込み中に予期しないIOエラーが発生した場合があります。

(b)　出力形式

[ENA]<ctime> failed to open file. [file=<FILENAME>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒38　出力項目（明示管理ヒープ自動配置設定ファイルオープンエラー）

出力項目

出力内容

意味

<ctime>

<letters>

明示管理ヒープ自動配置設定ファイルのオープンに失敗した日時を示します。拡張VerboseGC機能で出力しているものと同一の時刻形式で出力されます。HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力します。

<FILENAME>

<letters>

ファイルのオープンに失敗した自動配置設定ファイルの名前が出力されます（ディレクトリ名を含みません）。

(d)　出力例

出力例を示します。

[ENA]<Tue Jul 24 01:23:51 2007> failed to open file. [file=usrexmem.cfg]

この出力例では次の内容が確認できます。

2007年7月24日(火)1時23分51秒に，明示管理ヒープ自動配置設定ファイルのオープンに失敗しました。

(7)　明示管理ヒープ自動配置設定ファイルパースエラー

明示管理ヒープ自動配置設定ファイルのパースに失敗した行がある場合，エラーメッセージが出力されます。

(a)　出力の契機

明示管理ヒープ自動配置設定ファイルのパースに失敗した行がある場合です。ファイルの複数行で記述フォーマットエラーがある場合，複数回ログ出力されます。

(b)　出力形式

[ENA]<ctime> parsed error line. [file=<FILENAME> line=<LINENO>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒39　出力項目（明示管理ヒープ自動配置設定ファイルパースエラー）

出力項目

出力内容

意味

<ctime>

<letters>

明示管理ヒープ機能自動配置設定ファイルのパースに失敗した日時を示します。拡張verboseGC機能で出力しているものと同一の時刻形式で出力されます。HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<FILENAME>

<letters>

ファイルのパースに失敗した自動配置設定ファイルの名前が出力されます（ディレクトリ名を含みません）。

<LINENO>

<const>

パースに失敗した行数が出力されます。

(d)　出力例

出力例を示します。

[ENA]<Tue Jul 24 01:23:51 2007> parsed error line. [file=usrexmem.cfg line=25]

この出力例では次の内容が確認できます。

2007年7月24日(火)1時23分51秒に，明示管理ヒープ機能自動配置設定ファイルのパースに25行目で失敗しました。

(8)　明示管理ヒープ自動配置エラー

明示管理ヒープ機能によって指定したクラスが，明示管理ヒープへの自動配置に失敗した場合，エラーメッセージが出力されます。

(a)　出力の契機

明示管理ヒープ機能によって指定したクラスが，明示管理ヒープへの自動配置に失敗した場合です。

(b)　出力形式

[ENA]<ctime> creation <CLASS_LIST> class's object in explicit memory is failed. [target=<CLASS_METHOD> ¥
detail=<MESSAGE>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒40　出力項目（明示管理ヒープ自動配置エラー）

出力項目

出力内容

意味

<ctime>

<letters>

明示管理ヒープ上への自動配置に失敗した日時を示します。拡張VerboseGC機能で出力しているものと同一の時刻形式で出力されます。HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<CLASS_LIST>

<letters>

明示管理ヒープ上への自動配置しようとしたオブジェクトの完全限定クラス名のリストが出力されます。リストが空の場合があります。

<CLASS_METHOD>

<letters>

明示管理ヒープ上への自動配置に失敗したクラスの完全限定名が出力されます。より詳細な失敗個所を示すメソッド名も出力されることがあります。

<MESSAGE>

<letters>

明示管理ヒープ上への自動配置に失敗した原因を示す詳細メッセージが出力されます。

(d)　出力例

出力例を示します。

[ENA]<Tue Jul 24 01:23:51 2007> creation java.util.HashMap, java.util.LinkedList ¥
class's object in explicit memory is failed. [target=com.sample.MainClass.main ¥
detail=Invalid class file format. (max_stack = 65536, max = 65535, min = 0)]

この出力例では次の内容が確認できます。

2007年7月24日(火)1時23分51秒に，明示管理ヒープ機能がクラスjp.co.sample.Mainの明示管理ヒープ上への自動配置に失敗しました。

(9)　明示管理ヒープ機能適用除外クラス指定機能の設定ファイルオープンエラー

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルのオープンや読み込みに失敗した場合，エラーメッセージが出力されます。

(a)　出力の契機

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルのオープンや読み込みに失敗した場合です。例えば，ファイルが存在しない場合，ファイルの読み込み権限がない場合，ファイル読み込み中に予期しないIOエラーが発生した場合があります。

(b)　出力形式

[ENO]<ctime> failed to open file. [<TYPE>] [file=<FILENAME>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒41　出力項目（明示管理ヒープ機能適用除外クラス指定機能の設定ファイルオープンエラー）

出力項目

出力内容

意味

<ctime>

<letters>

設定ファイルのオープンに失敗した日時を示します。拡張VerboseGC機能で出力しているものと同一の時刻形式で出力されます。HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力します。

<TYPE>

SYS|USR|DEF

ファイルのオープンや読み込みに失敗した設定ファイルの種類が出力されます。

"SYS"はシステムで提供している設定ファイル，"USR"はJavaVM起動オプションで指定したファイルパスの設定ファイル，"DEF"はJavaVM起動オプションのデフォルトのファイルパスにある設定ファイルを示します。

<FILENAME>

<letters>

ファイルのオープンに失敗した設定ファイルの名前が出力されます（ディレクトリ名を含みません）。

(d)　出力例

出力例を示します。

[ENO]<Fri Aug 10 17:41:51 2012> failed to open file. [USR] [file=javamove.cfg]

この出力例では次の内容が確認できます。

2012年8月10日(金)17時41分51秒に，JavaVM起動オプションで指定したファイルパスの設定ファイルのオープンに失敗しました。

(10)　明示管理ヒープ機能適用除外クラス指定機能の設定ファイルパースエラー

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルのパースに失敗した行がある場合，エラーメッセージが出力されます。

(a)　出力の契機

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルのパースに失敗した行がある場合です。ファイルの複数行で記述フォーマットエラーがある場合，複数回ログ出力されます。

(b)　出力形式

[ENO]<ctime> parsed error line. [TYPE] [file=<FILENAME> line=<LINENO>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒42　出力項目（明示管理ヒープ自動配置設定ファイルパースエラー）

出力項目

出力内容

意味

<ctime>

<letters>

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルのパースに失敗した日時を示します。拡張verboseGC機能で出力しているものと同一の時刻形式で出力されます。HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<TYPE>

SYS|USR|DEF

ファイルのパースに失敗した設定ファイルの種類が出力されます。

"SYS"はシステムで提供している設定ファイル，"USR"はJavaVM起動オプションで指定したファイルパスの設定ファイル，"DEF"はJavaVM起動オプションのデフォルトのファイルパスにある設定ファイルを示します。

<FILENAME>

<letters>

ファイルのパースに失敗した設定ファイルの名前が出力されます（ディレクトリ名を含みません）。

<LINENO>

<const>

パースに失敗した行数が出力されます。

(d)　出力例

出力例を示します。

[ENO]<Fri Aug 10 17:41:51 2012> parsed error line. [USR] [file=javamove.cfg line=25]

この出力例では次の内容が確認できます。

2012年8月10日(金)17時41分51秒に，JavaVM起動オプションでファイルパスを指定した設定ファイルのパースに25行目で失敗しました。

5.11.4　出力レベルがverboseの場合に出力される内容

ここでは，ログ出力レベルにverboseを指定した場合に出力される内容をイベントごとに説明します。verboseは，障害解析などに必要な詳細情報を出力するためのログ出力レベルです。

補足

verboseでは，normalで出力する内容に加えて，normalでは出力しない詳細なログを出力します。ログ出力のオーバーヘッドが掛かるため，通常運用時に指定するとスループットが低下するおそれがあります。

(1)　Explicitメモリブロックの初期化

新たにExplicitメモリブロックを初期化した場合に，初期化したExplicitメモリブロックの名称，ID，およびExplicitメモリブロックの種類を出力します。

(a)　出力の契機

Explicitメモリブロックの初期化です。

(b)　出力形式

[EVO]<ctime>[Created]["<EM_NAME>" eid=<EID>(<EM_PTR>)/<EM_TYPE>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒43　出力項目（Explicitメモリブロックの初期化）

出力項目

出力内容

意味

<ctime>

<letters>

Explicitメモリブロックを初期化した日時を示します。拡張verbosegc情報と同じ形式で出力されます。

-XX:+HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EM_NAME>

<letters>

初期化したExplicitメモリブロックの名称が出力されます。

Explicitメモリブロックの名称に多バイト文字が含まれている場合，出力内容は不定です（通常は文字化けして出力されます）。

<EID>

<const>

初期化したExplicitメモリブロックのIDが出力されます。

<EM_PTR>

<ptr>

Explicitメモリブロックの内部状態を示す値が出力されます。

<EM_TYPE>

R|B

初期化したExplicitメモリブロックの種類が出力されます。

Rは，アプリケーションサーバの内部で利用されているExplicitメモリブロックを示します。Bは，ExplicitメモリブロックのJavaVM内部での種別を示します。

(d)　出力例

出力例を示します。

[EVO]<Tue Jul 24 01:23:51 2007>[Created]["BasicExplicitMemory-2" eid=2(0x1234568)/B]

この出力例では次の内容が確認できます。

出力契機は2007年7月24日(火)1時23分51秒に実行されたExplicitメモリブロックの初期化です。

初期化されたExplicitメモリブロックの名称は「BasicExplicitMemory-2」です。

(2)　Explicitメモリブロックの初期化失敗

Explicitメモリブロックの初期化時に，Explicitメモリブロックの初期化が失敗した場合に出力されます。失敗の原因はExplicitメモリブロックの最大数に達したことです。その時点のExplicitメモリブロックの数と，初期化に失敗したJavaプログラム上のスタックトレースが出力されます。

なお，このログは複数行にわたって出力されます。また，Javaプログラムの実行とは非同期に出力されます。このため，各行の間に別のログが出力されることがあります。ただし，1行の中にほかのログが出力されることはありません。

(a)　出力の契機

Explicitメモリブロックの上限に達して，Explicitメモリブロックの初期化に失敗した場合です。

(b)　出力形式

[EVO]<ctime>[Creation failed][EH: <EH_USED>(<EH_GARB>)/<EH_TOTAL>/<EH_MAX>][E/F/D: <AC_NUM>/<FL_NUM>/<DA_NUM>][Thread: <TH_PTR>]
[EVO][Thread: <TH_PTR>] at <FRAME><SOURCE>
…

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒44　出力項目（Explicitメモリブロックの初期化失敗）

出力項目

出力内容

意味

<ctime>

<letters>

Explicitメモリブロックを初期化が失敗した日時を示します。拡張verbosegc情報と同じ形式で出力されます。

-XX:+HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EH_USED>

<const>K

Explicitメモリブロック初期化失敗時のExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_GARB>

<const>K

Explicitヒープの内部状態が出力されます。

<EH_TOTAL>

<const>K

Explicitメモリブロック初期化失敗時のExplicitヒープの確保済みサイズが出力されます。単位はキロバイトです。

<EH_MAX>

<const>K

Explicitヒープ最大サイズが出力されます。単位はキロバイトです。

<AC_NUM>

<const>

Explicitメモリブロック初期化失敗時にサブ状態がEnableであるExplicitメモリブロックの数が出力されます。

<FL_NUM>

<const>

常に0が出力されます。

<DA_NUM>

<const>

Explicitメモリブロック初期化失敗時にサブ状態がDisableであるExplicitメモリブロックの数が出力されます。

<TH_PTR>

<ptr>

Explicitメモリブロックの初期化に失敗したスレッドのスレッドIDが出力されます。スレッドダンプに出力されるtidと同一です。

<FRAME>

<letters>.<letters>

Explicitメモリブロック初期化失敗時のスタックトレース中の1フレームが出力されます。完全クラス名とメソッド名が"."で区切られて出力されます。

<SOURCE>

(<letters>:<const>)|(Native Method)|(Unknown Source)

<FRAME>で出力されたメソッドが記述されているソースファイル名と，スタックトレースと一致する行番号が出力されます。ファイル名と行番号は":"で区切られて出力されます。

ネイティブメソッドの場合は，"(Native Method)"と出力されます。ソースファイル名が取得できない場合は，"(Unknown Source)"と出力されます。

(d)　出力例

出力例を示します。

[EVO]<Tue Jul 24 01:23:51 2007>[Creation failed][EH: 12000K(0K)/15000K/30000K][E/F/D: 65535/0/0][Thread: 0x00035a60]
[EVO][Thread: 0x00035a60] at ExplicitMemory.registerExplicitMemory(Native Method)
[EVO][Thread: 0x00035a60] at BasicExplicitMemory.<init>(Unknown Source)
[EVO][Thread: 0x00035a60] at AllocTest.test(AllocTest.java:64)
[EVO][Thread: 0x00035a60] at java.lang.Thread.run(Thread.java:2312)

この出力例では次の内容が確認できます。

出力契機は2007年7月24日(火)1時23分51秒に発生したExplicitメモリブロックの初期化失敗です。最大数である65535個のExplicitメモリブロックがすでに存在しているため，新たなExplicitメモリブロックの初期化に失敗しました。

AllocTest.javaの64行目で，BasicExplicitMemoryクラスのコンストラクタを実行して，Explicitメモリブロックの初期化を試みています。

(3)　Explicitメモリブロックのサブ状態のDisable化

Explicitメモリブロックのサブ状態がDisableに変更になった場合に，その時点でのExplicitヒープの利用状況と，サブ状態がDisableに変更されたExplicitメモリブロックの情報が出力されます。このログは，複数行にわたって，Javaプログラムの実行と非同期に出力されます。このため，各行の間に別なログが出力されることがあります。ただし，1行中にほかのログが出力されることはありません。

(a)　出力の契機

Explicitメモリブロックのサブ状態がDisableになり，そのExplicitメモリブロックにオブジェクトを配置できなくなった場合です。

(b)　出力形式

[EVO]<ctime>[Alloc failed(Disable)][EH: <EH_USED>(<EH_GARB>)/<EH_TOTAL>/<EH_MAX>][E/F/D: <AC_NUM>/<FL_NUM>/<DA_NUM>][cause:<CAUSE>]¥
["<EM_NAME>" eid=<EID>/<EM_TYPE>: <EM_USED>(<EM_GARB>)/<EM_TOTAL>][Thread: <TH_PTR>]
[EVO][Thread: <TH_PTR>] at <FRAME><SOURCE>
…

注

下線部分はNewの場合にだけ出力されます。

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒45　出力項目（Explicitメモリブロックのサブ状態のDisable化）

出力項目

出力内容

意味

<ctime>

<letters>

<EID>が示すExplicitメモリブロックのサブ状態がDisableになった日時を示します。拡張verbosegc情報と同じ形式で出力されます。

-XX:+HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EH_USED>

<const>K

<EID>が示すExplicitメモリブロックのサブ状態がDisableになったときのExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_GARB>

<const>K

Explicitヒープの内部状態を示す値が出力されます。

<EH_TOTAL>

<const>K

<EID>が示すExplicitメモリブロックのサブ状態がDisableになったときのExplicitヒープの確保済みサイズが出力されます。単位はキロバイトです。

<EH_MAX>

<const>K

Explicitヒープ最大サイズが出力されます。単位はキロバイトです。

<AC_NUM>

<const>

<EID>が示すExplicitメモリブロックのサブ状態がDisableになったあとで，サブ状態がEnableであるExplicitメモリブロックの数が出力されます。

<FL_NUM>

<const>

常に0が出力されます。

<DA_NUM>

<const>

<EID>が示すExplicitメモリブロックのサブ状態がDisableになったあとで，サブ状態がDisableであるExplicitメモリブロックの数が出力されます。

<CAUSE>

New|GC|Full GC

サブ状態がDisableになった原因の処理が出力されます。

出力内容と原因の対応は次のとおりです。

"New"

newInstance()などによるExplicitヒープへのオブジェクト直接生成が原因です。

"GC"

CopyGCによるExplicitヒープへのオブジェクト移動が原因です。

"Full GC"

FullGCによるExplicitヒープへのオブジェクト移動が原因です。

<EM_NAME>

<letters>

サブ状態がDisableになったExplicitメモリブロックの名称が出力されます。

Explicitメモリブロックの名称に多バイト文字が含まれている場合，出力内容は不定です（通常は文字化けして出力されます）。

<EID>

<const>

サブ状態がDisableになったExplicitメモリブロックのIDが出力されます。

<EM_TYPE>

R|B|A

サブ状態がDisableになったExplicitメモリブロックの種類が出力されます。

Rは，アプリケーションサーバの内部で利用されているExplicitメモリブロックを示します。Bは，ExplicitメモリブロックのJavaVM内部での種別を示します。Aは，自動配置設定ファイルを使って指定したExplicitメモリブロックを示します。

<EM_USED>

<const>K

サブ状態がDisableになったExplicitメモリブロックの利用済みサイズが出力されます。単位はキロバイトです。

<EM_GARB>

<const>K

Explicitメモリブロックの内部状態を示す値が出力されます。

<EM_TOTAL>

<const>K

サブ状態がDisableになったExplicitメモリブロックの確保済みサイズが出力されます。単位はキロバイトです。

<TH_PTR>

<ptr>

サブ状態がDisableになった原因である，Explicitヒープへのオブジェクト生成を実行したスレッドのスレッドIDが出力されます。スレッドダンプに出力されるtidと同一です。

この項目は，<CAUSE>が"New"の場合だけに出力されます。

<FRAME>

<letters>.<letters>

Explicitヒープへのオブジェクト直接生成によってサブ状態がDisableになった場合に，オブジェクト直接生成で出力されたスタックトレース中の1フレームが出力されます。

完全クラス名とメソッド名が"."で区切られて出力されます。

この項目は，<CAUSE>が"New"の場合だけに出力されます。

<SOURCE>

(<letters>:<const>)|(Native Method)|(Unknown Source)

<FRAME>で出力されたメソッドが記述されているソースファイル名と，スタックトレースと一致する行番号が出力されます。ファイル名と行番号は":"で区切られて出力されます。

ネイティブメソッドの場合は，"(Native Method)"と出力されます。

ソースファイル名が取得できない場合は，"(Unknown Source)"と出力されます。

この項目は，<CAUSE>が"New"の場合だけに出力されます。

(d)　出力例

出力例を示します。

[EVO]<Tue Jul 24 01:23:51 2007>[Alloc failed(Disable)][EH: 12000K(1258K)/15000K/30000K][E/F/D: 321/0/1][cause:GC]¥
["ReferenceExplicitMemory-3" eid=3/R: 108K(20K)/108K]

この出力例では次の内容が確認できます。

出力契機は，2007年7月24日(火)1時23分51秒にExplicitメモリブロックのサブ状態がDisableになったことです。

Explicitヒープは，12000Kが利用済み，15000Kが確保済みです。

Explicitヒープの最大サイズは30000Kです。

Explicitヒープ全体で有効なExplicitメモリブロックは322個です。このうち，サブ状態がEnableのものは321個，Disableのものは1個あります。

サブ状態がDisableになった原因の処理は，GC発生時のExplicitメモリブロックへのオブジェクトの移動です。

サブ状態がDisableになったのは，IDが"3"，名称が"ReferenceExplicitMemory-3"のExplicitメモリブロックです。

"ReferenceExplicitMemory-3"では，108kのメモリを利用済みです。

(4)　Explicitメモリブロックへのオブジェクト生成

ExplicitMemory.newInstance()などを使用してExplicitメモリブロックに直接オブジェクトを生成した場合に出力されます。

(a)　出力の契機

Explicitメモリブロックにオブジェクトが生成された時です。

(b)　出力形式

[EVS]<ctime>[EH: <EH_USED_BF>-><EH_USED_AF>(<EH_TOTAL>/<EH_MAX>)][E/F/D: <AC_NUM>/<FL_NUM>/<DA_NUM>][cause:<CAUSE>]¥
["<EM_NAME>" eid=<EID>/<EM_TYPE>: <EM_USED_BF>-><EM_USED_AF>(<EM_TOTAL>)]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒46　出力項目（Explicitメモリブロックへのオブジェクト生成）

出力項目

出力内容

意味

<ctime>

<letters>

Explicitメモリブロックにオブジェクトが生成された日時を示します。拡張verbosegc情報と同じ形式で出力されます。

-XX:+HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EH_USED_BF>

<const>K

オブジェクト生成前のExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_USED_AF>

<const>K

オブジェクト生成後のExplicitヒープの利用済みサイズが出力されます。単位はキロバイトです。

<EH_TOTAL>

<const>K

オブジェクト生成後のExplicitヒープの確保済みサイズが出力されます。単位はキロバイトです。

<EH_MAX>

<const>K

Explicitヒープの最大サイズが出力されます。単位はキロバイトです。

<AC_NUM>

<const>

オブジェクト生成後にサブ状態がEnableであるExplicitメモリブロックの数が出力されます。

<FL_NUM>

<const>

常に0が出力されます。

<DA_NUM>

<const>

オブジェクト生成後にサブ状態がDisableであるExplicitメモリブロックの数が出力されます。

<CAUSE>

New

必ず"New"と出力されます。

Explicitメモリブロックへのオブジェクトへの移動がJavaプログラムから実行されたことを示します。

<EM_NAME>

<letters>

オブジェクトを生成したExplicitメモリブロックの名称が出力されます。

Explicitメモリブロックの名称に多バイト文字が含まれている場合，出力内容は不定です（通常は文字化けして出力されます）。

<EID>

<const>

オブジェクトを生成したExplicitメモリブロックのIDが出力されます。

<EM_TYPE>

R|B|A

オブジェクトを生成したExplicitメモリブロックの種類が出力されます。

Rは，アプリケーションサーバの内部で利用されているExplicitメモリブロックを示します。Bは，ExplicitメモリブロックのJavaVM内部での種別を示します。Aは，自動配置設定ファイルを使って指定したExplicitメモリブロックを示します。

<EM_USED_BF>

<const>K

オブジェクト生成前の生成先Explicitメモリブロックの利用済みサイズが出力されます。単位はキロバイトです。

<EM_USED_AF>

<const>K

オブジェクト生成後の生成先Explicitメモリブロックの利用済みサイズが出力されます。単位はキロバイトです。

<EM_TOTAL>

<const>K

オブジェクト生成後の生成先Explicitメモリブロックの確保済みサイズが出力されます。単位はキロバイトです。

(d)　出力例

出力例を示します。

[EVS]<Thu Oct 21 14:55:50 2007>[EH: 150528K->150529K(150532K/1048576K)][E/F/D: 200/0/0][cause:New]["BEM" eid=2/B: 30K->31K(32K)]

この出力例では次の内容が確認できます。

出力契機は，2007年10月21日(木)14時55分50秒に実行された，Explicitメモリブロックへのオブジェクトの生成です。

Explicitヒープにオブジェクトが生成されたため，Explicitヒープの利用済みサイズが150528Kから150529Kに変化しました。

Explicitヒープへのオブジェクト生成後のExplicitヒープの確保済みサイズは150532Kです。最大サイズは1048576Kです。

Explicitヒープへのオブジェクト生成後に，サブ状態がEnableであるExplicitメモリブロックの数は200個です。

"BEM"という名称のメモリブロックの利用済みサイズが，30Kから31Kに変化しました。オブジェクト生成後のBEMの確保済みサイズは32Kです。

(5)　Explicitメモリブロックへの移動（詳細情報出力）

Explicitメモリブロックにオブジェクトが移動する場合の詳細な情報が出力されます。「5.11.3(1)　GC発生（Explicitヒープ利用状況出力）」で示した出力内容に加えて，移動先になったExplicitメモリブロックすべての利用状況が出力されます。

(a)　出力の契機

GC発生による，Explicitメモリブロックへのオブジェクトの移動です。

(b)　出力形式

<GC発生時のExplicitヒープ利用状況>※
[EVS]{["<EM_NAME>" eid=<EID>/<EM_TYPE>: <EM_USED_BF>-><EM_USED_AF>(<EM_TOTAL>)]}{1,5}
...

注

Explicitメモリブロックの情報が5個出力されるごとに改行されます。

注※

出力項目については，「5.11.3(1)　GC発生（Explicitヒープ利用状況出力）」を参照してください。

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒47　出力項目（Explicitメモリブロックへの移動（詳細情報出力））

出力項目

出力内容

意味

GC発生時のExplicitヒープ利用状況

「5.11.3(1)　GC発生（Explicitヒープ利用状況出力）」を参照してください。

<EM_NAME>

<letters>

GC発生時にオブジェクト移動先となったExplicitメモリブロックの名称が出力されます。

Explicitメモリブロックの名称に多バイト文字が含まれている場合，出力内容は不定です（通常は文字化けして出力されます）。

<EID>

<const>

GC発生時にオブジェクト移動先となったExplicitメモリブロックのIDが出力されます。

<EM_TYPE>

R|A

GC発生時にオブジェクト移動先となったExplicitメモリブロックの種別が出力されます。

RまたはAが出力されます。Rは，ExplicitメモリブロックのJavaVM内部での種別を示します。Aは，自動配置設定ファイルを使って指定したExplicitメモリブロックを示します。

<EM_USED_BF>

<const>K

GC発生時にオブジェクト移動先となったExplicitメモリブロックの，GC発生前の利用済みサイズが出力されます。単位はキロバイトです。

<EM_USED_AF>

<const>K

GC発生時にオブジェクト移動先となったExplicitメモリブロックの，GC発生後の利用済みサイズが出力されます。単位はキロバイトです。

<EM_TOTAL>

<const>K

GC発生時にオブジェクト移動先となったExplicitメモリブロックの，GC発生後の確保済みサイズが出力されます。単位はキロバイトです。

(d)　出力例

出力例を示します。

[ENS]<Thu Oct 21 14:55:50 2007>[EH: 150528K->162816K(162816K/1048576K)][E/F/D: 200/0/0][cause:GC][CF: 0]
[EVS]["REM2" eid=2/R: 0K->88K(128K)]["REM3" eid=3/R: 30K->230K(256K)]["REM6" eid=6/R: 30K->2030K(2048K)]¥
["Session1" eid=8/R: 30K->2530K(2548K)]["Session2" eid=10/R: 30K->2530K(2548K)]
[EVS]["Session3" eid=12/R: 30K->5030K(5048K)]

この出力例では次の内容が確認できます。

出力契機は2007年10月21日(木)14時55分50秒に発生したGCでの，Explicitヒープへのオブジェクトの移動です。

Explicitヒープの利用済みサイズが，150528Kから162816Kに変化しました。

GC実行後のExplicitヒープの確保済みサイズは162816Kです。最大サイズは1048576Kです。

GC実行後に，サブ状態がEnableであるExplicitメモリブロックは200個あります。

GCの種類はCopyGCです。

移動先になったExplicitメモリブロックは5個以上あります。このため，5個分出力されたところで1回改行されています。

Explicitヒープへの2288K(162816K-150528K)移動の内訳は次のとおりです。

Explicitメモリブロック"REM2"(eid=2)に88K移動。

Explicitメモリブロック"REM3"(eid=3)に200K移動。

Explicitメモリブロック"REM6"(eid=6)に2000K移動。

Explicitメモリブロック"Session1"(eid=8)に2500K移動。

Explicitメモリブロック"Session2"(eid=10)に2500K移動。

Explicitメモリブロック"Session3"(eid=12)に5000K移動。

なお，移動先は，すべてアプリケーションサーバの内部で利用されているExplicitメモリブロックです。

(6)　Explicitメモリブロックの明示解放処理（詳細情報出力）

Explicitメモリブロックの明示解放処理が起こった場合の詳細な情報が出力されます。「5.11.3(2)　Explicitメモリブロックの明示解放処理」で示した出力内容に加えて，明示解放したすべてのExplicitメモリブロックの情報が出力されます。

Explicitメモリブロックの明示解放時にJavaヒープがあふれた場合は，あふれる前に明示解放したExplicitメモリブロックの情報が追加されて出力されます。ただし，「5.11.3(3)　Explicitメモリブロックの明示解放処理時のJavaヒープあふれ」で示した出力内容には，ここで説明する情報は追加出力されません。

(a)　出力の契機

Explicitメモリブロックの明示解放処理です。

(b)　出力形式

<Explicitメモリブロックの明示解放処理>※
[EVS]{["<EM_NAME>" eid=<EID>/<EM_TYPE>: <EM_TOTAL>]}{1,5}
...

注

Explicitメモリブロックの情報が5個出力されるごとに改行されます。

注※

出力項目については，「5.11.3(2)　Explicitメモリブロックの明示解放処理」を参照してください。

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒48　出力項目（Explicitメモリブロックの明示解放処理（詳細情報出力））

出力項目

出力内容

意味

Explicitメモリブロックの明示解放処理で出力される情報

「5.11.3(2)　Explicitメモリブロックの明示解放処理」を参照してください。

<EM_NAME>

<letters>

明示解放したExplicitメモリブロックの名称が出力されます。

Explicitメモリブロックの名称に多バイト文字が含まれている場合，出力内容は不定です（通常は文字化けして出力されます）。

<EID>

<const>

明示解放したExplicitメモリブロックのIDが出力されます。

<EM_TYPE>

R|B|A

明示解放したExplicitメモリブロックの種別が出力されます。

Rは，アプリケーションサーバの内部で利用されているExplicitメモリブロックを示します。Bは，ExplicitメモリブロックのJavaVM内部での種別を示します。Aは，自動配置設定ファイルを使って指定したExplicitメモリブロックを示します。

<EM_TOTAL>

<const>K

明示解放したExplicitメモリブロックによって確保済みだったメモリサイズ（明示解放処理によって明示解放されたメモリサイズ）が出力されます。単位はキロバイトです。

(d)　出力例

出力例を示します。

[ENS]<Tue Jul 24 01:23:51 2007>[EH: 150528K->149528K(162816K/1048576K), 0.1129602 secs][E/F/D: 523/0/0]¥
[DefNew::Eden: 0K->0K(243600K)][DefNew::Survivor: 0K->0K(17400K)][Tenured: 103400K->103400K(556800K)][cause:Reclaim]
[EVS]["REM2" eid=3/R: 300K]["BEM3" eid=5/B: 300K]["BEM1" eid=7/B: 400K]

この出力例では次の内容が確認できます。

出力契機は2007年7月24日(火)1時23分51秒に発生したExplicitメモリブロックの明示解放処理です。

Explicitメモリブロックの明示解放処理によって，Explicitヒープの利用済みサイズが150528Kから149528Kに減少しました。

Explicitメモリブロックの明示解放処理後のExplicitヒープの確保済みサイズは162816Kです。最大サイズは1048576Kです。

Explicitメモリブロックの明示解放処理には，0.1129602秒掛かりました。

Explicitメモリブロックの明示解放処理後，サブ状態がEnableであるExplicitメモリブロックは523個あります。

Explicitメモリブロックの明示解放処理によって，Javaヒープの各領域のメモリサイズは変化していません。つまり，Javaヒープへのオブジェクトの移動はありませんでした。

明示解放処理の対象になったのは，次のExplicitメモリブロックです。

確保済みのメモリサイズが300KだったExplicitメモリブロック"REM2"(eid=3)

確保済みのメモリサイズが300KだったExplicitメモリブロック"BEM3"(eid=5)

確保済みのメモリサイズが400KだったExplicitメモリブロック"BEM1"(eid=7)

なお，REM2は，アプリケーションサーバの内部で利用されていたExplicitメモリブロックです。BEM3とBEM1は，アプリケーションが利用していたExplicitメモリブロックです。

(7)　ファイナライザによるExplicitメモリブロックの解放予約

ExplicitMemoryインスタンスへの参照切れによって，ExplicitMemoryクラスのfinalizeメソッドで対応するExplicitメモリブロックが解放予約された場合に出力されます。

(a)　出力の契機

ExplicitMemory.finalize()メソッドによってExplicitメモリブロックの解放が予約された場合です。

(b)　出力形式

[EVO]<ctime>[Finalized]["<EM_NAME>" eid=<EID>/<EM_TYPE>: <EM_TOTAL>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒49　出力項目（ファイナライザによるExplicitメモリブロックの解放予約）

出力項目

出力内容

意味

<ctime>

<letters>

解放が予約された日時を示します。拡張verbosegc情報と同じ形式で出力されます。

-XX:+HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<EM_NAME>

<letters>

解放予約したExplicitメモリブロックの名称が出力されます。

Explicitメモリブロックの名称に多バイト文字が含まれている場合，出力内容は不定です（通常は文字化けして出力されます）。

<EID>

<const>

解放予約したExplicitメモリブロックのIDが出力されます。

<EM_TYPE>

B

解放予約したExplicitメモリブロックの種別が出力されます。

Bは，ExplicitメモリブロックのJavaVM内部での種別を示します。アプリケーションサーバのバージョンが08-50より前の場合は，アプリケーションが利用しているExplicitメモリブロックを示します。

<EM_TOTAL>

<const>K

解放を予約したExplicitメモリブロックによって確保済みサイズ（解放処理によって解放されるメモリサイズ）が出力されます。単位はキロバイトです。

(d)　出力例

出力例を示します。

[EVO]<Tue Jul 24 01:23:51 2007>[Finalized]["REM1" eid=3/R: 512K]

この出力例では次の内容が確認できます。

出力契機は2007年7月24日(火)1時23分51秒にExplicitメモリブロック"REM1"(eid=3)が解放予約されたことです。解放予約は，finalize()によって実行されました。

(8)　明示管理ヒープへの自動配置

指定したクラスが明示管理ヒープ上への自動配置に成功した場合，ログメッセージが出力されます。

(a)　出力の契機

指定したクラスが明示管理ヒープ上への自動配置に成功した場合です。

(b)　出力形式

[EVA]<ctime> creation in explicit memory is succeeded. [class=<CLASSNAME>]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒50　出力項目（明示管理ヒープへの自動配置）

出力項目

出力内容

意味

<ctime>

<letters>

指定したクラスが明示管理ヒープ上への自動配置に成功した日時を示します。拡張VerboseGC機能で出力しているものと同一の時刻形式で出力されます。HitachiOutputMilliTimeオプションが設定されている場合は，ミリ秒単位まで出力されます。

<CLASSNAME>

<letters>

明示管理ヒープへの自動配置に成功したクラスの完全修飾クラス名が出力されます。

(d)　出力例

出力例を示します。

[EVA]<Tue Jul 24 01:23:51 2007> creation in explicit memory is succeeded. [class=jp.co.sample.Main]

この出力例では次の内容が確認できます。

2007年7月24日(火)1時23分51秒に，明示管理ヒープ機能がクラスjp.co.sample.Mainを明示管理ヒープ上への自動配置に成功した場合です。

5.11.5　出力レベルがdebugの場合に出力される内容

ここでは，ログ出力レベルにdebugを指定した場合に出力される内容をイベントごとに説明します。

補足

debugは，デバッグなどを実施する場合に，verboseで出力する内容よりもさらに詳細な情報が必要なときに使用します。debugで出力するログには，出力するためにFullGC実行時以上のオーバーヘッドが必要なログもあります。

(1)　Explicitメモリブロックの明示解放によるJavaヒープへのオブジェクトの移動

Explicitメモリブロックを明示解放する場合に，Explicitメモリブロック内のオブジェクトが明示解放対象のExplicitメモリブロック以外から参照されているとき，そのオブジェクトはJavaヒープに移動します。このログでは，Javaヒープに移動したオブジェクトとその参照元のオブジェクトの情報が出力されます。

(a)　出力の契機

Explicitメモリブロックの明示解放処理で，Javaヒープへのオブジェクトの移動が発生した場合です。

(b)　出力形式

[EDO][eid=<EID>: Reference to <REFED_NAME>(<REFED_PTR>), total <R_SIZE>]
[EDO]   <REF_NAME>(<REF_PTR>)<REF_GEN>

注

明示解放対象のExplicitメモリブロック以外から参照されているオブジェクトごとに出力されます。

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒51　出力項目（Explicitメモリブロックの明示解放によるJavaヒープへのオブジェクト移動）

出力項目

出力内容

意味

<EID>

<const>

Explicitメモリブロックの明示解放処理時に，明示解放対象のExplicitヒープ以外から参照されているオブジェクトを含むExplicitメモリブロックのIDが出力されます。

<REFED_NAME>

<letters>

Explicitメモリブロックの明示解放処理時に，明示解放対象のExplicitヒープ以外のオブジェクト(<REF_NAME>(<REF_PTR>)で示すオブジェクト)から参照されているオブジェクトの完全クラス名が出力されます。

<REFED_PTR>

<ptr>

<REFED_NAME>が示すオブジェクトのJavaヒープへの移動前のメモリアドレスが出力されます。

<R_SIZE>

<const>K

<REF_NAME>(<REF_PTR>)から参照されていることによって，Javaヒープに移動することになるオブジェクトの総サイズが出力されます。<REF_NAME>(<REF_PTR>)から間接参照している，明示解放対象Explicitメモリブロック内のオブジェクトも含めた値になります※。単位はキロバイトです。

<REF_NAME>

<letters>|JVM

<REFED_NAME>(<REFED_PTR>)を参照しているオブジェクトの完全クラス名が出力されます。ただし，参照元がスタックやJavaVM内部の場合は，"JVM"と出力されます。

<REF_PTR>

<ptr>

<REF_NAME>が示すオブジェクト，スタックまたはJavaVM内部のメモリアドレスが出力されます。

<REF_GEN>

(eid=<EID>)|(DefNew)|(Tenured)|(JVM)

<REF_NAME>(<REF_PTR>)の属する領域または世代の名称が出力されます。Explicitメモリブロックの場合はExplicitメモリブロックのIDが出力されます。スタックやJavaVM内部から参照されている場合は"JVM"と出力されます。

注※　次に示す「補足」も参照してください。

補足

Javaヒープに移動するオブジェクトへの参照経路が複数ある場合について説明します。

ここでは，次の図を例にして説明します。

図5‒9　Javaヒープに移動するオブジェクトへの参照経路が複数ある例

Javaヒープに移動するオブジェクトが複数のオブジェクトから参照されている場合の出力

Javaヒープに移動するオブジェクトは，複数のオブジェクトから参照されていることがあります。図の場合，オブジェクトBに対して，A→B，E→Bの2種類の参照経路があります。

この場合，ログには，A→B，E→Bの参照についての情報が別々に出力されます。

複数のオブジェクトから間接参照されている場合の<R_SIZE>の算出

<R_SIZE>には，<REF_NAME>(<REF_PTR>)から間接参照している，明示解放対象Explicitメモリブロック内のオブジェクトも含めた値が出力されます。ただし，Javaヒープに移動するオブジェクトが複数のオブジェクトから間接参照されている場合は，算出方法が異なります。

図の場合，オブジェクトDは，次の3種類の経路で間接参照されています。

A→B→D

E→B→D

E→F→D

複数の経路で参照される場合，最初に算出される参照関係の<R_SIZE>にオブジェクトのサイズが計上されます。例えば，A→B，E→B，E→Fの順で参照関係が出力される場合，オブジェクトDのサイズは，A→Bの<R_SIZE>に計上されます。この場合の各参照関係の<R_SIZE>の出力は次のようになります。

A→B

オブジェクトBとオブジェクトDのサイズの合計で4Kになります。

E→B

オブジェクトBのサイズである2Kになります。

E→F

オブジェクトFのサイズである1Kになります。

(d)　出力例

出力例を示します。

[EDO][eid=5: Reference to java.lang.HashMap$Entry(0x1234568), total 125K]
[EDO]   java.util.HashMap$KeyIterator(0x1134428)(eid=1)
[EDO][eid=5: Reference to ClassA(0x1234580), total 19250K]
[EDO]   ClassV(0x1234468)(Tenured)
[EDO][eid=5: Reference to ClassZ(0x1234680), total 12K]
[EDO]   ClassU(0x1233468)(DefNew)
[EDO][eid=9: Reference to JP.co.Hitachi.soft.jvm.BBB(0x1034428), total 1250K]
[EDO]   JVM(0x23456780)(JVM)

この出力例では次の内容が確認できます。

eid=5のExplicitメモリブロック内にあるjava.lang.HashMap$Entryのオブジェクトは，明示解放対象ではないeid=1のExplicitメモリブロック内のjava.util.HashMap$KeyIteratorのオブジェクトから参照されています。このため，125キロバイトのオブジェクトがJavaヒープに移動しました。

eid=5のExplicitメモリブロック内にあるClassAのオブジェクトは，Tenured領域内のClassVのオブジェクトから参照されています。このため，19,250キロバイトのオブジェクトがJavaヒープに移動しました。

eid=5のExplicitメモリブロック内にあるClassZのオブジェクトは，New領域内のClassUのオブジェクトから参照されています。このため，12キロバイトのオブジェクトがJavaヒープに移動しました。

eid=9のExplicitメモリブロック内にあるJP.co.Hitachi.soft.jvm.BBBのオブジェクトは，スタックまたはJavaVM内部から参照されています。このため，1,250キロバイトのオブジェクトがJavaヒープに移動しました。

(2)　Explicitメモリブロックの初期化（詳細情報出力）

新たにExplicitメモリブロックを初期化した場合の詳細な情報が出力されます。「5.11.4(1)　Explicitメモリブロックの初期化」で示した出力内容に加えて，初期化処理を実行したJavaプログラムのスタックトレースが出力されます。このログは，複数行にわたって，Javaプログラムの実行と非同期に出力されます。このため，各行の間に別なログが出力されることがあります。ただし，1行中にほかのログが出力されることはありません。

(a)　出力の契機

Explicitメモリブロックの初期化です。

(b)　出力形式

<Explicitメモリブロックの初期化の情報（verbose）>※[Thread: <TH_PTR>]
[EDO][Thread: <TH_PTR>] at <FRAME><SOURCE>
...

注※

出力項目については，「5.11.4(1)　Explicitメモリブロックの初期化」を参照してください。

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒52　出力項目（Explicitメモリブロックの初期化（詳細情報出力））

出力項目

出力内容

意味

Explicitメモリブロックの初期化時の情報（vervose）

「5.11.4(1)　Explicitメモリブロックの初期化」を参照してください。

<TH_PTR>

<ptr>

Explicitメモリブロックを初期化したスレッドのスレッドIDが出力されます。スレッドダンプに出力されるtidと同一です。

<FRAME>

<letters>.<letters>

Explicitメモリブロック初期化時のスタックトレース中の1フレームが出力されます。完全クラス名とメソッド名が"."で区切られて出力されます。

<SOURCE>

(<letters>:<const>)|(Native Method)|(Unknown Source)

<FRAME>で出力されたメソッドが記述されているソースファイル名と，スタックトレースと一致する行番号が出力されます。ファイル名と行番号は":"で区切られて出力されます。

ネイティブメソッドの場合は，"(Native Method)"と出力されます。

ソースファイル名が取得できない場合は，"(Unknown Source)"と出力されます。

(d)　出力例

出力例を示します。

[EVO]<Tue Jul 24 01:23:51 2007>[Created]["BasicExplicitMemory-2" eid=2(0x1234568)/B][Thread: 0x00035a60]
[EDO][Thread: 0x00035a60] at ExplicitMemory.registerExplicitMemory(Native Method)
[EDO][Thread: 0x00035a60] at BasicExplicitMemory.<init>(Unknown Source)
[EDO][Thread: 0x00035a60] at AllocTest.test(AllocTest.java:64)
[EDO][Thread: 0x00035a60] at java.lang.Thread.run(Thread.java:2312)

この出力例では次の内容が確認できます。

出力契機は2007年7月24日(火)1時23分51秒に実行したメモリブロックの初期化です。Explicitメモリブロックの名称は"BasicExplicitMemory-2"です。ExplicitメモリブロックのIDはeid=2です。

AllocTest.javaの64行目でBasicExplicitMemoryクラスのコンストラクタを実行して，Explicitメモリブロックの初期化を試みています。

(3)　Explicitメモリブロックの自動解放処理の詳細（詳細情報出力）

Explicitメモリブロックの自動解放処理が起こった場合の詳細情報を出力します。「5.11.3(4)　Explicitメモリブロックの自動解放処理」で示した出力内容に加えて，自動解放処理を実施したExplicitメモリブロックのEID情報を出力します。Explicitメモリブロックの自動解放処理は，オブジェクトの移動が発生しない自動解放処理，多対1の自動解放処理，および1対1の自動解放処理が実行されることがあります。このため，オブジェクトの移動が発生しなかったEID，多対1のEID，および1対1のEIDの情報を出力します。

(a)　出力の契機

Explicitメモリブロックの自動解放処理が起こった場合です。

(b)　出力形式

[EDO][migrate:(<EID_DEL>{,<EID_DEL>}*|)/(<EID_MBF>{,<EID_MBF>}*-><EID_MAF>|)/(<EID_MIG>{,<EID_MIG>}*|)]

(c)　出力項目

「(b)　出力形式」で示した各項目について説明します。

表5‒53　出力項目（Explicitメモリブロックの自動解放処理の詳細（詳細情報出力））

出力項目

出力内容

意味

<EID_DEL>

<const>

Explicitメモリブロックの自動解放処理によって解放されるExplicitメモリブロックのうち，オブジェクトの移動が発生しなかったExplicitメモリブロックのEIDを出力します。

<EID_MBF>

<const>

Explicitメモリブロックの自動解放処理によって解放されるExplicitメモリブロックのうち，多対1の自動解放が起こったExplicitメモリブロックの自動解放予約される前のEIDを出力します。

<EID_MAF>

<const>

Explicitメモリブロックの自動解放処理によって生成されるExplicitメモリブロックのうち，多対1の自動解放によって生成されたExplicitメモリブロックのEIDを出力します。

<EID_MIG>

<const>

Explicitメモリブロックの自動解放処理によって解放されるExplicitメモリブロックのうち，1対1の自動解放が起こったExplicitメモリブロックのEIDを出力します。

(d)　出力例

出力例を示します。

[EVS]<Tue Jul 14 02:31:22 2009>[EH: 256512K->256128K(256256K/1048576K), 0.1124626 secs][E/F/D: 423/0/0][target:584K/384K/200K]¥
[cause:Migrate]
[EDO][migrate:()/(2,4,6,9->10)/(1,8)]

この出力例では次の内容が確認できます。

2009年7月14日（火）2時31分22秒に発生した，GCでのExplicitメモリブロックの自動解放処理です。

自動解放処理が発生したことによって，Explicitヒープの利用済みサイズが256,512Kから256,128Kに変化しています。

自動解放処理後のExplicitヒープの確保済みサイズは256,256K，最大サイズは1,048,576Kとなっています。

自動解放処理に0.1124626秒掛かっています。

自動解放処理後のサブ状態がEnableであるExplicitメモリブロック数は423です。

Explicitヒープの利用済みサイズ584Kに対して自動解放処理を実行しました。

ID（2，4，6，9）のExplicitメモリブロックがID（10）のExplicitメモリブロックに移動しています。

ID（1，8）のExplicitメモリブロックが，同じID（1，8）に移動しています。

6　トラブルシューティングの手順

ここでは，アプリケーションサーバのトラブルシューティングの手順について説明します。

6.1　この章の構成

この章では，アプリケーションサーバで発生する主なトラブルと，そのトラブルシュートについて説明します。

この章の構成を次の表に示します。

表6‒1　この章の構成（トラブルシューティングの手順）

分類

タイトル

参照先

解説

主なトラブルの一覧

6.2

ログを出力するプロセス

6.3

構築時のトラブルシュート

6.4.1

稼働（運用）時のトラブルシュート

6.4.2

サーバ管理コマンドでのトラブルシュート

6.4.3

運用時のトラブルシュートの例

6.5

6.2　主なトラブルの一覧

トラブルが発生したタイミングごとに，主なトラブルの原因や対処に必要なログの調査個所について説明します。

ここでは，次に示すタイミングごとにトラブルの主な原因や対処などについて説明します。

インストール時

サーバ構築時

サーバ起動時

アプリケーションの開始時

稼働（運用）時

サーバ／アプリケーションの保守（メンテナンス）時

それぞれについて説明します。

6.2.1　インストール時に発生する主なトラブル

インストール時に発生する主なトラブルについて次の表に示します。

表6‒2　インストール時に発生する主なトラブル一覧

トラブルを知らせるツール

現象

主な影響

主な原因

調査個所

インストーラ

エラーメッセージ出力（ダイアログまたはコマンドプロンプト）

インストールが中断します。場合によってはアンインストールが必要です。

環境（OS，ディスクなど）に問題があります。

ダイアログ

install.log

（凡例）　−：該当なし。

参考

インストールおよびアンインストールに関する注意については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録I　インストールおよびアンインストールするときの注意事項」を参照してください。

6.2.2　サーバ構築時に発生する主なトラブル

サーバ構築時に発生する主なトラブルについて説明します。

表6‒3　サーバ構築時に発生する主なトラブル一覧

トラブルを知らせるツール

現象

主な影響

主な原因

調査個所

参照先

セットアップウィザード

エラーメッセージ出力（コマンドプロンプト）

構築作業が中断します。場合によってはアンセットアップが必要です。

次に示す原因が考えられます。

環境（OS，ネットワーク，メモリ，ディスクなど）に問題がある

操作誤り

設定誤り

コマンドエラー

セットアップウィザードログ

Managerログ

J2EEサーバログ

Webサーバログ

OS

6.4.1

SmartComposer

エラーメッセージ出力（コマンドプロンプト）

コマンドエラー

Managerログ

J2EEサーバログ

Webサーバログ

OS

運用管理ポータル

エラーメッセージ出力（GUI）

ログ表示

Managerログ

J2EEサーバログ

Webサーバログ

OS

6.2.3　サーバ起動時に発生する主なトラブル

サーバ起動時に発生する主なトラブルについて説明します。

表6‒4　サーバ起動時に発生する主なトラブル一覧

トラブルを知らせるツール

現象

主な影響

主な原因

調査個所

参照先

SmartComposer

エラーメッセージ出力（コマンドプロンプト）

デプロイ作業が中断します。

次に示す原因が考えられます。

環境（OS，ネットワーク，メモリ，ディスクなど）に問題がある

操作誤り

設定誤り

コマンドエラー

Managerログ

J2EEサーバログ

Webサーバログ

OS

6.4.1

運用管理ポータル

エラーメッセージ出力（GUI）

ログ表示

Managerログ

J2EEサーバログ

Webサーバログ

OS

6.2.4　アプリケーションの開始時に発生する主なトラブル

アプリケーションの開始時に発生する主なトラブルについて説明します。

表6‒5　アプリケーションの開始時に発生する主なトラブル一覧

トラブルを知らせるツール

現象

主な影響

主な原因

調査個所

参照先

SmartComposer（互換用）

エラーメッセージ出力（コマンドプロンプト）

デプロイ作業が中断します。

次に示す原因が考えられます。

環境（OS，ネットワーク，メモリ，ディスクなど）に問題がある

操作誤り

設定誤り

作成したアプリケーションに問題がある

アプリケーションとアプリケーションサーバとの間に問題がある

コマンドエラー

Managerログ

J2EEサーバログ

Webサーバログ

OS

6.4.1

運用管理ポータル

エラーメッセージ出力（GUI）

ログ表示

Managerログ

adminログ

J2EEサーバログ

Webサーバログ

OS

サーバ管理コマンド※

エラーメッセージ出力（コマンドプロンプト）

コマンドエラー

adminログ

J2EEサーバログ

アプリケーション

6.4.3

注※

サーバ管理コマンドを使用している場合は，トラブルの対処が異なります。表に示す参照先の対処を確認してください。

6.2.5　稼働（運用）時に発生する主なトラブル

稼働（運用）時に発生する主なトラブルについて説明します。

表6‒6　稼働時（運用時）に発生する主なトラブル一覧

トラブルを知らせるツール

現象

主な影響

主な原因

調査個所

参照先

運用管理ポータル

エラーメッセージ出力（GUI）

業務が継続できません。

次に示す原因が考えられます。

環境（OS，ネットワーク，メモリ，ディスクなど）に問題がある

サーバ内部のリソース枯渇（OOMなど）

連携システム（DBなど）に問題がある

アプリケーションの上長な処理

HA切り替え

ログ表示

Managerログ

J2EEサーバログ

Webサーバログ

OS

JavaVM，コンテナリソース

PRFトレース

スレッドダンプ

アプリケーション

6.4.2

（クライアント）※

業務のエラー出力

ブラウザ固有のエラー（サーバが見つからない，404，500，503など）

無応答

応答遅延（性能劣化）

業務が継続できないことがあります。

ログ表示

Managerログ

J2EEサーバログ

Webサーバログ

OS

JavaVM，コンテナリソース

PRFトレース

スレッドダンプ

アプリケーション

注※　サービスを利用しているクライアント側の現象として現れます。

6.2.6　サーバ／アプリケーションの保守（メンテナンス）時に発生する主なトラブル

サーバ／アプリケーションの保守（メンテナンス）時に発生する主なトラブルについて説明します。

表6‒7　サーバ／アプリケーションの保守（メンテナンス）時に発生する主なトラブル一覧

トラブルを知らせるツール

現象

主な影響

主な原因

調査個所

参照先

SmartComposer

エラーメッセージ出力（コマンドプロンプト）

サーバの設定変更ができません

アプリケーションの更新ができません

次に示す原因が考えられます。

環境（OS，ネットワーク，メモリ，ディスクなど）に問題がある

操作誤り

設定誤り

作成したアプリケーションに問題がある

アプリケーションとアプリケーションサーバとの間に問題がある

コマンドエラー

Managerログ

J2EEサーバログ

Webサーバログ

OS

6.4.1

運用管理ポータル

エラーメッセージ出力（GUI）

ログ表示

Managerログ

adminログ

J2EEサーバログ

Webサーバログ

OS

サーバ管理コマンド※

エラーメッセージ出力（コマンドプロンプト）

コマンドエラー

adminログ

J2EEサーバログ

OS

アプリケーション

6.4.3

注※

サーバ管理コマンドを使用している場合は，トラブルの対処が異なります。表に示す参照先の対処を確認してください。

6.3　ログを出力するプロセス

アプリケーションサーバでは，複数のログを出力します。これらのログを参照して，トラブルの原因を特定し対処します。

ここでは，トラブルシュートで主に使用するログと，そのログを出力するプロセスについて説明します。トラブルシュートで主に使用するログと出力するプロセスを次の図に示します。

図6‒1　ログを出力するプロセス

アプリケーションサーバのトラブルシュートで主に使用するログは4種類です。それぞれについて次の表に示します。

表6‒8　ログの種類と出力内容

図中の番号

ログの種類

出力内容

1

Managerのログ

Management Serverまたは運用管理エージェントが出力するログです。Manager機能を使用した構築・運用・保守で出力されるログです。

2

サーバ管理コマンドのログ

サーバ管理コマンドの操作で出力されるログです。

3

Webサーバのログ

HTTP Serverから出力されるログです。

4

J2EEサーバのログ

J2EEサーバから出力されるログです。

トラブルシュートでは，これらのログを確認して対処します。以降では，使用するツールごとに具体的なトラブルシュートの流れについて説明します。

6.4　トラブルシュートの流れ

6.4.1　構築時のトラブルシュート

ここでは，構築時に発生するトラブルの対処について説明します。

構築時とは，次に示すタイミングを指します。

サーバの構築時

サーバの起動時

アプリケーションの開始時

サーバ／アプリケーションの保守（メンテナンス）時

構築時の調査の流れを示します。

図6‒2　使用しているツールごとの調査の流れ（構築時）

使用しているツールごとに，図で示した流れに従って，必要な調査を実施します。以降の説明では，それぞれの調査の詳細について説明します。

参考

Managerログの調査では，運用管理ポータルを利用します。運用管理ポータルについては，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

(1)　コマンドエラーの調査

ポイント

次のツールを使用している場合に必要な調査です。

セットアップウィザード

SmartComposer

セットアップウィザードやSmartComposerの画面にエラーが表示されます。表示されたエラーの内容を確認して対処します。エラーメッセージの対処については，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照してください。

(2)　セットアップウィザードログの調査

ポイント

次のツールを使用している場合に必要な調査です。

セットアップウィザード

セットアップウィザードのログを確認します。セットアップウィザードのログの出力先は，setup.cfgのsetup.log.dirで指定した出力先です。setup.cfgについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.18　setup.cfg（セットアップウィザード用設定ファイル）」を参照してください。

(3)　ログの表示，およびManagerログの調査

ポイント

次のツールを使用している場合に必要な調査です。

セットアップウィザード

運用管理ポータル

SmartComposer

運用管理ポータルを使って，Managerで出力されたログを確認します。ログの表示方法を次に示します。

運用管理ポータルで［論理サーバのアプリケーション管理］アンカーをクリックします。

ツリーペインで次のどちらかの操作をします。

J2EEサーバの場合

［論理J2EEサーバ］−［J2EEサーバ］−［＜J2EEサーバ名＞］−［アプリケーション］をクリックします。

J2EEサーバクラスタの場合

［論理J2EEサーバ］−［J2EEサーバクラスタ］−［＜J2EEサーバクラスタ名＞］−［アプリケーション］をクリックします。または，［論理J2EEサーバ］−［J2EEサーバクラスタ］−［＜J2EEサーバクラスタ名＞］−［メンバ］−［＜J2EEサーバ名＞］−［アプリケーション］をクリックします。

［ログの表示］タブをクリックします。

運用管理ポータルの画面でログを表示した場合の画面を次に示します。

図6‒3　運用管理ポータルの画面でログを表示した場合の出力例

［ログの表示］タブでログを表示させたあと，システムの障害が判明したタイミングに近い時刻に出力されたメッセージを探します。そして，エラーメッセージ（メッセージIDがEで終わっているもの）を特定し，障害が発生した論理サーバの種類と名前を確認してください。

(4)　adminログの調査

ポイント

次のツールを使用している場合に必要な調査です。

運用管理ポータル

なお，この調査はアプリケーションの開始時にエラーが発生した場合に必要な調査です。

サーバ管理コマンドのログを確認します。

サーバ管理コマンドのログには，メッセージログ，例外ログ，および保守用ログの3種類があります。これらのログには，サーバ管理コマンドの稼働状態，アプリケーション中で出力される標準出力，および標準エラー出力の情報，保守員がComponent Containerの障害解析用に使用する情報などが出力されます。

ログファイルのデフォルトの出力先や，ログファイル名については，「4.3.1　Component Containerのログの取得」のサーバ管理コマンドのログに関する説明を参照してください。

(5)　J2EEサーバログの調査

ポイント

次のツールを使用している場合に必要な調査です。

セットアップウィザード

運用管理ポータル

SmartComposer

J2EEサーバで出力されたログファイルの内容を確認します。確認するログファイルの一覧を次に示します。

表6‒9　採取するログファイルの一覧

ログファイル名※

ログの説明

確認方法

cjmessage?.log

J2EEサーバ稼働時のログ

Managerでエラーメッセージが出力された時刻のエラーメッセージID（メッセージ種別がEのもの）の内容を確認します。

cjexception?.log

J2EEサーバ稼働時の例外情報ログ

web_servlet?.log

Webサーブレットログ（JSP／Servletでのメッセージの出力）

user_out?.log

ユーザ出力ログ（アプリケーションでのメッセージの標準出力）

user_err?.log

ユーザエラーログ（アプリケーションでのメッセージの標準エラー出力）

javalog?.log

JavaVMの保守情報およびGC情報のログ

hs_err?

JavaVMのエラーリポートファイル

保守員に送付してください。

注※　「?」はログの面数を示します。

なお，ログファイルのデフォルトの出力先については，「4.3.1　Component Containerのログの取得」を参照してください。

hs_errの取得方法については，「4.11　JavaVM出力メッセージログ（標準出力またはエラーリポートファイル）」を参照してください。

(6)　Webサーバログの調査

ポイント

次のツールを使用している場合に必要な調査です。

セットアップウィザード

運用管理ポータル

SmartComposer

Webサーバで出力されたログファイルを確認します。確認するログファイルの一覧を次に示します。

表6‒10　採取するログファイルの一覧

ログファイル名※

ログの説明

確認方法

processConsole?.log

Managerのコンソールログ（Webサーバ起動時のエラー情報）

Managerでエラーメッセージが出力された時刻のエラーメッセージID（メッセージ種別がEのもの）の内容を確認します。

error?

Webサーバのエラーログ

Managerでエラーメッセージが出力された時刻のエラーメッセージ（「emerg」，「alert」，「crit」のもの）の内容を確認します。

注※　「?」はログの面数を示します。

なお，Managerのコンソールログのデフォルトの出力先については，「4.11　JavaVM出力メッセージログ（標準出力またはエラーリポートファイル）」を参照してください。

Webサーバのエラーログのデフォルトの出力先については，マニュアル「HTTP Server」の「6.2.4　E，F，G，H，Iで始まるディレクティブ」を参照してください。

(7)　OS周りの調査

ポイント

次のツールを使用している場合に必要な調査です。

セットアップウィザード

運用管理ポータル

SmartComposer

アプリケーションサーバをインストールしているマシンのメモリサイズや稼働状態を確認してください。

6.4.2　稼働（運用）時のトラブルシュート

ここでは，稼働（運用）時に発生するトラブルの対処について説明します。

稼働時とは，サーバ起動完了直後／サーバ稼働中のタイミングです。

使用しているツールごとに稼働時の調査の流れを示します。

図6‒4　使用しているツールごとの調査の流れ（稼働時）

使用しているツールごとに，図で示した流れに従って，必要な調査を実施します。以降の説明では，それぞれの調査の詳細について説明します。

参考

Managerログの調査では，運用管理ポータルを利用します。運用管理ポータルについては，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

(1)　ログの表示，およびManagerログの調査

運用管理ポータルを使って，Managerで出力されたログを確認します。ログの表示，およびManagerログの調査については，「6.4.1(3)　ログの表示，およびManagerログの調査」を参照してください。

(2)　J2EEサーバログの調査

J2EEサーバで出力されたログファイルを確認します。J2EEサーバログの調査については，「6.4.1(5)　J2EEサーバログの調査」を参照してください。

(3)　Webサーバログの調査

Webサーバで出力されたログファイルを確認します。Webサーバログの調査については，「6.4.1(6)　Webサーバログの調査」を参照してください。

(4)　OS周りの調査

アプリケーションサーバをインストールしているマシンのメモリサイズや稼働状態を確認してください。

(5)　JavaVM，コンテナリソースの調査

JavaVMに問題が発生していないか（OutOfMemoryErrorが発生していないか），また，リソースに問題が発生していないか確認します。JavaVMに問題が発生した場合の対処については，「2.5.4　JavaVMが異常終了した場合」を参照してください。

(6)　PRFトレースの調査

性能解析トレースを調査して，ボトルネック個所がないか，処理が滞っている個所がないか確認します。性能解析トレースについては，「7.　性能解析トレースを使用した性能解析」を参照してください。

(7)　スレッドダンプの調査

スレッドダンプを調査して，デッドロックしている処理がないか，Javaプログラムに問題がないか確認します。スレッドダンプに出力される情報については，「5.5　JavaVMのスレッドダンプ」を参照してください。

(8)　アプリケーションの調査

問題が発生したと考えられるアプリケーションの内容を調査します。アプリケーションの作成元に確認を依頼してください。

6.4.3　サーバ管理コマンドのトラブルシュート

ここでは，サーバ管理コマンドを使用している場合のトラブルの対処について説明します。

ここで説明するトラブルの対処を次に示します。

アプリケーションの開始時

サーバ／アプリケーションの保守（メンテナンス）時

サーバ管理コマンドを使用した調査の流れを示します。

図6‒5　サーバ管理コマンドを使用した調査の流れ

それぞれの作業の詳細を示します。

(1)　コマンドエラーの調査

コマンドプロンプトにエラーが表示されます。表示されたエラーの内容を確認して対処します。

(2)　adminログの調査

サーバ管理コマンドのログを確認します。ログファイルのデフォルトの出力先については，「4.3.1　Component Containerのログの取得」のサーバ管理コマンドのログに関する説明を参照してください。

(3)　J2EEサーバログの調査

J2EEサーバで出力されたログファイルを確認します。J2EEサーバログの調査については，「6.4.1(5)　J2EEサーバログの調査」を参照してください。

(4)　アプリケーションの調査

問題が発生したと考えられるアプリケーションの内容を調査します。アプリケーションの作成元に確認を依頼してください。

6.5　運用時のトラブルシュートの例

ここでは，運用時のトラブルシュートの例として，次に示すトラブルが発生した場合のトラブルシュートの流れを示します。

プロセスダウン

応答遅延

注意事項

この節では，アプリケーションサーバのデフォルトの設定のパスを記載しています。また，使用するOSはWindowsです。

6.5.1　プロセスダウンのトラブルシュート

プロセスダウンのトラブルシュートについて説明します。

(1)　プロセスダウン発生時の対処フロー

プロセスダウンが発生した場合の，トラブルシュートの流れを次に示します。

図6‒6　プロセスダウン発生時の対処フロー

フローの詳細で示した処理の詳細は(2)で説明します。

(2)　プロセスダウン発生時の対処の流れ

プロセスダウンのフローの内容に沿って，それぞれの作業について説明します。

エラーリポートファイル（hs_err_pid<プロセスID>.log）を開く

エラーが発生した時刻近辺に出力されたエラーリポートファイルを開き，Managerのログと突き合わせます。

エラーリポートファイルの出力先および出力ファイル名

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥public¥ejb¥<サーバ名称>¥hs_err_pid<サーバプロセスID>.log

OutOfMemoryErrorが発生しているかどうか確認する

OutOfMemoryErrorが発生している場合，「java.lang.OutOfMemoryError occurred.」が表示されています。

OutOfMemoryErrorが発生している場合，およびOutOfMemoryErrorが発生していない場合について，それぞれエラーリポートファイルの出力例と対処を次に示します。

OutOfMemoryErrorが発生している場合

出力例

  ：
#
# java.lang.OutOfMemoryError occurred.
# JavaVM aborted because of specified -XX:+HitachiOutOfMemoryAbort options.
# Please check Javacorefile:D:¥Cosminexus¥CC¥server¥public¥ejb¥MyJ2EEServer¥javacore2100.120124144835.txt
#

背景色付きの太字で示した個所がOutOfMemoryErrorが発生している場合に出力される文字列です。

対処

エラーリポートファイルを調査する必要があります。手順3.へ進んでください。

OutOfMemoryErrorが発生していない場合

出力例

  ：
#
# A fatal error has been detected by the Java Runtime Environment
#
#  EXCEPTION_ACCESS_VIOLATION (0xc0000005) at pc=0x0000000008303b00, pid=1356, tid=2604
#
# Java VM: Java HotSpot(TM) 64-Bit Server VM (25.20-b23-CDK0970-20150127 mixed mode windows-amd64)
# Problematic frame:
# V  [C:¥Program Files¥Hitachi¥Cosminexus¥jdk¥jre¥bin¥server¥jvm.dll+0x303b00]
#

対処

次のような調査が必要です。手順に従って調査してください。なお，手順の番号は図6-6と対応しています。

3-1　シグナルが発生したライブラリを確認する

出力例の赤字部分を確認し，ダウンしたライブラリ名，およびダウンしたネイティブ関数を控えてください。

出力例の場合，ライブラリ名は「NativeCrash.dll」，ダウンしたネイティブ関数は「(null)+0x77C785BA」となります。

3-2　シグナルを確認する

「An unexpected error has been detected by HotSpot Virtual Machine:」で続く個所がシグナル6（SIGABRT，SIGIOT）でダウンしている場合，上位のabort関数でアボートしていることから呼び出し先のライブラリを調査する必要があります。

上記の例はアボートしていません。

この例では，Oracleのサポートに詳細な調査を依頼します。

3-3　収集結果を問い合わせ窓口に送付する

ひかえておいたライブラリ，およびシグナルの内容をモジュール開発元，またはご購入契約に基づくお問い合わせ窓口に送付して調査を依頼してください。

拡張verbosegc情報を確認してメモリサイズをチューニングする

拡張verbosegc情報を確認して，Javaヒープのメモリサイズを調整します。

設定済みの-Xmxオプションの値を目安として1.5倍〜2倍にしてください。ただし，ハード搭載メモリサイズを超えないように注意してください。

マシンを再起動する

マシンを再起動して，問題なく動作できるか確認します。

ポイント

マシンを再起動し，問題なく動作した場合は，トラブルシュートは完了です。

マシンを再起動してもうまく動作しない場合は，手順5.へ進んでください。

クラス別統計情報を出力する

JavaVMのGCのログ（javalog[n].log），または稼働情報ログ（HJVMStats_<YYYYMMDDhhmm><TZ>.csv）を確認し，メモリが10MB〜20MB増加するごとにjheapprofコマンドを実行してクラス別統計情報（txtファイル）を出力します。

メモリが100MB以上増加するまで繰り返してください。

コマンドの実行間隔が短い場合，リークしているメモリサイズも小さいためメモリ増加しているクラスを探すのが難しくなります。

実行間隔を長くしメモリの増分を大きくすることで，リークしているクラスを目立たせます。

実行例

% jheapprof -p 2463

注意

実行例の「2463」はプロセスIDになります。コマンドを実行する場合は問題となっているプロセスIDを指定してください。

クラス構造一覧を出力する

前の手順でピックアップしたクラスをメンバに持つクラスの構造を一覧に出力し，調査対象のクラスリストを作成し，調査対象をリストアップします。

実行例

% jheapprof -class org.apache.catalina.loader.WebappClassLoder -p 2463

注意

実行例の「2463」はプロセスIDになります。コマンドを実行する場合は問題となっているクラスを指定してください。

実行例の「org.apache.catalina.loader.WebappClassLoder」はクラス名になります。Metaspace領域不足によるOutOfMemoryErrorはこのクラスを使って調べます。

開発元に調査を依頼する

前回の手順で収集した情報を開発元へ送付して，調査を依頼してください。

6.5.2　応答遅延のトラブルシュート

応答遅延のトラブルシュートについて説明します。

(1)　応答遅延発生時の対処のフロー

応答遅延が発生した場合の，トラブルシュートの流れを次に示します。

図6‒7　応答遅延発生時の対処フロー

フローの詳細で示した処理の詳細は(2)で説明します。

(2)　応答遅延発生時の対処の流れ

応答遅延のフローの内容に沿って，それぞれの作業について説明します。

CPUの利用率を調査する

該当するプロセスのCPU利用率を調査します。

タスクマネージャでCPU利用率を表示した例を次に示します。

図6‒8　CPU利用率

ポイント

1coreが100％に近い場合

無限ループや再帰呼び出しに陥っているケースが考えられます。CPUネックが原因と考えられます。手順2.へ進んで調査を進めてください。

1coreが0％に近い場合

バックプロセスから応答が返ってきていないことが原因による，バックプロセス無応答やデッドロックが考えられます。手順2.へ進んで調査を進めてください。

PRFトレースを取得する

mngsvrutilコマンドを実行すると，PRFトレースを出力できます。

実行例

mngsvrutil -m 123.45.67.89 -u admin2 collect allPrfTraces

PRFトレースを開く

PRFトレースを開きます。

出力先

C:¥Program Files¥Hitachi¥Cosminexus¥manager¥log¥prf

ファイル名

トレース情報の収集対象別に次に示すファイル名で出力されます。

なお，<日時>には，PRFトレースを収集した日時が表示されます。

パフォーマンストレーサの種類

ファイル名

運用管理ドメイン内のホスト上で動作しているすべてのパフォーマンストレーサ

<運用管理ドメイン名>−<日時>.zip

特定のホスト上で動作しているすべてのパフォーマンストレーサ

<ホスト名>−<日時>.zip

特定のパフォーマンストレーサ

<論理サーバ名>−<日時>.zip

PRFトレースを調査する

PRFトレースのTime列を確認して，長時間を要している処理を探します。

PRFトレースは，プロセスにわたりイベントを出力するトレース情報で性能解析・障害解析に有効な資料です。

図6‒9　PRFトレースの出力例

例の場合，SQL発行後11分の空白があります。さらにSQLの実行は終了していません。したがって，SQL実行中にDBに何らかの問題が発生したものと考えられます。

なお，PRFトレースは表計算ソフトで表示すると確認しやすくなります。

スレッドダンプを出力する

mngsvrutilコマンドを実行すると，スレッドダンプを出力できます。

実行例

mngsvrutil -m 123.45.67.89 -u admin2 dump server

スレッドダンプを調査する

無限ループの場合

無限ループの場合のスレッドダンプの出力例，および調査のポイントについて説明します。

図6‒10　スレッドダンプ（無限ループ）の出力例

スレッドダンプを複数回出力して，時系列で観察し，それぞれのスレッドダンプでtidの同じスレッドのスタックトレースを比較調査します。

ポイント1

スレッド属性がrunnableの場合，このスレッドは実行可能状態にあります。このスレッドがCPU利用率の増加に関与しています（waiting for monitor entryの場合は実行可能状態ではないので，CPU利用率を増加させません）。

ポイント2

複数のスレッドダンプファイルで，同一のtidのスレッド属性がすべてrunnableです。

長時間にわたって実行中の可能性があります。

ポイント3

同一メソッド内の特定の行が，繰り返し実行されているような場合，無限ループの疑いがあります。

ポイント

ここまでの調査で，無限ループの疑いがある場合は，開発元へ調査を依頼してください。

無限ループの疑いがない場合は手順7.へ進んでください。

デッドロックの場合

デッドロックの場合のスレッドダンプの出力例，および調査のポイントについて説明します。

図6‒11　スレッドダンプ（デッドロック）の出力例

デッドロックが発生している場合のスレッドダンプの例を示します。

出力例の「nid:...」に続いてスレッド属性が出力されます。

「waiting for monitor entry」となっているスレッドを探します。

「-waiting to lock...」，および「-locked...」の内容を確認し，お互いがロックしている領域のロック取得待ちが発生していればデッドロック状態です。

ポイント1

スレッド属性がrunnableの場合，このスレッドは実行可能状態にありますので，このスレッドはデッドロックとは無関係です。

ポイント2

スレッド属性がwaiting for monitor entryである場合，このスレッドはロックの取得待ちであることを示しています。

デッドロックを起こしているスレッドである可能性があります。

ポイント3

スレッドがロックを取得していて，かつ，ポイント2でスレッドのロック待ちの場合，デッドロックを起こしているスレッドである可能性がさらに高いです。

ポイント2，ポイント3に当てはまるスレッドに対して，ロックしているオブジェクトのアドレスを突き合わせながらデッドロックを検出します。

例の場合，Thread-3は，<02A328C8>のロックを取得して，かつ<02A328C0>の取得待ちを示します。

一方，Thread-1は，<02A328C0>のロックを取得していて，かつ<02A328C8>の取得待ちとなっていて，Thread-3とThread-1がデッドロックしていることがわかります。

ポイント

ここまでの調査で，デッドロックの疑いがある場合は，開発元へ調査を依頼してください。

デッドロックの疑いがない場合は手順7.へ進んでください。

業務アプリケーションを改修する。冗長な処理を取り除く

PRFトレース，およびスレッドダンプの調査の結果を基に，業務アプリケーションで遅延している疑いがある場合は調査して対策します。

ポイント

問題が解決した場合は，これでトラブルシュートは完了です。

問題が解決しない場合で，CPU使用率が高い場合は，手順8.へ進んでください。

問題が解決しない場合で，CPU使用率が低い場合は，ご購入契約に基づくお問い合わせ窓口に調査を依頼してください。

同時実行スレッド数のパラメタを小さくして，同時実行処理数を抑える

実行待ちリクエストが溜まることがありますが，多少処理を待たせた方がよいです。

マシンのCPUを増設する

CPUの増設では，ミドルウェアのライセンス費用の追加に注意してください。

マシンを追加し，トランザクションを負荷分散させる

マシンを追加する場合は，ハードウェア／ソフトウェアのライセンス費用の追加に注意してください。

ポイント

問題が解決した場合は，これでトラブルシュートは完了です。

問題が解決しない場合は，ご購入契約に基づくお問い合わせ窓口に調査を依頼してください。

7　性能解析トレースを使用した性能解析

性能解析トレースは，クライアントからのリクエストを処理するときにアプリケーションサーバの各機能が出力する性能解析情報（トレース情報），およびアプリケーションの処理が出力する性能解析情報（トレース情報）を収集する機能です。

この情報を基に，システムおよびアプリケーションの処理性能を解析できます。この章では，性能解析トレースを使用して，システムおよびアプリケーションの性能を解析する方法について説明します。なお，性能解析トレースによって性能解析情報が取得されるポイント（トレース取得ポイント）や，情報の取得範囲（PRFトレース取得レベル）については，「8.　性能解析トレースのトレース取得ポイントとPRFトレース取得レベル」を参照してください。

7.1　この章の構成

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

この章の構成を次の表に示します。

表7‒1　この章の構成（性能解析トレース）

分類

タイトル

参照先

解説

性能解析トレースの概要

7.2

Management Serverを利用した性能解析トレースファイルの収集

7.3

実装

性能解析トレースのルートアプリケーション情報取得のための実装

7.4

設定

実行環境での設定

7.5

運用

ユーザ拡張性能解析トレース実行時に出力されるログ情報

7.6

性能解析トレースファイルを使用した処理性能の解析作業

7.7

注意事項

ユーザ拡張性能解析トレース使用時の注意事項

7.8

7.2　性能解析トレースの概要

性能解析トレースは，アプリケーションサーバの各機能やアプリケーションの処理が出力する性能解析情報を使用して，アプリケーションサーバおよびアプリケーションの処理性能を解析する機能です。

性能解析トレース機能には，使用する性能解析情報によって次の種類があります。

アプリケーションサーバの性能解析トレース

アプリケーションの性能解析トレース

なお，どちらの場合も処理性能の解析に，Performance Tracerという構成ソフトウェアを使用します。

性能解析トレースの概要を次の図に示します。

図7‒1　性能解析トレースの概要

図中の1.および2.はアプリケーションサーバの性能解析トレース，3.および4.はアプリケーションの性能解析トレースです。どちらの性能解析トレースも，性能解析トレース情報としてまとめて解析できます。

7.2.1　アプリケーションサーバの性能解析トレースの概要

アプリケーションサーバの性能解析トレースは，クライアントからのリクエストを処理する過程でアプリケーションサーバの各機能が出力する性能解析情報（トレース情報）や，セッションのライフサイクルを判断するための情報を使用して，アプリケーションサーバの処理性能を解析する機能です（以降，アプリケーションサーバの性能解析トレースを性能解析トレースと呼びます）。アプリケーションサーバのボトルネックを解析したり，障害が発生した場合にリクエストの処理がどこまで到達したかを調べてトラブルシュートの効率向上を図ったり，セッションやグローバルセッション情報のライフサイクルを把握したりできます。

(1)　性能解析トレースのトレース情報収集

性能解析トレースのトレース情報には，クライアントからデータベースなどのEISに至るまで，およびその処理結果がクライアントに返却されるまでのリクエストの一連の処理で出力される性能解析情報が収集されます。

性能解析トレースのトレース情報収集の概要を，次の図に示します。

図7‒2　性能解析トレースのトレース情報収集の概要

WebクライアントまたはEJBクライアントからリクエストが送信された場合に，Webサーバ，J2EEサーバおよびCTMでは，決まった処理のポイントでトレース情報がバッファに出力されます。出力された情報は，一定量たまるとパフォーマンストレーサ（PRFデーモン）によって，トレースファイル（PRFトレースファイル）に出力されます。トレースが出力されるポイントを，トレース取得ポイントといいます。パフォーマンストレーサには，トレース取得レベル（標準または詳細）を設定できます。パフォーマンストレーサに設定するトレース取得レベルをPRFトレース取得レベルといいます。

Management Serverを利用して運用している場合は，PRFトレースファイルをテキスト形式に編集した性能解析トレースファイルを収集できます。運用管理者は，収集した性能解析トレースファイルを基に，運用管理ドメイン内全体の性能解析およびボトルネックの解析ができるようになります。性能解析トレースファイルの収集方法や出力情報については，「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(2)　性能解析トレースの仕組み

性能解析トレースでは，システム内部のイベント単位で，複数のノードおよびプロセス間にわたるトレース情報を取得できます。これによって，一連の処理の中で，どの処理がボトルネックになっているかをトレースできます。

イベント単位でトレースを取得するために，性能解析トレースでは，イベント単位の一連の処理に一貫したキーを設定して管理します。イベント内のトレース取得ポイントで出力するトレースには，キーの情報が付加されます。これによって，一連の処理がトレースできます。

図7‒3　性能解析トレースによるトレース出力の概要

なお，トレースを出力するEJBコンテナ，Webコンテナなどを，機能レイヤといいます。性能解析トレースでは，次の機能レイヤの入り口と出口でトレース情報を出力します。必要に応じて，各機能レイヤ内の処理のうち，性能に影響を与える処理ごとにも，トレース情報を出力します。アプリケーションの実行環境と該当する機能レイヤを次の表に示します。

表7‒2　アプリケーションの実行環境と該当する機能レイヤ

機能レイヤ

アプリケーションの実行環境

J2EEアプリケーションの実行環境

バッチアプリケーションの実行環境

CTM

○

−

Webコンテナ

○

−

EJBコンテナ

○

−

Timer Service

○

−

JNDI

○

○

JTA

○

○

JCAコンテナ

○

○

DB Connector

○

○

RMI（通信処理）※1

○

○

OTS

○

○

標準出力/標準エラー出力/ユーザログ

○

○

DI

○

−

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

−

○※2

JPA

○

−

TP1インバウンド連携機能

○

−

CJMSプロバイダ

○

−

JavaMail

○

−

CDI

○

−

JSF 2.3

○

−

JAX-RS

○

−

Java Batch

○

−

（凡例）○：該当する　−：該当しない

注※1

RMI（通信処理）の機能レイヤについては，トレース情報の取得を抑止することができます。その場合，トレース取得レベルに「抑止」を設定します。設定方法については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cprfstart（PRFデーモンの開始）」，またはマニュアル「アプリケーションサーバ リファレンス コマンド編」の「cprflevel（PRFトレース取得レベルの表示と変更）」を参照してください。

注※2

トレース情報は，バッチアプリケーションの実行直前（mainメソッドを呼ぶ直前），およびバッチアプリケーション終了直後に出力されます。cjexecjobコマンドおよびcjkilljobコマンドの実行では出力されません。

また，性能解析トレースでは，これらの機能レイヤのほかに，J2EEサーバの開始処理，終了処理，トランザクションタイムアウト発生時，およびセッションの生成／破棄でもトレースを出力します。

なお，トレース情報の内容には，トレース情報を取得したプロセスID，取得ポイントを示すイベントID，トレース取得年月日やトレース情報を取得したクライアントアプリケーションのIPアドレスなどの情報が含まれます。

参考

これらの機能レイヤのほか，Application Serverの構成ソフトウェアおよび関連プログラムでも，次の機能レイヤでPRFトレースが取得できます。

Web Services - Base

TP1 Connector

TP1/Client/J

TP1/MQ Access

Reliable Messaging

HCSCサーバ

HCSCサーバ（Object Accessアダプタ）

Service Coordinator Interactive Workflow

HCSCサーバ（ファイルアダプタ）

HCSCサーバ（Message Queueアダプタ）

HCSCサーバ（FTPアダプタ）

JAX-WSエンジン

Elastic Application Data store

トレース情報のキー情報は，次の要素で構成されています。

キー情報の構成

キー情報を取得したプロセスID

キー情報を取得したプロセスが起動しているホストのIPアドレス

PRFトレースのI／Oプロセス（PRFデーモン）単位で割り当てられる通信番号

なお，PRFデーモンが起動していない場合は，通信番号として時刻が返却されます。ただし，この場合，通信番号の一意性を保てないおそれがあるので，PRFデーモンは必ず起動してください。

PRFトレースには，次の2種類のキー情報が付与されます。

ルートアプリケーション情報

各イベントで一連の処理の先頭になるプロセスで取得した情報です。

J2EEアプリケーションの場合

HTTP Server，NIO HTTPサーバ，またはEJBクライアントで取得した情報になります。

バッチアプリケーションの場合

バッチアプリケーションの実行直前に取得した情報になります。

クライアントアプリケーション情報

J2EEアプリケーションの場合，次に示すEnterprise Beanを呼び出す処理単位で設定される情報です。

WebコンテナからEJBコンテナの呼び出し

EJBクライアントからEJBコンテナの呼び出し

EJBコンテナからEJBコンテナの呼び出し

なお，バッチアプリケーションの場合は，バッチアプリケーションの実行直前に設定される情報になります。

(3)　性能解析トレースの構成

性能解析トレースは，次のプログラムで構成されています。

PRFトレース出力ライブラリ

アプリケーションサーバの各機能レイヤに組み込まれています。各機能レイヤが出力したPRFトレースを，共用メモリに作成されたバッファに出力します。

PRFデーモン

バッファに出力されたPRFトレースを，一定量たまったらファイルに出力する，I／Oプロセスです。PRFトレースを取得するホストごとに，一つ以上起動します。一つのホストに一つ配置することをお勧めします。

PRFトレース出力ライブラリとPRFデーモンの関係を次の図に示します。

図7‒4　PRFトレース出力ライブラリとPRFデーモンの関係

PRFトレース出力ライブラリによってトレースが出力されるバッファ領域は，PRFデーモン起動時に作成されます。バッファ領域は，共用メモリに作成されます。ただし，前回PRFデーモンを起動した時に作成したバッファ領域が残っている場合は，その領域を再利用します。バッファ領域が削除されないで残っているのは，前回起動したPRFデーモンが異常終了した場合です。

PRFデーモンが正常終了した場合，バッファ領域内のバッファデータはPRFトレースファイルに出力され，バッファ領域は削除されます。

バッファ領域が不足すると，KFCT26999-Wのメッセージが出力されて，PRFトレースが完全に出力されない場合があります。そのため，このメッセージが出力される場合は，バッファサイズのチューニングをしてください。

(4)　トレース情報の取得によるトラブルシュート

トレース情報を利用したトラブルシュートについて説明します。

性能解析トレースに出力される情報を取得することで，トラブルシュートとして次のように使用できます。

J2EEアプリケーションのトランザクションがタイムアウトした場合やHTTP Serverのリバースプロキシでのレスポンス受信時にタイムアウトが発生した場合，性能解析トレースに出力されるルートアプリケーション情報を使用して，タイムアウトしたトランザクションやリクエストを特定できます。

データベースとの接続中にトラブルが発生した場合，性能解析トレースに出力されるコネクションIDを利用して，トラブルが発生したコネクションを特定できます。

7.2.2　アプリケーションの性能解析トレースの概要

アプリケーションの性能解析トレースは，アプリケーションの開始から終了までの過程で，アプリケーションのトレース対象の処理が実行された時点で出力される性能解析情報（トレース情報）を使用して，アプリケーションの処理性能を解析する機能です（以降，アプリケーションの性能解析トレースをユーザ拡張性能解析トレースと呼びます）。ユーザ拡張性能解析トレースは，アプリケーションサーバの性能解析トレースを使用していることが前提となります。ボトルネックとなる処理を特定したり，障害が発生した場合に処理がどこまで到達したかを調べてトラブルシュートの効率向上を図ったりできます。また，どの処理を性能解析情報の取得対象とするかはユーザ拡張性能解析トレース設定ファイルで指定します。アプリケーションに性能解析情報の取得処理を実装する必要がないため，アプリケーションの性能を確認したり比較したりする作業を効率良く実施できます。

(1)　ユーザ拡張性能解析トレースのトレース情報収集

ユーザ拡張性能解析トレースのトレース情報には，ユーザ拡張性能解析トレース設定ファイルで指定した処理が実行された時点で出力される性能解析情報が収集されます。

ユーザ拡張性能解析トレースのトレース情報収集の概要を，次の図に示します。

図7‒5　ユーザ拡張性能解析トレースのトレース情報収集の概要

J2EEサーバが起動すると，ユーザ拡張性能解析トレース設定ファイルが読み込まれます。ユーザ拡張性能解析トレース設定ファイルに指定された処理（トレース取得ポイント）が呼ばれると，トレース情報がバッファに出力されます。出力された情報は，一定量溜まるとパフォーマンストレーサ（PRFデーモン）によって，トレースファイル（PRFトレースファイル）に出力されます。

Management Serverを利用して運用している場合は，PRFトレースファイルをテキスト形式に編集した性能解析トレースファイルを収集できます。運用管理者は，収集した性能解析トレースファイルを基に，運用管理ドメイン内全体の性能解析およびボトルネックの解析ができるようになります。性能解析トレースファイルの収集方法や出力情報については，「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(2)　ユーザ拡張性能解析トレースの仕組み

ユーザ拡張性能解析トレースでは，トレース情報を取得する対象メソッドの名前をユーザ拡張性能解析トレース設定ファイルで指定します。指定したメソッド名のトレース出力の概要を次の図に示します。

図7‒6　ユーザ拡張性能解析トレースによるトレース出力の概要

ユーザ拡張性能解析トレースを有効に設定している場合，ユーザ拡張性能解析トレースはユーザ拡張性能解析トレース設定ファイルを読み込みます。アプリケーションが実行され，ユーザ拡張性能解析トレース設定ファイルに指定したメソッド（トレース対象メソッド）が呼び出されると，次の位置でトレース情報を出力します。

メソッドの入口

メソッドが開始された直後のトレース情報。

メソッドの正常出口

メソッドが正常終了する直前のトレース情報。

メソッドの異常出口

メソッドで例外またはエラーが発生した直後のトレース情報。ただし，メソッドの呼び出し元にスローされない例外やエラーは除きます。

(3)　ユーザ拡張性能解析トレースの構成

ユーザ拡張性能解析トレースは次の要素で構成されています。

なお，ユーザ拡張性能解析トレースは，性能解析トレースを出力するために，インストゥルメンテーション機能のクラスロードフック処理を利用して，トレース対象のアプリケーションを書き換えています。

ユーザ拡張性能解析トレース設定ファイル

ユーザ拡張性能解析トレースのトレース対象メソッドの情報は，ユーザ拡張性能解析トレース設定ファイルを使って設定します。ユーザ拡張性能解析トレース設定ファイルの内容については，「7.5.3　ユーザ拡張性能解析トレースのトレース対象メソッドの設定」を参照してください。

PRFデーモン

バッファに出力されたPRFトレースを，一定量たまったらファイルに出力する，I／Oプロセスです。PRFトレースを取得するホストごとに，一つ以上起動します。一つのホストに一つ配置することをお勧めします。

ユーザ拡張性能解析トレース設定ファイルおよびPRFデーモンの関係を次の図に示します。

図7‒7　ユーザ拡張性能解析トレース設定ファイルおよびPRFデーモンの関係

7.3　Management Serverを利用した性能解析トレースファイルの収集

Management Serverを利用して運用している場合，各ホストに出力されたトレースファイルの内容は，Management Serverの運用管理コマンド（mngsvrutil）で，管理サーバに一括収集できます。なお，PRFデーモンが出力したPRFトレースファイルは，バイナリ形式のファイルです。Management Serverでは，運用管理エージェントに指示を出し，PRFトレースファイルをテキスト（CSV）形式のファイルに編集して，それを圧縮（ZIP形式）したものを収集します。Management Serverで収集できるのは，運用管理ドメイン内のホストで出力されたPRFトレースです。

なお，テキスト形式に編集したトレースファイルを性能解析トレースファイルといいます。

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

この節では，性能解析トレースファイルの収集方法，出力先や出力情報について説明します。

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

性能解析トレースファイルを収集する場合，Management Serverの運用管理コマンド（mngsvrutil）を使用します。mngsvrutilコマンドには，サブコマンド「collect」を指定します。性能解析トレースファイルの収集時，トレース情報の収集対象を選択します。運用管理コマンドを使用した場合のトレース情報の収集対象を次に示します。

運用管理ドメイン内のホスト上で動作しているすべてのパフォーマンストレーサ

特定のホスト上で動作しているすべてのパフォーマンストレーサ

特定のパフォーマンストレーサ

それぞれの場合の実行形式と実行例を次に示します。

運用管理ドメイン内のホスト上で動作しているすべてのパフォーマンストレーサを対象にする場合

実行形式

mngsvrutil -m <Management Serverのホスト名>［:<ポート番号>］ -u <管理ユーザID> -p <管理パスワード> collect allPrfTraces

実行例

mngsvrutil -m mnghost -u user01 -p pw1 collect allPrfTraces

特定のホスト上で動作しているすべてのパフォーマンストレーサを対象にする場合

実行形式

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

7.3.2　性能解析トレースファイルの出力先

Windowsの場合

<Managerのログ出力ディレクトリ>¥prf

UNIXの場合

<Managerのログ出力ディレクトリ>/prf

なお，性能解析トレースファイルは，トレース情報の収集対象別に次の表に示すファイル名で出力されます。

表7‒3　性能解析トレースファイルのファイル名

トレース情報の収集対象

ファイル名

運用管理ドメイン内のホスト上で動作しているすべてのパフォーマンストレーサ

<運用管理ドメイン名>-<日時※1>.zip

特定のホスト上で動作しているすべてのパフォーマンストレーサ

<ホスト名>-<日時※1>.zip

特定のパフォーマンストレーサ

<論理サーバ名※2>-<日時※1>.zip

注※1

性能解析トレースファイルを収集した日時が表示されます。

注※2

指定したパフォーマンストレーサの名称が表示されます。

7.3.3　性能解析トレースファイルの出力情報（性能解析トレースの場合）

性能解析トレースでは，各機能レイヤのトレース情報を収集します。

各機能レイヤが出力する情報を次の表に示します。なお，CTMとそれ以外の機能レイヤでは，取得項目が異なります。また，付加情報の有無など，取得ポイントごとに，出力される項目は異なります。各取得ポイントで出力される項目の詳細については，「8.　性能解析トレースのトレース取得ポイントとPRFトレース取得レベル」を参照してください。

表7‒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の内容が514文字以内のASCII文字列として出力されます。

注※1

CTMで取得したトレース情報には，スレッドのハッシュ値は出力されない場合があります。

注※2

プロセス名称は次のように決定されます。

EJBクライアントアプリケーションの場合

EJBクライアントアプリケーションのシステムプロパティejbserver.server.prf.processNameに指定された名称。

このシステムプロパティを指定していない場合，またはこのプロパティにnull文字を指定した場合は，"EJBClient"になります。

J2EEサーバ，バッチサーバ，およびWebコンテナサーバの場合

サーバ名がプロセス名称となります。

CTMの場合

CTMの各プロセス名称となります。

注※3

イベントIDは，機能レイヤのトレース取得ポイントごとに割り当てられています。詳細は，「8.　性能解析トレースのトレース取得ポイントとPRFトレース取得レベル」を参照してください。

注※4

クライアントアプリケーション情報の構成要素です。

注※5

ルートアプリケーション情報の構成要素です。Webコンテナで出力されるトレースポイントでは，トレース情報を取得したルートアプリケーションのIPアドレス，プロセスID，および通信番号が「0.0.0. 0/0/0x0000000000000000」と出力される場合があります。詳細は「7.7.7　ルートアプリケーション情報を利用したログ調査」を参照してください。

なお，HTTP ServerをIPv4とIPv6のデュアルスタック環境で動作させて運用する場合，ルートアプリケーションのプロセスIDには，IPv4アドレスが出力されます。また，クライアントのアドレスがIPv6の場合で33文字以上のときは，トレース情報のイベントID「0x8000」および「0x8100」を編集して出力します。

イベントID「0x8000」の場合："先頭から32文字"+"*"

イベントID「0x8100」の場合："先頭から16文字"+"*"+"後ろから16文字"

この場合，イベントID「0x8000」および「0x8100」の両方を参照すると，クライアントのアドレス全体を取得できます。

注※6

CTMの場合だけ出力される情報です。CTM以外のレイヤでは，「****」が表示されます。なお，バッチアプリケーションを実行するシステムではスケジュールグループ名が表示されます。

注※7

インタフェース名，オペレーション名，およびルックアップ名が32文字を超える場合，次のどれかの方法で，33文字になって出力されます。詳細については，「8.　性能解析トレースのトレース取得ポイントとPRFトレース取得レベル」を参照してください。

先頭32文字+*

先頭16文字+*+末尾16文字

*+末尾32文字

注※8

機能レイヤによっては，「OPT」に入り口時刻が出力されるトレース取得ポイントがあります。入り口時刻とは，そのトレース取得ポイントのトレースに対応する入り口トレースが出力された時間を示します。

なお，入り口時刻は，「1970年1月1日00:00:00」からの通算時間が16バイトの値で出力されます。前半の8バイトの値は秒単位を，後半の8バイトの値はマイクロ秒単位を示します。

7.3.4　性能解析トレースファイルの出力情報（ユーザ拡張性能解析トレースの場合）

ユーザ拡張性能解析トレースでは，アプリケーションの処理が出力するトレース情報を収集します。

性能解析トレースの出力項目については，「7.3.3　性能解析トレースファイルの出力情報（性能解析トレースの場合）」を参照してください。

なお，オペレーション情報の有無など，取得ポイントごとに，出力される項目は異なります。各取得ポイントで出力される項目の詳細については，「8.25　アプリケーションのトレース取得ポイント」を参照してください。

7.4　性能解析トレースのルートアプリケーション情報取得のための実装

この節では，性能解析トレースのルートアプリケーション情報を取得する機能の概要および実装方法を説明します。

ルートアプリケーション情報とは，性能解析トレース機能で取得した情報のうち，HTTP Server，NIO HTTPサーバ，またはEJBクライアントで取得した情報をいいます。APIを使用して，ルートアプリケーション情報の文字列表現を取得する機能をJ2EEアプリケーションおよびバッチアプリケーションに実装できます。実装すると，取得した文字列表現をログファイルなどに記録することで，任意のタイミングで性能解析トレースファイルとの突き合わせができるため，トラブル発生時のトラブルシュートに役立ちます。

性能解析トレースのルートアプリケーション情報の取得機能を実装するには，CprfTraceクラスを使用します。CprfTraceクラスを使用するには，次のパスをクラスパスに指定してコンパイルします。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥lib¥ejbserver.jar

UNIXの場合

/opt/Cosminexus/CC/lib/ejbserver.jar

なお，ルートアプリケーション情報を利用した調査については，「7.7.7　ルートアプリケーション情報を利用したログ調査」を参照してください。

7.5　実行環境での設定

この節では，性能解析トレースおよびユーザ拡張性能解析トレースを使用するための設定について説明します。

設定する項目は，性能解析トレースとユーザ拡張性能解析トレースで異なります。取得するトレース情報に必要な設定項目を次の表に示します。

表7‒5　取得するトレース情報に必要な設定項目

設定項目

取得するトレース情報

参照先

性能解析トレース

ユーザ拡張性能解析トレース

性能解析トレースを使用するための設定

○

○

7.5.1

ユーザ拡張性能解析トレースの使用するための設定

−

○

7.5.2

ユーザ拡張性能解析トレースのトレース対象メソッドの設定

−

○

7.5.3

（凡例）　○：設定が必要。　−：設定は不要。

7.5.1　性能解析トレースを使用するための設定

性能解析トレースを使用する場合，次の設定が必要です。

Management Server

パフォーマンストレーサ

注意事項

AIXの場合は，環境変数の設定には次の点に注意してください。

Performance Tracerの実行環境では，環境変数PSALLOCに「early」を設定してください。設定しない場合にメモリ不足が発生すると，正しい動作が保証できません。

AIXの早期ページングスペース割り当てを指定する，環境変数PSALLOCに「early」を指定しています。早期ページングスペース割り当てでは，ページングスペース見積もり上の考慮事項があります。詳細は，AIXのマニュアルの「システム・マネージメント・コンセプト：オペレーティング・システムおよびデバイス」を参照してください。

Performance Tracerの実行環境では，環境変数NODISCLAIMに「true」を設定してください。環境変数PSALLOCに「early」を設定した場合，環境変数NODISCLAIMに「true」を設定しないと，レスポンス，スループットおよびCPU利用率が極端に低下することがあります。

Performance Tracerで使用するユーザデータ領域と共用メモリ領域を拡張するため，環境変数LDR_CNTRLに「MAXDATA=0x40000000」を設定してください。割り当てるメモリの値を1ギガバイトにしてください。

Performance Tracerの実行環境では，環境変数EXTSHMに「ON」を設定してください。設定しない場合，共有メモリが参照できなくなることがあります。

(1)　Management Serverの設定

Management Serverの設定は，mserver.properties（Management Server環境設定ファイル）で実施します。指定するパラメタを次に示します。

com.cosminexus.mngsvr.trace

Management Serverが収集する性能解析トレースファイルのファイル面数を指定します。

mserver.propertiesおよびキーの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.6　mserver.properties（Management Server環境設定ファイル）」を参照してください。なお，性能解析トレースファイルについては，「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(2)　パフォーマンストレーサの設定

パフォーマンストレーサ（PRFデーモン）の設定は，簡易構築定義ファイルで実施します。性能解析トレースの定義は，簡易構築定義ファイルの論理パフォーマンストレーサ（performance-tracer）の<configuration>タグ内に指定します。

簡易構築定義ファイルでの性能解析トレースの定義について次の表に示します。

表7‒6　簡易構築定義ファイルでの性能解析トレースの定義

指定するパラメタ

設定内容

PrfTraceLevel

アプリケーションサーバの各機能（Webサーバ，J2EEサーバ，CTMなどの機能レイヤ）がバッファに出力する，パフォーマンストレーサのトレース取得レベルを指定します。

PrfTraceCount

パフォーマンストレーサのPRFトレースファイルの面数を指定します。

PrfTraceFileSize

パフォーマンストレーサのファイルサイズを指定します。PrfTraceFileSize≧PrfTraceBufferSizeの関係が成り立つ値を設定してください。

PrfTraceBufferSize

パフォーマンストレーサのバッファサイズを指定します。PrfTraceFileSize≧PrfTraceBufferSizeの関係が成り立つ値を設定してください。

注　簡易構築定義ファイルおよび指定する各パラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

7.5.2　ユーザ拡張性能解析トレースを使用するための設定

ユーザ拡張性能解析トレースを使用する場合，サーバの起動前に次の設定が必要です。

J2EEサーバ

バッチサーバ

EJBクライアントアプリケーション

ユーザ拡張性能解析トレースのトレース対象メソッドの設定

(1)　J2EEサーバの設定

J2EEサーバの設定は，簡易構築定義ファイルで実施します。

ユーザ拡張性能解析トレースの定義は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にJavaVM起動パラメタ（add.jvm.arg）で指定します。

簡易構築定義ファイルでのユーザ拡張性能解析トレースの定義を次の表に示します。

表7‒7　簡易構築定義ファイルでのユーザ拡張性能解析トレースの定義

項目

指定するパラメタ

設定内容

ユーザ拡張性能解析トレースを有効にするための設定

jvm.userprf.Enable

ユーザ拡張性能解析トレースを使用する場合，有効に設定してください。

ユーザ拡張性能解析トレース設定ファイルを指定するための設定

jvm.userprf.File※1

ユーザ拡張性能解析トレースで使用するユーザ拡張性能解析トレース設定ファイルのファイルパスを指定します。

アプリケーションの書き換え処理に関する設定

jvm.userprf.Limit

ユーザ拡張性能解析トレース設定ファイルで指定したメソッドのうち，書き換え対象とするメソッド数の上限値を指定します。ユーザ拡張性能解析トレース設定ファイルで指定したメソッドで，この値を超えたメソッドはトレース対象となりません。

jvm.userprf.Trace

ユーザ拡張性能解析トレース設定ファイルで指定したクラスファイルの書き換えに成功した場合に，ログを出力するかどうかを指定します。なお，クラスファイルの書き換えに失敗した場合は，ログは必ず出力されます。

ユーザ拡張性能解析トレースの出力情報に関する設定

jvm.userprf.ExtendedSetting※2

トレース対象をメソッド単位に加えて，パッケージ単位またはクラス単位で指定できるようにするかどうかを指定します。

jvm.userprf.LineNumber

メソッドの正常出口でメソッドが最後に実行した行の行番号をトレース情報に出力するかどうかを指定します。

jvm.userprf.ThrowableName

例外またはエラーのクラス名をトレース情報に出力するかどうかを指定します。

jvm.userprf.ThrowableNameEditMethod

例外またはエラーのクラス名が文字数制限32文字を超えた場合の名前の編集方法を指定します。

jvm.userprf.LogLevel

ユーザ拡張性能解析トレースのトレース出力レベルを指定します。

注※1　

デフォルト値を次に示します。

Windowsの場合

<JDKインストールディレクトリ>¥usrconf¥userprf.cfg

UNIXの場合

/opt/Cosminexus/jdk/usrconf/userprf.cfg

注※2　

jvm.userprf.ExtendedSettingプロパティを設定して許可されるユーザ拡張性能解析トレース設定ファイルの指定形式はトレース対象となるメソッドが大量になります。そのため，出力量が増えたり性能に影響を与えたりする場合があるので注意が必要です。ユーザ拡張性能解析トレース使用時の注意事項についての詳細は「7.8　ユーザ拡張性能解析トレース使用時の注意事項」を参照してください。

簡易構築定義ファイルおよび指定する各パラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

定義例を次に示します。

　：
<param>
<param-name>add.jvm.arg</param-name>
<param-value>-Djvm.userprf.Enable=true</param-value>
<param-value>-Djvm.userprf.File=<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<実サーバ名>/userprf.cfg</param-value>
<param-value>-Djvm.userprf.LogLevel=class</param-value>
</param>
　：

参考

J2EEサーバの設定は，運用管理ポータルの［起動パラメタの設定］画面（論理J2EEサーバの定義）でも設定できます。運用管理ポータルでの設定方法については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.23　起動パラメタの設定（J2EEサーバ）」を参照してください。

(2)　バッチサーバの設定

バッチサーバの設定は，簡易構築定義ファイルで実施します。

ユーザ拡張性能解析トレースの定義は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にJavaVM起動パラメタ（add.jvm.arg）で指定します。指定するパラメタ値は，「(1)　J2EEサーバの設定」を参照してください。

(3)　EJBクライアントアプリケーションの設定

cjclstartapコマンドで動作させるEJBクライアントアプリケーションの設定は，EJBクライアントアプリケーション用オプション定義ファイル（usrconf.cfg）で実施します。

ユーザ拡張性能解析トレースの定義は，EJBクライアントアプリケーション用オプション定義ファイル（usrconf.cfg）のJavaVM起動パラメタ（add.jvm.arg）で指定します。指定するパラメタ値は，「(1)　J2EEサーバの設定」を参照してください。

EJBクライアントアプリケーション用オプション定義ファイル（usrconf.cfg）での定義例を次に示します。

　：
add.jvm.arg=-Djvm.userprf.Enable=true
add.jvm.arg=-Djvm.userprf.File=<ユーザ定義ファイル格納ディレクトリ>※/userprf.cfg
add.jvm.arg=-Djvm.userprf.LogLevel=class
　：

注※

ユーザ定義ファイル格納先環境変数（CJCLUSRCONFDIR）で指定したディレクトリです。ユーザ定義ファイル格納先環境変数が設定されていない場合，カレントディレクトリが参照されます。

(4)　ユーザ拡張性能解析トレース設定ファイルの設定

ユーザ拡張性能解析トレースを使用するためには，ユーザ拡張性能解析トレース設定ファイルを作成して，トレース対象メソッドの設定が必要です。

トレース対象メソッドの設定は，簡易構築定義ファイルの論理J2EEサーバ（J2EE-Server）の<configuration>タグ内にUserPrfTextパラメタで指定します。

定義例を次に示します。

　：
<param>
<param-name>UserPrfText</param-name>
<param-value>
<![CDATA[
org.apache.struts.action.Action.execute(*), struts, true
Info.getInfo(*), struts, true
]]>
</param-value>
</param>
　：

ユーザ拡張性能解析トレース設定ファイルの作成方法については，「7.5.3　ユーザ拡張性能解析トレースのトレース対象メソッドの設定」を参照してください。

参考

ユーザ拡張性能解析トレース設定ファイルは，運用管理ポータルの［起動パラメタの設定］画面（論理J2EEサーバの定義）またはユーザ任意のファイル（jvm.userprf.Fileプロパティで指定したファイル）でも設定できます。

7.5.3　ユーザ拡張性能解析トレースのトレース対象メソッドの設定

ユーザ拡張性能解析トレースのトレース対象メソッドの設定は，ユーザ拡張性能解析トレース設定ファイルを使って設定します。ユーザ拡張性能解析トレース設定ファイルの内容は次のどれかに記述できます。

簡易構築定義ファイル

運用管理ポータルの［起動パラメタの設定］画面（論理J2EEサーバの定義）

デフォルトのファイル，またはユーザが指定した任意のファイル（jvm.userprf.Fileプロパティで指定したファイル）

(1)　記述形式

ユーザ拡張性能解析トレース設定ファイルの記述形式を次に示します。

<指定形式>※,<識別ID>,<サブクラスフラグ>［,［<イベントID>］［,［<トレース取得レベル>］］］［#コメント］

注1

［ ］で囲んだ項目は省略できます。

注2

クラス名およびパッケージ名が一致するすべてのメソッドを対象とする場合，jvm.userprf.ExtendedSettingプロパティの値をtrueに設定してください。

注※

<指定形式>は次のどれかの形式で指定します。

メソッド名と引数の型が一致するメソッドをトレースの対象とする場合

<パッケージ名>.<クラス名>.<メソッド名>(メソッドの引数の型名)

メソッド名が一致するメソッドをトレースの対象とする場合

<パッケージ名>.<クラス名>.<メソッド名>(*)

クラス名が一致するすべてのメソッドをトレースの対象とする場合

<パッケージ名>.<クラス名>

パッケージ名が一致するすべてのメソッドをトレースの対象とする場合

<パッケージ名>.*

記述形式の例

com.sample.Test.method(),TEST1,false,0xae02,A
com.sample.Test.method(),TEST1,false,0xae02
com.sample.Test.method(),TEST1,false,0xae02,
com.sample.Test.method(),TEST1,false,,A
com.sample.Test.method(),TEST1,false
com.sample.Test.method(),TEST1,false,
com.sample.Test.method(),TEST1,false,,

(2)　記述項目

ユーザ拡張性能解析トレース設定ファイルの記述項目を次に示します。

指定形式

トレース対象メソッドを指定します。

パッケージ名

トレース対象メソッドのクラスまたはインタフェースのパッケージ名を指定します。

クラス名

トレース対象メソッドのクラス名またはインタフェース名を指定します。クラス名の代わりにインタフェース名を指定し，かつ，サブクラスフラグにtrueを指定した場合，そのインタフェースを実装しているメソッドがトレース対象となります。

メソッド名

トレース対象メソッドの名前を指定します。

メソッドの引数の型名

トレース対象メソッドの引数の型を完全修飾名で指定します。

識別ID

トレース対象メソッドを識別するための文字列を指定します。

使用できる文字はASCII文字で0x21（!）から0x7e（~）までです。ただし，0x22（"），0x23（#），および0x2c（,）は指定できません。

識別IDはPRFトレースファイルに出力されます。なお，PRFトレースファイルに出力される文字数は32文字までです。33文字目以降は省略されて，33文字目に*が出力されます。

注意事項

トレース対象メソッドが定義されているクラスにサブクラスが存在し，そのサブクラスでトレース対象メソッドがオーバーライドされていない場合，スーパークラスのトレース対象メソッドに対して指定された識別IDが出力されます。

サブクラスフラグ

指定したメソッドのクラスまたはインタフェースと継承関係にあるクラスのメソッドをトレース対象に含めるかどうかをtrueまたはfalseで指定します。

trueを指定した場合，指定したメソッドと，それをオーバーライドしているメソッドがトレース対象となります。

falseを指定した場合，指定したメソッドだけがトレース対象となり，指定したメソッドをオーバーライドしているメソッドはトレース対象となりません。

イベントID

トレース情報を取得するポイント（トレース取得ポイント）を16進数（0xae02〜0xae7eおよび0xc000〜0xcffe）の値で指定します。デフォルト値は0xae00です。

メソッドの入口で出力されるトレース情報にはこの値が出力され，メソッドの出口で出力されるトレース情報にはこの値＋1が出力されます。

トレース取得レベル

トレース対象メソッドのトレース取得レベルに，A，B，C，またはそれぞれの小文字のどれかを指定します。デフォルト値はAです。

A：標準レベル

B：詳細レベル

C：保守レベル

参考

トレース取得レベルはcprflevelコマンドのPRFトレース取得レベルと同じです。トレース対象メソッドはすべてJava VMレイヤのレベルを参照します。PRF取得レベルとレイヤについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cprflevel（PRFトレース取得レベルの表示と変更）」を参照してください。

コメント

コメントは「#」で始まり，「#」から行末までの間の文字すべてをコメントとします。

(3)　記述規則

ユーザ拡張性能解析トレース設定ファイルの記述規則を次に示します。

記述にはシングルバイト文字だけが使用できます。

空白文字は，半角スペース文字（「0x20」）またはタブ文字（「¥t」もしくは「0x09」）となります。なお，ユーザ拡張性能解析トレース設定ファイルの読み込みでは空白文字は無視されます。

トレース対象メソッドは1行に一つずつ記述します。

1行に指定できる文字数は2,048文字までです。この文字数には空白やコメントを含みます。

行末は改行文字（「¥n」もしくは「0x0A」）または復帰文字（「¥r」もしくは「0x0D」）が1文字以上続いたものとなります。

ユーザ拡張性能解析トレース設定ファイルの記述に誤りがある場合，誤りの内容を示すメッセージが出力されます。また，各項目に無効な値を記述した場合，誤りの内容を示すメッセージが出力され，その行の設定は無効になります。

メッセージについては，「7.6　ユーザ拡張性能解析トレース実行時に出力されるログ情報」を参照してください。

ユーザ拡張性能解析トレースでは，JavaVM内のクラスやCosminexus内のクラスはトレース対象のメソッドに指定できません。次のパッケージが該当します。

java以下

javax以下

com.hitachi以下

JP.co.Hitachi以下

そのため，jvm.userprf.ExtendedSettingプロパティを指定して，パッケージ名指定をする場合は，アプリケーションのクラスだけが含まれるようにパッケージ名を記述してください。

次のメソッドはトレース対象のメソッドに指定できません。

存在しないパッケージ名，クラス名，およびメソッド名

nativeメソッド

abstractメソッド

JavaVM内のクラス，およびそのクラスのメソッド

（例）javaおよびjavaxで始まるパッケージのクラス

-Xbootclasspathで指定したクラス，およびそのクラスのメソッド

製品内のクラス

次のメソッドは次の記述でトレース対象のメソッドに指定できます。

コンストラクタは，クラス名と同じメソッド名，または<init>で指定できます。

（例）MyMainクラスのコンストラクタの場合，次のように指定します。

MyMain.MyMain()またはMyMain.<init>()

コンストラクタではないクラス名と同じ名前のメソッドを指定した場合は，コンストラクタを指定しているのか，メソッドを指定しているのか判別できないためコンストラクタとメソッドがトレースの対象となります。

引数が可変長であるメソッドを指定する場合は，可変長の引数を配列として記述してください。

（例）引数が可変長であるメソッドの指定

正しい指定例：com.sample.Test.method(java.lang.String[])

誤った指定例：com.sample.Test.method(java.lang.String...)

ネストクラスは，「.」ではなく「$」で区切った名前を指定してください。

（例）ネストクラスの指定

正しい指定例：com.sample.Test$NestClass

誤った指定例：com.sample.Test.NestClass

ジェネリクスではなく，パラメタ化されていないクラス名（raw型）であれば指定できます。

（例）ジェネリクスではないクラスの指定

正しい指定例：com.sample.Test.method()

誤った指定例：com.sample.Test<java.lang.String,java.lang.Object>.method()

<指定形式>の<クラス名>にクラス名を指定した場合とインタフェース名を指定した場合ではトレース対象メソッドが異なります。

クラスまたはインタフェースの指定によるトレース対象メソッドを次の表に示します。

表7‒8　クラスまたはインタフェースの指定によるトレース対象メソッド

クラスまたはインタフェース

トレース対象メソッド

サブクラスフラグにfalseを指定した場合

サブクラスフラグにtrueを指定した場合

クラス

指定したクラスのメソッド

指定したクラスのメソッドと，そのメソッドをオーバーライドしているメソッド

インタフェース

なし

指定したインタフェースを直接実装しているクラス※1と間接実装しているクラス※2のメソッド，およびそのメソッドをオーバーライドしているメソッド

注※1　クラスの宣言時にimplementsを使用して指定したインタフェースを実装しているクラスです。

注※2　指定したインタフェースを直接実装しているクラスのサブクラス，または指定したインタフェースを継承しているインタフェースを直接実装しているクラスです。

(4)　ユーザ拡張性能解析トレース設定ファイルの記述例

ここでは，トレース対象メソッドごとに，ユーザ拡張性能解析トレース設定ファイルの記述例について説明します。

なお，ここで説明する記述例は，パッケージ名が「com.sample」で，次の図に示すクラス構造を持っているアプリケーションとします。

図7‒8　アプリケーションのクラス構造の例

(a)　メソッド名と引数の型が一致するメソッドをトレースの対象とする場合

メソッド名と引数の型が一致するメソッドをトレースの対象とする場合のユーザ拡張性能解析トレース設定ファイルの記述例を次に示します。

サブクラスフラグがfalseの場合

com.sample.ClassA.methodA1(java.lang.String,java.lang.Object),1000,false

サブクラスフラグがfalseの場合，記述したメソッド名と引数の型が一致するメソッドがトレース対象となります。

トレース対象のメソッド

・ClassAクラスのmethodA1(String,Object)

トレース対象メソッドに対してイベントIDの設定を省略しているため，トレース対象となったメソッドが呼び出されると，イベントIDとしてメソッドの入口で0xae00，メソッドの出口で0xae01のデフォルト値が出力されます。また，識別IDに「1000」を設定しているため，識別IDとして「1000」が出力されます。

サブクラスフラグがtrueの場合

com.sample.ClassA.methodA2(),2000,true

サブクラスフラグがtureの場合，メソッド名と引数の型が記述と一致するメソッドに加えて，記述したメソッドをオーバーライドしているメソッドもトレース対象となります。

トレース対象のメソッド

・ClassAクラスのmethodA2()

・ClassAクラスのmethodA2()をオーバーライドしているClassBクラスのmethodA2()

トレース対象メソッドに対してイベントIDの設定を省略しているため，トレース対象となったメソッドが呼び出されると，イベントIDとしてメソッドの入口で0xae00，メソッドの出口で0xae01のデフォルト値が出力されます。また，識別IDに「2000」を設定しているため，トレース対象のすべてのメソッドに識別IDとして「2000」が出力されます。

(b)　メソッド名が一致するメソッドをトレースの対象とする場合

メソッド名が一致するメソッドをトレースの対象とする場合のユーザ拡張性能解析トレース設定ファイルの記述例を次に示します。

サブクラスフラグがfalseの場合

com.sample.ClassA.methodA1(*),methodA1,false,0xae30

サブクラスフラグがfalseの場合，記述したメソッド名と一致するメソッドのすべてがトレース対象となります。

トレース対象のメソッド

・ClassAクラスのmethodA1(String,Object)

・ClassAクラスのmethodA1(int)

トレース対象となったメソッドが呼び出されると，イベントIDとしてメソッドの入口で0xae30，メソッドの出口で0xae31が出力されます。また，トレース対象のすべてのメソッドに識別IDとして「methodA1」が出力されます。

サブクラスフラグがtrueの場合

com.sample.ClassA.methodA1(*),methodA1,true,0xae30

サブクラスフラグがtrueの場合，記述したメソッド名と一致するメソッドのすべてがトレース対象となります。また，記述したメソッドに加えて，記述したメソッドをオーバーライドしているメソッドもトレース対象となります。

トレース対象のメソッド

・ClassAクラスのmethodA1(String,Object)とmethodA1(int)

・ClassAクラスのmethodA1(String,Object)をオーバーライドしているClassBクラスのmethodA1(String,Object)

・ClassBクラスのmethodA1(String,Object)をオーバーライドしているClassCクラスのmethodA1(String,Object)

トレース対象となったメソッドが呼び出されると，イベントIDとしてメソッドの入口で0xae30，メソッドの出口で0xae31が出力されます。また，トレース対象のすべてのメソッドに識別IDとして「methodA1」が出力されます。

(c)　クラス名が一致するすべてのメソッドをトレースの対象とする場合

メソッドと引数を省略して，クラス名が一致するすべてのメソッドをトレースの対象とする場合のユーザ拡張性能解析トレース設定ファイルの記述例を次に示します。

サブクラスフラグがfalseの場合

com.sample.ClassA,TEST01,false

サブクラスフラグがfalseの場合，記述したクラス名（ClassAクラス）のすべてのメソッドがトレース対象となります。

トレース対象のメソッド

ClassAクラスのmethodA1(String,Object)，methodA1(int)，およびmethodA2()

トレース対象となったメソッドが呼び出されると，イベントIDが省略されているため，メソッド入口で0xae00，メソッド出口で0xae01が出力されます。また，これらすべてのメソッドに識別IDとして「TEST01」が出力されます。

サブクラスフラグがtrueの場合

com.sample.ClassB,TEST02,true

サブクラスフラグがtrueの場合，記述したクラス名（ClassBクラス）のすべてのメソッドと，そのメソッドをオーバーライドしているメソッドのすべてがトレース対象となります。

トレース対象のメソッド

・ClassBクラスのmethodA1(String,Object)

・ClassBクラスのmethodA2()

・ClassBクラスのmethodB1()

・ClassBクラスのmethodA1(String,Object)をオーバーライドしているClassCクラスのmethodA1(String,Object)

トレース対象となったメソッドが呼び出されると，イベントIDが省略されているため，メソッド入口で0xae00，メソッド出口で0xae01が出力されます。また，これらすべてのメソッドに識別IDとして「TEST02」が出力されます。

(d)　パッケージ名が一致するすべてのメソッドをトレースの対象とする場合

クラス名とメソッド名と引数を省略して，パッケージ名が一致するすべてのクラスのすべてのメソッドをトレースの対象とする場合のユーザ拡張性能解析トレース設定ファイルの記述例を次に示します。

注意事項

この指定ではサブパッケージも対象に含まれます。トレース対象となった場合，対象となったメソッドが呼び出されるとトレースが出力されます。

com.sampleパッケージにサブパッケージがある場合，そのサブパッケージのすべてのクラスのすべてのメソッドもトレース対象となります。

サブクラスフラグがfalseの場合

com.sample.*,6000,false

サブクラスフラグがfalseの場合，記述したパッケージ（com.sample）にあるすべてのクラスのすべてのメソッドがトレース対象となります。

トレース対象のメソッド

ClassA，ClassB，ClassC，ClassDのすべてのメソッドがトレース対象となります。

トレース対象となったメソッドが呼び出されると，イベントIDが省略されているため，メソッド入口で0xae00，メソッド出口で0xae01が出力されます。また，これらすべてのメソッドに識別IDとして「6000」が出力されます。

サブクラスフラグがtrueの場合

com.sample.*,6000,false

サブクラスフラグがtrueの場合，記述したパッケージ（com.sample）にあるすべてのクラスのすべてのメソッドと，そのメソッドをオーバーライドしているメソッドのすべてがトレース対象となります。

トレース対象のメソッド

ClassA，ClassB，ClassC，ClassDのすべてのメソッドと，そのメソッドをオーバーライドしているすべてのメソッドもトレース対象となります。

トレース対象となったメソッドが呼び出されると，イベントIDが省略されているため，メソッド入口で0xae00，メソッド出口で0xae01が出力されます。また，これらすべてのメソッドに識別IDとして「6001」が出力されます。

(5)　ユーザ拡張性能解析トレース設定ファイル作成の注意事項

ユーザ拡張性能解析トレース設定ファイルを作成するときの注意事項を次に示します。

ユーザ拡張性能解析トレース設定ファイルで，同じメソッドに対して複数行で異なるイベントIDまたは識別IDを指定した場合，ユーザ拡張性能解析トレース設定ファイルの前方に記述された設定が優先されます。

ユーザ拡張性能解析トレース設定ファイルで，複数のメソッドを対象とする記述をした場合，対象となるすべてのメソッドが同一イベントIDまたは識別IDで出力されます。その場合，出力されるメソッド名が出力できる文字数を超えるとメソッドを特定できないことがあります。メソッドを一つに特定できるように記述してください。

トレース対象にインタフェースを指定した場合，サブクラスフラグにtrueを指定してください。インタフェースにはトレース対象となるメソッドが存在しないため，サブクラスフラグにfalseを指定するとトレース情報は出力されません。

複数のメソッドをユーザ拡張解析トレースの対象とする指定形式は，アプリケーションの動作を把握したい場合などに限り指定してください。

ユーザ拡張性能解析トレース設定ファイルの記述で，サブクラスフラグにtrueを指定した場合や，メソッド名が一致するメソッドをトレースの対象とする指定形式で指定した場合，ユーザが意図しない多くのメソッドがユーザ拡張性能解析トレースの対象となり，性能劣化要因の特定が困難になることがあります。性能劣化要因の特定のためには，ユーザ拡張性能解析トレース設定ファイルのサブクラスフラグにfalseを指定する，またはメソッド名と引数の型が一致するメソッドをトレースの対象とする指定形式で指定するなどで，ユーザ拡張性能解析トレースの対象を限定することを推奨します。

7.6　ユーザ拡張性能解析トレース実行時に出力されるログ情報

ユーザ拡張性能解析トレースの実行時に，JavaVMログファイルに次のログが出力されます。

ユーザ拡張性能解析トレース設定ファイルの読み込み時のログ

アプリケーションの書き換え時のログ

それぞれのログについて説明します。

7.6.1　ユーザ拡張性能解析トレース設定ファイルの読み込み時のログ

ユーザ拡張性能解析トレースでユーザ拡張性能解析トレース設定ファイルの読み込み時に出力されるログ情報を次の表に示します。

表7‒9　ユーザ拡張性能解析トレース設定ファイルの読み込み時に出力されるログ

出力形式

出力内容

説明

[UPR※1]<DATE>Setting file not found.<file=FILEPATH>

DATE※2

ユーザ拡張性能解析トレース設定ファイルの読み込みに失敗した日時。

FILEPATH

読み込みに失敗したユーザ拡張性能解析トレース設定ファイルの絶対ファイルパス。

デフォルト，またはjvm.userprf.Fileプロパティで指定したユーザ拡張性能解析トレース設定ファイルが存在しません。

[UPR※1]<DATE>Failed to open setting file.<file=FILEPATH>

DATE※2

ユーザ拡張性能解析トレース設定ファイルの読み込みに失敗した日時。

FILEPATH

読み込みに失敗したユーザ拡張性能解析トレース設定ファイルの絶対ファイルパス。

ユーザ拡張性能解析トレース設定ファイルのオープンまたは読み込みができません。

[UPR※1]<DATE>Failed to parse setting file.<file=FILEPATH><line=LINE>

DATE※2

ユーザ拡張性能解析トレース設定ファイルの誤りを検出した日時。

FILEPATH

ユーザ拡張性能解析トレース設定ファイルの絶対ファイルパス。

LINE

ユーザ拡張性能解析トレース設定ファイルの行番号。

ユーザ拡張性能解析トレース設定ファイルの内容に記述フォーマット上の誤りがあります。

[UPR※1]<DATE>Event ID is invalid value.<file=FILEPATH><eventID=EventID>

DATE※2

ユーザ拡張性能解析トレース設定ファイルの誤りを検出した日時。

FILEPATH

ユーザ拡張性能解析トレース設定ファイルの絶対ファイルパス。

EventID：ユーザ拡張性能解析トレース設定ファイルに指定したイベントID。

ユーザ拡張性能解析トレース設定ファイルのイベントIDが有効な値の範囲外です。

[UPR※1]<DATE>No valid settings in setting file.<file=FILEPATH>

DATE※2

ユーザ拡張性能解析トレース設定ファイルに有効な設定がないことを検出した日時。

FILEPATH

ユーザ拡張性能解析トレース設定ファイルの絶対ファイルパス。

ユーザ拡張性能解析トレース設定ファイルに有効な設定がありません。

[UPR※1]<DATE>User Extended PRF started successfully.<file=FILEPATH>

DATE※2

ユーザ拡張性能解析トレース設定ファイルの読み込みに成功した日時。

FILEPATH

有効に読み込みが行われたユーザ拡張性能解析トレース設定ファイルの絶対ファイルパス。

ユーザ拡張性能解析トレース設定ファイルが正常に読み込まれ，ユーザ拡張性能解析トレースが有効になりました。

注※1　ユーザ拡張性能解析トレースが出力したログであることを示す識別子です。

注※2　拡張verbosegc情報と同じ形式で出力します。

7.6.2　アプリケーションの書き換え時のログ

ユーザ拡張性能解析トレースでは性能解析トレースを出力するために，インストゥルメンテーション機能を利用して，クラスロード時にアプリケーションのクラスを書き換えます。このときに出力するログを次の表に示します。

表7‒10　アプリケーションの書き換え時のログ

出力形式

出力内容

説明

[UPR※1]<DATE>BCI process failed.<class=CLASS>

DATE※2

書き換えに失敗した日時。

CLASS

書き換えに失敗した完全修飾クラス名。

ユーザ拡張性能解析トレース設定ファイルに指定されたクラスの書き換えに失敗しました。

[UPR※1]<DATE>BCI process finished successfully.<class=CLASS>

DATE※2

書き換えに成功した日時。

CLASS

書き換えに成功した完全修飾クラス名。

ユーザ拡張性能解析トレース設定ファイルに指定されたクラスの書き換えに成功しました。なお，このログはjvm.userprf.Traceプロパティにtrueを指定している場合に出力します。

[UPR※1]<DATE>BCI count exceeded a limit.

DATE※2

書き換え数が書き換え数の上限値を超えた日時。

jvm.userprf.Limitプロパティで指定した数を超えてトレース対象メソッドを書き換えようとしました。次のどちらかで対処してください。

ユーザ拡張性能解析トレースの対象メソッド数を減らす。

jvm.userprf.Limitプロパティで指定した値を大きくする。

なお，このログはjvm.userprf.Limitプロパティで指定した値を初めて超えたときに出力します。

注※1　ユーザ拡張性能解析トレースが出力したログであることを示す識別子です。

注※2　拡張verbosegc情報と同じ形式で出力します。

7.7　性能解析トレースファイルを使用した処理性能の解析作業

この節では，性能解析トレースファイルを使用した処理性能の解析作業について説明します。

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

アプリケーションサーバの処理性能は，クライアントからデータベースなどのEISまでの一連の処理，およびその処理結果がクライアントに返却されるまでのリクエストの一連の処理で，EJBコンテナやWebコンテナなどの機能レイヤから出力されるトレース情報を基に解析できます。

各機能レイヤのトレース情報は，バイナリ形式でPRFトレースファイルに出力されます。アプリケーションサーバの処理性能を解析する際は，PRFトレースファイルをテキスト形式（CSV形式）に変換した性能解析トレースファイルを使用します。

次に，アプリケーションサーバの処理性能を解析する作業について説明します。

参考

保守レベルのトレース情報について

PRFトレース取得レベルには，標準レベルと詳細レベルのほかに，保守レベルがあります。保守レベルとは，障害発生時などの保守情報を取得するためのレベルを指します。通常は指定しないでください。

PRFトレース取得レベルに保守レベルを設定する方法については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cprflevel（PRFトレース取得レベルの表示と変更）」を参照してください。

(1)　性能解析トレースファイルの収集

アプリケーションサーバの処理性能の解析で使用する性能解析トレースファイルを，運用管理コマンド（mngsvrutil）を使用して出力，収集します。性能解析トレースファイルの収集方法，性能解析トレースファイルの出力先および出力情報については，「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(2)　性能解析トレースファイルを利用したアプリケーションサーバの処理性能の解析

性能解析トレースファイルを使用して性能を解析する場合，CSV形式のファイルを編集できるアプリケーションプログラムで表示して，目的に合わせてフィルタリングや並べ替えの機能を利用します。

例えば，CSV形式で出力すると，CSV形式のファイルを編集できるアプリケーションプログラムで「イベントごと」「プロセスごと」などによって出力項目をフィルタリングして，注目する個所を絞り込んで，目的に合わせた解析ができます。

次に示す性能解析トレースファイルの利用方法について，例を使用して説明します。

Webサーバのレスポンスタイムの解析（7.7.2参照）

アプリケーションサーバ内でのリクエストの処理状況の調査（7.7.3参照）

セッションのライフサイクルの調査（7.7.4参照）

タイムアウトが発生したトランザクションの特定（7.7.5参照）

タイムアウトが発生したリクエストの特定（7.7.6参照）

ルートアプリケーション情報を利用したログ調査（7.7.7参照）

トラブルが発生したコネクションの特定（7.7.8参照）

性能解析トレースとスレッドダンプの対応づけた問題個所の調査（7.7.9参照）

なお，ここでは，次のようなWebクライアント構成の環境で性能解析トレースファイルを収集したことを前提とします。

図7‒9　 Webクライアント構成の例

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

ここでは，Webサーバがクライアントからリクエストを受けてから返却するまでに掛かった時間を解析する方法を，例を使用して説明します。

Webサーバのアクセスログでリクエスト処理に掛かった時間を出力することができます。詳細は，マニュアル「HTTP Server」の「6.2.3(6)　CustomLog」ディレクティブを参照してください。

デフォルトのコンフィグファイルで指定しているアクセスログの出力例を次に示します。

（出力例）

192.168.10.10 - - [12/Feb/2020:20:52:16.352 +0900] "GET /index.html HTTP/1.1" 200 53 0.013 11340 "192.168.10.10/5636/0x0000000000000022"
192.168.10.10 - - [12/Feb/2020:20:52:19.439 +0900] "GET /wait.pl HTTP/1.1" 504 319 3.004 12548 "192.168.10.10/5636/0x0000000000000023"

出力例ではindex.htmlへのリクエスト処理に0.013秒が掛かり，wait.plへのリクエスト処理に3.004秒が掛かっています。また，それぞれのメッセージに出力されているルートアプリケーション情報を，性能解析トレースファイルに出力されたルートアプリケーション情報と突き合わせることで，各機能レイヤごとの処理時間を解析できます。

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

ここでは，Webサーバがクライアントから受けたリクエストがアプリケーションサーバで処理されているかどうか調査する方法を，例を使用して説明します。

次に示すWebサーバで収集した性能解析トレースファイルから，2004/2/5 16:32:31にリクエストを受け付けたことがわかります。

図7‒10　 Webサーバで収集した性能解析トレースファイルの例

このリクエストのルートアプリケーション情報をキーにして，アプリケーションサーバで収集した性能解析トレースファイルを調査します。

「RootAP IP：10.209.13.123」，「RootAP ID：2200」，および「RootAP CommNo.：0x00000000000000c7」をキーにして，アプリケーションサーバで収集した性能解析トレースファイルをフィルタリングした例を次に示します。

図7‒11　アプリケーションサーバで収集した性能解析トレースファイルをフィルタリングした例

このようにアプリケーションサーバで収集した性能解析トレースファイルを，ルートアプリケーション情報をキーにフィルタリングすると，アプリケーションサーバ内でのリクエストの一連の処理を調査できます。

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

ここでは，性能解析トレースを利用したセッションのライフサイクルの調査方法について説明します。

セッションのライフサイクルは，PRFトレース取得レベルを「詳細」に設定している場合に出力されるトレース（セッショントレース）を利用して調査できます。

セッショントレース情報は，出力された性能解析トレースファイルのセッションIDをキーにして調査できます。

セッションIDは，セッショントレース情報として出力されたイベントのオプション領域に，次の形式で出力されます。

セッション文字数:セッションID

例えば，「abc123」というセッションIDの場合，オプション領域には「6:abc123」と出力されます。セッションIDが空文字の場合は，セッション文字数として「0:」と出力されます。セッションIDを取得できなかった場合は，何も出力されません。

セッショントレース情報が出力されている性能解析トレースファイルの例を次の図に示します。この例は，一つのセッションの有効期間内での，セッションを生成するリクエスト，セッションを利用するリクエスト，およびセッションを破棄するリクエストのトレース情報を出力したものです。また，ここでは，セッションを生成するリクエスト，セッションを利用するリクエスト，およびセッションを破棄するリクエストを分けて示します。実際はこれら三つの出力例は，続けて出力されます。また，これらの画面では，セッショントレースに関係ない出力項目は表示していません。

図7‒12　セッショントレース情報が出力されている性能解析トレースファイルの例（セッションを生成するリクエスト部分）

イベント「0x8208」のASCIIの列に，生成されたセッションIDが出力されます。オペレーション列の1800は，セッションの有効期間を示します。

このトレースファイルで確認できることについて説明します。

セッションの有効期間の確認

セッション生成時には，イベント「0x8208」が出力されます。セッション破棄時には，イベント「0x8209」が出力されます。これらの取得時刻から，セッションの有効範囲を確認できます。また，イベント「0x8208」では，オペレーション名から生成されたセッションの有効期間（秒）も確認できます。

セッションIDは，セッションを破棄するリクエスト内のイベント「0x8209」でセッションが破棄されるまで，同じIDが出力されます。なお，イベント「0x8209」のオペレーション名から破棄されたセッションの生成時刻も確認できます。

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

ここでは，J2EEアプリケーションまたはバッチアプリケーションのトランザクションがタイムアウトした場合に，メッセージまたは性能解析トレースファイルを使用してタイムアウトしたトランザクションを特定する方法について説明します。

ここでは，次の2種類の方法について説明します。

メッセージを利用した特定方法

性能解析トレースファイルの出力内容による特定方法

(1)　メッセージを利用した特定方法

トランザクションでタイムアウトが発生した場合，メッセージKDJE31002-W，およびKDJE50080-Wが出力されます。これらのメッセージには，次の情報が出力されます。

KDJE31002-W

トランザクションを開始したJ2EEアプリケーション名，またはバッチアプリケーションのクラス名

トランザクションを開始したJ2EEコンポーネント（Enterprise Bean，サーブレットまたはJSP）のクラス名とインスタンスのハッシュコード

保守情報

性能解析トレースのルートアプリケーション情報

メッセージに出力された性能解析トレースのルートアプリケーション情報を，性能解析トレースファイルに出力されたルートアプリケーション情報と突き合わせて確認することで，性能解析トレース中のどこでトランザクションタイムアウトが発生したかを確認できます。

また，その前後のトレース情報を確認して，タイムアウトが発生したトランザクションでの処理内容を確認できます。

KDJE50080-W

IPアドレス，プロセスID，ルートアプリケーション情報

SQLを実行したコネクションのコネクションID

SQLを実行したメソッド名

SQLを実行したメソッドが実行中かどうか

最後に実行されたSQL

メッセージに出力されたSQLの情報を参照することで，タイムアウトが発生した原因となった個所を調査できます。

なお，メッセージの詳細については，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」の「KDJE31002-W」，およびマニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」の「KDJE50080-W」を参照してください。

(2)　性能解析トレースファイルの出力内容による特定方法

性能解析トレースファイルには，トランザクションタイムアウトが発生する直前と直後のトレース取得ポイントで，トレース情報が出力されています。

次のイベントIDの処理内容を確認してください。

表7‒11　トランザクションタイムアウト時に出力される性能解析トレース

イベントID

説明

0x8819

トランザクションタイムアウトの直前の処理で出力される情報です。インタフェース名に，タイムアウトするトランザクションのルートアプリケーション情報が出力されます。

0x8820

トランザクションタイムアウトの直後の処理で出力される情報です。

0x8C41

障害調査用SQLが出力されたときに出力される情報です。

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

ここでは，Webサーバのリバースプロキシでレスポンス受信時にタイムアウトが発生した場合に，性能解析トレースを利用してタイムアウトが発生したリクエストを特定する方法について説明します。

リバースプロキシでのレスポンス受信時にタイムアウトが発生した場合，WebサーバのエラーログにメッセージAH01102が出力され，その詳細情報としてタイムアウトが発生したことが示されます。このメッセージに含まれるスレッドIDと時刻を基に，Webサーバのリクエストログからプロキシトレースを検索します。プロキシトレースには次の情報が出力されています。

バックエンドサーバとの接続状況

接続先IPアドレス

接続先ポート番号

性能解析トレースのルートアプリケーション情報

プロキシトレースのメッセージに出力された性能解析トレースのルートアプリケーション情報を，性能解析トレースファイルに出力されたルートアプリケーション情報と突き合わせて確認することで，性能解析トレース中のどこでリクエストのタイムアウトが発生したかを確認できます。

また，該当するルートアプリケーション情報を，Webサーバのアクセスログに出力されたルートアプリケーション情報と突き合わせることで，タイムアウトが発生したリクエストのURIを確認できます。これらの情報を基に，タイムアウトが発生したリクエストを特定してください。

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

J2EEアプリケーションまたはバッチアプリケーション内で，アプリケーションサーバのAPIを使用すると，性能解析情報のルートアプリケーション情報の文字列表現を任意のタイミングでログファイルに出力できます。

ルートアプリケーション情報の文字列表現は，次の形式で出力されます（最大48文字）。

IPアドレス/プロセスID/通信番号
（例：10.209.15.130/1234/0x0000000000000001）

APIを使用してログファイルにルートアプリケーション情報を出力すると，ログファイルと性能解析トレースファイルを突き合わせた調査ができるようになります。

Webコンテナでは，新しいリクエストを受け付けた時点で，リクエスト単位で新しいルートアプリケーション情報が割り当てられます。新しいルートアプリケーション情報が割り当てられるトレースポイントを次に示します。

表7‒12　新しいルートアプリケーション情報が割り当てられるトレースポイント

イベントID（処理内容）

処理内容

0x8236

リクエスト取得時，リクエストヘッダ解析完了時

注※　Webサーバと連携している場合，HTTP Serverで取得したルートアプリケーション情報が割り当てられます。HTTP ServerまたはHTTP Serverが使用するPRFトレース出力ライブラリのロードに失敗してルートアプリケーション情報が発行されなかった場合，Webコンテナで新しいルートアプリケーション情報が割り当てられます。

また，次のトレース取得ポイントでは，「IPアドレス/プロセスID/通信番号」が「0.0.0. 0/0/0x0000000000000000」と出力されることがあります。

0x8237

Webクライアントからのデータ読み込み開始時

0x8238

Webクライアントへのデータ書き込み開始時

「IPアドレス/プロセスID/通信番号」が「0.0.0. 0/0/0x0000000000000000」と出力されるのは，次の場合です。

HTTPリクエストヘッダを受信した場合

HTTPリクエストではない，不正なデータを受信した場合

リクエスト処理中に例外が発生した場合

なお，ルートアプリケーション情報の文字列表現での出力に使用するAPIは，com.hitachi.software.ejb.application.prfパッケージで提供されている，CprfTraceクラスのgetRootApInfoメソッドです。

J2EEアプリケーションまたはバッチアプリケーション開発時のルートアプリケーション情報の取得の実装については，「7.4　性能解析トレースのルートアプリケーション情報取得のための実装」を参照してください。APIの詳細については，マニュアル「アプリケーションサーバ リファレンス API編」を参照してください。

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

データベースとしてHiRDBまたはOracleを使用している場合，性能解析トレースファイルに出力されたコネクションIDと，HiRDBクライアントおよびOracleクライアントのログファイルやトレースファイルに出力されたコネクションIDを突き合わせて確認することで，トラブルが発生したコネクションを確認できます。確認方法については，「付録B　データベースと接続中にトラブルが発生したコネクションの特定」を参照してください。

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

J2EEアプリケーションまたはバッチアプリケーションでスローダウンやハングアップが発生したときに，性能解析トレースファイルとスレッドダンプを対応づけることで，問題が発生した個所を調査できます。

性能解析トレースファイルとスレッドダンプの対応づけには，性能解析トレースファイルに出力されたスレッドIDと，スレッドダンプに出力されたスレッド情報のnativeID（OSレベルのスレッドID）を使用します。ここでは，性能解析トレースファイルから対応するスレッドダンプを特定する方法について説明します。

性能解析トレースファイルから対応するスレッドダンプを特定する手順を次に示します。

性能解析トレースファイル，およびスレッドダンプを収集します。

性能解析トレースファイルの収集方法については，「7.3.1　性能解析トレースファイルの収集方法」を参照してください。スレッドダンプの収集方法については，「4.7　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）」の値を16進数に変換します。

WindowsおよびAIXの場合

Thread（スレッドID）の値を10進数から16進数に変換します。

Linuxの場合

hashcode（ハッシュコード）の値を10進数から16進数に変換します。

手順3.で16進数に変換した「Thread（hashcode）」の値と一致するスレッド情報を探して，対応するスレッド情報を特定します。

WindowsおよびAIXの場合

スレッドダンプの「nid」が，16進数に変換したThread（スレッドID）の値（1124）と一致するスレッド情報を探します。

　：
　：
"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)
　：
　：

Linuxの場合

スレッドダンプの「jid」が，16進数に変換したhashcode（ハッシュコード）の値（6d75）と一致するスレッド情報を探します。

　：
　：
"main" prio=1 jid=0x00006d75 tid=0x00201d70 nid=0x1e51 waiting on condition [0x00000000..0xbfe80488]
  stack=[0xbfe87000..0xbfc8c000..0xbfc88000..0xbfc87000]
  [user cpu time=1320ms, kernel cpu time=4280ms] [blocked count=5, waited count=4]
　：
　：

7.8　ユーザ拡張性能解析トレース使用時の注意事項

ユーザ拡張性能解析トレースを使用する場合の注意事項を次に示します。

トレース対象メソッドが頻繁に呼び出される場合，ユーザ拡張性能解析トレースの処理のオーバーヘッドによる性能劣化によって，劣化の要因となるメソッドの特定が困難になることがあります。そのため，トレース対象メソッドには劣化要因が特定できる処理の入口となるメソッドを指定してください。

例えば，次の図に示すようなメソッドの呼び出し関係のあるアプリケーションの場合，処理の入口となるメソッド1（トレース取得ポイント1）を対象としてください。トレース取得ポイント2のメソッド4，メソッド5，メソッド6を指定すると，これらのメソッドに対するユーザ拡張性能解析トレースの処理に時間が掛かると，このアプリケーションの性能測定に影響を与えることがあります。

図7‒13　アプリケーションのメソッドの呼び出し関係

ルートアプリケーション情報を取得する前に呼び出されるメソッドにユーザ拡張性能解析トレースを使用した場合，ルートアプリケーション情報が0で出力されることがあります。

トレース対象メソッドの呼び出し回数を増やしたり，トレースの出力量を増やすプロパティを指定したりした場合，PRFトレースファイルの出力量が増えます。その場合は，PRFトレースファイル面数またはPRFトレースファイルサイズの量を増やしてください。PRFトレースファイル数とPRFトレースファイルサイズの変更の方法については，マニュアル「アプリケーションサーバ運用管理ポータル操作ガイド」の「10.3.1　パフォーマンストレーサの設定」を参照してください。

なお，PRFトレースファイルの出力量の増加は，次の現象に対する原因となります。

トレースファイルへの書き込みによるオーバーヘッドが発生して性能劣化につながります。

大量の書き込みでトレースファイルの面の切り替えが発生して，J2EEサーバが取得しているトレースが取得できなくなることがあります。

通常運用時では，ユーザ拡張性能解析トレース設定ファイルの指定内容を適切に設定してトレース取得量を調整してください。

ユーザ拡張性能解析トレースでは，アプリケーションのクラスを書き換えます。このとき，クラスの書き換え後のサイズが64キロバイトを超える場合は，書き換えに失敗します。その場合は，クラスを分割するなどしてクラスのサイズを小さくしてください。

8　性能解析トレースのトレース取得ポイントとPRFトレース取得レベル

性能解析トレースには，アプリケーションサーバの性能を解析する性能解析トレースと，性能解析トレースの対象を拡張してアプリケーションサーバ上に構築したアプリケーションの性能を解析するユーザ拡張性能解析トレースの2種類があります。この章では，性能解析トレースおよびユーザ拡張性能解析トレースによって出力されるトレース取得ポイントとPRFトレース取得レベルについて説明します。

性能解析トレースの概要と，解析方法については，「7.　性能解析トレースを使用した性能解析」を参照してください。

8.1　この章の構成

この章では，次の性能解析トレースのトレース取得ポイントとPRFトレース取得レベルについて説明します。

性能解析トレースによって，機能レイヤごとに出力されるトレース取得ポイントとPRFトレース取得レベル

WebクライアントまたはEJBクライアントからリクエストが送信された場合に，J2EEサーバ，EJBクライアント，およびCTMでは，決まった処理のポイント（トレース取得ポイント）でトレース情報を出力します。また，性能解析トレースでは，標準，詳細などのPRFトレース取得レベルを設定してトレースを出力できます。

ユーザ拡張性能解析トレースによって，アプリケーションの処理の起点となるメソッドごとに出力されるトレース取得ポイントとPRFトレース取得レベル

ユーザ拡張性能解析トレースでは，アプリケーションの性能解析情報を取得したい処理ポイントとして，アプリケーションの処理の起点となるメソッドを指定することで，そのメソッドが呼ばれたポイントでトレースを出力できます。

この章の構成を次の表に示します。

表8‒1　この章の構成（性能解析トレース）

分類

タイトル

参照先

解説

性能解析トレースのトレース取得ポイントとPRFトレース取得レベルの概要

8.2

CTMのトレース取得ポイント

8.3

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

8.4

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

8.5

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

8.6

Webコンテナのトレース取得ポイント（データベースセッションフェイルオーバ機能のトレース）

8.7

Webコンテナのトレース取得ポイント（セッションマネージャの指定機能のトレース）

8.8

EJBコンテナのトレース取得ポイント

8.9

JNDIのトレース取得ポイント

8.10

JTAのトレース取得ポイント

8.11

DB Connector，JCAコンテナのトレース取得ポイント

8.12

RMIのトレース取得ポイント

8.13

OTSのトレース取得ポイント

8.14

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

8.15

DIのトレース取得ポイント

8.16

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

8.17

JPAでのトレース取得ポイント

8.18

TP1インバウンド連携機能のトレース取得ポイント

8.19

CJMSプロバイダのトレース取得ポイント

8.20

JavaMailのトレース取得ポイント

8.21

JSF 2.3のトレース取得ポイント

8.22

CDIのトレース取得ポイント

8.23

J2EEサーバの開始・終了時のトレース取得ポイント

8.24

アプリケーションのトレース取得ポイント

8.25

JAX-RSのトレース取得ポイント

8.26

Java Batchのトレース取得ポイント

8.27

WebSocketのトレース取得ポイント

8.28

Concurrency Utilitiesのトレース取得ポイント

8.29

注　「実装」，「設定」，「運用」および「注意事項」について，この機能固有の説明はありません。

なお，性能解析トレースの概要と，解析方法については，「7.　性能解析トレースを使用した性能解析」を参照してください。

8.2　性能解析トレースのトレース取得ポイントとPRFトレース取得レベルの概要

ここでは，トレース取得ポイントとPRFトレース取得レベルについて説明します。

8.2.1　トレース取得ポイント

トレース取得ポイントは大きく分けて，J2EEサーバの開始・終了時でのトレース取得と，各機能レイヤでの処理中のトレース取得およびアプリケーションのメソッドの開始・終了時でのトレース取得があります。

(1)　J2EEサーバの開始・終了時のトレース取得

J2EEサーバの開始処理の完了時，およびJ2EEサーバの終了処理の開始時に，トレース情報を取得できます。取得できるイベントIDと参照先を次に示します。

イベントID

0x8FFE〜0x8FFF

参照先

J2EEサーバの開始・終了時のトレース取得の詳細については，「8.24　J2EEサーバの開始・終了時のトレース取得ポイント」を参照してください。

(2)　各機能レイヤでのトレース取得

取得できるイベントIDと機能レイヤの対応を次の表に示します。

表8‒2　取得できるイベントIDと機能レイヤ

イベントID

機能レイヤ

図中の番号※

参照先

0x1101〜0x1102

0x1301〜0x1302

0x1401〜0x1406

0x2002〜0x2003

0x2101〜0x2104

0x3000〜0x3008

CTM

5

8.3

0x8202〜0x8203

0x8206〜0x8210

0x8214〜0x8216

0x8219〜0x8225

0x8234〜0x8252

0x8302〜0x8303

0x8306〜0x8310

0x8314〜0x8316

0x8319〜0x8325

0x8334〜0x8352

Webコンテナ

2

8.4，8.5，8.6，8.7，8.8

0x8401〜0x840A

0x8425〜0x8428

0x842D〜0x8434

0x8453〜0x8454

0x8460〜0x846D

0x8470〜0x8477

0x8490〜0x8491

0x84A0〜0x84D9

0x8C41

EJBコンテナ

6

8.9

0x8603〜0x861C

JNDI

4

8.10

0x8435〜0x843F

0x8811〜0x8820

0x8C41

JTA

7

8.11

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

8.12

0x8E01〜0x8E06

RMI

3

8.13

0x9400〜0x9413

OTS

9

8.14

0x9C00〜0x9C03

標準出力／標準エラー出力／ユーザログ

−

8.15

0x9D00，0x9D01

DI

10

8.16

0xA100，0xA101

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

11

8.17

0xD100〜0xD10F

0xD110〜0xD11F

0xD120〜0xD12F

0xD130〜0xD13F

0xD140〜0xD14F

0xD150〜0xD15F

0xD160〜0xD16F

0xD170〜0xD17F

0xD180〜0xD18F

0xD190〜0xD19F

0xD1A0〜0xD1AF

0xD1B0〜0xD1BF

0xD1C0〜0xD1CF

0xD1D0〜0xD1DF

0xD1E0〜0xD1EF

0xD1F0〜0xD1FF

JPA

12

8.18

0x842F

0x8430〜0x8432

0x8825

0x8826

0x8B86，0x8B87

0x8B8A〜0x8B93

0xAA00〜0xAA06

0xAA08〜0xAA0D

0xAA10〜0xAA19

TP1インバウンド連携機能

14

8.19

0xA600〜0xA60F

0xA610〜0xA619

0xA61E，0xA61F

0xA620〜0xA62F

0xA630〜0xA63F

0xA640〜0xA64F

0xA650〜0xA65F

0xA660〜0xA667

0xA61A，0xA61B

0xA668〜0xA66F

0xA670〜0xA67F

0xA686〜0xA68D

0xA692〜0xA69B

0xA69E，0xA69F

0xA6A0，0xA6A1

0xA6A6〜0xA6AB

CJMSプロバイダ

15

8.20

0xAD00〜0xAD15

0xAD80〜0xAD93

JavaMail

16

8.21

0xAF20〜0xAF2D

JSF 2.3

17

8.22

0xb002〜0xb009

CDI

18

8.23

0xD000〜0xD005

JAX-RS

19

8.26

0xD020〜0xD04D

Java Batch

20

8.27

0xE100〜0xE147

WebSocket

21

8.28

0xD050〜0xD057

Concurrency Utilities

22

8.29

（凡例）−：該当しない

注※　図8-1〜図8-4中の番号と対応しています。

PRFトレースを出力する機能レイヤとトレース取得ポイントについて，システムの構成ごとに次の図に示します。

図8‒1　機能レイヤとトレース取得ポイント（Webクライアント構成の場合）

図8‒2　機能レイヤとトレース取得ポイント（バッチアプリケーションを実行するシステムの場合）

図8‒3　機能レイヤとトレース取得ポイント（EJBクライアント/TPBrokerクライアント/TPBroker OTMクライアント構成（CTM使用）の場合）

図8‒4　機能レイヤとトレース取得ポイント（TP1インバウンド連携機能の場合）

トレース取得ポイントは，各機能レイヤ内でさらに詳細に分かれており，トレース取得ポイントによって，PRFトレース取得レベルが異なります。各機能レイヤの詳細なトレース取得ポイント，およびPRFトレース取得レベルについては，表8-2の参照先を参照してください。

参考

表8-2に示した機能レイヤのほか，Application Serverのプロセス，構成ソフトウェアおよび関連プログラムでも，PRFトレースが取得できるものがあります。

表8-2に示した以外でPRFトレースを取得できる機能レイヤとイベントIDの対応を，次の表に示します。

表8‒3　表8-2に示した以外でPRFトレースを取得できるイベントIDと機能レイヤの対応

イベントID

機能レイヤ

0x9000〜0x90FF

0xA400〜0xA4FF

SOAP通信基盤

0x9100〜0x91FF

TP1 Connector

TP1/Client/J

0x9200〜0x92FF

TP1/MQ Access

0x9300〜0x93FF

Reliable Messaging

0x9800〜0x9B6E

HCSCサーバ

0x9E00〜0x9EFF

Service Coordinator Interactive Workflow

0x9F00〜0x9FFF

HCSCサーバ（Object Accessアダプタ）

0xA000〜0xA0FF

HCSCサーバ（ファイルアダプタ）

0xA200〜0xA2FF

HCSCサーバ（Message Queueアダプタ）

0xAB00〜0xABFF

0xAC00〜0xACFF

HCSCサーバ（FTPアダプタ）

0xA400〜0xA4FF

JAX-WSエンジン

0xE000〜0xE0FF

Elastic Application Data store

(3)　アプリケーションのメソッドの開始・終了時トレース取得

アプリケーションのメソッドの開始時，および終了時にトレース情報を取得できます。取得できるトレース情報を次に示します。

メソッドの開始時刻，終了時刻

識別ID

パッケージ名，クラス名，メソッド名

メソッドで実行された最後の行の行番号

発生した例外またはエラーのクラス名

トレース情報の詳細については，「8.25　アプリケーションのトレース取得ポイント」を参照してください。

(4)　各トレースのリターンコード

各トレースのリターンコードは入口トレースの場合，常に「0」が出力されます。

出口トレースおよび呼び出し後トレースの場合，次のように出力されます。

正常終了：0

異常終了：0以外

8.2.2　PRFトレース取得レベル

性能解析トレースでは，次の4種類のPRFトレース取得レベルを設定してトレースを出力できます。レベルによって，トレース取得ポイントの数が異なります。トレース取得ポイント，およびPRFトレース取得レベルについては，表8-2の参照先を参照してください。

標準レベル

各機能レイヤの境界（入り口と出口）を識別できるトレース情報を出力します。

詳細レベル

標準レベルの出力内容に加えて，各機能レイヤ内処理のトレース情報も出力します。

保守レベル

障害発生時などの保守情報を取得するためのレベルです。

抑止レベル

トレース情報の出力を抑止するためのレベルです。RMI，JSF 2.3，JAX-RS，Java Batch，WebSocket，およびConcurrency Utilitiesの機能レイヤに設定できます。

Management Serverを利用して運用している場合は，簡易構築定義ファイルで，すべての機能レイヤに対して共通のレベルを設定して，トレース情報を出力します。

なお，次節以降は，トレース取得レベルが標準レベルと詳細レベルのトレース取得ポイントについて説明します。保守レベルは，障害発生時などの保守情報を取得するためのレベルのため，通常は収集する必要はありません。

8.3　CTMのトレース取得ポイント

ここでは，CTMでのトレース取得ポイントと，取得できるトレース情報について説明します。

8.3.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒4　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クライアントまたはcjexecjobコマンドからのリクエスト受信直後

A

0x2102

14

EJBクライアントまたはcjexecjobコマンドへのレスポンス送信直前

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：詳細　−：該当なし

注※　図8-5〜図8-8中の番号と対応しています。

CTMでのトレース取得ポイントを次の図に示します。

図8‒5　CTMのトレース取得ポイント

ほかのCTMと連携している場合は，次の図に示す場所でもトレース情報を取得します。上記の図とあわせて参照してください。なお，この図では，ほかのCTMと連携している個所だけを取り上げています。

図8‒6　CTMのトレース取得ポイント（他CTMと連携している場合）

また，OTMゲートウェイまたはORBゲートウェイを使用する場合は，次の図に示す場所でもトレース情報を取得します。上記の図とあわせて参照してください。なお，この図では，ほかのCTMと連携している個所だけを取り上げています。

図8‒7　CTMのトレース取得ポイント（OTMゲートウェイを使用する場合）

図8‒8　CTMのトレース取得ポイント（ORBゲートウェイを使用する場合）

8.3.2　取得できるトレース情報

CTMで取得できるトレース情報を次の表に示します。

表8‒5　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：詳細　−：該当なし

注※　図8-5〜図8-8中の番号と対応しています。

8.4　Webコンテナのトレース取得ポイント（リクエスト処理のトレース）

ここでは，Webコンテナのトレース取得ポイントと，取得できるトレース情報について説明します。なお，Webコンテナでは，リクエスト処理のトレースとセッショントレースが出力されます。ここでは，リクエスト処理のトレースについて説明します。

8.4.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒6　Webコンテナでのトレース取得ポイントの詳細（リクエスト処理のトレース）

イベントID

図中の番号※1

トレース取得ポイント

レベル

0x8202※2

6

サーブレット／JSPの呼び出し直前

A／B

0x8203

5

フィルタの呼び出し直前

B

0x8206

7

RequestDispatcherのforward()／include()呼び出し直前

B

0x8207

6

静的コンテンツの呼び出し

A／B

0x8234

4

同期処理の開始直後

A

0x8235

14

非同期処理の開始直後

A

0x8236

3

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8237

1

リバースプロキシからのデータ読み込み開始直前

B

0x8238

8

リバースプロキシへのデータ書き込み開始直前

B

0x8239

16

非同期サーブレット処理の開始直後

A

0x8260

19

javax.servlet.http.PushBuilder.pushメソッドによるpush処理開始直前

A

0x8302

11

サーブレット／JSPの処理完了直後

A／B

0x8303

12

フィルタの処理完了直後

B

0x8306

10

RequestDispatcherのforward()／include()処理完了直後

B

0x8307

11

静的コンテンツの処理完了直後

A／B

0x8334

13

同期処理の完了直前

A

0x8335

15

非同期処理の完了直前

A

0x8336

18

リクエスト処理完了直後

A

0x8337

2

リバースプロキシからのデータ読み込み完了直後

B

0x8338

9

リバースプロキシへのデータ書き込み完了直後

B

0x8339

17

非同期サーブレット処理の完了直前

A

0x8360

20

javax.servlet.http.PushBuilder.pushメソッドによるpush処理開始直後

A

（凡例）A：標準　B：詳細　A／B：標準と詳細で異なる情報を取得

注※1　図8-9中の番号と対応しています。

注※2　JSPのコンパイルが必要な場合は，JSPのコンパイルを実行したあと，トレースを取得します。

Webコンテナでのトレース取得ポイントを次の図に示します。

図8‒9　Webコンテナのトレース取得ポイント（リクエスト処理のトレース）

8.4.2　取得できるトレース情報

Webコンテナで取得できるトレース情報を次の表に示します。

表8‒7　Webコンテナで取得できるトレース情報（リクエスト処理のトレース）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8237

B

要求サイズ

−

−

2

0x8337

B

読み込めたサイズ

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

4

0x8234

A

−

−

−

5

0x8203

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

6

0x8202

A

クラス名（JSP呼び出し時はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入口時刻><セッションID文字数:セッションID>

例外発生時

<入口時刻><例外名:セッションID文字数:セッションID>

0x8207

B

−

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

7

0x8206

B

クラス名

ディスパッチのタイプ

コンテキストルート

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

8

0x8238

B

書き込みサイズ

−

−

9

0x8338

B

書き込めたサイズ

−

正常時

<入口時刻>

例外発生時

<入口時刻><例外名>

10

0x8306

B

クラス名

ディスパッチのタイプ

コンテキストルート名

正常時

<入口時刻><セッションID文字数:セッションID>

例外発生時

<入口時刻><例外名:セッションID文字数:セッションID>

11

0x8302

A

クラス名（JSP呼び出し時はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入口時刻><セッションID文字数:セッションID>

例外発生時

<入口時刻><例外名:セッションID文字数:セッションID>

0x8307

B

−

コンテキストルート名

正常時

<入口時刻><セッションID文字数:セッションID>

例外発生時

<入口時刻><例外名:セッションID文字数:セッションID>

12

0x8303

B

クラス名

コンテキストルート名

正常時

<入口時刻><セッションID文字数:セッションID>

例外発生時

<入口時刻><例外名:セッションID文字数:セッションID>

13

0x8334

A

−

−

<入り口時刻>

14

0x8235

A

非同期処理の実装クラス名

−

−

15

0x8335

A

非同期処理の実装クラス名

−

正常時

<入口時刻>

例外発生時

<入口時刻><例外名>

16

0x8239

A

−

−

−

17

0x8339

A

−

−

<入り口時刻>

18

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

19

0x8260

A

HTTPメソッド

pushするリクエストのURI

−

20

0x8360

A

HTTPメソッド

pushするリクエストのURI

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-9中の番号と対応しています。

参考

SOAPクライアント以外のリクエストを受信した場合，トレース情報のキー情報である「クライアントアプリケーション情報」には，常に0が表示されます。SOAPクライアントのリクエストを受信した場合だけ，「クライアントアプリケーション情報」が出力されます。

8.5　Webコンテナのトレース取得ポイント（セッショントレース）

ここでは，Webコンテナのトレースのトレース取得ポイントと，取得できるトレース情報について説明します。なお，Webコンテナでは，リクエスト処理のトレースとセッショントレースが出力されます。ここでは，セッショントレース，およびグローバルセッションについてのトレース取得ポイントと取得できるトレース情報について説明します。

8.5.1　トレース取得ポイントとPRFトレース取得レベル（セッショントレース）

セッショントレースに関連するトレースの，イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。なお，「0x8203」，「0x8202」，「0x8207」，および「0x8206」では，グローバルセッションについての情報も出力されます。

表8‒8　Webコンテナでのトレース取得ポイントの詳細（セッショントレース）

イベントID

図中の番号※1

トレース取得ポイント

レベル※2

0x8202

4，9

サーブレット／JSP呼び出し直前

A／B

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

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

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8302

10，13

サーブレット／JSP処理完了直後

A／B

0x8303

14，15

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了直後

（web.xmlの<filter-mapping>タグの<dispatcher>タグで""REQUEST""を指定したフィルタの処理が完了した場合）

B

0x8306

12

RequestDispatcher経由のサーブレット／JSP処理完了直後

B

0x8307

10，13

静的コンテンツ処理完了直後（DefaultServlet）

B

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

0x8336

16

リクエスト処理完了直後

A

（凡例）A：標準　B：詳細　A／B：標準と詳細で異なる情報を取得

注※1　図8-10中の番号と対応しています。

注※2　セッショントレースについての情報はレベルが「詳細」の場合だけ出力されます。

Webコンテナでのセッショントレースのトレース取得ポイントを次の図に示します。

図8‒10　Webコンテナのトレース取得ポイント（セッショントレース）

それぞれのポイントで取得できるセッションIDについて説明します。

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アプリケーションでセッションが破棄されることはありません。

17のポイント

有効期限を超えたセッションが破棄された場合だけ，無効になったセッションIDを取得できます。

8.5.2　取得できるトレース情報

セッショントレースについて，Webコンテナで取得できるトレース情報を次の表に示します。なお，イベントIDが「0x8202」，「0x8203」，「0x8206」，「0x8207」，「0x8214」，および「0x8215」のトレース取得ポイントでは，グローバルセッションについての情報も出力されます。

表8‒9　Webコンテナで取得できるトレース情報（セッショントレース）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

4，9

0x8202

A

クラス名（JSP呼び出し時はJSPファイル名）

−

−

B

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

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>

8

0x8214

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

8

0x8215

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

2

0x8216

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

16

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

10，13

0x8302

A

クラス名（JSP呼び出し時はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻>＜例外名:セッションID文字数:セッションID>

14，15

0x8303

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻>＜例外名:セッションID文字数:セッションID>

12

0x8306

B

クラス名

ディスパッチのタイプ

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻>＜例外名:セッションID文字数:セッションID>

10，13

0x8307

B

−

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻>＜例外名:セッションID文字数:セッションID>

11

0x8314

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

11

0x8315

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

15

0x8316

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-10中の番号と対応しています。

8.6　Webコンテナのトレース取得ポイント（フィルタのトレース）

ここでは，フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナのトレースのトレース取得ポイントと，取得できるトレース情報について説明します。

なお，フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナでは，正常に処理が終了した場合と障害が発生した場合で取得できるトレース情報が異なります。ここでは，それぞれの場合について説明します。

なお，JSPのpageディレクティブでerrorPage属性を使用しエラーページを設定して，JSPで例外が発生した場合，リクエストのforwardでエラーページが表示されます。したがって，JSPでエラーページを表示する場合も，forward時のトレースが出力されます。

8.6.1　正常に処理が終了した場合のWebコンテナのトレース取得ポイント（フィルタのトレース）

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒10　正常終了時のWebコンテナでのトレース取得ポイントの詳細（フィルタのトレース）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8202

3

サーブレット／JSPの呼び出し直前

A／B

0x8202

6

サーブレット／JSPの呼び出し直前

A／B

0x8203

2

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し直前（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略，または<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8206

4

RequestDispatcher経由のサーブレット／JSP呼び出し直前

B

0x8207

6

静的コンテンツ呼び出し直前（DefaultServlet）

B

0x8214

5

フォワード時に実行されるフィルタの呼び出し直前（web.xmlの<filter-mapping>タグの<dispatcher>タグで"FORWARD"を指定したフィルタ）

B

0x8215

5

インクルード時に実行されるフィルタの呼び出し直前

（web.xmlの<filter-mapping>タグの<dispatcher>タグで"INCLUDE"を指定したフィルタ）

B

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8302

7

サーブレット／JSPの処理完了直後

A／B

0x8302

10

サーブレット／JSPの処理完了直後

A／B

0x8303

11

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8306

9

RequestDispatcher経由のサーブレット／JSP処理完了直後

B

0x8307

7

静的コンテンツ処理完了直後(DefaultServlet)

B

0x8314

8

フォワード時に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"FORWARD"を指定したフィルタ）

B

0x8315

8

インクルード時に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"INCLUDE"を指定したフィルタ）

B

0x8336

12

リクエスト処理完了直後

A

（凡例）A：標準　B：詳細　A／B：標準と詳細で異なる情報を取得

注※　図8-11中の番号と対応しています。

フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナでのトレース取得ポイントを次の図に示します。

図8‒11　正常終了時のWebコンテナでのトレース取得ポイント（フィルタのトレース）

(2)　取得できるトレース情報

フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナで取得できるトレース情報を次の表に示します。

表8‒11　正常終了時のWebコンテナで取得できるトレース情報（フィルタのトレース）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

2

0x8203

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

3

0x8202

A

クラス名（JSP呼び出しの場合はJSPファイル名）

−

−

B

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

4

0x8206

B

クラス名

ディスパッチのタイプ

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

5

0x8214

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8215

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

6

0x8202

A

クラス名（JSP呼び出しの場合はJSPファイル名）

−

−

B

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8207

B

−

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

7

0x8302

A

クラス名（JSP呼び出しの場合はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8307

B

−

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

8

0x8314

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8315

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

9

0x8306

B

クラス名

ディスパッチのタイプ

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

10

0x8302

A

クラス名（JSP呼び出しの場合はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

11

0x8303

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

12

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-11中の番号と対応しています。

8.6.2　例外が発生した場合のWebコンテナのトレース取得ポイント（フィルタのトレース）

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒12　例外が発生した場合のWebコンテナでのトレース取得ポイントの詳細（フィルタのトレース）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8202

3

サーブレット／JSPの呼び出し直前

A／B

0x8202

8

サーブレット／JSPの呼び出し直前

A／B

0x8203

2

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し直前（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略，または<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8206

6

RequestDispatcher経由のサーブレット／JSP呼び出し直前

B

0x8207

8

静的コンテンツ呼び出し直前（DefaultServlet）

B

0x8216

7

エラーページに転送される際に実行されるフィルタの呼び出し直前（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタ）

B

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8302

4，9

サーブレット／JSPの処理完了直後

A／B

0x8303

5

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8306

11

RequestDispatcher経由のサーブレット／JSP処理完了直後

B

0x8307

9

静的コンテンツ処理完了直後(DefaultServlet)

B

0x8316

10

エラーページに転送される際に実行されるフィルタの処理完了直後

（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタ）

B

0x8336

12

リクエスト処理完了直後

A

（凡例）A：標準　B：詳細　A／B：標準と詳細で異なる情報を取得

注※　図8-12中の番号と対応しています。

例外が発生した場合のWebコンテナでのトレース取得ポイントを次の図に示します。

図8‒12　例外が発生した場合のWebコンテナでのトレース取得ポイント

(2)　取得できるトレース情報

フォワード時，またはインクルード時に呼び出されるフィルタを設定した場合のWebコンテナで取得できるトレース情報を次の表に示します。

表8‒13　例外が発生した場合のWebコンテナで取得できるトレース情報（フィルタのトレース）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

2

0x8203

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

3

0x8202

A

クラス名（JSP呼び出しの場合はJSPファイル名）

−

−

B

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

4

0x8302

A

クラス名（JSP呼び出しの場合はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

5

0x8303

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

6

0x8206

B

クラス名

ディスパッチのタイプ

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

7

0x8216

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

8

0x8202

A

クラス名（JSP呼び出しの場合はJSPファイル名）

−

−

B

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8207

B

−

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

9

0x8302

A

クラス名（JSP呼び出しの場合はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8307

B

−

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻>＜例外名:セッションID文字数:セッションID>

10

0x8316

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

11

0x8306

B

クラス名

ディスパッチのタイプ

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

12

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-12中の番号と対応しています。

8.7　Webコンテナのトレース取得ポイント（データベースセッションフェイルオーバ機能のトレース）

ここでは，データベースセッションフェイルオーバ機能を使用した場合のトレース取得ポイントと，取得できるトレース情報について説明します。

8.7.1　HTTPセッションを作成するリクエスト処理のトレース取得ポイントと取得できるトレース情報（データベースセッションフェイルオーバ機能のトレース）

HTTPセッションを作成するリクエスト処理のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒14　HTTPセッションを作成するリクエスト処理のトレース取得ポイントの詳細（データベースセッションフェイルオーバ機能）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8202

2

サーブレット／JSP呼び出し直前

A／B

0x8203

2

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し直前（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略，または<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8207

2

静的コンテンツ呼び出し直前（DefaultServlet）

B

0x8219

6

データベースセッションフェイルオーバ機能によるHTTPセッションの属性情報のシリアライズ開始直前

A

0x8222

8

データベースセッションフェイルオーバ機能によるWebアプリケーション処理後のデータベースアクセス開始直前

A

0x8223

3

データベースセッションフェイルオーバ機能によるHTTPセッション作成時のデータベースアクセス開始直前

A

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8302

5

サーブレット／JSP処理完了直後

A／B

0x8303

5

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8307

5

静的コンテンツ処理完了直後（DefaultServlet）

B

0x8316

5

エラーページに転送される際に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタ）

B

0x8319

7

データベースセッションフェイルオーバ機能によるHTTPセッションの属性情報のシリアライズ終了直後

A

0x8322

9

データベースセッションフェイルオーバ機能によるWebアプリケーション処理後のデータベースアクセス終了直後

A

0x8323

4

データベースセッションフェイルオーバ機能によるHTTPセッション作成時のデータベースアクセス終了直後

A

0x8336

10

リクエスト処理完了直後

A

（凡例）A：標準　B：詳細　A／B：標準と詳細で異なる情報を取得

注※　図8-13中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒13　HTTPセッションを作成するリクエスト処理のトレース取得ポイント（データベースセッションフェイルオーバ機能）

(2)　取得できるトレース情報

HTTPセッションを作成するリクエスト処理で取得できるトレース情報を次の表に示します。

表8‒15　HTTPセッションを作成するリクエスト処理で取得できるトレース情報（データベースセッションフェイルオーバ機能）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

2

0x8202

A

クラス名

（JSP呼び出し時はJSPファイル名）

−

−

B

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8207

B

−

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8203

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

3

0x8223

A

−

−

−

4

0x8323

A

完全性保障モードが有効な場合

排他を取得したレコード番号

完全性保障モードが無効な場合

-1

−

正常時

<入り口時刻><セッションID文字数:作成したHTTPセッションのセッションID>

例外発生時

<入り口時刻><例外名>

5

0x8302

A

クラス名

（JSP呼び出し時はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8307

B

−

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8303

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8316

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

6

0x8219

A

リクエストURL

−

<セッションID文字数:セッションID>

7

0x8319

A

リクエストURL

シリアライズ後のHTTPセッションの属性情報のサイズ（バイト）

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

8

0x8222

A

−

−

<セッションIDの文字数:HTTPセッションのセッションID>

9

0x8322

A

完全性保障モードが有効な場合

排他を解放したレコード番号

完全性保障モードが無効な場合

-1

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

10

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-13中の番号と対応しています。

8.7.2　HTTPセッションを更新するリクエスト処理のトレース取得ポイントと取得できるトレース情報（データベースセッションフェイルオーバ機能のトレース）

HTTPセッションを更新するリクエスト処理のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒16　HTTPセッションを更新するリクエスト処理のトレース取得ポイントの詳細（データベースセッションフェイルオーバ機能）

イベントID

図中の番号※1

トレース取得ポイント

レベル

0x8202

6

サーブレット／JSP呼び出し直前

A／B

0x8203

6

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し直前（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略，または<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8207

6

静的コンテンツ呼び出し直前（DefaultServlet）

B

0x8219※2

8

データベースセッションフェイルオーバ機能によるHTTPセッションの属性情報のシリアライズ開始直前

A

0x8220

4

データベースセッションフェイルオーバ機能によるHTTPセッションの属性情報のデシリアライズ開始直前

A

0x8221

2

データベースセッションフェイルオーバ機能によるWebアプリケーション処理前のデータベースアクセス開始直前

A

0x8222※2

10

データベースセッションフェイルオーバ機能によるWebアプリケーション処理後のデータベースアクセス開始直前

A

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8302

7

サーブレット／JSP処理完了直後

A／B

0x8303

7

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8307

7

静的コンテンツ処理完了直後（DefaultServlet）

B

0x8316

7

エラーページに転送される時に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタ）

B

0x8319※2

9

データベースセッションフェイルオーバ機能によるHTTPセッションの属性情報のシリアライズ終了直後

A

0x8320

5

データベースセッションフェイルオーバ機能によるHTTPセッションの属性情報のデシリアライズ終了直後

A

0x8321

3

データベースセッションフェイルオーバ機能によるWebアプリケーション処理前のデータベースアクセス終了直後

A

0x8322※2

11

データベースセッションフェイルオーバ機能によるWebアプリケーション処理後のデータベースアクセス終了直後

A

0x8336

12

リクエスト処理完了直後

A

（凡例）A：標準　B：詳細　A／B：標準と詳細で異なる情報を取得

注※1　図8-14中の番号と対応しています。

注※2　HTTPセッションの参照専用リクエストの場合，出力されません。

トレース取得ポイントを次の図に示します。

図8‒14　HTTPセッションを更新するリクエスト処理のトレース取得ポイント（データベースセッションフェイルオーバ機能）

(2)　取得できるトレース情報

HTTPセッションを更新するリクエスト処理で取得できるトレース情報を次の表に示します。

表8‒17　HTTPセッションを更新するリクエスト処理で取得できるトレース情報（データベースセッションフェイルオーバ機能）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし

2

0x8221

A

−

−

<セッションIDの文字数:リクエストで受信したセッションID>

3

0x8321

A

完全性保障モードが有効な場合

排他を取得したレコード番号

完全性保障モードが無効な場合

-1

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

4

0x8220

A

リクエストURL

デシリアライズ前のHTTPセッションの属性情報のサイズ（バイト）

<セッションID文字数:セッションID>

5

0x8320

A

リクエストURL

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

6

0x8202

A

クラス名

（JSP呼び出し時はJSPファイル名）

−

−

B

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8207

B

−

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8203

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

7

0x8302

A

クラス名

（JSP呼び出し時はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8307

B

−

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8303

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8316

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

8

0x8219

A

リクエストURL

−

<セッションID文字数:セッションID>

9

0x8319

A

リクエストURL

シリアライズ後のHTTPセッションの属性情報のサイズ（バイト）

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

10

0x8222

A

−

−

<セッションIDの文字数:HTTPセッションのセッションID>

11

0x8322

A

完全性保障モードが有効な場合

排他を解放したレコード番号

完全性保障モードが無効な場合

-1

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

12

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-14中の番号と対応しています。

8.7.3　HTTPセッションを無効化するリクエスト処理のトレース取得ポイントと取得できるトレース情報（データベースセッションフェイルオーバ機能のトレース）

HTTPセッションを無効化するリクエスト処理のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒18　HTTPセッションを無効化するリクエスト処理のトレース取得ポイントの詳細（データベースセッションフェイルオーバ機能）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8202

6

サーブレット／JSP呼び出し直前

A／B

0x8203

6

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの呼び出し直前（web.xmlの<filter-mapping>タグの<dispatcher>タグを省略，または<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8207

6

静的コンテンツ呼び出し直前（DefaultServlet）

B

0x8220

4

データベースセッションフェイルオーバ機能によるHTTPセッションの属性情報のデシリアライズ開始直前

A

0x8221

2

データベースセッションフェイルオーバ機能によるWebアプリケーション処理前のデータベースアクセス開始直前

A

0x8224

7

データベースセッションフェイルオーバ機能によるHTTPセッション無効化時のデータベースアクセス開始直前

A

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8302

9

サーブレット／JSP処理完了直後

A／B

0x8303

9

リクエストを受信したサーブレット／JSPの実行前に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"REQUEST"を指定したフィルタ）

B

0x8307

9

静的コンテンツ処理完了直後（DefaultServlet）

B

0x8316

9

エラーページに転送される際に実行されるフィルタの処理完了直後（web.xmlの<filter-mapping>タグの<dispatcher>タグで"ERROR"を指定したフィルタ）

B

0x8320

5

データベースセッションフェイルオーバ機能によるHTTPセッションの属性情報のデシリアライズ終了直後

A

0x8321

3

データベースセッションフェイルオーバ機能によるWebアプリケーション処理前のデータベースアクセス終了直後

A

0x8324

8

データベースセッションフェイルオーバ機能によるHTTPセッション無効化時のデータベースアクセス終了直後

A

0x8336

10

リクエスト処理完了直後

A

（凡例）A：標準　B：詳細　A／B：標準と詳細で異なる情報を取得

注※　図8-15中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒15　HTTPセッションを無効化するリクエスト処理のトレース取得ポイント（データベースセッションフェイルオーバ機能）

(2)　取得できるトレース情報

HTTPセッションを無効化するリクエスト処理で取得できるトレース情報を次の表に示します。

表8‒19　HTTPセッションを無効化するリクエスト処理で取得できるトレース情報（データベースセッションフェイルオーバ機能）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

2

0x8221

A

−

−

<セッションIDの文字数:リクエストで受信したセッションID>

3

0x8321

A

完全性保障モードが有効な場合

排他を取得したレコード番号

完全性保障モードが無効な場合

-1

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

4

0x8220

A

リクエストURL

デシリアライズ前のHTTPセッションの属性情報のサイズ（バイト）

<セッションID文字数:セッションID>

5

0x8320

A

リクエストURL

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

6

0x8202

A

クラス名

（JSP呼び出し時はJSPファイル名）

−

−

B

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8207

B

−

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

0x8203

B

クラス名

コンテキストルート名

<セッションID文字数:セッションID:グローバルセッションID文字数:グローバルセッションID>

7

0x8224

A

−

−

<セッションIDの文字数:無効化したHTTPセッションのセッションID>

8

0x8324

A

完全性保障モードが有効な場合

排他を解放したレコード番号

完全性保障モードが無効な場合

-1

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

9

0x8302

A

クラス名

（JSP呼び出し時はJSPファイル名）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

B

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻>＜例外名:セッションID文字数:セッションID>

0x8307

B

−

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8303

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

0x8316

B

クラス名

コンテキストルート名

正常時

<入り口時刻><セッションID文字数:セッションID>

例外発生時

<入り口時刻><例外名:セッションID文字数:セッションID>

10

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-15中の番号と対応しています。

8.7.4　有効期限監視でHTTPセッションを無効化するリクエスト処理のトレース取得ポイントと取得できるトレース情報（データベースセッションフェイルオーバ機能のトレース）

有効期限監視でHTTPセッションを無効化するリクエスト処理のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒20　有効期限監視でHTTPセッションを無効化するリクエスト処理のトレース取得ポイントの詳細（データベースセッションフェイルオーバ機能）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8210

3

セッションタイムアウト後

B

0x8225

1

データベース上のグローバルセッション情報の有効期限監視処理開始直前

A

0x8325

2

データベース上のグローバルセッション情報の有効期限監視処理終了直後

A

（凡例）A：標準　B：詳細

注※　図8-16中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒16　有効期限監視でHTTPセッションを無効化するリクエスト処理のトレース取得ポイント（データベースセッションフェイルオーバ機能）

(2)　取得できるトレース情報

有効期限監視でHTTPセッションを無効化するリクエスト処理で取得できるトレース情報を次の表に示します。

表8‒21　有効期限監視でHTTPセッションを無効化するリクエスト処理で取得できるトレース情報（データベースセッションフェイルオーバ機能）

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8225※2

A

−

−

−

2

0x8325※2

A

グローバルセッション情報の有効期限チェックを実施した場合

無効化したグローバルセッションの個数

グローバルセッション情報の有効期限チェックを実施しなかった場合

現在，有効期限チェックを担当しているJ2EEサーバのJ2EEサーバ名（IPアドレス）

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8210

B

コンテキストルート名

セッション有効期間：セッション生成時刻

<セッションID文字数:セッションID>

（凡例）A：標準　B：詳細　−：該当なし

注※1　図8-16中の番号と対応しています。

注※2　完全性保障モードが無効な場合は，出力されません。

8.8　Webコンテナのトレース取得ポイント（セッションマネージャの指定機能のトレース）

ここでは，セッションマネージャの指定機能を使用した場合のトレース取得ポイントと，取得できるトレース情報について説明します。

8.8.1　HTTPセッションを作成するリクエスト処理のトレース取得ポイントと取得できるトレース情報（セッションマネージャの指定機能のトレース）

HTTPセッションを作成するリクエスト処理のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒22　HTTPセッションを作成するリクエスト処理のトレース取得ポイントの詳細（セッションマネージャの指定機能）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8240

5

セッションの生成直前（セッションマネージャの指定機能）

B

0x8241

3

セッションの探索直前（セッションマネージャの指定機能）

B

0x8248

8

セッションマネージャの指定機能によるHTTPセッションの属性情報の取得直前

B

0x8252

2

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.Valveインタフェースの実装クラスのinvokeメソッド呼び出し直前

B

0x8336

10

リクエスト処理完了直後

A

0x8340

6

セッションの生成直後（セッションマネージャの指定機能）

B

0x8341

4

セッションの探索直後（セッションマネージャの指定機能）

B

0x8348

9

セッションマネージャの指定機能によるHTTPセッションの属性情報の取得直後

B

0x8352

7

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.Valveインタフェースの実装クラスのinvokeメソッド呼び出し直後

B

（凡例）A：標準　B：詳細

注※　図8-17中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒17　HTTPセッションを作成するリクエスト処理のトレース取得ポイント（セッションマネージャの指定機能）

(2)　取得できるトレース情報

HTTPセッションを作成するリクエスト処理で取得できるトレース情報を次の表に示します。

表8‒23　HTTPセッションを作成するリクエスト処理で取得できるトレース情報（セッションマネージャの指定機能）

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名※3

オペレーション名※3※4

オプション※2※4

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

2

0x8252

B

ライブラリにおけるValveインターフェースの実装クラス名

ライブラリの呼び出し元メソッド名

なし

3

0x8241

B

コンテキストルート名

なし

<セッションID文字数:セッションID>

4

0x8341

B

コンテキストルート名

セッション有効期間

正常時

<入り口時刻:セッションID文字数:セッションID>

異常時

<入り口時刻:例外名>

5

0x8240

B

コンテキストルート名

なし

なし

6

0x8340

B

コンテキストルート名

セッション有効期間

正常時

<入り口時刻:セッションID文字数:セッションID>

異常時

<入り口時刻:例外名>

7

0x8352

B

ライブラリにおけるValveインターフェースの実装クラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

8

0x8248

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

<セッションID文字数:セッションID:属性名>

9

0x8348

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

10

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

（凡例）A：標準　B：詳細

注※1　図8-17中の番号と対応しています。

注※2　「例外名」の情報が取得できるトレース取得ポイントでは，PRFトレースに出力した例外のスタックトレースをJ2EEサーバの例外ログに出力します。

注※3　33文字以上の場合，「先頭16文字+*+末尾16文字」で出力します。

注※4　「セッション有効期間」はセッションが存在する場合だけ出力します。「セッションID文字数」「セッションID」はセッションIDが存在する場合だけ出力します。

8.8.2　HTTPセッションを更新するリクエスト処理のトレース取得ポイントと取得できるトレース情報（セッションマネージャの指定機能のトレース）

HTTPセッションを更新するリクエスト処理のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒24　HTTPセッションを更新するリクエスト処理のトレース取得ポイントの詳細（セッションマネージャの指定機能）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8241

3

セッションの探索直前（セッションマネージャの指定機能）

B

0x8246

9

セッションマネージャの指定機能によるHTTPセッションの属性情報の設定直前

B

0x8247

10

セッションマネージャの指定機能によるHTTPセッションの属性情報の消去直前

B

0x8248

4

セッションマネージャの指定機能によるHTTPセッションの属性情報の取得直前

B

0x8252

2

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.Valveインタフェースの実装クラスのinvokeメソッド呼び出し直前

B

0x8336

8

リクエスト処理完了直後

A

0x8341

6

セッションの探索直後（セッションマネージャの指定機能）

B

0x8346

12

セッションマネージャの指定機能によるHTTPセッションの属性情報の設定直後

B

0x8347

11

セッションマネージャの指定機能によるHTTPセッションの属性情報の消去直後

B

0x8348

5

セッションマネージャの指定機能によるHTTPセッションの属性情報の取得直後

B

0x8352

7

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.Valveインタフェースの実装クラスのinvokeメソッド呼び出し直後

B

（凡例）A：標準　B：詳細

注※　図8-18および図8-19中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒18　HTTPセッションを更新するリクエスト処理のトレース取得ポイント（セッションマネージャの指定機能）

図8‒19　HTTPセッションの操作のトレース取得ポイント（セッションマネージャの指定機能）

(2)　取得できるトレース情報

HTTPセッションを更新するリクエスト処理で取得できるトレース情報を次の表に示します。

表8‒25　HTTPセッションを更新するリクエスト処理で取得できるトレース情報（セッションマネージャの指定機能）

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名※3

オペレーション名※3※4

オプション※2※4

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

2

0x8252

B

ライブラリにおけるValveインターフェースの実装クラス名

ライブラリの呼び出し元メソッド名

なし

3

0x8241

B

コンテキストルート名

なし

<セッションID文字数:セッションID>

4

0x8248

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

<セッションID文字数:セッションID:属性名>

5

0x8348

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

6

0x8341

B

コンテキストルート名

セッション有効期間

正常時

<入り口時刻:セッションID文字数:セッションID>

異常時

<入り口時刻:例外名>

7

0x8352

B

ライブラリにおけるValveインターフェースの実装クラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

8

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

9

0x8246

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

<セッションID文字数:セッションID:属性名>

10

0x8247

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

<セッションID文字数:セッションID:属性名>

11

0x8347

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

12

0x8346

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

（凡例）A：標準　B：詳細

注※1　図8-18および図8-19中の番号と対応しています。

注※2　「例外名」の情報が取得できるトレース取得ポイントでは，PRFトレースに出力した例外のスタックトレースをJ2EEサーバの例外ログに出力します。

注※3　33文字以上の場合，「先頭16文字+*+末尾16文字」で出力します。

注※4　「セッション有効期間」はセッションが存在する場合だけ出力します。「セッションID文字数」「セッションID」はセッションIDが存在する場合だけ出力します。

8.8.3　HTTPセッションを無効化するリクエスト処理のトレース取得ポイントと取得できるトレース情報（セッションマネージャの指定機能のトレース）

HTTPセッションを無効化するリクエスト処理のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒26　HTTPセッションを無効化するリクエスト処理のトレース取得ポイントの詳細（セッションマネージャの指定機能）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8209

17

セッションの破棄後

B

0x8236

1

リクエスト取得・リクエストヘッダ解析完了直後

A

0x8241

3

セッションの探索直前（セッションマネージャの指定機能）

B

0x8242

7

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.ManagerBaseのサブクラスのremoveメソッドの呼び出し直前

B

0x8243

11

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.StandardSessionのサブクラスのrecycleメソッドの呼び出し直前

B

0x8244

12

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.StandardSessionのサブクラスのsetAuthTypeメソッドの呼び出し直前

B

0x8245

14

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.StandardSessionのサブクラスのsetPrincipalメソッドの呼び出し直前

B

0x8247

9

セッションマネージャの指定機能によるHTTPセッションの属性情報の消去直前

B

0x8248

4

セッションマネージャの指定機能によるHTTPセッションの属性情報の取得直前

B

0x8252

2

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.Valveインタフェースの実装クラスのinvokeメソッド呼び出し直前

B

0x8336

19

リクエスト処理完了直後

A

0x8341

6

セッションの探索直後（セッションマネージャの指定機能）

B

0x8342

8

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.ManagerBaseのサブクラスのremoveメソッドの呼び出し直後

B

0x8343

16

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.StandardSessionのサブクラスのrecycleメソッドの呼び出し直後

B

0x8344

13

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.StandardSessionのサブクラスのsetAuthTypeメソッドの呼び出し直後

B

0x8345

15

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.StandardSessionのサブクラスのsetPrincipalメソッドの呼び出し直後

B

0x8347

10

セッションマネージャの指定機能によるHTTPセッションの属性情報の消去直後

B

0x8348

5

セッションマネージャの指定機能によるHTTPセッションの属性情報の取得直後

B

0x8352

18

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.Valveインタフェースの実装クラスのinvokeメソッド呼び出し直後

B

（凡例）A：標準　B：詳細

注※　図8-20中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒20　HTTPセッションを無効化するリクエスト処理のトレース取得ポイント（セッションマネージャの指定機能）

(2)　取得できるトレース情報

HTTPセッションを無効化するリクエスト処理で取得できるトレース情報を次の表に示します。

表8‒27　HTTPセッションを無効化するリクエスト処理で取得できるトレース情報（セッションマネージャの指定機能）

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名※3

オペレーション名※3※4

オプション※2※4

1

0x8236

A

HTTPメソッド

URI

プロパティで指定したリクエストヘッダ名に対する値（ヘッダ名未指定の場合はなし）

2

0x8252

B

ライブラリにおけるValveインターフェースの実装クラス名

ライブラリの呼び出し元メソッド名

なし

3

0x8241

B

コンテキストルート名

なし

<セッションID文字数:セッションID>

4

0x8248

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

<セッションID文字数:セッションID:属性名>

5

0x8348

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

6

0x8341

B

コンテキストルート名

セッション有効期間

正常時

<入り口時刻:セッションID文字数:セッションID>

異常時

<入り口時刻:例外名>

7

0x8242

B

コンテキストルート名

なし

<セッションID文字数:セッションID>

8

0x8342

B

コンテキストルート名

なし

正常時

<入り口時刻:セッションID文字数:セッションID>

異常時

<入り口時刻:例外名>

9

0x8247

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

<セッションID文字数:セッションID:属性名>

10

0x8347

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

11

0x8243

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

なし

12

0x8244

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

なし

13

0x8344

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

14

0x8245

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

なし

15

0x8345

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

16

0x8343

B

ライブラリにおけるStandardSessionのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

17

0x8209

B

コンテキストルート名

セッション生成時刻

<セッションID文字数:セッションID>

18

0x8352

B

ライブラリにおけるValveインターフェースの実装クラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻>

異常時

<入り口時刻:例外名>

19

0x8336

A

HTTPメソッド

URI

<入り口時刻><ステータスコード>

（凡例）A：標準　B：詳細

注※1　図8-20中の番号と対応しています。

注※2　「例外名」の情報が取得できるトレース取得ポイントでは，PRFトレースに出力した例外のスタックトレースをJ2EEサーバの例外ログに出力します。

注※3　33文字以上の場合，「先頭16文字+*+末尾16文字」で出力します。

注※4　「セッション有効期間」はセッションが存在する場合だけ出力します。「セッションID文字数」「セッションID」はセッションIDが存在する場合だけ出力します。

8.8.4　セッションマネージャの起動・停止処理のトレース取得ポイントと取得できるトレース情報（セッションマネージャの指定機能のトレース）

セッションマネージャの起動・停止処理のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒28　セッションマネージャの起動・停止処理のトレース取得ポイントの詳細（セッションマネージャの指定機能）

イベントID

トレース取得ポイント

レベル

0x8250

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.ManagerBaseのサブクラスのstartInternalメソッド呼び出し直前

B

0x8251

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.ManagerBaseのサブクラスのstopInternalメソッド呼び出し直前

B

0x8350

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.ManagerBaseのサブクラスのstartInternalメソッド呼び出し直後

B

0x8351

セッションマネージャの指定機能で使用するライブラリが実装するorg.apache.catalina.session.ManagerBaseのサブクラスのstopInternalメソッド呼び出し直後

B

（凡例）A：標準　B：詳細

(2)　取得できるトレース情報

セッションマネージャの起動・停止処理で取得できるトレース情報を次の表に示します。

表8‒29　セッションマネージャの起動・停止処理で取得できるトレース情報（セッションマネージャの指定機能）

イベントID

レベル

取得できる情報

インタフェース名※2

オペレーション名※2

オプション※1

0x8250

B

ライブラリにおけるManagerBaseのサブクラス名

ライブラリの呼び出し元メソッド名

<ライフサイクルの状態>

0x8251

B

ライブラリにおけるManagerBaseのサブクラス名

ライブラリの呼び出し元メソッド名

<ライフサイクルの状態>

0x8350

B

ライブラリにおけるManagerBaseのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻:ライフサイクルの状態>

異常時

<入り口時刻:例外名>

0x8351

B

ライブラリにおけるManagerBaseのサブクラス名

ライブラリの呼び出し元メソッド名

正常時

<入り口時刻:ライフサイクルの状態>

異常時

<入り口時刻:例外名>

（凡例）A：標準　B：詳細

注※1　「例外名」の情報が取得できるトレース取得ポイントでは，PRFトレースに出力した例外のスタックトレースをJ2EEサーバの例外ログに出力します。

注※2　33文字以上の場合，「先頭16文字+*+末尾16文字」で出力します。

8.9　EJBコンテナのトレース取得ポイント

ここでは，EJBコンテナのトレース取得ポイントと，取得できるトレース情報について，Session Bean，Entity Beanの場合，Message-driven Beanの場合，Timer Serviceを使用した場合，およびメソッドキャンセルが発生した場合に分けて説明します。

8.9.1　Session Bean，Entity Beanの場合

Session Bean，Entity Beanのトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒30　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：詳細

注※　図8-21中の番号と対応しています。

Session Bean，Entity Beanでのトレース取得ポイントを次の図に示します。

図8‒21　Session Bean，Entity Beanのトレース取得ポイント

(2)　取得できるトレース情報

Session Bean，Entity Beanで取得できるトレース情報を次の表に示します。

表8‒31　Session Bean，Entity Beanで取得できるトレース情報

図中の番号※

イベント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名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

0x8476

A

Bean名

−

−

0x8477

A

Bean名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

2

0x8409

B

Bean名

メソッド名，引数の数

−

0x8453

B

Bean名

メソッド名，引数の数

−

3

0x840A

B

Bean名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

0x8454

B

Bean名

メソッド名，引数の数

4

0x8402

A

Bean名

メソッド名，引数の数

0x8404

A

Bean名

メソッド名，引数の数

0x8406

A

Bean名

メソッド名，引数の数

0x8408

A

Bean名

メソッド名，引数の数

0x8471

A

Bean名

メソッド名，引数の数

0x8473

A

Bean名

メソッド名，引数の数

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-21中の番号と対応しています。

8.9.2　Message-driven Bean（EJB2.0）の場合

Message-driven Bean（EJB2.0）のトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒32　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：詳細

注※　図8-22中の番号と対応しています。

Message-driven Bean（EJB2.0）でのトレース取得ポイントを次の図に示します。

図8‒22　Message-driven Bean（EJB2.0）のトレース取得ポイント

(2)　取得できるトレース情報

Message-driven Bean（EJB2.0）で取得できるトレース情報を次の表に示します。

表8‒33　Message-driven Bean（EJB2.0）で取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8425

A

Bean名

−

−

2

0x8427

B

−

−

−

3

0x8428

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

4

0x8426

A

Bean名

−

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-22中の番号と対応しています。

8.9.3　Message-driven Bean（EJB2.1以降）の場合

Message-driven Bean（EJB2.1以降）のトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒34　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：標準

注※　図8-23および図8-24中の番号と対応しています。

Message-driven Bean（EJB2.1以降）でのトレース取得ポイントを次の図に示します。

図8‒23　Message-driven Bean（EJB2.1以降）のトレース取得ポイント（optionA※の場合）

注※　Connector 1.5仕様に記述されるメッセージ配送オプションを示します。

図8‒24　Message-driven Bean（EJB2.1以降）のトレース取得ポイント（optionB※の場合）

注※　Connector 1.5仕様に記述されるメッセージ配送オプションを示します。

(2)　取得できるトレース情報

Message-driven Bean（EJB2.1以降）で取得できるトレース情報を次の表に示します。

表8‒35　Message-driven Bean（EJB2.1以降）で取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x842D

A

Bean名

−

−

2

0x842E

A

Bean名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x842F

A

Bean名

メソッド名

−

4

0x8431

A

Bean名

メソッド名

−

5

0x8432

A

Bean名

メソッド名

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

6

0x8430

A

Bean名

メソッド名

7

0x8433

A

Bean名

−

−

8

0x8434

A

Bean名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　−：該当なし

注※　図8-23および図8-24中の番号と対応しています。

8.9.4　Timer Serviceの場合

Timer Serviceのトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　createTimerの場合

(a)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒36　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：標準

注※　図8-25中の番号と対応しています。

createTimerの場合のTimer Serviceでのトレース取得ポイントを次の図に示します。

図8‒25　Timer Serviceのトレース取得ポイント（createTimerの場合）

(b)　取得できるトレース情報

createTimerの場合のTimer Serviceで取得できるトレース情報を次の表に示します。

表8‒37　Timer Serviceで取得できるトレース情報（createTimerの場合）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8460

A

コールバック対象Beanのクラス名

−

引数情報

1

0x8462

A

コールバック対象Beanのクラス名

−

引数情報

1

0x8464

A

コールバック対象Beanのクラス名

−

引数情報

1

0x8466

A

コールバック対象Beanのクラス名

−

引数情報

2

0x8461

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

2

0x8463

A

コールバック対象Beanのクラス名

−

2

0x8465

A

コールバック対象Beanのクラス名

−

2

0x8467

A

コールバック対象Beanのクラス名

−

（凡例）A：標準　−：該当なし

注※　図8-25中の番号と対応しています。

(2)　cancelの場合

(a)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒38　Timer Serviceでのトレース取得ポイントの詳細（cancelの場合）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8468

1

javax.ejb.Timer.cancel()処理開始

A

0x8469

2

javax.ejb.Timer.cancel()処理終了

A

（凡例）A：標準

注※　図8-26中の番号と対応しています。

cancelの場合のTimer Serviceでのトレース取得ポイントを次の図に示します。

図8‒26　Timer Serviceのトレース取得ポイント（cancelの場合）

(b)　取得できるトレース情報

cancelの場合のTimer Serviceで取得できるトレース情報を次の表に示します。

表8‒39　Timer Serviceで取得できるトレース情報（cancelの場合）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8468

A

コールバック対象Beanのクラス名

−

−

2

0x8469

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　−：該当なし

注※　図8-26中の番号と対応しています。

(3)　コールバックの場合

(a)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒40　Timer Serviceでのトレース取得ポイントの詳細（コールバックの場合）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x846C

1

スレッドがコールバック処理開始

B

0x846A

2

Enterprise Beanのタイムアウトコールバックメソッドをコールバック開始

A

0x846B

3

Enterprise Beanのタイムアウトコールバックメソッドをコールバック終了

A

0x846D

4

スレッドがコールバック処理終了

B

（凡例）A：標準　B：詳細

注※　図8-27中の番号と対応しています。

コールバックの場合のTimer Serviceでのトレース取得ポイントを次の図に示します。

図8‒27　Timer Serviceのトレース取得ポイント（コールバックの場合）

(b)　取得できるトレース情報

コールバックの場合のTimer Serviceで取得できるトレース情報を次の表に示します。

なお，ルートアプリケーション情報には，タイムアウトメソッドのコールバック時に取得する情報が出力されます。また，クライアントアプリケーション情報には「0」が出力されます。

表8‒41　Timer Serviceで取得できるトレース情報（コールバックの場合）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x846C

B

コールバック対象Beanのクラス名

−

−

2

0x846A

A

コールバック対象Beanのクラス名

−

−

3

0x846B

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

4

0x846D

B

コールバック対象Beanのクラス名

−

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-27中の番号と対応しています。

(4)　createSingleActionTimerの場合

(a)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒42　Timer Serviceでのトレース取得ポイントの詳細（createSingleActionTimerの場合）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84A0

1

TimerService.createSingleActionTimer(long duration, TimerConfig timerConfig)処理開始

A

0x84A1

2

TimerService.createSingleActionTimer(long duration, TimerConfig timerConfig)処理終了

A

0x84A2

1

TimerService.createSingleActionTimer(Date expiration, TimerConfig timerConfig)処理開始

A

0x84A3

2

TimerService.createSingleActionTimer(Date expiration, TimerConfig timerConfig)処理終了

A

（凡例）A：標準

注※　図8-28中の番号と対応しています。

createSingleActionTimerでのトレース取得ポイントを次の図に示します。

図8‒28　Timer Serviceのトレース取得ポイント（createSingleActionTimerの場合）

(b)　取得できるトレース情報

createSingleActionTimerで取得できるトレース情報を次の表に示します。

表8‒43　Timer Serviceで取得できるトレース情報（createSingleActionTimerの場合）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84A0

A

コールバック対象Beanのクラス名

−

引数情報

2

0x84A1

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

1

0x84A2

A

コールバック対象Beanのクラス名

−

引数情報

2

0x84A3

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　−：該当なし

注※　図8-28中の番号と対応しています。

(5)　createIntervalTimerの場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒44　Timer Serviceのトレース取得ポイントの詳細（createIntervalTimerの場合）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84A4

1

TimerService.createIntervalTimer(long initialDuration, long intervalDuration, TimerConfig timerConfig)処理開始

A

0x84A5

2

TimerService.createIntervalTimer(long initialDuration, long intervalDuration, TimerConfig timerConfig)処理終了

A

0x84A6

1

TimerService.createIntervalTimer(Date initialExpiration, long intervalDuration, TimerConfig timerConfig)処理開始

A

0x84A7

2

TimerService.createIntervalTimer(Date initialExpiration, long intervalDuration, TimerConfig timerConfig)処理終了

A

（凡例）A：標準

注※　図8-29中の番号と対応しています。

createIntervalTimerのトレース取得ポイントを次の図に示します。

図8‒29　Timer Serviceのトレース取得ポイント（createIntervalTimerの場合）

(b)　取得できるトレース情報

createIntervalTimerで取得できるトレース情報を次の表に示します。

表8‒45　Timer Serviceで取得できるトレース情報（createIntervalTimerの場合）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84A4

A

コールバック対象Beanのクラス名

−

引数情報

2

0x84A5

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

1

0x84A6

A

コールバック対象Beanのクラス名

−

引数情報

2

0x84A7

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　−：該当なし

注※　図8-29中の番号と対応しています。

(6)　createCalendarTimerの場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒46　Timer Serviceのトレース取得ポイントの詳細（createCalendarTimerの場合）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84A8

1

TimerService.createCalendarTimer(ScheduleExpression schedule)処理開始

A

0x84A9

2

TimerService.createCalendarTimer(ScheduleExpression schedule)処理終了

A

0x84AA

1

TimerService.createCalendarTimer(ScheduleExpression schedule, TimerConfig config)処理開始

A

0x84AB

2

TimerService.createCalendarTimer(ScheduleExpression schedule, TimerConfig config)処理終了

A

（凡例）A：標準

注※　図8-30中の番号と対応しています。

createCalendarTimerのトレース取得ポイントを次の図に示します。

図8‒30　Timer Serviceのトレース取得ポイント（createCalendarTimerの場合）

(b)　取得できるトレース情報

createCalendarTimerで取得できるトレース情報を次の表に示します。

表8‒47　Timer Serviceで取得できるトレース情報（createCalendarTimerの場合）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84A8

A

コールバック対象Beanのクラス名

−

引数情報

2

0x84A9

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

1

0x84AA

A

コールバック対象Beanのクラス名

−

引数情報

2

0x84AB

A

コールバック対象Beanのクラス名

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　−：該当なし

注※　図8-30中の番号と対応しています。

8.9.5　Session Beanの非同期呼び出しの場合

Session Beanの非同期呼び出し時のトレース取得ポイントと，取得できるトレース情報について説明します。

非同期呼び出しでは，同じスレッドで出力されるイベントIDの出力順序は保証されますが，異なるスレッドで出力されるイベントIDの出力順序は保証されません。このため，次のことが発生する場合があります。

イベントIDの出力順序がここで説明する順序とは異なることがあります。

ほかの機能のイベントIDの間に，非同期呼び出しのイベントIDが出力されることがあります。

(1)　ローカルクライアントからSession Beanを非同期呼び出しする場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒48　ローカルクライアントからSession Beanを非同期呼び出しした場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8472

1

EJBコンテナがリクエストを受信した直後（ローカル呼び出しの場合）

A

0x8473

2

EJBコンテナがレスポンスを送信する直前（ローカル呼び出しの場合）

A

0x84C0

3

EJBコンテナがEJBの非同期のビジネスメソッドをコールバックする直前

A

0x84D6

4

EJBコンテナがEJBの非同期のビジネスメソッドを開始する直前（ローカル呼び出しの場合）

A

0x8409

5

EJBコンテナがEJBのビジネスメソッドをコールバックする直前

B

0x840A

6

EJBのビジネスメソッドのコールバックからリターンした直後

B

0x84D7

7

EJBの非同期のビジネスメソッドが終了した直後（ローカル呼び出しの場合）

A

0x84C1

8

EJBの非同期のビジネスメソッドのコールバックからリターンした直後

A

（凡例）A：標準　B：詳細

注※　図8-31中の番号と対応しています。

ローカルクライアントからSession Beanを非同期呼び出しした場合のトレース取得ポイントを次の図に示します。

図8‒31　ローカルクライアントからSession Beanを非同期呼び出しした場合のトレース取得ポイント

(b)　取得できるトレース情報

ローカルクライアントからSession Beanを非同期呼び出しした場合に取得できるトレース情報を次の表に示します。

表8‒49　ローカルクライアントからSession Beanを非同期呼び出しした場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8472

A

Bean名

メソッド名，引数の数

−

2

0x8473

A

Bean名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x84C0

A

コールバック対象Beanのクラス名

メソッド名，引数の数

非同期メソッド呼び出し元のルートアプリケーション情報

4

0x84D6

A

コールバック対象Beanのクラス名

メソッド名，引数の数

−

5

0x8409

B

Bean名

メソッド名，引数の数

−

6

0x840A

B

Bean名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

7

0x84D7

A

コールバック対象Beanのクラス名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

8

0x84C1

A

コールバック対象Beanのクラス名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-31中の番号と対応しています。

(2)　リモートクライアントからSession Beanを非同期呼び出しする場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒50　リモートクライアントからSession Beanを非同期呼び出しした場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8470

1

EJBコンテナがリクエストを受信した直後（リモート呼び出しの場合）

A

0x8471

2

EJBコンテナがレスポンスを送信する直前（リモート呼び出しの場合）

A

0x84C0

3

EJBコンテナがEJBの非同期のビジネスメソッドをコールバックする直前

A

0x84D8

4

EJBコンテナがEJBの非同期のビジネスメソッドを開始する直前（リモート呼び出しの場合）

A

0x8409

5

EJBコンテナがEJBのビジネスメソッドをコールバックする直前

B

0x840A

6

EJBのビジネスメソッドのコールバックからリターンした直後

B

0x84D9

7

EJBの非同期のビジネスメソッドが終了した直後（リモート呼び出しの場合）

A

0x84C1

8

EJBの非同期のビジネスメソッドのコールバックからリターンした直後

A

（凡例）A：標準　B：詳細

注※　図8-32中の番号と対応しています。

リモートクライアントからSession Beanを非同期呼び出しした場合のトレース取得ポイントを次の図に示します。

図8‒32　リモートクライアントからSession Beanを非同期呼び出しした場合のトレース取得ポイント

(b)　取得できるトレース情報

リモートクライアントからSession Beanを非同期呼び出しした場合に取得できるトレース情報を次の表に示します。

表8‒51　リモートクライアントからSession Beanを非同期呼び出しした場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8470

A

Bean名

メソッド名，引数の数

−

2

0x8471

A

Bean名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x84C0

A

コールバック対象Beanのクラス名

メソッド名，引数の数

非同期メソッド呼び出し元のルートアプリケーション情報

4

0x84D8

A

コールバック対象Beanのクラス名

メソッド名，引数の数

−

5

0x8409

B

Bean名

メソッド名，引数の数

−

6

0x840A

B

Bean名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

7

0x84D9

A

コールバック対象Beanのクラス名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

8

0x84C1

A

コールバック対象Beanのクラス名

メソッド名，引数の数

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-32中の番号と対応しています。

(3)　ローカルクライアントからgetを呼び出す場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒52　ローカルクライアントからgetを呼び出した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84C2

1

Future.get()処理開始（ローカル呼び出しの場合）

B

0x84C3

2

Future.get()処理終了（ローカル呼び出しの場合）

B

0x84C4

1

Future.get(long timeout, TimeUnit unit)処理開始（ローカル呼び出しの場合）

B

0x84C5

2

Future.get(long timeout, TimeUnit unit)処理終了（ローカル呼び出しの場合）

B

（凡例）B：詳細

注※　図8-33中の番号と対応しています。

ローカルクライアントからgetを呼び出した場合のトレース取得ポイントを次の図に示します。

図8‒33　ローカルクライアントからgetを呼び出した場合のトレース取得ポイント

(b)　取得できるトレース情報

ローカルクライアントからgetを呼び出した場合に取得できるトレース情報を次の表に示します。

表8‒53　ローカルクライアントからgetを呼び出した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84C2

B

−

−

−

2

0x84C3

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

1

0x84C4

B

−

−

メソッド名，引数情報

2

0x84C5

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）B：詳細　−：該当なし

注※　図8-33中の番号と対応しています。

(4)　リモートクライアントからgetを呼び出す場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒54　リモートクライアントからgetを呼び出した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84C6

1

Future.get()処理開始（リモート呼び出しの場合）

B

0x84C2

2

Future.get()処理開始（ローカル呼び出しの場合）

B

0x84C3

3

Future.get()処理終了（ローカル呼び出しの場合）

B

0x84C7

4

Future.get()処理終了（リモート呼び出しの場合）

B

0x84C8

1

Future.get(long timeout, TimeUnit unit)処理開始（リモート呼び出しの場合）

B

0x84C4

2

Future.get(long timeout, TimeUnit unit)処理開始（ローカル呼び出しの場合）

B

0x84C5

3

Future.get(long timeout, TimeUnit unit)処理終了（ローカル呼び出しの場合）

B

0x84C9

4

Future.get(long timeout, TimeUnit unit)処理終了（リモート呼び出しの場合）

B

（凡例）B：詳細

注※　図8-34中の番号と対応しています。

リモートクライアントからgetを呼び出した場合のトレース取得ポイントを次の図に示します。

図8‒34　リモートクライアントからgetを呼び出した場合のトレース取得ポイント

(b)　取得できるトレース情報

リモートクライアントからgetを呼び出した場合に取得できるトレース情報を次の表に示します。

表8‒55　リモートクライアントからgetを呼び出した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84C6

B

−

−

−

2

0x84C2

B

−

−

−

3

0x84C3

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

4

0x84C7

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

1

0x84C8

B

−

−

メソッド名，引数情報

2

0x84C4

B

−

−

メソッド名，引数情報

3

0x84C5

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

4

0x84C9

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）B：詳細　−：該当なし

注※　図8-34中の番号と対応しています。

(5)　ローカルクライアントからisDoneを呼び出す場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒56　ローカルクライアントからisDoneを呼び出した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84CA

1

Future.isDone()処理開始（ローカル呼び出しの場合）

B

0x84CB

2

Future.isDone()処理終了（ローカル呼び出しの場合）

B

（凡例）B：詳細

注※　図8-35中の番号と対応しています。

ローカルクライアントからisDoneを呼び出した場合のトレース取得ポイントを次の図に示します。

図8‒35　ローカルクライアントからisDoneを呼び出した場合のトレース取得ポイント

(b)　取得できるトレース情報

ローカルクライアントからisDoneを呼び出した場合に取得できるトレース情報を次の表に示します。

表8‒57　ローカルクライアントからisDoneを呼び出した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84CA

B

−

−

−

2

0x84CB

B

−

−

isDone()の戻り値

（凡例）B：詳細　−：該当なし

注※　図8-35中の番号と対応しています。

注

このメソッドの実行では，例外は発生しません。したがって，異常な状態を示すログは生成されません。

(6)　リモートクライアントからisDoneを呼び出す場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒58　リモートクライアントからisDoneを呼び出した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84CE

1

Future.isDone()処理開始（リモート呼び出しの場合）

B

0x84CA

2

Future.isDone()処理開始（ローカル呼び出しの場合）

B

0x84CB

3

Future.isDone()処理終了（ローカル呼び出しの場合）

B

0x84CF

4

Future.isDone()処理終了（リモート呼び出しの場合）

B

（凡例）B：詳細

注※　図8-36中の番号と対応しています。

リモートクライアントからisDoneを呼び出した場合のトレース取得ポイントを次の図に示します。

図8‒36　リモートクライアントからisDoneを呼び出した場合のトレース取得ポイント

(b)　取得できるトレース情報

リモートクライアントからisDoneを呼び出した場合に取得できるトレース情報を次の表に示します。

表8‒59　リモートクライアントからisDoneを呼び出した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84CE

B

−

−

−

2

0x84CA

B

−

−

−

3

0x84CB

B

−

−

isDone()の戻り値

4

0x84CF

B

−

−

正常時

<入り口時刻>

例外発生時

<例外名>

（凡例）B：詳細　−：該当なし

注※　図8-36中の番号と対応しています。

(7)　ローカルクライアントからisCancelledを呼び出す場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒60　ローカルクライアントからisCancelledを呼び出した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84CC

1

Future.isCancelled()処理開始（ローカル呼び出しの場合）

B

0x84CD

2

Future.isCancelled()処理終了（ローカル呼び出しの場合）

B

（凡例）B：詳細

注※　図8-37中の番号と対応しています。

ローカルクライアントからisCancelledを呼び出した場合のトレース取得ポイントを次の図に示します。

図8‒37　ローカルクライアントからisCancelledを呼び出した場合のトレース取得ポイント

(b)　取得できるトレース情報

ローカルクライアントからisCancelledを呼び出した場合に取得できるトレース情報を次の表に示します。

表8‒61　ローカルクライアントからisCancelledを呼び出した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84CC

B

−

−

−

2

0x84CD

B

−

−

isCancelled()の戻り値

（凡例）B：詳細　−：該当なし

注※　図8-37中の番号と対応しています。

注

このメソッドの実行では，例外は発生しません。したがって，異常な状態を示すログは生成されません。

(8)　リモートクライアントからisCancelledを呼び出す場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒62　リモートクライアントからisCancelledを呼び出した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84D0

1

Future.isCancelled()処理開始（リモート呼び出しの場合）

B

0x84CC

2

Future.isCancelled()処理開始（ローカル呼び出しの場合）

B

0x84CD

3

Future.isCancelled()処理終了（ローカル呼び出しの場合）

B

0x84D1

4

Future.isCancelled()処理終了（リモート呼び出しの場合）

B

（凡例）B：詳細

注※　図8-38中の番号と対応しています。

リモートクライアントからisCancelledを呼び出した場合のトレース取得ポイントを次の図に示します。

図8‒38　リモートクライアントからisCancelledを呼び出した場合のトレース取得ポイント

(b)　取得できるトレース情報

リモートクライアントからisCancelledを呼び出した場合に取得できるトレース情報を次の表に示します。

表8‒63　リモートクライアントからisCancelledを呼び出した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84D0

B

−

−

−

2

0x84CC

B

−

−

−

3

0x84CD

B

−

−

isCancelled()の戻り値

4

0x84D1

B

−

−

正常時

isCancelled()の戻り値

例外発生時

<例外名>

（凡例）B：詳細　−：該当なし

注※　図8-38中の番号と対応しています。

(9)　ローカルクライアントからcancelを呼び出す場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒64　ローカルクライアントからcancelを呼び出した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84D2

1

Future.cancel()処理開始（ローカル呼び出しの場合）

A

0x84D3

2

Future.cancel()処理終了（ローカル呼び出しの場合）

A

（凡例）A：標準

注※　図8-39中の番号と対応しています。

ローカルクライアントからcancelを呼び出した場合のトレース取得ポイントを次の図に示します。

図8‒39　ローカルクライアントからcancelを呼び出した場合のトレース取得ポイント

(b)　取得できるトレース情報

ローカルクライアントからcancelを呼び出した場合に取得できるトレース情報を次の表に示します。

表8‒65　ローカルクライアントからcancelを呼び出した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84D2

A

−

−

メソッド名，引数情報

2

0x84D3

A

−

−

cancel()の戻り値

（凡例）A：標準　−：該当なし

注※　図8-39中の番号と対応しています。

注

このメソッドの実行では，例外は発生しません。したがって，異常な状態を示すログは生成されません。

(10)　リモートクライアントからcancelを呼び出す場合

(a)　トレース取得ポイントとPRFトレース

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒66　リモートクライアントからcancelを呼び出した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x84D4

1

Future.cancel()処理開始（リモート呼び出しの場合）

A

0x84D2

2

Future.cancel()処理開始（ローカル呼び出しの場合）

A

0x84D3

3

Future.cancel()処理終了（ローカル呼び出しの場合）

A

0x84D5

4

Future.cancel()処理終了（リモート呼び出しの場合）

A

（凡例）A：標準

注※　図8-40中の番号と対応しています。

リモートクライアントからcancelを呼び出した場合のトレース取得ポイントを次の図に示します。

図8‒40　リモートクライアントからcancelを呼び出した場合のトレース取得ポイント

(b)　取得できるトレース情報

リモートクライアントからcancelを呼び出した場合に取得できるトレース情報を次の表に示します。

表8‒67　リモートクライアントからcancelを呼び出した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x84D4

A

−

−

メソッド名，引数情報

2

0x84D2

A

−

−

メソッド名，引数情報

3

0x84D3

A

−

−

cancel()の戻り値

4

0x84D5

A

−

−

正常時

cancel()の戻り値

例外発生時

<例外名>

（凡例）A：標準　−：該当なし

注※　図8-40中の番号と対応しています。

8.9.6　メソッドキャンセルが発生した場合

メソッドキャンセルが発生した場合のトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒68　メソッドキャンセルが発生した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8490

1

メソッドキャンセル処理開始

A

0x8C41

2

障害調査用SQL出力

A

0x8491

3

メソッドキャンセル処理完了

A

（凡例）A：標準

注※　図8-41中の番号と対応しています。

メソッドキャンセルが発生した場合のトレース取得ポイントを次の図に示します。

図8‒41　メソッドキャンセルが発生した場合のトレース取得ポイント

(2)　取得できるトレース情報

メソッドキャンセルが発生した場合に取得できるトレース情報を次の表に示します。

表8‒69　メソッドキャンセルが発生した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8490

A

メソッドキャンセル対象のアプリケーションのルートアプリケーション情報

−

−

2

0x8C41

A

トランザクションタイムアウト，J2EEアプリケーション強制停止，またはメソッドキャンセルされたコネクションのルートアプリケーション情報

−

SQL文

3

0x8491

A

−

−

<入り口時刻>

（凡例）A：標準　−：該当なし

注※　図8-41中の番号と対応しています。

8.10　JNDIのトレース取得ポイント

ここでは，JNDIのトレース取得ポイントと，取得できるトレース情報について説明します。

8.10.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒70　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：詳細

注※　図8-42中の番号と対応しています。

JNDIでのトレース取得ポイントを次の図に示します。

図8‒42　JNDIのトレース取得ポイント

8.10.2　取得できるトレース情報

JNDIで取得できるトレース情報を次の表に示します。

表8‒71　JNDIで取得できるトレース情報

図中の番号※

イベント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

−

正常時

<入り口時刻>

例外発生時

<入り口時刻:例外名>

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：詳細　−：該当なし

注※　図8-42中の番号と対応しています。

参考

JNDIでのトレース情報では，次に示す場合，キー情報である「ルートアプリケーション情報」および「クライアントアプリケーション情報」には，0が表示されます。

・クライアントからのlookupメソッドを呼び出す場合

・サーバが開始処理中または停止処理中の場合

ビジネスインタフェース利用時には，0x8609と0x860Aが2回ずつ出力されます。

8.11　JTAのトレース取得ポイント

ここでは，JTAのトレース取得ポイントと，取得できるトレース情報について説明します。

8.11.1　CMTおよびTransactionManagerを使用する場合

CMTおよびjavax.transaction.TransactionManagerを使用する場合のトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒72　CMTおよびTransactionManagerを使用する場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8811

1

トランザクション開始処理直前

A

0x8812

2

トランザクション開始処理直後

A

0x8815

3

トランザクションコミット処理直前

A

0x8816

4

トランザクションコミット処理直後

A

0x8817

3

トランザクションロールバック処理直前

A

0x8818

4

トランザクションロールバック処理直後

A

（凡例）A：標準

注※　図8-43および図8-44中の番号と対応しています。

CMTを使用する場合のトレース取得ポイントを，次の図に示します。

図8‒43　CMTを使用する場合のトレース取得ポイント

TransactionManagerを使用する場合のトレース取得ポイントを，次の図に示します。

図8‒44　TransactionManagerを使用する場合のトレース取得ポイント

(2)　取得できるトレース情報

CMTおよびTransactionManagerを使用する場合に取得できるトレース情報を次の表に示します。

表8‒73　CMTおよびTransactionManagerを使用する場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8811

A

−

−

−

2

0x8812

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8815

A

−

−

−

0x8817

A

−

−

−

4

0x8816

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

0x8818

A

−

−

（凡例）A：標準　−：該当なし

注※　図8-43および図8-44中の番号と対応しています。

8.11.2　UserTransactionを使用する場合

UserTransactionを使用する場合のトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒74　UserTransactionを使用する場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8813

1

トランザクション開始処理直前

A

0x8814

2

トランザクション開始処理直後

A

0x8815

3

トランザクションコミット処理直前

A

0x8816

4

トランザクションコミット処理直後

A

0x8817

3

トランザクションロールバック処理直前

A

0x8818

4

トランザクションロールバック処理直後

A

（凡例）A：標準

注※　図8-45中の番号と対応しています。

UserTransactionを使用する場合のトレース取得ポイントを，次の図に示します。

図8‒45　UserTransactionを使用する場合のトレース取得ポイント

(2)　取得できるトレース情報

UserTransactionを使用する場合に取得できるトレース情報を次の表に示します。

表8‒75　UserTransactionを使用する場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8813

A

−

−

−

2

0x8814

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8815

A

−

−

−

0x8817

A

−

−

−

4

0x8816

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

0x8818

A

−

−

（凡例）A：標準　−：該当なし

注※　図8-45中の番号と対応しています。

8.11.3　トランザクションタイムアウトの場合

トランザクションタイムアウトの場合のトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒76　トランザクションタイムアウトでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8819

1

トランザクションタイムアウト処理直前

A

0x8C41

2

障害調査用SQL出力

A

0x8820

3

トランザクションタイムアウト処理直後

A

（凡例）A：標準

注※　図8-46中の番号と対応しています。

トランザクションタイムアウトのトレース取得ポイントを，次の図に示します。

図8‒46　トランザクションタイムアウトのトレース取得ポイント

(2)　取得できるトレース情報

トランザクションタイムアウトで取得できるトレース情報を次の表に示します。

表8‒77　トランザクションタイムアウトで取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8819

A

タイムアウトしたトランザクションのルートアプリケーション情報

−

−

2

0x8C41

A

トランザクションタイムアウト，J2EEアプリケーション強制停止，またはメソッドキャンセルされたコネクションのルートアプリケーション情報

−

SQL文

3

0x8820

A

−

−

<入り口時刻>

（凡例）A：標準　−：該当なし

注※　図8-46中の番号と対応しています。

8.11.4　スレッドの非同期並行処理を使用する場合

スレッドの非同期並行処理を使用する場合のトレース取得ポイントと，取得できるトレース情報について説明します。

(1)　TimerManagerのトレース取得ポイント

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

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒78　TimerManagerのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8435

1

TimerManagerの開始直前

A

0x8436

2

TimerManagerの開始直後

A

0x8439

5

TimerManagerの停止直前

A

0x843A

6

TimerManagerの停止直後

A

0x843D

3

TimerManagerのリスナ実行の直前

A

0x843E

4

TimerManagerのリスナ実行の直後

A

（凡例）A：標準

注※　図8-47中の番号と対応しています。

TimerManagerのトレース取得ポイントを次の図に示します。

図8‒47　TimerManagerのトレース取得ポイント

取得できるトレース情報

TimerManagerで取得できるトレース情報を次の表に示します。

表8‒79　TimerManagerで取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8435

A

−

−

−

2

0x8436

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x843D

A

メソッド名※2

スケジュールごとに一意の番号

−

4

0x843E

A

メソッド名※2

スケジュールごとに一意の番号

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

5

0x8439

A

−

−

−

6

0x843A

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　−：該当なし

注※1　図8-47中の番号と対応しています。

注※2　TimerManager.timerExpired，StopTimerListener.timerStop，またはCancelTimerListener.timerCancelが出力されます。

(2)　WorkManagerのトレース取得ポイント

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

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒80　WorkManagerのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8437

1

WorkManagerの開始直前

A

0x8438

2

WorkManagerの開始直後

A

0x8440

4

WorkManagerのリスナ，またはタスク処理の実行直後

A

0x843B

5

WorkManagerの停止直前

A

0x843C

6

WorkManagerの停止直後

A

0x843F

3

WorkManagerのリスナ，またはタスク処理の実行直前

A

（凡例）A：標準

注※　図8-48中の番号と対応しています。

WorkManagerのトレース取得ポイントを次の図に示します。

図8‒48　WorkManagerのトレース取得ポイント

取得できるトレース情報

WorkManagerで取得できるトレース情報を次の表に示します。

表8‒81　WorkManagerで取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8437

A

−

−

−

2

0x8438

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x843F

A

メソッド名※2

スケジュールごとに一意の番号

−

4

0x8440

A

メソッド名※2

スケジュールごとに一意の番号

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

5

0x843B

A

−

−

−

6

0x843C

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　−：該当なし

注※1　図8-48中の番号と対応しています。

注※2　Work.run，WorkListener.workAccepted，WorkListener.workRejected，WorkListener.workStarted，またはWorkListener.workCompletedが出力されます。

8.12　DB Connector，JCAコンテナのトレース取得ポイント

ここでは，DB ConnectorおよびJCAコンテナのトレース取得ポイントと，取得できるトレース情報について説明します。

コネクション関連のトレース取得ポイントには，ローカルトランザクションを使用する場合だけ取得できるものがあります。ここでは，トランザクションサポートレベルに関係なく取得できるトレース取得ポイントと，ローカルトランザクションを使用する場合だけ取得できるトレース取得ポイントの二つに分けて説明します。なお，ここでは，トランザクションサポートレベルに関係なく取得できるトレース取得ポイントを，「コネクション関連のトレース取得ポイント」と呼びます。

8.12.1　コネクション関連のトレース取得ポイントと取得できるトレース情報

コネクション関連のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，イベントIDごとに，次の四つの表に示します。

0x8B00，0x8B01，0x8B80〜0x8B83，0x8C00〜0x8C03，0x8C10〜0xC13，0x8C20〜0x8C29，0x8C2A〜0x8C3Fの場合（コネクション関連の処理実行時）

参照先：表8-82

0x8C80〜0x8C93の場合（java.sql.Statementインタフェースのメソッド実行時）

参照先：表8-83

0x8CC0〜0x8CD9の場合（java.sql.PreparedStatementインタフェースのメソッド実行時）

参照先：表8-84

0x8D00〜0x8D19の場合（java.sql.CallableStatementインタフェースのメソッド実行時）

参照先：表8-85

ポイント

イベントID「0x8C41」については，「8.9　EJBコンテナのトレース取得ポイント」，および「8.11　JTAのトレース取得ポイント」を参照してください。

表8‒82　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：詳細

注　SQL Server 2005を使用している場合，DB ConnectorのイベントIDは出力されません。

注※　図8-49中の番号と対応しています。

表8‒83　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：詳細

注※　図8-49中の番号と対応しています。

表8‒84　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：詳細

注※　図8-49中の番号と対応しています。

表8‒85　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：詳細

注※　図8-49と対応しています。

DB Connector，JCAコンテナでのトレース取得ポイントを次の図に示します。

図8‒49　DB Connector，JCAコンテナのトレース取得ポイント（コネクション関連）

(2)　取得できるトレース情報

DB Connector，JCAコンテナで取得できるトレース情報について，次に示します。ここでは，図8-49の番号と対応づけて説明しています。

番号1〜6・11〜16に対応するトレース情報

番号1〜6・11〜16に対応するイベントIDとトレース情報を，次の表に示します。

表8‒86　DB Connector，JCAコンテナで取得できるトレース情報（コネクション関連の処理実行時）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8C00

A

−

−

−

0x8C02

A

−

−

−

0x8C10

A

−

−

−

0x8C12

A

−

−

−

2

0x8B00

B

−

−

−

3

0x8B80

B

−

−

−

4

0x8B81

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

5

0x8B01

B

−

−

6

0x8C01

A

コネクションID

−

0x8C03

A

コネクションID

−

0x8C11

A

コネクションID

−

0x8C13

A

コネクションID

−

11

0x8C22

B

−

−

−

0x8C24

B

−

−

−

0x8C26

B

−

−

−

12

0x8C23

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

0x8C25

B

−

−

0x8C27

B

−

−

13

0x8C20

A

コネクションID

−

−

14

0x8B82

B

−

−

−

15

0x8B83

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

16

0x8C21

A

−

−

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-49中の番号と対応しています。

番号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では，正常に処理された場合は入り口時刻が表示されます。例外が発生した場合は入り口時刻および例外が表示されます。

8.12.2　ローカルトランザクションを使用する場合のトレース取得ポイントと取得できるトレース情報

ローカルトランザクションを使用する場合のトレース取得ポイントと取得できるトレース情報トレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒87　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ローカルトランザクションの処理実行時）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8C60

1

ローカルトランザクションの開始

処理開始

B

0x8C61

2

処理終了

B

0x8C62

3

ローカルトランザクションのコミット

処理開始

B

0x8C63

4

処理終了

B

0x8C64

3

ローカルトランザクションのロールバック

処理開始

B

0x8C65

4

処理終了

B

（凡例）B：詳細

注※　図8-50と対応しています。

トレース取得ポイントを次の図に示します。

図8‒50　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ローカルトランザクション関連）

(2)　取得できるトレース情報

取得できるトレース情報を次の表に示します。

表8‒88　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ローカルトランザクションの処理実行時）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8C60

B

−

−

−

2

0x8C61

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8C62

B

−

−

−

0x8C64

B

−

−

−

4

0x8C63

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

0x8C65

B

−

−

（凡例）B：詳細　−：該当なし

注※　図8-50中の番号と対応しています。

8.12.3　コネクションアソシエーションを使用する場合のトレース取得ポイントと取得できるトレース情報

コネクションアソシエーションを使用する場合のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒89　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクションアソシエーションの処理実行時）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8C40

1

コネクションアソシエーション機能によって，論理コネクションに対する物理コネクションが差し替えられた時

A

（凡例）A：標準

注※　図8-51の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒51　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクションアソシエーション関連）

(2)　取得できるトレース情報

取得できるトレース情報を次の表に示します。

表8‒90　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクションアソシエーション処理実行時）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8C40

A

コネクションID（コネクションアソシエーション機能によって差し替えられた先の物理コネクションのコネクションID）

−

−

（凡例）A：標準　−：該当なし

注※　図8-51中の番号と対応しています。

8.12.4　コネクション自動クローズ機能を使用する場合のトレース取得ポイントと取得できるトレース情報

コネクション自動クローズ時のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒91　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクション自動クローズ時）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8B84

1

コネクション自動クローズ機能によるクローズ処理呼び出し直後

B

0x8B82

2

物理コネクション破棄の呼び出し直前

B

0x8B83

3

物理コネクション破棄のリターン直後

B

0x8B85

4

コネクション自動クローズ機能によるクローズ処理リターン直前

B

（凡例）B：詳細

注※　図8-52の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒52　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクション自動クローズ時）

(2)　取得できるトレース情報

取得できるトレース情報を次の表に示します。

表8‒92　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（コネクション自動クローズ時）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8B84

B

コネクションID

−

−

2

0x8B82

B

−

−

−

3

0x8B83

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

4

0x8B85

B

−

−

<入り口時刻>

（凡例）B：詳細　−：該当なし

注※　図8-52中の番号と対応しています。

8.12.5　DB Connector for Reliable Messagingと連携する場合のトレース取得ポイントと取得できるトレース情報

DB Connector for Reliable Messagingと連携する場合のトレース取得ポイントと取得できるトレース情報について説明します。

なお，DB Connector for Reliable Messagingでは，DB Connectorを使用してデータベースに接続しています。そのためDB Connector for Reliable Messaging利用時にはDB Connectorのトレースポイントも取得します。JDBCコネクションの生成物（java.sql.Statementなど）は，DB Connectorと同じトレース取得ポイントになります。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒93　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（DB Connector for Reliable Messaging連携時）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8D60

1

DB Connector for Reliable Messaging利用時のjavax.sql.DataSource.getConnection()でのデータベース接続の確立

処理開始

A

0x8D61

2

処理終了

A

0x8D62

1

DB Connector for Reliable Messaging利用時のjavax.sql.DataSource.getConnection(String username, String password)での，データベース接続の確立

処理開始

A

0x8D63

2

処理終了

A

0x8D80

5

DB Connector for Reliable Messaging利用時のjava.sql.Connection.close()での，ConnectionオブジェクトのデータベースとJDBCリソースの解除

処理開始

A

0x8D81

6

処理終了

A

0x8D82

3

DB Connector for Reliable Messaging利用時のConnection.createStatement()

処理開始

B

0x8D83

4

処理終了

B

0x8D84

3

DB Connector for Reliable Messaging利用時のConnection.createStatement(int resultSetType, int resultSetConcurrency)

処理開始

B

0x8D85

4

処理終了

B

0x8D86

3

DB Connector for Reliable Messaging利用時のConnection.createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability)

処理開始

B

0x8D87

4

処理終了

B

0x8D88

3

DB Connector for Reliable Messaging利用時のConnection.prepareCall(String sql)

処理開始

B

0x8D89

4

処理終了

B

0x8D8A

3

DB Connector for Reliable Messaging利用時の(String sql, int resultSetType, int resultSetConcurrency)

処理開始

B

0x8D8B

4

処理終了

B

0x8D8C

3

DB Connector for Reliable Messaging利用時のConnection.prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)

処理開始

B

0x8D8D

4

処理終了

B

0x8D8E

3

DB Connector for Reliable Messaging利用時のConnection.prepareStatement(String sql)

処理開始

B

0x8D8F

4

処理終了

B

0x8D90

3

DB Connector for Reliable Messaging利用時のConnection.prepareStatement(String sql, int autoGeneratedKeys)

処理開始

B

0x8D91

4

処理終了

B

0x8D92

3

DB Connector for Reliable Messaging利用時のConnection.prepareStatement(String sql, int[] columnIndexes)

処理開始

B

0x8D93

4

処理終了

B

0x8D94

3

DB Connector for Reliable Messaging利用時のConnection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency)

処理開始

B

0x8D95

4

処理終了

B

0x8D96

3

DB Connector for Reliable Messaging利用時のConnection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)

処理開始

B

0x8D97

4

処理終了

B

0x8D98

3

DB Connector for Reliable Messaging利用時のConnection.prepareStatement(String sql, String[] columnNames)

処理開始

B

0x8D99

4

処理終了

B

（凡例）A：標準　B：詳細

注※　図8-53の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒53　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（DB Connector for Reliable Messaging連携時）

(2)　取得できるトレース情報

取得できるトレース情報を次の表に示します。

表8‒94　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（DB Connector for Reliable Messaging連携時）

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8D60

A

−

−

−

2

0x8D61

A

コネクションID

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

1

0x8D62

A

−

−

−

2

0x8D63

A

コネクションID

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

5

0x8D80

A

コネクションID

−

−

6

0x8D81

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D82

B

−

−

−

4

0x8D83

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D84

B

−

−

−

4

0x8D85

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D86

B

−

−

−

4

0x8D87

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D88

B

−

−

SQL文

4

0x8D89

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D8A

B

−

−

SQL文

4

0x8D8B

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D8C

B

−

−

SQL文

4

0x8D8D

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D8E

B

−

−

SQL文

4

0x8D8F

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D90

B

−

−

SQL文

4

0x8D91

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D92

B

−

−

SQL文

4

0x8D93

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D94

B

−

−

SQL文

4

0x8D95

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D96

B

−

−

SQL文

4

0x8D97

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

3

0x8D98

B

−

−

SQL文

4

0x8D99

B

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-53中の番号と対応しています。

8.12.6　ワーク管理を使用する場合のトレース取得ポイントと取得できるトレース情報

Connector1.5に準拠したリソースアダプタでワーク管理を使用する場合のトレース取得ポイントと取得できるトレース情報について説明します。

なお，製品のリソースアダプタ以外を使用している場合，0x8B86を出力するときにルートAP情報が新規に採番されます。DD（ra.xml）の<resourceadapter>-<resourceadapter-class>の値が"com.hitachi"または"com.cosminexus"で始まっている場合，製品のリソースアダプタであると判断されます。

WorkからMessage-driven Beanを呼び出した場合，MDBコンテナの入り口で設定されるルートAP情報は，WorkのルートAP情報となります。個々のMessage-driven Beanの処理は，スレッドIDで区別されます。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒95　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ワーク管理を使用する場合）

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8B86

1

javax.resource.spi.work.WorkManagerのメソッドの呼び出し直後

A

0x8B87

6，9，14

javax.resource.spi.work.WorkManagerのメソッドのリターン直前

A

0x8B88

2，4，7，12

javax.resource.spi.work.WorkListenerのメソッドの呼び出し直前

B

0x8B89

3，5，8，13

javax.resource.spi.work.WorkListenerのメソッドのリターン直後

B

0x8B8A

10

javax.resource.spi.work.Workのメソッド呼び出し直前

A

0x8B8B

11

javax.resource.spi.work.Workのメソッドのリターン直後

A

（凡例）A：標準　B：詳細

注※　図8-54〜図8-56中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒54　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（scheduleWork()呼び出し時）

図8‒55　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（startWork()呼び出し時）

図8‒56　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（doWork()呼び出し時）

(2)　取得できるトレース情報

取得できるトレース情報を次の表に示します。

表8‒96　DB Connector，JCAコンテナでのトレース取得ポイントの詳細（ワーク管理を使用する場合）

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8B86

A

Workのクラス名

メソッド名

リソースアダプタの表示名

2

0x8B88

B

Workのクラス名

メソッド名

リソースアダプタの表示名※2

3

0x8B89

B

Workのクラス名

メソッド名

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

4

0x8B88

B

Workのクラス名

メソッド名

リソースアダプタの表示名※2

5

0x8B89

B

Workのクラス名

メソッド名

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

6

0x8B87

A

Workのクラス名

メソッド名

7

0x8B88

B

Workのクラス名

メソッド名

リソースアダプタの表示名※2

8

0x8B89

B

Workのクラス名

メソッド名

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

9

0x8B87

A

Workのクラス名

メソッド名

10

0x8B8A

A

Workのクラス名

メソッド名

リソースアダプタの表示名※2

11

0x8B8B

A

Workのクラス名

メソッド名

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

12

0x8B88

B

Workのクラス名

メソッド名

リソースアダプタの表示名※2

13

0x8B89

B

Workのクラス名

メソッド名

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

14

0x8B87

A

Workのクラス名

メソッド名

（凡例）A：標準　B：詳細

注※1　図8-54〜図8-56中の番号と対応しています。

注※2　アプリケーションに含まれているリソースアダプタの場合，「アプリケーション名:リソースアダプタの表示名」と表示されます。

8.13　RMIのトレース取得ポイント

ここでは，RMIのトレース取得ポイントと，取得できるトレース情報について説明します。

8.13.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒97　RMIでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x8E01

1

スタブでのリクエスト送信処理の始まり

A

0x8E02

6

スタブでのレスポンス受信処理の終わり

A

0x8E03

2

クライアント側のリクエスト送信処理

A

0x8E04

5

クライアント側のレスポンス受信処理

A

0x8E05

3

サーバ側のリクエスト受信処理

A

0x8E06

4

サーバ側のレスポンス送信処理

A

（凡例）A：標準

注※　図8-57中の番号と対応しています。

RMIでのトレース取得ポイントを次の図に示します。

図8‒57　RMIのトレース取得ポイント

8.13.2　取得できるトレース情報

RMIで取得できるトレース情報を次の表に示します。

表8‒98　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　図8-57中の番号と対応しています。

注※2　例外が発生した場合，インタフェース名およびオペレーション名は表示されません。また，オプションには発生した例外が表示されます。

8.14　OTSのトレース取得ポイント

ここでは，OTSのトレース取得ポイントと，取得できるトレース情報について説明します。

8.14.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒99　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：詳細

注※　図8-58〜図8-63中の番号と対応しています。

OTSでのトレース取得ポイントを次の図に示します。

図8‒58　トランザクション生成から決着までのトレース取得ポイント

図8‒59　インプロセスOTS初期化時のステータスファイルへの読み込み・書き込みに関連するトレース取得ポイント

図8‒60　javax.transaction.xa.Xidの回復処理でのトレース取得ポイント

図8‒61　典型的な1フェーズコミットモデルでのトレース取得ポイント

図8‒62　典型的な2フェーズコミットモデルでのトレース取得ポイント

図8‒63　OpenTP1とトランザクション連携した場合のPRF取得情報

8.14.2　取得できるトレース情報

OTSで取得できるトレース情報を次の表に示します。なお，次の表の中で，一つの項目に複数の情報が個条書きで記載してある場合は，そのどれかが出力されることを意味します。

表8‒100　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　図8-58〜図8-63中の番号と対応しています。

注※2　遷移した理由として，次のどれかが出力されます。

operation：インプロセスOTS外部から指示されました。

server call：別ノードにあるサーバへの呼び出しに失敗しました。

superior：別ノードからトランザクション処理への参加指示を受けましたが，すでにそのトランザクションがMarkedRollback状態でした。

sync before：決着処理中のJTAへのコールバック処理に失敗しました。

注※3　遷移した理由として，次のどれかが出力されます。

operation：インプロセスOTS外部から指示されました。

timeout：グローバルトランザクションタイムアウトが発生しました。

superior：スペリアトランザクション，またはcjrollbacktrnコマンドから指示されました。

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

8.15　標準出力／標準エラー出力／ユーザログのトレース取得ポイント

ここでは，標準出力／標準エラー出力／ユーザログのトレース取得ポイントと，取得できるトレース情報について説明します。

8.15.1　標準出力／標準エラー出力のトレース取得ポイント

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒101　標準出力／標準エラー出力でのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x9C00

1

標準出力/標準エラー出力への出力開始時

B

0x9C01

2

標準出力/標準エラー出力への出力完了時

B

（凡例）B：詳細

注※　図8-64中の番号と対応しています。

標準出力／標準エラー出力のトレース取得ポイントを次の図に示します。

図8‒64　標準出力／標準エラー出力のトレース取得ポイント

(2)　取得できるトレース情報

標準出力／標準エラー出力で取得できるトレース情報を次の表に示します。

表8‒102　標準出力／標準エラー出力で取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x9C00

B

ストリーム名（「out」／「err」）

−

−

2

0x9C01

B

ストリーム名（「out」／「err」）

−

−

（凡例）B：詳細　−：該当なし

注※　図8-64中の番号と対応しています。

8.15.2　ユーザログのトレース取得ポイント

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒103　ユーザログのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x9C02

1

ユーザログを使用したメッセージ出力開始時

B

0x9C03

2

ユーザログを使用したメッセージ出力完了時

B

（凡例）B：詳細

注※　図8-65中の番号と対応しています。

ユーザログのトレース取得ポイントを次の図に示します。

図8‒65　ユーザログのトレース取得ポイント

(2)　取得できるトレース情報

ユーザログで取得できるトレース情報を次の表に示します。

表8‒104　ユーザログで取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x9C02

B

アプリケーション識別名

メッセージID

−

2

0x9C03

B

アプリケーション識別名

メッセージID

−

（凡例）B：詳細　−：該当なし

注※　図8-65中の番号と対応しています。

8.16　DIのトレース取得ポイント

ここでは，DIのトレース取得ポイントと，取得できるトレース情報について説明します。

8.16.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒105　DIでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x9D00

1

依存性を注入する直前

A

0x9D01

2

依存性を注入した直後

A

（凡例）A：標準

注※　図8-66中の番号と対応しています。

DIのトレース取得ポイントを次の図に示します。

図8‒66　DIのトレース取得ポイント

8.16.2　取得できるトレース情報

DIで取得できるトレース情報を次の表に示します。

表8‒106　DIで取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x9D00

A

依存性を注入する先のターゲット名

注入するリファレンス名

−

2

0x9D01

A

依存性を注入した先のターゲット名

注入したリファレンス名

※2

（凡例）A：標準　−：該当なし

注※1　図8-66中の番号と対応しています。

注※2　正常に処理された場合，入り口時刻が表示されます。例外が発生した場合，入り口時刻および例外が表示されます。

8.17　バッチアプリケーション実行機能のトレース取得ポイント

ここでは，バッチアプリケーション実行機能のトレース取得ポイントと，取得できるトレース情報について説明します。

8.17.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒107　バッチアプリケーション実行機能でのトレース取得ポイントの詳細

イベントID

図中の番号※1

トレース取得ポイント

レベル

0x8E05

1※2

バッチアプリケーションの実行リクエストを受信した直後

A

0xA100

2

バッチアプリケーションの実行直前

A

0xA101

3

バッチアプリケーションの終了直後

A

0x8E06

4※2

バッチアプリケーションの終了結果を送信する直前

A

（凡例）A：標準

注※1　図8-67中の番号と対応しています。

注※2　トレースが取得されるのはスケジューリング機能使用時だけです。

バッチアプリケーション実行機能のトレース取得ポイントを次の図に示します。

図8‒67　バッチアプリケーション実行機能のトレース取得ポイント

8.17.2　取得できるトレース情報

バッチアプリケーション実行機能で取得できるトレース情報を次の表に示します。

表8‒108　バッチアプリケーション実行機能で取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0x8E05

A

−

−

−

2

0xA100

A

バッチアプリケーションのクラス名（パッケージ名を含む）

−

−

3

0xA101

A

バッチアプリケーションのクラス名（パッケージ名を含む）

−

※2

4

0x8E06

A

−

−

−

（凡例）A：標準　−：該当なし

注※1　図8-67中の番号と対応しています。

注※2　正常に処理された場合，入り口時刻が表示されます。例外が発生した場合，入り口時刻および例外が表示されます。

8.18　JPAでのトレース取得ポイント

ここでは，JPAのトレース取得ポイントと，取得できるトレース情報について説明します。

8.18.1　アプリケーション管理の永続化コンテキストを利用した場合のトレース取得ポイントと取得できるトレース情報

アプリケーション管理の永続化コンテキストを利用した場合のトレース取得ポイントと取得できるトレース情報について説明します。

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒109　アプリケーション管理の永続化コンテキストを利用した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xD100

1

EntityManagerFactory#createEntityManager()の処理開始

A

0xD101

2

EntityManagerFactory#createEntityManager()の処理終了

A

0xD102

1

EntityManagerFactory#createEntityManager(Map map)の処理開始

A

0xD103

2

EntityManagerFactory#createEntityManager(Map map)の処理終了

A

0xD104

1

EntityManagerFactory#createEntityManager(SynchronizationType type)の処理開始

A

0xD105

2

EntityManagerFactory#createEntityManager(SynchronizationType type)の処理終了

A

0xD106

1

EntityManagerFactory#createEntityManager(SynchronizationType type, Map map)の処理開始

A

0xD107

2

EntityManagerFactory#createEntityManager(SynchronizationType type, Map map)の処理終了

A

0xD108

1

EntityManagerFactory#getCriteriaBuilder()の処理開始

B

0xD109

2

EntityManagerFactory#getCriteriaBuilder()の処理終了

B

0xD10A

1

EntityManagerFactory#getMetamodel()の処理開始

B

0xD10B

2

EntityManagerFactory#getMetamodel()の処理終了

B

0xD10C

1

EntityManagerFactory#getProperties()の処理開始

B

0xD10D

2

EntityManagerFactory#getProperties()の処理終了

B

0xD10E

1

EntityManagerFactory#getCache()の処理開始

B

0xD10F

2

EntityManagerFactory#getCache()の処理終了

B

0xD110

1

EntityManagerFactory#getPersistenceUnitUtil()の処理開始

B

0xD111

2

EntityManagerFactory#getPersistenceUnitUtil()の処理終了

B

0xD112

1

EntityManagerFactory#addNamedQuery(String name, Query query)の処理開始

B

0xD113

2

EntityManagerFactory#addNamedQuery(String name, Query query)の処理終了

B

0xD114

1

EntityManagerFactory#unwrap(Class<T> cls)の処理開始

B

0xD115

2

EntityManagerFactory#unwrap(Class<T> cls)の処理終了

B

0xD116

1

EntityManagerFactory#addNamedEntityGraph(String graphName, EntityGraph<T> entityGraph)の処理開始

B

0xD117

2

EntityManagerFactory#addNamedEntityGraph(String graphName, EntityGraph<T> entityGraph)の処理終了

B

0xD118

1

EntityManagerFactory#isOpen()の処理開始

B

0xD119

2

EntityManagerFactory#isOpen()の処理終了

B

0xD11A

1

EntityManagerFactory#close()の処理開始

A

0xD11B

2

EntityManagerFactory#close()の処理終了

A

0xD11C

1

EntityManager#find(Class<T> entityClass, Object primaryKey)の処理開始

B

0xD11D

2

EntityManager#find(Class<T> entityClass, Object primaryKey)の処理終了

B

0xD11E

1

EntityManager#find(Class<T> entityClass, Object primaryKey, Map<String, Object> properties)の処理開始

B

0xD11F

2

EntityManager#find(Class<T> entityClass, Object primaryKey, Map<String, Object> properties)の処理終了

B

0xD120

1

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)の処理開始

B

0xD121

2

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)の処理終了

B

0xD122

1

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String, Object> properties)の処理開始

B

0xD123

2

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String, Object> properties)の処理終了

B

0xD124

1

EntityManager#getReference(Class<T> entityClass, Object primaryKey)の処理開始

B

0xD125

2

EntityManager#getReference(Class<T> entityClass, Object primaryKey)の処理終了

B

0xD126

1

EntityManager#contains(Object entity)の処理開始

B

0xD127

2

EntityManager#contains(Object entity)の処理終了

B

0xD128

1

EntityManager#lock(Object entity, LockModeType lockMode)の処理開始

B

0xD129

2

EntityManager#lock(Object entity, LockModeType lockMode)の処理終了

B

0xD12A

1

EntityManager#lock(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理開始

B

0xD12B

2

EntityManager#lock(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理終了

B

0xD12C

1

EntityManager#merge(T entity)の処理開始

B

0xD12D

2

EntityManager#merge(T entity)の処理終了

B

0xD12E

1

EntityManager#persist(Object entity)の処理開始

B

0xD12F

2

EntityManager#persist(Object entity)の処理終了

B

0xD130

1

EntityManager#refresh(Object entity)の処理開始

B

0xD131

2

EntityManager#refresh(Object entity)の処理終了

B

0xD132

1

EntityManager#refresh(Object entity, Map<String,Object> properties)の処理開始

B

0xD133

2

EntityManager#refresh(Object entity, Map<String,Object> properties)の処理終了

B

0xD134

1

EntityManager#refresh(Object entity, LockModeType lockMode)の処理開始

B

0xD135

2

EntityManager#refresh(Object entity, LockModeType lockMode)の処理終了

B

0xD136

1

EntityManager#refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理開始

B

0xD137

2

EntityManager#refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理終了

B

0xD138

1

EntityManager#remove(Object entity)の処理開始

B

0xD139

2

EntityManager#remove(Object entity)の処理終了

B

0xD13A

1

EntityManager#clear()の処理開始

B

0xD13B

2

EntityManager#clear()の処理終了

B

0xD13C

1

EntityManager#flush()の処理開始

B

0xD13D

2

EntityManager#flush()の処理終了

B

0xD13E

1

EntityManager#detach(Object entity)の処理開始

B

0xD13F

2

EntityManager#detach(Object entity)の処理終了

B

0xD140

1

EntityManager#createEntityGraph(Class<T> rootType)の処理開始

B

0xD141

2

EntityManager#createEntityGraph(Class<T> rootType)の処理終了

B

0xD142

1

EntityManager#createEntityGraph(String graphName)の処理開始

B

0xD143

2

EntityManager#createEntityGraph(String graphName)の処理終了

B

0xD144

1

EntityManager#createQuery(String qlString)の処理開始

A

0xD145

2

EntityManager#createQuery(String qlString)の処理終了

A

0xD146

1

EntityManager#createQuery(CriteriaQuery<T> criteriaQuery)の処理開始

A

0xD147

2

EntityManager#createQuery(CriteriaQuery<T> criteriaQuery)の処理終了

A

0xD148

1

EntityManager#createQuery(CriteriaUpdate updateQuery)の処理開始

A

0xD149

2

EntityManager#createQuery(CriteriaUpdate updateQuery)の処理終了

A

0xD14A

1

EntityManager#createQuery(CriteriaDelete deleteQuery)の処理開始

A

0xD14B

2

EntityManager#createQuery(CriteriaDelete deleteQuery)の処理終了

A

0xD14C

1

EntityManager#createQuery(String qlString, Class<T> resultClass)の処理開始

A

0xD14D

2

EntityManager#createQuery(String qlString, Class<T> resultClass)の処理終了

A

0xD14E

1

EntityManager#createNamedQuery(String name)の処理開始

A

0xD14F

2

EntityManager#createNamedQuery(String name)の処理終了

A

0xD150

1

EntityManager#createNamedQuery(String name, Class<T> resultClass)の処理開始

A

0xD151

2

EntityManager#createNamedQuery(String name, Class<T> resultClass)の処理終了

A

0xD152

1

EntityManager#createNativeQuery(String sqlString)の処理開始

A

0xD153

2

EntityManager#createNativeQuery(String sqlString)の処理終了

A

0xD154

1

EntityManager#createNativeQuery(String sqlString, Class resultClass)の処理開始

A

0xD155

2

EntityManager#createNativeQuery(String sqlString, Class resultClass)の処理終了

A

0xD156

1

EntityManager#createNativeQuery(String sqlString, String resultSetMapping)の処理開始

A

0xD157

2

EntityManager#createNativeQuery(String sqlString, String resultSetMapping)の処理終了

A

0xD158

1

EntityManager#createNamedStoredProcedureQuery(String name)の処理開始

A

0xD159

2

EntityManager#createNamedStoredProcedureQuery(String name)の処理終了

A

0xD15A

1

EntityManager#createStoredProcedureQuery(String procedureName)の処理開始

A

0xD15B

2

EntityManager#createStoredProcedureQuery(String procedureName)の処理終了

A

0xD15C

1

EntityManager#createStoredProcedureQuery(String procedureName, Class... resultClasses)の処理開始

A

0xD15D

2

EntityManager#createStoredProcedureQuery(String procedureName, Class... resultClasses)の処理終了

A

0xD15E

1

EntityManager#createStoredProcedureQuery(String procedureName, String... resultSetMappings)の処理開始

A

0xD15F

2

EntityManager#createStoredProcedureQuery(String procedureName, String... resultSetMappings)の処理終了

A

0xD160

1

EntityManager#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD161

2

EntityManager#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD162

1

EntityManager#getFlushMode()の処理開始

B

0xD163

2

EntityManager#getFlushMode()の処理終了

B

0xD164

1

EntityManager#joinTransaction()の処理開始

B

0xD165

2

EntityManager#joinTransaction()の処理終了

B

0xD166

1

EntityManager#getTransaction()の処理開始

B

0xD167

2

EntityManager#getTransaction()の処理終了

B

0xD168

1

EntityManager#getDelegate()の処理開始

B

0xD169

2

EntityManager#getDelegate()の処理終了

B

0xD16A

1

EntityManager#unwrap(Class<T> cls)の処理開始

B

0xD16B

2

EntityManager#unwrap(Class<T> cls)の処理終了

B

0xD16C

1

EntityManager#getCriteriaBuilder()の処理開始

B

0xD16D

2

EntityManager#getCriteriaBuilder()の処理終了

B

0xD16E

1

EntityManager#getEntityGraph(String graphName)の処理開始

B

0xD16F

2

EntityManager#getEntityGraph(String graphName)の処理終了

B

0xD170

1

EntityManager#getEntityGraphs(Class<T> entityClass)の処理開始

B

0xD171

2

EntityManager#getEntityGraphs(Class<T> entityClass)の処理終了

B

0xD172

1

EntityManager#getEntityManagerFactory()の処理開始

B

0xD173

2

EntityManager#getEntityManagerFactory()の処理終了

B

0xD174

1

EntityManager#getLockMode(Object entity)の処理開始

B

0xD175

2

EntityManager#getLockMode(Object entity)の処理終了

B

0xD176

1

EntityManager#getMetamodel()の処理開始

B

0xD177

2

EntityManager#getMetamodel()の処理終了

B

0xD178

1

EntityManager#setProperty(String propertyName, Object value)の処理開始

B

0xD179

2

EntityManager#setProperty(String propertyName, Object value)の処理終了

B

0xD17A

1

EntityManager#getProperties()の処理開始

B

0xD17B

2

EntityManager#getProperties()の処理終了

B

0xD17C

1

EntityManager#isJoinedToTransaction()の処理開始

B

0xD17D

2

EntityManager#isJoinedToTransaction()の処理終了

B

0xD17E

1

EntityManager#isOpen()の処理開始

B

0xD17F

2

EntityManager#isOpen()の処理終了

B

0xD180

1

EntityManager#close()の処理開始

A

0xD181

2

EntityManager#close()の処理終了

A

0xD182

1

EntityTransaction#begin()の処理開始

A

0xD183

2

EntityTransaction#begin()の処理終了

A

0xD184

1

EntityTransaction#commit()の処理開始

A

0xD185

2

EntityTransaction#commit()の処理終了

A

0xD186

1

EntityTransaction#rollback()の処理開始

A

0xD187

2

EntityTransaction#rollback()の処理終了

A

0xD188

1

EntityTransaction#getRollbackOnly()の処理開始

B

0xD189

2

EntityTransaction#getRollbackOnly()の処理終了

B

0xD18A

1

EntityTransaction#setRollbackOnly()の処理開始

B

0xD18B

2

EntityTransaction#setRollbackOnly()の処理終了

B

0xD18C

1

EntityTransaction#isActive()の処理開始

B

0xD18D

2

EntityTransaction#isActive()の処理終了

B

0xD18E

1

Query#executeUpdate()の処理開始

B

0xD18F

2

Query#executeUpdate()の処理終了

B

0xD190

1

Query#getResultList()の処理開始

B

0xD191

2

Query#getResultList()の処理終了

B

0xD192

1

Query#getSingleResult()の処理開始

B

0xD193

2

Query#getSingleResult()の処理終了

B

0xD194

1

Query#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD195

2

Query#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD196

1

Query#getFlushMode()の処理開始

B

0xD197

2

Query#getFlushMode()の処理終了

B

0xD198

1

Query#setFirstResult(int startPosition)の処理開始

B

0xD199

2

Query#setFirstResult(int startPosition)の処理終了

B

0xD19A

1

Query#getFirstResult()の処理開始

B

0xD19B

2

Query#getFirstResult()の処理終了

B

0xD19C

1

Query#setMaxResults(int maxResult)の処理開始

B

0xD19D

2

Query#setMaxResults(int maxResult)の処理終了

B

0xD19E

1

Query#getMaxResults()の処理開始

B

0xD19F

2

Query#getMaxResults()の処理終了

B

0xD1A0

1

Query#setHint(String hintName, Object value)の処理開始

B

0xD1A1

2

Query#setHint(String hintName, Object value)の処理終了

B

0xD1A2

1

Query#getHints()の処理開始

B

0xD1A3

2

Query#getHints()の処理終了

B

0xD1A4

1

Query#setParameter(int position, Calendar value, TemporalType temporalType)の処理開始

B

0xD1A5

2

Query#setParameter(int position, Calendar value, TemporalType temporalType)の処理終了

B

0xD1A6

1

Query#setParameter(int position, Date value, TemporalType temporalType)の処理開始

B

0xD1A7

2

Query#setParameter(int position, Date value, TemporalType temporalType)の処理終了

B

0xD1A8

1

Query#setParameter(int position, Object value)の処理開始

B

0xD1A9

2

Query#setParameter(int position, Object value)の処理終了

B

0xD1AA

1

Query#setParameter(String name, Calendar value, TemporalType temporalType)の処理開始

B

0xD1AB

2

Query#setParameter(String name, Calendar value, TemporalType temporalType)の処理終了

B

0xD1AC

1

Query#setParameter(String name, Date value, TemporalType temporalType)の処理開始

B

0xD1AD

2

Query#setParameter(String name, Date value, TemporalType temporalType)の処理終了

B

0xD1AE

1

Query#setParameter(String name, Object value)の処理開始

B

0xD1AF

2

Query#setParameter(String name, Object value)の処理終了

B

0xD1B0

1

Query#setParameter(Parameter<T> param, T value)の処理開始

B

0xD1B1

2

Query#setParameter(Parameter<T> param, T value)の処理終了

B

0xD1B2

1

Query#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理開始

B

0xD1B3

2

Query#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理終了

B

0xD1B4

1

Query#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理開始

B

0xD1B5

2

Query#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理終了

B

0xD1B6

1

Query#getParameters()の処理開始

B

0xD1B7

2

Query#getParameters()の処理終了

B

0xD1B8

1

Query#getParameter(String name)の処理開始

B

0xD1B9

2

Query#getParameter(String name)の処理終了

B

0xD1BA

1

Query#getParameter(String name, Class<T> type)の処理開始

B

0xD1BB

2

Query#getParameter(String name, Class<T> type)の処理終了

B

0xD1BC

1

Query#getParameter(int position)の処理開始

B

0xD1BD

2

Query#getParameter(int position)の処理終了

B

0xD1BE

1

Query#getParameter(int position, Class<T> type)の処理開始

B

0xD1BF

2

Query#getParameter(int position, Class<T> type)の処理終了

B

0xD1C0

1

Query#isBound(Parameter<?> param)の処理開始

B

0xD1C1

2

Query#isBound(Parameter<?> param)の処理終了

B

0xD1C2

1

Query#getParameterValue(Parameter<T> param)の処理開始

B

0xD1C3

2

Query#getParameterValue(Parameter<T> param)の処理終了

B

0xD1C4

1

Query#getParameterValue(String name)の処理開始

B

0xD1C5

2

Query#getParameterValue(String name)の処理終了

B

0xD1C6

1

Query#getParameterValue(int position)の処理開始

B

0xD1C7

2

Query#getParameterValue(int position)の処理終了

B

0xD1C8

1

Query#setLockMode(LockModeType lockMode)の処理開始

B

0xD1C9

2

Query#setLockMode(LockModeType lockMode)の処理終了

B

0xD1CA

1

Query#getLockMode()の処理開始

B

0xD1CB

2

Query#getLockMode()の処理終了

B

0xD1CC

1

Query#unwrap(Class<T> cls)の処理開始

B

0xD1CD

2

Query#unwrap(Class<T> cls)の処理終了

B

0xD1CE

1

TypedQuery#executeUpdate()の処理開始

B

0xD1CF

2

TypedQuery#executeUpdate()の処理終了

B

0xD1D0

1

TypedQuery#getResultList()の処理開始

B

0xD1D1

2

TypedQuery#getResultList()の処理終了

B

0xD1D2

1

TypedQuery#getSingleResult()の処理開始

B

0xD1D3

2

TypedQuery#getSingleResult()の処理終了

B

0xD1D4

1

TypedQuery#setMaxResults(int maxResult)の処理開始

B

0xD1D5

2

TypedQuery#setMaxResults(int maxResult)の処理終了

B

0xD1D6

1

TypedQuery#setFirstResult(int startPosition)の処理開始

B

0xD1D7

2

TypedQuery#setFirstResult(int startPosition)の処理終了

B

0xD1D8

1

TypedQuery#setHint(String hintName, Object value)の処理開始

B

0xD1D9

2

TypedQuery#setHint(String hintName, Object value)の処理終了

B

0xD1DA

1

TypedQuery#setParameter(Parameter<T> param, T value)の処理開始

B

0xD1DB

2

TypedQuery#setParameter(Parameter<T> param, T value)の処理終了

B

0xD1DC

1

TypedQuery#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理開始

B

0xD1DD

2

TypedQuery#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理終了

B

0xD1DE

1

TypedQuery#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理開始

B

0xD1DF

2

TypedQuery#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理終了

B

0xD1E0

1

TypedQuery#setParameter(String name, Object value)の処理開始

B

0xD1E1

2

TypedQuery#setParameter(String name, Object value)の処理終了

B

0xD1E2

1

TypedQuery#setParameter(String name, Calendar value, TemporalType temporalType)の処理開始

B

0xD1E3

2

TypedQuery#setParameter(String name, Calendar value, TemporalType temporalType)の処理終了

B

0xD1E4

1

TypedQuery#setParameter(String name, Date value, TemporalType temporalType)の処理開始

B

0xD1E5

2

TypedQuery#setParameter(String name, Date value, TemporalType temporalType)の処理終了

B

0xD1E6

1

TypedQuery#setParameter(int position, Object value)の処理開始

B

0xD1E7

2

TypedQuery#setParameter(int position, Object value)の処理終了

B

0xD1E8

1

TypedQuery#setParameter(int position, Calendar value, TemporalType temporalType)の処理開始

B

0xD1E9

2

TypedQuery#setParameter(int position, Calendar value, TemporalType temporalType)の処理終了

B

0xD1EA

1

TypedQuery#setParameter(int position, Date value, TemporalType temporalType)の処理開始

B

0xD1EB

2

TypedQuery#setParameter(int position, Date value, TemporalType temporalType)の処理終了

B

0xD1EC

1

TypedQuery#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD1ED

2

TypedQuery#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD1EE

1

TypedQuery#setLockMode(LockModeType lockMode)の処理開始

B

0xD1EF

2

TypedQuery#setLockMode(LockModeType lockMode)の処理終了

B

（凡例）A：標準　B：詳細

注※　図8-68の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒68　アプリケーション管理の永続化コンテキストを利用した場合のトレース取得ポイント

(2)　取得できるトレース情報

アプリケーション管理の永続化コンテキストを利用した場合に取得できるトレース情報を次の表に示します。

表8‒110　アプリケーション管理の永続化コンテキストを利用した場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インターフェース名

オペレーション名

オプション

1

0xD100

A

−

−

−

0xD102

A

−

−

−

0xD104

A

SynchronizationTypeの値

−

−

0xD106

A

SynchronizationTypeの値

−

−

0xD108

B

−

−

−

0xD10A

B

−

−

−

0xD10C

B

−

−

−

0xD10E

B

−

−

−

0xD110

B

−

−

−

0xD112

B

nameの値

−

−

0xD114

B

clsのクラス名

−

−

0xD116

B

graphNameの値

−

−

0xD118

B

−

−

−

0xD11A

A

−

−

−

0xD11C

B

entityのクラス名

−

−

0xD11E

B

entityClassのクラス名

−

−

0xD120

B

entityClassのクラス名

−

−

0xD122

B

entityClassのクラス名

−

−

0xD124

B

entityのクラス名

−

−

0xD126

B

entityのクラス名

−

−

0xD128

B

entityのクラス名

lockModeの値

−

0xD12A

B

entityのクラス名

lockModeの値

−

0xD12C

B

entityのクラス名

−

−

0xD12E

B

entityのクラス名

−

−

0xD130

B

entityのクラス名

−

−

0xD132

B

entityのクラス名

−

−

0xD134

B

entityのクラス名

−

−

0xD136

B

entityのクラス名

−

−

0xD138

B

entityのクラス名

−

−

0xD13A

B

−

−

−

0xD13C

B

−

−

−

0xD13E

B

entityのクラス名

−

−

0xD140

B

rootTyoeのクラス名

−

−

0xD142

B

graphNameの値

−

−

0xD144

A

−

−

−

0xD146

A

−

−

−

0xD148

A

−

−

−

0xD14A

A

−

−

−

0xD14C

A

−

−

−

0xD14E

A

nameの値

−

−

0xD150

A

nameの値

−

−

0xD152

A

−

−

−

0xD154

A

resultClassのクラス名

−

−

0xD156

A

resultSetMapping

−

−

0xD158

A

nameの値

−

−

0xD15A

A

procedureNameの値

−

−

0xD15C

A

procedureNameの値

−

−

0xD15E

A

procedureNameの値

−

−

0xD160

B

flushModeの値

−

−

0xD162

B

−

−

−

0xD164

B

−

−

−

0xD166

B

−

−

−

0xD168

B

−

−

−

0xD16A

B

clsのクラス名

−

−

0xD16C

B

−

−

−

0xD16E

B

graphNameの値

−

−

0xD170

B

entityClassのクラス名

−

−

0xD172

B

−

−

−

0xD174

B

entityのクラス名

−

−

0xD176

B

−

−

−

0xD178

B

propertyNameの値

−

−

0xD17A

B

−

−

−

0xD17C

B

−

−

−

0xD17E

B

−

−

−

0xD180

A

−

−

−

0xD182

A

−

−

−

0xD184

A

−

−

−

0xD186

A

−

−

−

0xD188

B

−

−

−

0xD18A

B

−

−

−

0xD18C

B

−

−

−

0xD18E

B

−

−

−

0xD190

B

−

−

−

0xD192

B

−

−

−

0xD194

B

flushModeの値

−

−

0xD196

B

−

−

−

0xD198

B

startPositionの値

−

−

0xD19A

B

−

−

−

0xD19C

B

maxResultの値

−

−

0xD19E

B

−

−

−

0xD1A0

B

hintName

valueのクラス名

−

0xD1A2

B

−

−

−

0xD1A4

B

positionの値

−

−

0xD1A6

B

positionの値

−

−

0xD1A8

B

positionの値

−

−

0xD1AA

B

nameの値

−

−

0xD1AC

B

nameの値

−

−

0xD1AE

B

nameの値

−

−

0xD1B0

B

−

−

−

0xD1B2

B

−

−

−

0xD1B4

B

−

−

−

0xD1B6

B

−

−

−

0xD1B8

B

nameの値

−

−

0xD1BA

B

nameの値

−

−

0xD1BC

B

positionの値

−

−

0xD1BE

B

positionの値

−

−

0xD1C0

B

−

−

−

0xD1C2

B

−

−

−

0xD1C4

B

nameの値

−

−

0xD1C6

B

positionの値

−

−

0xD1C8

B

−

−

−

0xD1CA

B

−

−

−

0xD1CC

B

−

−

−

0xD1CE

B

−

−

−

0xD1D0

B

−

−

−

0xD1D2

B

−

−

−

0xD1D4

B

maxResultの値

−

−

0xD1D6

B

startPositionの値

−

−

0xD1D8

B

hintName

valueのクラス名

−

0xD1DA

B

−

−

−

0xD1DC

B

−

−

−

0xD1DE

B

−

−

−

0xD1E0

B

nameの値

−

−

0xD1E2

B

nameの値

−

−

0xD1E4

B

nameの値

−

−

0xD1E6

B

positionの値

−

−

0xD1E8

B

positionの値

−

−

0xD1EA

B

positionの値

−

−

0xD1EC

B

flushModeの値

−

−

0xD1EE

B

−

−

−

2

0xD101

A

−

−

正常時

<入り口時刻>

例外発生時

<入り口時刻><例外名>

0xD103

A

−

−

0xD105

A

−

−

0xD107

A

−

−

0xD109

B

−

−

0xD10B

B

−

−

0xD10D

B

−

−

0xD10F

B

−

−

0xD111

B

−

−

0xD113

B

−

−

0xD115

B

−

−

0xD117

B

−

−

0xD119

B

−

−

0xD11B

A

−

−

0xD11D

B

−

−

0xD11F

B

−

−

0xD121

B

−

−

0xD123

B

−

−

0xD125

B

−

−

0xD127

B

−

−

0xD129

B

−

−

0xD12B

B

−

−

0xD12D

B

−

−

0xD12F

B

−

−

0xD131

B

−

−

0xD133

B

−

−

0xD135

B

−

−

0xD137

B

−

−

0xD139

B

−

−

0xD13B

B

−

−

0xD13D

B

−

−

0xD13F

B

−

−

0xD141

B

−

−

0xD143

B

−

−

0xD145

A

−

−

0xD147

A

−

−

0xD149

A

−

−

0xD14B

A

−

−

0xD14D

A

−

−

0xD14F

A

−

−

0xD151

A

−

−

0xD153

A

−

−

0xD155

A

−

−

0xD157

A

−

−

0xD159

A

−

−

0xD15B

A

−

−

0xD15D

A

−

−

0xD15F

A

−

−

0xD161

B

−

−

0xD163

B

−

−

0xD165

B

−

−

0xD167

B

−

−

0xD169

B

−

−

0xD16B

B

−

−

0xD16D

B

−

−

0xD16F

B

−

−

0xD171

B

−

−

0xD173

B

−

−

0xD175

B

−

−

0xD177

B

−

−

0xD179

B

−

−

0xD17B

B

−

−

0xD17D

B

−

−

0xD17F

B

−

−

0xD181

A

−

−

0xD183

A

−

−

0xD185

A

−

−

0xD187

A

−

−

0xD189

B

−

−

0xD18B

B

−

−

0xD18D

B

−

−

0xD18F

B

−

−

0xD191

B

−

−

0xD193

B

−

−

0xD195

B

−

−

0xD197

B

−

−

0xD199

B

−

−

0xD19B

B

−

−

0xD19D

B

−

−

0xD19F

B

−

−

0xD1A1

B

−

−

0xD1A3

B

−

−

0xD1A5

B

−

−

0xD1A7

B

−

−

0xD1A9

B

−

−

0xD1AB

B

−

−

0xD1AD

B

−

−

0xD1AF

B

−

−

0xD1B1

B

−

−

0xD1B3

B

−

−

0xD1B5

B

−

−

0xD1B7

B

−

−

0xD1B9

B

−

−

0xD1BB

B

−

−

0xD1BD

B

−

−

0xD1BF

B

−

−

0xD1C1

B

−

−

0xD1C3

B

−

−

0xD1C5

B

−

−

0xD1C7

B

−

−

0xD1C9

B

−

−

0xD1CB

B

−

−

0xD1CD

B

−

−

0xD1CF

B

−

−

0xD1D1

B

−

−

0xD1D3

B

−

−

0xD1D5

B

−

−

0xD1D7

B

−

−

0xD1D9

B

−

−

0xD1DB

B

−

−

0xD1DD

B

−

−

0xD1DF

B

−

−

0xD1E1

B

−

−

0xD1E3

B

−

−

0xD1E5

B

−

−

0xD1E7

B

−

−

0xD1E9

B

−

−

0xD1EB

B

−

−

0xD1ED

B

−

−

0xD1EF

B

−

−

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-68中の番号と対応しています。

8.18.2　コンテナ管理の永続化コンテキストを利用した場合のトレース取得ポイントと取得できるトレース情報

コンテナ管理の永続化コンテキストを利用した場合のトレース取得ポイントと取得できるトレース情報について説明します。ここでは，次の四つの場合に分けて説明します。

トランザクションスコープの永続化コンテキストをトランザクション内で利用した場合

トランザクションスコープの永続化コンテキストに関連づいているエンティティマネージャをトランザクション外で利用した場合

トランザクション外で生成されたQueryをトランザクション外で利用した場合

拡張永続化コンテキストを利用した場合

(1)　トレース取得ポイントとPRFトレース取得レベル

(a)　トランザクションスコープの永続化コンテキストをトランザクション内で利用した場合

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒111　トランザクションスコープの永続化コンテキストをトランザクション内で利用した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xD11C

1，5

EntityManager#find(Class<T> entityClass, Object primaryKey)の処理開始

B

0xD11D

4，6

EntityManager#find(Class<T> entityClass, Object primaryKey)の処理終了

B

0xD11E

1，5

EntityManager#find(Class<T> entityClass, Object primaryKey, Map<String, Object> properties)の処理開始

B

0xD11F

4，6

EntityManager#find(Class<T> entityClass, Object primaryKey, Map<String, Object> properties)の処理終了

B

0xD120

1，5

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)の処理開始

B

0xD121

4，6

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)の処理終了

B

0xD122

1，5

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String, Object> properties)の処理開始

B

0xD123

4，6

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String, Object> properties)の処理終了

B

0xD124

1，5

EntityManager#getReference(Class<T> entityClass, Object primaryKey)の処理開始

B

0xD125

4，6

EntityManager#getReference(Class<T> entityClass, Object primaryKey)の処理終了

B

0xD126

1，5

EntityManager#contains(Object entity)の処理開始

B

0xD127

4，6

EntityManager#contains(Object entity)の処理終了

B

0xD128

1，5

EntityManager#lock(Object entity, LockModeType lockMode)の処理開始

B

0xD129

4，6

EntityManager#lock(Object entity, LockModeType lockMode)の処理終了

B

0xD12A

1，5

EntityManager#lock(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理開始

B

0xD12B

4，6

EntityManager#lock(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理終了

B

0xD12C

1，5

EntityManager#merge(T entity)の処理開始

B

0xD12D

4，6

EntityManager#merge(T entity)の処理終了

B

0xD12E

1，5

EntityManager#persist(Object entity)の処理開始

B

0xD12F

4，6

EntityManager#persist(Object entity)の処理終了

B

0xD130

1，5

EntityManager#refresh(Object entity)の処理開始

B

0xD131

4，6

EntityManager#refresh(Object entity)の処理終了

B

0xD132

1，5

EntityManager#refresh(Object entity, Map<String,Object> properties)の処理開始

B

0xD133

4，6

EntityManager#refresh(Object entity, Map<String,Object> properties)の処理終了

B

0xD134

1，5

EntityManager#refresh(Object entity, LockModeType lockMode)の処理開始

B

0xD135

4，6

EntityManager#refresh(Object entity, LockModeType lockMode)の処理終了

B

0xD136

1，5

EntityManager#refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理開始

B

0xD137

4，6

EntityManager#refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理終了

B

0xD138

1，5

EntityManager#remove(Object entity)の処理開始

B

0xD139

4，6

EntityManager#remove(Object entity)の処理終了

B

0xD13A

1，5

EntityManager#clear()の処理開始

B

0xD13B

4，6

EntityManager#clear()の処理終了

B

0xD13C

1，5

EntityManager#flush()の処理開始

B

0xD13D

4，6

EntityManager#flush()の処理終了

B

0xD13E

1，5

EntityManager#detach(Object entity)の処理開始

B

0xD13F

4，6

EntityManager#detach(Object entity)の処理終了

B

0xD140

1，5

EntityManager#createEntityGraph(Class<T> rootType)の処理開始

B

0xD141

4，6

EntityManager#createEntityGraph(Class<T> rootType)の処理終了

B

0xD142

1，5

EntityManager#createEntityGraph(String graphName)の処理開始

B

0xD143

4，6

EntityManager#createEntityGraph(String graphName)の処理終了

B

0xD144

1，5

EntityManager#createQuery(String qlString)の処理開始

A

0xD145

4，6

EntityManager#createQuery(String qlString)の処理終了

A

0xD146

1，5

EntityManager#createQuery(CriteriaQuery<T> criteriaQuery)の処理開始

A

0xD147

4，6

EntityManager#createQuery(CriteriaQuery<T> criteriaQuery)の処理終了

A

0xD148

1，5

EntityManager#createQuery(CriteriaUpdate updateQuery)の処理開始

A

0xD149

4，6

EntityManager#createQuery(CriteriaUpdate updateQuery)の処理終了

A

0xD14A

1，5

EntityManager#createQuery(CriteriaDelete deleteQuery)の処理開始

A

0xD14B

4，6

EntityManager#createQuery(CriteriaDelete deleteQuery)の処理終了

A

0xD14C

1，5

EntityManager#createQuery(String qlString, Class<T> resultClass)の処理開始

A

0xD14D

4，6

EntityManager#createQuery(String qlString, Class<T> resultClass)の処理終了

A

0xD14E

1，5

EntityManager#createNamedQuery(String name)の処理開始

A

0xD14F

4，6

EntityManager#createNamedQuery(String name)の処理終了

A

0xD150

1，5

EntityManager#createNamedQuery(String name, Class<T> resultClass)の処理開始

A

0xD151

4，6

EntityManager#createNamedQuery(String name, Class<T> resultClass)の処理終了

A

0xD152

1，5

EntityManager#createNativeQuery(String sqlString)の処理開始

A

0xD153

4，6

EntityManager#createNativeQuery(String sqlString)の処理終了

A

0xD154

1，5

EntityManager#createNativeQuery(String sqlString, Class resultClass)の処理開始

A

0xD155

4，6

EntityManager#createNativeQuery(String sqlString, Class resultClass)の処理終了

A

0xD156

1，5

EntityManager#createNativeQuery(String sqlString, String resultSetMapping)の処理開始

A

0xD157

4，6

EntityManager#createNativeQuery(String sqlString, String resultSetMapping)の処理終了

A

0xD158

1，5

EntityManager#createNamedStoredProcedureQuery(String name)の処理開始

A

0xD159

4，6

EntityManager#createNamedStoredProcedureQuery(String name)の処理終了

A

0xD15A

1，5

EntityManager#createStoredProcedureQuery(String procedureName)の処理開始

A

0xD15B

4，6

EntityManager#createStoredProcedureQuery(String procedureName)の処理終了

A

0xD15C

1，5

EntityManager#createStoredProcedureQuery(String procedureName, Class... resultClasses)の処理開始

A

0xD15D

4，6

EntityManager#createStoredProcedureQuery(String procedureName, Class... resultClasses)の処理終了

A

0xD15E

1，5

EntityManager#createStoredProcedureQuery(String procedureName, String... resultSetMappings)の処理開始

A

0xD15F

4，6

EntityManager#createStoredProcedureQuery(String procedureName, String... resultSetMappings)の処理終了

A

0xD160

1，5

EntityManager#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD161

4，6

EntityManager#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD162

1，5

EntityManager#getFlushMode()の処理開始

B

0xD163

4，6

EntityManager#getFlushMode()の処理終了

B

0xD164

1，5

EntityManager#joinTransaction()の処理開始

B

0xD165

4，6

EntityManager#joinTransaction()の処理終了

B

0xD166

1，5

EntityManager#getTransaction()の処理開始

B

0xD167

4，6

EntityManager#getTransaction()の処理終了

B

0xD168

1，5

EntityManager#getDelegate()の処理開始

B

0xD169

4，6

EntityManager#getDelegate()の処理終了

B

0xD16A

1，5

EntityManager#unwrap(Class<T> cls)の処理開始

B

0xD16B

4，6

EntityManager#unwrap(Class<T> cls)の処理終了

B

0xD16C

1，5

EntityManager#getCriteriaBuilder()の処理開始

B

0xD16D

4，6

EntityManager#getCriteriaBuilder()の処理終了

B

0xD16E

1，5

EntityManager#getEntityGraph(String graphName)の処理開始

B

0xD16F

4，6

EntityManager#getEntityGraph(String graphName)の処理終了

B

0xD170

1，5

EntityManager#getEntityGraphs(Class<T> entityClass)の処理開始

B

0xD171

4，6

EntityManager#getEntityGraphs(Class<T> entityClass)の処理終了

B

0xD172

1，5

EntityManager#getEntityManagerFactory()の処理開始

B

0xD173

4，6

EntityManager#getEntityManagerFactory()の処理終了

B

0xD174

1，5

EntityManager#getLockMode(Object entity)の処理開始

B

0xD175

4，6

EntityManager#getLockMode(Object entity)の処理終了

B

0xD176

1，5

EntityManager#getMetamodel()の処理開始

B

0xD177

4，6

EntityManager#getMetamodel()の処理終了

B

0xD178

1，5

EntityManager#setProperty(String propertyName, Object value)の処理開始

B

0xD179

4，6

EntityManager#setProperty(String propertyName, Object value)の処理終了

B

0xD17A

1，5

EntityManager#getProperties()の処理開始

B

0xD17B

4，6

EntityManager#getProperties()の処理終了

B

0xD17C

1，5

EntityManager#isJoinedToTransaction()の処理開始

B

0xD17D

4，6

EntityManager#isJoinedToTransaction()の処理終了

B

0xD17E

1，5

EntityManager#isOpen()の処理開始

B

0xD17F

4，6

EntityManager#isOpen()の処理終了

B

0xD180

1，5

EntityManager#close()の処理開始

A

0xD181

4，6

EntityManager#close()の処理終了

A

0xD18E

1，5

Query#executeUpdate()の処理開始

B

0xD18F

4，6

Query#executeUpdate()の処理終了

B

0xD190

1，5

Query#getResultList()の処理開始

B

0xD191

4，6

Query#getResultList()の処理終了

B

0xD192

1，5

Query#getSingleResult()の処理開始

B

0xD193

4，6

Query#getSingleResult()の処理終了

B

0xD194

1，5

Query#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD195

4，6

Query#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD196

1，5

Query#getFlushMode()の処理開始

B

0xD197

4，6

Query#getFlushMode()の処理終了

B

0xD198

1，5

Query#setFirstResult(int startPosition)の処理開始

B

0xD199

4，6

Query#setFirstResult(int startPosition)の処理終了

B

0xD19A

1，5

Query#getFirstResult()の処理開始

B

0xD19B

4，6

Query#getFirstResult()の処理終了

B

0xD19C

1，5

Query#setMaxResults(int maxResult)の処理開始

B

0xD19D

4，6

Query#setMaxResults(int maxResult)の処理終了

B

0xD19E

1，5

Query#getMaxResults()の処理開始

B

0xD19F

4，6

Query#getMaxResults()の処理終了

B

0xD1A0

1，5

Query#setHint(String hintName, Object value)の処理開始

B

0xD1A1

4，6

Query#setHint(String hintName, Object value)の処理終了

B

0xD1A2

1，5

Query#getHints()の処理開始

B

0xD1A3

4，6

Query#getHints()の処理終了

B

0xD1A4

1，5

Query#setParameter(int position, Calendar value, TemporalType temporalType)の処理開始

B

0xD1A5

4，6

Query#setParameter(int position, Calendar value, TemporalType temporalType)の処理終了

B

0xD1A6

1，5

Query#setParameter(int position, Date value, TemporalType temporalType)の処理開始

B

0xD1A7

4，6

Query#setParameter(int position, Date value, TemporalType temporalType)の処理終了

B

0xD1A8

1，5

Query#setParameter(int position, Object value)の処理開始

B

0xD1A9

4，6

Query#setParameter(int position, Object value)の処理終了

B

0xD1AA

1，5

Query#setParameter(String name, Calendar value, TemporalType temporalType)の処理開始

B

0xD1AB

4，6

Query#setParameter(String name, Calendar value, TemporalType temporalType)の処理終了

B

0xD1AC

1，5

Query#setParameter(String name, Date value, TemporalType temporalType)の処理開始

B

0xD1AD

4，6

Query#setParameter(String name, Date value, TemporalType temporalType)の処理終了

B

0xD1AE

1，5

Query#setParameter(String name, Object value)の処理開始

B

0xD1AF

4，6

Query#setParameter(String name, Object value)の処理終了

B

0xD1B0

1，5

Query#setParameter(Parameter<T> param, T value)の処理開始

B

0xD1B1

4，6

Query#setParameter(Parameter<T> param, T value)の処理終了

B

0xD1B2

1，5

Query#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理開始

B

0xD1B3

4，6

Query#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理終了

B

0xD1B4

1，5

Query#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理開始

B

0xD1B5

4，6

Query#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理終了

B

0xD1B6

1，5

Query#getParameters()の処理開始

B

0xD1B7

4，6

Query#getParameters()の処理終了

B

0xD1B8

1，5

Query#getParameter(String name)の処理開始

B

0xD1B9

4，6

Query#getParameter(String name)の処理終了

B

0xD1BA

1，5

Query#getParameter(String name, Class<T> type)の処理開始

B

0xD1BB

4，6

Query#getParameter(String name, Class<T> type)の処理終了

B

0xD1BC

1，5

Query#getParameter(int position)の処理開始

B

0xD1BD

4，6

Query#getParameter(int position)の処理終了

B

0xD1BE

1，5

Query#getParameter(int position, Class<T> type)の処理開始

B

0xD1BF

4，6

Query#getParameter(int position, Class<T> type)の処理終了

B

0xD1C0

1，5

Query#isBound(Parameter<?> param)の処理開始

B

0xD1C1

4，6

Query#isBound(Parameter<?> param)の処理終了

B

0xD1C2

1，5

Query#getParameterValue(Parameter<T> param)の処理開始

B

0xD1C3

4，6

Query#getParameterValue(Parameter<T> param)の処理終了

B

0xD1C4

1，5

Query#getParameterValue(String name)の処理開始

B

0xD1C5

4，6

Query#getParameterValue(String name)の処理終了

B

0xD1C6

1，5

Query#getParameterValue(int position)の処理開始

B

0xD1C7

4，6

Query#getParameterValue(int position)の処理終了

B

0xD1C8

1，5

Query#setLockMode(LockModeType lockMode)の処理開始

B

0xD1C9

4，6

Query#setLockMode(LockModeType lockMode)の処理終了

B

0xD1CA

1，5

Query#getLockMode()の処理開始

B

0xD1CB

4，6

Query#getLockMode()の処理終了

B

0xD1CC

1，5

Query#unwrap(Class<T> cls)の処理開始

B

0xD1CD

4，6

Query#unwrap(Class<T> cls)の処理終了

B

0xD1CE

1，5

TypedQuery#executeUpdate()の処理開始

B

0xD1CF

4，6

TypedQuery#executeUpdate()の処理終了

B

0xD1D0

1，5

TypedQuery#getResultList()の処理開始

B

0xD1D1

4，6

TypedQuery#getResultList()の処理終了

B

0xD1D2

1，5

TypedQuery#getSingleResult()の処理開始

B

0xD1D3

4，6

TypedQuery#getSingleResult()の処理終了

B

0xD1D4

1，5

TypedQuery#setMaxResults(int maxResult)の処理開始

B

0xD1D5

4，6

TypedQuery#setMaxResults(int maxResult)の処理終了

B

0xD1D6

1，5

TypedQuery#setFirstResult(int startPosition)の処理開始

B

0xD1D7

4，6

TypedQuery#setFirstResult(int startPosition)の処理終了

B

0xD1D8

1，5

TypedQuery#setHint(String hintName, Object value)の処理開始

B

0xD1D9

4，6

TypedQuery#setHint(String hintName, Object value)の処理終了

B

0xD1DA

1，5

TypedQuery#setParameter(Parameter<T> param, T value)の処理開始

B

0xD1DB

4，6

TypedQuery#setParameter(Parameter<T> param, T value)の処理終了

B

0xD1DC

1，5

TypedQuery#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理開始

B

0xD1DD

4，6

TypedQuery#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理終了

B

0xD1DE

1，5

TypedQuery#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理開始

B

0xD1DF

4，6

TypedQuery#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理終了

B

0xD1E0

1，5

TypedQuery#setParameter(String name, Object value)の処理開始

B

0xD1E1

4，6

TypedQuery#setParameter(String name, Object value)の処理終了

B

0xD1E2

1，5

TypedQuery#setParameter(String name, Calendar value, TemporalType temporalType)の処理開始

B

0xD1E3

4，6

TypedQuery#setParameter(String name, Calendar value, TemporalType temporalType)の処理終了

B

0xD1E4

1，5

TypedQuery#setParameter(String name, Date value, TemporalType temporalType)の処理開始

B

0xD1E5

4，6

TypedQuery#setParameter(String name, Date value, TemporalType temporalType)の処理終了

B

0xD1E6

1，5

TypedQuery#setParameter(int position, Object value)の処理開始

B

0xD1E7

4，6

TypedQuery#setParameter(int position, Object value)の処理終了

B

0xD1E8

1，5

TypedQuery#setParameter(int position, Calendar value, TemporalType temporalType)の処理開始

B

0xD1E9

4，6

TypedQuery#setParameter(int position, Calendar value, TemporalType temporalType)の処理終了

B

0xD1EA

1，5

TypedQuery#setParameter(int position, Date value, TemporalType temporalType)の処理開始

B

0xD1EB

4，6

TypedQuery#setParameter(int position, Date value, TemporalType temporalType)の処理終了

B

0xD1EC

1，5

TypedQuery#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD1ED

4，6

TypedQuery#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD1EE

1，5

TypedQuery#setLockMode(LockModeType lockMode)の処理開始

B

0xD1EF

4，6

TypedQuery#setLockMode(LockModeType lockMode)の処理終了

B

0xD1F0

2

トランザクションスコープの永続化コンテキストを利用した際の永続化コンテキストの生成処理開始

A

0xD1F1

3

トランザクションスコープの永続化コンテキストを利用した際の永続化コンテキストの生成処理終了

A

0xD1F2

7

トランザクションスコープの永続化コンテキストを利用した際の永続化コンテキストの破棄処理開始

A

0xD1F3

8

トランザクションスコープの永続化コンテキストを利用した際の永続化コンテキストの破棄処理終了

A

（凡例）A：標準　B：詳細

注※　図8-69中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒69　トランザクションスコープの永続化コンテキストをトランザクション内で利用した場合のトレース取得ポイント

(b)　トランザクションスコープの永続化コンテキストに関連づいているエンティティマネージャをトランザクション外で利用した場合

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒112　トランザクションスコープの永続化コンテキストに関連づいているエンティティマネージャをトランザクション外で利用した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xD11C

1

EntityManager#find(Class<T> entityClass, Object primaryKey)の処理開始

B

0xD11D

4

EntityManager#find(Class<T> entityClass, Object primaryKey)の処理終了

B

0xD11E

1

EntityManager#find(Class<T> entityClass, Object primaryKey, Map<String, Object> properties)の処理開始

B

0xD11F

4

EntityManager#find(Class<T> entityClass, Object primaryKey, Map<String, Object> properties)の処理終了

B

0xD120

1

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)の処理開始

B

0xD121

4

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)の処理終了

B

0xD122

1

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String, Object> properties)の処理開始

B

0xD123

4

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String, Object> properties)の処理終了

B

0xD124

1

EntityManager#getReference(Class<T> entityClass, Object primaryKey)の処理開始

B

0xD125

4

EntityManager#getReference(Class<T> entityClass, Object primaryKey)の処理終了

B

0xD126

1

EntityManager#contains(Object entity)の処理開始

B

0xD127

4

EntityManager#contains(Object entity)の処理終了

B

0xD128

1

EntityManager#lock(Object entity, LockModeType lockMode)の処理開始

B

0xD129

4

EntityManager#lock(Object entity, LockModeType lockMode)の処理終了

B

0xD12A

1

EntityManager#lock(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理開始

B

0xD12B

4

EntityManager#lock(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理終了

B

0xD12C

1

EntityManager#merge(T entity)の処理開始

B

0xD12D

4

EntityManager#merge(T entity)の処理終了

B

0xD12E

1

EntityManager#persist(Object entity)の処理開始

B

0xD12F

4

EntityManager#persist(Object entity)の処理終了

B

0xD130

1

EntityManager#refresh(Object entity)の処理開始

B

0xD131

4

EntityManager#refresh(Object entity)の処理終了

B

0xD132

1

EntityManager#refresh(Object entity, Map<String,Object> properties)の処理開始

B

0xD133

4

EntityManager#refresh(Object entity, Map<String,Object> properties)の処理終了

B

0xD134

1

EntityManager#refresh(Object entity, LockModeType lockMode)の処理開始

B

0xD135

4

EntityManager#refresh(Object entity, LockModeType lockMode)の処理終了

B

0xD136

1

EntityManager#refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理開始

B

0xD137

4

EntityManager#refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理終了

B

0xD138

1

EntityManager#remove(Object entity)の処理開始

B

0xD139

4

EntityManager#remove(Object entity)の処理終了

B

0xD13A

1

EntityManager#clear()の処理開始

B

0xD13B

4

EntityManager#clear()の処理終了

B

0xD13C

1

EntityManager#flush()の処理開始

B

0xD13D

4

EntityManager#flush()の処理終了

B

0xD13E

1

EntityManager#detach(Object entity)の処理開始

B

0xD13F

4

EntityManager#detach(Object entity)の処理終了

B

0xD140

1

EntityManager#createEntityGraph(Class<T> rootType)の処理開始

B

0xD141

4

EntityManager#createEntityGraph(Class<T> rootType)の処理終了

B

0xD142

1

EntityManager#createEntityGraph(String graphName)の処理開始

B

0xD143

4

EntityManager#createEntityGraph(String graphName)の処理終了

B

0xD160

1

EntityManager#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD161

4

EntityManager#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD162

1

EntityManager#getFlushMode()の処理開始

B

0xD163

4

EntityManager#getFlushMode()の処理終了

B

0xD164

1

EntityManager#joinTransaction()の処理開始

B

0xD165

4

EntityManager#joinTransaction()の処理終了

B

0xD166

1

EntityManager#getTransaction()の処理開始

B

0xD167

4

EntityManager#getTransaction()の処理終了

B

0xD168

1

EntityManager#getDelegate()の処理開始

B

0xD169

4

EntityManager#getDelegate()の処理終了

B

0xD16A

1

EntityManager#unwrap(Class<T> cls)の処理開始

B

0xD16B

4

EntityManager#unwrap(Class<T> cls)の処理終了

B

0xD16C

1

EntityManager#getCriteriaBuilder()の処理開始

B

0xD16D

4

EntityManager#getCriteriaBuilder()の処理終了

B

0xD16E

1

EntityManager#getEntityGraph(String graphName)の処理開始

B

0xD16F

4

EntityManager#getEntityGraph(String graphName)の処理終了

B

0xD170

1

EntityManager#getEntityGraphs(Class<T> entityClass)の処理開始

B

0xD171

4

EntityManager#getEntityGraphs(Class<T> entityClass)の処理終了

B

0xD172

1

EntityManager#getEntityManagerFactory()の処理開始

B

0xD173

4

EntityManager#getEntityManagerFactory()の処理終了

B

0xD174

1

EntityManager#getLockMode(Object entity)の処理開始

B

0xD175

4

EntityManager#getLockMode(Object entity)の処理終了

B

0xD176

1

EntityManager#getMetamodel()の処理開始

B

0xD177

4

EntityManager#getMetamodel()の処理終了

B

0xD178

1

EntityManager#setProperty(String propertyName, Object value)の処理開始

B

0xD179

4

EntityManager#setProperty(String propertyName, Object value)の処理終了

B

0xD17A

1

EntityManager#getProperties()の処理開始

B

0xD17B

4

EntityManager#getProperties()の処理終了

B

0xD17C

1

EntityManager#isJoinedToTransaction()の処理開始

B

0xD17D

4

EntityManager#isJoinedToTransaction()の処理終了

B

0xD17E

1

EntityManager#isOpen()の処理開始

B

0xD17F

4

EntityManager#isOpen()の処理終了

B

0xD180

1

EntityManager#close()の処理開始

A

0xD181

4

EntityManager#close()の処理終了

A

0xD1F4

2

トランザクションスコープのEntityManagerのAPIを，トランザクションの存在しない状況で利用した際の永続化コンテキストの生成処理開始

A

0xD1F5

3

トランザクションスコープのEntityManagerのAPIを，トランザクションの存在しない状況で利用した際の永続化コンテキストの生成処理終了

A

0xD1F6

5

トランザクションスコープのEntityManagerのAPIを，トランザクションの存在しない状況で利用した際に生成した永続化コンテキストの破棄処理開始

A

0xD1F7

6

トランザクションスコープのEntityManagerのAPIを，トランザクションの存在しない状況で利用した際に生成した永続化コンテキストの破棄処理終了

A

（凡例）A：標準　B：詳細

注※　図8-70中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒70　トランザクションスコープの永続化コンテキストに関連づいているエンティティマネージャをトランザクション外で利用した場合のトレース取得ポイント

(c)　トランザクション外で生成されたQueryをトランザクション外で利用した場合

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒113　トランザクション外で生成されたQueryをトランザクション外で利用した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xD144

1

EntityManager#createQuery(String qlString)の処理開始

A

0xD145

4

EntityManager#createQuery(String qlString)の処理終了

A

0xD146

1

EntityManager#createQuery(CriteriaQuery<T> criteriaQuery)の処理開始

A

0xD147

4

EntityManager#createQuery(CriteriaQuery<T> criteriaQuery)の処理終了

A

0xD148

1

EntityManager#createQuery(CriteriaUpdate updateQuery)の処理開始

A

0xD149

4

EntityManager#createQuery(CriteriaUpdate updateQuery)の処理終了

A

0xD14A

1

EntityManager#createQuery(CriteriaDelete deleteQuery)の処理開始

A

0xD14B

4

EntityManager#createQuery(CriteriaDelete deleteQuery)の処理終了

A

0xD14C

1

EntityManager#createQuery(String qlString, Class<T> resultClass)の処理開始

A

0xD14D

4

EntityManager#createQuery(String qlString, Class<T> resultClass)の処理終了

A

0xD14E

1

EntityManager#createNamedQuery(String name)の処理開始

A

0xD14F

4

EntityManager#createNamedQuery(String name)の処理終了

A

0xD150

1

EntityManager#createNamedQuery(String name, Class<T> resultClass)の処理開始

A

0xD151

4

EntityManager#createNamedQuery(String name, Class<T> resultClass)の処理終了

A

0xD152

1

EntityManager#createNativeQuery(String sqlString)の処理開始

A

0xD153

4

EntityManager#createNativeQuery(String sqlString)の処理終了

A

0xD154

1

EntityManager#createNativeQuery(String sqlString, Class resultClass)の処理開始

A

0xD155

4

EntityManager#createNativeQuery(String sqlString, Class resultClass)の処理終了

A

0xD156

1

EntityManager#createNativeQuery(String sqlString, String resultSetMapping)の処理開始

A

0xD157

4

EntityManager#createNativeQuery(String sqlString, String resultSetMapping)の処理終了

A

0xD158

1

EntityManager#createNamedStoredProcedureQuery(String name)の処理開始

A

0xD159

4

EntityManager#createNamedStoredProcedureQuery(String name)の処理終了

A

0xD15A

1

EntityManager#createStoredProcedureQuery(String procedureName)の処理開始

A

0xD15B

4

EntityManager#createStoredProcedureQuery(String procedureName)の処理終了

A

0xD15C

1

EntityManager#createStoredProcedureQuery(String procedureName, Class... resultClasses)の処理開始

A

0xD15D

4

EntityManager#createStoredProcedureQuery(String procedureName, Class... resultClasses)の処理終了

A

0xD15E

1

EntityManager#createStoredProcedureQuery(String procedureName, String... resultSetMappings)の処理開始

A

0xD15F

4

EntityManager#createStoredProcedureQuery(String procedureName, String... resultSetMappings)の処理終了

A

0xD18E

1，5

Query#executeUpdate()の処理開始

B

0xD18F

4，6

Query#executeUpdate()の処理終了

B

0xD190

1，5

Query#getResultList()の処理開始

B

0xD191

4，6

Query#getResultList()の処理終了

B

0xD192

1，5

Query#getSingleResult()の処理開始

B

0xD193

4，6

Query#getSingleResult()の処理終了

B

0xD194

1，5

Query#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD195

4，6

Query#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD196

1，5

Query#getFlushMode()の処理開始

B

0xD197

4，6

Query#getFlushMode()の処理終了

B

0xD198

1，5

Query#setFirstResult(int startPosition)の処理開始

B

0xD199

4，6

Query#setFirstResult(int startPosition)の処理終了

B

0xD19A

1，5

Query#getFirstResult()の処理開始

B

0xD19B

4，6

Query#getFirstResult()の処理終了

B

0xD19C

1，5

Query#setMaxResults(int maxResult)の処理開始

B

0xD19D

4，6

Query#setMaxResults(int maxResult)の処理終了

B

0xD19E

1，5

Query#getMaxResults()の処理開始

B

0xD19F

4，6

Query#getMaxResults()の処理終了

B

0xD1A0

1，5

Query#setHint(String hintName, Object value)の処理開始

B

0xD1A1

4，6

Query#setHint(String hintName, Object value)の処理終了

B

0xD1A2

1，5

Query#getHints()の処理開始

B

0xD1A3

4，6

Query#getHints()の処理終了

B

0xD1A4

1，5

Query#setParameter(int position, Calendar value, TemporalType temporalType)の処理開始

B

0xD1A5

4，6

Query#setParameter(int position, Calendar value, TemporalType temporalType)の処理終了

B

0xD1A6

1，5

Query#setParameter(int position, Date value, TemporalType temporalType)の処理開始

B

0xD1A7

4，6

Query#setParameter(int position, Date value, TemporalType temporalType)の処理終了

B

0xD1A8

1，5

Query#setParameter(int position, Object value)の処理開始

B

0xD1A9

4，6

Query#setParameter(int position, Object value)の処理終了

B

0xD1AA

1，5

Query#setParameter(String name, Calendar value, TemporalType temporalType)の処理開始

B

0xD1AB

4，6

Query#setParameter(String name, Calendar value, TemporalType temporalType)の処理終了

B

0xD1AC

1，5

Query#setParameter(String name, Date value, TemporalType temporalType)の処理開始

B

0xD1AD

4，6

Query#setParameter(String name, Date value, TemporalType temporalType)の処理終了

B

0xD1AE

1，5

Query#setParameter(String name, Object value)の処理開始

B

0xD1AF

4，6

Query#setParameter(String name, Object value)の処理終了

B

0xD1B0

1，5

Query#setParameter(Parameter<T> param, T value)の処理開始

B

0xD1B1

4，6

Query#setParameter(Parameter<T> param, T value)の処理終了

B

0xD1B2

1，5

Query#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理開始

B

0xD1B3

4，6

Query#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理終了

B

0xD1B4

1，5

Query#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理開始

B

0xD1B5

4，6

Query#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理終了

B

0xD1B6

1，5

Query#getParameters()の処理開始

B

0xD1B7

4，6

Query#getParameters()の処理終了

B

0xD1B8

1，5

Query#getParameter(String name)の処理開始

B

0xD1B9

4，6

Query#getParameter(String name)の処理終了

B

0xD1BA

1，5

Query#getParameter(String name, Class<T> type)の処理開始

B

0xD1BB

4，6

Query#getParameter(String name, Class<T> type)の処理終了

B

0xD1BC

1，5

Query#getParameter(int position)の処理開始

B

0xD1BD

4，6

Query#getParameter(int position)の処理終了

B

0xD1BE

1，5

Query#getParameter(int position, Class<T> type)の処理開始

B

0xD1BF

4，6

Query#getParameter(int position, Class<T> type)の処理終了

B

0xD1C0

1，5

Query#isBound(Parameter<?> param)の処理開始

B

0xD1C1

4，6

Query#isBound(Parameter<?> param)の処理終了

B

0xD1C2

1，5

Query#getParameterValue(Parameter<T> param)の処理開始

B

0xD1C3

4，6

Query#getParameterValue(Parameter<T> param)の処理終了

B

0xD1C4

1，5

Query#getParameterValue(String name)の処理開始

B

0xD1C5

4，6

Query#getParameterValue(String name)の処理終了

B

0xD1C6

1，5

Query#getParameterValue(int position)の処理開始

B

0xD1C7

4，6

Query#getParameterValue(int position)の処理終了

B

0xD1C8

1，5

Query#setLockMode(LockModeType lockMode)の処理開始

B

0xD1C9

4，6

Query#setLockMode(LockModeType lockMode)の処理終了

B

0xD1CA

1，5

Query#getLockMode()の処理開始

B

0xD1CB

4，6

Query#getLockMode()の処理終了

B

0xD1CC

1，5

Query#unwrap(Class<T> cls)の処理開始

B

0xD1CD

4，6

Query#unwrap(Class<T> cls)の処理終了

B

0xD1CE

1，5

TypedQuery#executeUpdate()の処理開始

B

0xD1CF

4，6

TypedQuery#executeUpdate()の処理終了

B

0xD1D0

1，5

TypedQuery#getResultList()の処理開始

B

0xD1D1

4，6

TypedQuery#getResultList()の処理終了

B

0xD1D2

1，5

TypedQuery#getSingleResult()の処理開始

B

0xD1D3

4，6

TypedQuery#getSingleResult()の処理終了

B

0xD1D4

1，5

TypedQuery#setMaxResults(int maxResult)の処理開始

B

0xD1D5

4，6

TypedQuery#setMaxResults(int maxResult)の処理終了

B

0xD1D6

1，5

TypedQuery#setFirstResult(int startPosition)の処理開始

B

0xD1D7

4，6

TypedQuery#setFirstResult(int startPosition)の処理終了

B

0xD1D8

1，5

TypedQuery#setHint(String hintName, Object value)の処理開始

B

0xD1D9

4，6

TypedQuery#setHint(String hintName, Object value)の処理終了

B

0xD1DA

1，5

TypedQuery#setParameter(Parameter<T> param, T value)の処理開始

B

0xD1DB

4，6

TypedQuery#setParameter(Parameter<T> param, T value)の処理終了

B

0xD1DC

1，5

TypedQuery#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理開始

B

0xD1DD

4，6

TypedQuery#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理終了

B

0xD1DE

1，5

TypedQuery#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理開始

B

0xD1DF

4，6

TypedQuery#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理終了

B

0xD1E0

1，5

TypedQuery#setParameter(String name, Object value)の処理開始

B

0xD1E1

4，6

TypedQuery#setParameter(String name, Object value)の処理終了

B

0xD1E2

1，5

TypedQuery#setParameter(String name, Calendar value, TemporalType temporalType)の処理開始

B

0xD1E3

4，6

TypedQuery#setParameter(String name, Calendar value, TemporalType temporalType)の処理終了

B

0xD1E4

1，5

TypedQuery#setParameter(String name, Date value, TemporalType temporalType)の処理開始

B

0xD1E5

4，6

TypedQuery#setParameter(String name, Date value, TemporalType temporalType)の処理終了

B

0xD1E6

1，5

TypedQuery#setParameter(int position, Object value)の処理開始

B

0xD1E7

4，6

TypedQuery#setParameter(int position, Object value)の処理終了

B

0xD1E8

1，5

TypedQuery#setParameter(int position, Calendar value, TemporalType temporalType)の処理開始

B

0xD1E9

4，6

TypedQuery#setParameter(int position, Calendar value, TemporalType temporalType)の処理終了

B

0xD1EA

1，5

TypedQuery#setParameter(int position, Date value, TemporalType temporalType)の処理開始

B

0xD1EB

4，6

TypedQuery#setParameter(int position, Date value, TemporalType temporalType)の処理終了

B

0xD1EC

1，5

TypedQuery#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD1ED

4，6

TypedQuery#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD1EE

1，5

TypedQuery#setLockMode(LockModeType lockMode)の処理開始

B

0xD1EF

4，6

TypedQuery#setLockMode(LockModeType lockMode)の処理終了

B

0xD1F4

2

トランザクションスコープのEntityManagerのAPIを，トランザクションの存在しない状況で利用した際の永続化コンテキストの生成処理開始

A

0xD1F5

3

トランザクションスコープのEntityManagerのAPIを，トランザクションの存在しない状況で利用した際の永続化コンテキストの生成処理終了

A

0xD1F6

7

トランザクションスコープのEntityManagerのAPIを，トランザクションの存在しない状況で利用した際の永続化コンテキストの破棄処理開始

A

0xD1F7

8

トランザクションスコープのEntityManagerのAPIを，トランザクションの存在しない状況で利用した際の永続化コンテキストの破棄処理終了

A

（凡例）A：標準　B：詳細

注※　図8-71中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒71　トランザクション外で生成されたQueryをトランザクション外で利用した場合のトレース取得ポイント

(d)　拡張永続化コンテキストを利用した場合

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒114　拡張永続化コンテキストを利用した場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xD11C

3

EntityManager#find(Class<T> entityClass, Object primaryKey)の処理開始

B

0xD11D

4

EntityManager#find(Class<T> entityClass, Object primaryKey)の処理終了

B

0xD11E

3

EntityManager#find(Class<T> entityClass, Object primaryKey, Map<String, Object> properties)の処理開始

B

0xD11F

4

EntityManager#find(Class<T> entityClass, Object primaryKey, Map<String, Object> properties)の処理終了

B

0xD120

3

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)の処理開始

B

0xD121

4

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)の処理終了

B

0xD122

3

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String, Object> properties)の処理開始

B

0xD123

4

EntityManager#find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String, Object> properties)の処理終了

B

0xD124

3

EntityManager#getReference(Class<T> entityClass, Object primaryKey)の処理開始

B

0xD125

4

EntityManager#getReference(Class<T> entityClass, Object primaryKey)の処理終了

B

0xD126

3

EntityManager#contains(Object entity)の処理開始

B

0xD127

4

EntityManager#contains(Object entity)の処理終了

B

0xD128

3

EntityManager#lock(Object entity, LockModeType lockMode)の処理開始

B

0xD129

4

EntityManager#lock(Object entity, LockModeType lockMode)の処理終了

B

0xD12A

3

EntityManager#lock(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理開始

B

0xD12B

4

EntityManager#lock(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理終了

B

0xD12C

3

EntityManager#merge(T entity)の処理開始

B

0xD12D

4

EntityManager#merge(T entity)の処理終了

B

0xD12E

3

EntityManager#persist(Object entity)の処理開始

B

0xD12F

4

EntityManager#persist(Object entity)の処理終了

B

0xD130

3

EntityManager#refresh(Object entity)の処理開始

B

0xD131

4

EntityManager#refresh(Object entity)の処理終了

B

0xD132

3

EntityManager#refresh(Object entity, Map<String,Object> properties)の処理開始

B

0xD133

4

EntityManager#refresh(Object entity, Map<String,Object> properties)の処理終了

B

0xD134

3

EntityManager#refresh(Object entity, LockModeType lockMode)の処理開始

B

0xD135

4

EntityManager#refresh(Object entity, LockModeType lockMode)の処理終了

B

0xD136

3

EntityManager#refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理開始

B

0xD137

4

EntityManager#refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)の処理終了

B

0xD138

3

EntityManager#remove(Object entity)の処理開始

B

0xD139

4

EntityManager#remove(Object entity)の処理終了

B

0xD13A

3

EntityManager#clear()の処理開始

B

0xD13B

4

EntityManager#clear()の処理終了

B

0xD13C

3

EntityManager#flush()の処理開始

B

0xD13D

4

EntityManager#flush()の処理終了

B

0xD13E

3

EntityManager#detach(Object entity)の処理開始

B

0xD13F

4

EntityManager#detach(Object entity)の処理終了

B

0xD140

3

EntityManager#createEntityGraph(Class<T> rootType)の処理開始

B

0xD141

4

EntityManager#createEntityGraph(Class<T> rootType)の処理終了

B

0xD142

3

EntityManager#createEntityGraph(String graphName)の処理開始

B

0xD143

4

EntityManager#createEntityGraph(String graphName)の処理終了

B

0xD144

3

EntityManager#createQuery(String qlString)の処理開始

A

0xD145

4

EntityManager#createQuery(String qlString)の処理終了

A

0xD146

3

EntityManager#createQuery(CriteriaQuery<T> criteriaQuery)の処理開始

A

0xD147

4

EntityManager#createQuery(CriteriaQuery<T> criteriaQuery)の処理終了

A

0xD148

3

EntityManager#createQuery(CriteriaUpdate updateQuery)の処理開始

A

0xD149

4

EntityManager#createQuery(CriteriaUpdate updateQuery)の処理終了

A

0xD14A

3

EntityManager#createQuery(CriteriaDelete deleteQuery)の処理開始

A

0xD14B

4

EntityManager#createQuery(CriteriaDelete deleteQuery)の処理終了

A

0xD14C

3

EntityManager#createQuery(String qlString, Class<T> resultClass)の処理開始

A

0xD14D

4

EntityManager#createQuery(String qlString, Class<T> resultClass)の処理終了

A

0xD14E

3

EntityManager#createNamedQuery(String name)の処理開始

A

0xD14F

4

EntityManager#createNamedQuery(String name)の処理終了

A

0xD150

3

EntityManager#createNamedQuery(String name, Class<T> resultClass)の処理開始

A

0xD151

4

EntityManager#createNamedQuery(String name, Class<T> resultClass)の処理終了

A

0xD152

3

EntityManager#createNativeQuery(String sqlString)の処理開始

A

0xD153

4

EntityManager#createNativeQuery(String sqlString)の処理終了

A

0xD154

3

EntityManager#createNativeQuery(String sqlString, Class resultClass)の処理開始

A

0xD155

4

EntityManager#createNativeQuery(String sqlString, Class resultClass)の処理終了

A

0xD156

3

EntityManager#createNativeQuery(String sqlString, String resultSetMapping)の処理開始

A

0xD157

4

EntityManager#createNativeQuery(String sqlString, String resultSetMapping)の処理終了

A

0xD158

3

EntityManager#createNamedStoredProcedureQuery(String name)の処理開始

A

0xD159

4

EntityManager#createNamedStoredProcedureQuery(String name)の処理終了

A

0xD15A

3

EntityManager#createStoredProcedureQuery(String procedureName)の処理開始

A

0xD15B

4

EntityManager#createStoredProcedureQuery(String procedureName)の処理終了

A

0xD15C

3

EntityManager#createStoredProcedureQuery(String procedureName, Class... resultClasses)の処理開始

A

0xD15D

4

EntityManager#createStoredProcedureQuery(String procedureName, Class... resultClasses)の処理終了

A

0xD15E

3

EntityManager#createStoredProcedureQuery(String procedureName, String... resultSetMappings)の処理開始

A

0xD15F

4

EntityManager#createStoredProcedureQuery(String procedureName, String... resultSetMappings)の処理終了

A

0xD160

3

EntityManager#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD161

4

EntityManager#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD162

3

EntityManager#getFlushMode()の処理開始

B

0xD163

4

EntityManager#getFlushMode()の処理終了

B

0xD164

3

EntityManager#joinTransaction()の処理開始

B

0xD165

4

EntityManager#joinTransaction()の処理終了

B

0xD166

3

EntityManager#getTransaction()の処理開始

B

0xD167

4

EntityManager#getTransaction()の処理終了

B

0xD168

3

EntityManager#getDelegate()の処理開始

B

0xD169

4

EntityManager#getDelegate()の処理終了

B

0xD16A

3

EntityManager#unwrap(Class<T> cls)の処理開始

B

0xD16B

4

EntityManager#unwrap(Class<T> cls)の処理終了

B

0xD16C

3

EntityManager#getCriteriaBuilder()の処理開始

B

0xD16D

4

EntityManager#getCriteriaBuilder()の処理終了

B

0xD16E

3

EntityManager#getEntityGraph(String graphName)の処理開始

B

0xD16F

4

EntityManager#getEntityGraph(String graphName)の処理終了

B

0xD170

3

EntityManager#getEntityGraphs(Class<T> entityClass)の処理開始

B

0xD171

4

EntityManager#getEntityGraphs(Class<T> entityClass)の処理終了

B

0xD172

3

EntityManager#getEntityManagerFactory()の処理開始

B

0xD173

4

EntityManager#getEntityManagerFactory()の処理終了

B

0xD174

3

EntityManager#getLockMode(Object entity)の処理開始

B

0xD175

4

EntityManager#getLockMode(Object entity)の処理終了

B

0xD176

3

EntityManager#getMetamodel()の処理開始

B

0xD177

4

EntityManager#getMetamodel()の処理終了

B

0xD178

3

EntityManager#setProperty(String propertyName, Object value)の処理開始

B

0xD179

4

EntityManager#setProperty(String propertyName, Object value)の処理終了

B

0xD17A

3

EntityManager#getProperties()の処理開始

B

0xD17B

4

EntityManager#getProperties()の処理終了

B

0xD17C

3

EntityManager#isJoinedToTransaction()の処理開始

B

0xD17D

4

EntityManager#isJoinedToTransaction()の処理終了

B

0xD17E

3

EntityManager#isOpen()の処理開始

B

0xD17F

4

EntityManager#isOpen()の処理終了

B

0xD180

3

EntityManager#close()の処理開始

A

0xD181

4

EntityManager#close()の処理終了

A

0xD18E

3

Query#executeUpdate()の処理開始

B

0xD18F

4

Query#executeUpdate()の処理終了

B

0xD190

3

Query#getResultList()の処理開始

B

0xD191

4

Query#getResultList()の処理終了

B

0xD192

3

Query#getSingleResult()の処理開始

B

0xD193

4

Query#getSingleResult()の処理終了

B

0xD194

3

Query#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD195

4

Query#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD196

3

Query#getFlushMode()の処理開始

B

0xD197

4

Query#getFlushMode()の処理終了

B

0xD198

3

Query#setFirstResult(int startPosition)の処理開始

B

0xD199

4

Query#setFirstResult(int startPosition)の処理終了

B

0xD19A

3

Query#getFirstResult()の処理開始

B

0xD19B

4

Query#getFirstResult()の処理終了

B

0xD19C

3

Query#setMaxResults(int maxResult)の処理開始

B

0xD19D

4

Query#setMaxResults(int maxResult)の処理終了

B

0xD19E

3

Query#getMaxResults()の処理開始

B

0xD19F

4

Query#getMaxResults()の処理終了

B

0xD1A0

3

Query#setHint(String hintName, Object value)の処理開始

B

0xD1A1

4

Query#setHint(String hintName, Object value)の処理終了

B

0xD1A2

3

Query#getHints()の処理開始

B

0xD1A3

4

Query#getHints()の処理終了

B

0xD1A4

3

Query#setParameter(int position, Calendar value, TemporalType temporalType)の処理開始

B

0xD1A5

4

Query#setParameter(int position, Calendar value, TemporalType temporalType)の処理終了

B

0xD1A6

3

Query#setParameter(int position, Date value, TemporalType temporalType)の処理開始

B

0xD1A7

4

Query#setParameter(int position, Date value, TemporalType temporalType)の処理終了

B

0xD1A8

3

Query#setParameter(int position, Object value)の処理開始

B

0xD1A9

4

Query#setParameter(int position, Object value)の処理終了

B

0xD1AA

3

Query#setParameter(String name, Calendar value, TemporalType temporalType)の処理開始

B

0xD1AB

4

Query#setParameter(String name, Calendar value, TemporalType temporalType)の処理終了

B

0xD1AC

3

Query#setParameter(String name, Date value, TemporalType temporalType)の処理開始

B

0xD1AD

4

Query#setParameter(String name, Date value, TemporalType temporalType)の処理終了

B

0xD1AE

3

Query#setParameter(String name, Object value)の処理開始

B

0xD1AF

4

Query#setParameter(String name, Object value)の処理終了

B

0xD1B0

3

Query#setParameter(Parameter<T> param, T value)の処理開始

B

0xD1B1

4

Query#setParameter(Parameter<T> param, T value)の処理終了

B

0xD1B2

3

Query#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理開始

B

0xD1B3

4

Query#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理終了

B

0xD1B4

3

Query#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理開始

B

0xD1B5

4

Query#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理終了

B

0xD1B6

3

Query#getParameters()の処理開始

B

0xD1B7

4

Query#getParameters()の処理終了

B

0xD1B8

3

Query#getParameter(String name)の処理開始

B

0xD1B9

4

Query#getParameter(String name)の処理終了

B

0xD1BA

3

Query#getParameter(String name, Class<T> type)の処理開始

B

0xD1BB

4

Query#getParameter(String name, Class<T> type)の処理終了

B

0xD1BC

3

Query#getParameter(int position)の処理開始

B

0xD1BD

4

Query#getParameter(int position)の処理終了

B

0xD1BE

3

Query#getParameter(int position, Class<T> type)の処理開始

B

0xD1BF

4

Query#getParameter(int position, Class<T> type)の処理終了

B

0xD1C0

3

Query#isBound(Parameter<?> param)の処理開始

B

0xD1C1

4

Query#isBound(Parameter<?> param)の処理終了

B

0xD1C2

3

Query#getParameterValue(Parameter<T> param)の処理開始

B

0xD1C3

4

Query#getParameterValue(Parameter<T> param)の処理終了

B

0xD1C4

3

Query#getParameterValue(String name)の処理開始

B

0xD1C5

4

Query#getParameterValue(String name)の処理終了

B

0xD1C6

3

Query#getParameterValue(int position)の処理開始

B

0xD1C7

4

Query#getParameterValue(int position)の処理終了

B

0xD1C8

3

Query#setLockMode(LockModeType lockMode)の処理開始

B

0xD1C9

4

Query#setLockMode(LockModeType lockMode)の処理終了

B

0xD1CA

3

Query#getLockMode()の処理開始

B

0xD1CB

4

Query#getLockMode()の処理終了

B

0xD1CC

3

Query#unwrap(Class<T> cls)の処理開始

B

0xD1CD

4

Query#unwrap(Class<T> cls)の処理終了

B

0xD1CE

3

TypedQuery#executeUpdate()の処理開始

B

0xD1CF

4

TypedQuery#executeUpdate()の処理終了

B

0xD1D0

3

TypedQuery#getResultList()の処理開始

B

0xD1D1

4

TypedQuery#getResultList()の処理終了

B

0xD1D2

3

TypedQuery#getSingleResult()の処理開始

B

0xD1D3

4

TypedQuery#getSingleResult()の処理終了

B

0xD1D4

3

TypedQuery#setMaxResults(int maxResult)の処理開始

B

0xD1D5

4

TypedQuery#setMaxResults(int maxResult)の処理終了

B

0xD1D6

3

TypedQuery#setFirstResult(int startPosition)の処理開始

B

0xD1D7

4

TypedQuery#setFirstResult(int startPosition)の処理終了

B

0xD1D8

3

TypedQuery#setHint(String hintName, Object value)の処理開始

B

0xD1D9

4

TypedQuery#setHint(String hintName, Object value)の処理終了

B

0xD1DA

3

TypedQuery#setParameter(Parameter<T> param, T value)の処理開始

B

0xD1DB

4

TypedQuery#setParameter(Parameter<T> param, T value)の処理終了

B

0xD1DC

3

TypedQuery#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理開始

B

0xD1DD

4

TypedQuery#setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)の処理終了

B

0xD1DE

3

TypedQuery#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理開始

B

0xD1DF

4

TypedQuery#setParameter(Parameter<Date> param, Date value, TemporalType temporalType)の処理終了

B

0xD1E0

3

TypedQuery#setParameter(String name, Object value)の処理開始

B

0xD1E1

4

TypedQuery#setParameter(String name, Object value)の処理終了

B

0xD1E2

3

TypedQuery#setParameter(String name, Calendar value, TemporalType temporalType)の処理開始

B

0xD1E3

4

TypedQuery#setParameter(String name, Calendar value, TemporalType temporalType)の処理終了

B

0xD1E4

3

TypedQuery#setParameter(String name, Date value, TemporalType temporalType)の処理開始

B

0xD1E5

4

TypedQuery#setParameter(String name, Date value, TemporalType temporalType)の処理終了

B

0xD1E6

3

TypedQuery#setParameter(int position, Object value)の処理開始

B

0xD1E7

4

TypedQuery#setParameter(int position, Object value)の処理終了

B

0xD1E8

3

TypedQuery#setParameter(int position, Calendar value, TemporalType temporalType)の処理開始

B

0xD1E9

4

TypedQuery#setParameter(int position, Calendar value, TemporalType temporalType)の処理終了

B

0xD1EA

3

TypedQuery#setParameter(int position, Date value, TemporalType temporalType)の処理開始

B

0xD1EB

4

TypedQuery#setParameter(int position, Date value, TemporalType temporalType)の処理終了

B

0xD1EC

3

TypedQuery#setFlushMode(FlushModeType flushMode)の処理開始

B

0xD1ED

4

TypedQuery#setFlushMode(FlushModeType flushMode)の処理終了

B

0xD1EE

3

TypedQuery#setLockMode(LockModeType lockMode)の処理開始

B

0xD1EF

4

TypedQuery#setLockMode(LockModeType lockMode)の処理終了

B

0xD1FC

1

拡張スコープの永続化コンテキストを利用した際の永続化コンテキストの生成処理開始

A

0xD1FD

2

拡張スコープの永続化コンテキストを利用した際の永続化コンテキストの生成処理終了

A

0xD1FE

5

拡張スコープの永続化コンテキストを利用した際のEntityManager.close()の処理開始

A

0xD1FF

6

拡張スコープの永続化コンテキストを利用した際のEntityManager.close()の処理終了

A

（凡例）A：標準　B：詳細

注※　図8-72中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒72　拡張永続化コンテキストを利用した場合のトレース取得ポイント

(2)　取得できるトレース情報

(a)　トランザクションスコープの永続化コンテキストをトランザクション内で利用した場合

トランザクションスコープの永続化コンテキストをトランザクション内で利用した場合に取得できるトレース情報を次の表に示します。

表8‒115　トランザクションスコープの永続化コンテキストをトランザクション内で利用した場合に取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1，5

0xD11C

B

entityのクラス名

−

−

0xD11E

B

entityClassのクラス名

−

−

0xD120

B

entityClassのクラス名

−

−

0xD122

B

entityClassのクラス名

−

−

0xD124

B

entityのクラス名

−

−

0xD126

B

entityのクラス名

−

−

0xD128

B

entityのクラス名

lockModeの値

−

0xD12A

B

entityのクラス名

lockModeの値

−

0xD12C

B

entityのクラス名

−

−

0xD12E

B

entityのクラス名

−

−

0xD130

B

entityのクラス名

−

−

0xD132

B

entityのクラス名

−

−

0xD134

B

entityのクラス名

−

−

0xD136

B

entityのクラス名

−

−

0xD138

B

entityのクラス名

−

−

0xD13A

B

−

−

−

0xD13C

B

−

−

−

0xD13E

B

entityのクラス名

−

−

0xD140

B

rootTyoeのクラス名

−

−

0xD142

B

graphNameの値

−

−

0xD144

A

−

−

−

0xD146

A

−

−

−

0xD148

A

−

−

−

0xD14A

A

−

−

−

0xD14C

A

−

−

−

0xD14E

A

nameの値

−

−

0xD150

A

nameの値

−

−

0xD152

A

−

−

−

0xD154

A

resultClassのクラス名

−

−

0xD156

A

resultSetMapping

−

−

0xD158

A

nameの値

−

−

0xD15A

A

procedureNameの値

−

−

0xD15C

A

procedureNameの値

−

−

0xD15E

A

procedureNameの値

−

−

0xD160

B

flushModeの値

−

−

0xD162

B

−

−

−

0xD164

B

−

−

−

0xD166

B

−

−

−

0xD168

B

−

−

−

0xD16A

B

clsのクラス名

−

−

0xD16C

B

−

−

−

0xD16E

B

graphNameの値

−

−

0xD170

B

entityClassのクラス名

−

−

0xD172

B

−

−

−

0xD174

B

entityのクラス名

−

−

0xD176

B

−

−

−

0xD178

B

propertyNameの値

−

−

0xD17A

B

−

−

−

0xD17C

B

−

−

−

0xD17E

B

−

−

−

0xD180

A

−

−

−

0xD18E

B

−

−

−

0xD190

B

−

−

−

0xD192

B

−

−

−

0xD194

B

flushModeの値

−

−

0xD196

B

−

−

−

0xD198

B

startPositionの値

−

−

0xD19A

B

−

−

−

0xD19C

B

maxResultの値

−

−

0xD19E

B

−

−

−

0xD1A0

B

hintName

valueのクラス名

−

0xD1A2

B

−

−

−

0xD1A4

B

positionの値

−

−

0xD1A6

B

positionの値

−

−

0xD1A8

B

positionの値

−

−

0xD1AA

B

nameの値

−

−

0xD1AC

B

nameの値

−

−

0xD1AE

B

nameの値

−

−

0xD1B0

B

−

−

−

0xD1B2

B

−

−

−

0xD1B4

B

−

−

−

0xD1B6

B

−

−

−

0xD1B8

B

nameの値

−

−

0xD1BA

B

nameの値

−

−

0xD1BC

B

positionの値

−

−

0xD1BE

B

positionの値

−

−

0xD1C0

B

−

−

−

0xD1C2

B

−

−

−

0xD1C4

B

nameの値

−

−

0xD1C6

B

positionの値

−

−

0xD1C8

B

−

−

−

0xD1CA

B

−

−

−

0xD1CC

B

−

−

−

0xD1CE

B

−

−

−

0xD1D0

B

−

−

−

0xD1D2

B

−

−

−

0xD1D4

B

maxResultの値

−

−

0xD1D6

B

startPositionの値

−

−

0xD1D8

B

hintName

valueのクラス名

−

0xD1DA

B

−

−

−

0xD1DC

B

−

−

−

0xD1DE

B

−

−

−

0xD1E0

B

nameの値

−

−

0xD1E2

B

nameの値

−

−

0xD1E4

B

nameの値

−

−

0xD1E6

B

positionの値

−

−

0xD1E8

B

positionの値

−

−

0xD1EA

B

positionの値

−

−

0xD1EC

B

flushModeの値

−

−

0xD1EE

B

−

−

−

2

0xD1F0

A

−

−

−

3

0xD1F1

A

−

−

※2

4，6

0xD11D

B

−

−

※2

0xD11F

B

−

−

※2

0xD121

B

−

−

※2

0xD123

B

−

−

※2

0xD125

B

−

−

※2

0xD127

B

−

−

※2

0xD129

B

−

−

※2

0xD12B

B

−

−

※2

0xD12D

B

−

−

※2

0xD12F

B

−

−

※2

0xD131

B

−

−

※2

0xD133

B

−

−

※2

0xD135

B

−

−

※2

0xD137

B

−

−

※2

0xD139

B

−

−

※2

0xD13B

B

−

−

※2

0xD13D

B

−

−

※2

0xD13F

B

−

−

※2

0xD141

B

−

−

※2

0xD143

B

−

−

※2

0xD145

A

−

−

※2

0xD147

A

−

−

※2

0xD149

A

−

−

※2

0xD14B

A

−

−

※2

0xD14D

A

−

−

※2

0xD14F

A

−

−

※2

0xD151

A

−

−

※2

0xD153

A

−

−

※2

0xD155

A

−

−

※2

0xD157

A

−

−

※2

0xD159

A

−

−

※2

0xD15B

A

−

−

※2

0xD15D

A

−

−

※2

0xD15F

A

−

−

※2

0xD161

B

−

−

※2

0xD163

B

−

−

※2

0xD165

B

−

−

※2

0xD167

B

−

−

※2

0xD169

B

−

−

※2

0xD16B

B

−

−

※2

0xD16D

B

−

−

※2

0xD16F

B

−

−

※2

0xD171

B

−

−

※2

0xD173

B

−

−

※2

0xD175

B

−

−

※2

0xD177

B

−

−

※2

0xD179

B

−

−

※2

0xD17B

B

−

−

※2

0xD17D

B

−

−

※2

0xD17F

B

−

−

※2

0xD181

A

−

−

※2

0xD18F

B

−

−

※2

0xD191

B

−

−

※2

0xD193

B

−

−

※2

0xD195

B

−

−

※2

0xD197

B

−

−

※2

0xD199

B

−

−

※2

0xD19B

B

−

−

※2

0xD19D

B

−

−

※2

0xD19F

B

−

−

※2

0xD1A1

B

−

−

※2

0xD1A3

B

−

−

※2

0xD1A5

B

−

−

※2

0xD1A7

B

−

−

※2

0xD1A9

B

−

−

※2

0xD1AB

B

−

−

※2

0xD1AD

B

−

−

※2

0xD1AF

B

−

−

※2

0xD1B1

B

−

−

※2

0xD1B3

B

−

−

※2

0xD1B5

B

−

−

※2

0xD1B7

B

−

−

※2

0xD1B9

B

−

−

※2

0xD1BB

B

−

−

※2

0xD1BD

B

−

−

※2

0xD1BF

B

−

−

※2

0xD1C1

B

−

−

※2

0xD1C3

B

−

−

※2

0xD1C5

B

−

−

※2

0xD1C7

B

−

−

※2

0xD1C9

B

−

−

※2

0xD1CB

B

−

−

※2

0xD1CD

B

−

−

※2

0xD1CF

B

−

−

※2

0xD1D1

B

−

−

※2

0xD1D3

B

−

−

※2

0xD1D5

B

−

−

※2

0xD1D7

B

−

−

※2

0xD1D9

B

−

−

※2

0xD1DB

B

−

−

※2

0xD1DD

B

−

−

※2

0xD1DF

B

−

−

※2

0xD1E1

B

−

−

※2

0xD1E3

B

−

−

※2

0xD1E5

B

−

−

※2

0xD1E7

B

−

−

※2

0xD1E9

B

−

−

※2

0xD1EB

B

−

−

※2

0xD1ED

B

−

−

※2

0xD1EF

B

−

−

※2

7

0xD1F2

A

−

−

−

8

0xD1F3

A

−

−

※2

（凡例）A：標準　B：詳細　−：該当なし

注※1　図8-69中の番号と対応しています。

注※2　正常に処理された場合，入り口時刻が表示されます。例外が発生した場合，入り口時刻と例外が表示されます。

(b)　トランザクションスコープの永続化コンテキストに関連づいているエンティティマネージャをトランザクション外で利用した場合

トランザクションスコープの永続化コンテキストに関連づいているエンティティマネージャをトランザクション外で利用した場合に取得できるトレース情報を次の表に示します。

表8‒116　トランザクションスコープの永続化コンテキストに関連づいているエンティティマネージャをトランザクション外で利用した場合に取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xD11C

B

entityのクラス名

−

−

0xD11E

B

entityClassのクラス名

−

−

0xD120

B

entityClassのクラス名

−

−

0xD122

B

entityClassのクラス名

−

−

0xD124

B

entityのクラス名

−

−

0xD126

B

entityのクラス名

−

−

0xD128

B

entityのクラス名

lockModeの値

−

0xD12A

B

entityのクラス名

lockModeの値

−

0xD12C

B

entityのクラス名

−

−

0xD12E

B

entityのクラス名

−

−

0xD130

B

entityのクラス名

−

−

0xD132

B

entityのクラス名

−

−

0xD134

B

entityのクラス名

−

−

0xD136

B

entityのクラス名

−

−

0xD138

B

entityのクラス名

−

−

0xD13A

B

−

−

−

0xD13C

B

−

−

−

0xD13E

B

entityのクラス名

−

−

0xD140

B

rootTyoeのクラス名

−

−

0xD142

B

graphNameの値

−

−

0xD160

B

flushModeの値

−

−

0xD162

B

−

−

−

0xD164

B

−

−

−

0xD166

B

−

−

−

0xD168

B

−

−

−

0xD16A

B

clsのクラス名

−

−

0xD16C

B

−

−

−

0xD16E

B

graphNameの値

−

−

0xD170

B

entityClassのクラス名

−

−

0xD172

B

−

−

−

0xD174

B

entityのクラス名

−

−

0xD176

B

−

−

−

0xD178

B

propertyNameの値

−

−

0xD17A

B

−

−

−

0xD17C

B

−

−

−

0xD17E

B

−

−

−

0xD180

A

−

−

−

2

0xD1F4

A

−

−

−

3

0xD1F5

A

−

−

※2

4

0xD11D

B

−

−

※2

0xD11F

B

−

−

※2

0xD121

B

−

−

※2

0xD123

B

−

−

※2

0xD125

B

−

−

※2

0xD127

B

−

−

※2

0xD129

B

−

−

※2

0xD12B

B

−

−

※2

0xD12D

B

−

−

※2

0xD12F

B

−

−

※2

0xD131

B

−

−

※2

0xD133

B

−

−

※2

0xD135

B

−

−

※2

0xD137

B

−

−

※2

0xD139

B

−

−

※2

0xD13B

B

−

−

※2

0xD13D

B

−

−

※2

0xD13F

B

−

−

※2

0xD141

B

−

−

※2

0xD143

B

−

−

※2

0xD161

B

−

−

※2

0xD163

B

−

−

※2

0xD165

B

−

−

※2

0xD167

B

−

−

※2

0xD169

B

−

−

※2

0xD16B

B

−

−

※2

0xD16D

B

−

−

※2

0xD16F

B

−

−

※2

0xD171

B

−

−

※2

0xD173

B

−

−

※2

0xD175

B

−

−

※2

0xD177

B

−

−

※2

0xD179

B

−

−

※2

0xD17B

B

−

−

※2

0xD17D

B

−

−

※2

0xD17F

B

−

−

※2

0xD181

A

−

−

※2

5

0xD1F6

A

−

−

−

6

0xD1F7

A

−

−

※2

（凡例）A：標準　B：詳細　−：該当なし

注※1　図8-70中の番号と対応しています。

注※2　正常に処理された場合，入り口時刻が表示されます。例外が発生した場合，入り口時刻と例外が表示されます。

(c)　トランザクション外で生成されたQueryをトランザクション外で利用した場合

トランザクション外で生成されたQueryをトランザクション外で利用した場合に取得できるトレース情報を次の表に示します。

表8‒117　トランザクション外で生成されたQueryをトランザクション外で利用した場合に取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xD144

A

−

−

−

0xD146

A

−

−

−

0xD148

A

−

−

−

0xD14A

A

−

−

−

0xD14C

A

−

−

−

0xD14E

A

nameの値

−

−

0xD150

A

nameの値

−

−

0xD152

A

−

−

−

0xD154

A

resultClassのクラス名

−

−

0xD156

A

resultSetMapping

−

−

0xD158

A

nameの値

−

−

0xD15A

A

procedureNameの値

−

−

0xD15C

A

procedureNameの値

−

−

0xD15E

A

procedureNameの値

−

−

1，5

0xD18E

B

−

−

−

0xD190

B

−

−

−

0xD192

B

−

−

−

0xD194

B

flushModeの値

−

−

0xD196

B

−

−

−

0xD198

B

startPositionの値

−

−

0xD19A

B

−

−

−

0xD19C

B

maxResultの値

−

−

0xD19E

B

−

−

−

0xD1A0

B

hintName

valueのクラス名

−

0xD1A2

B

−

−

−

0xD1A4

B

positionの値

−

−

0xD1A6

B

positionの値

−

−

0xD1A8

B

positionの値

−

−

0xD1AA

B

nameの値

−

−

0xD1AC

B

nameの値

−

−

0xD1AE

B

nameの値

−

−

0xD1B0

B

−

−

−

0xD1B2

B

−

−

−

0xD1B4

B

−

−

−

0xD1B6

B

−

−

−

0xD1B8

B

nameの値

−

−

0xD1BA

B

nameの値

−

−

0xD1BC

B

positionの値

−

−

0xD1BE

B

positionの値

−

−

0xD1C0

B

−

−

−

0xD1C2

B

−

−

−

0xD1C4

B

nameの値

−

−

0xD1C6

B

positionの値

−

−

0xD1C8

B

−

−

−

0xD1CA

B

−

−

−

0xD1CC

B

−

−

−

0xD1CE

B

−

−

−

0xD1D0

B

−

−

−

0xD1D2

B

−

−

−

0xD1D4

B

maxResultの値

−

−

0xD1D6

B

startPositionの値

−

−

0xD1D8

B

hintName

valueのクラス名

−

0xD1DA

B

−

−

−

0xD1DC

B

−

−

−

0xD1DE

B

−

−

−

0xD1E0

B

nameの値

−

−

0xD1E2

B

nameの値

−

−

0xD1E4

B

nameの値

−

−

0xD1E6

B

positionの値

−

−

0xD1E8

B

positionの値

−

−

0xD1EA

B

positionの値

−

−

0xD1EC

B

flushModeの値

−

−

0xD1EE

B

−

−

−

2

0xD1F4

A

−

−

−

3

0xD1F5

A

−

−

※2

4

0xD145

A

−

−

※2

0xD147

A

−

−

※2

0xD149

A

−

−

※2

0xD14B

A

−

−

※2

0xD14D

A

−

−

※2

0xD14F

A

−

−

※2

0xD151

A

−

−

※2

0xD153

A

−

−

※2

0xD155

A

−

−

※2

0xD157

A

−

−

※2

0xD159

A

−

−

※2

0xD15B

A

−

−

※2

0xD15D

A

−

−

※2

0xD15F

A

−

−

※2

4，6

0xD18F

B

−

−

※2

0xD191

B

−

−

※2

0xD193

B

−

−

※2

0xD195

B

−

−

※2

0xD197

B

−

−

※2

0xD199

B

−

−

※2

0xD19B

B

−

−

※2

0xD19D

B

−

−

※2

0xD19F

B

−

−

※2

0xD1A1

B

−

−

※2

0xD1A3

B

−

−

※2

0xD1A5

B

−

−

※2

0xD1A7

B

−

−

※2

0xD1A9

B

−

−

※2

0xD1AB

B

−

−

※2

0xD1AD

B

−

−

※2

0xD1AF

B

−

−

※2

0xD1B1

B

−

−

※2

0xD1B3

B

−

−

※2

0xD1B5

B

−

−

※2

0xD1B7

B

−

−

※2

0xD1B9

B

−

−

※2

0xD1BB

B

−

−

※2

0xD1BD

B

−

−

※2

0xD1BF

B

−

−

※2

0xD1C1

B

−

−

※2

0xD1C3

B

−

−

※2

0xD1C5

B

−

−

※2

0xD1C7

B

−

−

※2

0xD1C9

B

−

−

※2

0xD1CB

B

−

−

※2

0xD1CD

B

−

−

※2

0xD1CF

B

−

−

※2

0xD1D1

B

−

−

※2

0xD1D3

B

−

−

※2

0xD1D5

B

−

−

※2

0xD1D7

B

−

−

※2

0xD1D9

B

−

−

※2

0xD1DB

B

−

−

※2

0xD1DD

B

−

−

※2

0xD1DF

B

−

−

※2

0xD1E1

B

−

−

※2

0xD1E3

B

−

−

※2

0xD1E5

B

−

−

※2

0xD1E7

B

−

−

※2

0xD1E9

B

−

−

※2

0xD1EB

B

−

−

※2

0xD1ED

B

−

−

※2

0xD1EF

B

−

−

※2

7

0xD1F6

A

−

−

−

8

0xD1F7

A

−

−

※2

（凡例）A：標準　B：詳細　−：該当なし

注※1　図8-71中の番号と対応しています。

注※2　正常に処理された場合，入り口時刻が表示されます。例外が発生した場合，入り口時刻と例外が表示されます。

(d)　拡張永続化コンテキストを利用した場合

拡張永続化コンテキストを利用した場合に取得できるトレース情報を次の表に示します。

表8‒118　拡張永続化コンテキストを利用した場合に取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xD1FC

A

−

−

−

2

0xD1FD

A

−

−

※2

3

0xD11C

B

entityのクラス名

−

−

0xD11E

B

entityClassのクラス名

−

−

0xD120

B

entityClassのクラス名

−

−

0xD122

B

entityClassのクラス名

−

−

0xD124

B

entityのクラス名

−

−

0xD126

B

entityのクラス名

−

−

0xD128

B

entityのクラス名

lockModeの値

−

0xD12A

B

entityのクラス名

lockModeの値

−

0xD12C

B

entityのクラス名

−

−

0xD12E

B

entityのクラス名

−

−

0xD130

B

entityのクラス名

−

−

0xD132

B

entityのクラス名

−

−

0xD134

B

entityのクラス名

−

−

0xD136

B

entityのクラス名

−

−

0xD138

B

entityのクラス名

−

−

0xD13A

B

−

−

−

0xD13C

B

−

−

−

0xD13E

B

entityのクラス名

−

−

0xD140

B

rootTyoeのクラス名

−

−

0xD142

B

graphNameの値

−

−

0xD144

A

−

−

−

0xD146

A

−

−

−

0xD148

A

−

−

−

0xD14A

A

−

−

−

0xD14C

A

−

−

−

0xD14E

A

nameの値

−

−

0xD150

A

nameの値

−

−

0xD152

A

−

−

−

0xD154

A

resultClassのクラス名

−

−

0xD156

A

resultSetMapping

−

−

0xD158

A

nameの値

−

−

0xD15A

A

procedureNameの値

−

−

0xD15C

A

procedureNameの値

−

−

0xD15E

A

procedureNameの値

−

−

0xD160

B

flushModeの値

−

−

0xD162

B

−

−

−

0xD164

B

−

−

−

0xD166

B

−

−

−

0xD168

B

−

−

−

0xD16A

B

clsのクラス名

−

−

0xD16C

B

−

−

−

0xD16E

B

graphNameの値

−

−

0xD170

B

entityClassのクラス名

−

−

0xD172

B

−

−

−

0xD174

B

entityのクラス名

−

−

0xD176

B

−

−

−

0xD178

B

propertyNameの値

−

−

0xD17A

B

−

−

−

0xD17C

B

−

−

−

0xD17E

B

−

−

−

0xD180

A

−

−

−

0xD18E

B

−

−

−

0xD190

B

−

−

−

0xD192

B

−

−

−

0xD194

B

flushModeの値

−

−

0xD196

B

−

−

−

0xD198

B

startPositionの値

−

−

0xD19A

B

−

−

−

0xD19C

B

maxResultの値

−

−

0xD19E

B

−

−

−

0xD1A0

B

hintName

valueのクラス名

−

0xD1A2

B

−

−

−

0xD1A4

B

positionの値

−

−

0xD1A6

B

positionの値

−

−

0xD1A8

B

positionの値

−

−

0xD1AA

B

nameの値

−

−

0xD1AC

B

nameの値

−

−

0xD1AE

B

nameの値

−

−

0xD1B0

B

−

−

−

0xD1B2

B

−

−

−

0xD1B4

B

−

−

−

0xD1B6

B

−

−

−

0xD1B8

B

nameの値

−

−

0xD1BA

B

nameの値

−

−

0xD1BC

B

positionの値

−

−

0xD1BE

B

positionの値

−

−

0xD1C0

B

−

−

−

0xD1C2

B

−

−

−

0xD1C4

B

nameの値

−

−

0xD1C6

B

positionの値

−

−

0xD1C8

B

−

−

−

0xD1CA

B

−

−

−

0xD1CC

B

−

−

−

0xD1CE

B

−

−

−

0xD1D0

B

−

−

−

0xD1D2

B

−

−

−

0xD1D4

B

maxResultの値

−

−

0xD1D6

B

startPositionの値

−

−

0xD1D8

B

hintName

valueのクラス名

−

0xD1DA

B

−

−

−

0xD1DC

B

−

−

−

0xD1DE

B

−

−

−

0xD1E0

B

nameの値

−

−

0xD1E2

B

nameの値

−

−

0xD1E4

B

nameの値

−

−

0xD1E6

B

positionの値

−

−

0xD1E8

B

positionの値

−

−

0xD1EA

B

positionの値

−

−

0xD1EC

B

flushModeの値

−

−

0xD1EE

B

−

−

−

4

0xD11D

B

−

−

※2

0xD11F

B

−

−

※2

0xD121

B

−

−

※2

0xD123

B

−

−

※2

0xD125

B

−

−

※2

0xD127

B

−

−

※2

0xD129

B

−

−

※2

0xD12B

B

−

−

※2

0xD12D

B

−

−

※2

0xD12F

B

−

−

※2

0xD131

B

−

−

※2

0xD133

B

−

−

※2

0xD135

B

−

−

※2

0xD137

B

−

−

※2

0xD139

B

−

−

※2

0xD13B

B

−

−

※2

0xD13D

B

−

−

※2

0xD13F

B

−

−

※2

0xD141

B

−

−

※2

0xD143

B

−

−

※2

0xD145

A

−

−

※2

0xD147

A

−

−

※2

0xD149

A

−

−

※2

0xD14B

A

−

−

※2

0xD14D

A

−

−

※2

0xD14F

A

−

−

※2

0xD151

A

−

−

※2

0xD153

A

−

−

※2

0xD155

A

−

−

※2

0xD157

A

−

−

※2

0xD159

A

−

−

※2

0xD15B

A

−

−

※2

0xD15D

A

−

−

※2

0xD15F

A

−

−

※2

0xD161

B

−

−

※2

0xD163

B

−

−

※2

0xD165

B

−

−

※2

0xD167

B

−

−

※2

0xD169

B

−

−

※2

0xD16B

B

−

−

※2

0xD16D

B

−

−

※2

0xD16F

B

−

−

※2

0xD171

B

−

−

※2

0xD173

B

−

−

※2

0xD175

B

−

−

※2

0xD177

B

−

−

※2

0xD179

B

−

−

※2

0xD17B

B

−

−

※2

0xD17D

B

−

−

※2

0xD17F

B

−

−

※2

0xD181

A

−

−

※2

0xD18F

B

−

−

※2

0xD191

B

−

−

※2

0xD193

B

−

−

※2

0xD195

B

−

−

※2

0xD197

B

−

−

※2

0xD199

B

−

−

※2

0xD19B

B

−

−

※2

0xD19D

B

−

−

※2

0xD19F

B

−

−

※2

0xD1A1

B

−

−

※2

0xD1A3

B

−

−

※2

0xD1A5

B

−

−

※2

0xD1A7

B

−

−

※2

0xD1A9

B

−

−

※2

0xD1AB

B

−

−

※2

0xD1AD

B

−

−

※2

0xD1AF

B

−

−

※2

0xD1B1

B

−

−

※2

0xD1B3

B

−

−

※2

0xD1B5

B

−

−

※2

0xD1B7

B

−

−

※2

0xD1B9

B

−

−

※2

0xD1BB

B

−

−

※2

0xD1BD

B

−

−

※2

0xD1BF

B

−

−

※2

0xD1C1

B

−

−

※2

0xD1C3

B

−

−

※2

0xD1C5

B

−

−

※2

0xD1C7

B

−

−

※2

0xD1C9

B

−

−

※2

0xD1CB

B

−

−

※2

0xD1CD

B

−

−

※2

0xD1CF

B

−

−

※2

0xD1D1

B

−

−

※2

0xD1D3

B

−

−

※2

0xD1D5

B

−

−

※2

0xD1D7

B

−

−

※2

0xD1D9

B

−

−

※2

0xD1DB

B

−

−

※2

0xD1DD

B

−

−

※2

0xD1DF

B

−

−

※2

0xD1E1

B

−

−

※2

0xD1E3

B

−

−

※2

0xD1E5

B

−

−

※2

0xD1E7

B

−

−

※2

0xD1E9

B

−

−

※2

0xD1EB

B

−

−

※2

0xD1ED

B

−

−

※2

0xD1EF

B

−

−

※2

5

0xD1FE

A

−

−

−

6

0xD1FF

A

−

−

※2

（凡例）A：標準　B：詳細　−：該当なし

注※1　図8-72中の番号と対応しています。

注※2　正常に処理された場合，入り口時刻が表示されます。例外が発生した場合，入り口時刻と例外が表示されます。

8.19　TP1インバウンド連携機能のトレース取得ポイント

ここでは，TP1インバウンド連携機能のトレース取得ポイントと，取得できるトレース情報について説明します。

8.19.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

(1)　TP1インバウンド連携機能でのトレース取得ポイントの詳細

TP1インバウンド連携機能でのトレース取得ポイントの詳細について次の表に示します。

表8‒119　TP1インバウンド連携機能でのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0x842F

19

リソースアダプタからMessage-driven Beanのメッセージリスナのメソッドを呼び出した直後

A

0x8430

22

リソースアダプタから呼び出したMessage-driven Beanのメッセージリスナのメソッドのリターン直前

A

0x8431

20

EJBコンテナがMessage-driven Beanのメッセージリスナのメソッドをコールバックする直前

A

0x8432

21

Message-driven Beanのメッセージリスナのメソッドのコールバックからリターンした直後

A

0x8825

17

トランザクションのrecreate処理直前

B

0x8826

18

トランザクションのrecreate処理直後

B

0x8B86

14

javax.resource.spi.work.WorkManagerのメソッドの呼び出し直後

A

0x8B87

15

javax.resource.spi.work.WorkManagerのメソッドのリターン直前

A

0x8B8A

16

javax.resource.spi.work.Workのメソッド呼び出し直前

A

0x8B8B

29

javax.resource.spi.work.Workのメソッドのリターン直後

A

0x8B8C

33

javax.resource.spi.XATerminator.prepare（Xid xid）呼び出し直後

B

0x8B8D

34

javax.resource.spi.XATerminator.prepare（Xid xid）リターン直前

B

0x8B8E

−

javax.resource.spi.XATerminator.commit（Xid xid，boolean onePhase）呼び出し直後

B

0x8B8F

−

javax.resource.spi.XATerminator.commit（Xid xid，boolean onePhase）リターン直前

B

0x8B90

−

javax.resource.spi.XATerminator.rollback（Xid xid）呼び出し直後

B

0x8B91

−

javax.resource.spi.XATerminator.rollback（Xid xid）リターン直前

B

0x8B92

−

javax.resource.spi.XATerminator.forget（Xid xid）呼び出し直後

B

0x8B93

−

javax.resource.spi.XATerminator.forget（Xid xid）リターン直前

B

0xAA00

8

電文受信開始直後

A

0xAA01

12

RPC応答送信完了直後

A

0xAA02

4

OpenTP1からの電文読み込み開始直後

A

0xAA03

10

OpenTP1とのコネクション切断直前（OpenTP1の定義にrpc_close_after_send=Yが指定されている場合）

A

0xAA04

5

ソケットのread呼び出し直前

B

0xAA05

6

ソケットのread完了直後

B

0xAA06

13

電文受信が完了し，スケジュールキュー投入直前

A

0xAA08

23

RPC応答電文の送信開始直前

A

0xAA09

27

応答用のコネクション切断直前（TP1インバウンドアダプタのプロパティにrpc_close_after_send=trueが指定されている場合）

A

0xAA0A

25

ソケットのwrite呼び出し直前

B

0xAA0B

26

ソケットのwrite完了直後

B

0xAA0C

30

送信失敗。リトライ待機開始直前

A

0xAA0D

31

リトライ開始直前

A

0xAA10

11

不正電文を受信してコネクションを切断した直後

受信タイムアウトが発生してコネクションを切断した直後

受信タイマ監視スレッドでRPC要求の受信タイムアウトが発生し電文が破棄された直後

A

0xAA11

28

RPC応答送信失敗直後

A

0xAA12

2

OpenTP1とのコネクションを受信監視対象に追加する直前

B

0xAA13

3

OpenTP1とのコネクションで電文の受信を検知した時

B

0xAA14

32

同期点処理でのOpenTP1からの受信完了直後

A

0xAA15

35

同期点処理でのOpenTP1への送信完了直後，または送信できないエラーが発生した直後

A

0xAA16

1

OpenTP1とのコネクション確立直後

A

0xAA17

9

OpenTP1とのコネクション切断直前，または通信エラー発生によるOpenTP1とのコネクション切断検知直後

A

0xAA18

7

受信した電文を解析した直後

B

0xAA19

24

電文を送信する直前

B

（凡例）A：標準　B：詳細　−：該当なし

注※　図8-73〜図8-79の番号と対応しています。

(2)　TP1インバウンド連携機能でのトレース取得ポイント

TP1インバウンド連携機能でのトレース取得ポイントの全体を次の図に示します。なお，図中のA，およびBについては，さらに詳細なトレース取得ポイントがあります。

図8‒73　TP1インバウンド連携機能のトレース取得ポイントの全体

図中のAおよびBの詳細なトレース取得ポイントについて，次の二つの図で示します。

図8‒74　A部分のトレース取得ポイント

注※1　readで例外が発生した場合，出力しません。

注※2　電文受信後に出力します。分割された電文の場合，分割された電文ごとに出力します。ただし，電文不正時は出力しません。

注※3　RPC応答送信処理（0xAA01以外のPRFトレース取得ポイント）については，図8-75を参照してください。

RPC受信時のPRFトレース取得ポイントは，図8-74に加えて，受信タイマ監視スレッドがRPC要求の受信タイムアウトを検知し，電文を破棄した直後に出力する0xAA10があります。

図8‒75　B部分のトレース取得ポイント

図8-75の応答送信時のPRFトレース出力ポイントは，RPC通信時だけでなく，J2EEアプリケーション停止時にも出力します。このときのルートアプリケーション情報は，OpenTP1から引き継いだルートアプリケーション情報ではなく，J2EEサーバによって生成されたルートアプリケーション情報です。そのため，J2EEアプリケーション停止時のPRFトレース出力ポイントとRPC通信時のほかのPRFトレース出力ポイントとの対応づけは，J2EEアプリケーション停止時の0xAA08のインタフェース名に出力するルートアプリケーション情報を使用します。

(3)　同期点処理でのトレース取得ポイント

同期点処理でのトレース取得ポイントの全体を次の図に示します。なお，図中のA，およびBについては，さらに詳細なトレース取得ポイントがあります。

図8‒76　同期点処理のトレース取得ポイントの全体

注※1

処理要求がXATerminatorに移った時点で，メソッドごとに出力されるイベントIDが異なります。各メソッドと出力されるイベントIDの対応を次の表に示します。

表8‒120　メソッドとイベントIDの対応

メソッド

イベントID

図中の番号

prepareメソッド

0x8B8C

33

commitメソッド

0x8B8E

−

rollbackメソッド

0x8B90

−

forgetメソッド

0x8B92

−

（凡例）−：図中では使用していません。

注※2

OTSの出力ポイントについては，「8.14　OTSのトレース取得ポイント」を参照してください。

注※3

処理要求がXATerminatorから同期点電文送受信スレッドへ移る時点で，メソッドごとに出力されるイベントIDが異なります。各メソッドと出力されるイベントIDの対応を次の表に示します。

表8‒121　メソッドとイベントIDの対応

メソッド

イベントID

図中の番号

prepareメソッド

0x8B8D

34

commitメソッド

0x8B8F

−

rollbackメソッド

0x8B91

−

forgetメソッド

0x8B93

−

（凡例）−：図中では使用していません。

図中のAおよびBの詳細なトレース取得ポイントについて，次の二つの図で示します。

図8‒77　同期点処理のA部分のトレース取得ポイント

注※1　readで例外が発生した場合，出力しません。

注※2　電文受信後に出力します。分割された電文の場合，分割された電文ごとに出力します。ただし，電文不正時は出力しません。

図8‒78　同期点処理のB部分のトレース取得ポイント

コネクション数調整スレッドのトレース取得ポイントを次の図で示します。

図8‒79　コネクション数調整スレッドのトレース取得ポイント

8.19.2　取得できるトレース情報

TP1インバウンド連携機能で取得できるトレース情報を次の表に示します。

表8‒122　TP1インバウンド連携機能で取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xAA16

A

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

−

TP1インバウンドアダプタ側のListenポート番号

2

0xAA12

B

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

−

TP1インバウンドアダプタ側のListenポート番号

3

0xAA13

B

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

−

TP1インバウンドアダプタ側のListenポート番号

4

0xAA02

A

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

−

TP1インバウンドアダプタ側のListenポート番号

5

0xAA04

B

要求サイズ

−

−

6

0xAA05

B

読み込めたサイズ

−

−

7

0xAA18

B

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

電文の種類

TP1インバウンドアダプタ側のListenポート番号

8

0xAA00

A

サービスグループ名

サービス名

呼び出し元のOpenTP1のノード識別子※3，トランザクショングローバル識別子（トランザクショナルRPCの場合）

9

0xAA17

A

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

−

TP1インバウンドアダプタ側のListenポート番号

10

0xAA03

A

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

−

TP1インバウンドアダプタ側のListenポート番号

11

0xAA10

A

サービスグループ名※4

サービス名※5

入り口時刻

12

0xAA01

A

サービスグループ名

サービス名

正常時：入り口時刻

異常時：入り口時刻およびエラー応答コード

13

0xAA06

A

サービスグループ名

サービス名

呼び出し元のOpenTP1のノード識別子※3，キュー内の電文数

14

0x8B86

A

Workのクラス名

メソッド名

リソースアダプタの表示名

15

0x8B87

A

Workのクラス名

メソッド名

正常時：入り口時刻

異常時：入り口時刻および例外

16

0x8B8A

A

Workのクラス名

メソッド名

リソースアダプタの表示名

17

0x8825

B

−

−

OpenTP1のグローバルトランザクションID（バイト列）

18

0x8826

B

−

−

正常時：入り口時刻

異常時：入り口時刻および例外

19

0x842F

A

Bean名

メソッド名

−

20

0x8431

A

Bean名

メソッド名

−

21

0x8432

A

Bean名

メソッド名

正常時：入り口時刻

異常時：入り口時刻および例外

22

0x8430

A

Bean名

メソッド名

正常時：入り口時刻

異常時：入り口時刻および例外

23

0xAA08

A

ルートアプリケーション情報※6

−

−

24

0xAA19

B

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

電文の種類

TP1インバウンドアダプタ側のListenポート番号

25

0xAA0A

B

書き込みサイズ

−

−

26

0xAA0B

B

書き込めたサイズ

−

−

27

0xAA09

A

OpenTP1のIPアドレス：OpenTP1のlistenポート番号※2

−

TP1インバウンドアダプタ側のListenポート番号

28

0xAA11

A

サービスグループ名

サービス名

入り口時刻

29

0x8B8B

A

Workのクラス名

メソッド名

正常時：入り口時刻

異常時：入り口時刻および例外

30

0xAA0C

A

−

−

−

31

0xAA0D

A

−

−

−

32

0xAA14

A

OpenTP1のノード識別子

次のどれかを出力します。

prepare

commit

rollback

トランザクショングローバル識別子

33

0x8B8C

B

−

−

XATerminatorの引数xidのグローバルトランザクションID（バイト列）

34

0x8B8D

B

−

−

正常時：入り口時刻

異常時：入り口時刻および例外

35

0xAA15

A

−

正常時は次のどれかを出力します※7。

prepared

read only

committed

rolled back

異常時は何も出力しません。

入口時刻

−

0x8B8E

B

−

−

XATerminatorの引数xidのグローバルトランザクションID（バイト列）

−

0x8B8F

B

−

−

正常時：入り口時刻

異常時：入り口時刻および例外

−

0x8B90

B

−

−

XATerminatorの引数xidのグローバルトランザクションID（バイト列）

−

0x8B91

B

−

−

正常時：入り口時刻

異常時：入り口時刻および例外

−

0x8B92

B

−

−

XATerminatorの引数xidのグローバルトランザクションID（バイト列）

−

0x8B93

B

−

−

正常時：入り口時刻

異常時：入り口時刻および例外

（凡例）A：標準　B：詳細　−：該当なし

注※1　図8-73〜図8-79中の番号と対応しています。

注※2　OpenTP1のlistenポートが判別できない場合は「OpenTP1のIPアドレス：−」と出力します。

注※3　呼び出し元のOpenTP1からPRF情報を引き継いでいる場合は，「root RPCノード識別子」が出力されます。引き継いでいない場合は，「呼出元ノードID」が出力されます。

注※4　インタフェース名に出力されるサービスグループ名が判別できない場合は「−」が出力されます。

注※5　オペレーション名に出力されるサービス名が判別できない場合は「−」が出力されます。

注※6　J2EEアプリケーションの停止時だけ出力します。出力する内容を以下に示します。

呼び出し元のOpenTP1からPRF情報を引き継いでいる場合は，OpenTP1から引き継いだルートアプリケーション情報を出力します。

呼び出し元のOpenTP1からPRF情報を引き継いでいない場合は，TP1インバウンドアダプタが採番したルートアプリケーション情報を出力します。

注※7　それぞれ次の条件の場合に出力します。

prepared：プリペアが完了した場合

read only：リソースへのアクセスが参照の場合などプリペアの結果がリードオンリーだった場合。または実行したMessage-driven Bean（サービス）のトランザクションの設定がCMT NotSupported，またはBMTの場合

committed：コミットが完了した場合

rolled back：ロールバックが完了した場合。プリペアやコミットの結果がロールバックとなった場合も含みます。

8.20　CJMSプロバイダのトレース取得ポイント

ここでは，CJMSプロバイダのトレース取得ポイントと，取得できるトレース情報について説明します。

8.20.1　JMS ConnectionFactoryインタフェースのトレース取得ポイントと取得できるトレース情報

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒123　JMS ConnectionFactoryインタフェースでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xA600

1

ConnectionFactory.createConnection()の処理開始

A

0xA601

4

ConnectionFactory.createConnection()の処理終了

A

0xA602

1

ConnectionFactory.createConnection(uname,pwd)の処理開始

A

0xA603

4

ConnectionFactory.createConnection(uname,pwd)の処理終了

A

0xA604

1

QueueConnectionFactory.createQueueConnection()の処理開始

A

0xA605

4

QueueConnectionFactory.createQueueConnection()の処理終了

A

0xA606

1

QueueConnectionFactory.createQueueConnection(uname,pwd)の処理開始

A

0xA607

4

QueueConnectionFactory.createQueueConnection(uname,pwd)の処理終了

A

0xA608

1

TopicConnectionFactory.createTopicConnection()の処理開始

A

0xA609

4

TopicConnectionFactory.createTopicConnection()の処理終了

A

0xA60A

1

TopicConnectionFactory.createTopicConnection(uname,pwd)の処理開始

A

0xA60B

4

TopicConnectionFactory.createTopicConnection(uname,pwd)の処理終了

A

0xA60C

2

ManagedConnectionFactory.matchManagedConnections()の処理開始

B

0xA60D

3

ManagedConnectionFactory.matchManagedConnections()の処理終了

B

（凡例）A：標準　B：詳細

注※　図8-80の番号と対応しています。

JMS ConnectionFactoryインタフェースでのトレース取得ポイントを次の図に示します。

図8‒80　JMS ConnectionFactoryインタフェースのトレース取得ポイント

(2)　取得できるトレース情報

JMS ConnectionFactoryインタフェースで取得できるトレース情報（インタフェース名，オペレーション名，およびオプション）はありません。

8.20.2　JMS Connectionインタフェースのトレース取得ポイントと取得できるトレース情報

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒124　JMS Connectionインタフェースでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xA60E

1

Connection.createSession(transacted,acknowledgeMode)の処理開始

A

0xA60F

4

Connection.createSession(transacted,acknowledgeMode)の処理終了

A

0xA610

1

QueueConnection.createQueueSession(transacted,acknowledgeMode)の処理開始

A

0xA611

4

QueueConnection.createQueueSession(transacted,acknowledgeMode)の処理終了

A

0xA612

1

TopicConnection.createTopicSession(transacted,acknowledgeMode)の処理開始

A

0xA613

4

TopicConnection.createTopicSession(transacted,acknowledgeMode)の処理終了

A

0xA614

5

Connection.close()処理の開始

A

0xA615

8

Connection.close()処理の終了

A

0xA616

2

セッション作成直前のCJMSPブローカーによる呼び出し

A

0xA617

3

セッション作成直後のCJMSPブローカーによる呼び出し

A

0xA618

6

コネクションの切断直前のCJMSPブローカーによる呼び出し

A

0xA619

7

コネクションの切断直後のCJMSPブローカーによる呼び出し

A

（凡例）A：標準

注※　図8-81の番号と対応しています。

JMS Connectionインタフェースでのトレース取得ポイントを次の図に示します。

図8‒81　JMS Connectionインタフェースのトレース取得ポイント

(2)　取得できるトレース情報

JMS Connectionインタフェースで取得できるトレース情報を次の表に示します。

表8‒125　JMS Connectionインタフェースで取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xA60E

A

トランザクション

Ack モード

−

0xA610

A

0xA612

A

2

0xA616

A

−

−

−

3

0xA617

A

−

−

−

4

0xA60F

A

−

−

−

0xA611

A

0xA613

A

5

0xA614

A

−

−

−

6

0xA618

A

−

−

−

7

0xA619

A

−

−

−

8

0xA615

A

−

−

−

（凡例）A：標準　−：該当なし

注※　図8-81の番号と対応しています。

注意事項

イベントIDの0xA618と0xA619はMessage-driven Beanアプリケーションを停止している間にも出力されます。

参考

Acknowledgementモードは数値で出力されます。数値は，Acknowledgementモードの種類ごとに対応しています。対応を次に示します。

AUTO_ACKNOWLEDGE = 1

CLIENT_ACKNOWLEDGE = 2

DUPS_OK_ACKNOWLEDGE = 3

SESSION_TRANSACTED = 0

それぞれのモードの数値はJMS仕様で定義されています。

8.20.3　JMSセッションインタフェースのトレース取得ポイントと取得できるトレース情報

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒126　JMSセッションインタフェースでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xA61E

5

Session.createSubscriber(topic)の処理開始

A

0xA61F

8

Session.createSubscriber(topic)の処理終了

A

0xA620

1

Session.createBrowser(queue)の処理開始

A

0xA621

4

Session.createBrowser(queue)の処理終了

A

0xA622

1

Session.createBrowser(queue,selector)の処理開始

A

0xA623

4

Session.createBrowser(queue,selector)の処理終了

A

0xA624

5

Session.createSubscriber(topic,selector,noLocal)の処理開始

A

0xA625

8

Session.createSubscriber(topic,selector,noLocal)の処理終了

A

0xA626

5

Session.createDurableSubscriber(topic,name)の処理開始

A

0xA627

8

Session.createDurableSubscriber(topic,name)の処理終了

A

0xA628

5

Session.createDurableSubscriber(topic,name,selector,noLocal)の処理開始

A

0xA629

8

Session.createDurableSubscriber(topic,name,selector,noLocal)の処理終了

A

0xA62A

5

Session.createConsumer(destination)の処理開始

A

0xA62B

8

Session.createConsumer(destination)の処理終了

A

0xA62C

5

Session.createConsumer(destination,selector)の処理開始

A

0xA62D

8

Session.createConsumer(destination,selector)の処理終了

A

0xA62E

5

Session.createConsumer(destination,selector,noLocal)の処理開始

A

0xA62F

8

Session.createConsumer(destination,selector,noLocal)の処理終了

A

0xA630

5

Session.createReceiver(queue)の処理開始

A

0xA631

8

Session.createReceiver(queue)の処理終了

A

0xA632

5

Session.createReceiver(queue,selector)の処理開始

A

0xA633

8

Session.createReceiver(queue,selector)の処理終了

A

0xA634

9

Session.createPublisher(topic)の処理開始

A

0xA635

12

Session.createPublisher(topic)の処理終了

A

0xA636

9

Session.createProducer(destination)の処理開始

A

0xA637

12

Session.createProducer(destination)の処理終了

A

0xA638

9

Session.createSender(queue)の処理開始

A

0xA639

12

Session.createSender(queue)の処理終了

A

0xA63A

13

Session.createQueue()の処理開始

A

0xA63B

16

Session.createQueue()の処理終了

A

0xA63C

13

Session.createTopic()の処理開始

A

0xA63D

16

Session.createTopic()の処理終了

A

0xA63E

13

Session.createTemporaryQueue()の処理開始

A

0xA63F

16

Session.createTemporaryQueue()の処理終了

A

0xA640

13

Session.createTemporaryTopic()の処理開始

A

0xA641

16

Session.createTemporaryTopic()の処理終了

A

0xA642

17

Session.unsubscribe()の処理開始

A

0xA643

20

Session.unsubscribe()の処理終了

A

0xA644

21

Session.commit()の処理開始

A

0xA645

24

Session.commit()の処理終了

A

0xA646

21

Session.rollback()の処理開始

A

0xA647

24

Session.rollback()の処理終了

A

0xA648

25

Session.recover()の処理開始

A

0xA649

26

Session.recover()の処理終了

A

0xA64A

25

Session.close()の処理開始

A

0xA64B

26

Session.close()の処理終了

A

0xA64C

2

ブラウザーの送信先認証を呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA64D

3

ブラウザーの送信先認証を呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA64E

6

コンシューマーを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA64F

7

コンシューマーを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA650

10

プロデューサーを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA651

11

プロデューサーを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA652

14

送信先作成を呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA653

15

送信先作成を呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA654

18

永続化サブスクライバー作成を呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA655

19

永続化サブスクライバー作成を呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA656

22

セッションコミットを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA657

23

セッションコミットを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA658

22

セッションロールバックを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA659

23

セッションロールバックを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA65A

22

セッション回復を呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA65B

23

セッション回復を呼び出した直後のCJMSPブローカーによる呼び出し

A

（凡例）A：標準

注※　図8-82の番号と対応しています。

注意事項

イベントIDの0xA644と0xA645，0xA646と0x647に対応するメソッドであるSession.commit()およびSession.rollback()はサポートされていません。

イベントIDの0xA65Aと0xA65Bは出力されません。XAトランザクションを使用したとき出力されます。

JMSセッションインタフェースでのトレース取得ポイントを次の図に示します。

図8‒82　JMSセッションインタフェースのトレース取得ポイント

参考

プロデューサーまたはコンシューマーの作成の間，destinationが作成されます。このため，createProducer()メソッドおよびcreateConsumer()メソッドでは，イベントID 0xa652および0xa653が呼び出される可能性があります。

(2)　取得できるトレース情報

JMSセッションインタフェースで取得できるトレース情報を次の表に示します。

表8‒127　 JMSセッションインタフェースで取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xA620

A

キュー名

−

−

0xA622

A

セレクタ文字列

2

0xA64C

A

−

−

−

3

0xA64D

A

−

−

−

4

0xA621

A

−

−

−

0xA623

A

5

0xA61E

A

トピック名

−

−

0xA624

A

セレクタ文字列

0xA626

A

−

0xA628

A

セレクタ文字列

0xA62A

A

送信先名

−

0xA62C

A

セレクタ文字列

0xA62E

A

0xA630

A

キュー名

−

0xA632

A

セレクタ文字列

6

0xA64E

A

−

−

−

7

0xA64F

A

−

−

−

8

0xA61F

A

−

−

−

0xA625

A

0xA627

A

0xA629

A

0xA62B

A

0xA62D

A

0xA62F

A

0xA631

A

0xA633

A

9

0xA634

A

トピック名

−

−

0xA636

A

送信先名

−

−

0xA638

A

キュー名

−

−

10

0xA650

A

−

−

−

11

0xA651

A

−

−

−

12

0xA635

A

−

−

−

0xA637

A

0xA639

A

13

0xA63A

A

キュー名

−

−

0xA63C

A

トピック名

0xA63E

A

−

0xA640

A

14

0xA652

A

−

−

−

15

0xA653

A

−

−

−

16

0xA63B

A

−

−

−

0xA63D

A

0xA63F

A

0xA641

A

17

0xA642

A

−

−

−

18

0xA654

A

−

−

−

19

0xA655

A

−

−

−

20

0xA643

A

−

−

−

21

0xA644

A

−

−

−

0xA646

A

0xA648

A

22

0xA656

A

−

−

−

0xA658

A

0xA65A

A

23

0xA657

A

−

−

−

0xA659

A

0xA65B

A

24

0xA645

A

−

−

−

0xA647

A

0xA649

A

25

0xA64A

A

−

−

−

26

0xA64B

A

−

−

−

（凡例）A：標準　−：該当なし

注※　図8-82の番号と対応しています。

8.20.4　JMSメッセージ，プロデューサー，コンシューマーとキューブラウザーのトレース取得ポイントと取得できるトレース情報

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒128　JMSメッセージ，プロデューサー，コンシューマーとキューブラウザーでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xA65C

1

MessageProducer.send(msg)の処理開始

A

0xA65D

4

MessageProducer.send(msg)の処理終了

A

0xA65E

1

MessageProducer.send(msg,deliveryMode,priority,timeToLive)の処理開始

A

0xA65F

4

MessageProducer.send(msg,deliveryMode,priority,timeToLive)の処理終了

A

0xA660

1

MessageProducer.send(destination,msg)の処理開始

A

0xA661

4

MessageProducer.send(destination,msg)の処理終了

A

0xA662

1

MessageProducer.send(destination,msg,deliveryMode,priority,timeToLive)の処理開始

A

0xA663

4

MessageProducer.send(destination,msg,deliveryMode,priority,timeToLive)の処理終了

A

0xA664

9

MessageProducer.close()の処理開始

A

0xA665

10

MessageProducer.close()の処理終了

A

0xA666

5

MessageConsumer.receive()の処理開始

A

0xA667

8

MessageConsumer.receive()の処理終了

A

0xA61A

5

MessageConsumer.receive(timeout)の処理開始

A

0xA61B

8

MessageConsumer.receive(timeout)の処理終了

A

0xA668

5

MessageConsumer.receiveNoWait()の処理開始

A

0xA669

8

MessageConsumer.receiveNoWait()の処理終了

A

0xA66A

9

MessageConsumer.close()の処理開始

A

0xA66B

10

MessageConsumel.close()の処理終了

A

0xA66C

11

QueueBrowser.getEnumeration()の処理開始

A

0xA66D

14

QueueBrowser.getEnumeration()の処理終了

A

0xA66E

15

Message.acknowledge()の処理開始

A

0xA66F

18

Message.acknowledge()の処理終了

A

0xA670

2

JMSメッセージの書き込みを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA671

3

JMSメッセージの書き込みを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA672

6

JMSメッセージの受信を呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA673

7

JMSメッセージの受信を呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA674

12

全JMSメッセージの配信を呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA675

13

全JMSメッセージの配信を呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA676

16

JMSメッセージの承認を呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA677

17

JMSメッセージの承認を呼び出した直後のCJMSPブローカーによる呼び出し

A

（凡例）A：標準

注※　図8-83の番号と対応しています。

注意事項

トランザクションを使用した場合，またはacknowledgementモードをCLIENT_ACKNOWLEDGE以外に設定した場合は，メッセージを受信するとイベントIDの0xA676と0xA677が出力されます。

Message-driven Beanを実行した場合は，イベントIDの0xA672と0xA673のルートアプリケーション情報が不正な状態になります。

JMSメッセージ，プロデューサー，コンシューマーとキューブラウザーでのトレース取得ポイントを次の図に示します。

図8‒83　JMSメッセージ，プロデューサー，コンシューマーとキューブラウザーのトレース取得ポイント

(2)　取得できるトレース情報

JMSメッセージ，プロデューサー，コンシューマーとキューブラウザーで取得できるトレース情報を次の表に示します。

表8‒129　JMSメッセージ，プロデューサー，コンシューマーとキューブラウザーで取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xA65C

A

送信先名

−

−

0xA65E

A

優先

0xA660

A

−

0xA662

A

優先

2

0xA670

A

−

−

−

3

0xA671

A

−

−

−

4

0xA65D

A

−

−

−

0xA65F

A

0xA661

A

0xA663

A

5

0xA666

A

送信先名

0

−

0xA61A

A

タイムアウト

0xA668

A

−

6

0xA672

A

−

−

−

7

0xA673

A

−

−

−

8

0xA667

A

−

−

−

0xA61B

A

0xA669

A

9

0xA664

A

−

−

−

0xA66A

A

10

0xA665

A

−

−

−

0xA66B

A

11

0xA66C

A

−

−

−

12

0xA674

A

−

−

−

13

0xA675

A

−

−

−

14

0xA66D

A

−

−

−

15

0xA66E

A

−

−

−

16

0xA676

A

−

−

−

17

0xA677

A

−

−

−

18

0xA66F

A

−

−

−

（凡例）A：標準　−：該当なし

注※　図8-83の番号と対応しています。

8.20.5　CJMSPリソースアダプタと接続するときのCJMSPブローカーのトレース取得ポイントと取得できるトレース情報

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒130　CJMSPリソースアダプタと接続するときのCJMSPブローカーでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xA678

1

ResourceAdapter.start(ctx)の処理開始

A

0xA679

4

ResourceAdapter.start(ctx)の処理終了

A

0xA67A

5

ResourceAdapter.stop()の処理開始

A

0xA67B

8

ResourceAdapter.stop()の処理終了

A

0xA67C

2

helloメソッドを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA67D

3

helloメソッドを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA67E

6

good byeメソッドを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA67F

7

good byeメソッドを呼び出した直後のCJMSPブローカーによる呼び出し

A

（凡例）A：標準

注※　図8-84の番号と対応しています。

注意事項

イベントIDの0xA67Cと0xA67DはCJMSPブローカーとCJMSPリソースアダプタがコネクション接続をするための通信をしている間にも出力されます。

CJMSPリソースアダプタと接続するときのCJMSPブローカーでのトレース取得ポイントを次の図に示します。

図8‒84　CJMSPリソースアダプタと接続するときのCJMSPブローカーのトレース取得ポイント

(2)　取得できるトレース情報

CJMSPリソースアダプタと接続するときのCJMSPブローカーで取得できるトレース情報（インタフェース名，オペレーション名，およびオプション）はありません。

8.20.6　CJMSPリソースアダプタでのトランザクション管理のトレース取得ポイントと取得できるトレース情報

(1)　CJMSPリソースアダプタでのトランザクション管理（LocalTransactionの場合）

(a)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒131　CJMSPリソースアダプタでのトランザクション管理（LocalTransactionの場合）のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xA656

6

セッションコミットを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA657

7

セッションコミットを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA658

6

セッションロールバックを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA659

7

セッションロールバックを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA686

1

LocalTransaction.begin()の処理開始

A

0xA687

4

LocalTransaction.begin()の処理終了

A

0xA688

5

LocalTransaction.commit()の処理開始

A

0xA689

8

LocalTransaction.commit()の処理終了

A

0xA68A

5

LocalTransaction.rollback()の処理開始

A

0xA68B

8

LocalTransaction.rollback()の処理終了

A

0xA68C

2

トランザクション開始直前のCJMSPブローカーによる呼び出し

A

0xA68D

3

トランザクション開始直後のCJMSPブローカーによる呼び出し

A

（凡例）A：標準

注※　図8-85の番号と対応しています。

CJMSPリソースアダプタでのトランザクション管理（LocalTransactionの場合）のトレース取得ポイントを次の図に示します。

図8‒85　CJMSPリソースアダプタでのトランザクション管理（LocalTransactionの場合）のトレース取得ポイント

(b)　取得できるトレース情報

CJMSPリソースアダプタでのトランザクション管理（LocalTransactionの場合）で取得できるトレース情報（インタフェース名，オペレーション名，およびオプション）はありません。

(2)　CJMSPリソースアダプタでのトランザクション管理（XAResourceの場合）

(a)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒132　CJMSPリソースアダプタでのトランザクション管理（XAResourceの場合）でのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xA656

2

セッションコミットを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA657

3

セッションコミットを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA658

2

セッションロールバックを呼び出す直前のCJMSPブローカーによる呼び出し

A

0xA659

3

セッションロールバックを呼び出した直後のCJMSPブローカーによる呼び出し

A

0xA68C

2

トランザクション開始直前のCJMSPブローカーによる呼び出し

A

0xA68D

3

トランザクション開始直後のCJMSPブローカーによる呼び出し

A

0xA692

1

XAResource.start()の処理開始

A

0xA693

4

XAResource.start()の処理終了

A

0xA694

1

XAResource.end()の処理開始

A

0xA695

4

XAResource.end()の処理終了

A

0xA696

1

XAResource.prepare()の処理開始

A

0xA697

4

XAResource.prepare()の処理終了

A

0xA698

1

XAResource.commit()の処理開始

A

0xA699

4

XAResource.commit()の処理終了

A

0xA69A

1

XAResource.rollback()の処理開始

A

0xA69B

4

XAResource.rollback()の処理終了

A

0xA69E

2

XAResource停止を呼び出す直前のブローカーによる呼び出し

A

0xA69F

3

XAResource停止を呼び出した直後のブローカーによる呼び出し

A

0xA6A0

2

XAResource準備の直前のブローカーによる呼び出し

A

0xA6A1

3

XAResource準備の直後のブローカーによる呼び出し

A

（凡例）A：標準

注※　図8-86の番号と対応しています。

CJMSPリソースアダプタでのトランザクション管理（XAResourceの場合）でのトレース取得ポイントを次の図に示します。

図8‒86　CJMSPリソースアダプタでのトランザクション管理（XAResourceの場合）のトレース取得ポイント

(b)　取得できるトレース情報

CJMSPリソースアダプタでのトランザクション管理（XAResourceの場合）で取得できるトレース情報を次の表に示します。

表8‒133　CJMSPリソースアダプタでのトランザクション管理（XAResourceの場合）で取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xA692

A

フラグ

−

−

0xA694

A

フラグ

0xA696

A

−

0xA698

A

フラグ

0xA69A

A

−

2

0xA656

A

−

−

−

0xA658

A

0xA68C

A

0xA69E

A

0xA6A0

A

3

0xA657

A

−

−

−

0xA659

A

0xA68D

A

0xA69F

A

0xA6A1

A

4

0xA693

A

−

−

−

0xA695

A

0xA697

A

0xA699

A

0xA69B

A

（凡例）A：標準　−：該当なし

注※　図8-86の番号と対応しています。

8.20.7　CJMSPリソースアダプタからのMessage-driven Beanのデプロイ時のトレース取得ポイントと取得できるトレース情報

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒134　CJMSPリソースアダプタからのMessage-driven Beanのデプロイ時でのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xA6A6

1

ResourceAdapter.endpointActivation(endpointFactory,spec)の処理開始

A

0xA6A7

2

ResourceAdapter.endpointActivation(endpointFactory,spec)の処理終了

A

0xA6A8

3

ResourceAdapter.endpointDeactivation(endpointFactory,spec)の処理開始

A

0xA6A9

4

ResourceAdapter.endpointDeactivation(endpointFactory,spec)の処理終了

A

0xA6AA

5

MessageListener.onMessage()の処理開始

A

0xA6AB

6

MessageListener.onMessage()の処理終了

A

（凡例）A：標準

注※　図8-87の番号と対応しています。

注意事項

endpointDeactivation()を呼び出すと0xA67Eと0xA67Fが出力されます。

endpointActivation()を呼び出すと0xA67Cと0xA67Dが出力されます。

CJMSPリソースアダプタからのMessage-driven Beanのデプロイ時でのトレース取得ポイントを次の図に示します。

図8‒87　CJMSPリソースアダプタからのMessage-driven Beanのデプロイ時のトレース取得ポイント

(2)　取得できるトレース情報

CJMSPリソースアダプタからのMessage-driven Beanのデプロイ時で取得できるトレース情報（インタフェース名，オペレーション名，およびオプション）はありません。

8.21　JavaMailのトレース取得ポイント

ここでは，JavaMailのトレース取得ポイントと，取得できるトレース情報について説明します。

8.21.1　JavaMail送信時のトレース取得ポイントと取得できるトレース情報

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒135　JavaMail送信時のトレース取得ポイントの詳細

イベントID

図中の番号※1

トレース取得ポイント

レベル

0xAD00

1

javax.mail.Transportクラスのconnect(String host, int port, String user, String password)メソッドの入り口

A

0xAD01

22

javax.mail.Transportクラスのconnect(String host, int port, String user, String password)メソッドの出口

A

0xAD02

23

javax.mail.TransportクラスのsendMessage(Message message, Address[] addresses)メソッドの入り口

A

0xAD03

38

javax.mail.TransportクラスのsendMessage(Message message, Address[] addresses)メソッドの出口

A

0xAD04

39

javax.mail.Transportクラスのcloseメソッドの入り口

A

0xAD05

44

javax.mail.Transportクラスのcloseメソッドの出口

A

0xAD06

2

コネクション取得処理の開始直前

A

0xAD07

3

コネクション取得処理の終了直後

A

0xAD08

26※2

すべての送信先情報の送信開始直前

A

0xAD09

29※2

すべての送信先情報の送信終了直後

A

0xAD0A

34※3

メール本体の送信開始直前

A

0xAD0B

35※3

メール本体の送信完了直後

A

0xAD0C

42

コネクション切断処理の開始直前

B

6

コネクション切断処理の開始直前

B

0xAD0D

43

コネクション切断処理の終了直後

B

7

コネクション切断処理の終了直後

B

0xAD0E

45

javax.mail.Transportクラスのsend(Message msg, Address[] addresses)メソッド，javax.mail.Transportクラスのsend(Message msg)メソッドの入り口

A

0xAD0F

46

javax.mail.Transportクラスのsend(Message msg, Address[] addresses)メソッド，javax.mail.Transportクラスのsend(Message msg)メソッドの出口

A

0xAD10

8※4

EHLOまたはHELOコマンド発行の開始直前

A

0xAD11

9※4

EHELOまたはHELOコマンドのレスポンスを受信した直後

A

0xAD12

10

AUTHコマンド発行の開始直前

B

14

ユーザ名，パスワードの送信の開始直前

B

16

認証の終了通知開始直前

B

18

ユーザ名の送信の開始直前

B

20

パスワードの送信の開始直前

B

24

MAILコマンド発行の開始直前

B

27※5

RCPTコマンド発行の開始直前

B

30

RSETコマンド発行の開始直前

B

32

DATAコマンド発行の開始直前

B

36

メール本文送信終了通知の発行の開始直前

B

40

QUITコマンド発行の開始直前

B

47※6

NOOPコマンドのレスポンスを受信した直後

B

12

STARTTLSコマンド発行の開始直後

B

0xAD13

11

AUTHのレスポンスを受信した直後

B

15

ユーザ名，パスワード送信のレスポンスを受信した直後

B

17

認証の終了通知完了直後

B

19

ユーザ名送信のレスポンスを受信した直後

B

21

パスワード送信のレスポンスを受信した直後

B

25

MAILコマンドのレスポンスを受信した直後

B

28※5

RCPTコマンドのレスポンスを受信した直後

B

31

RSETコマンドのレスポンスを受信した直後

B

33

DATAコマンドのレスポンスを受信した直後

B

37

メール本文送信終了通知のレスポンスを受信した直後

B

41

QUITコマンドのレスポンスを受信した直後

B

48※6

NOOPコマンド発行の開始直前

B

13

STARTTLSコマンドのレスポンスを受信した直後

B

0xAD14

4

接続時のサーバレスポンス取得を行う直前

B

0xAD15

5

接続時のサーバレスポンス取得直後

B

（凡例）A：標準　B：詳細

注※1

図8-88，図8-89，または図8-90中の番号と対応しています。

注※2

すべての送信先情報の送信開始〜終了で取得します。

注※3

32または33の取得ポイントのデータ送信処理では，送信するデータの読み込みとメールサーバへの送信を行います。例えば，添付ファイルが存在する場合は，添付ファイルのデータの読み込みとメールサーバへの送信を行います。

注※4

EHLOに失敗した場合，HELOで再度接続を試みるため，1回のサーバ接続でEHLOとHELOの2回分のログが出力される場合があります。

注※5

個々の送信先情報の送信開始〜終了で取得します。

注※6

サーバと接続中の場合にだけ取得します。

JavaMail送信時のトレース取得ポイントを以降の図に示します。

図8‒88　JavaMailの送信処理のトレース取得ポイント（javax.mail.TransportクラスのsendMessage(Message message, Address[] addresses)メソッドを使用する場合）

図8‒89　JavaMailの送信処理のトレース取得ポイント（javax.mail.Transportクラスのsend(Message msg, Address[] addresses)メソッド，javax.mail.Transportクラスのsend(Message msg)メソッドを使用する場合）

注※1　内部でjavax.mail.Transportクラスのconnectメソッドを呼び出すため，図8-88で示した1〜20の取得ポイントも出力されます。

注※2　内部でjavax.mail.TransportクラスのsendMessageメソッドを呼び出すため，図8-88で示した21〜36の取得ポイントも出力されます。

注※3　内部でjavax.mail.Transportクラスのcloseメソッドを呼び出すため，図8-88で示した37〜42の取得ポイントも出力されます。

図8‒90　JavaMailのコネクション接続確認時のトレース取得ポイント

(2)　取得できるトレース情報

JavaMail送信時に取得できるトレース情報を次の表に示します。

表8‒136　JavaMail送信時に取得できるトレース情報

図中の番号※1

イベントID

レベル

インタフェース名

オペレーション名

オプション

1

0xAD00

A

−

−

−

2

0xAD06

A

−

−

※2

3

0xAD07

A

−

−

異常時は例外のクラス名

4

0xAD14

B

通信処理を示す文字列※3

−

−

5

0xAD15

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

6

0xAD0C

B

−

−

−

7

0xAD0D

B

−

−

異常時は例外のクラス名

8

0xAD10

A

通信処理を示す文字列※3

−

−

9

0xAD11

A

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※6

異常時は例外のクラス名※7

10

0xAD12

B

通信処理を示す文字列※3

−

−

11

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

12

0xAD12

B

通信処理を示す文字列※3

−

−

13

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

14

0xAD12

B

通信処理を示す文字列※3

−

−

15

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

16

0xAD12

B

通信処理を示す文字列※3

−

−

17

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

18

0xAD12

B

通信処理を示す文字列※3

−

−

19

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

20

0xAD12

B

通信処理を示す文字列※3

−

−

21

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

22

0xAD01

A

−

−

異常時は例外のクラス名

23

0xAD02

A

−

−

−

24

0xAD12

B

通信処理を示す文字列※3

−

−

25

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

26

0xAD08

A

−

−

−

27

0xAD12

B

通信処理を示す文字列※3

−

−

28

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

29

0xAD09

A

−

−

異常時は例外のクラス名

30

0xAD12

B

通信処理を示す文字列※3

−

−

31

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

31

0xAD12

B

通信処理を示す文字列※3

−

−

32

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

33

0xAD0A

A

−

−

−

34

0xAD0B

A

−

−

異常時は例外のクラス名

35

0xAD12

B

通信処理を示す文字列※3

−

−

36

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

37

0xAD03

A

−

−

異常時は例外のクラス名

38

0xAD04

A

−

−

−

39

0xAD12

B

通信処理を示す文字列※3

−

−

40

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

41

0xAD0C

B

−

−

−

42

0xAD0D

B

−

−

異常時は例外のクラス名

43

0xAD05

A

−

−

異常時は例外のクラス名

44

0xAD0E

A

メソッド名(send(Message, Address[])またはsend(Message))

−

−

45

0xAD0F

A

メソッド名(send(Message, Address[])またはsend(Message))

−

異常時は例外のクラス名

46

0xAD12

B

通信処理を示す文字列※3

−

−

47

0xAD13

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4，※5，※6

異常時は例外のクラス名※7

（凡例）A：標準　B：詳細　−：該当なし

注※1

図8-88，図8-89，または図8-90中の番号と対応しています。

注※2

次の出力項目を出力します。

「ホスト名 ポート番号 コネクション取得時のタイムアウト値 通信のタイムアウト値」

各出力項目は半角スペースで区切って出力します。

タイムアウト値が無限に設定されている場合は0を出力します。また，ユーザがタイムアウト値を設定しなかった場合は-1を出力します。

（例）「localhost 25 10000 10000」

注※3

通信処理を示す文字列出力内容は，次の表に示すとおりです。

項番

通信処理を示す文字列

通信処理

1

−（該当なし）

コネクション取得

2

connect-mail-server

接続時のサーバレスポンス取得

3

EHLO コマンド引数

EHLOコマンド発行

4

HELO コマンド引数

HELOコマンド発行

5

AUTH LOGIN

AUTHコマンド発行

(引数に LOGIN)

6

AUTH PLAIN

AUTHコマンド発行

(引数に PLAIN)

7

AUTH DIGEST-MD5

AUTHコマンド発行

(引数に DIGEST-MD5)

8

SEND USER

ユーザ名の送信

9

SEND PASS

パスワードの送信

10

SEND USER PASS

ユーザ名とパスワードの送信

11

AUTH END

認証の完了通知

12

QUIT

QUITコマンド発行

13

MAIL コマンド引数

MAILコマンド発行

14

RCPT コマンド引数

RCPTコマンド発行

15

RSET

RSETコマンド発行

16

NOOP

NOOPコマンド発行

17

DATA

DATAコマンド発行

18

SEND MAIL

メール本体のデータ送信

19

.

メール本文送信終了通知

20

STARTTLS

STARTTLSコマンド発行

注※4

レスポンスの出力内容は，次の表に示すとおりです。

レスポンス

出力内容

レスポンスコードが不正ではない（RFC仕様内）

レスポンスコード

レスポンスコードが不正（RFC仕様外）

レスポンス1行目の先頭4文字（詳細については，KDJE59111-Eメッセージを参照してください）

1行目が4文字未満の場合

1行目のすべての文字を出力

レスポンスがない場合

空文字列を出力

注※5

QUITコマンドではmail.smtp.quitwaitまたはmail.smtps.quitwaitがtureの場合にだけレスポンスコードを出力します。

注※6

レスポンスが取得できた場合にだけレスポンスコードを出力します。通信でIOExceptionが発生した場合など，異常時にレスポンスが取得できなかったとき，レスポンスコードは出力しません。

注※7

レスポンスコードがRFC仕様外の場合，およびEOFを検知した場合には例外のクラス名は出力しません。

8.21.2　JavaMail受信時のトレース取得ポイントと取得できるトレース情報

(1)　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒137　JavaMail受信時のトレース取得ポイントの詳細

イベントID

図中の番号※1

トレース取得ポイント

レベル

0xAD80

1

javax.mail.Storeクラスのconnect(String host, int port, String user, String password)メソッドの入り口

A

0xAD81

14

javax.mail.Storeクラスのconnect(String host, int port, String user, String password)メソッドの出口

A

0xAD82

2

コネクション取得処理の開始直前

A

0xAD83

3

コネクション取得処理の終了直後

A

0xAD84

15

javax.mail.Folderクラスのopen(int)メソッドの入り口

A

0xAD85

18

javax.mail.Folderクラスのopen(int)メソッドの出口

A

0xAD86

25

javax.mail.Folderクラスのclose(boolean)メソッドの入り口

A

0xAD87

36

javax.mail.Folderクラスの close(boolean)メソッドの出口

A

0xAD88

34

コネクション切断処理の開始直前

B

6

コネクション切断処理の開始直前

B

0xAD89

35

コネクション切断処理の終了直後

B

7

コネクション切断処理の終了直後

B

0xAD8A

19※2

全メッセージ情報取得処理の開始直前

A

0xAD8B

22※2

全メッセージ情報取得処理の終了直後

A

0xAD8C

28※2

すべての削除対象のメッセージに対するDELEコマンド発行の開始直前

A

0xAD8D

31※2

すべての削除対象のメッセージに対するDELEコマンドのレスポンスを受信した直後

A

0xAD8E

10

USERコマンド発行の開始直前

A

23※3

LIST，UIDL，RETR，またはTOPコマンド発行の開始直前

A

26

RSETコマンド発行の開始直前

A

8

CAPAコマンド発行の開始直前

A

0xAD8F

11

USERコマンドのレスポンスを受信した直後

A

24※3

LIST，UIDL，RETR，またはTOPコマンドのレスポンスを受信した直後

A

27

RSETコマンドのレスポンスを受信した直後

A

9

CAPAコマンドのレスポンスを受信した直後

A

0xAD90

12

PASSコマンド発行の開始直前

B

16

STATコマンド発行の開始直前

B

20※4，※5

TOPまたはLISTコマンド発行の開始直前

B

29※5

DELEコマンド発行の開始直前

B

32

QUITコマンド発行の開始直前

B

37※6

NOOPコマンド発行の開始直前

B

0xAD91

13

PASSコマンドのレスポンスを受信した直後

B

17

STATコマンドのレスポンスを受信した直後

B

21※4，※5

TOPまたはLISTのレスポンスを受信した直後

B

30※5

DELEコマンドのレスポンスを受信した直後

B

33

QUITコマンドのレスポンスを受信した直後

B

38※6

NOOPコマンドのレスポンスを受信した直後

B

0xAD92

4

接続時のサーバレスポンス取得を行う直前

B

0xAD93

5

接続時のサーバレスポンス取得直後

B

（凡例）A：標準　B：詳細

注※1

図8-91，または図8-92中の番号と対応しています。

注※2

すべてのメールの情報の取得開始〜終了で取得します。

注※3

javax.mail.Folderクラスのfetchメソッドの第2引数にENVELOPEが指定されて呼び出された場合以外です。

注※4

javax.mail.Folderクラスのfetchメソッドの第2引数にENVELOPEが指定されて呼び出された場合だけです。

注※5

個々のメールの情報の取得開始〜終了で取得します。

注※6

サーバと接続中の場合にだけ取得します。

JavaMail受信時のトレース取得ポイントを以降の図に示します。

図8‒91　JavaMailの受信処理でのトレース取得ポイント

図8‒92　JavaMailのコネクション接続確認時の取得ポイント

(2)　取得できるトレース情報

JavaMail受信時に取得できるトレース情報を次の表に示します。

表8‒138　JavaMail受信時に取得できるトレース情報

図中の番号※1

イベントID

レベル

インタフェース名

オペレーション名

オプション

1

0xAD80

A

−

−

−

2

0xAD82

A

−

−

※2

3

0xAD83

A

−

−

異常時は例外のクラス名

4

0xAD92

B

通信処理を示す文字列※3

−

−

5

0xAD93

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

6

0xAD88

B

−

−

−

7

0xAD89

B

−

−

異常時は例外のクラス名

8

0xAD8E

A

通信処理を示す文字列※3

−

−

9

0xAD8F

A

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

10

0xAD8E

A

通信処理を示す文字列※3

−

−

11

0xAD8F

A

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

12

0xAD90

B

通信処理を示す文字列※3

−

−

13

0xAD91

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

14

0xAD81

A

−

−

異常時は例外のクラス名

15

0xAD84

A

−

−

−

16

0xAD90

B

通信処理を示す文字列※3

−

−

17

0xAD91

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

18

0xAD85

A

−

−

異常時は例外のクラス名

19※5

0xAD8A

A

−

−

−

20

0xAD90

B

通信処理を示す文字列※3

−

−

21※6

0xAD91

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

22※5

0xAD8B

A

−

−

異常時は例外のクラス名

23

0xAD8E

A

通信処理を示す文字列※3

−

−

24※6

0xAD8F

A

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

25

0xAD86

A

−

−

−

26

0xAD8E

A

通信処理を示す文字列※3

−

−

27

0xAD8F

A

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

28

0xAD8C

A

−

−

−

29

0xAD90

B

通信処理を示す文字列※3

−

−

30

0xAD91

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

31

0xAD8D

A

−

−

異常時は例外のクラス名

30

0xAD90

B

通信処理を示す文字列※3

−

−

31

0xAD91

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

32

0xAD88

B

−

−

−

33

0xAD89

B

−

−

異常時は例外のクラス名

34

0xAD87

A

−

−

異常時は例外のクラス名

35

0xAD90

B

通信処理を示す文字列※3

−

−

36

0xAD91

B

通信処理を示す文字列※3

メールサーバからのレスポンスコード※4

異常時は例外のクラス名

（凡例）A：標準　B：詳細　−：該当なし

注※1

図8-91，または図8-92中の番号と対応しています。

注※2

次の出力項目を出力します。

「ホスト名 ポート番号 コネクション取得時のタイムアウト値 通信のタイムアウト値」

各出力項目は半角スペースで区切って出力します。

タイムアウト値が無限に設定されている場合は0を出力します。また，ユーザがタイムアウト値を設定しなかった場合は-1を出力します。

（例）「localhost 25 10000 10000」

注※3

通信処理を示す文字列出力内容は，次の表に示すとおりです。

項番

通信処理を示す文字列

通信処理

1

−（該当なし）

コネクション取得

2

connect-mail-server

接続時のサーバレスポンス取得

3

USER

USERコマンド発行

4

PASS

PASSコマンド発行

5

QUIT

QUITコマンド発行

6

STAT

STATコマンド発行

7

LIST コマンド引数

LISTコマンド発行

8

UIDL コマンド引数

UIDLコマンド発行

9

RETR コマンド引数

RETRコマンド発行

10

TOP コマンド引数

TOPコマンド発行

11

DELE コマンド引数

DELEコマンド発行

12

NOOP

NOOPコマンド発行

13

RSET

RSETコマンド発行

14

CAPA

CAPAコマンド発行

注※4

レスポンス1行目が取得できた場合にだけレスポンスコードを出力します。通信でIOExceptionが発生した場合など，異常時にレスポンスが取得できなかったとき，レスポンスコードは出力しません。

注※5

レスポンスの出力内容は，次の表に示すとおりです。

レスポンス

出力内容

レスポンスコードが不正ではない（RFC仕様内）

レスポンスコード

レスポンスコードが不正（RFC仕様外）

レスポンス1行目の先頭4文字（詳細については，KDJE59112-Eメッセージを参照してください）

1行目が4文字未満の場合

1行目のすべての文字を出力

レスポンスがない場合

空文字列を出力

注※6

複数行のレスポンスを受け取るコマンド（RETRコマンド，TOPコマンド，およびUIDLコマンドの発行時）では，レスポンスの1行目が取得できた場合，リターンコード0を出力します。

8.22　JSF 2.3のトレース取得ポイント

ここでは，JSF 2.3のトレース取得ポイントと，取得できるトレース情報について説明します。

8.22.1　トレース取得ポイントおよび取得できるトレース情報

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒139　 JSF 2.3でのトレース取得ポイントの詳細

イベントID

図中の番号※¹

トレース取得ポイント

レベル

0xAF20

1

カスタムコンバータが呼び出される直前

A

0xAF21

2

カスタムコンバータの処理が終了した直後

A

0xAF22

3

カスタムバリデータが呼び出される直前

A

0xAF23

4

カスタムバリデータの処理が終了した直後

A

0xAF24

5

ValueChangeListenerが呼び出される直前

A

0xAF25

6

ValueChangeListenerの処理が終了した直後

A

0xAF26

7

ActionListenerが呼び出される直前

A

0xAF27

8

ActionListenerの処理が終了した直後

A

0xAF28

9

AjaxBehaviorListenerが呼び出される直前

A

0xAF29

10

AjaxBehaviorListenerの処理が終了した直後

A

0xAF2A

11

Action Methodが呼び出される直前

A

0xAF2B

12

Action Methodの処理が終了した直後

A

0xAF2C

13

ComponentSystemEventListenerが呼び出される直前

A

0xAF2D

14

ComponentSystemEventListenerの処理が終了した直後

A

0xAF2E

15

Websocketプッシュ接続の開始時（javax.websocket.RemoteEndpoint.Async.sendText(String)の呼び出し開始時）※2

A

0xAF2F

16

Websocketプッシュ接続の終了時（javax.websocket.RemoteEndpoint.Async.sendText(String)の呼び出し終了時）※2

A

（凡例）A：標準

注※1

図8-93〜図8-100中の番号と対応しています。

注※2

Websocket側で出力するPRFトレースの内容については，「8.28.3　データ送信時」を参照してください。

JSF 2.3でのトレース取得ポイントを次の図に示します。

図8‒93　JSF 2.3の性能解析トレース取得ポイント（カスタムコンバータ）

図8‒94　JSF 2.3の性能解析トレース取得ポイント（カスタムバリデータ）

図8‒95　JSF 2.3の性能解析トレース取得ポイント（ValueChangeListener）

図8‒96　JSF 2.3の性能解析トレース取得ポイント（ActionListener）

図8‒97　JSF 2.3の性能解析トレース取得ポイント（AjaxBehaviorListener）

図8‒98　JSF 2.3のトレース取得ポイント（Action Method）

図8‒99　JSF 2.3のトレース取得ポイント（ComponentSystemEventListener）

図8‒100　JSF 2.3の性能解析トレース取得ポイント（Websocketプッシュ接続）

8.22.2　取得できるトレース情報

JSF 2.3で取得できるトレース情報を次の表に示します。

表8‒140　JSF 2.3で取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xAF20

A

クライアントID

カスタムコンバータのクラス名とメソッド名

−

2

0xAF21

A

クライアントID

カスタムコンバータのクラス名とメソッド名

正常時

なし

異常時

例外名

3

0xAF22

A

クライアントID

カスタムバリデータのクラス名。MethodExpressionを利用してカスタムバリデータを呼び出す場合はMethodExpression。

注

引数を複数記述したMethodExpressionを使用した場合，性能解析トレースファイル（CSV形式）の列がずれることがあります。

−

4

0xAF23

A

クライアントID

カスタムバリデータのクラス名。MethodExpressionを利用してカスタムバリデータを呼び出す場合はMethodExpression。

注

引数を複数記述したMethodExpressionを使用した場合，性能解析トレースファイル（CSV形式）の列がずれることがあります。

正常時

なし

異常時

例外名

5

0xAF24

A

クライアントID

ValueChangeListenerのクラス名。

ethodExpressionを利用してValueChangeListenerを呼び出す場合，MethodExpression。

−

6

0xAF25

A

クライアントID

正常時

MethodExpressionでValueChangeListenerが呼び出されて正常終了した場合，一つの引数を持つメソッドが呼び出された時は「one argument」を出力します。

引数のないメソッドが呼ばれた時は「no argument」を出力します。

異常時

なし。

正常時

なし

異常時

例外名

7

0xAF26

A

クライアントID

ActionListenerのクラス名。

MethodExpressionを利用してActionListenerを呼び出す場合，MethodExpression。

−

8

0xAF27

A

クライアントID

正常時

MethodExpressionでActionListenerが呼び出されて正常終了した場合，一つの引数を持つメソッドが呼び出された時は「one argument」を出力します。

引数のないメソッドが呼ばれた時は「no argument」を出力します。

異常時

なし。

正常時

なし

異常時

例外名

9

0xAF28

A

クライアントID

AjaxBehaviorListenerのクラス名。

MethodExpressionを利用してAjaxBehaviorListenerを呼び出す場合，MethodExpression。

−

10

0xAF29

A

クライアントID

正常時

MethodExpressionでAjaxBehaviorListenerが呼び出されて正常終了した場合，一つの引数を持つメソッドが呼び出された時は「one argument」を出力します。

引数のないメソッドが呼ばれた時は「no argument」を出力します。

異常時

なし。

正常時

なし

異常時

例外名

11

0xAF2A

A

クライアントID

−

−

12

0xAF2B

A

クライアントID

−

正常時

なし

異常時

例外名

13

0xAF2C

A

クライアントID

ComponentSystemEventListenerのクラス名。

MethodExpressionを利用してComponentSystemEventListenerを呼び出す場合，MethodExpression。

−

14

0xAF2D

A

クライアントID

正常時

MethodExpressionでComponentSystemEventListenerが呼び出されて正常終了した場合，一つの引数を持つメソッドが呼び出された時は「one argument」を出力します。

引数のないメソッドが呼ばれた時は「no argument」を出力します。

異常時

なし。

正常時

なし

異常時

例外名

15

0xAF2E

A

WebSocketの接続を開いたリクエストのクエリ文字列

−

−

16

0xAF2F

A

WebSocketの接続を開いたリクエストのクエリ文字列

−

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-93〜図8-100中の番号と対応しています。

8.22.3　例外ログの出力

性能解析トレースの取得ポイントで付加情報（OPT）列に例外名を出力した場合は，同時に例外ログに例外の詳細情報を出力します。障害解析時には性能解析トレースで出力した例外名と例外ログを照合して障害解析を行うことができます。ただし，バッチアプリケーションなどで意図的に例外を発生させてジョブの処理を制御する目的で使用している場合，例外を発生させるたびに例外ログに詳細情報が出力されるため，ログ出力量が増加することがあります。このようなアプリケーションを実行する場合は，あらかじめ例外ログのサイズを大きく設定してください。

8.23　CDIのトレース取得ポイント

ここでは，CDIのトレース取得ポイントと，取得できるトレース情報について説明します。

8.23.1　CDIのトレース取得ポイントと取得できるトレース情報

CDIのトレース取得ポイントと取得できるトレース情報について説明します。ここでは，次の二つの場合に分けて説明します。

JSF 2.3とCDIを組み合わせて利用する場合

サーブレットとCDIを組み合わせて利用する場合

(1)　トレース取得ポイントとPRFトレース取得レベル

(a)　JSF 2.3とCDIを組み合わせて利用する場合

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒141　JSF 2.3とCDIを組み合わせて利用する場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xb002

1

CDIを利用するために必要なJSF 2.3の設定の読み込み処理開始

A

0xb003

2

CDIを利用するために必要なJSF 2.3の設定の読み込み処理終了（正常終了）

A

0xb004

3

CDIを利用するために必要なJSF 2.3の準備の処理開始

A

0xb005

4

CDIを利用するために必要なJSF 2.3の準備の処理終了（正常終了）

A

0xb006

5

EL評価準備の処理開始

B

0xb007

6

EL評価準備の処理終了（正常終了）

B

（凡例）A：標準　B：詳細

注※　図8-101および図8-102中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒101　JSF 2.3とCDIを組み合わせて利用する場合のトレース取得ポイント（JSF 2.3の設定の読み込みと準備処理時）

図8‒102　JSF 2.3とCDIを組み合わせて利用する場合のトレース取得ポイント（EL評価処理時）

(b)　サーブレット・フィルタ・リスナとCDIを組み合わせて利用する場合

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒142　サーブレット・フィルタ・リスナとCDIを組み合わせて利用する場合のトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xb008

1

サーブレット・フィルタ・リスナのインスタンス生成の処理開始

A

0xb009

2

サーブレット・フィルタ・リスナのインスタンス生成の処理終了（正常終了）

A

（凡例）A：標準

注※　図8-103中の番号と対応しています。

トレース取得ポイントを次の図に示します。

図8‒103　サーブレット・フィルタ・リスナとCDIを組み合わせて利用する場合のトレース取得ポイント

(2)　取得できるトレース情報

(a)　JSF 2.3とCDIを組み合わせて利用する場合

JSF 2.3とCDIを組み合わせて利用する場合に取得できるトレース情報を次の表に示します。

表8‒143　JSF 2.3とCDIを組み合わせて利用する場合に取得できる場合に取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xb002※2

A

WeldFacesConfigProvider

−

Webコンテナのコンテキスト情報

2

0xb003※2

A

WeldFacesConfigProvider

−

入口時刻

3

0xb004※2

A

WeldApplicationFactory

−

−

4

0xb005※2

A

WeldApplicationFactory

−

入口時刻

5

0xb006※3

B

WeldApplication

−

−

6

0xb007※3

B

WeldApplication

−

入口時刻

（凡例）A：標準　B：詳細　−：該当なし

注※1　図8-101および図8-102中の番号と対応しています。

注※2　CDIを利用するために必要なJSF 2.3の設定の読み込みと，CDIを利用するために必要なJSF 2.3の準備のトレース情報はアプリケーション開始時に取得します。

注※3　EL評価準備のトレース情報は，FacesServletが初期化処理時とJSF 2.3で指定されているEL式の評価実行時に取得します。

(b)　CDIからサーブレットを呼び出す場合

CDIからサーブレットを呼び出す場合に取得できるトレース情報を次の表に示します。

表8‒144　CDIからサーブレットを呼び出す場合に取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xb008

A

CDIServiceImpl

−

次の情報が出力されます。

Managedクラス

クラス名

コンテキストルート

2

0xb009

A

CDIServiceImpl

−

入口時刻

（凡例）A：標準　−：該当なし

注※　図8-103中の番号と対応しています。

なお，トレース情報は，サーブレット・フィルタ・リスナのインタフェース生成時に取得します。

8.24　J2EEサーバの開始・終了時のトレース取得ポイント

J2EEサーバの開始処理の完了時，およびJ2EEサーバの終了処理の開始時に，トレース情報を取得できます。

8.24.1　トレース取得ポイントとPRFトレース取得レベル

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒145　J2EEサーバでのトレース取得ポイントの詳細

イベントID

トレース取得ポイント

レベル

0x8FFE

J2EEサーバの開始処理完了（KDJE30028-Iメッセージ出力）時

A

0x8FFF

J2EEサーバのシャットダウン開始（KDJE30031-Iメッセージ出力）時

A

（凡例）A：標準

8.24.2　取得できるトレース情報

J2EEサーバの開始・終了時に取得できるトレース情報を次に示します。

イベントID

0x8FFE，0x8FFF

PRFトレース取得レベル

すべて「標準」になります。

インタフェース名，オペレーション名，およびオプション

情報は出力されません。

8.25　アプリケーションのトレース取得ポイント

アプリケーションのトレースはユーザ拡張性能解析トレースで出力されます。ユーザ拡張性能解析トレースはユーザ拡張性能解析トレース設定ファイルで指定したメソッドが呼ばれるポイントでトレース情報を出力します。

ここでは，ユーザ拡張性能解析トレースのトレースポイントとトレース情報について説明します。

8.25.1　トレース取得ポイントとPRFトレース取得レベル

ユーザ拡張性能解析トレースがトレースを出力するポイントを次に示します。

表8‒146　ユーザ拡張性能解析トレースのトレース取得ポイント

トレース取得ポイント

図中の番号※1

説明

レベル

メソッドの正常入口

1

メソッドが呼び出された直後。

ユーザ拡張性能解析トレース設定ファイルで指定したトレース取得レベル※2

メソッドの正常出口

2

メソッドが正常に終了する直前。

メソッドの異常出口

3

メソッドが例外またはエラーで異常終了する直前。

（凡例）A：標準

注※1　図8-104中の番号と対応しています。

注※2　ユーザ拡張性能解析トレース設定ファイルのトレース取得レベルの指定については，「7.5.3　ユーザ拡張性能解析トレースのトレース対象メソッドの設定」を参照してください。

参考

トレース対象のメソッド，およびトレースの対象メソッドの呼び出し先メソッドで発生した例外やエラーでトレース対象メソッドが終了する場合，メソッドの異常出口としてトレースを取得します。

トレース対象メソッド内のtry-catch構文で例外やエラーを処理していて，トレース対象メソッドの呼び出し元に例外やエラーがthrowされない場合は，メソッドの正常出口としてトレースを取得します。

ユーザ拡張性能解析トレースでのトレース取得ポイントを次の図に示します。

図8‒104　ユーザ拡張性能解析トレーストレース取得ポイント

8.25.2　取得できるトレース情報

ユーザ拡張性能解析トレースのトレース情報について説明します。

(1)　ユーザ拡張性能解析トレースのトレース情報

ユーザ拡張性能解析トレースのトレース情報を次の表に示します。

表8‒147　ユーザ拡張性能解析トレースのトレース情報

図中の番号※1

取得できる情報

イベントID

（Event）

リターンコード（Rc）

インタフェース名（INT）

オペレーション情報（OPR）

付加情報※2

（OPT／ASCII※3）

1

ユーザ拡張性能解析トレース設定ファイルで指定したイベントID。

指定しない場合は，0xae00。

0

ユーザ拡張性能解析トレース設定ファイルでユーザが指定した識別ID。

−

次の情報が出力されます。

パッケージ名

クラス名

メソッド名

2

ユーザ拡張性能解析トレース設定ファイルで指定したイベントIDに+ 1した値。

指定しない場合は，0xae01。

0

ユーザ拡張性能解析トレース設定ファイルでユーザが指定した識別ID。

メソッドの最後に実行した文の行番号※4。

次の情報が出力されます。

パッケージ名

クラス名

メソッド名

3

ユーザ拡張性能解析トレース設定ファイルで指定したイベントIDに+1した値。

指定しない場合は，0xae01。

1

ユーザ拡張性能解析トレース設定ファイルでユーザが指定した識別ID。

例外またはエラーのクラス名※5。

次の情報が出力されます。

パッケージ名

クラス名

メソッド名

（凡例）−：出力なし。

注※1　図8-104中の番号と対応しています。

注※2　ユーザ拡張性能解析トレースは，jvm.userprf.LogLevelプロパティに指定した出力レベルでメソッド名を出力します。出力レベルと各レベルで出力される情報については，「(2)　出力レベル」を参照してください。

注※3　ASCII領域に出力され付加情報が，ASCII文字で256文字を超えていた場合，前から256文字が出力されます。

注※4　jvm.userprf.LineNumberプロパティにtrueを指定した場合に出力されます。jvm.userprf.LineNumberプロパティについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.3　JavaVMで使用するプロパティ」を参照してください。

注※5　jvm.userprf.ThrowableNameプロパティにtrueを指定した場合，jvm.userprf.LogLevelプロパティに指定した出力レベル，およびjvm.userprf.ThrowableNameEditMethodプロパティに指定した編集方法でクラス名が出力されます。jvm.userprf.ThrowableNameプロパティおよびjvm.userprf.ThrowableNameEditMethodプロパティについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「14.3　JavaVMで使用するプロパティ」を参照してください。

(2)　出力レベル

jvm.userprf.LogLevelプロパティで，ユーザ拡張性能解析トレースのトレース情報の出力レベルを指定します。

出力レベルと出力されるトレース情報を次の表に示します。

表8‒148　出力レベルの指定とトレース出力情報

jvm.userprf.LogLevelプロパティの指定

付加情報（OPT／ASCII）

メソッドの異常出口のオペレーション情報（OPR）

class

クラス名

例外またはエラーのクラス名

package

完全修飾クラス名

例外またはエラーの完全修飾クラス名

method

完全修飾クラス名＋メソッド名

signature

完全修飾クラス名＋メソッド名＋メソッドの引数の型

jvm.userprf.LogLevelプロパティについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.3　JavaVMで使用するプロパティ」を参照してください。

(3)　ユーザ拡張性能解析トレースの出力例

ユーザ拡張性能解析トレースの出力例を次に示します。

(a)　トレース情報の出力内容を変更しない場合の例

トレース情報の出力内容を変更しない場合の設定例を次に示します。

簡易構築定義ファイルの設定例

：
<param>
<param-name>UserPrfText</param-name>
<param-value>
<![CDATA[
com.sample.ClassA.method1(int),test00,false
]]>
</param-value>
</param>
<param>
<param-name>add.jvm.arg</param-name>
<param-value>-Djvm.userprf.Enable=true</param-value>
</param>
：

出力内容

Event

Rc

INT

OPR

ASCII

0xae00

0

test00

（空白）

ClassA

0xae01

0

test00

（空白）

ClassA

この例では，次のようにトレース情報が出力されます。

トレース対象メソッドに対してイベントIDの設定を省略しているため，トレース対象となったメソッドが呼び出されると，イベントIDとしてメソッドの入口で0xae00，メソッドの出口で0xae01のデフォルト値が出力されます。

(b)　オペレーション情報に行番号を出力する場合の例

ユーザ拡張性能解析トレース設定ファイル（/test/setting.txt）を使用して，オペレーション情報に行番号を出力する場合の設定例を次に示します。

簡易構築定義ファイルの設定例

：
<param>
<param-name>add.jvm.arg</param-name>
<param-value>-Djvm.userprf.Enable=true</param-value>
<param-value>-Djvm.userprf.File=/test/setting.txt</param-value>
<param-value>-Djvm.userprf.LineNumber=true</param-value>
</param>
：

ユーザ拡張性能解析トレース設定ファイル（setting.txt）の設定例

com.sample.ClassA.method1(java.lang.String),test00,false,0xae77
com.sample.ClassB.method2(boolean),test01.false

出力内容

この例ではjvm.userprf.LineNumber=trueを指定しているため，メソッド正常出口でオペレーション情報（OPR領域）に，各メソッドの最後に実行された行番号が出力されます。

Event

Rc

INT

OPR

ASCII

0xae77

0

test00

（空白）

ClassA

0xae78

0

test00

324

ClassA

0xae00

0

test01

（空白）

ClassB

0xae01

0

test01

15

ClassB

この例では，次のようにトレース情報が出力されます。

ユーザ拡張性能解析トレース設定ファイルの2行目の設定では，トレース対象メソッドに対してイベントIDの設定を省略しているため，トレース対象となったメソッドが呼び出されると，イベントIDとしてメソッドの入口で0xae00，メソッドの出口で0xae01のデフォルト値が出力されます。

(c)　発生した例外またはエラーのクラス名を出力する場合の例

例外のクラス名をメソッド異常出口のオペレーション情報（OPR領域）に出力する場合の設定例を次に示します。なお，この例ではClassAのサブクラスにClassCが存在し，ClassCでClassA.method1をオーバーライドしている場合について説明します。

簡易構築定義ファイルの設定例

：
<param>
<param-name>UserPrfText</param-name>
<param-value>
<![CDATA[
com.sample.ClassA.method1(),test00,true,0xae0a
]]>
</param-value>
</param>
<param>
<param-name>add.jvm.arg</param-name>
<param-value>-Djvm.userprf.Enable=true</param-value>
<param-value>-Djvm.userprf.LineNumber=true</param-value>
<param-value>-Djvm.userprf.ThrowableName=true</param-value>
</param>
：

出力内容

Event

Rc

INT

OPR

ASCII

0xae0a

0

test00

（空白）

ClassA

0xae0b

0

test00

324

ClassA

0xae0a

0

test00

（空白）

ClassC

0xae0b

1

test00

IOException

ClassC

この例では，次のようにトレース情報が出力されます。

サブクラスフラグにtrueを設定しているため，ClassA.method1をオーバーライドしているClassC.method1の情報も出力されます。

jvm.userprf.LineNumber=trueを指定しているため，メソッド正常出口のオペレーション情報（OPR領域）に，各メソッドの最後に実行された行番号が出力されます。

jvm.userprf.ThrowableName=trueを設定しているため，発生した例外のクラス名がメソッド異常出口のオペレーション情報（OPR領域）に出力されます。ただし，jvm.userprf.LogLevelプロパティを指定していないため，発生した例外のクラス名だけが出力されます。

(d)　発生した例外またはエラーのクラス名の出力方式を変更した例

発生した例外またはエラーのクラス名の出力方式を変更した場合の設定例を次に示します。

簡易構築定義ファイルの設定例

：
<param>
<param-name>UserPrfText</param-name>
<param-value>
<![CDATA[
com.sample.ClassA.method1(),test00,false
]]>
</param-value>
</param>
<param>
<param-name>add.jvm.arg</param-name>
<param-value>-Djvm.userprf.Enable=true</param-value>
<param-value>-Djvm.userprf.ThrowableName=true</param-value>
<param-value>-Djvm.userprf.ThrowableNameEditMethod=FRONT_CUT</param-value>
<param-value>-Djvm.userprf.LogLevel=method</param-value>
</param>
：

出力内容

Event

Rc

INT

OPR

ASCII

0xae00

0

test00

（空白）

com.sample.ClassA.method1

0xae01

1

test00

*ment.IllegalClassFormatException

com.sample.ClassA.method1

この例では，次のようにトレース情報が出力されます。

トレース対象メソッドに対してイベントIDの設定を省略しているため，トレース対象となったメソッドが呼び出されると，イベントIDとしてメソッドの入口で0xae00，メソッドの出口で0xae01のデフォルト値が出力されます。

jvm.userprf.ThrowableName=trueを指定しているため，発生した例外またはエラーのクラス名がメソッドの異常出口のオペレーション情報（OPR領域）に出力されます。ただし，発生した例外名が33文字以上で，jvm.userprf.ThrowableNameEditMethod=FRONT_CUTを指定しているため，前方が省略されて出力されます。省略された部分は「*」で表示されます。

jvm.userprf.LogLevel=methodを指定しているため，付加情報（ASCII領域）に完全修飾クラス名＋メソッド名が出力されます。

8.26　JAX-RSのトレース取得ポイント

ここでは，JAX-RSのトレース取得ポイントと，取得できるトレース情報について説明します。

8.26.1　トレース取得ポイントおよび取得できるトレース情報

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒149　JAX-RSでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xD000

1

HTTPメソッド呼び出しの開始時

A

0xD001

2

HTTPメソッド呼び出しの終了時

A

0xD002

3

クライアントライブラリのHTTPメッセージ送信前

A

0xD003

4

クライアントライブラリのHTTPメッセージ受信後

A

0xD004

5

Webリソース呼び出し前

A

0xD005

6

Webリソース呼び出し後

A

（凡例）A：標準

注※　図8-105中の番号と対応しています。

JAX-RSでのトレース取得ポイントを次の図に示します。

図8‒105　JAX-RSのトレース取得ポイント

8.26.2　取得できるトレース情報

JAX-RSで取得できるトレース情報を次の表に示します。

表8‒150　JAX-RSで取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xD000

A

クラス名

メソッド名

−

2

0xD001

A

クラス名

メソッド名

正常時

なし

異常時

例外名

3

0xD002

A

クラス名

メソッド名

エンドポイントURI

4

0xD003

A

クラス名

メソッド名

正常時

なし

異常時

例外名

5

0xD004

A

クラス名

メソッド名

呼び出し種別は次のどれか

ObjectOut Invoker

ResponseOut Invoker

TypeOutInvoker

VoidOutInvoker

SseEventSinkInvoker

VoidToVoid Dispatcher

6

0xD005

A

クラス名

メソッド名

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-105中の番号と対応しています。

8.26.3　例外ログの出力

性能解析トレースの取得ポイントで付加情報（OPT）列に例外名を出力した場合は，同時に例外ログに例外の詳細情報を出力します。障害解析時には性能解析トレースで出力した例外名と例外ログを照合して障害解析を行うことができます。ただし，バッチアプリケーションなどで意図的に例外を発生させてジョブの処理を制御する目的で使用している場合，例外を発生させるたびに例外ログに詳細情報が出力されるため，ログ出力量が増加することがあります。このようなアプリケーションを実行する場合は，あらかじめ例外ログのサイズを大きく設定してください。

8.27　Java Batchのトレース取得ポイント

ここでは，Java Batchのトレース取得ポイントと，取得できるトレース情報について説明します。

8.27.1　トレース取得ポイントおよび取得できるトレース情報

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒151　Java Batchでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xD020

1

javax.batch.runtime.BatchRuntime.getJobOperator()メソッド開始直後

A

0xD021

2

javax.batch.runtime.BatchRuntime.getJobOperator()メソッド終了直前

A

0xD022

3

javax.batch.operations.JobOperator.start(String jobXMLName, Properties jobParameters)メソッド開始直後

A

0xD023

4

javax.batch.operations.JobOperator.start(String jobXMLName, Properties jobParameters)メソッド終了直前

A

0xD024

5

javax.batch.operations.JobOperator.restart(long executionId, Properties restartParameters)メソッド開始直後

A

0xD025

6

javax.batch.operations.JobOperator.restart(long executionId, Properties restartParameters)メソッド終了直前

A

0xD026

7

javax.batch.operations.JobOperator.stop(long executionId)メソッド開始直後

A

0xD027

8

javax.batch.operations.JobOperator.stop(long executionId)メソッド終了直前

A

0xD028

9

javax.batch.operations.JobOperator.abandon(long executionId)メソッド開始直後

A

0xD029

10

javax.batch.operations.JobOperator.abandon(long executionId)メソッド終了直前

A

0xD02A

11

ジョブの開始直後

A

0xD02B

12

ジョブの終了直後

A

0xD02C

13

ステップの処理開始直後

A

0xD02D

14

ステップの処理終了直前

A

0xD02E

15

javax.batch.api.chunk.ItemReaderの実装クラスのopen(Serializable checkpoint)メソッドの呼び出し直前

A

0xD02F

16

javax.batch.api.chunk.ItemReaderの実装クラスのopen(Serializable checkpoint)メソッドの処理完了直後

A

0xD030

17

javax.batch.api.chunk.ItemReaderの実装クラスのclose()メソッドの呼び出し直前

A

0xD031

18

javax.batch.api.chunk.ItemReaderの実装クラスのclose()メソッドの処理完了直後

A

0xD032

19

javax.batch.api.chunk.ItemReaderの実装クラスのreadItem()メソッドの呼び出し直前

A

0xD033

20

javax.batch.api.chunk.ItemReaderの実装クラスのreadItem()メソッドの処理完了直後

A

0xD034

21

javax.batch.api.chunk.ItemReaderの実装クラスのcheckpointInfo()メソッドの呼び出し直前

A

0xD035

22

javax.batch.api.chunk.ItemReaderの実装クラスのcheckpointInfo()メソッドの処理完了直後

A

0xD036

23

javax.batch.api.chunk.ItemProcessorの実装クラスのprocessItem(Object item)メソッドの呼び出し直前

A

0xD037

24

javax.batch.api.chunk.ItemProcessorの実装クラスのprocessItem(Object item)メソッドの処理完了直後

A

0xD038

25

javax.batch.api.chunk.ItemWriterの実装クラスのopen(Serializable checkpoint)メソッドの呼び出し直前

A

0xD039

26

javax.batch.api.chunk.ItemWriterの実装クラスのopen(Serializable checkpoint)メソッドの処理完了直後

A

0xD03A

27

javax.batch.api.chunk.ItemWriterの実装クラスのclose()メソッドの呼び出し直前

A

0xD03B

28

javax.batch.api.chunk.ItemWriterの実装クラスのclose()メソッドの処理完了直後

A

0xD03C

29

javax.batch.api.chunk.ItemWriterの実装クラスのwriteItems(List<Object> items)メソッドの呼び出し直前

A

0xD03D

30

javax.batch.api.chunk.ItemWriterの実装クラスのwriteItems(List<Object> items)メソッドの処理完了直後

A

0xD03E

31

javax.batch.api.chunk.ItemWriterの実装クラスのcheckpointInfo()メソッドの呼び出し直前

A

0xD03F0

32

javax.batch.api.chunk.ItemWriterの実装クラスのcheckpointInfo()メソッドの処理完了直後

A

0xD040

33

javax.batch.api.listener.JobListenerの実装クラスのbeforeJob()メソッドの呼び出し直前

A

0xD041

34

javax.batch.api.listener.JobListenerの実装クラスのbeforeJob()メソッドの処理完了直後

A

0xD042

35

javax.batch.api.listener.JobListenerの実装クラスのafterJob()メソッドの呼び出し直前

A

0xD043

36

javax.batch.api.listener.JobListenerの実装クラスのafterJob()メソッドの処理完了直後

A

0xD044

37

javax.batch.api.listener.StepListenerの実装クラスのbeforeStep()メソッドの呼び出し直前

A

0xD045

38

javax.batch.api.listener.StepListenerの実装クラスのbeforeStep()メソッドの処理完了直後

A

0xD046

39

javax.batch.api.listener.StepListenerの実装クラスのafterStep()メソッドの呼び出し直前

A

0xD047

40

javax.batch.api.listener.StepListenerの実装クラスのafterStep()メソッドの処理完了直後

A

0xD048

41

javax.batch.api.chunk.listener.ChunkListenerの実装クラスのbeforeChunk()メソッドの呼び出し直前

A

0xD049

42

javax.batch.api.chunk.listener.ChunkListenerの実装クラスのbeforeChunk()メソッドの処理完了直後

A

0xD04A

43

javax.batch.api.chunk.listener.ChunkListenerの実装クラスのafterChunk()メソッドの呼び出し直前

A

0xD04B

44

javax.batch.api.chunk.listener.ChunkListenerの実装クラスのafterChunk()メソッドの処理完了直後

A

0xD04C

45

javax.batch.api.chunk.listener.ChunkListenerの実装クラスのonError(Exception ex)メソッドの呼び出し直前

A

0xD04D

46

javax.batch.api.chunk.listener.ChunkListenerの実装クラスのonError(Exception ex)メソッドの処理完了直後

A

（凡例）A：標準

注※　図8-106〜図8-109中の番号と対応しています。

Java Batchでのトレース取得ポイントを次の図に示します。

図8‒106　Java Batchのトレース取得ポイント（クライアント・同期実行スレッド・非同期実行スレッド間で出力されるポイント）

図8‒107　Java Batchのトレース取得ポイント（ジョブの実行中に出力されるポイント）

図8‒108　Java Batchのトレース取得ポイント（Stepの処理中に出力されるポイント）

図8‒109　Java Batchのトレース取得ポイント（Stepの処理中に出力されるポイント（範囲Aの処理））

8.27.2　取得できるトレース情報

JAX-RSで取得できるトレース情報を次の表に示します。

表8‒152　JAX-RSで取得できるトレース情報

図中の番号※

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xD020

A

−

−

−

2

0xD021

A

−

−

正常時

なし

異常時

例外名

3

0xD022

A

−

−

JobOperator.start()の引数のjobXMLName

4

0xD023

A

instanceId

executionId

正常時

なし

異常時

例外名

5

0xD024

A

−

JobOperator.restart()の引数のexecutionId

−

6

0xD025

A

instanceId

新たに割り当てられたexecutionId

正常時

なし

異常時

例外名

7

0xD026

A

−

JobOperator.stop()の引数のexecutionId

−

8

0xD027

A

−

−

正常時

なし

異常時

例外名

9

0xD028

A

−

JobOperator.abandon()の引数のexecutionId

−

10

0xD029

A

−

−

正常時

なし

異常時

例外名

11

0xD02A

A

−

−

−

12

0xD02B

A

Job batch status

−

正常時

Job exit status

異常時

例外名

13

0xD02C

A

−

StepのID

−

14

0xD02D

A

TransitionElementが適用された場合

適用されたTransitionElement名(next, fail, end, stopのどれか)

next属性が適用された場合

next

上記以外の場合

Step batch status

次のExecutionElementが存在する場合

次に実行するExecutionElementのID

上記以外の場合

なし

正常時

Step exit status

異常時

例外名

15

0xD02E

A

呼び出されたクラス名

−

−

16

0xD02F

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

17

0xD030

A

呼び出されたクラス名

−

−

18

0xD031

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

19

0xD032

A

呼び出されたクラス名

−

−

20

0xD033

A

呼び出されたクラス名

返り値がnull

null

返り値がnull以外

not null

異常時

なし

正常時

なし

異常時

UPから発生した例外名

21

0xD034

A

呼び出されたクラス名

−

−

22

0xD035

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

23

0xD036

A

呼び出されたクラス名

−

−

24

0xD037

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

25

0xD038

A

呼び出されたクラス名

−

−

26

0xD039

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

27

0xD03A

A

呼び出されたクラス名

−

−

28

0xD03B

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

29

0xD03C

A

呼び出されたクラス名

−

−

30

0xD03D

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

31

0xD03E

A

呼び出されたクラス名

−

−

32

0xD03F0

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

33

0xD040

A

呼び出されたクラス名

−

−

34

0xD041

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

35

0xD042

A

呼び出されたクラス名

−

−

36

0xD043

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

37

0xD044

A

呼び出されたクラス名

−

−

38

0xD045

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

39

0xD046

A

呼び出されたクラス名

−

−

40

0xD047

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

41

0xD048

A

呼び出されたクラス名

−

−

42

0xD049

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

43

0xD04A

A

呼び出されたクラス名

−

−

44

0xD04B

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

45

0xD04C

A

呼び出されたクラス名

−

ChunkListener.onError(Exception)の引数のException

46

0xD04D

A

呼び出されたクラス名

−

正常時

なし

異常時

UPから発生した例外名

（凡例）A：標準　−：該当なし

注※　図8-106〜図8-109中の番号と対応しています。

8.27.3　例外ログの出力

性能解析トレースの取得ポイントで付加情報（OPT）列に例外名を出力した場合は，同時に例外ログに例外の詳細情報を出力します。障害解析時には性能解析トレースで出力した例外名と例外ログを照合して障害解析を行うことができます。ただし，バッチアプリケーションなどで意図的に例外を発生させてジョブの処理を制御する目的で使用している場合，例外を発生させるたびに例外ログに詳細情報が出力されるため，ログ出力量が増加することがあります。このようなアプリケーションを実行する場合は，あらかじめ例外ログのサイズを大きく設定してください。

8.28　WebSocketのトレース取得ポイント

WebSocketでのトレース取得ポイントの詳細について説明します。

8.28.1　オープニングハンドシェイク要求受信時

WebSocketでのトレースの取得ポイントを次に示します。

図8‒110　WebSocketのトレース取得ポイント（オープニングハンドシェイク要求受信時）

イベントID，トレースレベル，トレース取得ポイント，取得できる情報について次の表に示します。

表8‒153　WebSocketのトレース取得ポイントの詳細（オープニングハンドシェイク要求受信時）

イベントID

図中の番号※

レベル

トレース取得ポイント

取得できる情報

インタフェース名

オペレーション名

オプション

0xE100

1

A

オープニングハンドシェイク要求受信後処理開始直前

CONNECT

ハンドシェイク時のURI

−

0xE120

2

A

@OnOpenアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonOpenメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

−

0xE121

3

A

@OnOpenアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonOpenメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

なし

異常時

例外名

0xE101

4

A

オープニングハンドシェイク要求受信後処理完了直後

CONNECT

ハンドシェイク時のURI

正常時

セッションID

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-110中の番号と対応しています。

8.28.2　メッセージ受信時

WebSocketでのトレースの取得ポイントを次に示します。

図8‒111　WebSocketのトレース取得ポイント（メッセージ（データフレーム）受信時）

図8‒112　WebSocketのトレース取得ポイント（ReaderまたはInputStream型の引数を持つメッセージハンドラによる分割メッセージ受信時）

イベントID，トレースレベル，トレース取得ポイント，取得できる情報について次の表に示します。

表8‒154　WebSocketのトレース取得ポイントの詳細（メッセージ受信時）

イベントID

図中の番号※

レベル

トレース取得ポイント

取得できる情報

インタフェース名

オペレーション名

オプション

0xE102

5

A

受信したWebSocketフレームに対する処理開始直前

READ

−

−

0xE103

12

A

受信したWebSocketフレームに対する処理完了直後

READ

−

正常時

なし

異常時

例外名

0xE140

6

A

データフレーム受信後処理開始直前

MESSAGE

次のどれか

onMessage(String)

onMessage(ByteBuffer)

onPartialMessage(String)

onPartialMessage(ByteBuffer)

-

0xE141

11

A

データフレーム受信後処理完了直後

MESSAGE

次のどれか

onMessage(String)

onMessage(ByteBuffer)

onPartialMessage(String)

onPartialMessage(ByteBuffer)

正常時

なし

異常時

例外名

0xE122

7

A

@OnMessageアノテーションが付与されたメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

−

0xE123

8

A

@OnMessageアノテーションが付与されたメソッド処理完了直後

エンドポイントのクラス名

メソッド名

正常時

なし

異常時

例外名

0xE124

7

A

javax.websocket.MessageHandler.Wholeの実装クラスのonMessageメソッド呼び出し直前

javax.websocket.MessageHandler.Wholeの実装クラス名

メソッド名

−

0xE125

8

A

javax.websocket.MessageHandler.Wholeの実装クラスのonMessageメソッド処理完了直後

javax.websocket.MessageHandler.Wholeの実装クラス名

メソッド名

正常時

なし

異常時

例外名

0xE126

7

A

javax.websocket.MessageHandler.Partialの実装クラスのonMessageメソッド呼び出し直前

javax.websocket.MessageHandler.Partialの実装クラス名

メソッド名

−

0xE127

8

A

javax.websocket.MessageHandler.Partialの実装クラスのonMessageメソッド処理完了直後

javax.websocket.MessageHandler.Partialの実装クラス名

メソッド名

正常時

なし

異常時

例外名

0xE128

9

A

@OnErrorアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonErrorメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

−

0xE129

10

A

@OnErrorアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonErrorメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-111，図8-112中の番号と対応しています。

8.28.3　データ送信時

WebSocketでのトレースの取得ポイントを次に示します。

図8‒113　WebSocketのトレース取得ポイント（データ送信時）

イベントID，トレースレベル，トレース取得ポイント，取得できる情報について次の表に示します。

表8‒155　WebSocketのトレース取得ポイントの詳細（データ送信時）

イベントID

図中の番号※

レベル

トレース取得ポイント

取得できる情報

インタフェース名

オペレーション名

オプション

0xE112

14

A

WebSocketフレームの送信処理開始直前

WRITE

−

−

0xE113

15

A

WebSocketフレームの送信処理完了直後

WRITE

−

正常時

なし

異常時

例外名

0xE130

13

A

javax.websocket.RemoteEndpoint.Async.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint.Async

メソッド名（引数の型）

送信先のセッションID

0xE131

16

A

javax.websocket.RemoteEndpoint.Async.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint.Async

メソッド名（引数の型）

正常時

なし

異常時

例外名

0xE132

13

A

javax.websocket.RemoteEndpoint.Basic.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint.Basic

メソッド名（引数の型）

送信先のセッションID

0xE133

16

A

javax.websocket.RemoteEndpoint.Basic.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint.Basic

メソッド名（引数の型）

正常時

なし

異常時

例外名

0xE134

13

A

javax.websocket.RemoteEndpoint.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint

メソッド名（引数の型）

送信先のセッションID

0xE135

16

A

javax.websocket.RemoteEndpoin.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint

メソッド名（引数の型）

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-113中の番号と対応しています。

8.28.4　PING受信時

WebSocketでのトレースの取得ポイントを次に示します。

図8‒114　WebSocketのトレース取得ポイント（PING受信時）

イベントID，トレースレベル，トレース取得ポイント，取得できる情報について次の表に示します。

表8‒156　WebSocketのトレース取得ポイントの詳細（PING受信時）

イベントID

図中の番号※

レベル

トレース取得ポイント

取得できる情報

インタフェース名

オペレーション名

オプション

0xE102

5

A

受信したWebSocketフレームに対する処理開始直前

READ

−

−

0xE103

12

A

受信したWebSocketフレームに対する処理完了直後

READ

−

正常時

なし

異常時

例外名

0xE112

14

A

WebSocketフレームの送信処理開始直前

WRITE

−

−

0xE113

15

A

WebSocketフレームの送信処理完了直後

WRITE

−

正常時

なし

異常時

例外名

0xE142

17

A

PINGフレーム受信後処理開始直前

PING

−

−

0xE143

18

A

PINGフレーム受信後処理完了直後

PING

−

正常時

なし

異常時

例外名

0xE130

13

A

javax.websocket.RemoteEndpoint.Async.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint.Async

メソッド名（引数の型）

送信先のセッションID

0xE131

16

A

javax.websocket.RemoteEndpoint.Async.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint.Async

メソッド名（引数の型）

正常時

なし

異常時

例外名

0xE132

13

A

javax.websocket.RemoteEndpoint.Basic.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint.Basic

メソッド名（引数の型）

送信先のセッションID

0xE133

16

A

javax.websocket.RemoteEndpoint.Basic.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint.Basic

メソッド名（引数の型）

正常時

なし

異常時

例外名

0xE134

13

A

javax.websocket.RemoteEndpoint.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint

メソッド名（引数の型）

送信先のセッションID

0xE135

16

A

javax.websocket.RemoteEndpoin.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint

メソッド名（引数の型）

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-114中の番号と対応しています。

8.28.5　PONG受信時

WebSocketでのトレースの取得ポイントを次に示します。

図8‒115　WebSocketのトレース取得ポイント（PONG受信時）

イベントID，トレースレベル，トレース取得ポイント，取得できる情報について次の表に示します。

表8‒157　WebSocketのトレース取得ポイントの詳細（PONG受信時）

イベントID

図中の番号※

レベル

トレース取得ポイント

取得できる情報

インタフェース名

オペレーション名

オプション

0xE102

5

A

受信したWebSocketフレームに対する処理開始直前

READ

−

−

0xE103

12

A

受信したWebSocketフレームに対する処理完了直後

READ

−

正常時

なし

異常時

例外名

0xE144

19

A

PONGフレーム受信後処理開始直前

PONG

−

−

0xE145

20

A

PONGフレーム受信後処理完了直後

PONG

−

正常時

なし

異常時

例外名

0xE122

7

A

@OnMessageアノテーションが付与されたメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

−

0xE123

8

A

@OnMessageアノテーションが付与されたメソッド処理完了直後

エンドポイントのクラス名

メソッド名

正常時

なし

異常時

例外名

0xE124

7

A

javax.websocket.MessageHandler.Wholeの実装クラスのonMessageメソッド呼び出し直前

javax.websocket.MessageHandler.Wholeの実装クラス名

メソッド名

−

0xE125

8

A

javax.websocket.MessageHandler.Wholeの実装クラスのonMessageメソッド処理完了直後

javax.websocket.MessageHandler.Wholeの実装クラス名

メソッド名

正常時

なし

異常時

例外名

0xE126

7

A

javax.websocket.MessageHandler.Partialの実装クラスのonMessageメソッド呼び出し直前

javax.websocket.MessageHandler.Partialの実装クラス名

メソッド名

−

0xE127

8

A

javax.websocket.MessageHandler.Partialの実装クラスのonMessageメソッド処理完了直後

javax.websocket.MessageHandler.Partialの実装クラス名

メソッド名

正常時

なし

異常時

例外名

0xE128

9

A

@OnErrorアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonErrorメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

−

0xE129

10

A

@OnErrorアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonErrorメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-115中の番号と対応しています。

8.28.6　クロージングハンドシェイク要求受信時

WebSocketでのトレースの取得ポイントを次に示します。

図8‒116　WebSocketのトレース取得ポイント（クロージングハンドシェイク要求受信時（ペイロードデータあり））

図8‒117　WebSocketのトレース取得ポイント（クロージングハンドシェイク要求受信時（ペイロードデータなし））

イベントID，トレースレベル，トレース取得ポイント，取得できる情報について次の表に示します。

表8‒158　WebSocketのトレース取得ポイントの詳細（クロージングハンドシェイク要求受信時）

イベントID

図中の番号※

レベル

トレース取得ポイント

取得できる情報

インタフェース名

オペレーション名

オプション

0xE102

5

A

受信したWebSocketフレームに対する処理開始直前

READ

−

−

0xE103

12

A

受信したWebSocketフレームに対する処理完了直後

READ

−

正常時

なし

異常時

例外名

0xE112

14

A

WebSocketフレームの送信処理開始

直前

WRITE

−

−

0xE113

15

A

WebSocketフレームの送信処理完了直後

WRITE

−

正常時

なし

異常時

例外名

0xE146

21

A

クロージングハンドシェイク要求受信後処理または送信後処理開始直前

CLOSE

切断要因

−

0xE147

24

A

クロージングハンドシェイク要求受信後処理または送信後処理完了直後

CLOSE

切断要因

正常時

なし

異常時

例外名

0xE12A

22

A

@OnCloseアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonCloseメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

−

0xE12B

23

A

@OnCloseアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonCloseメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-116，図8-117中の番号と対応しています。

8.28.7　クロージングハンドシェイク要求送信時

WebSocketでのトレースの取得ポイントを次に示します。

図8‒118　WebSocketのトレース取得ポイント（クロージングハンドシェイク要求送信時

イベントID，トレースレベル，トレース取得ポイント，取得できる情報について次の表に示します。

表8‒159　WebSocketのトレース取得ポイントの詳細（クロージングハンドシェイク要求送信時

イベントID

図中の番号※

レベル

トレース取得ポイント

取得できる情報

インタフェース名

オペレーション名

オプション

0xE112

14

A

WebSocketフレームの送信処理開始直前

WRITE

−

−

0xE113

15

A

WebSocketフレームの送信処理完了直後

WRITE

−

正常時

なし

異常時

例外名

0xE146

21

A

クロージングハンドシェイク要求受信後処理または送信後処理開始直前

CLOSE

切断要因

−

0xE147

24

A

クロージングハンドシェイク要求受信後処理または送信後処理完了直後

CLOSE

切断要因

正常時

なし

異常時

例外名

0xE12A

22

A

@OnCloseアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonCloseメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

−

0xE12B

23

A

@OnCloseアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonCloseメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

なし

異常時

例外名

0xE136

25

A

javax.websocket.Session.closeメソッドが呼び出された直後

javax.websocket.Session

メソッド名（引数の型）

送信先のセッションID

0xE137

26

A

javax.websocket.Session.closeメソッドのリターン直前

javax.websocket.Session

メソッド名（引数の型）

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※　図8-118中の番号と対応しています。

8.29　Concurrency Utilitiesのトレース取得ポイント

ここでは，Concurrency Utilitiesのトレース取得ポイントと，取得できるトレース情報について説明します。

8.29.1　トレース取得ポイントおよび取得できるトレース情報

イベントID，トレース取得ポイント，およびPRFトレース取得レベルについて，次の表に示します。

表8‒160　Concurrency Utilitiesでのトレース取得ポイントの詳細

イベントID

図中の番号※

トレース取得ポイント

レベル

0xD050

1

新規タスク登録メソッドの入口

A

0xD051

2

新規タスク登録メソッドの出口

A

0xD052

3

タスクの呼び出し直前

A

0xD053

4

タスクの終了直後

A

0xD054

5

タスク登録時に戻り値として返されたFutureまたはScheduledFutureオブジェクトのgetメソッドの入口

A

0xD055

6

タスク登録時に戻り値として返されたFutureまたはScheduledFutureオブジェクトのgetメソッドの出口

A

0xD056

7

タスク登録時に戻り値として返されたFutureまたはScheduledFutureオブジェクトのcancelメソッドの入口

A

0xD057

8

タスク登録時に戻り値として返されたFutureまたはScheduledFutureオブジェクトのcancelメソッドの出口

A

（凡例）A：標準

注※　図8-119〜図8-126中の番号と対応しています。

次のメソッドを呼び出した場合のトレース取得ポイントを図8-119に示します。

javax.enterprise.concurrent.ManagedExecutorService#execute(Runnable)

javax.enterprise.concurrent.ManagedScheduledExecutorService#execute(Runnable)

図8‒119　Concurrency Utilitiesのトレース取得ポイント（その1）

次のメソッドを呼び出した場合のトレース取得ポイントを図8-120〜図8-124に示します。getメソッド，またはcancelメソッドを呼び出すタイミングによって，トレース取得ポイントが異なります。

タスク終了前にgetメソッドを呼び出したとき：図8-120

タスク終了後にgetメソッドを呼び出したとき：図8-121

タスク実行開始前にcancelメソッドを呼び出したとき：図8-122

タスク処理中にcancelメソッドを呼び出したとき：図8-123

タスク終了後にcancelメソッドを呼び出したとき：図8-124

javax.enterprise.concurrent.ManagedExecutorService#submit(Runnable)

javax.enterprise.concurrent.ManagedExecutorService#submit(Runnable, T)

javax.enterprise.concurrent.ManagedExecutorService#submit(Callable<T>)

javax.enterprise.concurrent.ManagedScheduledExecutorService#submit(Runnable)

javax.enterprise.concurrent.ManagedScheduledExecutorService#submit(Runnable, T)

javax.enterprise.concurrent.ManagedScheduledExecutorService#submit(Callable<T>)

javax.enterprise.concurrent.ManagedScheduledExecutorService#schedule(Callable<V>, long, TimeUnit)

javax.enterprise.concurrent.ManagedScheduledExecutorService#schedule(Callable<V>, Trigger)

javax.enterprise.concurrent.ManagedScheduledExecutorService#schedule(Runnable, long, TimeUnit)

javax.enterprise.concurrent.ManagedScheduledExecutorService#schedule(Runnable, Trigger)

javax.enterprise.concurrent.ManagedScheduledExecutorService#scheduleAtFixedRate(Runnable, long, long, TimeUnit)

javax.enterprise.concurrent.ManagedScheduledExecutorService#scheduleWithFixedDelay(Runnable, long, long, TimeUnit)

図8‒120　Concurrency Utilitiesのトレース取得ポイント（その2）（タスク終了前にgetメソッドを呼び出したとき）

図8‒121　Concurrency Utilitiesのトレース取得ポイント（その3）（タスク終了後にgetメソッドを呼び出したとき）

図8‒122　Concurrency Utilitiesのトレース取得ポイント（その4）（タスク実行開始前にcancelメソッドを呼び出したとき）

図8‒123　Concurrency Utilitiesのトレース取得ポイント（その5）（タスク処理中にcancelメソッドを呼び出したとき）

図8‒124　Concurrency Utilitiesのトレース取得ポイント（その6）（タスク終了後にcancelメソッドを呼び出したとき）

次のメソッドを呼び出した場合のトレース取得ポイントを図8-125に示します。

javax.enterprise.concurrent.ManagedExecutorService#invokeAll(Collection<? Extends Callable<T>>)

javax.enterprise.concurrent.ManagedExecutorService#invokeAll(Collection<? Extends Callable<T>>, long, TimeUnit)

javax.enterprise.concurrent.ManagedScheduledExecutorService#invokeAll(Collection<? Extends Callable<T>>)

javax.enterprise.concurrent.ManagedScheduledExecutorService#invokeAll(Collection<? Extends Callable<T>>, long, TimeUnit)

図8‒125　Concurrency Utilitiesのトレース取得ポイント（その7）

次のメソッドを呼び出した場合のトレース取得ポイントを図8-126に示します。

javax.enterprise.concurrent.ManagedExecutorService#invokeAny(Collection<? Extends Callable<T>>)

javax.enterprise.concurrent.ManagedExecutorService#invokeAny(Collection<? Extends Callable<T>>, long, TimeUnit)

javax.enterprise.concurrent.ManagedScheduledExecutorService#invokeAny(Collection<? Extends Callable<T>>)

javax.enterprise.concurrent.ManagedScheduledExecutorService#invokeAny(Collection<? Extends Callable<T>>, long, TimeUnit)

図8‒126　Concurrency Utilitiesのトレース取得ポイント（その8）

8.29.2　取得できるトレース情報

Concurrency Utilitiesで取得できるトレース情報を次の表に示します。

表8‒161　JMS Connectionインタフェースで取得できるトレース情報

図中の番号※1

イベントID

レベル

取得できる情報

インタフェース名

オペレーション名

オプション

1

0xD050

A

登録先のManagedExecutorServiceまたはManagedScheduledExecutorServiceのJNDI名

呼び出されたメソッド名（複数のタスクを指定可能なメソッド※2の場合は，カッコ内にタスク数を出力する）

新規タスクのクラス名（複数の場合はコンマ区切り）

2

0xD051

A

登録先のManagedExecutorServiceまたはManagedScheduledExecutorServiceのJNDI名

タスクID

正常時

なし

異常時

例外名

3

0xD052

A

呼び出し元のManagedExecutorServiceまたはManagedScheduledExecutorServiceのJNDI名

単一タスクの場合

タスクID

複数タスクの場合

タスクID-リスト通番

−

4

0xD053

A

呼び出し元のManagedExecutorServiceまたはManagedScheduledExecutorServiceのJNDI名

単一タスクの場合

タスクID

複数タスクの場合

タスクID-リスト通番

正常時

なし

異常時

例外名

5

0xD054

A

登録先のManagedExecutorServiceまたはManagedScheduledExecutorServiceのJNDI名

単一タスクの場合

タスクID

複数タスクの場合

タスクID-リスト番号

−

6

0xD055

A

登録先のManagedExecutorServiceまたはManagedScheduledExecutorServiceのJNDI名

単一タスクの場合

タスクID

複数タスクの場合

タスクID-リスト番号

正常時

なし

異常時

例外名

7

0xD056

A

登録先のManagedExecutorServiceまたはManagedScheduledExecutorServiceのJNDI名

単一タスクの場合

タスクID

複数タスクの場合

タスクID-リスト番号

−

8

0xD057

A

登録先のManagedExecutorServiceまたはManagedScheduledExecutorServiceのJNDI名

正常時

cancelメソッドの戻り値

異常時

なし

正常時

なし

異常時

例外名

（凡例）A：標準　−：該当なし

注※1　図8-119〜図8-126の番号と対応しています。

注※2　複数のタスクを指定可能なメソッドとは，第1引数にCollectionオブジェクトを入れるものです。実引数のCollectionオブジェクトのsizeをかっこ書きで出力します。

（例）invokeAnyメソッドで要素3つのCollectionを渡した場合

invokeAny(3)

なお，Collectionオブジェクトがnullだった場合は，カッコ内に「null」を出力します。

（例）Collectionオブジェクトがnullだった場合

invokeAny(null)

9　製品のJavaVMの機能

製品のJavaVMを使用すると，障害時の資料やチューニングで使用する情報を取得できます。この章では，製品のJavaVMが提供する機能について説明します。なお，製品のJavaVMが提供する機能の一つである明示管理ヒープ機能については，マニュアル「アプリケーションサーバ機能解説 拡張編」の「7.　明示管理ヒープ機能を使用したFullGCの抑止」を参照してください。

9.1　この章の構成

製品のJavaVMは，構成ソフトウェアであるDeveloper's Kit for Javaによって提供されます。アプリケーションサーバで動作するJ2EEサーバまたはバッチサーバのプロセスは，JavaVM上で実行されます。この節では，製品のJavaVMの機能について説明します。

製品のJavaVMの機能の概要については，「9.2　製品のJavaVMの機能の概要」を参照してください。

アプリケーションサーバで提供する製品のJavaVMの機能と参照先を次の表に示します。

表9‒1　アプリケーションサーバで提供する製品のJavaVMの機能

機能名

参照先

クラス別統計機能

9.3

インスタンス統計機能※

9.4

STATICメンバ統計機能※

9.5

参照関係情報出力機能※

9.6

統計前のGC選択機能※

9.7

Tenured領域内不要オブジェクト統計機能※

9.8

Tenured増加要因の基点オブジェクトリスト出力機能※

9.9

クラス別統計情報解析機能

9.10

Survivor領域の年齢分布情報出力機能

9.11

hndlwrap機能

9.12

JITコンパイル時のCヒープ確保量の上限値設定機能

9.13

スレッド数の上限値設定機能

9.14

製品のJavaVMの機能使用時の注意事項

9.15

注※　クラス別統計情報を出力するクラス別統計機能の一つです。

9.2　製品のJavaVMの機能の概要

アプリケーションサーバで動作するJ2EEサーバまたはバッチサーバのプロセスは，JavaVM上で実行されます。製品のJavaVMで提供している機能を次に示します。

明示管理ヒープ機能

クラス別統計機能

インスタンス統計機能

STATICメンバ統計機能

参照関係情報出力機能

統計前のGC選択機能

Tenured領域内不要オブジェクト統計機能

Tenured増加要因の基点オブジェクトリスト出力機能

クラス別統計情報解析機能※

Survivor領域の年齢分布情報出力機能

hndlwrap機能

JITコンパイル時のCヒープ確保量の上限値設定機能

スレッド数の上限値設定機能

注※

クラス別統計情報解析機能を使うと，拡張スレッドダンプファイルに出力されたクラス別統計情報をCSV形式で出力できます。

ポイント

クラス別統計機能のTenured領域内不要オブジェクト統計機能を実行した場合，次に示す機能は無効となります。

インスタンス統計機能

STATICメンバ統計機能

統計前のGC選択機能

製品のJavaVMでは，障害発生時の要因分析やシステムの状態確認に利用できるよう，ログの出力内容が拡張されています。このログは，製品のJavaVMログファイルに出力され，標準のJavaVMよりも，多くのトラブルシュート情報が取得できます。さらに，このログ（拡張verbosegc情報）を利用して適切なチューニングを実施することで，システムの可用性向上が図れます。製品のJavaVMログファイルについては，「5.7　JavaVMログ（JavaVMログファイル）」を参照してください。Java VMのチューニングについては，マニュアル「アプリケーションサーバ システム設計ガイド」の「7.　JavaVMのメモリチューニング」を参照してください。

次節以降で，製品のJavaVMの各機能について説明します。なお，明示管理ヒープ機能については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「7.　明示管理ヒープ機能を使用したFullGCの抑止」を参照してください。

9.3　クラス別統計機能

この節では，クラス別統計機能について説明します。

クラス別統計機能を使用すると，クラスごとに，参照関係にあるクラスのインスタンスの情報を拡張スレッドダンプに出力できます。

この節の構成を次の表に示します。

表9‒2　この節の構成（クラス別統計機能）

分類

タイトル

参照先

解説

クラス別統計機能の概要

9.3.1

クラス別統計情報を前提とする機能

9.3.2

運用

クラス別統計情報の出力

9.3.3

注意事項

クラス別統計情報出力時の注意事項

9.3.4

注　「実装」および「設定」について，この機能固有の説明はありません。

9.3.1　クラス別統計機能の概要

各クラスのインスタンスが持つメンバの配下にあるすべてのインスタンスのサイズを，クラスごとに統計情報として拡張スレッドダンプに出力できます。この統計情報をクラス別統計情報といいます。クラス別統計情報を複数回出力すると，GCによるJavaオブジェクトの変化や，寿命が短いJavaオブジェクトの状態，クラスごとのサイズの変化，Javaオブジェクトの親子関係などを調査できます。これらの情報は，1トランザクション当たりのメモリ使用量の測定や，メモリリークの検出などに利用できます。

クラス別統計情報は，次に示す機能によって出力されます。

インスタンス統計機能

STATICメンバ統計機能

参照関係情報出力機能

統計前のGC選択機能

Tenured領域内不要オブジェクト統計機能

Tenured増加要因の基点オブジェクトリスト出力機能

各機能については，「9.3.2　クラス別統計機能を前提とする機能」を参照してください。

また，クラス別統計機能では，Javaヒープ（Eden領域，Survivor領域およびTenured領域を合わせたもの）にあるインスタンスを統計対象とします。さらに，明示管理ヒープ機能を使用している場合には，Explicitヒープにあるインスタンスも統計対象にできます。クラス別統計情報の出力方法については，「9.3.3　クラス別統計情報の出力」を参照してください。

参考

拡張スレッドダンプは，デフォルトで出力されるように設定されています。拡張スレッドダンプを取得するための設定については，「3.3.17(1)　JavaVMのスレッドダンプ取得の設定」を参照してください。出力情報については，「5.5　JavaVMのスレッドダンプ」を参照してください。

また，クラス別統計情報は，CSV形式に出力することもできます。クラス別統計情報をCSV形式で出力する方法については，「9.10　クラス別統計情報解析機能」を参照してください。

9.3.2　クラス別統計機能を前提とする機能

クラス別統計機能を前提とする機能の種類と概要を次の表に示します。

表9‒3　クラス別統計機能を前提とする機能の種類と概要

種類

概要

参照先

インスタンス統計機能

クラスごとに，クラスのインスタンスがメンバとして持つインスタンスの合計サイズを出力します。

9.4

STATICメンバ統計機能

各クラスのstaticメンバが持つインスタンスの合計サイズを出力します。

9.5

参照関係情報出力機能

指定したクラス（インスタンス）をメンバに持つクラスの参照関係を出力します。

9.6

統計前のGC選択機能

クラス別統計情報を出力する前に，GCを実行するかどうかを選択できます。この機能は，jheapprofコマンド実行時にオプションで指定します。デフォルトの設定では，クラス別統計情報を出力する前にFullGCが実行されます。

9.7

Tenured領域内不要オブジェクト統計機能

Tenured領域内で不要となったオブジェクトを特定します。

9.8

Tenured増加要因の基点オブジェクトリスト出力機能

Tenured領域内不要オブジェクト統計機能を使って特定した，不要オブジェクトの基点となるオブジェクトの情報を出力します。

9.9

これらの機能のうち，インスタンス統計機能，STATICメンバ統計機能，参照関係情報出力機能，およびTenured増加要因の基点オブジェクトリスト出力機能は，クラス別統計機能の実行時に有効になります。

統計前のGC選択機能は，クラス別統計機能を実行する際に設定できます。クラス別統計情報の調査目的に合わせて選択してください。詳細は，「9.7.2　GCの選択の指針」を参照してください。

9.3.3　クラス別統計情報の出力

ここでは，クラス別統計情報を出力する方法について説明します。

クラス別統計情報を拡張スレッドダンプに出力するには，jheapprofコマンドを利用します。クラス別統計情報を出力したいJavaプロセスや，参照関係情報を出力したいクラスを指定して，jheapprofコマンドを実行します。

jheapprofコマンド実行時には，次の指定ができます。

クラス別統計情報にExplicitヒープの情報を出力するかどうかの指定

クラス別統計情報を取得する前にGCを実行するかどうかの指定

次に，jheapprofコマンドの実行形式と実行例，および各指定方法について説明します。

(1)　jheapprofコマンドの実行形式と実行例

jheapprofコマンドの実行形式と実行例を次に示します。jheapprofコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「jheapprof（クラス別統計情報付き拡張スレッドダンプの出力）」を参照してください。

実行形式

Windowsの場合

jheapprof [-f|-i] [-explicit|-noexplicit] [-class <クラス名>] [-fullgc|-copygc|-nogc] [-garbage|-nogarbage] [-rootobjectinfo|-norootobjectinfo] [-rootobjectinfost <サイズ>] -p <プロセスID>

UNIXの場合

jheapprof [-f|-i] [-explicit|-noexplicit] [-class <クラス名>] [-fullgc|-copygc|-nogc] [-garbage|-nogarbage] [-rootobjectinfo|-norootobjectinfo] [-rootobjectinfost <サイズ>] [-force] -p <プロセスID>

実行例

ここでは，プロセスIDが2463のJavaプロセスのクラス別統計情報を出力します。

-pオプションに，クラス別統計情報を出力したいJavaプロセスのプロセスIDを指定して，jheapprofコマンドを実行します。

% jheapprof -p 2463

jheapprofコマンドで-fオプションを省略している場合，次の確認メッセージが表示されます。

Windowsの場合

クラス別統計情報付き拡張スレッドダンプを出力するかどうかを確認するメッセージが次の形式で表示されます。

Force VM to output HitachiJavaHeapProfile: ? (y/n)

UNIXの場合

プロセスIDを確認するメッセージが次の形式で表示されます。

send SIGQUIT to 2463: ? (y/n)

yを入力します。

クラス別統計情報付き拡張スレッドダンプが出力されます。実行中のjavaプログラムでは次のメッセージが出力されます。

Writing Java core to javacore2463.030806215140.txt... OK

実行中のjavaプログラムは，カレントディレクトリにクラス別統計情報付き拡張スレッドダンプ（javacore<プロセスID>.<日時>.txt）を作成し，プログラムを継続します。

(2)　Explicitヒープの情報をクラス別統計情報に出力する場合

次の条件を満たしている場合，Explicitヒープの情報をクラス別統計情報に出力できます。

JavaVM起動オプションに-XX:+HitachiUseExplicitMemoryを指定している。

アプリケーションの実装，または実行環境（J2EEサーバ）の設定でExplicitヒープが使用されている。

Explicitヒープの情報をクラス別統計情報に出力する場合は，jheapprofコマンドに-explicitオプションを指定して実行します。

明示管理ヒープ機能については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「7.　明示管理ヒープ機能を使用したFullGCの抑止」を参照してください。

(3)　GCの実行有無を指定する場合

クラス別統計情報を出力する前に，GCを実行するかどうかを選択できます。この機能を統計前のGC選択機能といいます。クラス別統計情報を出力する前に，GCを実行するかどうかは，jheapprofコマンドに次のどれかのオプションを指定して実行します。

-fullgc

FullGCを実行してから，クラス別統計情報を出力します。

-copygc

CopyGCを実行してから，クラス別統計情報を出力します。

-nogc

GCを実行しないで，クラス別統計情報を出力します。

統計前のGC選択機能については，「9.7　統計前のGC選択機能」を参照してください。なお，Tenured領域内不要オブジェクト統計機能を実行する場合，統計前のGC選択機能は実行できません。

9.3.4　クラス別統計情報出力時の注意事項

ここでは，クラス別統計情報出力時の注意事項について説明します。

起動中のJavaプロセスに対して，-copygcオプションを設定したjheapprofコマンドを実行すると，統計前にCopyGCを実行しようとします。この場合に，Tenured領域の空き容量が足りないと，CopyGCが実行できないときがあります。

CopyGCが実行できない場合，JavaVM起動オプションに-XX:+HitachiVerboseGCを指定していても，GCが発生した時の拡張verbosegc情報は出力されません。なお，クラス別統計情報を含む拡張スレッドダンプは，GC実行時と同様に出力されます。

JavaVM起動時に，-XX:+PrintGCDetailsが指定されたJavaプロセスに対して，-copygcオプションを設定したjheapprofコマンドを実行すると，統計前にCopyGCを実行します。この場合，-XX:+PrintGCDetailsの指定によって出力されるGC情報には，「Full GC」と出力されます。

9.4　インスタンス統計機能

この節では，インスタンス統計機能について説明します。

インスタンス統計機能は，クラス別統計情報を出力する機能の一つです。クラスごとに，クラスのインスタンスの数やインスタンスの合計サイズが出力できます。

インスタンス統計機能はjheapprofコマンドを使用して出力します。jheapprofコマンドの実行形式と実行例については，「9.3.3　クラス別統計情報の出力」を参照してください。

この節の構成を次の表に示します。

表9‒4　この節の構成（インスタンス統計機能）

分類

タイトル

参照先

解説

インスタンス統計機能の概要

9.4.1

インスタンス統計機能で出力するクラス別統計情報

9.4.2

注　「実装」，「設定」，「運用」および「注意事項」について，この機能固有の説明はありません。

9.4.1　インスタンス統計機能の概要

インスタンス統計機能は，アプリケーションのメモリリークの調査で使用します。

インスタンス統計機能では，classAのインスタンス→classAのメンバ変数（クラスはclassB）→classBのインスタンス→...とインスタンスの参照関係を調べ，ほかのインスタンスへの参照を持たないインスタンスのサイズをそのインスタンスをメンバに持つクラスに再帰的に加算します。つまり，インスタンス統計機能では，各クラスのインスタンスが参照しているインスタンスの合計サイズが出力されます。

メモリリークの原因を調査する場合は，次のように，メモリリークを調査したいアプリケーションの処理の前後でインスタンス統計機能を実行し，1.と3.のインスタンス数やインスタンスの合計サイズの差分を取り，その増加量を見てメモリリークの原因となっているクラスを特定します。

インスタンス統計機能を実行します。

メモリリークを調査したいアプリケーションの処理を実行します。

インスタンス統計機能を実行します。

なお，インスタンス統計機能は，各クラスのインスタンスが参照しているすべてのインスタンスのサイズを再帰的に加算するため，各クラスのインスタンスだけのサイズ（参照しているインスタンスのサイズを含まないサイズ）を調べることはできません。

インスタンス統計機能では，明示管理ヒープ機能を使用している場合に，Explicitヒープのインスタンスを統計対象とするかどうかによって，クラス別統計情報の出力結果が変わります。なお，Explicitヒープのインスタンスを統計対象とする場合には，jheapprofコマンドに-explicitオプションを指定して実行します。

統計対象ごとの出力結果について，次の図に示すインスタンス構造を例に説明します。

図9‒1　インスタンス構造の例

Explicitヒープを統計対象に含む場合は，インスタンスa1，b1，b2，c1，およびc2がクラス別統計情報の対象となります。Explicitヒープを統計対象に含まない場合は，インスタンスa1，b2，c2がクラス別統計情報の対象となります。

統計対象ごとのインスタンス数とインスタンスの合計サイズを次の表に示します。

表9‒5　統計対象ごとのインスタンス数とインスタンスの合計サイズ

jheapprofコマンドの引数

統計対象

クラスA

クラスB

クラスC

インスタンス数

合計サイズ※

インスタンス数

合計サイズ※

インスタンス数※

合計サイズ※

-explicit

Javaヒープ

Explicitヒープ

1

122

2

22

2

2

-noexplicit

Javaヒープ

1

111

1

11

1

1

注※　合計サイズは，インスタンスの合計サイズを示します。単位はバイトです。

各クラスのインスタンスの合計サイズの算出式を次に示します。

Explicitヒープを統計対象に含む場合

クラスAの場合：a1+b1+b2+c1+c2

クラスBの場合：b1+b2+c1+c2

クラスCの場合：c1+c2

Explicitヒープを統計対象に含まない場合

クラスAの場合：a1+b2+c2

クラスBの場合：b2+c2

（インスタンスb1が対象外でも，その配下にあるインスタンスb2，c2が対象であるため，参照関係にあるそれらのインスタンスのサイズがクラスBに加算される）

クラスCの場合：c2

インスタンス統計機能では，基点となるオブジェクトから次の順序に従って参照されるオブジェクトの参照関係を調べます。基点となるオブジェクトは，ほかの参照関係で調べられていないオブジェクトが該当します。1.，2.，3.は調査の優先順を示します。

Javaヒープ内のアドレスの低い順

明示管理ヒープ内のアドレスの低い順

参照先のオブジェクトが調査済みの場合は，分岐点まで戻って参照関係を調べます。

また，参照先のオブジェクトがほかの参照関係の基点となるオブジェクトである場合は，参照先オブジェクトとして扱います。すべての基点となるオブジェクトがなくなるまで参照関係を調べます。

インスタンス統計機能の場合，インスタンス数には各クラスのインスタンス数が出力されます。インスタンスの合計サイズには，次の内容が出力されます。

基点となるオブジェクトのサイズは，該当するクラスに加算されます。参照先のオブジェクトのサイズは，該当するクラスに加算され，さらに基点となるオブジェクト，および該当するクラスまでの参照関係にあるすべてのオブジェクトの該当するクラスにも加算されます。

9.4.2　インスタンス統計機能で出力するクラス別統計情報

ここでは，インスタンス統計機能で出力するクラス別統計情報の出力形式，出力項目および出力例について説明します。

(1)　出力形式と出力項目

インスタンス統計機能で出力するクラス別統計情報の出力形式を次に示します。

出力形式

Java Heap Profile
-----------------------
________________Size__Instances__Class________________
   <total_size>       <Instance_count>   <class_name>
   <total_size>       <Instance_count>   <class_name>
...

出力項目

出力形式で示した各項目について説明します。

表9‒6　出力項目（インスタンス統計機能）

出力項目

意味

<total_size>

インスタンスの合計サイズがバイト単位で出力されます。

<Instance_count>

インスタンスの数が出力されます。

<class_name>

クラス名が出力されます。

(2)　出力例

インスタンス統計機能で出力するクラス別統計情報の出力例を，次のソースを例にして説明します。

public class instance {
  public static void main(String args[]) {
    classA cls_a = new classA();
    try {
      Thread.sleep(20000);
    } catch (Exception e) {}
  }
}
class classA {
  classB a1;
  classC a2;
  classA() {
    a1 = new classB();
    a2 = new classC();
  }
}
class classB {
  classD b1;
  String b2;
  classB() {
    b1 = new classD();
    b2 = null;
  }
}
class classC {
  String c1, c2;
  classC() {
    c1 = null;
    c2 = null;
  }
}
class classD {
  String d1, d2;
  classD() {
    d1 = null;
    d2 = null;
  }
}

このソースの場合の，インスタンス構造を次の図に示します。

図9‒2　インスタンス構造（インスタンス統計機能）

このようなインスタンス構造の場合，インスタンス統計機能では，次のように各クラスのサイズを加算します。

classAのサイズ：a1+a2+ b1+b2+ c1+c2+ d1+d2

classBのサイズ：b1+b2+ d1+d2

classCのサイズ：c1+c2

classDのサイズ：d1+d2

インスタンス統計機能の出力結果を次の図に示します。

図9‒3　出力結果（インスタンス統計機能）

9.5　STATICメンバ統計機能

この節では，STATICメンバ統計機能について説明します。

STATICメンバ統計機能は，クラス別統計情報を出力する機能の一つです。クラスごとに，staticメンバが持つインスタンスの合計サイズが出力できます。

STATICメンバ統計機能はjheapprofコマンドを使用して出力します。jheapprofコマンドの実行形式と実行例については，「9.3.3　クラス別統計情報の出力」を参照してください。

この節の構成を次の表に示します。

表9‒7　この節の構成（STATICメンバ統計機能）

分類

タイトル

参照先

解説

STATICメンバ統計機能の概要

9.5.1

STATICメンバ統計機能で出力するクラス別統計情報

9.5.2

注　「実装」，「設定」，「運用」および「注意事項」について，この機能固有の説明はありません。

9.5.1　STATICメンバ統計機能の概要

STATICメンバ統計機能は，インスタンス統計機能と同様に，アプリケーションのメモリリークの調査で使用します。

インスタンス統計機能と異なる点は，インスタンス統計機能が最初に取り出したインスタンスの非staticフィールドから参照しているインスタンスのサイズを再帰的に加算するのに対し，STATICメンバ統計機能は最初に取り出したインスタンスのstaticフィールド（クラスのstaticフィールド）から参照しているインスタンスのサイズを再帰的に加算するという点です。これによって，各クラスのstaticメンバが持つインスタンスの合計サイズを得ることができます。ただし，最初に取り出すインスタンス以外では，インスタンス統計機能およびSTATICメンバ統計機能共に，インスタンスの非staticメンバを基に参照関係を調べます。

インスタンス統計機能とSTATICメンバ統計機能の違いについては，「9.5.2(2)　出力例」を参照してください。

メモリリークの原因を調査する場合は，次のように，メモリリークを調査したいアプリケーションの処理の前後でSTATICメンバ統計機能を実行し，1.と3.のインスタンス数やインスタンスの合計サイズの差分を取り，その増加量を見てメモリリークの原因となっているクラスを特定します。

STATICメンバ統計機能を実行します。

メモリリークを調査したいアプリケーションの処理を実行します。

STATICメンバ統計機能を実行します。

なお，STATICメンバ統計機能は，各クラスのstaticフィールドが参照しているインスタンスのサイズを再帰的に加算するため，各クラスのインスタンスだけのサイズ（参照しているインスタンスのサイズを含まないサイズ）の合計を調べることはできません。

STATICメンバ統計機能では，基点となるオブジェクトから参照関係を調べます。基点となるオブジェクトは，JavaVMが持つすべてのクラスのSTATICメンバが参照し，ほかの参照関係で調べられていないオブジェクトが該当します。

また，参照先のオブジェクトが調査済みの場合は，分岐点まで戻って参照関係を調べます。すべての基点となるオブジェクトがなくなるまで参照関係を調べます。

STATICメンバ統計機能の場合，インスタンス数とインスタンスの合計サイズには，次の内容が出力されます。

参照関係にあるすべてのオブジェクトのサイズとオブジェクト数を基点となるオブジェクトに合計します。この値を基点となるオブジェクトが参照しているSTATICメンバを持つクラスに合計して統計値とします。

9.5.2　STATICメンバ統計機能で出力するクラス別統計情報

ここでは，STATICメンバ統計機能で出力するクラス別統計情報の出力形式，出力項目および出力例について説明します。

(1)　出力形式と出力項目

STATICメンバ統計機能で出力するクラス別統計情報の出力形式を次に示します。

出力形式

Java Heap Dump Static Profile
-----------------------
________________Size__Instances__Class________________
   <total_size>       <Instance_count>   <class_name>
   <total_size>       <Instance_count>   <class_name>
...

出力項目

出力形式で示した各項目について説明します。

表9‒8　出力項目（STATICメンバ統計機能）

出力項目

意味

<total_size>

インスタンスの合計サイズがバイト単位で出力されます。

<Instance_count>

インスタンスの数が出力されます。

<class_name>

クラス名が出力されます。

(2)　出力例

STATICメンバ統計機能で出力するクラス別統計情報の出力例を，次のソースを例にして説明します。

public class static_instance {
  public static void main(String args[]) {
    classA cls_a;
    classB cls_b;
    classC cls_c;

    cls_a = new classA();
    cls_b = new classB();
    cls_c = new classC();
    cls_b.cls_c = cls_c;
    cls_a.cls_b = cls_b;

    try {
      Thread.sleep(20000);
    } catch (Exception e) {}
  }
}
class classA {
  static classB cls_b;
}
class classB {
  classC cls_c;
}
class classC {
}

STATICメンバ統計機能の出力結果を次の図に示します。

図9‒4　出力結果（STATICメンバ統計機能）

また，上記のソースの場合，インスタンス統計機能とSTATICメンバ統計機能では，参照関係に違いがあります。インスタンス統計機能とSTATICメンバ統計機能の参照関係の相違を次の図に示します。

図9‒5　インスタンス統計機能とSTATICメンバ統計機能の参照関係の相違

それぞれ機能の参照関係は次のようになっています。

インスタンス統計機能の参照関係

インスタンスAのインスタンス変数 cls_b → インスタンスBのインスタンス変数 cls_c → インスタンスC

STATICメンバ統計機能の参照関係

クラスAのクラス変数cls_b → インスタンスBのインスタンス変数cls_c → インスタンスC

9.6　参照関係情報出力機能

この節では，参照関係情報出力機能について説明します。

参照関係情報出力機能は，指定したクラスのインスタンスの参照関係が先頭から順番に出力できます。

この節の構成を次の表に示します。

表9‒9　この節の構成（参照関係情報出力機能）

分類

タイトル

参照先

解説

参照関係情報出力機能の概要

9.6.1

参照関係情報出力機能で出力するクラス別統計情報

9.6.2

staticフィールドを基点とした参照関係情報出力機能で出力するクラス別統計情報

9.6.3

注意事項

staticフィールドを基点とした参照関係情報出力時の注意事項

9.6.4

注　「実装」，「設定」，および「運用」について，この機能固有の説明はありません。

9.6.1　参照関係情報出力機能の概要

jheapprofコマンドの-classオプションに指定したクラスのインスタンスがどのクラスから参照されているかを，インスタンスの参照関係の先頭から順番に出力します。

指定したクラスのインスタンスが複数ある場合は，該当するすべてのインスタンスが出力されます。同じ名前のインスタンスが複数ある場合でも，インスタンス名のあとに次の情報が出力されるため，別のインスタンスかどうか識別できます。

インスタンスのアドレス

インスタンスが所属している領域名称

参照関係情報出力機能では，基点となるオブジェクトから次の順序に従って参照されるオブジェクトの参照関係を調べます。基点となるオブジェクトは，ほかの参照関係で調べられていないオブジェクトが該当します。1.，2.，3.は調査の優先順を示します。

Javaヒープ内のアドレスの低い順

明示管理ヒープ内のアドレスの低い順

参照先のオブジェクトが-classオプションで指定したクラスの場合，参照関係情報には，基点となるオブジェクトから-classオプションで指定したクラスのオブジェクトまでの参照関係が出力されます。参照先のオブジェクトが調査済みの場合は，分岐点まで戻って参照関係を調べます。参照先のオブジェクトがほかの参照関係の基点となるオブジェクトである場合は，参照先オブジェクトとして扱います。すべての基点となるオブジェクトがなくなるまで参照関係を調べます。

また，jheapprofコマンドで-staticrootオプションを指定すると，staticフィールドを基点とした参照関係情報出力機能が有効になります。この機能は，参照関係情報出力機能を前提としています。staticフィールドを基点とした参照関係情報出力機能では，参照関係情報出力機能が出力する参照関係情報に，staticフィールドを基点とした参照関係情報を追加して出力します。この出力情報は，staticフィールドを基点とした参照関係によるメモリリークの原因を究明するために使用します。

メモリリーク状態の参照関係の例を次に示します。

図の参照関係のインスタンス「d/Cd」にstaticフィールドを基点とした参照関係情報出力機能を実行すると，次の参照関係情報が出力されます。

この情報を基に，リーク対策として，次のフィールドの参照をクリアします。このことで，「d/Cd」はGCで回収されるため，メモリリークを解消することができます。

インスタンス「c/Cc」のインスタンスフィールド「id1」

クラス「Ca」のstaticフィールド「sd1」

参照関係情報出力機能の参照関係情報については，「9.6.2　参照関係情報出力機能で出力するクラス別統計情報」を，staticフィールドを基点とした参照関係情報については，「9.6.3　staticフィールドを基点とした参照関係情報出力機能で出力するクラス別統計情報」を参照してください。

9.6.2　参照関係情報出力機能で出力するクラス別統計情報

ここでは，参照関係情報出力機能で出力するクラス別統計情報の出力形式，出力項目および出力例について説明します。

(1)　出力形式と出力項目

参照関係情報出力機能で出力するクラス別統計情報の出力形式を次に示します。

出力形式

Reference of class <オプション指定クラス名>
--------------------------------------------※
<クラス名>(<アドレス>)[<領域名称>]
  <クラス名>(<アドレス>)[<領域名称>]
    <オプション指定クラス名>(<アドレス>)[<領域名称>]
------
<クラス名>(<アドレス>)[<領域名称>]
  java.lang.ref.Finalizer<<繰り返し数> times>
    <クラス名>(<アドレス>)[<領域名称>]
      <クラス名>(<アドレス>)[<領域名称>]
        <オプション指定クラス名>(<アドレス>)[<領域名称>]
------
...

注※

<オプション指定クラス名>の文字数に19を加算した数の「-（ハイフン）」が出力されます。

出力項目

出力形式で示した各項目について説明します。

表9‒10　出力項目（参照関係情報出力機能）

出力項目

意味

<クラス名>

jheapprofコマンドの-classオプションに指定したクラスのインスタンスが参照するクラスの名称が出力されます。

<アドレス>

インスタンスのアドレスが出力されます。

<領域名称>

インスタンスが所属する領域が出力されます。

Eden：Eden領域を示します。

Survivor：Survivor領域を示します。

Tenured：Tenured領域を示します。

EM(eid=<id>)：Explicitメモリブロックを示します。

<オプション指定クラス名>

jheapprofコマンドの-classオプションに指定したクラス名が出力されます。

java.lang.ref.Finalizer

finalize()メソッドを持つクラスで生成するjava.lang.ref.Finalizerのオブジェクトを一つにまとめて出力することを示します。

<繰り返し数>

Finalizerインスタンスの参照が連続した回数が出力されます。

(2)　出力例

参照関係情報出力機能で出力するクラス別統計情報の出力例を，次のソースを例にして説明します。

public class instance2 {
  public static void main(String args[]) {
    classA cls_a1 = new classA();    classA cls_a2 = new classA();
    classB cls_b1 = new classB();    classB cls_b2 = new classB();
    classC cls_c1 = new classC();    classC cls_c2 = new classC();
    classC cls_c3 = new classC();    classC cls_c4 = new classC();
    cls_a1.cls_a = cls_a2;    cls_a1.cls_b = cls_b1;
    cls_a1.cls_c = cls_c1;    cls_a2.cls_b = cls_b2;
    cls_b1.cls_c = cls_c2;    cls_b2.cls_c = cls_c3;
    cls_c1.cls_c = cls_c4;
    try {
      Thread.sleep(20000);
    } catch (Exception e) {}
  }
}
class classA {
  classA cls_a;
  classB cls_b;
  classC cls_c;

  classA() {
    classB cls_b;
  }
}
class classB {
  classC cls_c;
}
class classC {
  classC cls_c;
}

インスタンス構造を次の図に示します。

図9‒6　インスタンス構造（参照関係情報出力機能）

参照関係情報出力機能の出力結果を次の図に示します。この場合，jheapprofコマンドに引数「-class <クラス名>」を指定して実行します。

図9‒7　出力結果（参照関係情報出力機能）

classAのアドレスは，すべて同じアドレス（0x10766840）になっています。したがって，classAはすべて同じインスタンスであることがわかります。一方，(1)と(4)のclassBは，アドレスが異なっているので，別のインスタンスであることがわかります。

なお，GCの発生によってインスタンスのメモリ上の配置が変化します。そのため，アドレスおよび領域名称は，出力するたびに変化する場合があります。

9.6.3　staticフィールドを基点とした参照関係情報出力機能で出力するクラス別統計情報

ここでは，staticフィールドを基点とした参照関係情報出力機能で出力するクラス別統計情報の出力形式，出力項目および出力例について説明します。

(1)　出力形式と出力項目

出力形式

staticフィールドを基点とした参照関係情報出力機能で出力するクラス別統計情報の出力形式を次に示します。

Reference of class <オプション指定クラス名> from static field
-------------------------------------------------------------※1
static field <staticフィールド宣言クラス名>※2.<staticフィールド名>※2
<クラス名>(<アドレス>)[<領域名称>]
  <クラス名>(<アドレス>)[<領域名称>]
    <オプション指定クラス名>(<アドレス>)[<領域名称>]
------
...

注※1

<オプション指定クラス名>の文字数に37を加算した数の「-（ハイフン）」が出力されます。

注※2

参照関係の基点を示します。

出力項目

出力形式で示した各項目について説明します。

表9‒11　出力項目（staticフィールドを基点とした参照関係情報出力機能）

出力項目

意味

<staticフィールド宣言クラス名>

基点となるstaticフィールドを宣言しているクラス名が出力されます。

<staticフィールド名>

基点となるstaticフィールドの名称が出力されます。

<クラス名>

jheapprofコマンドの-classオプションに指定したクラスのインスタンスを参照する，インスタンスのクラスの名称が出力されます。

<アドレス>

インスタンスのアドレスが出力されます。

<領域名称>

インスタンスが所属する領域が出力されます。

Eden：Eden領域を示します。

Survivor：Survivor領域を示します。

Tenured：Tenured領域を示します。

EM(eid=<id>)：Explicitメモリブロックを示します。

<オプション指定クラス名>

jheapprofコマンドの-classオプションに指定したクラス名が出力されます。

(2)　出力例

staticフィールドを基点とした参照関係情報出力機能で出力するクラス別統計情報の出力例を，次のソースを例にして説明します。

import JP.co.Hitachi.soft.jvm.MemoryArea.*;
public class static_reference {
  public static void main(String args[]) {
   try {
      classA cls_a1 = new classA();
      classB cls_b1 = new classB();
      classB cls_b2 = new classB();
      classC cls_c1 = new classC();
      classC cls_c2 = new classC();
      classC cls_c3 = new classC();
      BasicExplicitMemory emem = new BasicExplicitMemory();
      classC cls_c4 = (classC)emem.newInstance(classC.class);
      cls_a1.s_cls_a = cls_a1;
      cls_a1.s_cls_b = cls_b1;
      cls_a1.s_cls_c = cls_c1;
      cls_a1.cls_b = cls_b2;
      cls_b1.cls_c = cls_c2;
      cls_b2.cls_c = cls_c3;
      cls_c1.cls_c = cls_c4;
      Thread.sleep(20000);
    } catch (Exception e) {e.printStackTrace();}
  }
}
class classA {
  static classA s_cls_a;
  static classB s_cls_b;
  static classC s_cls_c;
  classB cls_b;
}
class classB {
  classC cls_c;
}
class classC {
  classC cls_c;
  public classC(){
  }
}

インスタンス構造を次の図に示します。

図9‒8　インスタンス構造（staticフィールドを基点とした参照関係情報出力機能）

staticフィールドを基点とした参照関係情報出力機能の出力結果を次の図に示します。この場合，jheapprofコマンドに引数「-class <クラス名> -staticroot」を指定して実行します。

図9‒9　出力結果（staticフィールドを基点とした参照関係情報出力機能）

9.6.4　staticフィールドを基点とした参照関係情報出力時の注意事項

jheapprofコマンドの実行時間は，staticフィールドを基点とした参照関係情報出力機能を有効にすると，staticフィールドを基点とした参照関係情報出力機能が無効な場合に比べて，参照関係情報出力機能の実行時間分長くなります。

9.7　統計前のGC選択機能

この節では，統計前のGC選択機能について説明します。

統計前のGC選択機能を使用すると，クラス別統計情報の出力前に実行する処理を選択できます。

この節の構成を次の表に示します。

表9‒12　この節の構成（統計前のGC選択機能）

分類

タイトル

参照先

解説

統計前のGC選択機能の概要

9.7.1

GCの選択の指針

9.7.2

注　「実装」，「設定」，「運用」，および「注意事項」について，この機能固有の説明はありません。

9.7.1　統計前のGC選択機能の概要

クラス別統計機能を実行すると，拡張スレッドダンプへクラス別統計情報が出力できます。統計前のGC選択機能では，クラス別統計情報を出力する前に実施する処理を選択できます。調査目的に合わせて，実施する処理を選択することで，Javaオブジェクトのさまざまな変化の様子をクラス別統計情報に取得できます。

統計前のGC選択機能を使用する場合，jheapprofコマンドの引数で実行する処理を指定します。クラス別統計機能実行前に実施できる処理とjheapprofコマンドの引数を次の表に示します。

表9‒13　クラス別統計機能実行前に実施できる処理とjheapprofコマンドの引数

処理の種類

処理内容

jheapprofコマンドの引数

FullGCの実行

Tenured領域も含む，JavaVM固有領域全体を対象に，使用済みのオブジェクトを回収します。

-fullgc

CopyGCの実行

Eden領域およびSurvivor領域だけを対象に，使用済みのオブジェクトを回収します。

-copygc

GCを実行しない

使用済みのオブジェクトがあっても回収しません。

-nogc

なお，JavaVM起動オプションで-XX:+HitachiVerboseGCおよび-XX:+HitachiVerboseGCPrintCauseを指定している場合にクラス別統計機能を実行すると，拡張verbosegc情報に次の情報が出力されます。

GC種別

拡張スレッドダンプにGCが発生した要因

これらの情報は，jheapprofコマンドに指定する引数によって，出力される情報が異なります。jheapprofコマンドの引数と出力情報の関係を次の表に示します。

表9‒14　jheapprofコマンドの引数と出力情報の関係

jheapprofコマンドの引数

GC種別

GCが発生した要因

-fullgc

FullGC

JHeapProf Command

-copygc

GC

JHeapProf Command

9.7.2　GCの選択の指針

統計前のGC選択機能で，どの処理を指定するかは，出力されるクラス別統計情報の調査目的によって異なります。

ここでは，調査目的に合わせて，処理を選択する指針について説明します。

統計前のGC選択機能で選択できる処理は，jheapprofコマンドの引数で指定します。処理は，どのオブジェクトを調査対象とするか，クラス別統計情報をどのような調査で使用するかによって選択します。

処理の選択の指針を次の表に示します。

表9‒15　処理の選択の指針

処理

（jheapprofコマンドの引数）

調査対象

クラス別統計情報の調査方法の例

FullGCの実行

（-fullgc）

FullGCによるオブジェクトの変化

FullGCによって，使用済みのオブジェクトが回収されるため，Javaヒープのメモリリークの原因となるオブジェクトを特定できます。

CopyGCの実行

（-copygc）

CopyGCによるオブジェクトの変化

CopyGCによって，Tenured領域へ移動する寿命の長いオブジェクトを特定できます。この情報から，FullGCの発生頻度が増大する原因となるオブジェクトを特定できます。

GCは実行しない

（-nogc）※

GCの実行で回収されてしまう短寿命オブジェクト

使用済みのオブジェクトを含むすべてのオブジェクトの情報が出力されます。CopyGCが多発している場合などに，その原因となるメモリ占有率の高いオブジェクト（超大オブジェクト）を特定できます。

注※

jheapprofコマンドの引数に-nogcを指定した場合，すべての寿命の短いオブジェクトの情報が出力されるため，ログの出力量が増加します。

9.8　Tenured領域内不要オブジェクト統計機能

この節では，Tenured領域内不要オブジェクト統計機能について説明します。

Tenured領域内不要オブジェクト統計機能は，クラス別統計情報を出力する機能の一つです。Tenured領域内不要オブジェクト統計機能を使用すると，Tenured領域内で不要となったオブジェクトを特定できます。

Tenured領域内不要オブジェクト統計機能を使用する場合は，jheapprofコマンドの引数に-garbageを指定します。jheapprofコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「jheapprof（クラス別統計情報付き拡張スレッドダンプの出力）」を参照してください。

この節の構成を次の表に示します。

表9‒16　この節の構成（Tenured領域内不要オブジェクト統計機能）

分類

タイトル

参照先

解説

Tenured領域内不要オブジェクト統計機能の概要

9.8.1

Tenured領域内不要オブジェクト統計機能で出力するクラス別統計情報

9.8.2

注意事項

Tenured領域内不要オブジェクト統計機能の実行に関する注意事項

9.8.3

注　「実装」，「設定」および「運用」について，この機能固有の説明はありません。

9.8.1　Tenured領域内不要オブジェクト統計機能の概要

Tenured領域内不要オブジェクト統計機能では，Tenured領域内に蓄積された不要となったオブジェクトだけを特定して，スレッドダンプファイルに出力します。Tenured領域内不要オブジェクト統計機能の仕組みについて説明します。

(1)　不要なオブジェクトのサイズの出力

CopyGCの繰り返しによって，長寿命オブジェクトがTenured領域に蓄積します。蓄積した長寿命オブジェクトのうち，時間が経過して用途を失ったオブジェクトは，不要なオブジェクトとなってTenured領域内に残ります。その後，メモリがいっぱいになったタイミングでFullGCが発生します。CopyGCの発生からFullGCの発生までのTenured領域の使用量は，Tenured領域内不要オブジェクト統計機能，およびインスタンス統計機能で確認できます。

Tenured領域内不要オブジェクト統計機能，およびインスタンス統計機能を使って特定できる内容を次の図に示します。

図9‒10　Tenured領域内不要オブジェクト統計機能，およびインスタンス統計機能を使って特定できる内容

統計前GCを実施しないでインスタンス統計機能を実行した場合，図9-10の3.のサイズが出力されます。このサイズは，図9-10の1.に該当するTenured領域内で不要となったオブジェクトのサイズ，および図9-10の2.に該当するTenured領域内で使用中のオブジェクトを含んだTenured領域内のメモリ使用状況になります。

一方，Tenured領域内不要オブジェクト統計機能を実行した場合は，図9-10の2.の使用中のオブジェクトを除いたTenured領域内のメモリ使用状況（図9-10の1.に該当）を出力できます。Tenured領域内不要オブジェクト統計機能を使うことで，Tenured領域の増加要因となる不要となったオブジェクトを特定できるため，FullGCを抑止できます。

(2)　不要なオブジェクトの参照関係の確認

Tenured領域内不要オブジェクト統計機能では，基点となるオブジェクトはTenured領域内のアドレスの低い順に検索されます。検索されたオブジェクトの中でも，ほかの参照関係で調べられていないオブジェクトが基点となるオブジェクトになります。

参照先のオブジェクトが調査済みの場合は，分岐点まで戻って参照関係を調べます。また，参照先のオブジェクトがほかの参照関係の基点となるオブジェクトである場合は，参照先オブジェクトとして扱います。すべての基点となるオブジェクトがなくなるまで参照関係を調べます。

Tenured領域内不要オブジェクト統計機能の場合，インスタンス数，およびインスタンスサイズの合計が出力されます。インスタンス数は該当するクラスを加算します。インスタンスの合計サイズには次の内容が出力されます。

基点となるオブジェクトのサイズは，該当するクラスに加算されます。参照先のオブジェクトのサイズは，該当するクラスに加算され，さらに基点となるオブジェクト，および該当するクラスまでの参照関係にあるすべてのオブジェクトの該当するクラスにも加算されます。

なお，Tenured領域内不要オブジェクト統計機能を実行した場合，インスタンス統計機能，STATICメンバ統計機能，および統計前のGC選択機能は無効となります。

Tenured領域内の不要オブジェクトによる参照関係の例を示します。

図9‒11　Tenured領域内の不要なオブジェクトによる参照関係の例

図9-11の参照関係について説明します。

インスタンス数

classA：a1が存在するため1

classB：b1，b2の二つが存在するため2

classC：c1，c2の二つが存在するため2

インスタンスサイズの合計

classA：classAのインスタンス（a1）と，その参照先のインスタンス（b1，b2，c1，c2）のサイズを合計した122

classB：classBのインスタンス（b1，b2）と，その参照先のインスタンス（c1，c2）のサイズを合計した22

classC：classCのインスタンス（c1，c2）を合計した2

Tenured領域内不要オブジェクト統計機能を実行して，図9-11の参照関係の情報を出力した場合の出力例を次に示します。

Garbage Profile
---------------
________________Size__Instances__Class________________
                 122          1 A
                  22          2 B
                   2          2 C

9.8.2　Tenured領域内不要オブジェクト統計機能で出力するクラス別統計情報

ここでは，Tenured領域内不要オブジェクト統計機能で出力するクラス別統計情報の出力形式，出力項目および出力例について説明します。

(1)　出力形式と出力項目

Tenured領域内不要オブジェクト統計機能で出力するクラス別統計情報の出力形式を次に示します。

出力形式

Garbage Profile
-----------------------
________________Size__Instances__Class________________
            <サイズ>       <個数>          <クラス名>
            <サイズ>       <個数>          <クラス名>...

出力項目

出力形式で示した各項目について説明します。

表9‒17　出力項目（Tenured領域内不要オブジェクト統計機能）

出力項目

意味

<サイズ>

インスタンスの合計サイズがバイト単位で出力されます。

<個数>

インスタンスの数が出力されます。

<クラス名>

クラス名が出力されます。

(2)　出力例

Tenured領域内不要オブジェクト統計機能で出力するクラス別統計情報の出力例を示します。

Garbage Profile
---------------
________________Size__Instances__Class________________
            35234568      10648 java.util.HashMap
             5678900      10668 [Ljava.util.HashMap$Entry;
             4456788       7436 java.util.HashMap$Entry
             4321000        200 java.util.WeakHashMap
             1234568        190 [Ljava.util.WeakHashMap$Entry
              454400          4 java.util.WeakHashMap$Entry
                   0          0 java.lang.Class
…

9.8.3　Tenured領域内不要オブジェクト統計機能の実行に関する注意事項

Tenured領域内不要オブジェクト統計機能の注意事項を次に示します。

(1)　Tenured領域内不要オブジェクト統計機能をFullGC直後に実行した場合の注意事項

Tenured領域内不要オブジェクト統計機能をFullGC直後に実行すると，統計対象のTenured領域内の不要なオブジェクトが回収されている状態で統計処理を実行します。そのため，クラス別統計情報中のインスタンスサイズの合計，およびインスタンス数が小さくなり，不要なオブジェクトが効果的に特定されません。不要なオブジェクトを効果的に特定するためにはTenured領域内不要オブジェクト統計機能を実行してください。なお，Tenured領域内不要オブジェクト統計機能の実行について，FullGCの発生のタイミングが判明している場合と，判明していない場合に分けて説明します。

(a)　FullGCが発生するタイミングが判明している場合

Tenured領域内不要オブジェクト統計機能をFullGCの直前に実行すると，統計対象であるTenured領域内の不要オブジェクトの数が多い状態で統計処理が実行されます。そのため，クラス別統計情報中のインスタンスサイズの合計，およびインスタンス数が大きくなり，不要なオブジェクトを効果的に特定できます。

(b)　FullGCが発生するタイミングが判明していない場合

クラス別統計情報中のインスタンスサイズの合計，およびインスタンス数をできるだけ大きくし，不要なオブジェクトを効果的に特定する方法を示します。

FullGCの発生のタイミングを知るためにJavaVM起動時に拡張verbosegc情報を出力するオプション-XX:+HitachiVerboseGCを設定します。オプションを指定することでGCの情報を取得できます。

JavaVMに対してTenured領域内不要オブジェクト統計機能を一定の間隔で実行します。それによって，GCの情報と，複数のクラス別統計情報を取得できます。

拡張verbosegc情報からFullGCの日時を取得できるため，FullGCにより近いクラス別統計情報を選択します。FullGCに近いクラス別統計情報は，統計対象であるTenured領域内の不要なオブジェクトの数が多い状態で統計処理された情報です。

(2)　統計結果に関する注意事項

図9-12のような参照関係の場合を例に統計結果に関する注意事項を説明します。

図9‒12　参照関係の例（統計結果に関する注意事項）

この図で，a1が最も下位のアドレスとした場合，a1を基点となるオブジェクトとして，a1→b1→c1という参照関係で統計処理を実行します。このとき，b1またはc1を基点となるオブジェクトとしている場合，Tenured領域内不要オブジェクト統計機能，およびTenured増加要因の基点オブジェクトリスト機能の統計結果には，意図したとおりの結果が出力できません。

(3)　統計対象とならないオブジェクトに関する注意事項

図9-13のようにTenured領域のオブジェクト（a1およびc1）が，Tenured領域以外のオブジェクト（b1）と参照関係がある場合を例に，統計対象とならないオブジェクトに関する注意事項を説明します。

図9‒13　参照関係の例（統計対象とならないオブジェクト）

この図の場合，Tenured領域以外のオブジェクト（b1）は統計対象とはなりません。しかし，クラスBのインスタンスサイズの合計には，参照先のTenured領域のオブジェクト（c1）のサイズが加算されます。

(4)　複数のオブジェクトから参照関係がある場合の注意事項

図9-14のように複数の参照元（c1およびd1）から一つのオブジェクト（b1）を参照している参照関係がある場合を例に，複数のオブジェクトから参照関係がある場合の注意事項を説明します。

図9‒14　参照関係の例（複数のオブジェクトから参照関係がある場合）

この図の場合，Tenured領域内不要オブジェクト統計機能を実行すると，その参照元が属している参照関係の基点となるオブジェクト（c1およびa1）のうち，アドレスが最も低位である基点となるオブジェクトから統計処理が実行されます。そのため，アドレスが最も低位のオブジェクトがa1で，基点となるオブジェクトがc1である場合，Tenured領域内不要オブジェクト統計機能，およびTenured増加要因の基点オブジェクトリスト機能の統計結果には，意図したとおりの結果が出力できません。

(5)　統計値の増加に関する注意事項

オプション-XX:+HitachiAutoExplicitMemoryを指定したJavaプロセスに対して，Tenured領域内不要オブジェクト統計機能，およびTenured増加要因の基点オブジェクトリスト出力機能を実行すると，次に示すような現象が発生する場合があります。

Tenured領域内不要オブジェクト統計機能で出力されるクラス別統計情報のうち，float型の配列型（クラス名に[Fと出力される情報）のインスタンスサイズの合計，およびインスタンス数の統計値が，本来の統計値よりも大きくなります。クラス別統計情報の出力例を次に示します。

Garbage Profile
---------------
________________Size__Instances__Class________________
            43861400     473859 [F
                   0          0 java.util.Collections$EmptyMap
                   0          0 sun.security.util.Debug
                   0          0 java.nio.ByteOrder

Tenured増加要因の基点オブジェクトリスト出力機能で出力されるTenured増加要因の基点オブジェクトリストに，float型の配列型（クラス名に[Fと出力される情報）が出力されることでインスタンスサイズの合計の統計値が，本来の統計値よりも大きくなります。Tenured増加要因の基点オブジェクトリストの出力例を次に示します。

Garbage Profile Root Object Information
---------------------------------------
*, [F # 43861400

08-70よりも前のバージョンを使用している場合，これらの現象を発生させないために，-XX:-HitachiExplicitMemoryPartialTenuredAreaCollectionオプションを指定してください。

9.9　Tenured増加要因の基点オブジェクトリスト出力機能

この節では，Tenured増加要因の基点オブジェクトリスト出力機能について説明します。

Tenured増加要因の基点オブジェクトリスト出力機能は，クラス別統計情報を出力する機能の一つです。Tenured増加要因の基点オブジェクトリスト出力機能は，Tenured領域内不要オブジェクト統計機能を使って特定した，不要なオブジェクトの基点となるオブジェクトの情報を出力できます。

Tenured増加要因の基点オブジェクトリスト出力機能を使用する場合は，jheapprofコマンドの引数に-rootobjectinfoを指定します。jheapprofコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンスコマンド編」の「jheapprof（クラス別統計情報付き拡張スレッドダンプの出力）」を参照してください。

この節の構成を次の表に示します。

表9‒18　この節の構成（Tenured増加要因の基点オブジェクトリスト出力機能）

分類

タイトル

参照先

解説

Tenured増加要因の基点オブジェクトリスト出力機能の概要

9.9.1

Tenured増加要因の基点オブジェクトリスト出力機能で出力するクラス別統計情報

9.9.2

注　「実装」，「設定」，「運用」および「注意事項」について，この機能固有の説明はありません。

9.9.1　Tenured増加要因の基点オブジェクトリスト出力機能の概要

Tenured増加要因の基点オブジェクトリスト出力機能では，Tenured領域内不要オブジェクト統計機能を使って特定した，不要なオブジェクトの基点となるオブジェクトの情報をリストにしてスレッドダンプファイルに出力します。

また，Tenured増加要因の基点オブジェクトリスト出力機能は，Tenured領域内不要オブジェクト統計機能が前提になります。

ポイント

Tenured増加要因の基点オブジェクトリスト出力機能を使って取得した情報は，明示管理ヒープ機能を使用する場合に指定する，自動配置設定ファイルに指定できます。自動配置設定ファイルを使った明示管理ヒープの使用については，マニュアル「アプリケーションサーバ機能解説 拡張編」の「7.13.2　自動配置設定ファイルを使った明示管理ヒープ機能の使用」を参照してください。

Tenured増加要因の基点オブジェクトリスト出力機能の仕組みについて説明します。

(1)　基点となるオブジェクトのリスト出力

Tenured増加要因の基点オブジェクトリスト出力機能は，Tenured領域内不要オブジェクト統計機能の処理のあとに続けて実行されます。Tenured領域内不要オブジェクト統計機能で実行する処理については，「9.8.1　Tenured領域内不要オブジェクト統計機能の概要」を参照してください。

Tenured増加要因の基点オブジェクトリスト出力機能は，Tenured領域内のアドレスの低い順にオブジェクトを検索します。検索したオブジェクトの中で，すでに参照関係で調べられているオブジェクト，および不要なオブジェクトのクラス情報を取得して，出力候補リストに保存します。

出力候補リストに保存した情報をインスタンスサイズの合計でソートし，合計サイズがjheapprofコマンドの-rootobjectinfostオプションで指定した値以上のクラス情報だけが出力されます。

(2)　不要なオブジェクトの参照関係の確認

Tenured増加要因の基点オブジェクトリスト出力機能を実行して基点となるオブジェクトを取得する際の，Tenured領域内の不要オブジェクトによる参照関係の例を示します。

インスタンス数

classA：a1が存在するため1

classB：b1，b2の二つが存在するため2

classC：c1，c2の二つが存在するため2

インスタンスサイズの合計

classA：classAのインスタンス（a1）と，その参照先のインスタンス（b1，b2，c1，c2）のサイズを合計した122

classB：classBのインスタンス（b1，b2）と，その参照先のインスタンス（c1，c2）のサイズを合計した22

classC：classCのインスタンス（c1，c2）を合計した2

図9‒15　Tenured領域内の不要なオブジェクトによる参照関係の例

Tenured領域内不要オブジェクト統計機能を実行して図9-15のような参照関係の情報を取得した場合に，Tenured増加要因の基点オブジェクトリスト出力機能で取得する情報を次に示します。

基点オブジェクト：a1

基点オブジェクトのクラス：A

基点オブジェクトのクラスAのインスタンスサイズの合計：122

図9-15の参照関係の情報をTenured増加要因の基点オブジェクトリスト出力機能を実行して出力した場合の出力例を次に示します。

Garbage Profile Root Object Information
---------------------------------------
*, A # 122

9.9.2　Tenured増加要因の基点オブジェクトリスト出力機能で出力するクラス別統計情報

ここでは，Tenured増加要因の基点オブジェクトリスト出力機能で出力するクラス別統計情報の出力形式，および出力項目について説明します。

出力形式

Garbage Profile Root Object Information
---------------------------------------
*, <クラス名> # <サイズ>
…

出力項目

出力形式で示した各項目について説明します。

表9‒19　出力項目（Tenured領域内不要オブジェクト統計機能）

出力項目

意味

<クラス名>

Tenured増加要因となった基点となるオブジェクトのクラス名が出力されます。

<サイズ>

Tenured領域内不要オブジェクト統計機能のクラス別統計情報から取得したインスタンスサイズの合計がバイト単位で出力されます。

9.10　クラス別統計情報解析機能

この節では，クラス別統計情報解析機能について説明します。

クラス別統計情報解析機能を使用すると，クラス別統計情報で取得した情報をCSV形式で出力できます。

この節の構成を次の表に示します。

表9‒20　この節の構成（クラス別統計情報解析機能）

分類

タイトル

参照先

解説

クラス別統計情報解析機能の概要

9.10.1

クラス別統計情報解析機能の出力例

9.10.2

注意事項

クラス別統計情報解析機能の注意事項

9.10.3

注　「実装」，「設定」および「運用」について，この機能固有の説明はありません。

9.10.1　クラス別統計情報解析機能の概要

jheapprofanalyzerコマンド（クラス別統計情報解析機能）を実行することで，クラス別統計情報の付いた複数の拡張スレッドダンプファイルを入力ファイルとして，クラスごとのインスタンスの合計サイズ，およびクラスごとのインスタンス数を時系列に出力します。出力されるファイルは，CSV形式で出力されます。

クラス別統計情報として取得した情報を基に，クラス別統計情報解析機能を実行してCSV形式に出力する場合の流れを次に示します。

図9‒16　クラス別統計情報解析機能を実行してCSV形式に出力する場合の流れ

クラス別統計情報解析機能では，インスタンスの合計サイズが大きいインスタンスの情報を出力して，そのインスタンスのメモリ使用量だけを確認することもできます。インスタンスの合計サイズが大きいものだけを出力する場合には-DJP.co.Hitachi.soft.jvm.tools.jheapprofanalyzer.thresholdにしきい値を指定し，jheapprofanalyzerコマンドに指定して実行します。jheapprofanalyzerコマンドの詳細については，マニュアル「アプリケーションサーバリファレンス コマンド編」の「jheapprofanalyzer（クラス別統計情報解析ファイルのCSV出力）」を参照してください。

9.10.2　クラス別統計情報解析機能の出力例

ここでは，クラス別統計情報解析機能の入力ファイル，出力ファイル，および出力形式について説明します。

(1)　入力ファイル

クラス別統計情報解析機能で使用する入力ファイルは，クラス別統計情報を出力した拡張スレッドダンプファイルです。

(2)　出力ファイル

クラス別統計情報解析機能で出力するファイルは，クラスごとのインスタンスの合計サイズを出力したファイル，およびクラスごとのインスタンス数を出力したファイルの2種類です。出力ファイルはカレントディレクトリに次のファイル名で作成されます。

表9‒21　出力ファイルのファイル名

出力ファイルの種類

出力ファイルのファイル名の例

インスタンス合計サイズファイル

JheapprofAnalyzer_size_nnn.csv

インスタンス数ファイル

JheapprofAnalyzer_num_nnn.csv

（凡例）

nnn：ファイルの分割番号が出力されます。分割番号の範囲は001〜999です。

列が201列を超える場合は出力ファイルが分割されます。また，999ファイルを超えた場合は，001に戻りファイルは書き換えられます。

分割する列数は，201列（クラス名1列＋値200列）を超えた場合とし，出力形式は分割したファイルも同じになります。

(3)　出力形式

クラス別統計情報解析機能で出力されるファイルの出力形式を次の図に示します。なお，インスタンス合計サイズ，およびインスタンス数が出力されたCSVファイルの出力形式は同じです。

図9‒17　クラス別統計情報解析機能で出力されるファイルの出力形式

クラス名と値，および値と値の間はコンマで区切ります。また，行の最後は値（空白も含む）で終了します。

クラス名の出力順はランダムです。値は入力ファイルの先頭行にある日付を基に，日付の古いものから横に並びます。同じ日付の入力ファイルがある場合はランダムに連続して横に並びます。

参考

クラス別統計情報解析機能を複数回実行すると，処理途中のクラスが消滅したり追加されたりする場合があります。また，該当するクラスがない場合の値には0が出力されます。図9-18のクラス情報の例を使用して説明します。

図9‒18　クラス情報の例

上記のようなクラス情報の場合で，-DJP.co.Hitachi.soft.jvm.tools.jheapprofanalyzer.thresholdのしきい値を0にしたときの出力結果は図9-17のようになります。

図9‒19　クラス別統計情報解析機能の出力例

インスタンス合計サイズの最大値は0〜2⁶³-1，インスタンス数の最大値は0〜2³¹-1です。一つの入力ファイルに同じクラス名がある場合は，インスタンスサイズの合計が加算されます。また，インスタンス数も加算されます。加算されたことによって，それぞれの最大値を超えた場合は，指定した最大値が出力されます。なお，一つのクラスについて，すべての入力ファイルで該当するクラスの情報がない，またはしきい値未満の場合は，そのクラスの情報は出力されません。

9.10.3　クラス別統計情報解析機能の注意事項

クラス別統計情報解析機能を使用する場合，jheapprofanalyzerコマンド実行中に入力ファイルの更新，および削除の操作はしないでください。クラス別統計情報解析機能は，日付を取得するとき，およびデータを読み込むときの2回ファイルを開きます。そのため，コマンド実行中に入力ファイルの更新，および削除の操作をした場合の結果は保証されません。

9.11　Survivor領域の年齢分布情報出力機能

この節では，Survivor領域の年齢分布情報出力機能について説明します。

Survivor領域の年齢分布情報出力機能を使用すると，CopyGC実行時に，Survivor領域の使用状況が調査できます。この情報は，メモリサイズのチューニングに使用できます。

この節の構成を次の表に示します。

表9‒22　この節の構成（Survivor領域の年齢分布情報出力機能）

分類

タイトル

参照先

解説

Survivor領域の年齢分布情報出力機能の概要

9.11.1

Survivor領域の年齢分布情報の出力形式と出力例

9.11.2

設定

実行環境での設定

9.11.3

注意事項

Survivor領域の年齢分布情報出力機能使用時の注意事項

9.11.4

注　「実装」および「運用」について，この機能固有の説明はありません。

9.11.1　Survivor領域の年齢分布情報出力機能の概要

製品のJavaVMでは，多くのトラブルシュート情報が取得できるように，ログの出力内容が標準のJavaVMよりも拡張されています。製品のJavaVMログは，製品のJavaVMログファイルに出力されます。Survivor領域の年齢分布情報出力機能は，CopyGC実行時，製品のJavaVMログファイルに，Survivor領域のJavaオブジェクトの年齢分布情報を出力できる機能です。この情報を使用すると，Survivor領域のオブジェクトの使用状況が調査でき，Survivor領域のメモリサイズのチューニングができます。Survivor領域のメモリサイズのチューニングについては，マニュアル「アプリケーションサーバシステム設計ガイド」の「7.6.1　Javaヒープ内のSurvivor領域のメモリサイズの見積もり」を参照してください。

Survivor領域の年齢分布情報出力機能は，Survivor領域の年齢分布情報に加えて日時も出力できます。また，出力先が製品のJavaVMログファイルなので，ほかのログとの同期が取れます。

製品のJavaVMログファイルについては，「4.10　JavaVMログ（JavaVMログファイル）」を参照してください。また，Java VMのチューニングについては，マニュアル「アプリケーションサーバ システム設計ガイド」の「7.　JavaVMのメモリチューニング」を参照してください。

9.11.2　Survivor領域の年齢分布情報の出力形式と出力例

Survivor領域の年齢分布情報は，CopyGC発生時に，CopyGCのログのあとに続けて出力されます。Survivor領域の年齢分布情報の出力形式と出力例を次に示します。

出力形式

[PTD]<date>[Desired survivor:size bytes][New threshold:value][MaxTenuringThreshold: max_value][age1:total_age1][age2:total_age2]...[agen:total_agen]

説明

PTD：Survivor領域の年齢情報であることを示す識別子

date：GCが発生した日時（-XX:+HitachiVerboseGCPrintDate（拡張verbosegc情報日付出力オプション）を指定した場合だけ出力）※1

size：Survivor領域のサイズ（単位：バイト）

value：次回のGC発生時にTenured領域へ移動するオブジェクトの年齢のしきい値

max_value：-XX:MaxTenuringThresholdの指定値※2

total_age1：1歳のオブジェクトが使用しているメモリサイズの合計（単位：バイト）

total_age2：1歳から2歳までのオブジェクトが使用しているメモリサイズの合計（単位：バイト）

total_agen：1歳からn歳までのオブジェクトが使用しているメモリサイズの合計（単位：バイト）※3

注

-XX:+HitachiCommaVerboseGCを指定している場合は，次の形式で出力されます。

PTD,date,size,value,max_value,total_age1,total_age2,...,total_agen

注※1

対応するCopyGCのログと同じ時刻が表示されます。

注※2

-XX:MaxTenuringThresholdの指定値には，CopyGC実行時に，From空間とTo空間でJavaオブジェクトを入れ替える回数のしきい値を設定します。

注※3

存在するオブジェクトを最小年齢から最大年齢まで順番に表示します。表示されるオブジェクトの最大年齢がmax_valueの値に近いと，寿命の長いオブジェクトが存在することを示します。

出力例

[VGC]<Wed May 28 11:45:23 2008>[GC 648K->136K(1984K), 0.0013020 secs][DefNew::Eden: 512K->0K(512K)][DefNew::Survivor: 0K->0K(64K)][Tenured: 136K->136K(1408K)][Metaspace: 3634K(4492K, 4492K)->3634K(4492K, 4492K)][class space: 356K(388K, 388K)->356K(388K, 388K)][cause:ObjAllocFail][User: 0.0000000 secs][Sys: 0.0000000 secs]
[PTD]<Wed May 28 11:45:23 2008>[Desired survivor:5467547 bytes][New  threshold:30][MaxTenuringThreshold:31][age1:1357527][age2:1539661]

この出力例では，次の内容が確認できます。

出力契機は，2008年5月28日(水)11時45分23秒に発生したCopyGCです。

Survivor領域のメモリサイズは5,467,547バイトです。Survivor領域のオブジェクトは2歳までです。1歳のオブジェクトが使用しているメモリサイズは1,357,527バイト，1歳から2歳までのオブジェクトが使用しているメモリサイズは1,539,661バイトです。

9.11.3　実行環境での設定

Survivor領域の年齢分布情報出力機能を使用する場合，次の設定が必要です。

J2EEサーバ

バッチサーバ

Javaアプリケーション

(1)　J2EEサーバの設定

J2EEサーバの設定は，簡易構築定義ファイルで実施します。Survivor領域の年齢分布情報出力機能の定義は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にJavaVM起動パラメタ（add.jvm.arg）で指定します。指定するパラメタ値を次に示します。

-XX:+HitachiVerboseGCPrintTenuringDistribution

Survivor領域の年齢分布情報を製品のJavaVMログファイルへ出力します。デフォルト値は，-XX:-HitachiVerboseGCPrintTenuringDistributionです。

簡易構築定義ファイルおよびパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

(2)　バッチサーバの設定

バッチサーバの設定は，簡易構築定義ファイルで実施します。Survivor領域の年齢分布情報出力機能の定義は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にJavaVM起動パラメタ（add.jvm.arg）で指定します。指定するパラメタ値を次に示します。

-XX:+HitachiVerboseGCPrintTenuringDistribution

Survivor領域の年齢分布情報を製品のJavaVMログファイルへ出力します。デフォルト値は，-XX:-HitachiVerboseGCPrintTenuringDistributionです。

簡易構築定義ファイルおよびパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

(3)　Javaアプリケーションの設定

Javaアプリケーションの設定は，usrconf.cfg（Javaアプリケーション用オプション定義ファイル）で実施します。Survivor領域の年齢分布情報出力機能の定義は，usrconf.cfgのadd.jvm.argキーで指定します。指定するパラメタ値を次に示します。

-XX:+HitachiVerboseGCPrintTenuringDistribution

Survivor領域の年齢分布情報を製品のJavaVMログファイルへ出力します。デフォルト値は，-XX:-HitachiVerboseGCPrintTenuringDistributionです。

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

9.11.4　Survivor領域の年齢分布情報出力機能使用時の注意事項

Survivor領域の年齢分布情報出力機能を使用すると，CopyGC実行時のログが使用しない場合に比べて倍以上に増えます。この機能は，Survivor領域のチューニング時だけに使用することをお勧めします。

9.12　hndlwrap機能

この節では，hndlwrap機能について説明します。

hndlwrap機能は，ログオフ時のJavaVMのログオフイベントの発生を抑止できます。なお，この機能はWindowsの場合だけ使用できます。

この節の構成を次の表に示します。

表9‒23　この節の構成（hndlwrap機能）

分類

タイトル

参照先

解説

hndlwrap機能の概要

9.12.1

注意事項

hndlwrap機能使用時の注意事項

9.12.2

注　「実装」，「設定」および「運用」について，この機能固有の説明はありません。

9.12.1　hndlwrap機能の概要

hndlwrap機能は，ログオフした場合にログオフイベント，およびウィンドウクローズが発生しないようにする機能です。

この機能は，Java Virtual Machine Tool Interface（JVMTI）を使用します。「hndlwrap2.dll」をJVMTIインタフェースでローディングすると，クラスの準備イベントを検出してログオフとウィンドウクローズのイベントを無視するイベントハンドラがインストールされます。これによって，-agentlib:hndlwrap2オプションを指定してhndlwrap機能を実行した場合には，ログオフ後もコマンドを動作させることができます。指定するオプションの詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「14.5　Application Serverで指定できるJava HotSpot VMのオプション」を参照してください。

9.12.2　hndlwrap機能使用時の注意事項

hndlwrap機能使用時の注意事項を次に示します。

-XX:+EagerXrunInitオプションを指定したときは，-Xrunhndlwrapオプションは無効になります。

コマンドプロンプト上でhndlwrap機能を使用したJavaアプリケーションを実行している場合にログオフすると，エラー用のポップアップが表示され，ログオフできません。

-agentlib:hndlwrap2オプションはほかのJVMTIプログラムと同時に実行できません。実行した場合の動作は保証されません。

-Xrunhndlwrapオプション，および-agentlib:hndlwrap2オプションは同時に指定できません。

9.13　JITコンパイル時のCヒープ確保量の上限値設定機能

JavaVMがサポートしているJust In Time方式でのコンパイル（JITコンパイル）では，コンパイル実行中にCヒープを使用します。処理数が多いメソッドや大量のメソッドに対してJITコンパイルを実行した場合，コンパイル処理のために確保されるCヒープのサイズも多大になり，Cヒープ不足が発生することがあります。この場合，JavaVMの強制終了やJ2EEサーバの異常終了などのトラブルが発生して，システムが全面停止してしまうおそれがあります。

このような問題の発生を防止するために，JITコンパイルで使用するCヒープのサイズに上限値を設定できます。上限値を超えた場合は，JITコンパイルが中止され，以降のコンパイルはインタプリタ方式で実行されます。これによって，JavaVMの強制終了を防ぎ，システムの停止を抑止できます。

JITコンパイル時のCヒープ確保量の上限は，-XX:HitachiJITCompileMaxMemorySizeオプションで指定します。-XX:HitachiJITCompileMaxMemorySizeオプションの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「-XX:HitachiJITCompileMaxMemorySize（JITコンパイル時の確保メモリ上限値指定オプション）」を参照してください。

9.14　スレッド数の上限値設定機能

アプリケーションで使用するスレッド数が多くなると，Cヒープで使用するメモリ使用量が増加します。メモリ使用量の増加に伴いCヒープ不足が発生した場合，JavaVMの強制終了，J2EEサーバの異常終了などのトラブルが発生して，システムが全面停止してしまうおそれがあります。

このような問題の発生を防止するために，使用できるスレッド数に上限値を設定できます。あらかじめ使用するスレッド数の上限を把握し，その数を基にCヒープに割り当てるメモリサイズを決定することで，Cヒープ不足の発生を防止します。なお，設定した上限値を超えたスレッドが生成された場合は，例外がスローされます。アプリケーションでこの例外をキャッチして，適切な対処をすることで，システムの停止を抑止できます。

スレッド数の上限は，-XX:HitachiThreadLimitオプションで指定します。-XX:HitachiThreadLimitオプションの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「-XX:HitachiThreadLimit（スレッド数の上限値指定オプション）」を参照してください。

9.15　製品のJavaVMの機能使用時の注意事項（UNIXの場合）

製品のJavaVMの機能を使用する際の注意事項について説明します。

9.15.1　UNIX共通の場合

UNIXで共通の注意事項について説明します。

SIGXFSZシグナル受信時の動作について

JavaVMがSIGXFSZシグナルを受信した場合，次のメッセージを標準出力に出力して処理を継続します。

Java HotSpot(TM) 64-Bit Server VM warning: File size limit exceeded.

ただし，ファイルサイズの上限を超える場合は，ファイルへ書き込みません。

SIGXCPUシグナル受信時の動作について

JavaVMがSIGXCPUシグナルを受信した場合，次のメッセージを標準出力に出力して処理を継続します。

Java HotSpot(TM) 64-Bit Server VM warning: CPU time limit exceeded.

AWTについて（AIXの場合）

AIXの場合，アプリケーションサーバのAWTは，XToolkit（sun.awt.X11.XToolkit）を使用しています。MotifベースのMToolkitはサポートしていません。

9.15.2　AIXの場合

AIXでの注意事項について説明します。

ページングスペース見積もりについて

J2EEサーバおよびWebコンテナサーバを起動するときは，プログラム稼動中にページング不足でプログラムを停止（SIGKILL）させられないようにするため，起動シェルでAIXの早期ページングスペース割り当てを指定する環境変数PSALLOC=earlyを指定してください。ただし，/etc/environmentファイルにPSALLOC=earlyを指定すると，すべてのプロセスが早期ページングスペース割り当て指定となり，ページングスペース不足に陥ります。このため，該当するサーバを起動するシェルだけで，環境変数を指定するようにしてください。また，環境変数NODISCLAIM=trueも同時に指定してください。早期ページングスペース割り当てのページングスペースを見積もる上で考慮する点については，AIXのマニュアルを参照してください。

ネイティブライブラリ検索パスについて

javaコマンドを使用する場合

Developer's Kit for Javaに含まれるjavaコマンドを使ってJavaプログラムを実行する場合，System.loadLibrary()でローディングされるシステムライブラリのディレクトリ検索パスは，環境変数LIBPATH，および環境変数LD_LIBRARY_PATHで指定できます。検索順序は，LD_LIBRARY_PATH，LIBPATHの順に優先されます。

javaコマンドを使用しない場合

JNIを使ってJavaVMを起動し，Javaプログラムを実行する場合，System.loadLibrary()でローディングされるシステムライブラリのディレクトリ検索パスは，環境変数LIBPATHで指定されたパスだけになります。

JNIを使用したJavaVMの起動について

JNIを使ってJavaVMを起動する場合は，次の点に注意してください。

次のAIX固有環境変数を必ず設定してください。

csh（Cシェル）の場合

　setenv AIXTHREAD_MUTEX_DEBUG OFF

　setenv AIXTHREAD_RWLOCK_DEBUG OFF

　setenv AIXTHREAD_COND_DEBUG OFF

sh（標準シェル）およびkshの場合

　export AIXTHREAD_MUTEX_DEBUG=OFF

　export AIXTHREAD_RWLOCK_DEBUG=OFF

　export AIXTHREAD_COND_DEBUG=OFF

これらの環境変数については，該当ページ（https://www.ibm.com/support/knowledgecenter/ja/ssw_aix_72/performance/thread_env_vars.html）を参照してください。

環境変数LIBPATHに次のパスを追加してから起動プログラム実行してください。

/opt/Cosimnexus/jdk/lib

/opt/Cosimnexus/jdk/lib/server

なお，起動プログラム生成時のリンケージオプションとして，これらのパスを設定している場合は，環境変数LIBPATHは設定不要です。

フォントパスについて

GUIで表示されるフォントは，システムのフォントパスから検索されます。Developer's Kit for Javaの起動前にシステムのフォントパスを変更するプログラムを実行すると，GUIが正しく表示されないことがあります。また，Developer's Kit for Javaによってもシステムのフォントパスが変更されます。このため，Developer's Kit for Javaの起動後にシステムのフォントパスを検索するようなプログラムでは，GUIが正しく表示されないことがあります。

Developer's Kit for Javaの起動前や起動後に次の設定をすると，システムのフォントパスをデフォルトの状態に戻すことができます。

% xset fp default

プログラムの起動時間について

Developer's Kit for JavaのJava仮想マシンの実装は，サーバVM（Java HotSpot Server VM）です。サーバVMは，旧バージョンのクライアントVM（Java HotSpot Client VM）に比べて，一般に，プログラムの実行速度は高速ですが，J2EEサーバなどのプログラムの起動が遅くなることがあります。プログラムの起動を速くしたい場合には，次のオプションを指定してください。ただし，このオプションを指定した場合，プログラムの実行速度は通常よりも遅くなることがあります。

-XX:CompileThreshold=3000

32ビット版のJavaVM（アプリケーションサーバ Version 8）から64ビット版のJavaVM（アプリケーションサーバ Version 9）に移行する際の注意事項

一般的に，64ビット版のJavaVMでは，32ビット版のJavaVMと比べて，大きなアドレス空間を利用できるという利点があります。また，オブジェクトのポインタ値は，32ビット版のJavaVMでは32ビット，64ビット版のJavaVMでは64ビットとなります。このため，32ビット版のJavaVMから64ビット版のJavaVMへ移行する際には，アプリケーションの見直し，メモリチューニング，環境の見直しなどが必要になることがあります。次の点に注意して移行してください。

オブジェクトへのアクセスコストの増加

オブジェクトのポインタ値が32ビットから64ビットになるため，オブジェクトへのアクセスが最大で2倍となります。オブジェクトへ頻繁にアクセスするようなアプリケーションの場合，64ビット版のJavaVMでは実行性能に影響が出ることがあります。

Javaヒープのメモリサイズの増加

オブジェクトのポインタ値が32ビットから64ビットになるため，オブジェクト1個あたりのサイズが最大で2倍に増加します。これに伴って，アプリケーションが使用するJavaヒープのメモリサイズも増加します。

プロセスが使用するメモリサイズの増加

64ビット版のJavaVMでは，Javaヒープのメモリサイズだけでなく，プロセスが使用するメモリサイズも増加します。プロセスが使用するメモリサイズの見積もり方法は，coreファイルサイズの見積もり方法と同じです。見積もり方法については，「3.3.16(1)　coreファイルのサイズの上限値の設定」を参照してください。

JNIの互換性について

32ビットのバイナリとして作成された，JNIで呼び出されるネイティブプログラムは，64ビット版のJavaVM上では動作できません。また，一つのプロセス内で，32ビットと64ビットのネイティブプログラムを同時に動作させることもできません。そのため，JNIで呼び出されるネイティブプログラムが使用されている場合は，64ビット版のJavaVM用にそのプログラムをコンパイルし直す必要があります。

9.15.3　Linuxの場合

Linuxでの注意事項について説明します。

フォントに関するメッセージについて

Xサーバのようにコンソール以外のリモート端末上で，GUIのアプリケーションを起動する際，次のようなメッセージが出力される場合があります。

Warning: Cannot convert string
"-monotype-arial-regular-r-normal--*-140-*-*-p-*-iso8859-1" to type FontStruct

この場合，xfsコマンドでフォントサーバを起動し，Xサーバ側でxsetコマンドを使用してフォントパスにフォントサーバを指定すると回避できます。その際，フォントサーバの設定ファイルに不足しているフォントパスが指定されていることを確認してください。

9.16　ファイナライズ滞留解消機能

この節では，ファイナライズ滞留解消機能について説明します。ファイナライズ滞留解消機能を使用すると，ファイナライズ処理の滞留を解消でき，OS資源の解放遅れなどの発生を抑止できます。

9.16.1　概要

finalize()メソッドでOS資源の解放処理を定義しているアプリケーションでは，ファイナライズ処理が滞留して，OS資源の解放遅れが発生することがあります。ファイナライズ滞留解消機能を使用すると，JavaVM内でファイナライズ処理が滞留している状態を検知して，滞留しているファイナライズ処理を解消します。

ファイナライズ滞留解消機能では，ファイナライズ滞留を検知するために，Java起動時にFinalizerThreadを監視するファイナライズ処理監視スレッドを生成します。FinalizerThreadは，Java実行時に常に1つあり，オブジェクトのfinalize()メソッドを1つずつ処理するスレッドです。

ファイナライズ処理監視スレッドでは，FinalizerThreadで処理しているオブジェクトを定期的に監視します。次の条件を満たす場合，ファイナライズ処理が滞留していると見なして，新たにファイナライズスレッドを生成します。

FinalizerThreadでオブジェクトのファイナライズ処理が進んでいない。

ファイナライズキューにオブジェクトがある。

FinalizerThreadとファイナライズスレッドの両方で，ファイナライズ処理を実行して，滞留しているファイナライズ処理の解消を促します。なお，ファイナライズスレッドは，ファイナライズキューが空になると終了します。

9.16.2　出力情報

ファイナライズ滞留解消機能では，次に示すタイミングでメッセージを標準出力に出力します。

ファイナライズ処理の滞留を検知して，ファイナライズスレッドを新たに生成する場合

生成したファイナライズスレッドが終了した場合

それぞれのタイミングで出力するメッセージの形式と出力例を次に示します。

ファイナライズ処理の滞留を検知して，ファイナライズスレッドを新たに生成する場合

ファイナライズ処理の滞留を検知して，ファイナライズスレッドを新たに生成する場合に出力されるメッセージの形式を次に示します。

# FinalizerWatcherThread: Create: create secondary finalizer thread. [queue length = queue] <date>

説明

queue：ファイナライズキューの要素数

date：ファイナライズスレッドを新たに生成した日時

出力例を次に示します。

# FinalizerWatcherThread: Create: create secondary finalizer thread. [queue length = 128] <Mon May 26 18:00:36 JST 2008>

生成したファイナライズスレッドが終了した場合

生成したファイナライズスレッドが終了した場合に出力されるメッセージの形式を次に示します。

# FinalizerWatcherThread: Finish: secondary finalizer thread is finished. <date>

説明

date：生成したファイナライズスレッドが終了した日時

出力例を次に示します。

# FinalizerWatcherThread: Finish: secondary finalizer thread is finished.  <Mon May 26 20:12:26 JST 2008>

9.16.3　実行環境での設定

ファイナライズ滞留解消機能を使用する場合，次の設定が必要です。

J2EEサーバ

バッチサーバ

Javaアプリケーション

(1)　J2EEサーバの設定

J2EEサーバの設定は，簡易構築定義ファイルで実施します。ファイナライズ滞留解消機能の定義は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にJavaVM起動パラメタ（add.jvm.arg）で指定します。指定するパラメタ値を次に示します。

-DJP.co.Hitachi.soft.jvm.autofinalizer=true

ファイナライズ滞留解消機能を有効にします。この機能を有効にすると，Java起動時に監視スレッドを生成します。デフォルト値はtrueのため，無効にする場合はfalseを指定してください。

簡易構築定義ファイルおよびパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

(2)　バッチサーバの設定

バッチサーバの設定は，簡易構築定義ファイルで実施します。ファイナライズ滞留解消機能の定義は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内にJavaVM起動パラメタ（add.jvm.arg）で指定します。指定するパラメタ値を次に示します。

-DJP.co.Hitachi.soft.jvm.autofinalizer=true

ファイナライズ滞留解消機能を有効にします。この機能を有効にすると，Java起動時に監視スレッドを生成します。デフォルト値はtrueのため，無効にする場合はfalseを指定してください。

簡易構築定義ファイルおよびパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

(3)　Javaアプリケーションの設定

Javaアプリケーションの設定は，usrconf.cfg（Javaアプリケーション用オプション定義ファイル）で実施します。ファイナライズ滞留解消機能の定義は，usrconf.cfgのadd.jvm.argキーで指定します。指定するパラメタ値を次に示します。

-DJP.co.Hitachi.soft.jvm.autofinalizer=true

ファイナライズ滞留解消機能を有効にします。この機能を有効にすると，Java起動時に監視スレッドを生成します。デフォルト値はtrueのため，無効にする場合はfalseを指定してください。

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

9.16.4　注意事項

ファイナライズ滞留解消機能を使用する場合の注意事項を次に示します。

JavaVM起動パラメタの値は，Java起動時に参照されます。このため，JavaVM実行中にjava.lang.System.setProperty()メソッドなどで，JavaVM起動パラメタの値を変更しても，ファイナライズ滞留解消機能は有効になりません。

JavaVM起動パラメタが複数指定された場合，最後に指定されたパラメタの値が有効になります。

ファイナライズ滞留解消機能では，ファイナライズの滞留を監視するための常駐スレッドを1つ生成します。また，ファイナライズの滞留を検知すると，滞留を解消するためのスレッドを1つ生成します。ファイナライズの滞留が発生してもシステムに影響しない場合は，add.jvm.argパラメタまたはadd.jvm.argキーに「-DJP.co.Hitachi.soft.jvm.autofinalizer=false」を指定して，ファイナライズ滞留解消機能を無効にすることで，ファイナライズの滞留を監視するスレッドとファイナライズの滞留を解消するスレッドの生成を抑止できます。

9.17　ログファイルの非同期出力機能

ここではログファイルの非同期出力機能について説明します。

9.17.1　概要

この機能は，ログのファイル出力を非同期でできるように変更する機能です。ここに記載している「非同期」とは，ログのファイル出力処理を専用でするスレッドを用意することで，ログのファイル出力以外の処理を実行するスレッドとは処理のタイミングを合わせることなく，ログをファイルに出力していくことを指します。ここでは例として，GC発生時に出力されるログファイルについて記載します。

GCの実行中は，プログラムの処理が停止します。日立JavaVMログファイル機能では，GCを実行しているスレッドが，GCの情報のログファイル出力処理もしているため，GCの情報をログファイルに出力する処理が完了するまで次の処理へ進むことができません。

そこで，この機能を有効にすることによって，GC情報のログファイル出力処理は専用のスレッドが実行するようになります。そのため，それ以外の処理を実行するスレッドがGC情報のログファイル出力処理の完了を待つことによる処理の遅延を削減することができます。

しかし，この機能を使用することでログの一部が欠けるおそれがあります。この機能は，一時的にログをバッファにためておき，その後ログファイルへ出力するという処理をしています。ログの出力量が非常に多い場合や，ファイル入出力処理が極端に遅い場合に，一部のログが出力されないおそれがあります。そのため，GCによるプログラムの処理の停止時間として100msec以下を達成するようなチューニングをしている場合は，この機能の使用を推奨します。一方で，100msec以下を達成するようなチューニングをしていない場合には，この機能の使用は推奨しません。

9.17.2　対象ログファイル

この機能の対象とするファイルは次の2つです。

日立JavaVMログファイル

明示管理ヒープ機能のイベントログ

9.17.3　エラーケース

ファイルへのI/O処理速度より，バッファへの書き込み処理速度が速い場合，バッファがラウンドしてログが出力されない場合があります。

バッファがラウンドしてログが出力されなかった場合の出力様式

[ASY]<skip_count> log is skipped.

skip_count：バッファがラウンドして出力できなかった場合のスキップした行数

この機能で使用するログに出力する専用のスレッドの生成に失敗した場合は，次のメッセージを標準出力に出力し，JavaVMを起動しません。

日立JavaVMログファイル用のスレッドの生成に失敗

Error occurred during initialization of VM
Could not create thread for VM: Asynchronous javalog thread creation failed. thread_count threads exist.

thread_count: 存在するスレッド数

明示管理ヒープログファイル用のスレッドの生成に失敗

Error occurred during initialization of VM
Could not create thread for VM: Asynchronous ehjavalog thread creation failed. thread_count threads exist.

thread_count: 存在するスレッド数

9.17.4　注意事項

ログの非同期出力機能使用時，-XX:HitachiOutOfMemoryStackTraceLineSizeまたは-XX:HitachiJavaClassLibTraceLineSizeオプションに4096より大きな値を指定した場合は，オプションの値として4096が指定されたものとして動作します。その場合の動作の詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「14.2　JavaVM拡張オプションの詳細」を参照してください。

9.17.5　メモリ所要量

この機能は，新たにバッファとスレッドを生成します。この機能が有効の場合，このバッファとスレッドはJavaVM終了時まで生存します。そのため，この機能を使用することでバッファとスレッド用にメモリを消費します。そのメモリ消費量を次に記載します。

まず，バッファのメモリ消費量を次に示します。

（ログ1行分のサイズ = 4096byte）×（バッファにためこめる行数 = 1024行）= 4Mbyte

さらに明示管理ヒープ機能を使用している場合は，明示管理ヒープ機能のイベントログ用のバッファも生成するため，2倍のメモリ消費量となり8Mbyteとなります。

また，スレッドのメモリ消費量は-Xssオプションに指定された値です。こちらも，明示管理ヒープ機能を使用している場合は，明示管理ヒープ機能のイベントログ用のスレッドも生成するため，メモリ消費量は2倍となります。

表9‒24　プラットフォームごとの-Xssのデフォルト値

プラットフォーム

-Xssのデフォルト値

Linux(EM64T)

1Mbyte

Windows

1Mbyte

AIX

1Mbyte

9.18　圧縮オブジェクトポインタ機能

ここでは圧縮オブジェクトポインタ機能について説明します。

9.18.1　概要

圧縮オブジェクトポインタ機能は，Javaアプリケーションによって作成されるJavaオブジェクトのサイズを圧縮することで，Javaアプリケーションのメモリ使用効率を向上させる機能です。この機能を有効にすることによって，Application Server上で動作しているJavaアプリケーション実行中での，Javaヒープ領域とExplicitヒープ領域※の使用量を少なくできます。

圧縮オブジェクトポインタ機能は，-XX:+UseCompressedOopsを指定することで有効にできます。UseCompressedOopsオプションの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.2　JavaVM拡張オプションの詳細」を参照してください。

この機能を有効にすると，実行時のメモリ使用量とJavaVMの実行性能が変化する場合があります。また，JavaVM実行時のOS環境の違いによっても，この機能有効時のJavaVMの実行性能が変動します。

注※　Explicitヒープ領域は，明示管理ヒープ機能が有効な場合にだけ該当します。

9.18.2　前提条件

各ヒープ領域（Javaヒープ領域，およびExplicitヒープ領域※）の設定サイズの総和が32GB未満のときに有効です。設定サイズの総和が32GB以上の場合は，-XX:+UseCompressedOopsを指定しても，この機能は無効となります。

圧縮オブジェクトポインタ機能が有効となるヒープ領域サイズ指定値

(1)明示管理ヒープ機能を使用する場合
　(-Xmxオプションの指定値) + (-XX:HitachiExplicitHeapMaxSizeオプションの指定値) < 32GB

(2)明示管理ヒープ機能を使用しない場合
　(-Xmxオプションの指定値) < 32GB

注※

Explicitヒープ領域は，明示管理ヒープ機能が有効な場合にだけ該当します。

9.18.3　注意事項

この機能を有効にすることによって，Javaアプリケーション実行時のJavaヒープ領域とExplicitヒープ領域の使用量が減少し，その変化量はJavaアプリケーションに依存します。もし，この機能を有効にしたことによるメモリ使用量の変化を問題視する場合は，この機能をOFFにしてください。

この機能を有効にすることによって，Javaアプリケーション実行時のスループットなどの実行性能に影響を与える場合があるのでご注意ください。この機能が実行性能に影響する点は，次の2点です。

(a)JavaVMが扱うデータ(Javaオブジェクト)サイズが減少し，より効率的なメモリアクセスができる(性能向上要因)

(b)JavaVMがJavaオブジェクトのサイズを圧縮するための計算が必要となる(性能低下要因)

(a)(b)の2点の要因から，この機能有効時JavaVM実行時の性能が変化することになります。また(b)については，JavaVM起動時のOS環境の違いによって，計算方法(詳細は次の(補足))も変化し実行性能に影響します。もし，この機能を有効にしたことによる性能の変化を問題視する場合は，この機能をOFFにしてください。

(補足) Javaオブジェクトのサイズの圧縮について

圧縮オブジェクトポインタ機能有効時，JavaVMはJavaオブジェクトのサイズを圧縮して管理しますが，その圧縮方法(以降，モードと呼びます)は複数存在します。JavaVMは起動時に，その実行環境状況によってどのモードを選択するかを決定します。以降，JavaVMは起動時に選択したモードを適用して，Javaオブジェクトのサイズを圧縮します。

どのモードを選択するかの条件は，次の2つとなります。

1.Javaヒープ領域とExplicitヒープ領域サイズの指定合計値

2. 1.のヒープ領域が仮想アドレス空間のどこに割り当てられるか

そのため，JavaVM起動時のヒープ領域サイズの指定値を変更した場合，または，同一OS上で動作しているほかのプロセスやライブラリのロード状況によっては，JavaVM起動ごとに異なるモードが適用されます。

どのモードが選択されるかは，実際にヒープ領域が仮想メモリ空間上のどこに割り当てられるかに依存するため，特定の圧縮モードが常に適用されるようにこの機能を有効とすることは困難です。この機能を無効・有効とした場合だけ性能の差異がでるだけでなく，この機能を有効とした場合も，JavaVMの起動ごとに性能の差異が発生する場合もあることにご注意ください。

参考として圧縮オブジェクトポインタ機能有効時にJavaVMが選択できる各モードについて，選択条件と圧縮方法の概要を次の表※1※2に示します。

表9‒25　圧縮オブジェクトポインタ機能のモード一覧

選択条件

概要説明

モード1

各ヒープ領域（Javaヒープ領域とExplicitヒープ領域※3）の総サイズが4GB未満であり，仮想アドレス空間上，全ヒープ領域が4GBよりも低位側に存在する場合

最も簡単な計算方法で，Javaオブジェクトのサイズを圧縮します。

モード2

モード1の適用ができないで，仮想アドレス空間上，その全ヒープ領域が32GBよりも低位側に存在する場合

モード1の次に簡単な計算方法によりJavaオブジェクトのサイズを圧縮します。

モード3

モード1とモード2が適用できなかった場合

これらモードのうち，最も複雑な方法でJavaオブジェクトの圧縮をします。

注※1

表に示した内容はJavaVMの内部処理を参考として示したものです。以降のJDKのアップデートや修正によって予告なく変更される場合があります。

注※2

AIXでは，プラットフォーム固有の制約によって，表9-25中のモード1およびモード2が選択できるメモリが確保できないため，必ずモード3が選択されます。

注※3

Explicitヒープ領域は，明示管理ヒープ機能を利用している場合だけ該当します。

9.19　Oracle社のJDKとアプリケーションサーバが提供するJDKとの非互換性

ここではOracle社のJDKとアプリケーションサーバが提供するJDKとの非互換性について説明します。

9.19.1　デフォルトで選択されるメモリ管理方式

Oracle社のJDK 9以降では，デフォルトで選択されるメモリ管理方式はガベージファースト・コレクタ（G1GC）に変更されました。しかし，アプリケーションサーバが提供するメモリ管理方式は，旧バージョンである 09-70と同じ，シリアルガベージコレクタ（SerialGC）であることに注意してください。

9.19.2　ランタイムイメージ

アプリケーションサーバではランタイムイメージの作成および再構成はサポートしていません。また，ランタイムイメージを作成するjlinkコマンドは同梱していません。

9.19.3　モジュール関連オプション

アプリケーションサーバでは，モジュールに関連したオプションで，サポートしていないオプションまたは制限事項のあるオプションがあります。

(1)　サポートしていないオプション

次に示すオプションは，アプリケーションサーバではサポートしていません。

--limit-modules

--module（または-m）

--patch-module

--upgrade-module-path

各オプションの詳細は，次のWebページを参照してください。

https://docs.oracle.com/en/java/javase/11/tools/java.html

(2)　制限事項のあるオプション

次に示すオプションには制限事項があります。これらのオプションには，更新対象モジュールにJDK内モジュール※を指定しないでください。

--add-exports

--add-opens

--add-reads

注※

JDK内モジュールとは，次のWebページに記載されているすべてのモジュールです。

https://docs.oracle.com/javase/jp/11/docs/api/index.html

各オプションの詳細は，次のWebページを参照してください。

https://docs.oracle.com/en/java/javase/11/tools/java.html

制限事項の対象となる使用例を次に示します。

（使用例1）

--add-exports=java.base/jdk.internal.jimage=my.module

更新対象にjava.baseモジュールを指定しないでください。

（使用例2）

--add-opens=java.base/jdk.internal.jimage=my.module

更新対象にjava.baseモジュールを指定しないでください。

（使用例3）

--add-reads=java.logging=my.module

更新対象にjava.loggingモジュールを指定しないでください。

10　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）

この章では，旧バージョンのアプリケーションサーバから移行する場合の方法について説明します。なお，ここでは，J2EEサーバモードを使ったシステムを移行する場合に必要な移行情報を記載しています。

10.1　アプリケーションサーバの移行の概要

旧バージョンからアプリケーションサーバ 11-20への移行方法について説明します。移行の対象となる旧バージョンを次に示します。

アプリケーションサーバ 08-00

アプリケーションサーバ 08-50

アプリケーションサーバ 08-53

アプリケーションサーバ 08-70

アプリケーションサーバ 09-00

アプリケーションサーバ 09-50

アプリケーションサーバ 09-60

アプリケーションサーバ 09-70

アプリケーションサーバ 09-80

アプリケーションサーバ 09-87

アプリケーションサーバ 11-00

アプリケーションサーバ 11-10

なお，このマニュアルでは，次に示す構成ソフトウェアの移行を中心に説明します。

Performance Tracer

Component Container

Component Transaction Monitor

Component Container - Client

Component Container - Redirector

Developer's Kit for Java

旧バージョンからの移行を行う場合，使用しているアプリケーションサーバの全構成ソフトウェアを同時に移行する必要があります。上記で示していないほかの構成ソフトウェア（以降，他構成ソフトウェアと呼びます）の移行については，次に示すマニュアルを参照してください。

表10‒1　構成ソフトウェアごとの参照先マニュアル

構成ソフトウェア

参照先マニュアル

HTTP Server

HTTP Server

Reliable Messaging

Reliable Messaging

Web Services - Security

アプリケーションサーバ Webサービスセキュリティ構築ガイド

XML Processor

XML Processor ユーザーズガイド

注意事項

構成ソフトウェアは，バージョンごとに体系が異なる場合があります。

バージョンごとの構成ソフトウェアの体系について次に示します。

表10‒2　バージョンごとの構成ソフトウェアの体系

構成ソフトウェア

アプリケーションサーバのバージョン

備考

V8

V9

Component Container

○

○

なし

Component Transaction Monitor

○

○

V8まではApplication Server Enterpriseだけに同梱。

DABroker Library

○

○

互換用としてサポート。

Developer's Kit for Java

○

○

なし

Performance Tracer

○

○

なし

Reliable Messaging

○

○

なし

Server Plug-in

○

−

UNIXで動作する製品には含まれない。

TPBroker

○

○

なし

Web Services - Security

○

○

なし

XML Processor

○

○

なし

HTTP Server

○

○

V9から名称をHitachi Web ServerからHTTP Serverへ変更。

（凡例）○：対応するバージョンで構成ソフトウェアあり

　　　　−：対応するバージョンで構成ソフトウェアなし

参考

TPBrokerについては，明示的な移行作業はありません。このほか，アプリケーションサーバ上で動作するSOAPアプリケーションや，Webサービスなどの移行については，次のマニュアルを参照してください。

SOAPアプリケーション

マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」

JAX-WS仕様に対応したSOAP Webサービス／JAX-RS仕様に対応したRESTful Webサービス

マニュアル「アプリケーションサーバ Webサービス開発ガイド」

アプリケーションサーバの移行の概要について説明します。

10.1.1　移行のための新規インストール，または更新インストール

旧バージョンからアプリケーションサーバ 11-20へ移行するためには，新規インストール，または更新インストールを行います。新規インストールとは，アプリケーションサーバがインストールされていない新規のマシンに，アプリケーションサーバをインストールすることです。更新インストールとは，インストール先のマシンに旧バージョンのアプリケーションサーバがインストール済みの場合のインストールです。

なお，更新インストールの場合は，アプリケーションサーバのインストールディレクトリを旧バージョンのインストールディレクトリから変更できません。旧バージョンがインストールされているディレクトリに上書きインストールされます。

新規インストールの場合の移行手順は，「10.2.1　新規インストールの場合」を参照してください。

更新インストールの場合の移行手順は，「10.2.2　更新インストールの場合」を参照してください。

10.1.2　移行時に引き継がれる情報

旧バージョンで使用されていた，<製品のインストールディレクトリ>以下に配置される定義情報，DD（Deployment Descriptor）情報，構成情報などのユーザ資産は，移行コマンドなどで必要に応じて自動変換され，11-20で引き続き使用されます（一部，手動での定義修正が必要な場合もあります）。また，移行コマンドを実行すると，移行元バージョンから移行先バージョン間のすべてのバージョンごとに移行処理が実施されます。例えば，09-00から11-20へ移行する場合，09-00から09-50への移行，09-50から09-70への移行，09-70から09-80への移行，09-80から09-87への移行，09-87から11-00への移行，11-00から11-10への移行，11-10から11-20への移行というように処理が実施されます。

Component Containerで引き継がれる定義情報，DD情報，構成情報などを次の表に示します。他構成ソフトウェアについては，それぞれのドキュメントを参照してください。

表10‒3　Component Containerで移行時に引き継がれる情報

機能

引き継がれる情報

ファイル名称，または格納場所

J2EEサーバ

オプション定義ファイル

usrconf.cfg

ユーザプロパティファイル

usrconf.properties

セキュリティポリシーファイル

server.policy

Webアプリケーションプロパティファイル

hitachi_web.properties

作業ディレクトリ

定義情報

アプリケーション

DD情報

ユーザ・パスワード情報

オプション定義ファイルで指定されているejb.public.directoryの値。デフォルトは，次のとおり。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥public以下

UNIXの場合

/opt/Cosminexus/CC/server/public以下

バッチサーバ

オプション定義ファイル

usrconf.cfg

ユーザプロパティファイル

usrconf.properties

セキュリティポリシーファイル

server.policy

作業ディレクトリ

定義情報

DD情報

ユーザ・パスワード情報

オプション定義ファイルで指定されているejb.public.directoryの値。デフォルトは，次のとおり。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥public以下

UNIXの場合

/opt/Cosminexus/CC/server/public以下

サーバ管理コマンド

オプション定義ファイル

Windowsの場合

usrconf.bat

UNIXの場合

usrconf

ユーザプロパティファイル

usrconf.properties

Webサーバ連携

Web Server用リダイレクタ動作定義ファイル

mod_jk.conf

Microsoft IIS用リダイレクタ動作定義ファイル（Windowsだけのファイル）

isapi_redirect.conf

Microsoft IIS用マッピング定義ファイル（Windowsだけのファイル）

uriworkermap.properties

ワーカ定義ファイル

workers.properties

Management Server

運用管理エージェントプロパティファイル

adminagent.properties

運用管理エージェント設定ファイル

adminagent.xml

別のファイル名称でバックアップされたあと，新規のファイルで上書きされます。

Management Serverの「論理サーバの起動／停止」で使用する環境変数を指定する機能を利用している場合，手動による定義修正が必要となります。

運用監視エージェント設定ファイル

mngagent.<実サーバ名>.properties

Management Server環境設定ファイル

mserver.properties

mngsvrutilコマンドのサーバ側定義ファイル

mngsvrutil.properties

構成情報定義

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config以下

UNIXの場合

/opt/Cosminexus/manager/config以下

Managementアクション実行用プロパティファイル

maction.properties

Management Server用メッセージマッピングファイル

mserver.jp1event.system.mapping.properties

J2EEサーバ共通用メッセージマッピングファイル

manager.jp1event.system.mapping.properties

J2EEサーバ個別用メッセージマッピングファイル

manager.<論理サーバ名>.jp1event.system.mapping.properties

J2EEアプリケーションの登録ディレクトリのデフォルトパス

Windowsの場合

<製品のインストールディレクトリ>¥manager¥apps以下

UNIXの場合

/opt/Cosminexus/manager/apps以下

統合ユーザ管理

JAASのコンフィグレーションファイル

jaas.conf

統合ユーザ管理のコンフィグレーションファイル

ua.conf

カスタムログインモジュール格納用ディレクトリ

Windowsの場合

<製品のインストールディレクトリ>¥manager¥modules

UNIXの場合

/opt/Cosminexus/manager/modules

Smart Composer機能

サーバ設定プロパティファイル

cmxserver.properties

負荷分散機定義プロパティファイル

lb.properties

10.1.3　移行時のJ2EEアプリケーションの動作

アプリケーションサーバを更新インストールする場合，または旧バージョンのJ2EEアプリケーションをインポートする場合には，次に示す処理で，自動的にJ2EEアプリケーションに含まれるEJBの再デプロイが実行されるため，一時的に性能が悪くなります。

開始状態のJ2EEアプリケーションが存在する状態でアプリケーションサーバを更新インストールしたあとの初回J2EEサーバ起動時

停止状態のJ2EEアプリケーションが存在する状態でアプリケーションサーバを更新インストールしたあとの初回J2EEアプリケーション開始時

旧バージョンのアプリケーションサーバでエクスポートした実行時情報を含む，開始状態のJ2EEアプリケーションのインポート時

旧バージョンのアプリケーションサーバでエクスポートした実行時情報を含む，停止状態のJ2EEアプリケーションをインポートしたあとの初回J2EEアプリケーション開始時

10.2　アプリケーションサーバの移行手順の詳細

10.2.1　新規インストールの場合

ここでは，旧バージョンのアプリケーションサーバを移行する場合に，新しいアプリケーションサーバを，旧バージョンのアプリケーションサーバを構築している環境とは別の環境へ構築（新規インストール）する際の手順について示します。

新規インストールについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「2.2.1　Application Serverのインストールについて」を参照してください。

次の手順に従って，旧バージョンからアプリケーションサーバ 11-20へ移行してください。

図10‒1　旧バージョンからアプリケーションサーバ 11-20への移行作業（新規インストールの場合）

(1)　移行方針の決定

移行後の環境で使用する機能や，使用するWebサーバの種類などを決めます。

また，旧バージョンのアプリケーションサーバの環境での設定を引き継ぐのか（互換性を重視したシステムへ移行），または移行後のアプリケーションサーバが推奨する機能を使用する設定にするのか（推奨機能を使用したシステムへ移行）についても検討します。互換重視のシステム，および推奨機能を使用したシステムの特徴を次に示します。

表10‒4　互換重視のシステムおよび推奨機能を使用したシステムの特徴

移行方針

特徴

互換性を重視したシステムへ移行

推奨されていない機能を，移行後の環境でも使用します。

推奨されていない機能については，マニュアル「アプリケーションサーバ 機能解説 互換編」を参照してください。

機能が廃止されたり，互換性がない仕様変更があったりするため，旧システムと完全に同じ環境は構築できません（J2SEやJ2EEのバージョン変更，サーバマネージャやユーザマネージャの廃止など）。

最新のバージョンのアプリケーションサーバで追加された機能には，互換性を重視したシステムの設定では使用できない場合もあります（コネクション自動クローズ機能など）。

推奨機能を使用したシステムへ移行

最新のバージョンのアプリケーションサーバで使用できる機能でも，推奨される機能がほかにある場合は，推奨機能が選択されます。

これらの移行方針を決定する上で，旧バージョンと移行するバージョンとの仕様差を確認する必要があります。機能の変更や追加に伴い，旧バージョンで使用している機能，使用条件，使用方法によっては，次の作業が必要となります。

操作手順の変更

運用手順の変更

アプリケーション，およびDDの変更

詳細は，「10.3　旧バージョンから11-20までの仕様変更の確認」を参照してください。

(2)　アプリケーションの退避

旧バージョンのアプリケーションサーバで使用していたアプリケーションを退避します。退避の手順を次に示します。

J2EEアプリケーション，およびJ2EEアプリケーション内のEJB-JAR，WAR属性ファイルを取得します。

J2EEリソースアダプタを，実行時情報を含む形式でエクスポートします。

開始状態の場合は停止してからエクスポートしてください。

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

Connector属性ファイルは，移行後に属性変更が必要になった場合に使用します。

データソース属性ファイルを取得します。

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

サーバ管理コマンドで追加したユーザおよびロールの情報を記録しておきます。

なお，Reliable Messagingを使用している場合は，上記のJ2EEリソースアダプタと同様に，Reliable MessagingのリソースアダプタおよびConnector属性ファイルを退避してください。

(3)　定義などのバックアップ

旧バージョンのアプリケーションサーバで使用していた定義ファイルを退避します。新規インストールの場合，ここで退避したバックアップ情報を基に，新規インストールする環境で使用する定義ファイルなどを作成します。詳細は，「10.6　定義などのバックアップ」を参照してください。なお，adminagent.xml，snapshotlog.confおよびsnapshotlog.2.confについては，カスタマイズした情報を控えてください。

(4)　全構成ソフトウェアの新規インストール

使用しているアプリケーションサーバの全構成ソフトウェアを新規インストールします。

なお，インストール方法，および注意事項については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「2.2.1　Application Serverのインストールについて」を参照してください。

(5)　システムの構築

新規インストールを実施した環境のシステムを構築します。「(3)　定義などのバックアップ」で退避した，運用管理ポータルの［運用管理ドメインの構成定義］画面の情報，または簡易構築定義ファイルの情報を基に，システムを構築します。システムの構築とは，セットアップウィザードの実行，運用管理ポータルの［運用管理ドメインの構成定義］画面での操作，またはSmart Composer機能のcmx_build_systemコマンド実行を指します。

システムの構築については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

(6)　定義などの配置

adminagent.xml，snapshotlog.confおよびsnapshotlog.2.conf以外の定義ファイルは，旧バージョンのアプリケーションサーバから退避した定義ファイルを，新規インストールする環境に配置します。詳細は，「10.6　定義などのバックアップ」のバックアップを取った情報の設定先に関する説明を参照してください。

これらの定義ファイルの場合は旧バージョンのアプリケーションサーバから退避した定義ファイルに，最新のバージョンの情報を追加します。情報の追加は，「(8)　手動による定義などの修正」で記載している作業になります。

adminagent.xml，snapshotlog.confおよびsnapshotlog.2.confの場合は，「(3)　定義などのバックアップ」で控えた情報を基に新規インストールされた定義ファイルに，旧バージョンのアプリケーションサーバでカスタマイズした情報を追加します。

参考

adminagent.xml，snapshotlog.confおよびsnapshotlog.2.confは，旧バージョンのアプリケーションサーバで使用していた定義ファイルを上書きして使用しないでください。

(7)　手動による定義などの修正

「(3)　定義などのバックアップ」で退避した情報を基に，手動で定義などを修正します。機能の変更，追加に伴い，互換性を保つためのオプションが提供されています。旧バージョンで使用している機能，使用方法，使用条件によっては，次の作業が必要となります。

ユーザプロパティファイルなどの定義ファイルの変更

Javaのユーザクラスパスの変更

環境変数の変更

旧バージョンで使用している機能，使用方法，使用条件については，「10.3　旧バージョンから11-20までの仕様変更の確認」を参照してください。

なお，このマニュアルで説明していない構成ソフトウェアの旧バージョンに関する説明については，次に示すマニュアルを参照してください。

HTTP Server

マニュアル「HTTP Server」の旧バージョンからの移行に関する注意事項を参照してください。

Web Services - Security

マニュアル「アプリケーションサーバ Webサービスセキュリティ構築ガイド」の下位バージョンからの移行情報に関する説明を参照してください。

XML Processor

マニュアル「XML Processor ユーザーズガイド」のバージョン間の差異に関する説明を参照してください。

(8)　論理サーバの設定情報の再読み込みおよび配布

設定した定義情報をシステムへ反映させます。詳細は，「10.10　論理サーバの設定情報の再読み込みおよび配布」を参照してください。

配布したあと，運用管理ポータルから，「(3)　定義などのバックアップ」で控えた論理J2EEサーバの［JP1連携の設定］画面で，JP1連携の再設定をしてください。再設定後は，再度配布してください。

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

アプリケーションを設定します。詳細は，「10.11　アプリケーションの設定（新規インストールの場合）」を参照してください。

なお，Reliable Messagingを使用している場合は，J2EEリソースアダプタの手順と同様に，退避していたReliable Messagingのリソースアダプタを更新してください。この際，Reliable Messagingを使用するために必要なシステム構築を実施してください。

Reliable Messagingのシステム構築の詳細については，マニュアル「Reliable Messaging」を参照してください。

(10)　移行後の確認

移行後にアプリケーションサーバの動作確認を実施します。

10.2.2　更新インストールの場合

ここでは，旧バージョンのアプリケーションサーバを移行する場合に，旧バージョンのアプリケーションサーバを構築している環境の上に，新規のアプリケーションサーバの環境を構築（更新インストール）する際の手順について示します。

更新インストールについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「2.2.1　Application Serverのインストールについて」を参照してください。

次の手順に従って，旧バージョンからアプリケーションサーバ 11-20へ移行してください。

図10‒2　旧バージョンからアプリケーションサーバ 11-20への移行作業（更新インストールの場合）

(1)　移行方針の決定

詳細は「10.2.1(1)　移行方針の決定」を参照してください。

(2)　J2EEサーバまたはバッチサーバの作業ディレクトリのディスク容量の確認

移行のために十分なディスク容量があるかを確認します。詳細については，「10.4　J2EEサーバまたはバッチサーバの作業ディレクトリのディスク容量の確認」を参照してください。

(3)　アプリケーションサーバの動作環境および動作状態の確認

移行前にアプリケーションサーバの動作環境，動作状態などを確認します。詳細については，「10.5　アプリケーションサーバの動作環境および動作状態の確認」を参照してください。

(4)　定義などのバックアップ

旧バージョンのアプリケーションサーバで使用していた定義ファイルを退避します。詳細については，「10.6　定義などのバックアップ」を参照してください。

(5)　他構成ソフトウェアの移行準備

使用しているアプリケーションサーバの全構成ソフトウェアについて移行の準備をします。

構成ソフトウェアごとの参照先マニュアルについては，「10.1　アプリケーションサーバの移行の概要」の構成ソフトウェアごとの参照先マニュアルに関する説明を参照してください。

なお，ここで準備した情報を基に，「(12)　他構成ソフトウェアの移行実施」で他構成ソフトウェアを移行してください。

(6)　全構成ソフトウェアの更新インストール

使用しているアプリケーションサーバの全構成ソフトウェアを更新インストールします。

なお，インストール方法，および注意事項については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「2.2.1　Application Serverのインストールについて」を参照してください。

(7)　J2EEサーバまたはバッチサーバの移行コマンドの実行

定義情報，DD情報などを継続して利用できるようにするため，J2EEサーバまたはバッチサーバの移行コマンド（cjenvupdate）を実行します。詳細については，「10.7　J2EEサーバまたはバッチサーバの移行コマンドの実行」を参照してください。

(8)　リソースアダプタの移行

旧バージョンのアプリケーションサーバで使用していたリソースアダプタを使用する場合，リソースアダプタの移行処理が必要です。

DB Connectorやほかのリソースアダプタの場合は，リソースアダプタの移行コマンド（cjrarupdateコマンド）を実行します。ただし，CJMSPリソースアダプタの場合，リソースアダプタの移行コマンド（cjrarupdateコマンド）は使用できません。サーバ管理コマンドを使用してCJMSPリソースアダプタを入れ替えてください。

(a)　リソースアダプタの移行コマンドの実行

旧バージョンでDB Connectorを使用していた場合，またはほかのリソースアダプタを更新インストールする場合，DB Connectorやほかのリソースアダプタを入れ替えるためには，リソースアダプタの移行コマンド（cjrarupdate）を実行します。詳細については，「10.8.1　リソースアダプタの移行コマンドの実行」を参照してください。

(b)　CJMSPリソースアダプタの入れ替え

CJMSプロバイダのリソースアダプタ（CJMSPリソースアダプタ）をバージョンアップする場合，リソースアダプタの移行コマンド（cjrarupdate）は使用できません。この場合，サーバ管理コマンドを使用してCJMSPリソースアダプタを入れ替えてください。詳細は，「10.8.2　CJMSPリソースアダプタの入れ替え」を参照してください。

(9)　Management Serverの移行コマンドの実行

アプリケーションサーバ Version 8から移行する場合，Management Serverの移行コマンド（mngenvupdate）を実行します。詳細については，「10.9　Management Serverの移行コマンドの実行」を参照してください。

(10)　手動による定義などの修正

手動で定義などを修正します。機能の変更，追加に伴い，互換性を保つためのオプションが提供されています。旧バージョンで使用している機能，使用方法，使用条件によっては，次の作業が必要となります。

ユーザプロパティファイルなどの定義ファイルの変更

Javaのユーザクラスパスの変更

環境変数の変更

詳細については，「10.3　旧バージョンから11-20までの仕様変更の確認」を参照してください。

(11)　論理サーバの設定情報の再読み込みおよび配布

設定した定義情報をシステムへ反映させます。詳細は，「10.10　論理サーバの設定情報の再読み込みおよび配布」を参照してください。

(12)　他構成ソフトウェアの移行実施

他構成ソフトウェアを移行します。移行の詳細はそれぞれの他構成ソフトウェアのドキュメントを参照してください。なお，「(5)　他構成ソフトウェアの移行準備」で準備した情報を基に移行を実施してください。

(13)　移行後の確認

移行後にアプリケーションサーバの動作確認を実施します。

(14)　移行コマンドで作成されたバックアップ削除

移行コマンドでは，各種バックアップを作成します。移行後の確認が完了したあと，バックアップを削除してください。詳細については，「10.12　移行コマンドで作成されたバックアップの削除」を参照してください。

10.3　旧バージョンから11-20までの仕様変更の確認

旧バージョンから11-20までの仕様変更について説明します。

10.3.1　アプリケーションサーバ Version 8から11-20までの仕様変更

この項にある表で，アプリケーションサーバ Version 8から11-20までの仕様変更の項目を示します。

アプリケーションサーバVersion 8から11-20に移行する場合，この項にある表の「移行前のアプリケーションサーバのバージョン」列で該当する列を確認してください。「○」のときは仕様変更があるため，「仕様変更の項目」列に記載の参照先を確認してください。「−」のときは仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要です。なお，「仕様変更の項目」列の項番は，「10.3.5　旧バージョンからVersion 9までの仕様変更の一覧」の説明の項番と対応しています。

アプリケーションに関する仕様変更

表10‒5　アプリケーションサーバ Version 8から11-20までの仕様変更（アプリケーションに関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

08-70

08-53

08-50

08-00

全体

10.3.4　11-20への移行とV9互換モードについて

○

○

○

○

10.3.5(1)　Java SEのバージョン

○

○

○

○

J2EEサーバ

10.3.5(2)　JSPから生成されたサーブレット用コンパイラのバージョン

○

○

○

○

10.3.5(3)　POSTリクエストのフォームデータの最大サイズの制限

−

−

−

○

10.3.5(23)　javax.servlet.http.HttpServletRequestインタフェースのgetSessionメソッドでスローされる例外の変更

−

○

○

○

10.3.5(24)　アプリケーションサーバで実行できるアプリケーションの構成の変更

○

○

○

○

10.3.5(25)　アプリケーションサーバで実行できるWebアプリケーションの構成の変更

○

○

○

○

10.3.5(4)　同一J2EEサーバ内のほかのアプリケーションで動作するEnterprise Beanの呼び出し手順の改善

○

○

○

○

10.3.5(26)　Portable Global JNDI対応

○

○

○

○

10.3.5(43)　MimeUtility APIの仕様変更

○

○

○

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

−：仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要

構築環境に関する仕様変更

表10‒6　アプリケーションサーバ Version 8から11-20までの仕様変更（構築環境に関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

08-70

08-53

08-50

08-00

全体

10.3.4　11-20への移行とV9互換モードについて

○

○

○

○

Management Server

10.3.5(6)　論理サーバの環境変数定義の再設定

○

○

○

○

10.3.5(7)　JP1イベントメッセージマッピングファイルの再設定

○

○

○

○

10.3.5(8)　snapshotログ収集先対象リストファイルの再設定

○

○

○

○

10.3.5(9)　OutOfMemoryError発生時の運用管理エージェントの動作変更

○

○

○

○

10.3.5(10)　負荷分散機のCookieスイッチング機能のモード変更

−

−

○

○

10.3.5(11)　運用管理ポータルで操作対象とするリソースアダプタの変更

−

○

○

○

10.3.5(12)　Smart Composer機能でcmx_build_system（-sオプション指定）コマンド実行時の設定情報の配布に関する動作変更

○

○

○

○

10.3.5(13)　運用管理エージェントおよびManagement Serverの自動起動の設定方法変更（UNIXの場合）

○

○

○

○

10.3.5(14)　Management Serverのプロセス構成の変更

○

○

○

○

10.3.5(15)　cmx_list_statusコマンドによるサービスユニットの稼働状況のステータス変更

○

○

○

○

10.3.5(16)　Management Serverの機能を使用した明示管理ヒープ機能の自動配置設定ファイルの設定方法の追加

○

○

○

−

10.3.5(17)　Management Serverの移行

○

○

○

○

10.3.5(18)　WebPasswordJDBCLoginModule使用時のDB接続設定の見直し

−

○

○

○

10.3.5(45)　Permanent領域からMetaspace領域への移行

○

○

○

○

J2EEサーバ

10.3.5(27)　TP1インバウンド連携機能でのコネクション保持のサポート

−

−

○

−

10.3.5(28)　TP1インバウンド連携機能での最大同時接続数のデフォルト値の変更

−

−

○

−

10.3.5(29)　TP1インバウンド連携機能で使用するスレッド数，ファイルディスクリプタ数，ポート番号の変更

−

−

○

−

10.3.5(30)　データベースセッションフェイルオーバ機能での完全性保障モードの変更

−

○

○

○

10.3.5(31)　TP1インバウンド連携機能の同期点待ち受けポートの追加

−

−

○

○

10.3.5(32)　データベースセッションフェイルオーバ機能のデータベーステーブルの再作成

○

○

○

○

10.3.5(33)　データベースセッションフェイルオーバ機能でのDB Connectorに設定するステートメントプールの数の変更

○

○

○

○

10.3.5(34)　@EJBアノテーションのmappedName属性の仕様変更

○

○

○

○

10.3.5(19)　証明書のインポート

−

−

−

○

10.3.5(20)　DBConnector_SQLServer_CP.rarの非サポート

○

○

○

○

10.3.5(21)　DBConnector_SQLServer2005_CP.rarの名称変更

○

○

○

○

10.3.5(38)　サーバIDのデフォルト値の変更

○

○

○

○

10.3.5(41)　server.policy（J2EEサーバ用セキュリティポリシーファイル）への定義の追加

○

○

○

○

10.3.5(45)　Permanent領域からMetaspace領域への移行

○

○

○

○

サーバ管理コマンド

10.3.5(39)　cjimportappコマンドの-aまたは-dオプション実行時の重複ディレクトリチェックの変更

○

○

○

○

Webサーバ連携

10.3.5(35)　Microsoft IIS 7.0，7.5の設定変更

○

○

−

−

パフォーマンストレーサ

10.3.5(22)　PRFトレースバックアップの設定変更

○

○

○

○

JavaVM

10.3.5(36)　明示管理ヒープ機能の自動配置機能で使用する設定ファイルの内容変更

○

○

○

−

10.3.5(45)　Permanent領域からMetaspace領域への移行

○

○

○

○

EJBクライアント

10.3.5(45)　Permanent領域からMetaspace領域への移行

○

○

○

○

Webコンテナサーバ

10.3.5(45)　Permanent領域からMetaspace領域への移行

○

○

○

○

バッチアプリケーション実行基盤

10.3.5(45)　Permanent領域からMetaspace領域への移行

○

○

○

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

−：仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要

運用環境に関する仕様変更

表10‒7　アプリケーションサーバ Version 8から11-20までの仕様変更（運用環境に関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

08-70

08-53

08-50

08-00

全体

10.3.4　11-20への移行とV9互換モードについて

○

○

○

○

Management

Server

10.3.5(42)　Managementイベント発行用メッセージIDの追加

○

○

○

○

J2EEサーバ

10.3.5(40)　J2EEアプリケーション開始時のJavaのコンパイルの仕様

○

○

○

○

10.3.5(5)　J2EEアプリケーション起動時およびJSPコンパイル時のJavaプログラムのコンパイル処理

○

○

○

○

10.3.5(38)　サーバIDのデフォルト値の変更

○

○

○

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

−：仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要

10.3.2　アプリケーションサーバ Version 9から11-20までの仕様変更

この項にある表で，アプリケーションサーバ Version 9から11-20までの仕様変更の項目を示します。

アプリケーションサーバVersion 9から11-20に移行する場合，この項にある表の「移行前のアプリケーションサーバのバージョン」列で該当する列を確認してください。「○」のときは仕様変更があるため，「仕様変更の項目」列に記載の参照先を確認してください。「−」のときは仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要です。なお，「仕様変更の項目」列の項番は，「10.3.5　旧バージョンからVersion 9までの仕様変更の一覧」の説明の項番と対応しています。

アプリケーションに関する仕様変更

表10‒8　アプリケーションサーバ Version 9から11-20までの仕様変更（アプリケーションに関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

09-87

09-80

09-70

09-60

09-50

09-00

全体

10.3.4　11-20への移行とV9互換モードについて

○

○

○

○

○

○

10.3.5(1)　Java SEのバージョン

−

○

○

○

○

○

J2EEサーバ

10.3.5(2)　JSPから生成されたサーブレット用コンパイラのバージョン

−

−

−

○

○

○

10.3.5(43)　MimeUtility APIの仕様変更

−

−

−

−

−

○

JavaVM

10.3.5(46)　JDK内部のファイル構成変更

−

−

○

○

○

○

10.3.5(47)　削除されたAPI／機能／オプション

−

−

○

○

○

○

10.3.5(48)　バージョン文字列形式の変更

−

−

○

○

○

○

10.3.5(49)　内部APIのカプセル化

−

−

○

○

○

○

10.3.5(53)　システムクラスローダの継承関係の変更

−

−

○

○

○

○

10.3.5(56)　java.io.FileInputStreamとjava.io.FileOuputStreamクラスのfinalizeメソッドの実装変更

−

○

○

○

○

○

10.3.5(58)　Java EE向けモジュールとCORBAモジュールの削除

−

○

○

○

○

○

10.3.5(59)　クラスファイルバージョンの変更

−

○

○

○

○

○

10.3.5(60)　javacコマンドのsource/target/releaseオプションに指定できる値

−

○

○

○

○

○

10.3.5(61)　Javaプログラム実行中のシステムプロパティの変更

−

○

○

○

○

○

10.3.5(62)　3DES暗号スイートの無効化

−

○

○

○

○

○

10.3.5(63)　runFinalizersOnExitメソッドの削除

−

○

○

○

○

○

10.3.5(64)　ThreadPoolExecutorとScheduledThreadPoolExecutorクラスのfinalizeメソッドの実装変更

−

○

○

○

○

○

10.3.5(65)　getAnnotationメソッド呼び出しで発生する例外の変更

−

○

○

○

○

○

10.3.5(72)　クラスライブラリのスタックトレース出力オプションの対象となるAPIの変更

−

○

○

○

○

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

−：仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要

構築環境に関する仕様変更

表10‒9　アプリケーションサーバ Version 9から11-20までの仕様変更（構築環境に関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

09-87

09-80

09-70

09-60

09-50

09-00

全体

10.3.4　11-20への移行とV9互換モードについて

○

○

○

○

○

○

Management

Server

10.3.5(6)　論理サーバの環境変数定義の再設定

−

−

−

−

−

○

10.3.5(7)　JP1イベントメッセージマッピングファイルの再設定

−

−

−

−

−

○

10.3.5(8)　snapshotログ収集先対象リストファイルの再設定

−

−

−

−

−

○

10.3.5(9)　OutOfMemoryError発生時の運用管理エージェントの動作変更

−

−

−

−

−

○

10.3.5(14)　Management Serverのプロセス構成の変更

−

−

−

−

−

○

10.3.5(45)　Permanent領域からMetaspace領域への移行

−

−

−

○

○

○

J2EEサーバ

10.3.5(21)　DBConnector_SQLServer2005_CP.rarの名称変更

−

−

−

−

−

○

10.3.5(38)　サーバIDのデフォルト値の変更

−

−

−

−

−

○

10.3.5(45)　Permanent領域からMetaspace領域への移行

−

−

−

○

○

○

サーバ管理コマンド

10.3.5(39)　cjimportappコマンドの-aまたは-dオプション実行時の重複ディレクトリチェックの変更

−

−

−

−

−

○

JavaVM

10.3.5(36)　明示管理ヒープ機能の自動配置機能で使用する設定ファイルの内容変更

−

−

−

−

−

○

10.3.5(44)　RSA BSAFE SSL-Jの削除

−

−

−

○

−

−

10.3.5(45)　Permanent領域からMetaspace領域への移行

−

−

−

○

○

○

10.3.5(50)　-Xbootclasspathオプションと-Xbootclasspath/pオプションの削除

−

−

○

○

○

○

10.3.5(51)　推奨標準機構（Endorsed Standards Override Mechanism）の削除

−

−

○

○

○

○

10.3.5(52)　拡張機能機構（Extensions Mechanism）の削除

−

−

○

○

○

○

10.3.5(54)　javahコマンドの削除

−

○

○

○

○

○

10.3.5(55)　-Xprofオプションの削除

−

○

○

○

○

○

10.3.5(57)　JMXエージェントのパスワード暗号化

−

○

○

○

○

○

10.3.5(66)　日立拡張機能が提供するファイルの配置場所の変更

−

−

○

○

○

○

10.3.5(67)　拡張verbosegc出力機能のログフォーマット変更（G1GCを使用する場合）

−

−

○

○

○

○

10.3.5(70)　インストーラ

−

−

○

○

○

○

10.3.5(71)　更新インストール時に退避するファイルと退避先

−

−

○

○

○

○

EJBクライアント

10.3.5(45)　Permanent領域からMetaspace領域への移行

−

−

−

○

○

○

Webコンテナサーバ

10.3.5(45)　Permanent領域からMetaspace領域への移行

−

−

−

○

○

○

バッチアプリケーション実行基盤

10.3.5(45)　Permanent領域からMetaspace領域への移行

−

−

−

○

○

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

−：仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要

運用環境に関する仕様変更

表10‒10　アプリケーションサーバ Version 9から11-20までの仕様変更（運用環境に関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

09-87

09-80

09-70

09-60

09-50

09-00

全体

10.3.4　11-20への移行とV9互換モードについて

○

○

○

○

○

○

J2EEサーバ

10.3.5(37)　Servlet 3.0を使用したアプリケーションのリロードに関する仕様の変更

−

−

−

−

−

○

10.3.5(38)　サーバIDのデフォルト値の変更

−

−

−

−

−

○

JavaVM

10.3.5(68)　スレッドダンプ中のJavaVM内部メモリマップ情報の出力フォーマット変更

−

−

○

○

○

○

10.3.5(69)　エラーリポートファイル中のメモリ情報の出力フォーマット変更

−

−

○

○

○

○

10.3.5(73)　G1GCの処理変更に伴うJavaVMログファイルの出力形式変更

−

−

○

○

○

○

10.3.5(74)　StackOverflowError

−

−

○

○

○

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

−：仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要

10.3.3　アプリケーションサーバ 11-00または11-10から，11-20までの仕様変更

この項にある表で，アプリケーションサーバ 11-00または11-10から，11-20までの仕様変更の項目を示します。

アプリケーションサーバ 11-00または11-10から，11-20に移行する場合，この項にある表の「移行前のアプリケーションサーバのバージョン」列で該当する列を確認してください。「○」のときは仕様変更があるため，「仕様変更の項目」列に記載の参照先を確認してください。「−」のときは仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要です。

アプリケーションに関する仕様変更

表10‒11　アプリケーションサーバ 11-00または11-10から，11-20までの仕様変更（アプリケーションに関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

11-10

11-00

J2EEサーバ

(2)　アプリケーションサーバのJPA機能のCDI Managed Bean対応

○

○

(3)　Webコンテナのwelcomeファイル転送方式

○

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

構築環境に関する仕様変更

表10‒12　アプリケーションサーバ 11-00または11-10から，11-20までの仕様変更（構築環境に関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

11-10

11-00

J2EEサーバ

(1)　アプリケーションサーバのJPA機能

−

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

−：仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要

運用環境に関する仕様変更

表10‒13　アプリケーションサーバ 11-00または11-10から，11-20までの仕様変更（運用環境に関する仕様変更）

分類

仕様変更の項目

移行前のアプリケーションサーバのバージョン

11-10

11-00

J2EEサーバ

(1)　アプリケーションサーバのJPA機能

−

○

（凡例）

○：仕様変更があるため，参照先の確認が必要

−：仕様変更がない，または移行前のバージョンにその仕様がないため，参照先の確認は不要

(1)　アプリケーションサーバのJPA機能

アプリケーションサーバ 11-10以降，アプリケーションサーバのJPA機能はデフォルトで有効になります。11-00から移行した場合でも同様です。

11-00から移行した場合に，11-00のJ2EEサーバでJPA2.1を利用していたアプリケーションが，メッセージKDJE56515-Eを出力して開始に失敗するときは，アプリケーションサーバのJPA機能を無効にしてください。アプリケーションサーバのJPA機能を無効にするには，ユーザプロパティファイルに次のプロパティを設定してください。

ejbserver.jpa.disabled=true

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

ありません。

(2)　アプリケーションサーバのJPA機能のCDI Managed Bean対応

11-20以降では，CDI Managed Bean（それに関連づくインターセプタ含む）からアプリケーションサーバのJPA機能の使用をサポートします。そのため，CDI Managed Beanで@PersistenceContextおよび@PersistenceUnitが有効になり，アノテーションによってコンテナ管理のEntityManagerとEntityManagerFactoryがインジェクトされます。11-10以前から移行した場合でも同様です。

CDI Managed Beanで@PersistenceContextおよび@PersistenceUnitを無効にしたい場合は，ユーザプロパティファイルに次のプロパティを設定してください。

ejbserver.jpa.cdiEnabled=false

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

ありません。

(3)　Webコンテナのwelcomeファイル転送方式

11-20以降では，Webコンテナのwelcomeファイル転送方式がリダイレクト方式からフォワード方式に変更になります。このため，welcomeファイルをリダイレクトで処理することを期待していたアプリケーションを11-10以前から移行する場合，次の動作が異なります。

welcomeファイル内で指定した相対パスは，welcomeファイルを配置した位置からの相対パスではなく，リクエストURLからの相対パスとして処理します。

welcomeファイルを配置した位置からの相対パスとリクエストURLからの相対パスとが異なる場合，welcomeファイルからの遷移先が11-10以前と異なることがあります。

互換性を重視したシステムへ移行する場合に必要な作業

V9互換モードでは，リダイレクト方式から変更がないため作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

welcomeファイル内で相対パスを指定していて，リクエストURLからの相対パスとは異なる位置を期待している場合，指定したパスの変更が必要です。

影響を受けるもの

welcomeファイルから他のページへ遷移する場合に，期待したページへ遷移できない場合があります。

10.3.4　11-20への移行とV9互換モードについて

11-20には「推奨モード」と「V9互換モード」の2つのモードがあり，モードによって使用できる機能が異なります。そのため，11-20に移行する場合は，使用したい機能を基に，どちらのモードを使用するかを検討してください。

推奨モード

推奨モードでは，11-00以降の新機能を使用できます。11-00以降の新機能については，この項の「・11-00以降の主な機能」を参照してください。

また，09-87から11-20に移行し，「推奨モード」を使用するユーザ向けに，09-87から11-20の変更点を説明する移行ガイドを提供しています。移行ガイドについては，「12.　アプリケーションサーバ09-87から11-20への移行」を参照してください。

V9互換モード

V9互換モードでは，アプリケーションサーバが09-87相当の動作になります。11-00ではJava EE 7の新機能に対応するために大幅な機能の変更をしています。11-20の新機能を使用しないで，09-87以前との互換性を重視するユーザは「V9互換モード」を使用してください。

V9互換モードでは，09-87以前との互換性がある機能を使用できます。互換性がある機能の詳細は，この項の「・旧バージョンとの互換のための機能」を参照してください。

なお，「V9互換モード」の詳細は，マニュアル「アプリケーションサーバ 機能解説 互換編」の「第2編　V9互換モード」を参照してください。

なお，11-00以降で非サポートとなった機能は，推奨モードとV9互換モードのどちらでも使用できません。詳細は，この項の「・11-00以降で非サポートとなった機能」を参照してください。

11-00以降の主な機能，旧バージョンとの互換のための機能，および11-00以降で非サポートとなった機能について説明します。

11-00以降の主な機能

11-00以降の主な機能を次の表に示します。この表に記載している機能は，推奨モードでは使用できますが，V9互換モードでは使用できません。

表10‒14　11-00以降の主な機能

分類

機能名

マニュアル参照先

Webコンテナ

JSF 2.3対応

アプリケーションサーバ 機能解説　基本・開発編(Webコンテナ)

「3.　JSFおよびJSTLの利用」

JAX-RS 2.1対応

アプリケーションサーバ 機能解説　基本・開発編(Webコンテナ)

「4.　JAX-RS 2.1の利用」

WebSocket 1.1対応

アプリケーションサーバ 機能解説　基本・開発編(Webコンテナ)

「5.　WebSocket」

NIO HTTPサーバ機能

アプリケーションサーバ 機能解説　基本・開発編(Webコンテナ)

「7.　NIO HTTPサーバ」

非同期サーブレット対応

アプリケーションサーバ 機能解説　基本・開発編(Webコンテナ)

「8.　サーブレットおよびJSPの実装」

Servlet 4.0対応

JSP 2.3対応

コンテナ共通機能

JPA 2.2対応

アプリケーションサーバ 機能解説　基本・開発編(コンテナ共通機能)

「6.　JPA 2.2の利用」

CDI 2.0対応

アプリケーションサーバ 機能解説　基本・開発編(コンテナ共通機能)

「9.　アプリケーションサーバでのCDIの利用」

Bean Validation 2.0対応

アプリケーションサーバ 機能解説　基本・開発編(コンテナ共通機能)

「10.　アプリケーションサーバでのBean Validationの利用」

Java Batch 1.0対応

アプリケーションサーバ 機能解説　基本・開発編(コンテナ共通機能)

「11.　Java Batch」

JSON-P 1.1対応

アプリケーションサーバ 機能解説　基本・開発編(コンテナ共通機能)

「12.　JSON-P」

JSON-B 1.0対応

アプリケーションサーバ 機能解説　基本・開発編(コンテナ共通機能)

「13.　JSON-B」

Concurrency Utilities for Java EE 1.0対応

アプリケーションサーバ 機能解説　基本・開発編(コンテナ共通機能)

「14.　Concurrency Utilities」

Interceptors 1.2対応

アプリケーションサーバ 機能解説　基本・開発編(コンテナ共通機能)

「15.　Interceptors」

旧バージョンとの互換のための機能

旧バージョンとの互換のための機能を次の表に示します。この表に記載している機能は，推奨モードとV9互換モードで使用可否が異なります。

表10‒15　旧バージョンとの互換のための機能

分類

機能名

V9互換モードでの使用可否

推奨モードでの使用可否

推奨モードでの代替機能

Webコンテナ

HTTPレスポンス圧縮機能

○

×

Webアプリケーション側でFilterとして実装してください。

Webサーバ連携機能（リダイレクタ機能）

○

×

HTTP Serverのリバースプロキシ機能と，J2EEサーバのNIO HTTPサーバ機能を組み合わせることで代替できます。

ただし，次の機能は代替できません。

ラウンドロビン方式によるリクエストの振り分け

POSTデータサイズでのリクエストの振り分け

Webコンテナへのゲートウェイ情報の通知

詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発機能編(Webコンテナ)」 の「7.　NIO HTTPサーバ」，およびマニュアル「HTTP Server」を参照してください。

インプロセスHTTPサーバ機能

○

×

NIO HTTPサーバ機能で代替できます。

ただし，次の機能は代替できません。

リダイレクトによるリクエストの振り分け

有効なHTTPメソッドの制限によるアクセス制御

エラーページのカスタマイズ

Webコンテナへのゲートウェイ情報の通知

詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発機能編(Webコンテナ)」の「7.　NIO HTTPサーバ」を参照してください。

コンテナ共通機能

JPAコンテナ機能（11-00の場合）

○

×

次のAPIを使用してアプリケーション管理の永続化ユニットを取得してください。

javax.persistence.PersistenceクラスのcreateEntityManagerFactoryメソッド

詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発機能編(コンテナ共通機能)」の「6.　JPA 2.2の利用」を参照してください。

JPAコンテナ機能

（11-10以降の場合）

○

○

−

CJPAプロバイダ機能

○

×

JPA 2.2対応のJPAプロバイダで代替できます。

詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発機能編(コンテナ共通機能)」の「6.　JPA 2.2の利用」を参照してください。

クラスタコネクションプール機能

△

△

Oracle RACの機能で代替できます。

Webサービス機能

JAX-RS機能（JAX-RS 1.1）

○

×

JAX-RS 2.1で代替できます。

詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発機能編(Webコンテナ)」の「4.　JAX-RS 2.1の利用」を参照してください。

（凡例）

○：使用できます。

△：使用できますが，互換機能のため推奨しません。

×：使用できません。

11-00以降で非サポートとなった機能

Version 11-00以降で非サポートとなった機能を次の表に示します。この表に記載している機能は，推奨モードとV9互換モードのどちらでも使用できません。

表10‒16　11-00以降で非サポートとなった機能

分類

機能名

代替機能

拡張機能

EADsセッションフェイルオーバー機能

データベースセッションフェイルオーバ機能を使用してください。

詳細は，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「6.　データベースセッションフェイルオーバ機能」を参照してください。

互換機能

ベーシックモード

J2EEサーバを使用してください。

サーブレットエンジンモード (Webコンテナサーバ)

J2EEサーバを使用してください。

簡易Webサーバ機能

NIO HTTPサーバ機能を使用してください。

詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発機能編(Webコンテナ)」の「7.　NIO HTTPサーバ」を参照してください。

EJBクライアントアプリケーションのログのサブディレクトリ専有モード

デフォルトのサブディレクトリ共有モードを使用してください。

メモリセッションフェイルオーバ機能

データベースセッションフェイルオーバ機能を使用してください。

詳細は，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「6.　データベースセッションフェイルオーバ機能」を参照してください。

複数の構築済み実行環境の切り替え

なし

J2EEアプリケーションのテスト機能

なし

JSP1.1仕様およびJSP1.2仕様に準拠したJSPソースのチェック（cjjsp2java）

なし

論理サーバのアプリケーション管理のV7互換モード

なし

セキュリティ管理機能

セッションフェイルオーバ機能を使用したログイン状態の引き継ぎ

データベースセッションフェイルオーバ機能を使用してください。

詳細は，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「6.　データベースセッションフェイルオーバ機能」を参照してください。

コマンド

Management Serverで使用するコマンド（旧バージョンとの互換用のコマンド）

cmx_define_applicationコマンド

cmx_deploy_applicationコマンド

cmx_register_applicationコマンド

cmx_start_applicationコマンド

cmx_stop_applicationコマンド

cmx_undefine_applicationコマンド

cmx_undeploy_applicationコマンド

cmx_unregister_applicationコマンド

cmx_define_resourceコマンド

cmx_deploy_resourceコマンド

cmx_register_resourceコマンド

cmx_start_resourceコマンド

cmx_stop_resourceコマンド

cmx_undefine_resourceコマンド

cmx_undeploy_resourceコマンド

cmx_unregister_resourceコマンド

cmx_add_serverrefコマンド

cmx_delete_serverrefコマンド

J2EEサーバのコマンドを使用してください。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.　J2EEサーバで使用するコマンド」を参照してください。

10.3.5　旧バージョンからVersion 9までの仕様変更の一覧

旧バージョンからVersion 9までの仕様変更を示します。

(1)　Java SEのバージョン

09-87以降で使用されているJava SE 11は，以前のJ2SE 1.4.2，J2SE 5.0，JavaSE 6，Java SE7，Java SE 8，Java SE 9と，一部の機能に互換性がありません。詳細については，JavaSEのドキュメントを参照してください。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

ありません。

(2)　JSPから生成されたサーブレット用コンパイラのバージョン

変更内容

JSPファイルをコンパイルする過程で，中間ファイルとしてサーブレットのJavaソースを生成します。生成されたサーブレットのJavaソースはJavaコンパイラによって，最終的にclassファイルを生成します。このとき使用されるJavaコンパイラのJava言語仕様のバージョンは，製品のバージョンによって異なります。J2EEサーバでは，インストールされているjavacコンパイラのデフォルトバージョンのJava言語仕様に従ってJSPから生成されたサーブレットのソースファイルをコンパイルします。

コンパイルするJava言語仕様のバージョンを次の表に示します。

表10‒17　コンパイルするJava言語仕様のバージョン

アプリケーションサーバのバージョン

JDKのバージョン

コンパイルJava言語仕様バージョン

Version 8

JDK 5.0

J2SE 5.0

JDK 6

Java SE 6

09-00から09-60より前

JDK 6

Java SE 6

09-60から09-70より前

JDK 7

Java SE 7

09-70

JDK 8

Java SE 8

09-80

JDK 9

Java SE 9

09-87

JDK 11

Java SE 11

JSPファイルのスクリプティングにJava SE 8の言語仕様に反したコーディングをしていて，JSPから生成されたサーブレットのソースファイルがコンパイルできない場合，コンパイラのJava言語仕様のバージョンをJ2EEサーバ，またはWebコンテナサーバのユーザプロパティファイルのwebserver.jsp.compile.backcompatキーに移行前と同じ値になるように設定します。

cjjspcコマンドを使用してJSP事前コンパイルを実行する場合は，cjjspcコマンドの-sourceオプションに移行前と同じ値を指定します。

JSPファイル内にスクリプティングを記述していない場合やJSPファイルのスクリプティングがJava SE 8の言語仕様に反していなくてJSPから生成したサーブレットのソースファイルのコンパイルが正常にできる場合，上記の設定は不要です。

互換性を重視したシステムへ移行する場合に必要な作業

移行前のアプリケーションサーバのコンパイルJava言語仕様バージョンに合わせて，J2EEサーバ用のユーザプロパティファイル（usrconf.properties）のwebserver.jsp.compile.backcompatキーに「1.6」「6」「1.7」「7」「1.8」または「8」を設定してください。

cjjspcコマンドを使用してJSP事前コンパイルを実行する場合は，同様に移行前のアプリケーションサーバでのコンパイラが受け付けるソースコードのバージョンに合わせて，cjjspcコマンドの-sourceオプションに1.6,6,1.7,7,1.8または8を設定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

JSPファイルのスクリプティングにJava SE 11の言語仕様に反したコーディングをしている場合，Java SE 11の言語仕様に従うよう，JSPファイルを修正してください。

影響を受けるもの

「10.3.5(1)　Java SEのバージョン」

(3)　POSTリクエストのフォームデータの最大サイズの制限

変更内容

POSTリクエストのフォームデータ（Content-Typeヘッダの値がapplication/x-www-form-urlencodedの場合のPOSTデータ）の最大サイズがデフォルトで2MBに制限されます。更新インストールをした場合，すでにセットアップされているJ2EEサーバには，POSTリクエストのフォームデータの最大サイズを無制限にする設定（webserver.connector.limit.max_post_form_data=-1）が自動的に実施されます。

互換性を重視したシステムへ移行する場合に必要な作業

J2EEサーバ用usrconf.propertiesのwebserver.connector.limit.max_post_form_dataプロパティに-1（無制限）を指定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

J2EEサーバ用usrconf.propertiesのwebserver.connector.limit.max_post_form_dataプロパティに適切な上限値を指定してください。

影響を受けるもの

アプリケーションがPOSTリクエストを行う際，2MB以上のフォームデータを送信している場合は実行時エラーになります。

(4)　同一J2EEサーバ内のほかのアプリケーションで動作するEnterprise Beanの呼び出し手順の改善

変更内容

09-00以降では，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に次のプロパティを設定した場合，またはこのプロパティの指定を省略した場合，同一J2EEサーバ内のほかのアプリケーションで動作するEnterprise Beanの呼び出しができます。

パラメタ名

ejbserver.rmi.localinvocation.scope

値

app

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(5)　J2EEアプリケーション起動時およびJSPコンパイル時のJavaプログラムのコンパイル処理

変更内容

バージョンアップに伴い，J2EEサーバの設定ファイルの変更が必要です。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

Javaヒープ使用量が以前のバージョンに比べて約40MB増加します。

(6)　論理サーバの環境変数定義の再設定

変更内容

バージョンアップに伴い，adminagent.xmlファイルの変更が必要です。

互換性を重視したシステムへ移行する場合に必要な作業

Management Serverを使用している場合，運用管理ポータルの「論理サーバの起動／停止」で使用する環境変数を設定していたときは，新たにインストールされたadminagent.xmlファイルに環境変数を再設定する必要があります。adminagent.xmlは次のディレクトリに格納されています。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config

UNIXの場合

/opt/Cosminexus/manager/config

adminagent.xmlでの環境変数の設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.4　adminagent.xml（運用管理エージェント設定ファイル）」を参照してください。

注意事項

adminagent.xmlはインストール時に上書きされ，既存のファイルはadminagent.xml.bakに退避されます。

adminagent.xmlはバージョンアップによって変更されている可能性があります。adminagent.xmlを編集して運用している場合は，新たにインストールされたファイルに，以前に編集した項目を再編集してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

移行で実施する作業を行わないと，「論理サーバの起動／停止」で使用する環境変数の設定が引き継がれません。

(7)　JP1イベントメッセージマッピングファイルの再設定

変更内容

バージョンアップに伴い，JP1イベントメッセージマッピングファイルの変更が必要です。

互換性を重視したシステムへ移行する場合に必要な作業

次に示すJP1イベントメッセージマッピングファイルは，更新インストール時に上書きされないで旧バージョンのファイルが引き継がれます。

Management Server用メッセージマッピングファイル

mserver.jp1event.system.mapping.properties

J2EEサーバ共通用メッセージマッピングファイル

manager.jp1event.system.mapping.properties

J2EEサーバ個別用メッセージマッピングファイル

manager.<論理サーバ名>.jp1event.system.mapping.properties

JP1イベントメッセージマッピングファイルをカスタマイズしないで使用していた場合

次の場所に格納されているManagement Server用メッセージマッピングファイルとJ2EEサーバ共通用メッセージマッピングファイルを修正しないで，旧バージョンのファイルに上書きしてください。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config¥templates

UNIXの場合

/opt/Cosminexus/manager/config/templates

JP1イベントメッセージマッピングファイルをカスタマイズして使用していた場合

次の場所に格納されているManagement Server用メッセージマッピングファイルとJ2EEサーバ共通用メッセージマッピングファイルをコピーして，旧バージョンのときと同様にカスタマイズした上で，旧バージョンのファイルに上書きしてください。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config¥templates

UNIXの場合

/opt/Cosminexus/manager/config/templates

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

移行で実施する作業を行わないと，新しいバージョンで追加されたメッセージに対するJP1イベントが発行されません。

(8)　snapshotログ収集先対象リストファイルの再設定

変更内容

バージョンアップに伴い，snapshotログ収集先対象リストの変更が必要です。

互換性を重視したシステムへ移行する場合に必要な作業

snapshotログを収集する場合に，snapshotログ収集先対象リストファイル（snapshotlog.conf，snapshotlog.2.conf，およびsnapshotlog.param.conf）を編集して使用していたときは，新たにインストールされたsnapshotログ収集先対象リストファイルでsnapshotログの収集先を再設定する必要があります。

snapshotログ収集先対象リストファイルは，次のディレクトリに格納されています。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config

UNIXの場合

/opt/Cosminexus/manager/config

snapshotログ収集先対象リストファイルの設定については，「3.3.3(3)　snapshotログの収集先のカスタマイズ」を参照してください。

注意事項

更新インストールの場合，snapshotログ収集先対象リストファイルはバージョンアップ時に上書きされ，既存のファイルはsnapshotlog.conf.bak，snapshotlog.2.conf.bak，およびsnapshotlog.param.conf.bakとして退避されます。

バージョンアップによってsnapshotログの収集先が変更されることがあります。snapshotログの収集対象を編集して運用している場合は，新たにインストールされたファイルに，以前に編集した項目を再編集してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

移行で実施する作業を行わないと，バージョンアップ前のsnapshotログ収集先対象リストファイルに対するユーザ変更が失われます。

(9)　OutOfMemoryError発生時の運用管理エージェントの動作変更

変更内容

OutOfMemoryError発生時に保守調査用ログを保護したり，不安定な状態で運用管理エージェントが動作することを防いだりするため，08-50から運用管理エージェントの動作が変更になります。

08-50より前の動作

OutOfMemoryErrorが発生しても処理を続行する。

08-50以降の動作

OutOfMemoryErrorが発生したら強制終了する。

旧バージョンと同等の動作にするには，adminagentuser.cfgに次のオプションを追加してください。

add.jvm.arg=-XX:-HitachiOutOfMemoryAbort

互換性を重視したシステムへ移行する場合に必要な作業

運用管理エージェント用オプション定義ファイル（adminagentuser.cfg）でadd.jvm.arg=-XX:-HitachiOutOfMemoryAbortを指定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

デフォルト値（OutOfMemoryError発生時に強制終了）を使用してください。

影響を受けるもの

旧バージョンと同等の動作にする作業を行わないと，OutOfMemoryErrorが発生したら運用管理エージェントが強制終了されます。

(10)　負荷分散機のCookieスイッチング機能のモード変更

変更内容

08-53から，負荷分散機のCookieスイッチング機能で使用しているスイッチングモードが，ハッシュモードからインサートモードへ変更されます。

互換性を重視したシステムへ移行する場合に必要な作業

08-53より前に，Smart Composer機能でBIG-IP v9のCookieスイッチング機能を使用してシステムを構築している場合は，cmx_delete_systemコマンドを実行してシステムを削除してから，再度，cmx_build_systemコマンドを実行してシステムを構築してください。

また，08-53以降では，簡易構築定義ファイルの<server-id-rule>タグが非推奨となります。<server-id-rule>タグに値を設定しても無視されます。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

移行で実施する作業を行わないと，HTTPリクエストが特定のWebサーバに割り振られなくなる場合があります。

(11)　運用管理ポータルで操作対象とするリソースアダプタの変更

変更内容

08-70から，運用管理ポータルで操作対象とするリソースアダプタが，デプロイしたリソースアダプタに変更されます。運用管理ポータルでリソースアダプタを削除しても，そのデプロイ元のリソースは削除されません。

互換性を重視したシステムへ移行する場合に必要な作業

更新インストールした環境ではデプロイ元のリソースが残ります。この場合，サーバ管理コマンド（cjdeleteresコマンド）でデプロイ元のリソースを削除してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

移行で実施する作業を行わないと，デプロイ前リソースと同名のリソースアダプタのデプロイができません。

(12)　Smart Composer機能でcmx_build_system（-sオプション指定）コマンド実行時の設定情報の配布に関する動作変更

変更内容

09-00以降，Smart Composer機能で-sオプションを指定してcmx_build_systemコマンドを実行した場合，各ホストのサーバに設定情報が配布されているかどうかに関係なく，常に設定情報を配布するように動作が変更になります。

09-00より前の動作

各ホストのサーバに設定情報が配布されていない論理サーバの設定情報を配布する。

09-00以降の動作

各ホストのサーバに設定情報が配布されているかどうかに関係なく，常に論理サーバの設定情報を配布する。

互換性を重視したシステムへ移行する場合に必要な作業

旧バージョンと同等の動作にするには，-sオプションを指定してcmx_build_systemコマンドを実行する際には，-sdオプションを指定して実行してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

移行で実施する作業を行わないと各ホストのサーバに設定情報が配布されているかどうかに関係なく，常に論理サーバの設定情報が配布されるようになります。

(13)　運用管理エージェントおよびManagement Serverの自動起動の設定方法変更（UNIXの場合）

変更内容

UNIXの場合，09-00以降では，運用管理エージェントおよびManagement Serverの自動起動の設定方法が変更になります。

09-00より前に運用管理エージェントまたはManagement Serverで自動起動を設定している場合に，09-00以降の設定方法を使用するときは，次の手順で自動起動の設定方法を変更してください。なお，09-00より前の設定のまま自動起動を運用しても問題はありません。09-00より前の設定のまま自動起動を運用する場合は，09-00以降の自動起動の設定は有効にしないでください。

運用管理エージェントの自動起動の設定変更手順

09-00より前の自動起動の設定を解除します。

OSごとに説明します。

AIXの場合

rmitabコマンドを使用して，起動スクリプト（/opt/Cosminexus/manager/bin/adminagentctl start）を/etc/inittabファイルから削除します。

（指定例）

# rmitab adminagentctl

AIX以外の場合

rmコマンドを使用して，自動起動の設定時に作成したシンボリックリンクを削除します。

（指定例）

# rm /sbin/rc2.d/S800AdminAgent

mngautorunコマンドを使用して，運用管理エージェントの自動起動を設定します。

（指定例）

mngautorun once agent

Management Serverの自動起動の設定変更手順

09-00より前の自動起動の設定を解除します。

OSごとに説明します。

AIXの場合

rmitabコマンドを使用して，起動スクリプト（/opt/Cosminexus/manager/bin/mngsvrctl start）を，/etc/inittabファイルから削除します。

（指定例）

# rmitab mngsvrctl

AIX以外の場合

rmコマンドを使用して，自動起動の設定時に作成したシンボリックリンクを削除します。

（指定例）

# rm sbin/rc2.d/S900MngSvr

mngautorunコマンドを使用して，Management Serverの自動起動を設定します。

（指定例）

mngautorun once server

互換性を重視したシステムへ移行する場合に必要な作業

mngautorunコマンドを使用して自動起動設定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

mngautorunコマンドによる運用管理エージェントおよびManagement Server の自動起動を有効した場合，09-00より前の自動起動の設定とmngautorunコマンドによる設定が有効となってしまうため，マシン起動時にどちらかの自動起動処理がエラーとなります。

(14)　Management Serverのプロセス構成の変更

変更内容

09-00からManagement Serverのプロセス構成が変更になります。

09-00より前のプロセス構成

mngsvrctlプロセスおよびcjstartwebプロセス

09-00以降のプロセス構成

cjstartsvプロセス

Management Serverのプロセスや，Management Serverの起動時に出力されるメッセージを監視する運用をしている場合は，監視対象を変更する必要があります。

互換性を重視したシステムへ移行する場合に必要な作業

スクリプトファイルなどでmngsvrctlプロセスを監視している場合は，cjstartsvプロセスを監視するように変更してください。

Management Serverの起動失敗時にコンソールに出力されていたKEOS10112-Eメッセージが出力されないことがあります。mngsvrctlコマンドの戻り値が0以外の場合は，「<Managerのログ出力ディレクトリ>¥cjmessage[n].log」，または「<Managerのログ出力ディレクトリ>/cjmessage[n].log」を参照してエラーの内容を確認してください。

また，Management Serverの起動成功時にコンソールに出力されていたKEOS10110-Iメッセージが出力されません。Management Serverが起動されたかどうかは，次のどちらかの方法で確認してください。

KEOS10019-Iメッセージが，次に示すManagement Serverのログに出力されているかどうかを確認する。

Windowsの場合：<Managerのログ出力ディレクトリ>¥mngsvr[n].logまたは<Managerのログ出力ディレクトリ>¥message¥mngmessage[n].log

UNIXの場合：<Managerのログ出力ディレクトリ>/mngsvr[n].logまたは<Managerのログ出力ディレクトリ>/message/mngmessage[n].log

mngsvrutilコマンドのサブコマンドcheckを使用して，Management Serverが稼働しているかどうかを確認する。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

監視システムなどでManagement Serverの稼働監視を行っている場合，不当に異常を検知したり，異常を検知できなかったりする場合があります。

(15)　cmx_list_statusコマンドによるサービスユニットの稼働状況のステータス変更

変更内容

09-00から，Smart Composer機能でcmx_list_statusコマンド実行時に取得されるサービスユニットの稼働状況のステータスが，「unknown」から「no working」と「no ready」に変更となります。

互換性を重視したシステムへ移行する場合に必要な作業

監視システムなどで「unknown」を参照している場合は，「no working」または「no ready」のどちらかを参照するように変更してください。「no working」および「no ready」については，マニュアル「アプリケーションサーバリファレンス コマンド編」の「cmx_list_status（サービスユニット状況の表示）」を参照してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

監視システムなどでサービスユニットの稼働状況を監視している場合，不当に異常を検知したり，異常を検知できなかったりする場合があります。

(16)　Management Serverの機能を使用した明示管理ヒープ機能の自動配置設定ファイルの設定方法の追加

変更内容

09-00から，明示管理ヒープ機能の自動配置設定ファイルを，Management Serverの機能を使用して設定できます。

互換性を重視したシステムへ移行する場合に必要な作業

09-00より前に設定した明示管理ヒープ機能の自動配置設定ファイルを使用する場合は次の作業を実施してください。

明示管理ヒープ機能の自動配置設定ファイルのリネームなどを実施し，<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/＜実サーバ名＞/auto_explicit_memory.cfgに配置します。

明示管理ヒープ機能の自動配置設定ファイルを使用している論理J2EEサーバのusrconf.cfg内の-XX:HitachiAutoExplicitMemoryFileオプションに，<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/＜実サーバ名＞/auto_explicit_memory.cfgを指定します。

運用管理ポータルにログインして，［運用管理ポータル］画面で「論理サーバの環境設定」をクリックします。

運用管理ドメインに構成定義された既存の論理J2EEサーバに対して，［サーバの設定読み込み］画面で「接続先ホストから設定を読み込みます」をチェックして［読み込み］ボタンをクリックします。

論理J2EEサーバの定義する画面で［適用］ボタンをクリックしたあと，［設定情報の配布］画面で再配布します。

参考

mngsvrutilコマンドでも接続先ホストからの読み込みを実行できます。mngsvrutilコマンドで実行する場合は，サブコマンド「reload」で引数に「env」を指定します。mngsvrutilコマンドについては，マニュアル「アプリケーションサーバリファレンス コマンド編」の「7.3　mngsvrutilコマンドのサブコマンドの詳細」を参照してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

移行で実施する作業を行わないと明示管理ヒープ機能の自動配置設定ファイルの設定は従来どおり手動での運用となります。

(17)　Management Serverの移行

変更内容

09-00以降，Management Serverが使用するWebコンテナが変更されます。

互換性を重視したシステムへ移行する場合に必要な作業

アプリケーションサーバ Version 8から移行する場合，Management Serverの移行コマンド（mngenvupdate）を実行します。移行方法については，「10.9　Management Serverの移行コマンドの実行」を参照してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

移行で実施する作業を行わないと，バージョンアップ前のManagement Server用オプション定義ファイル（mserver.cfg）への設定が引き継がれない場合があります。アプリケーション管理機能・統合ユーザ管理機能を使用していた場合は正常に動作しなくなります。

また，新規インストールの場合，Management Server用オプション定義ファイル（mserver.cfg）に指定できるキーがWebコンテナサーバ用オプション定義ファイル（usrconf.cfg）からJ2EEサーバ用オプション定義ファイル（usrconf.cfg）へ変更されたことを考慮して，mserver.cfgを設定する必要があります。

(18)　WebPasswordJDBCLoginModule使用時のDB接続設定の見直し

変更内容

DABrokerを使用した接続が，サポート外になりました。08-70以降，データベース製品が提供するJDBCドライバを使用してください。なお，HiRDBの場合はType4ドライバを，Oracleの場合はThinドライバを使用してください。

互換性を重視したシステムへ移行する場合に必要な作業

J2EEサーバ用usrconf.cfgのadd.class.pathキーに，JDBCドライバの絶対パスを追加してください。また，JDBCドライバのマニュアルに従い，ua.confのcom.cosminexus.admin.auth.jdbc.driverパラメタにドライバのクラス名，com.cosminexus.admin.auth.jdbc.conn.urlパラメタに接続URLを指定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

移行で実施する作業を行わないとWebPasswordJDBCLoginModuleが使用できません。

(19)　証明書のインポート

変更内容

08-50以降では，cacerts証明書ファイルを同梱していません。証明書が必要な場合は，個別に入手してインポートする必要があります。

インポート手順の詳細は，次に示すJava SEのドキュメントを参照してください。

Windowsの場合

http://docs.oracle.com/javase/jp/6/technotes/tools/windows/keytool.html

UNIX（Linux，AIX）の場合

http://docs.oracle.com/javase/jp/6/technotes/tools/solaris/keytool.html

互換性を重視したシステムへ移行する場合に必要な作業

必要な証明書を入手してインポートしてください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

「10.3.5(1)　Java SEのバージョン」

(20)　DBConnector_SQLServer_CP.rarの非サポート

変更内容

09-00以降では08-70以前の「DBConnector_SQLServer_CP.rar」が非サポートになります。

「DBConnector_SQLServer2005_CP.rar」は08-70以前の「DBConnector_SQLServer_CP.rar」と互換性がないため，cjrarupdateコマンドによる自動での移行処理はできません。このため，手動で08-70以前の「DBConnector_SQLServer_CP.rar」の削除，「DBConnector_SQLServer2005_CP.rar」のインポートおよびプロパティ設定を実施する必要があります。

互換性を重視したシステムへ移行する場合に必要な作業

08-70以前の「DBConnector_SQLServer_CP.rar」の削除，「DBConnector_SQLServer2005_CP.rar」のインポートおよびプロパティ設定※を実施してください。

注※　08-70以前と09-50以降の「DBConnector_SQLServer_CP.rar」では一部設定できるプロパティが異なります。09-50以降で設定できるプロパティについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.　リソースの設定で使用する属性ファイル」を参照してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(21)　DBConnector_SQLServer2005_CP.rarの名称変更

変更内容

09-00以前の「DBConnector_SQLServer2005_CP.rar」は，09-50以降では「DBConnector_SQLServer_CP.rar」に名称が変更になります。09-50以降の「DBConnector_SQLServer_CP.rar」は08-70以前の「DBConnector_SQLServer_CP.rar」と互換性がないため，cjrarupdateコマンドによる自動での移行処理はできません。このため，手動で08-70以前の「DBConnector_SQLServer_CP.rar」の削除，09-50以降の「DBConnector_SQLServer_CP.rar」のインポートおよびプロパティ設定を実施する必要があります。

互換性を重視したシステムへ移行する場合に必要な作業

08-70以前の「DBConnector_SQLServer_CP.rar」の削除，09-50以降の「DBConnector_SQLServer_CP.rar」のインポートおよびプロパティ設定※を実施してください。

注※　08-70以前と09-50以降の「DBConnector_SQLServer_CP.rar」では一部設定できるプロパティが異なります。09-50以降で設定できるプロパティについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.　リソースの設定で使用する属性ファイル」を参照してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(22)　PRFトレースバックアップの設定変更

変更内容

09-00以降は，PRFデーモンの起動時，および停止時にPRFトレースをバックアップしなくなります。

互換性を重視したシステムへ移行する場合に必要な作業

09-00より前のバージョンのようにPRFデーモンをバックアップするには，cprfstartコマンドに-PrfNoBackUp 0オプションを指定してください。詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cprfstart（PRFデーモンの開始）」を参照してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(23)　javax.servlet.http.HttpServletRequestインタフェースのgetSessionメソッドでスローされる例外の変更

変更内容

web.xmlに指定したエラーページ内で，データベースセッションフェイルオーバ機能の抑止によってデータベースセッションフェイルオーバ機能が無効となったリクエストに対して，javax.servlet.http.HttpServletRequestインタフェースのgetSession()メソッド，またはgetSession(boolean create)メソッドを呼び出した時にスローされる例外は，バージョンごとに異なります。バージョンごとにスローされる例外を次に示します。

08-53以前

com.hitachi.software.web.dbsfo.DatabaseAccessException

08-70以降

com.hitachi.software.web.dbsfo.SessionOperationException

互換性を重視したシステムへ移行する場合に必要な作業

08-70以降で08-53以前と同じ例外をスローさせる場合は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に次のパラメタを設定する必要があります。

パラメタ名

webserver.dbsfo.exception_type_backcompat

値

true

推奨機能を使用したシステムへ移行する場合に必要な作業

業務アプリケーションでキャッチする例外をcom.hitachi.software.web.dbsfo.DatabaseAccessExceptionからcom.hitachi.software.web.dbsfo.SessionOperationExceptionへ変更してください。

影響を受けるもの

なし。

(24)　アプリケーションサーバで実行できるアプリケーションの構成の変更

変更内容

09-00以降では，J2EEアプリケーションの構成として，JavaEE 6.0のapplication.xmlと，EJB 3.1のejb-jar.xmlをサポートしました。

そのため，DDを省略した場合に適用されるバージョンが，次のとおり変更されます。

application.xmlを省略したJ2EEアプリケーションは，JavaEE 6と認識されます。

application.xmlを省略したJ2EEアプリケーションに含まれる，ejb-jar.xmlを省略したEJBコンポーネントはEJB 3.1と認識されます。

互換性を重視したシステムへ移行する場合に必要な作業

ejb-jar.xmlを省略したEJBコンポーネントをEJB 3.0として扱いたい場合は，JavaEE 5仕様に準じたapplication.xmlをJ2EEアプリケーションに含めるか，08-70以前でエクスポートした実行時情報付きのJ2EEアプリケーションをインポートしてください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(25)　アプリケーションサーバで実行できるWebアプリケーションの構成の変更

変更内容

09-00以降では，J2EEアプリケーションの構成として，Servlet 3.0のweb.xmlをサポートしました。

そのため，application.xmlを省略したJ2EEアプリケーションに含まれる，web.xmlを省略したWebアプリケーションはServlet 3.0と認識されます。

互換性を重視したシステムへ移行する場合に必要な作業

web.xmlを省略したWebアプリケーションをServlet 2.5として扱いたい場合は，JavaEE 5仕様に準じたapplication.xmlをJ2EEアプリケーションに含めるか，08-70以前でエクスポートした実行時情報付きのJ2EEアプリケーションをインポートしてください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(26)　Portable Global JNDI対応

変更内容

09-00以降では，Java EE 6の新機能であるPortable Global JNDIをサポートします。そのため，アプリケーションの開始時に各アプリケーションやアプリケーション内の各モジュールに対して，Portable Global JNDI名として使用する標準アプリケーション名（application-name）と標準モジュール名（module-name）が割り当てられ，ネーミングサービスに登録されます。また，EJBのリファレンスなど標準仕様でPortable Global JNDI名が決まっているものに対しても，自動的にPortable Global JNDI名でリソースが登録されます。

09-00以降でPortable Global JNDI名の登録機能が有効になっている場合，08-70以前の既存のアプリケーションで，標準アプリケーション名，標準モジュール名，Enterprise Bean名が重複する場合や，Portable Global JNDI名として使用できない文字が含まれている場合は，KDJE477xx-Wが出力される場合があります。KDJE477xx-Wが出力されていてもアプリケーションの開始は続行されますので，Portable Global JNDI名を使用していないアプリケーションの場合は問題ありません。

J2EEサーバ全体でPortable Global JNDI名の登録機能を無効にしたい場合は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に次のプロパティを設定する必要があります。

パラメタ名

ejbserver.jndi.global.enabled

値

false

更新インストール時，すでにセットアップされているJ2EEサーバに対しては，このプロパティが自動的に設定されます。

互換性を重視したシステムへ移行する場合に必要な作業

J2EEサーバ用usrconf.propertiesのejbserver.jndi.global.enabledプロパティにfalseを指定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

Portable Global JNDI機能を使ってアプリケーションを開発する場合は，J2EEサーバ用usrconf.propertiesのejbserver.jndi.global.enabledプロパティをデフォルト値（有効）で使用してください。アプリケーション開始時に警告メッセージが出力される場合は，メッセージに従い名前の重複を解消してください。

使わない場合はfalseを指定してください。

影響を受けるもの

互換機能を利用した場合は業務アプリケーション，およびユーザ運用への影響はありませんが，Portable Global JNDI機能を使ったアプリケーションをエンハンスできません。推奨機能を利用した場合，既存の業務アプリケーションが正常に動作しなくなることがあります。

(27)　TP1インバウンド連携機能でのコネクション保持のサポート

変更内容

08-53以降のTP1インバウンド連携機能では，OpenTP1とのコネクションを保持できるようになりました。

互換性を重視したシステムへ移行する場合に必要な作業

TP1インバウンドアダプタで使用するConnector属性ファイルのrpc_close_after_sendプロパティに"true"を指定して，OpenTP1のrpc_close_after_send句に"Y"を指定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

TP1インバウンドアダプタで使用するConnector属性ファイルのrpc_close_after_sendプロパティに"false"を指定して，OpenTP1のrpc_close_after_send句を削除してください。

影響を受けるもの

推奨機能を使用することで，コネクションの接続と切断に伴うボトルネックを削減でき，通信効率を向上できます。

(28)　TP1インバウンド連携機能での最大同時接続数のデフォルト値の変更

変更内容

08-53以降のTP1インバウンド連携機能では，RPC受信コネクションの最大同時接続数（Connector属性ファイルのmax_connectionsプロパティ）のデフォルト値が10から64に変更になりました。

互換性を重視したシステムへ移行する場合に必要な作業

デフォルト値（10）を使用している場合，移行後，設定値として10を設定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

最大同時接続数が64になります。関連機能の最大同時接続数を見直してください。

影響を受けるもの

なし

(29)　TP1インバウンド連携機能で使用するスレッド数，ファイルディスクリプタ数，ポート番号の変更

変更内容

08-53以降のTP1インバウンド連携アダプタでは，使用するスレッド数，ファイルディスクリプタ数，およびポート番号が08-50と異なります。08-50から08-53以降のバージョンに移行する場合は，再度リソースを見積もり直してください。

互換性を重視したシステムへ移行する場合に必要な作業

再度，リソース見積もりを行ってください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし

(30)　データベースセッションフェイルオーバ機能での完全性保障モードの変更

変更内容

08-70以降のデータベースセッションフェイルオーバ機能では，完全性保障モードを無効にする機能をサポートしました。完全性保障モードを無効にすると，同一セッションIDを持つリクエスト処理を同時に実行できるようになります。

08-53以前は，完全性保障モードは常に有効でしたが，08-70以降ではデフォルトで無効になります。

互換性を重視したシステムへ移行する場合に必要な作業

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に次のプロパティを設定する必要があります。

パラメタ名

webserver.dbsfo.integrity_mode.enabled

値

true

推奨機能を使用したシステムへ移行する場合に必要な作業

現状のシステムが，完全性保証モード「無効」が適用可能か確認してください。「無効」は，冗長化された複数のJ2EEサーバから同じセッションIDのグローバルセッション情報を同時に更新するような処理が発生しないことを前提としています。

「無効」への移行が可能な場合，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に次のプロパティを設定してください。

パラメタ名

webserver.dbsfo.integrity_mode.enabled

値

false

影響を受けるもの

なし。

(31)　TP1インバウンド連携機能の同期点待ち受けポートの追加

変更内容

08-53以降のTP1インバウンド連携機能では，同期点待ち受けポートが追加になりました。デフォルトは23900です。

互換性を重視したシステムへ移行する場合に必要な作業

別の機能で23900を使用している場合，同期点待ち受けポートのポート番号を変更してください。また，複数のTP1インバウンドアダプタを使用している場合は，cjrarupdateコマンド実行後に，同期点待ち受けポートにそれぞれ別のポート番号を設定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(32)　データベースセッションフェイルオーバ機能のデータベーステーブルの再作成

変更内容

08-70以降のデータベースセッションフェイルオーバ機能では，データベースのアプリケーション情報テーブルとセッション情報格納テーブルのテーブル構成が08-53以前のテーブル構成と異なります。

互換性を重視したシステムへ移行する場合に必要な作業

08-70以降のバージョンに移行する場合は，08-70以降のデータベースセッションフェイルオーバ機能が提供するテーブル削除用SQLを使用してテーブルを削除してから，テーブル作成用SQLを使用してテーブルを作成してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(33)　データベースセッションフェイルオーバ機能でのDB Connectorに設定するステートメントプールの数の変更

変更内容

08-70以降のデータベースセッションフェイルオーバ機能では，DB Connectorに設定するステートメントプールの数が変更となります。Connector属性ファイルに次のプロパティを設定してください。

プロパティ名

PreparedStatementPoolSize

値

30×J2EEサーバ内のデータベースセッションフェイルオーバ機能を使用するWebアプリケーション数

互換性を重視したシステムへ移行する場合に必要な作業

Connector属性ファイルに次のプロパティを設定してください。

プロパティ名

PreparedStatementPoolSize

値

30×J2EEサーバ内のデータベースセッションフェイルオーバ機能を使用するWebアプリケーション数

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(34)　@EJBアノテーションのmappedName属性の仕様変更

変更内容

08-70以前では，@EJBアノテーションのmappedName属性は無視されていましたが，09-00以降では，mappedName属性へのGlobalJNDI名（Portable Global JNDI名，EJBの別名，物理名）の記述をサポートします。

互換性を重視したシステムへ移行する場合に必要な作業

08-70以前で動作していたアプリケーションで，mappedName属性の指定がある場合，mappedName属性を削除してください。mappedName属性が残っていると，09-00以降に移行したことで，従来無視されていたmappedName属性の値が有効になり，アプリケーションの動作が変わってしまうおそれがあります。

推奨機能を使用したシステムへ移行する場合に必要な作業

09-00以降の@EJBアノテーションのmappedName属性には，DI対象のEJBのPortable Global JNDI名，またはEJBの別名を指定できます。

影響を受けるもの

ユーザアプリケーション（@EJBのmappedName属性を指定していた場合だけ影響します）。

(35)　Microsoft IIS 7.0，7.5の設定変更

変更内容

09-00以降のリダイレクタは，64bitアプリケーションになりました。

互換性を重視したシステムへ移行する場合に必要な作業

Microsoft IIS 7.0またはMicrosoft IIS 7.5を使用してWebサーバ連携する場合，Microsoft IISのアプリケーションプールの詳細設定で[32bitアプリケーションの有効化]にfalseを指定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(36)　明示管理ヒープ機能の自動配置機能で使用する設定ファイルの内容変更

変更内容

09-50以降では，明示管理ヒープ機能の自動配置機能で使用する設定ファイル（自動配置設定ファイル）で，Hibernateに関する設定項目が削除され，初期設定時の内容が変更になりました。

互換性を重視したシステムへ移行する場合に必要な作業

自動配置設定ファイルに次の内容を記述してください。記述方法については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「7.13.2　自動配置設定ファイルを使った明示管理ヒープ機能の使用」を参照してください。

org.hibernate.cfg.Configuration.buildSessionFactory(), org.hibernate.impl.SessionFactoryImpl

推奨機能を使用したシステムへ移行する場合に必要な作業

Javaヒープ領域およびExplicitヒープ領域のメモリサイズを再チューニングしてください。チューニング方法については，マニュアル「アプリケーションサーバ システム設計ガイド」の「7.　JavaVMのメモリチューニング」を参照してください。

影響を受けるもの

アプリケーションサーバとHibernateの両方を動作させていた場合に，09-50より前から移行すると，Javaヒープ領域およびExplicitヒープ領域の使用サイズが変化することがあります。

(37)　Servlet 3.0を使用したアプリケーションのリロードに関する仕様の変更

変更内容

09-50より前では，Servlet 3.0を使用したアプリケーションで，次に示すメソッドを削除することで設定を解除した場合，リロードの際にその設定が反映されません。

SessionCookieConfig.setName(String name)

SessionCookieConfig.setDomain(String domain)

SessionCookieConfig.setPath(String path)

SessionCookieConfig.setComment(String comment)

SessionCookieConfig.setHttpOnly(boolean httpOnly)

SessionCookieConfig.setSecure(boolean secure)

SessionCookieConfig.setMaxAge(int maxAge)

ServletContext.setSessionTrackingModes(Set<SessionTrackingMode> sessionTrackingModes)

ServletContext.setInitParameter(String name, String value)

09-50以降では，リロードの際に設定が反映されるようになりました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(38)　サーバIDのデフォルト値の変更

変更内容

09-50以降，サーバIDのデフォルト値は64バイト固定です。サーバIDを明示的に指定するには，usrconf.propertiesに次のプロパティを指定してください。

webserver.session.server_id.value

webserver.container.server_id.value

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

互換性を重視したシステムへ移行する場合に必要な作業

サーバIDがデフォルト値の場合，サーバIDを明示的に指定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

サーバIDがデフォルト値の場合，セッションIDの文字列長が増加します。

セッションIDの長さによって問題が起こらないかどうかを確認してください。

(39)　cjimportappコマンドの-aまたは-dオプション実行時の重複ディレクトリチェックの変更

変更内容

cjimportappコマンドで-aまたは-dオプションを指定して実行した際のディレクトリ重複チェックの仕様が，次のとおり変更となります。

09-00以前の場合

cjimportappコマンドで-aまたは-dオプションを指定したディレクトリと同じディレクトリを持つJ2EEアプリケーションがJ2EEサーバ内に存在する場合，KDJE42325-Eを出力してインポートに失敗します。

09-50以降の場合

cjimportappコマンドで-aまたは-dオプションを指定したディレクトリと同じディレクトリを持つJ2EEアプリケーションがJ2EEサーバ内に存在する場合，KDJE42325-Eを出力してインポートに失敗します。

cjimportappコマンドで-aまたは-dオプションを指定したディレクトリの上位ディレクトリを持つJ2EEアプリケーションがJ2EEサーバ内に存在する場合，KDJE42406-Eを出力してインポートに失敗します。

cjimportappコマンドで-aまたは-dオプションを指定したディレクトリの下位ディレクトリを持つJ2EEアプリケーションがJ2EEサーバ内に存在する場合，KDJE42410-Eを出力してインポートに失敗します。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(40)　J2EEアプリケーション開始時のJavaのコンパイルの仕様

変更内容

J2EEアプリケーション開始時のJavaのコンパイルは，javacコマンドではなくJ2EEサーバプロセス内で行われるようになります。

互換性を重視したシステムへ移行する場合に必要な作業

J2EEサーバのヒープサイズの見積りを実施してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(41)　server.policy（J2EEサーバ用セキュリティポリシーファイル）への定義の追加

変更内容

新規インストールした環境へ移行する場合，server.policyに定義を追加する必要があります。

更新インストールの場合は，移行コマンドを実行すると自動で定義が追加されます。

互換性を重視したシステムへ移行する場合に必要な作業

バージョンごとに，追加が必要な定義を次に示します。なお，説明中の括弧内の数字は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.4　server.policy（J2EEサーバ用セキュリティポリシーファイル）」の記述例に関する説明を参照してください。

08-50で追加された定義

// (3)

// Grant all permissions to anything loaded from the

// EJB server itself

grant codeBase "file:${cosminexus.home}/jaxws/lib/*" {

permission java.security.AllPermission;

};

08-53で追加された定義

// (6)

// Grant permissions to resource adapters

grant codeBase "file:${ejbserver.http.root}/ejb/${ejbserver.serverName}/rarjars/-" {

// For Cosminexus SOA FTP Inbound Adapter

permission java.lang.RuntimePermission "getClassLoader";

permission java.lang.RuntimePermission "setContextClassLoader";

permission java.lang.RuntimePermission "accessDeclaredMembers";

};

08-70で追加された定義

// (7)

// Grant permissions to JSP/Servlet

grant codeBase "file:${ejbserver.http.root}/web/${ejbserver.serverName}/-" {

permission javax.security.auth.AuthPermission "createLoginContext.{name}";

permission javax.security.auth.AuthPermission "getSubject";

// (9)

// Grant permissions to custom login modules

//

grant codeBase "file:${cosminexus.home}/manager/modules/-" {

permission java.io.FilePermission "<<ALL FILES>>", "read";

permission javax.security.auth.AuthPermission "modifyPrincipals";

permission javax.security.auth.AuthPermission "modifyPublicCredentials";

};

09-00で追加された定義

// (3)

// Grant all permissions to anything loaded from the

// EJB server itself

grant codeBase "file:${cosminexus.home}/jaxrs/lib/*" {

permission java.security.AllPermission;

};

grant codeBase "file:${ejbserver.install.root}/weld/lib/*" {

permission java.security.AllPermission;

};

grant codeBase "file:${cosminexus.home}/common/lib/*" {

permission java.security.AllPermission;

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(42)　Managementイベント発行用メッセージIDの追加

変更内容

Managementイベント発行用メッセージIDを追加しました。

互換性を重視したシステムへ移行する場合に必要な作業

追加されたメッセージIDでイベントが発行されないよう，追加されたメッセージIDの前に「-」（ハイフン）を付けたメッセージIDをManagementイベント発行用メッセージIDリストファイルに追加してください。

追加されたManagementイベント発行用メッセージIDをバージョンごとに示します。

表10‒18　追加されたManagementイベント発行用メッセージID

追加されたアプリケーションサーバのバージョン

機能

メッセージID

09-00

Webコンテナ単位の全体実行待ちリクエスト数の監視

KDJE53862-W

KDJE53863-I

KDJE53864-W

KDJE53865-I

KDJE53866-W

KDJE53867-I

KDJE53868-W

KDJE53869-I

Managementイベント発行用メッセージIDリストファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.12　Managementイベント発行用メッセージIDリストファイル」を参照してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(43)　MimeUtility APIの仕様変更

変更内容

javax.mail.internet.MimeUtilityクラスのencodeメソッドでエンコード方式に"base64"を用いた場合，Component Containerのバージョンおよび戻り値として得たOutputStreamに対するcloseメソッドの実行有無によって，末尾への改行（"¥r¥n"）付与の有無が次のように異なります。

Component Containerのバージョン

OutputStream.closeメソッドの実行の有無

末尾への改行付与

09-00以前

有

付与しない

無

付与しない

09-50以降

有

付与する

無

付与しない

互換性を重視したシステムへ移行する場合に必要な作業

MimeUtility.encodeメソッドの戻り値として得たOutputStreamの末尾に不要な改行が存在する場合があります。不要な改行が存在する場合は，改行文字を削除してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

以下の条件がすべて重なるアプリケーションに影響がありますので，上記の必要な作業を実施してください。

MimeUtility.encodeメソッドを使用してBase64エンコードを実行している。

戻り値として得られるOutputStreamでcloseメソッドを実行している。

(44)　RSA BSAFE SSL-Jの削除

変更内容

JDK 6をベースとしているアプリケーションサーバ Version 9と9.5では，TLSv1.2によるSSL/TLS通信を目的として，RSA BSAFE SSL-J(以降，SSL-J)をCosminexus Developer's Kit for Java(TM)に同梱していました。JDK 7以降ではTLSv1.2によるSSL/TLS通信を標準で提供していて，JDK 7以降をベースとしているこの製品のCosminexus Developer's Kit for Java(TM)では，SSL-Jを同梱していません。

互換性を重視したシステムへ移行する場合に必要な作業

アプリケーションサーバ Version 9と9.5で，同梱していたSSL-Jを使用していた場合，この製品にバージョンアップをする際には，SSL-Jを利用するために行っていた手順や設定を取り消してください。具体的には次の手順(a)〜(c)が必要となります。

(a)　コピーしていたSSL-Jプロバイダのファイルの削除

次のファイルを拡張機能ディレクトリから削除します。

sslj.jar

cryptoj.jar

certj.jar

拡張機能ディレクトリ

<JDKインストールパス>/jre/lib/ext

(b)　セキュリティプロパティファイルの変更取り消し

SSL-Jが提供しているセキュリティプロパイダを削除してください。その際，削除した行以降については，プロバイダの優先順位を表す番号を繰り上げるようにしてください。次に例を示します。

＜取り消し前のセキュリティプロパティファイルの内容＞

security.provider.1=com.rsa.jsafe.provider.JsafeJCE
security.provider.2=com.rsa.jsse.JsseProvider
security.provider.3=example.provider.
security.provider.4=…..
…..

＜取り消し後のセキュリティプロパティファイルの内容＞

security.provider.1=example.provider
security.provider.2=…..
…..

(c)　ユーザプロパティファイルusrconf.propertiesの編集

SSL-JによるSSL/TLS通信機能を利用する場合に行った設定変更を元に戻します。この手順では，ユーザプロパティファイルusrconf.propertiesの編集を行います。使用しているusrconf.propertiesによって，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の次の項目を参照してください。

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

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

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

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

SSL-Jが同梱されていたCosminexus製品のusrconf.propertiesには，次のように，SSL-Jが提供しているSSL/TLS通信が有効となるような設定記載が行われています。

…..
# JDK SSL-J Settings
# If you want to enable SSL-J, please uncomment.
https.protocols=SSLv3,TLSv1,TLSv1.1,TLSv1.2
https.cipherSuites=TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384…..
…..

SSL-Jを同梱していないこの製品では，これらの設定は不要ですので，usrconf.propertiesからこれらの行を削除してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

アプリケーションサーバ Version 9と9.5で，同梱していたSSL-Jを使用していた場合に影響があります。

(45)　Permanent領域からMetaspace領域への移行

変更内容

09-70では，ロードされたクラスなどの情報が格納される領域がMetaspace領域になりました。09-60まではロードされたクラスなどの情報が格納される領域はPermanent領域でしたが，09-70では廃止されました。

互換性を重視したシステムへ移行する場合に必要な作業

Permanent領域を09-70で使用することはできません。

それに伴い，-XX:PermSize，-XX:MaxPermSizeは09-70以降指定できません。

代わりに-XX:MetaspaceSize，-XX:MaxMetaspaceSizeを使用してください。

表10‒19　移行時の各オプションの設定

オプション名

設定値

-XX:MetaspaceSize

アプリケーションで必要なクラス情報の見積もり値（09-60までの-XX:PermSizeと同じ値）

-XX:MaxMetaspaceSize

アプリケーションで必要なクラス情報の見積もり値（09-60までの-XX:MaxPermSizeと同じ値）

-XX:CompressedClassSpaceSize

アプリケーションで必要なクラス情報の見積もり値（09-60までの-XX:MaxPermSizeと同じ値）

なお，Compressed Class Spaceは，圧縮オブジェクトポインタ機能が有効な場合，Metaspace領域内に作成される領域です。この領域に，Javaヒープ内のオブジェクトから参照されるクラス情報が配置されます。そして，それ以外のメソッド情報などがCompressed Class Space以外のMetaspace領域に配置されます。

推奨機能を使用したシステムへ移行する場合に必要な作業

Metaspace領域はロードされたクラス情報が格納される領域です。そのため，Metaspace領域のサイズの設定は，アプリケーションで必要なクラス情報のサイズを見積もり，その値を-XX:MetaspaceSizeや-XX:MaxMetaspaceSizeに設定することを推奨します。これは，09-60までのPermanent領域の設定の考え方と同じです。

アプリケーションで必要なクラス情報のサイズの見積もり値を正しく設定することで，Metaspace領域のOutOfMemoryErrorの発生を防ぎ，また-XX:MetaspaceSizeと-XX:MaxMetaspaceSizeを同じ値にすることでMetaspace領域に起因するFullGCの発生を抑止することができます。

影響を受けるもの

Permanent領域に関するオプションを使用している場合に影響を受けます。

(46)　JDK内部のファイル構成変更

変更内容

JDK 9では，JDK内部のディレクトリとファイル構成が一部変更されています。主要な変更点を次に示します。

<Application Server のインストールディレクトリ>¥jdk¥下のディレクトリ構成の変更

jreディレクトリの削除など，いくつかの変更点があります。詳細は次のWebページを参照してください。

https://docs.oracle.com/javase/9/migrate/toc.htm#JSMIG-GUID-BC5E3EDE-C1FB-4B60-AF7D-8D4D7FE79C84

rt.jarファイルとtools.jarファイルの削除

rt.jarファイルとtools.jarファイルは削除されました。詳細は次のWebページを参照してください。

https://docs.oracle.com/javase/9/migrate/toc.htm#JSMIG-GUID-A78CC891-701D-4549-AA4E-B8DD90228B4B

互換性を重視したシステムへ移行する場合に必要な作業

変更内容に記載されているディレクトリまたはファイルに依存している設定や実装方式のアプリケーションの場合，設定または実装方式の変更が必要です。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(47)　削除されたAPI／機能／オプション

変更内容

JDK 9で削除または変更されたAPI，機能，オプションについては次に示すWebページを参照し，JDK 9移行時に使用している項目がないかどうかを確認してください。

http://www.oracle.com/technetwork/java/javase/9-removed-features-3745614.html

https://docs.oracle.com/javase/9/migrate/toc.htm#JSMIG-GUID-F7696E02-A1FB-4D5A-B1F2-89E7007D4096

互換性を重視したシステムへ移行する場合に必要な作業

変更内容に記載されているAPI，機能，オプションを使用している場合，設定または実装方式の変更が必要です。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(48)　バージョン文字列形式の変更

変更内容

JDK 9ではバージョン文字列のフォーマットが変更され，従来の”1.8.0”のようなフォーマットではなくなりました。JDK 9のバージョン文字列は”9”や”9.0.1”といったフォーマットになります。それに関連し，バージョン文字列に依存した，次のシステムプロパティのデフォルト値も変更されています。

java.version

java.specification.version

java.vm.specification.version

互換性を重視したシステムへ移行する場合に必要な作業

バージョン文字列または変更内容で示した3つのシステムプロパティに依存する設定や実装方式のアプリケーションの場合，設定または実装方式の変更が必要です。JDK 9のバージョン文字列フォーマットやシステムプロパティの詳細は，次のWebページを参照してください。

http://www.oracle.com/technetwork/java/javase/9-relnote-issues-3704069.html#JDK-8085822

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(49)　内部APIのカプセル化

変更内容

JSR 376「Java Platform Module System」の導入に伴い，一部の内部APIがカプセル化され，利用できなくなりました（このような内部APIは，JDK 8において非サポートとされていたものです）。そのため，そのような内部APIを使用したソースコードをJDK 9でコンパイルした場合，エラーや警告が発生するおそれがあります。

また，JDK 8以前のJDKを利用して作成したアプリケーションをJDK 9で実行させた場合でも同様に，カプセル化した内部APIを使用していると，エラーや警告が発生するおそれがあります。

詳細は次のWebページを参照してください。

http://www.oracle.com/technetwork/java/javase/9-relnote-issues-3704069.html#JDK-8142968

互換性を重視したシステムへ移行する場合に必要な作業

内部APIを使用している場合，設定または実装方式の変更が必要です。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(50)　-Xbootclasspathオプションと-Xbootclasspath/pオプションの削除

変更内容

JDK 9では，-Xbootclasspathオプションと-Xbootclasspath/pオプションは削除されました。一方，-Xbootclasspath/aオプションは削除されていません。ただし，これらのオプションは，旧バージョンを含め，削除されているかどうかに関係なく，アプリケーションサーバではサポートしていません。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(51)　推奨標準機構（Endorsed Standards Override Mechanism）の削除

変更内容

JDK 9では推奨標準機構（Endorsed Standards Override Mechanism）が削除され，java.endorsed.dirsシステムプロパティと<Application Serverのインストールディレクトリ>¥jdk¥lib¥endorsedディレクトリは使用できません。JavaVMの起動時，このシステムプロパティ指定またはディレクトリが存在する場合は，JDKの起動に失敗します。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(52)　拡張機能機構（Extensions Mechanism）の削除

変更内容

JDK 9では拡張標準機構（Extensions Mechanism）が削除され，java.ext.dirsシステムプロパティと<Application Serverのインストールディレクトリ>¥jdk¥lib¥extディレクトリは使用できません。JDKの起動時，このシステムプロパティ指定またはディレクトリが存在する場合は，JDKの起動に失敗します。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(53)　システムクラスローダの継承関係の変更

変更内容

JDK 8以前のシステムクラスローダは，JDK内部実装としてjava.net.URLClassLoaderを継承していましたが，JDK 9のシステムクラスローダはjava.net.URLClassLoaderを継承していません。そのため，システムクラスローダがjava.net.URLClassLoaderを継承していることを前提としていないことを確認してください。

詳細は次のWebページを参照してください。

http://www.oracle.com/technetwork/java/javase/9-relnote-issues-3704069.html

互換性を重視したシステムへ移行する場合に必要な作業

システムクラスローダがjava.net.URLClassLoaderを継承していることを前提としている場合，実装方式の変更が必要です。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(54)　javahコマンドの削除

変更内容

javahコマンドはJDK 10で削除されました。javahコマンドの機能は，javacコマンドの-hオプションに移管されています。詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/10-relnote-issues-4108729.html#JDK-8182758

互換性を重視したシステムへ移行する場合に必要な作業

javacコマンドの-hオプションを使用してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(55)　-Xprofオプションの削除

変更内容

JavaVMオプションである，-XprofオプションはJDK 10で削除されました。詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/10-relnote-issues-4108729.html#JDK-8173715

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(56)　java.io.FileInputStreamとjava.io.FileOuputStreamクラスのfinalizeメソッドの実装変更

変更内容

FileInputStreamクラスとFileOutputStreamクラスのfinalizeメソッドは，以前はcloseメソッドを呼び出していましたが，JDK 10以降ではcloseメソッドを呼び出しません。もし，これらクラスのfinalizeメソッドがcloseメソッドを直接呼び出すことを前提とした処理がある場合には，非互換性が発生するおそれがあります。その場合は，closeメソッドを明示的に呼び出すか，try-with-resouce構文を使用してリソースの解放をしてください。ただし，Application Serverを使用した場合は，互換性を考慮し，旧バージョンと同様にFileInputStreamクラスとFileOutputStreamクラスのfinalizeメソッドはcloseメソッドを呼び出す方式になります。詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/10-relnote-issues-4108729.html#JDK-8080225

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(57)　JMXエージェントのパスワード暗号化

変更内容

JMXエージェントを使用したリモート接続時，設定ファイル（jmxremote.password）に記載されたパスワードはハッシュ化された値で上書きされるようになりました。詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/10-relnote-issues-4108729.html#JDK-5016517

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(58)　Java EE向けモジュールとCORBAモジュールの削除

変更内容

次に示すJava EE向けモジュールとCORBAモジュールはJDK 11で削除されました。

java.xml.ws

java.xml.bind

java.activation

java.xml.ws.annotation

java.corba

java.transaction

java.se.ee

jdk.xml.ws

jdk.xml.bind

モジュールの削除に伴い，これらのモジュールに関連したコマンド群やシステムプロパティも削除されています。詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/11-relnote-issues-5012449.html#JDK-8190378

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(59)　クラスファイルバージョンの変更

変更内容

JDK11のクラスファイルバージョンは”55.0”です。クラスファイルバージョン”54.0”や”55.0”のクラスファイルをJDK9で動作させることはできません。

また，このクラスファイルバージョンの変更に伴い，クラスファイルフォーマットも変更されています。

互換性を重視したシステムへ移行する場合に必要な作業

クラスファイルの解析などをするプログラムやライブラリを使用している場合は，実装の変更やライブラリの更新などが必要となる場合があります。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(60)　javacコマンドのsource/target/releaseオプションに指定できる値

変更内容

09-87のjavacコマンドでは，sourceオプション，targetオプションそれぞれに指定できる値を次に示します。

「6」または「1.6」（非推奨。次バージョンで指定できなくなるおそれがあります。）

「7」または「1.7」

「8」または「1.8」

「9」または「1.9」

09-80以降では「10」または「1.10」は指定できません。「10」または「1.10」を指定した場合の動作は保証しません。また，--releaseオプションも同様に，「10」を指定した場合の動作は保証しません。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(61)　Javaプログラム実行中のシステムプロパティの変更

変更内容

Javaプログラム実行中，次に示すシステムプロパティ値を変更しても，その変更がjava.baseモジュール内のAPIの動作に反映されない場合があります。JavaVM初期化時の値が参照される方式になりました。

java.home

user.home

user.dir

user.name

詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/11-relnote-issues-5012449.html#JDK-8066709

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(62)　3DES暗号スイートの無効化

変更内容

SSL/TLS通信で使用する3DES暗号スイートは，使用できなくなりました。

詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/11-relnote-issues-5012449.html#JDK-8175075

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(63)　runFinalizersOnExitメソッドの削除

変更内容

java.lang.Systemクラスとjava.lang.RuntimeクラスのrunFinalizersOnExitメソッドは，JDK 11で削除されました。runFinalizersOnExitメソッドを使用するとjava.lang.NoSuchMethodErrorがスローされます。

互換性を重視したシステムへ移行する場合に必要な作業

runFinalizersOnExitメソッドを使用している場合は，使用しない方式へプログラムを変更してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

(64)　ThreadPoolExecutorとScheduledThreadPoolExecutorクラスのfinalizeメソッドの実装変更

変更内容

java.util.concurrent.ThreadPoolExecutorクラスと，そのサブクラスであるjava.util.concurrent.ScheduledThreadPoolExecutorクラスのfinalizeメソッドは，以前はshutdownメソッドを呼び出していましたが，JDK11以降ではshutdownメソッドを呼び出しません。もし，これらのクラスのfinalizeメソッドがshutdownメソッドを呼び出すことを前提とした処理がある場合には，非互換性が発生するおそれがあります。その場合は，shutdownメソッドを明示的に呼び出すようにしてください。

ただし，Application Serverを使用した場合は，互換性を考慮し，旧バージョンと同様にThreadPoolExecutorクラスとScheduledThreadPoolExecutorクラスのfinalizeメソッドはshutdownメソッドを呼び出す方式になります。これらのクラスのshutdownメソッドは複数回呼ばれても問題ないメソッドです。

また，Application Serverを使用する際，ThreadPoolExecutorクラスまたはScheduledThreadPoolExecutorクラスのサブクラスを作成していて，かつshutdownメソッドをオーバーライドしている場合，オーバーライドしたshutdownメソッドが複数回呼ばれるおそれがあります。オーバーライドするshutdownメソッドが複数回呼ばれても問題ないように実装してください。

詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/11-relnote-issues-5012449.html#JDK-8190324

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(65)　getAnnotationメソッド呼び出しで発生する例外の変更

変更内容

アノテーションに指定したクラスがクラスパスに存在しない場合に，そのアノテーションをjava.lang.ClassクラスのgetAnnotationメソッドで取得しようとすると，JDK10以前はjava.lang.ArrayStoreExceptionをスローしていました。JDK11以降から，同様の処理を実施してもjava.lang.ArrayStoreExceptionをスローしないで，getAnnotationメソッドで取得したアノテーションの値を読み込もうとしたタイミングで，java.lang.TypeNotPresentExceptionをスローするようになりました。もし，java.lang.ArrayStoreExceptionを前提とした処理がある場合には，非互換性が発生するおそれがあります。その場合は，java.lang.TypeNotPresentExceptionを明示的にキャッチするようにしてください。

ただし，Application Serverを使用した場合だけ，JDK10以前と同様にjava.lang.ArrayStoreExceptionをスローする方式になります。従って，java.lang.ArrayStoreExceptionを明示的にキャッチしていたプログラムで，java.lang.TypeNotPresentExceptionを処理するように変更する必要はありません。

詳細は次のWebページを参照してください。

https://www.oracle.com/technetwork/java/javase/11-relnote-issues-5012449.html#JDK-7183985

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(66)　日立拡張機能が提供するファイルの配置場所の変更

変更内容

jreディレクトリの削除に伴い，旧バージョンのjreディレクトリ内の，日立拡張機能が提供するコマンドまたはファイルの配置場所が変更されました。jreディレクトリの削除については「10.3.5(46)　JDK内部のファイル構成変更」を参照してください。

配置場所が変更されたコマンドまたはファイルについて，旧バージョンである09-70の配置場所と09-80以降での配置場所を次の表に示します。

表10‒20　配置場所が変更されたコマンドまたはファイル一覧

項番

09-70

09-80以降

1

jdk¥jre¥bin¥eheapprof.exe

jdk¥bin¥eheapprof.exe

2

jdk¥jre¥bin¥javacore.exe

jdk¥bin¥javacore.exe

3

jdk¥jre¥bin¥javagc.exe

jdk¥bin¥javagc.exe

4

jdk¥jre¥bin¥jheapprof.exe

jdk¥bin¥jheapprof.exe

5

jdk¥jre¥bin¥jheapprofanalyzer.exe

jdk¥bin¥jheapprofanalyzer.exe

6

jdk¥jre¥bin¥hndlwrap2.dll

jdk¥bin¥hndlwrap2.dll

7

jdk¥jre¥lib¥explicitmemory¥sysexmemexcludeclass.cfg

jdk¥lib¥explicitmemory¥sysexmemexcludeclass.cfg

8

jdk¥jre¥bin¥car_tar_gz

jdk¥bin¥car_tar_gz

9

jdk¥jre¥bin¥car_tar_Z

jdk¥bin¥car_tar_Z

10

jdk¥jre¥bin¥javatrace

jdk¥bin¥javatrace

注1　jdkディレクトリは，<Application Server のインストールディレクトリ>¥jdkを指します。

注2　項番1〜5のファイル名文字列は，Linux環境では拡張子.exeが存在しない文字列です。

注3　項番6はWindows固有のファイル，項番8〜10はLinux環境固有のファイルです。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(67)　拡張verbosegc出力機能のログフォーマット変更（G1GCを使用する場合）

変更内容

ガベージファースト・コレクタ（G1GC）使用時，拡張verbosegc出力機能のログファイルフォーマットにGCIDという項目が追加されます。GCIDとは，GCごとに付与される一意の値です。G1GC以外のガーベージコレクション方式使用時には，拡張verbosegc出力機能のログファイルフォーマットに変更はありません。

GCIDは，次に示すGCを開始するタイミングでインクリメントされます。

Young GC

Concurrent Marking(CM)

Mixed GC

Full GC

G1GC使用時のGCIDの出力イメージを次に示します。各行末尾の太字の項目がGCIDの出力項目です。

G1GC使用時のGCID出力イメージ

[VG1]<Thu Sep 15 11:01:45 2016>[Young GC(initial-mark) 974K/1024K(131072K)->1044K/2048K(131072K), 0.0017569 secs]…[GCID: 1]
[VCM]<Thu Sep 15 11:01:45 2016>[Concurrent Cycle Start][User: 0.0000000 secs][Sys: 0.0000000 secs][GCID: 2]
[VCM]<Thu Sep 15 11:01:45 2016>[Concurrent Root Region Scan Start][User: 0.0000000 secs][Sys: 0.0000000 secs][GCID: 2]
[VCM]<Thu Sep 15 11:01:45 2016>[Concurrent Root Region Scan End][User: 0.0000000 secs][Sys: 0.0000000 secs][GCID: 2]
[VCM]<Thu Sep 15 11:01:45 2016>[Concurrent Mark Start][User: 0.0000000 secs][Sys: 0.0000000 secs][GCID: 2]
[VG1]<Thu Sep 15 11:01:45 2016>[Young GC 1022K/1024K(131072K)->1024K/1024K(131072K), 0.0015565 secs]…[GCID: 3]
[VCM]<Thu Sep 15 11:01:45 2016>[Concurrent Mark End][User: 0.0000000 secs][Sys: 0.0000000 secs][GCID: 2]
[VG1]<Thu Sep 15 11:01:45 2016>[Young GC 1024K/1024K(131072K)->1019K/1024K(157696K), 0.0021122 secs]…[GCID: 4]
[VG1]<Thu Sep 15 11:01:45 2016>[CM Remark 1024K/1024K(131072K)->1019K/1024K(157696K), 0.0007291 secs]…[GCID: 2]
[VG1]<Thu Sep 15 11:01:45 2016>[CM Cleanup 1024K/1024K(131072K)->1019K/2048K(157696K), 0.0002869 secs]…[GCID: 2]
[VCM]<Thu Sep 15 11:01:45 2016>[Concurrent Cycle End][User: 0.0000000 secs][Sys: 0.0000000 secs][GCID: 2]

注

…は省略を示します。

GIGC使用時の拡張verbosegc出力機能のログフォーマット（非CSV形式）を次に示します。

gc_idがGCごとに付与される一意の値を示します。フォーマット中のgc_id以外の出力項目（id，dataなどの太字・斜字部分）の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください

G1GC使用時の拡張verbosegc出力機能のログフォーマット（非CSV形式）

 [id]<date>[gc_kind gc_info, gc_time secs][Status:gc_status][G1GC::Eden: eden_info][G1GC::Survivor: survivor_info][G1GC::Tenured: tenured_info][G1GC::Humongous: humongous_info][G1GC::Free: free_info][G1GC::Perm: perm_info][Metaspace: metaspace_info][class space: class_space_info] [cause:cause_info][RegionSize: region_sizeK][Target: target_time secs][Predicted: predicted_time secs][TargetTenured: target_sizeK][Reclaimable: reclaimable_info][User: user_cpu secs][Sys: system_cpu secs][IM: jvm_alloc_sizeK, mmap_total_sizeK, malloc_total_sizeK][TC: thread_count][DOE: doe_alloc_sizeK, called_count][CCI: cc_used_sizeK, cc_max_sizeK, cc_infoK][GCID: gc_id]

注

上記のログフォーマットは1文です。

G1GC使用時の拡張verbosegc出力機能のログ出力例（非CSV形式）を次に示します。

G1GC使用時の拡張verbosegc出力機能のログ出力例（非CSV形式）

[VG1]<Wed Sep 14 13:48:48.563 2016>[Full GC 841216K/841728K(1344512K)->632147K/841728K(1344512K), 0.2313101 secs][Status:-][G1GC::Eden: 6144K(57344K)->0K(66560K)][G1GC::Survivor: 9216K->0K][G1GC::Tenured: 826368K->841728K][G1GC::Humongous: 0K->0K][G1GC::Free: 502784K->502784K][Metaspace: 6562K(6900K, 7040K)->6562K(6900K, 7040K)][class space: 662K(774K, 896K)->662K(774K, 896K)][cause:System.gc][RegionSize: 1024K][Target: 0.2000000 secs][Predicted: 0.0000000 secs][TargetTenured: 0K][Reclaimable: 0K(0.00%)][User: 0.2343750 secs][Sys: 0.0000000 secs][IM: 20459K, 21920K, 0K][TC: 34][DOE: 0K, 0][CCI: 2126K, 245760K, 7488K][GCID: 22]

GIGC使用時の拡張verbosegc出力機能のログフォーマット（CSV形式）を次に示します。

gc_idがGCごとに付与される一意の値を示します。フォーマット中のgc_id以外の出力項目（id，dataなどの太字・斜字部分）の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください

G1GC使用時の拡張verbosegc出力機能のログフォーマット（非CSV形式）

id,date,gc_kind,gc_info,gc_time,gc_status,eden_info,survivor_info,tenured_info,humongous_info,free_info,perm_info,metaspace_info,classspace_info,cause_info,region_size,target_time,predicted_time,target_size,reclaimable_info,user_cpu,system_cpu,jvm_alloc_size,mmap_total_size,malloc_total_size,thread_count,doe_alloc_size,called_count,cc_used_size,cc_max_size,cc_info,gc_id

注

上記format文は1文です。

G1GC使用時の拡張verbosegc出力機能のログ出力例（CSV形式）を次に示します。

G1GC使用時の拡張verbosegc出力機能のログ出力例（CSV形式）

VG1,Thu Oct 02 10:40:54.920 2016,Full GC,753,2048,8192,678,1024,8192,0.0064767,-,1024,2048,0,2048,0,0,1024,1024,0,0,6144,7168,3634,3634,4492,3634,3634,4492,356,356,388,356,356,388,1,1024,0.2000000,0.0000000,0,0,0.00,0.0000000,0.0000000,20459,21920,0,35,0,0,1171,245760,2496,3

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(68)　スレッドダンプ中のJavaVM内部メモリマップ情報の出力フォーマット変更

変更内容

スレッドダンプには，JavaVM 自身が確保しているメモリ領域情報として，JavaVM内部メモリマップ情報が出力されます。このJavaVM内部メモリマップ情報の出力フォーマットが変更されました。スレッドダンプやJavaVM内部メモリマップ情報の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

旧バージョンでは，JavaVM内部メモリマップ情報はJVM Internal Memory Mapの1項目としてすべて出力していましたが，09-80以降では，JavaVM内部メモリマップ情報をJVM Internal Memory MapとJVM Internal Memory Map (Large Block)の2項目に分けて出力します。JavaVM 自身が確保しているメモリ領域のうち，巨大なメモリを割り当てるためにJavaVMが確保したメモリ情報をJVM Internal Memory Map（Large Block）として出力し，それ以外の，通常の大きさのメモリを割り当てるためにJavaVMが確保したメモリ情報をJVM Internal Memory Mapとして出力します。

JavaVM内部メモリマップ情報の出力フォーマットと出力例を次に示します。

JavaVM内部メモリマップ情報の出力フォーマット

JVM Internal Memory Map
-----------------------
        <メモリ確保関数>  : address = <開始アドレス> - <終了アドレス> (size:<サイズ>)
…

JVM Internal Memory Map (Large Block)
-------------------------------------
        <メモリ確保関数>  : address = <開始アドレス> - <終了アドレス> (size:<サイズ>)
…

注

<メモリ確保関数>：mmap()かmalloc()のどちらかです。

<開始アドレス>：メモリ領域の開始アドレスが16進数で表示されます。

<終了アドレス>：メモリ領域の終了アドレスが16進数で表示されます。

<サイズ>：確保しているメモリ領域のサイズが出力されます（単位：バイト）。

JavaVM内部メモリマップ情報の出力例

JVM Internal Memory Map
-----------------------
        mmap()   : address = 0x000000ee20010000 - 0x000000ee20050000 (size:262144)
        mmap()   : address = 0x000000ee2d590000 - 0x000000ee2d5d0000 (size:262144)
        mmap()   : address = 0x000000ee33280000 - 0x000000ee332c0000 (size:262144)

JVM Internal Memory Map (Large Block)
-------------------------------------
        mmap()   : address = 0x000000ee2d500000 - 0x000000ee2d528000 (size:163840)
        mmap()   : address = 0x000000ee2d530000 - 0x000000ee2d58b000 (size:372736)
        mmap()   : address = 0x000000ee33200000 - 0x000000ee33276000 (size:483328)

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(69)　エラーリポートファイル中のメモリ情報の出力フォーマット変更

変更内容

エラーリポートファイルには，JavaVM 自身が確保しているメモリ領域情報として，メモリ情報が出力されます。このメモリ情報の出力フォーマットが変更されました。エラーリポートファイルやメモリ情報の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

09-80以降では，「10.3.5(68)　スレッドダンプ中のJavaVM内部メモリマップ情報の出力フォーマット変更」のJVM Internal Memory Mapに対応するメモリ情報のあとに空行1行が挿入され，JVM Internal Memory Map （Large Block）に対応するメモリ情報を出力します。

メモリ情報の出力フォーマットと出力例を次に示します。

メモリ情報の出力フォーマット

JVM Internal Memory Map
-----------------------
        <メモリ確保関数>  : address = <開始アドレス> - <終了アドレス> (size:<サイズ>)
…

JVM Internal Memory Map (Large Block)
-------------------------------------
        <メモリ確保関数>  : address = <開始アドレス> - <終了アドレス> (size:<サイズ>)
…
        Heap Size  : <確保しているメモリサイズ>
        Alloc Size : <使用中のメモリサイズ>
        Free Size  : <未使用のメモリサイズ>

注

<メモリ確保関数>：mmap()かmalloc()のどちらかです。

<開始アドレス>：メモリ領域の開始アドレスが16進数で表示されます。

<終了アドレス>：メモリ領域の終了アドレスが16進数で表示されます。

各種メモリサイズの単位はバイトです。

メモリ情報の出力例

Memory:
        mmap()   : address = 0x000000ca0d380000 - 0x000000ca0d400000 (size:524288)
        mmap()   : address = 0x000000ca136d0000 - 0x000000ca13710000 (size:262144)
        mmap()   : address = 0x000000ca13d10000 - 0x000000ca13dd0000 (size:786432)

        mmap()   : address = 0x000000ca0d270000 - 0x000000ca0d298000 (size:163840)
        mmap()   : address = 0x000000ca0d2a0000 - 0x000000ca0d2fb000 (size:372736)
        mmap()   : address = 0x000000ca0d300000 - 0x000000ca0d376000 (size:483328)

        Heap Size  : 3919872
        Alloc Size : 3302992
        Free Size  : 616880

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(70)　インストーラ

変更内容

更新インストールする前のバージョンが09-70と09-80以降では，更新インストール時に退避するファイルの退避場所と退避後のファイル名が異なります。

「10.3.5(71)　更新インストール時に退避するファイルと退避先」で，09-70と09-80以降のインストール時の動作の違いについて説明します。

(71)　更新インストール時に退避するファイルと退避先

変更内容

更新インストールする前のバージョンが09-70と09-80以降では，更新インストール時に退避するファイルの退避場所と退避後のファイル名が異なります。

更新インストールする前のバージョンが09-70以前の場合

09-80以降のインストーラでは，<Application Serverのインストールディレクトリ>¥jdk¥jre_バージョン番号_日付時刻¥下にファイルを退避します。また，ファイル名はインストール前のファイル名のままとなります。

2017年7月10日18:02:02に09-60から09-80に更新インストールした場合の例を次の表に示します。

表10‒21　09-60から09-80に更新インストールした場合の例

退避対象ファイル

退避後のファイルパス

jdk¥jre¥lib¥security¥cacerts

jdk¥jre_0960_20170710180202¥lib¥security¥cacerts

jdk¥jre¥lib¥logging.properties

jdk¥jre_0960_20170710180202¥lib¥logging.properties

jdk¥jre¥lib¥net.properties

jdk¥jre_0960_20170710180202¥lib¥net.properties

jdk¥jre¥lib¥sound.properties

jdk¥jre_0960_20170710180202¥lib¥sound.properties

jdk¥jre¥lib¥management¥jmxremote.access

jdk¥jre_0960_20170710180202¥lib¥management¥jmxremote.access

jdk¥jre¥lib¥management¥management.properties

jdk¥jre_0960_20170710180202¥lib¥management¥management.properties

jdk¥jre¥lib¥security¥java.policy

jdk¥jre_0960_20170710180202¥lib¥security¥java.policy

jdk¥jre¥lib¥security¥java.security

jdk¥jre_0960_20170710180202¥lib¥security¥java.security

注

jdkディレクトリは，<Application Server のインストールディレクトリ>¥jdkを指します。

更新インストールする前のバージョンが09-80以降の場合

退避したファイルの別名（ファイル名_バージョン番号_日付時刻）の命名規則に変更はなく，同じディレクトリ内に別名ファイルとして退避します。

09-80以降のインストーラが退避する対象ファイルを次に示します。

jdk¥lib¥security¥cacerts

jdk¥conf¥logging.properties

jdk¥conf¥net.properties

jdk¥conf¥sound.properties

jdk¥conf¥management¥jmxremote.access

jdk¥conf¥management¥management.properties

jdk¥conf¥security¥java.policy

jdk¥conf¥security¥java.security

注

jdkディレクトリは，<Application Server のインストールディレクトリ>¥jdkを指します。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(72)　クラスライブラリのスタックトレース出力オプションの対象となるAPIの変更

変更内容

次に示すAPIはOracle社製JDK 11で削除されたため，クラスライブラリのスタックトレース出力オプション(-XX:[+|-]HitachiJavaClassLibTrace)を有効にした際，トレース対象となるAPIではなくなりました。

java.lang.System.runFinalizersOnExit

java.lang.Runtime.runFinalizersOnExit

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(73)　G1GCの処理変更に伴うJavaVMログファイルの出力形式変更

変更内容

JDK9（09-80）以前では，拡張verbosegc機能とG1GCの両方を有効にした場合，G1GCのConcurrent Marking処理中にConcurrent Cleanupが実施されると，JavaVMログファイルにはVG1ログのcm_event欄にConcurrent Cleanup Start（またはEnd）が出力されました。JDK11(09-87)では，Concurrent Cleanupが削除されたため，VG1ログのcm_event欄には[Concurrent Cleanup Start（またはEnd）が出力されなくなります。

拡張verbosegc情報出力オプション，JavaVMログファイルの出力形式については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(74)　StackOverflowError

変更内容

AIX環境では，次に示す処理でスタック領域が枯渇すると，java.lang.StackOverflowError例外がスローされないでJavaプロセスが異常終了する場合があります。

cjstartsvコマンド実行もしくはManagement Serverによる，J2EEサーバの起動処理

cjstartwebコマンド実行もしくはManagement Serverによる， Webコンテナサーバの起動処理

cjclstartapコマンド実行時，Javaアプリケーションのメインスレッド 上で行われる処理

この時，次のメッセージを出力してJavaプロセスが終了します。

java.lang.StackOverflowError occurred in primordial thread.

互換性を重視したシステムへ移行する場合に必要な作業

OSのスタック領域の最大サイズの設定値と-Xssオプション（デフォルト:1MB）に設定する値を大きくして，スタック領域が枯渇しないようにしてください。この際，OSのスタック領域の最大サイズには，-Xssオプション値以上の値を設定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

互換性を重視したシステムへ移行する場合に必要な作業と同じです。

影響を受けるもの

なし。

10.4　J2EEサーバまたはバッチサーバの作業ディレクトリのディスク容量の確認

J2EEサーバまたはバッチサーバの作業ディレクトリ用に十分なディスク容量があるかを確認します。バッチサーバの場合は，「J2EEサーバ」を「バッチサーバ」と読み替えてください。

旧バージョンからの移行で幾つかの移行コマンドを実行する必要がありますが，移行コマンドを実行すると，J2EEサーバの作業ディレクトリ内のファイルを変換する前にバックアップを作成します。バックアップはJ2EEサーバの作業ディレクトリ以下に作成されます。また，移行コマンドを実行すると，バックアップ分の容量に加えて，J2EEサーバの作業ディレクトリ自体のサイズも大きくなります。

これらの理由から，移行の前に作業ディレクトリに割り当てられているディスク領域の容量が十分かどうかを確認してください。バックアップと移行後の作業ディレクトリのサイズは次のとおりです。

なお，ここでのバックアップとは，バックアップ作業ディレクトリとバックアップRARディレクトリを示します。詳細については，「10.7　J2EEサーバまたはバッチサーバの移行コマンドの実行」，および「10.8.1　リソースアダプタの移行コマンドの実行」を参照してください。

旧バージョンでのJ2EEサーバの作業ディレクトリのサイズがNバイトの場合，バックアップ領域のサイズは，次の計算式で算出してください。

N×（cjenvupdateコマンドによって作業ディレクトリが移行される場合は1，移行されない場合は0）＋N×（DB Connectorを使用している場合は1，使用していない場合は0）+N×（リソースアダプタを使用している場合は，バージョンアップするリソースアダプタの数）

また，旧バージョンでのJ2EEサーバの作業ディレクトリのサイズがNバイトの場合，作業ディレクトリ自体の増加分のサイズは次の計算式で算出してください。

N×（cjenvupdateコマンドによって作業ディレクトリが移行される場合は1，移行されない場合は0）＋N×（DB Connectorを使用している場合は1，使用していない場合は0）+N×（リソースアダプタを使用している場合は，バージョンアップするリソースアダプタの数）

注意事項

移行するためには，J2EEサーバの作業ディレクトリが割り当てられているディスクの空き容量が，バックアップ領域分と作業ディレクトリ自体の増加分を足した値よりも大きい必要があります。なお，移行が完了したあと，バックアップ領域は削除できます。

10.5　アプリケーションサーバの動作環境および動作状態の確認

移行前に，アプリケーションサーバの動作環境，および動作状態を確認します。次に確認項目を示します。

運用管理サーバ（Management Serverだけ起動するマシン）を利用するシステム構成の場合，運用管理サーバにインストールしているアプリケーションサーバは09-70に移行する必要があります。

旧バージョンのアプリケーションサーバが終了していることを確認してください。アプリケーションサーバの全構成ソフトウェアを終了させます。

Microsoft IISを使用している場合は，Microsoft IISを終了させます。

JavaVMのプロセスは，プロセス起動時に取得したCPU情報を使って動作します。このため，プロセス起動時と異なるCPU情報（プロセッサ数など）の環境へ移行した場合の動作は保証できません。

AIXの場合，旧バージョンで環境変数LDR_CNTRLにMAXDATAを指定して運用していたときは，移行後に旧バージョンの指定値のまま運用すると，Cヒープ領域のサイズが不足するおそれがあります。移行後も環境変数LDR_CNTRLにMAXDATAを指定して運用するときは，MAXDATAの指定値を見直してください。

10.6　定義などのバックアップ

定義情報のバックアップについて説明します。なお，ここで説明している定義情報は，次に示す構成ソフトウェアに関するものです。

Performance Tracer

Component Container

Component Transaction Monitor

Component Container - Client

Component Container - Redirector

Developer's Kit for Java

Application Development Plug-in

このほかの構成ソフトウェアについては，次に示すマニュアルを参照してください。また，必要な場合は，保守員に連絡してください。

表10‒22　構成ソフトウェアごとの参照先マニュアル

構成ソフトウェア

参照先マニュアル

HTTP Server

HTTP Server

Reliable Messaging

Reliable Messaging

Web Services - Security

アプリケーションサーバ Webサービスセキュリティ構築ガイド

XML Processor

XML Processor ユーザーズガイド

10.6.1　新規インストールの場合の定義情報のバックアップ

新規インストールの場合，バックアップを取った定義情報を基に，新しいアプリケーションサーバの定義情報を作成します。

バックアップを取る情報を次の表に示します。

表10‒23　バックアップを取る情報（新規インストールの場合）

機能

バックアップを取る情報

バックアップを取った情報の設定先

Management Server／統合ユーザ管理

次に示すファイルをバックアップします。

keyfile.key（ua.confのcom.cosminexus.admin.auth.sso.keyfileキーに指定した暗号鍵ファイル）※

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config

UNIXの場合

/opt/Cosminexus/manager/config

次に示すファイルをバックアップします。

Managerで使用するファイル

Smart Composer機能で使用するファイル

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

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

設定先については，次のマニュアルを参照してください。

Managerで使用するファイル

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.　Managerで使用するファイル」

Smart Composer機能で使用するファイル

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.　Smart Composer機能で使用するファイル」

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

マニュアル「アプリケーションサーバ 機能解説 セキュリティ管理機能編」の「14.　統合ユーザ管理で使用するファイル」

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

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.　ログの運用で使用するファイル」

次に示すディレクトリをバックアップします。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥modules

UNIXの場合

/opt/Cosminexus/manager/modules

Windowsの場合

<製品のインストールディレクトリ>¥manager

UNIXの場合

/opt/Cosminexus/manager

次に示すディレクトリをバックアップします。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥apps

UNIXの場合

/opt/Cosminexus/manager/apps

Windowsの場合

<製品のインストールディレクトリ>¥manager

UNIXの場合

/opt/Cosminexus/manager

運用管理ポータルで，次に示す情報を控えます。

［運用管理ドメインの構成定義］画面で設定する情報

［論理サーバの環境設定］画面で設定する情報。論理J2EEサーバの設定項目に関しては，［JP1連携の設定］画面，［オプションの設定］画面，［環境変数の設定］画面，および［J2EEサーバの基本設定］画面の「セキュリティマネージャの使用」の設定項目だけ控えます。

［論理サーバの起動／停止］画面で設定する情報

［論理サーバのアプリケーション管理］画面で設定する情報。ただし，旧バージョンのアプリケーションサーバが08-00未満の場合，設定項目を控えます。

統合ユーザ管理の［リポジトリ管理］画面で設定する情報

設定項目を控えたときと同じ運用管理ポータルの画面

J2EEサーバ

次に示すディレクトリをバックアップします。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥usrconf¥ejb

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥usrconf

UNIXの場合

/opt/Cosminexus/CC/server/usrconf

Management Serverを使用していない場合は，J2EEサーバ起動時に独自に定義していた環境変数を退避してください。

運用管理ポータルの［環境変数の設定］画面，または簡易構築定義ファイルのuser.env.variableパラメタに設定します。

環境変数の設定については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1　Webサーバを別ホストに配置してマシン性能を向上するシステムの構築」の環境変数に関する説明を参照してください。

バッチサーバ

次に示すディレクトリをバックアップします。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥usrconf¥ejb

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥usrconf

UNIXの場合

/opt/Cosminexus/CC/server/usrconf

サーバ管理コマンド

次に示すディレクトリをバックアップします。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥admin¥usrconf

UNIXの場合

/opt/Cosminexus/CC/admin/usrconf

Windowsの場合

<製品のインストールディレクトリ>¥CC¥admin

UNIXの場合

/opt/Cosminexus/CC/admin

Webサーバ連携

次に示すファイルをバックアップします。

Microsoft IISの場合

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

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

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

HTTP Serverの場合

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

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

Windowsの場合

<製品のインストールディレクトリ>¥CC¥web¥redirector

UNIXの場合

/opt/Cosminexus/CC/web/redirector

HTTP Server

次に示すファイルをバックアップします。

httpsd.conf（HTTP Server定義ファイル）

mime.types（HTTP Server定義ファイル）

Windowsの場合

<製品のインストールディレクトリ>¥httpsd¥conf

UNIXの場合

/opt/hitachi/httpsd/conf

Smart Composer機能を使ってWebシステムを構築した場合，または運用管理ポータル画面で論理サーバを構築した場合のhttpsd.confファイルの設定先を次に示します。

Windowsの場合

<製品のインストールディレクトリ>¥httpsd¥servers¥HWS_<論理Webサーバ名>¥conf

UNIXの場合

/opt/hitachi/httpsd/servers/HWS_<論理Webサーバ名>/conf

Management Serverを使用していない場合は，HTTP Server起動時に独自に定義していた環境変数を退避してください。

adminagent.xml（運用管理エージェント設定ファイル）へ設定してください。環境変数の設定については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.12　論理サーバの環境変数を設定する」の環境変数に関する説明を参照してください。

次のディレクティブに設定されたディレクトリ，およびファイルは，HTTP Serverの設定，またはHTTP Serverの出力するコンテンツに関連するものです。各ディレクティブに設定されたディレクトリ，およびファイルの内容を確認し，移行する必要があるディレクトリ，およびファイルを選択し，バックアップを取ってください。

<Directory>，<DirectoryMatch>，AccessFileName，Alias，AliasMatch，AuthGroupFile，AuthUserFile，CoreDumpDirectory（UNIXの場合），DocumentRoot，HWSTraceIdFile，HWSTraceLogFile，Include，LoadFile，PidFile，QOSResponse（UNIXの場合），ScriptAlias，ScriptAliasMatch，ScriptLog，ServerRoot，SSLCACertificateFile，SSLCACertificatePath（UNIXの場合），SSLCacheServerPath（UNIXの場合），SSLCacheServerPort（UNIXの場合），SSLCacheServerRunDir（UNIXの場合），SSLCertificateFile，SSLCertificateKeyFile，SSLCertificateKeyPassword，SSLCRLDERPath，SSLCRLPEMPath，TypesConfig，UserDir

次のディレクティブの設定に合致するように，退避したディレクトリおよびファイルを設定してください。

<Directory>，<DirectoryMatch>，AccessFileName，Alias，AliasMatch，AuthGroupFile，AuthUserFile，CoreDumpDirectory（UNIXの場合），CustomLog，DocumentRoot，ErrorLog，HWSRequestLog，HWSTraceIdFile，HWSTraceLogFile，Include，LoadFile，PidFile，QOSResponse（UNIXの場合），ScriptAlias，ScriptAliasMatch，ScriptLog，ServerRoot，SSLCACertificateFile，SSLCACertificatePath（UNIXの場合），SSLCacheServerPath（UNIXの場合），SSLCacheServerPort（UNIXの場合），SSLCacheServerRunDir（UNIXの場合），SSLCertificateFile，SSLCertificateKeyFile，SSLCertificateKeyPassword，SSLCRLDERPath，SSLCRLPEMPath，TransferLog，TypesConfig，UserDir

なお，移行先でディレクトリおよびファイルの構成が変更される場合は，これらのディレクティブの設定値を見直してください。

LoadModuleディレクティブに設定されたモジュールは，09-00より前と09-00以降のバージョン間で互換性がありません。09-00以降が提供するモジュールを使用してください。

移行前の環境でLoadModuleディレクティブに設定していたモジュールについて，09-00以降が提供するモジュールを使用し，LoadModuleディレクティブの指定先に格納してください。

モジュールの仕様差を確認し，必要であればモジュールに関する設定値を見直してください。

次のディレクティブに設定されたログファイルのバックアップを取ってください。rotatelogsまたはrotatelogs2を使用している場合，ユティリティの退避は不要です。

CustomLog，ErrorLog，HWSRequestLog，TransferLog

設定先なし

注※

存在する場合だけバックアップを取ります。

注

ここで説明していない定義情報については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」およびマニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」を参照してください。

10.6.2　更新インストールの場合の定義情報のバックアップ

更新インストールに失敗するといった問題が発生したときに対応できるよう，バックアップを取ります。

バックアップを取るディレクトリを次の表に示します。

表10‒24　バックアップを取るディレクトリ

機能

バックアップを取るディレクトリ

Management Server／統合ユーザ管理

Windowsの場合

<製品のインストールディレクトリ>¥manager

UNIXの場合

/opt/Cosminexus/manager

J2EEサーバ

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥usrconf

J2EEサーバ用作業ディレクトリ

UNIXの場合

/opt/Cosminexus/CC/server/usrconf

J2EEサーバ用作業ディレクトリ

バッチサーバ

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥usrconf

バッチサーバ用作業ディレクトリ

UNIXの場合

/opt/Cosminexus/CC/server/usrconf

バッチサーバ用作業ディレクトリ

サーバ管理コマンド

Windowsの場合

<製品のインストールディレクトリ>¥CC¥admin¥usrconf

UNIXの場合

/opt/Cosminexus/CC/admin/usrconf

Webサーバ連携

Windowsの場合

<製品のインストールディレクトリ>¥CC¥web¥redirector

UNIXの場合

/opt/Cosminexus/CC/web/redirector

10.7　J2EEサーバまたはバッチサーバの移行コマンドの実行

ここでは，J2EEサーバおよびバッチサーバの移行コマンドであるcjenvupdateコマンドの実行について説明します。バッチサーバの場合は，「J2EEサーバ」を「バッチサーバ」と読み替えてください。

10.7.1　バックアップ作業ディレクトリ

J2EEサーバの移行コマンドを実行すると，J2EEサーバの作業ディレクトリ内のファイルを変換する前にバックアップを作成します。このマニュアルでは，バックアップされた作業ディレクトリのことを，バックアップ作業ディレクトリと呼びます。バックアップ作業ディレクトリには，移行前の情報（ファイル）が残ります。移行コマンドの実行が終了したとき，バックアップ作業ディレクトリは自動的に削除されません。

注意事項

WindowsおよびUNIX共に，バックアップ作業ディレクトリは作業ディレクトリの直下に作成されます。その際，バックアップ作業ディレクトリ名は，作業ディレクトリに「_old」が付いた名称になります。

バックアップ作業ディレクトリの例を次に示します。

Windowsの場合

　作業ディレクトリ

　　<製品のインストールディレクトリ>¥CC¥server¥public

　バックアップ作業ディレクトリ

　　<製品のインストールディレクトリ>¥CC¥server¥public¥public_old

UNIXの場合

　作業ディレクトリ

　　/opt/Cosminexus/CC/server/public

　バックアップ作業ディレクトリ

　　/opt/Cosminexus/CC/server/public/public_old

作業ディレクトリの移行が必要ないバージョンからのバージョンアップの場合，cjenvupdateコマンドは作業ディレクトリの移行は行いません。この場合，バックアップ作業ディレクトリは作成されません。

10.7.2　J2EEサーバの移行方法

作業ディレクトリおよびユーザ定義ファイルを移行するため，cjenvupdateコマンドを実行します。cjenvupdateコマンドの実行形式を次に示します。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥bin¥cjenvupdate

UNIXの場合

/opt/Cosminexus/CC/server/bin/cjenvupdate

cjenvupdateコマンドを実行すると，作業ディレクトリおよびユーザ定義ファイルが移行されます。cjenvupdateコマンドのログは次の場所に出力されます。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥logs

UNIXの場合

/opt/Cosminexus/CC/logs

cjenvupdateコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjenvupdate（作業ディレクトリおよびユーザ定義ファイルの移行）」を参照してください。

10.8　リソースアダプタの移行

旧バージョンのアプリケーションサーバで使用していたリソースアダプタを使用する場合，リソースアダプタの移行処理が必要です。

DB Connectorやほかのリソースアダプタの場合は，リソースアダプタの移行コマンド（cjrarupdateコマンド）を実行します。ただし，CJMSPリソースアダプタの場合，リソースアダプタの移行コマンド（cjrarupdateコマンド）は使用できません。サーバ管理コマンドを使用してCJMSPリソースアダプタを入れ替えてください。

注意事項

DB Connectorを使用しリソース接続を行う場合，CosminexusでサポートしているJDBCドライバはリリースノートでご確認ください。

10.8.1　リソースアダプタの移行コマンドの実行

ここでは，リソースアダプタの移行コマンドであるcjrarupdateコマンドの実行について説明します。バッチサーバの場合は，「J2EEサーバ」を「バッチサーバ」と読み替えてください。

(1)　バックアップRARディレクトリ

WindowsおよびUNIX共に，リソースアダプタの移行コマンドを実行すると，J2EEサーバの作業ディレクトリ内のファイルを変換する前にバックアップを作成します。このマニュアルでは，バックアップされた作業ディレクトリのことを，バックアップRARディレクトリと呼びます。バックアップRARディレクトリには，移行前の情報（ファイル）が残ります。リソースアダプタの移行コマンドの実行が終了したとき，バックアップRARディレクトリは自動的に削除されません。

また，リソースアダプタの移行コマンドを複数回実行する場合（例えば，DB Connector用に1回とTP1 Connector用に1回の合計2回実行する），バックアップRARディレクトリはコマンド実行ごとに生成され，最終的には複数残ります。

バックアップRARディレクトリの例，および移行処理に失敗した場合に自動で回復する方法について説明します。

バックアップRARディレクトリの例

バックアップRARディレクトリは，作業ディレクトリの直下に作成されます。バックアップRARディレクトリ名は，「rarupdate_bk」です。バックアップRARディレクトリの例を次に示します。

Windowsの場合

作業ディレクトリ

<製品のインストールディレクトリ>¥CC¥server¥public

バックアップRARディレクトリ

<製品のインストールディレクトリ>¥CC¥server¥public¥rarupdate_bk

UNIXの場合

作業ディレクトリ

/opt/Cosminexus/CC/server/public

バックアップRARディレクトリ

/opt/Cosminexus/CC/server/public/rarupdate_bk

すでにバックアップRARディレクトリ（rarupdate_bk）が作成されている場合，既存のバックアップディレクトリは「rarupdate_bk_0000000[n]」（nは17けたの番号で年月日時間の情報）にリネームされたあと，新たにバックアップRARディレクトリが作成されます。

移行処理に失敗した場合に自動で回復する方法

移行処理に失敗した場合に自動で回復するには，cjrarupdateコマンドに引数-recoverfromを指定して実行してください。引数-recoverfromには，バックアップ格納先ディレクトリを指定します。バックアップ処理の開始時，および完了時には，メッセージが出力されます。また，引数-recoverfromに指定したバックアップ格納先ディレクトリが不正な場合，および回復処理に失敗した場合，エラーメッセージが出力されます。

(2)　移行コマンドの実行

cjrarupdateコマンドを実行します。DB Connector，およびバージョンアップする各リソースアダプタに対して，一回ずつcjrarupdateコマンドを実行します。

cjrarupdateコマンドの実行形式を次に示します。

DB Connectorを使用している場合

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥bin¥cjrarupdate -type dbconnector

UNIXの場合

/opt/Cosminexus/CC/server/bin/cjrarupdate -type dbconnector

DB Connector以外のリソースアダプタを使用している場合

Windowsの場合

<製品のインストールディレクトリ>¥CC¥server¥bin¥cjrarupdate -type rar -f <リソースアダプタのパス>

UNIXの場合

/opt/Cosminexus/CC/server/bin/cjrarupdate -type rar -f <リソースアダプタのパス>

なお，cjrarupdateコマンドのログは，次の場所に出力されます。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥logs

UNIXの場合

/opt/Cosminexus/CC/logs

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

注意事項

cjrarupdateコマンドを同時に実行すると正しく環境が移行されないことがあります。コマンドを同時に実行しないでください。

複数のリソースアダプタを使用している場合，cjrarupdateコマンドを1回実行して，すべてのリソースアダプタを一括で移行できます。また，バックアップRARディレクトリのディレクトリパスを明示的に指定できます。

TP1/Message Queue-Accessを移行する場合に，新しいRARファイルが同一バージョンと認識されることがあります。その場合は-forceオプションを指定して強制的に移行処理を実行してください。

cjrarupdateコマンドに引数-recoverfromを指定して，J2EEアプリケーションに含めて使用するリソースアダプタを自動で回復する場合，移行処理に失敗したときに，回復が完了するまでJ2EEサーバに対する操作を実行しないでください。回復が完了する前にJ2EEサーバに対する操作を実行すると，回復処理が正しく実行されないことがあります。

10.8.2　CJMSPリソースアダプタの入れ替え

CJMSPプロバイダのリソースアダプタ（CJMSPリソースアダプタ）をバージョンアップする場合は，サーバ管理コマンドを使用してCJMSPリソースアダプタを入れ替えて，設定値を引き継いでください。入れ替え手順を次に示します。

cjgetrarpropコマンドを使用して，入れ替え前のCJMSPリソースアダプタのConnector属性ファイルを取得します。

CJMSPリソースアダプタを使用中のアプリケーションがある場合は，アプリケーションを停止します。

CJMSPリソースアダプタを削除します。

入れ替え前のCJMSPリソースアダプタを削除します。

cjimportresコマンドを使用して，次に示すCJMSPリソースアダプタのRARファイルをインポートします。

Windowsの場合

<製品のインストールディレクトリ>¥CC¥cjmsp¥lib¥cjmsra.rar

UNIXの場合

/opt/Cosminexus/CC/cjmsp/lib/cjmsra.rar

cjdeployrarコマンドを使用して，CJMSPリソースアダプタをデプロイします。

cjsetrarpropコマンドを使用して，CJMSPリソースアダプタのConnector属性ファイルを入れ替え前に指定されていた値へ変更します。

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

10.9　Management Serverの移行コマンドの実行

ここでは，Management Serverの移行コマンドの実行について説明します。

09-00より前の製品から移行する場合は，09-00以降にバージョンアップしたあと，Management Serverが動作するホストでmngenvupdateコマンドを実行します。mngenvupdateコマンドの実行形式を次に示します。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥bin¥mngenvupdate

UNIXの場合

/opt/Cosminexus/manager/bin/mngenvupdate

注意事項

mngenvupdateコマンドは，Administrator権限（Windowsの場合），またはroot権限（UNIXの場合）のあるユーザが実行してください。

mngenvupdateコマンドの実行に失敗した場合，<のインストールディレクトリ>/manager/configディレクトリの直下に一時ファイル（mserver.cfgxxxxxxxxxxxxxxxxxxxx.tmp）が残る場合がありますが，この一時ファイルを残しても削除しても，そのあとの操作への影響はありません。

10.10　論理サーバの設定情報の再読み込みおよび配布

バージョンアップ前の環境で使用していた設定を引き継ぐため，論理サーバの設定情報の再読み込みが必要です。この作業を行わないと，バージョンアップ前の論理J2EEサーバの設定が失われることがあります。

Management Serverを使用している場合，移行後にManagement Serverを最初に起動したときに，運用管理ドメインに構成定義された既存の論理J2EEサーバに対して，接続先ホストから設定情報の読み込みを実施する必要があります。移行の手順中で，既存の論理J2EEサーバの設定ファイルの内容が自動的に変更されるためです。

読み込みを実施したあと，設定情報の配布も実施してください。読み込みを実施したときにワーニングメッセージが出力され，配布ステータスが空白になった場合には，ワーニングメッセージに従って設定情報を見直してから配布してください。また，配布ステータスが空白以外の場合には，そのまま配布を実施してください。

設定情報の読み込みは，Management Serverの運用管理ポータルの論理サーバごとの［サーバの設定読み込み］画面で実施できます。「論理サーバの環境設定」については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.28　論理J2EEサーバの設定読み込み」を参照してください。

注意事項

設定情報の読み込みを実施したあと，Management Serverの運用管理ポータルの［設定情報の配布］画面，またはSmart Composer機能のcmx_build_systemコマンドで，設定情報の配布を実施してください。［設定情報の配布］画面で設定情報の読み込みを実施した際にワーニングメッセージが出力されて，ステータスに「空白」が表示された場合は，ワーニングメッセージに従って設定情報を見直してから配布してください。Smart Composer機能で設定情報の配布を実施すると，論理J2EEサーバだけでなく論理Webサーバの設定情報も配布されます。設定情報が未配布の論理サーバだけを配布したい場合は，-sdオプションを指定してcmx_build_systemコマンドを実行してください。［設定情報の配布］画面については，マニュアル「アプリケーションサーバ運用管理ポータル操作ガイド」の「10.10.1　設定情報の配布」を参照してください。また，cmx_build_systemコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cmx_build_system（Webシステムの構築）」を参照してください。

10.11　アプリケーションの設定（新規インストールの場合）

新しい環境で使用するアプリケーションを設定します。アプリケーションの設定手順を次に示します。

J2EEアプリケーションが利用するリソースをJ2EEサーバに設定します。

サーバ管理コマンドと属性ファイルを使用して設定します。属性ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」を参照してください。

記録していたセキュリティグループ（ユーザおよびロール）の情報を基に，セキュリティグループを追加してください。

退避していた属性ファイルを使用してメールコンフィグレーションを作成してください。

退避していた実行時情報付きJ2EEリソースアダプタをインポートしてください。

データソースを使用していた場合は，退避していた属性ファイルの情報を基にDB Connectorを登録し，開始してください。

退避していた実行時情報付きJ2EEリソースアダプタをインポートします。

J2EEサーバを停止します。

cjrarupdateコマンドを実行します。

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

J2EEサーバを開始します。

「10.3　旧バージョンから11-20までの仕様変更の確認」に従い，J2EEアプリケーションを修正します。

統合ユーザ管理が提供するuastartup.warまたはuastartup.earをデプロイしていた場合は，移行先のアプリケーションサーバが提供するものを使用してください。09-00以降では，次の場所にインストールされています。

Windowsの場合

<製品のインストールディレクトリ>¥manager¥config

UNIXの場合

/opt/Cosminexus/manager/config

J2EEアプリケーションをインポートします。

cjgetapppropコマンドでアプリケーション統合属性ファイルを取得します。

記録しておいたJ2EEアプリケーション内のEJB-JAR，WARのプロパティ情報，J2EEアプリケーションのカスタマイズ情報を基に，アプリケーション統合属性ファイルを編集します。

cjsetapppropコマンドでアプリケーション統合属性ファイルを設定します。

J2EEアプリケーションを開始します。

10.12　移行コマンドで作成されたバックアップの削除

アプリケーションの動作確認後，手動でバックアップ作業ディレクトリ，およびバックアップRARディレクトリを削除する必要があります。ただし，保守のためにバックアップ作業ディレクトリ，およびバックアップRARディレクトリを別の場所に保存しておくことをお勧めします。

移行前の作業ディレクトリ，移行後の作業ディレクトリ，バックアップ作業ディレクトリ，およびバックアップRARディレクトリの例を次の表に示します。

表10‒25　ディレクトリの移行の例（Windowsの場合）

J2EEサーバのサーバ名称

移行前の作業ディレクトリ

移行後の作業ディレクトリ，およびバックアップ作業ディレクトリ

サーバA

<製品のインストールディレクトリ>¥CC¥server¥public

（デフォルト）

変換後の作業ディレクトリ

<製品のインストールディレクトリ>¥CC¥server¥public

バックアップ作業ディレクトリ

<製品のインストールディレクトリ>¥CC¥server¥public¥public_old

バックアップRARディレクトリ

<製品のインストールディレクトリ>¥CC¥server¥public¥rarupdate_bk

サーバB

C:¥work_dir

変換後の作業ディレクトリ

C:¥work_dir

バックアップ作業ディレクトリ

C:¥work_dir¥work_dir_old

バックアップRARディレクトリ

C:¥work_dir¥rarupdate_bk

サーバC

−

D:¥replication_dir

D:¥replication_dir

未使用のディレクトリは移行されません。

（凡例）

−：作業ディレクトリとして使用しているサーバがないことを示す

表10‒26　ディレクトリの移行の例（UNIXの場合）

J2EEサーバのサーバ名称

移行前の作業ディレクトリ

移行後の作業ディレクトリ，およびバックアップ作業ディレクトリ

サーバA

/opt/Cosminexus/CC/server/public

（デフォルト）

変換後の作業ディレクトリ

/opt/Cosminexus/CC/server/public

バックアップ作業ディレクトリ

/opt/Cosminexus/CC/server/public/public_old

バックアップRARディレクトリ

/opt/Cosminexus/CC/server/public/rarupdate_bk

サーバB

/<任意のディレクトリ>/work_dir

変換後の作業ディレクトリ

/<任意のディレクトリ>/work_dir

バックアップ作業ディレクトリ

/<任意のディレクトリ>/work_dir/work_dir_old

バックアップRARディレクトリ

/<任意のディレクトリ>/work_dir/rarupdate_bk

サーバC

−

/<任意のディレクトリ>/replication_dir

/<任意のディレクトリ>/replication_dir

未使用のディレクトリは移行されません。

（凡例）

−：作業ディレクトリとして使用しているサーバがないことを示す

上記の表の例では，更新インストール前に，「サーバA」，「サーバB」，および「サーバC」のJ2EEサーバがセットアップされています。「サーバA」，および「サーバB」ではDB Connectorを使用しています。これらのJ2EEサーバが利用している作業ディレクトリが，Windowsの場合は「<製品のインストールディレクトリ>¥CC¥server¥public」と「C:¥work_dir」，UNIXの場合は「/opt/Cosminexus/CC/server/public」と「<任意のディレクトリ>/work_dir」です。Windowsの場合の「D:¥replication_dir」，UNIXの場合の「<任意のディレクトリ>/replication_dir」はユーザが複製した作業ディレクトリで，J2EEサーバからは利用されていません。

このような状況でcjenvupdateコマンド，およびcjrarupdateコマンドを実行した場合，それぞれ使用中の作業ディレクトリに対して，バックアップが作成されます。アプリケーションの動作確認後，手動でバックアップを削除してください。なお，未使用の作業ディレクトリ「D:¥replication_dir」または「<任意のディレクトリ>/replication_dir」は，移行されません。

注意事項

作業ディレクトリの移行が必要ないバージョンからのバージョンアップの場合，cjenvupdateコマンドは作業ディレクトリを移行しません。この場合，バックアップ作業ディレクトリは作成されません。

10.13　J2EEサーバまたはバッチサーバの移行コマンドで自動的に追加／変更／削除される定義

J2EEサーバまたはバッチサーバのユーザプロパティファイルや作業ディレクトリ内のDD情報は，旧バージョンのものが09-70の環境でもそのまま継続使用されます。ただし，新バージョンで追加された機能，およびデフォルト値が変更された機能があり，互換性を維持するために，J2EEサーバまたはバッチサーバの移行コマンドがユーザプロパティファイルのプロパティや作業ディレクトリ内のDD情報を部分的に変換します。移行コマンド実行時に追加／変更されるキーと値，およびコマンドで取得した属性ファイルに追加されるタグについて説明します。

また，移行コマンドを実行すると，移行元バージョンから移行先バージョン間のすべてのバージョンごとに移行処理が実施されます。例えば，08-00から09-70へ移行する場合，08-00から08-50への移行，08-50から08-53への移行，08-53から08-70への移行，08-70から09-00への移行，09-00から09-50への移行，09-50から09-70への移行というように処理が実施されます。

10.13.1　移行コマンドで自動的に追加／変更／削除される定義（アプリケーションサーバ Version 8からの移行）

移行コマンド実行時に追加／変更／削除されるキーと値を次の表に示します。

表10‒27　J2EEサーバのusrconf.propertiesに自動的に追加される定義（アプリケーションサーバ Version 8からの移行）

追加されるキーと値

旧バージョンでの環境条件

08-70

08-53

08-50

08-00

webserver.connector.limit.max_post_form_data=-1

−

−

−

−

○

webserver.dbsfo.integrity_mode.enabled=true

−

−

○

○

○

ejbserver.jndi.global.enabled=false

−

○

○

○

○

（凡例）　○：定義が自動的に追加されることを示す　−：該当しない

表10‒28　J2EEサーバのusrconf.cfgに自動的に追加／変更／削除される定義（アプリケーションサーバ Version 8からの移行）

追加／変更／削除されるキーと値

旧バージョンでの環境条件

08-70

08-53

08-50

08-00

add.jvm.arg=-XX:+HitachiExplicitMemoryCompatibleToV8

−

−

−

−

○

add.jvm.arg=-XX:-HitachiOutOfMemoryHandling

−

−

−

○

○

add.jvm.arg=-XX:MetaspaceSize=<size>

<size>は-XX:PermSizeの指定値

-XX:PermSizeを指定している場合

○

○

○

○

add.jvm.arg=-XX:MaxMetaspaceSize=<size>

<size>は-XX:MaxPermSizeの指定値

-XX:MaxPermSizeを指定している場合

○

○

○

○

add.jvm.arg=-XX:+UseParNewGC

−

×

×

×

×

（凡例）　○：定義が自動的に追加／変更されることを示す　×：定義が自動的に削除されることを示す　−：該当しない

表10‒29　J2EEサーバのserver.policyに自動的に追加される定義（アプリケーションサーバ Version 8からの移行）

追加される定義

旧バージョンでの環境条件

08-70

08-53

08-50

08-00

grant codeBase "file:${cosminexus.home}/jaxws/lib/*" {

permission java.security.AllPermission;

};

−

−

−

−

○

grant codeBase "file:${ejbserver.http.root}/ejb/${ejbserver.serverName}/rarjars/-" {

permission java.lang.RuntimePermission "getClassLoader";

permission java.lang.RuntimePermission "setContextClassLoader";

permission java.lang.RuntimePermission "accessDeclaredMembers";

};

−

−

−

○

○

grant codeBase

"file:${ejbserver.http.root}/web/${ejbserver.serverName}/-" {

permission javax.security.auth.AuthPermission "getSubject";

permission javax.security.auth.AuthPermission "createLoginContext.*";

};

−

−

○

○

○

grant codeBase

"file:${cosminexus.home}/manager/modules/-" {

permission java.io.FilePermission "<<ALL FILES>>", "read";

permission javax.security.auth.AuthPermission "modifyPrincipals";

permission javax.security.auth.AuthPermission "modifyPublicCredentials";

};

−

−

○

○

○

grant codeBase "file:${cosminexus.home}/common/lib/*" {

permission java.security.AllPermission;

};

−

○

○

○

○

grant codeBase "file:${ejbserver.install.root}/weld/lib/*" {

permission java.security.AllPermission;

};

−

○

○

○

○

grant codeBase "file:${cosminexus.home}/jaxrs/lib/*" {

permission java.security.AllPermission;

};

−

○

○

○

○

（凡例）　○：定義が自動的に追加されることを示す　−：該当しない

表10‒30　サーバ管理コマンドのusrconf.bat，またはusrconfに自動的に追加／変更／削除される定義（アプリケーションサーバ Version 8からの移行）

追加／変更／削除されるキーと値

旧バージョンでの環境条件

08-70

08-53

08-50

08-00

USRCONF_JVM_ARGS内の-XX:MetaspaceSize=<size>

<size>は-XX:PermSizeの指定値

-XX:PermSizeを指定している場合

○

○

○

○

USRCONF_JVM_ARGS内の-XX:MaxMetaspaceSize=<size>

<size>は-XX:MaxPermSizeの指定値

-XX:MaxPermSizeを指定している場合

○

○

○

○

（凡例）　○：定義が自動的に追加／変更されることを示す

10.13.2　移行コマンドで自動的に追加／変更／削除される定義（アプリケーションサーバ Version 9からの移行）

移行コマンド実行時に変更／削除されるキーと値を次の表に示します。

表10‒31　J2EEサーバのusrconf.cfgに自動的に追加／変更／削除される定義（アプリケーションサーバ Version 9からの移行）

追加／変更／削除されるキーと値

旧バージョンでの環境条件

09-60

09-50

09-00

add.jvm.arg=-XX:MetaspaceSize=<size>

<size>は-XX:PermSizeの指定値

-XX:PermSizeを指定している場合

○

○

○

add.jvm.arg=-XX:MaxMetaspaceSize=<size>

<size>は-XX:MaxPermSizeの指定値

-XX:MaxPermSizeを指定している場合

○

○

○

add.jvm.arg=-XX:+UseParNewGC

−

×

×

×

（凡例）　○：定義が自動的に追加／変更されることを示す　×：定義が自動的に削除されることを示す　−：該当しない

表10‒32　サーバ管理コマンドのusrconf.bat，またはusrconfに自動的に追加／変更／削除される定義（アプリケーションサーバ Version 9からの移行）

追加／変更／削除されるキーと値

旧バージョンでの環境条件

09-60

09-50

09-00

USRCONF_JVM_ARGS内の-XX:MetaspaceSize=<size>

<size>は-XX:PermSizeの指定値

-XX:PermSizeを指定している場合

○

○

○

USRCONF_JVM_ARGS内の-XX:MaxMetaspaceSize=<size>

<size>は-XX:MaxPermSizeの指定値

-XX:MaxPermSizeを指定している場合

○

○

○

（凡例）　○：定義が自動的に追加／変更されることを示す

表10‒33　J2EEサーバのusrconf.propertiesに自動的に追加される定義（アプリケーションサーバ Version 9からの移行）

追加／変更／削除されるキーと値

旧バージョンでの環境条件

09-87

09-70

ejbserver.rmi.remote.listener.port=0

ejbserver.rmi.remote.listener.portプロパティが存在しない場合

−

○

ejbserver.http.port=8080

ejbserver.http.portプロパティが存在しない場合

○

○

（凡例）　○：定義が自動的に追加／変更されることを示す　−：該当しない

10.13.3　移行コマンドで自動的に追加／変更／削除される定義（アプリケーションサーバ Version 11からの移行）

移行コマンド実行時に追加されるキーと値を次の表に示します。

表10‒34　J2EEサーバのusrconf.propertiesに自動的に追加される定義（アプリケーションサーバ Version 11からの移行）

追加されるキーと値

旧バージョンでの環境条件

11-10

11-00

ejbserver.javaee.cdi.webInfLibJarsEnabled=false

ejbserver.javaee.cdi.webInfLibJarsEnabledが存在しない場合

○

○

（凡例）　○：定義が自動的に追加／変更されることを示す

11　推奨機能への移行

この章では，アプリケーションサーバで従来サポートしている機能から推奨機能への移行について説明します。

11.1　HiRDB Type4 JDBC Driverを使用したデータベース接続への移行時の注意事項

DABroker Libraryを使用したデータベース接続からHiRDB Type4 JDBC Driverを使用したデータベース接続へ移行する場合，マニュアル「HiRDB UAP開発ガイド」のDABroker for Javaからの移行の説明を参照してださい。

11.2　DABroker LibraryからOracle JDBC Thin Driverを使用したデータベース接続への移行

DABroker LibraryとOracle JDBC Thin DriverのJDBCドライバには仕様差があります。そのため，Oracleへの接続方法をDABroker LibraryからOracle JDBC Thin Driverへ移行する場合，互換性を保つためにConnector属性ファイルのconfig-propertyタグに次のプロパティを設定してください。

appendZero

Connector属性ファイルでappendZeroプロパティをtrueに設定してください。

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

forceFixedString

Connector属性ファイルでforceFixedStringプロパティをtrueに設定してください。

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

12　アプリケーションサーバ09-87から11-20への移行

アプリケーションサーバ09-87から11-20への移行について説明します。

12.1　概要

アプリケーションサーバ 11-00では，Servlet 3.1やWebSocket 1.0などのJava EE 7の新仕様に対応しています。これによって，Java EE 7の仕様を前提とするHitachi Application Frameworkや他社製フレームワークに対応しています。

11-20ではJava EE 7/8の仕様に対応するため，09-87以前との互換性が保てない機能変更があります。この章では09-87から11-20へ移行する場合の，機能変更と移行方法について説明します。

12.2　09-87から11-20までの変更点

09-87から11-20までの変更点について説明します。

12.2.1　NIO HTTPサーバ機能

アプリケーションサーバ 11-20では，Servlet 3.0の非同期サーブレット，Servlet 3.1の非同期I/O API，WebSocket 1.1など，主にWebアプリケーションを非同期で処理する機能をサポートしています。これに伴い，従来の同期処理を前提としていた「リダイレクタによるWebサーバ連携機能」および「インプロセスHTTPサーバ機能」を刷新し，Java NIOの技術を用いて実装したインプロセスのHTTPサーバ機能である「NIO HTTPサーバ機能」を搭載しています。

アプリケーションサーバ 11-20では，NIO HTTPサーバ機能によるノンブロッキングI/Oを前提としているため，従来のリダイレクタ機能やインプロセスHTTPサーバ機能は使用できません。J2EEサーバ内のWebアプリケーションへのリクエストは，Webサーバを介する場合と直接J2EEサーバにアクセスする場合，NIO HTTPサーバ機能によるHTTP通信に一本化されます。

そのため，リダイレクタ機能やインプロセスHTTPサーバ機能に対するシステム設計を，NIO HTTPサーバ向けの設計に見直す必要があります。

詳細は，「12.4　システム設計の移行ガイド」を参照してください。

図12‒1　リダイレクタによるWebサーバ連携構成をアプリケーションサーバ 11-20に移行する場合

図12‒2　インプロセスHTTPサーバ構成をアプリケーションサーバ 11-20に移行する場合

12.2.2　Java EE 7/8新仕様対応

アプリケーションサーバ 11-20では，次のJava EEコンポーネントについてサポートバージョンやサポート範囲を変更しています。一部の仕様については，アプリケーション側で移行作業が必要です。該当する仕様をアプリケーション内で利用している場合は，各仕様の参照先を確認してください。

表12‒1　Java EE 7/8　標準仕様

仕様名

アプリケーションサーバでの

サポートバージョン

参照先

09-87

11-20

Java Servlet (Servlet)

3.0

4.0

12.3.2

Contexts and Dependency Injection for Java (CDI)

1.0

2.0

12.3.3

Java API for RESTful Web Services (JAX-RS)

1.1

2.1

12.3.4

Java Persistence API (JPA)

1.0

2.1

12.3.5

Java Server Faces (JSF)

2.1

2.3

12.3.6

JavaServer Pages (JSP)

2.1

2.3

移行不要

Expression Language (EL)

2.2

3.0

Bean Validation (BV)

1.0

2.0

Common Annotations for the Java Platform

(Common Annotations)

1.1

1.2

Java Transaction API (JTA)

1.1

1.2※1

Batch Applications for the Java Platform (JavaBatch)

−

1.0

Java API for JSON Processing (JSON-P)

−

1.1

Java API for JSON Binding (JSON-B)

−

1.0

Java API for WebSocket (WebSocket)

−

1.1

Concurrency Utilities for Java EE

−

1.0※2

Interceptors

1.1

1.2

注

アプリケーションサーバ 09-87から変更のない仕様については記載を省略しています。

注※1

09-87以前までの機能に加えて，@javax.transaction.Transactionalアノテーションをサポートします。

注※2

ContextService機能は使用できません。

12.2.3　V9互換モード

アプリケーションサーバ 11-20では，新機能は使用しないで09-87以前からの互換性を重視するシステム向けや，uCosminexus Service Platformのユーザ向けに，アプリケーションサーバの動作を09-87相当の仕様に戻す「V9互換モード」を提供しています。

V9互換モードについては，マニュアル「アプリケーションサーバ 機能解説 互換編」を参照してください。

なお，この章ではV9互換モードを使用しないユーザを前提に説明しています。

12.2.4　11-20で非サポートの機能

アプリケーションサーバ 11-20には，09-87からの移行をサポートしていない機能があります。なお，一部の機能を除き，V9互換モードでは使用できます。

(1)　非サポートのWebコンテナの機能

(a)　ラウンドロビン方式によるリクエストの振り分け

アプリケーションサーバ 11-20のWebサーバに内蔵されたプロキシモジュールでは，09-87のリダイレクタによるWebサーバ連携でサポートしていたラウンドロビン方式によるリクエストの振り分け（ロードバランサ）をサポートしていません。

ラウンドロビン方式によるリクエストの振り分けを実現するには，負荷分散機やロードバランサ機能を持つWebサーバが別途必要です。

(b)　POSTデータサイズでのリクエストの振り分け

アプリケーションサーバ 11-20のWebサーバに内蔵されたプロキシモジュールでは，09-87のリダイレクタによるWebサーバ連携でサポートしていた，POSTデータサイズでのリクエストの振り分けをサポートしていません。

POSTデータサイズによるリクエストの振り分けを実現するには，その機能を持つ負荷分散機やロードバランサ機能を持つWebサーバが別途必要です。

(c)　J2EEサーバによるゲートウェイ指定機能

アプリケーションサーバ 11-20のNIO HTTPサーバには，09-87のリダイレクタやインプロセスHTTPサーバで提供していた「ゲートウェイ指定機能」がありません。

URL転送の際にLocationヘッダに付与するURLとして，負荷分散機やSSLアクセラレータなど，ゲートウェイのURLをクライアントに返却する必要がある場合，負荷分散機やSSLアクセラレータの機能でLocationヘッダの書き換えなどの適切なゲートウェイのURLを返す設定をしてください。

(d)　Webコンテナ単位のエラーページのカスタマイズ機能

アプリケーションサーバ 11-20のNIO HTTPサーバには，09-87のリダイレクタやインプロセスHTTPサーバで提供していた「Webコンテナ単位のエラーページのカスタマイズ機能」がありません。

エラーステータスコードに応じたユーザ独自のエラーページをレスポンスとして返したい場合は，Servlet仕様に従ってアプリケーション単位で定義するか，またはWebサーバのリバースプロキシ機能を介したWebサーバ連携を構成し，Webサーバ側の機能を使用してエラーページをカスタマイズしてください。

(e)　有効なHTTPメソッドの制限機能

アプリケーションサーバ 11-20のNIO HTTPサーバには，09-87のインプロセスHTTPサーバで提供していた「有効なHTTPメソッドの制限機能」がありません。

有効なHTTPメソッドの制限が必要な場合は，Webサーバのリバースプロキシ機能を介したWebサーバ連携を構成し，Webサーバ側の機能を使用して有効なHTTPメソッドを制限してください。

(f)　リダイレクトによるリクエストの振り分け機能

アプリケーションサーバ 11-20のNIO HTTPサーバには，09-87のインプロセスHTTPサーバで提供していた「リダイレクトによるリクエストの振り分け機能」がありません。

URL単位でリダイレクトが必要な場合は，Webサーバのリバースプロキシ機能を介したWebサーバ連携を構成し，Webサーバ側の機能を使用してURLのリダイレクトをしてください。

(2)　非サポートの拡張機能

アプリケーションサーバ 11-20では，「EADsセッションフェイルオーバ機能」をサポートしていません。この機能は，V9互換モードでも使用できません。

(3)　非サポートの互換機能

アプリケーションサーバ 09-87以前から，前バージョンとの互換性のために残されていた次の互換機能は，アプリケーションサーバ 11-20では使用できません。これらの機能は，V9互換モードでも使用できません。

表12‒2　アプリケーションサーバ 11-20では非サポートの互換機能

分類

機能名

代替機能

互換機能

ベーシックモード

J2EEサーバを使用してください。

サーブレットエンジンモード

（Webコンテナサーバ）

J2EEサーバを使用してください。

簡易Webサーバ機能

NIO HTTPサーバ機能を使用してください。

詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発機能編(Webコンテナ)」の「7.　NIO HTTPサーバ」を参照してください。

EJBクライアントアプリケーションの

ログのサブディレクトリ専有モード

デフォルトのサブディレクトリ共有モードを使用してください。

メモリセッションフェイルオーバ機能

データベースセッションフェイルオーバ機能を使用してください。

詳細は，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「6.　データベースセッションフェイルオーバ機能」を参照してください。

複数の構築済み実行環境の切り替え

なし

J2EEアプリケーションのテスト機能

なし

JSP1.1仕様およびJSP1.2仕様に準拠したJSPソースのチェック

（cjjsp2java）

なし

論理サーバのアプリケーション管理のV7互換モード

なし

セキュリティ

管理機能

セッションフェイルオーバ機能を使用したログイン状態の引き継ぎ

データベースセッションフェイルオーバ機能を使用してください。

詳細は，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「6.　データベースセッションフェイルオーバ機能」を参照してください。

コマンド

Management Serverで使用するコマンド

（旧バージョンとの互換用のコマンド）

cmx_define_applicationコマンド

cmx_deploy_applicationコマンド

cmx_register_applicationコマンド

cmx_start_applicationコマンド

cmx_stop_applicationコマンド

cmx_undefine_applicationコマンド

cmx_undeploy_applicationコマンド

cmx_unregister_applicationコマンド

cmx_define_resourceコマンド

cmx_deploy_resourceコマンド

cmx_register_resourceコマンド

cmx_start_resourceコマンド

cmx_stop_resourceコマンド

cmx_undefine_resourceコマンド

cmx_undeploy_resourceコマンド

cmx_unregister_resourceコマンド

cmx_add_serverrefコマンド

cmx_delete_serverrefコマンド

J2EEサーバのコマンドを使用してください。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.　J2EEサーバで使用するコマンド」を参照してください。

12.3　アプリケーションの移行ガイド

ここでは，ユーザアプリケーションの移行手続きについて説明します。

12.3.1　代替機能への移行

アプリケーションサーバ 09-87で使用していた機能は，アプリケーションサーバ 11-20で動作させるために，代替機能への移行が必要な場合があります。次の表を確認して，必要な場合はアプリケーションを移行してください。表に記載されていない機能についてはアプリケーションサーバ 09-87と互換性があります。

表12‒3　アプリケーションの移行が必要な場合

機能

移行が必要な場合

参照先

Servlet

Servlet 3.0の非サポートAPIを使用していて，UnsupportedOperationException例外がスローされることを期待していた場合

12.3.2(1)

動的サーブレット定義APIを使用して，コンテキストルート（URLパターンが”/”）にマッピングするようにServletRegistrationのaddMappingメソッドを呼び出しているが，正常にマッピングされることを期待していなかった場合

12.3.2(2)

CDI

CDIのアノテーションをアプリケーション内で使用しているが，beans.xmlをアプリケーションアーカイブ内に格納していない状態で，CDIが動作することは期待していなかった場合

12.3.3(1)

Portable Extensionの実装クラスを持つライブラリをクラスパスに追加しているか，またはアプリケーション内に格納しているが，Portable Extensionが動作することを期待していなかった場合

12.3.3(2)

JAX-RS

Cosminexus JAX-RSエンジンを使用していた場合（「cjjaxrs.jar」をクラスパスに追加していた場合）

12.3.4(1)

Cosminexus JAX-RSエンジン独自のパラメタを使用していた場合

12.3.4(2)

Cosminexus JAX-RSエンジン独自のRESTful Webサービス用クライアントAPIを使用していた場合

12.3.4(3)

JPA

CJPAプロバイダ独自のパラメタを使用していた場合

（「cosminexus.jpa」から始まる名称のユーザプロパティ，またはpersistence.xmlの<property>タグ指定値）

12.3.5(1)

永続化先データベースにHiRDB以外を使用していた場合

12.3.5(2)

JSF

JSFを使用していた場合（「cjsf.jar」をクラスパスに追加していた場合）

12.3.6(1)

12.3.2　Servletの変更点

(1)　Servlet 3.0の非サポートAPIの扱い

アプリケーションサーバ 11-20では，09-87で非サポートだった一部のServlet 3.0 APIがサポート対象になっています。そのため，アプリケーションサーバ 09-87では該当するAPIを使用するとUnsupportedOperationException例外がスローされる仕様となっていましたが，アプリケーションサーバ 11-20ではServlet 3.0仕様に従って動作します。

該当するAPIを次の表に示します。もし，これらのAPIから常にUnsupportedOperationException例外がスローされることを期待しているアプリケーションだった場合は，例外がスローされない前提の実装となるようにアプリケーションの改修が必要です。

表12‒4　アプリケーションサーバ 11-20からサポートされるようになったServlet 3.0 API

パッケージ

クラス

メソッド

javax.servlet

AsyncContext

すべてのメソッド

AsyncListener

すべてのメソッド

ServletRequest

startAsync

isAsyncStarted

isAsyncSupported

getAsyncContext

getDispatcherType

AsyncEvent

すべてのメソッド

ServletRequestWrapper

startAsync

isAsyncStarted

isAsyncSupported

getAsyncContext

getDispatcherType

Registration

setAsyncSupported

また，アプリケーションサーバ 11-20で引き続き非サポートとなるAPIについても，アプリケーションサーバ 09-87ではUnsupportedOperationException例外がスローされていましたが，アプリケーションサーバ 11-20ではデフォルトでは例外がスローされません。該当するAPIを次の表に示します。

表12‒5　アプリケーションサーバ 11-20でも非サポートのServlet 3.0 API

パッケージ

クラス

メソッド

webserver.servlet_api.unsupported.throwUnsupportedOperationExceptionの指定値に対する動作

false（デフォルト）

true

javax.servlet

ServletContext

getJspConfigDescriptor

nullが返ります

UnsupportedOperationException例外がスローされます

もし，これらのAPIから常にUnsupportedOperationException例外がスローされることを期待しているアプリケーションだった場合は，例外がスローされない前提の実装となるようにアプリケーションを改修するか，または次の定義をJ2EEサーバ用ユーザプロパティに追加してください。

webserver.servlet_api.unsupported.throwUnsupportedOperationException=true

(2)　コンテキストルートにマッピングする動的サーブレット追加処理について

アプリケーションサーバ 09-87では，javax.servlet.ServletRegistrationのaddMappingメソッドの引数にコンテキストルートを示す”/”を指定した場合，すでにデフォルトサーブレットがマッピング済みであるためにマッピングの上書きができませんでした。

アプリケーションサーバ 11-20では，同一ServletContextに対して1度だけ，コンテキストルートに対するマッピングを上書きできます。これによって，デフォルトサーブレットの代わりにユーザ定義サーブレットをコンテキストルートにマッピングできます。

もし，アプリケーションサーバ 11-20の動作を期待しておらず，addMappingメソッドがマッピングの上書きを拒否することを期待しているアプリケーションだった場合，コンテキストルートにマッピングするaddMappingメソッドの呼び出しをしないようにアプリケーションの改修が必要です。アプリケーションを改修しないでアプリケーションサーバ 11-20に移行すると，デフォルトサーブレットへのマッピングがユーザサーブレットへのマッピングに上書きされるおそれがあります。

12.3.3　CDIの変更点

(1)　beans.xml省略時のCDI有効／無効判定条件の変更

アプリケーションサーバ 11-20では，beans.xmlファイルの扱いとCDI有効／無効の判定条件はCDI 2.0仕様に従います。

CDI 1.2以降の仕様では，beans.xmlが格納されていないアプリケーションアーカイブであっても，CDIのアノテーションが使用されていると判定されると自動的にCDIが有効化されます。そのため，アプリケーションサーバ 09-87でデプロイできていたアプリケーションであっても，CDIが有効になることが想定されていないアプリケーションの場合は，アプリケーションサーバ 11-20ではデプロイに失敗するおそれがあります。

CDI 1.2以降の仕様では，そのような事態を避けるためにCDI 1.0基準の判定条件に戻すオプションを提供するよう規定されています。アプリケーションサーバ 11-20でもそのオプションを提供しています。CDI有効／無効の判定条件をCDI 1.0基準に戻すには，次の定義をJ2EEサーバ用ユーザプロパティに追加してください。

ejbserver.javaee.cdi.beansXmlRequired=true

(2)　Portable Extension APIの扱いの変更

アプリケーションサーバ 09-87ではCDIのPortable Extension APIは非サポートとなっていて，Portable Extensionの実装クラスがクラスパス内に存在していても無視されていました。

アプリケーションサーバ 11-20でもユーザアプリケーションによるPortable Extension APIの使用は引き続き非サポートとなりますが，製品内部でCDIのPortable Extension APIを使用するためPortable Extensionの実装クラスが動作します。

Portable Extensionの実装クラス（javax.enterprise.inject.spi.Extensionインタフェースを実装したクラス）とそのサービス定義ファイル（META-INF/services/javax.enterprise.inject.spi.Extensionファイル）が格納されたJARファイルは，J2EEサーバのクラスパスに追加したり，アプリケーション内に格納したりしないでください。Portable Extensionの実装クラスが動作して，アプリケーションのデプロイに失敗したり，アプリケーションの動作が変わったりするおそれがあります。

12.3.4　JAX-RSの変更点

(1)　JAX-RSエンジンの変更

アプリケーションサーバ 11-20では，JAX-RS 2.1をサポートするJAX-RS 2.1エンジンを提供しています。従来のアプリケーションサーバ 09-87以前のJAX-RSエンジンとは異なるJARファイルに格納されているため，JAX-RSエンジンを利用するために必要なクラスパスの設定が変わります。

アプリケーションサーバ 09-87以前の場合

add.class.path=<cosminexus.home>¥jaxrs¥lib¥cjjaxrs.jar

アプリケーションサーバ 11-20の場合

add.class.path=<cosminexus.home>¥CC¥javaee¥1100¥lib¥jaxrs-impl.jar
add.class.path=<cosminexus.home>¥CC¥javaee¥1100¥lib¥jaxrs-jackson.jar

アプリケーションサーバ 09-87以前のJAX-RSエンジン（cjjaxrs.jar）がクラスパスに入ったままになっている場合，アプリケーションが正常に動作しなくなるため，必ずクラスパスの設定を見直してください。

(2)　JAX-RSエンジンのCosminexus独自パラメタの廃止

アプリケーションサーバ 11-20のJAX-RS 2.1エンジンは，アプリケーションサーバ 09-87以前のJAX-RSエンジンでサポートしていたCosminexus独自定義ファイルや独自パラメタをサポートしていません。マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「13.1　動作定義ファイル」に記載されている定義ファイルやパラメタはアプリケーションサーバ 11-20では使用できません。

(3)　RESTful Webサービス用クライアントAPIの廃止

JAX-RS 2.0仕様では，新たにクライアントAPIが標準化されました。これに伴い，アプリケーションサーバ 09-87以前のJAX-RSエンジンでサポートしていたCosminexus独自のRESTful Webサービス用クライアントAPIをサポートしていません。マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「25.　RESTful Webサービス用クライアントAPIのサポート範囲」に記載されている機能は，アプリケーションサーバ 11-20では使用できません。

JAX-RSのクライアントAPIを使用するアプリケーションについては，JAX-RS 2.0仕様書およびJAX-RS 2.0 API仕様に従い，JAX-RS 2.0標準APIに置き換えてください。

JAX-RS 2.0 API仕様 (Oracle社提供)

https://docs.oracle.com/javaee/7/api/javax/ws/rs/client/package-summary.html

12.3.5　JPAの変更点

(1)　CJPAプロバイダの廃止

従来のCJPAプロバイダは，JPA 2.2 APIに対応していないため使用できません。代わりに，アプリケーションサーバ 11-20では，JPA 2.2をサポートするJPAプロバイダを新たに提供しています。しかし，従来のCJPAプロバイダで提供していたCosminexus独自機能は使用できません。次に示すパラメタは，指定されていても無視されます。

persistence.xmlの<property>タグに指定する「cosminexus.jpa」で始まるプロパティ

J2EEサーバ用ユーザプロパティファイルに指定する「cosminexus.jpa」で始まるキー

Smart Composer機能で論理J2EEサーバに指定する「cosminexus.jpa」で始まるパラメタ

(2)　永続化先としてサポートされるデータベースの変更

アプリケーションサーバ 11-20のJPA 2.2サポート範囲では，永続化先として使用可能なデータベースは次の製品です。

HiRDB

Oracle

それ以外のデータベースへの永続化が必要な場合は，JPA 2.2と永続化先データベースに対応したJPAプロバイダライブラリ※を用意し，CosminexusのJPA 2.2プロバイダの代わりにクラスパスに追加して使用してください。

注※

EclipseLink，Hibernate JPAなど

12.3.6　JSFの変更点

(1)　JSFライブラリの変更

アプリケーションサーバ 11-20では，JSF 2.3をサポートします。JSF 2.3用ライブラリは，従来のアプリケーションサーバ 09-87以前のJSF 2.1用ライブラリとは異なるJARファイルに格納され，デフォルトでクラスパスに追加されています。そのため，JSFを利用するとき，次のクラスパスを追加する必要はなくなりました。

アプリケーションサーバ 09-87以前の場合

add.class.path=<cosminexus.home>¥CC¥lib¥cjsf.jar
add.class.path=<cosminexus.home>¥CC¥lib¥cjstl.jar

アプリケーションサーバ 11-20の場合

クラスパスの追加は不要です。

アプリケーションサーバ 09-87以前のJSF 2.1用ライブラリ（cjsf.jar）がクラスパスに入ったままになっている場合，アプリケーションが正常に動作しなくなるため，必ずクラスパスの設定を見直してください。

12.4　システム設計の移行ガイド

この節では，チューニングパラメタやリソース見積もり式などのシステム設計の変更点について説明します。

なお，各パラメタの単位，デフォルト値，指定可能範囲などについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

12.4.1　パフォーマンスチューニング

アプリケーションサーバ 11-20では，J2EEアプリケーション実行基盤のパフォーマンスチューニングの観点のうち，次の観点が09-87以前と異なります。

同時実行数の最適化

タイムアウトの設定

(1)　同時実行数の最適化

アプリケーションサーバ 09-87以前では，Webコンテナのリクエスト処理スレッドは1つのコネクションに対して必ず1つのスレッドが割り当てられ，クライアントにレスポンス本文を送信し終えるまでリクエスト処理スレッドを占有していました。

アプリケーションサーバ 11-20では，Servlet 3.0の非同期サーブレットやServlet 3.1の非同期I/O API，WebSocketなどのノンブロッキングI/Oを前提とする標準仕様をサポートするため，リクエストを受けるコネクションの管理と，受け付けたリクエストを処理するスレッドの管理を分離し，1つのコネクションが複数の処理スレッドを使用することや，リクエストの受付処理とレスポンスの送信処理を別々のスレッドに処理させることができます。

これに伴い，アプリケーションサーバ 11-20では，09-87以前の同時実行数制御の考え方とは異なる部分があります。以降では，Webサーバの構成ごとに同時実行数制御の設定ポイントの相違点を説明します。

(a)　リダイレクタによるWebサーバ連携構成から移行する場合

アプリケーションサーバ 09-87以前で使用していたリダイレクタ機能では，WebサーバとWebコンテナ間を常設コネクションで接続し，Webコンテナ側では1つのコネクションごとに1つのリクエスト処理スレッドを占有していました。そのため，生成されるスレッド数は同時接続可能な最大コネクション数と常に同じ値になります。また，同時実行スレッド数制御によって，生成されたスレッドのうち同時に実行が可能なスレッドを制御することで，パフォーマンスの低下やリソースの枯渇を抑制できました。アプリケーションサーバ 09-87のスレッド数制御の仕組みを次の図に示します。

図12‒3　アプリケーションサーバ 09-87のスレッド数制御の仕組み（Webサーバ連携の場合）

アプリケーションサーバ 11-20のNIO HTTPサーバ機能では，WebサーバとWebコンテナ間を常設コネクションで接続しても，Webコンテナ側のリクエスト処理スレッドはコネクションに占有されることはありません。Webコンテナ側がデータの受信を検知するたびにスレッドプールからスレッドを割り当てて処理します。また，同時実行スレッド数制御によって，サーブレットのリクエスト処理要求に対して割り当てられたスレッドのうち同時に実行できるスレッドを制御することで，アプリケーションサーバ 09-87と同様にパフォーマンスの低下やリソースの枯渇を抑制できます。アプリケーションサーバ 11-20のスレッド数制御の仕組みを次の図に示します。

図12‒4　アプリケーションサーバ 11-20のスレッド数制御の仕組み（Webサーバ連携の場合）

NIO HTTPサーバ機能では，J2EEサーバ起動時にスレッドプールにあらかじめ生成しておくスレッド数と，動的に生成する最大スレッド数を定義できます。Webサーバ連携構成のアプリケーションサーバ 09-87から移行する場合に推奨されるスレッド数の設定値を次の表に示します。ただし，WebSocket機能を使用する場合はこの限りではありません。詳細は「12.4.1(1)(c)　WebSocket機能を使用するために最大同時接続数を増やす場合の注意点」を参照してください。

表12‒6　推奨される同時実行数設定値（Webサーバ連携構成からの移行の場合）

設定先のNIO HTTPサーバのパラメタ

推奨される設定値

アプリケーションサーバ 09-87以前の機能だけを使用する場合

アプリケーションサーバ 11-20でサポートされている非同期処理を使用する場合

webserver.connector.nio_http.max_threads

webserver.connector.ajp13.max_threadsと同じ値

webserver.connector.ajp13.max_threadsの値

＋コネクション数を超えて同時実行される非同期処理※¹の最大同時実行数

webserver.connector.nio_http.min_threads

webserver.connector.ajp13.max_threadsと同じ値

webserver.connector.nio_http.max_connections

J2EEサーバに接続するコネクション数の総和※2

注※1

「コネクション数を超えて同時実行される非同期処理」に含まれるものは次のとおりです。

Servlet 3.0のjavax.servlet.AsyncContextのstartメソッドの呼び出し

WebSocketのjavax.websocket.RemoteEndpoint.AsyncインタフェースのsendBinaryメソッド，sendObjectメソッド，sendTextメソッドの呼び出し

注※2

「J2EEサーバに接続するコネクション数の総和」は，J2EEサーバのNIO HTTPサーバに接続する接続数の総和です。複数のプロセスからJ2EEサーバに接続する場合，各プロセスからの最大接続数の総和を設定してください。

なお，Cosminexus HTTP ServerのリバースプロキシからJ2EEサーバへの最大接続数は，マニュアル「HTTP Server」の「4.7.4(5)　性能に関する注意事項」を参照してください。

(b)　インプロセスHTTPサーバ構成から移行する場合

アプリケーションサーバ 09-87以前で使用していたインプロセスHTTPサーバ機能では，クライアントから接続要求があるたびに，スレッドプールにあらかじめ生成しておいたスレッドをコネクションごとに割り当て，クライアントとの接続が切れるまでそのスレッドを占有していました。また，同時実行スレッド数制御によって，生成されたスレッドのうち同時に実行できるスレッドを制御することで，パフォーマンスの低下やリソースの枯渇を抑制できました。

アプリケーションサーバ 11-20のNIO HTTPサーバ機能では，Webコンテナ側のリクエスト処理スレッドはコネクションに占有されることなく，Webコンテナ側がデータの受信を検知するたびにスレッドプールからスレッドを割り当てて処理します。また，同時実行スレッド数制御によって，サーブレットのリクエスト処理要求に対して割り当てられたスレッドのうち同時に実行できるスレッドを制御することで，アプリケーションサーバ 09-87と同様にパフォーマンスの低下やリソースの枯渇を抑制できます。

NIO HTTPサーバ機能では，J2EEサーバ起動時にスレッドプールにあらかじめ生成しておくスレッド数と，動的に生成する最大スレッド数を定義できます。インプロセスHTTPサーバ構成のアプリケーションサーバ 09-87から移行する場合に推奨されるスレッド数の設定値を次の表に示します。ただし，WebSocket機能を使用する場合はこの限りではありません。詳細は「12.4.1(1)(c)　WebSocket機能を使用するために最大同時接続数を増やす場合の注意点」を参照してください。

表12‒7　推奨される同時実行数設定値（インプロセスHTTPサーバ構成からの移行の場合）

設定先のNIO HTTPサーバのパラメタ

アプリケーションサーバ 11-20で推奨される設定値

アプリケーションサーバ 09-87以前の機能だけを使用する場合

アプリケーションサーバ 11-20でサポートされた非同期処理を使用する場合

webserver.connector.nio_http.max_threads

webserver.connector.inprocess_http.max_connectionsと同値

webserver.connector.inprocess_http.max_connectionsの値

＋コネクション数を超えて同時実行される非同期処理※の最大同時実行数

webserver.connector.nio_http.min_threads

webserver.connector.inprocess_http.max_connectionsまたは

webserver.connector.inprocess_http.max_spare_threadsまたは

webserver.connector.inprocess_http.init_threadsのうち

最も小さい方の値

webserver.connector.nio_http.max_connections

webserver.connector.inprocess_http.max_connectionsと同じ値

注※

「コネクション数を超えて同時実行される非同期処理」に含まれるものは次のとおりです。

Servlet 3.0のjavax.servlet.AsyncContextのstartメソッドの呼び出し

WebSocketのjavax.websocket.RemoteEndpoint.AsyncインタフェースのsendBinaryメソッド，sendObjectメソッド，sendTextメソッドの呼び出し

(c)　WebSocket機能を使用するために最大同時接続数を増やす場合の注意点

アプリケーションサーバ 11-20のNIO HTTPサーバ機能では，スレッド数と最大同時接続数は必ずしも同じ値である必要はありません。同時接続数に対してスレッド数が少ない場合でも，データの受信処理を同時に行う最大同時実行数が最大スレッド数以内であれば実行待ちは発生しません。また，スレッドが割り当てできないで実行待ちが発生した場合でも，無限長の実行待ちキューにキューイングされるので，スレッドに空きができればデータの受信処理が再開されます。

アプリケーションサーバ 11-20のWebSocket機能を使用する場合，多数のWebSocketクライアントとの接続を長時間維持するために最大同時接続数を増やす必要が生じることがあります。アプリケーションサーバ 09-87以前はCosminexus HTTP ServerとインプロセスHTTPサーバともに，最大同時接続数の上限を「1024」としていましたが，アプリケーションサーバ 11-20ではWebSocketを考慮して上限値が09-87以前より大きくなっています。

しかし，最大同時接続数に合わせてNIO HTTPサーバの最大スレッド数を増やすと，スレッド数に比例してメモリ使用量も増加します。また，1つのプロセスが生成できるスレッド数はOSによって上限があります。最小スレッド数に対して確保できるメモリ容量やOSのスレッド数上限が不足している場合は，J2EEサーバの起動処理中にOutOfMemoryErrorが発生してJ2EEサーバの起動に失敗するおそれがあります。最大スレッド数に対して確保できるメモリ容量やOSのスレッド数上限が不足している場合は，リクエスト受付処理中にOutOfMemoryErrorが発生してJ2EEサーバがプロセスダウンするおそれがあります。

もし，NIO HTTPサーバの最小スレッド数や最大スレッド数を増やす場合には，メモリサイズ（物理メモリのサイズ，J2EEサーバプロセスの-Xmx指定値）も適切に再見積もりしてください。

最大スレッド数の見積もり方法についてはマニュアル「アプリケーションサーバ システム設計ガイド」の「5.2.1　J2EEサーバが使用するリソースの見積もり」を参照してください。メモリ使用量については，マニュアル「アプリケーションサーバ システム設計ガイド」の「5.3.1　J2EEサーバが使用する仮想メモリの使用量の見積もり」を参照してください。

(2)　タイムアウトの設定

アプリケーションサーバ 11-20では，タイムアウトの発生個所とタイムアウト値の設定パラメタがアプリケーションサーバ 09-87以前と異なります。以降では，Webサーバの構成ごとにタイムアウトの設定ポイントの相違点を説明します。

(a)　リダイレクタによるWebサーバ連携構成から移行する場合

アプリケーションサーバ 11-20では，リダイレクタモジュール（mod_jk）をプロキシモジュール（mod_proxy）に，Webコンテナ側のリクエストの受け口がNIO HTTPサーバになっています。

そのため，アプリケーションサーバ 09-87でリダイレクタとWebコンテナに設定していたタイムアウトは，アプリケーションサーバ 11-20ではリバースプロキシとNIO HTTPサーバに設定するタイムアウトに変わります。

アプリケーションサーバ 09-87でタイムアウトが設定できるポイントについて，次の図に示します。

図12‒5　アプリケーションサーバ 09-87でタイムアウトが設定できるポイント（Webサーバ連携の場合）

アプリケーションサーバ 11-20でタイムアウトが設定できるポイントについて，次の図に示します。

図12‒6　アプリケーションサーバ 11-20でタイムアウトが設定できるポイント（Webサーバ連携の場合）

アプリケーションサーバ 09-87からアプリケーションサーバ 11-20への移行が必要なポイントについて，それぞれの相違点を次の表に示します。

表12‒8　各ポイントに設定するタイムアウトの相違点（Webサーバ連携構成からの移行）

ポイント

タイムアウトの種類

アプリケーションサーバ 09-87

アプリケーションサーバ 11-20

2

リダイレクタ側で設定するWebコンテナへのコネクション確立のタイムアウト。

設定対象

mod_jk.conf （リダイレクタ動作定義ファイル）

論理Webサーバ（web-server）

設定個所

JkConnectTimeout

リバースプロキシ側で設定するWebコンテナ（NIO HTTPサーバ）へのコネクション確立のタイムアウト。

設定対象

httpsd.conf

論理Webサーバ（web-server）

設定個所

ProxyPassのconnectiontimeoutキー，

ProxyPassのtimeoutキー，

またはTimeout

3

リダイレクタ側で設定するWebコンテナへのリクエストヘッダおよびリクエストボディ送信のタイムアウト。

設定対象

mod_jk.conf （リダイレクタ動作定義ファイル）

論理Webサーバ（web-server）

設定個所

JkSendTimeout

リバースプロキシ側で設定するWebコンテナ（NIO HTTPサーバ）へのリクエストヘッダおよびリクエストボディ送信のタイムアウト。

設定対象

httpsd.conf

論理Webサーバ（web-server）

設定個所

ProxyPassのtimeoutキー，またはTimeout

4

リダイレクタ側で設定するWebコンテナからのデータ受信のタイムアウト。

設定対象

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

論理Webサーバ（web-server）

設定個所

worker.<ワーカ名>.receive_timeout

リバースプロキシ側で設定するWebコンテナ（NIO HTTPサーバ）からのデータ受信のタイムアウト。

設定対象

httpsd.conf

論理Webサーバ（web-server）

設定個所

ProxyPassのtimeoutキー，またはTimeout

5

Webコンテナ側で設定するリダイレクタからのデータ受信のタイムアウト。

設定対象

usrconf.properties（J2EEサーバ用ユーザプロパティ）

論理J2EEサーバ（j2ee-server）

設定個所

webserver.connector.ajp13.receive_timeout

Webコンテナ（NIO HTTPサーバ）側で設定するリバースプロキシからのデータ受信のタイムアウト。

設定対象

usrconf.properties（J2EEサーバ用ユーザプロパティ）

論理J2EEサーバ（j2ee-server）

設定個所

webserver.connector.nio_http.receive_timeout

13

Webコンテナ側で設定するリダイレクタへのレスポンス送信のタイムアウト。

設定対象

usrconf.properties（J2EEサーバ用ユーザプロパティ）

論理J2EEサーバ（j2ee-server）

設定個所

webserver.connector.ajp13.send_timeout

Webコンテナ（NIO HTTPサーバ）側で設定するリバースプロキシへのデータ送信のタイムアウト。

設定対象

usrconf.properties（J2EEサーバ用ユーザプロパティ）

論理J2EEサーバ（j2ee-server）

設定個所

webserver.connector.nio_http.send_timeout

(b)　インプロセスHTTPサーバ構成から移行する場合

アプリケーションサーバ 11-20では，09-87のインプロセスHTTPサーバがNIO HTTPサーバになります。

そのため，アプリケーションサーバ 09-87でインプロセスHTTPサーバに設定していたタイムアウトは，アプリケーションサーバ 11-20ではNIO HTTPサーバに設定するタイムアウトに変わります。

タイムアウトが設定できるポイントについて，次の図に示します。

図12‒7　タイムアウトが設定できるポイント（インプロセスHTTPサーバの場合）

アプリケーションサーバ 09-87からアプリケーションサーバ 11-20への移行が必要なポイントについて，それぞれの相違点を次の表に示します。

表12‒9　各ポイントに設定するタイムアウトの相違点（インプロセスHTTPサーバ構成からの移行）

ポイント

タイムアウトの種類

アプリケーションサーバ 09-87

アプリケーションサーバ 11-20

5

Webコンテナ側で設定するクライアントからのリクエスト受信のタイムアウト。

設定対象

usrconf.properties（J2EEサーバ用ユーザプロパティ）

論理J2EEサーバ（j2ee-server）

設定個所

webserver.connector.inprocess_http.receive_timeout

NIO HTTPサーバ側で設定するクライアントからのデータ受信のタイムアウト。

設定対象

usrconf.properties（J2EEサーバ用ユーザプロパティ）

論理J2EEサーバ（j2ee-server）

設定個所

webserver.connector.nio_http.receive_timeout

13

Webコンテナ側で設定するクライアントへのレスポンス送信のタイムアウト。

設定対象

usrconf.properties（J2EEサーバ用ユーザプロパティ）

論理J2EEサーバ（j2ee-server）

設定個所

webserver.connector.inprocess_http.send_timeout

NIO HTTPサーバ側で設定するクライアントへのデータ送信のタイムアウト。

設定対象

usrconf.properties（J2EEサーバ用ユーザプロパティ）

論理J2EEサーバ（j2ee-server）

設定個所

webserver.connector.nio_http.send_timeout

12.4.2　使用するリソースの見積もり

アプリケーションサーバ 11-20では，J2EEアプリケーション実行基盤の使用するリソースの見積もり式のうち，次の見積もり式が09-87以前と異なります。

J2EEサーバが使用するリソースの見積もり

(1)　J2EEサーバが使用するリソースの見積もり

アプリケーションサーバ 11-20では，インプロセスHTTPサーバがNIO HTTPサーバ機能に代わったことや，非同期処理をする機能が加わったことによって，J2EEサーバプロセスのスレッド数とファイルディスクリプタ数が09-87以前と異なります。

詳細は，マニュアル「アプリケーションサーバ システム設計ガイド」の「5.2.1　J2EEサーバが使用するリソースの見積もり」を参照してください。

12.5　システム保守情報の移行ガイド

この節では，ログや性能解析トレースなどの保守情報の扱いについて，アプリケーションサーバ 09-87からの変更点を説明します。

12.5.1　出力先ログファイルの変更点

アプリケーションサーバ 11-20では，一部の保守情報について出力先ログファイルが09-87以前と異なります。

表12‒10　保守情報出力先の変更点

出力元

分類

出力先

アプリケーションサーバ 09-87

アプリケーションサーバ 11-20

J2EE

サーバ

インプロセスHTTPサーバ／NIO HTTPサーバのアクセスログ

<ejb.server.log.directory>¥http¥cjhttp_access.inprocess_http[n].log

<ejb.server.log.directory>¥cj_access_niohttp[n].log

WebSocketアクセスログ

−

<ejb.server.log.directory>¥cj_access_websocket[n].log

開発調査ログ

<ejb.server.log.directory>¥cjdevelopment[n].log

導入母体ログ出力機能によって，同等の内容がメッセージログと例外ログに出力されます。

リダイレクタ

リダイレクタのメッセージログ

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

またはJkLogFileDirの指定値

廃止

リダイレクタの保守用トレースログ

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

またはJkLogFileDirの指定値

廃止

12.5.2　アクセスログの変更点

アプリケーションサーバ 11-20のNIO HTTPサーバ機能には，従来のインプロセスHTTPサーバのアクセスログに相当するアクセスログ出力機能があります。アクセスログの設定先プロパティの変更点を次の表に示します。

表12‒11　NIO HTTPサーバのアクセスログに対するプロパティ推奨値

設定項目

アプリケーションサーバ 09-87のプロパティ名

アプリケーションサーバ 11-20のプロパティ名

アプリケーションサーバ 11-20の推奨値

最大ファイルサイズ

webserver.logger.access_log.inprocess_http.filenum

ejbserver.logger.channels.define.NIOHTTPAccessLogFile.filenum

アプリケーションサーバ 09-87と同じ値

最大面数

webserver.logger.access_log.inprocess_http.filesize

ejbserver.logger.channels.define.NIOHTTPAccessLogFile.filesize

アプリケーションサーバ 09-87と同じ値

フォーマット

webserver.logger.access_log.<フォーマット名>

ejbserver.logger.access_log.nio_http.format

デフォルト値＋

個別に指定していたフォーマット引数

12.5.3　性能解析トレースのトレース取得ポイントの変更点

アプリケーションサーバ 11-20では，性能解析トレースの一部の取得ポイントが09-87以前と異なります。09-87で性能解析トレース機能を使用していた場合は，次の表に従ってイベントIDを読み替えてください。

表12‒12　性能解析トレースのトレース取得ポイントの変更点

出力元

トレース取得ポイント

イベントID

レベル

アプリケーションサーバ 09-87

アプリケーションサーバ 11-20

Webコンテナ

（Webサーバ連携）

リクエスト取得・リクエストヘッダ解析完了直後

0x8200

0x8236

A

リクエスト処理完了直後

0x8300

0x8336

A

Webコンテナ

（インプロセスHTTPサーバ）

リクエスト取得時／リクエストヘッダ解析完了直後

0x8211

0x8236※1

A／B

リクエスト処理完了直後

0x8311

0x8336※1

A／B

Webクライアントからのデータ読み込み開始直前

0x8212

0x8237

B

Webクライアントからのデータ読み込み完了直後

0x8312

0x8337

B

Webクライアントへのデータ書き込み開始直前

0x8213

0x8238

B

Webクライアントへのデータ書き込み完了直後

0x8313

0x8338

B

リダイレクタ

すべての取得ポイント

0x8000〜0x8104

廃止※2

A／B

注※1

アプリケーションサーバ 09-87ではレベルBの場合はレベルAより詳細な情報が出力されましたが，アプリケーションサーバ 11-20ではレベルAとレベルBとで出力内容は同じです。

注※2

HTTP Serverのアクセスログやリクエストログにルートアプリケーション情報が出力されますので，それらのログと突き合わせることで代替してください。

12.5.4　メッセージの変更点

アプリケーションサーバ 11-20では，メッセージログに出力されるメッセージIDや内容が09-87以前と異なります。同等の条件で出力されるアプリケーションサーバ 11-20のメッセージIDを次の表に示します。09-87で該当するメッセージを監視していた場合は，次の表に従ってメッセージIDを読み替えてください。

表12‒13　メッセージIDの変更点

出力元

アプリケーションサーバ 09-87でのメッセージ

アプリケーションサーバ 11-20の読み替え先ID

ログ

レベル

ID

内容

Webコンテナ

KDJE39236-I

Webサーバ連携を開始します。

なし

Error

KDJE39237-I

インプロセスHTTPサーバを開始します。Webサーバ連携機能は無効となります。

KDJE39562-I

Error

KDJE39238-W

webserver.connector.inprocess_http.permitted.hostsに指定されたホスト名は，名前解決できませんでした。

KDJE39563-W

Error

KDJE39239-W

インプロセスHTTPサーバへのアクセスを許可されていないホストからのアクセスが拒否されました。

KDJE39564-W

Error

KDJE39240-W

webserver.connector.inprocess_http.bind_hostに指定されたホスト（{0}）は解決できませんでした。

KDJE39565-W

Error

KDJE39241-E

インプロセスHTTPサーバを指定されたポート番号（{0}）で起動できませんでした。

KDJE39566-E

Error

KDJE39242-W

webserver.connector.inprocess_http.bind_hostに指定されたホスト（{0}）は解決できませんでした。

KDJE39567-W

Error

KDJE39243-E

送信されたリクエストのHTTPメソッドは許可されていません。

なし

Error

KDJE39244-E

送信されたリクエストのリクエストラインが最大サイズを超えています。

なし

Error

KDJE39245-E

送信されたリクエストのリクエストヘッダが最大サイズを超えています。

KDJE39568-E

Error

KDJE39246-E

送信されたリクエストのリクエストボディが最大サイズを超えています。

KDJE39569-E

Error

KDJE39247-E

送信されたリクエストに含まれるHTTPヘッダの数が最大数を超えています。

KDJE39570-E

Error

KDJE39256-W

リダイレクト機能のレスポンスボディとして送信するファイルの読み込みができませんでした。

なし

Error

KDJE39257-E

リダイレクト機能のレスポンスボディとして送信するファイルの読み込み中にエラーが発生しました。

なし

Error

KDJE39258-W

リダイレクト機能のレスポンスボディを送信中にエラーが発生しました。

なし

Information

KDJE39259-W

ファイルの読み込みができないため，エラーコンテンツカスタマイズ機能のレスポンスボディとして送信するファイルはクライアントに送信されませんでした。

なし

Error

KDJE39260-E

エラーコンテンツカスタマイズ機能のレスポンスボディとして送信するファイルの読み込み中にエラーが発生しました。

なし

Error

KDJE39261-W

エラーコンテンツカスタマイズ機能のレスポンスボディを送信中にエラーが発生しました。

なし

Information

KDJE39262-E

Webクライアントとの接続数が上限を超えたため，リクエスト処理を拒否します。

なし

Error

KDJE39263-W

リクエスト処理スレッドが不足しています。

なし

Error

KDJE39265-E

クライアントからのリクエストヘッダ読み込み中にタイムアウトが発生しました。

KDJE39576-E

Warning

KDJE39267-W

アクセスされたリクエストを拒否しました。 インプロセスHTTPサーバでは，"/ejb/"または"/web/"で始まるリクエストは使えません。

KDJE39571-W

Error

KDJE39268-E

リダイレクト機能のレスポンスボディとして送信するファイルの読み込みができませんでした。

なし

Error

KDJE39269-E

HTTPリクエストのボディ情報が大き過ぎるため，インプロセスHTTPサーバはアクセスされたリクエストを拒否しました。

なし

Error

KDJE39270-W

レスポンスがコミット済みのため，エラーページのカスタマイズを行えませんでした。

なし

Error

KDJE39274-E

クライアントとのコネクション確立時に障害が発生しました。

KDJE39572-E

Error

KDJE39276-W

クライアントとのコネクション確立時に障害が発生しましたが，クライアントとのコネクション確立に成功しました。

KDJE39573-W

Error

KDJE39277-E

不正なリクエストヘッダを受信したため，インプロセスHTTPサーバはアクセスされたリクエストを拒否しました。

KDJE39574-E

Error

KDJE39514-W

幾つかのリクエスト処理スレッドが終了していません。

KDJE39575-W

Error

KDJE39561-W

Servlet ContainerInitializer検索範囲絞り込み機能が有効になっています。

なし

Error

リダイレクタ

KDJE41000

〜KDJE41041

すべてのメッセージ

なし※

−

注※

HTTP Serverのエラーログで代替してください。

12.6　パラメタ読み替えリファレンス

この節では，アプリケーションサーバ 11-00以降にだけ存在するパラメタの設定値を，アプリケーションサーバ 09-87での設定値からどのように算出すべきかについて説明します。

12.6.1　J2EEサーバ用ユーザプロパティ定義

アプリケーションサーバ 11-00以降にだけ存在するパラメタのうち，J2EEサーバ用ユーザプロパティファイルに指定するプロパティの推奨値を次の表に示します。プロパティの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

表12‒14　J2EEサーバ用ユーザプロパティの移行先プロパティ

アプリケーションサーバ 11-20のプロパティ名

アプリケーションサーバ 11-20での推奨値

Webサーバ連携の場合

インプロセスHTTPサーバの場合

webserver.connector.nio_http.max_connections

12.4.1(1)(a)を参照

12.4.1(1)(b)を参照

webserver.connector.nio_http.max_threads

webserver.connector.nio_http.min_threads

webserver.connector.nio_http.receive_timeout

12.4.1(2)(a)を参照

12.4.1(2)(b)を参照

webserver.connector.nio_http.send_timeout

webserver.connector.nio_http.backlog

webserver.connector.ajp13.backlogと同じ値

webserver.connector.inprocess_http.backlogと同じ値

webserver.connector.nio_http.bind_host

リバースプロキシの転送先URLのホスト名が「localhost」の場合は"localhost"。

それ以外の場合は，Webサーバと通信可能なIPアドレスまたはホスト名

webserver.connector.inprocess_http.bind_hostと同じ値

webserver.connector.nio_http.hostname_lookups

false（デフォルト値）

webserver.connector.inprocess_http.hostname_lookupsと同じ値

webserver.connector.nio_http.limit.max_headers

100（デフォルト値）

webserver.connector.inprocess_http.limit.max_headersと同じ値

webserver.connector.nio_http.limit.max_request_body

-1（デフォルト値）

webserver.connector.inprocess_http.limit.max_request_bodyと同じ値

webserver.connector.nio_http.limit.max_request_header

16384（デフォルト値）

webserver.connector.inprocess_http.limit.max_request_headerと同じ値

webserver.connector.nio_http.keep_alive.max_requests

0（デフォルト値）

webserver.connector.inprocess_http.persistent_connection.max_requestsと同じ値

webserver.connector.nio_http.keep_alive.timeout

0（デフォルト値）

webserver.connector.inprocess_http.persistent_connection.timeoutと同じ値

webserver.connector.nio_http.port

Webサーバと通信可能な任意のポート番号

webserver.connector.inprocess_http.portと同じ値

webserver.connector.nio_http.response.header.server

"CosminexusComponentContainer"

（デフォルト値）

webserver.connector.inprocess_http.response.header.serverと同じ値

webserver.connector.nio_http.idle_thread_timeout

60（デフォルト値）

60（デフォルト値）

webserver.connector.nio_http.permitted.hosts

リバースプロキシの転送先URLのホスト名がlocalhostの場合

"localhost"

それ以外の場合

WebサーバのIPアドレスまたはホスト名

webserver.connector.inprocess_http.permitted.hostsと同じ値

webserver.connector.nio_http.max_servlet_execute_threads

webserver.connector.ajp13.max_threadsと同じ値

webserver.connector.inprocess_http.max_execute_threadsと同じ値

ejbserver.logger.channels.define.NIOHTTPAccessLogFile.filenum

16（デフォルト値）

webserver.logger.access_log.inprocess_http.filenumと同じ値

ejbserver.logger.channels.define.NIOHTTPAccessLogFile.filesize

4194304（デフォルト値）

webserver.logger.access_log.inprocess_http.filesizeと同じ値

ejbserver.logger.access_log.nio_http.format

%h %{X-Forwarded-For}i %l %u %d %rootap "%r" %s %b %D %S（デフォルト値）

webserver.logger.access_log.inprocess_http.usage_formatの値が”common”または”combined”だった場合

デフォルト値

それ以外の場合

デフォルト値に加え，webserver.logger.access_log.<フォーマット名>に個別に指定していたフォーマット引数

<フォーマット名>はwebserver.logger.access_log.inprocess_http.usage_formatに指定していた文字列

webserver.context.stop_asyncwait_timeout

30（デフォルト値）

webserver.servlet_api.unsupported.throwUnsupportedOperationException

12.3.2(1)を参照

12.6.2　リダイレクタの定義

アプリケーションサーバ 09-87でリダイレクタによるWebサーバ連携構成を使用していた場合は，リダイレクタによるWebサーバ連携機能がHTTP Serverのリバースプロキシ機能に置き換わります。従来のリダイレクタに指定していたパラメタから，リバースプロキシ機能のディレクティブへの読み替えを次の表に示します。

表12‒15　リダイレクタの定義ファイルの移行先

アプリケーションサーバ 09-87での指定先

アプリケーションサーバ 11-20で対応する指定先

指定先ファイル

パラメタ名

mod_jk.conf

（リダイレクタ動作定義ファイル）

JkConnectTimeout

12.4.1(2)(a)を参照

JkSendTimeout

JkPrfId

HWSPrfIdディレクティブ

JkRequestRetryCount

なし（常にリトライはしない）

上記以外

なし

worker.properties

（ワーカ定義ファイル）

worker.<ワーカ名>.host

ProxyPassディレクティブの第2引数に指定するURLのホスト名

worker.<ワーカ名>.port

ProxyPassディレクティブの第2引数に指定するURLのポート番号

worker.<ワーカ名>.receive_timeout

12.4.1(2)(a)を参照

上記以外

なし

12.7　廃止されたパラメタリファレンス

この節では，アプリケーションサーバ 11-20で廃止されているパラメタについて説明します。

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

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

アプリケーションサーバ 11-20では指定できないキーを次の表に示します。

表12‒16　J2EEサーバ用ユーザプロパティファイルの廃止パラメタ

廃止されたアプリケーションサーバ 09-87のキー名

備考

webserver.connector.inprocess_httpから始まるキー

インプロセスHTTPサーバ機能は使用できません。

webserver.logger.access_logから始まるキー

webserver.logger.communication_trace.inprocess_http.filenum

webserver.logger.thread_trace.inprocess_http.filenum

webserver.container.thread_control.enabled

指定値は無視され，常にtrue相当の動きになります。

webserver.connector.ajp12から始まるキー

リダイレクタによるWebサーバ連携機能は使用できません。

webserver.connector.ajp13から始まるキー

ejbserver.server.eheap.ajp13.enabled

webserver.eadssfo.から始まるキー

EADsセッションフェイルオーバ機能は使用できません。

webserver.jsp.el2_2.enabled

指定値は無視され，常にEL 3.0で動作します。

cosminexus.jpa.から始まるキー

CJPAプロバイダ独自パラメタは使用できません。

ejbserver.server.j2ee.feature

1.3basicなどの旧バージョン互換の動作モードは指定できません。

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

次のファイルは使用できません。

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

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

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

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

12.7.3　JPAで使用するファイル

(1)　persistence.xml

persistence.xmlの<property>タグに指定するプロパティとして，次のプロパティは指定できません。

cosminexus.jpaから始まるプロパティ

12.7.4　Smart Composer機能で指定するパラメタ

(1)　論理J2EEサーバで指定するパラメタ

「表12-16　J2EEサーバ用ユーザプロパティファイルの廃止パラメタ」にあるパラメタは，論理J2EEサーバのパラメタとしても指定できません。

(2)　論理Webサーバで指定するパラメタ

次のパラメタは論理Webサーバのパラメタとして指定できません。

HTTP Server用リダイレクタ動作定義を設定するパラメタ

ワーカ定義を設定するパラメタ

付録

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

ここでは，snapshotログの一括収集を実行する場合に収集対象となる構成ソフトウェアの実行環境ディレクトリについて説明します。なお，収集したZIPファイルを展開すると，収集元と同じディレクトリ構成で展開されます。

snapshotログの一括収集時，アプリケーションサーバで構築したシステムの構成ソフトウェア，ライブラリのログファイルおよび定義ファイルが収集されます。収集対象は，次のファイルを編集すると変更できます。snapshotログ取得の設定については，「3.3.3　snapshotログ収集の設定（J2EEアプリケーションを実行するシステム）」または「3.3.4　snapshotログ収集の設定（バッチアプリケーションを実行するシステム）」を参照してください。

トラブルシューティングに必要な資料とsnapshotログの資料の種類との対応を次の表に示します。

表A‒1　トラブルシューティングに必要な資料とsnapshotログの資料の種類との対応

トラブルシューティングに必要な資料

snapshotログの資料の種類

アプリケーションサーバのログ

メッセージログ

メッセージログ

ユーザログ

そのほかのログ

例外ログ

そのほかのログ

保守用ログ

保守ログ

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

メッセージログ

メッセージログ

ユーザログ

そのほかのログ

例外ログ

そのほかのログ

保守用ログ

保守ログ

性能解析トレース

性能，障害解析トレース

JavaVMのスレッドダンプ

ダンプ

JavaVMのGCのログ

そのほかのログ

メモリダンプ

ダンプ

JavaVMログファイル

そのほかのログ

エラーリポートファイル

ダンプ

OSの状態・ログ

そのほか

OSの統計情報

そのほか

定義情報

定義情報

作業ディレクトリ

ユーザデータ

リソースの設定

ユーザデータ

Webサーバのログ

メッセージログ

そのほかのログ

アクセスログ

内部インタフェース

JavaVMのスタックトレース

そのほかのログ

明示管理ヒープ機能のイベントログ

そのほかのログ

注意事項

snapshotログの一括収集は，デフォルトの状態では構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリを対象に実行します。ログの出力先および作業ディレクトリを変更している場合は，収集先をカスタマイズしてください。

付録A.1　snapshotログの収集対象一覧の概要

ここでは，snapshotログの資料の格納場所や，一覧で説明している収集方法，ディレクトリおよびファイルの名称について説明します。

(1)　資料の格納場所

snapshotログは，snapshotlog.conf，snapshotlog.2.conf，およびsnapshotlog.param.confのファイルに分けて収集されます。

snapshotlog.conf

一次送付資料の収集対象が記載されているファイルです。ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥snapshotlog.conf

UNIXの場合

/opt/Cosminexus/manager/config/snapshotlog.conf

snapshotlog.2.conf

二次送付資料の収集対象が記載されているファイルです。ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥snapshotlog.2.conf

UNIXの場合

/opt/Cosminexus/manager/config/snapshotlog.2.conf

snapshotlog.param.conf

定義送付資料の収集対象が記載されているファイルです。ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥snapshotlog.param.conf

UNIXの場合

/opt/Cosminexus/manager/config/snapshotlog.param.conf

(2)　snapshotログの収集方法

snapshotログを収集する方法には，次の種類があります。snapshotログの収集方法を次の表に示します。

表A‒2　snapshotログの収集方法

項番

収集方法

分類

1

運用管理ポータルの「論理サーバの起動／停止」アンカーの［snapshotログ］画面から収集する

収集方法A

2

運用管理コマンド（mngsvrutil collect snapshotコマンド）を実行する

収集方法A

3

論理サーバの障害を検知して自動収集する

収集方法A

4

標準のsnapshotlog.conf，snapshotlog.2.conf，snapshotlog.param.confを使用してsnapshotlogコマンドを実行する

収集方法B

(3)　snapshotログの収集可否や収集に関する設定変更

表A-5から表A-45では，mngsvrutilコマンドまたはsnapshotlogコマンドでの収集可否や設定変更可否などを記号で分類しています。それぞれの記号について次の表で説明します。

表A‒3　表A-5から表A-45の表中の記号の定義

表中の

記号

デフォルト

での収集

ログの出力先や定義ファイルの格納先の変更

ログの出力先や定義ファイルの

格納先の変更をした場合の収集

◎

収集される

できる

できる

○

収集される

できない

できない

△

収集される

できる

できるが制限がある※1

×

収集されない

できない

できない※2

注※1

snapshotログ収集対象定義ファイル（snapshotlog.conf，snapshotlog.2.conf，またはsnapshotlog.param.conf）を編集して，収集対象ディレクトリに設定する必要があります。

注※2

ログの出力先や定義ファイルの格納先を変更できません。また，snapshotログ収集対象定義ファイル（snapshotlog.conf，snapshotlog.2.conf，またはsnapshotlog.param.conf）を編集して，収集対象ディレクトリに設定する必要があります。

また，表A-5から表A-45の資料列では，mngsvrutilコマンドまたはsnapshotlogコマンドを実行した場合に，収集される資料を示しています。

ほかの方法で資料を収集した場合，またはmngsvrutil collect snapshot 2を実行した場合は，表の資料列の内容に関係なくすべての資料が収集されます。

資料列の表記および記号について説明します。

一次：一次送付資料

snapshotconf.confを指定したsnapshotlogコマンド，またはmngsvrutil collect snapshot 1を実行した場合に収集される資料です。

二次：二次送付資料

snapshotconf.2.confを指定したsnapshotlogコマンド，またはmngsvrutil collect snapshot 2を実行した場合に収集される資料です。

定義：定義送付資料

snapshotlog.param.confを指定したsnapshotlogコマンドを実行した場合に収集される資料です。

表中の記号

○：収集される

−：収集されない

(4)　収集対象の記述規則

収集対象のディレクトリおよびファイルの共通の記述方法を次に示します。

収集対象中の「*」は0文字以上の任意の文字列を示します。

Windowsでの「¥*¥*¥*」やUNIXでの「/*/*/*」のような記述は，何階層下のファイルを収集するかを示します。例えば，Windowsでの「log¥*¥*」やUNIXでの「log/*/*」の場合は，logディレクトリの2階層下のファイルが収集対象になります。

また，収集対象のディレクトリおよびファイルの意味を次の表に示します。

表A‒4　収集対象のディレクトリおよびファイルの意味

ディレクトリまたはファイル名

内容

デフォルト値

置換後の値

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

アプリケーションサーバのインストールディレクトリパス名

Windowsの場合

アプリケーションサーバのインストール時に決定する。

UNIXの場合

/opt/Cosminexus

${cosminexus.home}

<CTM識別子>

ctmstartコマンドの-CTMIDオプション名

−

.+

<CTMスプールディレクトリ(ctmspool)>

環境変数CTMSPOOLに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CTM/spool

&{ctmspool}

<DABroker運用ディレクトリ(dabroker)>

DABrokerインストール後，dabsetupコマンドで設定したディレクトリパス名

/opt/DABroker

<DABroker_Oparation>

<EJBクライアントの定義ファイル格納ディレクトリ>

環境変数CJCLUSRCONFDIRに指定したディレクトリパス名，またはcjclstartapコマンドを実行したディレクトリパス名

−

<ejb.client.definition.file.dir>

<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>

Javaアプリケーション用のusrconf.cfgのejb.client.ejb.logキーに指定したサブディレクトリ名

system

.+

<EJBクライアントログサブディレクトリ1(ejbserver..client.ejb.log)>

Javaアプリケーション用のusrconf.propertiesのejbserver.client.ejb.logキーに指定したディレクトリパス名

−

.+

<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>

Javaアプリケーション用のusrconf.cfgのejb.client.log.appidキーに指定したサブディレクトリ名

ejbcl

.+

<EJBクライアントログサブディレクトリ2(ejbserver..client.log.appid)>

Javaアプリケーション用のusrconf.propertiesのejbserver.client.log.appidキーに指定したディレクトリパス名

−

.+

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>

Javaアプリケーション用のusrconf.cfgのejb.client.log.directoryキーに指定したディレクトリパス名

−

<ejb.client.log.directory>

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>

Javaアプリケーション用のusrconf.propertiesのejbserver.client.log.directoryキーに指定したディレクトリパス名

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

<ejbserver.client.log.directory>

<HCSCサーバのプロパティ(methodtrace-filepath)>

HCSCサーバ定義コマンドcscsvconfigでmethodtrace-filepathプロパティに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>/logs/csc/maintenance

<methodtrace-filepath>

<HCSCサーバのプロパティ(requesttrace-filepath)>

HCSCサーバ定義コマンドcscsvconfigでrequesttrace-filepathプロパティに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>/logs/csc

<requesttrace-filepath>

<HCSCリポジトリルート(cscmng.repository.root)>

HCSC-Manager定義cscmng.propertiesのcscmng.repository.rootキーに指定したリポジトリルート名

<Application Serverのインストールディレクトリ>/CSC/repository

<cscmng.repository.root>

<HCSCログ出力ディレクトリ(cscmng.log.dir)>

HCSC-Manager定義cscmng.propertiesのcscmng.log.dirキーに指定したログディレクトリパス名

<Application Serverのインストールディレクトリ>/CSC/log/manager

<cscmng.log.dir>

<HWSアクセスログディレクトリ(HttpsdCustomLogFileDir)>

httpsd.confのCustomLogディレクティブに指定したファイル名のディレクトリパス名部分

<HWSのインストールディレクトリ>/servers/HWS_<サーバ名称>/logs

&{hws.logfile.dir}

<HWSのインストールディレクトリ>

HTTP Serverのインストールディレクトリパス名

Windowsの場合

<Application Serverのインストールディレクトリ>/httpsd

UNIXの場合

/opt/hitachi/httpsd

${hws.home}

<HWSエラーログディレクトリ(HttpsdErrorLogFileDir)>

httpsd.confのErrorLogrディレクティブに指定したファイル名のディレクトリパス名部分

<HWSのインストールディレクトリ>/servers/HWS_<サーバ名称>/logs

&{hws.logfile.dir}

<HWSキャッシュサーバの作業ディレクトリ(SSLCacheServerRunDir)>

httpsd.confのSSLCacheServerRunDirディレクティブに指定したディレクトリパス名

<HWSサーバのルートディレクトリ(ServerRoot)>

<SSLCacheServerRunDir>

<HWSコアダンプ出力ディレクトリ(CoreDumpDirectory)>

httpsd.confのCoreDumpDirectoryディレクティブに指定したディレクトリパス名

<HWSのインストールディレクトリ>/servers/HWS_<サーバ名称>

&{core.dump.directory}

<HWSサーバのルートディレクトリ(ServerRoot)>

httpsd.confのServerRootディレクティブに指定したディレクトリパス名

<HWSのインストールディレクトリ>

<ServerRoot>

<HWS内部トレースディレクトリ(HttpsdTraceLogFileDir)>

httpsd.confのHWSTraceLogFileディレクティブに指定したファイル名のディレクトリパス名部分

<HWSのインストールディレクトリ>/servers/HWS_<サーバ名称>/logs

&{hws.logfile.dir}

<HWSプロセスIDファイル(PidFile)>

httpsd.confのPidFileディレクティブに指定したファイル名

<HWSのインストールディレクトリ>/servers/HWS_<サーバ名称>/logs/httpd.pid

<PidFile>

<HWS用リダイレクタログ出力ディレクトリ(JkLogFileDir)>

mod_jk.confのJkLogFileDirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名称>/logs

&{jklogfiledir}

<HWS用リダイレクタトレースログ出力ディレクトリ(JkTraceLogFileDir)>

mod_jk.confのJkTraceLogFileDirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名称>/logs

&{jktracelogfiledir}

<HWSリクエストログディレクトリ(HttpsdRequestLogFileDir)>

httpsd.confのHWSRequestLogディレクティブに指定したファイル名のディレクトリパス名部分

<HWSのインストールディレクトリ>/servers/HWS_<サーバ名称>/logs

&{hws.logfile.dir}

<IISアクセスログディレクトリ(IIS_log_dir)>

Microsoft IISのアクセスログ出力ディレクトリパス名

<システムルートディレクトリ(systemroot)>/system32/LogFiles/W3SVC1

<IIS_log_dir>

<IIS用リダイレクタトレースログ出力ディレクトリ(trace_log_file_dir)>

isapi_redirect.confのtrace_log_file_dirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名称>/logs

&{jktracelogfiledir}

<IIS用リダイレクタログ出力ディレクトリ(log_file_dir)>

isapi_redirect.confのlog_file_dirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名称>/logs

&{jklogfiledir}

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>

J2EEサーバ用のusrconf.cfgのejb.public.directoryキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/public

&{ejb.public.directory}

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>

J2EEサーバ用のusrconf.cfgのejb.server.log.directoryキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>/logs

&{ejb.server.log.directory}

<JAXRトレースファイル名(com.cosminexus.xml.registry.trace.file_path)>

システムプロパティのcom.cosminexus.xml.registry.trace.file_pathキーに指定したファイルパス名

${cosminexus.home}/c4web/logs/JAXRAPITrace

<com.cosminexus.xml.registry.trace.file_path>

<JSP用一時ディレクトリ(webserver.work.directory)>

J2EEサーバのusrconf.propertiesのwebserver.work.directoryキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/repository/<サーバ名称>/web

&{webserver.work.directory}

<Managementイベント発行用メッセージIDリストファイル(manager.mevent.message_id.list)>

mevent.<サーバ名称>.propertiesのmanager.mevent.message_id.listキーに指定したファイルパス名

−

<manager.mevent.message_id.list>

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>

manager.cfgのcom.cosminexus.manager.log.dirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/manager/log

${com.cosminexus.manager.log.dir}

<PRF識別子>

cprfstartコマンドの-PRFIDオプション名

−

.+

<PRFスプールディレクトリ(prfspool)>

環境変数PRFSPOOLに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/PRF/spool

&{prfspool}

<RMインストールディレクトリ>

環境変数HRMDIRに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/RM

<HRMDIR>

<TP1Connectorログ出力ディレクトリ(jp.co.hitachi_system.tp1connector.logdestination)>

システムプロパティのjp.co.hitachi_system.tp1connector.logdestinationキーに指定したディレクトリパス名

<ユーザホームディレクトリ(user.home)>

<jp.co.hitachi_system.tp1connector.logdestination>

<UNIXのsyslog(syslog)>

UNIXのsyslogファイルパス名

AIXの場合

/var/adm/ras/syslog*

Linuxの場合

/var/log/messages*

<syslog>

<VBROKER_ADMディレクトリ(vbroker_adm)>

環境変数VBROKER_ADMに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/TPB/adm

<VBROKER_ADM>

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>

J2EEサーバ用のusrconf.cfgのweb.server.log.directoryキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/logs

<web.server.log.directory>

<Windowsのイベントログ(EventLog)>

Windowsのイベントログをwmicコマンドなどで収集したファイル

−

<EventLog>

<Windowsのクラッシュダンプ出力ディレクトリ(CrashDumpDir)>

Windowsのクラッシュダンプ出力先ディレクトリパス名

<ユーザのApplication Dataディレクトリ(LOCALAPPDATA)>/CrashDumps

<CrashDumpDir>

<XML Security - Core トレース出力ディレクトリ(com.cosminexus.xml.security.logging.trace_dir)>

J2EEサーバ用のusrconf.cfgのcom.cosminexus.xml.security.logging.trace_dirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>

<com.cosminexus.xml.security.logging.trace_dir>

<インプロセスHTTPサーバアクセスログファイル(webserver.logger.access_log.inprocess_http.filename)>

J2EEサーバ用のusrconf.propertiesのwebserver.logger.access_log.inprocess_http.filenameキーに指定したファイルパス名

<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>/logs/http/cjhttp_access.inprocess_http

&{webserver.logger.access_log.inprocess_http.filename}.

<稼働情報ファイル出力先ディレクトリ(ejbserver.management.stats_file.dir)>

J2EEサーバ用のusrconf.propertiesのejbserver.management.stats_file.dirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>/stats

&{ejbserver.management.stats_file.dir}

<監査ログ出力ディレクトリ(auditlog.directory)>

監査ログ定義ファイルのauditlog.directoryキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/auditlog

<auditlog.directory>

<監査ログメッセージ出力ディレクトリ(auditlog.raslog.message.directory)>

監査ログ定義ファイルのauditlog.raslog.message.directoryキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/auditlog

<auditlog.raslog.message.directory>

<監査ログ例外出力ディレクトリ(auditlog.raslog.exception.directory)>

監査ログ定義ファイルのauditlog.raslog.exception.directoryキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/auditlog

<auditlog.raslog.exception.directory>

<コンテキストルート>

サーバで実行している J2EE webアプリケーションのルート名

−

.+

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>

サーバ管理コマンド用オプション定義ファイルのUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプションに指定したディレクトリパス名

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

<admin_ejb.server.log.directory>

<サーバ名称>

Management Serverで設定した論理サーバ名または実サーバ名

−

.+

<システムドライブ(SystemDrive)>

環境変数SystemDriveに指定したディレクトリパス名

−

%{SystemDrive}

<システムルートディレクトリ(systemroot)>

環境変数SystemRootに指定したディレクトリパス名

−

%{SystemRoot}

<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)>

J2EEサーバのusrconf.propertiesのejbserver.distributedtx.ots.status.directory1キーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>/otsstatus

&{ejbserver.distributedtx.ots.status.directory1}

<統合ユーザ管理のトレースファイル名(com.cosminexus.admin.auth.trace.prefix)>

ua.confのcom.cosminexus.admin.auth.trace.prefixオプションに指定したファイルパス名

−

<com.cosminexus.admin.auth.trace.prefix>

<バッチアプリケーションの定義ファイル格納ディレクトリ>

環境変数CJBATCHUSRCONFDIRに指定したディレクトリパス名，またはcjexecjobコマンド，cjkilljobコマンドもしくはcjlistjobコマンドを実行したディレクトリパス名

−

<batch.application.definition.file.dir>

<バッチアプリケーションログ出力ディレクトリ(batch.log.directory)>

バッチアプリケーション用のusrconf.cfgのbatch.log.directoryに指定したディレクトリパス名

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

<batch.log.directory>

<ユーザのApplication Dataディレクトリ(LOCALAPPDATA)>

環境変数LOCALAPPDATAに指定したディレクトリパス名

−

%{LOCALAPPDATA}

<ユーザホームディレクトリ(user.home)>

実行ユーザのホームディレクトリパス名

収集方法がAの場合

運用管理エージェント起動ユーザのホームディレクトリ

収集方法がBの場合

snapshotlogコマンドの実行ユーザのホームディレクトリ

−

${user.home}および<user.home>

<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)>

J2EEサーバのusrconf.propertiesのejbserver.distributedtx.ots.status.directory2キーに指定したディレクトリパス名

−

&{ejbserver.distributedtx.ots.status.directory2}

<08-50モードの仮想サーバマネージャログディレクトリ(vmx.log.dir)>

vmx.propertiesのvmx.log.dirキーに指定したディレクトリパス名※

<Application Serverのインストールディレクトリ>/manager/vmx/log

<vmx.log.dir>

<08-50モードの仮想サーバマネージャの処理データ格納ディレクトリ(vmx.spool.dir)>

vmx.propertiesのvmx.spool.dirキーに指定したディレクトリパス名※

<Application Serverのインストールディレクトリ>/manager/vmx/spool

<vmx.spool.dir>

<仮想サーバマネージャの処理データ格納ディレクトリ(vmi.spool.dir)>

vmi.propertiesのvmi.spool.dirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/manager/vmi/spool

<vmi.spool.dir>

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>

sinaviagent.cfgのsinaviagent.log.dirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/sinagent/log

<sinaviagent.log.dir>

<サーバ通信エージェント処理データ格納ディレクトリ(sinaviagent.spool.dir)>

sinaviagent.cfgのsinaviagent.spool.dirキーに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/sinagent/spool

<sinaviagent.spool.dir>

<FTPアダプタインストールディレクトリ(ftpadp.home)>

FTPアダプタのインストールディレクトリパス名

−

<ftpadp.home>

<FTPアダプタコマンドメッセージログ出力先ディレクトリ(ftpadp.command.messagelog.filepath)>

FTPアダプタの運用コマンドのメッセージログ出力先ディレクトリパス名

<FTPアダプタインストールディレクトリ(ftpadp.home)>/log

<ftpadp.command.messagelog.filepath>

<HCSCメールアダプタ運用コマンドメッセージログ出力先ディレクトリ(mailadp.command.messagelog.filepath)>

Service Coordinator本体に組み込まれるメールアダプタの運用コマンド実行ログディレクトリパス名

<Application Serverのインストールディレクトリ>/CSC/log/adapter/command

<mailadp.command.messagelog.filepath>

<HCSCメールアダプタの保守ログ出力先ディレクトリ(mailadp.methodtrace.filepath)>

メールアダプタの実行環境プロパティファイルでmailadp.methodtrace.filepathプロパティに指定したディレクトリパス名

<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>/logs/CSCADP/MAILADP/maintenance/

<mailadp.methodtrace.filepath>

<CTMレギュレータの設定ファイル(ctm.RegOption)>

CTMレギュレータの設定ファイルのパス名

−

&{ctm.RegOption}

<OTMゲートウェイの設定ファイル(ctm.TSCGwOption)>

OTMゲートウェイの設定ファイルのパス名

−

&{ctm.TSCGwOption}

<一時PRFトレースファイル出力用ディレクトリ(adminagent.prftrace_dir)>

一時PRFトレースファイルの出力先ディレクトリパス名

<Application Serverインストールディレクトリ>/manager/tmp

${adminagent.prftrace_dir}

<明示管理ヒープ機能適用除外設定ファイル名(jvm.exmemexcludeclass.File)>

JavaVM拡張オプション-XX:ExplicitMemoryExcludeClassListFileに指定したファイルパス名

<Application Serverのインストールディレクトリ>/jdk/usrconf/exmemexcludeclass.cfg

<jvm.exmemexcludeclass.File>

<明示管理ヒープ機能適用除外設定の無効化対象設定ファイル名(jvm.exmemnotexcludeclass.File)>

JavaVM拡張オプション-XX:ExplicitMemoryNotExcludeClassListFileに指定したファイルパス名

<Application Serverのインストールディレクトリ>/jdk/usrconf/exmemnotexcludeclass.cfg

<jvm.exmemnotexcludeclass.File>

<HWSWebSocketログディレクトリ(HttpsdWebSocketLogFileDir)>

httpsd.confのHWSWebSocketLogディレクティブに指定したファイル名のディレクトリパス名

<HWSインストールディレクトリ>/servers/HWS_<サーバ名称>/logs

&{hws.logfile.dir}

（凡例）−：デフォルト値なし

注※　このバージョンでは指定できません。常にデフォルト値になります。

付録A.2　Component Container

Component Containerに関連する収集対象を次の表に示します。

表A‒5　Component Containerに関連する収集対象（Windowsの場合）

分類

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

J2EEサーバ

メッセージログ

稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjmessage*.log

○

−

−

◎

△

ログ稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjlogger.log

○

−

−

◎

△

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/*.log

○

−

−

◎

△

J2EEアプリケーションに含めて使用するリソースアダプタの稼働ログ（通常モード）

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/<J2EEアプリケーション名>/*.log

○

−

−

◎

△

J2EEアプリケーションに含めて使用するリソースアダプタの稼働ログ（テストモード）

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/TEST#<J2EEアプリケーション名>/*.log

○

−

−

◎

△

Webサーブレットログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/web_servlet*.log

○

−

−

◎

△

そのほかのログ

ユーザ出力ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/user_out*.log

○

−

−

◎

△

ユーザエラーログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/user_err*.log

○

−

−

◎

△

JavaVMの保守情報およびGCのログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/javalog*.log

○

−

−

◎

△

JavaVMの明示管理ヒープ機能イベントログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/ehjavalog*.log

○

−

−

◎

△

開発調査ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjdevelopment*.log

○

−

−

◎

△

障害発生時の例外情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjexception*.log

○

−

−

◎

△

JavaVMイベントログ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/hs_err*

○

−

−

◎

◎

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/replay_pid*.log

○

−

−

◎

◎

J2EEアプリケーションのユーザログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/user/*

○

−

−

◎

△

保守ログ

保守情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjmaintenance*.log

○

−

−

◎

△

コンソールメッセージ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjconsole*.log

○

−

−

◎

△

EJBコンテナの保守情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjejbcontainer*.log

○

−

−

◎

△

Webコンテナの保守情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjwebcontainer*.log

○

−

−

◎

△

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

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjstdout*.log

○

−

−

◎

△

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

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjstderr*.log

○

−

−

◎

△

終了プロセス情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cj_shutdown*.log

○

−

−

◎

△

ダンプ

スレッドダンプ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/javacore*

○

−

−

◎

◎

統計情報

稼働情報ファイル

<稼働情報ファイル出力先ディレクトリ(ejbserver.management.stats_file.dir)>/*

−

○

−

◎

△

メモリ監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjmemorywatch*.log

○

−

−

◎

△

スレッド監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjthreadwatch*.log

○

−

−

◎

△

スレッドダンプ監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjthreaddumpwatch*.log

○

−

−

◎

△

HTTPリクエスト実行待ちキュー監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjrequestqueuewatch*.log

○

−

−

◎

△

HTTPセッション数監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjhttpsessionwatch*.log

○

−

−

◎

△

コネクションプール監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjconnectionpoolwatch*.log

○

−

−

◎

△

そのほか

J2EEサーバの起動，停止または異常終了を示すログ

<Windowsのイベントログ(EventLog)>

○

−

−

×

×

定義情報

J2EEサーバ用オプション定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

○

−

○

○

○

J2EEサーバ用ユーザプロパティファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

○

−

○

○

○

J2EEサーバ用セキュリティポリシーファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/server.policy

○

−

○

○

○

MNGで作成した各種定義ファイルのバックアップ

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/*

−

○

−

○

○

保護区リストファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/criticalList.cfg

○

−

○

○

○

リソース設定情報

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/import/**

−

○

−

×

×

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/rars/**

−

○

−

×

×

保守情報

<Cosminexusインストールディレクトリ>/CC/server/version/**

○

−

○

○

○

ユーザデータ

EJBサーバ作業ディレクトリの内容

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/**

−

○

−

×

×

Webコンテナ作業ディレクトリの内容

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/**

−

○

−

×

×

JSP用一時ディレクトリの内容

<JSP用一時ディレクトリ(webserver.work.directory)>/**

−

○

−

×

×

サーバ管理コマンド

メッセージログ

稼働ログ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/cjmessage*.log

○

−

−

△

△

ログ稼働ログ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/cjlogger.log

○

−

−

△

△

互換モードの稼働ログ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*message*.log

○

−

−

△

△

そのほかのログ

障害発生時の例外情報

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/cjexception*.log

○

−

−

△

△

互換モードの障害発生時の例外情報

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*exception*.log

○

−

−

△

△

保守ログ

保守情報

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/CC/maintenance/cjmaintenance*.log

○

−

−

△

△

コンソールメッセージ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/CC/maintenance/cjconsole*.log

○

−

−

△

△

サーバ管理コマンドの保守情報

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/CC/maintenance/cjserveradmin*.log

○

−

−

△

△

そのほかのログ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*/*

○

−

−

△

△

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*/*/*

○

−

−

△

△

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*/*/*/*

−

○

−

△

△

定義情報

サーバ管理コマンド用定義ファイル

<Application Serverのインストールディレクトリ>/CC/admin/usrconf/*

○

−

○

○

○

バッチアプリケーション

メッセージログ

cjexecjobコマンド，cjkilljobコマンドおよびcjlistjobコマンドの稼働ログ

<バッチアプリケーションログ出力ディレクトリ(batch.log.directory)>/cjmessage*.log

○

−

−

△

△

保守ログ

そのほかのログ

<バッチアプリケーションログ出力ディレクトリ(batch.log.directory)>/*/*

○

−

−

△

△

定義情報

バッチアプリケーション用オプション定義ファイル

<バッチアプリケーションの定義ファイル格納ディレクトリ>/usrconf.cfg

○

−

−

×

×

バッチアプリケーション用ユーザプロパティファイル

<バッチアプリケーションの定義ファイル格納ディレクトリ>/usrconf.properties

○

−

−

×

×

リソースアダプタバージョンアップコマンド（cjrarupdate）

メッセージログ

稼働ログ

<Application Serverのインストールディレクトリ>/CC/logs/cjrarupdatemessage*.log

○

−

−

○

○

そのほかのログ

障害発生時の例外情報

<Application Serverのインストールディレクトリ>/CC/logs/cjrarupdateexception*.log

○

−

−

○

○

保守ログ

保守情報

<Application Serverのインストールディレクトリ>/CC/logs/cjrarupdatemaintenance*.log

○

−

−

○

○

インプロセスHTTPサーバ

アクセスログ

インプロセスHTTPサーバの処理結果

<インプロセスHTTPサーバアクセスログファイル(webserver.logger.access_log.inprocess_http.filename)>*.log

○

−

−

◎

△

モジュールトレース

スレッドトレースの情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/http/maintenance/thr/cjhttp_thr.*.inprocess_http.mm

○

−

−

◎

△

通信トレース

通信トレースの情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/http/maintenance/comm/cjhttp_comm.*.inprocess_http.mm

○

−

−

◎

△

NIO HTTPサーバ

アクセスログ

NIO HTTPサーバ（HTTP）の処理結果

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cj_access_niohttp*.log

○

−

−

◎

△

NIO HTTPサーバ（WebSocket）の処理結果

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cj_access_websocket*.log

○

−

−

◎

△

移行コマンド（cjenvupdate）

メッセージログ

cjenvupdateコマンドの稼働ログ

<Application Serverのインストールディレクトリ>/CC/logs/cjenvupdatemessage*.log

○

−

−

○

○

そのほかのログ

cjenvupdateコマンドの例外情報

<Application Serverのインストールディレクトリ>/CC/logs/cjenvupdateexception*.log

○

−

−

○

○

保守ログ

cjenvupdateコマンドの保守情報

<Application Serverのインストールディレクトリ>/CC/logs/cjenvupdatemaintenance*.log

○

−

−

○

○

インプロセストランザクションサービス

そのほか

インプロセストランザクションサービスのステータスファイル

<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)>/*

−

○

−

◎

△

<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)>/*/*

−

○

−

◎

△

インプロセストランザクションサービスの予備ステータスファイル

<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)>/*

−

○

−

◎

×

<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)>/*/*

−

○

−

◎

×

EJBクライアント

メッセージログ

稼働ログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/cjclmessage*.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/cjclmessage*.log

○

−

−

×

×

cjclstartapコマンドの稼働ログ

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/cjclstartap*.log

○

−

−

×

×

cjcldellogコマンドの稼働ログ

<Application Serverのインストールディレクトリ>/CC/client/logs/cjcldellog.log

○

−

−

○

○

そのほかのログ

ユーザ出力ログ

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/user_out*.log

○

−

−

×

×

ユーザエラーログ

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/user_err*.log

○

−

−

×

×

JavaVMの保守情報，GCのログ

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/javalog*.log

○

−

−

×

×

障害発生時の例外情報

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/cjclexception*.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjclmaintenance*.log

○

−

−

×

×

EJBクライアントアプリケーションのユーザログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/user/*

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/user/*

○

−

−

×

×

保守ログ

保守情報

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/cjclmaintenance*.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjclmaintenance*.log

○

−

−

×

×

EJBコンテナの保守情報

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjejbcontainer*.log

○

−

−

×

×

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

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjstdout*.log

○

−

−

×

×

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

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjstderr*.log

○

−

−

×

×

ログの稼働情報

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/cjlogger.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/cjlogger.log

○

−

−

×

×

定義情報

EJBクライアント用オプション定義ファイル

<EJBクライアントの定義ファイル格納ディレクトリ>/usrconf.cfg

○

−

−

×

×

EJBクライアント用ユーザプロパティファイル

<EJBクライアントの定義ファイル格納ディレクトリ>/usrconf.properties

○

−

−

×

×

リダイレクタ（Webサーバ）

メッセージログ

HWS用リダイレクタのメッセージログ

<HWS用リダイレクタログ出力ディレクトリ(JkLogFileDir)>/hws_redirect*.log

○

−

−

◎

△

旧バージョン互換HWS用リダイレクタのメッセージログ

<HWS用リダイレクタログ出力ディレクトリ(JkLogFileDir)>/hws_redirect*.log

○

−

−

◎

△

旧バージョン互換IIS用リダイレクタのメッセージログ

<IIS用リダイレクタログ出力ディレクトリ(log_file_dir)>/isapi_redirect*.log

○

−

−

△

△

保守ログ

HWS用リダイレクタの保守用トレースログ

<HWS用リダイレクタトレースログ出力ディレクトリ(JkTraceLogFileDir)>/hws_rd_trace*.log

○

−

−

◎

△

旧バージョン互換HWS用リダイレクタの保守用トレースログ

<HWS用リダイレクタトレースログ出力ディレクトリ(JkTraceLogFileDir)>/hws_rd_trace*.log

○

−

−

◎

△

旧バージョン互換ＩIS用リダイレクタの保守用トレースログ

<IIS用リダイレクタトレースログ出力ディレクトリ(trace_log_file_dir)>/iis_rd_trace*.log

○

−

−

△

△

定義情報

HWS用リダイレクタ動作定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名称>/mod_jk.conf

○

−

○

○

○

ワーカ定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名称>/workers.properties

○

−

○

○

○

旧バージョン互換HWS用リダイレクタ動作定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/mod_jk.conf

○

−

○

○

○

旧バージョン互換IIS用リダイレクタ動作定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/isapi_redirect.conf

○

−

○

○

○

旧バージョン互換用ワーカ定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/workers.properties

○

−

○

○

○

旧バージョン互換用マッピング定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/uriworkermap.properties

○

−

○

○

○

TP1/Message Queue-Access

保守ログ

API，およびApplication Serverインタフェースに関するメソッドトレース，メッセージログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/*.log

○

−

−

◎

△

APIトレース

APIトレースファイル

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/mqc.api*

○

−

−

◎

◎

TP1 Connector

メッセージログ

J2EEリソースアダプタとしてデプロイして使用するTP1 Connectorの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/*.log

○

−

−

◎

△

J2EEアプリケーションに含めて使用するTP1 Connectorの稼働ログ（通常モード）

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/<J2EEアプリケーション名>/*.log

○

−

−

◎

△

Non-managed 環境で使用する場合のTP1 Connector の稼働ログ

<TP1Connectorログ出力ディレクトリ(jp.co.hitachi_system.tp1connector.logdestination)>/tp1connector*.log

○

−

−

△

△

TP1/Client/J

そのほかのログ

デバッグトレース情報

<ユーザホームディレクトリ(user.home)>/TP1clientJ/dcClt*.dmp

−

○

−

△

△

Manager

メッセージログ

運用管理エージェントのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagent*.log

○

−

−

◎

○

運用管理エージェントの起動・停止コマンドのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagentctl.exe.*.log

○

−

−

◎

○

統合メッセージログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/message/mngmessage*.log

○

−

−

◎

○

運用管理エージェントサービスのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagentsv.exe.*.log

○

−

−

◎

○

運用監視エージェントのログ・トレース

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngagent*.*.log

○

−

−

◎

○

Management Serverサービスのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvr.exe.*.log

○

−

−

◎

○

Management Serverサービス起動・停止コマンドのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvrctl.exe.*.log

○

−

−

◎

○

Management Serverのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvr*.log

○

−

−

◎

○

そのほかのログ

運用管理エージェントの標準エラー出力

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagent.err.*.log

○

−

−

◎

○

運用管理エージェントの標準出力

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagent.out.*.log

○

−

−

◎

○

運用管理エージェントの標準エラー出力コマンドライン

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagent.err

○

−

−

◎

○

コンソールログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/processConsole*.log

○

−

−

◎

○

運用管理エージェントサービスの標準出力

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagentsv.exe.out

○

−

−

◎

○

運用管理エージェントサービスの標準エラー出力

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagentsv.exe.err

○

−

−

◎

○

Management Serverサービスの標準エラー出力

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvr.exe.err

○

−

−

◎

○

Management Serverサービスの標準出力

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvr.exe.out

○

−

−

◎

○

明示管理ヒープ機能で使用する自動配置用設定ファイル

<Application Serverインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/auto_explicit_memory.cfg

○

−

○

△

△

ユーザ拡張性能解析トレースで使用するユーザ拡張性能解析トレース設定ファイル

<Application Serverインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/userprf.cfg

○

−

○

△

△

セットアップウィザードなどのセットアップコマンドの定義ファイル

<Application Serverインストールディレクトリ>/manager/setup/config/*

○

−

○

○

○

セットアップウィザードなどのセットアップコマンドのログ

<Application Serverインストールディレクトリ>/manager/setup/log/*.log

○

−

−

△

△

保守ログ

コマンド保守ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/mngcmd*.log

−

○

−

○

○

運用管理エージェントの保守ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/adminagent*.log

○

−

−

○

○

運用管理エージェントが行うRMI処理での保守ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/mngrmi*.log

−

○

−

○

○

Management Serverの保守ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/mngsvr*.log

○

−

−

○

○

定義情報

運用管理エージェントプロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/adminagent.properties

○

−

○

○

○

運用管理エージェント用オプション定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/adminagentuser.cfg

○

−

○

○

○

運用管理エージェント設定ファイル

<Application Serverのインストールディレクトリ>/manager/config/adminagent.xml

○

−

○

○

○

運用監視エージェントプロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/mngagent.<サーバ名称>.properties

○

−

○

○

○

Management Server環境設定ファイル

<Application Serverのインストールディレクトリ>/manager/config/mserver.properties

○

−

○

○

○

Management Server用オプション定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/mserver.cfg

○

−

○

○

○

Management Server用環境変数定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/mserverenv.cfg

○

−

○

○

○

Manager設定ファイル

<Application Serverのインストールディレクトリ>/manager/config/manager.cfg

○

−

○

○

○

Managementアクション実行用プロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/maction.properties

○

−

○

○

○

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

<Application Serverのインストールディレクトリ>/manager/config/mevent.<サーバ名称>.properties

−

○

○

○

○

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

<Managementイベント発行用メッセージIDリストファイル(manager.mevent.message_id.list)>

−

○

○

×

×

mngsvrutilコマンドのクライアント側定義ファイル

<ユーザホームディレクトリ(user.home)>/.mngsvrutilrc

−

○

○

△

△

mngsvrutilコマンドのサーバ側定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/mngsvrutil.properties

○

−

○

○

○

mngsvrutilコマンドのクライアント側共通定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/mngsvrutilcl.properties

○

−

○

○

○

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

<ユーザホームディレクトリ(user.home)>/.mngsvrmonitorrc

−

○

○

△

△

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

<Application Serverのインストールディレクトリ>/manager/config/mserver.jp1event.system.mapping.properties

○

−

○

○

○

<Application Serverのインストールディレクトリ>/manager/config/manager.jp1event.system.mapping.properties

○

−

○

○

○

<Application Serverのインストールディレクトリ>/manager/config/manager.<サーバ名称>.jp1event.system.mapping.properties

○

−

○

○

○

性能，障害解析トレース

PRFトレースなど

<一時PRFトレースファイル出力用ディレクトリ(adminagent.prftrace_dir)>/*.zip

−

○

−

◎

×

内部インタフェーストレース

統合トレースログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/trace/mngtrace*.log

○

−

−

○

○

そのほか

OSの状態情報など

<Application Serverのインストールディレクトリ>/manager/tmp/*

○

−

−

○

○

Smart Composer

定義情報

サーバ設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/cmxserver.properties

○

−

○

○

○

クライアント設定プロパティファイル

<ユーザホームディレクトリ(user.home)>/.cmxrc

−

○

○

△

△

クライアント共通設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/cmxclient.properties

○

−

○

○

○

負荷分散機定義プロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/lb.properties

○

−

○

○

○

統合ユーザ管理

定義情報

JAASのコンフィグレーションファイル

<Application Serverのインストールディレクトリ>/manager/config/jaas.conf

○

−

○

○

○

統合ユーザ管理のコンフィグレーションファイル

<Application Serverのインストールディレクトリ>/manager/config/ua.conf

○

−

○

○

○

APIトレース

統合ユーザ管理のトレース

<統合ユーザ管理のトレースファイル名(com.cosminexus.admin.auth.trace.prefix)>.*.log

−

○

−

×

×

08-50モードの仮想サーバマネージャ※

定義情報

仮想サーバマネージャプロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmx.properties

○

−

○

×

○

仮想サーバマネージャのクライアント共通設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmxclient.properties

○

−

○

×

○

VMware vCenter Serverの接続処理のオプション定義ファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmx_avcs_usrconf.cfg

○

−

○

×

○

VMware vCenter Serverの接続処理のプロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmx_avcs_usrconf.properties

○

−

○

×

○

VMware vCenter Serverの接続処理の共通定義ファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmx_avcs_cjwconf.properties

○

−

○

×

○

そのほかのログ

仮想サーバマネージャで使用するcjclstartapコマンドのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/vmx_avcs_logs/**

−

○

−

×

○

仮想サーバから収集したログ情報

<08-50モードの仮想サーバマネージャログディレクトリ(vmx.log.dir)>/mngunit/*/*.zip

−

○

−

×

△

仮想サーバマネージャ

定義情報

仮想サーバマネージャプロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmi/config/vmi.properties

○

−

○

×

○

仮想サーバマネージャのクライアント設定プロパティファイル

<ユーザホームディレクトリ(user.home)>/.vmirc

−

○

○

△

△

仮想サーバマネージャのクライアント共通設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmi/config/vmiclient.properties

○

−

○

×

○

負荷分散機接続設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmi/config/lb/*.properties

○

−

○

×

○

サーバ通信エージェント

メッセージログ

サーバ通信エージェントのログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/sinaviagent*.log

○

−

−

×

○

サーバ通信エージェントのサービスのログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/sinaviagentsv*.log

○

−

−

×

△

snactlコマンドのログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/snactl*.log

○

−

−

×

△

そのほかのログ

サーバ通信エージェント起動時のエラー情報

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/sinaviagent.err

○

−

−

×

△

サーバ通信エージェントの標準出力

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/sinaviagent.out

○

−

−

×

△

サーバ通信エージェントが起動したコマンドのプロセスのコンソール出力情報

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/processConsole*.log

○

−

−

×

△

保守ログ

サーバ通信エージェントの保守ログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/maintenance/sinaviagent*.log

−

○

−

×

△

サーバ通信エージェントサービスの保守ログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/maintenance/sinaviagentsv*.log

−

○

−

×

△

snactlコマンドの保守ログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/maintenance/snactl*.log

−

○

−

×

△

サーバ通信エージェントのJavalog

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/maintenance/sinaviagent.javalog*.log

−

○

−

×

△

定義情報

サーバ通信エージェント用オプション定義ファイル

<Application Serverのインストールディレクトリ>/sinagent/config/sinaviagent.cfg

○

−

○

×

○

サーバ通信エージェントプロパティファイル

<Application Serverのインストールディレクトリ>/sinagent/config/sinaviagent.properties

○

−

○

×

○

Web Services - Base

メッセージログ

メッセージログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjmessage*.log

○

−

−

◎

△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/cjweb_message*.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/cjclmessage*.log

○

−

−

△

△

サーバトレース，クライアントトレース，デフォルトトレース，アプリケーションログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/WS/*.log

○

−

−

◎

△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/WS/*.log

○

−

−

△

○

クライアントトレース，デフォルトトレース，提供コマンドトレース，アプリケーションログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/WS/*.log

○

−

−

△

△

JAXRトレース

<JAXRトレースファイル名(com.cosminexus.xml.registry.trace.file_path)>*.log

○

−

−

△

△

定義情報

共通定義ファイル

<Application Serverのインストールディレクトリ>/c4web/conf/c4webcom.cfg

○

−

○

○

○

サーバ定義ファイル

<Application Serverのインストールディレクトリ>/c4web/conf/c4websv.cfg

○

−

○

○

○

サービスデプロイ定義

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/server-config.xml

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/server-config.xml

○

−

○

○

○

クライアント定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/c4webcl.properties

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/c4webcl.properties

○

−

○

○

○

この製品のJAX-WS機能

メッセージログ

cjwsimportコマンドの稼働ログ

<Application Serverのインストールディレクトリ>/jaxws/logs/cjwsimport*.log

○

−

−

○

○

aptコマンドの稼働ログ

<Application Serverのインストールディレクトリ>/jaxws/logs/cjwapt*.log

○

−

−

○

○

サービスおよびクライアントの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJW/cjwmessage*.log

○

−

−

◎

△

クライアントの稼働ログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/CJW/cjwmessage*.log

○

−

−

△

△

サービスおよびクライアントの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJR/cjrmessage*.log

○

−

−

◎

△

そのほかのログ

サービスおよびクライアントの通信ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJW/cjwtransport*.log

○

−

−

◎

△

クライアントの通信ログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/CJW/cjwtransport*.log

○

−

−

△

△

サービスおよびクライアントの通信ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJR/cjrtransport*.log

○

−

−

◎

△

例外ログ

cjwsimportコマンドの例外ログ

<Application Serverのインストールディレクトリ>/jaxws/logs/cjwsimportex*.log

○

−

−

○

○

aptコマンドの例外ログ

<Application Serverのインストールディレクトリ>/jaxws/logs/cjwaptex*.log

○

−

−

○

○

サービスおよびクライアントの例外ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJW/cjwexception*.log

○

−

−

◎

△

クライアントの例外ログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/CJW/cjwexception*.log

○

−

−

△

△

サービスおよびクライアントの例外ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJR/cjrexception*.log

○

−

−

◎

△

定義情報

動作定義ファイル

<Application Serverのインストールディレクトリ>/jaxws/conf/*.properties

○

−

○

○

○

プロセス別の動作定義ファイル

<プロセス別動作定義ファイル(com.cosminexus.jaxws.confpath)>

○

−

○

×

×

動作定義ファイル

<Application Serverインストールディレクトリ>/jaxrs/conf/*.properties

○

−

○

△

△

プロセス別の動作定義ファイル

<プロセス別動作定義ファイル(com.cosminexus.jaxrs.confpath)>

○

−

○

×

×

定義ファイル

web.xml

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/*/WEB-INF/web.xml

−

○

○

◎

◎

cosminexus-jaxws.xml

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/*/WEB-INF/cosminexus-jaxws.xml

−

○

○

◎

◎

ハンドラチェイン設定ファイル

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/**

−

○

○

×

×

WSDL

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/*/WEB-INF/wsdl/*

−

○

○

◎

◎

カタログファイル

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/*/WEB-INF/classes/META-INF/jax-ws-catalog.xml

−

○

○

◎

◎

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/apps/*/*/*/jax-ws-catalog.xml

−

○

○

◎

◎

CJPAプロバイダ

メッセージログ

CJPAプロバイダの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjpa/cjpaoperation*.log

○

−

−

◎

△

PRFデーモンおよびPRFコマンドのログ

<PRFスプールディレクトリ(prfspool)>/log/<PRF識別子>/ctmlog*

○

−

−

◎

△

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/*.log

○

−

−

◎

△

メッセージログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjmessage*.log

○

−

−

◎

△

そのほかのログ

障害発生時の例外情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjexception*.log

○

−

−

◎

△

定義情報

J2EEサーバ用オプション定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/*.cfg

○

−

○

○

○

J2EEサーバ用ユーザプロパティファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/*.properties

○

−

○

○

○

J2EEサーバ用セキュリティポリシーファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/*.policy

○

−

○

○

○

ユーザデータ

EJBサーバ作業ディレクトリの内容

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/**

−

○

−

×

×

Webコンテナ作業ディレクトリの内容

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/**

−

○

−

×

×

CJMSプロバイダ

メッセージログ

CJMSPブローカーのログ

<Application Serverのインストールディレクトリ>/CC/cjmsp/var/instances/<インスタンス名>/log/*.log

○

−

−

△

△

管理コマンドのログ

<Application Serverのインストールディレクトリ>/CC/cjmsp/var/admin/log/*.log

○

−

−

△

△

CJMSPリソースアダプタのログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjms/<リソースアダプタ名>/*.log

○

−

−

◎

△

定義情報

CJMSPブローカー共通プロパティファイル

<Application Serverのインストールディレクトリ>/CC/cjmsp/lib/props/broker/commonconfig.properties

○

−

○

○

○

CJMSPブローカー個別プロパティファイル

<Application Serverのインストールディレクトリ>/CC/cjmsp/var/instances/<インスタンス名>/props/config.properties

○

−

○

△

△

管理コマンド定義ファイル

<Application Serverのインストールディレクトリ>/CC/cjmsp/var/admin/config/admin.properties

○

−

○

△

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注※　08-50モードの仮想サーバマネージャは，このバージョンでは使用できません。デフォルトの収集先が収集対象です。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒6　Component Containerに関連する収集対象（UNIXの場合）

分類

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

J2EEサーバ

メッセージログ

稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjmessage*.log

○

−

−

◎

△

ログ稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjlogger.log

○

−

−

◎

△

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/*.log

○

−

−

◎

△

J2EEアプリケーションに含めて使用するリソースアダプタの稼働ログ（通常モード）

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/<J2EEアプリケーション名>/*.log

○

−

−

◎

△

J2EEアプリケーションに含めて使用するリソースアダプタの稼働ログ（テストモード）

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/TEST#<J2EEアプリケーション名>/*.log

○

−

−

◎

△

Webサーブレットログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/web_servlet*.log

○

−

−

◎

△

そのほかのログ

ユーザ出力ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/user_out*.log

○

−

−

◎

△

ユーザエラーログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/user_err*.log

○

−

−

◎

△

JavaVMの保守情報およびGCのログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/javalog*.log

○

−

−

◎

△

JavaVMの明示管理ヒープ機能イベントログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/ehjavalog*.log

○

−

−

◎

△

開発調査ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjdevelopment*.log

○

−

−

◎

△

障害発生時の例外情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjexception*.log

○

−

−

◎

△

JavaVMイベントログ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/hs_err*

○

−

−

◎

◎

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/replay_pid*.log

○

−

−

◎

◎

J2EEアプリケーションのユーザログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/user/*

○

−

−

◎

△

保守ログ

保守情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjmaintenance*.log

○

−

−

◎

△

コンソールメッセージ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjconsole*.log

○

−

−

◎

△

EJBコンテナの保守情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjejbcontainer*.log

○

−

−

◎

△

Webコンテナの保守情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjwebcontainer*.log

○

−

−

◎

△

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

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjstdout*.log

○

−

−

◎

△

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

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cjstderr*.log

○

−

−

◎

△

終了プロセス情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CC/maintenance/cj_shutdown*.log

○

−

−

◎

△

ダンプ

スレッドダンプ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/javacore*

○

−

−

◎

◎

coreダンプ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/core*

−

○

−

◎

◎

統計情報

稼働情報ファイル

<稼働情報ファイル出力先ディレクトリ(ejbserver.management.stats_file.dir)>/*

−

○

−

◎

△

メモリ監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjmemorywatch*.log

○

−

−

◎

△

ファイルディスクリプタ監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjfiledescriptorwatch*.log

○

−

−

◎

△

スレッド監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjthreadwatch*.log

○

−

−

◎

△

スレッドダンプ監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjthreaddumpwatch*.log

○

−

−

◎

△

HTTPリクエスト実行待ちキュー監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjrequestqueuewatch*.log

○

−

−

◎

△

HTTPセッション数監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjhttpsessionwatch*.log

○

−

−

◎

△

コネクションプール監視ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/watch/cjconnectionpoolwatch*.log

○

−

−

◎

△

定義情報

J2EEサーバ用オプション定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

○

−

○

○

○

J2EEサーバ用ユーザプロパティファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

○

−

○

○

○

J2EEサーバ用セキュリティポリシーファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/server.policy

○

−

○

○

○

MNGで作成した各種定義ファイルのバックアップ

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/*

−

○

−

○

○

保護区リストファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/criticalList.cfg

○

−

○

○

○

リソース設定情報

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/import/**

−

○

−

×

×

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/rars/**

−

○

−

×

×

保守情報

<Cosminexusインストールディレクトリ>/CC/server/version/**

○

−

○

○

○

そのほか

J2EEサーバの起動，停止または異常終了を示すログ

<UNIXのsyslog(syslog)>

○

−

−

△

△

ユーザデータ

EJBサーバ作業ディレクトリの内容

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/**

−

○

−

×

×

Webコンテナ作業ディレクトリの内容

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/**

−

○

−

×

×

JSP用一時ディレクトリの内容

<JSP用一時ディレクトリ(webserver.work.directory)>/**

−

○

−

×

×

サーバ管理コマンド

メッセージログ

稼働ログ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/cjmessage*.log

○

−

−

△

△

ログ稼働ログ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/cjlogger.log

○

−

−

△

△

互換モードの稼働ログ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*message*.log

○

−

−

△

△

そのほかのログ

障害発生時の例外情報

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/cjexception*.log

○

−

−

△

△

互換モードの障害発生時の例外情報

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*exception*.log

○

−

−

△

△

保守ログ

保守情報

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/CC/maintenance/cjmaintenance*.log

○

−

−

△

△

コンソールメッセージ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/CC/maintenance/cjconsole*.log

○

−

−

△

△

サーバ管理コマンドの保守情報

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/CC/maintenance/cjserveradmin*.log

○

−

−

△

△

そのほかのログ

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*/*

○

−

−

△

△

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*/*/*

○

−

−

△

△

<サーバ管理コマンドログ出力ディレクトリ(admin_ejb.server.log.directory)>/*/*/*/*

−

○

−

△

△

定義情報

サーバ管理コマンド用定義ファイル

<Application Serverのインストールディレクトリ>/CC/admin/usrconf/*

○

−

−

○

○

バッチアプリケーション

メッセージログ

cjexecjobコマンド，cjkilljobコマンドおよびcjlistjobコマンドの稼働ログ

<バッチアプリケーションログ出力ディレクトリ(batch.log.directory)>/cjmessage*.log

○

−

−

△

△

保守ログ

そのほかのログ

<バッチアプリケーションログ出力ディレクトリ(batch.log.directory)>/*/*

○

−

−

△

△

定義情報

バッチアプリケーション用オプション定義ファイル

<バッチアプリケーションの定義ファイル格納ディレクトリ>/usrconf.cfg

○

−

−

×

×

バッチアプリケーション用ユーザプロパティファイル

<バッチアプリケーションの定義ファイル格納ディレクトリ>/usrconf.properties

○

−

−

×

×

リソースアダプタバージョンアップコマンド（cjrarupdate）

メッセージログ

稼働ログ

<Application Serverのインストールディレクトリ>/CC/logs/cjrarupdatemessage*.log

○

−

−

○

○

そのほかのログ

障害発生時の例外情報

<Application Serverのインストールディレクトリ>/CC/logs/cjrarupdateexception*.log

○

−

−

○

○

保守ログ

保守情報

<Application Serverのインストールディレクトリ>/CC/logs/cjrarupdatemaintenance*.log

○

−

−

○

○

インプロセスHTTPサーバ

アクセスログ

インプロセスHTTPサーバの処理結果

<インプロセスHTTPサーバアクセスログファイル(webserver.logger.access_log.inprocess_http.filename)>*.log

○

−

−

◎

△

モジュールトレース

スレッドトレースの情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/http/maintenance/thr/cjhttp_thr.*.inprocess_http.mm

○

−

−

◎

△

通信トレース

通信トレースの情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/http/maintenance/comm/cjhttp_comm.*.inprocess_http.mm

○

−

−

◎

△

NIO HTTPサーバ

アクセスログ

NIO HTTPサーバ（HTTP）の処理結果

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cj_access_niohttp*.log

○

−

−

◎

△

NIO HTTPサーバ（WebSocket）の処理結果

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cj_access_websocket*.log

○

−

−

◎

△

移行コマンド（cjenvupdate）

メッセージログ

cjenvupdateコマンドの稼働ログ

<Application Serverのインストールディレクトリ>/CC/logs/cjenvupdatemessage*.log

○

−

−

○

○

そのほかのログ

cjenvupdateコマンドの例外情報

<Application Serverのインストールディレクトリ>/CC/logs/cjenvupdateexception*.log

○

−

−

○

○

保守ログ

cjenvupdateコマンドの保守情報

<Application Serverのインストールディレクトリ>/CC/logs/cjenvupdatemaintenance*.log

○

−

−

○

○

CC管理者変更コマンド

メッセージログ

cjenvsetupコマンドの稼働ログ

<Application Serverのインストールディレクトリ>/CC/logs/cjenvsetupmessage*.log

○

−

−

○

○

そのほか

cjenvsetupコマンドの実行前ファイル構成情報

<Application Serverのインストールディレクトリ>/CC/logs/before_cjenvsetup_files*.txt

○

−

−

○

○

cjenvsetupコマンドの実行後ファイル構成情報

<Application Serverのインストールディレクトリ>/CC/logs/after_cjenvsetup_files*.txt

○

−

−

○

○

インプロセストランザクションサービス

そのほか

インプロセストランザクションサービスのステータスファイル

<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)>/*

−

○

−

◎

△

<ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory1)>/*/*

−

○

−

◎

△

インプロセストランザクションサービスの予備ステータスファイル

<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)>/*

−

○

−

◎

×

<予備ステータスファイルのディレクトリ(ejbserver.distributedtx.ots.status.directory2)>/*/*

−

○

−

◎

×

EJBクライアント

メッセージログ

稼働ログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/cjclmessage*.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/cjclmessage*.log

○

−

−

×

×

cjclstartapコマンドの稼働ログ

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/cjclstartap*.log

○

−

−

×

×

cjcldellogコマンドの稼働ログ

<Application Serverのインストールディレクトリ>/CC/client/logs/cjcldellog.log

○

−

−

○

○

そのほかのログ

ユーザ出力ログ

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/user_out*.log

○

−

−

×

×

ユーザエラーログ

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/user_err*.log

○

−

−

×

×

JavaVMの保守情報，GCのログ

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/javalog*.log

○

−

−

×

×

障害発生時の例外情報

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/cjclexception*.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/cjclexception*.log

○

−

−

×

×

EJBクライアントアプリケーションのユーザログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/user/*

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/user/*

○

−

−

×

×

保守ログ

保守情報

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/cjclmaintenance*.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjclmaintenance*.log

○

−

−

×

×

EJBコンテナの保守情報

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjejbcontainer*.log

○

−

−

×

×

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

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjstdout*.log

○

−

−

×

×

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

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/<EJBクライアントログサブディレクトリ1(ejb.client.ejb.log)>/<EJBクライアントログサブディレクトリ2(ejb.client.log.appid)>/maintenance/cjstderr*.log

○

−

−

×

×

ログの稼働情報

<EJBクライアントログ出力ディレクトリ(ejb.client.log.directory)>/cjlogger.log

○

−

−

×

×

定義情報

EJBクライアント用オプション定義ファイル

<EJBクライアントの定義ファイル格納ディレクトリ>/usrconf.cfg

○

−

−

×

×

EJBクライアント用ユーザプロパティファイル

<EJBクライアントの定義ファイル格納ディレクトリ>/usrconf.properties

○

−

−

×

×

リダイレクタ（Webサーバ）

メッセージログ

HWS用リダイレクタのメッセージログ

<HWS用リダイレクタログ出力ディレクトリ(JkLogFileDir)>/hws_redirect*.log

○

−

−

◎

△

旧バージョン互換HWS用リダイレクタのメッセージログ

<HWS用リダイレクタログ出力ディレクトリ(JkLogFileDir)>/hws_redirect*.log

○

−

−

◎

△

保守ログ

HWS用リダイレクタの保守用トレースログ

<HWS用リダイレクタトレースログ出力ディレクトリ(JkTraceLogFileDir)>/hws_rd_trace*.log

○

−

−

◎

△

旧バージョン互換HWS用リダイレクタの保守用トレースログ

<HWS用リダイレクタトレースログ出力ディレクトリ(JkTraceLogFileDir)>/hws_rd_trace*.log

○

−

−

◎

△

定義情報

HWS用リダイレクタ動作定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名称>/mod_jk.conf

○

−

○

○

○

ワーカ定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名称>/workers.properties

○

−

○

○

○

旧バージョン互換HWS用リダイレクタ動作定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/mod_jk.conf

○

−

−

○

○

旧バージョン互換用ワーカ定義ファイル

<Application Serverのインストールディレクトリ>/CC/web/redirector/workers.properties

○

−

−

○

○

TP1/Message Queue-Access

保守ログ

API，およびApplication Serverインタフェースに関するメソッドトレース，メッセージログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/*.log

○

−

−

◎

△

APIトレース

APIトレースファイル

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/mqc.api*

○

−

−

◎

◎

TP1 Connector

メッセージログ

J2EEリソースアダプタとしてデプロイして使用するTP1 Connectorの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/*.log

○

−

−

◎

△

J2EEアプリケーションに含めて使用するTP1 Connectorの稼働ログ（通常モード）

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/<J2EEアプリケーション名>/*.log

○

−

−

◎

△

Non-managed 環境で使用する場合のTP1 Connector の稼働ログ

<TP1Connectorログ出力ディレクトリ(jp.co.hitachi_system.tp1connector.logdestination)>/tp1connector*.log

○

−

−

△

△

TP1/Client/J

そのほかのログ

デバッグトレース情報

<ユーザホームディレクトリ(user.home)>/TP1clientJ/dcClt*.dmp

−

○

−

△

△

Manager

メッセージログ

統合メッセージログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/message/mngmessage*.log

○

−

−

◎

○

運用管理エージェントのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagent*.log

○

−

−

◎

○

運用管理エージェントの起動・停止コマンドのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagentctl.*.log

○

−

−

◎

○

運用監視エージェントのログ・トレース

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngagent*.*.log

○

−

−

◎

○

Management Server起動コマンドのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvrctlstart.*.log

○

−

−

◎

○

Management Server停止コマンドのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvrctlstop.*.log

○

−

−

◎

○

Management Serverセットアップコマンドのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvrctlsetup.*.log

○

−

−

◎

○

Management Serverのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/mngsvr*.log

○

−

−

◎

○

そのほかのログ

運用管理エージェントの標準エラー出力

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagent.err.*.log

○

−

−

◎

○

運用管理エージェントの標準出力

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagent.out.*.log

○

−

−

◎

○

運用管理エージェントの標準エラー出力コマンドライン

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/adminagent.err

○

−

−

◎

○

コンソールログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/processConsole*.log

○

−

−

◎

○

明示管理ヒープ機能で使用する自動配置用設定ファイル

<Application Serverインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/auto_explicit_memory.cfg

○

−

○

△

△

ユーザ拡張性能解析トレースで使用するユーザ拡張性能解析トレース設定ファイル

<Application Serverインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/userprf.cfg

○

−

○

△

△

セットアップウィザードなどのセットアップコマンドの定義ファイル

<Application Serverインストールディレクトリ>/manager/setup/config/*

○

−

○

○

○

セットアップウィザードなどのセットアップコマンドのログ

<Application Serverインストールディレクトリ>/manager/setup/log/*.log

○

−

−

△

△

保守ログ

コマンド保守ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/mngcmd*.log

−

○

−

○

○

運用管理エージェントが行うRMI処理での保守ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/mngrmi*.log

−

○

−

○

○

運用管理エージェントの保守ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/adminagent*.log

○

−

−

○

○

mngenvsetupコマンドの実行ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/mngenvsetup*.log

−

○

−

○

○

Management Serverの保守ログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/maintenance/mngsvr*.log

○

−

−

○

○

定義情報

運用管理エージェントプロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/adminagent.properties

○

−

○

○

○

運用管理エージェント自動起動用設定ファイル

<Application Serverのインストールディレクトリ>/manager/config/AdminAgentrc

○

−

○

○

○

運用管理エージェント用オプション定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/adminagentuser.cfg

○

−

○

○

○

運用管理エージェント設定ファイル

<Application Serverのインストールディレクトリ>/manager/config/adminagent.xml

○

−

○

○

○

運用監視エージェントプロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/mngagent.<サーバ名称>.properties

○

−

○

○

○

Management Server環境設定ファイル

<Application Serverのインストールディレクトリ>/manager/config/mserver.properties

○

−

○

○

○

Management Server用オプション定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/mserver.cfg

○

−

○

○

○

Management Server用環境変数定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/mserverenv.cfg

○

−

○

○

○

Manager設定ファイル

<Application Serverのインストールディレクトリ>/manager/config/manager.cfg

○

−

○

○

○

Managementアクション実行用プロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/maction.properties

○

−

○

○

○

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

<Application Serverのインストールディレクトリ>/manager/config/mevent.<サーバ名称>.properties

−

○

○

○

○

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

<Managementイベント発行用メッセージIDリストファイル(manager.mevent.message_id.list)>

−

○

○

×

×

mngsvrutilコマンドのクライアント側定義ファイル

<ユーザホームディレクトリ(user.home)>/.mngsvrutilrc

−

○

○

△

△

mngsvrutilコマンドのサーバ側定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/mngsvrutil.properties

○

−

○

○

○

mngsvrutilコマンドのクライアント側共通定義ファイル

<Application Serverのインストールディレクトリ>/manager/config/mngsvrutilcl.properties

○

−

○

○

○

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

<Application Serverのインストールディレクトリ>/manager/config/mserver.jp1event.system.mapping.properties

○

−

○

○

○

<Application Serverのインストールディレクトリ>/manager/config/manager.jp1event.system.mapping.properties

○

−

○

○

○

<Application Serverのインストールディレクトリ>/manager/config/manager.<サーバ名称>.jp1event.system.mapping.properties

○

−

○

○

○

性能，障害解析トレース

PRFトレースなど

<一時PRFトレースファイル出力用ディレクトリ(adminagent.prftrace_dir)>/*.zip

−

○

−

◎

×

内部インタフェーストレース

統合トレースログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/trace/mngtrace*.log

○

−

−

○

○

そのほか

OSの状態情報など

<Application Serverのインストールディレクトリ>/manager/tmp/*

○

−

−

○

○

Smart Composer

定義情報

サーバ設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/cmxserver.properties

○

−

○

○

○

クライアント設定プロパティファイル

<ユーザホームディレクトリ(user.home)>/.cmxrc

−

○

○

△

△

クライアント共通設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/cmxclient.properties

○

−

○

○

○

負荷分散機定義プロパティファイル

<Application Serverのインストールディレクトリ>/manager/config/lb.properties

○

−

○

○

○

統合ユーザ管理

定義情報

JAASのコンフィグレーションファイル

<Application Serverのインストールディレクトリ>/manager/config/jaas.conf

○

−

○

○

○

統合ユーザ管理のコンフィグレーションファイル

<Application Serverのインストールディレクトリ>/manager/config/ua.conf

○

−

○

○

○

APIトレース

統合ユーザ管理のトレース

<統合ユーザ管理のトレースファイル名(com.cosminexus.admin.auth.trace.prefix)>.*.log

−

○

−

×

×

08-50モードの仮想サーバマネージャ※

定義情報

仮想サーバマネージャプロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmx.properties

○

−

○

×

○

仮想サーバマネージャのクライアント共通設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmxclient.properties

○

−

○

×

○

VMware vCenter Serverの接続処理のオプション定義ファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmx_avcs_usrconf.cfg

○

−

○

×

○

VMware vCenter Serverの接続処理のプロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmx_avcs_usrconf.properties

○

−

○

×

○

VMware vCenter Serverの接続処理の共通定義ファイル

<Application Serverのインストールディレクトリ>/manager/vmx/config/vmx_avcs_cjwconf.properties

○

−

○

×

○

そのほかのログ

仮想サーバマネージャで使用するcjclstartapコマンドのログ

<Managerログ出力ディレクトリ(com.cosminexus.manager.log.dir)>/vmx_avcs_logs/**

−

○

−

×

○

仮想サーバから収集したログ情報

<08-50モードの仮想サーバマネージャログディレクトリ(vmx.log.dir)>/mngunit/*/*.zip

−

○

−

×

△

仮想サーバマネージャ

定義情報

仮想サーバマネージャプロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmi/config/vmi.properties

○

−

○

×

○

仮想サーバマネージャのクライアント設定プロパティファイル

<ユーザホームディレクトリ(user.home)>/.vmirc

−

○

○

△

△

仮想サーバマネージャのクライアント共通設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmi/config/vmiclient.properties

○

−

○

×

○

負荷分散機接続設定プロパティファイル

<Application Serverのインストールディレクトリ>/manager/vmi/config/lb/*.properties

○

−

○

×

○

サーバ通信エージェント

メッセージログ

サーバ通信エージェントのログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/sinaviagent*.log

○

−

−

×

○

サーバ通信エージェントのサービスのログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/sinaviagentsv*.log

○

−

−

×

△

snactlコマンドのログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/snactl*.log

○

−

−

×

△

そのほかのログ

サーバ通信エージェント起動時のエラー情報

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/sinaviagent.err

○

−

−

×

△

サーバ通信エージェントの標準出力

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/sinaviagent.out

○

−

−

×

△

サーバ通信エージェントが起動したコマンドのプロセスのコンソール出力情報

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/processConsole*.log

○

−

−

×

△

保守ログ

サーバ通信エージェントの保守ログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/maintenance/sinaviagent*.log

−

○

−

×

△

snactlコマンドの保守ログ

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/maintenance/snactl*.log

−

○

−

×

△

サーバ通信エージェントのJavalog

<サーバ通信エージェントログ出力ディレクトリ(sinaviagent.log.dir)>/maintenance/sinaviagent.javalog*.log

−

○

−

×

△

定義情報

サーバ通信エージェント用オプション定義ファイル

<Application Serverのインストールディレクトリ>/sinagent/config/sinaviagent.cfg

○

−

○

×

○

サーバ通信エージェントプロパティファイル

<Application Serverのインストールディレクトリ>/sinagent/config/sinaviagent.properties

○

−

○

×

○

Web Services - Base

メッセージログ

メッセージログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjmessage*.log

○

−

−

◎

△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/cjweb_message*.log

○

−

−

△

△

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/cjclmessage*.log

○

−

−

△

△

サーバトレース，クライアントトレース，デフォルトトレース，アプリケーションログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/WS/*.log

○

−

−

◎

△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/WS/*.log

○

−

−

△

○

クライアントトレース，デフォルトトレース，提供コマンドトレース，アプリケーションログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/WS/*.log

○

−

−

△

△

JAXRトレース

<JAXRトレースファイル名(com.cosminexus.xml.registry.trace.file_path)>*.log

○

−

−

△

△

定義情報

共通定義ファイル

<Application Serverのインストールディレクトリ>/c4web/conf/c4webcom.cfg

○

−

○

○

○

サーバ定義ファイル

<Application Serverのインストールディレクトリ>/c4web/conf/c4websv.cfg

○

−

○

○

○

サービスデプロイ定義

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/server-config.xml

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/server-config.xml

○

−

○

○

○

クライアント定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/c4webcl.properties

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/c4webcl.properties

○

−

○

○

○

この製品のJAX-WS機能

メッセージログ

サービスおよびクライアントの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJW/cjwmessage*.log

○

−

−

◎

△

クライアントの稼働ログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/CJW/cjwmessage*.log

○

−

−

△

△

サービスおよびクライアントの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJR/cjrmessage*.log

○

−

−

◎

△

そのほかのログ

サービスおよびクライアントの通信ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJW/cjwtransport*.log

○

−

−

◎

△

クライアントの通信ログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/CJW/cjwtransport*.log

○

−

−

△

△

サービスおよびクライアントの通信ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJR/cjrtransport*.log

○

−

−

◎

△

例外ログ

サービスおよびクライアントの例外ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJW/cjwexception*.log

○

−

−

◎

△

クライアントの例外ログ

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/CJW/cjwexception*.log

○

−

−

△

△

サービスおよびクライアントの例外ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CJR/cjrexception*.log

○

−

−

◎

△

定義情報

動作定義ファイル

<Application Serverのインストールディレクトリ>/jaxws/conf/*.properties

○

−

○

○

○

プロセス別の動作定義ファイル

<プロセス別動作定義ファイル(com.cosminexus.jaxws.confpath)>

○

−

○

×

×

動作定義ファイル

<Application Serverインストールディレクトリ>/jaxrs/conf/*.properties

○

−

○

△

△

プロセス別の動作定義ファイル

<プロセス別動作定義ファイル(com.cosminexus.jaxrs.confpath)>

○

−

○

×

×

定義ファイル

web.xml

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/*/WEB-INF/web.xml

−

○

○

◎

◎

cosminexus-jaxws.xml

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/*/WEB-INF/cosminexus-jaxws.xml

−

○

○

◎

◎

ハンドラチェイン設定ファイル

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/**

−

○

○

×

×

WSDL

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/*/WEB-INF/wsdl/*

−

○

○

◎

◎

カタログファイル

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/*/WEB-INF/classes/META-INF/jax-ws-catalog.xml

−

○

○

◎

◎

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/apps/*/*/*/jax-ws-catalog.xml

−

○

○

◎

◎

CJPAプロバイダ

メッセージログ

CJPAプロバイダの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjpa/cjpaoperation*.log

○

−

−

◎

△

PRFデーモンおよびPRFコマンドのログ

<PRFスプールディレクトリ(prfspool)>/log/<PRF識別子>/ctmlog*

○

−

−

◎

△

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの稼働ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/connectors/*.log

○

−

−

◎

△

メッセージログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjmessage*.log

○

−

−

◎

△

そのほかのログ

障害発生時の例外情報

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjexception*.log

○

−

−

◎

△

定義情報

J2EEサーバ用オプション定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/*.cfg

○

−

○

○

○

J2EEサーバ用ユーザプロパティファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/*.properties

○

−

○

○

○

J2EEサーバ用セキュリティポリシーファイル

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名称>/*.policy

○

−

○

○

○

ユーザデータ

EJBサーバ作業ディレクトリの内容

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/**

−

○

−

×

×

Webコンテナ作業ディレクトリの内容

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/web/<サーバ名称>/**

−

○

−

×

×

CJMSプロバイダ

メッセージログ

CJMSPブローカーのログ

<Application Serverのインストールディレクトリ>/CC/cjmsp/var/instances/<インスタンス名>/log/*.log

○

−

−

△

△

管理コマンドのログ

<Application Serverのインストールディレクトリ>/CC/cjmsp/var/admin/log/*.log

○

−

−

△

△

CJMSPリソースアダプタのログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/cjms/<リソースアダプタ名>/*.log

○

−

−

◎

△

定義情報

CJMSPブローカー共通プロパティファイル

<Application Serverのインストールディレクトリ>/CC/cjmsp/lib/props/broker/commonconfig.properties

○

−

○

○

○

CJMSPブローカー個別プロパティファイル

<Application Serverのインストールディレクトリ>/CC/cjmsp/var/instances/<インスタンス名>/props/config.properties

○

−

○

△

△

管理コマンド定義ファイル

<Application Serverのインストールディレクトリ>/CC/cjmsp/var/admin/config/admin.properties

○

−

○

△

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注※　08-50モードの仮想サーバマネージャは，このバージョンでは使用できません。デフォルトの収集先が収集対象です。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.3　Component Transaction Monitor

Component Transaction Monitorに関連する収集対象を次の表に示します。

表A‒7　Component Transaction Monitorに関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

CTMデーモンおよびCTMコマンドのログ

<CTMスプールディレクトリ(ctmspool)>/log/<CTM識別子>/ctmlog*

○

−

−

◎

△

CTMドメインマネジャのログ

<CTMスプールディレクトリ(ctmspool)>/log/ctmdmlog*

○

−

−

◎

△

ダンプ

スレッドダンプ

<Application Serverのインストールディレクトリ>/TPB/logj/javacore*

○

−

−

○

○

定義情報

CTMレギュレータの設定ファイル

<CTMレギュレータの設定ファイル(ctm.RegOption)>

○

−

−

◎

×

OTMゲートウェイの設定ファイル

<OTMゲートウェイの設定ファイル(ctm.TSCGwOption)>

○

−

−

◎

×

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒8　Component Transaction Monitorに関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

CTMデーモンおよびCTMコマンドのログ

<CTMスプールディレクトリ(ctmspool)>/log/<CTM識別子>/ctmlog*

○

−

−

◎

△

CTMドメインマネジャのログ

<CTMスプールディレクトリ(ctmspool)>/log/ctmdmlog*

○

−

−

◎

△

ダンプ

スレッドダンプ

<Application Serverのインストールディレクトリ>/TPB/logj/javacore*

○

−

−

○

○

coreダンプ

<Application Serverのインストールディレクトリ>/TPB/logj/core*

−

○

−

○

○

定義情報

CTMレギュレータの設定ファイル

<CTMレギュレータの設定ファイル(ctm.RegOption)>

○

−

−

◎

×

OTMゲートウェイの設定ファイル

<OTMゲートウェイの設定ファイル(ctm.TSCGwOption)>

○

−

−

◎

×

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.4　DABroker Library

DABroker Libraryに関連する収集対象を次の表に示します。

表A‒9　DABroker Libraryに関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

定義情報

動作環境定義ファイル

<Application Serverのインストールディレクトリ>/DAB/conf/dasysconf

○

−

○

○

○

接続先データベース定義ファイル

<Application Serverのインストールディレクトリ>/DAB/conf/dadbenv

○

−

○

○

○

そのほか

スプール情報

<Application Serverのインストールディレクトリ>/DAB/spool/*

○

−

−

○

○

<Application Serverのインストールディレクトリ>/DAB/spool/*/*

−

○

−

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒10　DABroker Libraryに関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

定義情報

動作環境定義ファイル

<DABroker運用ディレクトリ(dabroker)>/conf/dasysconf

○

−

○

△

△

接続先データベース定義ファイル

<DABroker運用ディレクトリ(dabroker)>/conf/dadbenv

○

−

○

△

△

そのほか

スプール情報

<DABroker運用ディレクトリ(dabroker)>/spool/*

○

−

−

△

△

<DABroker運用ディレクトリ(dabroker)>/spool/*/*

−

○

−

△

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.5　Developer's Kit for Java

Developer's Kit for Javaに関連する収集対象を次の表に示します。

表A‒11　Developer's Kit for Javaに関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

ダンプ

クラッシュダンプ

<Windowsのクラッシュダンプファイル(CrashDumpFile)>

−

○

−

△

△

<Windowsのクラッシュダンプ出力ディレクトリ(CrashDumpDir)>/*.dmp

−

○

−

△

△

定義情報

ユーザ拡張性能解析トレース設定ファイル

<ユーザ拡張性能解析トレース設定ファイル(jvm.userprf.File)>

○

−

○

△

△

明示管理ヒープ機能適用除外設定ファイル

<明示管理ヒープ機能適用除外設定ファイル名(jvm.exmemexcludeclass.File)>

○

−

○

△

△

明示管理ヒープ機能適用除外設定の無効化対象設定ファイル

<明示管理ヒープ機能適用除外設定の無効化対象設定ファイル名(jvm.exmemnotexcludeclass.File)>

○

−

○

△

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒12　Developer's Kit for Javaに関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

定義情報

ユーザ拡張性能解析トレース設定ファイル

<ユーザ拡張性能解析トレース設定ファイル(jvm.userprf.File)>

○

−

○

△

△

明示管理ヒープ機能適用除外設定ファイル

<明示管理ヒープ機能適用除外設定ファイル名(jvm.exmemexcludeclass.File)>

○

−

○

△

△

明示管理ヒープ機能適用除外設定の無効化対象設定ファイル

<明示管理ヒープ機能適用除外設定の無効化対象設定ファイル名(jvm.exmemnotexcludeclass.File)>

○

−

○

△

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.6　Performance Tracer

Performance Tracerに関連する収集対象を次の表に示します。

表A‒13　Performance Tracerに関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

PRFデーモンおよびPRFコマンドのログ

<PRFスプールディレクトリ(prfspool)>/log/<PRF識別子>/ctmlog*

○

−

−

◎

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒14　Performance Tracerに関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

PRFデーモンおよびPRFコマンドのログ

<PRFスプールディレクトリ(prfspool)>/log/<PRF識別子>/ctmlog*

○

−

−

◎

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.7　Web Services - Security

Web Services - Securityに関連する収集対象を次の表に示します。

表A‒15　Web Services - Securityに関連する収集対象（Windowsの場合）

分類

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

Web Services - Security

メッセージログ

コマンドトレース，クライアントトレース

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/WS/*.log

○

−

−

△

△

サーバトレース，クライアントトレース

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/WS/*.log

○

−

−

◎

△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/WS/*.log

○

−

−

△

△

定義情報

環境設定ファイル

<Application Serverのインストールディレクトリ>/wss/conf/cwsscfg.properties

○

−

○

○

○

クライアントデプロイ定義

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/client-config.xml

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/client-config.xml

○

−

○

○

○

ポリシー定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/policy-config.xml

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/policy-config.xml

○

−

○

○

○

機能定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/security-config.xml

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/security-config.xml

○

−

○

○

○

XML Security - Core

保守ログ

メソッド呼び出しなどのトレース保守情報

<XML Security - Core トレース出力ディレクトリ(com.cosminexus.xml.security.logging.trace_dir)>/*.log

○

−

−

△

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒16　Web Services - Securityに関連する収集対象（UNIXの場合）

分類

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

Web Services - Security

メッセージログ

コマンドトレース，クライアントトレース

<EJBクライアントログ出力ディレクトリ(ejbserver.client.log.directory)>/<サブディレクトリ1(ejbserver.client.ejb.log)>/<サブディレクトリ2(ejbserver.client.log.appid)>/WS/*.log

○

−

−

△

△

サーバトレース，クライアントトレース

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/WS/*.log

○

−

−

◎

△

<Webコンテナサーバログ出力ディレクトリ(web.server.log.directory)>/WS/*.log

○

−

−

△

△

定義情報

環境設定ファイル

<Application Serverのインストールディレクトリ>/wss/conf/cwsscfg.properties

○

−

○

○

○

クライアントデプロイ定義

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/client-config.xml

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/client-config.xml

○

−

○

○

○

ポリシー定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/policy-config.xml

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/policy-config.xml

○

−

○

○

○

機能定義ファイル

<Application Serverのインストールディレクトリ>/CC/server/public/web/<サーバ名称>/<コンテキストルート>/WEB-INF/classes/security-config.xml

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CC/web/containers/<サーバ名称>/webapps/<コンテキストルート>/WEB-INF/classes/security-config.xml

○

−

○

○

○

XML Security - Core

保守ログ

メソッド呼び出しなどのトレース保守情報

<XML Security - Core トレース出力ディレクトリ(com.cosminexus.xml.security.logging.trace_dir)>/*.log

○

−

−

△

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.8　HTTP Server

HTTP Serverに関連する収集対象を次の表に示します。

表A‒17　HTTP Serverに関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

エラーログ

<HWSエラーログディレクトリ(HttpsdErrorLogFileDir)>/error*

○

−

−

◎

△

ログ一式(旧バージョン互換用)

<HWSのインストールディレクトリ>/logs/*

○

−

−

○

○

そのほかのログ

リクエストログ

<HWSリクエストログディレクトリ(HttpsdRequestLogFileDir)>/hwsrequest*

−

○

−

◎

△

プロセスIDファイル

<HWSプロセスIDファイル(PidFile)>

○

−

−

△

△

アクセスログ

アクセスログ

<HWSアクセスログディレクトリ(HttpsdCustomLogFileDir)>/access*

−

○

−

◎

△

定義情報

定義ファイル

<HWSのインストールディレクトリ>/servers/HWS_<サーバ名称>/conf/*.conf

○

−

○

○

○

定義ファイル一式(旧バージョン互換用)

<HWSのインストールディレクトリ>/conf/*.conf

○

−

○

○

○

内部インタフェーストレース

内部トレース

<HWS内部トレースディレクトリ(HttpsdTraceLogFileDir)>/hws.trc*

−

○

−

◎

△

WebSocketログ

WebSocketログ

<HWSWebSocketログディレクトリ(HttpsdWebSocketLogFileDir)>/hws_websocket_log*

−

○

−

◎

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒18　HTTP Serverに関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

エラーログ

<HWSエラーログディレクトリ(HttpsdErrorLogFileDir)>/error*

○

−

−

◎

△

ログ一式(旧バージョン互換用)

<HWSのインストールディレクトリ>/logs/*

○

−

−

○

○

そのほかのログ

リクエストログ

<HWSリクエストログディレクトリ(HttpsdRequestLogFileDir)>/hwsrequest*

−

○

−

◎

△

プロセスIDファイル

<HWSプロセスIDファイル(PidFile)>

○

−

−

△

△

アクセスログ

アクセスログ

<HWSアクセスログディレクトリ(HttpsdCustomLogFileDir)>/access*

−

○

−

◎

△

ダンプ

coreダンプ

<HWSコアダンプ出力ディレクトリ(CoreDumpDirectory)>/core*

−

○

−

◎

△

gcacheサーバcoreダンプ

<HWSキャッシュサーバの作業ディレクトリ(SSLCacheServerRunDir)>/core*

−

○

−

△

△

定義情報

定義ファイル

<HWSのインストールディレクトリ>/servers/HWS_<サーバ名称>/conf/*.conf

○

−

○

○

○

定義ファイル一式(旧バージョン互換用)

<HWSのインストールディレクトリ>/conf/*.conf

○

−

○

○

○

内部インタフェーストレース

内部トレース

<HWS内部トレースディレクトリ(HttpsdTraceLogFileDir)>/hws.trc*

−

○

−

◎

△

WebSocketログ

WebSocketログ

<HWSWebSocketログディレクトリ(HttpsdWebSocketLogFileDir)>/hws_websocket_log*

−

○

−

◎

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.9　Microsoft Internet Information Service

Microsoft Internet Information Serviceの情報に関連する収集対象を次の表に示します。

表A‒19　Microsoft Internet Information Serviceの情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

アクセスログ

<IISアクセスログディレクトリ(IIS_log_dir)>/*

−

○

−

△

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.10　HCSCサーバ

HCSCサーバの情報に関連する収集対象を次の表に示します。

表A‒20　HCSCサーバの情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

HCSC-Managerログ

<HCSCログ出力ディレクトリ(cscmng.log.dir)>/*

○

−

−

△

△

ユーザ認証情報管理コマンドログ

<ユーザ認証情報管理コマンドのメッセージログファイルの出力先ディレクトリ(authinfo.command.messagelog.filepath)>/*

○

−

−

△

△

アクセスログ

リクエストトレース

<HCSCサーバのプロパティ(requesttrace-filepath)>/*

○

−

−

△

△

保守ログ

メソッドトレース

<HCSCサーバのプロパティ(methodtrace-filepath)>/*

○

−

−

△

△

定義情報

HCSCサーバの定義情報

<Application Serverのインストールディレクトリ>/CSC/system/msg/*

○

−

○

○

○

HCSC-Manager定義ファイル

<Application Serverのインストールディレクトリ>/CSC/config/manager/*

○

−

○

○

○

HCSC-Messaging定義ファイル

<Application Serverのインストールディレクトリ>/CSC/config/msg/*

○

−

○

○

○

リポジトリ

<HCSCリポジトリルート(cscmng.repository.root)>/**

○

−

−

○

○

その他のログ

ビジネスプロセスのアクティビティトレース

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/csc/*

−

○

−

◎

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒21　HCSCサーバの情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

HCSC-Managerログ

<HCSCログ出力ディレクトリ(cscmng.log.dir)>/*

○

−

−

△

△

アクセスログ

リクエストトレース

<HCSCサーバのプロパティ(requesttrace-filepath)>/*

○

−

−

△

△

保守ログ

メソッドトレース

<HCSCサーバのプロパティ(methodtrace-filepath)>/*

○

−

−

△

△

定義情報

HCSCサーバの定義情報

<Application Serverのインストールディレクトリ>/CSC/system/msg/*

○

−

○

○

○

HCSC-Manager定義ファイル

<Application Serverのインストールディレクトリ>/CSC/config/manager/*

○

−

○

○

○

HCSC-Messaging定義ファイル

<Application Serverのインストールディレクトリ>/CSC/config/msg/*

○

−

○

○

○

リポジトリ

<HCSCリポジトリルート(cscmng.repository.root)>/**

○

−

−

○

○

その他のログ

ビジネスプロセスのアクティビティトレース

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/csc/*

−

○

−

◎

△

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.11　HCSCサーバ（FTP受付）

HCSCサーバ（FTP受付）の情報に関連する収集対象を次の表に示します。

表A‒22　HCSCサーバ（FTP受付）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

定義情報

FTP受付の定義情報

<Application Serverのインストールディレクトリ>/CSC/config/ftprecp/*

○

−

○

○

○

FTP受付の共通定義情報

<Application Serverのインストールディレクトリ>/CSC/config/ftprecp/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒23　HCSCサーバ（FTP受付）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

定義情報

FTP受付の定義情報

<Application Serverのインストールディレクトリ>/CSC/config/ftprecp/*

○

−

○

○

○

FTP受付の共通定義情報

<Application Serverのインストールディレクトリ>/CSC/config/ftprecp/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.12　HCSCサーバ（TP1アダプタ）

HCSCサーバ（TP1アダプタ）の情報に関連する収集対象を次の表に示します。

表A‒24　HCSCサーバ（TP1アダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

トレース一式

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/TP1ADP/maintenance/*/*

−

○

−

◎

◎

定義情報

TP1アダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/TP1/config/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒25　HCSCサーバ（TP1アダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

トレース一式

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/TP1ADP/maintenance/*/*

−

○

−

◎

◎

定義情報

TP1アダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/TP1/config/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.13　HCSCサーバ（ファイルアダプタ）

HCSCサーバ（ファイルアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒26　HCSCサーバ（ファイルアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

トレース一式

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/FFADP/maintenance/*/*

−

○

−

◎

◎

定義情報

ファイルアダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/File/config/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒27　HCSCサーバ（ファイルアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

トレース一式

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/FFADP/maintenance/*/*

−

○

−

◎

◎

定義情報

ファイルアダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/File/config/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.14　HCSCサーバ（Object Accessアダプタ）

HCSCサーバ（Object Accessアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒28　HCSCサーバ（Object Accessアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

トレース一式

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/OAADP/maintenance/*/*

−

○

−

◎

◎

定義情報

OAアダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/OA/config/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒29　HCSCサーバ（Object Accessアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

トレース一式

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/OAADP/maintenance/*/*

−

○

−

◎

◎

定義情報

OAアダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/OA/config/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.15　HCSCサーバ（Message Queueアダプタ）

HCSCサーバ（Message Queueアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒30　HCSCサーバ（Message Queueアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

トレース一式

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/MQADP/maintenance/*/*

−

○

−

◎

◎

定義情報

MQアダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/MQ/config/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒31　HCSCサーバ（Message Queueアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

トレース一式

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/MQADP/maintenance/*/*

−

○

−

◎

◎

定義情報

MQアダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/MQ/config/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.16　HCSCサーバ（FTPアダプタ）

HCSCサーバ（FTPアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒32　HCSCサーバ（FTPアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

通信トレース

FTPアダプタのプロトコルトレース

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/FTPADP/*/*

−

○

−

◎

△

保守ログ

FTPアダプタの保守ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/FTPADP/maintenance/*/*

−

○

−

◎

△

メッセージログ

FTPアダプタの運用コマンドのメッセージログ

<FTPアダプタコマンドメッセージログ出力先ディレクトリ(ftpadp.command.messagelog.filepath)>/*

−

○

−

△

△

定義情報

FTPアダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/FTP/config/*

○

−

○

○

○

FTPアダプタの共通定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/FTP/config/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒33　HCSCサーバ（FTPアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

通信トレース

FTPアダプタのプロトコルトレース

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/FTPADP/*/*

−

○

−

◎

△

保守ログ

FTPアダプタの保守ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/FTPADP/maintenance/*/*

−

○

−

◎

△

メッセージログ

FTPアダプタの運用コマンドのメッセージログ

<FTPアダプタコマンドメッセージログ出力先ディレクトリ(ftpadp.command.messagelog.filepath)>/*

−

○

−

△

△

定義情報

FTPアダプタの定義情報

<Application Serverインストールディレクトリ>/CSC/custom-adapter/FTP/config/*

○

−

○

○

○

FTPアダプタの共通定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/FTP/config/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.17　HCSCサーバ（SFTPアダプタ）

HCSCサーバ（SFTPアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒34　HCSCサーバ（SFTPアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

通信トレース

SFTPアダプタのプロトコルトレース

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/SFTPADP/*/*

−

○

−

◎

◎

保守ログ

SFTPアダプタの保守ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/SFTPADP/maintenance/*/*

−

○

−

◎

◎

定義情報

SFTPアダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/SFTP/config/*

○

−

○

○

○

SFTPアダプタの共通定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/SFTP/config/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒35　HCSCサーバ（SFTPアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

通信トレース

SFTPアダプタのプロトコルトレース

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/SFTPADP/*/*

−

○

−

◎

◎

保守ログ

SFTPアダプタの保守ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/SFTPADP/maintenance/*/*

−

○

−

◎

◎

定義情報

SFTPアダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/SFTP/config/*

○

−

○

○

○

SFTPアダプタの共通定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/SFTP/config/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.18　HCSCサーバ（ファイル操作アダプタ）

HCSCサーバ（ファイル操作アダプタ）の情報に関連する収集対象を次の表に示します。

表A‒36　HCSCサーバ（ファイル操作アダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

保守ログ

ファイル操作アダプタの保守ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/ADPFOP/maintenance/*/cscadpfopmnt_*.log

○

−

−

◎

△

例外ログ

ファイル操作アダプタの例外ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/ADPFOP/maintenance/*/cscadpfopexp_*.log

○

−

−

◎

△

定義情報

ファイル操作アダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/config/adpfop/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒37　HCSCサーバ（ファイル操作アダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

保守ログ

ファイル操作アダプタの保守ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/ADPFOP/maintenance/*/cscadpfopmnt_*.log

○

−

−

◎

△

例外ログ

ファイル操作アダプタの例外ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/ADPFOP/maintenance/*/cscadpfopexp_*.log

○

−

−

◎

△

定義情報

ファイル操作アダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/config/adpfop/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.19　HCSCサーバ（FTPインバウンドアダプタ）

HCSCサーバ（FTPインバウンドアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒38　HCSCサーバ（FTPインバウンドアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

FTPインバウンドアダプタのメッセージログ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/csc/inbound-adapter/ftp/<リソースアダプタ名称>/*

○

−

−

◎

◎

FTPインバウンドアダプタの運用コマンドのメッセージログ

<Application Serverのインストールディレクトリ>/CSC/inbound-adapter/ftp/logs/<リソースアダプタ名称>/*

○

−

−

○

○

定義情報

FTPインバウンドアダプタの定義ファイル

<Application Serverのインストールディレクトリ>/CSC/inbound-adapter/ftp/config/<リソースアダプタ名称>/<サーバ名称>/*.xml

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒39　HCSCサーバ（FTPインバウンドアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

FTPインバウンドアダプタのメッセージログ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/csc/inbound-adapter/ftp/<リソースアダプタ名称>/*

○

−

−

◎

◎

FTPインバウンドアダプタの運用コマンドのメッセージログ

<Application Serverのインストールディレクトリ>/CSC/inbound-adapter/ftp/logs/<リソースアダプタ名称>/*

○

−

−

○

○

定義情報

FTPインバウンドアダプタの定義ファイル

<Application Serverのインストールディレクトリ>/CSC/inbound-adapter/ftp/config/<リソースアダプタ名称>/*.xml

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.20　HCSCサーバ（メールアダプタ）

HCSCサーバ（メールアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒40　HCSCサーバ（メールアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

メールアダプタ運用コマンドメッセージログ

<HCSCメールアダプタ運用コマンドメッセージログ出力先ディレクトリ(mailadp.command.messagelog.filepath)>/*

○

−

−

△

△

保守ログ

メールアダプタの保守ログ

<HCSCメールアダプタの保守ログ出力先ディレクトリ(mailadp.methodtrace.filepath)>/*/*

−

○

−

◎

△

定義情報

メールアダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/config/mail/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒41　HCSCサーバ（メールアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

メッセージログ

メールアダプタ運用コマンドメッセージログ

<HCSCメールアダプタ運用コマンドメッセージログ出力先ディレクトリ(mailadp.command.messagelog.filepath)>/*

○

−

−

△

△

保守ログ

メールアダプタの保守ログ

<HCSCメールアダプタの保守ログ出力先ディレクトリ(mailadp.methodtrace.filepath)>/*/*

−

○

−

◎

△

定義情報

メールアダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/config/mail/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.21　HCSCサーバ（HTTPアダプタ）

HCSCサーバ（HTTPアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒42　HCSCサーバ（HTTPアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

保守ログ

HTTPアダプタの保守ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/ADPHTTP/maintenance/*/cscadphttpmnt_*.log

−

○

−

◎

△

例外ログ

HTTPアダプタの例外ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/ADPHTTP/maintenance/*/cscadphttpexp_*.log

○

−

−

◎

△

定義情報

HTTPアダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/HTTP/config/**

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒43　HCSCサーバ（HTTPアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

保守ログ

HTTPアダプタの保守ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/ADPHTTP/maintenance/*/cscadphttpmnt_*.log

−

○

−

◎

△

例外ログ

HTTPアダプタの例外ログ

<J2EEサーバログ出力ディレクトリ(ejb.server.log.directory)>/CSCADP/ADPHTTP/maintenance/*/cscadphttpexp_*.log

○

−

−

◎

△

定義情報

HTTPアダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/HTTP/config/**

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.22　HCSCサーバ（コマンドアダプタ）

HCSCサーバ（コマンドアダプタ）の情報に関連する収集対象を次の表に示します。

表A‒44　HCSCサーバ（コマンドアダプタ）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

保守ログ

コマンドアダプタの保守ログ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/ADPCMD/maintenance/*/cscadpcmdmnt_*.log

−

○

−

◎

◎

例外ログ

コマンドアダプタの例外ログ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/ADPCMD/maintenance/*/cscadpcmdexp_*.log

○

−

−

◎

◎

定義情報

コマンドアダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/Command/config/*

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/Command/config/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒45　HCSCサーバ（コマンドアダプタ）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

保守ログ

コマンドアダプタの保守ログ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/ADPCMD/maintenance/*/cscadpcmdmnt_*.log

−

○

−

◎

◎

例外ログ

コマンドアダプタの例外ログ

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/CSCADP/ADPCMD/maintenance/*/cscadpcmdexp_*.log

○

−

−

◎

◎

定義情報

コマンドアダプタの定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/Command/config/*

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CSC/custom-adapter/Command/config/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.23　HCSCサーバ（ファイルイベント受付）

HCSCサーバ（ファイルイベント受付）の情報に関連する収集対象を次の表に示します。

表A‒46　HCSCサーバ（ファイルイベント受付）の情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

ファイルイベントトレース

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/csc/rcp/fileevent/*/fileeventtrace_*.log

−

○

−

◎

◎

定義情報

ファイルイベント受付の定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-reception/fileevent/config/*

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CSC/custom-reception/fileevent/config/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒47　HCSCサーバ（ファイルイベント受付）の情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

ファイルイベントトレース

<J2EEサーバ作業ディレクトリ(ejb.public.directory)>/ejb/<サーバ名称>/logs/csc/rcp/fileevent/*/fileeventtrace_*.log

−

○

−

◎

◎

定義情報

ファイルイベント受付の定義情報

<Application Serverのインストールディレクトリ>/CSC/custom-reception/fileevent/config/*

○

−

○

○

○

<Application Serverのインストールディレクトリ>/CSC/custom-reception/fileevent/config/common/*

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.24　監査ログ

監査ログの情報に関連する収集対象を次の表に示します。

表A‒48　監査ログの情報に関連する収集対象（Windowsの場合）

分類

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

なし

メッセージログ

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

<監査ログメッセージ出力ディレクトリ(auditlog.raslog.message.directory)>/rasmessage*.log

○

−

−

△

△

そのほかのログ

監査ログ

<監査ログ出力ディレクトリ(auditlog.directory)>/*

−

○

−

△

△

監査ログの例外情報

<監査ログ例外出力ディレクトリ(auditlog.raslog.exception.directory)>/rasexception*.log

○

−

−

△

△

保守ログ

そのほかのログ

<監査ログメッセージ出力ディレクトリ(auditlog.raslog.message.directory)>/*/*

○

−

−

△

△

<監査ログ例外出力ディレクトリ(auditlog.raslog.exception.directory)>/*/*

○

−

−

△

△

定義情報

監査ログ定義ファイル

<Application Serverのインストールディレクトリ>/common/conf/auditlog.properties

○

−

○

△

△

ネーミングサービス

そのほか

ネーミングサービスの起動，停止または異常終了を示すログ

<Windowsのイベントログ(EventLog)>

○

−

−

×

×

ダンプ

スレッドダンプ

<Application Serverのインストールディレクトリ>/TPB/logj/javacore*

○

−

−

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒49　監査ログの情報に関連する収集対象（UNIXの場合）

分類

資料の種類

収集ファイル

収集対象

資料

収集方法

一次

二次

定義

A

B

なし

メッセージログ

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

<監査ログメッセージ出力ディレクトリ(auditlog.raslog.message.directory)>/rasmessage*.log

○

−

−

△

△

そのほかのログ

監査ログ

<監査ログ出力ディレクトリ(auditlog.directory)>/*

−

○

−

△

△

監査ログの例外情報

<監査ログ例外出力ディレクトリ(auditlog.raslog.exception.directory)>/rasexception*.log

○

−

−

△

△

保守ログ

そのほかのログ

<監査ログメッセージ出力ディレクトリ(auditlog.raslog.message.directory)>/*/*

○

−

−

△

△

<監査ログ例外出力ディレクトリ(auditlog.raslog.exception.directory)>/*/*

○

−

−

△

△

定義情報

監査ログ定義ファイル

<Application Serverのインストールディレクトリ>/common/conf/auditlog.properties

○

−

○

△

△

ネーミングサービス

そのほか

ネーミングサービスの起動，停止または異常終了を示すログ

<UNIXのsyslog(syslog)>

○

−

−

△

△

ダンプ

スレッドダンプ

<Application Serverのインストールディレクトリ>/TPB/logj/javacore*

○

−

−

○

○

coreダンプ

<Application Serverのインストールディレクトリ>/TPB/logj/core*

−

○

−

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

付録A.25　そのほかの情報

そのほかの情報に関連する収集対象を次の表に示します。

表A‒50　そのほかの情報に関連する収集対象（Windowsの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

cosmienvコマンドのログ

<Application Serverのインストールディレクトリ>/env/log/*

○

−

−

○

○

定義情報

ホスト定義ファイル(Windows用)

<システムルートディレクトリ(systemroot)>/system32/drivers/etc/hosts

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

表A‒51　そのほかの情報に関連する収集対象（UNIXの場合）

資料の種類

収集ファイル

デフォルトの収集先

資料

収集方法

一次

二次

定義

A

B

メッセージログ

cosmienvコマンドのログ

<Application Serverのインストールディレクトリ>/env/log/*

○

−

−

○

○

定義情報

ホスト定義ファイル(UNIX用)

/etc/hosts

○

−

○

○

○

そのほか

プログラムプロダクト情報

/etc/.hitachi/pplistd/pplistd

○

−

○

○

○

（凡例）一次：一次送付資料　二次：二次送付資料　定義：定義送付資料　A：mngsvrutil collect snapshotコマンド　B：snapshotlogコマンド

資料の場合

○：収集される

−：収集されない

収集方法の場合

「付録A.1(3)　snapshotログの収集可否や収集に関する設定変更」を参照してください。

注　収集方法Aおよび収集方法Bについては，「付録A.1(2)　snapshotログの収集方法」を参照してください。表内の収集対象のディレクトリおよびファイルの意味については，「付録A.1(4)　収集対象の記述規則」を参照してください。

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

データベース関連のトラブルに対処するためには，どのコネクションを使用してデータベースと接続しているかを特定することが重要です。

ここでは，データベース（HiRDBまたはOracle）と接続中にトラブルが発生した場合に，アプリケーションサーバから出力される情報（性能解析トレースやログなど）とデータベースから出力される情報（トレース情報やpdlsコマンドの実行結果，動的パフォーマンスビューの内容など）を使用して，トラブルが発生したコネクションを特定する方法について説明します。

アプリケーションサーバでは，HiRDBおよびOracleとの接続に使用しているコネクションを一意に識別するための接続情報（コネクションID）を性能解析トレースに出力しています。J2EEサーバからデータベースに至るまで，およびデータベースからJ2EEサーバに処理結果が返却されるまでの一連の処理では，関連する構成ソフトウェアのログやトレース情報などにコネクションIDやデータベースサーバで割り振られるコネクト通番などが出力されます。これらの情報を突き合わせて確認することで，トラブルが発生したコネクションを特定できます。

HiRDBを使用する場合，およびOracleを使用する場合のコネクションIDの出力の概要，およびトラブルが発生したコネクションの特定に使用する情報を次に示します。

HiRDBを使用する場合

コネクションIDの出力の概要を次に示します。

図B‒1　コネクションIDの出力の概要（HiRDBの場合）

トラブルが発生したコネクションの特定に使用する情報を次の表に示します。

表B‒1　トラブルが発生したコネクションの特定に使用する情報（HiRDBの場合）

項番

出力元

情報の種類

参照先

1

Component Container

性能解析トレースファイル

付録B.1

2

SQLException発生時の例外メッセージ

3

DABroker Library

拡張データベースアクセストレース

付録B.2

4

HiRDBクライアント

SQLトレースファイル

付録B.3

5

エラーログ情報

6

再接続トレース

7

HiRDBサーバ

pdlsコマンドの実行結果

付録B.4

コネクションIDには次に示す情報が含まれています。

サーバ名称

フロントエンドサーバ名（HiRDB/Parallel Server使用時）またはシングルサーバ名（HiRDB/Single Server使用時）が表示されます。

コネクト通番

サーバ名称に表示されたHiRDBサーバで割り振られるコネクト通番が表示されます。

サーバのプロセスID

サーバ名称に表示されたHiRDBサーバのプロセスIDが表示されます。

コネクションIDの出力形式と出力例を次に示します。

コネクションIDの出力形式（HiRDBの場合）

サーバ名称：コネクト通番：サーバのプロセスID

コネクションIDの出力例（HiRDBの場合）

fes01:15:2351

参考

グローバルトランザクションの処理中に，エラーが発生してコネクションが切断されると自動的に再接続されます。しかし，この再接続処理は再接続トレースには出力されません。この場合，再接続トレースに出力されるコネクションIDと実際の接続情報に不整合が生じます。ただし，基本的にグローバルトランザクションの処理中にコネクションが切断されることはありません。

Oracleを使用する場合

コネクションIDの出力の概要を次に示します。

図B‒2　コネクションIDの出力の概要（Oracleの場合）

トラブルが発生したコネクションの特定に使用する情報を次の表に示します。

表B‒2　トラブルが発生したコネクションの特定に使用する情報（Oracleの場合）

項番

出力元

情報の種類

参照先

1

Component Container

性能解析トレースファイル

付録B.1

2

SQLException発生時の例外メッセージ

3

DABroker Library

拡張データベースアクセストレース

付録B.2

4

Oracleクライアント

Netクライアントトレース

付録B.5

5

Oracleサーバ

アラートファイル

付録B.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のプロパティ定義の設定方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2.2　DB Connectorのプロパティ定義」を参照してください。

注意事項

Oracleの透過的アプリケーションフェイルオーバーを使用している場合，PRFトレースに出力されるコネクションIDと実際に接続しているコネクションIDが異なることがあります。これはOracle内でコネクションが再接続されているためです。PRFトレースに出力されるコネクションIDと実際に接続しているコネクションIDが異なる場合，コネクションIDでOracleのトレース情報を追跡することはできません。

付録B.1　Component Container

トランザクション処理の状態（正常または異常）によって，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のトレース情報のインタフェース名に出力されています。

表B‒3　コネクションIDが出力される性能解析トレース

イベントID

説明

0x8C01

DataSource.getConnection()メソッドの終了直前の処理で出力された情報です。

0x8C03

DataSource.getConnection(String username, String password)メソッドの終了直前の処理で出力された情報です。

0x8C20

Connection.close()メソッドの開始直後の処理で出力された情報です。

0x8C40

ManagedConnection.associateConnection()メソッドの呼び出し時の処理で出力された情報です。

なお，トレース取得ポイントと取得できるトレース情報の詳細については，「8.12　DB Connector，JCAコンテナのトレース取得ポイント」を参照してください。

性能解析トレース，およびSQLException発生時の例外メッセージの取得方法と出力形式について説明します。

(1)　性能解析トレースファイル

PRFトレースファイルに出力された，クライアントからデータベースなどのEISに至るまで，およびその処理結果がクライアントに返却されるまでのリクエストの一連の処理で出力されるトレース情報をCSV形式で編集出力したファイルです。

コネクションIDが出力される条件

次の条件をすべて満たしている場合，性能解析トレースファイルにコネクションIDが出力されます。

使用しているデータベースが，次のどれかである。

HiRDB

Oracle

論理パフォーマンストレーサが起動中である。

リソースアダプタとして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の場合）に出力されます。取得方法については，「7.3.1　性能解析トレースファイルの収集方法」を参照してください。

(c)　出力形式

性能解析トレースの出力例を次に示します。コネクションIDはインタフェース名（「INT」欄）に出力されます。

図B‒3　性能解析トレースの出力例

(2)　SQLException発生時の例外メッセージ

データベースアクセス，DABroker LibraryまたはJDBCドライバでエラーが発生した場合に，例外としてSQLExceptionがスローされたことを示すメッセージです。

コネクションIDが出力される条件

使用しているデータベースが次のどれかである場合，SQLException発生時の例外メッセージにコネクションIDが出力されます。

HiRDB

Oracle

(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

付録B.2　DABroker Library

DABroker Libraryでは，拡張データベースアクセストレースにコネクションIDが出力されます。

拡張データベースアクセストレースの取得方法と出力形式について説明します。

(1)　拡張データベースアクセストレース

データベースへの接続から切断までのアクセス情報を出力したトレースです。データベースへの接続ごとに出力されます。

拡張データベースアクセストレースにコネクションIDが出力されるためには，次の条件を満たしている必要があります。

コネクションIDが出力される条件（HiRDBの場合）

HiRDBクライアントのバージョンが07-01以降である。

DABroker Library動作環境定義ファイルのDABEXSQL_TRC_LINEに0以上の値を指定している。

なお，DABroker Libraryの動作環境の設定については，Windowsの場合はマニュアル「アプリケーションサーバ 機能解説 互換編」の「18.3.1(3)　DABroker Libraryの動作環境の設定（Windowsの場合）」，UNIXの場合はマニュアル「アプリケーションサーバ 機能解説 互換編」の「18.3.2(4)　DABroker Libraryの動作環境の設定（UNIXの場合）」を参照してください。DABroker Library動作環境定義ファイルの詳細については，マニュアル「アプリケーションサーバ 機能解説 互換編」の「18.24.1　DABroker Library動作環境定義ファイル」を参照してください。

コネクションIDが出力される条件（Oracleの場合）

Oracle9i，またはOracle10gを使用している。

DABroker Library動作環境定義ファイルのDABEXSQL_TRC_LINE Eに-1，0，または1024から32767の値を指定している。

なお，Windowsの場合，DABroker Library動作環境定義ファイルの設定は，環境設定ユティリティを使用します。環境設定ユティリティを使用したDABroker Libraryの動作環境の設定については，Windowsの場合はマニュアル「アプリケーションサーバ機能解説 互換編」の「18.3.1(3)　DABroker Libraryの動作環境の設定（Windowsの場合）」，UNIXの場合はマニュアル「アプリケーションサーバ 機能解説 互換編」の「18.3.2(4)　DABroker Libraryの動作環境の設定（UNIXの場合）」を参照してください。DABroker Library動作環境定義ファイルの詳細については，マニュアル「アプリケーションサーバ 機能解説 互換編」の「18.24.1　DABroker Library動作環境定義ファイル」を参照してください。

(a)　取得方法

拡張データベースアクセストレースの格納場所は次のとおりです。

Windowsの場合

<DABroker Libraryの運用ディレクトリ>¥spool¥db_accessディレクトリ下のファイル

UNIXの場合

/opt/DABroker/spool/db_accessディレクトリ下のファイル

(b)　出力形式

拡張データベースアクセストレースの出力形式を次に示します。

なお，拡張データベースアクセストレースの出力形式の詳細については，マニュアル「アプリケーションサーバ 機能解説 互換編」の「18.6.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…SS
（トレース情報）

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
（トレース情報）

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

HiRDBクライアントでは，SQLトレースファイル，エラーログファイル，および再接続トレースファイルに，コネクションIDやコネクト通番などの情報が出力されます。

SQLトレースファイル，エラーログファイル，および再接続トレースファイルの取得方法と出力形式について説明します。

(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

付録B.4　HiRDBサーバ

HiRDBサーバでは，pdlsコマンドの実行結果を参照してサーバの状態を確認します。

pdlsコマンドの実行結果に表示されるサーバ名称やサーバのプロセスIDと，コネクションIDに含まれる情報を突き合わせて，接続したHiRDBサーバの状態を確認します。

pdlsコマンドの実行形式と，実行結果の出力形式について説明します。

(1)　pdlsコマンドの実行結果

HiRDBサーバの排他制御の状態，プロセスの状態，通信制御情報などを表示できるコマンドです。

(a)　実行形式

次に示すpdlsコマンドを実行して，サーバの状態を確認します。

サーバの排他制御の状態表示する場合

pdls -d lck

サーバのプロセスの状態表示する場合

pdls -d prc

サーバの通信制御情報の表示する場合

pdls -d rpc

pdlsコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(b)　出力形式

実行結果の「SVID」欄にサーバ名称が出力されて，「PID」欄にサーバのプロセスIDが出力されます。

出力形式の詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

付録B.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クライアントトレースを参照してください。

付録B.6　Oracleサーバ

Oracleサーバでは，次の方法でOracleサーバのエラー情報，サーバの状態などの情報が出力されます。

アラートファイルの取得

ユーザトレースの取得

Netサーバトレースファイルの取得

動的パフォーマンスビューの使用

(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の関係を次の表に示します。

表B‒4　動的パフォーマンスビューと性能解析トレースのコネクションIDの関係

項番

動的パフォーマンスビューに表示される項目

性能解析トレースのコネクションIDの項目

1

V$INSTANCE　INSTANCE_NAME

インスタンス名

2

V$SESSION　SID

セッションID

3

V$SESSION　SERIAL#

セッションシリアル番号

4

V$PROCESS　SPID

OSプロセスID

動的パフォーマンスビューの詳細については，Oracleのドキュメントを参照してください。

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

ここでは，CMRを含むアプリケーションをデプロイしたあとJ2EEサーバで障害が発生した場合に，障害発生前に使用していたCMR用の表を回復させる手順について説明します。なお，CMR用の表の詳細については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「9.6.3　CMP2.xとデータベースのマッピング」を参照してください。

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サーバを起動します。

付録D　各バージョンでの主な機能変更

ここでは，11-20よりも前のアプリケーションサーバの各バージョンでの主な機能の変更について，変更目的ごとに説明します。11-20での主な機能変更については，「1.4　アプリケーションサーバ 11-20での主な機能変更」を参照してください。

説明内容は次のとおりです。

アプリケーションサーバの各バージョンで変更になった主な機能と，その概要を説明しています。機能の詳細については「参照先マニュアル」の「参照個所」の記述を確認してください。「参照先マニュアル」および「参照個所」には，その機能についての11-20のマニュアルでの主な記載個所を記載しています。

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

付録D.1　11-10での主な機能変更

(1)　導入・構築の容易性強化

導入・構築の容易性強化を目的として変更した項目を次の表に示します。

表D‒1　導入・構築の容易性強化を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

ライブラリ競合回避機能の追加

クラス・リソースをロードするときの検索順序を変更し，ユーザアプリケーションに含まれるライブラリを優先して参照できるようにする機能を追加しました。

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

付録B.4

(2)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒2　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

JSP2.3への対応

JSP2.3に対応しました。

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

8章

コンテナ管理のEntityManagerへの対応

JPA 2.1に対応したコンテナ管理のEntityManagerに対応しました。

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

5章

Interceptors 1.2への対応

Interceptors 1.2に対応しました。

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

15章

(3)　信頼性の維持・向上

信頼性の維持・向上を目的として変更した項目を次の表に示します。

表D‒3　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

セッションマネージャの指定機能の追加

クラウド環境利用時にHTTPセッションのセッションフェイルオーバを利用できるようにする機能を追加しました。

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

2.22

付録D.2　11-00での主な機能変更

(1)　導入・構築の容易性強化

導入・構築の容易性強化を目的として変更した項目を次の表に示します。

表D‒4　導入・構築の容易性強化を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

開発環境のWindows Server対応

クラウド環境上にアプリケーション開発環境を構築できるよう，uCosminexus DeveloperのサポートOSにWindows Server OSを追加しました。

−

−

(2)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒5　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

Servlet 3.0/3.1への対応

Servlet 3.0の非同期サーブレット，およびServlet 3.1の非同期I/O系APIに対応しました。

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

8.1

EL 3.0への対応

EL 3.0に対応しました。

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

2.3.3

JSF 2.2への対応

JSF 2.2に対応しました。

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

3章

JAX-RS 2,0への対応

JAX-RS 2.0に対応しました。

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

4章

WebSocket 1.0への対応

WebSocket 1.0に対応しました。

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

5章

NIO HTTPサーバ機能の追加

従来のリダイレクタ機能やインプロセスHTTPサーバ機能に代わり，非同期サーブレットやWebSocketなどのノンブロッキングI/O処理に対応したインプロセスのHTTPサーバとして，NIO HTTPサーバ機能を追加しました。

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

7章

JPA 2.1への対応

JPA 2.1に対応し，JPA 2.1対応のJPAプロバイダを利用できるようになりました。

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

6章

CDI 1.2への対応

CDI 1.2に対応しました。

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

9章

BV 1.1への対応

Bean Validation 1.1に対応しました。

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

10章

Java Batch 1.0への対応

Batch Applications for the Java Platform （Java Batch） 1.0に対応しました。

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

11章

JSON-P 1.0への対応

Java API for JSON Processing（JSON-P） 1.0に対応しました。

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

12章

Concurrency Utilities 1.0への対応

Concurrency Utilities for Java EE 1.0に対応しました。

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

14章

WebSocket通信への対応

HTTP ServerからJ2EEサーバにWebSocket通信を中継する機能を追加しました。

HTTP Server

4.15

(3)　信頼性の維持・向上

信頼性の維持・向上を目的として変更した項目を次の表に示します。

表D‒6　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

暗号化通信モジュールの変更

HTTP Serverの暗号化通信モジュールとしてmod_sslを採用しました。

HTTP Server

5章，付録H

(4)　そのほかの目的

そのほかの目的で変更した項目を次の表に示します。

表D‒7　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

V9互換モードの追加

Version 9以前のJ2EEサーバから移行するユーザ向けに，Version 9との互換性を維持するためのV9互換モードを追加しました。

このマニュアル

10.3.4

付録D.3　09-87での主な機能変更

(1)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒8　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

Java SE 11への対応

Java SE 11の機能が使用できるようになりました。

このマニュアル

9章

付録D.4　09-80での主な機能変更

(1)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒9　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

JAX-RS機能におけるラムダ式の使用

web.xmlのサーブレット初期化パラメタに指定したパッケージとそのサブパッケージに含まれるクラスで，ラムダ式が使用できるようになりました。

Webサービス開発ガイド

11.2

Java SE 9への対応

Java SE 9の機能が使用できるようになりました。

このマニュアル

9章

(2)　信頼性の維持・向上

信頼性の維持・向上を目的として変更した項目を次の表に示します。

表D‒10　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

WebサーバのApache2.4のサポート

WebサーバのベースバージョンとしてApache2.4をサポートしました。

HTTP Server

6章，付録G

SSL通信での楕円曲線暗号の利用

楕円曲線暗号を利用したSSL通信ができるようになりました。

HTTP Server

5章，付録G

SSLライブラリの変更

SSL機能を提供するSSLライブラリをOpenSSLに変更しました。

HTTP Server

5章，付録G

付録D.5　09-70での主な機能変更

(1)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒11　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

運用管理ポータルでのJSPコンパイルバージョンの追加

J2EEサーバでのJSPから生成されたサーブレットのコンパイル方法に「JDK1.7の仕様に従ったコンパイル」と「JDK7の仕様に従ったコンパイル」を追加する。

運用管理ポータル操作ガイド

10.8.4

リファレンス 定義編(サーバ定義)

4.11.2

JDK8でのメタスペース対応

JavaVMの起動で使用しているPermanent領域用のオプションをMetaspace領域用のオプションに変更する。

システム構築・運用ガイド

付録A.2

運用管理ポータル操作ガイド

10.8.7

リファレンス 定義編(サーバ定義)

5.2.1，5.2.2，付録A.2

統合ユーザ管理でのユーザ認証のSHA-2対応

統合ユーザ管理でのユーザ認証のハッシュアルゴリズムとしてSHA-224，SHA-256，SHA-384，SHA-512を追加する。

機能解説 セキュリティ管理機能編

5.3.1，5.3.9，5.10.7，11.4.3，12.4.3，12.5.3，13.2，14.2.2

Red Hat Enterprise Linux Server 7での自動起動と自動再起動および自動停止の追加

Red Hat Enterprise Linux Server 7でのManagement Serverと運用管理エージェントの自動起動と自動再起動および自動停止方法を追加する。

機能解説 運用／監視／連携編

2.6.3，2.6.4，2.6.5

リファレンス コマンド編

7.2

(2)　運用性の維持・向上

運用性の維持・向上を目的として変更した項目を次の表に示します。

表D‒12　運用性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

V9.7へのバージョンアップ対応

バージョンアップ時のJavaVMの起動で使用しているPermanent領域用のオプションをMetaspace領域用のオプションに変更する手順を追加する。

このマニュアル

10.3.1，10.3.2，10.3.5

WARによる運用

WARファイルだけで構成されたWARアプリケーションをJ2EEサーバにデプロイできるようになりました。

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

2.2.1

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

18.9

リファレンス コマンド編

cjimportwar（WARアプリケーションのインポート）

明示管理ヒープ機能でのExplicitメモリブロックの強制解放

javagcコマンドで，Explicitメモリブロックの解放処理を任意のタイミングで実行できるようになりました。

機能解説 拡張編

7.6.1，7.9

リファレンス コマンド編

javagc（GCの強制発生）

(3)　そのほかの目的

そのほかの目的で変更した項目を次の表に示します。

表D‒13　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

snapshotログの収集対象

snapshotログの収集対象としてJavaVMイベントログとManagement Serverのスレッドダンプを追加する。

このマニュアル

付録A.2

cjenvsetupコマンドのログ出力

Component Container管理者のセットアップ（cjenvsetupコマンド）の実行情報がメッセージログに出力されるようになりました。

システム構築・運用ガイド

4.1.4

機能解説 保守／移行編

4.20

リファレンス コマンド編

cjenvsetup（Component Container管理者のセットアップ）

明示管理ヒープ機能のイベントログへのCPU時間の出力

Explicitメモリブロック解放処理に掛かったCPU時間が，明示管理ヒープ機能のイベントログに出力されるようになりました。

このマニュアル

5.11.3

ユーザ拡張性能解析トレースの機能拡張

ユーザ拡張性能解析トレースで，次の機能を追加しました。

トレース対象の指定方法を通常のメソッド単位の指定方法に加えて，パッケージ単位またはクラス単位で指定できるようになりました。

使用できるイベントIDの範囲を拡張しました。

ユーザ拡張性能解析トレース設定ファイルに指定できる行数の制限を緩和しました。

ユーザ拡張性能解析トレース設定ファイルでトレース取得レベルを指定できるようになりました。

このマニュアル

7.5.2，7.5.3，8.25.1

Session Beanの非同期呼び出し使用時の情報解析向上

PRFトレースのルートアプリケーション情報を使用して，呼び出し元と呼び出し先のリクエストを突き合わせることができるようになりました。

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

2.17.3

付録D.6　09-60での主な機能変更

(1)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒14　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

G1GCへの対応

G1GCを選択できるようになりました。

システム設計ガイド

7.15

リファレンス 定義編(サーバ定義)

14.5

圧縮オブジェクトポインタ機能への対応

圧縮オブジェクトポインタ機能を使用できるようになりました。

このマニュアル

9.18

(2)　信頼性の維持・向上

信頼性の維持・向上を目的として変更した項目を次の表に示します。

表D‒15　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

ファイナライズ滞留解消機能の追加

ファイナライズ処理の滞留を解消でき，OS資源の解放遅れなどの発生を抑止できるようになりました。

このマニュアル

9.16

(3)　そのほかの目的

そのほかの目的で変更した項目を次の表に示します。

表D‒16　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

ログファイルの非同期出力機能の追加

ログのファイル出力を非同期でできるようになりました。

リファレンス 定義編(サーバ定義)

14.2

付録D.7　09-50での主な機能変更

(1)　開発生産性の向上

開発生産性の向上を目的として変更した項目を次の表に示します。

表D‒17　開発生産性の向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

Eclipseセットアップの簡略化

GUIを利用してEclipse環境をセットアップできるようになりました。

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

1.1.5，2.4

ユーザ拡張性能解析トレースを使ったデバッグ支援

ユーザ拡張性能解析トレース設定ファイルを開発環境で作成できるようになりました。

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

1.1.3，6.4

(2)　導入・構築の容易性強化

導入・構築の容易性強化を目的として変更した項目を次の表に示します。

表D‒18　導入・構築の容易性強化を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

仮想化環境でのシステム構成パターンの拡充

仮想化環境で使用できるティアの種類（http-tier，j2ee-tierおよびctm-tier）が増えました。これによって，次のシステム構成パターンが構築できるようになりました。

WebサーバとJ2EEサーバを別のホストに配置するパターン

フロントエンド（サーブレット，JSP）とバックエンド（EJB）を分けて配置するパターン

CTMを使用するパターン

仮想化システム構築・運用ガイド

1.1.2

(3)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒19　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

JDBC 4.0仕様への対応

DB ConnectorでJDBC 4.0仕様のHiRDB Type4 JDBC Driver，およびSQL ServerのJDBCドライバに対応しました。

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

3.6.3

Portable Global JNDI名での命名規則の緩和

Portable Global JNDI名に使用できる文字を追加しました。

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

2.4.3

Servlet 3.0仕様への対応

Servlet 3.0のHTTP Cookieの名称，およびURLのパスパラメタ名の変更が，Servlet 2.5以前のバージョンでも使用できるようになりました。

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

2.7

Bean Validationと連携できるアプリケーションの適用拡大

CDIやユーザアプリケーションでもBean Validationを使って検証できるようになりました。

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

10章

JavaMailへの対応

JavaMail 1.4に準拠したAPIを使用したメール送受信機能を利用できるようになりました。

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

8章

javacoreコマンドが使用できるOSの適用拡大

javacoreコマンドを使って，Windowsのスレッドダンプを取得できるようになりました。

リファレンス コマンド編

javacore（スレッドダンプの取得／Windowsの場合）

(4)　信頼性の維持・向上

信頼性の維持・向上を目的として変更した項目を次の表に示します。

表D‒20　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

コードキャッシュ領域の枯渇回避

システムで使用しているコードキャッシュ領域のサイズを確認して，領域が枯渇する前にしきい値を変更して領域枯渇するのを回避できるようになりました。

システム設計ガイド

7.2.6

このマニュアル

5.7.2，5.7.3

リファレンス 定義編(サーバ定義)

14.1，14.2，14.4

明示管理ヒープ機能の効率的な適用への対応

自動解放処理時間を短縮し，明示管理ヒープ機能を効率的に適用するための機能として，Explicitヒープに移動するオブジェクトを制御できる機能を追加しました。

Explicitメモリブロックへのオブジェクト移動制御機能

明示管理ヒープ機能適用除外クラス指定機能

Explicitヒープ情報へのオブジェクト解放率情報の出力

システム設計ガイド

7.14.6

機能解説 拡張編

7.2.2，7.6.5，7.10，7.13.1，7.13.3

このマニュアル

5.5

クラス別統計情報の出力範囲拡大

クラス別統計情報を含んだ拡張スレッドダンプに，staticフィールドを基点とした参照関係を出力できるようになりました。

このマニュアル

9.6

(5)　運用性の維持・向上

運用性の維持・向上を目的として変更した項目を次の表に示します。

表D‒21　運用性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

EADsセッションフェイルオーバ機能のサポート

EADsと連携してセッションフェイルオーバ機能を実現するEADsセッションフェイルオーバ機能をサポートしました。

機能解説 拡張編

5章

WARによる運用

WARファイルだけで構成されたWARアプリケーションをJ2EEサーバにデプロイできるようになりました。

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

2.2.1

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

18.9

リファレンス コマンド編

cjimportwar（WARアプリケーションのインポート）

運用管理機能の同期実行による起動と停止

運用管理機能（Management Serverおよび運用管理エージェント）の起動および停止を，同期実行するオプションを追加しました。

機能解説 運用／監視／連携編

2.6.1，2.6.2，2.6.3，2.6.4

リファレンス コマンド編

adminagentctl（運用管理エージェントの起動と停止），mngautorun（自動起動および自動再起動の設定／設定解除），mngsvrctl（Management Serverの起動／停止／セットアップ）

明示管理ヒープ機能でのExplicitメモリブロックの強制解放

javagcコマンドで，Explicitメモリブロックの解放処理を任意のタイミングで実行できるようになりました。

機能解説 拡張編

7.6.1，7.9

リファレンス コマンド編

javagc（GCの強制発生）

(6)　そのほかの目的

そのほかの目的で変更した項目を次の表に示します。

表D‒22　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

定義情報の取得

snapshotlog（snapshotログの収集）コマンドで定義ファイルだけを収集できるようになりました。

このマニュアル

2.3

リファレンス コマンド編

snapshotlog（snapshotログの収集）

cjenvsetupコマンドのログ出力

Component Container管理者のセットアップ（cjenvsetupコマンド）の実行情報がメッセージログに出力されるようになりました。

システム構築・運用ガイド

4.1.4

このマニュアル

4.20

リファレンス コマンド編

cjenvsetup（Component Container管理者のセットアップ）

BIG-IP v11のサポート

使用できる負荷分散機の種類にBIG-IP v11が追加になりました。

システム構築・運用ガイド

4.7.2

仮想化システム構築・運用ガイド

2.1

明示管理ヒープ機能のイベントログへのCPU時間の出力

Explicitメモリブロック解放処理に掛かったCPU時間が，明示管理ヒープ機能のイベントログに出力されるようになりました。

このマニュアル

5.11.3

ユーザ拡張性能解析トレースの機能拡張

ユーザ拡張性能解析トレースで，次の機能を追加しました。

トレース対象の指定方法を通常のメソッド単位の指定方法に加えて，パッケージ単位またはクラス単位で指定できるようになりました。

使用できるイベントIDの範囲を拡張しました。

ユーザ拡張性能解析トレース設定ファイルに指定できる行数の制限を緩和しました。

ユーザ拡張性能解析トレース設定ファイルでトレース取得レベルを指定できるようになりました。

このマニュアル

7.5.2，7.5.3，8.25.1

Session Beanの非同期呼び出し使用時の情報解析向上

PRFトレースのルートアプリケーション情報を使用して，呼び出し元と呼び出し先のリクエストを突き合わせることができるようになりました。

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

2.17.3

付録D.8　09-00での主な機能変更

(1)　導入・構築の容易性強化

導入・構築の容易性強化を目的として変更した項目を次の表に示します。

表D‒23　導入・構築の容易性強化を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

仮想化環境での構築・運用の操作対象単位の変更

仮想化環境の構築・運用時の操作対象単位が仮想サーバから仮想サーバグループへ変更になりました。仮想サーバグループの情報を定義したファイルを使用して，複数の仮想サーバを管理ユニットへ一括で登録できるようになりました。

仮想化システム構築・運用ガイド

1.1.2

セットアップウィザードによる構築環境の制限解除

セットアップウィザードを使用して構築できる環境の制限が解除されました。ほかの機能で構築した環境があってもアンセットアップされて，セットアップウィザードで構築できるようになりました。

システム構築・運用ガイド

2.2.7

構築環境の削除手順の簡略化

Management Serverを使用して構築したシステム環境を削除する機能（mngunsetupコマンド）の追加によって，削除手順を簡略化しました。

システム構築・運用ガイド

4.1.37

運用管理ポータル操作ガイド

3.6，5.4

リファレンス コマンド編

mngunsetup（Management Serverの構築環境の削除）

(2)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒24　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

Servlet 3.0への対応

Servlet 3.0に対応しました。

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

8章

EJB 3.1への対応

EJB 3.1に対応しました。

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

2章

JSF 2.1への対応

JSF 2.1に対応しました。

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

3章

JSTL 1.2への対応

JSTL 1.2に対応しました。

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

3章

CDI 1.0への対応

CDI 1.0に対応しました。

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

9章

Portable Global JNDI名の利用

Portable Global JNDI名を利用したオブジェクトのルックアップができるようになりました。

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

2.4

JAX-WS 2.2への対応

JAX-WS 2.2に対応しました。

Webサービス開発ガイド

1.1，16.1.5，16.1.7，16.2.1，16.2.6，16.2.10，16.2.12，16.2.13，16.2.14，16.2.16，16.2.17，16.2.18，16.2.20，16.2.22，19.1，19.2.3，37.2，37.6.1，37.6.2，37.6.3

JAX-RS 1.1への対応

JAX-RS 1.1に対応しました。

Webサービス開発ガイド

1.1，1.2.2，1.3.2，1.4.2，1.5.1，1.6，2.3，11章，12章，13章，17章，24章，39章

(3)　信頼性の維持・向上

信頼性の維持・向上を目的として変更した項目を次の表に示します。

表D‒25　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

SSL/TLS通信でのTLSv1.2の使用

RSA BSAFE SSL-Jを使用して，TLSv1.2を含むセキュリティ・プロトコルでSSL/TLS通信ができるようになりました。

機能解説 セキュリティ管理機能編

7.3

(4)　運用性の維持・向上

運用性の維持・向上を目的として変更した項目を次の表に示します。

表D‒26　運用性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

Webコンテナ全体の実行待ちキューの総和の監視

Webコンテナ全体の実行待ちキューの総和を稼働情報に出力して監視できるようになりました。

機能解説 運用／監視／連携編

3章

アプリケーションの性能解析トレース（ユーザ拡張トレース）の出力

ユーザが開発したアプリケーションの処理性能を解析するための性能解析トレースを，アプリケーションの変更をしないで出力できるようになりました。

このマニュアル

7章

仮想化環境でのユーザスクリプトを使用した運用

任意のタイミングでユーザ作成のスクリプト（ユーザスクリプト）を仮想サーバ上で実行できるようになりました。

仮想化システム構築・運用ガイド

7.8

運用管理ポータル改善

運用管理ポータルの次の画面で，手順を示すメッセージを画面に表示するように変更しました。

［設定情報の配布］画面

Webサーバ，J2EEサーバおよびSFOサーバの起動画面

WebサーバクラスタとJ2EEサーバクラスタの一括起動，一括再起動および起動画面

運用管理ポータル操作ガイド

10.10.1，11.9.2，11.10.2，11.10.4，11.10.6，11.11.2，11.12.2，11.12.4，11.12.6

運用管理機能の再起動機能の追加

運用管理機能（Management Serverおよび運用管理エージェント）で自動再起動が設定できるようになり，運用管理機能で障害が発生した場合でも運用が継続できるようになりました。また，自動起動の設定方法も変更になりました。

機能解説 運用／監視／連携編

2.4.1，2.4.2，2.6.3，2.6.4

リファレンス コマンド編

mngautorun（自動起動および自動再起動の設定／設定解除）

(5)　そのほかの目的

そのほかの目的で変更した項目を次の表に示します。

表D‒27　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

ログ出力時のファイル切り替え単位の変更

ログ出力時に，日付ごとに出力先のファイルを切り替えられるようになりました。

このマニュアル

3.2.1

Webサーバの名称の変更

アプリケーションサーバに含まれるWebサーバの名称をHTTP Serverに変更しました。

HTTP Server

−

BIG-IPのAPI（SOAPアーキテクチャ）を使用した直接接続への対応

BIG-IP（負荷分散機）でAPI（SOAPアーキテクチャ）を使用した直接接続に対応しました。

また，APIを使用した直接接続を使用する場合に，負荷分散機の接続環境を設定する方法が変更になりました。

システム構築・運用ガイド

4.7.3，付録J

仮想化システム構築・運用ガイド

2.1，付録C

機能解説 セキュリティ管理機能編

8.2，8.4，8.5，8.6，18.2.1，18.2.2，18.2.3

（凡例）−：マニュアル全体を参照する

付録D.9　08-70での主な機能変更

(1)　導入・構築の容易性強化

導入・構築の容易性強化を目的として変更した項目を次の表に示します。

表D‒28　導入・構築の容易性強化を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

運用管理ポータル改善

運用管理ポータルの画面で，リソースアダプタの属性を定義するプロパティ（Connector属性ファイルの設定内容）の設定，および接続テストができるようになりました。また，運用管理ポータルの画面で，J2EEアプリケーション（earファイルおよびzipファイル）をManagement Serverにアップロードできるようになりました。

ファーストステップガイド

3.5

運用管理ポータル操作ガイド

−

page/tagディレクティブのimport属性暗黙インポート機能の追加

page/tagディレクティブのimport属性暗黙インポート機能を使用できるようになりました。

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

2.3.7

仮想化環境でのJP1製品に対する環境設定の自動化対応

仮想サーバへのアプリケーションサーバ構築時に，仮想サーバに対するJP1製品の環境設定を，フックスクリプトで自動的に設定できるようになりました。

仮想化システム構築・運用ガイド

7.7.2

統合ユーザ管理機能の改善

ユーザ情報リポジトリでデータベースを使用する場合に，データベース製品のJDBCドライバを使用して，データベースに接続できるようになりました。DABroker LibraryのJDBCドライバによるデータベース接続はサポート外になりました。

簡易構築定義ファイルおよび運用管理ポータルの画面で，統合ユーザ管理機能に関する設定ができるようになりました。

また，Active Directoryの場合，DNで日本語などの2バイト文字に対応しました。

機能解説 セキュリティ管理機能編

5章，14.2.2

運用管理ポータル操作ガイド

3.5，10.8.1

HTTP Server設定項目の拡充

簡易構築定義ファイルおよび運用管理ポータルの画面で，HTTP Serverの動作環境を定義するディレクティブ（httpsd.confの設定内容）を直接設定できるようになりました。

システム構築・運用ガイド

4.1.21

運用管理ポータル操作ガイド

10.9.1

リファレンス 定義編(サーバ定義)

4.10

（凡例）−：マニュアル全体を参照する

(2)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更した項目を次の表に示します。

表D‒29　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

ejb-jar.xmlの指定項目の追加

ejb-jar.xmlに，クラスレベルインターセプタおよびメソッドレベルインターセプタを指定できるようになりました。

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

2.15

パラレルコピーガーベージコレクションへの対応

パラレルコピーガーベージコレクションを選択できるようになりました。

リファレンス 定義編(サーバ定義)

14.5

Connector 1.5仕様に準拠したInboundリソースアダプタのグローバルトランザクションへの対応

Connector 1.5仕様に準拠したリソースアダプタでTransacted Deliveryを使用できるようにしました。これによって，Message-driven Beanを呼び出すEISがグローバルトランザクションに参加できるようになりました。

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

3.16.3

TP1インバウンドアダプタのMHPへの対応

TP1インバウンドアダプタを使用してアプリケーションサーバを呼び出すOpenTP1のクライアントとして，MHPを使用できるようになりました。

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

4章

cjrarupdateコマンドのFTPインバウンドアダプタへの対応

cjrarupdateコマンドでバージョンアップできるリソースアダプタにFTPインバウンドアダプタを追加しました。

リファレンス コマンド編

2.2

(3)　信頼性の維持・向上

信頼性の維持・向上を目的として変更した項目を次の表に示します。

表D‒30　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

データベースセッションフェイルオーバ機能の改善

性能を重視するシステムで，グローバルセッション情報を格納したデータベースのロックを取得しないモードを選択できるようになりました。また，データベースを更新しない，参照専用のリクエストを定義できるようになりました。

機能解説 拡張編

6章

OutOfMemoryハンドリング機能の対象となる処理の拡大

OutOfMemoryハンドリング機能の対象となる処理を追加しました。

このマニュアル

2.5.4

リファレンス 定義編(サーバ定義)

14.2

HTTPセッションで利用するExplicitヒープの省メモリ化機能の追加

HTTPセッションで利用するExplicitヒープのメモリ使用量を抑止する機能を追加しました。

機能解説 拡張編

7.11

(4)　運用性の維持・向上

運用性の維持・向上を目的として変更した項目を次の表に示します。

表D‒31　運用性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

仮想化環境でのJP1製品を使用したユーザ認証への対応（クラウド運用対応）

JP1連携時に，JP1製品の認証サーバを利用して，仮想サーバマネージャを使用するユーザを管理・認証できるようになりました。

仮想化システム構築・運用ガイド

1.2.2，3章，4章，5章，6章，7.9

(5)　そのほかの目的

そのほかの目的で変更した項目を次の表に示します。

表D‒32　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

負荷分散機へのAPI（RESTアーキテクチャ）を使用した直接接続の対応

負荷分散機への接続方法として，API（RESTアーキテクチャ）を使用した直接接続に対応しました。

また，使用できる負荷分散機の種類にACOS（AX2500）が追加になりました。

システム構築・運用ガイド

4.7.2，4.7.3

仮想化システム構築・運用ガイド

2.1

リファレンス 定義編(サーバ定義)

4.2.4

snapshotログ収集時のタイムアウトへの対応と収集対象の改善

snapshotログの収集が指定した時間で終了（タイムアウト）できるようになりました。一次送付資料として収集される内容が変更になりました。

このマニュアル

付録A

付録D.10　08-53での主な機能変更

(1)　導入・構築の容易性強化

導入・構築の容易性強化を目的として変更された項目を次の表に示します。

表D‒33　導入・構築の容易性強化を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

さまざまなハイパーバイザに対応した仮想化環境の構築

さまざまなハイパーバイザを使用して実現する仮想サーバ上に，アプリケーションサーバを構築できるようになりました。

また，複数のハイパーバイザが混在する環境にも対応しました。

仮想化システム構築・運用ガイド

2章，3章，5章

(2)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更された項目を次の表に示します。

表D‒34　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

トランザクション連携に対応したOpenTP1からの呼び出し

OpenTP1からアプリケーションサーバ上で動作するMessage-driven Beanを呼び出すときに，トランザクション連携ができるようになりました。

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

4章

JavaMail

POP3に準拠したメールサーバと連携して，JavaMail 1.3に準拠したAPIを使用したメール受信機能を利用できるようになりました。

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

8章

(3)　信頼性の維持・向上

信頼性の維持・向上を目的として変更された項目を次の表に示します。

表D‒35　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

JavaVMのトラブルシュート機能強化

JavaVMのトラブルシュート機能として，次の機能が使用できるようになりました。

OutOfMemoryError発生時の動作を変更できるようになりました。

JITコンパイル時に，Cヒープ確保量の上限値を設定できるようになりました。

スレッド数の上限値を設定できるようになりました。

拡張verbosegc情報の出力項目を拡張しました。

このマニュアル

4章，5章，9章

(4)　運用性の維持・向上

運用性の維持・向上を目的として変更された項目を次の表に示します。

表D‒36　運用性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

JP1/ITRMへの対応

ITリソースを一元管理する製品であるJP1/ITRMに対応しました。

仮想化システム構築・運用ガイド

1.3，2.1

(5)　そのほかの目的

そのほかの目的で変更された項目を次の表に示します。

表D‒37　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

Microsoft IIS 7.0およびMicrosoft IIS 7.5への対応

WebサーバとしてMicrosoft IIS 7.0およびMicrosoft IIS 7.5に対応しました。

−

−

HiRDB Version 9およびSQL Server 2008への対応

データベースとして次の製品に対応しました。

HiRDB Server Version 9

HiRDB/Developer's Kit Version 9

HiRDB/Run Time Version 9

SQL Server 2008

また，SQL Server 2008に対応するJDBCドライバとして，SQL Server JDBC Driverに対応しました。

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

3章

（凡例）−：該当なし。

付録D.11　08-50での主な機能変更

(1)　導入・構築の容易性強化

導入・構築の容易性強化を目的として変更された項目を次の表に示します。

表D‒38　導入・構築の容易性強化を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

Webサービスプロバイダ側でのweb.xmlの指定必須タグの変更

Webサービスプロバイダ側でのweb.xmlで，listenerタグ，servletタグおよびservlet-mappingタグの指定を必須から任意に変更しました。

リファレンス 定義編(サーバ定義)

2.2.3

論理サーバのネットワークリソース使用

J2EEアプリケーションからほかのホスト上にあるネットワークリソースやネットワークドライブにアクセスするための機能を追加しました。

機能解説 運用／監視／連携編

1.2.3，5.2，5.7

サンプルプログラムの実行手順の簡略化

一部のサンプルプログラムをEAR形式で提供することによって，サンプルプログラムの実行手順を簡略化しました。

ファーストステップガイド

3.5

システム構築・運用ガイド

付録L

運用管理ポータルの画面の動作の改善

画面の更新間隔のデフォルトを「更新しない」から「3秒」に変更しました。

運用管理ポータル操作ガイド

7.4.1

セットアップウィザードの完了画面の改善

セットアップウィザード完了時の画面に，セットアップで使用した簡易構築定義ファイルおよびConnector属性ファイルが表示されるようになりました。

システム構築・運用ガイド

2.2.6

仮想化環境の構築

ハイパーバイザを使用して実現する仮想サーバ上に，アプリケーションサーバを構築する手順を追加しました。

仮想化システム構築・運用ガイド

3章，5章

(2)　標準機能・既存機能への対応

標準機能・既存機能への対応を目的として変更された項目を次の表に示します。

表D‒39　標準機能・既存機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

OpenTP1からの呼び出しへの対応

OpenTP1からアプリケーションサーバ上で動作するMessage-driven Beanを呼び出せるようになりました。

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

4章

JMSへの対応

JMS 1.1仕様に対応したCJMSプロバイダ機能を使用できるようになりました。

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

7章

Java SE 6への対応

Java SE 6の機能が使用できるようになりました。

このマニュアル

5.5，5.8.1

ジェネリクスの使用への対応

EJBでジェネリクスを使用できるようになりました。

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

4.2.18

(3)　信頼性の維持・向上

信頼性の維持・向上を目的として変更された項目を次の表に示します。

表D‒40　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

明示管理ヒープ機能の使用性向上

自動配置設定ファイルを使用して，明示管理ヒープ機能を容易に使用できるようになりました。

システム設計ガイド

7.2，7.7.3，7.11.4，7.12.1

機能解説 拡張編

7章

データベースセッションフェイルオーバ機能のURI単位での抑止

データベースセッションフェイルオーバ機能を使用する場合に，機能の対象外にするリクエストをURI単位で指定できるようになりました。

機能解説 拡張編

5.6.1

仮想化環境での障害監視

仮想化システムで，仮想サーバを監視し，障害の発生を検知できるようになりました。

仮想化システム構築・運用ガイド

−

(4)　運用性の維持・向上

運用性の維持・向上を目的として変更された項目を次の表に示します。

表D‒41　運用性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

管理ユーザアカウントの省略

運用管理ポータル，Management Serverのコマンド，またはSmart Composer機能のコマンドで，ユーザのログインIDおよびパスワードの入力を省略できるようになりました。

システム構築・運用ガイド

4.1.15

運用管理ポータル操作ガイド

2.2，7.1.1，7.1.2，7.1.3，8.1，8.2.1，付録E.2

リファレンス コマンド編

1.4，mngsvrctl（Management Serverの起動／停止／セットアップ），mngsvrutil（Management Serverの運用管理コマンド），8.3，cmx_admin_passwd（Management Serverの管理ユーザアカウントの設定）

仮想化環境の運用

仮想化システムで，複数の仮想サーバを対象にした一括起動・一括停止，スケールイン・スケールアウトなどを実行する手順を追加しました。

仮想化システム構築・運用ガイド

4章，6章

(5)　そのほかの目的

そのほかの目的で変更された項目を次の表に示します。

表D‒42　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

Tenured領域内不要オブジェクト統計機能

Tenured領域内で不要となったオブジェクトだけを特定できるようになりました。

このマニュアル

9.8

Tenured増加要因の基点オブジェクトリスト出力機能

Tenured領域内不要オブジェクト統計機能を使って特定した，不要オブジェクトの基点となるオブジェクトの情報を出力できるようになりました。

9.9

クラス別統計情報解析機能

クラス別統計情報をCSV形式で出力できるようになりました。

9.10

論理サーバの自動再起動回数オーバー検知によるクラスタ系切り替え

Management Serverを系切り替えの監視対象としているクラスタ構成の場合，論理サーバが異常停止状態(自動再起動回数をオーバーした状態，または自動再起動回数の設定が0のときに障害を検知した状態)になったタイミングでの系切り替えができるようになりました。

機能解説 運用／監視／連携編

18.4.3，18.5.3，

16.2.2，

16.3.3，16.3.4

ホスト単位管理モデルを対象とした系切り替えシステム

クラスタソフトウェアと連携したシステム運用で，ホスト単位管理モデルを対象にした系切り替えができるようになりました。

16章

ACOS（AX2000，BS320）のサポート

使用できる負荷分散機の種類にACOS（AX2000，BS320）が追加になりました。

システム構築・運用ガイド

4.7.2，4.7.3，4.7.5，4.7.6，付録J，付録J.2

リファレンス 定義編(サーバ定義)

4.2.4，4.3.2，4.3.4，4.3.5，4.3.6，4.7.1

CMTでトランザクション管理をする場合にStateful Session Bean（SessionSynchronization）に指定できるトランザクション属性の追加

CMTでトランザクション管理をする場合に，Stateful Session Bean（SessionSynchronization）にトランザクション属性としてSupports，NotSupportedおよびNeverを指定できるようになりました。

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

2.7.3

OutOfMemoryError発生時の運用管理エージェントの強制終了

JavaVMでOutOfMemoryErrorが発生したときに，運用管理エージェントが強制終了するようになりました。

このマニュアル

2.5.5

スレッドの非同期並行処理

TimerManagerおよびWorkManagerを使用して，非同期タイマ処理および非同期スレッド処理を実現できるようになりました。

機能解説 拡張編

−

付録D.12　08-00での主な機能変更

(1)　開発生産性の向上

開発生産性の向上を目的として変更された項目を次の表に示します。

表D‒43　開発生産性の向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

ほかのアプリケーションサーバ製品からの移行容易化

ほかのアプリケーションサーバ製品からの移行を円滑に実施するため，次の機能を使用できるようになりました。

HTTPセッションの上限が例外で判定できるようになりました。

JavaBeansのIDが重複している場合や，カスタムタグの属性名とTLDの定義で大文字・小文字が異なる場合に，トランスレーションエラーが発生することを抑止できるようになりました。

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

2.3，2.7.5

cosminexus.xmlの提供

アプリケーションサーバ独自の属性をcosminexus.xmlに記載することによって，J2EEアプリケーションをJ2EEサーバにインポート後，プロパティの設定をしないで開始できるようになりました。

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

16.3

(2)　標準機能への対応

標準機能への対応を目的として変更された項目を次の表に示します。

表D‒44　標準機能への対応を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

Servlet 2.5への対応

Servlet 2.5に対応しました。

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

2.2，2.5.4，2.6，8章

JSP 2.1への対応

JSP 2.1に対応しました。

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

2.3.1，2.3.3，2.5，2.6，8章

JSPデバッグ

MyEclipseを使用した開発環境でJSPデバッグができるようになりました。※

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

2.4

タグライブラリのライブラリJARへの格納とTLDのマッピング

タグライブラリをライブラリJARに格納した場合に，Webアプリケーション開始時にWebコンテナによってライブラリJAR内のTLDファイルを検索し，自動的にマッピングできるようになりました。

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

2.3.4

application.xmlの省略

J2EEアプリケーションでapplication.xmlが省略できるようになりました。

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

16.4

アノテーションとDDの併用

アノテーションとDDを併用できるようになり，アノテーションで指定した内容をDDで更新できるようになりました。

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

17.5

アノテーションのJava EE 5標準準拠（デフォルトインターセプタ）

デフォルトインターセプタをライブラリJARに格納できるようになりました。また，デフォルトインターセプタからDIできるようになりました。

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

16.4

@Resourceの参照解決

@Resourceでリソースの参照解決ができるようになりました。

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

17.4

JPAへの対応

JPA仕様に対応しました。

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

6章

注※　09-00以降では，WTPを使用した開発環境でJSPデバッグ機能を使用できます。

(3)　信頼性の維持・向上

信頼性の維持・向上を目的として変更された項目を次の表に示します。

表D‒45　信頼性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

セッション情報の永続化

HTTPセッションのセッション情報をデータベースに保存して引き継げるようになりました。

機能解説 拡張編

5章，6章

FullGCの抑止

FullGCの要因となるオブジェクトをJavaヒープ外に配置することで，FullGC発生を抑止できるようになりました。

機能解説 拡張編

7章

クライアント性能モニタ

クライアント処理に掛かった時間を調査・分析できるようになりました。

−

−

（凡例）−：09-00で削除された機能です。

(4)　運用性の維持・向上

運用性の維持・向上を目的として変更された項目を次の表に示します。

表D‒46　運用性の維持・向上を目的とした変更

項目

変更の概要

参照先マニュアル

参照個所

運用管理ポータルでのアプリケーション操作性向上

アプリケーションおよびリソースの操作について，サーバ管理コマンドと運用管理ポータルの相互運用ができるようになりました。

運用管理ポータル操作ガイド

1.1.3

(5)　そのほかの目的

そのほかの目的で変更された項目を次の表に示します。

表D‒47　そのほかの目的による変更

項目

変更の概要

参照先マニュアル

参照個所

無効なHTTP Cookieの削除

無効なHTTP Cookieを削除できるようになりました。

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

2.7.4

ネーミングサービスの障害検知

ネーミングサービスの障害が発生した場合に，EJBクライアントが，より早くエラーを検知できるようになりました。

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

2.9

コネクション障害検知タイムアウト

コネクション障害検知タイムアウトのタイムアウト時間を指定できるようになりました。

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

3.15.1

Oracle11gへの対応

データベースとしてOracle11gが使用できるようになりました。

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

3章

バッチ処理のスケジューリング

バッチアプリケーションの実行をCTMによってスケジューリングできるようになりました。

機能解説 拡張編

4章

バッチ処理のログ

バッチ実行コマンドのログファイルのサイズ，面数，ログの排他処理失敗時のリトライ回数とリトライ間隔を指定できるようになりました。

リファレンス 定義編(サーバ定義)

3.2.5

snapshotログ

snapshotログの収集内容が変更されました。

このマニュアル

付録A.1，付録A.2

メソッドキャンセルの保護区公開

メソッドキャンセルの対象外となる保護区リストの内容を公開しました。

機能解説 運用／監視／連携編

付録C

統計前のGC選択機能

クラス別統計情報を出力する前に，GCを実行するかどうかを選択できるようになりました。

このマニュアル

9.7

Survivor領域の年齢分布情報出力機能

Survivor領域のJavaオブジェクトの年齢分布情報をJavaVMログファイルに出力できるようになりました。

このマニュアル

9.11

ファイナライズ滞留解消機能

JavaVMのファイナライズ処理の状態を監視して，処理の滞留を解消できるようになりました。

−

−

サーバ管理コマンドの最大ヒープサイズの変更

サーバ管理コマンドが使用する最大ヒープサイズが変更されました。

リファレンス 定義編(サーバ定義)

5.2.1，5.2.2

推奨しない表示名を指定された場合の対応

J2EEアプリケーションで推奨しない表示名を指定された場合にメッセージが出力されるようになりました。

メッセージ(構築／運用／開発用)

KDJE42374-W

（凡例）−：09-00で削除された機能です。

付録E　用語解説

マニュアルで使用する用語について

マニュアル「アプリケーションサーバ & BPM/ESB基盤 用語解説」を参照してください。

索引

記号

-XX:+HitachiJavaClassLibTrace[1]

-XX:+HitachiLocalsInThrowableオプションが指定されている場合[1]

-XX:+HitachiOutOfMemoryStackTrace[1]

-XX:+HitachiVerboseGC[1]

-XX:+JITCompilerContinuation[1]

数字

09-00での主な機能変更[1]

09-70での主な機能変更[1]

09-80での主な機能変更[1]

09-87から11-20への移行[1]

09-87での主な機能変更[1]

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

11-20への移行とV9互換モードについて[1]

11-00での主な機能変更[1]

11-10での主な機能変更[1]

C

CDIのトレース取得ポイント[1]

cjenvupdate[1]

cjgetsysinfoコマンドの実行によって実行されるOSのコマンド[1]

CJMSプロバイダのトレース取得ポイント[1]

CJMSプロバイダのログ取得の設定[1]

cjrarupdate[1]

com.cosminexus.manager.cmdtracelog.fnum[1]

com.cosminexus.manager.cmdtracelog.size[1]

com.cosminexus.manager.log.compatible[1]

com.cosminexus.manager.log.dir[1]

com.cosminexus.manager.messagelog.fnum[1]

com.cosminexus.manager.messagelog.size[1]

com.cosminexus.manager.messagelog.style[1]

com.cosminexus.manager.messagelog.time[1]

com.cosminexus.manager.tracelog.fnum[1]

com.cosminexus.manager.tracelog.size[1]

com.cosminexus.manager.tracelog.style[1]

com.cosminexus.manager.tracelog.time[1]

com.cosminexus.mngsvr.log.level[1]

com.cosminexus.mngsvr.log.rotate[1]

com.cosminexus.mngsvr.log.size[1]

com.cosminexus.mngsvr.trace[1]

Component Container管理者のセットアップコマンドの実行情報（UNIXの場合）[1]

Component Transaction Monitorのログ[1]

Component Transaction Monitorのログの取得[1]

Concurrency Utilitiesのトレース取得ポイント[1]

CORBAネーミングサービスのスレッドダンプの取得[1]

coreダンプ取得の設定[1]

coreダンプの生成を示すメッセージの出力内容[1]

CTMのトレース取得ポイント[1]

Cヒープが不足した場合[1]

Cヒープが不足した場合のメッセージログの出力項目[1]

Cヒープ不足を示すメッセージログの出力内容[1]

D

DB Connector，JCAコンテナのトレース取得ポイント[1]

DIのトレース取得ポイント[1]

E

ejb.server.log.directory[1]、[2]、[3]

ejbserver.connector.logwriter.filenum[1]

ejbserver.connector.logwriter.filesize[1]

ejbserver.logger.access_log.nio_http.format[1]

ejbserver.logger.access_log.websocket.enabled[1]

ejbserver.logger.access_log.websocket.format[1]

ejbserver.logger.channels.define.<チャネル名>.filenum〔J2EEサーバ〕[1]

ejbserver.logger.channels.define.<チャネル名>.filenum〔バッチサーバ〕[1]

ejbserver.logger.channels.define.<チャネル名>.filesize〔J2EEサーバ〕[1]

ejbserver.logger.channels.define.<チャネル名>.filesize〔バッチサーバ〕[1]

ejbserver.logger.channels.define.NIOHTTPAccessLogFile.filenum[1]

ejbserver.logger.channels.define.NIOHTTPAccessLogFile.filesize[1]

ejbserver.logger.channels.define.WebSocketAccessLogFile.filenum[1]

ejbserver.logger.channels.define.WebSocketAccessLogFile.filesize[1]

ejbserver.logger.enabled.*[1]、[2]

ejbserver.logger.rotationStyle[1]

ejbserver.logger.rotationTime[1]

EJBクライアントアプリケーションのシステムログ[1]

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

EJBクライアントアプリケーションのシステムログの出力先[1]

EJBクライアントアプリケーションのシステムログの種類[1]

EJBクライアントアプリケーションのユーザログの取得[1]

EJBクライアントアプリケーションのログ[1]

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

EJBコンテナのトレース取得ポイント[1]

Explicitメモリブロックの自動解放処理[1]

Explicitメモリブロックの自動解放処理時のJavaヒープあふれ[1]

G

GCの選択の指針[1]

H

HiRDB Type4 JDBC Driverを使用したデータベース接続への移行時の注意事項[1]

hndlwrap機能[1]

HttpsdCustomLogFileDir[1]

HttpsdCustomlogFormat[1]

HttpsdCustomMethod[1]

HttpsdErrorLogFileDir[1]

HttpsdErrorMethod[1]

HttpsdRequestLogFileDir[1]

HttpsdRequestMethod[1]

HTTPセッションを更新するリクエスト処理のトレース取得ポイントと取得できるトレース情報（セッションマネージャの指定機能のトレース）[1]

HTTPセッションを作成するリクエスト処理のトレース取得ポイントと取得できるトレース情報（セッションマネージャの指定機能のトレース）[1]

HTTPセッションを作成するリクエスト処理のトレース取得ポイントと取得できるトレース情報（データベースセッションフェイルオーバ機能のトレース）[1]

HTTPセッションを無効化するリクエスト処理のトレース取得ポイントと取得できるトレース情報（セッションマネージャの指定機能のトレース）[1]

HWSLogTimeVerbose[1]

HWSRequestLogLevel[1]

I

Internal Errorが発生した場合[1]

J

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

J2EEアプリケーションのユーザログ[1]

J2EEサーバの移行コマンドで自動的に追加／変更／削除される定義[1]

J2EEサーバの移行コマンドの実行[1]

J2EEサーバの開始・終了時のトレース取得ポイント[1]

J2EEサーバの作業ディレクトリのディスク容量の確認[1]

J2EEサーバのスレッドダンプの取得[1]

J2EEサーバのメモリダンプの取得[1]

J2EEサーバのログ[1]

J2EEサーバのログ取得の設定[1]

J2EEサーバのログ種別[1]

J2EEサーバまたはバッチサーバの作業ディレクトリの内容[1]

J2EEサーバ・サーバ管理コマンドのログの取得[1]

Java Batchのトレース取得ポイント[1]

javagcコマンド[1]

JavaMailのトレース取得ポイント[1]

javatrace起動コマンドのコマンドライン[1]

JavaVMが異常終了した場合[1]

JavaVMが出力するメッセージログ[1]

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

JavaVMスタックトレース情報[1]

JavaVMのGCログ[1]、[2]

JavaVMの資料取得の設定[1]

JavaVMのスタックトレース情報[1]

JavaVMのスレッドダンプ[1]、[2]

JavaVMのスレッドダンプ取得の設定[1]

JavaVMログ（JavaVMログファイル）[1]

JavaVMログ取得の設定[1]

JavaVMログファイル[1]、[2]

JavaVMログファイルを出力するオプション[1]

Javaヒープの使用状況[1]

JAX-RSのトレース取得ポイント[1]

JITコンパイル[1]

JNDIのトレース取得ポイント[1]

JP1/IMと連携したシステムでのトラブルへの対処[1]

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

JPAでのトレース取得ポイント[1]

JSF 2.3のトレース取得ポイント[1]

JTAのトレース取得ポイント[1]

L

LogLevel[1]

M

Management Serverの移行コマンドの実行[1]

Managementイベント発行ログ[1]、[2]

Managerのログ取得の設定[1]

N

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

NIO HTTPサーバのアクセスログの出力形式と出力項目[1]

NIO HTTPサーバのログ取得の設定[1]

O

OSの状態情報およびOSのログ[1]

OSの状態情報とOSのログ[1]

OSの統計情報[1]

OSの統計情報取得の設定[1]

OSのログの取得[1]

OTSのトレース取得ポイント[1]

OutOfMemoryError発生時に運用管理エージェントが強制終了した場合[1]

P

Performance Tracerのログ[1]

Performance Tracerのログの出力先[1]

Performance Tracerのログの取得[1]

Performance Tracerのログの種類[1]

Permanent領域からMetaspace領域への移行[1]

PrfTraceBufferSize[1]

PrfTraceCount[1]

PrfTraceFileSize[1]

PrfTraceLevel[1]

PRFデーモン[1]、[2]、[3]

PRFトレース出力ライブラリ[1]

PRFトレース取得レベル[1]、[2]、[3]

PRFトレース取得レベル〔CMTおよびTransactionManager〕[1]

PRFトレース取得レベル〔DB Connector〕[1]、[2]

PRFトレース取得レベル〔DI〕[1]

PRFトレース取得レベル〔J2EEサーバ〕[1]

PRFトレース取得レベル〔JNDI〕[1]

PRFトレース取得レベル〔Message-driven Bean（EJB2.0）〕[1]

PRFトレース取得レベル〔Message-driven Bean（EJB2.1以降）〕[1]

PRFトレース取得レベル〔OTS〕[1]

PRFトレース取得レベル〔RMI〕[1]

PRFトレース取得レベル〔Session Bean・Entity Bean〕[1]

PRFトレース取得レベル〔TP1インバウンド連携機能〕[1]

PRFトレース取得レベル〔UserTransaction〕[1]

PRFトレース取得レベル〔Webコンテナ〕[1]、[2]

PRFトレース取得レベル〔コネクションアソシエーション〕[1]

PRFトレース取得レベル〔コネクション自動クローズ時〕[1]

PRFトレース取得レベル〔トランザクションタイムアウト〕[1]

PRFトレース取得レベル〔バッチアプリケーション実行機能〕[1]

PRFトレース取得レベル〔フィルタのトレース（正常に処理が終了した場合）〕[1]

PRFトレース取得レベル〔フィルタのトレース（例外が発生した場合）〕[1]

PRFトレース取得レベル〔ワーク管理〕[1]

PRFトレースファイル[1]

R

RMIのトレース取得ポイント[1]

RSA BSAFE SSL-Jの削除[1]

S

siginfo情報（UNIXの場合）[1]

snapshotlog.2.conf[1]

snapshotlog.conf[1]

snapshotlog.param.conf[1]

snapshotログ[1]、[2]、[3]

snapshotログ収集の設定（J2EEアプリケーションを実行するシステム）[1]

snapshotログ収集の設定（バッチアプリケーションを実行するシステム）[1]

snapshotログ収集の流れ[1]

snapshotログとして収集できる資料[1]

snapshotログの収集[1]

snapshotログの収集対象一覧[1]

snapshotログの収集タイミング[1]

STATICメンバ統計機能[1]

STATICメンバ統計機能で出力するクラス別統計情報[1]

Survivor領域の年齢分布情報出力機能[1]

Survivor領域の年齢分布情報出力機能使用時の注意事項[1]

Survivor領域の年齢分布情報出力機能の概要[1]

Survivor領域の年齢分布情報の出力形式と出力例[1]

syslog[1]、[2]

syslogの出力形式と出力項目（UNIXの場合）[1]

T

Tenured増加要因の基点オブジェクトリスト出力機能[1]

Tenured領域内不要オブジェクト統計機能[1]

Tenured領域内不要オブジェクト統計機能で出力するクラス別統計情報[1]

Tenured領域内不要オブジェクト統計機能の概要[1]

Tenured領域内不要オブジェクト統計機能の実行に関する注意事項[1]

TP1インバウンド連携機能のトレース取得ポイント[1]

TPBrokerのログ取得の設定[1]

U

USRCONF_JVM_ARGS[1]

V

vbroker.orb.htc.comt.entryCount[1]、[2]、[3]

vbroker.orb.htc.comt.fileCount[1]、[2]、[3]

vbroker.orb.htc.tracePath[1]、[2]、[3]、[4]

VMの状態[1]

W

WebSocketのトレース取得ポイント[1]

Webクライアント構成の例[1]

Webコンテナのトレース取得ポイント（セッショントレース）[1]

Webコンテナのトレース取得ポイント（セッションマネージャの指定機能のトレース）[1]

Webコンテナのトレース取得ポイント（データベースセッションフェイルオーバ機能のトレース）[1]

Webコンテナのトレース取得ポイント（フィルタのトレース）[1]

Webコンテナのトレース取得ポイント（リクエスト処理のトレース）[1]

Webサーバで収集した性能解析トレースファイルの例[1]

Webサーバのレスポンスタイムの解析[1]

Webサーバのログ取得の設定[1]

Webサーバログ[1]

あ

アクセスログ[1]

圧縮オブジェクトポインタ機能[1]

アプリケーション管理の永続化コンテキストを利用した場合のトレース取得ポイントと取得できるトレース情報[1]

アプリケーションサーバ 11-00または11-10から，11-20までの仕様変更[1]

アプリケーションサーバ 11-20での主な機能変更[1]

アプリケーションサーバ Version 8から11-20までの仕様変更[1]

アプリケーションサーバ Version 9から11-20までの仕様変更[1]

アプリケーションサーバで収集した性能解析トレースファイルをフィルタリングした例[1]

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

アプリケーションサーバの移行手順の詳細[1]

アプリケーションサーバの移行の概要〔J2EEサーバモードの場合〕[1]

アプリケーションサーバの性能解析トレースの概要[1]

アプリケーションサーバの動作環境および動作状態の確認[1]

アプリケーションサーバのリソース設定情報[1]

アプリケーションサーバのログ[1]

アプリケーションの開始時に発生する主なトラブル[1]

アプリケーションの書き換え時のログ[1]

アプリケーションの性能解析トレースの概要[1]

アプリケーションの設定（新規インストールの場合）[1]

アプリケーションの退避〔アプリケーションサーバの移行〕[1]

アプリケーションのトレース取得ポイント[1]

アプリケーションのユーザログの取得[1]、[2]

い

移行コマンド（cjenvupdate）のログ[1]、[2]、[3]

移行コマンドで作成されたバックアップの削除[1]

移行方針の決定〔アプリケーションサーバの移行〕[1]

異常終了位置とシグナル種別[1]

一次送付資料[1]、[2]

イベントログ[1]、[2]

イベントログの出力形式と出力項目（Windowsの場合）[1]

インスタンス統計機能[1]

インスタンス統計機能で出力するクラス別統計情報[1]

インストール時に発生する主なトラブル[1]

インプロセストランザクションサービスを使用している場合[1]

う

運用管理エージェント，運用監視エージェント，およびManagement Serverのログの出力先[1]

運用管理エージェント・運用監視エージェント・Management Serverのログ[1]

運用管理エージェント・運用監視エージェント・Management Serverのログの取得[1]、[2]

運用管理コマンドを使用したsnapshotログの収集[1]

運用時のトラブルシュートの例[1]

え

エラーメッセージ出力[1]

エラーリポートファイル[1]

エラーリポートファイルの出力先[1]、[2]

お

応答遅延のトラブルシュート[1]

か

拡張verbosegc情報の取得[1]

拡張verbosegc情報の取得を指定するオプション[1]

拡張スレッドダンプ[1]、[2]

仮想サーバマネージャの内部構築ツールおよびサーバ通信エージェントのログ[1]

仮想サーバマネージャの内部構築ツールおよびサーバ通信エージェントのログの取得[1]

稼働（運用）時に発生する主なトラブル[1]

稼働（運用）時のトラブルシュート[1]

カレントスレッド情報[1]

環境変数[1]

監査ログで出力するログ[1]

き

起動順序の依存関係[1]

機能の分類と機能解説のマニュアルの対応[1]

機能レイヤ[1]

旧バージョンから11-20までの仕様変更の確認[1]

旧バージョンからVersion 9までの仕様変更の一覧[1]

旧バージョンからアプリケーションサーバ 11-20への移行作業（更新インストールの場合）[1]

旧バージョンからアプリケーションサーバ 11-20への移行作業（新規インストールの場合）[1]

旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）[1]

く

クライアントアプリケーション情報[1]

クラス別統計機能[1]

クラス別統計機能を前提とする機能[1]

クラス別統計情報[1]

クラス別統計情報解析機能[1]

クラス別統計情報の出力[1]

クラスまたは配列型の変数の実際の型名を出力する場合の出力例[1]

クラスまたは配列型の変数を文字列として出力する場合の出力例[1]

こ

更新インストールの場合[1]

更新インストールの場合の定義情報のバックアップ〔アプリケーションサーバの移行〕[1]

構成ソフトウェアごとの参照先マニュアル〔アプリケーションサーバの移行〕[1]

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

構築時のトラブルシュート[1]

コードキャッシュ領域に関するログの内容[1]

互換重視のシステムおよび推奨機能を使用したシステムの特徴[1]

コネクションID[1]

コネクション関連のトレース取得ポイント[1]

コマンドおよびVMパラメタ[1]

コンソールログ[1]

コンテナ管理の永続化コンテキストを利用した場合のトレース取得ポイントと取得できるトレース情報[1]

さ

サーバ／アプリケーションの保守（メンテナンス）時に発生する主なトラブル[1]

サーバ管理コマンドでのトラブルシュート[1]

サーバ管理コマンドのログ[1]、[2]、[3]

サーバ管理コマンドのログの出力先（互換モード）[1]、[2]

サーバ起動時に発生する主なトラブル[1]

サーバ構築時に発生する主なトラブル[1]

作業ディレクトリ[1]

参照関係情報出力機能[1]

参照関係情報出力機能で出力するクラス別統計情報[1]

し

時間情報[1]

シグナル情報[1]

シグナル情報の格納先アドレス[1]

システムダウン[1]

システム提供の障害検知時コマンド[1]

システムで提供されている障害検知時コマンドで取得できる情報[1]

システムの構築〔アプリケーションサーバの移行〕[1]

システム名，CPU，実メモリ，およびVM情報[1]

システムモニタの設定[1]

システムモニタの設定内容[1]

シフトモード[1]

出力レベルがdebugの場合に出力される内容[1]

出力レベルがnormalの場合に出力される内容[1]

出力レベルがverboseの場合に出力される内容[1]

手動による定義などの修正〔アプリケーションサーバの移行〕[1]

取得が必要な資料の一覧[1]

取得が必要な資料の取得方法と調査方法の参照先[1]

取得が必要な資料の種類[1]

取得できるトレース情報〔CMTおよびTransactionManager〕[1]

取得できるトレース情報〔DB Connector for Reliable Messaging〕[1]

取得できるトレース情報〔DB Connector〕[1]、[2]

取得できるトレース情報〔DI〕[1]

取得できるトレース情報〔J2EEサーバ〕[1]

取得できるトレース情報〔JNDI〕[1]

取得できるトレース情報〔Message-driven Bean（EJB2.0）〕[1]

取得できるトレース情報〔Message-driven Bean（EJB2.1以降）〕[1]

取得できるトレース情報〔OTS〕[1]

取得できるトレース情報〔RMI〕[1]

取得できるトレース情報〔Session Bean・Entity Bean〕[1]

取得できるトレース情報〔TP1インバウンド連携機能〕[1]

取得できるトレース情報〔UserTransaction〕[1]

取得できるトレース情報〔Webコンテナ〕[1]、[2]

取得できるトレース情報〔コネクションアソシエーション〕[1]

取得できるトレース情報〔コネクション自動クローズ時〕[1]

取得できるトレース情報〔セッションマネージャの指定機能〕[1]、[2]、[3]、[4]

取得できるトレース情報〔データベースセッションフェイルオーバ機能〕[1]、[2]、[3]、[4]

取得できるトレース情報〔トランザクションタイムアウト〕[1]

取得できるトレース情報〔バッチアプリケーション実行機能〕[1]

取得できるトレース情報〔フィルタのトレース（正常に処理が終了した場合）〕[1]

取得できるトレース情報〔フィルタのトレース（例外が発生した場合）〕[1]

取得できるトレース情報〔ワーク管理〕[1]

障害検知時コマンド[1]

障害検知時コマンドによる資料取得[1]

障害検知時コマンドによる資料取得の設定（J2EEアプリケーションを実行するシステム）[1]

障害検知時コマンドによる資料取得の設定（バッチアプリケーションを実行するシステム）[1]

障害発生時のCMR用の表の回復[1]

詳細レベル[1]

処理性能の解析作業の概要[1]

資料の取得[1]

新規インストールの場合[1]

新規インストールの場合の定義情報のバックアップ〔アプリケーションサーバの移行〕[1]

す

推奨機能への移行[1]

スタックトレース[1]

スタックトレース情報[1]

スタックトレースにローカル変数情報を出力するためのオプション[1]

スタックの先頭から格納されている情報[1]

スレッド作成に失敗した場合[1]

スレッド情報[1]

スレッドダンプ情報の構成[1]

スレッドの非同期並行処理を使用する場合[1]

スローダウン[1]

せ

性能解析トレース[1]、[2]

性能解析トレースの概要[1]

性能解析トレースの構成[1]

性能解析トレースの仕組み[1]

性能解析トレースのトレース取得ポイントとPRFトレース取得レベル[1]

性能解析トレースのトレース情報収集[1]

性能解析トレースのルートアプリケーション情報取得のための実装[1]

性能解析トレースファイル[1]、[2]

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

性能解析トレースファイルの収集[1]

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

性能解析トレースファイルの出力先[1]

性能解析トレースファイルの出力情報（性能解析トレースの場合）[1]

性能解析トレースファイルの出力情報（ユーザ拡張性能解析トレースの場合）[1]

性能解析トレースファイルのファイル名[1]

性能解析トレースファイルを使用した処理性能の解析作業[1]

性能解析トレースファイルを利用したアプリケーションサーバの処理性能の解析[1]

性能解析トレースを使用するための設定[1]

製品のJavaVMの機能[1]

製品のJavaVMの機能の概要[1]

セッショントレース[1]

セッショントレース情報が出力されている性能解析トレースファイルの例（セッションを生成するリクエスト部分）[1]

セッションの有効期間の確認[1]

セッションのライフサイクルの調査[1]

セッションマネージャの起動・停止処理のトレース取得ポイントと取得できるトレース情報（セッションマネージャの指定機能のトレース）[1]

全構成ソフトウェアの新規インストール〔アプリケーションサーバの移行〕[1]

た

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

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

て

定義送付資料[1]、[2]

定義などのバックアップ〔J2EEサーバモードの場合〕[1]

データベースセッションフェイルオーバ機能でトラブルが発生した場合[1]

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

と

統計前のGC選択機能[1]

統計前のGC選択機能の概要[1]

統合ユーザ管理のログの取得[1]

統合ログ[1]、[2]

統合ログの出力先[1]

登録済みシグナルハンドラ[1]

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

トラブルシューティング[1]

トラブルシューティングで使用する資料の種類[1]

トラブルシューティングで必要な資料の出力先と出力方法[1]

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

トラブルシューティングのための準備[1]

トラブルシューティングの手順[1]

トラブルシュートの流れ[1]

トラブル種別ごとの取得資料一覧[1]

トラブルの分析[1]

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

トラブル発生時の対処の流れ[1]

トラブルへの対処と回復[1]

トランザクションタイムアウト時に出力される性能解析トレース[1]

トレース共通ライブラリ形式[1]

トレース共通ライブラリ形式（シングルプロセス）[1]

トレース共通ライブラリ形式（マルチプロセス）[1]

トレース共通ライブラリ形式のログの出力形式と出力項目[1]

トレース共通ライブラリ形式のログの出力項目[1]

トレース共通ライブラリ形式のログを参照する場合の注意[1]

トレース取得ポイント[1]、[2]、[3]

トレース取得ポイントとPRFトレース取得レベル〔DB Connector for Reliable Messaging〕[1]

トレース取得ポイントとPRFトレース取得レベル〔セッションマネージャの指定機能〕[1]、[2]、[3]、[4]

トレース取得ポイントとPRFトレース取得レベル〔データベースセッションフェイルオーバ機能〕[1]、[2]、[3]、[4]

トレース取得ポイント〔CMTおよびTransactionManager〕[1]

トレース取得ポイント〔DB Connector〕[1]、[2]

トレース取得ポイント〔DI〕[1]

トレース取得ポイント〔J2EEサーバ〕[1]

トレース取得ポイント〔JNDI〕[1]

トレース取得ポイント〔Message-driven Bean（EJB2.0）〕[1]

トレース取得ポイント〔Message-driven Bean（EJB2.1以降）〕[1]

トレース取得ポイント〔OTS〕[1]

トレース取得ポイント〔RMI〕[1]

トレース取得ポイント〔Session Bean・Entity Bean〕[1]

トレース取得ポイント〔TP1インバウンド連携機能〕[1]

トレース取得ポイント〔UserTransaction〕[1]

トレース取得ポイント〔Webコンテナ〕[1]、[2]

トレース取得ポイント〔コネクションアソシエーション〕[1]

トレース取得ポイント〔コネクション自動クローズ時〕 [1]

トレース取得ポイント〔トランザクションタイムアウト〕[1]

トレース取得ポイント〔バッチアプリケーション実行機能〕[1]

トレース取得ポイント〔フィルタのトレース（正常に処理が終了した場合）〕[1]

トレース取得ポイント〔フィルタのトレース（例外が発生した場合）〕[1]

トレース取得ポイント〔ワーク管理〕[1]

トレース情報のキー情報[1]

トレース情報の取得によるトラブルシュート[1]

に

二次送付資料[1]、[2]

は

バックアップを取る情報（新規インストールの場合）[1]

バッチアプリケーション実行機能のトレース取得ポイント[1]

バッチアプリケーションのユーザログの出力先[1]

バッチサーバの移行コマンドで自動的に追加／変更／削除される定義[1]

バッチサーバの移行コマンドの実行[1]

バッチサーバの作業ディレクトリのディスク容量の確認[1]

バッチサーバのログ[1]

バッチサーバのログ取得の設定[1]

パフォーマンストレーサ[1]

ハングアップ（無応答）[1]

ひ

標準出力／標準エラー出力／ユーザログのトレース取得ポイント[1]

標準の形式および簡易出力フォーマットでの出力例[1]

標準レベル[1]

ふ

ファイナライズ滞留解消機能[1]

プロセスダウンのトラブルシュート[1]

ほ

保守員[1]

保守員に連絡が必要なトラブル[1]

保守用ログ[1]、[2]

保守レベル[1]、[2]

ホスト単位管理モデルを対象とした系切り替えシステムでトラブルが発生した場合[1]

ま

マシン情報[1]

マルチプロセスに対応したトレース共通ライブラリ形式の変更ファイル一覧[1]

マルチプロセスに対応したトレース共通ライブラリの旧バージョンとの差異[1]

め

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルオープンエラー[1]

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルパースエラー[1]

明示管理ヒープ機能のイベントログ[1]、[2]、[3]

明示管理ヒープ機能のイベントログ取得の設定[1]

明示管理ヒープ機能のイベントログの確認方法[1]

明示管理ヒープ機能のイベントログの出力契機[1]

明示管理ヒープ自動配置エラー[1]

明示管理ヒープ自動配置設定ファイルオープンエラー[1]

明示管理ヒープ自動配置設定ファイルパースエラー[1]

メッセージログ[1]、[2]

メモリ情報[1]

メモリダンプ[1]

メモリ不足を示すメッセージの出力内容[1]

ゆ

ユーザ拡張性能解析トレース実行時に出力されるログ情報[1]

ユーザ拡張性能解析トレース使用時の注意事項[1]

ユーザ拡張性能解析トレース設定ファイル[1]

ユーザ拡張性能解析トレース設定ファイル作成の注意事項[1]

ユーザ拡張性能解析トレース設定ファイルの読み込み時のログ[1]

ユーザ拡張性能解析トレースの構成[1]

ユーザ拡張性能解析トレースの仕組み[1]

ユーザ拡張性能解析トレースのトレース情報収集[1]

ユーザ拡張性能解析トレースのトレース対象メソッドの設定[1]

ユーザ拡張性能解析トレースを使用するための設定[1]

ユーザが作成した障害検知時コマンドで取得できる情報[1]

ユーザ作成の障害検知時コマンド[1]

ユーザダンプ取得の設定[1]

ユーザダンプの取得[1]

ユーザログ[1]、[2]

よ

抑止レベル[1]

ら

ライブラリ[1]

ラップアラウンドモード[1]

り

リソースアダプタの移行コマンドの実行[1]

リソースアダプタのログ取得の設定[1]

リソースアダプタバージョンアップコマンド（cjrarupdate）のログ[1]、[2]、[3]

リソース枯渇監視のログ[1]、[2]、[3]

リソース枯渇監視ログ[1]、[2]

る

ルートアプリケーション情報[1]、[2]

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

れ

例外ログ[1]、[2]

レジスタ情報[1]

ろ

ローカル変数[1]

ローカル変数情報[1]

ログ以外に取得が必要な情報[1]、[2]

ログサイズの変更[1]

ログの出力先[1]、[2]、[3]、[4]

ログの出力先の変更[1]

ログの出力先を設定するユーザ定義ファイル[1]、[2]

ログファイルの非同期出力機能[1]

ログレベルの変更[1]

ログを出力するプロセス[1]

論理サーバの設定情報の再読み込みおよび配布[1]