JP1 Version 12　JP1/Integrated Management 2 - Manager コマンド・定義ファイルリファレンス

3021-3-D55-10

前書き

対象製品

適用OSのバージョン，JP1/Integrated Management 2 - Manager，およびJP1/Integrated Management 2 - Viewが前提とするサービスパックやパッチなどの詳細については各製品のリリースノートで確認してください。

●JP1/Integrated Management 2 - Manager（適用OS：Windows）

P-2A2C-8ECL JP1/Integrated Management 2 - Manager 12-10

製品構成一覧および内訳形名

P-CC2A2C-9MCL JP1/Integrated Management 2 - Manager 12-10 (適用OS: Windows Server 2019，Windows Server 2016，Windows Server 2012)

P-CC2A2C-6HCL JP1/Integrated Management 2 - View 12-00 (適用OS: Windows Server 2019，Windows Server 2016，Windows 10，Windows 8.1，Windows 8，Windows Server 2012，Windows 7)

●JP1/Integrated Management 2 - Manager（適用OS：Linux）

P-812C-8ECL JP1/Integrated Management 2 - Manager 12-10

製品構成一覧および内訳形名

P-CC812C-9MCL JP1/Integrated Management 2 - Manager 12-10 (適用OS: Linux 7，Linux 6 (x64)，Oracle Linux 7，Oracle Linux 6 (x64)，CentOS 7，CentOS 6 (x64))

P-CC9W2C-9MCL JP1/Integrated Management 2 - Manager 12-10 (適用OS: SUSE Linux 15，SUSE Linux 12)

P-CC2A2C-6HCL JP1/Integrated Management 2 - View 12-00 (適用OS: Windows Server 2019，Windows Server 2016，Windows 10，Windows 8.1，Windows 8，Windows Server 2012，Windows 7)

輸出時の注意

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

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

商標類

HITACHI，Cosminexus，HiRDB，JP1，ServerConductorは，株式会社 日立製作所の商標または登録商標です。

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。

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

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

Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびHyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Netscapeは，AOL Inc.の登録商標です。

OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。

Red Hat, and Red Hat Enterprise Linux are registered trademarks of Red Hat, Inc. in the United States and other countries. Linux(R) is the registered trademark of Linus Torvalds in the U.S. and other countries.

RSAおよびBSAFEは，米国EMC コーポレーションの米国およびその他の国における商標または登録商標です。

すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。

UNIXは，The Open Groupの米国ならびに他の国における登録商標です。

Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

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

本製品は，米国EMC コーポレーションのRSA BSAFE(R)ソフトウェアを搭載しています。

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

This product includes software developed by Ben Laurie for use in the Apache-SSL HTTP server project.

Portions of this software were developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5 Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England. The original software is available from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

This product includes software developed by Ralf S. Engelschall <rse@engelschall.com> for use in the mod_ssl project (http://www.modssl.org/).

This product includes software developed by Andy Clark.

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi (http://relaxngcc.sf.net/).

This product includes software developed by IAIK of Graz University of Technology.

This product includes software developed by the Java Apache Project for use in the Apache JServ servlet engine project (http://java.apache.org/).

Java is a registered trademark of Oracle and/or its affiliates.

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

製品名

Hyper-V

Microsoft(R) Windows Server(R) 2008 R2 Hyper-V(R)

Microsoft(R) Windows Server(R) 2012 Hyper-V(R)

IE

Windows Internet Explorer

Windows(R) Internet Explorer(R)

SCVMM

Microsoft(R) System Center Virtual Machine Manager 2008

Microsoft(R) System Center Virtual Machine Manager 2012

Windows 7

Microsoft(R) Windows(R) 7 Enterprise

Microsoft(R) Windows(R) 7 Professional

Microsoft(R) Windows(R) 7 Ultimate

Windows 8

Windows(R) 8 Enterprise

Windows(R) 8 Pro

Windows 8.1

Windows(R) 8.1 Enterprise

Windows(R) 8.1 Pro

Windows 10

Windows(R) 10 Enterprise 32-bit

Windows(R) 10 Enterprise 64-bit

Windows(R) 10 Home 32-bit

Windows(R) 10 Home 64-bit

Windows(R) 10 Pro 32-bit

Windows(R) 10 Pro 64-bit

Windows Server 2012

Windows Server 2012

Microsoft(R) Windows Server(R) 2012 Datacenter

Microsoft(R) Windows Server(R) 2012 Standard

Windows Server 2012 R2

Microsoft(R) Windows Server(R) 2012 R2 Datacenter

Microsoft(R) Windows Server(R) 2012 R2 Standard

Windows Server 2016

Microsoft(R) Windows Server(R) 2016 Datacenter

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2019

Microsoft(R) Windows Server(R) 2019 Datacenter

Microsoft(R) Windows Server(R) 2019 Standard

Windows Server 2019，Windows Server 2016，Windows 10，Windows 8.1，Windows 8，Windows Server 2012，およびWindows 7を総称してWindowsと表記することがあります。

発行

2020年1月　3021-3-D55-10

著作権

Copyright (C) 2019, 2020, Hitachi, Ltd.

Copyright (C) 2019, 2020, Hitachi Solutions, Ltd.

奥付

マニュアル発行元

株式会社 日立製作所

〒100‒8280　東京都千代田区丸の内一丁目6番6号

変更内容

変更内容(3021-3-D55-10)　JP1/Integrated Management 2 - Manager　12-10

追加・変更内容

変更個所

次のコマンドを追加した。

jddsetproxyuser

1.コマンド一覧，1.jddsetproxyuser

機能説明を変更した。

1.jddsetaccessuser

64bit版の統合トレースログの資料格納先を追加した。

1.jcoview_log.bat（Windows限定）

インテリジェント統合管理基盤のプラグインの資料格納先を追加した。

-bオプションを追加した。

1.jim_log.bat（Windows限定），1.jim_log.sh（UNIX限定）

インテリジェント統合管理基盤で，次の機能が利用できるようにした。

プロキシサーバーの認証

［ユーザー定義の画面表示領域］の設定

連携ユニット表示機能の使用有無の設定

後続ルートジョブネットへの影響が不明であることを示すアイコンの表示有無の設定

繰り返しイベントの表示抑止機能の互換設定（バージョン12-00互換）

2.インテリジェント統合管理基盤定義ファイル（imdd.properties）

システム，またはサブシステムに属するオブジェクトルートノードの構成の取得を定義できるようにした。

2.システムノード定義ファイル（imdd_systemnode.conf）

ジョブネット間の関連を定義できるようにした。

2.IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）

モニター画面呼び出し定義ファイルの置き換えキーワードについて，インテリジェント統合管理基盤の場合は，置き換えされないキーワードがあることを補足した。

2. モニター画面呼び出し定義ファイル

ダミーイベントに関する制限事項を追加した。

3.2.1

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

はじめに

このマニュアルは，JP1/Integrated Management 2 - ManagerおよびJP1/Integrated Management 2 - Viewのコマンドや定義ファイルなどについて説明したものです。なお，このマニュアルでは，JP1/Integrated Management 2 - ManagerおよびJP1/Integrated Management 2 - Viewを総称して，JP1/Integrated ManagementまたはJP1/IMと表記します。また，このマニュアルでのJP1/Integrated Management - ManagerおよびJP1/Integrated Management - Viewは，それぞれJP1/Integrated Management 2 - ManagerおよびJP1/Integrated Management 2 - Viewと読み替えてください。

対象読者

オープンプラットフォームのシステムを管理するインフラを，JP1/IMを使って管理，運用，操作される方を対象としています。具体的には次の方を対象としています。

システムで発生する事象を一元監視するため，JP1/IMを管理，運用，操作するシステム管理者

システムを管理するインフラの状態をシステムで発生する事象と関連づけて一元監視するため，JP1/IMを管理，運用，操作するシステム管理者

OSおよびアプリケーションについて知識がある方

マニュアルの構成

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

第1章　コマンド

JP1/Integrated Managementで使用できるコマンドの文法について説明しています。

第2章　定義ファイル

JP1/Integrated Managementの定義ファイルの形式および文法について説明しています。

第3章　JP1イベント

JP1/Integrated Managementが出力するJP1イベントの種類とその属性について説明しています。

第4章　システム監視オブジェクト一覧（セントラルスコープ用）

JP1/Integrated Managementで提供しているシステム監視オブジェクトについて説明しています。

第5章　監視ツリーモデル（セントラルスコープ用）

監視ツリーを自動生成するときに作成される監視ツリーの構造について説明しています。

マニュアルの体系

JP1/IMのマニュアルでは，システムの設計・構築・運用などのシステムのライフサイクルでの段階ごとに必要な情報を説明しています。目的に合わせて必要なマニュアルをお読みください。

JP1/IMのマニュアルとシステムのライフサイクルの関係を次の図に示します。

このマニュアルで使用する記号

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

記号

意味

［　］

メニュー項目，画面名，ボタン名，およびキーボードのキーなどを示す。

例

メニュー項目：［新規作成］

画面名：［ログイン］画面

ボタン名：［OK］ボタン

キーボードのキー：［Ctrl］キー

［　］−［　］

画面のメニューから項目を選択する操作を示す。

例

［ファイル］−［新規作成］を選択する。

上記の例では，メニューバーの［ファイル］を選んで，プルダウンメニューの［新規作成］を選択することを示す。

［　］＋［　］

キーを同時に押すことを示す。

例

［Ctrl］＋［C］キー

上記の例では，［Ctrl］キーと［C］キーを同時に押すことを示す。

コマンドの文法で使用する記号

コマンドとパラメーターの説明で使用する記号を，次のように定義します。

記号

意味

|

(ストローク)

複数の項目に対し，項目間の区切りを示し，「または」の意味を示す。

例

「A | B | C」は，「A，BまたはC」を示す。

｛　｝

この記号で囲まれている複数の項目の中から，必ず一つの項目を選択する。項目の区切りは|で示す。

例

｛A | B | C｝は「A，BまたはCのどれかを指定する」ことを示す。

[　]

この記号で囲まれている項目は任意に指定できる（省略してもよい）。

複数の項目が記述されている場合には，すべてを省略するか，どれか一つを選択する。

例

[A]は「何も指定しない」か「Aを指定する」ことを示す。

[B | C]は「何も指定しない」か「BまたはCを指定する」ことを示す。

…または...

この記号の直前に示された項目を繰り返して複数個，指定できる。

例

「A，B，…」は「AのあとにBを必要個数指定する」ことを示す。

＿

(下線)

括弧内のすべてを省略したときに，システムがとる標準値を示す。標準値がない場合は，指定した項目だけが有効である。

例

[A | B]はこの項目を指定しなかった場合に，Aを選択したと見なすことを示す。

△

空白を表す。

△₀：0個以上の空白（空白を省略できる）

△₁：1個以上の空白（空白を省略できない）

▲

タブを表す。

例

▲Aとした場合に，Aの前にタブがあることを示す。

図中で使用する記号

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

Windows版JP1/IM，JP1/Baseのインストール先フォルダの表記

このマニュアルでは，Windows版JP1/IM，JP1/Baseのインストール先フォルダを次のように表記しています。

製品名

インストール先フォルダの表記

デフォルトインストール先フォルダ※

JP1/IM - View

Viewパス

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

JP1/IM - Manager

Managerパス

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

Consoleパス

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

Scopeパス

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

JP1/Base

Baseパス

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

注※　各製品をデフォルトのままインストールした場合のインストール先フォルダを表しています。「システムドライブ:¥Program Files」と表記している部分は，インストール時のOS環境変数によって決定されるため，環境によって異なる場合があります。

このマニュアルで使用する「Administrators権限」について

このマニュアルで表記している「Administrators権限」とは，ローカルPCに対するAdministrators権限です。ローカルPCに対してAdministrators権限を持つユーザーであれば，ローカルユーザー，ドメインユーザーおよび，Active Directory環境で動作に違いはありません。

このマニュアルで使用する定義ファイルに指定するパスについて

ファイル名を指定する定義には，ネットワークパスを指定することはできません。

例えば，イベントガイド情報ファイルに記述するEV_FILEにはネットワークパス以外の任意のフォルダ（パス）を指定してください。

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

JP1/IMでは，Webブラウザーで参照できるHTMLマニュアルを提供しています。

オンラインマニュアルの内容は，このマニュアルと同様です。

オンラインマニュアルは，次の操作で目次が表示されます。

JP1/IM - View：［ヘルプ］−［目次］を選択する。

統合オペレーション・ビューアー：［ヘルプ］−［オンラインマニュアル］を選択する。

注意事項

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

統合トレースログの出力先について

JP1/IM 12-10から，JP1/IM - Managerの32ビットJavaプロセスを，すべて64ビットJavaプロセスに変更しました。このため，JP1/IMの各機能のJavaプロセス機能が出力する統合トレースログの出力先が変更となります。

バージョン12-10以降のJP1/IMの各機能の統合トレースログの出力先を次に示します。ログファイルトラップ機能を使用している場合，出力先の変更に応じて設定変更が必要です。

統合トレースログの出力先（32ビット）：システムドライブ¥Program Files(x86)¥Hitachi¥HNTRLib2¥spool

IMデータベース

セントラルスコープサービス

プロセス管理

コマンド実行

自動アクション

インストールおよびセットアップ

統合トレースログの出力先（64ビット）：システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool

イベント基盤サービス

セントラルコンソール・ビューアー

セントラルスコープ・ビューアー

相関イベント発行サービス

IM構成管理

IM構成管理・ビューアー

インテリジェント統合管理基盤

1　コマンド

この章では，JP1/IMで使用できるコマンドの文法について説明します。

コマンドの記述形式

コマンドの記述形式について説明します。ただし，コマンドによっては説明しない項目もあります。

機能

コマンドの機能について説明しています。

形式

コマンドの形式を説明しています。

実行権限

コマンドの実行に必要なユーザーの権限について説明しています。

格納先ディレクトリ

コマンドの格納場所について説明しています。

引数

コマンドの引数について説明しています。

なお，引数は大文字・小文字を区別します。ただし，ON，OFFの指定は大文字・小文字を区別しません。

注意事項

注意事項を説明しています。

戻り値

コマンドの戻り値について説明しています。

なお，コマンド実行時に表示されるメッセージについては，マニュアル「JP1/Integrated Management 2 - Manager メッセージ」を参照してください。

使用例

コマンドの使用例について説明しています。

出力例

コマンドの出力例について説明しています。

コマンド一覧

JP1/IMで使用できるコマンド名とコマンドを実行するために必要な権限の一覧を示します。なお，次節以降のコマンドの説明では，コマンドはアルファベット順に記載されています。

表中の凡例および注釈

表中では，Windows，UNIXの対応を凡例のように表記しています。

（凡例）

○：対応している

−：対応していない

注※1

Windowsの場合，スーパーユーザーとはAdministrators権限を持つユーザーを指します。

注※2

マネージャーが対象のJP1/Baseのコマンド（構成定義，コマンド実行に関するコマンド）です。コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」のコマンドを説明している章を参照してください。

注※3

Windowsの場合はAdministrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）が必要です。

起動・終了，セットアップに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

JP1/IM - Manager（セントラルコンソール）のセットアップをする

jp1cc_setup（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Manager（セントラルスコープ）のセットアップをする

jp1cs_setup（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Managerを自動的に起動する

jco_start（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Managerを自動的に終了する

jco_stop（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Managerのプロセスの状態を確認する

jco_spmd_status

○

○

スーパーユーザー※1

JP1/IM - Managerのプロセスの状態を更新する

jco_spmd_reload

○

○

スーパーユーザー※1

クラスタシステムで運用するための設定をする

jp1cohasetup（Windows限定）

○

−

スーパーユーザー※1

jp1cshasetup（Windows限定）

○

−

スーパーユーザー※1

jp1cc_setup_cluster（UNIX限定）

−

○

スーパーユーザー

jp1cs_setup_cluster（UNIX限定）

−

○

スーパーユーザー

クラスタシステムでJP1/IM - Managerを起動する

jco_start.cluster（UNIX限定）

−

○

スーパーユーザー

クラスタシステムでJP1/IM - Managerを終了する

jco_stop.cluster（UNIX限定）

−

○

スーパーユーザー

クラスタシステムでJP1/IM - Managerを強制的に終了する

jco_killall.cluster（UNIX限定）

−

○

スーパーユーザー

JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を設定する

SpmSetSvcCon（Windows限定）

○

−

スーパーユーザー※1

IMデータベースに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

構成情報を格納するIM構成管理DBをセットアップする

jcfdbsetup

○

○

スーパーユーザー※1

構成情報を格納するIM構成管理DBをアンセットアップする

jcfdbunsetup

○

○

スーパーユーザー※1

JP1イベントを格納する統合監視DBをセットアップする

jcodbsetup

○

○

スーパーユーザー※1

JP1イベントを格納する統合監視DBをアンセットアップする

jcodbunsetup

○

○

スーパーユーザー※1

統合監視DBに登録しているJP1イベントの情報をCSV形式にしてファイルに出力する

jcoevtreport

○

○

スーパーユーザー※1

IMデータベースをバックアップする

jimdbbackup

○

○

スーパーユーザー※1

IM構成管理DBの使用中の空き領域（空きページ領域）を解放する

jimdbreclaim

○

○

スーパーユーザー※1

バックアップで保管しておいたデータベースを復旧（リカバリー）する

jimdbrecovery

○

○

スーパーユーザー※1

データベースの断片化された空き領域を再編成する

jimdbrorg

○

○

スーパーユーザー※1

IMデータベースの起動・停止などの稼働状態を確認する

jimdbstatus

○

○

スーパーユーザー※1

IMデータベースを停止する

jimdbstop

○

○

スーパーユーザー※1

IMデータベースをアップデートする

jimdbupdate

○

○

スーパーユーザー※1

IM構成管理に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

HCSMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmhcsm

○

○

スーパーユーザー※1

KVMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmkvm

○

○

スーパーユーザー※1

SCVMMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmscvmm（Windows限定）

○

−

スーパーユーザー※1

vCenterから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmvc

○

○

スーパーユーザー※1

日立サーバ論理分割機構から仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmvirtage

○

○

スーパーユーザー※1

VMware ESXから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmesx

○

○

スーパーユーザー※1

IM構成管理で管理しているシステムの階層構成（IM構成），ホスト情報および定義情報を出力する

jcfexport

○

○

スーパーユーザー※1

IM構成管理の情報をインポートする

jcfimport

○

○

スーパーユーザー※1

ホスト入力情報ファイルとセントラルスコープのエクスポートファイルから，仮想化構成の監視ツリー情報を追加したセントラルスコープのインポートファイルを生成する。または，業務グループ情報ファイル，監視グループ情報ファイルおよびセントラルスコープのエクスポートファイルから，業務グループの監視ツリー情報を追加したセントラルスコープのインポートファイルを生成する

jcfmkcsdata

○

○

スーパーユーザー※1

仮想化構成情報ファイルで，ホスト入力情報ファイルを更新する

jcfmkhostsdata

○

○

スーパーユーザー※1

指定ホストの仮想化構成を更新する

jcfvirtualchstat

○

○

スーパーユーザー※1

JP1/IM - ManagerのIM構成管理プロセスの動作環境を設定する

jp1cf_setup（UNIX限定）

−

○

スーパーユーザー

クラスタシステムで運用する場合に，IM構成管理の環境設定をする

jp1cf_setup_cluster（UNIX限定）

−

○

スーパーユーザー

クラスタシステムで運用する場合に，IM構成管理の環境設定をする

jp1cfhasetup（Windows限定）

○

−

スーパーユーザー※1

IM構成管理に関するコマンド（リモート監視構成）

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

指定した監視対象ホストに，リモート監視イベントログトラップのプロファイルを定義する

jcfaleltdef（Windows限定）

○

−

スーパーユーザー※1

リモート監視イベントログトラップ動作定義ファイルをリロードする

jcfaleltreload（Windows限定）

○

−

スーパーユーザー※1

リモート監視イベントログトラップを起動する

jcfaleltstart（Windows限定）

○

−

スーパーユーザー※1

リモート監視イベントログトラップの動作状況を表示する

jcfaleltstat（Windows限定）

○

−

スーパーユーザー※1

リモート監視イベントログトラップを停止する

jcfaleltstop（Windows限定）

○

−

スーパーユーザー※1

指定した監視対象ホストに，リモート監視ログファイルトラップのプロファイルを追加または削除する

jcfallogdef

○

○

スーパーユーザー※1

リモート監視ログファイルトラップ動作定義ファイルをリロードする

jcfallogreload

○

○

スーパーユーザー※1

リモート監視ログファイルトラップを起動する

jcfallogstart

○

○

スーパーユーザー※1

リモート監視ログファイルトラップの動作状況を表示する

jcfallogstat

○

○

スーパーユーザー※1

リモート監視ログファイルトラップを停止する

jcfallogstop

○

○

スーパーユーザー※1

バージョンアップに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

11-50より前のアクション定義ファイルを11-50以降のアクション定義ファイルに変換する

jcadefconv

○

○

スーパーユーザー※1

イベント取得フィルターが互換用で動作している場合にイベント取得フィルターの位置をイベントコンソールサービスからイベント基盤サービスに変更する

jcochafmode（UNIX限定）

○

○

スーパーユーザー※1

バージョン7以前のJP1/Baseのコマンド実行の履歴をバージョン8用のコマンド実行履歴ファイルに移行する

jcocmdconv※2

○

○

スーパーユーザー※1

旧バージョンのJP1/IM - ManagerまたはJP1/IM - Manager（セントラルコンソール）で設定した論理ホスト環境をバージョンアップする

jp1cohaverup

○

○

スーパーユーザー※1

旧バージョンのJP1/IM - Manager（セントラルスコープ）の物理ホスト環境をバージョンアップする

jp1csverup.bat（Windows限定）

○

−

スーパーユーザー※1

旧バージョンのJP1/IM - Manager（セントラルスコープ）で設定した論理ホスト環境をバージョンアップする

jp1cshaverup.bat（Windows限定）

○

−

スーパーユーザー※1

旧バージョンのJP1/IM - Manager（セントラルスコープ）の物理ホスト環境をバージョンアップする

jp1csverup（UNIX限定）

−

○

スーパーユーザー

旧バージョンのJP1/IM - Manager（セントラルスコープ）で設定した論理ホスト環境をバージョンアップする

jp1cshaverup（UNIX限定）

−

○

スーパーユーザー

インテリジェント統合管理基盤に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

JP1/IM - Manager（インテリジェント統合管理基盤）が管理するシステム構成情報を取得し，IM管理ノード関連ファイルを生成する

jddcreatetree

○

○

スーパーユーザー※1

インテリジェント統合管理サーバが管理する製品からシステム構成情報を取得し，jddupdatetreeコマンドの入力データとなるIM管理ノード関連ファイルを生成する

jddupdatetree

○

○

スーパーユーザー※1

JP1/IM - Manager（インテリジェント統合管理基盤）が連携する製品から認証を受けるために使用するユーザーIDとパスワードを設定する

jddsetaccessuser

○

○

スーパーユーザー※1

JP1/IM - Manager（インテリジェント統合管理基盤）が提供するプラグインからREST APIを実行する場合のプロキシサーバーの認証情報を設定する

jddsetproxyuser

○

○

スーパーユーザー※1

ビューの起動に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

IM構成管理・ビューアーを起動する

jcfview（Windows限定）

○

−

なし

IM構成管理・ビューアーを起動するメニューをWindowsスタートメニューに登録・削除する

jcovcfsetup（Windows限定）

○

−

スーパーユーザー※1

JP1/IM - Viewの［ログイン］画面，［監視ツリー(編集中)］画面を起動する，またはコマンドラインからJP1/IM - Managerにログインする

jcoview（Windows限定）

○

−

なし

構成定義に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

構成定義情報を下位ホストに配布し，定義を有効にする

jbsrt_distrib※2

○

○

スーパーユーザー※1

下位ホストから構成定義情報を収集し，構成定義を更新する

jbsrt_sync※2

○

○

スーパーユーザー※1

コマンドを実行したホストの構成定義情報を削除する

jbsrt_del※2

○

○

スーパーユーザー※1

設定されている構成定義情報を表示する

jbsrt_get※2

○

○

スーパーユーザー※1

イベントに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

重要イベントの対処状況を変更する

jcochstat

○

○

なし※3

JP1/IM - Managerのシステム環境を設定する

jcoimdef

○

○

スーパーユーザー※1

自動アクション，およびコマンド実行に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

自動アクションの定義をチェックし，複数の定義ファイルを併合する

jcamakea

○

○

スーパーユーザー※1

自動アクションの実行結果を表示する

jcashowa

○

○

なし※3

稼働しているアクション実行サービスの動作状態，および読み込んでいる自動アクション定義ファイルの内容を標準出力に表示する

jcastatus

○

○

なし※3

自動アクションの定義を再読み込みする，自動アクション機能を休止する，自動アクション定義を有効化または無効化する

jcachange

○

○

スーパーユーザー※1

自動アクションをキャンセルする

jcacancel

○

○

スーパーユーザー※1

コマンド実行のための環境を設定する

jcocmddef※2

○

○

スーパーユーザー※1

実行したコマンドの履歴を出力する

jcocmdlog※2

○

○

なし

JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドを削除する

jcocmddel※2

○

○

スーパーユーザー※1

JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドの状態を確認する

jcocmdshow※2

○

○

スーパーユーザー※1

メール通知機能に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

指定したメールアドレスにメールを送信する

jimmail（Windows限定）

○

−

スーパーユーザー※1

POP before SMTPまたはSMTP-AUTH認証のパスワードをメール環境定義ファイルに設定する

jimmailpasswd（Windows限定）

○

−

スーパーユーザー※1

相関イベントの発行に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

相関イベント発行定義を変更する

jcoegschange

○

○

スーパーユーザー※1

相関イベント発行定義ファイルの定義内容をチェックする

jcoegscheck

○

○

スーパーユーザー※1

相関イベント発行機能を相関稼働状態にする

jcoegsstart

○

○

スーパーユーザー※1

相関イベント発行機能の状態，および現在使用している相関イベント発行定義を表示する

jcoegsstatus

○

○

なし※3

相関イベント発行機能を機能停止状態にする

jcoegsstop

○

○

スーパーユーザー※1

セントラルスコープの環境設定で使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

ホスト情報をホスト情報DBに登録する

jcshostsimport

○

○

スーパーユーザー※1

ホスト情報DBからホスト情報を取得する

jcshostsexport

○

○

スーパーユーザー※1

監視オブジェクトDBを作成または再作成する

jcsdbsetup

○

○

スーパーユーザー※1

フィルターに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

イベント取得フィルターを切り替える

jcochfilter

○

○

スーパーユーザー※1

共通除外条件の動作モードを変更する

jcochcefmode

○

○

スーパーユーザー※1

セントラルスコープの監視ノードの状態変更に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

監視ノード（監視オブジェクトまたは監視グループ）の状態を変更する

jcschstat

○

○

スーパーユーザー※1

セントラルスコープの監視オブジェクトDBの情報を移行するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

JP1/IM - Managerの監視オブジェクトDBの保管情報を一括取得し，ローカルにファイル出力する

jcsdbexport

○

○

スーパーユーザー※1

jcsdbexportコマンドでファイル出力した情報をJP1/IM - Managerの監視オブジェクトDBに反映する

jcsdbimport

○

○

スーパーユーザー※1

トラブルシューティングに使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

IM構成管理・ビューアーのJavaスレッドダンプを生成する

jcfthreaddmp（Windows限定）

○

−

なし

JP1/IM - Manager，およびJP1/IM - Viewの障害発生時の資料を採取する

jim_log.bat（Windows限定）

○

−

なし※3

JP1/IM - Managerの障害発生時の資料を採取する

jim_log.sh（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Viewの障害発生時の資料を採取する

jcoview_log.bat（Windows限定）

○

−

なし※3

JP1/IM - Viewの障害発生時にスレッドダンプを出力する

jcothreaddmp（Windows限定）

○

−

なし

JP1/IM - Managerの障害発生時にスレッドダンプ，コアダンプ（UNIX限定）を出力する

jcogencore

○

○

スーパーユーザー※1

JP1/IM - Managerのヘルスチェック定義ファイルで定義した通知コマンドをテストする

jcohctest

○

○

スーパーユーザー※1

JP1/IM - Managerの定義ファイルの内容をチェックするコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

イベント拡張属性定義ファイルをチェックする

jcoattrfcheck

○

○

なし※3

モニター画面呼び出し定義ファイルをチェックする

jcomonitorfcheck

○

○

なし※3

JP1/IM - Viewの定義ファイルの内容をチェックするコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

アプリケーション実行定義ファイルをチェックする

jcoappexecfcheck（Windows限定）

○

−

なし

統合機能メニュー定義ファイルをチェックする

jcofuncfcheck（Windows限定）

○

−

なし

JP1/IM - Managerの管理ノード数をカウントするコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

JP1/IM - Managerの管理ノード数をカウントする

jimnodecount

○

○

スーパーユーザー※1

jcacancel

機能

自動アクションをキャンセルするコマンドです。このコマンドは，システムの運用に必要なくなった次に示すようなアクションを，JP1/IM - Managerから削除する場合に使用します。

システムの運用中に自動アクションが多発したことによって，「キューイング」状態のまま実行されないアクション

処理に時間が掛かるコマンドまたは処理が終了しないコマンドの実行によって，「実行中」状態のまま終了しないアクション

アクションで実行したコマンドは，jcocmddelコマンドでも削除できますが，アクションの状態が「キャンセル」になりません。jcocmddelコマンドは，jcacancelコマンドでキャンセルできなくなってしまったアクションを削除する場合に使用してください。

jcocmddelコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」のコマンドに関する章を参照してください。

キャンセル後のアクションの状態は，キャンセルするアクションの状態に応じて異なります。キャンセルできるアクションの状態と，キャンセル後のアクションの状態を次に示します。

表1‒1　キャンセルできるアクションの状態，キャンセル後のアクションの状態

キャンセルできるアクションの状態

キャンセル後のアクションの状態※1

「送信待機」または「送信待機（キャンセル失敗）」

「キャンセル」

「送信中（キャンセル失敗）」※2

「キューイング」または「キューイング（キャンセル失敗）」

「実行中」または「実行中（キャンセル失敗）」

「強制終了」

注※1　キャンセル処理中にJP1/Baseのコマンド制御内で，エラーが発生するとアクションの状態は「実行失敗（キャンセル失敗）」になります。

注※2　状態が「送信中」のアクションは，キャンセルできません。キャンセルを実行すると状態が「送信中（キャンセル失敗）」になります。

形式

jcacancel [-h 論理ホスト名]
          {[-i アクション通し番号,...] | [-a] | [-s アクション実行ホスト名]}
          [-f]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応する自動アクションをキャンセルします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-i アクション通し番号

アクション単位で，自動アクションをキャンセルする場合に指定します。

アクション通し番号は，jcashowaコマンド，またはJP1/IM - View上の［アクション結果一覧］画面，および［アクション結果詳細］画面で確認できます。最大20件指定できます。複数のアクション通し番号を指定する場合は，アクション通し番号を半角コンマ（,）で区切ってください。なお，アクション通し番号とアクション通し番号の間に，ほかのオプションは指定できません。

複数のアクション通し番号を指定した場合には，実行途中でエラーが発生しても処理を継続します。エラーメッセージはエラーが発生した件数だけ表示されます。

-iオプションで複数のアクションを指定して複数アクションをキャンセルした場合に，複数のエラーが発生したとき，最後にエラーとなったエラー内容がjcacancelコマンドの戻り値となります。

-a

jcacancelを実行するJP1/IMから実行し，監視しているすべてのホストに存在する自動アクションをキャンセルする場合に指定します。

-aオプションを指定して複数アクションをキャンセルした場合に，複数のエラーが発生したとき，最後にエラーとなったエラー内容がjcacancelコマンドの戻り値となります。

-s アクション実行ホスト名

jcacancelを実行するJP1/IMから実行し，指定した実行先ホストに存在する自動アクションをキャンセルする場合に指定します。

システム構成の定義で管理対象ホストに設定したホストだけ指定できます。なお，IPアドレス，およびホストグループは指定できません。

-sオプションを指定して複数アクションをキャンセルした場合に，複数のエラーが発生したとき，最後にエラーとなったエラー内容がjcacancelコマンドの戻り値となります。

-f

キャンセル時の確認メッセージを省略して，自動アクションをキャンセルしたい場合に指定します。

注意事項

キャンセル処理中に実行先のホストが再起動した場合の処理

自動アクションのキャンセル処理中にアクション実行先のホストが再起動した場合には，アクションのキャンセル状態を取得できません。そのため，アクションの状態が「送信待機（キャンセル中）」，「送信中（キャンセル中）」，「キューイング（キャンセル中）」，または「実行中（キャンセル中）」のままになり，キャンセル処理が成功したかどうか確認できません。jcocmdshowコマンドで確認し，アクションが残っている場合には，jcocmddelコマンドで削除してください。

戻り値

0

正常終了

1

引数不正エラー

2

共通定義不正エラー

3

アクション状態不正エラー

4

キャンセル処理エラー

5

入出力エラー

6

自動アクション機能（アクション実行サービス）からの応答がない

7

実行権限エラー（Windows限定）

255

システムエラー

使用例1

複数の自動アクション（アクション通し番号23，35，42）をキャンセルする場合

jcacancel -i 23,35,42

使用例2

論理ホストhostAから実行し，論理ホストhostAの監視下にあるすべてのホストに存在する自動アクションをキャンセルする場合

jcacancel -h hostA -a

使用例3

jcacancelを実行するJP1/IMから実行し，ホストhost01に存在する自動アクションをキャンセルする場合

jcacancel -s host01

使用例4

論理ホストhostBから実行し，論理ホストhostB監視下のhost02に存在する自動アクションをキャンセルする場合

jcacancel -h hostB -s host02

使用例5

論理ホストhostCの監視下にある自動アクションを，アクション通し番号（23，35，42）を指定してキャンセルする場合

jcacancel -h hostC -i 23,35,42

jcachange

機能

自動アクション定義ファイルを再読み込みする，自動アクション機能を休止する，または，自動アクション定義を有効化または無効化するコマンドです。

オプションを省略した場合，自動アクション定義ファイルを再読み込みします。自動アクション定義ファイルの内容を変更したあとに，変更したアクション定義を有効にするために，このコマンドで再読み込みをします。

自動アクション定義ファイル中の不正なアクション定義は読み飛ばし，処理を続行します。

自動アクション定義ファイルに不正なアクション定義があった場合，KAVB5104-Wのメッセージが出力されます。変更した自動アクション定義ファイルを再読み込みする場合は，このコマンドを実行する前にjcamakeaコマンドを実行して自動アクション定義ファイルに誤りがないことを確認してください。

KAVB5104-Wのメッセージが出力された場合は，自動アクション定義ファイルの内容を見直してください。

読み込んだ自動アクション定義ファイルに有効なアクション定義がない場合，KAVB4053-Iのメッセージが出力され，自動アクション機能を休止します。

このコマンドをオプション指定なしで実行する場合，すべてのアクション実行条件の抑止時間とAND条件の部分成立状態を初期化します。-e，-on，-off，または-stオプションを指定した場合は，定義変更していないアクション実行条件の抑止時間とAND条件の部分成立状態を維持します。

再読み込みした自動アクション定義パラメーターのサイズが最大長を超えていた場合，該当する行番号の自動アクション定義パラメーターは無視されます。自動アクション定義パラメーターのサイズについては，「自動アクション定義ファイル（actdef.conf）」（2.　定義ファイル）を参照してください。

形式

jcachange [-n] [-h 論理ホスト名]
          [-e [アクションID[,アクションID...] | ALL]]
          [-on アクションID[,アクションID...]]
          [-off アクションID[,アクションID...]]
          [-st]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-n

自動アクション機能を休止します。アクション定義に一致するイベントを受信しても，アクションは実行されません。

自動アクション機能を再開するには，オプションを省略してjcachangeコマンドを実行するか，JP1/IM - Managerを再起動します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応するアクション定義を再読み込み，または休止します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-e [アクションID[,アクションID...] | ALL]

有効にしたいアクション定義のアクションIDを指定します。指定しなかったアクション定義は無効になります。複数指定する場合は，コンマで区切ります。すべてのアクションを有効にしたい場合は，ALLを指定します。

このオプションを指定した場合，アクション定義ファイル中の該当するアクションIDのvalidパラメーターをtrueに書き換えます。指定されていないアクションIDのvalidパラメーターはfalseに書き換えます。ALLを指定した場合はすべてのvalidパラメーターをtrueに書き換えます。

アクション定義ファイルのDESC_VERSIONが4のときだけ使用できます。

指定したアクションIDのアクション定義がアクション定義ファイルにない場合はKAVB4028-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード10で終了します。アクション定義ファイルにアクション実行条件が一つも定義されていない状態でALLを指定した場合は，KAVB4029-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード10で終了します。アクション定義ファイルにアクション実行条件が一つも定義されていない状態でアクションIDを指定しなかった場合は，KAVB4029-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード11で終了します。

-on アクションID[,アクションID...]

有効にしたいアクション定義のアクションIDを指定します。複数指定する場合は，コンマで区切ります。指定していないアクションIDの状態は変わりません。-eオプションと同時に指定できません。

このオプションを指定した場合，アクション定義ファイル中の該当するアクションIDのvalidパラメーターをtrueに書き換えます。

アクション定義ファイルのDESC_VERSIONが4のときだけ使用できます。

指定したアクションIDのアクション定義がアクション定義ファイルにない場合はKAVB4028-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード10で終了します。

-off アクションID[,アクションID...]

無効にしたいアクション定義のアクションIDを指定します。複数指定する場合は，コンマで区切ります。指定していないアクションIDの状態は変わりません。-eオプションと同時に指定できません。

このオプションを指定した場合，アクション定義ファイル中の該当するアクションIDのvalidパラメーターをfalseに書き換えます。

アクション定義ファイルのDESC_VERSIONが4のときだけ使用できます。

指定したアクションIDのアクション定義がアクション定義ファイルにない場合はKAVB4028-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード11で終了します。

-st

コマンド実行時に，次に示すアクション実行条件の抑止状態およびAND条件の部分成立状態を初期化しない場合に指定します。

イベント基盤サービスで動作しているアクション実行条件の定義内容と，アクション定義ファイルの定義内容が同じアクション実行条件

アクション定義ファイルのDESC_VERSIONが4のときだけ使用できます。このオプションと同時に指定できるのは，-hオプションだけです。

注意事項

jcachangeコマンドを大量に同時実行すると，マネージャーの性能が低下したり，タイムアウトが発生したりすることがあります。

戻り値

0

正常終了

4

自動アクション機能からの応答がない

5

自動アクション定義ファイルの再読み込み，自動アクション機能の一時停止失敗

10

有効化対象のアクション定義が存在しない

11

無効化対象のアクション定義が存在しない

12

自動アクション定義ファイルの排他に失敗したため，更新に失敗した

13

自動アクション定義ファイルの排他に失敗したため，読み込みに失敗した

111

イベント基盤サービスまたはイベントコンソールサービスとの接続に失敗（UNIXの場合）

154

ファイル入出力エラー（UNIXの場合）

243

引数指定値不正（UNIXの場合）

-13

引数指定値不正（Windowsの場合）

-102

ファイル入出力エラー（Windowsの場合）

-401

イベント基盤サービスまたはイベントコンソールサービスとの接続に失敗（Windowsの場合）

その他の値

システムエラー

jcadefconv

機能

バージョン11-50より前のアクション定義ファイル（DESC_VERSIONの値が4未満）を11-50以降のアクション定義ファイル（DSEC_VERSIONの値が4）に変換します。

ただし，バージョン8以前のアクション定義ファイルの，メッセージ，イベント基本情報，イベント詳細情報，およびイベント拡張情報の項目に，次の文字があった場合，変換して定義します。

表1‒2　文字の変換

変換前の文字

変換後の文字

¥/

/

半角スペース

%20

%

%25

なお，このコマンドは変換前にアクション定義ファイルのフォーマットを自動でチェックします。チェックした結果，エラーが見つかった場合は，標準エラー出力にエラーメッセージが出力され，変換されません。

変換後のアクション定義ファイルの出力先は任意に設定できます。

バージョン8以前のアクション定義ファイルから11-50以降のアクション定義ファイルへは，次のように変換されます。

表1‒3　アクション定義ファイルの変換

バージョン8以前の形式

11-50以降の形式

備考

（DESC_VERSIONなし）

DESC_VERSION=4

−

DESC_VERSION=1

DESC_VERSION=4

−

DESC_VERSION=2

DESC_VERSION=4

−

DESC_VERSION=3

DESC_VERSION=4

−

:state_watch=true

cmn

▲sta△true

end-cmn

−

:state_watch=false

cmn

▲sta△false

end-cmn

−

(:state_watchを指定していない)

cmn

▲sta△false

end-cmn

−

#コメント1

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△コメント1

(省略)

end-act

−

#△コメント1

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△△コメント1

(省略)

end-act

−

#コメント1

#コメント2

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△コメント2

(省略)

end-act

−

パラメーターグループ指定のアクション

act△アクション通し番号

コマンド実行の環境が日本語環境だった場合

act△Action通し番号

コマンド実行の環境が英語環境だった場合

ANDアクションの場合

act

−

+パラメーターグループ番号

▲prm△パラメーターグループ番号

−

&

▲prm△&

−

$イベントID基本部

▲eid△イベントID基本部

−

$イベントID基本部:イベントID拡張部

▲eid△イベントID基本部:イベントID拡張部

−

*

▲eid△*

−

/メッセージ/

▲▲B.MESSAGE△REGEX△メッセージ

−

/イベント基本情報/

▲▲B.BASIC△REGEX△イベント基本情報

−

/イベント詳細情報/

▲▲B.DETAIL△REGEX△イベント詳細情報

−

//

（条件を設定しない）

−

/-------E/

▲▲E.SEVERITY△IN△Emergency

−

/------A-/

▲▲E.SEVERITY△IN△Alert

−

/-----C--/

▲▲E.SEVERITY△IN△Critical

−

/----E---/

▲▲E.SEVERITY△IN△Error

−

/---W----/

▲▲E.SEVERITY△IN△Warning

−

/--N-----/

▲▲E.SEVERITY△IN△Notice

−

/-I------/

▲▲E.SEVERITY△IN△Information

−

/D-------/

▲▲E.SEVERITY△IN△Debug

−

/DINWECAE/

▲▲E.SEVERITY△IN△Emergency△Alert△Critical△Error△Warning△Notice△Information△Debug

複数の重大度の条件を指定する場合

イベント拡張情報属性名=/属性値/

▲▲E.イベント拡張情報属性名△REGEX△属性値

−

u=ユーザー名

▲usr△ユーザー名

−

e=環境変数ファイル名

▲var△環境変数ファイル名

−

d=実行先ホスト名

▲hst△実行先ホスト名

−

d=グループ名

▲hst△グループ名

−

dt=抑止時間

▲det△抑止時間

−

rt=遅延監視時間

▲ret△遅延監視時間

−

+0△*△:アクション

▲cmd△アクション

−

+0△*△:<RULE>

▲rul

JP1/IM - RLを実行する場合

+0△*△:action.exe

act△アクション1

▲prm△0

▲eid△*

▲cnd

▲end-cnd

▲cmd△action.exe

end-act

イベント条件がない場合

+0△*△/メッセージ/ : action.exe

act△アクション1

▲prm△0

▲eid△*

▲cnd

▲▲B.MESSAGE△REGEX△メッセージ

▲end-cnd

▲cmd△action.exe

end-act

イベント条件がある場合

−

aid△アクションID

アクション定義の先頭からアクション実行条件が定義されている順に，アクションIDを0〜2,147,483,647を昇順に設定します。ただし，パラメーターグループに&が指定されているアクション実行条件には採番しません。

−

valid△true

有効パラメーターをtrue（有効）に設定します。ただし，パラメーターグループに&が指定されているアクション実行条件には設定しません。

（凡例）

▲：タブを示す

△：半角スペース

−：なし

形式

jcadefconv -i 変換するアクション定義ファイル名
           -o 変換後のアクション定義ファイル名
          [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-i 変換するアクション定義ファイル名

変換するアクション定義ファイル名を，相対パスまたは絶対パス形式で指定します。アクション定義ファイルのパス名に空白を含む場合は，「"」で囲んで指定します。ファイル名には，255バイトまでの名称を指定できます。

-o 変換後のアクション定義ファイル名

変換するアクション定義ファイル名を，相対パスまたは絶対パス形式で指定します。アクション定義ファイルのパス名に空白を含む場合は，「"」で囲んで指定します。ファイル名には，255バイトまでの名称を指定できます。

ただし，Windowsの場合，次に示す文字列はファイル名には指定できません。

「:」，「?」，「"」，「<」，「>」，「|」の文字。

CON，PRN，AUX，NUL，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9のどれかと完全一致する（小文字も含む）文字列。

変換後のアクション定義ファイル名はユーザー任意に指定できますが，-iオプションに指定したファイルは指定できません。指定した場合，KAVB5502-Eのメッセージが出力されコマンドが終了します。また，-oオプションに指定したファイル名と同名のファイルがすでにある場合，KAVB5504-Eメッセージが出力されてプログラムが終了されます。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストが使用する正規表現を使用して，変換する定義ファイルの内容をチェックします。

このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

-iオプションまたは-oオプションに，JP1/IM - Managerが使用している自動アクション定義を指定する場合は，JP1/IM - Managerを停止してください。

11-50以降の形式に変換した際に，定義不正となる項目があります。定義不正の場合には，KAVB5505-Wメッセージが出力されますので，メッセージに従って，アクション定義ファイルを修正してください。そのあと，jcamakeaコマンドでチェックし，定義ファイルが正しく修正されたことを確認してください。

戻り値

0

正常終了

1

異常終了

2

警告終了

使用例

バージョン8以前の形式で指定されたアクション定義ファイルを11-50以降の形式に変換する場合の例を次に示します。

jcadefconv  -i actdef.conf  -o actdef_new.conf

バージョン8以前の形式で指定されたアクション定義ファイルの記述が次の場合を仮定します。

DESC_VERSION=2
:state_watch=true
#コメント
+0 $0000000A /メッセージ/,/イベント基本情報/,/イベント詳細情報/,/-------E/ ATTR1=/属性値1/ : u=ユーザー名 e=環境変数ファイル名 d=実行先ホスト名 dt=20 rt=30 アクション

jcadefconvコマンドを実行すると，次のように変換されます。

DESC_VERSION=4
cmn
  sta true
end-cmn
act アクション1
  aid アクションID
  valid true
  prm 0
  cmt コメント
  eid A
  cnd
    B.MESSAGE REGEX メッセージ
    B.BASIC REGEX イベント基本情報
    B.DETAIL REGEX イベント詳細情報
    E.SEVERITY IN Emergency
    E.ATTR1 REGEX 属性値1
  end-cnd

  usr ユーザー名
  hst 実行先ホスト名
  cmd アクション
  var 環境変数ファイル名
  det 20
  ret 30
end-act

jcamakea

機能

自動アクション定義ファイルの定義内容をチェックします。複数の自動アクション定義ファイルに定義が分かれている場合は，一つに合わせます。ただし，複数に分かれている自動アクション定義ファイルを一つにする場合，アクション定義ファイルのバージョン，および自動アクション状態監視パラメーターは最初に読み込んだファイルの定義を使用します。

チェック，および併合結果は標準出力に出力されます。出力結果を確認して，自動アクション定義ファイルを作成してください。

チェックした結果，エラーが見つかった場合は，標準エラー出力にエラーメッセージが出力されます。

オプション指定した自動アクション定義ファイル内に記述している自動アクション定義パラメーターのサイズが最大長を超えていた場合，その自動アクション定義パラメーターは標準出力に出力されません。自動アクション定義パラメーターのサイズについては，「自動アクション定義ファイル（actdef.conf）」（2.　定義ファイル）を参照してください。

定義パラメーターがないファイル，またはコメントだけのファイルは，エラーになります。

形式

jcamakea [-h 論理ホスト名] 自動アクション定義ファイル名1 […自動アクション定義ファイル名100]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

変換する定義ファイルの内容のチェックに使用する正規表現のあるホストの論理ホスト名を指定します。指定した論理ホストが使用する正規表現を使用して，定義ファイルの内容をチェックします。また，指定した論理ホストのファイルサイズの設定に従って，自動アクション定義ファイルのファイルサイズが最大値を超えていないかチェックします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

自動アクション定義ファイル名1 […自動アクション定義ファイル名100]

アクションを定義したファイルを，相対パスまたは絶対パス形式で指定します。最大100ファイル指定できます。ファイル名とファイル名の間には空白を挿入します。自動アクション定義ファイルのパス名に空白を含む場合は，「"」で囲んで指定します。

ファイル名には，255バイトまでの名称を指定できます。

戻り値

0

正常終了

3

引数不正

7

フォーマットエラー，または権限がない。

152

システムエラー（UNIXの場合）

153

メモリー不足（UNIXの場合）

154

ファイル入出力エラー（UNIXの場合）

156

論理エラー（UNIXの場合）

255

ファイルオープンエラー（UNIXの場合）

-1

ファイルオープンエラー（Windowsの場合）

-100

論理エラー（Windowsの場合）

-102

ファイル入出力エラー（Windowsの場合）

-103

メモリー不足（Windowsの場合）

-104

システムエラー（Windowsの場合）

08-50以前の形式のアクション定義ファイルを読み込んだ場合の戻り値は，次のとおりです。

0：正常終了

0以外：異常終了

なお，エラーが複数発生した場合，戻り値は，最後に発生したエラーの戻り値となります。

使用例

自動アクション定義ファイル1 /usr/console/action1と自動アクション定義ファイル2 /usr/console/action2を併合して，自動アクション定義ファイル /usr/console/actionx1を作成します。

jcamakea /usr/console/action1 /usr/console/action2 > /usr/console/actionx1

jcashowa

機能

アクション情報ファイルに格納されている，実行した自動アクションの結果を表示します。指定した日時に登録されたイベントに対する自動アクションの実行結果を表示します。

形式

jcashowa [-d {[MM/dd/hh:mm][, [MM/dd/hh:mm]]}]
         [-h 論理ホスト名]
         [アクション情報ファイル名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-d {[MM/dd/hh:mm][, [MM/dd/hh:mm]]}

アクション情報ファイルに格納されている，アクションの対象となったイベントのイベント登録時刻を指定します。範囲を指定する場合は，指定する日時の始点と終点を「,」で区切って指定します。指定した範囲のイベント登録時刻となっているイベントに対するアクション情報を表示します。

このオプションを省略した場合は，アクション情報ファイルに格納されているすべてのアクション情報を表示します。

日時指定（MM/dd/hh:mm）について

日時指定は，次の表に示す形式で指定できます。運用に合わせて使い分けてください。

表1‒4　日時指定形式

日時指定パターン

説明

MM/dd/hh:mm

MMには月，ddには日，hhには時，mmには分を指定します。

MM/dd/hh

MMには月，ddには日，hhには時を指定します。

省略したmmは00を指定したと仮定されます。

MM/dd

MMには月，ddには日を指定します。

省略したhhは00，mmは00を指定したと仮定されます。

dd

ddには日を指定します。

省略したMMはjcashowaコマンドを実行した月，hhは00，mmは00を指定したと仮定されます。

dd/hh:mm

ddには日，hhには時，mmには分を指定します。

省略したMMはjcashowaコマンドを実行した月を指定したと仮定されます。

hh:mm

hhには時，mmには分を指定します。

省略したMMはjcashowaコマンドを実行した月，ddはjcashowaコマンドを実行した日を指定したと仮定されます。

日時の範囲指定（[MM/dd/hh:mm][, [MM/dd/hh:mm]]）について

日時の範囲指定は，次の表に示す形式で指定できます。運用に合わせて使い分けてください。

表1‒5　日時の範囲指定形式

範囲指定パターン

説明

-d 日時

「日時」を指定すると，特定の日時に登録されたイベントに対して実行されたアクションの，アクション結果を表示できます。

例えば10月24日22時に登録されたイベントに対して実行されたアクションの，アクション結果を表示したい場合は次のように指定します。

jcashowa -d 10/24/22:00

-d 日時,日時

「日時,日時」を指定すると，ある日時からある日時までの範囲で登録されたイベントに対して実行されたアクションの，アクション結果をすべて表示できます。

例えば10月24日22時から11月24日10時までに登録されたイベントに対して実行されたアクションの，アクション結果を表示したい場合は次のように指定します。

jcashowa -d 10/24/22:00,11/24/10:00

-d 日時,

「日時,」を指定すると，ある日時以降に登録されたイベントに対して実行されたアクションの，アクション結果をすべて表示できます。

例えば10月24日22時以降に登録されたイベントに対して実行されたアクションの，アクション結果を表示したい場合は次のように指定します。

jcashowa -d 10/24/22:00,

-d ,日時

「,日時」を指定すると，ある日時以前に登録されたイベントに対して実行されたアクションの，アクション結果をすべて表示できます。

例えば11月24日10時以前に登録されたイベントに対して実行されたアクションの，アクション結果を表示したい場合は次のように指定します。

jcashowa -d ,11/24/10:00

指定年の仮定について

jcashowaコマンドを実行した月より，始点に指定した月の方が大きい場合，始点に指定した日時を前年と見なして「前年の始点日時から本年の終点日時まで」と判断します。

始点に指定した月がjcashowaコマンドを実行した月より大きい場合

12月 ≧ 始点指定月 ＞ jcashowaコマンド実行月

始点指定日時の年度はjcashowaコマンドを実行した年の1年前の日時と見なします。

始点に指定した月がjcashowaコマンドを実行した月より小さい場合

jcashowaコマンド実行月 ≧ 始点指定月 ≧ 01月

始点指定日時の年度はjcashowaコマンドを実行した年の日時と見なします。

(例1) 2003/10/31に次のようにjcashowaコマンドを実行した場合

# jcashowa -d 11/01/0:00,10/01/23:59

2002/11/01 0:00 〜 2003/10/01 23:59 の範囲として正常に処理されます。

(例2) 2003/11/01に次のようにjcashowaコマンドを実行した場合

# jcashowa -d 11/01/0:00,10/01/23:59

2003/11/01 0:00 〜 2003/10/01 23:59 の範囲を指定したと見なし，日時の指定範囲が昇順となっていないため，KAVB4009-Wのメッセージが表示されます。

-dオプションは，指定する日時の大小関係を判断します。始点に指定した日時と終点に指定した日時が，昇順となっていない場合はエラーとなります。

秒単位の指定について

秒については，始点に指定した場合は00秒，終点に指定した場合は59秒として扱います。

(例1) 次のようにjcashowaコマンドを実行した場合

# jcashowa -d 10/24/22:00

10月24日 22時00分00秒〜10月24日 22時00分59秒までのアクション結果を表示します。

(例2) 次のようにjcashowaコマンドを実行した場合

# jcashowa -d 10/24/22:00,11/24/10:00

10月24日 22時00分00秒〜11月24日 10時00分59秒までのアクション結果を表示します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応するアクションの実行結果が表示されます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

アクション情報ファイル名

アクション情報ファイルをフルパスで指定します。

物理ホストのアクション情報ファイルを指定する場合は，-hオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

論理ホストのアクション情報ファイルを指定する場合は，-hオプションまたは環境変数JP1_HOSTNAMEに論理ホスト名を指定してください。

アクション情報ファイル名には，255バイトまでのファイル名が指定できます。

アクション情報ファイルは，実行したアクションに関する情報を格納するファイルです。

なお，このオプションは，指定したいほかのオプションをすべて指定したあとに指定してください。

戻り値

0

正常終了

3

引数エラー

6

システムエラー

7

コマンドを実行する権限がない（Windowsの場合）

出力形式

jcashowaコマンドを実行すると，自動アクション情報は次の形式で出力されます。

イベント情報※1　 イベントID△イベントDB内通し番号△イベント登録時刻△イベント到着時刻

アクション情報※2 アクション通し番号△アクション種別△状態△遅延状態△PID△実行先ホスト名

アクション情報 アクション投入時刻△アクション開始時刻△アクション終了時刻△終了コード

コマンド　　　 コマンド

メッセージ　　 メッセージ

注※1

自動アクションの設定でAND条件を指定している場合には，実行条件に設定しているイベントのうち，最後に受信したイベントのイベント情報だけ出力されます。

注※2

アクションに遅延監視設定をしていない，またはアクションが遅延していない場合は，次のように出力されます。

アクション情報 アクション通し番号△アクション種別△状態△PID△実行先ホスト名

出力される各項目を次に説明します。

表1‒6　自動アクション情報の出力項目

項目

説明

イベントID

イベントIDが「基本コード:拡張コード」の形式で表示される。

イベントDB内通し番号

イベントのイベントDB内通し番号が表示される。

イベント登録時刻

イベントの登録時刻が「月/日 時:分:秒」の形式で表示される。

イベント到着時刻

イベントの到着時刻が「月/日 時:分:秒」の形式で表示される。

アクション通し番号

実行するアクションのアクション通し番号。

アクション種別

アクションの種別が次のどれかで表示される。

Command（コマンド）

Rule（JP1/IM - Rule Operationへのルール起動要求）

状態

状態アクションの実行状態を表す次の文字列のどれか。

running（実行中）

ended（終了）

none（なし）

fail（実行不可：JP1/Baseに実行要求を渡す前のエラー）

error（実行失敗：JP1/Baseのコマンド制御内でのエラー）

unknown（状態不明：コマンドの実行結果が不明）

wait（送信待機：先行コマンドの終了待ち）

send（送信中：コマンドの送信中）

queue（キューイング：JP1/Base内でのコマンド実行待ち）

cancel（キャンセル）

kill（強制終了）

deterrent（抑止）

アクションをJP1/IM - Viewまたはjcacancelコマンドからキャンセルした場合，上記の状態の後ろにキャンセル状態が表示される。

アクションのキャンセル状態を次に示す。

canceling（キャンセル中）例：queue（canceling）

miss（キャンセル失敗）例：ended（miss）

アクション実行サービスの再起動時にコマンドが再実行，またはアクション再実行用ファイルに出力された場合は，状態の後ろに「-R」が付く（例：ended-R）。

JP1/IM - Viewから再実行をした場合は，上記の状態の後ろに「-RU」が付く（例：ended-RU）。

抑止されたアクションをJP1/IM - Viewから再実行した場合は，上記状態の後ろに「-RUD」が付く（例：ended-RUD）。

抑止されたアクションをJP1/IM - Viewから再実行し，かつ，再実行中にアクション実行サービスの再起動（系切り替え含む）の発生によって再実行，またはアクション再実行用ファイルに出力された場合は，状態の後ろに「-RD」が付く（例：ended-RD）。

抑止されたアクションでアクションの状態が「fail」(実行不可)の場合は「fail」の状態の後ろに「-D」が付く（例：fail-D）。

遅延状態

アクションの遅延状態を表す。

アクションが遅延している場合は，delay（遅延）と表示される。

アクションが遅延していない場合は，何も表示されない。

PID

実行したアクションのプロセスID。

系切り替えが発生して，アクション再実行用ファイルにアクションの情報が記述された場合は，「OUTPUT」と表示される。

実行先ホスト名

アクションを実行したホストのホスト名。

アクション投入時刻

実行するアクションの投入時刻が「月/日 時:分:秒」の形式で表示される。

アクションが投入されていない場合は「**/** **:**:**」と表示される。

アクション開始時刻

実行するアクションの開始時刻が「月/日 時:分:秒」の形式で表示される。

アクションが開始されていない場合は「**/** **:**:**」と表示される。

アクション終了時刻

実行したアクションの終了時刻を「月/日 時:分:秒」の形式で表示する。

アクションが終了していない場合は，「**/** **:**:**」と表示される。

終了コード

実行したアクションの終了コード。

アクションが終了していない場合は，「***」と表示される。

コマンド

アクションとして実行したコマンド。

メッセージ

コマンドが出力したメッセージ。

出力例

（例1）

コマンドが異常終了し，メッセージが出力された場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   23000 Command ended 27934 raysol
アクション情報   12/03 12:09:15 12/03 12:09:16 12/03 12:09:17 1
コマンド　　　   /usr/local/action
メッセージ　　   abcがみつかりません。

（例2）

コマンドが実行中で，メッセージが出力されていない場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   23000 Command running 27934 raysol
アクション情報   12/03 12:09:15 12/03 12:09:16 **/** **:**:** ***
コマンド　　　   /usr/local/executing

（例3）

コマンドの状態が実行中，キャンセル状態がキャンセル中で，メッセージが出力されていない場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   10 Command running(canceling) 15236 raysol
アクション情報   12/03 12:09:15 12/03 12:09:16 **/** **:**:** ***
コマンド　　　   /usr/local/action

（例4）

結果が複数ある場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   380 Command ended 233 raysol
アクション情報   12/03 12:09:13 12/03 12:09:14 12/03 12:09:14 20
コマンド　　　   /usr/local/action
イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   381 Command ended 279 raysol
アクション情報   12/05 10:39:20 12/05 10:39:21 12/05 10:39:23 128
コマンド　　　   /usr/local/action2
メッセージ　　   権限がありません
スーパーユーザで実行してください
処理を打ち切ります

（例5）

パラメーターグループ指定のため，一つのイベントに対し複数のアクションがある場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   987 Command running 2904 raysol
アクション情報   12/05 10:39:20 12/05 10:39:21 12/03 12:09:13 0
コマンド　　　   /usr/local/first
イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   988 Command ended 2906 raysol
アクション情報   12/05 10:39:20 12/05 10:39:21 12/06 21:02:54 0
コマンド　　　   /usr/local/second

（例6）

系切り替えが発生したため，アクションの情報がアクション再実行用ファイルに記述された場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   45687 Command ended-R OUTPUT
アクション情報   **/** **:**:** *** **/** **:**:** *** **/** **:**:** ***

（例7）

実行中のアクションが遅延している場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   987 Command running delay 2904 raysol
アクション情報   12/05 10:39:20 12/05 10:39:21 **/** **:**:** ***
コマンド　　　   /usr/local/executing

（例8）

引数なしでコマンドを実行した場合（JP1/IM - Rule Operation連携機能が有効）

イベント情報　  00000111:00000000 628 03/13 16:18:24 03/13 16:18:24
アクション情報  523 Rule ended 3016 raysol
アクション情報  03/13 16:18:24 03/13 16:18:24  03/13 16:18:28 0
コマンド　　　  jrmexecrule -c raysol -s 628 -t 1142234304
メッセージ　　  KAJX4101-I ルールの起動に成功しました
起動ルール一覧
RuleOperation/rule005
イベント情報　  00000111:00000000 628 03/13 16:18:24 03/13 16:18:24
アクション情報  524 Command ended 3156 raysol
アクション情報  03/13 16:18:24 03/13 16:18:28  03/13 16:18:28 0
コマンド　　　  hostname
メッセージ　　  raysol

jcastatus

機能

稼働している自動アクション機能の動作状態（停止，稼働，休止），または稼働している自動アクション機能が読み込んでいる自動アクション定義ファイルの内容を標準出力に表示します。

なお，このコマンドは同時に複数起動できます。

形式

jcastatus [-h 論理ホスト名]
          [-d]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応する自動アクション機能（イベント基盤サービス）の動作状態が表示されます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-d

稼働している自動アクション機能が読み込んでいる自動アクション定義ファイルの内容を標準出力に表示します。自動アクション定義ファイルと同じフォーマットで表示されます。

自動アクション定義がすべて無効の状態でも，稼働している自動アクション機能が読み込んでいる自動アクション定義ファイルの内容を標準出力に表示します。

戻り値

0

正常終了

4

自動アクション機能（イベント基盤サービス）からの応答がない

5

自動アクション機能（イベント基盤サービス）が停止または休止中のため，自動アクション定義ファイルの内容が表示できない

6

システムエラー（コマンド側）

152

システムエラー（イベント基盤サービス側）（UNIXの場合）

154

入出力エラー（UNIXの場合）

243

引数指定値不正（UNIXの場合）

-13

引数指定値不正（Windowsの場合）

-102

入出力エラー（Windowsの場合）

-104

システムエラー（イベント基盤サービス側）（Windowsの場合）

出力形式

jcastatusコマンドを実行すると，自動アクション機能の動作状態は次の形式で出力されます。

Status : 状態

「状態」に表示される文字列について次に説明します。

表1‒7　自動アクション機能の動作状態

「状態」に表示される文字列

動作状態

説明

STOP

停止

自動アクション機能（イベント基盤サービス）が停止している状態。

RUNNING

稼働

自動アクション機能（イベント基盤サービス）が起動していて，自動アクション機能が使用できる状態。

STANDBY

休止

イベント基盤サービスは起動しているが，自動アクション機能は休止している状態。

休止状態の間は，イベントは受信されるが，受信されたイベントに対してアクション処理は行われない。

休止状態から稼働状態になった場合は，休止中に受信されたイベントに対してアクション処理は行われない。

出力例

自動アクション機能の動作状態が休止状態であった場合

Status : STANDBY

jcfaleltdef（Windows限定）

機能

指定した監視対象ホストに，リモート監視イベントログトラップのプロファイルを定義します。指定した監視対象ホストのプロファイルが稼働中か停止中かに関係なく，定義を上書きします。

一括リロードをする場合は，jcfaleltdefコマンドで複数の稼働中のリモート監視イベントログトラップを上書きしたあと，jcfaleltreloadコマンドで複数のプロファイルを一括でリロードします。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

形式

jcfaleltdef -f リモート監視イベントログトラップ動作定義ファイル名
            -o 監視対象ホスト名
            [-filter フィルター]
            [-h 論理ホスト名]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-f リモート監視イベントログトラップ動作定義ファイル名

動作定義ファイルの名称を指定します。

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

-o 監視対象ホスト名

プロファイルを定義したいリモート監視イベントログトラップのプロファイル監視対象ホスト名を指定します。なお，監視対象ホストのOSは，Windowsだけです。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したイベントログをフィルタリングする場合に，フィルターをログの種類で指定します。

このオプションを指定すると，指定したログの種類と一致したイベントログだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

ログの種類は，次の表に示す文字列で指定します。なお，文字列の大文字・小文字は区別しません。

指定できるログ種別

フィルタリングするイベントのログの種類

Error

エラー，Error，重大，Critical

Warning

警告，Warning

Information

情報，Information，詳細，Verbose

Audit_success

成功の監査，Security Audit Success

Audit_failure

失敗の監査，Security Audit Failure

複数のログの種類を指定する場合は，「,」で区切って指定します。「,」の前後に空白は入れないでください。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

追加成功

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

14

DB不正

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1にプロファイルを追加する場合

jcfaleltdef -f actionDefinition.conf -o host1

使用例2

host1にプロファイルを追加する場合で，エラー，警告，および失敗の監査のイベントログだけをフィルタリングしたいとき

jcfaleltdef -f actionDefinition.conf -o host1 -filter Error,Warning,Audit_failure

jcfaleltreload（Windows限定）

機能

リモート監視イベントログトラップをリロードします。また，コマンド実行時にトラップ処理をしていた場合，そのトラップ処理の完了後，リロード処理をします。jcfaleltdefコマンドまたは［プロファイル表示/編集］画面で，起動オプションを変更した場合は，リロードしても反映されません。再起動して反映してください。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

DCOMの設定をしている

リモート監視イベントログトラップが起動中である

形式

jcfaleltreload {-o 監視対象ホスト名 | ALL}
               [-h 論理ホスト名]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-o 監視対象ホスト名

リロードしたいリモート監視イベントログトラップの監視対象ホスト名を指定します。監視対象ホストのOSはWindowsに限ります。

ALL

すべてのリモート監視イベントログトラップを対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

リロード成功

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

11

動作定義ファイル不正

12

認証定義ファイル不正

13

通信エラー

14

DB不正

15

指定したリモート監視イベントログトラップは停止済み

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

host1のリモート監視イベントログトラップをリロードする場合

jcfaleltreload -o host1

jcfaleltstart（Windows限定）

機能

リモート監視イベントログトラップを起動します。

このコマンドを実行すると，オプションに指定した監視対象ホストのイベントログファイルを収集し，リモート監視イベントログトラップ動作定義ファイルで指定した条件に合うログの1行をJP1イベント化して，イベントサーバに登録します。

-fオプションを指定する場合，コマンドの実行前に，リモート監視イベントログトラップ動作定義ファイルを作成しておく必要があります。また，-fオプションを指定して実行した場合，プロファイルが停止中であれば，既存のリモート監視イベントログトラップ動作定義ファイルを上書きしたあと，リモート監視イベントログトラップのプロファイルのプロセスを起動します。プロファイルが稼働中であれば，既存のリモート監視イベントログトラップ動作定義ファイルを上書きし，サーバに保存したあとにエラーメッセージを出力します。このとき，プロファイルは上書きされる前の動作定義で稼働しています。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

DCOMの設定をしている

形式

jcfaleltstart
        -o 監視対象ホスト名
        [-h 論理ホスト名]
        [-f リモート監視イベントログトラップ動作定義ファイル名
        [-filter フィルター]]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-o 監視対象ホスト名

起動したいリモート監視イベントログトラップの監視対象ホスト名を指定します。監視対象ホストのOSはWindowsに限ります。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-f リモート監視イベントログトラップ動作定義ファイル名

動作定義ファイルの名称を指定します。-fオプションを指定した場合，既存のリモート監視イベントログトラップ動作定義ファイルを上書きして起動します。また，-fオプションを指定しない場合は，既存のリモート監視イベントログトラップを起動します。

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したイベントログをフィルタリングする場合に，フィルターをログの種類で指定します。-fオプションを指定したときだけ指定できます。

このオプションを指定すると，指定したログの種類と一致したイベントログだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

ログの種類は，次の表に示す文字列で指定します。なお，文字列の大文字・小文字は区別しません。

指定できるログ種別

フィルタリングするイベントのログの種類

Error

エラー，Error，重大，Critical

Warning

警告，Warning

Information

情報，Information，詳細，Verbose

Audit_success

成功の監査，Security Audit Success

Audit_failure

失敗の監査，Security Audit Failure

複数のログの種類を指定する場合は，「,」で区切って指定します。「,」の前後に空白は入れないでください。

戻り値

0

起動成功

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

8

すでに稼働済み

9

プロファイルの各種制限値を超過

10

排他編集権取得エラー

11

動作定義ファイル不正

12

認証情報定義ファイル不正

13

通信エラー

14

DB不正

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1のリモート監視イベントログトラップを起動する場合

jcfaleltstart -o host1 -f actionDefinition.conf

使用例2

host1のリモート監視イベントログトラップを起動する場合で，エラー，警告，および失敗の監査のイベントログだけをフィルタリングしたいとき

jcfaleltstart -o host1 -f actionDefinition.conf -filter Error,Warning,Audit_failure

jcfaleltstat（Windows限定）

機能

リモート監視イベントログトラップの動作状況を表示します。

このコマンドを実行すると，引数に指定した監視対象ホストを監視対象とするリモート監視イベントログトラップの動作状況を返します。

-oオプションでALLを指定していてリモート監視構成にホストが存在しない，またはWindowsではない場合は，そのことを示すメッセージが表示されます。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

形式

jcfaleltstat {-o 監視対象ホスト名 | ALL}
             [-h 論理ホスト名]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

表示形式

jcfaleltstatコマンドを実行すると，次の形式で出力結果が表示されます。

注

この例では，説明のために行頭に行番号を入れて示しています。

1　Message ID△メッセージ

2　Message ID△メッセージ

3　ホスト名△状態

4　ホスト名△状態

5　ホスト名△状態

6　　　　　：

1行目

コマンド実行が開始したことを示すメッセージを表示します。

2行目

次の表示範囲を示すメッセージを表示します。

すべて

指定したホスト

指定したホストの指定したイベントログトラップ

3〜6行目

指定した範囲内のリモートの監視対象ホスト（Windows）のイベントログトラップに関する状態を表示します。表示する状態は，次のとおりです。

START：イベントログトラップが起動中の状態

STOP：イベントログトラップが停止中の状態

EDIT：イベントログトラップの動作定義ファイルが編集されているが，反映していない状態

FAIL：次の理由によってイベントログトラップの状態の取得に失敗した状態

・ホスト不正（ホスト情報未収集，または収集失敗状態となっている）

・WMI通信でエラーが発生した

・認証エラー

・I/Oエラー

・排他権取得エラー

・内部エラー

引数

-o 監視対象ホスト名

動作状況を確認したいリモート監視イベントログトラップの監視対象ホスト名を指定します。監視対象ホストのOSはWindowsに限ります。

ALL

すべてのリモート監視イベントログトラップを対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

リモート監視イベントログトラップがすべて稼働している

1

リモート監視イベントログトラップが一部稼働している（ALLオプションを指定したとき）

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

14

DB不正

17

権限が不正

18

I/Oエラー

19

リモート監視イベントログトラップがすべて停止している

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

host1のリモート監視イベントログトラップの動作状況を表示する場合

jcfaleltstat -o host1

jcfaleltstop（Windows限定）

機能

リモート監視イベントログトラップを停止します。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

DCOMの設定をしている

リモート監視ログファイルトラップが起動中である

形式

jcfaleltstop {-o 監視対象ホスト名 | ALL}
             [-h 論理ホスト名]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-o 監視対象ホスト名

停止したいリモート監視イベントログトラップの監視対象ホスト名を指定します。監視対象ホストのOSはWindowsに限ります。

ALL

すべてのリモート監視イベントログトラップを対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

停止成功

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

12

認証定義ファイル不正

13

通信エラー

14

DB不正

15

指定したリモート監視イベントログトラップは停止済み

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

すべてのリモート監視イベントログトラップを停止する場合

jcfaleltstop ALL

jcfallogdef

機能

指定した監視対象ホストに，リモート監視ログファイルトラップのプロファイルを追加または削除します。-fオプションを指定した場合はプロファイルを追加し，-dオプションを指定した場合はプロファイルを削除します。

プロファイルを追加するときに，指定した監視対象ホストに同じ監視名のプロファイルがすでにある場合は，そのプロファイルが稼働中か停止中かに関係なく，動作定義ファイルを上書きします。

プロファイルを削除するときは，指定したプロファイルが停止中のときだけ，このコマンドを実行できます。

一括リロードをする場合は，jcfallogdefコマンドで複数の稼働中のリモート監視ログファイルトラップを上書きしたあと，jcfallogreloadコマンドで複数のプロファイルを一括でリロードします。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

形式

jcfallogdef
        -a 監視名
        -o 監視対象ホスト名
        [-h 論理ホスト名]
        {-f リモート監視ログファイルトラップ動作定義ファイル名
            -c 文字コード
            [-filter フィルター]
            [-m イベント化するデータの最大長（バイト）]
            [-p ログデータ出力元プログラム名]
            [-r]
            [-t ファイル監視間隔（秒）]
            ログファイル名1 […ログファイル名32] |
         -d}
        [-q]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-a 監視名

リモート監視ログファイルトラップを識別する監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

なお，監視名と監視対象ホストの組は一意である必要があり，jcfallogstartで指定したほかの監視名と監視対象の組との重複はできません。ただし，JP1/Baseのjevlogstartで指定される監視名との重複はできます。

-o 監視対象ホスト名

プロファイルを追加または削除したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-f リモート監視ログファイルトラップ動作定義ファイル名

動作定義ファイルの名称を指定します。

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

-c 文字コード

ログファイルの文字コードを指定します。-fオプションを指定したときだけ指定できます。

指定できる文字コードは次のとおりです。

表1‒8　文字コード

監視対象OS

日本語の場合

英語の場合

中国語の場合

AIX

SJIS

SJISを指定した場合，SJIS/Ja_JPが設定されます。

SJIS/Ja_JP

SJIS/Ja_JP.IBM-932

EUC

EUCを指定した場合，EUC/ja_JPが設定されます。

EUC/ja_JP

EUC/ja_JP.IBM-eucJP

UTF-8

UTF-8を指定した場合，UTF-8/JA_JPが設定されます。

UTF-8/JA_JP

UTF-8/JA_JP.UTF-8

C

C

GB18030

GB18030を指定した場合，GB18030/Zh_CN.GB18030が設定されます。

GB18030/Zh_CN.GB18030

GB18030/Zh_CN

UTF-8

UTF-8を指定した場合，UTF-8/ZH_CNが設定されます。

UTF-8/ZH_CN

UTF-8/ZH_CN.UTF-8

C

HP-UX

SJIS

SJISを指定した場合，SJIS/ja_JP.SJISが設定されます。

SJIS/ja_JP.SJIS

SJIS/japanese

EUC

EUCを指定した場合，EUC/ja_JP.eucJPが設定されます。

EUC/ja_JP.eucJP

EUC/japanese.euc

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.utf8が設定されます。

UTF-8/ja_JP.utf8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。

GB18030/zh_CN.gb18030

UTF-8

UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。

UTF-8/zh_CN.utf8

C

Linux

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。

UTF-8/ja_JP.UTF-8

UTF-8/ja_JP.utf8

SJIS※1

SJISを指定した場合，SJIS/ja_JP.sjisが設定されます。

SJIS/ja_JP.sjis※1

SJIS/ja_JP.SJIS※1

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。

GB18030/zh_CN.gb18030

UTF-8

UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。

UTF-8/zh_CN.utf8

C

Solaris

EUC

EUCを指定した場合，EUC/jaが設定されます。

EUC/ja

EUC/japanese

EUC/ja_JP.eucJP

SJIS

SJISを指定した場合，SJIS/ja_JP.PCKが設定されます。

SJIS/ja_JP.PCK

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。

UTF-8/ja_JP.UTF-8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.GB18030が設定されます。

GB18030/zh_CN.GB18030

GB18030/zh_CN.GB18030@pinyin

GB18030/zh_CN.GB18030@radical

GB18030/zh_CN.GB18030@stroke

UTF-8

UTF-8を指定した場合，UTF-8/zh.UTF-8が設定されます。

UTF-8/zh.UTF-8

UTF-8/zh_CN.UTF-8

UTF-8/zh_CN.UTF-8@pinyin

UTF-8/zh_CN.UTF-8@radical

UTF-8/zh_CN.UTF-8@stroke

C

Windows

SJIS

SJIS※2

C

GB18030

注※1

監視対象OSがSUSE Linuxの場合だけ有効です。

注※2

英語OSの場合，文字コードにSJISを指定してもCで動作します。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したログファイルをフィルタリングする場合に，フィルターを正規表現で指定します。

このオプションを指定すると，指定した正規表現と一致したログデータだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

このオプションは，-fオプションを指定したときだけ指定できます。

このオプションは，リモートの監視対象ホストがUNIXの場合だけ有効です。前提条件として，SSH接続でgrepコマンドが実行できる必要があります。リモートの監視対象ホストがWindowsの場合は，このオプションを指定しても無視されます。

指定できる正規表現の形式は，リモートの監視対象ホストのgrepコマンドの-Eオプションに指定できる拡張正規表現の形式と同一です。環境変数は使用できません。

正規表現は128バイト以内の文字列で指定します。使用できる文字列は，「'」，「"」，「<」，「>」，および制御文字を除く半角英数字，半角スペース，記号です。文字列に半角スペースが含まれている場合は，前後をダブルクォーテーション「"」で囲む必要があります。

grepコマンドのパス例を次に示します。詳細は，各OSのgrepコマンドのマニュアルを参照してください。

Linuxの場合：/bin/grep

Solarisの場合：/usr/xpg4/bin/grep

Linux，Solaris以外の場合：/usr/bin/grep

-m イベント化するデータの最大長（バイト）

ログファイルの1行を，先頭から何バイト読み込むかを指定します。指定できるバイト数は1〜1,024です。このオプションを省略した場合は512が設定されます。

行の終了文字は終了記号「¥0」に変更されます。ログファイルの1行がこのオプションで指定されたバイト数を超える場合，最後の1バイトが「¥0」に変更されます。

このオプションで指定した値は，入力したログファイルの1行の有効範囲を示します。したがって，リモート監視ログファイルトラップ動作定義ファイルのMARKSTRパラメーターの正規表現とACTDEFパラメーターの正規表現をチェックするのは，ここで指定した範囲内です。つまり，有効範囲を超えたカラムに対応する正規表現があっても，それらはチェックの対象にはなりません。

-p ログデータ出力元プログラム名

ログデータを出力するプログラム名を指定します。指定した名前はJP1/IM - Viewの［イベントコンソール］画面に表示されます。

表示される名称は次のとおりです。

Windowsの場合

/HITACHI/JP1/NT_LOGTRAP/ログデータ出力元プログラム名

UNIXの場合

/HITACHI/JP1/UX_LOGTRAP/ログデータ出力元プログラム名

このオプションを省略すると，Windowsの場合は「/HITACHI/JP1/NT_LOGTRAP」，UNIXの場合は「/HITACHI/JP1/UX_LOGTRAP」と表示されます。

-r

このオプションを指定すると，次の場合に，ログが収集できるようになるまで，-tオプションで指定した間隔で収集を試みます。

リモート監視ログファイルトラップの起動時に，リモートの監視対象ホストにアクセスできない場合

リモート監視ログファイルトラップの稼働中に，リモートの監視対象ホストにアクセスできなくなった場合

リモート監視ログファイルトラップの起動時に，監視対象のログファイルにアクセスできない場合

リモート監視ログファイルトラップの稼働中に，監視対象のログファイルにアクセスできなくなった場合

-rオプションは，次の場合に指定してください。

リモート監視ログファイルトラップの起動後に，リモートの監視対象ホストにアクセスできるようになる場合

リモート監視ログファイルトラップの起動後に，監視対象のログファイルが作成される場合

リモートの監視対象ホストにアクセスできなくでも監視を継続したい場合

このオプションを省略した場合，次の動作となります。

リモート監視ログファイルトラップを起動した時点で，監視対象のログファイルの収集ができない場合，起動を中止し処理を終了します。

稼働中に監視対象のログファイルの収集ができなくなった場合，リモート監視ログファイルトラップ動作定義ファイルに指定したリトライ回数および間隔でリトライします。

-t ファイル監視間隔（秒）

ファイルの監視間隔を指定します。指定できる値は60〜86,400（単位：秒）です。省略した場合は300が設定されます。

WRAP2形式のログファイルを監視する場合

ラップアラウンドする頻度が高い場合や監視間隔を長く指定した場合に，リモート監視ログファイルトラップがデータを読み込む前に上書きされてしまい，データの読み込み漏れが発生するおそれがあります。データの読み込み漏れの予防策として，次の監視間隔の見積もり式を参考にしてください。

ログファイルサイズ（バイト）×ログファイル数>1秒当たりの出力サイズ（バイト）×監視間隔（秒）

ログファイル名1 […ログファイル名32]

監視するログファイル名を指定します。ログファイル名は256バイト以内の文字列で指定します。監視対象ホストがWindowsの場合は，ホスト名を除いたネットワークパス名で指定します。UNIXの場合はフルパスで指定します。なお，ワイルドカードを使用して，監視するログファイルを指定することはできません。

監視対象ホストがUNIXの場合，監視対象ファイルパスに半角英数字および「-」，「_」，「.」，「/」を含むログファイルを監視できます。それ以外の文字を含むファイルパスについては，正常に監視できないときがあります。

指定できるファイル数は32以下で，指定できるファイル形式は次の形式です。

シーケンシャルファイル(SEQ)

シーケンシャルファイル(SEQ2)

ラップアラウンドファイル(WRAP2)

-d

リモート監視ログファイルトラップのプロファイルを削除します。

リモート監視ログファイルトラップをプロファイルツリーから削除することになるため，問題ないかを確認するためのメッセージが表示されます。

-q

このオプションを指定すると，-dオプション指定時でも確認メッセージが表示されません。-dオプションを指定していない場合は，指定しても無視されます。

戻り値

0

追加成功/削除成功

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

8

指定した監視名は稼働済み（-dオプション指定時）

9

プロファイルの各種制限値を超過

10

排他編集権取得エラー

14

DB不正

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1にプロファイルを追加する場合

jcfallogdef -a name1 -o host1 -f actionDefinition.conf -c SJIS -filter ".*-E" /log/sample.log

使用例2

host1のプロファイルを削除する場合

jcfallogdef -a name1 -o host1 -d -q

jcfallogreload

機能

リモート監視ログファイルトラップ動作定義ファイルをリロードします。

リロードできる定義情報は，動作定義ファイルのMARKSTRおよびACTDEFパラメーターの値だけです。jcfallogdefコマンドまたは［プロファイル表示/編集］画面で，MARKSTRおよびACTDEFパラメーター以外の値を変更した場合は，リロードしても反映されません。再起動して反映してください。また，リロードコマンドの実行がトラップ処理と重なった場合，そのトラップ処理にリロードする内容が反映されます。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

SSHで通信する場合，対象のリモートの監視対象ホストと公開鍵暗号方式でSSH認証できる

NetBIOS（NetBIOS over TCP/IP）で通信する場合，監視するログファイルが共有されている

リモート監視ログファイルトラップが起動中である

形式

jcfallogreload {-o 監視対象ホスト名 [-a 監視名] | ALL}
               [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-o 監視対象ホスト名

リロードしたいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-a 監視名

リロードしたいリモート監視ログファイルトラップの監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

ALL

すべてのリモート監視ログファイルトラップを対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

リロード成功

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

11

動作定義ファイル不正

12

認証情報定義ファイル不正

13

通信エラー

14

DB不正

15

指定したリモート監視ログファイルトラップは停止済み

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

host1のname1のリモート監視ログファイルトラップをリロードする場合

jcfallogreload -o host1 -a name1

jcfallogstart

機能

リモート監視ログファイルトラップを起動します。

このコマンドを実行すると，監視対象ホストのログファイルを収集し，リモート監視ログファイルトラップ動作定義ファイルで指定した条件に合うログの1行をJP1イベント化して，イベントサーバに登録します。

-fオプションを指定した場合，新規にリモート監視ログファイルトラップのプロファイルを追加したあと，プロセスを起動します。指定した監視対象ホストに同じ監視名のプロファイルがすでに存在する場合，プロファイルが停止中であれば，リモート監視ログファイルトラップ動作定義ファイルを上書きしたあと，リモート監視ログファイルトラップのプロセスを起動します。プロファイルが稼働中だった場合，動作定義ファイルを上書きして，サーバに保存したあとにエラーメッセージが出力され，処理を中断します。このとき，プロファイルは上書きされる前の動作定義で稼働しています。-fオプションを指定しない場合，既存のリモート監視ログファイルトラップのプロファイルのプロセスを起動します。

データの形式が異なるログファイルは同時に扱えません。この場合は，新たに別のリモート監視ログファイルトラップを起動してください。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

SSHで通信する場合，対象のリモートの監視対象ホストと公開鍵暗号方式でSSH認証できる

NetBIOS（NetBIOS over TCP/IP）で通信する場合，監視するログファイルが共有されている

形式

jcfallogstart
        -a 監視名
        -o 監視対象ホスト名
        [-h 論理ホスト名]
        [-f リモート監視ログファイルトラップ動作定義ファイル名
          -c 文字コード
          [-filter フィルター]
          [-m イベント化するデータの最大長（バイト）]
          [-p ログデータ出力元プログラム名]
          [-r]
          [-t ファイル監視間隔（秒）]
          ログファイル名1 […ログファイル名32]]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-a 監視名

リモート監視ログファイルトラップを識別する監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

なお，監視名と監視対象ホストの組は一意である必要があり，jcfallogstartで指定したほかの監視名と監視対象の組との重複はできません。ただし，JP1/Baseのjevlogstartで指定される監視名との重複はできます。

-o 監視対象ホスト名

起動したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-f リモート監視ログファイルトラップ動作定義ファイル名

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

このオプションを指定した場合，新規にリモート監視ログファイルトラップを作成して起動します。このオプションを省略した場合は，既存のリモート監視ログファイルトラップを起動します。

-c 文字コード

ログファイルの文字コードを指定します。-fオプションを指定したときだけ指定できます。

指定できる文字コードは次のとおりです。

表1‒9　文字コード

監視対象OS

日本語の場合

英語の場合

中国語の場合

AIX

SJIS

SJISを指定した場合，SJIS/Ja_JPが設定されます。

SJIS/Ja_JP

SJIS/Ja_JP.IBM-932

EUC

EUCを指定した場合，EUC/ja_JPが設定されます。

EUC/ja_JP

EUC/ja_JP.IBM-eucJP

UTF-8

UTF-8を指定した場合，UTF-8/JA_JPが設定されます。

UTF-8/JA_JP

UTF-8/JA_JP.UTF-8

C

C

GB18030

GB18030を指定した場合，GB18030/Zh_CN.GB18030が設定されます。

GB18030/Zh_CN.GB18030

GB18030/Zh_CN

UTF-8

UTF-8を指定した場合，UTF-8/ZH_CNが設定されます。

UTF-8/ZH_CN

UTF-8/ZH_CN.UTF-8

C

HP-UX

SJIS

SJISを指定した場合，SJIS/ja_JP.SJISが設定されます。

SJIS/ja_JP.SJIS

SJIS/japanese

EUC

EUCを指定した場合，EUC/ja_JP.eucJPが設定されます。

EUC/ja_JP.eucJP

EUC/japanese.euc

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.utf8が設定されます。

UTF-8/ja_JP.utf8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。

GB18030/zh_CN.gb18030

UTF-8

UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。

UTF-8/zh_CN.utf8

C

Linux

SJIS/ja_JP.sjis※1

SJIS/ja_JP.SJIS※1

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。

UTF-8/ja_JP.UTF-8

UTF-8/ja_JP.utf8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。

GB18030/zh_CN.gb18030

UTF-8

UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。

UTF-8/zh_CN.utf8

C

Solaris

EUC

EUCを指定した場合，EUC/jaが設定されます。

EUC/ja

EUC/japanese

EUC/ja_JP.eucJP

SJIS

SJISを指定した場合，SJIS/ja_JP.PCKが設定されます。

SJIS/ja_JP.PCK

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。

UTF-8/ja_JP.UTF-8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.GB18030が設定されます。

GB18030/zh_CN.GB18030

GB18030/zh_CN.GB18030@pinyin

GB18030/zh_CN.GB18030@radical

GB18030/zh_CN.GB18030@stroke

UTF-8

UTF-8を指定した場合，UTF-8/zh.UTF-8が設定されます。

UTF-8/zh.UTF-8

UTF-8/zh_CN.UTF-8

UTF-8/zh_CN.UTF-8@pinyin

UTF-8/zh_CN.UTF-8@radical

UTF-8/zh_CN.UTF-8@stroke

C

Windows

SJIS

SJIS※2

C

GB18030

注※1

監視対象OSがSUSE Linuxの場合だけ有効です。

注※2

英語OSの場合，文字コードにSJISを指定してもCで動作します。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したログファイルをフィルタリングする場合に，フィルターを正規表現で指定します。

このオプションを指定すると，指定した正規表現と一致したログデータだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

このオプションは，-fオプションを指定したときだけ指定できます。

このオプションは，リモートの監視対象ホストがUNIXの場合だけ有効です。前提条件として，SSH接続でgrepコマンドが実行できる必要があります。リモートの監視対象ホストがWindowsの場合は，このオプションを指定しても無視されます。

指定できる正規表現の形式は，リモートの監視対象ホストのgrepコマンドの-Eオプションに指定できる拡張正規表現の形式と同一です。環境変数は使用できません。

正規表現は128バイト以内の文字列で指定します。使用できる文字列は，「'」，「"」，「<」，「>」，および制御文字を除く半角英数字，半角スペース，記号です。文字列に半角スペースが含まれている場合は，前後をダブルクォーテーション「"」で囲む必要があります。

grepコマンドのパス例を次に示します。詳細は，各OSのgrepコマンドのマニュアルを参照してください。

Linuxの場合：/bin/grep

Solarisの場合：/usr/xpg4/bin/grep

Linux，Solaris以外の場合：/usr/bin/grep

-m イベント化するデータの最大長（バイト）

ログファイルの1行を，先頭から何バイト読み込むかを指定します。指定できるバイト数は1〜1,024です。このオプションを省略した場合は512が設定されます。

行の終了文字は終了記号「¥0」に変更されます。ログファイルの1行がこのオプションで指定されたバイト数を超える場合，最後の1バイトが「¥0」に変更されます。

このオプションで指定した値は，入力したログファイルの1行の有効範囲を示します。したがって，リモート監視ログファイルトラップ動作定義ファイルのMARKSTRパラメーターの正規表現とACTDEFパラメーターの正規表現をチェックするのは，ここで指定した範囲内です。つまり，有効範囲を超えたカラムに対応する正規表現があっても，それらはチェックの対象にはなりません。

-p ログデータ出力元プログラム名

ログデータを出力するプログラム名を指定します。指定した名前はJP1/IM - Viewの［イベントコンソール］画面に表示されます。

表示される名称は次のとおりです。

Windowsの場合

/HITACHI/JP1/NT_LOGTRAP/ログデータ出力元プログラム名

UNIXの場合

/HITACHI/JP1/UX_LOGTRAP/ログデータ出力元プログラム名

このオプションを省略すると，Windowsの場合は「/HITACHI/JP1/NT_LOGTRAP」，UNIXの場合は「/HITACHI/JP1/UX_LOGTRAP」と表示されます。

-r

このオプションを指定すると，次の場合に，ログが収集できるようになるまで，-tオプションで指定した間隔で収集を試みます。

リモート監視ログファイルトラップの起動時に，リモートの監視対象ホストにアクセスできない場合

リモート監視ログファイルトラップの稼働中に，リモートの監視対象ホストにアクセスできなくなった場合

リモート監視ログファイルトラップの起動時に，監視対象のログファイルにアクセスできない場合

リモート監視ログファイルトラップの稼働中に，監視対象のログファイルにアクセスできなくなった場合

-rオプションは，次の場合に指定してください。

リモート監視ログファイルトラップの起動後に，リモートの監視対象ホストにアクセスできるようになる場合

リモート監視ログファイルトラップの起動後に，監視対象のログファイルが作成される場合

リモートの監視対象ホストにアクセスできなくでも監視を継続したい場合

このオプションを省略した場合，次の動作となります。

リモート監視ログファイルトラップを起動した時点で，監視対象のログファイルの収集ができない場合，起動を中止し処理を終了します。

稼働中に監視対象のログファイルの収集ができなくなった場合，リモート監視ログファイルトラップ動作定義ファイルに指定したリトライ回数および間隔でリトライします。

-t ファイル監視間隔（秒）

ファイルの監視間隔を指定します。指定できる値は60〜86,400（単位：秒）です。省略した場合は300が設定されます。

WRAP2形式のログファイルを監視する場合

ラップアラウンドする頻度が高い場合や監視間隔を長く指定した場合に，リモート監視ログファイルトラップがデータを読み込む前に上書きされてしまい，データの読み込み漏れが発生するおそれがあります。データの読み込み漏れの予防策として，次の監視間隔の見積もり式を参考にしてください。

ログファイルサイズ（バイト）×ログファイル数>1秒当たりの出力サイズ（バイト）×監視間隔（秒）

ログファイル名1 […ログファイル名32]

監視するログファイル名を指定します。ログファイル名は256バイト以内の文字列で指定します。監視対象ホストがWindowsの場合は，ホスト名を除いたネットワークパス名で指定します。UNIXの場合はフルパスで指定します。なお，ワイルドカードを使用して，監視するログファイルを指定することはできません。

監視対象ホストがUNIXの場合，監視対象ファイルパスに半角英数字および「-」，「_」，「.」，「/」を含むログファイルを監視できます。それ以外の文字を含むファイルパスについては，正常に監視できない場合があります。

指定できるファイル数は32以下で，指定できるファイル形式は次の形式です。

シーケンシャルファイル(SEQ)

シーケンシャルファイル(SEQ2)

ラップアラウンドファイル(WRAP2)

戻り値

0

起動成功

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

8

指定した監視名は稼働済み

9

プロファイルの各種制限値を超過

10

排他編集権取得エラー

11

動作定義ファイル不正

12

認証情報定義ファイル不正

13

通信エラー

14

DB不正

17

権限不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1のmonitoringNameのリモート監視ログファイルトラップを起動する場合

jcfallogstart -a monitoringName -o host1

使用例2

リモート監視ログファイルトラップ動作定義ファイルを新規作成し，起動する場合

jcfallogstart -a monitoringName -o host2 -f actionDefinition.conf -c SJIS -filter ".*-E" /log/sample.log

jcfallogstat

機能

リモート監視ログファイルトラップの動作状況を表示します。

このコマンドを実行すると，引数に指定した監視名を持つ，または引数に指定した監視対象ホストを監視対象とするリモート監視ログファイルトラップの動作状況を返します。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

形式

jcfallogstat {-o 監視対象ホスト名 [-a 監視名] | ALL}
             [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

表示形式

jcfallogstatコマンドを実行すると，次の形式で出力結果が表示されます。ただし，ALLを指定していてリモート監視構成にホストが存在しない，または指定したホストがリモート監視構成に存在しない場合は，そのことを示すメッセージが表示されます。

注

この例では，説明のために行頭に行番号を入れて示しています。

1　Message ID△メッセージ

2　Message ID△メッセージ

3　[ホスト名]

4　監視名△状態

5　監視名△状態

6　監視名△状態

7　[ホスト名]

8　[ホスト名]

9　△状態

10　：

1行目

コマンド実行が開始したことを示すメッセージを表示します。

2行目

次の表示範囲を示すメッセージを表示します。

すべて

指定したホスト

指定したホストの指定したログファイルトラップ

3〜6行目

指定した範囲内のリモートの監視対象ホストのログファイルトラップに関する状態を表示します。表示する状態は，次のとおりです。

START：ログファイルトラップが起動中の状態

STOP：ログファイルトラップが停止中の状態

EDIT：ログファイルトラップの動作定義ファイルが編集されているが，反映していない状態

FAIL：次の理由によってログファイルトラップの状態の取得に失敗した状態

・ホスト不正（ホスト情報未収集，または収集失敗状態となっている）

・SSH，WMI/NetBIOS（NetBIOS over TCP/IP）通信でエラーが発生した

・認証エラー

・I/Oエラー

・排他権取得エラー

・内部エラー

7行目

ログファイルトラップが1件も定義されていない場合，ホスト名だけを表示します。

8〜9行目

ホスト単位でエラーが発生し状態の取得に失敗した場合に，FAILだけを表示します。

10行目

指定した範囲内すべてのリモートの監視対象ホストのログファイルトラップに関する状態を表示します。

引数

-o 監視対象ホスト名

動作状況を確認したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-a 監視名

動作状況を確認したいリモート監視ログファイルトラップの監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

ALL

すべてのログファイルトラップの監視名を対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。このオプションを省略した場合は物理ホスト名が設定されます。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

リモート監視ログファイルトラップがすべて稼働している

1

リモート監視ログファイルトラップが一部稼働している（ALLオプションを指定したとき，または-oオプションだけを指定したとき）

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

14

DB不正

17

権限が不正

18

I/Oエラー

19

リモート監視ログファイルトラップがすべて停止している

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

host1のname1のリモート監視ログファイルトラップの動作状況を表示する場合

jcfallogstat -o host1 -a name1

jcfallogstop

機能

リモート監視ログファイルトラップを停止します。

オプションで，次の指定ができます。

停止する範囲（個別停止または一括停止）

停止したリモート監視ログファイルトラップの削除の有無

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

SSHで通信する場合，対象のリモートの監視対象ホストと公開鍵暗号方式でSSH認証できる

NetBIOS（NetBIOS over TCP/IP）で通信する場合，監視するログファイルが共有されている

リモート監視ログファイルトラップが起動している

形式

jcfallogstop {-o 監視対象ホスト名 [-a 監視名] | ALL}
             [-d]
             [-h 論理ホスト名]
             [-q]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-o 監視対象ホスト名

停止したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-a 監視名

停止したいリモート監視ログファイルトラップの監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

ALL

すべてのリモート監視ログファイルトラップを対象とします。

-d

このオプションを指定すると，停止するリモート監視ログファイルトラップのエントリーをプロファイルツリーから削除します。

このオプションを-a，-o，またはALLオプションのどれかと組み合わせた場合，複数のリモート監視ログファイルトラップをプロファイルツリーから削除することになるため，問題ないかを確認するためのメッセージが表示されます。その他の指定と組み合わせた場合は，指定しても無視されます。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-q

このオプションを指定すると，-dオプション指定時でも確認メッセージが表示されません。-dオプションを指定していない場合は，指定しても無視されます。

戻り値

0

停止成功，または削除成功

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

12

認証定義ファイル不正

13

通信エラー

14

DB不正

15

指定したリモート監視ログファイルトラップは停止済み（-dオプションを指定していないとき）

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1のname1のリモート監視ログファイルトラップを停止する場合

jcfallogstop -o host1 -a name1

使用例2

すべてのリモート監視ログファイルトラップを停止後，削除する場合

jcfallogstop ALL -d

jcfcolvmesx

機能

VMware ESXから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

ただし，VMware ESXからゲストOSの仮想ホスト名を取得するには，ゲストOSでVMware Toolsが動作している必要があります。VMware Toolsがインストールされていない，またはインストールされていても動作していない場合，仮想ホスト名は取得できません。

また，ゲストOS自体が起動していない場合も，仮想ホスト名は取得できません。

このコマンドは，VMware Infrastructure SDKのインターフェースを使用して通信します。

形式

jcfcolvmesx
          [-m 通信種別]
          -u ユーザーID
          [-p パスワード]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-m 通信種別

VMware ESXとの通信方法を指定します。

httpsを指定した場合，VMware ESXとhttps通信をします。httpを指定した場合，VMware ESXとhttp通信をします。

このオプションを指定しなかった場合，httpsで通信をします。

-u ユーザーID

接続先VMware ESXのアカウントのユーザーIDを指定します。

ユーザーIDは，256バイト以内の半角文字列で指定します。空白，タブは指定できません。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。

パスワードは，256バイト以内の半角文字列で指定します。空白，タブは指定できません。

このオプションを指定しなかった場合，パスワードなしが仮定されます。

-c ホスト名 [ホスト名]

VMware ESXが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

VMware ESXから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー（Windows限定）

5

管理者コンソールから実行されなかった（Windows限定）

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒10　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

090100

文字コード

UTF-8固定

表1‒11　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒12　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

VMware ESXの場合，「ESX」を出力する。

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化構成管理ホスト

VMMホストを管理するホスト名。

jcfcolvmesxコマンドの場合，常に空白。

出力例

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,ESX1,,,
Vm2,ESX1,,,
ESX1,,ESX,4.0,

jcfcolvmhcsm

機能

HCSMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmhcsm
          -u ユーザーID
          -p パスワード
          [-port ポート番号]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-u ユーザーID

接続先HCSMのアカウントのユーザーIDを指定します。ユーザーIDは，制御文字を含まない255バイト以内の文字列で指定します。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。パスワードは，制御文字を含まない255バイト以内の文字列で指定します。

-port ポート番号

接続先HCSMと通信するためのポート番号を指定します。ポート番号は，1〜65535の半角数字で指定します。このオプションを指定しなかった場合，23015が仮定されます。

-c ホスト名 [ホスト名]

HCSMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

HCSMから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒13　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

101000

文字コード

UTF-8固定

表1‒14　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒15　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

HCSMの場合：HCSM

日立サーバ論理分割機構の場合：Virtage

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理種別がHCSMの場合，HCSMの外部接続インターフェースのバージョンが設定される。

なお，仮想化構成情報をHCSMから収集した場合，仮想化管理種別がVirtageのホストではバージョンを収集できない。

仮想化構成管理ホスト

VMMホストを管理するホスト名。

出力例

#VM,101000,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
WIN-T0NFDNMQ29E,,HCSM,7.2,
10.197.62.41,,Virtage,,WIN-T0NFDNMQ29E
bs20071-1,10.197.62.41,,,
WIN-77MGIUCU8P0,,,,WIN-T0NFDNMQ29E
guest01,,,,WIN-T0NFDNMQ29E

jcfcolvmkvm

機能

KVMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmkvm
          -u ユーザーID
          -i 秘密鍵ファイルパス
          [-port ポート番号]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-u ユーザーID

接続先KVMが動作しているホストのユーザーIDを指定します。ユーザーIDは，空白およびタブを含まない255バイト以内の半角文字列で指定します。

-i 秘密鍵ファイルパス

接続先KVMと通信するための秘密鍵ファイル名を絶対パス形式で指定します。秘密鍵ファイルパスは，制御文字を含まない256バイト以内の文字列で指定します。秘密鍵ファイルパスは，大文字，小文字を区別します。また，パスに空白を含む場合は，「"」で囲みます。

-port ポート番号

接続先KVMとSSH接続するためのポート番号を指定します。ポート番号は，1〜65535の半角数字で指定します。このオプションを指定しなかった場合，22が仮定されます。

-c ホスト名 [ホスト名]

KVMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

KVMから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒16　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

101000

文字コード

UTF-8固定

表1‒17　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒18　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

KVMの場合，「KVM」を出力する。

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化構成管理ホスト

VMMホストを管理するホスト名。

jcfcolvmkvmコマンドの場合，常に空白。

出力例

#VM,101000,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
jp1-sf7800b,,KVM,0.12.1,
kv7801,jp1-sf7800b,,,
kv7802,jp1-sf7800b,,,
kv7803,jp1-sf7800b,,,
kv7804,jp1-sf7800b,,,

jcfcolvmscvmm（Windows限定）

機能

SCVMMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmscvmm
          -c ホスト名 [ホスト名]
          [-d ドメイン名 -u ユーザーID [-p パスワード]]
          -o 出力ファイル名

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納ディレクトリ

Managerパス¥bin¥imcf¥

引数

-c ホスト名 [ホスト名]

SCVMMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-d ドメイン名

接続先SCVMMのホストが所属するドメイン名を指定します。JP1/IM - Managerが接続先SCVMMのホストのドメインと，同じドメインに所属する場合は省略できます。ドメイン名は，255バイト以内で指定します。

-u ユーザーID

接続先SCVMMのホストが所属するドメインで管理者権限を持つアカウントのユーザーIDを指定します。-dオプションを指定した場合は，このオプションは省略できません。ユーザーIDは，制御文字を含まない255バイト以内の文字列で指定します。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。このオプションを指定しなかった場合，パスワードなしが仮定されます。パスワードは，制御文字を含まない255バイト以内の文字列で指定します。

-o 出力ファイル名

vCenterから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒19　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

090100

文字コード

UTF-8固定

表1‒20　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒21　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

Hyper-Vの場合：Hyper-V

SCVMMの場合：SCVMM

vCenterの場合：vCenter

VMware ESXの場合：ESX

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理元ホスト名

VMMホストを管理するホスト名。

出力例

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,ESX1,,,
Vm2,ESX1,,,
ESX1,,ESX,4.0,vCenter1
vCenter1,, vCenter,2.0,SCVMM1
SCVMM1,,SCVMM,2008,

jcfcolvmvc

機能

vCenterから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmvc
          [-m 通信種別]
          -u ユーザーID
          [-p パスワード]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-m 通信種別

vCenterとの通信方法を指定します。

httpsを指定した場合，vCenterとhttps通信をします。httpを指定した場合，vCenterとhttp通信をします。

このオプションを指定しなかった場合，httpsで通信をします。

-u ユーザーID

接続先vCenterのアカウントのユーザーIDを指定します。

ユーザーIDは，制御文字を含まない255バイト以内の文字列で指定します。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。

パスワードは，制御文字を含まない255バイト以内の文字列で指定します。

このオプションを指定しなかった場合，パスワードなしが仮定されます。

-c ホスト名 [ホスト名]

vCenterが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

vCenterから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒22　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

090100

文字コード

UTF-8固定

表1‒23　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒24　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

vCenterの場合：vCenter

VMware ESXの場合：ESX

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理元ホスト名

VMMホストを管理するホスト名。

出力例

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,ESX1,,,
Vm2,ESX1,,,
ESX1,,ESX,4.0,vCenter1
vCenter1,, vCenter,2.0,

jcfcolvmvirtage

機能

日立サーバ論理分割機構から仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmvirtage
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-c ホスト名 [ホスト名]

日立サーバ論理分割機構を管理するJP1/SC/CMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

日立サーバ論理分割機構を管理するJP1/SCから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒25　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

090100

文字コード

UTF-8固定

表1‒26　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒27　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

JP1/SC/CMの場合：JP1/SC/CM

日立サーバ論理分割機構の場合：Virtage

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理元ホスト名

VMMホストを管理するホスト名。

出力例

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,VIRTAGE1,,,
Vm2, VIRTAGE1,,,
VIRTAGE1,,Virtage,
SCCM1,VIRTAGE1,JP1/SC/CM,,

jcfdbsetup

機能

構成情報を格納するIM構成管理DBをセットアップするコマンドです。データベースのサイズ，ポート番号，データベース格納先は，セットアップ情報ファイルに指定しておく必要があります。

Windowsの場合，統合監視DBがセットアップされていない環境でこのコマンドを実行すると，次のサービスがOSに登録されます。

物理ホストのセットアップ時：JP1/IM2-Manager DB Server，JP1/IM2-Manager DB Cluster Service

クラスタ構成のセットアップ時：JP1/IM2-Manager DB Server_論理ホスト名，JP1/IM2-Manager DB Cluster Service_論理ホスト名

UNIXの場合，統合監視DBがセットアップされていない環境でこのコマンドを実行すると，/etc/inittabファイルに，IMデータベースのパスを含むエントリーが追加されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストごとに追加されます。このコマンドを実行したときに追加された/etc/inittabファイルのエントリーを，削除，編集，またはコメントアウトしないでください。

形式

jcfdbsetup {-f セットアップ情報ファイル名|-s}
           [-h 論理ホスト名 -c {online|standby}]
           [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-f セットアップ情報ファイル名

インストール先フォルダや，データベース領域のサイズを記述したセットアップ情報ファイルを指定します。IM構成管理DBと統合監視DBがどちらもセットアップされていない場合は，必ずこのオプションを指定してください。統合監視DBがすでにセットアップ済みの場合にこのオプションを指定する場合は，統合監視DBのセットアップ時に指定したセットアップ情報ファイルと同じファイルを指定してください。また，統合監視DBがすでにセットアップ済みの場合は，-sオプションを代わりに指定できます。その際，統合監視DBのセットアップ時に指定したセットアップ情報が用いられます。

-sオプションと同時に指定できません。また，-fオプションと-sオプションは同時に省略できません。

パスに空白を含む場合は，「"」で囲みます。クラスタ環境を構築する場合は，クラスタセットアップ情報ファイル名を指定してください。

-s

統合監視DBがセットアップされている場合は，-fオプションの代わりに指定できます。このオプションを指定した場合は，統合監視DBのセットアップ時に指定されたセットアップ情報の内容を参照して，IM構成管理DB をセットアップします。

統合監視DBがセットアップされていない場合，このオプションを指定すると，KNAN11193-Eメッセージが出力されます。

-fオプションと同時に指定できません。また，-sオプションと-fオプションは同時に省略できません。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するIM構成管理DBをセットアップします。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-c {online|standby}

クラスタ構成の実行系および待機系のセットアップ種別を指定します。-hオプションを指定した場合は，必ずこのオプションを指定してください。また，すでに同一ホストに統合監視DBをセットアップしている場合は，-cオプションに統合監視DBを作成したときと同じ値を指定してください。

online：実行系をセットアップする場合に指定します。

standby：待機系をセットアップする場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。また，非クラスタ環境で，論理ホストを運用する場合は-cオプションに「online」を指定してください。

-q

ユーザーの確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

実行系と待機系のクラスタセットアップ情報ファイルの内容は同じにする必要があります。待機系をセットアップする場合，実行系で使用したクラスタセットアップ情報ファイルをコピーして使用してください。実行系と待機系で指定したファイル内容が異なっていた場合，待機系でアンセットアップしたあとに，クラスタセットアップ情報ファイルを実行系からコピーし，コマンドを再実行してください。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後に一度アンセットアップしてから，コマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdistup，pdfmkfs，pddef，およびpdloadのプロセスが実行されていないことを確認し，jcfdbunsetupコマンドを実行してからこのコマンドを再実行してください。

統合監視DBをセットアップ済みの場合，かつIMデータベースを使用している場合，JP1/IM-Managerサービスが停止している必要があります。

Windowsで統合監視DBを使用している場合，IMデータベースサービス（JP1/IM2-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service_論理ホスト名）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

引数に指定する論理ホスト名とJP1/Baseの論理ホスト名が一致し，かつ論理ホスト名の名前解決ができることを確認してからコマンドを実行してください。

jcodbunsetup，またはjcfdbunsetupコマンドを実行してIMデータベースをアンセットアップした場合にjcfdbsetupコマンドを実行するときは，jcfdbsetupコマンドを実行する前にOSを再起動してください。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jcfdbunsetup

機能

構成情報を格納するIM構成管理DBをアンセットアップするコマンドです。

このコマンドは，IM構成管理DBの使用を停止する場合，JP1/IM - Managerをアンインストールする場合，IM構成管理DBを再作成する場合，およびデータベースサイズを拡張する場合に実行します。

統合監視DBをセットアップしている環境では，このコマンドの実行後も統合監視DBは使用できます。

Windowsの場合，統合監視DBがセットアップされていない環境でこのコマンドを実行すると，次のサービスが削除されます。

物理ホストのアンセットアップ時：JP1/IM-Manager DB Server，JP1/IM-Manager DB Cluster Service

クラスタ構成のアンセットアップ時：JP1/IM-Manager DB Server_論理ホスト名，JP1/IM-Manager DB Cluster Service_論理ホスト名

UNIXの場合，統合監視DBがセットアップされていない環境でこのコマンドを実行すると，jcodbsetupまたはjcfdbsetupコマンドが登録した/etc/inittabファイルのエントリーが削除されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストに対応した処理だけ削除されます。

なお，jcfdbunsetupコマンドを実行したあとは，必ず次のファイルを削除してください。

Windowsの場合

物理ホストのとき

Managerパス¥data¥imcf¥imconfig以下のファイル

Managerパス¥data¥imcf¥profiles以下のファイルおよびフォルダ

論理ホストのとき

共有フォルダ¥data¥imcf¥imconfig以下のファイル

共有フォルダ¥data¥imcf¥profiles以下のファイルおよびフォルダ

UNIXの場合

物理ホストのとき

/var/opt/jp1imm/data/imcf/imconfig以下のファイル

/var/opt/jp1imm/data/imcf/profiles以下のファイルおよびディレクトリ

論理ホストのとき

共有ディレクトリ/data/imcf/imconfig以下のファイル

共有ディレクトリ/data/imcf/profiles以下のファイルおよびディレクトリ

形式

jcfdbunsetup [-h 論理ホスト名 -c {online|standby}]
             [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するIM構成管理DBをアンセットアップします。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-c {online|standby}

クラスタ構成の実行系および待機系のアンセットアップ種別を指定します。-hオプションを指定した場合は，必ずこのオプションを指定してください。

online：IM構成管理DBのセットアップでonlineを指定した場合に指定します。

standby：IM構成管理DBのセットアップでstandbyを指定した場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。また，非クラスタ環境で，運用していた論理ホストのIM構成管理DBをアンセットアップする場合は-cオプションに「online」を指定してください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

統合監視DBを作成している環境で，データベースのサイズを拡張する場合は，このコマンド実行後に，統合監視DBのアンセットアップコマンドを実行する必要があります。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後にコマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdirstプロセスが実行されていないことを確認してからこのコマンドを再実行してください。

Windowsの場合，サービスが次の状態である必要があります。

物理ホストのとき

IMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service）が停止していて，IMデータベースサービス（JP1/IM2-Manager DB Server）が開始している必要があります。また，統合監視DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM2-Manager）が停止している必要があります。

論理ホストのとき

論理ホストのIMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service_論理ホスト名）が停止していて，論理ホストのIMデータベースサービス（JP1/IM2-Manager DB Server_論理ホスト名）が開始している必要があります。また，統合監視DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM2-Manager_論理ホスト名）が停止している必要があります。

UNIXの場合，IM構成管理DBがセットアップ済み，かつIMデータベースを使用しているとき，JP1/IM-Managerサービスが停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jcfexport

機能

IM構成管理で管理しているシステムの階層構成（IM構成），ホスト情報および定義情報を出力するコマンドです。

このコマンドを使用する場合には，IM構成管理サービスが起動している必要があります。jcfimportコマンドを実行している場合，このコマンドは実行できません。また，同時に実行できるコマンドの数は5個までです。

形式

jcfexport        [-h 論理ホスト名]
                 [-f]
                 -o ディレクトリ名
                 [-m | -r | -c | -g | -a]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-f

指定したディレクトリにエクスポートファイル名と同名のファイルがすでにある場合は，ファイルを上書きします。このオプションを省略した場合は，エクスポート先にファイルがあるとエクスポートしません。

-o ディレクトリ名

エクスポートデータを出力するディレクトリ名を絶対パス形式，またはこのコマンドを実行した場所からの相対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲んで指定します。

-m

ホスト情報だけをエクスポートします。エクスポートした情報は，ホスト入力情報ファイル（host_input_data.csv）に出力されます。

-r，-c，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-r

ホスト情報とリモート認証情報だけをエクスポートします。

-m，-c，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-c

ホスト情報とシステムの階層構成だけをエクスポートします。ホスト情報は，ホスト入力情報ファイル（host_input_data.csv）に出力されます。また，システムの階層構成は，system_tree_information.txtに出力されます。

-m，-r，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-g

ホスト情報，業務グループ情報，監視グループ情報だけをエクスポートします。

-m，-r，-c，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-a

すべての情報をエクスポートします。エクスポートした情報は，data_information.txtに出力されます。ホスト情報は，ホスト入力情報ファイル（host_input_data.csv）に出力されます。システムの階層構成は，system_tree_information.txtに出力されます。また，定義情報は，-oオプションで指定したディレクトリ¥definition_files¥ホスト名¥製品名の直下の，次のファイルに出力されます。

転送設定ファイル（forward）

ログファイルトラップ動作定義ファイル（任意のファイル）

ログファイルトラップ起動定義ファイル（jevlog_start.conf）

イベントログトラップ機能の動作定義ファイル（ntevent.conf）

ローカルアクションの動作定義ファイル（jbslcact.conf）

-m，-r，-c，-gオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

注意事項

プロファイル設定ファイルを収集していないホストの場合，エクスポートするデータはありません（ディレクトリも作成されません）。

戻り値

0

正常終了

4

オプション不正

8

サーバに接続できない

12

メモリーが不足した

16

権限が不正

20

ファイルエラー，パスが不正，すでにファイルが存在するなど

21

同時実行数の上限に達した

24

入出力エラーが発生した

120

システムエラーが発生した

124

その他エラーにより終了した

201以上

JavaVMの起動エラーが発生した

使用例

c:¥tempの直下にIM構成管理のすべての情報をエクスポートする場合

jcfexport -o c:¥temp

jcfimport

機能

IM構成管理の情報をインポートするコマンドです。

このコマンドを使用する場合には，IM構成管理サービスが起動している必要があります。なお，リモート監視中は，このコマンドは実行できません。また，同時に実行できるコマンドの数は5個までです。

このコマンドを実行すると，インポート前にIM構成管理が管理していたホスト，システムの階層構成（IM構成），およびプロファイルの3種類の情報がすべて削除されて，オプションで指定した情報がインポートされます。

リモート監視をする場合は，インポート後にIM構成管理・ビューアーから［システム共通設定］画面を開き，設定を確認後に［OK］ボタンをクリックしてください。

形式

jcfimport       [-h 論理ホスト名]
                -i ディレクトリ名
                [-m | -r | -c | -g | -a]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定する必要はありません。

-i ディレクトリ名

jcfexportコマンドでエクスポートしたファイルのディレクトリ名を絶対パス形式，またはjcfimportコマンドを実行する場所からの相対パス形式で指定します。このオプションは省略できません。

-m

ホスト情報だけをインポートします。-c，-r，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-r

ホスト情報とリモート認証情報だけをインポートします。

-m，-c，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-c

システムの階層構成およびホスト情報をインポートします。-m，-r，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-g

ホスト情報，業務グループ情報，監視グループ情報だけをインポートします。

-m，-r，-c，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-a

すべての情報をインポートします。-m，-r，-c，-gオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

戻り値

0

正常終了

4

オプション不正

8

サーバに接続できない

12

メモリーが不足した

16

権限が不正

20

ファイルエラー，パスが不正など

24

入出力エラーが発生した

21

同時実行数の上限に達した

120

システムエラーが発生した

124

その他エラーにより終了した

201以上

JavaVMの起動エラーが発生した

使用例

c:¥tempの直下にあるエクスポートファイルのすべての情報をインポートする場合

jcfimport -i c:¥temp

jcfmkcsdata

機能

ホスト入力情報ファイル（host_input_data.csv）とセントラルスコープのエクスポートファイルから，仮想化構成の監視ツリー情報を追加したセントラルスコープのインポートファイルを生成します。または，業務グループ情報ファイル（monitoring_system_data.csv），監視グループ情報ファイル（monitoring_group_data.csv）およびセントラルスコープのエクスポートファイルから，業務グループの監視ツリー情報を追加したセントラルスコープのインポートファイルを生成します。

業務グループ情報ファイル（monitoring_system_data.csv），および監視グループ情報ファイル（monitoring_group_data.csv）については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「9.7.1(5)　業務グループ情報」および「9.7.1(6)　監視グループ情報」を参照してください。

形式

jcfmkcsdata
          { -f ホスト入力情報ファイル名 セントラルスコープのエクスポートファイル名 | -g 業務グループ情報ファイル名 監視グループ情報ファイル名 セントラルスコープのエクスポートファイル名 }
          -o エクスポートファイル名
          [-r]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-f ホスト入力情報ファイル名 セントラルスコープのエクスポートファイル名

jcfexportコマンドでエクスポートしたホスト入力情報ファイル（host_input_data.csv）とjcsdbexportコマンドでエクスポートしたファイルを，相対パスまたは絶対パス形式で指定します。このオプションは-gオプションと同時には指定できません。パスに空白を含む場合は，「"」で囲みます。

セントラルスコープのエクスポートファイルには，サーバ指向ツリーをエクスポートしたファイルを指定します。

ホスト入力情報ファイル（host_input_data.csv）については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「9.7.1(1)　ホスト情報」を参照してください。

-g 業務グループ情報ファイル名 監視グループ情報ファイル名 セントラルスコープのエクスポートファイル名

jcfexportコマンドでエクスポートした業務グループ情報ファイル（monitoring_system_data.csv），監視グループ情報ファイル（monitoring_group_data.csv）とjcsdbexportコマンドでエクスポートしたファイルを，相対パスまたは絶対パス形式で指定します。このオプションは-fオプションと同時には指定できません。パスに空白を含む場合は，「"」で囲みます。

セントラルスコープのエクスポートファイルには，サーバ指向ツリーをエクスポートしたファイルを指定します。なお，エクスポートファイルにはデータバージョンが0810以降の監視オブジェクトDBからエクスポートしたファイルを指定してください。

-o エクスポートファイル名

コマンドが出力するセントラルスコープのインポート用ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

[-r]

このオプションは，引数で指定したJP1/IM - Manager（セントラルスコープ）のエクスポートファイルに含まれる仮想化システム構成ツリーを使用するかどうかを設定します。このオプションを指定する場合，JP1/IM - Manager（セントラルスコープ）のエクスポートファイルの仮想化システム構成ツリーを使用しないで，このコマンドで新しく作成します。このオプションを指定しない場合，JP1/IM - Manager（セントラルスコープ）のエクスポートファイルに含まれる仮想化システム構成ツリーに対して，新たに仮想化システム構成ツリーを追加します。

注意事項

09-00以前のIM構成管理からバージョンアップした場合，次のようにファイルを操作してください。

ホスト入力情報ファイル（host_input_data.csv）

09-00のJP1/IM - Manager（IM構成管理）からバージョンアップした場合，ホスト入力情報ファイル（host_input_data.csv）のフォーマットバージョンが0900になっているため，jcfmkcsdataコマンドを実行できません。次の手順でフォーマットバージョンを変更してください。

jcfimportコマンドを実行して，ホスト入力情報ファイルをIM構成管理にインポートする。

jcfexportコマンドを実行して，ホスト入力情報ファイルをエクスポートする。

ホスト入力情報ファイルのフォーマットバージョンが0901になり，jcfmkcsdataコマンドが実行できるようになります。

戻り値

0

正常終了

1

引数エラー

2

指定したファイルが不正

3

指定した入力ファイルが存在しない

4

エクスポートファイルがすでに存在する

5

指定したファイルに対するアクセス権がない

6

メモリー不足

7

入出力エラーが発生した

9

ディスク不足

10

実行権限エラー

11

［Ctrl］+［C］キーでコマンドを強制終了した

12

指定したセントラルスコープのエクスポートファイルのデータバージョンが古い

20

ファイルパスに予約デバイスを指定した

99

その他のエラー

122

管理者コンソールから実行されなかった（Windows限定）

jcfmkhostsdata

機能

仮想化構成情報ファイルで，ホスト入力情報ファイルを更新します。

形式

jcfmkhostsdata
          -imcf ホスト入力情報ファイル
          -vm 仮想化構成情報ファイル
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-imcf ホスト入力情報ファイル

ホスト入力情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

-vm 仮想化構成情報ファイル

仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

-o 出力ファイル名

ホスト入力情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。ホスト入力情報ファイルには，ホスト入力情報ファイルを更新した結果が出力されます。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

注意事項

09-00以前のIM構成管理からバージョンアップした場合，次のようにファイルを操作してください。

ホスト入力情報ファイル（host_input_data.csv）

09-00のJP1/IM - Manager（IM構成管理）からバージョンアップした場合，ホスト入力情報ファイル（host_input_data.csv）のフォーマットバージョンが0900になっているため，jcfmkhostsdataコマンドを実行できません。次の手順でフォーマットバージョンを変更してください。

jcfimportコマンドを実行して，ホスト入力情報ファイルをIM構成管理にインポートする。

jcfexportコマンドを実行して，ホスト入力情報ファイルをエクスポートする。

ホスト入力情報ファイルのフォーマットバージョンが0901になり，jcfmkhostsdataコマンドが実行できるようになります。

仮想化構成情報ファイル

IM構成管理の仮想化構成収集コマンドjcfcolvmesxを実行して，再度仮想化構成情報ファイルを出力します。仮想化構成情報ファイルのフォーマットバージョンは0901にします。

戻り値

0

正常終了

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー（Windows限定）

5

管理者コンソールから実行されなかった（Windows限定）

6

出力ファイルがすでに存在する

7

指定したファイルが不正

8

指定した入力ファイルが存在しない

9

指定したファイルに対するアクセス権がない

10

入出力エラーが発生した

99

その他のエラー

jcfthreaddmp（Windows限定）

機能

IM構成管理・ビューアーのJavaスレッドダンプを生成するコマンドです。

次の条件が成立した場合，このコマンドを実行するとJavaのスレッドダンプが取得されます。

画面操作ができなくなった場合

IM構成管理・ビューアーとIM構成管理サーバのプロセスで，停止しているプロセスがない場合

IM構成管理・ビューアーのJavaスレッドダンプをlogディレクトリ内にテキストファイル形式で出力します。

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1CoView¥log

なお，正常に稼働しているIM構成管理・ビューアーのスレッドダンプを生成すると，JavaVMが不安定になるため，IM構成管理・ビューアーを再起動する必要があります。

形式

jcfthreaddmp プロセスID

実行権限

なし（ただし，WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Viewパス¥bin¥

引数

プロセスID

操作できなくなったIM構成管理・ビューアーのjava.exeプロセスのプロセスIDを指定します。

なお，プロセスIDとして指定できるバイト数は，OSの制限に依存します。

IM構成管理・ビューアー（java.exe）以外のプロセスに対して，CTRL_BREAK_EVENTは送信しません。

戻り値

0

正常終了

1

オプションエラー，引数エラー

2

プロセスチェックエラー

3

スレッドダンプ出力要求送信エラー

4

実行権限エラー

10

上記以外のエラー

使用例1

操作できなくなったIM構成管理・ビューアーのプロセスIDが，1234の場合

jcfthreaddmp 1234

使用例2

IM構成管理・ビューアーに対応するjava.exeのプロセスIDの特定方法

次の手順で，操作不能になったIM構成管理・ビューアーに対応するjava.exeのプロセスIDを特定し，jcfthreaddmpコマンドの引数に指定します。

なお，複数のIM構成管理・ビューアーを起動している場合は，java.exeプロセスも複数存在するため，プロセスIDの特定は，使用例2の手順を使用してください。

［PID（プロセスID）］列を追加する。

タスクマネージャのプロセスタブを開き，［表示］−［列の選択］を実行し，列の選択画面で「PID（プロセスID）」にチェックを入れます。

操作不能になったIM構成管理・ビューアーか確認する。

タスクマネージャのアプリケーションタブで，IM構成管理・ビューアーを選択し，右クリックして表示されるポップアップメニューから［手前に表示］を実行します。手前に表示されたIM構成管理・ビューアーが操作できなくなったIM構成管理・ビューアーか確認する。

操作できなくなったIM構成管理・ビューアーのjava.exeの［PID（プロセスID）］を表示する。

アプリケーションタブで操作できなくなったIM構成管理・ビューアーを選択し，右クリックして表示されるポップアップメニューから［プロセスの表示］を実行します。

プロセスタブに切り替わり，操作できなくなったIM構成管理・ビューアーのjava.exeの行が選択されます。その選択行のPID列が，操作できなくなったIM構成管理・ビューアーに対応するjava.exeのプロセスIDとなります。

jddcreatetree

機能

インテリジェント統合管理サーバが管理する製品からシステム構成情報を取得し，jddupdatetreeコマンドの入力データとなるIM管理ノード関連ファイルを生成します。このコマンドを実行する前にjddsetaccessuserコマンドを実行して，認証の際に必要なユーザーIDとパスワードの情報を設定してください。

jddupdatetreeコマンド，jddsetaccessuserコマンドについては，「jddupdatetree」（1.　コマンド），「jddsetaccessuser」（1.　コマンド）を参照してください。

このコマンドは，インテリジェント統合管理基盤にIM管理ノード関連ファイルの生成要求を出し，要求が完了するまで待機します。

なお，コマンドを実行する前に，システムノード定義ファイル（imdd_systemnode.conf），IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf），構成取得対象ホスト定義ファイル（imdd_target_host.conf）の定義が必要です。また，ホスト名にエイリアス名を付けることができる製品をIM管理ノードの構成に加える場合は，ホスト名定義ファイル（imdd_host_name.conf）でエイリアス名と実ホスト名のマッピングを定義しておく必要があります。

IM管理ノード関連ファイルについては，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」のIM管理ノード関連ファイルについて説明している項を参照してください。

また，定義ファイルについては，「システムノード定義ファイル（imdd_systemnode.conf）」（2.　定義ファイル），「IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）」（2.　定義ファイル），「構成取得対象ホスト定義ファイル（imdd_target_host.conf）」（2.　定義ファイル），「ホスト名定義ファイル（imdd_host_name.conf）」（2.　定義ファイル）を参照してください。

形式

jddcreatetree -o ディレクトリ名 [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-o ディレクトリ名

作成するファイルの保存先ディレクトリを，絶対パス形式，またはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲みます。パスの長さは，200文字まで指定できます。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，JP1/IMの論理ホスト名を指定します。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを設定していない場合は，物理ホスト名が仮定されます。

構成情報を取得できる論理ホスト名の長さは，最大32バイトです。それより長い論理ホスト名を指定した場合，jddcreatetreeコマンドはメッセージKAJY02015-Eを出力して失敗し，構成管理ツリーは更新されません。

注意事項

jddcreatetreeコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddupdatetreeコマンドを実行中に，jddcreatetreeコマンドの実行はできません。実行した場合，エラーとなります。

jddcreatetreeコマンドを使用するには，JP1/IM-ManagerおよびIMデータベースが起動している必要があります。

jddcreatetreeコマンドの実行中に，JP1/IM-ManagerおよびIMデータベースを停止しないでください。

拠点マネージャーまたは中継マネージャーを定義している場合は，システムの階層構成の同期が取れているかを確認したあと，統合マネージャーでjddcreatetreeコマンドを実行してください。なお，拠点マネージャーまたは中継マネージャーでjddcreatetreeコマンドを実行する必要はありません。

jddcreatetreeコマンドは，JP1/AJS3 - Managerホストでジョブを実行していない時間帯に実行してください。ジョブを実行しているときにjddcreatetreeコマンドを実行した場合，両方の処理の負荷が同時にかかることにより，それぞれの処理が遅延する可能性があります。

jddcreatetreeコマンドは，JP1/AJS3サービスが起動しているときに実行してください。構成情報取得先のホストのJP1/AJS3サービスが停止中または起動／停止途中にjddcreatetreeコマンドを実行すると，情報の取得に失敗します。

jddcreatetreeコマンドで情報取得中に，取得先のJP1/AJS3サービスを停止しないでください。停止した場合，サービスの停止処理が遅延する可能性があります。

jddcreatetreeコマンドでは，日本語以外の多バイト文字を含むユニット定義情報の取得はできません。取得した場合，構成管理ツリーが正しく表示されない可能性があります。

jddcreatetreeコマンドで取得する，ユニット名，ユニット定義内容，実行エージェント名，JP1資源グループ名などの情報に制御文字が含まれている場合，情報取得が失敗する可能性があります。取得する情報には，制御文字を含めないようにして運用してください。

戻り値

0

正常終了

1

正常終了（プロパティ不正）

2

排他中

3

引数不正

4

論理ホスト名が不正

5

インテリジェント統合管理基盤が利用する認証情報が設定されていない

6

jddcreatetreeコマンドの実行に必要な情報が不足している

7

jddcreatetreeコマンドの実行権限がない

8

指定したディレクトリにアクセスできない

9

指定したディレクトリのパスが長すぎる

11

インテリジェント統合管理基盤への接続に失敗

12

インテリジェント統合管理基盤の認証に失敗

13

前提ファイルが存在しない

14

前提ファイルの読み込みに失敗

15

前提ファイルのフォーマット不正

16

前提ファイルの記載内容不正

17

プラグインからの情報取得に失敗

18

プラグインからの情報が不正

20

IM管理ノードファイルの作成に失敗

21

IM管理ノードリンクファイルの作成に失敗

22

IM管理ノードツリーデータの作成に失敗

23

IM管理ノードツリーファイルの作成に失敗

26

認証に使用したユーザーの権限が不足

255

システムエラー

使用例1

作成するファイルの保存先を「C:¥tmp」とする場合の例を次に示します。

$ jddcreatetree -o C:¥tmp
KAJY02009-I コマンド(jddcreatetree)を開始しました
KAJY02010-I コマンド(jddcreatetree)が正常終了しました

使用例2

作成するファイルの保存先を「C:¥tmp」とし，論理ホストを「ronri」とする場合の例を次に示します。

$ jddcreatetree -o C:¥tmp -h ronri
KAJY02009-I コマンド(jddcreatetree)を開始しました
KAJY02010-I コマンド(jddcreatetree)が正常終了しました

jddupdatetree

機能

jddcreatetreeコマンドで取得したIM管理ノード関連ファイル，ユーザーが手動で定義したIM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）の情報に基づき，IM管理ノードのツリー情報とリンク情報を作成します。また，統合監視DBに格納されているJP1イベントをすべて取得し，IM管理ノードごとに状況を評価します。このコマンドを実行する前にjddsetaccessuserコマンドを実行して，認証の際に必要なユーザーIDとパスワードの情報を設定してください。

このコマンドは，インテリジェント統合管理基盤にIM管理ノード関連ファイルの反映要求を出し，要求が完了するまで待機します。

jddcreatetreeコマンドについては，「jddcreatetree」（1.　コマンド）を参照してください。

形式

jddupdatetree -i ディレクトリ名 [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-i ディレクトリ名

jddcreatetreeコマンドで作成したファイルの保存先ディレクトリを，絶対パス形式，またはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲みます。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，JP1/IMの論理ホスト名を指定します。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを設定していない場合は，物理ホスト名が仮定されます。

注意事項

jddupdatetreeコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddcreatetreeコマンドを実行中に，jddupdatetreeコマンドの実行はできません。実行した場合，エラーとなります。

jddupdatetreeコマンドを使用するには，JP1/IM-ManagerおよびIMデータベースが起動している必要があります。

jddupdatetreeコマンドの実行中に，JP1/IM-ManagerおよびIMデータベースを停止しないでください。

戻り値

0

正常終了

1

正常終了（プロパティ不正）

2

排他中

3

引数不正

4

論理ホスト名が不正

5

インテリジェント統合管理基盤が利用する認証情報が設定されていない

6

jddupdatetreeコマンド実行に必要な情報が不足している

7

jddupdatetreeコマンドの実行権限がない

8

指定したディレクトリが存在しない

10

IMデータベースサービスが起動していない

11

インテリジェント統合管理基盤への接続に失敗

12

インテリジェント統合管理基盤の認証に失敗

13

前提ファイルが存在しない

14

前提ファイルの読み込みに失敗

15

前提ファイルのフォーマット不正

16

前提ファイルの記載内容不正

17

イベント情報の取得に失敗

19

プラグインからの情報取得に失敗

21

マスターファイルの作成に失敗

22

マスターファイルの置換に失敗

26

認証に使用したユーザーの権限が不足

255

システムエラー

使用例1

jddcreatetreeコマンドで作成したファイルの保存先を「C:¥tmp」とする場合の例を次に示します。

$ jddupdatetree -i C:¥tmp
KAJY02009-I コマンド(jddupdatetree)を開始しました
KAJY02010-I コマンド(jddupdatetree)が正常終了しました

使用例2

jddcreatetreeコマンドで作成したファイルの保存先を「C:¥tmp」とし，論理ホストを「ronri」とする場合の例を次に示します。

$ jddupdatetree -i C:¥tmp -h ronri
KAJY02009-I コマンド(jddupdatetree)を開始しました
KAJY02010-I コマンド(jddupdatetree)が正常終了しました

jddsetaccessuser

機能

インテリジェント統合管理サーバが，管理対象のJP1製品のシステム構成情報をIM管理ノードとして収集する際に，監視対象のJP1製品へ接続するときや，インテリジェント統合管理基盤の各コマンドからインテリジェント統合管理基盤サーバに接続するときの認証を定義するコマンドです。ユーザーIDとパスワードの情報を設定します。

形式

jddsetaccessuser -id ユーザーID -pw パスワード [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-id ユーザーID

JP1/IM，JP1/PFM，JP1/AJSの管理者権限を持つユーザーのユーザーIDを指定します。

ユーザーIDは1〜31バイト以内の文字列で指定します。

使用できる文字は半角英数字と記号「!」，「$」，「%」，「&」，「_」，「-」，「#」，「@」です。

大文字が指定された場合でも小文字で指定されたものとして扱われます。

-pw パスワード

-idオプションで指定したユーザーに対するパスワードを指定します。

パスワードは6〜32バイト以内の文字列で指定します。

使用できる文字は半角英数字と記号「!」，「#」，「$」，「%」，「&」，「_」，「-」，「*」，「/」，「'」，「^」，「[」，「]」，「{」，「}」，「(」，「)」，「;」，「|」，「=」，「+」，「?」，「<」，「>」です。

大文字と小文字は区別します。パスワードに「^<>|&」が含まれる場合は「"」で囲んで指定します。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

戻り値

0

正常終了

1

引数不正

2

引数指定値不正

3

ファイルの作成に失敗

4

論理ホスト名が不正

7

jddsetaccessuserコマンドの実行権限がない

255

システムエラー

使用例1

「UserA」に「ABCDEF」というパスワードを設定する場合の例を次に示します。

$ jddsetaccessuser -id UserA -pw ABCDEF
KAJY02009-I コマンド(jddsetaccessuser)を開始しました
KAJY02010-I コマンド(jddsetaccessuser)が正常終了しました

使用例2

「UserA」に「ABCDEF」というパスワードを論理ホスト「ronri」に設定する場合の例を次に示します。

$ jddsetaccessuser -id UserA -pw ABCDEF -h ronri
KAJY02009-I コマンド(jddsetaccessuser)を開始しました
KAJY02010-I コマンド(jddsetaccessuser)が正常終了しました

jddsetproxyuser

機能

JP1/IM - Manager（インテリジェント統合管理基盤）が提供するプラグインからREST APIを実行する場合のプロキシサーバーの認証情報を設定するコマンドです。プロキシサーバーの認証を使用しない場合は，この設定は不要です。

形式1

Usage:
jddsetproxyuser {-list|-add -id ユーザーID -pw パスワード|-rm -id ユーザーID} [-h 論理ホスト名]

形式2

jddsetproxyuser -list [-h 論理ホスト名]

形式3

jddsetproxyuser -add -id ユーザーID -pw パスワード[-h 論理ホスト名]

形式4

jddsetproxyuser -rm -id ユーザーID [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-list

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を取得する場合に指定します。

-add

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を更新する場合に指定します。このオプションを指定した場合，-idオプションと-pwオプションの指定は必須です。指定がない場合はエラーとなります。

-rm

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を削除する場合に指定します。このオプションを指定した場合，-idオプションの指定は必須です。指定がない場合はエラーとなります。

-id ユーザーID

プロキシサーバー認証用ユーザーのユーザーIDを指定します。

-pw パスワード

-idオプションで指定したユーザーに対するパスワードを指定します。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

注意事項

jddsetproxyuserコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddsetproxyuserコマンドの実行中に，JP1/IM - ManagerおよびIMデータベースを停止しないでください。

jddsetproxyuserコマンドはプロキシ認証情報設定APIと同時に実行できません。プロキシ認証情報設定APIについては，別途提供するドキュメントを参照してください。

JP1/IM - Managerの停止中にjddsetproxyuserコマンドを実行した場合，KAJY52015-Wメッセージを出力し，次回JP1/IM - Managerを起動した際に設定を反映します。

戻り値

0

正常終了

1

引数不正

2

排他中

3

引数指定値不正

4

論理ホスト名が不正

5

インテリジェント統合管理基盤が利用する認証情報が設定されていない

7

jddsetproxyuserコマンドの実行権限がない

11

インテリジェント統合管理基盤への接続に失敗

12

インテリジェント統合管理基盤の認証に失敗

13

プロキシ認証情報更新失敗

255

システムエラー

使用例1

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を取得する場合の例を次に示します。

jddsetproxyuser -list
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
User1
User2
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

使用例2

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を更新する場合の例を次に示します。

jddsetproxyuser -add -id User3 -pw PASSWORD
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

jddsetproxyuser -list
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
User1
User2
User3
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

使用例3

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を削除する場合の例を次に示します。

jddsetproxyuser -rm -id User3
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

jddsetproxyuser -list
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
User1
User2
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

jcfview（Windows限定）

機能

IM構成管理・ビューアーを起動します。-hオプション，-uオプション，-pオプションで起動した場合，［ログイン］画面を表示しないで，自動的にログインします。

形式

jcfview [-h 接続先ホスト名] [-u ユーザー名] [-p パスワード]

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

-h 接続先ホスト名

ログインするIM構成管理が起動しているホスト名を指定します。指定できる文字数は，1〜255バイトです。JP1/IM - Managerが起動しているホストだけを指定できます。

接続先ホスト名には，次のものが指定できます。

コマンドを使用するホストで定義されているホスト名

コマンドを使用するホストでアドレス解決可能なホスト名

IPアドレス

IPアドレスを指定する場合，IPv4アドレス形式のアドレスだけ指定できます。IPv6アドレス形式のアドレスは指定できません。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-hオプションだけで起動した場合，または-hオプションと-uオプションで起動した場合，引数をデフォルト値として［ログイン］画面が表示されます。-hオプションと-pオプションで起動した場合，エラーとなります。

-u ユーザー名

認証サーバに登録してあるJP1ユーザー名を指定します。指定できる文字数は，1〜31バイトです。半角英数字（英字は小文字）だけを使用できます。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-uオプションだけで起動した場合，または-hオプションと-uオプションで起動した場合，引数をデフォルト値として［ログイン］画面を表示します。-uオプションと-pオプションで起動した場合，エラーとなります。

-p パスワード

指定したユーザー名に対応するパスワードを指定します。指定できる文字数は，6〜32バイトです。半角英数字だけを使用できます。英字は，大文字・小文字が区別されます。このオプションは省略できます。

このオプションを指定する場合は，-hおよび-uオプションも指定する必要があります。

戻り値

0

正常終了

1

引数エラー

2

メモリー不足

3

リソースの取得に失敗

4

エラーメッセージの作成に失敗

5

IM構成管理・ビューアーを強制終了

255

システムエラー

使用例1

IM構成管理・ビューアーを起動して，[ログイン]画面を表示する場合

jcfview

使用例2

［ログイン］画面を表示させないで自動的にログインする場合

接続先ホスト（host1），ユーザー名（user2），パスワード（password）を指定してIM構成管理・ビューアーを起動します。

jcfview -h host1 -u user2 -p password

jcfvirtualchstat

機能

指定ホストの仮想化構成を更新します。

仮想化環境管理ソフトウェアが管理する仮想化構成が変更された場合，このコマンドを実行することによって仮想化構成の変更をIM構成管理に反映できます。

なお，同時に実行できるコマンドの数は5個までです。

形式

jcfvirtualchstat    -c ホスト名
                    [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-c ホスト名

仮想化構成情報の収集対象のホスト名を指定します。ホスト名は，255文字以内で指定します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。論理ホスト名は，255バイト以内で指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

戻り値

0

正常終了

4

オプション不正

8

サーバに接続できない

12

メモリーが不足した

16

権限が不正

21

同時実行数の上限に達した

24

入出力エラーが発生した

120

システムエラーが発生した

124

その他エラーにより終了した

201以上

JavaVMの起動エラーが発生した

jco_killall.cluster（UNIX限定）

機能

クラスタシステムで運用している場合に，JP1/IM - Managerのプロセスを強制的に終了します。

クラスタ運用時には，jco_stop.clusterコマンドを実行してもプロセスが停止しなくて，クラスタ運用が失敗することがあります。このコマンドは，停止しないプロセスを強制終了します。このコマンドは，正規の方法でJP1/IM - Managerのサービスを停止してもプロセスが停止しない場合にだけ使用してください。

終了させるプロセスを次に示します。

プロセス管理（jco_spmd）

アクション実行サービス（jcamain）

イベントコンソールサービス（evtcon）

イベント基盤サービス（evflow）

相関イベント発行サービス（evgen）

セントラルスコープサービス（jcsmain）

IM構成管理サービス（jcfmain）

IMデータベースサービス

形式

jco_killall.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

JP1/Baseで設定した論理ホスト名を指定します。指定できる文字数は，1〜32バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

このコマンドは，論理ホスト名を先頭から32バイトまでで判定して，対応するプロセスを強制終了します。名称が33バイト以上の論理ホストのプロセスを強制終了できません。

戻り値

0

正常終了

1

論理ホスト名が指定されていない

2

ログディレクトリがない

jco_spmd_reload

機能

JP1/IM - Managerのプロセスの状態を更新します。JP1/IM - Managerの定義情報を変更した場合に，変更した内容を再度読み込んで有効にします。

jco_spmd_reloadコマンドの実行で有効になる定義ファイル，およびその定義情報は次のとおりです。詳細については，「2.　定義ファイル」記載の各定義ファイルの「定義の反映時期」を参照してください。

自動アクション環境定義ファイル（action.conf.update）の次の情報

ANDイベント保管期限（"EVENTALIVEPERIOD"）

アクション実行標準ユーザー（"ACTIONEXECUSER"）

自動アクション発行イベント（"SENDABLE_EVENT"）

イベント発行元ホスト名取得方法（"HOSTINEVENT"）

自動アクション通知定義ファイル（actnotice.conf）

拡張起動プロセス定義ファイル（jp1co_service.conf）

ヘルスチェック定義ファイル（jcohc.conf）

イベントガイド情報ファイル（jco_guide.txt）

ホスト情報ファイル（jcs_hosts）

ガイド情報ファイル（jcs_guide_xxx.txt）

相関イベント発行システムプロファイル（egs_system.conf）

相関イベント発行環境定義ファイル

インシデント手動登録定義ファイル（incident.conf）

インシデント引き継ぎ情報設定ファイル（incident_info.conf）

発生元ホストマッピング定義ファイル（user_hostmap.conf）

重大度変更定義ファイル（jcochsev.conf）

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）

イベント条件表示項目定義ファイル（attr_list.conf）

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）

イベント拡張属性定義ファイル

イベント拡張属性定義ファイル（拡張ファイル）

表示メッセージ変更定義ファイル（jcochmsg.conf）

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）

モニター画面呼び出し定義ファイル

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

形式

jco_spmd_reload [-h 論理ホスト名]
                [-t 監視時間]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定できる文字数は，1〜255バイトです。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-t 監視時間

jco_spmd_reloadコマンドの実行終了を待つ時間を秒単位で指定します。指定できる値は，0〜32,767（単位：秒）です。指定した時間内にjco_spmd_reloadコマンドの実行が終わらない場合，jco_spmd_reloadコマンドの実行が失敗したと見なします。デフォルトは，60秒です。

注意事項

jco_spmd_reloadコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

0以外の値

異常終了

jco_spmd_status

機能

JP1/IM - Managerのプロセス群の起動状態を表示するコマンドです。

形式

jco_spmd_status [-h 論理ホスト名]
                [-t 監視時間]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定できる文字数は，1〜255バイトです。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-t 監視時間

jco_spmd_statusコマンドの実行終了を待つ時間を秒単位で指定します。指定できる値は，0〜32,767（単位：秒）です。指定した時間内にjco_spmd_statusコマンドの実行が終わらない場合，jco_spmd_statusコマンドの実行が失敗したと見なします。デフォルトは60秒です。

戻り値

0

すべての子プロセスが起動している

1

プロセス管理との通信などでエラーが発生した

クラスタシステムで運用している場合に共有フォルダ（共有ディレクトリ）がマウントされていない

実行権限エラー（Windows限定）

4

一部の子プロセスが起動している

8

すべて停止している

12

要求処理中（リトライ可能）

jco_start（UNIX限定）

機能

JP1/IM - Managerを自動的に起動するためのスクリプトです。

このコマンドを実行するためには，JP1/IM - Managerのインストールとセットアップの完了後，次に示す操作が必要です。

# cd /etc/opt/jp1cons

# cp -p jco_start.model jco_start

この操作によって，システムの開始時に，JP1/IM - Managerが自動的に起動します。システムの開始時に，JP1/IM - Managerを自動的に起動させたくない場合はこの操作を行わないでください。

バージョン10以前のJP1/IM - Managerで自動起動していた場合，必ずこの操作をしてください。

自動起動の設定については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「2.17.2　自動起動および自動終了の設定（UNIXの場合）」を参照してください。

JP1/IM - Managerを手動で起動する場合は，/etc/opt/jp1cons/jco_start.modelスクリプト，またはこのスクリプトをコピーしたファイルを実行してください。

バージョン10以前のJP1/IM - Managerでjco_start.modelをコピーしたスクリプトで手動起動していた場合，このスクリプトをjco_start.modelで上書きしてください。

なお，このコマンドを実行する前に必ずJP1/Baseを起動してください。JP1/IM - Managerは，前提製品JP1/Baseの機能を使用して動作しています。

また，次の条件を満たす場合にこのコマンドを実行すると，IMデータベースサービスを起動したあと，JP1/IM - Managerを起動します。

IMデータベースサービスをセットアップしている

統合監視DBを使用している，またはIM構成管理サービスを起動する設定にしている

JP1/IM - Managerのプロセス群に起動要求を出したあと，戻り値0で終了します。プロセス群が正しく起動したかどうかは，jco_startコマンドの終了後，jco_spmd_statusコマンドで起動したサービスのプロセスIDを表示させて確認してください。ただし，IMデータベースサービスのプロセスIDは，表示されません。

形式

jco_start

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

注意事項

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/IM - Managerのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

環境変数JP1_HOSTNAMEが設定されていない環境でこのコマンドを実行してください。環境変数JP1_HOSTNAMEが設定されている環境でこのコマンドを実行すると，物理ホストではなく環境変数JP1_HOSTNAMEに設定した論理ホストのJP1/IM - Managerを起動しようとします。このコマンドは論理ホストに対応していないため，物理ホストのJP1/IM - Managerを起動する場合は，環境変数JP1_HOSTNAMEを削除してください。

jco_startコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数が二つ以上指定されている，イベントサービスが起動していない，またはIMデータベースサービスが起動できない

2

ログディレクトリがない

使用例1

統合監視DBを使用している場合

入力値

jco_start

結果

Please wait a minutes, now starting the IM database service...
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.
Please wait a minutes, now starting JP1/IM - Manager...
KAVB3690-I Processing to report the status of JP1_CONS has started.
Display the running processes
process name  process ID
      evflow      18990
     jcamain      19036
      evtcon      19037
KAVB3691-I All the processes have started.

使用例2

統合監視DBを使用していない，およびIM構成管理サービスを起動していない場合

入力値

jco_start

結果

Please wait a minutes, now starting JP1/IM - Manager...
KAVB3690-I Processing to report the status of JP1_CONS has started.
Display the running processes
process name  process ID
       evflow      19237
      jcamain      19277
       evtcon      19278
KAVB3691-I All the processes have started.

使用例3

IMデータベースを使用していない場合

入力値

jco_start

結果

Please wait a minutes, now starting the IM database service...
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11109-E The IM database service is not set up.
Unable start JP1/IM - Manager.

jco_start.cluster（UNIX限定）

機能

クラスタシステムで運用している場合に，論理ホスト上のJP1/IM - Managerを起動します。

クラスタソフトにこのコマンドを登録すると，JP1/IM - Managerが起動します。

このコマンドを実行する前に，同じ論理ホスト上のJP1/Baseを起動してください。JP1/Baseのイベントサービスが起動していない場合にこのコマンドを実行したときは，エラーとなります。

JP1/IM - Managerのプロセス群に起動要求を出したあと，戻り値0で終了します。プロセス群が正しく起動したかどうかは，jco_start.clusterコマンドの終了後，jco_spmd_statusコマンドで確認してください。

また，次の条件を満たす場合にこのコマンドを実行すると，IMデータベースサービスを起動したあと，JP1/IM - Managerを起動します。

論理ホスト上の統合監視DBを使用している，またはIM構成管理サービスを起動する設定にしている

このコマンドを実行するためには，JP1/IM - Managerのインストールとセットアップの完了後，jp1cc_setup_clusterおよびjp1cs_setup_clusterを実行する必要があります。また，IMデータベースサービスは，IMデータベースサービスのクラスタシステムをセットアップする必要があります。クラスタシステムのセットアップについては，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「8.　クラスタシステムでの運用と環境構築（UNIXの場合）」を参照してください。

形式

jco_start.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定できる文字数は，1〜63バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/IM - Managerのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

jco_start.clusterコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数が二つ以上指定されている，イベントサービスが起動していない，またはIMデータベースサービスが起動できない

2

ログディレクトリがない

jco_stop（UNIX限定）

機能

JP1/IM - Managerを自動的に終了するためのスクリプトです。このコマンドの実行には，JP1/IM - Managerのインストールとセットアップの完了後，次に示す操作が必要です。

# cd /etc/opt/jp1cons

# cp -p jco_stop.model jco_stop

この操作によって，システムの終了時にJP1/IM - Managerが自動的に終了します。ただし，IMデータベースサービスが起動している場合は，JP1/IM - Managerを停止したあとに自動的にIMデータベースサービスが終了します。

JP1/IM - Managerが停止しなかった場合，KAVB8800-Eのメッセージが標準出力に出力されます。

IMデータベースサービスが停止しなかった場合，KAVB8801-Eのメッセージが標準出力に出力されます。

JP1/IM - Managerを手動で停止する場合は，/etc/opt/jp1cons/jco_stop.modelスクリプト，またはこのスクリプトをコピーしたファイルを実行してください。

形式

jco_stop

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

注意事項

環境変数JP1_HOSTNAMEが設定されていない環境でこのコマンドを実行してください。環境変数JP1_HOSTNAMEが設定されている環境でこのコマンドを実行すると，物理ホストではなく環境変数JP1_HOSTNAMEに設定した論理ホストのJP1/IM - Managerを停止しようとします。このコマンドは論理ホストに対応していないため，物理ホストのJP1/IM - Managerを停止する場合は，環境変数JP1_HOSTNAMEを削除してください。

jco_stopコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数が二つ以上指定されている，または停止要求がタイムアウトした

使用例1

JP1/IM - ManagerおよびIMデータベースサービスが起動している場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3675-I The stop command terminated normally.
KNAN11185-I Processing to stop the IM database service will now start.
KNAN11028-I Please wait.
KNAN11187-I The IM database service stopped normally.
KNAN11186-I Processing to stop the IM database service ended normally.
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.

使用例2

JP1/IM - Managerが起動している，およびIMデータベースサービスを起動していない場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3675-I The stop command terminated normally.
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.

使用例3

JP1/IM - ManagerおよびIMデータベースサービスが起動していない場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3662-I The process management is not running.
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.

使用例4

JP1/IM - Managerが起動していない，およびIMデータベースサービスが起動している場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3662-I The process management is not running.
KNAN11185-I Processing to stop the IM database service will now start.
KNAN11028-I Please wait.
KNAN11187-I The IM database service stopped normally.
KNAN11186-I Processing to stop the IM database service ended normally.
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.

jco_stop.cluster（UNIX限定）

機能

クラスタシステムで運用している場合に，論理ホスト上のJP1/IM - Managerを終了します。

論理ホスト上のIMデータベースサービスが起動している場合，JP1/IM - Managerを終了したあと，同じ論理ホスト上のIMデータベースを終了します。

このコマンドを実行するとJP1/IM - ManagerのプロセスおよびIMデータベースサービスが停止します。このコマンドを実行してもプロセスが停止しなかった場合，jco_killall.clusterコマンドでプロセスを強制終了してください。

このコマンドを実行するためには，JP1/IM - Managerのインストールとセットアップの完了後，jp1cc_setup_clusterおよびjp1cs_setup_clusterを実行する必要があります。また，IMデータベースサービスは，IMデータベースサービスのクラスタシステムをセットアップする必要があります。クラスタシステムのセットアップについては，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「8.　クラスタシステムでの運用と環境構築（UNIXの場合）」を参照してください。

形式

jco_stop.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定できる文字数は，1〜63バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

jco_stop.clusterコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数が二つ以上指定されている，または停止要求がタイムアウトした

jcoappexecfcheck（Windows限定）

機能

アプリケーション実行定義ファイルをチェックします。

このコマンドを実行すると，指定されたディレクトリのアプリケーション実行定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。

解析結果は次の形式で出力されます。

アプリケーション実行定義識別子,実行パス[,説明文]

解析結果には，システムで定義するアプリケーション実行定義識別子（セントラルコンソールで使用するデフォルトのWWWブラウザー定義である「"default_browser"」）が含まれます。

形式

jcoappexecfcheck アプリケーション実行定義ディレクトリ名

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

アプリケーション実行定義ディレクトリ名

チェックの対象となるアプリケーション実行定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名は指定できません。

使用例

次の定義ファイルに対してコマンドを実行した場合の例を示します。

@file type="application-execution-definition", version="0300";
@define-block type="application-execution-def";
id="notepad";
path="C:¥winnt¥system32¥notepad.exe";
@define-block-end;
@define-block type="application-execution-def";
id="dmp";
path="[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥NETM/DM/P¥0521/A¥PathName¥Path00]¥bin¥DMPSTS.exe";
@define-block-end;

解析結果は次のように出力されます。

"dmp","C:¥NETMDMP¥bin¥DMPSTS.exe"
"notepad","C:¥winnt¥system32¥notepad.exe"
"default_browser","C:¥Program Files¥Netscape¥Communicator¥Program¥netscape.exe"

jcoattrfcheck

機能

イベント拡張属性定義ファイルの記述内容をチェックします。

このコマンドを実行すると，指定されたディレクトリのイベント拡張属性定義ファイルの定義誤りがチェックされ，解析結果が標準出力に出力されます。定義誤りなどのエラー情報は，標準エラー出力に出力されます。

解析結果はCSV形式で出力されます。イベントIDごとに，次の情報を含んだ1行で出力されます。

プラットフォーム,イベントID,言語種別,プロダクト名,属性名,表示名,タイプ

注

「,属性名,表示名,タイプ」部分は，表示されるイベント属性の分だけ繰り返し出力されます。

イベント拡張属性定義ファイル（拡張ファイル）をチェックした場合，一部の項目は出力内容が固定となります。固定となる出力内容を次に示します。

表1‒28　拡張ファイルをチェックした場合の出力内容

項番

項目

出力内容

1

プラットフォーム

"base"

2

イベントID

"DEFAULT"

3

言語種別

extend_attr_ja.confをチェックした場合は，"japanese"

extend_attr_en.confをチェックした場合は，"english"

extend_attr_zh.confをチェックした場合は，"chinese"

4

プロダクト名

"/HITACHI/DEFAULT"

［イベント詳細］画面に出力されるJP1イベントの属性は，このコマンドで出力される解析結果に，基本属性および拡張属性の共通情報が付加されたものになります。

形式

jcoattrfcheck イベント拡張属性定義ディレクトリ名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

イベント拡張属性定義ディレクトリ名

チェックの対象となる拡張属性定義ファイルがあるディレクトリ名を指定します。ディレクトリ名は，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。

チェックの対象となるファイルは，拡張子が「.conf」で，ファイルタイプが「extended-attributes-definition」でなければなりません。

イベント拡張属性定義ファイル（拡張ファイル）をチェックする場合は，jcoattrfcheckコマンドの引数に指定するディレクトリの下にextendディレクトリを作成して，extendディレクトリの下に拡張ファイルを配置します。extendディレクトリの下にあるファイルは，拡張ファイルとしてチェックされます。

なお，拡張ファイルのチェックでは，JP1/IM - Managerに配置されている標準ファイルと，jcoattrfcheckコマンドの引数に指定したディレクトリに配置されている拡張ファイルを読み込み，指定されている拡張属性が重複しているかチェックします。拡張ファイルをチェックするときに読み込む標準ファイルのパスを次に示します。

Windowsの場合

Consoleパス¥conf¥console¥attribute¥default.conf

UNIXの場合

/etc/opt/jp1cons/conf/console/attribute/default.conf

jcochafmode（UNIX限定）

機能

イベント取得フィルターの位置をイベントコンソールサービスからイベント基盤サービスに変更します。

イベント取得フィルター（互換用）を使用している場合にこのコマンドを実行すると，JP1イベントの監視に加えて，自動アクションやセントラルスコープなどのほかの機能にも有効なフィルターとして動作させることができます。また，フィルター条件を詳細に定義できるようになります。ただし，イベント取得フィルター（互換用）のまま運用したい場合は，フィルター位置の変更は不要です。

なお，07-00以前のイベント取得フィルターで設定した内容，またはイベント取得フィルター（互換用）で設定した内容は，次の表で示すとおりに引き継がれます。運用に合わせて設定内容，条件群名を変更してください。

表1‒29　イベント取得フィルター設定項目の引き継ぎ

jcochafmodeコマンド実行前の設定

jcochafmodeコマンド実行後

設定なし

何も設定のない「既存条件群」に引き継がれる。

イベントIDだけ設定

「既存条件群」に引き継がれる。

重大度だけ設定

「既存条件群」に引き継がれる。

JP1/SESイベントだけ設定

「既存条件群_SES」に引き継がれる。

JP1/SESイベント，イベントIDを設定

JP1/SESイベント，イベントID※の設定が「既存条件群_SES」として引き継がれる。

イベントID※の設定が「既存条件群」として引き継がれる。

重大度，イベントIDを設定

「既存条件群」に引き継がれる。

JP1/SESイベント，重大度を設定

JP1/SESイベントの設定は「既存条件群_SES」として引き継がれる。

重大度の設定は「既存条件群」として引き継がれる。

JP1/SESイベント，重大度，イベントIDを設定

JP1/SESイベント，イベントID※の設定が「既存条件群_SES」として引き継がれる。

重大度，イベントID※の設定が「既存条件群」として引き継がれる。

注※

イベントIDの設定は条件群両方に引き継がれます。

形式

jcochafmode [-h 論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1cons/bin/

注　このコマンドは，Linux版のJP1/IM - Managerには同梱されていません。

引数

-h 論理ホスト名

イベント取得フィルター（互換用）の論理ホスト名を指定します。このオプションを省略した場合，物理ホストを仮定します。クラスタシステムを使用していない場合には指定は不要です。

注意事項

このコマンドを実行してイベント取得フィルターの位置および定義内容を変更する場合は，イベント取得フィルターを変更する対象ホストのJP1/IM - Managerを必ず停止してください。JP1/IM - Managerを停止していない状態でこのコマンドを実行したときは，エラーとなります。

このコマンドを何度も実行した場合は，すでに変換されているイベント取得フィルターが上書きされ，カスタマイズした条件定義が破棄されます。このコマンドは，イベント取得フィルターを変換するときに1回だけ実行してください。

一度変換したイベント取得フィルターを，バージョンアップ前のイベント取得フィルターまたはイベント取得フィルター（互換用）として（フィルターの位置および定義内容を）元に戻すことはできません。

バージョン07-10以降のイベント取得フィルターは，イベント取得フィルター（互換用）に変換できません。

JP1/IM - Managerを新規にインストールした場合，このコマンドを実行する必要はありません。

このコマンドを実行してイベント取得フィルターの位置をイベント基盤サービスに変更すると，以後そのフィルターは相関イベント発行機能にも適用されるようになります。

戻り値

0

正常終了

1

異常終了

使用例

論理ホストhost01のイベント取得フィルター（互換用）を，イベント基盤サービス上で動作するイベント取得フィルターに変換する。

jcochafmode -h host01

出力例1

イベント取得フィルターを変更する対象ホストのJP1/IM - Managerが停止されている場合

KAVB1005-I コマンド（jcochafmode）を開始しました
KAVB0836-I イベント取得フィルタを互換から通常モードに切り替えました
KAVB1002-I コマンド（jcochafmode）が正常終了しました

出力例2

イベント取得フィルターを変更する対象ホストのJP1/IM - Managerが停止されていない場合

KAVB1005-I コマンド（jcochafmode）を開始しました
KAVB0831-E JP1/IM - Managerが起動しています
KAVB1003-I コマンド（jcochafmode）が異常終了しました

jcochcefmode

機能

JP1/IM - Managerの共通除外条件の動作モードを変更するコマンドです。このコマンドを実行すると，共通除外条件を基本モードから拡張モードに変更したり，拡張モードから基本モードに変更したりできます。拡張モードから基本モードに切り替えた場合，共通除外条件および追加共通除外条件は，基本モードの共通除外条件に引き継がれません。共通除外条件を拡張モードに変更する場合は，JP1/Baseの正規表現が拡張されている必要があります。JP1/Baseの正規表現を拡張するための設定手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

-mオプションを指定してこのコマンドを実行する場合は，JP1/IM - Managerが停止している必要があります。停止していないときに実行すると，エラー終了し，メッセージが表示されます。

また，このコマンドは複数を同時に実行できません。

なお，共通除外条件がすでに設定されている場合でも共通除外条件を拡張モードに変更できます。

次の場合に共通除外条件拡張定義ファイルのバックアップファイルがcommon_exclude_filter_backup.confとして出力されます。

動作モードを基本モードから拡張モードに変更した場合で正規表現に問題があるとき

動作モードを拡張モードから基本モードに変更した場合

バックアップファイルの出力先を次に示します。

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥filter¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥filter¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/filter/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/filter/

拡張モードで使用できない正規表現があった場合，エラーメッセージが表示され，拡張モードの共通除外条件が設定されていない状態になります。出力されたファイルを編集し直して，jcochfilterコマンドの-efオプションでJP1/IM - Managerに反映してください。

共通除外条件拡張定義ファイルについては，「共通除外条件拡張定義ファイル」（2.　定義ファイル）を参照してください。

jcochfilterコマンドについては，「jcochfilter」（1.　コマンド）を参照してください。

形式

jcochcefmode [-m {normal | extended}]
             [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-m {normal | extended}

共通除外条件の動作モードを指定します。

normal：共通除外条件の動作モードを基本モードにしたい場合に指定します。デフォルトは，normalです。

動作モードを拡張モードから基本モードに戻した場合は，基本モードの共通除外条件の定義は空になります。拡張モードで使用していた共通除外条件の定義はバックアップファイルとして保存されます。また，追加共通除外条件の定義はすべて削除されます。バックアップファイルについては，「機能」を参照してください。

extended：共通除外条件の動作モードを拡張モードにしたい場合に指定します。基本モードで使用していた共通除外条件の定義は，拡張モードの共通除外条件の定義に引き継がれます。なお，共通除外条件を拡張モードに変更する場合は，JP1/Baseの正規表現が拡張されている必要があり，JP1/Baseの正規表現を拡張するとJP1/Baseの正規表現を使用する機能に影響があります。JP1/Baseの正規表現の拡張については，マニュアル「JP1/Base 運用ガイド」を参照してください。

normalまたはextendedは大文字・小文字を区別しません。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応する動作モードを，JP1/IM - Managerの共通除外条件に設定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

環境変数JP1_HOSTNAMEにJP1_DEFAULTや存在しない論理ホストを設定した場合，エラーメッセージが表示されます。

注意事項

-mオプションを指定しなかった場合，共通除外条件の動作モードを表示します。

次のどちらかまたは両方の状態の場合，拡張モードを使用できません。

イベント取得フィルター（互換用）を使用している

マネージャーホストのJP1/Baseで，拡張正規表現を使用していない

-hオプションを使用して論理ホストの共通除外条件の動作モードを変更する場合，共有ディスクがマウントされている必要があります。

クラスタシステムで運用している場合は，実行系サーバから待機系サーバに共通定義情報をコピーする必要があります。

手順については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「7.7.2　コマンドでの設定変更（Windowsの場合）」または「8.7.2　コマンドでの設定変更（UNIXの場合）」を参照してください。

jcochcefmodeコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

異常終了

2

引数エラー

3

JP1/IM - Managerが起動している

4

拡張モードの前提条件を満たしていない，またはイベント取得フィルターが互換用で動作している

5

拡張モードの前提条件を満たしていない，またはJP1/Baseの正規表現が拡張されていない

6

現在の動作モードと同じ動作モードを指定している

7

jcochcefmodeコマンドの実行権限がない（Windows限定）

8

共通除外条件拡張定義ファイルのバックアップに失敗した

9

論理ホストの指定が不正である

10

同時実行エラー

255

その他のエラー

使用例1

動作モードを基本モードに変更する場合

入力値

jcochcefmode -m normal

結果

KAVB1005-I コマンド（jcochcefmode）を開始しました
KAVB0895-I 共通除外条件の動作モードを基本モードに変更しました
KAVB1002-I コマンド（jcochcefmode）が正常終了しました

使用例2

動作モードを拡張モードに変更する場合

入力値

jcochcefmode -m extended

結果

KAVB1005-I コマンド（jcochcefmode）を開始しました
KAVB0896-I 共通除外条件の動作モードを拡張モードに変更しました
KAVB1002-I コマンド（jcochcefmode）が正常終了しました

使用例3

共通除外条件の動作モードを確認する場合（この例の場合，物理または論理ホストのホスト名はhostA，動作モードは拡張である）

入力値

jcochcefmode

結果

KAVB1005-I コマンド（jcochcefmode）を開始しました
KAVB0894-I 共通除外条件の動作モードを表示します(ホスト名:hostA)
動作モード            : 拡張モード
KAVB1002-I コマンド（jcochcefmode）が正常終了しました

jcochfilter

機能

JP1/IM - Managerのイベント基盤サービス，および相関イベント発行機能で有効となっているイベント取得フィルターを，指定したフィルターIDのイベント取得フィルターに切り替えるためのコマンドです。また，指定した共通除外条件を有効または無効にすることもできます。

イベント取得フィルターのフィルターID，フィルター名，共通除外条件群の共通除外条件群ID，および共通除外条件群名を一覧で表示することもできます。

指定したホストのJP1/IM - Managerが起動していない場合，およびイベント取得フィルター（互換用）の場合は使用できません。

また，共通除外条件が拡張モードの場合に，次の操作を実行できます。

拡張モードの共通除外条件を，条件群単位で有効・無効に設定できる

共通除外条件定義ファイルを読み込み，拡張モードの共通除外条件の定義を一括で反映できる

共通除外条件定義ファイルを読み込み，拡張モードの共通除外条件の定義内容をチェックできる

定義した追加共通除外条件群を，条件群単位で有効・無効に設定できる

形式1

jcochfilter [-i フィルターID]
            [-e [共通除外条件群ID[,共通除外条件群ID...]|ALL]]
            [-on 共通除外条件群ID[,共通除外条件群ID...]]※
            [-off 共通除外条件群ID[,共通除外条件群ID...]]※
            [-ef 共通除外条件拡張定義ファイル名]※
            [-h 論理ホスト名]

注※　拡張モードの共通除外条件の場合に指定できます。

形式2

jcochfilter -check 共通除外条件拡張定義ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-i フィルターID

切り替えて使用するイベント取得フィルターのフィルターIDを指定します。

このオプションは，-efおよび-checkオプションと同時に指定できません。

-e [共通除外条件群ID,共通除外条件群ID...]|ALL

有効にしたい共通除外条件群のIDを指定します。指定しなかったIDの共通除外条件は無効になります。共通除外条件が拡張モードの場合，追加共通除外条件群IDを指定できます。複数指定する場合は，コンマで区切ります。すべての共通除外条件を有効にしたい場合は，ALLを指定します。

共通除外条件群IDには次の値が指定できます。

基本モードの場合：0〜29

拡張モードの場合：0〜2,499

なお，-eのあとに何も指定しなかった場合は，すべての共通除外条件が無効になります。追加共通除外条件群IDの場合は，Aを付けた数値を指定します。

このオプションと同時に指定できるのは，-iおよび-hオプションだけです。

-on 共通除外条件群ID[,共通除外条件群ID...]

有効にしたい拡張モードの共通除外条件のIDまたは追加共通除外条件のIDを指定します。このオプションは，共通除外条件が拡張モードの場合に設定できます。拡張モードの共通除外条件のIDを複数指定する場合は，コンマで区切ります。共通除外条件群IDには次の値が指定できます。

基本モードの場合：0〜29

拡張モードの場合：0〜2,499

追加共通除外条件群IDの場合は，Aを付けた数値を指定します。

このオプションは，-e，-ef，および-checkオプションと同時に指定できません。

-off 共通除外条件群ID[,共通除外条件群ID...]

無効にしたい拡張モードの共通除外条件のIDまたは追加共通除外条件のIDを指定します。このオプションは，共通除外条件が拡張モードの場合に設定できます。拡張モードの共通除外条件のIDを複数指定する場合は，コンマで区切ります。共通除外条件群IDには次の値が指定できます。

基本モードの場合：0〜29

拡張モードの場合：0〜2,499

追加共通除外条件群IDの場合は，Aを付けた数値を指定します。

このオプションは，-e，-ef，および-checkオプションと同時に指定できません。

-ef 共通除外条件拡張定義ファイル名

JP1/IM - Managerに反映したい共通除外条件拡張定義ファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは，共通除外条件が拡張モードの場合に設定できます。

このオプションを指定すると，共通除外条件拡張定義ファイルに記載されている拡張モードの共通除外条件の定義内容をJP1/IM - Managerに一括で反映できます※。

追加共通除外条件群が設定されている場合，すべて削除されます。このオプションと同時に指定できるのは，-hオプションだけです。

注※　定義内容に環境依存文字など文字化けする文字が含まれている場合は反映できません。

-check 共通除外条件拡張定義ファイル名

定義内容に環境依存文字など文字化けする文字が含まれているかも含めて，共通除外条件拡張定義ファイルに記載されている拡張モードの共通除外条件の定義内容が正しいかどうかをチェックするオプションです。

JP1/IM - Managerに反映したい共通除外条件拡張定義ファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは，ほかのオプションと同時に指定できません。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。このオプションは，-checkオプションと同時に指定できません。

注意事項

-h以外のオプションを指定しなかった場合，次の内容を一覧で表示します。

適用中のイベント取得フィルターのフィルターIDとフィルター名

適用中の共通除外条件群IDと共通除外条件群名

設定されているイベント取得フィルターのフィルターIDとフィルター名

設定されている共通除外条件群IDと共通除外条件群名

共通除外条件の動作モードが拡張モードの場合，拡張モードの共通除外条件のIDと共通除外条件群名

指定したホストのJP1/IM - Managerが起動していない場合，およびイベント取得フィルターが互換用の場合は，jcochfilterコマンドは実行できません。

jcochfilterコマンドを同時に実行した場合，タイミングによってエラーとなることがあります。

jcochfilterコマンドを大量に同時実行すると，マネージャーの性能が低下したり，タイムアウトが発生したりすることがあります。

jcochfilterコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数エラー

2

JP1/IM - Manager（セントラルコンソール）と接続できない（通信エラー）

3

JP1/IM - Managerの起動状態が確認できない

4

一定時間内にJP1/IM - Managerからの応答がない

5

イベント取得フィルターが互換用で動作している

6

JP1/IM - Managerからのエラー

7

-iオプションで指定したフィルターIDが存在しない

8

jcochfilterコマンドの実行権限がない（Windows限定）

9

イベント取得フィルターの最大長を超えている

10

-eオプションで指定した共通除外条件が存在しない

11

-onオプション，または-offオプションで指定した共通除外条件群（拡張）が存在しない

12

共通除外条件群（拡張）が使用できない（設定が拡張モードではない）

13

共通除外条件群（拡張）の定義反映に失敗した

14

共通除外条件群（拡張）の定義内容に誤りがある

255

その他のエラー

使用例1

論理ホストhostA上のイベント取得フィルターの一覧を表示する場合

jcochfilter -h hostA

使用例2

論理ホストhostA上のイベント取得フィルターをフィルターIDが3のフィルターに変更する場合

jcochfilter -i 3 -h hostA

使用例3

論理ホストhostA上のイベント取得フィルターの共通除外条件群（ID：0，2）を有効にし，それ以外を無効にする場合

jcochfilter -e 0,2 -h hostA

jcochstat

機能

重要イベントの対処状況を示す情報を変更します。

このコマンドは，-hで指定したホストのイベントDBにアクセスし，-nで指定した通し番号のJP1イベントの重要イベント対処状況を変更します。

対処状況を変更すると，同じマネージャーにログインしているほかのJP1/IM - Viewでも対処状況の表示が変更されます。対処状況を変更するJP1イベントがほかのホストから転送されてきた場合やほかのホストに転送する設定がされている場合，転送元および転送先のホストでの対処状況は変更されません。

なお，このコマンドを使えば，［イベントコンソール］画面の［重要イベント］ページに表示されていないJP1イベントの対処状況も変更できますが，この場合，その変更を確認するには次の方法を取る必要があります。

対処状況を変更したJP1イベントが［イベントコンソール］画面の［イベント監視］ページに表示されている場合：［イベント監視］ページで確認する。

対処状況を変更したJP1イベントが［イベントコンソール］画面の［イベント監視］ページに表示されていない場合：イベント検索で確認する。

このコマンドは，JP1/IM - Managerが稼働する環境で使用できます。

形式

jcochstat [-h マネージャーホスト名]
          {-k 重要イベント対処状況キー | -d |
           -k 重要イベント対処状況キー -d}
           -n イベントDB内通し番号1[,...,イベントDB内通し番号100]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h マネージャーホスト名

重要イベントが登録されているイベントDBがあるマネージャーを指定します。ホスト名，ドメイン名，およびIPv4アドレスを指定できます。このオプションを省略した場合は，自ホストを仮定します。クラスタシステムでの運用時に，このオプションを省略した場合は，コマンドを実行した物理ホスト名を仮定します。指定したマネージャー上のJP1/IM - Managerが起動していないと，エラーになります。

マネージャーホスト名は255文字以内の文字列で指定してください。

なお，マネージャーホスト名に他ホストのマネージャーを指定する機能は，バージョン6互換用です。

-k 重要イベント対処状況キー

重要イベントの対処状況を表すキー値を入力します。-nオプションで指定した重要イベントの対処状況が，指定したキーが示す対処状況に変更されます。また，JP1/IM - Viewで表示した場合，対処状況マークが変更されます。

重要イベント対処状況キーは大文字と小文字を区別します。

-kオプションと-dオプションは，どちらか一方または両方を指定してください。-kオプションと-dオプションを両方指定した場合は，対処状況を変更したあと，JP1/IM - Viewの画面からイベントを削除します。-kオプションと-dオプションは同時に省略できません。

表1‒30　重要イベント対処状況キー

キー値

対処状況

JP1/IM - Viewに表示される対処状況マーク

PROCESSED

対処済

PROCESSING

処理中

HELD

保留

UNPROCESSED

未対処

（無印）

-d

-nオプションで指定した重要イベントを［イベントコンソール］画面の［重要イベント］ページから削除します。イベントDBからは削除されません。

削除したイベントを［重要イベント］ページに再度表示することはできません。

-kオプションと-dオプションは，どちらか一方または両方を指定してください。

-kオプションと-dオプションを両方指定した場合は，対処状況を変更したあと，［イベントコンソール］画面の［重要イベント］ページからイベントを削除します。-kオプションと-dオプションは同時に省略できません。

-n イベントDB内通し番号

対処状況を変更したい重要イベントのイベントDB内通し番号を指定します。このオプションは省略できません。

イベントDB内通し番号は，最大100個指定できます。複数指定する場合は，通し番号と通し番号の間をコンマで区切ります。コンマの前後に空白を指定できません。

指定できる値は，0〜2,147,483,647の10進数整数です。

戻り値

0

正常終了

1

引数エラー

2

ネットワーク障害

3

イベントDBの更新に失敗した

4

指定できないキーを指定している

5

更新できないイベントを指定した

7

コマンドを実行する権限がない（Windowsの場合）

255

その他のエラー

使用例

マネージャーhost01上のイベントDBに登録されている，イベントDB内通し番号が35のイベントおよび400のイベントを，対処状況を対処済に変更したあと，画面から削除します。

jcochstat -h host01 -k PROCESSED -n 35,400 -d

jcodbsetup

機能

JP1イベントを格納する統合監視DB領域を作成するセットアップコマンドです。データベースのサイズ，ポート番号，およびデータベース格納先は，セットアップ情報ファイルに指定しておく必要があります。

Windowsの場合，IM構成管理DBがセットアップされていない環境でこのコマンドを実行すると，次のサービスがOSに登録されます。

物理ホストのセットアップ時：JP1/IM-Manager DB Server，JP1/IM-Manager DB Cluster Service

クラスタ構成のセットアップ時：JP1/IM-Manager DB Server_論理ホスト名，JP1/IM-Manager DB Cluster Service_論理ホスト名

UNIXの場合，IM構成管理DBがセットアップされていない環境でこのコマンドを実行すると，/etc/inittabファイルに，IMデータベースのパスを含むエントリーが追加されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストごとに追加されます。このコマンドを実行したときに追加された/etc/inittabファイルのエントリーを，削除，編集，またはコメントアウトしないでください。

形式

jcodbsetup  {-f セットアップ情報ファイル名|-s}
            [-h 論理ホスト名 -c {online|standby}]
            [-q]
            [-v 0]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-f セットアップ情報ファイル名

IMデータベースのインストール先フォルダや，データベース領域のサイズを記述したセットアップ情報ファイルを指定します。IM構成管理DBと統合監視DBがどちらもセットアップされていない場合は，必ずこのオプションを指定してください。IM構成管理DBがすでにセットアップ済みの場合にこのオプションを指定するときには，IM構成管理DBのセットアップ時に指定したセットアップ情報ファイルと同じファイルを指定してください。また，IM構成管理DBがすでにセットアップ済みの場合は，-sオプションを代わりに指定できます。その際，IM構成管理DBのセットアップ時に指定したセットアップ情報が用いられます。

-sオプションと同時に指定できません。また，-fオプションと-sオプションは同時に省略できません。

パスに空白を含む場合は，「"」で囲みます。クラスタ環境を構築する場合は，クラスタセットアップ情報ファイル名を指定してください。

-s

IM構成管理DBがセットアップされている場合は，-fオプションの代わりに指定できます。このオプションを指定した場合は，IM構成管理DBのセットアップ時に指定されたセットアップ情報の内容を参照して，統合監視DBをセットアップします。

IM構成管理DBがセットアップされていない場合，このオプションを指定すると，KNAN11193-Eメッセージが出力されます。

-fオプションと同時に指定できません。また，-sオプションと-fオプションは同時に省略できません。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応する統合監視DBをセットアップします。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-c {online|standby}

クラスタ構成の実行系および待機系のセットアップ種別を指定します。-hオプションを指定した場合は，必ずこのオプションを指定してください。

すでに同一ホストにIM構成管理DBをセットアップしている場合は，-cオプションにIM構成管理DBを作成したときと同じ値を指定してください。また，非クラスタ環境で，論理ホスト運用をする場合はonlineを指定してください。

online：実行系をセットアップする場合に指定します。

standby：待機系をセットアップする場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

-v 0

JP1/IM - Manager 09-00〜10-50のテーブルスキーマでバックアップした拡張用バックアップをリカバリーする場合に指定します。JP1/IM - Manager 11-00では，拡張用バックアップのバージョンとして，0を指定できます。

0を指定した場合，JP1/IM - Manager 09-00〜10-50と同じテーブルスキーマの統合監視DBをセットアップします。

-vオプションの指定を省略した場合，JP1/IM - Manager 11-00以降のテーブルスキーマで統合監視DBをセットアップします。

-cオプションにstandbyを指定している場合，-vオプションの指定は無視されます。

戻り値

0

正常終了

1

異常終了

注意事項

実行系と待機系のクラスタセットアップ情報ファイルの内容は同じにする必要があります。待機系をセットアップする場合，実行系で使用したクラスタセットアップ情報ファイルをコピーして使用してください。実行系と待機系で指定したファイル内容が異なっていた場合，待機系でアンセットアップしたあとに，クラスタセットアップ情報ファイルを実行系からコピーし，コマンドを再実行します。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後に一度アンセットアップしてから，コマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdistup，pdfmkfs，pddef，およびpdloadのプロセスが実行されていないことを確認し，jcodbunsetupコマンドを実行してからこのコマンドを再実行してください。

IM構成管理DBをセットアップ済みの場合，かつIMデータベースを使用している場合，JP1/IM-Managerサービスが停止している必要があります。

WindowsでIM構成管理DBを使用している場合，IMデータベースサービス（JP1/IM2-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

引数に指定する論理ホスト名とJP1/Baseの論理ホスト名が一致し，かつ論理ホスト名の名前解決ができることを確認してからコマンドを実行してください。

jcodbunsetup，またはjcfdbunsetupコマンドを実行してIMデータベースをアンセットアップした場合にjcodbsetupコマンドを実行するときは，jcodbsetupコマンドを実行する前にOSを再起動してください。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jcodbunsetup

機能

JP1イベントを格納する統合監視DBをアンセットアップするコマンドです。

このコマンドは，統合監視DBの使用を停止する場合，JP1/IM - Managerをアンインストールする場合，統合監視DBを再作成する場合，およびデータベースサイズを拡張する場合に実行します。IM構成管理DBをセットアップしている環境では，このコマンドを実行後もIM構成管理は使用できます。

Windowsの場合，IM構成管理DBがセットアップされていない環境でこのコマンドを実行すると，次のサービスが削除されます。

物理ホストのアンセットアップ時：JP1/IM-Manager DB Server，JP1/IM-Manager DB Cluster Service

クラスタ構成のアンセットアップ時：JP1/IM-Manager DB Server_論理ホスト名，JP1/IM-Manager DB Cluster Service_論理ホスト名

UNIXの場合，IM構成管理DBがセットアップされていない環境でこのコマンドを実行すると，jcodbsetupまたはjcfdbsetupコマンドが登録した，/etc/inittabファイルのエントリーが削除されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストに対応した処理だけ削除されます。

形式

jcodbunsetup [-h 論理ホスト名 -c {online|standby}]
             [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応する統合監視DBがアンセットアップされます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-c {online|standby}

クラスタ構成の実行系および待機系のアンセットアップ種別を指定します。-hオプションを指定した場合は，必ずこのオプションを指定してください。

online：統合監視DBのセットアップでonlineを指定した場合に指定します。

standby：統合監視DBのセットアップでstandbyを指定した場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。また，非クラスタ環境で，運用していた論理ホストの統合監視DBをアンセットアップする場合はonlineを指定してください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

IM構成管理DBを作成している環境で，データベースのサイズを拡張する場合は，このコマンドを実行後に，IM構成管理DBのアンセットアップコマンドを実行する必要があります。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後にコマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdirstプロセスが実行されていないことを確認してからこのコマンドを再実行してください。

Windowsの場合，サービスが次の状態である必要があります。

物理ホストの場合

IMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service）が停止していて，IMデータベースサービス（JP1/IM2-Manager DB Server）が開始している必要があります。また，IM構成管理DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM2-Manager）が停止している必要があります。

論理ホストの場合

論理ホストのIMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service_論理ホスト名）が停止していて，論理ホストのIMデータベースサービス（JP1/IM2-Manager DB Server_論理ホスト名）が開始している必要があります。また，IM構成管理DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM2-Manager_論理ホスト名）が停止している必要があります。

UNIXの場合，IM構成管理DBがセットアップ済み，かつIMデータベースを使用しているとき，JP1/IM-Managerサービスが停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jcoegschange

機能

相関イベント発行定義を変更するコマンドです。相関イベント発行機能の状態が停止，相関稼働，および機能停止のどの状態のときでも実行できます。なお，起動処理中および停止処理中は実行できません。

jcoegschangeコマンドを実行する場合の注意事項を次に示します。

jcoegschangeコマンドで相関イベント発行定義を変更すると，即時に変更後の定義が有効になります。定義が有効になった時点で，相関イベントの発行処理中のJP1イベントがあった場合，すべて不成立となります。

jcoegschangeコマンド実行時，相関イベント発行定義ファイルに条件が1件も定義されていなかった場合，相関イベント発行条件がない状態で動作します。つまり，相関イベントは発行されません。

相関イベント発行機能が相関稼働状態の場合，jcoegschangeコマンドで変更しようとした相関イベント発行定義に不正があると，定義が変更されずに処理が続行されます。

相関イベント発行機能が起動していない場合は，相関イベント発行定義の設定だけが行われます。相関イベント発行機能を起動すると，相関イベント発行定義の設定が有効になります。

jcoegschangeコマンドは，jcoegsstatusコマンド（-dオプション指定）と同時に実行できません。

形式

jcoegschange [-h 論理ホスト名]
             -f 相関イベント発行定義ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-f 相関イベント発行定義ファイル名

相関イベント発行定義ファイル名を，相対パスまたは絶対パス形式で指定します。

戻り値

0

相関イベント発行定義の変更に成功した

1

相関イベント発行定義の変更に失敗した

2

相関イベント発行サービス（統合監視DBを使用しない場合），またはイベント基盤サービス（統合監視DBを使用する場合）との通信がタイムアウトした

100

実行権限エラー（Windows限定）

101

引数エラー

102

通信エラー

255

その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）の相関イベント発行定義を，相関イベント発行定義ファイル（/tmp/teigi1.conf）に定義した内容に変更する場合

入力値

jcoegschange -f /tmp/teigi1.conf

結果

KAJV3201-I 相関イベント発行定義ファイル（/tmp/teigi1.conf）を読み込み，hostPの相関イベント発行機能に反映しました

相関イベント発行機能に対して，相関イベント発行定義が1件も設定されていない場合でも同様の出力結果になります。

jcoegscheck

機能

相関イベント発行定義ファイルの定義内容をチェックするコマンドです。

相関イベント発行定義ファイル内の定義不正や，冗長な定義内容をチェックアウトします。

形式

jcoegscheck -f 相関イベント発行定義ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-f 相関イベント発行定義ファイル名

相関イベント発行定義ファイル名を，相対パスまたは絶対パス形式で指定します。

戻り値

0

相関イベント発行定義ファイルの定義内容が正常だった

1

相関イベント発行定義ファイルの定義内容が不正だった

100

実行権限がない（Windows限定）

rootに対してだけ実行権限を与える（UNIX限定）

101

引数エラー

255

その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）で相関イベント発行定義ファイル（/tmp/teigi1.conf）の定義内容をチェックする場合

入力値

jcoegscheck -f /tmp/teigi1.conf

結果（定義内容が正常だった場合）

KAJV3311-I 相関イベント発行定義ファイル（/tmp/teigi1.conf）の内容をチェックします
KAJV3312-I 相関イベント発行定義ファイル（/tmp/teigi1.conf）の内容に誤りは見つかりませんでした

結果（定義内容に不正があった場合）

KAJV3311-I 相関イベント発行定義ファイル（/tmp/teigi1.conf）の内容をチェックします
KAJV3313-E 相関イベント発行定義に不正な定義があります
KAJV3314-E 相関イベント発行定義ファイル（/tmp/teigi1.conf）の記載内容に間違いがあります。行番号:5 不正内容:相関イベント発行条件名が指定されていません
KAJV3314-E 相関イベント発行定義ファイル（/tmp/teigi1.conf）の記載内容に間違いがあります。行番号:25 不正内容:1つの相関イベント発行条件に指定されているイベント条件数が最大数を超えています

jcoegsstart

機能

相関イベント発行機能の状態を，機能停止から相関稼働に移行します。相関イベント発行機能は相関稼働状態になると，相関イベント発行定義に従って処理を開始します。

jcoegsstartコマンドは，相関イベント発行機能の状態をjcoegsstopコマンドで機能停止にしたあとにだけ使用します。停止している相関イベント発行機能の起動はできません（サービスの起動および停止は，プロセス管理(jco_spmd)によって制御されます）。

jcoegsstartコマンドで状態の移行に成功すると，JP1イベント（00003F25）が発行されます。JP1イベント（00003F25）については，「3.2.2　JP1イベントの詳細」を参照してください。

jcoegsstartコマンドの実行時に相関イベント発行機能が相関稼働状態だった場合，状態は変更されません。

形式

jcoegsstart [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

戻り値

0

相関イベント発行機能の再開に成功した

1

相関イベント発行機能の再開に失敗した

2

相関イベント発行機能との通信がタイムアウトした

100

実行権限がない（Windows限定）

UNIXの場合は，rootに対してだけ実行権限を与える

101

引数エラー

102

通信エラー

255

その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）の相関イベント発行機能を再開する場合

入力値

jcoegsstart

結果

KAJV3291-I hostPの相関イベント発行機能を再開しました

jcoegsstatus

機能

相関イベント発行機能の状態，および起動オプションを表示するコマンドです。オプションの指定によって，現在使用している相関イベント発行定義，および相関イベント発行定義を反映した日時を表示することもできます。

形式

jcoegsstatus [-h 論理ホスト名]
             [-d]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-d

-dオプションを指定すると相関イベント発行機能の状態，および起動オプションに加えて，現在使用している相関イベント発行定義，およびjcoegsstatusコマンドでの相関イベント発行定義の反映日時を表示します。

-dオプションを指定したjcoegsstatusコマンドはjcoegschangeコマンドと同時に実行できません。

出力形式

WindowsおよびUNIX（環境変数LANGがC以外）の場合

jcoegsstatusコマンドを実行すると，相関イベント発行機能の状態は次の形式で表示されます。

KAJV3261-I hostPの相関イベント発行サービスの状態を表示します

相関イベント発行機能 : 状態

起動オプション : 起動オプション

-dオプションを指定した場合は次の形式で表示されます。

KAJV3261-I hostPの相関イベント発行サービスの状態を表示します

相関イベント発行機能 : 状態

起動オプション : 起動オプション

KAJV3281-I hostPの相関イベント発行定義を表示します

ファイル名 : ファイルの絶対パス

反映日時 : YYYY/MM/DD hh:mm:ss

VERSION=0002

# コメント

[発行条件名]

TARGET=相関の対象範囲の絞り込み条件

CON=イベント条件

SAME_ATTRIBUTE=同一属性値条件

CORRELATION_NUM=同時相関数

TIMEOUT=タイムアウト時間

TYPE=イベント相関タイプ

SUCCESS_EVENT=相関イベント情報

UNIX（環境変数LANGがC）の場合

jcoegsstatusコマンドを実行すると，相関イベント発行機能の状態は次の形式で表示されます。

KAJV3261-I The status of the correlation event generation service for ホスト名 will now be displayed.

Correlation event generation function : 状態

Start option : 起動オプション

-dオプションを指定した場合は次の形式で表示されます。

KAJV3261-I The status of the correlation event generation service for ホスト名 will now be displayed.

Correlation event generation function : 状態

Start option : 起動オプション

KAJV3281-I The correlation event generation definition for ホスト名 will now be displayed.

File name : ファイルの絶対パス

Reflection time : YYYY/MM/DD hh:mm:ss

VERSION=0002

# コメント

[発行条件名]

TARGET=相関の対象範囲の絞り込み条件

CON=イベント条件

SAME_ATTRIBUTE=同一属性値条件

CORRELATION_NUM=同時相関数

TIMEOUT=タイムアウト時間

TYPE=イベント相関タイプ

SUCCESS_EVENT=相関イベント情報

状態に表示される文字列について次に説明します。

表1‒31　状態に表示される文字列

状態に表示される文字列

動作状態

説明

STARTING

起動処理中

相関イベント発行機能が起動処理を実行している状態。

RUNNING

相関稼働

相関イベント発行機能が起動していて，相関イベントの発行処理ができる状態。

次の場合にこの状態となる。

相関イベント発行機能が起動した場合。

相関イベント発行機能の状態が機能停止で，jcoegsstartコマンドを実行した場合。

STANDBY

機能停止

相関イベント発行機能は起動しているが，相関イベントの発行処理が停止している状態。

機能停止中に発生したJP1イベントに対して相関イベントの発行処理はしない。

また，機能停止から相関稼働になった場合でも，機能停止中に発生したJP1イベントに対して相関イベントの発行処理はしない。

備考

機能停止前に発行処理中だった相関イベントは機能停止後に不成立になる。

STOPPING

停止処理中

相関イベント発行機能が停止処理をしている状態。

STOP

停止

相関イベント発行機能が停止している状態。

起動オプションに表示される文字列について次に説明します。

表1‒32　起動オプションに表示される文字列

起動オプションに表示される文字列

起動オプション

説明

cold

coldスタート

前回停止時に相関イベントの発行処理中であった情報を引き継がない。

warm

warmスタート

前回停止時に相関イベントの発行処理中であった情報を引き継ぐ。

相関イベント発行定義ファイルの形式については，「相関イベント発行定義ファイル」（2.　定義ファイル）を参照してください。

戻り値

0

状態の表示に成功した

1

状態の表示に失敗した

2

相関イベント発行機能との通信がタイムアウトした

100

コマンドを実行する権限がない（Windowsの場合）

101

引数エラー

102

通信エラー

255

その他の異常終了（システムエラー）

使用例1

物理ホスト（hostP）の相関イベント発行機能の状態を表示する場合（状態：相関稼働，起動オプション：cold）

入力値

jcoegsstatus

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : RUNNING
起動オプション              : cold

使用例2

物理ホスト（hostP）の相関イベント発行機能の状態および相関イベント発行定義を表示する場合（状態：相関稼働，起動オプション：cold）

入力値

jcoegsstatus  -d

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : RUNNING
起動オプション              : cold

KAJV3281-I  hostPの相関イベント発行定義を表示します
ファイル名  :  /tmp/teigi1.conf
反映日時  :  2005/11/05 20:35:30

VERSION=2
[CONDITION]
TARGET=B.SOURCESERVER==host1;host2;host3
CON=CID:1, B.ID==100, E.SEVERITY==Emergency;Critical;Alert;Error
SAME_ATTRIBUTE=B.SOURCESERVER
CORRELATION_NUM=20
SUCCESS_EVENT=B.ID:A00, E.SEVERITY:Emergency, B.MESSAGE:$EV1_B.MESSAGE

使用例3

物理ホスト（hostP）の相関イベント発行機能の状態および相関イベント発行定義を表示する場合（状態：機能停止，起動オプション：warm）

なお，次の条件がある。

JP1/IM - Managerの新規インストール時

相関イベント発行定義ファイルが設定されていないため，KAJV3283-Iが出力される。

入力値

jcoegsstatus  -d

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : STANDBY
起動オプション              : warm

KAJV3283-I  hostPの相関イベント発行定義は定義されていません

使用例4

物理ホスト（hostP）の相関イベント発行機能の状態および相関イベント発行定義を表示する場合（状態：停止(プロセスダウン)，起動オプション：cold）

入力値

jcoegsstatus  -d

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : STOP
起動オプション              : cold

KAJV3281-I  hostPの相関イベント発行定義を表示します
ファイル名  :  /tmp/teigi1.conf
反映日時  :  2005/11/05 20:35:30

VERSION=2
[CONDITION]
TARGET=B.SOURCESERVER==host1;host2;host3
CON=CID:1, B.ID==100, E.SEVERITY==Emergency;Critical;Alert;Error
SAME_ATTRIBUTE=B.SOURCESERVER
CORRELATION_NUM=20
SUCCESS_EVENT=B.ID:A00, E.SEVERITY:Emergency, B.MESSAGE:$EV1_B.MESSAGE

使用例5

イベント相関機能の起動時に不正な相関イベント発行定義ファイルを読み込んだ場合

入力値

jcoegsstatus  -d

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : RUNNING
起動オプション              : cold

KAJV3281-I  hostPの相関イベント発行定義を表示します
ファイル名  :  /tmp/teigi1.conf
反映日時  :  2005/11/05 20:35:30

KAJV3285-I  hostPの相関イベント発行定義に不正があるため，不正な相関イベント発行条件を無視して動作しています

[CONDITION]
CON=CID:1, B.ID==ZZZ                ・・・※メッセージIDが不正
SUCCESS_EVENT=B.ID:A00, E.SEVERITY:Emergency, B.MESSAGE:$EV1_B.MESSAGE

jcoegsstop

機能

相関イベント発行機能の状態を，相関稼働から機能停止に移行します。相関イベント発行機能は機能停止状態になると，相関イベントの発行処理を停止します。

jcoegsstopコマンドは，相関イベント発行機能を停止させずに，相関イベントの発行処理だけを休止したい場合に使用します。なお，相関イベント発行機能の状態を相関稼働に戻したい場合，jcoegsstartコマンドを実行するか，JP1/IM - Managerを再起動してください。

jcoegsstopコマンドで状態の移行に成功すると，JP1イベント（00003F26）が発行されます。JP1イベント（00003F26）については，「3.2.2　JP1イベントの詳細」を参照してください。

形式

jcoegsstop [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

注意事項

相関イベントの発行処理中にこのコマンドを実行した場合，発行処理中の相関イベントはすべて不成立になります。

相関イベント発行機能の状態が機能停止の間に発行されたJP1イベントは，相関イベントの発行処理の対象外になります。

jcoegsstopコマンドの実行時に相関イベント発行機能が機能停止状態だった場合，状態は変更されません。

戻り値

0

相関イベント発行機能の停止に成功した

1

相関イベント発行機能の停止に失敗した

2

相関イベント発行機能との通信がタイムアウトした

100

実行権限がない（Windows限定）

UNIXの場合は，rootに対してだけ実行権限を与える

101

引数エラー

102

通信エラー

255

その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）の相関イベント発行機能を停止する場合

入力値

jcoegsstop

結果

KAJV3301-I hostPの相関イベント発行機能を停止しました

jcoevtreport

機能

統合監視DBに登録しているJP1イベントの情報をCSV形式にしてファイルに出力するコマンドです。このコマンドは，複数を同時に実行できません。

jcoevtreportコマンドは，統合監視DBを無効にしている場合またはセントラルコンソールが停止している場合でも，IMデータベースサービスが起動していれば，JP1イベントの情報をCSV形式にしてファイルに出力できます。

重要

jcoevtreportコマンドは統合監視DBのイベントを取得するため，JP1/IM - Viewからのイベント検索，対処状況変更，およびJP1/IM - Managerのイベント取得処理に影響します。このため，イベントが大量に発生している場合にjcoevtreportコマンドを実行したとき，JP1/IM - ViewやJP1/IM - Managerのほかの処理が遅延し，運用に影響を及ぼすことがあります。jcoevtreportコマンドを実行する場合は，運用に影響を及ぼさない時間帯に実行することをお勧めします。

CSVの出力形式については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.15.2　統合監視DBのイベント情報を保管（イベントレポート出力）」を参照してください。

定義を誤った場合や，ファイルサイズの最大値を超えた場合などのエラー情報は，標準エラー出力に出力されます。

出力する機能の説明を次の表に示します。

機能

説明

イベントレポート出力

統合監視DBに登録しているJP1イベントの情報をCSV形式にしてファイルに出力する機能

保守情報出力

統合監視DBで障害が発生した場合に出力対象始点日から出力対象終点日までに登録されたJP1イベントのすべての情報をイベントレポート出力する機能

保存出力

統合監視DBからJP1イベントの情報が削除される前に，イベントレポート出力を利用して保存する機能

保存出力状態表示

統合監視DB内の保存出力していないJP1イベントの割合（統合監視DBの最大件数との比率）と容量，および削除警告通知位置を表示する機能

形式

イベントレポート出力
jcoevtreport [-h 論理ホスト名]
             [-o 出力ファイル名]
              -s 出力対象始点日 -e 出力対象終点日
             [-user]
             [-f イベントレポート出力のフィルターファイル名]
             [-k イベントレポート出力の項目ファイル名]
             [-t {ON|OFF}]
             [-a {EVTATTR|DISP}]
保守情報出力
jcoevtreport [-h 論理ホスト名]
             [-o 出力ファイル名]
              -s 出力対象始点日 -e 出力対象終点日
              -sys
保存出力
jcoevtreport [-h 論理ホスト名]
             [-o 出力ファイル名]
              -save
             [-t {ON|OFF}]
             [-a {EVTATTR|DISP}]
保存出力状態表示
jcoevtreport [-h 論理ホスト名]
              -showsv

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定された論理ホストで稼働している統合監視DBからJP1イベントの情報を取得し，イベントレポート出力，保守情報出力，保存出力，または保存出力状態表示をします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-o 出力ファイル名

統合監視DBから取得したJP1イベントの情報をCSV形式にして出力するファイル名を，相対パスまたは絶対パス形式で指定します。

ファイル名が「-」で始まるファイルを指定する場合は，オプション指定との区別をするため，「-」で始まらないように，ディレクトリを含む相対パス（「./-hoge」など）や絶対パス形式で指定してください。指定できるファイル名は，パスを含めて250バイト以内です。

ただし，Windowsの場合，次に示す文字列はファイル名には指定できません。

「:」，「?」，「"」，「<」，「>」，「|」の文字。

CON，PRN，AUX，NUL，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9のどれかと完全一致する（小文字も含む）文字列。

指定した出力ファイル名と実際に作成されるファイル名の関係を次に示します。

統合監視DBのイベント情報がCSV形式で「出力ファイル名_通し番号.csv」が出力されます。通し番号は，000から999までの数字です。1ファイルに出力するイベントの情報は最大50,000件です。すでに同じファイル名が存在する場合は，上書きしないで，存在しない番号まで繰り上げて作成します。通し番号が999を超えた場合は，ファイルを出力しないで，終了します。オプションを省略した場合は，カレントディレクトリにjcoevtreport_通し番号.csvが出力されます。

カレントディレクトリ（「.」）やルートディレクトリ（「/」）をファイル名に指定した場合，次の対処となります。

-oの引数

Windows

UNIX

.

カレントに「._xxx.csv」が作成される。

カレントに「_xxx.csv」が作成される。

/

ルートに「_xxx.csv」が作成される。

ルートに「_xxx.csv」が作成される。

""(空文字)

カレントに「_xxx.csv」が作成される。

引数不足エラー。

-s 出力対象始点日

出力するイベントの始点日をイベントの到着時刻で指定します。

指定形式はYYYYMMDDhhmmssで指定します。

指定可能な日時の範囲は，（GMT）1970/01/01 00:00:00 〜 2038/01/19 03:14:07です。コマンド実行ホストのタイムゾーンが日本時間の場合，（GMT+9:00）1970/01/01 09:00:00 〜 2038/01/19 12:14:07となります。

-e 出力対象終点日

出力するイベントの終点日をイベントの到着時刻で指定します。

指定形式はYYYYMMDDhhmmssで指定します。

指定可能な日時の範囲は，-sオプションと同じです。

-k イベントレポート出力の項目ファイル名

イベントレポート出力の項目ファイル名を，相対パスまたは絶対パス形式で指定します。

ファイル名が「-」で始まるファイルを指定する場合は，オプション指定との区別をするため，「-」で始まらないように，ディレクトリを含む相対パス（「./-hoge」など），または絶対パス形式で指定してください。

イベントレポート出力の項目ファイルの形式については，「イベントレポート出力の項目ファイル」（2.　定義ファイル）を参照してください。

-f イベントレポート出力のフィルターファイル名

イベントレポート出力のフィルターファイル名を，相対パスまたは絶対パス形式で指定します。

ファイル名が「-」で始まるファイルを指定する場合は，オプション指定との区別をするため，「-」で始まらないように，ディレクトリを含む相対パス（「./-hoge」など），または絶対パス形式で指定してください。

イベントレポート出力のフィルターファイルの形式については，「イベントレポート出力のフィルターファイル」（2.　定義ファイル）を参照してください。

-t {ON|OFF}

登録時刻，到着時刻，および拡張属性の共通情報のSTART_TIMEとEND_TIMEを通算秒でなくYYYYMMDDhhmmss形式で出力します。

ON：登録時刻，到着時刻，および拡張属性の共通情報のSTART_TIMEとEND_TIMEを1970年1月1日からの通算秒の表記からYYYYMMDDhhmmssの西暦表示に変換したい場合に指定します。

OFF：西暦表示に変換しない場合に指定します。

このオプションの指定は，項目ファイルの指定より優先されます。

ONまたはOFFは，大文字・小文字を区別しません。

-a {EVTATTR|DISP}

ヘッダーの出力形式を指定します。-aオプションを省略した場合，ヘッダーは出力しません。

EVTATTRを指定すると表示形式が属性名（B.IDやE.SEVERITYなど）で出力し，DISPを指定すると項目（イベントIDや重大度など）で出力します。

EVTATTRまたはDISPは，大文字・小文字を区別しません。

-aオプションにDISPを指定した場合，環境変数LANGの設定値によって出力する文字列が異なります。なお，ヘッダーの文字列表示に使用される環境変数LANGは，Windowsの場合，ヘッダー文字列の言語はOSの言語になります。UNIXの場合，コマンドを実行するプロンプトの環境変数LANGになります。

また，イベント拡張属性定義ファイル（拡張ファイル）に固有の拡張属性と任意の項目名を指定すると，基本属性や共通の拡張属性と同じように，1件の属性に1つの列を割り当てて出力できます。ヘッダーについても，属性名や指定した項目名で出力できます。CSVの出力形式については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.15.2　統合監視DBのイベント情報を保管（イベントレポート出力）」を参照してください。

1件の固有の拡張属性に1つの列を割り当てて出力する機能は，イベントレポート出力環境定義ファイル（evtreport.conf）で有効にするかどうかを指定します。詳細については，「イベントレポート出力環境定義ファイル（evtreport.conf）」（2.　定義ファイル）を参照してください。

jcoevtreportコマンドが出力するヘッダーの文字列を次の表に示します。

表1‒33　jcoevtreportコマンドが出力するヘッダー文字列

-a EVTATTRの場合

-a DISPの場合

LANGが日本語

LANGが英語

B.SEQNO

イベントDB内通し番号

Serial number

B.ID

イベントID

Event ID

B.PROCESSID

発行元プロセスID

Source process ID

B.TIME

登録時刻

Registered time

B.ARRIVEDTIME

到着時刻

Arrived time

B.REASON

登録要因

Registered reason

B.USERID

発行元ユーザーID

Source user ID

B.GROUPID

発行元グループID

Source group ID

B.USERNAME

発行元ユーザー名

Source user name

B.GROUPNAME

発行元グループ名

Source group name

B.SOURCESERVER

登録ホスト名

Source event server name

B.DESTSERVER

送信先イベントサーバ名

Destination event server name

B.SOURCEIPADDR

発行元IPアドレス

Source IP address

B.DESTIPADDR

送信先IPアドレス

Destination IP address

B.SOURCESEQNO

発行元イベントDB内通し番号

Source serial number

B.CODESET

コードセット

Code set

B.MESSAGE

メッセージ

Message

E.SEVERITY

重大度

Event level

E.USER_NAME

ユーザー名

User name

E.PRODUCT_NAME

プロダクト名

Product name

E.OBJECT_TYPE

オブジェクトタイプ

Object type

E.OBJECT_NAME

オブジェクト名

Object name

E.ROOT_OBJECT_TYPE

登録名タイプ

Root object type

E.ROOT_OBJECT_NAME

登録名

Root object name

E.OBJECT_ID

オブジェクトID

Object ID

E.OCCURRENCE

事象種別

Occurrence

E.START_TIME

開始時刻

Start time

E.END_TIME

終了時刻

End time

E.RESULT_CODE

終了コード

Result code

E.JP1_SOURCEHOST

発生元ホスト名

Event source host

E.JP1_GENERATE_SOURCE_SEQNO

関連イベントDB内通し番号

Relation Event serial number

E.JP1_GENERATE_NAME

相関イベント発行条件名

Correlation event generation condition name

E.JP1_IMSUPPRESS_ID

監視抑止ID

Suppressed event ID

E.JP1_IMSUPPRESS_NAME

繰り返しイベント条件名

Repeated event condition name

E.JP1_TRAP_NAME

監視名

Monitoring target name

E.JP1_TRAP_ID

監視ID

Monitoring ID number

E.JP1_IMCOMEXCLUDE_ID

共通除外条件群ID

Common exclude conditions group ID

E.JP1_IMCOMEXCLUDE_NAME

共通除外条件群名

Common exclude conditions group name

E.JP1_IMCOMEXCLUDE_TARGET

共通除外条件群除外対象

Common exclude conditions group target-for-exclusion

E.@JP1IM_ACTTYPE

アクション種別

Action type

E.@JP1IM_ACTCONTROL

アクション

Action

E.@JP1IM_SEVERE

重要イベント

Severe Event

E.@JP1IM_CORRELATE

相関イベント

Correlation event

E.@JP1IM_RESPONSE

応答待ちイベント

Response-waiting event

E.@JP1IM_ORIGINAL_SEVERITY

重大度(変更前)

Original Severity Level

E.@JP1IM_CHANGE_SEVERITY

重大度変更

New Severity Level

E.@JP1IM_DEALT

対処状況

Event status

E.@JP1IM_RELEASE

重要イベント解除

Severe Event Released

E.@JP1IM_DISMISSED

重要イベント削除

Severe Event Deleted

E.@JP1IM_MEMO

メモ

Memo

E.@JP1IM_DISPLAY_MESSAGE

メッセージ(変更後)

Display Message

E.@JP1IM_CHANGE_MESSAGE

表示メッセージ変更

New Message

E.@JP1IM_CHANGE_MESSAGE_NAME

表示メッセージ変更定義名

Message change definition name

E.xxxxxxx※1

項目名※2

項目名※3

Program-specific extended attributes count

固有の拡張属性数※4

Program-specific extended attributes count

Program-specific extended attributes

固有の拡張属性

Program-specific extended attribute

注※1　イベント拡張属性定義ファイル（拡張ファイル）に指定した属性名が出力されます。

注※2　日本語のイベント拡張属性定義ファイル（拡張ファイル）に指定した項目名が出力されます。

注※3　英語のイベント拡張属性定義ファイル（拡張ファイル）に指定した項目名が出力されます。

注※4　イベント拡張属性定義ファイル（拡張ファイル）に指定していない固有の拡張属性の合計数が出力されます。

-user

統合監視DBに登録しているJP1イベントをイベントレポート出力します。

-userオプションは，省略できます。

-userオプションを指定しなくても，-sys，-save，-showsvを指定していなければイベントレポート出力を指定していることになります。

-sys

統合監視DBに登録しているJP1イベントを保守情報出力します。

-save

統合監視DB内の保存出力していないJP1イベントをすべて保存出力します。

-showsv

次の項目を表示します。

表示項目

内容

未出力イベントの割合

統合監視DB内の保存出力していないJP1イベントの割合（統合監視DBの最大件数との比率）をパーセンテージで表示します。

未出力イベントのサイズ

統合監視DB内の保存出力していないJP1イベントの統合監視DB内でのデータサイズを，メガバイト単位で表示します。

表示するサイズは，統合監視DB内でのデータサイズです。CSV出力には，表示された未出力イベントのサイズ×1.2の容量が必要となります。

削除警告通知設定

削除警告通知位置の設定値を表示します。

削除警告通知がOFFの場合は「-」（半角ハイフン）を表示します。

戻り値

0

正常終了

1

オプション・引数不正

2

フィルター不正

3

項目ファイル不正

4

レポート出力処理エラー

5

実行権限エラー（Windows限定）

6

同時実行エラー

7

出力ファイルの通し番号が上限値に達した

101

統合監視DBがセットアップされていない

102

IMデータベースサービスが起動していない

103

IMデータベースサービスとの接続エラーが発生した

254

メモリー不足が発生した

255

システムエラー

注意事項

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

使用例1

2008/06/01 12:00:00 〜 2009/01/01/00:00:00の間にマネージャーに到着したイベントを対象にレポート出力する場合

jcoevtreport -s 20080601120000 -e 20090101000000 -user

使用例2

出力先を「report_xxx.csv」に指定して2009/07/08 08:45:00 〜 2009/07/14 17:15:00のJP1イベントをイベントレポート出力する場合

jcoevtreport -s 20090708084500 -e 20090714171500 -o report

使用例3

出力先を「report_xxx.csv」に指定して2009/07/08 08:45:00 〜 2009/07/14 17:15:00のJP1イベントを保守情報出力する場合

jcoevtreport -sys -s 20090708084500 -e 20090714171500 -o report

使用例4

出力先を「report_xxx.csv」に指定して保存出力する場合

jcoevtreport -save -o report

使用例5

保存出力状態を表示する場合

jcoevtreport -showsv

jcofuncfcheck（Windows限定）

機能

このコマンドを実行すると，指定されたディレクトリのアプリケーション実行定義ファイルおよび統合機能メニュー定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。

解析結果は次の形式で出力されます。

Function tree definition

ツリー階層 "表示文字列" [,"実行コマンドパス"]

Function toolbar definition

row = 列

"表示文字列"[,"実行コマンドパス"]

注

「Function toolbar definition」以降の部分は，統合機能メニュー定義ディレクトリとして次のディレクトリが指定された場合にだけ表示されます。

Viewパス¥conf¥function¥ja

または

Viewパス¥conf¥function¥en

解析結果には，システムで定義するアプリケーション実行定義識別子（セントラルコンソールで使用するデフォルトのWWWブラウザー定義である「"default_browser"」）および統合機能メニュー識別子（機能ツリーの最上位ノードを表す「"root"」）が含まれます。

形式

jcofuncfcheck アプリケーション実行定義ディレクトリ名
              統合機能メニュー定義ディレクトリ名

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

アプリケーション実行定義ディレクトリ名

チェックの対象となるアプリケーション実行定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名は指定できません。

統合機能メニュー定義ディレクトリ名

チェックの対象となる統合機能メニュー定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名は指定できません。

使用例

次の定義ファイルに対してコマンドを実行した場合の例を示します。

アプリケーション実行定義ファイル

@file type="application-execution-definition", version="0300";
@define-block type="application-execution-def";
id="notepad";
path="C:¥winnt¥system32¥notepad.exe";
@define-block-end;
@define-block type="application-execution-def";
id="dmp";
path="[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥NETM/DM/P¥0521/A¥PathName¥Path00]¥bin¥DMPSTS.exe";
@define-block-end;

統合機能メニュー定義ファイル

@file type="function-definition", version="0300";
@define-block type="function-tree-def";
id="node1";
parent_id="root";
name="ノード1";
@define-block-end;
@define-block type="function-tree-def";
id="node11";
parent_id="node1";
name="ノード11";
icon="%JCO_INSTALL_PATH%¥image¥1206.gif";
execute_id="default_browser";
args="http://";
@define-block-end;
@define-block type="function-tree-def";
id="node2";
parent_id="root";
name="ノード2";
icon="%JCO_INSTALL_PATH%¥image¥1206.gif";
execute_id="notepad";
@define-block-end;
@define-block type="function-tree-def";
id="node3";
parent_id="root";
name="ノード3";
icon="%JCO_INSTALL_PATH%¥image¥1206.gif";
execute_id="dmp";
@define-block-end;

解析結果は次のように出力されます。

Function tree definition
  "統合管理"
   "ノード1"
     "ノード11","C:¥Program Files¥Netscape¥Communicator¥Program¥netscape.exe"
     "ノード2","C:¥winnt¥system32¥notepad.exe"
     "ノード3","C:¥NETMDMP¥bin¥DMPSTS.exe"
Function toolbar definition
  row=1
   "ノード11","C:¥Program Files¥Netscape¥Communicator¥Program¥netscape.exe"
   "ノード2","C:¥winnt¥system32¥notepad.exe"

jcogencore

機能

JP1/IM - Managerのプロセスで障害が発生したときに，ダンプを出力するためのコマンドです。なお，インテリジェント統合管理サービス（jddmain），セントラルスコープサービス（jcsmain）は除きます。また，jcogencoreコマンドを実行した場合は，JP1/IM - Managerを再起動する必要があります。

jcogencoreコマンドは，通常実行するコマンドではありません。プロセスがハングアップした場合や，サポートからの調査の過程で指示された場合に，実行してください。

障害の検知手段としてはJP1/IM - Managerのヘルスチェック機能を利用します（ヘルスチェック機能については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「8.2　JP1/IM - Managerのヘルスチェック機能」参照）。

jcogencoreコマンドを実行すると，どのプロセスの障害資料を出力するか問い合わせメッセージが表示されます。障害が発生したプロセスの資料を出力するようにします。jcogencoreコマンドを実行することで出力されるファイルを次の表に示します。

表1‒34　出力されるファイル

OS

プロセス名

出力されるファイルの名称

Javaスレッドダンプ

コアダンプ

Windows

evflow

javacoreプロセスID.XXXXXXXXXX.txt

−

jcamain

−

−

evtcon※1

javacoreプロセスID.XXXXXXXXXX.txt

−

evgen※1，※2

javacoreプロセスID.XXXXXXXXXX.txt

−

jcfmain

javacoreプロセスID.XXXXXXXXXX.txt

−

UNIX

evflow

javacoreプロセスID.XXXXXXXXXX.txt

core.evflow

jcamain

−

core.jcamain

evtcon※1

javacoreプロセスID.XXXXXXXXXX.txt

core.java

evgen※1，※2

javacoreプロセスID.XXXXXXXXXX.txt

core.evgen

jcfmain

javacoreプロセスID.XXXXXXXXXX.txt

core.jcfmain

core.プロセスID.jcfallogtrap

（凡例）

XXXXXXXXXX：OSが自動で割り当てる一意のID

−：出力しない

注※1

evtcon，およびevgenは機能名です。

注※2

統合監視DBを使用しない場合に使用される機能名です。

出力されたファイルは，次のフォルダに格納されます。

プロセス名がjcfmain以外の場合

Windowsの場合

物理ホスト：Consoleパス¥log¥

論理ホスト：共有ディスク¥jp1cons¥log¥

UNIXの場合

物理ホスト：/var/opt/jp1cons/log/

論理ホスト：共有ディスク/jp1cons/log/

プロセス名がjcfmainの場合

Windowsの場合

物理ホスト：Managerパス¥log¥imcf¥

論理ホスト：共有ディスク¥jp1imm¥log¥imcf¥

UNIXの場合

物理ホスト：/var/opt/jp1imm/log/imcf

論理ホスト：共有ディスク/jp1imm/log/imcf

出力したスレッドダンプおよびコアダンプは，資料採取ツールを使って，ほかの障害資料と合わせて採取してください。

また，このコマンドを実行したあとは，JP1/IM - Managerの再起動が必要です。

Windowsの場合

物理ホスト：コマンドを実行したあと，［コントロールパネル］−［管理ツール］−［サービス］で「JP1/IM-Managerサービス」を停止し，再起動してください。再起動後に，jco_spmd_statusコマンドでプロセスの起動状況を確認してください。

論理ホスト：コマンドを実行したあと，［コントロールパネル］−［管理ツール］−［サービス］で「JP1/IM-Manager_論理ホスト名サービス」を停止し，再起動してください。クラスタソフトで「JP1/IM-Manager_論理ホスト名サービス」を監視している場合は，クラスタソフトでサービスを再起動するか，フェールオーバーしてください。

UNIXの場合

物理ホスト：コマンドを実行したあと，指定したプロセスが強制的に停止します。一度，jco_stopコマンドですべてのプロセスを停止し，jco_startコマンドで再起動してください。再起動後に，jco_spmd_statusコマンドでプロセスの起動状況を確認してください。

論理ホスト：コマンドを実行したあと，指定したプロセスが強制的に停止します。一度，jco_stop.clusterコマンドですべてのプロセスを停止し，jco_start.clusterコマンドで再起動してください。クラスタソフトでJP1/IM - Managerを監視している場合は，クラスタソフトでJP1/IM - Managerを再起動するか，フェールオーバーしてください。

形式

jcogencore [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストのJP1/IM - Managerプロセスのスレッドダンプ，またはコアダンプを出力します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

注意事項

UNIXの場合，jcogencoreコマンドを実行すると，ダンプ出力後に指定したプロセスは強制的に停止します。プロセスがハングアップしたとき以外には実行しないでください。プロセスのハングアップはヘルスチェックで検知できます。

なお，クラスタシステムで運用中にjcogencoreコマンドを実行する場合は，注意してください。

UNIXでこのコマンドを実行する場合には，実行前にご使用のマシンの空き容量を確認してください。jcfmainを除く5プロセス分のコアダンプを出力した場合，コアダンプの容量は合計で最大8,419メガバイトになる場合があります。

また，jcfmainのコアダンプを出力した場合，コアダンプの容量は合計で最大「560＋230×jcfallogtrapプロセスの数」メガバイトになる場合があります。

複数のプロセスで障害が発生した場合は，次の順にコマンドを実行してください。

Windowsの場合：イベントコンソールサービス（evtcon），イベント基盤サービス（evflow）

UNIXの場合：イベントコンソールサービス（evtcon），アクション実行サービス（jcamain），イベント基盤サービス（evflow）

なお，相関イベント発行機能（evgen），IM構成管理サービス（jcfmain）はほかのプロセスと依存関係がないため，コマンドの実行順序は任意です。

UNIXの場合，OSの設定などでコアダンプファイルの生成を制限しているとjcogencoreコマンドの実行でもコアダンプファイルが生成されないことがあります。

コアダンプファイルに関する設定については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「2.17.5　JP1/IM - Managerの障害に備えた設定（UNIXの場合）」を参照してください。

戻り値

0

正常終了

1

オプション・引数解析エラー

2

プロセスチェックエラー

3

論理ホストエラー

4

実行権限エラー（Windows限定）

5

パイプ作成エラー（Windows限定）

6

スレッドダンプ出力処理エラー

10

その他のエラー

使用例1

Windowsで，物理ホストのイベントコンソールサービス（evtcon）プロセスがハングアップした場合

jcogencore

使用例2

Windowsで，論理ホストhostAのイベントコンソールサービス（evtcon）プロセスがハングアップした場合

jcogencore -h hostA

使用例3

UNIXで，物理ホストのイベントコンソールサービス（evtcon）プロセスがハングアップした場合

/opt/jp1cons/bin/jcogencore

出力例

UNIXで，物理ホストのイベントコンソールサービス（evtcon）プロセスがハングアップし，コアダンプおよびスレッドダンプを出力する場合

     ProcessName    PID
[1] : evflow        1234
[2] : jcamain       94320
[3] : evtcon        3333
[4] : evgen         65654
[6] : jcfmain       3316
[7] : Exit
KAVB8427-I When outputting dumps for the three processes evflow, jcamain, and evtcon at the same time, output the dumps in order of evtcon, jcamain, and evflow.
KAVB8417-I Please enter a number for the process to output the core dump file [1-7]:3
KAVB8414-I The thread dump output request has been sent.
KAVB8407-I When the core dump is output, evtcon will stop. Is this OK? (y/n):y
KAVB8406-I The core dump file will be output.
KAVB8416-I The core dump file has been output.

jcohctest

機能

JP1/IM - Managerのヘルスチェック機能で使用するヘルスチェック定義ファイル（jcohc.conf）の定義が正しく実行されるかをテストするコマンドです。ヘルスチェック定義ファイルに従い，通知コマンドの実行テストができます。

jcohctestコマンドは，JP1/IM - Managerが起動中にだけ実行できます。

ヘルスチェック定義ファイル（jcohc.conf）を変更した場合は，jcohctestコマンドを実行する前に，jco_spmd_reloadコマンドなどでヘルスチェック定義ファイルの設定を有効にする必要があります。

ヘルスチェック定義ファイルで指定した変数（HCHOST，HCFUNC，HCPNAME，HCPID，HCDATE，およびHCTIME）は，jcohctestコマンドでのテスト時には次のように表示されます。

表1‒35　jcohctestコマンド実行時に表示される値

変数名

jcohctestコマンド実行時に表示される値

HCHOST

物理ホスト名，または-h オプションで指定した論理ホスト名

HCFUNC

evflow

HCPNAME

evflow

HCPID

evflowのプロセスID

HCDATE

通知コマンドの実行日付（YYYY/MM/DD）

HCTIME

通知コマンドの実行時刻（hh:mm:ss）

ヘルスチェック定義ファイル（jcohc.conf）については，「ヘルスチェック定義ファイル（jcohc.conf）」（2.　定義ファイル）を参照してください。

形式

jcohctest [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホスト用のヘルスチェック定義ファイルで設定した通知コマンドをテストします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

戻り値

0

正常終了

1

引数エラー

2

論理ホストが存在しない

3

通知コマンド実行失敗

7

実行権限エラー（Windows限定）

10

その他のエラー

jcoimdef

機能

JP1/IM - Managerのシステム環境を設定，または設定値を参照します。

このコマンドを実行すると設定内容が標準出力に出力されます。

なお，-iオプションを指定して有効になる設定値については，-iオプションの説明を参照してください。

形式

jcoimdef  [-r {EXE | OUTPUT | OFF}]
          [-b イベント取得位置]
          [-s {ON | OFF}]
          [-egs {ON | OFF}]
          [-rulehost ホスト名]
          [-ruleuser ユーザー名]
          [-rule {ON | OFF}]
          [-resevent {ON | OFF}]
          [-e リトライ間隔]
          [-t タイムアウト時間]
          [-c リトライ回数:リトライ間隔]
          [-o リトライ回数:リトライ間隔]
          [-i]
          [-h 論理ホスト名]
          [-memo {ON | OFF}]
          [-chsev {ON | OFF}]
          [-db {ON | OFF}]
          [-dbntc {ON | OFF}]
          [-dbntcpos 削除警告通知位置]
          [-cf {ON | OFF}]
          [-cmdbtn {ON | OFF}]
          [-hostmap {ON | OFF}]
          [-bizmonmode {ON | OFF}]
          [-ignorecasehost {ON | OFF}]
          [-storm {ON | OFF}]
          [-dd {ON | OFF}]

-reseventオプションは，BJEXまたはJP1/ASと連携した場合に使用するオプションです。-reseventオプションの詳細については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「10.5.1　jcoimdef」を参照してください。

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

引数なし

現在の設定内容が，標準出力に一覧表示されます。

表示形式を，次に示します。

設定項目名=設定値

デフォルトの値が設定されている場合にこのコマンドを実行したときの出力内容を次に示します。各設定項目名の設定値は引数指定によって変更ができます。

図1‒1　jcoimdefコマンドの出力形式

-r {EXE | OUTPUT | OFF}

アクション実行サービスに対する設定です。アクション実行サービス起動時に次の状態となっているアクションに対する動作を指定します。

送信待機

送信待機（キャンセル中）

送信待機（キャンセル失敗）

送信中

送信中（キャンセル中）

送信中（キャンセル失敗）

キューイング

キューイング（キャンセル中）

キューイング（キャンセル失敗）

実行中

実行中（キャンセル中）

実行中（キャンセル失敗）

EXEを指定すると，上記の状態となっているアクションを再実行します。該当アクションの状態をjcashowaコマンド，アクション結果画面などで表示した場合，状態名に「-R」が付きます。

OUTPUTを指定すると，上記の状態となっているアクションの一覧をアクション再実行用ファイル（actreaction）に出力します。

該当アクションの状態をjcashowaコマンド，アクション結果画面などで表示した場合，状態名は「終了-R」と表示されます。

アクション再実行用ファイルには，次の形式でアクションごとに繰り返し出力されます。

###　日付※△時刻※△イベントID△イベントDB内通し番号　###［改行］

　　［u=実行ユーザー名］［e=環境変数ファイル名］［d=実行先ホスト名］

　　　実行コマンド［改行］

注※　日付と時刻は再実行機能が動作した時の日付と時刻になります。

OFFを指定すると，上記の状態となっているアクションに対して処理を行わず，その状態のままになります。

-b イベント取得開始位置

JP1/IM - Managerを起動した時に取得するイベントをいつから取得するかを指定します。指定できる値は，-1〜144です。

-1を指定すると，JP1/IM - Managerが前回停止したときの状態から処理を続行します。デフォルトでは，-1が設定されています。

例えば-1が指定されている状態で，JP1/IM - ManagerがイベントDB内通し番号12000のイベントまで受信していて，イベントがイベントバッファーにイベントDB内通し番号10001〜12000（2,000件）のイベントが格納されているときにJP1/IM - Managerを再起動したときの動作は次のようになります。

JP1/IM - Managerのイベントバッファー

前回停止したときにイベントバッファーに入っていたイベント（イベントDB内通し番号10001〜12000）を再度イベントバッファーに格納します。

自動アクション

イベントDB内通し番号12000の次のイベント(イベントDB内通し番号12001)から自動アクション処理の対象になります。自動アクション処理とは，イベントとアクション定義とのマッチング処理のことです。

0を指定すると，JP1/IM - Managerの起動後に登録されたイベントから，取得処理を開始します。

JP1/IM - Managerのイベントバッファー

起動後にイベントDBに登録されたイベントがイベントバッファーに格納されます。

自動アクション

起動後にイベントDBに登録されたイベントが自動アクション処理の対象になります。

1〜144を指定すると，JP1/IM - Managerの起動前に登録されたイベントを，指定された時間分さかのぼってイベントDBから取得します。

1〜144の単位は時間です。例えば，JP1/IM - Managerが起動する1時間前にさかのぼって，イベントを取得したい場合，1を指定します。

JP1/IM - Managerのイベントバッファー

起動時刻から指定された時刻をさかのぼり，その時刻以降にマネージャー上のイベントDBに登録されたイベントがイベントバッファーに格納されます。

自動アクション

起動時刻から指定された時刻をさかのぼり，その時刻以降にマネージャー上のイベントDBに登録されたイベントが自動アクション処理の対象になります。

ただし，一度自動アクション処理を行ったイベントは，自動アクション処理の対象にはなりません。つまり，一つのイベントに対して，アクションのマッチング処理は一度だけです。

どの場合でも，セントラルスコープサービスへ配信するイベントは自動アクションと同じになります。

-s {ON | OFF}

セントラルスコープサービスを起動し，かつセントラルスコープサービスにイベントを配信するようにするかどうかを指定します。

ONを指定すると，JP1/IM - Managerの起動時にセントラルスコープサービスが起動し，さらにセントラルスコープサービスにイベントが配信されるようになります。また，［イベントコンソール］画面の［セントラルスコープ起動］ボタンおよびメニューが活性となります。

OFFを指定すると，JP1/IM - Managerの起動時にセントラルスコープサービスが起動しないため，セントラルスコープサービスにイベントが配信されるようになりません。また，［イベントコンソール］画面の［セントラルスコープ起動］ボタンおよびメニューが非活性となります。デフォルトはOFFです。

-sの設定を有効にするには，接続中のJP1/IM - Viewも再起動が必要です。

-egs {ON | OFF}

相関イベント発行機能を有効にするかどうかを指定します。

ONを指定すると，JP1/IM - Managerの起動時に次の動作をします。

統合監視DBを使用しない場合，相関イベント発行サービスを起動します。

統合監視DBを使用する場合，イベント基盤サービスの相関イベント発行機能を有効にします。

OFFを指定すると，JP1/IM - Managerの起動時に次の動作をします。

統合監視DBを使用しない場合，相関イベント発行サービスを起動しません。

統合監視DBを使用する場合，イベント基盤サービスの相関イベント発行機能を無効にします。

デフォルトはOFFです。

-rulehost ホスト名

連携するJP1/IM - Rule Operationのホスト名を指定します。システム構成の定義で管理対象ホストに設定したホスト名を指定してください。255文字以内で，スペース，タブ，および制御文字を除くASCII文字で指定してください。また，ホストグループの指定はできません。ホスト名に「""」を指定した場合，空文字（なし）が設定されます。この場合，コマンドを実行しているホストを仮定します。

-ruleuser ユーザー名

連携するJP1/IM - Rule Operationを実行するJP1ユーザー名を指定します。31文字以内で，「* " ' / ¥ [ ] { } ( ) : ; | = , + ? < >」，スペース，タブ，制御文字を除くASCII文字で指定してください。ユーザー名に「""」を指定した場合，空文字（なし）が設定されます。この場合，次の順に優先して仮定されます。

自動アクション環境定義ファイル（action.conf.update）で設定した共通定義情報の"ACTIONEXECUSER"のJP1ユーザー

jp1admin

-rule {ON | OFF}

JP1/IM - ViewにJP1/IM - Rule Operation連携用の項目を表示するかどうかを指定します。

ONを指定すると，JP1/IM - Managerの起動時に，JP1/IM - ViewにJP1/IM - Rule Operation連携用の項目を表示する機能が有効になります。

OFFを指定すると，JP1/IM - Managerの起動時に，JP1/IM - ViewにJP1/IM - Rule Operation連携用の項目を表示する機能が無効になります。デフォルトはOFFです。

-ruleの設定を有効にするには，接続中のJP1/IM - Viewも再起動が必要です。

-resevent {ON | OFF}

応答待ちイベント管理機能を有効にするかどうかを指定します。

ONを指定すると，JP1/IM - Manager全体のイベントへの応答機能が有効になります。

OFFを指定すると，JP1/IM - Manager全体のイベントへの応答機能が無効になります。デフォルトはOFFです。このコマンドで設定した値は，JP1/IM - Managerを再起動した場合に有効になります。この場合，接続しているJP1/IM - Viewも再起動する必要があります。-iオプションまたはjco_spmd_reloadコマンドで，応答待ちイベント管理機能の有効・無効は反映できません。

-e リトライ間隔

イベント基盤サービスからイベントサービスへのイベント取得時に，イベントサービスに接続ができなかった，または接続が切断された場合に，自動的に再接続するリトライ間隔を指定します。指定できる値は，1〜86,400（単位：秒）です。イベント基盤サービスに対する設定です。

-t タイムアウト時間

イベント基盤サービスからセントラルスコープサービスまたはイベントコンソールサービスへのイベント配信処理が失敗した場合に，自動的に再配布するリトライ処理のタイムアウト時間を指定します。指定できる値は，1〜3,600（単位：秒）です。イベント基盤サービスは，セントラルスコープサービスまたはイベントコンソールサービスにイベント配信要求をし，このオプションで指定された時間内に応答がない場合は，応答がない制御に対してイベント配信を停止します。イベント基盤サービスに対する設定です。

-c リトライ回数:リトライ間隔

イベント基盤サービスからセントラルスコープサービスまたはイベントコンソールサービスへのイベント配信時に，セントラルスコープサービスまたはイベントコンソールサービスに接続ができなかった，または接続が切断された場合に，自動的に再接続するリトライ処理のリトライ回数とリトライ間隔を指定します。リトライ回数に指定できる値は0〜100（単位：回），リトライ間隔に指定できる値は0〜3,600（単位：秒）です。イベント基盤サービスに対する設定です。

-o リトライ回数:リトライ間隔

イベント基盤サービスからセントラルスコープサービスまたはイベントコンソールサービスへのイベント配信処理が失敗した場合に，自動的に再配布するリトライ処理のリトライ回数とリトライ間隔を指定します。リトライ回数に指定できる値は0〜100（単位：回），リトライ間隔に指定できる値は0〜3,600（単位：秒）です。イベント基盤サービスに対する設定です。

-i

各オプションで指定した値を有効にするために，有効にしたいオプションと一緒にこのオプションを指定します。このオプションを指定すると，一緒に指定したオプションで設定された値がイベント基盤サービスおよびアクション実行サービスに読み込まれて，有効になります。

-iオプションで直ちに反映できるオプションを次に示します。

-rulehostオプション

-ruleuserオプション

-eオプション

-tオプション

-cオプション

-oオプション

-memoオプション

-cmdbtnオプション

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストのJP1/IM - Managerのシステム環境を設定，または設定値を参照します。ただし，論理ホストでは，物理ホストのシステム環境が引き継がれます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-memo {ON | OFF}

メモ情報の設定機能を使用するかどうかを指定します。

統合監視DBが有効な場合にONを指定すると，メモ情報の設定機能が有効になります。OFFを指定すると，メモ情報の設定機能が無効になります。統合監視DBが無効な場合にONを指定しても，メモ情報の設定機能が無効になります。デフォルトはOFFです。

-chsev {ON | OFF}

重大度変更機能を使用するかどうかを指定します。

統合監視DBが有効な場合にONを指定すると，重大度変更機能が有効になります。OFFを指定すると，重大度変更機能が無効になります。統合監視DBが無効な場合にONを指定しても，重大度変更機能が無効になります。デフォルトはOFFです。

-db {ON | OFF}

イベント保管機能を使用するかどうかを指定します。

ON：イベント保管機能が有効になり，統合監視DBにイベントが保管されます。

OFF：イベント保管機能が無効になり，統合監視DBにイベントが保管されません。

統合監視DBが無効な場合にONを指定しても，イベント保管機能が無効になります。デフォルトはOFFです。

ONを指定する場合は，事前に統合監視DBをセットアップしてください。

統合監視DBがセットアップされていない，またはIMデータベースサービスが起動していない状態でJP1/IM - Managerを起動すると，イベント基盤サービスは統合トレースログにメッセージを出力して異常終了します。

-dbntc {ON | OFF}

統合監視DB内の保存出力していないJP1イベントの割合（統合監視DBの最大件数との比率）が削除警告通知位置を超えた場合，削除警告通知イベントを発行するかどうかを指定します。

ON：統合監視DB内で保存出力していないJP1イベントの割合が削除警告通知位置を超えたときに，削除警告通知イベントを発行します。

OFF：統合監視DB内で保存出力していないJP1イベントの割合が削除警告通知位置を超えても，削除警告通知イベントを発行しません。デフォルトはOFFです。

統合監視DBが無効な場合にONを指定しても，統合監視DB内の保存出力していないJP1イベントの割合が削除警告通知位置を超えていなければ，削除警告通知イベントを発行しません。

-dbntcpos 削除警告通知位置

削除警告通知イベントで通知する，統合監視DB内で保存出力していないJP1イベントの割合（統合監視DBの最大件数との比率）を%で指定します。

指定できる範囲は20〜80%です。デフォルト値は80です。

例えば，-dbntcpos 70と指定した場合，削除警告通知位置は70%になります。

-cf {ON | OFF}

IM構成管理サービスを起動するかどうかを指定します。

ON：JP1/IM - Managerの起動時にIM構成管理サービスを起動します。

OFF：JP1/IM - Managerの起動時にIM構成管理サービスを起動しません。デフォルトはOFFです。

ONを指定する場合は，事前にIM構成管理をセットアップしてください。

IM構成管理がセットアップされていない，またはIMデータベースサービスが起動していない状態でJP1/IM - Managerを起動すると，イベント基盤サービスは統合トレースログにメッセージを出力して異常終了します。

-cmdbtn {ON | OFF}

［コマンド実行］画面の［コマンド］ボタンを有効にするかどうかを指定します。

ON：［コマンド］ボタンを有効にします。有効にすると［コマンド実行］画面に［コマンド］ボタンが表示されます。デフォルトはONです。

OFF：［コマンド］ボタンを無効にします。無効にすると［コマンド実行］画面に［コマンド］ボタンは表示されません。

-hostmap {ON | OFF}

発生元ホストのマッピングを有効にするかどうかを指定します。

ON：発生元ホストのマッピングを有効にします。

OFF：発生元ホストのマッピングを無効にします。デフォルトはOFFです。

統合監視DBが無効な場合にONを指定しても，発生元ホストのマッピングが無効になります。

-bizmonmode {ON | OFF}

業務グループの参照・操作制限を有効にするかどうかを指定します。

ON：業務グループの参照・操作制限を有効にします。

OFF：業務グループの参照・操作制限を無効にします。デフォルトはOFFです。

統合監視DB，IM構成管理サービス，発生元ホストのマッピングのうちどれかが無効な場合にONを指定しても，業務グループの参照・操作制限が無効になります。

-ignorecasehost {ON | OFF}

ホスト名に関するイベント条件を比較するときに英大文字・英小文字を区別するかどうかを指定します。

ON：英大文字・英小文字を区別しません。ただし，比較キーワードに正規表現を使用している場合は区別します。

OFF：英大文字・英小文字を区別します。デフォルトはOFFです。

このオプションを有効にした場合に，ホスト名の大文字・小文字を区別しなくなる機能と属性の対応を次に示します。

表1‒36　機能とイベント条件の対応

機能

属性（イベント条件）

重要イベントフィルターでのフィルタリング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

イベント検索

検索対象が統合監視DBの場合

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

検索対象がイベントDBの場合

対応しない

イベント取得フィルター（拡張モードの共通除外条件）でのフィルタリング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

表示フィルターでのフィルタリング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

ユーザーフィルターでのフィルタリング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

自動アクション

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

繰り返しイベントの監視抑止

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

繰り返しイベントの集約表示

イベント条件を指定できないが，-ignorecasehostオプションの設定が反映される

相関イベントの発行

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

重大度の変更

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

メッセージの表示形式の変更

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

イベントレポート出力

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

発生元ホストのマッピング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

-storm {ON | OFF}

繰り返しイベントの監視抑止を有効にするかどうかを指定します。

ON：繰り返しイベントの監視抑止を有効にします。

OFF：繰り返しイベントの監視抑止を無効にします。デフォルトはOFFです。

統合監視DBが無効な場合にONを指定しても，繰り返しイベントの監視抑止が無効になります。

-dd {ON | OFF}

インテリジェント統合管理基盤サービスを起動するかどうかを指定します。

ON：JP1/IM - Managerの起動時にインテリジェント統合管理基盤サービスを起動します。

OFF：JP1/IM - Managerの起動時にインテリジェント統合管理基盤サービスを起動しません。デフォルトはOFFです。

ONを指定する場合は，事前に統合監視DBのセットアップが必要です。また，発生元ホストのマッピングを有効にしてください。

統合監視DBがセットアップされていない，発生元ホストのマッピングが無効，またはIMデータベースサービスが起動していない状態でJP1/IM - Managerを起動すると，インテリジェント統合管理基盤サービスは統合トレースログにメッセージを出力して異常終了します。

戻り値

0

正常終了

1

異常終了

7

実行権限エラー（Windows限定）

定義が有効になる契機

オプション

有効になる契機

JP1/IM - Managerの再起動時

jco_spmd_reloadコマンド実行時

-i指定時

-r

○

−

−

-b

○

−

−

-s

○※

−

−

-egs

○

−

−

-rulehost

○

○

○

-ruleuser

○

○

○

-rule

○※

−

−

-resevent

○※

−

−

-e

○

○

○

-t

○

○

○

-c

○

○

○

-o

○

○

○

-memo

○※

○※

○※

-chsev

○※

−

−

-db

○※

−

−

-dbntc

○

○

−

-dbntcpos

○

○

−

-cf

○

−

−

-cmdbtn

○

−

○※

-hostmap

○※

−

−

-bizmonmode

○※

−

−

-ignorecasehost

○※

−

−

-storm

○※

−

−

-dd

○

−

−

（凡例）

○：有効になる

−：該当しない

注※

接続中のJP1/IM - Viewの再起動が必要です。

jcomonitorfcheck

機能

モニター画面呼び出し定義ファイルをチェックします。

このコマンドを実行すると，指定されたモニター画面呼び出し定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。定義誤りなどのエラー情報は標準エラー出力に出力されます。

解析結果は，イベントID単位に次の形式で出力されます。

プロダクト名，イベントID

開始バージョン，終了バージョン

[サブキー名 ，キーとなる属性名

[キーとなる属性値, インターフェース名]]

[インターフェース名，アプリケーション実行定義識別子，

コマンド引数，置き換えイベント属性]

バージョンの指定が「0600」のように一つだけだった場合は，開始バージョンと終了バージョンに同じ値が出力されます。同様に，「ALL」を指定した場合も，開始バージョンと終了バージョンの両方に「ALL」が表示されます。

キー定義「DEF_KEY」に「SUBKEY」が設定された場合は，サブキーの内容が表示されます。「SUBKEY」は，ほかのキー定義「DEF_KEY」で使用されている場合でも重複して表示されます。

このコマンドでは，アプリケーション実行定義識別子がアプリケーション実行定義ファイルに定義されているかどうかはチェックしません。

形式

jcomonitorfcheck モニター画面呼び出し定義ディレクトリ名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

モニター画面呼び出し定義ディレクトリ名

チェックの対象となるモニター画面呼び出し定義ディレクトリ名を，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。

使用例

次の定義ファイルに対してコマンドを実行した場合の例を示します。

DESC_VERSION=0300
#AJS-View用モニター画面遷移定義ファイル
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004102 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004103 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004104 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004105 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004106 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004107 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004108 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004109 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004120 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004121 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004122 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004123 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004124 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004125 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=000041A7 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=000041A8 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=000041A9 INTERFACE=AJS2_MONITOR

DEF_MTR_CALL NAME=AJS2_MONITOR EXEC_ID=jco_JP1_AJS2 PATH="-j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%" PARAM=B.SOURCESERVER,E.A0,E.A1,E.A3

解析結果は次のようになります。

/HITACHI/JP1/AJS2, 41a9
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4109
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 41a8
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4108
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 41a7
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4107
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4106
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4125
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4105
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4124
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4104
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4123
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4103
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4122
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4102
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4121
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4120
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3

jcothreaddmp（Windows限定）

機能

JP1/IM - Viewで障害が発生したときに，スレッドダンプを出力するためのコマンドです。

jcothreaddmpコマンドを実行して出力したスレッドダンプは，次のフォルダに格納されます。

Viewパス¥log¥

出力したスレッドダンプは，資料採取ツールを使って，ほかの障害情報と合わせて採取してください。

形式

jcothreaddmp プロセスID

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

プロセスID

操作ができなくなったJP1/IM - Viewのjava.exeプロセスのプロセスIDを指定します。指定できるプロセスIDは一つだけです。プロセスIDの省略および複数指定はできません。

複数のJP1/IM - Viewを起動している場合は，タスクマネージャで操作ができなくなったJP1/IM - ViewのプロセスIDを識別してください。

JP1/IM - Viewはタスクマネージャ上でjava.exeと表示されます。このとき，同時に動作しているほかのjavaプログラムがあると，同様にjava.exeと表示されるため，識別が難しくなります。マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「11.4.1(2)　JP1/IM用スレッドダンプを出力する」を参照して，操作できなくなったJP1/IM - ViewのプロセスIDを識別してください。

注意事項

正常なJP1/IM - Viewに対して，jcothreaddmpコマンドを実行した場合は，JP1/IM - Viewの動作が不安定になることがあります。この場合には，JP1/IM - Viewを再起動してください。

戻り値

0

正常終了

1

オプションの解析エラー

2

プロセスのチェックエラー

3

スレッドダンプ出力要求の送信エラー

10

その他のエラー

jcovcfsetup（Windows限定）

機能

IM構成管理・ビューアーを起動するメニューをWindowsのスタートメニューに登録・削除するコマンドです。なお，IM構成管理・ビューアーはインストール時にWindowsのスタートメニューには登録されます。

このコマンドは，［管理者として実行］から起動したコマンドプロンプト上から実行したときだけ有効となります。

形式

jcovcfsetup [-i | -u]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Viewパス¥bin¥

引数

オプションを指定しない場合は，-iオプションを指定したときと同じ動作をします。

-i

IM構成管理・ビューアーを起動するメニューを登録します。

-u

IM構成管理・ビューアーを起動するメニューを削除します。

ただし，メニューの名称や，格納場所を手動で変更した場合，削除できません。この場合は手動で削除する必要があります。

注意事項

コマンドの引数で指定できる最大バイト数は，OSの制限に依存します。コマンドの引数は，各OSの制限内で指定します。

戻り値

0

正常終了

1

異常終了

使用例1

JP1/IM - Viewのメニューに，［構成管理］を追加する場合

jcovcfsetupまたはjcovcfsetup -i

使用例2

JP1/IM - Viewのメニューから［構成管理］を削除する場合

jcovcfsetup -u

jcoview（Windows限定）

機能

JP1/IM - Viewの画面を起動します。

オプション指定によって次のように起動する画面が異なります。

JP1/IM - Viewの［ログイン］画面の起動

-p，-eオプション以外のオプションを指定した場合，またはオプション指定なしの場合，［ログイン］画面が起動します。

-cオプション指定時：［ログイン］画面の［セントラルコンソール］チェックボックスがチェックされます。

-sオプション指定時：［ログイン］画面の［セントラルスコープ］チェックボックスがチェックされます。

-hオプション指定時：［ログイン］画面の「接続ホスト名」に値が入力されます。

-uオプション指定時：［ログイン］画面の「ユーザー名」に値が入力されます。

JP1/IM - Viewの［イベントコンソール］画面および［監視ツリー］画面の起動

-h，-u，-pオプションを指定した場合，［イベントコンソール］画面および［監視ツリー］画面が起動します。［イベントコンソール］画面および［監視ツリー］画面を起動する場合，-h，-u，-pオプションの指定は必須となります。

-cオプション指定時：［イベントコンソール］画面が起動します。

-sオプション指定時：［監視ツリー］画面が起動します。

-c，-sオプション指定なし：［イベントコンソール］画面が起動します。

JP1/IM - Viewの［監視ツリー(編集中)］画面の起動

-eオプションを指定した場合，［監視ツリー(編集中)］画面が起動します。

形式

jcoview [[[-c] [-s]]
         [-h 接続ホスト名] [-u ユーザー名] [-p パスワード]
         | -e]

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

-c

［イベントコンソール］画面を起動します。

パスワード（-pオプション）を省略した場合，［セントラルコンソール］チェックボックスがチェックされた状態で，［ログイン］画面が起動します。また，-eオプションと同時に指定できません。

このオプションは省略できます。

-h，-u，および-pオプションが指定されていて，かつ，-c，-s，または-eオプションのどれも指定されていない場合は，この-cオプションが指定されているものと仮定されます。

-s

［監視ツリー］画面を起動します。

パスワード（-pオプション）を省略した場合，［セントラルスコープ］チェックボックスがチェックされた状態で，［ログイン］画面が起動します。また，-eオプションと同時に指定できません。

このオプションは省略できます。

-h 接続ホスト名

接続先ホストのホスト名を指定します。指定できる文字数は，1〜255バイトです。JP1/IM - Managerが起動しているホストだけを指定できます。

接続先ホスト名には，次のものが指定できます。

コマンドを使用するホストで定義されているホスト名

コマンドを使用するホストでアドレス解決可能なホスト名

IPアドレス

IPアドレスを指定する場合，IPv4アドレス形式のアドレスだけ指定できます。IPv6アドレス形式のアドレスは指定できません。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-u ユーザー名

認証サーバに登録してあるJP1ユーザー名を指定します。指定できる文字数は，1〜31バイトです。半角英数字（英字は小文字）だけを使用できます。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-p パスワード

指定したユーザー名に対応するパスワードを指定します。指定できる文字数は，6〜32バイトです。半角英数字だけを使用できます。英字は，大文字・小文字が区別されます。

このオプションを指定する場合は，-hおよび-uオプションも指定する必要があります。

このオプションは省略できます。

-e

［監視ツリー(編集中)］画面を起動します。

このオプションを指定する場合は，ほかのオプションを指定しないでください。

このオプションは省略できます。

重要

jcoviewコマンドの引数に誤った値を指定し，JP1/IM - Viewを起動すると，「KAVB0104-E ユーザー認証に失敗しました」，または「KAVB1210-E 接続中に通信エラーが発生しました。ホスト名をIPアドレスに変換できません。ホスト名を確認してくださいホスト名：ホスト名, ポート番号：ポート番号 詳細情報：詳細情報」メッセージを出力後に［ログイン］画面が表示され，マウスでクリックしても，［ログイン］画面の入力フィールドを選択して入力できなくなる場合があります。この場合は，いったん，タスクバーでJP1/IM - View以外の画面をクリックした後，［ログイン］画面をクリックすると入力できる状態になります。

日本語で動作させる場合，コードページを932以外に設定しているコマンドプロンプトからjcoviewコマンドを実行すると，画面に表示される文字が文字化けする場合があります。

中国語で動作させる場合，コードページを936以外に設定しているコマンドプロンプトからjcoviewコマンドを実行すると，画面に表示される文字が文字化けする場合があります。

戻り値

0

正常終了

1

引数エラー

2

メモリー不足

3

リソースの取得に失敗

4

エラーメッセージの作成に失敗

255

システムエラー

使用例1

JP1/IM - Viewを起動して，［ログイン］画面を表示します。

jcoview

使用例2

JP1/IM - Viewを起動して，［ログイン］画面を表示します。［ログイン］画面の［接続ホスト名］にhost，［ユーザー名］にjp1adminが設定されます。

jcoview -h host -u jp1admin

使用例3

JP1/IM - Viewを起動して，ユーザーjp1admin，パスワードjp1adminで接続ホストhostにログインし，［イベントコンソール］画面を起動します。

jcoview -h host -u jp1admin -p jp1admin

使用例4

JP1/IM - Viewを起動して，ユーザーjp1admin，パスワードjp1adminで接続ホストhostにログインし，［監視ツリー］画面を起動します。

jcoview -s -h host -u jp1admin -p jp1admin

使用例5

JP1/IM - Viewを起動して，ユーザーjp1admin，パスワードjp1adminで接続ホストhostにログインし，［イベントコンソール］画面および［監視ツリー］画面を起動します。

jcoview -c -s -h host -u jp1admin -p jp1admin

使用例6

JP1/IM - Viewを起動して，［監視ツリー(編集中)］画面を起動します。

jcoview -e

使用例7

ホストやユーザーごとに，使用例2や使用例3などのコマンドのショートカットを作成できます。

jcoview_log.bat（Windows限定）

機能

JP1/IM - Viewで障害が発生したときに資料を採取するためのツールです。JP1/IM - Viewの保守資料，OSのシステム情報，統合トレースログなどを採取します。JP1/IM - ManagerおよびJP1/Baseが同一マシン上にインストールされている場合，JP1/IM - ManagerおよびJP1/Baseの資料も採取されます。

このツールは，バッチファイルです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料を採取する対象フォルダまたはファイルを一次資料および二次資料に区分けし，指定した資料格納フォルダの直下に採取した資料が格納されます。

一次資料は，障害時の切り分けや，軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は，一次資料ではわからなかった障害をさらに調査するための詳細資料です。Windowsイベントログを採取します。

また，JP1/IM - Viewのスレッドダンプがある状態でjcoview_log.batを実行すると，メッセージKAVB8946-Iを表示してスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」を入力した場合，スレッドダンプを削除します。

必要に応じて採取した資料を圧縮ツールなどで圧縮してください。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「11.3　トラブル発生時に採取が必要な資料」を参照してください。

資料格納フォルダの直下に格納された資料のフォルダ構成および資料内容を次に示します。

表1‒37　一次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥jp1_default¥imm_1st¥coview

JP1/IM - Viewのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥conf

JP1/IM - Viewの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥default

JP1/IM - Viewの共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥log

JP1/IM - Viewのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥oslog

OSのログ情報

資料格納フォルダ¥jp1_default¥imm_1st¥spool

32bit版の統合トレースログ

資料格納フォルダ¥jp1_default¥imm_1st¥spoolx64

64bit版の統合トレースログ

表1‒38　二次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥jp1_default¥imm_2nd¥oslog

Windowsイベントログ

形式

jcoview_log.bat -f 資料格納フォルダ
               [-t]
               [-q]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Viewパス¥tools¥

引数

-f 資料格納フォルダ

採取した資料を出力するフォルダ名をフルパスまたはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲んで指定します。このオプションは省略できません。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。すでに存在するフォルダを指定した場合は，いったんそのフォルダを削除してから，指定したフォルダが作成されます。

-t

hostsおよびservicesファイルを採取しない場合に指定します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

注意事項

JP1/IM - Managerと同一ホストで，JP1/IM - Viewの資料を採取する場合は，jim_log.batコマンドを実行してください。

このツールを複数同時に実行しないでください。資料が上書きされたり，採取できなかったりする場合があります。

採取するファイルが見つからない場合，「ファイルが見つかりません」などのメッセージが表示されることがありますが，対処の必要はありません。

戻り値

0

正常終了

8

異常終了

使用例

F:¥tmp¥batフォルダに資料を採取する場合

jcoview_log.bat -f F:¥tmp¥bat

出力結果は次のようになります。

KAVB8925-I The directory does not exists. ("F:¥tmp¥bat")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("F:¥tmp¥bat¥jp1_default¥imm_1st")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("F:¥tmp¥bat¥jp1_default¥imm_2nd")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8926-I Data acquisition processing will start.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" command will start.
KAVB8921-I The information for JP1/IM - View will be acquired.
KAVB8922-I The information for JP1/IM - View has been acquired.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8929-I The system information will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I The system information has been acquired.
KAVB8929-I "Watson log and crash dump" will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I "Watson log and crash dump" has been acquired.
KAVB8921-I Windows Eventlog(Application) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(Application) has been acquired.
KAVB8921-I Windows Eventlog(System) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(System) has been acquired.
KAVB8921-I The setup.ini of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ini of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ini of JP1/Base will be acquired.
KAVB8922-I The setup.ini of JP1/Base has been acquired.
KAVB8921-I The setup.ilg of JP1/Base will be acquired.
KAVB8922-I The setup.ilg of JP1/Base has been acquired.
KAVB8921-I The setup.ini of JP1/IM - View will be acquired.
KAVB8922-I The setup.ini of JP1/IM - View has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - View will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - View has been acquired.
KAVB8921-I The integrated trace log will be acquired.
KAVB8922-I The integrated trace log has been acquired.
KAVB8921-I The integrated installer log will be acquired.
KAVB8922-I The integrated installer log has been acquired.
KAVB8921-I The installer log file will be acquired.
KAVB8922-I The installer log has been acquired.
KAVB8921-I The hosts will be acquired.
KAVB8922-I The hosts has been acquired.
KAVB8921-I The services will be acquired.
KAVB8922-I The services has been acquired.
KAVB8921-I The registry information will be acquired.
KAVB8922-I The registry information has been acquired.
KAVB8921-I The netstat information will be acquired.
KAVB8922-I The netstat information has been acquired.
KAVB8921-I The ipconfig information will be acquired.
KAVB8922-I The ipconfig information has been acquired.
KAVB8921-I The net start information will be acquired.
KAVB8922-I The net start information has been acquired.
KAVB8921-I The set information will be acquired.
KAVB8922-I The set information has been acquired.
KAVB8918-I The data was successfully acquired.

jcschstat

機能

監視ノード（監視オブジェクトまたは監視グループ）の状態を変更します。また，監視ノードの状態変更イベントの履歴をクリアします。監視ノードの監視状態は変更できません。

障害発生時の回復処理としてバッチ処理でこのコマンドを含め，最後の処理として自動実行で監視ノードの状態を初期化したい場合，ヘルプデスクシステムと連携して障害を取り除いたあとに自動実行で監視ノードの状態を初期化したい場合に，使用できます。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

JP1/IM - Manager（セントラルスコープ）がすでに32個のコマンド要求を処理している最中に，このコマンドを実行した場合，サーバ側の通信が切断され，このコマンドの実行に失敗します。

形式

jcschstat [-h 論理ホスト名]
          -n 監視ノードID1,監視ノードID2,監視ノードID3...
          [-s 状態値]
          [-i]
          [-t タイムアウト時間]
          [-d]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-n 監視ノードID1,監視ノードID2,監視ノードID3...

状態変更の対象となる監視ノードID（監視オブジェクトIDまたは監視グループID）を指定します。監視ノードIDは，16進数で指定します。

監視ノードIDは複数指定，10個まで指定できます。複数指定する場合は，コンマ「,」で区切ってください。指定した監視ノードの順に監視ノードの状態が変わります。

-s 状態値

監視ノードの変更後の状態を指定します。状態値は大文字と小文字を区別します。監視オブジェクトはEmergency，Alert，Critical，Error，Warning，Normal，Debug，またはInitialを指定できます。監視グループはInitialだけ指定できます。

指定した監視ノードの状態を変更すると，上位ノードへ状態が伝播し，下位ノードを初期化します。

省略した場合，Initialが仮定されます。

-i

監視ノードの状態を変更する際に，確認メッセージを表示させたい場合に指定します。

-t タイムアウト時間

サーバとの通信時のタイムアウト時間を指定します。指定できる値は，1〜32,767（単位：秒）です。デフォルトは1,800秒（30分）です。

-d

このオプションを指定すると，-nオプションで指定した監視ノードが存在しない場合または監視ノードの状態変更に失敗した場合に，コマンド処理を中断し，エラー終了します。

省略した場合，存在しないまたは状態変更に失敗した監視ノードの処理をスキップし，次の監視ノード以降の処理を続行します。

戻り値

0

正常終了

1

論理ホスト名が存在しない

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

32

データアクセスエラー

33

監視ツリーIDまたは監視ノードIDがDB内に存在しない

37

サーバからの応答がない（コネクション要求が失敗した）

38

サーバとの通信が切断された（通信中にサーバが停止した，またはサーバ側の接続数が最大値を超えた）

39

タイムアウトが発生した（サーバに要求送信後，応答を受信するまでにタイムアウト時間を超えた）

40

サーバから不正な応答が送信された

42

ほかのコマンドまたはほかの要求が実行中

43

-nに非監視設定の監視ノードを指定している

44

-nに監視グループを設定している

99

その他のエラー

使用例

監視ノードID 8の状態をErrorに変更します。

jcschstat -n 8 -s Error

出力例

jcschstat -n 5 -s Normal
KAVB7630-I 監視ノード(5)の状態を正常に変更しました

jcsdbexport

機能

監視オブジェクトDBの保管情報を取得し，ツリー構成ファイルとしてローカルにファイル出力するコマンドです。ファイルに出力される情報は，監視ツリー構成情報，共通イベント監視条件，およびビジュアル監視画面構成情報です。

監視オブジェクトDBで保管情報を複数世代保存する場合に利用できます。また，監視オブジェクトDBの保管情報を別サーバに複製したい場合は，このコマンドを実行したあとにjcsdbimportコマンドで別サーバの監視オブジェクトDBに反映することもできます。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

セントラルスコープサービスのデータ更新中にこのコマンドを実行すると，エラー終了します。例えば，［監視ツリー(編集中)］画面からサーバのツリーを更新中の場合や，jcschstatコマンドで監視ノードの状態を変更中の場合に，このコマンドを実行するとエラー終了します。

08-10以降のJP1/IM - Managerで出力したツリー構成ファイルは，08-01以前のJP1/IM - Managerで読み込むことはできません。

形式

jcsdbexport [-h 論理ホスト名]
            -o ファイル名
            [-t タイムアウト時間]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-o ファイル名

ツリー構成情報の出力先となるファイルをフルパスで指定します。ファイル名の末尾は「.dat」と指定します。また，パスに空白を含む場合は，「"」で囲んで指定します。

-t タイムアウト時間

サーバとの通信時のタイムアウト時間を指定します。指定できる値は，10〜32,767（単位：秒）です。デフォルトは1,800秒（30分）です。

戻り値

0

正常終了

1

論理ホスト名が存在しない

2

引数エラー

3

指定したファイルが不正

4

コマンドを実行する権限がない

6

指定したファイルに対するアクセス権がない

12

メモリー不足

13

ディスク容量不足

31

サーバ側でDBの初期化失敗

32

サーバ側でDBへのアクセスに失敗

33

監視ツリーIDまたは監視ノードIDがDB内に存在しない

37

サーバからの応答がない（コネクション要求が失敗した）

38

サーバとの通信が切断された（通信中にサーバが停止した，またはサーバ側の接続数が最大値を超えた）

39

タイムアウトが発生した（サーバに要求送信後，応答を受信するまでにタイムアウト時間を超えた）

40

サーバから不正な応答が送信された

42

ほかのコマンドまたはほかの要求が実行中

99

その他のエラー

使用例

監視オブジェクトDBの保管情報をc:¥temp¥output.datに出力します。

jcsdbexport -o c:¥temp¥output.dat

出力例

KAVB7670-I ファイル(c:¥temp¥output.dat)への監視ツリー定義の出力に成功しました

jcsdbimport

機能

jcsdbexportコマンドでファイル出力した監視オブジェクトDBの保管情報（監視ツリー構成情報，共通イベント監視条件，およびビジュアル監視画面構成情報）をJP1/IM - Managerの監視オブジェクトDBに反映するためのコマンドです。

このコマンドは，jcsdbexportコマンドと併用して，ほかのサーバにJP1/IM - Managerの監視オブジェクトDBの保管情報を移行する際に利用します。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

セントラルスコープサービスのデータ更新中にこのコマンドを実行すると，エラー終了します。例えば，［監視ツリー(編集中)］画面からサーバのツリーを更新中の場合や，jcschstatコマンドで監視ノードの状態を変更中の場合に，このコマンドを実行するとエラー終了します。

形式

jcsdbimport [-h 論理ホスト名]
            -o ファイル名
            [-t タイムアウト時間]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-o ファイル名

JP1/IM - Managerの監視オブジェクトDBに反映させたい，jcsdbexportコマンドで出力したファイルをフルパスで指定します。ファイル名の末尾には「.dat」と指定します。パスに空白を含む場合は，「"」で囲んで指定します。

-t タイムアウト時間

サーバとの通信時のタイムアウト時間を指定します。指定できる値は，10〜32,767（単位：秒）です。デフォルトは1,800秒（30分）です。

注意事項

jcsdbimportコマンドでインポートすると，監視ツリーの状態が初期化されます。

戻り値

0

正常終了

1

論理ホスト名が存在しない

2

引数エラー

3

指定したファイルが不正

4

コマンドを実行する権限がない

6

指定したファイルに対するアクセス権がない

12

メモリー不足

31

サーバ側でDBの初期化失敗

32

サーバ側でDBへのアクセスに失敗

34

ツリー構成ファイルのフォーマットエラー

37

サーバからの応答がない（コネクション要求が失敗した）

38

サーバとの通信が切断された（通信中にサーバが停止した，またはサーバ側の接続数が最大値を超えた）

39

タイムアウトが発生した（サーバに要求送信後，応答を受信するまでにタイムアウト時間を超えた）

40

サーバから不正な応答が送信された

41

指定した入力ファイルが存在しない

42

ほかのコマンドまたはほかの要求が実行中

48

サーバが指定したファイルのファイルバージョンに対応していない

99

その他のエラー

使用例

jcsdbexportコマンドで出力したファイル（input.dat）を，JP1/IM - Managerの監視オブジェクトDBに反映します。

jcsdbimport -o input.dat

出力例

KAVB7660-I input.datファイルから監視ツリー定義のインポートに成功しました

jcsdbsetup

機能

監視オブジェクトDBを格納するISAMファイルを新規作成します。このコマンドを実行すると，既存の監視オブジェクトDBが削除され，新たに監視オブジェクトDBが作成されます。

監視オブジェクトDBを作成する際は，JP1/IM - Managerを停止してから実行してください。

セントラルスコープの機能を使用する場合には必ず実行してください。

形式

jcsdbsetup [-h 論理ホスト名]
           [-f]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-f

監視オブジェクトDBが存在する場合は必ず指定します（指定しない場合，エラーとなります）。監視オブジェクトDBが存在しない場合は省略できます。

このオプションを指定し，かつ，監視オブジェクトDBが存在する場合，確認メッセージ「データベースが存在しますが，再作成してよろしいですか？[Y/N]」が表示されます。「Y」を入力し，［Enter］キーを押すと，既存の監視オブジェクトDB削除後，監視オブジェクトDBが再作成されます。監視オブジェクトが存在しない場合は，確認メッセージの表示なしで監視オブジェクトDBが作成されます。

戻り値

0

正常終了

1

論理ホスト名が不正

2

引数エラー

4

コマンドを実行する権限がない

10

セットアップされていない

12

メモリー不足

13

ディスク容量不足

20

DBがすでに存在する

42

ほかのコマンドまたはほかの要求が実行中

99

その他のエラー

jcshostsexport

機能

ホスト情報DBに登録されたホスト情報を採取するコマンドです。このコマンドを実行すると，ホスト情報DBからホスト情報を読み出し，ホスト情報ファイル名にホスト情報を格納します（ホスト情報ファイル名を指定しなかった場合，標準出力に出力します）。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

形式

jcshostsexport [-h 論理ホスト名] > ホスト情報ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

ホスト情報ファイル名

ホスト情報を格納するファイル名を指定します。

戻り値

0

正常終了

1

論理ホスト名が不正

2

引数エラー

4

コマンドを実行する権限がない

10

セットアップされていない

11

ホスト情報DBがない

12

メモリー不足

14

ホスト情報DBが壊れている

15

メッセージの初期化失敗

16

ホスト情報DBが使用中

99

その他のエラー

jcshostsimport

機能

ホスト情報DBにホスト情報の登録，削除を行うコマンドです。JP1/IM - Manager稼働中の場合は，このコマンド実行後，jco_spmd_reloadコマンドを実行することでホスト情報の内容が有効になります。JP1/IM - Manager停止中の場合は，JP1/IM - Managerを起動することで有効になります。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

形式

jcshostsimport { { -o | -r } ホスト情報ファイル名 | -d}
               [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-r ホスト情報ファイル名

ホスト情報DBに登録したいホスト情報を定義したファイル名を指定します。-rオプションを指定した場合は，ホスト情報DBに登録済みのホスト情報をすべて削除してからホスト情報を登録します。

ホスト情報ファイルの記述形式については，「ホスト情報ファイル（jcs_hosts）」（2.　定義ファイル）を参照してください。

-o ホスト情報ファイル名

ホスト情報DBに登録したいホスト情報を定義したファイル名を指定します。-oオプションを指定した場合は，ホスト情報DBに登録済みのホスト情報を削除せずに，ホスト情報ファイルに記述したホスト情報を追加登録します（同一IPアドレスが存在した場合は上書きします）。

ホスト情報ファイルの記述形式については，「ホスト情報ファイル（jcs_hosts）」（2.　定義ファイル）を参照してください。

-d

ホスト情報DBに登録されたホスト情報をすべて削除する場合に指定します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

戻り値

0

正常終了

1

論理ホスト名が不正

2

引数エラー

3

ファイル名が不正

4

コマンドを実行する権限がない

5

指定したホスト情報ファイルの構文エラー

6

指定したホスト情報ファイルへのアクセス権がない

10

セットアップされていない

11

ホスト情報DBがない

12

メモリー不足

13

ディスク容量不足

14

ホスト情報DBが壊れている

15

メッセージの初期化失敗

16

ホスト情報DBが使用中

99

その他のエラー

jim_log.bat（Windows限定）

機能

JP1/IM - ManagerまたはJP1/IM - Viewで障害が発生したときに資料を採取するためのツールです。JP1/IM - Manager，JP1/IM - View，およびJP1/Baseの保守資料，OSのシステム情報，統合トレースログなどを採取します。

このツールは，バッチファイルです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料を採取する対象フォルダまたはファイルを一次資料および二次資料に区分けし，指定した資料格納フォルダの直下に採取した資料が格納されます。

一次資料は，障害時の切り分けや，軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は，一次資料ではわからなかった障害をさらに調査するための詳細資料です。Windowsイベントログ，JP1/BaseのイベントDBなどを採取します。

また，JP1/IM - Manager（セントラルコンソール）またはJP1/IM - Viewのスレッドダンプがある状態でjim_log.batを実行すると，メッセージKAVB8946-Iを表示してスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」を入力した場合，スレッドダンプを削除します。

必要に応じて採取した資料を圧縮ツールなどで圧縮してください。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「11.3　トラブル発生時に採取が必要な資料」を参照してください。

資料格納フォルダの直下に格納された資料のフォルダ構成および資料内容を次に示します。

表1‒39　物理ホストの一次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥jp1_default¥imm_1st¥imm

JP1/IM - Managerの資料格納フォルダ

JP1/IM - Managerのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥conf

JP1/IM - Managerの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥log

JP1/IM - Managerのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥cons

JP1/IM - Manager（セントラルコンソール）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥conf

JP1/IM - Manager（セントラルコンソール）の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥default

JP1/IM - Manager（セントラルコンソール）の共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥log

JP1/IM - Manager（セントラルコンソール）のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥scope

JP1/IM - Manager（セントラルスコープ）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥conf

JP1/IM - Manager（セントラルスコープ）の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥default

JP1/IM - Manager（セントラルスコープ）の共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥log

JP1/IM - Manager（セントラルスコープ）のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥coview

JP1/IM - Viewの資料格納フォルダ

JP1/IM - Viewのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥conf

JP1/IM - Viewの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥default

JP1/IM - Viewの共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥log

JP1/IM - Viewのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥Patchlog_jp1imm.txt

JP1/IM - Managerのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥conf¥tools

JP1/IM - Managerの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥log¥operationlog

JP1/IM - Managerの操作ログ

資料格納フォルダ¥jp1_default¥imm_1st¥imcf¥conf¥imcf

IM構成管理の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imdb¥conf¥imdb

IMデータベースの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imcf¥system¥default¥new¥imcf

IM構成管理の共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥imdb¥database¥imdb

IMデータベースのログの詳細情報

資料格納フォルダ¥jp1_default¥imm_1st¥imcf¥log¥imcf

IM構成管理のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imdb¥log¥imdb

IMデータベースのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥base

JP1/Baseの資料格納フォルダ

JP1/Baseのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥base¥conf

JP1/Baseの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥base¥default

JP1/Baseの共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥base¥log

JP1/Baseのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥base¥plugin¥conf

JP1/Baseのプラグインサービスの設定ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥base¥sys¥tmp

JP1/Baseのログおよびテンポラリファイル

資料格納フォルダ¥jp1_default¥imm_1st¥oslog

OSのログ情報

資料格納フォルダ¥jp1_default¥imm_1st¥spool

32bit版の統合トレースログ

資料格納フォルダ¥jp1_default¥imm_1st¥spoolx64

64bit版の統合トレースログ

資料格納フォルダ¥jp1_default¥imm_1st¥imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_1st¥imdd¥conf

JP1/IM - Manager（インテリジェント統合管理基盤）の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imdd¥log

JP1/IM - Manager（インテリジェント統合管理基盤）のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imdd¥plugin

JP1/IM - Manager（インテリジェント統合管理基盤）のプラグイン

表1‒40　物理ホストの二次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥jp1_default¥imm_2nd¥cons

JP1/IM - Manager（セントラルコンソール）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_2nd¥cons¥operation¥evgen

JP1/IM - Manager（セントラルコンソール）の相関イベント発行履歴ファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥cons¥operation¥comexclude

JP1/IM - Manager（セントラルコンソール）の共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥scope

JP1/IM - Manager（セントラルスコープ）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_2nd¥scope¥database

JP1/IM - Manager（セントラルスコープ）のDB情報

資料格納フォルダ¥jp1_default¥imm_2nd¥base

JP1/Baseの資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_2nd¥base¥log¥COMMAND

JP1/Baseのコマンド実行履歴ファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥base¥sys¥event¥servers¥default

JP1/BaseのイベントDB

資料格納フォルダ¥jp1_default¥imm_2nd¥oslog

Windowsイベントログ

資料格納フォルダ¥jp1_default¥imm_2nd¥imcf¥data¥imcf

IM構成管理のデータファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥imdb¥database¥imdb¥imdbbackup.dat

IMデータベースのバックアップファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥imdd¥data¥imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のデータファイル

表1‒41　論理ホストの一次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥論理ホスト名¥imm_1st¥cons

JP1/IM - Manager（セントラルコンソール）の論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_1st¥cons¥conf

JP1/IM - Manager（セントラルコンソール）の論理ホストの設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥cons¥log

JP1/IM - Manager（セントラルコンソール）の論理ホストのログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥scope

JP1/IM - Manager（セントラルスコープ）の論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_1st¥scope¥conf

JP1/IM - Manager（セントラルスコープ）の論理ホストの設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥scope¥log

JP1/IM - Manager（セントラルスコープ）の論理ホストのログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥base

JP1/Baseの論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_1st¥base¥conf

JP1/Baseの論理ホスト名の設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥base¥event

JP1/Baseの論理ホストのイベントサーバ設定

資料格納フォルダ¥論理ホスト名¥imm_1st¥base¥log

JP1/Baseの論理ホストのログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥oslog

OSのログ情報

資料格納フォルダ¥論理ホスト名¥imm_1st¥imm¥Patchlog_jp1imm.txt

JP1/IM - Managerのパッチ情報

資料格納フォルダ¥論理ホスト名¥imm_1st¥imm¥log¥operationlog

JP1/IM - Managerの操作ログ

資料格納フォルダ¥論理ホスト名¥imm_1st¥imcf¥conf¥imcf

IM構成管理の設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdb¥database¥imdb

IMデータベースのログの詳細情報

資料格納フォルダ¥論理ホスト名¥imm_1st¥imcf¥log¥imcf

IM構成管理のログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdb¥log¥imdb

IMデータベースのログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd¥conf

JP1/IM - Manager（インテリジェント統合管理基盤）の設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd¥log

JP1/IM - Manager（インテリジェント統合管理基盤）のログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd¥plugin

JP1/IM - Manager（インテリジェント統合管理基盤）のプラグイン

表1‒42　論理ホストの二次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons

JP1/IM - Manager（セントラルコンソール）の論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons¥operation¥evgen

JP1/IM - Manager（セントラルコンソール）の論理ホストの相関イベント発行履歴ファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons¥operation¥comexclude

JP1/IM - Manager（セントラルコンソール）の論理ホストの共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥scope

JP1/IM - Manager（セントラルスコープ）の論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_2nd¥scope¥database

JP1/IM - Manager（セントラルスコープ）の論理ホストのDB情報

資料格納フォルダ¥論理ホスト名¥imm_2nd¥base

JP1/Baseの論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_2nd¥base¥log¥COMMAND

JP1/Baseの論理ホストのコマンド実行履歴ファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥base¥event

JP1/Baseの論理ホストのイベントDB

資料格納フォルダ¥論理ホスト名¥imm_2nd¥imcf¥data¥imcf

IM構成管理のデータファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥imdb¥database¥imdb¥imdbbackup.dat

IMデータベースのバックアップファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥imdd¥data¥imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の論理ホストのデータファイル

形式

jim_log.bat -f 資料格納フォルダ
            [-h 論理ホスト名]
            [-t]
            [-n]
            [-p]
            [-r]
            [-g]
            [-a]
            [-s]
            [-c]
            [-d]
            [-x]
            [-w]
            [-q]
            [-b]

-aオプションは，BJEXまたはJP1/ASと連携した場合に使用するオプションです。-aオプションの詳細については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「10.5.2　jim_log.bat（Windows限定）」を参照してください。

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Managerパス¥tools¥

引数

-f 資料格納フォルダ

採取した資料を出力するフォルダ名をフルパスまたはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲んで指定します。このオプションは省略できません。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。すでに存在するフォルダを指定した場合は，いったんそのフォルダを削除してから，指定したフォルダが作成されます。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。このオプションを省略した場合，物理ホストの資料だけ採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため，クラスタシステムで使用する場合には論理ホスト名を必ずこのオプションで指定してください。

-t

hostsおよびservicesファイルを採取しない場合に指定します。

-n

JP1/Baseの保守資料を採取しない場合に指定します。

-p

JP1/BaseのイベントDBを取得しない場合に指定します。

-r

JP1/Baseのコマンド実行履歴ファイルを採取しない場合に指定します。

-g

相関イベント発行履歴ファイルを採取しない場合に指定します。

-a

応答待ちイベント滞留ファイルを採取しない場合に指定します。

-s

JP1/IM - Manager（セントラルスコープ）の保守資料を採取しない場合に指定します。

-c

IM構成管理の保守資料を採取しない場合に指定します。

-d

IMデータベースの保守資料を採取しない場合に指定します。

-xオプションと同時に指定できません。

-x

IMデータベースのバックアップファイルを採取する場合に指定します。

-dオプションと同時に指定できません。

IMデータベースのバックアップファイルは，デフォルトで採取するIMデータベースの保守資料には含まれていません。IMデータベースサービスが起動していない場合は，保守資料を採取しません。IMデータベースサービスを起動したあと，資料採取コマンドを再実行してください。なお，資料採取時にJP1/IM-Managerが起動していても採取できます。

-w

JP1/IM - Viewの保守資料を採取しない場合に指定します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

-b

インテリジェント統合管理基盤の保守資料を採取しない場合に指定します。

注意事項

このツールによって採取される資料の総容量は大きくなるため，このツールを実行する前に必要容量を見積もり，ご使用のマシンの空き容量を確認する必要があります。詳細については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「11.4　資料の採取方法」を参照してください。

このツールを複数同時に実行しないでください。資料が上書きされたり，採取できなかったりする場合があります。

採取するファイルが見つからない場合，「ファイルが見つかりません」などのメッセージが表示されることがありますが，対処の必要はありません。

JP1/BaseまたはJP1/IM - Managerが起動している場合，「共有違反です」などのメッセージが表示されることがありますが，対処の必要はありません。

資料を採取するツールの実行時は，ある程度の負荷（ディスクI/Oなど）が掛かります。

このツールを使用しないでサポートサービスへ資料を送付した場合や，資料を除外して送付した場合は，正確な調査ができないおそれがあります。

戻り値

0

正常終了

8

異常終了

使用例1

D:¥tempフォルダに物理ホストの資料と論理ホストhostAの資料を採取する場合

jim_log.bat -f D:¥temp -h hostA

出力結果は次のようになります。

KAVB8925-I The directory does not exists. ("D:¥temp¥jp1_default¥imm_1st")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥jp1_default¥imm_2nd")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥hostA¥imm_1st")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥hostA¥imm_2nd")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8926-I Data acquisition processing will start.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" command will start.
KAVB8921-I The information for JP1/IM - Manager will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Manager has been acquired.
KAVB8921-I The information for JP1/IM - Central Console will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/IM - Central Console has been acquired.
KAVB8921-I The information for JP1/IM - Central Scope will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/IM - Central Scope has been acquired.
KAVB8921-I The information for JP1/Base will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/Base has been acquired.
KAVB8921-I The information for JP1/IM - View will be acquired.
KAVB8922-I The information for JP1/IM - View has been acquired.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8929-I The system information will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I The system information has been acquired.
KAVB8929-I "Watson log and crash dump" will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I "Watson log and crash dump" has been acquired.
KAVB8921-I Windows Eventlog(Application) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(Application) has been acquired.
KAVB8921-I Windows Eventlog(System) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(System) has been acquired.
KAVB8921-I The setup.ini of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ini of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ini of JP1/IM - View will be acquired.
KAVB8922-I The setup.ini of JP1/IM - View has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - View will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - View has been acquired.
KAVB8921-I The setup.ini of JP1/Base will be acquired.
KAVB8922-I The setup.ini of JP1/Base has been acquired.
KAVB8921-I The setup.ilg of JP1/Base will be acquired.
KAVB8922-I The setup.ilg of JP1/Base has been acquired.
KAVB8921-I The integrated trace log will be acquired.
KAVB8922-I The integrated trace log has been acquired.
KAVB8921-I The integrated installer log will be acquired.
KAVB8922-I The integrated installer log has been acquired.
KAVB8921-I The installer log file will be acquired.
KAVB8922-I The installer log file has been acquired.
KAVB8921-I The hosts will be acquired.
KAVB8922-I The hosts has been acquired.
KAVB8921-I The services will be acquired.
KAVB8922-I The services has been acquired.
KAVB8921-I The registry information will be acquired.
KAVB8922-I The registry information has been acquired.
KAVB8921-I The netstat information will be acquired.
KAVB8922-I The netstat information has been acquired.
KAVB8921-I The ipconfig information will be acquired.
KAVB8922-I The ipconfig information has been acquired.
KAVB8921-I The net start information will be acquired.
KAVB8922-I The net start information has been acquired.
KAVB8921-I The set information will be acquired.
KAVB8922-I The set information has been acquired.
KAVB8918-I The data was successfully acquired.

使用例2

存在しないD:¥tempフォルダに物理ホストの資料を採取するが，存在する論理ホストhostAを指定しなかった場合

jim_log.bat -f D:¥temp

出力結果は次のようになります。

KAVB8925-I The directory does not exists. ("D:¥temp")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥jp1_default¥imm_1st")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥jp1_default¥imm_2nd")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8926-I Data acquisition processing will start.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" command will start.
KAVB8921-I The information for JP1/IM - Manager will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Manager has been acquired.
KAVB8921-I The information for JP1/IM - Central Console will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Central Console has been acquired.
KAVB8921-I The information for JP1/IM - Central Scope will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Central Scope has been acquired.
KAVB8921-I The information for JP1/Base will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/Base has been acquired.
KAVB8921-I The information for JP1/IM - View will be acquired.
KAVB8922-I The information for JP1/IM - View has been acquired.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8929-I The system information will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I The system information has been acquired.
KAVB8929-I "Watson log and crash dump" will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I "Watson log and crash dump" has been acquired.
KAVB8921-I Windows Eventlog(Application) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(Application) has been acquired.
KAVB8921-I Windows Eventlog(System) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(System) has been acquired.
KAVB8921-I The setup.ini of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ini of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ini of JP1/IM - View will be acquired.
KAVB8922-I The setup.ini of JP1/IM - View has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - View will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - View has been acquired.
KAVB8921-I The setup.ini of JP1/Base will be acquired.
KAVB8922-I The setup.ini of JP1/Base has been acquired.
KAVB8921-I The setup.ilg of JP1/Base will be acquired.
KAVB8922-I The setup.ilg of JP1/Base has been acquired.
KAVB8921-I The integrated trace log will be acquired.
KAVB8922-I The integrated trace log has been acquired.
KAVB8921-I The integrated installer log will be acquired.
KAVB8922-I The integrated installer log has been acquired.
KAVB8921-I The installer log file will be acquired.
KAVB8922-I The installer log file has been acquired.
KAVB8921-I The hosts will be acquired.
KAVB8922-I The hosts has been acquired.
KAVB8921-I The services will be acquired.
KAVB8922-I The services has been acquired.
KAVB8921-I The registry information will be acquired.
KAVB8922-I The registry information has been acquired.
KAVB8921-I The netstat information will be acquired.
KAVB8922-I The netstat information has been acquired.
KAVB8921-I The ipconfig information will be acquired.
KAVB8922-I The ipconfig information has been acquired.
KAVB8921-I The net start information will be acquired.
KAVB8922-I The net start information has been acquired.
KAVB8921-I The set information will be acquired.
KAVB8922-I The set information has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8934-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.bat -f output-directory-name -h logical-hostname".
続行するには何かキーを押してください . . .

jim_log.sh（UNIX限定）

機能

JP1/IM - Managerで障害が発生したときに資料を採取するためのツールです。JP1/IM - ManagerおよびJP1/Baseの保守資料，OSのシステム情報，統合トレースログなどを採取します。

このツールは，シェルスクリプトです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料を採取する対象ディレクトリまたはファイルを一次資料および二次資料に区分けし，指定した資料格納ディレクトリの直下でtarコマンドによってアーカイブしたあと，compressコマンドで圧縮したファイルを作成します。

一次資料は，障害時の切り分けや，軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は，一次資料ではわからなかった障害をさらに調査するための詳細資料です。core解析情報，JP1/BaseのイベントDBなどを採取します。

また，JP1/IM - Manager（セントラルコンソール）のコアダンプやスレッドダンプがある状態でjim_log.shコマンドを実行すると，メッセージKAVB8941-IまたはKAVB8942-Iを表示してコアダンプまたはスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」または「yes」を入力した場合，コアダンプまたはスレッドダンプを削除します。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「11.3　トラブル発生時に採取が必要な資料」を参照してください。

採取した資料を圧縮したファイルを次に示します。

表1‒43　採取した資料を圧縮したファイル

ファイル名

内容

jp1_default_imm_1st.tar.Z

物理ホストの一次資料を格納します。

jp1_default_imm_2nd.tar.Z

物理ホストの二次資料を格納します。

論理ホスト名_imm_1st.tar.Z※

論理ホストの一次資料を格納します。

論理ホスト名_imm_2nd.tar.Z※

論理ホストの二次資料を格納します。

注※　-hオプションで論理ホストを指定した場合にだけ作成されます。

圧縮されたファイルは，資料格納ディレクトリに格納されます。圧縮された各ファイルの内部ディレクトリ構成を次に示します。

表1‒44　物理ホストの一次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./etc/opt/jp1base

JP1/Baseの自動起動および自動終了スクリプト

./etc/opt/jp1base/conf

JP1/Baseの設定および定義ファイル

./etc/opt/jp1base/default

JP1/Baseの共通定義情報

./etc/opt/jp1cons

JP1/IM - Manager（セントラルコンソール）の自動起動および自動終了スクリプト

./etc/opt/jp1cons/conf

JP1/IM - Manager（セントラルコンソール）の設定および定義ファイル

./etc/opt/jp1cons/default

JP1/IM - Manager（セントラルコンソール）の共通定義情報

./etc/opt/jp1imm/conf/tools

JP1/IM - Managerの設定および定義ファイル

./etc/opt/jp1imm/conf/imcf

IM構成管理の設定および定義ファイル

./etc/opt/jp1imm/conf/imdb

IMデータベースの設定および定義ファイル

./etc/opt/jp1imm/conf/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の設定および定義ファイル

./etc/opt/jp1imm/plugin

JP1/IM - Manager（インテリジェント統合管理基盤）のプラグイン

./etc/opt/jp1imm/default/imcf

IM構成管理の共通定義情報

./etc/opt/jp1scope/conf

JP1/IM - Manager（セントラルスコープ）の設定および定義ファイル

./etc/opt/jp1scope/default

JP1/IM - Manager（セントラルスコープ）の共通定義情報

./opt/jp1/hcclibcnf

共通定義情報

./opt/jp1base

JP1/Baseのパッチ適用履歴およびパッチログ情報

./opt/jp1base/conf

JP1/Baseのプラグインサービスの設定ファイル

./opt/jp1imm

JP1/IM - Managerのパッチ適用履歴およびパッチログ情報

./var/opt/jp1base/log

JP1/Baseのログファイル

./var/opt/jp1base/sys/tmp

JP1/Baseのログおよびテンポラリファイル

./var/opt/hitachi/HNTRLib2/spool

統合トレースログ

./var/opt/jp1cons/log

JP1/IM - Manager（セントラルコンソール）のログファイル

./var/opt/jp1imm/database/imdb

IMデータベースのログの詳細情報

./var/opt/jp1imm/log/imcf

IM構成管理のログファイル

./var/opt/jp1imm/log/imdb

IMデータベースのログファイル

./var/opt/jp1imm/log/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のログファイル

./var/opt/jp1imm/log/_jp1_default/oslog

OSのログ情報

./var/opt/jp1imm/log/_jp1_default/operationlog

JP1/IM - Managerの操作ログ

./var/opt/jp1scope/log

JP1/IM - Manager（セントラルスコープ）のログファイル

表1‒45　物理ホストの二次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./var/opt/jp1base/log/COMMAND

JP1/Baseのコマンド実行履歴ファイル

./var/opt/jp1base/sys/event/servers/default

JP1/BaseのイベントDB

./var/opt/jp1cons/operation/evgen

JP1/IM - Manager（セントラルコンソール）の相関イベント発行履歴ファイル

./var/opt/jp1cons/operation/comexclude

JP1/IM - Manager（セントラルコンソール）の共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

./var/opt/jp1imm/log/_jp1_default/oslog

OSのログ情報

./var/opt/jp1imm/log/_jp1_default/core

コアファイル

./var/opt/jp1scope/database

JP1/IM - Manager（セントラルスコープ）のDB情報

./var/opt/jp1imm/data/imcf

IM構成管理のデータファイル

./var/opt/jp1imm/database/imdb/imdbbackup.dat

IMデータベースのバックアップファイル

./var/opt/jp1imm/data/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のデータファイル

./tmp/.JP1_SES*

./usr/tmp/jp1_ses

./usr/lib/jp1_ses/log

./usr/lib/jp1_ses/sys

./usr/bin/jp1_ses/jp*

./var/opt/jp1_ses

JP1/SES互換用ログ

表1‒46　論理ホストの一次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./共有ディスク/jp1base/../event

JP1/Baseの論理ホストのイベントサーバ設定

./共有ディスク/jp1base/conf

JP1/Baseの論理ホストの設定および定義ファイル

./共有ディスク/jp1base/log

JP1/Baseの論理ホストのログファイル

./共有ディスク/jp1cons/conf

JP1/IM - Manager（セントラルコンソール）の論理ホストの設定および定義ファイル

./共有ディスク/jp1cons/log

JP1/IM - Manager（セントラルコンソール）の論理ホストのログファイル

./共有ディスク/jp1scope/conf

JP1/IM - Manager（セントラルスコープ）の論理ホストの設定および定義ファイル

./共有ディスク/jp1scope/log

JP1/IM - Manager（セントラルスコープ）の論理ホストのログファイル

./var/opt/jp1imm/log/_論理ホスト名/oslog

OSのログ情報

./var/opt/jp1imm/log/_論理ホスト名/operationlog

JP1/IM - Managerの操作ログ

./共有ディスク/jp1imm/conf/imcf

IM構成管理の設定および定義ファイル

./共有ディスク/jp1imm/conf/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の設定および定義ファイル

./var/opt/jp1imm/database/imdb

IMデータベースのログの詳細情報

./共有ディスク/jp1imm/log/imcf

IM構成管理のログファイル

./共有ディスク/jp1imm/log/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のログファイル

./var/opt/jp1imm/log/imdb

IMデータベースのログファイル

表1‒47　論理ホストの二次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./共有ディスク/event

JP1/Baseの論理ホストのイベントDB

./共有ディスク/jp1base/log/COMMAND

JP1/Baseの論理ホストのコマンド実行履歴ファイル

./共有ディスク/jp1cons/operation/evgen

JP1/IM - Manager（セントラルコンソール）の論理ホストの相関イベント発行履歴ファイル

./共有ディスク/jp1cons/operation/comexclude

JP1/IM - Manager（セントラルコンソール）の論理ホストの共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

./共有ディスク/jp1scope/database

JP1/IM - Manager（セントラルスコープ）の論理ホストのDB情報

./var/opt/jp1imm/log/_論理ホスト名/oslog

OSのログ情報

./var/opt/jp1imm/log/_論理ホスト名/core

コアファイル

./共有ディスク/jp1imm/data/imcf

IM構成管理のデータファイル

./共有ディスク/jp1imm/database/imdb/imdbbackup.dat

IMデータベースのバックアップファイル

./共有ディスク/jp1imm/data/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のデータファイル

形式

jim_log.sh -f 資料格納ディレクトリ
           [-h 論理ホスト名]
           [-t]
           [-u]
           [-n]
           [-p]
           [-r]
           [-g]
           [-a]
           [-s]
           [-c]
           [-d]
           [-x]
           [-q]
           [-b]
           [ディレクトリ名またはファイル名...]

-aオプションは，BJEXまたはJP1/ASと連携した場合に使用するオプションです。-aオプションの詳細については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「10.5.3　jim_log.sh（UNIX限定）」を参照してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1imm/tools/

引数

-f 資料格納ディレクトリ

採取した資料を出力するディレクトリ名またはデバイス名をフルパスまたはルートディレクトリからの相対パス形式で指定します。ディレクトリ名を指定した場合，その下に採取した各資料を格納したファイルが作成されます。パスに空白を含む場合は，「"」で囲んで指定します。このオプションは省略できません。

存在しないディレクトリを指定した場合は，その名称でディレクトリが新規作成されます。すでに存在するディレクトリを指定した場合は，いったんそのディレクトリを削除してから，指定したディレクトリが作成されます。

デバイス名を指定した場合，作成したファイルの数だけデバイスに対して書き込みが発生します。また，テープなどのデバイスファイル名を指定した場合，採取した資料は圧縮されずにデバイスに格納されます。

デバイス名を指定し，かつ-qオプションを指定した場合，ユーザー確認に対しては「yes」を選択したものとして動作するので，あらかじめコマンドを実行する前にデバイスをセットしておく必要があります。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。このオプションを省略した場合，物理ホストの資料だけ採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため，クラスタシステムで使用する場合には論理ホスト名を必ずこのオプションで指定してください。

-t

hosts，services，およびpasswdファイルを採取しない場合に指定します。

-u

core解析情報を採取しない場合に指定します。core解析情報とは，coreダンプファイルをSeraphツールのcarコマンドで解析して取得したファイルです。

-n

JP1/Baseの保守資料を採取しない場合に指定します。

-p

JP1/BaseのイベントDBを取得しない場合に指定します。

-r

JP1/Baseのコマンド実行履歴ファイルを採取しない場合に指定します。

-g

相関イベント発行履歴ファイルを採取しない場合に指定します。

-a

応答待ちイベント滞留ファイルを採取しない場合に指定します。

-s

JP1/IM - Manager（セントラルスコープ）の保守資料を採取しない場合に指定します。

-c

IM構成管理の保守資料を採取しない場合に指定します。

-d

IMデータベースの保守資料を採取しない場合に指定します。

-xオプションと同時に指定できません。

-x

IMデータベースのバックアップファイルを採取する場合に指定します。

-dオプションと同時に指定できません。

IMデータベースのバックアップファイルは，デフォルトで採取するIMデータベースの保守資料には含まれていません。IMデータベースサービスが起動していない場合は，保守資料を採取しません。IMデータベースサービスを起動したあと，資料採取コマンドを再実行してください。なお，資料採取時にJP1/IM-Managerが起動していても採取できます。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

-b

インテリジェント統合管理基盤の保守資料を採取しない場合に指定します。

ディレクトリ名またはファイル名

資料採取ツールで任意のファイルまたはディレクトリを採取したいときに指定します。フルパス名で指定してください。複数指定する場合は，スペースで区切ってください。

なお，このオプションは，指定したいほかのオプションをすべて指定したあとに指定してください。採取した資料は物理ホストの一次資料に格納されます。

注意事項

このツールによって採取される資料の総容量は大きくなるため，このツールを実行する前に必要容量を見積もり，ご使用のマシンの空き容量を確認する必要があります。詳細については，マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「11.4　資料の採取方法」を参照してください。

このツールを複数同時に実行しないでください。資料が上書きされたり，採取できなかったりする場合があります。

資料を採取するツールの実行時は，ある程度の負荷（ディスクI/Oなど）が掛かります。

このツールを使用しないでサポートサービスへ資料を送付した場合や，資料を除外して送付した場合は，正確な調査ができないおそれがあります。

戻り値

0

正常終了

8

異常終了

使用例1

/tmp/jp1logに物理ホストの資料と論理ホストhostAの資料を採取する場合

jim_log.sh -f /tmp/jp1log -h hostA

出力結果は次のようになります。

KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_hostA).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8922-I The physical host's second material has been acquired.
KAVB8921-I The logical host(hostA)'s first material will be acquired.
KAVB8922-I The logical host(hostA)'s first material has been acquired.
KAVB8921-I The logical host(hostA)'s second material will be acquired.
KAVB8922-I The logical host(hostA)'s second material has been acquired.
KAVB8918-I The data was successfully acquired.

使用例2

存在しない/tmp/jp1log/に物理ホストの資料を採取するが，存在する論理ホストhostAを指定しなかった場合

jim_log.sh -f /tmp/jp1log

出力結果は次のようになります。

KAVB8925-I The directory does not exist. (/tmp/jp1log).
           The directory will be created.
KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8922-I The physical host's second material has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8935-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.sh -f output-directory-name -h logical-hostname".

使用例3

jp1_default_imm_1st.tar.Zおよびjp1_default_imm_2nd.tar.Zファイルが存在する/tmp/jp1log/に物理ホストの資料を採取するが，存在する論理ホストhostAを指定しなかった場合

jim_log.sh -f /tmp/jp1log

出力結果は次のようになります（すべて「y」と入力した場合）。

KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8944-I (/tmp/jp1log/jp1_default_imm_2nd.tar.Z) already exists. Do you want to overwrite it? [yes/no]y
KAVB8922-I The physical host's second material has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8944-I (/tmp/jp1log/jp1_default_imm_1st.tar.Z) already exists. Do you want to overwrite it? [yes/no]y
KAVB8935-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.sh -f output-directory-name -h logical-hostname".

jimdbbackup

機能

IMデータベースをバックアップするコマンドです。バックアップの用途と取得できるデータの種類を次に示します。

障害復旧用バックアップ

データベースの障害が発生した際にデータベースを復旧するため，定期的にデータをバックアップします。バックアップ対象は，データベース内の統合監視DB領域，IM構成管理DB領域，およびシステムDB領域です。

拡張用バックアップ

データベースのサイズ拡張をするために，一時退避するためのデータをバックアップします。バックアップ対象は，データベース内の統合監視DB領域，IM構成管理DB領域です。

形式

jimdbbackup -o バックアップファイル名
            -m {MAINT|EXPAND}
              [-h 論理ホスト名]
              [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-o バックアップファイル名

バックアップするデータベースを出力するファイル名を絶対パス形式で指定します。バックアップファイルは，ローカルドライブを指定してください。このオプションは省略できません。

ネットワークドライブが指定された場合，UNCパスが指定された場合，およびWindowsで予約デバイスファイルが指定された場合はエラーとなります。指定したバックアップファイルがすでに存在する場合は，上書きされます。

バックアップファイル名にはファイルパスを含めて指定してください。使用できる文字は半角英数字とアンダーバー「_」，ドット「.」，シャープ「#」，アットマーク「@」です。文字はOSに依存し，半角スペース「 」または丸括弧「(」，「)」を含む場合は，前後を引用符「"」で囲む必要があります。Windowsの場合，MAINT指定時のバックアップファイル名はすべて小文字となります。また，ファイル名の最大長はOSの制限に従います。

指定されたバックアップファイルを格納するディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

-m {MAINT | EXPAND}

データベースのバックアップ形式を指定します。半角英大文字です。このオプションは省略できません。

MAINT：障害復旧用バックアップを実行します。

EXPAND：拡張用バックアップを実行します。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するデータベースをバックアップします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

バックアップが正常終了した

1

バックアップが異常終了した

注意事項

このコマンドを実行する前に，このコマンドとjimdbrecoveryコマンドの実行条件を満たすことを確認してください。

このコマンドの実行中にほかのJP1/IM - Managerのコマンドを実行したりJP1/IM - Managerのサービスを起動したりしないでください。このコマンドは障害復旧用バックアップの場合にデータベースを参照・更新禁止モードに変更するため，実行に失敗することがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーは押さないでください。バックアップをバックグラウンドで実行するため，［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押してもバックアップ処理は継続されます。［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押したあと，すぐにほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Manager全体のサービスを起動したりすると，コマンドの実行やサービスの起動に失敗することがあります。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，次のプロセスが実行されていないことを確認してからコマンドを再実行してください。

障害復旧用バックアップの場合はpdcopyプロセス

拡張用バックアップの場合はpdrorgプロセス

このコマンドの実行時にバックアップファイルが作成されます。拡張用バックアップの場合，または障害復旧用バックアップの場合，バックアップファイルの出力先のドライブ空き容量は，DBサイズがSのときに最大2ギガバイト，Mのときに最大15ギガバイト，Lのときに最大50ギガバイト程度必要です。

IMデータベースを使用している場合，JP1/IM-Managerが停止している必要があります。

Windowsの場合，IMデータベースサービス（JP1/IM2-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service_論理ホスト名）が停止している必要があります。

バックアップファイルは，復旧用と拡張用の区別ができないため，ファイル名にそれぞれが区別できる文字を指定することを推奨します。

バックアップファイルのアクセス権は，ユーザーがアクセスできる状態で出力されます。バックアップ取得後，アクセス権を変更するか，ユーザーがアクセスできない場所へ移動することを推奨します。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbreclaim

機能

IM構成管理DBの使用中の空き領域（空きページ領域）を解放するコマンドです。

IM構成管理DBで大量のホストを削除すると，そのデータを格納している領域の一部が使用中の空き領域になることがあります。このコマンドを実行すると，使用中の空き領域を未使用の空き領域にして再利用できます。

また，JP1/IM-Managerサービスを停止しないで，運用中に実行できます。

形式

jimdbreclaim [-h 論理ホスト名]
             [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するIM構成管理DBの空き領域を解放します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

このコマンドはIM構成管理DBで大量のホストの追加，削除を繰り返さない場合は実行する必要がありません。

このコマンドの実行中に，ほかのJP1/IM - Managerのコマンドを実行しないでください。実行が失敗することがあります。

このコマンドの実行中はCPUが高負荷状態になるため，参照・更新の頻度が低い夜間などの時間帯に実行することをお勧めします。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押して処理を中止した場合，データベースの空き領域解放に失敗することがあります。コマンドを再実行するには，別プロセスが動作している場合があるため，pdreclaimとpdrorgプロセスが実行されていないことを確認してください。これらのプロセスが実行中の場合，しばらく時間をおいてから再確認してください。

このコマンドの実行中にデータベースサービスを停止しないでください。

実行中にデータベースサービスを停止した場合は，データベースサービスを起動後にコマンドの再実行が必要です。

Windowsの場合，IMデータベースサービス「JP1/IM2-Manager DB Server」が起動している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbrecovery

機能

バックアップで保管しておいたデータベースを復旧（リカバリー）するコマンドです。リカバリーできるデータの種類を次に示します。

障害復旧用リカバリー

データベースの障害が発生した際に，定期的に取得しているバックアップデータを利用してデータベースを復旧します。

拡張用リカバリー

データベースのサイズ拡張をするために，一時退避するためのデータをバックアップします。

形式

jimdbrecovery -i バックアップファイル名
                -m {MAINT|EXPAND}
                [-h 論理ホスト名]
                [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-i バックアップファイル名

jimdbbackupコマンドを用いてバックアップしたデータベースのファイル名を絶対パス形式で指定します。ファイル名に使用できる文字は，半角英数字とアンダーバー「_」，ドット「.」，シャープ「#」，アットマーク「@」です。バックアップファイルには，ローカルドライブを指定します。このオプションは省略できません。

ネットワークドライブが指定された場合，UNCパスが指定された場合，およびWindowsで予約デバイスファイルが指定された場合はエラーとなります。

-m {MAINT|EXPAND}

データベースのリカバリー形式を指定します。指定できる文字は，半角英大文字です。このオプションは省略できません。

MAINT：障害復旧用リカバリーを実行します。

EXPAND：拡張用リカバリーを実行します。

障害復旧用リカバリーを実行する場合，障害復旧用バックアップで採取したバックアップファイルを指定してください。また，拡張用リカバリーを実行する場合，拡張用バックアップで採取したバックアップファイルを指定してください。指定した引数とバックアップファイルの種別が異なる場合は，エラーとなります。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対するデータベースがリカバリーされます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

リカバリーが正常終了した

1

リカバリーが異常終了した

注意事項

jimdbbackupコマンドで取得したバックアップデータをjimdbrecoveryコマンドでリカバリーする場合は，バックアップを取得したときと同じOSで実施してください。異なるOSのデータベースにリカバリーした場合は，動作は保証できません。

このコマンドの実行中に，ほかのJP1/IM - Managerのコマンドの実行やJP1/IM - Managerのサービス起動をしないでください。このコマンドはデータベースの参照・更新を禁止モードに変更するため，実行に失敗するおそれがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーは押さないでください。リカバリーをバックグラウンドで実行するため，［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押してもリカバリー処理は継続されます。［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押したあと，すぐにほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Managerのサービスを起動したりすると，コマンドの実行やサービスの起動に失敗することがあります。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーでコマンドの実行を途中で停止した場合，障害復旧用リカバリーではpdrstrプロセスが実行されていないことを確認してからJP1/IM - Managerを再起動してください。拡張用リカバリーではpdrorgプロセスが実行されていないことを確認してから，ほかのコマンドの実行やJP1/IM - Managerのサービスの起動をしてください。

このコマンドの実行時に一時ファイルが作成されます。拡張用リカバリーの場合，IMデータベースのインストール先ディレクトリの空き容量は，DBサイズがSのときに1ギガバイト，Mのときに1ギガバイト，Lのときに4ギガバイト程度必要です。また，障害復旧用リカバリーの場合，IMデータベースのインストール先ディレクトリの空き容量は，DBサイズがS，MおよびLのどのサイズのときも，5〜50メガバイト程度必要です。

障害復旧用リカバリー実行時は，障害復旧用バックアップを実行したときのデータベース格納ディレクトリと，障害復旧用リカバリーを実行するときのデータベース格納ディレクトリは同じである必要あります。

拡張用リカバリーを実行する場合，拡張用バックアップを実行した時のサイズより小さいサイズでは実行できません。

拡張用リカバリーを実行する場合，拡張用バックアップを実行したときと同じサイズでは，リカバリーに失敗することがあります。データベースを再セットアップしてデータベースを空にしてから，リカバリーしてください。

IMデータベースを使用している場合には，JP1/IM - Managerが停止している必要があります。

Windowsの場合，IMデータベースサービス（JP1/IM2-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service_論理ホスト名）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbrorg

機能

IM構成管理DBの断片化された空き領域を再編成するコマンドです。再編成に伴って，使用中の空き領域も解放されます。そのため，jimdbreclaimコマンドを続けて実行する必要はありません。

空き領域によるデータの非効率化を防ぐために，データベースの再編成はJP1/IM - Managerのメンテナンスのタイミングで実行してください。

形式

jimdbrorg [-h 論理ホスト名]
          [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対するデータベースを再編成します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

再編成が正常終了した

1

再編成が異常終了した

注意事項

このコマンドの実行中に，ほかのJP1/IM - Managerのコマンドを実行したり，JP1/IM - Managerのサービスを起動したりしないでください。実行に失敗することがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーは押さないでください。データベースの再編成処理をバックグラウンドで実行するため，［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押してもデータベースの再編成処理処理は継続されます。［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押したあと，すぐにほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Managerのサービスを起動したりすると，コマンドの実行やサービスの起動に失敗することがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーでコマンドの実行を途中で停止した場合，タスクマネージャなどによりpdrorgプロセスが実行していないことを確認してからほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Managerを操作したりする必要があります。これらのプロセスが実行中の場合，しばらく時間をおいて，そのプロセスの終了を待ってから，ほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Managerの操作をしたりしてください。

このコマンドを実行する前後には，障害復旧用バックアップを実行することをお勧めします。

コマンド実行時に一時ファイルを作成します。そのためIMデータベースのインストール先ディレクトリの空き容量は，DBサイズがSの場合に1ギガバイト，サイズがMの場合に1ギガバイト，Lの場合に4ギガバイト程度必要です。

IMデータベースを使用している場合には，JP1/IM-Managerが停止している必要があります。

Windowsの場合，IMデータベースサービス（JP1/IM2-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service_論理ホスト名）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbstatus

機能

IMデータベースの起動・停止などの稼働状態を確認するコマンドです。

形式

jimdbstatus [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。その後，指定した論理ホストに対応するIMデータベースの稼働状態を確認します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名は，大文字・小文字を区別します。

戻り値

0

IMデータベース稼働中

1

jimdbstatusコマンドが異常終了

4

IMデータベースが起動・停止処理中

8

IMデータベースが停止中（IMデータベースが再起動中断状態であり，不安定な状態）

12

IMデータベースが停止中（正常に停止された状態）

16

IMデータベースサービスが起動していない（Windowsの場合）

20

IMデータベースがセットアップされていない

注意事項

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbstop

機能

IMデータベースを停止するコマンドです。JP1/Baseの起動順序制御機能で，終了コマンドを設定する場合に使用します。

また，IMデータベースが再起動中断状態の場合，IMデータベースを強制停止するときに，-fオプションを指定してこのコマンドを使用します。

形式

jimdbstop [-h 論理ホスト名]
          [-f]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。その後，指定した論理ホストに対応するIMデータベースを停止します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名は，大文字・小文字を区別します。

-f

IMデータベースを強制停止する場合に指定します。

戻り値

0

正常終了

1

異常終了

4

IMデータベースが起動・停止処理中

8

IMデータベースが停止中（IMデータベースが再起動中断状態であり，不安定な状態）

12

IMデータベースが停止中（正常に停止された状態）

20

IMデータベースがセットアップされていない

注意事項

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押して処理を中止した場合，IMデータベースの停止に失敗することがあります。コマンドを再実行するには，別プロセスが動作している場合があるため，pdstopプロセスが実行されていないことを確認してください。このプロセスが実行中の場合，しばらく時間をおいてから再確認してください。

IMデータベースを使用している場合には，JP1/IM-Managerが停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbupdate

機能

セットアップ済みのIMデータベースをアップデートするコマンドです。JP1/IM - Managerをバージョンアップインストールした場合，このコマンドを実行してください。

形式

jimdbupdate [-h 論理ホスト名] [-i] [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するIMデータベースを更新します。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-i

IMデータベースを更新する場合に指定します。指定しない場合は，IMデータベースをアップデートする必要があるか確認するメッセージが出力されます。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

このコマンドを実行する前に，次に示すこのコマンドの実行条件を満たすことを確認してください。

実行条件

実行系で実行する場合は，共有ディスクがオンラインであり，論理ホスト名が名前解決できる必要があります。

Windowsの場合，IMデータベースサービスが起動している必要があります。

物理ホストの場合

　JP1/IM - Manager DB Server

論理ホストの場合

　JP1/IM - Manager DB Server _論理ホスト名

また，次に示す，JP1/IM-Managerサービス，およびIMデータベースのクラスタサービスが停止している必要があります。ただし，統合監視DB，およびIM構成管理DBを使用していない場合はJP1/IM-Managerサービスは停止する必要はありません。

物理ホストの場合

　JP1/IM-Managerサービス（JP1/IM2-Manager）

　IMデータベースのクラスタサービス（JP1/IM2-Manager DB Cluster Service）

論理ホストの場合

　JP1/IM-Managerサービス（JP1/IM2-Manager_論理ホスト名）

　IMデータベースのクラスタサービス（JP1/IM2 - Manager DB Cluster Service_論理ホスト名）

UNIXの場合，JP1/IM-Managerサービスが停止している必要があります。ただし，統合監視DB，およびIM構成管理DBを使用していない場合はJP1/IM-Managerサービスは停止する必要はありません。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdeinstallのプロセスが実行していないことを確認してから再度コマンドを実行してください。

jimdbupdateコマンド実行後は，jimdbupdateコマンド実行前の拡張バックアップはリカバリーできなくなります。jimdbupdateコマンド実行後に拡張バックアップを取り直してください。

このコマンドを実行する前に取得したIMデータベースの更新前のバックアップデータは，コマンド実行後のIMデータベースにリカバリーしないでください。このコマンドを実行したあとは，再度jimdbupdateコマンドでバックアップを取り直してください。

jimdbupdateコマンド実行中に，jimdbstatusなどのIMデータベースに関するコマンドを実行しないでください。実行した場合，IMデータベースがアンインストールできなくなる場合があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimmail（Windows限定）

機能

指定したメールアドレスにメールを送信するコマンドです。

jimmailコマンドでメールを送信するには，メール環境定義ファイルの設定が必要です。

このコマンドは，JP1/IM - Managerサービスの起動状態に関係なく単体で実行できます。次に示すJP1/IM - Managerの機能でメール送信できます。

表1‒48　jimmailコマンドでメール送信できるJP1/IM - Managerの機能

機能

説明

自動アクション

自動アクションでメール送信できる。

アクションの状態監視，遅延監視

アクションの異常を検知したときに通知コマンドでメール送信できる。

ヘルスチェック

JP1/IM - Managerのプロセス異常を検知したとき，通知コマンドでメール送信できる。

コマンド実行（コマンドボタン）

コマンドボタンでメール送信できる。

コマンドラインの最大長を超過した場合は，jimmailコマンドのコマンドライン長が制限内に収まるように，メールの内容を再定義してください。

形式

jimmail [-to 送信先メールアドレス[,送信先メールアドレス…]]
        [-s メールの主題]
        [-b メールの本文]
        [-rh 論理ホスト名]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Consoleパス¥bin¥

引数

-to 送信先メールアドレス[,送信先メールアドレス…]

送信先メールアドレスを指定するオプションです。

指定できるメールアドレスは20件です。ただし，コマンドラインの最大長を超えて指定することはできません。複数のメールアドレスを指定する場合は，「,（コンマ）」でアドレスを区切って指定してください。メールアドレスと「,（コンマ）」の間の半角スペース，タブは無視されます。連続した「,（コンマ）」は一つの「,（コンマ）」と見なし，先頭と末尾の「,（コンマ）」は無視されます。同じメールアドレスを複数指定した場合，指定したアドレスにはメールを1件送信します。

指定したメールアドレスが最大件数を超過した場合，KAVB8725-Eを出力して異常終了します。

送信先メールアドレスに指定できる文字数は，1〜256バイトです。半角英数字，「@（アットマーク）」，「-（ハイフン）」，「_（アンダーバー）」，「.（ピリオド）」の文字で指定します。

このオプションは省略できます。省略した場合，メール環境定義ファイルのDefaultToパラメーター（デフォルトの送信先メールアドレス）に指定したメールアドレスを送信先として処理を継続します。送信処理する際，DefaultToパラメーターのメールアドレスに送信したメッセージは出力しません。

-toオプションを省略し，DefaultToパラメーターにメールアドレスの指定がない場合，jimmailコマンドはエラーメッセージを出力して異常終了します。

-toオプションとDefaultToパラメーターがどちらも設定されている場合，-toオプションが優先されます。

jimmailコマンドは，指定されたメールアドレスが有効なアドレスかをチェックしません。

-s メールの主題

メールの主題を指定するオプションです。

指定できる文字数は，1〜512バイトです。文字数は，メール環境定義ファイルのCharsetパラメーターで指定したメールの文字コードに従ったバイト数でチェックします。イベントやアクションの情報を引き継ぐ場合は，「$変数名」を置換したあとの長さで最大長をチェックします。最大長を超えている場合，メールの主題を切り捨ててメール送信を継続するかを，メール環境定義ファイルのMailSubjectCuttingパラメーターで選択できます。

MailSubjectCuttingパラメーターの値が「OFF」の場合は，KAVB8708-Eメッセージを出力してコマンドは異常終了します。

MailSubjectCuttingパラメーターの値が「ON」の場合は，メールの主題をCharsetパラメーターで指定したメールの文字コードに従い512バイト以内になるように切り捨てて，メール送信を継続します。512バイトを超える場合は，512バイト以内になるように主題の文字列を切り捨てます。メールの主題を切り捨てて送信した場合，KAVB8729-I（メール送信成功メッセージ）の前に，KAVB8724-Wメッセージを表示します。

このオプションは省略できます。省略した場合，メールの主題は空文字（""）になります。

メールの主題に空白文字を含む場合，メールの主題を「"」で囲んで指定します。

「¥n」を指定しても，メールの主題は改行されません。「¥n」を指定した場合，「¥n」がそのまま表示されます。改行コード，制御文字の場合，半角スペースに変換されます。

-b メールの本文

メールの本文を指定するオプションです。

メールの本文に指定できる文字数は，1〜4,096バイトです。文字数は，メール環境定義ファイルのCharsetパラメーターで指定したメールの文字コードに従ったバイト数でチェックします。イベントやアクションの情報を引き継ぐ場合は，「$変数名」を置換したあとの長さで最大長をチェックします。

1行に指定できる文字数は，改行文字を含め1〜512バイトです。512バイトを超えている場合，改行文字を含めて512バイト以内になるように改行コードを挿入します。その際，警告メッセージは出力しません。

このオプションは省略できます。省略した場合，メールの本文は空文字（""）となります。

最終行の末尾に改行がない場合，改行コードが挿入されます。

メールの本文に空白文字を含む場合，メール本文を「"」で囲んで指定します。

メールの本文中に「¥n」を指定した場合，メール環境定義ファイルのMailNewLineパラメーターに指定した改行コードで改行されます。「CRLF」，「CR」，「LF」を除く制御文字が指定されている場合は，半角スペースに変換されます。

「¥n」を文字列として入力する場合は，「¥¥n」と指定します。

-rh 論理ホスト名

-rhオプションは，クラスタでJP1/IM - Managerを運用している場合に，jimmailコマンドが物理ホスト上，または論理ホストの共有フォルダ上のどちらに格納されたメール環境定義ファイルを使用するか指定するオプションです。

このオプションを指定した場合，指定した論理ホスト名の共有フォルダ上のメール環境定義ファイルを読み込み，メールを送信します。

このオプションを省略した場合は，物理ホスト上のメール環境定義ファイルを読み込み，メールを送信します。

ただし，このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタでJP1/IM - Managerを運用していない場合は指定する必要はありません。

注意事項

コマンドラインに指定したメールの主題，および本文は，メール環境定義ファイルに指定した文字コードの範囲で指定してください。メール環境定義ファイルの詳細については，「メール環境定義ファイル（jimmail.conf）」（2.　定義ファイル）を参照してください。

自動アクションやコマンド実行（コマンドボタン）でjimmailコマンドを実行する場合，イベント情報を引き継ぐ際にイベント情報に次に示す制御文字が含まれていると，その制御文字は半角スペース（0x20）に変換されて処理されます。

半角スペースに変換される制御文字：0x01〜0x1F（タブ（0x09）を除く），0x7F

例えば，$EVMSGの指定によって取得したメッセージの中に改行コード（0x0A）が含まれていた場合，改行コード（0x0A）は半角スペース（0x20）に変換されて処理されます。

戻り値

戻り値

説明

0

正常終了

1

引数エラー

2

送信先メールアドレスが指定されていない

3

メール環境定義ファイルの読み込みエラー

4

メール環境定義ファイルのフォーマットエラー

（設定値不正，必須項目未指定，パラメーター不正）

5

SMTPサーバへの接続でタイムアウトが発生した

6

SMTPサーバがログインを拒否した

7

SMTPサーバへの接続に失敗した

8

POP3サーバへの接続でタイムアウトが発生した

9

POP3サーバがログインを拒否した

10

POP3サーバへの接続に失敗した

11

メール送信処理に失敗した

12

メモリー不足が発生した

13

実行権限エラー

255

その他のエラー

使用例

自動アクションで，監視対象ホスト（gyoumu001）の障害をマネージャーホスト（jp1imhost001）からシステム管理者（user@hitachi.com）にメール通知する例と，送信されるメール内容の例を次に示します。

jimmail.exe -to user@hitachi.com -s "[重大度:$EVSEV] 障害発生通知" -b "業務サーバで障害が発生しました。¥n---¥nイベントDB内通し番号=$EVSEQNO¥nイベント発生日時=$EVDATE $EVTIME¥nイベントID=$EVIDBASE¥n重大度=$EVSEV¥nプロダクト名=$EV"PRODUCT_NAME"¥nメッセージ=$EVMSG¥n---¥nFrom:IM-Mホスト($ACTHOST)"

［通知メール例］

送信元（From）

admin@hitachi.com

送信先（To）

user@hitachi.com

メールの主題

[重大度:Error]障害発生通知

メールの本文

業務サーバで障害が発生しました。

---

イベントDB内通し番号=1234567

イベント発生日時=2014/01/01 10:00:00

イベントID=000A

重大度=Error

プロダクト名=/HITACHI/XXXXX/JP1

メッセージ=業務サーバでシステムエラーが発生しました

---

From:IM-Mホスト(jp1imhost001)

jimmailpasswd（Windows限定）

機能

POP before SMTPまたはSMTP-AUTH認証のパスワードをメール環境定義ファイルに設定します。このコマンドは，JP1/IM - Managerサービスの起動状態に関係なく単体で実行できます。

このコマンドを実行する前に，メール環境定義ファイルに次の項目を設定してください。

AuthMethodパラメーターに「POP」または「SMTP」を指定する

AuthUserパラメーターに認証アカウント名を指定する

これらのパラメーターを設定しないでコマンドを実行した場合，KAVB8714-EまたはKAVB8736-Eメッセージを出力して異常終了します。

形式

jimmailpasswd {-p 新しい認証パスワード | -d}
              [-rh 論理ホスト名]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Consoleパス¥bin¥

引数

-p 新しい認証パスワード

POP before SMTPまたはSMTP-AUTH認証を使用してメールサーバに接続する場合の認証パスワードをメール環境定義ファイルに設定するオプションです。

オプションの引数には，認証パスワードを1〜127バイトの範囲で指定します。引数の認証パスワードの指定は省略できません。

指定できる文字は制御文字（0x00〜0x1F，0x7F〜0x9F）を除く半角文字だけで，マルチバイト文字は指定できません。パスワードは大文字・小文字を区別します。

オプションの引数にパスワードを指定しなかった場合，KAVB8704-Eメッセージが出力され，異常終了します。

-d

メール環境定義ファイルから認証パスワードを削除するオプションです。

このオプションを指定してコマンドを実行するとメール環境定義ファイルのAuthPasswordパラメーターの設定値（パスワード部分）を削除します。

-dオプションは，-pオプションと同時に指定はできません。

-rh 論理ホスト名

クラスタでJP1/IM - Managerを運用している場合に，jimmailコマンドが物理ホスト上，または論理ホストの共有フォルダ上に格納した，どちらのメール環境定義ファイルを使用するか指定するオプションです。

このオプションを指定した場合，指定した論理ホスト名の共有フォルダ上のメール環境定義ファイルに認証パスワードを設定します。

このオプションを省略した場合は，物理ホスト上のメール環境定義ファイルに認証パスワードを設定します。

ただし，このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。クラスタでJP1/IM - Managerを運用していない場合は指定する必要はありません。

使用例1

認証パスワード"ABCD"をメール環境定義ファイルに設定する場合

$ jimmailpasswd -p ABCD
KAVB8731-I コマンド（jimmailpasswd）を開始しました
KAVB8730-I パスワードの設定に成功しました
KAVB8732-I コマンド（jimmailpasswd）が正常終了しました

使用例2

認証パスワード"ABCD"を論理ホスト（ronri）上のメール環境定義ファイルに設定する場合

$ jimmailpasswd -p ABCD -rh ronri
KAVB8731-I コマンド（jimmailpasswd）を開始しました
KAVB8730-I パスワードの設定に成功しました
KAVB8732-I コマンド（jimmailpasswd）が正常終了しました

使用例3

認証パスワードをメール環境定義ファイルから削除する場合

$ jimmailpasswd -d
KAVB8731-I コマンド（jimmailpasswd）を開始しました
KAVB8734-I パスワードの削除に成功しました
KAVB8732-I コマンド（jimmailpasswd）が正常終了しました

jimnodecount

機能

JP1/IM - Managerの管理ノードをカウントします。また，管理ノードとしてカウントしたホストの一覧を管理ノードリストファイルに出力します。

このコマンドは，JP1/IM - Managerの起動状態に関係なく，単体で実行できます。

このコマンドでカウントの対象となるJP1/IM - Managerの管理ノードとは，構成定義情報で定義したホストのJP1/Base，およびリモートの監視対象ホストです。

構成定義に定義していないホストのJP1/Baseは，管理ノードとしてカウントされません。ユーザー自身でカウントしてください。

形式

jimnodecount[ -h 論理ホスト名| -m]
            [ -o 出力ファイル名]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥

UNIXの場合

/opt/jp1imm/bin/

引数

-h 論理ホスト名

クラスタシステムでJP1/IM - Managerを運用している場合に，jimnodecountコマンドが物理ホスト，または論理ホストのどちらの管理ノードをカウントするか指定するオプションです。

-hオプションを指定した場合は，指定した論理ホストの管理ノードをカウントします。

-hオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEに論理ホスト名を設定していない場合は，物理ホストの管理ノードをカウントします。

クラスタシステムでJP1/IM - Managerを運用していない場合，指定は不要です。

-m

クラスタシステムでJP1/IM - Managerを運用している場合に，jimnodecountコマンドが物理ホスト，および論理ホストすべての管理ノードの合計値をカウントするオプションです。

-mオプションを指定した場合は，全管理ノードをカウントします。

-mオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホストの管理ノードをカウントします。環境変数JP1_HOSTNAMEに論理ホスト名を設定していない場合は，物理ホストの管理ノードをカウントします。

-o 出力ファイル名

管理ノードの一覧を出力する，管理ノードリストファイルを指定するオプションです。出力先に同名のファイルがすでにある場合は，ファイル内容を上書きします。

出力ファイル名は，相対パス，または絶対パス形式で指定します。出力ファイル名を相対パスで指定した場合は，jimnodecountコマンドを実行したカレントディレクトリからの相対パスに，管理ノードリストファイルを出力します。ファイル名が「-」で始まるファイルを指定する場合は，オプション指定との区別をするため，「-」で始まらないように，ディレクトリを含む相対パス（「./-hoge」など），または，絶対パスで指定してください。指定できるファイル名は，パスを含めて250バイト以内です。

出力ファイル名にネットワークパスを指定できません。

また，実行環境がWindowsの場合，次に示す文字列はファイル名には指定できません。

「:」，「?」，「"」，「<」，「>」，「|」の文字。

CON，PRN，AUX，NUL，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9のどれかと完全一致する（小文字も含む）文字列。

出力形式

jimnodecountコマンドを実行すると，管理ノード数は次の形式で出力されます。

なお，コマンド実行時にエラーが発生した場合は，管理ノード数は出力されません。

管理ノード数

注意事項

クラスタシステムで複数の論理ホストのJP1/IM - Managerが，同一ホストを管理ノードとして管理している構成では，jimnodecountコマンドに-mオプションを指定して実行した場合，該当のホストが重複してカウントされます。運用に合わせて管理ノード数を減算してください。

戻り値

0

正常終了

43

リモート構成の反映中，またはjcfimportコマンドの実行中にjimnodecountコマンドを実行した

84

引数エラー

85

実行権限エラー

127

その他のエラー

管理ノードリストファイルの形式

管理ノードリストファイルの形式を次に示します。なお，各行の先頭の番号（1〜12）は行番号を示しています。実際のファイルには行番号は出力されません。

 1  出力時刻
 2  The number of managed nodes : 管理ノード数
 3  M  /マネージャーのホスト名
 4  B  /マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseのホスト名
 5  R  /マネージャーのホスト名/リモートの監視対象ホストのホスト名
 6  BR /マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseかつリモートの監視対象ホストのホスト名
 7  B  /マネージャーのホスト名/拠点マネージャーのホスト名
 8  B  /マネージャーのホスト名/拠点マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseのホスト名
 9  R  /マネージャーのホスト名/拠点マネージャーのホスト名/リモートの監視対象ホストのホスト名
10  BR /マネージャーのホスト名/拠点マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseかつリモートの監視対象ホストのホスト名
11  B  /マネージャーのホスト名/中継マネージャーのホスト名
12  B  /マネージャーのホスト名/中継マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseのホスト名

2行目〜12行目が管理ノードブロックになります。管理ノードブロックは，2行目の管理ノード数と3行目〜12行目の管理ノードリストから構成されます。

管理ノードリストファイルの出力形式

出力時刻

jimnodecountコマンドを実行し，管理ノードリストファイルを出力した時刻を出力します。

YYYY/MM/DD hh:mm:ss

（YYYY：年，MM：月，DD：日，hh：時間，mm：分，ss：秒）

管理ノードブロック

出力形式を次に示します。

The number of managed nodes : 管理ノード数

カウントされた管理ノード数が出力されます。

管理ノード数リスト

管理ノードの種別/ホスト名[/ホスト名...]

管理ノードの種別について次に説明します。

種別

説明

M△△

jimnodecountコマンドを実行したマネージャーを示す。

B△△

jimnodecountコマンドを実行したマネージャー以外の構成定義情報で定義したホストのJP1/Baseを示す。

R△△

リモートの監視対象ホストを示す。

BR△

構成定義情報で定義したホストのJP1/Base，かつリモートの監視対象ホストを示す。

（凡例）△：半角スペース

管理ノードブロックは-mオプションの指定の有無で出力形式が異なります。

-mオプションの指定がない場合

-mオプションの指定がない場合，出力される管理ノードブロックは一つです。

-mオプションの指定がない場合の出力例を次に示します。

統合マネージャー

拠点マネージャー

エージェント

物理ホスト（kanri）

tokyo

jp1ag1

osaka

rhost1

jp1ag2

2016/04/28 09:00:00
The number of managed nodes : 6
M  /kanri
B  /kanri/tokyo
B  /kanri/tokyo/jp1ag1
B  /kanri/osaka
R  /kanri/osaka/rhost1
BR /kanri/osaka/jp1ag2

-mオプションの指定がある場合

-mオプションの指定がある場合，出力される管理ノードブロックは複数あります。管理ノードブロックが出力される順番は，物理ホスト，論理ホストの順番です。論理ホストが複数存在する場合は，論理ホスト名の昇順で出力されます。

-mオプションの指定がある場合の出力例を次に示します。

統合マネージャー

拠点マネージャー

エージェント

物理ホスト（kanri）

tokyo

jp1ag1

論理ホスト（kanriL1）

osakaA

jp1ag2

osakaB

jp1ag3

論理ホスト（kanriL2）

nagoyaA

jp1ag4

論理ホスト（kanriL3）

nagoyaB

jp1ag5

2016/11/26 09:00:00
The number of managed nodes : 3
M  /kanri
B  /kanri/tokyo
B  /kanri/tokyo/jp1ag1
The number of managed nodes : 5
M  /kanriL1
B  /kanriL1/osakaA
B  /kanriL1/osakaA/jp1ag2
B  /kanriL1/osakaB
B  /kanriL1/osakaB/jp1ag3
KAVB8201-E またはKAVB8202-Eの英語メッセージ※
The number of managed nodes : 3
M  /kanriL3
B  /kanriL3/nagoyaB
B  /kanriL3/nagoyaB/jp1ag5

注※　論理ホスト（kanriL2）の管理ノード数カウントに失敗すると，KAVB8201-EまたはKAVB8202-Eの英語メッセージが出力されます。メッセージの詳細については，マニュアル「JP1/Integrated Management 2 - Manager メッセージ」を参照してください。

jp1cc_setup（UNIX限定）

機能

JP1/IM - Manager（セントラルコンソール）の動作環境を設定します。

このコマンドは，JP1/IM - ManagerとJP1/Baseがインストールされているマシン上で，JP1/BaseをアンインストールしたあとでJP1/Baseを再インストールした場合だけ，実行する必要があります。Hitachi PP InstallerによるJP1/IM - Managerの新規インストールまたは上書きインストールをした場合は，実行する必要はありません。

形式

jp1cc_setup

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1cons/bin/

戻り値

0

正常終了

1

異常終了

jp1cc_setup_cluster（UNIX限定）

機能

JP1/IM - Manager（セントラルコンソール）の論理ホストの動作環境を設定します。クラスタシステムでの環境設定に使います。

環境設定は，実行系，待機系の順に設定します。

実行系の環境設定では，論理ホスト名と共有ディレクトリ名の指定が必要です。コマンドを実行すると指定した共有ディレクトリに定義ファイルなどがコピーされるため，あらかじめ共有ディスクを使用できる状態にしておいてください。

待機系の環境設定では，論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。

なお，待機系の環境設定をする前に，JP1/Baseのjbsgetcnfコマンドとjbssetcnfコマンドを使って，実行系で設定した共通定義情報を待機系にコピーする必要があります。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cc_setup_cluster -h 論理ホスト名
                   [-d 共有ディレクトリ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1cons/bin/

引数

-h 論理ホスト名

環境を設定する論理ホストのホスト名を指定します。指定できる文字数は，1〜63バイトです。

論理ホスト名は，hostsファイルやネームサーバに設定し，TCP/IP通信ができるようにしてください。

-d 共有ディレクトリ名

系切り替え時に引き継ぐ情報を格納する共有ディレクトリを指定します。共有ディスク上のディレクトリを指定してください。指定できる文字数は，1〜165バイトです。

指定した共有ディレクトリには，次のディレクトリを作成し，定義ファイルを/etc/opt/jp1cons/conf/からコピーします。作成されたディレクトリには適切な権限が設定されます。設定されたディレクトリの権限を変更しないでください。

表1‒49　jp1cc_setup_clusterコマンド実行で作成されるディレクトリ

格納するファイル種別

ディレクトリ

定義ファイル

共有ディレクトリ名/jp1cons/conf/

ログファイル

共有ディレクトリ名/jp1cons/log/

一時ファイル

共有ディレクトリ名/jp1cons/tmp/

履歴ファイル※

共有ディレクトリ名/jp1cons/operation/

注※ 相関イベント発行機能の処理が履歴として出力されます。

必要に応じて，定義ファイルを変更してください。

注意事項

論理ホストの設定は，各ノード単位で実施してください。

実行系の環境設定をする場合は，あらかじめ共有ディスクを使用できる状態にしてから，jp1cc_setup_clusterコマンドを実行してください。

戻り値

0

正常終了

1

異常終了

使用例

次の条件で設定する例を説明します。

論理ホスト名：lnode0
共有ディスク：/shdsk/lnode0

実行系サーバで論理ホスト環境を設定する

jp1cc_setup_cluster -h lnode0 -d /shdsk/lnode0

待機系サーバで論理ホスト環境を設定する

jp1cc_setup_cluster -h lnode0

jp1cf_setup（UNIX限定）

機能

JP1/IM - ManagerのIM構成管理プロセスの動作環境を設定するコマンドです。

このコマンドは，JP1/IM - ManagerとJP1/Baseがインストールされているマシンで，JP1/Baseをアンインストールしたあと，JP1/Baseを再インストールした場合だけ，実行する必要があります。

形式

jp1cf_setup

実行権限

スーパーユーザー権限

格納ディレクトリ

/opt/jp1imm/bin/imcf

戻り値

0

正常終了

1

異常終了

jp1cf_setup_cluster（UNIX限定）

機能

クラスタシステムで運用する場合に，IM構成管理の環境を設定するコマンドです。

IM構成管理のクラスタセットアップは，論理ホストの実行系，待機系の設定の両方に対応します。-dオプションを指定した場合は，実行系を設定します。-dオプションを指定しなかった場合は，待機系を設定します。

それぞれの設定内容を次の表に示します。

表1‒50　実行系の設定，待機系の設定

コマンド実行ホスト

設定項目

設定概要

実行系

論理ホストの共通定義の設定

jbsgetcnf，jbssetcnfコマンドを使用して物理ホストのIM構成管理の共通定義を論理ホストの共通定義として設定する。その際，ディレクトリ名などの設定を変更する。

共有ディレクトリの作成

共有ディレクトリ以下に必要なディレクトリを作成する。

定義ファイルのコピー

/opt/jp1imm/conf/imcf以下の定義ファイルを共有ディレクトリ/jp1imm/conf/imcf以下にコピーする。

論理ホストのセントラルコンソールに対するIM構成管理の起動設定

jcoimdefコマンドを使用して論理ホストのセントラルコンソールのプロセス管理と連動してIM構成管理サービスが起動するようにする。

物理ホストのIM構成管理の通信方式の変更

物理ホストのIM構成管理の通信方式をIPバインド方式に変更する。

待機系

物理ホストの通信方式の変更

同上

共通定義の設定

IM構成管理のクラスタセットアップは，論理ホストの共通定義に対して次の値を設定します。

表1‒51　論理ホストの共通定義

パス

キー名称

設定値

論理ホスト名¥JP1CONF¥

JP1CONFIG_CONFDIR

共有ディレクトリ名/jp1imm/conf/imcf

JP1CONFIG_TMPDIR

共有ディレクトリ名/jp1imm/tmp

JP1CONFIG_LOGDIR

共有ディレクトリ名/jp1imm/log/imcf

JP1CONFIG_DATADIR

共有ディレクトリ名/jp1imm/data/imcf

JP1_BIND_ADDR

IP

共有ディレクトリの作成

IM構成管理のクラスタセットアップは次のディレクトリを作成します。作成されたディレクトリには適切な権限が設定されます。設定されたディレクトリの権限を変更しないでください。

表1‒52　jp1cf_setup_clusterコマンド実行で作成されるディレクトリ

格納するファイル種別

ディレクトリ

定義ファイル

共有ディレクトリ名/jp1imm/conf/imcf

ログファイル

共有ディレクトリ名/jp1imm/log/imcf

一時ファイル

共有ディレクトリ名/jp1imm/tmp

システムの階層構成（IM構成）のデータおよびプロファイルのデータ

共有ディレクトリ名/jp1imm/data/imcf

論理ホストのセントラルコンソールに対するIM構成管理の起動設定

jcoimdefコマンドを実行し，同一論理ホストのセントラルコンソールのプロセス管理に対してIM構成管理の起動設定を追加します。

物理ホストのIM構成管理の通信方式の変更

IM構成管理のクラスタセットアップは，共通定義JP1_DEFAULT¥JP1CONFIG¥以下のJP1_BIND_ADDRの値をIPに変更することで，物理ホストの通信方式の設定をIPバインド方式に変更します。

形式

jp1cf_setup_cluster  -h 論理ホスト名
                     [-d 共有ディレクトリ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1imm/bin/imcf

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。その後，指定した論理ホストに対するデータベースを再編成します。指定できる文字数は，1〜63バイトです。このオプションを省略した場合は，エラーとなります。

-d 共有ディレクトリ名

実行系をセットアップする場合，論理ホストの共有ディレクトリを指定します。指定しなかった場合待機系をセットアップします。指定できる文字数は，1〜165バイトです。

戻り値

0

正常終了

1

異常終了

注意事項

実行系の設定の際は，共有ディレクトリへの定義ファイルのコピー，および監視オブジェクトDBの作成をするため，共有ディスクをマウントする必要があります。

論理ホストの設定は各ノード単位でします。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，OSのマニュアルを参照してください。

jp1cfhasetup（Windows限定）

機能

クラスタシステムで運用する場合に，IM構成管理の環境を設定するコマンドです。

このコマンドを実行する前に，JP1/Baseの論理ホストを設定する必要があります。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cfhasetup

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Managerパス¥bin¥imcf¥

注意事項

jp1cfhasetupコマンドを実行する場合は，先にjp1cohasetupコマンドを実行してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストを設定しておく必要があります。JP1/Baseの設定方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1cohasetup（Windows限定）

機能

JP1/IM - Manager（セントラルコンソール）の論理ホストの動作環境を設定する［Central Consoleクラスタ構成の設定］ダイアログボックスを表示するコマンドです。クラスタシステムでのJP1/IM - Manager（セントラルコンソール）の環境設定で使用します。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cohasetup

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Consoleパス¥bin¥

注意事項

このコマンドは，クラスタシステムでのJP1/IM - Manager（セントラルコンソール）の環境設定で使用します。JP1/IM - Manager（セントラルスコープ）の環境設定をする場合は，jp1cshasetupコマンドを使用してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストを設定しておく必要があります。JP1/Baseの設定方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1cohaverup

機能

JP1/IM - Managerで設定した論理ホスト環境をバージョンアップします。論理ホスト環境のJP1/IM - Managerをバージョンアップした場合に実行してください。

形式

jp1cohaverup -h 論理ホスト名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

バージョンアップする論理ホスト名を指定します。このオプションを省略した場合は，エラーとなります。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していないときにこのコマンドを実行した場合は，エラーとなります。

このコマンドは実行系ホストでだけ実行します。コマンドの実行時は共有ディスクをマウントした状態で実行してください。なお，待機系ホストでは実行しないでください。

このコマンドを実行したあと，必ず実行系ホストの共通定義情報を退避してください。そのあと，退避した共通定義情報ファイルを待機系ホストにコピーし，jbssetcnfコマンドで設定してください。

同一バージョンに対する修正版を上書きインストールした場合は，このコマンドを実行する必要はありません。

戻り値

0

正常終了

1

異常終了

使用例

論理ホストhost01をバージョンアップします。

jp1cohaverup -h host01

出力例

jp1cohaverup -h host01
KAVB9101-I The upgrading of the logical host environment will now start.
KAVB9102-I The upgrading of the logical host environment has finished.

jp1cs_setup（UNIX限定）

機能

JP1/IM - Manager（セントラルスコープ）の動作環境を設定します。

このコマンドは，JP1/IM - ManagerおよびJP1/Baseがインストールされているマシン上で，JP1/BaseをアンインストールしたあとでJP1/Baseを再インストールした場合だけ，実行する必要があります。Hitachi PP InstallerによるJP1/IM - Managerの新規インストールまたは上書きインストールをした場合は，実行する必要はありません。

このコマンドを使用する場合，JP1/IM - Managerを停止してください。

形式

jp1cs_setup

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

戻り値

0

正常終了

1

異常終了

jp1cs_setup_cluster（UNIX限定）

機能

JP1/IM - Manager（セントラルスコープ）の論理ホストの動作環境を設定します。クラスタでの環境設定に使います。

環境設定は，実行系，待機系の順に設定します。

実行系の環境設定では，論理ホスト名と共有ディレクトリ名の指定が必要です。コマンドを実行すると指定した共有ディレクトリに定義ファイルなどがコピーされるため，あらかじめ共有ディスクを使用できる状態にしておいてください。

待機系の環境設定では，論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。

なお，待機系の環境設定をする前に，JP1/Baseのjbsgetcnfコマンドとjbssetcnfコマンドを使って，実行系で設定した共通定義情報を待機系にコピーする必要があります。

このコマンドを使用する場合，JP1/IM - Managerを停止してください。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cs_setup_cluster -h 論理ホスト名
                   [-d 共有ディレクトリ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

引数

-h 論理ホスト名

環境を設定する論理ホストのホスト名を指定します。指定できる文字数は，1〜63バイトです。

論理ホスト名は，hostsファイルやネームサーバに設定し，TCP/IP通信ができるようにしてください。

-d 共有ディレクトリ名

系切り替え時に引き継ぐ情報を格納する共有ディレクトリを指定します。共有ディスク上のディレクトリを指定してください。指定できる文字数は，1〜165バイトです。

指定した共有ディレクトリには，次のディレクトリを作成し，定義ファイルを/etc/opt/jp1scope/conf/からコピーします。作成されたディレクトリには適切な権限が設定されます。設定されたディレクトリの権限を変更しないでください。

表1‒53　jp1cs_setup_clusterコマンド実行で作成されるディレクトリ

格納するファイル種別

ディレクトリ

定義ファイル

共有ディレクトリ名/jp1scope/conf/

ログファイル

共有ディレクトリ名/jp1scope/log/

一時ファイル

共有ディレクトリ名/jp1scope/tmp/

DB情報

共有ディレクトリ名/jp1scope/database/

必要に応じて，定義ファイルを変更してください。

注意事項

論理ホストの設定は，各ノード単位で実施してください。

実行系の環境設定をする場合は，あらかじめ共有ディスクを使用できる状態にしてから，jp1cs_setup_clusterコマンドを実行してください。

戻り値

0

正常終了

1

異常終了

使用例

次の条件で設定する例を説明します。

論理ホスト名：lnode0
共有ディスク：/shdsk/lnode0

実行系サーバで論理ホスト環境を設定する

jp1cs_setup_cluster -h lnode0 -d /shdsk/lnode0

待機系サーバで論理ホスト環境を設定する

jp1cs_setup_cluster -h lnode0

jp1cshasetup（Windows限定）

機能

JP1/IM - Manager（セントラルスコープ）の論理ホストの動作環境を設定する［Central Scopeクラスタ構成の設定］ダイアログボックスを表示するコマンドです。クラスタシステムでのJP1/IM - Manager（セントラルスコープ）の環境設定で使用します。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cshasetup

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Scopeパス¥bin¥

注意事項

このコマンドは，クラスタシステムでのJP1/IM - Manager（セントラルスコープ）の環境設定で使用します。JP1/IM - Manager（セントラルコンソール）の環境設定をする場合は，jp1cohasetupコマンドを使用してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストの設定をしておく必要があります。JP1/Baseの設定作業については，マニュアル「JP1/Base 運用ガイド」のクラスタシステムで運用する場合の設定の章を参照してください。

また，事前にJP1/IM - Manager（セントラルコンソール）の論理ホストの設定をしておく必要があります。

jp1cshaverup（UNIX限定）

機能

JP1/IM - Managerで設定した論理ホスト環境をバージョンアップします。論理ホスト環境のJP1/IM - Managerをバージョンアップした場合に実行してください。

形式

jp1cshaverup -h 論理ホスト名
             [-w 作業ディレクトリ]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

注　このコマンドは，Linux版JP1/IM - Managerには同梱されていません。

引数

-h 論理ホスト名

バージョンアップする論理ホスト名を指定します。このオプションを省略した場合は，エラーとなります。

-w 作業ディレクトリ

JP1/IM - Manager（セントラルスコープ）の論理ホスト環境をバージョンアップするための作業ディレクトリをフルパスで指定します。

このオプションを省略した場合は，/opt/jp1scope/tmp/を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

jp1cshaverupコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）として動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0

正常終了

1

指定した論理ホスト名が存在しない

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

13

ディスク容量不足

31

DB初期化エラー

32

データアクセスエラー

42

サービスが起動中

45

新しいバージョンのデータベースに対してコマンドを実行しようとした

99

その他のエラー

使用例

作業ディレクトリ/temp/で，08-01のJP1/IM - Manager（セントラルスコープ）の論理ホスト環境logicalhostをバージョンアップします。

jp1cshaverup -h logicalhost -w /temp

出力例

クラスタ環境のバージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1cshaverup.bat（Windows限定）

機能

JP1/IM - Managerで設定した論理ホスト環境をバージョンアップします。論理ホスト環境のJP1/IM - Managerをバージョンアップした場合に実行してください。

形式

jp1cshaverup.bat -h 論理ホスト名
                [-w 作業ディレクトリ]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Scopeパス¥bin¥

引数

-h 論理ホスト名

バージョンアップする論理ホスト名を指定します。このオプションを省略した場合は，エラーとなります。

-w 作業ディレクトリ

JP1/IM - Manager（セントラルスコープ）の論理ホスト環境をバージョンアップするための作業フォルダをフルパスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

このオプションを省略した場合は，Scopeパス¥tmp¥を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

jp1cshaverup.batコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）として動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0

正常終了

1

指定した論理ホスト名が存在しない

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

13

ディスク容量不足

31

DB初期化エラー

32

データアクセスエラー

42

サービスが起動中

45

新しいバージョンのデータベースに対してコマンドを実行しようとした

99

その他のエラー

使用例

作業フォルダC:¥temp¥で，08-01のJP1/IM - Manager（セントラルスコープ）の論理ホスト環境logicalhostをバージョンアップします。

jp1cshaverup -h logicalhost -w C:¥temp

出力例

クラスタ環境のバージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1csverup（UNIX限定）

機能

08-01以前のJP1/IM - Manager（セントラルスコープ）で設定した物理ホストの環境をバージョンアップします。08-01以前のJP1/IM - Manager（セントラルスコープ）からバージョンアップした場合に実行してください。

インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）の機能を使用したい場合には必ず実行してください。ただし，08-01以前の機能範囲で使用したい場合には，実行しないでください。

形式

jp1csverup [-w 作業ディレクトリ]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

注　このコマンドは，Linux版JP1/IM - Managerには同梱されていません。

引数

-w 作業ディレクトリ

JP1/IM - Manager（セントラルスコープ）の物理ホストの環境をバージョンアップするための作業ディレクトリをフルパスで指定します。

このオプションを省略した場合は，/opt/jp1scope/tmp/を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

このコマンドを実行する前にディスクの空き容量を確認してください。このコマンドを実行するには，監視オブジェクトDB分の空き容量が必要です。監視オブジェクトDBは，次に示すディレクトリ内のすべてのデータです。

/var/opt/jp1scope/database/jcsdb/

jp1csverupコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）として動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0

正常終了

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

13

ディスク容量不足

31

DB初期化エラー

32

データアクセスエラー

42

サービスが起動中

45

新しいバージョンのデータベースに対してコマンドを実行しようとした

99

その他のエラー

使用例

作業ディレクトリ/temp/で，08-01のJP1/IM - Manager（セントラルスコープ）の物理ホスト環境をバージョンアップします。

jp1csverup -w /temp

出力例

バージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1csverup.bat（Windows限定）

機能

08-01以前のJP1/IM - Manager（セントラルスコープ）で設定した物理ホストの環境をバージョンアップします。08-01以前のJP1/IM - Manager（セントラルスコープ）からバージョンアップした場合に実行してください。

インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）の機能を使用したい場合には必ず実行してください。ただし，08-01以前の機能範囲で使用したい場合には，実行しないでください。

形式

jp1csverup.bat [-w 作業ディレクトリ]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Scopeパス¥bin¥

引数

-w 作業ディレクトリ

JP1/IM - Manager（セントラルスコープ）の物理ホストの環境をバージョンアップするための作業フォルダをフルパスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

このオプションを省略した場合は，Scopeパス¥tmp¥を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

このコマンドを実行する前にディスクの空き容量を確認してください。このコマンドを実行するには，監視オブジェクトDB分の空き容量が必要です。監視オブジェクトDBは，次に示すフォルダ内のすべてのデータです。

Scopeパス¥database¥jcsdb¥

jp1csverup.batコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）として動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0

正常終了

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

13

ディスク容量不足

31

DB初期化エラー

32

データアクセスエラー

42

サービスが起動中

45

新しいバージョンのデータベースに対してコマンドを実行しようとした

99

その他のエラー

使用例

作業フォルダC:¥tempで，08-01のJP1/IM - Manager（セントラルスコープ）の物理ホスト環境をバージョンアップします。

jp1csverup -w C:¥temp

出力例

バージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

SpmSetSvcCon（Windows限定）

機能

JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を設定，または解除するコマンドです。また，論理ホストからJP1/IM - Managerだけを削除する場合に，論理ホストのJP1/IM-Managerサービスを削除することもできます。

形式

SpmSetSvcCon {-setdepend {yes|no} | -d -h 論理ホスト名}

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Consoleパス¥bin¥

引数

-setdepend {yes|no}

登録してあるサービスに対して，依存関係を設定します。

yes：JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を設定します。

no：JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を解除します。

-d -h 論理ホスト名

論理ホストからJP1/IM - Managerだけを削除する場合に指定します。論理ホストからJP1/IM - Managerだけを削除する手順については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「7.6.1(3)　論理ホストからJP1/IM - ManagerおよびIMデータベースだけを削除する手順」を参照してください。

戻り値

0

正常終了

1

引数エラー

2

実行権限エラー

3

JP1/IM-Managerサービスが登録されていない

255

その他のエラー

2　定義ファイル

この章では，JP1/IMの定義ファイルの形式および文法について説明します。

定義ファイル一覧

JP1/Integrated Managementの定義ファイルの一覧を次に示します。

定義ファイル一覧

表2‒1　定義ファイル一覧

製品名

定義ファイル名

説明

JP1/Base

構成定義ファイル（jbs_route.conf）

JP1/IMで管理するシステムの階層構造を定義するファイルです。構成定義ファイル（jbs_route.conf）の詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

環境変数ファイル

JP1/IMの管理対象ホストでコマンドを実行するときの環境変数を定義するファイルです。環境変数ファイルの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ホストグループ定義ファイル

JP1/IMの管理対象ホストのグループを定義するファイルです。ホストグループ定義ファイルの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/IM - Manager

JP1/IM - Manager

共通定義設定用ファイル（JP1イベントの属性変更）

JP1イベントの属性を変更するファイルです。

操作ログ定義ファイル（imm_operationlog.conf）

操作ログの出力の有無，出力先，サイズ，および保存面数を定義するファイルです。

インテリジェント統合管理基盤

インテリジェント統合管理基盤定義ファイル（imdd.properties）

インテリジェント統合管理基盤のシステム関連の設定値を定義するファイルです。

システムノード定義ファイル（imdd_systemnode.conf）

サンバースト形式やツリー形式で表示するシステムの階層構造を定義し，収集したデータを定義したホストでグルーピングする設定ファイルです。

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）

サンバースト形式やツリー形式で表示する管理グループのIM管理ノードカテゴリの名称を定義するファイルです。

構成取得対象ホスト定義ファイル（imdd_target_host.conf）

監視オブジェクトの情報を取得する際に，製品ごとに取得先のホストを定義する設定ファイルです。

ホスト名定義ファイル（imdd_host_name.conf）

エイリアス名と実ホスト名のマッピングを定義するファイルです。

IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）

IM管理ノード間の関連を定義するファイルです。

セントラルコンソール

発生元ホストマッピング定義ファイル（user_hostmap.conf）

発生元ホストのマッピングを定義するファイルです。

自動アクション環境定義ファイル（action.conf.update）

自動アクションの実行環境を定義するファイルです。

自動アクション定義ファイル（actdef.conf）

自動アクションのアクションを実行する条件と，アクションとして実行するコマンドについて定義するファイルです。

自動アクション定義ファイル（actdef.conf）（互換用）

互換用に自動アクションのアクションを実行する条件と，アクションとして実行するコマンドについて定義するファイルです。

自動アクション通知定義ファイル（actnotice.conf）

自動アクションの状態通知機能を有効にするかどうかを定義するファイルです。

拡張起動プロセス定義ファイル（jp1co_service.conf）

JP1/IM - Managerを構成する機能のプロセス情報を定義するファイルです。

IMパラメーター定義ファイル（jp1co_param_V7.conf）

JP1/IM - Managerのプロセスの異常，また，異常終了からの自動復旧時にJP1イベントを発行するかどうかを定義するファイルです。

システムプロファイル（.system）

イベントコンソールの基本動作に関する環境情報を定義するファイルです。

ユーザープロファイル（defaultUser | profile_ユーザー名）

イベントコンソールの画面表示に関する環境情報を定義するファイルです。

通信環境定義ファイル（console.conf.update）

JP1/IM - Managerとビューアー，jcochstatコマンドとの通信処理（タイムアウト時間）を定義するファイルです。

ヘルスチェック定義ファイル（jcohc.conf）

ヘルスチェック機能を有効にするかどうかを定義するファイルです。

イベントガイド情報ファイル（jco_guide.txt）

システムで発生した問題となるJP1イベントに対して，JP1イベント単位でイベントガイド情報を定義するファイルです。

対処状況イベント定義ファイル（processupdate.conf）

対処状況を変更したときにJP1イベントを発行するかどうかを定義するファイルです。

相関イベント発行システムプロファイル（egs_system.conf）

相関イベント発行サービスの起動時および停止時の動作を定義するファイルです。

相関イベント発行定義ファイル

相関イベントの発行処理の対象とするJP1イベントの条件と条件成立時に発行する相関イベントを定義するファイルです。

相関イベント発行環境定義ファイル

相関イベント発行履歴ファイルのサイズおよび面数を定義するファイルです。

インシデント手動登録定義ファイル（incident.conf）

JP1/Service Support連携用の定義ファイルです。JP1/IM - Viewの連携先JP1/Service Supportを定義するファイルです。

インシデント引き継ぎ情報設定ファイル（incident_info.conf）

JP1/Service Supportとの連携で，インシデントとして登録する任意のJP1イベントの属性または文字列を定義するファイルです。

重大度変更定義ファイル（jcochsev.conf）

イベントの重大度変更機能で，重大度を変更するJP1イベントの条件と変更後の重大度を定義するファイルです。

コマンドボタン定義ファイル（cmdbtn.conf）

［コマンド実行］画面に表示する［コマンド］ボタンを定義するファイルです。

イベント条件表示項目定義ファイル（attr_list.conf）

［アクション詳細設定］画面の［属性名］表示領域に表示する表示項目を指定する定義ファイルです。

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

自動アクション，およびコマンド実行のイベント引き継ぎ機能の変換ルールを指定するファイルです。

イベントレポート出力の項目ファイル

イベントレポート出力で出力したいJP1イベントの属性を指定するファイルです。

イベントレポート出力環境定義ファイル（evtreport.conf）

イベントレポート出力機能の実行環境の情報を定義するファイルです。

イベントレポート出力のフィルターファイル

イベントレポート出力時のフィルター条件を指定する定義ファイルです。

システムカラー定義ファイル（systemColor.conf）

イベント一覧に使用する色の設定を定義するファイルです。

イベント拡張属性定義ファイル

JP1イベントの拡張属性を定義するファイルです。

イベント拡張属性定義ファイル（拡張ファイル）

JP1イベントの固有の拡張属性を項目名で画面に表示したり，イベントレポート出力したりする設定を定義するファイルです。

オブジェクトタイプ定義ファイル

JP1イベントの拡張属性のオブジェクトタイプを定義するファイルです。

共通除外条件拡張定義ファイル

拡張モードの共通除外条件のイベント条件や適用期間を定義するファイルです。

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）

［共通除外条件設定(拡張)］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）

［繰り返しイベント条件設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）

［繰り返しイベント条件設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）

［重大度変更定義設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）

［重大度変更定義設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。

モニター画面呼び出し定義ファイル

モニター画面呼び出しの設定を定義するファイルです。

メール環境定義ファイル（jimmail.conf）

JP1/IM - Managerでメール送信するときに，必要な情報を設定する定義ファイルです。

表示メッセージ変更定義ファイル（jcochmsg.conf）

イベントの表示メッセージ変更機能で，メッセージの表示を変更するJP1イベントの条件と変更後のメッセージを定義するファイルです。

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）

［表示メッセージ変更定義設定］画面の［属性名］表示領域に表示する表示項目を指定する定義ファイルです。

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）

［表示メッセージ変更定義設定］画面を開いたときに，自動で設定される条件を設定する定義ファイルです。

表示メッセージ変更後イベント環境定義ファイル（chmsgevent.conf）

表示メッセージ変更したイベントを発行する機能の動作を定義するファイルです。

セントラルスコープ

ホスト情報ファイル（jcs_hosts）

JP1/IM - Manager（セントラルスコープ）が管理するホスト情報を定義するファイルです。

ガイド情報ファイル（jcs_guide_xxx.txt）※1

監視オブジェクトの状態変更の契機となったJP1イベントに関するガイド情報を定義するファイルです。

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）※2

監視オブジェクトの状態変更イベントの件数が上限を超えた場合に，JP1イベントを発行するかどうかを定義するファイルです。

対処済み連動設定ファイル（action_complete_xxx.conf）※2

対処済み連動機能を有効にするかどうかを定義するファイルです。

状態変更イベント自動削除設定ファイル

JP1イベントの対処状況を「対処済」にしたときに，状態変更イベントを自動削除する機能を有効にするかどうかを定義するファイルです。

監視オブジェクト初期化設定ファイル

特定のJP1イベントを受信したときに，監視オブジェクトを初期化する機能を有効にするかどうかを定義するファイルです。

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）※2

監視ツリー更新中の，OSのシャットダウンやクラスタシステムの系切り替え発生による，監視オブジェクトDBの破損を防ぐための機能を有効にするかどうかを定義するファイルです。

状態変更条件メモリー常駐機能の設定ファイル

状態変更条件メモリー常駐機能を有効にするかどうかを設定するファイルです。

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）※1

セントラルスコープ・ビューアーの共通の定義情報です。

セントラルスコープにログインすると，セントラルスコープ・ビューアーに送信されます。

IM構成管理

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

IM構成管理・ビューアーの動作を指定するファイルです。

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

システムの階層構成の反映方式を定義するファイルです。

ホスト入力情報ファイル（host_input_data.csv）

IM構成管理の管理対象ホストに関するホスト入力情報のエクスポートファイルです。

ホスト収集情報ファイル（host_collect_data.csv）

IM構成管理の管理対象ホストに関するホスト収集情報のエクスポートファイルです。

プロファイル管理環境定義ファイル（jp1cf_profile_manager.conf）

プロファイル管理機能の実行環境の情報を定義するファイルです。

リモートログトラップ環境定義ファイル（jp1cf_remote_logtrap.conf）

リモート監視ログファイルトラップ機能とリモート監視イベントログトラップ機能の実行環境を定義するファイルです。

リモート監視ログファイルトラップ動作定義ファイル

リモート監視のログトラップ機能の動作を定義するファイルです。

リモート監視イベントログトラップ動作定義ファイル

リモート監視のイベントログトラップ機能の動作を定義するファイルです。

IMデータベース

セットアップ情報ファイル（jimdbsetupinfo.conf）

統合監視DBおよびIM構成管理DBのセットアップ時に，IMデータベースのサイズやIMデータベースのデータを格納するディレクトリなどを記述するファイルです。

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

統合監視DBおよびIM構成管理DBのクラスタ環境のセットアップ時に，論理ホスト用のIMデータベースのサイズや論理ホスト用のIMデータベースのデータを格納するディレクトリなどを記述するファイルです。

JP1/IM - View

通信環境定義ファイル（view.conf.update）

JP1/IM - ViewとJP1/IM - Manager（セントラルコンソール）間の通信でのタイムアウト時間を定義するファイルです。

通信環境定義ファイル（tree_view.conf.update）

JP1/IM - ViewとJP1/IM - Manager（セントラルスコープ）間の通信でのタイムアウト時間を定義するファイルです。

非暗号化通信ホスト設定ファイル（nosslhost.conf）

非暗号化通信をするホストを設定するファイルです。

IM-View設定ファイル（tuning.conf）

ログイン画面での接続先ホスト入力履歴数，イベントコンソール画面表示時の動作などJP1/IM - Viewの動作を定義するファイルです。

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

統合機能メニューから他製品のWWWページを呼び出すときに使用するファイルです。

起動プログラム定義ファイル（!JP1_CS_APP0.conf）

監視ツリー画面のツールバーに追加するプログラムの起動パスを定義するファイルです。

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）

監視ツリー画面のツールバーに追加するプログラムの並び順を定義するファイルです。

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）

監視ツリー画面のツールバーに追加するアイコンの動作を定義するファイルです。

ツリー構成ファイル

監視ツリー画面に表示される監視ツリーのツリー構成を定義したファイルです。

アプリケーション実行定義ファイル

ビューアーで実行するアプリケーションのIDとパスを定義するファイルです。

統合機能メニュー定義ファイル

統合機能メニューに表示するツリーを定義するファイルです。

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）

セントラルスコープ・ビューアーの共通の定義情報です。

［監視ツリー（編集中）］画面と［ビジュアル監視（編集中）］画面を定義します。

性能レポート表示定義ファイル（performance.conf）

事象発生元ホストの性能レポート表示機能の定義ファイルです。接続先のJP1/PFM - Web ConsoleのURLを定義します。

注※1　システムプロファイル（セントラルスコープ），およびJP1/IM - ManagerのUNIX版で使用するガイド情報ファイルは，JP1/IM - Managerが動作する言語コードによってファイル名が異なります。xxx部分については，以降の各ファイルの詳細で説明します。

注※2　状態変更イベント件数の上限監視設定ファイル，対処済み連動設定ファイル，および監視オブジェクトDBの自動バックアップ・リカバリー設定ファイルはそれぞれ二つあります。xxx部分には，on，offのどちらかが入ります。

定義ファイルの記述形式

定義ファイルの記述形式について説明します。ただし，定義ファイルによっては説明しない項目もあります。なお，定義ファイル名や定義ファイル内に環境依存文字を使用すると，定義に文字化けが発生することがあるため，使用しないでください。

形式

定義ファイルの形式について説明しています。

ファイル

定義ファイルのファイル名について説明しています。

格納先ディレクトリ

定義ファイルの格納場所について説明しています。

説明

定義ファイルの用途について説明しています。

定義の反映時期

定義ファイルが反映されるタイミングについて説明しています。

記述内容

定義ファイルの記述内容について説明しています。

定義例

定義ファイルの定義例について説明しています。

ユーザー独自のイベント属性を表示するための定義ファイルについて

JP1/IMの定義ファイルをカスタマイズすることによって，ほかのアプリケーションがJP1/IMと連携するための機能を拡張できるようになります。

JP1/IMの定義ファイルのカスタマイズ

機能を拡張すると，次のことができます。

ユーザー独自のイベント属性を表示する

JP1/IM - Viewに表示されたJP1イベントからモニター画面を表示する

［統合機能メニュー］画面に新規メニューを追加する

注意事項

カスタマイズした定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

機能の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.14　ユーザー独自のイベント属性の表示」を参照してください。

定義ファイルの概要

定義ファイルの中で，定義を記述するブロック間には関連があります。また，定義ファイル間にも関連があります。それらの関連を次の図に示します。

図2‒1　定義ブロックおよび定義ファイルの関連

定義ファイルの命名規則

定義ファイルの命名規則を次に示します。

表2‒2　定義ファイルの命名規則

定義ファイル名

命名規則

イベント拡張属性定義ファイル

会社名_製品名_attr_ja.conf

オブジェクトタイプ定義ファイル

会社名_製品名_obj.ja

アプリケーション実行定義ファイル

会社名_製品名_app.conf

モニター画面呼び出し定義ファイル

会社名_製品名_mon.conf

統合機能メニュー定義ファイル

会社名_製品名_tree.conf

なお，「製品名」は，「シリーズ名_製品名」とすることもできます。JP1イベント発行時の「PRODUCT_NAME」に指定する値の「/」を「_」に変更してファイル名に使用することをお勧めします。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

定義ファイルの格納先

それぞれの定義ファイルの格納先を次に示します。

表2‒3　定義ファイルの格納先

定義ファイル名

格納先

イベント拡張属性定義ファイル

JP1/IM - Managerがインストールされたマシン

モニター画面呼び出し定義ファイル

JP1/IM - Managerがインストールされたマシン

オブジェクトタイプ定義ファイル

JP1/IM - Managerがインストールされたマシン

アプリケーション実行定義ファイル

JP1/IM - Viewがインストールされたマシン

統合機能メニュー定義ファイル

JP1/IM - Viewがインストールされたマシン

定義ファイルの構造

ここでは，［イベントコンソール］画面，［統合機能メニュー］画面と連携するためにカスタマイズできるJP1/IMの定義ファイルに共通する事項について説明します。

なお，この節の説明は次の三つの定義ファイルだけに該当します。

イベント拡張属性定義ファイル

アプリケーション実行定義ファイル

統合機能メニュー定義ファイル

オブジェクトタイプ定義ファイルおよびモニター画面呼び出し定義ファイルは，それぞれ構造が異なります。

定義ファイルの構成要素

定義ファイルを構成する要素には，大きく分けて，ステートメント，ブロック，およびコメントがあります。定義ファイルは，そのファイル全体の属性を表すステートメント（定義情報ヘッダー）から開始し，定義内容を記述するブロック，および任意選択のコメントが続きます。

定義ファイルを構成するこれらの要素について説明します。

ステートメント

ステートメントの構造

ステートメントとは，複数の構成要素が組み合わされて一つの意味を形成するようになった列のことです。ステートメントは必ず行頭から開始しなければなりません。また，ステートメントは「;」と改行で区切らなければなりません。

ステートメントの種別

ステートメントは，記述できる場所によって「ファイル内ステートメント」と「ブロック内ステートメント」に分けられます。

ファイル内ステートメント

ファイル内ステートメントは，定義ファイルの属性を表すステートメントです。ファイル内ステートメントには，さらに「定義情報ヘッダー用ステートメント」と「ブロック制御用ステートメント」の二つがあります。

ファイル内ステートメントには「@」のプリフィックスが付きます。

ブロック内ステートメント

ブロック内ステートメントは，ブロック内の属性を表すステートメントです。ブロック内ステートメントは，ブロック開始ステートメント（@define-block）からブロック終了ステートメント（@define-block-end）までの間に記述できるステートメントのうち，コメント以外のものを指します。記述できるブロック内ステートメントは，ブロックごとに決まっています。

ブロック内ステートメントには「@」などのプリフィックスは付きません。

ブロック

ブロックの構造

ブロックはステートメントの集合体です。ブロックは，ブロックの開始を宣言するステートメント（@define-block），実際の定義を記述するブロック内ステートメント，コメント，およびブロックの終了を宣言するステートメント（@define-block-end）によって構成されます。

定義ファイルの中でブロックをネストできません。

ブロックの種別

ブロック種別は，ブロック開始ステートメント（@define-block）の「type=」パラメーターで指定します。ブロック種別の詳細については，「@define-blockステートメント」を参照してください。

ブロックの優先順位

ブロックには，定義内でユニークでなければならないキー項目があります。キー項目が定義内に複数個存在した場合は，優先順位に従ってブロック単位で取捨選択されます。ブロックの優先順位は次のようになります。

ファイル名を昇順にソートしてあとの方のファイル内のブロック

ファイル内で記述場所があとの方に存在するブロック

言い換えると，「定義ファイルをファイル名で昇順にソートして一つのファイルに連結し，連結したファイル内であとに記述されているものが優先される」ということになります。

コメント

コメントとは，行頭が「#」のステートメント，または1行が空白，タブ，または改行だけで構成される行です。コメントは定義情報としての意味を持ちません。

コメントは一つのステートメントとして処理されます。コメントは行単位で判断されるので，「;」で区切る必要はありません。コメントの末尾に「;」を付けた場合は，「;」もコメントの一部として解釈されます。

共通ステートメントの生成規則

ファイル内ステートメントには，定義情報ヘッダー用ステートメントとブロック制御用ステートメントの二つがあります。

ファイル内ステートメントの一覧を次に示します。

表2‒4　ファイル内ステートメントの一覧

ステートメント名

意味

種別

@file

定義バージョンを宣言する

定義情報ヘッダー用

@product

定義中のPP情報を宣言する

定義情報ヘッダー用

@define-block

ブロックの開始を宣言する

ブロック制御用

@define-block-end

ブロックの終了を宣言する

ブロック制御用

これらのステートメントのうち，定義情報ヘッダー用ステートメントは，一つの定義ファイル全体に共通する属性を定義します。使用できる定義情報ヘッダー用ステートメントは定義ファイルごとに異なります。また，定義情報ヘッダー用ステートメントのパラメーターも，定義ファイルごとに異なります。

ブロック制御用ステートメントは，その定義ファイル内で定義するブロックの単位を宣言するために使用します。ブロック制御用ステートメントの生成規則は，すべての定義ファイルで共通です。

このあとに，ブロック制御用ステートメントの生成規則を示します。定義情報ヘッダー用ステートメントの生成規則については，個々の定義ファイルの説明を参照してください。

@define-blockステートメント

構文

@define-block type="ブロック種別";

機能

ブロックの開始を宣言します。このステートメントから @define-block-endステートメントまでを一つの定義ブロックとして扱います。

パラメーター

・type="ブロック種別"

定義ブロックの種類を指定します。指定できるブロック種別を次に示します。

表2‒5　ブロック種別一覧

ブロック名

パラメーターでの指定値

イベント属性定義ブロック

"event-attr-def"

イベント属性グループ定義ブロック

"event-attr-group-def"

イベント表示順序定義ブロック

"event-attr-order-def"

アプリケーション実行定義ブロック

"application-execution-def"

機能ツリーメニュー定義ブロック

"function-tree-def"

無効なブロック種別が指定された場合は，ブロック全体が無視されて警告が表示されますが，ファイルの解析処理は続行されます。

注意事項

定義ブロックをネストできません。

定義例

@define-block-endステートメントの説明を参照してください。

@define-block-endステートメント

構文

@define-block-end;

機能

@define-blockから始まる定義ブロックの終了を宣言します。

注意事項

対応する@define-blockステートメントがない場合は，ファイルの解析処理を中止します。

定義例

@define-blockステートメントおよび@define-block-endステートメントの定義例を示します。

@define-block type="event-attr-def";
block lang="Japanese", platform="base", extended="false";
attr name="E.SEVERITY", title="重大度";
attr name="B.TIME", title="登録時刻";
attr name="B.SOURCESERVER", title="登録ホスト";
attr name="E.USER_NAME", title="ユーザー名";
@define-block-end;

共通定義設定用ファイル（JP1イベントの属性変更）

形式

[JP1_DEFAULT¥JP1CONFIG]
"ATTR_EVENT_LOGTRAP_SOURCEHOST"=dword:{00000000 | 00000001}

ファイル

任意

jp1im_jp1_event_attributes.conf.model（共通定義設定用ファイル（JP1イベントの属性変更）のモデルファイル）

格納先ディレクトリ

共通定義設定用ファイル（JP1イベントの属性変更）のモデルファイルの格納先ディレクトリを次に示します。モデルファイルをコピーして，任意のファイル名で作成してください。

Windowsの場合

Managerパス¥conf

UNIXの場合

/etc/opt/jp1imm/conf

説明

イベントログトラップの発生元属性についての情報を共通定義情報に設定するファイルです。

定義の反映時期

jbssetcnfコマンドを実行すると，共通定義設定用ファイル（JP1イベントの属性変更）の情報が共通定義情報に登録されます。そのあと，JP1/IM - Managerを再起動すると，共通定義情報の設定が有効になります。共通定義を変更した場合は，必ずJP1/IM - Managerを再起動してください。

記述内容

共通定義設定用ファイル（JP1イベントの属性変更）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1CONFIG]

この行は変更しないでください。

"ATTR_EVENT_LOGTRAP_SOURCEHOST"=dword:{00000000 | 00000001}

JP1/IM - Managerで監視するJP1/Baseイベントログトラップ，およびリモート監視イベントログトラップのJP1イベントの発生元ホスト名属性にマッピングする属性を決定します。

「00000000」または「00000001」のどちらかを指定します。デフォルト値は「00000000」です。

「00000000」を指定した場合，JP1イベント（イベントID=3A71）の発生元ホスト名にコンピュータ名をマッピングします。

「00000001」を指定した場合，JP1/BaseのイベントログトラップによるJP1イベント（3A71）の発生元ホスト名にイベントサーバ名をマッピングします。また，リモート監視イベントログトラップによるJP1イベント（3A71）に発生元ホスト名の属性が追加され，発生元ホスト名として監視対象ホスト名が表示されます。

JP1/BaseイベントログトラップのJP1イベント（3A71）の発生元ホスト名にマッピングする属性については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「13.3.11(2)(b)　JP1イベントの属性を変更する（JP1/IM - Managerの設定）」を参照してください。

リモート監視イベントログトラップのJP1イベント（3A71）については，「3.2.2(97)　イベントID：00003A71またはリモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細」を参照してください。

操作ログ定義ファイル（imm_operationlog.conf）

形式

[論理ホスト名¥JP1IMM¥OPERATION]
"ENABLE"=dword:16進数
"LOGFILEDIR"="出力先"
"LOGSIZE"=dword:16進数
"LOGFILENUM"=dword:16進数

ファイル

imm_operationlog.conf

imm_operationlog.conf.model（操作ログ定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf

UNIXの場合

/etc/opt/jp1imm/conf

説明

操作ログ出力機能で使用する共通定義の内容を指定するファイルです。操作ログの出力の有無，出力先，サイズ，および保存面数を定義します。

定義の反映時期

jbssetcnfコマンドを実行すると，操作ログ定義ファイル（imm_operationlog.conf）の情報が共通定義情報に登録されます。そのあと，JP1/IM - Managerを再起動すると，共通定義情報の設定が有効になります。共通定義を変更した場合は，必ずJP1/IM - Managerを再起動してください。

記述内容

[論理ホスト名¥JP1IMM¥OPERATION]

JP1/IM - Managerの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"ENABLE"=dword:16進数

操作ログの出力を有効にするか無効にするかを16進数で指定します。未定義，または次に示す値以外を指定した場合，初期値を仮定します。

初期値：0x00000000

操作ログの出力を無効にする場合：0x00000000

操作ログの出力を有効にする場合：0x00000001

"LOGFILEDIR"="出力先"

操作ログファイル（imm_operation.log）の出力先を絶対パス形式で指定します。出力先の最大長は217バイトです。出力先には存在し，かつ書き込みできるディレクトリを指定してください。論理ホスト側の操作ログは，共有ディスク上に出力するように指定することをお勧めします。

初期値

Windowsの場合：Managerパス¥log¥operationlog

UNIXの場合：/var/opt/jp1imm/log/operationlog

論理ホストの場合の出力先例

Windowsの場合：共有フォルダ¥JP1IMM¥log¥operationlog

UNIXの場合：共有ディレクトリ/jp1imm/log/operationlog

出力先にネットワークパスを指定できません。

また，実行環境がWindowsの場合，次に示す文字列は出力先には指定できません。

「:」，「?」，「"」，「<」，「>」，「|」の文字。

CON，PRN，AUX，NUL，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9のどれかと完全一致する（小文字も含む）文字列。

"LOGSIZE"=dword:16進数

操作ログファイル（imm_operation.log）のサイズを16進数で指定します。単位はメガバイトです。未定義，または指定できる範囲以外の値を指定した場合は，初期値を仮定します。

初期値：0x00000005（5MB）

指定できる範囲：0x00000001〜0x00000800（1MB〜2,048MB）

"LOGFILENUM"=dword:16進数

操作ログファイル（imm_operation.log）の保存する面数を16進数で指定します。未定義，または指定できる範囲以外の値を指定した場合は，初期値を仮定します。

初期値：0x0000000A（10面）

指定できる範囲：0x00000001〜0x00000010（1〜16面）

定義例

1ファイル当たり5メガバイトの操作ログを出力して，10ファイルまで保存する場合の定義例を次に示します。なお，次に示す定義例はJP1/IM - ManagerのOSがUNIX，かつ物理ホストの場合の例です。

[JP1_DEFAULT¥JP1IMM¥OPERATION]
"ENABLE"=dword:00000001
"LOGFILEDIR"="/var/opt/jp1imm/log/operationlog"
"LOGSIZE"=dword:00000005
"LOGFILENUM"=dword:0000000A

インテリジェント統合管理基盤定義ファイル（imdd.properties）

形式

server.port=ポート番号
jp1.imdd.proxy.server[n].host=プロキシサーバー[n]のホスト名
jp1.imdd.proxy.server[n].port=プロキシサーバー[n]のポート番号
jp1.imdd.proxy.server[n].user=プロキシサーバー[n]の認証ユーザーID
jp1.imdd.proxy.target[n].host= プロキシサーバーを利用するREST APIのターゲットホスト[n]
jp1.imdd.proxy.target[n].serverHost=接続先のプロキシサーバーのターゲットホスト名[n]
jp1.imdd.gui.settings.contentViews.<custom UI Id>.title=［カスタムUI］タブに表示するタイトル
jp1.imdd.gui.settings.contentViews.<custom UI Id>.url=［ユーザー定義の画面表示領域］に表示するhtmlファイルのパス
jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid=ユーザー定義の画面を表示するIM管理ノードのツリーSID
jp1.imdd.gui.settings.contentViews.<custom UI Id>.target=ユーザー定義の画面を表示するIM管理ノードのSID
jp1.im.db.DEFAULT.portNo=IMデータベースが使用するポート番号
jp1.im.db.DEFAULT.logicalHostNum=論理ホスト用のIMデータベースで論理ホストを識別する番号
jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=影響不明アイコンの表示/非表示
jp1.imdd.event.stormCompatible=繰り返しイベントの表示抑止機能の互換設定
jp1.imdd.gui.settings.eventSearchCount=イベント取得での検索回数
jp1.imdd.authBasic=Basic認証の有効/無効

ファイル

imdd.properties

imdd.properties.model（インテリジェント統合管理基盤定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imdd/

説明

インテリジェント統合管理基盤のシステムの設定を定義するファイルです。

定義の反映時期

JP1/IM - Managerを起動すると，定義情報の設定が有効になります。

記述内容

インテリジェント統合管理基盤定義ファイルには，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

プロパティ名は英小文字，英大文字を区別します。

定義ファイルはUTF-8で，BOM（byte order mark）が付与されないように保存してください。

無効なプロパティの場合は，その行を無視して処理を続行します。

プロパティに指定できる値以外を指定した場合は，動作を保証できません。

server.port=ポート番号

インテリジェント統合管理基盤サービスでHTTP通信を受け付ける任意のポート番号を指定します。

指定するポート番号はシステムで一意である必要があります。また，セットアップで作成するホスト単位でも一意の値とします。

指定できる値は，5001〜65535です。デフォルトは20703です。

jp1.imdd.proxy.server[n].host=プロキシサーバー[n]のホスト名

プロキシサーバー[n]のホスト名を指定します。

名前解決ができるプロキシサーバーのホスト名を指定します。不正なホスト名を指定した場合，製品プラグインからのAPIの実行に失敗します。

ASCII文字で指定します。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

jp1.imdd.proxy.server[n].port=プロキシサーバー[n]のポート番号

プロキシサーバー[n]のポート番号を指定します。

指定できる値は，1〜65535です。指定できる範囲以外の値を指定した場合は，KAJY52016-Wメッセージを出力して，プロキシサーバー[n]の設定を無効にします。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

jp1.imdd.proxy.server[n].user=プロキシサーバー[n]の認証ユーザーID

プロキシサーバー[n]の認証ユーザーのユーザーIDを指定します。

プロキシサーバーの認証を使用する場合，このオプションの指定と，プロキシサーバーの認証情報の設定が必要です。プロキシサーバーの認証情報の設定は「jddsetproxyuser」（1.　コマンド）を参照してください。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

プロキシサーバーの認証を使用しない場合は，このオプションの指定は不要です。

jp1.imdd.proxy.target[n].host=プロキシサーバーを利用するREST APIのターゲットホスト[n]

プロキシサーバーを利用するREST APIの実行対象となるターゲット[n]のホストを指定します。ターゲット[n]のホスト名には，REST APIのURLのホスト部を指定します。

例えば，REST APIが「」の場合は，「hitacih.co.jp」を指定します。

ASCII文字で指定します。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

jp1.imdd.proxy.target[n].serverHost=接続先のプロキシサーバーのターゲットホスト名[n]

接続先のプロキシサーバー[n]のターゲットホスト名を指定します。

設定した値がプロキシサーバー[n]に設定されていない場合，または無効な値の場合は，KAJY52018-Wメッセージを出力し，ターゲットホスト[n]の設定を無効にします。

ASCII文字で指定します。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

jp1.imdd.gui.settings.contentViews.<custom UI Id>.title=［カスタムUI］タブに表示するタイトル

カスタムUI表示機能を使用する場合に，［カスタムUI］タブに表示するタイトルを指定します。

タイトルは，制御文字および機種依存文字を含まない255文字以内の文字列で指定します。

なお，マルチバイト文字を指定する場合はUnicode（¥udddd表記）に変換してください。その場合の文字数は，Unicodeに変換済みの文字列の文字数でカウントされます。

一つの<custom UI Id>に対して，必ず指定してください。

jp1.imdd.gui.settings.contentViews.<custom UI Id>.url=［ユーザー定義の画面表示領域］に表示するhtmlファイルのパス

カスタムUI表示機能を使用する場合に，［ユーザー定義の画面表示領域］に表示するhtmlファイルのパスを，「public」からの相対パス形式で指定します。htmlファイルの配置先を次に示します。

Windowsの場合

Managerパス¥public¥customUI¥

UNIXの場合

/opt/jp1imm/public/customUI/

htmlファイルのパスは，制御文字および機種依存文字を含まない255文字以内の文字列で指定します。パス区切り文字は「/」を使用します。

なお，マルチバイト文字を指定する場合はUnicode（¥udddd表記）に変換してください。その場合の文字数は，Unicodeに変換済みの文字列の文字数でカウントされます。半角スペース「 」を含む場合でも，前後を引用符「"」で囲む必要はありません。

一つの<custom UI Id>に対して，必ず指定してください。

jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid=ユーザー定義の画面を表示するIM管理ノードのツリーSID

カスタムUI表示機能を使用する場合に，ユーザー定義の画面を表示するIM管理ノードのツリーSIDを指定します。

IM管理ノードのツリーSIDは，1,048,576文字以内で指定します。指定できる文字は，指定したツリーSIDの仕様に準じます。

IM管理ノードのツリーSIDは，正規表現で指定できます。正規表現で指定する場合，すべての文字に一致する表現の「.*」を多用すると，検索に時間が掛かることがあります。「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。

なお，指定したツリーSIDが存在するかどうかはチェックされません。

一つの<custom UI Id>に対して，sidまたはtargetのどちらかの指定が必要です。

jp1.imdd.gui.settings.contentViews.<custom UI Id>.target=ユーザー定義の画面を表示するIM管理ノードのSID

カスタムUI表示機能を使用する場合に，ユーザー定義の画面を表示するIM管理ノードのSIDを指定します。

IM管理ノードのSIDは，1,048,576文字以内で指定します。指定できる文字は，指定したSIDの仕様に準じます。

IM管理ノードのSIDは，正規表現で指定できます。正規表現で指定する場合，すべての文字に一致する表現の「.*」を多用すると，検索に時間が掛かることがあります。「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。

なお，指定したSIDが存在するかどうかはチェックされません。

一つの<custom UI Id>に対して，sidまたはtargetのどちらかの指定が必要です。

jp1.im.db.DEFAULT.portNo=IMデータベースが使用するポート番号

IMデータベースが使用するポート番号を指定します。

物理ホストの場合，統合監視DBのセットアップ時に使用したセットアップ情報ファイルのIMDBPORTオプションに指定した値を指定します。IMDBPORTオプションがデフォルトの設定の場合，jp1.im.db.DEFAULT.portNoの指定は不要です。

セットアップ情報ファイルについては「セットアップ情報ファイル（jimdbsetupinfo.conf）」を参照してください。

論理ホストの場合，統合監視DBのセットアップ時に使用したクラスタセットアップ情報ファイルのIMDBPORTオプションに指定した値を指定します。

クラスタセットアップ情報ファイルについては「クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）」を参照してください。

jp1.im.db.DEFAULT.logicalHostNum=論理ホスト用のIMデータベースで論理ホストを識別する番号

論理ホスト用のIMデータベースで論理ホストを識別する番号を指定します。

統合監視DBのセットアップ時に使用したクラスタセットアップ情報ファイルのLOGICALHOSTNUMBERオプションに指定した値を指定します。

jp1.im.db.DEFAULT.portNoで論理ホストを指定した場合，このオプションを指定します。

クラスタセットアップ情報ファイルについては「クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）」を参照してください。

jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=影響不明アイコンの表示/非表示

［業務フロー］タブおよび［連携ユニット］ダイアログで，後続ルートジョブネットへの影響の有無が不明であることを表すアイコン（[図データ]アイコン）を表示するかどうかを指定します。

「true」または「false」のどちらかを指定します。アイコンを表示する場合は「true」，表示しない場合は「false」です。デフォルト値は「true」です。

jp1.imdd.event.stormCompatible=繰り返しイベントの表示抑止機能の互換設定

バージョン12-00では，jcoimdefコマンドの-stormオプションの設定がONでも，繰り返しイベントの表示が抑止されません。このため，バージョン12-00からバージョンアップした場合，繰り返しイベントの表示抑止機能を使用するには，繰り返しイベントの表示抑止機能の互換設定を無効（false）にする必要があります。

なお，バージョン12-10を新規インストールした場合，繰り返しイベントの表示抑止機能の互換設定はあらかじめ無効（false）に設定されています。

「true」または「false」のどちらかを指定します。

「true」を設定すると12-00と同様に繰り返しイベントの表示を抑止しません。「false」を設定すると，繰り返しイベントの表示を抑止します。

デフォルト値は「true」です。

jcoimdefコマンドの-stormオプションの繰り返しイベントの監視抑止の設定がONで，かつjp1.imdd.event.stormCompatibleオプションの設定がfalseの場合に，繰り返しイベントの表示抑止機能が有効になります。

jcoimdefコマンドの-stormオプションの繰り返しイベントの監視抑止の設定がOFFの場合は，jp1.imdd.event.stormCompatibleオプションの設定に関わらず，繰り返しイベントの表示抑止機能は無効となります。

jp1.imdd.gui.settings.eventSearchCount=イベント取得での検索回数

統合オペレーション・ビューアーがイベント一覧を表示するために行うイベント取得での検索回数を設定します。

イベント取得では，選択したIM管理ノードにマッピングされているイベントを対象に検索します。表示するページに応じて検索開始位置，検索方向を決定し，検索対象のイベント100件を決定します。ユーザーフィルターなどによりイベントが100件取得できなかった場合は，次のイベント100件を対象として繰り返し検索します。

この繰り返し行うイベント検索回数の上限値を設定します。検索回数が設定した値に達した場合は検索を中断し，イベント一覧には中断までに取得したイベントを表示します。

指定できる値は，0〜120000（単位：回）です。0を指定した場合は，無制限となります。デフォルトは10回です。指定できる範囲以外の値を指定した場合は，デフォルトの値を仮定して動作します。

jp1.imdd.authBasic=Basic認証の有効/無効

インテリジェント統合管理基盤の任意のREST APIでは，REST APIに付加したログイン情報による認証方式（Basic認証）を使用できます。このBasic認証を有効にするかどうかを設定します。

「true」または「false」のどちらかを指定します。

「true」を設定すると，Basic認証を有効にします。

デフォルト値は「false」です。

REST APIについては，別途提供するドキュメントを参照してください。

注意事項

インテリジェント統合管理基盤サービスを起動した際にこの定義ファイルが存在しない場合，または読み込みに失敗した場合は，統合トレースログにKAJY00015-W，KAJY00016-Wのメッセージを出力し，デフォルトの値をプロパティに仮定して起動します。

定義例

server.port=20703

jp1.imdd.proxy.server[0].host=ProxyServer
jp1.imdd.proxy.server[0].port=443
jp1.imdd.proxy.server[0].user=UserID
jp1.imdd.proxy.target[0].host=HostA
jp1.imdd.proxy.target[0].serverHost=ProxyServer

jp1.imdd.gui.settings.contentViews.sample.title=¥u30ab¥u30b9¥u30bf¥u30e0UI1
jp1.imdd.gui.settings.contentViews.sample.url=./customUI/sample/index.html
jp1.imdd.gui.settings.contentViews.sample.target=^(?=.*MYHOST).*$

jp1.imdd.gui.settings.contentViews.sample2.title=¥u30ab¥u30b9¥u30bf¥u30e0UI2
jp1.imdd.gui.settings.contentViews.sample2.url=./customUI/sample2/index.html
jp1.imdd.gui.settings.contentViews.sample2.sid=_ROOT_AllSystems

jp1.im.db.DEFAULT.portNo=20700
jp1.im.db.DEFAULT.logicalHostNum=[1-9]

jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=true
jp1.imdd.event.stormCompatible=false

jp1.imdd.gui.settings.eventSearchCount=10

jp1.imdd.authBasic=false

システムノード定義ファイル（imdd_systemnode.conf）

形式

{
  "meta":{
    "version":"2"
  },
  "allSystem":[
    {
      "id":"一つ目のシステム名(ID)",
      "displayName":"システム名（表示名）",
      "jp1ResourcesGroup":"JP1資源グループ",
      "hostName":[{"ホスト指定文字":"指定種別"},
                   ･･･
                 ],
      "objectRoot":[
             {"type":"オブジェクトルートノード種別",
              "name":[
                 {"オブジェクトルートノード指定文字":"指定種別"},
                    ･･･
                     ]
                    },
                    ･･･
             ],
      "children":[
        {
          "id":"一つ目のサブシステム名（ID）",
          "displayName":"サブシステム名（表示名）",
          "jp1ResourcesGroup":"JP1資源グループ",
          "hostName":[
                       {"ホスト指定文字":"指定種別"},
                        ･･･
                     ],
          "objectRoot":[
             {"type":"オブジェクトルートノード種別",
              "name":[
                 {"オブジェクトルートノード指定文字":"指定種別"},
                    ･･･
                     ]
                    },
                    ･･･
                     ],
          "children":[
            {
              "id":"一つ目のサブシステム配下のサブシステム名（ID）",
              "displayName":"サブシステム名（表示名）",
              "jp1ResourcesGroup":"JP1資源グループ",
              "hostName":[{"ホスト指定文字":"指定種別"},･･･],
              "objectRoot":[
                 {"type":"オブジェクトルートノード種別",
                  "name":[
                     {"オブジェクトルートノード指定文字":"指定種別"},
                        ･･･
                          ]
                         },
                         ･･･
                 ]
              "children":[
                {
                  ･･･
                },
                ･･･
              ]
            },
            ･･･
          ]
        },
        {
          "id":"二つ目のサブシステム名（ID）",
          "displayName":"サブシステム名（表示名）",
          "jp1ResourcesGroup":"JP1資源グループ",
          "hostName":[{"ホスト指定文字":"指定種別"},･･･],
          "objectRoot":[
             {"type":"オブジェクトルートノード種別",
              "name":[
                 {"オブジェクトルートノード指定文字":"指定種別"},
                    ･･･
                      ]
                     },
                     ･･･
             ]
          "children":[
            {
              ･･･
            },
            ･･･
          ]
        },
        ･･･
      ]
    },
    {
      "id":"二つ目のシステム名(ID)",
      ･･･
    },
    ･･･
  ]
}

ファイル

imdd_systemnode.conf

imdd_systemnode.conf.model（システムノード定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imdd/

説明

サンバースト形式やツリー形式で表示するシステムの階層構造を定義し，収集したデータを定義したホスト，およびホスト以外のオブジェクトルートでグルーピングする設定ファイルです。

インテリジェント統合管理基盤が収集した構成情報内のホスト，およびホスト以外のオブジェクトルートに対して，どのシステムに配置するかを定義します。

表示対象は，JP1/IM - Managerのエージェント構成またはリモート監視構成に含まれているホスト，およびホスト以外のオブジェクトルート，および他製品から収集した構成情報に含まれるホスト，およびホスト以外のオブジェクトルートです。JP1/IM - Manager（インテリジェント統合管理基盤）の連携先ホストにAJSマネージャーやPFMマネージャーが含まれる場合，配下のAJSエージェントやPFMの監視エージェントもツリーの表示対象です。

jddcreatetreeコマンド実行時にこれらのホスト，およびホスト以外のオブジェクトルートの一覧を取得し，システムノード定義ファイル（imdd_systemnode.conf）の定義内容に従って，システムの配下にホスト，およびホスト以外のオブジェクトルートを振り分けて階層構造を作成します。このため，システムノード定義ファイル（imdd_systemnode.conf）に定義されたホスト，およびホスト以外のオブジェクトルートでも，JP1/IM，JP1/AJS，およびJP1/PFMの構成上に存在しない場合は，ツリー上には表示されません。

なお，一つのノードが複数のシステムまたはサブシステムで使用される場合は，どれか一つのシステムに定義を絞る必要があります。複数のシステムで一つのノードを管理することはできません。

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドが正常終了すると，システムノード定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

jddcreatetreeコマンドおよびjddupdatetreeコマンドについては，「jddcreatetree」（1.　コマンド），「jddupdatetree」（1.　コマンド）を参照してください。

記述内容

システムノード定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。「¥」を文字として指定したい場合は，エスケープ文字「¥」を「¥」の前に指定します。

version

システムノード定義ファイルのバージョンです。「2」を指定します。このオプションは省略できません。

id

SID（連携する各製品の構成要素を一意に表わすID）に設定するシステムのIDを，半角英数字で指定します。

idは255文字以内で指定します。システムとシステム構成要素を合わせて1,000個まで指定できます。このオプションは省略できません。

システムの場合

allSystemの直下に定義するシステム内の一意の値

サブシステムの場合

childrenの直下に定義するサブシステム内の一意の値

システムの統合によりシステムノード定義ファイルを統合する場合，設定値が一意となっているかを確認し，必要に応じてidを変更してください。

displayName

サンバースト形式，ツリー形式に表示されるシステムの名称を指定します。

名称は，制御文字および機種依存文字を含まない255文字以内の文字列で指定します。なお，displayNameは，システムノード定義ファイル内で一意とする必要はありません。同じ名称を指定できます。

jp1ResourcesGroup

システムが監視する範囲のJP1資源グループです。JP1資源グループによるアクセス制御をしない場合，この項目は不要です。

jp1ResourcesGroupは半角英数字および記号「!」，「@」，「#」，「$」，「%」，「&」，「_」，「-」，「*」，「'」，「^」，「{」，「}」，「(」，「)」，「.」，「¥」，「`」，「~」で64文字以内で指定します。

hostName

IM構成上のホスト，連携製品の登録エージェントなどシステムに属するホストを，次に示すホスト指定文字と指定種別で指定します。

ホスト指定文字

指定種別（6文字以内）

ホスト名そのもので指定する場合

""（空文字）

正規表現※でホストを指定する場合

regexp

注※　正規表現には拡張正規表現を使用します。正規表現の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

ホスト名に指定できる文字は，半角英数字および記号「!」，「$」，「(」，「)」，「*」，「+」，「,」，「-」，「.」，「/」，「:」，「<」，「=」，「[」，「¥」，「]」，「^」，「{」，「|」，「}」です。255文字以内で指定します。

（指定例）

"hostName":[{"host1":""},{".+[1-5]+":"regexp"}]

hostNameで設定したホストでデータをグループ化する際は，上から設定された順番で処理されます。また，ホストのグループ化では，大文字小文字の区別はありません。childrenでサブシステムを定義していない場合，かつtypeおよびnameが指定されていない場合，このオプションは省略できません。

なお，ホスト名が重複している場合，二つ目以降のホスト名は無視されます。

objectRoot

システム，またはサブシステムに属するオブジェクトルートノードのオブジェクトルートノード種別とオブジェクトルートノード指定文字，指定種別を指定します。

type

nameに指定したオブジェクトルートノード名の種別を指定します。

指定したオブジェクトルートノード種別は大文字小文字の区別はありません。typeに指定できる値については，各製品のマニュアルを参照してください。なお，JP1/AJSまたはJP1/PFMと連携する場合に指定できる値は，HOSTだけです。

childrenでサブシステムを定義していない場合，かつhostNameが指定されていない場合，このオプションの指定は省略できません。

typeに指定できる文字は，半角英数字および記号「-」，「.」，「:」，「~」です。

name

システム，またはサブシステムに属するオブジェクトルートノードを，次に示すオブジェクトルートノード指定文字と指定種別で指定します。

オブジェクトルートノード指定文字

指定種別

オブジェクトルートノード名そのもので指定する場合

""（空文字）

正規表現※で指定する場合

regexp

注※　正規表現には拡張正規表現を使用します。正規表現の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

（指定例1）

"name":{"switch1":""}

（指定例2）

"name":{".+[1-5]+":"regexp"}

nameで設定したオブジェクトルートノードでデータをグループ化する際は，上から設定された順番で処理されます。また，オブジェクトルートノードのグループ化では，大文字小文字の区別はありません。nameに設定したオブジェクトルートノード名とtypeに設定したオブジェクトルートノード種別が重複している場合，二つ目以降のオブジェクトルートノード名は無視されます。

childrenでサブシステムを定義していない場合，かつhostNameが指定されていない場合，このオプションの指定は省略できません。

children

システムの直下のサブシステムの情報を，id〜childrenの内容で定義し，階層化の情報として設定します。階層はシステムと合わせて10階層まで定義できます。配下にサブシステムを持たないシステムの場合，この項目は不要です。

なお，統合オペレーション・ビューアーのサンバーストまたはツリーに表示できる階層については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」のサンバーストまたはツリーの階層を説明している章を参照してください。

定義例1

例題に示す構成の場合の定義例

次のシステム，サブシステム，および各システム，サブシステムに属するホストの構成を設定します。

（例題）

{
  "meta":{
    "version":"2"
  },
  "allSystem":[
    {
      "id":"systemA",
      "displayName":"システムA",
      "jp1ResourcesGroup":"SYSTEM_A",
      "hostName":[{"HOST-A0":""}],
      "children":[
        {
          "id":"subA1",
          "displayName":"システムA-1",
          "jp1ResourcesGroup":"SYSTEM_A",
          "hostName":[{"HOST-A10":""},{"HOST-A11":""}]
        },
        {
          "id":"subA2",
          "displayName":"システムA-2",
          "jp1ResourcesGroup":"SYSTEM_A",
          "children":[
            {
              "id":"subA21",
              "displayName":"システムA-2-1",
              "jp1ResourcesGroup":"SYSTEM_A",
              "hostName":[{"^HOST-A21.*":"regexp"},{"HOST-A10-1":""}]
            },
            {
              "id":"subA22",
              "displayName":"システムA-2-2",
              "jp1ResourcesGroup":"SYSTEM_A",
              "hostName":[{"HOST-A22":""}]
            }
          ]
        }
      ]
    },
    {
      "id":"systemB",
      "displayName":"システムB",
      "jp1ResourcesGroup":"SYSTEM_B",
      "hostName":[{"HOST-B10":""},{"HOST-B11":""}]
    }
  ]
}

定義例2

一つのホストやルートオブジェクトノードが複数のシステムまたはサブシステムで使用される場合の定義例

複数のシステムで一つのホストを管理できないため，システムAまたはシステムBのどちらかに定義を絞ります。

例題

{
  "meta":{
    "version":"1"
  },
  "allSystem":[
    {
      "id":"systemA",
      "displayName":"システムA",
      "hostName":[{"HOST1":""},{"HOST-A":""}]
    },
    {
      "id":"systemB",
      "displayName":"システムB",
      "hostName":[{"HOST1":""},{"HOST-B":""}]
    }
  ]
}

システムAに絞る場合の定義例

{
  "meta":{
    "version":"1"
  },
  "allSystem":[
    {
      "id":"systemA",
      "displayName":"システムA",
      "hostName":[{"HOST1":""},{"HOST-A":""}]
    },
    {
      "id":"systemB",
      "displayName":"システムB",
      "hostName":[{"HOST-B":""}]
    }
  ]
}

システムBに絞る場合の定義例

{
  "meta":{
    "version":"1"
  },
  "allSystem":[
    {
      "id":"systemA",
      "displayName":"システムA",
      "hostName":[{"HOST-A":""}]
    },
    {
      "id":"systemB",
      "displayName":"システムB",
      "hostName":[{"HOST1":""},{"HOST-B":""}]
    }
  ]
}

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）

形式

{
  "meta":{
    "version":"1"
  },
  "categoryData":[
    {"categoryId":"カテゴリId","categoryName":"カテゴリ名称"},
    ･･･
  ]
}

ファイル

imdd_category_name.conf

imdd_category_name.conf.model（IM管理ノードカテゴリ名称定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imdd/

説明

インテリジェント統合管理基盤が収集したデータをサンバースト形式，ツリー形式で表示する際の管理グループのIM管理ノードカテゴリの名称，および順番を定義するファイルです。順番は，IM管理ノードカテゴリが定義された順となります。

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドが正常終了すると，IM管理ノードカテゴリ名称定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

jddcreatetreeコマンドおよびjddupdatetreeコマンドについては，「jddcreatetree」（1.　コマンド），「jddupdatetree」（1.　コマンド）を参照してください。

記述内容

IM管理ノードカテゴリ名称定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。

version

IM管理ノードカテゴリ名称定義ファイルのバージョンです。「1」を指定します。

categoryId

デフォルトで設定された値です。編集しないでください。

categoryName

サンバースト形式，ツリー形式に表示される管理グループのカテゴリ名称を指定します。categoryNameは制御文字および機種依存文字を含まない255文字以内の文字列で指定します。

定義例

下線部分のカテゴリの順番を入れ替える定義例を次に示します。

変更前

{
  "meta":{
    "version":"1"
  },
  "categoryData":[
    {"categoryId":"job","categoryName":"Job"},
    {"categoryId":"serviceResponse","categoryName":"Service Response"},
    {"categoryId":"enterprise","categoryName":"Enterprise"},
    {"categoryId":"transactionProcessing","categoryName":"Transaction Processing"},
    {"categoryId":"applicationServer","categoryName":"Application Server"},
    {"categoryId":"database","categoryName":"Database"},
    {"categoryId":"platform","categoryName":"Platform"},
    {"categoryId":"virtualMachine","categoryName":"Virtual Machine"},
    {"categoryId":"managementApplications","categoryName":"Management Applications"},
    {"categoryId":"otherApplications","categoryName":"Other Applications"}
  ]
}

変更後

{
  "meta":{
    "version":"1"
  },
  "categoryData":[
    {"categoryId":"job","categoryName":"Job"},
    {"categoryId":"serviceResponse","categoryName":"Service Response"},
    {"categoryId":"enterprise","categoryName":"Enterprise"},
    {"categoryId":"platform","categoryName":"Platform"},
    {"categoryId":"database","categoryName":"Database"},
    {"categoryId":"virtualMachine","categoryName":"Virtual Machine"},
    {"categoryId":"managementApplications","categoryName":"Management Applications"},
    {"categoryId":"transactionProcessing","categoryName":"Transaction Processing"},
    {"categoryId":"applicationServer","categoryName":"Application Server"},
    {"categoryId":"otherApplications","categoryName":"Other Applications"}
  ]
}

構成取得対象ホスト定義ファイル（imdd_target_host.conf）

形式

{
  "meta":{
    "version":"1"
  },
  "target":[
    {
      "product":"製品",
      "hostName":["ホスト名1","ホスト名2",･･･]
    },
    ･･･
  ]
}

ファイル

imdd_target_host.conf

imdd_target_host.conf.model（構成取得対象ホスト定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imdd/

説明

インテリジェント統合管理基盤が，連携製品の監視オブジェクトの情報を取得する際に，このファイルの定義内容に基づいて連携製品ごとに取得先のホストを設定します。

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドが正常終了すると，構成取得対象ホスト定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

jddcreatetreeコマンドおよびjddupdatetreeコマンドについては，「jddcreatetree」（1.　コマンド），「jddupdatetree」（1.　コマンド）を参照してください。

記述内容

構成取得対象ホスト定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。「¥」を文字として指定したい場合は，エスケープ文字「¥」を「¥」の前に指定します。

version

構成取得対象ホスト定義ファイルのバージョンです。「1」を指定します。

product

連携する製品を半角英数字で指定します。255文字以内で指定します。構成取得対象を指定する場合，このオプションは省略できません。

AJS3

JP1/AJSと連携する場合に指定します。

PFM

JP1/PFMと連携する場合に指定します。

hostName

構成取得対象のホスト名を255文字以内の文字列で指定します。

使用できる文字は半角英数字と記号「!」，「$」，「(」，「) 」，「*」，「+」，「,」，「-」，「. 」，「/」，「: 」，「<」，「=」，「[」，「¥」，「]」，「^」，「{」，「|」，「}」です。

IM構成に登録済みのホストを，物理ホストまたは論理ホストの名称で指定します。連携する製品内で同名のホストの指定はできません。構成取得対象を指定する場合，このオプションは省略できません。

定義例

JP1/AJS，JP1/PFMと連携する場合

{
  "meta":{
    "version":"1"
  },
  "target":[
    {
      "product":"AJS3",
      "hostName":["host-01","host-02","host-03"]
    },
    {
      "product":"PFM",
      "hostName":["host-01","host-04"]
    }
  ]
}

ホスト名定義ファイル（imdd_host_name.conf）

形式

{
  "meta":{
    "version":"1"
  },
  "hostNameDef":[
    {
      "sourceHostName":["構成情報のホスト名1","構成情報のホスト名2"],
      "hostName":"ツリーデータ上のホスト名",
      "label":"画面上の表示名"
    },
    ･･･
  ]
}

ファイル

imdd_host_name.conf

imdd_host_name.conf.model（ホスト名定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imdd/

説明

ホスト名にエイリアス名を付けることができる製品をIM管理ノードの構成に加える場合，エイリアス名と実ホスト名のマッピングを定義するファイルです。エイリアス名と実ホスト名をマッピングすると，ツリー上のホスト名が実ホスト名となるため，管理ツールごとにエイリアス名が異なる場合でも，ツリー上では同じホストにグルーピングできます。

統合オペレーション・ビューアーに表示するホスト名を変更する場合も，この定義ファイルを使用します。

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドが正常終了すると，ホスト名定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

jddcreatetreeコマンドおよびjddupdatetreeコマンドについては，「jddcreatetree」（1.　コマンド），「jddupdatetree」（1.　コマンド）を参照してください。

記述内容

ホスト名定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。「¥」を文字として指定したい場合は，エスケープ文字「¥」を「¥」の前に指定します。

hostNameDef

sourceHostNameまたはlabelのどちらかの指定が必要です。hostNameの指定は必須です。

sourceHostName

同一ホストとして扱うホスト名を指定します。最大10個指定できます。一つのホスト名は，255文字以内で指定します。

使用できる文字は半角英数字と記号「!」，「$」，「(」，「)」，「*」，「+」，「,」，「-」，「.」，「/」，「:」，「<」，「=」，「[」，「¥」，「]」，「^」，「{」，「|」，「}」です。

hostName

ツリーデータ上のホスト名を指定します。ホスト名は，255文字以内で指定します。

使用できる文字は半角英数字と記号「!」，「$」，「(」，「)」，「*」，「+」，「,」，「-」，「.」，「/」，「:」，「<」，「=」，「[」，「¥」，「]」，「^」，「{」，「|」，「}」です。

label

画面上に表示するラベル名を指定します。制御文字および機種依存文字を含まない255文字以内の文字列で指定します。

画面に表示されるホスト名

画面上に表示されるホスト名は，次に示す優先度に従い表示文字列を決定します。

優先度

hostNameの値との一致／不一致

labelの設定有無

ホストのSIDのvalue値のlabelの設定有無

画面に表示されるホスト名

高い

一致

あり

−

labelの値

↑

一致

なし

−

hostNameの値

↓

不一致

−

あり

ホストのSIDのvalue値に設定されているlabelの値

低い

不一致

−

なし

SIDに設定されているホスト名（_HOST_XXXXXのXXXXX）

（凡例）−：関係しない項目です。

定義例

定義例1：「hostX」を画面上で「ホストX」と表示する場合

{
  "meta":{
    "version":"1"
  },
  "hostNameDef":[
    {
      "hostName":"hostX",
      "label":"ホストX"
    }
  ]
}

定義例2：エイリアス名として「hostA,hostB」と定義されているホストを「hostX」と扱う際に「hostX」を画面上で「ホストX」と表示する場合

{
  "meta":{
    "version":"1"
  },
  "hostNameDef":[
    {
      "sourceHostName":["hostA","hostB"],
      "hostName":"hostX",
      "label":"ホストX"
    }
  ]
}

IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）

形式

{
  "meta":{
    "version":"1"
  },
  "links":[
    {
      "from":"先行ノードのSIDまたはツリーSID",
      "to":"後続ノードのSIDまたはツリーSID",
      "type":"処理対象種別",
      "value":{
          "unit":[
            {
              "precedingJob":"先行する連携ユニットの完全名",
              "succeedingJob":"後続の連携ユニットの完全名",
              "succeedingJobTimeType":"連携予定日時の取得形式"
            }, ...
          ]
      }
    }, ...
  ]
}

ファイル

imdd_nodeLink_def.conf

imdd_nodeLink_def.conf.model（IM管理ノードリンク定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imdd/

説明

IM管理ノード間の関連を定義するファイルです。この定義ファイルは，ユーザーがIM管理ノードの関連を新たに定義したい場合に使用します。IM管理ノードリンクファイル（imdd_nodeLink.json）と同じ関連（from，to，typeが一致する関連）を定義した場合は，このファイルに定義した関連がシステムに反映されます。

JP1/AJSやJP1/PFMと連携した場合，監視対象間の関連は関連ノード表示機能によって自動的に登録されます。それ以外に個別に関連を追加し，統合オペレーション・ビューアーに表示したい場合に，この定義ファイルに関連を指定できます。関連ノード表示機能については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「3.6　関連ノード表示機能」を参照してください。

関連ノード表示機能に対応している関連以外を定義した場合，統合オペレーション・ビューアーには表示できませんが，REST APIを使用すると，設定した内容をデータとして取得することができます。REST APIについては，別途提供するドキュメントを参照してください。

定義の反映時期

jddupdatetreeコマンドが正常終了すると，IM管理ノードリンク定義ファイルの設定がインテリジェント統合管理基盤に反映されます。

記述内容

IM管理ノードリンク定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。

version

IM管理ノードリンク定義ファイルのバージョンです。「1」を指定します。

from

先行ノードです。SIDまたはツリーSIDを指定します。制御文字を含まない1メガバイト以内で指定します。使用できる文字は半角英数字と記号「_」，「/」，「%」，「-」，「. 」，「: 」，「~」です。このオプションは省略できません。

［業務フロー］タブでは，typeがrootJobnetExecutionOrderでかつSIDで指定した場合にだけ，IM管理ノード間の関連として表示されます。なお，ツリーSIDで指定した場合，画面には関連が表示されませんが，リンク情報取得APIによってツリーSIDで指定したリンク情報を取得できます。詳細については別途提供するドキュメントを参照してください。

［関連ノード］タブの場合は，type に関わらずSIDおよびツリーSIDのどちらで指定されたときでも，IM管理ノード間の関連として表示されます。

（指定例）ルートジョブネットを指定する場合

_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1

to

後続ノードです。SIDまたはツリーSIDを指定します。制御文字を含まない1メガバイト以内で指定します。使用できる文字は半角英数字と記号「_」，「/」，「%」，「-」，「. 」，「: 」，「~」です。このオプションは省略できません。

［業務フロー］タブでは，typeがrootJobnetExecutionOrderでかつSIDで指定した場合にだけ，IM管理ノード間の関連として表示されます。なお，ツリーSIDで指定した場合，画面には関連が表示されませんが，リンク情報取得APIによってツリーSIDで指定したリンク情報を取得できます。詳細については別途提供するドキュメントを参照してください。

［関連ノード］タブの場合は，type に関わらずSIDおよびツリーSIDのどちらで指定されたときでも，IM管理ノード間の関連として表示されます。

（指定例）ルートジョブネットを指定する場合

_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet2

type

fromとtoで設定したリンク情報が示す種別を指定します。制御文字は指定できません。このオプションは省略できません。

標準では次の種別をサポートしています。

rootJobnetExecutionOrder（ルートジョブネット実行順序の関連）

rootJobnetAgent（ルートジョブネットとAJSエージェントの関連）

managerAgent（JP1製品のマネージャーとエージェントの関連）

sameNode（名称が同じノードの関連）

typeにrootJobnetExecutionOrderを指定する場合は，fromおよびtoにはIM管理ノードのSIDを指定してください。

value

リンク情報の付与情報を指定します。このオプションは省略できます。

unit

処理対象種別がルートジョブネット実行順序の場合に指定します。連携ユニットの情報を指定します。このオプションは省略できます。

precedingJob

先行する連携ユニットの完全名を指定します。制御文字を除く1メガバイト以内の文字列で指定します。このオプションは省略できません。

（指定例）

/jobnet1/JP1イベント送信ジョブ

succeedingJob

後続の連携ユニットの完全名を指定します。制御文字を除く1メガバイト以内の文字列で指定します。このオプションは省略できません。

（指定例）

/jobnet2/JP1イベント受信監視ジョブ

succeedingJobTimeType

処理対象種別がルートジョブネット実行順序の場合に指定します。連携予定日時を指定します。このオプションは省略できます。省略した場合は，endtimeを仮定して動作します。

startTime

先行ユニットの終了によって，後続ユニットが実行開始される連携の場合に指定します。例えば，保留解除操作や待ち合わせ条件による連携の場合に指定します。

endTime

先行ユニットの終了によって，後続ユニットの待ち条件が満了する連携の場合に指定します。例えば，イベントジョブ（ファイル監視ジョブやメール受信監視ジョブなど）による連携の場合に指定します。

定義例

{
    "meta":{
        "version":"1"
    },
        "links": [
    {
     "from":_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv
/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1",
     "to":_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv
/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet2",
     "type":"rootJobnetExecutionOrder",
     "value":{
          "unit":[
           {
              "precedingJob":"/jobnet1/ジョブ1",
              "succeedingJob":"/jobnet2/ジョブ2",
              "succeedingJobTimeType":"startTime"
           }, …
         ]
      }

        }, ...
    ]
}

発生元ホストマッピング定義ファイル（user_hostmap.conf）

形式

[DESC_VERSION=バージョン情報]
#コメント
def 定義名1
    cnd
        イベント条件
    end-cnd
    source_attr 属性名
end-def
def 定義名2
    cnd
        イベント条件
    end-cnd
    source_attr 属性名
end-def

ファイル

user_hostmap.conf（発生元ホストマッピング定義ファイル）

user_hostmap.conf.model（発生元ホストマッピング定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥hostmap¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥hostmap¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/hostmap/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/hostmap/

説明

発生元ホストマッピングの機能で，発生元ホストをマッピングするJP1イベントの条件とマッピング元を定義するファイルです。発生元ホストマッピング定義ファイルの最大ファイルサイズは，17メガバイトです。

発生元ホストマッピングの機能は，このファイルの定義に従い，イベント条件に一致するJP1イベントの発生元ホストをマッピングします。

定義の反映時期

発生元ホストマッピングの機能が有効な場合で，次のどちらかが成立するときに有効になります。

JP1/IMを起動した場合

jco_spmd_reloadコマンドを実行した場合

記述内容

DESC_VERSION=バージョン情報

発生元ホストマッピング定義ファイルのファイルバージョンである1を指定します。DESC_VERSIONは，定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に指定します。先頭行にファイルバージョンがない場合は，ファイルバージョンを1と見なして処理します。

# コメント

発生元ホストマッピング定義ファイルの説明を記述します。

def 〜 end-def

マッピングの定義ブロックの開始と終了を示します。def〜end-defブロックは省略できます。

def以降には，発生元ホストマッピング定義の定義名を記述します。「def△△△定義1△△△定義2△△△」と指定した場合，「△△定義1△△△定義2△△△」が定義名となります（△は半角スペースを表す）。

定義名は，発生元ホストマッピング定義ファイル内で一意になるように指定します。文字列の長さは1から50バイトまでです。

使用できる文字は，制御文字を除くすべての文字です。

制御文字は，アスキーコードの0x00〜0x1Fと0x7F〜0x9Fです。

cnd 〜 end-cnd

マッピングするJP1イベントのイベント条件ブロックの開始と終了を示します。イベント条件ブロックは，マッピングの定義ブロック内に必ず一つだけ指定します。省略できません。受信したJP1イベントが，複数のイベント条件に一致する場合，発生元ホストマッピング定義ファイルの先頭に近い定義ブロックが優先されます。cnd，およびend-cndパラメーターの前後のタブまたはスペースは無視されます。

イベント条件

マッピングするJP1イベントの条件を指定します。イベント条件ブロックには，1件以上，最大256件のイベント条件を指定できます。イベント条件とイベント条件は，AND条件となります。イベント条件は，次の形式で指定します。

属性名 比較キーワード オペランド

属性名

属性名には，比較したい属性の名称を指定します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2‒6　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番

項目

属性名

比較キーワード

オペランド

1

イベントID

B.ID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

16進数形式で指定する。大文字・小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

3

発行元プロセスID

B.PROCESSID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

4

発行元ユーザーID

B.USERID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

5

発行元グループID

B.GROUPID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

6

発行元ユーザー名

B.USERNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

7

発行元グループ名

B.GROUPNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

8

発行元イベントサーバ名(登録ホスト名)※

B.SOURCESERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

9

送信先イベントサーバ名※

B.DESTSERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

10

メッセージ

B.MESSAGE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

11

重大度

E.SEVERITY

と一致する

複数指定できる。複数指定した場合，同じ重大度は指定できない。正規表現を指定した場合は，複数指定できない。"Emergency"，"Alert"，"Critical"，"Error"，"Warning"，"Notice"，"Information"，"Debug"のどれかを指定できる。

12

ユーザー名

E.USER_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

13

プロダクト名

E.PRODUCT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

14

オブジェクトタイプ

E.OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

15

オブジェクト名

E.OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

16

登録名タイプ

E.ROOT_OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

17

登録名

E.ROOT_OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

18

オブジェクトID

E.OBJECT_ID

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

19

事象種別

E.OCCURRENCE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

20

終了コード

E.RESULT_CODE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

21

拡張属性の固有情報

E.xxxxxxx

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

属性名には，先頭が英大文字で英大文字，数字，およびアンダーバー（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

注※

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入します。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブを指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

CR（0x0d）

%0d

5

LF（0x0a）

%0a

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

source_attr

マッピング元の属性値を指定します。source_attrには，発生元ホスト名が格納されている値を一つ指定できます。省略はできません。source_attrは，次の形式で指定します。

source_attr マッピング元属性値

マッピング元属性値には，属性名または変数名を指定できます。属性名を指定すると，属性値のすべてを格納します。変数名を指定すると，属性値の一部を切り出して格納します（部分切り出し）。

マッピング元属性値に指定できる属性は拡張属性（固有情報）です。拡張属性（固有情報）は，「表3-2　共通情報の一覧」にある共通情報以外の属性です。変数名には$EVENV1〜$EVENV9が指定できます。

定義例

イベントIDが100に一致，かつ重大度がWarningで，メッセージが「ホストAGENT_Aでエラーコード1111のエラーが発生しました」（AGENT_Aはホスト名）に一致する場合に，メッセージに含まれるホスト名（AGENT_A）を発生元ホスト名に設定する例を次に示します。

DESC_VERSION=1
#メッセージ中のホスト名を発生元ホスト名にマッピングする
def 発生元ホストマッピング1
    cnd
        B.ID IN 100
        E.SEVERITY IN Warning
        B.MESSAGE REGEX ホスト([a-zA-Z0-9¥-_]+)でエラーコード1111のエラーが発生しました
    end-cnd
    source_attr $EVENV1
end-def

自動アクション環境定義ファイル（action.conf.update）

形式

[論理ホスト名¥JP1CONSOLEMANAGER¥ACTION]
"ACTIONINFSIZE"=dword:16進数値
"EVENTALIVEPERIOD"=dword:16進数値
"ACTIONEXECUSER"="JP1ユーザー名"
"ACTIONDEFFILE"="ファイル名"
"HOSTINEVENT"="{remote | local}"
"ACTIONINFFILE"="ファイル名"
"ACTIONLIMIT"=dword:16進数値
"SENDABLE_EVENT"="イベントID"
"REGEXP"="{JP1|EXTENDED}"
"ACTIONPRIORITY"="{DEFAULT|V8COMPATIBLE}"

[論理ホスト名¥JP1CONSOLEMANAGER¥LOG_CONTROL¥JCAMAIN]
"LOGSIZE"=dword:16進数値

共通定義情報のパラメーター形式です。上記以外のパラメーターは，内部動作で使うパラメーターですので編集しないでください。

ファイル

action.conf.update（自動アクション環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

自動アクションの実行環境の情報を定義するファイルです。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

アクション情報ファイルの容量を小さくする場合

アクション情報ファイルのバックアップを採取し，アクション情報ファイルをいったん削除してから，設定を変更してください。

定義の反映時期

jbssetcnfコマンドを実行して定義をJP1共通定義情報に反映したあとに，JP1/IM - Managerを起動したときに有効になります。

次のパラメーターについては，jco_spmd_reloadコマンドによるリロードによっても，有効となります。

"EVENTALIVEPERIOD"

"ACTIONEXECUSER"

"HOSTINEVENT"

"SENDABLE_EVENT"

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER¥ACTION]

アクション実行環境設定のキー名称です。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"ACTIONINFSIZE"=dword:16進数値

アクション情報ファイル容量を16進数値（キロバイト単位）で指定します。

指定できる値は次のとおりです。

指定できる値は，「dword:00000001〜00001000」（1〜4,096キロバイト）です。デフォルト値は，「dword:00001000」（4,096キロバイト）です。

アクション情報ファイルは，自動アクションの実行情報を保存するファイルです。イベントコンソールおよびjcashowaコマンドでアクションを参照する場合や，アクション状態通知イベントを発行する場合は，アクション情報ファイルを参照します。

このファイルは，"ACTIONINFSIZE"で設定した値に達すると上書きされるラップアラウンド形式のファイルです。そのため，上書きされた古いアクション情報はイベントコンソールおよびjcashowaコマンドで参照できなくなったり，アクション状態通知イベントが発行されなくなったりすることがあります。過去のアクション実行結果を参照する場合や，アクション情報通知イベントを発行する場合は，参照したいアクション情報の容量を見積もって，"ACTIONINFSIZE"に設定しておく必要があります。

アクション情報ファイルの容量見積もりの詳細については，JP1/IM - Managerのリリースノートを参照してください。

アクション情報ファイル容量をデフォルト値に設定した場合は，65,535アクション分の情報を参照できます。

"EVENTALIVEPERIOD"=dword:16進数値

ANDイベント保管期限を，分単位で指定します。

1〜1,440（分）の16進数値で指定します。デフォルト値は「dword:0000003c」（60分）です。

"ACTIONEXECUSER"="JP1ユーザー名"

アクション実行標準ユーザーとしてJP1ユーザーを指定します。

15バイトまでの文字列で指定します。デフォルト値は""（なし）です。指定がない場合は，jp1adminが仮定されます。

自動アクションの定義で，実行ユーザーを指定しなかった場合は，ここで定義したJP1ユーザーでアクションを実行します。

"ACTIONDEFFILE"="ファイル名"

自動アクション定義ファイル名を指定します。

デフォルトで"actdef.conf"が指定されています。この値は変更せずに使用してください。

この自動アクション定義ファイルで，自動アクション機能によってアクションを実行する条件および実行するコマンドを定義します。

"HOSTINEVENT"="{remote | local}"

イベント発行元ホスト名取得方法を指定します。

"remote"または"local"のどちらかを指定します。デフォルト値は"remote"です。

"remote"を指定した場合は，イベント属性中の「発行元イベントサーバ名」をイベント発行元ホスト名として使用します。

"local"を指定した場合は，JP1/IM - Manager上でイベント属性中の「発行元IPアドレス」がIPv6アドレスのとき，getnameinfoを利用して求めたホスト名を，イベント発行元ホスト名として使用します。「発行元IPアドレス」がIPv4アドレスのとき，gethostbyaddrを利用して求めたホスト名を，イベント発行元ホスト名として使用します。ホスト名が求められなかった場合は，IPアドレスをイベント発行元ホスト名として使用します。

注意事項

"local"を指定した場合，DNSの問合せなどでアクションのマッチング処理に時間がかかることがあります。

"ACTIONINFFILE"="ファイル名"

アクション情報ファイル名を指定します。

デフォルトで"actinf.log"が指定されています。この値は変更せずに使用してください。

"ACTIONLIMIT"=dword:16進数値

コマンド先行入力数を指定します。

自動アクションの実行先ホストでJP1/Base 06-51以前を使用する場合に，実行先ホストのコマンド先行入力数を指定します。指定できる値は，「dword:00000001〜00000040」（1〜64件）です。デフォルト値は「dword:0000000a」（10件）です。

なお，自動アクションの実行先ホストでJP1/Base 06-71以降を使用する場合は，コマンド先行入力数は，実行先ホストのJP1/Baseで設定します。この場合，コマンド先行入力数は，実行先ホストでjcocmddefコマンドを使用して設定してください。デフォルト値は1,024件です。

詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「13.7.6　コマンド実行環境の検討」を参照してください。

"SENDABLE_EVENT"="イベントID"

自動アクション発行イベント（イベントIDが20A0，20A1，20A2，20A3，および20A4のJP1イベント）を指定します。

指定できるのは20A0，20A1，20A2，20A3，20A4で，複数指定する場合は半角スペースで区切ります。

デフォルト値は"20A0 20A3 20A4"です。

JP1イベントの詳細については，「3.2.2　JP1イベントの詳細」を参照してください。

"REGEXP"="{JP1|EXTENDED}"

使用する正規表現の種類を指定します。

"JP1"または"EXTENDED"のどちらかを指定します。デフォルト値は"EXTENDED"です。

"JP1"を指定すると，JP1独自正規表現，"EXTENDED"を指定すると拡張正規表現が自動アクションの定義で使用できます。

なお，このパラメーターはWindows限定のパラメーターで，UNIXの場合指定する必要はありません。

"ACTIONPRIORITY"="{DEFAULT|V8COMPATIBLE}"

アクションの優先順位を指定します。

"DEFAULT"または"V8COMPATIBLE"のどちらかを指定します。大文字・小文字を区別します。

パラメーターが存在しない場合は"V8COMPATIBLE"で動作します。

JP1/IM - Managerを新規インストールした場合，"DEFAULT"が設定されます。

JP1/IM - Managerをバージョン8以前からバージョンアップした場合，ACTIONPRIORITYパラメーターは設定されません。

"DEFAULT"を指定すると，同一パラメーターのアクション定義が複数指定された場合，自動アクション定義ファイルの記述順で先頭行に近いアクション定義を優先します。

"V8COMPATIBLE"を指定すると，JP1/IM - Managerのバージョンが09-00より前の自動アクション機能と同じ優先順位となります。つまり，同一パラメーターのアクション定義が複数指定された場合，「イベントIDを指定したアクション定義」を「すべてのイベントを対象としたアクション定義」より優先し，次に自動アクション定義ファイルの記述順で先頭行に近いアクション定義を優先します。

[論理ホスト名¥JP1CONSOLEMANAGER¥LOG_CONTROL¥JCAMAIN]

自動アクションログ定義のキー名称です。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"LOGSIZE"=dword:16進数値

自動アクショントレースログ（1ファイル）の最大サイズ値を指定します。

65,536〜104,857,600バイト（64キロバイト〜100メガバイト）の16進数値で指定します。単位はバイトです。デフォルト値は「dword:00500000」（5,242,880バイト（5メガバイト））です。

デフォルト値の場合，実行するコマンドの最大長が100バイトのアクションを3000コマンド実行したときでもラップアラウンドしない値です。ログサイズを変更する場合は，JP1/IM - Managerのリリースノートを参照してログサイズを見積もってください。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER¥ACTION]
"ACTIONINFSIZE"=dword:00001000
"EVENTALIVEPERIOD"=dword:0000003c
"ACTIONEXECUSER"="JP1USER"
"ACTIONDEFFILE"="actdef.conf"
"HOSTINEVENT"="remote"
"ACTIONINFFILE"="actinf.log"
"SENDABLE_EVENT"="20A0 20A3 20A4"
"REGEXP"="JP1"

[JP1_DEFAULT¥JP1CONSOLEMANAGER¥LOG_CONTROL¥JCAMAIN]
"LOGSIZE"=dword:00100000

ファイルの終端が最下行の先頭になるようにしてください。

自動アクション定義ファイル（actdef.conf）

形式

[#自動アクション定義ファイルバージョン]
[DESC_VERSION=バージョン情報]

[#自動アクション状態監視パラメーター]
cmn
    [sta {true|false}]
end-cmn

[#自動アクション定義パラメーター]
act アクション名
    [prm パラメーターグループ]
    [cmt コメント]
    aid アクションID
    [valid true|false]
    eid イベントID

    cnd
        イベント条件
    end-cnd

    [usr ユーザー名]
    [hst {実行ホスト名|グループ名|業務グループ名|監視グループ名}]
    [{cmd アクション|rul}]
    [var 環境変数ファイル名]

    [det 抑止時間]
    [ret 遅延監視時間]
end-act

ファイル

actdef.conf（自動アクション定義ファイル）

actdef.conf.model（自動アクション定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action/

説明

JP1/IMの自動アクション機能で，アクションを実行する条件と，アクションとして実行するコマンドについて定義するファイルです。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

自動アクション定義ファイルの最大サイズは，22（23,068,672バイト）メガバイトです。

自動アクション機能はファイルの定義に従い，特定の条件を満たすJP1イベントを受信した時に，自動的にコマンドを実行します。

各行のアクションの定義をパラメーターといいます。自動アクション定義ファイルのパラメーターには，次の3種類があります。

自動アクション定義ファイルバージョン

自動アクション定義ファイルのフォーマットのバージョンを定義します。

自動アクション状態監視パラメーター（共通ブロック）

共通ブロック内では，cmnのパラメーターが指定でき，自動アクションの状態を監視するかどうかを定義します。

自動アクション定義パラメーター（アクションブロック）

アクションブロック内にはprmやcmtなどのパラメーターが指定でき，アクションを実行する条件と，アクションとして実行するコマンドについて定義します。

自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターは，自動アクション定義パラメーターの前に記述してください。自動アクション定義パラメーターの後ろに，自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターを記述した場合，定義内容は無効になります。

また，自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターを，複数回定義した場合，最初の定義を有効，2回目以降の定義を無効とします。

定義の記述

パラメーターの各単語は，半角スペースまたはタブで区切ります。

各行の先頭のパラメーター名の前の半角スペース，タブは無視されます。

「#」で始まる行は，コメントになります。ただし「#」の前に文字列が入っている場合は，コメント行として扱いません。

アクション定義で設定できるパラメーター名は，小文字で指定してください。大文字を含むパラメーター名を指定した場合，無効なパラメーターとして定義エラーとなります。

アクションの優先度

受信したJP1イベントが，複数の自動アクション定義の実行条件と一致する場合，（後述するパラメーターグループごとに）最も優先順位の高い自動アクションが一つだけ実行されます。自動アクションの優先順位は，次の規則によって決まります。

自動アクション定義ファイルで前に記述されている（GUIでは［アクション設定］の画面で上に表示されている）自動アクションが優先されます。

アクションの優先度は，共通定義で変更できます。自動アクションの優先順位については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「6.3.2　実行条件の優先度」を参照してください。

パラメーターグループとAND条件

それぞれの自動アクション定義パラメーターは，パラメーターグループに属します。パラメーターグループとは，自動アクション実行の条件を判定する単位です。パラメーターグループによって，一つのJP1イベントで複数のアクションを実行する場合や，複数の条件を満たすときにアクションを実行する場合など，複雑な条件を指定できます。

一つのJP1イベントがJP1/IMのマネージャーホストに届くと，パラメーターグループごとに，優先順位の順に自動アクション定義パラメーターと実行条件を比較します。実行条件が一致する場合は，パラメーターグループごとに優先順位の最も高い自動アクション定義パラメーターが一つだけ実行されます。

パラメーターグループに「&」を指定すると，前の行に定義した自動アクション定義パラメーターとのAND条件となります。自動アクション定義パラメーターをAND条件として指定すると，すべての条件が満たされたときにアクションが実行されます。

指定内容の確認

作成した定義ファイルは，jcamakeaコマンドを使って定義ファイルの定義内容を確認してください。

定義の反映時期

自動アクションの定義は，JP1/IM - Managerの起動時，JP1/IM - Viewの［アクション設定］画面の［適用］ボタンをクリックして定義を有効にしたとき，またはjcachangeコマンドを実行して定義を再読み込みしたときに有効になります。

jcachangeコマンドを実行して定義を再読み込みする場合は，jcachangeコマンドを実行する前にjcamakeaコマンドを実行して定義に誤りがないことを確認してください。

記述内容（自動アクション定義ファイルバージョン）

自動アクション定義ファイルバージョンに記述する項目について説明します。

DESC_VERSION=バージョン情報

自動アクション定義ファイルのフォーマットのバージョンを定義します。この定義は，自動アクション定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に記載します。先頭行以外に記載した場合，定義エラーとなります。

表2‒7　自動アクション定義ファイルのフォーマットのバージョン情報

バージョン情報

説明

1

07-11〜07-51の自動アクション定義ファイルのバージョンを示す。

2

08-00〜08-50の自動アクション定義ファイルのバージョンを示す。

3

09-00〜11-10の自動アクション定義ファイルのバージョンを示す。

4

11-50以降の自動アクション定義ファイルのバージョンを示す。

このパラメーターを省略，または「1」を指定した場合は，バージョン情報を「2」と仮定して読み込みます。JP1/IM - Viewで［アクション設定］画面の［適用］ボタンをクリックしたとき，「2」に設定し直します。

このパラメーターに「1」，「2」，「3」，または「4」以外の値を指定した場合，統合トレースログにエラーが出力され，バージョン情報を「3」と仮定して読み込みます。このとき，JP1/IM - Viewで［アクション設定］画面は表示できません。バージョン情報を変更したい場合は，直接定義ファイルを編集してください。

旧バージョンの自動アクション定義ファイルのフォーマットは，08-00以降の自動アクション定義ファイルのフォーマットと互換性があるため，08-00以降のフォーマットとして読み込まれます。

このパラメーターが自動アクション定義パラメーター以降の行に記述されている場合，JP1/IM - Viewで［アクション設定］画面が表示できなくなります。

jcamakeaコマンドを実行して自動アクションの定義ファイルの内容をチェックすることをお勧めします。

記述内容（自動アクション状態監視パラメーター）

自動アクション状態監視パラメーターに記述する項目について説明します。

cmn 〜 end-cmn

すべてのアクション定義に有効なパラメーターを指定するブロックの開始と終了パラメーターです。cmn 〜 end-cmnで定義している部分を共通ブロックと呼びます。このブロックは，「自動アクション定義パラメーター」の前に指定する必要があります。なお，このパラメーターは，自動アクション定義ファイルに一つだけ指定します。なお，このブロックは，省略できます。省略した場合は，staパラメーターはfalseを仮定します。

sta {true|false}

アクションの状態を監視するかどうかを指定します。

「true」または「false」のどちらかを指定します。状態監視する場合は「true」，状態監視しない場合は「false」です。デフォルト値は「false」です。

記述内容（自動アクション定義パラメーター）

自動アクション定義パラメーターに記述する各項目について説明します。

act アクション名 〜 end-act

自動アクション定義の開始と終了パラメーターです。act 〜 end-act間で定義する件数に制限はありません。ただし，一つ以上定義する必要があります。act アクション名 〜 end-actで定義している部分をアクションブロックと呼びます。

actのあとにはアクション名を，1〜50バイトの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

アクション名は，ほかのアクションブロックで指定したアクション名と重複できません。アクションブロックで指定できるパラメーターを次に示します。

prm，cmt，eid，cnd 〜 end-cnd，usr，hst，cmd，rul，var，det，ret，aid，valid

prm パラメーターグループ

パラメーターグループを指定します。このパラメーターを省略した場合，「0」を仮定します。

パラメーターグループは，1けたの数字（0〜9）および「&」で指定できます。1けたの数字（0〜9）を指定した場合，アクション名は省略できません。「&」を指定すると，直前のアクションブロックとのAND条件の指定になります。この場合，このアクションブロックの自動アクション定義パラメーターが属するパラメーターグループは，直前のアクションブロックと同じになります。「&」を指定している場合は，アクション名を指定できません。

「&」を指定していないアクションブロックのあとに，AND条件のアクションブロックを最大9件（最初のアクションブロックを含めて10件）指定できます。

同一のパラメーターグループでは，アクションブロックで前に記述されている（GUIでは［アクション設定］の画面で上に表示されている）アクションブロックが優先します。一つのJP1イベントがマネージャーに届くと，パラメーターグループごとに，優先順位の順にアクションブロックのイベント条件とマッチングします。イベント条件が一致する場合は，パラメーターグループごとに優先順位の最も高いアクションブロックのアクションを実行し，実行したアクションブロック以降のアクションブロックはマッチングしません。また，パラメーターグループの小さいものから大きいものの順番にイベントとマッチングを実施します。自動アクションの優先順位については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「6.3.2　実行条件の優先度」を参照してください。

cmt コメント

アクションブロックの説明を記述します。このパラメーターは省略できます。コメントは1,040バイト以内で指定してください。指定できる文字は，すべての文字です。1,040バイトを超えた分は削除されます。

aid アクションID

アクションIDを指定します。このパラメーターは省略できません。アクションIDに指定できる範囲は0〜2,147,483,647です。ただし，パラメーターグループに&を指定する場合は，指定できません。

バージョン情報が4の場合だけ，このパラメーターを指定できます。

valid true|false

自動アクション定義を有効（true）または無効（false）に設定します。このパラメーターは省略できます。省略した場合，有効（true）を仮定します。ただし，パラメーターグループに&を指定する場合は，指定できません。パラメーターグループに&を指定する場合の有効，無効は，一つ前のアクション実行条件に従います。

バージョン情報が4の場合だけ，このパラメーターを指定できます。

eid イベントID

アクション条件のイベントIDを指定します。このパラメーターは省略できません。また，複数指定はできません。

イベントIDは，基本部および拡張部から構成されます。イベントIDは，1〜8桁の16進数で指定し，基本部および拡張部は「:」（半角コロン）で区切って指定します。英大文字・英小文字を区別しません。なお，拡張部は省略できます。任意のイベントIDを指定する場合は，「*」で指定します。「*」を指定するとすべてのイベントをアクションの対象にするため，JP1イベントの発生頻度が大きい場合にアクションが大量に発生し，実行が遅延することがあります。「*」を指定する場合は，その他の条件（メッセージ，イベント基本情報，イベント詳細情報，イベント拡張情報）でイベントを絞り込んでください。

指定例を次に示します。

例）イベントID Aを指定する場合，次のように指定します。

eid a

eid A

eid 0000000a

eid 0000000A

eid 0000000A:0

eid 0000000A:00000000

例）任意のイベントIDを指定する場合，次のように指定します。

eid *

cnd イベント条件 〜 end-cnd

アクションを実行するイベント条件を指定するブロックの開始と終了パラメーターです。イベント条件ブロックは省略できません。イベント条件ブロックは，アクションブロック内に一つだけ指定します。イベント条件ブロックには，0〜256件のイベント条件を指定できます。それぞれのイベント条件は，AND条件となります。

イベント条件

イベント条件は，次の形式で指定します（△は半角スペースを表す）。

　属性名△比較キーワード△オペランド[△オペランド]…

なお，半角スペース，または，タブだけで構成された行は，無視して処理を続行します。

属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

%のあとに指定する文字コードは，英大文字・英小文字を区別しません。JP1正規表現を使用する場合，「%0d」は指定できません。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

イベント基本情報

属性名にB.BASICを指定すると，自動アクション定義ファイル（互換用）のイベント基本情報と同じ条件を設定できます。

属性名にB.BASICを指定した場合は，比較キーワードにはREGEXを指定してください。

オペランドは，自動アクション定義ファイル（互換用）のイベント基本情報と同じ形式で指定できます。ただし，半角スペース，タブ，改行（CR，LF），%は，%を使って記述してください。また，「/」は，「/」と記述してください。「¥/」と記述する必要はありません。

イベント詳細情報

属性名にB.DETAILを指定すると，自動アクション定義ファイル（互換用）のイベント詳細情報と同じ条件を設定できます。

属性名にB.DETAILを指定した場合は，比較キーワードにはREGEXを指定してください。

オペランドは，自動アクション定義ファイル（互換用）のイベント詳細情報と同じ形式で指定できます。ただし，半角スペース，タブ，改行(CR，LF)，%は，%を使って記述してください。また，「/」は，「/」と記述してください。「¥/」と記述する必要はありません。

イベント条件で指定できる属性名，比較キーワードおよびオペランドについて次の表に示します。

表2‒8　イベント条件で指定できる属性名，比較キーワードおよびオペランド

項番

項目

属性名

比較キーワード

オペランド

1

イベントID

B.ID

一致する

一致しない

正規表現

イベントIDを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

一致する，一致しないの場合は，イベントIDの大文字，小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

正規表現の場合は，比較するイベントのイベントIDを，次の形式と見なして比較する。

・イベントID拡張部が0の場合：

イベントID基本部（16進数8桁の英大文字または数字の文字列）

・イベントID拡張部が0でない場合：

イベントID基本部（16進数8桁の英大文字または数字の文字列）:イベントID拡張部（16進数8桁の英大文字または数字の文字列）

イベントID基本部またはイベントID拡張部は，8桁未満の値であった場合は先頭を0で埋め，8桁の文字列とする。

2

発行元プロセスID

B.PROCESSID

一致する

一致しない

正規表現

発行元APのプロセスIDを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

3

登録時刻

B.TIME

正規表現

JP1イベントが発行元ホストのイベントDBに登録された時刻を指定する。

設定方法はYYYYMMDDhhmmssの形式で正規表現で指定する。

4

到着時刻

B.ARRIVEDTIME

正規表現

JP1イベントが発行元ホストのイベントDBに到着した時刻を指定する。

設定方法はYYYYMMDDhhmmssの形式で正規表現で指定する。

5

発行元ユーザーID

B.USERID

一致する

一致しない

正規表現

発行元プロセスのユーザーID（数値）を設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

6

発行元グループID

B.GROUPID

一致する

一致しない

正規表現

発行元プロセスのグループID（数値）を設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

7

発行元ユーザー名

B.USERNAME

一致する

一致しない

含む

含まない

から始まる

正規表現

発行元プロセスのユーザー名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

8

発行元グループ名

B.GROUPNAME

一致する

一致しない

含む

含まない

から始まる

正規表現

発行元プロセスのグループ名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

9

発行元IPアドレス

B.SOURCEIPADDR

一致する

一致しない

含む

含まない

から始まる

正規表現

発行元イベントサーバに対応するIPアドレスを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

IPv6アドレスを指定する場合は，次に示すとおり，0〜9およびa〜fの4桁の16進数で指定する。英字部分は，英小文字で指定する。

（例）0011:2233:4455:6677:8899:aabb:ccdd:eeff

英字部分を英大文字にしたり，IPv4射影アドレス，IPv4互換アドレス，およびIPv6アドレスの省略形式を指定したりはできない。

10

発行元イベントサーバ名(登録ホスト名)※

B.SOURCESERVER

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントが発生したホストのホスト名（イベントサーバ名）を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

11

メッセージ

B.MESSAGE

一致する

一致しない

含む

含まない

から始まる

正規表現

イベント基本属性のメッセージを設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

12

イベント詳細情報

B.DETAIL

一致する

一致しない

含む

含まない

から始まる

正規表現

イベント基本属性の詳細情報を設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

JP1イベントの詳細情報にバイナリー形式のデータが設定されている場合，JP1イベントの詳細情報を空文字""（0バイト）として比較する。

互換用として使用できる。

13

登録要因

B.REASON

一致する

一致しない

登録要因を設定する。

複数指定できる。複数指定では最大100件指定できる。

14

開始時刻

E.START_TIME

正規表現

実行開始または再実行開始の時刻を設定する。

複数指定はできない。

通算秒の正規表現指定で設定する。

15

終了時刻

E.END_TIME

正規表現

実行終了の時刻を設定する。

複数指定はできない。

通算秒の正規表現指定で設定する。

16

プロダクト名

E.PRODUCT_NAME

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントを発行したプロダクトの名称を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

17

オブジェクトタイプ

E.OBJECT_TYPE

一致する

一致しない

含む

含まない

から始まる

正規表現

オブジェクトの種類を設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

18

オブジェクト名

E.OBJECT_NAME

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントのオブジェクト名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

19

登録名タイプ

E.ROOT_OBJECT_TYPE

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントの登録名タイプを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

20

登録名

E.ROOT_OBJECT_NAME

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントの登録名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

21

オブジェクトID

E.OBJECT_ID

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントのオブジェクトIDを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

22

事象種別

E.OCCURRENCE

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントの事象種別を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

23

ユーザー名

E.USER_NAME

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントを発行したユーザー名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

24

終了コード

E.RESULT_CODE

一致する

一致しない

含む

含まない

から始まる

正規表現

終了コードを設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

25

重大度

E.SEVERITY

一致する

正規表現

JP1イベントの重大度を指定する。

"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）の中から指定する。

複数指定できる。ただし，正規表現では複数指定はできない。

26

発生元ホスト名※

E.JP1_SOURCEHOST

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発生元ホスト名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

27

イベント基本情報

B.BASIC

正規表現

バージョン8以前の互換用のイベント基本情報を設定できる。

28

固有の拡張属性

−

一致する

一致しない

含む

含まない

から始まる

正規表現

固有の拡張属性の属性名を指定する。

属性名を先頭が英大文字で，英大文字，数字，およびアンダーバー（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

（凡例）

−：なし

注※

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

また，jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

usr ユーザー名

アクションを実行するJP1ユーザー名を指定します。usrパラメーターは省略できます。省略した場合，自動アクションの実行環境の定義で，アクション実行標準ユーザーとして指定したJP1ユーザー名を仮定します。アクション実行標準ユーザーも指定されていない場合は，jp1adminを使用します。

ユーザー名に指定できる文字数は，1〜31バイトです。半角英数字だけを使用できます。英字は大文字・小文字を区別しません。また，ユーザー名には，変数を指定できます。受信したJP1イベントに含まれる情報をユーザー名に設定したい場合は，変数を指定します。

ユーザー名にはイベントの情報を設定できます。

アクションを実行するとき，実行先ホストで，ここで指定したJP1ユーザーをJP1/Baseの定義に従ってOSユーザーにユーザーマッピングしてコマンドを実行します。UNIXの場合は，ユーザーマッピングしたOSユーザーのシェル環境を使用して実行します。なお，rulパラメーターと同時に指定できません。

hst {実行ホスト名|グループ名|業務グループ名|監視グループ名}

アクションを実行するホスト名，ホストグループ名，業務グループ名，および監視グループ名を指定します。ホスト名にはシステム構成の定義で管理対象ホストに設定したホスト名を指定します。hstパラメーターは省略できます。省略した場合，自ホストを仮定します。

実行ホスト名，ホストグループ名は，255バイト以内の文字列で指定します。実行ホスト名，ホストグループ名に半角スペースを含むものは指定できません。また，実行ホスト名，またはホストグループ名には，変数を指定できます。受信したJP1イベントに含まれる情報を実行ホスト名，またはホストグループ名に設定したい場合は，変数を指定します。例えば，イベント発行元のホストでアクションを実行したい場合は，「$EVHOST」と指定します。

実行ホスト名，ホストグループ名にはイベントの情報を設定できます。

業務グループ名，監視グループ名には，最大2,048バイトの文字列を指定できます。指定された文字列が「/」で始まる場合は，業務グループ名，監視グループ名と見なします。ただし，統合監視DBおよびIM構成管理DBが無効な場合は，ホスト名またはホストグループ名と見なします。

なお，rulパラメーターと同時に指定できません。

cmd アクション

アクションとして実行するコマンドを指定します。 指定できるコマンドについては，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「6.　自動アクションによるコマンド実行」を参照してください。

cmdパラメーターは省略できます。省略した場合，アクションを実行する条件が成立しても，何も実行しません。

ただし，次のパラメーターのどれかを指定した場合，cmdパラメーターを省略すると定義エラーとなります。

usr，var，hst，det，ret

また，cmdパラメーターは，複数指定できません。アクションは，4,096バイト以内の文字列で指定します。アクションの前のタブ・スペースは削除し，アクションの後ろのスペースは削除しません。

このパラメーターは，rulパラメーターと同時に指定できません。

アクションにはイベントの情報を設定できます。

なお，変数を使うことで受信したJP1イベントに含まれる情報を指定できます。例えば，実行ホストがUNIXの場合，次のように記述すると，JP1イベントのイベント発行元ホスト名を環境変数HOSTNAMEに指定できます。

HOSTNAME="$EVHOST" アクション

　xxx_BASIC="$EVBASE" xxx_MESSAGE="$EVMSG" アクション

アクションのコマンド長に関する注意事項

アクションとして実行できるコマンドの長さは，アクション定義で使用できる変数（$EVMSGなど）の変換後の情報を含めて，4,096バイトまでです。コマンドの長さが4,096バイトを超えた場合は実行状態が「実行不可」になり，コマンドは実行されません。［アクション結果詳細］画面の［メッセージ］欄には，KAVB4421-Wのメッセージが表示されます。

アクションとして実行できるコマンドの長さは，JP1/IM - Manager，JP1/Baseを運用しているシステムによって変わります。

自動アクションの実行経路上のホスト（実行元マネージャーホスト，実行先ホストを含む）にバージョン6，バージョン7のJP1/IM - Manager，JP1/Baseがある場合には，コマンドの長さは，最大1,024バイトに抑える必要があります。コマンド長に関する注意事項の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「12.4.1　自動アクションを検討するときの注意事項」を参照してください。

アクション中の文字として認識できないコードについての注意事項

アクション中に，文字として認識できないコード（ASCIIコードおよび環境設定で指定したマルチバイト文字コードの文字集合に含まれない部分）が含まれた場合，実行先ホストのシェルなどの仕様で実行されない，または実行されても結果が不正になることがあります。この場合，アクションは実行失敗にならず，終了状態になります。定義ファイル中に上記の不正なコードを指定していなくても，アクション定義で使用できる変数から実行時に置き換えることでアクションに含まれる場合があります。アクション対象イベントを発行する各製品のマニュアルなどで確認し，アクション定義で使用できる変数を指定してください。

rul

JP1/IM - RLへのルール起動要求を設定したい場合に指定します。なお，このパラメーターは，var，cmd，usr，hstパラメーターとは同時に指定できません。

var 環境変数ファイル名

アクションとして実行するコマンドの環境変数を指定した環境変数ファイルのファイル名をフルパスで指定します。このパラメーターは省略できます。省略した場合，環境変数ファイルは仮定されません。環境変数ファイルの形式については，マニュアル「JP1/Base 運用ガイド」を参照してください。

環境変数ファイル名は，255バイト以内の文字列で指定します。環境変数ファイル名にはイベントの情報を設定できます。また，環境変数ファイル名には，変数を指定できます。受信したJP1イベントに含まれる情報を環境変数ファイル名に設定したい場合は，変数を指定します。例えば，ENVFILEという名称のJP1イベント拡張属性を環境変数ファイル名として設定したい場合は，「$EV"ENVFILE"」と指定します。

なお，このパラメーターは，rulパラメーターと同時に指定できません。環境変数ファイル名の前後のスペースは削除しません。varの後ろにある1文字のタブ・スペースだけ削除します。

det 抑止時間

アクションを抑止する時間を指定します。このパラメーターで指定した時間内に発生した同一のアクション条件に対するアクションは抑止されます。このパラメーターは省略できます。省略した場合，アクションは抑止されません。抑止時間に指定できる範囲は1〜3,600（秒）です。パラメーターグループに「&」を指定している場合はこのパラメーターは指定できません。AND条件を使用する場合は，AND条件の最初に定義する自動アクション定義パラメーターに指定してください。

ret 遅延監視時間

アクションの実行時間を監視する時間を指定します。このパラメーターで指定した時間が，マネージャー上のJP1/BaseにJP1イベントが到着してから，実行先ホストのコマンド制御アクション実行終了メッセージを受信するまでの時間を超過した場合，JP1イベントの発行やコマンドの実行などの方法で，アクションに遅延が発生していることを通知します。このパラメーターは省略できます。省略した場合，アクションの遅延監視をしません。遅延監視時間に指定できる範囲は1〜86,400（秒）です。

#コメント行

#で始まる行は，コメント扱いとなります。なお，JP1/IM - Viewからアクション定義を設定した場合，#のコメント行は削除されます。

アクション定義で使用できる変数

自動アクション定義パラメーターの定義のうち，usr，var，hst，cmdパラメーターには，変数を使って，JP1イベントに含まれる情報を指定できます。

アクション実行時に，変数がJP1イベント中の情報に変換されて実行されます。

変数を自動アクション定義パラメーターに記述する場合は，「$EVID」のような形式で指定します。なお，「$」を文字列として扱いたい場合は，エスケープ文字「¥」を「$」の前に指定してください。

使用できる変数を次に示します。

表2‒9　アクション定義で使用できる変数

情報の種類

変数名

内容

JP1イベント基本属性に含まれる情報

EVBASE

イベント基本情報全体※1

EVID

イベントID（基本コード:拡張コード）

EVIDBASE

イベントID（基本コード）

EVDATE

イベント登録日（YYYY/MM/DD）※2

EVTIME

イベント登録時刻（hh:mm:ss）※2

EVPID

イベント発行元プロセスID

EVUSRID

イベント発行元プロセスのユーザーID

EVGRPID

イベント発行元プロセスのグループID

EVUSR

イベント発行元ユーザー名

EVGRP

イベント発行元グループ名

EVHOST

イベント発行元ホスト名

EVIPADDR

イベント発行元IPアドレス

EVSEQNO

イベントDB内通し番号

EVARVDATE

イベント到着日（YYYY/MM/DD）※2

EVARVTIME

イベント到着時刻（hh:mm:ss）※2

EVSRCNO

イベント発生元のイベントDB内通し番号

EVMSG

メッセージテキスト全体※3

EVDETAIL

イベント詳細情報全体※3，※4

JP1イベント拡張属性に含まれる情報

EVSEV

イベント拡張情報重大度（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）※3

EVUSNAM

ユーザー名※3

EVOBTYP

オブジェクトタイプ※3

EVOBNAM

オブジェクト名※3

EVROBTYP

登録タイプ※3

EVROBNAM

登録名※3

EV"PRODUCT_NAME"

プロダクト名※5

EV"OBJECT_ID"

オブジェクトID※5

EV"OCCURRENCE"

事象種別※5

EV"START_TIME"

開始時刻※5

EV"END_TIME"

終了時刻※5

EV"RESULT_CODE"

終了コード※5

EV"JP1_SOURCEHOST"

発生ホスト名※5

EV"拡張属性名"

任意の拡張属性※5

その他

EV"@JP1IM_CORRELATE"

相関イベントフラグ

相関イベントではない：0

相関成立イベントである：1

相関不成立イベント：2

EV"@JP1IM_ORIGINAL_SEVERITY"

イベント拡張情報重大度(変更前)

（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）※3

EV"@JP1IM_CHANGE_SEVERITY"

重大度変更フラグ

重大度を変更していない：0

重大度を変更した：1

EV"@JP1IM_DISPLAY_MESSAGE"

メッセージ(変更後)

EV"@JP1IM_CHANGE_MESSAGE"

表示メッセージ変更フラグ

メッセージを変更していない：0

メッセージを変更した：1

ACTHOST

アクション実行要求元マネージャーホスト名※3

EVENV1〜EVENV9

アクションの実行条件の指定で，正規表現中に"( )"を指定して切り出したデータ※5

（マネージャーホストで拡張正規表現を使用している場合だけ使用できる）

注※1　JP1イベントの基本情報が次の形式に変換されてアクションに渡されます（△は半角スペース）。

イベントID△イベント発行元ユーザー名△イベント発行元ユーザーID△イベント発行元グループ名△イベント発行元グループID△イベント発行元イベントサーバ名△イベント発行元プロセスID△イベント登録年月日△イベント登録時刻△イベント発行元ホストIPアドレス

設定されていない項目は空文字となります。

注※2　JP1/IM - Managerのタイムゾーンで変換してアクションに渡されます。

注※3　該当する属性が存在しない場合，アクション実行時に変数が空文字に変換されてアクションに渡されます。

注※4　JP1イベントの詳細属性の情報がバイナリー形式の場合は，変数が空文字に変換されてアクションに渡されます。

注※5　該当する属性が存在しない場合，変数の文字列がそのままアクションに渡されます。

また，JP1イベントの種類によっては，変数自体のないものや，各属性に含まれる情報に文字として認識できないコード（ASCIIコードおよび環境設定で指定したマルチバイト文字コードの文字集合に含まれない部分）が含まれていることで，アクションが実行できない，または実行されても結果が不正になる場合があります。また，JP1イベント発行元の制限によってJP1イベント中の情報が途中で切れ，アクションが実行できない，または実行されても結果が不正になる場合があります。JP1イベント発行元製品のマニュアルなどを事前に参照し，属性値の情報を確認してから置き換え文字を設定してください。

イベント引き継ぎ情報のエンコーディング

アクションの実行内容に関する項目のうち「アクション」については，イベント引き継ぎ情報の値をURLエンコーディングしたり，Base64エンコーディングしたりできます。指定形式は，「$変数名$エンコーディングの種類」です。エンコーディングの種類の直後に半角英数字，または_（アンダーバー）を指定する場合は，「${変数名$エンコーディング種類}」の形式で指定してください。「$」を文字列として扱いたい場合は，エスケープ文字「¥」を「$」の前に指定してください。

次の場合，「$変数名$エンコーディングの種類」または「${変数名$エンコーディング種類}」は，文字列と見なされて変換されません。

「変数名」に該当するイベントが存在しない。

指定形式が誤っている。

イベント引き継ぎ情報のエンコーディングの種類と指定形式を次に示します。

表2‒10　イベント引き継ぎ情報のエンコーディングの種類と指定形式

項番

エンコーディングの種類

指定形式

説明

1

URLエンコーディング

$変数名$URLENC

イベント引き継ぎ情報の値をUTF-8の文字列としてURLエンコーディングします。

${変数名$URLENC}

2

Base64エンコーディング

$変数名$ENC

イベント引き継ぎ情報の値をBase64エンコーディングします。

${変数名$ENC}

3

Base64コーディングとURLコーディングの両方

$変数名$ENC$URLENC

イベント引き継ぎ情報の値をBase64エンコーディングし，さらにURLエンコーディングします。

${変数名$ENC$URLENC}

4

エンコーディングしない

$変数名

URLエンコーディングもBase64エンコーディングもしない。

${変数名}

変数の記述での注意点

変数の直後に文字を記述する場合，変数の直後に英数字および「_」を指定すると正しく変換されません。このような場合は，変数を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

（指定例）

アクション定義 → 変換後の情報

「$EVID abc」 →「100:0 abc」

「$EVIDabc」 →「$EVIDabc」(Windowsの場合)，なし(UNIXの場合)

「${EVID}abc」 →「100:0abc」

「$EVID_abc」 →「$EVID_abc」(Windowsの場合)，なし(UNIXの場合)

「${EVID}_abc」→「100:0_abc」

「$EV"EX" abc」→「ABC abc」

「$EV"EX"abc」 →「ABCabc」

変換元の文字情報に，次に示す制御文字が含まれていた場合，その制御文字は半角スペース（0x20）に変換されて処理されます。

半角スペースに変換される制御文字：0x01〜0x1F（タブ（0x09）を除く），0x7F

例えば，$EVMSGの指定によって取得したメッセージの中に改行コード（0x0A）が含まれていた場合，改行コード（0x0A）は半角スペース（0x20）に変換されて処理されます。

（例）アクション（echo $EVMSG）を設定し，イベントのメッセージとして改行コードを含む文字列”1行目 0x0A 2行目”を受信した場合には，アクションとして実行されるコマンドは "echo 1行目△2行目"となります（△は半角スペースを表す）。

「$」は「¥」を直前に指定することで，文字として扱われます。ただし，ファイルパスなどで「¥」に続いて変数を指定したい場合は，「¥」が変換されて，文字列として扱われません。この場合の回避方法を，次に示します。

実行コマンドに指定する場合

変数を引数に指定したバッチファイルを作成します。「¥」を使用するコマンドラインの組み立ては，バッチファイル内で指定します。

実行コマンドの指定例：

・実行コマンド：AppTest.bat $ACTHOST

・バッチファイル：application.exe c:¥work¥%1¥result.txt

この例では，「%1」に「$ACTHOST」を変換した値が設定されます。

変数をファイルパスに使用する場合

変数に任意のプレフィックスを付けます。

「EV"PRODUCT_NAME"」に「IM-VIEW」が設定されている場合の例を，変換できる場合とできない場合に分けて次に示します。

変数を変換できない例：

・指定例：C:¥$EV"PRODUCT_NAME"

・変換結果：C:$EV"PRODUCT_NAME"

この例では，「¥$」が指定されているため，「EV"PRODUCT_NAME"」が変換されません。

変数を変換できる例：

・指定例：C:¥pre_$EV"PRODUCT_NAME"

・変換結果：C:¥pre_IM-VIEW

この例では，「pre_」を変数の前に付けることで，「EV"PRODUCT_NAME"」が変換されます。

UNIXの場合，最終的な展開はシェルの解釈に依存します。展開後のデータに「*」など，シェルで特別な意味を持つ文字がある場合，その内容に置き換えられます。置き換えられないようにするには，変数全体を「"」で囲み，「"$EVMSG"」のように記述してください。

変数で指定されたJP1イベントの情報に「"」や「'」など，コマンドで特別な意味を持つ文字がある場合，コマンドが正しく解釈されないときがあります。イベント引き継ぎ情報変換設定ファイルで文字変換することをお勧めします。イベント引き継ぎ情報変換設定ファイルの詳細については，「イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）」（2.　定義ファイル）を参照してください。

アクション定義での正規表現

自動アクションの定義で，イベント監視条件にJP1イベントの属性（メッセージテキスト・基本属性・詳細情報）を正規表現で指定する場合の指定方法について説明します。

使用できる正規表現は，OSによって異なります。Windowsの場合とUNIXの場合に分けて，使用できる正規表現を説明します。

複数のOSでアクション定義を共用する場合，正規表現の解釈が異なるので，どのOSでも使用できる表現で条件を記述するように注意してください。なお，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」に各OS共通で使用できる正規表現を記載しています。これを参考にして使用する正規表現を決めてください。

Windows版の正規表現

Windows版では，使用できる正規表現をJP1独自の正規表現，拡張正規表現のどちらかにできます。デフォルトは拡張正規表現です。JP1独自の正規表現にする場合は，「自動アクション環境定義ファイル（action.conf.update）」（2.　定義ファイル）を参照して設定してください。

UNIX版の正規表現

UNIX版では「拡張正規表現」を使用します。使用できる正規表現の詳細については，OS提供の「regexp（5）」を参照してください。

正規表現に関する注意事項

自動アクションの正規表現は部分一致のため，先頭および末尾に「.*」を指定した場合と，先頭および末尾に「.*」を指定しない場合は同じ条件になります。

例えば，次の例1と，例2は同じ条件になります。

（例1）「A001△:△WEBサーバ」を含む文字列の場合に一致する正規表現

.*A001△:△WEBサーバ.*

（例2）「A001△:△WEBサーバ」を含む文字列の場合に一致する正規表現

A001△:△WEBサーバ

先頭および末尾に「.*」を指定した場合，検索に時間が掛かることがあるので，先頭および末尾に「.*」は指定しないでください。

正規表現を使用していて，次に示すどちらかに一致している場合，jcamakeaコマンドを実行した際にKAVB5759-Wメッセージが表示されます。

正規表現として，先頭または末尾に「.*」が指定されている

正規表現として，「.*」が連続して指定されている

KAVB5759-Wメッセージの詳細については，マニュアル「JP1/Integrated Management 2 - Manager メッセージ」の「2.6　自動アクションおよびイベント基盤サービスに関するメッセージ（KAVB4001〜KAVB6000）」を参照してください。

定義例

自動アクション定義ファイルの定義例を次に示します。なお，定義例は，正規表現の種別に拡張正規表現を指定しています。

定義例1：変数を使用した例1

変数を使用して受信したJP1イベントの情報を，アクションとして実行するコマンドの引数に指定する場合の定義例を次に示します。

イベント条件

イベントID（B.ID）が「00000001」

メッセージの形式が「メッセージID※△:△メッセージ本文」

注※　メッセージIDは，英字1文字と3けたの数字。

アクションとして実行するコマンド

alarm.bat△引数1△引数2

コマンドの引数に指定するJP1イベントの情報

引数1：メッセージの値（変数には，${EVMSG}を指定）

引数2：拡張属性AAAの値（変数には，${EV"AAA"}を指定）

受信したJP1イベントのメッセージ（B.MESSAGE）の値が「A001△:△WEBサーバーがダウンしました。」，拡張属性AAAの値が「kanshi」の場合，「alarm.bat△"kanshi"△"A001△:△WEBサーバーがダウンしました。"」というアクションを実行します。

定義例2：変数を使用した例2

変数「EVENV1」〜「EVENV9」を使用して受信したJP1イベントの情報の一部を，アクションとして実行するコマンドの引数に指定する場合の定義例を次に示します。

イベント条件

イベントID（B.ID）が「00000001」

メッセージの形式が「メッセージID※△:△メッセージ本文」

注※　メッセージIDは，英字1文字と3けたの数字。

アクションとして実行するコマンド

alarm.bat△引数1△引数2

コマンドの引数に指定するJP1イベントの情報

引数1：メッセージのメッセージIDの値（変数には，${EVENV1}を指定）

引数2：メッセージのメッセージ本文の値（変数には，${EVENV2}を指定）

受信したJP1イベントのメッセージ（B.MESSAGE）の値が「A001△:△WEBサーバーがダウンしました。」の場合，「alarm.bat△"A001"△"WEBサーバーがダウンしました。"」というアクションを実行します。

定義例3：イベントIDを正規表現で指定した例1

イベント条件の属性名に「B.ID」，比較キーワードに「REGEX」を指定する場合の定義例を次に示します。

イベント条件

イベントIDが00000001〜00000200（16進数のA〜Fの文字は含めない）

発行元イベントサーバ名（B.SOURCESERVER）が「kanshi」

アクションとして実行するコマンド

alarm.bat

イベント条件でイベントIDを指定する場合は，イベント条件で指定しているイベントIDが対象となるように，eidに「*」を指定してください。

定義例4：イベントIDを正規表現で指定した例2

イベント条件の属性名に「B.BASIC」を指定すると，自動アクション定義ファイル（互換用）のイベント基本情報と同じ形式で条件を設定できます。

イベント条件の属性名に「B.BASIC」，比較キーワードに「REGEX」を指定する場合の定義例を次に示します。

イベント条件

イベントIDが00000001〜00000200（16進数のA〜Fの文字は含めない）

発行元イベントサーバ名（B.SOURCESERVER）が「kanshi」

アクションとして実行するコマンド

alarm.bat

タブ，半角スペース，%，および改行コードの指定方法が自動アクション定義ファイル（互換用）と異なります。詳細については，「自動アクション定義ファイル（actdef.conf）（互換用）」（2.　定義ファイル）を参照してください。

定義例5：AND条件を使用した例

イベントAおよびイベントBを受信した場合にアクションを実行するように指定するときの定義例を次に示します。

イベントAの条件

イベントID（B.ID）が「00000201」

メッセージ（B.MESSAGE）が「WEBサーバーAがダウンしました。」

イベントBの条件

イベントID（B.ID）が「00000202」

メッセージ（B.MESSAGE）が「WEBサーバーBがダウンしました。」

アクションとして実行するコマンド

alarm.bat

AND条件を使用する場合は，相関イベント発行機能を使った自動アクションをお勧めします。相関イベント発行機能は，AND条件では考慮できない，JP1イベントの順序や件数を指定できます。相関イベントについては，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.3　相関イベントの発行」を参照してください。

自動アクション定義ファイル（actdef.conf）（互換用）

形式

[#自動アクション定義ファイルバージョン]
[DESC_VERSION=バージョン情報]

[#自動アクション状態監視パラメーター]
△₀[：state_watch={true | false}]

[#自動アクション定義パラメーター]
△₀[ {+パラメーターグループ番号|&}△₁] {$イベントID|*}△₁
[/メッセージ/] [,[/イベント基本情報/] [,[/イベント詳細情報/]
[,[/イベント拡張情報重大度/] ] ] ]△₁[イベント拡張情報属性名=/属性値/
[,イベント拡張情報属性名2=/属性値/][,…] ]△₀
: △₀[u=ユーザー名△₁] [e=環境変数ファイル名△₁]
[d=実行先ホスト名|グループ名△₁] [dt=抑止時間△₁]
[rt=遅延監視時間△₁] [アクション]
   ：

ファイル

actdef.conf（自動アクション定義ファイル）（互換用）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action/

説明

JP1/IMの自動アクション機能で，アクションを実行する条件と，アクションとして実行するコマンドについて定義するファイルです。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

自動アクション機能はこのファイルの定義に従い，特定の条件を満たすJP1イベントを受信した時に，自動的にコマンドを実行します。

各行のアクションの定義をパラメーターといいます。自動アクション定義ファイルのパラメーターには，次の3種類があります。

自動アクション定義ファイルバージョン

自動アクション定義ファイルのフォーマットのバージョンを定義します。

自動アクション状態監視パラメーター

自動アクションの状態を監視するかどうかを定義します。

自動アクション定義パラメーター

アクションを実行する条件と，アクションとして実行するコマンドについて定義します。

自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターは，自動アクション定義パラメーターの前に記述してください。自動アクション定義パラメーターの後ろに，自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターを記述した場合，定義内容は無効になります。

また，自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターを，複数回定義した場合，最初の定義を有効，2回目以降の定義を無効とします。

定義の記述

自動アクション状態監視パラメーターおよび自動アクション定義パラメーターは，定義を１行に１件ずつ定義します。１行に書ききれない場合は，次の行に継続できます。

自動アクション定義パラメーターでは，「:」で区切られた二つの部分により「イベント監視条件：アクション実行定義」という形式で指定します。

一つの自動アクション定義パラメーターの最大長は，5,706バイトです。

バイト数には，空白を含みます。改行コードと，継続行にする場合の「¥」は含みません。

自動アクション定義パラメーターが長いときは，次の行に継続できます。

定義行を継続するときは，改行コードの直前に「¥」を記述します。「¥」と改行コードの間に空白など文字がある場合は継続行にならず，「¥」はデータとして扱います。

1カラム目が「#」の行はコメントになります。

コメントは1行で記述してください。複数行のコメントは，GUIで定義したときに定義行の直前の1行目以外が破棄されます。なお，行の途中や継続行の中の「#」はコメントではなくデータとして扱います。

イベント監視条件の優先度

受信したJP1イベントが，複数の自動アクション定義の実行条件と一致する場合，（後述するパラメーターグループごとに）最も優先順位の高い自動アクションが一つだけ実行されます。自動アクションの優先順位は，次の規則によって決まります。

イベントIDを指定した自動アクションは，イベントIDの「すべて」を対象にする自動アクションが優先されます。

自動アクション定義ファイルで前に記述されている（GUIでは［アクション設定］の画面で上に表示されている）自動アクションが優先されます。

パラメーターグループとAND条件

それぞれの自動アクション定義パラメーターは，パラメーターグループに属します。パラメーターグループとは，自動アクション実行の条件を判定する単位です。パラメーターグループによって，一つのJP1イベントで複数のアクションを実行する場合や，複数の条件を満たすときにアクションを実行する場合など，複雑な条件を指定できます。

一つのJP1イベントがJP1/IMのマネージャーに届くと，パラメーターグループごとに，優先順位の順に自動アクション定義パラメーターと実行条件と比較します。実行条件が一致する場合は，パラメーターグループごとに優先順位の最も高い自動アクション定義パラメーターが一つだけ実行されます。

パラメーターグループに「&」を指定すると，前の行に定義した自動アクション定義パラメーターとのAND条件となります。自動アクション定義パラメーターをAND条件として指定すると，すべての条件が満たされたときにアクションが実行されます。

自動アクション定義パラメーターのサイズチェック

自動アクション定義パラメーターでサイズチェックされる項目とその最大長を次に示します。

自動アクション定義パラメーターのサイズは5,706バイトまで。

自動アクション定義パラメーターのイベント監視条件のサイズは1,040バイトまで。

自動アクション定義パラメーターのアクションのサイズは4,096バイトまで。

最大長を超過した場合は，定義を反映するときにメッセージが表示され，該当する自動アクション定義パラメーターは無視されます。

指定内容の確認

作成した定義ファイルは，jcamakeaコマンドを使って定義ファイルの定義内容を確認してください。

自動アクション定義ファイル（actdef.conf）（互換用）では業務グループ名を使用できません。業務グループ名を指定した場合，ホスト名として扱われます。

定義の反映時期

自動アクションの定義は，JP1/IM - Managerの起動時，JP1/IM - Viewの［アクション設定］画面の［適用］ボタンをクリックして定義を有効にしたとき，またはjcachangeコマンドを実行して定義を再読み込みしたときに有効になります。

jcachangeコマンドを実行して定義を再読み込みする場合は，jcachangeコマンドを実行する前にjcamakeaコマンドを実行して定義に誤りがないことを確認してください。

記述内容（自動アクション定義ファイルバージョン）

自動アクション定義ファイルバージョンに記述する項目について説明します。

DESC_VERSION=バージョン情報

自動アクション定義ファイルのフォーマットのバージョンを定義します。

表2‒11　自動アクション定義ファイルのフォーマットのバージョン情報

バージョン情報

説明

1

07-11〜07-51の自動アクション定義ファイルのバージョンを示す。

2

08-00以降の自動アクション定義ファイルのバージョンを示す。

3

09-00以降の自動アクション定義ファイルのバージョンを示す。

4

11-50以降の自動アクション定義ファイルのバージョンを示す。

このパラメーターを省略，または「1」に指定した場合は，バージョン情報を「2」と仮定して読み込みます。JP1/IM - Viewで［アクション設定］画面の［適用］ボタンをクリックしたとき，「2」に設定し直します。

このパラメーターに「1」，「2」，「3」，または「4」以外の値を指定した場合，統合トレースログにエラーが出力され，バージョン情報を「3」と仮定して読み込みます。このとき，JP1/IM - Viewで［アクション設定］画面は表示できません。バージョン情報を変更したい場合は，直接定義ファイルを編集してください。

旧バージョンの自動アクション定義ファイルのフォーマットは，08-00以降の自動アクション定義ファイルのフォーマットと互換性があるため，08-00以降のフォーマットとして読み込まれます。

このパラメーターが自動アクション定義パラメーター以降の行に記述されている場合，JP1/IM - Viewで［アクション設定］画面が表示できなくなります。

jcamakeaコマンドを実行して自動アクションの定義ファイルの内容をチェックすることをお勧めします。

記述内容（自動アクション状態監視パラメーター）

自動アクション状態監視パラメーターに記述する項目について説明します。

state_watch={true | false}

アクションの状態を監視するかどうかを指定します。

「true」または「false」のどちらかを指定します。デフォルト値は「false」です。

「true」を指定した場合，バージョン07-10以前のJP1/IM - Viewで［アクション設定］画面を表示できません。

このパラメーターは，自動アクション定義パラメーターより前に記述されている場合にだけ有効となります。

このパラメーターが自動アクション定義パラメーター以降の行に記述されている場合，JP1/IM - Viewで［アクション設定］画面が表示できなくなります。

jcamakeaコマンドを実行して自動アクションの定義ファイルの内容をチェックすることをお勧めします。

バージョン07-11以降のJP1/IM - Viewが07-11以降のJP1/IM - Manager（セントラルコンソール）に接続している場合，アクションの状態を監視する・しないにかかわらず，自動アクション状態監視パラメーターは自動アクション定義ファイルに出力されます。

記述内容（自動アクション定義パラメーター）

自動アクション定義パラメーターに記述する各項目について説明します。なお，JP1イベントについては，「3.　JP1イベント」を参照してください。また，定義中に指定する正規表現と変数については，後述します。

イベント監視条件

自動アクション定義パラメーターの中で，実行条件として記述する項目を次に示します。実行条件として定義できるパラメーターの長さは1,040バイトまでです。

{+パラメーターグループ番号|&}

この行の自動アクション定義パラメーターが属しているパラメーターグループの番号を，「+」に続けて1けたの数字（0〜9）で指定します。指定を省略すると「0」を仮定します。

「&」を指定すると，直前の定義行とのAND条件の指定になります。この場合，この行の自動アクション定義パラメーターが属するパラメーターグループは，直前の定義行と同じになります。

なお，パラメーターグループの数字の大小は，実行条件判定の優先順位およびアクションの実行順序とは関係ありません。

$イベントID

イベントIDを「$」に続けて指定します。イベントIDの指定形式は次のとおりです。

　基本部[:拡張部]

基本部および拡張部は，16進数8桁以内（0〜7fffffff）の範囲で指定します。英字は小文字だけを指定できます。

*

すべてのイベントIDを対象にする場合に指定します。*を指定するとすべてのイベントをアクションの対象にするため，JP1イベントの発生頻度が大きい場合にアクションが大量に発生し，実行が遅延することがあります。*を指定する場合は，その他の条件（メッセージ，イベント基本情報，イベント詳細情報，イベント拡張情報）でイベントを絞り込んでください。

メッセージ

実行条件として，JP1イベントのメッセージテキストを指定します。条件には，正規表現を使うことができます。正規表現で指定する場合は，メッセージテキストの制御コード以外の部分を記述するようにしてください。

正規表現で「/」を表す場合は，「¥/」と記述してください。

イベント基本情報

実行条件として，JP1イベント基本属性の情報を指定します。指定には，正規表現を使うことができます。

正規表現で「/」を表す場合は，「¥/」と記述してください。正規表現の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

イベント基本情報は，JP1イベント基本属性の情報を次のように並べた形式で渡されます。この形式にあわせて，アクションを実行する条件を指定してください。

イベントID△イベント発行元ユーザー名△イベント発行元ユーザーID△

イベント発行元グループ名△イベント発行元グループID△

イベント発行元イベントサーバ名△イベント発行元プロセスID△

イベント登録年月日△イベント登録時刻△イベント発行元ホストIPアドレス

これらのJP1イベントの基本属性に含まれる情報については，「3.　JP1イベント」を参照してください。

イベント詳細情報

実行条件として，JP1イベント基本属性の詳細属性の情報を指定します。

指定には，正規表現を使うことができます。

正規表現で「/」を表す場合は，「¥/」と記述してください。正規表現の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

JP1イベント基本属性の詳細属性の情報は，JP1イベントの付加的な情報で，内容や形式はJP1イベントによって異なります。なお，JP1イベントの詳細属性の情報がバイナリー形式の場合は，情報がない（NULL）として扱われます。

・備考：JP1イベント基本属性の詳細属性は，主にバージョン5以前のJP1/SES形式と互換のイベントを発行する製品が，詳細情報を記録する場合などに使われます。バージョン6以降の製品の多くは，JP1イベント拡張属性を使って詳細な情報を記録します。

イベント拡張情報重大度

実行条件として，JP1イベント拡張属性の重大度を指定します。重大度は次の形式で，文字の部分を組み合わせて指定します。

　「-------E」　重大度：Emergency

　「------A-」　重大度：Alert

　「-----C--」　重大度：Critical

　「----E---」　重大度：Error

　「---W----」　重大度：Warning

　「--N-----」　重大度：Notice

　「-I------」　重大度：Information

　「D-------」　重大度：Debug

例えば，Error以上の重大度を条件として設定する場合は，/----ECAE/と指定します。

イベント拡張情報属性名=/属性値/

実行条件として，JP1イベント拡張属性の属性名と属性値を組み合わせて指定します。指定には，正規表現を使うことができます。

正規表現で「/」を表す場合は，「¥/」と記述してください。

属性名と属性値の組み合わせを，最大100組指定できます。

属性名は，英大文字，数字，およびアンダーバー（_）から構成される32バイトまでの名称を指定できます。属性名に「:」「=」を含むものは指定できません。属性名は，"PRODUCT_NAME"，"OBJECT_NAME"のように指定します。ほかの機能での設定とは異なり，属性名の先頭に"E."は付けません。

なお，この項目で重大度（項目名"SEVERITY"）を指定する場合，属性値は"Emergency"，"Alert"などの文字列で指定します。

アクション実行定義

自動アクション定義パラメーターの中で，アクション実行定義として設定する項目を次に示します。

u=ユーザー名

アクションを実行するJP1ユーザー名を指定します。

ユーザー名に指定できる文字数は，1〜31バイトです。半角英数字だけを使用できます。英字は大文字・小文字を区別しません。

このパラメーターを指定しなかった場合は，自動アクションの実行環境の定義で，アクション実行標準ユーザーとして指定したJP1ユーザー名を使用します。アクション実行標準ユーザーも指定されていない場合は，jp1adminを使用します。

JP1ユーザー名は，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。

アクションを実行するとき，実行先ホストで，ここで指定したJP1ユーザーをJP1/Baseの定義に従ってOSユーザーにユーザーマッピングしてコマンドを実行します。UNIXの場合は，ユーザーマッピングしたOSユーザーのシェル環境を使用して実行されます。

アクションに「<RULE>」と指定する場合は，この項目は設定できません。

e=環境変数ファイル名

アクションとして実行するコマンドの環境変数を指定した，環境変数ファイルのファイル名をフルパスで指定します。

ファイル名には，255バイトまでの文字列が指定できます。ファイル名に空白を含む場合は""で囲んで指定してください。

ファイル名は，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。例えば，ENVFILEという名称のJP1イベント拡張属性を環境変数ファイル名として使う場合は「$EV"ENVFILE"」と指定します。

なお，環境変数ファイルの形式については，マニュアル「JP1/Base 運用ガイド」を参照してください。

アクションに「<RULE>」と指定する場合は，この項目は設定できません。

d=実行先ホスト名|グループ名

アクションを実行するホスト名，またはホストグループ名を指定します。ホスト名にはシステム構成の定義で管理対象ホストに設定したホスト名を指定します。ホスト名・グループ名に空白を含むものは指定できません。

このパラメーターを省略した場合，アクションは自ホスト（自動アクション定義ファイルのあるホスト）で実行されます。

ホスト名・グループ名は，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。例えば，イベント発行元のホストでアクションを実行したい場合は，「$EVHOST」と指定します。

アクションに「<RULE>」と指定する場合は，この項目は設定できません。

dt=抑止時間

アクションを抑止する時間を指定します。このパラメーターで指定した時間内に発生した同一のアクション条件に対するアクションは抑止されます。このパラメーターを省略した場合，抑止は実行されません。抑止時間は，4バイトまでの数字で指定します。指定できる範囲は1〜3,600（秒）です。

このパラメーターを指定した場合，バージョン07-10以前のJP1/IM - Viewで［アクション設定］画面を表示できません。

なお，次の場合は，このパラメーターは指定できません。

・「&」を指定している場合

rt=遅延監視時間

アクションの実行時間を監視する時間を指定します。このパラメーターで指定した時間が，マネージャー上のJP1/BaseにJP1イベントが到着してから，実行先ホストのコマンド制御アクション実行終了メッセージを受信するまでの時間を超過した場合，JP1イベントの発行やコマンドの実行などの方法で，アクションに遅延が発生していることを通知します。このパラメーターを省略した場合，アクションの遅延監視は実行されません。

遅延監視時間は，5バイトまでの数字で指定します。指定できる範囲は1〜86,400（秒）です。

このパラメーターを指定した場合，バージョン07-10以前のJP1/IM - Viewで［アクション設定］画面を表示できません。

アクション

アクションとして実行するコマンドを指定します。

指定できるコマンドについては，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「6.　自動アクションによるコマンド実行」を参照してください。

このパラメーターを省略した場合，アクションを実行する条件が成立しても，何も実行しません。

コマンドのパラメーターに，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。

自動アクションが定義されているホストがUNIXの場合は，コマンドの環境変数に，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。この場合は「MESSAGE="$EVMSG" command arg1 arg2」のように指定します。

なお，自動アクション定義パラメーターの「:」以降は，実行するアクションを指定しますが，「u=」「e=」「d=」「dt=」「rt=」を指定すると前述のユーザー名などの項目と見なされます。「u=」などを指定した場合は，アクションの指定を省略するとエラーになります。

また，アクションとして実行できるコマンドの長さは，アクション定義で使用できる変数（$EVMSG など）の変換後の情報を含めて，4,096バイトまでです。コマンドの長さが4,096バイトを超えた場合は実行状態が「実行不可」になり，コマンドは実行されません。［アクション結果詳細］画面の［メッセージ］欄には，KAVB4421-Wのメッセージが表示されます。

アクション中に，文字として認識できないコード（ASCIIコードおよび環境設定で指定したマルチバイト文字コードの文字集合に含まれない部分）が含まれた場合，実行先ホストのシェルなどの仕様で実行されない，または実行されても結果が不正になることがあります。この場合，アクションは実行失敗にならず，終了状態になります。定義ファイル中に上記の不正なコードを指定していなくても，アクション定義で使用できる変数から実行時に置き換えることでアクションに含まれる場合があります。アクション対象イベントを発行する各製品のマニュアルなどで確認の上，アクション定義で使用できる変数を指定してください。

JP1/IM - Rule Operationへのルール起動要求を設定したい場合は，「<RULE>」と固定で指定してください。「<RULE>」と指定されている場合，［実行ユーザー名］［実行ホスト名］［環境変数ファイル］を同時に指定できません。このときKAVB4550-Wメッセージが表示され，自動アクション定義パラメーターは標準出力に出力されません。

アクションのコマンド長に関する注意事項

アクションとして実行できるコマンドの長さは，JP1/IM，JP1/Baseを運用しているシステムによって変わります。

自動アクションの実行経路上のホスト（実行元マネージャー，実行先ホストを含む）にバージョン6，バージョン7のJP1/IM，JP1/Baseがある場合には，コマンドの長さは，最大1,024バイトに抑える必要があります。コマンド長に関する注意事項の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「12.4.1　自動アクションを検討するときの注意事項」を参照してください。

アクション定義で使用できる変数

自動アクション定義パラメーターの定義のうち，実行するアクションの指定（:以降の指定）には，変数を使って，JP1イベントに含まれる情報を指定できます。アクション実行時に，変数がJP1イベント中の情報に変換されて実行されます。

変数を自動アクション定義パラメーターに記述する場合は，「$EVID」のような形式で指定します。

使用できる変数を次に示します。

表2‒12　アクション定義で使用できる変数

情報の種類

変数名

内容

JP1イベント基本属性に含まれる情報

EVBASE

イベント基本情報全体

EVID

イベントID（基本コード:拡張コード）

EVDATE

イベント発生日（YYYY/MM/DD）

EVTIME

イベント発生時刻（hh:mm:ss）

EVPID

イベント発行元プロセスID

EVUSRID

イベント発行元プロセスのユーザーID

EVGRPID

イベント発行元プロセスのグループID

EVUSR

イベント発行元ユーザー名

EVGRP

イベント発行元グループ名

EVHOST

イベント発行元ホスト名

EVIPADDR

イベント発行元IPアドレス

EVSEQNO

イベントDB内通し番号

EVARVDATE

イベント到着日（YYYY/MM/DD）

EVARVTIME

イベント到着時刻（hh:mm:ss）

EVSRCNO

イベント発生元のイベントDB内通し番号

EVMSG

メッセージテキスト全体

EVDETAIL

イベント詳細情報全体

JP1イベント拡張属性に含まれる情報

EVSEV

イベント拡張情報重大度（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）

EV"拡張属性名"

任意の拡張属性

その他

ACTHOST

アクション実行要求元マネージャー名

EVENV1〜EVENV9

アクションの実行条件の指定で，正規表現中に"( )"を指定して切り出したデータ

（マネージャーで拡張正規表現を使用している場合だけ使用できる）

該当しない項目の変数の値はNULLになります。また，JP1イベントの種類によっては，変数自体のないものや，各属性に含まれる情報に文字として認識できないコード（ASCIIコードおよび環境設定で指定したマルチバイト文字コードの文字集合に含まれない部分）が含まれていることで，アクションが実行できない，または実行されても結果が不正になる場合があります。JP1イベント発行元製品のマニュアルなどを事前に参照し，設定してください。

変数の記述での注意点

変数の直後に文字を記述する場合，変数の直後に英数字および「_ 」を指定すると正しく変換されません。このような場合は，変数を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

（指定例）

アクション定義 → 変換後の情報

「$EVID abc」 →「100:0 abc」

「$EVIDabc」 →「$EVIDabc」(Windowsの場合)，なし(UNIXの場合)

「${EVID}abc」 →「100:0abc」

「$EVID_abc」 →「$EVID_abc」(Windowsの場合)，なし(UNIXの場合)

「${EVID}_abc」→「100:0_abc」

「$EV"EX" abc」→「ABC abc」

「$EV"EX"abc」 →「ABCabc」

変換元の文字情報に，次に示す制御文字が含まれていた場合，その制御文字は半角スペース（0x20）に変換されて処理されます。

半角スペースに変換される制御文字：0x01〜0x1F（タブ(0x09)を除く），0x7F

例えば，$EVMSGの指定によって取得したメッセージの中に改行コード（0x0A）が含まれていた場合，改行コード（0x0A）は半角スペース（0x20）に変換されて処理されます。

（例）アクション（echo $EVMSG）を設定し，イベントのメッセージとして改行コードを含む文字列”1行目 0x0A 2行目”を受信した場合には，アクションとして実行されるコマンドは "echo 1行目△2行目"となります（△は半角スペースを表す）。

UNIXの場合，最終的な展開はシェルの解釈に依存します。展開後のデータに「*」など，シェルで特別な意味を持つ文字がある場合，その内容に置き換えられます。置き換えをしないようにするには，変数全体を「"」で囲み，「"$EVMSG"」のように記述してください。

変数で指定されたJP1イベントの情報に「"」や「'」など，コマンドで特別な意味を持つ文字がある場合，コマンドが正しく解釈されないときがあります。イベント引き継ぎ情報変換設定ファイルで文字変換することをお勧めします。イベント引き継ぎ情報変換設定ファイルの詳細については，「イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）」（2.　定義ファイル）を参照してください。

アクション定義での正規表現

自動アクションの定義で，イベント監視条件にJP1イベントの属性（メッセージテキスト・基本属性・詳細情報）を正規表現で指定する場合の指定方法について説明します。

使用できる正規表現は，OSによって異なります。Windowsの場合とUNIXの場合に分けて，使用できる正規表現を説明します。

複数のOSでアクション定義を共用する場合，正規表現の解釈が異なるので，どのOSでも使用できる表現で条件を記述するように注意してください。なお，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」に各OS共通で使用できる正規表現を記載しています。これを参考にして使用する正規表現を決めてください。

Windows版の正規表現

Windows版では，使用できる正規表現をJP1独自の正規表現，拡張正規表現のどちらかにできます。デフォルトは拡張正規表現です。JP1独自の正規表現にする場合は，「自動アクション環境定義ファイル（action.conf.update）」（2.　定義ファイル）を参照して設定してください。

JP1/IMの自動アクションでは，OSの正規表現に加えて，次の拡張記法も使えます。

「¥/」，「¥¥」

ブラケット式中でも，それぞれただの「/」，「¥」を表します。正規表現で「/」，「¥」を表すときはすべてこの方法を使います。

UNIX版の正規表現

UNIX版では「拡張正規表現」を使用します。使用できる正規表現の詳細については，OS提供の「regexp（5）」を参照してください。

JP1/IMの自動アクションでは，OSの正規表現に加えて，次の拡張記法も使えます。

「¥/」，「¥¥」

ブラケット式中でも，それぞれただの「/」，「¥」を表します。正規表現で「/」，「¥」を表すときはすべてこの方法を使います。

正規表現による基本属性・詳細属性の指定

イベント監視条件に，JP1イベントの基本属性・詳細情報を正規表現で指定する場合の方法について説明します。

自動アクション定義パラメーターの中では，JP1イベントの基本属性は，次の形式で表されます。

イベントID※1△イベント発行元ユーザー名△イベント発行元ユーザーID△

イベント発行元グループ名△イベント発行元グループID△

イベント発行元イベントサーバ名※2△イベント発行元プロセスID△

イベント登録年月日※3△イベント登録時刻※4△イベント発行元ホストIPアドレス

注※1

イベントIDは「基本コード:拡張コード」という形式で表されます。基本コードおよび拡張コードは，ともに8けたの16進数（A〜Fは大文字）です。IDの前の0は省略されます。拡張コードが00000000の場合は，「基本コード:0」と表されます。

注※2

イベントサーバ名とホスト名が異なる場合，イベント発行元ホスト名の取得方法が「local」に設定されていると，イベントサーバ名ではなくホスト名となります。

注※3

「YYYY/MM/DD」という形式で表されます。

注※4

イベント登録時刻は「hh:mm:ss」という形式で表されます。

JP1イベントの詳細情報は，次の形式で表されます。

情報1△情報2△情報3△…△情報n△

注

プログラムによっては，この形式でない場合や，固定長のためマルチバイト文字の1バイト目しか含まれていないなど，文字として認識できないコードが混入している場合もあります。形式については各プログラムのマニュアルを参照してください。

基本属性，詳細情報とも，情報中の各項目は，空白文字で区切られます。

該当する情報がない場合は，NULLになり，前後の区切りの空白が連続して表されます。また，最後の項目のあとには，将来の機能拡張などで情報が追加されることがあるので注意してください。

次に，基本属性および詳細情報中の各項目の指定方法を説明します。

基本属性，および詳細情報の先頭の項目を指定する場合は，先頭文字列を意味する「^」を使用します。例えば，イベントIDが00003A80のJP1イベントを指定するには，次のように指定します。

「^3A80:0△.*△.*△.*△.*△.*△.*△.*△.*△.*$」

2番目以降の項目を指定する場合は，「.* 」（任意の文字列と空白を示す）を繰り返して，不要な項目をスキップします。例えば，イベント基本属性の6番目の項目であるイベント発行ホスト名を指定する場合は，「.* 」を5回繰り返し，次のように指定します。

「^.*△.*△.*△.*△.*△host01」

次に，イベント情報の指定例を示します。

（例1）JP1USERで始まるユーザー名のユーザーから送信されたJP1イベント

^.*△JP1USER[_A-Z0-9]+△.*△.*△.*△.*△.*△.*△.*△.*$

（例2）host01〜host05で発行されたJP1イベント（拡張正規表現を使用している場合）

^.*△.*△.*△.*△.*△host0[1-5]△.*△.*△.*△.*$

（例3）host02で8時0分から8時10分に登録されたJP1イベント（拡張正規表現を使用している場合）

^.*△.*△.*△.*△.*△host02△.*△.*△08:(10|0[0-9]).*△.*$

（例4）詳細情報の3番目の項目が「prn」で始まるJP1イベント

^.*△.*△prn.*$

注　詳細情報の形式は，JP1イベントを発行するプログラムのマニュアルなどでご確認ください。

正規表現に関する注意事項

JP1独自正規表現（Windows）を拡張して，拡張正規表現を使用する場合には，拡張による誤動作を防ぐため，定義済みの設定を見直し，拡張正規表現用に定義し直す必要があります。

制御コード（改行，タブなど）は，製品やOSによって扱いが異なることがあります。このため，メッセージに対する条件を正規表現で記述する場合は，制御コード以外の部分を記述するようにしてください。

正規表現で，すべての文字に一致する表現の「.*」を多用すると，検索に時間が掛かることがあります。長いメッセージなどに対して「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。

また，拡張正規表現を使用できる環境で，かつ，空白以外の文字に一致させたい場合には，「.*」の代わりに「[^ ]*」が使用できます。「[^ ]*」を使用した方が検索に掛かる時間を短縮できます。

自動アクションの正規表現は部分一致のため，先頭および末尾に「.*」を指定した場合と，先頭および末尾に「.*」を指定しない場合は同じ条件になります。

例えば，次の例1と，例2は同じ条件になります。

（例1）「A001△:△WEBサーバ」を含む文字列の場合に一致する正規表現

.*A001△:△WEBサーバ.*

（例2）「A001△:△WEBサーバ」を含む文字列の場合に一致する正規表現

A001△:△WEBサーバ

先頭および末尾に「.*」を指定した場合，検索に時間が掛かることがあるので，先頭および末尾に「.*」は指定しないでください。

特殊文字である縦線「|」はOR条件を表します。このOR条件を正規表現中に使用する際は，次のことに注意してください。

OR条件の縦線「|」は正規表現の中で優先度が低いため，OR条件がかかる範囲を明示的に指定する必要があります。範囲を指定しない場合，動作しない，または誤動作する原因になることがあります。OR条件の範囲は，条件がかかる範囲を丸括弧「()」で囲むことで指定できます。イベント発行元サーバ名の条件をOR条件にするときの指定例を次に示します。

（例）gyoumuまたはhostで発行されたJP1イベント

^.*△.*△.*△.*△.*△(gyoumu|host)△.*△.*△.*△.*$

定義例

自動アクション定義ファイルの定義例を次に示します。なお，定義例は，正規表現の種別に拡張正規表現を指定しています。

定義例1：変数を使用した例1

変数を使用して受信したJP1イベントの情報を，アクションとして実行するコマンドの引数に指定する場合の定義例を次に示します。

イベント条件

イベントID（B.ID）が「00000001」

メッセージの形式が「メッセージID※△:△メッセージ本文」

注※　メッセージIDは，英字1文字と3けたの数字。

アクションとして実行するコマンド

alarm.bat△引数1△引数2

コマンドの引数に指定するJP1イベントの情報

引数1：メッセージの値（変数には，${EVMSG}を指定）

引数2：拡張属性AAAの値（変数には，${EV"AAA"}を指定）

受信したJP1イベントのメッセージ（B.MESSAGE）の値が「A001△:△WEBサーバーがダウンしました。」，拡張属性AAAの値が「kanshi」の場合，「alarm.bat△"kanshi"△"A001△:△WEBサーバーがダウンしました。"」というアクションを実行します。

定義例2：変数を使用した例2

変数「EVENV1」〜「EVENV9」を使用して受信したJP1イベントの情報の一部を，アクションとして実行するコマンドの引数に指定する場合の定義例を次に示します。

イベント条件

イベントID（B.ID）が「00000001」

メッセージの形式が「メッセージID※△:△メッセージ本文」

注※　メッセージIDは，英字1文字と3けたの数字。

アクションとして実行するコマンド

alarm.bat△引数1△引数2

コマンドの引数に指定するJP1イベントの情報

引数1：メッセージのメッセージIDの値（変数には，${EVENV1}を指定）

引数2：メッセージのメッセージ本文の値（変数には，${EVENV2}を指定）

受信したJP1イベントのメッセージ（B.MESSAGE）の値が「A001△:△WEBサーバーがダウンしました。」の場合，「alarm.bat△"A001"△"WEBサーバーがダウンしました。"」というアクションを実行します。

定義例3：イベントIDを正規表現で指定した例

イベント条件の属性名に「B.ID」，比較キーワードに「REGEX」を指定する場合の定義例を次に示します。

イベント条件

イベントIDが00000001〜00000200（16進数のA〜Fの文字は含めない）

発行元イベントサーバ名（B.SOURCESERVER）が「kanshi」

アクションとして実行するコマンド

alarm.bat

イベント基本情報でイベントIDを指定する場合は，イベント基本情報で指定しているイベントIDが対象となるように，eidに「*」を指定してください。

また，イベントIDの基本部と拡張部を8バイト以内の16進数で指定し，「：」で区切ってください。

定義例4：AND条件を使用した例

イベントAおよびイベントBを受信した場合にアクションを実行するように指定するときの定義例を次に示します。

イベントAの条件

イベントID（B.ID）が「00000201」

メッセージ（B.MESSAGE）が「WEBサーバーAがダウンしました。」

イベントBの条件

イベントID（B.ID）が「00000202」

メッセージ（B.MESSAGE）が「WEBサーバーBがダウンしました。」

アクションとして実行するコマンド

alarm.bat

AND条件を使用する場合は，相関イベント発行機能を使った自動アクションをお勧めします。相関イベント発行機能は，AND条件では考慮できない，JP1イベントの順序や件数を指定できます。相関イベントについては，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.3　相関イベントの発行」を参照してください。

自動アクション通知定義ファイル（actnotice.conf）

形式

[STATE_WATCH]
EVENT={true | false}
COMMAND=コマンド
[End]
[DELAY_WATCH]
EVENT={true | false}
COMMAND=コマンド
[End]

ファイル

actnotice.conf（自動アクション通知定義ファイル）

actnotice.conf.model（自動アクション通知定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action/

説明

自動アクションの状態監視または遅延監視で異常を検知した場合に，JP1イベントの発行および通知コマンドの実行で，自動アクションの異常を通知するかどうかを定義するファイルです。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

この定義ファイルで自動アクションの異常を通知するよう設定すると，自動アクションの状態監視では，「実行不可」「実行失敗」または「実行失敗（キャンセル失敗）」の状態となって異常終了した自動アクションを検知して，JP1イベントの発行および通知コマンドを実行し，オペレーターに異常状態になった自動アクションに対する対処を促します。また，自動アクションの遅延監視では，遅延監視時間で設定した時間内に終了しない自動アクションを検知して，JP1イベントの発行および通知コマンドを実行し，オペレーターに遅延状態になった自動アクションに対する対処を促します。

自動アクション通知定義ファイル（actnotice.conf）を削除した場合は，自動アクション通知定義ファイルのモデルファイル（actnotice.conf.model）をactnotice.confの名称でコピーし，必要に応じて，定義を変更してください。

定義の反映時期

次の場合に，自動アクション通知定義ファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドによりリロードをした場合

記述内容

[STATE_WATCH]

自動アクションの状態監視で異常を検知した場合に，JP1イベントの発行および通知コマンドの実行で，自動アクションの異常を通知するかどうかを定義します。

EVENT={true | false}

自動アクションの状態監視で異常を検知した場合に，JP1イベント（イベントID：2011）を発行するかどうかを指定します。

「true」または「false」のどちらかを指定します。異常検知時にJP1イベントを発行する場合は「true」を，発行しない場合は「false」を指定します。デフォルトは「true」です。なお，「true」を指定すると，次の場合にもJP1イベント（イベントID：2016，2021）が発行されるようになります。

・アクション状態監視への通知抑止が解除された場合（イベントIDが2016のJP1イベントが発行される）

・アクション状態の監視中に，異常状態となったアクションがアクション情報ファイルからラップした場合（イベントIDが2021のJP1イベントが発行される）

JP1イベントの詳細については，「3.2.2　JP1イベントの詳細」を参照してください。

COMMAND=コマンド

自動アクションの状態監視で異常を検知した場合に，実行する通知コマンドを指定します。

実行可能なコマンドの種類は次のとおりです。

コマンドを実行するホストがWindowsの場合

・実行形式ファイル（.com，.exe）

・バッチファイル（.bat）

・JP1/Scriptのスクリプトファイル（.spt）

（ただし.sptファイルが実行可能なよう関連づけが設定されていること）

コマンドを実行するホストがUNIXの場合

・実行形式ファイル（実行権限が付いていること）

・シェルスクリプト（実行権限が付いていること）

・上記以外の場合，または定義がない場合はデフォルト値「指定無し」を仮定します。

通知コマンドを定義する場合の注意事項を次に示します。

・「COMMAND=」から改行コードまでを一つのコマンドとして定義します。

・一つのコマンド定義の最大長は，1,023バイトです。

なお，変数を展開した文字列が1,023バイトを超える場合はコマンドを実行しません。

その際，統合トレースログにKAVB4409-Eのメッセージが出力されます。

・最大長のバイト数には，空白を含みます。改行コードは含みません。

・変数を指定する場合は，変数を「$」に続けて指定します。指定できる変数については，「表2-13　自動アクション通知定義ファイルで指定できる変数」を参照してください。

・COMMANDに指定された通知コマンドは，JP1/IM - Managerの実行環境を引き継ぎます。

・通知コマンドは，JP1/IM - Managerの実行権限（Windows：SYSTEMユーザー，UNIX：root）で実行されます。

・COMMANDに指定する通知コマンドは，フルパスで指定してください。

・通知コマンドは，必ず終了するコマンドを設定してください。バッチファイル（Windows）またはシェルスクリプト（UNIX）を設定する場合は，必ず exit 0 で終了するようにしてください。終了しないコマンドやGUIが起動するコマンドを指定した場合，実行した通知コマンドのプロセスが残ってしまいます。

・「$」を指定したい場合は「$$」と指定してください。

[DELAY_WATCH]

自動アクションの遅延監視で異常を検知した場合に，JP1イベントの発行および通知コマンドの実行で，自動アクションの異常を通知するかどうかを定義します。

EVENT={true | false}

自動アクションの遅延監視で異常を検知した場合に，JP1イベント（イベントID：2010）を発行するかどうかを指定します。

「true」または「false」のどちらかを指定します。異常検知時にJP1イベントを発行する場合は「true」を，発行しない場合は「false」を指定します。デフォルト値は「true」です。なお，「true」を指定すると，次の場合にもJP1イベント（イベントID：2015，2020）が発行されるようになります。

・アクション遅延監視への通知抑止が解除された場合（イベントIDが2015のJP1イベントが発行される）

・アクション遅延の監視中に，遅延状態となったアクションがアクション情報ファイルからラップした場合（イベントIDが2020のJP1イベントが発行される）

JP1イベントの詳細については，「3.2.2　JP1イベントの詳細」を参照してください。

COMMAND=コマンド

自動アクションの遅延監視で異常を検知した場合に，実行する通知コマンドを指定します。

実行可能なコマンドの種類は次のとおりです。

コマンドを実行するホストがWindowsの場合

・実行形式ファイル（.com，.exe）

・バッチファイル（.bat）

・JP1/Scriptのスクリプトファイル（.spt）

（ただし.sptファイルが実行可能なよう関連づけが設定されていること）

コマンドを実行するホストがUNIXの場合

・実行形式ファイル（実行権限が付いていること）

・シェルスクリプト（実行権限が付いていること）

・上記以外の場合，または定義がない場合はデフォルト値「指定無し」を仮定します。

通知コマンドを定義する場合の注意事項を次に示します。

・「COMMAND=」から改行コードまでを一つのコマンドとして定義します。

・一つのコマンド定義の最大長は，1,023バイトです。

なお，変数を展開した文字列が1,023バイトを超える場合はコマンドを実行しません。

その際，統合トレースログにKAVB4409-Eのメッセージが出力されます。

・最大長のバイト数には，空白を含みます。改行コードは含みません。

・変数を指定する場合は，変数を「$」に続けて指定します。指定できる変数については，「表2-13　自動アクション通知定義ファイルで指定できる変数」を参照してください。

・COMMANDに指定された通知コマンドは，JP1/IM - Managerの実行環境を引き継ぎます。

・通知コマンドは，JP1/IM - Managerの実行権限（Windows：SYSTEMユーザー，UNIX：root）で実行されます。

・COMMANDに指定する通知コマンドは，フルパスで指定してください。

・通知コマンドは，必ず終了するコマンドを設定してください。バッチファイル（Windows）またはシェルスクリプト（UNIX）を設定する場合は，必ず exit 0 で終了するようにしてください。終了しないコマンドやGUIが起動するコマンドを指定した場合，実行した通知コマンドのプロセスが残ってしまいます。

・「$」を指定したい場合は「$$」と指定してください。

表2‒13　自動アクション通知定義ファイルで指定できる変数

変数名

内容

ACTSEQNO

遅延状態および異常状態となったアクションのアクション通し番号。

状態監視で指定した時に，異常状態となったアクションがアクション情報ファイルからラップした場合には，（----）と表示される。

EVID

遅延状態および異常状態となったアクション契機イベントのイベントID（基本コード（16進8桁）:拡張コード（16進8桁））。

遅延または異常状態となったアクションがアクション情報ファイルからラップした場合には，（----:----）と表示される。

EVARVTIME

遅延状態および異常状態となったアクション契機イベントのイベント到着時刻（YYYY/MM/DD hh:mm:ss）。

遅延もしくは異常状態となったアクションがアクション情報ファイルからラップした場合には，（----/--/-- --:--:--）と表示される。

ACTSTAT

遅延状態および異常状態となったアクションのアクション状態。

アクションの実行状態を表す次の文字列のどれか。

running（実行中）

ended（終了）

fail（実行不可）

error（実行失敗）

unknown（状態不明）

wait（送信待機）

send（送信中）

queue（キューイング）

cancel（キャンセル）

kill（強制終了）

アクションをJP1/IM - Viewからキャンセルした場合，上記の状態の後ろにキャンセル状態が表示される。

キャンセル状態がキャンセル中の場合。

running（canceling）

send（canceling）

queue（canceling）

wait（canceling）

キャンセル状態がキャンセル失敗の場合。

running（miss）

send（miss）

queue（miss）

wait（miss）

ended（miss）

error（miss）

アクション実行サービスの再起動時にコマンドが再実行，またはアクション再実行用ファイルに出力された場合は，状態の後ろに「-R」が付く。（例：ended-R）

JP1/IM - Viewから再実行をした場合は，上記の状態の後ろに「-RU」が付く。（例：ended-RU）

抑止されたアクションをJP1/IM - Viewから再実行した場合は，上記状態の後ろに「-RUD」が付く。（例：ended-RUD）

抑止されたアクションをJP1/IM - View から再実行し，かつ，再実行中にアクション実行サービスの再起動（系切り替え含む）の発生によって再実行，またはアクション再実行用ファイルに出力された場合は，状態の後ろに「-RD」が付く。（例：ended-RD）

抑止されたアクションの状態が「fail」（実行不可）になった場合は，状態の後ろに「-D」が付く。（例：fail-D）

遅延監視で指定した場合に，遅延となったアクションがアクション情報ファイルからラップしたときには，（----）と表示される。

状態監視で指定した場合に，異常状態となったアクションがアクション情報ファイルからラップしたときには，次の文字列のどれかになる。

fail（実行不可）

error（実行失敗）

ACTSTARTTIME

遅延状態となったアクションのアクション開始時刻（YYYY/MM/DD hh:mm:ss）。

遅延監視で指定したときだけ，時刻が表示される。

状態監視で指定した場合には，（----/--/-- --:--:--）と表示される。

遅延監視で指定した場合に，遅延となったアクションがアクション情報ファイルからラップしたときには，（----/--/-- --:--:--）と表示される。

ACTENDTIME

異常状態となったアクションのアクション終了時刻（YYYY/MM/DD hh:mm:ss）。

状態監視で指定したときだけ，時刻が表示される。

遅延監視で指定した場合には，（----/--/-- --:--:--）と表示される。

状態監視で指定した場合に，異常状態となったアクションがアクション情報ファイルからラップしたときには，（----/--/-- --:--:--）と表示される。

ACTHOST

遅延状態および異常状態となったアクションの実行先ホスト名。

遅延監視で指定した場合に，遅延となったアクションがアクション情報ファイルからラップしたときには，（----）と表示される。

状態監視で指定した場合に，「実行ホスト名」を設定していないアクション定義により発行されたアクションの状態が「実行不可」となったときには，（----）と表示される。

ACTUSR

遅延状態および異常状態となったアクションを実行しているJP1ユーザー名。

実行先ホストに登録されているユーザー名となる。

遅延監視で指定した場合に，遅延となったアクションがアクション情報ファイルからラップしたときには，（----）と表示される。

状態監視で指定した場合に，「実行ユーザー名」を設定していないアクション定義により発行されたアクションの状態が「実行不可」となったときには，（----）と表示される。

定義例

自動アクションの状態監視または遅延監視で異常を検知した場合に，JP1イベントを発行し，通知コマンドstatenotice01.exe（状態監視の場合）または，delaynotice01.exe（遅延監視の場合）を実行する。

[STATE_WATCH]
EVENT=true
COMMAND=C:¥Command¥statenotice01.exe
[End]
[DELAY_WATCH]
EVENT=true
COMMAND=C:¥Command¥delaynotice01.exe
[End]

イベント条件表示項目定義ファイル（attr_list.conf）

形式

# コメント行
属性名
属性名
属性名
　・
　・
　・
属性名

ファイル

attr_list.conf（イベント条件表示項目定義ファイル）

attr_list.conf.model（イベント条件表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action/attr_list

説明

イベント条件表示項目定義ファイルは，［アクション詳細設定］画面の［属性名］表示領域に表示する表示項目を指定する定義ファイルです。［アクション詳細設定］画面は，イベント条件表示項目定義ファイルに指定された表示項目を指定された順番で［属性名］表示領域に表示します。

反映時期

イベント条件表示項目定義ファイルは，セントラルコンソールの起動時，または，jco_spmd_reloadコマンド実行時に読み込みます。JP1/IM - Viewは，［アクション設定］画面を表示するときにセントラルコンソールが読み込んだイベント条件表示項目定義ファイルの内容を取得し，［アクション詳細設定］画面に反映します。

記述内容

属性名

イベント条件表示項目定義ファイルには，［アクション詳細設定］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

指定できる属性名を次の表に示します。

SEPARATORを指定すると，［アクション詳細設定］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択してイベント条件を追加しても，イベント条件は設定できません。

表2‒14　表示項目一覧

項番

表示項目

属性名

1

登録ホスト名

B.SOURCESERVER

2

重大度

E.SEVERITY

3

オブジェクトタイプ

E.OBJECT_TYPE

4

オブジェクト名

E.OBJECT_NAME

5

登録名タイプ

E.ROOT_OBJECT_TYPE

6

登録名

E.ROOT_OBJECT_NAME

7

事象種別

E.OCCURRENCE

8

ユーザー名

E.USER_NAME

9

メッセージ

B.MESSAGE

10

プロダクト名

E.PRODUCT_NAME

11

イベントID

B.ID

12

開始時刻

E.START_TIME

13

終了時刻

E.END_TIME

14

登録時刻

B.TIME

15

到着時刻

B.ARRIVEDTIME

16

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

17

登録要因

B.REASON

18

発行元プロセスID

B.PROCESSID

19

発行元ユーザー名

B.USERNAME

20

発行元ユーザーID

B.USERID

21

発行元グループ名

B.GROUPNAME

22

発行元グループID

B.GROUPID

23

発行元IPアドレス

B.SOURCEIPADDR

24

オブジェクトID

E.OBJECT_ID

25

終了コード

E.RESULT_CODE

26

発生元ホスト名

E.JP1_SOURCEHOST

27

イベント基本情報

B.BASIC

28

イベント詳細情報

B.DETAIL

29

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，イベント表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜25が表示されます。

#コメント行

#で始まる行は，コメント扱いとなります。

定義例

B.SOURCESERVER
E.SEVERITY
E.OBJECT_TYPE
E.OBJECT_NAME
E.ROOT_OBJECT_TYPE
E.ROOT_OBJECT_NAME
E.OCCURRENCE
E.USER_NAME
B.MESSAGE
E.PRODUCT_NAME
B.ID
E.START_TIME
E.END_TIME
B.TIME
B.ARRIVEDTIME
OTHER_EXTENDED_ATTRIBUTE
B.REASON
B.PROCESSID
B.USERNAME
B.USERID
B.GROUPNAME
B.GROUPID
B.SOURCEIPADDR
E.OBJECT_ID
E.RESULT_CODE
E.JP1_SOURCEHOST

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

形式

変換前文字=変換後文字列
変換前文字=変換後文字列
      ：
変換前文字=変換後文字列

ファイル

event_info_replace.conf

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action

ファイルの権限

イベント引き継ぎ情報変換設定ファイルに必要な権限を次に示します。

Windowsの場合

AdministratorsグループおよびSYSTEMユーザーが参照できる必要があります。

UNIXの場合

root権限を持つユーザーが参照できる必要があります。

説明

自動アクション，およびコマンド実行のイベント引き継ぎ機能の変換ルールを指定するファイルです。自動アクション，およびコマンド実行のイベント引き継ぎ情報変換機能は，イベント引き継ぎ情報変換設定ファイルの変換ルールに従って，イベント引き継ぎ情報に含まれる特定のASCII文字を別の文字列に変換できます。

イベント引き継ぎ情報変換設定ファイルは，JP1/IM - Managerのインストール時に作成されません。使用する際は「event_info_replace.conf」をテキストエディターで作成・編集してください。

定義の反映時期

自動アクションの場合

イベント引き継ぎ情報変換設定ファイルの内容は，JP1/IM - Managerの起動時，JP1/IM - Viewの［アクション設定］画面の［適用］ボタンをクリックして定義を有効にしたとき，またはjcachangeコマンドを実行して定義を再読み込みしたときに有効になります。

コマンド実行の場合

イベント引き継ぎ情報変換設定ファイルの内容は，［コマンド実行］画面の起動時に有効になります。

記述内容

変換前文字=変換後文字列

イベント引き継ぎ情報変換設定ファイルには，イベント引き継ぎ情報の変換機能で「変換前の文字」と「変換後の文字列」を記述し，変換ルールを指定します。0〜34件の変換ルールを指定できます。

イベント引き継ぎ情報変換設定ファイルの半角スペース，タブ，改行だけの行は無視されます。1行に一つの変換ルールを指定します。変換前文字，変換後文字列は，「=」で区切って指定します。

定義した1行が「変換前文字=変換後文字列」の形式でない場合は，その定義を無視して処理を続行します。また，変換後文字列が指定されていない場合，イベント引き継ぎ情報の変換時に変換前の文字を削除する設定とします。

変換前文字の同じ変換ルールは指定できません。変換前文字の同じ変換ルールが複数あった場合，ファイルの先頭行に近い変換ルールが有効となり，その他の変換前文字の同じ変換ルールは無効となります。

イベント引き継ぎ情報に制御文字（0x00〜0x1F，0x7F〜0x9F）が含まれていた場合，その制御文字は半角スペース（0x20）に変換されます。

次に示す場合，変換ルールを無視して処理を続行します。

変換前文字に指定できない文字を指定した場合。

変換前の文字が2文字以上の場合。

変換前文字

変換前文字には，次の表の変換前文字で○となっているASCII文字（0x00〜0x7F）を1文字指定できます。

変換前文字として指定できるASCII文字を次に示します。

表2‒15　変換前文字および変換後文字列として指定できる文字

文字

16進数

変換前文字

変換後文字列

制御文字

0x00〜0x08

×

×

タブ

0x09

○

○

制御文字

0x0a〜0x1f

×

×

半角スペース

0x20

○

○

!

0x21

○

○

"

0x22

○

○

#

0x23

○

○

$

0x24

○

○

%

0x25

○

○

&

0x26

○

○

'

0x27

○

○

(

0x28

○

○

)

0x29

○

○

*

0x2a

○

○

+

0x2b

○

○

,

0x2c

○

○

-

0x2d

○

○

.

0x2e

○

○

/

0x2f

○

○

0〜9（数字）

0x30〜0x39

×

○

:

0x3a

○

○

;

0x3b

○

○

<

0x3c

○

○

=

0x3d

○

○

>

0x3e

○

○

?

0x3f

○

○

@

0x40

○

○

A〜Z（アルファベット大文字）

0x41〜0x5a

×

○

[

0x5b

○

○

¥

0x5c

○

○

]

0x5d

○

○

^

0x5e

○

○

_

0x5f

○

○

`

0x60

○

○

a〜z（アルファベット小文字）

0x61〜0x7a

×

○

{

0x7b

○

○

|

0x7c

○

○

}

0x7d

○

○

~

0x7e

○

○

制御文字

0x7f

×

×

（凡例）

○：指定できる

×：指定できない

変換後文字列

変換後文字列には，上記の表の変換後文字列で○となっているASCII文字（0x00〜0x7F）を0〜2文字まで指定できます。

定義例

「"」「'」および「*」を「_」に変換する例を次に示します。

"=_
'=_
*=_

メッセージ（B.MESSAGE）の値が「WEBサーバがダウンしました。詳細："Network△Error"」というJP1イベントを受信すると，メッセージテキスト全体（変数：EVMSG）の値は，「WEBサーバがダウンしました。詳細：_Network△Error_」となります。

拡張起動プロセス定義ファイル（jp1co_service.conf）

形式

プロセス名|起動オプション|再起動可否|再起動回数|リトライ間隔|再起動回数リセット時間|

ファイル

jp1co_service.conf（拡張起動プロセス定義ファイル）

jp1co_service.conf.model（拡張起動プロセス定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/

説明

JP1/IM - Managerを構成する機能のプロセス情報を定義するファイルです。

JP1/IM - Managerはプロセス管理機能によって，プロセス異常終了時の再起動を制御しています。プロセス管理機能は，拡張起動プロセス定義ファイルの定義に従ってプロセスを制御します。

空白など，不要な文字を記述しないでください。編集を許可されているパラメーターの数値だけを編集してください。

「再起動可否」のパラメーターだけを，運用にあわせてカスタマイズするようにしてください。ほかのパラメーターは，各プロセスに合わせて適切な値がデフォルト値として設定されているため，通常は設定を変える必要はありません。

クラスタ構成では，論理ホストのプロセス管理のプロセスを起動する際，論理ホストのconfフォルダに拡張起動プロセス定義ファイルがない場合，物理ホストの拡張起動プロセス定義ファイルがコピーされます。

定義の反映時期

定義ファイルの内容は，JP1/IM - Managerの起動時，またはjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。なお，「起動オプション」のパラメーター変更についてはJP1/IM - Managerの起動時にだけ有効になります。

記述内容

プロセス名

JP1/IM - Managerのプロセス管理機能により起動停止するプロセス名を指定します。

JP1/IM - Managerのプロセス名があらかじめ指定されています。編集しないでください。

なお，ここで指定した名称は，jco_spmd_statusコマンドでプロセス名として表示されます。

起動オプション

プロセスの起動オプションを指定します。

-Xmxパラメーター

-Xmxパラメーターは，Javaヒープ領域の最大サイズを設定するパラメーターです。

evtconプロセスおよびjddmainプロセスのヒープ領域使用量は，ユーザーの設定により初期値を超えることがあります。evtconプロセスは，デフォルト指定は-Xmx 512mで，512メガバイトがデフォルトサイズとなります。jddmainプロセスは，デフォルト指定はなしで，8,192メガバイトがデフォルトサイズとなります。ヒープ領域を見積もり，使用量がデフォルト値を超える場合には-Xmxパラメーターの値を見積もり後の値に変更する必要があります。

ヒープ領域の見積もりについては，JP1/IM - Managerのリリースノートを参照してください。

起動オプションの注意事項

・JP1/IM - Managerのevtconプロセスのヒープ領域サイズを変更する場合は，十分にテスト運用して問題ないことを確認してください。ヒープ領域範囲内で指定される場合であっても，メモリー不足によりJP1/IM - Managerが停止したり，［イベントコンソール］画面のイベント表示が更新されなくなったりするなど，動作が不安定になることがあります。この場合は，ヒープ領域見積もり式を参照し，［イベントバッファー］および［検索時のイベント取得件数］の設定を見直してください。

・JP1/IM - Managerのリリースノートに記載している最大メモリー容量は論理値です。OS種別，ご使用の環境，同時に稼働するアプリケーションの影響により，設定したヒープ領域を確保できない場合があります。ヒープ領域を確保できなかった場合や，デフォルト値を下回る値を設定した場合は，JP1/IM - Managerが起動できないなど，不具合が生じることがあります。

Windowsで，evtconプロセスのヒープ領域サイズを512メガバイトから1,024メガバイトに変更した場合の設定例を次に示します。

（設定例）

<ヒープ領域サイズを1,024メガバイトに変更する前（初期値）の状態>

evtcon|-Xmx512m|0|3|3|3600|

<ヒープ領域サイズを1,024メガバイトに変更したあとの状態>

evtcon|-Xmx1024m|0|3|3|3600|

再起動可否

プロセスが異常終了した場合に，再起動するかどうかを指定します。

再起動しない場合は0，再起動する場合は1を指定します。

デフォルトは0です。

再起動回数

プロセスの再起動の試行回数を指定します。

指定できる値は，0〜99です。デフォルトは3です。

なお，再起動可否のフィールドに0が指定されている場合は，値が指定されていても無効になります。

リトライ間隔

プロセスの再起動のリトライ間隔を，秒単位で指定します。

指定できる値は，0〜3,600です。デフォルトは3です。

なお，再起動可否のフィールドに0が指定されている場合は，値が指定されていても無効になります。

再起動回数リセット時間

再起動によってプロセスが起動してから何時間後に再起動回数をリセットするかを，秒単位で指定します。

指定できる値は，3,600〜2,147,483,647（秒）です。デフォルトは3,600です。

プロセスが起動してから，指定した時間が経過すると，再起動回数がリセットされます。再度プロセスが異常終了した場合は，再起動回数が1からカウントされます。再起動によってプロセスが起動してから，指定した時間より前に再度異常終了した場合は，前回の再起動回数を引き継ぎます。

なお，再起動可否のフィールドに0が指定されている場合は，値が指定されていても無効になります。

定義例

拡張起動プロセス定義ファイルの定義例を次に示します。

evflow||0|3|3|3600|
jcamain||0|3|3|3600|
evtcon|-Xmx512m|0|3|3|3600|
evgen||0|3|3|3600|
jcsmain||0|3|3|3600|
jcfmain||0|3|3|3600|
jddmain||0|3|3|3600|

IMパラメーター定義ファイル（jp1co_param_V7.conf）

形式

[論理ホスト名¥JP1CONSOLEMANAGER]
"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:値
"SEND_PROCESS_RESTART_EVENT"=dword:値

ファイル

jp1co_param_V7.conf（IMパラメーター定義ファイル）

jp1co_param_V7.conf.model（IMパラメーター定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/

説明

JP1/IM - Managerのプロセスの異常，また，異常終了からの自動復旧時にJP1イベントを発行するかどうかを定義するファイルです。JP1/IM - Managerのプロセス，および発行できるJP1イベントは次のようになります。

JP1/IM - Managerのプロセス

イベントコンソールサービス（evtcon）

イベント基盤サービス（evflow）

アクション実行サービス（jcamain）

セントラルスコープサービス（jcsmain）

相関イベント発行サービス（evgen）

発行できるJP1イベント

イベントIDが3F90のJP1イベント：プロセスが異常終了した場合に発行できる。

イベントIDが3F91のJP1イベント：プロセス起動時にタイムアウトした場合に発行できる。

イベントIDが3F92のJP1イベント：異常終了したプロセスが再起動を完了した場合に発行できる。

プロセスの異常や異常終了からの自動復旧時にJP1イベントを発行することにより，JP1/IM - Manager自身の障害を履歴管理できるようになります。このため，この定義ファイルを使って，JP1イベントを発行する設定にすることをお勧めします。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

この定義ファイルを引数にjbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER]

JP1/IM - Managerの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:値

値を「1」にすると，次の場合にJP1イベントを発行します。

プロセスが異常終了した場合（イベントIDが3F90のJP1イベントが発行される）

起動時に起動通知がなく，タイムアウトした場合（イベントIDが3F91のJP1イベントが発行される）

デフォルトは「0」でJP1イベントを発行しません。

JP1イベントの詳細については，「3.2.2　JP1イベントの詳細」を参照してください。

"SEND_PROCESS_RESTART_EVENT"=dword:値

値を「1」にすると，次の場合にJP1イベントを発行します。

プロセス再起動の機能により，異常終了したプロセスの再起動が完了した場合（イベントIDが3F92のJP1イベントが発行される）

デフォルトは「0」でJP1イベントを発行しません。

JP1イベントの詳細については，「3.2.2　JP1イベントの詳細」を参照してください。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER]
"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:0
"SEND_PROCESS_RESTART_EVENT"=dword:0

ファイルの終端が最下行の先頭になるようにしてください。

システムプロファイル（.system）

形式

DESC_VERSION=15
     :
[ServerDefine]
InvalidateTime = 1440
EventCount = イベントバッファー数
Debug = true
[End]
     :
[RetryInfo]
RetryCount = リトライ回数
RetryInterval = リトライ間隔
[End]

ファイル

.system（システムプロファイル）

.system.model（システムプロファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥profile¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥profile¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/profile/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/profile/

説明

イベントコンソールの基本動作を定義するファイルです。

各マネージャー（JP1/IM - Manager）に一つあり，イベントコンソールのシステム環境（イベントバッファー数やイベント検索時のイベントサービスとの接続リトライ回数など）についての環境情報を設定します。このプロファイルで設定した内容は，このプロファイルがあるマネージャーに接続されているすべてのJP1/IM - Viewに影響します。

定義の反映時期

JP1/IM - Manager起動時，または［システム環境設定］画面で［適用］ボタンをクリックしたときに，その定義が有効になります。

記述内容

EventCount = イベントバッファー数

イベントサービスからイベントを抽出してマネージャー上にバッファリングするときのイベント件数の上限を指定します。

指定できる値は10〜2,000，デフォルトは2,000です。

RetryCount = リトライ回数

イベント検索時にイベントサービスと接続ができなかった，または接続が切断された場合に自動的に再接続するリトライ回数を指定します。

指定できる値は0〜100，デフォルトは3です。

RetryInterval = リトライ間隔

イベント検索時にイベントサービスと接続ができなかった，または接続が切断された場合に自動的に再接続するリトライ間隔をミリ秒単位で指定します。

指定できる値は1〜86,400,000，デフォルトは10,000です。

注意事項

特別な理由がない場合は，［システム環境設定］画面で設定してください。

システムプロファイルの内容はイベントコンソールの動作のすべてに影響するため，操作にはご注意ください。また，説明していない属性および属性値については一切変更しないでください。変更した場合，イベントコンソールの動作が不正になることがあります。

システムプロファイルを編集する前に，JP1/IM - Viewを終了させてください。

システムプロファイルは，マネージャーごとにあります。そのため，ログインするマネージャーを変更した場合は，その接続先のシステムプロファイルを変更する必要があります。

.systemファイルの内容を変更する場合には，あらかじめバックアップを作成してから変更されることをお勧めします。

属性値が範囲外など，システムプロファイルに誤りがある場合，イベントコンソールは正しく動作しないことがあります。

定義例

DESC_VERSION=15
    :
[End]
[ServerDefine]
InvalidateTime = 1440
EventCount = 500
Debug = true
[End]
    :
[RetryInfo]
RetryCount = 3
RetryInterval = 10000
[End]

ユーザープロファイル（defaultUser | profile_ユーザー名）

形式

DESC_VERSION=ファイルバージョン
[DisplayItemContainer]
    :
[DisplayItemInformation]※
ValidTab=All
Visible=表示可否
AttrName=JP1イベント属性名
AttrOrder=並び順
ColumnSize=列幅
[End]
[End]
    :

注※　ValidTab=Allが記載されている[DisplayItemInformation]〜[End]内の太字部分だけが変更できます。

ファイル

defaultUser（デフォルトユーザープロファイル）

defaultUser.model（デフォルトユーザープロファイルのモデルファイル）

profile_ユーザー名（各JP1ユーザー用ユーザープロファイル）

格納ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥profile¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥profile¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/profile/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/profile/

説明

イベントコンソールの画面表示に関する環境情報をユーザーごとに定義するファイルです。

マネージャー上のユーザーごとにあり，イベントコンソールのユーザー環境（主に画面表示に関する環境情報）を設定します。ユーザーごとのプロファイルは，JP1ユーザー名に対応して「profile_ユーザー名」という名称で作成されます。なお，ユーザープロファイルにはすべてのユーザーのデフォルトとなる「defaultUser」プロファイルが用意してあります。この「defaultUser」プロファイルを変更しておくと，それ以降作成するユーザープロファイルは変更した「defaultUser」プロファイルを基準にします。

profile_ユーザー名（各JP1ユーザー用ユーザープロファイル）は，JP1/IM - Viewの［ユーザー環境設定］画面から定義できます。ユーザープロファイルに誤りがある場合，［イベントコンソール］画面が正しく表示されないことがありますので，JP1/IM - Viewの［ユーザー環境設定］画面から定義してください。

定義の反映時期

JP1/IM - Manager（セントラルコンソール）に再ログインするとその定義が有効になります。

記述内容

DESC_VERSION=ファイルバージョン

ユーザープロファイルの形式のバージョンを表しています。

ファイルバージョンにより，[DisplayItemInformation]〜[End]で指定できる項目が変わります。バージョン11-00以降はファイルバージョンに15を指定してください。ファイルバージョンに11以前が指定されている場合は，ファイルバージョンを変更しないでください。

profile_ユーザー名（各JP1ユーザー用ユーザープロファイル）は，次の操作によって最新のファイルバージョンに更新されます。

JP1/IM - Viewから［ユーザー環境設定］画面を保存する場合

JP1/IM - Viewのログアウト時に，［イベントコンソール］画面の各ページのイベント一覧に表示される項目の列幅の大きさを保存する場合

defaultUser（デフォルトユーザープロファイル）をファイルバージョン12にしたい場合は，defaultUser.model（デフォルトユーザープロファイルのモデルファイル）をdefaultUserに上書きした上で編集してください。

[DisplayItemInformation]〜[End]

[DisplayItemInformation]〜[End]内にイベントコンソール画面に表示するJP1イベントの属性を指定します。

[DisplayItemInformation]〜[End]で一つの定義ブロックとなります。定義ブロックの内容は，［イベントコンソール］画面の三つのページすべてに反映されます。定義ブロックを追加する場合は，[DisplayItemContainer]〜[End]の間に挿入します。

[DisplayItemInformation]〜[End]で指定できるパラメーターを次に示します。

なお，「AttrOrder=0」が指定されている[DisplayItemInformation]〜[End]は，システムが使用する定義となりますので，編集しないでください。

ValidTab = All

固定の文字列です。変更しないでください。

Visible = 表示可否

AttrNameで指定した属性の情報を表示するかどうかを指定します。表示可否に「true」を指定した場合は，AttrNameで指定した属性の情報が表示されます。表示可否に「false」を指定した場合は，AttrNameで指定した属性の情報は表示されません。なお，「false」を指定すると，［ユーザー環境設定］画面の「表示できる項目」に表示されます。表示可否に「false」を指定した場合は，AttrOrderには「-1」を指定してください。

AttrName = 表示する属性名

JP1イベントの属性名を指定します。ここで指定した属性の情報が［イベントコンソール］画面に表示されます。

設定可能な属性の一覧を次の表に示します。

表2‒16　「表示する属性名」に指定できる属性名の一覧

項番

指定可能な属性

属性の名称

DESC_VERSION

1〜10※1

11

12〜14

15

1

IM.EVENT_TYPE

種別

○

○

○

○

2

B.SEQNO

イベントDB内通し番号

○

○

○

○

3

B.IDBASE

イベントID

○

○

○

○

4

B.PROCESSID

発行元プロセスID

○

○

○

○

5

B.TIME

登録時刻

○

○

○

○

6

B.ARRIVEDTIME

到着時刻

○

○

○

○

7

B.USERID

発行元ユーザーID

○

○

○

○

8

B.GROUPID

発行元グループID

○

○

○

○

9

B.USERNAME

発行元ユーザー名

○

○

○

○

10

B.GROUPNAME

発行元グループ名

○

○

○

○

11

B.SOURCESERVER

登録ホスト名

○

○

○

○

12

B.SOURCESEQNO

発行元イベントDB内通し番号

○

○

○

○

13

B.MESSAGE

メッセージ

○

○

○

○

14

E.SEVERITY

重大度

○

○

○

○

15

E.USER_NAME

ユーザー名

○

○

○

○

16

E.PRODUCT_NAME

プロダクト名

○

○

○

○

17

E.OBJECT_TYPE

オブジェクトタイプ

○

○

○

○

18

E.OBJECT_NAME

オブジェクト名

○

○

○

○

19

E.OBJECT_ID

オブジェクトID

○

○

○

○

20

E.ROOT_OBJECT_TYPE

登録名タイプ

○

○

○

○

21

E.ROOT_OBJECT_NAME

登録名

○

○

○

○

22

E.OCCURRENCE

事象種別

○

○

○

○

23

E.START_TIME

開始時刻

○

○

○

○

24

E.END_TIME

終了時刻

○

○

○

○

25

E.@JP1IM_ACTCONTROL

アクション

×

○

○

○

26

E.@JP1IM_ACTTYPE

アクション種別

×

○

○

○

27

E.@JP1IM_ORIGINAL_SEVERITY

重大度(変更前)

×

○

○

○

28

E.@JP1IM_CHANGE_SEVERITY

重大度変更

×

○

○

○

29

E.@JP1IM_DISPLAY_MESSAGE

メッセージ(変更後)

×

×

×

○

30

E.@JP1IM_CHANGE_MESSAGE

表示メッセージ変更

×

×

×

○

31

E.@JP1IM_CHANGE_MESSAGE_NAME

表示メッセージ変更定義名

×

×

×

○

32

E.@JP1IM_MEMO

メモ

×

○

○

○

33

E.JP1_SOURCEHOST

発生元ホスト名

×

×

○

○

34

E.ACTION_TARGET※2

アクション

○

×

×

×

35

IM.ACTION_TYPE※2

アクション種別

○

×

×

×

36

E.*

固有の拡張属性

×

×

×

○

（凡例）

○：指定できる

×：指定できない

注※1

１〜10で指定できる項目は同じです。

注※2

バージョン8互換の項目です。DESC_VERSIONが10以前（バージョン8以前の定義）の場合に，次のように変換されます。

　　E.ACTION_TARGET → E.@JP1IM_ACTCONTROL

　　IM.ACTION_TYPE → E.@JP1IM_ACTTYPE

AttrOrder = 並び順

左から何列目に表示させるかを指定します。1を指定すると，イベント一覧のいちばん左側に表示されます。なお，ほかと同じ値は指定しないでください。

また，0はシステムで使用する値のため指定しないでください。

ユーザープロファイルに誤りがある場合，［イベントコンソール］画面が正しく表示されないことがありますので，JP1/IM - Viewの［ユーザー環境設定］画面から定義してください。

ColumnSize = 列幅

列の幅を指定します。指定できる値は，1〜1,000です。

注意事項

ユーザープロファイルの内容はイベントコンソールの動作のすべてに影響するため，操作にはご注意ください。また，説明していない属性および属性値については一切変更しないでください。変更した場合，イベントコンソールの動作が不正になることがあります。

JP1/IM - Viewの動作中および終了時には，ユーザープロファイルが上書きされることがあります。このため，ユーザープロファイルを編集する場合は，編集する前にJP1/IM - Viewを終了させてください。

ユーザープロファイルは，マネージャーごとにあります。そのため，ログインするマネージャーを変更した場合は，その接続先のプロファイルを変更する必要があります。

defaultUserファイルの内容を変更する場合には，あらかじめバックアップを作成してから変更されることをお勧めします。

JP1/Baseのユーザー管理でユーザーを削除しても，ユーザープロファイルは削除されません。

JP1/Baseのユーザー管理でユーザー名を変更しても，ユーザープロファイルは引き継がれません。

属性値が範囲外など，ユーザープロファイルに誤りがある場合，イベントコンソールは正しく動作しないことがあります。

通信環境定義ファイル（console.conf.update）

形式

[論理ホスト名¥JP1CONSOLEMANAGER¥EVCONS]
"COM_SO_TIMEOUT"=dword:16進数値

[JP1_DEFAULT¥JP1CONSOLE_CMD]
"COM_SO_TIMEOUT"=dword:16進数値
"COM_RETRY_COUNT"=dword:16進数値
"COM_RETRY_INTERVAL"=dword:16進数値
"COM_RMI_TIMEOUT"=dword:16進数値

ファイル

console.conf.update（通信環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

JP1/IM - Managerとビューアー，jcochstatコマンドとの通信処理（タイムアウト時間）を定義するファイルです。

ビューアーとJP1/IM - Managerとの通信で，ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。

また，ほかのマネージャーからjcochstatコマンドを使って自ホストのJP1イベントの対処状況を変更する場合にも，何らかの理由によって通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合，通信のタイムアウト時間や接続リトライ回数を変更することで通信エラーの発生を防げます。

JP1/IM - View（イベントコンソール）を使用している場合は，JP1/IM - View（イベントコンソール）の通信環境定義ファイル（view.conf.update）も変更が必要です。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER¥EVCONS]

イベントコンソールサービス環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"COM_SO_TIMEOUT"=dword:16進数値

タイムアウト時間を16進数値で指定します。単位はミリ秒です。デフォルト値はdword:0000EA60（60,000ミリ秒）です。

指定できる値の範囲は0x00000001〜0x0036EE80（3,600,000ミリ秒）です。

また，通信環境定義ファイル（console.conf.update），および通信環境定義ファイル（view.conf.update）の"COM_RMI_TIMEOUT"値（デフォルト：0000EA60）を超えないように指定してください。なお，接続元の設定値（タイムアウト時間）を確認してください。

[JP1_DEFAULT¥JP1CONSOLE_CMD]

jcochstatコマンド環境設定のキー名称です。

"COM_SO_TIMEOUT"=dword:16進数値

タイムアウト時間を16進数値で指定します。単位はミリ秒です。デフォルト値はdword:0000EA60（60,000ミリ秒）です。

指定できる値の範囲は0x00000001〜0x0036EE80（3,600,000ミリ秒）です。

また，通信環境定義ファイル（console.conf.update）の"COM_RMI_TIMEOUT"値（デフォルト：0000EA60）を超えないように指定してください。

"COM_RETRY_COUNT"=dword:16進数値

通信エラーが発生したときのリトライ回数を16進数で指定します。デフォルト値はdword:00000003（3回）です。

指定できる値の範囲は，0x00000001〜0x7fffffff（2,147,483,647回）です。

"COM_RETRY_INTERVAL"=dword:16進数値

リトライするまでの待ち時間を16進数で指定します。単位はミリ秒です。デフォルト値はdword:00000BB8（3,000ミリ秒）です。

指定できる値の範囲は，0x00000001〜0x7fffffff（2,147,483,647ミリ秒）です。

"COM_RMI_TIMEOUT"=dword:16進数値

イベントの対処状況変更のタイムアウト時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0000EA60（60,000ミリ秒）です。

KAVB1205-Eが頻繁に表示される場合，タイムアウト時間を長めに設定します。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER¥EVCONS]
"COM_SO_TIMEOUT"=dword:000009C4

[JP1_DEFAULT¥JP1CONSOLE_CMD]
"COM_SO_TIMEOUT"=dword:0000EA60
"COM_RETRY_COUNT"=dword:00000003
"COM_RETRY_INTERVAL"=dword:00000BB8

ファイルの終端が最下行の先頭になるようにしてください。

ヘルスチェック定義ファイル（jcohc.conf）

形式

[HEALTHCHECK]
ENABLE={true | false}
FAILOVER={true | false}
EVENT={true | false}
COMMAND=コマンド
NO_RESPONSE_TIME=無応答時間
ERROR_THRESHOLD=異常とみなす無応答回数
BASE_NO_RESPONSE_TIME=無応答時間
BASE_ERROR_THRESHOLD=異常とみなす無応答回数
[End]

ファイル

jcohc.conf（ヘルスチェック定義ファイル）

jcohc.conf.model（ヘルスチェック定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥health¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥health¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/health/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/health/

説明

ヘルスチェック機能を有効にするかどうかを定義するファイルです。ヘルスチェック機能を有効に設定する場合，異常を検知したときに，JP1イベントの発行および通知コマンドの実行で，異常を通知するかどうかも定義できます。

この定義ファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

ヘルスチェック定義ファイル（jcohc.conf）を削除した場合は，ヘルスチェック定義ファイルのモデルファイル（jcohc.conf.model）をjcohc.confの名称でコピーし，必要に応じて，定義を変更してください。

セントラルスコープサービス（jcsmain）はヘルスチェック機能で監視できません。

この定義ファイルでヘルスチェック機能を有効に設定すると，JP1/IM - Managerの各プロセスおよび自ホスト上のJP1/Baseのイベントサービスが正常に動作しているかどうかをチェックできます。

ヘルスチェック機能で異常を検知できるプロセスを次に示します。

イベントコンソールサービス（evtcon）

アクション実行サービス（jcamain）

イベント基盤サービス（evflow）

相関イベント発行サービス（evgen）

イベントサービス（jevservice）

これらのプロセスがハングアップ※や異常終了となった場合に，異常を検知し，JP1イベントを発行したり，設定した通知コマンドを実行したりして，オペレーターにプロセスの回復を促します。

注※

プロセスのハングアップとは，デッドロックや無限ループなどが原因で，プロセスが処理要求を受け付けなくなる状態です。

定義の反映時期

次の場合に，ヘルスチェック定義ファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドによりリロードをした場合

記述内容

ENABLE={true | false}

ヘルスチェック機能を有効にするかどうかを指定します。

「true」または「false」のどちらかを指定します。ヘルスチェック機能を有効にする場合は「true」を，無効にする場合は「false」を指定します。デフォルトは「false」です。

ヘルスチェック機能を有効にすると，ヘルスチェック定義ファイル内のEVENTの設定が「true」か「false」かに関係なく，ヘルスチェック機能で異常を検知した場合に統合トレースおよびWindowsイベントログ（syslog）にメッセージ（KAVB8060-E，KAVB8062-E）が出力されます。

FAILOVER={true | false}

クラスタシステムを使用している場合に使用します。ヘルスチェック機能で異常を検知した場合のJP1/IM - Managerの動作を「true」または「false」のどちらかで指定します。デフォルトは「false」です。クラスタシステムを使用していない場合には，デフォルトのままにしてください。

Windowsの場合

異常を検知したときにJP1/IM - Managerを停止する場合は「true」を，停止しない場合は「false」を指定します。ヘルスチェック機能で異常を検知したときにJP1/IM - Managerを停止することで，クラスタシステムにJP1/IM - Managerの異常を通知します。クラスタシステムでJP1/IM - Managerの障害時に，フェールオーバーするように設定しておくことで，ヘルスチェックが異常を検知した場合にフェールオーバーできます。

UNIXの場合

異常検知したJP1/IM - Managerのプロセスを停止する場合は「true」を，停止しない場合は「false」を指定します。ヘルスチェック機能で異常を検知したときにJP1/IM - Managerを停止することで，クラスタシステムにJP1/IM - Managerの異常を通知します。クラスタシステムでJP1/IM - Managerの障害時に，jco_killall.clusterコマンドで強制的に終了し，フェールオーバーするように設定しておくことで，ヘルスチェックが異常を検知した場合にフェールオーバーできます。

EVENT={true | false}

ヘルスチェック機能で異常を検知した場合に，JP1イベント（イベントID：2012，2013）を発行するかどうかを指定します。

「true」または「false」のどちらかを指定します。イベントを発行する場合は「true」を，発行しない場合は「false」を指定します。

デフォルトは「true」です。なお，「true」を指定すると，次の場合にもJP1イベント（イベントID：2014）が発行されるようになります。

ヘルスチェック機能が異常回復を検知した場合

JP1イベントの詳細については，「3.2.2　JP1イベントの詳細」を参照してください。

COMMAND=コマンド

ヘルスチェック機能で異常を検知した場合に，実行する通知コマンドを指定します。

実行可能なコマンドの種類は次のとおりです。

コマンドを実行するホストがWindowsの場合

実行形式ファイル（.com，.exe）

バッチファイル（.bat）

JP1/Scriptのスクリプトファイル（.spt）

　（ただし.sptファイルが実行可能なよう関連づけが設定されていること）

コマンドを実行するホストがUNIXの場合

実行形式ファイル（実行権限が付いていること）

シェルスクリプト（実行権限が付いていること）

通知コマンドを定義する場合の注意事項を次に示します。

「COMMAND=」から改行コードまでを一つのコマンドとして定義します。

一つのコマンド定義の最大長は，1,023バイトです。最大長のバイト数には，空白を含みます。改行コードは含みません。1,024バイトを超えた場合は，デフォルト値を仮定します。なお，変数を指定する場合は，変数を展開した文字列が1,023バイトを超えるときはコマンドを実行しません。その際，統合トレースログにKAVB8072-Eのメッセージが出力されます。

変数を指定する場合は，変数を「$」に続けて指定します。指定できる変数を次に示します。

表2‒17　通知コマンドに指定できる変数

変数名

内容

HCHOST

異常が発生したホスト名

HCFUNC

異常が発生した機能名

（evflow，jcamain，evtcon，evgenまたはjevservice）

HCPNAME

異常が発生したプロセスのプロセス名

（evflow，jcamain，evtcon，evgenまたはjevservice）

HCPID

evflow，jcamain，evtcon，evgenの場合

異常が発生したプロセスのプロセスID

jevserviceの場合

-1

HCDATE

異常が発生した日付（YYYY/MM/DD）

HCTIME

異常が発生した時刻（hh:mm:ss）

通知コマンドは，必ず終了するコマンドを設定してください。バッチファイル（Windows）またはシェルスクリプト（UNIX）を設定する場合は，必ず exit 0 で終了するようにしてください。終了しないコマンドやGUIが起動するコマンドを指定した場合，実行した通知コマンドのプロセスが残ってしまいます。

COMMANDに指定された通知コマンドは，JP1/IM - Managerの実行環境を引き継ぎます。

通知コマンドは，JP1/IM - Managerの実行権限（Windows：SYSTEMユーザー，UNIX：root）で実行されます。

COMMANDに指定する通知コマンドは，フルパスで指定してください。

また，設定した通知コマンドが正常に動作するかどうかは，jcohctestコマンドを使って十分にテストしてください。jcohctestコマンドについては，「jcohctest」（1.　コマンド）を参照してください。

デフォルトは指定なしの「COMMAND=」で，通知コマンドを実行しません。

「$」を指定したい場合は「$$」と指定してください。

Windowsでは，%WINDIR%¥System32フォルダ以下に配置されているコマンドを実行すると，WOW64のリダイレクト機能によって，%WINDIR%¥SysWow64フォルダ以下に配置されているコマンドにリダイレクトされます。リダイレクト先のコマンドがない場合，コマンドの実行に失敗することがあります。%WINDIR%¥System32フォルダ以下に配置されているコマンドを実行コマンドに指定する場合は注意してください。

NO_RESPONSE_TIME=無応答時間

JP1/IM - Managerのプロセスの無応答時間のチェック間隔を秒単位で指定します。指定できる範囲は，60〜3,600秒です。デフォルト値は「60」秒です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「60」秒を仮定します。

なお，このパラメーターはJP1/IM - Managerのインストール時に配置されるヘルスチェック定義ファイル（jcohc.conf）に記載されていません。設定をデフォルト値から変更する場合は，パラメーターを追記する必要があります。

ERROR_THRESHOLD=異常とみなす無応答回数

JP1/IM - Managerのプロセスについて異常とみなす無応答回数を指定します。指定できる範囲は，1〜60回です。デフォルト値は「3」回です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「3」回を仮定します。

BASE_NO_RESPONSE_TIME=無応答時間

マネージャー上のJP1/Baseのイベントサービスの無応答時間のチェック間隔を秒単位で指定します。指定できる範囲は，60〜3,600秒です。デフォルト値は「300」秒です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「300」秒を仮定します。

BASE_ERROR_THRESHOLD=異常とみなす無応答回数

マネージャー上のJP1/Baseのイベントサービスについて異常と見なす無応答回数を指定します。指定できる範囲は，1〜60回です。デフォルト値は2です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「2」回を仮定します。

定義例

ヘルスチェック機能で異常を検知した場合に，JP1イベントを発行し，通知コマンドjcohc01.exeを実行します。

[HEALTHCHECK]
ENABLE=true
FAILOVER=false
EVENT=true
COMMAND=C:¥Command¥jcohc01.exe
NO_RESPONSE_TIME=60
ERROR_THRESHOLD=3
BASE_NO_RESPONSE_TIME=300
BASE_ERROR_THRESHOLD=2
[End]

イベントガイド情報ファイル（jco_guide.txt）

形式

DESC_VERSION=ファイルバージョン

[EV_GUIDE_イベントガイド番号]
EV_USER=JP1ユーザー名
EV_COMP=属性名:属性値
EV_GUIDE=イベントガイドメッセージ
[END]
[EV_GUIDE_イベントガイド番号]
EV_COMP=属性名:属性値
EV_COMP=属性名:属性値
EV_FILE=イベントガイドメッセージファイル名
[END]
   :

ファイル

sample_jco_guide_ja.txt（イベントガイド情報ファイルのサンプルファイル（日本語））

sample_jco_guide_en.txt（イベントガイド情報ファイルのサンプルファイル（英語））

sample_jco_guide_ja.txt.model（イベントガイド情報サンプルのモデルファイル（日本語））

sample_jco_guide_en.txt.model（イベントガイド情報サンプルのモデルファイル（英語））

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥guide¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥guide¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/guide/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/guide/

説明

JP1イベントに対して，イベントガイド情報を定義するファイルです。このファイルで記述した内容は，JP1/IM - Viewおよび統合オペレーション・ビューアーの［イベント詳細］画面に表示されます。

イベントガイド情報ファイルの最大サイズは，1メガバイトです。また，イベントガイド情報ファイルの最大件数は，1,000件です。

イベントガイド情報ファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

なお，イベントガイド情報ファイルは，jco_guide.txtというファイル名で作成する必要があります。JP1/IM - Managerの動作する言語コードに合わせてsample_jco_guide_ja.txtまたはsample_jco_guide_en.txtをコピーし，ファイル名をjco_guide.txtに変更してから使用するようにしてください。また，格納先のディレクトリは，サンプルファイルと同じディレクトリにしてください。EV_FILEパラメーターで指定するファイル（イベントガイドメッセージファイル）と異なり，ファイル名は任意ではないため，注意してください。

発行されたJP1イベントに対して，複数のイベントガイド情報が一致する場合，イベントガイド情報ファイルで先に記述してある方が有効になります。

#を指定した場合，#以降は改行されるまでコメント扱いとなります。ただし，開始タグ，属性情報，終了タグの後方にコメントを記述できません。開始タグと終了タグの後方にコメントを記述した場合は，エラーとなります。また，属性値の後方にコメントを書いた場合は，属性値の一部として認識されます。

¥を記述する場合，¥¥と記述する必要があります。¥nおよび¥$以外に¥を記述していた場合はログが出力され，¥を記述した行を無視して処理します。

イベントガイド情報ファイル，イベントガイドメッセージファイルに記述されているHTMLの構文チェックはしません。

定義の反映時期

イベントガイド情報ファイルを編集後，JP1/IM - Managerを再起動するか，jco_spmd_reloadコマンドを実行したときから有効になります。なお，JP1/IM - Viewおよび統合オペレーション・ビューアーでのログイン時，［イベント詳細］画面にイベントガイド情報の表示領域がない場合，定義を有効にしたあと再ログインすることで，表示領域が表示されます。

イベントガイドメッセージファイルを編集した場合は，［イベント詳細］画面を表示し直すことで，編集内容が更新されます。

記述内容

DESC_VERSION=ファイルバージョン

イベントガイド情報ファイルの形式のバージョンを表しています。1または2を指定できます。2を指定すると，EV_USERパラメーターを指定できます。

[EV_GUIDE_イベントガイド番号]

イベントガイド情報の開始タグです。[EV_GUIDE_イベントガイド番号]〜[END]で一つの定義ブロックとなります。このパラメーターと[END]の間に［イベント詳細］画面への表示対象となるJP1イベントの比較条件および表示するメッセージを記述します。イベントガイド番号は，1〜9999の数字を10進数で指定します。

複数の定義ブロックがある場合でも順序性を持たせる必要はありませんが，同一のイベントガイド番号を指定するとエラーになり，定義ブロックが無効になります。なお，[EV_GUIDE_1]と[EV_GUIDE_0001]は異なります。

EV_GUIDE_イベントガイド番号タグ内の文字列は一意にしてください。不正な文字列がある場合はログが出力され，該当個所を無視して処理します。

EV_GUIDE_イベントガイド番号タグ内に記述できる属性以外が記述されている場合は，該当個所を無視して処理します。

EV_USER=JP1ユーザー名

イベントガイドメッセージの表示対象となるJP1ユーザー名を指定します。指定できる文字数は，1〜31バイトです。半角英数字だけを使用できます。英字は大文字・小文字を区別しません。このパラメーターを指定する場合は，DESC_VERSIONに2を指定してください。このパラメーターは，複数指定できません。また，このパラメーターを省略した場合は，すべてのJP1ユーザーを対象ユーザーと仮定し動作します。

JP1/IM - Managerのバージョンが09-50以降の場合に指定できます。JP1ユーザー名とJP1ユーザー名は，一つ以上の空白で区切り，最大100個指定できます。

（例）

EV_USER=jp1user1 jp1user2 jp1user3

EV_COMP=属性名:属性値

このパラメーターは，JP1イベントを比較する属性の数だけ記述します。複数記述した場合は，AND条件になります。例えば，EV_COMPパラメーターを二つ以上指定した場合，すべての条件が成立したときにだけ，イベントガイドメッセージを［イベント詳細］画面に表示します。

EV_COMPパラメーターの属性名にイベントIDを指定する場合には，B.IDとB.IDBASEのどちらかを指定できます。B.IDの場合は属性値を基本部:拡張部の16桁で，B.IDBASEの場合は基本部8桁で記述します。

（例）

EV_COMP=B.ID:00004107:00000000

EV_COMP=B.IDBASE:00004107

なお，EV_COMPに指定できる条件は100件までです。EV_COMPを二つ以上指定する場合の例については，以降の定義例を参照してください。

また，発行元イベントサーバ名（B.SOURCESERVER），送信先イベントサーバ名（B.DESTSERVER），発生元ホスト名（E.JP1_SOURCEHOST）には業務グループ名を使用できません。業務グループ名を指定した場合，ホスト名として扱われます。

属性名

次の属性を指定できます。

・JP1イベントの基本属性：指定する場合「B.属性名」と指定します。

・JP1イベントの拡張属性：指定する場合「E.属性名」と指定します。

なお，登録要因（B.REASON），コードセット（B.CODESET）は指定できません。

属性名に登録時刻（B.TIME）または到着時刻（B.ARRIVEDTIME）を指定した場合はUTC 1970年1月1日00:00:00からの通算ミリ秒で比較を行います。

（例）到着時刻が2013/6/12 10:20:00.000（通算ミリ秒表記で1371000000000）のJP1イベントを指定する場合

EV_COMP=B.TIME:1371000000000

属性値

属性名で指定した属性の内容を正規表現で記述します。正規表現には拡張正規表現を使用します。正規表現の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

デフォルトでは，指定した正規表現とJP1イベントの属性値全体を比較し，完全に一致した場合だけ条件が成立します。

部分一致にしたいときは，次の共通定義情報を定義した任意のファイルを引数にjbssetcnfコマンドを実行したあと，定義を有効にするため，JP1/IM - Managerを再起動してください。定義ファイル作成時にはファイルの終端が最下行の先頭になるようにしてください。

・物理ホストの場合

[JP1_DEFAULT¥JP1CONSOLEMANAGER]

"GUIDE_EV_COMP"="find"

・論理ホストの場合

[論理ホスト名¥JP1CONSOLEMANAGER]

"GUIDE_EV_COMP"="find"

定義内容を完全一致（デフォルト）に戻す場合は，共通定義情報"GUIDE_EV_COMP"の値に"match"を指定してください。

共通定義情報の設定がない場合や，値が不正な場合は"match"を仮定し完全一致で動作します。

なお，この共通定義情報はインストール直後の状態では設定されていません。

発行元IPアドレス（B.SOURCEIPADDR）および送信先IPアドレス（B.DESTIPADDR）にIPv6アドレスを指定する場合，次のように英字部分を英小文字で指定してください。

0011:2233:4455:6677:8899:aabb:ccdd:eeff

また，次のようなIPアドレスの省略形式は指定できません。

2012:7:8::a:b

登録時刻（B.TIME），または到着時刻（B.ARRIVEDTIME）を指定する場合は，UTC 1970-01-01 00:00:00からの秒数をミリ秒で指定してください。

EV_GUIDE=イベントガイドメッセージ

イベントガイドメッセージには，イベントガイドとして表示したい文字列を1行で記述します。指定した文字列は，［イベント詳細］画面のイベントガイド情報が表示される領域（［メッセージ］の下の［ガイド］）に表示されます。

なお，このパラメーターは，[EV_GUIDE_イベントガイド番号]と[END]の間に一つしか記述できません。

EV_GUIDE=イベントガイドメッセージとEV_FILE=イベントガイドメッセージファイル名を同時に指定した場合，EV_FILE=イベントガイドメッセージファイル名の記述が優先されます。

メッセージ中に¥を記述する場合は¥¥，$を記述する場合は¥$と記述します。メッセージに改行を入れる場合は，¥nと記述します。

また，イベントガイドメッセージでは，HTMLタグを使ったり，JP1イベントの属性を変数として記述したりすることもできます。

HTMLタグの記述

HTMLタグを記述すれば，［イベント詳細］画面に表示されるイベントガイドメッセージをHTML形式で表示できます（記述できるHTMLタグはEV_FILEの説明文にある「表2-21　イベントガイドメッセージとして使用できるHTMLタグ」を参照のこと）。

JP1イベントの属性を変数として記述

メッセージ中に「$B.属性名△」，「$E.属性名△」を指定した場合，JP1イベントの属性名に対応する属性値がメッセージとして展開されます（△は半角スペースを表す）。ただし，登録要因（B.REASON），コードセット（B.CODESET）は指定できません。また，対応する属性が存在しない場合は空に置き換えられます。

メッセージ中に指定できる属性名を，次表に一覧で示します。なお，JP1イベントの属性の詳細については，「3.1　JP1イベントの属性」を参照してください。

表2‒18　メッセージ中に指定できる属性名の一覧

JP1イベントの属性

メッセージ中の記述

基本属性

イベントDB内通し番号

B.SEQNO

イベントID

次の2とおり

B.ID

B.IDBASE

発行元プロセスID

B.PROCESSID

登録時刻

B.TIME

到着時刻

B.ARRIVEDTIME

発行元ユーザーID

B.USERID

発行元グループID

B.GROUPID

発行元ユーザー名

B.USERNAME

発行元グループ名

B.GROUPNAME

発行元イベントサーバ名

B.SOURCESERVER

送信先イベントサーバ名

B.DESTSERVER

発行元イベントDB内通し番号

B.SOURCESEQNO

メッセージ

B.MESSAGE

拡張属性

重大度

E.SEVERITY

ユーザー名

E.USER_NAME

プロダクト名

E.PRODUCT_NAME

オブジェクトタイプ

E.OBJECT_TYPE

オブジェクト名

E.OBJECT_NAME

登録名タイプ

E.ROOT_OBJECT_TYPE

登録名

E.ROOT_OBJECT_NAME

オブジェクトID

E.OBJECT_ID

事象種別

E.OCCURRENCE

開始時刻

E.START_TIME

終了時刻

E.END_TIME

終了コード

E.RESULT_CODE

発生元ホスト名

E.JP1_SOURCEHOST

上記以外の拡張属性

E.xxxxxx※

注※

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

イベントガイドメッセージに記述する文字数は196,608文字以内にしてください。196,608文字よりも長く記述した場合，196,609文字以降のメッセージは，［イベント詳細］画面に表示されません。

なお，イベントガイドメッセージは，次の表に示す置き換え文字を指定することで，連携製品のWWWページなどを文字化けすることなく表示できます。

表2‒19　指定できる置き換え文字

指定形式

説明

$B.属性名△

$E.属性名△

属性値をそのまま展開する。

ガイド情報の形式がHTML形式の場合は，HTMLエンコードを行う。

JP1イベントの属性値をイベントガイドメッセージで表示する文章の一部として表示する場合に指定する。

（例）$B.MESSAGE△

$B.属性名$URLENC△

$E.属性名$URLENC△

属性値をUTF-8の文字列としてURLエンコードして展開する。

WWWページアプリケーションの引数（URLパラメーター）としてJP1イベントの属性値をUTF-8の文字列として渡す場合に使用する。

（例）<a href="http://host/page?msg=$B.MESSAGE$URLENC△">

$B.属性名$ENC△

$E.属性名$ENC△

属性値をUTF-8の文字列としてBase64でエンコードして展開する。

JP1イベントの属性値をUTF-8の文字列としてBase64でエンコードした値をイベントガイドメッセージで表示する文章の一部として表示する場合に指定する。

ただし，WWWページアプリケーションの引数（URLパラメーター）として渡す場合は，「$B.属性名$ENC$URLENC△，$E.属性名$ENC$URLENC△」の変数を使用する。

（例）$B.MESSAGE$ENC△

$B.属性名$ENC$URLENC△

$E.属性名$ENC$URLENC△

属性値をUTF-8の文字列としてBase64でエンコード後，さらにURLエンコードして展開する。

WWWページアプリケーションの引数（URLパラメーター）としてJP1イベントの属性値のBase64値を渡す場合に使用する。

（例）<a href="http://host/page?msg=$B.MESSAGE$ENC$URLENC△">

注

$URLENC，または$ENCを指定する場合は，DESC_VERSIONの値に2を指定する必要があります。

EV_FILE=イベントガイドメッセージファイル名

イベントガイドメッセージファイル名には，［イベント詳細］画面に表示されるイベントガイドメッセージの内容を記述したファイルの名称をフルパスで指定します。このパラメーターは，[EV_GUIDE_イベントガイド番号]と[END]の間に一つしか記述できません。なお，イベントガイドメッセージファイル名に何も記述していない場合，次のファイル名を指定したと見なされます。

表2‒20　イベントガイドメッセージファイル名

OS

イベントガイドメッセージファイル名

Windows

Consoleパス¥conf¥guide¥EV_GUIDE_イベントガイド番号.txt

共有フォルダ¥jp1cons¥conf¥guide¥EV_GUIDE_イベントガイド番号.txt

UNIX

/etc/opt/jp1cons/conf/guide/EV_GUIDE_イベントガイド番号.txt

共有ディレクトリ/jp1cons/conf/guide/EV_GUIDE_イベントガイド番号.txt

ファイル名は，パスを含めて1,024文字以内にしてください。1,024文字を超えた場合，JP1/IM - Managerの起動時またはJP1/IM - Viewおよび統合オペレーション・ビューアーからのイベントガイドメッセージファイル呼び出し時にエラーとなります。

ガイドメッセージファイルとして指定できるファイルの名称，拡張子はユーザー任意です。ファイル名称には管理しやすい名称を，拡張子は表示するイベントガイドメッセージがTXT形式であれば.txtを，HTML形式であれば.html，.htmを使用することをお勧めします。

（例）jco_guidemes001_AJS2.txt，またはjco_guidemes001_AJS2.htm

イベントガイドメッセージファイル

イベントガイドメッセージファイルには，［イベント詳細］画面から表示させたい情報をTXT形式またはHTML形式で記述します。記述できる内容は，イベントガイド情報ファイルのEV_GUIDEで記述できる内容と同じです。つまり，HTMLタグを使用したり，JP1イベントの属性を変数として記述したりできます。メッセージ中に¥を記述する場合は¥¥，$を記述する場合は¥$と記述します。メッセージに改行を入れる場合は，¥nと記述します。

なお，1行でメッセージを記載するEV_GUIDEと違い，イベントガイドメッセージファイルの場合，改行を挿入して体裁を整えることができます。

作成したイベントガイドメッセージファイルは，任意のフォルダに格納できます。

イベントガイドメッセージファイルの最大サイズは，1メガバイトです。1メガバイトを超えた場合，JP1/IM - Viewおよび統合オペレーション・ビューアーの［イベント詳細］画面からのイベントガイドメッセージファイル読み込み時にエラーとなります。

HTML形式のイベントガイドメッセージファイルを作成する場合に使用できるHTMLタグおよび属性を次に示します。なお，このほかのHTMLタグについては動作保証していません。

表2‒21　イベントガイドメッセージとして使用できるHTMLタグ

タグ

属性

説明

HTML

−

HTML文章であることを宣言します。このタグは必須です。

HEAD

−

HTML文章のヘッダーを宣言します。

このタグは必須です。

BODY

−

HTML文章の本文を宣言します。

このタグは必須です。

A※1

HREF="URL"

リンク先URLを指定します。※2，※3「http://」，または「https://」で始まるURLが指定できます。

それ以外は動作保証されません。

ここで指定したリンクは［イベント詳細］画面（HTML形式）に表示されます。クリックするとWWWブラウザーが起動し，指定したURLにアクセスできます。エンコードできる文字数は2,083文字までです。

H1，H2，H3，H4，H5，H6

−

見出しを指定します。

FONT

SIZE="文字サイズ"

文字サイズを指定します。指定できる値は1〜7です。

COLOR="文字色"

文字色を指定します。指定できる色は次の16色です。

black，silver，gray，white，maroon，red，purple，fuchsia，green，lime，olive，yellow，navy，blue，teal，aqua

これ以外の文字色は動作保証されません。

B

−

文字を太字にします。

I※4

−

文字を斜体にします。

HR

−

けい線を引きます。

BR

−

強制的に改行します。

（凡例）　−：なし

注※1　AタグのURLの解釈および表示される画面は，WWWブラウザーなどの環境に依存します。

注※2　JP1/Navigation Platformと連携する場合のURLを次に記述します。

【記述例】

http://hostA:8080/ucnpBase/portal/screen/Home/action/PLoginUser?contentId=f24077e7-0136-1000-8000-00000ad20b6f-0

JP1/Navigation Platformとの連携については，JP1/Navigation PlatformのマニュアルのJP1製品からナビゲーションプラットフォームを呼び出すためのURLについて説明されている個所を参照してください。

注※3　JP1/AJSと連携する場合のURLについては，JP1/AJSのマニュアルを参照してください。

注※4　統合オペレーション・ビューアーの場合，日本語にIタグを指定しても斜体になりません。

[END]

イベントガイド情報の終了タグです。小文字，大文字の区別はしません。

定義例

# JP1/IM-CC Guide Information File.

DESC_VERSION=1
[EV_GUIDE_001]
EV_COMP=B.ID:00004107:00000000
EV_COMP=E.SEVERITY:Error
EV_GUIDE=ジョブが異常終了しました。¥n$E.C0 のホストで異常が発生していないか確認してください。
[END]

システムカラー定義ファイル（systemColor.conf）

形式

DESC_VERSION=ファイルバージョン

# コメント行
[DEFAULT.BackgroundColor=カラー]
[DEFAULT.TextColor=カラー]

[SEVERITY.重大度.BackgroundColor=カラー]
[SEVERITY.重大度.TextColor=カラー]
：

ファイル

systemColor.conf（システムカラー定義ファイル）

systemColor.conf.model（システムカラー定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥profile

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥profile

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/profile

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/profile

説明

［イベントコンソール］画面の［イベント監視］ページ，［重要イベント］ページ，および［イベント検索］ページでのカラーリングを定義するファイルです。

ファイルの権限

Windowsの場合

AdministratorsグループおよびSYSTEMユーザーが参照できる必要があります。

UNIXの場合

root権限を持つユーザーが参照できる必要があります。

定義の反映時期

［ユーザー環境設定］画面の［カラーリング］項目の［有効］チェックボックスをチェックすると，システムカラー定義ファイルの設定内容に従ってイベント一覧のイベントがカラーリングされます。

JP1/IM - Viewはログイン時のシステムカラー定義ファイルの設定内容に従ってカラーリングを行います。

ログイン中にシステムカラー定義ファイルの設定内容を変更した場合は，JP1/IM - Viewを再起動することで設定内容を有効にできます。

記述内容

DESC_VERSION=ファイルバージョン

システムカラー定義ファイルの形式のバージョンを表しています。指定する値は1です。省略した場合や1以外の数値を指定した場合は，1が仮定されます。

#コメント行

#で始まる行は，コメント扱いとなります。

[DEFAULT.BackgroundColor=カラー]

デフォルトの背景色を指定します。重大度の背景色の指定がない，または重大度の背景色の指定に一致しないJP1イベントは，このパラメーターで指定した背景色となります。このパラメーターは省略できます。背景色はカラー名またはRGB値で指定します。カラー名とRGB値の対応を次に示します。

カラー名

RGB値

black

0,0,0

blue

0,0,255

cyan

0,255,255

darkGray

64,64,64

gray

128,128,128

green

0,255,0

lightGray

192,192,192

magenta

255,0,255

orange

255,200,0

pink

255,175,175

red

255,0,0

white

255,255,255

yellow

255,255,0

カラー名は，大文字・小文字を区別しません。

指定できるRGB値の範囲は，0〜255です。デフォルトはwhite（255,255,255）です。RGB値は「,」（半角コンマ）で区切ります。

[DEFAULT.TextColor=カラー]

文字の色が指定されていない重大度の文字の色を指定します。このパラメーターは省略できます。カラー名，RGB値およびRGB値の範囲は，DEFAULT.BackgroundColor=カラーと同じです。カラー名は，大文字・小文字を区別しません。

デフォルトはblack（0,0,0）です。

[SEVERITY.重大度.BackgroundColor=カラー]

重大度の背景色を指定します。このパラメーターは省略できます。カラー名，RGB値およびRGB値の範囲は，DEFAULT.BackgroundColor=カラーと同じです。カラー名は，大文字・小文字を区別しません。

指定できる重大度は，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）です。重大度は，大文字・小文字を区別します。

[SEVERITY.重大度.TextColor=カラー]

重大度の文字の色を指定します。このパラメーターは省略できます。カラー名，RGB値およびRGB値の範囲は，DEFAULT.BackgroundColor=カラーと同じです。カラー名は，大文字・小文字を区別しません。

指定できる重大度は，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）です。重大度は，大文字・小文字を区別します。

定義例

DESC_VERSION=1

DEFAULT.TextColor=black
DEFAULT.BackgroundColor=white

SEVERITY.Emergency.TextColor=white
SEVERITY.Emergency.BackgroundColor=red

SEVERITY.Alert.TextColor=white
SEVERITY.Alert.BackgroundColor=red

SEVERITY.Critical.TextColor=white
SEVERITY.Critical.BackgroundColor=red

SEVERITY.Error.TextColor=white
SEVERITY.Error.BackgroundColor=255,128,0

SEVERITY.Warning.TextColor=black
SEVERITY.Warning.BackgroundColor=yellow

イベント拡張属性定義ファイル

形式

@encode 文字コード
@file type="定義ファイルタイプ", version="定義フォーマットバージョン";
@product name="プロダクト名";
@define-block type="event-attr-def";
block lang = "言語種別", platform="プラットフォーム種別"
attr name="属性名", title="表示項目名"[, type="属性表示タイプ"];
・・・
@define-block-end;
@define-block type="event-attr-group-def";
block platform="プラットフォーム種別"
group name="グループ名", attrs="属性名並び";
・・・
@define-block-end;
@define-block type="event-attr-order-def";
block platform="プラットフォーム種別"
order id="イベントID定義文字列", attrs="属性名並び";
・・・
@define-block-end;

ファイル

イベント拡張属性定義ファイルの拡張子は.conf（小文字）としてください。

default.conf（デフォルトのイベント拡張属性定義ファイル）

hitachi_xxxx.conf（連携製品のイベント拡張属性定義ファイル）

会社名_製品名_attr.conf（ユーザー定義のイベント拡張属性定義ファイル）

なお，「製品名」は，「シリーズ名_製品名」とすることもできます。JP1イベント発行時の「PRODUCT_NAME」に指定する値の「/」を「_」に変更してファイル名に使用することをお勧めします。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥attribute¥

論理ホストのとき

共有フォルダ¥JP1Cons¥conf¥console¥attribute¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/attribute/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/attribute/

説明

イベント拡張属性定義ファイルは，［イベント詳細］画面に表示するイベント属性の並び順や表示する属性名を定義します。

イベント拡張属性定義ファイルには，次の4種類のファイルがあります。

表2‒22　イベント拡張属性定義ファイルの種類

項番

種類

説明

1

標準ファイル

すべてのイベントに共通の基本属性，および拡張属性の共通情報に対するイベント詳細情報定義

2

拡張ファイル

固有の拡張属性を指定する定義

3

連携製品提供ファイル

JP1イベントを発行する連携製品の拡張属性の固有情報定義

4

ユーザー定義ファイル

ユーザー定義の拡張属性の固有情報

上記表の項番1と項番3の2種類のファイルは，JP1/IMの定義ファイル格納先ディレクトリに格納されています。JP1/IM - Managerがインストール時に作成するこの2種類のファイルは，システム標準の定義情報であり，ユーザーによる追加・変更・削除はできません。

新たにJP1イベントに対する拡張属性の固有情報を追加する場合，ユーザーは，項番2と項番4の定義ファイルを作成し，格納先ディレクトリに格納します。

項番2の詳細については，「イベント拡張属性定義ファイル（拡張ファイル）」（2.　定義ファイル）を参照してください。

作成契機

イベント拡張属性定義ファイルの作成契機を次に示します。

項番

ファイル

作成契機

1

default.conf

JP1/IM - Manager インストール時に作成する。

2

hitachi_xxxx.conf

JP1/IM - Manager インストール時に作成する。

3

会社名_製品名_attr.conf

ユーザーが追加して個別に作成する。

定義の反映時期

次のどちらかが成立する場合に，イベント拡張属性定義ファイルの記述内容を反映します。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドを実行した場合

記述内容

イベント拡張属性定義ファイルは，JP1/IM - View および統合オペレーション・ビューアーの［イベント詳細］画面に表示するイベント属性の並び順や表示する属性名を定義します。

イベント拡張属性定義ファイルには，次の3種類のファイルがあります。

すべてのイベントに共通の基本属性，および拡張属性の共通情報に対するイベント詳細情報定義（標準提供：default.conf）

JP1イベントを発行する連携製品の拡張属性の固有情報定義（標準提供：hitachi_xxxx.conf）

ユーザー定義の拡張属性の固有情報（ユーザーが個別作成）

JP1/IM - Managerがインストール時に作成するイベント拡張属性定義ファイルは，システム標準定義情報であるため，ユーザーによる追加，変更，削除はできません。

新たにJP1イベントに対する拡張属性の固有情報を追加する場合は，この定義ファイル格納ディレクトリに「表2-2　定義ファイルの命名規則」の名称基準に従って作成した定義ファイルを格納してください。

この定義ファイルを作成する場合，次のことに注意してください。

Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCコードで定義する必要があります。

定義ファイルに誤って基本属性や拡張属性の共通情報を定義した場合，属性（属性名，項目名，属性表示タイプ）が重複していると次のように表示されます。

属性名だけ，または項目名だけが重複している場合：それぞれの定義ファイルに定義された属性名および項目名が表示されます。

すべての属性が重複している場合：イベント拡張属性定義ファイルの標準ファイル（default.conf）の指定を無視します。

なお，JP1/IMには，イベント拡張属性定義ファイルの記述内容をチェックするためのコマンド「jcoattrfcheck」が用意されています。このコマンドの詳細については，「jcoattrfcheck」（1.　コマンド）を参照してください。

イベント拡張属性定義ファイルには，次のステートメントとブロックを記述できます。

表2‒23　イベント拡張属性定義ファイルに記述できるステートメントおよびブロック

ステートメントまたはブロック

意味

@encodeステートメント

定義ファイルで使用している文字コードを指定する

@fileステートメント

定義ファイルタイプおよびバージョンを宣言する

@productステートメント

定義中のプログラム情報を宣言する

イベント拡張属性定義ブロック

イベント属性の表示について定義する

属性グループ定義ブロック

イベント属性のグループを定義する

属性表示順序定義ブロック

［イベント詳細］画面表示時の順序をIDごとに定義する

記述内容（文字コードの指定）

@encode

イベント拡張属性定義ファイルで使用する文字コードを指定します。

イベント拡張属性定義ファイルを追加で作成する場合は，@encodeステートメントで定義ファイルの文字コードを指定してください。

項目名には，@encodeステートメントに指定した文字コードで表現できる文字を記載します。また，イベント拡張属性定義ファイルは，@encodeステートメントに指定した文字コードで保存します。

次の場合，JP1/IM - Viewおよび統合オペレーション・ビューアーに表示される項目名が文字化けすることがあります。

項目名に，@encodeステートメントに指定した文字コードで表現できない文字を使用した場合

@encodeステートメントに指定した文字コード，ファイルを保存した文字コード，および@encodeステートメントに指定した文字コードが不一致の場合

@encodeステートメントが存在しない場合，および@encodeステートメントのあとに指定した文字コードに誤りがある場合は，文字コードが自動判別されます。ただし，定義ファイルの内容によっては正しく判別できないおそれがあります。

指定できる文字コードは次のとおりです。

C

EUCJIS

SJIS

UTF-8

GB18030

注意事項

定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

次の場合，エラーが出力されます。

C，EUCJIS，SJIS，UTF-8，およびGB18030以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

注意事項

他製品から提供されたイベント拡張属性定義ファイルを使用する場合，定義ファイルで使用されている文字コードと，@encodeステートメントに指定する文字コードが一致していることを確認してください。また，定義ファイルを転送して配置する際は，定義ファイルの文字コードを変換しないようにしてください。

記述内容（ファイル内ステートメントの生成規則）

@fileステートメント

この定義ファイルがイベント拡張属性定義ファイルであること，および定義記述フォーマットのバージョンが0300であることを宣言します。このステートメントは必須です。

なお，このステートメントは，ファイルの先頭行または@encodeの次の行に記述しなければなりません。記述しない場合，動作は保証できません。

構文

@file type="extended-attributes-definition", version="0300";

@productステートメント

ファイル内で定義する各ステートメントのプロダクト情報を定義します。

なお，定義する際には次の内容に注意してください。

指定値は，JP1イベントの拡張属性「PRODUCT_NAME」と一致させる必要があります。記述しない場合，動作は保証できません。

解析処理では，使用禁止文字や形式はチェックされません。指定した文字列がそのまま使用されます。

構文

@product name="プロダクト名";

name="プロダクト名"

プロダクト名は，スラントで区切られた半角英数字列です。次のどちらかの形式になります。

/会社名/シリーズ名/プロダクト名

/会社名/プロダクト名

定義例

定義情報ヘッダー用ステートメントの定義例を次に示します。

@file type="extended-attributes-definition", version="0300";
@product name="/HITACHI/JP1/CentralConsole";
@define-block type="event-attr-def";
block lang="Japanese", platform="NT";
attr name="E.SAMPLE_TIME", title="サンプル時刻";
attr name="E.SAMPLE_HOST", title="サンプルホスト";
attr name="E.SAMPLE_USER", title="サンプルユーザー";
@define-block-end;

記述内容（イベント拡張属性定義ファイルのブロックの生成規則）

イベント拡張属性定義ファイルに記述できるブロックについて説明します。なお，それぞれのブロックに記述できるステートメント以外のステートメントを記述した場合は，エラー出力され，該当するステートメントだけが無視されます。

イベント拡張属性定義ブロック

［イベント詳細］画面で，イベント属性名とその表示項目名（日本語名，英語名，中国語名）を関連づけます。このブロックは，定義ファイル内に複数個記述できます。ただし，ブロックのキーとなる属性（後述のblockステートメントの指定値）が同じブロックは，複数個記述できません。

なお，複数の言語を指定する場合は，後述のattrステートメントの属性名が指定した言語のすべてに対応している必要があります。

記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

・blockステートメント

・attrステートメント

属性グループ定義ブロック

イベント拡張属性定義ブロックで定義したイベント属性をグループ化します。グループ化することにより，属性表示順序定義ブロック内のorderステートメントで属性を何度も定義する必要がなくなります。

このブロックは省略できます。

記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

・blockステートメント

・groupステートメント

属性表示順序定義ブロック

イベント単位でそのイベントが詳細表示されたときに表示するイベント属性の順序や属性の表示名の順序を定義します。

記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

・blockステートメント

・orderステートメント

記述内容（イベント拡張属性定義ブロック内のステートメント生成規則）

blockステートメント

ブロックの属性を定義します。このステートメントは，ブロックの先頭に1回だけ記述できます。

構文

block lang=言語種別, platform=プラットフォーム種別;

lang=言語種別

イベント拡張属性定義ブロックの言語種別を宣言します。指定できる言語種別を次に示します。

・"Japanese"

日本語環境時の定義であることを示します。

・"English"

英語環境時の定義であることを示します。

・"Chinese"

中国語環境時の定義であることを示します。

platform=プラットフォーム種別

ブロック内の定義が有効になるプラットフォームを指定します。

定義できるプラットフォームを次に示します。

・"base"

すべてのプラットフォームで有効にする場合に使用します。

platformパラメーターに「"base"」を指定する場合は，「,extended="false"」を記述する必要があります。

・"ユーザー定義"

ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象になります。したがって，ここに指定するプラットフォーム名と同一の文字列がJP1イベントの拡張属性「PLATFORM」にない場合は，処理の対象になりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

定義例

次の「attrステートメント」の定義例を参照してください。

attrステートメント

［イベント詳細］画面の属性名欄に表示する項目名と，属性値のタイプを指定します。このステートメントはブロック内に複数個指定できます。

なお，このステートメントで定義するのは，基本属性，および拡張属性の共通情報を除いた拡張属性の固有情報だけです。拡張属性の固有情報以外が指定された場合，エラーは出力されないで処理が続行されますが，表示時には標準提供の定義と重複して表示されます。標準提供の定義については，次の「定義例」を参照してください。

構文

attr name=属性名, title=表示項目名[,type="elapsed_time/

date_format:CLIENT"];

name=属性名

属性名を定義します。

表示可能な属性の一覧を次に示します。

項番

指定形式

属性の内容

1

"B.SEQNO"

イベントDB内通し番号

2

"B.IDBASE"

イベントID

3

"B.PROCESSID"

発行元プロセスID

4

"B.TIME"

登録時刻

5

"B.ARRIVEDTIME"

到着時刻

6

"B.USERID"

発行元ユーザーID

7

"B.GROUPID"

発行元グループID

8

"B.USERNAME"

発行元ユーザー名

9

"B.GROUPNAME"

発行元グループ名

10

"B.SOURCESERVER"

発行元イベントサーバ名

11

"B.DESTSERVER"

送信先イベントサーバ名

12

"B.SOURCESEQNO"

発行元イベントDB内通し番号

13

"B.MESSAGE"

メッセージ

14

"B.SOURCEIPADDR"

発行元IPアドレス

15

"E.拡張属性名"

拡張属性

title=表示項目名

［イベント詳細］画面表示時の属性名欄に表示する文字列を指定します。その際には，blockステートメントで指定した言語種別が使用されます。指定文字列に半角仮名を含めることはできません。

type="elapsed_time/date_format:CLIENT"

属性値のタイプと表示形式を指定します。属性値「elapsed_time」は，UTC 1970年1月1日00:00:00からの経過秒数を10進文字列で表記した値です。表示形式「date_format:CLIENT」は，表示するビューアーのローカルタイムゾーンで指定された時刻を使用して，時刻形式で書式化して表示することを示します。

定義例

JP1イベントの拡張属性の固有情報定義例を示します。プラットフォームが"W2K"で次の表の四つの拡張属性（固有情報）を表示させたい場合の「イベント拡張属性定義ブロック」の定義例を示します。

表2‒24　イベント拡張属性定義ブロックの定義例

画面表示名

拡張属性名(固有情報)

SAMPLE共通属性1

COMMON_ATTR1

SAMPLE共通属性2

COMMON_ATTR2

SAMPLE開始属性1

START_ATTR1

SAMPLE開始属性2

START_ATTR2

@define-block type="event-attr-def";
block lang="Japanese", platform="w2k";
attr name="E.COMMON_ATTR1",    title="SAMPLE共通属性1";
attr name="E.COMMON_ATTR2",    title="SAMPLE共通属性2";
attr name="E.START_ATTR1",     title="SAMPLE開始属性1";
attr name="E.START_ATTR2",     title="SAMPLE開始属性2";
@define-block-end;

記述内容（属性グループ定義ブロック内のステートメント生成規則）

blockステートメント

ブロックの属性を定義します。このステートメントは，ブロックの先頭に1回だけ記述できます。

なお，定義する際には次の内容に注意してください。

このブロックにはlangパラメーターは使用できません。

構文

block platform=プラットフォーム種別;

platform=プラットフォーム種別

ブロック内の定義が有効になるプラットフォームを指定します。指定できる値を次に示します。

指定できる値

説明

"base"

すべてのプラットフォームで有効にする場合に使用します。

platformパラメーターに「"base"」を指定する場合は，「,extended="false"」を記述する必要があります。

"ユーザー定義"

ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象となります。したがって，ここに指定するプラットフォーム名と同一の文字列がイベントの拡張属性「PLATFORM」にない場合は，処理の対象となりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

定義例

次の「groupステートメント」の定義例を参照してください。

groupステートメント

［イベント詳細］画面上に表示する属性の並び順に名称を付けてグループ化します。このステートメントはブロック内に複数個指定できます。

構文

group name=グループ名, attrs=属性名並び;

name=グループ名

属性名並びに付ける名称を指定します。名称は，32バイト以内の半角英数字で指定します。大文字と小文字は区別されません。ここで付けた名称は，定義ファイル内のorderブロック中で使用できます。

attrs=属性名並び

グループ化する属性を一つ以上並べて指定します。複数個並べた場合は，［イベント詳細］画面に上からその順序で表示されます。指定形式は次のとおりです。

・一つの場合：attrs="E.A0"

・複数の場合：attrs="E.A0|E.A1"

なお，指定できる属性は拡張属性の固有情報だけです。基本属性または拡張属性の共通情報を指定した場合は，指定した属性値が［イベント詳細］画面上に複数個表示されます。

定義例

JP1イベントの基本属性および拡張属性の共通情報の定義を示します。これらの定義は，イベント拡張属性定義ファイルに標準で提供されています。

@define-block type="event-attr-group-def";
block platform="base", extended="false";
group name="BASE",   attrs="B.GROUPID|B.GROUPNAME|B.IDBASE|B.PROCESSID|B.SEQNO|B.SOURCEIPADDR|
B.SOURCESEQNO|B.SOURCESERVER|B.TIME|B.USERID|B.USERNAME|B.ARRIVEDTIME";
group name="COMMON", attrs="E.SEVERITY|E.USER_NAME|E.PRODUCT_NAME|E.OBJECT_TYPE|E.OBJECT_NAME|
E.ROOT_OBJECT_TYPE|E.ROOT_OBJECT_NAME|E.OBJECT_ID|E.OCCURRENCE|
E.START_TIME|E.END_TIME|E.RESULT_CODE";
@define-block-end;

記述内容（属性表示順序定義ブロック内のステートメント生成規則）

blockステートメント

属性表示順序定義ブロックに依存するブロック属性を定義します。このステートメントは，ブロックの先頭に1回だけ記述できます。

なお，定義する際には次の内容に注意してください。

このブロックではlangパラメーターは使用できません。

構文

block platform=プラットフォーム種別;

platform=プラットフォーム種別

ブロック内の定義が有効になるプラットフォームを指定します。定義できるプラットフォームを次に示します。

表2‒25　指定できるプラットフォーム

指定できる値

説明

"base"

すべてのプラットフォームで有効にする場合に使用します。

platformパラメーターに「"base"」を指定する場合は，「,extended="false"」を記述する必要があります。

"ユーザー定義"

ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象となります。したがって，ここに指定するプラットフォーム名と同一の文字列がイベントの拡張属性「PLATFORM」にない場合は，処理の対象となりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

定義例

次の「orderステートメント」の定義例を参照してください。

orderステートメント

［イベント詳細］画面上に表示する属性とその並び順をIDごとに定義します。このステートメントはブロック内に複数個指定できます。

構文

order id=イベントID定義文字列, attrs=属性名並び;

id=イベントID定義文字列

attrsパラメーターで指定した順序で属性を表示するイベントIDを一つ指定します。

指定形式は次のとおりです。

id="200"

イベントIDは，8けた以内の16進数文字列で指定します。8けた未満の場合，先頭に0を補って8けたにする必要はありません。16進数文字列の英字（a〜f）は，大文字と小文字のどちらでもかまいません。

IDの範囲指定はできません。

attrs=属性名並び

表示する属性，グループ，またはその両方が混在したものを並べて指定します。複数個並べた場合は，［イベント詳細］画面に上からその順序で表示されます。

指定形式は次のとおりです。

・一つの場合：attrs="E.A0"

・複数の場合：attrs="E.A0|E.A1|GROUP1"

groupステートメントの場合と同様に，指定できる属性は固有の拡張属性だけです。基本属性または共通の拡張属性を指定した場合は，指定した属性値が［イベント詳細］画面上に複数個表示されます。

定義例

イベントIDが00001000の場合にBASEグループとCOMMONグループを表示する定義例を次に示します。

@define-block type="event-attr-order-def";
block platform="base", extended="false";
order id=00001000, attrs="BASE|COMMON"
@define-block-end;

イベント拡張属性定義ファイルの定義例

@encode UTF-8
@file type="extended-attributes-definition",version="0300";
@product name="/HITACHI/JP1/SAMPLE";
@define-block type="event-attr-def";
block platform="base", lang="Japanese", extended="false";
attr name="E.SAMPLE_CLUSTER_NAME", title="クラスタ名";
attr name="E.SAMPLE_PRINT_SERVER_NAME", title="プリントサーバ名";
attr name="E.SAMPLE_PRINTER_NAME", title="プリンタ名";
attr name="E.SAMPLE_PORT_NAME", title="ポート名";
@define-block-end;
@define-block type="event-attr-group-def";
block platform="base", extended="false";
group name="_PRINTER_INFO",
attrs="E.SAMPLE_PRINT_SERVER_NAME|E.SAMPLE_PRINTER_NAME";
group name="_CLUSTER_INFO", attrs="E.SAMPLE_CLUSTER_NAME|E.SAMPLE_PORT_NAME";
@define-block-end;
@define-block type="event-attr-order-def";
block platform="base", extended="false";
order id="00003100",attrs="_PRINTER_INFO";
order id="00003101",attrs="_CLUSTER_INFO";
order id="00003102", attrs="_PRINTER_INFO|_CLUSTER_INFO";

@define-block-end;

標準提供されているイベント拡張属性定義ファイル

JP1イベントの基本属性および拡張属性の共通情報の定義を次に示します。これらの定義は，イベント拡張属性定義ファイルとして標準提供されています。

@define-block type="event-attr-def";
block lang="Japanese", platform="base", extended="false";
attr name="B.SEQNO",            title="イベントDB内通し番号";
attr name="B.IDBASE",           title="イベントID";
attr name="B.PROCESSID",        title="発行元プロセスID";
attr name="B.TIME",             title="登録時刻", type="elapsed_time_in_milli/date_format:CLIENT";
attr name="B.ARRIVEDTIME",      title="到着時間", type="elapsed_time_in_milli/date_format:CLIENT";
attr name="B.USERID",           title="発行元ユーザーID";
attr name="B.GROUPID",          title="発行元グループID";
attr name="B.USERNAME",         title="発行元ユーザー名";
attr name="B.GROUPNAME",        title="発行元グループ名";
attr name="E.JP1_SOURCEHOST",   title="発生元ホスト名";
attr name="B.SOURCESERVER",     title="発行元イベントサーバ名";
attr name="B.SOURCEIPADDR",     title="発行元IPアドレス";
attr name="B.SOURCESEQNO",      title="発行元イベントDB内通し番号";
attr name="E.SEVERITY",         title="重大度";
attr name="E.USER_NAME",        title="ユーザー名";
attr name="E.PRODUCT_NAME",     title="プロダクト名";
attr name="E.OBJECT_TYPE",      title="オブジェクトタイプ";
attr name="E.OBJECT_NAME",      title="オブジェクト名";
attr name="E.ROOT_OBJECT_TYPE", title="登録名タイプ";
attr name="E.ROOT_OBJECT_NAME", title="登録名";
attr name="E.OBJECT_ID",        title="オブジェクトID";
attr name="E.OCCURRENCE",       title="事象種別";
attr name="E.START_TIME",       title="開始時刻", type="elapsed_time/date_format:CLIENT";
attr name="E.END_TIME",         title="終了時刻",type="elapsed_time/date_format:CLIENT";
attr name="E.RESULT_CODE",      title="終了コード";
attr name="E.JP1_GENERATE_SOURCE_SEQNO", title="関連イベントDB内通し番号";
attr name="E.JP1_GENERATE_NAME",         title="相関イベント発行条件名";
attr name="E.@JP1IM_ORIGINAL_SEVERITY",  title="重大度(変更前)";
attr name="E.JP1_IMSUPPRESS_ID",   title="監視抑止ID";
attr name="E.JP1_IMSUPPRESS_NAME", title="繰り返しイベント条件名";
attr name="E.JP1_TRAP_ID",      title="監視ID";
attr name="E.JP1_TRAP_NAME",    title="監視名";
attr name="E.@JP1IM_CHANGE_MESSAGE_NAME",    title="表示メッセージ変更定義名";
attr name="E.JP1_IMCOMEXCLUDE_ID",   title="共通除外条件群ID";
attr name="E.JP1_IMCOMEXCLUDE_NAME", title="共通除外条件群名";
attr name="E.JP1_IMCOMEXCLUDE_TARGET", title="共通除外条件群除外対象";
@define-block-end;

イベント拡張属性定義ファイル（拡張ファイル）

形式

[@encode 文字コード]
@file type="extended-attributes-definition", version="0300";
@define-block type="event-attr-def";
attr name="属性名", title="項目名";
・・・
@define-block-end;

ファイル

template_extend_attr_ja.conf（日本語の拡張ファイル）

template_extend_attr_ja.conf.model（日本語の拡張ファイルのモデルファイル）

template_extend_attr_en.conf（英語の拡張ファイル）

template_extend_attr_en.conf.model（英語の拡張ファイルのモデルファイル）

template_extend_attr_zh.conf（中国語の拡張ファイル）

template_extend_attr_zh.conf.model（中国語の拡張ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥attribute¥extend

論理ホストのとき

共有フォルダ¥JP1Cons¥conf¥console¥attribute¥extend

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/attribute/extend

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/attribute/extend

説明

イベント拡張属性定義ファイル（拡張ファイル）は，項目名でJP1/IM - Viewおよび統合オペレーション・ビューアーの画面に表示したり，項目名でイベントレポート出力したりする固有の拡張属性を定義します。

JP1/IM - Managerに同梱する定義ファイルは，ファイル名の先頭に「template_」が付いています。「extend_attr_ja.conf」のようにリネームしてから設定してください。

拡張ファイル以外のイベント拡張属性定義ファイルの詳細については，「イベント拡張属性定義ファイル」（2.　定義ファイル）を参照してください。

作成契機

JP1/IM - Managerインストール時に作成します。

定義の反映時期

次のどちらかが成立する場合に，イベント拡張属性定義ファイル（拡張ファイル）の記述内容を反映します。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドを実行した場合

なお，JP1/IM - Viewまたは統合オペレーション・ビューアーに接続中に定義を反映した場合は，JP1/IM - Viewまたは統合オペレーション・ビューアーの再起動が必要です。

記述内容

イベント拡張属性定義ファイル（拡張ファイル）は，項目名で画面に表示したり，項目名でイベントレポート出力したりする固有の拡張属性を定義します。拡張ファイルはJP1/IM - Managerの定義ファイルで，JP1/IM - Managerの動作言語ごとに定義します。

複数の言語の拡張ファイルをJP1/IM - Managerに配置する場合は，すべての拡張ファイルに指定する属性名を一致させる必要があります。JP1/IM - Viewおよび統合オペレーション・ビューアーに表示する属性はシステム全体で一意に決まるため，JP1/IM - Viewおよび統合オペレーション・ビューアーの言語ごとに異なる属性は表示できません。

すべての拡張ファイルに指定した属性名に不一致がある場合は，jcoattrfcheckコマンドで拡張ファイルをチェックした際，KAVB5820-Wの警告メッセージを出力します。また，拡張ファイルに指定していない属性がJP1/IM - Viewまたは統合オペレーション・ビューアーに表示される場合があります。例えば，英語の拡張ファイルにだけ「E.SYSTEM」という属性名を指定している場合，日本語や中国語のJP1/IM - Viewにも「E.SYSTEM」が表示されます。このとき，日本語や中国語のJP1/IM - Viewに表示される「E.SYSTEM」の項目名は，属性名と同じ「E.SYSTEM」となります。

なお，JP1/IMには，イベント拡張属性定義ファイル（拡張ファイル）の記述内容をチェックするためのコマンド「jcoattrfcheck」が用意されています。このコマンドの詳細については，「jcoattrfcheck」（1.　コマンド）を参照してください。

イベント拡張属性定義ファイル（拡張ファイル）には，次のステートメントとブロックを記述できます。

表2‒26　イベント拡張属性定義ファイル（拡張ファイル）に記述できるステートメントおよびブロック

ステートメントまたはブロック

意味

@encodeステートメント

定義ファイルで使用している文字コードを指定する

@fileステートメント

定義ファイルタイプおよびバージョンを宣言する

イベント拡張属性定義ブロック

イベント属性の表示について定義する

表に示したステートメントおよびブロック以外を記述した場合は，記述内容は無視されます。また，イベント拡張属性定義ファイル（拡張ファイル）の記述に誤りがある場合は，誤りのある行を無視して有効な行だけで動作します。ただし，blockステートメント（block lang="";）のように，拡張ファイル以外のイベント拡張属性定義ファイルでは読み込むが，イベント拡張属性定義ファイル（拡張ファイル）では読み込まない定義の記述があり，それが不正だった場合はエラーとなります。拡張ファイル以外のイベント拡張属性定義ファイルの詳細については，「イベント拡張属性定義ファイル」（2.　定義ファイル）を参照してください。

記述内容（文字コードの指定）

@encode

イベント拡張属性定義ファイル（拡張ファイル）で使用する文字コードを指定します。

項目名には，@encodeステートメントに指定した文字コードで表現できる文字を記載します。また，イベント拡張属性定義ファイル（拡張ファイル）は，@encodeステートメントに指定した文字コードで保存します。

次の場合，JP1/IM - Viewおよび統合オペレーション・ビューアーに表示される項目名が文字化けすることがあります。

項目名に，@encodeステートメントに指定した文字コードで表現できない文字を使用した場合

@encodeステートメントに指定した文字コード，ファイルを保存した文字コード，および@encodeステートメントに指定した文字コードが不一致の場合

@encodeステートメントがない場合，および@encodeステートメントのあとに指定した文字コードに誤りがある場合は，文字コードが自動判別されます。ただし，定義ファイルの内容によっては正しく判別できないおそれがあります。

指定できる文字コードは次のとおりです。

表2‒27　指定できる定義ファイルの文字コード

項番

ファイルの文字コード

指定可否

Linux以外

Linux

1

C

○

○

2

EUCJIS

○

×

3

SJIS

○

○※

4

UTF-8

○

○

5

GB18030

○

○

（凡例）

○：指定できる

×：指定できない

注※

SUSE Linuxの場合だけ指定できます。

注意事項

定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

次の場合，エラーが出力されます。

C，EUCJIS，SJIS，UTF-8，およびGB18030以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

記述内容（ファイル内ステートメントの生成規則）

@fileステートメント

この定義ファイルがイベント拡張属性定義ファイル（拡張ファイル）であること，および定義記述フォーマットのバージョンが0300であることを宣言します。このステートメントは必須です。

なお，このステートメントは，ファイルの先頭行に記述しなければなりません。記述しない場合，動作は保証できません。

構文

@file type="extended-attributes-definition", version="0300";

記述内容（イベント拡張属性定義ファイルのブロックの生成規則）

イベント拡張属性定義ファイル（拡張ファイル）に記述できるブロックについて説明します。なお，それぞれのブロックに記述できるステートメント以外のステートメントを記述した場合は，エラー出力され，該当するステートメントだけが無視されます。

イベント拡張属性定義ブロック

イベント属性の属性名とその表示項目名を関連づけます。このブロックは，定義ファイル内に一つだけ記述できます。イベント拡張属性定義ブロックを複数記述した場合，エラーや警告は出力されず，二つ目以降のイベント拡張属性定義ブロックは無視されます。

記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

・attrステートメント

記述内容（イベント拡張属性定義ブロック内のステートメント生成規則）

attrステートメント

項目名で画面に表示したり，項目名でイベントレポート出力したりする固有の拡張属性の属性名と，属性名に対応する項目名を指定します。このステートメントはブロック内に100個まで指定できます。100個を超えるattrステートメントを指定した場合は，jcoattrfcheckコマンドでのチェック時にKAVB5803-Wのメッセージが出力されます。

構文

attr name=属性名, title=項目名;

name=属性名

拡張属性名を定義します。値の形式は次のとおりです。

"E.拡張属性名"

属性名は，先頭が英大文字で英大文字，数字，およびアンダーバー（_）から構成される32バイトまでの名称を指定できます。

32バイトを超える拡張属性名を指定した場合は，jcoattrfcheckコマンドでのチェック時やjcoevtreportコマンドの実行時にKAVB5803-Wのメッセージが出力されます。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wのメッセージが出力されます。

指定できる属性は固有の拡張属性だけです。ただし，発生元ホスト名（E.JP1_SOURCEHOST）や監視名（E.JP1_TRAP_NAME）など，イベント拡張属性定義ファイルの標準ファイル（default.conf）に指定した拡張属性と重複する属性は指定できません。イベント拡張属性定義ファイルの標準ファイル（default.conf）と重複する拡張属性を指定した場合は，標準ファイルに指定した項目名が適用されます。

なお，イベント拡張属性定義ファイルの標準ファイル（default.conf）と重複する拡張属性を指定した場合，jcoevtreportコマンドの実行時やjcoattrfcheckコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5802-W※のメッセージが出力されます。jcoevtreportコマンドは，イベント拡張属性定義ファイル（拡張ファイル）に指定された重複する属性を無視して動作します。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wメッセージが出力されます。JP1/IM - Managerは，イベント拡張属性定義ファイル（拡張ファイル）に指定された重複する属性を無視して動作します。

基本属性（B.属性名）やIM属性（E.@属性名）など，拡張属性（E.属性名）以外を指定した場合は，jcoevtreportコマンドの実行時やjcoattrfcheckコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5821-W※のメッセージが出力されます。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wメッセージが出力されます。

注※　KAVB5802-WまたはKAVB5821-Wのメッセージが出力されていても，jcoevtreportコマンドでレポート出力に成功した場合，およびjcoattrfcheckコマンドで定義ファイルのチェックが完了した場合は，各コマンドの戻り値は0（正常終了）になります。

複数の言語の拡張ファイルをJP1/IM - Managerに配置する場合は，すべてのイベント拡張属性定義ファイル（拡張ファイル）に指定する属性名を一致させる必要があります。すべてのイベント拡張属性定義ファイル（拡張ファイル）に指定した属性名に不一致がある場合は，jcoevtreportコマンドの実行時やjcoattrfcheckコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5820-Wのメッセージが出力されます。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wメッセージが出力されます。

title=項目名

固有の拡張属性の項目名を定義します。項目名には，@encodeステートメントで指定した文字コードで表現できる文字を使用します。@encodeステートメントで指定した文字コードで表現できない文字を使用した場合，JP1/IM - Viewおよび統合オペレーション・ビューアーに表示される項目名が文字化けします。

また，jcoevtreportコマンドで出力するレポートの文字コードで表現できない文字を使用した場合，CSVファイルに出力される項目名が文字化けします。

項目名で画面に表示したり，項目名でイベントレポート出力したりする固有の拡張属性の項目名を文字列で指定します。このパラメーターには，指定文字列に半角仮名および「,（コンマ）」は使用できません。半角仮名および「,（コンマ）」がある場合，正常に出力できません。

項目名の最大長は255バイトです。255バイトを超える項目名を指定した場合は，jcoattrfcheckコマンドでのチェック時やjcoevtreportコマンドの実行時にKAVB5803-Wのメッセージが出力されます。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wのメッセージが出力されます。

注意事項

イベント拡張属性定義ファイルの標準ファイル（default.conf）とイベント拡張属性定義ファイル（拡張ファイル）で重複する固有の拡張属性を指定した場合，［イベントコンソール］画面のイベント一覧やイベントレポート出力で出力されるCSVのヘッダーには，イベント拡張属性定義ファイルの標準ファイル（default.conf）に指定した固有の拡張属性の項目名が表示または出力されます。

定義例

イベント拡張属性定義ファイル（拡張ファイル）の定義例を次に示します。

@encode UTF-8
@file type="extended-attributes-definition", version="0300";
@define-block type="event-attr-def";
attr name="E.SYSTEM",    title="システム名";
attr name="E.ROLE",     title="サーバ用途";
@define-block-end;

共通除外条件拡張定義ファイル

形式

DESC_VERSION=ファイルバージョン
#コメント行
def 条件群名
    [cmt コメント]
    id 条件群ID
    [valid {true | false}]
    [ex-target 除外対象]
    [date 開始日-終了日]
    [rtime 開始時刻-終了時刻]
    [week 曜日]
    cnd
        イベント条件
    end-cnd
end-def

def 条件群名2
・・・
end-def
   :

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

拡張モードの共通除外条件のイベント条件や適用期間を定義するファイルです。

このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

次の場合に共通除外条件拡張定義ファイルのバックアップファイルがcommon_exclude_filter_backup.confとして出力されます。

jcochcefmodeコマンドで共通除外条件の動作モードを基本モードから拡張モードに変更した場合で正規表現に問題があるとき

動作モードを拡張モードから基本モードに変更した場合

jcochcefmodeコマンドおよび共通除外条件拡張定義ファイルのバックアップファイルについては，「jcochcefmode」（1.　コマンド）を参照してください。

なお，イベント取得フィルター（互換用）を使用している場合，共通除外条件を使用できません。イベント取得フィルター（互換用）を使用している場合は，jcochafmodeコマンドでイベント取得フィルターに変更してください。jcochafmodeコマンドについては，「jcochafmode（UNIX限定）」（1.　コマンド）を参照してください。

共通除外条件拡張定義ファイルの最大サイズは，シフトJISコード換算で15メガバイトです。

なお，最大サイズは，共通除外条件拡張定義ファイルのサイズと追加共通除外条件定義のサイズの合計となります。そのため，共通除外条件拡張定義ファイルがシフトJISコード換算で15メガバイトになるように定義を記述すると追加共通除外条件を追加できなくなります。

定義の反映時期

jcochfilterコマンドの-efオプションを指定すると，定義内容が反映されます。jcochfilterコマンドについては，「jcochfilter」（1.　コマンド）を参照してください。

記述内容

DESC_VERSION=ファイルバージョン

共通除外条件拡張定義ファイルのバージョンを表します。指定できる値は1または2です。省略した場合，「1」を仮定します。

#コメント行

#で始まる行は，コメント扱いとなります。

def〜end-def（定義ブロック）

拡張モードの共通除外条件定義の開始と終了のパラメーターです。def〜end-defブロックは省略できます。def以降には，拡張モードの共通除外条件の条件群名を記述します。「def△△△条件群名1△△△条件群名2△△△」と指定した場合，「△△条件群名1△△△条件群名2△△△」が定義名となります（△は半角スペースを表す）。

条件群名は，共通除外条件拡張定義ファイル内でユニークになるようにシフトJISコード換算で1〜50バイトの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

定義ブロックは最大2,500件記述できます。

なお，最大件数は，共通除外条件拡張定義ファイルに記述した定義ブロック数と追加共通除外条件群の件数の合計となります。そのため，共通除外条件群拡張定義ファイルに定義ブロックを最大の2,500件記述すると，追加共通除外条件群を作成できなくなります。

cmt コメント

拡張モードの共通除外条件の説明を記述します。このパラメーターは省略できます。コメントはシフトJISコード換算で1〜1,024バイトの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

id 条件群ID

拡張モードの共通除外条件の条件群IDを指定するパラメーターです。0以上，最大定義数から1を引いた値以下で指定できます。このパラメーターは省略できません。

idパラメーターに指定できるIDは，0〜2,499です。

valid {true | false}

拡張モードの共通除外条件を有効にするかどうかを指定するパラメーターです。

大文字・小文字を区別しません。省略した場合，trueが指定されます。

ex-target 除外対象

除外対象を指定するパラメーターです。共通除外条件に一致するJP1イベントを自動アクションの実行対象外にする場合，除外対象にactionの文字列を指定します。大文字小文字の区別はありません。このパラメーターを省略した場合，共通除外条件に一致するJP1イベントは取得対象外になります。このパラメーターは，定義ブロック内に一つだけ指定できます。また，共通除外条件拡張定義ファイルのバージョンが2の場合だけ定義できます。

date 開始日-終了日

拡張モードの共通除外条件を適用する期間を指定するパラメーターです。このパラメーターは省略できます。次の形式で指定します。

　date△YYYYMMDD-YYYYMMDD

　（凡例）△：半角スペース

指定できる期間は1970/01/01〜2038/01/19です。

このパラメーターを省略した場合，常に適用となります。

開始日を省略した場合，拡張モードの共通除外条件を定義した時点から終了日まで適用されます。開始日を省略するには次の形式で終了日だけを指定します。

　date△-YYYYMMDD

　（凡例）△：半角スペース

終了日を省略した場合，開始日から常に適用となります。終了日を省略するには次のどちらかの形式で開始日だけを指定します。

　date△YYYYMMDD

　date△YYYYMMDD-

　（凡例）△：半角スペース

適用期間については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.2.7　共通除外条件」を参照してください。

rtime 開始時刻-終了時刻

拡張モードの共通除外条件を適用する時刻を指定するパラメーターです。このパラメーターは省略できます。次の形式で指定します。

　rtime△HHMM-HHMM

　（凡例）△：半角スペース

このパラメーターを省略した場合，開始時刻を9:00，終了時刻を開始時刻の24時間後と仮定します。また，開始時刻は省略できません。終了時刻を省略した場合，開始時刻から24時間後まで適用されます。

終了時刻を省略するには次の形式で開始時刻だけを指定します。

　rtime△HHMM

　rtime△HHMM-

　（凡例）△：半角スペース

開始時刻，終了時刻に指定できる時刻は00:00〜23:59です。

開始時刻より前の時刻を終了時刻に指定した場合，終了時刻を翌日の時刻として動作します。また，開始時刻と終了時刻に同じ時刻を指定した場合も同様に，終了時刻を翌日の時刻として動作します。

パラメーターの終了時刻の省略パターンを次の表に示します。

表2‒28　rtimeパラメーターの終了時刻の省略パターン

項番

省略パターン

説明

1

rtime△開始時刻

開始時刻から24時間後まで適用する。

2

rtime△開始時刻-

3

rtime△開始時刻-終了時刻

開始日から終了日まで適用する。

（凡例）

△：半角スペース

開始時刻，終了時刻は，HHMMの形式で指定してください。HHには時，MMには分を指定します。

適用期間には，開始時刻は含まれますが，終了時刻は含まれません。例えば，曜日指定を月曜日，開始時刻を21:00，終了時刻を03:00に設定した場合，適用期間は，月曜日の21:00:00から，翌火曜日の02:59:59までとなります。

適用期間については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.2.7　共通除外条件」を参照してください。

week 曜日

拡張モードの共通除外条件を適用する曜日を指定するパラメーターです。このパラメーターは省略できます。複数の曜日を指定する場合は「,」（半角コンマ）で区切ります。次の形式で指定します。

　week△0,1,2,3,4,5,6

　（凡例）△：半角スペース

曜日と数値は次のとおり対応しています。

日曜日：0

月曜日：1

火曜日：2

水曜日：3

木曜日：4

金曜日：5

土曜日：6

曜日を省略した場合，すべての曜日として適用されます。

適用期間については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.2.7　共通除外条件」を参照してください。

cnd〜end-cnd（イベント条件ブロック）

拡張モードの共通除外条件のイベント条件を指定する，ブロックの開始と終了のパラメーターです。イベント条件ブロックは，定義ブロック内に必ず一つ指定する必要があります。省略はできません。cndおよびend-cndパラメーターの前後のタブやスペースは，無視されます。

一つの定義ブロック内に複数のイベント条件ブロックを指定することはできません。

イベント条件

拡張モードの共通除外条件で除外するJP1イベントの条件を指定します。イベント条件ブロックには，0〜256件のイベント条件を指定できます。イベント条件とイベント条件は，AND条件となります。次の形式で指定します。

　属性名△比較キーワード△オペランド

　（凡例）△：半角スペース

なお，半角スペース，またはタブだけで構成された行は，無視して処理を続行します。

属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2‒29　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番

項目

属性名

比較

キーワード

オペランド

1

イベントID

B.ID

と一致する

と一致しない

JP1イベントのイベントIDを指定する。

最大100件複数指定できる。

16進数形式で指定する。

英大文字・英小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

と一致する

と一致しない

JP1イベントの登録要因を設定する。

最大100件複数指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

3

発行元プロセスID

B.PROCESSID

と一致する

と一致しない

JP1イベントの発行元アプリケーションのプロセス別IDを指定する。

最大100件複数指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

4

登録時刻

B.TIME

時刻範囲

JP1イベントが発行元ホストのイベントDBに登録された時刻を指定する。

JP1/IM - Managerが稼働している環境の時刻で指定する。

範囲開始日時および範囲終了日時，または期間を指定する。

範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。

5

到着時刻

B.ARRIVEDTIME

時刻範囲

JP1イベントがマネージャーホストのイベントDBに登録された時刻を指定する。

JP1/IM - Managerが稼働している環境の時刻で指定する。

範囲開始日時および範囲終了日時，または期間を指定する。

6

発行元ユーザーID

B.USERID

と一致する

と一致しない

JP1イベントの発行元プロセスのユーザーIDを指定する。

最大100件複数指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

7

発行元グループID

B.GROUPID

と一致する

と一致しない

JP1イベントの発行元プロセスのグループIDを指定する。

最大100件複数指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

8

発行元ユーザー名

B.USERNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発行元プロセスのユーザー名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

9

発行元グループ名

B.GROUPNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発行元プロセスのグループ名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

10

発行元IPアドレス

B.SOURCEIPADDR

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発行元イベントサーバに対応するIPアドレスを指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

IPv6アドレスを指定する場合は，次に示すとおり，0〜9およびa〜fの4桁の16進数で指定する。英字部分は，英小文字で指定する。

（例）0011:2233:4455:6677:8899:aabb:ccdd:eeff

英字部分を英大文字にしたり，IPv4射影アドレス，IPv4互換アドレス，およびIPv6アドレスの省略形式を指定したりはできない。

11

発行元イベントサーバ名(登録ホスト名)※

B.SOURCESERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの登録ホスト名（イベントサーバ名）を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

12

メッセージ

B.MESSAGE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントのメッセージを設定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

13

重大度

(重大度変更機能が有効の場合，変更前の重大度を指定する)

E.SEVERITY

属性有

属性無

と一致する

JP1イベントの重大度の有無，種類を指定できる。

比較キーワードが「と一致する」の場合，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）の中から複数指定できる。

14

ユーザー名

E.USER_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントを発行したユーザー名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

15

プロダクト名

E.PRODUCT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントを発行したプログラムの名称を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

16

オブジェクトタイプ

E.OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントのオブジェクトの種類を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

17

オブジェクト名

E.OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントのオブジェクト名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

18

登録名タイプ

E.ROOT_OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの登録名タイプを指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

19

登録名

E.ROOT_OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの登録名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

20

オブジェクトID

E.OBJECT_ID

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントのオブジェクトタイプを指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

21

事象種別

E.OCCURRENCE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの事象種別を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

22

開始時刻

E.START_TIME

時刻範囲

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの実行開始または再実行開始の時刻を設定する。

比較キーワードが「時刻範囲」の場合

・範囲開始日時および範囲終了日時，または期間を指定する。

・範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。

・比較対象の属性が10進数の場合，通算秒として比較する。

比較キーワードが「時刻範囲」以外の場合

・最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

・オペランドを文字列として指定した比較キーワードで比較する。

23

終了時刻

E.END_TIME

時刻範囲

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベント実行終了の時刻を設定する。

比較キーワードが「時刻範囲」の場合

・範囲開始日時および範囲終了日時，または期間を指定する。

・範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。

・比較対象の属性が10進数の場合，通算秒として比較する。

比較キーワードが「時刻範囲」以外の場合

・最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

・オペランドを文字列として指定した比較キーワードで比較する。

24

終了コード

E.RESULT_CODE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの終了コードを設定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

25

発生元ホスト名※

E.JP1_SOURCEHOST

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発生元ホストのホスト名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

26

固有の拡張属性

E.xxxxxxx

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの固有の拡張属性の属性名を指定する。

属性名には，先頭が英大文字で英大文字，数字，およびアンダーバー（_）から構成される32バイトまでの名称を設定できる。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

注※

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」，「TRANGE（時刻範囲）」，「DEFINED（属性有）」，「NOTDEFINED（属性無）」のどれか一つを指定できます。小文字と大文字で区別します。

比較キーワードに「TRANGE（時刻範囲）」を使用する場合，次の表に示すように指定します。

表2‒30　TRANGEの指定形式

比較方法

形式

指定できる範囲

指定例

日時指定

開始日時△終了日時

開始日時≦属性値≦終了日時

2018年5月1日00:00:00〜2018年5月31日23:59:59を指定する場合

20180501000000 20180531235959

期間指定

分前

基準日時△-期間（分）MIN

基準日時 - 期間（分）≦属性値≦基準日時

2018年5月1日00:00:00から330分前までの期間を指定する場合

20180501000000 -330MIN

分後

基準日時△+期間（分）MIN

基準日時≦属性値≦基準日時 + 期間（分）

2018年5月1日00:00:00から330分後までの期間を指定する場合

20180501000000 +330MIN

時間前

基準日時△-期間（時）HOUR

基準日時 - 期間（時）≦属性値≦基準日時

2018年5月1日00:00:00から120時間前までの期間を指定する場合

20180501000000 -120HOUR

時間後

基準日時△+期間（時）HOUR

基準日時≦属性値≦基準日時 + 期間（時）

2018年5月1日00:00:00から120時間後までの期間を指定する場合

20180501000000 +120HOUR

日前

基準日時△-期間（日）DAY

基準日時 - 期間（日）≦属性値≦基準日時

2018年5月1日00:00:00から180日前までの期間を指定する場合

20180501000000 -180DAY

日後

基準日時△+期間（日）DAY

基準日時≦属性値≦基準日時 + 期間（日）

2018年5月1日00:00:00から180日後までの期間を指定する場合

20180501000000 +180DAY

（凡例）

△：半角スペース

開始日時，終了日時および基準日時は，YYYYMMDDhhmmss形式で指定します。

期間（分，時，日）は，1〜9,999の範囲の数字で指定します。MIN，HOUR，DAYは，大文字・小文字を区別します。

期間指定の場合，指定した基準日時からの期間が，日時の範囲（UTC1970年1月1日00:00:00〜UTC2038年1月19日03:14:07）を超える場合，エラーとなります。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。小文字と大文字で区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。また，これらの値は定義フォーマットの上限チェックの場合，1文字として扱います。

オペランドに最大長制限はありません。ただし，cnd〜end-cnd（イベント条件ブロック）に記述できるイベント条件（属性名，比較キーワード，オペランド）の合計はシフトJISコード換算で最大65,536バイトです。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

注意事項

date，rtime，weekの設定値の関連について

date，rtime，weekを設定した場合，dateで指定した期間内のweekで指定した曜日に合致する日ごとに，rtimeで指定した開始時刻から終了時刻まで共通除外条件が有効となります。

rtimeで終了時刻が翌日となるような指定をした場合は，指定された翌日の終了時刻まで共通除外条件は有効となります。

適用期間については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.2.7　共通除外条件」を参照してください。

定義例

次の条件の場合に，2010/10/01〜2010/10/31の毎週月曜〜土曜10:00〜12:00の期間でイベントを除外する定義例を示します。

イベントIDが1に一致

重大度がEmergencyまたはAlert

登録ホストが正規表現で次のとおり指定

host[0-9][0-9]

DESC_VERSION=1
# コメント
def 共通除外条件群1
    cmt 期限：2010/10/31
    id 1
    valid true
    date 20101001-20101031
    week 1,2,3,4,5,6
    rtime 1000-1200
    cnd
        B.ID IN 00000001
        E.SEVERITY IN Emergency Alert
        B.SOURCESERVER REGEX host[0-9][0-9]
    end-cnd
end-def

次の条件の場合に，2017/04/01〜2017/05/01の毎週月曜〜土曜23:00〜翌02:00の期間でイベントを自動アクションの実行対象外にする定義例を示します。

イベントIDが2に一致

重大度がEmergencyまたはAlert

登録ホストが正規表現で次のとおり指定

host[0-9][0-9]

DESC_VERSION=2
# コメント
def 共通除外条件群1
    cmt 期限：2017/05/01
    id 1
    valid true
    ex-target action
    date 20170401-20170501
    week 1,2,3,4,5,6
    rtime 2300-0200
    cnd
        B.ID IN 00000002
        E.SEVERITY IN Emergency Alert
        B.SOURCESERVER REGEX host[0-9][0-9]
    end-cnd
end-def

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

形式

# コメント行
属性名
属性名
属性名
　・
　・
　・
属性名

ファイル

common_exclude_filter_attr_list.conf（共通除外条件表示項目定義ファイル）

common_exclude_filter_attr_list.conf.model（共通除外条件表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥filter¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥filter¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/filter/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/filter/attr_list

説明

［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。共通除外条件表示項目定義ファイルに指定された表示項目を指定された順番で［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示します。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，またはjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

共通除外条件表示項目定義ファイルには，［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

SEPARATORを指定すると，［共通除外条件設定(拡張)］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択しても，属性名は設定できません。

指定できる属性名を次の表に示します。

表2‒31　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

開始時刻

E.START_TIME

14

終了時刻

E.END_TIME

15

登録時刻

B.TIME

16

到着時刻

B.ARRIVEDTIME

17

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

18

登録要因

B.REASON

19

発行元プロセスID

B.PROCESSID

20

発行元ユーザー名

B.USERNAME

21

発行元ユーザーID

B.USERID

22

発行元グループ名

B.GROUPNAME

23

発行元グループID

B.GROUPID

24

発行元IPアドレス

B.SOURCEIPADDR

25

オブジェクトID

E.OBJECT_ID

26

終了コード

E.RESULT_CODE

27

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，共通除外条件表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜26が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［共通除外条件設定(拡張)］画面には表示されません。

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）

形式

# コメント行
[DEFAULT_NAME 共通除外条件群名]
属性名
属性名
　・
　・
属性名
属性名

ファイル

common_exclude_filter_auto_list.conf

common_exclude_filter_auto_list.conf.model（共通除外条件自動入力定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥filter¥auto_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥filter¥auto_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/filter/auto_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/filter/auto_list

説明

［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［共通除外条件で除外］を選択して［共通除外条件設定(拡張)］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。また，追加共通除外条件群名のデフォルト名も定義できます。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，またはjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

DEFAULT_NAME 共通除外条件群名

共通除外条件群名を定義する識別子を表しています。識別子は，コメントと空行を除いたファイルの先頭に記述してください。

このパラメーターに指定した共通除外条件群名が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［共通除外条件で除外］を選択して［共通除外条件設定(拡張)］画面を開いたときに，初期値として表示されます。

40バイトまでの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。40バイトを超えて指定した場合，41バイト以上の文字列を切り捨てた文字列が共通除外条件群名となります。指定しなかった場合，「追加共通除外条件群」が共通除外条件群名となります。

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

共通除外条件自動入力定義ファイルには，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［共通除外条件で除外］を選択して［共通除外条件設定(拡張)］画面を開いたときに，イベント条件として設定されるJP1イベントの属性を指定します。このパラメーターに指定した属性名の条件が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［共通除外条件で除外］を選択して［共通除外条件設定(拡張)］画面を開いたときに，初期値として表示されます。

定義項目は，設定されるJP1イベントの属性名を1行に1件記述します。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

同じ属性名が複数指定されていた場合，その値は無視し，KAVB1160-Wメッセージを統合トレースログに出力します。

［共通除外条件設定(拡張)］画面の［イベント条件］に自動的に表示されるJP1イベントの属性の順序は，共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）の属性の記載順に設定されます。

指定できる属性名を次の表に示します。

表2‒32　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

登録要因

B.REASON

14

発行元プロセスID

B.PROCESSID

15

発行元ユーザー名

B.USERNAME

16

発行元ユーザーID

B.USERID

17

発行元グループ名

B.GROUPNAME

18

発行元グループID

B.GROUPID

19

発行元IPアドレス

B.SOURCEIPADDR

20

オブジェクトID

E.OBJECT_ID

21

終了コード

E.RESULT_CODE

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，共通除外条件自動入力定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜3，項番10〜12が表示されます。

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）

形式

# コメント行
属性名
属性名
　・
属性名

ファイル

event_storm_attr_list.conf（繰り返しイベント条件表示項目定義ファイル）

event_storm_attr_list.conf.model（繰り返しイベント条件表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥event_storm¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥event_storm¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/event_storm/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/event_storm/attr_list

説明

［繰り返しイベント条件設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。繰り返しイベント条件表示項目定義ファイルに指定された表示項目を指定された順番で［繰り返しイベント条件設定］画面の［属性名］表示領域に表示します。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

繰り返しイベント条件表示項目定義ファイルには，［繰り返しイベント条件設定］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

SEPARATORを指定すると，［繰り返しイベント条件設定］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択しても，属性名は設定できません。

指定できる属性名を次の表に示します。

表2‒33　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

開始時刻

E.START_TIME

14

終了時刻

E.END_TIME

15

登録時刻

B.TIME

16

到着時刻

B.ARRIVEDTIME

17

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

18

登録要因

B.REASON

19

発行元プロセスID

B.PROCESSID

20

発行元ユーザー名

B.USERNAME

21

発行元ユーザーID

B.USERID

22

発行元グループ名

B.GROUPNAME

23

発行元グループID

B.GROUPID

24

発行元IPアドレス

B.SOURCEIPADDR

25

オブジェクトID

E.OBJECT_ID

26

終了コード

E.RESULT_CODE

27

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，繰り返しイベント条件表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜26が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［繰り返しイベント条件設定］画面には表示されません。

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）

形式

# コメント行
[DEFAULT_NAME 繰り返しイベント条件名]
属性名
属性名
　・
　・
属性名
属性名

ファイル

event_storm_auto_list.conf

event_storm_auto_list.conf.model（繰り返しイベント条件自動入力定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥event_storm¥auto_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥event_storm¥auto_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/event_storm/auto_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/event_storm/auto_list

説明

［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［繰り返しイベント条件で抑止］を選択して［繰り返しイベント条件設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。また，繰り返しイベント条件名のデフォルト名も定義できます。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

DEFAULT_NAME 繰り返しイベント条件名

繰り返しイベント条件名を定義する識別子を表しています。識別子は，コメントと空行を除いたファイルの先頭に記述してください。

このパラメーターに指定した共通除外条件群名が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［繰り返しイベント条件で抑止］を選択して［繰り返しイベント条件設定］画面を開いたときに，初期値として表示されます。

40バイトまでの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。40バイトを超えて指定した場合，41バイト以上の文字列を切り捨てた文字列が繰り返しイベント条件名となります。指定しなかった場合，「追加繰り返しイベント条件」が繰り返しイベント条件名となります。

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

繰り返しイベント条件自動入力定義ファイルには，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［繰り返しイベント条件で抑止］を選択して［繰り返しイベント条件設定］画面を開いたときに，イベント条件として設定されるJP1イベントの属性を指定します。このパラメーターに指定した属性名の条件が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［繰り返しイベント条件で抑止］を選択して［繰り返しイベント条件設定］画面を開いたときに，初期値として表示されます。

定義項目は，設定されるJP1イベントの属性名を1行に1件記述します。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

同じ属性名が複数指定されていた場合，その値は無視し，KAVB1896-Wメッセージを統合トレースログに出力します。

［繰り返しイベント条件設定］画面の［イベント条件］に自動的に表示されるJP1イベントの属性の順序は，繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）の属性の記載順に設定されます。

指定できる属性名を次の表に示します。

表2‒34　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

登録要因

B.REASON

14

発行元プロセスID

B.PROCESSID

15

発行元ユーザー名

B.USERNAME

16

発行元ユーザーID

B.USERID

17

発行元グループ名

B.GROUPNAME

18

発行元グループID

B.GROUPID

19

発行元IPアドレス

B.SOURCEIPADDR

20

オブジェクトID

E.OBJECT_ID

21

終了コード

E.RESULT_CODE

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，繰り返しイベント条件自動入力定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜3，項番10〜12が表示されます。

対処状況イベント定義ファイル（processupdate.conf）

形式

[PROCESSUPDATE]
PROCESS_UPDATE_EVENT_OPTION={true | false}
[End]

ファイル

processupdate.conf（対処状況イベント定義ファイル）

processupdate.conf.model（対処状況イベント定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥processupdate¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥processupdate¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/processupdate/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/processupdate/

説明

対処状況を変更したときにJP1イベントを発行するかどうかを定義するファイルです。

定義の反映時期

次の場合に，対処状況イベント定義ファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

記述内容

PROCESS_UPDATE_EVENT_OPTION={true | false}

対処状況変更時にJP1イベント（イベントID：3F11）を発行するかどうかを指定します。なお，大文字・小文字は区別しません。

trueを指定すると対処状況変更時にJP1イベントを発行します。

falseを指定すると対処状況変更時にJP1イベントを発行しません。デフォルトはfalseです。

省略した場合や値が不正な場合はfalseが仮定されます。

JP1イベントの詳細については，「3.2.2　JP1イベントの詳細」を参照してください。

注意事項

JP1イベントの発行設定をすると，対処されたJP1イベント一つに対し，3F11のJP1イベントが一つ発行されるようになります。例えば，［イベントコンソール］画面の［重要イベント］ページでJP1イベントを複数選択し，対処状況を変更した場合は，その対処状況を変更したJP1イベント数分，3F11のJP1イベントが発行されます。

大量のJP1イベントの対処状況をまとめて変更する運用をされている場合はこの機能を有効にしないでください。

相関イベント発行システムプロファイル（egs_system.conf）

形式

VERSION=1

START_OPTION={cold | warm}

ファイル

egs_system.conf（相関イベント発行システムプロファイル）

egs_system.conf.model（相関イベント発行システムプロファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥evgen¥profile¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥evgen¥profile¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/evgen/profile/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/evgen/profile/

説明

相関イベント発行サービスの起動時および停止時の動作を定義するファイルです。

定義の反映時期

次の場合に，相関イベント発行システムプロファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドでリロードをした場合

記述内容

VERSION=1

ファイルのバージョンを表しています。編集不要です。省略した場合や1以外の数値を指定した場合は，VERSION=1が仮定されます。

START_OPTION={cold | warm}

相関イベント発行サービスの起動オプションです。

起動時および停止時の動作を決めるための値を指定します。値に指定できるのは，coldとwarmの二つです。デフォルトはwarmです。大文字・小文字は区別されません。省略した場合や値が不正な場合はwarmが仮定されます。

統合監視DBを使用しない場合と統合監視DBを使用する場合とで動作が異なります。

統合監視DBを使用しない場合にcold，warmそれぞれを指定したときの相関イベント発行サービスの動作を起動時，停止時に分けて次の表に示します。用途に合わせて値を変更してください。

表2‒35　起動オプションの違いによる相関イベント発行サービス起動時・停止時の動作の違い（統合監視DBを使用しない場合）

起動オプション

相関イベント発行サービスの動作

起動時の動作※1

停止時の動作

cold

前回停止時の起動オプションがcoldの場合：

相関イベント発行サービスが起動したあとに登録されたJP1イベントから，発行処理の対象とする。

発行処理中の相関イベントをすべて不成立にして，相関イベント発行履歴ファイルに出力する。

前回停止時の起動オプションがwarmの場合：

発行処理中の相関イベントをすべて不成立にして，相関イベント発行サービスが起動したあとに取得したJP1イベントから，発行処理の対象とする。

warm

前回停止時の起動オプションがcoldの場合：

相関イベント発行サービスが前回停止時に取得したJP1イベントの続きから発行処理の対象とする。

停止前の最後に取得したJP1イベントの情報，発行処理の内容，および相関イベントの発行定義の内容を内部ログに出力・保管する。

前回停止時の起動オプションがwarmの場合：

前回停止時の相関イベントの発行処理の内容を引き継ぎ，前回停止時に取得したJP1イベントの続きから発行処理の対象とする。※2

注※1

相関イベント発行サービスが初めて起動するときは，起動オプションの値に関係なく次のように動作します。

・相関イベント発行サービス起動後に登録されたJP1イベントから取得を開始する。

・相関イベント発行定義を読み込み，定義に従って処理を開始する。

なお，デフォルトでは，相関イベント発行定義が設定されていないため，相関イベントは発行されません。

注※2

JP1/IM - Managerの停止時と次の起動時で相関イベント発行定義が異なる場合，発行処理中の相関イベントはすべて不成立になります。いったん，内容がクリアされたあとは，前回停止時に取得したJP1イベントの続きから，発行処理の対象になります。

統合監視DBを使用する場合，相関イベント発行機能は，イベント基盤サービスが取得したイベントに対して，相関イベント発行定義を関連づけし，相関イベントを発行します。

イベント基盤サービスは，起動後にJP1/BaseのイベントDBからJP1イベントの取得を開始する位置を選択できます。JP1イベントの取得を開始する位置は，jcoimdefコマンドの-bオプションで選択できます。

相関イベントの発行処理は，JP1イベントの取得を開始する位置および起動オプションの組み合わせによって次のように異なります。

表2‒36　起動オプションの違いによる相関イベント発行サービス起動時・停止時の動作の違い（統合監視DBを使用する場合）

起動オプション

-bオプションの値

処理

warm

-1（デフォルト値）

相関イベントの発行処理中であるJP1イベントの状態を引き継ぎます。

JP1イベントの取得を開始する位置は，前回の停止時に取得を終えていたJP1イベントの次のJP1イベントからです。なお，前回の停止時に取得を終えていたJP1イベントがない場合は，イベントDBに登録されているイベントの中で最も古いJP1イベントから取得を開始します。

0〜144

KAJV2316-Wメッセージを出力し，相関イベントの発行処理中であるJP1イベントの状態を引き継ぎません。

cold

-1〜144

相関イベントの発行処理は，すべて停止し，終了します。相関イベントの発行処理中であるJP1イベントの状態を引き継げません。

なお，統合監視DBを使用する場合，一度，相関イベント発行処理の対象となったJP1イベントは，再度，相関イベント発行処理の対象にはなりません。

JP1/IM - Managerをクラスタシステムで運用する場合にはwarmに設定を変更してください。

フェールオーバー時には，JP1/IM - Manager停止→JP1/Base停止→JP1/Base起動→JP1/IM - Manager起動，の順に製品の停止・起動処理がされます。coldの設定状態でフェールオーバーした場合，JP1/IM - Manager停止→JP1/Base停止の間に発生したJP1イベントやJP1/Base起動→JP1/IM - Manager起動の間に発生したJP1イベントを取得できません。このため，cold設定のままだと，発行処理の対象となるJP1イベントを取り漏らすことがあります。

相関イベント発行定義ファイル

形式

VERSION={1 | 2}

#コメント行
[発行条件名]
TARGET=相関の対象範囲の絞り込み条件
CON=イベント条件
TIMEOUT=タイムアウト時間
TYPE=イベント相関タイプ
SAME_ATTRIBUTE=同一属性値条件
CORRELATION_NUM=同時相関数
SUCCESS_EVENT=相関成立イベント
FAIL_EVENT=相関不成立イベント

[発行条件名]
TARGET=相関の対象範囲の絞り込み条件
CON=イベント条件
TIMEOUT=タイムアウト時間
TYPE=イベント相関タイプ
SAME_ATTRIBUTE=同一属性値条件
CORRELATION_NUM=同時相関数
SUCCESS_EVENT=相関成立イベント
FAIL_EVENT=相関不成立イベント
          :

ファイル

任意のファイルを使用します。ただし，次の制限があります。

拡張子は.confとしてください。

ファイル名に使用できる文字は，半角英数字とアンダーバー「_」だけです。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

相関の対象とするJP1イベントの条件，および条件成立時に発行する相関イベントを定義するファイルです。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

定義の反映時期

jcoegschangeコマンドで相関イベント発行定義を反映したあとに有効になります。

記述内容

VERSION={1 | 2}

相関イベント発行定義ファイルのバージョンです。

1または2を指定します。

1を指定すると，次のパラメーターを指定できません。ここで説明しているすべてのパラメーターを指定したい場合，2を指定してください。

表2‒37　指定できないパラメーター一覧

バージョン

パラメーター名

1

TARGET

SAME_ATTRIBUTE

CORRELATION_NUM

2

なし

値の前に0を指定した場合，0は無視されます。例えば，VERSION=0001とVERSION=1は同じ意味です。省略した場合は，VERSION=1が仮定されます。

1または2以外の値を指定した場合，定義不正になります。また，VERSIONを複数指定した場合は，定義不正になります。

#コメント行

#で始まる行は，コメント扱いとなります。

[発行条件名]

相関イベント発行条件の定義ブロックの開始タグです。[発行条件名]から，次の[発行条件名]の直前までが一つの定義ブロックになります。省略できません。相関イベント発行条件は1,000件まで定義できます。1,000件を超えて定義した場合，定義不正となります。

発行条件名は[ ]（半角角括弧）で囲って指定します。発行条件名には，半角英数字，-（ハイフン），_（アンダーバー）および/（スラッシュ）が使用できます。指定できる文字数は，1文字以上32文字以下です。

また，大文字，小文字は区別されます。例えば，［JP1_HAKKOUZYOUKEN］と［jp1_hakkouzyouken］は別の定義になります。

なお，相関イベント発行定義ファイル内で，同じ発行条件名は使用できません。同じ発行条件名を定義した場合，ファイル内で先に記述してある方が有効になります。また，「IM_」で始まる発行条件名は指定できません。指定した場合，定義不正になります。「IM_」の大文字・小文字は区別されません。

[発行条件名]の横には発行条件のコメントを付けられます。コメントを付ける場合は，[発行条件名]#発行条件のコメントと記述します。

TARGET=相関の対象範囲の絞り込み条件

相関イベントの発行処理の対象とするJP1イベントの範囲を絞り込みたいときに定義します。省略すると，取得したすべてのJP1イベントが相関イベントの発行処理の対象になります。

1件の相関イベント発行条件に指定できる相関の対象範囲の絞り込み条件は一つだけです。複数定義した場合，定義不正となります。

形式を次に示します。

　TARGET=イベント属性条件1［,イベント属性条件2…］

イベント属性条件を複数指定する場合，「,」（半角コンマ）で区切ります。複数指定すると，それぞれのイベント属性条件はAND条件となります。複数指定したイベント属性条件がすべて成立するJP1イベントが発行された場合に，条件が成立します。

イベント属性条件は次の形式で指定します。

　属性名 比較条件 属性値

イベント属性条件の設定項目を次に示します。

表2‒38　イベント属性条件の設定項目

項番

設定項目

説明

1

属性名

JP1イベントの基本属性または拡張属性を指定します。 基本属性には「B.」を，拡張属性には「E.」を付けます。例えば，メッセージを指定する場合「B.MESSAGE」と指定します。

拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダーバー）

指定できる属性名については，「表2-39　相関の対象範囲の絞り込み条件に指定できる属性名の一覧」を参照してください。

2

比較条件

使用できる比較条件は次のとおりです。これ以外のものを指定すると定義不正となります。

比較条件：意味

==　：と一致する

!=　：と一致しない

^=　：から始まる

>=　：を含む

<=　：を含まない

*=　：正規表現※

注※　使用できる正規表現については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

3

属性値

属性値には比較する値を指定します。属性値に指定できる文字数は最大2,048（JP1/IM - Managerのバージョンが09-10までの場合は1,023）バイトです。2,048（JP1/IM - Managerのバージョンが09-10までの場合は1,023）バイトを超えると定義不正となります。

なお，イベント属性条件を複数指定する場合は，指定できる文字数が，全条件の属性値の合計で最大2,305（JP1/IM - Managerのバージョンが09-10までの場合は1,280）バイトになります。2,305（JP1/IM - Managerのバージョンが09-10までの場合は1,280）バイトを超えると定義不正となります。

例えば，イベント属性条件を五つ設定した場合，その五つの属性値の合計を2,305（JP1/IM - Managerのバージョンが09-10までの場合は1,280）バイト以内にする必要があります。

属性値を複数定義する場合は;（セミコロン）で属性値を区切ります。なお，属性値の間に;（セミコロン）が連続してあっても一つの;（セミコロン）と見なします。例えば，B.ID==A;;;;;BはB.ID==A;Bと見なします。

例：E.xxx==A;Bと設定したとき，E.xxxがAまたはBと一致したときに条件が成立します。

,（半角コンマ），;（セミコロン）を属性値として使用する場合，または空白を属性値の両端に使用する場合は，一つの属性値として指定したい範囲を"（ダブルクォーテーション）で囲みます。

"（ダブルクォーテーション），¥（半角エンマーク）を属性値として使用する場合は直前に¥（半角エンマーク）を付けます。

一つの属性名に対して，属性値を複数指定した場合，次に示す例のように条件が成立します。

例1：E.xxx==A;Bと指定した場合，E.xxxがAまたはBのどちらか一方に一致したときに条件が成立します。

例2：E.xxx!=A;Bと指定した場合，E.xxxがAまたはBの両方に一致しないときに条件が成立します。

例3：E.xxx^=A;Bと指定した場合，E.xxxがAまたはBのどちらかで始まるときに条件が成立します。

例4：E.xxx>=A;Bと指定した場合，E.xxxがAまたはBのどちらかを含むときに条件が成立します。

例5：E.xxx<=A;Bと指定した場合，E.xxxがAまたはBの両方を含まないときに条件が成立します。

例6：E.xxx*=A;Bと指定した場合，E.xxxがAまたはBのどちらかの正規表現に一致したときに条件が成立します。

一つのイベント属性条件に，同一の属性名を複数指定する場合，次のような組み合わせは定義不正になりますので，注意してください。

・絶対に一致しない組み合わせ

　メッセージ(B.MESSAGE)がKAVBで始まり，メッセージがKAVBを含まない

・冗長な組み合わせ

　メッセージ(B.MESSAGE)がKAVBで始まり，メッセージがKAVBを含む

属性名，比較条件，および属性値の間，セミコロンで区切って指定した属性値の両端，またはイベント属性条件の両端に指定された空白（半角スペースとASCIIコード0x01〜0x1Fの文字）は無視されます。

例：メッセージが「KAJVxxxx-I△実行しました」またはErrorと一致する条件

次の△部分に空白がある場合，無視されます。

△B.MESSAGE△==△"KAJVxxxx-I△実行しました";△Error△

上記の例と同じ意味になる指定方法の例を示します。

B.MESSAGE==KAJVxxxx-I△実行しました;Error

B.MESSAGE=="KAJVxxxx-I△実行しました";Error

属性名にイベントID（B.ID）を指定する場合は，比較条件は完全一致（==）しか使用できません。

相関の対象範囲の絞り込み条件に指定できる属性名の一覧を次に示します。

表2‒39　相関の対象範囲の絞り込み条件に指定できる属性名の一覧

項番

属性名

項目

1

B.SOURCESERVER※1

発行元イベントサーバ名

2

B.DESTSERVER※1

送信先イベントサーバ名

3

B.MESSAGE

メッセージ

4

B.ID

イベントID

5

B.REASON

登録要因

6

B.USERID

発行元ユーザーID

7

B.GROUPID

発行元グループID

8

B.USERNAME

発行元ユーザー名

9

B.GROUPNAME

発行元グループ名

10

E.JP1_SOURCEHOST※1

発生元ホスト名

11

E.xxxxxxx※2

拡張属性（共通情報・固有情報）

注※1

統合監視DBおよびIM構成管理DBが有効な場合に，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

注※2

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

CON=イベント条件

相関イベントの発行処理の対象，または対象外とするJP1イベントの条件を定義します。イベント条件は複数指定できます。また，1件の相関イベント発行条件内に少なくとも1件以上定義する必要があります。イベント条件は10件まで定義できます。なお，定義していない場合，または定義が正しくない場合は，定義不正となります。

形式を次に示します。

　CON={NOT|[CID:n]},イベント属性条件1 [, イベント属性条件2[, イベント属性条件3 …] ]

イベント属性条件を複数指定する場合，「,」（半角コンマ）で区切ります。複数指定すると，それぞれのイベント属性条件はAND条件となります。複数指定したイベント属性条件がすべて成立するJP1イベントが発行された場合に，条件が成立します。

イベント条件の設定項目を次に示します。

表2‒40　イベント条件の設定項目

項番

設定項目

説明

1

NOT

相関イベントの発行処理の対象外にするJP1イベントを指定します。

イベント条件にNOTを指定した場合，イベント条件（CON）の定義順序に関係なく，その条件が最初に適用されます。

2

CID:n

条件IDです。相関イベントの発行時に，変数を使って相関元イベントの情報をほかのパラメーター（SAME_ATTRIBUTE，SUCCESS_EVENT）に引き継ぐ場合に指定します。1〜999の整数値で指定します。

例えば，複数のJP1イベントを相関元イベントとし，SUCCESS_EVENTパラメーターに変数 $EVn_B.MESSAGEを指定する場合，条件IDの指定に従って，相関イベントに相関元イベントのメッセージ情報を引き継ぎます。

省略した場合，ほかのパラメーターに情報を引き継ぐことはできません。また，指定値の前に0を付けたり，同じCIDを指定したりすると定義不正になります。

3

イベント属性条件

イベント属性条件は次の形式で指定します。

形式

　属性名 比較条件 属性値

属性名

JP1イベントの基本属性または拡張属性を指定します。

基本属性には「B.」を，拡張属性には「E.」を付けます。

例えば，メッセージを指定する場合「B.MESSAGE」と指定します。

拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダーバー）

基本属性，拡張属性については，「3.1　JP1イベントの属性」を参照してください。なお，製品固有の拡張属性を指定する場合，JP1イベントを発行する各製品のマニュアルを参照してください。ただし，発行元IPアドレス（SOURCEIPADDR）は，指定することができません。

比較条件および属性値

比較条件および属性値の指定方法は，TARGETにイベント属性条件を指定する場合と同じです。

「表2-38　イベント属性条件の設定項目」および表下の説明を参照してください。

TIMEOUT=タイムアウト時間

相関イベント発行条件のタイムアウト時間を指定します。指定できる値は，1〜86,400（単位：秒）です。省略した場合は，60秒が仮定されます。

TYPE=イベント相関タイプ

イベント相関タイプを指定します。

イベント相関タイプには，sequence（順序性），combination（組み合わせ）およびthreshold（しきい値）があります。イベント相関タイプに指定できる値を次に示します。

sequence

順序性を考慮し，定義したイベント条件と一致するJP1イベントが定義順に発行されたときに相関イベント発行条件が成立します。

combination

順序性を考慮せず，定義したイベント条件の組み合わせでJP1イベントが発行されたときに相関イベント発行条件が成立します。

threshold:n

定義したイベント条件に一致するJP1イベントの発行する数がしきい値に達した時点で相関イベント発行条件が成立します。イベント条件が複数定義されている場合，そのどれかに一致したJP1イベントの合計がしきい値に達した時点で相関イベント発行条件が成立します。

しきい値は1〜100（単位：件）で指定できます。例えば，しきい値を10とする場合，次のように指定します。

threshold:10

大文字，小文字は区別されません。また，イベント相関タイプの指定を省略した場合は，combination（組み合わせ）が仮定されます。

SAME_ATTRIBUTE=同一属性値条件

同一属性値条件を指定します。

イベント条件に一致したJP1イベント（相関元イベント）に対し，特定の属性値ごとにグルーピングして，グループ単位に相関イベントを発行したい場合に定義します。

同一属性値条件は1件の相関イベント発行条件に三つまで定義できます。省略することもできます。

形式を次に示します。

　SAME_ATTRIBUTE=属性名 | {$EVn_属性名 | $EVn_ENVo} [, {$EVn_属性名 | $EVn_ENVo} …]

同一属性値条件の設定項目について説明します。

表2‒41　同一属性値条件の設定項目

項番

設定項目

説明

1

属性名

JP1イベントの基本属性または拡張属性を指定します。

ここで指定した属性名に対応する相関元イベントの属性値がグルーピングのキーになります。

属性名は，一つの同一属性値条件に対して一つだけ指定できます。

基本属性には「B.」を，拡張属性には「E.」を付けます。拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダーバー）

指定できる属性名については，「表2-42　同一属性値条件に指定できる属性名の一覧」を参照してください。

2

変数

$EVn_属性名

グルーピングのキーにしたい属性値が，相関元イベントごとに異なる属性に入っている場合に指定します。

例えば，相関元イベントAの属性A'と，相関元イベントBの属性B'をグルーピングのキーにしたいときに使用します。

$EVn_属性名は，一つの同一属性値条件に対して$EVn_ENVoと合わせて10個まで指定できます。

詳細については，「(1)(a)　相関元イベントの属性値を同一属性値条件として使用する」を参照してください。

3

変数

$EVn_ENVo

相関元イベントの属性値の一部を切り出して，同一属性値条件として使用する場合に指定します。

例えば，メッセージ（B.MESSAGE）の一部を切り出して，グルーピングのキーにしたいときに使用します。

$EVn_ENVoは，一つの同一属性値条件に対して$EVn_属性名と合わせて10個まで指定できます。

詳細については，「(1)(b)　相関元イベントの属性値の一部を同一属性値条件として使用する」を参照してください。

属性名および変数に置き換わる値（属性値または属性値の一部）は，全角，半角および大文字，小文字が区別されます。完全に同一の値だけが同一属性値条件になります。

属性名および変数に置き換わる値（属性値または属性値の一部）が相関元イベントにない場合，空文字（0バイト）に置き換わります。このため，空文字をキーにしてグルーピングします。空文字で処理された場合，相関イベント発行履歴ファイルに次の文字列が出力されます。

A JP1 event that matches the correlation event generation condition occurred, and the correlation event generation processing started, but the event attribute defined in that attribute value condition does not exist in the JP1 event. (発行条件名(発行処理番号) イベントDB内通し番号 属性名)

SAME_ATTRIBUTE=同一属性値条件 を複数指定すると，それぞれの同一属性値条件ごとに相関イベントが発行されます。

例えば，ホスト名（B.SOURCESERVER）およびユーザー名（B.USERNAME）ごとに相関イベントを発行する場合，次のように定義します。

　　　　　：

SAME_ATTRIBUTE=B.SOURCESERVER

SAME_ATTRIBUTE=B.USERNAME

　　　　　：

同一属性値条件に複数個の変数を指定する場合は「,」（半角コンマ）で区切ってください。変数に置き換わる属性値ごとに相関イベントが発行されます。

属性名および変数（$EVn_属性名，$EVn_ENVo）の間，または同一属性値条件の両端に指定された空白（半角スペースとASCIIコード0x01〜0x1Fの文字）は無視されます（次の例の△部分）。

例：

△SAME_ATTRIBUTE△=△$EV1_ENV1△,△$EV2_ENV2△

同一属性値条件に指定できる属性名の一覧を次に示します。

表2‒42　同一属性値条件に指定できる属性名の一覧

項番

属性名

項目

1

B.SOURCESERVER

発行元イベントサーバ名

2

B.DESTSERVER

送信先イベントサーバ名

3

B.MESSAGE

メッセージ

4

B.ID

イベントID

5

B.REASON

登録要因

6

B.USERID

発行元ユーザーID

7

B.GROUPID

発行元グループID

8

B.USERNAME

発行元ユーザー名

9

B.GROUPNAME

発行元グループ名

10

E.xxxxxxx※

拡張属性（共通情報・固有情報）

注※

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

CORRELATION_NUM=同時相関数

相関イベント発行条件で保持できるJP1イベントの組数を指定します。1件の相関イベント発行条件に定義できる同時相関数は一つだけです。

指定できる値は，1〜1,024（単位：組）です。項目を省略した場合は，10組が仮定されます。

注意

同時相関数を多くの相関イベント発行条件に指定し，かつ，大きな値を指定する，などの運用はお勧めできません。

相関イベント発行サービスが同時に処理するJP1イベントの組数が多くなるため，メモリー所要量が増加したり，処理速度が低下したりします。

また，すべての相関イベント発行条件で同時に発行処理できるJP1イベントの組数は20,000組です。20,000組に達すると，JP1イベント（イベントID：00003F28）が出力されます。新たにイベント条件に一致するJP1イベントが発行されても，組数が20,000組を下回るまでは処理されません。

SUCCESS_EVENT=相関成立イベント

相関イベント発行条件が相関成立になった場合に発行するJP1イベント(相関イベント)を定義します。1件の相関イベント発行条件に定義できる相関成立イベントは一つだけです。相関成立になる条件については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.3.6(1)　相関成立の場合」を参照してください。

なお，相関イベント発行条件に「FAIL_EVENT=相関不成立イベント」が定義されている場合，この定義を省略できます。省略した場合，相関イベント発行条件が相関成立になっても，相関成立イベントは発行されません。

相関成立イベントは，次の形式で記述します。

　属性名:属性値

各項目について説明します。

属性名

JP1イベント（相関元イベント）の基本属性または拡張属性を指定します。基本属性には「B.」を，拡張属性には「E.」を付けます。拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

・先頭は大文字の半角英字

・2バイト目以降は大文字の半角英数字，または_（アンダーバー）

次の属性に対してはユーザーが任意に値を設定できます。

・イベントID（B.ID）

・メッセージ（B.MESSAGE）

・次の表に示す以外の拡張属性

表2‒43　値を指定できない拡張属性

属性種別

項目

属性名

内容

共通情報

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM/GENERATE_EVENT

オブジェクトタイプ

E.OBJECT_TYPE

SERVICE

オブジェクト名

E.OBJECT_NAME

EGS

事象種別

E.OCCURRENCE

SUCCESS

固有情報

関連イベントDB内通し番号

E.JP1_GENERATE_SOURCE_SEQNO

相関元のイベントのイベントDB内通し番号を半角スペース区切りで格納します。

イベントDB内通し番号1△イベントDB内通し番号2△イベントDB内通し番号3・・・イベントDB内通し番号n

nは最大100です。

相関イベント発行条件名

E.JP1_GENERATE_NAME

成立した相関イベント発行条件名

予約語

E.JP1_で始まる拡張属性

発生元ホスト名（E.JP1_SOURCEHOST）を除くJP1/IM - Managerが予約している拡張属性

相関元イベントの属性値を相関イベントに引き継ぎたい場合，変数を指定します。また，相関成立イベントは次の形式で指定します。

　属性名:$EVn_属性名

この場合，イベント条件のCIDで引き継ぎたい相関元イベントを指定し，nにCIDの値を指定します。また，:の右側に変数を指定します。

詳細については，「(2)(a)　相関元イベントの属性値を相関イベントの属性値に引き継ぐ」を参照してください。

イベント相関タイプでしきい値（threshold）を指定，かつ，相関元イベントの属性値を相関イベントに引き継ぎたい場合，相関成立イベントは，次の形式で指定します。

　属性名:$EVn_m_属性名

この場合，CIDで引き継ぎたい相関元イベントを指定し，nにCIDの値を指定します。また，:の右側に変数を指定します。かつ，mに何番目に処理された相関元イベントの属性値を引き継ぐかを指定します。

詳細については，「(2)(b)　相関元イベントの属性値を相関イベントの属性値に引き継ぐ（イベント相関タイプがしきい値の場合）」を参照してください。

相関元イベントの属性値の一部を切り出して，相関イベントに引き継ぎたい場合，変数 $EVn_ENVoを指定します。また，イベント条件は正規表現で指定し，属性値の切り出したい部分を( )で囲みます。

相関成立イベントは次の形式で指定します。

　属性名:$EVn_ENVo

この場合，CIDで引き継ぎたい相関元イベントを指定し，nにCIDの値を指定します。また，ENVoのoに切り出した順番を指定します。

詳細については，「(2)(c)　相関元イベントの属性値の一部を相関イベントの属性値に引き継ぐ」を参照してください。

基本属性，拡張属性については，「3.1　JP1イベントの属性」を参照してください。なお，製品固有の拡張属性を指定する場合，JP1イベントを発行する各製品のマニュアルを参照してください。

相関成立イベントに項目を複数指定する場合は「,」（半角コンマ）で区切ってください。

基本属性のイベントID（B.ID）は必ず指定してください。指定できるイベントIDの範囲は，0〜1FFF，7FFF8000〜7FFFFFFFです。指定しなかった場合，イベントIDには0が設定されます。

一つの相関成立イベントの最大長は8,192バイトです。また，B.MESSAGEの最大長は1,023バイトです。最大長のバイト数には，空白を含み，改行コードは含みません。

属性名および属性値の間，またはSUCCESS_EVENT=相関成立イベントの両端に指定された空白（半角スペースとASCIIコード0x01〜0x1Fの文字）は無視されます（次の例の△部分）。

例：

△SUCCESS_EVENT△=△B.ID△:△1△

,（半角コンマ），空白を属性値として使用する場合は"（ダブルクォーテーション）で囲みます。

"（ダブルクォーテーション），¥（半角エンマーク）を指定する場合は直前に¥（半角エンマーク）を付け，「¥"」，「¥¥」とします。

特殊文字（^ $ . * + ? | ( ) { } [ ] ¥）を打ち消す場合は，「¥¥特殊文字」とします。

例えば，「$」を通常の文字として扱う場合は，「¥¥$」とします。また，¥（半角エンマーク）を通常の文字として扱う場合は「¥¥¥¥」とします。

属性値を省略すると，相関イベントの発行時に何も設定されません。ただし，属性名（B.ID）の属性値の記述を省略した場合は，0が設定されます。

変数 $EVn_属性名に設定値を続けて記述する場合は，変数のあとに空白（次の例に△で表記）を記述します。

例：

SUCCESS_EVENT=B.MESSAGE:"$EVn_B.ID△$EVn_B.TIME△・・・"

変数を使用する場合，一致する属性名がない場合は空白に置き換わります。また，相関イベントの発行時に変数を属性値に置き換えたことによって，属性値の最大長を超えた場合は相関イベントは発行されません。

拡張属性は94件まで指定できます。

FAIL_EVENT=相関不成立イベント

相関イベント発行条件が相関不成立になった場合に発行するJP1イベント(相関イベント)を定義します。1件の相関イベント発行条件に定義できる相関不成立イベントは一つだけです。相関不成立になる条件については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.3.6(2)　相関不成立の場合」を参照してください。

なお，相関イベント発行条件に「SUCCESS_EVENT=相関成立イベント」が定義されている場合，この定義を省略できます。省略した場合，相関イベント発行条件が不成立になっても，相関不成立イベントは発行されません。

相関不成立イベントは，相関成立イベントと同じ形式で記述します。「SUCCESS_EVENT=相関成立イベント」を参照してください。

(1) 同一属性値条件（SAME_ATTRIBUTE）に変数を使用する

同一属性値条件（SAME_ATTRIBUTE）に変数（$EVnまたは$EVn_ENVo）を使用する方法について説明します。

(a) 相関元イベントの属性値を同一属性値条件として使用する

相関元イベントの属性値を，同一属性値条件として使用する場合，変数 $EVn_属性名を使用します。形式を次に示します。

　SAME_ATTRIBUTE=$EVn_属性名

nにはイベント条件の条件ID（CID）に対応した値を指定します。指定できる条件IDの値の範囲は1〜999です。

属性名には，グルーピングのキーにしたい属性名を指定します。なお，指定できる属性名については，「表2-42　同一属性値条件に指定できる属性名の一覧」を参照してください。

例えば，WindowsログトラップのJP1イベント（イベントID：00003A71）と，JP1/AJSが発行したJP1イベント（イベントID：00004107）のように，ホスト情報が異なる属性値に入っているJP1イベントを関連づけ，ホストごとに相関イベントを発行したい場合，次のように定義します。

CON=CID:1,B.ID==3A71,E.A0==host1;host2
CON=CID:2,B.ID==4107,E.C0==host1;host2
          ：
SAME_ATTRIBUTE=$EV1_E.A0,$EV2_E.C0
          ：

(b) 相関元イベントの属性値の一部を同一属性値条件として使用する

相関元イベントの属性値の一部を切り出して，同一属性値条件として使用する場合，変数 $EVn_ENVoを使用します。形式を次に示します。

　SAME_ATTRIBUTE=$EVn_ENVo

$EVn_ENVoを指定する場合，イベント条件は正規表現（*=）で指定し，属性値の切り出したい部分を( )で囲みます。

nにはイベント条件の条件ID（CID）に対応した値を指定します。指定できる条件IDの値の範囲は1〜999です。

また，ENVoのoに切り出しの順番を指定します。切り出しの順番とは，イベント条件の右辺に記述されている( )を左から右に数えた値です。指定できる切り出しの順番の範囲は1〜9です。

イベント条件（CON）と$EVn_ENVoで切り出される部分の対応を次の図に示します。

図2‒2　イベント条件（CON）と$EVn_ENVoで切り出される部分の対応

一つのイベント条件（CON）に，正規表現を指定したイベント属性条件が複数ある場合も，左から右に" ( " を数え，切り出したい個所の順番をoに指定します。

例えば，相関元イベントのメッセージの一部にホスト名が入っていて，このホスト名が同一のイベントごとに相関イベントを発行したい場合は次のように定義します。

CON=CID:1, B.ID==1001, B.MESSAGE*=.*HOST=(.*¥¥))
TYPE=threshold:5
SAME_ATTRIBUTE=$EV1_ENV1
          ：

(2) 相関成立イベント（SUCCESS_EVENT）に変数を使用する

相関元イベントの属性値を相関イベントに引き継ぎたい場合，相関成立イベント（SUCCESS_EVENT）に変数を使用します。

(a) 相関元イベントの属性値を相関イベントの属性値に引き継ぐ

相関元イベントの属性値を，そのまま相関イベントの属性値に引き継ぐ場合，変数 $EVn_属性名を使用します。形式を次に示します。

　SUCCESS_EVENT=属性名:$EVn_属性名

nにはイベント条件で指定した条件ID（CID）を指定します。また，右側の属性名には，相関元イベントから引き継ぎたい属性を指定します。ただし，左側の属性名にイベントID(B.ID)を指定している場合は, 相関元イベントの属性値を引き継げません。

変数に指定できる属性名の一覧を次に示します。

表2‒44　変数に指定できる属性名の一覧

項番

属性名

項目

形式

1

B.SEQNO

イベントDB内通し番号

数値

2

B.ID

イベントID

基本部：拡張部の16進数

3

B.PROCESSID

発行元プロセスID

数値

4

B.TIME

登録時刻

YYYY/MM/DD hh:mm:ss※1

5

B.ARRIVEDTIME

到着時刻

YYYY/MM/DD hh:mm:ss※1

6

B.REASON

登録要因

文字列

7

B.USERID

発行元ユーザーID

数値

8

B.GROUPID

発行元グループID

数値

9

B.USERNAME

発行元ユーザー名

文字列

10

B.GROUPNAME

発行元グループ名

文字列

11

B.SOURCESERVER

発行元イベントサーバ名

文字列

12

B.DESTSERVER

送信先イベントサーバ名

文字列

13

B.SOURCESEQNO

発行元イベントDB内通し番号

数値

14

B.MESSAGE

メッセージ

文字列

15

E.SEVERITY

重要度

文字列

16

E.USER_NAME

ユーザー名

文字列

17

E.PRODUCT_NAME

プロダクト名

文字列

18

E.OBJECT_TYPE

オブジェクトタイプ

文字列

19

E.OBJECT_NAME

オブジェクト名

文字列

20

E.ROOT_OBJECT_TYPE

登録名タイプ

文字列

21

E.ROOT_OBJECT_NAME

登録名

文字列

22

E.OBJECT_ID

オブジェクトID

文字列

23

E.OCCURRENCE

事象種別

文字列

24

E.START_TIME

開始時刻

YYYY/MM/DD hh:mm:ss※1

25

E.END_TIME

終了時刻

YYYY/MM/DD hh:mm:ss※1

26

E.xxxxxx※2

上記以外の拡張属性

文字列

注※1

JP1イベントに入っているGMT時間をJP1/IM - Managerのタイムゾーンで変換した値になります。

注※2

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

相関元イベントの属性値の引き継ぎ例を次の図に示します。

図2‒3　変数を使用した場合の相関成立イベントへの引き継ぎ例

上記の例では，JP1/AJSおよびJP1/Baseの発行した重大度がエラーのJP1イベントを関連づけて，相関イベントを発行しています。

また，相関成立イベントは次のように定義されています。

相関イベントの重大度は，JP1/AJSの発行したJP1イベントの重大度を引き継ぐ。

相関イベントのメッセージは，JP1/AJSおよびJP1/Baseの発行したJP1イベントのメッセージを引き継ぐ。

(b) 相関元イベントの属性値を相関イベントの属性値に引き継ぐ（イベント相関タイプがしきい値の場合）

次にイベント相関タイプがしきい値の場合に，変数を使用して相関成立イベントを定義する方法について説明します。

イベント相関タイプがしきい値の場合，一つのイベント条件（CON）に複数のJP1イベントが一致します。例えば，次の図ような場合です。

図2‒4　イベント相関タイプがしきい値の場合の問題

上記の図に示したとおり，$EV1_B.MESSAGEに一致するJP1イベントが，イベント1，イベント2，およびイベント3の三つになってしまいます。三つのうちのどのJP1イベントのメッセージを引き継ぐかを指定する必要があります。

このため，次の形式で相関成立イベントを指定します。

　SUCCESS_EVENT=属性名:$EVn_m_属性名

nはこれまで説明してきたとおり，イベント条件で指定した条件ID（CID）を指定します。また，右側の属性名には，相関元イベントから引き継ぎたい属性を指定します。ただし，左側の属性名にイベントID(B.ID)を指定している場合は, 相関元イベントの属性値を引き継げません。

加えて，mには発行されたJP1イベント（相関元イベント）の処理順序を指定します。つまり，3番目に処理されたJP1イベントの属性値を引き継ぎたい場合，mに3を指定します。なお，mに指定した値が，しきい値（threshold:n）に指定した件数より大きい場合は定義不正になります。

イベント相関タイプがしきい値の場合の引き継ぎ例を次の図に示します。

図2‒5　イベント相関タイプがしきい値の場合の引き継ぎ例

属性名:$EVn_m_属性名のn，mはどちらも省略できます。n，mを省略した場合の引き継ぎについて，例を用いて説明します。

例1

メッセージにLogin errorを含むJP1イベントが3回発行された場合に相関元イベントのメッセージを引き継いだ相関イベントを発行する。

相関イベント発行定義ファイルの定義内容

[ex.1]

CON=CID:1,B.MESSAGE*="Login error"

TYPE=threshold:3

SUCCESS_EVENT=B.ID:A00,E.SEVERITY:Error,B.MESSAGE:設定値

表2‒45　満たしたい要件と設定値（例1の場合）

項番

満たしたい要件

設定値

1

1番目（最初）にイベント条件に合致したJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV1_1_B.MESSAGE，

または$EV_1_B.MESSAGE

2

2番目にイベント条件に合致したJP1イベントのメッセージを引き継ぐ。

$EV1_2_B.MESSAGE，

または$EV_2_B.MESSAGE

3

3番目（最後）にイベント条件に合致したJP1イベントのメッセージを引き継ぐ。

$EV1_3_B.MESSAGE，

$EV1_B.MESSAGE，

$EV_3_B.MESSAGE，

または$EV_B.MESSAGE

例2

次の条件のどれかに該当するJP1イベントが10回発行された場合に，相関元イベントのメッセージを引き継いだ相関イベントを発行する。

イベントIDが100で，メッセージにWarningを含む。

イベントIDが200で，メッセージにWarningまたはErrorを含む。

相関イベント発行定義ファイルの定義内容

[ex.2]

CON=CID:100,B.ID==100,B.MESSAGE*="Warning"

CON=CID:200,B.ID==200,B.MESSAGE*="Warning";"Error"

TYPE=threshold:10

SUCCESS_EVENT=B.ID:B00,E.SEVERITY:Error,B.MESSAGE:設定値

表2‒46　満たしたい要件と設定値（例2の場合）

項番

要件

設定値

1

イベント条件（条件ID：100）に1番目（最初）に合致したJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV100_1_B.MESSAGE

2

イベント条件（条件ID：100）に5番目に合致したJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV100_5_B.MESSAGE

3

イベント条件（条件ID：100）に10番目（最後）に合致したJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV100_10_B.MESSAGE

4

イベント条件に関係なく，1番目（最初）に処理されたJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV_1_B.MESSAGE

5

イベント条件に関係なく，5番目に処理されたJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV_5_B.MESSAGE

6

イベント条件に関係なく，10番目（最後）に処理されたJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV_10_B.MESSAGE，

または$EV_B.MESSAGE

まとめると次のようになります。

nを省略した場合

nを省略すると，イベント条件に関係なく，mに指定した相関元イベントの順番だけで判定されます。つまり，mに3を指定していれば，相関イベントには，3番目に処理された相関元イベントの属性値が引き継がれます。

mを省略した場合

mを省略すると，順番に関係なく，最後に処理された相関元イベントが対象になります。しきい値が10件であれば，10番目に処理された相関元イベントの属性値が引き継がれます。

同時にnを指定していれば，イベント条件で最後に処理された相関元イベントの属性値が引き継がれます。

nおよびmを省略した場合

nおよびmを省略すると，イベント条件および処理の順番に関係なく，最後に処理された相関元イベントが対象になります。

なお，n，mのどちらを指定した場合でも，条件に合う（引き継ぎ元の）JP1イベントがない場合は，変数の部分が空文字（0バイト）に置き換わります。

(c) 相関元イベントの属性値の一部を相関イベントの属性値に引き継ぐ

相関元イベントの属性値の一部を切り出して，相関イベントに引き継ぎたい場合，変数 $EVn_ENVoを指定します。また，イベント条件は正規表現（*=）で指定し，属性値の切り出したい部分を( )で囲みます。

相関成立イベントは次の形式で指定します。

　SUCCESS_EVENT=属性名:$EVn_ENVo

この場合，CIDで引き継ぎたい相関元イベントを指定し，nにCIDの値を指定します。また，ENVoのoに切り出した順番を指定します。属性値の一部を切り出した場合の引き継ぎ例を次の図に示します。

図2‒6　変数$EVn_ENVoを使用した場合の相関成立イベントへの引き継ぎ例

上記の例では，条件ID（CID）=1の条件および条件ID（CID）=2で指定した相関元イベントのErrorCode=の右辺を( )を使って切り出し，相関イベントのメッセージに引き継いでいます。

変数 $EVn_ENVoを使うと，属性値に特定の文字列を含む相関元イベントが発行された場合に相関イベントを発行し，かつ，属性値に含まれる文字列の一部を相関イベントに引き継ぐこともできます。

この場合，イベント条件に指定した正規表現(*=)のあとの" ( " が何番目かでENVoのoに番号を指定します。つまり，イベント条件の正規表現(*=)のあとに続く相関元イベントの属性値に対して，左から右に" ( " を数え，引き継ぎたい個所の順番をoに指定します。

$EVn_ENVoで切り出される部分については，同一属性値条件に$EVn_ENVoを指定した場合と同じです。詳細については，「図2-2　イベント条件（CON）と$EVn_ENVoで切り出される部分の対応」を参照してください。

属性値に特定の文字列を含む相関元イベントが発行された場合に相関イベントを発行し，かつ，属性値に含まれる文字列の一部を相関イベントに引き継ぐ例を次に示します。

図2‒7　属性値に含まれる特定の文字列の一部を相関イベントに引き継ぐ例

上記の例では，次に示す相関元イベントが発行された場合に，相関イベントにその属性値を引き継ぐよう定義しています。

host= のあとに「MANAGER_A」または「AGENT_A，B，Cのどれか」を含む。

ErrorCode= のあとに4文字以上の文字列を含む※。

注※

4文字を超える場合は，4文字までを引き継ぎます。

ErrorCode=12345678・・・の場合，「1234」となります。

4文字未満の場合は，ErrorCode= 文字列のあとに続く文字列を含んで4文字を引き継ぎます。

ErrorCode=1 2006/11/11・・・の場合，「1 20」となります。

なお，ErrorCode=のあとの文字列が4文字未満だった場合，相関イベントは発行されません。

定義例

定義例1：重大度がエラー以上のJP1イベントを相関イベントとして発行する場合

VERSION=2

#エラー以上のJP1イベントを相関イベントとして発行する
[filter_over_error]
CON=CID:1,B.ID==1,E.SEVERITY==Error;Critical;Alert;Emergency
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

定義例2：重大度がエラー以上のJP1イベント，およびJP1/AJSが発行した重大度がエラーのJP1イベントを相関イベントとして発行する場合

次のように設定した場合，JP1/AJSがエラーのJP1イベントを発行すると，相関イベント発行条件over_error，およびajs2_over_errorに一致するため，相関イベントは二つ発行されます。

VERSION=2

#エラー以上のJP1イベントを相関イベントとして発行する
[over_error]
CON=CID:1,E.SEVERITY==Error;Critical;Alert;Emergency
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

#JP1/AJS2のエラーのJP1イベントを相関イベントとして発行する
[ajs2_over_error]
CON=CID:1,E.SEVERITY==Error,E.PRODUCT_NAME==/HITACHI/JP1/AJS2
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

なお，JP1/AJSがエラーのJP1イベントを発行した場合に，相関イベントを1件だけ発行したい場合は，一つ目の相関イベント発行条件を次のように設定します。

VERSION=2

#エラー以上のJP1イベントを相関イベントとして発行する
#JP1/AJS2が発行したイベントは除外する
[over_error_and_not_ajs2]
CON=NOT,E.SEVERITY==Error,E.PRODUCT_NAME==/HITACHI/JP1/AJS2
CON=CID:1,E.SEVERITY==Error;Critical;Alert;Emergency
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

#JP1/AJS2のエラーのJP1イベントを相関イベントとして発行する
[ajs2_over_error]
CON=CID:1,E.SEVERITY==Error,E.PRODUCT_NAME==/HITACHI/JP1/AJS2
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

定義例3：タイムアウト時間を定義した場合

VERSION=2

[condition]
CON=NOT,E.SEVERITY==Error,E.PRODUCT_NAME==/HITACHI/JP1/AJS2

CON=CID:1,B.ID==1,B.MESSAGE==TEST,E.SEVERITY==Warning
CON=CID:2,B.ID==1,B.MESSAGE==TEST,E.SEVERITY==Error
CON=CID:3,B.ID==1,B.MESSAGE==TEST,E.SEVERITY==Critical

TIMEOUT=10
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

定義例4：JP1/AJS2およびJP1/Baseの発行したエラーのJP1イベントのメッセージをまとめて，1件の相関イベントとして発行する場合

VERSION=2

[cond1]

CON=CID:1,E.SEVERITY==Error,E.PRODUCT_NAME>=HITACHI/JP1/AJS2
CON=CID:5,E.SEVERITY==Error,E.PRODUCT_NAME>=HITACHI/JP1/Base

SUCCESS_EVENT=E.SEVERITY:$EV1_E.SEVERITY,B.MESSAGE:"$EV1_B.MESSAGE $EV5_B.MESSAGE"

定義例5：変数 $EVn_ENVoを使った切り出しの例

メッセージに含まれる詳細コード「error△code△=△n△」を相関イベントのメッセージに設定する場合（nは任意の文字列，△は半角スペース）

VERSION=2

[SAMPLE]

CON=CID:100, B.MESSAGE*=(error△code△=.*△)
SUCCESS_EVENT=B.ID:100,E.SEVERITY:Emergency,B.MESSAGE:エラー情報[$EV100_ENV1△]

定義例6：相関の対象範囲をホストで絞り込み，同時相関数を20としてユーザーごとに相関イベントを発行する場合

VERSION=2

[condition2]
TARGET=B.SOURCESERVER==host1;host2;host3
CON=NOT, E.SEVERITY==Error, E.PRODUCT_NAME==/HITACHI/JP1/AJS2

CON=CID:1, B.ID==1, B.MESSAGE==TEST, E.SEVERITY==Warning
CON=CID:2, B.ID==1, B.MESSAGE==TEST, E.SEVERITY==Error
CON=CID:3, B.ID==1, B.MESSAGE==TEST, E.SEVERITY==Critical

SAME_ATTRIBUTE=E.USERNAME
CORRELATION_NUM=20
TIMEOUT=10
SUCCESS_EVENT=B.MESSAGE:$EV1_B.MESSAGE

相関イベント発行環境定義ファイル

形式

[論理ホスト名¥JP1CONSOLEMANAGER¥EVGEN]
"OPERATION_LOG_SIZE"=dword:16進数値
"OPERATION_LOG_NUM"=dword:16進数値

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

相関イベント発行履歴ファイルのサイズ，面数を定義するファイルです。

このファイルを更新する場合，JP1/IM - Managerが管理するプロセスのすべてが定義情報を更新します。

定義の反映時期

jbssetcnfコマンドを実行して定義を共通定義情報に反映したあとに，JP1/IM - Managerを再起動，またはjco_spmd_reloadコマンドを実行することで有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER¥EVGEN]

JP1/IM - Managerの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"OPERATION_LOG_SIZE"=dword:16進数値

相関イベント発行履歴ファイルの1面当たりのファイルサイズを16進数で指定します。00010000〜06400000（64キロバイト〜100メガバイト）の範囲で指定できます。デフォルトは，00A00000です。

"OPERATION_LOG_NUM"=dword:16進数値

相関イベント発行履歴ファイルの面数を16進で指定します。00000003から00000064（3面〜100面）の範囲で指定できます。デフォルトは，00000003（3面）です。

相関イベント発行履歴ファイルのサイズ，面数の算出方法

相関イベント発行履歴ファイルのサイズ，面数の調整をする場合，1日で増加する相関イベント発行履歴ファイルのサイズを算出し，必要に応じて保存したい日数を掛けてください。調整する場合は，算出された値より少し大きめの値にしてください。

見積もりの詳細については，JP1/IM - Managerのリリースノートを参照してください。

インシデント手動登録定義ファイル（incident.conf）

形式

VERSION=バージョン情報
SS_MODE={1|2|3}

#コメント行
[SS_URL=http://JP1/Service Supportのホスト:ポート番号]

ファイル

incident.conf（インシデント手動登録定義ファイル）

incident.conf.model（インシデント手動登録定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥incident¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥incident¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/incident/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/incident/

説明

JP1/IM - ViewのJP1イベントをインシデントとして他製品に登録する定義ファイルです。

定義の反映時期

jco_spmd_reloadコマンドを実行したあと，またはJP1/IM - Managerを再起動したあと，JP1/IM - ViewでJP1/IM - Manager（セントラルコンソール）にログインすると，インシデント手動登録定義ファイルの設定が有効になります。

記述内容

VERSION=バージョン情報

インシデント手動登録定義ファイルのバージョンを指定します。バージョン情報には，2または3を指定してください。このパラメーターを省略した場合，または値を正しく指定しなかった場合は，SS_URLパラメーター，およびSS_MODEパラメーターは無視されます。なお，このパラメーターを複数指定した場合は，最後の行に指定したものが有効になります。

表2‒47　バージョン情報とインシデント手動登録定義ファイルで指定できるパラメーター一覧

バージョン情報

パラメーター名

2

SS_URL※

3

SS_URL

SS_MODE

注※

SS_MODE=1での動作となります。

SS_MODE={1|2|3}

インシデントの登録モードを指定します。このパラメーターを指定する場合は，VERSIONパラメーターに3を指定してください。VERSIONパラメーターに3が指定されていない場合，このパラメーターは無視されます。指定できる値は，1，2，または3です。インシデントの登録モードの説明と選択基準を次の表に示します。

表2‒48　インシデントの登録モードの説明と選択基準

インシデントの登録モード

説明

選択基準

JP1/IM - Manager，JP1/IM - View，JP1/Service Supportの対応バージョン

SS_MODE=1

引き継ぐ属性と引き継ぎ先は固定している。

JP1/IM - Manager 10-00以前と同じ仕様でJP1/Service Supportと連携する場合

09-50以降

SS_MODE=2

引き継ぐ属性と引き継ぎ先は固定している。

SS_MODE=1で引き継ぐ属性のほかにイベントID（B.IDBASE）が引き継がれる。

イベントIDを登録する場合

JP1/IM - Manager，JP1/Service Support，JP1/Navigation Platformで連携する場合

10-10以降

SS_MODE=3

引き継ぐ属性と引き継ぎ先の組合せを設定できる。

1件の引き継ぎ先に，複数の属性を引き継ぐことができる。

任意の文字列を引き継ぐことができる。

任意の属性や任意の文字列を登録する場合

JP1/IM - Manager，JP1/Service Support，JP1/Navigation Platformでの連携も可能

11-50以降

このパラメーターを省略した場合，または値を正しく指定しなかった場合は，1が仮定されます。なお，このパラメーターを複数指定した場合は，最後の行に指定したものが有効になります。

インシデントの登録モードを指定すると，インシデントとして登録される情報が変化します。インシデントの登録モードとインシデントとして登録される情報については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「9.1.1　JP1/Service Supportと連携する場合にインシデントとして登録できるJP1イベントの属性」を参照してください。

#コメント行

#で始まる行は，コメント扱いとなります。

[SS_URL=http://JP1/Service Supportのホスト:ポート番号]

インシデントを登録するJP1/Service SupportのWWWページのURLを半角英数字および記号で指定します。デフォルトは，「SS_URL=」となっていて，何も設定されていません。

JP1/Service Supportを呼び出す際のURLの最大長は2,046文字です。インシデントの登録モードを2に設定した場合，イベントIDを引き継ぐため，登録モードを1に設定した場合より，引き継げるメッセージが短くなります。メッセージが途中で切れている場合は，ユーザーが［イベント詳細］画面に表示されているメッセージをJP1/Service Supportにコピー&ペーストしてください。

なお，このパラメーターに記載したJP1/Service Supportのポート番号については，JP1/IM - ViewのマシンからJP1/Service Supportのマシンに対して，ファイアウォールを通過できるよう設定する必要があります。

なお，JP1/IM - Managerをバージョンアップ後にJP1/Service Supportと連携する場合は，この行を追加したあと，次の作業を実施してください。

バージョン情報を“2”または“3”に変更する。

イベントIDを登録する場合（SS_MODE=2），または任意のJP1イベントの属性や文字列をインシデントとして引き継ぐ場合（SS_MODE=3）は，SS_MODEの行を追加し登録モードを指定する。

IDM_URLで始まる行をコメント扱いに変更する（#を付ける）。

JP1/IM - Managerを再起動またはjco_spmd_reloadコマンドを実行して定義内容を反映する。JP1/IM - Viewにログインしている場合は，JP1/IM - Viewを再起動する。

インシデント引き継ぎ情報設定ファイル（incident_info.conf）

形式

[@encode UTF-8]
#item-field-ID=value-to-be-set-for-the-item
JP1/Service Supportの案件項目指定ID=案件項目に設定する値[改行文字]

ファイル

incident_info.conf（インシデント引き継ぎ情報設定ファイル）

incident_info.conf.model（インシデント引き継ぎ情報設定ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥incident¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥incident¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/incident/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/incident/

説明

任意のJP1イベントの属性や文字列をJP1/Service Supportにインシデントとして引き継ぐ場合に，JP1イベントの属性や文字列を，JP1/Service Supportの［案件作成］画面のどの案件項目に引き継ぐかを定義します。

定義の反映時期

インシデントの登録モードを3に設定し，jco_spmd_reloadコマンドを実行したあと，またはJP1/IM - Managerを再起動したあと，JP1/IM - ViewでJP1/IM - Manager（セントラルコンソール）にログインすると，インシデント引き継ぎ情報設定ファイルの設定が有効になります。

記述内容

[@encode UTF-8]

インシデント引き継ぎ情報設定ファイルで使用する文字コードを指定します。@encodeステートメントは必ず先頭行に指定します。@encodeステートメントを省略した場合，マネージャーの文字コードを仮定します。指定できる文字コードはUTF-8です。UTF-8を指定した場合，定義ファイルのエンコーディングはUTF-8になります。

次の場合は，エラーメッセージ（KAVB1115-W）を出力してマネージャーの文字コードを仮定します。

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

次の場合は，エラーメッセージ（KAVB1119-W）を出力してマネージャーの文字コードを仮定します。

UTF-8以外の文字コードを指定した場合

マネージャーの文字コードは次のとおりです。

Windowsの場合

システムロケールごとに次のとおりです。

日本語：MS932（ただし，使用できる文字はSJISコードの範囲です。）

英語：C

中国語：GB18030

日本語または中国語以外：C

UNIXの場合

/etc/opt/jp1cons/conf/jp1co_env.confファイルに記述する環境変数LANGの設定に依存します。

#コメント行

#で始まる行は，コメント扱いとなります。

JP1/Service Supportの案件項目指定ID=案件項目に設定する値[改行文字]

インシデントとして登録するJP1イベントの属性や文字列，およびその情報をJP1/Service Supportの［案件作成］画面のどの案件項目に引き継ぐかを指定します。

JP1/Service Supportの案件項目指定ID

JP1/Service Supportの案件項目指定IDを指定します。案件項目指定IDが重複した場合は，先に定義した内容が優先されます。案件項目指定IDについては，マニュアル「JP1/Service Support 構築・運用ガイド」を参照してください。

案件項目に設定する値[改行文字]

任意の文字列および変数を指定します。引き継ぐ変数は複数指定でき，数に制限はありません。

指定できる文字列は，制御文字以外の任意の文字列です。制御文字（0x00〜0x0F，0x14〜0x1F，0x7F）を指定した場合は，空白（0x20）に置き換えられます。「$」を文字として指定したい場合は，エスケープ文字「¥」を「$」の前に指定します。文字列に改行を入れる場合は，改行を「¥n」で指定します。「¥n」を文字として指定したいは，「¥¥n」と指定します。

変数の指定方法を次の表に示します。

表2‒49　変数の指定方法

形式

説明

$変数名

変数は，「$変数名」の形式で指定します。指定できるJP1イベントの属性値と対応する変数名は，「表2-51　JP1/Service Supportの案件項目に指定できる変数」を参照してください。

${変数名}

変数の直後に英数字および_（アンダーバー）を指定する場合は，変数名を｛｝で囲みます。

$変数名$URLENC

${変数名$URLENC}

属性値をUTF-8の文字列としてURLエンコードして展開します。

$変数名$ENC

${変数名$ENC}

属性値をBase64でエンコードして展開します。

$変数名$ENC$URLENC

${変数名$ENC$URLENC}

属性値をBase64でエンコード後，URLエンコードして展開します。

変数の指定例を次の表に示します。この例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

表2‒50　変数の指定例

指定例

変換後の情報

$EVID abc

100:0 abc

$EVIDabc

Windowsの場合

$EVIDabc

UNIXの場合

なし

${EVID}abc

100:0abc

$EVID_abc

Windowsの場合

$EVID_abc

UNIXの場合

なし

${EVID}_abc

100:0_abc

$EV"EX" abc

ABC abc

$EV"EX"abc

ABCabc

次の表に示す変数名を使用することで，任意の属性を引き継ぐことができます。なお，引き継ぎ個所は任意のため，引き継ぐ属性と引き継ぎ個所の表示の型の整合性がとれるように設定してください。

表2‒51　JP1/Service Supportの案件項目に指定できる変数

項目

引き継ぐ内容

変数名

イベント基本情報全体

イベント基本情報全体

EVBASE

イベントID（基本部:拡張部）

イベントID（基本コード:拡張コード）の値

基本コードはイベントID（B.ID），拡張コードはイベントID（拡張部）（B.IDEXT）の値。基本コードおよび拡張コードは，どちらも8桁の16進数（A〜Fは大文字），IDの前の0は省略する。拡張コードが00000000の場合，「基本コード:0」に変換する。

EVID

イベントID（基本部）

イベントID（基本コード）の値

8桁の16進数（A〜Fは大文字），IDの前の0は省略する。

EVIDBASE

イベント登録日

登録時刻（B.TIME）を「yyyy/mm/dd」形式にした文字列

EVDATE

イベント登録時刻（hh:mm:ss）

登録時刻（B.TIME）を「hh:mm:ss」形式にした文字列

EVTIME

発行元プロセスID

B.PROCESSIDの値

EVPID

発行元プロセスのユーザーID

B.USERIDの値

EVUSRID

発行元プロセスのグループID

B.GROUPIDの値

EVGRPID

発行元ユーザー名

B.USERNAMEの値

EVUSR

発行元グループ名

B.GROUPNAMEの値

EVGRP

発行元イベントサーバ名

B.SOURCESERVERの値

発生元ホストマッピングが無効の場合だけ

EVHOST

発行元IPアドレス

B.SOURCEIPADDRの値

EVIPADDR

イベントDB内通し番号

B.SEQNOの値

EVSEQNO

イベント到着日

到着時刻（B.ARRIVEDTIME）を「yyyy/mm/dd」形式にした文字列

EVARVDATE

イベント到着時刻

到着時刻（B.ARRIVEDTIME）を「hh:mm:ss」形式にした文字列

EVARVTIME

発生元のイベントDB内通し番号

B.SOURCESEQNOの値

EVSRCNO

メッセージ

B.MESSAGEの値

EVMSG

詳細情報

詳細情報（B.DETAIL）を「情報1△情報2△情報3△…情報n△」形式にした文字列

△：半角スペース

EVDETAIL

重大度

E.SEVERITYの値

EVSEV

ユーザー名

E.USER_NAMEの値

EVUSNAM

オブジェクトタイプ

E.OBJECT_TYPEの値

EVOBTYP

オブジェクト名

E.OBJECT_NAMEの値

EVOBNAM

登録名タイプ

E.ROOT_OBJECT_TYPEの値

EVROBTYP

登録名

E.ROOT_OBJECT_NAMEの値

EVROBNAM

プロダクト名

E.PRODUCT_NAMEの値

EV"PRODUCT_NAME"

オブジェクトID

E.OBJECT_IDの値

EV"OBJECT_ID"

事象種別

E.OCCURRENCEの値

EV"OCCURRENCE"

開始時刻

E.START_TIMEの値

EV"START_TIME"

終了時刻

E.END_TIMEの値

EV"END_TIME"

終了コード

E.RESULT_CODEの値

EV"RESULT_CODE"

発生元ホスト名

E.JP1_SOURCEHOSTの値

発生元ホストマッピングが有効の場合だけ

EV"JP1_SOURCEHOST"

任意の拡張属性

拡張属性名で指定された属性の属性値

EV"拡張属性名"

相関イベントフラグ

E.@JP1IM_CORRELATEの値

相関イベントではない：0

相関成立イベント：1

相関不成立イベント：2

相関イベント発行機能が有効で，かつ統合監視DBが有効な場合だけ

EV"@JP1IM_CORRELATE"

変更前の重大度

E.@JP1IM_ORIGINAL_SEVERITYの値

重大度変更機能が有効な場合だけ

EV"@JP1IM_ORIGINAL_SEVERITY"

重大度変更フラグ

E.@JP1IM_CHANGE_SEVERITYの値

重大度を変更していない：0

重大度を変更した：1

重大度変更機能が有効な場合だけ

EV"@JP1IM_CHANGE_SEVERITY"

変更後のメッセージ

E.@JP1IM_DISPLAY_MESSAGEの値

表示メッセージ変更機能が有効な場合だけ

EV"@JP1IM_DISPLAY_MESSAGE"

表示メッセージ変更フラグ

E.@JP1IM_CHANGE_MESSAGEの値

メッセージを変更していない：0

メッセージを変更した：1

表示メッセージ変更機能が有効な場合だけ

EV"@JP1IM_CHANGE_MESSAGE"

メモ

E.@JP1IM_MEMOの値

メモを設定したあとに設定される属性

EV"@JP1IM_MEMO"

共通除外条件群ID

E.JP1_IMCOMEXCLUDE_IDの値

共通除外の拡張モードが有効で，かつ統合監視DBが有効な場合だけ

EV"JP1_IMCOMEXCLUDE_ID"

共通除外条件群名

E.JP1_IMCOMEXCLUDE_NAMEの値

共通除外の拡張モードが有効で，かつ統合監視DBが有効な場合だけ

EV"JP1_IMCOMEXCLUDE_NAME"

共通除外条件群除外対象

E.JP1_IMCOMEXCLUDE_TARGETの値

共通除外の拡張モードが有効で，かつ統合監視DBが有効な場合だけ

EV"JP1_IMCOMEXCLUDE_TARGET"

表に示す変数名以外が指定された場合，変数が記述されている個所はイベント引き継ぎ情報に変換しません。例えば，変数名「AAA」を「$AAA」として指定した場合，JP1/Service Supportの［案件作成］画面には「$AAA」が引き継がれます。

EV"拡張属性名"で指定された属性の値が取得できなかった場合，変数が記述されている個所はイベント引き継ぎ情報に変換しません。例えば，「$EV"BBB"」と指定しているとき，JP1イベントに拡張属性「BBB」がない場合，JP1/Service Supportの［案件作成］画面には「$EV"BBB"」が引き継がれます。

EV"拡張属性名"以外の変数で指定された属性の値が取得できなかった場合，変数が記述されている個所は空文字に変換します。例えば，「$EVSEV」を指定しているとき，JP1イベントに拡張属性「SEVERITY」がなければ，JP1/Service Supportの［案件作成］画面には「」（空文字）が引き継がれます。

定義例

JP1/Service Supportの［案件作成］画面のタイトル項目に，「発生元ホスト（IPアドレス）で発生したイベント：イベントID」と表示する場合（発生元ホストマッピングが有効のとき）

TITLE=$EV"JP1_SOURCEHOST"($EVIPADDR)で発生したイベント：$EVIDBASE

JP1/Service Supportの［案件作成］画面の関連情報項目に，URLリンクを表示する（属性値をUTF-8の文字列としてURLエンコードする）場合

LINKURL=http://host/page?msg=$EVMSG$URLENC

ホスト情報ファイル（jcs_hosts）

形式

IPアドレス ホスト名1 ホスト名2 ホスト名3 ... ホスト名8
IPアドレス ホスト名1 ホスト名2 ホスト名3 ... ホスト名8
              :

ファイル

jcs_hosts（ホスト情報ファイル）

jcs_hosts.model（ホスト情報ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

JP1/IM - Manager（セントラルスコープ）が管理するホスト情報を定義するファイルです。

ホスト情報ファイルは，監視ツリーの自動生成，および監視オブジェクトの状態を変更するJP1イベント照合処理の際のホスト名比較に使用するホスト情報を記述するファイルです。なお，ホスト情報ファイルの形式は，hostsファイルと同じです。

#を指定した場合，#以降は改行されるまでコメント扱いとなります。

定義の反映時期

ホスト情報ファイルの内容は，jcshostsimportコマンド実行後，JP1/IM - Managerを再起動，またはjco_spmd_reloadコマンドを実行することで有効になります。

jcshostsimportコマンドでホスト情報ファイルの内容をホスト情報DBに格納すると，ホスト名はすべて小文字になります。そのため，jcshostsexportで出力するホスト情報のホスト名も，すべて小文字になります。

jcshostsimportコマンドでは，ホスト情報ファイルのコメントは格納されません。

記述内容

IPアドレス ホスト名1 ホスト名2 ホスト名3 ... ホスト名8

空白を除く行の先頭にIPアドレスを記述し，複数の空白またはタブのあとにホスト名，エイリアス名を記述します。

IPアドレスの文字数は，最大63バイトです。IPv6アドレス形式のIPアドレスには対応していません。

ホスト名，エイリアス名の文字数は，一つにつき最大255バイトです。

一つのIPアドレスに対し，最大八つホスト名を記述できます。また，一つのホスト名に対し，指定できるIPアドレスの数は最大八つです。

同じIPアドレスの記述が複数存在した場合は，最初の定義が有効になります。

IPアドレスだけを指定した行がある場合はjcshostsimportコマンド実行時にエラーとなります。

ホスト名の大文字・小文字は区別されません。ホスト名には，日本語を使用できません。IPアドレスは，16進数表記でも記述できます。

定義例

#
# jcs_hosts
#
# Internet Address Hostname
100.100.10.10     samplehost1  samplehost2

ガイド情報ファイル（jcs_guide_xxx.txt）

形式1

DESC_VERSION=1

[EV_GUIDE_数字]
NUM=数字
EV_COMP_数字=属性指定:正規表現
EV_TITLE=文字列
EV_GUIDE=メッセージ
[END]
[EV_GUIDE_数字]
NUM=数字
EV_COMP_数字=属性指定:正規表現
EV_TITLE=文字列
EV_GUIDE=メッセージ
[END]
   :

形式2

DESC_VERSION=2

[EV_GUIDE_数字]
NUM=数字
EV_COMP_数字=属性指定:正規表現
EV_TITLE=文字列
EV_FILE=ガイドメッセージファイル
[END]
[EV_GUIDE_数字]
NUM=数字
EV_COMP_数字=属性指定:正規表現
EV_TITLE=文字列
EV_FILE=ガイドメッセージファイル
[END]
   :

ファイル

ガイド情報ファイル（jcs_guide_xxx.txt）は，JP1/IMの動作する言語コードによって，編集するファイルが異なります。JP1/IMの動作する言語コードと，編集するガイド情報ファイルの対応を次の表に示します。

表2‒52　JP1/IMの動作する言語コードとガイド情報ファイルの対応

OS

言語種別

JP1/IMの動作する言語コード

編集するファイル

Windows

日本語

jcs_guide_sjis.txt（ガイド情報ファイル）

jcs_guide_sjis.txt.model

（ガイド情報ファイルのモデルファイル）

英語

jcs_guide.txt（ガイド情報ファイル）

jcs_guide.txt.model（ガイド情報ファイルのモデルファイル）

中国語

jcs_guide_GB18030.txt（ガイド情報ファイル）

UNIX※

日本語

シフトJISコード

jcs_guide_sjis.txt（ガイド情報ファイル）

jcs_guide_sjis.txt.model

（ガイド情報ファイルのモデルファイル）

EUCコード

jcs_guide_euc.txt（ガイド情報ファイル）

jcs_guide_euc.txt.model

（ガイド情報ファイルのモデルファイル）

UTF-8コード

/etc/opt/jp1scope/conf/jcs_guide_UTF-8.txt

共有ディレクトリ/jp1scope/conf/jcs_guide_UTF-8.txt

英語

jcs_guide.txt（ガイド情報ファイル）

jcs_guide.txt.model

（ガイド情報ファイルのモデルファイル）

中国語

GB18030コード

jcs_guide_GB18030.txt（ガイド情報ファイル）

注※　OSがサポートしている言語と対応するファイルだけが存在します。

言語コードに対応したガイド情報ファイルを使用してください。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

監視オブジェクトの状態変更の契機となったJP1イベントに関するガイド情報を定義するファイルです。

このファイルで記述した内容は，JP1/IM - Viewの［ガイド］画面に表示されます。

ガイド情報ファイルの最大サイズは，1メガバイトです。

形式2は，ユーザーによって作成されたTXT形式またはHTML形式のファイルをガイドメッセージファイルとして読み込んで［ガイド］画面に表示させる場合に，記述する方法です。

複数のガイド情報が一致する場合，ガイド情報ファイルで先に記述してある情報が有効になります。

Windowsの場合，07-00のJP1/IM - Manager（セントラルスコープ）のガイド情報ファイルは，08-00以降のJP1/IM - Managerでも読み込めます。

Windowsの場合，08-00以降のJP1/IM - Managerのガイド情報ファイルは，07-00のJP1/IM - Manager（セントラルスコープ）でも読み込むことはできますが，DESC_VERSION=2のEV_FILE=ガイドメッセージファイルの記述は無視され，EV_GUIDE=メッセージの記述が優先されます。両方の記述がない場合はエラーとなります。

#を指定した場合，#以降は改行されるまでコメント扱いとなります。ただし，開始タグ，属性情報，終了タグの後方にコメントを記述できません。開始タグと終了タグの後方にコメントを記述した場合は，エラーとなります。また，属性値の後方にコメントを書いた場合は，属性値の一部として認識されます。

¥を記述する場合，¥¥と記述する必要があります。¥nおよび¥$以外に¥を記述していた場合はログが出力され，¥を記述した行を無視して処理します。

定義の反映時期

ガイド情報ファイル編集後，JP1/IM - Managerを再起動，またはjco_spmd_reloadコマンドを実行することで有効になります。

記述内容

DESC_VERSION=1 | 2

ガイド情報ファイルのバージョンを表しています。指定できる値は1または2です。

EV_FILEパラメーターを指定してガイドメッセージファイル呼び出す場合は，値を2にする必要があります。

DESC_VERSION=1でEV_GUIDE=メッセージとEV_FILE=ガイドメッセージファイルを同時に指定した場合，EV_FILE=ガイドメッセージファイルの記述は無視されます。

DESC_VERSION=2でEV_GUIDE=メッセージとEV_FILE=ガイドメッセージファイルを同時に指定した場合，EV_FILE=ガイドメッセージファイルの記述が優先されます。

[EV_GUIDE_数字]

ガイド情報の開始タグです。[EV_GUIDE_数字]〜[END]で一つの定義ブロックとなります。このパラメーターと[END]の間に［ガイド］画面への表示対象となるJP1イベントの条件および表示するメッセージを記述します。数字は，1からガイドの数だけ1ずつ増加します。

EV_GUIDE_数字タグ内の文字列は一意にしてください。不正な文字列がある場合はログが出力され，該当個所を無視して処理します。

EV_GUIDE_数字タグ内に記述できる属性以外が記述されている場合は，該当個所を無視して処理します。

NUM=数字

数字には，EV_COMP_数字のエントリー数を記述します。

EV_COMP_数字=属性指定:正規表現

このパラメーターは，比較する属性の数だけ記述します。数字は，1から1ずつ増加します。複数記述した場合は，AND条件が成立すると，EV_GUIDEパラメーターで記述したメッセージを［ガイド］画面に表示します。

EV_COMP_数字の数字は，NUMで指定された範囲内の数字(1〜NUM)でない場合は，無視されます。

イベントIDは8けた表記で記述してください。なお，EV_COMP_数字の属性指定にB.IDと記述し，一致条件にイベントIDの基本部だけを指定する場合，拡張部の記述を省略できます。

例

EV_COMP_1=B.ID:00004107:00000000またはEV_COMP_1=B.ID:00004107

属性指定

次の属性を指定できます。

・JP1イベントの基本属性：指定する場合「B.属性名」と指定します。

・JP1イベントの拡張属性：指定する場合「E.属性名」と指定します。

・監視ノードの属性：指定する場合「T.MONNODEID」(監視ノードID)を指定できます（監視ノードIDは，16進数8桁で指定してください）。

正規表現

属性指定で指定した属性の内容を正規表現で記述します。正規表現には拡張正規表現を使用します。正規表現の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

EV_TITLE=文字列

文字列には，［ガイド］画面のタイトルに表示される文字列を記述します。このパラメーターは，[EV_GUIDE_数字]と[END]の間に一つしか記述できません。

EV_GUIDE=メッセージ

メッセージには，［ガイド］画面のガイドメッセージに表示される文字列を記述します。HTMLタグを記述すれば，［ガイド］画面に表示されるガイドメッセージをHTML形式で表示できます（記述できるHTMLタグはEV_FILEの説明文にある「表2-53　ガイドメッセージとして使用できるHTMLタグ」を参照のこと）。このパラメーターは，[EV_GUIDE_数字]と[END]の間に一つしか記述できません。

また，文字数は10,240バイト以内にしてください。10,241バイト以上記述した場合，10,241バイト以降のメッセージは，［ガイド］画面に表示されません。

なお，メッセージ中に¥を記述する場合は¥¥，$を記述する場合は¥$と記述します。メッセージ中に$B.属性名△，$E.属性名△を指定した場合，JP1イベントの属性名に対応する属性値がメッセージとして展開されます（△は半角スペースを表す）。また，$T.MONNODEID△を指定した場合は，監視ノードIDに置き換えられます（△は半角スペースを表す）。対応する属性が存在しない場合は，空に置き換えられます。

メッセージに改行を入れる場合は，¥nと指定します。

EV_FILE=ガイドメッセージファイル

ガイドメッセージファイルには，［ガイド］画面に表示されるガイドメッセージの内容を記述したファイルの名称をフルパスまたは相対パス（起点はScopeパス¥conf¥guide¥，または/etc/opt/jp1scope/conf/guide/）で指定します。このパラメーターは，[EV_GUIDE_数字]と[END]の間に一つしか記述できません。

ファイル名は，パスを含めて1,024バイト以内の文字数にしてください。1,024バイトを超えた場合，JP1/IM - Managerの起動時またはJP1/IM - Viewからのガイドメッセージファイル呼び出し時にエラーとなります。

また，このパラメーターを指定する場合は，DESC_VERSIONの値を2にしてください。

ガイドメッセージファイルとして指定できるファイルの名称，拡張子はユーザー任意です。なお，ファイル名称にはご利用元で管理しやすい名称を，拡張子は表示するガイドメッセージがTXT形式であれば.txtを，HTML形式であれば.html，.htmを使用することをお勧めします。

（例）guide001_AJS2.txt，またはguide001_AJS2.htm

ガイドメッセージファイル

ガイドメッセージファイルには，［ガイド］画面から表示させたい情報をTXT形式またはHTML形式で記述します。記述できる内容は，ガイド情報ファイルのEV_GUIDEで記述できる内容と同じです。なお，ガイドメッセージファイルの場合，改行を挿入して体裁を整えることもできます。

ガイドメッセージファイルに記述されている内容および構文チェックはしません。

作成したガイドメッセージファイルは，任意のフォルダに格納できますが，クラスタ構成の場合にシステムのフェールオーバーに対応するためには次のフォルダに格納することを推奨します。

・Windowsの場合

共有フォルダ¥jp1scope¥conf¥guide¥

・UNIXの場合

共有ディレクトリ/jp1scope/conf/guide/

ガイドメッセージファイルの最大サイズは，1メガバイトです。1メガバイトを超えた場合，JP1/IM - Viewの［ガイド］画面からのガイドメッセージファイル読み込み時にエラーとなります。

HTML形式のガイドメッセージファイルを作成する場合に使用できるHTMLタグおよび属性を次に示します。

表2‒53　ガイドメッセージとして使用できるHTMLタグ

タグ

属性

説明

HTML

−

HTML文章であることを宣言します。このタグは必須です。

HEAD

−

HTML文章のヘッダーを宣言します。

このタグは必須です。

BODY

−

HTML文章の本文を宣言します。

このタグは必須です。

A

HREF="URL"

リンク先URLを指定します。相対パスおよび「mailto:」で始まるURLは動作保証されません。

ここで指定したリンクは［ガイド］画面（HTML形式）に表示されます。クリックするとWWWブラウザーが起動し，指定したURLにアクセスできます。

H1，H2，H3，H4，H5，H6

−

見出しを指定します。

FONT

SIZE="文字サイズ"

文字サイズを指定します。指定できる値は1〜7です。

COLOR="文字色"

文字色を指定します。指定できる色は次の16色です。

black，silver，gray，white，maroon，red，purple，fuchsia，green，lime，olive，yellow，navy，blue，teal，aqua

これ以外の文字色は動作保証されません。

B

−

文字を太字にします。

I

−

文字を斜体にします。

HR

−

けい線を引きます。

BR

−

強制的に改行します。

（凡例）　−：なし

なお，このほかのHTMLタグについては動作保証していません。

[END]

ガイド情報の終了タグです。

定義例

# JP1/IM-CS Guide Information File.

DESC_VERSION=1
[EV_GUIDE_1]
NUM=2
EV_TITLE=JP1/AJS2　業務Aの異常終了
EV_COMP_1=T.MONNODEID:0000000A
EV_COMP_2=B.ID:00000111
EV_GUIDE=業務Aが異常終了しました。$E.C0 のホストで異常が発生していないか確認してください。
[END]
[EV_GUIDE_2]
NUM=1
EV_COMP_1=B.ID:00004107
EV_GUIDE=ジョブが異常終了しました。$E.C0 のホストで異常が発生していないか確認してください。¥n以前の障害例として，ホストAではメモリ不足によりジョブが失敗した事があります。vmstatコマンドでメモリ空き容量を確認してください。
[END]

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）

形式

[論理ホスト名¥JP1SCOPE¥BMS¥EVHISTORY]
"EVHIST_WARN_EVENT"=dword:値

ファイル

evhist_warn_event_on.conf（状態変更イベント件数の上限監視を有効にする場合に使用します）

evhist_warn_event_off.conf（状態変更イベント件数の上限監視を無効にする場合に使用します）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

状態変更イベントの件数が上限（100件）を超えた場合に，JP1イベントの発行を有効にするかどうかを設定するファイルです。

有効にした場合は，監視オブジェクトの状態変更イベントが100件を超えたときに，JP1イベントを発行します。発行されるJP1イベントは，イベントIDが3FB1の警告イベントです。

JP1/IM - Managerを新規インストールした場合は，有効（JP1イベントを発行する）になっています。バージョンアップ時は，バージョンアップ前に設定を無効にしていた場合は，無効（JP1イベントを発行しない）になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS¥EVHISTORY]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"EVHIST_WARN_EVENT"=dword:値

evhist_warn_event_on.confは，値が「00000001」です（イベントIDが3FB1のJP1イベントが発行される）。

evhist_warn_event_off.confは，値が「00000000」です（イベントIDが3FB1のJP1イベントが発行されない）。

このパラメーターは編集しないでください。

JP1イベントの詳細については，「3.2.2　JP1イベントの詳細」を参照してください。

対処済み連動設定ファイル（action_complete_xxx.conf）

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"ACTION_COMPLETE_MODE"=dword:値

ファイル

action_complete_on.conf（対処済み連動機能を有効にする場合に使用します）

action_complete_off.conf（対処済み連動機能を無効にする場合に使用します）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

対処済み連動機能を有効にするかどうかを設定するファイルです。

有効にした場合は，セントラルコンソールでのJP1イベントの対処状況に連動して，セントラルスコープの監視オブジェクトの状態が変わります。

JP1/IM - Managerを新規インストールした場合は，有効になっています。バージョンアップ時は，バージョンアップ前に設定を無効にしていた場合は，無効になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"ACTION_COMPLETE_MODE"=dword:値

action_complete_on.confは，値が「00000001」です。

action_complete_off.confは，値が「00000000」です。

このパラメーターは編集しないでください。

状態変更イベント自動削除設定ファイル

形式

[論理ホスト名¥JP1SCOPE¥BMS¥EVHISTORY]
"EVPROCESSED_MODE"=dword:値

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

JP1イベントの対処状況を「対処済」にしたときに，状態変更イベントを自動で削除する機能を有効にするための定義ファイルです。

JP1/IM - Managerを新規インストールした場合は，無効になっています。バージョンアップ時は，バージョンアップ前に設定を有効にしていた場合は，有効になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS¥EVHISTORY]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"EVPROCESSED_MODE"=dword:値

状態変更イベントの自動削除機能を有効にする場合は「1」を，無効にする場合は「0」を指定します。

監視オブジェクト初期化設定ファイル

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"AUTO_INITIALIZE_MODE"=dword:値

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

特定のJP1イベントを受信したときに，監視オブジェクトを自動で初期化する機能を有効にするための定義ファイルです。

JP1/IM - Managerを新規インストールした場合は，無効になっています。バージョンアップ時は，バージョンアップ前に設定を有効にしていた場合は，有効になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"AUTO_INITIALIZE_MODE"=dword:値

監視オブジェクトの自動初期化機能を有効にする場合は「1」を，無効にする場合は「0」を指定します。

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"AUTO_DB_BACKUP_RECOVERY"=dword:値

ファイル

auto_dbbackup_on.conf（監視オブジェクトDBのバックアップ・リカバリーを有効にする場合に使用します）

auto_dbbackup_off.conf（監視オブジェクトDBのバックアップ・リカバリーを無効にする場合に使用します）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

監視ツリー更新中の，OSのシャットダウンやクラスタシステムの系切り替え発生による，監視オブジェクトDBの破損を防ぐための機能（監視オブジェクトDBの自動バックアップ・リカバリー機能）を有効にするかどうかを設定するファイルです。

有効にした場合は，監視ツリー更新時に更新前の監視オブジェクトDBをバックアップし，障害発生時には，バックアップした監視オブジェクトDBをリカバリーします（障害の発生なしで更新処理が終了した場合には，バックアップデータは自動的に削除されます）。

JP1/IM - Managerを新規インストールした場合は，デフォルトで有効になっています。バージョンアップした場合には，従来の設定を引き継ぎます。

なお，クラスタ運用している場合は，必ず有効に設定してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"AUTO_DB_BACKUP_RECOVERY"=dword:値

auto_dbbackup_on.confは，値が「00000001」です。

auto_dbbackup_off.confは，値が「00000000」です。

このパラメーターは編集しないでください。

記述例

論理ホストHostAのJP1/IM - Managerに対し，監視オブジェクトDBの自動バック・リカバリー機能を有効にします。

[HostA¥JP1SCOPE¥BMS¥JCSDB]"AUTO_DB_BACKUP_RECOVERY"=dword:00000001

オブジェクトタイプ定義ファイル

形式

@encode 文字コード
[コメント]
[ObjectType]
定義ブロック [コメント]
[End]
[コメント]

ファイル

会社名_製品名_会社名_製品名_obj.ja（オブジェクトタイプ定義ファイル）

なお，「製品名」は，「シリーズ名_製品名」とすることもできます。JP1イベント発行時の「PRODUCT_NAME」に指定する値の「/」を「_」に変更してファイル名に使用することをお勧めします。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥object_type¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥object_type¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/object_type/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/object_type/

説明

オブジェクトタイプ定義ファイルは，次に示すJP1/IM - Viewの画面の［オブジェクトタイプ］および［登録名タイプ］に表示するオブジェクトタイプおよび登録名タイプを設定します。

［重要イベント定義］画面

［イベント取得条件設定］画面

［共通除外条件設定］画面

［共通除外条件設定(拡張)］画面

［繰り返しイベント条件設定］画面

［イベント検索条件設定］画面

［表示フィルター設定］画面

［ユーザーフィルター詳細設定］画面

［アクション詳細設定］画面

［重大度変更定義設定］画面（［追加重大度変更定義設定］画面）

［表示メッセージ変更定義設定］画面（［追加表示メッセージ変更定義設定］画面）

この定義ファイルは，Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCコードで定義する必要があります。

複数のファイルに同一のオブジェクトタイプが存在した場合の動作は保証されません。

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

@encode 文字コード

オブジェクトタイプ定義ファイルで使用する文字コードを指定します。

オブジェクトタイプ定義ファイルを追加で作成する場合は，@encodeステートメントで定義ファイルの文字コードを指定してください。

項目名には，@encodeステートメントに指定した文字コードで表現できる文字を記載します。また，オブジェクトタイプ定義ファイルは，@encodeステートメントに指定した文字コードで保存します。

次の場合，JP1/IM - Viewに表示される項目名が文字化けすることがあります。

項目名に，@encodeステートメントに指定した文字コードで表現できない文字を使用した場合

@encodeステートメントに指定した文字コード，ファイルを保存した文字コード，および@encodeステートメントに指定した文字コードが不一致の場合

@encodeステートメントが存在しない場合，および@encodeステートメントのあとに指定した文字コードに誤りがある場合は，文字コードが自動判別されます。ただし，定義ファイルの内容によっては正しく判別できないおそれがあります。

指定できる文字コードは次のとおりです。

C

EUCJIS

SJIS

UTF-8

GB18030

注意事項

定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

次の場合，エラーが出力されます。

C，EUCJIS，SJIS，UTF-8，およびGB18030以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

[コメント]

コメントは，「#」で開始する改行を含まない文字列です。

[ObjectType]

「[ObjectType]」および「[End]」は「[」および「]」を含めてそのまま記述します。

定義ブロック [コメント]

定義ブロックは，拡張属性値とリスト表示文字列で構成されます。拡張属性値は，オブジェクトタイプまたは登録名タイプに格納される文字列です。リスト表示文字列は，ドロップダウンリストに一覧表示する文字列です。

[End]

「[End]」は「[」および「]」を含めてそのまま記述します。

なお，定義する際には次の内容に注意してください。

オブジェクトタイプ（拡張属性値）に空白を入れることはできません。

リスト表示文字列には，日本語ではなく拡張属性値そのものを記述してください。

定義例

オブジェクトタイプ定義ファイルの定義例を次に示します。

@encode UTF-8
[ObjectType]
# 拡張属性値,  リスト表示文字列   コメント
ACTION,        ACTION          // アクション
ACTIONFLOW,    ACTIONFLOW      // アクションフロー
BATCHQUEUE,    BATCHQUEUE      // バッチキュー
JOB,           JOB             // ジョブ
JOBNET,        JOBNET          // ジョブネット
MEDIA,         MEDIA           // メディア
PRINTER,       PRINTER         // プリンタ
PRINTJOB,      PRINTJOB        // プリントジョブ
PRINTQUEUE,    PRINTQUEUE      // パイプキュー
PROCESS,       PROCESS         // プロセス
RESTORE,       RESTORE         // リストア
[End]

アプリケーション実行定義ファイル

形式

@file type="定義ファイルタイプ", version="定義フォーマットバージョン";
#コメント行
@define-block type="application-execution-def";
id="アプリケーション実行定義識別子";
path="コマンドパス";
description="アプリケーション実行の説明文";
@define-block-end;

ファイル

!JP1_CC_APP0.conf（アプリケーション実行定義ファイル）

!JP1_CC_APP0.conf.model（アプリケーション実行定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥appexecute¥ja¥

説明

アプリケーション実行定義ファイルは，［イベントコンソール］画面から起動するアプリケーションなどの実行形式ファイルのIDとパスを定義するファイルです。

なお，JP1/IMには，アプリケーション実行定義ファイルの記述内容をチェックするためのコマンド「jcoappexecfcheck」が用意されています。このコマンドの詳細については，「jcoappexecfcheck（Windows限定）」（1.　コマンド）を参照してください。

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

@file type="application-execution-definition";

この定義ファイルがアプリケーション実行定義ファイルであることを宣言します。このステートメントは必須です。

このステートメントは，ファイルの先頭行に記述しなければなりません。

#コメント行

#で始まる行は，コメント扱いとなります。

アプリケーション実行定義ブロック

［イベントコンソール］画面から起動するアプリケーションなどの実行形式ファイルのパスを定義し，ほかの定義ファイルからリンクするためのID付けをします。

このブロックには次のステートメントを記述できます。

idステートメント

pathステートメント

descriptionステートメント

これ以外のステートメントが記述された場合は，エラー出力し，該当するステートメントだけを無視されます。

次にステートメントについて説明します。

id="アプリケーション実行定義識別子";

このブロックで指定するコマンドパスにIDを付けます。このステートメントは必須です。このステートメントは，ブロック内で1回だけ記述できます。

同一のidを持つブロックが解析対象のファイル内に複数個存在した場合，次の順に優先順位が決定され，最優先のブロックが有効になります。

1. ファイル名を昇順でソートしてあとの方のブロック

2. ファイル内の位置があとの方のブロック

それ以外のブロックは無効になります。

アプリケーション実行定義識別子は，32バイト以内の半角英数字で構成される文字列です。この文字列は定義内でユニークでなければなりません。ユニーク性を保持するために，次の命名規則に従ってください。

会社名_製品名[_機能名(または画面名)]

「"jco_"」で始まる文字列，および「"default_browser"」は，アプリケーション実行定義識別子として予約されているため，使用できません。

path="コマンドパス";

idステートメントで指定したアプリケーション実行定義識別子と関連づける実行形式ファイルのパスを定義します。このステートメントは必須です。このステートメントは，同一ブロック中に複数個指定できます。起動する実行形式ファイルは，フルパスで指定します。後述の置き換えキーワードを使用して，レジストリーなどからパスを組み立てることもできます。

このステートメントを複数個指定した場合は，記述順にパスが検索され，最初に見つかったパスが使用されます。

pathステートメントで指定できる実行形式ファイルは，.exeまたは.batファイルです。

コマンド実行時のカレントディレクトリは不定です。カレントディレクトリから相対パスを意識するコマンドなどは指定できません。.batファイルなどでcdコマンドを実行したあと，実行するようにしてください。

検索処理はJP1/IM - Viewの起動時にだけ実行されます。そのため，起動対象となるアプリケーションをJP1/IM - Viewの実行中にインストールした場合は，JP1/IM - Viewを再起動する必要があります。

64ビット版のWindowsでは，%WINDIR%¥System32フォルダ以下に配置されているコマンドを実行すると，WOW64のリダイレクト機能によって，%WINDIR%¥SysWow64フォルダ以下に配置されているコマンドにリダイレクトされます。リダイレクト先のコマンドがない場合，コマンドの実行に失敗することがあります。%WINDIR%¥System32フォルダ以下に配置されているコマンドを実行コマンドに指定する場合は注意してください。

・置換文字列

pathステートメントには，実行時に置き換え可能な置換文字列を指定できます。

(1)キーワード置換文字列

指定された定義内にキーワード置換文字列が存在する場合は，記述されたキーワードに従って文字列の置換が実行されます。形式を次に示します。

%置き換えキーワード%

置き換えキーワードの一覧を次に示します。

表2‒54　置き換えキーワードの一覧

キーワード

置換する内容

JCO_JP1USER

JP1/IM - ManagerにログインしたJP1のユーザー

JCO_INSTALL_PATH

JP1/IM - Viewのインストールフォルダの名称

(2)レジストリー置換文字列

定義内にレジストリー置換文字列を指定すると，記述されたレジストリーから値を取得して文字列の置換が実行されます。レジストリー置換文字列の形式を次に示します。

[¥レジストリーキー¥レジストリーキー¥…¥レジストリー値]

レジストリー置換文字列の中には，さらに，レジストリー専用の置き換えキーワード「%UPPER%」を使用できます。「%UPPER%」を使用すると，レジストリーキーの中で同一階層のキーの中からキー名称で文字列比較が実行され，最も大きな文字列を選択して置換が実行されます。このキーワードの目的は，レジストリーキー内でバージョンごとにキーを分けているときに，常に最新のバージョンが得られるようにすることです。

「%UPPER%」は，レジストリー文字列内に１か所だけ指定できます。次に，「%UPPER%」を使用してJP1/SAMPLEのレジストリーを指定する例を示します。

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥%UPPER%¥PATHNAME¥PATH00]

このように指定すると，「%UPPER%」の部分が最新バージョンに置き換えられ，常に最新の実行形式ファイルが得られます。

例えば，レジストリーキーに次の二つが存在した場合，"0700">"0671"となるため，"0700"のレジストリーから値を取得します。

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥0671¥PATHNAME¥PATH00]

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥0700¥PATHNAME¥PATH00]

description="アプリケーション実行の説明文";

ブロック内のアプリケーション実行定義に説明を付加します。このステートメントは，ブロック内で1回だけ記述できます。

文字数の制限はありませんが，50文字以内にすることをお勧めします。

アプリケーション実行定義ブロックの定義例を次に示します。

@define-block type="application-execution-def";

id="HITACHI_JP1_SAMPLE";

path="C:¥Program Files¥Hitachi¥JP1¥bin¥sample.exe";

description="日立のサンプルプログラム";

@define-block-end;

定義例

アプリケーション実行定義ファイルの定義例を次に示します。

@file type="application-execution-definition", version="0300";
#-----------------------------------------
@define-block type="application-execution-def";
id="jco_notepad";
path="C:¥winnt40¥system32¥notepad.exe";
@define-block-end;
#-----------------------------------------
@define-block type="application-execution-def";
id="jco_dmp";
path="[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥NETM/DM/P¥0521/
    A¥PathName¥Path00]¥bin¥DMPSTS.exe";
@define-block-end;

状態変更条件メモリー常駐機能の設定ファイル

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"EVENT_MATCH_MODE"=dword:値

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

状態変更条件メモリー常駐機能を有効にするための定義ファイルです。

JP1/IM - Managerを新規インストールした場合は，有効になっています。バージョンアップ時は，バージョンアップ前に設定を無効にしていた場合は，無効になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"EVENT_MATCH_MODE"=dword:値

状態変更条件メモリー常駐機能を有効にする場合は「1」を，無効にする場合は「0」を指定します。

重大度変更定義ファイル（jcochsev.conf）

形式

DESC_VERSION=バージョン情報

def 定義名1
    [cmt コメント]
    [define {enable | disable}]
    [addflag {true | false}]
    cnd
        イベント条件
    end-cnd
    sev 重大度
end-def

def 定義名2
    [cmt コメント]
    [define {enable | disable}]
    [addflag {true | false}]
    cnd
        イベント条件
    end-cnd
    sev 重大度
end-def

ファイル

jcochsev.conf（重大度変更定義ファイル）

jcochsev.conf.model（重大度変更定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chsev¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chsev¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chsev/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chsev/

説明

イベントの重大度変更機能で，重大度を変更するJP1イベントの条件と変更後の重大度を定義するファイルです。イベントの重大度変更機能は，このファイルの定義に従い，イベント条件に一致するJP1イベントの重大度を変更します。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

このファイルの最大サイズは，17メガバイト（17,825,792バイト）です。定義件数に上限はありません。

重大度変更定義ファイルのパラメーターには，次の2種類があります。

重大度変更定義ファイルバージョン

重大度変更定義ファイルのフォーマットのバージョンを定義します。

重大度変更定義パラメーター

重大度を変更するJP1イベントの条件と変更後の重大度を定義します。重大度変更定義ファイルで上に記述されている重大度変更定義ほど，優先順位が高くなります。

定義の反映時期

イベントの重大度変更機能が有効で，次のどれかが成立する場合に有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドを実行した場合

［追加重大度変更定義設定］画面で［OK］ボタンをクリックした場合

［重大度変更定義一覧］画面で［適用］ボタンをクリックした場合

記述内容（重大度変更定義ファイルバージョン）

DESC_VERSION

DESC_VERSIONには，重大度変更定義ファイルの形式を決定するファイルバージョンをバージョン情報として定義します。指定する値は2です。DESC_VERSIONの指定を省略した場合，ファイルバージョンを2と見なして処理します。

DESC_VERSIONは，定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に記載します。先頭行にファイルバージョンがなかった場合は，ファイルバージョンを2と見なして処理します。

表2‒55　重大度変更定義ファイルのフォーマットのバージョン情報

バージョン情報

説明

1

10-10以前の重大度変更定義ファイルのバージョンを示す。

2

10-50の重大度変更定義ファイルのバージョンを示す。

表2‒56　バージョン情報と重大度変更定義ファイルで指定できるパラメーター一覧

バージョン情報

パラメーター名

1

def〜end-def（定義ブロック）

cnd〜end-cnd（イベント条件ブロック）

sev

2

def〜end-def（定義ブロック）

cmt コメント

define {enable | disable}

addflag {true | false}

cnd〜end-cnd（イベント条件ブロック）

sev

記述内容（重大度変更定義パラメーター）

重大度変更定義パラメーターは，図に示すとおり，定義ブロックとイベント条件ブロックで構成されています。

図2‒8　重大度変更定義パラメーター

def〜end-def（定義ブロック）

重大度変更定義の開始と終了のパラメーターです。def〜end-defブロックは省略でき，この場合「すべてのJP1イベントの重大度を変更しない」と解釈します。def以降には，重大度変更定義の定義名を記述します。「def△△△定義1△△△定義2△△△」と指定した場合，「△△定義1△△△定義2△△△」が定義名となります（△は半角スペースを表す）。

定義名は，重大度定義ファイル内でユニークになるように1〜50バイトの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

cmt コメント

重大度変更定義のコメントを記述します。cmtに指定されたコメントは，［重大度変更定義設定］画面のコメント欄に表示されます。cmtパラメーターは，定義ブロック内に一つだけ指定できます。このパラメーターは省略できます。コメントは1,024バイト以内で指定してください。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

バージョン情報が1の場合，このパラメーターを指定するとエラーになります。

define {enable | disable}

重大度変更定義を有効にするかどうかを指定します。defineパラメーターは，定義ブロック内に一つだけ指定できます。重大度変更定義を有効にする場合は「enable」を，無効にする場合は「disable」を指定します。defineパラメーターは，省略できます。デフォルトは，「enable」です。英大文字・英小文字は区別しません。

バージョン情報が1の場合，このパラメーターを指定するとエラーになります。

addflag {true | false}

追加重大度変更定義を画面から追加したことを示すパラメーターで，重大度変更定義が追加重大度変更定義かどうかを指定します。そのため，重大度変更定義ファイルを編集する場合は，addflagパラメーターを指定する必要はありません。addflagパラメーターは定義ブロック内に一つだけ指定できます。追加重大度変更定義の場合は「true」を，重大度変更定義の場合は「false」を指定します。「true」を指定した場合は，［重大度変更定義一覧］画面の［種別］にアイコン（[図データ]）が表示されます。addflagパラメーターは，省略できます。デフォルトは，「false」です。英大文字・英小文字は区別しません。

バージョン情報が1の場合，このパラメーターを指定するとエラーになります。

cnd〜end-cnd（イベント条件ブロック）

重大度を変更するJP1イベントのイベント条件を指定する，ブロックの開始と終了のパラメーターです。イベント条件ブロックは，定義ブロック内に必ず一つ指定する必要があります。省略はできません。受信したJP1イベントが，複数のイベント条件に一致する場合，重大度変更定義ファイルの先頭に近い定義ブロックが優先されます。cndおよびend-cndパラメーターの前後のタブやスペースは，無視されます。

イベント条件

重大度を変更するJP1イベントの条件を指定します。イベント条件ブロックには，0〜256件のイベント条件を指定できます。イベント条件とイベント条件は，AND条件となります。イベント条件は，次の形式で指定します（△は半角スペースを表す）。

　属性名△比較キーワード△オペランド[△オペランド]…

なお，半角スペースまたはタブだけで構成された行は，無視して処理を続行します。

・属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2‒57　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番

項目

属性名

比較

キーワード

オペランド

1

イベントID

B.ID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

16進数形式で指定する。大文字・小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

3

発行元プロセスID

B.PROCESSID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

4

発行元ユーザーID

B.USERID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

5

発行元グループID

B.GROUPID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

6

発行元ユーザー名

B.USERNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

7

発行元グループ名

B.GROUPNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

8

発行元イベントサーバ名(登録ホスト名)※1

B.SOURCESERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

9

送信先イベントサーバ名※1

B.DESTSERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

10

メッセージ

B.MESSAGE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

11

重大度

E.SEVERITY

と一致する

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。"Emergency"，"Alert"，"Critical"，"Error"，"Warning"，"Notice"，"Information"，"Debug"のどれかを指定できる。

12

ユーザー名

E.USER_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

13

プロダクト名

E.PRODUCT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

14

オブジェクトタイプ

E.OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

15

オブジェクト名

E.OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

16

登録名タイプ

E.ROOT_OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

17

登録名

E.ROOT_OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

18

オブジェクトID

E.OBJECT_ID

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

19

事象種別

E.OCCURRENCE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

20

終了コード

E.RESULT_CODE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

21

発生元ホスト名※1

E.JP1_SOURCEHOST

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

22

固有の拡張属性※3

E.xxxxxxx

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

属性名には，先頭が英大文字で英大文字，数字，およびアンダーバー（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

注※1

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

注※2

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

・比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

・オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。%のあとに指定する文字コードは，英大文字・英小文字を区別しません。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

sev

変更後の重大度を記述するパラメーターです。

sevパラメーターは，定義ブロック内に必ず一つ指定する必要があります。省略はできません。

sevパラメーターに指定できる値は，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）のどれかです。

#コメント行

#で始まる行は，コメント扱いとなります。なお，JP1/IM - Viewから重大度変更定義を設定した場合，#のコメント行は削除されます。

定義例

イベントIDが100または200に一致，かつ重大度がWarningで，かつ登録ホストがhostA，hostB，hostCに一致する場合に，重大度をEmergencyに変更する例を次に示します。

DESC_VERSION=2
def 重大度変更1
    cmt コメント1
    define enable
    cnd
        B.ID IN 100 200
        E.SEVERITY IN Warning
        B.SOURCESERVER IN hostA hostB hostC
    end-cnd
    sev Emergency
end-def

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）

形式

# コメント行
属性名
属性名
　・
　・
属性名

ファイル

chsev_attr_list.conf（重大度変更定義表示項目定義ファイル）

chsev_attr_list.conf.model（重大度変更定義表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chsev¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chsev¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chsev/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chsev/attr_list

説明

［重大度変更定義設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。重大度変更定義表示項目定義ファイルに指定された表示項目を指定された順番で［重大度変更定義設定］画面の［属性名］表示領域に表示します。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

重大度変更定義表示項目定義ファイルには，［重大度変更定義設定］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

SEPARATORを指定すると，［重大度変更定義設定］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択しても，属性名は設定できません。

指定できる属性名を次の表に示します。

表2‒58　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

送信先イベントサーバ名

B.DESTSERVER

14

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

15

登録要因

B.REASON

16

発行元プロセスID

B.PROCESSID

17

発行元ユーザー名

B.USERNAME

18

発行元ユーザーID

B.USERID

19

発行元グループ名

B.GROUPNAME

20

発行元グループID

B.GROUPID

21

オブジェクトID

E.OBJECT_ID

22

終了コード

E.RESULT_CODE

23

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，重大度変更定義表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜22が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［重大度変更定義設定］画面には表示されません。

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）

形式

# コメント行
[DEFAULT_NAME 重大度変更定義名]
属性名
属性名
　・
　・
属性名
属性名

ファイル

chsev_auto_list.conf

chsev_auto_list.conf.model（重大度変更定義自動入力定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chsev¥auto_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chsev¥auto_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chsev/auto_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chsev/auto_list

説明

［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［重大度変更定義を設定］メニューを選択して［追加重大度変更定義設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。また，重大度変更定義名のデフォルト名も定義できます。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

DEFAULT_NAME 重大度変更定義名

重大度変更定義名を定義する識別子を表しています。識別子は，コメントと空行を除いたファイルの先頭に記述してください。

このパラメーターに指定した重大度変更定義名が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［重大度変更定義を設定］を選択して［追加重大度変更定義設定］画面を開いたときに，初期値として表示されます。

40バイトまでの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。40バイトを超えて指定した場合，41バイト以上の文字列を切り捨てた文字列が重大度変更定義名となります。指定しなかった場合，「追加重大度変更定義」が重大度変更定義名となります。

属性名

重大度変更定義自動入力定義ファイルには，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［重大度変更定義を設定］を選択して［追加重大度変更定義設定］画面を開いたときに，イベント条件として設定されるJP1イベントの属性を指定します。このパラメーターに指定した属性名の条件が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［重大度変更定義を設定］を選択して［追加重大度変更定義設定］画面を開いたときに，初期値として表示されます。

定義項目は，設定されるJP1イベントの属性名を1行に1件記述します。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

同じ属性名が複数指定されていた場合，その値は無視し，KAVB1935-Wメッセージを統合トレースログに出力します。

［重大度変更定義設定］画面の［イベント条件］に自動的に表示されるJP1イベントの属性の順序は，重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）の属性の記載順に設定されます。

指定できる属性名を次の表に示します。

表2‒59　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

送信先イベントサーバ名

B.DESTSERVER

14

登録要因

B.REASON

15

発行元プロセスID

B.PROCESSID

16

発行元ユーザー名

B.USERNAME

17

発行元ユーザーID

B.USERID

18

発行元グループ名

B.GROUPNAME

19

発行元グループID

B.GROUPID

20

オブジェクトID

E.OBJECT_ID

21

終了コード

E.RESULT_CODE

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，重大度変更定義自動入力定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜3，項番10〜12が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［追加重大度変更定義設定］画面には表示されません。

通信環境定義ファイル（view.conf.update）

形式

[JP1_DEFAULT¥JP1CONSOLEVIEW]
"COM_SO_TIMEOUT"=dword:16進数値
"COM_RMI_TIMEOUT"=dword:16進数値

ファイル

view.conf.update（通信環境定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥default¥

説明

JP1/IM - ViewとJP1/IM - Manager（セントラルコンソール）間の通信でのタイムアウト時間を定義するファイルです。

ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合に，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。タイムアウト時間を設定する場合は，接続するJP1/IM - Manager（セントラルコンソール）でも同様の設定が必要です。

なお，この定義ファイルの値を変更する場合は，JP1/IM - Manager（セントラルコンソール）用の通信環境定義ファイルの値も変更する必要があります。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Viewを再起動したあとに有効になります。

記述内容

[JP1_DEFAULT¥JP1CONSOLEVIEW]

JP1/IM - View環境設定のキー名称です。

JP1/IM - Viewの場合，このパラメーターは固定です。

"COM_SO_TIMEOUT"=dword:16進数値

受信データの到着待ち時間（ソケットタイムアウト値）を16進数で指定します。単位はミリ秒です。デフォルト値はdword:0000EA60（60,000ミリ秒）です。

低速回線や，イベントトラフィックが高い環境の場合は長めに設定します。

指定できる値の範囲は0x00000001〜0x0036EE80（3,600,000ミリ秒）です。

また，通信環境定義ファイル（view.conf.update）の"COM_RMI_TIMEOUT"値（デフォルト：0000EA60）を超えないように指定してください。

"COM_RMI_TIMEOUT"=dword:16進数値

次に示す操作または設定時に発生する通信処理のタイムアウト時間（サーバ処理タイムアウト値）を16進数で指定します。単位はミリ秒です。

ログイン

ログアウト

［イベントコンソール］画面の手動および自動更新

イベントの対処状況の変更

重要イベントの削除

イベント検索

ユーザー環境設定

重要イベント設定

自動アクション設定

フィルター設定

コマンド実行操作

機能状態通知復帰の操作

応答待ちイベントに対する応答・滞留解除

指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0000EA60（60,000ミリ秒）です。

定義例

[JP1_DEFAULT¥JP1CONSOLEVIEW]
"COM_SO_TIMEOUT"=dword:000009C4
"COM_RMI_TIMEOUT"=dword:0000EA60

通信環境定義ファイル（tree_view.conf.update）

形式

[JP1_DEFAULT¥JP1CONSOLEVIEW]
"SOV_LOGIN_TIMEOUT"=dword:16進数値
"SOV_GETTREE_TIMEOUT"=dword:16進数値
"SOV_SETTREE_TIMEOUT"=dword:16進数値
"SOV_MAKETREE_TIMEOUT"=dword:16進数値
"SOV_GETMAP_TIMEOUT"=dword:16進数値
"SOV_SETMAP_TIMEOUT"=dword:16進数値
"SOV_GETPROFILE_TIMEOUT"=dword:16進数値
"SOV_SETPROFILE_TIMEOUT"=dword:16進数値
"SOV_DEF_TIMEOUT"=dword:16進数値

ファイル

tree_view.conf.update（通信環境定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥default¥

説明

JP1/IM - ViewとJP1/IM - Manager（セントラルスコープ）間の通信でのタイムアウト時間を定義するファイルです。

ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合に，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Viewを再起動したあとに有効になります。

記述内容

[JP1_DEFAULT¥JP1CONSOLEVIEW]

JP1/IM - View環境設定のキー名称です。

JP1/IM - Viewの場合，このパラメーターは固定です。

"SOV_LOGIN_TIMEOUT"=dword:16進数値

ログイン・ログアウト処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_GETTREE_TIMEOUT"=dword:16進数値

監視オブジェクトの状態取得，監視ツリーの更新，［監視ツリー(編集中)］画面の表示処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0036EE80（3,600,000ミリ秒）です。

"SOV_SETTREE_TIMEOUT"=dword:16進数値

監視オブジェクトの状態変更，監視対象設定，ツリー更新処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0036EE80（3,600,000ミリ秒）です。

"SOV_MAKETREE_TIMEOUT"=dword:16進数値

監視ツリーの自動生成処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0036EE80（3,600,000ミリ秒）です。

"SOV_GETMAP_TIMEOUT"=dword:16進数値

ビジュアル監視一覧の表示，ビジュアル監視画面の表示処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_SETMAP_TIMEOUT"=dword:16進数値

ビジュアル監視の作成，削除，コピー，ビジュアル監視更新処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_GETPROFILE_TIMEOUT"=dword:16進数値

監視ツリー画面用システム環境設定，ユーザー環境設定の取得処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_SETPROFILE_TIMEOUT"=dword:16進数値

監視ツリー画面用システム環境設定，ユーザー環境設定の反映処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_DEF_TIMEOUT"=dword:16進数値

監視オブジェクトのプロパティ取得，監視オブジェクトのプロパティ設定，ログインユーザー一覧取得，自動生成構成選択の取得処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:001B7740（1,800,000ミリ秒）です。

定義例

[JP1_DEFAULT¥JP1CONSOLEVIEW]
"SOV_LOGIN_TIMEOUT"=dword:0002BF20
"SOV_GETTREE_TIMEOUT"=dword:0002BF20
"SOV_SETTREE_TIMEOUT"=dword:0002BF20
"SOV_MAKETREE_TIMEOUT"=dword:0036EE80
"SOV_GETMAP_TIMEOUT"=dword:0002BF20
"SOV_SETMAP_TIMEOUT"=dword:0002BF20
"SOV_GETPROFILE_TIMEOUT"=dword:0002BF20
"SOV_SETPROFILE_TIMEOUT"=dword:0002BF20
"SOV_DEF_TIMEOUT"=dword:0002BF20

非暗号化通信ホスト設定ファイル（nosslhost.conf）

形式

[NO_SSL_HOST]
マネージャーホスト名
マネージャーホスト名
    ：
マネージャーホスト名

ファイル

nosslhost.conf（非暗号化通信ホスト設定ファイル）

nosslhost.conf.model（非暗号化通信ホスト設定ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥ssl

説明

非暗号化通信をするホストを設定するファイルです。初期値はすべてのホストで非暗号化通信となるため，暗号化通信をする場合は，このファイルを設定する必要があります。JP1/IM - Viewが，ログインするマネージャーホストとの通信を，非暗号化通信する場合に定義します。このファイルに定義のないマネージャーホストとは暗号化通信をします。

JP1/IM - Viewはログイン画面の接続先ホスト名，またはjcoviewコマンドの-hオプションおよびjcfviewコマンドの-hオプションで指定した接続ホスト名と，定義ファイルに記載してあるマネージャーホスト名を突き合わせて一致した場合は，非暗号化通信を行います。大文字，小文字の区別はしません。

定義の反映時期

次の場合に，非暗号化通信ホスト設定ファイルの設定が有効になります。

セントラルコンソール・ビューアーからセントラルコンソール，セントラルスコープ・ビューアーからセントラルスコープ，およびIM構成管理・ビューアーからIM構成管理にログインする場合（ログイン画面を表示し，ログインする場合は，ログイン画面の［OK］ボタンをクリックした場合）。

IM構成管理・ビューアーからセントラルコンソール・ビューアー，またはセントラルスコープ・ビューアーを表示した場合。

IM構成管理・ビューアーから拠点マネージャーのIM構成管理・ビューアーを表示（拠点ビュー起動）した場合。

次に，それぞれのビューアーの起動と定義ファイルの読み込みについて示します。

表2‒60　それぞれのビューアー起動時の非暗号化通信ホスト設定ファイルの読み込み

呼び出し元画面（呼び出し元画面での操作）

チェックボックス

起動するビューアー

定義ファイルを読み込むかどうか

セントラルコンソール

セントラルスコープ

セントラルコンソール・ビューアー，セントラルスコープ・ビューアーのログイン画面（［OK］ボタンをクリックしたとき）

あり

なし

セントラルコンソール

○

なし

あり

セントラルスコープ

○

あり

あり

セントラルコンソール，セントラルスコープ

○※

IM構成管理・ビューアーログイン画面（［OK］ボタンをクリックしたとき）

IM構成管理

○

セントラルスコープ・ビューアーログイン画面（［OK］ボタンをクリックしたとき）

［監視ツリー(編集中)］画面からの起動

セントラルスコープ

○

セントラルコンソール・ビューアー（メインメニュー，ツールバー）

セントラルスコープ

×

セントラルスコープ・ビューアー（メインメニュー，ツールバー）

セントラルコンソール

×

IM構成管理・ビューアー（メインメニュー，ツールバー）

セントラルコンソール

○

セントラルスコープ

○

IM構成管理・ビューアー（拠点ビュー起動）

拠点マネージャーのIM構成管理

○

（凡例）

○：読み込む

×：読み込まない

あり：チェックあり

なし：チェックなし

注※

起動するのはセントラルコンソール・ビューアー，およびセントラルスコープ・ビューアーの二つですが，読み込み処理は1回です。

記述内容

[NO_SSL_HOST]

このブロックは必須項目です。英大文字・英小文字を区別します。[NO_SSL_HOST]の前後の半角スペース，およびタブは無視されます。

マネージャーホスト名

非暗号化通信（暗号化通信しない）をする接続先のマネージャーホストのホスト名，またはIPv4アドレスを指定します。マネージャーホスト名のホスト名はFQDN形式も記載できます。初期設定では，「*」が設定されています。「*」は接続するすべてのマネージャーホストと非暗号化通信をします。最大定義数は1,024件です。同じマネージャーホスト名を複数記載することはできません。大文字・小文字を区別しません。指定できる値は，0〜255文字です。マネージャーホスト名の前後の半角スペース，およびタブは無視されます。

定義例

定義例1：すべてのマネージャーホストとの通信を非暗号化通信にする場合

[NO_SSL_HOST]
*

「*」が定義されることで，すべてのマネージャーホストとの通信が非暗号化通信となります。「*」を記載する場合，上記以外の記載は，エラーとなります。

定義例2：すべてのマネージャーホストとの通信を暗号化通信にする場合

[NO_SSL_HOST]

すべてのマネージャーホストとの通信を暗号化通信にする場合は「*」を削除します。

定義例3：マネージャーホストとの通信が非暗号化通信と暗号化通信で混在する場合

[NO_SSL_HOST]
hostA
hostB

マネージャーホスト（hostA，hostB）との通信は非暗号化通信となり，hostA，hostB以外のマネージャーホストとの通信は暗号化通信となります。

IM-View設定ファイル（tuning.conf）

形式

LOGIN_HISTORY_MAX=接続先ホスト入力履歴数
MENU_AUTO_START={ON | OFF}
ACTIONLIST_AUTO_START={ON | OFF}
WWW_BROWSER_PATH=起動ブラウザーのパス
CLIPBOARD_OUTPUT={ON | OFF}
LOGIN_USER_HISTORY_MAX={0|1}
SCREEN_TITLE_LOGININFO={ON|OFF}

ファイル

tuning.conf（IM-View設定ファイル）

tuning.conf.model（IM-View設定ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥

説明

JP1/IM - Viewの動作を定義するファイルです。ログイン画面での接続先ホスト入力履歴数，イベントコンソール画面表示時の動作，およびクリップボードへのコピー可否を設定します。

tuning.confファイルの各項目は，「パラメーター名=値」という形式で記述します。定義ファイル中の，次の行は無視されます。

空白文字だけの行

空白文字を除いた先頭の文字が「#」の行（コメント行）

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

LOGIN_HISTORY_MAX=接続先ホスト入力履歴数

ログイン画面の［接続ホスト名］リストボックスに表示する入力履歴の数を指定します。

指定できる値は，0〜20です。0を指定した場合は，入力履歴を表示しません。このパラメーターを指定しなかった場合は，「5」を仮定します。デフォルトは，「5」です。

MENU_AUTO_START={ON | OFF}

イベントコンソール画面を表示したときに統合機能メニューを起動するかどうかを指定します。「ON」を指定すると，イベントコンソール画面表示時に統合機能メニュー画面を起動します。「OFF」を指定すると，イベントコンソール画面表示時に統合機能メニュー画面を起動しません。このパラメーターを指定しなかった場合は，「OFF」を仮定します。デフォルトは，「OFF」です。

ACTIONLIST_AUTO_START={ON | OFF}

イベントコンソール画面を表示したときに［アクション結果一覧］画面を表示するかどうかを指定します。「ON」を指定すると，イベントコンソール画面表示時に［アクション結果一覧］画面を起動します。「OFF」を指定すると，イベントコンソール画面表示時に［アクション結果一覧］画面を起動しません。このパラメーターを指定しなかった場合は，「OFF」を仮定します。デフォルトは，「OFF」です。

WWW_BROWSER_PATH=起動ブラウザーのパス

統合機能メニューおよびモニター画面呼び出しで使用するWWWブラウザーの起動パスを指定します。なお，このパラメーターはデフォルトでは記述されていません。指定する場合は，パラメーターを定義ファイルに追加する必要があります。

パスの指定ではパスに含まれる「¥」を「¥¥」と記述します。起動パス名は「"」で囲まないで記述します。指定するWWWブラウザーが，統合機能メニューおよびモニター画面呼び出しで起動するアプリケーションが前提としているWWWブラウザーかどうかを確認しておいてください。

このパラメーターを指定しなかった場合は，そのホストでファイルタイプ「.html」に関連づけられているWWWブラウザーが使用されます。ファイルタイプ「.html」に関連づけられているWWWブラウザー以外のWWWブラウザー（バージョンが異なるものも含む）を使用したい場合に，このパラメーターを指定します。

CLIPBOARD_OUTPUT={ON | OFF}

JP1イベント情報，アクション結果，コマンド実行結果をクリップボードにコピーする機能を有効にするかどうかを指定します。

「ON」を指定すると，クリップボードへのコピー機能が有効になります。JP1/IM - Viewの画面でコピーしたい情報を選択し［Ctrl］+［C］キーを押すと，選択している情報がCSV形式でクリップボードにコピーされます。また，［イベントコンソール］画面の［編集］メニューに［コピー］が表示されます。

「OFF」を指定すると，クリップボードへのコピー機能が無効になります。

このパラメーターを指定しなかった場合は，「ON」を仮定します。

LOGIN_USER_HISTORY_MAX={0|1}

［ログイン］画面のユーザー名に前回ログインしたJP1ユーザー名を表示するかどうかを指定します。1を指定すると，前回ログインしたJP1ユーザー名を表示します。0を指定すると，前回ログインしたJP1ユーザー名を表示しません。このパラメーターを指定しなかった場合や，0または1以外を指定した場合は，1を仮定します。デフォルトは1です。

SCREEN_TITLE_LOGININFO={ON|OFF}

［監視ツリー］画面，［監視ツリー（編集中）］画面，［ビジュアル監視（編集中）］画面，［イベントコンソール］画面，［コマンド実行］画面，および［アクション結果一覧］画面のタイトル部分に表示されるログイン中のJP1ユーザー名を非表示にできます。「ON」を指定すると，ログイン中のJP1ユーザー名を表示します。「OFF」を指定すると，ログイン中のJP1ユーザー名を表示しません。デフォルトは，「ON」です。このパラメーターを指定しなかった場合や，「ON」または「OFF」以外を指定した場合は，「ON」を仮定します。指定値は大文字と小文字を区別します。

定義例

# ************************************************************************
# ***  JP1/Integrated Management - View   Tuning definition file       ***
# ************************************************************************

# Input history maximum number in connected hostname input field on log in screen
LOGIN_HISTORY_MAX=5
# Tool Launcher is automatically started at log in whether (ON) (OFF).
MENU_AUTO_START=OFF
# List of Action Result is automatically started at log in whether (ON) (OFF).
 ACTIONLIST_AUTO_START=OFFCLIPBOARD_OUTPUT=ON
# Copies JP1 event information, action results, and command execution results to the clipboard (ON) (OFF).
CLIPBOARD_OUTPUT=ON
# Displays the previous user name in the Login window (1) (0).
LOGIN_USER_HISTORY_MAX=1
# Displays the user name in the window title bar (ON) (OFF).
SCREEN_TITLE_LOGININFO=ON

モニター画面呼び出し定義ファイル

形式

[@encode 文字コード]
DESC_VERSION=0300
{キー定義(SUBKEYパラメーターを使用)
サブキー定義
関連づけ定義
|キー定義(INTERFACEパラメーターを使用)}
呼び出しインターフェース定義

ファイル

hitachi_xxxx_mon.conf（連携製品のモニター画面呼び出し定義ファイル）

会社名_製品名_mon.conf（ユーザー定義のモニター画面呼び出し定義ファイル）

会社名_シリーズ名_製品名_mon.conf（ユーザー定義のモニター画面呼び出し定義ファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥monitor¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥monitor¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/monitor/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/monitor/

説明

モニター画面呼び出し定義ファイルは，インテリジェント統合管理基盤の統合オペレーション・ビューアー，またはセントラルコンソールの［イベントコンソール］画面から，イベント発行元などのモニター画面を呼び出すための定義ファイルです。この定義ファイルは，イベントIDや属性などの情報からキーを作り，イベント属性からコマンドラインパラメーターを作成するために使用します。

モニター画面呼び出し定義ファイルは，Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCJISコードで定義する必要があります。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

会社名が「hitachi」のモニター画面呼び出し定義ファイルは，システム標準定義情報であるため，ユーザーによる新規作成，変更，削除はできません。

なお，JP1/IMには，モニター画面呼び出し定義ファイルの記述内容をチェックするためのコマンド「jcomonitorfcheck」が用意されています。このコマンドの詳細については，「jcomonitorfcheck」（1.　コマンド）を参照してください。

定義の反映時期

JP1/IM - Managerを再起動したあと，またはjco_spmd_reloadコマンドを実行すると定義内容が有効になります。なお，インテリジェント統合管理基盤またはJP1/IM - Viewのログイン中に定義を変更した場合，ログイン中のインテリジェント統合管理基盤またはJP1/IM - Viewに変更した定義内容は反映されません。変更した定義を有効にするには，インテリジェント統合管理基盤またはJP1/IM - Viewを再起動する必要があります。

記述内容

@encode

モニター画面呼び出し定義ファイルで使用する文字コードを指定します。

モニター画面呼び出し定義ファイルを追加で作成する場合は，@encodeステートメントで定義ファイルの文字コードを指定してください。

項目名には，@encodeステートメントに指定した文字コードで表現できる文字を記載します。また，モニター画面呼び出し定義ファイルは，@encodeステートメントに指定した文字コードで保存します。

次の場合，統合オペレーション・ビューアーまたはJP1/IM - Viewに表示される項目名が文字化けすることがあります。

項目名に，@encodeステートメントに指定した文字コードで表現できない文字を使用した場合

@encodeステートメントに指定した文字コード，ファイルを保存した文字コード，および@encodeステートメントに指定した文字コードが不一致の場合

@encodeステートメントが存在しない場合，および@encodeステートメントのあとに指定した文字コードに誤りがある場合は，文字コードが自動判別されます。ただし，定義ファイルの内容によっては正しく判別できないおそれがあります。

指定できる文字コードは次のとおりです。

C

EUCJIS

SJIS

UTF-8

GB18030

注意事項

定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

次の場合，エラーが出力されます。

C，EUCJIS，SJIS，UTF-8，およびGB18030以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

注意事項

他製品から提供されたイベント拡張属性定義ファイルを使用する場合，定義ファイルで使用されている文字コードと，@encodeステートメントに指定する文字コードが一致していることを確認してください。また，定義ファイルを転送して配置する際は，定義ファイルの文字コードを変換しないようにしてください。

DESC_VERSION=0300

テーブルバージョンレコードです。

キー定義

モニター画面の呼び出し時にイベント属性中で固定的にキーとなる項目を定義します。キーとなる項目は次の三つです。

イベントID

プロダクト名

バージョン

それぞれの属性の組み合わせによって，動作やサブキーへのリンクを定義します。

形式

DEF_KEY PRODUCT_NAME="プロダクト名"

EVENT_ID=イベントID

[VERSION=バージョン|ALL]

{SUBKEY=サブキー

|INTERFACE=インターフェース名}

引数

・PRODUCT_NAME="プロダクト名"

/HITACHI/JP1/AJSなどの製品名を表す文字列です。拡張属性「PRODUCT_NAME」に設定する値と同一のものを指定します。

・EVENT_ID=イベントID

8けたの16進数値文字列で，IDの基本部だけを指定します。拡張部は無視されます。JP1/SES形式のイベントに設定されている拡張部を含める場合は，サブキーを使用してください。

・VERSION=バージョン

ここで指定したバージョンは，JP1イベントの拡張属性「ACTION_VERSION」と比較されます。バージョンとして使用できる文字は，半角の数字（0〜9），英字（A〜Z），「/」，「-」です。英字の大文字と小文字は区別されません。

一つのバージョンは8バイト以内で指定します。バージョンの範囲を指定する場合は，開始バージョンと終了バージョンの両方を「-」で区切って指定します。その場合，区切りとなる「-」の前後に一つ以上の空白が必要です。

ほかのキー定義で指定したバージョンと重複するバージョンは指定できません。

・SUBKEY=サブキー

サブキーの名称を記述します。このパラメーターとINTERFACEパラメーターは，どちらかを指定できます。

SUBKEYパラメーターを指定した場合は，SUBKEYに指定したサブキー名に対応したサブキー定義，関連づけ定義が必要です。

・INTERFACE=インターフェース名

インターフェースの名称を記述します。定義するキーに対して，モニター画面起動時のインターフェースを一つだけ指定します。このパラメーターとSUBKEYパラメーターは，どちらかを指定できます。

INTERFACEパラメーターを指定した場合はサブキー定義，関連づけ定義は使用できません。

注意事項

・バージョンの比較は昇順で実行されます。開始バージョンよりも終了バージョンの方が小さい場合は，エラーは発行されませんが，そのキー定義自体が無視されます。

・「PRODUCT_NAME」に指定する値は，JP1イベントの拡張属性「PRODUCT_NAME」に指定する値と同じにする必要があります。

サブキー定義

サブキー定義は，モニター画面の呼び出し時に固定キーからリンクされ，イベント属性をキーとして登録します。

形式

DEF_SUBKEY

NAME=サブキー名

KEYS=属性名1 [, 属性名2[,属性名3[,属性名4]]]

引数

・NAME=サブキー名

サブキーの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

・KEYS=属性名1 [, 属性名2[,属性名3[,属性名4]]]

属性名の指定形式を次に示します。

表2‒61　属性名の指定形式

指定形式

値の形式

意味および内容

B.ARRIVEDTIME

13けたの10進数文字列

到着時刻（UTC1970年1月1日00:00:00からのミリ秒数）

B.DESTSERVER

文字列

送信先イベントサーバ名

B.GROUPNAME

文字列

発行元グループ名

B.IDBASE

8けたの16進数文字列

イベントIDの基本部

B.IDEXT

8けたの16進数文字列

イベントIDの拡張部

B.PROCESSID

10進数文字列

発行元プロセスID

B.SEQNO

10進数文字列

DB内通し番号

B.SOURCESEQNO

10進数文字列

発行元別通し番号

B.SOURCESERVER※

文字列

発行元イベントサーバ名

B.TIME

13けたの10進数文字列

登録時刻（UTC1970年1月1日00:00:00からのミリ秒数）

B.USERNAME

文字列

発行元ユーザー名

B.MESSAGE

文字列

メッセージ

E.JP1_SOURCEHOST※

文字列

発生元ホスト名

E.xxxxxxx

文字列

拡張属性

注※

発行元イベントサーバ名（B.SOURCESERVER），発生元ホスト名（E.JP1_SOURCEHOST）には業務グループ名を使用できません。業務グループ名を指定した場合，ホスト名として扱われます。

関連づけ定義

サブキーの値とインターフェースの関連づけを定義します。

形式

DEF_IF_RELATION

SUBKEY_NAME=サブキー名

｛ VALUE1=" 属性値1"[[ VALUE2=" 属性値2"]…]

|KEY_DEFAULT ｝

IF_NAME=インターフェース名

引数

・SUBKEY_NAME=サブキー名

サブキーの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

・VALUEn=" 属性値"

nは，サブキー定義のKEYSパラメーターで指定した属性の並び順に1〜4の数です。キーの値は完全に一致させる必要があります。値に正規表現などは使用できません。指定できる属性の一覧と指定形式については，サブキー定義の説明を参照してください。

VALUE1，VALUE2，…のすべての属性が完全に一致しないJP1イベントは，「KEY_DEFAULT」で指定したインターフェースとなります。

・KEY_DEFAULT

VALUE1，VALUE2，…に指定した値と一致しないケースをインターフェースと関連づける際に，VALUE1，VALUE2，…の代わりに指定します。

・IF_NAME=インターフェース名

サブキー値が一致した場合に呼び出すインターフェース名称を指定します。インターフェース名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

呼び出しインターフェース定義

モニター画面呼び出し時のインターフェースを定義します。

形式

DEF_MTR_CALL

NAME=インターフェース名

EXEC_ID=アプリケーション実行定義識別子

PATH="コマンド引数"

[PARAM= 属性名1[,属性名2…]]

引数

・NAME=インターフェース名

インターフェースの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

・EXEC_ID=アプリケーション実行定義識別子

アプリケーション実行定義識別子を指定します。識別子には，ビューアー上のアプリケーション実行定義ファイルで定義したIDを指定します。

EXEC_IDパラメーターには「"default_browser"」を指定してデフォルトのブラウザーを起動できます。また，EXEC_IDパラメーターに「"default_browser"」を指定する場合は，PATHパラメーターにURLを記載します。

なお，「"jco_"」で始まる文字列はアプリケーション実行定義識別子として予約されているため，使用できません。

・PATH="コマンド引数"

EXEC_IDで指定した実行形式ファイルに渡すコマンド引数を指定します。EXEC_IDで指定した実行形式ファイル名とここで指定した引数によってコマンドラインが構成されます。例えば，次のようなコマンドラインがあるとします。

"app.exe arg1 arg2"

コマンド引数には，この「arg1」「arg2」の部分を指定します。

PATHには，ビューアーの動作環境属性およびイベント属性値で置換できる予約キーワードを指定できます。置き換えキーワードを次に示します。

表2‒62　置き換えキーワード

キーワード

置換する語句

%JCO_JP1USER%

インテリジェント統合管理基盤またはセントラルコンソールのログインユーザー名

%JCO_INSTALL_PATH%※

ビューアーのインストールフォルダ名

%IM_EVC_PARAMETER_n%

PARAMで指定したイベント属性値に置き換える

（nは1以上の整数）

%IM_EVC_LANGUAGE%

言語環境に応じて「Japanese」または「English」に置き換える

注※

インテリジェント統合管理基盤の場合は置き換えされません。

・PARAM=属性名1 [, 属性名2…]

イベント属性値で置き換える場合のイベント属性を属性名で指定します。属性名には，指定した順に1から順序番号が付けられます。順序番号は，置き換えキーワードの「n」に当たります。

複数のイベント属性を指定する場合は，「,」で区切って指定します。例を示します。

B.EXTID,E.A0

指定できるイベント属性は，基本属性の一部と拡張属性です。指定できる属性と指定形式については，サブキーの説明を参照してください。

定義例

WindowsのイベントログをトラップしたJP1イベントからモニター画面を呼ぶ場合の例を示します。

注

この例では，説明のために行頭に行番号を入れて示しています。

1行目

定義ファイルの文字コードで，文字コードが「UTF-8」であることを示します。

2行目

「DESC_VERSION=0300」は，このファイルの記述形式のバージョンが「0300」であることを示します。

3〜5行目

コメント行です。動作バージョンの適用範囲を含めることをお勧めします。

6行目

キー定義レコードで，プロダクト名が「/HITACHI/JP1/NTEVENT_LOGTRAP」，イベントIDが「00003A71」の場合に，サブキー「SAMPLE」を使用して，呼び出すモニター画面を決定することを意味します。

7行目

サブキー定義レコードで，サブキー名を「SAMPLE」として，拡張属性「PRODUCT_NAME」と，拡張属性「A5」（WindowsのイベントログのID）を使用することを宣言します。

8行目

関連づけ定義レコードで，サブキーに設定した「E.A5」の値が「8010」と一致した場合，インターフェース「NETM_DM」を使用してモニター画面を表示することを意味します。

9行目

呼び出しインターフェース定義レコードです。インターフェース名称を「NETM_DM」とし，アプリケーション実行定義識別子が「HITACHI_NETM_DM」で定義されているコマンドに引数として「netmdm_argument」を渡して実行することを意味します。

メール環境定義ファイル（jimmail.conf）

形式

Charset=メールの文字コード
From=送信元メールアドレス
DefaultTo=デフォルトの送信先メールアドレス[,デフォルトの送信先メールアドレス…]
SmtpServer=SMTPサーバ名
SmtpPort=SMTPポート番号
AuthMethod=メール送信時の認証方式
SmtpAuthPort=SMTP-AUTH認証のサブミッションポート番号
Pop3Server=POP3サーバ名
Pop3Port=POP3ポート番号
AuthUser=認証アカウント名
AuthPassword=認証パスワード
ConnectTimeout=ネットワーク接続タイムアウト時間
SoTimeout=通信タイムアウト時間
MailSubjectCutting=メール主題の切り捨て設定
MailNewLine=メールの改行コード

ファイル

jimmail.conf（メール環境定義ファイル)

jimmail.conf.model（メール環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥mail

論理ホストのとき

共有フォルダ¥JP1Cons¥conf¥mail

説明

メール環境定義ファイルは，メールサーバのホスト名や認証方式，認証アカウント名・パスワードなどメール送信に必要な情報を設定する定義ファイルです。

定義の反映時期

jimmailコマンドを実行したときに有効になります。

記述内容

メール環境定義ファイルには，次に示す規則があります。

設定項目の1行は「パラメーター名=設定値」形式で記述し，パラメーター名と設定値は，1行の最初の"="（0x3d）で区切ります。

改行は，「CR（0x0d）」「LF（0x0a）」です。「CRLF」以外の改行コードを含む場合，jimmailpasswdコマンドでパスワードを設定すると「CRLF」に統一して出力します。

パラメーター名は大文字・小文字を区別します。

先頭が「#（0x23）」または「△#」で始まる行は，コメント行になります。ただし，#の前に半角スペース（0x20）またはタブ（0x09）を除く文字がある場合は，コメント行として扱いません（△は半角スペースまたはタブ）。

半角スペースまたはタブの扱いは次のとおりです（△は半角スペースまたはタブ）。

パラメーター名の前後の半角スペースおよびタブは無視されます。

例）△パラメーター名△=設定値

設定値の前後の半角スペースおよびタブ文字は無視されます。ただし，AuthPasswordパラメーターの場合だけ，前後の半角スペースおよびタブ文字を無視しないで，文字として扱います。

例）パラメーター名=△設定値△

無効なパラメーターが記述してある場合，エラーとなります。また，パラメーター名の後ろに"="がない場合も，エラーとなります。

Charset=メールの文字コード

送信するメールの件名と本文の文字コードを定義します。

文字コードは大文字・小文字を区別しません。

Charsetパラメーターの初期値と，Charsetパラメーターの値を取得できなかった場合の設定値を次の表に示します。

表2‒63　Charsetパラメーターの初期値と値を取得できなかった場合の設定値

環境

初期値

値を取得できなかった場合の設定値

日本語環境

iso-2022-jp

iso-8859-1

日本語環境以外

iso-8859-1

iso-8859-1

Charsetに指定できる文字コードを次の表に示します。

指定できない文字コードを定義した場合，上記表の値を取得できなかった場合の設定値として処理を行います。

表2‒64　Charsetに指定できる文字コード

文字コード

説明

iso-2022-jp

JISコード

shift_jis

シフトJISコード

euc-jp

EUCコード

utf-8

UTF-8コード

iso-8859-1

Latin1コード

us-ascii

ANSIコード

GB18030

GB18030コード（ただし，GBK範囲だけ）

上記以外

指定できない。

パラメーターがない場合，パラメーターに値がない場合，またはパラメーターに指定できない文字コードが定義されている場合は，KAVB8715-Wのメッセージを出力して，初期値で処理を継続します。

From=送信元メールアドレス

通知メールの送信元メールアドレスを定義します。

初期値は，空文字（""）です。

送信元メールアドレスは，1件だけ定義できます。

この項目は，省略できません。

送信元メールアドレスは，1〜256バイトの範囲で指定してください。

使用できる文字は，次の表に示す文字です。

表2‒65　Fromで使用できる文字コード

使用できる文字

説明

半角英数字

0-9，a-z

@

アットマーク（0x40）

.

ピリオド（0x2e）

-

ハイフン（0x2d）

_

アンダーバー（0x5f）

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字が定義されている場合，パラメーターがRFC822フォーマットではない場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

DefaultTo=デフォルトの送信先メールアドレス[,デフォルトの送信先メールアドレス…]

デフォルトの送信先メールアドレスを定義します。

初期値は，空文字（""）です。

送信先メールアドレスは，20件定義できます。複数のメールアドレスを指定する場合は，「,（コンマ）」でアドレスを区切って指定してください。

メールアドレスと「,（コンマ）」の間の半角スペース，タブは無視されます。

連続した「,（コンマ）」は一つの「,（コンマ）」と見なし，先頭と末尾の「,（コンマ）」は無視されます。同じメールアドレスを複数指定した場合，指定したアドレスにはメールを1件だけ送信します。

このパラメーターは省略できます。省略した場合，jimmailコマンドの-toオプションは必ず指定してください。

DefaultToパラメーターとjimmailコマンドの-toオプションどちらも指定されている場合，-toオプションが優先されます。

送信先メールアドレスは，1〜256バイトの範囲で指定してください。

使用できる文字は，送信元メールアドレスと同じです。

使用できない文字が指定されている場合，パラメーターがRFC822フォーマットではない場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

また，DefaultToパラメーターとjimmailコマンドの-toオプションどちらも指定がない場合は，KAVB8712-Eのメッセージを出力して，異常終了します。

SmtpServer=SMTPサーバ名

メール送信時に接続するSMTPサーバのホスト名またはIPアドレスを定義します。SMTPサーバ名のホスト名解決ができるように，次のどれかのファイルを設定します。

マネージャーホスト上のJP1/Baseのjp1hostsファイル

マネージャーホスト上のJP1/Baseのjp1hosts2ファイル

hostsファイルまたはDNS

IPアドレスは，IPv4アドレスだけを指定できます。IPv6アドレスは指定できません。

SmtpServerパラメーターの初期値は，空文字（""）です。

SMTPサーバ名は，システムで一つだけ指定します。

また，このパラメーターは省略できません。

ホスト名を指定する場合，1〜255バイトの半角文字で指定してください。

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字が定義されている場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

SmtpPort=SMTPポート番号

SMTPサーバの通信ポートのポート番号を定義します。

SmtpPortパラメーターの初期値は25です。値を取得できなかった場合，25を仮定します。ポート番号は，1〜65535の範囲で指定してください。

AuthMethodで「NONE」または「POP」を定義した場合，この項目は有効になります。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

AuthMethod=メール送信時の認証方法

メール送信時の認証方式を定義します。

このパラメーターは，省略できません。

認証方式は，次の表に示す値で定義します。初期値は「NONE」です。

表2‒66　AuthMethodの認証方式

AuthMethodの値

認証方式

NONE

認証なし

POP

POP before SMTP認証

SMTP

SMTP-AUTH認証

メール送信時の認証方式によって，メール環境定義ファイルの設定の必須・任意項目が変わります。

必須パラメーターがない場合，パラメーターに値がない場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

AuthMethodの値ごとの設定項目の一覧を次に示します。

表2‒67　AuthMethodがNONEのときの設定項目

パラメーター名

設定要否

省略

省略時の値

Charset

○

省略可能

iso-8859-1

From

○

必須

−

DefaultTo

○

省略可能

""

AuthMethod

○

必須

−

SmtpServer

○

必須

−

SmtpPort

○

省略可能

25

SmtpAuthPort

×

−

−

Pop3Server

×

−

−

Pop3Port

×

−

−

AuthUser

×

−

−

AuthPassword

×

−

−

ConnectTimeout

○

省略可能

10,000

SoTimeout

○

省略可能

10,000

MailSubjectCutting

○

省略可能

OFF

MailNewLine

○

省略可能

CRLF

（凡例）

○：設定の必要あり

×：設定の必要なし

表2‒68　AuthMethodがPOPのときの設定項目

パラメーター名

設定要否

省略

省略時の値

Charset

○

省略可能

iso-8859-1

From

○

必須

−

DefaultTo

○

省略可能

""

AuthMethod

○

必須

−

SmtpServer

○

必須

−

SmtpPort

○

省略可能

25

SmtpAuthPort

×

−

−

Pop3Server

○

必須

−

Pop3Port

○

省略可能

110

AuthUser

○

必須

−

AuthPassword

○

必須

−

ConnectTimeout

○

省略可能

10,000

SoTimeout

○

省略可能

10,000

MailSubjectCutting

○

省略可能

OFF

MailNewLine

○

省略可能

CRLF

（凡例）

○：設定の必要あり

×：設定の必要なし

表2‒69　AuthMethodがSMTPのときの設定項目

パラメーター名

設定要否

省略

省略時の値

Charset

○

省略可能

iso-8859-1

From

○

必須

−

DefaultTo

○

省略可能

""

AuthMethod

○

必須

−

SmtpServer

○

必須

−

SmtpPort

×

−

−

SmtpAuthPort

○

必須

587

Pop3Server

×

−

−

Pop3Port

×

−

−

AuthUser

○

必須

−

AuthPassword

○

必須

−

ConnectTimeout

○

省略可能

10,000

SoTimeout

○

省略可能

10,000

MailSubjectCutting

○

省略可能

OFF

MailNewLine

○

省略可能

CRLF

（凡例）

○：設定の必要あり

×：設定の必要なし

SmtpAuthPort=SMTP-AUTH認証のサブミッションポート番号

SMTP-AUTH認証用の通信ポートのサブミッションポート番号を定義します。初期値は587です。値を取得できなかった場合，587を仮定します。ポート番号は，1〜65535の範囲で指定してください。

SMTP-AUTH認証を使用する場合，接続メールサーバがサブミッションポートを使用しないときは，SmtpAuthPortパラメーターには，接続するSMTPサーバが使用する宛先ポート番号を指定してください。

AuthMethodで「SMTP」を定義した場合，この項目は有効になります。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

Pop3Server=POP3サーバ名

POP before SMTP認証で使用するPOP3サーバのホスト名またはIPアドレスを定義します。POP3サーバ名のホスト名解決ができるように，次のどれかのファイルを設定します。

マネージャーホスト上のJP1/Baseのjp1hostsファイル

マネージャーホスト上のJP1/Baseのjp1hosts2ファイル

hostsファイルまたはDNS

IPアドレスは，IPv4アドレスを指定できます。IPv6アドレスは指定できません。

メールサーバがSMTPサーバとPOP3サーバを兼ねている場合，SmtpServerに指定したSMTPサーバ名を指定してください。

POP3サーバ名は，システムで一つだけ指定してください。

POP3サーバのホスト名を指定する場合，1〜255バイトの半角文字で指定します。初期値は，空文字（""）です。POP3サーバのホスト名に使用できる文字は，SMTPサーバのホスト名に使用できる文字と同じです。

AuthMethodで「POP」を定義した場合，この項目は有効になります。有効の場合，このパラメーターの指定は必須です。

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字が定義されている場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

Pop3Port=POP3ポート番号

POP before SMTP認証で使用するPOP3サーバの通信ポートのポート番号を定義します。

パラメーターの初期値は110です。値を取得できなかった場合，110を仮定します。ポート番号は，1〜65535の範囲で指定してください。

AuthMethodで「POP」を定義した場合，この項目は有効になります。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

AuthUser=認証アカウント名

AuthUserパラメーターでは，POP before SMTP認証またはSMTP-AUTH認証で使用する認証アカウント名を定義します。

認証アカウント名は，1〜255バイトの半角文字で指定します。

初期値は空文字（""）です。

AuthMethodパラメーターに「POP」または「SMTP」を指定した場合，この項目は有効になります。

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字（マルチバイト）が定義されている場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

AuthPassword=認証パスワード

AuthPasswordパラメーターでは，POP before SMTP認証またはSMTP-AUTH認証の認証パスワードが設定されます。

AuthPasswordパラメーターの認証パスワードはjimmailpasswdコマンドで設定します。

メール環境定義ファイルを直接編集してAuthPasswordパラメーターに平文のパスワードを設定した場合，メールサーバ接続時に認証パスワードが一致しないため，メールサーバにログインできません。

AuthMethodパラメーターに「POP」または「SMTP」を指定した場合，この項目は有効になります。

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字（マルチバイト）が指定されている場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

ConnectTimeout=ネットワーク接続タイムアウト時間

ConnectTimeoutパラメーターには，SMTPとPOP3サーバとの接続完了を待つタイムアウト時間をミリ秒単位で定義します。初期値は10,000ミリ秒（10秒）です。

タイムアウト時間は1,000〜3,600,000（1〜3,600秒）の範囲で指定します。

初期値で接続タイムアウトが発生する場合だけ，運用環境に合わせて変更してください。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

SoTimeout=通信タイムアウト時間

SoTimeoutパラメーターには，SMTPとPOP3サーバからの応答を受信するまでのタイムアウト時間をミリ秒単位で定義します。初期値は10,000ミリ秒（10秒）です。

タイムアウト時間は1,000〜3,600,000（1〜3,600秒）の範囲で指定します。

初期値で通信タイムアウトのエラーが発生する場合だけ，運用環境に合わせて変更してください。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

MailSubjectCutting=メール主題の切り捨て設定

MailSubjectCuttingパラメーターには，メール送信時にメール主題が最大長を超えていた場合にメールの主題を切り捨てて強制的に送信を行うかを定義します。

「OFF」の場合は，メールの主題は切り捨てないで，jimmailコマンドが異常終了します。

「ON」の場合は，メールの主題をCharsetパラメーターで指定したメールの文字コードに従い512バイト以内になるように切り捨てて，メール送信を継続します。

初期値は，「OFF」です。設定値は大文字・小文字の区別はしません。

パラメーターがない場合，パラメーターに値がない場合，またはパラメーターに「ON」「OFF」以外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

MailNewLine=メール本文の改行コード

MailNewLineパラメーターには，メール本文で使用する改行コードを定義します。jimmailコマンドは，コマンドのオプション引数で指定した改行文字「¥n」を，このパラメーターで指定した改行コードに置き換えてメール送信します。初期値は，「CRLF」です。

設定値は，大文字・小文字を区別しません。

RFCでメールの改行コードは「CRLF」と規定されていて，理由がないかぎり初期値から変更しないでください。メールサーバによっては，「CRLF」以外の改行コードを使用した場合，メール送信に失敗したり，メールの改行が行われなかったりなどの問題が発生するおそれがあります。

改行コードは，次の表に示す値で定義します。

表2‒70　MailNewLineの設定値

設定値

説明

CRLF

CR（0x0d）+LF（0x0a）

LF

LF（0x0a）

CR

CR（0x0d）

パラメーターがない場合，パラメーターに値がない場合，またはパラメーターに範囲外の値が定義されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

定義例

インストール直後の日本語環境のメール環境定義ファイルを次に示します。

Charset=iso-2022-jp
From=
DefaultTo=
SmtpServer=
SmtpPort=25
AuthMethod=NONE
SmtpAuthPort=587
Pop3Server=
Pop3Port=110
AuthUser=
AuthPassword=
ConnectTimeout=10000
SoTimeout=10000
MailSubjectCutting=OFF
MailNewLine=CRLF

インストール直後の日本語環境以外のメール環境定義ファイルを次に示します。

Charset=iso-8859-1
From=
DefaultTo=
SmtpServer=
SmtpPort=25
AuthMethod=NONE
SmtpAuthPort=587
Pop3Server=
Pop3Port=110
AuthUser=
AuthPassword=
ConnectTimeout=10000
SoTimeout=10000
MailSubjectCutting=OFF
MailNewLine=CRLF

表示メッセージ変更定義ファイル（jcochmsg.conf）

形式

DESC_VERSION=1
#表示メッセージ変更定義のコメント
def 定義名1
    [cmt コメント]
    [define {enable | disable}]
    [addflag {true | false}]
    cnd
        イベント条件
    end-cnd
    msg メッセージ
end-def

def 定義名2
    [cmt コメント]
    [define {enable | disable}]
    [addflag {true | false}]
    cnd
        イベント条件
    end-cnd
    msg メッセージ
end-def

ファイル

jcochmsg.conf（表示メッセージ変更定義ファイル）

jcochmsg.conf.model（表示メッセージ変更定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chattr¥ jcochmsg.conf

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chattr¥jcochmsg.conf

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chattr/jcochmsg.conf

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chattr/jcochmsg.conf

説明

表示メッセージ変更機能でメッセージの表示を変更するJP1イベントの条件と，変更後のメッセージを定義するファイルです。このファイルの定義に従い，イベント条件に一致するJP1イベントの属性を変更します。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

このファイルの最大サイズは，22メガバイト（23,068,672バイト）です。

表示メッセージ変更定義ファイルのパラメーターには，次の2種類があります。

表示メッセージ変更定義ファイルバージョン

表示メッセージ変更定義ファイルのフォーマットのバージョンを定義します。

表示メッセージ変更定義パラメーター

表示メッセージを変更するJP1イベントの条件と変更後の表示メッセージを定義します。表示メッセージ変更定義ファイルで上に記述されている表示メッセージ変更定義ほど，優先順位が高くなります。

定義の反映時期

イベントの表示メッセージ変更機能が有効で，次のどれかが成立する場合に有効になります

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドを実行した場合

［表示メッセージ変更定義を設定］メニューから開いた［追加表示メッセージ変更定義設定］画面で［OK］ボタンをクリックした場合

［表示メッセージ変更定義一覧］画面で［適用］ボタンをクリックした場合

記述内容（表示メッセージ変更定義ファイルバージョン）

DESC_VERSION

DESC_VERSIONには，表示メッセージ変更定義ファイルの形式を決定するファイルバージョンをバージョン情報として定義します。指定する値は1です。DESC_VERSIONの指定を省略した場合，ファイルバージョンを1と見なして処理します。

DESC_VERSIONは，定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に記載します。先頭行にファイルバージョンがなかった場合は，ファイルバージョンを1と見なして処理します。

記述内容（表示メッセージ変更定義パラメーター）

表示メッセージ変更定義パラメーターは，図に示すとおり，定義ブロックとイベント条件ブロックで構成されています。

図2‒9　表示メッセージ変更パラメーター

定義ブロックは複数指定できます。指定できる定義ブロックの数は，0〜3,000個です。定義ブロックの数が最大数を超えていた場合，KAVB4640-Wのメッセージを出力し，3,001個以降の定義ブロックを無視して処理を続行します。

def〜end-def（定義ブロック）

表示メッセージ変更定義の開始と終了のパラメーターです。def〜end-defブロックは省略でき，この場合「すべてのJP1イベントのメッセージ変更をしない」と解釈します。

def以降には，表示メッセージ変更定義の定義名を記述します。「def△△△定義1△△△定義2△△△」と指定した場合，「△△定義1△△△定義2△△△」が定義名となります（△は半角スペースを表す）。

定義名は，表示メッセージ変更定義ファイル内で一意になるように1〜50バイトの文字列を指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

cmt コメント

表示メッセージ変更定義のコメントを記述します。cmtに指定されたコメントは，［表示メッセージ変更定義設定］画面のコメント欄に表示されます。cmtパラメーターは，定義ブロック内に一つだけ指定できます。このパラメーターは省略できます。コメントは1,024バイト以内で指定してください。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

define {enable | disable}

表示メッセージ変更定義を有効にするかどうかを指定します。defineパラメーターは，定義ブロック内に一つだけ指定できます。表示メッセージ変更定義を有効にする場合は「enable」を，無効にする場合は「disable」を指定します。defineパラメーターは，省略できます。デフォルトは，「enable」です。英大文字・英小文字は区別しません。

addflag {true | false}

追加表示メッセージ変更定義を画面から追加したことを示すパラメーターで，表示メッセージ変更定義が追加表示メッセージ変更定義かどうかを指定します。そのため，表示メッセージ変更定義ファイルを編集する場合は，addflagパラメーターを指定する必要はありません。addflagパラメーターは定義ブロック内に一つだけ指定できます。追加表示メッセージ変更定義の場合は「true」を，表示メッセージ変更定義の場合は「false」を指定します。「true」を指定した場合は，［表示メッセージ変更定義一覧］画面の［種別］にアイコン（[図データ]）が表示されます。addflagパラメーターは，省略できます。デフォルトは，「false」です。英大文字・英小文字は区別しません。

cnd〜end-cnd（イベント条件ブロック）

表示メッセージを変更するJP1イベントのイベント条件を指定する，ブロックの開始と終了のパラメーターです。イベント条件ブロックは，定義ブロック内に必ず一つ指定します。省略はできません。受信したJP1イベントが，複数のイベント条件に一致する場合，表示メッセージ変更定義ファイルの先頭に近い定義ブロックが優先されます。cndおよびend-cndパラメーターの前後のタブやスペースは，無視されます。

イベント条件

表示メッセージを変更するJP1イベントの条件を指定します。イベント条件ブロックに指定できるイベント条件は0〜256件です。イベント条件とイベント条件は，AND条件となります。イベント条件は，次の形式で指定します（△は半角スペースを表す）。

　属性名△比較キーワード△オペランド[△オペランド]…

なお，半角スペースまたはタブだけで構成された行は，無視して処理を続行します。

・属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2‒71　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番

項目

属性名

比較

キーワード

オペランド

1

イベントID

B.ID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

16進数形式で指定する。大文字・小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

3

発行元プロセスID

B.PROCESSID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

4

発行元ユーザーID

B.USERID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

5

発行元グループID

B.GROUPID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

6

発行元ユーザー名

B.USERNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

7

発行元グループ名

B.GROUPNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

8

発行元イベントサーバ名(登録ホスト名)※1

B.SOURCESERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

9

送信先イベントサーバ名※1

B.DESTSERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

10

メッセージ

B.MESSAGE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

11

重大度

E.SEVERITY

と一致する

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。"Emergency"，"Alert"，"Critical"，"Error"，"Warning"，"Notice"，"Information"，"Debug"のどれかを指定できる。

12

ユーザー名

E.USER_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

13

プロダクト名

E.PRODUCT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

14

オブジェクトタイプ

E.OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

15

オブジェクト名

E.OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

16

登録名タイプ

E.ROOT_OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

17

登録名

E.ROOT_OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

18

オブジェクトID

E.OBJECT_ID

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

19

事象種別

E.OCCURRENCE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

20

終了コード

E.RESULT_CODE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

21

発生元ホスト名※1

E.JP1_SOURCEHOST

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

22

固有の拡張属性※3

E.xxxxxxx

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

属性名には，先頭が英大文字で英大文字，数字，およびアンダーバー（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

注※1

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

注※2

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

・比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

・オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。%のあとに指定する文字コードは，英大文字・英小文字を区別しません。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

msg

表示用のメッセージを記述するパラメーターです。

msgパラメーターは，定義ブロック内に必ず一つ指定します。省略はできません。

msgは1,023バイト以内で指定してください。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

msgパラメーターが，定義ブロックの外で指定された場合，KAVB4629-Wのメッセージを出力し，msgパラメーターの指定を無視して処理を続行します。

また，msgパラメーターが以下の場合，KAVB4631-Wのメッセージを出力し，エラーがあった定義ブロックを無視して処理を続行します。

msgパラメーターを省略した場合

msgパラメーターの指定が複数ある場合

msgパラメーターに指定したメッセージが1,023バイトを超える場合

msgパラメーターに指定したメッセージに制御文字が指定されていた場合

変更後のメッセージに$EVSEVのように変数を指定すると，イベントの属性値の引き継ぎができます。

指定できる変数を次に示します。

情報の種類

変数名

内容

JP1イベント基本属性に含まれる情報

EVBASE

イベント基本情報全体※1

EVID

イベントID（基本コード:拡張コード）

EVIDBASE

イベントID（基本コード）

EVDATE

イベント登録日（YYYY/MM/DD）※2

EVTIME

イベント登録時刻（hh:mm:ss）※2

EVPID

イベント発行元プロセスID

EVUSRID

イベント発行元プロセスのユーザーID

EVGRPID

イベント発行元プロセスのグループID

EVUSR

イベント発行元ユーザー名

EVGRP

イベント発行元グループ名

EVHOST

イベント発行元ホスト名

EVIPADDR

イベント発行元IPアドレス

EVSEQNO

イベントDB内通し番号

EVARVDATE

イベント到着日（YYYY/MM/DD）※2

EVARVTIME

イベント到着時刻（hh:mm:ss）※2

EVSRCNO

イベント発生元のイベントDB内通し番号

EVMSG

メッセージテキスト全体※3

EVDETAIL

イベント詳細情報全体※3，※4

JP1イベント拡張属性に含まれる情報

EVSEV

イベント拡張情報重大度（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）※3

EVUSNAM

ユーザー名※3

EVOBTYP

オブジェクトタイプ※3

EVOBNAM

オブジェクト名※3

EVROBTYP

登録タイプ※3

EVROBNAM

登録名※3

EV"PRODUCT_NAME"

プロダクト名※5

EV"OBJECT_ID"

オブジェクトID※5

EV"OCCURRENCE"

事象種別※5

EV"START_TIME"

開始時刻※5

EV"END_TIME"

終了時刻※5

EV"RESULT_CODE"

終了コード※5

EV"JP1_SOURCEHOST"

発生ホスト名※5

EV"拡張属性名"

任意の拡張属性※5

その他

EV"@JP1IM_CORRELATE"

相関イベントフラグ

相関イベントではない：0

相関成立イベントである：1

相関不成立イベント：2

EV"@JP1IM_ORIGINAL_SEVERITY"

イベント拡張情報重大度(変更前)

（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）※3

EV"@JP1IM_CHANGE_SEVERITY"

重大度変更フラグ

重大度を変更していない：0

重大度を変更した：1

ACTHOST

マネージャーホスト名の値※3

EVENV1〜EVENV20

イベント条件の指定で，正規表現中に"( )"を指定して切り出したデータ※5

（マネージャーホストで拡張正規表現を使用している場合だけ使用できる）

注※1

JP1イベントの基本情報が次の形式に変換されて変更後のメッセージに渡されます（△は半角スペース）。

イベントID△イベント発行元ユーザー名△イベント発行元ユーザーID△イベント発行元グループ名△イベント発行元グループID△イベント発行元イベントサーバ名△イベント発行元プロセスID△イベント登録年月日△イベント登録時刻△イベント発行元ホストIPアドレス

設定されていない項目は空文字となります。

注※2

JP1/IM - Managerのタイムゾーンで変換して変更後のメッセージに渡されます。

注※3

該当する属性が存在しない場合，メッセージ変更時に変数が空文字に変換されて変更後のメッセージに渡されます。

注※4

JP1イベントの詳細属性の情報がバイナリー形式の場合は，変数が空文字に変換されて変更後のメッセージに渡されます。

注※5

該当する属性が存在しない場合，変数の文字列がそのまま変更後のメッセージに渡されます。

変数の記述での注意点

「$」を文字として指定したい場合は，エスケープ文字「¥」を「$」の前に指定します。

変数の直後に文字を記述する場合，変数の直後に英数字および「_」を指定すると正しく変換されません。このような場合は，変数を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

（指定例）

表示メッセージ変更定義 → 変換後の情報

「$EVID abc」 → 「100:0 abc」

「$EVIDabc」 → 「$EVIDabc」

「${EVID}abc」 → 「100:0abc」

「$EVID_abc」 → 「$EVID_abc」

「${EVID}_abc」 → 「100:0_abc」

「$EV"EX" abc」 → 「ABC abc」

「$EV"EX"abc」 → 「ABCabc」

変数名以外が指定された場合，変数が記述されている個所をイベント引き継ぎ情報に変換されません。例えば，指定していない変数名「AAA」を「$AAA」として指定した場合，変更後のメッセージには「$AAA」が設定されます。

EV"拡張属性名"，EVENV1〜EVENV20で指定された属性の値が取得できなかった場合，変数が記述されている個所をイベント引き継ぎ情報に変換されません。例えば，「$EV"BBB"」と指定している場合，JP1イベントに拡張属性「BBB」がないとき，変更後のメッセージには「$EV"BBB"」が設定されます。

EV"拡張属性名"，EVENV1〜EVENV20以外の変数で指定された属性の値が取得できなかった場合は，変数が記述されている個所を空文字に変換されます。例えば，「$EVSEV」を指定しているとき，JP1イベントに拡張属性「SEVERITY」がなければ，変更後のメッセージには「」（空文字）が設定されます。

正規表現を使ったイベント条件が複数ある場合は上から順に，さらに記述された正規表現に"( )"が複数ある場合は左から順に，EVENV1〜EVENV20まで順次対応付けがされます。

イベント引き継ぎ情報の変換機能

イベント引き継ぎ情報をユーザーが指定した長さの文字列に変換できます。メッセージIDや日付などを固定長にそろえて，イベント一覧に見やすく表示できます。

イベント引き継ぎ情報の長さがユーザーの指定した長さ未満の場合は，半角スペースを追加し，指定した長さにします。

イベント引き継ぎ情報の長さがユーザーの指定した長さより大きい場合は，イベント引き継ぎ情報をユーザーが指定した長さに切り捨てます。

マルチバイト文字が切り捨てられる場合は，文字が壊れないように切り捨てられます。切り捨て後の長さがユーザーの指定した長さに満たない場合は，半角スペースが追加されます。

＜指定形式＞

$変数名$FIXLEN=<バイト数>

バイト数には1〜1,023の数値を指定します。指定形式が不正な場合は，「$FIXLEN=<バイト数>」を文字列として扱います。

変数名を｛｝で囲むことにより，パラメーターとして扱う位置を指定できます。

項番

指定形式

$変数名の文字列

メッセージに設定する文字列

備考

1

$変数名$FIXLEN=6

ABC

ABC△△△

指定した長さより短いため，足りない桁に半角スペースを追加する。

2

ABCDEFG

ABCDEF

指定した長さより長いため，文字列を切り捨てる。

3

$変数名$FIXLEN=1024

ABC

ABC$FIXLEN=1024

指定している値が最大数1023を超えているので，文字列として扱う。

4

$変数名$FIXLEN=10225

ABC

ABC△…△5

△…△：△が1,019個を表す

$FIXLEN=の後ろの文字列は4文字だけがパラメーターとなり，5文字目以降は文字列として扱う。

5

${変数名$FIXLEN=10}235

ABC

ABC△△△△△△△235

「10」までを｛｝で囲みパラメーターとして扱い，「235」を文字列として扱う。

（凡例） △：半角スペース

メッセージの数値にゼロ埋めをして，表示する数値の桁数を揃えることができます。秒数を示す数値を「ss」「ss. sss」「ss.ssssss」等のフォーマットに変換したい場合に使用します。

＜指定形式＞

$変数名$FIXNUM=<00>.<000000>

整数は0〜2桁，小数は0〜6桁が指定できます。

変数に格納されている値が数値の文字列の場合も変換できます。

数値以外の文字列が設定されている場合，整数が指定した桁数より多い場合，または変数に格納されている値が100以上の場合は変換しません。

小数が指定した桁数より多い場合は，小数以下は切り捨てます。また，変数に格納されている値に小数第７位以降が設定されている場合も切り捨てます。

項番

指定形式

$変数名の文字列

メッセージに設定する文字列

備考

1

$変数名$FIXNUM=00.000

1

01.000

整数，小数の足りない桁はゼロ埋めする。

2

123.123456

123.123456

値が100以上のため，変換しない。

3

$変数名$FIXNUM=0.00

15

15.00

整数が指定した桁数（1桁）より多いため，整数は変換しない。

4

$変数名$FIXNUM=00

1

01

整数の足りない桁はゼロ埋めする。

5

1.5

01

小数が指定した桁数より多い場合は，小数以下は切り捨る。

6

$変数名$FIXNUM=00.000000

0.1234567

00.123456

小数第７位以降は切り捨てる。

7

$変数名$FIXNUM=.00

1

1.00

小数の足りない桁はゼロ埋めする。

8

$変数名$FIXNUM=00.

1

01

整数の足りない桁はゼロ埋めする。

9

$変数名$FIXNUM=ABC

1

1$FIXNUM=ABC

$FIXNUMの指定が不正なため，文字列として扱う。

10

$変数名$FIXNUM=0.00

ABC

ABC

$変数名の値が数値以外のため，変換しない。

11

0.0000000A

0.0000000A

1970/01/01からの経過秒数を年，月，日，時，分，秒の文字列に変換します。

マネージャーホストのタイムゾーンで変換します。

変数に格納されている値が0〜2,147,483,647の数値の文字列以外の場合，変換しません。

項番

指定形式

変換内容

1

$変数名$YEAR

1970/01/01からの経過秒数を年に変換する。

変換後はYYYY形式で出力する。出力する年数が４桁未満でもゼロ埋めして4桁にする。

2

$変数名$MONTH

1970/01/01からの経過秒数を月に変換する。

変換後はMM形式で出力する。出力する月が2桁未満でもゼロ埋めして2桁にする。

3

$変数名$DAY

1970/01/01からの経過秒数を日に変換する。

変換後はDD形式で出力する。出力する日が2桁未満でもゼロ埋めして2桁にする。

4

$変数名$HOUR

1970/01/01からの経過秒数を時に変換する。

変換後はhh形式で出力する。出力する時が2桁未満でもゼロ埋めして2桁にする。

時間は24時間表記で出力する。

5

$変数名$MIN

1970/01/01からの経過秒数を分に変換する。

変換後はmm形式で出力する。出力する分が2桁未満でもゼロ埋めして2桁にする。

6

$変数名$SEC

1970/01/01からの経過秒数を秒に変換する。

変換後はmm形式で出力する。出力する秒が2桁未満でもゼロ埋めして2桁にする。

フォーマット変換の機能は連続して指定できます。

連続してフォーマット変換の機能を指定した場合，左にあるフォーマット変換の指定から順に変換します。

先に実行したフォーマット変換が失敗した場合でも，後続のフォーマット変換の処理は実行されます。

図2‒10　連続したフォーマット変換

#コメント行

#で始まる行は，コメント扱いとなります。なお，JP1/IM - Viewから表示メッセージ変更定義を設定した場合，#のコメント行は削除されます。

定義例

イベントIDが100または200に一致，かつ重大度がWarningで，かつ登録ホストがhostA，hostB，hostCに一致する場合に，メッセージの先頭に日付時刻を付加して「DBサーバで障害が発生しました」に変更する例を次に示します。

DESC_VERSION=1
def 表示メッセージ変更1
    cmt コメント1
    define enable
    addflag false
    cnd
        B.ID IN 100 200
        E.SEVERITY IN Warning
        B.SOURCESERVER IN hostA hostB hostC
    end-cnd
    msg $EVDATE $EVTIME DBサーバで障害が発生しました
end-def

HntrログのメッセージID，メッセージテキスト部分を抽出する例を次に示します。

DESC_VERSION=1
def 表示メッセージ変更1
    cmt コメント1
    define enable
    addflag false
    cnd
        E.OBJECT_TYPE IN LOGFILE
        E.OBJECT_NAME SUBSTR HNTRLib2
        E.ROOT_OBJECT_TYPE IN LOGFILE
        E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
        B.MESSAGE REGEX [0-9]{4}%20[0-9]{4}/[0-9]{2}/[0-9]{2}%20[0-9]{2}:[0-9]{2}:[0-9]{2}¥.[0-9]{3}[%20]+.*[%20]+[0-9A-Z]+%20[0-9A-Z]+[%20]+([^%20]+)[%20]+(.*)
    end-cnd
    msg $EVENV1 $EVENV2
end-def

特定プロダクトのメッセージの先頭に，一律で文字列を追加する例を次に示します。

DESC_VERSION=1
    def 表示メッセージ変更1
    cmt コメント1
    define enable
    addflag false
    cnd
        E.PRODUCT_NAME IN PRODUCT_A
    end-cnd
    msg [製品A]$EVMSG
end-def

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）

形式

# コメント行
属性名
属性名
　・
　・
属性名

ファイル

chmsg_attr_list.conf（表示メッセージ変更定義表示項目定義ファイル）

chmsg_attr_list.conf.model（表示メッセージ変更定義表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chattr¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chattr¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chattr/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chattr/attr_list

説明

［表示メッセージ変更定義設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。表示メッセージ変更定義表示項目定義ファイルに指定された表示項目を指定された順番で［表示メッセージ変更定義設定］画面の［属性名］表示領域に表示します。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

表示メッセージ変更定義表示項目定義ファイルには，［表示メッセージ変更定義設定］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

SEPARATORを指定すると，［表示メッセージ変更定義設定］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択しても，属性名は設定できません。

指定できる属性名を次の表に示します。

表2‒72　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

送信先イベントサーバ名

B.DESTSERVER

14

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

15

登録要因

B.REASON

16

発行元プロセスID

B.PROCESSID

17

発行元ユーザー名

B.USERNAME

18

発行元ユーザーID

B.USERID

19

発行元グループ名

B.GROUPNAME

20

発行元グループID

B.GROUPID

21

オブジェクトID

E.OBJECT_ID

22

終了コード

E.RESULT_CODE

23

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，表示メッセージ変更定義表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜22が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［表示メッセージ変更定義設定］画面には表示されません。

定義例

E.JP1_SOURCEHOST
B.SOURCESERVER
E.SEVERITY
E.OBJECT_TYPE
E.OBJECT_NAME
E.ROOT_OBJECT_TYPE
E.ROOT_OBJECT_NAME
E.OCCURRENCE
E.USER_NAME
B.MESSAGE
E.PRODUCT_NAME
B.ID
B.DESTSERVER
OTHER_EXTENDED_ATTRIBUTE
B.REASON
B.PROCESSID
B.USERNAME
B.USERID
B.GROUPNAME
B.GROUPID
E.OBJECT_ID
E.RESULT_CODE

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）

形式

# コメント行
[DEFAULT_NAME 表示メッセージ変更定義名]
属性名
属性名
　・
　・
属性名
属性名

ファイル

chmsg_auto_list.conf（表示メッセージ変更定義自動入力定義ファイル）

chmsg_auto_list.conf.model（表示メッセージ変更定義自動入力定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chattr¥auto_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chattr¥auto_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chattr/auto_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chattr/auto_list

説明

［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［表示メッセージ変更定義を設定］メニューを選択して［追加表示メッセージ変更定義設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。また，表示メッセージ変更定義名のデフォルト名も定義できます。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

DEFAULT_NAME 表示メッセージ変更定義名

表示メッセージ変更定義名を定義する識別子を表しています。識別子は，コメントと空行を除いたファイルの先頭に記述してください。

このパラメーターに指定した表示メッセージ変更定義名が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［表示メッセージ変更定義を設定］を選択して［追加表示メッセージ変更定義設定］画面を開いたときに，初期値として表示されます。

40バイトまでの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。40バイトを超えて指定した場合，41バイト以上の文字列を切り捨てた文字列が表示メッセージ変更定義名となります。指定しなかった場合，「追加表示メッセージ変更定義」が表示メッセージ変更定義名となります。

属性名

表示メッセージ変更定義自動入力定義ファイルには，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［表示メッセージ変更定義を設定］を選択して［追加表示メッセージ変更定義設定］画面を開いたときに，イベント条件として設定されるJP1イベントの属性を指定します。このパラメーターに指定した属性名の条件が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［表示メッセージ変更定義を設定］を選択して［追加表示メッセージ変更定義設定］画面を開いたときに，初期値として表示されます。

定義項目は，設定されるJP1イベントの属性名を1行に1件記述します。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

有効な属性名が0件のときは，KAVB1952-Wメッセージを統合トレースログに出力し，デフォルト値項目を使用します。

同じ属性名が複数指定されていた場合，その値は無視し，KAVB1954-Wメッセージを統合トレースログに出力します。

［表示メッセージ変更定義設定］画面の［イベント条件］に自動的に表示されるJP1イベントの属性の順序は，表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）の属性の記載順に設定されます。

指定できる属性名でない場合は，KAVB1953-Wメッセージを統合トレースログに出力し，その属性名を無視されます。

指定できる属性名を次の表に示します。

表2‒73　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

送信先イベントサーバ名

B.DESTSERVER

14

登録要因

B.REASON

15

発行元プロセスID

B.PROCESSID

16

発行元ユーザー名

B.USERNAME

17

発行元ユーザーID

B.USERID

18

発行元グループ名

B.GROUPNAME

19

発行元グループID

B.GROUPID

20

オブジェクトID

E.OBJECT_ID

21

終了コード

E.RESULT_CODE

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，表示メッセージ変更定義自動入力定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜3，項番10〜12が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［追加表示メッセージ変更定義設定］画面には表示されません。

定義例

DEFAULT_NAME 表示メッセージ変更定義名
E.JP1_SOURCEHOST
B.SOURCESERVER
E.SEVERITY
B.MESSAGE
E.PRODUCT_NAME
B.ID

表示メッセージ変更後イベント環境定義ファイル（chmsgevent.conf）

形式

[論理ホスト名¥JP1CONSOLEMANAGER]
"SEND_CHANGE_MESSAGE_EVENT"=dword:16進数値

ファイル

chmsgevent.conf（表示メッセージ変更後イベント環境定義ファイル）

chmsgevent.conf.update（表示メッセージ変更後イベント環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

表示メッセージ変更した後にイベントを発行する機能の実行環境の情報を定義するファイルです。機能を有効にするかどうかを指定します。

定義の反映時期

JP1/Baseのjbssetcnfコマンドで，表示メッセージ変更後イベント環境定義ファイルをJP1共通定義情報に反映した後に，JP1/IM - Managerを再起動すると有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER]

JP1/IM - Managerの環境設定のキー名称を示します。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"SEND_CHANGE_MESSAGE_EVENT"=dword:16進数値

表示メッセージ変更した後にイベントを発行する機能を有効にするかどうかを指定します。

00000001：有効（表示メッセージ変更した後にイベントを発行する）

00000000：無効（表示メッセージ変更した後にイベントを発行しない）

デフォルトは「00000000」（無効）です。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER]
"SEND_CHANGE_MESSAGE_EVENT"=dword:00000000

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

形式

<HTML>
<HEAD>
<META HTTP-EQUIV="refresh" CONTENT="0;URL=他製品のWWWページのURL">
</HEAD>
</HTML>

ファイル

hitachi_jp1_製品名.html（WWWページ呼び出し定義ファイル）

hitachi_jp1_製品名.html.model（WWWページ呼び出し定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥webdata¥ja¥

説明

統合機能メニューから他製品のWWWページを呼び出すときに使用するファイルです。

統合機能メニューから他製品のWWWページを呼び出す場合，いったんWWWページ呼び出し定義ファイルを参照し，このファイルで定義されているURLにジャンプするようになっています。ユーザーは，他製品のWWWページを統合機能メニューから呼び出す場合，自分の環境に合わせてこのファイルに記述されたURLを編集する必要があります。

なお，URLの編集をせずに統合機能メニューからWWWページを表示しようとすると，設定方法を記述したページが表示されます。

WWWページ呼び出し定義ファイル一覧

JP1/IMでは，次の表に示す定義ファイルを提供しています。連携製品の対応バージョン，および対応OSの詳細については，各連携製品のマニュアルをご確認ください。

表2‒74　統合機能メニューの名称と対応するWWWページ呼び出し定義ファイル一覧

統合機能メニューのメニュー項目

WWWページ呼び出し定義ファイル名

製品名

フォルダ名

サブフォルダ名

機能名

ネットワーク管理

−

ネットワークノードマネージャー

hitachi_jp1_cm2.html

JP1/Cm2/NNM

HP NNM

資産・配布管理

−

統合資産管理

hitachi_jp1_assetinfomationmanager.html

JP1/NETM/Asset Information Manager

−

資産・配布管理※

hitachi_jp1_netmdm.html

JP1/NETM/DM Manager

ストレージ管理

ストレージエリア管理

ストレージシステム稼働管理

hitachi_jp1_hicommand_tuning_manager.html

JP1/HiCommand Tuning Manager

ストレージハードウェア管理

hitachi_jp1_hicommand_device_manager.html

JP1/HiCommand Device Manager

ストレージリソース割り当て管理

hitachi_jp1_hicommand_provisioning_manager.html

JP1/HiCommand Provisioning Manager

ストレージレプリケーション管理

hitachi_jp1_hicommand_replication_manager.html

Hitachi Replication Manager

階層ストレージリソース管理

hitachi_jp1_hicommand_tiered_storage_manager.html

JP1/HiCommand Tiered Storage Manager

グローバル入出力パス稼働管理

hitachi_jp1_hicommandGLAM.html

JP1/HiCommand Global Link Availability Manager

サーバ管理

−

Webコンソール

hitachi_jp1_systemmanager.html

JP1/Server Conductor

（凡例）

−：なし

注※

Windows版のJP1/IM - Viewでは，JP1/NETM/DM ManagerのWWWページ版との連携はできません。JP1/NETM/DMは日本国内の製品名称です。

［WWWページ呼び出し定義ファイル名］列に記載しているhtmlファイルに記述されたURLを各製品のWWWページのURLに変更することで，［統合機能メニュー］画面からほかの製品のWWWページを起動できるようになります。

定義の反映時期

JP1/IM - Viewを再起動すると，有効になります。

記述内容

<META HTTP-EQUIV="refresh" CONTENT="0;URL=他製品のWWWページのURL">

他製品のWWWページのURLを指定します。

なお，URLの編集をせずに統合機能メニューから他製品のWWWページを表示しようとすると，設定方法を記述したページ※（Viewパス¥conf¥webdata¥ja¥webconfig_hitachi_jp1_製品名.html）が表示されます。このページを参考にしてURLを指定してください。

注※

・このページに記述されたURLは標準的な値です。製品によってはユーザーがURLをカスタマイズできるものがあるため，他製品側で使用しているURLを事前にご確認ください。

また，他製品のバージョンアップなどによってURLが変更になる場合があります。URLを設定しても画面が起動されない場合には，各製品のマニュアルなどをご確認ください。

・「ホスト名」には，WWWページに対応する製品をインストールしたマシンのホスト名またはIPアドレスを指定してください。

定義例

<HTML>
<HEAD>
<META HTTP-EQUIV="refresh" CONTENT="0;URL=http://hostA/OvCgi/ovlaunch.exe">
</HEAD>
</HTML>

統合機能メニュー定義ファイル

形式

@file type="定義ファイルタイプ", version="定義フォーマットバージョン";
#コメント行
@define-block type="function-tree-def";
フォルダ定義
機能定義
@define-block-end;

ファイル

!JP1_CC_FTREE0.conf（統合機能メニュー定義ファイル）

!JP1_CC_FTREE0.conf.model（統合機能メニュー定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥function¥ja¥

説明

統合機能メニュー定義ファイルは，JP1/IM - Viewの［統合機能メニュー］画面に表示するツリー構造や表示項目などを定義するためのファイルです。

なお，JP1/IMには，統合機能メニュー定義ファイルの記述内容をチェックするためのコマンド「jcofuncfcheck」が用意されています。このコマンドの詳細については，「jcofuncfcheck（Windows限定）」（1.　コマンド）を参照してください。

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

@file type="function-definition"

この定義ファイルが統合機能メニュー定義ファイルであることを宣言します。このステートメントは必須です。

常にfunction-definitionを指定してください。

このステートメントは，ファイル内の先頭行に記述しなければなりません。

version="0300";

常に0300を指定してください。

#コメント行

#で始まる行は，コメント扱いとなります。

@define-block type="function-tree-def"; 〜 @define-block-end;（統合機能メニュー定義ブロック）

［統合機能メニュー］画面に表示するフォルダまたは機能を作成し，機能が選択されたときに実行するアプリケーションとの関連をアプリケーション実行定義識別子で定義します。

なお，［統合機能メニュー］画面に表示される機能の順序はファイル名順になります。一つのファイル内では，定義ブロック順になります。メニューの表示順序を変更したい場合は，これらの順序を変更してください。

このブロックに記述できるステートメントは，フォルダを定義する場合と機能を定義する場合で異なります。

表2‒75　ステートメント

フォルダを定義する場合

機能を定義する場合

idステートメント

parent_idステートメント

nameステートメント

idステートメント

parent_idステートメント

nameステートメント

execute_idステートメント

iconステートメント

argumentsステートメント

これ以外のステートメントが記述された場合は，エラー出力され，該当するステートメントだけが無視されます。

次に，ステートメントについて説明します。

id="メニュー識別子";

機能ツリーメニュー定義ブロックのメニュー識別子を定義します。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

同一の「id」を持つブロックが解析対象のファイル内に複数個存在した場合，次の順に優先順位が決定され，最優先のブロックが有効になります。

1. ファイル名を昇順でソートしてあとの方のブロック

2. ファイル内の位置があとの方のブロック

それ以外のブロックは無効になります。

メニュー識別子には，32バイト以内の半角英数字を指定できます。この文字列は，統合機能メニュー定義ファイル内でユニークでなければなりません。ユニーク性を保持するために，次の命名規則に従ってください。

・フォルダを定義する場合

会社名[_製品名]

・機能を定義する場合

会社名_製品名[_機能名(または画面名)]

適切なフォルダ名称がすでに存在している場合は，フォルダを新規に追加しないで，定義ファイル格納場所のほかの定義ファイルに記述してあるフォルダを使用してください。

「"root"」は最上位のメニュー識別子として予約されているため，使用できません。

「"jco_"」で始まる文字列はアプリケーション実行識別子として予約されているため，使用できません。

parent_id="親メニュー識別子";

自メニュー識別子に対して，ツリー構造上の上位にあるrootまたはメニュー識別子を指定します。階層は，rootを含めて3階層まで指定できます。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

複数の親メニュー識別子を指定して複数の上位フォルダを持つことはできません。

name="表示名称";

［統合機能メニュー］画面に表示する名称を定義します。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

表示名称には，［統合機能メニュー］画面上に表示される文字列を指定します。文字列には日本語文字を含めることができます。内容のわかりやすい簡潔な表示名称を指定してください。

指定した値はメニュー上に表示されるため，名詞にすることをお勧めします。例えば，「コマンド実行機能」などの文字列にします。

指定する値は，定義内でユニークでなくてもかまいませんが，操作性を考えてユニークにすることをお勧めします。

execute_id="アプリケーション実行定義識別子";

統合機能メニューに表示される機能をダブルクリックしたときに実行するアプリケーション実行定義識別子を指定します。このステートメントは機能を指定する場合は必須です。このステートメントは，ブロック内で1回だけ指定できます。

execute_idパラメーターには「"default_browser"」を指定してデフォルトのブラウザーを起動できます。また，execute_idパラメーターに「"default_browser"」を指定する場合は，argumentsパラメーターにURLを記載します。

フォルダを作成する場合は，このステートメントを指定しても無視されます。

指定したアプリケーション実行定義識別子が存在しない場合，メニューは表示されません。

「"jco_"」で始まる文字列はアプリケーション実行定義識別子として予約されているため，使用できません。

icon="表示アイコンファイル名";

［統合機能メニュー］画面に表示するアイコンを指定します。アイコンは，GIFファイルのファイル名称をフルパスで指定します。GIFファイルの推奨サイズは16×16ピクセルです。それ以外のサイズはリサイズして表示します。

このステートメントは，機能を指定する場合にだけ使用できます。

フォルダを作成する場合は，このステートメントを指定しても無視されます。

このステートメントが省略された場合は，共通のアイコンが使用されます。

arguments="コマンド引数";

execute_idで指定したアプリケーションに対する引数を指定します。このステートメントは，機能を指定する場合にだけ使用できます。このステートメントは，ブロック内で1回だけ指定できます。

argumentsには，ビューアーの動作環境属性で置き換える予約キーワードや，レジストリーの値から置き換える置換文字列も使用できます。置換文字列の詳細については，「アプリケーション実行定義ファイル」（2.　定義ファイル）の「置換文字列」を参照してください。

フォルダを作成する場合は，このステートメントを指定しても無視されます。

execute_idで指定した実行形式ファイルへのフルパスと，置換文字列を置換したあとのargumentsは，1個の空白を付加して連結されます。このときのコマンドラインの長さが1,024文字を超えた場合は，実行できません。

機能ツリーメニューブロックの定義例を次に示します。

@define-block type="function-tree-def";

id="hitachi_jp1";

parent_id="root";

name="サンプル管理";

@define-block-end;

@define-block type="function-tree-def";

id="hitachi_jp1_seihin_sample";

parent_id="hitachi_jp1";

name="サンプル画面";

icon="sample.gif";

execute_id="hitachi_jp1_seihin_sample_execute";

arguments="node_map";

@define-block-end;

定義例

統合機能メニュー定義ファイルの定義例を次に示します。

#
# All Rights Reserved, Copyright (C) 2000, Hitachi, Ltd.
#
@file type="function-definition", version="0300";
#----------------------------------------------------------
@define-block type="function-tree-def";
id="jco_folder_Network";
parent_id="root";
name="ネットワーク管理";
@define-block-end;
#----------------------------------------------------------
@define-block type="function-tree-def";
id="jco_JP1_Cm2";
parent_id="jco_folder_Network";
name="ネットワーク管理";
icon="%JCO_INSTALL_PATH%¥image¥menu¥cm2_manager.gif";
execute_id="default_browser";
arguments="%JCO_INSTALL_PATH%¥conf¥webdata¥ja¥hitachi_jp1_cm2.html";
@define-block-end;
#----------------------------------------------------------
@define-block type="function-tree-def";
id="jco_folder_JobSystemOperation";
parent_id="root";
name="ジョブシステム運用";
@define-block-end;
#----------------------------------------------------------
@define-block type="function-tree-def";
id="jco_JP1_AJS2";
parent_id="jco_folder_JobSystemOperation";
name="ジョブシステム運用";
icon="%JCO_INSTALL_PATH%¥image¥menu¥ajs2_manager.gif";
execute_id="jco_JP1_AJS2";
arguments="-t "%JCO_JP1TOKEN%"";
@define-block-end;
#----------------------------------------------------------

コマンドボタン定義ファイル（cmdbtn.conf）

形式

DESC_VERSION=ファイルバージョン

# コメント行
def
  [usr 対象ユーザー名 対象ユーザー名 …]

  btn ［コマンド］ボタン名
    [cmt ［コマンド］ボタンのコメント]
    [cmdtype {agent|client}]
    [inev {true|false}]
    [hst 実行ホスト名]
    cmd コマンドライン
    [var 環境変数ファイル名]
    [qui {true|false}]
    [preview {true|false}]
  end-btn
  ：
  ：
end-def
：
：

ファイル

cmdbtn.conf

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥rmtcmd¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥rmtcmd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/rmtcmd/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/rmtcmd/

ファイルの権限

Windowsの場合

AdministratorsグループおよびSYSTEMユーザー

UNIXの場合

root権限を持つユーザー

説明

［コマンド実行］画面に表示する［コマンド］ボタンを定義するファイルです。コマンドボタン定義ファイルの最大ファイルサイズは，10メガバイトです。なお，使用できるコマンドボタン定義が複数ある場合は，コマンドボタン定義ファイルの先頭に近い定義内容が表示されます。

定義の反映時期

［コマンド］ボタン定義の内容は，jcoimdefコマンドを実行して［コマンド］ボタンが有効な場合に，［コマンド実行］画面を表示するときに反映されます。

なお，JP1/IM - Viewを起動中に［コマンド］ボタン定義の内容を変更した場合は，JP1/IM - Viewの再起動が必要です。

記述内容

DESC_VERSION=ファイルバージョン

コマンドボタン定義ファイルの形式のバージョンを指定します。指定する値は1または2です。クライアントアプリケーションまたはイベント情報の引き継ぎ機能を使用する場合は，2を指定します。2を指定すると，次のパラメーターを指定できます。

cmdtype

inev

preview

ファイルバージョンを省略した場合や1または2以外の数値を指定した場合は，1が仮定されます。

#コメント行

#で始まる行は，コメント扱いとなります。

def〜end-def（定義ブロック）

コマンドボタン定義の開始と終了のパラメーターです。64個まで指定できます。

[usr 対象ユーザー名 対象ユーザー名 …]

［コマンド］ボタンを使用するJP1ユーザー名を指定します。対象ユーザー名に指定できる文字数は，1〜31バイトです。半角英数字だけを使用できます。英字は大文字・小文字を区別しません。複数指定する場合は，一つ以上の連続した半角スペースまたはタブを対象ユーザー名と対象ユーザー名の間に挿入して区切ります。複数指定では，100個まで指定できます。101個目以降の対象ユーザー名は無視されます。省略した場合，すべてのJP1ユーザーを対象ユーザーとします。def〜end-defの間に1個指定できます。btn〜end-btnの間には指定できません。

btn ［コマンド］ボタン名〜end-btn

［コマンド］ボタンの開始と終了パラメーターです。［コマンド］ボタン名は，［コマンド］ボタンの名称として［コマンド実行］画面の上に表示されます。一つの［コマンド］ボタン名に対して，8文字まで指定できます。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。大文字・小文字は区別します。［コマンド］ボタンは，定義ブロックの中に16個まで定義できます。重複した［コマンド］ボタン名は指定できません。［コマンド］ボタン名が最大文字数を超える場合，または［コマンド］ボタン名が重複している場合，その［コマンド］ボタン名は読み込めません。

[cmt ［コマンド］ボタンのコメント]

［コマンド］ボタンの説明を記述します。コメントは，ツールチップとして表示されます。このパラメーターは省略できます。コメントは40文字まで指定できます。41文字以降の文字は無視されます。指定できる文字は，すべての文字です。

[cmdtype {agent|client}]

［コマンド］ボタンで実行するコマンドの種類を指定します。管理対象ホストのコマンド，またはクライアントアプリケーションのどちらのコマンドなのかを選択します。クライアントアプリケーションは，クライアントアプリケーション実行機能で実行されます。このパラメーターを指定する場合は，DESC_VERSIONに2を指定してください。

エージェントまたはマネージャーホストでコマンドを実行する場合，agentパラメーターを指定します。クライアントアプリケーションを実行する場合，clientを指定します。

cmdtypeにclientを指定した場合は，hstおよびvarパラメーターを指定できません。

agentまたはclientは，大文字・小文字を区別しません。

[inev {true|false}]

［コマンド］ボタンを使用してイベント情報を引き継ぐかどうかを指定します。このパラメーターを指定する場合は，DESC_VERSIONに2を指定してください。

［コマンド］ボタンをクリックしたときに指定したイベント情報を引き継いでコマンドを実行させる場合はtrue，実行させない場合はfalseを指定します。省略した場合，falseが指定されます。

trueまたはfalseは，大文字・小文字を区別しません。

[hst 実行ホスト名]

コマンドを実行するホスト名を指定します。実行ホスト名には，ホスト名，ホストグループ名，業務グループ名，および監視グループ名を指定できます。

ホスト名，ホストグループ名には，最大255バイトの文字列を指定できます。業務グループ名，監視グループ名には，最大2,048バイトの文字列を指定できます。このパラメーターは省略できます。

統合監視DBおよびIM構成管理DBが有効な場合に，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，パス表記で業務グループ名を指定しても，ホスト名またはホストグループ名として扱われます。

イベント引き継ぎ情報は，変数で指定します。指定できるイベント引き継ぎ情報については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「4.19.5(1)　指定できるイベント引き継ぎ情報」を参照してください。イベント引き継ぎ情報を指定する場合は，inevパラメーターにtrueを指定してください。イベント引き継ぎ情報を指定する場合は，変数をJP1イベントの情報に置き換えたあとの文字列の長さが，実行ホスト名の最大バイト数以下になるように指定してください。置き換えたあとの文字列の長さが実行ホスト名の最大バイト数を超える場合は，最大バイト数に収まるように切り捨てられた文字列が実行ホスト名に指定されます。

cmd コマンドライン

実行するコマンドを指定します。コマンドラインは4,096バイトまで指定できます。このパラメーターは省略できません。

イベント引き継ぎ情報は，変数で指定します。イベント引き継ぎ情報を指定する場合は，inevパラメーターにtrueを指定してください。イベント引き継ぎ情報を指定する場合は，変数をJP1イベントの情報に置き換えたあとの文字列の長さが，コマンドラインの最大バイト数以下になるように指定してください。置き換えたあとの文字列の長さがコマンドラインの最大バイト数を超える場合は，最大バイト数に収まるように切り捨てられた文字列が環境変数ファイルに指定されます。

[var 環境変数ファイル名]

実行するコマンドの環境変数を指定した環境変数ファイルのファイル名を指定します。このパラメーターは省略できます。環境変数ファイルの形式については，マニュアル「JP1/Base 運用ガイド」を参照してください。環境変数ファイル名は255バイト以内の文字列で指定します。環境変数ファイル名が最大バイト数を超える場合は，コマンドボタンを読み込みません。

イベント引き継ぎ情報は，変数で指定します。イベント引き継ぎ情報を指定する場合は，inevパラメーターにtrueを指定してください。イベント引き継ぎ情報を指定する場合は，変数をJP1イベントの情報に置き換えたあとの文字列の長さが，環境変数ファイルの最大バイト数以下になるように指定してください。置き換えたあとの文字列の長さが環境変数ファイルの最大バイト数を超える場合は，最大バイト数に収まるように切り捨てられた文字列が環境変数ファイルに指定されます。

[qui {true|false}]

［コマンド］ボタンを使用してコマンドを実行する前に，コマンドを実行してもよいか確認するメッセージを表示させるかどうかを指定します。確認するメッセージを表示させないと，［コマンド］ボタンをクリックすると同時にコマンドが実行されます。

確認するメッセージを表示させない場合はtrue，表示させる場合はfalseを指定します。省略した場合，falseが指定されます。ただし，previewパラメーターにtrueを指定した場合は，［コマンド実行内容プレビュー］画面が表示されます。

trueまたはfalseは，大文字・小文字を区別しません。

[preview {true|false}]

［コマンド］ボタンを使用してイベント情報を引き継ぐ場合，引き継ぎ後のコマンド実行内容をプレビューで確認するかどうかを設定するパラメーターです。このパラメーターを指定する場合は，DESC_VERSIONに2を指定してください。

プレビューを表示させる場合はtrue，表示させない場合はfalseを指定します。省略した場合，trueが指定されます。

trueまたはfalseは，大文字・小文字を区別しません。

このパラメーターは，inevパラメーターがfalseの場合は無視されます。

previewパラメーターにfalse，quiパラメーターにtrueを指定した場合は，コマンドボタンをクリックすると同時にコマンドが実行されます。［コマンド実行内容プレビュー］画面およびコマンド実行の確認メッセージは表示されません。

定義例

DESC_VERSION=2

def
# ビューアーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報を指定する。
# 実行前にプレビュー画面を表示する。
  btn App1
    cmt App1を実行します。
    cmdtype client
    inev true
    cmd C:¥kansi¥app1.exe $EVIDBASE $EVSEQNO "$EVMSG"
  end-btn

# ビューアーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報を指定する。
# 実行前に確認ダイアログを表示する。プレビュー画面は表示しない。
  btn App2
    cmt App2を実行します。
    cmdtype client
    inev true
    cmd C:¥kansi¥app2.exe $EVIDBASE $EVSEQNO "$EVMSG"
    preview false
  end-btn

# ビューアーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報を指定する。
# 実行前に確認ダイアログもプレビュー画面も表示しない。
  btn App3
    cmt App3を実行します。
    cmdtype client
    inev true
    cmd C:¥kansi¥app3.exe $EVIDBASE $EVSEQNO "$EVMSG"
    qui true
    preview false
  end-btn

# エージェントまたはマネージャーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報を指定する。
# 実行前にプレビュー画面を表示する。
  btn Cmd1
    cmt cmd1を実行します。
    cmdtype agent
    inev true
    hst $EVHOST
    cmd /kansi/cmd1 $EVIDBASE $EVSEQNO '$EVMSG'
  end-btn

# エージェントまたはマネージャーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報は指定しない。
# 実行前に確認ダイアログを表示する。
  btn Cmd2
    cmt cmd2を実行します。
    hst agent2
    cmd /kansi/cmd2
  end-btn

end-def

起動プログラム定義ファイル（!JP1_CS_APP0.conf）

形式

@define-block type="application-execution-def";
id="プログラム識別子";
path="起動プログラムのパス";
@define-block-end;

ファイル

!JP1_CS_APP0.conf（起動プログラム定義ファイル）

!JP1_CS_APP0.conf.model（起動プログラム定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥sovtoolexec¥ja¥

説明

監視ツリー画面のツールバーに追加するプログラムの起動パスを定義するファイルです。

なお，監視ツリー画面のツールバーにプログラムを追加し，ツールバーからそのプログラムを起動するには，次の定義ファイルも編集する必要があります。

ツールバー定義ファイル

アイコン動作定義ファイル

定義の反映時期

監視ツリー画面を再起動すると有効になります。

記述内容

@define-block type〜@define-block-end;

@define-block type〜@define-block-end;で一つの定義ブロックとなります。監視ツリー画面のツールバーにプログラムを複数追加する場合は，この定義ブロックを複数記述します。この定義ブロックに記述できるパラメーターを次に示します。

id="プログラム識別子"

起動するプログラムを表す識別子を指定します。指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するプログラム識別子は，アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）で指定するプログラム識別子と同一にする必要があります。アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）の詳細については，「アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）」（2.　定義ファイル）を参照してください。

path="起動プログラムのパス"

起動するプログラムのパスを指定します。指定できる実行形式ファイルは，.exeまたは.batファイルです。

定義例

#
# All Rights Reserved. Copyright (C) 2003, Hitachi, Ltd.
#
@file type="application-execution-definition", version="0300";
#----------------------------------------------------------
@define-block type="application-execution-def";
id="app_notepad";
path="C:¥WINNT¥NOTEPAD.EXE";
@define-block-end;
#----------------------------------------------------------

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）

形式

@define-block type="function-toolbar-def";
toolbar="sov_JP1_IM_Central_Console|sov_JP1_IM_Function_Tree|sov_JP1_IM_Visual_View|sov_JP1_IM_Bmv_Help|アイコン識別子...";
@define-block-end;

ファイル

!JP1_CS_FTOOL0.conf（ツールバー定義ファイル）

!JP1_CS_FTOOL0.conf.model（ツールバー定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥sovtoolitem¥ja¥

説明

監視ツリー画面のツールバーに追加するプログラムの並び順を定義するファイルです。

なお，監視ツリー画面のツールバーにプログラムを追加し，ツールバーからそのプログラムを起動するには，次の定義ファイルも編集する必要があります。

起動プログラム定義ファイル

アイコン動作定義ファイル

定義の反映時期

監視ツリー画面を再起動すると有効になります。

記述内容

@define-block type〜@define-block-end;

@define-block type〜@define-block-end;で一つの定義ブロックとなります。定義ファイル中一つしか定義できません。

toolbar="sov_JP1_IM_Central_Console|sov_JP1_IM_Function_Tree|sov_JP1_IM_Visual_View|sov_JP1_IM_Bmv_Help|アイコン識別子";

アイコンを表す識別子は「|」で区切られ，この記載順序に従ってアイコンは，［監視ツリー］画面で左から並んで表示されます。識別子として指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するアイコン識別子は，アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）で指定するアイコン識別子と同一にする必要があります。アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）の詳細については，「アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）」（2.　定義ファイル）を参照してください。

定義例

#
# All Rights Reserved. Copyright (C) 2003, Hitachi, Ltd.
#
@file type="function-definition", version="0300";
#----------------------------------------------------------
@define-block type="function-toolbar-def";
toolbar="sov_JP1_IM_New_Info|sov_JP1_IM_Visual_View|sov_JP1_IM_Function_Tree|sov_JP1_IM_Central_Console|sov_JP1_IM_Bmv_Help|tool_notepad";
@define-block-end;
#----------------------------------------------------------

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）

形式

@define-block type="function-tree-def";
id="アイコン識別子";
name="ツールチップ";
iconstandard="アイコン格納パス";
icondown="アイコン格納パス";
iconrollover="アイコン格納パス";
icondisable="アイコン格納パス";
execute_id="プログラム識別子";
arguments="引数";
@define-block-end;

ファイル

!JP1_CS_FTREE0.conf（アイコン動作定義ファイル）

!JP1_CS_FTREE0.conf.model（アイコン動作定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥sovtoolitem¥ja¥

説明

監視ツリー画面のツールバーに表示するアイコンの動作を定義するファイルです。

なお，監視ツリー画面のツールバーにプログラムを追加し，ツールバーからそのプログラムを起動するには，次の定義ファイルも編集する必要があります。

起動プログラム定義ファイル

ツールバー定義ファイル

定義の反映時期

監視ツリー画面を再起動すると有効になります。

記述内容

@define-block type〜@define-block-end;

@define-block type〜@define-block-end;で一つの定義ブロックとなります。

監視ツリー画面のツールバーにプログラムを複数追加する場合は，この定義ブロックを複数記述します。この定義ブロックに記述できるパラメーターを次に示します。

id="アイコン識別子";

アイコンを表す識別子を指定します。識別子として指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するアイコン識別子は，ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）で指定するアイコン識別子と同一にする必要があります。ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）の詳細については，「ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）」（2.　定義ファイル）を参照してください。

name="ツールチップ";

カーソルをアイコンの上に置いたときに表示されるツールチップを指定します。

iconstandard="アイコン格納パス";

通常時に表示されるアイコンをフルパスで指定します。

icondown="アイコン格納パス";

アイコンをクリックしたときに表示されるアイコンをフルパスで指定します。

iconrollover="アイコン格納パス";

カーソルをアイコンの上に移動したときに表示されるアイコンをフルパスで指定します。

icondisable="アイコン格納パス";

そのプログラムが起動できない場合に表示されるアイコンをフルパスで指定します。

execute_id="プログラム識別子";

起動するプログラムを表す識別子を指定します。識別子として指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するプログラム識別子は，起動プログラム定義ファイル（!JP1_CS_APP0.conf）で指定するプログラム識別子と同一にする必要があります。起動プログラム定義ファイル（!JP1_CS_APP0.conf）の詳細については，「起動プログラム定義ファイル（!JP1_CS_APP0.conf）」（2.　定義ファイル）を参照してください。

arguments="引数";

起動プログラム定義ファイル（!JP1_CS_APP0.conf）で定義した起動するプログラム（起動パス）に対する引数を指定します。起動プログラム定義ファイル（!JP1_CS_APP0.conf）の詳細については，「起動プログラム定義ファイル（!JP1_CS_APP0.conf）」（2.　定義ファイル）を参照してください。

定義例

#----------------------------------------------------------
# Definition changed by 07-00.
@define-block type="function-tree-def";
id="tool_notepad";
name="メモ帳";
iconstandard="%SOV_INSTALL_PATH%¥image¥sovtool¥blank_standard.gif";
icondown="%SOV_INSTALL_PATH%¥image¥sovtool¥blank_down.gif";
iconrollover="%SOV_INSTALL_PATH%¥image¥sovtool¥blank_over.gif";
icondisable="%SOV_INSTALL_PATH%¥image¥sovtool¥blank_disable.gif";
execute_id="app_notepad";
arguments="C:¥test.txt";
@define-block-end;
#----------------------------------------------------------

ツリー構成ファイル

形式

TREE:BUILD=値;ID=値;[DATE=生成日時;]CSV_VER=09000000;MSCOPE=ON（改行）
OBJ:監視ノード名※, NID:監視ノードID※, ICO:アイコン名, TYPE:監視ノード種別, CLASS:監視オブジェクト種別, STA:状態ID, CHDT:状態更新時刻, OBS:監視状態, STD:基本情報(属性名1=属性値1※), BKIMG=背景画像ファイル名, POT:X=X座標;Y=Y座標;Z=Z座標, CON:NAME=状態変更条件名※, STA=遷移状態ID, CID=共通条件ID;共通条件情報, GCON:NAME=状態変更条件名※, STA=遷移状態ID, CSTA=子ノードの状態ID, NUM>=子ノードの個数, RATIO>=子ノードの比率, (個別条件名==個別条件値※), EVE:STA=状態ID, RES:JP1資源グループ名, OWN:監視ノード所有者名, OPE:操作項目のリスト（改行）
          :

（凡例）

（改行）：改行を意味する

注※：編集できることを意味する（ほかの個所は編集できない）。

ファイル

任意のファイル（ツリー構成ファイル）

格納先ディレクトリ

任意のフォルダ

説明

［監視ツリー］画面に表示される監視ツリーのツリー構成を定義したファイルです。

ツリー構成ファイルを編集することで，監視ツリーに表示される監視ノードの名称，基本情報の属性値などを変更できます。ツリー構成ファイルは，［監視ツリー］画面または［監視ツリー(編集中)］画面からツリー構成をローカルに保存することで作成できます。なお，これらの方法以外で，ツリー構成ファイルを作成しないでください。また，ツリー構成ファイルを編集する場合，次の記述内容で説明する値以外は変更しないでください。

編集してはならない値を誤って更新した場合，ツリー構成ファイルのバックアップがあるときはツリー構成ファイルを更新し直してください。バックアップがないときはjcsdbsetupまたはjcsdbimportコマンドを使用して監視オブジェクトDBをセットアップし直してください。

特別な理由がない場合は，［監視ツリー(編集中)］画面を使って監視ツリーを編集することを推奨します。

全角文字を使用する場合は，文字コードをMS932に統一してください。外字は使用できません。エスケープ文字は入力しないでください。

定義の反映時期

［監視ツリー(編集中)］画面でこの定義ファイルを開いたあと，JP1/IM - Managerに反映することで有効になります。

記述内容

TREE

TREEに含まれる次のパラメーターの内容は変更できません。

BUILD=値

値にはツリー生成番号が表示されます。なお，このパラメーターの値は，サーバへの更新によって変更されます。

ID=値

値にはツリーIDが表示されます。

DATE=生成日時

生成日時にはツリー生成日時が表示されます。なお，このパラメーターの値は，サーバへの更新および監視ノードの状態変更によって更新されます。

CSV_VER=09000000

CSVファイルのフォーマットバージョンです。JP1/IM - Managerのバージョンによって値が異なる場合があります。

MSCOPE={ON | OFF}

監視範囲設定の有効・無効が表示されます。ONの場合，監視範囲設定が有効です。

OBJ:監視ノード名

監視ノード名には監視ツリーに表示される監視ノード名が表示されます。ユーザーが変更できます。指定できる文字数は最大255バイトです。半角英数字，全角文字（外字を除く）を使用できます。なお，監視ノードにセミコロン（;）を入力する場合には，セミコロンを二つ重ねて入力してください。

監視ノード名にコンマ（,）を入力する場合は，OBJの項目全体をダブルクォーテーション（"）で囲んでください。

例

監視ノード名を「監視,ノード」とする場合は，次のように記述します。

"OBJ:監視,ノード"

監視ノード名にダブルクォーテーション（"）を入力する場合は，OBJの項目全体をダブルクォーテーション（"）で囲み，さらに監視ノード名のダブルクォーテーション（"）の前にもう一つダブルクォーテーション（"）を記述してください。

例

監視ノード名を「"監視ノード"」とする場合，次のように記述します。

"OBJ:""監視ノード"""

NID:監視ノードID

監視ノードIDには監視ツリーに表示される監視ノードのIDが16進数8けたで表示されます。ユーザーが変更できます。

なお，監視ノードIDは，ほかの監視ノードの監視ノードIDと重複しないように注意してください。監視ノードIDには，00000001〜7FFFFFFFを指定してください。

ICO:アイコン名

監視ノードのアイコン名が最大で三つ，セミコロン（;）区切りで表示されます。

このパラメーターは変更できません。

TYPE:監視ノード種別

監視グループ，監視オブジェクト，および仮想ルートノードを識別するIDが表示されます。このパラメーターは変更できません。

CLASS:監視オブジェクト種別

監視オブジェクトの種別が表示されます。このパラメーターは変更できません。

STA:状態ID

監視ノードの状態を示すIDが表示されます。このパラメーターは変更できません。

CHDT:状態更新時刻

監視ノードの状態が更新された時刻が表示されます。このパラメーターは変更できません。

OBS:監視状態

監視ノードの監視状態が表示されます。このパラメーターは変更できません。

STD:属性名=属性値

監視ノードの基本情報を定義した場合には，その属性名と属性値が表示されます。基本情報は，複数指定がある場合，セミコロン（;）で区切られます。

属性値だけ変更できます。属性値に指定できる文字数は最大1,023バイト※です。なお，属性値にセミコロン（;）を入力する場合には，セミコロンを二つ重ねて入力してください。

注※　全フィールドのトータルでは1,280バイト以内です（例えば基本情報を五つ設定した場合，五つの属性値の合計が1,280バイト以内にする必要がある）。

属性値にコンマ（,）を入力する場合は，STDの項目全体をダブルクォーテーション（"）で囲んでください。

例

属性値を「属性,値」とする場合は，次のように記述します。

"STD:属性名=""属性,値"

属性値にダブルクォーテーション（"）を入力する場合は，STDの項目全体をダブルクォーテーション（"）で囲み，さらに属性値のダブルクォーテーション（"）の前にもう一つダブルクォーテーション（"）を記述してください。

例

属性値を「"属性値"」とする場合は，次のように記述します。

"STD:属性名=""属性値"""

BKIMG=背景画像ファイル名

［監視ツリー(編集中)］画面のマップ表示時，または［ビジュアル監視(編集中)］画面で設定されている背景画像ファイル名が表示されます。このパラメーターは変更できません。

POT:X=X座標;Y=Y座標;Z=Z座標

［監視ツリー(編集中)］画面のマップ表示時，または［ビジュアル監視(編集中)］画面で設定されているアイコンの位置情報（座標軸）が表示されます。このパラメーターは変更できません。

CON

CONに含まれるパラメーターには次のものがあります。なお，CONパラメーターはTYPEの値が1（監視グループ）の場合は表示されません。

NAME=状態変更条件名

状態変更条件名が表示されます。ユーザーが変更できます。指定できる文字数は最大63バイトです。半角英数字，全角文字（外字を除く）を使用できます。* " ' ¥ : ; | = + ? <.>は使用できません。なお，同行にNAMEパラメーターが複数ある場合，その中で同じ状態変更条件名は使用できないため，注意してください。

状態変更条件名にコンマ（,）を入力する場合は，CONの項目全体をダブルクォーテーション（"）で囲んでください。

例

　状態変更条件名を「状態変更,条件名」とする場合，次のように記述します。

　"CON:NAME=状態変更,条件名;STA=700;個別条件名==個別条件値"

STA=遷移状態ID

遷移状態IDが表示されます。このパラメーターは変更できません。

CID=共通条件ID;共通条件情報

共通条件IDおよび共通条件情報が表示されます。共通条件情報には，［状態変更条件設定］画面で設定した，システムが管理するために必要なIDや情報などの共通条件が表示され，セミコロン（;）で区切られます。なお，これらのパラメーターは変更できません。

GCON

GCONに含まれるパラメーターには次のものがあります。

なお，GCONパラメーターはTYPEの値が2（監視オブジェクト）の場合や，監視グループの状態変更条件を一つも設定していない場合は表示されません。

NAME=状態変更条件名

状態変更条件名が表示されます。ユーザーが変更できます。指定できる文字数は最大63バイトです。半角英数字，全角文字（外字を除く）を使用できます。* " ' ¥ : ; | = + ? <.>は使用できません。なお，同行にNAMEパラメーターが複数ある場合，その中で同じ状態変更条件名は使用できないため，注意してください。

状態変更条件名にコンマ(,)を入力する場合は，GCONの項目全体をダブルクォーテーション（"）で囲んでください。

STA=遷移状態ID

遷移状態IDが表示されます。このパラメーターは変更できません。

CSTA=子ノードの状態ID

子ノードの状態IDが表示されます。このパラメーターは変更できません。

NUM>=子ノードの個数

子ノードの個数が表示されます。このパラメーターは変更できません。また，RATIOと同時に指定できません。

RATIO>=子ノードの比率

子ノードの比率が表示されます。このパラメーターは変更できません。また，NUMと同時に指定できません。

個別条件名==個別条件値

［状態変更条件設定］画面で個別条件を設定した場合に表示されます。個別条件は，複数指定がある場合，セミコロン（;）で区切られます。個別条件値だけ変更できます。なお，==部分はGUIでの設定によって次のように変わりますが，この部分は変更しないでください。

==：「と一致する」

!=：「と一致しない」

^=：「から始まる」

>=：「を含む」

<=：「を含まない」

*=：「正規表現」

+=：「ホスト名比較」

個別条件値に指定できる文字数は最大1,023バイト※です。なお，個別条件値にセミコロン（;）を入力する場合には，セミコロンを二つ重ねて入力してください。

注※　全フィールドのトータルでは1,280バイト以内です（例えば個別条件を五つ設定した場合，五つの条件値の合計が1,280バイト以内にする必要がある）。

個別条件値にコンマ（,）を入力する場合は，CONの項目全体をダブルクォーテーション（"）で囲んでください。

例

　個別条件値を「個別,条件値」とする場合は，次のように記述します。

　"CON:NAME=状態変更条件名;STA=700;個別条件名==個別,条件値"

個別条件値にダブルクォーテーション（"）を入力する場合は，CONの項目全体をダブルクォーテーション（"）で囲み，さらに属性値のダブルクォーテーション（"）の前にもう一つダブルクォーテーション（"）を記述してください。

例

　個別条件値を「"個別条件値"」とする場合は，次のように記述します。

　"CON:NAME=状態変更条件名,;STA=700;個別条件名==""個別条件値"""

EVE:STA=状態ID

イベント発行条件で設定した状態の状態IDが表示されます。このパラメーターは変更できません。

RES:JP1資源グループ名

監視ノードのJP1資源グループ名が表示されます。このパラメーターは変更できません。

OWN:監視ノード所有者名

監視ノードの所有者名が表示されます。このパラメーターは変更できません。

OPE:操作項目のリスト

ログインしたユーザーが監視ノードに対して保有する操作項目のリストが表示されます。このパラメーターは変更できません。

注意事項

監視ノードIDを変更すると，［ビジュアル監視］画面に影響がでるおそれがあります。これは，［監視ツリー］画面，［ビジュアル監視］画面に表示される監視ノードが監視ノードIDをキーに管理されているためです。

監視ノードIDを変更した場合は，画面表示に問題がないか［ビジュアル監視］画面の確認をしてください。

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）

形式

DESC_VERSION=1※1
[SystemProfile]
  FrameVisible={true | false}
  Movable={true | false}
[DisplayColor]
    :
  [ColorItem]※2
    Status=監視ノードの状態識別子
    Name=監視ノードの状態名
    [Label]
      R=値
      G=値
      B=値
      A=値
    [END]
    [TEXT]
      R=値
      G=値
      B=値
    [End]
  [End]
      :
[End]
[DisplayLamp]
  Status=監視ノードの状態識別子
[End]
[End]

注※1　DESC_VERSION=1は，変更しないでください。

注※2　[ColorItem]〜[End]内のStatus，Nameの値は，変更しないでください。

ファイル

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）は，JP1/IMの動作する言語コードによって，編集するファイルが異なります。JP1/IMの動作する言語コードと，編集するシステムプロファイル（セントラルスコープ）の対応を次の表に示します。

表2‒76　JP1/IMの動作する言語コードとシステムプロファイル（セントラルスコープ）の対応

OS

言語種別

JP1/IMの動作する言語コード

定義ファイル

Windows

日本語

jcs_sysprofile_sjis.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_sjis.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

英語

jcs_sysprofile.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

中国語

jcs_sysprofile_GB18030.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_GB18030.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

UNIX※

日本語

シフトJISコード

jcs_sysprofile_sjis.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_sjis.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

EUCコード

jcs_sysprofile_euc.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_euc.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

UTF-8コード

jcs_sysprofile_UTF-8.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_UTF-8.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

英語

jcs_sysprofile.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

中国語

GB18030コード

jcs_sysprofile_GB18030.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_GB18030.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

注※

OSがサポートしている言語と対応するファイルだけが存在します。

言語コードに対応したシステムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）を使用してください。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf

論理ホストのとき

共有フォルダ¥jp1scope¥conf

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf

論理ホストのとき

共有ディレクトリ/jp1scope/conf

説明

セントラルスコープ・ビューアーの共通の定義情報です。この定義ファイルの内容は，次の画面に反映されます。

［監視ツリー］画面

［ビジュアル監視］画面

定義の反映時期

セントラルスコープにログインするとその定義が有効になります。ただし，［イベントコンソール］画面からセントラルスコープにログインする場合は，定義ファイルの編集後に［イベントコンソール］画面を再起動してからセントラルスコープにログインする必要があります。

記述内容

DESC_VERSION=1

システムプロファイルの形式のバージョンを表しています。

セントラルスコープ・ビューアーの動作が不正になることがあるため，この値は変更しないでください。

[SystemProfile]〜[End]

システムプロファイルの定義開始タグ，および定義終了タグです。

FrameVisible={true | false}

監視ノード名およびアイコン余白を表示するかどうかを指定します。指定できる値は「true」または「false」です。設定値の大文字・小文字は区別しません。このパラメーターは，[SystemProfile]〜[End]内に記載します。

「true」を指定した場合は，監視ノード名およびアイコン余白を表示します。「false」を指定した場合は，監視ノード名およびアイコン余白を表示しません。

このパラメーターを省略した場合，および「true」「false」以外の値を指定した場合は，「true」を仮定します。

JP1/IM - Managerをバージョン10-10以前からバージョンアップした場合，論理ホストのシステムプロファイルには，このパラメーターは設定されません。このパラメーターを指定したいときは，記述を追加してください。

Movable={true | false}

［監視ツリー］画面のマップ表示，および［ビジュアル監視］画面で監視ノードアイコンをドラッグ&ドロップで移動できるようにするかどうかを指定します。指定できる値は「true」または「false」です。設定値の大文字・小文字は区別しません。このパラメーターは，[SystemProfile]〜[End]内に記載します。

「true」を指定した場合は，監視ノードアイコンを移動できます。「false」を指定した場合は，監視ノードアイコンを移動できません。

このパラメーターを省略した場合，および「true」「false」以外の値を指定した場合は，「true」を仮定します。

JP1/IM - Managerをバージョン10-10以前からバージョンアップした場合，論理ホストのシステムプロファイルには，このパラメーターは設定されません。このパラメーターを指定したいときは，記述を追加してください。

[DisplayColor]〜[End]

[DisplayColor]〜[End]内に監視ノードの状態を定義するための定義ブロックを記載します。この定義ブロックは[SystemProfile]〜[End]内に一つだけ記載します。

[ColorItem]〜[End]

[ColorItem]〜[End]内に状態識別子，状態名，状態色を定義するためのパラメーター，および定義ブロックを記載します。この定義ブロックは[DisplayColor]〜[End]内に状態ごとに記載します。

Status=監視ノードの状態識別子

状態識別子を指定します。このパラメーターは[ColorItem]〜[End]内に記載します。セントラルスコープ・ビューアーの動作が不正になることがあるため，この値は変更しないでください。

Name=監視ノードの状態名

状態名を指定します。このパラメーターは[ColorItem]〜[End]内に記載します。セントラルスコープ・ビューアーの動作が不正になることがあるため，この値は変更しないでください。

[Label]〜[End]

[Label]〜[End]内に監視ノードの状態色，および監視ノードの状態色を透過するかどうかを指定するためのパラメーターを記載します。監視ノードの状態が遷移すると，状態色が遷移先の状態に対応する[Label]〜[End]で指定された色に変化します。この定義ブロックは[ColorItem]〜[End]内に一つだけ記載します。

R=値，G=値，B=値

監視ノードの状態色をRGB値で指定します。このパラメーターは[Label]〜[End]内に記載します。指定できる値は0〜255の整数です。

このパラメーターを省略した場合，0未満の整数値を指定した場合，および整数値以外を指定した場合は，0を仮定します。256以上の整数値を指定した場合は，255を仮定します。

A=値

監視ノードの状態色を透過するかどうかを指定します。このパラメーターは[Label]〜[End]内に記載します。FrameVisibleパラメーターが指定されていない場合，およびFrameVisibleパラメーターに「true」が指定されている場合は，Aに指定した値に関係なく状態色を透過しません。指定できる値は0〜255の整数です。指定した値が小さいほど，透過率が高くなります。0を指定した場合，状態色を完全に透過します。255を指定した場合，状態色を透過しません。

このパラメーターを省略した場合，および指定できる値以外の値を指定した場合は，255を仮定します。

[TEXT]〜[End]

[TEXT]〜[End]内に監視ノード名のテキストの色を指定するためのパラメーターを記載します。監視ノードの状態が遷移すると，監視ノード名のテキストの色が遷移先の状態に対応する[TEXT]〜[End]で指定された色に変化します。この定義ブロックは[ColorItem]〜[End]内に一つだけ記載します。

R=値，G=値，B=値

監視ノード名のテキストの色をRGB値で指定します。このパラメーターは[TEXT]〜[End]内に記載します。指定できる値は0〜255の整数です。

このパラメーターを省略した場合，0未満の値を指定した場合，および整数値以外を指定した場合は，0を仮定します。256以上の値を指定した場合は，255を仮定します。インストール時点ではすべての値に0が指定されています。

[DisplayLamp]〜[End]

アラームランプが点灯する状態を指定するためのパラメーターを指定します。最上位監視ノードの状態が遷移した場合に，遷移先の状態に指定された状態識別子が[DisplayLamp]〜[End]で指定された値以上であるときに，アラームランプが点灯します。この定義ブロックは[SystemProfile]〜[End]内に記載します。

Status=監視ノードの状態識別子

アラームランプが点灯する状態を指定します。このパラメーターは[DisplayLamp]〜[End]内に記載します。指定できる値は-2,147,483,648〜2,147,483,647の10進数整数です。

このパラメーターを省略した場合，および指定できる値以外の値を指定した場合は，0を仮定します。最上位監視ノードの状態に指定された状態識別子が，このパラメーターに指定された値より大きい場合，アラームランプが点灯します。このパラメーターで指定した値とアラームランプが点灯する状態の対応を，次の表に示します。

表2‒77　指定した値とアラームランプが点灯する状態の対応

指定した値

アラームランプが点灯する状態

-2,147,483,648〜100

初期状態，デバッグ，正常，警告，エラー，致命的，警戒，緊急

101〜200

デバッグ，正常，警告，エラー，致命的，警戒，緊急

201〜300

正常，警告，エラー，致命的，警戒，緊急

301〜400

警告，エラー，致命的，警戒，緊急

401〜500

エラー，致命的，警戒，緊急

501〜600

致命的，警戒，緊急

601〜700

警戒，緊急

701〜800

緊急

801〜2,147,483,648

点灯しない

なお，値は「200」「300」「400」「500」「600」「700」「800」の中から指定することをお勧めします。

注意事項

設定項目名は，大文字・小文字を区別します。

各設定項目の設定値は「=」の直後に設定してください。スペースやタグなどを入れた場合は，設定した値が認識されません。

定義の開始タグが誤って削除された場合は，ファイルフォーマット不正のメッセージ（KAVB7303-E）を出力し，JP1/IM - Viewの操作を中断します。また，誤って変更した場合は，定義が認識されません。

定義の終了タグが誤って変更または削除された場合は，ファイルフォーマット不正のメッセージ（KAVB7303-E）を出力し，JP1/IM - Viewの操作を中断します。

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）を編集しても，［監視ツリー(編集中)］画面および［ビジュアル監視(編集中)］画面には編集結果が反映されません。これらの画面の設定を変更したい場合は，システムプロファイル（セントラルスコープ・ビューアー）（system.conf）を編集してください。

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）

形式

DESC_VERSION=1
[SystemProfile]
  FrameVisible={true | false}
 [DisplayColor]
    :
  [ColorItem]
    Status=監視ノードの状態識別子
    Name=監視ノードの状態名
    [Label]
      R=値
      G=値
      B=値
      A=値
    [END]
    [TEXT]
      R=値
      G=値
      B=値
    [End]
  [End]
      :
[End]

[End]

ファイル

system.conf（システムプロファイル（セントラルスコープ・ビューアー））

system.conf.model（システムプロファイル（セントラルスコープ・ビューアー）のモデルファイル）

格納先ディレクトリ

日本語OSの場合

Viewパス¥conf¥sovsystem¥ja¥

英語OSの場合

Viewパス¥conf¥sovsystem¥en¥

中国語OSの場合

Viewパス¥conf¥sovsystem¥zh¥

説明

セントラルスコープ・ビューアーの共通の定義情報です。この定義ファイルの内容は，次の画面に反映されます。

［監視ツリー(編集中)］画面

［ビジュアル監視(編集中)］画面

定義の反映時期

［監視ツリー(編集中)］画面，または［ビジュアル監視(編集中)］画面を表示したときに有効になります。

記述内容

Movableが指定できないこと以外は，システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）と同じです。詳細については，「システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）」（2.　定義ファイル）を参照してください。

注意事項

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）特有の注意事項について説明します。ここに記載している以外の注意事項については，「システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）」（2.　定義ファイル）を参照してください。

［監視ツリー(編集中)］画面，および［ビジュアル監視(編集中)］画面の監視ノードの状態は，常に初期状態です。そのため，初期状態以外の状態については，定義が画面に反映されません。

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）を編集しても，［監視ツリー］画面および［ビジュアル監視］画面には編集結果が反映されません。これらの画面の設定を変更したい場合は，システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）を編集してください。

性能レポート表示定義ファイル（performance.conf）

形式

# (JP1/PFM - Web Console URL)
[JP1/PFM - Web ConsoleのURL]

ファイル

performance.conf（性能レポート表示定義ファイル）

performance.conf.model（性能レポート表示定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥performance

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥performance

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/performance

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/performance

説明

事象発生元ホストの性能レポート表示機能の定義ファイルです。接続先のJP1/PFM - Web ConsoleのURLを定義します。

定義の反映時期

jco_spmd_reloadコマンドを実行したあと，またはJP1/IM - Managerを再起動したあと，JP1/IM - ViewでJP1/IM - Managerにログインすると，性能レポート表示定義ファイルの設定が有効になります。

記述内容

タブ，および行の前方と後方の半角スペースは無視されます。

半角スペースまたはタブだけで構成された行，および空行（改行だけの行）は，無視して処理を続行します。

「#」で始まる行は，コメントになります。

[JP1/PFM - Web ConsoleのURL]

接続先のJP1/PFM - Web ConsoleのURLを半角英数字および記号で指定します。

JP1/PFM - Web ConsoleのURLの詳細については，JP1/PFMのマニュアルを参照してください。

注意事項

ファイルの文字コードは，マネージャーの文字コード設定と同じ文字コードを使用してください。

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

形式

jcfview.login.host.max=ホストの最大記録数
jcfview.login.user.max={0|1}
jcfview.screen.history.enable={0|1}
jcfview.response.wait.time=サーバ応答待ちタイムアウト時間
jcfview.imconfigreflect.response.wait.time=システムの階層構成の反映応答待ちタイムアウト時間
jcfview.screen.title.logininfo.enable={0|1}

ファイル

jcfview.conf（IM構成管理・ビューアー動作定義ファイル）

jcfview.conf.model（IM構成管理・ビューアー動作定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥jcfview¥

説明

IM構成管理・ビューアーの動作を指定するファイルです。

定義の反映時期

IM構成管理・ビューアーの起動時に有効になります。

記述内容

jcfview.login.host.max=ホストの最大記録数

ログインに成功したホストの最大記録数を10進数で記述します。指定できる値は0〜20です。デフォルトは5です。

jcfview.login.user.max={0|1}

［ログイン］画面のユーザー名に前回ログインしたJP1ユーザー名を表示するかどうかを指定します。1を指定すると，前回ログインしたJP1ユーザー名を表示します。0を指定すると，前回ログインしたJP1ユーザー名を表示しません。このパラメーターを指定しなかった場合や，0または1以外を指定した場合は，1を仮定します。デフォルトは1です。

jcfview.screen.history.enable={0|1}

画面起動時に前回のIM構成管理・ビューアー画面の表示位置，表示サイズ，および表示ボタンの選択状態の履歴を使用するかどうかを指定します。対象となる画面は，［IM構成管理］画面，［エージェント構成編集］画面，［リモート監視構成編集］画面，および［プロファイル表示/編集］画面です。

指定できる値は，次のとおりです。

0：画面表示設定履歴機能を使用しません。

1：画面表示設定履歴機能を使用します（デフォルト値）。

なお，0を設定してIM-Viewを起動した場合，すべての画面表示設定履歴ファイルを削除します。

jcfview.response.wait.time=サーバ応答待ちタイムアウト時間

サーバ応答待ちのタイムアウト時間を10進数で記述します。単位はミリ秒です。

指摘できる値は，60,000〜3,600,000，デフォルトは1,800,000です。最小値より小さい値，最大値より大きい値，不正な値が指定された場合，または定義がない場合は，デフォルト値が使用されます。

タイムアウトが発生した場合は，KNAN20105-Eのメッセージが表示されます。KNAN20105-Eのメッセージが頻繁に出力される場合は，タイムアウト時間の設定を見直してください。

jcfview.imconfigreflect.response.wait.time=システムの階層構成の反映応答待ちタイムアウト時間

システムの階層構成（IM構成）が反映されるまでの応答待ちのタイムアウト時間を10進数で記述します。単位はミリ秒です。指摘できる値は，60,000〜36,000,000，デフォルトは18,000,000です。最小値より小さい値，最大値より大きい値，不正な値が指定された場合，または定義がない場合は，デフォルト値が使用されます。

タイムアウトが発生した場合は，KNAN20105-Eのメッセージが表示されます。KNAN20105-Eのメッセージが頻繁に出力される場合は，タイムアウト時間の設定を見直してください。

jcfview.screen.title.logininfo.enable={0|1}

[IM構成管理]画面，[エージェント構成編集]画面，[リモート監視構成編集]画面，および[プロファイル表示/編集]画面のタイトル部分に表示されるログイン中のJP1ユーザー名を非表示にできます。1を指定すると，ログイン中のJP1ユーザー名を表示します。0を指定すると，ログイン中のJP1ユーザー名を表示しません。このパラメーターを指定しなかった場合や，0または1以外が指定されたときは，1を仮定します。デフォルトは1です。

定義例

jcfview.login.host.max=5
jcfview.login.user.max=1
jcfview.screen.history.enable=1
jcfview.response.wait.time=1800000
jcfview.imconfigreflect.response.wait.time=18000000
jcfview.screen.title.logininfo.enable=1

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

形式

[論理ホスト名¥JP1CONFIG]
"APPLY_CONFIG_TYPE"=dword:{00000000 | 00000001}

ファイル

jp1cf_applyconfig.conf（IM構成反映方式設定ファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imcf¥

論理ホストのとき

共有フォルダ¥JP1IMM¥conf¥imcf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imcf/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imcf/

説明

システムの階層構成の反映方式を定義するファイルです。

エージェント構成の反映には，差分配布方式，一括配布方式（構成削除あり），および一括配布方式（構成削除なし）があります。

次に示す条件の場合，IM構成反映方式設定ファイルで，反映方式を一括配布方式（構成削除あり）または一括配布方式（構成削除なし）に切り替えられます。

JP1/Baseの構成定義情報の配布の設定で差分配布機能が無効の場合，かつ業務グループの参照・操作制限機能が無効の場合

システムの階層構成の反映方式については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「7.2.6　システムの階層構成の反映」を参照してください。

定義の反映時期

jbssetcnfコマンドを実行して定義をJP1共通定義情報に反映したあと，JP1/IM - Managerを起動・再起動した場合か，jco_spmd_reloadコマンドでリロードした場合に設定を反映します。

記述内容

[論理ホスト名¥JP1CONFIG]

IM構成反映方式設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"APPLY_CONFIG_TYPE"=dword:{00000000 | 00000001}

システムの階層構成の反映方式を指定します。

00000000

システムの階層構成の反映方式が一括配布方式（構成削除あり）になります。システムの階層構成を削除後に反映します。この項目は，デフォルトで設定されています。

00000001

システムの階層構成の反映方式が一括配布方式（構成削除なし）になります。システムの階層構成を削除しないで反映します。

値が不正または共通定義が設定されていない場合は，デフォルトが仮定されます。

定義例

[JP1_DEFAULT¥JP1CONFIG]
"APPLY_CONFIG_TYPE"=dword:00000001

ホスト入力情報ファイル（host_input_data.csv）

形式

製品名;ファイルフォーマットバージョン;文字コード
Host_name,IPAddress,Host_list,Comment,Host_type,Running_host_name,Standby_host_name,VMM_host_name,Virtual_manager_type,Username,Password,Domain_name,Connection_type,Virtual_host_manager,Remote_connection_type,Authentication_section,Port_number,SSH_private_key_path
ホスト名,IPアドレス,ホスト名一覧,コメント,ホスト種別,実行系ホスト,待機系ホスト,VMMホスト,仮想化管理種別,ユーザー名,パスワード,ドメイン名,通信種別,仮想化管理元ホスト,リモート通信種別,認証情報の区分,ポート番号,秘密鍵パス

ファイル

host_input_data.csv（ホスト入力情報ファイル）

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

IM構成管理の管理対象ホストに関するホスト入力情報のエクスポートファイルです。ホスト入力情報ファイルを編集してインポートできます。

定義の反映時期

jcfimportコマンドでファイルをインポートしたときに反映されます。

記述内容

ホスト入力情報ファイルに出力されるホスト情報を次の表に示します。

表2‒78　エクスポートされるホスト情報（ホスト入力情報ファイル）

行

出力項目

出力値

1行目（ヘッダー情報）

製品名

JP1/IM-CF

ファイルフォーマットバージョン

ファイルフォーマットのバージョン

例えば，JP1/IM - Managerのバージョンが10-50の場合は，「101000」と出力されます。

文字コード

文字コード

マネージャーの環境変数LANGの設定に依存します。詳細は，「表2-79　ファイルの文字コード」を参照してください。

2行目（ヘッダー情報）

ホスト名

Host_name

IPアドレス

IPAddress

ホスト名一覧

Host_list

コメント

Comment

ホスト種別

Host_type

実行系ホスト

Running_host_name

待機系ホスト

Standby_host_name

VMMホスト

VMM_host_name

仮想化管理種別

Virtual_manager_type

ユーザー名

Username

パスワード

Password

ドメイン名

Domain_name

通信種別

Connection_type

仮想化管理元ホスト

Virtual_host_manager

リモート通信種別

Remote_connection_type

認証情報の区分

Authentication_section

ポート番号

Port_number

秘密鍵パス

SSH_private_key_path

3行目以降

ホスト名

システムの階層構成に登録したホストのホスト名

IPアドレス

システムの階層構成に登録したホストのIPアドレス（複数ある場合はコンマ（,）で区切り，全体をダブルクォーテーション（"）で囲む）

ホスト名一覧

ホストに登録したホスト名の一覧（複数ある場合はコンマ（,）で区切り，全体をダブルクォーテーション（"）で囲む）

コメント

ホストに登録したコメント

ホスト種別

ホストの種別（physical，logical，virtual，unknown）

実行系ホスト

実行系となるホストのホスト名

待機系ホスト

待機系となるホストのホスト名（複数ある場合はコンマ（,）で区切り，全体をダブルクォーテーション（"）で囲む）

VMMホスト

仮想マシンモニターが動作しているホストのホスト名

仮想化管理種別

仮想化管理の種別（vCenter，JP1/SC/CM，SCVMM，HCSM，ESX※1，Hyper-V，KVM，Virtage※2）

ユーザー名

ユーザー名

パスワード

パスワード情報であるため出力されません。

ドメイン名

仮想マシンモニターが動作しているホストのドメイン名

通信種別

通信種別（http，https，ssh）

仮想化管理元ホスト

ホストに登録したホスト名

リモート通信種別

リモート監視の場合に出力される通信種別（disable，ssh，wmi）

認証情報の区分

リモート監視の場合に出力される認証情報（common，host，空白）

ポート番号

通信で使用するポート番号

秘密鍵パス

SSH接続で使用する秘密鍵ファイルの絶対パス

注※1　ESXは，VMware ESXを指します。

注※2　Virtageは，日立サーバ論理分割機構を指します。

表2‒79　ファイルの文字コード

OS

環境変数LANGの形式

変換する文字コード

Windows

−

日本語OS：MS932

英語OS：C（ISO-8859-1）

中国語OS：GB18030

Linux

ja_JP.UTF-8またはja_JP.utf8

日本語OS：UTF-8

ja_JP.sjisまたはja_JP.SJIS※

日本語OS：Shift_JIS

C

英語OS：C（ISO-8859-1）

zh_CN.gb18030

中国語OS：GB18030

−

上記以外

UTF-8

（凡例）

−：該当なし

注※　OSがSUSE Linuxの場合だけ有効です。

出力例

JP1/IM-CF;101000;MS932,,,,,,,,,,,,,,,,
Host_name,IPAddress,Host_list,Comment,Host_type,Running_host_name,Standby_host_name,VMM_host_name, Virtual_manager_type,Username,Password, Domain_name, Connection_type,Virtual_host_manager,Remote_connection_type,Authentication_section, Port_number, SSH_private_key_path
infch05340,192.168.105.251,infch05340.supp528,,physical,,,,,,,,,,disable,,
infch05356,192.168.105.193,infch05356,,physical,,,,,,,,,,disable,,
infch02272,192.168.105.84,infch02272,,physical,,,,KVM,,,,,,disable,22,<ssh_private_key_path>

ホスト収集情報ファイル（host_collect_data.csv）

形式

製品名;ファイルフォーマットバージョン;文字コード
Real_host_name,OS_name,JP1_product_name,JP1_product_id,JP1_product_version,Install_path,Conf_dir,Date,Total_time,Host_name,Virtual_manager_type,Virtual_manager_version
実ホスト名,OS名,製品名,製品形名,バージョン,インストールパス,環境設定ファイル格納フォルダ,更新日時,更新日時（GMT）,ホスト名,仮想化管理種別,仮想化製品バージョン

ファイル

host_collect_data.csv（ホスト収集情報ファイル）

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

IM構成管理の管理対象ホストに関するホスト収集情報のエクスポートファイルです。ホスト収集情報ファイルを編集したりインポートしたりできません。

記述内容

ホスト収集情報ファイルに出力されるホスト情報を次の表に示します。

表2‒80　エクスポートされるホスト情報（ホスト収集情報ファイル）

行

出力項目

出力値

1行目（ヘッダー情報）

製品名

JP1/IM-CF

ファイルフォーマットバージョン

ファイルフォーマットのバージョン

例えば，JP1/IM - Managerのバージョンが10-50の場合は，「101000」と出力されます。

文字コード

文字コード

マネージャーの環境変数LANGの設定に依存します。詳細は，「表2-79　ファイルの文字コード」を参照してください。

2行目（ヘッダー情報）

実ホスト名

Real_host_name

OS名

OS_name

製品名

JP1_product_name

製品形名

JP1_product_id

バージョン

JP1_product_version

インストールパス

Install_path

環境設定ファイル格納フォルダ

Conf_dir

更新日時

Date

更新日時（GMT）

Total_time

ホスト名

Host_name

仮想化管理種別

Virtual_manager_type

仮想化製品バージョン

Virtual_manager_version

3行目以降

実ホスト名

ホストの実ホスト名

OS名

ホスト上で動作しているOS名

製品名

ホスト上で動作している製品名

製品形名

製品の型名

バージョン

製品のバージョン

インストールパス

製品のインストールパス

環境設定ファイル格納フォルダ

製品の環境設定ファイルを格納したフォルダ

更新日時

YYYY/MM/DD hh:mm:ss

更新日時（GMT）

YYYY/MM/DD hh:mm:ss（GMT）※1

ホスト名

システムの階層構成に登録したホストのホスト名

仮想化管理種別

仮想化製品の種別（vCenter，JP1/SC/CM，SCVMM，HCSM，ESX※2，Hyper-V，KVM，Virtage※3）

仮想化製品バージョン※4

仮想化製品のバージョン

更新日時は，仮想化構成収集日時を出力します。

注※1　仮想化ソフトウェアおよび仮想化環境管理ソフトウェアを使用している場合は，仮想化構成収集日時が出力されます。

注※2　ESXは，VMware ESXを指します。

注※3　Virtageは，日立サーバ論理分割機構を指します。

注※4　仮想化管理種別がHCSMの場合，バージョンにはHCSMの外部接続インターフェースのバージョンが表示されます。そのため，表示されるバージョンと実際のHCSMのバージョンが異なるときがあります。また，仮想化構成情報をHCSMから収集した場合，仮想化管理種別が日立サーバ論理分割機構のホストではバージョン番号が表示されません。

出力例

JP1/IM-CF;101000;UTF-8,,,,,,,,,,,
Real_host_name,OS_name,JP1_product_name,JP1_product_id,JP1_product_version,Install_path,Conf_dir,Date,Total_time,Host_name,Virtual_manager_type,Virtual_manager_version
jp1_bs1,Windows,JP1/Base,P-242C-6L94,0900,C:¥Program Files¥Hitachi¥JP1Base,C:¥Program Files¥Hitachi¥JP1Base¥conf,2009/11/28 10:45:20,1205115658437,jp1-bs1,,
jp1-bs2,Windows, , , , , ,2009/11/28 10:45:20,1205115658437,jp1-bs2,ESX,3.5
jp1-bs3,Windows, , , , , ,2009/11/28 10:45:20,1205115658437,jp1-bs3,vCenter,4.0

プロファイル管理環境定義ファイル（jp1cf_profile_manager.conf）

形式

[論理ホスト名¥JP1CONFIG¥PROFILE_MANAGER¥JP1BASE]
"LOGFILETRAP_AUTO_START_CONTROL"=dword:16進数
"AGENT_PROFILE_UPDATE_NOTICE"=dword:16進数

ファイル

jp1cf_profile_manager.conf（プロファイル管理環境定義ファイル）

jp1cf_profile_manager.conf.model（プロファイル管理環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imcf

UNIXの場合

/etc/opt/jp1imm/conf/imcf

説明

プロファイル管理機能の実行環境の情報を定義するファイルです。

定義の反映時期

JP1/Baseのjbssetcnfコマンドで，プロファイル管理環境定義ファイルの定義をJP1共通定義情報に反映したあとに，JP1/IM - Managerを再起動すると有効になります。

記述内容

[論理ホスト名¥JP1CONFIG¥PROFILE_MANAGER¥JP1BASE]

プロファイル管理環境定義のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"LOGFILETRAP_AUTO_START_CONTROL"=dword:16進数

JP1/IM - Viewの［プロファイル表示/編集］画面で，ログファイルトラップの自動起動を設定する機能を有効にするかどうかを指定します。有効の場合，［起動オプション］の［ログファイルトラップサービスが起動したときに自動でプロセス起動する］チェックボックスが表示されます。

00000001：有効

00000000：無効

デフォルトは「00000001」（有効）です。

"AGENT_PROFILE_UPDATE_NOTICE"=dword:16進数

JP1/IM - Viewの［プロファイル表示/編集］画面で，プロファイルの編集や反映をする際，エージェントのプロファイルが更新された可能性があることを通知する機能を有効にするかどうかを指定します。

00000001：有効

00000000：無効

デフォルトは「00000001」（有効）です。

リモートログトラップ環境定義ファイル（jp1cf_remote_logtrap.conf）

形式

[論理ホスト名¥JP1CONFIG¥AGTLESS_MGR]
"MAX_COLLECT_EVENTLOG_DATA_SIZE"=dword:16進数
"MAX_COLLECT_WIN_LOG_DATA_SIZE"=dword:16進数
"MAX_COLLECT_UNIX_LOG_DATA_SIZE"=dword:16進数
"START_OPTION"="warm" | "cold"

ファイル

jp1cf_remote_logtrap.conf（リモートログトラップ環境定義ファイル）

jp1cf_remote_logtrap.conf.model（リモートログトラップ環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imcf

UNIXの場合

/etc/opt/jp1imm/conf/imcf

説明

リモート監視ログファイルトラップ機能とリモート監視イベントログトラップ機能の実行環境を定義するファイルです。

定義の反映時期

jbssetcnfコマンドの引数にリモートログトラップ環境定義ファイルを指定して共通定義に設定します。そのあと，次に示す契機でリモートログトラップ環境定義ファイルの設定が有効になります。

JP1/IM - Managerを起動したとき

jco_spmd_reloadコマンドを実行してリロードしたとき

なお，定義を反映した際に，1台のJP1/IM - Managerで監視できるログの総容量のチェックを実施し，10MBを超えていると警告メッセージKNAN26143-Wを統合トレースログに出力します。

記述内容

[論理ホスト名¥JP1CONFIG¥AGTLESS_MGR]

リモートログトラップ環境定義のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"MAX_COLLECT_EVENTLOG_DATA_SIZE"=dword:16進数

リモート監視イベントログトラップの1回の監視間隔で収集できるイベントログの取得上限を16進数で指定します。0x00002800〜0x00032000（10KB〜200KB）の範囲で指定できます。省略した場合，0x00002800（10KB）が仮定されます。

"MAX_COLLECT_WIN_LOG_DATA_SIZE"=dword:16進数

監視対象ホストがWindowsの場合のリモート監視ログファイルトラップの1回の監視間隔で収集できるログの取得上限を16進数で指定します。0x00002800〜0x00032000（10KB〜200KB）の範囲で指定できます。省略した場合，0x00002800（10KB）が仮定されます。

"MAX_COLLECT_UNIX_LOG_DATA_SIZE"=dword:16進数

監視対象ホストがUNIXの場合のリモート監視ログファイルトラップの1回の監視間隔で収集できるログの取得上限を16進数で指定します。0x00002800〜0x0000C800（10KB〜50KB）の範囲で指定できます。省略した場合，0x00002800（10KB）が仮定されます。

"START_OPTION"="warm" | "cold"

リモート監視を停止し，リモート監視を起動した場合，停止中に出力されたログを収集するかどうかを指定します。

"warm"を指定した場合，停止中に出力されたログを収集します。

"cold"を指定した場合，停止中に出力されたログを収集しません。

定義ファイルの指定を省略した場合は，"warm"が仮定されます。

定義例

定義例1：Windowsの場合

[JP1_DEFAULT¥JP1CONFIG¥AGTLESS_MGR]
"MAX_COLLECT_EVENTLOG_DATA_SIZE"=dword:00002800
"MAX_COLLECT_WIN_LOG_DATA_SIZE"=dword:00002800
"MAX_COLLECT_UNIX_LOG_DATA_SIZE"=dword:00002800
"START_OPTION"="warm"

定義例2：UNIXの場合

[JP1_DEFAULT¥JP1CONFIG¥AGTLESS_MGR]
"MAX_COLLECT_UNIX_LOG_DATA_SIZE"=dword:00002800
"START_OPTION"="warm"

マネージャーホストがUNIXで監視対象ホストがWindowsの場合，リモート監視はできないため，MAX_COLLECT_EVENTLOG_DATA_SIZEおよびMAX_COLLECT_WIN_LOG_DATA_SIZEを指定しても定義は設定されません。

リモート監視ログファイルトラップ動作定義ファイル

形式

retry-times=リトライ回数
retry-interval=リトライ間隔
open-retry-times=リトライ回数
open-retry-interval=リトライ間隔
hold-count=JP1イベントの保留件数
keep-event={ OLD | NEW }
unset-extattr=出力を抑止する属性
FILETYPE={ SEQ | SEQ2 | WRAP2 }
HEADLINE=ヘッダーの行数
MARKSTR=[!]"正規表現"
[!]"正規表現n"※
ACTDEF=[{EXIT}][重大度][イベントID][!]"正規表現"
[!]"正規表現n"※

注※　「正規表現n」は複数の正規表現の指定を表します。

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

リモート監視のログファイルトラップ機能の動作を定義するファイルです。リモート監視のログファイルトラップ機能の起動時にその内容を参照します。

UTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

定義の反映時期

次の場合に，リモート監視ログファイルトラップ動作定義ファイルの設定が有効になります。

［プロファイル表示/編集］画面でリロードまたは再起動

［プロファイル表示/編集］画面については，マニュアル「JP1/Integrated Management 2 - Manager 画面リファレンス」の「5.9　［プロファイル表示/編集］画面」を参照してください。

jcfallogstartコマンドまたはjcfallogreloadコマンドの実行

jcfallogstartコマンドの詳細については，「jcfallogstart」（1.　コマンド）を参照してください。jcfallogreloadコマンドの詳細については，「jcfallogreload」（1.　コマンド）を参照してください。

JP1/IM - Managerの再起動

記述内容

retry-times

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの回数を0〜86,400の範囲で指定します。省略した場合，リトライ処理はしません。

retry-interval

通信障害で，イベントサービスへの接続に失敗した場合に行うリトライ処理の間隔を1〜600（秒）の範囲で指定します。省略した場合，リトライ間隔を10秒と見なします。イベントサービスへの接続のリトライ回数を1以上に設定した場合に有効になります。リトライ間隔は，イベントサービスへの接続に失敗してから次にイベントサービスへの接続を試みるまでの間隔です。イベントサービスへの接続処理に掛かる時間は含みません。retry-timesおよびretry-intervalの組み合わせで24時間以上の設定もできますが，リトライを開始した時刻から24時間以上経過した場合，リトライ処理は打ち切られます。

open-retry-times

ログファイルの読み込みに失敗，または監視対象ホストに接続できなかった場合に行うリトライの回数を1〜3,600の範囲で指定します。省略した場合，リトライ回数を1回と見なします。指定したリトライ回数を超えた場合，ログファイルの監視を停止します。

open-retry-interval

ログファイルの読み込みに失敗，または監視対象ホストに接続できなかった場合に行うリトライ処理の間隔を3〜600（秒）の範囲で指定します。省略した場合，リトライ間隔を3秒と見なします。リトライ間隔は，エラー発生後，リトライを試みるまでの間隔です。

hold-count

リトライ処理中に保留できるJP1イベントの件数を1〜100の範囲で指定します。省略した場合，保留件数を100件と見なします。リトライ処理を行う場合，リトライ処理中に変換されたJP1イベントを保留するためのリソースが必要となります。リトライ処理を行う場合に必要なメモリー所要量を次に示します。

JP1イベントの保留件数 × 1KB

keep-event={ OLD | NEW }

リトライ処理中に保留されたJP1イベントが保留件数を超過した場合，超過したJP1イベントは消去されます。超過した場合に，古いJP1イベントと新しいJP1イベントのどちらを残すかを次のどちらかの値で指定します。省略した場合，OLDが指定されたものと見なします。

OLD

古いJP1イベントを残したい場合に指定します。この場合，hold-countに指定した保留件数までのJP1イベントが保留され，以降に発生したJP1イベントは消去されます。

NEW

新しいJP1イベントを残したい場合に指定します。この場合，JP1イベントの保留件数を超過すると，古いJP1イベントから消去されます。

unset-extattr

属性を出力しない場合に指定します。JP1/Baseのバージョンが10-50以降の場合に，設定できます。監視名を出力しない場合は，TRAP_NAMEを指定します。監視IDを出力しない場合は，TRAP_IDを指定します。監視名と監視IDの両方を出力しない場合は，TRAP_NAMEとTRAP_IDをコンマ（,）区切りで指定します。監視名と監視IDの両方を出力しない指定例を次に示します。

（例）

TRAP_NAME,TRAP_ID

このパラメーターは，1行で記述します。

FILETYPE={ SEQ | SEQ2 | WRAP2 }

トラップするログファイルのデータ出力形式を指定します。省略した場合，SEQが指定されたものと見なします。

トラップするログファイルのデータ出力形式については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「7.6.3(1)　ログファイルトラップ情報の出力形式」を参照してください。

HEADLINE

読み込むログファイルの先頭にヘッダーがある場合，ヘッダーの行数を0〜99,999の範囲で指定します。省略した場合，ヘッダーがないものと見なします。

なお，指定したヘッダーに含まれる文字列のサイズが，ヘッダーサイズの上限（10キロバイト）を超えている場合は，エラーとなります。

MARKSTR=[!]"正規表現"

ログデータ以外のデータなど，監視の対象外にしたいデータを正規表現で指定します。省略した場合，指定がないものと見なします。正規表現は「"」で囲んでください。ログデータ以外のデータとは，一定間隔でログファイル中に出力されるデータなどです。ログデータ以外のデータの例を次に示します。

（例）

"==== 13:00:00 JP1/Base Event ===="

「!」を「"　"」の前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを監視の対象外とします。

一つのMARKSTRには，複数の正規表現を指定できます。複数の正規表現を指定した場合，AND条件となり，「!」の指定も含むすべての正規表現の条件に一致するデータだけを監視対象外とします。なお，複数の正規表現を指定する場合は，正規表現の間を改行で区切ってください。2行目からは値だけを指定します。この場合，2行目以降の値の前に一つ以上の空白を入れてください。次に，「====」および「MARK」を含むデータを監視の対象外に指定する場合の例を示します。

（例）

MARKSTR="===="（改行）

△△△△△"MARK"

（凡例）△：空白

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべて監視対象外とします。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭からjevlogstartコマンドの-mオプションで指定した長さまでの間だけです。このパラメーターを省略すると，ログデータ以外のデータはないと仮定されます。

ACTDEF＝[{EXIT}][重大度][イベントID][!]"正規表現"

JP1イベントに変換するログデータの正規表現と，対応するJP1イベントのイベントIDおよび重大度を指定します。省略した場合，指定がないものと見なします。正規表現に一致するログがあると，指定したイベントIDでJP1イベントを発行します。なお，「=」，「EXIT」，「重大度」，および「イベントID」の間にはスペースまたはタブを入れないでください。入れた場合は文法エラーになります。

EXIT

複数のACTDEFパラメーターを指定した場合に，「EXIT」を指定した条件に一致した時点で，そのログデータの監視を終了します。

複数のACTDEFパラメーターを指定した場合，一つのログデータが複数のACTDEFパラメーターの条件に一致すると，一致した数だけJP1イベントが発行されます。「EXIT」を指定しておくと，「EXIT」を指定した条件のイベントIDでJP1イベントが発行され，以降の監視は行われません。

重大度

JP1イベントの拡張属性の重大度を「<　>」で囲んで指定します。重大度とイベントIDは，対にして指定します。指定できる値を次に示します。

Emergency

Alert

Critical

Error

Warning

Notice

Information

Debug

指定を省略した場合はNoticeが仮定されます。

イベントID

イベントサーバにJP1イベントを登録する際のイベントIDを指定します。イベントIDは上位4バイト（基本コード）と下位4バイト（拡張コード）をコロン「:」で区切り，16進数で記述します。A〜Fは大文字で記述してください。なお，下位4バイトまたはコロン以下の下位4バイトは省略できます。この場合，省略値には0を仮定します。また，上位下位とも8桁に満たない場合は前から補われます。ユーザーが指定できる範囲の値，0:0〜1FFF:0および7FFF8000:0〜7FFFFFFF:0を指定してください。なお，拡張コードには0を指定してください。イベントIDの表記例を次に示します。

（例）

次に示す3とおりの表記は同じ意味になります。

0000011A:00000000

11A:0

11A

"正規表現"

JP1イベントに変換するログデータを正規表現で指定します。使用できる正規表現は拡張正規表現固定となります。正規表現は「"」で囲んでください。「!」を一つ目の「"　"」の手前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを変換対象とします。

一つのACTDEFパラメーターには，複数の正規表現を指定できます。複数の正規表現を指定した場合，AND条件となり，「!」の指定も含むすべての正規表現の条件に一致するデータだけをJP1イベントに変換します。なお，複数の正規表現を指定する場合は，正規表現の間を改行で区切ってください。2行目からは正規表現だけを指定します。この場合，2行目以降の値の前に一つ以上の空白を入れてください。次に，「jp1base」および「error」を含むデータを，イベントID「00000333」でJP1イベントに変換する場合の指定例を示します。

（例）

ACTDEF=00000333 "jp1base"（改行）

△△△△△"error"

（凡例）△：空白

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべてJP1イベントに変換します。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭から「起動オプションのイベント化するデータの最大長（バイト）」まで指定した長さまでの間だけです。

このパラメーターは省略できません。

定義例

MARKSTRパラメーターおよびACTDEFパラメーターの定義例

次に示すログデータを基に，MARKSTRパラメーターおよびACTDEFパラメーター部分の定義例を説明します。

定義例1

ログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

定義例2

定義例1とは異なるログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

リモート監視イベントログトラップ動作定義ファイル

形式

retry-times リトライ回数
retry-interval リトライ間隔
open-retry-times=リトライ回数（イベントログの収集のリトライ回数）
open-retry-interval=リトライ間隔（イベントログの収集のリトライ間隔）
trap-interval 監視間隔
matching-level 比較レベル
filter-check-level フィルターチェックレベル
# フィルター
filter　ログの種別　[id=イベントID]　[trap-name=監視名]
　　条件文1
　　条件文2
　　　：
　　条件文n
end-filter

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

リモート監視のイベントログトラップ機能の動作を定義するファイルです。リモート監視のイベントログトラップ機能の起動時にその内容を参照します。

UTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

定義の反映時期

次の場合に，リモート監視イベントログトラップ動作定義ファイルの設定が有効になります。

［プロファイル表示/編集］画面でリロードまたは再起動

［プロファイル表示/編集］画面については，マニュアル「JP1/Integrated Management 2 - Manager 画面リファレンス」の「5.9　［プロファイル表示/編集］画面」を参照してください。

jcfaleltstartコマンドまたはjcfaleltreloadコマンドの実行

jcfaleltstartコマンドの詳細については，「jcfaleltstart（Windows限定）」（1.　コマンド）を参照してください。jcfaleltreloadコマンドの詳細については，「jcfaleltreload（Windows限定）」（1.　コマンド）を参照してください。

JP1/IM - Managerの再起動

記述内容

retry-times

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの回数を0〜86,400の範囲で指定します。省略した場合，リトライ処理はしません。指定された回数のリトライが成功しない場合はエラーとします。retry-timesおよびretry-intervalの組み合わせで24時間以上の設定もできますが，リトライを開始した時刻から24時間以上経過した場合，リトライ処理は打ち切られます。

retry-interval

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライ間隔を1〜600（秒）の範囲で指定します。省略した場合，リトライ間隔を10秒と見なします。

open-retry-times

イベントログの収集に失敗，または監視対象ホストに接続できなかった場合に行うリトライの回数を1〜3,600の範囲で指定します。省略した場合，リトライ回数を3回と見なします。指定したリトライ回数を超えた場合，ログファイルの監視を停止します。

open-retry-interval

イベントログの収集に失敗，または監視対象ホストに接続できなかった場合に行うリトライ処理の間隔を3〜600（秒）の範囲で指定します。省略した場合，trap-intervalが指定されているときは，trap-intervalに指定した値になります。trap-intervalが指定されていないときは，300秒になります。リトライ間隔は，エラー発生後，リトライを試みるまでの間隔です。

trap-interval

イベントログを監視する間隔を60〜86,400（秒）の範囲で指定します。省略した場合，300秒と見なします。イベントログトラップは，一定の間隔でイベントログを監視します。

matching-level

フィルターにmessage属性またはcategory属性を指定した場合で，メッセージDLLまたはカテゴリーDLLが正しく設定されてないなどの理由で，イベントログの説明文の読み込みに失敗したときの，イベントログと定義内容の比較レベルを指定します。0を指定すると，比較しないで次のフィルターと比較をします。1を指定すると，比較します。省略した場合，0を指定したものと見なします。

filter-check-level

フィルターに不正な（システムに存在しない）ログの種別や不正な正規表現指定がある場合のチェックレベルを指定します。0を指定すると，フィルターに不正なログの種別や不正な正規表現がある場合，該当するフィルターを無効にします。ただし，有効なフィルターが一つでもある場合，リモート監視イベントログトラップの起動またはリロードは成功します。有効なフィルターが一つもない場合，リモート監視イベントログトラップの起動またはリロードは失敗します。1を指定すると，フィルターに不正なログの種別や不正な正規表現が一つでもある場合，リモート監視イベントログトラップの起動またはリロードは失敗します。

省略した場合，0を指定したものと見なします。

filter〜end-filter

ログの種別

監視の対象となるイベントログの種別を指定します。

（例）

”アプリケーション”または”Application”

”セキュリティ”または”Security”

”システム”または”System”

”DNS Server”

”Directory Service”

”ファイルレプリケーションサービス”または”File Replication Service”

”DFS レプリケーション”または”DFS Replication”

複数のフィルターに同一のログの種別を指定した場合，それらのフィルターのどれかの条件を満たすときに成立します。

[id=イベントID]

イベントサーバにJP1イベントを登録する際のイベントIDを指定します。イベントIDは上位4バイト（基本コード）と下位4バイト（拡張コード）をコロン「:」で区切り，16進数で記述します。A〜Fは大文字で記述してください。なお，下位4バイトまたはコロン以下の下位4バイトは省略できます。この場合，省略値には0を仮定します。また，上位下位とも8桁に満たない場合は前から補われます。ユーザーが指定できる範囲の値，0:0〜1FFF:0および7FFF8000:0〜7FFFFFFF:0を指定してください。「id=」と値の間には，スペースやタブを入れないでください。ログの種別と監視名の間には，スペースを入れてください。この値を省略すると，イベントID（00003A71）が指定されます。イベントIDの表記例を次に示します。

（例）

次に示す3とおりの表記は同じ意味になります。

0000011A:00000000

11A:0

11A

[trap-name=監視名]

イベントログを変換して登録されたJP1イベントが，どのフィルターに該当したものなのか判別する際の監視名を指定します。監視名の先頭の文字は，必ず英数字を指定してください。英大文字・英小文字を区別します。スペースやタブを入れないでください。このパラメーターを省略すると，JP1イベント変換時に拡張属性（E.JP1_TRAP_NAME）が作成されません。

条件文

条件文の指定は次のとおりです。

・属性指定にtype以外を指定した場合

属性指定　正規表現１　正規表現２　正規表現３ …

・属性指定にtypeを指定した場合

type ログの種類１ ログの種類２　ログの種類３ …

属性指定のあとに列挙された正規表現（またはログの種類）のどれかが成立した場合に成立します。なお，フィルター内の条件文はAND条件，フィルター間はOR条件です。

属性設定

属性設定は次のとおりです。

属性名

記述する内容

type

ログの種類

source

ソース

category

分類

id

イベントID

user

ユーザー

message

説明

computer

コンピュータ名

・注意事項

属性設定で”message"を指定した場合，イベントログの説明文で「〜に関する説明が見つかりませんでした」という説明文（メッセージDLLが存在しない説明文）を含んだイベントログは，メッセージを作成できません。このため，トラップ対象外となります。挿入句にトラップ対象の語句が含まれていたとしてもトラップされません。

上記の場合，Windowsのイベントログの仕組みに従って，イベントログの説明文を記載したメッセージDLLが正しく設定された状態でご利用ください。メッセージDLLが正しく設定されていないと，イベントログから説明文を読み込めないため，トラップの対象にできないことがあります。なお，メッセージDLLがないメッセージをトラップしたい場合は，matching-levelパラメーターを1に設定してください。

なお，監視できるログ情報の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「7.6.3　監視できるログ情報」を参照してください。

正規表現

正規表現は，’...’ のように引用符で囲まれた文字列で指定します。!’...’のように引用符の前に感嘆符を付加した場合，指定した正規表現以外の文字列という意味となります。正規表現中に ’ を指定する場合は ¥’ のようにエスケープ指定する必要があります。正規表現は，ログの種類がtype以外の場合に指定できます。

ログの種類

ログの種類は次のとおりです。

ログの種類

内容

重大度

Information

情報

Information（情報）

Warning

警告

Warning（警告）

Error

エラー

Error（エラー）

Audit_success

成功の監査

Notice（通知）

Audit_failure

失敗の監査

Notice（通知）

定義例

定義例1：OR条件とAND条件

OR条件の定義例

ログの種別が「システムログ」で，説明に「TEXT」，「MSG」，または「-W」のどれかを含む。

filter "System"
    message 'TEXT' 'MSG' '-W'
end-filter

条件をスペースまたはタブで区切って指定すると，OR条件になります。

AND条件の定義例

ログの種類が「システムログ」で，説明に「TEXT」，「MSG」，および「-W」をすべて含む。

filter "System"
    message 'TEXT'
    message 'MSG'
    message '-W'
end-filter

条件を改行で区切って指定すると，AND条件になります。改行した場合は，属性名から記述してください。

定義例2：複数のフィルターを設定する

ログの種別が「アプリケーションログ」のイベントログのうち，次に示す条件のイベントログをトラップする。

フィルター1

・種別：アプリケーションログ

・種類：エラー

・説明：「-E」および「JP1/Base」を含む。

フィルター2

・種別：アプリケーションログ

・種類：警告

・説明：「-W」または「warning」を含む。

#フィルター1
filter "Application"
    type Error
    message '-E'
    message 'JP1/Base'
end-filter
#フィルター2
filter "Application"
    type Warning
    message '-W' 'warning'
end-filter

定義例3：正規表現を使用する

次に示す条件のイベントログをトラップする。

種別：アプリケーションログ

種類：エラー

イベントID：111

説明：「-E」または「MSG」を含み，かつ「TEXT」を含まない。

filter "Application"
    type Error
    id '^111$'
    message '-E' 'MSG'
    message !'TEXT'
end-filter

「111」のイベントIDを条件にしたい場合は，正規表現を使用して，「id '^111$'」と指定してください。「id '111'」と指定すると，「イベントIDに111を含む」という条件になるため，イベントIDが「1112」や「0111」でも条件が成立します。「!」を「'　'」の手前に付けた場合は，指定した正規表現に一致しないデータを選択します。正規表現は，JP1/Baseの拡張正規表現固定となります。拡張正規表現の詳細については，マニュアル「JP1/Base 運用ガイド」の正規表現の文法を説明している個所を参照してください。

定義例4：特定のイベントログだけ変換しない

ログの種別が「システムログ」で，ログの種類が「警告」のイベントログのうち，次に示す条件のイベントログだけトラップしない。

ソース：AAA

イベントID：111

説明：「TEXT」を含む。

#ソースがAAAのイベントログはトラップしない。

filter "System"
    type Warning
    source !'AAA'
end-filter
#ソースがAAA，かつイベントIDが111以外のイベントログをトラップする。
filter "System"
    type Warning
    source 'AAA'
    id !'^111$'
end-filter
#ソースがAAA，イベントIDが111，かつ説明に「TEXT」を含まないイベントログをトラップする。
filter "System"
    type Warning
    source 'AAA'
    id '^111$'
    message !'TEXT'

end-filter

セットアップ情報ファイル（jimdbsetupinfo.conf）

形式

#IM DATABASE SERVICE - DB Size
IMDBSIZE=値
#IM DATABASE SERVICE - Data Storage Directory
IMDBDIR=値
#IM DATABASE SERVICE - Port Number
IMDBPORT=値
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=値
#IM DATABASE SERVICE - Host Name
IMDBHOSTNAME=値

ファイル

jimdbsetupinfo.conf（セットアップ情報ファイル）

jimdbsetupinfo.conf.model（セットアップ情報ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imdb¥setup¥

UNIXの場合

/etc/opt/jp1imm/conf/imdb/setup/

説明

統合監視DBおよびIM構成管理DBのセットアップ時に，IMデータベースのサイズやIMデータベースのデータを格納するディレクトリなどを記述するファイルです。

なお，セットアップ情報ファイルは，統合監視DBとIM構成管理DBのセットアップ時に共通で参照します。統合監視DBまたはIM構成管理DBをセットアップしたあとに，もう一方のデータベースを作成する場合には，同じ値を指定する必要があります。

セットアップ情報ファイルに指定するIMデータベースのサイズごとのおおよそのディスク占有量を，次の表に示します。

なお，次の表に記載の領域のほかに，IMデータベースのサイズに関わらず，IMデータベースインストール先ディレクトリ（IMDBENVDIR）に，約0.2ギガバイトの空き領域が必要です。ディスク占有量の詳細な値については，JP1/IM - Managerのリリースノートを参照してください。ディスク占有量を見積もる際は，JP1/IM - Managerのリリースノートに記載された値を使用してください。

表2‒81　作成するデータベースのサイズ

サイズ

システムDB領域※1※2（ギガバイト）

統合監視DB領域※1※3（ギガバイト）

IM構成管理DB領域※1※4（ギガバイト）

合計（ギガバイト）

S

2

9

2

13

M

3

33

2

38

L

7

98

11

116

注※1

セットアップ情報ファイルに指定したデータベース格納先ディレクトリ（IMDBDIR）の直下に作成されます。

注※2

IMデータベースをセットアップ中に作られる統合監視DBおよびIM構成管理DBが共有する領域です。

注※3

jcodbsetupコマンドを実行したときに作られる領域です。

注※4

jcfdbsetupコマンドを実行したときに作られる領域です。

定義の反映時期

セットアップ時に，このファイルの内容を読み込み，各項目に指定された値でIMデータベースの環境を構築します。

記述内容

IMDBSIZE

作成するIMデータベースのサイズを半角英大文字のS，M，Lで指定します。デフォルトはSです。

IMDBDIR

IMデータベースのデータを格納するディレクトリを絶対パス形式で指定します。指定したディレクトリの直下にimdbディレクトリを作成し，IMデータベースのファイル（領域）を格納します。デフォルトは次のとおりです。

Windowsの場合：Managerパス¥database

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：/var/opt/jp1imm/database

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

必要なディレクトリの権限は表2-82を参照してください。

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，.（ピリオド），および半角スペースで構成される95文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される95文字以内の文字列です。パス区切り文字（/）で始める必要があります。

IMDBPORT

IMデータベースが使用するポート番号を指定します。指定できる範囲は，5001〜65535です。デフォルトは20700です。

ここで指定するポート番号は，次のポート番号とは重複できません。

ほかの論理ホストのセットアップで指定したポート番号

servicesファイルに記載されているポート番号※

ほかの製品の組み込みHiRDBで使用しているポート番号

ほかの製品，OSなどが使用する一時ポート番号

注※　IMDBPORTに設定したポート番号を，あとでservicesファイルに記載しないようにしてください。

IMDBENVDIR

IMデータベースをインストールするディレクトリを絶対パス形式で指定します。指定したディレクトリの直下にディレクトリ（JMn：nはLOGICALHOSTNUMBERと一致します）を作成し，IMデータベースをインストールします。デフォルトは次のとおりです。

Windowsの場合：Managerパス¥dbms

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：/var/opt/jp1imm/dbms

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

また，シンボリックリンクを含むパスは指定しないでください。

ディレクトリの権限を次の表に示します。

表2‒82　OSとディレクトリ権限の対応

OS

権限

Linux

所有者：root

グループ：root

モード：755

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，および半角スペースで構成される195文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される123文字以内（Linuxの場合は22文字以内）の文字列です。パス区切り文字（/）で始める必要があります。

IMDBHOSTNAME

ほかのホストで動作するJP1/IM - MOとの通信に使用するホスト名，またはIPアドレスを指定します。ほかのホストのJP1/IM - MOと連携していない場合は，この項目を指定する必要はありません。

デフォルトは，ローカルホスト名です。値を省略した場合は，ローカルホスト名が仮定されます。使用できる文字列は，32文字以内の半角英数字，-，_，@，および.（ピリオド）です。

定義例

#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Data Storage Directory
IMDBDIR=Managerパス¥database
#IM DATABASE SERVICE - Port Number
IMDBPORT=20700
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Managerパス¥dbms
#IM DATABASE SERVICE - DB Host Name
IMDBHOSTNAME=

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

形式

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=値
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=値
#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Port Number
IMDBPORT=値
#IM DATABASE SERVICE - Data Storage Directory (Local Work Area)
IMDBDIR=Managerパス¥db
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREDBDIR=共有ディレクトリ¥db
#IM DATABASE SERVICE - Online Host Name
ONLINEHOSTNAME=値
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Managerパス¥dbms

ファイル

jimdbclustersetupinfo.conf（クラスタセットアップ情報ファイル）

jimdbclustersetupinfo.conf.model（クラスタセットアップ情報ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imdb¥setup¥

UNIXの場合

/etc/opt/jp1imm/conf/imdb/setup/

説明

統合監視DBおよびIM構成管理DBのクラスタ環境のセットアップ時に，論理ホスト用のIMデータベースのサイズや論理ホスト用のIMデータベースのデータを格納するディレクトリなどを記述するファイルです。

なお，クラスタセットアップ情報ファイルは，統合監視DBとIM構成管理DBのセットアップ時に共通で参照します。統合監視DBまたはIM構成管理DBをセットアップしたあとに，もう一方のデータベースを作成する場合には，同じ値を指定する必要があります。また，クラスタ環境を構築する場合，待機系のセットアップをするときは，実行系で使用したクラスタセットアップ情報ファイルをコピーし，実行してください。同一ホストに複数の論理ホストを設定する場合は，jimdbclustersetupinfo.conf（クラスタセットアップ情報ファイル）を別名でコピーし，設定情報を変更する必要があります。

クラスタセットアップ情報ファイルに指定するIMデータベースのサイズごとのおおよそのディスク占有量を，次の表に示します。

なお，次の表に記載の領域のほかに，IMデータベースのサイズに関わらず，ローカルディスクのIMデータベースインストール先ディレクトリ（IMDBENVDIR）に，約0.2ギガバイトの空き領域が必要です。ディスク占有量の詳細な値については，JP1/IM - Managerのリリースノートを参照してください。ディスク占有量を見積もる際は，JP1/IM - Managerのリリースノートに記載された値を使用してください。

表2‒83　作成するデータベースのサイズ

サイズ

ローカルディスク

共有ディスク

システムDB領域（ローカルディスク）※1（ギガバイト）

システムDB領域（共有ディスク）※2（ギガバイト）

統合監視DB領域※2（ギガバイト）

IM構成管理DB領域※2（ギガバイト）

合計（ギガバイト）

S

0.1

2

9

2

13

M

0.1

3

33

2

38

L

0.2

7

98

11

116

注※1

システムDB領域（ローカルディスク）は，クラスタセットアップ情報ファイルに指定したローカルデータベース格納ディレクトリの直下（IMDBDIR）に作成されます。

注※2

システムDB領域（共有ディスク），統合監視DB領域とIM構成管理DB領域は，クラスタセットアップ情報ファイルに指定した共有データベース格納先ディレクトリ（SHAREDBDIR）の直下に作成されます。

定義の反映時期

セットアップ時に，このファイルの内容を読み込み，各項目に指定された値で論理ホスト用のIMデータベースの環境を構築します。

記述内容

LOGICALHOSTNUMBER

論理ホスト用のIMデータベースで論理ホストを識別する番号を1〜9の半角数値で指定します。

論理ホストを追加する場合は，別の番号を指定する必要があります。実行系と待機系で同じ番号を指定してください。

LOGICALHOSTNAME

論理ホスト名を指定します。論理ホスト名には，jp1cohasetupコマンドおよびjp1cc_setup_clusterコマンドで指定した論理ホスト名を指定してください。IMデータベースは，jp1hostsファイルおよびjp1hosts2ファイルを参照しません。このため，LOGICALHOSTNAMEにはhostsファイルなどOSの機能で名前解決できる論理ホスト名を指定してください。指定できる文字列は，半角英数字，_，-，.（ピリオド），および@で構成される32文字以内の文字列です。なお，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。論理ホストのJP1/Baseのセットアップについては，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の次の個所を参照してください。

Windowsの場合

参照先：7.3.3(2)　JP1/Baseのセットアップ

UNIXの場合

参照先：8.3.3(2)　JP1/Baseのセットアップ

IMDBSIZE

作成する論理ホスト用のIMデータベースのサイズを半角英大文字のS，M，Lで指定します。デフォルトはSです。

IMDBDIR

論理ホスト用のIMデータベースのデータを格納するディレクトリを絶対パス形式で指定します。クラスタの共有ディスクは指定しないでください。指定したディレクトリの直下にimdbディレクトリを作成し，論理ホスト用のIMデータベースのファイル（ローカル作業領域用）を格納します。

Windowsの場合：

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

ディレクトリの権限を次の表に示します。

表2‒84　OSとディレクトリ権限の対応

OS

権限

Linux

所有者：root

グループ：root

モード：755

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，.（ピリオド），および半角スペースで構成される95文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される95文字以内の文字列です。パス区切り文字（/）で始める必要があります。

IMDBPORT

論理ホスト用のIMデータベースが使用するポート番号を指定します。指定できる範囲は，5001〜65535です。

ここで指定するポート番号は，次のポート番号とは重複できません。

ほかの論理ホストのセットアップで指定したポート番号

servicesファイルに記載されているポート番号※

ほかの製品の組み込みHiRDBで使用しているポート番号

ほかの製品，OSなどが使用する一時ポート番号

注※　IMDBPORTに設定したポート番号を，あとでservicesファイルに記載しないようにしてください。

SHAREDBDIR

クラスタ構成時に実行系と待機系で共有する，論理ホスト用のIMデータベースのデータを格納するディレクトリを絶対パス形式で指定します。共有ディスク上のディレクトリを指定してください。指定したディレクトリの直下にimdbディレクトリを作成し，論理ホスト用のIMデータベースのファイル（共有データ領域用）を格納します。

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，.（ピリオド），および半角スペースで構成される95文字以内の文字列です。ドライブ名で始める必要があります。

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される95文字以内の文字列です。パス区切り文字（/）で始める必要があります。

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

必要なディレクトリの権限は表2-84を参照してください。

ONLINEHOSTNAME

実行系のホスト名を指定します。実行系のホスト名には，名前解決できるホスト名を指定してください。指定できる文字列は，半角英数字，_，-，/，.（ピリオド），および@で構成される32文字以内の文字列です。なお，実行系のホスト名は，大文字・小文字を区別します。実行系のホスト名は大文字・小文字を含めて正確に指定してください。

IMDBENVDIR

論理ホスト用のIMデータベースをインストールするディレクトリを絶対パス形式で指定します。クラスタの共有ディスクは指定しないでください。指定したディレクトリの直下にディレクトリ（JMn：nはLOGICALHOSTNUMBERと一致します）を作成し，論理ホスト用のIMデータベースをインストールします。デフォルトは次のとおりです。

Windowsの場合：Managerパス¥dbms

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：/var/opt/jp1imm/dbms

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

また，シンボリックリンクを含むパスは指定しないでください。

必要なディレクトリの権限は表2-84を参照してください。

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，および半角スペースで構成される195文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される123文字以内（Linuxの場合は22文字以内）の文字列です。パス区切り文字（/）で始める必要があります。

定義例

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=1
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=host1
#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Data Storage Directory (Local Work Area)
IMDBDIR=Managerパス¥db
#IM DATABASE SERVICE - Port Number
IMDBPORT=20750
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREDBDIR=共有ディレクトリ¥db
#IM DATABASE SERVICE - Online Host Name
ONLINEHOSTNAME=host_H1
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Managerパス¥dbms

イベントレポート出力の項目ファイル

形式

[@]項目名
# コメント行
    ：

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

イベントレポート出力で出力したいJP1イベントの属性を指定するファイルです。

このファイルの最大サイズは，32キロバイト（32,768バイト）です。

定義の記述

半角スペースまたはタブだけで構成された行は無視されます。

各行の先頭のパラメーター名の前，および末尾の半角スペース，タブは無視されます。

定義の反映時期

-kオプションを指定してjcoevtreportコマンドを実行すると，指定した項目ファイルを読み込み，項目ファイルに従ってJP1イベントの属性値をイベントレポート出力します。

ファイル内容

項目名

イベントレポート出力で出力したい項目を指定します。

指定できる項目を次の表に示します。

項番

指定できる項目

内容

1

B.SEQNO

イベントDB内通し番号

2

B.ID

イベントID

3

B.PROCESSID

発行元プロセスID

4

B.TIME

登録時刻

5

B.ARRIVEDTIME

到着時刻

6

B.REASON

登録要因

7

B.USERID

発行元ユーザーID

8

B.GROUPID

発行元グループID

9

B.USERNAME

発行元ユーザー名

10

B.GROUPNAME

発行元グループ名

11

B.SOURCESERVER

登録ホスト名

12

B.DESTSERVER

送信先イベントサーバ名

13

B.SOURCEIPADDR

発行元IPアドレス

14

B.DESTIPADDR

送信先IPアドレス

15

B.SOURCESEQNO

発行元イベントDB内通し番号

16

B.CODESET

コードセット

17

B.MESSAGE

メッセージ

18

E.SEVERITY

重大度

19

E.USER_NAME

ユーザー名

20

E.PRODUCT_NAME

プロダクト名

21

E.OBJECT_TYPE

オブジェクトタイプ

22

E.OBJECT_NAME

オブジェクト名

23

E.ROOT_OBJECT_TYPE

登録名タイプ

24

E.ROOT_OBJECT_NAME

登録名

25

E.OBJECT_ID

オブジェクトID

26

E.OCCURRENCE

事象種別

27

E.START_TIME

開始時刻

28

E.END_TIME

終了時刻

29

E.RESULT_CODE

終了コード

30

E.JP1_SOURCEHOST

発生元ホスト名

31

E.@JP1IM_ACTTYPE

アクション種別

32

E.@JP1IM_ACTCONTROL

アクション

33

E.@JP1IM_SEVERE

重要イベント

34

E.@JP1IM_CORRELATE

相関イベント

35

E.@JP1IM_RESPONSE

応答待ちイベント

36

E.@JP1IM_ORIGINAL_SEVERITY

重大度(変更前)

37

E.@JP1IM_CHANGE_SEVERITY

重大度変更

38

E.@JP1IM_DEALT

対処状況

39

E.@JP1IM_RELEASE

重要イベント解除

40

E.@JP1IM_DISMISSED

重要イベント削除

41

E.@JP1IM_MEMO

メモ

42

E.@JP1IM_DISPLAY_MESSAGE

メッセージ(変更後)

43

E.@JP1IM_CHANGE_MESSAGE

表示メッセージ変更

44

E.@JP1IM_CHANGE_MESSAGE_NAME

表示メッセージ変更定義名

45

E.固有の拡張属性名

固有の拡張属性

JP1イベントに属性がない場合は，空文字を出力します。また，項目名の先頭に「@」を指定すると，基本属性および拡張属性の日時項目をYYYYMMDDhhmmss形式で出力します。ただし，「@」を指定したJP1イベントの属性に次の値が入っている場合は変換しないで出力します。

数値以外の値

0未満の数値，または2,147,483,648以上の数値

#コメント行

#で始まる行は，コメント扱いとなります。

定義例

B.SEQNO
B.ID
B.PROCESSID
B.TIME
　：

イベントレポート出力環境定義ファイル（evtreport.conf）

形式

[論理ホスト名¥JP1CONSOLEMANAGER]
"PROGRAM_SPECIFIC_EX_ATTR_COLUMN"=dword:16進数値

ファイル

evtreport.conf（イベントレポート出力環境定義ファイル）

evtreport.conf.update（イベントレポート出力環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

イベントレポート出力機能の実行環境の情報を定義するファイルです。機能を有効にするかどうかを指定します。

定義の反映時期

JP1/Baseのjbssetcnfコマンドで，イベントレポート出力環境定義ファイルをJP1共通定義情報に反映した後に，JP1/IM - Managerを再起動すると有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER]

JP1/IM - Managerの環境設定のキー名称を示します。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"PROGRAM_SPECIFIC_EX_ATTR_COLUMN"=dword:16進数値

jcoevtreportコマンドで固有の拡張属性を出力するときに，基本属性，共通の拡張属性，およびIM属性と同じように1件の固有の拡張属性に一つの列を割り当てて出力する機能を有効にするかどうかを指定します。

00000001：有効

00000000：無効

デフォルトは「00000001」（有効）です。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER]
"PROGRAM_SPECIFIC_EX_ATTR_COLUMN"=dword:00000001

イベントレポート出力のフィルターファイル

形式

イベント条件
    ：
OR
イベント条件
    ：
EXCLUDE
イベント条件
    ：

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

イベントレポート出力時のフィルター条件を指定する定義ファイルです。-fオプションを指定してjcoevtreportコマンドを実行すると読み込まれます。

このファイルの最大サイズは，256キロバイト（262,144バイト）です。

定義の反映時期

-fオプションを指定してjcoevtreportコマンドを実行すると，指定した項目ファイルを読み込み，指定された条件と一致するJP1イベントを統合監視DBから取得してイベントレポート出力します。

ファイル内容

通過条件群，除外条件群

jcoevtreportコマンドは，すべての除外条件群に一致しないJP1イベント，かつ，通過条件群のどれか一つが一致するJP1イベントを出力対象のJP1イベントと判断します。フィルター条件には，0〜5件の通過条件群と0〜5件の除外条件群を記述できます。

通過条件群または除外条件群には，0〜50件のイベント条件を指定できます。ただし，拡張属性（固有情報）のイベント条件は，一つの通過条件群または除外条件群に最大5件指定できます。

OR

条件群を複数指定する場合は，各条件群の間に「OR」を記述します。

EXCLUDE

通過条件群と除外条件群の間には，「EXCLUDE」を記述します。「EXCLUDE」以降のイベント条件は，除外条件群と見なします。「EXCLUDE」以降にイベント条件がない場合は，通過条件群だけが有効になります。

イベント条件

イベント条件は，次の形式で指定します（△は半角スペースを表す）。

　属性名△比較キーワード△オペランド[△オペランド]…

なお，半角スペース，または，タブだけで構成された行は，無視して処理を続行します。

属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，比較キーワードに正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。%のあとに指定する文字コードは，英大文字・英小文字を区別しません。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

イベント条件で指定できる属性名，比較キーワードおよびオペランドについて次の表に示します。

項番

項目

属性名

比較キーワード

オペランド

1

イベントID

B.ID

一致する

一致しない

複数指定できる。複数指定では最大100件指定できる。

イベントIDの英大文字・英小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

一致する

一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

3

発行元プロセスID

B.PROCESSID

4

発行元ユーザーID

B.USERID

5

発行元グループID

B.GROUPID

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

6

発行元ユーザー名

B.USERNAME

7

発行元グループ名

B.GROUPNAME

8

発行元イベントサーバ名※1

B.SOURCESERVER

9

送信先イベントサーバ名※1

B.DESTSERVER

10

メッセージ

B.MESSAGE

11

重大度

E.SEVERITY

一致する

"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）の中から指定できる。

複数指定できる。ただし，重複した重大度は指定できない。

12

拡張属性※2

E.xxxxxxx

から始まる

一致する

一致しない

を含む

を含まない

正規表現

拡張属性名には，先頭が英大文字で英大文字，数字，およびアンダーバー（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

13

アクション種別

E.@JP1IM_ACTTYPE

一致する

一致しない

次の数値を指定できる。

0（アクション対象外）

1（コマンド）

2（ルール）

3（コマンド,ルール）

複数指定できる。

14

アクション抑止

E.@JP1IM_ACTCONTROL

次の数値を指定できる。

0（アクション対象外）

1（実行）

2（抑止）

3（一部抑止）

複数指定できる。

15

重要イベント

E.@JP1IM_SEVERE

次の数値を指定できる。

0（重要イベントではない）

1（重要イベント）

複数指定できる。

16

相関イベント

E.@JP1IM_CORRELATE

次の数値を指定できる。

0（相関イベントではない）

1（相関成立イベント）

2（相関不成立イベント）

複数指定できる。

17

応答待ちイベント

E.@JP1IM_RESPONSE

次の数値を指定できる。

0（応答待ちイベントではない）

1（応答待ちイベント）

複数指定できる。

18

重大度(変更前)

E.@JP1IM_ORIGINAL_SEVERITY

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

19

重大度変更

E.@JP1IM_CHANGE_SEVERITY

一致する

一致しない

次の数値を指定できる。

0（重大度変更なし）

1（重大度変更あり）

複数指定できる。

20

対処状況

E.@JP1IM_DEALT

次の数値を指定できる。

0（未対処）

1（対処済）

2（処理中）

3（保留）

複数指定できる。

21

重要イベント解除

E.@JP1IM_RELEASE

次の数値を指定できる。

0（重要イベントを解除していない）

1（重要イベントを解除している）

複数指定できる。

22

重要イベント削除

E.@JP1IM_DISMISSED

次の数値を指定できる。

0（重要イベントを削除していない）

1（重要イベントを削除している）

複数指定できる。

23

メモ

E.@JP1IM_MEMO

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。

複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

24

メッセージ(変更後)※3

E.@JP1IM_DISPLAY_MESSAGE

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。

複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

25

表示メッセージ変更※3

E.@JP1IM_CHANGE_MESSAGE

一致する

一致しない

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

26

表示メッセージ変更定義名※3

E.@JP1IM_CHANGE_MESSAGE_NAME

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。

複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

27

発生元ホスト名※2

E.JP1_SOURCEHOST

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。

複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

注※1

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

注※2

E.START_TIME（開始時刻），E.END_TIME（終了時刻）は指定できません。

注※3

10-50以前のJP1/IM - Managerからバージョンアップした場合に，jimdbupdateコマンドで統合監視DBのアップデートを実施していないときは，出力されません。

定義例

B.ID IN 1
B.MESSAGE SUBSTR 警告
B.SOURCESERVER IN host1 host2 host3 host4
OR
B.ID IN 1
B.MESSAGE SUBSTR エラー
B.SOURCESERVER IN host1 host2 host3 host4
EXCLUDE
B.SOURCESERVER IN host3

定義ファイルのステートメントの詳細

JP1/IMの定義ファイルに記述できるステートメントの種類，構造，および指定できる値を一覧で示します。

注

この節の説明は次の三つの定義ファイルだけに該当します。

イベント拡張属性定義ファイル

アプリケーション実行定義ファイル

統合機能メニュー定義ファイル

ステートメントの種類

表2‒85　ステートメントの種類

ステートメントの分類

ステートメントの種類

ファイル内ステートメント

ブロック開始ステートメント

ブロック終了ステートメント

ファイル属性ステートメント

プロダクトステートメント

ブロック内ステートメント

機能メニューコマンドオプション定義ステートメント

イベント属性定義ステートメント

ブロック属性定義ステートメント

機能メニュー実行定義識別子定義ステートメント

アプリケーション説明定義ステートメント

グループ定義ステートメント

機能メニュー表示アイコン定義ステートメント

アプリケーション実行定義識別子定義ステートメント

機能メニュー識別子定義ステートメント

機能メニュー表示名定義ステートメント

順序定義ステートメント

機能メニュー親識別子定義ステートメント

アプリケーションパス定義ステートメント

ステートメントの構造

表2‒86　ステートメントの構造

ステートメントの種類

記述形式

ブロック開始ステートメント

@define-block type=ブロック種別

ブロック終了ステートメント

@define-block-end

ファイル属性ステートメント

@file type=定義ファイルタイプ[, version=定義フォーマットバージョン]

プロダクトステートメント

@product name=プロダクト名

機能メニューコマンドオプション定義ステートメント

arguments=コマンド引数

イベント属性定義ステートメント

attr name=属性名, title=表示項目名[, type=属性表示タイプ]

ブロック属性定義ステートメント

block lang=言語種別|platform=プラットフォーム種別|version=適用バージョン

機能メニュー実行定義識別子定義ステートメント

execute_id=アプリケーション実行定義識別子

アプリケーション説明定義ステートメント

description=アプリケーション実行の説明文

グループ定義ステートメント

group name=グループ名, attrs=属性名並び

機能メニュー表示アイコン定義ステートメント

icon=表示アイコンファイル名

アプリケーション実行定義識別子定義ステートメント

id=アプリケーション実行定義識別子

機能メニュー識別子定義ステートメント

id=機能メニュー識別子

機能メニュー表示名定義ステートメント

name=表示名称

順序定義ステートメント

order id=イベントID定義文字列, attrs=属性名並び

機能メニュー親識別子定義ステートメント

parent_id=親機能メニュー識別子

アプリケーションパス定義ステートメント

path=コマンドパス

ステートメント内の構成要素の生成規則

ステートメント内の構成要素に指定できる値を次に示します。

表2‒87　ステートメント内の構成要素に指定できる値

構成要素

指定できる値

16進数値文字

0〜9およびA〜F

EUCJIS

EUCJIS

GB18030

GB18030

JIS

JIS

Shift-JIS

SJIS

UTF-8

UTF-8

アプリケーション実行の説明文

1〜50バイトのユーザー定義文字列

アプリケーション実行定義

application-execution-definition

アプリケーション実行定義ブロック

application-execution-def

アプリケーション実行定義識別子

1〜32バイトの半角英数字

イベントID

1〜8バイトの16進数値文字

イベントID定義文字列

イベントID|イベントID定義文字列 列挙セパレーター イベントID

イベントオブジェクトタイプ定義ブロック

event-object-def

イベント拡張属性定義

extended-attributes-definition

イベント属性グループ定義ブロック

event-attr-group-def

イベント属性定義ブロック

event-attr-def

イベント表示順序定義ブロック

event-attr-order-def

インターフェース名

1〜32バイトの半角英数字

グループ名

1〜32バイトの半角英数字

コマンドパス

ファイル名

コマンド引数

コマンド引数として意味のあるユーザー定義文字列

サブキー名

1〜32バイトの半角英数字

スラント

/

スラント区切り英数字列

スラント|英数字|スラント区切り英数字列 スラント

|スラント区切り英数字列 英数字

デフォルト

default

バージョン

1〜7バイトの半角英数字のバージョン文字列

バージョン記号文字

/|.|

バージョン範囲指定

バージョン 空白-空白 バージョン

バージョン文字

英大文字|数字|バージョン記号文字

ファイル記号文字

.|/|¥¥|-|_|~

ファイル名

ファイルパスとして意味のある文字列

ファイル名文字列

ファイル記号文字|英数字|ファイル名文字列 ファイル記号文字|ファイル名文字列 英数字

プラットフォーム種別

base|半角英数字列

プロダクト名

スラント区切り半角英数字列

ブロック種別

イベント属性定義ブロック|イベント属性グループ定義ブロック|イベント表示順序定義ブロック|アプリケーション実行定義ブロック

ユーザー定義文字

半角英数字|日本語文字|記号

英語

English

英字

小文字および大文字の半角英字

英小文字

a〜z

英数字

半角の英字および数字

英大文字

A〜Z

機能ツリーノード定義ブロック

function-tree-def

統合ツリーメニュー定義

function-definition

機能メニュー識別子

1〜32バイトの半角英数字

機能メニュー識別子列

[0〜9バイトの機能メニュー識別子 列挙セパレーター]

機能メニュー識別子

言語種別

日本語|英語

親機能メニュー識別子

機能メニュー識別子

数字

0〜9

説明

1〜50バイトのユーザー定義文字

属性値

1〜10,000バイトの文字

属性値タイプ

elapsed_time

属性表示タイプ

属性値タイプ/表示フォーマット

属性名

(B|).属性名文字列

属性名文字

半角英大文字|半角数字|_

属性名文字列

0〜31バイトの半角英大文字の属性名文字

属性名並び

属性名|属性名並び¥|属性名

定義ファイルタイプ

イベント拡張属性定義|アプリケーション実行定義|モニター画面呼び出し定義|統合機能メニュー定義

定義フォーマットバージョン

0300

適用バージョン

ALL|バージョン|バージョン範囲指定

日時表示フォーマット

date_format:表示タイムゾーン

日本語

Japanese

日本語文字

半角仮名を除く2バイト文字

日本語文字コード

Shift-JIS|EUCJIS|JIS|UTF-8

表示アイコンファイル名

ファイル名

表示タイムゾーン

CLIENT

表示フォーマット

日時表示フォーマット

表示項目文字

英数字|空白|-|_|日本語文字

表示項目文字列

0〜64バイトの表示項目文字列

表示項目名

表示項目文字列

表示名称

1〜32バイトのユーザー定義文字列

列挙セパレーター

¥|

3　JP1イベント

この章では，JP1/IMが出力するJP1イベントの種類とその属性について説明します。

3.1　JP1イベントの属性

JP1イベントの属性を説明します。JP1イベントの属性には基本属性と拡張属性があります。ここではそれぞれの属性の詳細を説明します。

3.1.1　基本属性

イベントの基本属性とは，すべてのJP1イベントが持っている属性です。ここでは，JP1イベントの基本属性の詳細を説明します。

JP1イベントの基本属性の詳細

なお，基本属性の属性名にはB.IDのように先頭に「B.」を付けて区別する場合があります。設定する際に「B.」を付ける必要がある場合は，マニュアル内でそのつど説明しています。

表3‒1　JP1イベントの基本属性

項目

属性名

内容

イベントDB内通し番号

SEQNO

発行元によらないでこのイベントサーバに到達した順番。

イベントID

ID

発行アプリケーションプログラムや事象の内容を表す8バイトの値。

拡張イベントID

IDEXT

イベントIDの拡張部分を表す8桁の16進数文字列。

種別

TYPE

イベントの種別。

登録要因

REASON

JP1イベントがこのイベントサーバに登録された要因。

発行元プロセスID

PROCESSID

発行元アプリケーションプログラムのプロセスID。

登録時刻

TIME

発行元イベントサーバでの登録時刻。

到着時刻

ARRIVEDTIME

自イベントサーバでの登録時刻。

発行元ユーザーID

USERID

発行元プロセスのユーザーID。Windowsからのイベントの場合は-1となる。

発行元グループID

GROUPID

発行元プロセスのグループID。Windowsからのイベントの場合は-1となる。

発行元ユーザー名

USERNAME

発行元プロセスのユーザー名。

発行元グループ名

GROUPNAME

発行元プロセスのグループ名。Windowsからのイベントの場合は空白となる。

発行元イベントサーバ名

SOURCESERVER

発行元のイベントサーバ名。イベントが，JP1/Base(エージェント)→JP1/IM - Manager（拠点マネージャー）→ JP1/IM - Manager（統合マネージャー）のように転送された場合でも，最初のJP1/Baseのイベントサーバ名が入る。

送信先イベントサーバ名

DESTSERVER

発行元APが他イベントサーバへの転送を明示して指定した場合に，他イベントサーバの名称が入る。

発行元IPアドレス

SOURCEIPADDR

発行元イベントサーバに対応するIPアドレス（NAT（ネットワークアドレス変換）やプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。

送信先IPアドレス

DESTIPADDR

送信先イベントサーバに対応するIPアドレス（NAT（ネットワークアドレス変換）やプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。

発行元イベントDB内通し番号

SOURCESEQNO

発行元ホストでのイベントDB内通し番号（転送によって値は変化しない）。

コードセット

CODESET

メッセージ・詳細情報・拡張属性が記述されている文字コードセット名。

メッセージ

MESSAGE

イベントの内容を表した文字列。

詳細情報

−

任意のデータ。

基本属性の詳細情報は，主にバージョン5以前のJP1/SES互換のイベントを発行する製品が，詳細情報を記録する場合などに使われます。

バージョン6以降の製品の多くは，JP1イベント拡張属性を使って詳細な情報を記録します。

（凡例）

−：なし

3.1.2　拡張属性

イベントの拡張属性とは，イベント発行元プログラムが任意に指定できる属性です。拡張属性には共通情報と固有情報があります。共通情報はJP1プログラムで統一されている情報です。固有情報は共通情報以外の拡張属性です。ここでは，共通情報の詳細を説明します。

共通情報の詳細

拡張属性の属性名にはE.SEVERITYのように先頭に「E.」を付けて区別する場合があります。設定する際に「E.」を付ける必要がある場合は，マニュアル内でそのつど説明しています。

共通情報の一覧を次の表に示します。

表3‒2　共通情報の一覧

項目

属性名

内容

重大度

SEVERITY

JP1イベントの緊急性を表す。緊急性の高い順に，次の値がある。

Emergency（緊急）

Alert（警戒）

Critical（致命的）

Error（エラー）

Warning（警告）

Notice（通知）

Information（情報）

Debug（デバッグ）

ユーザー名

USER_NAME

業務を実行しているユーザー名。

プロダクト名

PRODUCT_NAME

JP1イベントを発行したプログラム名。次に示すプログラム名などがある。

/HITACHI/JP1/AJS

/HITACHI/JP1/FTP

/HITACHI/JP1/NETMDM

/HITACHI/JP1/NPS

/HITACHI/JP1/NT_LOGTRAP

/HITACHI/JP1/PAM

/HITACHI/JP1/IM/SCOPE

オブジェクトタイプ

OBJECT_TYPE

イベント発行の契機となったオブジェクトの種類を表す名称。次に示す値などがある。

JOB，JOBNET，BATCHJOB，ACTION，LIST

オブジェクト名

OBJECT_NAME

イベント発行の契機となったオブジェクト（ジョブ，ジョブネットなど）の名称。

登録名タイプ

ROOT_OBJECT_TYPE

オブジェクトの種別。通常はオブジェクトタイプと同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの種別となる。値の範囲はオブジェクトタイプと同じ。

登録名

ROOT_OBJECT_NAME

ユーザーの操作時に実行を指示する単位になる名称。通常はオブジェクト名と同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの名称になる。

オブジェクトID

OBJECT_ID

オブジェクトID。

PRODUCT_NAMEとの組み合わせによってオブジェクトのインスタンスを統合システム内で一意に意識できる文字列（形式は他製品に依存する。この情報はJP1/IM - Viewの［統合機能メニュー］画面から各製品のモニターを呼び出すときに使用する）。

事象種別

OCCURRENCE

オブジェクト名に示したオブジェクトに対して起こった事象。次に示す事象種別などがある。

START（実行開始）

END（実行終了）

PAUSE（実行の一時停止）

RELEASE（一時停止の解除）

RESTART（再実行の開始）

CREATE（定義の作成）

DESTROY（定義の削除）

開始時刻

START_TIME

実行開始または再実行開始の時刻(UTC 1970-01-01 00:00:00からの秒数)。この項目は設定されない場合もある。

終了時刻

END_TIME

実行終了の時刻(UTC 1970-01-01 00:00:00からの秒数)。この項目は設定されない場合もある。

終了コード

RESULT_CODE

10進数文字列の終了コード。この項目は設定されない場合もある。

発生元ホスト名

JP1_SOURCEHOST

発生元となったホスト名。

3.2　JP1/IMが出力するJP1イベント

JP1/IMが出力するイベントについて説明します。

3.2.1　JP1/IMが出力するJP1イベント一覧

イベントID

発行契機

メッセージ

発行元機能

00002010

アクション遅延の監視中に，アクション実行時間が監視時間を超過した場合

KAVB4400-E イベント(EVENT_ID=イベントID, SEQNO=イベントDB内通し番号)に対するアクション(実行ホスト=アクション実行ホスト, アクション通し番号=アクション通し番号)の実行時間がアクション遅延監視時間を超過しました。以降アクション遅延監視への通知機能の抑止を解除するまで，遅延監視の通知を実行しません

アクション実行サービス

00002011

アクション状態の監視中に，アクション状態が「実行不可」または「実行失敗」になった場合

KAVB4402-E イベント(EVENT_ID=イベントID，SEQNO=イベントDB内通し番号)に対するアクション(実行ホスト=アクション実行ホスト，アクション通し番号=アクション通し番号)の状態が異常状態になりました。以降アクション状態監視への通知機能の抑止を解除するまで，状態監視の通知を実行しません

アクション実行サービス

00002012

ヘルスチェック機能が異常を検知した場合

KAVB8060-E 機能名 の異常を検知しました (ホスト名=ホスト名, プロセス名=プロセス名, プロセスID=プロセスID) ： 保守情報

イベントコンソールサービス

イベント基盤サービス

00002013※1

ヘルスチェック機能が異常を検知した場合

KAVB8062-E 機能名 の異常を検知しました (ホスト名=ホスト名, プロセス名=プロセス名) ： 保守情報

イベントコンソールサービス

00002014※2

ヘルスチェック機能が異常回復を検知した場合

KAVB8061-I 機能名 が回復しました (ホスト名=ホスト名, プロセス名=プロセス名, プロセスID=プロセスID) ：保守情報

イベントコンソールサービス

イベント基盤サービス

00002015

アクション遅延監視への通知抑止が解除された場合

KAVB4401-I アクション遅延監視への通知機能の抑止を解除しました。以降アクション遅延監視時間を超過したアクションが発生した場合，通知機能を実行します

アクション実行サービス

00002016

アクション状態監視への通知抑止が解除された場合

KAVB4403-I アクション状態監視への通知機能の抑止を解除しました。以降アクション状態監視時間を超過したアクションが発生した場合，通知機能を実行します

アクション実行サービス

00002020

アクション遅延の監視中に，遅延状態となったアクションがアクション情報ファイルからラップした場合

KAVB4404-E アクション(アクション通し番号=アクション通し番号)の実行時間がアクション遅延監視時間を超過しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション遅延通知イベントを発行できませんでした。以降アクション遅延監視への通知機能の抑止を解除するまで，遅延監視の通知を実行しません

アクション実行サービス

00002021

アクション状態の監視中に，異常状態となったアクションがアクション情報ファイルからラップした場合

KAVB4405-E アクションの状態が異常状態になりましたが，アクション情報ファイルにアクションの情報が存在しないためアクション異常状態通知イベントを発行できませんでした。以降アクション状態監視への通知機能の抑止を解除するまで，監視の通知を実行しません：保守情報

アクション実行サービス

000020A0

続行できない問題が発生したため，自動アクション処理が異常終了した場合

KAVB4054-E 自動アクション処理が異常終了しました (ホスト名 : ホスト名)

アクション実行サービス

000020A1

jco_start (.model)コマンドによって，自動アクションが起動した場合。デフォルトでは発行しない。

KAVB4050-I 自動アクション処理を開始します

アクション実行サービス

000020A2

jco_stop (.model)コマンドによって，自動アクションが停止した場合。デフォルトでは発行しない。

KAVB4051-I 自動アクション処理を終了します

アクション実行サービス

000020A3

jcachangeコマンドまたは画面からの操作によって，自動アクション機能が稼働状態になった場合

KAVB4055-I アクション定義ファイルを読み込み，自動アクション機能を稼働状態にしました。次に受信したイベントから，読み込んだ定義で処理されます (定義数：有効な定義数/ファイル内の全定義数，最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD hh:mm:ss), イベントDB内通し番号=最後に処理したイベントのイベントDB内通し番号)

イベント基盤サービス

000020A4

自動アクション機能が稼働状態から休止状態になった場合

KAVB4056-I 自動アクションを休止しました。次に受信したイベントから，自動アクションが実行されません (最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD hh:mm:ss), イベントDB内通し番号=最後に処理したイベントのイベントDB内通し番号)

イベント基盤サービス

000020A5

アクション実行サービスがロケール情報の設定に失敗した場合

KAVB4909-E ロケール情報の設定に失敗しました

アクション実行サービス

000020A6

イベント基盤サービスプロセスがロケール情報の設定に失敗した場合

KAVB4909-E ロケール情報の設定に失敗しました

イベント基盤サービス

000020E0

アクションの実行を開始した場合

KAVB4430-I イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行を要求しました

アクション実行サービス

000020E1

アクションが終了した場合

KAVB4431-I イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行が終了しました (終了コード=終了コード)

アクション実行サービス

000020E2

アクションが自動アクションまたはコマンド制御内部で異常状態になった場合

KAVB4432-E イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションが自動アクションまたはコマンド制御で異常終了しました

アクション実行サービス

000020E3※3

アクション状態通知イベントに対するアクションの実行要求を登録した場合

KAVB4433-I アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行を要求しました

アクション実行サービス

000020E4※3

アクション状態通知イベントに対するアクションが終了した場合

KAVB4434-I アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行が終了しました (終了コード=終了コード)

アクション実行サービス

000020E5※3

アクション状態通知イベントに対するアクションが自動アクションまたはコマンド制御内部で異常状態になった場合

KAVB4435-E アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションが自動アクションまたはコマンド制御内部で異常終了しました

アクション実行サービス

000020E6※3

jcocmddefコマンドで実行要求を通知する設定が有効になっている場合。アクション情報ファイルがラップしており，実行要求に対するアクション状態通知イベント（000020E0，000020E3）が発行できなかった場合に発行する（重大度：Warning）。

KAVB4436-W アクションの実行を要求しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません

アクション実行サービス

000020E7※3

jcocmddefコマンドで実行終了を通知する設定が有効になっている場合。アクション情報ファイルがラップしており，実行終了に対するアクション状態通知イベント（000020E1，000020E4）が発行できなかった場合に発行する（重大度：Warning）。

KAVB4437-W アクションの実行が終了しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません

アクション実行サービス

000020E8※3

jcocmddefコマンドで異常終了を通知する設定が有効になっている場合。アクション情報ファイルがラップしており，異常終了に対するアクション状態通知イベント（000020E2，000020E5）が発行できなかった場合に発行する（重大度：Error）。

KAVB4438-E アクションが自動アクションまたはコマンド制御において異常終了しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません

アクション実行サービス

00003F01※1

接続ホスト上のイベントバッファーに取得できるイベントがなく，イベントを表示できなかった場合

KAVB1513-W 表示できなかったイベントがあります。

表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，以下の検索条件を指定し検索してください。

（１） 検索ホスト名として，接続中のホスト名を指定する

（２） 登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する

このイベントが頻繁に表示される場合は，次の条件に該当していないか確認し，必要があれば設定値を見直してください。

（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い

（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい

（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい

イベントコンソールサービス

00003F02※1

取得しようとしたイベントが，既に接続ホストのイベントバッファーになく，［イベント監視］ページ，または［重要イベント］ページのどちらかにだけ，イベントを表示できなかった場合に，その該当ページに表示する。

［重要イベント］ページに表示する場合は，強制的に重要イベントとする。

KAVB1540-W 表示できなかったイベントがあります。(ページ:ページ)

表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，以下の検索条件を指定してください。

（１）検索ホスト名として，接続中のホスト名を指定する

（２）登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する

このイベントが頻繁に表示される場合は，以下の条件に該当していないか確認し，必要があれば設定値を見直してください。

（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い

（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい

（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい

イベントコンソールサービス

00003F03※1

イベントサービスからイベントを取得するときにエラーが発生した場合

KAVB1516-W イベントサービスからイベントを取得するときにエラーが発生しました。

システムプロファイルに指定された回数リトライしましたが，回復しません。このため，以降のイベントは表示されません。

イベントサービスが起動しているか確認してください。起動していない場合は，イベントサービス起動後，マネージャーを再起動して，回復してください

イベントコンソールサービス

00003F04※1

バージョン06-00のJP1/Baseのイベントサービスに対して，サポートしていない条件（「を含む」，「を含まない」，「正規表現」の指定，または対処状況の複数指定）でイベントを検索した場合

バージョン06-51のJP1/Baseのイベントサービスに対して，サポートしていない条件（「正規表現」の指定）でイベントを検索した場合

KAVB1527-E 検索ホストで受け付けられない条件が含まれています

イベントコンソールサービス

00003F05※1

イベント検索実行時，フィルター長がイベントサービスのフィルターの最大長を超える場合

KAVB0246-E フィルター条件の最大長（最大長）を超えて指定しています

イベントコンソールサービス

00003F06※1

イベント検索実行時，指定した正規表現が間違っている場合

KAVB0248-E 正規表現の指定が正しくありません

イベントコンソールサービス

00003F07※1

イベント基盤サービスとイベントサービス間で接続が切れた場合

KAVB4764-W イベントサービスからイベントを取得するときにエラーが発生しました。

イベントサービスが起動しているか確認してください。起動していない場合はイベントサービスを起動してください。

イベント基盤サービス

00003F08※1

除外条件を指定してイベント検索を実行した時，検索ホストのJP1/Baseのバージョンが08-11以前だった場合

KAVB0251-E 検索ホストのJP1/Baseが除外条件に対応していないため，指定された条件では検索できません

イベントコンソールサービス

00003F11

次に示す画面での操作，またはコマンドによってJP1イベントの対処状況が変更になった場合

［イベントコンソール］画面

［関連イベント一覧］画面

jcochstatコマンド

応答待ちイベントに応答し，応答待ちイベントが「対処済」になった場合

応答待ちイベントがBJEXまたはJP1/ASからキャンセルされ，応答待ちイベントが「対処済」になった場合

KAVB1577-I 対処状況の操作が行われました(操作ユーザー:JP1ユーザー,イベントID:イベントID,対処前状況:対処前状況,対処後状況:対処後状況)

イベントコンソールサービス

00003F13※4

［システム環境設定］画面，［イベント取得条件一覧］画面，またはjcochfilterコマンドによって，JP1/IM - Managerのイベント取得フィルター条件が変更されたことを通知する場合

KAVB4014-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(フィルター名：フィルター名 ，最後に受信したイベント：到着時刻=到着時刻，イベントDB内通し番号=イベントDB内通し番号)

イベント基盤サービス

相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントID

設定した相関イベント発行条件が相関イベント発行処理で成立した場合

相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたメッセージ

相関イベント発行機能

相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントID

設定した相関イベント発行条件が相関イベント発行処理で不成立になった場合

相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたメッセージ

相関イベント発行機能

00003F15

統合監視DBが有効な場合に，［重要イベント定義］画面からJP1/IM - Manager（セントラルコンソール）の重要イベント定義が変更された事を通知する場合に発行される。

KAVB1669-I 重要イベント定義ファイルを読み込みました。次に取得したイベントから読み込んだ定義で処理されます（最後に取得したイベント：到着時刻=最後に取得したイベントの到着時刻，イベントDB内通し番号=最後に取得したイベントのイベントDB内通し番号）。

イベント基盤サービス

00003F16※1

統合監視DBからイベントを取得するときにエラーが発生した場合

KAVB1671-W 統合監視DBからイベントを取得するときにエラーが発生しました。

システムプロファイルに指定された回数リトライしましたが，回復しません。

このため，以降のイベントは表示されません

イベントコンソールサービス

00003F17※4

JP1/IM - Viewから追加共通除外条件が登録されたことを通知する

KAVB1150-I 追加共通除外条件群を登録しました。(共通除外群ID:共通除外条件群ID, 共通除外群名:共通除外条件群名, 登録ユーザー:ユーザー名)

イベント基盤サービス

00003F20※4

［システム環境設定］画面，［イベント取得条件一覧］画面，またはjcochfilterコマンドによって，JP1/IM - Manager（相関イベント発行サービス）のイベント取得フィルター条件が変更されたことを通知する場合

KAJV2179-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（フィルター名:フィルター名，最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）

相関イベント発行サービス

00003F21

jcoegschangeコマンドによって，相関イベント発行定義が更新されたことを通知する場合

KAJV2242-I 相関イベント発行定義ファイル（ファイル名）を読み込み，相関イベント発行機能に反映しました

相関イベント発行サービス

00003F22

JP1/IM - Manager起動時にJP1/Baseで使用する正規表現の設定が拡張正規表現でない場合かつJP1/IM - Managerの共通除外条件群の動作モードが拡張モードに設定されている場合

KAVB4712-W JP1/Baseで使用する正規表現を拡張していないためイベント基盤サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

イベントコンソールサービス

00003F23

JP1/IM - Manager起動時にJP1/Baseで使用する正規表現の設定が拡張正規表現でない場合かつJP1/IM - Managerの共通除外条件群の動作モードが拡張モードに設定されている場合

KAJV2502-W JP1/Baseで使用する正規表現を拡張していないため相関イベント発行サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

イベント相関機能

00003F25

jcoegsstartコマンドによって，相関イベント発行処理を再開したことを通知する場合

KAJV2243-I 相関イベント発行機能を再開しました

相関イベント発行サービス

00003F26

jcoegsstopコマンドによって，相関イベント発行サービスを停止せずに相関イベント発行処理を停止したことを通知する場合

KAJV2234-I 相関イベント発行機能を停止しました

相関イベント発行サービス

00003F28

相関イベント発行サービスが発行処理しているJP1イベントの組数が上限値の20,000組に達した場合

KAJV2322-W 相関中のJP1イベントの組が上限(20000組)に達しているためJP1イベント（イベントID=イベントID，イベントDB内通し番号=イベントDB内通し番号）を相関できませんでした

相関イベント発行サービス

00003F31※4

JP1/IM - Viewから追加共通除外条件が登録されたことを通知する

KAJV2188-I 追加共通除外条件群を登録しました。(共通除外群ID:共通除外条件群ID, 共通除外群名:共通除外条件群名, 登録ユーザー:ユーザー名)

相関イベント発行サービス

00003F41

滞留できる上限を超えて応答待ちイベントが発生した場合

KAVB0551-E マネージャーで滞留している応答待ちイベントが上限2000件を超えました

イベントコンソールサービス

00003F42

応答待ちイベント滞留ファイルの応答待ちイベントデータの読み込みに失敗した場合

KAVB1816-W 表示できなかった応答待ちイベントがあります。

表示できなかった応答待ちイベントを確認するには，［イベント検索条件設定］画面を表示し，次の検索条件を指定してください。

（１）検索ホスト名として，接続中のホスト名を指定する。

（２）応答待ちイベントとして，対象を指定する。

（３）到着時刻として，このJP1イベントの前又は後に表示されているイベントの到着時刻を指定する。

イベントコンソールサービス

00003F51

統合監視DBからイベントが削除された場合

KAVB1841-I 削除対象始点日から削除対象終点日のイベントを統合監視DBから削除しました

統合監視DB

00003F52

保存出力していないイベントが削除警告位置を超えた場合

KAVB1842-W 保存出力していないイベントが削除警告位置（削除警告位置%）を超えました

保存出力機能

00003F53※1

統合監視DBへのイベント登録処理でエラーが発生した場合

KAVB1832-E 統合監視DBへのイベント登録処理でエラーが発生しました。統合監視DBへのイベント登録をリトライします（詳細情報：詳細情報）

イベント基盤サービス

00003F54

統合監視DBへのイベント登録処理で発生していたエラーが回復した場合

KAVB1833-I 統合監視DBへのイベント登録処理で発生していたエラーが回復しました。イベント基盤サービスはイベント取得を再開しています

イベント基盤サービス

00003F56※4

追加繰り返しイベント条件を登録（追加）した場合

KAVB4673-I 繰り返しイベント条件を登録しました。(繰り返しイベント条件名:繰り返しイベント条件名, 登録ユーザー:ユーザー名)

繰り返しイベントの監視抑止機能

00003F57※4

［繰り返しイベント条件一覧］画面の［適用］ボタンをクリックした場合

KAVB4674-I 繰り返しイベント条件を更新しました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F58

繰り返しイベントの監視抑止で抑止が開始した場合

KAVB4676-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を開始しました。(抑止を開始したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F59

繰り返しイベントの監視抑止で抑止が終了した場合

KAVB4677-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を終了しました。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F60

繰り返しイベントの監視抑止を打ち切った場合

KAVB4678-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を打ち切り，再度抑止を開始しました。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F61

重大度変更定義を反映した場合jco_spmd_reloadを実行した場合

KAVB4600-I 重大度変更定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）

イベント基盤サービス

00003F63

発生元ホストマッピング定義を反映した場合

jco_spmd_reloadを実行した場合

KAVB4650-I 発生元ホストマッピング定義ファイルを読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

発生元ホストマッピング機能

00003F64

業務グループを反映した場合

KAVB8453-I 業務グループを反映しました。次に受信したイベントから処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

業務グループの参照・操作制限

00003F65

繰り返しイベントの監視の抑止が継続していると見なされた場合

KAVB4679-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止が継続しています。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F68

業務グループを反映した場合

KAVB8454-W 業務グループを反映できませんでした。(要因:要因)

業務グループの参照・操作制限

00003F69

業務グループを反映した場合

KAVB8456-E 業務グループを反映できませんでした。(要因:要因)

業務グループの参照・操作制限

00003F6A

表示メッセージ変更定義を反映した場合

jco_spmd_reloadコマンドを実行した場合

KAVB4623-I 表示メッセージ変更定義ファイルを読み込みました。次に受信したイベントから，読み込んだ定義に従って処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

表示メッセージ変更機能

00003F71

追加重大度変更定義を登録した場合

KAVB4802-I 重大度変更定義を登録しました。(重大度変更定義名:重大度変更定義名, 登録ユーザー:ユーザー名)

イベントの重大度変更機能

00003F76

追加表示メッセージ変更定義を登録した場合

KAVB4803-I 表示メッセージ変更定義を登録しました。(表示メッセージ変更定義名:表示メッセージ変更定義名, 登録ユーザー:ユーザー名)

表示メッセージ変更機能

00003F77

イベント拡張属性定義ファイルをリロードした場合

KAVB5800-I イベント拡張属性定義ファイルをJP1/IM - Managerに読み込みました

固有の拡張属性表示・指定機能

00003F78

イベント拡張属性定義ファイルのリロードをしたが，一部の定義ファイルのリロードに失敗した場合

KAVB5804-E イベント拡張属性定義ファイルを読み込もうとしましたが，一部のイベント拡張属性定義ファイルの読み込みに失敗しました

固有の拡張属性表示・指定機能

00003F7C

モニター画面呼び出し定義ファイルをリロードした場合

KAVB1981-I モニター画面呼び出し定義ファイルをJP1/IM - Managerに反映しました

連携製品のモニター起動

00003FA0※5

コマンド実行制御が［コマンド実行］画面からコマンド実行要求を受け取った場合

KAVB2100-I [ホスト名 : JP1ユーザー名] コマンド実行を開始しました。

JP1/Baseのコマンド実行

00003FA1※5

［コマンド実行］画面から実行要求されたコマンドが実行完了した場合

KAVB2101-I [ホスト名 : JP1ユーザー名] コマンド実行が終了しました。

JP1/Baseのコマンド実行

00003FA2※5

［コマンド実行］画面から実行要求されたコマンドが，何らかの原因で実行されなかった場合

KAVB2102-E [ホスト名 : JP1ユーザー名] コマンド実行が異常終了しました。

JP1/Baseのコマンド実行

00003FA3※5

jcocmddefコマンドで経過時間イベント発行間隔を指定している場合。

［コマンド実行］画面および自動アクションから実行要求されたコマンドが，経過時間イベント発行間隔を超えて実行している場合。

KAVB2402-W [ホスト名] コマンド実行の実行時間が数値秒を超えました

JP1/Baseのコマンド実行

00003FA5※5

jcocmddefコマンドでコマンド先行入力数のしきい値が設定されている場合。自動アクションの先行入力数がしきい値に達した場合。

KAVB2071-W 実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が閾値[xx件]を超えました。

JP1/Baseのコマンド実行

00003FA6※5

jcocmddefコマンドでコマンド先行入力数のしきい値が設定されている場合。自動アクションの先行入力数が0になった場合。

KAVB2072-I実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が0件になりました。

JP1/Baseのコマンド実行

00003FB0

監視ノードの状態が変更された場合

KAVB7900-I 監視ノード名の状態が状態から状態に変わりました。

セントラルスコープサービス

00003FB1

監視ノードの状態変更イベントが表示数の上限に達した場合

KAVB7901-W 監視ノード（監視ノードID）の状態変更イベントの件数が上限を超えました

セントラルスコープサービス

00003FC0

リモート監視のログファイルトラップがログファイルの監視を開始できない場合

KNAN26102-E リモートログファイルトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FC1

リモート監視のログファイルトラップの読み込みリトライ回数がしきい値をオーバーし，該当ログファイルの監視を停止した場合

KNAN26094-E 指定された回数リトライ処理を行いましたが，該当ログファイルの読み込みが出来ないため監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名, 監視名:監視名, ログファイル名:ログファイル名)

リモート監視機能

00003FC2

リモート監視のログファイルトラップのログファイルの状態が異常となった場合

KNAN26095-E 該当ログファイルを正しく監視することが出来ない状態になりました。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名, 監視名:監視名, ログファイル名:ログファイル名)

リモート監視機能

00003FC3

リモート監視のログファイルトラップが異常終了した場合

KNAN26057-E 続行できないエラーが発生したため，リモートログファイルトラップを停止します。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FC5

リモート監視のログファイルトラップで収集したログファイルの差分データが，ログの取得上限を超えている場合

KNAN26140-W リモートログファイルトラップにおいて，監視対象のログファイルから収集したデータのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，ログファイル名: ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)

リモート監視機能

00003FC6

リモート監視が稼働中の監視対象ホストに対して，ホスト情報収集を実行した結果，リモート監視ログファイルトラップが停止する場合

KNAN26351-E 監視対象ホスト監視対象ホスト名のすべてのリモートログファイルトラップを停止します。(要因: 要因)

リモート監視機能

00003FC7

リネームされたログファイル（退避ファイル）が見つからない（SEQ2形式で監視対象ホストがUNIXの場合だけ）

KNAN26350-W 監視対象のログファイルの退避ファイルが見つかりません。前回収集日時から今回収集日時までに退避ファイルに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，監視対象ログファイル名: 監視対象ログファイル名，前回収集日時: yyyy/MM/dd hh:mm:ss，今回収集日時: yyyy/MM/dd hh:mm:ss，ユーザー: ユーザー，実行したコマンドライン: 実行したコマンドライン)

リモート監視機能

00003FC8

リネームされたログファイル（退避ファイル）が見つからない（SEQ2形式で監視対象ホストがWindowsの場合だけ）

KNAN26352-W 監視対象のログファイルの退避ファイルが見つかりません。前回収集日時から今回収集日時までに退避ファイルに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，監視対象ログファイル名: 監視対象ログファイル名，前回収集日時: yyyy/MM/dd hh:mm:ss，今回収集日時: yyyy/MM/dd hh:mm:ss，ユーザー: ユーザー)

リモート監視機能

00003FC9

リモート監視が稼働中の監視対象ホストに対して，ホスト情報収集を実行した結果，リモート監視イベントログトラップが停止する場合

KNAN26353-E 監視対象ホスト監視対象ホスト名のリモートイベントログトラップを停止します。(要因: 要因)

リモート監視機能

00003FD0

リモート監視のイベントログトラップがWindowsイベントの監視を開始できない場合

KNAN26107-E リモートイベントログトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FD1

リモート監視のイベントログトラップの読み込みリトライ回数がしきい値をオーバーし，該当Windowsイベントの監視を停止した場合

KNAN26028-E 指定された回数リトライ処理を行いましたが，イベントログの読み込みが出来ないためリモート監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)

リモート監視機能

00003FD2

イベントログの収集をリトライした場合

KNAN26027-I イベントログの読み込みをリトライします。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FD3

リモート監視のイベントログトラップが異常終了した場合

KNAN26002-E 続行できないエラーが発生したため，リモートイベントログトラップを停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)

リモート監視機能

00003FD4

イベントログの収集リトライにより，イベントログの収集に成功した場合

KNAN26026-I イベントログの監視が可能になりました。(監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FD5

リモート監視のイベントログトラップで収集したイベントログの差分データが，ログの取得上限を超えている場合

KNAN26142-W リモートイベントログトラップにおいて，監視対象ホストから収集したイベントログのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているイベントログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)

リモート監視機能

00003FD6

リモート監視ログファイルトラップでリモート監視状態保持ファイルの書き込みに失敗した場合

KNAN26339-W ログ収集時にリモートログファイルトラップの状態の保存に失敗しました。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FD7

リモート監視イベントログトラップでリモート監視状態保持ファイルの書き込みに失敗した場合

KNAN26340-W ログ収集時にリモートイベントログトラップの状態の保存に失敗しました。(監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FD8

リモート監視ログファイルトラップでリモート監視状態保持ファイルの読み込みに失敗した場合

KNAN26341-W 前回停止時のリモートログファイルトラップの状態を復元することができませんでした。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FD9

リモート監視イベントログトラップでリモート監視状態保持ファイルの読み込みに失敗した場合

KNAN26342-W 前回停止時のリモートイベントログトラップの状態を復元することができませんでした。(監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FDA

リモート監視ログファイルトラップで監視対象のログが変更されたことによって，リモート監視の起動（warmスタート）でリモート監視の停止中に出力されたログを収集できなかった場合

KNAN26343-W 前回停止時のリモートログファイルトラップの状態を復元して監視できない状態のため，前回停止時のリモートログファイルトラップの状態を復元しませんでした。(詳細情報: 詳細情報，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FDB

リモート監視ログファイルトラップでリモート監視状態保持ファイルの書き込みの失敗から回復した場合

KNAN26345-I ログ収集時に発生していたリモートログファイルトラップの状態の保存のエラーが回復しました。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FDC

リモート監視イベントログトラップでリモート監視状態保持ファイルの書き込みの失敗から回復した場合

KNAN26346-I ログ収集時に発生していたリモートイベントログトラップの状態の保存のエラーが回復しました。(監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

ACTDEFパラメーターに指定されている値※6

APのログファイルのレコードを検知した場合

ログファイルの1行分のデータの内容

リモート監視機能

00003A71またはリモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細※7

Windowsイベントのログメッセージを検知した場合

イベントログのメッセージ

リモート監視機能

00003F90※8

プロセスが異常終了した場合

KAVB3737-E コンポーネント名 の管理対象プロセス名は異常終了しました

JP1/IM - Managerのプロセス管理

00003F91※8

プロセス起動時にタイムアウトした場合

KAVB3613-W コンポーネント名 の管理対象プロセス名の起動がタイムアウトしました. 処理を継続します

JP1/IM - Managerのプロセス管理

00003F92※8

異常終了したプロセスが再起動完了した場合

KAVB3616-I コンポーネント名 の管理対象プロセス名の再起動が完了しました

JP1/IM - Managerのプロセス管理

00006400※9

表示メッセージ変更後のイベントを発行した場合

表示メッセージ変更機能によりメッセージ変更した場合，変更後のメッセージを設定する。

メッセージを変更していない場合，オリジナルイベントのメッセージテキストを設定する。

表示メッセージ変更後のイベントを発行する

注※1　これらのイベントはダミーイベントです。次の制限事項があります。

［イベントコンソール］画面のイベント検索で検索できません。

［統合オペレーション・ビューアー］画面では表示できません。

イベント検索REST APIでは検索できません。

イベントの詳細を表示した場合，JP1イベントの基本属性および拡張属性は表示されません。

このイベントに自動アクションを設定しても，アクションは実行されません。

このイベントにイベント情報マッピングを定義しても，マッピングされません。

このイベントは，モニター起動の対象外です。

このイベントは，イベント取得フィルターのフィルター対象外です。

このイベントは，相関イベントの発行処理の対象外です。

このイベントは，イベントDBに登録されません。そのため，JP1/IM - Managerを再起動すると［イベントコンソール］画面に表示されなくなります。

このイベントの対処状況を変更しても，ほかのJP1/IM - Viewに反映されません。

注※2　JP1/Baseのイベントサービス（jevservice）の回復を検知した場合のメッセージは，KAVB8063-Iです。

注※3　これらのイベントには，次の制限事項があります。

このイベントに自動アクションを設定しても，アクションは実行されません。

注※4　これらのイベントには，次の制限事項があります。

このイベントは，イベント取得フィルターのフィルター対象外です。

注※5　JP1/Baseのコマンド実行が発行するJP1イベントです。JP1イベントの詳細については，マニュアル「JP1/Base 運用ガイド」のJP1イベントを説明している章を参照してください。

注※6　リモート監視機能ではなく，JP1/Baseのログファイルトラップが発行するJP1イベントについては，マニュアル「JP1/Base 運用ガイド」のJP1イベントを説明している章を参照してください。

注※7　リモート監視機能ではなく，JP1/Baseのイベントログトラップが発行するJP1イベントについては，マニュアル「JP1/Base 運用ガイド」のJP1イベントを説明している章を参照してください。

注※8　プロセスの異常時にJP1イベントを発行させる設定をした場合にだけ発行されます。JP1イベントを発行させたい場合は，IMパラメーター定義ファイルを編集したあと，jbssetcnfコマンドを実行してください。定義ファイルの詳細については「IMパラメーター定義ファイル（jp1co_param_V7.conf）」（2.　定義ファイル）を，設定手順についてはマニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「1.18.3　JP1/IM - Managerの障害に備えた設定（Windowsの場合）」，「2.17.5　JP1/IM - Managerの障害に備えた設定（UNIXの場合）」を参照してください。

注※9　「オリジナルイベント」とは，JP1/IM - ManagerがJP1/Baseから取得したイベントを指します。

3.2.2　JP1イベントの詳細

JP1イベントの詳細について説明します。

(1)　イベントID：00002010の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4400-E イベント(EVENT_ID=イベントID，SEQNO=イベントDB内通し番号)に対するアクション(実行ホスト=アクション実行ホスト，アクション通し番号=アクション通し番号)の実行時間がアクション遅延監視時間を超過しました。以降アクション遅延監視への通知機能の抑止を解除するまで，遅延監視の通知を実行しません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル

EXECENV

実行時に使用する環境変数ファイル名

アクション通し番号

ACTION_SEQNO

アクション通し番号

アクション契機イベントID

SRC_EVENT_ID

アクションの契機となったイベントのイベントID

投入時刻

SEND_TIME

アクションの実行要求を送信した時刻

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(2)　イベントID：00002011の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4402-E イベント(EVENT_ID=イベントID，SEQNO=イベントDB内通し番号)に対するアクション(実行ホスト=アクション実行ホスト，アクション通し番号=アクション通し番号)の状態が異常状態になりました。以降アクション状態監視への通知機能の抑止を解除するまで，状態監視の通知を実行しません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル

EXECENV

実行時に使用する環境変数ファイル名

アクション通し番号

ACTION_SEQNO

アクション通し番号

アクション契機イベントID

SRC_EVENT_ID

アクションの契機となったイベントのイベントID

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(3)　イベントID：00002012の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8060-E 機能名 の異常を検知しました(ホスト名=ホスト名，プロセス名=プロセス名，プロセスID=プロセスID)：保守情報

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/HEALTHCHECK

オブジェクトタイプ

OBJECT_TYPE

JCOHC

オブジェクト名

OBJECT_NAME

異常が検知された機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

プロセスID

PROCESS_ID

プロセスID

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(4)　イベントID：00002013の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8062-E 機能名 の異常を検知しました(ホスト名=ホスト名，プロセス名=プロセス名)：保守情報

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/HEALTHCHECK

オブジェクトタイプ

OBJECT_TYPE

JCOHC

オブジェクト名

OBJECT_NAME

異常が検知された機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

プロセスID

PROCESS_ID

プロセスID

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(5)　イベントID：00002014の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8061-I 機能名 が回復しました(ホスト名=ホスト名，プロセス名=プロセス名，プロセスID=プロセスID)：保守情報※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/HEALTHCHECK

オブジェクトタイプ

OBJECT_TYPE

JCOHC

オブジェクト名

OBJECT_NAME

回復された機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

プロセスID

PROCESS_ID

プロセスID

（凡例）

−：なし

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　JP1/Baseのイベントサービス（jevservice）の回復を検知した場合のメッセージは，KAVB8063-Iです。

(6)　イベントID：00002015の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4401-I アクション遅延監視への通知機能の抑止を解除しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(7)　イベントID：00002016の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4403-I アクション状態監視への通知機能の抑止を解除しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(8)　イベントID：00002020の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4404-E アクション(アクション通し番号=アクション通し番号)の実行時間がアクション遅延監視時間を超過しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション遅延通知イベントを発行できませんでした。以降アクション遅延監視への通知機能の抑止を解除するまで，遅延監視の通知を実行しません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

NOTICE

固有情報

アクション通し番号

ACTION_SEQNO

アクション通し番号

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(9)　イベントID：00002021の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4405-E アクションの状態が異常状態になりましたが，アクション情報ファイルにアクションの情報が存在しないためアクション異常状態通知イベントを発行できませんでした。以降アクション状態監視への通知機能の抑止を解除するまで，状態監視の通知を実行しません：保守情報

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション通し番号

アクション状態

ACTION_STATUS

アクションの状態

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(10)　イベントID：000020A0の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4054-E 自動アクション処理が異常終了しました (ホスト名 : ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

TERMINATE

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(11)　イベントID：000020A1の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが起動した論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4050-I 自動アクション処理を開始します

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

START

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(12)　イベントID：000020A2の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作していた論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4051-I 自動アクション処理を終了します

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

TERMINATE

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(13)　イベントID：000020A3の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4055-I アクション定義ファイルを読み込み，自動アクション機能を稼働状態にしました。次に受信したイベントから，読み込んだ定義で処理されます (定義数：有効な定義数/全定義数，最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD hh:mm:ss), イベントDB内通し番号=最後に処理したイベントのイベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　自動アクションがイベントを受信していない場合は，「YYYY/MM/DD hh:mm:ss」および「最後に処理したイベントのイベントDB内通し番号」には「--」が表示されます。

(14)　イベントID：000020A4の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4056-I 自動アクションを休止しました。次に受信したイベントから，自動アクションが実行されません (最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD hh:mm:ss), イベントDB内通し番号=最後に処理したイベントのイベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

STANDBY

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　自動アクションがイベントを受信していない場合は，「YYYY/MM/DD hh:mm:ss」および「最後に処理したイベントのイベントDB内通し番号」には「--」が表示されます。

(15)　イベントID：000020A5の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

問題のあった自動アクションプロセスが動作していた論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4909-E ロケール情報の設定に失敗しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

ERROR

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(16)　イベントID：000020A6の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

イベント基盤サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

問題のあったイベント基盤サービスプロセスが動作していた論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4909-E ロケール情報の設定に失敗しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

ERROR

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(17)　イベントID：000020E0の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4430-I イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行を要求しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

開始時刻

START_TIME

アクションの実行要求が完了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(18)　イベントID：000020E1の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4431-I イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行が終了しました (終了コード=終了コード)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションの実行要求が完了した時刻

終了コード

RESULT_CODE

アクションの終了コード

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(19)　イベントID：000020E2の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4432-E イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションが自動アクションまたはコマンド制御で異常終了しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」または「FAIL」

異常終了詳細情報

ERROR_INFO

異常の内容を示すメッセージ

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

エラー要因

EXECERR

異常時の保守情報

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(20)　イベントID：000020E3の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4433-I アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行を要求しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

開始時刻

START_TIME

アクションの実行要求が完了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(21)　イベントID：000020E4の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4434-I アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行が終了しました (終了コード=終了コード)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションの実行要求が完了した時刻

終了コード

RESULT_CODE

アクションの終了コード

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(22)　イベントID：000020E5の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4435-E アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションが自動アクションまたはコマンド制御内部において異常終了しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」または「FAIL」

異常終了詳細情報

ERROR_INFO

異常の内容を示すメッセージ

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

エラー要因

EXECERR

異常時の保守情報

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(23)　イベントID：000020E6の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4436-W アクションの実行を要求しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません:保守情報

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

開始時刻

START_TIME

アクションの実行要求が完了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(24)　イベントID：000020E7の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4437-W アクションの実行が終了しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません:保守情報

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

終了時刻

END_TIME

アクションが実行終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

実行コマンド

EXECCMD

実行要求したコマンド

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(25)　イベントID：000020E8の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4438-E アクションが自動アクションまたはコマンド制御において異常終了しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません：保守情報

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」または「FAIL」

異常終了詳細情報

ERROR_INFO

異常の内容を示すメッセージ

実行コマンド

EXECCMD

実行要求したコマンド

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(26)　イベントID：00003F01の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

取得できるイベントの到着時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1513-W 表示できなかったイベントがあります。

表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，次の検索条件を指定し検索してください。

（１） 検索ホスト名として，接続中のホスト名を指定する

（２） 登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する

このイベントが頻繁に表示される場合は，次の条件に該当していないか確認し，必要があれば設定値を見直してください。

（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い

（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい

（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

EVENT

オブジェクト名

OBJECT_NAME

¥SYSTEM¥ALL

事象種別

OCCURRENCE

LOST

(27)　イベントID：00003F02の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

取得できるイベントの到着時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1540-W 表示できなかったイベントがあります。(ページ:ページ)

表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，以下の検索条件を指定してください。

（１）検索ホスト名として，接続中のホスト名を指定する

（２）登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する

このイベントが頻繁に表示される場合は，以下の条件に該当していないか確認し，必要があれば設定値を見直してください。

（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い

（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい

（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

EVENT

オブジェクト名

OBJECT_NAME

¥SYSTEM¥ALL

事象種別

OCCURRENCE

LOST

(28)　イベントID：00003F03の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1516-W イベントサービスからイベントを取得するときにエラーが発生しました。

システムプロファイルに指定された回数リトライしましたが，回復しません。このため，以降のイベントは表示されません。

イベントサービスが起動しているか確認してください。起動していない場合は，イベントサービス起動後，マネージャーを再起動して，回復してください

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

DISCONNECT

(29)　イベントID：00003F04の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1527-E 検索ホストで受け付けられない条件が含まれています

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

PARAM_ERROR

(30)　イベントID：00003F05の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB0246-E フィルター条件の最大長（最大長）を超えて指定しています

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

OVER_LENGTH

(31)　イベントID：00003F06の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB0248-E 正規表現の指定が正しくありません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービスまたはIMデータベース

事象種別

OCCURRENCE

REGEXP_ERROR

(32)　イベントID：00003F07の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

メッセージ

MESSAGE

KAVB4764-W イベントサービスからイベントを取得するときにエラーが発生しました。

イベントサービスが起動しているか確認してください。起動していない場合はイベントサービスを起動してください。

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

DISCONNECT

(33)　イベントID：00003F08の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB0251-E 検索ホストのJP1/Baseが除外条件に対応していないため，指定された条件では検索できません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

EXCLUDE_ERROR

(34)　イベントID：00003F11の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

発生時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1577-I 対処状況の操作が行われました(操作ユーザー:JP1ユーザー※2,イベントID:イベントID,対処前状況:対処前状況※3,対処後状況:対処後状況※3)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

PROCESS

固有情報

対処イベントのイベントDB内通し番号

PROCESSUPDATE_SEQNO

イベントDB内通し番号（対処状況を変更したJP1イベントのイベントDB内通し番号：10進数）

対処イベントの発行元イベントDB内通し番号

PROCESSUPDATE_ORIGINALSEQNO

発行元イベントDB内通し番号（対処状況を変更したJP1イベントの発行元イベントDB内通し番号：10進数）

対処イベントの重大度

PROCESSUPDATE_SEVERITY

重大度（対処状況を変更したJP1イベント重大度：Emergency，Alert，Critical，Error，Warning，Notice，Information，Debugのどれか）

対処イベントの発行元イベントサーバ名

PROCESSUPDATE_SOURCESERVER

発行元イベントサーバ名（対処状況を変更したJP1イベントが発行されたイベントサーバ名）

対処イベントのメッセージ

PROCESSUPDATE_MESSAGE

メッセージ（対処状況を変更したJP1イベントのメッセージ）

対処イベントの登録時刻

PROCESSUPDATE_TIME

登録時刻（対処状況を変更したJP1イベントの登録時刻：MM/DD hh:mm:ssの形式でイベント詳細画面へ表示）

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　JP1ユーザーは，状況に応じて次のように表示が変わります。

07-51以降のJP1/IM - Viewから対処状況を変更した場合：対処状況を変更したJP1ユーザー

07-50以前のJP1/IM - Viewから対処状況を変更した場合：-

jcochstatコマンドによって対処状況を変更した場合：jcochstat

応答待ちイベントに応答したことで対処状況が変更された場合：system

応答待ちイベントがキャンセルされたことで対処状況が変更された場合：system

注※3　対処前状況，対処後状況は，対処操作によって，次のように表示が変わります。

対処済：PROCESSED

未対処：UNPROCESSED

処理中：PROCESSING

保留：HELD

対処済→削除：PROCESSED+DELETE

未対処→削除：UNPROCESSED+DELETE

処理中→削除：PROCESSING+DELETE

保留→削除：HELD+DELETE

(35)　イベントID：00003F13の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

発生時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4014-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(フィルター名：フィルター名 ，最後に受信したイベント：到着時刻=到着時刻，イベントDB内通し番号=イベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(36)　相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントIDの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

IDBASE

ユーザーが定義したイベントID

（0〜1FFFおよび7FFF8000〜7FFFFFFFで任意に設定可能）

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

ユーザーが定義したメッセージ

拡張属性

共通情報

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/GENERATE_EVENT

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

SUCCESS

固有情報

関連イベントDB内通し番号

JP1_GENERATE_SOURCE_SEQNO

関連イベントのイベントDB内通し番号を半角スペース（△）で区切って，次のように設定する。

イベントDB内通し番号1△イベントDB内通し番号2△...△イベントDB内通し番号n（nは１〜100の値）

相関イベント発行条件名

JP1_GENERATE_NAME

成立した相関イベント発行条件名

注　相関イベントの属性には，この表に記載されていない属性も定義できます。詳細については，「相関イベント発行定義ファイル」（2.　定義ファイル）を参照してください。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(37)　相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントIDの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

IDBASE

ユーザーが定義したイベントID

（0〜1FFFおよび7FFF8000〜7FFFFFFFで任意に設定可能）

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

拡張属性

共通情報

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/GENERATE_EVENT

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

FAIL

固有情報

関連イベントDB内通し番号

JP1_GENERATE_SOURCE_SEQNO

関連イベントのイベントDB内通し番号を半角スペース（△）で区切って，次のように設定する。

イベントDB内通し番号1△イベントDB内通し番号2△...△イベントDB内通し番号n（nは１〜100の値）

相関イベント発行条件名

JP1_GENERATE_NAME

不成立になった相関イベント発行条件名

注　相関イベントの属性には，この表に記載されていない属性も定義できます。詳細については，「相関イベント発行定義ファイル」（2.　定義ファイル）を参照してください。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(38)　イベントID：00003F15の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

3F15

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※1

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※1

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1669-I 重要イベント定義ファイルを読み込みました。次に取得したイベントから読み込んだ定義で処理されます（最後に取得したイベント：到着時刻=最後に取得したイベントの到着時刻，イベントDB内通し番号=最後に取得したイベントのイベントDB内通し番号）※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　イベント基盤サービスがイベントを受信していない場合は，「最後に取得したイベントの到着時刻」および「最後に取得したイベントのイベントDB内通し番号」には「--」が表示されます。

(39)　イベントID：00003F16の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1671-W 統合監視DBからイベントを取得するときにエラーが発生しました。

システムプロファイルに指定された回数リトライしましたが，回復しません。

このため，以降のイベントは表示されません

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IM Database

事象種別

OCCURRENCE

DISCONNECT

(40)　イベントID：00003F17の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1150-I 追加共通除外条件群を登録しました。(共通除外群ID:共通除外条件群ID, 共通除外群名:共通除外条件群名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(41)　イベントID：00003F20の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2179-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（フィルター名:フィルター名，最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(42)　イベントID：00003F21の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2242-I 相関イベント発行定義ファイル（ファイル名）を読み込み，相関イベント発行機能に反映しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(43)　イベントID：00003F22の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4712-W JP1/Baseで使用する正規表現を拡張していないためイベント基盤サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

Notice

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(44)　イベントID：00003F23の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2502-W JP1/Baseで使用する正規表現を拡張していないため相関イベント発行サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

Notice

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(45)　イベントID：00003F25の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2243-I 相関イベント発行機能を再開しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

START

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(46)　イベントID：00003F26の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2234-I 相関イベント発行機能を停止しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

STOP

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(47)　イベントID：00003F28の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2322-W 相関中のJP1イベントの組が上限(20000組)に達しているためJP1イベント（イベントID=イベントID，イベントDB内通し番号=イベントDB内通し番号）を相関できませんでした

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

RUN

注　00003F28は，JP1イベントの組数が上限に達した時点で1度出力されます。そのあと，JP1イベントの組数が16,000組以下になるまでは，組数が上限に達しても出力されません。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(48)　イベントID：00003F31の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2188-I 追加共通除外条件群を登録しました。(共通除外群ID:共通除外条件群ID, 共通除外群名:共通除外条件群名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(49)　イベントID：00003F41の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

発生時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB0551-E マネージャーで滞留している応答待ちイベントが上限2000件を超えました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

NOTICE

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(50)　イベントID：00003F42の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

発生時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1816-W 表示できなかった応答待ちイベントがあります。

表示できなかった応答待ちイベントを確認するには，［イベント検索条件設定］画面を表示し，次の検索条件を指定してください。

（１） 検索ホスト名として，接続中のホスト名を指定する。

（２） 応答待ちイベントとして，対象を指定する。

（３） 到着時刻として，このJP1イベントの前又は後に表示されているイベントの到着時刻を指定する。

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

PROCESS

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(51)　イベントID：00003F51の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F51

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1841-I 削除対象始点日から削除対象終点日のイベントを統合監視DBから削除しました※2

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

削除対象始点日

DEL_STARTDAY

削除対象始点日の通算秒（MM/DD hh:mm:ssの形式でイベント詳細画面へ表示する）

削除対象終点日

DEL_ENDDAY

削除対象終点日の通算秒（MM/DD hh:mm:ssの形式でイベント詳細画面へ表示する）

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB1841-Iメッセージの削除対象始点日，削除対象終点日は，YYYY/MM/DD hh:mm:ss形式で置き換えます。

(52)　イベントID：00003F52の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F52

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1842-W 保存出力していないイベントが削除警告位置（削除警告位置%）を超えました

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(53)　イベントID：00003F53の詳細

属性種別

項目

属性名

内容

基本属性

登録ホスト名

SOURCESERVER

イベントが発行されたイベントサーバ名

メッセージ

MESSAGE

KAVB1832-E 統合監視DBへのイベント登録処理でエラーが発生しました。統合監視DBへのイベント登録をリトライします（詳細情報：詳細情報）

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

(54)　イベントID：00003F54の詳細

属性種別

項目

属性名

内容

基本属性

登録ホスト名

SOURCESERVER

イベントが発行されたイベントサーバ名

メッセージ

MESSAGE

KAVB1833-I 統合監視DBへのイベント登録処理で発生していたエラーが回復しました。イベント基盤サービスはイベント取得を再開しています

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

(55)　イベントID：00003F56の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F56

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4673-I 繰り返しイベント条件を登録しました。(繰り返しイベント条件名:繰り返しイベント条件名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(56)　イベントID：00003F57の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F57

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4674-I 繰り返しイベント条件を更新しました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(57)　イベントID：00003F58の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F58

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4676-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を開始しました。(抑止を開始したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

同一属性値情報1

SAMEATTR1

同一属性値条件に指定した一番目（リストのいちばん上）の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が指定されていない場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報2

SAMEATTR2

同一属性値条件に指定した二番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が2件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報3

SAMEATTR3

同一属性値条件に指定した三番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が3件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(58)　イベントID：00003F59の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F59

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4677-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を終了しました。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

同一属性値情報1

SAMEATTR1

同一属性値条件に指定した一番目（リストのいちばん上）の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が指定されていない場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報2

SAMEATTR2

同一属性値条件に指定した二番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が2件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報3

SAMEATTR3

同一属性値条件に指定した三番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が3件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(59)　イベントID：00003F60の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F60

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4678-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を打ち切り，再度抑止を開始しました。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

同一属性値情報1

SAMEATTR1

同一属性値条件に指定した一番目（リストのいちばん上）の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が指定されていない場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報2

SAMEATTR2

同一属性値条件に指定した二番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が2件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報3

SAMEATTR3

同一属性値条件に指定した三番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が3件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(60)　イベントID：00003F61の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F61

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4600-I 重大度変更定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB4600-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(61)　イベントID：00003F63の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F63

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4650-I 発生元ホストマッピング定義ファイルを読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB4650-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(62)　イベントID：00003F64の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F64

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8453-I 業務グループを反映しました。次に受信したイベントから処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB8453-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(63)　イベントID：00003F65の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F65

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4679-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止が継続しています。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

同一属性値情報1

SAMEATTR1

同一属性値条件に指定した一番目（リストのいちばん上）の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が指定されていない場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報2

SAMEATTR2

同一属性値条件に指定した二番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が2件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報3

SAMEATTR3

同一属性値条件に指定した三番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が3件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(64)　イベントID：00003F68の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F68

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8454-W 業務グループを反映できませんでした。(要因:要因)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(65)　イベントID：00003F69の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F69

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8456-E 業務グループを反映できませんでした。(要因:要因)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(66)　イベントID：00003F6Aの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F6A

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4623-I 表示メッセージ変更定義ファイルを読み込みました。次に受信したイベントから，読み込んだ定義に従って処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB4623-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(67)　イベントID：00003F71の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F71

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4802-I 重大度変更定義を登録しました。(重大度変更定義名:重大度変更定義名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(68)　イベントID：00003F76の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F76

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4803-I 表示メッセージ変更定義を登録しました。(表示メッセージ変更定義名:表示メッセージ変更定義名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(69)　イベントID：00003F77の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F77

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントコンソールサービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB5800-I イベント拡張属性定義ファイルをJP1/IM - Managerに読み込みました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(70)　イベントID：00003F78の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F78

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントコンソールサービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB5804-E イベント拡張属性定義ファイルを読み込もうとしましたが，一部のイベント拡張属性定義ファイルの読み込みに失敗しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(71)　イベントID：00003F7Cの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F7C

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントコンソールサービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1981-I モニター画面呼び出し定義ファイルをJP1/IM - Managerに反映しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(72)　イベントID：00003FB0の詳細

属性種別

項目

属性名

内容

基本属性

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

メッセージ

MESSAGE

KAVB7900-I 監視ノード名の状態が状態から状態に変わりました。

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SCOPE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IM_CS

事象種別

OCCURRENCE

STATUS_CHANGE

固有情報

監視ノードID

MON_NODE_ID

監視ノードのID

監視ノード名

MON_NODE_NAME

監視ノードの名称

監視ノードの状態※1

MON_NODE_STATUS

監視ノードのStatusID

状態変更の元となったJP1イベントの情報※2

属性名

属性値(基本属性にはJCS_B_が，拡張属性にはJCS_E_の接頭字が付加される)。

注※1　「監視ノードの状態（E.MON_NODE_STATUS）」には，JP1イベントを発行した監視ノードの状態が，StatusIDと呼ぶ次の数値に格納されます。

StatusID（監視ノードの状態）の値

緊急：800，警戒：700，致命的：600，エラー：500，警告：400，正常：300，デバッグ：200，初期状態：100

例えば，監視ノードの状態が緊急に変化した時に発行されたJP1イベントは，監視ノードの状態（E.MON_NODE_STATUS）=800になります。

注※2　「状態変更の元となったJP1イベントの情報」は，JP1/IM - Viewで確認できません。なお，「状態変更の元となったJP1イベントの情報」には，状態変更の契機となったJP1イベントの情報が属性名-属性値の組み合わせですべて格納されます。この結果，00003FB0がJP1イベントの最大値（10,000バイト）を超えた場合，最大値を超えない分だけ，状態変更の契機となったJP1イベントの情報を格納します。また，拡張属性が100個を超える場合も，100個以内に収まる範囲内でJP1イベントの情報を格納します。「状態変更の元となったJP1イベント」の情報のうち，「状態変更の元となったJP1イベントの登録時刻（E.JCS_B_TIME）」および「状態変更の元となったJP1イベントの到着時刻（E.JCS_B_ARRIVEDTIME）」は，GMTでYYYY/MM/DD hh:mm:ssの形式で格納されます。

(73)　イベントID：00003FB1の詳細

属性種別

項目

属性名

内容

基本属性

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

イベントID

−

00003FB1

メッセージ

MESSAGE

KAVB7901-W 監視ノード（監視ノードID※）の状態変更イベントの件数が上限を超えました。

拡張属性

共通情報

重大度

SEVERITY

WARNING

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SCOPE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IM_CS

事象種別

OCCURRENCE

NOTICE

固有情報

監視ノードID

MON_NODE_ID

監視ノードのID

状態変更イベントの件数

EVHIST_NUMBER

状態変更イベントの件数

（凡例）

−：なし

注※　1件のJP1イベントを契機にして，複数の監視オブジェクトの状態変更イベントが100件を超えた場合でも，このときに発行されるJP1イベント（イベントID＝00003FB1）は1件だけです。メッセージ情報の監視ノードIDの部分に監視オブジェクトのIDが最大10件，コンマ区切りで列挙されます。10件を超えた場合は，IDの後ろに（...）が付加されます。

(74)　イベントID：00003FC0の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC0

メッセージ

MESSAGE

KNAN26102-E リモートログファイルトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(75)　イベントID：00003FC1の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC1

メッセージ

MESSAGE

KNAN26094-E 指定された回数リトライ処理を行いましたが，該当ログファイルの読み込みが出来ないため監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名, 監視名:監視名, ログファイル名:ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(76)　イベントID：00003FC2の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC2

メッセージ

MESSAGE

KNAN26095-E 該当ログファイルを正しく監視することが出来ない状態になりました。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名, 監視名:監視名, ログファイル名:ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

異常検知時刻

WATCH_CHECK_TIME

ログファイルの異常を検知した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(77)　イベントID：00003FC3の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC3

メッセージ

MESSAGE

KNAN26057-E 続行できないエラーが発生したため，リモートログファイルトラップを停止します。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

異常検知時刻

WATCH_CHECK_TIME

ログファイルの異常を検知した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(78)　イベントID：00003FC5の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC5

メッセージ

MESSAGE

KNAN26140-W リモートログファイルトラップにおいて，監視対象のログファイルから収集したデータのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，ログファイル名: ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(79)　イベントID：00003FC6の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC6

メッセージ

MESSAGE

KNAN26351-E 監視対象ホスト監視対象ホスト名のすべてのリモートログファイルトラップを停止します。(要因: 要因)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(80)　イベントID：00003FC7の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC7

メッセージ

MESSAGE

KNAN26350-W 監視対象のログファイルの退避ファイルが見つかりません。前回収集日時から今回収集日時までに退避ファイルに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，監視対象ログファイル名: 監視対象ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時，ユーザー: ユーザー，実行したコマンドライン: 実行したコマンドライン)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(81)　イベントID：00003FC8の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC8

メッセージ

MESSAGE

KNAN26352-W 監視対象のログファイルの退避ファイルが見つかりません。前回収集日時から今回収集日時までに退避ファイルに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，監視対象ログファイル名: 監視対象ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時，ユーザー: ユーザー)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(82)　イベントID：00003FC9の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC9

メッセージ

MESSAGE

KNAN26353-E 監視対象ホスト監視対象ホスト名のリモートイベントログトラップを停止します。(要因: 要因)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(83)　イベントID：00003FD0の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD0

メッセージ

MESSAGE

KNAN26107-E リモートイベントログトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー発生API名

ERROR_FUNCTION

エラーの発生したWindowsのAPI名

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(84)　イベントID：00003FD1の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD1

メッセージ

MESSAGE

KNAN26028-E 指定された回数リトライ処理を行いましたが，イベントログの読み込みが出来ないためリモート監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー発生API名

ERROR_FUNCTION

エラーの発生したWindowsのAPI名

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(85)　イベントID：00003FD2の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD2

メッセージ

MESSAGE

KNAN26027-I イベントログの読み込みをリトライします。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー発生API名

ERROR_FUNCTION

エラーの発生したWindowsのAPI名

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(86)　イベントID：00003FD3の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD3

メッセージ

MESSAGE

KNAN26002-E 続行できないエラーが発生したため，リモートイベントログトラップを停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(87)　イベントID：00003FD4の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD4

メッセージ

MESSAGE

KNAN26026-I イベントログの監視が可能になりました。(監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

回復時刻

RECOVER_TIME

エラーから回復した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(88)　イベントID：00003FD5の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD5

メッセージ

MESSAGE

KNAN26142-W リモートイベントログトラップにおいて，監視対象ホストから収集したイベントログのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているイベントログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(89)　イベントID：00003FD6の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD6

メッセージ

MESSAGE

KNAN26339-W ログ収集時にリモートログファイルトラップの状態の保存に失敗しました。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(90)　イベントID：00003FD7の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD7

メッセージ

MESSAGE

KNAN26340-W ログ収集時にリモートイベントログトラップの状態の保存に失敗しました。(監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(91)　イベントID：00003FD8の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD8

メッセージ

MESSAGE

KNAN26341-W 前回停止時のリモートログファイルトラップの状態を復元することができませんでした。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(92)　イベントID：00003FD9の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD9

メッセージ

MESSAGE

KNAN26342-W 前回停止時のリモートイベントログトラップの状態を復元することができませんでした。(監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(93)　イベントID：00003FDAの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FDA

メッセージ

MESSAGE

KNAN26343-W 前回停止時のリモートログファイルトラップの状態を復元して監視できない状態のため，前回停止時のリモートログファイルトラップの状態を復元しませんでした。(詳細情報: 詳細情報，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(94)　イベントID：00003FDBの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FDB

メッセージ

MESSAGE

KNAN26345-I ログ収集時に発生していたリモートログファイルトラップの状態の保存のエラーが回復しました。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(95)　イベントID：00003FDCの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FDC

メッセージ

MESSAGE

KNAN26346-I ログ収集時に発生していたリモートイベントログトラップの状態の保存のエラーが回復しました。(監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(96)　イベントID：リモート監視ログファイルトラップ動作定義ファイルのACTDEFパラメーターに指定されている値

属性種別

項目

属性名

内容

基本属性

イベントID

−

ACTDEFパラメーターに指定されている値

メッセージ

MESSAGE

ログファイル1行分のログデータの内容

イベント発行時刻

−

イベントを発行した時刻

拡張属性

共通情報

重大度

SEVERITY

動作定義ファイルのACTDEFパラメーターで指定された重大度

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogdefコマンド，jcfallogstartコマンド，リモート監視の起動オプションに-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名

jcfallogdefコマンド，jcfallogstartコマンド，リモート監視の起動オプションに-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jcfallogdefコマンド，jcfallogstartコマンド，リモート監視の起動オプションに-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名

jcfallogdefコマンド，jcfallogstartコマンド，リモート監視の起動オプションに-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象のログファイル名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象のログファイル名

固有情報

プラットフォーム

PLATFORM

Windowsの場合：NT

UNIXの場合：UNIX

PP名

PPNAME

/HITACHI/JP1/IM/REMOTE_MONITORING/LOGTRAP

ホスト名

JP1_SOURCEHOST

イベント発生元ホスト名（監視対象ホスト名）

監視ID

E.JP1_TRAP_ID※

ログファイルトラップのID番号

監視名

E.JP1_TRAP_NAME※

監視名

（凡例）

−：なし

注※1　マネージャーのJP1/Baseが10-50以降の場合に存在する属性です。

(97)　イベントID：00003A71またはリモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細

属性種別

項目

属性名

（WMIの属性名）

内容

基本属性

イベントID

B.ID

リモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントID。

イベントIDを指定していない場合は00003A71固定となる。

メッセージ

B.MESSAGE

（MessageまたはInsertionStrings）

イベントログのメッセージ※1

最大1,023バイト。超えた分は切り捨て。

イベント発行時刻

−

イベントを発行した時刻

拡張属性

共通情報

重大度

E.SEVERITY

（EventType）

イベントログの種別に応じて登録する。

Error：エラー

Warning：警告

Information：情報，詳細，その他

Notice：監査成功，監査失敗

発行元プロダクト名

E.PRODUCT_NAME

（SourceName）

/HITACHI/JP1/NTEVENT_LOGTRAP/ソース

オブジェクト種別

E.OBJECT_TYPE

E.ROOT_OBJECT_TYPE

LOGFILE

オブジェクト名

E.OBJECT_NAME

E.ROOT_OBJECT_NAME

NTEVENTLOG

固有情報

イベントログ登録日時

E.A0

（TimeGenerated）

time_t型（UTC 1970-01-01 00:00:00からの秒数）

コンピュータ名

E.A1

（ComputerName）

コンピュータ名の値

hostnameコマンドを実行した際に表示されるホスト名.ドメイン名

種別

E.A2

（Logfile）

イベントログの種別の値

種類

E.A3

（Type）

イベントログのレベルに対応する値

分類

E.A4

（CategoryStringまたはCategory）

イベントログのタスクのカテゴリーの値

イベントID

E.A5

（EventCode）

イベントログのイベントIDの値

ユーザー名

E.A6

（User）

イベントログのユーザー名の値

プラットフォーム

E.PLATFORM

NT

PP名

E.PPNAME

/HITACHI/JP1/IM/AGENTLESS/EVENTLOGTRAP

発生元ホスト名

E.JP1_SOURCEHOST※2

監視対象ホスト名

監視名

E.JP1_TRAP_NAME

イベントログトラップ動作定義ファイルに指定された監視名。指定していない場合は出力しない（属性が存在しない）。

（凡例）

−：なし

注※1　イベントログの説明文を記載したメッセージDLLが正しく設定されていない場合は，挿入句や詳細コードをダブルクォーテーションマーク（"）で囲んでJP1イベントのメッセージに登録します。

注※2　共通定義ATTR_EVENT_LOGTRAP_SOURCEHOSTが1の場合だけ存在する属性です。

(98)　イベントID：00003F90の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003F90

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

jco_spmdのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB3737-E コンポーネント名 の管理対象プロセス名 は異常終了しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

異常終了したプロセス名

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(99)　イベントID：00003F91の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003F91

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

jco_spmdのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB3613-W コンポーネント名 のプロセス名 の起動がタイムアウトしました. 処理を継続します

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

起動タイムアウトしたプロセス名

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(100)　イベントID：00003F92の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003F92

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

jco_spmdのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB3616-I コンポーネント名 の管理対象プロセス名 の再起動が完了しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

再起動したプロセス名

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(101)　イベントID：00006400の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00006400

イベントDB内通し番号

SEQNO

イベントDB内通し番号※

登録要因

REASON

1〜4の値※

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻※

到着時刻

ARRIVEDTIME

到着時刻※

発行元ユーザーID

USERID

Windowsの場合※

-1〜65,535

UNIXの場合※

0

発行元グループID

GROUPID

Windowsの場合※

-1〜65,535※

UNIXの場合※

0

発行元ユーザー名

USERNAME

Windowsの場合※

SYSTEM

UNIXの場合※

root

発行元グループ名

GROUPNAME

Windowsの場合※

空白

UNIXの場合※

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名※

発行先イベントサーバ名

DESTSERVER

発行先イベントサーバ名※

発行元IPアドレス

EVIPADDR

イベント発行元IPアドレス※

IPv4の場合：aaa.bbb.ccc.ddd形式（前にゼロを付けない10進数で，1〜3桁）

IPv6の場合：aaaa:bbbb:cccc:dddd:eeee:ffff:gggg:hhhh形式（前にゼロを付けない16進数で，1〜4桁）

送信先IPアドレス

−

イベント送信先IPアドレス※

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号※

コードセット

−

JP1/IM - Managerが動作している言語コード※

メッセージ

MESSAGE

表示メッセージ変更機能によりメッセージ変更した場合，変更後のメッセージを設定する。

メッセージを変更していない場合，オリジナルイベントのメッセージテキストを設定する。

詳細情報

−

設定しない。

拡張属性

共通情報

重大度

SEVERITY

オリジナルイベントを重大度変更機能により重大度変更している場合，変更後の重大度を設定する。

重大度を変更していない場合，オリジナルイベントの重大度を設定する。

ユーザー名

USER_NAME

オリジナルイベントのUSER_NAME

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/MO

オブジェクトタイプ

OBJECT_TYPE

オリジナルイベントのOBJECT_TYPE

オブジェクト名

OBJECT_NAME

オリジナルイベントのOBJECT_NAME

登録名タイプ

ROOT_OBJECT_TYPE

オリジナルイベントのROOT_OBJECT_TYPE

登録名

ROOT_OBJECT_NAME

オリジナルイベントのROOT_OBJECT_NAME

オブジェクトID

OBJECT_ID

オリジナルイベントのOBJECT_ID

事象種別

OCCURRENCE

オリジナルイベントのOCCURRENCE

開始時刻

START_TIME

オリジナルイベントのSTART_TIME

終了時刻

END_TIME

オリジナルイベントのEND_TIME

終了コード

RESULT_CODE

オリジナルイベントのRESULT_CODE

オリジナルイベントの基本属性

イベントDB内通し番号

B_SEQNO

オリジナルイベントのイベントDB内通し番号

イベントID

B_ID

オリジナルイベントのイベントID。

「基本コード：拡張コード」の形式。基本コード，拡張コード共に8桁以内の16進数。前にゼロは付けない。

登録要因

B_REASON

オリジナルイベントの登録要因

発行元プロセスID

B_PID

オリジナルイベントの発行元プロセスID

登録時刻

B_DATE

オリジナルイベントの登録時刻の日付部分を「YYYY/MM/DD」の形式で設定。サーバのタイムゾーンで変換した文字列となる。

B_TIME

オリジナルイベントの登録時刻の時刻部分を「hh:mm:ss」の形式で設定。サーバのタイムゾーンで変換した文字列となる。

到着時刻

B_ARVDATE

オリジナルイベントの到着時刻の日付部分を「YYYY/MM/DD」の形式で設定。サーバのタイムゾーンで変換した文字列となる。

B_ARVTIME

オリジナルイベントの到着時刻の時刻部分を「hh:mm:ss」の形式で設定。サーバのタイムゾーンで変換した文字列となる。

発行元ユーザーID

B_USRID

オリジナルイベントの発行元ユーザーID

発行元グループID

B_GRPID

オリジナルイベントの発行元グループID

発行元ユーザー名

B_USR

オリジナルイベントの発行元ユーザー名

発行元グループ名

B_GRP

オリジナルイベントの発行元グループ名

発行元イベントサーバ名

B_HOST

オリジナルイベントの発行元イベントサーバ名

送信先イベントサーバ名

B_DESTSERVER

オリジナルイベントの送信先イベントサーバ名

発行元IPアドレス

B_IPADDR

オリジナルイベントの発行元IPアドレス

送信先IPアドレス

B_DESTIPADDR

オリジナルイベントの送信先IPアドレス

発行元別通し番号

B_SRCNO

オリジナルイベントの発行元別通し番号

コードセット

B_CODESET

オリジナルイベントのコードセット

メッセージ

B_MSG

オリジナルイベントのメッセージ

詳細情報

B_DETAIL

オリジナルイベントの詳細情報

詳細情報が文字列の場合：詳細情報の文字列をそのまま設定

詳細情報がバイナリー形式の場合：空白を設定

オリジナルイベントの拡張属性：共通情報

重大度

E_SEVERITY

オリジナルイベントのSEVERITY

（重大度変更機能で重大度を変更している場合，変更後の重大度を設定）

プロダクト名

E_PRODUCT_NAME

オリジナルイベントのPRODUCT_NAME

オリジナルイベントの拡張属性：固有情報

オリジナルイベントが持つ拡張属性：固有情報

E_*

オリジナルイベントの拡張属性固有情報を設定。

オリジナルイベントの属性名の先頭にE_を付加したもの。

例えば，オリジナルイベントの拡張属性の属性名がPLATFORMで内容がNTの場合，変換後のイベントの属性名がE_PLATFORMになり，内容はそのままNTとなる。

ただし，オリジナルイベントの拡張属性名が31バイト以上の場合，変換後のイベント属性名中の「E_」は省略される。

JP1/IM - M固有情報

イベント発行元情報

EVTSRC_INFO

JP1/IM - Managerでホストマッピングの機能が有効な場合

発生元ホスト（E.JP1_SOURCEHOST）

JP1/IM - Managerでホストマッピングの機能が無効な場合

発行元イベントサーバ名（B.SOURCESERVER）

JP1/IM - MOバージョン

MO_VERSION

「1100」

イベント発行元名

EVTSRC_NAME

オリジナルイベントにE.JP1ADD_EVTSRC_NAMEがある場合

E.JP1ADD_EVTSRC_NAME

オリジナルイベントにE.JP1ADD_EVTSRC_NAMEがない場合

発行元イベントサーバ名（B.SOURCESERVER）

適用先システム名

SYSTEM_NAME

オリジナルイベントにE.JP1ADD_SYSTEM_NAMEがある場合

E.JP1ADD_SYSTEM_NAME

オリジナルイベントにE.JP1ADD_SYSTEM_NAMEがない場合

日本語環境では，「全てのシステム」を設定する。日本語環境以外では「ALLSYSTEM」を設定する

拡張属性格納結果

ADDEXTATTR_RESULT

拡張属性の格納結果を設定する。

次の値の和を2バイトの16進数で設定する。

0：すべての拡張属性の値を格納できた

1：拡張属性の個数の上限（100個）に達し，格納できなかった属性がある

2：拡張属性の合計サイズの上限（10キロバイト）に達し，格納できなかった属性がある

4：拡張属性名の最大長を超えるため"E_"を付けないで格納した属性がある

8：他の拡張属性名と重複するため，属性を格納できなかった

（凡例）

−：なし

注※　JP1/Baseが設定します。

注　「オリジナルイベント」とは，JP1/IM - ManagerがJP1/Baseから取得したイベントを指します。

4　システム監視オブジェクト一覧（セントラルスコープ用）

この章では，JP1/IMで提供しているシステム監視オブジェクトについて説明します。

4.1　システム監視オブジェクトとは

システム監視オブジェクトとは，システムが提供している監視オブジェクトで，製品ごとに基本的な設定項目があらかじめ定義されています。

この章で説明する監視ツリーや監視オブジェクトに関する機能，および表の見方については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」の「5.2　監視ツリー」を参照してください。また，監視ツリーや監視オブジェクトの設定手順については，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「6.3　監視ツリーをGUIで作成する」を参照してください。

4.2　システム監視オブジェクト対応製品一覧

JP1/IM - Managerがシステム監視オブジェクトを提供している製品と自動生成機能への対応を次の表に示します。

JP1/IM - Managerがシステム監視オブジェクトを提供している製品と自動生成機能への対応

表4‒1　JP1/IM - Managerがシステム監視オブジェクトを提供している製品と自動生成機能への対応状況

製品名

自動生成機能への対応

JP1/AJS2 07-00以降，JP1/AJS3 09-00以降

対応済み※3

JP1/Cm2/SSO バージョン7またはバージョン8※1※2

対応済み※3

JP1/Cm2/SSO 07-00以降※1※2

対応済み※3

JP1/PFM 07-00以降

対応済み※3

JP1/PAM 07-00以降

未対応

JP1/NETM/DM 07-00以降

未対応

JP1/Cm2/NNM バージョン7またはバージョン8※2

未対応

JP1/NNMi

未対応

JP1/IM - Central Console 07-00以降

対応済み※3

Cosminexus 06-00以降

対応済み※3

HiRDB 07-02以降

未対応

JP1/ServerConductor 07-50以降

未対応

注※1　バージョン7時の製品名称は，JP1/PFM/SSOです。

注※2　連携製品のインストールホスト上にバージョン7またはバージョン8のJP1/Baseが必要です。

注※3　自動生成するには，連携製品のインストールホスト上に07-00以降のJP1/Baseが必要です。また，JP1/IM - Managerと同バージョンのJP1/IM - Viewが必要です。

4.3　JP1/AJS用システム監視オブジェクト

JP1/AJS用のシステム監視オブジェクトには，「AJS監視」と「ジョブネット監視(AJS)」があります。

4.3.1　「AJS監視」システム監視オブジェクト

表4‒2　システム監視オブジェクトの概要

項目

説明

監視ノード種別

AJS監視

目的

JP1/AJS自身の障害の監視，

ジョブネットの実行状態の監視

基本情報

オブジェクト名

ジョブネットの完全名（スケジューラーサービス名：/ジョブネット名）

（例）AJSROOT1:/業務A/受注処理

ホスト名

JP1/AJS - Managerがインストールされているマネージャーのホスト名

（例）host01

表4‒3　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

ジョブネット警告のイベント(AJS)

警告

ジョブネット警告のイベント(AJS)※

イベントID（B.ID）

00004108，00004122，00004123

オブジェクトID（E.OBJECT_NAME）

基本情報のオブジェクト名

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

ジョブネットエラーのイベント(AJS)

エラー

ジョブネットエラーのイベント(AJS)※

イベントID（B.ID）

00004104，00004131，00004142，00004143，00004144

オブジェクトID（E.OBJECT_NAME）

基本情報のオブジェクト名

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

システム警告のイベント(AJS)

警告

システム警告のイベント(AJS)※

イベントID（B.ID）

00004154，00004164，00004171，000041F1

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

システムエラーのイベント(AJS)

エラー

システムエラーのイベント(AJS)※

イベントID（B.ID）

00004110，00004130，00004152，00004162，00004170，000041F0，000041F3

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.3.2　「ジョブネット監視(AJS)」システム監視オブジェクト

表4‒4　システム監視オブジェクトの概要

項目

説明

監視ノード種別

ジョブネット監視(AJS)

目的

ジョブの実行状態の監視

基本情報

ジョブ実行ホスト

ジョブを実行するホストのホスト名

（例）jp1-agent

発行元イベントサーバ

JP1/AJS - Managerがインストールされているホストのホスト名

（例）jp1-manager

登録名

ルートジョブネットの完全名（スケジューラーサービス名：/ルートジョブネット名）

（例）AJSROOT1:/業務A/受注処理

表4‒5　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

ジョブ警告のイベント(AJS)

警告

ジョブ警告のイベント(AJS)※

イベントID（B.ID）

00004109

登録名（E.ROOT_OBJECT_NAME）

基本情報の登録名

実行先ホスト名（E.C0）

基本情報のジョブ実行ホスト

発行元イベントサーバ名（B.SOURCESERVER）

基本情報の発行元イベントサーバ

ジョブエラーのイベント(AJS)

エラー

ジョブエラーのイベント(AJS)※

イベントID（B.ID）

00004107

登録名（E.ROOT_OBJECT_NAME）

基本情報の登録名

実行先ホスト名（E.C0）

基本情報のジョブ実行ホスト

発行元イベントサーバ名（B.SOURCESERVER）

基本情報の発行元イベントサーバ

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.4　JP1/Cm2/SSO用システム監視オブジェクト

バージョン8以前のJP1/Cm2/SSO用のシステム監視オブジェクトには，「SSO監視」と「カテゴリー監視(SSO)」および「アプリケーション監視(SSO)」があります。

4.4.1　バージョン8以前のJP1/Cm2/SSO用のシステム監視オブジェクトを監視をする場合の設定について

バージョン8以前のJP1/Cm2/SSO用システム監視オブジェクトを監視する場合に必要な設定について説明します。次の事項を設定する必要があります。

バージョン8以前のJP1/Cm2/SSOはJP1イベントを発行しないため，JP1/Cm2/SSOがバージョン8以前のJP1/Cm2/NNMまたはバージョン7.5以前のHP NNMに対して発行しているSNMPトラップをJP1/Baseの機能を利用してJP1イベントに変換する必要があります。この変換のときに，SNMPトラップのバリアブルバインディングを取り込むようJP1/BaseのSNMPトラップ変換機能で設定する必要があります。

「アプリケーション監視(SSO)」の監視をする場合，バージョン8以前のJP1/Cm2/SSOの定義ファイル（ssoapmon.def）に，SNMPトラップのバリアブルバインディングのソース名を取り込むよう設定する必要があります。

4.4.2　「SSO監視」システム監視オブジェクト

表4‒6　システム監視オブジェクトの概要

項目

説明

監視ノード種別

SSO監視

目的

バージョン8以前のJP1/Cm2/SSO自身の障害の監視

基本情報

ホスト名

バージョン8以前のJP1/Cm2/SSOがインストールされている監視サーバのホスト名

（例）host01

表4‒7　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

システム警戒のイベント(SSO)

警戒

システム警戒のイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.15※2

イベント発行元ホスト名（E.SNMP_VARBIND6）

基本情報のホスト名

システムエラーのイベント(SSO)

エラー

システムエラーのイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.13※2

イベント発行元ホスト名（E.SNMP_VARBIND6）

基本情報のホスト名

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hitachi.systemAP.comet.sso.0」が入ります。

4.4.3　「カテゴリー監視(SSO)」システム監視オブジェクト

表4‒8　システム監視オブジェクトの概要

項目

説明

監視ノード種別

カテゴリー監視(SSO)

目的

バージョン8以前のJP1/Cm2/SSOが監視しているリソース状態の監視

基本情報

カテゴリー名

カテゴリー名

イベント発行元ホスト

バージョン8以前のJP1/Cm2/SSOがインストールされている監視サーバのホスト名

（例）host01

ホスト名

バージョン8以前のJP1/Cm2/SSOが監視対象としているサーバのホスト名

（例）host02

表4‒9　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

リソース警戒のイベント(SSO)

警戒

リソース警戒のイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.24※2

ソース名（E.SNMP_VARBIND12）

基本情報のホスト名

イベント発行元ホスト名（E.SNMP_VARBIND11）

基本情報のイベント発行元ホスト

カテゴリー名（E.SNMP_VARBIND2）

基本情報のカテゴリー名

リソースエラーのイベント(SSO)

エラー

リソースエラーのイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(21|23)※2

ソース名（E.SNMP_VARBIND12）

基本情報のホスト名

イベント発行元ホスト名（E.SNMP_VARBIND11）

基本情報のイベント発行元ホスト

カテゴリー名（E.SNMP_VARBIND2）

基本情報のカテゴリー名

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hitachi.systemAP.comet.sso.0」が入ります。

4.4.4　「アプリケーション監視(SSO)」システム監視オブジェクト

表4‒10　システム監視オブジェクトの概要

項目

説明

監視ノード種別

アプリケーション監視(SSO)

目的

バージョン8以前のJP1/Cm2/SSOで監視しているアプリケーションの状態の監視

基本情報

イベント発行元ホスト

バージョン8以前のJP1/Cm2/SSOがインストールされている監視サーバのホスト名

（例）host01

アプリケーション名

バージョン8以前のJP1/Cm2/SSOが監視対象としているアプリケーションの名称

（例）JP1/PFM

ホスト名

バージョン8以前のJP1/Cm2/SSOが監視対象としているリソース収集対象サーバのホスト名です。

（例）host02

表4‒11　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

アプリケーション警戒のイベント(SSO)

警戒

アプリケーション警戒のイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(109|112|115)※2

ソース名（E.SNMP_VARBIND3）

基本情報のホスト名

イベント発行元ホスト名（E.SNMP_VARBIND2）

基本情報のイベント発行元ホスト

アプリケーション名（E.SNMP_VARBIND1）

基本情報のアプリケーション名

アプリケーションエラーのイベント(SSO)

エラー

アプリケーションエラーのイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(108|110|111|113|116|118)※2

ソース名（E.SNMP_VARBIND3）

基本情報のホスト名

イベント発行元ホスト名（E.SNMP_VARBIND2）

基本情報のイベント発行元ホスト

アプリケーション名（E.SNMP_VARBIND1）

基本情報のアプリケーション名

プロセス監視障害警戒のイベント（SSO）

警戒

プロセス監視障害警戒のイベント（SSO）※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.304※2

監視対象マシンのホスト名（E.SNMP_VARBIND1）

基本情報のホスト名

イベント発行元ホスト（E.SNMP_VARBIND4）

基本情報のイベント発行元ホスト

プロセス監視障害エラーのイベント（SSO）

エラー

プロセス監視障害エラーのイベント（SSO）※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.303※2

監視対象マシンのホスト名（E.SNMP_VARBIND1）

基本情報のホスト名

イベント発行元ホスト（E.SNMP_VARBIND4）

基本情報のイベント発行元ホスト

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hitachi.systemAP.comet.sso.0」が入ります。

4.5　JP1/PFM用システム監視オブジェクト

JP1/PFM用のシステム監視オブジェクトには，「エージェント監視(PFM)」があります。

4.5.1　JP1/PFM用システム監視オブジェクトを監視する場合の設定について

JP1/PFM用システム監視オブジェクトを監視する場合に必要な設定について説明します。次の事項を設定する必要があります。

JP1/PFM - Managerからの事象を管理するには，JP1/PFM - Managerのアラームの設定で，アラーム状態が変化したときに，コマンド実行のアクションでJP1イベントを発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

4.5.2　「エージェント監視(PFM)」システム監視オブジェクト

表4‒12　システム監視オブジェクトの概要

項目

説明

監視ノード種別

エージェント監視(PFM)

目的

JP1/PFMのエージェントの状態の監視

基本情報

オブジェクトID

JP1/PFMのエージェントのサービスID

（例）TA1host01

発行元イベントサーバ

JP1/PFM - Managerがインストールされているホストのホスト名

（例）pfm-manager

ホスト名

JP1/PFM - Agentがインストールされているホストのホスト名

（例）pfm-agent

表4‒13　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

リソースエラーのイベント(PFM)

エラー

リソースエラーのイベント(PFM)※2

重大度（E.SEVERITY）

Error

プロダクト名（E.PRODUCT_NAME）

/PFM/ALARM_EVENT

オブジェクトID（E.OBJECT_ID）

基本情報のオブジェクトID

アラーム発生ホスト名（E.JPC_AGENT）

基本情報のホスト名

発行元イベントサーバ名（B.SOURCESERVER）

基本情報の発行元イベントサーバ

リソース警告のイベント(PFM)

警告

リソース警告のイベント(PFM)※1

重大度（E.SEVERITY）

Warning

プロダクト名（E.PRODUCT_NAME）

/PFM/ALARM_EVENT

オブジェクトID（E.OBJECT_ID）

基本情報のオブジェクトID

アラーム発生ホスト名（E.JPC_AGENT）

基本情報のホスト名

発行元イベントサーバ名（B.SOURCESERVER）

基本情報の発行元イベントサーバ

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　サービスIDに含まれるプロダクトIDと機能IDで，JP1/PFMのサービスを判別します。次に，対応するサービスを示します。

プロダクトIDが「P」（PFM-Manager）以外のサービス。

機能IDが「A」（Agent Collector）のサービス。

4.6　JP1/PAM用システム監視オブジェクト

JP1/PAM用のシステム監視オブジェクトには，「メトリック監視(PAM)」と「オブジェクト監視(PAM)」があります。

4.6.1　「メトリック監視(PAM)」システム監視オブジェクト

表4‒14　システム監視オブジェクトの概要

項目

説明

監視ノード種別

メトリック監視(PAM)

目的

JP1/PAMのメトリックの状態を監視

基本情報

ホスト名

JP1/PAMの監視対象ホストのホスト名

（例）host1

表4‒15　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

メトリックエラーのイベント（PAM）

エラー

メトリックエラーのイベント（PAM）※

イベントID（B.ID）

00004602，00004604，0000460B

ホスト名（E.PAM_HOSTNAME）

基本情報のホスト名

メトリック警告のイベント（PAM）

警告

メトリック警告のイベント（PAM）※

イベントID（B.ID）

00004600，00004603，00004609

ホスト名（E.PAM_HOSTNAME）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.6.2　「オブジェクト監視(PAM)」システム監視オブジェクト

表4‒16　システム監視オブジェクトの概要

項目

説明

監視ノード種別

オブジェクト監視(PAM)

目的

JP1/PAMが管理するオブジェクトの状態の監視

基本情報

ホスト名

JP1/PAMの監視対象ホストのホスト名

（例）host1

表4‒17　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

オブジェクトエラーのイベント（PAM）

エラー

オブジェクトエラーのイベント（PAM）※

イベントID（B.ID）

00004620，00004625

ホスト名（E.PAM_HOSTNAME）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.7　JP1/NETM/DM用システム監視オブジェクト

JP1/NETM/DM用のシステム監視オブジェクトには，「NETM/DM監視」と「配布ジョブ監視(NETM/DM)」があります。

4.7.1　「NETM/DM監視」システム監視オブジェクト

表4‒18　システム監視オブジェクトの概要

項目

説明

監視ノード種別

NETM/DM監視

目的

JP1/NETM/DM Manager自身の障害の監視

基本情報

ホスト名

JP1/NETM/DM Managerがインストールされているマネージャーのホスト名

（例）host01

表4‒19　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

システム致命的のイベント(NETM/DM)

致命的

システム致命的のイベント(NETM/DM)※

イベントID（B.ID）

00010401

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.7.2　「配布ジョブ監視(NETM/DM)」システム監視オブジェクト

表4‒20　システム監視オブジェクトの概要

項目

説明

監視ノード種別

配布ジョブ監視(NETM/DM)

目的

JP1/NETM/DMによる配布ジョブの実行状態の監視

基本情報

ホスト名

JP1/NETM/DM Managerがインストールされているマネージャーのホスト名

（例）host01

表4‒21　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

配布ジョブエラーのイベント(NETM/DM)

エラー

配布ジョブエラーのイベント(NETM/DM)※

イベントID（B.ID）

00010403

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.8　JP1/NNMi用システム監視オブジェクト

JP1/NNMi用のシステム監視オブジェクトには，「NNMi監視(NNMi)」と「ノード監視(NNMi)」があります。

4.8.1　JP1/NNMi用システム監視オブジェクトを監視する場合の設定について

JP1/NNMi用システム監視オブジェクトを監視する場合に必要な設定について説明します。JP1/NNMiが発行するNNMiインシデントの監視にあたって，ManagementインシデントとSNMPトラップの区別は行いません。

「NNMi監視(NNMi)」または「ノード監視(NNMi)」を使用する場合は，JP1/IM - EG for NNMiが発行するNNMiインシデントを変換したJP1イベントに，拡張属性「NNMI_FAMILY_UK」を設定してください。

拡張属性「NNMI_FAMILY_UK」を設定しない場合，「NNMi監視(NNMi)」または「ノード監視(NNMi)」による監視ができません。

拡張属性「NNMI_FAMILY_UK」の設定およびNNMiインシデントの詳細については，マニュアル「JP1/Integrated Management 2 - Event Gateway for Network Node Manager i」を参照してください。

4.8.2　「NNMi監視(NNMi)」システム監視オブジェクト

表4‒22　システム監視オブジェクトの概要

項目

説明

監視ノード種別

「NNMi監視(NNMi)」

目的

JP1/NNMi自身の障害の監視

基本情報

ホスト名

JP1/NNMiがインストールされているマネージャーのホスト名

（例）host01

表4‒23　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

システム警戒のイベント(NNMi)

警戒

システム警戒のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

ホスト名

システム致命的のイベント(NNMi)

致命的

システム致命的のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

ホスト名

システム警告のイベント(NNMi)

警告

システム警告のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

ホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.8.3　「ノード監視(NNMi)」システム監視オブジェクト

表4‒24　システム監視オブジェクトの概要

項目

説明

監視ノード種別

ノード監視(NNMi)

目的

JP1/NNMiが監視するノードの状態の監視

基本情報

ホスト名

JP1/NNMiが監視しているノードのホスト名

（例）host01

表4‒25　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

ネットワーク警戒のイベント(NNMi)

警戒

ネットワーク警戒のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

基本情報のホスト名

ネットワーク致命的のイベント(NNMi)

致命的

ネットワーク致命的のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

基本情報のホスト名

ネットワーク警告のイベント(NNMi)

警告

ネットワーク警告のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.9　JP1/Cm2/NNM用システム監視オブジェクト

バージョン8以前のJP1/Cm2/NNM用のシステム監視オブジェクトには，「NNM監視」と「ノード監視(NNM)」があります。

4.9.1　「NNM監視」システム監視オブジェクト

表4‒26　システム監視オブジェクトの概要

項目

説明

監視ノード種別

NNM監視

目的

バージョン8以前のJP1/Cm2/NNM自身の障害の監視

基本情報

ホスト名

バージョン8以前のJP1/Cm2/NNMがインストールされているマネージャーのホスト名

（例）host01

表4‒27　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

システム警戒のイベント(NNM)

警戒

システム警戒のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(50790429|58851330|59179066|59179227|59179229|59179230|40000020)※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

システム致命的のイベント(NNM)

致命的

システム致命的のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(58720265|58720270|58851329|58851332|59179058|59181005|59181006|59179225|59179228|59179232|59179234|59180002|59180005|59180100|59181002|59181004|58982397|58982398|58982401|58982402|58982415|58982417|58982422|59179061|40000028|58720263)※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

システムエラーのイベント(NNM)

エラー

システムエラーのイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(58720266|59047936|59179226|59179233|59179235|58982408|58982414|50790430|40000021)※1

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

システム警告のイベント(NNM)

警告

システム警告のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(40000027|58982399|59179065)※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hp.nm.openView.hpOpenView.0」が入ります。

4.9.2　「ノード監視(NNM)」システム監視オブジェクト

表4‒28　システム監視オブジェクトの概要

項目

説明

監視ノード種別

ノード監視(NNM)

目的

バージョン8以前のJP1/Cm2/NNMが監視するノードの状態の監視

基本情報

ホスト名

バージョン8以前のJP1/Cm2/NNMが監視しているノードのホスト名

（例）host01

表4‒29　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

ネットワーク致命的のイベント(NNM)

致命的

ネットワーク致命的のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.58916868※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

ネットワーク警告のイベント(NNM)

警告

ネットワーク警告のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(40000083|40000084|40000085|50790400|58916865)※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hp.nm.openView.hpOpenView.0」が入ります。

4.10　JP1/IM - Manager用システム監視オブジェクト

JP1/IM - Manager用のシステム監視オブジェクトには，「IM監視」があります。

4.10.1　「IM監視」システム監視オブジェクト

表4‒30　システム監視オブジェクトの概要

項目

説明

監視ノード種別

IM監視

目的

JP1/IM - Manager自体の障害の監視

基本情報

ホスト名

JP1/IM - Managerがインストールされているマネージャーのホスト名

（例）host01

表4‒31　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

システム警告のイベント(IM)

警告

システム警告のイベント(IM)※

イベントID（B.ID）

000020E6，000020E7，00003F91

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

システムエラーのイベント(IM)

エラー

システムエラーのイベント(IM)※

イベントID（B.ID）

00002010，00002011，00002012，00002020，00002021，000020A0，000020E2，000020E5，000020E8，00003F90

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.11　Cosminexus用システム監視オブジェクト

Cosminexus用のシステム監視オブジェクトには，「論理サーバ監視(Cosminexus)」および「J2EEアプリケーション監視(Cosminexus)」があります。

4.11.1　「論理サーバ監視(Cosminexus)」システム監視オブジェクト

表4‒32　システム監視オブジェクトの概要

項目

説明

監視ノード種別

論理サーバ監視(Cosminexus)

目的

サーバレベルの障害に関するJP1イベントの監視※

基本情報

ドメイン名

Cosminexusサーバのドメイン名

（例）DOM001

論理ホスト名

Cosminexusが監視対象としている論理ホスト名

（例）APSV001

注※　重大度が「Warning」以上のJP1イベントを監視します。

表4‒33　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

論理サーバ緊急のイベント(Cosminexus)

緊急

論理サーバ緊急のイベント(Cosminexus)※

イベントID

（B.ID）

00012000，00012080

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

論理サーバ警戒のイベント(Cosminexus)

警戒

論理サーバ警戒のイベント(Cosminexus)※

イベントID

（B.ID）

00012001，00012081

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

論理サーバ致命的のイベント(Cosminexus)

致命的

論理サーバ致命的のイベント(Cosminexus)※

イベントID

（B.ID）

00012002，00012082

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

論理サーバエラーのイベント(Cosminexus)

エラー

論理サーバエラーのイベント(Cosminexus)※

イベントID

（B.ID）

00012003，00012083

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

論理サーバ警告のイベント(Cosminexus)

警告

論理サーバ警告のイベント(Cosminexus)※

イベントID

（B.ID）

00012004，00012084

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.11.2　「J2EEアプリケーション監視(Cosminexus)」システム監視オブジェクト

表4‒34　システム監視オブジェクトの概要

項目

説明

監視ノード種別

J2EEアプリケーション監視(Cosminexus)

目的

アプリケーションレベルの障害に関するJP1イベントの監視※

基本情報

ドメイン名

Cosminexusサーバのドメイン名

（例）DOM001

論理ホスト名

Cosminexusが監視対象としている論理ホスト名

（例）APSV001

J2EEアプリケーション名

Cosminexusが監視対象としている論理ホスト上のJ2EEアプリケーション名

（例）API

注※　重大度が「Warning」以上のJP1イベントを監視します。

表4‒35　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

J2EEアプリケーション緊急のイベント(Cosminexus)

緊急

J2EEアプリケーション緊急のイベント(Cosminexus)※

イベントID

（B.ID）

00012090，000120D0

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

J2EEアプリケーション警戒のイベント(Cosminexus)

警戒

J2EEアプリケーション警戒のイベント(Cosminexus)※

イベントID

（B.ID）

00012091，000120D1

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

J2EEアプリケーション致命的のイベント(Cosminexus)

致命的

J2EEアプリケーション致命的のイベント(Cosminexus)※

イベントID

（B.ID）

00012092，000120D2

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

J2EEアプリケーションエラーのイベント(Cosminexus)

エラー

J2EEアプリケーションエラーのイベント(Cosminexus)※

イベントID

（B.ID）

00012093，000120D3

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

J2EEアプリケーション警告のイベント(Cosminexus)

警告

J2EEアプリケーション警告のイベント(Cosminexus)※

イベントID

（B.ID）

00012094，000120D4

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.12　HiRDB用システム監視オブジェクト

HiRDB用システム監視オブジェクトには，「HiRDB監視」があります。

4.12.1　HiRDB用システム監視オブジェクトを監視する場合の設定について

HiRDB用システム監視オブジェクトを監視する場合に必要な設定について説明します。次の事項を設定する必要があります。

HiRDBに関する事象を管理するには，HiRDBが管理する障害情報をJP1イベントとして発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

4.12.2　「HiRDB監視」システム監視オブジェクト

表4‒36　システム監視オブジェクトの概要

項目

説明

監視ノード種別

HiRDB監視

目的

HiRDB自身の障害監視

基本情報

ホスト名

HiRDBがインストールされているホストのホスト名

（例）host02

HiRDB識別子

HiRDBを識別するための識別子

（例）PDB1

表4‒37　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

HiRDB緊急のイベント

緊急

HiRDB緊急のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Emergency

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

HiRDB警戒のイベント

警戒

HiRDB警戒のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Alert

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

HiRDB致命的のイベント

致命的

HiRDB致命的のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Critical

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

HiRDBエラーのイベント

エラー

HiRDBエラーのイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Error

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

HiRDB警告のイベント

警告

HiRDB警告のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Warning

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.13　JP1/ServerConductor用システム監視オブジェクト

JP1/ServerConductor用システム監視オブジェクトには，「物理ホスト監視（System Manager）」があります。

4.13.1　JP1/ServerConductor用システム監視オブジェクトを監視する場合の設定について

JP1/ServerConductor用システム監視オブジェクトを監視する場合に必要な設定について説明します。次の事項を設定する必要があります。

JP1/ServerConductorが管理する物理ホストに関する事象を管理するには，JP1/ServerConductorのマネージャーサービスが検知したアラートをJP1イベントとして発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

4.13.2　「物理ホスト監視（System Manager）」システム監視オブジェクト

表4‒38　システム監視オブジェクトの概要

項目

説明

監視ノード種別

物理ホスト監視（System Manager）

目的

JP1/ServerConductorが管理する物理ホストに関する障害監視

基本情報

ホスト名

System Managerが管理する物理ホスト名

（例）host02

表4‒39　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

物理ホスト緊急のイベント

緊急

物理ホスト緊急のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Emergency

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

物理ホスト警戒のイベント

警戒

物理ホスト警戒のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Alert

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

物理ホスト致命的のイベント

致命的

物理ホスト致命的のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Critical

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

物理ホストエラーのイベント

エラー

物理ホストエラーのイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Error

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

物理ホスト警告のイベント

警告

物理ホスト警告のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Warning

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

5　監視ツリーモデル（セントラルスコープ用）

この章では，監視ツリーを自動生成するときに作成される監視ツリーの構造について説明します。

5.1　監視ツリーを自動生成するときのテンプレートについて

監視ツリーを自動生成するときに作成される監視ツリーの構造は，［自動生成-構成選択］画面で選択するテンプレートによって異なります。セントラルコンソールが用意しているテンプレートを次に示します。

「業務指向ツリー」テンプレート

「サーバ指向ツリー」テンプレート

テンプレートごとに監視ツリーのモデルが定義されています。監視ツリーを自動生成する場合，各ホストから収集した定義を，監視ツリーモデルに合わせて自動的に監視ツリーを生成します。

5.2　「業務指向ツリー」の監視ツリーモデル

監視ツリーを自動生成するときに，「業務指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデルを次に示します。

「業務指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデル

図5‒1　監視ツリー（業務指向ツリー）のモデル

図5‒2　監視ツリー（業務指向ツリー）のモデル

5.3　「サーバ指向ツリー」の監視ツリーモデル

監視ツリーを自動生成するときに，「サーバ指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデルを次に示します。

「サーバ指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデル

図5‒3　監視ツリー（サーバ指向ツリー）のモデル

図5‒4　監視ツリー（サーバ指向ツリー）のモデル

索引

記号

!JP1_CS_APP0.conf（起動プログラム定義ファイル）[1]

!JP1_CS_FTOOL0.conf（ツールバー定義ファイル）[1]

!JP1_CS_FTREE0.conf（アイコン動作定義ファイル）[1]

.system（システムプロファイル）[1]

A

actdef.conf（自動アクション定義ファイル）[1]

actdef.conf（自動アクション定義ファイル）（互換用）[1]

action_complete_xxx.conf（対処済み連動設定ファイル）[1]

action.conf.update（自動アクション環境定義ファイル）[1]

actnotice.conf（自動アクション通知定義ファイル）[1]

attr_list.conf（イベント条件表示項目定義ファイル）[1]

auto_dbbackup_xxx.conf（監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル）[1]

C

chmsg_attr_list.conf（表示メッセージ変更定義表示項目定義ファイル）[1]

chmsg_auto_list.conf（表示メッセージ変更定義自動入力定義ファイル）[1]

chmsgevent.conf（表示メッセージ変更後イベント環境定義ファイル）[1]

chsev_attr_list.conf（重大度変更定義表示項目定義ファイル）[1]

chsev_auto_list.conf（重大度変更定義自動入力定義ファイル）[1]

common_exclude_filter_attr_list.conf（共通除外条件表示項目定義ファイル）[1]

console.conf.update（通信環境定義ファイル）[1]

D

defaultUser（ユーザープロファイル）[1]

E

egs_system.conf（相関イベント発行システムプロファイル）[1]

event_info_replace.conf（イベント引き継ぎ情報変換設定ファイル）[1]

event_storm_attr_list.conf（繰り返しイベント条件表示項目定義ファイル）[1]

event_storm_auto_list.conf（繰り返しイベント条件自動入力定義ファイル）[1]

evhist_warn_event_xxx.conf（状態変更イベント件数の上限監視設定ファイル）[1]

evtreport.conf（イベントレポート出力環境定義ファイル）[1]

H

hitachi_jp1_製品名.html（WWWページ呼び出し定義ファイル）[1]

host_collect_data.csv（ホスト収集情報ファイル）[1]

host_input_data.csv（ホスト入力情報ファイル）[1]

I

imdd_category_name.conf（IM管理ノードカテゴリ名称定義ファイル）[1]

imdd_host_name.conf（ホスト名定義ファイル）[1]

imdd_nodeLink_def.conf（IM管理ノードリンク定義ファイル）[1]

imdd_systemnode.conf（システムノード定義ファイル）[1]

imdd_target_host.conf（構成取得対象ホスト定義ファイル）[1]

imdd.properties（インテリジェント統合管理基盤定義ファイル）[1]

IM-View設定ファイル（tuning.conf）[1]

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）[1]

IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）[1]

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）[1]

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）[1]

IMパラメーター定義ファイル（jp1co_param_V7.conf）[1]

incident_info.conf（インシデント引き継ぎ情報設定ファイル）[1]

incident.conf（インシデント手動登録定義ファイル）[1]

J

jcacancel[1]

jcachange[1]

jcadefconv[1]

jcamakea[1]

jcashowa[1]

jcastatus[1]

jcfaleltdef（Windows限定）[1]

jcfaleltreload（Windows限定）[1]

jcfaleltstart（Windows限定）[1]

jcfaleltstat（Windows限定）[1]

jcfaleltstop（Windows限定）[1]

jcfallogdef[1]

jcfallogreload[1]

jcfallogstart[1]

jcfallogstat[1]

jcfallogstop[1]

jcfcolvmesx[1]

jcfcolvmhcsm[1]

jcfcolvmkvm[1]

jcfcolvmscvmm（Windows限定）[1]

jcfcolvmvc[1]

jcfcolvmvirtage[1]

jcfdbsetup[1]

jcfdbunsetup[1]

jcfexport[1]

jcfimport[1]

jcfmkcsdata[1]

jcfmkhostsdata[1]

jcfthreaddmp（Windows限定）[1]

jcfview.conf（IM構成管理・ビューアー動作定義ファイル）[1]

jcfview（Windows限定）[1]

jcfvirtualchstat[1]

jco_guide.txt（イベントガイド情報ファイル）[1]

jco_killall.cluster（UNIX限定）[1]

jco_spmd_reload[1]

jco_spmd_status[1]

jco_start.cluster（UNIX限定）[1]

jco_start（UNIX限定）[1]

jco_stop.cluster（UNIX限定）[1]

jco_stop（UNIX限定）[1]

jcoappexecfcheck（Windows限定）[1]

jcoattrfcheck[1]

jcochafmode（UNIX限定）[1]

jcochcefmode[1]

jcochfilter[1]

jcochstat[1]

jcodbsetup[1]

jcodbunsetup[1]

jcoegschange[1]

jcoegscheck[1]

jcoegsstart[1]

jcoegsstatus[1]

jcoegsstop[1]

jcoevtreport[1]

jcofuncfcheck（Windows限定）[1]

jcogencore[1]

jcohc.conf（ヘルスチェック定義ファイル）[1]

jcohctest[1]

jcoimdef[1]

jcomonitorfcheck[1]

jcothreaddmp（Windows限定）[1]

jcovcfsetup（Windows限定）[1]

jcoview_log.bat（Windows限定）[1]

jcoview（Windows限定）[1]

jcs_guide_xxx.txt（ガイド情報ファイル）[1]

jcs_hosts（ホスト情報ファイル）[1]

jcs_sysprofile_xxx.def（システムプロファイル（セントラルスコープ））[1]

jcschstat[1]

jcsdbexport[1]

jcsdbimport[1]

jcsdbsetup[1]

jcshostsexport[1]

jcshostsimport[1]

jddcreatetree[1]

jddsetaccessuser[1]

jddsetproxyuser[1]

jddupdatetree[1]

jim_log.bat（Windows限定）[1]

jim_log.sh（UNIX限定）[1]

jimdbbackup[1]

jimdbclustersetupinfo.conf（クラスタセットアップ情報ファイル）[1]

jimdbreclaim[1]

jimdbrecovery[1]

jimdbrorg[1]

jimdbsetupinfo.conf（セットアップ情報ファイル）[1]

jimdbstatus[1]

jimdbstop[1]

jimdbupdate[1]

jimmail（Windows限定）[1]

jimmailpasswd（Windows限定）[1]

JP1/AJS用システム監視オブジェクト[1]

JP1/Cm2/NNM用システム監視オブジェクト[1]

JP1/Cm2/SSO用システム監視オブジェクト[1]

JP1/IM - Managerの管理ノード数

カウントする[1]

JP1/IMが出力するJP1イベント[1]

JP1/NNMi用システム監視オブジェクト[1]

jp1cc_setup_cluster（UNIX限定）[1]

jp1cc_setup（UNIX限定）[1]

jp1cf_applyconfig.conf（IM構成反映方式設定ファイル）[1]

jp1cf_setup_cluster（UNIX限定）[1]

jp1cf_setup（UNIX限定）[1]

jp1cfhasetup（Windows限定）[1]

jp1co_param_V7.conf（IMパラメーター定義ファイル）[1]

jp1co_service.conf（拡張起動プロセス定義ファイル）[1]

jp1cohasetup（Windows限定）[1]

jp1cohaverup[1]

jp1cs_setup_cluster（UNIX限定）[1]

jp1cs_setup（UNIX限定）[1]

jp1cshasetup（Windows限定）[1]

jp1cshaverup.bat（Windows限定）[1]

jp1cshaverup（UNIX限定）[1]

jp1csverup.bat（Windows限定）[1]

jp1csverup（UNIX限定）[1]

JP1イベント[1]

一覧[1]

詳細[1]

属性[1]

N

nosslhost.conf(非暗号化通信ホスト設定ファイル）[1]

P

processupdate.conf（対処状況イベント定義ファイル）[1]

profile_ユーザー名（ユーザープロファイル）[1]

S

SpmSetSvcCon（Windows限定）[1]

system.conf（システムプロファイル（セントラルスコープ・ビューアー））[1]

systemColor.conf（システムカラー定義ファイル）[1]

T

tree_view.conf.update（通信環境定義ファイル）[1]

tuning.conf（IM-View設定ファイル）[1]

U

user_hostmap.conf（発生元ホストマッピング定義ファイル）[1]

V

view.conf.update（通信環境定義ファイル）[1]

W

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）[1]

あ

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）[1]

アクション情報ファイルの容量を小さくする場合[1]

アプリケーション実行定義ファイル[1]

チェックする[1]

置換文字列[1]

い

一次資料

JP1/IM - Manager用（UNIX）[1]

JP1/IM - View，JP1/IM - Manager用（Windows）[1]

イベントID

00002010の詳細[1]

00002011の詳細[1]

00002012の詳細[1]

00002013の詳細[1]

00002014の詳細[1]

00002015の詳細[1]

00002016の詳細[1]

00002020の詳細[1]

00002021の詳細[1]

000020A0の詳細[1]

000020A1の詳細[1]

000020A2の詳細[1]

000020A3の詳細[1]

000020A4の詳細[1]

000020A5の詳細[1]

000020A6の詳細[1]

000020E0の詳細[1]

000020E1の詳細[1]

000020E2の詳細[1]

000020E3の詳細[1]

000020E4の詳細[1]

000020E5の詳細[1]

000020E6の詳細[1]

000020E7の詳細[1]

000020E8の詳細[1]

00003A71の詳細[1]

00003A71またはリモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細[1]

00003F01の詳細[1]

00003F02の詳細[1]

00003F03の詳細[1]

00003F04の詳細[1]

00003F05の詳細[1]

00003F06の詳細[1]

00003F07の詳細[1]

00003F08の詳細[1]

00003F11の詳細[1]

00003F13の詳細[1]

00003F15の詳細[1]

00003F16の詳細[1]

00003F17の詳細[1]

00003F20の詳細[1]

00003F21の詳細[1]

00003F22の詳細[1]

00003F23の詳細[1]

00003F25の詳細[1]

00003F26の詳細[1]

00003F28の詳細[1]

00003F31の詳細[1]

00003F41の詳細[1]

00003F42の詳細[1]

00003F51の詳細[1]

00003F52の詳細[1]

00003F53の詳細[1]

00003F54の詳細[1]

00003F56の詳細[1]

00003F57の詳細[1]

00003F58の詳細[1]

00003F59の詳細[1]

00003F60の詳細[1]

00003F61の詳細[1]

00003F63の詳細[1]

00003F64の詳細[1]

00003F65の詳細[1]

00003F68の詳細[1]

00003F69の詳細[1]

00003F6Aの詳細[1]

00003F71の詳細[1]

00003F76の詳細[1]

00003F77の詳細[1]

00003F78の詳細[1]

00003F7Cの詳細[1]

00003F90の詳細[1]

00003F91の詳細[1]

00003F92の詳細[1]

00003FB0の詳細[1]

00003FB1の詳細[1]

00003FC0の詳細[1]

00003FC1の詳細[1]

00003FC2の詳細[1]

00003FC3の詳細[1]

00003FC5の詳細[1]

00003FC6の詳細[1]

00003FC9の詳細[1]

00003FC7の詳細[1]

00003FC8の詳細[1]

00003FD0の詳細[1]

00003FD1の詳細[1]

00003FD2の詳細[1]

00003FD3の詳細[1]

00003FD4の詳細[1]

00003FD5の詳細[1]

00003FD6の詳細[1]

00003FD7の詳細[1]

00003FD8の詳細[1]

00003FD9の詳細[1]

00003FDAの詳細[1]

00003FDBの詳細[1]

00003FDCの詳細[1]

00006400の詳細[1]

ACTDEFパラメーターに指定されている値[1]

相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントIDの詳細[1]

相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントIDの詳細[1]

リモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細[1]

イベントガイド情報ファイル（jco_guide.txt）[1]

イベント拡張属性定義ファイル[1]

チェックする[1]

イベント拡張属性定義ファイル（拡張ファイル）[1]

イベント監視条件の優先度[1]

イベント条件表示項目定義ファイル（attr_list.conf）[1]

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）[1]

イベントレポート出力環境定義ファイル（evtreport.conf）[1]

イベントレポート出力の項目ファイル[1]

イベントレポート出力のフィルターファイル[1]

インシデント手動登録定義ファイル（incident.conf）[1]

インシデント引き継ぎ情報設定ファイル（incident_info.conf）[1]

インテリジェント統合管理基盤定義ファイル（imdd.properties）[1]

お

オブジェクトタイプ定義ファイル[1]

か

ガイド情報ファイル（jcs_guide_xxx.txt）[1]

ガイドメッセージファイル[1]

拡張起動プロセス定義ファイル（jp1co_service.conf）[1]

拡張属性[1]

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）[1]

監視オブジェクト初期化設定ファイル[1]

監視ツリーモデル

業務指向ツリー[1]

サーバ指向ツリー[1]

監視ツリーモデル（セントラルスコープ用）[1]

き

キーワード置換文字列[1]

起動オプションの注意事項[1]

起動プログラム定義ファイル（!JP1_CS_APP0.conf）[1]

基本属性[1]

キャンセル処理中に実行先のホストが再起動した場合の処理[1]

共通除外条件拡張定義ファイル[1]

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）[1]

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）[1]

共通定義設定用ファイル（JP1イベントの属性変更）[1]

「業務指向ツリー」の監視ツリーモデル[1]

く

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）[1]

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）[1]

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）[1]

こ

構成取得対象ホスト定義ファイル（imdd_target_host.conf）[1]

コマンド[1]

IM構成管理に関するコマンド[1]

IM構成管理に関するコマンド（リモート監視構成）[1]

IMデータベース[1]

jcacancel[1]

jcachange[1]

jcadefconv[1]

jcamakea[1]

jcashowa[1]

jcastatus[1]

jcfaleltdef（Windows限定）[1]

jcfaleltreload（Windows限定）[1]

jcfaleltstart（Windows限定）[1]

jcfaleltstat（Windows限定）[1]

jcfaleltstop（Windows限定）[1]

jcfallogdef[1]

jcfallogreload[1]

jcfallogstart[1]

jcfallogstat[1]

jcfallogstop[1]

jcfcolvmesx[1]

jcfcolvmhcsm[1]

jcfcolvmkvm[1]

jcfcolvmscvmm（Windows限定）[1]

jcfcolvmvc[1]

jcfcolvmvirtage[1]

jcfdbsetup[1]

jcfdbunsetup[1]

jcfexport[1]

jcfimport[1]

jcfmkcsdata[1]

jcfmkhostsdata[1]

jcfthreaddmp（Windows限定）[1]

jcfview（Windows限定）[1]

jcfvirtualchstat[1]

jco_killall.cluster（UNIX限定）[1]

jco_spmd_reload[1]

jco_spmd_status[1]

jco_start.cluster（UNIX限定）[1]

jco_start（UNIX限定）[1]

jco_stop.cluster（UNIX限定）[1]

jco_stop（UNIX限定）[1]

jcoappexecfcheck（Windows限定）[1]

jcoattrfcheck[1]

jcochafmode（UNIX限定）[1]

jcochcefmode[1]

jcochfilter[1]

jcochstat[1]

jcodbsetup[1]

jcodbunsetup[1]

jcoegschange[1]

jcoegscheck[1]

jcoegsstart[1]

jcoegsstatus[1]

jcoegsstop[1]

jcoevtreport[1]

jcofuncfcheck（Windows限定）[1]

jcogencore[1]

jcohctest[1]

jcoimdef[1]

jcomonitorfcheck[1]

jcothreaddmp（Windows限定）[1]

jcovcfsetup（Windows限定）[1]

jcoview_log.bat（Windows限定）[1]

jcoview（Windows限定）[1]

jcschstat[1]

jcsdbexport[1]

jcsdbimport[1]

jcsdbsetup[1]

jcshostsexport[1]

jcshostsimport[1]

jddcreatetree[1]

jddsetaccessuser[1]

jddsetproxyuser[1]

jddupdatetree[1]

jim_log.bat（Windows限定）[1]

jim_log.sh（UNIX限定）[1]

jimdbbackup[1]

jimdbreclaim[1]

jimdbrecovery[1]

jimdbrorg[1]

jimdbstatus[1]

jimdbstop[1]

jimdbupdate[1]

jimmail（Windows限定）[1]

jimmailpasswd（Windows限定）[1]

jimnodecount[1]

JP1/IM - Managerの管理ノード数をカウントする[1]

JP1/IM - Managerの定義ファイルのチェック[1]

JP1/IM - Viewの定義ファイルのチェック[1]

jp1cc_setup_cluster（UNIX限定）[1]

jp1cc_setup（UNIX限定）[1]

jp1cf_setup_cluster（UNIX限定）[1]

jp1cf_setup（UNIX限定）[1]

jp1cfhasetup（Windows限定）[1]

jp1cohasetup（Windows限定）[1]

jp1cohaverup[1]

jp1cs_setup_cluster（UNIX限定）[1]

jp1cs_setup（UNIX限定）[1]

jp1cshasetup（Windows限定）[1]

jp1cshaverup.bat（Windows限定）[1]

jp1cshaverup（UNIX限定）[1]

jp1csverup.bat（Windows限定）[1]

jp1csverup（UNIX限定）[1]

SpmSetSvcCon（Windows限定）[1]

一覧[1]

イベント[1]

監視オブジェクトDBの情報の移行[1]

監視ノードの状態変更[1]

起動・終了，セットアップ[1]

構成定義[1]

自動アクションおよびコマンド実行[1]

セントラルスコープの環境設定[1]

相関イベントの発行[1]

トラブルシューティング[1]

バージョンアップ[1]

ビューの起動に関するコマンド[1]

フィルター[1]

メール通知機能[1]

コマンドの記述形式[1]

コマンドボタン定義ファイル（cmdbtn.conf）[1]

さ

「サーバ指向ツリー」の監視ツリーモデル[1]

し

システムカラー定義ファイル（systemColor.conf）[1]

システム監視オブジェクト

Cosminexus用[1]

HiRDB用[1]

JP1/IM - Manager用[1]

JP1/NETM/DM用[1]

JP1/PAM用[1]

JP1/PFM用[1]

JP1/ServerConductor用[1]

システム監視オブジェクト一覧（セントラルスコープ用）[1]

システム監視オブジェクト対応製品一覧[1]

システム監視オブジェクトとは[1]

システムノード定義ファイル（imdd_systemnode.conf）[1]

システムプロファイル（.system）[1]

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）[1]

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）[1]

指定内容の確認[1]

自動アクション環境定義ファイル（action.conf.update）[1]

自動アクション通知定義ファイル（actnotice.conf）[1]

自動アクション定義パラメーターのサイズチェック[1]

自動アクション定義ファイル（actdef.conf）[1]

自動アクション定義ファイル（actdef.conf）（互換用）[1]

自動アクション定義ファイル（互換用）

イベント監視条件の優先度[1]

指定内容の確認[1]

自動アクション定義パラメーターのサイズチェック[1]

定義の記述[1]

パラメーターグループとAND条件[1]

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）[1]

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）[1]

重大度変更定義ファイル[1]

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）[1]

状態変更イベント自動削除設定ファイル[1]

状態変更条件メモリー常駐機能の設定ファイル[1]

す

ステートメント[1]

構成要素の生成規則[1]

構造[1]

種類[1]

詳細[1]

せ

正規表現[1]

正規表現に関する注意事項[1]、[2]

性能レポート表示定義ファイル（performance.conf）[1]

セットアップ情報ファイル（jimdbsetupinfo.conf）[1]

そ

相関イベント発行環境定義ファイル[1]

相関イベント発行機能の状態

起動処理中[1]

機能停止[1]

相関稼働[1]

停止[1]

停止処理中[1]

相関イベント発行システムプロファイル（egs_system.conf）[1]

相関イベント発行定義ファイル[1]

操作ログ定義ファイル（imm_operationlog.conf）[1]

た

対処状況イベント定義ファイル（processupdate.conf）[1]

対処済み連動設定ファイル（action_complete_xxx.conf）[1]

ち

置換文字列[1]

キーワード置換文字列[1]

レジストリー置換文字列[1]

つ

通信環境定義ファイル（console.conf.update）[1]

通信環境定義ファイル（tree_view.conf.update）[1]

通信環境定義ファイル（view.conf.update）[1]

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）[1]

ツリー構成ファイル[1]

て

定義の記述[1]

定義ファイル[1]

IM-View設定ファイル（tuning.conf）[1]

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）[1]

IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）[1]

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）[1]

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）[1]

IMパラメーター定義ファイル（jp1co_param_V7.conf）[1]

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）[1]

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）[1]

アプリケーション実行定義ファイル[1]

一覧[1]

イベントガイド情報ファイル（jco_guide.txt）[1]

イベント拡張属性定義ファイル（拡張ファイル）[1]

イベント条件表示項目定義ファイル（attr_list.conf）[1]

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）[1]

イベントレポート出力環境定義ファイル（evtreport.conf）[1]

インシデント手動登録定義ファイル（incident.conf）[1]

インシデント引き継ぎ情報設定ファイル（incident_info.conf）[1]

インテリジェント統合管理基盤定義ファイル（imdd.properties）[1]

オブジェクトタイプ定義ファイル[1]

ガイド情報ファイル（jcs_guide_xxx.txt）[1]

概要[1]

拡張起動プロセス定義ファイル（jp1co_service.conf）[1]

格納先[1]

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）[1]

監視オブジェクト初期化設定ファイル[1]

起動プログラム定義ファイル（!JP1_CS_APP0.conf）[1]

共通除外条件拡張定義ファイル[1]

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）[1]

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）[1]

共通定義設定用ファイル（JP1イベントの属性変更）[1]

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）[1]

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）[1]

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）[1]

構成取得対象ホスト定義ファイル（imdd_target_host.conf）[1]

構成要素[1]

構造[1]

コマンドボタン定義ファイル（cmdbtn.conf）[1]

システムカラー定義ファイル（systemColor.conf）[1]

システムノード定義ファイル（imdd_systemnode.conf）[1]

システムプロファイル（.system）[1]

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）[1]

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）[1]

自動アクション環境定義ファイル（action.conf.update）[1]

自動アクション通知定義ファイル（actnotice.conf）[1]

自動アクション定義ファイル（actdef.conf）[1]

自動アクション定義ファイル（actdef.conf）（互換用）[1]

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）[1]

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）[1]

重大度変更定義ファイル[1]

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）[1]

状態変更イベント自動削除設定ファイル[1]

状態変更条件メモリー常駐機能の設定ファイル[1]

性能レポート表示定義ファイル（performance.conf）[1]

セットアップ情報ファイル（jimdbsetupinfo.conf）[1]

相関イベント発行環境定義ファイル[1]

相関イベント発行システムプロファイル（egs_system.conf）[1]

相関イベント発行定義ファイル[1]

操作ログ定義ファイル（imm_operationlog.conf）[1]

対処状況イベント定義ファイル（processupdate.conf）[1]

対処済み連動設定ファイル（action_complete_xxx.conf）[1]

通信環境定義ファイル（console.conf.update）[1]

通信環境定義ファイル（tree_view.conf.update）[1]

通信環境定義ファイル（view.conf.update）[1]

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）[1]

ツリー構成ファイル[1]

統合機能メニュー定義ファイル[1]

発生元ホストマッピング定義ファイル（user_hostmap.conf）[1]

非暗号化通信ホスト設定ファイル（nosslhost.conf）[1]

表示メッセージ変更後イベント環境定義ファイル（chmsgevent.conf）[1]

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）[1]

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）[1]

表示メッセージ変更定義ファイル[1]

プロファイル管理環境定義ファイル（jp1cf_profile_manager.conf）[1]

ヘルスチェック定義ファイル（jcohc.conf）[1]

ホスト収集情報ファイル（host_collect_data.csv）[1]

ホスト情報ファイル（jcs_hosts）[1]

ホスト入力情報ファイル（host_input_data.csv）[1]

ホスト名定義ファイル（imdd_host_name.conf）[1]

命名規則[1]

メール環境定義ファイル（jimmail.conf）[1]

モニター画面呼び出し定義ファイル[1]

ユーザープロファイル（defaultUser）[1]

ユーザープロファイル（profile_ユーザー名）[1]

リモート監視イベントログトラップ動作定義ファイル[1]

リモート監視ログファイルトラップ動作定義ファイル[1]

リモートログトラップ環境定義ファイル（jp1cf_remote_logtrap.conf）[1]

定義ファイルの記述形式[1]

と

統合機能メニュー定義ファイル[1]

チェックする[1]

に

二次資料

JP1/IM - Manager用（UNIX）[1]

JP1/IM - View，JP1/IM - Manager用（Windows）[1]

は

発生元ホストマッピング定義ファイル（user_hostmap.conf）[1]

パラメーターグループとAND条件[1]

ひ

非暗号化通信ホスト設定ファイル（nosslhost.conf）[1]

表示メッセージ変更後イベント環境定義ファイル（chmsgevent.conf）[1]

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）[1]

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）[1]

表示メッセージ変更定義ファイル[1]

ふ

プロファイル管理環境定義ファイル（jp1cf_profile_manager.conf）[1]

へ

ヘルスチェック定義ファイル（jcohc.conf）[1]

ほ

ホスト収集情報ファイル（host_collect_data.csv）[1]

ホスト情報ファイル（jcs_hosts）[1]

ホスト入力情報ファイル（host_input_data.csv）[1]

ホスト名定義ファイル（imdd_host_name.conf）[1]

め

メール環境定義ファイル（jimmail.conf）[1]

も

モニター画面呼び出し定義ファイル[1]

チェックする[1]

ゆ

ユーザープロファイル（defaultUser）[1]

ユーザープロファイル（profile_ユーザー名）[1]

り

リモート監視イベントログトラップ動作定義ファイル[1]

リモート監視ログファイルトラップ動作定義ファイル[1]

リモート監視ログファイルトラップ動作定義ファイルのACTDEFパラメーターに指定されている値[1]

リモートログトラップ環境定義ファイル（jp1cf_remote_logtrap.conf）[1]

れ

レジストリー置換文字列[1]