JP1 Version 8

JP1/Performance Management - Agent Option for IBM WebSphere MQ

解説・文法書

3020-3-K79-40

目　　次

前書き

変更内容

はじめに

第1編　概要編

1.　PFM - Agent for IBM WebSphere MQの概要

1.1　PFM - Agent for IBM WebSphere MQの特長

1.1.1　IBM WebSphere MQのパフォーマンスデータを収集できます

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

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

1.1.4　IBM WebSphere MQの運用上の問題点を通知できます

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

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

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

1.3　PFM - Agent for IBM WebSphere MQを使ったパフォーマンス監視の例

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

1.3.2　ベースラインの選定

1.3.3　稼働状況監視の例

1.3.4　性能情報監視の例

第2編　運用・操作編

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

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

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

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

2.1.3　インストール手順

2.1.4　PFM - Agent for IBM WebSphere MQのセットアップ手順

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

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

2.2.2　アンセットアップ手順

2.2.3　アンインストール手順

2.3　PFM - Agent for IBM WebSphere MQのシステム構成の変更

2.4　PFM - Agent for IBM WebSphere MQの運用方式の変更

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

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

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

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

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

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

3.1.3　インストール手順

3.1.4　PFM - Agent for IBM WebSphere MQのセットアップ手順

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

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

3.2.2　アンセットアップ手順

3.2.3　アンインストール手順

3.3　PFM - Agent for IBM WebSphere MQのシステム構成の変更

3.4　PFM - Agent for IBM WebSphere MQの運用方式の変更

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

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

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　アンインストールとアンセットアップの流れ

4.5.2　アンセットアップ手順

4.5.3　アンインストール手順

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

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

4.6.2　アンセットアップ手順

4.6.3　アンインストール手順

4.7　PFM - Agent for IBM WebSphere MQの運用方式の変更

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

第3編　リファレンス編

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

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

アラームの記載形式

アラーム一覧

Application Exist

Channel Event

Channel Status

Current Sys Q Depth

Current User Q Depth

Inhibit Get

Inhibit Put

Open Input Count

Open Output Count

Performance Event

Q Manager Event

Q Manager Status

Uncommitted Msgs

レポートの記載形式

レポートのディレクトリ構成

レポート一覧

Queue Activity Status

6.　レコード

データモデルについて

レコードの記載形式

ODBCキーフィールド一覧

要約ルール

データ型一覧

フィールドの値

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

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールド

レコードの注意事項

レコード一覧

Channel Status（PD_CS）

Channel Status Interval（PI_CSI）

Queue Handle Status（PD_QHS）

Queue Manager Status（PD）

Queue Manager Status Interval（PI）

Queue Status（PD_QS）

7.　メッセージ

7.1　メッセージの形式

7.1.1　メッセージの出力形式

7.1.2　メッセージの記載形式

7.1.3　システム管理者の方へ

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

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

7.4　メッセージ一覧

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

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

8.1　対処の手順

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

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

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

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

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

8.2.5　そのほかのトラブルについて

8.3　ログ情報

8.3.1　ログ情報の種類

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

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

8.4.1　Windowsの場合

8.4.2　UNIXの場合

8.5　資料の採取方法

8.5.1　Windowsの場合

8.5.2　UNIXの場合

8.6　Performance Managementの障害検知

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

付録

付録A　システム見積もり

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

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

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

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

付録C　識別子一覧

付録D　プロセス一覧

付録E　ポート番号一覧

付録E.1　PFM - Agent for IBM WebSphere MQのポート番号

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

付録F　PFM - Agent for IBM WebSphere MQのプロパティ

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

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

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

付録G.1　PFM - Agent for IBM WebSphere MQのファイルおよびディレクトリ一覧

付録G.2　メッセージカタログ格納ディレクトリ内のファイルおよびディレクトリ一覧

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

付録I　バージョン互換

付録J　動作ログの出力

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

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

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

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

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

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

付録L　用語解説

索引

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

All Rights Reserved. Copyright (C) 2007, 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-1M2C-AJ81　 JP1/Performance Management - Base　 08-50（適用OS：AIX 5.2，AIX 5.3）
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-AQ84　 JP1/Performance Management - Agent Option for IBM WebSphere MQ　 08-50（適用OS：Windows 2000，Windows Server 2003）
P-1M2C-AQ81　 JP1/Performance Management - Agent Option for IBM WebSphere MQ　 08-50（適用OS：AIX 5.2，AIX 5.3）

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

■ 輸出時の注意

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

■ 商標類

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

■ 発行

2007年 9月 (第1版) 3020-3-K79
2008年 3月 (第3版) 3020-3-K79-40

■ 著作権

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

変更内容

変更内容(3020-3-K79-40) JP1/Performance Management - Agent Option for IBM WebSphere MQ 08-50

追加・変更内容 | 変更個所
クラスタシステムに対応した。 | 1.1.6，2.1.1，2.1.3，2.1.4，2.2.3，2.4.1，3.1.1，3.1.3，3.1.4，3.2.3，3.4.1，4章，8.3.1，8.3.2，8.4，8.5.1，8.5.2，付録A.3，付録D，付録J.3，付録J.4，付録L
ソリューションセットのアラームテーブルのバージョンを8.11から8.50に変更した。 | 5章 アラーム一覧
各バージョンの変更内容を追加した。 | 付録K

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

はじめに

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

対象読者

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

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

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

また，IBM WebSphere MQについて熟知していることを前提としています。IBM WebSphere MQの対象バージョンはV6.0です。

なお，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(x86)，Windows Server 2003(x64)），Windows Server 2003(IPF)，およびAIXの各OS（Operating System）に共通のマニュアルです。OSごとに差異がある場合は，本文中でそのつど内容を書き分けています。

第1編　概要編

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

第2編　運用・操作編

JP1/Performance Management - Agent Option for IBM WebSphere MQのインストール，セットアップ，およびクラスタシステムでの運用について説明しています。

第3編　リファレンス編

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

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

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

関連マニュアル

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

JP1/Performance Management関連

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

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

JP1関連

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

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 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 IBM WebSphere MQの特長を知りたい。 | 1章
JP1/Performance Management - Agent Option for IBM WebSphere MQの機能概要を知りたい。 | 1章
JP1/Performance Management - Agent Option for IBM WebSphere MQ（Windows版）の導入時の作業を知りたい。 | 2章
JP1/Performance Management - Agent Option for IBM WebSphere MQ（UNIX版）の導入時の作業を知りたい。 | 3章
JP1/Performance Management - Agent Option for IBM WebSphere MQのクラスタシステムでの運用を知りたい。 | 4章
JP1/Performance Management - Agent Option for IBM WebSphere MQのソリューションセットについて知りたい。 | 5章
JP1/Performance Management - Agent Option for IBM WebSphere MQのレコードについて知りたい。 | 6章
JP1/Performance Management - Agent Option for IBM WebSphere MQのメッセージについて知りたい。 | 7章
障害発生時の対処方法について知りたい。 | 8章

このマニュアルでの表記

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

正式名称 | このマニュアルでの表記
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 Enterprise Applications | PFM - Agent for Enterprise Applications
JP1/Performance Management - Agent Option for HiRDB | PFM - Agent for HiRDB
JP1/Performance Management - Agent Option for IBM DB2(R) Universal Database(TM) | PFM - Agent for DB2
JP1/Performance Management - Agent Option for IBM WebSphere Application Server | PFM - Agent for IBM WebSphere Application Server
JP1/Performance Management - Agent Option for IBM WebSphere MQ | PFM - Agent for IBM WebSphere MQ
JP1/Performance Management - Agent Option for JP1/AJS2 | PFM - Agent for JP1/AJS2
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 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
AIX V6.1
HP-UX 11i V2(PA-RISC) | HP-UX(PA-RISC) | HP-UX
HP-UX 11i V2(IPF) | HP-UX(IPF)
Itanium(R) Processor Family | IPF
Internet Explorer(R) | Microsoft Internet Explorer
Microsoft(R) Cluster Server | MSCS
Microsoft(R) Cluster Service
Microsoft(R) Windows(R) 2000 Advanced Server Operating System | Windows 2000
Microsoft(R) Windows(R) 2000 Datacenter Server Operating System
Microsoft(R) Windows(R) 2000 Professional Operating System
Microsoft(R) Windows(R) 2000 Server Operating System
Microsoft(R) Windows Server(R) 2003, Datacenter Edition | Windows Server 2003(x86) | Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Enterprise Edition
Microsoft(R) Windows Server(R) 2003, Standard Edition
Microsoft(R) Windows Server(R) 2003, Datacenter x64 Edition | Windows Server 2003(x64)
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition | Windows Server 2003 R2(x86)
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition | Windows Server 2003 R2(x64)
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition
Microsoft(R) Windows Server(R) 2003, Datacenter Edition for Itanium-based Systems | Windows Server 2003(IPF)
Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium-based Systems
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)
Solaris 9 | Solaris
Solaris 10
Win32(R) | Win32

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と表記することがあります。

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

正式名称 | このマニュアルでの表記
Application Programming Interface | API
Central Processing Unit | CPU
Coordinated Universal Time | UTC
Greenwich Mean Time | GMT
Hyper Text Markup Language | HTML
Internet Control Message Protocol | ICMP
Internet Protocol | IP
Local Area Network | LAN
Message Queue Interface | MQI
MQSeries Administration Interface | MQAI
NetBIOS over TCP/IP | NBT
Network Address Translation | NAT
Network Interface Card | NIC
Open Database Connectivity | ODBC
Operating System | OS
Secure Socket Layer | SSL
Simple Network Management Protocol | SNMP
Transmission Control Protocol | TCP
Transmission Control Protocol/Internet Protocol | TCP/IP
User Datagram Protocol | UDP
Windows Internet Name Service | WINS
World Wide Web | Web

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

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

記　号
意　味

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

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

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

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

図中で使用する記号

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

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

このマニュアルでは，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¥

UNIX版Performance Managementのデフォルトのインストール先ディレクトリは，次のとおりです。

/opt/jp1pc

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

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形式のマニュアルが表示されます。

Webブラウザーでの文字の表示に関する注意事項

Windowsの場合，スタートメニューからオンラインマニュアルを表示させると，すでに表示されているブラウザーの画面上にHTMLマニュアルが表示されることがあります。

また，Microsoft Internet Explorer 5をご使用の場合，文字が不正に表示されることがあります。この場合，次のように設定してください。

［表示］－［エンコード］の［自動選択］のチェックを外す。

［表示］－［エンコード］の日本語で［日本語（シフトJIS）］を選択する。

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

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

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

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

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

1.　PFM - Agent for IBM WebSphere MQの概要

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

＜この章の構成＞

1.1　PFM - Agent for IBM WebSphere MQの特長

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

1.3　PFM - Agent for IBM WebSphere MQを使ったパフォーマンス監視の例

1.1　PFM - Agent for IBM WebSphere MQの特長

PFM - Agent for IBM WebSphere MQは，IBM WebSphere MQ V6.0のパフォーマンスを監視するために，パフォーマンスデータを収集および管理するプログラムです。

PFM - Agent for IBM WebSphere MQの特長を次に示します。

IBM WebSphere MQの稼働状況を分析できる
監視対象のIBM WebSphere MQから，現在キューに入っているメッセージの数などのパフォーマンスデータをPFM - Agent for IBM WebSphere MQで収集および集計し，その傾向や推移を図示することで，IBM WebSphere MQの稼働状況を容易に分析できます。
PFM - Agent for IBM WebSphere MQでは，IBM WebSphere MQのキューマネージャー単位にインスタンスを生成して監視します。これによって，同一ホスト上の複数のキューマネージャーを監視できます。

IBM WebSphere MQの運用上の問題点を早期に発見し，トラブルの原因を調査する資料を提供できる
監視対象のIBM WebSphere MQでキューに入っているメッセージが滞留するなどのトラブルが発生した場合，Eメールなどを使ってユーザーに通知することで，問題点を早期に発見できます。また，その問題点に関連する情報を図示することで，トラブルの原因を調査する資料を提供できます。

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

PFM - Agent for IBM WebSphere MQについて次に説明します。

＜この節の構成＞

1.1.1　IBM WebSphere MQのパフォーマンスデータを収集できます

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

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

1.1.4　IBM WebSphere MQの運用上の問題点を通知できます

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

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

1.1.1　IBM WebSphere MQのパフォーマンスデータを収集できます

PFM - Agent for IBM WebSphere MQを使用すると，対象ホスト上で動作しているIBM WebSphere MQの統計情報など，パフォーマンスデータが収集できます。PFM - Agent for IBM WebSphere MQでは，パフォーマンスデータを次のように利用できます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1.1.4　IBM WebSphere MQの運用上の問題点を通知できます

PFM - Agent for IBM WebSphere MQで収集したパフォーマンスデータは，IBM WebSphere MQのパフォーマンスをレポートとして表示するときに利用するだけでなく，IBM WebSphere MQのパフォーマンスを判断基準として，運用上の問題が起こったり，障害が発生したりしてユーザーに警告するときにも利用します。

例えば，現在メッセージキューの使用率が90%を上回った場合，ユーザーにEメールで通知するとします。このように運用するために，「現在メッセージキューの使用率が90%を上回る」を異常条件のしきい値として，そのしきい値に達した場合，Eメールをユーザーに送信するように設定します。しきい値に達した場合に取る動作を「アクション」と呼びます。アクションには，次の種類があります。

Eメールの送信

コマンドの実行

SNMPトラップの発行

JP1イベントの発行

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

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

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

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

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

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

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

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

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

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

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

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

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

PIレコードタイプ

PDレコードタイプ

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

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

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

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

1.3　PFM - Agent for IBM WebSphere MQを使ったパフォーマンス監視の例

システムを安定稼働させるためには，パフォーマンスを監視してシステムの状態を把握することが重要です。ここでは，PFM - Agent for IBM WebSphere MQを用いたパフォーマンス監視の目的，およびパフォーマンスの監視例を紹介します。

＜この節の構成＞

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

1.3.2　ベースラインの選定

1.3.3　稼働状況監視の例

1.3.4　性能情報監視の例

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

PFM - Agent for IBM WebSphere MQを用いたパフォーマンス監視は，主に次の目的で使用できます。

システムが正常に運用されているかどうかを監視する稼働状況監視

システムが十分なサービスを提供しているかどうかを監視する性能情報監視

システムを運用する場合，システムを構成する要素が正しく稼働しているかを確認することは大変重要なことです。システムが正しく稼働しているかを確認するため，次の要素を監視します。

必要なアプリケーションが動作しているか

アプリケーションがメッセージを書き込めるか，または読み込めるか

チャネルの状況

キューマネージャーの状況

システムを運用する場合，システムが十分な性能のサービスを提供しているかどうかを確認することは大変重要なことです。システムのサービスを確認するため，次の要素を監視します。

メッセージキューに入っているメッセージの使用率

メッセージキューにアクセスしているアプリケーションの数

イベントが発生しているか

未コミットメッセージが発生しているか

このように，システムを安定稼働させるには，PFM - Agent for IBM WebSphere MQを用いて正しくパフォーマンスを監視することが重要です。

ここでは，PFM - Agent for IBM WebSphere MQを用いてパフォーマンスを監視し，システムを安定稼働させる方法について紹介します。

パフォーマンスの監視方法について，例を挙げて紹介しますが，しきい値はあくまで参考値です。具体的なしきい値については，ベースラインを測定し決定してください。また，具体的な設定項目については，システムの運用形態に合わせて，検討してください。

1.3.2　ベースラインの選定

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

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

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

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

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

1.3.3　稼働状況監視の例

ここでは，稼働状況監視の設定例を紹介します。

＜この項の構成＞

(1)　必要なアプリケーションが動作しているか

(2)　アプリケーションがメッセージを書き込めるか，または読み込めるか

(3)　チャネルの状況

(4)　キューマネージャーの状況

(1)　必要なアプリケーションが動作しているか

必要なアプリケーションが正常に動作しているかを監視するレコードとフィールド，および異常時の対処方法を次に示します。特定のアプリケーションを監視する場合，"*"を監視するアプリケーション名に変更してください。

Windowsの場合，アプリケーション名は，対象アプリケーションの実行ファイル名を絶対パスで指定してください。ただし，絶対パスが28バイトを超える場合，後ろの28バイトを指定してください。

例えば，「C:¥Program Files¥IBM¥Eclipse SDK30¥eclipse¥jre¥bin¥javaw.exe」の場合には，「30¥eclipse¥jre¥bin¥javaw.exe」を指定してください。

UNIXの場合，アプリケーション名は，対象アプリケーションの実行ファイル名を指定してください。ディレクトリパスは指定しないでください。ただし，実行ファイル名が27バイトを超える場合，後ろの27バイトを指定してください。

表1-1　アプリケーションの動作を監視する設定例

使用レコード | 使用フィールド | 異常条件 | 値
PD_QHS | Appl Tag | 値の存在を監視する | "*"

対処方法

指定したアプリケーションがキューに接続していないため，アプリケーションが正しく稼働しているか確認してください。

(2)　アプリケーションがメッセージを書き込めるか，または読み込めるか

アプリケーションがメッセージをキューに書き込む権限を持っているか，またはメッセージをキューから読み込む権限を持っているかを監視するレコードとフィールド，および異常時の対処方法を次に示します。特定のキューを監視する場合，"*"を監視するキュー名に変更してください。

表1-2　アプリケーションの書き込み権限，読み込み権限を監視する設定例

使用レコード
権限
使用フィールド
警告条件
異常条件

PD_QS
書き込み
Q Name，
Inhibit Put
Q Name = "*" AND
Inhibit Put =
"MQQA_PUT_INHIBITED"
Q Name = "*" AND
Inhibit Put =
"MQQA_PUT_INHIBITED"

読み込み
Q Name，
Inhibit Get
Q Name = "*" AND
Inhibit Get =
"MQQA_GET_INHIBITED"
Q Name = "*" AND
Inhibit Get =
"MQQA_GET_INHIBITED"

対処方法

メッセージキューにメッセージの書き込み権限または読み込み権限が付与されていません。IBM WebSphere MQで，メッセージキューへのメッセージの書き込み権限または読み込み権限を確認し，書き込み権限または読み込み権限を許可してください。詳細については，IBM WebSphere MQのエクスプローラー・ヘルプを参照してください。

(3)　チャネルの状況

チャネルの状況を監視するレコードとフィールド，および異常時の対処方法を次に示します。特定のチャネルの状況を監視する場合，"*"を監視するチャネル名に変更してください。

表1-3　チャネルの状況を監視する設定例

使用レコード
使用フィールド
警告条件
異常条件

PD_CS
Channel Name , Channel Status
Channel Name = "*" AND
Channel Status <>
"MQCHS_BINDING"
AND
Channel Status <>
"MQCHS_STARTING"
AND
Channel Status <>
"MQCHS_RUNNING"
AND
Channel Status <>
"MQCHS_REQUESTING"
Channel Name = "*" AND
Channel Status <>
"MQCHS_BINDING"
AND
Channel Status <>
"MQCHS_STARTING"
AND
Channel Status <>
"MQCHS_RUNNING"
AND
Channel Status <>
"MQCHS_REQUESTING"

対処方法

チャネルが正常に稼働していません。IBM WebSphere MQで，チャネルの状況を確認し，再稼働してください。詳細については，IBM WebSphere MQのエクスプローラー・ヘルプを参照してください。

(4)　キューマネージャーの状況

キューマネージャーの状況を監視するレコードとフィールド，および異常時の対処方法を次に示します。

表1-4　キューマネージャーの状況を監視する設定例

使用レコード
使用フィールド
警告条件
異常条件

PD
Q Mgr Status
Q Mgr Status <>
"MQQMSTA_RUNNING"
Q Mgr Status <>
"MQQMSTA_RUNNING"

対処方法

キューマネージャーが正常に稼働していません。IBM WebSphere MQで，キューマネージャーの状況を確認し，再稼働してください。詳細については，IBM WebSphere MQのエクスプローラー・ヘルプを参照してください。

1.3.4　性能情報監視の例

ここでは，性能情報監視の設定例を紹介します。

＜この項の構成＞

(1)　メッセージキューに入っているメッセージの使用率

(2)　メッセージキューにアクセスしているアプリケーションの数

(3)　イベントが発生しているか

(4)　未コミットメッセージが発生しているか

(1)　メッセージキューに入っているメッセージの使用率

現在ユーザーキューに入っているメッセージの最大数に対するユーザーキューの使用率とシステムキューに入っているメッセージの最大数に対するシステムキューの使用率を監視するレコードとフィールド，および異常時の対処方法を次に示します。特定のキューの使用率を監視する場合，"SYSTEM.*"を監視するキュー名に変更してください。

表1-5　メッセージキューに入っているメッセージの使用率を監視する設定例

使用レコード
キューの種類
使用フィールド
警告条件
異常条件

PD_QS
ユーザーキュー
Q Name，
Q Depth %
Q Name <> "SYSTEM.*"
AND
Q Depth % > 10
Q Name <> "SYSTEM.*"
AND
Q Depth % > 90

システムキュー
Q Name，
Q Depth %
Q Name = "SYSTEM.*"
AND
Q Depth % > 10
Q Name = "SYSTEM.*"
AND
Q Depth % > 90

しきい値に対する考え方

メッセージキューの運用に十分な割合を考慮して選定してください。

対処方法

メッセージキューに大量のメッセージが入っています。メッセージを処理する必要があるアプリケーションが処理をしていない，不正に大量のメッセージが送られているなどの問題が発生している可能性があります。正しくシステムが稼働しているか確認してください。正しくシステムが稼働している場合，メッセージの最大値が妥当であるか見直してください。詳細については，IBM WebSphere MQのエクスプローラー・ヘルプを参照してください。

(2)　メッセージキューにアクセスしているアプリケーションの数

現在キューからメッセージを入力するためにキューにアクセスしているアプリケーションの数と，キューへメッセージを出力するためにキューにアクセスしているアプリケーションの数を監視するレコードとフィールド，および異常時の対処方法を次に示します。

表1-6　メッセージキューにアクセスしているアプリケーションの数を監視する設定例

使用レコード | 権限 | 使用フィールド | 警告条件 | 異常条件
PD_QS | 書き込み | Open Input Count | Open Input Count > 10 | Open Input Count > 20
読み込み | Open Output Count | Open Output Count > 10 | Open Output Count > 20

しきい値に対する考え方

システムで同時にキューに接続するアプリケーションの数を指定してください。

対処方法

メッセージを入力するまたは出力するためにキューにアクセスしているアプリケーションの数が，しきい値より多くなっています。IBM WebSphere MQで，メッセージを入力するまたは出力するためにキューに接続しているアプリケーションの数を確認し，不当にメッセージキューにアクセスしているアプリケーションが存在していないか確認してください。メッセージキューにアクセスしているアプリケーションは，PD_QHSレコードで確認してください。

また，特定のキューについて監視する場合は，Q Nameフィールドで絞り込んでください。

(3)　イベントが発生しているか

チャネルイベントが発生したか，パフォーマンスイベントが発生したか，キューマネージャーイベントが発生したかを監視するレコードとフィールド，および異常時の対処方法を次に示します。

表1-7　イベントが発生しているかを監視する設定例

使用レコード
イベントの種類
使用フィールド
警告条件
異常条件

PD_QS
チャネルイベント
Current Q Depth，
Q Name
Q Name =
"SYSTEM.ADMIN.CHANNEL.EVENT"
AND
Current Q Depth > 0
Q Name =
"SYSTEM.ADMIN.CHANNEL.EVENT"
AND
Current Q Depth > 0

パフォーマンスイベント
Current Q Depth，
Q Name
Q Name =
"SYSTEM.ADMIN.PERFM.EVENT"
AND
Current Q Depth > 0
Q Name =
"SYSTEM.ADMIN.PERFM.EVENT"
AND
Current Q Depth > 0

キューマネージャーイベント
Current Q Depth，
Q Name
Q Name =
"SYSTEM.ADMIN.QMGR.EVENT"
AND
Current Q Depth > 0
Q Name =
"SYSTEM.ADMIN.QMGR.EVENT"
AND
Current Q Depth > 0

しきい値に対する考え方

イベントの存在を確認する場合には，0で判定してください。ある一定の範囲を許容できる場合には，その値を指定してください。

対処方法

各種イベントの発生に伴い，メッセージが生成されています。メッセージを確認してください。詳細については，IBM WebSphere MQのエクスプローラー・ヘルプを参照してください。

(4)　未コミットメッセージが発生しているか

未コミットメッセージが発生しているかを監視するレコードとフィールド，および異常時の対処方法を次に示します。特定のキューの未コミットメッセージを監視する場合，"*"を監視するキュー名に変更してください。

表1-8　未コミットメッセージが発生しているかを監視する設定例

使用レコード
使用フィールド
警告条件
異常条件

PD_QS
Q Name，
Uncommitted Msgs
Q Name = "*" AND
Uncommitted Msgs =
"MQQSUM_YES"
Q Name = "*" AND
Uncommitted Msgs =
"MQQSUM_YES"

対処方法

コミットされていないメッセージが発生しています。IBM WebSphere MQで，コミットされていないメッセージの有無を確認し，メッセージをコミットしてください。詳細については，IBM WebSphere MQのエクスプローラー・ヘルプを参照してください。

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

この章では，PFM - Agent for IBM WebSphere MQのインストールおよびセットアップ方法について説明します。Performance Managementシステム全体のインストールおよびセットアップ方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この章の構成＞

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

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

2.3　PFM - Agent for IBM WebSphere MQのシステム構成の変更

2.4　PFM - Agent for IBM WebSphere MQの運用方式の変更

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

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

＜この節の構成＞

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

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

2.1.3　インストール手順

2.1.4　PFM - Agent for IBM WebSphere MQのセットアップ手順

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

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

＜この項の構成＞

(1)　前提OS

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

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

(4)　前提プログラム

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

(6)　注意事項

(1)　前提OS

PFM - Agent for IBM WebSphere MQが動作するOSを次に示します。

Windows 2000

Windows Server 2003

注意

Windows Server 2003 R2(x86)およびWindows Server 2003 R2(x64)では，Service Pack 1以降の適用が前提になります。

