JP1 Version 8

JP1/Performance Management - Agent Option for Enterprise Applications

解説・文法書

3020-3-K66-40

目　　次

前書き

変更内容

はじめに

第1編　概要編

1.　PFM - Agent for Enterprise Applicationsの概要

1.1　PFM - Agent for Enterprise Applicationsの特長

1.1.1　SAPシステムのパフォーマンスデータを収集できます

1.1.2　パフォーマンスデータの性質に応じた方法で収集できます

1.1.3　パフォーマンスデータを保存できます

1.1.4　SAPシステムの運用上の問題点を通知できます

1.1.5　アラームおよびレポートが容易に定義できます

1.1.6　SAPシステムのシステムログ情報およびCCMSアラート情報を抽出できます

1.1.7　SAPシステムのモニター情報を収集できます

1.1.8　クラスタシステムで運用できます

1.2　パフォーマンスデータの収集と管理の概要

1.3　PFM - Agent for Enterprise Applicationsを使用したパフォーマンス監視の例

1.3.1　パフォーマンス監視の目的

1.3.2　ベースラインの選定

1.3.3　パフォーマンス監視の例

第2編　運用・操作編

2.　インストールとセットアップ（Windowsの場合）

2.1　インストールとセットアップ

2.1.1　インストールとセットアップの前に

2.1.2　インストールとセットアップの流れ

2.1.3　インストール手順

2.1.4　PFM - Agent for Enterprise Applicationsのセットアップ手順

2.2　アンインストールとアンセットアップ

2.2.1　アンインストールとアンセットアップの前に

2.2.2　アンセットアップ手順

2.2.3　アンインストール手順

2.3　PFM - Agent for Enterprise Applicationsのシステム構成の変更

2.4　PFM - Agent for Enterprise Applicationsの運用方式の変更

2.4.1　パフォーマンスデータの格納先の変更

2.4.2　Storeバージョン2.0への移行

2.4.3　インスタンス環境の更新の設定

3.　インストールとセットアップ（UNIXの場合）

3.1　インストールとセットアップ

3.1.1　インストールとセットアップの前に

3.1.2　インストールとセットアップの流れ

3.1.3　インストール手順

3.1.4　PFM - Agent for Enterprise Applicationsのセットアップ手順

3.2　アンインストールとアンセットアップ

3.2.1　アンインストールとアンセットアップの前に

3.2.2　アンセットアップ手順

3.2.3　アンインストール手順

3.3　PFM - Agent for Enterprise Applicationsのシステム構成の変更

3.4　PFM - Agent for Enterprise Applicationsの運用方式の変更

3.4.1　パフォーマンスデータの格納先の変更

3.4.2　Storeバージョン2.0への移行

3.4.3　インスタンス環境の更新の設定

4.　クラスタシステムでの運用

4.1　クラスタシステムの概要

4.1.1　HAクラスタシステム

4.2　フェールオーバー時の処理

4.2.1　監視対象ホストに障害が発生した場合のフェールオーバー

4.2.2　PFM - Managerが停止した場合の影響

4.3　インストールとセットアップ（Windowsの場合）

4.3.1　インストールを始める前に

4.3.2　インストールから運用開始までの流れ

4.3.3　インストール

4.3.4　セットアップ

4.4　インストールとセットアップ（UNIXの場合）

4.4.1　インストールを始める前に

4.4.2　インストールから運用開始までの流れ

4.4.3　インストール

4.4.4　セットアップ

4.5　アンインストールとアンセットアップ（Windowsの場合）

4.5.1　PFM - Agent for Enterprise Applicationsのアンインストールとアンセットアップの流れ

4.5.2　PFM - Agent for Enterprise Applicationsのアンセットアップ

4.5.3　アンインストール

4.6　アンインストールとアンセットアップ（UNIXの場合）

4.6.1　PFM - Agent for Enterprise Applicationsのアンインストールとアンセットアップの流れ

4.6.2　PFM - Agent for Enterprise Applicationsのアンセットアップ

4.6.3　アンインストール

4.7　PFM - Agent for Enterprise Applicationsの運用方式の変更

4.7.1　インスタンス環境の更新の設定

5.　システムログ情報の抽出

5.1　システムログ情報抽出機能の概要

5.2　システムログ情報の抽出

5.2.1　セットアップ

5.2.2　出力例

5.3　環境パラメーター設定ファイル

5.3.1　設定手順

5.3.2　設定内容

5.4　コマンド実行によるシステムログ情報の抽出

5.4.1　コマンドを実行する前に

5.4.2　コマンド実行によるシステムログ情報の抽出方法

5.4.3　コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル

6.　CCMSアラート情報の抽出

6.1　CCMSアラート情報抽出機能の概要

6.2　CCMSアラート情報の抽出

6.2.1　セットアップ

6.2.2　出力例

6.3　環境パラメーター設定ファイル

6.3.1　設定手順

6.3.2　設定内容

6.4　コマンド実行によるCCMSアラート情報の抽出

6.4.1　コマンドを実行する前に

6.4.2　コマンド実行によるCCMSアラート情報の抽出方法

6.4.3　コマンドを実行してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイル

7.　モニター情報の収集

7.1　モニター情報収集の概要

7.2　モニター情報収集の設定

7.2.1　モニターセット名およびモニター名の設定

7.2.2　パフォーマンスデータ収集の設定

第3編　リファレンス編

8.　ソリューションセット

ソリューションセットの概要

アラームの記載形式

アラーム一覧

Buffer - CUA

Buffer - FieldDescri

Buffer - GenericKey

Buffer - InitialReco

Buffer - Program

Buffer - Screen

Buffer - ShortNameTA

Buffer - SingleRecor

Buffer - TableDefini

Dialog ResponseTime

Extended Memory

Heap Memory

Paging Area

Roll Area

レポートの記載形式

レポートのフォルダ構成

レポート一覧

Dialog ResponseTime

Dialog ResponseTime Status

Dialog ResponseTime Trend（時単位の履歴レポート）

Dialog ResponseTime Trend（日単位の履歴レポート）

Dialog ResponseTime Trend(Multi-Agent)

Process Detail

Process Overview Status

SAP Buffer Detail(CUA)

SAP Buffer Detail(FieldDescription)

SAP Buffer Detail(GenericKey)

SAP Buffer Detail(InitialRecords)

SAP Buffer Detail(Program)

SAP Buffer Detail(Screen)

SAP Buffer Detail(ShortNameTAB)

SAP Buffer Detail(SingleRecord)

SAP Buffer Detail(TableDefinition)

SAP Buffer Hitratio

SAP Buffer Hitratio Status

SAP Buffer Hitratio Trend（時単位の履歴レポート）

SAP Buffer Hitratio Trend（日単位の履歴レポート）

SAP Memory Detail

SAP Memory Used

SAP Memory Used Status

SAP Memory Used Trend（時単位の履歴レポート）

SAP Memory Used Trend（日単位の履歴レポート）

UsersLoggedIn Trend（時単位の履歴レポート）

UsersLoggedIn Trend（日単位の履歴レポート）

UsersLoggedIn Trend(Multi-Agent)

9.　レコード

データモデルについて

レコードの記載形式

ODBCキーフィールド一覧

要約ルール

データ型一覧

フィールドの値

Storeデータベースに記録されるときだけ追加されるフィールド

レコードの注意事項

レコード一覧

Background Processing（PI_BTCP）

Background Service（PI_BTC）

CCMS Alert Monitor Command（PD_ALMX）

Dialog Service（PI_DIA）

Enqueue Service（PI_ENQ）

SAP Buffer Summary（PI_BUFF）

SAP Instance Summary（PD_SRV）

SAP Memory Summary（PI_MEM）

Spool Service（PI_SPO）

System Log Monitor Command（PD_SLMX）

Update1 Service（PI_UPD1）

Update2 Service（PI_UPD2）

User defined Monitor (Perf.)（PI_UMP）

Work Process Summary（PD）

WorkLoad Summary Interval（PI）

10.　コマンド

コマンドの記載形式

コマンド一覧

jr3alget

jr3slget

11.　メッセージ

11.1　メッセージの形式

11.1.1　メッセージの出力形式

11.1.2　メッセージの記載形式

11.1.3　システム管理者の方へ

11.2　メッセージの出力先一覧

11.3　syslogとWindowsイベントログの一覧

11.4　メッセージ一覧

第4編　トラブルシューティング編

12.　トラブルへの対処方法

12.1　対処の手順

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

12.2.1　セットアップやサービスの起動について

12.2.2　コマンドの実行について

12.2.3　アラームの定義について

12.2.4　パフォーマンスデータの収集と管理について

12.2.5　その他のトラブルについて

12.3　ログ情報

12.3.1　ログ情報の種類

12.3.2　ログファイルおよびディレクトリ一覧

12.4　トラブル発生時に採取が必要な資料

12.4.1　Windowsの場合

12.4.2　UNIXの場合

12.5　資料の採取方法

12.5.1　Windowsの場合

12.5.2　UNIXの場合

12.6　Performance Managementの障害検知

12.7　Performance Managementシステムの障害回復

付録

付録A　システム見積もり

付録A.1　メモリー所要量

付録A.2　ディスク占有量

付録A.3　クラスタ運用時のディスク占有量

付録B　カーネルパラメーター

付録C　識別子一覧

付録D　プロセス一覧

付録E　ポート番号一覧

付録E.1　Performance Managementのポート番号

付録E.2　ファイアウォールの通過方向

付録F　PFM - Agent for Enterprise Applicationsのプロパティ

付録F.1　Agent Storeサービスのプロパティ一覧

付録F.2　Agent Collectorサービスのプロパティ一覧

付録G　ファイルおよびディレクトリ一覧

付録G.1　Windowsの場合

付録G.2　UNIXの場合

付録H　移行手順と移行時の注意事項

付録I　バージョン互換

付録J　動作ログの出力

付録J.1　動作ログに出力される事象の種別

付録J.2　動作ログの保存形式

付録J.3　動作ログの出力形式

付録J.4　動作ログを出力するための設定

付録K　各バージョンの変更内容

付録K.1　08-10の変更内容

付録K.2　08-00の変更内容

付録K.3　07-50の変更内容

付録K.4　07-00の変更内容

付録L　用語解説

索引

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

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

前書き

■ 対象製品

P-242C-AA84　 JP1/Performance Management - Manager　 08-50（適用OS：Windows Server 2003）
P-1B2C-AA81　 JP1/Performance Management - Manager　 08-50（適用OS：HP-UX 11i，HP-UX 11i V2(PA-RISC)）
P-1J2C-AA81　 JP1/Performance Management - Manager　 08-50（適用OS：HP-UX 11i V2(IPF)，HP-UX 11i V3(IPF)）
P-9D2C-AA81　 JP1/Performance Management - Manager　 08-50（適用OS：Solaris 9，Solaris 10）
P-1M2C-AA81　 JP1/Performance Management - Manager　 08-50（適用OS：AIX 5.2，AIX 5.3）
P-9S2C-BA81　 JP1/Performance Management - Manager　 08-50（適用OS：Linux AS 4(x86)，Linux ES 4(x86)，Linux AS 4(AMD64 & Intel EM64T)，Linux ES 4(AMD64 & Intel EM64T)）
P-242C-AJ84　 JP1/Performance Management - Base　 08-50（適用OS：Windows 2000，Windows Server 2003）
P-282C-AJ84　 JP1/Performance Management - Base　 08-50（適用OS：Windows Server 2003(IPF)）
P-1B2C-AJ81　 JP1/Performance Management - Base　 08-50（適用OS：HP-UX 11i，HP-UX 11i V2(PA-RISC)）
P-1J2C-AJ81　 JP1/Performance Management - Base　 08-50（適用OS：HP-UX 11i V2(IPF)，HP-UX 11i V3(IPF)）
P-9D2C-AJ81　 JP1/Performance Management - Base　 08-50（適用OS：Solaris 9，Solaris 10）
P-1M2C-AJ81　 JP1/Performance Management - Base　 08-50（適用OS：AIX 5.2，AIX 5.3，AIX 6.1）
P-242C-AR84　 JP1/Performance Management - Web Console　 08-50（適用OS：Windows Server 2003）
P-1J2C-AR81　 JP1/Performance Management - Web Console　 08-50（適用OS：HP-UX 11i V2(IPF)，HP-UX 11i V3(IPF)）
P-9D2C-AR81　 JP1/Performance Management - Web Console　 08-50（適用OS：Solaris 9，Solaris 10）
P-1M2C-AR81　 JP1/Performance Management - Web Console　 08-50（適用OS：AIX 5.2，AIX 5.3）
P-9S2C-AR81　 JP1/Performance Management - Web Console　 08-50（適用OS：Linux AS 4(x86)，Linux ES 4(x86)，Linux AS 4(AMD64 & Intel EM64T)，Linux ES 4(AMD64 & Intel EM64T)）
P-242C-AF84　 JP1/Performance Management - Agent Option for Enterprise Applications　 08-50（適用OS：Windows 2000，Windows Server 2003）
P-282C-AF84　 JP1/Performance Management - Agent Option for Enterprise Applications　 08-50（適用OS：Windows Server 2003(IPF)）
P-1B2C-AF81　 JP1/Performance Management - Agent Option for Enterprise Applications　 08-50（適用OS：HP-UX 11i，HP-UX 11i V2(PA-RISC)）
P-1J2C-AF81　 JP1/Performance Management - Agent Option for Enterprise Applications　 08-50（適用OS：HP-UX 11i V2(IPF)，HP-UX 11i V3(IPF)）
P-9D2C-AF81　 JP1/Performance Management - Agent Option for Enterprise Applications　 08-50（適用OS：Solaris 9，Solaris 10）
P-1M2C-AF81　 JP1/Performance Management - Agent Option for Enterprise Applications　 08-50（適用OS：AIX 5.2，AIX 5.3）

これらの製品には，他社からライセンスを受けて開発した部分が含まれています。

適用OSについての注意
・P-9D2C-AA81，P-9D2C-AJ81，P-9D2C-AR81，P-9D2C-AF81をSolaris 9にインストールする場合，Solaris 9に次の前提パッチまたはこれらの後継パッチを適用してください。
111711-12 32-bit Shared library patch for C++
111712-12 64-bit Shared library patch for C++
112963-22 linker Patch
111703-03 /usr/ccs/bin/sccs and /usr/ccs/bin/make patch
117560-03 Microtasking libraries (libmtsk) patch
111722-04 Math Library (libm) patch
112785-43 Xsun patch
・P-9D2C-AA81，P-9D2C-AJ81，P-9D2C-AR81，P-9D2C-AF81をSolaris 10にインストールする場合，Solaris 10に次の前提パッチまたはこれらの後継パッチを適用してください。
119963-04 Shared library patch for C++
117461-04 ld Patch
120753-02 Microtasking libraries (libmtsk) patch

■ 輸出時の注意

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

■ 商標類

ABAPは，SAP AGのドイツ及びその他の国における登録商標または商標です。
AIXは，米国における米国International Business Machines Corp.の登録商標です。
DB2は，米国における米国International Business Machines Corp.の登録商標です。
DB2 Universal Databaseは，米国における米国International Business Machines Corp.の商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IBMは，米国における米国International Business Machines Corp.の登録商標です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Lotusは，IBM Corporationの登録商標です。
Lotus Dominoは，IBM Corporationの登録商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Exchange Serverは，米国Microsoft Corp.の商品名称です。
Microsoft Internet Information Serverは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
ODBCは，米国Microsoft Corp.が提唱するデータベースアクセス機構です。
OpenViewは，ヒューレット・パッカード社の商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
R/3は，SAP AGのドイツ及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
SAPは，SAP AGのドイツ及びその他の国における登録商標または商標です。
Solarisは，米国Sun Microsystems,Inc. の米国およびその他の国における商標または登録商標です。
UNIXは，X/Open Company Limitedが独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
その他製品名などの固有名詞は各社の商品名，商標および登録商標です。
プログラムプロダクト「P-9D2C-AA81，P-9D2C-AJ81，P-9D2C-AR81，P-9D2C-AF81」には，米国Sun Microsystems, Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-AA81，P-9D2C-AJ81，P-9D2C-AR81，P-9D2C-AF81」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。

■ 発行

2006年6月 (第1版) 3020-3-K66
2008年3月 (第3版) 3020-3-K66-40

■ 著作権

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

変更内容

変更内容(3020-3-K66-40)　JP1/Performance Management - Agent Option for Enterprise Applications　08-50

追加・変更内容 | 変更個所
SAP NetWeaver 7.0以降をベースとしたSAPシステムで拡張されたパスワードルール（拡張パスワード）に対応した。 | 2.1.4，2.4，3.1.4，3.4，5.4.3，6.4.3，10章，付録F.2，付録L
PFM - Agent for Enterprise Applicationsを使用したパフォーマンス監視の例について説明を追加した。 | 1.3
PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの設定について説明を追加した。 | 2.1.4，3.1.4，10章
セットアップを簡易化した。 | 2.1，3.1
ソリューションセットのアラームテーブルのバージョンを8.10から8.50に変更した。 | 8章，付録I
KAVF14257-Eメッセージを追加した。 | 11.2，11.4

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

はじめに

このマニュアルは，JP1/Performance Management - Agent Option for Enterprise Applicationsの機能や収集レコードなどについて説明したものです。

対象読者

このマニュアルは，次の方を対象としています。

JP1/Performance Management - Agent Option for Enterprise Applicationsの機能および収集レコードについて知りたい方

JP1/Performance Managementを使用したシステムを構築，運用して，SAPシステムのパフォーマンスデータを収集したい方

また，SAPシステムについて熟知していることを前提としています。

なお，JP1/Performance Managementを使用したシステムの構築，運用方法については，次のマニュアルもあわせてご使用ください。

JP1 Version 8 JP1/Performance Management システム構築・運用ガイド（3020-3-K61）

JP1 Version 8 JP1/Performance Management リファレンス（3020-3-K62）

マニュアルの構成

このマニュアルは，次に示す編から構成されています。なお，このマニュアルは，Windows 2000，Windows Server 2003，Windows Server 2003(IPF)，HP-UX(PA-RISC)，HP-UX(IPF)，Solaris，およびAIXの各OS（Operating System）に共通のマニュアルです。OSごとに差異がある場合は，本文中でそのつど内容を書き分けています。

第1編　概要編

JP1/Performance Management - Agent Option for Enterprise Applicationsの概要について説明しています。

第2編　運用・操作編

JP1/Performance Management - Agent Option for Enterprise Applicationsのインストール，セットアップ，クラスタシステムでの運用，システムログ情報の抽出，CCMSアラート情報の抽出，およびモニター情報の収集について説明しています。

第3編　リファレンス編

JP1/Performance Management - Agent Option for Enterprise Applicationsのソリューションセット，レコード，コマンドおよびメッセージについて説明しています。

第4編　トラブルシューティング編

JP1/Performance Management - Agent Option for Enterprise Applicationsでトラブルが発生したときの対処方法について説明しています。

関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

JP1/Performance Management関連

JP1 Version 8 JP1/Performance Management システム構築・運用ガイド（3020-3-K61）

JP1 Version 8 JP1/Performance Management リファレンス（3020-3-K62）

JP1関連

JP1 Version 8 JP1/Cm2/Network Node Manager ネットワーク管理ガイド（3020-3-L01）

JP1 Version 8 JP1/NETM/DM 運用ガイド1（Windows(R)用）（3020-3-L38）

JP1 Version 6 JP1/NETM/DM Manager（3000-3-841）

JP1 Version 8 JP1/NETM/DM SubManager（UNIX(R)用）（3020-3-L42）

JP1 Version 8 JP1/NETM/DM Client（UNIX(R)用）（3020-3-L43）

読書手順

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

マニュアルを読む目的 | 記述個所
JP1/Performance Management - Agent Option for Enterprise Applicationsの特長を知りたい。 | 1章
JP1/Performance Management - Agent Option for Enterprise Applicationsの機能概要を知りたい。 | 1章
JP1/Performance Management - Agent Option for Enterprise Applicationsの導入時の作業を知りたい。 | 2章，3章
JP1/Performance Management - Agent Option for Enterprise Applicationsのクラスタシステムでの運用を知りたい。 | 4章
JP1/Performance Management - Agent Option for Enterprise Applicationsのシステムログ情報の抽出方法について知りたい。 | 5章
JP1/Performance Management - Agent Option for Enterprise ApplicationsのComputer Center Management System（CCMS）アラート情報の抽出方法について知りたい。 | 6章
JP1/Performance Management - Agent Option for Enterprise Applicationsのモニター情報の収集について知りたい。 | 7章
JP1/Performance Management - Agent Option for Enterprise Applicationsのソリューションセットについて知りたい。 | 8章
JP1/Performance Management - Agent Option for Enterprise Applicationsのレコードについて知りたい。 | 9章
JP1/Performance Management - Agent Option for Enterprise Applicationsのコマンドについて知りたい。 | 10章
JP1/Performance Management - Agent Option for Enterprise Applicationsのメッセージについて知りたい。 | 11章
障害発生時の対処方法について知りたい。 | 12章

このマニュアルでの表記

このマニュアルでは，日立製品およびその他の製品の名称を省略して表記しています。製品の正式名称と，このマニュアルでの表記を次に示します。

正式名称 | このマニュアルでの表記
JP1/Performance Management | Performance Management
JP1/Performance Management - Agent Option for BEA WebLogic Server | PFM - Agent for WebLogic Server | PFM - Agent
JP1/Performance Management - Agent Option for Domino | PFM - Agent for Domino
JP1/Performance Management - Agent Option for HiRDB | PFM - Agent for HiRDB
JP1/Performance Management - Agent Option for IBM(R) DB2(R) Universal Database(TM) | PFM - Agent for DB2
JP1/Performance Management - Agent Option for Microsoft(R) Exchange Server | PFM - Agent for Exchange Server
JP1/Performance Management - Agent Option for Microsoft(R) Internet Information Server | PFM - Agent for IIS
JP1/Performance Management - Agent Option for Microsoft(R) SQL Server | PFM - Agent for Microsoft SQL Server
JP1/Performance Management - Agent Option for OpenTP1 | PFM - Agent for OpenTP1
JP1/Performance Management - Agent Option for Oracle | PFM - Agent for Oracle
JP1/Performance Management - Agent Option for Platform（UNIX用） | PFM - Agent for Platform（UNIX） | PFM - Agent for Platform
JP1/Performance Management - Agent Option for Platform（Windows用） | PFM - Agent for Platform（Windows）
JP1/Performance Management - Agent Option for Enterprise Applications | PFM - Agent for Enterprise Applications
JP1/Performance Management - Agent Option for JP1/AJS2 | PFM - Agent for JP1/AJS2
JP1/Performance Management - Agent Option for Service Response | PFM - Agent for Service Response
JP1/Performance Management - Agent Option for uCosminexus Application Server | PFM - Agent for Cosminexus
JP1/Performance Management - Base | PFM - Base
JP1/Performance Management - Manager | PFM - Manager
JP1/Performance Management - Web Console | PFM - Web Console
JP1/Cm2/Network Node Manager | JP1/Cm2/NNM | NNM
hp OpenView network node manager | HP OpenView NNM，またはhp OpenView NNM
JP1/Integrated Management - Manager | JP1/IM - Manager | JP1/IM
JP1/Integrated Management - View | JP1/IM - View
JP1/NETM/DM Client | JP1/NETM/DM
JP1/NETM/DM Manager
JP1/NETM/DM SubManager
AIX 5L V5.2 | AIX
AIX 5L V5.3
HP-UX 11i/11i V2(PA-RISC) | HP-UX(PA-RISC) | HP-UX
HP-UX 11i V2(Itanium Processor Family) | HP-UX(IPF)
Microsoft(R) Cluster Server | MSCS
Microsoft(R) Cluster
Microsoft(R) Internet Explorer (R) | Microsoft Internet Explorer
Microsoft(R) Windows(R) 2000 Advanced Server Operating System | Windows 2000
Microsoft(R) Windows(R) 2000 Server Operating System
Microsoft(R) Windows Server(R) 2003, Enterprise Edition | Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Standard Edition
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition
Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium-based Systems | Windows Server 2003(IPF)
Red Hat Enterprise Linux AS 4(x86) | Linux AS 4(x86) | Linux(x86) | Linux
Red Hat Enterprise Linux ES 4(x86) | Linux ES 4(x86)
Red Hat Enterprise Linux AS 4(AMD64 & Intel EM64T) | Linux AS 4(AMD64 & Intel EM64T) | Linux(x64)
Red Hat Enterprise Linux ES 4(AMD64 & Intel EM64T) | Linux ES 4(AMD64 & Intel EM64T)
Red Hat Enterprise Linux AS 4(IPF) | Linux AS 4(IPF) | Linux(IPF)
Red Hat Enterprise Linux 5 Advanced Platform(x86) | Linux 5 Advanced Platform(x86) | Linux(x86)
Red Hat Enterprise Linux 5(x86) | Linux 5(x86)
Red Hat Enterprise Linux 5 Advanced Platform(AMD64 & Intel EM64T) | Linux 5 Advanced Platform(AMD64 & EM64T) | Linux(x64)
Red Hat Enterprise Linux 5(AMD64 & Intel EM64T) | Linux 5(AMD64 & EM64T)
Red Hat Enterprise Linux 5 Advanced Platform(IPF) | Linux 5 Advanced Platform(IPF) | Linux(IPF)
Red Hat Enterprise Linux 5(IPF) | Linux 5(IPF)
SAP R/3(R) | SAP R/3
SAP R/3 Enterprise
SAP Business Information Warehouse | SAP BW
Solaris 9 | Solaris
Solaris 10

PFM - Manager，PFM - Agent，PFM - BaseおよびPFM - Web Consoleを総称して，Performance Managementと表記することがあります。

Windows 2000，Windows Server 2003，およびWindows Server 2003(IPF)を総称して，Windowsと表記することがあります。

HP-UX，Solaris，AIX，およびLinuxを総称して，UNIXと表記することがあります。

また，このマニュアルでは，次の用語を省略して表記しています。用語の正式名称と，このマニュアルでの表記を次に示します。

正式名称 | このマニュアルでの表記
Computer Center Management System | CCMS
Itanium (R) Processor Family | IPF
Monitoring Tree Element | MTE
Open Database Connectivity | ODBC
Remote Function Call | RFC

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

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

記　号
意　味

［ ］
ウィンドウ，タブ，ダイアログボックス，ダイアログボックスのボタン，ダイアログボックスのチェックボックスなどを示します。
（例）
［メイン］ウィンドウ
［エージェント］タブ

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

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

記号 | 意　味
＊ | 乗算記号を示します。
/ | 除算記号を示します。

図中で使用する記号

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

このマニュアルで使用するディレクトリ

このマニュアルでは，Windowsで使用されている「フォルダ」とUNIXで使用されている「ディレクトリ」とが同じ場合，原則として，「ディレクトリ」と統一表記しています。

Performance Managementインストール先フォルダ

このマニュアルでは，Windows版Performance Managementのインストール先フォルダを，インストール先フォルダと表記しています。

Windows版Performance Managementのデフォルトのインストール先フォルダは，次のとおりです。

PFM - Web Console以外のPerformance Managementのプログラムのインストール先フォルダ

Windows 2003(x64)以外の場合

　　　システムドライブ¥Program Files¥Hitachi¥jp1pc¥

Windows 2003(x64)の場合

　　　システムドライブ¥Program Files(x86)¥Hitachi¥jp1pc¥

PFM - Web Consoleのインストール先フォルダ

Windows 2003(x64)以外の場合

　　　システムドライブ¥Program Files¥Hitachi¥jp1pcWebCon¥

Windows 2003(x64)の場合

　　　システムドライブ¥Program Files(x86)¥Hitachi¥jp1pcWebCon¥

オンラインマニュアルについて

Performance Managementでは，PFM - Web Consoleがインストールされているホストに，プログラムプロダクトに標準添付されているマニュアルCD-ROMからマニュアルをコピーすることで，Webブラウザーでマニュアルを参照できるようになります。

マニュアルを参照するための設定

1.　PFM - Web Consoleのセットアップ手順に従い，PFM - Web ConsoleにPFM - Agentを登録する（PFM - Agentの追加セットアップを行う）。

2.　PFM - Web Consoleがインストールされているホストに，マニュアルのコピー先フォルダを作成する。

　Web Consoleのインストール先フォルダ¥doc¥ja¥××××

　××××には，PFM - AgentのヘルプIDを指定してください。

　ヘルプIDについては，このマニュアルの付録に記載されている識別子一覧を参照してください。

3.　上記で作成したフォルダの直下に，マニュアルCD-ROMからマニュアルファイル一式をコピーする。

　コピーの際，HTMLマニュアルの場合はindex.htmファイルが，PDFマニュアルの場合はPDFファイル自体が，作成したフォルダ直下に配置されるようにしてください。マニュアルファイルのコピー方法については，マニュアルCD-ROMのreadme.txtを参照してください。

4.　PFM - Web Consoleを再起動する。

マニュアルの参照方法

マニュアルの参照手順を次に示します。

1.　PFM - Web Consoleの［メイン］画面のメニューバーフレームにある［ヘルプ］メニューをクリックし，［ヘルプ選択画面］を表示する。

2.　マニュアル名またはマニュアル名の後ろの［PDF］をクリックする。

　マニュアル名をクリックするとHTML形式のマニュアルが表示されます。

　［PDF］をクリックするとPDF形式のマニュアルが表示されます。

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

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

宛先（あてさき）　個所（かしょ）　桁（けた）　汎用（はんよう）　必須（ひっす）

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

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

1.　PFM - Agent for Enterprise Applicationsの概要

この章では，PFM - Agent for Enterprise Applicationsの概要について説明します。

＜この章の構成＞

1.1　PFM - Agent for Enterprise Applicationsの特長

1.2　パフォーマンスデータの収集と管理の概要

1.3　PFM - Agent for Enterprise Applicationsを使用したパフォーマンス監視の例

1.1　PFM - Agent for Enterprise Applicationsの特長

PFM - Agent for Enterprise Applicationsは，SAPシステムのパフォーマンスを監視するために，パフォーマンスデータを収集および管理するプログラムです。

PFM - Agent for Enterprise Applicationsの特長を次に示します。

SAPシステムの稼働状況を分析できる
監視対象のSAPシステムから，応答時間やワークプロセス使用率の統計情報などのパフォーマンスデータをPFM - Agent for Enterprise Applicationsで収集および集計し，その傾向や推移を図示することで，SAPシステムの稼働状況の分析が容易にできます。

SAPシステムの運用上の問題点を早期に発見し，原因を調査する資料を提供できる
監視対象のSAPシステムで，応答時間が遅延するなどのパフォーマンスの低下が発生した場合，Eメールなどを使ってユーザーに通知することで，問題点を早期に発見できます。また，その問題点に関連する情報を図示することで，原因を調査する資料を提供できます。

PFM - Agent for Enterprise Applicationsを使用するには，PFM - ManagerおよびPFM - Web Consoleが必要です。

PFM - Agent for Enterprise Applicationsについて次に説明します。

＜この節の構成＞

1.1.1　SAPシステムのパフォーマンスデータを収集できます

1.1.2　パフォーマンスデータの性質に応じた方法で収集できます

1.1.3　パフォーマンスデータを保存できます

1.1.4　SAPシステムの運用上の問題点を通知できます

1.1.5　アラームおよびレポートが容易に定義できます

1.1.6　SAPシステムのシステムログ情報およびCCMSアラート情報を抽出できます

1.1.7　SAPシステムのモニター情報を収集できます

1.1.8　クラスタシステムで運用できます

1.1.1　SAPシステムのパフォーマンスデータを収集できます

PFM - Agent for Enterprise Applicationsを使用すると，対象ホスト上で動作しているSAPシステムのバックグラウンドサービスの統計情報などのパフォーマンスデータが収集できます。

PFM - Agent for Enterprise Applicationsでは，パフォーマンスデータは，次のように利用できます。

SAPシステムの稼働状況をグラフィカルに表示する
パフォーマンスデータは，PFM - Web Consoleを使用して，「レポート」と呼ばれるグラフィカルな形式に加工し，表示できます。レポートによって，SAPシステムの稼働状況がよりわかりやすく分析できるようになります。
レポートには，次の種類があります。

リアルタイムレポート
監視しているSAPシステムの現在の状況を示すレポートです。主に，システムの現在の状態や問題点を確認するために使用します。リアルタイムレポートの表示には，収集した時点のパフォーマンスデータが直接使用されます。

履歴レポート
監視しているSAPシステムの過去から現在までの状況を示すレポートです。主に，システムの傾向を分析するために使用します。履歴レポートの表示には，PFM - Agent for Enterprise Applicationsのデータベースに格納されたパフォーマンスデータが使用されます。

問題が起こったかどうかの判定条件として使用する
収集されたパフォーマンスデータの値が何らかの異常を示した場合，ユーザーに通知するなどの処置を取るように設定できます。

1.1.2　パフォーマンスデータの性質に応じた方法で収集できます

パフォーマンスデータは，「レコード」の形式で収集されます。各レコードは，「フィールド」と呼ばれるさらに細かい単位に分けられます。レコードおよびフィールドの総称を「データモデル」と呼びます。

レコードは，性質によって二つのレコードタイプに分けられます。どのレコードでどのパフォーマンスデータが収集されるかは，PFM - Agent for Enterprise Applicationsで定義されています。ユーザーは，PFM - Web Consoleを使用して，どのパフォーマンスデータのレコードを収集するか選択します。

PFM - Agent for Enterprise Applicationsのレコードタイプを次に示します。

Product Intervalレコードタイプ（以降，PIレコードタイプと省略します）
PIレコードタイプのレコードには，1分ごとのプロセス数など，ある一定の時間（インターバル）ごとのパフォーマンスデータが収集されます。PIレコードタイプは，時間の経過に伴うシステムの状態の変化や傾向を分析したい場合に使用します。

Product Detailレコードタイプ（以降，PDレコードタイプと省略します）
PDレコードタイプのレコードには，現在起動しているプロセスの詳細情報など，ある時点でのシステムの状態を示すパフォーマンスデータが収集されます。PDレコードタイプは，ある時点でのシステムの状態を知りたい場合に使用します。

各レコードについては，「9.　レコード」を参照してください。

1.1.3　パフォーマンスデータを保存できます

収集したパフォーマンスデータを，PFM - Agent for Enterprise Applicationsの「Storeデータベース」と呼ばれるデータベースに格納することで，現在までのパフォーマンスデータを保存し，SAPシステムの稼働状況について，過去から現在までの傾向を分析できます。傾向を分析するためには，履歴レポートを使用します。

ユーザーは，PFM - Web Consoleを使用して，どのパフォーマンスデータのレコードをStoreデータベースに格納するか選択します。PFM - Web Consoleでのレコードの選択方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

1.1.4　SAPシステムの運用上の問題点を通知できます

PFM - Agent for Enterprise Applicationsで収集したパフォーマンスデータは，SAPシステムのパフォーマンスをレポートとして表示するのに利用できるだけでなく，SAPシステムを運用していて問題が起こったり，障害が発生したりした場合にユーザーに警告することもできます。

例えば，1分ごとのダイアログタスクの応答時間が3,000ミリ秒を上回った場合，ユーザーにEメールで通知するとします。このように運用するために，「1分ごとのダイアログタスクの応答時間が3,000ミリ秒を上回る」を異常条件のしきい値として，そのしきい値に達した場合，Eメールをユーザーに送信するように設定します。しきい値に達した場合に取る動作を「アクション」と呼びます。アクションには，次の種類があります。

Eメールの送信

コマンドの実行

SNMPトラップの発行

JP1イベントの発行

しきい値やアクションを定義したものを「アラーム」と呼びます。一つ以上のアラームを一つのテーブルにまとめたものを「アラームテーブル」と呼びます。アラームテーブルを定義したあと，PFM - Agent for Enterprise Applicationsと関連づけます。アラームテーブルとPFM - Agent for Enterprise Applicationsとを関連づけることを「バインド」と呼びます。バインドすると，PFM - Agent for Enterprise Applicationsによって収集されているパフォーマンスデータが，アラームで定義したしきい値に達した場合，ユーザーに通知できるようになります。

このように，アラームおよびアクションを定義することによって，SAPシステムの運用上の問題を早期に発見し，対処できます。

アラームおよびアクションの設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，アラームによる稼働監視について説明している章を参照してください。

1.1.5　アラームおよびレポートが容易に定義できます

PFM - Agent for Enterprise Applicationsでは，「ソリューションセット」と呼ばれる，必要な情報があらかじめ定義されたレポートおよびアラームを提供しています。このソリューションセットを使用することで，複雑な定義をしなくてもSAPシステムの運用状況を監視する準備が容易にできるようになります。ソリューションセットは，ユーザーの環境に合わせてカスタマイズすることもできます。ソリューションセットの使用方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働分析のためのレポートの作成またはアラームによる稼働監視について説明している章を参照してください。また，ソリューションセットの詳細については，「8.　ソリューションセット」を参照してください。

1.1.6　SAPシステムのシステムログ情報およびCCMSアラート情報を抽出できます

PFM - Agent for Enterprise Applicationsでは，SAPシステムの次の情報を定期的にテキストファイルに出力できます。

システムログ情報
SAPシステムで発生したイベントおよび障害を記録するログ（システムログ）です。システムログは，アプリケーションサーバごとに記録されます。

CCMSアラート情報
SAPシステムのCCMS（Computer Center Management System）の警告モニター内で発生する警告（アラート情報）です。

テキストファイルに出力された情報は，JP1/Baseなどのログファイルトラップ機能を使用して，JP1イベントに変換できます。このJP1イベントをJP1/IMやNNMから監視することで，SAPシステムの稼働状況をJP1/IMやNNMから監視できるようになります。

SAPシステムのシステムログ情報の抽出については，「5.　システムログ情報の抽出」を参照してください。CCMSアラート情報の抽出については，「6.　CCMSアラート情報の抽出」を参照してください。

1.1.7　SAPシステムのモニター情報を収集できます

PFM - Agent for Enterprise Applicationsでは，SAPシステムのモニター情報を，ユーザーの定義に基づいて収集できます。これによって，PFM - Agent for Enterprise Applicationsにレコードとして用意されていないパフォーマンス情報の収集もできるようになります。なお，収集できるSAPシステムのモニター情報は，パフォーマンス属性を持つ情報に限られます。

SAPシステムのモニター情報の収集については，「7.　モニター情報の収集」を参照してください。

1.1.8　クラスタシステムで運用できます

クラスタシステムを使うと，システムに障害が発生した場合にも継続して業務を運用できる，信頼性の高いシステムが構築できます。このため，システムに障害が発生した場合でもPerformance Managementの24時間稼働および24時間監視ができます。

クラスタシステムで監視対象ホストに障害が発生した場合の運用例を次の図に示します。

図1-1　クラスタシステムの運用例

同じ設定の環境を二つ構築し，通常運用する方を「実行系ノード」，障害発生時に使う方を「待機系ノード」として定義しておきます。

クラスタシステムでのPerformance Managementの運用の詳細については，「4.　クラスタシステムでの運用」を参照してください。

1.2　パフォーマンスデータの収集と管理の概要

パフォーマンスデータの収集方法と管理方法は，パフォーマンスデータが格納されるレコードのレコードタイプによって異なります。PFM - Agent for Enterprise Applicationsのレコードは，次の二つのレコードタイプに分けられます。

PIレコードタイプ

PDレコードタイプ

パフォーマンスデータの収集方法と管理方法については，次の個所を参照してください。

パフォーマンスデータの収集方法
パフォーマンスデータの収集方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの機能について説明している章を参照してください。
収集されるパフォーマンスデータの値については，「9.　レコード」を参照してください。

パフォーマンスデータの管理方法
パフォーマンスデータの管理方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

PFM - Agentで収集および管理されているレコードのうち，どのパフォーマンスデータを利用するかは，PFM - Web Consoleで選択します。選択方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

1.3　PFM - Agent for Enterprise Applicationsを使用したパフォーマンス監視の例

パフォーマンス監視をすることは，SAPシステム環境の構築および管理において重要な作業です。ここでは，PFM - Agent for Enterprise Applicationsを使用したパフォーマンス監視の目的，およびパフォーマンス監視の例を紹介します。

＜この節の構成＞

1.3.1　パフォーマンス監視の目的

1.3.2　ベースラインの選定

1.3.3　パフォーマンス監視の例

1.3.1　パフォーマンス監視の目的

PFM - Agent for Enterprise Applicationsを使用したパフォーマンス監視は，SAPシステム構成の変更や調整に役立ちます。また，将来のシステムリソースのアップグレード計画にも有効な情報となります。

パフォーマンス監視は，主に次の目的で使うことができます。

SAPシステムでのパフォーマンスデータを分析し，ボトルネック原因を見つける

SAPシステムでのパフォーマンスデータの傾向を分析し，負荷特性と対応するシステムリソースへの影響を把握する

SAPシステムが正しく動作しているかを監視する

継続的にパフォーマンス監視することで，SAPシステム環境の負荷特性と対応するシステムリソースへの影響を把握できます。

SAPシステムを安定稼働させるには，正しくパフォーマンス監視を行うことが重要です。SAPシステムが安定稼働しているかは，次の監視をすることによって動作を確認できます。

SAPシステムの応答時間の監視

SAPバッファの監視

SAPメモリーの監視

システムログ情報の監視

CCMSアラート情報の監視

PFM - Agent for Enterprise Applicationsで検出された問題点などは，SAPが標準で提供している運用管理ツール「CCMS」による詳細な調査や分析を行うことの手助けとなります。

1.3.2　ベースラインの選定

ベースラインの選定とは，システム運用で問題なしと想定されるラインをパフォーマンス測定結果から選定する作業です。

JP1/PFM製品では，ベースラインの値を「しきい値」とすることで，システムの運用監視をします。このため，ベースラインの選定は，パフォーマンス監視をするにあたっての重要な作業となります。

なお，ベースラインの選定は，次のように実施することをお勧めします。

運用環境の高負荷テスト時など，ピーク時の状態を測定する

システム構成によって大きく異なるため，システムリソースの変更，および運用環境の変更を行う場合は，再度ベースラインを測定する

1.3.3　パフォーマンス監視の例

＜この項の構成＞

(1)　SAPシステムの応答時間

(2)　SAPバッファの監視

(3)　SAPメモリーの監視

(4)　SAPシステムログ，CCMSアラートの監視

(1)　SAPシステムの応答時間

SAPシステム全体のパフォーマンス傾向を確認するためにSAPシステムの応答時間を監視します。

(a)　応答時間に関連するレコードとフィールド

応答時間に関連するレコードとフィールドを次の表に示します。

表1-1　応答時間に関連するレコードとフィールド

使用レコード | 使用フィールド | 値の見方（例）
PIまたはPI_DIA | ResponseTime | ダイアログステップの処理時間の平均値。
DBRequestTime | 論理データベース要求を処理するための平均時間。
QueueTime | ディスパッチャー待ち行列での平均待ち時間。

(b)　監視方法

ダイアログの応答時間の監視

SAPシステムでのダイアログの応答時間は，ソリューションセットで提供している「Dialog ResponseTimeアラーム」を使用して監視できます。

ResponseTimeがしきい値以上の場合，SAPシステム全体のパフォーマンスが低下している可能性があります。SAPシステム全体の負荷状況やデータベース依頼時間を監視してボトルネックを確認します。

SAPシステム全体の負荷状況の監視

SAPシステム全体の負荷状況は，ソリューションセットで提供している「Dialog ResponseTimeレポート（フィールド名: QueueTime）」を使用して監視できます。

QueueTimeの値が高い（ResponseTimeの値の10%を超える）場合，SAPシステム全体での負荷が高くなっている可能性があります。

データベース依頼時間の監視

データベース依頼時間は，ソリューションセットで提供している「Dialog ResponseTime レポート（フィールド名: DBRequestTime）」を使用して監視できます。

DBRequestTimeの値が高い（ResponseTime - QueueTimeの値の40%を超える）場合，運用方法，アプリケーションサーバでのバッファ，SQL文(ABAP)の最適化，またはデータベースサーバに問題がある可能性があります。

(2)　SAPバッファの監視

効率的にSAPシステムが運用されていることを確認するために，SAPシステム固有のSAPバッファを監視します。

効率よくSAPバッファを使用することで，定型業務など実行する機会が多い業務の応答時間の短縮を図ることができます。

(a)　SAPバッファに関連するレコードとフィールド

SAPバッファに関連するレコードとフィールドを次の表に示します。

表1-2　SAPバッファに関連するレコードとフィールド

使用レコード | 使用フィールド | 値の見方（例）
PIまたはPI_BUFF | Program HitRatio % | プログラムがProgramバッファに存在するため，データベースにアクセスせずに済んだ問い合わせの割合（バッファのヒット率）。
CUA HitRatio % | メニュー情報がCUAバッファに存在するため，データベースにアクセスせずに済んだ問い合わせの割合（バッファのヒット率）。
GenericKey HitRatio % | テーブルのデータ(複数レコード)がGeneric Keyバッファに存在するため，データベースにアクセスせずに済んだ問い合わせの割合（バッファのヒット率）。
SingleRecord HitRatio % | テーブルのデータ（1レコード）がSingle recordバッファに存在するため，データベースにアクセスせずに済んだ問い合わせの割合（バッファのヒット率）。
PI_BUFF | Program Swap | Programバッファで発生した，1分ごとのバッファフルによるスワップ回数。値が0であることが望ましい。
CUA Swap | CUAバッファで発生した，1分ごとのバッファフルによるスワップ回数。値が0であることが望ましい。
GenericKey Swap | Generic keyバッファで発生した，1分ごとのバッファフルによるスワップ回数。値が0であることが望ましい。
SingleRecord Swap | Single recordバッファで発生した，1分ごとのバッファフルによるスワップ回数。値が0であることが望ましい。

(b)　監視方法

Programバッファの監視

Programバッファのヒット率およびスワップ回数を監視できます。

Programバッファのヒット率は，ソリューションセットで提供している「SAP Buffer Hitratioレポート（フィールド名: Program HitRatio %）」を使用して監視できます。この値が低い（80%未満）場合は，定型業務以外のユーザー依頼が増加している可能性があります。

Programバッファで発生したスワップ回数は，ソリューションセットで提供している「SAP Buffer Hitratioレポート（フィールド名: Program Swap）」を使用して監視できます。この値が0よりも大きい場合には，Programバッファのサイズが小さい可能性があります。

メニュー情報のバッファの監視

メニュー情報のバッファヒット率および，スワップ回数を監視できます。

メニュー情報のバッファヒット率は，ソリューションセットで提供している「SAP Buffer Hitratioレポート（フィールド名: CUA HitRatio %）」を使用して監視できます。この値が低い（80%未満）場合は，定型業務以外でのメニュー操作が増加している可能性があります。

メニュー情報のスワップ回数は，ソリューションセットで提供している「SAP Buffer Hitratioレポート（フィールド名: CUA Swap）」を使用して監視できます。この値が0よりも大きい場合には，CUAバッファのサイズが小さい可能性があります。

テーブルデータのバッファの監視

テーブルデータのバッファヒット率およびスワップ回数を監視できます。

テーブルデータのバッファヒット率は，ソリューションセットで提供している「SAP Buffer Hitratioレポート（フィールド名: GenericKey HitRatio %）」および「「SAP Buffer Hitratioレポート（フィールド名: SingleRecord HitRatio %）」を使用して監視できます。この値が低い（80%未満）場合は，Generic keyバッファおよびSingle recordバッファのサイズが小さいか，またはGeneric Keyバッファへのテーブル割り当て方法に問題がある可能性があります。

テーブルデータのバッファで発生したスワップ回数は，ソリューションセットで提供している「SAP Buffer Hitratioレポート(フィールド名GenericKey Swap)」および「SAP Buffer Hitratioレポート（フィールド名SingleRecord Swap）」を使用して監視できます。この値が0よりも大きい場合には，Generic keyバッファおよびSingle recordバッファのサイズが小さい可能性があります。

(3)　SAPメモリーの監視

SAPメモリーの領域不足によって発生する，SAPシステム全体でパフォーマンスの低下の傾向を確認するためにSAPシステム固有のSAPメモリーを監視します。

(a)　SAPメモリーに関連するレコードとフィールド

SAPメモリーに関連するレコードとフィールドを次の表に示します。

表1-3　SAPメモリーに関連するレコードとフィールド

使用レコード | 使用フィールド | 値の見方（例）
PIまたはPI_MEM | EsAct % | 現在の，拡張メモリーの使用率。
HeapAct % | 現在の，ヒープ領域の使用率。
PrivWpNo | PRIVモードになったワークプロセス数。
R3PagingUsed % | ページング領域の使用率。
R3RollUsed % | ロール領域の使用率。

(b)　監視方法

SAPメモリーの拡張メモリー使用率の監視

SAPメモリーの拡張メモリー使用率は，ソリューションセットで提供している「Extended Memoryアラーム」を使用して監視できます。

Extended Memoryが警告の場合，拡張メモリーの領域不足の可能性があります。

SAPメモリーのヒープ領域使用率の監視

SAPメモリーのヒープ領域使用率は，ソリューションセットで提供している「Heap Memoryアラーム」を使用して監視できます。

Heap Memoryが警告の場合，ヒープ領域の領域不足の可能性があります。または，ダイアログのワークプロセスがショートダンプを発生するおそれがあります。

SAPメモリーのページング領域使用率の監視

SAPメモリーのページング領域使用率は，ソリューションセットで提供している「Paging Areaアラーム」を使用して監視できます。

Paging Areaが警告の場合，ページング領域の領域不足の可能性があります。

SAPメモリーのロール領域使用率の監視

SAPメモリーのロール領域使用率は，ソリューションセットで提供している「Roll Areaアラーム」を使用して監視できます。

Roll Areaが警告の場合，ロール領域の領域不足の可能性があります。または，ダイアログのワークプロセスが「PRIV」モードとなるおそれがあります。

「PRIV」モードになっているワークプロセス数は，ソリューションセットで提供している「SAP Memory Detailドリルダウンレポート（フィールド名: PrivWpNo）」を使用して確認できます。この値が1以上の場合，ディスパッチャーでの待ち時間が増加している可能性があります。

(4)　SAPシステムログ，CCMSアラートの監視

SAPシステムは，発生したイベントおよび障害情報をシステムログに出力しています。

また，システムの運用管理や負荷分析をするCCMS（Computer Center Management System）が備わっています。

PFM - Agent for Enterprise Applicationsでは，システムログやCCMSの警告モニター内で発生した警告（アラート情報）を定期的にテキストファイルに出力できます。

テキストファイルに出力された情報は，ほかのプログラム（JP1/Baseのログトラップ機能など）と連携することでSAPシステムの状態の監視に利用できます。

(a)　監視方法

システムログの監視

システムログ情報抽出機能を使用すると，SAPシステムで発生したイベントおよび障害を記録するシステムログ情報を定期的にテキストファイルに出力できます。

出力される内容を次に示します。

メッセージ記録時刻

メッセージを記録したサーバ

メッセージを記録したユーザー

メッセージを記録したプログラム

メッセージ番号

メッセージ

詳細は，「5.　システムログ情報の抽出」を参照してください。

CCMSアラート情報の監視

CCMSアラート情報抽出機能を使用すると，CCMSの警告モニター内で発生する警告（アラート情報）を定期的にテキストファイルに出力できます。

出力される内容を次に示します。

アラートID

アラートに関連づけられているMTEのID

アラートの重要度

一般プロパティ

メッセージ

詳細は，「6.　CCMSアラート情報の抽出」を参照してください。

2.　インストールとセットアップ（Windowsの場合）

この章では，PFM - Agent for Enterprise Applicationsのインストールおよびセットアップ方法について説明します。

＜この章の構成＞

2.1　インストールとセットアップ

2.2　アンインストールとアンセットアップ

2.3　PFM - Agent for Enterprise Applicationsのシステム構成の変更

2.4　PFM - Agent for Enterprise Applicationsの運用方式の変更

2.1　インストールとセットアップ

ここでは，PFM - Agent for Enterprise Applicationsをインストールおよびセットアップする手順を示します。

＜この節の構成＞

2.1.1　インストールとセットアップの前に

2.1.2　インストールとセットアップの流れ

2.1.3　インストール手順

2.1.4　PFM - Agent for Enterprise Applicationsのセットアップ手順

2.1.1　インストールとセットアップの前に

PFM - Agent for Enterprise Applicationsをインストールおよびセットアップする前に確認しておくことを説明します。

＜この項の構成＞

(1)　前提OS

(2)　ネットワークの環境設定

(3)　インストールに必要なOSユーザー権限について

(4)　前提プログラム

(5)　クラスタシステムでのインストールとセットアップについて

(6)　注意事項

(1)　前提OS

PFM - Agent for Enterprise Applicationsが動作するOSを次に示します。

Windows 2000

Windows Server 2003

Windows Server 2003(IPF)

(2)　ネットワークの環境設定

Performance Managementが動作するためのネットワーク環境について説明します。

(a)　IPアドレスの設定

PFM - Agentのホストは，ホスト名でIPアドレスが解決できる環境を設定してください。

IPアドレスが解決できない環境では，PFM - Agentは起動できません。

Windowsシステムでは，hostnameコマンドの実行結果で確認できるホスト名でIPアドレスが解決できるように環境設定をしてください。

ホスト名と，IPアドレスの設定は，次の方法のどれかで行ってください。

Performance Managementのホスト情報設定ファイル（jpchostsファイル）

hostsファイル

DNS（Domain Name System）

注意

Performance Managementは，DNS環境でも運用できますが，FQDN（Fully Qualified Domain Name）形式のホスト名には対応していません。Windowsの場合はhostnameコマンドで確認できるホスト名には，ドメイン名を除いたものを使用してください。

複数のLAN環境で使用する場合は，jpchostsファイルでIPアドレスを設定してください。詳細は，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(b)　ポート番号の設定

Performance Managementプログラムのサービスは，デフォルトで次の表に示すポート番号が割り当てられています。これ以外のサービスまたはプログラムに対しては，サービスを起動するたびに，そのときシステムで使用されていないポート番号が自動的に割り当てられます。また，ファイアウォール環境で，Performance Managementを使用するときは，ポート番号を固定してください。ポート番号の固定の手順は，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップについて説明している章を参照してください。

表2-1　デフォルトのポート番号とPerformance Managementプログラムのサービス（Windowsの場合）

サービス説明
サービス名
パラメーター
ポート番号
備考

サービス構成情報管理機能
Name Server
jp1pcnsvr
22285
PFM - ManagerのName Serverサービスで使用されるポート番号。
Performance Managementのすべてのホストで設定される。

NNM連携機能
NNM Object Manager
jp1pcovsvr
22292
PFM - ManagerおよびPFM - BaseのNNM連携機能で，マップマネージャとオブジェクトマネージャの間の通信で使用されるポート番号。
PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。

サービス状態管理機能
Status Server
jp1pcstatsvr
22350
PFM - ManagerおよびPFM - BaseのStatus Serverサービスで使用されるポート番号。
PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。

これらのPFM - Agentが使用するポート番号で通信できるように，ネットワークを設定してください。

(3)　インストールに必要なOSユーザー権限について

PFM - Agent for Enterprise Applicationsをインストールするときは，必ず，Administrators権限を持つアカウントで実行してください。

(4)　前提プログラム

ここでは，PFM - Agent for Enterprise Applicationsをインストールする場合に必要な前提プログラムを説明します。プログラムの構成図を次に示します。

図2-1　プログラムの構成図

(a)　監視対象プログラム

PFM - Agent for Enterprise Applicationsの監視対象プログラムを次に示します。

SAP R/3 Enterprise

SAP Business Information Warehouse

mySAP ERP

これらの監視対象プログラムは，PFM - Agent for Enterprise Applicationsと同一ホストにインストールする必要があります。

(b)　Performance Managementプログラム

監視エージェントには，PFM - AgentとPFM - Baseをインストールします。PFM - BaseはPFM - Agentの前提プログラムです。同一ホストに複数のPFM - Agentをインストールする場合でも，PFM - Baseは一つだけでかまいません。ただし，PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。

また，PFM - Agent for Enterprise Applicationsを使ってSAP R/3の稼働監視を行うためには，PFM - ManagerおよびPFM - Web Consoleが必要です。

(5)　クラスタシステムでのインストールとセットアップについて

クラスタシステムでのインストールとセットアップは，前提となるネットワーク環境やプログラム構成が，通常の構成のセットアップとは異なります。また，実行系ノードと待機系ノードでの作業が必要になります。詳細については，「4.　クラスタシステムでの運用」を参照してください。

(6)　注意事項

ここでは，Performance Managementをインスールおよびセットアップするときの注意事項を説明します。

(a)　同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項

Performance Managementは，同一ホストにPFM - Manager，PFM - Web Console，およびPFM - Agentをインストールすることもできます。その場合の注意事項を次に示します。

ポイント

システムの性能や信頼性を向上させるため，PFM - Manager，PFM - Web Console，およびPFM - Agentはそれぞれ別のホストで運用することをお勧めします。

PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。この場合，PFM - Agentの前提プログラムはPFM - Managerになるため，PFM - Managerをインストールしてから PFM - Agentをインストールしてください。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager → PFM - Agentの順でインストールしてください。また，PFM - Manager とPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base → PFM - Agentの順でインストールしてください。

PFM - ManagerがインストールされているホストにPFM - Agentをインストールすると，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，接続先PFM - ManagerをリモートホストのPFM - Managerに変更できません。リモートホストのPFM - Managerに接続したい場合は，インストールするホストにPFM - Managerがインストールされていないことを確認してください。

PFM - AgentがインストールされているホストにPFM - Managerをインストールすると，PFM - Agentの接続先PFM - Managerは自ホスト名に設定し直されます。共通メッセージログに設定結果が出力されています。結果を確認してください。

PFM - Web Consoleがインストールされているホストに，PFM - Agentをインストールする場合は，ブラウザーの画面をすべて閉じてからインストールを実施してください。

Performance Managementプログラムを新規にインストールした場合は，ステータス管理機能がデフォルトで有効になります。ただし，07-50から08-00以降にバージョンアップインストールした場合は，ステータス管理機能の設定状態はバージョンアップ前のままとなります。ステータス管理機能の設定を変更する場合は，マニュアル「JP1/Performance Management システム構築・運用ガイド」のPerformance Managementの障害検知について説明している章を参照してください。

(b)　バージョンアップの注意事項

古いバージョンのPFM - Agentからバージョンアップする場合の注意事項を次に示します。

なお，07-00以降からのバージョンアップについての詳細は，「付録H　移行手順と移行時の注意事項」を参照してください。

Performance Managementのプログラムをインストールするときは，ローカルホストのPerformance Managementのプログラムおよびサービスをすべて停止しておいてください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

すでにPerformance ManagementプログラムがインストールされているホストにPFM - Agentをインストールする場合，PFM - Agentのインストールパスは，すでにインストールされているPFM - Web Console以外のPerformance Managementプログラムのインストールパスと同じになります。インストールパスを変更したい場合は，インストール済みのPFM - Web Console以外のPerformance Managementプログラムをすべて削除し，インストールし直す必要があります。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager，PFM - Agentの順でインストールしてください。また，PFM - ManagerとPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base，PFM - Agentの順でインストールしてください。

バージョン08-00以降のPerformance Managementプログラムでは，Store実行プログラム（jpcsto.exeおよびstpqlpr.exe）の配置先が変更されています。PFM - Agentを08-00以降にバージョンアップする際に，旧配置先のStore実行モジュールは削除されます。

(c)　その他の注意事項

Performance Managementのプログラムが一つもインストールされていない環境に新規インストールする場合は，インストール先フォルダにファイルやフォルダがないことを確認してください。

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアなど）を起動したままインストールした場合，システムの再起動を促すメッセージが表示されることがあります。この場合は，メッセージに従ってシステムを再起動し，インストールを完了させてください。

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアなど）を起動したままの状態，ディスク容量が不足している状態，またはディレクトリ権限がない状態でインストールした場合，ファイルの展開に失敗することがあります。Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラムが起動している場合はすべて停止してからインストールし直してください。ディスク容量不足やディレクトリ権限不足が問題である場合は，問題を解決したあとでインストールし直してください。

2.1.2　インストールとセットアップの流れ

PFM - Agent for Enterprise Applicationsをインストールおよびセットアップする流れを説明します。

図2-2　インストールとセットアップの流れ

PFM - ManagerおよびPFM - Web Consoleのインストールおよびセットアップの手順は，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

2.1.3　インストール手順

ここでは，PFM - Agent for Enterprise Applicationsのプログラムをインストールする順序とCD-ROMの提供媒体からプログラムをインストールする手順を説明します。

＜この項の構成＞

(1)　プログラムのインストール順序

(2)　プログラムのインストール方法

(1)　プログラムのインストール順序

まず，PFM - Baseをインストールし，次にPFM - Agentをインストールします。PFM - BaseがインストールされていないホストにPFM - Agentをインストールすることはできません。

なお，PFM - Managerと同一ホストにPFM - Agentをインストールする場合は，PFM - Manager → PFM - Agentの順でインストールしてください。また，Storeデータベースのバージョン1.0からバージョン2.0にバージョンアップする場合，PFM - AgentとPFM - ManagerまたはPFM - Baseのインストール順序によって，セットアップ方法が異なります。Storeバージョン2.0のセットアップ方法については，「2.4.2　Storeバージョン2.0への移行」を参照してください。

同一ホストに複数のPFM - Agentをインストールする場合，PFM - Agent相互のインストール順序は問いません。

(2)　プログラムのインストール方法

WindowsホストにPerformance Managementプログラムをインストールするには，CD-ROMの提供媒体を使用する方法と，JP1/NETM/DMを使用してリモートインストールする方法があります。JP1/NETM/DMを使用する方法については，マニュアル「JP1/NETM/DM　運用ガイド1（Windows(R)用）」を参照してください。

注意

インストールを行うホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。サービスの停止方法は，マニュアル「JP1/Performance Management　システム構築・運用ガイド」の，サービスの起動と停止について説明している章を参照してください。

CD-ROMの提供媒体を使用する場合のインストール手順を次に示します。

Performance Managementプログラムをインストールするホストに，Administrators権限でログインする。

Performance Managementのプログラムおよびサービスを停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

提供媒体をCD-ROMドライブに入れる。
起動したインストーラーの指示に従ってインストールを進めます。
インストール時に定義する情報を次に示します。

ユーザー情報
ユーザー名などを入力します。

インストール先フォルダ
Performance Managementプログラムをインストールするフォルダを指定します。
インストール先フォルダは，［ディレクトリの選択］ダイアログボックスで設定して［OK］ボタンをクリックした時点で作成されます。誤ったフォルダを作成した場合はインストール後にフォルダを削除してください。

プログラムフォルダ
Windows 2000の場合，Windowsの［スタート］－［プログラム］メニューに登録されるプログラムメニュー名を指定します。
Windows Server 2003，Windows Server 2003(IPF)の場合，Windowsの［スタート］－［すべてのプログラム］メニューに登録されるプログラムメニュー名を指定します。

参考

PFM - Web Consoleを除くPerformance Managementプログラムのインストール先フォルダおよびプログラムフォルダは，そのホストに初めてPerformance Managementプログラムがインストールされるときだけ指定できます。2回目以降のインストールでは，初回のインストール時に指定したフォルダにインストールまたは登録されます。

2.1.4　PFM - Agent for Enterprise Applicationsのセットアップ手順

ここでは，PFM - Agent for Enterprise Applicationsを運用するための，セットアップについて説明します。

[図データ]は使用する環境によって必要になるセットアップ項目，またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。

＜この項の構成＞

(1)　PFM - Agent for Enterprise Applicationsの登録

(2)　PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの作成

(3)　インスタンス環境の設定

(4)　ネットワークの設定

(5)　ログのファイルサイズ変更

(6)　パフォーマンスデータの格納先の変更

(7)　PFM - Agent for Enterprise Applicationsの接続先PFM - Managerの設定

(8)　動作ログ出力の設定

(1)　PFM - Agent for Enterprise Applicationsの登録

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために，PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for Enterprise Applicationsを登録する必要があります。

PFM - Managerのバージョンが08-50以降の場合，PFM - Agentの登録は自動で行われるため，ここで説明する手順は不要です。ただし，PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお，PFM - Agent for Enterprise Applicationsのデータモデルのバージョンについては，「付録I　バージョン互換」を参照してください。

PFM - Agentの登録の流れを次に示します。

図2-3　PFM - Agentの登録の流れ

注意

PFM - Agentの登録は，インスタンス環境を設定する前に実施してください。

すでにPFM - Agent for Enterprise Applicationsの情報が登録されているPerformance Managementシステムに，新たに同じバージョンのPFM - Agent for Enterprise Applicationsを追加した場合，PFM - Agentの登録は必要ありません。

バージョンが異なるPFM - Agent for Enterprise Applicationsを，異なるホストにインストールする場合，古いバージョン，新しいバージョンの順でセットアップしてください。

PFM - Managerと同じホストにPFM - Agentをインストールした場合，jpcagtsetupコマンドが自動的に実行されます。共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されるので，結果を確認してください。コマンドが正しく実行されていない場合は，コマンドを実行し直してください。コマンドの実行方法については，マニュアル「JP1/Performance Management　リファレンス」のコマンドの章を参照してください。

(a)　PFM - Agent for Enterprise Applicationsのセットアップファイルをコピーする

PFM - Agent for Enterprise ApplicationsをインストールしたホストにあるセットアップファイルをPFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。

PFM - Web Consoleが起動されている場合は，停止する。

PFM - Agentのセットアップファイルをバイナリーモードでコピーする。
ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。

表2-2　コピーするセットアップファイル

PFM - Agentの
セットアップファイル
コピー先

PFM
プログラム名
OS
コピー先フォルダ
またはディレクトリ

インストール先フォルダ¥setup¥jpcagtmw.EXE
PFM - Manager
Windows
PFM - Managerのインストール先フォルダ¥setup

インストール先フォルダ¥setup¥jpcagtmu.Z
UNIX
/opt/jp1pc/setup/

インストール先フォルダ¥setup¥jpcagtmw.EXE
PFM - Web Console
Windows
PFM - Web Consoleのインストール先フォルダ¥setup

インストール先フォルダ¥setup¥jpcagtmu.Z
UNIX
/opt/jp1pcwebcon/setup/

(b)　PFM - Managerホストでセットアップコマンドを実行する

PFM - ManagerでPFM - Agent for Enterprise Applicationsをセットアップするための次のコマンドを実行します。

jpcagtsetup agtm

注意

コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcagtsetupコマンドを実行した場合，エラーが発生することがあります。その場合は，Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと，再度jpcagtsetupコマンドを実行してください。

PFM - ManagerホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと，削除してもかまいません。

(c)　PFM - Web Consoleホストでセットアップコマンドを実行する

PFM - Web ConsoleでPFM - Agent for Enterprise Applicationsをセットアップするための次のコマンドを実行します。

jpcwagtsetup

PFM - Web ConsoleホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと削除してもかまいません。

(2)　PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの作成

PFM - Agent for Enterprise Applicationsはパフォーマンス情報を収集するために，SAP社の通信プロトコルであるRFCを使用して，SAPシステム側に定義されている外部管理インターフェースを実行します。そのため，PFM - Agent for Enterprise Applicationsが使用するユーザーをあらかじめSAPシステム側に用意しておく必要があります。

ここでは，SAPシステム側に作成するSAPユーザーのユーザータイプ，パスワード，権限について説明します。

(a)　ユーザータイプ

PFM - Agent for Enterprise Applicationsで使用するSAPユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

(b)　パスワードに指定できる文字

SAPユーザーのパスワードは，半角数字(0～9)，半角英字(a～z, A～Z)，および次の半角記号で定義してください。

　!"@△$%&/()=?'`*+~#-_.,;:{[]}¥<>|

　△は，空白文字を示します。

(c)　必要な権限

ユーザーには次の権限（権限オブジェクト）を設定する必要があります。

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

外部管理インターフェースを使用するための権限（S_XMI_PROD）

各権限の値として，次の表に示す値またはすべての項目に「*」を指定したビルトイン権限値（S_RFC_ALLやS_XMI_ADMIN）を割り当ててください。

表2-3　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目 | 説明 | 値
RFC_TYPE | 保護されるRFCオブジェクトのタイプ | FUGR（汎用グループ）
RFC_NAME | 保護されるRFC名 | *
ACTVT | アクティビティ | 16（実行）

表2-4　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目 | 説明 | 値
EXTCOMPANY | 外部管理ツールの会社名 | HITACHI
EXTPRODUCT | 外部管理ツールのプログラム名 | JP1
INTERFACE | インターフェースID | *

(3)　インスタンス環境の設定

PFM - Agent for Enterprise Applicationsで監視するSAPシステムのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に，次の情報をあらかじめ確認してください。SAPシステムのインスタンス情報の詳細については，SAP R/3のマニュアルを参照してください。

表2-5　PFM - Agent for Enterprise Applicationsのインスタンス情報

項目
説明
設定できる値
デフォルト値

SID
監視対象となるSAPシステムID
8バイト以内の半角文字列
－

SERVER
監視対象となるSAPインスタンス名（トランザクションコードSM51で確認できる，ダイアログサービスを持つSAPインスタンス名）
20バイト以内の半角文字列
jpcinssetupコマンドの-instで指定したインスタンス名

ASHOST
接続先アプリケーションサーバのホスト名（トランザクションコードSM51で確認できるSAPローカルホスト名）
100バイト以内の半角文字列
ローカルホスト名

SYSNR
SAPシステムのシステム番号を指定する。
2バイト以内の半角数字
「00」

CLIENT
SAPユーザーが属するクライアント名（接続先ダイアログインスタンスに割り当てられているシステム番号）
3バイト以内の半角数字
「000」

USER
SAPユーザー名
12バイト以内の半角文字列
－

EXTPWD
SAPシステムへの接続に，拡張パスワードを使用するかどうかを指定する。
YまたはNで指定する。

Y：拡張パスワードを使用する。

N：拡張パスワードを使用しない。

「N」

PASSWD
SAPユーザーのパスワード

拡張パスワードを使用する場合：8バイト以内の半角文字列

拡張パスワードを使用しない場合：40バイト以内の半角文字列

－

DELAYCONNECT
SAPシステムにいつ接続するかを指定する。
YまたはNで指定する。

Y：パフォーマンスデータ収集時にSAPシステムに接続する。
この場合，Agent Collectorサービスは，接続時のSAPシステムの稼働状況に関係なく起動される。

N：Agent Collectorサービス起動時にSAPシステムに接続する。
この場合，Agent Collectorサービスは，接続時にSAPシステムが停止していると起動されない。

「N」

Store Version※
使用するStore バージョンを指定する。Storeバージョンについては「2.4.2　Store バージョン2.0への移行」を参照してください。
{1.0 | 2.0}
2.0

(凡例)

－：なし

注※

PFM - Agent for Enterprise Applications，および同一ホスト上のPFM - BaseまたはPFM - Managerが08-10以降で，初めてインスタンス環境の設定を行う場合に必要となる設定です。

注意

インスタンス環境を設定していない場合，PFM - Agent for Enterprise Applicationsのサービスを起動できません。

インスタンス環境を構築するには，jpcinssetupコマンドを使用します。インスタンス環境の構築手順を次に示します。

サービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
例えば，PFM - Agent for Enterprise Applicationsのインスタンス名o246bci_SD5_00のインスタンス環境を構築する場合，次のように指定してコマンドを実行します。

jpcinssetup agtm -inst o246bci_SD5_00

PFM - Agent for Enterprise Applicationsの場合，インスタンス名は任意ですが，管理のしやすさを考慮し，監視対象とするSAPシステムのインスタンス名と同じにしてください。SAPシステムのインスタンスには，通常，「ホスト名_SAPシステムID_システム番号」という形式の名称が付けられています。

SAPシステムのインスタンス情報を設定する。
表2-5に示した項目を，コマンドの指示に従って入力してください。各項目とも省略はできません。デフォルトで表示されている値を，項目の入力とする場合はリターンキーだけを押してください。

すべての入力が終了すると，インスタンス環境が構築されます。構築されるインスタンス環境を次に示します。

インスタンス環境のフォルダ構成
次のフォルダ下にインスタンス環境が構築されます。

物理ホスト運用の場合：インストール先フォルダ¥agtm

論理ホスト運用の場合：環境ディレクトリ※¥jp1pc¥agtm

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

構築されるインスタンス環境のフォルダ構成を次に示します。

表2-6　インスタンス環境のフォルダ構成

フォルダ名・ファイル名 | 説明
agent | インスタンス名 | jpcagt.ini | Agent Collectorサービス起動情報ファイル
jpcagt.ini.model※ | Agent Collectorサービス起動情報ファイルのモデルファイル
jr3alget.ini | CCMS Alert Monitor Command（PD_ALMX）レコード用の環境パラメーター設定ファイル
jr3slget.ini | System Log Monitor Command（PD_SLMX）レコード用の環境パラメーター設定ファイル
log | ログファイル格納フォルダ
store | インスタンス名 | jpcsto.ini | Agent Storeサービス起動情報ファイル
jpcsto.ini.model※ | Agent Storeサービス起動情報ファイルのモデルファイル
*.DAT | データモデル定義ファイル
dump | エクスポート先フォルダ
backup | バックアップ先フォルダ
import | インポート先フォルダ（Storeバージョン2.0の場合）
log | ログファイル格納フォルダ
partial | 部分バックアップ先フォルダ（Storeバージョン2.0の場合）
STPD | PDレコードタイプのパフォーマンスデータ格納フォルダ（Storeバージョン2.0の場合）
STPI | PIレコードタイプのパフォーマンスデータ格納フォルダ（Storeバージョン2.0の場合）
STPL | PLレコードタイプのパフォーマンスデータ格納フォルダ（Storeバージョン2.0の場合）

注※

インスタンス環境を構築した時点の設定値に戻したいときに使用します。

インスタンス環境のサービスID
インスタンス環境のサービスIDは，プロダクトID，機能ID，インスタンス番号，インスタンス名，ホスト名をつないだ文字列になります。例えばサービスID「MA1o246bci_SD5_00[host01]」は，次のインスタンス環境を表します。

プロダクトID：M

機能ID：A

インスタンス番号：1

インスタンス名：o246bci_SD5_00

ホスト名：host1

サービスIDについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録を参照してください。

インスタンス環境のWindowsのサービス名
インスタンス環境のWindowsのサービス名は次のようになります。

Agent Collectorサービス：PFM - Agent for R/3 インスタンス名

論理ホスト運用の場合のAgent Collectorサービス：PFM - Agent for R/3 インスタンス名 [論理ホスト名]

Agent Storeサービス：PFM - Agent Store for R/3 インスタンス名

論理ホスト運用の場合のAgent Storeサービス：PFM - Agent Store for R/3 インスタンス名 [論理ホスト名]

Windowsのサービス名については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録を参照してください。

(4)　ネットワークの設定[図データ]

Performance Managementを使用するネットワーク構成に応じて，変更する場合にだけ必要な設定です。

ネットワークの設定では次の二つの項目を設定できます。

IPアドレスを設定する
Performance Managementを複数のLANに接続されたネットワークで使用するときに設定します。複数のIPアドレスを設定するには，jpchostsファイルにホスト名とIPアドレスを定義します。設定したjpchostsファイルはPerformance Managementシステム全体で統一させてください。
詳細についてはマニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

ポート番号を設定する
Performance Managementが使用するポート番号を設定できます。運用での混乱を避けるため，ポート番号とサービス名は，Performance Managementシステム全体で統一させてください。
ポート番号の設定の詳細についてはマニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(5)　ログのファイルサイズ変更[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは，デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合にだけ，必要な設定です。

詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(6)　パフォーマンスデータの格納先の変更[図データ]

PFM - Agent for Enterprise Applicationsで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先，エクスポート先，部分バックアップ先またはインポート先のフォルダを変更したい場合にだけ，必要な設定です。

パフォーマンスデータは，デフォルトで，次の場所に保存されます。

保存先 | フォルダ名
データベースの保存先 | インストール先フォルダ¥agtm¥store¥インスタンス名¥
データベースの保存先（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥store¥インスタンス名¥
バックアップ先 | インストール先フォルダ¥agtm¥store¥インスタンス名¥backup¥
バックアップ先（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥store¥インスタンス名¥backup¥
エクスポート先 | インストール先フォルダ¥agtm¥store¥インスタンス名¥dump¥
エクスポート先（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥store¥インスタンス名¥dump¥
部分バックアップ先（Storeバージョン2.0の場合） | インストール先フォルダ¥agtm¥store¥インスタンス名¥partial¥
部分バックアップ先（論理ホスト運用で，Storeバージョン2.0の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥store¥インスタンス名¥partial¥
インポート先（Storeバージョン2.0の場合） | インストール先フォルダ¥agtm¥store¥インスタンス名¥import¥
インポート先（論理ホスト運用で，Storeバージョン2.0の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥store¥インスタンス名¥import¥

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

詳細については，「2.4.1　パフォーマンスデータの格納先の変更」を参照してください。

(7)　PFM - Agent for Enterprise Applicationsの接続先PFM - Managerの設定

PFM - Agentがインストールされているホストで，そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには，jpcnshostnameコマンドを使用します。

注意

同一ホスト上に，複数のPFM - Agentがインストールされている場合でも，接続先に指定できるPFM - Managerは，一つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。

PFM - AgentとPFM - Managerが同じホストにインストールされている場合，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，接続先のPFM - ManagerをほかのPFM - Managerに変更できません。

手順を次に示します。

Performance Managementのプログラムおよびサービスを停止する。
セットアップを実施する前に，ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，サービスの起動と停止について説明している章を参照してください。
jpcnshostnameコマンド実行時に，Performance Managementのプログラムおよびサービスが起動されている場合は，停止を問い合わせるメッセージが表示されます。

接続先のPFM - Managerホストのホスト名を指定して，jpcnshostnameコマンドを実行する。
例えば，接続先のPFM - Managerがホストhost01上にある場合，次のように指定します。

jpcnshostname -s host01

(8)　動作ログ出力の設定[図データ]

PFMサービスの起動・停止時や，PFM - Managerとの接続状態の変更時に動作ログを出力したい場合に必要な設定です。動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能などと連動した動作情報の履歴を出力するログ情報です。

設定方法については，「付録J　動作ログの出力」を参照してください。

2.2　アンインストールとアンセットアップ

ここでは，PFM - Agent for Enterprise Applicationsをアンインストールおよびアンセットアップする手順を示します。

＜この節の構成＞

2.2.1　アンインストールとアンセットアップの前に

2.2.2　アンセットアップ手順

2.2.3　アンインストール手順

2.2.1　アンインストールとアンセットアップの前に

ここでは，PFM - Agent for Enterprise Applicationsをアンインストールおよびアンセットアップするときの注意事項を次に示します。

＜この項の構成＞

(1)　アンインストールに必要なOSユーザー権限に関する注意事項

(2)　ネットワークに関する注意事項

(3)　プログラムに関する注意事項

(4)　サービスに関する注意

(5)　その他の注意事項

(1)　アンインストールに必要なOSユーザー権限に関する注意事項

PFM - Agentをアンインストールするときは，必ず，Administrators権限を持つアカウントで実行してください。

(2)　ネットワークに関する注意事項

Performance Managementプログラムをアンインストールしても，servicesファイルに定義されたポート番号は削除されません。

(3)　プログラムに関する注意事項

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアなど）を起動したままアンインストールした場合，ファイルやフォルダが残ることがあります。この場合は，手動でインストール先フォルダ以下をすべて削除してください。

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアなど）を起動したままアンインストールした場合，システムの再起動を促すメッセージが出力されることがあります。この場合，システムを再起動して，アンインストールを完了させてください。

PFM - BaseとPFM - Agentがインストールされているホストの場合，PFM - BaseのアンインストールはPFM - Agentをアンインストールしないと実行できません。この場合，PFM - Agent → PFM - Baseの順にアンインストールしてください。また，PFM - ManagerとPFM - Agentがインストールされているホストの場合も同様に，PFM - ManagerのアンインストールはPFM - Agentをアンインストールしないと実行できません。この場合，PFM - Agent → PFM - Managerの順にアンインストールしてください。

(4)　サービスに関する注意

PFM - Managerをアンインストールするときは，Performance Managementシステム全体で，Performance Managementのプログラムおよびサービスをすべて停止しておいてください。

PFM - Agentをアンインストールしただけでは，jpcctrl listコマンドで表示できるサービスの情報は削除されません。サービス情報の削除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップの章のサービスの削除について説明している個所を参照してください。

PFM - Managerをアンインストールしたあと，同じマシンに再インストールすると，jpcctrl listコマンドでTrap Generatorサービスが二つ表示されることがあります。この場合，PFM - Managerのサービスを起動し，「Inactive」となっているTrap Generatorサービスをjpcctrl deleteコマンドで削除してください。

(5)　その他の注意事項

PFM - Web Consoleがインストールされているホストから，Performance Managementプログラムをアンインストールする場合は，ブラウザーの画面をすべて閉じてからアンインストールを実施してください。

2.2.2　アンセットアップ手順

ここでは，PFM - Agent for Enterprise Applicationsをアンセットアップする手順を説明します。

＜この項の構成＞

(1)　インスタンス環境のアンセットアップ

(1)　インスタンス環境のアンセットアップ

インスタンス環境をアンセットアップするには，まず，インスタンス名を確認し，インスタンス環境を削除します。インスタンス環境の削除は，PFM - Agentホストで実施します。

インスタンス名を確認するには，jpcinslistコマンドを使用します。また，構築したインスタンス環境を削除するには，jpcinsunsetupコマンドを使用します。

インスタンス環境をアンセットアップする手順を次に示します。

インスタンス名を確認する。
PFM - Agent for Enterprise Applicationsを示すサービスキーを指定して，jpcinslistコマンドを実行します。

jpcinslist agtm

設定されているインスタンス名がo246bci_SD5_00の場合，o246bci_SD5_00と表示されます。

インスタンス環境のPFM - Agentのサービスが起動されている場合は，停止する。
サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，サービスの起動と停止について説明している章を参照してください。

インスタンス環境を削除する。
PFM - Agent for Enterprise Applicationsを示すサービスキーおよびインスタンス名を指定して，jpcinsunsetupコマンドを実行します。
設定されているインスタンス名がo246bci_SD5_00の場合，次のように指定します。

jpcinsunsetup agtm -inst o246bci_SD5_00

jpcinsunsetupコマンドが正常終了すると，インスタンス環境として構築されたフォルダ，サービスIDおよびWindowsのサービスが削除されます。

注意

インスタンス環境をアンセットアップしても，jpcctrl listコマンドで表示できるサービスの情報は削除されません。サービス情報の削除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップの章のサービスの削除について説明している個所を参照してください。

2.2.3　アンインストール手順

PFM - Agent for Enterprise Applicationsをアンインストールする手順を説明します。

PFM - Agent for Enterprise Applicationsをアンインストールするホストに，Administrators権限でログインする。

ローカルホストでPerformance Managementのプログラムおよびサービスを停止する。
サービス情報を表示して，サービスが起動されていないか確認してください。サービスの停止方法およびサービス情報の表示方法については，マニュアル「JP1/Performance Management　システム構築・運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。
ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。

アンインストールするPerformance Managementプログラムを選択する。
Windows 2000の場合，Windowsの［コントロールパネル］で［アプリケーションの追加と削除］を選択して，アンインストールするPerformance Managementプログラムを選択します。
Windows Server 2003，Windows Server 2003(IPF)の場合，Windowsの［コントロールパネル］で［プログラムの追加と削除］を選択して，アンインストールするPerformance Managementプログラムを選択します。

［削除］を選択し，［OK］ボタンをクリックする。
選択したプログラムがアンインストールされます。

2.3　PFM - Agent for Enterprise Applicationsのシステム構成の変更

監視対象システムのネットワーク構成の変更や，ホスト名の変更などに応じて，PFM - Agent for Enterprise Applicationsのシステム構成を変更する場合があります。ここでは，PFM - Agent for Enterprise Applicationsのシステム構成を変更する手順を説明します。

PFM - Agent for Enterprise Applicationsのシステム構成を変更する場合，PFM - ManagerやPFM - Web Consoleの設定変更もあわせて行う必要があります。Performance Managementのシステム構成を変更する手順の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

2.4　PFM - Agent for Enterprise Applicationsの運用方式の変更

収集した稼働監視データの運用手順の変更などで，PFM - Agent for Enterprise Applicationsの運用方式を変更する場合があります。ここでは，PFM - Agent for Enterprise Applicationsの運用方式を変更する手順を説明します。Performance Management全体の運用方式を変更する手順の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この節の構成＞

2.4.1　パフォーマンスデータの格納先の変更

2.4.2　Storeバージョン2.0への移行

2.4.3　インスタンス環境の更新の設定

2.4.1　パフォーマンスデータの格納先の変更

PFM - Agent for Enterprise Applicationsで収集したパフォーマンスデータは，PFM - Agent for Enterprise ApplicationsのAgent StoreサービスのStoreデータベースで管理しています。ここではパフォーマンスデータの格納先の変更方法について説明します。

＜この項の構成＞

(1)　jpcdbctrl configコマンドを使用して設定を変更する

(2)　jpcsto.iniファイルを編集して設定を変更する（Storeバージョン1.0の場合だけ）

(1)　jpcdbctrl configコマンドを使用して設定を変更する

Storeデータベースで管理されるパフォーマンスデータの，次のデータ格納先フォルダを変更したい場合は，jpcdbctrl configコマンドで設定します。Storeデータベースの格納先フォルダを変更する前に収集したパフォーマンスデータが必要な場合は，jpcdbctrl configコマンドの-moveオプションを使用してください。jpcdbctrl configコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

保存先フォルダ

バックアップ先フォルダ

エクスポート先フォルダ

部分バックアップ先フォルダ※

インポート先フォルダ※

注※　Storeバージョン2.0使用時だけ設定できます。

jpcdbctrl configコマンドで設定するオプション名，設定できる値の範囲などを次の表に示します。

表2-7　パフォーマンスデータの格納先を変更するコマンドの設定項目

説明 | オプション名 | 設定できる値（Storeバージョン1.0） | 設定できる値（Storeバージョン2.0） | デフォルト値
パフォーマンスデータの作成先フォルダ | sd | 1～127バイトのフルパス名 | 1～214バイトのフルパス名※1 | インストール先フォルダ¥agtm¥store¥インスタンス名
パフォーマンスデータの作成先フォルダ（論理ホスト運用の場合） | sd | 1～127バイトのフルパス名 | 1～214バイトのフルパス名※1 | 環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名
パフォーマンスデータの退避先フォルダ（フルバックアップ） | bd | 1～127バイトのフルパス名 | 1～211バイトのフルパス名※3 | インストール先フォルダ¥agtm¥store¥インスタンス名¥backup
パフォーマンスデータの退避先フォルダ（フルバックアップ。論理ホスト運用の場合） | bd | 1～127バイトのフルパス名 | 1～211バイトのフルパス名※3 | 環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名¥backup
パフォーマンスデータの退避先フォルダ（部分バックアップ） | pbd | － | 1～214バイトのフルパス名※1 | インストール先フォルダ¥agtm¥store¥インスタンス名¥partial
パフォーマンスデータの退避先フォルダ（部分バックアップ。論理ホスト運用の場合） | pbd | － | 1～214バイトのフルパス名※1 | 環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名¥partial
パフォーマンスデータを退避する場合の最大世代番号 | bs | 1～9 | 1～9 | 5
パフォーマンスデータのエクスポート先フォルダ | dd | 1～127バイトのフルパス名 | 1～127バイトのフルパス名 | インストール先フォルダ¥agtm¥store¥インスタンス名¥dump
パフォーマンスデータのエクスポート先フォルダ（論理ホスト運用の場合） | dd | 1～127バイトのフルパス名 | 1～127バイトのフルパス名 | 環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名¥dump
パフォーマンスデータのインポート先フォルダ | id | － | 1～222バイトのフルパス名※4 | インストール先フォルダ¥agtm¥store¥インスタンス名¥import
パフォーマンスデータのインポート先フォルダ（論理ホスト運用の場合） | id | － | 1～222バイトのフルパス名※4 | 環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名¥import

（凡例）

－：設定できない

注※1

相対パスで設定している場合には，設定したフォルダのパスの長さが，絶対パスで214バイト以内である必要があります。

注※2

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

注※3

相対パスで設定している場合には，設定したフォルダのパスの長さが，絶対パスで211バイト以内である必要があります。

注※4

相対パスで設定している場合には，設定したフォルダのパスの長さが，絶対パスで222バイト以内である必要があります。

(2)　jpcsto.iniファイルを編集して設定を変更する（Storeバージョン1.0の場合だけ）

Storeバージョン1.0使用時は，jpcsto.iniを直接編集して変更できます。

(a)　jpcsto.iniファイルの設定項目

jpcsto.iniファイルで編集するラベル名，設定できる値の範囲などを次の表に示します。

表2-8　パフォーマンスデータの格納先の設定項目（jpcsto.iniの[Data Section]セクション）

説明 | ラベル名 | 設定できる値（Storeバージョン1.0）※1 | デフォルト値
パフォーマンスデータの作成先フォルダ | Store Dir※2 | 1～127バイトのフルパス名 | インストール先フォルダ¥agtm¥store¥インスタンス名
パフォーマンスデータの作成先フォルダ（論理ホスト運用の場合） | Store Dir※2 | 1～127バイトのフルパス名 | 環境ディレクトリ※³¥jp1pc¥agtm¥store¥インスタンス名
パフォーマンスデータの退避先フォルダ（フルバックアップ） | Backup Dir※2 | 1～127バイトのフルパス名 | インストール先フォルダ¥agtm¥store¥インスタンス名¥backup
パフォーマンスデータの退避先フォルダ（フルバックアップ。論理ホスト運用の場合） | Backup Dir※2 | 1～127バイトのフルパス名 | 環境ディレクトリ※³¥jp1pc¥agtm¥store¥インスタンス名¥backup
パフォーマンスデータを退避する場合の最大世代番号 | Backup Save | 1～9 | 5
パフォーマンスデータのエクスポート先フォルダ | Dump Dir※2 | 1～127バイトのフルパス名 | インストール先フォルダ¥agtm¥store¥インスタンス名¥dump
パフォーマンスデータのエクスポート先フォルダ（論理ホスト運用の場合） | Dump Dir※2 | 1～127バイトのフルパス名 | 環境ディレクトリ※³¥jp1pc¥agtm¥store¥インスタンス名¥dump

（凡例）

－：設定できない

注※1

フォルダ名は，すべてフルパス名で指定してください。

指定できる文字は，次の文字を除く，半角英数字，半角記号および半角空白です。
; , * ? ' " < > |

指定値に誤りがある場合，Agent Storeサービスは起動できません。

注※2

Store Dir，Backup Dir，およびDump Dirには，それぞれ重複したフォルダを指定できません。

注※3

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

(b)　jpcsto.iniファイルの編集前の準備

Storeデータベースの格納先フォルダを変更する場合は，変更後の格納先フォルダを事前に作成しておいてください。

Storeデータベースの格納先フォルダを変更すると，変更前に収集したパフォーマンスデータを使用できなくなります。変更前に収集したパフォーマンスデータが必要な場合は，次に示す手順でデータを引き継いでください。

jpcctrl backupコマンドでStoreデータベースに格納されているパフォーマンスデータのバックアップを採取する。

「2.4.1(2)(c)　jpcsto.iniファイルの編集手順」に従ってStoreデータベースの格納先フォルダを変更する。

jpcrestoコマンドで変更後のフォルダにバックアップデータをリストアする。

(c)　jpcsto.iniファイルの編集手順

手順を次に示します。

PFM - Agent のサービスを停止する。
ローカルホストでPFM -Agentのプログラムおよびサービスが起動されている場合は，すべて停止してください。

テキストエディターなどで，jpcsto.iniファイルを開く。

パフォーマンスデータの格納先フォルダなどを変更する。
次に示す網掛け部分を，必要に応じて修正してください。

注意

行頭および「=」の前後には空白文字を入力しないでください。

各ラベルの値の「.」は，Agent StoreサービスのStoreデータベースのデフォルト格納先フォルダ（インストール先フォルダ¥agtm¥store¥インスタンス名）を示します。格納先を変更する場合，その格納先フォルダからの相対パスか，または絶対パスで記述してください。

jpcsto.iniファイルには，データベースの格納先フォルダ以外にも，定義情報が記述されています。[Data Section]セクション以外の値は変更しないようにしてください。[Data Section]セクション以外の値を変更すると，Performance Managementが正常に動作しなくなることがあります。

jpcsto.iniファイルを保存して閉じる。

Performance Managementのプログラムおよびサービスを起動する。

注意

この手順でStoreデータベースの保存先フォルダを変更した場合，パフォーマンスデータファイルは変更前のフォルダから削除されません。これらのファイルが不要な場合は，次に示すファイルだけを削除してください。

拡張子が.DBであるすべてのファイル

拡張子が.IDXであるすべてのファイル

2.4.2　Storeバージョン2.0への移行

Storeデータベースの保存形式には，バージョン1.0と2.0の2種類あります。Storeバージョン2.0の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」を参照してください。

Storeバージョン2.0は，PFM - BaseまたはPFM - Managerのバージョン08-10以降の環境に，08-10以降のPFM - Agent for Enterprise Applicationsで，新規にインスタンスを構築した場合にだけデフォルトで利用できます。それ以外の場合は，Storeバージョン1.0形式のままとなっているため，セットアップコマンドによってStoreバージョン2.0に移行してください。

何らかの理由によってStoreバージョン1.0に戻す必要がある場合は，Storeバージョン2.0のアンセットアップを行ってください。

インストール条件に対応するStoreバージョン2.0の利用可否と利用手順を次の表に示します。

表2-9　Storeバージョン2.0の利用可否および利用手順

インストール条件
Storeバージョン2.0
の利用可否
Storeバージョン2.0
の利用手順

インストール済みのPFM - Base，またはPFM - Managerのバージョン
PFM - Agentの
インストール方法

08-10より前
上書きインストール
利用できない
PFM - Base，または，PFM - Managerを08-10にバージョンアップ後，セットアップコマンドを実行

新規インストール

08-10以降
上書きインストール
既存のインスタンスについてはセットアップ後利用できる
セットアップコマンドを実行

新規インスタンスについては利用できる
インスタンス構築時にjpcinssetupコマンドで設定

新規インストール
利用できる
インスタンス構築時にjpcinssetupコマンドで設定

＜この項の構成＞

(1)　Storeバージョン2.0のセットアップ

(2)　マルチインスタンス環境の場合のセットアップ

(3)　Storeバージョン2.0のアンセットアップ

(4)　注意事項

(1)　Storeバージョン2.0のセットアップ

Storeバージョン2.0へ移行する場合のセットアップ手順について説明します。

システムリソース見積もりと保存期間の設定
Storeバージョン2.0導入に必要なシステムリソースが，実行環境に適しているかどうかを確認してください。必要なシステムリソースを次に示します。

ディスク容量

ファイル数

1プロセスがオープンするファイル数

これらの値は保存期間の設定によって調節できます。実行環境の保有しているリソースを考慮して保存期間を設定してください。システムリソースの見積もりについては，「付録A　システム見積もり」を参照してください。

フォルダの設定
Storeバージョン2.0に移行する場合に，Storeバージョン1.0でのパフォーマンスデータのデータ格納先フォルダ設定のままでは，Agent Storeサービスが起動しないことがあります。この場合，フォルダを設定し直す必要があります。詳しくは，「2.4.1　パフォーマンスデータの格納先の変更」を参照してください。

セットアップコマンドの実行
Storeバージョン2.0に移行するため，jpcdbctrl setupコマンドを実行します。jpcdbctrl setupコマンドは，Agentインスタンスごとに実行してください。
jpcdbctrl setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

保存期間の設定
手順1の見積もり時に設計した保存期間を設定してください。Agent Storeサービスを起動して，PFM - Web Consoleで設定してください。

(2)　マルチインスタンス環境の場合のセットアップ

マルチインスタンス環境の場合，PFM - Manager，PFM - BaseおよびPFM - Agentのバージョン08-10以降で新規インスタンスを作成するときに，jpcinssetupコマンドを実行してください。

(3)　Storeバージョン2.0のアンセットアップ

Storeバージョン2.0のアンセットアップはjpcdbctrl unsetupコマンドを使用します。Storeバージョン2.0をアンセットアップすると，Storeデータベースのデータはすべて初期化され，Storeバージョン1.0に戻ります。

jpcdbctrl unsetupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

(4)　注意事項

移行についての注意事項を次に示します。

(a)　Storeバージョン1.0からStoreバージョン2.0に移行する場合

StoreデータベースをStoreバージョン1.0からStoreバージョン2.0に移行した場合，PIレコードタイプのレコードの保存期間の設定は引き継がれますが，PDレコードタイプのレコードについては，以前の設定値（保存レコード数）に関係なくデフォルトの保存日数がレコードごとに設定され，保存日数以前に収集されたデータは削除されます。

例えば，Storeバージョン1.0で，Collection Intervalが3,600秒のPDレコードの保存レコード数を1,000に設定していた場合，PDレコードは1日に24レコード保存されることになるので，1,000÷24≒約42日分のデータが保存されています。このStoreデータベースをStoreバージョン2.0へ移行した結果，デフォルト保存日数が10日に設定されたとすると，11日以上前のデータは削除されて参照できなくなります。

Storeバージョン2.0へ移行する前に，PDレコードタイプのレコードの保存レコード数の設定を確認し，Storeバージョン2.0でのデフォルト保存日数以上のデータが保存される設定となっている場合は，jpcctrl dumpコマンドでデータベース内のデータを出力してください。Storeバージョン2.0でのデフォルト保存日数については，「付録A.2(2)(b)　Storeバージョン2.0のStoreデータベースのディスク占有量」を参照してください。

(b)　Storeバージョン2.0からStoreバージョン1.0に戻す場合

Storeバージョン2.0をアンセットアップすると，データは初期化されます。このため，Storeバージョン1.0に変更する前に，jpcctrl dumpコマンドでStoreバージョン2.0の情報を出力してください。

(c)　Storeバージョン2.0のレコードのデフォルト保存期間

Storeバージョン2.0は，バージョン08-10以降のPFM - ManagerまたはPFM - Baseとバージョン08-00以降のPFM - Agent for Enterprise Applicationsの組み合わせで利用できます。PFM - Agent for Enterprise Applications 08-10以降を使用する場合とPFM - Agent for Enterprise Applications 08-00を使用する場合で，レコードのデフォルト保存期間が異なります。

PFM - Agent for Enterprise Applications 08-10以降を使用する場合

レコードのデフォルト保存期間については，「付録A.2(2)(b)　Storeバージョン2.0のStoreデータベースのディスク占有量」を参照してください。

PFM - Agent for Enterprise Applications 08-00を使用する場合

PDレコードタイプとPLレコードタイプのレコードでは，すべてのレコードのデフォルト保存期間が10日に設定されます。PIレコードタイプのデフォルト保存期間を次に示します。

表2-10　PIレコードタイプのデフォルト保存期間

セットアップ前の保存期間
セットアップ後の保存期間

要約区分

分
（単位：日）
時
（単位：日）
日
（単位：週）
週
（単位：週）
月
（単位：月）

1分間
1
－
－
－
－

1時間
1
1
－
－
－

1日間
1
1
1
－
－

2日間
2
2
1
－
－

3日間
3
3
1
－
－

4日間
4
4
1
－
－

5日間
5
5
1
－
－

6日間
6
6
1
－
－

1週間
7
7
1
1
－

1か月間
31
31
5
5
1

1年間
366
366
54
54
12

（凡例）

－：指定できない項目

2.4.3　インスタンス環境の更新の設定

インスタンス環境を更新する手順を次に示します。

複数のインスタンス環境を更新する場合は，この手順を繰り返し実施します。

インスタンス名を確認するには，jpcinslistコマンドを使用します。また，インスタンス環境を更新するには，jpcinssetupコマンドを使用します。

インスタンス名を確認する。
インスタンス環境で動作しているPFM - Agent for Enterprise Applicationsを示すサービスキーを指定して，jpcinslistコマンドを実行します。
例えば，PFM - Agent for Enterprise Applicationsのインスタンス名を確認したい場合，次のように指定してコマンドを実行します。

jpcinslist agtm

設定されているインスタンス名がo246bci_SD5_00の場合，o246bci_SD5_00と表示されます。

更新する情報を確認する。
インスタンス環境で更新できる情報を，次に示します。

表2-11　PFM - Agent for Enterprise Applicationsのインスタンス情報

項目
説明
設定できる値
デフォルト値

SID
監視対象となるSAPシステムID
8バイト以内の半角文字列
前回の設定値

SERVER
監視対象となるSAPインスタンス名（トランザクションコードSM51で確認できる，ダイアログサービスを持つSAPインスタンス名）
20バイト以内の半角文字列
前回の設定値

ASHOST
接続先アプリケーションサーバのホスト名（トランザクションコードSM51で確認できるSAPローカルホスト名）
100バイト以内の半角文字列
前回の設定値

SYSNR
SAPシステムのシステム番号を指定する。
2バイト以内の半角数字
前回の設定値

CLIENT
SAPユーザーが属するクライアント名（接続先ダイアログインスタンスに割り当てられているシステム番号）
3バイト以内の半角数字
前回の設定値

USER
SAPユーザー名※
12バイト以内の半角文字列
前回の設定値

EXTPWD
SAPシステムへの接続に，拡張パスワードを使用するかどうかを指定する。
YまたはNで指定する。

Y：拡張パスワードを使用する。

N：拡張パスワードを使用しない。

前回の設定値

PASSWD
SAPユーザーのパスワード※

拡張パスワードを使用する場合：8バイト以内の半角文字列

拡張パスワードを使用しない場合：40バイト以内の半角文字列

前回の設定値（値は表示されません）

DELAYCONNECT
SAPシステムにいつ接続するかを指定する。
YまたはNで指定する。

Y：パフォーマンスデータ収集時にSAPシステムに接続する。
この場合，Agent Collectorサービスは，接続時のSAPシステムの稼働状況に関係なく起動される。

N：Agent Collectorサービス起動時にSAPシステムに接続する。
この場合，Agent Collectorサービスは，接続時にSAPシステムが停止していると起動されない。

前回の設定値

注※

SAPユーザー名およびパスワードについては，「2.1.4(2)　PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの作成」を参照してください。

更新したいインスタンス環境のPFM - Agent for Enterprise Applicationsのサービスが起動されている場合は，停止する。
jpcinssetupコマンド実行時に，更新したいインスタンス環境のサービスが起動されている場合は，確認メッセージが表示され，サービスを停止できます。サービスを停止した場合は，更新処理が続行されます。サービスを停止しなかった場合は，更新処理が中断されます。

更新したいインスタンス環境のPFM - Agent for Enterprise Applicationsを示すサービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
例えば，PFM - Agent for Enterprise Applicationsのインスタンス名o246bci_SD5_00のインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

jpcinssetup agtm -inst o246bci_SD5_00

SAP R/3のインスタンス情報を更新する。
表2-11に示した項目を，コマンドの指示に従って入力します。現在設定されている値が表示されます（ただしPASSWDの値は表示されません）。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

更新したインスタンス環境のサービスを再起動する。
サービスの起動方法および停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，サービスの起動と停止について説明している章を参照してください。コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

3.　インストールとセットアップ（UNIXの場合）

この章では，PFM - Agent for Enterprise Applicationsのインストールおよびセットアップ方法について説明します。

＜この章の構成＞

3.1　インストールとセットアップ

3.2　アンインストールとアンセットアップ

3.3　PFM - Agent for Enterprise Applicationsのシステム構成の変更

3.4　PFM - Agent for Enterprise Applicationsの運用方式の変更

3.1　インストールとセットアップ

ここでは，PFM - Agent for Enterprise Applicationsをインストールおよびセットアップする手順を示します。

＜この節の構成＞

3.1.1　インストールとセットアップの前に

3.1.2　インストールとセットアップの流れ

3.1.3　インストール手順

3.1.4　PFM - Agent for Enterprise Applicationsのセットアップ手順

3.1.1　インストールとセットアップの前に

PFM - Agent for Enterprise Applicationsをインストールおよびセットアップする前に確認しておくことを説明します。

＜この項の構成＞

(1)　前提OS

(2)　ネットワークの環境設定

(3)　インストールに必要なOSユーザー権限について

(4)　前提プログラム

(5)　クラスタシステムでのインストールとセットアップについて

(6)　注意事項

(1)　前提OS

PFM - Agent for Enterprise Applicationsが動作するOSを次に示します。

HP-UX(PA-RISC)

HP-UX(IPF)

AIX

Solaris

(2)　ネットワークの環境設定

Performance Managementが動作するためのネットワーク環境について説明します。

(a)　IPアドレスの設定

PFM - Agentのホストは，ホスト名でIPアドレスが解決できる環境を設定してください。

IPアドレスが解決できない環境では，PFM - Agentは起動できません。

UNIXシステムでは，uname -nコマンドの実行結果で確認できるホスト名でIPアドレスが解決できるように環境設定をしてください。

ホスト名と，IPアドレスの設定は，次の方法のどれかで行ってください。

Performance Managementのホスト情報設定ファイル（jpchostsファイル）

hostsファイル

DNS（Domain Name System）

注意

Performance Managementは，DNS環境でも運用できますが，FQDN（Fully Qualified Domain Name）形式のホスト名には対応していません。UNIXの場合はuname -nコマンドで確認できるホスト名には，ドメイン名を除いたものを使用してください。

複数のLAN環境で使用する場合は，jpchostsファイルでIPアドレスを設定してください。詳細は，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(b)　ポート番号の設定

Performance Managementプログラムのサービスは，デフォルトで次の表に示すポート番号が割り当てられています。これ以外のサービスまたはプログラムに対しては，サービスを起動するたびに，そのときシステムで使用されていないポート番号が自動的に割り当てられます。また，ファイアウォール環境で，Performance Managementを使用するときは，ポート番号を固定してください。ポート番号の固定の手順は，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップについて説明している章を参照してください。

表3-1　デフォルトのポート番号とPerformance Managementプログラムのサービス（UNIX の場合）

サービス説明
サービス名
パラメーター
ポート番号
備考

サービス構成情報管理機能
Name Server
jp1pcnsvr
22285
PFM - ManagerのName Serverサービスで使用されるポート番号。
Performance Managementのすべてのホストで設定される。

NNM連携機能
NNM Object Manager
jp1pcovsvr
22292
PFM - ManagerおよびPFM - BaseのNNM連携機能で，マップマネージャとオブジェクトマネージャの間の通信で使用されるポート番号。
PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。

サービス状態管理機能
Status Server
jp1pcstatsvr
22350
PFM - ManagerおよびPFM - BaseのStatus Serverサービスで使用されるポート番号。
PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。

これらのPFM - Agentが使用するポート番号で通信できるように，ネットワークを設定してください。

(3)　インストールに必要なOSユーザー権限について

PFM - Agent for Enterprise Applicationsをインストールするときは，必ず，スーパーユーザー権限を持つアカウントで実行してください。

(4)　前提プログラム

ここでは，PFM - Agent for Enterprise Applicationsをインストールする場合に必要な前提プログラムを説明します。プログラムの構成図を次に示します。

図3-1　プログラムの構成図

(a)　監視対象プログラム

PFM - Agent for Enterprise Applicationsの監視対象プログラムを次に示します。

SAP R/3 Enterprise

SAP Business Information Warehouse

mySAP ERP

これらの監視対象プログラムは，PFM - Agent for Enterprise Applicationsと同一ホストにインストールする必要があります。

(b)　Performance Managementプログラム

監視エージェントには，PFM - AgentとPFM - Baseをインストールします。PFM - BaseはPFM - Agentの前提プログラムです。同一ホストに複数のPFM - Agentをインストールする場合でも，PFM - Baseは一つだけでかまいません。

ただし，PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。

また，PFM - Agent for Enterprise Applicationsを使ってSAP R/3の稼働監視を行うためには，PFM - ManagerおよびPFM - Web Consoleが必要です。

(5)　クラスタシステムでのインストールとセットアップについて

クラスタシステムでのインストールとセットアップは，前提となるネットワーク環境やプログラム構成が，通常の構成のセットアップとは異なります。また，実行系ノードと待機系ノードでの作業が必要になります。詳細については，「4.　クラスタシステムでの運用」を参照してください。

(6)　注意事項

ここでは，Performance Managementをインスールおよびセットアップするときの注意事項を説明します。

(a)　同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項

Performance Managementは，同一ホストにPFM - Manager，PFM - Web Console，およびPFM - Agentをインストールすることもできます。その場合の注意事項を次に示します。

ポイント

システムの性能や信頼性を向上させるため，PFM - Manager，PFM - Web Console，およびPFM - Agentはそれぞれ別のホストで運用することをお勧めします。

PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。この場合，PFM - Agentの前提プログラムはPFM - Managerになるため，PFM - Managerをインストールしてから PFM - Agentをインストールしてください。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager → PFM - Agentの順でインストールしてください。また，PFM - Manager とPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base → PFM - Agentの順でインストールしてください。

PFM - ManagerがインストールされているホストにPFM - Agentをインストールすると，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，接続先PFM - ManagerをリモートホストのPFM - Managerに変更できません。リモートホストのPFM - Managerに接続したい場合は，インストールするホストにPFM - Managerがインストールされていないことを確認してください。

PFM - AgentがインストールされているホストにPFM - Managerをインストールすると，PFM - Agentの接続先PFM - Managerは自ホスト名に設定し直されます。共通メッセージログに設定結果が出力されています。結果を確認してください。

PFM - Web Consoleがインストールされているホストに，PFM - Agentをインストールする場合は，ブラウザーの画面をすべて閉じてからインストールを実施してください。

Performance Managementプログラムを新規にインストールした場合は，ステータス管理機能がデフォルトで有効になります。ただし，07-50から08-00以降にバージョンアップインストールした場合は，ステータス管理機能の設定状態はバージョンアップ前のままとなります。ステータス管理機能の設定を変更する場合は，マニュアル「JP1/Performance Management システム構築・運用ガイド」のPerformance Managementの障害検知について説明している章を参照してください。

(b)　バージョンアップの注意事項

古いバージョンのPFM - Agentからバージョンアップする場合の注意事項を次に示します。

なお，07-00以降からのバージョンアップについての詳細は，「付録H　移行手順と移行時の注意事項」を参照してください。

Performance Managementのプログラムをインストールするときは，ローカルホストのPerformance Managementのプログラムおよびサービスをすべて停止しておいてください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

すでにPerformance ManagementプログラムがインストールされているホストにPFM - Agentをインストールする場合，PFM - Agentのインストールパスは，すでにインストールされているPFM - Web Console以外のPerformance Managementプログラムのインストールパスと同じになります。インストールパスを変更したい場合は，インストール済みのPFM - Web Console以外のPerformance Managementプログラムをすべて削除し，インストールし直す必要があります。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager，PFM - Agentの順でインストールしてください。また，PFM - ManagerとPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base，PFM - Agentの順でインストールしてください。

バージョン08-00以降のPerformance Managementプログラムでは，Store実行プログラム（jpcsto およびstpqlpr）の配置先が変更されています。PFM - Agentを08-00以降にバージョンアップする際に，旧配置先のStore実行モジュールは削除されます。

(c)　その他の注意事項

Performance Managementのプログラムが一つもインストールされていない環境に新規インストールする場合は，インストールディレクトリにファイルやディレクトリがないことを確認してください。

インストール時のステータスバーに「Installation failed.」と表示されてインストールが失敗した場合，インストールログを採取してください。なお，このログファイルは，次にインストールすると上書きされるため，必要に応じてバックアップを採取してください。インストールログのデフォルトのファイル名については，「12.4.2(2)　Performance Managementの情報」を参照してください。

インストールディレクトリにリンクを張りPerformance Managementのプログラムをインストールした場合，全Performance Managementのプログラムをアンインストールしても，リンク先のディレクトリに一部のファイルやディレクトリが残る場合があります。削除する場合は，手動で行ってください。また，リンク先にインストールする場合，リンク先に同名のファイルやディレクトリがあるときは，Performance Managementのプログラムのインストール時に上書きされるので，注意してください。

3.1.2　インストールとセットアップの流れ

PFM - Agent for Enterprise Applicationsをインストールおよびセットアップする流れを説明します。

図3-2　インストールとセットアップの流れ

PFM - ManagerおよびPFM - Web Consoleのインストールおよびセットアップの手順は，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

3.1.3　インストール手順

ここでは，PFM - Agent for Enterprise Applicationsのプログラムをインストールする順序とCD-ROMの提供媒体からプログラムをインストールする手順を説明します。

＜この項の構成＞

(1)　プログラムのインストール順序

(2)　プログラムのインストール方法

(1)　プログラムのインストール順序

まず，PFM - Baseをインストールし，次にPFM - Agentをインストールします。PFM - BaseがインストールされていないホストにPFM - Agentをインストールすることはできません。

なお，PFM - Managerと同一ホストにPFM - Agentをインストールする場合は，PFM - Manager → PFM - Agentの順でインストールしてください。また，Storeデータベースのバージョン1.0からバージョン2.0にバージョンアップする場合，PFM - AgentとPFM - ManagerまたはPFM - Baseのインストール順序によって，セットアップ方法が異なります。Storeバージョン2.0のセットアップ方法については，「3.4.2　Storeバージョン2.0への移行」を参照してください。

同一ホストに複数のPFM - Agentをインストールする場合，PFM - Agent相互のインストール順序は問いません。

(2)　プログラムのインストール方法

UNIXホストにPerformance Managementプログラムをインストールするには，CD-ROMの提供媒体を使用する方法と，JP1/NETM/DMを使用してリモートインストールする方法があります。JP1/NETM/DMを使用する方法については，次のマニュアルを参照してください。

「JP1/NETM/DM Manager」

「JP1/NETM/DM SubManager（UNIX(R)用）」

「JP1/NETM/DM Client（UNIX(R)用）」

注意

インストールを行うホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。サービスの停止方法は，マニュアル「JP1/Performance Management　システム構築・運用ガイド」の，サービスの起動と停止について説明している章を参照してください。

CD-ROMの提供媒体を使用する場合のインストール手順をOSごとに示します。

(a)　HP-UX（PA-RISC）の場合

Performance Managementのプログラムをインストールするホストに，スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスをすべて停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

Performance Managementのプログラムの媒体をセットする。

mountコマンドを実行して，CD-ROM装置をマウントする。
例えば，CD-ROM装置を/cdromにマウントする場合，次のように指定してコマンドを実行します。

/usr/sbin/mount -F cdfs -r デバイススペシャルファイル名 /cdrom

なお，指定するコマンドは，使用する環境によって異なります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/HPUX/SETUP /cdrom

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールしたいPerformance Managementのプログラムを選択して，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

(b)　HP-UX（IPF）の場合

Performance Managementのプログラムをインストールするホストに，スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスをすべて停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

Performance Managementのプログラムの媒体をセットする。

mountコマンドを実行して，CD-ROM装置をマウントする。
例えば，CD-ROM装置を/cdromにマウントする場合，次のように指定してコマンドを実行します。

/usr/sbin/mount -F cdfs -r デバイススペシャルファイル名 /cdrom

なお，指定するコマンドは，使用する環境によって異なります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/IPFHPUX/SETUP /cdrom

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールしたいPerformance Managementのプログラムを選択して，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

(c)　Solarisの場合

Performance Managementのプログラムをインストールするホストに，スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスをすべて停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

Performance Managementのプログラムの媒体をセットする。

次のコマンドを実行して，Hitachi PP Installerを起動する。※

/cdrom/cdrom/SOLARIS/SETUP /cdrom/cdrom

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールしたいPerformance Managementのプログラムを選択して，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

注※

自動マウント機能を解除している環境では，Hitachi PP Installerを起動する前に，/usr/sbin/mountコマンドを次のように指定してCD-ROM装置をマウントしてください。

/usr/sbin/mount -F cdfs -r デバイススペシャルファイル名 /cdrom/cdrom

なお，指定するコマンドは，使用する環境によって異なります。

(d)　AIXの場合

Performance Managementのプログラムをインストールするホストに，スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスを停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

Performance Managementのプログラムの媒体をセットする。

mountコマンドを実行して，CD-ROM装置をマウントする。
例えば，CD-ROM装置を/cdromにマウントする場合，次のように指定してコマンドを実行します。

/usr/sbin/mount -r -v cdrfs /dev/cd0 /cdrom

なお，指定するコマンドは，使用する環境によって異なります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/AIX/SETUP /cdrom

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールしたいPerformance Managementのプログラムを選択して，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

3.1.4　PFM - Agent for Enterprise Applicationsのセットアップ手順

ここでは，PFM - Agent for Enterprise Applicationsを運用するための，セットアップについて説明します。

[図データ]は使用する環境によって必要になるセットアップ項目，またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。

＜この項の構成＞

(1)　LANG環境変数を設定する

(2)　PFM - Agent for Enterprise Applicationsの登録

(3)　PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの作成

(4)　インスタンス環境の設定

(5)　ネットワークの設定

(6)　ログのファイルサイズ変更

(7)　パフォーマンスデータの格納先の変更

(8)　PFM - Agent for Enterprise Applicationsの接続先PFM - Managerの設定

(9)　動作ログ出力の設定

(1)　LANG環境変数を設定する

PFM - Agent for Enterprise Applicationsで使用できるLANG環境変数を次の表に示します。

なお，これらのLANG環境変数を設定する前に，設定する言語環境が正しくインストール・構築されていることを確認しておいてください。正しくインストール・構築されていない場合，文字化けが発生したり，定義データが不当に書き換わってしまったりすることがあります。

注意

共通メッセージログの言語は，サービス起動時やコマンド実行時に設定されているLANG環境変数によって決まります。そのため，日本語や英語など，複数の言語コードの文字列が混在することがあります。

表3-2　PFM - Agent for Enterprise Applicationsで使用できるLANG環境変数

OS
言語種別
LANG環境変数の値

HP-UX
日本語
Shift-JISコード
ja_JP.SJIS
japanese

EUCコード
ja_JP.eucJP
japanese.euc

英語（日本語なし）
C

Solaris
日本語
Shift-JISコード
ja_JP.PCK

EUCコード
ja
japanese

英語（日本語なし）
C

AIX
日本語
Shift-JISコード
Ja_JP
Ja_JP.IBM-932

EUCコード
ja_JP
ja_JP.IBM-eucJP

英語（日本語なし）
C

（凡例）

－：該当しない

(2)　PFM - Agent for Enterprise Applicationsの登録

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために，PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for Enterprise Applicationsを登録する必要があります。

PFM - Managerのバージョンが08-50以降の場合，PFM - Agentの登録は自動で行われるため，ここで説明する手順は不要です。ただし，PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお，PFM - Agent for Enterprise Applicationsのデータモデルのバージョンについては，「付録I　バージョン互換」を参照してください。

PFM - Agentの登録の流れを次に示します。

図3-3　PFM - Agentの登録の流れ

注意

PFM - Agentの登録は，インスタンス環境を設定する前に実施してください。

すでにPFM - Agent for Enterprise Applicationsの情報が登録されているPerformance Managementシステムに，新たに同じバージョンのPFM - Agent for Enterprise Applicationsを追加した場合，PFM - Agentの登録は必要ありません。

バージョンが異なるPFM - Agent for Enterprise Applicationsを，異なるホストにインストールする場合，古いバージョン，新しいバージョンの順でセットアップしてください。

PFM - Managerと同じホストにPFM - Agentをインストールした場合，jpcagtsetupコマンドが自動的に実行されます。共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されるので，結果を確認してください。コマンドが正しく実行されていない場合は，コマンドを実行し直してください。コマンドの実行方法については，マニュアル「JP1/Performance Management　リファレンス」のコマンドの章を参照してください。

(a)　PFM - Agent for Enterprise Applicationsのセットアップファイルをコピーする

PFM - Agent for Enterprise ApplicationsをインストールしたホストにあるセットアップファイルをPFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。

PFM - Web Consoleが起動されている場合は，停止する。

PFM - Agentのセットアップファイルをバイナリーモードでコピーする。
ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。

表3-3　コピーするセットアップファイル

PFM - Agentの
セットアップファイル
コピー先

PFM
プログラム名
OS
コピー先フォルダ
またはディレクトリ

/opt/jp1pc/setup/jpcagtmw.EXE
PFM - Manager
Windows
PFM - Managerのインストール先フォルダ¥setup

/opt/jp1pc/setup/jpcagtmu.Z
UNIX
/opt/jp1pc/setup/

/opt/jp1pc/setup/jpcagtmw.EXE
PFM - Web Console
Windows
PFM - Web Consoleのインストール先フォルダ¥setup

/opt/jp1pc/setup/jpcagtmu.Z
UNIX
/opt/jp1pcwebcon/setup/

(b)　PFM - Managerホストでセットアップコマンドを実行する

PFM - ManagerでPFM - Agent for Enterprise Applicationsをセットアップするための次のコマンドを実行します。

jpcagtsetup agtm

注意

コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcagtsetupコマンドを実行した場合，エラーが発生することがあります。その場合は，Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと，再度jpcagtsetupコマンドを実行してください。

PFM - ManagerホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと，削除してもかまいません。

(c)　PFM - Web Consoleホストでセットアップコマンドを実行する

PFM - Web ConsoleでPFM - Agent for Enterprise Applicationsをセットアップするための次のコマンドを実行します。

jpcwagtsetup

PFM - Web ConsoleホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと削除してもかまいません。

(3)　PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの作成

PFM - Agent for Enterprise Applicationsはパフォーマンス情報を収集するために，SAP社の通信プロトコルであるRFCを使用して，SAPシステム側に定義されている外部管理インターフェースを実行します。そのため，PFM - Agent for Enterprise Applicationsが使用するユーザーをあらかじめSAPシステム側に用意しておく必要があります。

ここでは，SAPシステム側に作成するSAPユーザーのユーザータイプ，パスワード，権限について説明します。

(a)　ユーザータイプ

PFM - Agent for Enterprise Applicationsで使用するSAPユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

(b)　パスワードに指定できる文字

SAPユーザーのパスワードは，半角数字(0～9)，半角英字(a～z, A～Z)，および次の半角記号で定義してください。

　!"@△$%&/()=?'`*+~#-_.,;:{[]}¥<>|

　△は，空白文字を示します。

(c)　必要な権限

ユーザーには次の権限（権限オブジェクト）を設定する必要があります。

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

外部管理インターフェースを使用するための権限（S_XMI_PROD）

各権限の値として，次の表に示す値またはすべての項目に「*」を指定したビルトイン権限値（S_RFC_ALLやS_XMI_ADMIN）を割り当ててください。

表3-4　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目 | 説明 | 値
RFC_TYPE | 保護されるRFCオブジェクトのタイプ | FUGR（汎用グループ）
RFC_NAME | 保護されるRFC名 | *
ACTVT | アクティビティ | 16（実行）

表3-5　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目 | 説明 | 値
EXTCOMPANY | 外部管理ツールの会社名 | HITACHI
EXTPRODUCT | 外部管理ツールのプログラム名 | JP1
INTERFACE | インターフェースID | *

(4)　インスタンス環境の設定

PFM - Agent for Enterprise Applicationsで監視するSAPシステムのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に，次の情報をあらかじめ確認してください。SAPシステムのインスタンス情報の詳細については，SAP R/3のマニュアルを参照してください。

表3-6　PFM - Agent for Enterprise Applicationsのインスタンス情報

項目
説明
設定できる値
デフォルト値

SID
監視対象となるSAPシステムID
8バイト以内の半角文字列
－

SERVER
監視対象となるSAPインスタンス名（トランザクションコードSM51で確認できる，ダイアログサービスを持つSAPインスタンス名）
20バイト以内の半角文字列
jpcinssetupコマンドの-instで指定したインスタンス名

ASHOST
接続先アプリケーションサーバのホスト名（トランザクションコードSM51で確認できるSAPローカルホスト名）
100バイト以内の半角文字列
ローカルホスト名

SYSNR
SAPシステムのシステム番号を指定する。
2バイト以内の半角数字
「00」

CLIENT
SAPユーザーが属するクライアント名（接続先ダイアログインスタンスに割り当てられているシステム番号）
3バイト以内の半角数字
「000」

USER
SAPユーザー名
12バイト以内の半角文字列
－

EXTPWD
SAPシステムへの接続に，拡張パスワードを使用するかどうかを指定する。
YまたはNで指定する。

Y：拡張パスワードを使用する。

N：拡張パスワードを使用しない。

「N」

PASSWD
SAPユーザーのパスワード

拡張パスワードを使用する場合：8バイト以内の半角文字列

拡張パスワードを使用しない場合：40バイト以内の半角文字列

－

DELAYCONNECT
SAPシステムにいつ接続するかを指定する。
YまたはNで指定する。

Y：パフォーマンスデータ収集時にSAPシステムに接続する。
この場合，Agent Collectorサービスは，接続時のSAPシステムの稼働状況に関係なく起動される。

N：Agent Collectorサービス起動時にSAPシステムに接続する。
この場合，Agent Collectorサービスは，接続時にSAPシステムが停止していると起動されない。

「N」

Store Version※
使用するStore バージョンを指定する。Storeバージョンについては「2.4.2　Store バージョン2.0への移行」を参照してください。
{1.0 | 2.0}
2.0

(凡例)

－：なし

注※

PFM - Agent for Enterprise Applications，および同一ホスト上のPFM - BaseまたはPFM - Managerが08-10以降で，初めてインスタンス環境の設定を行う場合に必要となる設定です。

注意

インスタンス環境を設定していない場合，PFM - Agent for Enterprise Applicationsのサービスを起動できません。

インスタンス環境を構築するには，jpcinssetupコマンドを使用します。インスタンス環境の構築手順を次に示します。

サービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
例えば，PFM - Agent for Enterprise Applicationsのインスタンス名o246bci_SD5_00のインスタンス環境を構築する場合，次のように指定してコマンドを実行します。

jpcinssetup agtm -inst o246bci_SD5_00

PFM - Agent for Enterprise Applicationsの場合，インスタンス名は任意ですが，管理のしやすさを考慮し，監視対象とするSAPシステムのインスタンス名と同じにしてください。SAPシステムのインスタンスには，通常，「ホスト名_SAPシステムID_システム番号」という形式の名称が付けられています。

SAPシステムのインスタンス情報を設定する。
表3-6に示した項目を，コマンドの指示に従って入力してください。各項目とも省略はできません。デフォルトで表示されている値を，項目の入力とする場合はリターンキーだけを押してください。

すべての入力が終了すると，インスタンス環境が構築されます。構築されるインスタンス環境を次に示します。

インスタンス環境のディレクトリ構成
次のディレクトリ下にインスタンス環境が構築されます。

物理ホスト運用の場合：/opt/jp1pc/agtm

論理ホスト運用の場合：環境ディレクトリ※/jp1pc/agtm

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

構築されるインスタンス環境のディレクトリ構成を次に示します。

表3-7　インスタンス環境のディレクトリ構成

ディレクトリ名・ファイル名 | 説明
agent | インスタンス名 | jpcagt.ini | Agent Collectorサービス起動情報ファイル
jpcagt.ini.model※ | Agent Collectorサービス起動情報ファイルのモデルファイル
jr3alget.ini | CCMS Alert Monitor Command（PD_ALMX）レコード用の環境パラメーター設定ファイル
jr3slget.ini | System Log Monitor Command（PD_SLMX）レコード用の環境パラメーター設定ファイル
log | ログファイル格納ディレクトリ
store | インスタンス名 | jpcsto.ini | Agent Storeサービス起動情報ファイル
jpcsto.ini.model※ | Agent Storeサービス起動情報ファイルのモデルファイル
*.DAT | データモデル定義ファイル
dump | エクスポート先ディレクトリ
backup | バックアップ先ディレクトリ
import | インポート先ディレクトリ（Storeバージョン2.0の場合）
log | ログファイル格納ディレクトリ
partial | 部分バックアップ先ディレクトリ（Storeバージョン2.0の場合）
STPD | PDレコードタイプのパフォーマンスデータ格納ディレクトリ（Storeバージョン2.0の場合）
STPI | PIレコードタイプのパフォーマンスデータ格納ディレクトリ（Storeバージョン2.0の場合）
STPL | PLレコードタイプのパフォーマンスデータ格納ディレクトリ（Storeバージョン2.0の場合）

注※

インスタンス環境を構築した時点の設定値に戻したいときに使用します。

インスタンス環境のサービスID
インスタンス環境のサービスIDは，プロダクトID，機能ID，インスタンス番号，インスタンス名，ホスト名をつないだ文字列になります。例えばサービスID「MA1o246bci_SD5_00[host01]」は，次のインスタンス環境を表します。

プロダクトID：M

機能ID：A

インスタンス番号：1

インスタンス名：o246bci_SD5_00

ホスト名：host1

サービスIDについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録を参照してください。

(5)　ネットワークの設定[図データ]

Performance Managementを使用するネットワーク構成に応じて，変更する場合にだけ必要な設定です。

ネットワークの設定では次の二つの項目を設定できます。

IPアドレスを設定する
Performance Managementを複数のLANに接続されたネットワークで使用するときに設定します。複数のIPアドレスを設定するには，jpchostsファイルにホスト名とIPアドレスを定義します。設定したjpchostsファイルはPerformance Managementシステム全体で統一させてください。
詳細についてはマニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

ポート番号を設定する
Performance Managementが使用するポート番号を設定できます。運用での混乱を避けるため，ポート番号とサービス名は，Performance Managementシステム全体で統一させてください。
ポート番号の設定の詳細についてはマニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(6)　ログのファイルサイズ変更[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは，デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合にだけ，必要な設定です。

詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(7)　パフォーマンスデータの格納先の変更[図データ]

PFM - Agent for Enterprise Applicationsで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先，エクスポート先，部分バックアップ先またはインポート先のディレクトリを変更したい場合にだけ，必要な設定です。

パフォーマンスデータは，デフォルトで，次の場所に保存されます。

保存先 | ディレクトリ名
データベースの保存先 | /opt/jp1pc/agtm/store/インスタンス名/
データベースの保存先（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/agtm/store/インスタンス名/
バックアップ先 | /opt/jp1pc/agtm/store/インスタンス名/backup/
バックアップ先（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/agtm/store/インスタンス名/backup/
エクスポート先 | /opt/jp1pc/agtm/store/インスタンス名/dump/
エクスポート先（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/agtm/store/インスタンス名/dump/
部分バックアップ先（Storeバージョン2.0の場合） | /opt/jp1pc/agtm/store/インスタンス名/partial/
部分バックアップ先（論理ホスト運用で，Storeバージョン2.0の場合） | 環境ディレクトリ※/jp1pc/agtm/store/インスタンス名/partial/
インポート先（Storeバージョン2.0の場合） | /opt/jp1pc/agtm/store/インスタンス名/import/
インポート先（論理ホスト運用で，Storeバージョン2.0の場合） | 環境ディレクトリ※/jp1pc/agtm/store/インスタンス名/import/

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

詳細については，「2.4.1　パフォーマンスデータの格納先の変更」を参照してください。

(8)　PFM - Agent for Enterprise Applicationsの接続先PFM - Managerの設定

PFM - Agentがインストールされているホストで，そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには，jpcnshostnameコマンドを使用します。

注意

同一ホスト上に，複数のPFM - Agentがインストールされている場合でも，接続先に指定できるPFM - Managerは，一つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。

PFM - AgentとPFM - Managerが同じホストにインストールされている場合，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，接続先のPFM - ManagerをほかのPFM - Managerに変更できません。

手順を次に示します。

Performance Managementのプログラムおよびサービスを停止する
セットアップを実施する前に，ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，サービスの起動と停止について説明している章を参照してください。
jpcnshostnameコマンド実行時に，Performance Managementのプログラムおよびサービスが起動されている場合は，停止を問い合わせるメッセージが表示されます。

接続先のPFM - Managerホストのホスト名を指定して，jpcnshostnameコマンドを実行する
例えば，接続先のPFM - Managerがホストhost01上にある場合，次のように指定します。

jpcnshostname -s host01

(9)　動作ログ出力の設定[図データ]

PFMサービスの起動・停止時や，PFM - Managerとの接続状態の変更時に動作ログを出力したい場合に必要な設定です。動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能などと連動した動作情報の履歴を出力するログ情報です。

設定方法については，「付録J　動作ログの出力」を参照してください。

3.2　アンインストールとアンセットアップ

ここでは，PFM - Agent for Enterprise Applicationsをアンインストールおよびアンセットアップする手順を示します。

＜この節の構成＞

3.2.1　アンインストールとアンセットアップの前に

3.2.2　アンセットアップ手順

3.2.3　アンインストール手順

3.2.1　アンインストールとアンセットアップの前に

ここでは，PFM - Agent for Enterprise Applicationsをアンインストールおよびアンセットアップするときの注意事項を次に示します。

＜この項の構成＞

(1)　アンインストールに必要なOSユーザー権限に関する注意事項

(2)　ネットワークに関する注意事項

(3)　プログラムに関する注意事項

(4)　サービスに関する注意

(5)　その他の注意事項

(1)　アンインストールに必要なOSユーザー権限に関する注意事項

PFM - Agentをアンインストールするときは，必ず，スーパーユーザー権限を持つアカウントで実行してください。

(2)　ネットワークに関する注意事項

Performance Managementプログラムをアンインストールしても，servicesファイルに定義されたポート番号は削除されません。

(3)　プログラムに関する注意事項

PFM - BaseとPFM - Agentがインストールされているホストの場合，PFM - BaseのアンインストールはPFM - Agentをアンインストールしないと実行できません。この場合，PFM - Agent → PFM - Baseの順にアンインストールしてください。また，PFM - ManagerとPFM - Agentがインストールされているホストの場合も同様に，PFM - ManagerのアンインストールはPFM - Agentをアンインストールしないと実行できません。この場合，PFM - Agent → PFM - Managerの順にアンインストールしてください。

(4)　サービスに関する注意

PFM - Managerをアンインストールするときは，Performance Managementシステム全体で，Performance Managementのプログラムおよびサービスをすべて停止しておいてください。

PFM - Agentをアンインストールしただけでは，jpcctrl listコマンドで表示できるサービスの情報は削除されません。サービス情報の削除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップの章のサービスの削除について説明している個所を参照してください。

PFM - Managerをアンインストールしたあと，同じマシンに再インストールすると，jpcctrl listコマンドでTrap Generatorサービスが二つ表示されることがあります。この場合，PFM - Managerのサービスを起動し，「Inactive」となっているTrap Generatorサービスをjpcctrl deleteコマンドで削除してください。

(5)　その他の注意事項

PFM - Web Consoleがインストールされているホストから，Performance Managementプログラムをアンインストールする場合は，ブラウザーの画面をすべて閉じてからアンインストールを実施してください。

3.2.2　アンセットアップ手順

ここでは，PFM - Agent for Enterprise Applicationsをアンセットアップする手順を説明します。

＜この項の構成＞

(1)　インスタンス環境のアンセットアップ

(1)　インスタンス環境のアンセットアップ

インスタンス環境をアンセットアップするには，まず，インスタンス名を確認し，インスタンス環境を削除します。インスタンス環境の削除は，PFM - Agentホストで実施します。

インスタンス名を確認するには，jpcinslistコマンドを使用します。また，構築したインスタンス環境を削除するには，jpcinsunsetupコマンドを使用します。

インスタンス環境をアンセットアップする手順を次に示します。

インスタンス名を確認する。
PFM - Agent for Enterprise Applicationsを示すサービスキーを指定して，jpcinslistコマンドを実行します。

jpcinslist agtm

設定されているインスタンス名がo246bci_SD5_00の場合，o246bci_SD5_00と表示されます。

インスタンス環境のPFM - Agentのサービスが起動されている場合は，停止する。
サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，サービスの起動と停止について説明している章を参照してください。

インスタンス環境を削除する。
PFM - Agent for Enterprise Applicationsを示すサービスキーおよびインスタンス名を指定して，jpcinsunsetupコマンドを実行します。
設定されているインスタンス名がo246bci_SD5_00の場合，次のように指定します。

jpcinsunsetup agtm -inst o246bci_SD5_00

jpcinsunsetupコマンドが正常終了すると，インスタンス環境として構築されたディレクトリ，サービスIDが削除されます。

注意

インスタンス環境をアンセットアップしても，jpcctrl listコマンドで表示できるサービスの情報は削除されません。サービス情報の削除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップの章のサービスの削除について説明している個所を参照してください。

3.2.3　アンインストール手順

PFM - Agent for Enterprise Applicationsをアンインストールする手順を説明します。

Performance Managementのプログラムをアンインストールするホストに，スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスを停止する。
サービス情報を表示して，サービスが起動されていないか確認してください。サービスの停止方法およびサービス情報の表示方法については，マニュアル「JP1/Performance Management　システム構築・運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。
ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。
アンインストールできるプログラムの一覧が表示されます。

アンインストールしたいPerformance Managementのプログラムを選択して，「D」を入力する。
選択したプログラムがアンインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

アンインストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

3.3　PFM - Agent for Enterprise Applicationsのシステム構成の変更

監視対象システムのネットワーク構成の変更や，ホスト名の変更などに応じて，PFM - Agent for Enterprise Applicationsのシステム構成を変更する場合があります。ここでは，Agent for Enterprise Applicationsのシステム構成を変更する手順を説明します。

PFM - Agent for Enterprise Applicationsのシステム構成を変更する場合，PFM - ManagerやPFM - Web Consoleの設定変更もあわせて行う必要があります。Performance Managementのシステム構成を変更する手順の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

3.4　PFM - Agent for Enterprise Applicationsの運用方式の変更

収集した稼働監視データの運用手順の変更などで，PFM - Agent for Enterprise Applicationsの運用方式を変更する場合があります。ここでは，PFM - Agent for Enterprise Applicationsの運用方式を変更する手順を説明します。Performance Management全体の運用方式を変更する手順の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この節の構成＞

3.4.1　パフォーマンスデータの格納先の変更

3.4.2　Storeバージョン2.0への移行

3.4.3　インスタンス環境の更新の設定

3.4.1　パフォーマンスデータの格納先の変更

PFM - Agent for Enterprise Applicationsで収集したパフォーマンスデータは，PFM - Agent for Enterprise ApplicationsのAgent StoreサービスのStoreデータベースで管理しています。ここではパフォーマンスデータの格納先の変更方法について説明します。

＜この項の構成＞

(1)　jpcdbctrl configコマンドを使用して設定を変更する

(2)　jpcsto.iniファイルを編集して設定を変更する（Storeバージョン1.0の場合だけ）

(1)　jpcdbctrl configコマンドを使用して設定を変更する

Storeデータベースで管理されるパフォーマンスデータの，次のデータ格納先ディレクトリを変更したい場合は，jpcdbctrl configコマンドで設定します。Storeデータベースの格納先ディレクトリを変更する前に収集したパフォーマンスデータが必要な場合は，jpcdbctrl configコマンドの-moveオプションを使用してください。jpcdbctrl configコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

保存先ディレクトリ

バックアップ先ディレクトリ

エクスポート先ディレクトリ

部分バックアップ先ディレクトリ※

インポート先ディレクトリ※

注※　Storeバージョン2.0使用時だけ設定できます。

jpcdbctrl configコマンドで設定するオプション名，設定できる値の範囲などを次の表に示します。

表3-8　パフォーマンスデータの格納先を変更するコマンドの設定項目

説明 | オプション名 | 設定できる値（Storeバージョン1.0） | 設定できる値（Storeバージョン2.0） | デフォルト値
パフォーマンスデータの作成先ディレクトリ | sd | 1～127バイトのフルパス名 | 1～214バイトのフルパス名※1 | /opt/jp1pc/agtm/store/インスタンス名
パフォーマンスデータの作成先ディレクトリ（論理ホスト運用の場合） | sd | 1～127バイトのフルパス名 | 1～214バイトのフルパス名※1 | 環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名
パフォーマンスデータの退避先ディレクトリ（フルバックアップ） | bd | 1～127バイトのフルパス名 | 1～211バイトのフルパス名※3 | /opt/jp1pc/agtm/store/インスタンス名/backup
パフォーマンスデータの退避先ディレクトリ（フルバックアップ。論理ホスト運用の場合） | bd | 1～127バイトのフルパス名 | 1～211バイトのフルパス名※3 | 環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名/backup
パフォーマンスデータの退避先ディレクトリ（部分バックアップ） | pbd | － | 1～214バイトのフルパス名※1 | /opt/jp1pc/agtm/store/インスタンス名/partial
パフォーマンスデータの退避先ディレクトリ（部分バックアップ。論理ホスト運用の場合） | pbd | － | 1～214バイトのフルパス名※1 | 環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名/partial
パフォーマンスデータを退避する場合の最大世代番号 | bs | 1～9 | 1～9 | 5
パフォーマンスデータのエクスポート先ディレクトリ | dd | 1～127バイトのフルパス名 | 1～127バイトのフルパス名 | /opt/jp1pc/agtm/store/インスタンス名/dump
パフォーマンスデータのエクスポート先ディレクトリ（論理ホスト運用の場合） | dd | 1～127バイトのフルパス名 | 1～127バイトのフルパス名 | 環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名/dump
パフォーマンスデータのインポート先ディレクトリ | id | － | 1～222バイトのフルパス名※4 | /opt/jp1pc/agtm/store/インスタンス名/import
パフォーマンスデータのインポート先ディレクトリ（論理ホスト運用の場合） | id | － | 1～222バイトのフルパス名※4 | 環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名/import

（凡例）

－：設定できない

注※1

相対パスで設定している場合には，設定したディレクトリのパスの長さが，絶対パスで214バイト以内である必要があります。

注※2

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

注※3

相対パスで設定している場合には，設定したディレクトリのパスの長さが，絶対パスで211バイト以内である必要があります。

注※4

相対パスで設定している場合には，設定したディレクトリのパスの長さが，絶対パスで222バイト以内である必要があります。

(2)　jpcsto.iniファイルを編集して設定を変更する（Storeバージョン1.0の場合だけ）

Storeバージョン1.0使用時は，jpcsto.iniを直接編集して変更できます。

(a)　jpcsto.iniファイルの設定項目

jpcsto.iniファイルで編集するラベル名，設定できる値の範囲などを次の表に示します。

表3-9　パフォーマンスデータの格納先の設定項目（jpcsto.iniの[Data Section]セクション）

説明 | ラベル名 | 設定できる値（Storeバージョン1.0）※1 | デフォルト値
パフォーマンスデータの作成先ディレクトリ | Store Dir※2 | 1～127バイトのフルパス名 | /opt/jp1pc/agtm/store/インスタンス名
パフォーマンスデータの作成先ディレクトリ | Store Dir※2 | 1～127バイトのフルパス名 | 環境ディレクトリ※³/jp1pc/agtm/store/インスタンス名
パフォーマンスデータの退避先ディレクトリ（フルバックアップ） | Backup Dir※2 | 1～127バイトのフルパス名 | /opt/jp1pc/agtm/store/インスタンス名/backup
パフォーマンスデータの退避先ディレクトリ（フルバックアップ。論理ホスト運用の場合） | Backup Dir※2 | 1～127バイトのフルパス名 | 環境ディレクトリ※³/jp1pc/agtm/store/インスタンス名/backup
パフォーマンスデータを退避する場合の最大世代番号 | Backup Save | 1～9 | 5
パフォーマンスデータのエクスポート先ディレクトリ | Dump Dir※2 | 1～127バイトのフルパス名 | /opt/jp1pc/agtm/store/インスタンス名/dump
パフォーマンスデータのエクスポート先ディレクトリ（論理ホスト運用の場合） | Dump Dir※2 | 1～127バイトのフルパス名 | 環境ディレクトリ※³/jp1pc/agtm/store/インスタンス名/dump

（凡例）

－：設定できない

注※1

ディレクトリ名は，すべてフルパス名で指定してください。

指定できる文字は，次の文字を除く，半角英数字，半角記号および半角空白です。
; , * ? ' " < > |

指定値に誤りがある場合，Agent Storeサービスは起動できません。

注※2

Store Dir，Backup Dir，およびDump Dirには，それぞれ重複したディレクトリを指定できません。

注※3

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

(b)　jpcsto.iniファイルの編集前の準備

Storeデータベースの格納先ディレクトリを変更する場合は，変更後の格納先ディレクトリを事前に作成しておいてください。

Storeデータベースの格納先ディレクトリを変更すると，変更前に収集したパフォーマンスデータを使用できなくなります。変更前に収集したパフォーマンスデータが必要な場合は，次に示す手順でデータを引き継いでください。

jpcctrl backupコマンドでStoreデータベースに格納されているパフォーマンスデータのバックアップを採取する。

「3.4.1(2)(c)　jpcsto.iniファイルの編集手順」に従ってStoreデータベースの格納先ディレクトリを変更する。

jpcrestoコマンドで変更後のディレクトリにバックアップデータをリストアする。

(c)　jpcsto.iniファイルの編集手順

手順を次に示します。

PFM - Agent のサービスを停止する。
ローカルホストでPFM -Agentのプログラムおよびサービスが起動されている場合は，すべて停止してください。

テキストエディターなどで，jpcsto.iniファイルを開く。

パフォーマンスデータの格納先ディレクトリなどを変更する。
次に示す網掛け部分を，必要に応じて修正してください。

注意

行頭および「=」の前後には空白文字を入力しないでください。

各ラベルの値の「.」は，Agent StoreサービスのStoreデータベースのデフォルト格納先ディレクトリ（/opt/jp1pc/agtm/store/インスタンス名）を示します。格納先を変更する場合，その格納先ディレクトリからの相対パスか，または絶対パスで記述してください。

Storeデータベースの格納先を変更する場合，指定するディレクトリを事前に作成してください。

jpcsto.iniファイルには，データベースの格納先ディレクトリ外にも，定義情報が記述されています。[Data Section]セクション以外の値は変更しないようにしてください。[Data Section]セクション以外の値を変更すると，Performance Managementが正常に動作しなくなることがあります。

jpcsto.iniファイルを保存して閉じる。

Performance Managementのプログラムおよびサービスを起動する。

注意

この手順でStoreデータベースの保存先ディレクトリを変更した場合，パフォーマンスデータファイルは変更前のディレクトリから削除されません。これらのファイルが不要な場合は，次に示すファイルだけを削除してください。

拡張子が.DBであるすべてのファイル

拡張子が.IDXであるすべてのファイル

3.4.2　Storeバージョン2.0への移行

Storeデータベースの保存形式には，バージョン1.0と2.0の2種類あります。Storeバージョン2.0の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」を参照してください。

Storeバージョン2.0は，PFM - BaseまたはPFM - Managerのバージョン08-10以降の環境に，08-10以降のPFM - Agent for Enterprise Applicationsで，新規にインスタンスを構築した場合にだけデフォルトで利用できます。それ以外の場合は，Storeバージョン1.0形式のままとなっているため，セットアップコマンドによってStoreバージョン2.0に移行してください。

何らかの理由によってStoreバージョン1.0に戻す必要がある場合は，Storeバージョン2.0のアンセットアップを行ってください。

インストール条件に対応するStoreバージョン2.0の利用可否と利用手順を次の表に示します。

表3-10　Storeバージョン2.0の利用可否および利用手順

インストール条件 | Storeバージョン2.0の利用可否 | Storeバージョン2.0の利用手順
インストール済みのPFM - Base，またはPFM - Managerのバージョン | PFM - Agentのインストール方法
08-10より前 | 上書きインストール | 利用できない | PFM - Base，または，PFM - Managerを08-10にバージョンアップ後，セットアップコマンドを実行
新規インストール
08-10以降 | 上書きインストール | 既存のインスタンスについてはセットアップ後利用できる | セットアップコマンドを実行
新規インスタンスについては利用できる | インスタンス構築時にjpcinssetupコマンドで設定
新規インストール | 利用できる | インスタンス構築時にjpcinssetupコマンドで設定

＜この項の構成＞

(1)　Storeバージョン2.0のセットアップ

(2)　マルチインスタンス環境の場合のセットアップ

(3)　Storeバージョン2.0のアンセットアップ

(4)　注意事項

(1)　Storeバージョン2.0のセットアップ

Storeバージョン2.0へ移行する場合のセットアップ手順について説明します。

システムリソース見積もりと保存期間の設定
Storeバージョン2.0導入に必要なシステムリソースが，実行環境に適しているかどうかを確認してください。必要なシステムリソースを次に示します。

ディスク容量

ファイル数

1プロセスがオープンするファイル数

これらの値は保存期間の設定によって調節できます。実行環境の保有しているリソースを考慮して保存期間を設定してください。システムリソースの見積もりについては，「付録A　システム見積もり」を参照してください。

ディレクトリの設定
Storeバージョン2.0に移行する場合に，Storeバージョン1.0でのパフォーマンスデータのデータ格納先ディレクトリ設定のままでは，Agent Storeサービスが起動しないことがあります。この場合，ディレクトリを設定し直す必要があります。
詳しくは，「3.4.1　パフォーマンスデータの格納先の変更」を参照してください。

セットアップコマンドの実行
Storeバージョン2.0に移行するため，jpcdbctrl setupコマンドを実行します。jpcdbctrl setupコマンドは，Agentインスタンスごとに実行してください。
jpcdbctrl setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

保存期間の設定
手順1の見積もり時に設計した保存期間を設定してください。Agent Storeサービスを起動して，PFM - Web Consoleで設定してください。

(2)　マルチインスタンス環境の場合のセットアップ

マルチインスタンス環境の場合，PFM - Manager，PFM - BaseおよびPFM - Agentのバージョン08-10以降で新規インスタンスを作成するときに，jpcinssetupコマンドを実行してください。

(3)　Storeバージョン2.0のアンセットアップ

Storeバージョン2.0のアンセットアップはjpcdbctrl unsetupコマンドを使用します。Storeバージョン2.0をアンセットアップすると，Storeデータベースのデータはすべて初期化され，Storeバージョン1.0に戻ります。

jpcdbctrl unsetupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

(4)　注意事項

移行についての注意事項を次に示します。

(a)　Storeバージョン1.0からStoreバージョン2.0に移行する場合

StoreデータベースをStoreバージョン1.0からStoreバージョン2.0に移行した場合，PIレコードタイプのレコードの保存期間の設定は引き継がれますが，PDレコードタイプのレコードについては，以前の設定値（保存レコード数）に関係なくデフォルトの保存日数がレコードごとに設定され，保存日数以前に収集されたデータは削除されます。

例えば，Storeバージョン1.0で，Collection Intervalが3,600秒のPDレコードの保存レコード数を1,000に設定していた場合，PDレコードは1日に24レコード保存されることになるので，1,000÷24≒約42日分のデータが保存されています。このStoreデータベースをStoreバージョン2.0へ移行した結果，デフォルト保存日数が10日に設定されたとすると，11日以上前のデータは削除されて参照できなくなります。

Storeバージョン2.0へ移行する前に，PDレコードタイプのレコードの保存レコード数の設定を確認し，Storeバージョン2.0でのデフォルト保存日数以上のデータが保存される設定となっている場合は，jpcctrl dumpコマンドでデータベース内のデータを出力してください。Storeバージョン2.0でのデフォルト保存日数については，「付録A.2(2)(b)　Storeバージョン2.0のStoreデータベースのディスク占有量」を参照してください。

(b)　Storeバージョン2.0からStoreバージョン1.0に戻す場合

Storeバージョン2.0をアンセットアップすると，データは初期化されます。このため，Storeバージョン1.0に変更する前に，jpcctrl dumpコマンドでStoreバージョン2.0の情報を出力してください。

3.4.3　インスタンス環境の更新の設定

インスタンス環境を更新する手順を次に示します。

複数のインスタンス環境を更新する場合は，この手順を繰り返し実施します。

インスタンス名を確認するには，jpcinslistコマンドを使用します。また，インスタンス環境を更新するには，jpcinssetupコマンドを使用します。

インスタンス名を確認する。
インスタンス環境で動作しているPFM - Agent for Enterprise Applicationsを示すサービスキーを指定して，jpcinslistコマンドを実行します。
例えば，PFM - Agent for Enterprise Applicationsのインスタンス名を確認したい場合，次のように指定してコマンドを実行します。

jpcinslist agtm

設定されているインスタンス名がo246bci_SD5_00の場合，o246bci_SD5_00と表示されます。

更新する情報を確認する。
インスタンス環境で更新できる情報を，次に示します。

表3-11　PFM - Agent for Enterprise Applicationsのインスタンス情報

項目
説明
設定できる値
デフォルト値

SID
監視対象となるSAPシステムID
8バイト以内の半角文字列
前回の設定値

SERVER
監視対象となるSAPインスタンス名（トランザクションコードSM51で確認できる，ダイアログサービスを持つSAPインスタンス名）
20バイト以内の半角文字列
前回の設定値

ASHOST
接続先アプリケーションサーバのホスト名（トランザクションコードSM51で確認できるSAPローカルホスト名）
100バイト以内の半角文字列
前回の設定値

SYSNR
SAPシステムのシステム番号を指定する。
2バイト以内の半角数字
前回の設定値

CLIENT
SAPユーザーが属するクライアント名（接続先ダイアログインスタンスに割り当てられているシステム番号）
3バイト以内の半角数字
前回の設定値

USER
SAPユーザー名※
12バイト以内の半角文字列
前回の設定値

EXTPWD
SAPシステムへの接続に，拡張パスワードを使用するかどうかを指定する。
YまたはNで指定する。

Y：拡張パスワードを使用する。

N：拡張パスワードを使用しない。

前回の設定値

PASSWD
SAPユーザーのパスワード※

拡張パスワードを使用する場合：8バイト以内の半角文字列

拡張パスワードを使用しない場合：40バイト以内の半角文字列

前回の設定値（値は表示されません）

DELAYCONNECT
SAPシステムにいつ接続するかを指定する。
YまたはNで指定する。

Y：パフォーマンスデータ収集時にSAPシステムに接続する。
この場合，Agent Collectorサービスは，接続時のSAPシステムの稼働状況に関係なく起動される。

N：Agent Collectorサービス起動時にSAPシステムに接続する。
この場合，Agent Collectorサービスは，接続時にSAPシステムが停止していると起動されない。

前回の設定値

注※

SAPユーザー名およびパスワードについては，「3.1.4(3)　PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの作成」を参照してください。

更新したいインスタンス環境のPFM - Agent for Enterprise Applicationsのサービスが起動されている場合は，停止する。
jpcinssetupコマンド実行時に，更新したいインスタンス環境のサービスが起動されている場合は，確認メッセージが表示され，サービスを停止できます。サービスを停止した場合は，更新処理が続行されます。サービスを停止しなかった場合は，更新処理が中断されます。

更新したいインスタンス環境のPFM - Agent for Enterprise Applicationsを示すサービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
例えば，PFM - Agent for Enterprise Applicationsのインスタンス名o246bci_SD5_00のインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

jpcinssetup agtm -inst o246bci_SD5_00

SAP R/3のインスタンス情報を更新する。
表3-11に示した項目を，コマンドの指示に従って入力します。現在設定されている値が表示されます（ただしPASSWDの値は表示されません）。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

更新したインスタンス環境のサービスを再起動する。
サービスの起動方法および停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，サービスの起動と停止について説明している章を参照してください。コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

4.　クラスタシステムでの運用

この章では，クラスタシステムでPFM - Agent for Enterprise Applicationsを運用する場合のインストール，セットアップ，およびクラスタシステムでPFM - Agent for Enterprise Applicationsを運用しているときの処理の流れについて説明します。

＜この章の構成＞

4.1　クラスタシステムの概要

4.2　フェールオーバー時の処理

4.3　インストールとセットアップ（Windowsの場合）

4.4　インストールとセットアップ（UNIXの場合）

4.5　アンインストールとアンセットアップ（Windowsの場合）

4.6　アンインストールとアンセットアップ（UNIXの場合）

4.7　PFM - Agent for Enterprise Applicationsの運用方式の変更

4.1　クラスタシステムの概要

クラスタシステムとは，複数のサーバシステムを連携して一つのシステムとして運用するシステムです。PFM - Agent for Enterprise Applicationsの監視対象プログラムである，SAPシステムは，次のクラスタシステムで運用できます。

HA（High Availability）クラスタシステム構成のSAPシステム

ここでは，クラスタシステムでPFM - Agent for Enterprise Applicationsを運用する場合の構成について説明します。クラスタシステムの概要，およびPerformance Managementシステムをクラスタシステムで運用する場合のシステム構成については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

なお，この章で，単に「クラスタシステム」と記述している場合は，HAクラスタシステムのことを指します。

＜この節の構成＞

4.1.1　HAクラスタシステム

4.1.1　HAクラスタシステム

＜この項の構成＞

(1)　HAクラスタシステムでのSAPシステムの構成

(2)　HAクラスタシステムでのPFM - Agent for Enterprise Applicationsの構成

(1)　HAクラスタシステムでのSAPシステムの構成

SAPシステムをHAクラスタシステムで運用すると，障害発生時にフェールオーバーすることができ，可用性が向上します。

SAPシステムをHAクラスタシステムで運用する場合，一般的には，実行系ノードと待機系ノードの両方で同じSAPシステムのインスタンスが実行できる環境を構築し，SAPシステムのデータ（データファイル，構成ファイル，ログファイルなど）一式を共有ディスクに格納した構成にします。なお，HAクラスタシステム上でSAPシステムを運用する場合，一般的にはクラスタソフトからSAPシステムを制御するためのソリューション製品を使用します。また，クラスタシステムでのSAPシステムの構成や運用方法については，システムによって異なる場合があります。

(2)　HAクラスタシステムでのPFM - Agent for Enterprise Applicationsの構成

PFM - Agent for Enterprise Applicationsは，HAクラスタシステムで運用でき，クラスタ構成のSAPシステムを監視できます。HAクラスタシステムでPFM - Agent for Enterprise Applicationsを運用する場合は，次の図のような構成で運用します。

図4-1　HAクラスタシステムでのPFM - Agent for Enterprise Applicationsの構成例

図4-1に示すように，PFM - Agent for Enterprise Applicationsはクラスタ構成のSAPシステムと同じ論理ホスト環境で動作し，SAPシステムを監視します。障害発生時はSAPシステムのフェールオーバーに連動してPFM - Agent for Enterprise Applicationsもフェールオーバーし，監視を継続できます。

また，共有ディスクに定義情報，パフォーマンス情報，システムログ情報やCCMSアラート情報を抽出した出力ファイルなどを格納し，フェールオーバー時に引き継ぎます。一つの論理ホストに複数のPerformance Managementのプログラムがある場合は，それぞれが同じ共有ディレクトリを使います。

一つのノードでPFM - Agent for Enterprise Applicationsを複数実行できます。クラスタ構成のSAPシステムが複数ある構成（アクティブ・アクティブ構成）の場合，それぞれの論理ホスト環境で，PFM - Agent for Enterprise Applicationsを実行してください。それぞれのPFM - Agent for Enterprise Applicationsは独立して動作し，別々にフェールオーバーできます。

4.2　フェールオーバー時の処理

実行系ホストに障害が発生すると，処理が待機系ホストに移ります。

ここでは，PFM - Agent for Enterprise Applicationsに障害が発生した場合のフェールオーバー時の処理について説明します。また，PFM - Managerに障害が発生した場合の，PFM - Agent for Enterprise Applicationsへの影響について説明します。

＜この節の構成＞

4.2.1　監視対象ホストに障害が発生した場合のフェールオーバー

4.2.2　PFM - Managerが停止した場合の影響

4.2.1　監視対象ホストに障害が発生した場合のフェールオーバー

PFM - Agent for Enterprise Applicationsを実行している監視対象ホストでフェールオーバーが発生した場合の処理を次の図に示します。

図4-2　監視対象ホストでフェールオーバーが発生した場合の処理

PFM - Agent for Enterprise Applicationsのフェールオーバー中に，PFM - Web Consoleで操作すると，「There was no answer(-6)」というメッセージが表示されます。この場合は，フェールオーバーが完了するまで待ってから操作してください。

PFM - Agent for Enterprise Applicationsのフェールオーバー後に，PFM - Web Consoleで操作すると，フェールオーバー先のノードで起動したPFM - Agent for Enterprise Applicationsに接続されて，操作できます。

4.2.2　PFM - Managerが停止した場合の影響

PFM - Managerが停止すると，Performance Managementシステム全体に影響があります。

PFM - Managerは，各ノードで動作しているPFM - Agent for Enterprise Applicationsのエージェント情報を一括管理しています。また，PFM - Agent for Enterprise Applicationsがパフォーマンス監視中にしきい値を超えた場合のアラームイベントの通知や，アラームイベントを契機としたアクションの実行を制御しています。このため，PFM - Managerが停止すると，Performance Managementシステムに次の表に示す影響があります。

表4-1　PFM - Managerが停止した場合のPFM - Agent for Enterprise Applicationsへの影響

プログラム名
影響
対処

PFM - Agent for Enterprise Applications
PFM - Agent for Enterprise Applicationsが動作中に，PFM - Managerが停止した場合，次のように動作する。

パフォーマンスデータは継続して収集される。

発生したアラームイベントをPFM - Managerに通知できないため，アラーム定義ごとにアラームイベントが保持され，PFM - Managerが起動するまで通知をリトライする。保持しているアラームイベントが三つを超えると，古いアラームイベントは上書きされる。また，PFM - Agent for Enterprise Applicationsを停止すると，保持しているアラームイベントは削除される。

PFM - Managerに通知済みのアラームステータスは，PFM - Managerが再起動したときに一度リセットされる。その後，PFM - ManagerがPFM - Agent for Enterprise Applicationsの状態を確認したあと，アラームステータスは最新の状態となる。

PFM - Agent for Enterprise Applicationsを停止しようとした場合，PFM - Managerに停止することを通知できないため，停止に時間が掛かる。

PFM - Managerを起動する。動作中のPFM - Agent for Enterprise Applicationsはそのまま運用できる。ただし，アラームが期待したとおり通知されない場合があるため，PFM - Manager復旧後に，PFM - Agentの共通メッセージログに出力されているメッセージKAVE00024-Iを確認すること。

PFM - Managerが停止した場合の影響を考慮の上，運用方法を検討してください。なお，トラブル以外にも，構成変更やメンテナンスの作業などでPFM - Managerの停止が必要になる場合もあります。運用への影響が少ないときに，メンテナンスをすることをお勧めします。

4.3　インストールとセットアップ（Windowsの場合）

ここでは，クラスタシステムでのPFM - Agent for Enterprise Applicationsの環境構築と設定の手順について説明します。

なお，PFM - Managerの環境構築と設定の手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この節の構成＞

4.3.1　インストールを始める前に

4.3.2　インストールから運用開始までの流れ

4.3.3　インストール

4.3.4　セットアップ

4.3.1　インストールを始める前に

インストールおよびセットアップを開始する前に前提条件，必要な情報，および注意事項について説明します。

＜この項の構成＞

(1)　前提条件

(2)　論理ホスト運用するPFM - Agent for Enterprise Applicationsのセットアップに必要な情報

(3)　PFM - Agent for Enterprise Applicationsで論理ホストをフェールオーバーさせる場合の注意事項

(1)　前提条件

PFM - Agent for Enterprise Applicationsをクラスタシステムで使用する場合，次に示す前提条件があります。

(a)　クラスタシステム

次の条件が整っていることを確認してください。

クラスタシステムがクラスタソフトによって制御されていること。

クラスタソフトが論理ホスト運用するPFM - Agent for Enterprise Applicationsの起動や停止などを制御するように設定されていること。このとき，PFM - Agent for Enterprise Applicationsが，監視対象のSAPシステムと連動してフェールオーバーするように設定すること。

注意

ワトソン博士でアプリケーションエラーのメッセージボックスが表示されると，フェールオーバーできないおそれがあるため，メッセージボックスによるエラーの通知を抑止する必要があります。抑止手順については，OSのマニュアルを参照してください。なお，エラーの通知を抑止すると，アプリケーションエラーが発生した際の情報取得に影響が出る場合があるため注意してください。

Windows Server 2003では，アプリケーションエラーが発生すると，Microsoftへエラーを報告するダイアログボックスが表示されます。このダイアログボックスが表示されるとフェールオーバーできないおそれがあるため，エラー報告を抑止する必要があります。抑止手順については，OSのマニュアルを参照してください。

(b)　共有ディスク

次の条件が整っていることを確認してください。

論理ホストごとに共有ディスクがあり，実行系ノードから待機系ノードへ引き継げること。

共有ディスクが，各ノードに物理的にFibre ChannelやSCSIで接続されていること。
Performance Managementでは，ネットワークドライブや，ネットワーク経由でレプリケーションしたディスクを共有ディスクとして使う構成はサポートされていません。

フェールオーバーの際に，何らかの問題によって共有ディスクを使用中のプロセスが残った場合でも，クラスタソフトなどの制御によって強制的に共有ディスクをオフラインにしてフェールオーバーできること。

一つの論理ホストでPFM - ManagerやPFM - Agentを複数実行する場合，共有ディスクのディレクトリ名が同じであること。
なお，Storeデータベースについては格納先を変更して，共有ディスク上のほかのディレクトリに格納できます。

(c)　論理ホスト名，論理IPアドレス

次の条件が整っていることを確認してください。

論理ホストごとに論理ホスト名，および論理ホスト名と対応する論理IPアドレスがあり，実行系ノードから待機系ノードに引き継げること。

論理ホスト名と論理IPアドレスが，hostsファイルやネームサーバに設定されていること。

DNS運用している場合は，FQDN名ではなく，ドメイン名を除いたホスト名を論理ホスト名として使用していること。

物理ホスト名と論理ホスト名は，システムの中でユニークであること。

注意

論理ホスト名に，物理ホスト名（hostnameコマンドで表示されるホスト名）を指定しないでください。正常に通信処理がされなくなる可能性があります。

論理ホスト名に使用できる文字は，1～32バイトの半角英数字です。次の記号および空白文字は指定できません。
/ ¥ : ; * ? ' " < > | & = ,

論理ホスト名には，"localhost"，IPアドレス，"-"から始まるホスト名を指定できません。

(2)　論理ホスト運用するPFM - Agent for Enterprise Applicationsのセットアップに必要な情報

論理ホスト運用するPFM - Agent for Enterprise Applicationsをセットアップするには，通常のPFM - Agent for Enterprise Applicationsのセットアップで必要になる環境情報に加えて，次の表の情報が必要です。

表4-2　論理ホスト運用のPFM - Agent for Enterprise Applicationsのセットアップに必要な情報

項目 | 例
論理ホスト名 | jp1-halr3
論理IPアドレス | 172.16.92.100
共有ディスク | S:¥jp1

なお，一つの論理ホストで論理ホスト運用するPerformance Managementのプログラムが複数ある場合も，同じ共有ディスクのディレクトリを使用します。

共有ディスクに必要な容量については，「付録A　システム見積もり」を参照してください。

(3)　PFM - Agent for Enterprise Applicationsで論理ホストをフェールオーバーさせる場合の注意事項

PFM - Agent for Enterprise Applicationsを論理ホスト運用するシステム構成の場合，PFM - Agent for Enterprise Applicationsの障害によって論理ホスト全体をフェールオーバーさせるかどうかを検討してください。

PFM - Agent for Enterprise Applicationsの障害で論理ホスト全体をフェールオーバーさせると，PFM - Agent for Enterprise Applicationsが監視対象としている同じ論理ホストで運用する業務アプリケーションもフェールオーバーすることになり，業務に影響を与える可能性があります。

通常は，PFM - Agent for Enterprise Applicationsに異常が発生しても，SAPシステムの動作に影響がないように，次のどちらかのようにクラスタソフトで設定することをお勧めします。

PFM - Agent for Enterprise Applicationsの動作監視をしない

PFM - Agent for Enterprise Applicationsの異常を検知してもフェールオーバーしない

4.3.2　インストールから運用開始までの流れ

クラスタシステムで，論理ホスト運用するPFM - Agent for Enterprise Applicationsのインストールおよびセットアップの流れを次の図に示します。

図4-3　クラスタシステムで論理ホスト運用するPFM - Agent for Enterprise Applicationsのインストールおよびセットアップの流れ（Windowsの場合）

注意

論理ホスト環境のPFM - Agentをセットアップしても，物理ホスト環境のPFM - Agentの定義内容は引き継がれません。論理ホスト環境および物理ホスト環境では，インスタンス環境を設定した時点で，新規に環境が作成されます。

4.3.3　インストール

実行系ノードおよび待機系ノードにPFM - Agent for Enterprise Applicationsをインストールします。

インストール先はローカルディスクです。共有ディスクにはインストールしないでください。

インストール手順は非クラスタシステムの場合と同じです。インストール手順については，「2.1.3　インストール手順」を参照してください。

4.3.4　セットアップ

ここでは，クラスタシステムでPerformance Managementを運用するための，セットアップについて説明します。

注意

JPC_HOSTNAME環境変数は，Performance Managementで使用していますので，環境変数として設定しないでください。誤って設定した場合は，Performance Managementが正しく動作しません。

＜この項の構成＞

(1)　PFM - Agent for Enterprise Applicationsを登録する

(2)　実行系ノードの論理ホスト環境をセットアップする

(3)　待機系の論理ホスト環境をセットアップする

(4)　クラスタソフトへ登録する

(5)　起動・停止の確認

(6)　クラスタシステムでの環境を設定する

(1)　PFM - Agent for Enterprise Applicationsを登録する

Performance Managementシステムに，PFM - Agent for Enterprise Applicationsを追加する場合には，PFM - Agent for Enterprise Applicationsを登録するためのセットアップが必要です。

PFM - Managerのバージョンが08-50以降の場合，PFM - Agentの登録は自動で行われるため，ここで説明する手順は不要です。ただし，PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお，PFM - Agent for Enterprise Applicationsのデータモデルのバージョンについては，「付録I　バージョン互換」を参照してください。

PFM - Agent for Enterprise Applicationsの登録は，PFM - ManagerおよびPFM - Web Consoleで実施します。PFM - Agent for Enterprise Applicationsを登録する手順は非クラスタシステムの場合と同じです。手順については，「2.1.4(1)　PFM - Agent for Enterprise Applicationsの登録」を参照してください。

(2)　実行系ノードの論理ホスト環境をセットアップする

実行系ノードで，PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップします。

注意

セットアップを実施する前に，Performance Managementシステム全体で，Performance Managementのプログラムのサービスをすべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。

(a)　共有ディスクをオンラインにする

共有ディスクがオンラインになっていることを確認します。共有ディスクがオンラインになっていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオンラインにしてください。

(b)　PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップする

jpchasetup createコマンドを実行して論理ホスト環境を作成します。コマンドを実行すると，共有ディスクに必要なデータがコピーされ，論理ホスト用の定義を設定されて，論理ホスト環境が作成されます。

手順を次に示します。

jpchasetup createコマンドを実行して，PFM - Agent for Enterprise Applicationsの論理ホスト環境を作成する。
次のようにコマンドを実行します。

jpchasetup create agtm -lhost jp1-halr3 -d S:¥jp1

論理ホスト名は，-lhostで指定します。ここでは，論理ホスト名をjp1-halr3としています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
共有ディスクのディレクトリ名は，-dの環境ディレクトリ名に指定します。例えば-d S:¥jp1と指定するとS:¥jp1¥jp1pcが作成されて，論理ホスト環境のファイルが作成されます。

jpchasetup listコマンドを実行して，論理ホストの設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

作成した論理ホスト環境が正しいことを確認してください。

(c)　接続先PFM - Managerを設定する

jpcnshostnameコマンドを実行して，PFM - Agent for Enterprise Applicationsを管理するPFM - Managerを設定します。

jpcnshostnameコマンドを実行して，接続先PFM - Managerを設定する。
次のようにコマンドを実行します。

jpcnshostname -s jp1-hal -lhost jp1-halr3

接続先PFM - Managerのホスト名は，-sオプションで指定します。接続先PFM - Managerが論理ホスト運用されている場合は，-sオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは，PFM - Managerの論理ホスト名をjp1-halとしています。
また，PFM - Agent for Enterprise Applicationsの論理ホスト名は，-lhostで指定します。ここでは，PFM - Agent for Enterprise Applicationsの論理ホスト名をjp1-halr3としています。

(d)　インスタンス環境を設定する

jpcinssetupコマンドを実行して，PFM - Agent for Enterprise Applicationsのインスタンス環境を設定します。

jpcinssetupコマンドを実行する。
次のようにコマンドを実行します。

jpcinssetup agtm -lhost jp1-halr3 -inst o246bci_SD5_00

論理ホスト名は，-lhostで指定します。ここでは，PFM - Agent for Enterprise Applicationsの論理ホスト名をjp1-halr3としています。

SAPシステムのインスタンス環境を設定する。
設定するインスタンス環境は，非クラスタシステムの場合と同じです。設定するインスタンス情報については，「2.1.4(3)　インスタンス環境の設定」を参照してください。

(e)　その他のPerformance Managementのプログラムの論理ホスト環境をセットアップする

PFM - Agent for Enterprise Applicationsのほかに，同じ論理ホストにセットアップするPFM - ManagerやPFM - Agentがある場合は，この段階でセットアップしてください。

セットアップ手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(f)　ポート番号を設定する

ファイアウォールがあるネットワーク環境でPerformance Managementのプログラムを運用する場合だけに必要な設定です。ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には，jpcnsconfig portコマンドを使用してポート番号を設定します。

ポート番号の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。

(g)　IPアドレスを設定する

複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合は，IPアドレスの設定をします。IPアドレスを設定したい場合は，jpchostsファイルの内容を直接編集します。

IPアドレスの設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップについて説明している章を参照してください。

注意

jpchostsファイルを編集した場合は，jpchostsファイルを実行系ノードから待機系ノードにコピーしてください。

(h)　論理ホスト環境定義をエクスポートする

PFM - Agent for Enterprise Applicationsの論理ホスト環境が作成できたら，環境定義をファイルにエクスポートします。エクスポートでは，その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報を一括してファイル出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は，セットアップが一とおり済んだあとにエクスポートしてください。

論理ホスト環境定義をエクスポートする手順を次に示します。

jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
これまでの手順で作成した論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

jpchasetup export -f lhostexp.txt

(i)　論理ホスト環境定義ファイルを待機系ノードにコピーする

「4.3.4(2)(h)　論理ホスト環境定義をエクスポートする」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

(j)　共有ディスクをオフラインにする

クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオフラインにして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，オフラインにする必要はありません。

(3)　待機系の論理ホスト環境をセットアップする

待機系ノードで，PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップします。

(a)　論理ホスト環境定義をインポートする

実行系ノードからコピーしたエクスポートファイルを，待機系ノードにインポートします。

実行系ノードで作成した論理ホストのPerformance Managementのプログラムを，待機系ノードで実行するための設定には，jpchasetup importコマンドを使用します。一つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は，一括してインポートされます。

なお，このコマンドを実行するときには，共有ディスクをオンラインにしておく必要はありません。

jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

jpchasetup import -f lhostexp.txt

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for Enterprise Applicationsを起動するための設定が実施されます。
また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，同様に設定されます。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

実行系ノードでjpchasetup listを実行した時と同じ内容が表示されることを確認してください。

(4)　クラスタソフトへ登録する

Performance Managementのプログラムを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。

ここでは，PFM - Agent for Enterprise Applicationsをクラスタソフトに登録するときに設定する内容を説明します。

(a)　クラスタソフトへPFM - Agent for Enterprise Applicationsを登録する

PFM - Agent for Enterprise Applicationsをクラスタソフトに登録するときの設定内容を，MSCSに登録する項目を例として説明します。

PFM - Agent for Enterprise Applicationsの場合，次の表のサービスをクラスタに登録します。

表4-3　クラスタソフトに登録するPFM - Agent for Enterprise Applicationsのサービス

項番
名前
サービス名
依存関係

1
PFM - Agent Store for SAP R/3 インスタンス名 [LHOST]
JP1PCAGT_MS_インスタンス名 [LHOST]
IPアドレスリソース
物理ディスクリソース
SAPシステムリソース

2
PFM - Agent for SAP R/3 インスタンス名 [LHOST]
JP1PCAGT_MA_インスタンス名 [LHOST]
項番1のクラスタリソース

3
PFM - Action Handler [LHOST]
JP1PCMGR_PH [LHOST]
IPアドレスリソース
物理ディスクリソース

[LHOST]の部分は，論理ホスト名に置き換えてください。インスタンス名がo246bci_SD5_00，論理ホスト名がjp1-halr3 の場合，サービスの名前は「PFM - Agent Store for SAP R/3 o246bci_SD5_00 [jp1-halr3]」，サービス名は「JP1PCAGT_MS_o246bci_SD5_00 [jp1-halr3]」のようになります。

MSCSの場合は，これらのサービスをMSCSのリソースとして登録します。各リソースの設定は次のようにします。下記の［　］は，MSCSの設定項目です。

［リソースの種類］は「汎用サービス」として登録する。

［名前］，［依存関係］，および［サービス名］を表4-3のとおりに設定する。
なお，名前はサービスを表示するときの名称で，サービス名はMSCSから制御するサービスを指定するときの名称です。

［起動パラメータ］および［レジストリ複製］は設定しない。

プロパティの［詳細設定］タブは，Performance Managementのプログラムの障害時にフェールオーバーするかしないかの運用に合わせて設定する。
例えば，PFM - Agent for Enterprise Applicationsの障害時に，フェールオーバーするように設定するには，次のように設定します。
［再開する］：チェックする
［グループに適用する］：チェックする
再起動試行回数の［しきい値］：3※

注※

再起動試行回数の［しきい値］は3回を目安に設定してください。

注意

クラスタに登録するサービスは，クラスタから起動および停止を制御しますので，OS起動時に自動起動しないよう［スタートアップの種類］を［手動］に設定してください。なお，jpchasetup createコマンドでセットアップした直後のサービスは［手動］に設定されています。また，次のコマンドで強制停止しないでください。

jpcstop all lhost=論理ホスト名 kill=immediate

(5)　起動・停止の確認

クラスタソフトからの操作で，Performance Managementのプログラムの起動および停止を各ノードで実行し，正常に動作することを確認してください。

(6)　クラスタシステムでの環境を設定する

Performance Managementのプログラムのセットアップ終了後，PFM - Web Consoleから，運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり，監視対象で問題が発生したときにユーザーに通知できるようにしたりするために，Performance Managementのプログラムの環境を設定します。

Performance Managementのプログラムの環境の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

4.4　インストールとセットアップ（UNIXの場合）

ここでは，クラスタシステムでのPFM - Agent for Enterprise Applicationsの環境構築と設定の手順について説明します。

なお，PFM - Managerの環境構築と設定の手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この節の構成＞

4.4.1　インストールを始める前に

4.4.2　インストールから運用開始までの流れ

4.4.3　インストール

4.4.4　セットアップ

4.4.1　インストールを始める前に

インストールおよびセットアップを開始する前に前提条件，必要な情報，および注意事項について説明します。

＜この項の構成＞

(1)　前提条件

(2)　論理ホスト運用するPFM - Agent for Enterprise Applicationsのセットアップに必要な情報

(3)　PFM - Agent for Enterprise Applicationsで論理ホストをフェールオーバーさせる場合の注意事項

(1)　前提条件

PFM - Agent for Enterprise Applicationsをクラスタシステムで使用する場合，次に示す前提条件があります。

(a)　クラスタシステム

次の条件が整っていることを確認してください。

クラスタシステムがクラスタソフトによって制御されていること。

クラスタソフトが論理ホスト運用するPFM - Agent for Enterprise Applicationsの起動や停止などを制御するように設定されていること。このとき，PFM - Agent for Enterprise Applicationsが，監視対象のSAPシステムと連動してフェールオーバーするように設定すること。

(b)　共有ディスク

次の条件が整っていることを確認してください。

論理ホストごとに共有ディスクがあり，実行系ノードから待機系ノードへ引き継げること。

共有ディスクが，各ノードに物理的にFibre ChannelやSCSIで接続されていること。
Performance Managementでは，ネットワークドライブや，ネットワーク経由でレプリケーションしたディスクを共有ディスクとして使う構成はサポートされていません。

フェールオーバーの際に，何らかの問題によって共有ディスクを使用中のプロセスが残った場合でも，クラスタソフトなどの制御によって強制的に共有ディスクをアンマウントしてフェールオーバーできること。

一つの論理ホストでPFM - ManagerやPFM - Agentを複数実行する場合，共有ディスクのディレクトリ名が同じであること。
なお，Storeデータベースについては格納先を変更して，共有ディスク上のほかのディレクトリに格納できます。

(c)　論理ホスト名，論理IPアドレス

次の条件が整っていることを確認してください。

論理ホストごとに論理ホスト名，および論理ホスト名と対応する論理IPアドレスがあり，実行系ノードから待機系ノードに引き継げること。

論理ホスト名と論理IPアドレスが，hostsファイルやネームサーバに設定されていること。

DNS運用している場合は，FQDN名ではなく，ドメイン名を除いたホスト名を論理ホスト名として使用していること。

物理ホスト名と論理ホスト名は，システムの中でユニークであること。

注意

論理ホスト名に，物理ホスト名（uname -nコマンドで表示されるホスト名）を指定しないでください。正常に通信処理がされなくなる可能性があります。

論理ホスト名に使用できる文字は，1～32バイトの半角英数字です。次の記号および空白文字は指定できません。
/ ¥ : ; * ? ' " < > | & = ,

論理ホスト名には，"localhost"，IPアドレス，"-"から始まるホスト名を指定できません。

(2)　論理ホスト運用するPFM - Agent for Enterprise Applicationsのセットアップに必要な情報

論理ホスト運用するPFM - Agent for Enterprise Applicationsをセットアップするには，通常のPFM - Agent for Enterprise Applicationsのセットアップで必要になる環境情報に加えて，次の表の情報が必要です。

表4-4　論理ホスト運用のPFM - Agent for Enterprise Applicationsのセットアップに必要な情報

項目 | 例
論理ホスト名 | jp1-halr3
論理IPアドレス | 172.16.92.100
共有ディスク | /jp1

なお，一つの論理ホストで論理ホスト運用するPerformance Managementのプログラムが複数ある場合も，同じ共有ディスクのディレクトリを使用します。

共有ディスクに必要な容量については，「付録A　システム見積もり」を参照してください。

(3)　PFM - Agent for Enterprise Applicationsで論理ホストをフェールオーバーさせる場合の注意事項

PFM - Agent for Enterprise Applicationsを論理ホスト運用するシステム構成の場合，PFM - Agent for Enterprise Applicationsの障害によって論理ホスト全体をフェールオーバーさせるかどうかを検討してください。

PFM - Agent for Enterprise Applicationsの障害で論理ホスト全体をフェールオーバーさせると，PFM - Agent for Enterprise Applicationsが監視対象としている同じ論理ホストで運用する業務アプリケーションもフェールオーバーすることになり，業務に影響を与える可能性があります。

通常は，PFM - Agent for Enterprise Applicationsに異常が発生しても，SAPシステムの動作に影響がないように，次のどちらかのようにクラスタソフトで設定することをお勧めします。

PFM - Agent for Enterprise Applicationsの動作監視をしない

PFM - Agent for Enterprise Applicationsの異常を検知してもフェールオーバーしない

4.4.2　インストールから運用開始までの流れ

クラスタシステムで，論理ホスト運用するPFM - Agent for Enterprise Applicationsのインストールおよびセットアップの流れを次の図に示します。

図4-4　クラスタシステムで論理ホスト運用するPFM - Agent for Enterprise Applicationsのインストールおよびセットアップの流れ（UNIXの場合）

注意

論理ホスト環境のPFM - Agentをセットアップしても，物理ホスト環境のPFM - Agentの定義内容は引き継がれません。論理ホスト環境および物理ホスト環境では，インスタンス環境を設定した時点で，新規に環境が作成されます。

4.4.3　インストール

実行系ノードおよび待機系ノードにPFM - Agent for Enterprise Applicationsをインストールします。

インストール先はローカルディスクです。共有ディスクにはインストールしないでください。

インストール手順は非クラスタシステムの場合と同じです。インストール手順については，「3.1.3　インストール手順」を参照してください。

4.4.4　セットアップ

ここでは，クラスタシステムでPerformance Managementを運用するための，セットアップについて説明します。

注意

JPC_HOSTNAME環境変数は，Performance Managementで使用していますので，環境変数として設定しないでください。誤って設定した場合は，Performance Managementが正しく動作しません。

＜この項の構成＞

(1)　PFM - Agent for Enterprise Applicationsを登録する

(2)　実行系ノードの論理ホスト環境をセットアップする

(3)　待機系の論理ホスト環境をセットアップする

(4)　クラスタソフトへ登録する

(5)　起動・停止の確認

(6)　クラスタシステムでの環境を設定する

(1)　PFM - Agent for Enterprise Applicationsを登録する

Performance Managementシステムに，PFM - Agent for Enterprise Applicationsを追加する場合には，PFM - Agent for Enterprise Applicationsを登録するためのセットアップが必要です。

PFM - Managerのバージョンが08-50以降の場合，PFM - Agentの登録は自動で行われるため，ここで説明する手順は不要です。ただし，PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお，PFM - Agent for Enterprise Applicationsのデータモデルのバージョンについては，「付録I　バージョン互換」を参照してください。

PFM - Agent for Enterprise Applicationsの登録は，PFM - ManagerおよびPFM - Web Consoleで実施します。PFM - Agent for Enterprise Applicationsを登録する手順は非クラスタシステムの場合と同じです。手順については，「3.1.4(2)　PFM - Agent for Enterprise Applicationsの登録」を参照してください。

(2)　実行系ノードの論理ホスト環境をセットアップする

実行系ノードで，PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップします。

注意

セットアップを実施する前に，Performance Managementシステム全体で，Performance Managementのプログラムのサービスをすべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。

(a)　共有ディスクをマウントする

共有ディスクがマウントされていることを確認します。共有ディスクがマウントされていない場合は，共有ディスクをマウントしてください。

(b)　PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップする

jpchasetup createコマンドを実行して論理ホスト環境を作成します。コマンドを実行すると，共有ディスクに必要なデータがコピーされ，論理ホスト用の定義を設定して，論理ホスト環境が作成されます。

手順を次に示します。

jpchasetup createコマンドを実行して，PFM - Agent for Enterprise Applicationsの論理ホスト環境を作成する。
次のようにコマンドを実行します。

jpchasetup create agtm -lhost jp1-halr3 -d /jp1

論理ホスト名は，-lhostで指定します。ここでは，論理ホスト名をjp1-halr3としています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
共有ディスクのディレクトリ名は，-dの環境ディレクトリ名に指定します。例えば-d /jp1と指定すると/jp1/jp1pcが作成されて，論理ホスト環境のファイルが作成されます。

jpchasetup listコマンドを実行して，論理ホストの設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

作成した論理ホスト環境が正しいことを確認してください。

(c)　接続先PFM - Managerを設定する

jpcnshostnameコマンドを実行して，PFM - Agent for Enterprise Applicationsを管理するPFM - Managerを設定します。

jpcnshostnameコマンドを実行して，接続先PFM - Managerを設定する。
次のようにコマンドを実行します。

jpcnshostname -s jp1-hal -lhost jp1-halr3

接続先PFM - Managerのホスト名は，-sオプションで指定します。接続先PFM - Managerが論理ホスト運用されている場合は，-sオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは，PFM - Managerの論理ホスト名をjp1-halとしています。
また，PFM - Agent for Enterprise Applicationsの論理ホスト名は，-lhostで指定します。ここでは，PFM - Agent for Enterprise Applicationsの論理ホスト名をjp1-halr3としています。

(d)　インスタンス環境を設定する

jpcinssetupコマンドを実行して，PFM - Agent for Enterprise Applicationsのインスタンス環境を設定します。

jpcinssetupコマンドを実行する。
次のようにコマンドを実行します。

jpcinssetup agtm -lhost jp1-halr3 -inst o246bci_SD5_00

論理ホスト名は，-lhostで指定します。ここでは，PFM - Agent for Enterprise Applicationsの論理ホスト名をjp1-halr3としています。

SAPシステムのインスタンス環境を設定する。
設定するインスタンス環境は，非クラスタシステムの場合と同じです。設定するインスタンス情報については，「3.1.4(4)　インスタンス環境の設定」を参照してください。

(e)　その他のPerformance Managementのプログラムの論理ホスト環境をセットアップする

PFM - Agent for Enterprise Applicationsのほかに，同じ論理ホストにセットアップするPFM - ManagerやPFM - Agentがある場合は，この段階でセットアップしてください。

セットアップ手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(f)　ポート番号を設定する

ファイアウォールがあるネットワーク環境でPerformance Managementのプログラムを運用する場合だけに必要な設定です。ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には，jpcnsconfig portコマンドを使用してポート番号を設定します。

ポート番号の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。

(g)　IPアドレスを設定する

複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合は，IPアドレスの設定をします。IPアドレスを設定したい場合は，jpchostsファイルの内容を直接編集します。

IPアドレスの設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」のインストールとセットアップについて説明している章を参照してください。

注意

jpchostsファイルを編集した場合は，jpchostsファイルを実行系ノードから待機系ノードにコピーしてください。

(h)　論理ホスト環境定義をエクスポートする

PFM - Agent for Enterprise Applicationsの論理ホスト環境が作成できたら，環境定義をファイルにエクスポートします。エクスポートでは，その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報を一括してファイル出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は，セットアップが一とおり済んだあとにエクスポートしてください。

論理ホスト環境定義をエクスポートする手順を次に示します。

jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
これまでの手順で作成した論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

jpchasetup export -f lhostexp.txt

(i)　論理ホスト環境定義ファイルを待機系ノードにコピーする

「4.4.4(2)(h)　論理ホスト環境定義をエクスポートする」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

(j)　共有ディスクをアンマウントする

ファイルシステムをアンマウントして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，ファイルシステムをアンマウントする必要はありません。

注意

共有ディスクがアンマウントされていても，指定した環境ディレクトリにjp1pcディレクトリがあり，jp1pcディレクトリ以下のファイルがある場合は，共有ディスクをマウントしないでセットアップしています。この場合は次の手順で対処してください。

ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。

共有ディスクをマウントする。

共有ディスク上に指定した環境ディレクトリがない場合は，環境ディレクトリを作成する。

共有ディスク上の環境ディレクトリにtarファイルを展開する。

共有ディスクをアンマウントする。

ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリ以下を削除する。

(3)　待機系の論理ホスト環境をセットアップする

待機系ノードで，PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップします。

(a)　論理ホスト環境定義をインポートする

実行系ノードからコピーしたエクスポートファイルを，待機系ノードにインポートします。

実行系ノードで作成した論理ホストのPerformance Managementのプログラムを，待機系ノードで実行するための設定には，jpchasetup importコマンドを使用します。一つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は，一括してインポートされます。

なお，このコマンドを実行するときには，共有ディスクをマウントしておく必要はありません。

jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

jpchasetup import -f lhostexp.txt

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for Enterprise Applicationsを起動するための設定が実施されます。
また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，同様に設定されます。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

実行系ノードでjpchasetup listを実行した時と同じ内容が表示されることを確認してください。

(4)　クラスタソフトへ登録する

Performance Managementのプログラムを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。

ここでは，PFM - Agent for Enterprise Applicationsをクラスタソフトに登録するときに設定する内容を説明します。

(a)　クラスタソフトへPFM - Agent for Enterprise Applicationsを登録する

一般にUNIXのクラスタソフトに，アプリケーションを登録する場合に必要な項目は「起動」「停止」「動作監視」「強制停止」の四つがあります。

PFM - Agent for Enterprise Applicationsでの設定方法を次の表に示します。

表4-5　クラスタソフトに登録するPFM - Agent for Enterprise Applicationsの制御方法

項目
説明

起動
次のコマンドを順に実行して，PFM - Agent for Enterprise Applicationsを起動する。

/opt/jp1pc/tools/jpcstart act lhost=論理ホスト名
/opt/jp1pc/tools/jpcstart agtm lhost=論理ホスト名 inst=インスタンス名

起動するタイミングは，共有ディスクおよび論理IPアドレスが使用できる状態になったあととする。

停止
次のコマンドを順に実行して，PFM - Agent for Enterprise Applicationsを停止する。

/opt/jp1pc/tools/jpcstop agtm lhost=論理ホスト名 inst=インスタンス名
/opt/jp1pc/tools/jpcstop act lhost=論理ホスト名

停止するタイミングは，共有ディスクおよび論理IPアドレスを使用できない状態にする前とする。
なお，障害などでサービスが停止しているときは，jpcstopコマンドの戻り値が3になる。この場合はサービスが停止されているので，正常終了と扱う。戻り値で実行結果を判定するクラスタソフトの場合は，戻り値を0にするなどで対応すること。

動作監視
次のプロセスが動作していることを，psコマンドで確認する。

ps -ef | grep "プロセス名 論理ホスト名" | grep -v "grep 監視対象のプロセス"

監視対象のプロセスは，次のとおり。

jpcagtm,agtm/jpcsto,jpcah

プロセス名ついては，「付録D　プロセス一覧」またはマニュアル「JP1/Performance Management リファレンス」を参照のこと。なお，運用中にメンテナンスなどでPerformance Managementを一時的に停止する場合を想定して，動作監視を抑止する方法（例えば，メンテナンス中のファイルがあると監視をしないなど）を用意しておくことをお勧めします。

強制停止
強制停止が必要な場合は，次のコマンドを実行する。

/opt/jp1pc/tools/jpcstop all lhost=論理ホスト名 kill=immediate

第一引数のサービスキーに指定できるのは，allだけである。

注意

コマンドを実行すると，指定した論理ホスト環境すべてのPerformance Managementのプロセスが，SIGKILL送信によって強制停止される。このとき，サービス単位ではなく，論理ホスト単位でPerformance Managementが強制停止される。

なお，強制停止は，通常の停止を実行しても停止できない場合に限って実行するよう設定すること。

注意

クラスタに登録するPerformance Managementは，クラスタから起動および停止を制御しますので，OS起動時の自動起動設定をしないでください。

Performance Managementを日本語環境で実行する場合，クラスタソフトに登録するスクリプトでLANG環境変数を設定してから，Performance Managementのコマンドを実行するようにしてください。

クラスタソフトがコマンドの戻り値で実行結果を判定する場合は，Performance Managementのコマンドの戻り値をクラスタソフトの期待する値に変換するように設定してください。Performance Managementのコマンドの戻り値については，各コマンドのリファレンスを確認してください。

psコマンドで表示される文字の長さはOSによって異なります。論理ホスト名とインスタンス名を合わせて，47文字以内になるように設定してください。また，psコマンドで動作監視する場合，事前にpsコマンドで論理ホストがすべて表示されているか確認してください。表示が途中で切れてしまっている場合は表示されている文字までを監視するように設定してください。

(5)　起動・停止の確認

クラスタソフトからの操作で，Performance Managementのプログラムの起動および停止を各ノードで実行し，正常に動作することを確認してください。

(6)　クラスタシステムでの環境を設定する

Performance Managementのプログラムのセットアップ終了後，PFM - Web Consoleから，運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり，監視対象で問題が発生したときにユーザーに通知できるようにしたりするために，Performance Managementのプログラムの環境を設定します。

Performance Managementのプログラムの環境の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

4.5　アンインストールとアンセットアップ（Windowsの場合）

ここでは，クラスタシステムで運用していたPFM - Agent for Enterprise Applicationsを，アンインストールする方法とアンセットアップする方法について説明します。

なお，PFM - Managerのアンインストールとアンセットアップについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この節の構成＞

4.5.1　PFM - Agent for Enterprise Applicationsのアンインストールとアンセットアップの流れ

4.5.2　PFM - Agent for Enterprise Applicationsのアンセットアップ

4.5.3　アンインストール

4.5.1　PFM - Agent for Enterprise Applicationsのアンインストールとアンセットアップの流れ

クラスタシステムで運用していたPFM - Agent for Enterprise Applicationsのアンインストールおよびアンセットアップの流れを次の図に示します。

図4-5　クラスタシステムで論理ホスト運用するPFM - Agent for Enterprise Applicationsのアンインストールおよびアンセットアップの流れ（Windowsの場合）

4.5.2　PFM - Agent for Enterprise Applicationsのアンセットアップ

論理ホスト環境をアンセットアップします。アンセットアップ手順には，実行系ノードの手順と，待機系ノードの手順があります。実行系ノード，待機系ノードの順にアンセットアップしてください。

PFM - Agent for Enterprise Applicationsのアンセットアップ手順について説明します。

注意

アンセットアップする実行系ノードおよび待機系ノードで動作している，Performance Managementのプログラムのすべてのサービスを停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この項の構成＞

(1)　実行系ノードの論理ホスト環境をアンセットアップする

(2)　待機系ノードの論理ホスト環境をアンセットアップする

(3)　クラスタソフトの登録を解除する

(4)　PFM - Managerでの設定の削除

(1)　実行系ノードの論理ホスト環境をアンセットアップする

実行系ノードで，PFM - Agent for Enterprise Applicationsの論理ホストの環境をアンセットアップします。

(a)　共有ディスクをオンラインにする

共有ディスクがオンラインになっていることを確認します。共有ディスクがオンラインになっていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオンラインにしてください。

(b)　ポート番号の設定を解除する

この手順は，ファイアウォールを使用する環境で，セットアップ時にjpcnsconfig portコマンドでポート番号を設定した場合だけに必要な手順です。

ポート番号の解除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。

(c)　論理ホスト環境のPFM - Agent for Enterprise Applicationsをアンセットアップする

手順を次に示します。

注意

共有ディスクがオフラインの状態で論理ホスト環境を削除した場合は，物理ホスト上に存在する論理ホストの設定が削除され，共有ディスク上のディレクトリやファイルは削除されません。この場合，共有ディスクをオンラインにして，環境ディレクトリ以下のjp1pcディレクトリを手動で削除する必要があります。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all -lhost jp1-halr3

論理ホスト環境をアンセットアップする前に，現在の設定を確認します。論理ホスト名や共有ディスクのパスなどを確認してください。

PFM - Agent for Enterprise Applicationsのインスタンス環境を削除する。
次のようにコマンドを実行します。

jpcinsunsetup agtm -lhost jp1-halr3 -inst o246bci_SD5_00

jpcinsunsetupコマンドを実行すると，論理ホストのインスタンスを起動するための設定が削除されます。また，共有ディスク上のインスタンス用のファイルが削除されます。

jpchasetup deleteコマンドを実行して，PFM - Agent for Enterprise Applicationsの論理ホスト環境を削除する。
次のようにコマンドを実行します。

jpchasetup delete agtm -lhost jp1-halr3

jpchasetup deleteコマンドを実行すると，論理ホストのPFM - Agent for Enterprise Applicationsを起動するための設定が削除されます。また，共有ディスク上の論理ホスト用のファイルが削除されます。

jpchasetup listコマンドで，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

論理ホスト環境からPFM - Agent for Enterprise Applicationsが削除されていることを確認してください。

(d)　その他のPerformance Managementのプログラムの論理ホスト環境をアンセットアップする

PFM - Agent for Enterprise Applicationsのほかに，同じ論理ホストからアンセットアップするPFM - Agentがある場合は，この段階でアンセットアップしてください。

アンセットアップ手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(e)　論理ホスト環境定義をエクスポートする

論理ホストのPFM - Agent for Enterprise Applicationsを削除したら，環境定義をファイルにエクスポートします。

Performance Managementでは，環境定義のエクスポートおよびインポートによって実行系と待機系の環境を合わせる方式を採っています。

実行系ノードでエクスポートした環境定義（Performance Managementの定義が削除されている）を，待機系ノードにインポートすると，待機系ノードの既存の環境定義（Performance Managementの定義が削除前のままの状態で定義が残っている）と比較して差分（実行系ノードで削除された部分）を確認してPerformance Managementの環境定義を削除します。

手順を次に示します。

jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
Performance Managementの論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

jpchasetup export -f lhostexp.txt

(f)　論理ホスト環境定義ファイルを待機系ノードにコピーする

「(e)　論理ホスト環境定義をエクスポートする」でエクスポートしたファイルを，実行系ノードから待機系ノードにコピーします。

(g)　共有ディスクをオフラインにする

クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオフラインにして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，オフラインにする必要はありません。

(2)　待機系ノードの論理ホスト環境をアンセットアップする

実行系ノードでエクスポートしたファイルを待機系ノードにコピーし，待機系ノードで，論理ホスト環境をアンセットアップします。なお，待機系ノードでは，アンセットアップの時に共有ディスクをオンラインにする必要はありません。

手順を次に示します。

jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

jpchasetup import -f lhostexp.txt

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for Enterprise Applicationsを起動するための設定が削除されます。ほかの論理ホストのPerformance Managementのプログラムをアンセットアップしている場合は，それらの設定も削除されます。
また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，解除されます。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

実行系ノードでjpchasetup listコマンドを実行したときと同じ内容が表示されることを確認してください。

(3)　クラスタソフトの登録を解除する

クラスタソフトから，論理ホストのPFM - Agent for Enterprise Applicationsに関する設定を削除してください。

設定を削除する方法は，クラスタソフトのマニュアルを参照してください。

(4)　PFM - Managerでの設定の削除

PFM - Web ConsoleでPFM - Managerにログインし，アンセットアップするPFM - Agent for Enterprise Applicationsに関連する定義を削除してください。

手順を次に示します。

PFM - Web Consoleから，エージェントを削除する。

PFM - Managerのエージェント情報を削除する。
例えば，PFM - Managerが論理ホストjp1-hal上で動作し，PFM - Agent for Enterprise Applicationsが論理ホストjp1-halr3上で動作している場合，次のように指定してコマンドを実行します。

jpcctrl delete サービスID host=jp1-har3 lhost=jp1-hal

サービスIDには削除するエージェントのサービスIDを指定してください。

PFM - Managerサービスを再起動する。
サービスの起動方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

PFM - Web Consoleを再起動する。
サービス情報の削除をPFM - Web Consoleで有効にするには，PFM - Managerサービスを再起動したあと，PFM - Web Consoleを再起動してください。

4.5.3　アンインストール

PFM - Agent for Enterprise Applicationsをアンインストールしてください。

アンインストール手順は，非クラスタシステムの場合と同じです。詳細は，「2.2.3　アンインストール手順」を参照してください。

注意

PFM - Agent for Enterprise Applicationsをアンインストールする場合は，PFM - Agent for Enterprise ApplicationsをアンインストールするノードのPerformance Managementのプログラムのサービスをすべて停止してください。

論理ホスト環境を削除しないでPFM - Agent for Enterprise Applicationsをアンインストールした場合，環境ディレクトリが残ることがあります。その場合は，環境ディレクトリを削除してください。

4.6　アンインストールとアンセットアップ（UNIXの場合）

ここでは，クラスタシステムで運用していたPFM - Agent for Enterprise Applicationsを，アンインストールする方法とアンセットアップする方法について説明します。

なお，PFM - Managerのアンインストールとアンセットアップについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この節の構成＞

4.6.1　PFM - Agent for Enterprise Applicationsのアンインストールとアンセットアップの流れ

4.6.2　PFM - Agent for Enterprise Applicationsのアンセットアップ

4.6.3　アンインストール

4.6.1　PFM - Agent for Enterprise Applicationsのアンインストールとアンセットアップの流れ

クラスタシステムで運用していたPFM - Agent for Enterprise Applicationsのアンインストールおよびアンセットアップの流れを次の図に示します。

図4-6　クラスタシステムで論理ホスト運用するPFM - Agent for Enterprise Applicationsのアンインストールおよびアンセットアップの流れ（UNIXの場合）

4.6.2　PFM - Agent for Enterprise Applicationsのアンセットアップ

論理ホスト環境をアンセットアップします。アンセットアップ手順には，実行系ノードの手順と，待機系ノードの手順があります。実行系ノード，待機系ノードの順にアンセットアップしてください。

PFM - Agent for Enterprise Applicationsのアンセットアップ手順について説明します。

注意

アンセットアップする実行系ノードおよび待機系ノードで動作している，Performance Managementのプログラムのすべてのサービスを停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この項の構成＞

(1)　実行系ノードの論理ホスト環境をアンセットアップする

(2)　待機系ノードの論理ホスト環境をアンセットアップする

(3)　クラスタソフトの登録を解除する

(4)　PFM - Managerでの設定の削除

(1)　実行系ノードの論理ホスト環境をアンセットアップする

実行系ノードで，PFM - Agent for Enterprise Applicationsの論理ホストの環境をアンセットアップします。

(a)　共有ディスクをマウントする

共有ディスクがマウントされていることを確認します。共有ディスクがマウントされていない場合は，共有ディスクをマウントしてください。

注意

共有ディスクがアンマウントされていても，アンセットアップする論理ホストの環境ディレクトリにjp1pcディレクトリとそれ以下のファイルがある場合は，共有ディスクをマウントしないでセットアップしています。この場合は次の手順で対処してください。

ローカルディスク上のアンセットアップする論理ホストの環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。

共有ディスクをマウントする。

共有ディスク上にアンセットアップする論理ホストの環境ディレクトリがない場合は，環境ディレクトリを作成する。

共有ディスク上のアンセットアップする論理ホストの環境ディレクトリにtarファイルを展開する。

共有ディスクをアンマウントする。

ローカルディスク上のアンセットアップする論理ホストの環境ディレクトリにあるjp1pcディレクトリ以下を削除する。

(b)　ポート番号の設定を解除する

この手順は，ファイアウォールを使用する環境で，セットアップ時にjpcnsconfig portコマンドでポート番号を設定した場合だけに必要な手順です。

ポート番号の解除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。

(c)　論理ホスト環境のPFM - Agent for Enterprise Applicationsをアンセットアップする

手順を次に示します。

注意

共有ディスクがマウントされていない状態で論理ホスト環境を削除した場合は，物理ホスト上に存在する論理ホストの設定が削除され，共有ディスク上のディレクトリやファイルは削除されません。この場合，共有ディスクをマウントして，環境ディレクトリ以下のjp1pcディレクトリを手動で削除する必要があります。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all -lhost jp1-halr3

論理ホスト環境をアンセットアップする前に，現在の設定を確認します。論理ホスト名や共有ディスクのパスなどを確認してください。

PFM - Agent for Enterprise Applicationsのインスタンス環境を削除する。
次のようにコマンドを実行します。

jpcinsunsetup agtm -lhost jp1-halr3 -inst o246bci_SD5_00

jpcinsunsetupコマンドを実行すると，論理ホストのインスタンスを起動するための設定が削除されます。また，共有ディスク上のインスタンス用のファイルが削除されます。

jpchasetup deleteコマンドを実行して，PFM - Agent for Enterprise Applicationsの論理ホスト環境を削除する。
次のようにコマンドを実行します。

jpchasetup delete agtm -lhost jp1-halr3

jpchasetup deleteコマンドを実行すると，論理ホストのPFM - Agent for Enterprise Applicationsを起動するための設定が削除されます。また，共有ディスク上の論理ホスト用のファイルが削除されます。

jpchasetup listコマンドで，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

論理ホスト環境からPFM - Agent for Enterprise Applicationsが削除されていることを確認してください。

(d)　その他のPerformance Managementのプログラムの論理ホスト環境をアンセットアップする

PFM - Agent for Enterprise Applicationsのほかに，同じ論理ホストからアンセットアップするPFM - Agentがある場合は，この段階でアンセットアップしてください。

アンセットアップ手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(e)　論理ホスト環境定義をエクスポートする

論理ホストのPFM - Agent for Enterprise Applicationsを削除したら，環境定義をファイルにエクスポートします。

Performance Managementでは，環境定義のエクスポートおよびインポートによって実行系と待機系の環境を合わせる方式を採っています。

実行系ノードでエクスポートした環境定義（Performance Managementの定義が削除されている）を，待機系ノードにインポートすると，待機系ノードの既存の環境定義（Performance Managementの定義が削除前のままの状態で定義が残っている）と比較して差分（実行系ノードで削除された部分）を確認してPerformance Managementの環境定義を削除します。

手順を次に示します。

jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
Performance Managementの論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

jpchasetup export -f lhostexp.txt

(f)　論理ホスト環境定義ファイルを待機系ノードにコピーする

「(e)　論理ホスト環境定義をエクスポートする」でエクスポートしたファイルを，実行系ノードから待機系ノードにコピーします。

(g)　共有ディスクをアンマウントする

ファイルシステムをアンマウントして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，ファイルシステムをアンマウントする必要はありません。

(2)　待機系ノードの論理ホスト環境をアンセットアップする

実行系ノードでエクスポートしたファイルを待機系ノードにコピーし，待機系ノードで，論理ホスト環境をアンセットアップします。なお，待機系ノードでは，アンセットアップの時に共有ディスクをアンマウントする必要はありません。

手順を次に示します。

jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

jpchasetup import -f lhostexp.txt

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for Enterprise Applicationsを起動するための設定が削除されます。ほかの論理ホストのPerformance Managementのプログラムをアンセットアップしている場合は，それらの設定も削除されます。
また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，解除されます。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

実行系ノードでjpchasetup listコマンドを実行したときと同じ内容が表示されることを確認してください。

(3)　クラスタソフトの登録を解除する

クラスタソフトから，論理ホストのPFM - Agent for Enterprise Applicationsに関する設定を削除してください。

設定を削除する方法は，クラスタソフトのマニュアルを参照してください。

(4)　PFM - Managerでの設定の削除

PFM - Web ConsoleでPFM - Managerにログインし，アンセットアップするPFM - Agent for Enterprise Applicationsに関連する定義を削除してください。

手順を次に示します。

PFM - Web Consoleから，エージェントを削除する。

PFM - Managerのエージェント情報を削除する。
例えば，PFM - Managerが論理ホストjp1-hal上で動作し，PFM - Agent for Enterprise Applicationsが論理ホストjp1-halr3上で動作している場合，次のように指定してコマンドを実行します。

jpcctrl delete サービスID host=jp1-halr3 lhost=jp1-hal

サービスIDには削除するエージェントのサービスIDを指定してください。

PFM - Managerサービスを再起動する。
サービスの起動方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

4.6.3　アンインストール

PFM - Agent for Enterprise Applicationsをアンインストールしてください。

アンインストール手順は，非クラスタシステムの場合と同じです。詳細は，「3.2.3　アンインストール手順」を参照してください。

注意

PFM - Agent for Enterprise Applicationsをアンインストールする場合は，PFM - Agent for Enterprise ApplicationsをアンインストールするノードのPerformance Managementのプログラムのサービスをすべて停止してください。

論理ホスト環境を削除しないでPFM - Agent for Enterprise Applicationsをアンインストールした場合，環境ディレクトリが残ることがあります。その場合は，環境ディレクトリを削除してください。

4.7　PFM - Agent for Enterprise Applicationsの運用方式の変更

ここでは，クラスタシステムでPFM - Agent for Enterprise Applicationsの運用方式を変更する手順を説明します。Performance Management全体の運用方式を変更する手順の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この節の構成＞

4.7.1　インスタンス環境の更新の設定

4.7.1　インスタンス環境の更新の設定

クラスタシステムでインスタンス環境を更新したい場合は，論理ホスト名とインスタンス名を確認し，インスタンス情報を更新します。インスタンス情報の設定は，実行系ノードのPFM - Agentホストで実施します。

更新する情報については，「2.4.3　インスタンス環境の更新の設定」（Windowsの場合），「3.4.3　インスタンス環境の更新の設定」（UNIXの場合）を参照して，あらかじめ確認してください。SAPシステムのインスタンス情報の詳細については，SAP R/3のマニュアルを参照してください。

論理ホスト名とインスタンス名を確認するには，jpchasetup listコマンドを使用します。また，インスタンス環境を更新するには，jpcinssetupコマンドを使用します。

インスタンス環境を更新する手順を次に示します。複数のインスタンス環境を更新する場合は，この手順を繰り返し実施します。

論理ホスト名とインスタンス名を確認する。
更新したいインスタンス環境で動作しているPFM - Agent for Enterprise Applicationsを示すサービスキーを指定して，jpchasetup listコマンドを実行します。
例えば，PFM - Agent for Enterprise Applicationsの論理ホスト名とインスタンス名を確認したい場合，次のように指定してコマンドを実行します。

jpchasetup list agtm

設定されている論理ホスト名がjp1_EAP，インスタンス名がEAP1の場合，次のように表示されます。

更新したいインスタンス環境のPFM - Agent for Enterprise Applicationsのサービスが起動されている場合は，クラスタソフトからサービスを停止する。

更新したいインスタンス環境のPFM - Agent for Enterprise Applicationsを示すサービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
例えば，PFM - Agent for Enterprise Applicationsの論理ホスト名がjp1_EAP，インスタンス名がEAP1のインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

jpcinssetup agtm -lhost jp1_EAP -inst EAP1

SAP R/3のインスタンス情報を更新する。
PFM - Agent for Enterprise Applicationsのインスタンス情報を，コマンドの指示に従って入力します。PFM - Agent for Enterprise Applicationsのインスタンス情報については，「2.4.3　インスタンス環境の更新の設定」（Windowsの場合），「3.4.3　インスタンス環境の更新の設定」（UNIXの場合）を参照してください。現在設定されている値が表示されます（ただしPASSWORDの値は表示されません）。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

更新したインスタンス環境のサービスを，クラスタソフトから再起動する。
サービスの起動方法および停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

注意

更新できない項目の値を変更したい場合は，インスタンス環境を削除したあと，再作成してください。

コマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

5.　システムログ情報の抽出

この章では，PFM - Agent for Enterprise Applicationsで，システムログ情報を抽出する方法について説明します。

＜この章の構成＞

5.1　システムログ情報抽出機能の概要

5.2　システムログ情報の抽出

5.3　環境パラメーター設定ファイル

5.4　コマンド実行によるシステムログ情報の抽出

5.1　システムログ情報抽出機能の概要

PFM - Agent for Enterprise Applicationsで，SAPシステムで発生したイベントおよび障害を記録するシステムログ情報を定期的にテキストファイルに出力できます。PFM - Agent for Enterprise Applicationsのシステムログ情報抽出機能を使用すると，次のようなシステムログ情報をテキストファイルに出力できます。

メッセージ記録時刻

メッセージを記録したサーバ

メッセージを記録したユーザー

メッセージを記録したプログラム

メッセージ番号

メッセージ

テキストファイルに出力されたシステムログ情報は，ほかのプログラムと連携することで，SAPシステムの状態の監視に利用できます。ここでは，JP1/BaseとJP1/IM - Viewとの連携による状態監視の例を説明します。

JP1/Baseのログファイルトラップ機能を使用すると，システムログ情報をJP1イベントに変換できます。このJP1イベントをJP1/IM - Viewから監視することで，SAPシステムの状態をJP1/IM - Viewから監視できるようになります。

JP1/BaseおよびJP1/IM - Viewと連携してSAPシステムの状態を監視する例を，次の図に示します。

図5-1　JP1/BaseおよびJP1/IM - Viewと連携してSAPシステムの状態を監視する例

注意事項

PFM - Agent for Enterprise Applicationsがシステムログ情報を出力するテキストファイルは，一定の容量に達すると先頭から再びデータを上書きする形式のラップアラウンドファイルであり，ファイルの先頭に管理情報として1行のヘッダーがあります。そのため，JP1/Baseのログファイルトラップ機能を使用して本ファイルを監視する場合には，ログファイルトラップ機能の動作定義ファイルに下記のパラメーターを指定してください。

FILETYPE=WRAP1
HEADLINE=1

5.2　システムログ情報の抽出

SAPシステムのシステムログ情報を抽出する方法および出力例について説明します。

システムログ情報を抽出するには，System Log Monitor Command（PD_SLMX）レコードのパフォーマンスデータをStoreデータベースに格納するように設定します。System Log Monitor Command（PD_SLMX）レコードのパフォーマンスデータを収集するごとに，システムログ情報が自動的に抽出されます。前回のレコード収集時刻をタイムスタンプファイルに記録し，この時刻よりもあとに発生したシステムログ情報だけを抽出します。SAPシステムのシステムログ情報は，デフォルトでは，次のテキストファイルに出力されます。

運用環境 | システムログ情報格納ファイル
Windows | インストール先フォルダ¥agtm¥agent¥インスタンス名¥log¥SYSLOG
Windows（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥agent¥インスタンス名¥log¥SYSLOG
UNIX | /opt/jp1pc/agtm/agent/インスタンス名/log/SYSLOG
UNIX（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/agtm/agent/インスタンス名/log/SYSLOG

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

System Log Monitor Command（PD_SLMX）レコードには，処理結果が格納されます。

System Log Monitor Command（PD_SLMX）レコードについては，「9.　レコード」を参照してください。

SAPシステムのシステムログ情報を抽出する流れを次の図に示します。

図5-2　システムログ情報を抽出する流れ

＜この節の構成＞

5.2.1　セットアップ

5.2.2　出力例

5.2.1　セットアップ

SAPシステムのシステムログ情報を抽出するためのセットアップ手順を次に示します。

注意

デフォルトで指定されているシステムログ情報の出力先ファイル名などを変更したい場合，環境パラメーター設定ファイルを編集したあとにセットアップしてください。環境パラメーター設定ファイルについては，「5.3　環境パラメーター設定ファイル」を参照してください。

PFM - Web Consoleで，System Log Monitor Command（PD_SLMX）レコードのパフォーマンスデータをStoreデータベースに格納するように設定する。
設定する方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

5.2.2　出力例

SAPシステムのシステムログ情報の出力例を次に示します。

5.3　環境パラメーター設定ファイル

ここでは，環境パラメーター設定ファイルについて説明します。

環境パラメーター設定ファイルとは，システムログ情報の出力先ファイル名などを設定するファイルです。PFM - Agent for Enterprise Applicationsで，SAPシステムのシステムログ情報が抽出される際，このファイルの設定内容を基に抽出されます。

このファイルは，テキストファイルとしてユーザーが作成します。

＜この節の構成＞

5.3.1　設定手順

5.3.2　設定内容

5.3.1　設定手順

環境パラメーター設定ファイルの設定手順を次に示します。

環境パラメーター設定ファイルを開く。
環境パラメーター設定ファイルを次に示します。

運用環境 | 環境パラメーター設定ファイル
Windows | インストール先フォルダ¥agtm¥agent¥インスタンス名¥jr3slget.ini
Windows（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥agent¥インスタンス名¥jr3slget.ini
UNIX | /opt/jp1pc/agtm/agent/インスタンス名/jr3slget.ini
UNIX（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/agtm/agent/インスタンス名/jr3slget.ini

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

設定内容を編集する。
環境パラメーター設定ファイルの設定内容を次に示します。次の網掛け部分が修正できます。設定内容については，「5.3.2　設定内容」を参照してください。

環境パラメーター設定ファイルを保存する。

5.3.2　設定内容

環境パラメーター設定ファイルは，次の形式で記述します。

[セクション]
ラベル=値
ラベル=値
：
：
[セクション]
ラベル=値
ラベル=値

注意

行頭および「=」の前後に，空白文字などの余計な文字を設定しないでください。

セクションおよびラベルでは，指定した値の大文字・小文字は区別されません。

行の先頭に「;」を指定すると，その行はコメントとして扱われます。

次に，環境パラメーター設定ファイルの各セクションで設定する内容を表形式で説明します。

＜この項の構成＞

(1)　EXTRACTFILEセクション

(2)　FORMATセクション

(3)　TRACEセクション

(4)　CONNECTセクション

(1)　EXTRACTFILEセクション

EXTRACTFILEセクションでは，システムログ情報の出力ファイルの情報を指定します。

表5-1　EXTRACTFILEセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値

SIZE
出力ファイル容量。

0：システムの最大値※1

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
1024

X2PATH
出力ファイルのパス。※2※3
1～255バイトの半角英数字。相対パスを指定した場合，インスタンス環境ディレクトリからの相対パスとなる。

Windowsの場合：log¥SYSLOG

UNIXの場合：log/SYSLOG

注※1

32ビットの符号付き整数で示せる0x7FFFFFFF（約2ギガバイト）です。

注※2

指定の出力ファイルと同じディレクトリに，出力ファイル名.ofsという名称で管理ファイルが作成されます。（例：出力ファイル名としてSYSLOGを指定したときSYSLOGファイルとは別にSYSLOG.ofsファイルが管理ファイルとして作成されます）出力ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

注※3

デフォルトの格納先から変更した場合，トラブル発生時に資料を採取するjpcrasコマンドでは採取できません。

(2)　FORMATセクション

FORMATセクションでは，出力されるシステムログ情報の出力形式を指定します。

表5-2　FORMATセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値

COLUMN
出力されるシステムログ情報の出力形式。
フィールドID。フィールドIDについては，「10.　コマンド」を参照のこと。
列1：<TIME>
列2：<INSTANCE>
列3：<USER>
列4：<PROGRAM>
列5：<MSGNO>
列6：<MSGTEXT>

(3)　TRACEセクション

TRACEセクションでは，システムログ情報抽出の実行履歴が保存されるメッセージログおよびデータログの情報を指定します。

表5-3　TRACEセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値

MSGLOG_LEVEL
アプリケーションのトレース情報を保存するメッセージログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0～4
2

MSGLOG_SIZE
メッセージログを取得するファイル容量。

0：システムの最大値※

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
512

MSGLOG_DIR
メッセージログファイル（jr3slget.log）の取得先ディレクトリ。
（変更できない）
log

DATALOG_LEVEL
アプリケーションの各種データ情報を保存するデータログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0～4
2

DATALOG_SIZE
データログを取得するファイル容量。

0：システムの最大値※

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
512

DATALOG_DIR
データログファイル（jr3slget.dat）の取得先ディレクトリ。
（変更できない）
log

注※

32ビットの符号付き整数で示せる0x7FFFFFFF（約2ギガバイト）です。

(4)　CONNECTセクション

CONNECTセクションでは，SAPシステムとのRFC接続を確立するための情報を指定します。

表5-4　CONNECTセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値

LANG
接続に利用するユーザーの言語
SAPシステムで使用されている，2バイトのISO IDまたは1バイトの言語キー

日本語の場合：JA

英語の場合：EN

なし

CODEPAGE
接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページ
LANGラベルの言語と組み合わせて指定する※
なし

注※

LANGラベルとCODEPAGEラベルは，次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表5-5　言語とコードページの指定内容の組み合わせ

接続先
SAPシステム
接続言語
言語
（LANG）
コードページ（CODEPAGE）

Unicode版
日本語
JA
8000

英語
EN
指定する必要はありません。指定する場合は，1100を指定してください。

非Unicode版
日本語
JA
指定する必要はありません。指定する場合は，8000を指定してください。

英語
EN
指定する必要はありません。指定する場合は，1100を指定してください。

LANGラベルの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

CODEPAGEラベルの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。

5.4　コマンド実行によるシステムログ情報の抽出

jr3slgetコマンドを手動実行，またはほかのプログラムでjr3slgetコマンドを自動実行して，SAPシステムのシステムログ情報を抽出することもできます。ここでは，jr3slgetコマンド実行によるシステムログ情報の抽出方法を説明します。

＜この節の構成＞

5.4.1　コマンドを実行する前に

5.4.2　コマンド実行によるシステムログ情報の抽出方法

5.4.3　コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル

5.4.1　コマンドを実行する前に

jr3slgetコマンドを実行してSAPシステムのシステムログ情報を抽出する前に，次のことを確認してください。

環境パラメーター設定ファイルの設定内容
この場合の環境パラメーター設定ファイルは，System Log Monitor Command（PD_SLMX）レコードを使用してシステムログ情報を抽出する場合の環境パラメーター設定ファイルとは異なります。この場合に使用する環境パラメーター設定ファイルについては，「5.4.3　コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル」を参照してください。

コマンドの実行環境
次のことについて確認してください。

ネットワークの設定に問題がないか

SAPシステムが稼働しているか

SAPシステムがRFC要求を受け付けられる状態にあるか

5.4.2　コマンド実行によるシステムログ情報の抽出方法

jr3slgetコマンドを手動実行，またはほかのプログラムでjr3slgetコマンドを自動実行して，SAPシステムのシステムログ情報を抽出する場合，抽出するシステムログ情報を次のように選定できます。

コマンドを実行した日に出力されたすべてのシステムログ情報を抽出する

前回のコマンド実行時以降に出力されたシステムログ情報だけを抽出する

jr3slgetコマンドについては，「10.　コマンド」を参照してください。

注意

すでに環境パラメーター設定ファイルで設定したパラメーターの値を，jr3slgetコマンドでも指定した場合，コマンドで指定した値が優先されます。

次にそれぞれの方法について説明します。

＜この項の構成＞

(1)　コマンドを実行した日に出力されたすべてのシステムログ情報を抽出する

(2)　前回のコマンド実行時以降に出力されたシステムログ情報だけを抽出する

(1)　コマンドを実行した日に出力されたすべてのシステムログ情報を抽出する

コマンドを実行した日に出力されたすべてのシステムログ情報を抽出する場合のコマンドの指定例を次に示します（環境パラメーター設定ファイルでCONNECTセクションの値およびTARGETセクションの値を定義済み）。

jr3slget

(2)　前回のコマンド実行時以降に出力されたシステムログ情報だけを抽出する

前回のコマンド実行時以降に出力されたシステムログ情報だけを抽出する場合，-lasttimeオプションで，タイプスタンプファイルを指定してコマンドを実行します。タイムスタンプファイルには，jr3slgetコマンドの実行日時の履歴が格納されています。そのため，同じタイムスタンプファイルを指定して，コマンドを繰り返し実行すると，システムログ情報を連続かつ重複しないで抽出できます。

注意

-lasttimeオプションの初回実行時に，指定したタイムスタンプファイルが存在しない場合，新規に作成されます。-lasttimeオプション初回実行時は，システムログ情報が報告されません。

前回のコマンド実行時以降に出力されたシステムログ情報だけを抽出する場合のコマンドの指定例を次に示します（環境パラメーター設定ファイルでCONNECTセクションの値およびTARGETセクションの値を定義済み）。

jr3slget -lasttime sltimestamp.txt

5.4.3　コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル

jr3slgetコマンド実行時に，引数として環境パラメーター設定ファイルを指定すると，ファイルの設定内容を基に，SAPシステムのシステムログ情報が抽出されます。

このファイルは，テキストファイルとしてユーザーが作成します。

＜この項の構成＞

(1)　設定手順

(2)　設定内容

(1)　設定手順

環境パラメーター設定ファイルの設定手順を次に示します。

環境パラメーター設定ファイルのサンプルファイルを「jr3slget.ini」の名前でコピーする。
この「jr3slget.ini」が，デフォルトの環境パラメーター設定ファイルとなります。環境パラメーター設定ファイルのサンプルファイルを次に示します。

Windowsの場合

インストール先フォルダ¥agtm¥evtrap¥jr3slget.ini.sample

UNIXの場合

/opt/jp1pc/agtm/evtrap/jr3slget.ini.sample

jr3slget.iniを開く。

設定内容を編集する。
デフォルトの環境パラメーター設定ファイルの設定内容を次に示します。設定内容については，「(2)　設定内容」を参照してください。

コメント行を表す「;」が行頭にある項目は，デフォルトでは設定が有効になっていません。設定を有効にするには，コメント行を表す「;」を外してください。

環境パラメーター設定ファイルを保存する。
jr3slgetコマンド実行時に-cnfオプションを指定することで，環境パラメーター設定ファイルの内容を基にSAPシステムのシステムログ情報が抽出されます。

(2)　設定内容

環境パラメーター設定ファイルは，次の形式で記述します。

[セクション]
ラベル=値
ラベル=値
：
：
[セクション]
ラベル=値
ラベル=値

注意

行頭および「=」の前後に，空白文字などの余計な文字を設定しないでください。

セクションおよびラベルでは，指定した値の大文字・小文字は区別されません。

行の先頭に「;」を指定すると，その行はコメントとして扱われます。

次に，環境パラメーター設定ファイルの各セクションで設定する内容を表形式で説明します。表の「引数」列は，jr3slgetコマンドでも指定できる設定値の場合，コマンドで指定する際の引数を示します。「－」は，コマンドでは指定できない項目を示します。

(a)　CONNECTセクション

CONNECTセクションでは，コマンド実行時に，SAPシステムとのRFC接続を確立するための情報を指定します。

表5-6　CONNECTセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値
引数

ASHOST
接続先のアプリケーションサーバのホスト名（トランザクションコードSM51で確認できるホスト名）。
1～100バイトの半角英数字。次の形式で指定できる。

hostsファイルに指定されたホスト名

IPアドレス

SAPルーターアドレス

localhost
-h

SYSNR
接続先のアプリケーションサーバホストで識別するためのシステム番号。
0～99
00
-s

CLIENT
接続に利用するユーザーのクライアント名。
0～999
000
-c

USER
接続に利用するユーザー名。※1
1～12バイトの半角英数字。
CPIC
-u

PASSWD
接続に利用するユーザーのパスワード。※3
1～8バイトの半角文字列。※4
ADMIN
-p

PASSWD2
接続に利用するユーザーの拡張パスワード。※3
1～40バイトの半角文字列。※4
ADMIN
-p2

LANG
接続に利用するユーザーの言語。
SAPシステムで使用されている，2バイトのISO IDまたは1バイトの言語キー。

日本語の場合：JA

英語の場合：EN

なし
-l

CODEPAGE
接続先のUnicode版SAPシステムで文字コードを変換する時に使用するコードページ。
LANGラベルの言語と組み合わせて指定する。※2
なし
-codepage

注※1

このラベルで指定するユーザーには，次の権限を付与しておく必要があります。

表5-7　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目 | 説明 | 値
RFC_TYPE | 保護されるRFCオブジェクトのタイプ | FUGR（汎用グループ）
RFC_NAME | 保護されるRFC名 | *
ACTVT | アクティビティ | 16（実行）

表5-8　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目 | 説明 | 値
EXTCOMPANY | 外部管理ツールの会社名 | HITACHI
EXTPRODUCT | 外部管理ツールのプログラム名 | JP1
INTERFACE | インターフェースID | XAL

また，このラベルで指定するユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

注※2

LANGラベルとCODEPAGEラベルは，次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表5-9　言語とコードページの指定内容の組み合わせ

接続先SAPシステム | 接続言語 | 言語（LANG） | コードページ（CODEPAGE）
Unicode版 | 日本語 | JA | 8000
英語 | EN | 指定する必要はありません。指定する場合は，1100を指定してください。
非Unicode版 | 日本語 | JA | 指定する必要はありません。指定する場合は，8000を指定してください。
英語 | EN | 指定する必要はありません。指定する場合は，1100を指定してください。

LANGラベルの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

CODEPAGEラベルの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。

注※3

PASSWDラベルとPASSWD2ラベルは同時に指定できません。

注※4

接続に利用するユーザーのパスワード，および拡張パスワードは，半角数字(0～9)，半角英字(a～z, A～Z)，および次の半角記号で定義してください。

　!"@△$%&/()=?'`*+~#-_.,;:{[]}¥<>|

　△は，空白文字を示します。

(b)　COMMANDセクション

COMMANDセクションでは，jr3slgetコマンドの作業ディレクトリの情報を指定します。

表5-10　COMMANDセクションに指定できる値

ラベル | 意味 | 指定できる値 | デフォルト値 | 引数
WORKDIR | コマンドの作業ディレクトリ。 | 1～255バイトの半角英数字。相対パスを指定した場合，カレントディレクトリからの相対パスとなる。 | カレントディレクトリ | －

(c)　TRACEセクション

TRACEセクションでは，jr3slgetコマンドの実行履歴が保存されるメッセージログおよびデータログの情報を指定します。

表5-11　TRACEセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値
引数

MSGLOG_LEVEL
アプリケーションのトレース情報を保存するメッセージログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0～4
2
－

MSGLOG_SIZE
メッセージログを取得するファイル容量。

0：システムの最大値※

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
512
－

MSGLOG_DIR
メッセージログファイル（jr3slget.log）の取得先ディレクトリ。
1～255バイトの半角英数字。ファイル名部分のjr3slget.logまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる。
コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）
－

DATALOG_LEVEL
アプリケーションの各種データ情報を保存するデータログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0～4
2
－

DATALOG_SIZE
データログを取得するファイル容量。

0：システムの最大値※

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
512
－

DATALOG_DIR
データログファイル（jr3slget.dat）の取得先ディレクトリ。
1～255バイトの半角英数字。ファイル名部分のjr3slget.datまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる。
コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）
－

注※

32ビットの符号付き整数で示せる0x7FFFFFFF（約2ギガバイト）です。

(d)　TARGETセクション

TARGETセクションでは，抽出対象のシステムログ情報を特定するための情報を指定します。

表5-12　TARGETセクションに指定できる値

ラベル | 意味 | 指定できる値 | デフォルト値 | 引数
SERVER | SAPインスタンス名（トランザクションコードSM51で確認できる，ダイアログサービスを持つSAPインスタンス名）。 | 1～20バイトの半角英数字。 | （なし） | -server

(e)　FORMATセクション

FORMATセクションでは，出力されるシステムログ情報の出力形式を指定します。

表5-13　FORMATセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値
引数

COLUMN
出力されるシステムログ情報の出力形式。
フィールドID。フィールドIDについては，「10.　コマンド」を参照のこと。
列1：<TIME>
列2：<INSTANCE>
列3：<USER>
列4：<PROGRAM>
列5：<MSGNO>
列6：<MSGTEXT>
－

(f)　EXTRACTFILEセクション

EXTRACTFILEセクションでは，システムログ情報の出力ファイルの情報を指定します。

表5-14　EXTRACTFILEセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値
引数

SIZE
出力ファイル容量。

0：システムの最大値※1

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
1024
－

X2PATH
jr3slgetコマンドの-x2オプションで，ログファイル出力を指定したときに適用されるログファイルのパス。※2
1～255バイトの半角英数字。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）。
SYSLOG
－

注※1

32ビットの符号付き整数で示せる0x7FFFFFFF（約2ギガバイト）です。

注※2

指定の出力ファイルと同じディレクトリに，出力ファイル名.ofsという名称で管理ファイルが作成されます。（例：出力ファイル名としてSYSLOGを指定したときSYSLOGファイルとは別にSYSLOG.ofsファイルが管理ファイルとして作成されます）出力ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

6.　CCMSアラート情報の抽出

この章では，PFM - Agent for Enterprise Applicationsで，CCMSアラート情報を抽出する方法について説明します。

＜この章の構成＞

6.1　CCMSアラート情報抽出機能の概要

6.2　CCMSアラート情報の抽出

6.3　環境パラメーター設定ファイル

6.4　コマンド実行によるCCMSアラート情報の抽出

6.1　CCMSアラート情報抽出機能の概要

PFM - Agent for Enterprise Applicationsで，CCMSの警告モニター内で発生する警告（アラート情報）を定期的にテキストファイルに出力できます。PFM - Agent for Enterprise ApplicationsのCCMSアラート情報抽出機能を使用すると，次のようなCCMSアラート情報をテキストファイルに出力できます。

アラートID

アラートに関連づけられているMTEのID

アラートの重要度

一般プロパティ

メッセージ

テキストファイルに出力されたCCMSアラート情報は，ほかのプログラムと連携することで，SAPシステムの障害情報の監視に利用できます。ここでは，JP1/BaseとJP1/IM - Viewとの連携による障害監視の例を説明します。

JP1/Baseのログファイルトラップ機能を使用すると，CCMSアラート情報をJP1イベントに変換できます。このJP1イベントをJP1/IM - Viewから監視することで，SAPシステムの障害情報をJP1/IM - Viewから監視できるようになります。

JP1/BaseおよびJP1/IM - Viewと連携してSAPシステムの障害を監視する例を，次の図に示します。

図6-1　JP1/BaseおよびJP1/IM - Viewと連携してSAPシステムの障害を監視する例

注意事項

PFM - Agent for Enterprise ApplicationsがCCMSアラート情報を出力するテキストファイルは，一定の容量に達すると先頭から再びデータを上書きする形式のラップアラウンドファイルであり，ファイルの先頭に管理情報として1行のヘッダーがあります。そのため，JP1/Baseのログファイルトラップ機能を使用して本ファイルを監視する場合には，ログファイルトラップ機能の動作定義ファイルに下記のパラメーターを指定してください。

FILETYPE=WRAP1
HEADLINE=1

6.2　CCMSアラート情報の抽出

SAPシステムのCCMSアラート情報を抽出する方法および出力例について説明します。

CCMSアラート情報を抽出するには，CCMS Alert Monitor Command（PD_ALMX）レコードのパフォーマンスデータをStoreデータベースに格納するように設定します。CCMS Alert Monitor Command（PD_ALMX）レコードのパフォーマンスデータを収集するごとに，CCMSアラート情報が自動的に抽出されます。前回のレコード収集時刻をタイムスタンプファイルに記録し，この時刻よりもあとに発生したCCMSアラート情報だけを抽出します。SAPシステムのCCMSアラート情報は，デフォルトでは，次のテキストファイルに出力されます。

運用環境 | CCMSアラート情報格納ファイル
Windows | インストール先フォルダ¥agtm¥agent¥インスタンス名¥log¥ALERT
Windows（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥agent¥インスタンス名¥log¥ALERT
UNIX | /opt/jp1pc/agtm/agent/インスタンス名/log/ALERT
UNIX（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/agtm/agent/インスタンス名/log/ALERT

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

CCMS Alert Monitor Command（PD_ALMX）レコードには，処理結果が格納されます。

CCMS Alert Monitor Command（PD_ALMX）レコードについては，「9.　レコード」を参照してください。

SAPシステムのCCMSアラート情報を抽出する流れを次の図に示します。

図6-2　CCMSアラート情報を抽出する流れ

＜この節の構成＞

6.2.1　セットアップ

6.2.2　出力例

6.2.1　セットアップ

SAPシステムのCCMSアラート情報を抽出するためのセットアップ手順を次に示します。

注意

デフォルトで指定されているCCMSアラート情報の出力先ファイル名などを変更したい場合，環境パラメーター設定ファイルを編集したあとにセットアップしてください。環境パラメーター設定ファイルについては，「6.3　環境パラメーター設定ファイル」を参照してください。

PFM - Web Consoleで，CCMS Alert Monitor Command（PD_ALMX）レコードのパフォーマンスデータをStoreデータベースに格納するように設定する。
設定する方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

6.2.2　出力例

SAPシステムのCCMSアラート情報の出力例を次に示します。

6.3　環境パラメーター設定ファイル

ここでは，環境パラメーター設定ファイルについて説明します。

環境パラメーター設定ファイルとはCCMSアラート情報の出力先ファイル名などを設定するファイルです。PFM - Agent for Enterprise Applicationsで，SAPシステムのCCMSアラート情報が抽出される際，このファイルの設定内容を基に抽出されます。

このファイルは，テキストファイルとしてユーザーが作成します。

＜この節の構成＞

6.3.1　設定手順

6.3.2　設定内容

6.3.1　設定手順

環境パラメーター設定ファイルの設定手順を次に示します。

環境パラメーター設定ファイルを開く。
環境パラメーター設定ファイルを次に示します。

運用環境 | 環境パラメーター設定ファイル
Windows | インストール先フォルダ¥agtm¥agent¥インスタンス名¥jr3alget.ini
Windows（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥agtm¥agent¥インスタンス名¥jr3alget.ini
UNIX | /opt/jp1pc/agtm/agent/インスタンス名/jr3alget.ini
UNIX（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/agtm/agent/インスタンス名/jr3alget.ini

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

設定内容を編集する。
環境パラメーター設定ファイルの設定内容を次に示します。次の網掛け部分が修正できます。設定内容については，「6.3.2　設定内容」を参照してください。

環境パラメーター設定ファイルを保存する。

6.3.2　設定内容

環境パラメーター設定ファイルは，次の形式で記述します。

[セクション]
ラベル=値
ラベル=値
：
：
[セクション]
ラベル=値
ラベル=値

注意

行頭および「=」の前後に，空白文字などの余計な文字を設定しないでください。

セクションおよびラベルでは，指定した値の大文字・小文字は区別されません。

行の先頭に「;」を指定すると，その行はコメントとして扱われます。

次に，環境パラメーター設定ファイルの各セクションで設定する内容を表形式で説明します。

＜この項の構成＞

(1)　TARGETセクション

(2)　EXTRACTFILEセクション

(3)　FORMATセクション

(4)　TRACEセクション

(5)　CONNECTセクション

(1)　TARGETセクション

TARGETセクションでは，抽出対象のCCMSアラート情報を特定するための情報を指定します。

表6-1　TARGETセクションに指定できる値

ラベル | 意味 | 指定できる値 | デフォルト値
MONITOR_SET※ | モニターセット名（SAPシステムの警告モニター（トランザクションコードRZ20）で，「CCMS監視セット」として表示される名称）。 | 1～60バイトの半角英数字。 | SAP CCMS Monitor Templates
MONITOR※ | モニター名（SAPシステムの警告モニター（トランザクションコードRZ20）で，CCMS監視セットのツリーに表示される名称）。 | 1～60バイトの半角英数字。 | Entire System

注※

複数の監視対象を指定することはできません。複数のモニターを監視したい場合はSAPシステムのCCMSの機能で監視したいモニターを一つのモニターにまとめて定義します。PFM - Agent for Enterprise Applicationsからはこのモニターを監視するようにしてください。

(2)　EXTRACTFILEセクション

EXTRACTFILEセクションでは，CCMSアラート情報の出力ファイルの情報を指定します。

表6-2　EXTRACTFILEセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値

SIZE
出力ファイル容量。

0：システムの最大値※1

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
1024

X2PATH
出力ファイルのパス。※2※3
1～255バイトの半角英数字。相対パスを指定した場合，インスタンス環境ディレクトリからの相対パスとなる。

Windowsの場合：log¥ALERT

UNIXの場合：log/ALERT

注※1

32ビットの符号付き整数で示せる0x7FFFFFFF（約2ギガバイト）です。

注※2

指定の出力ファイルと同じディレクトリに，出力ファイル名.ofsという名称で管理ファイルが作成されます。（例：出力ファイル名としてALERTを指定したときALERTファイルとは別にALERT.ofsファイルが管理ファイルとして作成されます）出力ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

注※3

デフォルトの格納先から変更した場合，トラブル発生時に資料を採取するjpcrasコマンドでは採取できません。

(3)　FORMATセクション

FORMATセクションでは，出力されるCCMSアラート情報の出力形式を指定します。

表6-3　FORMATセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値

COLUMN
出力されるCCMSアラート情報の出力形式。
フィールドID。フィールドIDについては，「10.　コマンド」を参照のこと。
列1：<ALERTDATE>
列2：<ALERTTIME>
列3：<MTSYSID>
列4：<MTMCNAME>
列5：<OBJECTNAME>
列6：<FIELDNAME>
列7：<VALUE>
列8：<SEVERITY>
列9：<MSG>

TIMEZONE
フィールドID<ALERTDATE>，<ALERTTIME>，<STATCHGDAT>，<STATCHGTIM>で指定された時刻情報に関するタイムゾーン指定。

UTC
UTC（世界標準時）で出力する。

LOCAL
コマンドを実行したユーザーのローカルタイムで出力する。

UTC

(4)　TRACEセクション

TRACEセクションでは，CCMSアラート情報抽出の実行履歴が保存されるメッセージログおよびデータログの情報を指定します。

表6-4　TRACEセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値

MSGLOG_LEVEL
アプリケーションのトレース情報を保存するメッセージログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0～4
2

MSGLOG_SIZE
メッセージログを取得するファイル容量。

0：システムの最大値※

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
512

MSGLOG_DIR
メッセージログファイル（jr3alget.log）の取得先ディレクトリ。
（変更できない）
log

DATALOG_LEVEL
アプリケーションの各種データ情報を保存するデータログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0～4
2

DATALOG_SIZE
データログを取得するファイル容量。

0：システムの最大値※

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
512

DATALOG_DIR
データログファイル（jr3alget.dat）の取得先ディレクトリ。
（変更できない）
log

注※

32ビットの符号付き整数で示せる0x7FFFFFFF（約2ギガバイト）です。

(5)　CONNECTセクション

CONNECTセクションでは，SAPシステムとのRFC接続を確立するための情報を指定します。

表6-5　CONNECTセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値

LANG
接続に利用するユーザーの言語
SAPシステムで使用されている，2バイトのISO IDまたは1バイトの言語キー

日本語の場合：JA

英語の場合：EN

なし

CODEPAGE
接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページ
LANGラベルの言語と組み合わせて指定する※
なし

注※

LANGラベルとCODEPAGEラベルは，次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表6-6　言語とコードページの指定内容の組み合わせ

接続先
SAPシステム
接続言語
言語
（LANG）
コードページ（CODEPAGE）

Unicode版
日本語
JA
8000

英語
EN
指定する必要はありません。指定する場合は，1100を指定してください。

非Unicode版
日本語
JA
指定する必要はありません。指定する場合は，8000を指定してください。

英語
EN
指定する必要はありません。指定する場合は，1100を指定してください。

LANGラベルの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

CODEPAGEラベルの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。

6.4　コマンド実行によるCCMSアラート情報の抽出

jr3algetコマンドを手動実行，またはほかのプログラムでjr3algetコマンドを自動実行して，SAPシステムのCCMSアラート情報を抽出することもできます。ここでは，jr3algetコマンド実行によるCCMSアラート情報の抽出方法を説明します。

＜この節の構成＞

6.4.1　コマンドを実行する前に

6.4.2　コマンド実行によるCCMSアラート情報の抽出方法

6.4.3　コマンドを実行してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイル

6.4.1　コマンドを実行する前に

jr3algetコマンドを実行してSAPシステムのCCMSアラート情報を抽出する前に，次のことを確認してください。

環境パラメーター設定ファイルの設定内容
この場合の環境パラメーター設定ファイルは，CCMS Alert Monitor Command（PD_ALMX）レコードを使用してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイルとは異なります。この場合に使用する環境パラメーター設定ファイルについては，「6.4.3　コマンドを実行してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイル」を参照してください。

コマンドの実行環境
次のことについて確認してください。

ネットワークの設定に問題がないか

SAPシステムが稼働しているか

SAPシステムがRFC要求を受け付けられる状態にあるか

6.4.2　コマンド実行によるCCMSアラート情報の抽出方法

jr3algetコマンドを手動実行，またはほかのプログラムでjr3algetコマンドを自動実行して，SAPシステムのCCMSアラート情報を抽出する場合，抽出するCCMSアラート情報を次のように選定できます。

コマンドを実行した日に出力されたすべてのCCMSアラート情報を抽出する

前回のコマンド実行時以降に出力されたCCMSアラート情報だけを抽出する

jr3algetコマンドについては，「10.　コマンド」を参照してください。

注意

CCMSアラート情報は，SAPシステム内で一つのリソースとして扱われていて，どのアプリケーションサーバからも参照できるため，接続先のアプリケーションサーバは，任意です。一つのSAPシステムにつき，一つだけコマンドを実行するようにしてください。

すでに環境パラメーター設定ファイルで設定したパラメーターの値を，jr3algetコマンドでも指定した場合，コマンドで指定した値が優先されます。

次にそれぞれの方法について説明します。

＜この項の構成＞

(1)　コマンドを実行した日に出力されたすべてのCCMSアラート情報を抽出する

(2)　前回のコマンド実行時以降に出力されたCCMSアラート情報だけを抽出する

(1)　コマンドを実行した日に出力されたすべてのCCMSアラート情報を抽出する

コマンドを実行した日に出力されたすべてのCCMSアラート情報を抽出する場合のコマンドの指定例を次に示します（環境パラメーター設定ファイルでCONNECTセクションの値およびTARGETセクションの値を定義済み）。

jr3alget

(2)　前回のコマンド実行時以降に出力されたCCMSアラート情報だけを抽出する

前回のコマンド実行時以降に出力されたCCMSアラート情報だけを抽出する場合，-lasttimeオプションで，タイプスタンプファイルを指定してコマンドを実行します。タイムスタンプファイルには，jr3algetコマンドの実行日時の履歴が格納されています。そのため，同じタイムスタンプファイルを指定して，コマンドを繰り返し実行すると，CCMSアラート情報を連続かつ重複しないで抽出できます。

注意

-lasttimeオプションの初回実行時に，指定したタイムスタンプファイルが存在しない場合，新規に作成されます。-lasttimeオプション初回実行時は，CCMSアラート情報が報告されません。

前回のコマンド実行時以降に出力されたCCMSアラート情報だけを抽出する場合のコマンドの指定例を次に示します（環境パラメーター設定ファイルでCONNECTセクションの値およびTARGETセクションの値を定義済み）。

jr3alget -lasttime altimestamp.txt

6.4.3　コマンドを実行してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイル

jr3algetコマンド実行時に，引数として環境パラメーター設定ファイルを指定すると，ファイルの設定内容を基に，SAPシステムのCCMSアラート情報が抽出されます。

このファイルは，テキストファイルとしてユーザーが作成します。

＜この項の構成＞

(1)　設定手順

(2)　設定内容

(1)　設定手順

環境パラメーター設定ファイルの設定手順を次に示します。

環境パラメーター設定ファイルのサンプルファイルを「jr3alget.ini」の名前でコピーする。
この「jr3alget.ini」が，デフォルトの環境パラメーター設定ファイルとなります。環境パラメーター設定ファイルのサンプルファイルを次に示します。

Windowsの場合

インストール先フォルダ¥agtm¥evtrap¥jr3alget.ini.sample

UNIXの場合

/opt/jp1pc/agtm/evtrap/jr3alget.ini.sample

jr3alget.iniを開く。

設定内容を編集する。
デフォルトの環境パラメーター設定ファイルの設定内容を次に示します。設定内容については，「(2)　設定内容」を参照してください。

コメント行を表す「;」が行頭にある項目は，デフォルトでは設定が有効になっていません。設定を有効にするには，コメント行を表す「;」を外してください。

環境パラメーター設定ファイルを保存する。
jr3algetコマンド実行時に-cnfオプションを指定することで，環境パラメーター設定ファイルの内容を基にSAPシステムのCCMSアラート情報が抽出されます。

(2)　設定内容

環境パラメーター設定ファイルは，次の形式で記述します。

[セクション]
ラベル=値
ラベル=値
：
：
[セクション]
ラベル=値
ラベル=値

注意

行頭および「=」の前後に，空白文字などの余計な文字を設定しないでください。

セクションおよびラベルでは，指定した値の大文字・小文字は区別されません。

行の先頭に「;」を指定すると，その行はコメントとして扱われます。

次に，環境パラメーター設定ファイルの各セクションで設定する内容を表形式で説明します。表の「引数」列は，jr3algetコマンドでも指定できる設定値の場合，コマンドで指定する際の引数を示します。「－」は，コマンドでは指定できない項目を示します。

(a)　CONNECTセクション

CONNECTセクションでは，コマンド実行時に，SAPシステムとのRFC接続を確立するための情報を指定します。

表6-7　CONNECTセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値
引数

ASHOST
接続先のアプリケーションサーバのホスト名（トランザクションコードSM51で確認できるホスト名）。
1～100バイトの半角英数字。次の形式で指定できる。

hostsファイルに指定されたホスト名

IPアドレス

SAPルーターアドレス

localhost
-h

SYSNR
接続先のアプリケーションサーバホストで識別するためのシステム番号。
0～99
00
-s

CLIENT
接続に利用するユーザーのクライアント名。
0～999
000
-c

USER
接続に利用するユーザー名。※1
1～12バイトの半角英数字。
CPIC
-u

PASSWD
接続に利用するユーザーのパスワード。※3
1～8バイトの半角文字列。※4
ADMIN
-p

PASSWD2
接続に利用するユーザーの拡張パスワード。※3
1～40バイトの半角文字列。※4
ADMIN
-p2

LANG
接続に利用するユーザーの言語。
SAPシステムで使用されている，2バイトのISO IDまたは1バイトの言語キー。

日本語の場合：JA

英語の場合：EN

なし
-l

CODEPAGE
接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページ。
LANGラベルの言語と組み合わせて指定する。※2
なし
-codepage

注※1

このラベルで指定するユーザーには，次の権限を付与しておく必要があります。

表6-8　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目 | 説明 | 値
RFC_TYPE | 保護されるRFCオブジェクトのタイプ | FUGR（汎用グループ）
RFC_NAME | 保護されるRFC名 | *
ACTVT | アクティビティ | 16（実行）

表6-9　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目 | 説明 | 値
EXTCOMPANY | 外部管理ツールの会社名 | HITACHI
EXTPRODUCT | 外部管理ツールのプログラム名 | JP1
INTERFACE | インターフェースID | XAL

また，このラベルで指定するユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

注※2

LANGラベルとCODEPAGEラベルは，次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表6-10　言語とコードページの指定内容の組み合わせ

接続先
SAPシステム
接続言語
言語
（LANG）
コードページ（CODEPAGE）

Unicode版
日本語
JA
8000

英語
EN
指定する必要はありません。指定する場合は，1100を指定してください。

非Unicode版
日本語
JA
指定する必要はありません。指定する場合は，8000を指定してください。

英語
EN
指定する必要はありません。指定する場合は，1100を指定してください。

LANGラベルの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

CODEPAGEラベルの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。

注※3

PASSWDラベルとPASSWD2ラベルは同時に指定できません。

注※4

接続に利用するユーザーのパスワード，および拡張パスワードは，半角数字(0～9)，半角英字(a～z, A～Z)，および次の半角記号で定義してください。

　!"@△$%&/()=?'`*+~#-_.,;:{[]}¥<>|

　△は，空白文字を示します。

(b)　COMMANDセクション

COMMANDセクションでは，jr3algetコマンドの作業ディレクトリの情報を指定します。

表6-11　COMMANDセクションに指定できる値

ラベル | 意味 | 指定できる値 | デフォルト値 | 引数
WORKDIR | コマンドの作業ディレクトリ。 | 1～255バイトの半角英数字。相対パスを指定した場合，カレントディレクトリからの相対パスとなる。 | カレントディレクトリ | －

(c)　TRACEセクション

TRACEセクションでは，jr3algetコマンドの実行履歴が保存されるメッセージログおよびデータログの情報を指定します。

表6-12　TRACEセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値
引数

MSGLOG_LEVEL
アプリケーションのトレース情報を保存するメッセージログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0～4
2
－

MSGLOG_SIZE
メッセージログを取得するファイル容量。

0：システムの最大値※

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
512
－

MSGLOG_DIR
メッセージログファイル（jr3alget.log）の取得先ディレクトリ。
1～255バイトの半角英数字。ファイル名部分のjr3alget.logまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる。
コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）
－

DATALOG_LEVEL
アプリケーションの各種データ情報を保存するデータログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0～4
2
－

DATALOG_SIZE
データログを取得するファイル容量。

0：システムの最大値※

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
512
－

DATALOG_DIR
データログファイル（jr3alget.dat）の取得先ディレクトリ。
1～255バイトの半角英数字。ファイル名部分のjr3alget.datまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる。
コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）
－

注※

32ビットの符号付き整数で示せる0x7FFFFFFF（約2ギガバイト）です。

(d)　TARGETセクション

TARGETセクションでは，抽出対象のCCMSアラート情報を特定するための情報を指定します。

表6-13　TARGETセクションに指定できる値

ラベル | 意味 | 指定できる値 | デフォルト値 | 引数
MONITOR_SET | モニターセット名（詳細は-msオプションを参照）。 | 1～60バイトの半角英数字。 | SAP CCMS Technical Expert Monitors | -ms
MONITOR | モニター名（詳細は-mnオプションを参照）。 | 1～60バイトの半角英数字。 | All Monitoring Contexts | -mn

(e)　FORMATセクション

FORMATセクションでは，出力されるCCMSアラート情報の出力形式を指定します。

表6-14　FORMATセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値
引数

COLUMN
出力されるCCMSアラート情報の出力形式。
フィールドID。フィールドIDについては，「10.　コマンド」を参照のこと。
列1：<ALERTDATE>
列2：<ALERTTIME>
列3：<MTSYSID>
列4：<MTMCNAME>
列5：<OBJECTNAME>
列6：<FIELDNAME>
列7：<VALUE>
列8：<SEVERITY>
列9：<MSG>
－

TIMEZONE
フィールドID<ALERTDATE>，<ALERTTIME>，<STATCHGDAT>，<STATCHGTIM>で指定された時刻情報に関するタイムゾーン指定。

UTC
UTC（世界標準時）で出力する。

LOCAL
コマンドを実行したユーザーのローカルタイムで出力する。

UTC
TIMEZONE

(f)　EXTRACTFILEセクション

EXTRACTFILEセクションでは，CCMSアラート情報の出力ファイルの情報を指定します。

表6-15　EXTRACTFILEセクションに指定できる値

ラベル
意味
指定できる値
デフォルト値
引数

SIZE
出力ファイル容量。

0：システムの最大値※1

1～65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0～65535
1024
－

X2PATH
jr3algetコマンドの-x2オプションで，ログファイル出力を指定したときに適用されるログファイルのパス。※2
1～255バイトの半角英数字。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）。
ALERT
－

注※1

32ビットの符号付き整数で示せる0x7FFFFFFF（約2ギガバイト）です。

注※2

指定の出力ファイルと同じディレクトリに，出力ファイル名.ofsという名称で管理ファイルが作成されます。（例：出力ファイル名としてALERTを指定したときALERTファイルとは別にALERT.ofsファイルが管理ファイルとして作成されます）出力ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

7.　モニター情報の収集

この章では，PFM - Agent for Enterprise Applicationsで，SAPシステムのモニター情報を収集する方法について説明します。

＜この章の構成＞

7.1　モニター情報収集の概要

7.2　モニター情報収集の設定

7.1　モニター情報収集の概要

PFM - Agent for Enterprise Applicationsでは，SAPシステムのモニター情報を，ユーザーの定義に基づいて収集できます。

SAPシステムのモニター情報は，CCMSモニタリングアーキテクチャーによって管理されているSAPシステムの稼働性能情報です。個々の稼働性能情報は，モニターセットおよびモニターと呼ばれるツリー構造で階層的に管理されています。

このモニターセットおよびモニターに定義されている稼働性能情報のうち，パフォーマンス属性を持つ項目とその値を，PFM - Agent for Enterprise Applicationsのレコードおよびフィールドにマッピングして，パフォーマンスデータを収集し，PFM - Agent for Enterprise Applicationsのユーザー定義レコードとして格納できます。

ユーザー定義レコードは，PFM - Agent for Enterprise ApplicationsのUser defined Monitor (Perf.)（PI_UMP）レコードとして管理されます。複数のパフォーマンスデータを収集する場合，パフォーマンスデータごとにユーザーレコードのフィールドが1行ずつ追加されます。その結果，それぞれのユーザーレコードは，複数行のレコードになります。複数行のレコードとは，複数インスタンスレコードのことです。

レコードの詳細については，「9.　レコード」を参照してください。

7.2　モニター情報収集の設定

SAPシステムのモニター情報を収集するために，次の項目を設定します。

モニターセット名およびモニター名の設定

パフォーマンスデータ収集の設定

SAPシステムのモニター情報を収集する流れを次の図に示します。

図7-1　SAPシステムのモニター情報を収集する流れ

＜この節の構成＞

7.2.1　モニターセット名およびモニター名の設定

7.2.2　パフォーマンスデータ収集の設定

7.2.1　モニターセット名およびモニター名の設定

モニターセット名およびモニター名を，PFM - Web Console から設定する手順を次に示します。

この操作は，管理ユーザー権限を持つPerformance Managementユーザーが実行してください。

PFM - Web Consoleにログインする。
PFM - Web Consoleへのログイン方法の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

メイン画面のナビゲーションフレームで，［エージェント階層］タブを選択する。

［エージェント階層］画面のナビゲーションフレームで，SAPシステムのモニター情報を収集したいエージェントを選択する。
選択したエージェントにチェックマークが表示されます。

メソッドフレームで，［プロパティの表示］メソッドを選択する。
［プロパティの表示］画面が表示されます。

［Agent］ - ［PI_UMP］フォルダをクリックする。
モニターセット名およびモニター名の設定値が表示されます。

［MONITOR_SET］および［MONITOR］の［値］を設定する。
収集したいSAPシステムのモニター情報のモニターセット名およびモニター名を設定します。指定できる文字は，1～60バイトの半角英数字です。
モニターセット名およびモニター名は，トランザクションコードRZ20などで確認できます。なお，設定値の大文字・小文字は区別されます。

［OK］ボタンをクリックする。
設定が有効になります。

7.2.2　パフォーマンスデータ収集の設定

SAPシステムのモニターの情報を収集したパフォーマンスデータを，Storeデータベースに格納する手順を次に示します。

この操作は，管理ユーザー権限を持つPerformance Managementユーザーが実行してください。

PFM - Web Consoleで，User defined Monitor (Perf.)（PI_UMP）レコードのパフォーマンスデータをStoreデータベースに格納するように設定する。
設定する方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

注意

1回のパフォーマンスデータの収集で取得できるレコード数の上限値は，4,096です。レコード数が上限値を超えた場合，超えた分のレコードは切り捨てられます。

8.　ソリューションセット

この章では，PFM - Agent for Enterprise Applicationsのソリューションセットについて説明します。

＜この章の構成＞

ソリューションセットの概要

アラームの記載形式

アラーム一覧

Buffer - CUA

Buffer - FieldDescri

Buffer - GenericKey

Buffer - InitialReco

Buffer - Program

Buffer - Screen

Buffer - ShortNameTA

Buffer - SingleRecor

Buffer - TableDefini

Dialog ResponseTime

Extended Memory

Heap Memory

Paging Area

Roll Area

レポートの記載形式

レポートのフォルダ構成

レポート一覧

Dialog ResponseTime

Dialog ResponseTime Status

Dialog ResponseTime Trend（時単位の履歴レポート）

Dialog ResponseTime Trend（日単位の履歴レポート）

Dialog ResponseTime Trend(Multi-Agent)

Process Detail

Process Overview Status

SAP Buffer Detail(CUA)

SAP Buffer Detail(FieldDescription)

SAP Buffer Detail(GenericKey)

SAP Buffer Detail(InitialRecords)

SAP Buffer Detail(Program)

SAP Buffer Detail(Screen)

SAP Buffer Detail(ShortNameTAB)

SAP Buffer Detail(SingleRecord)

SAP Buffer Detail(TableDefinition)

SAP Buffer Hitratio

SAP Buffer Hitratio Status

SAP Buffer Hitratio Trend（時単位の履歴レポート）

SAP Buffer Hitratio Trend（日単位の履歴レポート）

SAP Memory Detail

SAP Memory Used

SAP Memory Used Status

SAP Memory Used Trend（時単位の履歴レポート）

SAP Memory Used Trend（日単位の履歴レポート）

UsersLoggedIn Trend（時単位の履歴レポート）

UsersLoggedIn Trend（日単位の履歴レポート）

UsersLoggedIn Trend(Multi-Agent)

ソリューションセットの概要

Performance Managementでは，アラームとレポートを定義する場合，次の方法があります。

PFM - Agentで定義されているアラームやレポートをそのまま使用する

PFM - Agentで定義されているアラームやレポートをコピーしてカスタマイズする

ウィザードを使用して新規に定義する

PFM - Agentで用意されているアラームやレポートを「ソリューションセット」と呼びます。ソリューションセットのレポートとアラームは，必要な情報があらかじめ定義されているので，コピーしてそのまま使用したり，ユーザーの環境に合わせてカスタマイズしたりできます。そのため，ウィザードを使用して新規に定義をしなくても，監視対象の運用状況を監視する準備が容易にできるようになります。

この章では，PFM - Agent for Enterprise Applicationsで定義されているソリューションセットのアラームとレポートの設定内容について説明します。

ソリューションセットの使用方法の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，アラームによる稼働監視および稼働分析のためのレポートの作成について説明している章を参照してください。

アラームの記載形式

ここでは，アラームの記載形式を示します。アラームは，アルファベット順に記載しています。

アラーム名

ソリューションセットのアラーム名を示します。

概要

このアラームで監視できる監視対象の概要について説明します。

主な設定

このアラームの主な設定値を表で説明します。この表では，アラームの設定値と，PFM - Web Consoleの［アラーム階層］］タブでアラームアイコンをクリックし，［プロパティの表示］メソッドをクリックしたときに表示される，［プロパティ］画面の設定項目との対応を示しています。各アラームの設定の詳細については，PFM - Web Consoleのアラームの［プロパティ］画面で確認してください。

設定値の「－」は，設定が常に無効であることを示します。

なお，条件式で異常条件と警告条件が同じ場合は，アラームイベントは異常のものだけが発行されます。

関連レポート

このアラームに関連する，ソリューションセットのレポートを示します。PFM - Web Consoleの［エージェント階層］タブでエージェントアイコンをクリックし，［アラームの状態の表示］メソッドで表示される[図データ]アイコンをクリックすると，このレポートを表示できます。

なお，PFM - Web Consoleの画面でレポート階層を確認する場合は，Reports/で始まるパスをSystem Reports/と読みかえてください。

アラーム一覧

PFM - Agent for Enterprise Applicationsのソリューションセットで定義されているアラームは，「PFM SAP System Solution Alarms 8.50」というアラームテーブルにまとめられています。「8.50」は，アラームテーブルのバージョンを示します。このアラームテーブルは，PFM - Web Consoleの［アラーム階層］タブに表示される「SAP System」フォルダに格納されています。ソリューションセットで定義されているアラームを次の表に示します。

表8-1　アラーム一覧（ソリューションセット）

アラーム名 | 監視対象
Buffer - CUA | SAPバッファ（CUAバッファ）のヒット率。
Buffer - FieldDescri | SAPバッファ（Field descriptionバッファ）のヒット率。
Buffer - GenericKey | SAPバッファ（Generic keyバッファ）のヒット率。
Buffer - InitialReco | SAPバッファ（Initial recordsバッファ）のヒット率
Buffer - Program | SAPバッファ（Programバッファ）のヒット率。
Buffer - Screen | SAPバッファ（Screenバッファ）のヒット率。
Buffer - ShortNameTA | SAPバッファ（Short nametabバッファ）のヒット率。
Buffer - SingleRecor | SAPバッファ（Single recordバッファ）のヒット率。
Buffer - TableDefini | SAPバッファ（Table definitionバッファ）のヒット率。
Dialog ResponseTime | ダイアログタスクでの応答時間。
Extended Memory | 拡張メモリーの使用率。
Heap Memory | ヒープメモリーの使用率。
Paging Area | ページング領域の使用率。
Roll Area | ロール領域の使用率。

Buffer - CUA

概要

Buffer - CUAアラームは，SAPバッファ（CUAバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
CUA HitRatio %

異常条件
CUA HitRatio % < 60

警告条件
CUA HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Buffer - FieldDescri

概要

Buffer - FieldDescriアラームは，SAPバッファ（Field descriptionバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
FieldDescription HitRatio %

異常条件
FieldDescription HitRatio % < 60

警告条件
FieldDescription HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Buffer - GenericKey

概要

Buffer - GenericKeyアラームは，SAPバッファ（Generic keyバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
GenericKey HitRatio %

異常条件
GenericKey HitRatio % < 60

警告条件
GenericKey HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Buffer - InitialReco

概要

Buffer - InitialRecoアラームは，SAPバッファ（Initial recordsバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
InitialRecords HitRatio %

異常条件
InitialRecords HitRatio % < 60

警告条件
InitialRecords HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Buffer - Program

概要

Buffer - Programアラームは，SAPバッファ（Programバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
Program HitRatio %

異常条件
Program HitRatio % < 60

警告条件
Program HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Buffer - Screen

概要

Buffer - Screenアラームは，SAPバッファ（Screenバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
Screen HitRatio %

異常条件
Screen HitRatio % < 60

警告条件
Screen HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Buffer - ShortNameTA

概要

Buffer - ShortNameTAアラームは，SAPバッファ（Short nametabバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
ShortNameTAB HitRatio %

異常条件
ShortNameTAB HitRatio % < 60

警告条件
ShortNameTAB HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Buffer - SingleRecor

概要

Buffer - SingleRecorアラームは，SAPバッファ（Single recordバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
SingleRecord HitRatio %

異常条件
SingleRecord HitRatio % < 60

警告条件
SingleRecord HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Buffer - TableDefini

概要

Buffer - TableDefiniアラームは，SAPバッファ（Table definitionバッファ）のヒット率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
TableDefinition HitRatio %

異常条件
TableDefinition HitRatio % < 60

警告条件
TableDefinition HitRatio % < 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Buffer Hitratio

Dialog ResponseTime

概要

Dialog ResponseTimeアラームは，ダイアログタスクでの応答時間を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
ResponseTime

異常条件
ResponseTime > 3000

警告条件
ResponseTime > 2000

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/Dialog ResponseTime

Extended Memory

概要

Extended Memoryアラームは，拡張メモリーの使用率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
EsAct %

異常条件
EsAct % > 95

警告条件
EsAct % > 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Memory Used

Heap Memory

概要

Heap Memoryアラームは，ヒープメモリーの使用率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
HeapAct %

異常条件
HeapAct % > 95

警告条件
HeapAct % > 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Memory Used

Paging Area

概要

Paging Areaアラームは，ページング領域の使用率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
R3PagingUsed %

異常条件
R3PagingUsed % > 95

警告条件
R3PagingUsed % > 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Memory Used

Roll Area

概要

Roll Areaアラームは，ロール領域の使用率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
WorkLoad Summary Interval（PI）

フィールド
R3RollUsed %

異常条件
R3RollUsed % > 95

警告条件
R3RollUsed % > 80

関連レポート

Reports/SAP System/SAP Basis/Web Application Server/Troubleshooting/Recent Past/SAP Memory Used

レポートの記載形式

ここでは，レポートの記載形式を示します。レポートは，アルファベット順に記載しています。

レポート名

ソリューションセットのレポート名を示します。

レポート名に「(Multi-Agent)」が含まれるレポートは，複数のインスタンスについて情報を表示するレポートです。

レポート名に「(Multi-Agent)」が含まれないレポートは，単一のインスタンスについて情報を表示するレポートです。

概要

このレポートで表示できる情報の概要について説明します。

格納先

このレポートの格納先を示します。

なお，PFM - Web Consoleの画面でレポート階層を確認する場合は，Reports/で始まるパスをSystem Reports/と読みかえてください。

レコード

このレポートで使用するパフォーマンスデータが，格納されているレコードを示します。履歴レポートを表示するためには，この欄に示すレコードを収集するように，あらかじめ設定しておく必要があります。レポートを表示する前に，PFM - Web Consoleの［エージェント階層］タブでエージェントアイコンをクリックし，［プロパティの表示］メソッドをクリックして表示される［プロパティ］画面で，このレコードが「Log = Yes」に設定されているか確認してください。リアルタイムレポートの場合，設定する必要はありません。

フィールド

このレポートで使用するレコードのフィールドについて，表で説明します。

ドリルダウンレポート（レポートレベル）

このレポートに関連づけられた，ソリューションセットのレポートを表で説明します。このドリルダウンレポートを表示するには，PFM - Web Consoleのレポートウィンドウのドリルダウンレポートドロップダウンリストから，該当するドリルダウンレポート名を選択し，［レポートの表示］をクリックしてください。なお，レポートによってドリルダウンレポートを持つものと持たないものがあります。

ドリルダウンレポート（フィールドレベル）

このレポートのフィールドに関連づけられた，ソリューションセットのレポートを表で説明します。このドリルダウンレポートを表示するには，PFM - Web Consoleのレポートウィンドウのグラフ，一覧，または表をクリックしてください。履歴レポートの場合，時間項目からドリルダウンレポートを表示することで，より詳細な時間間隔でレポートを表示できます。なお，レポートによってドリルダウンレポートを持つものと持たないものがあります。

ドリルダウンレポートについての詳細は，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働分析のためのレポートの作成について説明している章を参照してください。

レポートのフォルダ構成

PFM - Agent for Enterprise Applicationsのレポートのフォルダ構成を次に示します。<　>内は，フォルダ名を示します。

<SAP System>
+-- <SAP Basis/Web Application Server>
    +-- <Monthly Trend>
    |    +-- Dialog ResponseTime Trend
    |    +-- Dialog ResponseTime Trend(Multi-Agent)
    |    +-- SAP Buffer Hitratio Trend
    |    +-- SAP Memory Used Trend
    |    +-- UsersLoggedIn Trend
    |    +-- UsersLoggedIn Trend(Multi-Agent)
    +-- <Status Reporting>
    |    +-- <Daily Trend>
    |    |    +-- Dialog ResponseTime Trend
    |    |    +-- SAP Buffer Hitratio Trend
    |    |    +-- SAP Memory Used Trend
    |    |    +-- UsersLoggedIn Trend
    |    +-- <Real-Time>
    |         +-- Dialog ResponseTime Status
    |         +-- Process Overview Status
    |         +-- SAP Buffer Hitratio Status
    |         +-- SAP Memory Used Status
    |         +-- <Drilldown Only>
    |             +--  SAP Buffer Detail(CUA)
    |             +--  SAP Buffer Detail(FieldDescription)
    |             +--  SAP Buffer Detail(GenericKey)
    |             +--  SAP Buffer Detail(InitialRecords)
    |             +--  SAP Buffer Detail(Program)
    |             +--  SAP Buffer Detail(Screen)
    |             +--  SAP Buffer Detail(ShortNameTAB)
    |             +--  SAP Buffer Detail(SingleRecord)
    |             +--  SAP Buffer Detail(TableDefinition)
    |             +--  SAP Memory Detail
    +-- <Troubleshooting>
         +-- <Real-Time>
         +-- <Recent Past>
              +-- Dialog ResponseTime
              +-- SAP Buffer Hitratio
              +-- SAP Memory Used
              +-- <Drilldown Only>
                   +-- Process Detail

各フォルダの説明を次に示します。

「Monthly Trend」フォルダ
最近1か月間の1日ごとに集計された情報を表示するレポートが格納されています。1か月のシステムの傾向を分析するために使用します。

「Status Reporting」フォルダ
日，または週ごとに集計された情報を表示するレポートが格納されています。システムの総合的な状態を見るために使用します。また，履歴レポートのほかにリアルタイムレポートの表示もできます。

「Daily Trend」フォルダ
最近24時間の1時間ごとに集計された情報を表示するレポートが格納されています。1日ごとにシステムの状態を確認するために使用します。

「Real-Time」フォルダ
システムの状態を確認するためのリアルタイムレポートが格納されています。

「Troubleshooting」フォルダ
トラブルを解決するのに役立つ情報を表示するレポートが格納されています。システムに問題が発生した場合，問題の原因を調査するために使用します。

「Real-Time」フォルダ
現在のシステムの状態を確認するためのリアルタイムレポートが格納されています。

「Recent Past」フォルダ
最近1時間の1分ごとに集計された情報を表示する履歴レポートが格納されています。

さらに，これらのフォルダの下位には，次のフォルダがある場合があります。

「Drilldown Only」フォルダ
ドリルダウンレポート（フィールドレベル）として表示されるレポートが格納されています。そのレポートのフィールドに関連する詳細な情報を表示するために使用します。

レポート一覧

ソリューションセットで定義されているレポートをアルファベット順に次の表に示します。

表8-2　レポート一覧

カテゴリー | レポート名 | 表示する情報
応答時間 | Dialog ResponseTime | 最近1時間のダイアログタスクの応答時間に問題が発生したときの分析レポート。
Dialog ResponseTime Status | ダイアログタスクでの応答時間の概要。
Dialog ResponseTime Trend（時単位の履歴レポート） | 最近24時間のダイアログタスクでの応答時間の傾向（時単位）。
Dialog ResponseTime Trend（日単位の履歴レポート） | 最近1か月間のダイアログタスクでの応答時間の傾向（日単位）。
Dialog ResponseTime Trend(Multi-Agent) | 最近1か月間のダイアログタスクでの応答時間の傾向（アプリケーションサーバ間で比較）。
ワークプロセス | Process Detail | 最近1時間のワークプロセスの活動状態。
Process Overview Status | ワークプロセスの活動状態。
SAPバッファ | SAP Buffer Detail(CUA) | SAPバッファ（CUAバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Detail(FieldDescription) | SAPバッファ（Field descriptionバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Detail(GenericKey) | SAPバッファ（Generic keyバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Detail(InitialRecords) | SAPバッファ（Initial recordsバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Detail(Program) | SAPバッファ（Programバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Detail(Screen) | SAPバッファ（Screenバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Detail(ShortNameTAB) | SAPバッファ（Short nametabバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Detail(SingleRecord) | SAPバッファ（Single recordバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Detail(TableDefinition) | SAPバッファ（Table definitionバッファ）の詳細（ドリルダウンレポート）。
SAP Buffer Hitratio | 最近1時間のSAPバッファのヒット率に問題が発生したときの分析レポート。
SAP Buffer Hitratio Status | SAPバッファのヒット率の概要。
SAP Buffer Hitratio Trend（時単位の履歴レポート） | 最近24時間のSAPバッファのヒット率の傾向（時単位）。
SAP Buffer Hitratio Trend（日単位の履歴レポート） | 最近1か月間のSAPバッファのヒット率の傾向（日単位）。
SAPメモリー | SAP Memory Detail | SAPメモリーの詳細。
SAP Memory Used | 最近1時間のSAPメモリーの使用率に問題が発生したときの分析レポート。
SAP Memory Used Status | SAPメモリーの使用率の概要。
SAP Memory Used Trend（時単位の履歴レポート） | 最近24時間のSAPメモリーの使用率の傾向（時単位）。
SAP Memory Used Trend（日単位の履歴レポート） | 最近1か月間のSAPメモリーの使用率の傾向（日単位）。
ログインユーザー | UsersLoggedIn Trend（時単位の履歴レポート） | 最近24時間のログインユーザー数の傾向（時単位）。
UsersLoggedIn Trend（日単位の履歴レポート） | 最近1か月間のログインユーザー数の傾向（日単位）。
UsersLoggedIn Trend(Multi-Agent) | 最近1か月間のログインユーザー数の傾向（アプリケーションサーバ間で比較）。

Dialog ResponseTime

概要

Dialog ResponseTimeレポートは，ダイアログタスクの応答時間に問題が発生したときの分析レポートです。最近1時間の応答時間の傾向を分単位で表示します。表示形式は，表および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Troubleshooting/Recent Past/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
DBRequestTime | 論理データベース要求を処理するための平均時間。ミリ秒単位。
DialogSteps | 1分当たりの平均ダイアログステップ数。
FrontendResponseTime | 自分の要求が処理されるのをユーザーがフロントエンドで待つ平均時間。つまり，応答時間，ネットワーク転送時間，およびフロントエンド処理時間の合計平均時間。ミリ秒単位。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Load+GenTime | データベースからのソーステキスト，グラフィカルユーザーインターフェース，および画面情報の平均ロードと作成時間。ミリ秒単位。
QueueTime | ディスパッチャー待ち行列での平均待ち時間。ユーザー要求がディスパッチャーキューに入っている平均待ち時間。ミリ秒単位。
ResponseTime | ダイアログステップの処理時間の平均値。ミリ秒単位。ダイアログステップの処理に必要だった全処理時間を含む。データベース処理時間を含むが，ネットワーク転送時間やフロントエンド処理時間は含まれない。
System ID | SAPシステムID。

ドリルダウンレポート（レポートレベル）

レポート名 | 説明
Process Detail | 最近1時間のワークプロセスの活動状態を表示する。

Dialog ResponseTime Status

概要

Dialog ResponseTime Statusレポートは，ダイアログタスクでの応答時間の概要をリアルタイムに表示します。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/

レコード

Dialog Service（PI_DIA）

フィールド

フィールド名 | 説明
FrontendNetTime | フロントエンドからアプリケーションサーバへの最初のデータ転送時と，アプリケーションサーバからフロントエンドへの最後のデータ転送時に，ネットワークで使われる時間。ミリ秒単位。GuiCallBackTimeフィールドの値は含まれていない。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
ResponseTime | ダイアログステップの処理時間の平均値。ミリ秒単位。ダイアログステップの処理に必要だった全処理時間を含む。データベース処理時間を含むが，ネットワーク転送時間やフロントエンド処理時間は含まれない。
ResponseTime:StandardTran. | 標準トランザクションの応答時間。ミリ秒単位。
System ID | SAPシステムID。
UsersLoggedIn | ログインしているユーザー数。

Dialog ResponseTime Trend（時単位の履歴レポート）

概要

Dialog ResponseTime Trendレポートは，最近24時間のダイアログタスクでの応答時間の傾向を時単位で表示します。表示形式は，表および折れ線グラフです。

表示されたデータは，分単位でドリルダウンでき，ある時間帯の，より詳細なデータを表示させることもできます。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Daily Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
DBRequestTime | 論理データベース要求を処理するための平均時間。ミリ秒単位。
DialogSteps | 1分当たりの平均ダイアログステップ数。
FrontendResponseTime | 自分の要求が処理されるのをユーザーがフロントエンドで待つ平均時間。つまり，応答時間，ネットワーク転送時間，およびフロントエンド処理時間の合計平均時間。ミリ秒単位。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Load+GenTime | データベースからのソーステキスト，グラフィカルユーザーインターフェース，および画面情報の平均ロードと作成時間。ミリ秒単位。
QueueTime | ディスパッチャー待ち行列での平均待ち時間。ユーザー要求がディスパッチャーキューに入っている平均待ち時間。ミリ秒単位。
ResponseTime | ダイアログステップの処理時間の平均値。ミリ秒単位。ダイアログステップの処理に必要だった全処理時間を含む。データベース処理時間を含むが，ネットワーク転送時間やフロントエンド処理時間は含まれない。
System ID | SAPシステムID。

Dialog ResponseTime Trend（日単位の履歴レポート）

概要

Dialog ResponseTime Trendレポートは，最近1か月間のダイアログタスクでの応答時間の傾向を日単位で表示します。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Monthly Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
DBRequestTime | 論理データベース要求を処理するための平均時間。ミリ秒単位。
DialogSteps | 1分当たりの平均ダイアログステップ数。
FrontendResponseTime | 自分の要求が処理されるのをユーザーがフロントエンドで待つ平均時間。つまり，応答時間，ネットワーク転送時間，およびフロントエンド処理時間の合計平均時間。ミリ秒単位。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Load+GenTime | データベースからのソーステキスト，グラフィカルユーザーインターフェース，および画面情報の平均ロードと作成時間。ミリ秒単位。
QueueTime | ディスパッチャー待ち行列での平均待ち時間。ユーザー要求がディスパッチャーキューに入っている平均待ち時間。ミリ秒単位。
ResponseTime | ダイアログステップの処理時間の平均値。ミリ秒単位。ダイアログステップの処理に必要だった全処理時間を含む。データベース処理時間を含むが，ネットワーク転送時間やフロントエンド処理時間は含まれない。
System ID | SAPシステムID。

Dialog ResponseTime Trend(Multi-Agent)

概要

Dialog ResponseTime Trend(Multi-Agent)レポートは，最近1か月間のダイアログタスクでの応答時間の傾向を，アプリケーションサーバ間で比較します。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Monthly Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
DBRequestTime | 論理データベース要求を処理するための平均時間。ミリ秒単位。
DialogSteps | 1分当たりの平均ダイアログステップ数。
FrontendResponseTime | 自分の要求が処理されるのをユーザーがフロントエンドで待つ平均時間。つまり，応答時間，ネットワーク転送時間，およびフロントエンド処理時間の合計平均時間。ミリ秒単位。
Agent Instance | PFM - Agentのインスタンス名。
Load+GenTime | データベースからのソーステキスト，グラフィカルユーザーインターフェース，および画面情報の平均ロードと作成時間。ミリ秒単位。
QueueTime | ディスパッチャー待ち行列での平均待ち時間。ユーザー要求がディスパッチャーキューに入っている平均待ち時間。ミリ秒単位。
ResponseTime | ダイアログステップの処理時間の平均値。ミリ秒単位。ダイアログステップの処理に必要だった全処理時間を含む。データベース処理時間を含むが，ネットワーク転送時間やフロントエンド処理時間は含まれない。
System ID | SAPシステムID。

Process Detail

概要

Process Detailレポートは，最近1時間のワークプロセスの活動状態を表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Troubleshooting/Recent Past/Drilldown Only/

レコード

Work Process Summary（PD）

フィールド

フィールド名 | 説明
Action | ワークプロセスの該当アクティビティ名。
Bname | 現在ワークプロセスが処理している依頼のユーザー名。
CPU | 予約フィールドのため，使用できない。
Dumps | ワークプロセスが異常終了した回数。
ElTime | ワークプロセスの実行経過時間。秒単位。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
ManDt | 現在ワークプロセスが処理している依頼のクライアント名。
No | ワークプロセス番号。
Pid | ホストシステムでのワークプロセスのプロセスID。
Report | ワークプロセスが実行しているレポート名。
Restart | 異常終了したイベントで，ワークプロセスが自動的に再実行されるかどうかをY（再実行される）またはN（再実行されない）で表す。
Sem | ワークプロセスが待ち状態にあるセマフォの番号。
Status | ワークプロセスの現在の状態（例：待機中，実行中）。
System ID | SAPシステムID。
Table | ワークプロセスの最終アクセスDBテーブル名。
Typ | ワークプロセスのタイプ（例：DIA，UPD，UP2，ENQ，BGD，SPO）。
Waiting | ワークプロセスが待機中である理由。

Process Overview Status

概要

Process Overview Statusレポートは，ワークプロセスの活動状態をリアルタイムに表示します。表示形式は，表です。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/

レコード

Work Process Summary（PD）

フィールド

フィールド名 | 説明
Action | ワークプロセスの該当アクティビティ名。
Bname | 現在ワークプロセスが処理している依頼のユーザー名。
CPU | 予約フィールドのため，使用できない。
Dumps | ワークプロセスが異常終了した回数。
ElTime | ワークプロセスの実行経過時間。秒単位。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
ManDt | 現在ワークプロセスが処理している依頼のクライアント名。
No | ワークプロセス番号。
Pid | ホストシステムでのワークプロセスのプロセスID。
Report | ワークプロセスが実行しているレポート名。
Restart | 異常終了したイベントで，ワークプロセスが自動的に再実行されるかどうかをY（再実行される）またはN（再実行されない）で表す。
Sem | ワークプロセスが待ち状態にあるセマフォの番号。
Status | ワークプロセスの現在の状態（例：Running，Waiting）。
System ID | SAPシステムID。
Table | ワークプロセスの最終アクセスDBテーブル名。
Typ | ワークプロセスのタイプ（例：DIA，UPD，UP2，ENQ，BGD，SPO）。
Waiting | ワークプロセスが待機中である理由。

SAP Buffer Detail(CUA)

概要

SAP Buffer Detail(CUA)レポートは，SAPバッファ（CUAバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
CUA DirectoryUsed % | CUAバッファのディレクトリの使用率（エントリーの数）。
CUA HitRatio % | CUAバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
CUA SpaceUsed % | CUAバッファストレージの使用率。
CUA Swap | CUAバッファで発生した，1分ごとのバッファフルによるスワップ回数。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
System ID | SAPシステムID。

SAP Buffer Detail(FieldDescription)

概要

SAP Buffer Detail(FieldDescription)レポートは，SAPバッファ（Field descriptionバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
FieldDescription DirectoryUsed % | Field descriptionバッファのディレクトリの使用率（エントリーの数）。
FieldDescription HitRatio % | Field descriptionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
FieldDescription SpaceUsed % | Field descriptionバッファストレージの使用率。
FieldDescription Swap | Field descriptionバッファで発生した，1分ごとのバッファフルによるスワップ回数。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
System ID | SAPシステムID。

SAP Buffer Detail(GenericKey)

概要

SAP Buffer Detail(GenericKey)レポートは，SAPバッファ（Generic keyバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
GenericKey DirectoryUsed % | Generic keyバッファのディレクトリの使用率（エントリーの数）。
GenericKey HitRatio % | Generic keyバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
GenericKey SpaceUsed % | Generic keyバッファストレージの使用率。
GenericKey Swap | Generic keyバッファで発生した，1分ごとのバッファフルによるスワップ回数。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
System ID | SAPシステムID。

SAP Buffer Detail(InitialRecords)

概要

SAP Buffer Detail(InitialRecords)レポートは，SAPバッファ（Initial recordsバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
InitialRecords DirectoryUsed % | Initial recordsバッファのディレクトリの使用率（エントリーの数）。
InitialRecords HitRatio % | Initial recordsバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
InitialRecords SpaceUsed % | Initial recordsバッファストレージの使用率。
InitialRecords Swap | Initial recordsバッファで発生した，1分ごとのバッファフルによるスワップ回数。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
System ID | SAPシステムID。

SAP Buffer Detail(Program)

概要

SAP Buffer Detail(Program)レポートは，SAPバッファ（Programバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Program DirectoryUsed % | Programバッファのディレクトリの使用率（エントリーの数）。
Program HitRatio % | Programバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Program SpaceUsed % | Programバッファストレージの使用率。
Program Swap | Programバッファで発生した，1分ごとのバッファフルによるスワップ回数。
System ID | SAPシステムID。

SAP Buffer Detail(Screen)

概要

SAP Buffer Detail(Screen)レポートは，SAPバッファ（Screenバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Screen DirectoryUsed % | Screenバッファのディレクトリの使用率（エントリーの数）。
Screen HitRatio % | Screenバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Screen SpaceUsed % | Screenバッファストレージの使用率。
Screen Swap | Screenバッファで発生した，1分ごとのバッファフルによるスワップ回数。
System ID | SAPシステムID。

SAP Buffer Detail(ShortNameTAB)

概要

SAP Buffer Detail(ShortNameTAB)レポートは，SAPバッファ（Short nametabバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
ShortNameTAB DirectoryUsed % | Short nametabバッファのディレクトリの使用率（エントリーの数）。
ShortNameTAB HitRatio % | Short nametabバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
ShortNameTAB SpaceUsed % | Short nametabバッファストレージの使用率。
ShortNameTAB Swap | Short nametabバッファで発生した，1分ごとのバッファフルによるスワップ回数。
System ID | SAPシステムID。

SAP Buffer Detail(SingleRecord)

概要

SAP Buffer Detail(SingleRecord)レポートは，SAPバッファ（Single recordバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
SingleRecord DirectoryUsed % | Single recordバッファのディレクトリの使用率（エントリーの数）。
SingleRecord HitRatio % | Single recordバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
SingleRecord SpaceUsed % | Single recordバッファのバッファストレージの使用率。
SingleRecord Swap | Single recordバッファで発生した，1分ごとのバッファフルによるスワップ回数。
System ID | SAPシステムID。

SAP Buffer Detail(TableDefinition)

概要

SAP Buffer Detail(TableDefinition)レポートは，SAPバッファ（Table definitionバッファ）の詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
System ID | SAPシステムID。
TableDefinition DirectoryUsed % | Table definitionバッファのディレクトリの使用率（エントリーの数）。
TableDefinition HitRatio % | Table definitionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
TableDefinition SpaceUsed % | Table definitionバッファストレージの使用率。
TableDefinition Swap | Table definitionバッファで発生した，1分ごとのバッファフルによるスワップ回数。

SAP Buffer Hitratio

概要

SAP Buffer Hitratioレポートは，SAPバッファのヒット率に問題が発生したときの分析レポートです。最近1時間のSAPバッファのヒット率の傾向を分単位で表示します。表示形式は，表および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Troubleshooting/Recent Past/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
CUA HitRatio % | CUAバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
FieldDescription HitRatio % | Field descriptionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
GenericKey HitRatio % | Generic keyバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
InitialRecords HitRatio % | Initial recordsバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Program HitRatio % | Programバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Screen HitRatio % | Screenバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
ShortNameTAB HitRatio % | Short nametabバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
SingleRecord HitRatio % | Single recordバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
System ID | SAPシステムID。
TableDefinition HitRatio % | Table definitionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。

ドリルダウンレポート（レポートレベル）

レポート名 | 説明
Process Detail | 最近1時間のワークプロセスの活動状態を表示する。

SAP Buffer Hitratio Status

概要

SAP Buffer Hitratio Statusレポートは，SAPバッファのヒット率の概要をリアルタイムに表示します。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/

レコード

SAP Buffer Summary（PI_BUFF）

フィールド

フィールド名 | 説明
CUA HitRatio % | CUAバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
FieldDescription HitRatio % | Field descriptionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
GenericKey HitRatio % | Generic keyバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
InitialRecords HitRatio % | Initial recordsバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Program HitRatio % | Programバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Screen HitRatio % | Screenバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
ShortNameTAB HitRatio % | Short nametabバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
SingleRecord HitRatio % | Single recordバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
System ID | SAPシステムID。
TableDefinition HitRatio % | Table definitionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。

ドリルダウンレポート（フィールドレベル）

レポート名 | 説明
SAP Buffer Detail(CUA) | SAPバッファ（CUAバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，CUA HitRatio %フィールドをクリックする。
SAP Buffer Detail(FieldDescription) | SAPバッファ（Field descriptionバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，FieldDescription HitRatio %フィールドをクリックする。
SAP Buffer Detail(GenericKey) | SAPバッファ（Generic keyバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，GenericKey HitRatio %フィールドをクリックする。
SAP Buffer Detail(InitialRecords) | SAPバッファ（Initial recordsバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，InitialRecords HitRatio %フィールドをクリックする。
SAP Buffer Detail(Program) | SAPバッファ（Programバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，Program HitRatio %フィールドをクリックする。
SAP Buffer Detail(Screen) | SAPバッファ（Screenバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，Screen HitRatio %フィールドをクリックする。
SAP Buffer Detail(ShortNameTAB) | SAPバッファ（Short nametabバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，ShortNameTAB HitRatio %フィールドをクリックする。
SAP Buffer Detail(SingleRecord) | SAPバッファ（Single recordバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，SingleRecord HitRatio %フィールドをクリックする。
SAP Buffer Detail(TableDefinition) | SAPバッファ（Table definitionバッファ）の詳細をリアルタイムで表示する。このレポートを表示するには，TableDefinition HitRatio %フィールドをクリックする。

SAP Buffer Hitratio Trend（時単位の履歴レポート）

概要

SAP Buffer Hitratio Trendレポートは，最近24時間のSAPバッファのヒット率の傾向を時単位で表示します。表示形式は，表および折れ線グラフです。

表示されたデータは，分単位でドリルダウンでき，ある時間帯の，より詳細なデータを表示させることもできます。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Daily Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
CUA HitRatio % | CUAバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
FieldDescription HitRatio % | Field descriptionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
GenericKey HitRatio % | Generic keyバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
InitialRecords HitRatio % | Initial recordsバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Program HitRatio % | Programバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Screen HitRatio % | Screenバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
ShortNameTAB HitRatio % | Short nametabバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
SingleRecord HitRatio % | Single recordバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
System ID | SAPシステムID。
TableDefinition HitRatio % | Table definitionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。

SAP Buffer Hitratio Trend（日単位の履歴レポート）

概要

SAP Buffer Hitratio Trendレポートは，最近1か月間のSAPバッファのヒット率の傾向を日単位で表示します。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Monthly Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
CUA HitRatio % | CUAバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
FieldDescription HitRatio % | Field descriptionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
GenericKey HitRatio % | Generic keyバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
InitialRecords HitRatio % | Initial recordsバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
Program HitRatio % | Programバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
Screen HitRatio % | Screenバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
ShortNameTAB HitRatio % | Short nametabバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
SingleRecord HitRatio % | Single recordバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
System ID | SAPシステムID。
TableDefinition HitRatio % | Table definitionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。

SAP Memory Detail

概要

SAP Memory Detailレポートは，SAPメモリーの詳細をリアルタイムで表示します。表示形式は，一覧です。このレポートは，ドリルダウンレポートです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/Drilldown Only/

レコード

SAP Memory Summary（PI_MEM）

フィールド

フィールド名 | 説明
EmSlotsAct % | 現在の，拡張メモリースロットの使用率。
EmSlotsTotal | 拡張メモリースロットの合計数。
EsAct % | 現在の，拡張メモリーの使用率。
EsAttached % | アタッチされている拡張メモリーの使用率。
EsTotal | 拡張メモリーのサイズ。メガバイト単位。
HeapAct % | 現在の，ヒープ領域の使用率。
HeapTotal | ヒープ領域の合計。メガバイト単位。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
PrivWpNo | PRIVモードになったワークプロセス数。
R3PagingUsed % | ページング領域の使用率。
R3RollUsed % | ロール領域の使用率。
System ID | SAPシステムID。
WpDiaRestart | 「リスタート=Yes」のダイアログワークプロセス数。
WpNonDiaRestart | 「リスタート=No」のダイアログワークプロセス数。

SAP Memory Used

概要

SAP Memory Usedレポートは，SAPメモリーの使用率に問題が発生したときの分析レポートです。最近1時間のSAPメモリーの使用率の傾向を分単位で表示します。表示形式は，表および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Troubleshooting/Recent Past/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
EsAct % | 現在の，拡張メモリーの使用率。
HeapAct % | 現在の，ヒープ領域の使用率。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
R3PagingUsed % | ページング領域の使用率。
R3RollUsed % | ロール領域の使用率。
System ID | SAPシステムID。

ドリルダウンレポート（レポートレベル）

レポート名 | 説明
Process Detail | 最近1時間のワークプロセスの活動状態を表示する。

SAP Memory Used Status

概要

SAP Memory Used Statusレポートは，SAPメモリーの使用率の概要をリアルタイムで表示します。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Real-Time/

レコード

SAP Memory Summary（PI_MEM）

フィールド

フィールド名 | 説明
EsAct % | 現在の，拡張メモリーの使用率。
HeapAct % | 現在の，ヒープ領域の使用率。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
R3PagingUsed % | ページング領域の使用率。
R3RollUsed % | ロール領域の使用率。
System ID | SAPシステムID。

ドリルダウンレポート（フィールドレベル）

レポート名 | 説明
SAP Memory Detail | SAPメモリーの詳細をリアルタイムで表示する。このレポートを表示するには，EsAct %フィールド，HeapAct %フィールド，R3PagingUsed %フィールド，またはR3RollUsed %フィールドをクリックする。

SAP Memory Used Trend（時単位の履歴レポート）

概要

SAP Memory Used Trendレポートは，最近24時間のSAPメモリーの使用率の傾向を時単位で表示します。表示形式は，表および折れ線グラフです。表示されたデータは，分単位でドリルダウンでき，ある時間帯の，より詳細なデータを表示させることもできます。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Daily Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
EsAct % | 現在の，拡張メモリーの使用率。
HeapAct % | 現在の，ヒープ領域の使用率。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
R3PagingUsed % | ページング領域の使用率。
R3RollUsed % | ロール領域の使用率。
System ID | SAPシステムID。

SAP Memory Used Trend（日単位の履歴レポート）

概要

SAP Memory Used Trendレポートは，最近1か月間のSAPメモリーの使用率の傾向を日単位で表示します。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Monthly Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
EsAct % | 現在の，拡張メモリーの使用率。
HeapAct % | 現在の，ヒープ領域の使用率。
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
R3PagingUsed % | ページング領域の使用率。
R3RollUsed % | ロール領域の使用率。
System ID | SAPシステムID。

UsersLoggedIn Trend（時単位の履歴レポート）

概要

UsersLoggedIn Trendレポートは，最近24時間のログインユーザー数の傾向を表示します。集約された平均値に加えて最大値および最小値が表示されます。表示形式は，表および折れ線グラフです。表示されたデータは，分単位でドリルダウンでき，ある時間帯での，より詳細なデータを表示させることもできます。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Status Reporting/Daily Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
System ID | SAPシステムID。
UsersLoggedIn | ログインしているユーザー数。
UsersLoggedIn (Max) | ログインしている最大ユーザー数。
UsersLoggedIn (Min) | ログインしている最小ユーザー数。

UsersLoggedIn Trend（日単位の履歴レポート）

概要

UsersLoggedIn Trendレポートは，最近1か月間のログインユーザー数の傾向を日単位で表示します。集約された平均値に加えて最大値および最小値が表示されます。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Monthly Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
System ID | SAPシステムID。
UsersLoggedIn | ログインしているユーザー数。
UsersLoggedIn (Max) | ログインしている最大ユーザー数。
UsersLoggedIn (Min) | ログインしている最小ユーザー数。

UsersLoggedIn Trend(Multi-Agent)

概要

UsersLoggedIn Trend(Multi-Agent)レポートは，最近1か月間のログインユーザー数の傾向をアプリケーションサーバ間で比較します。表示形式は，一覧および折れ線グラフです。

格納先

Reports/SAP System/SAP Basis/Web Application Sever/Monthly Trend/

レコード

WorkLoad Summary Interval（PI）

フィールド

フィールド名 | 説明
Instance Name | SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
System ID | SAPシステムID。
UsersLoggedIn | ログインしているユーザー数。
UsersLoggedIn (Max) | ログインしている最大ユーザー数。
UsersLoggedIn (Min) | ログインしている最小ユーザー数。

9.　レコード

この章では，PFM - Agent for Enterprise Applicationsのレコードについて説明します。各レコードのパフォーマンスデータの収集方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの機能，または稼働監視データの管理について説明している章を参照してください。

＜この章の構成＞

データモデルについて

レコードの記載形式

ODBCキーフィールド一覧

要約ルール

データ型一覧

フィールドの値

Storeデータベースに記録されるときだけ追加されるフィールド

レコードの注意事項

レコード一覧

Background Processing（PI_BTCP）

Background Service（PI_BTC）

CCMS Alert Monitor Command（PD_ALMX）

Dialog Service（PI_DIA）

Enqueue Service（PI_ENQ）

SAP Buffer Summary（PI_BUFF）

SAP Instance Summary（PD_SRV）

SAP Memory Summary（PI_MEM）

Spool Service（PI_SPO）

System Log Monitor Command（PD_SLMX）

Update1 Service（PI_UPD1）

Update2 Service（PI_UPD2）

User defined Monitor (Perf.)（PI_UMP）

Work Process Summary（PD）

WorkLoad Summary Interval（PI）

データモデルについて

各PFM - Agentが持つレコードおよびフィールドの総称を「データモデル」と呼びます。各PFM - Agentと，そのPFM - Agentが持つデータモデルには，それぞれ固有のバージョン番号が付与されています。08-50版PFM - Agent for Enterprise Applicationsのデータモデルのバージョンは，5.0です。

各PFM - Agentのデータモデルのバージョンは，PFM - Web Consoleの［エージェント階層］タブでエージェントアイコンをクリックし，［プロパティの表示］メソッドをクリックして表示される［プロパティ］画面で確認してください。

データモデルについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの機能について説明している章を参照してください。

レコードの記載形式

この章では，PFM - Agent for Enterprise Applicationsのレコードをアルファベット順に記載しています。各レコードの説明は，次の項目から構成されています。

機能

各レコードに格納されるパフォーマンスデータの概要および注意事項について説明します。

デフォルト値および変更できる値

各レコードに設定されているパフォーマンスデータの収集条件のデフォルト値およびユーザーが変更できる値を表で示します。「デフォルト値および変更できる値」に記載している項目とその意味を次の表に示します。この表で示す各項目については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

項目
デフォルト値
変更可否

Collection Interval
パフォーマンスデータの収集間隔（秒単位）。
○：変更できる
×：変更できない

Collection Offset※
パフォーマンスデータの収集を開始するオフセット値（秒単位）。オフセット値については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照のこと。

Log
収集したパフォーマンスデータをStoreデータベースに記録するかどうか。
Yes：記録する。ただし，「Collection Interval=0」の場合，記録しない。
No：記録しない。

LOGIF
収集したパフォーマンスデータをStoreデータベースに記録するかどうかの条件。

注※

指定できる値は，0～32,767秒（Collection Intervalで指定した値の範囲内）です。これは，複数のデータを収集する場合に，一度にデータの収集処理が実行されると負荷が集中するので，収集処理の負荷を分散するために使用します。なお，データ収集の記録時間は，Collection Offsetの値に関係なく，Collection Intervalと同様の時間となります。

Collection Offsetの値を変更する場合は，収集処理の負荷を考慮した上で値を指定してください。

ODBCキーフィールド

PFM - Managerで，SQLを使用してStoreデータベースに格納されているレコードのデータを利用する場合に必要なODBCキーフィールドを示します。ODBCキーフィールドには，各レコード共通のものと各レコード固有のものとがあります。ここで示すのは，各レコード固有のODBCキーフィールドです。複数インスタンスレコードだけが，固有のODBCキーフィールドを持っています。

各レコード共通のODBCキーフィールドについては，この章の「ODBCキーフィールド一覧」を参照してください。ODBCキーフィールドの使用方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，ODBCに準拠したアプリケーションプログラムとの連携について説明している章を参照してください。

ライフタイム

各レコードに収集されるパフォーマンスデータの一貫性が保証される期間を示します。ライフタイムについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの機能について説明している章を参照してください。

レコードサイズ

1回の収集で各レコードに格納されるパフォーマンスデータの容量を示します。

フィールド

各レコードのフィールドについて表で説明します。表の各項目について次に説明します。

PFM - View名（PFM - Manager名）

PFM - View名
PFM - Web Consoleで表示されるフィールド名を示します。

PFM - Manager名
PFM - Managerで，SQLを使用してStoreデータベースに格納されているフィールドのデータを利用する場合，SQL文で記述するフィールド名（PFM - Manager名）を示します。
SQL文では，先頭に各レコードのレコードIDを付加した形式で記述します。例えば，Dialog Service（PI_DIA）レコードのDialogSteps（DIALOG_STEPS）フィールドの場合，「PI_DIA_DIALOG_STEPS」と記述します。

説明
各フィールドに格納されるパフォーマンスデータについて説明します。

要約
Agent Storeがデータを要約するときの方法（要約ルール）を示します。要約ルールについては，この章の「要約ルール」を参照してください。

形式
char型やfloat型など，各フィールドの値のデータ型を示します。データ型については，この章の「データ型一覧」を参照してください。

デルタ
累積値として収集するデータに対し，変化量でデータを表すことを「デルタ」と呼びます。デルタについては，この章の「フィールドの値」を参照してください。

サポートバージョン
そのフィールドを使用できるSAP Basisのバージョン番号を示します。バージョン番号が記述してある場合，そのバージョン以降のSAP Basisでそのフィールドが使用できます。「－」の場合，SAP Basisのバージョンに関係なく，そのフィールドが使用できます。

データソース
該当するフィールドの値の計算方法または取得先を示します。フィールドの値については，この章の「フィールドの値」を参照してください。

ODBCキーフィールド一覧

ODBCキーフィールドには，各レコード共通のものと各レコード固有のものとがあります。ここで示すのは，各レコード共通のODBCキーフィールドです。PFM - Managerで，SQLを使用してStoreデータベースに格納されているレコードのデータを利用する場合，ODBCキーフィールドが必要です。

各レコード共通のODBCキーフィールド一覧を次の表に示します。各レコード固有のODBCキーフィールドについては，各レコードの説明を参照してください。

表9-1　ODBCキーフィールド一覧

ODBCキーフィールド
ODBCフォーマット
データ
説明

レコードID_DATE
SQL_INTEGER
内部
レコードが生成された日付を表すレコードのキー。

レコードID_DATETIME
SQL_INTEGER
内部
レコードID_DATEフィールドとレコードID_TIMEフィールドの組み合わせ。

レコードID_DEVICEID
SQL_VARCHAR
内部
インスタンス名[ホスト名]。

レコードID_DRAWER_TYPE
SQL_VARCHAR
内部
区分。有効な値を次に示す。
m：分
H：時
D：日
W：週
M：月
Y：年

レコードID_PROD_INST
SQL_VARCHAR
内部
PFM - Agentのインスタンス名。

レコードID_PRODID
SQL_VARCHAR
内部
PFM - AgentのプロダクトID。

レコードID_RECORD_TYPE
SQL_VARCHAR
内部
レコードタイプを表す識別子（4バイト）。

レコードID_TIME
SQL_INTEGER
内部
レコードが生成された時刻（グリニッジ標準時）。

要約ルール

要約レコードは，収集したデータを一定の時間単位（分・時・日・週・月・年）ごとに要約してStoreデータベースに格納します。要約は，フィールドごとに定められた演算の定義に基づいて行われます。この演算の定義を「要約ルール」と呼びます。

要約によってStoreデータベースに追加されるフィールドを「追加フィールド」と呼びます。追加フィールドの有無や種類は要約ルールごとに異なります。追加フィールドの一部は，PFM - Web Consoleでレコードのフィールドとして表示されます。PFM - Web Consoleに表示される追加フィールドは，履歴レポートに表示するフィールドとして使用できます。

なお，要約によって追加される「追加フィールド」と区別するために，ここでは，この章の各レコードの説明に記載されているフィールドを「固有フィールド」と呼びます。

追加フィールドのフィールド名は次のようになります。

Storeデータベースに格納される追加フィールド名
固有フィールドのPFM - Manager名にサフィックスが付加されたフィールド名になります。

PFM - Web Consoleで表示される追加フィールド名
固有フィールドのPFM - View名にサフィックスが付加されたフィールド名になります。

PFM - Manager名に付加されるサフィックスと，それに対応するPFM - View名に付加されるサフィックス，およびフィールドに格納されるデータを次の表に示します。

表9-2　追加フィールドのサフィックス一覧

PFM - Manager名 | PFM - View名 | 格納データ
_TOTAL | (Total) | 要約期間内のレコードのフィールドの値の総和
_TOTAL_SEC | (Total) | 要約期間内のレコードのフィールドの値の総和（utime型の場合）
_COUNT | － | 要約期間内の収集レコード数
_HI | (Max) | 要約期間内のレコードのフィールド値の最大値
_LO | (Min) | 要約期間内のレコードのフィールド値の最小値

凡例

－：追加フィールドがないことを示します。

要約ルールの一覧を次の表に示します。

表9-3　要約ルール一覧

要約ルール名
要約ルール

COPY
要約期間内の最新のレコードのフィールド値がそのまま格納される。

AVG
要約期間内のフィールド値の平均値が格納される。
次に計算式を示す。
（フィールド値の総和）/（収集レコード数）
追加フィールド（Storeデータベース）

_TOTAL

_TOTAL_SEC（utime型の場合）

_COUNT

追加フィールド（PFM - Web Console）※1※2

(Total)

ADD
要約期間内のフィールド値の総和が格納される。

HI
要約期間内のフィールド値の最大値が格納される。

LO
要約期間内のフィールド値の最小値が格納される。

HILO
要約期間内のデータの最大値，最小値，および平均値が格納される。
固有フィールドには平均値が格納される。
次に計算式を示す。
（フィールド値の総和）/（収集レコード数）
追加フィールド（Storeデータベース）

_HI

_LO

_TOTAL

_TOTAL_SEC（utime型の場合）

_COUNT

追加フィールド（PFM - Web Console）※1※2

(Max)

(Min)

(Total)

%
要約期間内のフィールド値の平均値が格納される。
主に百分率のフィールドに適用される。
次に計算式を示す。
（フィールド値の総和）/（収集レコード数）
追加フィールド（Storeデータベース）

_TOTAL

_TOTAL_SEC（utime型の場合）

_COUNT

追加フィールド（PFM - Web Console）※3

(Total)

R
要約期間内のフィールド値の平均値が格納される。
主に1秒当たりの量を表すフィールドに適用される。
次に計算式を示す。
（フィールド値の総和）/（収集レコード数）
Real-Timeレポートのdelta指定時は差分をIntervalで割る特殊な計算方法を採用する。
追加フィールド（Storeデータベース）

_TOTAL

_COUNT

追加フィールド（PFM - Web Console）※1※2

(Total)

－
要約されないことを示す。

注※1

PFM - Manager名に「_AVG」が含まれるutime型のフィールドは，PFM - Web Consoleに追加される「(Total)」フィールドを履歴レポートで利用できません。

注※2

PFM - Manager名に次の文字列が含まれるフィールドは，PFM - Web Consoleに追加される（Total）フィールドを履歴レポートで利用できません。

「_PER_」，「PCT 」，「PERCENT 」，「_AVG 」，「_RATE_TOTAL 」

注※3

utime型のフィールドだけPFM - Web Consoleに追加される「(Total)」フィールドを履歴レポートで利用できます。

データ型一覧

各フィールドの値のデータ型と，対応するCおよびC++のデータ型の一覧を次の表に示します。この表で示す「データ型」の「フィールド」の値は，各レコードのフィールドの表にある「形式」の列に示されています。

表9-4　データ型一覧

データ型
サイズ
（バイト）

説明

フィールド
CおよびC++

char(n)
char( )
( )内の数
nバイトの長さを持つ文字データ。

double
double
8
数値（1.7E±308（15桁））。

float
float
4
数値（3.4E±38（7桁））。

long
long
4
数値（-2,147,483,648～2,147,483,647）。

short
short
2
数値（-32,768～32,767）。

string(n)
char[ ]
( )内の数
nバイトの長さを持つ文字列。最後の文字は，「null」。

time_t
unsigned long
4
数値（0～4,294,967,295）。

timeval
構造体
8
数値（最初の4バイトは秒，次の4バイトはマイクロ秒を表す）。

ulong
unsigned long
4
数値（0～4,294,967,295）。

utime
構造体
8
数値（最初の4バイトは秒，次の4バイトはマイクロ秒を表す）。

word
unsigned short
2
数値（0～65,535）。

（該当なし）
unsigned char
1
数値（0～255）。

フィールドの値

ここでは，各フィールドに格納される値について説明します。

データソース

各フィールドには，Performance Managementや監視対象プログラムから取得した値や，これらの値をある計算式に基づいて計算した値が格納されます。各フィールドの値の取得先または計算方法は，フィールドの表の「データソース」列で示します。

PFM - Agent for Enterprise Applicationsの「データソース」列の文字列は，SAPシステムのトランザクションコードを示します。該当するトランザクションコードに示されている値を取得することを示します。トランザクションコードだけでは値が特定できない場合，MTE（Monitoring Tree Element）名を補足しています（例：SAPシステムID¥SAPインスタンス名¥Background¥Utilisation）。MTE名については，SAPシステムのマニュアルを参照してください。

デルタ

累積値として収集するデータに対し，変化量でデータを表すことを「デルタ」と呼びます。例えば，1回目に収集されたパフォーマンスデータが「3」，2回目に収集されたパフォーマンスデータが「4」とすると，累積値の場合は「7」，変化量の場合は「1」が格納されます。各フィールドの値がデルタ値かどうかは，フィールドの表の「デルタ」列で示します。

PFM - Agent for Enterprise Applicationsで収集されるパフォーマンスデータは，次の表のように異なります。

レコードタイプ
デルタ
データ種別
［デルタ値で表示］のチェック※
レコードの値

PIレコードタイプ
Yes
リアルタイムデータ
あり
変化量が表示される。

なし
累積値が表示される。

・履歴データ
・アラームの監視データ
－
変化量が表示される。

No
リアルタイムデータ
あり
収集時点の値が表示される。

なし
収集時点の値が表示される。

・履歴データ
・アラームの監視データ
－
収集時点の値が表示される。

PDレコードタイプ
Yes
リアルタイムデータ
あり
変化量が表示される。

なし
累積値が表示される。

・履歴データ
・アラームの監視データ
－
累積値が表示される。

No
リアルタイムデータ
あり
収集時点の値が表示される。

なし
収集時点の値が表示される。

・履歴データ
・アラームの監視データ
－
収集時点の値が表示される。

（凡例）

－：該当しない

注※

次に示すPFM - Web Consoleのダイアログボックスの項目でチェックされていることを示します。

レポートウィザードの［編集 > 表示設定（リアルタイムレポート）］画面の［デルタ値で表示］

レポートウィンドウの［Properties］タブの［表示設定（リアルタイムレポート）］の［デルタ値で表示］

パフォーマンスデータが収集される際の注意事項を次に示します。

リアルタイムレポートの設定で，［デルタ値で表示］がチェックされている場合，最初にデータが収集されたときから値が表示されます。ただし，前回のデータを必要とするレポートの場合，初回の値は0で表示されます。2回目以降のデータ収集は，収集データの値が表示されます。

Storeデータベースに記録されるときだけ追加されるフィールド

Storeデータベースに記録されるときだけ追加されるフィールドを次の表に示します。

PFM - View名
（PFM - Manager名）
説明
形式
デルタ
サポートバージョン
データソース

Agent Host
（DEVICEID）
PFM - Agentが動作しているホスト名。
string(256)
No
すべて
－

Agent Instance
（PROD_INST）
PFM - Agentのインスタンス名。
string(256)
No
すべて
－

Agent Type
（PRODID）
PFM - AgentのプロダクトID。1バイトの識別子で表される。
char
No
すべて
－

Date
（DATE）
レコードが作成された日。グリニッジ標準時。※1※3
char(3)
No
すべて
－

Date and Time
（DATETIME）
Date（DATE）フィールドとTime（TIME）フィールドの組み合わせ。※3
char(6)
No
すべて
－

Drawer Type
（DRAWER_TYPE）
PIレコードタイプのレコードの場合，データが要約される区分。PFM - Web Consoleのレポートで表示する場合とODBCドライバを使用して表示する場合とで，区分の表示が異なる。※2
char
No
すべて
－

GMT Offset
（GMT_ADJUST）
グリニッジ標準時とローカル時間の差。秒単位。
long
No
すべて
－

Time
（TIME）
レコードが作成された時刻。グリニッジ標準時。※1※3
char(3)
No
すべて
－

（凡例）

－：SAP R/3から取得したパフォーマンスデータを加工してフィールドの値を設定していないことを意味する

注※1

PIレコードタイプのレコードでは，データが要約されるため，要約される際の基準となる時刻が設定されます。レコード区分ごとの設定値を次の表に示します。

区分 | レコード区分ごとの設定値
分 | レコードが作成された時刻の0秒
時 | レコードが作成された時刻の0分0秒
日 | レコードが作成された日の0時0分0秒
週 | レコードが作成された週の月曜日の0時0分0秒
月 | レコードが作成された月の1日の0時0分0秒
年 | レコードが作成された年の1月1日の0時0分0秒

注※2

PFM - Web Consoleのレポートで表示する場合とODBCドライバを使用して表示する場合の違いを次の表に示します。

区分 | PFM - Web Console | ODBCドライバ
分 | Minute | m
時 | Hour | H
日 | Day | D
週 | Week | W
月 | Month | M
年 | Year | Y

注※3

レポートやODBCドライバによるデータ表示を行った場合，"Date"フィールドはYYYYMMDD形式で，"Date and Time"フィールドはYYYYMMDD hh:mm:ss形式で，"Time"フィールドはhh:mm:ss形式で表示されます。

レコードの注意事項

レコードを収集する場合の注意事項を次に示します。

データを取得できない場合のレコード生成結果

フィールドに格納するデータを取得できない場合のレコード生成結果について説明します。

レコードが生成されない
次の場合，レコードは生成されません。

ODBCキーフィールドとして定義されたフィールドに格納するパフォーマンスデータをPFM - Agent for Enterprise Applicationsが収集できない場合

Enterprise Applicationsの性能値を表すフィールドに格納するパフォーマンスデータをPFM - Agent for Enterprise Applicationsが収集できない場合

空のフィールドを持つレコードが生成される
次の場合，空のフィールドを持つレコードが生成されます。

文字型のデータの収集にPFM - Agent for Enterprise Applicationsが失敗した場合

空の文字型のデータをPFM - Agent for Enterprise Applicationsが収集した場合

値が「-1」のフィールドを持つレコードが生成される
数値型の構成データの収集にPFM - Agent for Enterprise Applicationsが失敗した場合は，値が「-1」のフィールドを持つレコードが生成されます。

値が「Unknown」のフィールドを持つレコードが生成される
次の場合，値が「Unknown」のフィールドを持つレコードが生成されます。

データモデルに定義域を持つフィールドに対して，PFM - Agent for Enterprise Applicationsが収集したデータが定義域に含まれない場合

データモデルに定義域を持つフィールドに対して，PFM - Agent for Enterprise Applicationsがデータを収集できない場合

レコード一覧

ここでは，PFM - Agent for Enterprise Applicationsで収集できるレコードの一覧を記載します。

PFM - Agent for Enterprise Applicationsで収集できるレコードおよびそのレコードに格納される情報を，レコード名順およびレコードID順で次の表に示します。

表9-5　PFM - Agent for Enterprise Applicationsのレコード一覧（レコード名）

レコード名 | レコードID | 格納される情報
Background Processing | PI_BTCP | SAPシステム全体のバックグラウンドシステムの状態および処理効率についての情報。
Background Service | PI_BTC | バックグラウンドサービスについての統計情報。
CCMS Alert Monitor Command | PD_ALMX | SAPシステムのCCMSアラート情報の抽出結果。
Dialog Service | PI_DIA | ダイアログサービスについての統計情報。
Enqueue Service | PI_ENQ | エンキューサービスについての統計情報。
SAP Buffer Summary | PI_BUFF | SAPバッファについての要約情報。
SAP Instance Summary | PD_SRV | SAPインスタンスについての情報（トランザクションコードSM51で確認できる情報に相当）。
SAP Memory Summary | PI_MEM | 各種SAPメモリーについての要約情報。
Spool Service | PI_SPO | スプールサービスについての統計情報。
System Log Monitor Command | PD_SLMX | SAPシステムのシステムログ情報の抽出結果。
Update1 Service | PI_UPD1 | V1更新サービスについての統計情報。
Update2 Service | PI_UPD2 | V2更新サービスについての統計情報。
User defined Monitor (Perf.) | PI_UMP | SAPシステムのモニター情報のうち，ユーザーの定義に基づいて収集したパフォーマンス情報。
Work Process Summary | PD | ワークプロセスの概要（トランザクションコードSM50で確認できる情報に相当）。
WorkLoad Summary Interval | PI | ダイアログタスクのワークロード時間統計を取得および分析するための情報。

表9-6　PFM - Agent for Enterprise Applicationsのレコード一覧（レコードID）

レコードID | レコード名 | 格納される情報
PD | Work Process Summary | ワークプロセスの概要（トランザクションコードSM50で確認できる情報に相当）。
PD_ALMX | CCMS Alert Monitor Command | SAPシステムのCCMSアラート情報の抽出結果。
PD_SLMX | System Log Monitor Command | SAPシステムのシステムログ情報の抽出結果。
PD_SRV | SAP Instance Summary | SAPインスタンスについての情報（トランザクションコードSM51で確認できる情報に相当）。
PI | WorkLoad Summary Interval | ダイアログタスクのワークロード時間統計を取得および分析するための情報。
PI_BTC | Background Service | バックグラウンドサービスについての統計情報。
PI_BTCP | Background Processing | SAPシステム全体のバックグラウンドシステムの状態および処理効率についての情報。
PI_BUFF | SAP Buffer Summary | SAPバッファについての要約情報。
PI_DIA | Dialog Service | ダイアログサービスについての統計情報。
PI_ENQ | Enqueue Service | エンキューサービスについての統計情報。
PI_MEM | SAP Memory Summary | 各種SAPメモリーについての要約情報。
PI_SPO | Spool Service | スプールサービスについての統計情報。
PI_UMP | User defined Monitor (Perf.) | SAPシステムのモニター情報のうち，ユーザーの定義に基づいて収集したパフォーマンス情報。
PI_UPD1 | Update1 Service | V1更新サービスについての統計情報。
PI_UPD2 | Update2 Service | V2更新サービスについての統計情報。

Background Processing（PI_BTCP）

機能

Background Processing（PI_BTCP）レコードは，SAPシステム全体のバックグラウンドシステムの状態および処理効率についての情報を示します。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 40 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：743バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「BTCP」。
COPY
char(8)
No
6.20
－

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

SystemWideFreeBPWP
（SYSTEM_WIDE_FREE_BP_WP）
システム全体でのフリーバックグラウンドワークプロセスの数。
AVG
float
No
6.20
RZ20（SAPシステムID ¥BackgroundService¥SystemWideFreeBPWP）

SystemWideQueueLength
（SYSTEM_WIDE_QUEUE_LENGTH）
すべてのアプリケーションサーバでバックグラウンドワークプロセスを持つ実行待ちの平均ジョブ数。
AVG
float
No
6.20
RZ20（SAPシステムID ¥BackgroundService¥SystemWideQueueLength）

Background Service（PI_BTC）

機能

Background Service（PI_BTC）レコードは，バックグラウンドサービスについての統計情報を示します。このサービスを提供するSAPインスタンスごとに，1件のレコードが作成されます。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 40 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：759バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

NumberOfWpBTC
（NUMBER_OF_WP_BTC）
一つのアプリケーションサーバでのバックグラウンドワークプロセスの数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Background¥NumberOfWpBTC）

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「BTC」。
COPY
char(8)
No
6.20
－

ServerSpecificQueueLength
（SERVER_SPECIFIC_QUEUE_LENGTH）
アプリケーションサーバで明示的に実行されなければならないが，空いているバックグラウンドワークプロセスが存在しない実行待ちジョブの数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Background¥ServerSpecificQueueLength）

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

Utilization %
（UTILIZATION）
現在のバックグラウンド処理キャパシティの使用率。このフィールドの値は，バックグラウンドワークプロセス全体での平均の割合である。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Background¥Utilisation）

CCMS Alert Monitor Command（PD_ALMX）

機能

CCMS Alert Monitor Command（PD_ALMX）レコードは，SAPシステムのCCMSアラート情報の抽出結果を示します。

注意

このレコードはリアルタイムレポートでは表示できません。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：5,073バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
形式
デルタ
サポートバージョン
データソース

Elapsed Time
（ELAPSED_TIME）
コマンドの実行時間。ミリ秒単位。
ulong
No
6.20
－

Exit Code
（EXIT_CODE）
コマンドの終了コード。
ulong
No
6.20
－

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
string(21)
No
－
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ulong
No
－
－

Path
（PATH）
コマンドのパス（引数部分は含まない）。
string(256)
No
6.20
－

Record Time
（RECORD_TIME）
レコードが作成された時刻。
time_t
No
－
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「ALMX」。
char(8)
No
－
－

Stderr Buffer
（STDERR_BUFFER）
コマンドの標準エラー出力バッファ。
string(2049)
No
6.20
－

Stdout Buffer
（STDOUT_BUFFER）
コマンドの標準出力バッファ。
string(2049)
No
6.20
－

System ID
（SYSTEM_ID）
SAPシステムID。
string(9)
No
－
－

Dialog Service（PI_DIA）

機能

Dialog Service（PI_DIA）レコードは，ダイアログサービスについての統計情報を示します。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 35 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：959バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

DBRequestTime
（DB_REQUEST_TIME）
論理データベース要求を処理するための平均時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥DBRequestTime）

DialogSteps
（DIALOG_STEPS）
1分当たりの平均ダイアログステップ数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥DialogSteps）

FrontendNetTime
（FRONTEND_NET_TIME）
フロントエンドからアプリケーションサーバへの最初のデータ転送時と，アプリケーションサーバからフロントエンドへの最後のデータ転送時に，ネットワークで使われる時間。ミリ秒単位。GuiCallBackTimeフィールドの値は含まれていない。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥FrontEndNetTime）

FrontendResponseTime
（FRONTEND_RESPONSE_TIME）
自分の要求が処理されるのをユーザーがフロントエンドで待つ平均時間。つまり，応答時間，ネットワーク転送時間，およびフロントエンド処理時間の合計平均時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥FrontendResponseTime）

GuiCallBackTime
（GUI_CALL_BACK_TIME）
ダイアログステップ中のアプリケーションサーバとフロントエンドの間の通信時に，ワークプロセスがフロントエンドを待つ平均時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥GuiCallBackTime）

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

Load+GenTime
（LOAD_GENTIME）
データベースからのソーステキスト，グラフィカルユーザーインターフェース，および画面情報の平均ロードと作成時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥Load+GenTime）

LongRunners
（LONG_RUNNERS）
長期間実行中のダイアログワークプロセス数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥LongRunners）

MonitoringTime
（MONITORING_TIME）
ダイアログステップでモニタリングデータを作成するための平均時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥MonitoringTime）

NumberOfWPDia
（NUMBER_OF_WP_DIA）
ダイアログワークプロセスの数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥NumberOfWpDIA）

QueueLength %
（QUEUE_LENGTH）
ディスパッチャー待ち行列の平均使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥QueueLength）

QueueTime
（QUEUE_TIME）
ディスパッチャー待ち行列での平均待ち時間。つまり，ユーザー要求がディスパッチャーキューに入っている平均待ち時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥QueueTime）

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「DIA」。
COPY
char(8)
No
6.20
－

ResponseTime
（RESPONSE_TIME）
ダイアログステップの処理時間の平均値。ミリ秒単位。ダイアログステップの処理に必要だった全処理時間を含む。データベース処理時間を含むが，ネットワーク転送時間やフロントエンド処理時間は含まれない。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥ResponseTime）

ResponseTime:StandardTran.
（RESPONSE_TIME_STANDARD_TRAN）
標準トランザクションの応答時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥ResponseTime(StandardTran.) ）

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

UsersLoggedIn
（USERS_LOGGED_IN）
ログインしているユーザー数。
HILO
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥UsersLoggedIn）

Utilization %
（UTILIZATION）
1アプリケーションサーバ当たりのダイアログワークプロセスの平均使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥Utilisation）

Enqueue Service（PI_ENQ）

機能

Enqueue Service（PI_ENQ）レコードは，エンキューサービスについての統計情報を示します。SAPインスタンスごとに，1件のレコードが作成されます。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 40 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：743バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

EnqueueClient EnqueueFreq
（ENQUEUE_CLIENT_ENQUEUE_FREQ）
ほかのインスタンスからセントラルインスタンスへの，1分当たりのエンキュー処理数（論理データロック）。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Enqueue Client¥EnqueuFreq）

EnqueueServer QueueLength %
（ENQUEUE_SERVER_QUEUE_LENGTH）
エンキューサービスの待ち行列の長さの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Enqueue Server¥QueueLength）

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「ENQ」。
COPY
char(8)
No
6.20
－

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

SAP Buffer Summary（PI_BUFF）

機能

SAP Buffer Summary（PI_BUFF）レコードは，次のSAPバッファについての要約情報を示します。SAPインスタンスごとに，1件のレコードが作成されます。

Nametabバッファ（NTABバッファ）

Field descriptionバッファ（FTABバッファ，table DDNTF）
リポジトリーの項目内容説明を格納するバッファです。

Initial recordバッファ（IRECバッファ）
テーブルにあるデータレコードのレイアウトを格納するバッファです。

Short nametabバッファ（Short NTABバッファ，SNTABバッファ）
Field descriptionバッファとTable definitionバッファの結合形で，各バッファの最重要情報だけを格納するバッファです。

Table definitionバッファ（TTABバッファ，table DDNTT）
リポジトリーのテーブル定義を格納するバッファです。

Programバッファ（R/3 executableバッファ，ABAPバッファ，PXAバッファ）
コンパイル済みのプログラムを格納するバッファです。

R/3 GUIバッファ

CUAバッファ（Menuバッファ）
ABAPプログラムの画面メニューおよびボタン定義を格納するバッファです。

Screenバッファ（Presentationバッファ，Dynproバッファ）
ABAPプログラムの画面情報を格納するバッファです。

Tableバッファ

Generic keyバッファ（Generic tableバッファ，TABL）
データベーステーブルの内容の一部または全部を格納するバッファです。

Single recordバッファ（Partial tableバッファ，TABLP）
データベーステーブルから個々のレコードを格納するバッファです。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 40 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：1,287バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

CUA DirectoryUsed %
（CUA_DIRECTORY_USED）
CUAバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥CUA¥DirectoryUsed）

CUA HitRatio %
（CUA_HIT_RATIO）
CUAバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥CUA¥HitRatio）

CUA SpaceUsed %
（CUA_SPACE_USED）
CUAバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥CUA¥SpaceUsed）

CUA Swap
（CUA_SWAP）
CUAバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥CUA¥Swap）

FieldDescription DirectoryUsed %
（FIELD_DESCRIPTION_DIRECTORY_USED）
Field descriptionバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥FieldDescription¥DirectoryUsed）

FieldDescription HitRatio %
（FIELD_DESCRIPTION_HIT_RATIO）
Field descriptionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥FieldDescription¥HitRatio）

FieldDescription SpaceUsed %
（FIELD_DESCRIPTION_SPACE_USED）
Field descriptionバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥FieldDescription¥SpaceUsed）

FieldDescription Swap
（FIELD_DESCRIPTION_SWAP）
Field descriptionバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥FieldDescription¥Swap）

GenericKey DirectoryUsed %
（GENERIC_KEY_DIRECTORY_USED）
Generic keyバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥GenericKey¥DirectoryUsed）

GenericKey HitRatio %
（GENERIC_KEY_HIT_RATIO）
Generic keyバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥GenericKey¥HitRatio）

GenericKey SpaceUsed %
（GENERIC_KEY_SPACE_USED）
Generic keyバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥GenericKey¥SpaceUsed）

GenericKey Swap
（GENERIC_KEY_SWAP）
Generic keyバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥GenericKey¥Swap）

InitialRecords DirectoryUsed %
（INITIAL_RECORDS_DIRECTORY_USED）
Initial recordsバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥InitialRecords¥DirectoryUsed）

InitialRecords HitRatio %
（INITIAL_RECORDS_HIT_RATIO）
Initial recordsバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥InitialRecords¥HitRatio）

InitialRecords SpaceUsed %
（INITIAL_RECORDS_SPACE_USED）
Initial recordsバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥InitialRecords¥SpaceUsed）

InitialRecords Swap
（INITIAL_RECORDS_SWAP）
Initial recordsバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥InitialRecords¥Swap）

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

Program DirectoryUsed %
（PROGRAM_DIRECTORY_USED）
Programバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Program¥DirectoryUsed）

Program HitRatio %
（PROGRAM_HIT_RATIO）
Programバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Program¥HitRatio）

Program SpaceUsed %
（PROGRAM_SPACE_USED）
Programバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Program¥SpaceUsed）

Program Swap
（PROGRAM_SWAP）
Programバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Program¥Swap）

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「BUFF」。
COPY
char(8)
No
6.20
－

Screen DirectoryUsed %
（SCREEN_DIRECTORY_USED）
Screenバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Screen¥DirectoryUsed）

Screen HitRatio %
（SCREEN_HIT_RATIO）
Screenバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Screen¥HitRatio）

Screen SpaceUsed %
（SCREEN_SPACE_USED）
Screenバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Screen¥SpaceUsed）

Screen Swap
（SCREEN_SWAP）
Screenバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Screen¥Swap）

ShortNameTAB DirectoryUsed %
（SHORT_NAME_TAB_DIRECTORY_USED）
Short nametabバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥ShortNameTAB¥DirectoryUsed）

ShortNameTAB HitRatio %
（SHORT_NAME_TAB_HIT_RATIO）
Short nametabバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥ShortNameTAB¥HitRatio）

ShortNameTAB SpaceUsed %
（SHORT_NAME_TAB_SPACE_USED）
Short nametabバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥ShortNameTAB¥SpaceUsed）

ShortNameTAB Swap
（SHORT_NAME_TAB_SWAP）
Short nametabバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥ShortNameTAB¥Swap）

SingleRecord DirectoryUsed %
（SINGLE_RECORD_DIRECTORY_USED）
Single recordバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SingleRecord¥DirectoryUsed）

SingleRecord HitRatio %
（SINGLE_RECORD_HIT_RATIO）
Single recordバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SingleRecord¥HitRatio）

SingleRecord SpaceUsed %
（SINGLE_RECORD_SPACE_USED）
Single recordバッファのバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SingleRecord¥SpaceUsed）

SingleRecord Swap
（SINGLE_RECORD_SWAP）
Single recordバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SingleRecord¥Swap）

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

TableDefinition DirectoryUsed %
（TABLE_DEFINITION_DIRECTORY_USED）
Table definitionバッファのディレクトリの使用率（エントリーの数）。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥TableDefinition¥DirectoryUsed）

TableDefinition HitRatio %
（TABLE_DEFINITION_HIT_RATIO）
Table definitionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥TableDefinition¥HitRatio）

TableDefinition SpaceUsed %
（TABLE_DEFINITION_SPACE_USED）
Table definitionバッファストレージの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥TableDefinition¥SpaceUsed）

TableDefinition Swap
（TABLE_DEFINITION_SWAP）
Table definitionバッファで発生した，1分ごとのバッファフルによるスワップ回数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥TableDefinition¥Swap）

SAP Instance Summary（PD_SRV）

機能

SAP Instance Summary（PD_SRV）レコードは，SAPインスタンスについての情報（トランザクションコードがSM51で確認できる情報に相当）を示します。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 35 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PD_SRV_NAME

ライフタイム

サーバ名の設定から変更まで。

レコードサイズ

固定部：681バイト

可変部：102バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
形式
デルタ
サポートバージョン
データソース

Host
（HOST）
SAPインスタンスが動作するホスト名。
string(21)
No
6.20
SM51

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ulong
No
6.20
－

Name
（NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
string(21)
No
6.20
SM51

Record Time
（RECORD_TIME）
レコードが作成された時刻。
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「SRV」。
char(8)
No
6.20
－

Serv
（SERV）
サービス名。
string(21)
No
6.20
SM51

System ID
（SYSTEM_ID）
SAPシステムID。
string(9)
No
6.20
－

TypeList
（TYPELIST）
SAPインスタンスのタイプリスト。
string(9)
No
6.20
SM51

SAP Memory Summary（PI_MEM）

機能

SAP Memory Summary（PI_MEM）レコードは，各種SAPメモリーについての要約情報を示します。SAPインスタンスごとに，1件のレコードが作成されます。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 40 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：951バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

EmSlotRecentPeak %
（EM_SLOT_RECENT_PEAK）
最近の，拡張メモリースロット最大使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EmSlotRecentPeak）

EmSlotsAct %
（EM_SLOTS_ACT）
現在の，拡張メモリースロットの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EmSlotsAct）

EmSlotsPeak %
（EM_SLOTS_PEAK）
拡張メモリースロットの最大使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EmSlotsPeak）

EmSlotsTotal
（EM_SLOTS_TOTAL）
拡張メモリースロットの合計数。
COPY
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EmSlotsTotal）

EsAct %
（ES_ACT）
現在の，拡張メモリーの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EsAct）

EsAttached %
（ES_ATTACHED）
アタッチされている拡張メモリーの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EsAttached）

EsPeak %
（ES_PEAK）
拡張メモリーの最大使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EsPeak）

EsRecentPeak %
（ES_RECENT_PEAK）
最近の，拡張メモリーの最大使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EsRecentPeak）

EsTotal
（ES_TOTAL）
拡張メモリーのサイズ。メガバイト単位。
COPY
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EsTotal）

HeapAct %
（HEAP_ACT）
現在の，ヒープ領域の使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥HeapAct）

HeapPeak %
（HEAP_PEAK）
ヒープ領域の最大使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥HeapPeak）

HeapRecentPeak %
（HEAP_RECENT_PEAK）
最近の，ヒープ領域の最大使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥HeapRecentPeak）

HeapTotal
（HEAP_TOTAL）
ヒープ領域の合計。メガバイト単位。
COPY
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥HeapTotal）

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

PrivWpNo
（PRIV_WP_NO）
PRIVモードになったワークプロセス数。
HILO
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥PrivWpNo）

R3PagingUsed %
（R3_PAGING_USED）
ページング領域の使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3RollPaging¥R3PagingUsed）

R3RollUsed %
（R3_ROLL_USED）
ロール領域の使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3RollPaging¥R3RollUsed）

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「MEM」。
COPY
char(8)
No
6.20
－

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

WpDiaRestart
（WP_DIA_RESTART）
「リスタート=Yes」のダイアログワークプロセス数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥WpDiaRestart）

WpNonDiaRestart
（WP_NON_DIA_RESTART）
「リスタート=No」のダイアログワークプロセス数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥WpNonDiaRestart）

Spool Service（PI_SPO）

機能

Spool Service（PI_SPO）レコードは，スプールサービスについての統計情報を示します。このサービスを提供するSAPインスタンスごとに，1件のレコードが作成されます。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 40 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：855バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

DeviceCacheFixed %
（DEVICE_CACHE_FIXED）
固定デバイスキャッシュの使用済み領域の割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥DeviceCacheFixed）

DeviceCacheUsed %
（DEVICE_CACHE_USED）
デバイスキャッシュ全体の使用済み領域の割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥DeviceCacheUsed）

HostspoolListUsed %
（HOSTSPOOL_LIST_USED）
ホストスプール要求リストの使用済み領域の割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥HostspoolListUsed）

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

NumberOfWpSPO
（NUMBER_OF_WP_SPO）
スプールワークプロセスの数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥NumberOfWpSPO）

QueueLength %
（QUEUE_LENGTH）
ディスパッチャーキューの使用済み領域の割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥QueueLength）

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「SPO」。
COPY
char(8)
No
6.20
－

ServiceQueue %
（SERVICE_QUEUE）
スプール要求キューの使用済み領域の割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥ServiceQueue）

ServiceQueuePages
（SERVICE_QUEUE_PAGES）
スプール要求キューにあるページ数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥ServiceQueuePages）

ServiceQueuePriv %
（SERVICE_QUEUE_PRIV）
順次処理されるスプール要求キューの使用済み領域の割合。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥ServiceQueuePriv）

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

Utilization %
（UTILIZATION）
スプールワークプロセスの使用率。このフィールドの値は，スプールワークプロセス全体での平均の割合である。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SpoolService¥Utilisation）

System Log Monitor Command（PD_SLMX）

機能

System Log Monitor Command（PD_SLMX）レコードは，SAPシステムのシステムログ情報の抽出結果を示します。

注意

このレコードはリアルタイムレポートでは表示できません。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：5,073バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
形式
デルタ
サポートバージョン
データソース

Elapsed Time
（ELAPSED_TIME）
コマンドの実行時間。ミリ秒単位。
ulong
No
6.20
－

Exit Code
（EXIT_CODE）
コマンドの終了コード。
ulong
No
6.20
－

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
string(21)
No
－
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ulong
No
－
－

Path
（PATH）
コマンドのパス（引数部分は含まない）。
string(256)
No
6.20
－

Record Time
（RECORD_TIME）
レコードが作成された時刻。
time_t
No
－
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「SLMX」。
char(8)
No
－
－

Stderr Buffer
（STDERR_BUFFER）
コマンドの標準エラー出力バッファ。
string(2049)
No
6.20
－

Stdout Buffer
（STDOUT_BUFFER）
コマンドの標準出力バッファ。
string(2049)
No
6.20
－

System ID
（SYSTEM_ID）
SAPシステムID。
string(9)
No
－
－

Update1 Service（PI_UPD1）

機能

Update1 Service（PI_UPD1）レコードは，V1更新サービスについての統計情報を示します。このサービスを提供するSAPインスタンスごとに，1件のレコードが作成されます。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 40 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：775バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

NumberOfWpUD1
（NUMBER_OF_WP_UD1）
更新ワークプロセスの数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥PerformanceU1¥NumberOfWpUD1）

QueueTime
（QUEUE_TIME）
ディスパッチャーキューでの平均待ち時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥PerformanceU1¥QueueTime）

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「UPD1」。
COPY
char(8)
No
6.20
－

ResponseTime
（RESPONSE_TIME）
更新サービスの平均応答時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥PerformanceU1¥ResponseTime）

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

Utilization %
（UTILIZATION）
更新ワークプロセスの使用率。このフィールドの値は，更新ワークプロセス全体での平均の割合である。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥PerformanceU1¥Utilisation）

Update2 Service（PI_UPD2）

機能

Update2 Service（PI_UPD2）レコードは，V2更新サービスについての統計情報を示します。このサービスを提供するSAPインスタンスごとに，1件のレコードが作成されます。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 40 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：775バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

NumberOfWpUD2
（NUMBER_OF_WP_UD2）
更新ワークプロセスの数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥PerformanceU2¥NumberOfWpUD2）

QueueTime
（QUEUE_TIME）
ディスパッチャーキューでの平均待ち時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥PerformanceU2¥QueueTime）

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「UPD2」。
COPY
char(8)
No
6.20
－

ResponseTime
（RESPONSE_TIME）
更新サービスの平均応答時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥PerformanceU2¥ResponseTime）

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

Utilization %
（UTILIZATION）
更新ワークプロセスの使用率。このフィールドの値は，更新ワークプロセス全体での平均の割合である。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥PerformanceU2¥Utilisation）

User defined Monitor (Perf.)（PI_UMP）

機能

User defined Monitor (Perf.)（PI_UMP）レコードは，SAP システムのモニター情報のうち，ユーザーの定義に基づいて収集したパフォーマンス情報を示します。指定したSAPシステムのモニター情報のうち，MTEタイプがパフォーマンス属性であるMTEごとに，1件のレコードが作成されます。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 600 | ○
Collection Offset | 45 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_UMP_MTE_NAME

ライフタイム

なし

レコードサイズ

固定部：833バイト

可変部：293バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

Measured Date（MEASURED_DATE）
パフォーマンス値（Measured Value）の測定日付。
COPY
String(9)
No
6.20
RZ20

Measured Time（MEASURED_TIME）
パフォーマンス値（Measured Value）の測定時刻。
COPY
String(7)
No
6.20
RZ20

Measured Value（MEASURED_VALUE）
パフォーマンス値（SAPシステム側で計算済みの値）。
HILO
float
No
6.20
RZ20

Monitor Name
（MONITOR_NAME）
監視対象モニター名。
COPY
string(61)
No
6.20
RZ20

Monitor Set
（MONITOR_SET）
監視対象モニターセット名。
COPY
string(61)
No
6.20
RZ20

MTE Context
（MTE_CONTEXT）
MTEのContext部の名称。
COPY
string(41)
No
6.20
RZ20

MTE Name
（MTE_NAME）
MTE名（MTEのSystem ID部，Context部，Objectname部，Shortname部を'¥'で連結したもの。例：SAPシステムID¥SAPインスタンス名¥Background¥Utilisation）。
COPY
string(132)
No
6.20
RZ20

MTE Objectname
（MTE_OBJECTNAME）
MTEのObjectname部の名称。
COPY
string(41)
No
6.20
RZ20

MTE Shortname
（MTE_SHORTNAME）
MTEのShortname部の名称。
COPY
string(41)
No
6.20
RZ20

MTE System ID
（MTE_SYSID）
MTEのSystem ID部の名称。
COPY
string(9)
No
6.20
RZ20

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「UMP」。
COPY
char(8)
No
6.20
－

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

Unit
（UNIT）
パフォーマンス値の単位。
COPY
string(5)
No
6.20
RZ20

Value
（VALUE）
パフォーマンス値。
HILO
float
No
6.20
RZ20

Work Process Summary（PD）

機能

Work Process Summary（PD）レコードは，ワークプロセスの概要（トランザクションコードSM50で確認できる情報に相当）を示します。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 35 | ○
Log | Yes | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PD_NO

ライフタイム

ワークプロセス数の設定から変更まで。

レコードサイズ

固定部：681バイト

可変部：273バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
形式
デルタ
サポートバージョン
データソース

Action
（ACTION）
ワークプロセスの該当アクティビティ名。
string(26)
No
6.20
SM50

Bname
（BNAME）
現在ワークプロセスが処理している依頼のユーザー名。
string(13)
No
6.20
SM50

CPU
（CPU）
予約フィールドのため，使用できない。
string(9)
No
6.20
SM50

Dumps
（DUMPS）
ワークプロセスが異常終了した回数。
string(3)
No
6.20
SM50

ElTime
（ELTIME）
ワークプロセスの実行経過時間。秒単位。
string(7)
No
6.20
SM50

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ulong
No
6.20
－

ManDt
（MANDT）
現在ワークプロセスが処理している依頼のクライアント名。
string(4)
No
6.20
SM50

No
（NO）
ワークプロセス番号。
string(3)
No
6.20
SM50

Pid
（PID）
ホストシステムでのワークプロセスのプロセスID。
string(9)
No
6.20
SM50

Record Time
（RECORD_TIME）
レコードが作成された時刻。
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「PD」。
char(8)
No
6.20
－

Report
（REPORT）
ワークプロセスが実行しているレポート名。
string(41)
No
6.20
SM50

Restart
（RESTART）
異常終了したイベントで，ワークプロセスが自動的に再実行されるかどうかをYes（再実行される）またはNo（再実行されない）で表す。
string(5)
No
6.20
SM50

Sem
（SEM）
ワークプロセスが待ち状態にあるセマフォの番号。
string(3)
No
6.20
SM50

Server
（SERVER）
サーバ名。
string(21)
No
6.20
SM50

Status
（STATUS）
ワークプロセスの現在の状態（例：待機中，実行中）。
string(8)
No
6.20
SM50

System ID
（SYSTEM_ID）
SAPシステムID。
string(9)
No
6.20
－

Table
（TABLE）
ワークプロセスの最終アクセスDBテーブル名。
string(31)
No
6.20
SM50

Typ
（TYP）
ワークプロセスのタイプ（例：DIA，UPD，UP2，ENQ，BGD，SPO）。
string(4)
No
6.20
SM50

WaitInf
（WAITINF）
待機理由についての追加情報。
string(41)
No
6.20
SM50

WaitTim
（WAITTIM）
待機開始時刻。
string(9)
No
6.20
SM50

Waiting
（WAITING）
ワークプロセスが待機中である理由。
string(6)
No
6.20
SM50

WorkLoad Summary Interval（PI）

機能

WorkLoad Summary Interval（PI）レコードは，ダイアログタスクのワークロード時間統計を取得および分析するための情報を示します。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | Yes | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：1,075バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

CUA HitRatio %
（CUA _HIT_RATIO）
CUAバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。CUAバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥CUA¥HitRatio）

DBRequestTime
（DB_REQUEST_TIME）
論理データベース要求を処理するための平均時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥DBRequestTime）

DialogSteps
（DIALOG_STEPS）
1分当たりの平均ダイアログステップ数。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥DialogSteps）

EsAct %
（ES_ACT）
現在の，拡張メモリーの使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥EsAct）

FieldDescription HitRatio %
（FIELD_DESCRIPTION_HIT_RATIO）
Field descriptionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。Field descriptionバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥FieldDescription¥HitRatio）

FrontendNetTime
（FRONTEND_NET_TIME）
フロントエンドからアプリケーションサーバへの最初のデータ転送時と，アプリケーションサーバからフロントエンドへの最後のデータ転送時にネットワークで使われる時間。GuiCallBackTimeフィールドの値は含まれていない。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥FrontEndNetTime）

FrontendResponseTime
（FRONTEND_RESPONSE_TIME）
自分の要求が処理されるのをユーザーがフロントエンドで待つ平均時間。つまり，応答時間，ネットワーク転送時間，およびフロントエンド処理時間の合計平均時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥FrontendResponseTime）

GenericKey HitRatio %
（GENERIC_KEY_HIT_RATIO）
Generic keyバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。Generic keyバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥GenericKey¥HitRatio）

HeapAct %
（HEAP_ACT）
現在の，ヒープ領域の使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥HeapAct）

InitialRecords HitRatio %
（INITIAL_RECORDS_HIT_RATIO）
Initial recordsバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。Initial recordsバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥InitialRecords¥HitRatio）

Instance Name
（INSTANCE_NAME）
SAPインスタンス名。この名前は通常，ホスト名，SAPシステムID名，およびシステム番号から構成される。rdisp/mynameパラメーターによって設定を変更できる。
COPY
string(21)
No
6.20
－

Interval
（INTERVAL）
レコードが格納されたインターバル（Record Timeフィールドの値 - 前回取得時のRecode Timeフィールドの値）の秒数。最初の値は0。
ADD
ulong
No
6.20
－

Load+GenTime
（LOAD_GENTIME）
データベースからのソーステキスト，グラフィカルユーザーインターフェース，および画面情報の平均ロードと作成時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥Load+GenTime）

PrivWpNo
（PRIV_WP_NO）
PRIVモードになったワークプロセス数。
HI
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3MemMgmtResources¥PrivWpNo）

Program HitRatio %
（PROGRAM_HIT_RATIO）
Programバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。Programバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Program¥HitRatio）

QueueTime
（QUEUE_TIME）
ディスパッチャー待ち行列での平均待ち時間。ユーザー要求がディスパッチャーキューに入っている平均待ち時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥QueueTime）

R3PagingUsed %
（R3_PAGING_USED）
ページング領域の使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3RollPaging¥R3PagingUsed）

R3RollUsed %
（R3_ROLL_USED）
ロール領域の使用率。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥R3RollPaging¥R3RollUsed）

Record Time
（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
6.20
－

Record Type
（INPUT_RECORD_TYPE）
レコード種別。常に「PI」。
COPY
char(8)
No
6.20
－

ResponseTime
（RESPONSE_TIME）
ダイアログステップの処理時間の平均値。ミリ秒単位。ダイアログステップの処理に必要だった全処理時間を含む。データベース処理時間を含むが，ネットワーク転送時間やフロントエンド処理時間は含まれない。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥ResponseTime）

ResponseTime:StandardTran.
（RESPONSE_TIME_STANDARD_TRAN）
標準トランザクションの応答時間。ミリ秒単位。
AVG
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥ResponseTime(StandardTran.) ）

Screen HitRatio %
（SCREEN_HIT_RATIO）
Screenバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。Screenバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Screen¥HitRatio）

ShortNameTAB HitRatio %
（SHORT_NAME_TAB_HIT_RATIO）
Short nametabバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。Short nametabバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥ShortNameTAB¥HitRatio）

SingleRecord HitRatio %
（SINGLE_RECORD_HIT_RATIO）
Single recordバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。Single recordバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥SingleRecord¥HitRatio）

System ID
（SYSTEM_ID）
SAPシステムID。
COPY
string(9)
No
6.20
－

TableDefinition HitRatio %
（TABLE_DEFINITION_HIT_RATIO）
Table definitionバッファに存在したため，データベースに渡される必要がなかったデータベース問い合わせの割合。Table definitionバッファについては，SAP Buffer Summary（PI_BUFF）レコードを参照のこと。
%
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥TableDefinition¥HitRatio）

UsersLoggedIn
（USERS_LOGGED_IN）
ログインしているユーザー数。
HILO
float
No
6.20
RZ20（SAPシステムID¥SAPインスタンス名¥Dialog¥UsersLoggedIn）

10.　コマンド

この章では，PFM - Agent for Enterprise Applicationsのコマンドについて説明します。

PFM - Agent for Enterprise Applicationsのコマンドの記載形式および文法規則は，WindowsとUNIXとで共通です。

Windowsの場合，コマンドプロンプトからコマンドを実行します。

UNIXの場合，制御端末からコマンドを実行します。

＜この章の構成＞

コマンドの記載形式

コマンド一覧

jr3alget

jr3slget

コマンドの記載形式

ここでは，コマンドの記載形式として，コマンドの指定方法と，コマンドの文法の説明に使用する記号について説明します。

コマンドの指定方法

コマンドの指定形式を次に示します。

(1)を「オプション」と呼びます。(2)を「引数」と呼びます。

コマンドの文法の説明に使用する記号

コマンドの文法の説明に使用する記号を次の表に示します。

表10-1　コマンドの文法の説明に使用する記号

記号
意味と例

|
（ストローク）
複数の項目に対して項目間の区切りを示し，「または」の意味を示します。
（例）
「A|B|C」は，「A，B，またはC」を示します。

{　}
（波括弧）
この記号で囲まれている複数の項目の中から，必ず一組の項目を選択します。項目と項目の区切りは「|」で示します。
（例）
「{A|B|C}」は，「A，B，またはCのどれかを必ず指定する」ことを示します。

[　]
（角括弧）
この記号で囲まれている項目は，任意に指定できます（省略できます）。
（例）
「[A]」は，「必要に応じてAを指定する」ことを示します（必要でない場合は，Aを省略できます）。
「[B|C]」は，「必要に応じてB，またはCを指定する」ことを示します（必要でない場合は，BおよびCを省略できます）。

...
（点線）
この記号の直前に示された項目を繰り返して複数個，指定できます。なお，項目を複数個指定する場合は，項目の区切りに1バイトの空白文字（半角スペース）を使用します。
（例）
「A B...」は，「Aの後に，Bを複数個指定できる」ことを示します。

_
（下線）
括弧で囲まれているすべての項目を省略したときに，システムが採用する値を示します。
（例）
「[A|B]」は，「AおよびBを指定しなかった場合，システムはAを採用する」ことを示します。

ワイルドカード文字について

コマンドを実行する際に，複数のサービスまたはホスト名を指定する場合，ワイルドカード文字を使用できます。使用できるワイルドカード文字を次に示します。

*：任意の1文字以上の文字列を示します。

?：任意の1文字を示します。

UNIXで，ワイルドカード文字を指定する場合，シェルで解析されるのを防ぐため，「"*"」のように「"」で囲んで指定してください。

コマンド共通の注意事項

カレントディレクトリをコマンドの格納先ディレクトリに移動してからコマンドを実行してください。コマンドの格納先ディレクトリについては，各コマンドの説明を参照してください。

コマンド一覧

PFM - Agent for Enterprise Applicationsのコマンド一覧を次の表に示します。

各コマンドの詳細説明は，次の節以降にアルファベット順に記載しています。

表10-2　PFM - Agent for Enterprise Applicationsコマンドの一覧

コマンド名 | 機能 | 実行ホスト | 必要な実行権限
Windows | UNIX
jr3alget | SAPシステムのCCMSアラート情報を抽出する。 | PFM - Agent for Enterprise Applications | なし | なし
jr3slget | SAPシステムのシステムログ情報を抽出する。 | PFM - Agent for Enterprise Applications | なし | なし

jr3alget

形式

jr3alget     ［RFC接続情報］
            ［ターゲット情報］
            ［-lasttime タイムスタンプファイル名］
            ［出力先］
            ［-cnf 環境パラメーター設定ファイル名］
            ［-help］
            ［-v］

機能

jr3algetコマンドは，SAPシステムのCCMSアラート情報を抽出します。

コマンドを実行できるホスト

PFM - Agent for Enterprise Applications

実行権限

Windowsの場合

なし

UNIXの場合

なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥agtm¥evtrap¥

UNIXの場合

/opt/jp1pc/agtm/evtrap/

引数

RFC接続情報

コマンド実行時に，SAPシステムとのRFC接続を確立するための情報を指定します。

環境パラメーター設定ファイルで，RFC接続情報（CONNECTセクション）が指定されている場合，これらの引数の指定を省略できます。環境パラメーター設定ファイルおよびコマンドの両方でRFC接続情報が指定された場合，コマンドでの指定が優先されます。環境パラメーター設定ファイルについては，「6.4.3　コマンドを実行してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイル」を参照してください。

RFC情報の各引数について説明します。

-h アプリケーションサーバホスト名

接続先のアプリケーションサーバホスト名を指定します。指定できる値は，1～100バイトの半角英数字です。アプリケーションサーバホスト名は，次の形式で指定できます。

hostsファイルに指定されたホスト名

IPアドレス

SAPルーターアドレス

アプリケーションサーバホスト名は，トランザクションコードSM51で確認できます。

このオプションを指定する場合は，-sオプションも指定する必要があります。

-s システム番号

-hオプションで指定したアプリケーションサーバホストで識別するためのシステム番号を指定します。指定できる値は，0～99の数値です。

このオプションを指定する場合は，-hオプションも指定する必要があります。

-c クライアント名

接続に利用するユーザーのクライアント名を1～3バイトで指定します。指定できる値は，0～999の数値です。

このオプションを指定する場合は，-u，および-pまたは-p2オプションも指定する必要があります。

-u ユーザー名

接続に利用するユーザー名を指定します。指定できる値は，1～12バイトの半角英数字です。

このオプションを指定する場合は，-c，および-pまたは-p2オプションも指定する必要があります。

指定できるSAPユーザーについては「接続に使用するSAPユーザー」を参照してください。

-p パスワード

-uオプションで指定したユーザーのパスワードを指定します。指定できる値は，1～8バイトの半角文字列です。

このオプションは，-p2オプションと同時に指定できません。

このオプションを指定する場合は，-c，および-uオプションも指定する必要があります。

パスワードに指定できる文字については「接続に使用するSAPユーザー」を参照してください。

-p2 拡張パスワード

SAP NetWeaver 7.0以降をベースシステムとした拡張パスワード対応のSAPシステムへ接続する場合，-uオプションで指定したユーザーの拡張パスワードを指定します。指定できる値は，1～40バイトの半角文字列です。英字の大文字と小文字は区別されます。

このオプションは，-pオプションと同時に指定できません。

このオプションを指定する場合は，-c，および-uオプションも指定する必要があります。

拡張パスワードに指定できる文字については「接続に使用するSAPユーザー」を参照してください。

-l 言語

-uオプションで指定したユーザーの言語を指定します。指定できる値は，SAPシステムで使用されている，2バイトのISO IDまたは1バイトの言語キーです。例えば，次のように指定します。

日本語の場合：JA

英語の場合：EN

このオプションの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

このオプションを指定する場合は，-c，-u，および-pまたは-p2オプションも指定する必要があります。

-codepage コードページ

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページを指定します。コードページは，-lオプションの言語と組み合わせて指定する必要があります。

次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表10-3　言語とコードページの指定内容の組み合わせ

接続先SAPシステム | 接続言語 | 言語（-l） | コードページ（-codepage）
Unicode版 | 日本語 | JA | 8000
英語 | EN | 指定する必要はありません。指定する場合は，1100を指定してください。
非Unicode版 | 日本語 | JA | 指定する必要はありません。指定する場合は，8000を指定してください。
英語 | EN | 指定する必要はありません。指定する場合は，1100を指定してください。

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページは，SAPシステムが提供する環境変数SAP_CODEPAGEでも設定することができます。環境変数SAP_CODEPAGEとこのオプションの両方でコードページが指定された場合は，このオプションの指定が有効となります。

このオプションの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。このオプションを指定する場合は，-c，-u，および-pまたは-p2オプションも指定する必要があります。

ターゲット情報

抽出対象のCCMSアラート情報を特定するための情報を指定します。

環境パラメーター設定ファイルでターゲット情報（TARGETセクション）が指定されている場合は，これらの引数の指定を省略できます。環境パラメーター設定ファイルおよびコマンドの両方でターゲット接続情報が指定された場合，コマンドでの指定が優先されます。環境パラメーター設定ファイルについては，「6.4.3　コマンドを実行してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイル」を参照してください。

ターゲット情報の各引数について説明します。

-ms モニターセット名

モニターセット名を指定します。指定できる値は，1～60バイトの半角英数字です。モニターセット名とは，SAPシステムの警告モニター（トランザクションコードRZ20）で，「CCMS監視セット」として表示される名称です。

このオプションを指定する場合は，-mnオプションも指定する必要があります。

-mn モニター名

モニターセット内に定義されているモニター名を指定します。指定できる値は，1～60バイトの半角英数字です。モニター名とは，SAPシステムの警告モニター（トランザクションコードRZ20）で，CCMS監視セットのツリーに表示される名称です。

このオプションを指定する場合は，-msオプションも指定する必要があります。

-lasttime タイムスタンプファイル名

前回のコマンド実行時以降に出力されたCCMSアラート情報だけを抽出する場合に，前回の抽出時刻を管理するためのタイムスタンプファイル名を指定します。

指定できる値は，1～255バイトです。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

このオプションの指定を省略した場合，コマンド実行日の0時0分0秒から23時59分59秒までの期間が仮定されます。

このオプションの初回実行時に，指定したタイムスタンプファイルが存在しない場合，新規に作成されます。初回実行時は，CCMSアラート情報が出力されません。

出力先

CCMSアラート情報の出力先を指定します。このオプションの指定を省略した場合，CCMSアラート情報は，改行コードで区切られてコマンドの標準出力に出力されます。

出力先の各引数について説明します。

-x 出力ファイル名

CCMSアラート情報を出力するファイル名を指定します。指定できる値は，1～255バイトです。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

このファイルは，一定の容量に達すると先頭から再びデータを上書きする形式のラップアラウンドファイルであり，ファイルの先頭に管理情報として1行のヘッダーがあります。

ファイルサイズのデフォルトは1024KBです。ファイルサイズを変更する場合は，環境パラメーター設定ファイルのEXTRACTFILEセクションのSIZEラベルで指定してください。

なお，指定の出力ファイルと同じディレクトリに，出力ファイル名.ofsという名称で管理ファイルが作成されます。（例：出力ファイル名としてALERT を指定したときALERTファイルとは別にALERT.ofsファイルが管理ファイルとして作成されます）出力ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

-xオプションと-x2オプションは，同時に指定できません。

-x2

環境パラメーター設定ファイルのEXTRACTFILEセクションのX2PATHパラメーターで設定したファイルに，CCMSアラート情報を出力する場合に指定します。

-xオプションと-x2オプションは，同時に指定できません。

-cnf 環境パラメーター設定ファイル名

コマンドが参照する環境パラメーター設定ファイル名を指定します。指定できる値は，1～255バイトです。

相対パスで指定する場合，コマンドのカレントディレクトリからの相対パスを指定してください。

このオプションの指定を省略した場合，カレントディレクトリ下のデフォルト環境パラメーター設定ファイルjr3alget.iniが仮定されます。デフォルト環境パラメーター設定ファイルが存在しない場合，PFM - Agent for Enterprise Applicationsでのデフォルトの設定値が仮定されます。

環境パラメーター設定ファイルおよびデフォルトの設定値については，「6.4.3　コマンドを実行してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイル」を参照してください。

-help

jr3algetコマンドの使用方法を標準出力に出力します。

-v

標準出力にjr3algetコマンドの処理状況を示すメッセージを出力します。このオプションの指定を省略した場合，コマンドの処理状況を示すメッセージは出力されません。

接続に使用するSAPユーザー

jr3algetコマンドはCCMSアラート情報を収集するために，SAP社の通信プロトコルであるRFCを使用して，SAPシステム側に定義されている外部管理インターフェースを実行します。そのため，jr3algetコマンドが接続に使用するユーザーをあらかじめSAPシステム側に用意しておく必要があります。

ここでは，SAPシステム側に作成するSAPユーザーのユーザータイプ，パスワード，権限について説明します。

ユーザータイプ

PFM - Agent for Enterprise Applicationsで使用するSAPユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

パスワードに指定できる文字

SAPユーザーのパスワードは，半角数字(0～9)，半角英字(a～z, A～Z)，および次の半角記号で定義してください。

　!"@△$%&/()=?'`*+~#-_.,;:{[]}¥<>|

　△は，空白文字を示します。

必要な権限

SAPユーザーには次の権限（権限オブジェクト）を設定する必要があります。

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

外部管理インターフェースを使用するための権限（S_XMI_PROD）

各権限の値として，次の表に示す値またはすべての項目に「XAL」を指定したビルトイン権限値（S_RFC_ALLやS_XMI_ADMIN）を割り当ててください。

表10-4　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目 | 説明 | 値
RFC_TYPE | 保護されるRFCオブジェクトのタイプ | FUGR（汎用グループ）
RFC_NAME | 保護されるRFC名 | *
ACTVT | アクティビティ | 16（実行）

表10-5　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目 | 説明 | 値
EXTCOMPANY | 外部管理ツールの会社名 | HITACHI
EXTPRODUCT | 外部管理ツールのプログラム名 | JP1
INTERFACE | インターフェースID | XAL

注意事項

CCMSアラート情報は，SAPシステム内で一つのリソースとして扱われていて，どのアプリケーションサーバからも参照できるため，接続先のアプリケーションサーバは，任意です。一つのSAPシステムにつき，一つだけコマンドを実行するようにしてください。

出力形式および内容

CCMSアラート情報は，デフォルトでは次の形式で出力されます。＜　＞は，フィールドIDを示します。

CCMSアラート情報の各値が，各フィールドに対して決められた長さに満たない場合，半角の空白で埋められます。出力される各値について次に説明します。

表10-6　出力されるCCMSアラート情報の内容

フィールドID
意味
参照元
長さ（単位：バイト）

<ALSYSID>
SAPシステムの名称
アラートID（AID）
（BAPIAID）
8

<MSEGNAME>
監視セグメント名
40

<ALUNIQNUM>
AIDで使用される一意のID
10

<ALERTDATE>
アラート発生日付（YYYYMMDD）
8

<ALERTTIME>
アラート発生時刻（HHMMSS）
6

<MTSYSID>
SAPシステムの名称
アラートに関連づけられているMTEのID（TID）
（BAPITID）
8

<MTCLASS>
MTEタイプ
3

<MTNUMRANGE>
番号範囲（常駐,一時など）
3

<MTMCNAME>
監視コンテキスト名
40

<MTUID>
TIDで使用される一意のID
10

<VALUE>
警告値（トランザクションコードRZ20で見るCCMSアラートエントリーの色に対応）

0：灰（無効情報）

1：緑（ＯＫ）

2：黄（警告）

3：赤（問題またはエラー）

アラートの重要度（BAPIALDATA）
11

<SEVERITY>
重大度（0～255。数値が大きいほど重大）
11

<FIELDNAME>
MTE略称
一般プロパティ（BAPIALERT）
40

<STATUS>
アラートステータス
11

<OBJECTNAME>
監視オブジェクト名
40

<MANDT>
クライアント
3

<USERID>
SAPユーザー
12

<REPORTEDBY>
報告者（論理名）
16

<STATCHGDAT>
ステータス最終変更日付
8

<STATCHGBY>
ステータス最終変更者（論理名）
16

<STATCHGTIM>
ステータス最終変更時間
6

<MSCGLID>
ログ属性のメッセージがアラートを発生させたときのメッセージ識別
50

<MSGCLASS>
メッセージ記録者
メッセージ
16

<MSGID>
メッセージID
30

<MSGARG1>
メッセージの挿入語句1の文字列
128

<ARGTYPE1>
メッセージの挿入語句1のタイプ
1

<MSGARG2>
メッセージの挿入語句2の文字列
128

<ARGTYPE2>
メッセージの挿入語句2のタイプ
1

<MSGARG3>
メッセージの挿入語句3の文字列
128

<ARGTYPE3>
メッセージの挿入語句3のタイプ
1

<MSGARG4>
メッセージの挿入語句4の文字列
128

<ARGTYPE4>
メッセージの挿入語句4のタイプ
1

<MSGTEXT>
メッセージテキスト
128

<MSG>
翻訳済みメッセージ
255

戻り値

0 | 正常終了した。
1以上 | 異常終了した。

使用例

モニターセット名としてSAP CCMS Monitor Templates，モニター名をEntire SystemとしてCCMSアラート情報を出力する場合のコマンド実行例を次に示します。RFC接続情報は，環境パラメーター設定ファイルで定義済みであることを前提としています。

jr3alget -ms "SAP CCMS Monitor Templates" -mn "Entire System"

このコマンドの出力例を次に示します。

jr3slget

形式

jr3slget     ［RFC接続情報］
            ［ターゲット情報］
            ［-lasttime タイムスタンプファイル名］
            ［出力先］
            ［-cnf 環境パラメーター設定ファイル名］
            ［-help］
            ［-v］

機能

jr3slgetコマンドは，SAPシステムのシステムログ情報を抽出します。

コマンドを実行できるホスト

PFM - Agent for Enterprise Applications

実行権限

Windowsの場合

なし

UNIXの場合

なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥agtm¥evtrap¥

UNIXの場合

/opt/jp1pc/agtm/evtrap/

引数

RFC接続情報

コマンド実行時に，SAPシステムとのRFC接続を確立するための情報を指定します。

環境パラメーター設定ファイルで，RFC接続情報（CONNECTセクション）が指定されている場合，これらの引数の指定を省略できます。環境パラメーター設定ファイルおよびコマンドの両方でRFC接続情報が指定された場合，コマンドでの指定が優先されます。環境パラメーター設定ファイルについては，「5.4.3　コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル」を参照してください。

RFC情報の各引数について説明します。

-h アプリケーションサーバホスト名

接続先のアプリケーションサーバホスト名を指定します。指定できる値は，1～100バイトの半角英数字です。アプリケーションサーバホスト名は，次の形式で指定できます。

hostsファイルに指定されたホスト名

IPアドレス

SAPルーターアドレス

アプリケーションサーバホスト名は，トランザクションコードSM51で確認できます。

このオプションを指定する場合は，-sオプションも指定する必要があります。

-s システム番号

-hオプションで指定したアプリケーションサーバホストで識別するためのシステム番号を指定します。指定できる値は，0～99の数値です。

このオプションを指定する場合は，-hオプションも指定する必要があります。

-c クライアント名

接続に利用するユーザーのクライアント名を1～3バイトで指定します。指定できる値は，0～999の数値です。

このオプションを指定する場合は，-u，および-pまたは-p2オプションも指定する必要があります。

-u ユーザー名

接続に利用するユーザー名を指定します。指定できる値は，1～12バイトの半角英数字です。

このオプションを指定する場合は，-c，および-pまたは-p2オプションも指定する必要があります。

指定できるSAPユーザーについては「接続に使用するSAPユーザー」を参照してください。

-p パスワード

-uオプションで指定したユーザーのパスワードを指定します。指定できる値は，1～8バイトの半角文字列です。

このオプションは，-p2オプションと同時に指定できません。

このオプションを指定する場合は，-c，および-uオプションも指定する必要があります。

パスワードに指定できる文字については「接続に使用するSAPユーザー」を参照してください。

-p2 拡張パスワード

SAP NetWeaver 7.0以降をベースシステムとした拡張パスワード対応のSAPシステムへ接続する場合，-uオプションで指定したユーザーの拡張パスワードを指定します。指定できる値は，1～40バイトの半角文字列です。

このオプションは，-pオプションと同時に指定できません。

このオプションを指定する場合は，-c，および-uオプションも指定する必要があります。

拡張パスワードに指定できる文字については「接続に使用するSAPユーザー」を参照してください。

-l 言語

-uオプションで指定したユーザーの言語を指定します。指定できる値は，SAPシステムで使用されている，2バイトのISO IDまたは1バイトの言語キーです。例えば，次のように指定します。

日本語の場合：JA

英語の場合：EN

このオプションの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

このオプションを指定する場合は，-c，-u，および-pまたは-p2オプションも指定する必要があります。

-codepage コードページ

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページを指定します。コードページは，-lオプションの言語と組み合わせて指定する必要があります。

次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表10-7　言語とコードページの指定内容の組み合わせ

接続先SAPシステム | 接続言語 | 言語（-l） | コードページ（-codepage）
Unicode版 | 日本語 | JA | 8000
英語 | EN | 指定する必要はありません。指定する場合は，1100を指定してください。
非Unicode版 | 日本語 | JA | 指定する必要はありません。指定する場合は，8000を指定してください。
英語 | EN | 指定する必要はありません。指定する場合は，1100を指定してください。

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページは，SAPシステムが提供する環境変数SAP_CODEPAGEでも設定することができます。環境変数SAP_CODEPAGEとこのオプションの両方でコードページが指定された場合は，このオプションの指定が有効となります。

このオプションの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。このオプションを指定する場合は，-c，-u，および-pまたは-p2オプションも指定する必要があります。

ターゲット情報

抽出対象のシステムログ情報を特定するための情報を指定します。

環境パラメーター設定ファイルでターゲット情報（TARGETセクション）が指定されている場合は，この引数の指定を省略できます。環境パラメーター設定ファイルおよびコマンドの両方でターゲット接続情報が指定された場合，コマンドでの指定が優先されます。環境パラメーター設定ファイルについては，「5.4.3　コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル」を参照してください。

ターゲット情報の引数について説明します。

-server SAPインスタンス名

システムログを採取しているSAPインスタンス名を指定します。指定できる値は，1～20バイトの半角英数字です。一つのSAPインスタンス名だけ指定できます。SAPインスタンス名は，トランザクションコードSM50やSM66などで確認できます。

-lasttime タイムスタンプファイル名

前回のコマンド実行時以降に出力されたシステムログ情報だけを抽出する場合に，前回の抽出時刻を管理するためのタイムスタンプファイル名を指定します。

指定できる値は，1～255バイトです。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

このオプションの指定を省略した場合，コマンド実行日の0時0分0秒から23時59分59秒までの期間が仮定されます。

このオプションの初回実行時に，指定したタイムスタンプファイルが存在しない場合，新規に作成されます。初回実行時は，システムログ情報が出力されません。

出力先

システムログ情報の出力先を指定します。このオプションの指定を省略した場合，システムログ情報は，改行コードで区切られてコマンドの標準出力に出力されます。

出力先の各引数について説明します。

-x 出力ファイル名

システムログ情報を出力するファイル名を指定します。指定できる値は，1～255バイトです。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

このファイルは，一定の容量に達すると先頭から再びデータを上書きする形式のラップアラウンドファイルであり，ファイルの先頭に管理情報として1行のヘッダーがあります。

ファイルサイズのデフォルトは1024KBです。ファイルサイズを変更する場合は，環境パラメーター設定ファイルのEXTRACTFILEセクションのSIZEラベルで指定してください。

なお，指定の出力ファイルと同じディレクトリに，出力ファイル名.ofsという名称で管理ファイルが作成されます。（例：出力ファイル名としてSYSLOGを指定したときSYSLOGファイルとは別にSYSLOG.ofsファイルが管理ファイルとして作成されます）出力ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

-xオプションと-x2オプションは，同時に指定できません。

-x2

環境パラメーター設定ファイルのEXTRACTFILEセクションのX2PATHパラメーターで設定したファイルに，システムログ情報を出力する場合に指定します。

-xオプションと-x2オプションは，同時に指定できません。

-cnf 環境パラメーター設定ファイル名

コマンドが参照する環境パラメーター設定ファイル名を指定します。指定できる値は，1～255バイトです。

相対パスで指定する場合，コマンドのカレントディレクトリからの相対パスを指定してください。

このオプションの指定を省略した場合，カレントディレクトリ下のデフォルト環境パラメーター設定ファイルjr3slget.iniが仮定されます。デフォルト環境パラメーター設定ファイルが存在しない場合，PFM - Agent for Enterprise Applicationsでのデフォルトの設定値が仮定されます。

環境パラメーター設定ファイルおよびデフォルトの設定値については，「5.4.3　コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル」を参照してください。

-help

jr3slgetコマンドの使用方法を標準出力に出力します。

-v

標準出力にjr3slgetコマンドの処理状況を示すメッセージを出力します。このオプションの指定を省略した場合，コマンドの処理状況を示すメッセージは出力されません。

接続に使用するSAPユーザー

jr3slgetコマンドはシステムログ情報を収集するために，SAP社の通信プロトコルであるRFCを使用して，SAPシステム側に定義されている外部管理インターフェースを実行します。そのため，jr3slgetコマンドが接続に使用するユーザーをあらかじめSAPシステム側に用意しておく必要があります。

ここでは，SAPシステム側に作成するSAPユーザーのユーザータイプ，パスワード，権限について説明します。

ユーザータイプ

PFM - Agent for Enterprise Applicationsで使用するSAPユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

パスワードに指定できる文字

SAPユーザーのパスワードは，半角数字(0～9)，半角英字(a～z, A～Z)，および次の半角記号で定義してください。

　!"@△$%&/()=?'`*+~#-_.,;:{[]}¥<>|

　△は，空白文字を示します。

必要な権限

SAPユーザーには次の権限（権限オブジェクト）を設定する必要があります。

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

外部管理インターフェースを使用するための権限（S_XMI_PROD）

各権限の値として，次の表に示す値またはすべての項目に「XMB」を指定したビルトイン権限値（S_RFC_ALLやS_XMI_ADMIN）を割り当ててください。

表10-8　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目 | 説明 | 値
RFC_TYPE | 保護されるRFCオブジェクトのタイプ | FUGR（汎用グループ）
RFC_NAME | 保護されるRFC名 | *
ACTVT | アクティビティ | 16（実行）

表10-9　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目 | 説明 | 値
EXTCOMPANY | 外部管理ツールの会社名 | HITACHI
EXTPRODUCT | 外部管理ツールのプログラム名 | JP1
INTERFACE | インターフェースID | XMB

出力形式および内容

SAPシステムのトランザクションコードSM21で確認できるシステムログ情報（パラメーターレコード行を含む）を抽出します。

システムログ情報は，デフォルトでは次の形式で出力されます。＜　＞は，フィールドIDを示します。

システムログ情報の各値が，各フィールドに対して決められた長さに満たない場合，半角の空白で埋められます。出力される各値について次に説明します。

表10-10　出力されるシステムログ情報の内容

フィールドID | 意味 | 長さ（単位：バイト）
<TIME> | メッセージ記録時刻（HH:MM:SS） | 8
<INSTANCE> | メッセージを記録したサーバ | 20
<USER> | メッセージを記録したユーザー | 12
<PROGRAM> | メッセージを記録したプログラム | 8
<MSGNO> | メッセージ番号 | 3
<MSGTEXT> | メッセージテキスト | 255

戻り値

0 | 正常終了した。
1以上 | 異常終了した。

使用例

SAPインスタンスo246bci_SD5_00のシステムログ情報を出力する場合のコマンド実行例を次に示します。RFC接続情報は，環境パラメーター設定ファイルで定義済みであることを前提としています。

jr3slget -server o246bci_SD5_00

このコマンドの出力例を次に示します。

11.　メッセージ

この章では，PFM - Agent for Enterprise Applicationsのメッセージ形式，出力先一覧，syslogとWindowsイベントログの一覧，およびメッセージ一覧について説明します。

＜この章の構成＞

11.1　メッセージの形式

11.2　メッセージの出力先一覧

11.3　syslogとWindowsイベントログの一覧

11.4　メッセージ一覧

11.1　メッセージの形式

PFM - Agent for Enterprise Applicationsが出力するメッセージの形式と，マニュアルでの記載形式を示します。

＜この節の構成＞

11.1.1　メッセージの出力形式

11.1.2　メッセージの記載形式

11.1.3　システム管理者の方へ

11.1.1　メッセージの出力形式

PFM - Agent for Enterprise Applicationsが出力するメッセージの形式を説明します。メッセージは，メッセージIDとそれに続くメッセージテキストで構成されます。形式を次に示します。

KAVFnnnnn-Yメッセージテキスト

メッセージIDは，次の内容を示しています。

K

システム識別子を示します。

AVF

PFM - Agentのメッセージであることを示します。

nnnnn

メッセージの通し番号を示します。PFM - Agent for Enterprise Applicationsのメッセージ番号は，「14xxx」です。

Y

メッセージの種類を示します。

E：エラー
処理は中断されます。

W：警告
メッセージ出力後，処理は続けられます。

I：情報
ユーザーに情報を知らせます。

Q：応答
ユーザーに応答を促します。

メッセージの種類とsyslogのpriorityレベルとの対応を次に示します。

-E

レベル：LOG_ERR

意味：エラーメッセージ。

-W

レベル：LOG_WARNING

意味：警告メッセージ。

-I

レベル：LOG_INFO

意味：付加情報メッセージ。

-Q

（出力されない）

メッセージの種類とWindowsイベントログの種類との対応を次に示します。

-E

レベル：エラー

意味：エラーメッセージ。

-W

レベル：警告

意味：警告メッセージ。

-I

レベル：情報

意味：付加情報メッセージ。

-Q

（出力されない）

11.1.2　メッセージの記載形式

このマニュアルでのメッセージの記載形式を示します。メッセージテキストで太字になっている部分は，メッセージが表示される状況によって表示内容が変わることを示しています。また，メッセージをメッセージID順に記載しています。記載形式の例を次に示します。

メッセージID

英語メッセージテキスト
日本語メッセージテキスト

メッセージの説明文

(S)

システムの処置を示します。

(O)

メッセージが表示されたときに，オペレーターが取る処置を示します。

11.1.3　システム管理者の方へ

運用中にトラブルが発生した場合には，「12.　トラブルへの対処方法」を参照してログ情報を採取し，初期調査をしてください。

トラブル要因の初期調査をする場合は，OSのログ情報（Windowsの場合はWindowsイベントログ，UNIXの場合はsyslog）や，PFM - Agent for Enterprise Applicationsが出力する各種ログ情報を参照してください。これらのログ情報でトラブル発生時間帯の内容を参照して，トラブルを回避したり，トラブルに対処したりしてください。また，トラブルが発生するまでの操作方法などを記録してください。同時に，できるだけ再現性の有無を確認するようにしてください。

11.2　メッセージの出力先一覧

ここでは，PFM - Agent for Enterprise Applicationsが出力する各メッセージの出力先を一覧で示します。

表中では，出力先を凡例のように表記しています。

（凡例）

○：出力する

－：出力しない

表11-1　PFM - Agent for Enterprise Applicationsのメッセージの出力先一覧

メッセージID | 出力先
syslog | Windowsイベントログ | 共通メッセージログ | 標準出力 | 標準エラー出力
KAVF14000 | ○ | ○ | ○ | － | －
KAVF14001 | ○ | ○ | ○ | － | －
KAVF14002 | ○ | ○ | ○ | － | －
KAVF14100 | － | － | ○ | － | －
KAVF14103 | － | － | ○ | － | －
KAVF14105 | － | － | ○ | － | －
KAVF14121 | ○ | ○ | ○ | － | －
KAVF14122 | － | － | ○ | － | －
KAVF14125 | ○ | ○ | ○ | － | －
KAVF14126 | － | － | ○ | － | －
KAVF14127 | ○ | ○ | ○ | － | －
KAVF14128 | ○ | ○ | ○ | － | －
KAVF14129 | ○ | ○ | ○ | － | －
KAVF14131 | ○ | ○ | ○ | － | －
KAVF14133 | ○ | ○ | ○ | － | －
KAVF14134 | ○ | ○ | ○ | － | －
KAVF14136 | ○ | ○ | ○ | － | －
KAVF14150 | ○ | ○ | ○ | － | －
KAVF14151 | ○ | － | ○※ | － | －
KAVF14160 | ○ | ○ | ○ | － | －
KAVF14161 | ○ | ○ | ○ | － | －
KAVF14171 | ○ | ○ | ○ | － | －
KAVF14172 | ○ | ○ | ○ | － | －
KAVF14173 | ○ | ○ | ○ | － | －
KAVF14174 | ○ | ○ | ○ | － | －
KAVF14175 | ○ | ○ | ○ | － | －
KAVF14176 | ○ | ○ | ○ | － | －
KAVF14177 | ○ | ○ | ○ | － | －
KAVF14200 | － | － | － | ○ | －
KAVF14201 | － | － | － | ○ | －
KAVF14210 | － | － | － | ○ | －
KAVF14211 | － | － | － | － | ○
KAVF14212 | － | － | － | ○ | －
KAVF14213 | － | － | － | ○ | －
KAVF14215 | － | － | － | ○ | －
KAVF14216 | － | － | － | ○ | －
KAVF14220 | － | － | － | － | ○
KAVF14221 | － | － | － | － | ○
KAVF14222 | － | － | － | － | ○
KAVF14223 | － | － | － | － | ○
KAVF14224 | － | － | － | － | ○
KAVF14225 | － | － | － | － | ○
KAVF14226 | － | － | － | － | ○
KAVF14227 | － | － | － | － | ○
KAVF14229 | － | － | － | － | ○
KAVF14230 | － | － | － | － | ○
KAVF14231 | － | － | － | － | ○
KAVF14232 | － | － | － | － | ○
KAVF14233 | － | － | － | － | ○
KAVF14240 | － | － | － | － | ○
KAVF14241 | － | － | － | － | ○
KAVF14242 | － | － | － | － | ○
KAVF14243 | － | － | － | － | ○
KAVF14250 | － | － | － | － | ○
KAVF14251 | － | － | － | － | ○
KAVF14253 | － | － | － | － | ○
KAVF14254 | － | － | － | － | ○
KAVF14255 | － | － | － | － | ○
KAVF14256 | － | － | － | － | ○
KAVF14257 | － | － | － | － | ○
KAVF14260 | － | － | － | － | ○
KAVF14261 | － | － | － | － | ○
KAVF14262 | － | － | － | － | ○
KAVF14263 | － | － | － | － | ○
KAVF14270 | － | － | － | － | ○
KAVF14271 | － | － | － | － | ○
KAVF14272 | － | － | － | － | ○
KAVF14273 | － | － | － | ○ | －
KAVF14274 | － | － | － | － | ○
KAVF14275 | － | － | － | ○ | －
KAVF14276 | － | － | － | － | ○
KAVF14277 | － | － | － | ○ | －
KAVF14278 | － | － | － | － | ○

注※

UNIX版だけに出力されます。

11.3　syslogとWindowsイベントログの一覧

ここでは，PFM - Agent for Enterprise ApplicationsがsyslogとWindowsイベントログに出力するメッセージ情報の一覧を示します。

syslogは，syslogファイルに出力されます。syslogファイルの格納場所については，syslogデーモンコンフィギュレーションファイル（デフォルトは /etc/syslogd.conf）を参照してください。

Windowsイベントログは，次の個所に表示されます。

Windows 2000の場合
［イベントビューア］ウィンドウのアプリケーションログに表示されます。
［イベントビューア］ウィンドウは，Windowsの［スタート］メニューから［設定］－［コントロールパネル］－［管理ツール］－［イベントビューア］を選択することで表示できます。

Windows Server 2003，Windows Server 2003(IPF)の場合
［イベントビューア］ウィンドウのアプリケーションログに表示されます。
［イベントビューア］ウィンドウは，Windowsの［スタート］メニューから表示される［管理ツール］－［イベントビューア］を選択することで表示できます。

PFM - Agent for Enterprise Applicationsが出力するイベントの場合，［イベントビューア］ウィンドウの［ソース］に識別子「PFM-R3」が表示されます。

PFM - Agent for Enterprise ApplicationsがsyslogとWindowsイベントログに出力するメッセージ情報の一覧を次の表に示します。

表11-2　syslogとWindowsイベントログ出力メッセージ情報一覧

メッセージID | syslog | Windowsイベントログ
ファシリティ | レベル | イベントID | 種類
KAVF14000-I | LOG_DAEMON | LOG_INFO | 14000 | 情報
KAVF14001-I | LOG_DAEMON | LOG_INFO | 14001 | 情報
KAVF14002-E | LOG_DAEMON | LOG_ERR | 14002 | エラー
KAVF14121-E | LOG_DAEMON | LOG_ERR | 14121 | エラー
KAVF14125-E | LOG_DAEMON | LOG_ERR | 14125 | エラー
KAVF14127-E | LOG_DAEMON | LOG_ERR | 14127 | エラー
KAVF14128-E | LOG_DAEMON | LOG_ERR | 14128 | エラー
KAVF14129-E | LOG_DAEMON | LOG_ERR | 14129 | エラー
KAVF14131-E | LOG_DAEMON | LOG_ERR | 14131 | エラー
KAVF14133-E | LOG_DAEMON | LOG_ERR | 14133 | エラー
KAVF14134-E | LOG_DAEMON | LOG_ERR | 14134 | エラー
KAVF14136-E | LOG_DAEMON | LOG_ERR | 14136 | エラー
KAVF14150-E | LOG_DAEMON | LOG_ERR | 14150 | エラー
KAVF14151-E | LOG_DAEMON | LOG_ERR | － | －
KAVF14160-I | LOG_DAEMON | LOG_INFO | 14160 | 情報
KAVF14161-E | LOG_DAEMON | LOG_ERR | 14161 | エラー
KAVF14171-W | LOG_DAEMON | LOG_WARNING | 14171 | 警告
KAVF14172-W | LOG_DAEMON | LOG_WARNING | 14172 | 警告
KAVF14173-W | LOG_DAEMON | LOG_WARNING | 14173 | 警告
KAVF14174-W | LOG_DAEMON | LOG_WARNING | 14174 | 警告
KAVF14175-W | LOG_DAEMON | LOG_WARNING | 14175 | 警告
KAVF14176-W | LOG_DAEMON | LOG_WARNING | 14176 | 警告
KAVF14177-W | LOG_DAEMON | LOG_WARNING | 14177 | 警告

11.4　メッセージ一覧

PFM - Agent for Enterprise Applicationsが出力するメッセージと対処方法について説明します。PFM - Agent for Enterprise Applicationsのメッセージ一覧を次に示します。

KAVF14000-I

Agent Collector has started. (host=ホスト名, service=サービスID)
Agent Collectorが起動しました（host=ホスト名, service=サービスID）

Agent Collectorサービスの起動および初期化が完了しました。

(S)

SAPシステムのパフォーマンスデータの収集を開始します。

KAVF14001-I

Agent Collector has stopped. (host=ホスト名, service=サービスID)
Agent Collectorが停止しました（host=ホスト名, service=サービスID）

jpcstopコマンドでの停止要求，Windowsサービスの停止，またはシグナル割り込みによって，Agent Collectorサービスが終了しました。

シグナル割り込み時には，このメッセージの前にシグナル受信イベントと補足したシグナル番号を表すメッセージKAVF14151-Eが出力されます。

(S)

Agent Collectorサービスを停止します。

KAVF14002-E

Agent Collector failed to start. (rc=保守コード)
Agent Collectorの起動に失敗しました（rc=保守コード）

Agent Collectorサービスの起動および初期化に失敗したため，Agent Collectorサービスの処理を続行できません。

(S)

Agent Collectorサービスを停止します。

(O)

syslog（UNIXの場合），Windowsイベントログ（Windowsの場合），または共通メッセージログに出力されている直前のメッセージを確認し，そのメッセージの対処方法に従ってください。

KAVF14100-I

Connected to the SAP system. (sid=SAPシステムID)
SAPシステムに接続しました（sid=SAPシステムID）

SAPシステムとのRFC接続が確立されました。

(S)

Agent Collectorサービスの初期化処理を続行します。

KAVF14103-I

Reconnected to the SAP system. (sid=SAPシステムID)
SAPシステムに再接続しました（sid=SAPシステムID）

SAPシステムとのRFC接続が再確立されました。このメッセージは，Agent Collectorサービスが起動してから少なくとも1度は接続が確立されたあと，何らかの理由で切断され，SAPシステムに再接続する場合に出力されます。

(S)

Agent Collectorサービスの初期化処理を続行します。

KAVF14105-I

The connection to the SAP system was closed. (sid=SAPシステムID)
SAPシステムとの接続を閉じました（sid=SAPシステムID）

SAPシステムとのRFC接続が停止しました。

このメッセージは，停止要求に基づいた処理をする場合，または稼働中の一時的なエラーに対してRFCハンドルを解放する場合に出力されます。

(S)

停止要求に基づいた処理をする場合は，Agent Collectorサービスを終了します。

稼働中の一時的なエラーに対してRFCハンドルを解放する場合は，次回の接続まで待機します。

KAVF14121-E

An error occurred in the RFC API. (エラーが発生したAPI名)
RFC APIでエラーが発生しました（エラーが発生したAPI名）

RFC関数の呼び出しでエラーが発生しました。SAPシステムとの接続時に発生したRFC APIエラーについては，このメッセージの代わりにメッセージKAVF14127-EまたはメッセージKAVF14128-Eが出力されます。共通メッセージログ内には，続いて詳細なエラー情報を示すメッセージKAVF14122-Eが出力されます。エラーの要因として，次のことが考えられます。

SAPシステムが稼働していない

SAPシステムが高負荷であるためRFC要求を受け付けられない

ネットワークの設定に問題がある

(S)

起動処理中にこのエラーが発生した場合
Agent Collectorサービスを停止します。

起動完了後（運用中）にこのエラーが発生した場合
監視を続行します。開いているRFCハンドルは閉じられ，次回の収集タイミングで接続が再確立されます。なお，このタイミングで取得されるはずだったパフォーマンスデータの更新は，延期されます。

(O)

起動処理中にこのエラーが発生した場合
Agent Collectorサービス起動情報ファイル（jpcagt.ini）内に設定されている接続パラメーター，SAPシステムの稼働状態，ネットワークの状態などを見直し，問題を取り除いてから再起動してください。

起動完了後（運用中）にこのエラーが発生した場合
SAPシステムがダウンしているなどの致命的な状態になっていることがあります。このエラーが発生した時刻の前後に，共通メッセージログ内に出力されているメッセージKAVF14122-Eを確認して問題を解決してください。
Agent Collectorサービス起動情報ファイル（jpcagt.ini）内の接続パラメーターの誤りを訂正する場合，起動中のPFM - Agent for Enterprise Applicationsをjpcstopコマンドで停止してから訂正してください。
SAPシステムのメンテナンスなど，計画された停止によってこのエラーが発生した場合は，このメッセージを無視してかまいません。PFM - Agent for Enterprise Applicationsは，SAPシステムが再起動された時点で接続を再確立し，監視を続行します。

ソフトウェアの不具合であると考えられる場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVF14122-E

RFC_ERROR_INFO_EX: GROUP=エラーグループ名, KEY=エラーキー, MESSAGE=エラーメッセージ
RFC_ERROR_INFO_EX: GROUP=エラーグループ名, KEY=エラーキー, MESSAGE=エラーメッセージ

このメッセージは，KAVF14121-E，KAVF14127-E，またはKAVF14128-Eに続けてRFC APIのエラーの詳細を示すメッセージです。メッセージに出力される値の意味を次に示します。

GROUP：KEYを識別する3バイトの整数

KEY：エラーを識別する最大32バイトのコード

MESSAGE：エラー内容を説明する最大512バイトのテキスト（改行コードを含むことがある）

これらの値は，RFC APIのエラーを戻すGetRfcLastErrorEx関数で取得したRFC_ERROR_INFO_EX構造体中のメンバー値をそのまま設定しています。RFCの詳細については，SAPシステムのマニュアルを参照してください。

(S)

このメッセージの前に，メッセージKAVF14121-E，KAVF14127-E，またはKAVF14128-Eのどれかが出力されています。これらのメッセージに記載されているシステムの処置を参照してください。

(O)

このメッセージの前に出力されているメッセージKAVF14121-E，KAVF14127-E，またはKAVF14128-Eを確認して，要因を取り除いてください。

KAVF14125-E

An error occurred in the function module of the SAP system. (エラーが発生した汎用モジュール名)
SAPシステムの汎用モジュールでエラーが発生しました（エラーが発生した汎用モジュール名）

SAPシステム上の汎用モジュールから予期しないエラーコードが返されました。共通メッセージログ内には，続いて詳細なエラー情報を示すメッセージKAVF14126-Eが出力されます。エラーの要因は，呼び出した汎用モジュールごとに定義されます。エラーの要因については，メッセージKAVF14126-Eを参照してください。

(S)

起動処理中にこのエラーが発生した場合
Agent Collectorサービスを停止します。

起動完了後（運用中）にこのエラーが発生した場合
監視を続行します。なお，このタイミングで取得されるはずだったパフォーマンスデータの更新は，延期されます。

(O)

起動処理中にこのエラーが発生した場合
SAPシステムのバージョンを確認してください。BAPI_XMI_LOGONが権限チェックによってエラーとなることがあります。この場合は，接続に使用するユーザーに権限オブジェクトSXMI_PRODを付与してください。

起動完了後（運用中）にこのエラーが発生した場合
このエラーが発生した時刻の前後に，共通メッセージログ内に出力されているメッセージKAVF14126-Eを確認して問題を解決してください。

ソフトウェアの不具合であると考えられる場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVF14126-E

BAPIRET2: TYPE=メッセージタイプ, ID=メッセージクラス, NUMBER=メッセージ番号, MESSAGE=メッセージテキスト
BAPIRET2: TYPE=メッセージタイプ, ID=メッセージクラス, NUMBER=メッセージ番号, MESSAGE=メッセージテキスト

汎用モジュール（BAPI）のエラーの詳細を示すメッセージです。メッセージに出力される値の意味を次に示します。

TYPE：メッセージの重要度を表す1バイトの文字（S：正常，E：エラー，W：警告，I：情報，A：強制終了）

ID：メッセージを分類する最大20バイトのクラス

NUMBER：エラーを識別する最大3バイトのエラーコード

MESSAGE：エラー内容を説明する最大220バイトのテキスト

これらの値は，BAPIのエラーを格納するBAPIRET2構造体中のメンバー値をそのまま設定しています。BAPIの詳細については，SAPシステムのマニュアルを参照してください。呼び出したBAPIの仕様については，SAPシステムのオブジェクトナビゲーター（SE80），BAPIブラウザー（BAPI），またはSAPシステムのマニュアルを参照してください。

(S)

このメッセージの前に，メッセージKAVF14125-Eが出力されています。メッセージKAVF14125-Eのシステムの処置を参照してください。

(O)

このメッセージの前に出力されているメッセージKAVF14125-Eを確認して，要因を取り除いてください。

KAVF14127-E

Cannot connect to the SAP system. (エラーが発生した関数名)
SAPシステムに接続できません（エラーが発生した関数名）

SAPシステムとの接続処理で通信エラーが発生しました。SAPシステムとの接続時に発生したRFC APIエラーについては，メッセージKAVF14121-Eの代わりにこのメッセージまたはメッセージKAVF14128-Eが出力されます。共通メッセージログ内には，続いて詳細なエラー情報を示すメッセージKAVF14122-Eが出力されます。

エラーの要因として，次のことが考えられます。

SAPシステムが稼働していない

SAPシステムが高負荷であるためRFC要求を受け付けられない

ネットワークの設定に問題がある

あて先情報が不正である（ホスト名，システム番号などに誤りがある）

(S)

起動処理中にこのエラーが発生した場合
Agent Collectorサービスを停止します。

起動完了後（運用中）にこのエラーが発生した場合
監視を続行します。開いているRFCハンドルは閉じられ，次回のパフォーマンスデータ収集のタイミングで，接続が再確立されます。なお，このタイミングで取得されるはずだったパフォーマンスデータの更新は，延期されます。

(O)

起動処理中にこのエラーが発生した場合
Agent Collectorサービス起動情報ファイル（jpcagt.ini）内に設定されている接続パラメーター，SAPシステムの稼働状態，ネットワークの状態などを見直し，問題を取り除いてから再起動してください。

起動完了後（運用中）にこのエラーが発生した場合
SAPシステムがダウンしているなどの致命的な状態になっていることがあります。このエラーが発生した時刻の前後に，共通メッセージログ内に出力されているメッセージKAVF14122-Eを確認して問題を解決してください。
Agent Collectorサービス起動情報ファイル（jpcagt.ini）内の接続パラメーターの誤りを訂正する場合，起動中のPFM - Agent for Enterprise Applicationsをjpcstopコマンドで停止してから訂正してください。
SAPシステムのメンテナンスなど，計画された停止によってこのエラーが発生した場合は，このメッセージを無視してかまいません。PFM - Agent for Enterprise Applicationsは，SAPシステムが再起動された時点で接続を再確立し，監視を続行します。

ソフトウェアの不具合であると考えられる場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVF14128-E

Cannot log on to the SAP system. (エラーが発生した関数名)
SAPシステムにログオンできません（エラーが発生した関数名）

SAPシステムとの接続処理でログオンエラーが発生しました。SAPシステムとの接続時に発生したRFC APIエラーについては，メッセージKAVF14121-Eの代わりにこのメッセージまたはメッセージKAVF14127-Eが出力されます。共通メッセージログ内には，続いて詳細なエラー情報を示すメッセージKAVF14122-Eが出力されます。

エラーの要因として，次のことが考えられます。

ログオン情報が不正である（クライアント，ユーザー，パスワードなどに誤りがある）

ユーザーのパスワードが変更された

ユーザーに適切な権限が付与されていない
権限とは，汎用モジュールにRFC接続するための権限（S_RFC）のことです。

SAP NetWeaver 7.0以降をベースとしたSAPシステムで小文字を含む拡張パスワードを定義しているが，インスタンス情報のEXTPWD項目に"N"（拡張パスワードを使用しない）を指定している

(S)

起動処理中にこのエラーが発生した場合
Agent Collectorサービスを停止します。

起動完了後（運用中）にこのエラーが発生した場合
監視を続行します。開いているRFCハンドルは閉じられ，次回のパフォーマンスデータ収集のタイミングで，接続が再確立されます。なお，このタイミングで取得されるはずだったパフォーマンスデータの更新は，延期されます。

(O)

起動処理中にこのエラーが発生した場合
Agent Collectorサービス起動情報ファイル（jpcagt.ini）内に設定されている接続パラメーター，SAPシステム上のユーザー定義などを見直し，問題を取り除いてから再起動してください。

起動完了後（運用中）にこのエラーが発生した場合
ユーザーが削除された，パスワードが変更された，などの原因が考えられます。このエラーが発生した時刻の前後に，共通メッセージログ内に出力されているメッセージKAVF14122-Eを確認して問題を解決してください。
Agent Collectorサービス起動情報ファイル（jpcagt.ini）内の接続パラメーターの誤りを訂正する場合，起動中のPFM - Agent for Enterprise Applicationsをjpcstopコマンドで停止してから訂正してください。

ソフトウェアの不具合であると考えられる場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVF14129-E

SAP instance=SAPインスタンス名
SAP instance=SAPインスタンス名

このメッセージは，KAVF14121-EまたはKAVF14127-Eのメッセージ出力時に，通信障害の発生したSAPインスタンス名を示すメッセージです。

(S)

このメッセージの前に，KAVF14121-EまたはKAVF14127-Eのメッセージが出力されています。それらのメッセージに記載されているシステムの処置を参照してください。

(O)

このメッセージの前に出力されているKAVF14121-EまたはKAVF14127-Eのメッセージを確認して，要因を取り除いてください。

KAVF14131-E

The system resources are insufficient.
システムリソースが不足しています

システムのメモリーやハンドルなどのリソースが不足しています。Performance Managementが必要とするリソースに対してシステムのリソースが不足しているか，またはほかのアプリケーションのリソースリークによってシステムが不安定になっています。

(S)

起動処理中にこのエラーが発生した場合
Agent Collectorサービスを停止します。

起動完了後（運用中）にこのエラーが発生した場合
できるかぎりAgent Collectorサービスは監視を続行しようとします。一連の操作または要求はリジェクトされ，このタイミングで取得されるはずだったパフォーマンスデータの更新は，延期されます。

(O)

できるかぎり早く問題を特定し，システムの状態を回復してください。必要なリソースを再見積もりするとともに，メモリーの拡張，カーネルパラメーターの見直しなどをして，システムリソースを確保してください。

KAVF14133-E

An error occurred in an internal function. (func=関数名, rc=保守コード)
内部関数（関数名）でエラーが発生しました（func=関数名, rc=保守コード）

内部制御の関数インターフェースで関数エラーが発生しました。

(S)

起動処理中にこのエラーが発生するとAgent Collectorサービスは異常終了します。起動完了後（運用中）にエラーが発生した場合は，Agentサービスは監視を続けます。ただし，一連の操作または要求のリジェクトによってこのタイミングで取得されるはずだったパフォーマンスデータの更新は延期されます。

(O)

頻繁に問題が発生してエラーが回復しない場合は，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVF14134-E

A file or directory cannot be accessed. (パス)
ファイルまたはディレクトリにアクセスできません（パス）

ファイルの作成，削除，読み込み，書き込みなどの一般アクセスをする際に，エラー（ディスク容量不足以外のエラー）が発生しました。このエラーが発生する要因として，次のことが考えられます。

ファイルが存在しない

アクセス権限がない

ファイルシステムがアンマウントされている

ファイルのパスがディレクトリのパスになっている（環境不正）

(S)

起動処理中にこのエラーが発生した場合
Agent Collectorサービスを停止します。

起動完了後（運用中）にこのエラーが発生した場合
できるかぎりAgent Collectorサービスは監視を続行しようとします。一連の操作または要求はリジェクトされ，このタイミングで取得されるはずだったパフォーマンスデータの更新は，延期されます。

(O)

メッセージに出力されたパスが示すファイルの状態を確認して，問題を取り除いてください。

KAVF14136-E

The content of the Agent Collector service startup initialization file is invalid. (section=セクション名, subsection=サブセクション名, label=ラベル名)
Agent Collectorサービス起動情報ファイルの内容が不正です（section=セクション名, subsection=サブセクション名, label=ラベル名）

Agent Collectorサービス起動情報ファイル（jpcagt.ini）の指定内容に誤りがあります。

(S)

起動処理を中断してAgent Collectorサービスを停止します。

(O)

メッセージに出力されたセクション名，サブセクション名，およびラベル名を参照して，Agent Collectorサービス起動情報ファイル（jpcagt.ini）の不正な指定値を訂正してからAgent Collectorサービスを再起動してください。

KAVF14150-E

The system environment is invalid. (rc=保守コード)
システム環境が不正です（rc=保守コード）

システム環境が不正です。インストールおよびセットアップが不完全であるか，またはシステムファイルやレジストリが不当に削除または変更された状態でこのエラーが発生します。メッセージカタログが利用できない状況では，日本語環境でも英語でメッセージが出力されます。

(S)

Agent Collectorサービスを異常終了します。

(O)

必要なデータをバックアップしてシステムをアンインストールしたあと，再インストールしてください。それでも解決しない場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVF14151-E

The processing was interrupted by a signal. (signal=シグナル番号)
シグナルによって処理が中断されました（signal=シグナル番号）

システムのシャットダウンなどによって，プロセスの終了シグナルを受け付けたためAgent Collectorサービスを停止します。

(S)

Agent Collectorサービスを停止します。

KAVF14160-I

The performance data will now be collected. (sid=SAPシステムID, server=SAPインスタンス名)
パフォーマンスデータを収集します（sid=SAPシステムID, server=SAPインスタンス名）

Agent Collectorサービスがパフォーマンスデータの収集を開始しました。この時点で収集についてのすべての初期化処理が終了しています。

(S)

パフォーマンスデータを収集します。

KAVF14161-E

The SAP instance does not exist. (sid=SAPシステムID, server=SAPインスタンス名)
SAPインスタンスが存在しません（sid=SAPシステムID, server=SAPインスタンス名）

Agent Collectorサービス起動情報ファイル（jpcagt.ini）の［Agent］ - ［Target］サブセクションに設定されているSAPシステムIDまたはSAPインスタンス名に誤りがあるため，接続先のSAPシステム内でインスタンス情報を見つけられません。

(S)

起動処理中にこのエラーが発生した場合
Agent Collectorサービスを停止します。

起動完了後（運用中）にこのエラーが発生した場合
監視を続行します。なお，このタイミングで取得されるはずだったパフォーマンスデータの更新は，延期されます。

(O)

Agent Collectorサービス起動情報ファイル（jpcagt.ini）内に設定されているSAPインスタンス名（TargetセクションのSERVERパラメーター値）を見直してください。SAPインスタンス名は，通常，「ホスト名_SID_システム番号」の形式です。

KAVF14171-W

The performance data could not be updated. (レコードID[.フィールド名])
パフォーマンスデータを更新できませんでした（レコードID[.フィールド名]）

パフォーマンスデータの取得に失敗しました。このメッセージの前に，通信障害や汎用モジュールエラーなどの直接的な要因となるエラーを示すメッセージが出力されています。このメッセージに，影響を受けるレコードIDとフィールド名が「.」で区切った形式で出力されます。レコードIDおよびフィールド名は，PFM - Manager名で出力されます。

(S)

収集を続行します。パフォーマンスデータの更新は，次回の収集要求まで延期されます。

(O)

エラーの要因を取り除いてください。

KAVF14172-W

The performance data cannot be collected now.
パフォーマンスデータを収集できない状態です

通信障害が発生しているため，パフォーマンスデータの収集処理が実行されていないことを示すメッセージです。SAPシステムへの接続が復旧したことを示すメッセージKAVF14103-Iが出力されてから，初期化が完了したことを示すメッセージKAVF14160-Iが出力されるまで，このエージェントでは，パフォーマンスデータが収集できません。

(S)

収集要求ごとにSAPシステムへ再接続します。なお，2回目以降の接続エラーは報告されません。SAPシステムへの接続が復旧した場合，メッセージKAVF14103-Iを出力します。

(O)

このメッセージの前に出力されている通信障害メッセージKAVF14121-EおよびKAVF14122-Eを確認して，要因を取り除いてください。

KAVF14173-W

The performance data cannot be reported. (レコードID[.フィールド名])
パフォーマンスデータは報告されません（レコードID[.フィールド名]）

接続先のSAPシステムでは，このパフォーマンスデータはサポートされていません。パフォーマンスデータに対応するデータソースが接続先のSAPシステム内に見つかりません。

このメッセージに，サポートされていないパフォーマンスデータのレコードIDとフィールド名が「.」で区切った形式で出力されます。レコードIDおよびフィールド名は，PFM- Manager名で出力されます。

(S)

このパフォーマンスデータを監視対象から外して，エージェントの初期化を続行します。

(O)

サポートしているパフォーマンスデータを確認してください。サポートしているパフォーマンスデータについては，「9.　レコード」を参照してください。

KAVF14174-W

During collection of data, the number of instances of a multi-instance record exceeded the maximum. (record=レコードID, limit=上限値, instance=インスタンス数)
データの収集中に複数インスタンスレコードのインスタンス数が上限値を越えました (record=レコードID, limit=上限値, instance=インスタンス数)

データの収集で取得した複数インスタンスレコードのインスタンス数が上限値を超えました。上限値を超えたインスタンスは切り捨てられます。

(S)

処理を続行します。

(O)

監視対象のモニターの設定を見直してください。

KAVF14175-W

The specified monitor set name is invalid. (モニターセット名)
指定されたモニターセット名が不正です (モニターセット名)

Agent Collectorサービスのプロパティの［Agent］ - ［PI_UMP］フォルダの設定情報について，次のことが考えられます。

MONITOR_SETプロパティが設定されていない。

設定されているモニターセット名がSAPシステム上で定義されていない。

定義されているモニターセット名が無効。

(S)

User defined Monitor (Perf.)（PI_UMP）レコードの収集を中断して，処理を続行します。

(O)

Agent Collectorサービスのプロパティの［Agent］ - ［PI_UMP］フォルダのMONITOR_SETプロパティに設定されているモニターセット名がSAPシステム上に存在しているか確認してください。

モニターセット名は，トランザクションコードRZ20などで確認できます。モニターセット名は，「監視セット」と表記されていることもあります。なお，設定値の大文字・小文字は区別されます。

KAVF14176-W

The specified monitor name is invalid. (モニター名)
指定されたモニター名が不正です (モニター名)

Agent Collectorサービスのプロパティの［Agent］ - ［PI_UMP］フォルダの設定情報について，次のことが考えられます。

MONITOR_SETプロパティが設定されていない。

設定されているモニター名がSAPシステム上で定義されていない。

定義されているモニター名が無効。

(S)

User defined Monitor (Perf.)（PI_UMP）レコードの収集を中断して，処理を続行します。

(O)

Agent Collectorサービスのプロパティの［Agent］ - ［PI_UMP］フォルダのMONITOR_SETプロパティに設定されているモニター名がSAPシステム上に存在しているか確認してください。

モニター名は，トランザクションコードRZ20などで確認できます。モニター名は，「監視セット」と表記されていることもあります。なお，設定値の大文字・小文字は区別されます。

KAVF14177-W

The performance data could not be collected. (レコードID, モニターセット名, モニター名, MTE名)
パフォーマンスデータの取得に失敗しました (レコードID, モニターセット名, モニター名, MTE名)

MTE名で示されたパフォーマンスデータの取得に失敗しました（BAPIエラー）。このメッセージの直前に，通信障害や汎用モジュールエラーなどの直接的な要因となるエラーを示すメッセージが出力されています。

(S)

MTE名で示されたパフォーマンスデータの収集を中断して処理を続行します。このタイミングで取得されるはずだったパフォーマンスデータの更新は次回の収集タイミングまで延期されます。

(O)

このメッセージの直前に出力されているメッセージを確認して，要因を取り除いてください。

KAVF14200-I

Usage:
jr3slget [-h application-server-host -s system-number]
[-c client -u user {-p password | -p2 extended password}
[-l language] [-codepage codepage]]
[-server sap-instance-name]
[-lasttime time-stamp-file]
[{-x log-file | -x2}]
[-cnf environment-parameter-file]
[-help] [-v]
使用方法
jr3slget [-h アプリケーションサーバホスト -s システム番号]
[-c クライアント -u ユーザー
{-p パスワード | -p2 拡張パスワード}
[-l 言語] [-codepage コードページ]]
[-server SAPインスタンス名]
[-lasttime タイムスタンプファイル]
[{-x ログファイル | -x2}]
[-cnf 環境パラメーター設定ファイル]
[-help] [-v]

-helpオプションが指定されたため，jr3slgetコマンドの使用方法を表示します。

(S)

コマンドを正常終了します。

KAVF14201-I

Usage:
jr3alget [-h application-server-host -s system-number]
[-c client -u user {-p password | -p2 extended password}
[-l language] [-codepage codepage]]
[-c client -u user -p password [-l language] [-codepage codepage]]
[-ms monitor-set-name -mn monitor-name]
[-lasttime time-stamp-file]
[{-x log-file | -x2}]
[-cnf environment-parameter-file]
[-help] [-v]
使用方法:
jr3alget [-h アプリケーションサーバホスト -s システム番号]
[-c クライアント -u ユーザー
{-p パスワード | -p2 拡張パスワード}
[-l 言語] [-codepage コードページ]]
[-ms モニターセット名 -mn モニター名]
[-lasttime タイムスタンプファイル]
[{-x ログファイル | -x2}]
[-cnf 環境パラメーター設定ファイル]
[-help] [-v]

-helpオプションが指定されたため，jr3algetコマンドの使用方法を表示します。

(S)

コマンドを正常終了します。

KAVF14210-I

The command ended normally.
コマンドが正常終了しました

コマンドが正常終了したことを示すメッセージです。このメッセージは，コマンドに-vオプションが指定されたときにだけ出力されます。

(S)

終了コード0でコマンドを終了します。

KAVF14211-E

The command ended abnormally. (exit=終了コード)
コマンドが異常終了しました（exit=終了コード）

コマンドが異常終了したことを示すメッセージです。

(S)

終了コードでコマンドを終了します。

(O)

このメッセージの前に出力されている要因メッセージを参照してください。

KAVF14212-I

Connected to the SAP system.
SAPシステムに接続しました

SAPシステムとのRFC接続が確立されました。このメッセージは，コマンドに-vオプションが指定されたときにだけ出力されます。

(S)

このメッセージを出力したあとに，接続に使用したパラメーター情報を示すKAVF14213-IとKAVF14215-Iを出力します。その後，処理を続行します。

KAVF14213-I

SAP system data: ashost=アプリケーションサーバホスト, sysnr=システム番号
SAPシステムデータ: ashost=アプリケーションサーバホスト, sysnr=システム番号

このメッセージは，RFC接続確立時にKAVF14212-Iに続けて，RFC接続情報（あて先）として使用したパラメーターを示しています。このメッセージは，コマンドに-vオプションが指定されたときにだけ出力されます。

(S)

メッセージKAVF14212-Iが出力されたあとに，接続に使用したパラメーター情報を示します。

KAVF14215-I

SAP user data: client=クライアント, user=ユーザー, lang=言語, codepage=コードページ
SAPユーザーデータ: client=クライアント, user=ユーザー, lang=言語, codepage=コードページ

このメッセージは，RFC接続確立時に，KAVF14212-Iに続けてRFC接続情報（ログオン情報）として使用したパラメーターを示しています。このメッセージは，コマンドに-vオプションが指定されたときにだけ出力されます。言語とコードページの指定を省略した場合，lang=，codepage=には値が設定されません。また，パスワードは表示されません。

(S)

メッセージKAVF14212-Iが出力されたあとに，接続に使用したパラメーター情報を示します。

KAVF14216-I

Logged on to the external interface. (interface=インターフェース名, version=バージョン)
外部インターフェースにログオンしました（interface=インターフェース名, version=バージョン）

SAPシステムの外部インターフェースに対するログオンが成功しました。インターフェース名およびバージョンは，ログオン先のインターフェース名とバージョンです。このメッセージは，コマンドに-vオプションが指定されたときにだけ出力されます。

(S)

処理を続行します。

KAVF14220-E

An error occurred in the RFC API. (エラーが発生したRFC API名)
RFC APIでエラーが発生しました（エラーが発生したRFC API名）

RFC APIの呼び出しでエラーが発生しました。

(S)

このメッセージに続けて，詳細なエラー情報を示すメッセージKAVF14221-Eを出力します。また，分類できるエラーについてさらに補足メッセージを出力することがあります。その後，コマンドの実行を中止します。

(O)

継続メッセージを参照して，問題を取り除いてからコマンドを再実行してください。

KAVF14221-E

RFC_ERROR_INFO_EX: group=エラーグループ名, key=エラーキー, message=エラーメッセージ
RFC_ERROR_INFO_EX: group=エラーグループ名, key=エラーキー, message=エラーメッセージ

RFC APIのエラー詳細を示します。メッセージKAVF14220-Eに続けて出力されるメッセージです。メッセージに出力される値の意味を次に示します。

group：keyを識別する3バイトの整数

key：エラーを識別する最大32バイトのコード

message：エラー内容を説明する最大512バイトのテキスト（改行コードを含むことがある）

これらの値は，RFC APIのエラーを戻すGetRfcLastErrorEx関数で取得したRFC_ERROR_INFO_EX構造体中のメンバー値をそのまま設定しています。RFCの詳細については，SAPシステムのマニュアルを参照してください。

(S)

コマンドの実行を中止します。

(O)

問題を取り除いてからコマンドを再実行してください。

KAVF14222-E

An error occurred in the function module of the SAP system. (汎用モジュール名)
SAPシステムの汎用モジュールでエラーが発生しました（汎用モジュール名）

SAPシステムの汎用モジュールからエラーが返されました。

(S)

このメッセージに続けて，詳細なエラー情報を示すメッセージKAVF14223-EまたはKAVF14224-Eを出力します。また，分類できるエラーについてさらに補足メッセージを出力することがあります。その後，コマンドの実行を中止します。

(O)

継続メッセージを参照して，問題を取り除いてからコマンドを再実行してください。

KAVF14223-E

BAPIRET2: type=メッセージタイプ, id=メッセージクラス, number=メッセージ番号, message=メッセージテキスト
BAPIRET2: type=メッセージタイプ, id=メッセージクラス, number=メッセージ番号, message=メッセージテキスト

汎用モジュール（BAPI）のエラーを検出したときに，メッセージKAVF14222-Eに続けてこのメッセージを表示します。メッセージに出力される値の意味を次に示します。

type：メッセージの重要度を表す1バイトの文字（S：正常，E：エラー，W：警告，I：情報，A：強制終了）

id：メッセージを分類する最大20バイトのクラス

number：エラーを識別する最大3バイトのエラーコード

message：エラー内容を説明する最大220バイトのテキスト

これらの値は，BAPIのエラーを格納するBAPIRET2構造体中のメンバー値をそのまま設定しています。BAPIの詳細については，SAPシステムのマニュアルを参照してください。呼び出したBAPIの仕様については，SAPシステムのオブジェクトナビゲーター（SE80），BAPIブラウザー（BAPI），またはSAPシステムのマニュアルを参照してください。

(S)

コマンドの実行を中止します。

(O)

問題を取り除いてからコマンドを再実行してください。

KAVF14224-E

RFC_EXCEPTION: エラー要因コード
RFC_EXCEPTION: エラー要因コード

RFC例外によって汎用モジュールのエラーを検出した場合，メッセージKAVF14222-Eに続けてこのメッセージを表示します。

(S)

コマンドの実行を中止します。

(O)

問題を取り除いてからコマンドを再実行してください。

KAVF14225-E

Cannot connect to the SAP system.
SAPシステムに接続できません

SAPシステムとのRFC接続を確立する際に通信エラーが発生しました。このメッセージの直前に，エラーが発生した関数名と詳細情報を示すメッセージKAVF14220-EおよびKAVF14221-Eが出力されています。このエラーが発生する要因として次のことが考えられます。

RFC接続情報が正しく設定されていない（ホスト名が解決できない，誤ったシステム番号が設定されているなど）

SAPシステムが稼働していない

SAPシステムが高負荷であるためRFC要求を受け付けられない

ネットワークの設定に問題がある

(S)

このメッセージに続けて，接続に使用したパラメーター情報を示すメッセージKAVF14227-EとKAVF14229-Eを出力します。その後，コマンドの実行を中止します。

(O)

RFC接続情報で指定するあて先について，SAPシステムの稼働状態，ネットワークの状態などを見直し，問題を取り除いてからコマンドを再実行してください。

KAVF14226-E

Cannot connect to the SAP system, because an attempt to log on failed.
ログオンに失敗したためSAPシステムに接続できません

SAPシステムとのRFC接続を確立する際にログオンエラーが発生しました。このメッセージの直前に，エラーが発生した関数名と詳細情報を示すメッセージKAVF14220-EおよびKAVF14221-Eが出力されています。このエラーが発生する要因として次のことが考えられます。

RFC接続情報が正しく設定されていない（存在しないユーザーや誤ったパスワードを設定したなど）

ユーザーがロックアウトされている

ユーザーにS_RFC権限が適切に付与されていない

SAP NetWeaver 7.0以降をベースとしたSAPシステムで小文字を含む拡張パスワードを定義しているが，拡張パスワードに対応していない接続情報（-pオプションや環境パラメーター設定ファイルのPASSWDラベル）を指定している

(S)

このメッセージに続けて，接続に使用したパラメーター情報を示すメッセージKAVF14227-EとKAVF14229-Eを出力します。その後，コマンドの実行を中止します。

(O)

RFC接続情報で指定するユーザーについて，未定義，パスワードの有効期限切れ，ロックアウト，権限などを見直し，問題を取り除いてからコマンドを再実行してください。

KAVF14227-E

SAPシステムデータ: ashost=アプリケーションサーバホスト, sysnr=システム番号
SAP system data: ashost=アプリケーションサーバホスト, sysnr=システム番号

このメッセージは，RFC接続エラー時に，メッセージKAVF14225-EまたはKAVF14226-Eに続けて，RFC接続情報（あて先）として使用したパラメーターを示しています。

(S)

コマンドの実行を中止します。

(O)

問題を取り除いてからコマンドを再実行してください。

KAVF14229-E

SAP user data: client=クライアント, user=ユーザー, lang=言語, codepage=コードページ
SAPユーザーデータ: client=クライアント, user=ユーザー, lang=言語, codepage=コードページ

このメッセージは，RFC接続エラー時に，メッセージKAVF14225-EまたはKAVF14226-Eに続けて，RFC接続情報（ログオン）として使用したパラメーターを示しています。言語とコードページの指定を省略した場合，lang=，codepage= には値が設定されません。また，パスワードは表示されません。

(S)

コマンドの実行を中止します。

(O)

問題を取り除いてからコマンドを再実行してください。

KAVF14230-E

Cannot log on to the external interface. (interface=ログオン先のインターフェース名, version=バージョン)
外部インターフェースにログオンできません（interface=ログオン先のインターフェース名, version=バージョン）

SAPシステムの外部インターフェースに対するログオンが拒否されました（BAPIエラー）。このメッセージの直前にエラーが発生した汎用モジュール名と詳細情報を示すメッセージKAVF14222-EおよびKAVF14223-Eが出力されています。このエラーが発生する要因として次のことが考えられます。

接続先のSAPシステムがこのインターフェースをサポートしていない

ユーザーにS_XMI_PROD権限が適切に付与されていない

(S)

コマンドの実行を中止します。

(O)

接続先のSAPシステムのSAP Basis（SAP WebAS）のリリースとパッチレベルが前提条件を満たしていることを確認してください。汎用モジュールBAPI_XMI_LOGONが権限チェックでエラーとなっている場合は，RFC接続に使用するユーザーに権限オブジェクトSXMI_PRODを適切に付与してください。

KAVF14231-E

The specified server name is invalid. (指定されたSAPインスタンス名)
指定されたサーバ名は無効です（指定されたSAPインスタンス名）

次のどちらかで指定したSAPインスタンス名が定義されていないか，または無効です（BAPIエラー）。

jr3slgetコマンドの-serverオプション

環境パラメーター設定ファイル（TARGETセクションのSERVERラベル）

このメッセージの直前に，エラーが発生した汎用モジュール名と詳細情報を示すメッセージKAVF14222-EおよびKAVF14223-Eが出力されています。

(S)

コマンドの実行を中止します。

(O)

指定したSAPインスタンス名を見直してコマンドを再実行してください。SAPインスタンス名は，トランザクションコードSM51などで確認できます。SAPインスタンス名は，通常「ホスト名_システムID_システム番号」の形式です。なお，SAPインスタンスの大文字・小文字は区別されます。

KAVF14232-E

The specified monitor set name is invalid. (指定されたモニターセット名)
指定されたモニターセット名は無効です（指定されたモニターセット名）

次のどちらかで指定したモニターセット名が定義されていないか，または無効です（BAPIエラー）。

jr3algetコマンドの-msオプション

環境パラメーター設定ファイル（TARGETセクションのMONITOR_SETラベル）

このメッセージの直前に，エラーが発生した汎用モジュール名と詳細情報を示すメッセージKAVF14222-EおよびKAVF14223-Eが出力されています。

(S)

コマンドの実行を中止します。

(O)

指定したモニターセット名を見直してコマンドを再実行してください。モニターセット名は，トランザクションコードRZ20などで確認できます。モニターセット名は，「監視セット」と表記されていることもあります。なお，モニターセット名の大文字・小文字は区別されます。

KAVF14233-E

The specified monitor name is invalid. (指定されたモニター名)
指定されたモニター名は無効です（指定されたモニター名）

次のどちらかで指定したモニター名が定義されていないか，または無効です（BAPIエラー）。

jr3algetコマンドの-mnオプション

環境パラメーター設定ファイル（TARGETセクションのMONITORラベル）

このメッセージの直前に，エラーが発生した汎用モジュール名と詳細情報を示すメッセージKAVF14222-EおよびKAVF14223-Eが出力されています。

(S)

コマンドの実行を中止します。

(O)

指定したモニター名を見直してコマンドを再実行してください。モニターセット名とモニター名は，トランザクションコードRZ20などで確認できます。モニターセット名は，「監視セット」と表記されていることもあります。なお，モニター名の大文字・小文字は区別されます。

KAVF14240-E

The command execution will be terminated because the system resources are insufficient.
システムリソースが不足したため処理を打ち切ります

メモリーが不足しているため，処理を続行できません。

(S)

コマンドの実行を中止します。

(O)

不要なアプリケーションを終了するか，メモリーを拡張したあと再度コマンドを実行してください。

KAVF14241-E

A file or directory cannot be opened. (エラーが発生したファイル名またはディレクトリ名)
ファイルまたはディレクトリをオープンできません（エラーが発生したファイル名またはディレクトリ名）

ファイルまたはディレクトリのオープンまたは作成時にエラーが発生しました。エラーが発生したファイル名またはディレクトリ名が相対パスで示されている場合，コマンドの作業ディレクトリからの相対パスを示します。ただし，環境パラメーター設定ファイルで別の作業ディレクトリを指定した場合，カレントディレクトリと異なることがあります。このエラーが発生する要因として次のことが考えられます。

ファイルまたはディレクトリが存在しない（既存ファイルをオープンするとき）

コマンド実行ユーザーにこのファイルまたはディレクトリをオープンする適切な権限がない

ファイルまたはディレクトリを作成するためのシステムリソースが不足している

(S)

コマンドの実行を中止します。

(O)

コマンド実行ユーザーの権限と，エラーが発生したファイル名またはディレクトリ名が示すパスの状態を確認して，問題を取り除いてから再度コマンドを実行してください。

KAVF14242-E

The available free space is insufficient for extending the file or directory. (エラーが発生したファイル名またはディレクトリ名)
ファイルまたはディレクトリを拡張するための空き領域がありません（エラーが発生したファイル名またはディレクトリ名）

オープン済みのファイルまたはディレクトリの領域を拡張する際に，ディスク容量不足が発生しました。エラーが発生したファイル名またはディレクトリ名が相対パスで示されている場合，コマンドの作業ディレクトリからの相対パスを示します。ただし，環境パラメーター設定ファイルで別の作業ディレクトリを指定した場合，カレントディレクトリと異なることがあります。なお，標準入出力に対するアクセスでエラーが発生した場合，エラーが発生したファイル名またはディレクトリ名には，空の文字列が出力されます。

(S)

コマンドの実行を中止します。

(O)

エラーが発生したファイル名またはディレクトリ名が示すファイルシステムの空き容量を増やすか，またはファイルの作成先を変更してから再度コマンドを実行してください。

KAVF14243-E

An error occurred during the accessing of the file or directory. (エラーが発生したファイル名またはディレクトリ名)
ファイルまたはディレクトリをアクセス中にエラーが発生しました（エラーが発生したファイル名またはディレクトリ名）

ファイルまたはディレクトリに対する一般アクセスでI/Oエラーが発生しました。エラーが発生したファイル名またはディレクトリ名が相対パスで示されている場合，コマンドの作業ディレクトリからの相対パスを示します。ただし，環境パラメーター設定ファイルで別の作業ディレクトリを指定した場合，カレントディレクトリと異なることがあります。なお，標準入出力に対するアクセスでエラーが発生した場合，エラーが発生したファイル名またはディレクトリ名には空の文字列が出力されます。

(S)

コマンドの実行を中止します。

(O)

エラーが発生したファイル名またはディレクトリ名が示すパスの状態を確認して，問題を取り除いてから再度コマンドを実行してください。

KAVF14250-W

A specified environment parameter is invalid. (section=セクション名, label=ラベル名)
環境パラメーターの指定に誤りがあります（section=セクション名, label=ラベル名）

メッセージのセクション名およびラベル名が示す，環境パラメーター設定ファイルの環境パラメーターの値に誤りがあります。このエラーが発生する要因として次のことが考えられます。

値の長さが制限値を超えている

値に指定できない文字が含まれている

指定できる範囲外の数値が指定されている

(S)

指定値を無効にして処理を続行します。この警告によってコマンドが異常終了することはありません。

(O)

環境パラメーター設定ファイルの指定値を見直してください。-cnfオプションで環境パラメーター設定ファイルを指定しない場合，デフォルト環境パラメーター設定ファイル（カレントディレクトリ下の「コマンド名.ini」）が参照されます。

KAVF14251-E

A required option is missing.
省略できないオプションが指定されていません

指定しなければならないオプションまたは指定の組み合わせによって省略できないオプションが指定されていません。例えば，RFC接続情報について引数で-hオプションを指定するとき，-sオプションは省略できません。

(S)

コマンドの実行を中止します。

(O)

コマンド文法を見直して再度実行してください。

KAVF14253-E

The option value is invalid. (オプション)
オプションの値の指定に誤りがあります（オプション）

オプションで示す値の指定に誤りがあります。このエラーが発生する要因として次のことが考えられます。

値が省略されている

値の長さが制限値を超えている

値に指定できない文字が含まれている

指定できる範囲外の数値が指定されている

(S)

コマンドの実行を中止します。

(O)

コマンド文法を見直して再度実行してください。

KAVF14254-E

An option is invalid. (オプション)
無効なオプションです（オプション）

オプションで示す文字列は，オプションとして認識されません。

(S)

コマンドの実行を中止します。

(O)

コマンド文法を見直して再度実行してください。

KAVF14255-E

Mutually-exclusive options are specified.
同時に指定できないオプションが指定されています

同時に指定できないオプションが指定されています。例えば，出力先を指定する-xオプションと-x2オプションは同時に指定できません。

(S)

コマンドの実行を中止します。

(O)

コマンド文法を見直して再度実行してください。

KAVF14256-E

An option is duplicated. (オプション)
オプションが重複指定されています（オプション）

オプションで示すオプションは，複数指定できません。

(S)

コマンドの実行を中止します。

(O)

コマンド文法を見直して再度実行してください。

KAVF14257-E

Mutually exclusive keys or section names are specified as environment parameters.
環境パラメーターの指定に同時に指定できないキー・セクション名が指定されています

環境パラメーター設定ファイルで，同時に指定できないキー・セクション名が指定されています。このエラーが発生する要因として次のことが考えられます。

パスワード指定のPASSWDセクションとPASSWD2セクションは同時に指定できません。

(S)

コマンドの実行を中止します。

(O)

環境パラメーター設定ファイルの指定値を見直してください。

KAVF14260-E

The specified RFC connection parameter (destination) is incomplete.
RFC接続情報（宛先）の指定が不完全です

引数（-hおよび-sオプション）が省略されましたが，環境パラメーター設定ファイル内に環境パラメーター「RFC接続情報」が定義されていないか，誤りがあるため，処理を続行できません。引数を省略する場合は，環境パラメーター設定ファイルのCONNECTセクション中に，次の項目を正しく定義してください。

アプリケーションサーバホスト（ASHOST）

システム番号（SYSNR）

(S)

コマンドの実行を中止します。

(O)

環境パラメーター設定ファイルの指定値を見直して，コマンドを再実行してください。なお，-cnfオプションで環境パラメーター設定ファイルを指定しない場合，デフォルト環境パラメーター設定ファイル（カレントディレクトリ下の「コマンド名.ini」）が参照されます。

KAVF14261-E

The specified RFC connection parameter (logon) is incomplete.
RFC接続情報（ログオン）の指定が不完全です

引数（-c，-u，および-pオプション）が省略されましたが，環境パラメーター設定ファイル内に環境パラメーター「RFC接続情報」が定義されていないか，誤りがあるため，処理を続行できません。引数を省略する場合は，環境パラメーター設定ファイルのCONNECTセクション中に，次の項目を定義してください。

クライアント（CLIENT）

ユーザー（USER）

パスワード（PASSWD）

(S)

コマンドの実行を中止します。

(O)

環境パラメーター設定ファイルの指定値を見直して，コマンドを再実行してください。なお，-cnfオプションで環境パラメーター設定ファイルを指定しない場合，はデフォルト環境パラメーター設定ファイル（カレントディレクトリ下の「コマンド名.ini」）が参照されます。

KAVF14262-E

The specified target is incomplete.
ターゲットの指定が不完全です

jr3slgetコマンドの場合
引数（-server）が省略されましたが，環境パラメーター設定ファイル内に環境パラメーター「ターゲット」が定義されていないか，誤りがあるため，処理を続行できません。引数を省略する場合は，環境パラメーター設定ファイルのTARGETセクション中に，次の項目を定義してください。
・アプリケーションサーバ（SERVER）

jr3algetコマンドの場合
引数（-msおよび-mn）が省略されましたが，環境パラメーター設定ファイル内に環境パラメーター「ターゲット」が定義されていないか，誤りがあるため，処理を続行できません。引数を省略する場合は，環境パラメーター設定ファイルのTARGETセクション中に，次の項目を定義してください。
・モニターセット名（MONITOR_SET）
・モニター名（MONITOR）

(S)

コマンドの実行を中止します。

(O)

環境パラメーター設定ファイルの指定値を見直して，コマンドを再実行してください。なお，-cnfオプションで環境パラメーター設定ファイルを指定しないときはデフォルト環境パラメーター設定ファイル（カレントディレクトリ下の「コマンド名.ini」）が参照されます。

KAVF14263-E

The specified output place is incomplete.
出力先の指定が不完全です

-x2オプションが指定されましたが，環境パラメーター設定ファイルのEXTRACTFILEセクションのX2PATHラベルに出力先のパスが定義されていないか，または指定に誤りがあるため処理を続行できません。

(S)

コマンドの実行を中止します。

(O)

環境パラメーター設定ファイルの指定値を見直して，コマンドを再度実行してください。なお，-cnfオプションで環境パラメーター設定ファイルを指定しないときは，デフォルト環境パラメーター設定ファイル（カレントディレクトリ下の「コマンド名.ini」）が参照されます。

KAVF14270-E

The environment parameter settings file cannot be accessed. (エラーが発生した環境パラメーター設定ファイルのパス名)
環境パラメーター設定ファイルにアクセスできません（エラーが発生した環境パラメーター設定ファイルのパス名）

-cnfオプションで指定された環境パラメーター設定ファイルにアクセスできません。エラーが発生した環境パラメーター設定ファイルのパス名が相対パスで示されている場合，カレントディレクトリからの相対パスを示します。このエラーが発生する要因として次のことが考えられます。

ファイルが存在しない

コマンド実行ユーザーに対して読み込みのアクセス権限がない

(S)

コマンドの実行を中止します。

(O)

コマンド実行ユーザーの権限と，エラーが発生した環境パラメーター設定ファイルのパス名が示すパスの状態を確認して，問題を取り除いてから再度コマンドを実行してください。

KAVF14271-W

The trace file cannot be accessed. (エラーが発生したトレースファイルのパス名)
トレースファイルにアクセスできません（エラーが発生したトレースファイルのパス名）

トレースファイルのオープンまたは書き込み処理で，1回以上のエラーが発生しました。保守情報がまったく採取されないか，欠落している可能性があります。エラーが発生したトレースファイルのパス名が相対パスで示されている場合，コマンドの作業ディレクトリからの相対パスを示します。ただし，環境パラメーター設定ファイルで別の作業ディレクトリを指定した場合，カレントディレクトリと異なることがあります。このエラーが発生する要因として次のことが考えられます。

ファイルが存在しない

コマンド実行ユーザーに対して読み込みおよび書き込みのアクセス権限がない

(S)

処理を続行します。この警告によってコマンドが異常終了することはありません。

(O)

コマンド実行ユーザーの権限と，エラーが発生したトレースファイルのパス名が示すパスの状態を確認して，問題を取り除いてください。なお，トレースファイルの出力先は，環境パラメーター設定ファイルで変更できます。

KAVF14272-E

The work directory cannot be changed. (作業ディレクトリ)
作業ディレクトリを変更できません（作業ディレクトリ）

環境パラメーター設定ファイルで指定されたパス（COMMANDセクションのWORKDIRラベルに指定されている値）に作業ディレクトリを変更できません。このエラーが発生する要因として次のことが考えられます。

無効なパスが指定されている

指定したディレクトリがディレクトリではない

ディレクトリに実行（サーチ）権限がない

(S)

コマンドの実行を中止します。

(O)

環境パラメーター設定ファイルで指定されたパス（COMMANDセクションのWORKDIRラベルに指定されている値）の指定を見直して，問題を取り除いてから再度コマンドを実行してください。

KAVF14273-I

The time-stamp file was initialized. (タイムスタンプファイル名)
タイムスタンプファイルを初期化しました（タイムスタンプファイル名）

タイムスタンプファイルを新規作成し，管理情報を初期化しました。-lasttimeオプションを指定したコマンドの初回実行時（指定されたタイムスタンプファイルが存在しないとき）に出力されます。このメッセージは，コマンドに-vオプションが指定されたときにだけ出力されます。

(S)

コマンドを正常終了します。

(O)

差分情報は，次回以降のコマンド実行時に出力されます。同じタイムスタンプファイルを指定して，再度コマンドを実行してください。

KAVF14274-E

The time-stamp file cannot be updated. (タイムスタンプファイル名)
タイムスタンプファイルを更新できません（タイムスタンプファイル名）

タイムスタンプファイルを更新する際に予期しないエラーが発生しました。コマンドの処理結果を格納できなかったため，次回のコマンド実行時に，レコードが重複して報告されるなど，差分レコードを正しく報告できない可能性があります。

(S)

コマンドの実行を中止します。

(O)

タイムスタンプファイルのパス名が示すパスの状態を確認して問題を取り除いてください。

KAVF14275-I

Number of processing records: 処理レコード数
処理レコード数: 処理レコード数

コマンドが報告したレコードの数を示します。このメッセージは，コマンドに-vオプションが指定されたときにだけ出力されます。

(S)

処理を続行します。

KAVF14276-W

The specified output format column value is invalid. (指定値)
出力書式の列値の指定に誤りがあります（指定値）

環境パラメーター設定ファイルのFORMATセクションのCOLUMNラベルに指定した値に誤りがあります。

(S)

該当する列の値の指定を無効にして処理を続行します（表示する列が少なくなります）。この警告によって，コマンドの実行は中止しません。

(O)

環境パラメーター設定ファイルのFORMATセクションのCOLUMNラベルに，有効なフィールドIDを指定してください。フィールドIDについては，「10.　コマンド」を参照してください。-cnfオプションで環境パラメーター設定ファイルを指定しないときは，デフォルト環境パラメーター設定ファイル（カレントディレクトリ下の「コマンド名.ini」）が参照されます。

KAVF14277-I

The time-stamp file was updated. (タイムスタンプファイル名)
タイムスタンプファイルを更新しました（タイムスタンプファイル名）

タイムスタンプファイルを更新しました。このメッセージは，コマンドに-vオプションが指定されたときにだけ出力されます。

(S)

コマンドを正常終了します。

KAVF14278-E

The time-stamp file format is invalid. (エラーが発生したタイムスタンプファイル名)
タイムスタンプファイルの形式が不正です（エラーが発生したタイムスタンプファイル名）

-lasttimeオプションで指定したファイルは，タイムスタンプファイルではありません。エラーが発生したタイムスタンプファイル名が相対パスで示されている場合，コマンドの作業ディレクトリからの相対パスを示します。ただし，環境パラメーター設定ファイルで別の作業ディレクトリを指定した場合，カレントディレクトリと異なることがあります。

(S)

コマンドの実行を中止します。

(O)

正しいタイムスタンプファイルを指定してコマンドを再実行してください。ファイルアクセスエラーなどでタイムスタンプファイルの管理情報が破壊された場合，タイムスタンプファイルを削除して再作成してください。

12.　トラブルへの対処方法

この章では，Performance Managementの運用中にトラブルが発生した場合の対処方法などについて説明します。ここでは，主にPFM - Agentでトラブルが発生した場合の対処方法について記載しています。Performance Managementシステム全体のトラブルへの対処方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

＜この章の構成＞

12.1　対処の手順

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

12.3　ログ情報

12.4　トラブル発生時に採取が必要な資料

12.5　資料の採取方法

12.6　Performance Managementの障害検知

12.7　Performance Managementシステムの障害回復

12.1　対処の手順

Performance Managementでトラブルが起きた場合の対処の手順を次に示します。

現象の確認

次の内容を確認してください。

トラブルが発生したときの現象

メッセージの内容（メッセージが出力されている場合）

共通メッセージログなどのログ情報

各メッセージの要因と対処方法については，「11.　メッセージ」を参照してください。また，Performance Managementが出力するログ情報については，「12.3　ログ情報」を参照してください。

資料の採取

トラブルの要因を調べるために資料の採取が必要です。「12.4　トラブル発生時に採取が必要な資料」および「12.5　資料の採取方法」を参照して，必要な資料を採取してください。

問題の調査

採取した資料を基に問題の要因を調査し，問題が発生している部分，または問題の範囲を切り分けてください。

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

ここでは，Performance Management使用時のトラブルシューティングについて記述します。Performance Managementを使用しているときにトラブルが発生した場合，まず，この節で説明している現象が発生していないか確認してください。

Performance Managementに発生する主なトラブルの内容を次の表に示します。

表12-1　トラブルの内容

分類
トラブルの内容
記述個所

セットアップやサービスの起動について

Performance Managementのプログラムのサービスが起動しない

サービスの起動要求をしてからサービスが起動するまで時間が掛かる

Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

12.2.1

コマンドの実行について

jpcctrl listコマンドを実行すると稼働していないサービス名が出力される

jpcctrl dumpコマンドを実行すると，指定したStoreデータと異なるデータが出力される

12.2.2

アラームの定義について

アクション実行で定義したプログラムが正しく動作しない

アラームイベントが表示されない

12.2.3

パフォーマンスデータの収集と管理について

データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

12.2.4

＜この節の構成＞

12.2.1　セットアップやサービスの起動について

12.2.2　コマンドの実行について

12.2.3　アラームの定義について

12.2.4　パフォーマンスデータの収集と管理について

12.2.5　その他のトラブルについて

12.2.1　セットアップやサービスの起動について

セットアップやサービスの起動に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　Performance Managementのプログラムのサービスが起動しない

(2)　サービスの起動要求をしてからサービスが起動するまで時間が掛かる

(3)　Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

(4)　「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

(1)　Performance Managementのプログラムのサービスが起動しない

考えられる要因およびその対処方法を次に示します。

PFM - Managerが停止している
PFM - ManagerとPFM - Agentが同じホストにある場合，PFM - Managerが停止していると，PFM - Agentサービスは起動できません。PFM - Managerサービスが起動されているか確認してください。PFM - Managerサービスが起動されていない場合は，起動してください。サービスの起動方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

Performance Managementのプログラムの複数のサービスに対して同一のポート番号を設定している
Performance Managementのプログラムの複数のサービスに対して同一のポート番号を設定している場合，Performance Managementのプログラムのサービスは起動できません。デフォルトでは，ポート番号は自動的に割り当てられるため，ポート番号が重複することはありません。Performance Managementのセットアップ時にPerformance Managementのプログラムのサービスに対して固定のポート番号を設定している場合は，ポート番号の設定を確認してください。Performance Managementのプログラムの複数のサービスに対して同一のポート番号を設定している場合は，異なるポート番号を設定し直してください。ポート番号の設定については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

Storeデータベースの格納ディレクトリの設定に誤りがある
次のディレクトリを，アクセスできないディレクトリまたは存在しないディレクトリに設定していると，Agent Storeサービスは起動できません。ディレクトリ名や属性の設定を見直し，誤りがあれば修正してください。

Storeデータベースの格納先ディレクトリ

Storeデータベースのバックアップ先ディレクトリ

Storeデータベースのエクスポート先ディレクトリ

Storeデータベースの部分バックアップ先ディレクトリ（Storeバージョン2.0の場合）

Storeデータベースのインポート先ディレクトリ（Storeバージョン2.0の場合）

また，これらのディレクトリを複数のAgent Storeサービスに対して設定していると，Agent Storeサービスは起動できません。ディレクトリ設定を見直し，誤りがあれば修正してください。

指定された方法以外の方法でマシンのホスト名を変更した
マシンのホスト名の変更方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。指定された方法以外の方法でホスト名を変更した場合，Performance Managementのプログラムのサービスが起動しないことがあります。

サービスコントロールマネージャでエラーが発生した
Windowsでjpcstartコマンドを実行した場合，「Windowsのサービスコントロールマネージャでエラーが発生しました」というエラーメッセージが出力され，サービスの起動に失敗することがあります。この現象が発生した場合，jpcstartコマンドを再実行してください。頻繁に同じ現象が発生する場合は，jpcstartコマンド実行時にサービス起動処理がリトライされる間隔および回数を，jpccomm.iniファイルを編集して変更してください。リトライ間隔およびリトライ回数を変更する方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

SAPシステムが停止している
インスタンス環境構築時に「DELAYCONNECT=N」を設定した場合，SAPシステム接続時にSAPシステムが停止していると，Agent Collectorサービスは起動できません。SAPシステムが稼働しているかどうか確認してください。SAPシステムの稼働状況に関係なくAgent Collectorサービスを起動したい場合，「DELAYCONNECT=Y」を設定してください。

(2)　サービスの起動要求をしてからサービスが起動するまで時間が掛かる

jpcstartコマンドを実行してから，または［サービス］アイコンでサービスを開始してから，実際にサービスが起動するまで時間が掛かることがあります。次の要因で時間が掛かっている場合，2回目の起動時からはサービスの起動までに掛かる時間が短縮されます。

システム停止時にサービスを自動で停止させる設定をしないで，システムを再起動してサービスを起動すると，Storeデータベースのインデックスが再構築される場合があります。この場合，サービスが起動するまでに時間が掛かることがあります。

エージェントを新規に追加したあとサービスを起動すると，初回起動時だけStoreデータベースのインデックスが作成されます。そのため，サービスが起動するまでに時間が掛かることがあります。

電源切断などによってStoreサービスが正常な終了処理を行えなかったときは，再起動時にStoreデータベースのインデックスが再構築されるため，Storeサービスの起動に時間が掛かることがあります。

(3)　Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

Performance Managementのプログラムのサービスを停止した直後に，このサービスが使用していたポート番号で，ほかのプログラムがサービスを開始した場合，通信が正しく実行されないことがあります。この現象を回避するために，次のどちらかの設定をしてください。

Performance Managementのプログラムのサービスのポート番号を固定する
Performance Managementのプログラムの各サービスに対して，固定のポート番号を割り当てて運用してください。ポート番号の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

TCP_TIMEWAIT値の設定をする
TCP_TIMEWAIT値で接続待ち時間を設定してください。
HP-UX(PA-RISC)，HP-UX(IPF)，AIXの場合，次のように指定して，接続待ち時間を75秒以上にしてください。

HP-UX(PA-RISC)，HP-UX(IPF)の場合：tcp_time_wait_interval:240000

AIXの場合：tcp_timewait:5

Windows，Solarisの場合，接続待ち時間をデフォルトの設定としてください。デフォルト値は，次のとおりです。

Solarisの場合：4分

Windows 2000の場合：4分

Windows Server 2003，Windows Server 2003(IPF)の場合：2分

(4)　「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

Storeデータベースが使用しているディスクに十分な空き容量がない場合，Storeデータベースへのデータの格納が中断されます。この場合，「ディスク容量が不足しています」というメッセージが出力されたあと，Master StoreサービスまたはAgent Storeサービスが停止します。

このメッセージが表示された場合，次のどちらかの対処をしてください。

十分なディスク容量を確保する
Storeデータベースのディスク占有量を見積もり，Storeデータベースの格納先を十分な容量があるディスクに変更してください。Storeデータベースのディスク占有量を見積もる方法については，「付録A　システム見積もり」を参照してください。Storeデータベースの格納先を変更する方法については，Windowsの場合は「2.4.1　パフォーマンスデータの格納先の変更」を参照してください。UNIXの場合は「3.4.1　パフォーマンスデータの格納先の変更」を参照してください。

Storeデータベースの保存条件を変更する
Storeデータベースの保存条件を変更し，Storeデータベースのデータ量の上限値を調整してください。Storeデータベースの保存条件を変更する方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

これらの対処を実施したあともMaster StoreサービスまたはAgent Storeサービスが起動されない場合，Storeデータベースに回復できない論理矛盾が発生しています。この場合，バックアップデータからStoreデータベースをリストアしたあと，Master StoreサービスまたはAgent Storeサービスを起動してください。利用できるバックアップデータが存在しない場合は，Storeデータベースを初期化したあと，Master StoreサービスまたはAgent Storeサービスを起動してください。Storeデータベースを初期化するには，Storeデータベースの格納先ディレクトリにある次のファイルをすべて削除してください。

拡張子が.DBであるファイル

拡張子が.IDXであるファイル

Storeデータベースの格納先ディレクトリについては，Windowsの場合は「2.4.1　パフォーマンスデータの格納先の変更」を参照してください。UNIXの場合は「3.4.1　パフォーマンスデータの格納先の変更」を参照してください。

12.2.2　コマンドの実行について

Performance Managementのコマンドの実行に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　jpcctrl listコマンドを実行すると稼働していないサービス名が出力される

(2)　jpcctrl dumpコマンドを実行すると，指定したStoreデータと異なるデータが出力される

(1)　jpcctrl listコマンドを実行すると稼働していないサービス名が出力される

考えられる要因およびその対処方法を次に示します。

Performance Managementのプログラムのサービス情報を削除しないでPerformance Managementのプログラムをアンインストールした
Performance ManagementのプログラムをアンインストールしてもPerformance Managementのプログラムのサービス情報はデータベースに残っています。jpcctrl deleteコマンドを実行して，Performance Managementのプログラムのサービス情報を削除してください。サービス情報の削除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

Performance Managementのプログラムのサービス情報を削除しないでマシンのホスト名を変更した
Performance Managementのプログラムのサービス情報を削除しないでマシンのホスト名を変更した場合，以前のホスト名が付加されているサービスIDのサービス情報が，Master Managerサービスが管理しているデータベースに残っています。jpcctrl deleteコマンドを実行して，Performance Managementのプログラムのサービス情報を削除してください。サービス情報の削除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。ホスト名の変更方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(2)　jpcctrl dumpコマンドを実行すると，指定したStoreデータと異なるデータが出力される

同じMaster StoreサービスまたはAgent Storeサービスに対して，同じエクスポートファイル名を指定して，複数回jpcctrl dumpコマンドを実行すると，先に実行した出力結果があとから実行された実行結果に上書きされます。同じMaster StoreサービスまたはAgent Storeサービスに対して，複数回jpcctrl dumpコマンドを実行する場合は，異なる名称のエクスポートファイルを指定してください。Storeデータのエクスポート方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

12.2.3　アラームの定義について

Performance Managementのアラームの定義に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　アクション実行で定義したプログラムが正しく動作しない

(2)　アラームイベントが表示されない

(1)　アクション実行で定義したプログラムが正しく動作しない

考えられる要因とその対処方法を次に示します。

PFM - Managerまたはアクション実行先ホストのAction Handlerサービスが起動されていない
PFM - Managerまたはアクション実行先ホストのAction Handlerサービスが停止していると，アクションが実行されません。アクションを実行する場合は，PFM - Managerおよびアクション実行先ホストのAction Handlerサービスを起動しておいてください。

(2)　アラームイベントが表示されない

考えられる要因とその対処方法を次に示します。

PFM - Managerが起動されていない
PFM - Managerを停止すると，PFM - Agentからのアラームイベントを正しく発行できません。アラームイベントを監視する場合は，PFM - Managerを起動しておいてください。

12.2.4　パフォーマンスデータの収集と管理について

Performance Managementのパフォーマンスデータの収集と管理に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

(2)　共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

(1)　データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

Storeデータベースのファイル容量がすでに限界に達している場合，データの保存期間を短く設定してもファイルサイズは小さくなりません。この場合，保存期間を短く設定したあと，いったんStoreデータベースをバックアップし，リストアし直してください。

データの保存期間の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。また，Storeデータベースのバックアップとリストアの方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，バックアップとリストアについて説明している章を参照してください。

(2)　共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

予期しないサービスの停止またはマシンのシャットダウンによって，Storeデータベースに不整合なデータが発生した可能性があります。次の方法で対処してください。

Storeデータベースをバックアップしてある場合は，Storeデータベースをリストアしてください。

Storeデータベースをバックアップしていない場合は，Agent Storeサービスを停止したあと，対応するデータベースファイル（*.DBファイルおよび*.IDXファイル）を削除し，サービスを再起動してください。

12.2.5　その他のトラブルについて

トラブルが発生したときの現象を確認してください。メッセージが出力されている場合は，メッセージの内容を確認してください。また，Performance Managementが出力するログ情報については，「12.3　ログ情報」を参照してください。

「12.2.1　セットアップやサービスの起動について」から「12.2.4　パフォーマンスデータの収集と管理について」に示した対処をしても，トラブルが解決できなかった場合，または，これら以外のトラブルが発生した場合，トラブルの要因を調査するための資料を採取し，システム管理者に連絡してください。

採取が必要な資料および採取方法については，「12.4　トラブル発生時に採取が必要な資料」および「12.5　資料の採取方法」を参照してください。

12.3　ログ情報

Performance Managementでトラブルが発生した場合，ログ情報を確認して対処方法を検討します。Performance Managementを運用しているときに出力されるログ情報には，次の4種類があります。

システムログ

共通メッセージログ

稼働状況ログ

トレースログ

ここでは，4種類のログ情報，および各ログ情報に設定できるログオプションについて説明します。

＜この節の構成＞

12.3.1　ログ情報の種類

12.3.2　ログファイルおよびディレクトリ一覧

12.3.1　ログ情報の種類

＜この項の構成＞

(1)　システムログ

(2)　共通メッセージログ

(3)　稼働状況ログ

(4)　トレースログ

(1)　システムログ

システムログとは，システムの状態やトラブルを通知するログ情報のことです。このログ情報は次のログファイルに出力されます。

Windowsの場合
イベントログファイル

UNIXの場合
syslogファイル

出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

論理ホスト運用の場合の注意事項

Performance Managementのシステムログのほかに，クラスタソフトによるPerformance Managementの制御などを確認するためにクラスタソフトのログが必要です。

(2)　共通メッセージログ

共通メッセージログとは，システムの状態やトラブルを通知するログ情報のことです。システムログよりも詳しいログ情報が出力されます。共通メッセージログの出力先ファイル名やファイルサイズについては，「12.3.2　ログファイルおよびディレクトリ一覧」を参照してください。また，出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

論理ホスト運用の場合の注意事項

論理ホスト運用のPerformance Managementの場合，共通メッセージログは共有ディスクに出力されます。共有ディスク上にあるログファイルは，フェールオーバーするときにシステムとともに引き継がれますので，メッセージは同じログファイルに記録されます。

(3)　稼働状況ログ

稼働状況ログとは，PFM - Web Consoleが出力するログ情報のことです。稼働状況ログの出力先ファイル名やファイルサイズについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。また，出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

(4)　トレースログ

トレースログとは，トラブルが発生した場合に，トラブル発生の経緯を調査したり，各処理の処理時間を測定したりするために採取するログ情報のことです。

トレースログは，Performance Managementのプログラムの各サービスが持つログファイルに出力されます。

論理ホスト運用の場合の注意事項

論理ホスト運用のPerformance Managementの場合，トレースログは共有ディスクに出力されます。共有ディスク上にあるログファイルは，フェールオーバーするときにシステムとともに引き継がれますので，メッセージは同じログファイルに記録されます。

12.3.2　ログファイルおよびディレクトリ一覧

ここでは，Performance Managementから出力されるログ情報について説明します。稼働状況ログの出力先ファイル名やファイルサイズについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

＜この項の構成＞

(1)　共通メッセージログ

(2)　トレースログ

(1)　共通メッセージログ

ここでは，Performance Managementのログ情報のうち，共通メッセージログについて，ログの出力元であるサービス名または制御名，ログファイル名，およびディスク使用量を，OSごとに表に示します。

表12-2　共通メッセージログのファイル名（Windowsの場合）

ログ情報の種類
出力元
ファイル名
ディスク使用量※1（キロバイト）

共通メッセージログ
Performance Management
インストール先フォルダ¥log¥jpclog{01|02}※2
2,048
(＊2)

インストール先フォルダ¥log¥jpclogw{01|02}※2
2,048
(＊2)

共通メッセージログ（論理ホスト運用の場合）
論理ホスト運用のPerformance Management
環境ディレクトリ※3¥jp1pc¥log¥jpclog{01|02}※2
2,048
(＊2)

環境ディレクトリ※3¥jp1pc¥log¥jpclogw{01|02}※2
2,048
(＊2)

注※1

（　）内の数字は，一つのサービスに対して作成されるログファイルの数を示します。例えば，「2,048(＊2)」の場合，ディスク使用量が2,048キロバイトのログファイルが最大で二つ作成されることを示します。この場合，ディスク使用量は合計で4,096キロバイトとなります。

注※2

共通メッセージログのログファイル名には，末尾に「01」または「02」が付加されます。

シーケンシャルファイル（jpclog）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ログファイル名の末尾が「01」から「02」に変更され，ファイル名の末尾が「01」のログファイルが新規作成されます。その後出力されるログ情報は，末尾が「01」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，上書きされます。最新のログは常にファイル名の末尾が「01」のログファイルに出力されます。

ラップラウンドファイル（jpclogw）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ファイル名の末尾が「02」のログファイルが新規作成されます。その後出力されるログ情報は，末尾が「02」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，一度データをすべて削除し，先頭行からログが出力されます。そのあとログの出力ファイルが交互に入れ替わります。

ログファイルの出力方式については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※3

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

表12-3　共通メッセージログのファイル名（UNIXの場合）

ログ情報の種類
出力元
ファイル名
ディスク使用量※1（キロバイト）

共通メッセージログ
Performance Management
/opt/jp1pc/log/jpclog{01|02}※2
2,048
(＊2)

/opt/jp1pc/log/jpclogw{01|02}※2
2,048
(＊2)

共通メッセージログ（論理ホスト運用の場合）
論理ホスト運用のPerformance Management
環境ディレクトリ※3/jp1pc/log/jpclog{01|02}※2
2,048
(＊2)

環境ディレクトリ※3/jp1pc/log/jpclogw{01|02}※2
2,048
(＊2)

注※1

（　）内の数字は，一つのサービスに対して作成されるログファイルの数を示します。例えば，「2,048(＊2)」の場合，ディスク使用量が2,048キロバイトのログファイルが最大で二つ作成されることを示します。この場合，ディスク使用量は合計で4,096キロバイトとなります。

注※2

共通メッセージログのログファイル名には，末尾に「01」または「02」が付加されます。

シーケンシャルファイル（jpclog）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ログファイル名の末尾が「01」から「02」に変更され，ファイル名の末尾が「01」のログファイルが新規作成されます。その後出力されるログ情報は，末尾が「01」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，上書きされます。最新のログは常にファイル名の末尾が「01」のログファイルに出力されます。

ラップラウンドファイル（jpclogw）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ファイル名の末尾が「02」のログファイルが新規作成されます。その後出力されるログ情報は，末尾が「02」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，一度データをすべて削除し，先頭行からログが出力されます。そのあとログの出力ファイルが交互に入れ替わります。

ログファイルの出力方式については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※3

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

(2)　トレースログ

ここでは，Performance Managementのログ情報のうち，PFM - Agentのトレースログの出力元であるサービス名または制御名，および格納先ディレクトリ名を，OSごとに表に示します。

表12-4　トレースログの格納先フォルダ名（Windowsの場合）

ログ情報の種類 | 出力元 | フォルダ名
トレースログ | Agent Collectorサービス | インストール先フォルダ¥agtm¥agent¥インスタンス名¥log¥
Agent Storeサービス | インストール先フォルダ¥agtm¥store¥インスタンス名¥log¥
トレースログ（論理ホスト運用の場合） | Agent Collector | 環境ディレクトリ※¥jp1pc¥agtm¥agent¥インスタンス名¥log¥
Agent Store | 環境ディレクトリ※¥jp1pc¥agtm¥store¥インスタンス名¥log¥

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

表12-5　トレースログの格納先ディレクトリ名（UNIXの場合）

ログ情報の種類 | 出力元 | ディレクトリ名
トレースログ | Agent Collectorサービス | /opt/jp1pc/agtm/agent/インスタンス名/log/
Agent Storeサービス | /opt/jp1pc/agtm/store/インスタンス名/log/
トレースログ（論理ホスト運用の場合） | Agent Collector | 環境ディレクトリ※/jp1pc/agtm/agent/インスタンス名/log/
Agent Store | 環境ディレクトリ※/jp1pc/agtm/store/インスタンス名/log/

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

12.4　トラブル発生時に採取が必要な資料

「12.2　トラブルシューティング」に示した対処をしてもトラブルを解決できなかった場合，トラブルの要因を調べるための資料を採取し，システム管理者に連絡する必要があります。この節では，トラブル発生時に採取が必要な資料について説明します。

Performance Managementでは，採取が必要な資料を一括採取するためのコマンドを用意しています。PFM - Agentの資料を採取するには，jpcrasコマンドを使用します。jpcrasコマンドを使用して採取できる資料については，表中に記号で示しています。

注意

jpcrasコマンドで採取できる資料は，コマンド実行時に指定するオプションによって異なります。コマンドに指定するオプションと採取できる資料については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

論理ホスト運用の場合の注意事項

論理ホスト運用の場合の注意事項を次に示します。

論理ホスト運用する場合のPerformance Managementのログは，共有ディスクに格納されます。なお，共有ディスクがオンラインになっている場合（Windows），またはマウントされている場合（UNIX）は，jpcrasコマンドで共有ディスク上のログも一括して採取することができます。

フェールオーバー時の問題を調査するには，フェールオーバーの前後の資料が必要です。このため，実行系と待機系の両方の資料が必要になります。

論理ホスト運用のPerformance Managementの調査には，クラスタソフトの資料が必要です。論理ホスト運用のPerformance Managementは，クラスタソフトから起動や停止を制御されているので，クラスタソフトの動きとPerformance Managementの動きを対比して調査するためです。

＜この節の構成＞

12.4.1　Windowsの場合

12.4.2　UNIXの場合

12.4.1　Windowsの場合

＜この項の構成＞

(1)　OSのログ情報

(2)　Performance Managementの情報

(3)　オペレーション内容

(4)　画面上のエラー情報

(5)　その他の情報

(1)　OSのログ情報

OSに関する次の情報の採取が必要です。

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

システムログ
Windowsイベントログ
－
○

プロセス情報
プロセスの一覧
－
○

システムファイル
hostsファイル
システムフォルダ¥system32¥drivers¥etc¥hosts
○

servicesファイル
システムフォルダ¥system32¥drivers¥etc¥services
○

OS情報
システム情報
－
○

ネットワークステータス
－
○

ホスト名
－
○

ダンプ情報
ワトソンログファイル

Windows 2000の場合
システムドライブ¥Documents and Settings¥All Users¥Documents¥DrWatson¥drwtsn32.log※
システムドライブ¥Documents and Settings¥All Users¥Documents¥DrWatson¥user.dump※

Windows Server 2003，Windows Server 2003(IPF)の場合
システムドライブ¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥drwtsn32.log※
システムドライブ¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥user.dump※

○

（凡例）

○：採取できる

－：該当しない

注※

別のフォルダにログファイルが出力されるように設定している場合は，該当するフォルダから資料を採取してください。

(2)　Performance Managementの情報

Performance Managementに関する次の情報の採取が必要です。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

共通メッセージログ
Performance Managementから出力されるメッセージログ（シーケンシャルファイル方式）
インストール先フォルダ¥log¥jpclog{01|02}※1
○

Performance Managementから出力されるメッセージログ（ラップラウンドファイル方式）
インストール先フォルダ¥log¥jpclogw{01|02}※1
○

共通メッセージログ（論理ホスト運用の場合）
論理ホスト運用のPerformance Managementから出力されるメッセージログ（シーケンシャルファイル方式）
環境ディレクトリ※²¥jp1pc¥log¥jpclog{01|02}※1
○

論理ホスト運用のPerformance Managementから出力されるメッセージログ（ラップラウンドファイル方式）
環境ディレクトリ※²¥jp1pc¥log¥jpclogw{01|02}※1
○

構成情報
各構成情報ファイル
－
○

jpcctrl listコマンドの出力結果
－
○

バージョン情報
製品バージョン
－
○

履歴情報
－
○

データベース情報
Agent Storeサービス

Storeバージョン1.0の場合
インストール先フォルダ¥agtm¥store¥インスタンス名¥*.DB
インストール先フォルダ¥agtm¥store¥インスタンス名¥*.IDX

Storeバージョン2.0の場合
インストール先フォルダ¥agtm¥store¥インスタンス名¥STPD¥，
インストール先フォルダ¥agtm¥store¥インスタンス名¥STPI¥
フォルダ下の次に示すファイル。
*.DB
*.IDX

○

データベース情報（論理ホスト運用の場合）
論理ホスト運用のAgent Storeサービス

Storeバージョン1.0の場合
環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名¥*.DB
環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名¥*.IDX

Storeバージョン2.0の場合
環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名¥STPD¥，
環境ディレクトリ※²¥jp1pc¥agtm¥store¥インスタンス名¥STPI¥
フォルダ下の次に示すファイル。
*.DB
*.IDX

○

トレースログ
Performance Managementのプログラムの各サービスのトレース情報
－※3
○

インストールログ※4
インストール時のメッセージログ
（Windows 2000，Windows Server 2003の場合）
%TEMP%¥pfm_inst.log
×

インストール時のメッセージログ
（Windows Server 2003(IPF)の場合）
%Windowsディレクトリ%¥TEMP¥HCDINSTディレクトリ下の次に示すファイル。

HCDMAIN.LOGおよびHCDMAINn.LOG※5

HCDINST.LOGおよびHCDINSTn.LOG※5

P-282C-AF84.LOG

×

コマンド情報
環境パラメーター設定ファイル
インストール先フォルダ¥agtm¥agent¥インスタンス名¥jr3alget.ini
インストール先フォルダ¥agtm¥agent¥インスタンス名¥jr3slget.ini
○

トレース情報
－
○

タイムスタンプファイル
－
○

抽出結果ファイル
インストール先フォルダ¥agtm¥agent¥インスタンス名¥log¥ALERT
インストール先フォルダ¥agtm¥agent¥インスタンス名¥log¥SYSLOG
○※6

コマンド情報（論理ホスト運用の場合）
環境パラメーター設定ファイル
環境ディレクトリ※²¥jp1pc¥agtm¥agent¥インスタンス名¥jr3alget.ini
環境ディレクトリ※²¥jp1pc¥agtm¥agent¥インスタンス名¥jr3slget.ini
○

トレース情報
－
○

タイムスタンプファイル
－
○

抽出結果ファイル
環境ディレクトリ※²¥jp1pc¥agtm¥agent¥インスタンス名¥log¥ALERT
環境ディレクトリ※²¥jp1pc¥agtm¥agent¥インスタンス名¥log¥SYSLOG
○※6

（凡例）

○：採取できる

×：採取できない

－：該当しない

注※1

ログファイルの出力方式については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※2

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

注※3

トレースログの格納先フォルダについては，「12.3.2　ログファイルおよびディレクトリ一覧」を参照してください。

注※4

インストールに失敗した場合に採取してください。

注※5

nは数字を示します。

注※6

デフォルトの格納先から変更した場合，jpcrasコマンドでは採取できません。手動で採取してください。

抽出結果ファイルの格納先については，「5.3.2 設定内容」のEXTRACTFILEセクション，および「6.3.2 設定内容」のEXTRACTFILEセクションを参照してください。

(3)　オペレーション内容

トラブル発生時のオペレーション内容について，次に示す情報が必要です。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

(4)　画面上のエラー情報

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー（詳細ボタンがある場合はその内容を含む）

コマンド実行時にトラブルが発生した場合は，［コマンドプロンプト］ウィンドウのハードコピー

(5)　その他の情報

上記以外で必要な情報を次に示します。

Windowsの［イベントビューア］ウィンドウの，［システムログ］および［アプリケーションログ］の内容（Windows 2000の場合）

Windowsの［イベントビューア］ウィンドウの，［システム］および［アプリケーション］の内容（Windows Server 2003，Windows Server 2003(IPF)の場合）

［コンピュータの管理］の［システム情報］の内容，または［アクセサリ］－［システムツール］－［システム情報］の内容（Windows 2000の場合）

［アクセサリ］－［システムツール］－［システム情報］の内容（Windows Server 2003，Windows Server 2003(IPF)の場合）

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

12.4.2　UNIXの場合

＜この項の構成＞

(1)　OSのログ情報

(2)　Performance Managementの情報

(3)　オペレーション内容

(4)　エラー情報

(5)　その他の情報

(1)　OSのログ情報

OSに関する次の情報の採取が必要です。

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

システムログ
syslog

HP-UX(PA-RISC)，HP-UX(IPF)の場合
/var/adm/syslog/syslog.log

Solarisの場合
/var/adm/messages

AIXの場合
－

○※１

プロセス情報
プロセスの一覧
－
○

システムファイル
hostsファイル
/etc/hosts
○

/etc/inet/ipnodes※２
○※３

servicesファイル
/etc/services
○

OS情報
パッチ情報
－
○

カーネル情報
－
○

バージョン情報
－
○

ネットワークステータス
－
○

環境変数
－
○

ホスト名
－
○

ダンプ情報
coreファイル※４
－
○

（凡例）

○：採取できる

－：該当しない

注※1

デフォルトのパスおよびファイル名以外に出力されるように設定されているシステムでは，収集できません。手動で収集してください。

注※2

/etc/inet/ipnodesファイルはSolarisだけに存在するファイルです。/etc/hostsファイルと一緒に収集してください。

注※3

PFM - Manager 08-50以降またはPFM - Base 08-50以降のjpcrasコマンドだけで収集できます。

注※4

HP-UX 11i V3(IPF)では，coreadmコマンドによってcoreファイルの名称を任意に変更できます。ファイル名の先頭が「core」以外に変更されたファイルについては，jpcrasコマンドでは収集できません。手動で収集してください。

(2)　Performance Managementの情報

Performance Managementに関する次の情報の採取が必要です。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

共通メッセージログ
Performance Managementから出力されるメッセージログ（シーケンシャルファイル方式）
/opt/jp1pc/log/jpclog{01|02}※1
○

Performance Managementから出力されるメッセージログ（ラップラウンドファイル方式）
/opt/jp1pc/log/jpclogw{01|02}※1
○

共通メッセージログ（論理ホスト運用の場合）
論理ホスト運用のPerformance Managementから出力されるメッセージログ（シーケンシャルファイル方式）
環境ディレクトリ※²/jp1pc/log/jpclog{01|02}※1
○

論理ホスト運用のPerformance Managementから出力されるメッセージログ（ラップラウンドファイル方式）
環境ディレクトリ※²/jp1pc/log/jpclogw{01|02}※1
○

構成情報
各構成情報ファイル
－
○

jpcctrl listコマンドの出力結果
－
○

バージョン情報
製品バージョン
－
○

履歴情報
－
○

データベース情報
Agent Storeサービス

Storeバージョン1.0の場合
/opt/jp1pc/agtm/store/インスタンス名/*.DB
/opt/jp1pc/agtm/store/インスタンス名/*.IDX

Storeバージョン2.0の場合
/opt/jp1pc/agtm/store/インスタンス名/STPD/，
/opt/jp1pc/agtm/store/インスタンス名/STPI/
ディレクトリ下の次に示すファイル。
*.DB
*.IDX

○

データベース情報（論理ホスト運用の場合）
論理ホスト運用のAgent Storeサービス

Storeバージョン1.0の場合
環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名/*.DB
環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名/*.IDX

Storeバージョン2.0の場合
環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名/STPD/，
環境ディレクトリ※²/jp1pc/agtm/store/インスタンス名/STPI/
ディレクトリ下の次に示すファイル。
*.DB
*.IDX

○

トレースログ
Performance Managementの
プログラムの各サービスのトレース情報
－※3
○

インストールログ※4
Hitachi PP Installerの標準ログ
/etc/.hitachi/.hitachi.log
/etc/.hitachi/.hitachi.log{01|02|03|04|05}
/etc/.hitachi/.install.log
/etc/.hitachi/.install.log{01|02|03|04|05}
×

コマンド情報
環境パラメーター設定ファイル
/opt/jp1pc/agtm/agent/インスタンス名/jr3alget.ini
/opt/jp1pc/agtm/agent/インスタンス名/jr3slget.ini
○

トレース情報
－
○

タイムスタンプファイル
－
○

抽出結果ファイル
/opt/jp1pc/agtm/agent/インスタンス名/log/ALERT
/opt/jp1pc/agtm/agent/インスタンス名/log/SYSLOG
○※5

コマンド情報（論理ホスト運用の場合）
環境パラメーター設定ファイル
環境ディレクトリ※²/jp1pc/agtm/agent/インスタンス名/jr3alget.ini
環境ディレクトリ※²/jp1pc/agtm/agent/インスタンス名/jr3slget.ini
○

トレース情報
－
○

タイムスタンプファイル
－
○

抽出結果ファイル
環境ディレクトリ※²/jp1pc/agtm/agent/インスタンス名/log/ALERT
環境ディレクトリ※²/jp1pc/agtm/agent/インスタンス名/log/SYSLOG
○※5

（凡例）

○：採取できる

×：採取できない

－：該当しない

注※1

ログファイルの出力方式については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※2

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

注※3

トレースログの格納先ディレクトリについては，「12.3.2　ログファイルおよびディレクトリ一覧」を参照してください。

注※4

インストールに失敗した場合に採取してください。

注※5

デフォルトの格納先から変更した場合，jpcrasコマンドでは採取できません。手動で採取してください。

抽出結果ファイルの格納先については，「5.3.2 設定内容」のEXTRACTFILEセクション，および「6.3.2 設定内容」のEXTRACTFILEセクションを参照してください。

(3)　オペレーション内容

トラブル発生時のオペレーション内容について，次に示す情報が必要です。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

(4)　エラー情報

次に示すエラー情報を採取してください。

コマンド実行時にトラブルが発生した場合は，コンソールに出力されたメッセージ

(5)　その他の情報

上記以外で必要な情報を次に示します。

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

12.5　資料の採取方法

トラブルが発生したときに資料を採取する方法を次に示します。

＜この節の構成＞

12.5.1　Windowsの場合

12.5.2　UNIXの場合

12.5.1　Windowsの場合

＜この項の構成＞

(1)　資料採取コマンドを実行する

(2)　資料採取コマンドを実行する（論理ホスト運用の場合）

(3)　Windowsイベントログを確認する

(4)　オペレーション内容を確認する

(5)　画面上のエラー情報を採取する

(6)　その他の情報を採取する

(1)　資料採取コマンドを実行する

トラブルの要因を調べるための資料の採取には，jpcrasコマンドを使用します。資料採取コマンドの実行手順を次に示します。なお，ここで説明する操作は，OSユーザーとしてAdministrators権限を持つユーザーが実行してください。

資料採取するサービスがインストールされているホストにログインする。

コマンドプロンプトで次に示すコマンドを実行して，コマンドインタープリタの「コマンド拡張機能」を有効にする。

cmd /E:ON

採取する資料および資料の格納先フォルダを指定して，jpcrasコマンドを実行する。
jpcrasコマンドで，採取できるすべての情報をc:¥tmp¥jpc¥agtフォルダに格納する場合の，コマンドの指定例を次に示します。

jpcras c:¥tmp¥jpc¥agt all all

jpcrasコマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

(2)　資料採取コマンドを実行する（論理ホスト運用の場合）

論理ホスト運用のPerformance Managementの資料は共有ディスクにあり，資料は実行系と待機系の両方で採取する必要があります。

トラブルの要因を調べるための資料の採取には，jpcrasコマンドを使用します。資料採取コマンドの実行手順を次に示します。なお，ここで説明する操作は，OSユーザーとしてAdministrators権限を持つユーザーが実行してください。

論理ホスト運用の場合の資料採取コマンドの実行について，手順を説明します。

共有ディスクをオンラインにする。
論理ホストの資料は共有ディスクに格納されています。実行系ノードでは，共有ディスクがオンラインになっていることを確認して資料を採取してください。

実行系と待機系の両方で，採取する資料および資料の格納先フォルダを指定して，jpcrasコマンドを実行する。
jpcrasコマンドで，採取できるすべての情報をc:¥tmp¥jpc¥agtフォルダに格納する場合の，コマンドの指定例を次に示します。

jpcras c:¥tmp¥jpc¥agt all all

jpcrasコマンドをlhostの引数を指定しないで実行すると，そのノードの物理ホストと論理ホストのPerformance Managementの資料が一とおり採取されます。論理ホスト環境のPerformance Managementがある場合は，共有ディスク上のログファイルが取得されます。
なお，共有ディスクがオフラインになっているノードでjpcrasコマンドを実行すると，共有ディスク上のファイルを取得できませんが，エラーは発生しないで正常終了します。

注意

実行系ノードと待機系ノードの両方で，資料採取コマンドを実行して資料採取をしてください。フェールオーバーの前後の調査をするには，実行系と待機系の両方の資料が必要です。

jpcrasコマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

クラスタソフトの資料を採取する。
この資料は，クラスタソフトとPerformance Managementのどちらでトラブルが発生しているのかを調査するために必要になります。クラスタソフトからPerformance Managementへの起動停止などの制御要求と結果を調査できる資料を採取してください。

(3)　Windowsイベントログを確認する

Windowsの［イベントビューア］ウィンドウで，Windowsイベントログを確認してください。また，ファイルに出力してください。

(4)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

(5)　画面上のエラー情報を採取する

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー
詳細情報がある場合はその内容をコピーしてください。

コマンド実行時にトラブルが発生した場合は，［コマンドプロンプト］ウィンドウのハードコピー
［コマンドプロンプト］ウィンドウのハードコピーを採取する際は，［"コマンドプロンプト"のプロパティ］ウィンドウについて次のように設定しておいてください。

［オプション］タブの［編集オプション］
［簡易編集モード］がチェックされた状態にする。

［レイアウト］タブ
［画面バッファのサイズ］の［高さ］に「500」を設定する。

(6)　その他の情報を採取する

上記以外で必要な情報を採取してください。

Windowsの［イベントビューア］ウィンドウの，［システムログ］および［アプリケーションログ］の内容（Windows 2000の場合）

Windowsの［イベントビューア］ウィンドウの，［システム］および［アプリケーション］の内容（Windows Server 2003，Windows Server 2003(IPF)の場合）

［コンピュータの管理］の［システム情報］の内容，または［アクセサリ］－［システムツール］－［システム情報］の内容（Windows 2000の場合）

［アクセサリ］－［システムツール］－［システム情報］の内容（Windows Server 2003，Windows Server 2003(IPF)の場合）

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

12.5.2　UNIXの場合

＜この項の構成＞

(1)　資料採取コマンドを実行する

(2)　資料採取コマンドを実行する（論理ホスト運用の場合）

(3)　オペレーション内容を確認する

(4)　エラー情報を採取する

(5)　その他の情報を採取する

(1)　資料採取コマンドを実行する

トラブルの要因を調べるための資料の採取には，jpcrasコマンドを使用します。資料採取コマンドの実行手順を次に示します。なお，ここで説明する操作は，OSユーザーとしてrootユーザー権限を持つユーザーが実行してください。

資料採取するサービスがインストールされているホストにログインする。

採取する資料および資料の格納先ディレクトリを指定して，jpcrasコマンドを実行する。
jpcrasコマンドで，採取できるすべての情報を/tmp/jpc/agtディレクトリに格納する場合の，コマンドの指定例を次に示します。

jpcras /tmp/jpc/agt all all

資料採取コマンドで，収集された資料はtarコマンドおよびcompressコマンドで圧縮された形式で，指定されたディレクトリに格納されます。ファイル名を次に示します。
jpcrasYYMMDD.tar.Z
YYMMDDには年月日が付加されます。

jpcrasコマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

(2)　資料採取コマンドを実行する（論理ホスト運用の場合）

論理ホスト運用のPerformance Managementの資料は共有ディスクにあり，資料は実行系と待機系の両方で採取する必要があります。

トラブルの要因を調べるための資料の採取には，jpcrasコマンドを使用します。資料採取コマンドの実行手順を次に示します。なお，ここで説明する操作は，OSユーザーとしてrootユーザー権限を持つユーザーが実行してください。

論理ホスト運用の場合の，資料採取コマンドの実行について，手順を説明します。

共有ディスクをマウントする。
論理ホストの資料は共有ディスクに格納されています。実行系ノードでは，共有ディスクがマウントされていることを確認して資料を採取してください。

実行系と待機系の両方で，採取する資料および資料の格納先ディレクトリを指定して，jpcrasコマンドを実行する。
jpcrasコマンドで，採取できるすべての情報を/tmp/jpc/agtディレクトリに格納する場合の，コマンドの指定例を次に示します。

jpcras /tmp/jpc/agt all all

資料採取コマンドで収集された資料は，tarコマンドおよびcompressコマンドで圧縮された形式で，指定されたディレクトリに格納されます。ファイル名を次に示します。
jpcrasYYMMDD.tar.Z
YYMMDDには年月日が付加されます。
jpcrasコマンドをlhostの引数を指定しないで実行すると，そのノードの物理ホストと論理ホストのPerformance Managementの資料が一とおり採取されます。論理ホスト環境のPerformance Managementがある場合は，共有ディスク上のログファイルが取得されます。
なお，共有ディスクがマウントされていないノードでjpcrasコマンドを実行すると，共有ディスク上のファイルを取得できませんが，エラーは発生しないで正常終了します。

注意

実行系ノードと待機系ノードの両方で，資料採取コマンドを実行して資料採取をしてください。フェールオーバーの前後の調査をするには，実行系と待機系の両方の資料が必要です。

jpcrasコマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

クラスタソフトの資料を採取する。
この資料は，クラスタソフトとPerformance Managementのどちらでトラブルが発生しているのかを調査するために必要になります。クラスタソフトからPerformance Managementへの起動停止などの制御要求と結果を調査できる資料を採取してください。

(3)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

(4)　エラー情報を採取する

次に示すエラー情報を採取してください。

コマンド実行時にトラブルが発生した場合は，コンソールに出力されたメッセージ

(5)　その他の情報を採取する

上記以外で必要な情報を採取してください。

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

12.6　Performance Managementの障害検知

Performance Managementでは，ヘルスチェック機能を利用することでPerformance Management自身の障害を検知できます。ヘルスチェック機能では，監視エージェントや監視エージェントが稼働するホストの稼働状態を監視し，監視結果を監視エージェントの稼働状態の変化としてPFM - Web Console上に表示します。

また，PFMサービス自動再起動機能を利用することで，PFMサービスが何らかの原因で異常停止した場合に自動的にPFMサービスを再起動したり，定期的にPFMサービスを再起動したりすることができます。

ヘルスチェック機能によって監視エージェントの稼働状態を監視したり，PFMサービス自動再起動機能によってPFMサービスを自動再起動したりするには，Performance Managementのサービスの詳細な状態を確認するステータス管理機能を使用します。このため，対象となる監視エージェントがステータス管理機能に対応したバージョンであり，ステータス管理機能が有効になっている必要があります。ホストの稼働状態を監視する場合は前提となる条件はありません。

また，Performance Managementのログファイルをシステム統合監視製品であるJP1/Baseで監視することによっても，Performance Management自身の障害を検知できます。これによって，システム管理者は，トラブルが発生したときに障害を検知し，要因を特定して復旧の対処をします。

Performance Management自身の障害検知の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

12.7　Performance Managementシステムの障害回復

Performance Managementのサーバで障害が発生したときに，バックアップファイルを基にして，障害が発生する前の正常な状態に回復する必要があります。

障害が発生する前の状態に回復する手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

付録

＜この付録の構成＞

付録A　システム見積もり

付録B　カーネルパラメーター

付録C　識別子一覧

付録D　プロセス一覧

付録E　ポート番号一覧

付録F　PFM - Agent for Enterprise Applicationsのプロパティ

付録G　ファイルおよびディレクトリ一覧

付録H　移行手順と移行時の注意事項

付録I　バージョン互換

付録J　動作ログの出力

付録K　各バージョンの変更内容

付録L　用語解説

付録A　システム見積もり

PFM - Agent for Enterprise Applicationsを使ったシステムを構築する前に，使用するマシンの性能が，PFM - Agent for Enterprise Applicationsを運用するのに十分であるか，見積もっておくことをお勧めします。

見積もり項目を次に説明します。

＜この節の構成＞

付録A.1　メモリー所要量

付録A.2　ディスク占有量

付録A.3　クラスタ運用時のディスク占有量

付録A.1　メモリー所要量

メモリー所要量は，PFM - Agent for Enterprise Applicationsの設定状況や使用状況によって変化します。

＜この項の構成＞

(1)　システム全体のメモリー所要量

(2)　コマンド実行時のメモリー所要量

(1)　システム全体のメモリー所要量

PFM - Agent for Enterprise Applicationsのメモリー所要量の，おおよその見積もりを次の表に示します。初期状態とは，1インスタンスで運用する場合のことを示します。

表A-1　メモリー所要量

PFM - Agent for Enterprise Applicationsの状態
メモリー所要量（単位：メガバイト）

Windows 2000，Windows Server 2003
Windows Server 2003(IPF)
HP-UX
(PA-RISC)
HP-UX
(IPF)
Solaris
AIX

初期状態での運用
32
55
35
55
55
35

初期状態以外での運用
(32+a+b)＊インスタンス数
(55+a+b)＊インスタンス数
(35+a+b)＊インスタンス数
(55+a+b)＊インスタンス数
(55+a+b)＊インスタンス数
(35+a+b)＊インスタンス数

（凡例）

a：CCMS Alert Monitor Command（PD_ALMX）レコードを収集する場合のコマンド（jr3alget）のメモリー所要量。コマンドのメモリー所要量は，「付録A.1(2)　コマンド実行時のメモリー所要量」を参照してください。

b：System Log Monitor Command（PD_SLMX）レコードを収集する場合のコマンド（jr3slget）のメモリー所要量。コマンドのメモリー所要量は，「付録A.1(2)　コマンド実行時のメモリー所要量」を参照してください。

(2)　コマンド実行時のメモリー所要量

PFM - Agent for Enterprise Applicationsが提供しているコマンドを実行したときのメモリー所要量について，見積もりを次の表に示します。

表A-2　コマンド実行時のメモリー所要量

コマンド
コマンド実行1回当たりのメモリー所要量（単位：メガバイト）

Windows 2000，Windows Server 2003
Windows Server 2003(IPF)
HP-UX
(PA-RISC)
HP-UX
(IPF)
Solaris
AIX

jr3alget
13+0.004＊a
17+0.005＊a
9+0.006＊a
12+0.006＊a
16+0.005＊a
8+0.006＊a

jr3slget
13+0.001＊b
17+0.001＊b
9+0.002＊b
12+0.002＊b
16+0.001＊b
8+0.001＊b

（凡例）

a：監視対象のモニターで発生しているCCMSアラートの総数

b：抽出対象の期間内に発生したシステムログの総数

　抽出対象の期間は-lasttimeオプションの指定の有無によって異なります。

　・-lasttimeオプションを設定している場合：前回のコマンド実行時刻以降

　・-lasttimeオプションを設定していない場合：コマンド実行日の00:00:00以降

付録A.2　ディスク占有量

ディスク占有量は，パフォーマンスデータを収集するレコード数によって変化します。

PFM - Agent for Enterprise Applicationsのディスク占有量の見積もりについて説明します。

＜この項の構成＞

(1)　システム全体のディスク占有量

(2)　Storeデータベースのディスク占有量

(3)　コマンド実行時のディスク占有量

(1)　システム全体のディスク占有量

システム全体のディスク占有量の見積もりを次の表に示します。初期状態とは，収集設定がWorkLoad Summary Interval（PI）レコードおよびWork Process Summary（PD）レコードだけのPFM - Agent for Enterprise Applicationsのインスタンスが，Storeバージョン2.0で一つだけセットアップされている場合のことを示します。

表A-3　システム全体のディスク占有量

PFM - Agent for Enterprise Applicationsの状態
ディスク占有量（単位：メガバイト）

Windows 2000，Windows Server 2003
Windows Server 2003(IPF)
HP-UX
(PA-RISC)
HP-UX
(IPF)
Solaris
AIX

インストール時
30
50
25※1
50※1
25※1
30※1

初期状態での運用
110
140
a+120
a+120
a+120
a+120

初期状態以外での運用
30+20＊インスタンス数+b+c+W
50+20＊インスタンス数+b+c+W
a+30+20＊インスタンス数+b+c+W
a+30+20＊インスタンス数+b+c+W
a+30+20＊インスタンス数+b+c+W
a+30+20＊インスタンス数+b+c+W

（凡例）

a：インストール時のディスク占有量

b：System Log Monitor Command（PD_SLMX）レコードを収集する場合に作成されるシステムログ情報格納ファイル（SYSLOGファイル）のサイズ※2。ファイルサイズの設定は，「5.3　環境パラメーター設定ファイル」を参照してください。インスタンスを複数構築している場合は，構築したインスタンスごとのシステムログ情報格納ファイル（SYSLOGファイル）のサイズの総和になります。

c：CCMS Alert Monitor Command（PD_ALMX）レコードを収集する場合に作成されるCCMSアラート情報格納ファイル（ALERTファイル）のサイズ※3。ファイルサイズの設定は，「6.3　環境パラメーター設定ファイル」を参照してください。インスタンスを複数構築している場合は，構築したインスタンスごとのCCMSアラート情報格納ファイル（ALERTファイル）のサイズの総和になります。

W：Storeデータベースで使用するディスク占有量。レコードタイプごとのディスク占有量の総和となります。レコードタイプごとのディスク占有量の見積もり式については，「付録A.2(2)　Storeデータベースのディスク占有量」を参照してください。インスタンスを複数構築している場合は，構築したインスタンスごとのStoreデータベースのディスク占有量の総和となります。

注※1

インストール時には一時的にプログラム本体容量の2倍分のディスク容量が必要となります。

注※2

デフォルトは，1（単位：メガバイト）です。

CCMSアラート情報格納ファイルのサイズの見積もりは次のようになります。求まったバイト数をキロバイト数（1キロバイト=1024バイト）に変換して設定してください。なお，1メガバイトは1024キロバイトです。

Windowsの場合

28+421＊n（単位：バイト）

UNIXの場合

27+420＊n（単位：バイト）

（凡例）

n：収集するCCMSアラートの行数

注※3

デフォルトは，1（単位：メガバイト）です。

システムログ情報格納ファイルのサイズの見積もりは次のようになります。求まったバイト数をキロバイト数（1キロバイト=1024バイト）に変換して設定してください。なお，1メガバイトは1024キロバイトです。

Windowsの場合

28+308＊n（単位：バイト）

UNIXの場合

27+307＊n（単位：バイト）

（凡例）

n：収集するシステムログの行数

(2)　Storeデータベースのディスク占有量

StoreデータベースのStoreバージョンによって，ディスク占有量が異なります。Storeバージョンごとのディスク占有量を次に説明します。

注意

パフォーマンスデータがStoreデータベースに格納される際，幾つかのフィールドが追加されます。追加されるフィールドは，ディスク占有量に含まれるため，新たに容量を見積もる必要はありません。
・各レコードに共通して追加されるフィールド
各レコードに共通して追加されるフィールドを次の表に示します。

PFM - View名 | PFM - Manager名 | 説明
Agent Host | DEVICEID | PFM - Agentが動作しているホスト名。
Agent Instance | PROD_INST | PFM - Agentのインスタンス名。
Agent Type | PRODID | PFM - AgentのプロダクトID。
Date | DATE | レコードが作成された日（グリニッジ標準時）。
Date and Time | DATETIME | Date（DATE）とTime（TIME）フィールドの組み合わせ。
Drawer Type | DRAWER_TYPE | PIレコードタイプのレコードの場合，データが要約される区分（分，時，日，週，月，年）。
GMT Offset | GMT_ADJUST | グリニッジ標準時とローカル時間の差（秒単位）。
Time | TIME | レコードが作成された時刻（グリニッジ標準時）。

・PIレコードタイプのデータを要約する際に追加されるフィールド
PFM - View名やPFM - Manager名の末尾に，次に示す文字列が付加されているフィールドが該当します。PIレコードタイプのデータを要約する際に追加されるフィールドを次の表に示します。

PFM - View名 | PFM - Manager名 | 説明
PFM - View名(Total) | PFM - Manager名_TOTAL | フィールドの合計値。
PFM - View名(Total) | PFM - Manager名_TOTAL_SEC | フィールドの合計値（utime型の場合）。
PFM - View名(Max) | PFM - Manager名_HI | フィールドの最大値。
PFM - View名(Min) | PFM - Manager名_LO | フィールドの最小値。
－ | PFM - Manager名_COUNT | 収集レコード数。

・jpcctrl dumpコマンドで，Storeのデータベースに格納されているデータをエクスポートする際に追加されるフィールド
jpcctrl dumpコマンドで，Storeのデータベースに格納されているデータをエクスポートすると，次のフィールドが出力されます。これらのフィールドもStoreデータベースに格納される際，追加されるフィールドです。これらのフィールドは，PFM - Agent for Enterprise Applicationsが内部で使用するフィールドであるため，運用で使用しないでください。
- レコードID_DATE_F
- レコードID_DEVICEID_F
- レコードID_DRAWER_TYPE_F
- レコードID_DRAWER_COUNT
- レコードID_DRAWER_COUNT_F
- レコードID_INST_SEQ
- レコードID_PRODID_F
- レコードID_PROD_INST_F
- レコードID_RECORD_TYPE
- レコードID_RECORD_TYPE_F
- レコードID_SEVERITY
- レコードID_SEVERITY_F
- レコードID_TIME_F
- レコードID_UOWID
- レコードID_UOWID_F
- レコードID_UOW_INST
- レコードID_UOW_INST_F
- レコードID_PFM - Manager名_SEC
- レコードID_PFM - Manager名_MSEC

履歴データを収集する各レコードのインスタンス数は，次の表で見積もることができます。

表A-4　レコードごとのインスタンス数

レコード名 | レコードに対応する監視対象 | インスタンス数
Background Processing（PI_BTCP） | SAPシステム全体のバックグラウンドシステムの状態および処理効率 | 単数インスタンスレコードのため，1
Background Service（PI_BTC） | バックグラウンドサービス | 単数インスタンスレコードのため，1
CCMS Alert Monitor Command（PD_ALMX） | SAPシステムのCCMSアラート情報の抽出結果 | 単数インスタンスレコードのため，1
Dialog Service（PI_DIA） | ダイアログサービス | 単数インスタンスレコードのため，1
Enqueue Service（PI_ENQ） | エンキューサービス | 単数インスタンスレコードのため，1
SAP Buffer Summary（PI_BUFF） | SAPバッファの要約 | 単数インスタンスレコードのため，1
SAP Instance Summary（PD_SRV） | SAPインスタンスの要約 | 接続先SAPシステムに存在するインスタンス（サーバ）の数（トランザクションコードSM51に表示されるインスタンス（サーバ）の数）
SAP Memory Summary（PI_MEM） | SAPメモリーの要約 | 単数インスタンスレコードのため，1
Spool Service（PI_SPO） | スプールサービス | 単数インスタンスレコードのため，1
System Log Monitor Command（PD_SLMX） | SAPシステムのシステムログ情報の抽出結果 | 単数インスタンスレコードのため，1
Update1 Service（PI_UPD1） | V1更新サービス | 単数インスタンスレコードのため，1
Update2 Service（PI_UPD2） | V2更新サービス | 単数インスタンスレコードのため，1
User defined Monitor (Perf.)（PI_UMP） | モニター情報 | 設定したモニターセット名およびモニター名より以下に存在する，MTEタイプが「パフォーマンス属性」であるMTEの数
Work Process Summary（PD） | ワークプロセスの概要 | 接続先インスタンスに存在するワークプロセスの数（トランザクションコードSM50で確認できます）
WorkLoad Summary Interval（PI） | ダイアログタスクのワークロード時間 | 単数インスタンスレコードのため，1

jpcctrl backupコマンドまたはjpcctrl dumpコマンドを実行する場合，バックアップファイルまたはエクスポートファイルには，次の説明で算出した容量の約2倍のディスク容量が必要となります。

(a)　Storeバージョン1.0のStoreデータベースのディスク占有量

Storeデータベース（Storeバージョン1.0）のディスク占有量について説明します。

Storeデータベースでは，各レコードは，レコードタイプごとに一つのファイルに格納されます。Storeデータベース（Storeバージョン1.0）のディスク占有量について，レコードタイプごとに次の表に示します。

表A-5　レコードタイプごとのStoreデータベースのディスク占有量

レコードタイプ | ディスク占有量の見積もり式（単位：バイト）
PIレコードタイプ | X₁+.....+Xa+3,500＊a
PDレコードタイプ | Y₁+.....+Yb+700＊b

（凡例）

X：PIレコードタイプのレコードで履歴データを収集する各レコードのディスク占有量

Xの算出式を次に示します。

X={d＊e+(c+1,900)＊{(d＊e)/(65,250-c)+1}※1}＊f＊1.5

Y：PDレコードタイプのレコードで履歴データを収集する各レコードのディスク占有量

Yの算出式を次に示します。

Y={d＊g+(c+1,900)＊{(d＊e)/(65,250-c)+1}※1＊(g/e)※2}＊1.5

a：PIレコードタイプのレコードで履歴データを収集するレコード数

b：PDレコードタイプのレコードで履歴データを収集するレコード数

c：履歴データを収集する各レコードの固定部のサイズ※3

d：履歴データを収集する各レコードの可変部のサイズ※3

e：履歴データを収集する各レコードのインスタンス数（単数インスタンスレコードの場合は1）※4

f：履歴データを収集する各レコードの保存レコード数※5

g：履歴データを収集する各レコードの保存レコード数の上限値※6

注※1

{(d＊e)/(65,250-c)+1}の計算結果は，小数点以下を切り捨ててください。

注※2

(g/e)の計算結果は，小数点以下を切り捨ててください。

注※3

各レコードの固定部および可変部のサイズについては，「9.　レコード」を参照してください。

注※4

各レコードのインスタンス数は，表A-4で見積もることができます。

注※5

PIレコードタイプのレコードの場合，収集したデータがある一定の区分（時，日，週，月，および年単位）に自動的に要約されるので，分，時，日，週，月，および年の部分の保存レコード数を考慮して計算する必要があります。デフォルトの保存期間と保存レコード数を次の表に示します。

データの種類
保存期間
保存レコード数
（収集間隔が1分の場合）

分単位
1日
1,440

時単位
7日
168

日単位
1年
366

週単位
1年
52

月単位
1年
12

年単位
制限なし
（収集年数）＊1

注※6

保存レコード数の上限値については，「付録F.1　Agent Storeサービスのプロパティ一覧」を参照してください。

(b)　Storeバージョン2.0のStoreデータベースのディスク占有量

Storeデータベース（Storeバージョン2.0）のディスク占有量について説明します。

ディスク占有量，ファイル数，およびディレクトリ数の見積もりについて説明します。

ディスク占有量
Storeデータベースのディスク占有量は，レコードタイプごとのディスク占有量の総和となります。PIレコードタイプについては，さらに要約区分ごとのディスク占有量の総和となります。

レコードタイプごとのディスク占有量Xの見積もり式（単位：バイト）

X={(e+2)＊f'+(d+60)＊{((e+2)＊f')/(65,250-d)+1}※1}＊a/b＊(c+1)＊1.1

a：レコードタイプ，要約区分ごとに値が異なります。表A-6を参照してください。

b：レコードタイプ，要約区分ごとに値が異なります。表A-6を参照してください。※2

c：履歴データの保存期間設定値※3。レコードタイプ，要約区分ごとに指定する単位が異なります。単位については表A-6を参照してください。

d：履歴データを収集する各レコードの固定部のサイズ※4

e：履歴データを収集する各レコードの可変部のサイズ※4

f：履歴データを収集する各レコードのインスタンス数（単数インスタンスレコードの場合は1）※5

f'：fが2以上の場合，4の倍数に丸め込みます。たとえばf=2の場合はf'=4となります。f=1の場合はf'=1となります。

表A-6　a，b，およびcに設定する値

レコードタイプ | 要約区分 | a | b | c
PI | 分 | 1,440 | 1+(g-1)/60※2 | 保存期間（単位：日）
時 | 24 | 1+(g-1)/3,600※2 | 保存期間（単位：日）
日 | 7 | 1+(g-1)/86,400※2 | 保存期間（単位：週）
週 | 1 | 1+(g-1)/604,800※2 | 保存期間（単位：週）
月 | 1 | 1+(g-1)/2,592,000※2 | 保存期間（単位：月）
年 | 1 | 1+(g-1)/31,622,400※2 | 保存期間（単位：年）
PD | － | 1,440 | g/60 | 保存期間（単位：日）

（凡例）

g：履歴データの収集インターバル設定値（単位：秒）

－：該当しない

注※1

{(e＊f)/(65,250-d)+1}の計算結果は，小数点以下を切り捨ててください。

注※2

PIレコードタイプのbの計算結果は，小数点以下を切り捨ててください。

注※3

Storeバージョン2.0の場合のデフォルトの保存期間を表A-7，表A-8に示します。

注※4

各レコードの固定部・可変部のサイズについては，「9.　レコード」のレコードサイズを参照してください。

注※5

各レコードのインスタンス数は，表A-4で見積もることができます。

表A-7　PIレコードの保存期間（デフォルト値）

データの種類 | 保存期間
分単位 | 1日
時単位 | 7日
日単位 | 54週
週単位 | 54週
月単位 | 12か月
年単位 | 制限なし

表A-8　PDレコードの保存期間（デフォルト値）

レコード名 | 保存期間（単位：日）
CCMS Alert Monitor Command（PD_ALMX） | 2
SAP Instance Summary（PD_SRV） | 5
System Log Monitor Command（PD_SLMX） | 2
Work Process Summary（PD） | 5

PDレコードの保存期間は，jpcdbctrl setupコマンドでセットアップした場合はすべて10日間となります。

ファイル数

N=20+2＊(

(A11+A12+...+A1m+m)+

(A21+A22+...+A2m+m)+

(A31+A32+...+A3m+m)+

(A41+A42+...+A4m+m)+

(A51+A52+...+A5m+m)+

(11＊m)+

(B1+B2+...+Bn+n)

)

m：PIレコードで収集しているレコードの数

n：PDレコードで収集しているレコードの数

A11～A1m：PIレコードタイプのレコードごとの分レコードの保存期間設定値（単位：日）

A21～A2m：PIレコードタイプのレコードごとの時レコードの保存期間設定値（単位：日）

A31～A3m：PIレコードタイプのレコードごとの日レコードの保存期間設定値（単位：週）

A41～A4m：PIレコードタイプのレコードごとの週レコードの保存期間設定値（単位：週）

A51～A5m：PIレコードタイプのレコードごとの月レコードの保存期間設定値（単位：月）

B1～Bn：PDレコードタイプのレコードごとの保存期間設定値（単位：日）

ディレクトリ数
Storeデータベースで作成されるディレクトリ数Nの見積もり式を次に示します。
N=25+2＊((A1max)+(A2max)+(A3max)+(A4max)+(A5max)+11+(Bmax))

A1max：PIレコードタイプで収集しているレコードの要約区分が「分」のデータの保存期間設定値の最大値（単位：日）

A2max：PIレコードタイプで収集しているレコードの要約区分が「時」のデータの保存期間設定値の最大値（単位：日）

A3max：PIレコードタイプで収集しているレコードの要約区分が「日」のデータの保存期間設定値の最大値（単位：週）

A4max：PIレコードタイプで収集しているレコードの要約区分が「週」のデータの保存期間設定値の最大値（単位：週）

A5max：PIレコードタイプで収集しているレコードの要約区分が「月」のデータの保存期間設定値の最大値（単位：月）

Bmax：PDレコードタイプのレコードごとの保存期間設定値の最大値（単位：日）

Storeサービスがオープンするファイル数
Storeサービスがオープンするファイル数Nの見積もり式を次に示します。
N=20+2＊(6＊l+m)

l：PIレコードで収集しているレコードの数

m：PDレコードで収集しているレコードの数

(3)　コマンド実行時のディスク占有量

PFM - Agent for Enterprise Applicationsが提供しているコマンドを実行したときのディスク占有量について，見積もりを次の表に示します。

(a)　jr3algetコマンド

同一ディレクトリでjr3algetコマンドを実行する場合のディスク占有量を次の表に示します。

表A-9　jr3algetコマンド実行時のディスク占有量

ファイル | ディスク占有量（単位：キロバイト）
CCMSアラート情報格納ファイル | 1024※1※2
jr3alget.dat（データログファイル） | 512※1
jr3alget.log（メッセージログファイル） | 512※1
その他のファイル（合計） | 1

注※1

デフォルトの値です。ファイルサイズの設定については，「6.4　コマンド実行によるCCMSアラート情報の抽出」を参照してください。

注※2

CCMSアラート情報格納ファイルのサイズの見積もりは次のようになります。求まったバイト数をキロバイト数（1キロバイト=1024バイト）に変換して設定してください。

Windowsの場合

28+421＊n（単位：バイト）

UNIXの場合

27+420＊n（単位：バイト）

（凡例）

n：収集するCCMSアラートの行数

(b)　jr3slgetコマンド

同一ディレクトリでjr3slgetコマンドを実行する場合のディスク占有量を次の表に示します。

表A-10　jr3slgetコマンド実行時のディスク占有量

ファイル | ディスク占有量（単位：キロバイト）
システムログ情報格納ファイル | 1024※1※2
jr3slget.dat（データログファイル） | 512※1※3
jr3slget.log（メッセージログファイル） | 512※1
その他のファイル（合計） | 1

注※1

デフォルトでの値です。ファイルサイズの設定については，「5.4　コマンド実行によるシステムログ情報の抽出」を参照してください。

注※2

システムログ情報格納ファイルのサイズの見積もりは次のようになります。求まったバイト数をキロバイト数（1キロバイト=1024バイト）に変換して設定してください。

Windowsの場合

28+308＊n（単位：バイト）

UNIXの場合

27+307＊n（単位：バイト）

（凡例）

n：収集するシステムログの行数

注※3

jr3slget.dat（データログファイル）のサイズの見積もりは次のようになります。求まったバイト数をキロバイト数（1キロバイト=1024バイト）に変換して設定してください。

Windowsの場合

9280+1542＊d+257＊n（単位：バイト）

UNIXの場合

9243+1536＊d+256＊n（単位：バイト）

（凡例）

d：システムログを収集する期間（日数）

n：収集するシステムログの行数

付録A.3　クラスタ運用時のディスク占有量

クラスタ運用時のディスク占有量の見積もりは，クラスタシステムで運用しない場合のディスク占有量の見積もりと同じです。ディスク占有量については，「付録A.2　ディスク占有量」を参照してください。

付録B　カーネルパラメーター

PFM - Agent for Enterprise Applicationsでは，カーネルパラメーターの調整は不要です。

なお，UNIX環境でPFM - Managerを使用する場合の，カーネルパラメーターの調整については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されているカーネルパラメーター一覧を参照してください。

付録C　識別子一覧

PFM - Agent for Enterprise Applicationsを操作したり，PFM - Agent for Enterprise ApplicationsのStoreデータベースからパフォーマンスデータを抽出したりする際，PFM - Agent for Enterprise Applicationsであることを示す識別子が必要な場合があります。PFM - Agent for Enterprise Applicationsの識別子を次の表に示します。

表C-1　PFM - Agent for Enterprise Applicationsの識別子一覧

用途 | 名称 | 識別子 | 説明
コマンドなど | プロダクトID | M | プロダクトIDとは，サービスIDの一部。サービスIDは，コマンドを使用してPerformance Managementのシステム構成を確認する場合や，パフォーマンスデータをバックアップする場合などに必要である。サービスIDについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されている命名規則を参照のこと。
サービスキー | agtm | コマンドを使用してPFM - Agent for Enterprise Applicationsを起動する場合や，終了する場合などに必要である。サービスキーについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されているサービスキーを参照のこと。
ODBC | 製品タイプ識別子 | R3 | SQL文を使用してデータを抽出する場合に必要である。詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，ODBCに準拠したアプリケーションプログラムと連携した稼働分析について説明している章を参照のこと。
ヘルプ | ヘルプID | pcam | PFM - Agent for Enterprise Applicationsのヘルプであることを表す。

付録D　プロセス一覧

ここでは，PFM - Agent for Enterprise Applicationsのプロセス一覧を記載します。

PFM - Manager，PFM - Web Console，およびPFM - Baseのプロセスについては，マニュアル「JP1/Performance Management リファレンス」の付録を参照してください。

PFM - Agent for Enterprise Applicationsのプロセス一覧を次の表に示します。なお，プロセス名の後ろに記載されている値は，同時に起動できるプロセス数です。

注意

論理ホストのPFM - Agentでも，動作するプロセスおよびプロセス数は同じです。

表D-1　PFM - Agent for Enterprise Applicationsのプロセス一覧（Windows版）

プロセス名
（プロセス数）
機能

jpcagtm.exe(n)
Agent Collectorサービスプロセス。このプロセスは，PFM - Agent for Enterprise Applicationsのインスタンスごとに一つ起動する。

jpcsto.exe(n)
Agent Storeサービスプロセス。このプロセスは，PFM - Agent for Enterprise Applicationsのインスタンスごとに一つ起動する。

jr3alget.exe(1)※1
CCMSアラート情報を収集する実行プロセス。

jr3slget.exe(1)※1
システムログ情報を収集する実行プロセス。

stpqlpr.exe(1)※2
Storeデータベースのバックアップ／エクスポート実行プロセス。

注※1

jpcagtmプロセスの子プロセスです。

注※2

jpcstoプロセスの子プロセスです。

表D-2　PFM - Agent for Enterprise Applicationsのプロセス一覧（UNIX版）

プロセス名
（プロセス数）
機能

jpcagtm(n)
Agent Collectorサービスプロセス。このプロセスは，PFM - Agent for Enterprise Applicationsのインスタンスごとに一つ起動する。

jpcsto(n)
Agent Storeサービスプロセス。このプロセスは，PFM - Agent for Enterprise Applicationsのインスタンスごとに一つ起動する。

jr3alget(1)※1
CCMSアラート情報を収集する実行プロセス。

jr3slget(1)※1
システムログ情報を収集する実行プロセス。

stpqlpr(1)※2
Storeデータベースのバックアップ／エクスポート実行プロセス。

注※1

jpcagtmプロセスの子プロセスです。

注※2

jpcstoプロセスの子プロセスです。

付録E　ポート番号一覧

ここでは，Performance Managementのポート番号を記載します。

PFM - Manager，およびPFM - Baseのポート番号およびファイアウォールの通過方向については，マニュアル「JP1/Performance Management リファレンス」の付録を参照してください。

ポート番号は，ユーザー環境に合わせて任意の番号に変更することもできます。

ポート番号の変更方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。なお，使用するプロトコルはTCP/IPです。

注意

Performance Managementは，1対1のアドレス変換をする静的NAT(Basic NAT)に対応しています。

動的NATや，ポート変換機能を含むNAPT（IP Masquerade，NAT+）には対応していません。

＜この節の構成＞

付録E.1　Performance Managementのポート番号

付録E.2　ファイアウォールの通過方向

付録E.1　Performance Managementのポート番号

Performance Managementで使用するポート番号を次の表に示します。

表E-1　Performance Managementで使用するポート番号

サービス名 | パラメーター | ポート番号 | 用途
Agent Storeサービス | jp1pcstom[nnn]※1 | －※2 | パフォーマンスデータを記録したり，履歴レポートを取得したりするときに使用する。
Agent Collectorサービス | jp1pcagtm[nnn]※1 | －※2 | アラームをバインドしたり，リアルタイムレポートを取得したりするときに使用する。

注※1

複数インスタンスを作成している場合，2番目以降に作成したインスタンスに通番（nnn）が付加されます。最初に作成したインスタンスには，通番は付加されません。

注※2

サービスが再起動されるたびに，システムで使用されていないポート番号が自動的に割り当てられます。

付録E.2　ファイアウォールの通過方向

ファイアウォールを挟んでPFM - ManagerとPFM - Agent for Enterprise Applicationsを配置する場合は，PFM - ManagerとPFM - Agentのすべてのサービスにポート番号を固定値で設定してください。また，各ポート番号を次の表に示す方向で設定し，ファイアウォールを通過させるようにしてください。

表E-2　ファイアウォールの通過方向

サービス名 | パラメーター | 通過方向
Agent Storeサービス | jp1pcstom[nnn]※ | Agent←Manager
Agent Collectorサービス | jp1pcagtm[nnn]※ | Agent←Manager

（凡例）

Manager：PFM - Managerホスト

Agent：PFM - Agentホスト

←：右項から左項への通信（コネクション）を開始する方向

注※

複数インスタンスを作成している場合，2番目以降に作成したインスタンスに通番（nnn）が付加されます。最初に作成したインスタンスには，通番は付加されません。

注意

PFM - Agentのホストでjpcctrl dumpコマンドまたはjpcctrl listコマンドを実行したい場合，次のどちらかの方法でコマンドを実行してください。

jpcctrl dumpコマンドまたはjpcctrl listコマンドのproxyオプションで，PFM - Managerを経由して通信するように指定してください。jpcctrl dumpコマンドまたはjpcctrl listコマンドのproxyオプションについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

各PFM - Agentホスト間で次の表に示す方向でポート番号を設定し，ファイアウォールを通過させるようにしてください。

サービス名 | パラメーター | 通過方向
Agent Storeサービス | jp1pcstom[nnn]※ | Agent←→Agent
Agent Collectorサービス | jp1pcagtm[nnn]※ | Agent←→Agent

（凡例）

Agent：PFM - Agentホスト

←→：左項から右項，および右項から左項への通信（コネクション）を開始する方向

注※

複数インスタンスを作成している場合，2番目以降に作成したインスタンスに通番（nnn）が付加されます。最初に作成したインスタンスには，通番は付加されません。

付録F　PFM - Agent for Enterprise Applicationsのプロパティ

ここでは，PFM - Web Consoleで表示されるPFM - Agent for Enterprise ApplicationsのAgent Storeサービスのプロパティ一覧，およびAgent Collectorサービスのプロパティ一覧を記載します。

＜この節の構成＞

付録F.1　Agent Storeサービスのプロパティ一覧

付録F.2　Agent Collectorサービスのプロパティ一覧

付録F.1　Agent Storeサービスのプロパティ一覧

PFM - Agent for Enterprise ApplicationsのAgent Storeサービスのプロパティ一覧を次の表に示します。

表F-1　PFM - Agent for Enterprise ApplicationsのAgent Storeサービスのプロパティ一覧

フォルダ名
プロパティ名
説明

－
First Registration Date
サービスがPFM - Managerに認識された最初の日時が表示される。

Last Registration Date
サービスがPFM - Managerに認識された最新の日時が表示される。

General
－
ホスト名やディレクトリなどの情報が格納されている。このフォルダに格納されているプロパティは変更できない。

Directory
サービスの動作するカレントディレクトリ名が表示される。

Host Name
サービスが動作する物理ホスト名が表示される。

Process ID
サービスのプロセスIDが表示される。

Physical Address
サービスが動作するホストのIPアドレスおよびポート番号が表示される。

User Name
サービスプロセスを実行したユーザー名が表示される。

Time Zone
サービスで使用されるタイムゾーンが表示される。

System
－
サービスが起動されているOSの，OS情報が格納されている。このフォルダに格納されているプロパティは変更できない。

CPU Type
CPUの種類が表示される。

Hardware ID
ハードウェアIDが表示される。

OS Type
OSの種類が表示される。

OS Name
OS名が表示される。

OS Version
OSのバージョンが表示される。

Network Services
－
Performance Management通信共通ライブラリーについての情報が格納されている。このフォルダに格納されているプロパティは変更できない。

Build Date
Agent Storeサービスの作成日が表示される。

INI File
jpcns.iniファイルの格納ディレクトリ名が表示される。

Network Services
Service
－
サービスについての情報が格納されている。このフォルダに格納されているプロパティは変更できない。

Description
次の形式でホスト名が表示される。
インスタンス名_ホスト名

Local Service Name
サービスIDが表示される。

Remote Service Name
接続先PFM - ManagerホストのMaster ManagerサービスのサービスIDが表示される。

EP Service Name
接続先PFM - ManagerホストのCorrelatorサービスのサービスIDが表示される。

Retention
－
データの保存期間を設定する。詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照のこと。

Product Interval - Minute Drawer
分ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Minute

Hour

Day

2 Days

3 Days

4 Days

5 Days

6 Days

Week

Month

Year

Product Interval - Hour Drawer
時間ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Hour

Day

2 Days

3 Days

4 Days

5 Days

6 Days

Week

Month

Year

Product Interval - Day Drawer
日ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Day

2 Days

3 Days

4 Days

5 Days

6 Days

Week

Month

Year

Product Interval - Week Drawer
週ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Week

Month

Year

Product Interval - Month Drawer
月ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Month

Year

Product Interval - Year Drawer
年ごとのPIレコードタイプのレコードの保存期間。Yearで固定。

Product Detail - PDレコードタイプのレコードID
各PDレコードタイプのレコードの保存レコード数を設定する。0～2,147,483,647の整数が指定できる。
注意：範囲外の数値，またはアルファベットなどの文字を指定した場合，エラーメッセージが表示される。

RetentionEx
－
Storeバージョンが2.0の場合にデータの保存期間を設定する。詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照のこと。

RetentionEx
Product Interval - PIレコードタイプのレコードID
－
PIレコードタイプのレコードの保存期間を設定する。

Period - Minute Drawer (Day)
PIレコードタイプのレコードIDごとに，分単位のパフォーマンスデータの保存期間を設定する。
保存期間（日数）を0～366の整数で指定できる。

Period - Hour Drawer (Day)
PIレコードタイプのレコードIDごとに，時間単位のパフォーマンスデータの保存期間を設定する。
保存期間（日数）を0～366の整数で指定できる。

Period - Day Drawer (Week)
PIレコードタイプのレコードIDごとに，日単位のパフォーマンスデータの保存期間を設定する。
保存期間（週の数）を0～522の整数で指定できる。

Period - Week Drawer (Week)
PIレコードタイプのレコードIDごとに，週単位のパフォーマンスデータの保存期間を設定する。
保存期間（週の数）を0～522の整数で指定できる。

Period - Month Drawer (Month)
PIレコードタイプのレコードIDごとに，月単位のパフォーマンスデータの保存期間を設定する。
保存期間（月の数）を0～120の整数で指定できる。

Period - Year Drawer (Year)
PIレコードタイプのレコードIDごとに，年単位のパフォーマンスデータの保存期間が表示される。
常に「10」が表示される。保存期間は制限なし。

Product Detail - PDレコードタイプのレコードID
Period (Day)
PDレコードタイプのレコードIDごとに，パフォーマンスデータの保存期間を設定する。
保存期間（日数）を0～366の整数で指定できる。

Disk Usage
－
各データベースで使用されているディスク容量が格納されている。このフォルダに格納されているプロパティには，プロパティを表示した時点でのディスク使用量が表示される。このフォルダに格納されているプロパティは変更できない。

Product Interval
PIレコードタイプのレコードで使用されるディスク容量が表示される。

Product Detail
PDレコードタイプのレコードで使用されるディスク容量が表示される。

Product Alarm
PAレコードタイプのレコードで使用されるディスク容量が表示される。PFM - Agent for Enterprise Applicationsでは使用しない。

Product Log
PLレコードタイプのレコードで使用されるディスク容量が表示される。PFM - Agent for Enterprise Applicationsでは使用しない。

Total Disk Usage
データベース全体で使用されるディスク容量が表示される。

Configuration
－
Agent Storeサービスのプロパティが表示される。

Store Version
Storeデータベースのバージョンが表示される。

Storeバージョン1.0の場合
「1.0」

Storeバージョン2.0の場合
「2.0」

（凡例）

－：該当しない

付録F.2　Agent Collectorサービスのプロパティ一覧

PFM - Agent for Enterprise ApplicationsのAgent Collectorサービスのプロパティ一覧を次の表に示します。

表F-2　PFM - Agent for Enterprise ApplicationsのAgent Collectorサービスのプロパティ一覧

フォルダ名
プロパティ名
説明

－
First Registration Date※1
サービスがPFM - Managerに認識された最初の日時が表示される。

Last Registration Date※1
サービスがPFM - Managerに認識された最新の日時が表示される。

Data Model Version
データモデルのバージョンが表示される。

General
－
ホスト名やディレクトリなどの情報が格納されている。このフォルダに格納されているプロパティは変更できない。

Directory
サービスの動作するカレントディレクトリ名が表示される。

Host Name
サービスが動作する物理ホスト名が表示される。

Process ID
サービスのプロセスIDが表示される。

Physical Address
サービスが動作するホストのIPアドレスおよびポート番号が表示される。

User Name
サービスプロセスを実行したユーザー名が表示される。

Time Zone
サービスで使用されるタイムゾーンが表示される。

System
－
サービスが起動されているOSの，OS情報が格納されている。このフォルダに格納されているプロパティは変更できない。

CPU Type
CPUの種類が表示される。

Hardware ID
ハードウェアIDが表示される。

OS Type
OSの種類が表示される。

OS Name
OS名が表示される。

OS Version
OSのバージョンが表示される。

Network Services
－
Performance Management通信共通ライブラリーについての情報が格納されている。このフォルダに格納されているプロパティは変更できない。

Build Date
Agent Collectorサービスの作成日が表示される。

INI File
jpcns.iniファイルの格納ディレクトリ名が表示される。

Network Services
Service
－
サービスについての情報が格納されている。このフォルダに格納されているプロパティは変更できない。

Description
次の形式でホスト名が表示される。
インスタンス名_ホスト名

Local Service Name
サービスIDが表示される。

Remote Service Name
Agent Collectorサービスが接続するAgent StoreサービスのサービスIDが表示される。

AH Service Name
同一ホストにあるAction HandlerサービスのサービスIDが表示される。

Detail Records
－
PDレコードタイプのレコードのプロパティが格納されている。収集されているレコードのレコードIDは，太字で表示される。

Detail Records
レコードID※2
－
レコードのプロパティが格納されている。

Description
レコードの説明が表示される。このプロパティは変更できない。

Log
リスト項目から「Yes」または「No」を選択し，レコードをAgent Storeデータベースに記録するかどうかを指定する。この値が「Yes」でかつ，Collection Intervalが0より大きい値であれば，データベースに記録される。

Collection Interval
データの収集間隔を指定する。指定できる値は0～2,147,483,647秒で，1秒単位で指定できる。なお，0と指定した場合は0秒となり，データは収集されない。

Collection Offset
データの収集を開始するオフセット値を指定する。指定できる値は，Collection Intervalで指定した値の範囲内で，0～32,767秒の1秒単位で指定できる。なお，データ収集の記録時間は，Collection Offsetの値によらないで，Collection Intervalと同様の時間となる。

LOGIF
レコードをデータベースに記録するときの条件を指定する。条件に合ったレコードだけがデータベースに記録される。PFM - Web Consoleの［サービス階層］タブで表示されるサービスのプロパティ画面の，下部フレームの［LOGIF］をクリックすると表示される［ログ収集条件設定］ウィンドウで作成した条件式（文字列）が表示される。

Interval Records
－
PIレコードタイプのレコードのプロパティが格納されている。収集されているレコードのレコードIDは，太字で表示される。

Interval Records
レコードID※2
－
レコードのプロパティが格納されている。

Description
レコードの説明が表示される。このプロパティは変更できない。

Log
リスト項目から「Yes」または「No」を選択し，レコードをAgent Storeデータベースに記録するかどうかを指定する。この値が「Yes」でかつ，Collection Intervalが0より大きい値であれば，データベースに記録される。

Collection Interval
データの収集間隔を指定する。指定できる値は0～2,147,483,647秒で，1秒単位で指定できる。なお，0と指定した場合は0秒となり，データは収集されない。

Collection Offset
データの収集を開始するオフセット値を指定する。指定できる値は，Collection Intervalで指定した値の範囲内で，0～32,767秒の1秒単位で指定できる。なお，データ収集の記録時間は，Collection Offsetの値によらないで，Collection Intervalと同様の時間となる。

LOGIF
レコードをデータベースに記録するときの条件を指定する。条件に合ったレコードだけがデータベースに記録される。PFM - Web Consoleの［サービス階層］タブで表示されるサービスのプロパティ画面の，下部フレームの［LOGIF］をクリックすると表示される［ログ収集条件設定］ウィンドウで作成した条件式（文字列）が表示される。

Log Records
－
PLレコードタイプのレコードのプロパティが格納されている。PFM - Agent for Enterprise Applicationsではこのレコードをサポートしていないため使用しない。

Restart Configurations
－
PFMサービス自動再起動の条件を設定する。PFM - ManagerまたはPFM - Baseが08-50以降の場合に設定できる。PFMサービス自動再起動機能については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの機能について説明している章を参照のこと。

Restart when Abnormal Status
Status ServerサービスがAction Handlerサービス，Agent Collectorサービス，およびAgent Storeサービスの状態を正常に取得できない場合にサービスを自動再起動するかどうかを設定する。

Restart when Single Service Running
Agent StoreサービスとAgent Collectorサービスのどちらかしか起動していない場合にサービスを自動再起動するかどうかを設定する。

Restart Configurations
Action Handler
Auto Restart
Action Handlerサービスに対して自動再起動機能を利用するかどうかを設定する。

Auto Restart - Interval (Minute)
自動再起動機能を利用する場合，サービスの稼働状態を確認する間隔を分単位で設定する。

Auto Restart - Repeat Limit
自動再起動機能を利用する場合，連続して再起動を試行する回数を設定する。

Scheduled Restart
Action Handlerサービスに対して，定期再起動機能を利用するかどうかを設定する。

Scheduled Restart - Interval
定期再起動機能を利用する場合，再起動間隔を設定する。

Scheduled Restart - Interval Unit
定期再起動機能を利用する場合，再起動間隔の単位を設定する。

Scheduled Restart - Origin - Year
再起動する年を1971～2035の整数で指定できる。

Scheduled Restart - Origin - Month
再起動する月を1～12の整数で指定できる。

Scheduled Restart - Origin - Day
再起動する日を1～31の整数で指定できる。

Scheduled Restart - Origin - Hour
再起動する時間（時）を0～23の整数で指定できる。

Scheduled Restart - Origin - Minute
再起動する時間（分）を0～59の整数で指定できる。

Agent Collector
Auto Restart
Agent Collectorサービスに対して自動再起動機能を利用するかどうかを設定する。

Auto Restart - Interval (Minute)
自動再起動機能を利用する場合，サービスの稼働状態を確認する間隔を分単位で設定する。

Auto Restart - Repeat Limit
自動再起動機能を利用する場合，連続して再起動を試行する回数を設定する。

Scheduled Restart
Agent Collectorサービスに対して，定期再起動機能を利用するかどうかを設定する。

Scheduled Restart - Interval
定期再起動機能を利用する場合，再起動間隔を設定する。

Scheduled Restart - Interval Unit
定期再起動機能を利用する場合，再起動間隔の単位を設定する。

Scheduled Restart - Origin - Year
再起動する年を1971～2035の整数で指定できる。

Scheduled Restart - Origin - Month
再起動する月を1～12の整数で指定できる。

Scheduled Restart - Origin - Day
再起動する日を1～31の整数で指定できる。

Scheduled Restart - Origin - Hour
再起動する時間（時）を0～23の整数で指定できる。

Scheduled Restart - Origin - Minute
再起動する時間（分）を0～59の整数で指定できる。

Agent Store
Auto Restart
Agent Storeサービスに対して自動再起動機能を利用するかどうかを設定する。

Auto Restart - Interval (Minute)
自動再起動機能を利用する場合，サービスの稼働状態を確認する間隔を分単位で設定する。

Auto Restart - Repeat Limit
自動再起動機能を利用する場合，連続して再起動を試行する回数を設定する。

Scheduled Restart
Agent Storeサービスに対して，定期再起動機能を利用するかどうかを設定する。

Scheduled Restart - Interval
定期再起動機能を利用する場合，再起動間隔を設定する。

Scheduled Restart - Interval Unit
定期再起動機能を利用する場合，再起動間隔の単位を設定する。

Scheduled Restart - Origin - Year
再起動する年を1971～2035の整数で指定できる。

Scheduled Restart - Origin - Month
再起動する月を1～12の整数で指定できる。

Scheduled Restart - Origin - Day
再起動する日を1～31の整数で指定できる。

Scheduled Restart - Origin - Hour
再起動する時間（時）を0～23の整数で指定できる。

Scheduled Restart - Origin - Minute
再起動する時間（分）を0～59の整数で指定できる。

User Command Setting
ユーザーレコード名※3
Execute
ユーザーコマンド定期実行機能を実行するかどうか指定する。

Yes：実行する。

No：実行しない。

UserCommand
ユーザーコマンドの絶対パスを指定する。絶対パスに指定できる文字列の最大長は255バイト。指定できる文字は，半角英数字および次の文字。
¥ / : ; , " < >

Agent
－
PFM - Agent for Enterprise Applications固有の設定用プロパティが格納されている。

Agent
Target
－
監視対象となるSAPシステムの概要が表示される。このディレクトリに格納されているプロパティは変更できない。

SID
監視対象となるSAPシステムIDが表示される。

SERVER
監視対象となるSAPインスタンス名が表示される。

Destination
－
SAPシステムに接続するための情報が表示される。このフォルダに格納されているプロパティは変更できない。

ASHOST
接続先アプリケーションサーバのホスト名が表示される。通常は，ローカルホスト名が表示される。

SYSNR
SAPシステムのシステム番号が表示される。

CLIENT
SAPユーザーが属するクライアント名（接続先ダイアログインスタンスに割り当てられているシステム番号）が表示される。

USER
SAPユーザー名が表示される。

EXTPWD
SAPシステムへの接続に，拡張パスワードを使用するかどうかが表示される。

Y：拡張パスワードを使用する。

N：拡張パスワードを使用しない。

PASSWD
SAPユーザーのパスワードが*（アスタリスク）で表示される。

LANG
SAPユーザーの使用言語または接続先SAPシステムの言語が表示される。常に「EN」が表示される。

CODEPAGE
SAPシステムとの接続に使用するコードページが表示される。常に空欄で表示される。

Mode
－
Agent Collectorサービスの動作モードが表示される。このフォルダに格納されているプロパティは変更できない。

DELAYCONNECT
SAPシステムにいつ接続するかが表示される。

Y：パフォーマンスデータ収集時にSAPシステムに接続する。この場合，Agent Collectorサービスは，接続時のSAPシステムの稼働状況に関係なく起動される。

N：Agent Collectorサービス起動時にSAPシステムに接続する。この場合，Agent Collectorサービスは，接続時にSAPシステムが停止していると起動されない。

KEEPCONNECT
パフォーマンスデータ収集完了後にSAPシステムとの接続を続行するかどうかが表示される。常に「Y」が表示される。

Y：接続を続行する。

N：接続を続行しない。

PI_UMP
MONITOR_SET
User defined Monitor (Perf.)（PI_UMP）レコードで監視対象とする，SAPシステムのモニター情報のモニターセット名を指定する。
指定できる文字列は，1～60バイトの半角英数字。

MONITOR
User defined Monitor (Perf.)（PI_UMP）レコードで監視対象とする，SAPシステムのモニター情報のモニター名を指定する。
指定できる文字列は，1～60バイトの半角英数字。

（凡例）

－：該当しない

注※1

［プロパティ - ［サービス］］ダイアログボックスを［Performance Management - View］ウィンドウから表示した場合，［First Registration Date］および［Last Registration Date］は表示されません。これらのプロパティ値を参照したい場合は，［管理ツール］ウィンドウから［プロパティ - ［サービス］］ダイアログボックスを表示してください。

注※2

フォルダ名には，データベースIDを除いたレコードIDが表示されます。各レコードのレコードIDについては，「9.　レコード」を参照してください。

注※3

フォルダ名には，「PD_UPD」，「PD_UPDB」，「PI_UPI」，および「PI_UPIB」が表示されます。

付録G　ファイルおよびディレクトリ一覧

ここでは，PFM - Agent for Enterprise Applicationsのファイルおよびディレクトリ一覧をOSごとに記載します。

Performance ManagementのインストールディレクトリをOSごとに示します。

Windowsの場合

Performance Managementのインストール先フォルダは，任意です。デフォルトのインストール先フォルダは次のとおりです。

Windows 2003(x64)以外の場合
システムドライブ¥Program Files¥Hitachi¥jp1pc¥

Windows 2003(x64)の場合
システムドライブ¥Program Files(x86)¥Hitachi¥jp1pc¥

UNIXの場合

Performance Managementのインストール先ディレクトリは，「/opt/jp1pc/」です。

＜この節の構成＞

付録G.1　Windowsの場合

付録G.2　UNIXの場合

付録G.1　Windowsの場合

Windows版PFM - Agent for Enterprise Applicationsのファイルおよびフォルダ一覧を次の表に示します。

表G-1　PFM - Agent for Enterprise Applicationsのファイルおよびフォルダ一覧（Windows版）

フォルダ名 | ファイル名 | 説明
インストール先フォルダ¥agtm¥ | － | PFM - Agent for Enterprise Applicationsのルートフォルダ
readme.txt | README.TXT（日本語）
インストール先フォルダ¥agtm¥agent¥ | － | Agent Collectorサービスのルートフォルダ
jpcagtm.exe | Agent Collectorサービス実行プログラム
インストール先フォルダ¥agtm¥agent¥インスタンス名¥ | － | Agent Collectorサービスのルートフォルダ（インスタンスごと）※1
jpcagt.ini | Agent Collectorサービス起動情報ファイル（インスタンスごと）※1
jpcagt.ini.model | Agent Collectorサービス起動情報ファイルのモデルファイル（インスタンスごと）※1
jr3alget.ini | CCMS Alert Monitor Command（PD_ALMX）レコード用の環境パラメーター設定ファイル※1
jr3slget.ini | System Log Monitor Command（PD_SLMX）レコード用の環境パラメーター設定ファイル※1
インストール先フォルダ¥agtm¥agent¥インスタンス名¥log¥ | － | Agent Collectorサービス内部ログファイル格納フォルダ（インスタンスごと）※1
ALERT | CCMSアラート情報格納ファイル（デフォルト）※3
ALERT.ofs | CCMSアラート情報格納ファイルの管理ファイル（デフォルト）※3
jr3alget.log | CCMSアラート情報抽出の実行履歴を保存しているメッセージログファイル※3
jr3alget.dat | CCMSアラート情報抽出の実行履歴を保存しているデータログファイル※3
jr3alget.lasttime | CCMSアラート情報抽出の前回実行日時を保存しているタイムスタンプファイル※3
SYSLOG | システムログ情報格納ファイル（デフォルト）※4
SYSLOG.ofs | システムログ情報格納ファイルの管理ファイル（デフォルト）※4
jr3slget.log | システムログ情報抽出の実行履歴を保存しているメッセージログファイル※4
jr3slget.dat | システムログ情報抽出の実行履歴を保存しているデータログファイル※4
jr3slget.lasttime | システムログ情報抽出の前回実行日時を保存しているタイムスタンプファイル※4
インストール先フォルダ¥agtm¥evtrap¥ | － | SAPイベント管理機能のルートディレクトリ
jr3alget | CCMSアラートの抽出と変換コマンド
jr3alget.ini.sample | jr3algetコマンドの環境パラメーター設定ファイルのモデルファイル
jr3slget | システムログの抽出と変換コマンド
jr3slget.ini.sample | jr3slgetコマンドの環境パラメーター設定ファイルのモデルファイル
インストール先フォルダ¥agtm¥lib¥ | － | メッセージカタログ格納フォルダ
インストール先フォルダ¥agtm¥store¥ | － | Agent Storeサービスのルートフォルダ
*.DAT | データモデル定義ファイル
インストール先フォルダ¥agtm¥store¥インスタンス名¥ | － | Agent Storeサービスのルートフォルダ（インスタンスごと）※1
*.DB | パフォーマンスデータファイル（インスタンスごと）※2
*.IDX | パフォーマンスデータファイルのインデックスファイル（インスタンスごと）※2
*.LCK | パフォーマンスデータファイルのロックファイル（インスタンスごと）※2
jpcsto.ini | Agent Storeサービス起動情報ファイル（インスタンスごと）※1
jpcsto.ini.model | Agent Storeサービス起動情報ファイルのモデル（インスタンスごと）※1
*.DAT | データモデル定義ファイル（インスタンスごと）※1
インストール先フォルダ¥agtm¥store¥インスタンス名¥backup¥ | － | 標準のデータベースバックアップ先フォルダ（インスタンスごと）※1
インストール先フォルダ¥agtm¥store¥インスタンス名¥dump¥ | － | 標準のデータベースエクスポート先フォルダ（インスタンスごと）※1
インストール先フォルダ¥agtm¥store¥インスタンス名¥import¥ | － | Storeバージョン2.0の場合の，標準のデーターベースインポート先フォルダ（インスタンスごと）※5
インストール先フォルダ¥agtm¥store¥インスタンス名¥log¥ | － | Agent Storeサービス内部ログファイル格納フォルダ（インスタンスごと）※1
インストール先フォルダ¥agtm¥store¥インスタンス名¥partial¥ | － | Storeバージョン2.0の場合の，標準のデータベース部分バックアップ先フォルダ（インスタンスごと）※5
インストール先フォルダ¥agtm¥store¥インスタンス名¥STPD¥ | － | Storeバージョン2.0の場合の，PDレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※5
インストール先フォルダ¥agtm¥store¥インスタンス名¥STPI¥ | － | Storeバージョン2.0の場合の，PIレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※5
インストール先フォルダ¥agtm¥store¥インスタンス名¥STPL¥ | － | Storeバージョン2.0の場合の，PLレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※5
インストール先フォルダ¥patch_files¥agtm¥ | － | パッチ用ファイル格納フォルダ
インストール先フォルダ¥auditlog¥ | － | 動作ログファイルの標準の出力フォルダ
jpcauditn.log | 動作ログファイル※6
インストール先フォルダ¥setup¥ | － | セットアップファイル格納フォルダ
jpcagtmu.Z | PFM - Agentセットアップ用アーカイブファイル（UNIX）
jpcagtmw.EXE | PFM - Agentセットアップ用アーカイブファイル（Windows）
環境ディレクトリ※⁷¥jp1pc¥agtm¥agent¥インスタンス名¥ | － | 論理ホスト運用の場合の，Agent Collectorサービスのルートフォルダ（インスタンスごと）※1
jpcagt.ini | 論理ホスト運用の場合の，Agent Collectorサービス起動情報ファイル（インスタンスごと）※1
jpcagt.ini.model | 論理ホスト運用の場合の，Agent Collectorサービス起動情報ファイルのモデルファイル（インスタンスごと）※1
jr3alget.ini | 論理ホスト運用の場合の，CCMS Alert Monitor Command（PD_ALMX）レコード用の環境パラメーター設定ファイル※1
jr3slget.ini | 論理ホスト運用の場合の，System Log Monitor Command（PD_SLMX）レコード用の環境パラメーター設定ファイル※1
環境ディレクトリ※⁷¥jp1pc¥agtm¥agent¥インスタンス名¥log¥ | － | 論理ホスト運用の場合の，Agent Collectorサービス内部ログファイル格納フォルダ（インスタンスごと）※1
ALERT | 論理ホスト運用の場合の，CCMSアラート情報格納ファイル（デフォルト）※3
ALERT.ofs | 論理ホスト運用の場合の，CCMSアラート情報格納ファイルの管理ファイル（デフォルト）※3
jr3alget.log | 論理ホスト運用の場合の，CCMSアラート情報抽出の実行履歴を保存しているメッセージログファイル※3
jr3alget.dat | 論理ホスト運用の場合の，CCMSアラート情報抽出の実行履歴を保存しているデータログファイル※3
jr3alget.lasttime | 論理ホスト運用の場合の，CCMSアラート情報抽出の前回実行日時を保存しているタイムスタンプファイル※3
SYSLOG | 論理ホスト運用の場合の，システムログ情報格納ファイル（デフォルト）※4
SYSLOG.ofs | 論理ホスト運用の場合の，システムログ情報格納ファイルの管理ファイル（デフォルト）※4
jr3slget.log | 論理ホスト運用の場合の，システムログ情報抽出の実行履歴を保存しているメッセージログファイル※4
jr3slget.dat | 論理ホスト運用の場合の，システムログ情報抽出の実行履歴を保存しているデータログファイル※4
jr3slget.lasttime | 論理ホスト運用の場合の，システムログ情報抽出の前回実行日時を保存しているタイムスタンプファイル※4
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥ | － | 論理ホスト運用の場合の，Agent Storeサービスのルートフォルダ（インスタンスごと）※1
*.DB | 論理ホスト運用の場合の，パフォーマンスデータファイル（インスタンスごと）※2
*.IDX | 論理ホスト運用の場合の，パフォーマンスデータファイルのインデックスファイル（インスタンスごと）※2
*.LCK | 論理ホスト運用の場合の，パフォーマンスデータファイルのロックファイル（インスタンスごと）※2
jpcsto.ini | 論理ホスト運用の場合の，Agent Storeサービス起動情報ファイル（インスタンスごと）※1
jpcsto.ini.model | 論理ホスト運用の場合の，Agent Storeサービス起動情報ファイルのモデル（インスタンスごと）※1
*.DAT | 論理ホスト運用の場合の，データモデル定義ファイル（インスタンスごと）※1
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥backup¥ | － | 論理ホスト運用の場合の，標準のデータベースバックアップ先フォルダ（インスタンスごと）※1
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥dump¥ | － | 論理ホスト運用の場合の，標準のデータベースエクスポート先フォルダ（インスタンスごと）※1
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥import¥ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，標準のデーターベースインポート先フォルダ（インスタンスごと）※5
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥log¥ | － | 論理ホスト運用の場合の，Agent Storeサービス内部ログファイル格納フォルダ（インスタンスごと）※1
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥partial¥ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，標準のデータベース部分バックアップ先フォルダ（インスタンスごと）※5
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥STPD¥ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，PDレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※5
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥STPI¥ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，PIレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※5
環境ディレクトリ※⁷¥jp1pc¥agtm¥store¥インスタンス名¥STPL¥ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，PLレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※5
環境ディレクトリ※⁷¥jp1pc¥auditlog¥ | － | 論理ホスト運用の場合の，動作ログファイルの標準の出力フォルダ
jpcauditn.log | 論理ホスト運用の場合の，動作ログファイル※6

（凡例）

－：該当しない

注※1

jpcinssetupコマンドの実行で作成されます。

注※2

Agent Storeサービス起動時に作成されます。

注※3

CCMS Alert Monitor Command（PD_ALMX）レコードを収集する場合に作成されます。

注※4

System Log Monitor Command（PD_SLMX）レコードを収集する場合に作成されます。

注※5

StoreデータベースをStoreバージョン2.0で構築したときに作成されます。

注※6

nは数値です。ログファイル数は，jpccomm.iniファイルで変更できます。

注※7

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

付録G.2　UNIXの場合

UNIX版PFM - Agent for Enterprise Applicationsのファイルおよびディレクトリ一覧を次の表に示します。

表G-2　PFM - Agent for Enterprise Applicationsのファイルおよびディレクトリ一覧（UNIX版）

ディレクトリ名 | ファイル名 | 説明
/opt/jp1pc/agtm/ | － | PFM - Agent for Enterprise Applicationsのルートディレクトリ
/opt/jp1pc/agtm/agent/ | － | Agent Collectorサービスのルートディレクトリ
jpcagtm | Agent Collectorサービス実行プログラム
/opt/jp1pc/agtm/agent/インスタンス名/ | － | Agent Collectorサービスのルートディレクトリ（インスタンスごと）※1
jpcagt.ini | Agent Collectorサービス起動情報ファイル（インスタンスごと）※1
jpcagt.ini.lck | Agent Collectorサービス起動情報ファイル（インスタンスごと）のロックファイル※2
jpcagt.ini.model | Agent Collectorサービス起動情報ファイルのモデルファイル（インスタンスごと）※1
jr3alget.ini | CCMS Alert Monitor Command（PD_ALMX）レコード用の環境パラメーター設定ファイル※1
jr3slget.ini | System Log Monitor Command（PD_SLMX）レコード用の環境パラメーター設定ファイル※1
/opt/jp1pc/agtm/agent/インスタンス名/log/ | － | Agent Collectorサービス内部ログファイル格納ディレクトリ（インスタンスごと）※1
ALERT | CCMSアラート情報格納ファイル（デフォルト）※4
ALERT.ofs | CCMSアラート情報格納ファイルの管理ファイル（デフォルト）※4
jr3alget.log | CCMSアラート情報抽出の実行履歴を保存しているメッセージログファイル※4
jr3alget.dat | CCMSアラート情報抽出の実行履歴を保存しているデータログファイル※4
jr3alget.lasttime | CCMSアラート情報抽出の前回実行日時を保存しているタイムスタンプファイル※4
SYSLOG | システムログ情報格納ファイル（デフォルト）※5
SYSLOG.ofs | システムログ情報格納ファイルの管理ファイル（デフォルト）※5
jr3slget.log | システムログ情報抽出の実行履歴を保存しているメッセージログファイル※5
jr3slget.dat | システムログ情報抽出の実行履歴を保存しているデータログファイル※5
jr3slget.lasttime | システムログ情報抽出の前回実行日時を保存しているタイムスタンプファイル※5
/opt/jp1pc/agtm/evtrap/ | － | SAPイベント管理機能のルートディレクトリ
jr3alget | CCMSアラートの抽出と変換コマンド
jr3alget.ini.sample | jr3algetコマンドの環境パラメーター設定ファイルのモデルファイル
jr3slget | システムログの抽出と変換コマンド
jr3slget.ini.sample | jr3slgetコマンドの環境パラメーター設定ファイルのモデルファイル
/opt/jp1pc/agtm/lib/ | － | RFCライブラリー格納ディレクトリ
librfccm.* | SAPシステムのRFCライブラリー（共有ライブラリー版）
/opt/jp1pc/agtm/nls/ | － | メッセージカタログ格納ディレクトリ
/opt/jp1pc/agtm/store/ | － | Agent Storeサービスのルートディレクトリ
*.DAT | データモデル定義ファイル
/opt/jp1pc/agtm/store/インスタンス名/ | － | Agent Storeサービスのルートディレクトリ（インスタンスごと）※1
*.DB | パフォーマンスデータファイル（インスタンスごと）※3
*.IDX | パフォーマンスデータファイルのインデックスファイル（インスタンスごと）※3
*.LCK | パフォーマンスデータファイルのロックファイル（インスタンスごと）※3
jpcsto.ini | Agent Storeサービス起動情報ファイル（インスタンスごと）※1
jpcsto.ini.model | Agent Storeサービス起動情報ファイルのモデル（インスタンスごと）※1
*.DAT | データモデル定義ファイル（インスタンスごと）※1
/opt/jp1pc/agtm/store/インスタンス名/backup/ | － | 標準のデータベースバックアップ先ディレクトリ（インスタンスごと）※1
/opt/jp1pc/agtm/store/インスタンス名/dump/ | － | 標準のデータベースエクスポート先ディレクトリ（インスタンスごと）※1
/opt/jp1pc/agtm/store/インスタンス名/import/ | － | Storeバージョン2.0の場合の，標準のデーターベースインポート先ディレクトリ（インスタンスごと）※6
/opt/jp1pc/agtm/store/インスタンス名/log/ | － | Agent Storeサービス内部ログファイル格納ディレクトリ（インスタンスごと）※1
/opt/jp1pc/agtm/store/インスタンス名/partial/ | － | Storeバージョン2.0の場合の，標準のデータベース部分バックアップ先ディレクトリ（インスタンスごと）※6
/opt/jp1pc/agtm/store/インスタンス名/STPD/ | － | Storeバージョン2.0の場合の，PDレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※6
/opt/jp1pc/agtm/store/インスタンス名/STPI/ | － | Storeバージョン2.0の場合の，PIレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※6
/opt/jp1pc/agtm/store/インスタンス名/STPL/ | － | Storeバージョン2.0の場合の，PLレコードタイプのパフォーマンスデータのルートフォルダ（インスタンスごと）※6
/opt/jp1pc/patch_files/agtm/ | － | パッチ用ファイル格納ディレクトリ
/opt/jp1pc/auditlog/ | － | 動作ログファイルの標準の出力ディレクトリ
jpcauditn.log | 動作ログファイル※7
/opt/jp1pc/setup/ | － | セットアップファイル格納ディレクトリ
jpcagtmu.Z | PFM - Agentセットアップ用アーカイブファイル（UNIX）
jpcagtmw.EXE | PFM - Agentセットアップ用アーカイブファイル（Windows）
環境ディレクトリ※⁸/jp1pc/agtm/agent/インスタンス名/ | － | 論理ホスト運用の場合の，Agent Collectorサービスのルートディレクトリ（インスタンスごと）※1
jpcagt.ini | 論理ホスト運用の場合の，Agent Collectorサービス起動情報ファイル（インスタンスごと）※1
jpcagt.ini.model | 論理ホスト運用の場合の，Agent Collectorサービス起動情報ファイルのモデルファイル（インスタンスごと）※1
jr3alget.ini | 論理ホスト運用の場合の，CCMS Alert Monitor Command（PD_ALMX）レコード用の環境パラメーター設定ファイル※1
jr3slget.ini | 論理ホスト運用の場合の，System Log Monitor Command（PD_SLMX）レコード用の環境パラメーター設定ファイル※1
環境ディレクトリ※⁸/jp1pc/agtm/agent/インスタンス名/log/ | － | 論理ホスト運用の場合の，Agent Collectorサービス内部ログファイル格納ディレクトリ（インスタンスごと）※1
ALERT | 論理ホスト運用の場合の，CCMSアラート情報格納ファイル（デフォルト）※4
ALERT.ofs | 論理ホスト運用の場合の，CCMSアラート情報格納ファイルの管理ファイル（デフォルト）※4
jr3alget.log | 論理ホスト運用の場合の，CCMSアラート情報抽出の実行履歴を保存しているメッセージログファイル※4
jr3alget.dat | 論理ホスト運用の場合の，CCMSアラート情報抽出の実行履歴を保存しているデータログファイル※4
jr3alget.lasttime | 論理ホスト運用の場合の，CCMSアラート情報抽出の前回実行日時を保存しているタイムスタンプファイル※4
SYSLOG | 論理ホスト運用の場合の，システムログ情報格納ファイル（デフォルト）※5
SYSLOG.ofs | 論理ホスト運用の場合の，システムログ情報格納ファイルの管理ファイル（デフォルト）※5
jr3slget.log | 論理ホスト運用の場合の，システムログ情報抽出の実行履歴を保存しているメッセージログファイル※5
jr3slget.dat | 論理ホスト運用の場合の，システムログ情報抽出の実行履歴を保存しているデータログファイル※5
jr3slget.lasttime | 論理ホスト運用の場合の，システムログ情報抽出の前回実行日時を保存しているタイムスタンプファイル※5
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/ | － | 論理ホスト運用の場合の，Agent Storeサービスのルートディレクトリ（インスタンスごと）※1
*.DB | 論理ホスト運用の場合の，パフォーマンスデータファイル（インスタンスごと）※3
*.IDX | 論理ホスト運用の場合の，パフォーマンスデータファイルのインデックスファイル（インスタンスごと）※3
*.LCK | 論理ホスト運用の場合の，パフォーマンスデータファイルのロックファイル（インスタンスごと）※3
jpcsto.ini | 論理ホスト運用の場合の，Agent Storeサービス起動情報ファイル（インスタンスごと）※1
jpcsto.ini.model | 論理ホスト運用の場合の，Agent Storeサービス起動情報ファイルのモデル（インスタンスごと）※1
*.DAT | 論理ホスト運用の場合の，データモデル定義ファイル（インスタンスごと）※1
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/backup/ | － | 論理ホスト運用の場合の，標準のデータベースバックアップ先ディレクトリ（インスタンスごと）※1
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/dump/ | － | 論理ホスト運用の場合の，標準のデータベースエクスポート先ディレクトリ（インスタンスごと）※1
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/import/ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，標準のデーターベースインポート先ディレクトリ（インスタンスごと）※6
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/log/ | － | 論理ホスト運用の場合の，Agent Storeサービス内部ログファイル格納ディレクトリ（インスタンスごと）※1
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/partial/ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，標準のデータベース部分バックアップ先ディレクトリ（インスタンスごと）※6
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/STPD/ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，PDレコードタイプのパフォーマンスデータのルートディレクトリ（インスタンスごと）※6
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/STPI/ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，PIレコードタイプのパフォーマンスデータのルートディレクトリ（インスタンスごと）※6
環境ディレクトリ※⁸/jp1pc/agtm/store/インスタンス名/STPL/ | － | 論理ホスト運用の場合でStoreバージョン2.0の場合の，PLレコードタイプのパフォーマンスデータのルートディレクトリ（インスタンスごと）※6
環境ディレクトリ※⁸/jp1pc/auditlog/ | － | 論理ホスト運用の場合の，動作ログファイルの標準の出力ディレクトリ
jpcauditn.log | 論理ホスト運用の場合の，動作ログファイル※7

（凡例）

－：該当しない

注※1

jpcinssetupコマンドの実行で作成されます。

注※2

PFM - Agent for Enterprise Applicationsが内部で使用しているファイルです。変更および削除はしないでください。

注※3

Agent Storeサービス起動時に作成されます。

注※4

CCMS Alert Monitor Command（PD_ALMX）レコードを収集する場合に作成されます。

注※5

System Log Monitor Command（PD_SLMX）レコードを収集する場合に作成されます。

注※6

StoreデータベースをStoreバージョン2.0で構築したときに作成されます。

注※7

nは数値です。ログファイル数は，jpccomm.iniファイルで変更できます。

注※8

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

付録H　移行手順と移行時の注意事項

PFM - Agent for Enterprise Applicationsのバージョンアップ方法について説明します。

PFM - Agent for Enterprise Applicationsをバージョンアップする場合，PFM - Agent for Enterprise Applicationsを上書きインストールします。

上書きインストールを実施すると，次の項目が自動的に更新されます。

Agent StoreサービスのStoreデータベースファイル

iniファイル

PFM - Agent for Enterprise Applicationsのインスタンス環境

また，旧バージョンのPerformance Managementからの移行（07-50以前から08-00以降へのバージョンアップ）についての詳細は，マニュアル「JP1/Performance Management システム構築・運用ガイド」の付録を参照してください。

注意

バージョンアップする場合に，古いバージョンのPFM - Agent for Enterprise Applicationsをアンインストールすると，古いバージョンで収集したパフォーマンスデータも一緒に削除されてしまうため，新しいバージョンで使用できなくなります。

付録I　バージョン互換

PFM - Agentには，製品のバージョンのほかに，データモデルのバージョンがあります。

PFM - Agentをバージョンアップしたときに，データモデルもバージョンアップされます。データモデルは，上位互換を保っているため，古いバージョンで定義したレポートの定義やアラームの定義は，新しいバージョンのデータモデルでも使用できます。

PFM - Agent for Enterprise Applicationsのバージョンの対応を次の表に示します。

表I-1　PFM - Agent for Enterprise Applicationsのバージョン対応表

PFM - Agent for Enterprise Applicationsのバージョン | データモデルのバージョン | ソリューションセットのアラームテーブルのバージョン
06-70 | 3.0 | 6.70
07-00 | 4.0 | 7.00
07-50 | 5.0 | 7.50
08-00 | 5.0 | 8.00
08-10 | 5.0 | 8.10
08-50 | 5.0 | 8.50

バージョン互換については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されているバージョン互換を参照してください。

付録J　動作ログの出力

Performance Managementの動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能やPFMサービスの起動・停止などと連動した動作情報の履歴を出力するログ情報です。

例えば，PFMサービスの起動・停止時や，PFM - Managerとの接続状態の変更時に動作ログに出力されます。

動作ログは，PFM - ManagerまたはPFM - Baseが08-10以降の場合に出力できます。

動作ログは，CSV形式で出力されるテキストファイルです。定期的に保存して表計算ソフトで加工することで，分析資料として利用できます。

動作ログは，jpccomm.iniの設定によって出力されるようになります。ここでは，PFM - AgentおよびPFM - Baseが出力する動作ログの出力内容と，動作ログを出力するための設定方法について説明します。

＜この節の構成＞

付録J.1　動作ログに出力される事象の種別

付録J.2　動作ログの保存形式

付録J.3　動作ログの出力形式

付録J.4　動作ログを出力するための設定

付録J.1　動作ログに出力される事象の種別

動作ログに出力される事象の種別およびPFM - AgentおよびPFM - Baseが動作ログを出力する契機を次の表に示します。事象の種別とは，動作ログに出力される事象を分類するための，動作ログ内での識別子です。

表J-1　動作ログに出力される事象の種別

事象の種別
説明
PFM - AgentおよびPFM - Baseが出力する契機

StartStop
ソフトウェアの起動と終了を示す事象。

PFMサービスの起動・停止

スタンドアロンモードの開始・終了

ExternalService
JP1製品と外部サービスとの通信結果を示す事象。
異常な通信の発生を示す事象。
PFM - Managerとの接続状態の変更

ManagementAction
プログラムの重要なアクションの実行を示す事象。
ほかの監査カテゴリーを契機にアクションが実行されたことを示す事象。
自動アクションの実行

付録J.2　動作ログの保存形式

ここでは，動作ログのファイル保存形式について説明します。

動作ログは規定のファイル（カレント出力ファイル）に出力され，満杯になった動作ログは別のファイル（シフトファイル）として保存されます。動作ログのファイル切り替えの流れは次のとおりです。

動作ログは，カレント出力ファイル「jpcaudit.log」に順次出力されます。

カレント出力ファイルが満杯になると，その動作ログはシフトファイルとして保存されます。
シフトファイル名は，カレント出力ファイル名の末尾に数値を付加した名称です。シフトファイル名は，カレント出力ファイルが満杯になるたびにそれぞれ「ファイル名末尾の数値+1」へ変更されます。つまり，ファイル末尾の数値が大きいほど，古いログファイルとなります。

例

カレント出力ファイル「jpcaudit.log」が満杯になると，その内容はシフトファイル「jpcaudit1.log」へ保管されます。

カレント出力ファイルが再び満杯になると，そのログは「jpcaudit1.log」へ移され，既存のシフトファイル「jpcaudit1.log」は「jpcaudit2.log」へリネームされます。

なお，ログファイル数が保存面数（jpccomm.iniファイルで指定）を超えると，古いログファイルから削除されます。

カレント出力ファイルが初期化され，新たな動作ログが書き込まれます。

動作ログの出力要否，出力先および保存面数は，jpccomm.iniファイルで設定します。jpccomm.iniファイルの設定方法については，「付録J.4　動作ログを出力するための設定」を参照してください。

付録J.3　動作ログの出力形式

Performance Managementの動作ログには，監査事象に関する情報が出力されます。動作ログは，ホスト（物理ホスト・論理ホスト）ごとに1ファイル出力されます。動作ログの出力先ホストは次のようになります。

サービスを実行した場合：実行元サービスが動作するホストに出力

コマンドを実行した場合：コマンドを実行したホストに出力

動作ログの出力形式，出力先，出力項目について次に説明します。

＜この項の構成＞

(1)　出力形式

(2)　出力先

(3)　出力項目

(4)　出力例

(1)　出力形式

CALFHM x.x,出力項目1=値1,出力項目2=値2,…,出力項目n=値n

(2)　出力先

表J-2　デフォルトの動作ログ出力先ディレクトリ

プラットフォーム | デフォルトの出力先ディレクトリ
Windows | インストール先フォルダ¥auditlog¥
Windows（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥auditlog¥
UNIX | /opt/jp1pc/auditlog/
UNIX（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/auditlog/

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

動作ログの出力先は，jpccomm.iniファイルで変更できます。jpccomm.iniファイルの設定方法については，「付録J.4　動作ログを出力するための設定」を参照してください。

(3)　出力項目

出力項目には二つの分類があります。

共通出力項目
動作ログを出力するJP1製品が共通して出力する項目です。

固有出力項目
動作ログを出力するJP1製品が任意に出力する項目です。

(a)　共通出力項目

共通出力項目に出力される値と項目の内容を次の表に示します。なお，この表はPFM - Managerが出力する項目や内容も含みます。

表J-3　動作ログの共通出力項目

項番
出力項目
値
内容

項目名
出力される属性名

1
共通仕様識別子
－
CALFHM
動作ログフォーマットであることを示す識別子

2
共通仕様リビジョン番号
－
x.x
動作ログを管理するためのリビジョン番号

3
通番
seqnum
通し番号
動作ログレコードの通し番号

4
メッセージID
msgid
KAVExxxxx-x
製品のメッセージID

5
日付・時刻
date
YYYY-MM-DDThh:mm:ss.sssTZD※
動作ログの出力日時およびタイムゾーン

6
発生プログラム名
progid
JP1PFM
事象が発生したプログラムのプログラム名

7
発生コンポーネント名
compid
サービスID
事象が発生したコンポーネント名

8
発生プロセスID
pid
プロセスID
事象が発生したプロセスのプロセスID

9
発生場所
ocp:host

ホスト名

IPアドレス

事象が発生した場所

10
事象の種別
ctgry

StartStop

Authentication

ConfigurationAccess

ExternalService

AnomalyEvent

ManagementAction

動作ログに出力される事象を分類するためのカテゴリー名

11
事象の結果
result

Success（成功）

Failure（失敗）

Occurrence（発生）

事象の結果

12
サブジェクト識別情報
subj:pid
プロセスID
次のどれかの情報

ユーザー操作により動作するプロセスID

事象を発生させたプロセスID

事象を発生させたユーザー名

ユーザーに1：1で対応づけられた識別情報

subj:uid
アカウント識別子（PFMユーザー/JP1ユーザー）

subj:euid
実効ユーザーID（OSユーザー）

（凡例）

－：なし

注※

Tは日付と時刻の区切りです。

ZDはタイムゾーン指定子です。次のどれかが出力されます。

+hh:mm：UTCからhh:mmだけ進んでいることを示す。

-hh:mm：UTCからhh:mmだけ遅れていることを示す。

Z：UTCと同じであることを示す。

(b)　固有出力項目

固有出力項目に出力される値と項目の内容を次の表に示します。なお，この表はPFM - Managerが出力する項目や内容も含みます。

表J-4　動作ログの固有出力項目

項番
出力項目
値
内容

項目名
出力される属性名

1
オブジェクト情報
obj

PFM - AgentのサービスID

追加，削除，更新されたユーザー名（PFMユーザー）

操作の対象

obj:table
アラームテーブル名

obj:alarm
アラーム名

2
動作情報
op

Start（起動）

Stop（停止）

Add（追加）

Update（更新）

Delete（削除）

Change Password（パスワード変更）

Activate（有効化）

Inactivate（無効化）

Bind（バインド）

Unbind（アンバインド）

事象を発生させた動作情報

3
権限情報
auth

管理者ユーザー
Management

一般ユーザー
Ordinary

Windows
Administrator

UNIX
SuperUser

操作したユーザーの権限情報

auth:mode

PFM認証モード
pfm

JP1認証モード
jp1

OSユーザー
os

操作したユーザーの認証モード

4
出力元の場所
outp:host
PFM - Managerのホスト名
動作ログの出力元のホスト

5
指示元の場所
subjp:host

ログイン元ホスト名

実行ホスト名（jpcalarmコマンド実行時だけ）

操作の指示元のホスト

6
自由記述
msg
メッセージ
アラーム発生時，および自動アクションの実行時に出力されるメッセージ

固有出力項目は，出力契機ごとに出力項目の有無や内容が異なります。出力契機ごとに，メッセージIDと固有出力項目の内容を次に説明します。

●PFMサービスの起動・停止（StartStop）

出力ホスト：該当するサービスが動作しているホスト

出力コンポーネント：起動・停止を実行する各サービス

項目名
属性名
値

メッセージID
msgid
起動：KAVE03000-I
停止：KAVE03001-I

動作情報
op
起動：Start
停止：Stop

●スタンドアロンモードの開始・終了（StartStop）

出力ホスト：PFM - Agentホスト

出力コンポーネント：Agent Collectorサービス，Agent Storeサービス

項目名
属性名
値

メッセージID
msgid
スタンドアロンモードを開始：KAVE03002-I
スタンドアロンモードを終了：KAVE03003-I

注1

固有出力項目は出力されません。

注2

PFM - Agentの各サービスは，起動時にPFM - Managerホストに接続し，ノード情報の登録，最新のアラーム定義情報の取得などを行います。PFM - Managerホストに接続できない場合，稼働情報の収集など一部の機能だけが有効な状態（スタンドアロンモード）で起動します。その際，スタンドアロンモードで起動することを示すため，KAVE03002-Iが出力されます。その後，一定期間ごとにPFM - Managerへの再接続を試み，ノード情報の登録，定義情報の取得などに成功すると，スタンドアロンモードから回復し，KAVE03003-Iが出力されます。この動作ログによって，KAVE03002-IとKAVE03003-Iが出力されている間は，PFM - Agentが不完全な状態で起動していることを知ることができます。

●PFM - Managerとの接続状態の変更（ExternalService）

出力ホスト：PFM - Agentホスト

出力コンポーネント：Agent Collectorサービス，Agent Storeサービス

項目名
属性名
値

メッセージID
msgid
PFM - Managerへのイベントの送信に失敗（キューイングを開始）：KAVE03300-I
PFM - Managerへのイベントの再送が完了：KAVE03301-I

注1

固有出力項目は出力されません。

注2

Agent Storeサービスは，PFM - Managerへのイベント送信に失敗すると，イベントのキューイングを開始し，以降はイベントごとに最大3件がキューにためられます。KAVE03300-Iは，イベント送信に失敗し，キューイングを開始した時点で出力されます。PFM - Managerとの接続が回復したあと，キューイングされたイベントの送信が完了した時点で，KAVE03301-Iが出力されます。この動作ログによって，KAVE03300-IとKAVE03301-Iが出力されている間は，PFM - Managerへのイベント送信がリアルタイムでできていなかった期間と知ることができます。

注3

Agent Collectorサービスは，通常，Agent Storeサービスを経由してPFM - Managerにイベントを送信します。何らかの理由でAgent Storeサービスが停止している場合だけ，直接PFM - Managerにイベントを送信しますが，失敗した場合にKAVE03300-Iが出力されます。この場合，キューイングを開始しないため，KAVE03301-Iは出力されません。この動作ログによって，PFM - Managerに送信されなかったイベントがあることを知ることができます。

●自動アクションの実行（ManagementAction）

出力ホスト：アクションを実行したホスト

出力コンポーネント：Action Handlerサービス

項目名
属性名
値

メッセージID
msgid
コマンド実行プロセス生成に成功：KAVE03500-I
コマンド実行プロセス生成に失敗：KAVE03501-W
E-mail送信に成功：KAVE03502-I
E-mail送信に失敗：KAVE03503-W

自由記述
msg
コマンド実行：cmd=実行したコマンドライン
E-mail送信：mailto=送信先メールアドレス

注

コマンド実行プロセスの生成に成功した時点でKAVE03500-Iが出力されます。その後，コマンドが実行できたかどうかのログ，および実行結果のログは，動作ログには出力されません。

(4)　出力例

動作ログの出力例を次に示します。

CALFHM 1.0, seqnum=1, msgid=KAVE03000-I, date=2007-01-18T22:46:49.682+09:00,
progid=JP1PFM, compid=TA1host01, pid=2076,
ocp:host=host01, ctgry=StartStop, result=Occurrence,
subj:pid=2076,op=Start

付録J.4　動作ログを出力するための設定

動作ログを出力するための設定は，jpccomm.iniファイルで定義します。設定しない場合，動作ログは出力されません。動作ログを出力するための設定内容とその手順について次に示します。

＜この項の構成＞

(1)　設定手順

(2)　jpccomm.iniファイルの詳細

(1)　設定手順

動作ログを出力するための設定手順を次に示します。

ホスト上の全PFMサービスを停止させる。

テキストエディターなどで，jpccomm.iniファイルを編集する。

jpccomm.iniファイルを保存して閉じる。

(2)　jpccomm.iniファイルの詳細

jpccomm.iniファイルの詳細について説明します。

(a)　格納先ディレクトリ

表J-5　jpccomm.iniファイルの格納先ディレクトリ

プラットフォーム | 格納先ディレクトリ
Windows | インストール先フォルダ
Windows（論理ホスト運用の場合） | 環境ディレクトリ※¥jp1pc¥
UNIX | /opt/jp1pc/
UNIX（論理ホスト運用の場合） | 環境ディレクトリ※/jp1pc/

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

(b)　形式

jpccomm.iniファイルには，次の内容を定義します。

動作ログの出力の有無

動作ログの出力先

動作ログの保存面数

動作ログのファイルサイズ

指定形式は次のとおりです。

"項目名"=値

設定項目を次の表に示します。

表J-6　jpccomm.iniファイルで設定する項目および初期値

項番
項目
説明

1
[Action Log Section]
セクション名です。変更はできません。

2
Action Log Mode
動作ログを出力するかどうかを指定します。この項目の設定は省略できません。

初期値
0（出力しない）

指定できる値
0（出力しない），1（出力する）
これ以外の値を指定すると，エラーメッセージが出力され，動作ログは出力されません。

3
Action Log Dir
動作ログの出力先を指定します。
論理ホスト環境の場合は共有ディスク上のディレクトリを指定します。共有ディスク上にないディレクトリを指定した場合，論理ホストを構成する各物理ホストへ動作ログが出力されます。
なお，制限長を超えるパスを設定した場合や，ディレクトリへのアクセスが失敗した場合は，共通ログにエラーメッセージが出力され，動作ログは出力されません。

初期値
省略

省略した場合に適用される値（デフォルト値）
・Windowsの場合
　インストール先フォルダ¥auditlog¥
・Windowsの場合（論理ホスト運用の場合）
　環境ディレクトリ※¥jp1pc¥auditlog¥
・UNIXの場合
　/opt/jp1pc/auditlog/
・UNIXの場合（論理ホスト運用の場合）
　環境ディレクトリ※/jp1pc/auditlog/
注※
環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

指定できる値
1～185バイトの文字列

4
Action Log Num
ログファイルの総数の上限（保存面数）を指定します。カレント出力ファイルとシフトファイルの合計を指定してください。

初期値
省略

省略した場合に適用される値（デフォルト値）
5

指定できる値
2～10の整数

数値以外の文字列を指定した場合，エラーメッセージが出力され，デフォルト値である5が設定されます。
範囲外の数値を指定した場合，エラーメッセージを出力し，指定値に最も近い2～10の整数値が設定されます。

5
Action Log Size
ログファイルのサイズをキロバイト単位で指定します。

初期値
省略

省略した場合に適用される値（デフォルト値）
2048

指定できる値
512～2096128の整数

数値以外の文字列を指定した場合，エラーメッセージが出力され，デフォルト値である2048が設定されます。
範囲外の数値を指定した場合，エラーメッセージが出力され，指定値に最も近い512～2096128の整数値が設定されます。

付録K　各バージョンの変更内容

＜この節の構成＞

付録K.1　08-10の変更内容

付録K.2　08-00の変更内容

付録K.3　07-50の変更内容

付録K.4　07-00の変更内容

付録K.1　08-10の変更内容

ソリューションセットのアラームテーブルのバージョンを8.00から8.10に変更しました。

新規にインスタンスを構築するときに，Storeバージョンを選択できるように変更しました。

適用OSにWindows 2000を追加しました。

動作ログを出力する機能を追加しました。

Storeバージョン2.0への移行手順を追加しました。

パフォーマンスデータの格納先をコマンドによって変更する方法を追加しました。

UNIX版PFM - Web ConsoleへのPFM - Agent for Enterprise Applicationsの登録方法を追加しました。

SAP ERP Central Component 6.0以降，または，SAP Business Information Warehouse 7.0以降のSAPシステムに接続する場合の，SAPのユーザーにおけるパスワードの注意事項を追加しました。

付録K.2　08-00の変更内容

製品名をJP1/Performance Management - Agent Option for Enterprise Applicationsに変更しました。

対象製品にPFM - Web ConsoleおよびPFM - Baseを追加しました。

稼働OSから次を削除しました。

Windows 2000

Performance Management の製品構成の変更に伴い，ファイルとフォルダの一覧を変更しました。

ソリューションセットのアラームテーブルのバージョンを7.50から8.00に変更しました。

付録K.3　07-50の変更内容

データモデルのバージョンを4.0から5.0に変更しました。

レコードを追加しました。
User defined Monitor (Perf.)（PI_UMP）レコード

次のメッセージを追加しました。
KAVF14174-W，KAVF14175-W，KAVF14176-W，KAVF14177-W

ソリューションセットのアラームテーブルのバージョンを7.00から7.50に変更しました。

Unicode版SAPシステムとの接続をサポートしました。

付録K.4　07-00の変更内容

PFM - Agent for SAP R/3の適用OSを次のように変更しました。

プログラム名
変更内容

PFM - Agent for SAP R/3
Windows Server 2003(IPF)を追加した。
Windows Server 2003を追加した。
Windows NTを削除した。

複数LAN接続機能をサポートしました。

SAPシステムのシステムログ情報を定期的に抽出する機能をサポートしました。

SAPシステムのCCMSアラート情報を定期的に抽出する機能をサポートしました。

アラームのソリューションセットのバージョンを6.70から7.00に変更しました。

データモデルのバージョンを3.0から4.0に変更しました。変更内容を次に示します。

追加

レコード名 | フィールド名
CCMS Alert Monitor Command（PD_ALMX） | －
System Log Monitor Command（PD_SLMX） | －

変更

レコード名 | フィールド名 | 変更内容
WorkLoad Summary Interval（PI） | － | 変更可否

jr3algetコマンドおよびjr3slgetコマンドで，コマンドの処理状況を標準出力に出力するオプション（-vオプション）を追加しました。

スタンドアロンモードでPFM - Agentを起動する機能をサポートしました。

Master StoreサービスまたはAgent Storeサービス起動時に実行していたStoreデータベースのインデックスファイルの作成処理を，バージョンアップインストール時，またはデータベースのリストア時に実行するように変更しました。

メッセージを追加，変更，削除しました。

追加
KAVF14129，KAVF14210，KAVF14212，KAVF14213，KAVF14215，KAVF14216，KAVF14255，KAVF14263，KAVF14273，KAVF14275，KAVF14276，KAVF14277

変更
KAVF14000，KAVF14001，KAVF14002，KAVF14103，KAVF14105，KAVF14121，KAVF14122，KAVF14125，KAVF14127，KAVF14128，KAVF14131，KAVF14133，KAVF14134，KAVF14136，KAVF14150，KAVF14151，KAVF14160，KAVF14161，KAVF14171，KAVF14173，KAVF14200，KAVF14201，KAVF14211，KAVF14220，KAVF14221，KAVF14222，KAVF14223，KAVF14224，KAVF14225，KAVF14226，KAVF14227，KAVF14229，KAVF14230，KAVF14231，KAVF14232，KAVF14233，KAVF14240，KAVF14241，KAVF14242，KAVF14243，KAVF14250，KAVF14251，KAVF14253，KAVF14254，KAVF14256，KAVF14260，KAVF14261，KAVF14262，KAVF14270，KAVF14271，KAVF14272，KAVF14274，KAVF14278

削除
KAVF14003，KAVF14102，KAVF14110，KAVF14111，KAVF14132，KAVF14135

次のプロパティを追加しました。

サービス名 | プロパティ
Agent Collectorサービス | Data Model Version

次のプロパティを削除しました。

サービス名
プロパティ

Agent Storeサービス
Copyright以下すべて
Network Services下のVersion

Agent Collectorサービス
Network Services下のVersion

付録L　用語解説

（英字）

CCMSアラート情報抽出機能

CCMS（Computer Center Management System）の警告モニター内で発生する警告（アラート情報）を抽出するPFM - Agent for Enterprise Applicationsの機能のことです。

（カ行）

拡張パスワード

SAP NetWeaver 7.0以降をベースとしたSAPシステムで利用できるパスワードのことです。SAP NetWeaver 7.0をベースとしたSAPシステムでは，パスワードの文字数は8桁以内から40桁以内へと拡張，英字は大文字固定から大文字・小文字は区別されるようにパスワードルールが変更されています。

（サ行）

システムログ情報抽出機能

SAPシステムで発生したイベントおよび障害を記録するログ（システムログ）を抽出するPFM - Agent for Enterprise Applicationsの機能のことです。システムログは，アプリケーションサーバごとに記録されます。

（マ行）

モニター情報収集機能

SAPシステムのモニター情報を，ユーザーの定義に基づいて収集し，PFM - Agent for Enterprise Applicationsのユーザー定義レコードとして格納する機能のことです。

索引

[数字]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｆ][Ｇ][Ｈ][Ｉ][Ｊ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｗ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行][ワ行]

(数字)

07-00の変更内容

07-50の変更内容

08-00の変更内容

08-10の変更内容

(英字)

(Ａ)

ABAPバッファ

Agent Collectorサービスのプロパティ一覧

Agent Storeサービスのプロパティ一覧

(Ｂ)

Background Processing（PI_BTCP）レコード

Background Service（PI_BTC）レコード

Buffer - CUAアラーム

Buffer - FieldDescriアラーム

Buffer - GenericKeyアラーム

Buffer - InitialRecoアラーム

Buffer - Programアラーム

Buffer - Screenアラーム

Buffer - ShortNameTAアラーム

Buffer - SingleRecorアラーム

Buffer - TableDefiniアラーム

(Ｃ)

CCMS Alert Monitor Command（PD_ALMX）レコード

CCMSアラート情報

CCMSアラート情報抽出機能

CCMSアラート情報抽出機能の概要

CCMSアラート情報の監視

CCMSアラート情報の抽出

CCMSモニタリングアーキテクチャー

COMMANDセクション

COMMANDセクション

CONNECTセクション

CONNECTセクション

CONNECTセクション

CONNECTセクション

CUAバッファ

(Ｄ)

Dialog ResponseTime Statusレポート

Dialog ResponseTime Trend(Multi-Agent)レポート

Dialog ResponseTime Trendレポート

Dialog ResponseTime Trendレポート

Dialog ResponseTimeアラーム

Dialog ResponseTimeレポート

Dialog Service（PI_DIA）レコード

Dynproバッファ

(Ｅ)

Enqueue Service（PI_ENQ）レコード

Extended Memoryアラーム

EXTRACTFILEセクション

EXTRACTFILEセクション

EXTRACTFILEセクション

EXTRACTFILEセクション

(Ｆ)

Field descriptionバッファ

FORMATセクション

FORMATセクション

FORMATセクション

FORMATセクション

FTABバッファ

(Ｇ)

Generic keyバッファ

Generic tableバッファ

(Ｈ)

HAクラスタシステム

Heap Memoryアラーム

(Ｉ)

Initial recordバッファ

IPアドレスの設定

IPアドレスの設定

IPアドレスを設定する

IPアドレスを設定する

IRECバッファ

(Ｊ)

jpcdbctrl configコマンド

jpcdbctrl configコマンド

jpchostsファイル

jpchostsファイル

jpcrasコマンド

jpcsto.iniファイルの設定項目

jpcsto.iniファイルの設定項目

jpcsto.iniファイルの編集前の準備

jpcsto.iniファイルの編集前の準備

jpcsto.iniファイルの編集手順

jpcsto.iniファイルの編集手順

jpcsto.iniファイルを編集して設定を変更する

jpcsto.iniファイルを編集して設定を変更する

jr3algetコマンド

jr3slgetコマンド

(Ｌ)

LANG環境変数を設定する

(Ｍ)

Menuバッファ

(Ｎ)

Nametabバッファ

NTABバッファ

(Ｏ)

ODBCキーフィールド一覧

(Ｐ)

Paging Areaアラーム

Partial tableバッファ

PD

PD_ALMX

PD_SLMX

PD_SRV

PDレコードタイプ

Performance Managementシステムの障害回復

Performance Managementプログラム

Performance Managementプログラム

PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの作成

PFM - Agent for Enterprise Applicationsで使用するSAPユーザーの作成

PFM - Agent for Enterprise Applicationsのアンインストールとアンセットアップの流れ

PFM - Agent for Enterprise Applicationsのアンインストールとアンセットアップの流れ

PFM - Agent for Enterprise Applicationsのアンセットアップ

PFM - Agent for Enterprise Applicationsのアンセットアップ

PFM - Agent for Enterprise Applicationsの運用方式の変更

PFM - Agent for Enterprise Applicationsの運用方式の変更

PFM - Agent for Enterprise Applicationsの運用方式の変更

PFM - Agent for Enterprise Applicationsの概要

PFM - Agent for Enterprise Applicationsのシステム構成の変更

PFM - Agent for Enterprise Applicationsのシステム構成の変更

PFM - Agent for Enterprise Applicationsの接続先PFM - Managerの設定

PFM - Agent for Enterprise Applicationsの接続先PFM - Managerの設定

PFM - Agent for Enterprise Applicationsのセットアップ手順

PFM - Agent for Enterprise Applicationsのセットアップ手順

PFM - Agent for Enterprise Applicationsのセットアップファイルをコピーする

PFM - Agent for Enterprise Applicationsのセットアップファイルをコピーする

PFM - Agent for Enterprise Applicationsの登録

PFM - Agent for Enterprise Applicationsの登録

PFM - Agent for Enterprise Applicationsの特長

PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップする

PFM - Agent for Enterprise Applicationsの論理ホスト環境をセットアップする

PFM - Agent for Enterprise Applicationsを使用したパフォーマンス監視の例

PFM - Agent for Enterprise Applicationsを登録する

PFM - Agent for Enterprise Applicationsを登録する

PFM - Managerが停止した場合の影響

PFM - Managerでの設定の削除

PFM - Managerでの設定の削除

PFM - Managerホストでセットアップコマンドを実行する

PFM - Managerホストでセットアップコマンドを実行する

PFM - Web Consoleホストでセットアップコマンドを実行する

PFM - Web Consoleホストでセットアップコマンドを実行する

PI

PI_BTC

PI_BTCP

PI_BUFF

PI_DIA

PI_ENQ

PI_MEM

PI_SPO

PI_UMP

PI_UPD1

PI_UPD2

PIレコードタイプ

PIレコードタイプのデフォルト保存期間

Presentationバッファ

Process Detailレポート

Process Overview Statusレポート

Programバッファ

Programバッファの監視

PXAバッファ

(Ｒ)

R/3 executableバッファ

R/3 GUIバッファ

Roll Areaアラーム

(Ｓ)

SAP Buffer Detail(CUA)レポート

SAP Buffer Detail(FieldDescription)レポート

SAP Buffer Detail(GenericKey)レポート

SAP Buffer Detail(InitialRecords)レポート

SAP Buffer Detail(Program)レポート

SAP Buffer Detail(Screen)レポート

SAP Buffer Detail(ShortNameTAB)レポート

SAP Buffer Detail(SingleRecord)レポート

SAP Buffer Detail(TableDefinition)レポート

SAP Buffer Hitratio Statusレポート

SAP Buffer Hitratio Trendレポート

SAP Buffer Hitratio Trendレポート

SAP Buffer Hitratioレポート

SAP Buffer Summary（PI_BUFF）レコード

SAP Instance Summary（PD_SRV）レコード

SAP Memory Detailレポート

SAP Memory Summary（PI_MEM）レコード

SAP Memory Used Statusレポート

SAP Memory Used Trendレポート

SAP Memory Used Trendレポート

SAP Memory Usedレポート

SAPシステム全体の負荷状況の監視

SAPシステムの応答時間

SAPシステムログ，CCMSアラートの監視

SAPバッファに関連するレコードとフィールド

SAPバッファの監視

SAPメモリーに関連するレコードとフィールド

SAPメモリーの拡張メモリー使用率の監視

SAPメモリーの監視

SAPメモリーのヒープ領域使用率の監視

SAPメモリーのページング領域使用率の監視

SAPメモリーのロール領域使用率の監視

Screenバッファ

Short nametabバッファ

Short NTABバッファ

Single recordバッファ

SNTABバッファ

Spool Service（PI_SPO）レコード

Storeデータベース

Storeデータベースに記録されるときだけ追加されるフィールド

Storeバージョン1.0からStoreバージョン2.0に移行する場合

Storeバージョン1.0からStoreバージョン2.0に移行する場合

Storeバージョン2.0からStoreバージョン1.0に戻す場合

Storeバージョン2.0からStoreバージョン1.0に戻す場合

Storeバージョン2.0のレコードのデフォルト保存期間

Storeバージョン2.0への移行

Storeバージョン2.0への移行

syslogとWindowsイベントログの一覧

System Log Monitor Command（PD_SLMX）レコード

(Ｔ)

TABL

table DDNTF

table DDNTT

Table definitionバッファ

Tableバッファ

TABLP

TARGETセクション

TARGETセクション

TARGETセクション

TRACEセクション

TRACEセクション

TRACEセクション

TRACEセクション

TTABバッファ

(Ｕ)

UNIXの場合

Update1 Service（PI_UPD1）レコード

Update2 Service（PI_UPD2）レコード

User defined Monitor (Perf.)（PI_UMP）レコード

User defined Monitor (Perf.)（PI_UMP）レコード

UsersLoggedIn Trend(Multi-Agent)レポート

UsersLoggedIn Trendレポート

UsersLoggedIn Trendレポート

(Ｗ)

Windowsの場合

WorkLoad Summary Interval（PI）レコード

Work Process Summary（PD）レコード

(ア行)

(あ)

アクション

アラーム

アラーム一覧

アラームテーブル

アラームの記載形式

アンインストール

アンインストール

アンインストール手順

アンインストール手順

アンインストールとアンセットアップ

アンインストールとアンセットアップ

アンインストールとアンセットアップ（UNIXの場合）

アンインストールとアンセットアップ（Windowsの場合）

アンインストールとアンセットアップの前に

アンインストールとアンセットアップの前に

アンセットアップ手順

アンセットアップ手順

(い)

移行時の注意事項

移行手順

インスタンス環境のアンセットアップ

インスタンス環境のアンセットアップ

インスタンス環境の更新の設定

インスタンス環境の更新の設定

インスタンス環境の更新の設定［クラスタ運用時］

インスタンス環境の設定

インスタンス環境の設定

インスタンス環境を設定する

インスタンス環境を設定する

インストール

インストール

インストールから運用開始までの流れ

インストールから運用開始までの流れ

インストール手順

インストール手順

インストールとセットアップ

インストールとセットアップ

インストールとセットアップ（UNIXの場合）

インストールとセットアップ（UNIXの場合）

インストールとセットアップ（Windowsの場合）

インストールとセットアップ（Windowsの場合）

インストールとセットアップの流れ

インストールとセットアップの流れ

インストールとセットアップの前に

インストールとセットアップの前に

インストールに必要なOSユーザー権限について

インストールに必要なOSユーザー権限について

インストールを始める前に

インストールを始める前に

(お)

応答時間に関連するレコードとフィールド

(カ行)

(か)

カーネルパラメーター

外部管理インターフェースを使用するための権限（S_XMI_PROD）

外部管理インターフェースを使用するための権限（S_XMI_PROD）

拡張パスワード

各バージョンの変更内容

稼働状況ログ

稼働性能情報

環境パラメーター設定ファイル

環境パラメーター設定ファイル

監視対象プログラム

監視対象プログラム

監視対象ホストに障害が発生した場合のフェールオーバー

(き)

起動・停止の確認

起動・停止の確認

共通メッセージログ

共通メッセージログ

共有ディスクをアンマウントする

共有ディスクをオフラインにする

共有ディスクをオンラインにする

共有ディスクをマウントする

(く)

クラスタ運用時のディスク占有量

クラスタシステムでのインストールとセットアップについて

クラスタシステムでのインストールとセットアップについて

クラスタシステムでの運用

クラスタシステムでの環境を設定する

クラスタシステムでの環境を設定する

クラスタシステムの概要

クラスタソフトの登録を解除する

クラスタソフトの登録を解除する

クラスタソフトへPFM - Agent for Enterprise Applicationsを登録する

クラスタソフトへPFM - Agent for Enterprise Applicationsを登録する

クラスタソフトへ登録する

クラスタソフトへ登録する

(こ)

コマンド一覧

コマンド共通の注意事項

コマンドの記載形式

コマンドの指定方法

コマンドの文法の説明に使用する記号

(サ行)

(し)

識別子一覧

システム管理者の方へ

システム見積もり

システムログ

システムログ情報

システムログ情報抽出機能

システムログ情報抽出機能の概要

システムログ情報の抽出

システムログの監視

実行系ノードの論理ホスト環境をアンセットアップする

実行系ノードの論理ホスト環境をアンセットアップする

実行系ノードの論理ホスト環境をセットアップする

実行系ノードの論理ホスト環境をセットアップする

障害検知

資料の採取方法

(す)

ステータス管理機能

(せ)

接続先PFM - Managerを設定する

接続先PFM - Managerを設定する

セットアップ

セットアップ

前提OS

前提OS

前提プログラム

前提プログラム

(そ)

その他のPerformance Managementのプログラムの論理ホスト環境をアンセットアップする

その他のPerformance Managementのプログラムの論理ホスト環境をアンセットアップする

その他のPerformance Managementのプログラムの論理ホスト環境をセットアップする

その他のPerformance Managementのプログラムの論理ホスト環境をセットアップする

ソリューションセット

ソリューションセット

ソリューションセット

ソリューションセットの概要

(タ行)

(た)

ダイアログの応答時間の監視

待機系ノードの論理ホスト環境をアンセットアップする

待機系ノードの論理ホスト環境をアンセットアップする

待機系の論理ホスト環境をセットアップする

待機系の論理ホスト環境をセットアップする

(て)

ディスク占有量

データ型一覧

データベース依頼時間の監視

データモデル

データモデル

データを取得できない場合のレコード生成結果

テーブルデータのバッファの監視

(と)

同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項

同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項

動作ログに出力される事象の種別

動作ログの出力

動作ログの出力形式

動作ログの保存形式

動作ログを出力するための設定

トラブルシューティング

トラブル発生時に採取が必要な資料

トラブルへの対処方法

ドリルダウンレポート（フィールドレベル）

ドリルダウンレポート（レポートレベル）

トレースログ

トレースログ

(ナ行)

(ね)

ネットワークの環境設定

ネットワークの環境設定

ネットワークの設定

ネットワークの設定

(ハ行)

(は)

バージョンアップの注意事項

バージョンアップの注意事項

バージョン互換

バインド

パスワードに指定できる文字

パスワードに指定できる文字

パフォーマンス監視の目的

パフォーマンス監視の例

パフォーマンスデータ収集の設定

パフォーマンスデータの格納先の変更

パフォーマンスデータの格納先の変更

パフォーマンスデータの格納先の変更

パフォーマンスデータの格納先の変更

パフォーマンスデータの管理方法

パフォーマンスデータの収集と管理の概要

パフォーマンスデータの収集方法

(ひ)

必要な権限

必要な権限

(ふ)

ファイアウォールの通過方向

ファイルおよびディレクトリ一覧

フィールド

フィールド

フィールドID

フィールドID

フィールドの値

フェールオーバー時の処理

プログラムのインストール順序

プログラムのインストール順序

プログラムのインストール方法

プログラムのインストール方法

プロセス一覧

プロパティ

(へ)

ベースラインの選定

(ほ)

ポート番号一覧

ポート番号の設定

ポート番号の設定

ポート番号の設定を解除する

ポート番号の設定を解除する

ポート番号を設定する

ポート番号を設定する

(マ行)

(め)

メッセージ

メッセージ一覧

メッセージの記載形式

メッセージの形式

メッセージの出力形式

メッセージの出力先一覧

メニュー情報のバッファの監視

メモリー所要量

(も)

モニター

モニター情報収集機能

モニター情報収集の概要

モニター情報収集の設定

モニター情報の収集

モニターセット

モニターセット名およびモニター名の設定

(ヤ行)

(ゆ)

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

ユーザータイプ

ユーザータイプ

(よ)

用語解説

要約ルール

(ラ行)

(り)

リアルタイムレポート

履歴レポート

(れ)

レコード

レコード

レコード

レコード一覧

レコードの記載形式

レコードの注意事項

レポート

レポート一覧

レポートの記載形式

レポートのフォルダ構成

(ろ)

ログ情報

ログのファイルサイズ変更

ログのファイルサイズ変更

ログファイルおよびディレクトリ一覧

論理ホスト環境定義ファイルを待機系ノードにコピーする

論理ホスト環境定義ファイルを待機系ノードにコピーする

論理ホスト環境定義ファイルを待機系ノードにコピーする

論理ホスト環境定義ファイルを待機系ノードにコピーする

論理ホスト環境定義をインポートする

論理ホスト環境定義をインポートする

論理ホスト環境定義をエクスポートする

論理ホスト環境定義をエクスポートする

論理ホスト環境定義をエクスポートする

論理ホスト環境定義をエクスポートする

論理ホスト環境のPFM - Agent for Enterprise Applicationsをアンセットアップする

論理ホスト環境のPFM - Agent for Enterprise Applicationsをアンセットアップする

(ワ行)

(わ)

ワイルドカード文字について

■ 商標類

ABAPは，SAP AGのドイツ及びその他の国における登録商標または商標です。
AIXは，米国における米国International Business Machines Corp.の登録商標です。
DB2は，米国における米国International Business Machines Corp.の登録商標です。
DB2 Universal Databaseは，米国における米国International Business Machines Corp.の商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IBMは，米国における米国International Business Machines Corp.の登録商標です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Lotusは，IBM Corporationの登録商標です。
Lotus Dominoは，IBM Corporationの登録商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Exchange Serverは，米国Microsoft Corp.の商品名称です。
Microsoft Internet Information Serverは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
ODBCは，米国Microsoft Corp.が提唱するデータベースアクセス機構です。
OpenViewは，ヒューレット・パッカード社の商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
R/3は，SAP AGのドイツ及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
SAPは，SAP AGのドイツ及びその他の国における登録商標または商標です。
Solarisは，米国Sun Microsystems,Inc. の米国およびその他の国における商標または登録商標です。
UNIXは，X/Open Company Limitedが独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
その他製品名などの固有名詞は各社の商品名，商標および登録商標です。
プログラムプロダクト「P-9D2C-AA81，P-9D2C-AJ81，P-9D2C-AR81，P-9D2C-AF81」には，米国Sun Microsystems, Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-AA81，P-9D2C-AJ81，P-9D2C-AR81，P-9D2C-AF81」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。