(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コマンド，UNIXの場合はuname -nコマンドで確認できるホスト名には，ドメイン名を除いたものを使用してください。

Performance Managementは，DHCPによる動的なIPアドレスが割り振られているホスト上で運用できません。Performance Managementを導入するすべてのホストに，固定のIPアドレスを設定する必要があります。

複数の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 IBM WebSphere MQをインストールするときは，必ず，Administrators権限を持つアカウントで実行してください。

(4)　前提プログラム

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

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

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

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

IBM WebSphere MQ V6.0

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

(b)　Performance Managementプログラム

監視マネージャーと監視エージェントを別々のホストにインストールする場合

監視マネージャーにインストールするPFM - Managerのバージョンは，08-10以降にしてください。監視エージェントには，PFM - AgentとPFM - Baseをインストールします。PFM - BaseはPFM - Agentの前提プログラムです。PFM - BaseとPFM - Agentのバージョンは，ともに08-11以降にしてください。同一ホストに複数のPFM - Agentをインストールする場合でも，PFM - Baseは一つだけでかまいません。

監視マネージャーと監視エージェントを同一ホストにインストールする場合

インストールするPFM - ManagerとPFM - Agentのバージョンは，ともに08-11以降にしてください。この場合，PFM - Baseは不要です。

監視コンソールサーバ

監視コンソールサーバには，PFM - Web Console（08-00以降），またはPFM - View（07-00以降）が必要です。

(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からバージョンアップする場合の注意事項を次に示します。

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の順でインストールしてください。

(c)　そのほかの注意事項

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

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

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

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

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

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

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

2.1.3　インストール手順

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

＜この項の構成＞

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

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

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

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

なお，PFM - Managerと同一ホストにPFM - Agentをインストールする場合は，PFM - Manager，PFM - Agentの順でインストールしてください。

同一ホストに複数の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 システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

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

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

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

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

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

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

プログラムフォルダ
Windowsの［スタート］－［すべてのプログラム］メニューに登録されるプログラムメニュー名を指定します。
デフォルトでは，［Performance Management］が登録されます。

参考

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

2.1.4　PFM - Agent for IBM WebSphere MQのセットアップ手順

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

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

＜この項の構成＞

(1)　PFM - Agent for IBM WebSphere MQの登録

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

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

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

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

(6)　PFM - Agent for IBM WebSphere MQの接続先PFM - Managerの設定

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

(1)　PFM - Agent for IBM WebSphere MQの登録

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

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

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

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

注意

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

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

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

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

PFM - Agent for IBM WebSphere MQの情報を登録する作業では，PFM - Web Consoleの［レポート階層］タブおよび［アラーム階層］タブに「IBMWebSphereMQ」という名前のフォルダが作成されます。［レポート階層］タブで，すでに独自に「IBMWebSphereMQ」という名前のフォルダまたはファイルを作成していた場合には，名前を変更してから作業を始めてください。

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

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

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

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

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

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

PFMプログラム名
OS
コピー先フォルダ

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

UNIX
/opt/jp1pc/setup/

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

UNIX
/opt/jp1pcwebcon/setup/

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

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

jpcagtsetup agt9

注意

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

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

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

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

jpcwagtsetup

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

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

インスタンス環境の設定では，インスタンス情報を設定します。複数のインスタンス環境を設定する場合は，繰り返し実施します。

PFM - Agent for IBM WebSphere MQのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に，次の情報をあらかじめ確認してください。

表2-3　PFM - Agent for IBM WebSphere MQのインスタンス情報

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

QManager_Name
監視対象となるIBM WebSphere MQのキューマネージャー名
48バイト以内の半角文字列
指定できる文字

アルファベット
[a-z] [A-Z]

数字
[0-9]

次の記号
「.」「/」「_」「%」

jpcinssetupコマンドの-instオプションで指定した値

log_size
エージェントログの1ファイルの最大サイズ※1
1～32（単位：メガバイト）
ただし，推奨は16以上
16

Store Version
使用するStoreバージョンを指定する※2
｛1.0｜2.0｝
2.0

注※1

エージェントログは，1インスタンスにつき最大4ファイルが採取されます。log_sizeの値は，次の条件を満たすことを確認して指定してください。

log_pathに指定したドライブの空き容量（MB） ＞ log_sizeの値×4

注※2

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

ハードディスクに十分な空き容量がない場合，エージェントログが出力エラーとなります。エージェントログについては，「8.3　ログ情報」を参照してください。

注意

インスタンス情報で指定するキューマネージャー名(QManager_Name)に，IBM WebSphere MQ上に存在しない名称を指定した場合でも，インスタンス環境の生成コマンドは正常に終了します。しかし，そのインスタンス環境で，レコードの収集を開始すると，パフォーマンスデータが収集されません。この場合の対策については，「8.2.4　パフォーマンスデータの収集と管理について」の「(3)　PFM - Agentを起動してもパフォーマンスデータが収集されない」を参照してください。

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

jpcinssetupコマンドを実行する。
PFM - Agent for IBM WebSphere MQでは，インスタンス名として監視対象のキューマネージャー名を指定することを推奨します。例えば，キューマネージャー名がMQinstであるインスタンス環境を構築する場合，次のように指定してコマンドを実行します。

jpcinssetup agt9 -inst MQinst

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

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

すべての入力が終了すると，インスタンス環境が構築されます。構築時に入力したインスタンス情報を変更したい場合は，再度jpcinssetupコマンドを実行し，インスタンス環境を更新してください。インスタンス環境の更新については，「2.4.2　インスタンス環境の更新の設定」を参照してください。

構築されるインスタンス環境を次に示します。

インスタンス環境のフォルダ構成
次のフォルダ下にインスタンス環境が構築されます。
物理ホストの場合：インストール先フォルダ¥agt9
論理ホストの場合：環境フォルダ※¥jp1pc¥agt9

注※

環境フォルダとは，論理ホスト作成時に指定した共有ディスク上のフォルダです。

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

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

フォルダ名，ファイル名 | 説明
agent | インスタンス名 | jpcagt.ini | Agent Collectorサービス起動情報ファイル
jpcagt.ini.model※ | Agent Collectorサービス起動情報ファイルのモデルファイル
log | ログファイル格納フォルダ
store | インスタンス名 | jpcsto.ini | Agent Storeサービス起動情報ファイル
jpcsto.ini.model※ | Agent Storeサービス起動情報ファイルのモデルファイル
*.DAT | データモデル定義ファイル
dump | エクスポート先フォルダ
backup | バックアップ先フォルダ
partial | 部分バックアップ用フォルダ
import | インポート用フォルダ
log | ログファイル格納フォルダ

注※

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

インスタンス環境のサービスID
インスタンス環境のサービスIDは次のようになります。
プロダクトID 機能ID インスタンス番号 インスタンス名 [ホスト名]
PFM - Agent for IBM WebSphere MQの場合，インスタンス名にはjpcinssetupコマンドで指定したインスタンス名が表示されます。サービスIDについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されている命名規則を参照してください。

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

Agent Collectorサービス：PFM - Agent for IBMWebSphereMQインスタンス名[論理ホスト名]

Agent Storeサービス：PFM - Agent Store for IBMWebSphereMQインスタンス名[論理ホスト名]
Windowsのサービス名については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されている命名規則を参照してください。
また，論理ホストで運用する場合のWindowsのサービス名については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

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

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

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

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

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

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

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

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

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

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

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

保存先：インストール先フォルダ¥agt9¥store¥インスタンス名¥

バックアップ先：インストール先フォルダ¥agt9¥store¥インスタンス名¥backup¥

部分バックアップ先：インストールフォルダ¥agt9¥store¥インスタンス名¥partial¥

エクスポート先：インストール先フォルダ¥agt9¥store¥インスタンス名¥dump¥

インポート先：インストールフォルダ¥agt9¥store¥インスタンス名¥import¥

注意

論理ホストで運用する場合のデフォルトの保存先については，「インストール先フォルダ」を「環境フォルダ¥jp1pc」に読み替えてください。

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

(6)　PFM - Agent for IBM WebSphere MQの接続先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 システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
jpcnshostnameコマンド実行時に，Performance Managementのプログラムおよびサービスが起動されている場合は，停止を問い合わせるメッセージが表示されます。

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

jpcnshostname -s host01

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

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

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

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

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

＜この節の構成＞

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

2.2.2　アンセットアップ手順

2.2.3　アンインストール手順

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

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

＜この項の構成＞

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

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

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

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

(5)　そのほかの注意事項

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

PFM - Agent for IBM WebSphere MQをアンインストールするときは，必ず，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コマンドで表示できるサービスの情報は削除されません。この場合，jpcctrl deleteコマンドを使用してサービスの情報を削除してください。

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

(5)　そのほかの注意事項

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

アンインストールを実行する前にjpcinssetupコマンドまたはPFM - Web Consoleで，エージェントログの出力先フォルダを確認してください。エージェントログの出力先をデフォルト値（インストール先フォルダ¥agt9¥store¥インスタンス名¥log¥）以外に設定している場合，アンインストールしてもエージェントログファイルは削除されません。この場合，アンインストール実行後にエージェントログファイルを手動で削除する必要があります。

2.2.2　アンセットアップ手順

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

＜この項の構成＞

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

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

インスタンス環境をアンセットアップするには，まずインスタンス名を確認し，インスタンス環境を削除します。インスタンス環境の削除は，PFM - Agentホストで実施します。インスタンス名を確認するには，jpcinslistコマンドを使用します。また，構築したインスタンス環境を削除するには，jpcinsunsetupコマンドを使用します。

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

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

jpcinslist agt9

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

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

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

jpcinsunsetup agt9 -inst MQinst

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

注意

インスタンス環境をアンセットアップしても，jpcctrl listコマンドで表示できるサービスの情報は削除されません。この場合，jpcctrl deleteコマンドを使用してサービスの情報を削除してください。次に指定例を示します。

インスタンス名：MQinst

ホスト名：host03

Agent CollectorサービスのサービスID：9A1MQinst[host03]

Agent StoreサービスのサービスID：9S1MQinst[host03]
jpcctrl delete 9?1MQinst[host03] host=host03

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

2.2.3　アンインストール手順

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

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

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

アンインストールするPerformance Managementプログラムを選択する。
Windowsの［コントロールパネル］で［プログラムの追加と削除］を選択して，アンインストールするPerformance Managementプログラムを選択します。

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

2.3　PFM - Agent for IBM WebSphere MQのシステム構成の変更

監視対象システムのネットワーク構成の変更や，ホスト名の変更などに応じて，PFM - Agent for IBM WebSphere MQのシステム構成を変更する場合があります。

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

注意

インストール先のホスト名を変更すると，変更前に収集したパフォーマンスデータは参照できなくなります。

2.4　PFM - Agent for IBM WebSphere MQの運用方式の変更

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

＜この節の構成＞

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

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

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

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

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

保存先フォルダ

バックアップ先フォルダ

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

エクスポート先フォルダ

インポート先フォルダ※

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

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

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

説明
オプション名
設定できる値（Storeバージョン1.0）※1
設定できる値（Storeバージョン2.0）※1
デフォルト値
※2

パフォーマンスデータの作成先フォルダ
sd
1～127バイトのパス名
1～214バイトのパス名
インストール先フォルダ¥agt9¥store¥インスタンス名

パフォーマンスデータのバックアップ先フォルダ
bd
1～127バイトのパス名
1～211バイトのパス名
インストール先フォルダ¥agt9¥store¥インスタンス名¥backup

パフォーマンスデータの部分バックアップ先フォルダ
pb
－
1～214バイトのパス名
インストール先フォルダ¥agt9¥store¥インスタンス名¥partial

パフォーマンスデータを退避する場合の最大世代番号
bs
1～9
1～9
Storeバージョン1.0の場合5
Storeバージョン2.0の場合001

パフォーマンスデータのエクスポート先フォルダ
pbd
1～127バイトのパス名
1～127バイトのパス名
インストール先フォルダ¥agt9¥store¥インスタンス名¥dump

パフォーマンスデータのインポート先フォルダ
id
－
1～222バイトのパス名
インストール先フォルダ¥agt9¥store¥インスタンス名¥import

（凡例）

－：設定できません。

注※1

フォルダ名は，Storeデータベースのデフォルト格納先フォルダ（インストール先フォルダ¥agt9¥store）からの相対パスか，または絶対パスで指定してください。

注※2

論理ホストで運用する場合のデフォルト値については，「インストール先フォルダ」を「環境フォルダ¥jp1pc」に読み替えてください。

なお，Storeバージョン1.0使用時は，jpcsto.iniファイルを直接編集して変更できます。jpcsto.iniファイルを編集する方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

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

インスタンス環境を更新したい場合は，インスタンス名を確認し，インスタンス情報を更新します。インスタンス情報の設定は，PFM - Agentホストで実施します。

更新する情報は，次の表であらかじめ確認してください。

表2-6　PFM - Agent for IBM WebSphere MQのインスタンス情報

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

QManager_Name
監視対象となるIBM WebSphere MQのキューマネージャー名
この値は更新できる
48バイト以内の半角文字列
指定できる文字

アルファベット
[a-z] [A-Z]

数字
[0-9]

次の記号
「.」「/」「_」「%」

前回の設定値

log_size
エージェントログの1ファイルの最大サイズ
この値は更新できる
1～32（単位：メガバイト）
ただし，推奨は16以上
前回の設定値

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

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

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

jpcinslist agt9

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

更新したいインスタンス環境のPFM - Agent for IBM WebSphere MQのサービスが起動されている場合は停止する。
サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
jpcinssetupコマンド実行時に，更新したいインスタンス環境のサービスが起動されている場合は，確認メッセージが表示され，サービスを停止できます。サービスを停止した場合は，更新処理が続行されます。サービスを停止しなかった場合は，更新処理が中断されます。

PFM - Agent for IBM WebSphere MQを示すサービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
インスタンス名がMQinstのインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

jpcinssetup agt9 -inst MQinst

PFM - Agent for IBM WebSphere MQのインスタンス情報を更新する。
表2-6に示した項目を，コマンドの指示に従って入力します。現在設定されている値が表示されます。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

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

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

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

この章では，PFM - Agent for IBM WebSphere MQのインストールおよびセットアップ方法について説明します。Performance Managementシステム全体のインストールおよびセットアップ方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

また，表記上UNIXとしていますが，PFM - Agent for IBM WebSphere MQが動作するUNIXはAIXだけです。

＜この章の構成＞

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

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

3.3　PFM - Agent for IBM WebSphere MQのシステム構成の変更

3.4　PFM - Agent for IBM WebSphere MQの運用方式の変更

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

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

＜この節の構成＞

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

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

3.1.3　インストール手順

3.1.4　PFM - Agent for IBM WebSphere MQのセットアップ手順

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

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

＜この項の構成＞

(1)　前提OS

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

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

(4)　前提プログラム

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

(6)　注意事項

(1)　前提OS

PFM - Agent for IBM WebSphere MQが動作するOSを次に示します。

AIX 5.2/5.3

(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）形式のホスト名には対応していません。Windowsの場合はhostnameコマンド，UNIXの場合はuname -nコマンドで確認できるホスト名には，ドメイン名を除いたものを使用してください。

Performance Managementは，DHCPによる動的なIPアドレスが割り振られているホスト上で運用できません。Performance Managementを導入するすべてのホストに，固定のIPアドレスを設定する必要があります。

複数の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 IBM WebSphere MQをインストールするときは，必ず，スーパーユーザー権限(*)を持つアカウントで実行してください。

注意

*:mqmグループに属する必要があります。

(4)　前提プログラム

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

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

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

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

IBM WebSphere MQ V6.0

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

(b)　Performance Managementプログラム

監視マネージャーと監視エージェントを別々のホストにインストールする場合

監視マネージャーにインストールするPFM - Managerのバージョンは，08-10以降にしてください。監視エージェントには，PFM - AgentとPFM - Baseをインストールします。PFM - BaseはPFM - Agentの前提プログラムです。PFM - BaseとPFM - Agentのバージョンは，ともに08-11以降にしてください。同一ホストに複数のPFM - Agentをインストールする場合でも，PFM - Baseは一つだけでかまいません。

監視マネージャーと監視エージェントを同一ホストにインストールする場合

インストールするPFM - ManagerとPFM - Agentのバージョンは，ともに08-11以降にしてください。この場合，PFM - Baseは不要です。

監視コンソールサーバ

監視コンソールサーバには，PFM - Web Console（08-00以降），またはPFM - View（07-00以降）が必要です。

(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からバージョンアップする場合の注意事項を次に示します。

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の順でインストールしてください。

(c)　そのほかの注意事項

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

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

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

/opt/jp1pc/setupディレクトリにPFM - Agent for IBM WebSphere MQのセットアップファイルがある場合，新規PFM - Agent for IBM WebSphere MQの追加セットアップが実行されます。PFM - Agent for IBM WebSphere MQの追加セットアップが成功した場合の実行結果は共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されます。確認してください。

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

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

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

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

3.1.3　インストール手順

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

＜この項の構成＞

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

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

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

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

なお，PFM - Managerと同一ホストにPFM - Agentをインストールする場合は，PFM - Manager，PFM - Agentの順でインストールしてください。

同一ホストに複数の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 システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

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

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 IBM WebSphere MQのセットアップ手順

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

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

＜この項の構成＞

(1)　LANG環境変数の設定

(2)　PFM - Agent for IBM WebSphere MQの登録

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

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

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

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

(7)　PFM - Agent for IBM WebSphere MQの接続先PFM - Managerの設定

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

(9)　そのほかの注意事項

(1)　LANG環境変数の設定

PFM - Agent for IBM WebSphere MQで使用できるLANG環境変数を次の表に示します。

なお，これらのLANG環境変数を設定する前に，設定する言語環境が正しくインストール・構築されていることを確認しておいてください。正しくインストール・構築されていない場合，文字化けが発生したり，定義データが不当に書き換わってしまったりすることがあります。

注意

共通メッセージログの言語は，サービス起動時やコマンド実行時に設定されているLANG環境変数によって決まります。そのため，日本語や英語など，複数の言語コードの文字列が混在することがあります。

LANG環境変数は，次の表以外の設定がされている場合，Cで動作します。

表3-2　PFM - Agent for IBM WebSphere MQで使用できるLANG環境変数

言語種別
LANG環境変数の値

日本語
Shift-JISコード

Ja_JP

Ja_JP.IBM-932

EUCコード

ja_JP

ja_JP.IBM-eucJP

英語（日本語なし）

C

(2)　PFM - Agent for IBM WebSphere MQの登録

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

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

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

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

注意

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

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

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

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

PFM - Agent for IBM WebSphere MQの情報を登録する作業では，PFM - Web Consoleの［レポート階層］タブおよび［アラーム階層］タブに「IBMWebSphereMQ」という名前のディレクトリが作成されます。［レポート階層］タブで，すでに独自に「IBMWebSphereMQ」という名前のディレクトリまたはファイルを作成していた場合には，名前を変更してから作業を始めてください。

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

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

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

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

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

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

PFMプログラム名
OS
コピー先ディレクトリ

/opt/jp1pc/setup/jpcagt9w.EXE
/opt/jp1pc/setup/jpcagt9u.Z
PFM - Manager
Windows
PFM - Managerのインストール先フォルダ¥setup¥

UNIX
/opt/jp1pc/setup/

/opt/jp1pc/setup/jpcagt9w.EXE
/opt/jp1pc/setup/jpcagt9u.Z
PFM - Web Console
Windows
PFM - Web Consoleのインストール先フォルダ¥setup¥

UNIX
/opt/jp1pcwebcon/setup/

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

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

jpcagtsetup agt9

注意

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

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

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

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

jpcwagtsetup

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

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

インスタンス環境の設定では，インスタンス情報を設定します。複数のインスタンス環境を設定する場合は，繰り返し実施します。

PFM - Agent for IBM WebSphere MQのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に，次の情報をあらかじめ確認してください。

表3-4　PFM - Agent for IBM WebSphere MQのインスタンス情報

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

QManager_Name
監視対象となるIBM WebSphere MQのキューマネージャー名
48バイト以内の半角文字列
指定できる文字

アルファベット
[a-z] [A-Z]

数字
[0-9]

次の記号
「.」「/」「_」「%」

jpcinssetupコマンドの-instオプションで指定した値

log_size
エージェントログの1ファイルの最大サイズ※1
1～32（単位：メガバイト）
ただし，推奨は16以上
16

Store Version
使用するStoreバージョンを指定する※2
｛1.0｜2.0｝
2.0

注※1

エージェントログは，1インスタンスにつき最大4ファイルが採取されます。log_sizeの値は，次の条件を満たすことを確認して指定してください。

log_pathに指定したドライブの空き容量（MB） ＞ log_sizeの値×4

注※2

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

ハードディスクに十分な空き容量がない場合，エージェントログが出力エラーとなります。エージェントログについては，「8.3　ログ情報」を参照してください。

注意

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

インスタンス情報で指定するキューマネージャー名(QManager_Name)に，IBM WebSphere MQ上に存在しない名称を指定した場合でも，インスタンス環境の生成コマンドは正常に終了します。しかし，そのインスタンス環境で，レコードの収集を開始すると，パフォーマンスデータが収集されません。この場合の対策については，「8.2.4　パフォーマンスデータの収集と管理について」の「(3)　PFM - Agentを起動してもパフォーマンスデータが収集されない」を参照してください。

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

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

jpcinssetup agt9 -inst SDC

なお，インスタンス名に「sql」という名称は使用できません。
jpcinssetupコマンドの詳細については，マニュアル「JP1/Performance Managementリファレンス」の，コマンドについて説明している章を参照してください。

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

すべての入力が終了すると，インスタンス環境が構築されます。構築時に入力したインスタンス情報を変更したい場合は，再度jpcinssetupコマンドを実行し，インスタンス環境を更新してください。インスタンス環境の更新については，「3.4.2　インスタンス環境の更新の設定」を参照してください。

構築されるインスタンス環境を次に示します。

インスタンス環境のディレクトリ構成
次のディレクトリ下にインスタンス環境が構築されます。
物理ホストの場合：/opt/jp1pc/agt9
論理ホストの場合：環境ディレクトリ※/jp1pc/agt9

注※

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

構築されるインスタンス環境のディレクトリ構成を次に示します。

表3-5　インスタンス環境のディレクトリ構成

ディレクトリ名，ファイル名 | 説明
agent | インスタンス名 | jpcagt.ini | Agent Collectorサービス起動情報ファイル
jpcagt.ini.model※ | Agent Collectorサービス起動情報ファイルのモデルファイル
log | ログファイル格納ディレクトリ
store | インスタンス名 | jpcsto.ini | Agent Storeサービス起動情報ファイル
jpcsto.ini.model※ | Agent Storeサービス起動情報ファイルのモデルファイル
*.DAT | データモデル定義ファイル
dump | エクスポート先ディレクトリ
backup | バックアップ先ディレクトリ
partial | 部分バックアップ用ディレクトリ
import | インポート用ディレクトリ
log | ログファイル格納ディレクトリ

注※

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

インスタンス環境のサービスID
インスタンス環境のサービスIDは次のようになります。
プロダクトID 機能ID インスタンス番号 インスタンス名 [ホスト名]
PFM - Agent for IBM WebSphere MQの場合，インスタンス名にはjpcinssetupコマンドで指定したインスタンス名が表示されます。サービスIDについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されている命名規則を参照してください。

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

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

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

IPアドレスを設定する
Performance Managementを複数のLANに接続されたネットワークで使用するときに設定します。複数のIPアドレスを設定するには，jpchostsファイルにホスト名とIPアドレスを定義します。設定したjpchostsファイルはPerformance Managementシステム全体で統一させてください。
IPアドレスの設定の詳細については，マニュアル「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 IBM WebSphere MQで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先またはエクスポート先のディレクトリを変更したい場合にだけ，必要な設定です。

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

保存先：/opt/jp1pc/agt9/store/インスタンス名/

バックアップ先：/opt/jp1pc/agt9/store/インスタンス名/backup/

部分バックアップ先：/opt/jp1pc/agt9/store/インスタンス名/partial/

エクスポート先：/opt/jp1pc/agt9/store/インスタンス名/dump/

インポート先：/opt/jp1pc/agt9/store/インスタンス名/import/

注意

論理ホストで運用する場合のデフォルトの保存先については，「/opt/jp1pc」を「環境ディレクトリ/jp1pc」に読み替えてください。

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

(7)　PFM - Agent for IBM WebSphere MQの接続先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 システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
jpcnshostnameコマンド実行時に，Performance Managementのプログラムおよびサービスが起動されている場合は，停止を問い合わせるメッセージが表示されます。

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

jpcnshostname -s host01

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

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

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

(9)　そのほかの注意事項

PFM - Agent for IBM WebSphere MQをサービス運用するときは，スーパーユーザー権限(*)を持つアカウントで実行してください。

注意

*:mqmグループに属する必要があります。

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

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

＜この節の構成＞

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

3.2.2　アンセットアップ手順

3.2.3　アンインストール手順

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

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

＜この項の構成＞

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

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

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

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

(5)　そのほかの注意事項

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

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

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

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

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

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラムを起動したままアンインストールした場合，ファイルやディレクトリが残ることがあります。この場合は，手動でインストール先ディレクトリ以下をすべて削除してください。

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コマンドで表示できるサービスの情報は削除されません。この場合，jpcctrl deleteコマンドを使用してサービスの情報を削除してください。

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

(5)　そのほかの注意事項

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

アンインストールを実行する前にjpcinssetupコマンドまたはPFM - Web Consoleで，エージェントログの出力先ディレクトリを確認してください。エージェントログの出力先をデフォルト値（/opt/jp1pc/agt9/agent/インスタンス名/log）以外に設定している場合，アンインストールしてもエージェントログファイルは削除されません。この場合，アンインストール実行後にエージェントログファイルを手動で削除する必要があります。

3.2.2　アンセットアップ手順

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

＜この項の構成＞

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

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

インスタンス環境をアンセットアップするには，まずインスタンス名を確認し，インスタンス環境を削除します。インスタンス環境の削除は，PFM - Agentホストで実施します。インスタンス名を確認するには，jpcinslistコマンドを使用します。また，構築したインスタンス環境を削除するには，jpcinsunsetupコマンドを使用します。

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

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

jpcinslist agt9

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

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

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

jpcinsunsetup agt9 -inst MQinst

jpcinsunsetupコマンドが正常終了すると，インスタンス環境として構築されたディレクトリ，サービスIDが削除されます。

注意

インスタンス環境をアンセットアップしても，jpcctrl listコマンドで表示できるサービスの情報は削除されません。この場合，jpcctrl deleteコマンドを使用してサービスの情報を削除してください。次に指定例を示します。

インスタンス名：MQinst

ホスト名：host03

Agent CollectorサービスのサービスID：9A1MQinst[host03]

Agent StoreサービスのサービスID：9S1MQinst[host03]
jpcctrl delete 9?1MQinst[host03] host=host03

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

3.2.3　アンインストール手順

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

PFM - Agent for IBM WebSphere MQをアンインストールするホストに，スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスを停止する。
サービス情報を表示して，サービスが起動されていないか確認してください。
ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。サービスの表示方法およびサービスの停止については，マニュアル「JP1/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 IBM WebSphere MQのシステム構成の変更

監視対象システムのネットワーク構成の変更や，ホスト名の変更などに応じて，PFM - Agent for IBM WebSphere MQのシステム構成を変更する場合があります。

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

注意

インストール先のホスト名を変更すると，変更前に収集したパフォーマンスデータは参照できなくなります。

3.4　PFM - Agent for IBM WebSphere MQの運用方式の変更

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

＜この節の構成＞

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

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

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

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

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

保存先ディレクトリ

バックアップ先ディレクトリ

部分バックアップ先ディレクトリ※

エクスポート先ディレクトリ

インポート先ディレクトリ※

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

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

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

説明
オプション名
設定できる値（Storeバージョン1.0）※1
設定できる値（Storeバージョン2.0）※1
デフォルト値
※2

パフォーマンスデータの作成先ディレクトリ
sd
1～127バイトのパス名
1～214バイトのパス名
/opt/jp1pc/agt9/store /インスタンス名

パフォーマンスデータのバックアップ先ディレクトリ
bd
1～127バイトのパス名
1～211バイトのパス名
/opt/jp1pc/agt9/store/インスタンス名/backup

パフォーマンスデータの部分バックアップ先ディレクトリ
pb
－
1～214バイトのパス名
/opt/jp1pc/agt9/store/インスタンス名/partial

パフォーマンスデータを退避する場合の最大世代番号
bs
1～9
1～9
5

パフォーマンスデータのエクスポート先ディレクトリ
pbd
1～127バイトのパス名
1～127バイトのパス名
/opt/jp1pc/agt9/store/インスタンス名/dump

パフォーマンスデータのインポート先ディレクトリ
id
－
1～222バイトのパス名
/opt/jp1pc/agt9/store/インスタンス名/import

（凡例）

－：設定できません。

注※1

ディレクトリ名は，Storeデータベースのデフォルト格納先ディレクトリ（/opt/jp1pc/agt9/store）からの相対パスか，または絶対パスで指定してください。

注※2

論理ホストで運用する場合のデフォルト値については，「/opt/jp1pc」を「環境ディレクトリ/jp1pc」に読み替えてください。

なお，Storeバージョン1.0使用時は，jpcsto.iniファイルを直接編集して変更できます。jpcsto.iniファイルを編集する方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

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

インスタンス環境を更新したい場合は，インスタンス名を確認し，インスタンス情報を更新します。インスタンス情報の設定は，PFM - Agentホストで実施します。

更新する情報は，次の表であらかじめ確認してください。

表3-7　PFM - Agent for IBM WebSphere MQのインスタンス情報

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

QManager_Name
監視対象となるIBM WebSphere MQのキューマネージャー名
この値は更新できる
48バイト以内の半角文字列
指定できる文字

アルファベット
[a-z] [A-Z]

数字
[0-9]

次の記号
「.」「/」「_」「%」

前回の設定値

log_size
エージェントログの1ファイルの最大サイズ
この値は更新できる
1～32（単位：メガバイト）
ただし，推奨は16以上
前回の設定値

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

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

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

jpcinslist agt9

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

更新したいインスタンス環境のPFM - Agent for IBM WebSphere MQのサービスが起動されている場合は停止する。
サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
jpcinssetupコマンド実行時に，更新したいインスタンス環境のサービスが起動されている場合は，確認メッセージが表示され，サービスを停止できます。サービスを停止した場合は，更新処理が続行されます。サービスを停止しなかった場合は，更新処理が中断されます。

PFM - Agent for IBM WebSphere MQを示すサービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
インスタンス名がMQinstのインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

jpcinssetup agt9 -inst MQinst

PFM - Agent for IBM WebSphere MQのインスタンス情報を更新する。
表3-7に示した項目を，コマンドの指示に従って入力します。現在設定されている値が表示されます。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

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

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

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

この章では，クラスタシステムでPFM - Agent for IBM WebSphere MQを運用する場合のインストール，セットアップ，およびクラスタシステムでPFM - Agent for IBM WebSphere MQを運用しているときの処理の流れについて説明します。

また，表記上UNIXとしていますが，PFM - Agent for IBM WebSphere MQが動作するUNIXはAIXだけです。

＜この章の構成＞

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

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

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

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

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

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

4.7　PFM - Agent for IBM WebSphere MQの運用方式の変更

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

クラスタシステムとは，複数のサーバシステムを連携して一つのシステムとして運用するシステムです。PFM - Agent for IBM WebSphere MQの監視対象プログラムである，IBM WebSphere MQは，次のクラスタシステムで運用できます。

HA（High Availability）クラスタシステム構成のIBM WebSphere MQ

ここでは，クラスタシステムでPFM - Agent for IBM WebSphere MQを運用する場合の構成について説明します。クラスタシステムの概要，およびPerformance Managementシステムをクラスタシステムで運用する場合のシステム構成については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

なお，この章で，単に「クラスタシステム」と記述している場合は，HAクラスタシステムのことを指します。

＜この節の構成＞

4.1.1　HAクラスタシステム

4.1.1　HAクラスタシステム

＜この項の構成＞

(1)　HAクラスタシステムでのIBM WebSphere MQの構成

(2)　HAクラスタシステムでのPFM - Agent for IBM WebSphere MQの構成

(1)　HAクラスタシステムでのIBM WebSphere MQの構成

IBM WebSphere MQ（シングルインスタンスのIBM WebSphere MQ）をHAクラスタシステムで運用すると，障害発生時にフェールオーバーすることができ，可用性が向上します。

IBM WebSphere MQをHAクラスタシステムで運用する場合，一般的には，実行系ノードと待機系ノードの両方で同じIBM WebSphere MQのインスタンスが実行できる環境を構築し，IBM WebSphere MQのデータ（データファイル，構成ファイル，ログファイルなど）一式を共有ディスクに格納した構成にします。なお，HAクラスタシステム上でIBM WebSphere MQを運用する場合，一般的にはクラスタソフトからIBM WebSphere MQを制御するためのソリューション製品を使用します。

クラスタシステムでのIBM WebSphere MQの構成や運用方法は，システムによって異なる場合があります。

(2)　HAクラスタシステムでのPFM - Agent for IBM WebSphere MQの構成

PFM - Agent for IBM WebSphere MQは，HAクラスタシステムで運用でき，クラスタ構成のIBM WebSphere MQ を監視できます。HAクラスタシステムでPFM - Agent for IBM WebSphere MQを運用する場合は，次の図のような構成で運用します。

図4-1　HAクラスタシステムでのPFM - Agent for IBM WebSphere MQの構成例

図4-1に示すように，PFM - Agent for IBM WebSphere MQはクラスタ構成のIBM WebSphere MQと同じ論理ホスト環境で動作し，IBM WebSphere MQを監視します。障害発生時はIBM WebSphere MQのフェールオーバーに連動してPFM - Agent for IBM WebSphere MQもフェールオーバーし，監視を継続できます。

また，共有ディスクに定義情報やパフォーマンス情報を格納し，フェールオーバー時に引き継ぎます。一つの論理ホストに複数のPerformance Managementのプログラムがある場合は，それぞれが同じ共有ディレクトリを使います。

一つのノードでPFM - Agent for IBM WebSphere MQを複数実行できます。クラスタ構成のIBM WebSphere MQが複数ある構成（アクティブ・アクティブ構成）の場合，それぞれの論理ホスト環境で，PFM - Agent for IBM WebSphere MQを実行してください。それぞれのPFM - Agent for IBM WebSphere MQは独立して動作し，別々にフェールオーバーできます。

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

実行系ホストに障害が発生すると，処理が待機系ホストに移ります。

ここでは，PFM - Agent for IBM WebSphere MQに障害が発生した場合のフェールオーバー時の処理について説明します。また，PFM - Managerに障害が発生した場合の，PFM - Agent for IBM WebSphere MQへの影響について説明します。

＜この節の構成＞

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

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

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

PFM - Agent for IBM WebSphere MQを実行している監視対象ホストでフェールオーバーが発生した場合の処理を次の図に示します。

図4-2　監視対象ホストでフェールオーバーが発生した場合の処理

PFM - Agent for IBM WebSphere MQのフェールオーバー中に，PFM - Web Consoleで操作すると，「There was no answer(-6)」というメッセージが表示されます。この場合は，フェールオーバーが完了するまで待ってから操作してください。

PFM - Agent for IBM WebSphere MQのフェールオーバー後に，PFM - Web Consoleで操作すると，フェールオーバー先のノードで起動したPFM - Agent for IBM WebSphere MQに接続されます。

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

PFM - Managerが停止すると，Performance Managementシステム全体に影響があります。

PFM - Managerは，各ノードで動作しているPFM - Agent for IBM WebSphere MQのエージェント情報を一括管理しています。また，PFM - Agent for IBM WebSphere MQがパフォーマンス監視中にしきい値を超えた場合のアラームイベントの通知や，アラームイベントを契機としたアクションの実行を制御しています。このため，PFM - Managerが停止すると，Performance Managementシステムに次の表に示す影響があります。

表4-1　PFM - Managerが停止した場合のPFM - Agent for IBM WebSphere MQへの影響

プログラム名
影響
対処

PFM - Agent for IBM WebSphere MQ
PFM - Agent for IBM WebSphere MQの動作中に，PFM - Managerが停止した場合，次のように動作する。

パフォーマンスデータは継続して収集される。

発生したアラームイベントをPFM - Managerに通知できないため，アラーム定義ごとにアラームイベントが保持され，PFM - Managerが起動するまで通知をリトライする。保持しているアラームイベントが三つを超えると，古いアラームイベントは上書きされる。また，PFM - Agent for IBM WebSphere MQを停止すると，保持しているアラームイベントは削除される。

PFM - Managerに通知済みのアラームステータスは，PFM - Managerが再起動したときに一度リセットされる。その後，PFM - ManagerがPFM - Agent for IBM WebSphere MQの状態を確認したあと，アラームステータスは最新の状態になる。

PFM - Agent for IBM WebSphere MQを停止しようとした場合，PFM - Managerに停止することを通知できないため，停止に時間が掛かる。

PFM - Managerを起動する。
動作中のPFM - Agent for IBM WebSphere MQはそのまま運用できる。ただし，アラームが期待したとおり通知されない場合があるため，PFM - Manager復旧後に，共通メッセージログに出力されているメッセージKAVE00024-Iを確認すること。

PFM - Managerが停止した場合の影響を考慮の上，運用方法を検討してください。なお，トラブル以外にも，構成変更やメンテナンスの作業などでPFM - Managerの停止が必要になる場合もあります。運用への影響が少ないときに，メンテナンスすることをお勧めします。

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

ここでは，クラスタシステムでのPFM - Agent for IBM WebSphere MQのインストールとセットアップの手順について説明します。

なお，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 IBM WebSphere MQのセットアップに必要な情報

(3)　PFM - Agent for IBM WebSphere MQで論理ホストをフェールオーバーさせる場合の注意事項

(1)　前提条件

PFM - Agent for IBM WebSphere MQをクラスタシステムで使用する場合，次に示す前提条件があります。

(a)　クラスタシステム

次の条件が整っていることを確認してください。

クラスタシステムがクラスタソフトによって制御されていること。

クラスタソフトが論理ホスト運用するPFM - Agent for IBM WebSphere MQの起動や停止などを制御するように設定されていること。このとき，PFM - Agent for IBM WebSphere MQが，監視対象のIBM WebSphere MQと連動してフェールオーバーするように設定すること。

注意

ワトソン博士でアプリケーションエラーのメッセージボックスが表示されると，フェールオーバーできないおそれがあるため，メッセージボックスによるエラーの通知を抑止する必要があります。抑止手順については，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 IBM WebSphere MQのセットアップに必要な情報

論理ホスト運用するPFM - Agent for IBM WebSphere MQをセットアップするには，通常のPFM - Agent for IBM WebSphere MQのセットアップで必要になる環境情報に加えて，次の表の情報が必要です。

表4-2　論理ホスト運用のPFM - Agent for IBM WebSphere MQのセットアップに必要な情報

項目 | 例
論理ホスト名 | jp1-halora
論理IPアドレス | 172.16.92.100
共有ディスク | S:¥jp1

なお，一つの論理ホストで論理ホスト運用するPerformance Managementのプログラムが複数ある場合も，同じ共有ディスクのフォルダを使用します。

共有ディスクに必要な容量については，「付録A　システム見積もり」を参照してください。

(3)　PFM - Agent for IBM WebSphere MQで論理ホストをフェールオーバーさせる場合の注意事項

PFM - Agent for IBM WebSphere MQを論理ホスト運用するシステム構成の場合，PFM - Agent for IBM WebSphere MQの障害によって論理ホスト全体をフェールオーバーさせるかどうかを検討してください。

PFM - Agent for IBM WebSphere MQの障害で論理ホスト全体をフェールオーバーさせると，PFM - Agent for IBM WebSphere MQが監視対象としている同じ論理ホストで運用する業務アプリケーションもフェールオーバーすることになり，業務に影響を与えるおそれがあります。

通常は，PFM - Agent for IBM WebSphere MQに異常が発生しても，IBM WebSphere MQの動作に影響がないように，次のどちらかのようにクラスタソフトで設定することをお勧めします。

PFM - Agent for IBM WebSphere MQの動作監視をしない

PFM - Agent for IBM WebSphere MQの異常を検知してもフェールオーバーしない

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

クラスタシステムで，論理ホスト運用するPFM - Agent for IBM WebSphere MQのインストールおよびセットアップの流れを次の図に示します。

図4-3　クラスタシステムで論理ホスト運用するPFM - Agent for IBM WebSphere MQのインストールおよびセットアップの流れ（Windowsの場合）

注意

論理ホスト環境のPFM - Agentをセットアップしても，物理ホスト環境のPFM - Agentの定義内容は引き継がれません。論理ホスト環境および物理ホスト環境では，インスタンス環境を設定した時点で，新規に環境が作成されます。

4.3.3　インストール手順

実行系ノードおよび待機系ノードのそれぞれにPFM - Agent for IBM WebSphere MQをインストールします。

注意

インストール先はローカルディスクです。共有ディスクにはインストールしないでください。

インストール手順は非クラスタシステムの場合と同じです。インストール手順については，「2.1.3　インストール手順」を参照してください。

4.3.4　セットアップ手順

ここでは，クラスタシステムでPerformance Managementを運用するための，セットアップについて説明します。

セットアップ手順には，実行系ノードの手順と，待機系ノードの手順があります。実行系ノード，待機系ノードの順にセットアップしてください。

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

注意

JPC_HOSTNAME環境変数は，Performance Managementで使用していますので，環境変数として設定しないでください。誤って設定した場合は，Performance Managementが正しく動作しません。

＜この項の構成＞

(1)　PFM - Agentの登録　　

(2)　共有ディスクのオンライン

(3)　PFM - Agentの論理ホストのセットアップ

(4)　接続先PFM - Managerの設定

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

(6)　他Performance Managementプログラムの論理ホストのセットアップ　

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

(8)　論理ホスト環境定義ファイルのエクスポート

(9)　論理ホスト環境定義ファイルの待機系ノードへのコピー　

(10)　共有ディスクのオフライン　

(11)　論理ホスト環境定義ファイルのインポート

(12)　クラスタソフトへのPFM - Agentの登録　

(13)　クラスタソフトからの起動・停止の確認　

(14)　クラスタシステムでの環境設定　

(1)　PFM - Agentの登録[図データ]　[図データ]　[図データ]

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

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

登録はPFM - Manager上およびPFM - Web Console上で実施します。手順は非クラスタシステムの場合と同じです。手順については，「2.1.4(1)　PFM - Agent for IBM WebSphere MQの登録」を参照してください。

(2)　共有ディスクのオンライン[図データ]

共有ディスクがオンラインになっていることを確認します。共有ディスクがオンラインになっていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオンラインにしてください。

(3)　PFM - Agentの論理ホストのセットアップ[図データ]

jpchasetup createコマンドを実行して論理ホスト環境を作成します。コマンドを実行すると，共有ディスクに必要なデータがコピーされ，論理ホスト用の定義が設定されて，論理ホスト環境が作成されます。

注意

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

手順を次に示します。

jpchasetup createコマンドを実行して，PFM - Agent for IBM WebSphere MQの論理ホスト環境を作成する。
次のようにコマンドを実行します。

jpchasetup create agt9 -lhost jp1-halora -d S:¥jp1

論理ホスト名は，-lhostオプションで指定します。ここでは，論理ホスト名をjp1-haloraとしています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
共有ディスクのフォルダ名は，-dオプションの環境フォルダ名に指定します。例えば-d S:¥jp1と指定するとS:¥jp1¥jp1pcが作成されて，論理ホスト環境のファイルが作成されます。

注意

環境フォルダ名には，次の文字を含むパスは指定しないでください。

「(」,「)」

これらの文字が含まれていた場合，論理ホストの環境作成には成功しますが，PFM - Agent for IBM WebSphere MQの起動に失敗します。

jpchasetup listコマンドを実行して，論理ホストの設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

作成した論理ホスト環境が正しいことを確認してください。

(4)　接続先PFM - Managerの設定[図データ]

jpcnshostnameコマンドを実行して，PFM - Agent for IBM WebSphere MQを管理するPFM - Managerを設定します。

jpcnshostnameコマンドを実行して，接続先PFM - Managerを設定する。
次のようにコマンドを実行します。

jpcnshostname -s jp1-hal -lhost jp1-halora

接続先PFM - Managerのホスト名は，-sオプションで指定します。接続先PFM Managerが論理ホスト運用されている場合は，-sオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは，PFM - Managerの論理ホスト名をjp1-halとしています。
また，PFM - Agent for IBM WebSphere MQの論理ホスト名は，-lhostオプションで指定します。ここでは，PFM - Agent for IBM WebSphere MQの論理ホスト名をjp1-haloraとしています。

(5)　インスタンス環境の設定[図データ]

jpcinssetupコマンドを実行して，PFM - Agent for IBM WebSphere MQのインスタンス環境を設定します。

設定手順は，非クラスタシステムの場合と同じです。ただし，クラスタシステムの場合，jpcinssetupコマンドの実行時に，「-lhost」で論理ホスト名を指定する必要があります。

クラスタシステムの場合のjpcinssetupコマンドの指定方法を次に示します。

jpcinssetup agt9 -lhost 論理ホスト名 -inst インスタンス名

なお，エージェントログの出力先フォルダ（log_pathの値）には，共有ディスク上のパスを指定してください。

このほかの設定内容，および手順については，「2.1.4(2)　インスタンス環境の設定」を参照してください。

(6)　他Performance Managementプログラムの論理ホストのセットアップ[図データ]　[図データ]

PFM - Agent for IBM WebSphere MQのほかに，同じ論理ホストにセットアップするPFM - ManagerやPFM - Agentがある場合は，この段階でセットアップしてください。

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

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

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

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

IPアドレスを設定する
複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合には，jpchostsファイルの内容を直接編集します。
このとき，編集したjpchostsファイルは，実行系ノードから待機系ノードにコピーしてください。
IPアドレスの設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

ポート番号を設定する
ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には，jpcnsconfig portコマンドを使用してポート番号を設定します。
ポート番号の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。

(8)　論理ホスト環境定義ファイルのエクスポート[図データ]

PFM - Agent for IBM WebSphere MQの論理ホスト環境が作成できたら，環境定義をファイルにエクスポートします。エクスポートでは，その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報を一括してファイル出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は，セットアップが一とおり済んだあとにエクスポートしてください。

論理ホスト環境定義をエクスポートする手順を次に示します。

jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
これまでの手順で作成した論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

jpchasetup export -f lhostexp.txt

(9)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(8)　論理ホスト環境定義ファイルのエクスポート」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

(10)　共有ディスクのオフライン[図データ]　[図データ]

クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオフラインにして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，オフラインにする必要はありません。

(11)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードにインポートします。

実行系ノードで作成した論理ホストのPerformance Managementのプログラムを，待機系ノードで実行するための設定には，jpchasetup importコマンドを使用します。一つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は，一括してインポートされます。

なお，このコマンドを実行するときには，共有ディスクをオンラインにしておく必要はありません。

jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

jpchasetup import -f lhostexp.txt

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for IBM WebSphere MQを起動するための設定が実施されます。
また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，同様に設定されます。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

実行系ノードでjpchasetup listを実行した時と同じ内容が表示されることを確認してください。

(12)　クラスタソフトへのPFM - Agentの登録[図データ]　[図データ]

Performance Managementのプログラムを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。

注意

PFM - Agent for IBM WebSphere MQの登録を実施する前に，IBM WebSphere MQのリソースの登録が必要です。

クラスタソフトへPFM - Agent for IBM WebSphere MQを登録する方法は，クラスタソフトのマニュアルを参照してください。

PFM - Agent for IBM WebSphere MQをクラスタソフトに登録するときの設定内容を，Windows MSCSに登録する項目を例として説明します。

PFM - Agent for IBM WebSphere MQの場合，次の表のサービスをクラスタに登録します。

表4-3　クラスタソフトに登録するPFM - Agent for IBM WebSphere MQのサービス

項番
名前
サービス名
依存関係

1
PFM - Agent Store for IBM WebSphere MQインスタンス名 [LHOST]
JP1PCAGT_9S_インスタンス名 [LHOST]
IPアドレスリソース※1
物理ディスクリソース※2
IBM WebSphere MQリソース

2
PFM - Agent for IBM WebSphere MQ インスタンス名 [LHOST]
JP1PCAGT_9A_インスタンス名 [LHOST]
項番1のクラスタリソース

3
PFM - Action Handler [LHOST]
JP1PCMGR_PH [LHOST]
IPアドレスリソース※1
物理ディスクリソース※2

注※1

IBM WebSphere MQ のクラスタ環境で定義されているIP アドレスのリソース

注※2

IBM WebSphere MQ のクラスタ環境で定義されている共有ディスクのリソース

[LHOST]の部分は，論理ホスト名に置き換えてください。インスタンス名がSDC1，論理ホスト名がjp1-haloraの場合，サービスの名前は「PFM - Agent Store for IBM WebSphere MQ SDC1 [jp1-halora]」，サービス名は「JP1PCAGT_9S_SDC1 [jp1-halora]」のようになります。

MSCSの場合は，これらのサービスをMSCSのリソースとして登録します。各リソースの設定は次のようにします。下記の［　］は，MSCSの設定項目です。

［リソースの種類］は「汎用サービス」として登録する。

［名前］，［依存関係］，および［サービス名］を表4-3のとおりに設定する。

［起動パラメータ］および［レジストリ複製］は設定しない。

プロパティの［詳細設定］タブは，Performance Managementのプログラムの障害時にフェールオーバーするかしないかの運用に合わせて設定する。

例えば，PFM - Agent for IBM WebSphere MQの障害時に，フェールオーバーするように設定するには，次のように設定します。

［再開する］：チェックする

［グループに適用する］：チェックする

再起動試行回数の［しきい値］：3※

注※

再起動試行回数の［しきい値］は3回を目安に設定してください。

注意

クラスタに登録するサービスは，クラスタから起動および停止を制御しますので，OS起動時に自動起動しないよう［スタートアップの種類］を［手動］に設定してください。なお，jpchasetup createコマンドでセットアップした直後のサービスは［手動］に設定されています。また，次のコマンドで強制停止しないでください。

jpcstop all lhost=論理ホスト名 kill=immediate

(13)　クラスタソフトからの起動・停止の確認[図データ]　[図データ]

クラスタソフトからの操作で，Performance Managementのプログラムの起動および停止を各ノードで実行し，正常に動作することを確認してください。

(14)　クラスタシステムでの環境設定[図データ]　[図データ]

Performance Managementのプログラムのセットアップ終了後，PFM - Web Consoleから，運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり，監視対象で問題が発生したときにユーザーに通知できるようにしたりするために，Performance Managementのプログラムの環境を設定します。

Performance Managementのプログラムの環境設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

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

ここでは，クラスタシステムでのPFM - Agent for IBM WebSphere MQのインストールとセットアップの手順について説明します。

なお，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 IBM WebSphere MQのセットアップに必要な情報

(3)　PFM - Agent for IBM WebSphere MQで論理ホストをフェールオーバーさせる場合の注意事項

(1)　前提条件

PFM - Agent for IBM WebSphere MQをクラスタシステムで使用する場合，次に示す前提条件があります。

(a)　クラスタシステム

次の条件が整っていることを確認してください。

クラスタシステムがクラスタソフトによって制御されていること。

クラスタソフトが論理ホスト運用するPFM - Agent for IBM WebSphere MQの起動や停止などを制御するように設定されていること。このとき，PFM - Agent for IBM WebSphere MQが，監視対象のIBM WebSphere MQと連動してフェールオーバーするように設定すること。

(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 IBM WebSphere MQのセットアップに必要な情報

論理ホスト運用するPFM - Agent for IBM WebSphere MQをセットアップするには，通常のPFM - Agent for IBM WebSphere MQのセットアップで必要になる環境情報に加えて，次の表の情報が必要です。

表4-4　論理ホスト運用のPFM - Agent for IBM WebSphere MQのセットアップに必要な情報

項目 | 例
論理ホスト名 | jp1-halora
論理IPアドレス | 172.16.92.100
共有ディスク | /jp1

なお，一つの論理ホストで論理ホスト運用するPerformance Managementのプログラムが複数ある場合も，同じ共有ディスクのディレクトリを使用します。

共有ディスクに必要な容量については，「付録A　システム見積もり」を参照してください。

(3)　PFM - Agent for IBM WebSphere MQで論理ホストをフェールオーバーさせる場合の注意事項

PFM - Agent for IBM WebSphere MQを論理ホスト運用するシステム構成の場合，PFM - Agent for IBM WebSphere MQの障害によって論理ホスト全体をフェールオーバーさせるかどうかを検討してください。

PFM - Agent for IBM WebSphere MQの障害で論理ホスト全体をフェールオーバーさせると，PFM - Agent for IBM WebSphere MQが監視対象としている同じ論理ホストで運用する業務アプリケーションもフェールオーバーすることになり，業務に影響を与えるおそれがあります。

通常は，PFM - Agent for IBM WebSphere MQに異常が発生しても，IBM WebSphere MQの動作に影響がないように，次のどちらかのようにクラスタソフトで設定することをお勧めします。

PFM - Agent for IBM WebSphere MQの動作監視をしない

PFM - Agent for IBM WebSphere MQの異常を検知してもフェールオーバーしない

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

クラスタシステムで，論理ホスト運用するPFM - Agent for IBM WebSphere MQのインストールおよびセットアップの流れを次の図に示します。

図4-4　クラスタシステムで論理ホスト運用するPFM - Agent for IBM WebSphere MQのインストールおよびセットアップの流れ（UNIXの場合）

注意

論理ホスト環境のPFM - Agentをセットアップしても，物理ホスト環境のPFM - Agentの定義内容は引き継がれません。論理ホスト環境および物理ホスト環境では，インスタンス環境を設定した時点で，新規に環境が作成されます。

4.4.3　インストール手順

実行系ノードおよび待機系ノードのそれぞれにPFM - Agent for IBM WebSphere MQをインストールします。

注意

インストール先はローカルディスクです。共有ディスクにはインストールしないでください。

インストール手順は非クラスタシステムの場合と同じです。インストール手順については，「3.1.3　インストール手順」を参照してください。

4.4.4　セットアップ手順

ここでは，クラスタシステムでPerformance Managementを運用するための，セットアップについて説明します。

セットアップ手順には，実行系ノードの手順と，待機系ノードの手順があります。実行系ノード，待機系ノードの順にセットアップしてください。

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

注意

JPC_HOSTNAME環境変数は，Performance Managementで使用していますので，環境変数として設定しないでください。誤って設定した場合は，Performance Managementが正しく動作しません。

＜この項の構成＞

(1)　PFM - Agentの登録　　

(2)　共有ディスクのマウント

(3)　PFM - Agentの論理ホストのセットアップ

(4)　接続先PFM - Managerの設定

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

(6)　他Performance Managementプログラムの論理ホストのセットアップ　

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

(8)　論理ホスト環境定義ファイルのエクスポート

(9)　論理ホスト環境定義ファイルの待機系ノードへのコピー　

(10)　共有ディスクのアンマウント　

(11)　論理ホスト環境定義ファイルのインポート

(12)　クラスタソフトへのPFM - Agentの登録　

(13)　クラスタソフトからの起動・停止の確認　

(14)　クラスタシステムでの環境設定　

(1)　PFM - Agentの登録[図データ]　[図データ]　[図データ]

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

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

登録はPFM - Manager上およびPFM - Web Console上で実施します。手順は非クラスタシステムの場合と同じです。手順については，「3.1.4(2)　PFM - Agent for IBM WebSphere MQの登録」を参照してください。

(2)　共有ディスクのマウント[図データ]

共有ディスクがマウントされていることを確認します。共有ディスクがマウントされていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをマウントしてください。

(3)　PFM - Agentの論理ホストのセットアップ[図データ]

jpchasetup createコマンドを実行して論理ホスト環境を作成します。コマンドを実行すると，共有ディスクに必要なデータがコピーされ，論理ホスト用の定義が設定されて，論理ホスト環境が作成されます。

注意

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

手順を次に示します。

jpchasetup createコマンドを実行して，PFM - Agent for IBM WebSphere MQの論理ホスト環境を作成する。
次のようにコマンドを実行します。

jpchasetup create agt9 -lhost jp1-halora -d /jp1

論理ホスト名は，-lhostオプションで指定します。ここでは，論理ホスト名をjp1-haloraとしています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
共有ディスクのディレクトリ名は，-dオプションの環境ディレクトリ名に指定します。例えば-d /jp1と指定すると/jp1/jp1pcが作成されて，論理ホスト環境のファイルが作成されます。

jpchasetup listコマンドを実行して，論理ホストの設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

作成した論理ホスト環境が正しいことを確認してください。

(4)　接続先PFM - Managerの設定[図データ]

jpcnshostnameコマンドを実行して，PFM - Agent for IBM WebSphere MQを管理するPFM - Managerを設定します。

jpcnshostnameコマンドを実行して，接続先PFM - Managerを設定する。
次のようにコマンドを実行します。

jpcnshostname -s jp1-hal -lhost jp1-halora

接続先PFM - Managerのホスト名は，-sオプションで指定します。接続先PFM Managerが論理ホスト運用されている場合は，-sオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは，PFM - Managerの論理ホスト名をjp1-halとしています。
また，PFM - Agent for IBM WebSphere MQの論理ホスト名は，-lhostオプションで指定します。ここでは，PFM - Agent for IBM WebSphere MQの論理ホスト名をjp1-haloraとしています。

(5)　インスタンス環境の設定[図データ]

jpcinssetupコマンドを実行して，PFM - Agent for IBM WebSphere MQのインスタンス環境を設定します。

設定手順は，非クラスタシステムの場合と同じです。ただし，クラスタシステムの場合，jpcinssetupコマンドの実行時に，「-lhost」で論理ホスト名を指定する必要があります。

クラスタシステムの場合のjpcinssetupコマンドの指定方法を次に示します。

jpcinssetup agt9 -lhost 論理ホスト名 -inst インスタンス名

なお，エージェントログの出力先ディレクトリ（log_pathの値）には，共有ディスク上のパスを指定してください。

このほかの設定内容，および手順については，「3.1.4(3)　インスタンス環境の設定」を参照してください。

(6)　他Performance Managementプログラムの論理ホストのセットアップ[図データ]　[図データ]

PFM - Agent for IBM WebSphere MQのほかに，同じ論理ホストにセットアップするPFM - ManagerやPFM - Agentがある場合は，この段階でセットアップしてください。

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

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

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

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

IPアドレスを設定する
複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合には，jpchostsファイルの内容を直接編集します。
このとき，編集したjpchostsファイルは，実行系ノードから待機系ノードにコピーしてください。
IPアドレスの設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

ポート番号を設定する
ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には，jpcnsconfig portコマンドを使用してポート番号を設定します。
ポート番号の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。

(8)　論理ホスト環境定義ファイルのエクスポート[図データ]

PFM - Agent for IBM WebSphere MQの論理ホスト環境が作成できたら，環境定義をファイルにエクスポートします。エクスポートでは，その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報を一括してファイル出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は，セットアップが一とおり済んだあとにエクスポートしてください。

論理ホスト環境定義をエクスポートする手順を次に示します。

jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
これまでの手順で作成した論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

jpchasetup export -f lhostexp.txt

(9)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(8)　論理ホスト環境定義ファイルのエクスポート」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

(10)　共有ディスクのアンマウント[図データ]　[図データ]

ファイルシステムをアンマウントして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，ファイルシステムをアンマウントする必要はありません。

注意

共有ディスクがアンマウントされていても，指定した環境ディレクトリにjp1pcディレクトリがあり，jp1pcディレクトリ以下にファイルがある場合は，共有ディスクをマウントしないでセットアップしています。この場合は次の手順で対処してください。

ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。

共有ディスクをマウントする。

共有ディスク上に指定した環境ディレクトリがない場合は，環境ディレクトリを作成する。

共有ディスク上の環境ディレクトリにtarファイルを展開する。

共有ディスクをアンマウントする。

ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリ以下を削除する。

(11)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードにインポートします。

実行系ノードで作成した論理ホストのPerformance Managementのプログラムを，待機系ノードで実行するための設定には，jpchasetup importコマンドを使用します。一つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は，一括してインポートされます。

なお，このコマンドを実行するときには，共有ディスクをオンラインにしておく必要はありません。

jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

jpchasetup import -f lhostexp.txt

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for IBM WebSphere MQを起動するための設定が実施されます。
また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，同様に設定されます。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

実行系ノードでjpchasetup listを実行した時と同じ内容が表示されることを確認してください。

(12)　クラスタソフトへのPFM - Agentの登録[図データ]　[図データ]

Performance Managementのプログラムを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。

ここでは，PFM - Agent for IBM WebSphere MQをクラスタソフトに登録するときに設定する内容を説明します。

一般にUNIXのクラスタソフトに，アプリケーションを登録する場合に必要な項目は「起動」「停止」「動作監視」「強制停止」の四つがあります。

PFM - Agent for IBM WebSphere MQでの設定方法を次の表に示します。

表4-5　クラスタソフトに登録するPFM - Agent for IBM WebSphere MQの制御方法

項目
説明

起動
次のコマンドを順に実行して，PFM - Agent for IBM WebSphere MQを起動します。

/opt/jp1pc/tools/jpcstart act lhost= 論理ホスト名
/opt/jp1pc/tools/jpcstart agt9 lhost= 論理ホスト名 inst= インスタンス名

起動するタイミングは，共有ディスクおよび論理IPアドレスが使用できる状態になったあとです。

停止
次のコマンドを順に実行して，PFM - Agent for IBM WebSphere MQを停止します。

/opt/jp1pc/tools/jpcstop agt9 lhost= 論理ホスト名 inst= インスタンス名/opt/jp1pc/tools/jpcstop act lhost= 論理ホスト名

停止するタイミングは，共有ディスクおよび論理IPアドレスを使用できない状態にする前です。
障害などでサービスが停止しているときは，jpcstopコマンドの戻り値が3になります。この場合はサービスが停止しているので，正常終了として扱います。
戻り値で実行結果を判定するクラスタソフトの場合は，戻り値を0にするなどの方法で対応してください。

動作監視
次のプロセスが動作していることを，psコマンドで確認します。

ps -ef | grep "プロセス名 論理ホスト名" | grep -v "grep 監視対象のプロセス"

監視対象のプロセスは，次のとおりです。

jpcagt9,agt9/jpcsto,jpcah

プロセス名ついては，マニュアル「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コマンドで論理ホストがすべて表示されているか確認してください。表示が途中で切れてしまっている場合は表示されている文字までを監視するように設定してください。

IBM WebSphere MQを起動してから，PFM - Agent for IBM WebSphere MQを起動してください。また，停止する場合は，PFM - Agent for IBM WebSphere MQを停止してから，IBM WebSphere MQを停止してください。

(13)　クラスタソフトからの起動・停止の確認[図データ]　[図データ]

クラスタソフトからの操作で，Performance Managementのプログラムの起動および停止を各ノードで実行し，正常に動作することを確認してください。

(14)　クラスタシステムでの環境設定[図データ]　[図データ]

Performance Managementのプログラムのセットアップ終了後，PFM - Web Consoleから，運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり，監視対象で問題が発生したときにユーザーに通知できるようにしたりするために，Performance Managementのプログラムの環境を設定します。

Performance Managementのプログラムの環境設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

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

ここでは，クラスタシステムで運用していたPFM - Agent for IBM WebSphere MQを，アンインストールする方法とアンセットアップする方法について説明します。

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

＜この節の構成＞

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

4.5.2　アンセットアップ手順

4.5.3　アンインストール手順

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

クラスタシステムで運用していたPFM - Agent for IBM WebSphere MQのアンインストールおよびアンセットアップの流れを次の図に示します。

図4-5　クラスタシステムで論理ホスト運用するPFM - Agent for IBM WebSphere MQのアンインストールおよびアンセットアップの流れ（Windowsの場合）

4.5.2　アンセットアップ手順

論理ホスト環境をアンセットアップします。アンセットアップ手順には，実行系ノードの手順と，待機系ノードの手順があります。実行系ノード，待機系ノードの順にアンセットアップしてください。

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

PFM - Agent for IBM WebSphere MQのアンセットアップ手順について説明します。

＜この項の構成＞

(1)　クラスタソフトからの停止　

(2)　共有ディスクのオンライン

(3)　ポート番号の設定の解除　

(4)　PFM - Agentの論理ホストのアンセットアップ

(5)　他Performance Managementプログラムの論理ホストのアンセットアップ　

(6)　論理ホスト環境定義ファイルのエクスポート

(7)　論理ホスト環境定義ファイルの待機系ノードへのコピー　

(8)　共有ディスクのオフライン　

(9)　論理ホスト環境定義ファイルのインポート

(10)　クラスタソフトからのPFM - Agentの登録解除　

(11)　PFM - Managerでの設定の削除　

(1)　クラスタソフトからの停止[図データ]　[図データ]

クラスタソフトからの操作で，実行系ノードと待機系ノードで起動しているPerformance Managementのプログラムおよびサービスを停止してください。停止する方法については，クラスタソフトのマニュアルを参照してください。

(2)　共有ディスクのオンライン[図データ]

共有ディスクがオンラインになっていることを確認します。共有ディスクがオンラインになっていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオンラインにしてください。

(3)　ポート番号の設定の解除[図データ]　[図データ]

この手順は，ファイアウォールを使用する環境で，セットアップ時にjpcnsconfig portコマンドでポート番号を設定した場合だけに必要な手順です。

ポート番号の解除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。

(4)　PFM - Agentの論理ホストのアンセットアップ[図データ]

手順を次に示します。

注意

共有ディスクがオフラインになっている状態で論理ホスト環境を削除した場合は，物理ホスト上に存在する論理ホストの設定が削除され，共有ディスク上のフォルダやファイルは削除されません。この場合，共有ディスクをオンラインにし，環境フォルダ以下のjp1pcフォルダを手動で削除してください。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all -lhost jp1-halora

論理ホスト環境をアンセットアップする前に，現在の設定を確認します。論理ホスト名や共有ディスクのパスなどを確認してください。

PFM - Agent for IBM WebSphere MQのインスタンス環境を削除する。
次のようにコマンドを実行します。

jpcinsunsetup agt9 -lhost jp1-halora -inst SDC1

jpcinsunsetupコマンドを実行すると，論理ホストのインスタンスを起動するための設定が削除されます。また，共有ディスク上のインスタンス用のファイルが削除されます。

jpchasetup deleteコマンドを実行して，PFM - Agent for IBM WebSphere MQの論理ホスト環境を削除する。
次のようにコマンドを実行します。

jpchasetup delete agt9 -lhost jp1-halora

jpchasetup deleteコマンドを実行すると，論理ホストのPFM - Agent for IBM WebSphere MQを起動するための設定が削除されます。また，共有ディスク上の論理ホスト用のファイルが削除されます。

jpchasetup listコマンドで，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

論理ホスト環境からPFM - Agent for IBM WebSphere MQが削除されていることを確認してください。

(5)　他Performance Managementプログラムの論理ホストのアンセットアップ[図データ]　[図データ]

PFM - Agent for IBM WebSphere MQのほかに，同じ論理ホストからアンセットアップするPerformance Managementプログラムがある場合は，この段階でアンセットアップしてください。

アンセットアップ手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(6)　論理ホスト環境定義ファイルのエクスポート[図データ]

論理ホストのPFM - Agent for IBM WebSphere MQを削除したら，環境定義をファイルにエクスポートします。

Performance Managementでは，環境定義のエクスポートおよびインポートによって実行系と待機系の環境を合わせる方式を採っています。実行系ノードでエクスポートした環境定義（Performance Managementの定義が削除されている）を，待機系ノードにインポートすると，待機系ノードの既存の環境定義（Performance Managementの定義が削除前のままの状態で定義が残っている）と比較して差分（実行系ノードで削除された部分）を確認してPerformance Managementの環境定義を削除します。

手順を次に示します。

jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
Performance Managementの論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

jpchasetup export -f lhostexp.txt

(7)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(6)　論理ホスト環境定義ファイルのエクスポート」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

(8)　共有ディスクのオフライン[図データ]　[図データ]

クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオフラインにして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，オフラインにする必要はありません。

(9)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードに反映させるためにインポートします。なお，待機系ノードでは，インポート時に共有ディスクをオフラインにする必要はありません。

手順を次に示します。

jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

jpchasetup import -f lhostexp.txt

コマンドを実行すると，待機系ノードの環境をエクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for IBM WebSphere MQを起動するための設定が削除されます。ほかの論理ホストのPerformance Managementのプログラムをアンセットアップしている場合は，それらの設定も削除されます。また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，解除されます。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

実行系ノードでjpchasetup listコマンドを実行したときと同じ内容が表示されることを確認してください。

(10)　クラスタソフトからのPFM - Agentの登録解除[図データ]　[図データ]

クラスタソフトから，論理ホストのPFM - Agent for IBM WebSphere MQに関する設定を削除してください。設定を削除する方法は，クラスタソフトのマニュアルを参照してください。

(11)　PFM - Managerでの設定の削除[図データ]　[図データ]

PFM - Web ConsoleでPFM - Managerにログインし，アンセットアップするPFM - Agent for IBM WebSphere MQに関連する定義を削除してください。

手順を次に示します。

PFM - Web Consoleから，エージェントを削除する。

PFM - Managerのエージェント情報を削除する。
例えば，PFM - Managerが論理ホストjp1-hal上で動作し，PFM - Agent for IBM WebSphere MQが論理ホストjp1-halora上で動作している場合，次のように指定してコマンドを実行します。

jpcctrl delete サービスID host=jp1-halora 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 IBM WebSphere MQを実行系ノード，待機系ノードそれぞれからアンインストールします。

アンインストール手順は，非クラスタシステムの場合と同じです。手順については，「2.2.3　アンインストール手順」を参照してください。

注意

PFM - Agent for IBM WebSphere MQをアンインストールする場合は，PFM - Agent for IBM WebSphere MQをアンインストールするノードのPerformance Managementのプログラムおよびサービスをすべて停止してください。

論理ホスト環境を削除しないでPFM - Agent for IBM WebSphere MQをアンインストールした場合，環境フォルダが残ることがあります。その場合は，環境フォルダを削除してください。

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

ここでは，クラスタシステムで運用していたPFM - Agent for IBM WebSphere MQを，アンインストールする方法とアンセットアップする方法について説明します。

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

＜この節の構成＞

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

4.6.2　アンセットアップ手順

4.6.3　アンインストール手順

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

クラスタシステムで運用していたPFM - Agent for IBM WebSphere MQのアンインストールおよびアンセットアップの流れを次の図に示します。

図4-6　クラスタシステムで論理ホスト運用するPFM - Agent for IBM WebSphere MQのアンインストールおよびアンセットアップの流れ（UNIXの場合）

4.6.2　アンセットアップ手順

論理ホスト環境をアンセットアップします。アンセットアップ手順には，実行系ノードの手順と，待機系ノードの手順があります。実行系ノード，待機系ノードの順にアンセットアップしてください。

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

PFM - Agent for IBM WebSphere MQのアンセットアップ手順について説明します。

＜この項の構成＞

(1)　クラスタソフトからの停止　

(2)　共有ディスクのマウント

(3)　ポート番号の設定の解除　

(4)　PFM - Agentの論理ホストのアンセットアップ

(5)　他Performance Managementプログラムの論理ホストのアンセットアップ　

(6)　論理ホスト環境定義ファイルのエクスポート

(7)　論理ホスト環境定義ファイルの待機系ノードへのコピー　

(8)　共有ディスクのアンマウント　

(9)　論理ホスト環境定義ファイルのインポート

(10)　クラスタソフトからのPFM - Agentの登録解除　

(11)　PFM - Managerでの設定の削除　

(1)　クラスタソフトからの停止[図データ]　[図データ]

クラスタソフトからの操作で，実行系ノードと待機系ノードで起動しているPerformance Managementのプログラムおよびサービスを停止してください。停止する方法については，クラスタソフトのマニュアルを参照してください。

(2)　共有ディスクのマウント[図データ]

共有ディスクがマウントされていることを確認します。共有ディスクがマウントされていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをマウントしてください。

注意

共有ディスクがアンマウントされていても，アンセットアップする論理ホストの環境ディレクトリにjp1pcディレクトリがあり，jp1pcディレクトリ以下にファイルがある場合は，共有ディスクをマウントしないでセットアップしています。この場合は次の手順で対処してください。

ローカルディスク上のアンセットアップする論理ホストの環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。

共有ディスクをマウントする。

共有ディスク上にアンセットアップする論理ホストの環境ディレクトリがない場合は，環境ディレクトリを作成する。

共有ディスク上のアンセットアップする論理ホストの環境ディレクトリにtarファイルを展開する。

共有ディスクをアンマウントする。

ローカルディスク上のアンセットアップする論理ホストの環境ディレクトリにあるjp1pcディレクトリ以下を削除する。

(3)　ポート番号の設定の解除[図データ]　[図データ]

この手順は，ファイアウォールを使用する環境で，セットアップ時にjpcnsconfig portコマンドでポート番号を設定した場合だけに必要な手順です。

ポート番号の解除方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章，およびクラスタシステムでの構築と運用について説明している章を参照してください。

(4)　PFM - Agentの論理ホストのアンセットアップ[図データ]

手順を次に示します。

注意

共有ディスクがマウントされていない状態で論理ホスト環境を削除した場合は，物理ホスト上に存在する論理ホストの設定が削除され，共有ディスク上のディレクトリやファイルは削除されません。この場合，共有ディスクをマウントして，環境ディレクトリ以下のjp1pcディレクトリを手動で削除してください。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all -lhost jp1-halora

論理ホスト環境をアンセットアップする前に，現在の設定を確認します。論理ホスト名や共有ディスクのパスなどを確認してください。

PFM - Agent for IBM WebSphere MQのインスタンス環境を削除する。
次のようにコマンドを実行します。

jpcinsunsetup agt9 -lhost jp1-halora -inst SDC1

jpcinsunsetupコマンドを実行すると，論理ホストのインスタンスを起動するための設定が削除されます。また，共有ディスク上のインスタンス用のファイルが削除されます。

jpchasetup deleteコマンドを実行して，PFM - Agent for IBM WebSphere MQの論理ホスト環境を削除する。
次のようにコマンドを実行します。

jpchasetup delete agt9 -lhost jp1-halora

jpchasetup deleteコマンドを実行すると，論理ホストのPFM - Agent for IBM WebSphere MQを起動するための設定が削除されます。また，共有ディスク上の論理ホスト用のファイルが削除されます。

jpchasetup listコマンドで，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

論理ホスト環境からPFM - Agent for IBM WebSphere MQが削除されていることを確認してください。

(5)　他Performance Managementプログラムの論理ホストのアンセットアップ[図データ]　[図データ]

PFM - Agent for IBM WebSphere MQのほかに，同じ論理ホストからアンセットアップするPerformance Managementプログラムがある場合は，この段階でアンセットアップしてください。

アンセットアップ手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(6)　論理ホスト環境定義ファイルのエクスポート[図データ]

論理ホストのPFM - Agent for IBM WebSphere MQを削除したら，環境定義をファイルにエクスポートします。

Performance Managementでは，環境定義のエクスポートおよびインポートによって実行系と待機系の環境を合わせる方式を採っています。実行系ノードでエクスポートした環境定義（Performance Managementの定義が削除されている）を，待機系ノードにインポートすると，待機系ノードの既存の環境定義（Performance Managementの定義が削除前のままの状態で定義が残っている）と比較して差分（実行系ノードで削除された部分）を確認してPerformance Managementの環境定義を削除します。

手順を次に示します。

jpchasetup exportコマンドを実行して，論理ホスト環境定義をエクスポートする。
Performance Managementの論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

jpchasetup export -f lhostexp.txt

(7)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(6)　論理ホスト環境定義ファイルのエクスポート」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

(8)　共有ディスクのアンマウント[図データ]　[図データ]

ファイルシステムをアンマウントして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，ファイルシステムをアンマウントする必要はありません。

(9)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードに反映させるためにインポートします。なお，待機系ノードでは，インポート時に共有ディスクをアンマウントする必要はありません。

手順を次に示します。

jpchasetup importコマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

jpchasetup import -f lhostexp.txt

コマンドを実行すると，待機系ノードの環境をエクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for IBM WebSphere MQを起動するための設定が削除されます。ほかの論理ホストのPerformance Managementのプログラムをアンセットアップしている場合は，それらの設定も削除されます。また，セットアップ時にjpcnsconfig portコマンドで固定のポート番号を設定している場合も，解除されます。

jpchasetup listコマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

jpchasetup list all

実行系ノードでjpchasetup listコマンドを実行したときと同じ内容が表示されることを確認してください。

(10)　クラスタソフトからのPFM - Agentの登録解除[図データ]　[図データ]

クラスタソフトから，論理ホストのPFM - Agent for IBM WebSphere MQに関する設定を削除してください。設定を削除する方法は，クラスタソフトのマニュアルを参照してください。

(11)　PFM - Managerでの設定の削除[図データ]　[図データ]

PFM - Web ConsoleでPFM - Managerにログインし，アンセットアップするPFM - Agent for IBM WebSphere MQに関連する定義を削除してください。

手順を次に示します。

PFM - Web Consoleから，エージェントを削除する。

PFM - Managerのエージェント情報を削除する。
例えば，PFM - Managerが論理ホストjp1-hal上で動作し，PFM - Agent for IBM WebSphere MQが論理ホストjp1-halora上で動作している場合，次のように指定してコマンドを実行します。

jpcctrl delete サービスID host=jp1-halora lhost=jp1-hal

サービスIDには削除するエージェントのサービスIDを指定してください。

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

PFM - Web Consoleを再起動する。
サービス情報の削除をPFM - Web Consoleで有効にするには，PFM - Managerサービスを再起動したあと，PFM - Web Consoleを再起動してください。

4.6.3　アンインストール手順

PFM - Agent for IBM WebSphere MQを実行系ノード，待機系ノードそれぞれからアンインストールします。

アンインストール手順は，非クラスタシステムの場合と同じです。手順については，「3.2.3　アンインストール手順」を参照してください。

注意

PFM - Agent for IBM WebSphere MQをアンインストールする場合は，PFM - Agent for IBM WebSphere MQをアンインストールするノードのPerformance Managementのプログラムおよびサービスをすべて停止してください。

論理ホスト環境を削除しないでPFM - Agent for IBM WebSphere MQをアンインストールした場合，環境ディレクトリが残ることがあります。その場合は，環境ディレクトリを削除してください。

4.7　PFM - Agent for IBM WebSphere MQの運用方式の変更

ここでは，クラスタシステムでPFM - Agent for IBM WebSphere MQの運用方式を変更する手順を説明します。Performance Management全体の運用方式を変更する手順の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この節の構成＞

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

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

クラスタシステムでインスタンス環境を更新したい場合は，論理ホスト名とインスタンス名を確認し，インスタンス情報を更新します。インスタンス情報の設定は，実行系ノードのPFM - Agentホストで実施します。

更新する情報については，「2.4.2　インスタンス環境の更新の設定」（Windowsの場合），または「3.4.2　インスタンス環境の更新の設定」（UNIXの場合）を参照して，あらかじめ確認してください。IBM WebSphere MQのインスタンス情報の詳細については，IBM WebSphere MQのマニュアルを参照してください。

論理ホスト名とインスタンス名を確認するには，jpchasetup listコマンドを使用します。また，インスタンス環境を更新するには，jpcinssetupコマンドを使用します。

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

論理ホスト名とインスタンス名を確認する。
更新したいインスタンス環境で動作しているPFM - Agent for IBM WebSphere MQを示すサービスキーを指定して，jpchasetup listコマンドを実行します。
例えば，PFM - Agent for IBM WebSphere MQの論理ホスト名とインスタンス名を確認したい場合，次のように指定してコマンドを実行します。

jpchasetup list agt9

設定されている論理ホスト名がjp1_WMQ，インスタンス名がWMQ1の場合，次のように表示されます。

更新したいインスタンス環境のPFM - Agent for IBM WebSphere MQのサービスが起動されている場合は，クラスタソフトからサービスを停止する。

更新したいインスタンス環境のPFM - Agent for IBM WebSphere MQを示すサービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
例えば，PFM - Agent for IBM WebSphere MQの論理ホスト名がjp1_WMQ，インスタンス名がWMQ1のインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

jpcinssetup agt9 -lhost jp1_WMQ -inst WMQ1

IBM WebSphere MQのインスタンス情報を更新する。
PFM - Agent for IBM WebSphere MQのインスタンス情報を，コマンドの指示に従って入力します。PFM - Agent for IBM WebSphere MQのインスタンス情報については，「2.4.2　インスタンス環境の更新の設定」（Windowsの場合），または「3.4.2　インスタンス環境の更新の設定」（UNIXの場合）を参照してください。現在設定されている値が表示されます（ただしSQL_PASSWORDの値は表示されません）。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

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

注意

更新できない項目の値を変更したい場合は，インスタンス環境を削除したあと，再作成してください。

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

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

この章では，PFM - Agent for IBM WebSphere MQのソリューションセットについて説明します。

＜この章の構成＞

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

アラームの記載形式

アラーム一覧

Application Exist

Channel Event

Channel Status

Current Sys Q Depth

Current User Q Depth

Inhibit Get

Inhibit Put

Open Input Count

Open Output Count

Performance Event

Q Manager Event

Q Manager Status

Uncommitted Msgs

レポートの記載形式

レポートのディレクトリ構成

レポート一覧

Queue Activity Status

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

Performance Managementでは，アラームとレポートを定義する場合，次の方法があります。

PFM - Agentで定義されているアラームやレポートをそのまま使用する

PFM - Agentで定義されているアラームやレポートをコピーしてカスタマイズする

ウィザードを使用して新規に定義する

PFM - Agentで用意されているアラームやレポートを「ソリューションセット」と呼びます。ソリューションセットのレポートとアラームは，必要な情報があらかじめ定義されているので，コピーしてそのまま使用したり，ユーザーの環境に合わせてカスタマイズしたりできます。そのため，ウィザードを使用して新規に定義をしなくても，監視対象の運用状況を監視する準備が容易にできるようになります。

この章では，PFM - Agent for IBM WebSphere MQで定義されているソリューションセットのアラームとレポートの設定内容について説明します。

ソリューションセットの使用方法の詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働分析のためのレポートの作成またはアラームによる稼働監視について説明している章を参照してください。

アラームの記載形式

ここでは，アラームの記載形式を示します。アラームは，アルファベット順に記載しています。

アラーム名

ソリューションセットのアラーム名を示します。

概要

このアラームで監視できる監視対象の概要について説明します。

主な設定

このアラームの主な設定値を表で説明します。この表では，アラームの設定値と，PFM - Web Consoleの［アラーム階層］画面でアラームアイコンをクリックし，［プロパティの表示］メソッドをクリックしたときに表示される，［プロパティ］画面の設定項目との対応を示しています。各アラームの設定の詳細については，PFM - Web Consoleのアラームの［プロパティ］画面で確認してください。

設定値の「－」は，設定が常に無効であることを示します。

なお，条件式で異常条件と警告条件が同じ場合は，アラームイベントは異常のものだけが発行されます。

関連レポート

このアラームに関連する，ソリューションセットのレポートを示します。PFM - Web Consoleの［エージェント階層］画面でエージェントアイコンをクリックし，［アラームの状態の表示］メソッドで表示される[図データ]アイコンをクリックすると，このレポートを表示できます。

アラーム一覧

PFM - Agent for IBM WebSphere MQのソリューションセットで定義されているアラームは，「PFM IBMWebSphereMQ Solution Alarms 8.50」というアラームテーブルにまとめられています。「8.50」は，アラームテーブルのバージョンを示し，PFM - Agent for IBM WebSphere MQのバージョンとともに変化します。PFM - Agent for IBM WebSphere MQのバージョンとアラームテーブルのバージョンの関係は，「付録I　バージョン互換」を参照してください。このアラームテーブルは，PFM - Web Consoleの［アラーム階層］タブに表示される「IBMWebSphereMQ」ディレクトリに格納されています。ソリューションセットで定義されているアラームをアルファベット順で次の表に示します。

表5-1　アラーム一覧（ソリューションセット）

アラーム名 | 監視対象 | 監視目的
Application Exist | アプリケーションの存在 | 稼働状況監視
Channel Event | チャネルイベントの存在 | 性能情報監視
Channel Status | チャネルの状況 | 稼働状況監視
Current Sys Q Depth | システムキューに入っているメッセージの使用率 | 性能情報監視
Current User Q Depth | ユーザーキューに入っているメッセージの使用率 | 性能情報監視
Inhibit Get | メッセージをキューから読み取るための権限 | 稼働状況監視
Inhibit Put | メッセージをキューに書き込むための権限 | 稼働状況監視
Open Input Count | オープン入力カウント | 性能情報監視
Open Output Count | オープン出力カウント | 性能情報監視
Performance Event | パフォーマンスイベントの存在 | 性能情報監視
Q Manager Event | キューマネージャーイベントの存在 | 性能情報監視
Q Manager Status | キューマネージャーの状況 | 稼働状況監視
Uncommitted Msgs | 未コミットメッセージ | 性能情報監視

PFM - Agent for IBM WebSphere MQでは，ソリューションセットとして，システムが正常に運用しているかどうかを監視する稼働情報監視のアラームと，システムが十分なサービスを提供しているかどうかを監視する性能情報監視のアラームを提供しています。目的に合わせて必要なアラームを設定してください。

Application Exist

概要

Application Existアラームは，キューにアプリケーションがアクセスしているかどうかを監視します。必要なアプリケーションが常に動作していることを確認する場合に，このアラームを利用します。特定のアプリケーションを監視する場合，このアラームをコピーし，"*"を監視するアプリケーション名に変更したアラームを作成してください。

Windowsの場合，アプリケーション名は，対象アプリケーションの実行ファイル名を絶対パスで指定してください。ただし，絶対パスが28バイトを超える場合，後ろの28バイトを指定してください。

例えば，「C:¥Program Files¥IBM¥Eclipse SDK30¥eclipse¥jre¥bin¥javaw.exe」の場合には，「30¥eclipse¥jre¥bin¥javaw.exe」を指定してください。

UNIXの場合，アプリケーション名は，対象アプリケーションの実行ファイル名を指定してください。ディレクトリパスは指定しないでください。ただし，実行ファイル名が27バイトを超える場合，後ろの27バイトを指定してください。

主な設定

PFM - Web Consoleのアラームのプロパティ | 設定値
項目 | 詳細項目
基本情報 | 発生頻度を満たした時にアラーム通知する | しない
インターバル中 | －
回しきい値超過 | －
アクション | SNMP | 異常，警告，正常
条件式 | 値の存在を監視するアラームとする | する
レコード | Queue Handle Status (PD_QHS)
フィールド | Appl Tag
値 | "*"

関連レポート

なし

Channel Event

概要

Channel Eventアラームは，チャネルイベントの存在を監視します。チャネルが開始，または停止するなどのチャネル上で特定の条件を検出した場合に，キューマネージャーはチャネルイベントを生成できます。このチャネルイベントが生成されたことを確認する場合に，このアラームを利用します。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Status (PD_QS)

フィールド
Current Q Depth , Q Name

異常条件
Q Name =
"SYSTEM.ADMIN.CHANNEL.EVENT"
AND
Current Q Depth > 0

警告条件
Q Name =
"SYSTEM.ADMIN.CHANNEL.EVENT"
AND
Current Q Depth > 0

関連レポート

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/Queue Activity Status

Channel Status

概要

Channel Statusアラームは，チャネルの状況を監視します。チャネルを稼働状態にするには，開始命令などユーザーの操作が必要となる場合は異常状態となります。チャネルが動作していることを確認する場合に，このアラームを利用します。デフォルトではすべてのチャネルの状況を監視します。特定のチャネルの状況を監視する場合，このアラームをコピーし，"*"を監視するチャネル名に変更したアラームを作成してください。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Channel Status (PD_CS)

フィールド
Channel Name , Channel Status

異常条件
Channel Name = "*"
AND
Channel Status <> "MQCHS_BINDING"
AND
Channel Status <>
"MQCHS_STARTING" AND
Channel Status <>
"MQCHS_RUNNING" AND
Channel Status <>
"MQCHS_REQUESTING"

警告条件
Channel Name = "*"
AND
Channel Status <> "MQCHS_BINDING"
AND
Channel Status <>
"MQCHS_STARTING" AND
Channel Status <>
"MQCHS_RUNNING" AND
Channel Status <>
"MQCHS_REQUESTING"

関連レポート

なし

Current Sys Q Depth

概要

Current Sys Q Depthアラームは，システムキューに入れることができるメッセージの最大数に対するシステムキューの使用率(%)を監視します。システムキューの使用率がしきい値を超えないことを監視する場合に，このアラームを利用します。デフォルトではすべてのシステムキューの使用率を監視します。特定のキューの使用率を監視する場合，このアラームをコピーし，"SYSTEM.*"を監視するキュー名に変更したアラームを作成してください。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Status（PD_QS）

フィールド
Q Name , Q Depth %

異常条件
Q Name = "SYSTEM.*"
AND
Q Depth % > 90

警告条件
Q Name = "SYSTEM.*"
AND
Q Depth % > 10

関連レポート

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/Queue Activity Status

Current User Q Depth

概要

Current User Q Depthアラームは，ユーザーキューに入れることができるメッセージの最大数に対するユーザーキューの使用率(%)を監視します。ユーザーキューの使用率がしきい値を超えないことを監視する場合に，このアラームを利用します。デフォルトではすべてのユーザーキューの使用率を監視します。特定のキューの使用率を監視する場合，このアラームではなく，Current Sys Q Depthアラームをコピーし，"SYSTEM.*"を監視するキュー名に変更したアラームを作成してください。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Status（PD_QS）

フィールド
Q Name , Q Depth %

異常条件
Q Name <> "SYSTEM.*"
AND
Q Depth % > 90

警告条件
Q Name <> "SYSTEM.*"
AND
Q Depth % > 10

関連レポート

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/Queue Activity Status

Inhibit Get

概要

Inhibit Getアラームは，メッセージをキューから読み取るための権限を監視します。特定のキューが読み取り権限を持つことを監視する場合に，このアラームを利用します。デフォルトではすべてのキューの読み取り権限を監視します。特定のキューの読み取り権限を監視する場合，このアラームをコピーし，"*"を監視するキュー名に変更したアラームを作成してください。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Status（PD_QS）

フィールド
Q Name , Inhibit Get

異常条件
Q Name = "*"
AND
Inhibit Get =
"MQQA_GET_INHIBITED"

警告条件
Q Name = "*"
AND
Inhibit Get =
"MQQA_GET_INHIBITED"

関連レポート

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/Queue Activity Status

Inhibit Put

概要

Inhibit Putアラームは，メッセージをキューに書き込むための権限を監視します。特定のキューが書き込み権限を持つことを監視する場合に，このアラームを利用します。デフォルトではすべてのキューの書き込み権限を監視します。特定のキューの書き込み権限を監視する場合，このアラームをコピーし，"*"を監視するキュー名に変更したアラームを作成してください。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Status（PD_QS）

フィールド
Q Name , Inhibit Put

異常条件
Q Name = "*"
AND
Inhibit Put =
"MQQA_PUT_INHIBITED"

警告条件
Q Name = "*"
AND
Inhibit Put =
"MQQA_PUT_INHIBITED"

関連レポート

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/Queue Activity Status

Open Input Count

概要

Open Input Countアラームは，オープン入力カウントを監視します。キューからメッセージを入力するためにキューにアクセスしているアプリケーションの数が，しきい値を超えないことを監視する場合に，このアラームを利用します。

主な設定

PFM - Web Consoleのアラームのプロパティ | 設定値
項目 | 詳細項目
基本情報 | 発生頻度を満たした時にアラーム通知する | しない
インターバル中 | －
回しきい値超過 | －
アクション | SNMP | 異常，警告，正常
条件式 | レコード | Queue Status（PD_QS）
フィールド | Open Input Count
異常条件 | Open Input Count > 20
警告条件 | Open Input Count > 10

関連レポート

なし

Open Output Count

概要

Open Output Countアラームは，オープン出力カウントを監視します。キューへメッセージを出力するためにキューにアクセスしているアプリケーションの数が，しきい値を超えないことを監視する場合に，このアラームを利用します。

主な設定

PFM - Web Consoleのアラームのプロパティ | 設定値
項目 | 詳細項目
基本情報 | 発生頻度を満たした時にアラーム通知する | しない
インターバル中 | －
回しきい値超過 | －
アクション | SNMP | 異常，警告，正常
条件式 | レコード | Queue Status（PD_QS）
フィールド | Open output Count
異常条件 | Open output Count > 20
警告条件 | Open output Count > 10

関連レポート

なし

Performance Event

概要

Performance Eventアラームは，パフォーマンスイベントの存在を監視します。キューに入っているメッセージの数がしきい値に達したなど，リソースがしきい値条件に達した場合，キューマネージャーはパフォーマンスイベントを生成できます。パフォーマンスイベントが生成されたことを確認する場合に，このアラームを利用します。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Status (PD_QS)

フィールド
Current Q Depth , Q Name

異常条件
Q Name =
"SYSTEM.ADMIN.PERFM.EVENT"
AND
Current Q Depth > 0

警告条件
Q Name =
"SYSTEM.ADMIN.PERFM.EVENT"
AND
Current Q Depth > 0

関連レポート

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/Queue Activity Status

Q Manager Event

概要

Q Manager Eventアラームは，キューマネージャーイベントの存在を監視します。キューの書き込み権限を変更するなど，キューマネージャーに関する操作を行った場合，キューマネージャーはキューマネージャーイベントを生成できます。キューマネージャーイベントが生成されたことを確認する場合に，このアラームを利用します。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Status (PD_QS)

フィールド
Current Q Depth , Q Name

異常条件
Q Name =
"SYSTEM.ADMIN.QMGR.EVENT"
AND
Current Q Depth > 0

警告条件
Q Name =
"SYSTEM.ADMIN.QMGR.EVENT"
AND
Current Q Depth > 0

関連レポート

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/Queue Activity Status

Q Manager Status

概要

Q Manager Statusアラームは，キューマネージャーの状況を監視します。キューマネージャーが動作していることを確認する場合に，このアラームを利用します。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Manager Status (PD)

フィールド
Q Mgr Status

異常条件
Q Mgr Status <>
"MQQMSTA_RUNNING"

警告条件
Q Mgr Status <>
"MQQMSTA_RUNNING"

関連レポート

なし

Uncommitted Msgs

概要

Uncommitted Msgsアラームは，未コミットメッセージを監視します。未コミットメッセージが存在するかどうかを確認する場合に，このアラームを利用します。デフォルトではすべてのキューの未コミットメッセージを監視します。特定のキューの未コミットメッセージを監視する場合，このアラームをコピーし，"*"を監視するキュー名に変更したアラームを作成してください。

主な設定

PFM - Web Consoleのアラームのプロパティ
設定値

項目
詳細項目

基本情報
発生頻度を満たした時にアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
SNMP
異常，警告，正常

条件式
レコード
Queue Status（PD_QS）

フィールド
Q Name , Uncommitted Msgs

異常条件
Q Name = "*"
AND
Uncommitted Msgs = "MQQSUM_YES"

警告条件
Q Name = "*"
AND
Uncommitted Msgs = "MQQSUM_YES"

関連レポート

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/Queue Activity Status

レポートの記載形式

ここでは，レポートの記載形式を示します。レポートは，アルファベット順に記載しています。

レポート名

ソリューションセットのレポート名を示します。

レポート名に「(Multi-Agent)」が含まれるレポートは，複数のインスタンスについて情報を表示するレポートです。

レポート名に「(Multi-Agent)」が含まれないレポートは，単一のインスタンスについて情報を表示するレポートです。

データモデルについては，「6.　レコード」を参照してください。

概要

このレポートで表示できる情報の概要について説明します。

格納先

このレポートの格納先を示します。

レコード

このレポートで使用するパフォーマンスデータが，格納されているレコードを示します。履歴レポートを表示するためには，この欄に示すレコードを収集するように，あらかじめ設定しておく必要があります。レポートを表示する前に，PFM - Web Consoleの［エージェント階層］画面でエージェントのプロパティを表示して，このレコードが「Log = Yes」に設定されているか確認してください。リアルタイムレポートの場合，設定する必要はありません。

フィールド

このレポートで使用するレコードのフィールドについて，表で説明します。

レポートのディレクトリ構成

PFM - Agent for IBM WebSphere MQのレポートのディレクトリフォルダ構成を次に示します。<　>内は，ディレクトリ名を示します。

<IBMWebSphereMQ>
+-- <Monthly Trend>
+-- <Status Reporting>
|   +-- <Daily Trend>
|   +-- <Real-Time>
|       +-- Queue Activity Status
+-- <Troubleshooting>
    +-- <Real-Time>
    +-- <Recent Past>

各ディレクトリの説明を次に示します。

「Monthly Trend」ディレクトリ
最近1か月間の1日ごとに集計された情報を表示するレポートが格納されています。1か月のシステムの傾向を分析するために使用します。

「Status Reporting」ディレクトリ
日ごとに集計された情報を表示するレポートが格納されています。システムの総合的な状態を見るために使用します。また，履歴レポートのほかにリアルタイムレポートの表示もできます。

「Daily Trend」ディレクトリ
最近24時間の1時間ごとに集計された情報を表示する履歴レポートが格納されています。1日ごとにシステムの状態を確認するために使用します。

「Real-Time」ディレクトリ
システムの状態を確認するためのリアルタイムレポートが格納されています。

「Troubleshooting」ディレクトリ
トラブルを解決するのに役立つ情報を表示するレポートが格納されています。システムに問題が発生した場合，問題の原因を調査するために使用します。

「Real-Time」ディレクトリ
現在のシステムの状態を確認するためのリアルタイムレポートが格納されています。

「Recent Past」ディレクトリ
最近1時間の1分ごとに集計された情報を表示する履歴レポートが格納されています。

さらに，これらのディレクトリの下位には，次のディレクトリがあります。上位のディレクトリによって，どのディレクトリがあるかは異なります。各ディレクトリについて次に説明します。

「Advanced」ディレクトリ
デフォルトで「Log = No」に設定されているレコードを使用しているレポートが格納されています。このディレクトリのレポートを表示するには，使用しているレコードの設定をPFM - Web Consoleで「Log = Yes」にする必要があります。

「Drilldown Only」ディレクトリ
ドリルダウンレポート（フィールドレベル）として表示されるレポートが格納されています。そのレポートのフィールドに関連する詳細な情報を表示するために使用します。

レポート一覧

ソリューションセットで定義されているレポートをアルファベット順に次の表に示します。

表5-2　レポート一覧

カテゴリー | レポート名 | 表示する情報
システム | Queue Activity Status | キューの稼働状況

Queue Activity Status

概要

Queue Activity Statusレポートは，キューの稼働状況をリアルタイムで表示します。

格納先

Reports/IBMWebSphereMQ/StatusReporting/Real-Time/

レコード

Queue Status (PD_QS)

フィールド

フィールド名
説明

Current Q Depth
現在キューに入っているメッセージの数。

Oldest Msg Age
キューにある最も古いメッセージの経過日数(秒)。最大表示可能値は999,999,999です。この値を上回ると 999,999,999が表示されます。値を取得できない場合，このフィールドの値は-1になります。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，-1になります。

On Q Time Long
メッセージがキューに書き込まれてから，読み取られて破棄されるまでの間隔(マイクロ秒)。長期インターバルで取得した平均値。最大表示可能値は999,999,999です。この値を上回ると999,999,999が表示されます。値を取得できない場合，このフィールドの値は-1になります。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，-1になります。

On Q Time Short
メッセージがキューに書き込まれてから，読み取られて破棄されるまでの間隔(マイクロ秒)。短期インターバルで取得した平均値。最大表示可能値は999,999,999です。この値を上回ると999,999,999が表示されます。値を取得できない場合，このフィールドの値は-1になります。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，-1になります。

Q Depth %
キューに入れることができるメッセージの最大数に対するキューの使用率(%)。

Q Name
キュー名。

Queue Monitoring
現在のキューのモニターデータ収集レベル。有効な値は次のとおり。

MQMON_HIGH

高率でデータを収集する。

MQMON_LOW

低率でデータを収集する。

MQMON_MEDIUM

中率でデータを収集する。

MQMON_OFF

データが収集されない。

Uncommitted Msgs
コミットされていない変更があるかどうかを示します。

MQQSUM_NO

コミットされていない変更がない。

MQQSUM_YES

コミットされていない変更がある。

6.　レコード

この章では，PFM - Agent for IBM WebSphere MQのレコードについて説明します。各レコードのパフォーマンスデータの収集方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの機能について説明している章を参照してください。

＜この章の構成＞

データモデルについて

レコードの記載形式

ODBCキーフィールド一覧

要約ルール

データ型一覧

フィールドの値

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

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールド

レコードの注意事項

レコード一覧

Channel Status（PD_CS）

Channel Status Interval（PI_CSI）

Queue Handle Status（PD_QHS）

Queue Manager Status（PD）

Queue Manager Status Interval（PI）

Queue Status（PD_QS）

データモデルについて

各PFM - Agentが持つレコードおよびフィールドの総称を「データモデル」と呼びます。各PFM - Agentと，そのPFM - Agentが持つデータモデルには，それぞれ固有のバージョン番号が与えられています。PFM - Agent for IBM WebSphere MQのバージョンとデータモデルのバージョンの関係は，「付録I　バージョン互換」を参照してください。

各PFM - Agentのデータモデルのバージョンは，PFM - Web Consoleの［エージェント階層］画面でエージェントのプロパティを表示して確認してください。

データモデルについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの機能について説明している章を参照してください。

レコードの記載形式

この章では，PFM - Agent for IBM WebSphere MQのレコードをアルファベット順に記載しています。各レコードの説明は，次の項目から構成されています。

機能

各レコードに格納されるパフォーマンスデータの概要および注意事項について説明します。

デフォルト値および変更できる値

各レコードに設定されているパフォーマンスデータの収集条件のデフォルト値およびユーザーが変更できる値を表で示します。「デフォルト値および変更できる値」に記載している項目とその意味を次の表に示します。この表で示す各項目については，マニュアル「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 - View名）を示します。

PFM - Manager名
PFM - Managerで，SQLを使用してStoreデータベースに格納されているフィールドのデータを利用する場合，SQL文で記述するフィールド名（PFM - Manager名）を示します。
SQL文では，先頭に各レコードのレコードIDを付加した形式で記述します。例えば，System Stat Summary（PD）レコードのDisk Sorts（SORTS_DISK）フィールドの場合，「PD_SORTS_DISK」と記述します。

説明
各フィールドに格納されるパフォーマンスデータについて説明します。
各フィールドのパフォーマンスデータの求め方には，次の種類があります。

今回収集したデータと前回のインターバルで収集したデータによって求められた平均や割合を求めるもの。

今回収集したデータたけで求められるのもの。

ほかのフィールドのデータから求めるもの（各レコードのフィールドの表にある「データソース」参照）。

特に断り書きがない場合，データの収集間隔によって求められる値となります。
履歴レポートで，PIレコードタイプのレコードを，レポート間隔に「分」以外を設定して要約した場合に表示される値には，次の種類があります。

要約した間隔の平均値を表示するもの。

最後に収集した値を表示するもの。

合計値を表示するもの。

最小値を表示するもの。

最大値を表示するもの。

特に断り書きがないフィールドの値は，要約した間隔の平均値が表示されます。

要約
Agent Storeがデータを要約するときの要約方法（ルール）を示します。要約ルールについては，この章の「要約ルール」を参照してください。

形式
double型など，各フィールドの値のデータ型を示します。データ型については，この章の「データ型一覧」を参照してください。

デルタ
累積値として収集するデータに対し，変化量でデータを表すことを「デルタ」と呼びます。デルタについては，この章の「フィールドの値」を参照してください。

サポートバージョン
そのフィールドを使用できるIBM WebSphere MQのバージョン番号を示します。
バージョン番号が記述してある場合，そのバージョン以降でそのフィールドが使用できます。「すべて」と記述してある場合，すべてのIBM WebSphere MQのバージョンで使用できます。「対象外」と記述してある場合，サポート対象外のフィールドであることを示します。

データソース
該当するフィールドの値の計算方法または取得先を示します。フィールドの値については，この章の「フィールドの値」を参照してください。

ODBCキーフィールド一覧

ODBCキーフィールドには，各レコード共通のものと各レコード固有のものとがあります。ここで示すのは，各レコード共通のODBCキーフィールドです。PFM - Managerで，SQLを使用してStoreデータベースに格納されているレコードのデータを利用する場合，ODBCキーフィールドが必要です。

各レコード共通のODBCキーフィールド一覧を次の表に示します。各レコード固有のODBCキーフィールドについては，各レコードの説明を参照してください。

表6-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
内部
レコードが生成された時刻（グリニッジ標準時）。

要約ルール

PIレコードタイプのレコードでは，Collection Intervalに設定された間隔で収集されるデータと，あらかじめ定義されたルールに基づき一定の期間（分，時，日，週，月，または年単位）ごとに要約されたデータが，Storeデータベースに格納されます。要約の種類はフィールドごとに定義されています。この定義を「要約ルール」と呼びます。

要約ルールによっては，要約期間中の中間データを保持する必要のあるものがあります。この場合，中間データを保持するためのフィールドがStoreデータベース内のレコードに追加されます。このフィールドを「追加フィールド」と呼びます。追加フィールドの一部は，PFM - Web Consoleでレコードのフィールドとして表示されます。PFM - Web Consoleに表示される追加フィールドは，履歴レポートに表示するフィールドとして使用できます。

なお，要約によって追加される「追加フィールド」と区別するために，ここでは，この章の各レコードの説明に記載されているフィールドを「固有フィールド」と呼びます。

追加フィールドのフィールド名は次のようになります。

Storeデータベースに格納される追加フィールド名
固有フィールドのPFM - Manager名にサフィックスが付加されたフィールド名になります。

PFM - Web Consoleで表示される追加フィールド名
固有フィールドのPFM - View名にサフィックスが付加されたフィールド名になります。

PFM - Manager名に付加されるサフィックスと，それに対応するPFM - View名に付加されるサフィックス，およびフィールドに格納されるデータを次の表に示します。

表6-2　追加フィールドのサフィックス一覧

PFM - Manager名に付加されるサフィックス | PFM - View名に付加されるサフィックス | 格納データ
_TOTAL | (Total) | 要約期間内のレコードのフィールドの値の総和
_COUNT | － | 要約期間内の収集レコード数
_HI | (Max) | 要約期間内のレコードのフィールド値の最大値
_LO | (Min) | 要約期間内のレコードのフィールド値の最小値

（凡例）

－：追加フィールドがないことを示します。

要約ルールの一覧を次の表に示します。

表6-3　要約ルール一覧

要約
ルール名
要約ルール

COPY
要約期間内の最新のレコードのフィールド値がそのまま格納される。

AVG
要約期間内のフィールド値の平均値が格納される。
次に計算式を示す。

(フィールド値の総和)/(収集レコード数)

追加フィールド（Storeデータベース）

_TOTAL

_COUNT

追加フィールド（PFM - Web Console）

(Total)

HILO
要約期間内のデータの最大値，最小値，および平均値が格納される。
固有フィールドには平均値が格納される。
次に計算式を示す。

(フィールド値の総和)/(収集レコード数)

追加フィールド（Storeデータベース）

_HI

_LO

_TOTAL

_COUNT

追加フィールド（PFM - Web Console）

(Max)

(Min)

(Total)

－
要約されないことを示す。

データ型一覧

各フィールドの値のデータ型と，対応するCおよびC++のデータ型の一覧を次の表に示します。この表で示す「データ型」の「フィールド」の値は，各レコードのフィールドの表にある「形式」の列に示されています。

表6-4　データ型一覧

データ型
サイズ
（バイト）

説明

フィールド
CおよびC++

char(n)
char( )
1
文字データ(0x20～0x7e)。

double
double
8
数値（1.7E±308（15桁））。

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）。

ushort
unsigned short
2
数値（0～65,535）。

utime
構造体
8
数値（最初の4バイトは秒，次の4バイトはマイクロ秒を表す）。

word
unsigned short
2
数値（0～65,535）。

（該当なし）
unsigned char
1
数値（0～255）。

フィールドの値

ここでは，各フィールドに格納される値について説明します。

データソース

各フィールドには，Performance Managementや監視対象プログラムから取得した値や，これらの値をある計算式に基づいて計算した値が格納されます。各フィールド値の取得先または計算方法は，フィールドの表の「データソース」列で示します。

PFM - Agent for IBM WebSphere MQの「データソース」列の文字列の意味は，この章の「レコードの記載形式」を参照してください。

デルタ

累積値として収集するデータに対し，変化量でデータを表すことを「デルタ」と呼びます。例えば，1回目に収集されたパフォーマンスデータが「3」，2回目に収集されたパフォーマンスデータが「4」とすると，累積値の場合は「7」，変化量の場合は「1」が格納されます。各フィールドの値がデルタ値かどうかは，フィールドの表の「デルタ」列で示します。PFM - Agent for IBM WebSphere MQで収集されるパフォーマンスデータは，次の表のように異なります。

なお，デルタの値は，前回のデータからの相対値のため，マイナス値になる場合があります。

レコードタイプ
デルタ
データ種別
[デルタ値で表示］のチェック※
レコードの値

PIレコードタイプ
Yes
リアルタイムデータ
あり
変化量が表示される。

なし
変化量が表示される。

・履歴データ
・アラームの監視データ
－
変化量が表示される。

No
リアルタイムデータ
あり
収集時点の値が表示される。

なし
収集時点の値が表示される。

・履歴データ
・アラームの監視データ
－
収集時点の値が表示される。

PDレコードタイプ
Yes
リアルタイムデータ
あり
変化量が表示される。

なし
累積値が表示される。

・履歴データ
・アラームの監視データ
－
累積値が表示される。

No
リアルタイムデータ
あり
収集時点の値が表示される。

なし
収集時点の値が表示される。

・履歴データ
・アラームの監視データ
－
収集時点の値が表示される。

（凡例）

－：該当しない

注※

次に示すPFM - Web Consoleのダイアログボックスの項目でチェックされていることを示します。

レポートウィザードの［編集 > 表示設定（リアルタイムレポート）］画面の［デルタ値で表示］

レポートウィンドウの［Properties］タブの［表示設定（リアルタイムレポート）］の［デルタ値で表示］

パフォーマンスデータが収集される際の注意事項を次に示します。

PIレコードタイプのレコードが保存されるためには，2回以上パフォーマンスデータが収集されている必要があります。
PIレコードタイプのレコードには，PFM - Web Consoleで設定した収集間隔ごとにパフォーマンスデータが収集されます。しかし，パフォーマンスデータのStoreデータベースへの格納は，PFM - Web Consoleでパフォーマンスデータの収集の設定をした時点では実行されません。
PIレコードタイプの履歴データには，前回の収集データとの差分を必要とするデータ（デルタ値）が含まれているため，2回分のデータが必要になります。このため，履歴データがStoreデータベースに格納されるまでには，設定した時間の最大2倍の時間が掛かります。
例えば，PFM - Web Consoleでパフォーマンスデータの収集間隔を，18:32に300秒（5分）で設定した場合，最初のデータ収集は18:35に開始されます。次のデータ収集は18:40に開始されます。履歴のデータは，18:35と18:40に収集されたデータを基に作成され，18:40に（設定時18:32から8分後）履歴データとしてStoreデータベースに格納されます。

リアルタイムレポートには，最初にデータが収集されたときから値が表示されます。
ただし，前回のデータを必要とするレポートの場合，初回の値は0で表示されます。2回目以降のデータ収集は，レポートによって動作が異なります。

次の場合，2回目のデータ収集以降は，収集データの値が表示されます。

PIレコードタイプのリアルタイムレポートの設定で，［デルタ値で表示］がチェックされていない場合

PDレコードタイプのリアルタイムレポートの設定で，［デルタ値で表示］がチェックされている場合

次の場合，2回目のデータ収集では，1回目のデータと2回目のデータの差分が表示されます。3回目以降のデータ収集では，収集データの値が表示されます。

PIレコードタイプのリアルタイムレポートの設定で，［デルタ値で表示］がチェックされている場合

PFM - Agent for IBM WebSphere MQ起動中，監視対象のチャネルの再起動などが行われると，収集データの値が「マイナス値」となる場合があります。しかし，2回目以降のデータに関しては，データの差分として，0以上の値となります。

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）
レコードが作成された日。グリニッジ標準時。※１
char(3)
No
すべて
－

Date and Time
（DATETIME）
Date（DATE）フィールドとTime（TIME）フィールドの組み合わせ。
char(6)
No
すべて
－

Drawer Type
（DRAWER_TYPE）
PIレコードタイプのレコードの場合，データが要約される区分。PFM - Web Consoleのレポートで表示する場合とODBCドライバを使用して表示する場合とで，区分の表示が異なる。※2
char
No
すべて
－

GMT Offset
（GMT_ADJUST）
グリニッジ標準時とローカル時間の差。秒単位。
long
No
すべて
－

Time
（TIME）
レコードが作成された時刻。グリニッジ標準時。※1
char(3)
No
すべて
－

（凡例）

－：IBM WebSphere MQから取得したパフォーマンスデータを加工してフィールドの値を設定していないことを意味する。

注※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

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールド

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールドjpcctrl dumpコマンドで，Storeデータベースに格納されているデータをエクスポートすると，次に示すフィールドが出力されます。これらのフィールドも，Storeデータベースに記録されるとき追加されるフィールドですが，PFM - Web Consoleでは表示されないため，レポートに表示するフィールドとして使用できません。これらのフィールドは，PFM - Agentが内部で使用するフィールドなので，運用では使用しないでください。

レコード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

レコードの注意事項

レコードを収集する場合の注意事項を次に示します。

データを取得できない場合のレコード生成結果

フィールドに格納するデータを取得できない場合のレコード生成結果について説明します。

レコードが生成されない

次の場合，レコードは生成されません。

ODBCキーフィールドとして定義されたフィールドに格納するパフォーマンスデータをPFM - Agent for IBM WebSphere MQが収集できない場合

一部のフィールドが空白，または-1になる

各フィールド値の組み合わせによって，IBM WebSphere MQが一部のフィールドの値を出力しない場合があります。この場合，フィールドが文字列の場合は空白，数値の場合は-1になります。

(例)

IBM WebSphere MQ エクスプローラーの「コンテンツ」ビューに，キューの内容を表示させたときに，「キュー・タイプ」が「リモート」である場合，現行キュー項目数が表示されません。この場合，PD_QSレコードのCurrent Q Depthフィールドは-1になります。

レコード一覧

PFM - Agent for IBM WebSphere MQで収集できるレコードおよびそのレコードに格納される情報を，次の表に示します。

表6-5　PFM - Agent for IBM WebSphere MQのレコード一覧

レコード名 | レコードID | 格納される情報
Channel Status | PD_CS | チャネルについての，ある時点での状態を示すパフォーマンスデータが格納されます。
Channel Status Interval | PI_CSI | チャネルについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。
Queue Handle Status | PD_QHS | キューにアクセスしているハンドルについての，ある時点での状態を示すパフォーマンスデータが格納されます。
Queue Manager Status | PD | キューマネージャーについての，ある時点での状態を示すパフォーマンスデータが格納されます。
Queue Manager Status Interval | PI | 予約レコードのため，使用できません。
Queue Status | PD_QS | キューについての，ある時点での状態を示すパフォーマンスデータが格納されます。

Channel Status（PD_CS）

機能

Channel Status (PD_CS)レコードには，チャネルについての，ある時点での状態を示すパフォーマンスデータが格納されます。このレコードは，複数インスタンスレコードです。

注意

監視対象のキューマネージャー，またはコマンドサーバが実行中でない場合，情報を収集できません。

Channel Monitoringフィールドの値が「MQMON_OFF」の場合，以下のフィールドはデータの収集に失敗します。
・Compression Time Long
・Compression Time Short

Channel Statusフィールドの値がCHS_INACTIVEである場合，以下のフィールド以外は情報を収集できません。
・Record Type
・Record Time
・Interval
・Channel Status
・Channel Name
・Channel Type
・Connection Name
・MCA User Identifier

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PD_CS_CHANNEL_NAME

ライフタイム

チャネルの作成から削除まで。

レコードサイズ

固定部：681バイト

可変部：1,224バイト

フィールド

PFM-View名
（PFM-Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Record Type（INPUT_RECORD_TYPE）
レコード名。常に「CS」。
－
char(8)
No
すべて
－

Record Time（RECORD_TIME）
レコードが作成された時刻。
－
time_t
No
すべて
－

Interval（INTERVAL）
常に「0」。
－
ulong
No
すべて
－

Channel Name（CHANNEL_NAME）
チャネル名。
－
string(32)
No
すべて
Inquire Channel

Batches（BATCHES）
完了したバッチの数。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
－
double
No
すべて
Inquire Channel Status

Buffers Received（BUFFERS_RECEIVED）
受信したバッファ数。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
－
double
No
すべて
Inquire Channel Status

Buffers Sent（BUFFERS_SENT）
送信したバッファ数。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
－
double
No
すべて
Inquire Channel Status

Bytes Received（BYTES_RECEIVED）
受信されたバイト数。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
－
double
No
すべて
Inquire Channel Status

Bytes Sent（BYTES_SENT）
送信されたバイト数。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
－
double
No
すべて
Inquire Channel Status

Channel Monitoring（CHANNEL_MONITORING）
現在のチャネルのモニターデータ収集レベル。有効な値は次のとおり。

MQMON_HIGH

高率でデータを収集します。

MQMON_LOW

低率でデータを収集します。

MQMON_MEDIUM

中率でデータを収集します。

MQMON_OFF

データが収集されません。

－
string(32)
No
すべて
Inquire Channel Status

Channel Status（CHANNEL_STATUS）
チャネル状況。有効な値は次のとおり。

CHS_INACTIVE

チャネルは，非アクティブです。

MQCHS_BINDING

チャネルは，パートナーと対話中です。

MQCHS_INITIALIZING

チャネルは，初期化中です。

MQCHS_PAUSED

チャネルは，休止しています。

MQCHS_REQUESTING

要求側チャネルは，接続を要求中です。

MQCHS_RETRYING

チャネルは，接続の確立を再試行中です。

MQCHS_RUNNING

チャネルは，メッセージの転送中またはメッセージを待機中です。

MQCHS_STARTING

チャネルは，活動状態になるまで待機中です。

MQCHS_STOPPED

チャネルは，停止しています。

MQCHS_STOPPING

チャネルは，停止処理中です。

注意

値がCHS_INACTIVEの場合，このレコードの次に示すフィールド以外は，常に(1)(2)のどちらかの値となります。

・Record Type

・Record Time

・Interval

・Channel Name

・Channel Type

・Connection Name

・MCA User Identifier

(1)数値型のフィールドは「-1」

(2)文字列型のフィールドは空白

－
string(32)
No
すべて
Inquire Channel Status

Channel Type（CHANNEL_TYPE）
チャネル・タイプ。有効な値は次のとおり。

MQCHT_CLNTCONN

クライアント接続。

MQCHT_CLUSRCVR

クラスター受信側。

MQCHT_CLUSSDR

クラスター送信側。

MQCHT_RECEIVER

受信側。

MQCHT_REQUESTER

要求側。

MQCHT_SENDER

送信側。

MQCHT_SERVER

サーバ。

MQCHT_SVRCONN

サーバ接続（クライアント用）。

－
string(32)
No
すべて
Inquire Channel

Compression Time Long（COMPRESSION_TIME_LONG）
メッセージごとに圧縮または解凍時に要する時間(マイクロ秒)。長期インターバルで取得した平均値。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。

注意

Channel Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，「0」になります。

－
double
No
すべて
Inquire Channel Status

Compression Time Short（COMPRESSION_TIME_SHORT）
メッセージごとに圧縮または解凍時に要する時間(マイクロ秒)。短期インターバルで取得した平均値。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。

注意

Channel Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，「0」になります。

－
double
No
すべて
Inquire Channel Status

Connection Name（CONNECTION_NAME）
接続名。
－
string(512)
No
すべて
Inquire Channel

Current Msgs（CURRENT_MSGS）
送信側チャネルの場合，これは現行バッチで送信したメッセージの数です。メッセージを送信するたびに，これが更新され，チャネルが未確定になった場合は，これは未確定のメッセージ数です。受信側チャネルの場合，これは現行バッチで受信されたメッセージの数です。バッチがコミットされた場合は，送信と受信の両方のチャネルで，この値が「0」にリセットされます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
－
double
No
すべて
Inquire Channel Status

Current Sequence Number（CURRENT_SEQUENCE_NUMBER）
送信側チャネルの場合，これは送信した最後のメッセージのメッセージ・シーケンス番号です。メッセージを送信するたびに，これが更新され，チャネルが未確定になった場合は，これは未確定バッチの最後のメッセージのメッセージ・シーケンス番号です。受信側チャネルの場合，これは受信された最後のメッセージのメッセージ・シーケンス番号です。これは，メッセージを受信するたびに更新されます。
－
double
No
すべて
Inquire Channel Status

Exit Time Long（EXIT_TIME_LONG）
各メッセージによってユーザー出口が処理されるのに掛かる時間(マイクロ秒)。長期インターバルで取得した平均値。チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。
－
double
No
すべて
Inquire Channel Status

Exit Time Short（EXIT_TIME_SHORT）
各メッセージによってユーザー出口が処理されるのに掛かる時間(マイクロ秒)。短期インターバルで取得した平均値。チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。
－
double
No
すべて
Inquire Channel Status

In Doubt Status（IN_DOUBT_STATUS）
チャネルが現在未確定状態であるかを示します。
未確定状態とは，メッセージ送付チャネル・エージェントが送信したバッチ・メッセージを正常に受信したことの応答を待っている状態です。
受信側は未確定状態になることはありません。

MQCHIDS_INDOUBT

未確定状態である。

MQCHIDS_NOT_INDOUBT

未確定状態でない。

－
string(32)
No
すべて
Inquire Channel Status

Last LUWID（LAST_LUWID）
最終LUWID。
コミットされた最終作業論理単位の番号です。
－
string(32)
No
すべて
Inquire Channel Status

Last Msg Date（LAST_MSG_DATE）
最後のメッセージを送信したか，あるいはMQI呼び出しを処理した日付。
－
string(16)
No
すべて
Inquire Channel Status

Last Msg Time（LAST_MSG_TIME）
最後のメッセージを送信したか，あるいはMQI呼び出しを処理した時刻。
－
string(16)
No
すべて
Inquire Channel Status

Last Sequence Number（LAST_SEQUENCE_NUMBER）
コミットされた最終バッチ内の最終メッセージの番号。
－
double
No
すべて
Inquire Channel Status

Long Retries Left（LONG_RETRIES_LEFT）
残っている長期再試行待ち開始の試行回数。これは，送信側またはサーバ・チャネルにだけ適用されます。
－
double
No
すべて
Inquire Channel Status

MCA User Identifier（MCA_USER_IDENTIFIER）
MCAで使用されるユーザーID。このユーザー IDは，チャネル定義で設定されているユーザーID，MCAチャネル用のデフォルト・ユーザーID，セキュリティー出口で指定されているユーザーID，またはチャネルがサーバ接続チャネルである場合はクライアントから転送されたユーザーIDになります。
－
string(128)
No
すべて
Inquire Channel

MSGS（MSGS）
チャネルの開始後に送受信されたメッセージの数，またはサーバ接続チャネルの場合は処理したMQI呼び出しの数。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
－
double
No
すべて
Inquire Channel Status

Msgs Available（MSGS_AVAILABLE）
伝送キューに入れられ，MQGET用にチャネルで使用可能なメッセージの数。
値を取得できない場合，このフィールドの値は-1になります。
－
double
No
すべて
Inquire Channel Status

Net Time Long（NET_TIME_LONG）
チャネルのリモート・エンドに要求を送信してから応答を受け取るのに掛かる時間(マイクロ秒)。長期インターバルで取得した平均値。この値は，チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。このパラメーターは，送信側，サーバ，およびクラスター送信側チャネルにだけ適用されます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。
－
double
No
すべて
Inquire Channel Status

Net Time Short（NET_TIME_SHORT）
チャネルのリモート・エンドに要求を送信してから応答を受け取るのに掛かる時間(マイクロ秒)。短期インターバルで取得した平均値。この値は，チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。このパラメーターは，送信側，サーバ，およびクラスター送信側チャネルにだけ適用されます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。
－
double
No
すべて
Inquire Channel Status

Remote App lTag（REMOTE_APP_LTAG）
リモート・システムのキューマネージャー名またはキュー共用グループ名（リモートパートナーアプリケーション名）。これは，チャネルを使用している末端クライアントのアプリケーション名です。このパラメーターはサーバ接続チャネルだけに適用されます。
－
string(64)
No
すべて
Inquire Channel Status

Remote QMgr Name（REMOTE_QMGR_NAME）
リモート・システムのキューマネージャー名またはキュー共用グループ名。
－
string(64)
No
すべて
Inquire Channel Status

Short Retries Left（SHORT_RETRIES_LEFT）
残っている短期再試行待ち開始の試行回数。これは，送信側またはサーバ・チャネルにだけ適用されます。
－
double
No
すべて
Inquire Channel Status

SSL Key Resets（SSL_KEY_RESETS）
正常なSSL鍵リセットの数。SSL鍵リセットの数は，チャネル・インスタンスの終了時にリセットされます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
－
double
No
すべて
Inquire Channel Status

Stop Requested（STOP_REQUESTED）
ユーザーの停止要求が未解決かどうかを示す値。有効な値は次のとおり。

MQCHSR_STOP_NOT_REQUESTED

停止要求が未解決です。

MQCHSR_STOP_REQUESTED

停止要求は解決済みです。

－
string(32)
No
すべて
Inquire Channel Status

Sub State（SUB_STATE）
チャネルが現在実行中のアクション。有効な値は次のとおり。

MQCHSSTATE_CHADEXIT

自動定義出口実行中。

MQCHSSTATE_COMPRESSING

データ圧縮中，または解凍中。

MQCHSSTATE_END_OF_BATCH

バッチ処理の終了中。

MQCHSSTATE_HANDSHAKING

SSLハンドシェイク中。

MQCHSSTATE_HEARTBEATING

ハートビート送信中。

MQCHSSTATE_IN_MQGET

MQGETの実行中。

MQCHSSTATE_IN_MQI_CALL

MQPUT，MQGET以外のMQAPI実行中。

MQCHSSTATE_IN_MQPUT

MQPUTの実行中。

MQCHSSTATE_MREXIT

再試行出口実行中。

MQCHSSTATE_MSGEXIT

メッセージ出口実行中。

MQCHSSTATE_NAME_SERVER

ネームサーバ要求中。

MQCHSSTATE_NET_CONNECTING

ネットワーク接続中。

MQCHSSTATE_OTHER

未定義の状態。

MQCHSSTATE_RCVEXIT

受信出口実行中。

MQCHSSTATE_RECEIVING

受信中。

MQCHSSTATE_RESYNCHING

チャネルの両端で同期処理中。

MQCHSSTATE_SCYEXIT

セキュリティー出口実行中。

MQCHSSTATE_SENDEXIT

送信出口実行中。

MQCHSSTATE_SENDING

送信中。

MQCHSSTATE_SERIALIZING

キューマネージャーの同期処理中。

－
string(32)
No
すべて
Inquire Channel Status

X Q Time Long（X_Q_TIME_LONG）
メッセージを取得する前にこのメッセージが伝送キューに残っている時間(マイクロ秒)。長期インターバルで取得した平均値。時間は，メッセージが伝送キューに置かれてから，チャネルに送信するために取得されるまでの時間です。このため，書き込みアプリケーションでの遅延によって生じた間隔も含まれています。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
この値は，チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。
値を取得できない場合，このフィールドの値は-1になります。
－
double
No
すべて
Inquire Channel Status

X Q Time Short（X_Q_TIME_SHORT）
メッセージを取得する前にこのメッセージが伝送キューに残っている時間(マイクロ秒)。短期インターバルで取得した平均値。時間は，メッセージが伝送キューに置かれてから，チャネルに送信するために取得されるまでの時間です。このため，書き込みアプリケーションでの遅延によって生じた間隔も含まれています。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
この値は，チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。
値を取得できない場合，このフィールドの値は-1になります。
－
double
No
すべて
Inquire Channel Status

Channel Status Interval（PI_CSI）

機能

Channel Status Interval (PI_CSI)レコードには，チャネルについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。このレコードは，複数インスタンスレコードです。

注意

監視対象のキューマネージャー，またはコマンドサーバが実行中でない場合，情報を収集できません。

Channel Monitoringフィールドの値が「MQMON_OFF」の場合，以下のフィールドはデータの収集に失敗します。
・Compression Time Long
・Compression Time Short

Channel Statusフィールドの値がCHS_INACTIVEである場合，以下のフィールド以外は情報を収集できません。
・Record Type
・Record Time
・Interval
・Channel Status
・Channel Name
・Channel Type
・Connection Name
・MCA User Identifier

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_CSI_CHANNEL_NAME

ライフタイム

チャネルの作成から削除まで。

レコードサイズ

固定部：681バイト

可変部：1,644バイト

フィールド

PFM-View名
（PFM-Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Record Type（INPUT_RECORD_TYPE）
レコード名。常に「CSI」。
COPY
char(8)
No
すべて
－

Record Time（RECORD_TIME）
レコードが作成された時刻。
COPY
time_t
No
すべて
－

Interval（INTERVAL）
情報が収集される時間。秒単位。
COPY
ulong
No
すべて
－

Channel Name（CHANNEL_NAME）
チャネル名。
COPY
string(32)
No
すべて
Inquire Channel

Batches（BATCHES）
完了したバッチの数。
このフィールドのデルタ集計前の値の最大値は4,294,967,295です。
最大値を超えると0からの値となります。
COPY
double
Yes
すべて
Inquire Channel Status

Buffers Received（BUFFERS_RECEIVED）
受信したバッファ数。
このフィールドのデルタ集計前の値の最大値は4,294,967,295です。
最大値を超えると0からの値となります。
COPY
double
Yes
すべて
Inquire Channel Status

Buffers Sent（BUFFERS_SENT）
送信したバッファ数。
このフィールドのデルタ集計前の値の最大値は4,294,967,295です。
最大値を超えると0からの値となります。
COPY
double
Yes
すべて
Inquire Channel Status

Bytes Received（BYTES_RECEIVED）
受信されたバイト数。
このフィールドのデルタ集計前の値の最大値は4,294,967,295です。
最大値を超えると0からの値となります。
COPY
double
Yes
すべて
Inquire Channel Status

Bytes Sent（BYTES_SENT）
送信されたバイト数。
このフィールドのデルタ集計前の値の最大値は4,294,967,295です。
最大値を超えると0からの値となります。
COPY
double
Yes
すべて
Inquire Channel Status

Channel Monitoring（CHANNEL_MONITORING）
現在のチャネルのモニターデータ収集レベル。有効な値は次のとおり。

MQMON_HIGH

高率でデータを収集します。

MQMON_LOW

低率でデータを収集します。

MQMON_MEDIUM

中率でデータを収集します。

MQMON_OFF

データが収集されません。

COPY
string(32)
No
すべて
Inquire Channel Status

Channel Status（CHANNEL_STATUS）
チャネル状況。有効な値は次のとおり。

CHS_INACTIVE

チャネルは，非アクティブです。

MQCHS_BINDING

チャネルは，パートナーと対話中です。

MQCHS_INITIALIZING

チャネルは，初期化中です。

MQCHS_PAUSED

チャネルは，休止しています。

MQCHS_REQUESTING

要求側チャネルは，接続を要求中です。

MQCHS_RETRYING

チャネルは，接続の確立を再試行中です。

MQCHS_RUNNING

チャネルは，メッセージの転送中またはメッセージを待機中です。

MQCHS_STARTING

チャネルは，活動状態になるまで待機中です。

MQCHS_STOPPED

チャネルは，停止しています。

MQCHS_STOPPING

チャネルは，停止処理中です。

注意

値がCHS_INACTIVEの場合，このレコードの次に示すフィールド以外は，常に(1)～(3)のどれかの値となります。

・Record Type

・Record Time

・Interval

・Channel Name

・Channel Type

・Connection Name

・MCA User Identifier

(1)数値型でデルタがNOのフィールドは「-1」

(2)数値型でデルタがYESのフィールドは「0」

(3)文字列型のフィールドは空白

COPY
string(32)
No
すべて
Inquire Channel Status

Channel Type（CHANNEL_TYPE）
チャネル・タイプ。有効な値は次のとおり。

MQCHT_CLNTCONN

クライアント接続。

MQCHT_CLUSRCVR

クラスター受信側。

MQCHT_CLUSSDR

クラスター送信側。

MQCHT_RECEIVER

受信側。

MQCHT_REQUESTER

要求側。

MQCHT_SENDER

送信側。

MQCHT_SERVER

サーバ。

MQCHT_SVRCONN

サーバ接続（クライアント用）。

COPY
string(32)
No
すべて
Inquire Channel

Compression Time Long（COMPRESSION_TIME_LONG）
メッセージごとに圧縮または解凍時に要する時間(マイクロ秒)。長期インターバルで取得した平均値。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。

注意

Channel Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，「0」になります。

HILO
double
No
すべて
Inquire Channel Status

Compression Time Short（COMPRESSION_TIME_SHORT）
メッセージごとに圧縮または解凍時に要する時間(マイクロ秒)。短期インターバルで取得した平均値。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。

注意

Channel Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，「0」になります。

HILO
double
No
すべて
Inquire Channel Status

Connection Name（CONNECTION_NAME）
接続名。
COPY
string(512)
No
すべて
Inquire Channel

Current Msgs（CURRENT_MSGS）
送信側チャネルの場合，これは現行バッチで送信したメッセージの数です。メッセージを送信するたびに，これが更新され，チャネルが未確定になった場合は，これは未確定のメッセージ数です。受信側チャネルの場合，これは現行バッチで受信されたメッセージの数です。バッチがコミットされた場合は，送信と受信の両方のチャネルで，この値が「0」にリセットされます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
HILO
double
No
すべて
Inquire Channel Status

Current Sequence Number（CURRENT_SEQUENCE_NUMBER）
送信側チャネルの場合，これは送信した最後のメッセージのメッセージ・シーケンス番号です。メッセージを送信するたびに，これが更新され，チャネルが未確定になった場合は，これは未確定バッチの最後のメッセージのメッセージ・シーケンス番号です。受信側チャネルの場合，これは受信された最後のメッセージのメッセージ・シーケンス番号です。これは，メッセージを受信するたびに更新されます。
COPY
double
No
すべて
Inquire Channel Status

Exit Time Long（EXIT_TIME_LONG）
各メッセージによってユーザー出口が処理されるのに掛かる時間(マイクロ秒)。長期インターバルで取得した平均値。チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。
HILO
double
No
すべて
Inquire Channel Status

Exit Time Short（EXIT_TIME_SHORT）
各メッセージによってユーザー出口が処理されるのに掛かる時間(マイクロ秒)。短期インターバルで取得した平均値。チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。
HILO
double
No
すべて
Inquire Channel Status

In Doubt Status（IN_DOUBT_STATUS）
チャネルが現在未確定状態であるかを示します。
未確定状態とは，メッセージ送付チャネル・エージェントが送信したバッチ・メッセージを正常に受信したことの応答を待っている状態です。
受信側は未確定状態になることはありません。

MQCHIDS_INDOUBT

未確定状態である。

MQCHIDS_NOT_INDOUBT

未確定状態でない。

COPY
string(32)
No
すべて
Inquire Channel Status

Last LUWID（LAST_LUWID）
最終LUWID。
コミットされた最終作業論理単位の番号です。
COPY
string(32)
No
すべて
Inquire Channel Status

Last Msg Date（LAST_MSG_DATE）
最後のメッセージを送信したか，あるいはMQI呼び出しを処理した日付。
COPY
string(16)
No
すべて
Inquire Channel Status

Last Msg Time（LAST_MSG_TIME）
最後のメッセージを送信したか，あるいはMQI呼び出しを処理した時刻。
COPY
string(16)
No
すべて
Inquire Channel Status

Last Sequence Number（LAST_SEQUENCE_NUMBER）
コミットされた最終バッチ内の最終メッセージの番号。
COPY
double
No
すべて
Inquire Channel Status

Long Retries Left（LONG_RETRIES_LEFT）
残っている長期再試行待ち開始の試行回数。これは，送信側またはサーバ・チャネルにだけ適用されます。
HILO
double
No
すべて
Inquire Channel Status

MCA User Identifier（MCA_USER_IDENTIFIER）
MCAで使用されるユーザーID。このユーザー IDは，チャネル定義で設定されているユーザーID，MCAチャネル用のデフォルト・ユーザーID，セキュリティー出口で指定されているユーザーID，またはチャネルがサーバ接続チャネルである場合はクライアントから転送されたユーザーIDになります。
COPY
string(128)
No
すべて
Inquire Channel

MSGS（MSGS）
チャネルの開始後に送受信されたメッセージの数，またはサーバ接続チャネルの場合は処理したMQI呼び出しの数。
このフィールドのデルタ集計前の値の最大値は4,294,967,295です。
最大値を超えると0からの値となります。
COPY
double
Yes
すべて
Inquire Channel Status

Msgs Available（MSGS_AVAILABLE）
伝送キューに入れられ，MQGET用にチャネルで使用可能なメッセージの数。
値を取得できない場合，このフィールドの値は-1になります。
HILO
double
No
すべて
Inquire Channel Status

Net Time Long（NET_TIME_LONG）
チャネルのリモート・エンドに要求を送信してから応答を受け取るのに掛かる時間(マイクロ秒)。長期インターバルで取得した平均値。この値は，チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。このパラメーターは，送信側，サーバ，およびクラスター送信側チャネルにだけ適用されます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。
HILO
double
No
すべて
Inquire Channel Status

Net Time Short（NET_TIME_SHORT）
チャネルのリモート・エンドに要求を送信してから応答を受け取るのに掛かる時間(マイクロ秒)。短期インターバルで取得した平均値。この値は，チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。このパラメーターは，送信側，サーバ，およびクラスター送信側チャネルにだけ適用されます。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。
HILO
double
No
すべて
Inquire Channel Status

Remote App lTag（REMOTE_APP_LTAG）
リモート・システムのキューマネージャー名またはキュー共用グループ名（リモートパートナーアプリケーション名）。これは，チャネルを使用している末端クライアントのアプリケーション名です。このパラメーターはサーバ接続チャネルだけに適用されます。
COPY
string(64)
No
すべて
Inquire Channel Status

Remote QMgr Name（REMOTE_QMGR_NAME）
リモート・システムのキューマネージャー名またはキュー共用グループ名。
COPY
string(64)
No
すべて
Inquire Channel Status

Short Retries Left（SHORT_RETRIES_LEFT）
残っている短期再試行待ち開始の試行回数。これは，送信側またはサーバ・チャネルにだけ適用されます。
HILO
double
No
すべて
Inquire Channel Status

SSL Key Resets（SSL_KEY_RESETS）
正常なSSL鍵リセットの数。SSL鍵リセットの数は，チャネル・インスタンスの終了時にリセットされます。
このフィールドのデルタ集計前の値の最大値は4,294,967,295です。
最大値を超えると0からの値となります。
COPY
double
Yes
すべて
Inquire Channel Status

Stop Requested（STOP_REQUESTED）
ユーザーの停止要求が未解決かどうかを示す値。有効な値は次のとおり。

MQCHSR_STOP_NOT_REQUESTED

停止要求が未解決です。

MQCHSR_STOP_REQUESTED

停止要求は解決済みです。

COPY
string(32)
No
すべて
Inquire Channel Status

Sub State（SUB_STATE）
チャネルが現在実行中のアクション。有効な値は次のとおり。

MQCHSSTATE_CHADEXIT

自動定義出口実行中。

MQCHSSTATE_COMPRESSING

データ圧縮中，または解凍中。

MQCHSSTATE_END_OF_BATCH

バッチ処理の終了中。

MQCHSSTATE_HANDSHAKING

SSLハンドシェイク中。

MQCHSSTATE_HEARTBEATING

ハートビート送信中。

MQCHSSTATE_IN_MQGET

MQGETの実行中。

MQCHSSTATE_IN_MQI_CALL

MQPUT，MQGET以外のMQAPI実行中。

MQCHSSTATE_IN_MQPUT

MQPUTの実行中。

MQCHSSTATE_MREXIT

再試行出口実行中。

MQCHSSTATE_MSGEXIT

メッセージ出口実行中。

MQCHSSTATE_NAME_SERVER

ネームサーバ要求中。

MQCHSSTATE_NET_CONNECTING

ネットワーク接続中。

MQCHSSTATE_OTHER

未定義の状態。

MQCHSSTATE_RCVEXIT

受信出口実行中。

MQCHSSTATE_RECEIVING

受信中。

MQCHSSTATE_RESYNCHING

チャネルの両端で同期処理中。

MQCHSSTATE_SCYEXIT

セキュリティー出口実行中。

MQCHSSTATE_SENDEXIT

送信出口実行中。

MQCHSSTATE_SENDING

送信中。

MQCHSSTATE_SERIALIZING

キューマネージャーの同期処理中。

COPY
string(32)
No
すべて
Inquire Channel Status

X Q Time Long（X_Q_TIME_LONG）
メッセージを取得する前にこのメッセージが伝送キューに残っている時間(マイクロ秒)。長期インターバルで取得した平均値。時間は，メッセージが伝送キューに置かれてから，チャネルに送信するために取得されるまでの時間です。このため，書き込みアプリケーションでの遅延によって生じた間隔も含まれています。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
この値は，チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。
値を取得できない場合，このフィールドの値は-1になります。
HILO
double
No
すべて
Inquire Channel Status

X Q Time Short（X_Q_TIME_SHORT）
メッセージを取得する前にこのメッセージが伝送キューに残っている時間(マイクロ秒)。短期インターバルで取得した平均値。時間は，メッセージが伝送キューに置かれてから，チャネルに送信するために取得されるまでの時間です。このため，書き込みアプリケーションでの遅延によって生じた間隔も含まれています。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
この値は，チャネルの開始時にリセットされ，チャネルが実行している場合にだけ表示されます。
値を取得できない場合，このフィールドの値は-1になります。
HILO
double
No
すべて
Inquire Channel Status

Queue Handle Status（PD_QHS）

機能

Queue Handle Status (PD_QHS)レコードには，キューにアクセスしているハンドルについての，ある時点での状態を示すパフォーマンスデータが格納されます。ハンドルは，アプリケーションからキューへの接続を表します。このレコードは，複数インスタンスレコードです。

注意

監視対象のキューマネージャー，またはコマンドサーバが実行中でない場合，情報を収集できません。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PD_QHS_HANDLE_ID

ライフタイム

キューへのアクセスの開始から終了まで。

レコードサイズ

固定部：681バイト

可変部：976バイト

フィールド

PFM-View名
（PFM-Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Record Type（INPUT_RECORD_TYPE）
レコード名。常に「QHS」。
－
char(8)
No
すべて
－

Record Time（RECORD_TIME）
レコードが作成された時刻。
－
time_t
No
すべて
－

Interval（INTERVAL）
常に「0」。
－
ulong
No
すべて
－

Handle ID（HANDLE_ID）
ハンドルID。次の文字列で構成される。
[キュー名]_[プロセスID]_[スレッドID]_[通番]
[キュー名]:Q Nameフィールドの値
[プロセスID]:Process IDフィールドの値
[スレッドID]:Thread IDフィールドの値
[通番]:通常1です。キュー名，プロセスID，スレッドIDがすべて同一のハンドルが複数存在する場合に2，3，・・・になります。
2以上の通番が存在する場合，それぞれのハンドルを収集するたびに同一キーであることは保証されません。
－
string(128)
No
すべて
－

Appl Tag（APPL_TAG）
キューマネージャーに接続しているアプリケーション名を含む文字列。
アプリケーション名は，キューマネージャーに接続されたプロセスまたはジョブの名前を表します。
－
string(32)
No
すべて
Inquire Queue Status

Appl Type（APPL_TYPE）
キューマネージャーに接続しているアプリケーションのタイプ。有効な値は次のとおり。

MQAT_BATCH

バッチ接続を使用するアプリケーション。

MQAT_CHANNEL_INITIATOR

チャネル・イニシエーター。

MQAT_CICS

CICSトランザクション。

MQAT_IMS

IMSトランザクション。

MQAT_QMGR

キューマネージャー。

MQAT_RRS_BATCH

バッチ接続を使用し，RRS調整されたアプリケーション。

MQAT_USER

ユーザー・アプリケーション。

－
string(32)
No
すべて
Inquire Queue Status

Channel Name（CHANNEL_NAME）
ハンドルを所有するチャネルの名前。ハンドルに関連したチャネルがない場合，この値は空になります。この値は，ハンドルがチャネル・イニシエーターに属する場合にだけ表示されます。
－
string(32)
No
すべて
Inquire Queue Status

Conname（CONNAME）
ハンドルを所有するチャネルに関連した接続名。ハンドルに関連したチャネルがない場合，この値は空になります。この値は，ハンドルがチャネル・イニシエーターに属する場合にだけ表示されます。
－
string(512)
No
すべて
Inquire Queue Status

Handle State（HANDLE_STATE）
ハンドルの状況。有効な値は次のとおり。

MQHSTATE_ACTIVE

現在このオブジェクトで進行中のAPIコールがあります。MQGET WAITコールが進行中であるときにこの状態になります。

MQHSTATE_INACTIVE

現在このオブジェクトで進行中のAPIコールがありません。MQGET WAITコールが進行中でないときにこの状態になります。

－
string(32)
No
すべて
Inquire Queue Status

Process ID（PROCESS_ID）
キューを開いたプロセスのID。
－
double
No
すべて
Inquire Queue Status

Q Name（Q_NAME）
キュー名。
－
string(64)
No
すべて
Inquire Queue Status

Thread ID（THREAD_ID）
キューを開いたアプリケーション・プロセス内のスレッドのID。
－
double
No
すべて
Inquire Queue Status

User Identifier（USER_IDENTIFIER）
ハンドルに関連したユーザーID。
－
string(128)
No
すべて
Inquire Queue Status

Queue Manager Status（PD）

機能

Queue Manager Status (PD)レコードには，キューマネージャーについての，ある時点での状態を示すパフォーマンスデータが格納されます。

注意

監視対象のキューマネージャー，またはコマンドサーバが実行中でない場合，以下のフィールド以外は情報を収集できません。
・Record Type
・Record Time
・Interval
・Command Server Status
・Q Mgr Name
・Q Mgr Status
・Reason Code Numeric
・Reason Code String

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：2,010バイト

可変部：0バイト

フィールド

PFM-View名
（PFM-Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Record Type（INPUT_RECORD_TYPE）
レコード名。常に「PD」。
－
char(8)
No
すべて
－

Record Time（RECORD_TIME）
レコードが作成された時刻。
－
time_t
No
すべて
－

Interval（INTERVAL）
常に「0」。
－
ulong
No
すべて
－

Channel Initiator Status（CHANNEL_INITIATOR_STATUS）
チャネル・イニシエーターの状況。有効な値は次のとおり。

MQSVC_STATUS_RUNNING

実行中。

MQSVC_STATUS_STARTING

開始中。

MQSVC_STATUS_STOPPED

停止。

MQSVC_STATUS_STOPPING

停止中。

－
string(32)
No
すべて
Inquire Queue Manager Status

Command Server Status（COMMAND_SERVER_STATUS）
コマンドサーバの状況。有効な値は次のとおり。

MQSVC_STATUS_RUNNING

実行中。

MQSVC_STATUS_STARTING

開始中。

MQSVC_STATUS_STOPPED

停止。

MQSVC_STATUS_STOPPING

停止中。

－
string(32)
No
すべて
Inquire Queue Manager Status

Connection Count（CONNECTION_COUNT）
キューマネージャーへの接続数。
－
double
No
すべて
Inquire Queue Manager Status

Current Log（CURRENT_LOG）
現行のログファイルの名前。
－
string(32)
No
すべて
Inquire Queue Manager Status

Log Path（LOG_PATH）
キューマネージャーが作ったログファイルのディレクトリを識別するための，回復ログファイルの場所。
－
string(1,025)
No
すべて
Inquire Queue Manager Status

Media Recovery Log（MEDIA_RECOVERY_LOG）
キューマネージャーがメディア回復を実行するのに必要とする最も古いログファイルの名前。
－
string(32)
No
すべて
Inquire Queue Manager Status

Q Mgr Name（Q_MGR_NAME）
キューマネージャー名。
－
string(64)
No
すべて
Inquire Queue Manager Status

Q Mgr Status（Q_MGR_STATUS）
キューマネージャーの状況。有効な値は次のとおり。

CMD_ERROR

キューマネージャーへの接続可能，かつコマンド実行不可。

QM_ERROR

キューマネージャーへの接続不可。

MQQMSTA_QUIESCING

静止中。

MQQMSTA_RUNNING

実行中。

MQQMSTA_STARTING

開始中。

注意

値がQM_ERROR，またはCMD_ERRORの場合，このレコードの下記以外のフィールドはすべて「-1」または空白になります。また，このレコード以外のレコードはデータの収集に失敗します。

Record Type

Record Time

Interval

Command Server Status

Q Mgr Name

Reason Code Numeric

Reason Code String

－
string(32)
No
すべて
Inquire Queue Manager Status

Reason Code Numeric（REASON_CODE_NUMERIC）
Q Mgr StatusがQM_ERRORの場合，キューマネージャー接続時のエラーコード(数値)。
Q Mgr StatusがCMD_ERRORの場合，コマンド実行時のエラーコード(数値)。
Q Mgr Statusが上記以外の場合，「0」。
－
double
No
すべて
－

Reason Code String（REASON_CODE_STRING）
Q Mgr StatusがQM_ERRORの場合，キューマネージャー接続時のエラーコード(文字列)。
Q Mgr StatusがCMD_ERRORの場合，コマンド実行時のエラーコード(文字列)。
Q Mgr Statusが上記以外の場合，空白。
－
string(32)
No
すべて
－

Restart Recovery Log（RESTART_RECOVERY_LOG）
キューマネージャーが再始動回復を実行するのに必要とする最も古いログファイルの名前。
－
string(32)
No
すべて
Inquire Queue Manager Status

Queue Manager Status Interval（PI）

機能

このレコードは将来のバージョンのため予約されています。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：681バイト

可変部：0バイト

フィールド

PFM-View名
（PFM-Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Record Type（INPUT_RECORD_TYPE）
レコード名。常に「PI」。
－
char(8)
No
すべて
－

Record Time（RECORD_TIME）
レコードが作成された時刻。
－
time_t
No
すべて
－

Interval（INTERVAL）
常に「0」。
－
ulong
No
すべて
－

Queue Status（PD_QS）

機能

Queue Status (PD_QS)レコードには，キューについての，ある時点での状態を示すパフォーマンスデータが格納されます。このレコードは，複数インスタンスレコードです。

注意

監視対象のキューマネージャー，またはコマンドサーバが実行中でない場合，情報を収集できません。

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，以下のフィールドはデータの収集に失敗します。
・Last Get Date
・Last Get Time
・Last Put Date
・Last Put Time
・Oldest Msg Age
・On Q Time Long
・On Q Time Short

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PD_QS_Q_NAME

ライフタイム

キューの作成から削除まで。

レコードサイズ

固定部：681バイト

可変部：384バイト

フィールド

PFM-View名
（PFM-Manager名）
説明
要約
形式
デルタ
サポートバージョン
データソース

Record Type（INPUT_RECORD_TYPE）
レコード名。常に「QS」。
－
char(8)
No
すべて
－

Record Time（RECORD_TIME）
レコードが作成された時刻。
－
time_t
No
すべて
－

Interval（INTERVAL）
常に「0」。
－
ulong
No
すべて
－

Q Name（Q_NAME）
キュー名。
－
string(64)
No
すべて
Inquire Queue

Current Q Depth（CURRENT_Q_DEPTH）
現在キューに入っているメッセージの数。
－
double
No
すべて
Inquire Queue

Inhibit Get（INHIBIT_GET）
メッセージをキューから読み取るための権限。有効な値は次のとおり。

MQQA_GET_ALLOWED

許可。

MQQA_GET_INHIBITED

禁止。

－
string(32)
No
すべて
Inquire Queue

Inhibit Put（INHIBIT_PUT）
メッセージをキューに書き込むための権限。有効な値は次のとおり。

MQQA_PUT_ALLOWED

許可。

MQQA_PUT_INHIBITED

禁止。

－
string(32)
No
すべて
Inquire Queue

Last Get Date（LAST_GET_DATE）
キューマネージャーが開始されてから，最後のメッセージが取得された日付。
参照中のメッセージは，取得されたメッセージとしてカウントされません。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，空白になります。

－
string(16)
No
すべて
Inquire Queue Status

Last Get Time（LAST_GET_TIME）
キューマネージャーが開始されてから，最後のメッセージが取得された時刻。参照中のメッセージは，取得されたメッセージとしてカウントされません。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，空白になります。

－
string(16)
No
すべて
Inquire Queue Status

Last Put Date（LAST_PUT_DATE）
キューマネージャーが開始されてから，最後のメッセージが書き込まれた日付。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，空白になります。

－
string(16)
No
すべて
Inquire Queue Status

Last Put Time（LAST_PUT_TIME）
キューマネージャーが開始されてから，最後のメッセージがキューに書き込まれた時刻。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，空白になります。

－
string(16)
No
すべて
Inquire Queue Status

Max Q Depth（MAX_Q_DEPTH）
キューに入れることができるメッセージの最大数。
－
double
No
すべて
Inquire Queue

Oldest Msg Age（OLDEST_MSG_AGE）
キューにある最も古いメッセージの経過日数(秒)。最大表示可能値は999,999,999です。この値を上回ると999,999,999が表示されます。
値を取得できない場合，このフィールドの値は-1になります。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，-1になります。

－
double
No
すべて
Inquire Queue Status

On Q Time Long（ON_Q_TIME_LONG）
メッセージがキューに書き込まれてから，読み取られて破棄されるまでの間隔(マイクロ秒)。
長期インターバルで取得した平均値。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，-1になります。

－
double
No
すべて
Inquire Queue Status

On Q Time Short（ON_Q_TIME_SHORT）
メッセージがキューに書き込まれてから，読み取られて破棄されるまでの間隔(マイクロ秒)。
短期インターバルで取得した平均値。
このフィールドの最大値は4,294,967,295です。
最大値を超えると0からの値となります。
値を取得できない場合，このフィールドの値は-1になります。

注意

Queue Monitoringフィールドの値が「MQMON_OFF」の場合，このフィールド値の収集に失敗し，-1になります。

－
double
No
すべて
Inquire Queue Status

Open Input Count（OPEN_INPUT_COUNT）
キューからメッセージを入力するためにキューに現在接続しているアプリケーションの数。
－
double
No
すべて
Inquire Queue

Open Output Count（OPEN_OUTPUT_COUNT）
キューへメッセージを出力するためにキューに現在接続しているアプリケーションの数。
－
double
No
すべて
Inquire Queue

Q Depth %（Q_DEPTH_PERCENT）
キューに入れることができるメッセージの最大数に対するキューの使用率(%)。
このフィールドの値は，Max Q Depthフィールドに対するCurrent Q Depthフィールドの割合(%)です。
Current Q Depthフィールドの値が-1の場合，このフィールド値は-1になります。
Max Q Depthフィールドの値が0または-1の場合，このフィールド値は-1になります。
－
double
No
すべて
－

Q Type（Q_TYPE）
キュー・タイプ。有効な値は次のとおり。

MQQT_ALIAS

別名キュー。

MQQT_CLUSTER

クラスター・キュー。

MQQT_LOCAL

ローカル・キュー。

MQQT_MODEL

モデル・キュー。

MQQT_REMOTE

リモート・キュー定義。

－
string(32)
No
すべて
Inquire Queue

Queue Monitoring（QUEUE_MONITORING）
現在のキューのモニターデータ収集レベル。有効な値は次のとおり。

MQMON_HIGH

高率でデータを収集します。

MQMON_LOW

低率でデータを収集します。

MQMON_MEDIUM

中率でデータを収集します。

MQMON_OFF

データが収集されません。

－
string(32)
No
すべて
Inquire Queue Status

Trigger Control（TRIGGER_CONTROL）
キューでトリガーを使用するための権限。有効な値は次のとおり。

MQTC_OFF

使用不可。

MQTC_ON

使用可能。

－
string(32)
No
すべて
Inquire Queue

Uncommitted Msgs（UNCOMMITTED_MSGS）
コミットされていない変更があるかどうかを示します。

MQQSUM_NO

コミットされていない変更がない。

MQQSUM_YES

コミットされていない変更がある。

－
string(32)
No
すべて
Inquire Queue Status

7.　メッセージ

この章では，PFM - Agent for IBM WebSphere MQのメッセージ形式，出力先一覧，Windowsイベントログの一覧，およびメッセージ一覧について説明します。

＜この章の構成＞

7.1　メッセージの形式

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

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

7.4　メッセージ一覧

7.1　メッセージの形式

PFM - Agent for IBM WebSphere MQが出力するメッセージの形式と，マニュアルでの記載形式を示します。

＜この節の構成＞

7.1.1　メッセージの出力形式

7.1.2　メッセージの記載形式

7.1.3　システム管理者の方へ

7.1.1　メッセージの出力形式

PFM - Agent for IBM WebSphere MQが出力するメッセージの形式を説明します。メッセージは，メッセージIDとそれに続くメッセージテキストで構成されます。形式を次に示します。

KAVLnnnnn-Yメッセージテキスト

メッセージIDは，次の内容を示しています。

K

システム識別子を示します。

AVL

PFM - Agentのメッセージであることを示します。

nnnnn

メッセージの通し番号を示します。PFM - Agent for IBM WebSphere MQのメッセージ番号は，「13xxx」です。

Y

メッセージの種類を示します。

E：エラー
処理は中断されます。

W：警告
メッセージ出力後，処理は続けられます。

I：情報
ユーザーに情報を知らせます。

Q：応答
ユーザーに応答を促します。

メッセージの種類とsyslogのpriorityレベルとの対応を次に示します。

-E

レベル：LOG_ERR

意味：エラーメッセージ

-W

レベル：LOG_WARNING

意味：警告メッセージ

-I

レベル：LOG_INFO

意味：付加情報メッセージ

-Q

（出力されない）

メッセージの種類とWindowsイベントログの種類との対応を次に示します。

-E

レベル：エラー

意味：エラーメッセージ

-W

レベル：警告

意味：警告メッセージ

-I

レベル：情報

意味：付加情報メッセージ

-Q

（出力されない）

7.1.2　メッセージの記載形式

このマニュアルでのメッセージの記載形式を示します。メッセージテキストで太字になっている部分は，メッセージが表示される状況によって表示内容が変わることを示しています。また，メッセージをメッセージID順に記載しています。記載形式の例を次に示します。

メッセージID

英語メッセージテキスト
日本語メッセージテキスト

メッセージの説明文

(S)

システムの処置を示します。

(O)

メッセージが表示されたときに，オペレーターが取る処置を示します。

英語メッセージテキスト，および日本語メッセージテキスト文中の＜＞記号は，埋め字を表します。例えば，ホスト名が「hostA」であり，メッセージテキストが「host=＜ホスト名＞」である場合は「host= hostA」と出力されます。

7.1.3　システム管理者の方へ

運用中にトラブルが発生した場合には，「8.　トラブルへの対処方法」を参照してログ情報を採取し，初期調査をしてください。

トラブル要因の初期調査をする場合は，OSのログ情報（Windowsの場合はWindowsイベント，UNIXの場合はsyslog）や，PFM - Agent for IBM WebSphere MQが出力する各種ログ情報を参照してください。これらのログ情報でトラブル発生時間帯の内容を参照して，トラブルを回避したり，トラブルに対処したりしてください。また，トラブルが発生するまでの操作方法などを記録してください。同時に，できるだけ再現性の有無を確認するようにしてください。

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

ここでは，PFM - Agent for IBM WebSphere MQが出力する各メッセージの出力先を一覧で示します。

表中では，出力先を凡例のように表記しています。

（凡例）

○：出力する

－：出力しない

表7-1　PFM - Agent for IBM WebSphere MQのメッセージの出力先一覧

メッセージID | 出力先
syslog | Windowsイベントログ | 共通メッセージログ | 標準出力 | 標準エラー出力 | エージェントログ
通常ログ | 異常ログ
KAVL13000 | ○ | ○ | ○ | － | － | － | －
KAVL13001 | ○ | ○ | ○ | － | － | － | －
KAVL13002 | ○ | ○ | ○ | － | － | － | －
KAVL13003 | ○ | ○ | ○ | － | － | － | －
KAVL13004 | － | － | ○ | － | － | － | －
KAVL13005 | ○ | ○ | ○ | － | － | － | －
KAVL13010 | ○ | ○ | ○ | － | － | － | －
KAVL13011 | ○ | ○ | ○ | － | － | － | －
KAVL13012 | ○ | ○ | ○ | － | － | － | －
KAVL13013 | ○ | ○ | ○ | － | － | － | －
KAVL13015 | － | － | ○ | － | － | － | －
KAVL13016 | － | － | ○ | － | － | － | －
KAVL13017 | ○ | ○ | ○ | － | － | － | －
KAVL13018 | － | － | ○ | － | － | － | －
KAVL13019 | － | － | ○ | － | － | － | －
KAVL13020 | － | － | ○ | － | － | － | －
KAVL13021 | － | － | ○ | － | － | － | －
KAVL13022 | － | － | ○ | － | － | － | －
KAVL13100 | － | － | － | － | － | － | ○
KAVL13101 | － | － | － | － | － | － | ○
KAVL13102 | － | － | － | － | － | ○ | －
KAVL13103 | － | － | － | － | － | ○ | －
KAVL13104 | － | － | － | － | － | ○ | －
KAVL13105 | － | － | － | － | － | ○ | －
KAVL13106 | － | － | － | － | － | ○ | －
KAVL13107 | － | － | － | － | － | ○ | －
KAVL13108 | － | － | － | － | － | ○ | －
KAVL13109 | － | － | － | － | － | ○ | －
KAVL13110 | － | － | － | － | － | ○ | －
KAVL13114 | － | － | － | － | － | － | ○
KAVL13115 | － | － | － | － | － | － | ○
KAVL13116 | － | － | － | － | － | － | ○
KAVL13117 | － | － | － | － | － | － | ○
KAVL13119 | － | － | － | － | － | － | ○
KAVL13123 | － | － | － | － | － | － | ○
KAVL13124 | － | － | － | － | － | － | ○
KAVL13125 | － | － | － | － | － | － | ○
KAVL13127 | － | － | － | － | － | － | ○
KAVL13128 | － | － | － | － | － | － | ○
KAVL13129 | － | － | － | － | － | － | ○

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

ここでは，PFM - Agent for IBM WebSphere MQがWindowsイベントログに出力するメッセージ情報の一覧を示します。

Windowsイベントログは，次の個所に表示されます。

［イベントビューア］画面のアプリケーションログに表示されます。

［イベントビューア］画面は，Windowsの［スタート］メニューから表示される［管理ツール］－［イベントビューア］を選択することで表示できます。

PFM - Agent for IBM WebSphere MQが出力するイベントの場合，［イベントビューア］画面の［ソース］に識別子「PFM-IBM WebSphere MQ」が表示されます。

syslogは，syslogファイルに出力されます。

syslogファイルの格納場所については，syslogデーモンコンフィギュレーションファイル（デフォルトは /etc/syslogd.conf）を参照してください。

PFM - Agent for IBM WebSphere MQがWindowsイベントログとsyslogに出力するメッセージ情報の一覧を次の表に示します。

表7-2　Windowsイベントログとsyslog出力メッセージ情報一覧

メッセージID | Windowsイベントログ | syslog
イベントID | 種類 | ファシリティ | レベル
KAVL13000-I | 13000 | 情報 | LOG_DAEMON | LOG_INFO
KAVL13001-E | 13001 | エラー | LOG_DAEMON | LOG_ERR
KAVL13002-I | 13002 | 情報 | LOG_DAEMON | LOG_INFO
KAVL13003-E | 13003 | エラー | LOG_DAEMON | LOG_ERR
KAVL13005-E | 13005 | エラー | LOG_DAEMON | LOG_ERR
KAVL13010-E | 13010 | エラー | LOG_DAEMON | LOG_ERR
KAVL13011-E | 13011 | エラー | LOG_DAEMON | LOG_ERR
KAVL13012-E | 13012 | エラー | LOG_DAEMON | LOG_ERR
KAVL13013-E | 13013 | エラー | LOG_DAEMON | LOG_ERR
KAVL13017-E | 13017 | エラー | LOG_DAEMON | LOG_ERR

7.4　メッセージ一覧

PFM - Agent for IBM WebSphere MQが出力するメッセージと対処方法について説明します。PFM - Agent for IBM WebSphere MQのメッセージ一覧を次に示します。

KAVL13000-I

Agent Collector has stopped. (host=＜ホスト名＞, service=＜サービスID＞)
Agent Collectorが停止しました（host=＜ホスト名＞, service=＜サービスID＞）

Agent Collectorサービスが正常に終了しました。

(S)

Agent Collectorサービスの処理を終了します。

KAVL13001-E

Agent Collector failed to start.
Agent Collectorの起動に失敗しました

Agent Collectorサービスの起動に失敗しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

共通メッセージログに出力されている直前のメッセージを確認し，そのメッセージの対処方法に従ってください。

KAVL13002-I

Agent Collector started. (host=＜ホスト名＞, service=＜サービスID＞)
Agent Collectorが起動しました（host=＜ホスト名＞, service=＜サービスID＞）

Agent Collectorサービスの起動が完了しました。

(S)

Agent Collectorサービスのパフォーマンスデータ収集処理を開始します。

KAVL13003-E

Agent Collector stopped abnormally.
Agent Collectorが異常終了しました

Agent Collectorサービスが異常終了しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

共通メッセージログに出力されている直前のメッセージを確認し，そのメッセージの対処方法に従ってください。

KAVL13004-W

The object to be monitored cannot be used. (host=＜ホスト名＞, service=＜サービスID＞)
監視対象のオブジェクトが利用できません（host=＜ホスト名＞, service=＜サービスID＞）

監視対象のIBM WebSphere MQに接続できません。

(S)

Agent Collectorサービスの処理を続行します。

(O)

IBM WebSphere MQが起動されているかどうか確認してください。また，インスタンス環境のセットアップ時に設定した次の項目に誤りがないか確認してください。

KAVL13005-E

An attempt to read the service startup information file has failed.
サービス起動情報ファイルの読み込みに失敗しました

Agent Collectorサービス起動処理中に，サービス起動情報ファイルの読み込み処理に失敗しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

サービス起動情報ファイル（jpcagt.ini）が，次のディレクトリ下にあるかどうか確認してください。

Windowsの場合
インストール先フォルダ¥agt9¥agent¥インスタンス名

UNIXの場合
/opt/jp1pc/agt9/agent/インスタンス名

KAVL13010-E

An error occurred in the ＜関数名＞ function. (en=＜エラーコード＞,arg1=＜引数1＞, arg2=＜引数2＞, arg3=＜引数3＞)
関数 ＜関数名＞でエラーが発生しました（en=＜エラーコード＞,arg1=＜引数1＞, arg2=＜引数2＞, arg3=＜引数3＞）

関数名で示される関数の実行中に，エラーが発生しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13011-E

A signal interrupted processing. (signal=＜シグナル番号＞)
シグナルによって処理が中断されました（signal=＜シグナル番号＞）

シグナルによって処理が中断されました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13012-E

Agent Collector will now stop because an error occurred.
エラーが発生したためAgent Collectorを停止します

エラーが発生したため，Agent Collectorサービスを停止します。

(S)

Agent Collectorサービスの処理を終了します。

(O)

共通メッセージログの直前に出力されているメッセージを確認し，そのメッセージの対処方法に従ってください。

KAVL13013-E

Memory allocation failed. (RecordName=＜レコード名＞, Size=＜取得サイズ＞)
メモリーの割り当てに失敗しました（RecordName=＜レコード名＞, Size=＜取得サイズ＞）

メモリーの確保に失敗しました。レコード名に"UNKNOWN"が出力されている場合，複数のレコードIDでメモリーの確保に失敗したことを示します。

(S)

Agent Collectorサービスの処理を終了します。

(O)

空きメモリーを増やしてください。

KAVL13015-W

Memory allocation failed. (RecordName=＜レコード名＞, Size=＜取得サイズ＞)
メモリーの割り当てに失敗しました（RecordName=＜レコード名＞, Size=＜取得サイズ＞）

メモリーの確保に失敗しました。レコード名に"UNKNOWN"が出力されている場合，複数のレコードIDでメモリーの確保に失敗したことを示します。

(S)

Agent Collectorサービスの処理を続行します。

(O)

空きメモリーを増やしてください。

KAVL13016-W

An attempt to collect the record failed. (RecordName=＜レコード名＞)
レコードの収集に失敗しました（RecordName=＜レコード名＞）

レコード名に示されるレコードの取得に失敗しました。

(S)

Agent Collectorサービスの処理を続行します。

(O)

このメッセージが連続して出力されている場合，監視対象のシステム環境の設定に誤りがないかどうか確認してください。要因が判明しない場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13017-E

An unexpected error occurred during collection of the record. (RecordName=＜レコード名＞)
レコードの収集中に予期しない異常が発生しました（RecordName=＜レコード名＞）

予期しない異常が発生したため，レコードの収集を中止します。

(S)

Agent Collectorサービスの処理を終了します。

(O)

保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13018-E

The IBM WebSphere MQ version is not supported.
IBM WebSphere MQ のバージョンがサポート対象外です。

IBM WebSphere MQ のバージョンがサポート対象外です。

(S)

Agent Collectorサービスの処理を終了します。

(O)

監視対象のIBM WebSphere MQが，サポート対象とされているバージョンのものか確認してください。サポート対象外のIBM WebSphere MQの場合，監視できません。

KAVL13019-W

An MQI/MQAI call failed due to an error in the ＜関数名＞ function. (compcode=＜完了コード＞, reason=＜理由コード＞)
MQI/MQAI呼び出しが関数 ＜関数名＞（compcode=＜完了コード＞, reason=＜理由コード＞）で失敗しました。

IBM WebSphere MQに対するMQIまたはMQAI呼び出しが失敗しました。

(S)

Agent Collectorサービスの処理を続行します。

(O)

理由コード（reason）を基に対処してください。reasonの内容については，IBM WebSphere MQのマニュアルを参照してください。

KAVL13020-W

An invalid value or a value outside the range was specified for the ＜プロパティ名＞ property of the Agent Collector service. (Range:＜範囲値＞)
Agent Collectorサービスのプロパティ＜プロパティ名＞に不正な値または範囲外の値が指定されました。（Range:＜範囲値＞）

Agent Collectorサービスのプロパティに不正な値または範囲外の値が指定されました。

(S)

指定された値を無効にしてAgent Collectorの処理を続行します。該当する項目は変更前の値のままです。

(O)

設定された値で問題がないかどうかを確認してください。問題がある場合は，適切な値を再度指定してください。

KAVL13021-E

An attempt to read the MQI library file failed.
MQIライブラリファイルのロードに失敗しました

MQIライブラリファイルのロードに失敗しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

IBM WebSphere MQが正常にインストールされているか確認してください。

KAVL13022-E

The version of MQI library file could not get.
MQIライブラリファイルのバージョン取得に失敗しました

MQIライブラリファイルのバージョン取得に失敗しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

共通メッセージログに出力されている直前のメッセージを確認し，そのメッセージの対処方法に従ってください。

KAVL13100-E

Failed to output to Agent log. ＜OS関数＞ failed. (Error code =＜エラーコード＞)

エージェントログの出力に失敗しました。OS関数がエラーコードで失敗しました。

(S)

Agent Collectorの処理を続行します。これ以降，エラー原因が取り除かれるまで，エージェントログは採取されません。

(O)

エージェントログの出力先のパス，アクセス権限などを確認してください。

KAVL13101-E

An error occurred in OS function ＜関数名＞. (rc=＜エラーコード＞)

関数名に示される関数の実行中にエラーが発生しました。エラーコードはシステムコールが返却する値です。

(S)

Agent Collectorの処理を続行します。

(O)

OSのリソースが不足していないこと，OS全般に障害が発生していないことを確認してください。このメッセージが連続して出力されている場合，監視対象のシステム環境の設定に誤りがないかどうか確認してください。要因が判明しない場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13102-I

Records collection started.

レコード収集処理を開始しました。

(S)

Agent Collectorの処理を続行します。

KAVL13103-I

Connection to IBM WebSphere MQ started.

IBM WebSphere MQへの接続を開始します。

(S)

Agent Collectorの処理を続行します。

KAVL13104-I

Connection to IBM WebSphere MQ ended normally.

IBM WebSphere MQとの接続が完了しました。

(S)

Agent Collectorの処理を続行します。

KAVL13105-I

The process of the record started = ＜レコード名＞

該当するレコードに関する処理を開始します。

(S)

Agent Collectorの処理を続行します。

KAVL13106-I

The execution of the command started = ＜コマンド名＞

IBM WebSphere MQへのコマンド名コマンドの発行を開始しました。

(S)

Agent Collectorの処理を続行します。

KAVL13107-I

The execution of the command ended = ＜コマンド名＞

IBM WebSphere MQへのコマンド名コマンドの発行を完了しました。

(S)

Agent Collectorの処理を続行します。

KAVL13108-I

Getting record ended = ＜レコード名＞ -> Storing started [ count = ＜レコード数＞ ]

該当するレコードをレコード数分Storeデータベースへ保存開始します。

(S)

Agent Collectorの処理を続行します。

KAVL13109-I

The Process of the record ended = ＜レコード名＞

該当するレコードに関する処理を終了します。

(S)

Agent Collectorの処理を続行します。

KAVL13110-I

Records collection ended.

IBM WebSphere MQとの接続をクローズし，レコード収集処理を終了します。

(S)

Agent Collectorの処理を続行します。

KAVL13114-W

Agent property ＜プロパティ名＞ is outside injustice or the range. (Range: ＜範囲値＞ )

Agent Collectorサービスのプロパティに不正な値または範囲外の値が指定されました。

(S)

指定された値を無効にしてAgent Collectorの処理を続行します。該当する項目は変更前の値のままです。

(O)

設定された値で問題がないかどうかを確認してください。問題がある場合は，適切な値を再度指定してください。

KAVL13115-E

An error occurred: ＜エラー詳細内容＞

Agent Collectorサービスの処理中にエラーが発生しました。

(S)

Agent Collectorの処理を終了します。

(O)

次のことを確認してください。

OSのリソースが不足していないこと。

OS全般に障害が発生していないこと。

このメッセージが連続して出力されている場合，監視対象のシステム環境の設定に誤りがないかどうか確認してください。要因が判明しない場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13116-W

A warning-level error occurred: ＜警告エラー詳細内容＞

Agent Collectorサービスの処理中に警告エラーが発生しました。

(S)

Agent Collectorの処理を続行します。

(O)

次のことを確認してください。

OSのリソースが不足していないこと。

OS全般に障害が発生していないこと。

監視対象のシステム環境の設定に誤りがないこと。

KAVL13117-W

The object to be monitored is not available. (host=＜ホスト名＞, service=＜サービスID＞)

監視対象のIBM WebSphere MQに接続できません。

(S)

Agent Collectorサービスの処理を続行します。

(O)

IBM WebSphere MQが正常に稼働しているかどうか確認してください。また，インスタンスのセットアップ時に設定した情報に誤りがないか確認してください。

KAVL13119-W

An MQI/MQAI call failed because of function ＜関数名＞. (compcode=＜完了コード＞, reason=＜理由コード＞)

IBM WebSphere MQに対するMQIまたはMQAI呼び出しが失敗しました。

(S)

Agent Collectorの処理を続行します。

(O)

理由コード（reason）を基に対処してください。reasonの内容については，IBM WebSphere MQのマニュアルを参照してください。

KAVL13123-E

Error occurred by function ＜関数名＞. (en=＜エラーコード＞,arg1=＜引数1＞, arg2=＜引数2＞, arg3=＜引数3＞)

関数名で示される関数の実行中に，エラーが発生しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13124-E

Processing was interrupted by signal. (signal=＜シグナル番号＞)

シグナルによって処理が中断されました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13125-E

An attempt to allocate memory failed. (RecordName=＜レコード名＞, Size=＜取得サイズ＞)

メモリーの確保に失敗しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

空きメモリーを増やしてください。

KAVL13127-W

An attempt to allocate memory failed. (RecordName=＜レコード名＞, Size=＜取得サイズ＞)

メモリーの確保に失敗しました。

(S)

Agent Collectorサービスの処理を続行します。

(O)

空きメモリーを増やしてください。

KAVL13128-W

An attempt to collect a record failed. (RecordName=＜レコード名＞)

レコード名に示されるレコードの取得に失敗しました。

(S)

Agent Collectorサービスの処理を続行します。

(O)

このメッセージが連続して出力されている場合，監視対象のシステム環境の設定に誤りがないかどうか確認してください。要因が判明しない場合，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL13129-E

An unexpected abnormality occurred during the collection of records. (RecordName=＜レコード名＞)

予期しない異常が発生したため，レコードの収集を中止します。

(S)

Agent Collectorサービスの処理を終了します。

(O)

保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

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

この章では，Performance Managementの運用中にトラブルが発生した場合の対処方法などについて説明します。ここでは，主にPFM - Agentでトラブルが発生した場合の対処方法について記載しています。Performance Managementシステム全体のトラブルへの対処方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

＜この章の構成＞

8.1　対処の手順

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

8.3　ログ情報

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

8.5　資料の採取方法

8.6　Performance Managementの障害検知

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

8.1　対処の手順

Performance Managementでトラブルが起きた場合の対処の手順を次に示します。

現象の確認

次の内容を確認してください。

トラブルが発生したときの現象

メッセージの内容（メッセージが出力されている場合）

共通メッセージログなどのログ情報

各メッセージの要因と対処方法については，「7.　メッセージ」を参照してください。また，Performance Managementが出力するログ情報については，「8.3　ログ情報」を参照してください。

資料の採取

トラブルの要因を調べるために資料の採取が必要です。「8.4　トラブル発生時に採取が必要な資料」および「8.5　資料の採取方法」を参照して，必要な資料を採取してください。

問題の調査

採取した資料を基に問題の要因を調査し，問題が発生している部分，または問題の範囲を切り分けてください。

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

ここでは，Performance Management使用時のトラブルシューティングについて記述します。Performance Managementを使用しているときにトラブルが発生した場合，まず，この節で説明している現象が発生していないか確認してください。

Performance Managementに発生する主なトラブルの内容を次の表に示します。

表8-1　トラブルシューティング

分類
トラブルの内容
記述個所

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

Performance Managementのプログラムのサービスが起動しない

サービスの起動要求をしてからサービスが起動するまで時間が掛かる

Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

8.2.1

コマンドの実行について

jpcctrl listコマンドを実行すると稼働していないサービス名が出力される

jpcctrl dumpコマンドを実行すると，指定したStoreデータベースと異なるデータが出力される

8.2.2

アラームの定義について

アクション実行で定義したプログラムが正しく動作しない

アラームイベントが表示されない

8.2.3

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

データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

PFM - Agentを起動してもパフォーマンスデータが収集されない

8.2.4

＜この節の構成＞

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

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

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

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

8.2.5　そのほかのトラブルについて

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

セットアップやサービスの起動に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　Performance Managementのプログラムのサービスが起動しない

(2)　サービスの起動要求をしてからサービスが起動するまで時間が掛かる

(3)　Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

(4)　「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

(1)　Performance Managementのプログラムのサービスが起動しない

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データベースのインポート先ディレクトリ

また，これらのディレクトリを複数のAgent Storeサービスに対して設定していると，Agent Storeサービスは起動できません。ディレクトリ設定を見直し，誤りがあれば修正してください。

指定された方法以外の方法でマシンのホスト名を変更した
マシンのホスト名の変更方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。指定された方法以外の方法でホスト名を変更した場合，Performance Managementのプログラムのサービスが起動しないことがあります。

サービスコントロールマネージャーでエラーが発生した
Windowsでjpcstartコマンドを実行した場合，「Windowsのサービスコントロールマネージャーでエラーが発生しました」というエラーメッセージが出力され，サービスの起動に失敗することがあります。この現象が発生した場合，jpcstartコマンドを再実行してください。頻繁に同じ現象が発生する場合は，jpcstartコマンド実行時にサービス起動処理がリトライされる間隔および回数を，jpccomm.iniファイルを編集して変更してください。リトライ間隔およびリトライ回数を変更する方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

(2)　サービスの起動要求をしてからサービスが起動するまで時間が掛かる

jpcstartコマンドを実行してから，または［サービス］アイコンでサービスを開始してから，実際にサービスが起動するまで時間が掛かることがあります。次の要因で時間が掛かっている場合，2回目の起動時からはサービスの起動までに掛かる時間が短縮されます。

システム停止時にサービスを自動で停止させる設定をしないで，システムを再起動してサービスを起動すると，Storeデータベースのインデックスが再構築される場合があります。この場合，サービスが起動するまでに時間が掛かることがあります。

エージェントを新規に追加したあとサービスを起動すると，初回起動時だけStoreデータベースのインデックスが作成されます。そのため，サービスが起動するまでに時間が掛かることがあります。

電源切断などによってStoreサービスが正常な終了処理を行えなかったときは，再起動時にStoreデータベースのインデックスが再構築されるため，Storeサービスの起動に時間が掛かることがあります。

(3)　Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

Performance Managementのプログラムのサービスを停止した直後に，このサービスが使用していたポート番号で，ほかのプログラムがサービスを開始した場合，通信が正しく実行されないことがあります。この現象を回避するために，次のどちらかの設定をしてください。

Performance Managementのプログラムのサービスのポート番号を固定する
Performance Managementのプログラムの各サービスに対して，固定のポート番号を割り当てて運用してください。ポート番号の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

TCP_TIMEWAIT値を設定する
TCP_TIMEWAIT値で接続待ち時間を設定してください。接続待ち時間をデフォルトの設定としてください。デフォルト値は，次のとおりです。

Windows 2000の場合：4分

Windows Server 2003の場合：2分

AIXの場合，次のように指定して，接続待ち時間を75秒以上にしてください。

AIXの場合：tcp_timewait:5

(4)　「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

Storeデータベースが使用しているディスクに十分な空き容量がない場合，Storeデータベースへのデータの格納が中断されます。この場合，「ディスク容量が不足しています」というメッセージが出力されたあと，Master StoreサービスまたはAgent Storeサービスが停止します。

このメッセージが表示された場合，次のどちらかの対処をしてください。

十分なディスク容量を確保する
Storeデータベースのディスク占有量を見積もり，Storeデータベースの格納先を十分な容量があるディスクに変更してください。Storeデータベースのディスク占有量を見積もる方法については，「付録A　システム見積もり」を参照してください。Storeデータベースの格納先を変更する方法については，「2.4.1　パフォーマンスデータの格納先の変更」（Windowsの場合），または「3.4.1　パフォーマンスデータの格納先の変更」（UNIXの場合）を参照してください。

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データベースの格納先ディレクトリについては，「2.4.1　パフォーマンスデータの格納先の変更」，または「3.4.1　パフォーマンスデータの格納先の変更」を参照してください。

8.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 システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(2)　jpcctrl dumpコマンドを実行すると，指定したStoreデータベースと異なるデータが出力される

同じMaster StoreサービスまたはAgent Storeサービスに対して，同じエクスポートファイル名を指定して，複数回jpcctrl dumpコマンドを実行すると，先に実行した出力結果があとから実行された実行結果に上書きされます。同じMaster StoreサービスまたはAgent Storeサービスに対して，複数回jpcctrl dumpコマンドを実行する場合は，異なる名称のエクスポートファイルを指定してください。Storeデータベースのエクスポート方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

8.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を起動しておいてください。

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

Performance Managementのパフォーマンスデータの収集と管理に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

(2)　共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

(3)　PFM - Agentを起動してもパフォーマンスデータが収集されない

(1)　データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

Storeデータベースのファイル容量がすでに限界に達している場合，データの保存期間を短く設定してもファイルサイズは小さくなりません。この場合，保存期間を短く設定したあと，いったんStoreデータベースをバックアップし，リストアし直してください。

データの保存期間の設定方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，稼働監視データの管理について説明している章を参照してください。また，Storeデータベースのバックアップとリストアの方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，バックアップとリストアについて説明している章を参照してください。

(2)　共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

予期しないサービスの停止またはマシンのシャットダウンによって，Storeデータベースに不整合なデータが発生したおそれがあります。次の方法で対処をしてください。

Storeデータベースをバックアップしてある場合は，Storeデータベースをリストアしてください。

Storeデータベースをバックアップしていない場合は，Agent Storeサービスを停止したあと，対応するデータベースファイル（*.DBファイルおよび*.IDXファイル）を削除し，サービスを再起動してください。

(3)　PFM - Agentを起動してもパフォーマンスデータが収集されない

次の方法で対処してください。

PDレコードのQ Mgr Statusフィールドの値がQM_ERROR，またはCMD_ERRORの場合，Reason code numericフィールド，およびReason code stringフィールドに出力されるエラーコードを参考に対処してください。エラーコードの詳細は，IBM WebSphere MQのマニュアルを参照してください。
Reason code numericフィールドの値が2058，Reason code stringフィールドの値がMQRC_Q_MGR_NAME_ERRORである場合，指定したキューマネージャー名が誤っている可能性があります。インスタンス環境のセットアップ時の設定を見直してください。

共通メッセージログを確認し，Reasonコードの値が2035である場合，サービスを運用しているユーザーが，mqmグループに属していないユーザーであるおそれがあります。サービスを運用しているユーザーの設定を見直してください。

8.2.5　そのほかのトラブルについて

トラブルが発生したときの現象を確認してください。メッセージが出力されている場合は，メッセージの内容を確認してください。また，Performance Managementが出力するログ情報については，「8.3　ログ情報」を参照してください。

「8.2.1　セットアップやサービスの起動について」から「8.2.4　パフォーマンスデータの収集と管理について」に示した対処をしても，トラブルが解決できなかった場合，または，これら以外のトラブルが発生した場合，トラブルの要因を調査するための資料を採取し，システム管理者に連絡してください。

採取が必要な資料および採取方法については，「8.4　トラブル発生時に採取が必要な資料」および「8.5　資料の採取方法」を参照してください。

8.3　ログ情報

Performance Managementでトラブルが発生した場合，ログ情報を確認して対処方法を検討します。Performance Managementを運用しているときに出力されるログ情報には，次の5種類があります。

システムログ

共通メッセージログ

稼働状況ログ

トレースログ

エージェントログ

ここでは，各ログ情報について説明します。

＜この節の構成＞

8.3.1　ログ情報の種類

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

8.3.1　ログ情報の種類

＜この項の構成＞

(1)　システムログ

(2)　共通メッセージログ

(3)　稼働状況ログ

(4)　トレースログ

(5)　エージェントログ

(1)　システムログ

システムログとは，システムの状態やトラブルを通知するログ情報のことです。このログ情報は次のログファイルに出力されます。

Windowsの場合
イベントログファイル

UNIXの場合
syslogファイル

出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

論理ホスト運用の場合の注意事項

Performance Managementのシステムログのほかに，クラスタソフトによるPerformance Managementの制御などを確認するためにクラスタソフトのログが必要です。

(2)　共通メッセージログ

共通メッセージログとは，システムの状態やトラブルを通知するログ情報のことです。システムログよりも詳しいログ情報が出力されます。共通メッセージログの出力先ファイル名やファイルサイズについては，「8.3.2　ログファイルおよびディレクトリ一覧」を参照してください。また，出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

論理ホスト運用の場合の注意事項

論理ホスト運用のPerformance Managementの場合，共通メッセージログは共有ディスクに出力されます。共有ディスク上にあるログファイルは，フェールオーバーするときにシステムとともに引き継がれますので，メッセージは同じログファイルに記録されます。

(3)　稼働状況ログ

稼働状況ログとは，PFM - Web Consoleが出力するログ情報のことです。稼働状況ログの出力先ファイル名やファイルサイズについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。また，出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

(4)　トレースログ

トレースログとは，トラブルが発生した場合に，トラブル発生の経緯を調査したり，各処理の処理時間を測定したりするために採取するログ情報のことです。

トレースログは，Performance Managementのプログラムの各サービスが持つログファイルに出力されます。

論理ホスト運用の場合の注意事項

論理ホスト運用のPerformance Managementの場合，トレースログは共有ディスクに出力されます。共有ディスク上にあるログファイルは，フェールオーバーするときにシステムとともに引き継がれますので，メッセージは同じログファイルに記録されます。

(5)　エージェントログ

エージェントログとは，レコードの取得に関連する処理のログ情報で，PFM - Agent for IBM WebSphere MQが出力します。トラブルが発生した場合に，これらの処理の詳細情報を取得するために採取します。エージェントログは，通常ログ，異常ログが別ファイルに出力されます。エージェントログについては，「8.3.2(3)　エージェントログ」を参照してください。

形式

エージェントログは次に示す形式で出力されます。

yyyy/mm/dd hh:mm:ss.sss agt9 PID inf1 inf2 inf3 MessageID Message

出力される各項目について説明します。

表8-2　エージェントログの項目

項目 | 説明
yyyy/mm/dd | ログが出力された日付（yyyy：年，mm：月，dd：日）
hh:mm:ss.sss | ログが出力されたローカル時刻（hh：時，mm：分，ss：秒，sss：ミリ秒）
agt9 | ログを出力したプロセス名（agt9はPFM - Agent for IBM WebSphere MQのプロセス名）
PID | 出力プロセスID
inf1～inf3 | 保守情報
MessageID | メッセージID※
Message | メッセージ※

注※

メッセージの内容については，「7.　メッセージ」を参照してください。

注意

Agentホストの時刻やエージェントログファイルの更新日時は変更しないでください。エージェントログの出力にはログファイルの最終更新日時の情報が使用されるため，これらを変更した場合，エージェントログが正しく出力されないおそれがあります。

論理ホスト運用のPerformance Managementの場合，エージェントログの出力先は，実行系と待機系で同一となるように，共有ディスク上のパスを設定してください。

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

ここでは，Performance Managementのプログラムから出力されるログ情報について説明します。稼働状況ログの出力先ファイル名やファイルサイズについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

＜この項の構成＞

(1)　共通メッセージログ

(2)　トレースログ

(3)　エージェントログ

(1)　共通メッセージログ

ここでは，Performance Managementのログ情報のうち，共通メッセージログについて，ログの出力元であるサービス名または制御名，ログファイル名，およびディスク使用量を，OSごとに表に示します。

表8-3　共通メッセージログのファイル名（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)

表8-4　共通メッセージログのファイル名（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ごとに表に示します。

表8-5　トレースログの格納先フォルダ名（Windowsの場合）

ログ情報の種類
出力元
フォルダ名

トレースログ
Action Handlerサービス
インストール先フォルダ¥bin¥action¥log¥

Performance Managementコマンド
インストール先フォルダ¥tools¥log¥

Agent Collectorサービス
インストール先フォルダ¥agt9¥agent¥インスタンス名¥log¥

Agent Storeサービス
インストール先フォルダ¥agt9¥store¥インスタンス名¥log¥

Status Serverサービス
インストール先フォルダ¥bin¥statsvr¥log¥

トレースログ
（論理ホスト運用の場合）
Action Handlerサービス
環境フォルダ※¥jp1pc¥bin¥action¥log¥

Performance Managementコマンド
環境フォルダ※¥jp1pc¥tools¥log¥

Agent Collectorサービス
環境フォルダ※¥jp1pc¥agt9¥agent¥インスタンス名¥log¥

Agent Storeサービス
環境フォルダ※¥jp1pc¥agt9¥store¥インスタンス名¥log¥

表8-6　トレースログの格納先フォルダ名（UNIXの場合）

ログ情報の種類
出力元
フォルダ名

トレースログ
Action Handlerサービス
/opt/jp1pc/bin/action/log/

Performance Managementコマンド
/opt/jp1pc/tools/log/

Agent Collectorサービス
/opt/jp1pc/agt9/agent/インスタンス名/log/

Agent Storeサービス
/opt/jp1pc/agt9/store/インスタンス名/log/

Status Serverサービス
/opt/jp1pc/bin/statsvr/log/

トレースログ
（論理ホスト運用の場合）
Action Handlerサービス
環境ディレクトリ※/jp1pc/bin/action/log/

Performance Managementコマンド
環境ディレクトリ※/jp1pc/tools/log/

Agent Collectorサービス
環境ディレクトリ※/jp1pc/agt9/agent/インスタンス名/log/

Agent Storeサービス
環境ディレクトリ※/jp1pc/agt9/store/インスタンス名/log/

注※

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

(3)　エージェントログ

ここでは，Performance Managementのログ情報のうち，PFM - Agent for IBM WebSphere MQのエージェントログの出力元であるサービス名または制御名，ログファイル名，およびディスク使用量を次の表に示します。

表8-7　エージェントログのファイル

ログ情報の種類
出力元
出力先
ファイル名
デフォルトのディスク使用量※1（メガバイト）

通常ログ
PFM - Agent for IBM WebSphere MQ

Windowsの場合
インストール先フォルダ¥agt9¥agent¥インスタンス名¥log¥

UNIXの場合
/opt/jp1pc/agt9/agent/インスタンス名/log/

agt9inf{01|02}※2
16

異常ログ
agt9err{01|02}※2

通常ログ
（論理ホスト運用の場合）
PFM - Agent for IBM WebSphere MQ

Windowsの場合
環境フォルダ※3 ¥jp1pc¥agt9¥agent¥インスタンス名¥log¥

UNIXの場合
環境ディレクトリ※3 /jp1pc/agt9/agent/インスタンス名/log/

Agt9inf{01|02}※2
16

異常ログ
（論理ホスト運用の場合）
Agt9err{01|02}※2

注※1

エージェントログの最大ファイルサイズは，次の方法で確認・変更できます。

jpcinssetupコマンド

PFM - Web Console画面のAgent Configurationプロパティ

jpcinssetupコマンドでの変更方法については，「2.4.2　インスタンス環境の更新の設定」（Windowsの場合），または「3.4.2　インスタンス環境の更新の設定」（UNIXの場合）を参照してください。

注※2

エージェントログは，二つのファイルを使用してラップラウンドで出力されます。ファイル名には，末尾に「01」または「02」が付加されます。ファイル名に付加される数字の意味を次に示します。

01：カレントファイル

02：バックアップファイル

ラップラウンドについては，「(1)　共通メッセージログ」の「ラップラウンドファイル（jpclogw）方式の場合」を参照してください。

注※3

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

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

「8.2　トラブルシューティング」に示した対処をしてもトラブルを解決できなかった場合，トラブルの要因を調べるための資料を採取し，システム管理者に連絡する必要があります。この節では，トラブル発生時に採取が必要な資料について説明します。

Performance Managementでは，採取が必要な資料を一括採取するためのコマンドを用意しています。PFM - Agentの資料を採取するには，jpcrasコマンドを使用します。jpcrasコマンドを使用して採取できる資料については，表中に記号で示しています。

注意

jpcrasコマンドで採取できる資料は，コマンド実行時に指定するオプションによって異なります。コマンドに指定するオプションと採取できる資料については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

論理ホスト運用の場合の注意事項

論理ホスト運用の場合の注意事項を次に示します。

論理ホスト運用する場合のPerformance Managementのログは，共有ディスクに格納されます。共有ディスクがオンラインになっている場合（Windows）またはマウントされている場合（UNIX）は，jpcrasコマンドで共有ディスク上のログを一括して採取できます。

フェールオーバー時の問題を調査するには，フェールオーバーの前後の資料が必要です。このため，実行系と待機系の両方の資料が必要になります。

論理ホスト運用のPerformance Managementの調査には，クラスタソフトの資料が必要です。論理ホスト運用のPerformance Managementは，クラスタソフトから起動や停止を制御されているので，クラスタソフトの動きとPerformance Managementの動きを対比して調査するためです。

＜この節の構成＞

8.4.1　Windowsの場合

8.4.2　UNIXの場合

8.4.1　Windowsの場合

＜この項の構成＞

(1)　OSのログ情報

(2)　Performance Managementの情報

(3)　IBM WebSphere MQの情報

(4)　オペレーション内容

(5)　画面上のエラー情報

(6)　そのほかの情報

(1)　OSのログ情報

OSのログ情報で，採取が必要な情報を次の表に示します。

表8-8　OSのログ情報（Windowsの場合）

情報の種類
概要
デフォルトのファイル名
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の場合
システムドライブ¥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に関する次の情報の採取が必要です。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。Performance Managementの情報を次の表に示します。

表8-9　Performance Managementの情報（Windowsの場合）

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

共通メッセージログ
Performance Managementから出力されるメッセージログ
（シーケンシャルファイル方式）
インストール先フォルダ¥log
¥jpclog{01|02}※1
○

Performance Managementから出力されるメッセージログ
（ラップラウンドファイル方式）
インストール先フォルダ¥log
¥jpclogw{01|02}※1
○

構成情報
各構成情報ファイル
－
○

jpcctrl listコマンドの出力結果
－
○

バージョン情報
製品バージョン
－
○

履歴情報
－
○

データベース情報
Agent Storeサービス

Storeバージョン1.0の場合
インストール先フォルダ¥agt9¥store
¥インスタンス名¥*.DB
インストール先フォルダ¥agt9¥store
¥インスタンス名¥*.IDX

Storeバージョン2.0の場合
インストール先フォルダ¥agt9¥store¥インスタンス名¥STPD
インストール先フォルダ¥agt9¥store¥インスタンス名¥STPI
フォルダ下の次に示すファイル。
*.DB
*.IDX

○

トレースログ
Performance Managementのプログラムの各サービスのトレース情報
－※2
○

エージェントログ
PFM - Agent for IBM WebSphere MQのレコード取得に関する処理の通常ログ
インストール先フォルダ¥agt9¥agent
¥インスタンス名¥log¥agt9inf{01|02}
○

PFM - Agent for IBM WebSphere MQのレコード取得に関する処理の異常ログ
インストール先フォルダ¥agt9¥agent
¥インスタンス名¥log¥agt9err{01|02}
○

インストールログ※3
インストール時のメッセージログ
（Windows 2000，Windows Server 2003の場合）
%TEMP%¥pfm_inst.log
×

（凡例）

○：採取できる

×：採取できない

－：該当しない

注※1

ログファイルの出力方式については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※2

トレースログの格納先フォルダについては，「8.3.2　ログファイルおよびディレクトリ一覧」を参照してください。

注※3

インストールに失敗した場合に採取してください。

(3)　IBM WebSphere MQの情報

IBM WebSphere MQに関するレジストリ情報を採取します。採取する情報を次の表に示します。

表8-10　IBM WebSphere MQの情報（Windowsの場合）

情報の種類
概要
レジストリのキー名
jpcrasコマンドでの採取

構成情報
各構成情報
HKEY_LOCAL_MACHINE¥SOFTWARE¥IBM
¥MQSeries¥CurrentVersion(Windows Server 2003(x64)環境以外)
HKEY_LOCAL_MACHINE¥SOFTWARE¥
Wow6432Node¥IBM
¥MQSeries¥CurrentVersion(Windows Server 2003(x64)環境)
○

サービス情報
キューマネージャーのスタートアップなどを管理するサービスに関する情報
HKEY_LOCAL_MACHINE¥SYSTEM
¥CurrentControlSet¥Services¥MQSeriesServices
○

（凡例）

○：採取できる

(4)　オペレーション内容

トラブル発生時のオペレーション内容について，次に示す情報が必要です。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

(5)　画面上のエラー情報

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー（詳細ボタンがある場合はその内容を含む）

コマンド実行時にトラブルが発生した場合は，［コマンドプロンプト］画面のハードコピー

(6)　そのほかの情報

上記以外で必要な情報を次に示します。

Windowsの［イベントビューア］画面の，［システムログ］および［アプリケーションログ］の内容（Windows 2000の場合）

Windowsの［イベントビューア］画面の，［システム］および［アプリケーション］の内容（Windows Server 2003の場合）

［コンピュータの管理］の［システム情報］の内容，または［アクセサリ］－［システムツール］－［システム情報］の内容（Windows 2000の場合）

［アクセサリ］－［システムツール］－［システム情報］の内容（Windows Server 2003の場合）

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

8.4.2　UNIXの場合

＜この項の構成＞

(1)　OSのログ情報

(2)　Performance Managementの情報

(3)　IBM WebSphere MQの情報

(4)　オペレーション内容

(5)　画面上のエラー情報

(6)　そのほかの情報

(1)　OSのログ情報

OSのログ情報で，採取が必要な情報を次の表に示します。

表8-11　OSのログ情報（UNIXの場合）

情報の種類 | 概要 | デフォルトのファイル名 | jpcrasコマンドでの採取
システムログ | syslog | － | ○※1
プロセス情報 | プロセスの一覧 | － | ○
システムファイル | hostsファイル | /etc/hosts | ○
/etc/inet/ipnodes※2 | ○※3
servicesファイル | /etc/services | ○
OS情報 | パッチ情報 | － | ○
カーネル情報 | － | ○
バージョン情報 | － | ○
ネットワークステータス | － | ○
環境変数 | － | ○
ホスト名 | － | ○
ダンプ情報 | coreファイル | － | ○

（凡例）

○：採取できる

－：該当しない

注※1

デフォルトのパスおよびファイル名以外に，出力されるように設定されているシステムでは，収集できません。手動で収集してください。

注※2

/etc/inet/ipnodesファイルはSolarisだけに存在するファイルです。/etc/hostsファイルと一緒に収集してください。

注※3

PFM - Manager 08-50以降またはPFM - Base 08-50以降のjpcrasコマンドだけで収集できます。

(2)　Performance Managementの情報

Performance Managementに関する次の情報の採取が必要です。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。Performance Managementの情報を次の表に示します。

表8-12　Performance Managementの情報（UNIXの場合）

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

共通メッセージログ
Performance Managementから出力されるメッセージログ
（シーケンシャルファイル方式）
/opt/jp1pc/log/jpclog{01|02}※1
○

Performance Managementから出力されるメッセージログ
（ラップラウンドファイル方式）
/opt/jp1pc/log/jpclogw{01|02}※1
○

構成情報
各構成情報ファイル
－
○

jpcctrl listコマンドの出力結果
－
○

バージョン情報
製品バージョン
－
○

履歴情報
－
○

データベース情報
Agent Storeサービス

Storeバージョン1.0の場合
/opt/jp1pc/agt9/store/インスタンス名/*.DB
/opt/jp1pc/agt9/store/インスタンス名/*.IDX

Storeバージョン2.0の場合
/opt/jp1pc/agt9/store/インスタンス名/STPD
/opt/jp1pc/agt9/store/インスタンス名/STPI
/opt/jp1pc/agt9/store/インスタンス名/STPL
ディレクトリ下の次に示すファイル。
*.DB
*.IDX

○

トレースログ
Performance Managementのプログラムの各サービスのトレース情報
－※2
○

エージェントログ
PFM - Agent for IBM WebSphere MQのレコード取得に関する処理の通常ログ
/opt/jp1pc/agt9/agent/インスタンス名/log/agt9inf{01|02}※4
○

PFM - Agent for IBM WebSphere MQのレコード取得に関する処理の異常ログ
/opt/jp1pc/agt9/agent/インスタンス名/log/agt9err{01|02}※4
○

インストールログ※3
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}
×

（凡例）

○：採取できる

×：採取できない

－：該当しない

注※1

ログファイルの出力方式については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※2

トレースログの格納先フォルダについては，「8.3.2　ログファイルおよびディレクトリ一覧」を参照してください。

注※3

インストールに失敗した場合に採取してください。

注※4

エージェントログの出力方式，および格納先フォルダの変更方法については，「8.3.2　ログファイルおよびディレクトリ一覧」を参照してください。

(3)　IBM WebSphere MQの情報

IBM WebSphere MQに関する情報を採取します。採取する情報を次の表に示します。

表8-13　IBM WebSphere MQの情報（UNIXの場合）

情報の種類
概要
情報詳細内容
jpcrasコマンドでの採取

バージョン情報
IBM WebSphere MQのバージョン情報
IBM WebSphere MQのバージョン情報。
IBM WebSphere MQが提供するdspmqverコマンドの出力結果。
○

ファイルリスト
IBM WebSphere MQのファイルリスト
IBM WebSphere MQのインストールディレクトリ /usr/mqm 配下のファイルリスト。
OSコマンドls -lRの出力結果。
○

（凡例）

○：採取できる

(4)　オペレーション内容

トラブル発生時のオペレーション内容について，次に示す情報が必要です。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

(5)　画面上のエラー情報

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

コマンド実行時にトラブルが発生した場合は，コンソールに出力されたメッセージ

(6)　そのほかの情報

上記以外で必要な情報を次に示します。

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

8.5　資料の採取方法

トラブルが発生したときに資料を採取する方法を次に示します。

＜この節の構成＞

8.5.1　Windowsの場合

8.5.2　UNIXの場合

8.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)の場合）

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

8.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コマンドで圧縮された形式で，指定されたディレクトリに格納されます。ファイル名を次に示します。

jpcras YYMMDD.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)　そのほかの情報を採取する

上記以外で必要な情報を採取してください。

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

8.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の障害検知について説明している章を参照してください。

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

Performance Managementのサーバで障害が発生したときは，バックアップファイルを基にして，障害が発生する前の正常な状態に回復する必要があります。

障害が発生する前の状態に回復する手順については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

付録

＜この付録の構成＞

付録A　システム見積もり

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

付録C　識別子一覧

付録D　プロセス一覧

付録E　ポート番号一覧

付録F　PFM - Agent for IBM WebSphere MQのプロパティ

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

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

付録I　バージョン互換

付録J　動作ログの出力

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

付録L　用語解説

付録A　システム見積もり

PFM - Agent for IBM WebSphere MQを使ったシステムを構築する前に，使用するマシンの性能が，PFM - Agent for IBM WebSphere MQを運用するのに十分であるか，見積もっておくことをお勧めします。

見積もり項目を次に説明します。

＜この節の構成＞

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

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

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

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

メモリー所要量は，PFM - Agent for IBM WebSphere MQの設定状況や使用状況によって変化します。PFM - Agent for IBM WebSphere MQのメモリー所要量の，おおよその見積もりをOSごとに記載します。初期状態とは，1インスタンスで運用する場合のことを示します。

＜この項の構成＞

(1)　見積もり式（Windowsの場合）

(2)　見積もり式（UNIXの場合）

(1)　見積もり式（Windowsの場合）

Windowsの場合の，PFM - Agent for IBM WebSphere MQのメモリー所要量の，おおよその見積もりを次の表に示します。

表A-1　メモリー所要量（Windowsの場合）

PFM - Agent for IBM WebSphere MQの状態
メモリー所要量（単位：メガバイト）

Windows 2000
Windows Server 2003

初期状態での運用
a＋b

初期状態以外での運用
(a＋b)＊n

（凡例）

a：jpcagt9プロセスのメモリー使用量

b：jpcstoプロセスのメモリー使用量

n：PFM - Agent for IBM WebSphere MQのインスタンス数

各プロセスのメモリー使用量は，OSによって異なります。各プロセスのメモリー所要量について次の表に示します。

表A-2　プロセスのメモリー所要量（Windowsの場合）

プロセス名
プロセスのメモリー所要量（単位：メガバイト）

Windows 2000
Windows Server 2003

jpcagt9
10

jpcsto
10

(2)　見積もり式（UNIXの場合）

UNIXの場合の，PFM - Agent for IBM WebSphere MQのメモリー所要量の，おおよその見積もりを次の表に示します。

表A-3　メモリー所要量（UNIXの場合）

PFM - Agent for IBM WebSphere MQの状態 | メモリー所要量（単位：メガバイト）
AIX
初期状態での運用 | a＋b
初期状態以外での運用 | (a＋b)＊n

（凡例）

a：jpcagt9プロセスのメモリー使用量

b：jpcstoプロセスのメモリー使用量

n：PFM - Agent for IBM WebSphere MQのインスタンス数

各プロセスのメモリー使用量は，OSによって異なります。各プロセスのメモリー所要量について次の表に示します。

表A-4　プロセスのメモリー所要量（UNIXの場合）

プロセス名 | プロセスのメモリー所要量（単位：メガバイト）
AIX
jpcagt9 | 10
jpcsto | 10

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

ディスク占有量は，パフォーマンスデータを収集するレコード数によって変化します。

PFM - Agent for IBM WebSphere MQのディスク占有量の見積もりについて説明します。

＜この項の構成＞

(1)　システム全体のディスク占有量

(2)　Storeデータベース（Storeバージョン1.0）のディスク占有量

(3)　Storeデータベース（Storeバージョン2.0）のディスク占有量

(1)　システム全体のディスク占有量

システム全体のディスク占有量の見積もり値をOSごとに記載します。

(a)　Windowsの場合

PFM - Agent for IBM WebSphere MQのディスク占有量は，次のデータのファイルサイズによって変化します。

Agent Storeデータベース

PFM - Agent for IBM WebSphere MQのインスタンス数

エージェントログ

Windowsの場合の，システム全体のディスク占有量のおおよその見積もりを次の表に示します。

表A-5　システム全体のディスク占有量（Windowsの場合）

PFM - Agent for IBM WebSphere MQの状態
ディスク占有量（単位：メガバイト）

Windows 2000
Windows Server 2003

インストール時※1
1

初期状態での運用※2
200

運用時
a + b

（凡例）

a：インスタンスごとのディスク占有量の和。

インスタンスが一つの場合の，ディスク占有量の算出式を次に示します。

c + d + 130

b：インストール時のディスク占有量。

c：Storeデータベースのディスク占有量。

Storeデータベースのディスク占有量については，「(2)　Storeデータベース（Store バージョン1.0）のディスク占有量」または「(3)　Storeデータベース（Storeバージョン2.0）のディスク占有量」を参照してください。

d：エージェントログサイズ。

エージェントログのファイルサイズの上限は，128メガバイトです。

注※1

インストール時にはプログラム本体容量の2倍分のディスク容量が必要となります。

注※2

収集設定を行っていないPFM - Agent for IBM WebSphere MQのインスタンスが一つだけセットアップされている場合のことを示します。

(b)　UNIXの場合

PFM - Agent for IBM WebSphere MQのディスク占有量は，次のデータのファイルサイズによって変化します。

Agent Storeデータベース

PFM - Agent for IBM WebSphere MQのインスタンス数

エージェントログ

UNIXの場合の，システム全体のディスク占有量のおおよその見積もりを次の表に示します。

表A-6　システム全体のディスク占有量（UNIXの場合）

PFM - Agent for IBM WebSphere MQの状態 | ディスク占有量（単位：メガバイト）
AIX
インストール時※1 | 5
初期状態での運用※2 | 200
運用時 | a + b

（凡例）

a：インスタンスごとのディスク占有量の和。

インスタンスが一つの場合の，ディスク占有量の算出式を次に示します。

c + d + 130

b：インストール時のディスク占有量。

c：Storeデータベースのディスク占有量。

Storeデータベースのディスク占有量については，「(2)　Storeデータベース（Store バージョン1.0）のディスク占有量」または「(3)　Storeデータベース（Storeバージョン2.0）のディスク占有量」を参照してください。

d：エージェントログサイズ。

エージェントログのファイルサイズの上限は，128メガバイトです。

注※1

インストール時にはプログラム本体容量の2倍分のディスク容量が必要となります。

注※2

収集設定を行っていないPFM - Agent for IBM WebSphere MQのインスタンスが一つだけセットアップされている場合のことを示します。

(2)　Storeデータベース（Storeバージョン1.0）のディスク占有量

Storeデータベース（Storeバージョン1.0）のディスク占有量について説明します。

(a)　見積もり式

Storeデータベースでは，各レコードは，レコードタイプごとに一つのファイルに格納されます。

Storeデータベース（Storeバージョン1.0）のディスク占有量について，レコードタイプごとに次の表に示します。

表A-7　レコードタイプごとの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：履歴データを収集する各レコードのインスタンス数※6

（単数インスタンスレコードの場合は1）

f：履歴データを収集する各レコードの保存レコード数（インスタンス数は考慮しません）※4

g：履歴データを収集する各レコードの保存レコード数の上限値※5

注※1

{(d＊e)/(65,250-c)+1}の計算結果は，小数点以下を切り捨ててください。

注※2

(g/e)の計算結果は，小数点以下を切り捨ててください。

注※3

各レコードの固定部・可変部のサイズについては，「6.　レコード」を参照してください。

注※4

PIレコードタイプのレコードの場合，収集したデータがある一定の区分（時，日，週，月，および年単位）に自動的に要約されるので，分，時，日，週，月，および年の部分の保存レコード数を考慮して計算する必要があります。デフォルトの保存期間と保存レコード数を次の表に示します。

データの種類
保存期間
保存レコード数
（収集間隔が1分の場合）

分単位
1日
1,440

時単位
7日
168

日単位
1年
366

週単位
1年
52

月単位
1年
12

年単位
制限なし
（収集年数）＊1

注※5

保存レコード数については，「付録F.1　Agent Storeサービスのプロパティ一覧」を参照してください。

注※6

各レコードのインスタンス数の算出方法を次の表に示します。

また，算出方法を記載しているレコードに関しては，算出方法に従い算出してください。

表A-8　レコードのインスタンス数の算出方法

レコード
インスタンス数取得SQL文，または算出方法
確認方法

PD
インスタンス数は1です。
－

PI
予約レコードのため使用できません。
－

PD_QS
監視対象のキューマネージャーが持つキュー（システムキューを含む）の数。
※7

PD_QHS
監視対象のキューマネージャーが持つキュー（システムキューを含む）にアクセスしているアプリケーションのアクセス中ハンドル数。
ハンドルは，アプリケーションからキューへの接続を表します。
※8

PD_CS
監視対象のキューマネージャーが持つ，チャネル（システムチャネルを含む）の数。
※9

PI_CSI
監視対象のキューマネージャーが持つ，チャネル（システムチャネルを含む）の数。
※9

注※7

IBM WebSphere MQ エクスプローラーの「コンテンツ」ビューに，監視対象のキューマネージャーのキューの内容を次の条件で表示させた場合の，キューの総数です。

「フィルター」を「キューの標準」に設定

「システム・オブジェクトの表示」を設定

「一時キューの表示」を設定

詳しくは「IBM WebSphere MQ エクスプローラー」のヘルプを参照してください。

ただし，PFM - Agent for IBM WebSphere MQがIBM WebSphere MQにパフォーマンスデータの取得を要求する際に，一時キューを作成するため，実際のインスタンス数と異なる場合があります。

注※8

IBM WebSphere MQ エクスプローラーでは，注※7の各キューに対して「状況」を表示させ，「キュー・ハンドル状況」に表示されるハンドルの総数です。

詳しくは「IBM WebSphere MQ エクスプローラー」のヘルプを参照してください。

ただし，PFM - Agent for IBM WebSphere MQがIBM WebSphere MQにパフォーマンスデータの取得を要求する際に，一時キューにアクセスため，実際のインスタンス数と異なる場合があります。

注※9

IBM WebSphere MQ エクスプローラーの「コンテンツ」ビューに，監視対象のキューマネージャーのチャネルの内容を次の条件で表示させた場合の，チャネルの総数です。

「フィルター」を「チャネルの標準」に設定

「システム・オブジェクトの表示」を設定

詳しくは「IBM WebSphere MQ エクスプローラー」のヘルプを参照してください。

(b)　見積もり例

見積もり例１

OS がWindows で，Channel Status Interval（PI_CSI）について，PI_CSI以外のPI レコードタイプを保存設定していない場合。表A-7に示した変数a ～ f が次の値とします。

a=1
c=681
d=1,644
e=2
f=2,039

（eの求め方）

表A-8の，レコードに対応するパフォーマンスオブジェクトのインスタンス数を参照してください。今回はe=2とします。

（fの求め方）

PI_CSIの収集間隔を1分，年単位の収集年数を1年として，リテンションの設定が表A-7の注※4のとおりである場合。

(1,440+168+366+52+12+1)=2,039レコード
f=2,039

Xの算出式

X={d＊e+(c+1,900)＊{d＊e/(65,250-c)+1}}＊f＊1.5
X={1,644＊2+(681+1,900)＊{1,644＊2/(65,250-681)+1}}＊2,039＊1.5
={3,288+(2,581)＊{3,288/64,569+1}}＊3,058
={3,288+2,581＊1}＊3,058
=5,869＊3,058
=17,947,402 (バイト)
=約17(MB)

見積もり例2

OS がWindows で，PDレコードタイプのQueue Status（PD_QS）について，PD_QS以外のPDレコードタイプを保存設定していない場合。

b=1
c=681
d=384
e=3
g=2,232

（eの求め方）

表A-8のレコードに対応するパフォーマンスオブジェクトのインスタンス数を参照してください。今回はe=3とします。

（gの求め方）

リテンションの設定のデフォルトは10,000レコードです。

収集間隔を3,600秒にして1か月分のデータを保存したい場合。

g=24レコード(1日分)＊31(1か月)＊3(eの値)=2,232レコード

g=2,232レコード

Yの算出式

Y={d＊g+(c+1,900)＊{(d＊e)/(65,250-c)+1}＊(g/e)}＊1.5
Y={384＊2,232+(681+1,900)＊{(384＊3)/(65,250-681)+1}＊
 (2,232/3)}＊1.5
={857,088+2,581＊{1,152/64,569+1}＊744}＊1.5
={857,088+2,581＊1＊744}＊1.5
={857,088+1,920,264}＊1.5
=2,777,352＊1.5
=4,166,028 (バイト)
=約4 (MB)

(3)　Storeデータベース（Storeバージョン2.0）のディスク占有量

Storeデータベース（Storeバージョン2.0）のディスク占有量について説明します。

(a)　見積もり式

ディスク占有量，ファイル数，ディレクトリ数，およびStoreサービスがオープンするファイル数の見積もりについて説明します。

●ディスク占有量

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-9を参照してください。

b：レコードタイプ，要約区分ごとに値が異なります。表A-9を参照してください。

c：履歴データの保存期間設定値※3。レコードタイプ，要約区分ごとに指定する単位が異なります。単位については表A-9を参照してください。

d：履歴データを収集する各レコードの固定部のサイズ※4

e：履歴データを収集する各レコードの可変部のサイズ※4

f：履歴データを収集する各レコードのインスタンス数（単数インスタンスレコードの場合は1）※5

f’：fが2以上の場合，4の倍数に丸め込みます。例えばf=2の場合は，f'=4となります。f=13の場合はf’=16となります。f=1の場合は，f’=1となります。

表A-9　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 | 10(固定値)
PD | － | 1,440 | g/60 | 保存期間(単位：日)

（凡例）

g：履歴データの収集インターバル設定値（単位：秒）

－：該当しない

注※1

{((e+2)＊f')/(65,250-d)+1}の計算結果は，小数点以下を切り捨ててください。

注※2

PIレコードタイプのbの計算結果は，小数点以下を切り捨ててください。

注※3

Storeバージョン2.0の場合のデフォルトの保存期間を次の表に示します。

表A-10　デフォルトの保存期間（Store バージョン2.0 の場合）

レコードタイプ | データの種類 | 保存期間
PI | 分単位 | 1 日
時単位 | 7 日
日単位 | 54 週
週単位 | 54 週
月単位 | 1 年
年単位 | 制限なし
PD | － | 10 日

（凡例）

－：該当しない

注※4

各レコードの固定部・可変部のサイズについては，「6.　レコード」のレコードサイズを参照してください。

注※5

レコードごとのインスタンス数については，「(2)　Storeデータベース（Storeバージョン1.0）のディスク占有量」を参照してください。

●ファイル数

Storeデータベースで作成されるファイル数Nの見積もり式を次に示します。

N=20+2＊(
 (A11+A12+...+A1l+l)+
 (A21+A22+...+A2l+l)+
 (A31+A32+...+A3l+l)+
 (A41+A42+...+A4l+l)+
 (A51+A52+...+A5l+l)+
 (11＊l)+
 (B1+B2+...+Bm+m)
 )

l：PIレコードタイプで収集しているレコードの数

m：PDレコードタイプで収集しているレコードの数

A11～A1l：PIレコードタイプのレコードごとの分レコードの保存期間設定値（単位：日）

A21～A2l：PIレコードタイプのレコードごとの時レコードの保存期間設定値（単位：日）

A31～A3l：PIレコードタイプのレコードごとの日レコードの保存期間設定値（単位：週）

A41～A4l：PIレコードタイプのレコードごとの週レコードの保存期間設定値（単位：週）

A51～A5l：PIレコードタイプのレコードごとの月レコードの保存期間設定値（単位：月）

B1～Bm：PDレコードタイプのレコードごとの保存期間設定値（単位：日）

●ディレクトリ数

Storeデータベースで作成されるディレクトリ数Nの見積もり式を次に示します。

N=25+2 ＊ ((A1max)+(A2max)+(A3max)+(A4max)+(A5max)+11+(Bmax))

l：PI レコードで収集しているレコードの数

m：PD レコードで収集しているレコードの数

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レコードタイプで収集しているレコードの数

(b)　見積もり例

PFM - Agent for IBM WebSphere MQのStoreデータベース（Storeバージョン2.0）の見積もり例について説明します。

●ディスク占有量

PI_CSIとPD_PQS を収集する設定にした場合を例にして説明します。

PI_CSIレコードの見積もりについて説明します。「(3)(a)　見積もり式」のディスク占有量の見積もり式の，a～gの値を調べます。

d=681 バイト
e=1,644 バイト
f=3
f’=4
g=60（秒）

次に，分レコード，時レコードなどそれぞれの計算を行います。

分レコード

変数を次の値とします。

a=1,440
b=1+(60-1)/60
=1.98...
=1（小数点以下切り捨て）
c=3（日）

見積もり式を次に示します。

X（分）={(1,644+2)＊4+(681+60)＊{((1,644+2)＊4)/(65,250-681)+1}}＊1,440/1＊(3+1)＊1.1
      ={6,584+741＊1}＊6,336
      =7,325＊6,336
      =46,411,200（バイト）=約44MB

時レコード

変数を次の値とします。

a=24
b=1+(60-1)/3,600
=1.01...
=1（小数点以下切り捨て）
c=3（日）

見積もり式を次に示します。

X（時）={(1,644+2)＊4+(681+60)＊{((1,644+2)＊4)/(65,250-681)+1}}＊24/1＊(3+1)＊1.1
      ={6,584+741＊1}＊105.6
      =7,325＊105.6
      =773,520（バイト）=約0.7MB

日レコード

変数を次の値とします。

a=7
b=1+(60-1)/86,400
=1.00...
=1（小数点以下切り捨て）
c=1（週）

見積もり式を次に示します。

X（日）={(1,644+2)＊4+(681+60)＊{((1,644+2)＊4)/(65,250-681)+1}}＊7/1＊(1+1)＊1.1
      ={6,584+741＊1}＊15.4
      =7,325＊15.4
      =112,805（バイト）= 約0.1MB

週レコード

変数を次の値とします。

a=1
b=1+(60-1)/604,800
=1.00...
=1（小数点以下切り捨て）
c=1（週）

見積もり式を次に示します。

X（週）={(1,644+2)＊4+(681+60)＊{((1,644+2)＊4)/(65,250-681)+1}}＊1/1＊(1+1)＊1.1
      ={6,584+741＊1}＊2.2
      =7,325＊2.2
      =16,115（バイト）= 約0.01MB

月レコード

変数を次の値とします。

a=1
b=1+(60-1)/2,592,000
=1.00...
=1（小数点以下切り捨て）
c=1（月）

見積もり式を次に示します。

X（月）={(1,644+2)＊4+(681+60)＊{((1,644+2)＊4)/(65,250-681)+1}}＊1/1＊(1+1)＊1.1
      ={6,584+741＊1}＊2.2
      =7,325＊2.2
      =16,115（バイト）=約0.01MB

年レコード

変数を次の値とします。

a=1
b=1+(60-1)/31,622,400
=1.00...
=1（小数点以下切り捨て）
c=10（固定）

見積もり式を次に示します。

X（年）={(1,644+2)＊4+(681+60)＊{((1,644+2)＊4)/(65,250-681)+1}}＊1/1＊(10+1)＊1.1
      ={6,584+741＊1}＊12.1
      =7,325＊12.1
      =88,632.5（バイト）= 約0.08MB

以上から，PI_CSIの見積もりは次のようになります。

X（合計）=X（分）+X（時）+X（日）+X（週）+X（月）+X（年）
        =44.9MB
        =約45MB

次にPD_QS レコードの見積もりについて説明します。

変数を次の値とします。

a=1,400
b=60/60=1
c=7（日）
d=681（バイト）
e=384（バイト）
f=10
f'=12
g=60（秒）

見積もり式を次に示します。

X={(384+2)＊12+(681+60)＊{((384+2)＊12)/(65,250-681)+1}}＊1,440/1＊
 (7+1)＊1.1
={4,632+741＊1}＊12,672
=5,373＊12,672
=68,086,656（バイト）=約65MB

したがって，必要なディスク占有量はPI_CSI+PD_QS=110MBとなります。

●ファイル数

PI_CSI，PD，PD_QS を収集する場合を例にして説明します。「(3)(a)　見積もり式」の見積もり式の，可変値を調べます。

l：PIレコードで収集しているレコードの数=1
m：PDレコードで収集しているレコードの数=2
A11～A1l：PIレコードタイプのレコードごとの分レコードの保存期間設定値（単位：日）=3（日）
A21～A2l：PIレコードタイプのレコードごとの時レコードの保存期間設定値（単位：日）=3（日）
A31～A3l：PIレコードタイプのレコードごとの日レコードの保存期間設定値（単位：週）=1（週）
A41～A4l：PIレコードタイプのレコードごとの週レコードの保存期間設定値（単位：週）=1（週）
A51～A5l：PIレコードタイプのレコードごとの月レコードの保存期間設定値（単位：月）=1（月）
B1～Bm：PDレコードタイプのレコードごとの保存期間設定値（単位：日）=10（日）

Storeデータベースで作成されるファイル数Nの見積もり式を次に示します。

N=20+2＊(
 (A11+A12+...+A1l+l)+
 (A21+A22+...+A2l+l)+
 (A31+A32+...+A3l+l)+
 (A41+A42+...+A4l+l)+
 (A51+A52+...+A5l+l)+
 (11*l)+
 (B1+B2+...+Bm+m)+
 )
=20+2＊｛
 [3(PI_CSI分)+1]+
 [3(PI_CSI分)+1]+
 [1(PI_CSI分)+1]+
 [1(PI_CSI分)+1]+
 [1(PI_CSI分)+1]+
 [11＊1]+
 [10(PD分)+10(PD_QS分)+2]
 }
=20+2＊{4+4+2+2+2+11+22}=114

●ディレクトリ数

PI_CSI，PD，PD_QS を収集する場合を例にして説明します。

l：PIレコードで収集しているレコードの数=1
m：PDレコードで収集しているレコードの数=2
A1max：PIレコードタイプで収集しているレコードの要約区分が「分」のデータの保存期間設定値の最大値（単位：日）=3（日）
A2max：PIレコードタイプで収集しているレコードの要約区分が「時」のデータの保存期間設定値の最大値（単位：日）=3（日）
A3max：PIレコードタイプで収集しているレコードの要約区分が「日」のデータの保存期間設定値の最大値（単位：週）=1（週）
A4max：PIレコードタイプで収集しているレコードの要約区分が「週」のデータの保存期間設定値の最大値（単位：週）=1（週）
A5max：PIレコードタイプで収集しているレコードの要約区分が「月」のデータの保存期間設定値の最大値（単位：月）=1（月）
Bmax：PDレコードタイプのレコードごとの保存期間設定値の最大値（単位：日）=10（日）（考え方：PD_QSが8日，PDが10日の場合は10日となります）。

Storeデータベースで作成されるディレクトリ数Nの見積もり式を次に示します。

N=25+2＊((A1max)+(A2max)+(A3max)+(A4max)+(A5max)+11+(Bmax))
=25+2＊(3+3+1+1+1+11+10)=85

●Storeサービスがオープンするファイル数

PI，PD，PD_QS を収集する場合を例にして説明します。

l：PIレコードで収集しているレコードの数=1
m：PDレコードで収集しているレコードの数=2

Storeサービスがオープンするファイル数Nの見積もり式を次に示します。

N=20+2＊(6＊l+m)
=20+2＊(6＊1+2)=36

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

クラスタ運用時のディスク占有量の見積もりは，クラスタシステムで運用しない場合のディスク占有量の見積もりと同じです。ディスク占有量については，「付録A.2　ディスク占有量」を参照してください。

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

PFM - Agent for IBM WebSphere MQでは，カーネルパラメーターの調整は不要です。

なお，UNIX環境でPFM - ManagerおよびPFM - Web Consoleを使用する場合の，カーネルパラメーターの調整については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されているカーネルパラメーター一覧を参照してください。

付録C　識別子一覧

PFM - Agent for IBM WebSphere MQを操作したり，PFM - Agent for IBM WebSphere MQの Storeデータベースからパフォーマンスデータを抽出したりする際，PFM - Agent for IBM WebSphere MQであることを示す識別子が必要な場合があります。PFM - Agent for IBM WebSphere MQの識別子を次の表に示します。

表C-1　PFM - Agent for IBM WebSphere MQの識別子一覧

用途 | 名称 | 識別子 | 説明
コマンドなど | プロダクトID | 9 | プロダクトIDとは，サービスIDの一部。サービスIDは，コマンドを使用してPerformance Managementのシステム構成を確認する場合や，パフォーマンスデータをバックアップする場合などに必要である。サービスIDについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されている命名規則について説明している章を参照のこと。
サービスキー | agt9 | コマンドを使用してPFM - Agent for IBM WebSphere MQを起動する場合や，終了する場合などに必要である。サービスキーについては，マニュアル「JP1/Performance Managementシステム構築・運用ガイド」の，付録に記載されている命名規則について説明している章を参照のこと。
ODBC | 製品タイプ識別子 | IBMWebSphereMQ | SQL文を使用してデータを抽出する場合に必要である。詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，ODBCに準拠したアプリケーションプログラムとの連携について説明している章を参照のこと。
ヘルプ | ヘルプID | pca9 | PFM - Agent for IBM WebSphere MQのヘルプであることを表す。

付録D　プロセス一覧

ここでは，PFM - Agent for IBM WebSphere MQのプロセス一覧を記載します。

PFM - Agent for IBM WebSphere MQのプロセス一覧を次の表に示します。なお，プロセス名の後ろに記載されている値は，同時に起動できるプロセス数です。

注意

論理ホストのPFM - Agentでも，動作するプロセスおよびプロセス数は同じです。

表D-1　PFM - Agent for IBM WebSphere MQのプロセス一覧（Windowsの場合）

プロセス名
（プロセス数）
機能

jpcagt9.exe(1)
Agent Collectorサービスプロセス。このプロセスは，PFM - Agent for IBM WebSphere MQのインスタンスごとに一つ起動する。

jpcsto.exe(1)
Agent Storeサービスプロセス。このプロセスは，PFM - Agent for IBM WebSphere MQのインスタンスごとに一つ起動する。

stpqlpr.exe(1)※
Storeデータベースのバックアップ/エクスポート実行プロセス。

表D-2　PFM - Agent for IBM WebSphere MQのプロセス一覧（UNIXの場合）

プロセス名
（プロセス数）
機能

jpcagt9(1)
Agent Collectorサービスプロセス。このプロセスは，PFM - Agent for IBM WebSphere MQのインスタンスごとに一つ起動する。

agt9/jpcsto(1)
Agent Storeサービスプロセス。このプロセスは，PFM - Agent for IBM WebSphere MQのインスタンスごとに一つ起動する。

stpqlpr(1)※
Storeデータベースのバックアップ/エクスポート実行プロセス。

注※　jpcstoプロセスの子プロセスです。

付録E　ポート番号一覧

ここでは，PFM - Agent for IBM WebSphere MQで使用するポート番号を記載します。

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　PFM - Agent for IBM WebSphere MQのポート番号

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

付録E.1　PFM - Agent for IBM WebSphere MQのポート番号

PFM - Agent for IBM WebSphere MQで使用するポート番号を次の表に示します。

表E-1　PFM - Agent for IBM WebSphere MQで使用するポート番号

サービス名 | パラメーター | ポート番号 | 用途
Agent Storeサービス | jp1pcsto9[nnn]※1 | 自動※2 | パフォーマンスデータを記録したり，履歴レポートを取得したりするときに使用する。
Agent Collectorサービス | jp1pcagt9[nnn]※1 | 自動※2 | アラームをバインドしたり，リアルタイムレポートを取得したりするときに使用する。

注※1

複数インスタンスを作成している場合，2番目以降に作成したインスタンスに通番（nnn）が付加されます。最初に作成したインスタンスには，通番は付加されません。

注※2

サービスが再起動されるたびに，システムで使用されていないポート番号が自動的に割り当てられます。

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

ファイアウォールを挟んでPFM - ManagerとPFM - Agent for IBM WebSphere MQを配置する場合は，PFM - ManagerとPFM - Agentのすべてのサービスにポート番号を固定値で設定してください。また，各ポート番号を次の表に示す方向で設定し，ファイアウォールを通過させるようにしてください。

表E-2　ファイアウォールの通過方向

サービス名 | パラメーター | 通過方向
Agent Storeサービス | jp1pcsto9[nnn]※ | Agent←Manager
Agent Collectorサービス | jp1pcagt9[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サービス | jp1pcsto9[nnn]※ | Agent←→Agent
Agent Collectorサービス | jp1pcagt9[nnn]※ | Agent←→Agent

（凡例）

Agent：PFM - Agentホスト

←→：左項から右項，および右項から左項への通信（コネクション）を開始する方向

注※

複数インスタンスを作成している場合，2番目以降に作成したインスタンスに通番（nnn）が付加されます。最初に作成したインスタンスには，通番は付加されません。

付録F　PFM - Agent for IBM WebSphere MQのプロパティ

ここでは，PFM - Web Consoleで表示されるPFM - Agent for IBM WebSphere MQのAgent Storeサービスのプロパティ一覧，およびAgent Collectorサービスのプロパティ一覧を記載します。

＜この節の構成＞

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

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

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

PFM - Agent for IBM WebSphere MQのAgent Storeサービスのプロパティ一覧を次の表に示します。

表F-1　PFM - Agent for IBM WebSphere MQの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
－
Storeバージョンが1.0の場合にデータの保存期間を設定する。詳細については，マニュアル「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 - Hour Drawer (Day)
時間ごとのPIレコードタイプのレコードの保存期間を設定する。指定できる値は0～366日で，1日単位で指定できる。

Period - Day Drawer (Week)
日ごとのPIレコードタイプのレコードの保存期間を設定する。指定できる値は0～266週で，1週間単位で指定できる。

Period - Week Drawer (Week)
週ごとのPIレコードタイプのレコードの保存期間を設定する。指定できる値は0～266週で，1週間単位で指定できる。

Period - Month Drawer (Month)
月ごとのPIレコードタイプのレコードの保存期間を設定する。指定できる値は0～60月で，1か月単位で指定できる。

Period - Year Drawer (Year)
年ごとのPIレコードタイプのレコードの保存期間。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 IBM WebSphere MQでは使用しない。

Product Log
PLレコードタイプのレコードで使用されるディスク容量が表示される。PFM - Agent for IBM WebSphere MQでは使用しない。

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 IBM WebSphere MQのAgent Collectorサービスのプロパティ一覧を次の表に示します。

表F-2　PFM - Agent for IBM WebSphere MQのAgent Collectorサービスのプロパティ一覧

ディレクトリ名
プロパティ名
説明

－
First Registration Date
サービスがPFM - Managerに認識された最初の日時が表示される。

Last Registration Date
サービスが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※1
－
レコードのプロパティが格納されている。

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※1
－
レコードのプロパティが格納されている。

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 IBM WebSphere MQではこのレコードをサポートしていないため使用しない。

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の整数で指定できる。

Agent Configuration
－
PFM - Agent for IBM WebSphere MQ固有の設定用プロパティが格納されている。

Agent Configuration
Agent
－
Agent Collectorサービスの概要が表示される。

Product
プロダクトID「9」が表示される。

Instance
jpcinssetupコマンドで指定したインスタンス名が表示される。

QManager_Name
インスタンス環境を設定したときに指定した「QManager_Name」の値が表示される。このプロパティは変更できる。※2

LOG_SIZE
インスタンス環境を設定したときに指定した「log_size」の値が表示される。このプロパティは変更できる。※2

（凡例）

－：該当しない

注※1

ディレクトリ名には，データベースIDを除いたレコードIDが表示されます。各レコードのレコードIDについては，「6.　レコード」を参照してください。

注※2

変更した値を反映するには，Agent Collectorサービスを再起動してください。

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

ここでは，PFM - Agent for IBM WebSphere MQのファイルおよびディレクトリ一覧を記載します。

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　PFM - Agent for IBM WebSphere MQのファイルおよびディレクトリ一覧

付録G.2　メッセージカタログ格納ディレクトリ内のファイルおよびディレクトリ一覧

付録G.1　PFM - Agent for IBM WebSphere MQのファイルおよびディレクトリ一覧

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

PFM - Agent for IBM WebSphere MQのファイルおよびフォルダ一覧を次の表に示します。

表G-1　PFM - Agent for IBM WebSphere MQのファイルおよびフォルダ一覧（Windowsの場合）

フォルダ名
ファイル名
説明

インストール先フォルダ¥
instagt9.ini
内部処理用中間ファイル

インストール先フォルダ¥agt9¥
－
PFM - Agent for IBM WebSphere MQのルートフォルダ

readme.txt
README.TXT（日本語）

insrules.dat
内部処理用中間ファイル

PATCHLOG.TXT
内部処理用中間ファイル

jpcagtras.bat
保守資料収集プログラム

インストール先フォルダ¥agt9¥agent¥
－
Agent Collectorサービスのルートフォルダ

jpcagt.ini.instmpl
内部処理用中間ファイル

jpcagt9.exe
Agent Collectorサービス実行プログラム

インストール先フォルダ¥agt9¥agent¥インスタンス名¥
－
Agent Collectorサービスのルートフォルダ（インスタンスごと）※１

jpcagt.ini
Agent Collectorサービス起動情報ファイル（インスタンスごと）※１

jpcagt.ini.model
Agent Collectorサービス起動情報ファイルのモデルファイル（インスタンスごと）※１

status.dat
内部処理用中間ファイル※4

インストール先フォルダ¥agt9¥agent¥インスタンス名¥log¥
－
Agent Collectorサービス内部ログファイル格納フォルダ（インスタンスごと）※１

agt9inf01.log
agt9inf02.log
Agent for IBM WebSphere MQエージェントログファイル※2

agt9err01.log
agt9err02.log
Agent for IBM WebSphere MQエージェントログエラーファイル※2

agt9inf.lck
内部処理用中間ファイル※4

agt9err.lck
内部処理用中間ファイル※4

msglog01
msglog02
内部ログファイル※3

nslog01
nslog02
内部ログファイル※3

インストール先フォルダ¥agt9¥lib¥
－
メッセージカタログ格納フォルダ

jpcagt9msg.dll
メッセージカタログファイル

インストール先フォルダ¥agt9¥store¥
－
Agent同梱Storeサービスのルートフォルダ

*.DAT※5
データモデル定義ファイル

jpcsto.ini.instmpl
内部処理用中間ファイル

インストール先フォルダ¥agt9¥store¥インスタンス名¥
－
Agent Storeサービスのルートフォルダ（インスタンスごと）※１

*.DB※5
パフォーマンスデータファイル（インスタンスごと）※6

*.IDX※5
パフォーマンスデータファイルのインデックスファイル（インスタンスごと）※6

*.LCK※5
パフォーマンスデータファイルのロックファイル（インスタンスごと）※6

jpcsto.ini
Agent Storeサービス起動情報ファイル（インスタンスごと）※１

jpcsto.ini.model
Agent Storeサービス起動情報ファイルのモデル（インスタンスごと）※１

*.DAT※5
データモデル定義ファイル（インスタンスごと）※１

status.dat
内部処理用中間ファイル※4

インストール先フォルダ¥agt9¥store¥インスタンス名¥backup¥
－
標準のデータベースバックアップ先フォルダ（インスタンスごと）※１

インストール先フォルダ¥agt9¥store¥インスタンス名¥dump¥
－
標準のデータベースエクスポート先フォルダ（インスタンスごと）※１

インストール先フォルダ¥agt9¥store¥インスタンス名¥import¥
－
標準のデータベースインポート先フォルダ（インスタンスごと）※１

インストール先フォルダ¥agt9¥store¥インスタンス名¥STPD¥
－
PDデータベース固有のディレクトリ

インストール先フォルダ¥agt9¥store¥インスタンス名¥STPI¥
－
PIデータベース固有のディレクトリ

インストール先フォルダ¥agt9¥store¥インスタンス名¥log¥
－
Agent Storeサービス内部ログファイル格納フォルダ（インスタンスごと）※１

msglog01
msglog02
内部ログファイル※6

nslog01
nslog02
内部ログファイル※6

インストール先フォルダ¥agt9¥store¥インスタンス名¥partial¥
－
標準のデータベース部分バックアップ先フォルダ（インスタンスごと）※１

インストール先フォルダ¥patch_files¥agt9¥
－
パッチ用ファイル格納フォルダ(エージェント用)

インストール先フォルダ¥setup¥
－
セットアップファイル格納フォルダ

jpcagt9u.Z
PFM - Agentセットアップ用アーカイブファイル（UNIX）

jpcagt9w.EXE
PFM - Agentセットアップ用アーカイブファイル（Windows）

（凡例）

－：該当しない

注※1

jpcinssetupコマンドの実行で作成されます。

注※2

PFM - Agentが内部で使用しているファイルです。変更または削除しないでください。

注※3

Agent Collectorサービス起動時およびレコード収集時に作成されます。

注※4

一時的に作成される場合があります。

注※5

"*"には，任意の文字列が入ります。

注※6

Agent Storeサービス起動時に作成されます。

(2)　UNIXの場合

PFM - Agent for IBM WebSphere MQのファイルおよびディレクトリ一覧を次の表に示します。

表G-2　PFM - Agent for IBM WebSphere MQのファイルおよびディレクトリ一覧（UNIXの場合）

ディレクトリ名
ファイル名
パーミッション
説明

/opt/jp1pc/
instagt9.ini
644
内部処理用中間ファイル

/opt/jp1pc/agt9/
－
755
PFM - Agent for IBM WebSphere MQのルートディレクトリ

insrules.dat
444
内部処理用中間ファイル

PATCHLOG.TXT
644
内部処理用中間ファイル

patch_history
644
内部処理用中間ファイル

jpcagtras
555
保守資料収集プログラム

/opt/jp1pc/agt9/agent/
－
755
Agent Collectorサービスのルートディレクトリ

jpcagt.ini.instmpl
444
内部処理用中間ファイル

jpcagt9
555
Agent Collectorサービス実行プログラム

agtlist.ini
644
内部処理用中間ファイル

/opt/jp1pc/agt9/agent/インスタンス名/
－
755
Agent Collectorサービスのルートディレクトリ（インスタンスごと）※１

jpcagt.ini
600
Agent Collectorサービス起動情報ファイル（インスタンスごと）※１

jpcagt.ini.lck
777
Agent Collectorサービス起動情報ファイル（インスタンスごと）のロックファイル※2

jpcagt.ini.model
444
Agent Collectorサービス起動情報ファイルのモデルファイル（インスタンスごと）※１

status.dat
600
内部処理用中間ファイル※4

/opt/jp1pc/agt9/agent/インスタンス名/log/
－
777
Agent Collectorサービス内部ログファイル格納ディレクトリ（インスタンスごと）※１

agt9inf01.log
agt9inf02.log
644
644
Agent for IBM WebSphere MQエージェントログファイル※2

agt9err01.log
agt9err02.log
644
644
Agent for IBM WebSphere MQエージェントログエラーファイル※2

agt9inf.lck
644
内部処理用中間ファイル※4

agt9err.lck
644
内部処理用中間ファイル※4

msglog01
msglog02
666
666
内部ログファイル※3

nslog01
nslog02
666
666
内部ログファイル※3

/opt/jp1pc/agt9/nls/
－
755
メッセージカタログ格納ディレクトリ
このディレクトリ内のファイルおよびディレクトリについては，「付録G.2メッセージカタログ格納ディレクトリ内のファイルおよびディレクトリ一覧」を参照のこと。

/opt/jp1pc/agt9/store/
－
755
Agent同梱Storeサービスのルートディレクトリ

*.DAT※5
444
データモデル定義ファイル

stolist.ini
644
内部処理用中間ファイル

jpcsto.ini.instmpl
444
内部処理用中間ファイル

/opt/jp1pc/agt9/store/インスタンス名/
－
755
Agent Storeサービスのルートディレクトリ（インスタンスごと）※１

*.DB※5
644
パフォーマンスデータファイル（インスタンスごと）※6

*.IDX※5
644
パフォーマンスデータファイルのインデックスファイル（インスタンスごと）※6

*.LCK※5
666
パフォーマンスデータファイルのロックファイル（インスタンスごと）※6

jpcsto.ini
644
Agent Storeサービス起動情報ファイル（インスタンスごと）※１

jpcsto.ini.model
444
Agent Storeサービス起動情報ファイルのモデル（インスタンスごと）※１

*.DAT※5
444
データモデル定義ファイル（インスタンスごと）※１

status.dat
600
内部処理用中間ファイル※4

/opt/jp1pc/agt9/store/インスタンス名/backup/
－
755
標準のデータベースバックアップ先ディレクトリ（インスタンスごと）※１

/opt/jp1pc/agt9/store/インスタンス名/partial/
－
755
標準のデータベース部分バックアップ先ディレクトリ（インスタンスごと）※１

/opt/jp1pc/agt9/store/インスタンス名/dump/
－
777
標準のデータベースエクスポート先ディレクトリ（インスタンスごと）※１

/opt/jp1pc/agt9/store/インスタンス名/import/
－
755
標準のデータベースインポート先ディレクトリ（インスタンスごと）※１

/opt/jp1pc/agt9/store/インスタンス名/STPD/
－
755
PDデータベース固有のディレクトリ

/opt/jp1pc/agt9/store/インスタンス名/STPI/
－
755
PIデータベース固有のディレクトリ

/opt/jp1pc/agt9/store/インスタンス名/STPL/
－
755
PLデータベース固有のディレクトリ

/opt/jp1pc/agt9/store/インスタンス名/log/
－
777
Agent Storeサービス内部ログファイル格納ディレクトリ（インスタンスごと）※１

msglog01
msglog02
666
内部ログファイル※6

nslog01
nslog02
666
内部ログファイル※6

/opt/jp1pc/patch_files/agt9
－
755
パッチ用ファイル格納フォルダ（エージェント用）

/opt/jp1pc/setup/
－
755
セットアップファイル格納ディレクトリ

jpcagt9u.Z
444
PFM - Agentセットアップ用アーカイブファイル（UNIX）

jpcagt9w.EXE
444
PFM - Agentセットアップ用アーカイブファイル（Windows）

（凡例）

－：該当しない

注※1

jpcinssetupコマンドの実行で作成されます。

注※2

PFM - Agentが内部で使用しているファイルです。変更または削除しないでください。

注※3

Agent Collectorサービス起動時およびレコード収集時に作成されます。

注※4

一時的に作成される場合があります。

注※5

"*"には，任意の文字列が入ります。

注※6

Agent Storeサービス起動時に作成されます。

付録G.2　メッセージカタログ格納ディレクトリ内のファイルおよびディレクトリ一覧

メッセージカタログ格納ディレクトリ（/opt/jp1pc/agt9/nls/）内のファイルおよびディレクトリ構成について記載します。

AIX版PFM - Agent for IBM WebSphere MQのメッセージカタログ格納ディレクトリ内のファイルおよびディレクトリ一覧を次の表に示します。

表G-3　PFM - Agent for IBM WebSphere MQのメッセージカタログ格納ディレクトリ内のファイルおよびディレクトリ一覧

ディレクトリ名 | ファイル名 | パーミッション | 説明
/opt/jp1pc/agt9/nls/C/ | － | 755 | メッセージカタログ格納ディレクトリ
jpcagt9msg.cat | 444 | メッセージカタログファイル
/opt/jp1pc/agt9/nls/Ja_JP/ | － | 755 | メッセージカタログ格納ディレクトリ
jpcagt9msg.cat | 444 | メッセージカタログファイル
/opt/jp1pc/agt9/nls/ja_JP/ | － | 755 | メッセージカタログ格納ディレクトリ
jpcagt9msg.cat | 444 | メッセージカタログファイル
/opt/jp1pc/agt9/nls/Ja_JP.IBM-932/ | － | 777 | SJIS用メッセージカタログ格納ディレクトリへのシンボリックリンク
/opt/jp1pc/agt9/nls/Ja_JP.IBM-eucJP/ | － | 777 | EUC用メッセージカタログ格納ディレクトリへのシンボリックリンク

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

PFM - Agent for IBM WebSphere MQをバージョンアップするには，PFM - Agent for IBM WebSphere MQを上書きインストールします。インストールの操作の詳細については，次に示す個所を参照してください。

Windowsの場合

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

UNIXの場合

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

注意

バージョンアップする際には，古いバージョンのPFM - Agent for IBM WebSphere MQをアンインストールしないでください。アンインストールすると，古いバージョンで作成したパフォーマンスデータなども一緒に削除されてしまうため，新しいバージョンで使用できなくなります。

PFM - Agent for IBM WebSphere MQのプログラムを上書きインストールすると，次の項目が自動的に更新されます。

Agnet StoreサービスのStoreデータベースファイル

iniファイル

PFM - Agent for IBM WebSphere MQのインスタンス環境

付録I　バージョン互換

PFM - Agentには，製品のバージョンのほかに，データモデルのバージョンがあります。

PFM - Agent for IBM WebSphere MQの場合，データモデルのバージョンはそのままで，アラームテーブルのバージョンだけがアップされます。データモデルは，上位互換を保っているため，古いバージョンで定義したレポートの定義やアラームの定義は，新しいバージョンのデータモデルでも使用できます。

PFM - Agent for IBM WebSphere MQのバージョンの対応を次の表に示します。

表I-1　PFM - Agent for IBM WebSphere MQのバージョン対応表

PFM - Agent for IBM WebSphere MQのバージョン | データモデルのバージョン | ソリューションセットのアラームテーブルのバージョン
08-11 | 3.0 | 8.11
08-50 | 3.0 | 8.50

バージョン互換については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，付録に記載されているバージョン互換を参照してください。

付録J　動作ログの出力

Performance Managementの動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。

例えば，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)　出力先

Windowsの場合

インストール先フォルダ¥auditlog¥

UNIXの場合

/opt/jp1pc/auditlog/

動作ログの出力先は，jpccomm.iniファイルで変更できます。jpccomm.iniファイルの設定方法については，「付録J.4　動作ログを出力するための設定」を参照してください。

(3)　出力項目

出力項目には二つの分類があります。

共通出力項目
動作ログを出力するJP1製品が共通して出力する項目です。

固有出力項目
動作ログを出力するJP1製品が任意に出力する項目です。

(a)　共通出力項目

共通出力項目に出力される値と項目の内容を次の表に示します。なお，この表はPFM - Managerが出力する項目や内容も含みます。

表J-2　動作ログの共通出力項目

項番
出力項目
値
内容

項目名
出力される属性名

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は日付と時刻の区切りです。

TZDはタイムゾーン指定子です。次のどれかが出力されます。

+hh:mm：UTCからhh:mmだけ進んでいることを示す。

-hh:mm：UTCからhh:mmだけ遅れていることを示す。

Z：UTCと同じであることを示す。

(b)　固有出力項目

固有出力項目に出力される値と項目の内容を次の表に示します。なお，この表はPFM - Managerが出力する項目や内容も含みます。

表J-3　動作ログの固有出力項目

項番
出力項目
値
内容

項目名
出力される属性名

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)　格納先フォルダ

Windowsの場合

インストール先フォルダ

UNIXの場合

/opt/jp1pc/

(b)　形式

jpccomm.iniファイルには，次の内容を定義します。

動作ログの出力の有無

動作ログの出力先

動作ログの保存面数

動作ログのファイルサイズ

指定形式は次のとおりです。

"項目名"=値

設定項目を次の表に示します。

表J-4　jpccomm.iniファイルで設定する項目および初期値

項番
項目
説明

1
[Action Log Section]
セクション名です。変更はできません。

2
Action Log Mode
動作ログを出力するかどうかを指定します。この項目の設定は省略できません。

初期値
0（出力しない）

指定できる値
0（出力しない），1（出力する）
これ以外の値を指定すると，エラーメッセージが出力され，動作ログは出力されません。

3
Action Log Dir
動作ログの出力先を指定します。
論理ホスト環境の場合は共有ディスク上のディレクトリを指定します。共有ディスク上にないディレクトリを指定した場合，論理ホストを構成する各物理ホストへ動作ログが出力されます。
なお，制限長を超えるパスを設定した場合や，ディレクトリへのアクセスが失敗した場合は，共通ログにエラーメッセージが出力され，動作ログは出力されません。

初期値
省略

省略した場合に適用される値（デフォルト値）
Windowsの場合
インストール先フォルダ¥auditlog¥
UNIXの場合
/opt/jp1pc/

初期値
Windowsの場合
インストール先フォルダ¥auditlog¥
UNIXの場合
/opt/jp1pc/

指定できる値
1～185バイトの文字列

4
Action Log Num
ログファイルの総数の上限（保存面数）を指定します。カレント出力ファイルとシフトファイルの合計を指定してください。

初期値
省略

省略した場合に適用される値（デフォルト値）
5

指定できる値
2～10の整数

数値以外の文字列を指定した場合，エラーメッセージが出力され，デフォルト値である5が設定されます。
範囲外の数値を指定した場合，エラーメッセージを出力し，指定値に最も近い2～10の整数値が設定されます。

5
Action Log Size
ログファイルのサイズをキロバイト単位で指定します。

初期値
省略

省略した場合に適用される値（デフォルト値）
2,048

指定できる値
512～2,096,128の整数

数値以外の文字列を指定した場合，エラーメッセージが出力され，デフォルト値である2,048が設定されます。
範囲外の数値を指定した場合，エラーメッセージが出力され，指定値に最も近い512～2,096,128の整数値が設定されます。

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

各バージョンの変更内容を示します。

＜この節の構成＞

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

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

PFM - Agent Option for IBM WebSphere MQの適用OSにAIXを追加しました。

パフォーマンスデータの格納先として設定できる値の範囲を変更しました。

メモリー所要量の見積もり式と見積もり例を変更しました。

バージョンアップインストール時の注意事項を追加しました。

付録L　用語解説

（英字）

Action Handler

PFM - ManagerまたはPFM - Baseのサービスの一つです。アクションを実行するサービスのことです。

Agent Collector

PFM - Agentのサービスの一つです。パフォーマンスデータを収集したり，アラームに設定されたしきい値で，パフォーマンスデータを評価したりするサービスのことです。

Agent Store

PFM - Agentのサービスの一つです。パフォーマンスデータを格納するサービスのことです。Agent Storeサービスは，パフォーマンスデータの記録のためにデータベースを使用します。各PFM - Agentに対応して，各Agent Storeサービスがあります。

Correlator

PFM - Managerのサービスの一つです。サービス間のイベント配信を制御するサービスのことです。アラームの状態を評価して，しきい値を超過するとアラームイベントおよびエージェントイベントを，Trap GeneratorサービスおよびPFM - Web Consoleに送信します。

HAクラスタシステム

高可用性を実現させるためのクラスタシステムです。障害が発生しても運用を継続できるようにすることを目的としています。業務実行中のサーバで障害が発生すると，待機していた別のサーバが業務の処理を引き継ぎます。これによって，障害発生時の業務の中断を防ぎ，可用性を向上させることができます。

このマニュアルでは，単に「クラスタシステム」と記述している場合は，HAクラスタシステムのことを指します。

Master Manager

PFM - Managerのサービスの一つです。PFM - Managerのメインサービスのことです。

Master Store

PFM - Managerのサービスの一つです。各PFM - Agentから発行されたアラームイベントを管理するサービスのことです。Master Storeサービスはイベントデータの保持のためにデータベースを使用します。

ODBCキーフィールド

PFM - ManagerまたはPFM - Baseで，SQLを使用してStoreデータベースに格納されているレコードのデータを利用する場合に必要なODBCキーフィールドを示します。ODBCキーフィールドには，各レコード共通のものと各レコード固有のものとがあります。

PDレコードタイプ

→「Product Detailレコードタイプ」を参照してください。

Performance Management

システムのパフォーマンスに関する問題を監視および分析するために必要なソフトウェア群の総称です。Performance Managementは，次の四つのプログラムプロダクトで構成されます。

PFM - Manager

PFM - Web Console

PFM - Base

PFM - Agent

PFM - Agent

Performance Managementを構成するプログラムプロダクトの一つです。PFM - Agentは，システム監視機能に相当し，監視対象となるアプリケーション，データベース，OSによって，各種のPFM - Agentがあります。PFM - Agentには，次の機能があります。

監視対象のパフォーマンスの監視

監視対象のデータの収集および記録

PFM - Base

Performance Managementを構成するプログラムプロダクトの一つです。Performance Managementの稼働監視を行うための基盤機能を提供します。PFM - Agentを動作させるための前提製品です。PFM - Baseには，次の機能があります。

各種コマンドなどの管理ツール

Performance Managementと他システムとの連携に必要となる共通機能

PFM - Manager

Performance Managementを構成するプログラムプロダクトの一つです。PFM - Managerは，マネージャー機能に相当し，次の機能があります。

Performance Managementのプログラムプロダクトの管理

イベントの管理

PFM - Manager名

PFM - Managerで，SQLを使用してStoreデータベースに格納されているフィールドのデータを利用する場合，SQL文で記述するフィールド名のことです。

PFM - View名

PFM - Web ConsoleのGUIで表示されるフィールド名のことです。

PFM - Web Console

Performance Managementを構成するプログラムプロダクトの一つです。ブラウザーでPerformance Managementシステムを一元的に監視するためWebアプリケーションサーバの機能を提供します。PFM - Web Consoleには，次の機能があります。

GUIの表示

統合監視および管理機能

レポートの定義およびアラームの定義

PIレコードタイプ

→「Product Intervalレコードタイプ」を参照してください。

Product Detailレコードタイプ

現在起動しているプロセスの詳細情報など，ある時点でのシステムの状態を示すパフォーマンスデータが格納されるレコードタイプのことです。PDレコードタイプは，次のような，ある時点でのシステムの状態を知りたい場合に使用します。

システムの稼働状況

現在使用しているファイルシステム容量

Product Intervalレコードタイプ

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

一定時間内に発生したシステムコール数の推移

使用しているファイルシステム容量の推移

Storeデータベース

Agent Collectorサービスが収集したパフォーマンスデータが格納されるデータベースのことです。

（ア行）

アクション

監視するデータがしきい値に達した場合に，Performance Managementによって自動的に実行される動作のことです。次の動作があります。

Eメールの送信

コマンドの実行

SNMPトラップの発行

JP1イベントの発行

アラーム

監視するデータがしきい値に達した場合のアクションやイベントメッセージを定義した情報のことです。

アラームテーブル

次の情報を定義した一つ以上のアラームをまとめたテーブルです。

監視するオブジェクト（Process，TCP，WebServiceなど）

監視する情報（CPU使用率，1秒ごとの受信バイト数など）

監視する条件（しきい値）

インスタンス

このマニュアルでは，インスタンスという用語を次のように使用しています。

レコードの記録形式を示す場合
1行で記録されるレコードを「単数インスタンスレコード」，複数行で記録されるレコードを「複数インスタンスレコード」，レコード中の各行を「インスタンス」と呼びます。

PFM - Agentの起動方式を示す場合
同一ホスト上の監視対象を一つのエージェントで監視する方式のエージェントを「シングルインスタンスエージェント」，同一ホスト上の監視対象を複数のエージェントで監視する方式のエージェントを「マルチインスタンスエージェント」，マルチインスタンスエージェントの各エージェントサービスを「インスタンス」と呼びます。

インスタンス番号

内部処理で使用する，1バイトの管理番号を示す識別子のことです。サービスIDの一部です。

エージェント

パフォーマンスデータを収集するPFM - Agentのサービスのことです。

（カ行）

管理ツール

サービスの状態の確認やパフォーマンスデータを操作するために使用する各種のコマンドまたはGUI上の機能のことです。次のことができます。

サービスの構成および状態の表示

パフォーマンスデータの退避および回復

パフォーマンスデータのテキストファイルへのエクスポート

パフォーマンスデータの消去

機能ID

Performance Managementプログラムのサービスの機能種別を示す，1バイトの識別子のことです。サービスIDの一部です。

キューマネージャー

キューマネージャーとは，Agent の監視対象であるIBM WebSphere MQの中心となるオブジェクトのことです。キューマネージャーには，次の機能があります。

キューやログなど，各種資源の管理

アプリケーションプログラムにメッセージ・キューイング・サービスの提供

クラスタシステム

クラスタシステムとは，複数のサーバシステムを連携して一つのシステムとして運用するシステムです。

このマニュアルでは，単に「クラスタシステム」と記述している場合は，HAクラスタシステムのことを指します。

→「HAクラスタシステム」を参照してください。

（サ行）

サービスID

Performance Managementプログラムのサービスに付加された，一意のIDのことです。コマンドを使用してPerformance Managementのシステム構成を確認する場合，または個々のエージェントのパフォーマンスデータをバックアップする場合などは，Performance ManagementプログラムのサービスIDを指定してコマンドを実行します。サービスIDは，次の四つから構成されます。

プロダクトID

機能ID

インスタンス番号

デバイスID

実行系ノード

クラスタシステムを構成するそれぞれのサーバシステムの，業務を実行中のノード（論理ホストがアクティブなノード）のことです。

スタンドアロンモード

PFM - Agent単独で起動している状態のことです。PFM - ManagerのMaster ManagerサービスおよびName Serverサービスが，障害などのため起動できない状態でも，PFM - Agentだけを起動して，パフォーマンスデータを収集できます。

ソリューションセット

PFM - Agentに用意されている，定義済みのアラームとレポートのことです。ソリューションセットを使用することで，複雑な定義をしなくてもPFM - Agentの運用状況を監視する準備が容易にできるようになります。

（タ行）

待機系ノード

クラスタシステムを構成するそれぞれのサーバシステムの，実行系ノードの障害時に業務を引き継げるよう待機しているノードのことです。

単数インスタンスレコード

1行で記録されるレコードです。このレコードは，固有のODBCキーフィールドを持ちません。

→「インスタンス」を参照してください。

データベースID

PFM - Agentの各レコードに付けられた，レコードが格納されるデータベースを示すIDです。データベースIDは，そのデータベースに格納されるレコードの種類を示しています。データベースIDを次に示します。

・PI　：PIレコードタイプのレコードのデータベースであることを示します。

・PD　：PDレコードタイプのレコードのデータベースであることを示します。

データモデル

各PFM - Agentが持つレコードおよびフィールドの総称のことです。データモデルは，バージョンで管理されています。

ドリルダウンレポート

レポートまたはレポートのフィールドに関連づけられたレポートです。あるレポートの詳細情報や関連情報を表示したい場合に使用します。

（ハ行）

バインド

アラームをエージェントと関連づけることです。バインドすると，エージェントによって収集されているパフォーマンスデータが，アラームで定義したしきい値に達した場合，ユーザーに通知できるようになります。

パフォーマンスデータ

監視対象システムから収集したリソースの稼働状況データのことです。

フィールド

レコードを構成するパフォーマンスデータの集まりのことです。

フェールオーバー

クラスタシステムで障害が発生したときに，業務を実行するサーバの処理を実行系ノードから待機系ノードに引き継ぐことです。

複数インスタンスレコード

複数行で記録されるレコードです。このレコードは，固有のODBCキーフィールドを持っています。

→「インスタンス」を参照してください。

物理ホスト

クラスタシステムを構成する各サーバに固有な環境のことです。物理ホストの環境は，フェールオーバー時にもほかのサーバに引き継がれません。

プロダクトID

該当するPerformance Managementプログラムのサービスが，Performance Managementのどのプログラムプロダクトのものかを示す1バイトの識別子のことです。サービスIDの一部です。

（ラ行）

ライフタイム

各レコードに収集されるパフォーマンスデータの一貫性が保証される期間のことです。

リアルタイムレポート

監視対象の現在の状況を示すレポートです。

履歴レポート

監視対象の過去から現在までの状況を示すレポートです。

レコード

収集したパフォーマンスデータを格納する形式のことです。レコードの種類は，Storeデータベースの各データベースによって異なります。

レポート

PFM - Agentが収集したパフォーマンスデータをグラフィカルに表示する際の情報を定義したものです。主に，次の情報を定義します。

レポートに表示させるレコード

パフォーマンスデータの表示項目

パフォーマンスデータの表示形式（表，グラフなど）

論理ホスト

クラスタシステムでの運用時にJP1の実行環境となる論理上のサーバのことです。障害の発生時には，論理ホスト単位で系が切り替わります。

論理ホストは専用のIPアドレスを持ち，フェールオーバー時にはそのIPアドレスを引き継いで動作します。そのため，障害で物理的なサーバが切り替わった場合も，クライアントからは同じIPアドレスでアクセスでき，一つのサーバが常に動作しているように見えます。

索引

[Ａ][Ｃ][Ｉ][Ｌ][Ｍ][Ｏ][Ｐ][Ｑ][Ｓ][Ｕ][Ｗ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(英字)

(Ａ)

Action Handler

Action Handler

Agent Collector

Agent Collectorサービス

Agent Collectorサービスのプロパティ一覧

Agent Store

Agent Storeサービス

Agent Storeサービスのプロパティ一覧

Application Exist

(Ｃ)

Channel Event

Channel Status

Channel Statusアラーム

Channel Statusレコード

Channel Status Interval

Correlator

Correlator

Current Sys Q Depth

Current User Q Depth

(Ｉ)

Inhibit Get

Inhibit Put

IPアドレスの設定

IPアドレスの設定

(Ｌ)

LANG環境変数の設定

(Ｍ)

Master Manager

Master Managerサービス

Master Store

Master Storeサービス

MQinst

MQinst

mqmグループ

mqmグループ

(Ｏ)

ODBCキーフィールド

ODBCキーフィールド

ODBCキーフィールド一覧

Open Input Count

Open Output Count

(Ｐ)

PD

PD_CS

PD_QHS

PD_QS

PDレコードタイプ

PDレコードタイプ

Performance Event

Performance Management

Performance Management

Performance Managementシステムの障害回復

Performance Managementの障害検知

PFM - Agent

PFM - Agent

PFM - Agent

PFM - Agent

PFM - Agent for IBM WebSphere MQ

運用方式の変更

運用方式の変更

概要

システム構成の変更

システム構成の変更

接続先PFM - Managerの設定

接続先PFM - Managerの設定

セットアップ手順

セットアップ手順

セットアップファイル

セットアップファイル

登録

登録

特長

プロパティ

ポート番号

PFM - Agent for IBM WebSphere MQを使ったパフォーマンス監視の例

PFM - Agentの登録

PFM - Base

PFM - Base

PFM - Base

PFM - Manager

PFM - Manager

PFM - Manager

PFM - Manager名

PFM - Manager名

PFM - View

PFM - View

PFM - View名

PFM - View名

PFM - Web Console

PFM - Web Console

PFM - Web Console

PI

PI_CSI

PIレコードタイプ

PIレコードタイプ

Product Detailレコードタイプ

Product Detailレコードタイプ

Product Intervalレコードタイプ

Product Intervalレコードタイプ

(Ｑ)

Q Manager Event

Q Manager Status

Queue Activity Status

Queue Handle Status

Queue Manager Status

Queue Manager Status Interval

Queue Status

(Ｓ)

Storeデータベース

Storeデータベース

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールド

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

syslog

syslog

syslog

syslog

(Ｕ)

Uncommitted Msgs

(Ｗ)

Windows MSCS

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

(ア行)

(あ)

アクション

アクション

アラーム

アラーム

アラーム一覧

アラームテーブル

アラームテーブル

アラームの記載形式

アンインストール手順

アンインストール手順

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

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

アンセットアップ手順

アンセットアップ手順

(い)

移行手順と移行時の注意事項

インスタンス

インスタンス

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

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

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

インスタンス環境の設定

インスタンス環境の設定

インスタンス番号

インスタンス番号

インスタンス番号

インスタンス名

インスタンス名

インストール手順

インストール手順

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

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

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

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

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

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

(う)

運用方式の変更

PFM - Agent for IBM WebSphere MQ

(え)

エージェント

エージェント

エージェントログ

エージェントログ

(カ行)

(か)

カーネルパラメーター

各バージョンの変更内容

08-11の変更内容

稼働状況監視

稼働状況監視の例

稼働状況ログ

管理ツール

(き)

機能ID

機能ID

機能ID

キューマネージャー

キューマネージャー

共通メッセージログ

共通メッセージログ

(く)

クラスタシステム

HAクラスタシステム

HAクラスタシステム

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

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

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

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

共有ディスク

共有ディスク

共有ディスク

クラスタ運用時のディスク占有量

クラスタシステム

クラスタシステム

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

クラスタシステムの概要

実行系ノード

実行系ノード

待機系ノード

待機系ノード

フェールオーバー

フェールオーバー

フェールオーバー

物理ホスト

物理ホスト

物理ホスト

論理ホスト

論理ホスト

論理ホスト

論理ホスト

クラスタシステム（UNIXの場合）

PFM - Agentの登録

PFM - Agentの論理ホストのアンセットアップ

PFM - Agentの論理ホストのセットアップ

PFM - Managerでの設定の削除

アンインストール手順

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

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

アンセットアップ手順

インスタンス環境の設定

インストール手順

共有ディスクのアンマウント

共有ディスクのアンマウント

共有ディスクのマウント

共有ディスクのマウント

クラスタシステムでの環境設定

クラスタソフトからのPFM - Agentの登録解除

クラスタソフトからの起動・停止の確認

クラスタソフトからの停止

クラスタソフトへのPFM - Agentの登録

接続先PFM - Managerの設定

セットアップ手順

他Performance Managementプログラムの論理ホストのアンセットアップ

他Performance Managementプログラムの論理ホストのセットアップ

ネットワークの設定

ポート番号の設定の解除

論理ホスト環境定義ファイルのインポート

論理ホスト環境定義ファイルのインポート

論理ホスト環境定義ファイルのエクスポート

論理ホスト環境定義ファイルのエクスポート

論理ホスト環境定義ファイルの待機系ノードへのコピー

論理ホスト環境定義ファイルの待機系ノードへのコピー

クラスタシステム（Windowsの場合）

PFM - Agentの論理ホストのアンセットアップ

PFM - Agentの論理ホストのセットアップ

PFM - Managerでの設定の削除

アンインストール手順

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

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

アンセットアップ手順

インスタンス環境の設定

インストール手順

共有ディスクのオフライン

共有ディスクのオフライン

共有ディスクのオンライン

共有ディスクのオンライン

クラスタシステムでの環境設定

クラスタソフトからのPFM - Agentの登録解除

クラスタソフトからの起動・停止の確認

クラスタソフトからの停止

クラスタソフトへのPFM - Agentの登録

接続先PFM - Managerの設定

セットアップ手順

他Performance Managementプログラムの論理ホストのアンセットアップ

他Performance Managementプログラムの論理ホストのセットアップ

ネットワークの設定

ポート番号の設定の解除

論理ホスト環境定義ファイルのインポート

論理ホスト環境定義ファイルのインポート

論理ホスト環境定義ファイルのエクスポート

論理ホスト環境定義ファイルのエクスポート

論理ホスト環境定義ファイルの待機系ノードへのコピー

論理ホスト環境定義ファイルの待機系ノードへのコピー

(こ)

コマンド

コマンド

compressコマンド

compressコマンド

hostnameコマンド

hostnameコマンド

jpcagtsetupコマンド

jpcagtsetupコマンド

jpcagtsetupコマンド

jpcalarmコマンド

jpcctrl deleteコマンド

jpcctrl deleteコマンド

jpcctrl deleteコマンド

jpcctrl dumpコマンド

jpcctrl dumpコマンド

jpcctrl dumpコマンド

jpcctrl dumpコマンド

jpcctrl listコマンド

jpcctrl listコマンド

jpcctrl listコマンド

jpcctrl listコマンド

jpcdbctrl configコマンド

jpcdbctrl configコマンド

jpchasetup createコマンド

jpchasetup createコマンド

jpchasetup createコマンド

jpchasetup deleteコマンド

jpchasetup deleteコマンド

jpchasetup exportコマンド

jpchasetup exportコマンド

jpchasetup exportコマンド

jpchasetup exportコマンド

jpchasetup import

jpchasetup import

jpchasetup importコマンド

jpchasetup importコマンド

jpchasetup listコマンド

jpchasetup listコマンド

jpchasetup listコマンド

jpchasetup listコマンド

jpcinslistコマンド

jpcinslistコマンド

jpcinslistコマンド

jpcinslistコマンド

jpcinssetupコマンド

jpcinssetupコマンド

jpcinssetupコマンド

jpcinsunsetupコマンド

jpcinsunsetupコマンド

jpcinsunsetupコマンド

jpcinsunsetupコマンド

jpcnsconfig portコマンド

jpcnsconfig portコマンド

jpcnsconfig portコマンド

jpcnsconfig portコマンド

jpcnshostnameコマンド

jpcnshostnameコマンド

jpcnshostnameコマンド

jpcrasコマンド

jpcrasコマンド

jpcstartコマンド

mountコマンド

suコマンド

suコマンド

tarコマンド

tarコマンド

tarコマンド

tarコマンド

uname -nコマンド

uname -nコマンド

コマンドの実行

コマンドの実行

(サ行)

(さ)

サービスID

サービスID

サービスID

サービスコントロールマネージャー

(し)

シーケンシャルファイル方式

しきい値

識別子一覧

システム管理者の方へ

システム見積もり

システムログ

資料採取コマンドを実行する

資料採取コマンドを実行する

資料採取コマンドを実行する（論理ホスト運用の場合）

資料採取コマンドを実行する（論理ホスト運用の場合）

資料の採取方法

(す)

スタンドアロンモード

スタンドアロンモード

ステータス管理機能

(せ)

性能情報監視

性能情報監視の例

セットアップコマンド

セットアップコマンド

前提プログラム

前提プログラム

(そ)

ソリューションセット

ソリューションセット

ソリューションセット

ソリューションセット

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

(タ行)

(た)

単数インスタンスレコード

(て)

ディスク占有量

データ型一覧

データベースID

データベースID

データモデル

データモデル

データモデル

デルタ

(と)

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

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

動作ログ出力の設定

動作ログ出力の設定

動作ログの出力

トラブルシューティング

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

トラブルへの対処方法

ドリルダウンレポート

トレースログ

トレースログ

(ナ行)

(ね)

ネットワークの設定

ネットワークの設定

(ハ行)

(は)

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

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

バージョン互換

バインド

バインド

パフォーマンスデータ

パフォーマンスデータ

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

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

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

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

パフォーマンスデータの管理方法

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

パフォーマンスデータの収集方法

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

(ふ)

ファイアウォールの通過方向

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

フィールド

フィールド

フィールド

フィールドの値

複数インスタンスレコード

複数インスタンスレコード

プロセス一覧

プロダクトID

プロダクトID

プロダクトID

(へ)

ベースラインの選定

(ほ)

ポート番号一覧

ポート番号の設定

ポート番号の設定

(マ行)

(ま)

マシンのホスト名の変更方法

(め)

メッセージ

メッセージ一覧

メッセージカタログ格納ディレクトリ内のファイルおよびディレクトリ一覧

メッセージの記載形式

メッセージの形式

メッセージの出力形式

メッセージの出力先一覧

メモリー所要量

(ヤ行)

(よ)

要約ルール

(ラ行)

(ら)

ライフタイム

ライフタイム

ラップラウンドファイル方式

(り)

リアルタイムレポート

リアルタイムレポート

履歴レポート

履歴レポート

(れ)

レコード

レコード

レコード

レコード

レコード一覧

レコードタイプ

レコードの記載形式

レコードの注意事項

レポート

レポート

レポート一覧

レポートの記載形式

レポートのディレクトリ構成

(ろ)

ログ情報

ログのファイルサイズ変更

ログのファイルサイズ変更

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

■ 商標類

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