JP1 Version 9

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

文法書

3020-3-R80-51

目　　次

前書き

変更内容

はじめに

1.　コマンド

コマンドの記述形式

コマンド一覧

jcacancel

jcachange

jcadefconv

jcamakea

jcashowa

jcastatus

jcfaleltdef（Windows限定）

jcfaleltreload（Windows限定）

jcfaleltstart（Windows限定）

jcfaleltstat（Windows限定）

jcfaleltstop（Windows限定）

jcfallogdef

jcfallogreload

jcfallogstart

jcfallogstat

jcfallogstop

jcfcolvmesx

jcfcolvmscvmm（Windows限定）

jcfcolvmvc

jcfcolvmvirtage

jcfdbsetup

jcfdbunsetup

jcfexport

jcfimport

jcfmkcsdata

jcfmkhostsdata

jcfthreaddmp（Windows限定）

jcfview（Windows限定）

jcfvirtualchstat

jco_killall.cluster（UNIX限定）

jco_spmd_reload

jco_spmd_status

jco_start（UNIX限定）

jco_start.cluster（UNIX限定）

jco_stop（UNIX限定）

jco_stop.cluster（UNIX限定）

jcoappexecfcheck

jcoattrfcheck

jcochafmode

jcochcefmode

jcochdisc

jcochfilter

jcochstat

jcodbsetup

jcodbunsetup

jcoedsstatus

jcoegschange

jcoegscheck

jcoegsstart

jcoegsstatus

jcoegsstop

jcoevtreport

jcofuncfcheck

jcogencore

jcohctest

jcoimdef

jcomonitorfcheck

jcothreaddmp（Windows限定）

jcovcfsetup（Windows限定）

jcoview（Windows限定）

jcoview_log.bat（Windows限定）

jcschstat

jcsdbexport

jcsdbimport

jcsdbsetup

jcshostsexport

jcshostsimport

jim_log.bat（Windows限定）

jim_log.sh（UNIX限定）

jimdbbackup

jimdbreclaim

jimdbrecovery

jimdbrorg

jimdbstatus

jimdbstop

jimdbupdate

jp1cc_setup（UNIX限定）

jp1cc_setup_cluster（UNIX限定）

jp1cf_setup（UNIX限定）

jp1cf_setup_cluster（UNIX限定）

jp1cfhasetup（Windows限定）

jp1cohasetup（Windows限定）

jp1cohaverup

jp1cs_setup（UNIX限定）

jp1cs_setup_cluster（UNIX限定）

jp1cshasetup（Windows限定）

jp1cshaverup（UNIX限定）

jp1cshaverup.bat（Windows限定）

jp1csverup（UNIX限定）

jp1csverup.bat（Windows限定）

SpmSetSvcCon（Windows限定）

2.　定義ファイル

定義ファイル一覧

定義ファイルの記述形式

ユーザー独自のイベント属性を表示するための定義ファイルについて

構成定義ファイル（jbs_route.conf）

環境変数ファイル

ホストグループ定義ファイル

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

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

発生元ホストマッピング定義ファイル（user_hostmap.conf）

自動アクション環境定義ファイル（action.conf.update）

自動アクション定義ファイル（actdef.conf）

自動アクション定義ファイル（actdef.conf）（互換用）

自動アクション通知定義ファイル（actnotice.conf）

イベント条件表示項目定義ファイル（attr_list.conf）

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

拡張起動プロセス定義ファイル（jp1co_service.conf）

IMパラメーター定義ファイル（jp1co_param_V7.conf）

システムプロファイル（.system）

ユーザープロファイル（defaultUser | profile_ユーザー名）

通信環境定義ファイル（console.conf.update）

ヘルスチェック定義ファイル（jcohc.conf）

WWWページ版動作定義ファイル（console_ja.html）

イベントガイド情報ファイル（jco_guide.txt）

システムカラー定義ファイル（systemColor.conf）

イベント拡張属性定義ファイル

共通除外条件拡張定義ファイル

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

対処状況イベント定義ファイル（processupdate.conf）

相関イベント発行システムプロファイル（egs_system.conf）

相関イベント発行定義ファイル

相関イベント発行環境定義ファイル

インシデント登録用システムプロファイル（eds_system.conf）

インシデント手動登録定義ファイル（incident.conf）

インシデント登録環境定義ファイル（jcdmain.conf.update）

ホスト情報ファイル（jcs_hosts）

ガイド情報ファイル（jcs_guide_xxx.txt）

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）

対処済み連動設定ファイル（action_complete_xxx.conf）

状態変更イベント自動削除設定ファイル

監視オブジェクト初期化設定ファイル

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）

オブジェクトタイプ定義ファイル

アプリケーション実行定義ファイル

CMホスト定義ファイル（jcs_atc_cm_host.conf）

状態変更条件メモリー常駐機能の設定ファイル

重大度変更定義ファイル（jcochsev.conf）

通信環境定義ファイル（view.conf.update）

通信環境定義ファイル（tree_view.conf.update）

IM-View設定ファイル（tuning.conf）

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

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

統合機能メニュー定義ファイル

コマンドボタン定義ファイル（cmdbtn.conf）

起動プログラム定義ファイル（!JP1_CS_APP0.conf）

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）

ツリー構成ファイル

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

セットアップ情報ファイル（jimdbsetupinfo.conf）

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

イベントレポート出力の項目ファイル

イベントレポート出力のフィルターファイル

定義ファイルのステートメントの詳細

3.　JP1イベント

3.1　JP1イベントの属性

3.1.1　基本属性

3.1.2　拡張属性

3.2　JP1/IMが出力するJP1イベント

3.2.1　JP1/IMが出力するJP1イベント一覧

3.2.2　JP1イベントの詳細

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

4.1　システム監視オブジェクト対応製品一覧

4.2　JP1/AJS用システム監視オブジェクト

4.2.1　「AJS監視」システム監視オブジェクト

4.2.2　「ジョブネット監視(AJS)」システム監視オブジェクト

4.3　JP1/Cm2/SSO用システム監視オブジェクト

4.4　JP1/PFM用システム監視オブジェクト

4.4.1　「エージェント監視(PFM)」システム監視オブジェクト

4.5　JP1/PAM用システム監視オブジェクト

4.5.1　「メトリック監視(PAM)」システム監視オブジェクト

4.5.2　「オブジェクト監視(PAM)」システム監視オブジェクト

4.6　JP1/SCIM用システム監視オブジェクト

4.6.1　「SCIM監視」システム監視オブジェクト

4.6.2　「セキュリティ監視（SCIM）」システム監視オブジェクト

4.7　JP1/NETM/DM用システム監視オブジェクト

4.7.1　「NETM/DM監視」システム監視オブジェクト

4.7.2　「配布ジョブ監視(NETM/DM)」システム監視オブジェクト

4.8　JP1/Cm2/NNMi用システム監視オブジェクト

4.8.1　「NNMi監視(NNMi)」システム監視オブジェクト

4.8.2　「ノード監視(NNMi)」システム監視オブジェクト

4.9　JP1/Cm2/NNM用システム監視オブジェクト

4.10　JP1/IM - Manager用システム監視オブジェクト

4.10.1　「IM監視」システム監視オブジェクト

4.11　Cosminexus用システム監視オブジェクト

4.11.1　「論理サーバ監視(Cosminexus)」システム監視オブジェクト

4.11.2　「J2EEアプリケーション監視(Cosminexus)」システム監視オブジェクト

4.12　HiRDB用システム監視オブジェクト

4.12.1　「HiRDB監視」システム監視オブジェクト

4.13　JP1/ServerConductor用システム監視オブジェクト

4.13.1　「物理ホスト監視（System Manager）」システム監視オブジェクト

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

5.1　「業務指向ツリー」の監視ツリーモデル

5.2　「サーバ指向ツリー」の監視ツリーモデル

5.3　「システム構成ツリー」の監視ツリーモデル

索引

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

All Rights Reserved. Copyright (C) 2009, 2011, Hitachi, Ltd.

前書き

■ 対象製品

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

適用OS：Windows Server 2003，Windows XP Professional

P-242C-6H94　 JP1/Integrated Management - View　 09-50

適用OS：Windows 7，Windows Server 2008，Windows Vista

P-2A2C-6H94　 JP1/Integrated Management - View　 09-50

適用OS：Windows Server 2003

P-242C-8E94　 JP1/Integrated Management - Manager　 09-50

適用OS：Windows Server 2008

P-2A2C-8E94　 JP1/Integrated Management - Manager　 09-50

適用OS：Solaris

P-9D2C-8E91　 JP1/Integrated Management - Manager　 09-50

適用OS：AIX

P-1M2C-8E91　 JP1/Integrated Management - Manager　 09-50

適用OS：HP-UX (IPF)

P-1J2C-8E91　 JP1/Integrated Management - Manager　 09-50

適用OS：Linux 5 (AMD/Intel 64)，Linux 5 (x86)，Linux 5 Advanced Platform (AMD/Intel 64)，Linux 5 Advanced Platform (x86)

P-9S2C-8E91　 JP1/Integrated Management - Manager　 09-50

適用OS：Linux 5 (IPF)，Linux 5 Advanced Platform (IPF)

P-9V2C-8E91　 JP1/Integrated Management - Manager　 09-50

■ 輸出時の注意

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

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
BSAFEは，EMC Corporationの米国およびその他の国における登録商標または商標です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
J2EEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDBCは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
MicrosoftおよびHyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corporationの商品名称です。
NetInsightは，株式会社日立ソリューションズの登録商標です。
Netscapeは，米国およびその他の国におけるNetscape Communications Corporationの登録商標です。
POSIXは，the Institute of Electrical and Electronics Engineers, Inc. (IEEE)で制定された標準仕様です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
RSAは，EMC Corporationの米国およびその他の国における登録商標または商標です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Sunは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Sun Microsystemsは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
TELstaffは，株式会社日立ソリューションズの登録商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
VMwareおよびESXは，VMware, Inc.の米国および各国での登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
プログラムプロダクト「P-9D2C-8E91」には，Oracle Corporationまたはその子会社，関連会社が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-8E91」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。
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.
This product includes software developed by IAIK of Graz University of Technology.
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/).

本製品は，EMC CorporationのRSA(R) BSAFETMソフトウェアを搭載しています。

■ 発行

2011年9月　3020-3-R80-51

■ 著作権

All Rights Reserved. Copyright (C) 2009, 2011, Hitachi, Ltd.

変更内容

変更内容(3020-3-R80-51)　JP1/Integrated Management - Manager　09-50，JP1/Integrated Management - View　09-50

追加・変更内容
変更個所

次のコマンドの機能概要に同時に実行できるコマンド数の説明を追加した。

jcfaleltdef（Windows限定）コマンド

jcfaleltreload（Windows限定）コマンド

jcfaleltstart（Windows限定）コマンド

jcfaleltstat（Windows限定）コマンド

jcfaleltstop（Windows限定）コマンド

jcfallogdefコマンド

jcfallogreloadコマンド

jcfallogstartコマンド

jcfallogstatコマンド

jcfallogstopコマンド

jcfexportコマンド

jcfimportコマンド

jcfvirtualchstatコマンド

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. jcfexport，1. jcfimport，
1. jcfvirtualchstat

次のコマンドに-filterオプションを追加した。

jcfaleltdef（Windows限定）コマンド

jcfaleltstart（Windows限定）コマンド

jcfallogdefコマンド

jcfallogstartコマンド

1. jcfaleltdef（Windows限定），1. jcfaleltstart（Windows限定），1. jcfallogdef，1. jcfallogstart

次のコマンドに戻り値の説明を変更した。

jcfaleltdef（Windows限定）コマンド（戻り値：21）

jcfaleltreload（Windows限定）コマンド（戻り値：12，21）

jcfaleltstart（Windows限定）コマンド（戻り値：21）

jcfaleltstat（Windows限定）コマンド（戻り値：1，21）

jcfaleltstop（Windows限定）コマンド（戻り値：12，21）

jcfallogdefコマンド（戻り値：8，21）

jcfallogreloadコマンド（戻り値：21）

jcfallogstartコマンド（戻り値：8，21）

jcfallogstatコマンド（戻り値：1，21）

jcfallogstopコマンド（戻り値：12，15，21）

jcfexportコマンド（戻り値：21）

jcfimportコマンド（戻り値：21）

jcfview（Windows限定）コマンド（戻り値：5）

jcfvirtualchstatコマンド（戻り値：21）

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. jcfexport，
1. jcfimport，1. jcfview（Windows限定），
1. jcfvirtualchstat

次のコマンドの戻り値の説明を削除した。

jcfaleltdef（Windows限定）コマンド（戻り値：13）

jcfaleltstat（Windows限定）コマンド（戻り値：10，13）

jcfaleltstop（Windows限定）コマンド（戻り値：16）

jcfallogdefコマンド（戻り値：13）

jcfallogreloadコマンド（戻り値：8）

jcfallogstatコマンド（戻り値：10，13）

jcfallogstopコマンド（戻り値：16）

1. jcfaleltdef（Windows限定），1. jcfaleltstat（Windows限定），1. jcfaleltstop（Windows限定），1. jcfallogdef，1. jcfallogreload，1. jcfallogstat，1. jcfallogstop

jcfaleltreloadコマンドに，jcfaleltdefコマンドまたは［プロファイル表示/編集］画面で起動オプションを変更した場合は，リロードしても反映されないという説明を追加した。
1. jcfaleltreload（Windows限定）

次のコマンドの-oオプションの説明を変更した。

jcfaleltstart（Windows限定）コマンド

jcfallogstartコマンド

1. jcfaleltstart（Windows限定），1. jcfallogstart

jcfallogdefコマンドの機能概要に，プロファイルを削除する場合の説明を追加した。
1. jcfallogdef

次のコマンドの-cオプションの説明を変更した。

jcfallogdefコマンド

jcfallogstartコマンド

1. jcfallogdef，1. jcfallogstart

次のコマンドの-rオプションの説明を変更した。

jcfallogdefコマンド

jcfallogstartコマンド

1. jcfallogdef，1. jcfallogstart

jcfallogreloadコマンドに，jcfaleltdefコマンドまたは［プロファイル表示/編集］画面でMARKSTRおよびACTDEFパラメーター以外の値を変更した場合は，リロードしても反映されないという説明を追加した。
1. jcfallogreload

jcfdbunsetupコマンドを実行したあとに削除するファイルの説明を追加した。
1. jcfdbunsetup

jcfimportコマンドの機能概要に，リモート監視中の説明を追加した。
1. jcfimport

JP1/IM - Managerをインストールすると自動生成される，IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）を追加した。
2. 定義ファイル一覧，2. IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

リモート監視ログファイルトラップ動作定義ファイルのHEADLINEに，文字列の上限サイズの説明を追加した。
また，定義例を追加した。
2. リモート監視ログファイルトラップ動作定義ファイル

定義例を追加した。
2. リモート監視イベントログトラップ動作定義ファイル

セットアップ情報ファイル（jimdbsetupinfo.conf）にIMDBHOSTNAMEを追加した。
2. セットアップ情報ファイル（jimdbsetupinfo.conf）

JP1イベントIDを追加した。
00003F68，00003F69，00003FC5，00003FD1，00003FD4，00003FD5，ACTDEFパラメーターに指定されている値，00003A71
3. JP1イベント

JP1イベントの発行契機，およびメッセージを変更した。
00003FD3
3. JP1イベント

イベントID：00003FD0の詳細のログ種別を削除した。
3.2.2(71)

イベントID：00003FD2の詳細の固有情報に次の項目を追加した。

エラー発生API名

監視対象ホスト名

3.2.2(73)

イベントID：00003FD3の詳細の固有情報に次の項目を追加した。

監視対象ホスト名

3.2.2(74)

変更内容(3020-3-R80-50)　JP1/Integrated Management - Manager　09-50，JP1/Integrated Management - View　09-50

追加・変更内容
変更個所

jimdbupdateコマンドを追加し，IMデータベースをアップデートできるようにした。
1. コマンド一覧，1. jimdbupdate

jcfmkcsdataコマンドの機能概要に，業務グループの監視ツリー情報を追加したセントラルスコープのインポートファイルの生成についての説明を追加した。
1. コマンド一覧

次のコマンドを追加し，リモートの監視対象ホストを管理できるようにした。

jcfaleltdef（Windows限定）コマンド

jcfaleltreload（Windows限定）コマンド

jcfaleltstart（Windows限定）コマンド

jcfaleltstat（Windows限定）コマンド

jcfaleltstop（Windows限定）コマンド

jcfallogdefコマンド

jcfallogreloadコマンド

jcfallogstartコマンド

jcfallogstatコマンド

jcfallogstopコマンド

1. コマンド一覧，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

jcochcefmodeコマンドを追加し，共通除外条件の動作モードを変更できるようにした。
1. コマンド一覧，1. jcochcefmode

jcashowaコマンドの-dオプションの説明を変更した。また秒単位の指定についての説明を追加した。
1. jcashowa

次のコマンドの説明に注意事項を追加した。

Jcfdbsetup

jcfdbunsetup

jcodbsetup

jcodbunsetup

1. jcfdbsetup，1. jcodbsetup，1. jcodbunsetup

次のコマンドに-ｒオプションと-gオプションを追加した。

jcfexport

jcfimport

1. jcfexport，1. jcfimport

jcfmkcsdataコマンドに-gオプションを追加した。また，戻り値「11」を追加した。
1. jcfmkcsdata

jco_spmd_reloadコマンドを実行したときに有効になる定義ファイルに次のファイルを追加した。

イベント条件表示項目定義ファイル（attr_list.conf）

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

1. jco_spmd_reload

jco_start（UNIX限定）コマンドの機能説明にシステム開始時とJP1/IM - Managerを手動で起動する場合の注意事項を追加した。
1. jco_start（UNIX限定）

jco_stop（UNIX限定）コマンドの機能説明にJP1/IM - Managerを手動で停止する場合の注意事項を追加した。
1. jco_stop（UNIX限定）

jcochfilterコマンドに次のオプションを追加した。

-on

-off

-ef

-check

1. jcochfilter

jcoevtreportコマンドの機能説明にCSVの出力形式を参照する場合の参照先の記述を追加し，-fオプションのオペランド名を変更した。
1. jcoevtreport

jcoimdefコマンドに次のオプションを追加した。

-cmdbtn

-hostmap

-bizmonmode

-ignorecasehost

1. jcoimdef

次のコマンドにJP1/IM - MOを使用している場合の注意事項を追加した。

jimdbbackup

jimdbrecovery

jimdbrorg

jimdbstop

1. jimdbbackup，1. jimdbrecovery，1. jimdbrorg，1. jimdbstop

リモート監視のログトラップ機能の動作を定義するためのリモート監視ログファイルトラップ動作定義ファイルを追加した。
2. 定義ファイル一覧，2. リモート監視ログファイルトラップ動作定義ファイル

リモート監視のイベントログトラップ機能の動作を定義するためのリモート監視イベントログトラップ動作定義ファイルを追加した。
2. 定義ファイル一覧，2. リモート監視イベントログトラップ動作定義ファイル

発生元ホストマッピングの機能で，発生元ホストをマッピングするJP1イベントの条件とマッピング元を定義するための，発生元ホストマッピング定義ファイル（user_hostmap.conf）を追加した。
2. 定義ファイル一覧，2. 発生元ホストマッピング定義ファイル（user_hostmap.conf）

自動アクション環境定義ファイル（action.conf.update）の"ACTIONLIMIT"=dword:16進数値で指定できる値を追加した。
2. 自動アクション環境定義ファイル（action.conf.update）

イベント一覧に使用する色の設定を定義するためのシステムカラー定義ファイル（systemColor.conf）を追加した。
2. 定義ファイル一覧，2. システムカラー定義ファイル（systemColor.conf）

共通除外条件の拡張モードのイベント条件や適用期間を定義するための，共通除外条件拡張定義ファイルを追加した。
2. 定義ファイル一覧，2. 共通除外条件拡張定義ファイル

［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示する項目を定義するための共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）を追加した。
2. 定義ファイル一覧，2. 共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

［コマンド実行］画面に表示する［コマンド］ボタンを定義するためのコマンドボタン定義ファイル（cmdbtn.conf）を追加した。
2. 定義ファイル一覧，2. コマンドボタン定義ファイル（cmdbtn.conf）

次のファイルのイベント条件で指定できる属性名に発生元ホストのマッピングで使用するための発生元ホスト名を追加した。

自動アクション定義ファイル（actdef.conf）

ユーザープロファイル（defaultUser | profile_ユーザー名）

イベントガイド情報ファイル（jco_guide.txt）

相関イベント発行定義ファイル

重大度変更定義ファイル（jcochsev.conf）

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

2. 自動アクション定義ファイル（actdef.conf），2. ユーザープロファイル（defaultUser | profile_ユーザー名），2. イベントガイド情報ファイル（jco_guide.txt），2. 相関イベント発行定義ファイル，2. 重大度変更定義ファイル（jcochsev.conf），2. モニター画面呼び出し定義ファイル

自動アクション定義ファイル（actdef.conf）ホスト名に指定できる項目に，業務グループ名および監視グループ名を追加した。
2. 自動アクション定義ファイル（actdef.conf）

自動アクション定義ファイル（actdef.conf）のアクション定義で使用できる変数の表に記載されている注釈を変更した。
2. 自動アクション定義ファイル（actdef.conf）

イベント条件表示項目定義ファイル（attr_list.conf）に指定できる表示項目に発生元ホストのマッピングで使用する発生元ホスト名を追加した。
2. イベント条件表示項目定義ファイル（attr_list.conf）

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）の説明を補足した。
2. イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

ヘルスチェック定義ファイル（jcohc.conf）のFAILOVERの説明にヘルスチェック機能で異常を検知したときの説明を追加した。
2. ヘルスチェック定義ファイル（jcohc.conf）

イベントガイド情報ファイル（jco_guide.txt）のDESC_VERSIONおよびEV_FILEの説明を変更した。
2. イベントガイド情報ファイル（jco_guide.txt）

イベントガイド情報ファイル（jco_guide.txt）にEV_USERを追加した。
また，イベントガイドメッセージの置き換え文字についての説明を追加した。
2. イベントガイド情報ファイル（jco_guide.txt）

相関イベント発行定義ファイルの属性値の最大サイズを追加した。
2. 相関イベント発行定義ファイル

相関イベント発行定義ファイルで属性名に指定できない拡張属性の説明を変更した。
2. 相関イベント発行定義ファイル

相関イベント発行定義ファイルの相関成立イベントの説明を追加した。
2. 相関イベント発行定義ファイル

インシデント手動登録定義ファイル（incident.conf）にJP1/IM - Service Supportと連携するための説明を追加した。
2. インシデント手動登録定義ファイル（incident.conf）

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）の一覧に，JP1/IM - Managerと連携できるバージョンおよび対応OSを追加した。
2. WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）の説明中の［IM構成編集］画面を［エージェント構成編集］画面に変更した。
また，［リモート監視構成編集］画面の記述を追加した。
2. IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）のONLINEHOSTNAMEの説明に実行系のホスト名に関する記述を追加した。
2. クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

イベントレポート出力の項目ファイルの項目名の説明を変更した。
2. イベントレポート出力の項目ファイル

イベントレポート出力のフィルターファイルにイベント条件で指定できる属性名，比較キーワードおよびオペランドの説明を追加した。
2. イベントレポート出力のフィルターファイル

JP1イベントIDを追加した。
00003F22，00003F23，00003F24，00003F63，00003F64，00003F66，00003F67，00003FC0，00003FC1，00003FC2，00003FC3，00003FD0，00003FD2，00003FD3
3. JP1イベント

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

はじめに

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

対象読者

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

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

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

マニュアルの構成

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

第1章　コマンド

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

第2章　定義ファイル

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

第3章　JP1イベント

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

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

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

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

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

関連マニュアル

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

JP1/IM関連

JP1 Version 9 JP1/Integrated Management - Manager クイックリファレンス（3020-3-R75）

JP1 Version 9 JP1/Integrated Management - Manager 導入・設計ガイド（3020-3-R76）

JP1 Version 9 JP1/Integrated Management - Manager 構築ガイド（3020-3-R77）

JP1 Version 9 JP1/Integrated Management - Manager 運用ガイド（3020-3-R78）

JP1 Version 9 JP1/Integrated Management - Manager 画面リファレンス（3020-3-R79）

JP1 Version 9 JP1/Integrated Management - Manager メッセージ（3020-3-R81）

JP1 Version 9 JP1/Integrated Management - Event Gateway for Network Node Manager i（3020-3-R82）

JP1 Version 9 JP1/Integrated Management - Rule Operation 構築・運用ガイド（3020-3-R83）

JP1 Version 9 JP1/Integrated Management - Rule Operation 画面リファレンス（3020-3-R84）

JP1 Version 9 JP1/Integrated Management - TELstaff JP1/Integrated Management - TELstaff Alarm View 構築・運用ガイド（3020-3-R85）

JP1 Version 9 JP1/Integrated Management - Message Optimizer（3020-3-R86）

JP1 Version 9 JP1/Integrated Management - Service Support 構築・運用ガイド（3020-3-R91）

JP1 Version 9 JP1/Integrated Management - Service Support 操作ガイド（3020-3-R92）

JP1 Version 8 JP1/Integrated Management - Central Information Master システム構築・運用ガイド（3020-3-K04）

JP1 Version 8 JP1/Integrated Management - Central Information Master リファレンス（3020-3-K05）

JP1 Version 8 JP1/Integrated Management - Incident Master（3020-3-K09）

JP1関連

JP1 Version 9 JP1/Base 運用ガイド（3020-3-R71）

JP1 Version 9 JP1/Base メッセージ（3020-3-R72）

JP1 Version 9 JP1/Base 関数リファレンス（3020-3-R73）

マニュアルの体系

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

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

このマニュアルでの表記

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

このマニュアルでの表記
正式名称

AIX
AIX 5L 5.3

AIX 6.1

BJEX
uCosminexus Batch Job Execution Server

Cosminexus
Cosminexus Application Server
Cosminexus Application Server Enterprise Version 6

Cosminexus Application Server Standard Version 6

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

HNTRLib
Hitachi Network Objectplaza Trace Library

HNTRLib2
Hitachi Network Objectplaza Trace Library 2

HP-UX
HP-UX (IPF)
HP-UX 11i V2 (IPF)

HP-UX 11i V3 (IPF)

Hyper-V
Microsoft(R) Hyper-V(TM) 1.0

Microsoft(R) Hyper-V(TM) 2.0

IE
Microsoft Internet Explorer
Microsoft(R) Internet Explorer(R)

Windows Internet Explorer
Windows(R) Internet Explorer(R)

IIS
Internet Information Services
Microsoft(R) Internet Information Services 5.01以降

JP1/AJS
JP1/AJS2 - Advanced Manager
JP1/Automatic Job Management System 2 - Advanced Manager

JP1/AJS - Agent
JP1/Automatic Job Management System 2 - Agent

JP1/Automatic Job Management System 3 - Agent

JP1/AJS - Manager
JP1/Automatic Job Management System 2 - Manager

JP1/Automatic Job Management System 3 - Manager

JP1/AJS - View
JP1/Automatic Job Management System 2 - View

JP1/Automatic Job Management System 3 - View

JP1/AJS2 - Scenario Operation View
JP1/Automatic Job Management System 2 - Scenario Operation View

JP1/AJS2 - View for Mainframe
JP1/Automatic Job Management System 2 - View for Mainframe

JP1/Cm2/ESA
JP1/Cm2/Extensible SNMP Agent

JP1/Cm2/Extensible SNMP Agent for Extension Mib Runtime

JP1/Cm2/SSO
JP1/Cm2/SSO
JP1/Cm2/SNMP System Observer

JP1/PFM/SSO
JP1/Performance Management/Distributed SNMP System Observer

JP1/Performance Management/SNMP System Observer

JP1/SSO
JP1/Distributed Server System Observer

JP1/Server System Observer

JP1/FTP
JP1/File Transmission Server/FTP

JP1/Integrated ManagementまたはJP1/IM
バージョン7製品

JP1/IM - Central Console
またはJP1/IM - CC
JP1/Integrated Manager - Central Console

JP1/IM - Central Console 10 Node
またはJP1/IM - CC 10 Node
JP1/Integrated Manager - Central Console 10 Node

JP1/IM - Central Console アップグレード
またはJP1/IM - CC アップグレード
JP1/Integrated Manager - Central Console アップグレード

JP1/IM - Central Information Master
またはJP1/IM - CM※
JP1/Integrated Manager - Central Information Master

JP1/IM - Central Scope
またはJP1/IM - CS
JP1/Integrated Manager - Central Scope

JP1/IM - Incident Master
またはJP1/IM - IDM※
JP1/Integrated Manager - Incident Master

JP1/IM - TELstaff※
JP1/Integrated Manager - TELstaff

JP1/Integrated Manager - TELstaff Alarm View

JP1/IM - View
JP1/Integrated Manager - View

バージョン8製品

JP1/IM - Central Information Master
またはJP1/IM - CM※
JP1/Integrated Management - Central Information Master

JP1/IM - Incident Master
またはJP1/IM - IDM※
JP1/Integrated Management - Incident Master

JP1/IM - Manager
JP1/Integrated Management - Manager

JP1/IM - Rule Operation
またはJP1/IM - RL※
JP1/Integrated Management - Rule Operation

JP1/IM - Service Support
またはJP1/IM - SS※
JP1/Integrated Management - Service Support

JP1/IM - TELstaff※
JP1/Integrated Management - TELstaff

JP1/Integrated Management - TELstaff Alarm View

JP1/IM - View
JP1/Integrated Management - View

バージョン9製品

JP1/IM - Event Gateway for Network Node Manager i
またはJP1/IM - EG for NNMi※
JP1/Integrated Management - Event Gateway for Network Node Manager i

JP1/IM - Manager
JP1/Integrated Management - Manager

JP1/IM - Message Optimizer Assistant
またはJP1/IM - MO※
JP1/Integrated Management - Message Optimizer

JP1/Integrated Management - Message Optimizer Assistant

JP1/IM - Rule Operation
またはJP1/IM - RL※
JP1/Integrated Management - Rule Operation

JP1/IM - Service Support
またはJP1/IM - SS※
JP1/Integrated Management - Service Support

JP1/IM - TELstaff※
JP1/Integrated Management - TELstaff

JP1/Integrated Management - TELstaff Alarm View

JP1/IM - View
JP1/Integrated Management - View

JP1/NetInsight II - Facility Manager
JP1/NetInsight(R) II - Facility Manager

JP1/NetInsight(R) II - Facility Manager Standard

JP1/NetInsight(R) II - Facility Manager Upgrade License

JP1/NPS
JP1/Network Printing System

JP1/PAM
JP1/PA - Adaptor
JP1/Performance Analysis - Adaptor

JP1/Performance Management - Analysis Adaptor

JP1/PA - Manager
JP1/Performance Analysis - Manager

JP1/Performance Management - Analysis Manager

JP1/PA - View
JP1/Performance Analysis - View

JP1/Performance Management - Analysis View

JP1/PFM
JP1/PFM - Agent
JP1/Performance Management - Agent for Platformなどのエージェント製品群

JP1/PFM - Manager
JP1/Performance Management - Manager

JP1/PFM - View
JP1/Performance Management - View

JP1/PFM - Web Console
JP1/Performance Management - Web Console

JP1/PFM/SSO for Application Server
JP1/Performance Management/SNMP System Observer for Application Server

JP1/SC/CM
JP1/ServerConductor/Control Manager

JP1/ServerConductor
JP1/ServerConductor
JP1/ServerConductor/Advanced Agent

JP1/ServerConductor/Agent

JP1/ServerConductor/Blade Server Manager

JP1/ServerConductor/Blade Server Manager Plus

JP1/ServerConductor/Server Manager

ServerConductor
ServerConductor/Advanced Agent

ServerConductor/Agent

ServerConductor/Blade Server Manager

ServerConductor/Server Manager

System Manager
System Manager - Advanced Agent

System Manager - Management Console

System Manager - Server Agent

System Manager - Server Agent for HP-UX

JP1/SES
JP1/System Event Service

Linux
Linux 5 (AMD/Intel 64)
Red Hat Enterprise Linux(R) 5 (AMD/Intel 64)

Linux 5 (IPF)
Red Hat Enterprise Linux(R) 5 (IPF)

Linux 5 (x86)
Red Hat Enterprise Linux(R) 5 (x86)

Linux 5 Advanced Platform (AMD/Intel 64)
Red Hat Enterprise Linux(R) 5 Advanced Platform (AMD/Intel 64)

Linux 5 Advanced Platform (IPF)
Red Hat Enterprise Linux(R) 5 Advanced Platform (IPF)

Linux 5 Advanced Platform (x86)
Red Hat Enterprise Linux(R) 5 Advanced Platform (x86)

NNM
HP NNM
HP Network Node Manager Software バージョン6以前

HP Network Node Manager Starter Edition Software バージョン7.5以前

JP1/Cm2/NNM
JP1/Cm2/Network Node Manager バージョン7以前

JP1/Cm2/Network Node Manager Starter Edition 250 バージョン8以前

JP1/Cm2/Network Node Manager Starter Edition Enterprise バージョン8以前

NNMi
HP NNMi
HP Network Node Manager i Software v8.10

JP1/Cm2/NNMi
JP1/Cm2/Network Node Manager i 09-00以降

SCIM
JP1/SCIM
JP1/Security Integrated Manager

SCVMM
Microsoft(R) System Center Virtual Machine Manager 2008

Solaris
Solaris 9

Solaris 10

vCenter
VMware vCenter Server

Virtage
日立サーバ仮想機構「Virtage」

VMware
VMware(R) ESX 3.5

VMware(R) ESX 4.0

Windows 2000
Microsoft(R) Windows(R) 2000 Advanced Server Operating System

Microsoft(R) Windows(R) 2000 Professional Operating System

Microsoft(R) Windows(R) 2000 Server Operating System

Windows 7
Microsoft(R) Windows(R) 7 Enterprise

Microsoft(R) Windows(R) 7 Professional

Microsoft(R) Windows(R) 7 Ultimate

Windows Server 2003
Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Enterprise Edition

Microsoft(R) Windows Server(R) 2003, Standard Edition

Windows Server 2003 (IPF)
Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium-based Systems

Windows Server 2003 (x64)
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition

Microsoft(R) Windows Server(R) 2003, Standard x64 Edition

Windows Server 2003 R2
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition

Microsoft(R) Windows Server(R) 2003 R2, Standard Edition

Windows Server 2003 R2 (x64)
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition

Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition

Windows Server 2008
Windows Server 2008
Microsoft(R) Windows Server(R) 2008 Enterprise

Microsoft(R) Windows Server(R) 2008 Standard

Windows Server 2008 (IPF)
Microsoft(R) Windows Server(R) 2008 for Itanium-based Systems

Windows Server 2008 (x64)
Microsoft(R) Windows Server(R) 2008 Enterprise x64

Microsoft(R) Windows Server(R) 2008 Standard x64

Windows Server 2008 R2 (x64)
Microsoft(R) Windows Server(R) 2008 R2 Datacenter x64

Microsoft(R) Windows Server(R) 2008 R2 Enterprise x64

Microsoft(R) Windows Server(R) 2008 R2 Standard x64

Windows Vista
Microsoft(R) Windows Vista(R) Business

Microsoft(R) Windows Vista(R) Enterprise

Microsoft(R) Windows Vista(R) Ultimate

Windows XP Professional
Microsoft(R) Windows(R) XP Professional Operating System

注※　JP1/IM - Central Information Master，JP1/IM - Incident Master，JP1/IM - Rule Operation，JP1/IM - Service Support，JP1/IM - TELstaff，JP1/IM - Message Optimizer Assistant，およびJP1/IM - Event Gateway for Network Node Manager iについては，このマニュアルで説明するJP1/IM - Manager，JP1/IM - Viewに関連する機能概要だけ説明しています。

Windows 2000，Windows XP Professional，Windows Server 2003，Windows Vista，Windows Server 2008およびWindows 7を総称してWindowsと表記することがあります。

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

このマニュアルで使用する英略語

このマニュアルで使用する英略語を次に示します。

英略語 | 正式名称
AMD | Advanced Micro Devices
ASCII | American Standard Code for Information Interchange
CMT | Container-Managed Transaction
CRLF | Carriage Return/Line Feed
CSV | Comma Separated Value
DB | Database
DBMS | Database Management System
DNS | Domain Name System
FQDN | Fully Qualified Domain Name
GMT | Greenwich Mean Time
GUI | Graphical User Interface
HTML | Hyper Text Markup Language
HTTP | HyperText Transfer Protocol
IP | Internet Protocol
IPF | Itanium(R) Processor Family
ISAM | Indexed Sequential Access Method
J2EE | Java(TM)2 Platform Enterprise Edition
Java VM | Java(TM) Virtual Machine
JDBC | Java(TM) DataBase Connectivity
JIS | Japanese Industrial Standards
LAN | Local Area Network
NAT | Network Address Translator
NIC | Network Interface Card
NTP | Network Time Protocol
OTS | Object Transaction Service
POSIX | Portable Operating System Interface for UNIX
SFO | Session Fail Over
SNMP | Simple Network Management Protocol
TCP/IP | Transmission Control Protocol/Internet Protocol
TXT | Text
UAC | User Account Control
UCS | Universal Multiple-Octet Coded Character Set
UNC | Universal Naming Convention
URL | Uniform Resource Locator
UTC | Universal Time Coordinated
UTF | UCS Transformation Format
WAN | Wide Area Network
WWW | World Wide Web

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

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

記号
意味

［　］
メニュー項目，画面名，ボタン名，およびキーボードのキーなどを示す。
例
メニュー項目：［新規作成］
画面名：［ログイン］画面
ボタン名：［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

注※　各製品をデフォルトのままインストールした場合のインストール先フォルダを表しています。

Windows 7，Windows Server 2008およびWindows Vistaの場合，「システムドライブ:¥Program Files」と表記している部分は，インストール時のOS環境変数によって決定されるため，環境によって異なる場合があります。

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

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

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

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

Microsoft Internet Explorer 6.0以降

Windows Internet Explorer 7以降

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

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

JP1/IM - View：［ヘルプ］－［目次］を選択する。または，スタートメニューから［プログラム］－［JP1_Integrated Management - View］－［ヘルプ］を選択する。

注意事項

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

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

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

1.　コマンド

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

＜この章の構成＞

コマンドの記述形式

コマンド一覧

jcacancel

jcachange

jcadefconv

jcamakea

jcashowa

jcastatus

jcfaleltdef（Windows限定）

jcfaleltreload（Windows限定）

jcfaleltstart（Windows限定）

jcfaleltstat（Windows限定）

jcfaleltstop（Windows限定）

jcfallogdef

jcfallogreload

jcfallogstart

jcfallogstat

jcfallogstop

jcfcolvmesx

jcfcolvmscvmm（Windows限定）

jcfcolvmvc

jcfcolvmvirtage

jcfdbsetup

jcfdbunsetup

jcfexport

jcfimport

jcfmkcsdata

jcfmkhostsdata

jcfthreaddmp（Windows限定）

jcfview（Windows限定）

jcfvirtualchstat

jco_killall.cluster（UNIX限定）

jco_spmd_reload

jco_spmd_status

jco_start（UNIX限定）

jco_start.cluster（UNIX限定）

jco_stop（UNIX限定）

jco_stop.cluster（UNIX限定）

jcoappexecfcheck

jcoattrfcheck

jcochafmode

jcochcefmode

jcochdisc

jcochfilter

jcochstat

jcodbsetup

jcodbunsetup

jcoedsstatus

jcoegschange

jcoegscheck

jcoegsstart

jcoegsstatus

jcoegsstop

jcoevtreport

jcofuncfcheck

jcogencore

jcohctest

jcoimdef

jcomonitorfcheck

jcothreaddmp（Windows限定）

jcovcfsetup（Windows限定）

jcoview（Windows限定）

jcoview_log.bat（Windows限定）

jcschstat

jcsdbexport

jcsdbimport

jcsdbsetup

jcshostsexport

jcshostsimport

jim_log.bat（Windows限定）

jim_log.sh（UNIX限定）

jimdbbackup

jimdbreclaim

jimdbrecovery

jimdbrorg

jimdbstatus

jimdbstop

jimdbupdate

jp1cc_setup（UNIX限定）

jp1cc_setup_cluster（UNIX限定）

jp1cf_setup（UNIX限定）

jp1cf_setup_cluster（UNIX限定）

jp1cfhasetup（Windows限定）

jp1cohasetup（Windows限定）

jp1cohaverup

jp1cs_setup（UNIX限定）

jp1cs_setup_cluster（UNIX限定）

jp1cshasetup（Windows限定）

jp1cshaverup（UNIX限定）

jp1cshaverup.bat（Windows限定）

jp1csverup（UNIX限定）

jp1csverup.bat（Windows限定）

SpmSetSvcCon（Windows限定）

コマンドの記述形式

ここでは，コマンドの記述形式について説明します。

各コマンドで説明する項目は次のとおりです。ただし，コマンドによっては説明しない項目もあります。

機能

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

形式

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

実行権限

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

格納先ディレクトリ

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

引数

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

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

注意事項

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

戻り値

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

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

使用例

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

出力例

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

コマンド一覧

JP1/IMで使用できるコマンドの一覧を次に示します。表中では，Windows，UNIXの対応を凡例のように表記しています。

（凡例）

○：対応している。

－：対応していない。

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

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

注※3　Windows 7，Windows Server 2008，およびWindows Vistaの場合はAdministrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）が必要です。

なお，次節以降のコマンドの説明では，コマンドはアルファベット順に記載されています。

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

JP1/IM - Manager（JP1/IM - Central Console）のセットアップをする
jp1cc_setup（UNIX限定）
－
○
スーパーユーザー

JP1/IM - Manager（JP1/IM - Central Scope）のセットアップをする
jp1cs_setup（UNIX限定）
－
○
スーパーユーザー

JP1/IM - Managerを自動的に起動する
jco_start（UNIX限定）
－
○
スーパーユーザー

JP1/IM - Managerを自動的に終了する
jco_stop（UNIX限定）
－
○
スーパーユーザー

JP1/IM - Managerのプロセスの状態を確認する
jco_spmd_status
○
○
スーパーユーザー※¹

JP1/IM - Managerのプロセスの状態を更新する
jco_spmd_reload
○
○
スーパーユーザー※¹

クラスタシステムで運用するための設定をする
jp1cohasetup（Windows限定）
○
－
スーパーユーザー※¹

jp1cshasetup（Windows限定）
○
－
スーパーユーザー※¹

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限定）
○
－
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

構成情報を格納するIM構成管理DBをセットアップする
jcfdbsetup
○
○
スーパーユーザー※¹

構成情報を格納するIM構成管理DBをアンセットアップする
jcfdbunsetup
○
○
スーパーユーザー※¹

JP1イベントを格納する統合監視DBをセットアップする
jcodbsetup
○
○
スーパーユーザー※¹

JP1イベントを格納する統合監視DBをアンセットアップする
jcodbunsetup
○
○
スーパーユーザー※¹

統合監視DBに登録しているJP1イベントの情報をCSV形式にしてファイルに出力する
jcoevtreport
○
○
スーパーユーザー※¹

IMデータベースをバックアップする
jimdbbackup
○
○
スーパーユーザー※¹

IM構成管理DBの使用中の空き領域（空きページ領域）を解放する
jimdbreclaim
○
○
スーパーユーザー※¹

バックアップで保管しておいたデータベースを復旧（リカバリー）する
jimdbrecovery
○
○
スーパーユーザー※¹

データベースの断片化された空き領域を再編成する
jimdbrorg
○
○
スーパーユーザー※¹

IMデータベースの起動・停止などの稼働状態を確認する
jimdbstatus
○
○
スーパーユーザー※¹

IMデータベースを停止する
jimdbstop
○
○
スーパーユーザー※¹

IMデータベースをアップデートする
jimdbupdate
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

SCVMMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する
jcfcolvmscvmm（Windows限定）
○
－
スーパーユーザー※¹

vCenterから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する
jcfcolvmvc
○
○
スーパーユーザー※¹

Virtageから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する
jcfcolvmvirtage
○
○
スーパーユーザー※¹

VMware ESXから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する
jcfcolvmesx
○
○
スーパーユーザー※¹

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

IM構成管理の情報をインポートする
jcfimport
○
○
スーパーユーザー※¹

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

仮想化構成情報ファイルで，ホスト入力情報ファイルを更新する
jcfmkhostsdata
○
○
スーパーユーザー※¹

指定ホストの仮想化構成を更新する
jcfvirtualchstat
○
○
スーパーユーザー※¹

JP1/IM - ManagerのIM構成管理プロセスの動作環境を設定する
jp1cf_setup（UNIX限定）
－
○
スーパーユーザー

クラスタシステムで運用する場合に，IM構成管理の環境設定をする
jp1cf_setup_cluster（UNIX限定）
－
○
スーパーユーザー

クラスタシステムで運用する場合に，IM構成管理の環境設定をする
jp1cfhasetup（Windows限定）
○
－
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

指定した監視対象ホストに，リモート監視イベントログトラップのプロファイルを定義する
jcfaleltdef（Windows限定）
○
－
スーパーユーザー※¹

リモート監視イベントログトラップ動作定義ファイルをリロードする
jcfaleltreload（Windows限定）
○
－
スーパーユーザー※¹

リモート監視イベントログトラップを起動する
jcfaleltstart（Windows限定）
○
－
スーパーユーザー※¹

リモート監視イベントログトラップの動作状況を表示する
jcfaleltstat（Windows限定）
○
－
スーパーユーザー※¹

リモート監視イベントログトラップを停止する
jcfaleltstop（Windows限定）
○
－
スーパーユーザー※¹

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

リモート監視ログファイルトラップ動作定義ファイルをリロードする
jcfallogreload
○
○
スーパーユーザー※¹

リモート監視ログファイルトラップを起動する
jcfallogstart
○
○
スーパーユーザー※¹

リモート監視ログファイルトラップの動作状況を表示する
jcfallogstat
○
○
スーパーユーザー※¹

リモート監視ログファイルトラップを停止する
jcfallogstop
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

08-50以前のアクション定義ファイルを09-00のアクション定義ファイルに変換する
jcadefconv
○
○
スーパーユーザー※¹

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

バージョン7以前のJP1/Baseのコマンド実行の履歴をバージョン8用のコマンド実行履歴ファイルに移行する
jcocmdconv※2
○
○
スーパーユーザー※1

旧バージョンのJP1/IM - ManagerまたはJP1/IM - Central Consoleで設定した論理ホスト環境をバージョンアップする
jp1cohaverup
○
○
スーパーユーザー※¹

旧バージョンのJP1/IM - Central Scopeの物理ホスト環境をバージョンアップする
jp1csverup.bat（Windows限定）
○
－
スーパーユーザー※¹

旧バージョンのJP1/IM - Central Scopeで設定した論理ホスト環境をバージョンアップする
jp1cshaverup.bat（Windows限定）
○
－
スーパーユーザー※¹

旧バージョンのJP1/IM - Central Scopeの物理ホスト環境をバージョンアップする
jp1csverup（UNIX限定）
－
○
スーパーユーザー

旧バージョンのJP1/IM - Central Scopeで設定した論理ホスト環境をバージョンアップする
jp1cshaverup（UNIX限定）
－
○
スーパーユーザー

ログイン・ログアウトに関するコマンド

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

IM構成管理・ビューアーを起動する
jcfview（Windows限定）
○
－
なし

IM構成管理・ビューアーを起動するメニューをWindowsスタートメニューに登録・削除する
jcovcfsetup（Windows限定）
○
－
スーパーユーザー※¹

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

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

構成定義情報を下位ホストに配布し，定義を有効にする
jbsrt_distrib※2
○
○
スーパーユーザー※¹

下位ホストから構成定義情報を収集し，構成定義を更新する
jbsrt_sync※2
○
○
スーパーユーザー※¹

コマンドを実行したホストの構成定義情報を削除する
jbsrt_del※2
○
○
スーパーユーザー※¹

設定されている構成定義情報を表示する
jbsrt_get※2
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

重要イベントの対処状況を変更する
jcochstat
○
○
なし※³

JP1/IM - Managerのシステム環境を設定する
jcoimdef
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

自動アクションの定義をチェックし，複数の定義ファイルを併合する
jcamakea
○
○
スーパーユーザー※¹

自動アクションの実行結果を表示する
jcashowa
○
○
なし※³

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

自動アクションの定義を再読み込みする，または自動アクション機能を休止する
jcachange
○
○
スーパーユーザー※¹

自動アクションをキャンセルする
jcacancel
○
○
スーパーユーザー※¹

コマンド実行のための環境を設定する
jcocmddef※2
○
○
スーパーユーザー※¹

実行したコマンドの履歴を出力する
jcocmdlog※2
○
○
なし

JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドを削除する
jcocmddel※2
○
○
スーパーユーザー※¹

JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドの状態を確認する
jcocmdshow※2
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

相関イベント発行定義を変更する
jcoegschange
○
○
スーパーユーザー※¹

相関イベント発行定義ファイルの定義内容をチェックする
jcoegscheck
○
○
スーパーユーザー※¹

相関イベント発行機能を相関稼働状態にする
jcoegsstart
○
○
スーパーユーザー※¹

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

相関イベント発行機能を機能停止状態にする
jcoegsstop
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

ホスト情報をホスト情報DBに登録する
jcshostsimport
○
○
スーパーユーザー※¹

ホスト情報DBからホスト情報を取得する
jcshostsexport
○
○
スーパーユーザー※¹

監視オブジェクトDBを再作成する
jcsdbsetup
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

イベント取得フィルターを切り替える
jcochfilter
○
○
スーパーユーザー※¹

共通除外条件の動作モードを変更する
jcochcefmode
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

監視ノード（監視オブジェクトまたは監視グループ）の状態を変更する
jcschstat
○
○
スーパーユーザー※¹

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

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

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

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

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

IM構成管理・ビューアーのJavaスレッドダンプを生成する
jcfthreaddmp（Windows限定）
○
－
なし

JP1/IM - Manager，およびJP1/IM - Viewの障害発生時の資料を採取する
jim_log.bat（Windows限定）
○
－
なし※³

JP1/IM - Managerの障害発生時の資料を採取する
jim_log.sh（UNIX限定）
－
○
スーパーユーザー

JP1/IM - Viewの障害発生時の資料を採取する
jcoview_log.bat（Windows限定）
○
－
なし※³

JP1/IM - Viewの障害発生時にスレッドダンプを出力する
jcothreaddmp（Windows限定）
○
－
なし

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

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

JP1/IM - Managerの機能を拡張するコマンド

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

イベント拡張属性定義ファイルをチェックする
jcoattrfcheck
○
○
なし※³

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

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

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

JP1/IM - Incident Master連携で使用するコマンド

機能概要
コマンド名
Windows
UNIX
必要な
実行権限

インシデント登録サービスの動作状態を確認する
jcoedsstatus
○
○
なし※³

インシデント登録サービスの動作状態を稼働，または休止状態にする
jcochdisc
○
○
スーパーユーザー※1

jcacancel

機能

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

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

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

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

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

このコマンドはアクション実行ホストのJP1/Baseが07-10以降の場合に実行できます。JP1/Baseが07-00以前の場合には実行できません。アクション情報ファイルに存在しないアクションのキャンセルはできません。

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

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

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

形式

jcachange [-n] [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-n

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

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

-h 論理ホスト名

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

戻り値

0 | 正常終了
1 | 引数不正
2 | パイプ関連エラー
4 | 自動アクション機能からの応答がない
5 | 自動アクション定義ファイルの再読み込み，自動アクション機能の一時停止失敗
-13 | 引数指定値不正
-102 | ファイル入出力エラー
その他の値 | システムエラー

jcadefconv

機能

バージョン8以前のアクション定義ファイル（DESC_VERSIONの値が3未満）を09-00のアクション定義ファイル（DSEC_VERSIONの値が3）に変換します。

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

表1-2　文字の変換

変換前の文字 | 変換後の文字
¥/ | /
半角スペース | %20
% | %25

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

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

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

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

バージョン8以前の形式
09-00の形式
備考

（DESC_VERSIONなし）
DESC_VERSION=3
－

DESC_VERSION=1
DESC_VERSION=3
－

DESC_VERSION=2
DESC_VERSION=3
－

: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
イベント条件がある場合

（凡例）

▲：タブを示す

△：半角スペース

－：なし

形式

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のメッセージが出力されコマンドが終了します。また，同じファイル名を指定した場合，KAVB5504-Eメッセージが出力されプログラムを終了します。

-h 論理ホスト名

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

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

注意事項

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

戻り値

0 | 正常終了
1 | 異常終了
2 | 警告終了

使用例

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

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=3
cmn
 sta true
end-cmn

act アクション1
 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 | フォーマットエラー，または権限がない。
-1 | ファイルオープンエラー
-100 | 論理エラー
-102 | ファイル入出力エラー
-103 | メモリー不足
-104 | システムエラー

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 Server 2003の場合：なし

Windows Server 2008の場合：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)の値に誤りがあります」と表示されます。

-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 Server 2008限定）

出力形式

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 Server 2003の場合：なし

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

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

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

-d

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

戻り値

0 | 正常終了
4 | 自動アクション機能（イベント基盤サービス）からの応答がない
5 | 自動アクション機能（イベント基盤サービス）が停止または休止中のため，自動アクション定義ファイルの内容が表示できない
6 | システムエラー（コマンド側）
7 | コマンドを実行する権限がない（Windows Server 2008限定）
-13 | 引数指定値不正
-102 | 入出力エラー
-104 | システムエラー（イベント基盤サービス側）

出力形式

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限定）

機能

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

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

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

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

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

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

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

形式

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

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-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オプションを指定したときだけ指定できます。

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

監視対象のOSがAIXの場合

SJIS，SJIS/Ja_JP，SJIS/Ja_JP.IBM-932，EUCJIS，EUC/ja_JP，EUC/ja_JP.IBM-eucJP，C

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

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

監視対象のOSがHP-UXの場合

SJIS，SJIS/ja_JP.SJIS，SJIS/japanese，EUCJIS，EUC/ja_JP.eucJP，EUC/japanese.euc，C

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

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

監視対象のOSがLinuxの場合

UTF-8，UTF-8/ja_JP.UTF-8，UTF-8/ja_JP.utf8，C

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

監視対象のOSがSolarisの場合

SJIS，SJIS/ja_JP.PCK，EUCJIS，EUC/ja，EUC/japanese，C

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

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

監視対象のOSがWindowsの場合

SJIS

-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の場合はフルパスで指定します。

指定できるファイル数は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 ¥log¥sample.log -c SJIS -filter '.*-E'

使用例2

host1のプロファイルを削除する場合

jcfallogdef -a name1 -o host1 -d -q

jcfallogreload

機能

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

リロードできる定義情報は，動作定義ファイルのMARKSTRおよびACTDEFパラメーターの値だけです。jcfallogdefコマンドまたは［プロファイル表示/編集］画面で，MARKSTRおよびACTDEFパラメーター以外の値を変更した場合は，リロードしても反映されません。再起動して反映してください。また，リロードコマンドの実行がトラップ処理と重なった場合，そのトラップ処理にリロードする内容が反映されます。

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

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

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

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

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

SSHで通信する場合，対象のリモートの監視対象ホストと公開鍵暗号方式でSSH認証できる

NetBIOSで通信する場合，監視するログファイルが共有されている

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

形式

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で通信する場合，監視するログファイルが共有されている

形式

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オプションを指定したときだけ指定できます。

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

監視対象のOSがAIXの場合

SJIS，SJIS/Ja_JP，SJIS/Ja_JP.IBM-932，EUCJIS，EUC/ja_JP，EUC/ja_JP.IBM-eucJP，C

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

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

監視対象のOSがHP-UXの場合

SJIS，SJIS/ja_JP.SJIS，SJIS/japanese，EUCJIS，EUC/ja_JP.eucJP，EUC/japanese.euc，C

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

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

監視対象のOSがLinuxの場合

UTF-8，UTF-8/ja_JP.UTF-8，UTF-8/ja_JP.utf8，C

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

監視対象のOSがSolarisの場合

SJIS，SJIS/ja_JP.PCK，EUCJIS，EUC/ja，EUC/japanese，C

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

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

監視対象のOSがWindowsの場合

SJIS

-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の場合はフルパスで指定します。なお，ワイルドカードを使用して，監視するログファイルを指定することはできません。

指定できるファイル数は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 ¥log¥sample.log -c SJIS -filter '.*-E'

jcfallogstat

機能

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

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

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

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

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

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

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

形式

jcfallogstat {-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 | リモート監視ログファイルトラップがすべて稼働している
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で通信する場合，監視するログファイルが共有されている

リモート監視ログファイルトラップが起動している

形式

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-8　ヘッダー情報（1行目）

項目 | 出力値
仮想化構成情報ファイルの識別文字列 | #VM
ファイルフォーマットバージョン | 090100
文字コード | UTF-8固定

表1-9　ヘッダー情報（2行目）

項目 | 出力値
ホスト名 | Host_name
VMMホスト名 | VMM_host_name
仮想化管理種別 | Virtual_manager_type
仮想化管理製品のバージョン | Manager_version
仮想化構成管理ホスト | Virtual_host_manager

表1-10　出力項目（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,

jcfcolvmscvmm（Windows限定）

機能

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

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management - 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-11　ヘッダー情報（1行目）

項目 | 出力値
仮想化構成情報ファイルの識別文字列 | #VM
ファイルフォーマットバージョン | 090100
文字コード | UTF-8固定

表1-12　ヘッダー情報（2行目）

項目 | 出力値
ホスト名 | Host_name
VMMホスト名 | VMM_host_name
仮想化管理種別 | Virtual_manager_type
仮想化管理製品のバージョン | Manager_version
仮想化構成管理ホスト | Virtual_host_manager

表1-13　出力項目（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,,SCMMM,2008,

jcfcolvmvc

機能

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

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management - 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-14　ヘッダー情報（1行目）

項目 | 出力値
仮想化構成情報ファイルの識別文字列 | #VM
ファイルフォーマットバージョン | 090100
文字コード | UTF-8固定

表1-15　ヘッダー情報（2行目）

項目 | 出力値
ホスト名 | Host_name
VMMホスト名 | VMM_host_name
仮想化管理種別 | Virtual_manager_type
仮想化管理製品のバージョン | Manager_version
仮想化構成管理ホスト | Virtual_host_manager

表1-16　出力項目（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

機能

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

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmvirtage
         -c ホスト名 [ホスト名]
         -o 出力ファイル名

実行権限

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

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

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-c ホスト名 [ホスト名]

Virtageを管理するJP1/SC/CMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

Virtageを管理するJP1/SCから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0 | 正常終了※1
1 | 引数エラー
2 | メモリー不足
3 | JavaVMの起動エラーが発生した
4 | 実行権限エラー
5 | 管理者コンソールから実行されなかった
6 | 出力ファイルがすでに存在する
7 | 仮想化構成情報の取得に失敗※2
8 | 入出力エラーが発生した
99 | その他のエラー

注※1

一部取得できなかった仮想ホスト情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成を取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1-17　ヘッダー情報（1行目）

項目 | 出力値
仮想化構成情報ファイルの識別文字列 | #VM
ファイルフォーマットバージョン | 090100
文字コード | UTF-8固定

表1-18　ヘッダー情報（2行目）

項目 | 出力値
ホスト名 | Host_name
VMMホスト名 | VMM_host_name
仮想化管理種別 | Virtual_manager_type
仮想化管理製品のバージョン | Manager_version
仮想化構成管理ホスト | Virtual_host_manager

表1-19　出力項目（3行目以降）

項目
説明

ホスト名
ホスト名。

VMMホスト名
仮想化環境ソフトウェアが稼働するホストのホスト名。
ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別
仮想化構成を管理する製品の種別。

JP1/SC/CMの場合：JP1/SC/CM

Virtageの場合：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/IM-Manager DB Server，JP1/IM-Manager DB Cluster Service

クラスタ構成のセットアップ時：JP1/IM-Manager DB Server_論理ホスト名，JP1/IM-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をセットアップしている場合は，-ｃオプションに統合監視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/IM-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM-Manager DB Cluster Service）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

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/IM-Manager DB Cluster Service）が停止していて，IMデータベースサービス（JP1/IM-Manager DB Server）が開始している必要があります。また，統合監視DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM-Manager）が停止している必要があります。

論理ホストのとき

論理ホストのIMデータベースのクラスタサービス（JP1/IM-Manager DB Cluster Service_論理ホスト名）が停止していて，論理ホストのIMデータベースサービス（JP1/IM-Manager DB Server_論理ホスト名）が開始している必要があります。また，統合監視DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM-Manager_論理ホスト名）が停止している必要があります。

UNIXの場合，IM構成管理DBがセットアップ済み，かつIMデータベースを使用しているとき，JP1/IM-Managerサービスが停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

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種類の情報がすべて削除されて，オプションで指定した情報がインポートされます。

形式

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 - Manager 運用ガイド」の「8.7.1(5)　業務グループ情報」および「8.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 - Manager 運用ガイド」の「8.7.1(1)　ホスト情報」を参照してください。

-g 業務グループ情報ファイル名 監視グループ情報ファイル名 セントラルスコープのエクスポートファイル名

jcfexportコマンドでエクスポートした業務グループ情報ファイル（monitoring_system_data.csv），監視グループ情報ファイル（monitoring_group_data.csv）とjcsdbexportコマンドでエクスポートしたファイルを，相対パスまたは絶対パス形式で指定します。このオプションは-fオプションと同時には指定できません。パスに空白を含む場合は，「"」で囲みます。

セントラルスコープのエクスポートファイルには，サーバ指向ツリーをエクスポートしたファイルを指定します。

-o エクスポートファイル名

コマンドが出力するセントラルスコープのインポート用ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

[-r]

このオプションは，引数で指定したJP1/IM - Manager（JP1/IM - Central Scope）のエクスポートファイルに含まれる仮想化システム構成ツリーを使用するかどうかを設定します。このオプションを指定する場合，JP1/IM - Manager（JP1/IM - Central Scope）のエクスポートファイルの仮想化システム構成ツリーを使用しないで，このコマンドで新しく作成します。このオプションを指定しない場合，JP1/IM - Manager（JP1/IM - Central Scope）のエクスポートファイルに含まれる仮想化システム構成ツリーに対して，新たに仮想化システム構成ツリーを追加します。

注意事項

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］キーでコマンドを強制終了した
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ディレクトリ内にテキストファイル形式で出力します。

Windows Server 2003，Windows XP Professionalの場合

Viewパス¥log¥

Windows 7，Windows Server 2008，およびWindows Vistaの場合

%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となります。

jcfview（Windows限定）

機能

IM構成管理・ビューアーを起動します。-hオプション，-uオプション，-pオプションで起動した場合，［ログイン］画面を表示しないで，自動的にログインします。

形式

jcfview [-h 接続先ホスト名] [-u ユーザー名] [-p パスワード]

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

-h 接続先ホスト名

ログインするIM構成管理が起動しているホスト名を指定します。指定できる文字数は，1～255バイトです。JP1/IM - Managerが起動しているホストだけを指定できます。

接続先ホスト名には，次のものが指定できます。

コマンドを使用するホストで定義されているホスト名

コマンドを使用するホストでアドレス解決可能なホスト名

IPアドレス

このオプションは省略できますが，-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）

インシデント登録サービス（jcdmain）

IM構成管理サービス（jcfmain）

IMデータベースサービス

JP1/IM - Incident Master連携用のプロセス

形式

jco_killall.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

JP1/Baseで設定した論理ホスト名を指定します。指定できる文字数は，1～15バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

このコマンドは，論理ホスト名を先頭から15バイトまでで判定して，対応するプロセスを強制終了します。名称が16バイト以上の論理ホストのプロセスを強制終了できません。

戻り値

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）

相関イベント発行環境定義ファイル

インシデント登録用システムプロファイル（eds_system.conf）

インシデント手動登録定義ファイル（incident.conf）

インシデント登録環境定義ファイル（jcdmain.conf.update）

重大度変更定義ファイル（jcochsev.conf）

イベント条件表示項目定義ファイル（attr_list.conf）

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

発生元ホストマッピング定義ファイル（user_hostmap.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秒です。

戻り値

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を自動的に起動させたくない場合はこの操作を行わないでください。

JP1/IM - Managerを手動で起動する場合は，/etc/opt/jp1cons/jco_start.modelスクリプト，またはこのスクリプトをコピーしたファイルを実行してください。

バージョン8以前のJP1/IM - Managerを使用している場合，必ずこの操作をしてください。

なお，このコマンドを実行する前に必ず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/

戻り値

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 - Manager 構築ガイド」の「6.　クラスタシステムでの運用と環境構築」を参照してください。

形式

jco_start.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定できる文字数は，1～63バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

戻り値

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/

戻り値

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 - Manager 構築ガイド」の「6.　クラスタシステムでの運用と環境構築」を参照してください。

形式

jco_stop.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定できる文字数は，1～63バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

戻り値

0 | 正常終了
1 | 引数が二つ以上指定されている，または停止要求がタイムアウトした

jcoappexecfcheck

機能

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

このコマンドを実行すると，指定されたディレクトリのアプリケーション実行定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。

解析結果は次の形式で出力されます。

アプリケーション実行定義識別子,実行パス[,説明文]

解析結果には，システムで定義するアプリケーション実行定義識別子（セントラルコンソールで使用するデフォルトの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,言語種別,プロダクト名,属性名,表示名,タイプ

注

「,属性名,表示名,タイプ」部分は，表示されるイベント属性の分だけ繰り返し出力されます。

［イベント詳細］画面に出力されるJP1イベントの属性は，このコマンドで出力される解析結果に，基本属性および拡張属性の共通情報が付加されたものになります。

形式

jcoattrfcheck イベント拡張属性定義ディレクトリ名

実行権限

Windows Server 2003の場合：なし

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

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

イベント拡張属性定義ディレクトリ名

チェックの対象となる拡張属性定義ファイルがあるディレクトリ名を指定します。ディレクトリ名は，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。

チェックの対象となるファイルは，拡張子が「.conf」で，ファイルタイプが「extended-attributes-definition」でなければなりません。

jcochafmode

機能

イベント取得フィルターの位置をイベントコンソールサービスからイベント基盤サービスに変更します。

イベント取得フィルター（互換用）を使用している場合にこのコマンドを実行すると，JP1イベントの監視に加えて，自動アクションやセントラルスコープなどのほかの機能にも有効なフィルターとして動作させることができます。また，フィルター条件を詳細に定義できるようになります。ただし，イベント取得フィルター（互換用）のまま運用したい場合は，フィルター位置の変更は不要です。

なお，07-00以前のイベント取得フィルターで設定した内容，またはイベント取得フィルター（互換用）で設定した内容は，下記表で示すとおりに引き継がれます。運用に合わせて設定内容，条件群名を変更してください。

表1-20　イベント取得フィルター設定項目の引き継ぎ

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 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

注　このコマンドは，Windows Server 2008，HP-UX (IPF)，およびLinux版のJP1/IM - Managerには同梱されていません。

引数

-h 論理ホスト名

イベント取得フィルター（互換用）の論理ホスト名を指定します。このオプションを省略した場合，物理ホストを仮定します。クラスタシステムを使用していない場合には指定は不要です。

注意事項

このコマンドを実行してイベント取得フィルターの位置および定義内容を変更する場合は，イベント取得フィルターを変更する対象ホストのJP1/IM - Managerを必ず停止してください。JP1/IM - Managerを停止していない状態でこのコマンドを実行したときは，エラーとなります。

このコマンドを何度も実行した場合は，すでに変換されているイベント取得フィルターが上書きされ，カスタマイズした条件定義が破棄されます。このコマンドは，イベント取得フィルターを変換するときに1回だけ実行してください。

一度変換したイベント取得フィルターを，バージョンアップ前のイベント取得フィルターまたはイベント取得フィルター（互換用）として（フィルターの位置および定義内容を）元に戻すことはできません。

バージョン07-10以降のイベント取得フィルターは，イベント取得フィルター（互換用）に変換できません。

JP1/IM - Managerを新規にインストールした場合，このコマンドを実行する必要はありません。

このコマンドを実行してイベント取得フィルターの位置をイベント基盤サービスに変更すると，以後そのフィルターはJP1/IM - Incident Master連携用の機能（インシデント登録サービス）および相関イベント発行機能にも適用されるようになります。

戻り値

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の共通除外条件の動作モードを変更するコマンドです。このコマンドを実行すると，共通除外条件を基本モードから拡張モードに変更したり，拡張モードから基本モードに変更したりできます。共通除外条件を拡張モードに変更すると，正規表現の種類が，拡張正規表現に変更されます。

-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：共通除外条件の動作モードを拡張モードにしたい場合に指定します。基本モードで使用していた共通除外条件の定義は，拡張モードの共通除外条件の定義に引き継がれます。なお，共通除外条件を拡張モードに変更した場合，正規表現の種類が，拡張正規表現に変更されます。

normalまたはextendedは大文字・小文字を区別しません。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応する動作モードを，JP1/IM - Managerの共通除外条件に設定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

環境変数JP1_HOSTNAMEにJP1_DEFAULTや存在しない論理ホストを設定した場合，エラーメッセージが表示されます。

注意事項

-mオプションを指定しなかった場合，共通除外条件の動作モードを表示します。

次のどちらかまたは両方の状態の場合，拡張モードを使用できません。

イベント取得フィルター（互換用）を使用している

マネージャーホストのJP1/Baseで，拡張正規表現を使用していない

戻り値

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）を開始しました
KAVB0896-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）が正常終了しました

jcochdisc

機能

JP1/IM - Incident Master連携用のコマンドです。

インシデント登録サービスの動作状態を「稼働」から「休止」に，または「休止」から「稼働」に変更するコマンドです。状態が「稼働」の場合，インシデント登録定義に従い，JP1イベントの相関処理（条件比較，インシデントの生成，およびJP1/IM - Incident Masterへのインシデントの登録）をします。状態が「休止」の場合，インシデント登録定義に一致するJP1イベントを取得しても，JP1イベントの相関処理をしません。

形式

jcochdisc [-n]
         [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-n

インシデント登録サービスの動作状態を「休止」にする場合に指定します。「休止」になると，インシデント登録定義に一致するJP1イベントを取得しても，イベントの相関処理をしません。また，「休止」の間に発生したJP1イベントに対しては，インシデント登録サービスの動作状態が「休止」から「稼働」に変わっても，JP1イベントの相関処理をしません。

このオプションを省略した場合は，インシデント登録サービスの動作状態を「稼働」にします。

-h 論理ホスト名

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

戻り値

0 | 正常終了
1 | 異常終了（インシデント登録サービスの稼働，または休止に失敗した）
2 | インシデント登録サービスとの通信がタイムアウトした
100 | 実行権限がない（Windows限定）
101 | 引数エラー
102 | 通信エラー
255 | その他の異常終了（システムエラー）

使用例1

物理ホスト（hostP）のインシデント登録サービスの動作状態を「稼働」にする場合

入力値

jcochdisc

結果

KAJV1201-I インシデント登録定義ファイルを読み込み，hostPのインシデント登録機能を稼働状態にしました

使用例2

論理ホスト（hostL）のインシデント登録サービスの動作状態を「休止」にする場合

入力値

jcochdisc -n -h hostL

結果

KAJV1202-I hostLのインシデント登録機能を休止しました

jcochfilter

機能

JP1/IM - Managerのイベント基盤サービス，インシデント登録サービス（JP1/IM - Incident Master連携機能），および相関イベント発行機能で有効となっているイベント取得フィルターを，指定したフィルター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の共通除外条件は無効になります。複数指定する場合は，コンマで区切ります。すべての共通除外条件を有効にしたい場合は，ALLを指定します。なお，-eのあとに何も指定しなかった場合は，すべての共通除外条件が無効になります。このオプションと同時に指定できるのは，-iおよび-hオプションだけです。

-on 共通除外条件群ID[,共通除外条件群ID...]

有効にしたい拡張モードの共通除外条件のIDを指定します。このオプションは，共通除外条件が拡張モードの場合に設定できます。拡張モードの共通除外条件のIDを複数指定する場合は，コンマで区切ります。指定できる共通除外条件群IDの範囲は，0～1,023です。このオプションは，-e，-ef，および-checkオプションと同時に指定できません。

-off 共通除外条件群ID[,共通除外条件群ID...]

無効にしたい拡張モードの共通除外条件のIDを指定します。このオプションは，共通除外条件が拡張モードの場合に設定できます。拡張モードの共通除外条件のIDを複数指定する場合は，コンマで区切ります。指定できる共通除外条件群IDの範囲は，0～1,023です。このオプションは，-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コマンドは実行できません。

このコマンドを複数同時に実行しないでください。複数同時に実行した場合，あとに実行したコマンドが失敗する場合があります。

戻り値

0 | 正常終了
1 | 引数エラー
2 | JP1/IM - Manager（JP1/IM - Central Console）と接続できない（通信エラー）
3 | JP1/IM - Managerの起動状態が確認できない
4 | 一定時間内にJP1/IM - Managerからの応答がない
5 | イベント取得フィルターが互換用で動作している
6 | JP1/IM - Managerからのエラー
7 | -iオプションで指定したフィルターIDが存在しない
8 | jcochfilterコマンドの実行権限がない（Windows限定）
9 | イベント取得フィルターの最大長を超えている
10 | -eオプションで指定した共通除外条件が存在しない
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内通し番号10]

実行権限

Windows Server 2003の場合：なし

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

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h マネージャーホスト名

重要イベントが登録されているイベントDBがあるマネージャーを指定します。このオプションを省略した場合は，自ホストを仮定します。クラスタシステムでの運用時に，このオプションを省略した場合は，コマンドを実行した物理ホスト名を仮定します。指定したマネージャー上のJP1/IM - Managerが起動していないと，エラーになります。

マネージャーホスト名は255文字以内の文字列で指定してください。

-k 重要イベント対処状況キー

重要イベントの対処状況を表すキー値を入力します。-nオプションで指定した重要イベントの対処状況が，指定したキーが示す対処状況に変更されます。また，JP1/IM - Viewで表示した場合，対処状況マークが変更されます。

重要イベント対処状況キーは大文字と小文字を区別します。

-kオプションと-dオプションは，どちらか一方または両方を指定してください。-kオプションと-dオプションを両方指定した場合は，対処状況を変更したあと，JP1/IM - Viewの画面からイベントを削除します。-kオプションと-dオプションは同時に省略できません。

表1-21　重要イベント対処状況キー

キー値 | 対処状況 | JP1/IM - Viewに表示される対処状況マーク
PROCESSED | 対処済 | [図データ]　
PROCESSING | 処理中 | [図データ]　
HELD | 保留 | [図データ]　
UNPROCESSED | 未対処 | （無印）

-d

-nオプションで指定した重要イベントをJP1/IM - Viewの画面から削除します。イベントDBからは削除されません。

-kオプションと-dオプションは，どちらか一方または両方を指定してください。-kオプションと-dオプションを両方指定した場合は，対処状況を変更したあと，JP1/IM - Viewの画面からイベントを削除します。-kオプションと-dオプションは同時に省略できません。

-n イベントDB内通し番号

対処状況を変更したい重要イベントのイベントDB内通し番号を指定します。このオプションは省略できません。

イベントDB内通し番号は，最大10個指定できます。複数指定する場合は，通し番号と通し番号の間をコンマで区切ります。コンマの前後に空白を指定できません。

指定できる値は，0～2,147,483,647の10進数整数です。

戻り値

0 | 正常終了
1 | 引数エラー
2 | ネットワーク障害
3 | イベントDBの更新に失敗した
4 | 指定できないキーを指定している
5 | 更新できないイベントを指定した
7 | コマンドを実行する権限がない（Windows Server 2008限定）
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]

実行権限

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をセットアップしている場合は，-ｃオプションにIM構成管理DBを作成したときと同じ値を指定してください。また，非クラスタ環境で，論理ホスト運用をする場合はonlineを指定してください。

online：実行系をセットアップする場合に指定します。

standby：待機系をセットアップする場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0 | 正常終了
1 | 異常終了

注意事項

実行系と待機系のクラスタセットアップ情報ファイルの内容は同じにする必要があります。待機系をセットアップする場合，実行系で使用したクラスタセットアップ情報ファイルをコピーして使用してください。実行系と待機系で指定したファイル内容が異なっていた場合，待機系でアンセットアップしたあとに，クラスタセットアップ情報ファイルを実行系からコピーし，コマンドを再実行します。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後に一度アンセットアップしてから，コマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdistup，pdfmkfs，pddef，およびpdloadのプロセスが実行されていないことを確認し，jcodbunsetupコマンドを実行してからこのコマンドを再実行してください。

IM構成管理DBをセットアップ済みの場合，かつIMデータベースを使用している場合，JP1/IM-Managerサービスが停止している必要があります。

WindowsでIM構成管理DBを使用している場合，IMデータベースサービス（JP1/IM-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM-Manager DB Cluster Service）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

jcodbunsetup

機能

JP1イベントを格納する統合監視DBをアンセットアップするコマンドです。

このコマンドは，統合監視DBの使用を停止する場合，JP1/IM - Managerをアンインストールする場合，統合監視DBを再作成する場合，およびデータベースサイズを拡張する場合に実行します。IM構成管理DBをセットアップしている環境では，このコマンドを実行後もIM構成管理は使用できます。

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ファイルのエントリーが削除されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストに対応した処理だけ削除されます。

形式

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/IM-Manager DB Cluster Service）が停止していて，IMデータベースサービス（JP1/IM-Manager DB Server）が開始している必要があります。また，IM構成管理DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM-Manager）が停止している必要があります。

論理ホストの場合

論理ホストのIMデータベースのクラスタサービス（JP1/IM-Manager DB Cluster Service_論理ホスト名）が停止していて，論理ホストのIMデータベースサービス（JP1/IM-Manager DB Server_論理ホスト名）が開始している必要があります。また，IM構成管理DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM-Manager_論理ホスト名）が停止している必要があります。

UNIXの場合，IM構成管理DBがセットアップ済み，かつIMデータベースを使用しているとき，JP1/IM-Managerサービスが停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

jcoedsstatus

機能

JP1/IM - Incident Master連携用のコマンドです。

インシデント登録サービスの動作状態を表示するコマンドです。インシデント登録サービスの動作状態には，起動処理中，稼働，休止，停止処理中，停止の五つの状態があり，このコマンドを実行することで，どの状態になっているかを知ることができます。

形式

jcoedsstatus [-h 論理ホスト名]

実行権限

Windows Server 2003の場合：なし

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

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

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

出力形式

jcoedsstatusコマンドを実行すると，インシデント登録サービスの動作状態は次の形式で出力されます。

インシデント登録機能        : 状態

なお，UNIXで環境変数LANGの値をCとしていた場合は，次の形式で出力されます。

The discrimination function        : 状態

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

表1-22　状態に表示される文字列

状態に表示される文字列
動作状態
説明

STARTING
起動処理中
インシデント登録サービスが起動処理を実行している状態。

RUNNING
稼働
インシデント登録サービスが起動しており，インシデント登録機能が使用できる状態。
次の条件のときにこの状態となる。

有効なインシデント登録条件が少なくとも一つある状態でインシデント登録サービスが起動した。

有効なインシデント登録条件が少なくとも一つある状態で，-nオプションを指定せずにjcochdiscコマンドを実行し，インシデント登録定義を反映した。

有効なインシデント登録条件を記載したインシデント登録設定ファイルを引数にjcisetfilterコマンド（JP1/IM - Incident Master提供コマンド）を実行し，インシデント登録定義を反映した。

STANDBY
休止
インシデント登録サービスは起動しているが，インシデント登録機能は休止している状態。
休止中，JP1イベントの取得処理は行うが，取得したJP1イベントに対して相関処理は行わない。
また，「休止」から「稼働」になった場合でも，休止中に取得したJP1イベントに対して相関処理は行わない。

備考

休止前に「相関中」状態になっていたインシデントは休止後「不成立」状態になる。

インシデントの状態については，マニュアル「JP1/Integrated Management - Incident Master」を参照のこと。

STOPPING
停止処理中
インシデント登録サービスが停止処理を実行している状態。

STOP
停止
インシデント登録サービスが停止している状態。

戻り値

0 | 状態表示に成功
1 | 状態表示に失敗
2 | インシデント登録サービスとの通信がタイムアウトした
100 | コマンドを実行する権限がない（Windows Server 2008限定）
101 | 引数エラー
102 | 通信エラー
255 | その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）のインシデント登録サービスの動作状態（「稼働」時）を表示する場合

入力値

jcoedsstatus

結果

KAJV1261-I hostPのインシデント登録サービスの状態を表示します
インシデント登録機能        : RUNNING

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 不正内容:一つの相関イベント発行条件に指定されているイベント条件数が最大数を超えています

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 Server 2003の場合：なし

Windows Server 2008の場合：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-23　状態に表示される文字列

状態に表示される文字列
動作状態
説明

STARTING
起動処理中
相関イベント発行機能が起動処理を実行している状態。

RUNNING
相関稼働
相関イベント発行機能が起動しており，相関イベントの発行処理ができる状態。
次の場合にこの状態となる。

相関イベント発行機能が起動した場合。

相関イベント発行機能の状態が機能停止で，jcoegsstartコマンドを実行した場合。

STANDBY
機能停止
相関イベント発行機能は起動しているが，相関イベントの発行処理が停止している状態。
機能停止中に発生したJP1イベントに対して相関イベントの発行処理はしない。
また，機能停止から相関稼働になった場合でも，機能停止中に発生したJP1イベントに対して相関イベントの発行処理はしない。

備考

機能停止前に発行処理中だった相関イベントは機能停止後に不成立になる。

STOPPING
停止処理中
相関イベント発行機能が停止処理をしている状態。

STOP
停止
相関イベント発行機能が停止している状態。

起動オプションに表示される文字列について次に説明します。

表1-24　起動オプションに表示される文字列

起動オプションに表示される文字列 | 起動オプション | 説明
cold | coldスタート | 前回停止時に相関イベントの発行処理中であった情報を引き継がない。
warm | warmスタート | 前回停止時に相関イベントの発行処理中であった情報を引き継ぐ。

相関イベント発行定義ファイルの形式については，「相関イベント発行定義ファイル」（2.　定義ファイル）を参照してください。

戻り値

0 | 状態の表示に成功した
1 | 状態の表示に失敗した
2 | 相関イベント発行機能との通信がタイムアウトした
100 | コマンドを実行する権限がない（Windows Server 2008限定）
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形式にしてファイルに出力することができます。

CSVの出力形式については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「3.11.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件です。すでに同じファイル名が存在する場合は，上書きしないで，存在しない番号まで繰り上げて作成します。オプションを省略した場合は，カレントディレクトリに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」など），または絶対パス形式で指定してください。

-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は，大文字小文字を区別しません。

-user

統合監視DBに登録しているJP1イベントをイベントレポート出力します。

-userオプションは，省略できます。

-userオプションを指定しなくても，-sys，-save，-showsvを指定していなければイベントレポート出力を指定していることになります。

-sys

統合監視DBに登録しているJP1イベントを保守情報出力します。

-save

統合監視DB内の保存出力していないJP1イベントをすべて保存出力します。

-showsv

統合監視DB内の保存出力していないJP1イベントの割合（統合監視DBの最大容量との比率）と容量，および，削除警告通知位置を表示します。

戻り値

0 | 正常終了
1 | オプション・引数不正
2 | フィルター不正
3 | 項目ファイル不正
4 | レポート出力処理エラー
5 | 実行権限エラー（Windows限定）
6 | 同時実行エラー
7 | 出力ファイルの通し番号が上限値に達した
101 | 統合監視DBがセットアップされていない
102 | IMデーターベースサービスが起動していない
103 | IMデーターベースサービスとの接続エラーが発生した
254 | メモリー不足が発生した
255 | システムエラー

使用例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

機能

このコマンドを実行すると，指定されたディレクトリのアプリケーション実行定義ファイルおよび統合機能メニュー定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。

解析結果は次の形式で出力されます。

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のプロセスで障害が発生したときに，ダンプを出力するためのコマンドです。なお，セントラルスコープサービス（jcsmain）およびIM構成管理サービス（jcfmain）は除きます。また，jcogencoreコマンドを実行した場合は，JP1/IM - Managerを再起動する必要があります。

Windowsの場合
JP1/IM - Managerのevtcon，jcdmainおよびevgenプロセスで障害が発生したときにこのコマンドを実行してください。

UNIXの場合
JP1/IM - Managerのevflow，jcamain，evtcon，jcdmainおよびevgenプロセスで障害が発生したときにこのコマンドを実行してください。

障害の検知手段としてはJP1/IM - Managerのヘルスチェック機能を利用します（ヘルスチェック機能については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「7.2　JP1/IM - Managerのヘルスチェック機能」参照）。

jcogencoreコマンドを実行すると，どのプロセスの障害資料を出力するか問い合わせメッセージが表示されます。障害が発生したプロセスの資料を出力するようにします。jcogencoreコマンドを実行することで出力されるファイルを次の表に示します。

表1-25　出力されるファイル

OS | プロセス名 | 出力されるファイルの名称
Javaスレッドダンプ | コアダンプ
Windows | evflow | javacoreプロセスID.XXXXXXXXXX.txt | －
jcamain | － | －
evtcon※1 | javacoreプロセスID.XXXXXXXXXX.txt | －
jcdmain※1 | javacoreプロセスID.XXXXXXXXXX.txt | －
evgen※1，※2 | javacoreプロセスID.XXXXXXXXXX.txt | －
UNIX | evflow | javacoreプロセスID.XXXXXXXXXX.txt※3 | core.evflow
jcamain | － | core.jcamain
evtcon※1 | javacoreプロセスID.XXXXXXXXXX.txt※3 | core.evtcon
jcdmain※1 | javacoreプロセスID.XXXXXXXXXX.txt※3 | core.jcdmain
evgen※1，※2 | javacoreプロセスID.XXXXXXXXXX.txt※3 | core.evgen

（凡例）

XXXXXXXXXX：OSが自動で割り当てる一意のID

－：出力しない

注※1

evtcon，jcdmainおよびevgenは機能名です。

注※2

統合監視DBを使用しない場合に使用される機能名です。

注※3

HP-UX (IPF)の場合，Javaスレッドダンプは出力されません。

出力されたファイルは，次のフォルダに格納されます。

Windowsの場合

物理ホスト：Consoleパス¥log¥

論理ホスト：共有ディスク¥jp1cons¥log¥

UNIXの場合

物理ホスト：/var/opt/jp1cons/log/

論理ホスト：共有ディスク/jp1cons/log/

出力したスレッドダンプおよびコアダンプは，資料採取ツールを使って，ほかの障害資料と合わせて採取してください。

また，このコマンドを実行したあとは，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でこのコマンドを実行する場合には，実行前にご使用のマシンの空き容量を確認してください。5プロセス分のコアダンプを出力した場合，コアダンプの容量は合計で最大8,419メガバイトになる場合があります。

複数のプロセスで障害が発生した場合は，イベントコンソールサービス（java），アクション実行サービス（jcamain），イベント基盤サービス（evflow）の順にコマンドを実行してください。
なお，インシデント登録サービス（jcdmain）および相関イベント発行機能（evgen）はほかのプロセスと依存関係がないため，コマンドの実行順序は任意です。

戻り値

0 | 正常終了
1 | オプション・引数解析エラー
2 | プロセスチェックエラー
3 | 論理ホストエラー
4 | 実行権限エラー（Windows限定）
5 | パイプ作成エラー（Windows限定）
6 | スレッドダンプ出力処理エラー
10 | その他のエラー

使用例1

Windowsで，物理ホストのイベントコンソールサービス（java）プロセスがハングアップした場合

jcogencore

使用例2

Windowsで，論理ホストhostAのイベントコンソールサービス（java）プロセスがハングアップした場合

jcogencore -h hostA

使用例3

UNIXで，物理ホストのイベントコンソールサービス（java）プロセスがハングアップした場合

/opt/jp1cons/bin/jcogencore

出力例

UNIXで，物理ホストのイベントコンソールサービス（java）プロセスがハングアップし，コアダンプおよびスレッドダンプを出力する場合

    ProcessName    PID
[1] : evflow        1234
[2] : jcamain       94320
[3] : evtcon        3333
[4] : evgen         65654
[5] : jcdmain       368828
[6] : 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-6]: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-26　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]
         [-n 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]

-reseventオプションは，BJEXと連携した場合に使用するオプションです。-reseventオプションの詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「9.6.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も再起動が必要です。

-n ON | OFF

JP1/IM - Incident Master連携用のオプションです。インシデント登録サービスを起動するかどうかを指定します。

ONを指定すると，JP1/IM - Manager起動時にインシデント登録サービスが起動します。

OFFを指定すると，JP1/IM - Manager起動時にインシデント登録サービスが起動しません。デフォルトはOFFです。

-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）の"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です。

-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です。

-cmdbtn {ON | OFF}

［コマンド実行］画面の［コマンド］ボタンを有効にするかどうかを指定します。

ON：［コマンド］ボタンを有効にします。有効にすると［コマンド実行］画面に［コマンド］ボタンが表示されます。

OFF：［コマンド］ボタンを無効にします。無効にすると［コマンド実行］画面に［コマンド］ボタンは表示されません。デフォルトはOFFです。

-hostmap {ON | OFF}

発生元ホストのマッピングを有効にするかどうかを指定します。

ON：発生元ホストのマッピングを有効にします。

OFF：発生元ホストのマッピングを無効にします。デフォルトはOFFです。

-bizmonmode {ON | OFF}

業務グループの参照・操作制限を有効にするかどうかを指定します。

ON：業務グループの参照・操作制限を有効にします。

OFF：業務グループの参照・操作制限を無効にします。デフォルトはOFFです。

-ignorecasehost {ON | OFF}

ホスト名に関するイベント条件を比較するときに英大文字・小文字を区別するかどうかを指定します。

ON：英大文字・小文字を区別しません。ただし，比較キーワードに正規表現を使用している場合は区別します。

OFF：英大文字・小文字を区別します。デフォルトはOFFです。

このオプションを有効にした場合に，ホスト名の大文字・小文字を区別しなくなる機能と属性の対応を次に示します。

表1-27　機能とイベント条件の対応

機能
属性（イベント条件）

重要イベントフィルターでのフィルタリング

発行元イベントサーバ名(登録ホスト名)（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）

繰り返しイベントの集約表示
イベント条件を指定できないが，-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）

戻り値

0 | 正常終了
1 | 異常終了
7 | 実行権限エラー（Windows限定）

定義が有効になる契機

オプション | 有効になる契機
JP1/IM - Managerの再起動時 | jco_spmd_reloadコマンド実行時 | -i指定時
-r | ○ | － | －
-b | ○ | － | －
-s | ○※ | － | －
-n | ○ | － | －
-egs | ○ | － | －
-rulehost | ○ | ○ | ○
-ruleuser | ○ | ○ | ○
-rule | ○※ | － | －
-resevent | ○※ | － | －
-e | ○ | ○ | ○
-t | ○ | ○ | ○
-c | ○ | ○ | ○
-o | ○ | ○ | ○
-memo | ○※ | ○※ | ○※
-chsev | ○※ | － | －
-db | ○※ | － | －
-dbntc | ○ | ○ | －
-dbntcpos | ○ | ○ | －
-cf | ○ | － | －
-cmdbtn | ○ | － | ○※
-hostmap | ○※ | － | －
-bizmonmode | ○※ | － | －
-ignorecasehost | ○ | － | －

（凡例）

○：有効になる。

－：該当しない。

注※

接続中のJP1/IM - Viewの再起動が必要です。

jcomonitorfcheck

機能

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

このコマンドを実行すると，指定されたモニター画面呼び出し定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。定義誤りなどのエラー情報は標準エラー出力に出力されます。

解析結果は，イベントID単位に次の形式で出力されます。

プロダクト名，イベントID
 開始バージョン，終了バージョン
   [サブキー名 ，キーとなる属性名
     [キーとなる属性値, インターフェース名]]
     [インターフェース名，アプリケーション実行定義識別子，
      コマンド引数，置き換えイベント属性]

バージョンの指定が「0600」のように一つだけだった場合は，開始バージョンと終了バージョンに同じ値が出力されます。同様に，「ALL」を指定した場合も，開始バージョンと終了バージョンの両方に「ALL」が表示されます。

キー定義「DEF_KEY」に「SUBKEY」が設定された場合は，サブキーの内容が表示されます。「SUBKEY」は，ほかのキー定義「DEF_KEY」で使用されている場合でも重複して表示されます。

このコマンドでは，アプリケーション実行定義識別子がアプリケーション実行定義ファイルに定義されているかどうかはチェックしません。

形式

jcomonitorfcheck モニター画面呼び出し定義ディレクトリ名

実行権限

Windows Server 2003の場合：なし

Windows Server 2008の場合：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コマンドを実行して出力したスレッドダンプは，次のフォルダに格納されます。

Windows Vistaの場合

システムドライブ:¥ProgramData¥HITACHI¥JP1¥JP1_DEFAULT¥JP1CoView¥log¥

上記以外のOSの場合

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 - Manager 運用ガイド」の「10.4.1(2)　JP1/IM用スレッドダンプを出力する」を参照して，操作できなくなったJP1/IM - ViewのプロセスIDを識別してください。

注意事項

正常なJP1/IM - Viewに対して，jcothreaddmpコマンドを実行した場合は，JP1/IM - Viewの動作が不安定になることがあります。この場合には，JP1/IM - Viewを再起動してください。

WWWページ版のJP1/IM - Viewの資料採取
WWWページ版のJP1/IM - Viewで操作ができなくなった場合には，別の手段で資料を採取する必要があります。資料採取については，次を参照してください。

ダンプの採取前に必要な設定について
参照先：マニュアル「JP1/Integrated Management - Manager 構築ガイド」の「4.16.4　［Javaコンソール］画面の表示設定」

資料の採取手順について
参照先（Windows）：マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.4.1(3)　WWWページ版のJP1/IM - Viewに関連する情報を採取する」
参照先（UNIX）：マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.4.2(3)　WWWページ版のJP1/IM - Viewに関連する情報を採取する」

戻り値

0 | 正常終了
1 | オプションの解析エラー
2 | プロセスのチェックエラー
3 | スレッドダンプ出力要求の送信エラー
10 | その他のエラー

jcovcfsetup（Windows限定）

機能

IM構成管理・ビューアーを起動するメニューをWindowsのスタートメニューに登録・削除するコマンドです。なお，IM構成管理・ビューアーは自動的にWindowsのスタートメニューには登録されません。

JP1/IM - ViewがWindows 7，Windows Server 2008，またはWindows Vistaの場合，［管理者として実行］から起動したコマンドプロンプト上から実行したときだけ有効となります。

形式

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] | -m ]
        [-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アドレス

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-u ユーザー名

認証サーバに登録してあるJP1ユーザー名を指定します。指定できる文字数は，1～31バイトです。半角英数字（英字は小文字）だけを使用できます。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-p パスワード

指定したユーザー名に対応するパスワードを指定します。指定できる文字数は，6～32バイトです。半角英数字だけを使用できます。英字は，大文字・小文字が区別されます。

このオプションを指定する場合は，-hおよび-uオプションも指定する必要があります。

このオプションは省略できます。

-e

［監視ツリー(編集中)］画面を起動します。

このオプションを指定する場合は，ほかのオプションを指定しないでください。

このオプションは省略できます。

-m

このオプションは，JP1/IM - Central Information Masterにログインする場合に指定します。JP1/IM - Managerでは使用しません。

また，-c，-s，および-eオプションと同時に指定できません。

詳細については，マニュアル「JP1/Integrated Management - Central Information Master リファレンス」を参照してください。

戻り値

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のシステム情報，統合トレースログなどを採取します。

このツールは，バッチファイルです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料を採取する対象フォルダまたはファイルを一次資料および二次資料に区分けし，指定した資料格納フォルダの直下に採取した資料が格納されます。

一次資料は，障害時の切り分けや，軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は，一次資料ではわからなかった障害をさらに調査するための詳細資料です。Windowsイベントログ，クラッシュダンプを採取します。

また，JP1/IM - Viewのスレッドダンプがある状態でjcoview_log.batを実行すると，メッセージKAVB8946-Iを表示してスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」を入力した場合，スレッドダンプを削除します。

必要に応じて採取した資料を圧縮ツールなどで圧縮してください。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.3　トラブル発生時に採取が必要な資料」を参照してください。

資料格納フォルダの直下に格納された資料のフォルダ構成および資料内容を次に示します。

表1-28　一次資料の内部フォルダ構成

フォルダ名 | 格納された資料
資料格納フォルダ¥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 | 統合トレースログ

注※

JP1/IM - ManagerおよびJP1/Baseが同一マシン上にインストールされている場合，JP1/IM - ManagerおよびJP1/Baseの資料も採取されます。

表1-29　二次資料の内部フォルダ構成

フォルダ名
格納された資料

資料格納フォルダ¥jp1_default¥imm_2nd¥oslog

Windowsイベントログ

クラッシュダンプ※

注※

Windows 7，Windows Server 2008，およびWindows Vista版のJP1/IM - Viewでは，クラッシュダンプは採取しません。

形式

jcoview_log.bat -f 資料格納フォルダ
              [-t]
              [-u]
              [-q]

実行権限

Windows Server 2003，Windows XP Professionalの場合：なし

Windows 7，Windows Server 2008，およびWindows Vistaの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Viewパス¥tools¥

引数

-f 資料格納フォルダ

採取した資料を出力するフォルダ名をフルパスまたはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲んで指定します。このオプションは省略できません。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。すでに存在するフォルダを指定した場合は，いったんそのフォルダを削除してから，指定したフォルダが作成されます。

-t

hostsおよびservicesファイルを採取しない場合に指定します。

-u

クラッシュダンプを採取しない場合に指定します。Windows 7，Windows Server 2008，またはWindows Vista版のJP1/IM - Viewではこのオプションは使用できません。

-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（JP1/IM - Central Scope）がすでに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分）です。

戻り値

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がすでに存在する
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 - Central Console）またはJP1/IM - Viewのスレッドダンプがある状態でjim_log.batを実行すると，メッセージKAVB8946-Iを表示してスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」を入力した場合，スレッドダンプを削除します。

必要に応じて採取した資料を圧縮ツールなどで圧縮してください。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.3　トラブル発生時に採取が必要な資料」を参照してください。

資料格納フォルダの直下に格納された資料のフォルダ構成および資料内容を次に示します。

表1-30　物理ホストの一次資料の内部フォルダ構成

フォルダ名
格納された資料

資料格納フォルダ¥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/IM - Central Console）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥conf
JP1/IM - Manager（JP1/IM - Central Console）の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥default
JP1/IM - Manager（JP1/IM - Central Console）の共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥log
JP1/IM - Manager（JP1/IM - Central Console）のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥scope
JP1/IM - Manager（JP1/IM - Central Scope）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥conf
JP1/IM - Manager（JP1/IM - Central Scope）の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥default
JP1/IM - Manager（JP1/IM - Central Scope）の共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥log
JP1/IM - Manager（JP1/IM - Central Scope）のログファイル

資料格納フォルダ¥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¥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
統合トレースログ

表1-31　物理ホストの二次資料の内部フォルダ構成

フォルダ名
格納された資料

資料格納フォルダ¥jp1_default¥imm_2nd¥cons
JP1/IM - Manager（JP1/IM - Central Console）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_2nd¥cons¥operation¥discrim
JP1/IM - Manager（JP1/IM - Central Console）のインシデント登録履歴ファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥cons¥operation¥evgen
JP1/IM - Manager（JP1/IM - Central Console）の相関イベント発行履歴ファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥scope
JP1/IM - Manager（JP1/IM - Central Scope）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_2nd¥scope¥database
JP1/IM - Manager（JP1/IM - Central Scope）の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データベースのバックアップファイル

表1-32　論理ホストの一次資料の内部フォルダ構成

フォルダ名 | 格納された資料
資料格納フォルダ¥論理ホスト名¥imm_1st¥cons | JP1/IM - Manager（JP1/IM - Central Console）の論理ホストの資料格納フォルダ
資料格納フォルダ¥論理ホスト名¥imm_1st¥cons¥conf | JP1/IM - Manager（JP1/IM - Central Console）の論理ホストの設定および定義ファイル
資料格納フォルダ¥論理ホスト名¥imm_1st¥cons¥log | JP1/IM - Manager（JP1/IM - Central Console）の論理ホストのログファイル
資料格納フォルダ¥論理ホスト名¥imm_1st¥scope | JP1/IM - Manager（JP1/IM - Central Scope）の論理ホストの資料格納フォルダ
資料格納フォルダ¥論理ホスト名¥imm_1st¥scope¥conf | JP1/IM - Manager（JP1/IM - Central Scope）の論理ホストの設定および定義ファイル
資料格納フォルダ¥論理ホスト名¥imm_1st¥scope¥log | JP1/IM - Manager（JP1/IM - Central Scope）の論理ホストのログファイル
資料格納フォルダ¥論理ホスト名¥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¥imcf¥conf¥imcf | IM構成管理の設定および定義ファイル
資料格納フォルダ¥論理ホスト名¥imm_1st¥imdb¥database¥imdb | IMデータベースのログの詳細情報
資料格納フォルダ¥論理ホスト名¥imm_1st¥imcf¥log¥imcf | IM構成管理のログファイル
資料格納フォルダ¥論理ホスト名¥imm_1st¥imdb¥log¥imdb | IMデータベースのログファイル

表1-33　論理ホストの二次資料の内部フォルダ構成

フォルダ名 | 格納された資料
資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons | JP1/IM - Manager（JP1/IM - Central Console）の論理ホストの資料格納フォルダ
資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons¥operation¥discrim | JP1/IM - Manager（JP1/IM - Central Console）の論理ホストのインシデント登録履歴ファイル
資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons¥operation¥evgen | JP1/IM - Manager（JP1/IM - Central Console）の論理ホストの相関イベント発行履歴ファイル
資料格納フォルダ¥論理ホスト名¥imm_2nd¥scope | JP1/IM - Manager（JP1/IM - Central Scope）の論理ホストの資料格納フォルダ
資料格納フォルダ¥論理ホスト名¥imm_2nd¥scope¥database | JP1/IM - Manager（JP1/IM - Central Scope）の論理ホストの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データベースのバックアップファイル

形式

jim_log.bat -f 資料格納フォルダ
           [-h 論理ホスト名]
           [-t]
           [-u]
           [-n]
           [-p]
           [-r]
           [-e]
           [-g]
           [-a]
           [-s]
           [-c]
           [-d]
           [-x]
           [-w]
           [-q]

-aオプションは，BJEXと連携した場合に使用するオプションです。-aオプションの詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「9.6.2　jim_log.bat（Windows限定）」を参照してください。

実行権限

Windows Server 2003の場合：なし

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

UNIXの場合：なし

格納先ディレクトリ

Managerパス¥tools¥

引数

-f 資料格納フォルダ

採取した資料を出力するフォルダ名をフルパスまたはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲んで指定します。このオプションは省略できません。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。すでに存在するフォルダを指定した場合は，いったんそのフォルダを削除してから，指定したフォルダが作成されます。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。このオプションを省略した場合，物理ホストの資料だけ採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため，クラスタシステムで使用する場合には論理ホスト名を必ずこのオプションで指定してください。

-t

hostsおよびservicesファイルを採取しない場合に指定します。

-u

クラッシュダンプを採取しない場合に指定します。Windows Server 2008版のJP1/IM - Managerではこのオプションは使用できません。

-n

JP1/Baseの保守資料を採取しない場合に指定します。

-p

JP1/BaseのイベントDBを取得しない場合に指定します。

-r

JP1/Baseのコマンド実行履歴ファイルを採取しない場合に指定します。

-e

インシデント登録履歴ファイルを採取しない場合に指定します。

-g

相関イベント発行履歴ファイルを採取しない場合に指定します。

-a

応答待ちイベント滞留ファイルを採取しない場合に指定します。

-s

JP1/IM - Manager（JP1/IM - Central Scope）の保守資料を採取しない場合に指定します。

-c

IM構成管理の保守資料を採取しない場合に指定します。

-d

IMデータベースの保守資料を採取しない場合に指定します。

-x

IMデータベースのバックアップファイルを採取する場合に指定します。

IMデータベースのバックアップファイルは，デフォルトで採取するIMデータベースの保守資料には含まれていません。IMデータベースサービスが起動していない場合は，保守資料を採取しません。IMデータベースサービスを起動したあと，資料採取コマンドを再実行してください。なお，資料採取時にJP1/IM-Managerが起動していても採取できます。

-w

JP1/IM - Viewの保守資料を採取しない場合に指定します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

注意事項

このツールによって採取できる資料の総容量は膨大になるため，このツールを実行する前に必要容量を見積もり，ご使用のマシンの空き容量を確認する必要があります。詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.4　資料の採取方法」を参照してください。

このツールを複数同時に実行しないでください。資料が上書きされたり，採取できなかったりする場合があります。

採取するファイルが見つからない場合，「ファイルが見つかりません」などのメッセージが表示されることがありますが，対処の必要はありません。

戻り値

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（JP1/IM - Central Console）のコアダンプやスレッドダンプがある状態でjim_log.shコマンドを実行すると，メッセージKAVB8941-IまたはKAVB8942-Iを表示してコアダンプまたはスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」または「yes」を入力した場合，コアダンプまたはスレッドダンプを削除します。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.3　トラブル発生時に採取が必要な資料」を参照してください。

採取した資料を圧縮したファイルを次に示します。

表1-34　採取した資料を圧縮したファイル

ファイル名 | 内容
jp1_default_imm_1st.tar.Z | 物理ホストの一次資料を格納します。
jp1_default_imm_2nd.tar.Z | 物理ホストの二次資料を格納します。
論理ホスト名_imm_1st.tar.Z※ | 論理ホストの一次資料を格納します。
論理ホスト名_imm_2nd.tar.Z※ | 論理ホストの二次資料を格納します。

注※　-hオプションで論理ホストを指定した場合にだけ作成されます。

圧縮されたファイルは，資料格納ディレクトリに格納されます。圧縮された各ファイルの内部ディレクトリ構成を次に示します。

表1-35　物理ホストの一次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名 | 格納された資料
./etc/opt/jp1base | JP1/Baseの自動起動および自動終了スクリプト
./etc/opt/jp1base/conf | JP1/Baseの設定および定義ファイル
./etc/opt/jp1base/default | JP1/Baseの共通定義情報
./etc/opt/jp1cons | JP1/IM - Manager（JP1/IM - Central Console）の自動起動および自動終了スクリプト
./etc/opt/jp1cons/conf | JP1/IM - Manager（JP1/IM - Central Console）の設定および定義ファイル
./etc/opt/jp1cons/default | JP1/IM - Manager（JP1/IM - Central Console）の共通定義情報
./etc/opt/jp1imm/conf/tools | JP1/IM - Managerの設定および定義ファイル
./etc/opt/jp1imm/conf/imcf | IM構成管理の設定および定義ファイル
./etc/opt/jp1imm/conf/imdb | IMデータベースの設定および定義ファイル
./etc/opt/jp1imm/default/imcf | IM構成管理の共通定義情報
./etc/opt/jp1scope/conf | JP1/IM - Manager（JP1/IM - Central Scope）の設定および定義ファイル
./etc/opt/jp1scope/default | JP1/IM - Manager（JP1/IM - Central Scope）の共通定義情報
./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（JP1/IM - Central Console）のログファイル
./var/opt/jp1imm/database/imdb | IMデータベースのログの詳細情報
./var/opt/jp1imm/log/imcf | IM構成管理のログファイル
./var/opt/jp1imm/log/imdb | IMデータベースのログファイル
./var/opt/jp1imm/log/_jp1_default/oslog | OSのログ情報
./var/opt/jp1scope/log | JP1/IM - Manager（JP1/IM - Central Scope）のログファイル

表1-36　物理ホストの二次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名
格納された資料

./var/opt/jp1base/log/COMMAND
JP1/Baseのコマンド実行履歴ファイル

./var/opt/jp1base/sys/event/servers/default
JP1/BaseのイベントDB

./var/opt/jp1cons/operation/discrim
JP1/IM - Manager（JP1/IM - Central Console）のインシデント登録履歴ファイル

./var/opt/jp1cons/operation/evgen
JP1/IM - Manager（JP1/IM - Central Console）の相関イベント発行履歴ファイル

./var/opt/jp1imm/log/_jp1_default/oslog
OSのログ情報

./var/opt/jp1imm/log/_jp1_default/core
コアファイル

./var/opt/jp1scope/database
JP1/IM - Manager（JP1/IM - Central Scope）のDB情報

./var/opt/jp1imm/data/imcf
IM構成管理のデータファイル

./var/opt/jp1imm/database/imdb/imdbbackup.dat
IMデータベースのバックアップファイル

./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-37　論理ホストの一次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名 | 格納された資料
./共有ディスク/jp1base/../event | JP1/Baseの論理ホストのイベントサーバ設定
./共有ディスク/jp1base/conf | JP1/Baseの論理ホストの設定および定義ファイル
./共有ディスク/jp1base/log | JP1/Baseの論理ホストのログファイル
./共有ディスク/jp1cons/conf | JP1/IM - Manager（JP1/IM - Central Console）の論理ホストの設定および定義ファイル
./共有ディスク/jp1cons/log | JP1/IM - Manager（JP1/IM - Central Console）の論理ホストのログファイル
./共有ディスク/jp1scope/conf | JP1/IM - Manager（JP1/IM - Central Scope）の論理ホストの設定および定義ファイル
./共有ディスク/jp1scope/log | JP1/IM - Manager（JP1/IM - Central Scope）の論理ホストのログファイル
./var/opt/jp1imm/log/_論理ホスト名/oslog | OSのログ情報
./共有ディスク/jp1imm/conf/imcf | IM構成管理の設定および定義ファイル
./var/opt/jp1imm/database/imdb | IMデータベースのログの詳細情報
./共有ディスク/jp1imm/log/imcf | IM構成管理のログファイル
./var/opt/jp1imm/log/imdb | IMデータベースのログファイル

表1-38　論理ホストの二次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名 | 格納された資料
./共有ディスク/event | JP1/BaseのイベントDB
./共有ディスク/jp1base/log/COMMAND | JP1/Baseのコマンド実行履歴ファイル
./共有ディスク/jp1cons/operation/discrim | JP1/IM - Manager（JP1/IM - Central Console）のインシデント登録履歴ファイル
./共有ディスク/jp1cons/operation/evgen | JP1/IM - Manager（JP1/IM - Central Console）の相関イベント発行履歴ファイル
./共有ディスク/jp1scope/database | JP1/IM - Manager（JP1/IM - Central Scope）のDB情報
./var/opt/jp1imm/log/_論理ホスト名/oslog | OSのログ情報
./var/opt/jp1imm/log/_論理ホスト名/core | コアファイル
./共有ディスク/jp1imm/data/imcf | IM構成管理のデータファイル
./共有ディスク/jp1imm/database/imdb/imdbbackup.dat | IMデータベースのバックアップファイル

形式

jim_log.sh -f 資料格納ディレクトリ
          [-h 論理ホスト名]
          [-t]
          [-u]
          [-n]
          [-p]
          [-r]
          [-e]
          [-g]
          [-a]
          [-s]
          [-c]
          [-d]
          [-x]
          [-q]
          [ディレクトリ名またはファイル名...]

-aオプションは，BJEXと連携した場合に使用するオプションです。-aオプションの詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「9.6.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のコマンド実行履歴ファイルを採取しない場合に指定します。

-e

インシデント登録履歴ファイルを採取しない場合に指定します。

-g

相関イベント発行履歴ファイルを採取しない場合に指定します。

-a

応答待ちイベント滞留ファイルを採取しない場合に指定します。

-s

JP1/IM - Manager（JP1/IM - Central Scope）の保守資料を採取しない場合に指定します。

-c

IM構成管理の保守資料を採取しない場合に指定します。

-d

IMデータベースの保守資料を採取しない場合に指定します。

-x

IMデータベースのバックアップファイルを採取する場合に指定します。

IMデータベースのバックアップファイルは，デフォルトで採取するIMデータベースの保守資料には含まれていません。IMデータベースサービスが起動していない場合は，保守資料を採取しません。IMデータベースサービスを起動したあと，資料採取コマンドを再実行してください。なお，資料採取時にJP1/IM-Managerが起動していても採取できます。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

ディレクトリ名またはファイル名

資料採取ツールで任意のファイルまたはディレクトリを採取したいときに指定します。フルパス名で指定してください。複数指定する場合は，スペースで区切ってください。

なお，このオプションは，指定したいほかのオプションをすべて指定したあとに指定してください。採取した資料は物理ホストの一次資料に格納されます。

注意事項

このツールによって採取できる資料の総容量は膨大になるため，このツールを実行する前に必要容量を見積もり，ご使用のマシンの空き容量を確認する必要があります。詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.4　資料の採取方法」を参照してください。

このツールを複数同時に実行しないでください。資料が上書きされたり，採取できなかったりする場合があります。

戻り値

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領域内のシステムログファイル，アンロードログファイルはバックアップしません。

拡張用バックアップ

データベースのサイズ拡張をするために，一時退避するためのデータをバックアップします。バックアップ対象は，データベース内の統合監視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/IM-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM-Manager DB Cluster Service）が停止している必要があります。

バックアップファイルは，復旧用と拡張用の区別ができないため，ファイル名にそれぞれが区別できる文字を指定することを推奨します。

バックアップファイルのアクセス権は，ユーザーがアクセスできる状態で出力されます。バックアップ取得後，アクセス権を変更するか，ユーザーがアクセスできない場所へ移動することを推奨します。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

jimdbreclaim

機能

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

バッチジョブなどでホスト情報やJP1/IMのシステム構成情報など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 | 異常終了

注意事項

このコマンドの実行中に，ほかのJP1/IM - Managerのコマンドを実行しないでください。実行が失敗することがあります。

このコマンドの実行中はCPUが高負荷状態になるため，参照・更新の頻度が低い夜間などの時間帯に実行することをお勧めします。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押して処理を中止した場合，データベースの空き領域解放に失敗することがあります。コマンドを再実行するには，別プロセスが動作している場合があるため，pdreclaimとpdrorgプロセスが実行されていないことを確認してください。これらのプロセスが実行中の場合，しばらく時間をおいてから再確認してください。

このコマンドの実行中にデータベースサービスを停止しないでください。
実行中にデータベースサービスを停止した場合は，データベースサービスを起動後にコマンドの再実行が必要です。

Windowsの場合，IMデータベースサービス「JP1/IM-Manager DB Server」が起動している必要があります。

jimdbrecovery

機能

バックアップで保管しておいたデータベースを復旧（リカバリー）するコマンドです。リカバリーできるデータの種類を次に示します。

障害復旧用リカバリー

データベースの障害が発生した際に，定期的に取得しているバックアップデータを利用してデータベースを復旧します。システムログを使用しないで，バックアップデータだけを復旧します。

拡張用リカバリー

データベースのサイズ拡張をするために，一時退避するためのデータをバックアップします。バックアップ対象は，データベース内の統合監視DB領域，IM構成管理DB領域です。

データベースのサイズ拡張をするために，一時退避しておいたバックアップデータを利用してデータベースを復旧します。

形式

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/IM-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM-Manager DB Cluster Service）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

jimdbrorg

機能

IM構成管理DBの断片化された空き領域を再編成するコマンドです。

空き領域によるデータの非効率化を防ぐために，データベースの再編成は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/IM-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM-Manager DB Cluster Service）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

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データベースがセットアップされていない

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サービスが停止している必要があります。

jimdbupdate

機能

セットアップ済みのIMデータベースをアップデートするコマンドです。

形式

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データベースのクラスタサービスが停止している必要があります。ただし，IM統合監視でIMデータベースを使用していない，かつ，IM構成管理をセットアップしていない場合はJP1/IM-Managerサービスは停止する必要はありません。
物理ホストの場合
　JP1/IM-Managerサービス（JP1/IM-Manager）
　IMデータベースのクラスタサービス（JP1/IM-Manager DB Cluster Service）
論理ホストの場合
　JP1/IM-Managerサービス（JP1/IM-Manager_論理ホスト名）
　IMデータベースのクラスタサービス（JP1/IM - Manager DB Cluster Service_論理ホスト名）

UNIXの場合，JP1/IM-Managerサービスが停止している必要があります。ただし，IM統合監視でIMデータベースを使用していない，かつ，IM構成管理をセットアップしていない場合はJP1/IM-Managerサービスは停止する必要はありません。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdeinstallのプロセスが実行していないことを確認してから再度コマンドを実行してください。

jp1cc_setup（UNIX限定）

機能

JP1/IM - Manager（JP1/IM - Central Console）の動作環境を設定します。

このコマンドは，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/IM - Central Console）の論理ホストの動作環境を設定します。クラスタシステムでの環境設定に使います。

環境設定は，実行系，待機系の順に設定します。

実行系の環境設定では，論理ホスト名と共有ディレクトリ名の指定が必要です。コマンドを実行すると指定した共有ディレクトリに定義ファイルなどがコピーされるため，あらかじめ共有ディスクを使用できる状態にしておいてください。

待機系の環境設定では，論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。

なお，待機系の環境設定をする前に，JP1/Baseのjbsgetcnfコマンドとjbssetcnfコマンドを使って，実行系で設定した共通定義情報を待機系にコピーする必要があります。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cc_setup_cluster -h 論理ホスト名
                  [-d 共有ディレクトリ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1cons/bin/

引数

-h 論理ホスト名

環境を設定する論理ホストのホスト名を指定します。指定できる文字数は，1～63バイトです。

論理ホスト名は，hostsファイルやネームサーバに設定し，TCP/IP通信ができるようにしてください。DNS運用の場合は，FQDN形式でないホスト名を指定します。例えば，「jp1v6.soft.hitachi.co.jp」の場合は，「jp1v6」を指定します。

-d 共有ディレクトリ名

系切り替え時に引き継ぐ情報を格納する共有ディレクトリを指定します。共有ディスク上のディレクトリを指定してください。指定できる文字数は，1～165バイトです。

指定した共有ディレクトリには，次のディレクトリを作成し，定義ファイルを/etc/opt/jp1cons/conf/からコピーします。

表1-39　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-40　実行系の設定，待機系の設定

コマンド実行ホスト | 設定項目 | 設定概要
実行系 | 論理ホストの共通定義の設定 | jbsgetcnf，jbssetcnfコマンドを使用して物理ホストのIM構成管理の共通定義を論理ホストの共通定義として設定する。その際，ディレクトリ名などの設定を変更する。
共有ディレクトリの作成 | 共有ディレクトリ以下に必要なディレクトリを作成する。
定義ファイルのコピー | /opt/jp1imm/conf/imcf以下の定義ファイルを共有ディレクトリ/jp1imm/conf/imcf以下にコピーする。
論理ホストのセントラルコンソールに対するIM構成管理の起動設定 | jcoimdefコマンドを使用して論理ホストのセントラルコンソールのプロセス管理と連動してIM構成管理サービスが起動するようにする。
物理ホストのIM構成管理の通信方式の変更 | 物理ホストのIM構成管理の通信方式をIPバインド方式に変更する。
待機系 | 物理ホストの通信方式の変更 | 同上

共通定義の設定

IM構成管理のクラスタセットアップは，論理ホストの共通定義に対して次の値を設定します。

表1-41　論理ホストの共通定義

パス | キー名称 | 設定値
論理ホスト名¥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-42　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¥

注意事項

このコマンドは，クラスタシステムでのJP1/IM - Manager（JP1/IM - Central Console）の環境設定で使用します。JP1/IM - Manager（JP1/IM - Central Scope）の環境設定をする場合は，jp1cshasetupコマンドを使用してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストを設定しておく必要があります。JP1/Baseの設定方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1cohasetup（Windows限定）

機能

JP1/IM - Manager（JP1/IM - Central Console）の論理ホストの動作環境を設定する［Central Consoleクラスタ構成の設定］ダイアログボックスを表示するコマンドです。クラスタシステムでのJP1/IM - Manager（JP1/IM - Central Console）の環境設定で使用します。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cohasetup

実行権限

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

格納先ディレクトリ

Consoleパス¥bin¥

注意事項

このコマンドは，クラスタシステムでのJP1/IM - Manager（JP1/IM - Central Console）の環境設定で使用します。JP1/IM - Manager（JP1/IM - Central Scope）の環境設定をする場合は，jp1cshasetupコマンドを使用してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストを設定しておく必要があります。JP1/Baseの設定方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1cohaverup

機能

08-50以前のJP1/IM - ManagerまたはJP1/IM - Central Consoleで設定した論理ホスト環境をバージョンアップします。08-50以前のJP1/IM - ManagerまたはJP1/IM - Central Consoleからバージョンアップした場合に実行してください。

形式

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 - Central Scope）の動作環境を設定します。

このコマンドは，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/IM - Central Scope）の論理ホストの動作環境を設定します。クラスタでの環境設定に使います。

環境設定は，実行系，待機系の順に設定します。

実行系の環境設定では，論理ホスト名と共有ディレクトリ名の指定が必要です。コマンドを実行すると指定した共有ディレクトリに定義ファイルなどがコピーされるため，あらかじめ共有ディスクを使用できる状態にしておいてください。

待機系の環境設定では，論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。

なお，待機系の環境設定をする前に，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通信ができるようにしてください。DNS運用の場合は，FQDN形式でないホスト名を指定します。例えば，「jp1v6.soft.hitachi.co.jp」の場合は，「jp1v6」を指定します。

-d 共有ディレクトリ名

系切り替え時に引き継ぐ情報を格納する共有ディレクトリを指定します。共有ディスク上のディレクトリを指定してください。指定できる文字数は，1～165バイトです。

指定した共有ディレクトリには，次のディレクトリを作成し，定義ファイルを/etc/opt/jp1scope/conf/からコピーします。

表1-43　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（JP1/IM - Central Scope）の論理ホストの動作環境を設定する［Central Scopeクラスタ構成の設定］ダイアログボックスを表示するコマンドです。クラスタシステムでのJP1/IM - Manager（JP1/IM - Central Scope）の環境設定で使用します。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cshasetup

実行権限

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

格納先ディレクトリ

Scopeパス¥bin¥

注意事項

このコマンドは，クラスタシステムでのJP1/IM - Manager（JP1/IM - Central Scope）の環境設定で使用します。JP1/IM - Manager（JP1/IM - Central Console）の環境設定をする場合は，jp1cohasetupコマンドを使用してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストの設定をしておく必要があります。JP1/Baseの設定作業については，マニュアル「JP1/Base 運用ガイド」のクラスタシステムで運用する場合の設定の章を参照してください。
また，事前にJP1/IM - Manager（JP1/IM - Central Console）の論理ホストの設定をしておく必要があります。

jp1cshaverup（UNIX限定）

機能

08-01以前のJP1/IM - Central Scopeで設定した論理ホスト環境をバージョンアップします。08-01以前のJP1/IM - Central Scopeからバージョンアップした場合に実行してください。

インストールした新しいバージョンのJP1/IM - Central Scopeの機能を使用したい場合には必ず実行してください。ただし，08-01以前の機能範囲で使用したい場合には，実行しないでください。

形式

jp1cshaverup -h 論理ホスト名
            [-w 作業ディレクトリ]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

注　このコマンドは，Linux版JP1/IM - Managerには同梱されていません。

引数

-h 論理ホスト名

バージョンアップする論理ホスト名を指定します。このオプションを省略した場合は，エラーとなります。

-w 作業ディレクトリ

JP1/IM - Central Scopeの論理ホスト環境をバージョンアップするための作業ディレクトリをフルパスで指定します。

このオプションを省略した場合は，/opt/jp1scope/tmp/を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

jp1cshaverupコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Central Scopeとして動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0 | 正常終了
1 | 指定した論理ホスト名が存在しない
2 | 引数エラー
4 | コマンドを実行する権限がない
12 | メモリー不足
13 | ディスク容量不足
31 | DB初期化エラー
32 | データアクセスエラー
42 | サービスが起動中
45 | 新しいバージョンのデータベースに対してコマンドを実行しようとした
99 | その他のエラー

使用例

作業ディレクトリ/temp/で，08-01のJP1/IM - Central Scopeの論理ホスト環境logicalhostをバージョンアップします。

jp1cshaverup -h logicalhost -w /temp

出力例

クラスタ環境のバージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1cshaverup.bat（Windows限定）

機能

08-01以前のJP1/IM - Central Scopeで設定した論理ホスト環境をバージョンアップします。08-01以前のJP1/IM - Central Scopeからバージョンアップした場合に実行してください。

インストールした新しいバージョンのJP1/IM - Central Scopeの機能を使用したい場合には必ず実行してください。ただし，08-01以前の機能範囲で使用したい場合には，実行しないでください。

形式

jp1cshaverup.bat -h 論理ホスト名
               [-w 作業ディレクトリ]

実行権限

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

格納先ディレクトリ

Scopeパス¥bin¥

引数

-h 論理ホスト名

バージョンアップする論理ホスト名を指定します。このオプションを省略した場合は，エラーとなります。

-w 作業ディレクトリ

JP1/IM - Central Scopeの論理ホスト環境をバージョンアップするための作業フォルダをフルパスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

このオプションを省略した場合は，Scopeパス¥tmp¥を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

jp1cshaverup.batコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Central Scopeとして動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0 | 正常終了
1 | 指定した論理ホスト名が存在しない
2 | 引数エラー
4 | コマンドを実行する権限がない
12 | メモリー不足
13 | ディスク容量不足
31 | DB初期化エラー
32 | データアクセスエラー
42 | サービスが起動中
45 | 新しいバージョンのデータベースに対してコマンドを実行しようとした
99 | その他のエラー

使用例

作業フォルダC:¥temp¥で，08-01のJP1/IM - Central Scopeの論理ホスト環境logicalhostをバージョンアップします。

jp1cshaverup -h logicalhost -w C:¥temp

出力例

クラスタ環境のバージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1csverup（UNIX限定）

機能

08-01以前のJP1/IM - Central Scopeで設定した物理ホストの環境をバージョンアップします。08-01以前のJP1/IM - Central Scopeからバージョンアップした場合に実行してください。

インストールした新しいバージョンのJP1/IM - Central Scopeの機能を使用したい場合には必ず実行してください。ただし，08-01以前の機能範囲で使用したい場合には，実行しないでください。

形式

jp1csverup [-w 作業ディレクトリ]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

注　このコマンドは，Linux版JP1/IM - Managerには同梱されていません。

引数

-w 作業ディレクトリ

JP1/IM - Central Scopeの物理ホストの環境をバージョンアップするための作業ディレクトリをフルパスで指定します。

このオプションを省略した場合は，/opt/jp1scope/tmp/を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

このコマンドを実行する前にディスクの空き容量を確認してください。このコマンドを実行するには，監視オブジェクトDB分の空き容量が必要です。監視オブジェクトDBは，次に示すディレクトリ内のすべてのデータです。
/var/opt/jp1scope/database/jcsdb/

jp1csverupコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Central Scopeとして動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0 | 正常終了
2 | 引数エラー
4 | コマンドを実行する権限がない
12 | メモリー不足
13 | ディスク容量不足
31 | DB初期化エラー
32 | データアクセスエラー
42 | サービスが起動中
45 | 新しいバージョンのデータベースに対してコマンドを実行しようとした
99 | その他のエラー

使用例

作業ディレクトリ/temp/で，08-01のJP1/IM - Central Scopeの物理ホスト環境をバージョンアップします。

jp1csverup -w /temp

出力例

バージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1csverup.bat（Windows限定）

機能

08-01以前のJP1/IM - Central Scopeで設定した物理ホストの環境をバージョンアップします。08-01以前のJP1/IM - Central Scopeからバージョンアップした場合に実行してください。

インストールした新しいバージョンのJP1/IM - Central Scopeの機能を使用したい場合には必ず実行してください。ただし，08-01以前の機能範囲で使用したい場合には，実行しないでください。

形式

jp1csverup.bat [-w 作業ディレクトリ]

実行権限

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

格納先ディレクトリ

Scopeパス¥bin¥

引数

-w 作業ディレクトリ

JP1/IM - Central Scopeの物理ホストの環境をバージョンアップするための作業フォルダをフルパスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

このオプションを省略した場合は，Scopeパス¥tmp¥を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

このコマンドを実行する前にディスクの空き容量を確認してください。このコマンドを実行するには，監視オブジェクトDB分の空き容量が必要です。監視オブジェクトDBは，次に示すフォルダ内のすべてのデータです。
Scopeパス¥database¥jcsdb¥

jp1csverup.batコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Central Scopeとして動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0 | 正常終了
2 | 引数エラー
4 | コマンドを実行する権限がない
12 | メモリー不足
13 | ディスク容量不足
31 | DB初期化エラー
32 | データアクセスエラー
42 | サービスが起動中
45 | 新しいバージョンのデータベースに対してコマンドを実行しようとした
99 | その他のエラー

使用例

作業フォルダC:¥tempで，08-01のJP1/IM - Central Scopeの物理ホスト環境をバージョンアップします。

jp1csverup -w C:¥temp

出力例

バージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

SpmSetSvcCon（Windows限定）

機能

JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を設定，または解除するコマンドです。

形式

SpmSetSvcCon -setdepend {yes|no}

実行権限

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

格納先ディレクトリ

Consoleパス¥bin¥

引数

-setdepend {yes|no}

登録してあるサービスに対して，依存関係を設定します。

yes：JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を設定します。

no：JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を解除します。

戻り値

0 | 正常終了
1 | 引数エラー
2 | 実行権限エラー
3 | JP1/IM-Managerサービスが登録されていない
255 | その他のエラー

2.　定義ファイル

この章では，JP1/IMの定義ファイルの形式および文法について説明します。

＜この章の構成＞

定義ファイル一覧

定義ファイルの記述形式

ユーザー独自のイベント属性を表示するための定義ファイルについて

構成定義ファイル（jbs_route.conf）

環境変数ファイル

ホストグループ定義ファイル

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

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

発生元ホストマッピング定義ファイル（user_hostmap.conf）

自動アクション環境定義ファイル（action.conf.update）

自動アクション定義ファイル（actdef.conf）

自動アクション定義ファイル（actdef.conf）（互換用）

自動アクション通知定義ファイル（actnotice.conf）

イベント条件表示項目定義ファイル（attr_list.conf）

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

拡張起動プロセス定義ファイル（jp1co_service.conf）

IMパラメーター定義ファイル（jp1co_param_V7.conf）

システムプロファイル（.system）

ユーザープロファイル（defaultUser | profile_ユーザー名）

通信環境定義ファイル（console.conf.update）

ヘルスチェック定義ファイル（jcohc.conf）

WWWページ版動作定義ファイル（console_ja.html）

イベントガイド情報ファイル（jco_guide.txt）

システムカラー定義ファイル（systemColor.conf）

イベント拡張属性定義ファイル

共通除外条件拡張定義ファイル

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

対処状況イベント定義ファイル（processupdate.conf）

相関イベント発行システムプロファイル（egs_system.conf）

相関イベント発行定義ファイル

相関イベント発行環境定義ファイル

インシデント登録用システムプロファイル（eds_system.conf）

インシデント手動登録定義ファイル（incident.conf）

インシデント登録環境定義ファイル（jcdmain.conf.update）

ホスト情報ファイル（jcs_hosts）

ガイド情報ファイル（jcs_guide_xxx.txt）

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）

対処済み連動設定ファイル（action_complete_xxx.conf）

状態変更イベント自動削除設定ファイル

監視オブジェクト初期化設定ファイル

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）

オブジェクトタイプ定義ファイル

アプリケーション実行定義ファイル

CMホスト定義ファイル（jcs_atc_cm_host.conf）

状態変更条件メモリー常駐機能の設定ファイル

重大度変更定義ファイル（jcochsev.conf）

通信環境定義ファイル（view.conf.update）

通信環境定義ファイル（tree_view.conf.update）

IM-View設定ファイル（tuning.conf）

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

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

統合機能メニュー定義ファイル

コマンドボタン定義ファイル（cmdbtn.conf）

起動プログラム定義ファイル（!JP1_CS_APP0.conf）

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）

ツリー構成ファイル

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

セットアップ情報ファイル（jimdbsetupinfo.conf）

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

イベントレポート出力の項目ファイル

イベントレポート出力のフィルターファイル

定義ファイルのステートメントの詳細

定義ファイル一覧

JP1/Integrated Managementの定義ファイルの一覧を次に示します。

表2-1　定義ファイル一覧

製品名
定義ファイル名
説明

JP1/Base
構成定義ファイル（jbs_route.conf）
JP1/IMで管理するシステムの階層構造を定義するファイルです。

環境変数ファイル
JP1/IMの管理対象ホストでコマンドを実行するときの環境変数を定義するファイルです。

ホストグループ定義ファイル
JP1/IMの管理対象ホストのグループを定義するファイルです。

リモート監視ログファイルトラップ動作定義ファイル
リモート監視のログトラップ機能の動作を定義するファイルです。

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

JP1/IM - Manager
セントラルコンソール
発生元ホストマッピング定義ファイル（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）
ヘルスチェック機能を有効にするかどうかを定義するファイルです。

WWWページ版動作定義ファイル（console_ja.html）
WWWページ版のJP1/IM - Viewの動作を定義するファイルです。

イベントガイド情報ファイル（jco_guide.txt）
システムで発生した問題となるJP1イベントに対して，JP1イベント単位でイベントガイド情報を定義するファイルです。

対処状況イベント定義ファイル（processupdate.conf）
対処状況を変更したときにJP1イベントを発行するかどうかを定義するファイルです。

相関イベント発行システムプロファイル（egs_system.conf）
相関イベント発行サービスの起動時および停止時の動作を定義するファイルです。

相関イベント発行定義ファイル
相関イベントの発行処理の対象とするJP1イベントの条件と条件成立時に発行する相関イベントを定義するファイルです。

相関イベント発行環境定義ファイル
相関イベント発行履歴ファイルのサイズおよび面数を定義するファイルです。

インシデント登録用システムプロファイル（eds_system.conf）
JP1/IM - Incident Master連携用の定義ファイルです。インシデント登録サービスの基本動作を定義するファイルです。

インシデント手動登録定義ファイル（incident.conf）
JP1/IM - Incident Master連携用の定義ファイルです。JP1/IM - Viewの連携先JP1/IM - Incident Masterを定義するファイルです。

インシデント登録環境定義ファイル（jcdmain.conf.update）
JP1/IM - Incident Master連携用の定義ファイルです。次に示す内容を定義するファイルです。

インシデント登録履歴ファイルのサイズ，面数

JP1/IM - Incident Masterのポート番号（JP1/IM - Incident Master側の設定に合わせて定義します）

重大度変更定義ファイル（jcochsev.conf）
イベントの重大度変更機能で，重大度を変更するJP1イベントの条件と変更後の重大度を定義するファイルです。

コマンドボタン定義ファイル（cmdbtn.conf）
［コマンド実行］画面に表示する［コマンド］ボタンを定義するファイルです。

イベント条件表示項目定義ファイル（attr_list.conf）
［アクション詳細設定］画面の［属性名］表示領域に表示する表示項目を指定する定義ファイルです。

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）
自動アクションのイベント引き継ぎ機能の変換ルールを指定するファイルです。

イベントレポート出力の項目ファイル
イベントレポート出力で出力したいJP1イベントの属性を指定するファイルです。

イベントレポート出力のフィルターファイル
イベントレポート出力時のフィルター条件を指定する定義ファイルです。

システムカラー定義ファイル（systemColor.conf）
イベント一覧に使用する色の設定を定義するファイルです。

イベント拡張属性定義ファイル
JP1イベントの拡張属性を定義するファイルです。

オブジェクトタイプ定義ファイル
JP1イベントの拡張属性のオブジェクトタイプを定義するファイルです。

共通除外条件拡張定義ファイル
拡張モードの共通除外条件のイベント条件や適用期間を定義するファイルです。

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）
［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。

モニター画面呼び出し定義ファイル
モニター画面呼び出しの設定を定義するファイルです。

セントラルスコープ
ホスト情報ファイル（jcs_hosts）
JP1/IM - Manager（JP1/IM - Central Scope）が管理するホスト情報を定義するファイルです。

ガイド情報ファイル（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の破損を防ぐための機能を有効にするかどうかを定義するファイルです。

CMホスト定義ファイル（jcs_atc_cm_host.conf）
JP1/IM - Central Information Master連携用の定義ファイルです。
監視ツリー（システム構成ツリー）を自動生成するための定義情報を収集するJP1/IM - Central Information Masterホストを定義するファイルです。

状態変更条件メモリー常駐機能の設定ファイル
状態変更条件メモリー常駐機能を有効にするかどうかを設定するファイルです。

IM構成管理
IM構成管理・ビューアー動作定義ファイル（jcfview.conf）
IM構成管理・ビューアーの動作を指定するファイルです。

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）
JP1/IM - Managerをインストールすると自動生成されるファイルです。

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（JP1/IM - Central Console）間の通信でのタイムアウト時間を定義するファイルです。

通信環境定義ファイル（tree_view.conf.update）
JP1/IM - ViewとJP1/IM - Manager（JP1/IM - Central Scope）間の通信でのタイムアウト時間を定義するファイルです。

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とパスを定義するファイルです。

統合機能メニュー定義ファイル
統合機能メニューに表示するツリーを定義するファイルです。

注※1　JP1/IM - ManagerのUNIX版で使用するガイド情報ファイルは，JP1/IM - Managerが動作する言語コードによって異なります。ガイド情報ファイル（jcs_guide_xxx.txt）のxxx部分については，以降のガイド情報ファイルの詳細で説明します。

注※2　状態変更イベント件数の上限監視設定ファイル，対処済み連動設定ファイル，および監視オブジェクトDBの自動バックアップ・リカバリー設定ファイルはそれぞれ二つあります。xxx部分には，on，offのどちらかが入ります。

定義ファイルの記述形式

ここでは，定義ファイルの記述形式について説明します。

各定義ファイルで説明する項目は次のとおりです。ただし，定義ファイルによっては説明しない項目もあります。

形式

定義ファイルの形式について説明しています。

ファイル

定義ファイルのファイル名について説明しています。

格納先ディレクトリ

定義ファイルの格納場所について説明しています。

説明

定義ファイルの用途について説明しています。

定義の反映時期

定義ファイルが反映されるタイミングについて説明しています。

記述内容

定義ファイルの記述内容について説明しています。

定義例

定義ファイルの定義例について説明しています。

ユーザー独自のイベント属性を表示するための定義ファイルについて

JP1/IMの定義ファイルをカスタマイズすることによって，ほかのアプリケーションがJP1/IMと連携するための機能を拡張できるようになります。機能を拡張すると，次のことができます。

ユーザー独自のイベント属性を表示する

JP1/IM - Viewに表示されたJP1イベントからモニター画面を表示する

［統合機能メニュー］画面に新規メニューを追加する

機能の詳細については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「3.10　ユーザー独自のイベント属性の表示」を参照してください。

定義ファイルの概要

定義ファイルの中で，定義を記述するブロック間には関連があります。また，定義ファイル間にも関連があります。それらの関連を次の図に示します。

図2-1　定義ブロックおよび定義ファイルの関連

定義ファイルの命名規則

定義ファイルの命名規則を次に示します。

表2-2　定義ファイルの命名規則

定義ファイル名 | 命名規則
イベント拡張属性定義ファイル | 会社名_製品名_attr_ja.conf
オブジェクトタイプ定義ファイル | 会社名_製品名_obj.ja
アプリケーション実行定義ファイル | 会社名_製品名_app.conf
モニター画面呼び出し定義ファイル | 会社名_製品名_mon_ja.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";
attr name="E.SEVERITY", title="重大度";
attr name="B.TIME", title="登録時刻";
attr name="B.SOURCESERVER", title="登録ホスト";
attr name="E.USER_NAME", title="ユーザー名";
@define-block-end;

構成定義ファイル（jbs_route.conf）

形式

[マネージャーホスト１]
管理対象ホスト
管理対象ホスト
   ：
[マネージャーホスト２]
管理対象ホスト
   ：

ファイル

jbs_route.conf（構成定義ファイル）

jbs_route.conf.model（構成定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Baseパス¥conf¥route¥

論理ホストのとき

共有フォルダ¥jp1base¥conf¥route¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1base/conf/route/

論理ホストのとき

共有ディレクトリ/jp1base/conf/route/

説明

JP1/IMで管理するシステムの階層構造を定義するファイルです。

JP1/IMは，システムを管理するマネージャーと，管理対象であるエージェントによって，階層構造のシステム構成により運用します。また，マネージャーは階層化することができます。これによって，さまざまな規模のシステムを管理します。

システム階層構造は，JP1/IMの基盤機能を提供する前提製品JP1/Baseにより管理されています。

このファイルで定義した階層構造の情報を基にして，次のようにJP1/IMの機能が動作します。

JP1イベント転送
重要なJP1イベントは，構成定義情報で定義した，下位のホストから上位のホストへ転送されます（デフォルトの設定の場合）。

自動アクション，コマンド実行
構成定義情報で指定したホストに対して，自動アクションやコマンド実行によるコマンド実行指示を要求できます。

ファイルの最終行には，改行を入れてください。

定義の反映時期

構成定義情報の内容は，次のコマンドを実行して定義が反映されてから有効になります。

jbsrt_distrib（定義情報の配布）

jbsrt_sync（最上位マネージャーでの定義情報の同期）

jbsrt_del（定義情報の削除）

記述内容

[マネージャーホスト]

マネージャーのホスト名を指定します。

ホスト名は，1～255バイトの，半角英数字および記号（"-"," ."）で指定します。

システム構成を分割定義する場合は，ほかの構成定義ファイルと重複するホスト名の前に「*」を付けます。

マネージャーは，JP1/IM - Managerがインストールされているホストです。

管理対象ホスト

マネージャーによって管理される管理対象ホストのホスト名を指定します。

ホスト名は，1～255バイトの，半角英数字および記号（"-"," ."）で指定します。

システム構成を分割定義する場合は，ほかの構成定義ファイルと重複するホスト名の前に「*」を付けます。

管理対象ホストには，JP1/Baseがインストールされている必要があります。管理対象ホストは，複数のマネージャーを持つことはできません。

ホスト名には，hostsファイルやDNSに登録してあるホスト名，またはjp1hostsに定義しているホスト名を指定してください。

ホスト名として，誤って使用不可文字の「*」を記述した場合，jbsrt_distribコマンドが構成定義を削除する時に「*」が付いたホスト以下の構成定義情報が削除されません。

ホストをエイリアス名で定義する場合，定義ファイルに複数のエイリアス名を記述しないでください。同一ホストの複数のエイリアス名を記述した場合は，それぞれ別ホストとして扱われます。

コマンド実行，自動アクション機能を使用する場合，管理対象ホストにはコマンド実行，自動アクション機能で指定するホスト名を指定してください。また，指定するホストが物理ホストの場合，hostnameコマンドで返されるホスト名，または，そのホスト名に対するエイリアス名を指定してください。ただし，Windows 2000，Windows XP Professional，およびWindows Server 2003のホストは，エイリアス名で記述しないでください（エイリアス名の使用に関する制限はマネージャーの場合も同じです）。

定義例

次の表の階層構成でJP1/IMのシステムを組む場合の構成定義ファイルの定義例を一括定義する場合と分割定義する場合に分けて示します。

表2-6　JP1/IMのシステムの階層構成（例）

統合マネージャー | 拠点マネージャー | エージェント
jp1sv1 | jp1sv2 | jp1ag1，jp1ag2
jp1sv3 | jp1ag3，jp1ag4，jp1ag5

一括定義する場合

一括定義する場合，統合マネージャーで次のように構成定義ファイルを編集します（拠点マネージャー，エージェントでの編集は不要です）。

統合マネージャー（jp1sv1）の構成定義ファイル

[jp1sv1]
jp1sv2
jp1sv3
[jp1sv2]
jp1ag1
jp1ag2
[jp1sv3]
jp1ag3
jp1ag4
jp1ag5

分割定義する場合

分割定義する場合，統合マネージャー，各拠点マネージャーで次のように構成定義ファイルを編集します（エージェントでの編集は不要です）。

統合マネージャー（jp1sv1）の構成定義ファイル

[jp1sv1]
*jp1sv2
*jp1sv3

拠点マネージャー（jp1sv2）の構成定義ファイル

[*jp1sv2]
jp1ag1
jp1ag2

拠点マネージャー（jp1sv3）の構成定義ファイル

[*jp1sv3]
jp1ag3
jp1ag4
jp1ag5

環境変数ファイル

形式

環境変数名1=変数値1
[環境変数名2=変数値2]
   ：
   ：

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

コマンドを実行するホストの任意のフォルダ

UNIXの場合

コマンドを実行するホストの任意のディレクトリ

説明

JP1/IMの管理対象ホストでコマンドを実行するときの環境変数を定義するファイルです。

自動アクションやJP1/IM - Viewでの操作によって，JP1/IMの管理対象ホストでコマンドを実行するときには，そのコマンドの実行環境として環境変数を指定することができます。環境変数は，ここで説明している形式で記述された環境変数ファイルにより指定することができます。

環境変数ファイルのファイル名は任意です。複数の環境変数ファイルを用意することにより，実行するコマンドごとに任意の環境変数を指定することができます。

Windows環境で環境変数ファイルを指定しない場合，システムの環境変数でコマンドが実行されます。

各行の最後には，必ず改行を入れてください。

「環境変数名=変数値」の形式以外の文字列は指定しないでください。コマンドを実行するホスト側のOSによってはコマンドが異常終了することがあります。

定義の反映時期

環境変数ファイルは，コマンド実行を開始するときに参照されます。

記述内容

環境変数名

環境変数の名称を指定します。

改行文字を含む環境変数は指定できません。

指定する環境変数がシステム環境変数の場合は，環境変数名を「<-」と「->」で囲み，「<-variable->」のように指定してください。

変数値

環境変数の値を指定します。

ホストグループ定義ファイル

形式

ホストグループ名
{
ホスト名1
ホスト名2
  ：
  ：
}

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

JP1/IMの管理対象ホストのグループを定義するファイルです。

JP1/IMでは，自動アクションやJP1/IM - Viewの操作によりコマンドを実行するとき，実行先のホストをグループ化して，各ホストで同じコマンドを一括して実行することができます。

定義の反映時期

jcocmddefコマンドを実行して設定したあとに有効になります。

クラスタ構成で論理ホストの設定をする場合は，実行系と待機系の両方で設定してください。

記述内容

ホストグループ名

ホストグループを識別する名称を指定します。

ホストグループ名は，32文字以内の半角英数字で指定します。空白および全角文字は使用できません。

コマンドを実行するときにホストグループを対象とするときは，この名称を指定します。例えば，自動アクション定義ファイルの「d=実行先ホスト名・グループ名」の定義項目や，JP1/IM - Viewの［コマンド実行］画面の［実行ホスト名］などに指定します。

ホスト名

グループを構成するホストの名称を指定します。

ホスト名は，255文字以内の半角英数字で指定します。空白および全角文字は使用できません。

なお，ここで指定できるのは，構成定義ファイルで定義した管理対象ホストだけです。

ホストグループの削除

ホストグループを削除したいときは，ホストグループ定義ファイルに削除したいホストグループ名の空の定義を作成して，jcocmddefコマンドを実行してください。

ホストグループの編集

既存のホストグループの定義内容を変更したい場合は，同じホストグループ名でホストグループ定義ファイルを作り直し，jcocmddefコマンドを実行してください。

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

形式

retry-times=リトライ回数
retry-interval=リトライ間隔
open-retry-times=リトライ回数
open-retry-interval=リトライ間隔
hold-count=JP1イベントの保留件数
keep-event={ OLD | NEW }
FILETYPE={ SEQ | SEQ2 | WRAP2 }
HEADLINE=ヘッダーの行数
MARKSTR=[!]"正規表現"
[!]"正規表現n"※
ACTDEF=[{EXIT}][重大度][イベントID][!]"正規表現"
[!]"正規表現n"※

注※　「正規表現n」は複数の正規表現の指定を表します。

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥agtless¥以下の任意のパス

論理ホストのとき

共有フォルダ¥conf¥agtless¥以下の任意のパス

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/agtless/以下の任意のパス

論理ホストのとき

共有ディレクトリ/jp1imm/conf/agtless/以下の任意のパス

説明

リモート監視のログファイルトラップ機能の動作を定義するファイルです。リモート監視のログファイルトラップ機能の起動時にその内容を参照します。このファイルは，JP1/Baseのログファイルトラップ機能の動作定義ファイルと互換性があります。リモート監視のログファイルトラップ機能からJP1/Baseのログファイルトラップ機能への監視構成の変更については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「2.3　システムの階層構成での監視構成の変更」を参照してください。

定義の反映時期

次の場合に，リモート監視ログファイルトラップ動作定義ファイルの設定が有効になります。

［プロファイル表示/編集］画面でリロードまたは再起動
［プロファイル表示/編集］画面については，マニュアル「JP1/Integrated Management - Manager 画面リファレンス」の「4.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秒と見なします。リトライ間隔は，エラー発生後，リトライを試みるまでの間隔です。リトライ回数とリトライ間隔との組み合わせで，1時間以上の指定もできますが，リトライ開始から1時間を超えた場合，リトライオーバーとなり，該当ログファイルの監視を停止します。

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イベントから消去されます。

FILETYPE={ SEQ | SEQ2 | WRAP2 }

トラップするログファイルのデータ出力形式を次のどれかの値で指定します。省略した場合，SEQが指定されたものと見なします。

SEQ

シーケンシャルファイル（一つのログファイルに追加書き込みし続けるファイル，またはログファイルが一定の容量に達すると別のファイル名で新たにログファイルを作成して書き込むファイル）の場合に指定します。

SEQ2

ログの出力形式を，配下のディレクトリを含む同一ディレクトリ内にファイル名を変更した退避ファイルを作成したあと，変更前と同じ名称のファイルが再作成される形式のシーケンシャルファイルにする場合に指定します。

なお，作成された退避ファイルは，監視間隔の間は削除されません。また，監視間隔の間にログファイルが1回切り替わると，切り替わる前のファイル内から前回読み込んだデータ以降に蓄積されたデータを読み込んだあと，新たなファイル内のデータを読み込みます。そのため，監視間隔の間に2回以上切り替わると，切り替わる直前のファイルからのデータしか読み込めません。ログファイルが切り替わる頻度を考慮してjcfallogstartコマンドの-tオプション（ファイル監視間隔）を設定してください。

WRAP2

ラップアラウンドファイル（ラップアラウンドするとき，データを削除して再び先頭からデータを書き込むファイル）の場合に指定します。

WRAP2の場合，データをすべて読み込む前にラップアラウンドしてデータが削除されると，読み込めないデータが発生します。監視間隔を長くすると，一度に読み込むデータの量が多くなるため，jcfallogstartコマンドの-tオプション（ファイル監視間隔）の指定に注意してください。

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イベントに変換する場合の指定例を示します。

（例）

ACTDRF=00000333 "jp1base"（改行）

△△△△△"error"

（凡例）△：空白

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべてJP1イベントに変換します。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭から「起動オプションのイベント化するデータの最大長（バイト）」まで指定した長さまでの間だけです。

このパラメーターは省略できません。

定義例

MARKSTRパラメーターおよびACTDEFパラメーターの定義例

次に示すログデータを基に，MARKSTRパラメーターおよびACTDEFパラメーター部分の定義例を説明します。

定義例1

ログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

定義例2

定義例1とは異なるログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

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

形式

retry-times リトライ回数
retry-interval リトライ間隔
trap-interval 監視間隔
matching-level 比較レベル
filter-check-level フィルターチェックレベル
# フィルター
filter　ログの種別
　　条件文1
　　条件文2
　　　：
　　条件文n
end-filter

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥agtless¥以下の任意のパス

論理ホストのとき

共有フォルダ¥conf¥agtless¥以下の任意のパス

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/agtless/以下の任意のパス

論理ホストのとき

共有ディレクトリ/jp1imm/conf/agtless/以下の任意のパス

説明

リモート監視のイベントログトラップ機能の動作を定義するファイルです。リモート監視のイベントログトラップ機能の起動時にその内容を参照します。

このファイルは，JP1/Baseのイベントログトラップ機能の動作定義ファイルと互換性があります。リモート監視のイベントログトラップ機能からJP1/Baseのイベントログトラップ機能への監視構成の変更については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「2.3　システムの階層構成での監視構成の変更」を参照してください。

定義の反映時期

次の場合に，リモート監視イベントログトラップ動作定義ファイルの設定が有効になります。

［プロファイル表示/編集］画面でリロードまたは再起動
［プロファイル表示/編集］画面については，マニュアル「JP1/Integrated Management - Manager 画面リファレンス」の「4.9　［プロファイル表示/編集］画面」を参照してください。

jcfallogstartコマンドまたはjcfallogreloadコマンドの実行
jcfallogstartコマンドの詳細については，「jcfallogstart」（1.　コマンド）を参照してください。jcfallogreloadコマンドの詳細については，「jcfallogreload」（1.　コマンド）を参照してください。

JP1/IM - Managerの再起動

記述内容

retry-times

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの回数を0～86,400の範囲で指定します。省略した場合，リトライ処理はしません。指定された回数のリトライが成功しない場合はエラーとします。retry-timesおよびretry-intervalの組み合わせで24時間以上の設定もできますが，リトライを開始した時刻から24時間以上経過した場合，リトライ処理は打ち切られます。

retry-interval

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライ間隔を1～600（秒）の範囲で指定します。省略した場合，リトライ間隔を10秒と見なします。

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”

複数のフィルターに同一のログの種別を指定した場合，それらのフィルターのどれかの条件を満たすときに成立します。

条件文

条件文の指定は次のとおりです。

属性指定にtype以外を指定した場合
属性指定　正規表現１　正規表現２　正規表現３ …

属性指定にtypeを指定した場合
type ログの種類１ ログの種類２　ログの種類３ …

属性指定のあとに列挙された正規表現（またはログの種類）のどれかが成立した場合に成立します。なお，フィルター内の条件文はAND条件，フィルター間はOR条件です。

属性設定

属性設定は次のとおりです。

属性名 | 記述する内容
type | ログの種類
source | ソース
category | 分類
id | イベントID
user | ユーザー
message | 説明
computer | コンピュータ名

注意事項
属性設定で”message”を指定した場合，イベントログの説明文で「～に関する説明が見つかりませんでした」という説明文（メッセージDLLが存在しない説明文）を含んだイベントログは，メッセージを作成できません。そのため，フィルター条件とのマッチングができないというエラーになり，トラップ対象外となります。挿入句にトラップ対象の語句が含まれていたとしてもトラップされません。

正規表現

正規表現は，’...’ のように引用符で囲まれた文字列で指定します。!’...’のように引用符の前に感嘆符を付加した場合，指定した正規表現以外の文字列という意味となります。正規表現中に ’ を指定する場合は ¥’ のようにエスケープ指定する必要があります。正規表現は，ログの種類が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

発生元ホストマッピング定義ファイル（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-7　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番
項目
属性名
比較キーワード
オペランド

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 マッピング元属性値

マッピング元属性値には，属性名または変数名を指定できます。属性名を指定すると，属性値のすべてを格納します。変数名を指定すると，属性値の一部を切り出して格納します（部分切り出し）。

マッピング元属性値に指定できる属性は拡張属性（固有情報）です。変数名には$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進数値（キロバイト単位）で指定します。

指定できる値は次のとおりです。

Windows，HP-UX，Solaris，AIX，およびLinux（Linux (IPF)を除く）の場合

指定できる値は，「dword:00000001～00001000」（1～4,096キロバイト）です。デフォルト値は，「dword:00000272」（626キロバイト）です。

Linux (IPF)の場合

指定できる値は，「dword:00000001～00001C00」（1～7,168キロバイト）です。デフォルト値は，「dword:00000446」（1,094キロバイト）です。

アクション情報ファイルは，自動アクションの実行情報を保存するファイルです。イベントコンソールおよびjcashowaコマンドでアクションを参照する場合や，アクション状態通知イベントを発行する場合は，アクション情報ファイルを参照します。

このファイルは，"ACTIONINFSIZE"で設定した値に達すると上書きされるラップアラウンド形式のファイルです。そのため，上書きされた古いアクション情報はイベントコンソールおよびjcashowaコマンドで参照できなくなったり，アクション状態通知イベントが発行されなくなったりすることがあります。過去のアクション実行結果を参照する場合や，アクション情報通知イベントを発行する場合は，参照したいアクション情報の容量を見積もって，"ACTIONINFSIZE"に設定しておく必要があります。

アクション情報ファイルの容量見積もりの詳細については，JP1/IM - Managerのリリースノートを参照してください。

アクション情報ファイル容量をデフォルト値に設定した場合は，10,000アクション分の情報を参照できます。

"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アドレス」からgethostbyaddrを利用して求まったホスト名を，イベント発行元ホスト名として使用します。ホスト名が求まらなかった場合は，IPアドレスをイベント発行元ホスト名として使用します。

"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 - Manager 導入・設計ガイド」の「12.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"のどちらかを指定します。大文字・小文字を区別します。デフォルト値は"DEFAULT"です。

パラメーターが存在しない場合は"V8COMPATIBLE"で動作します。

"DEFAULT"を指定すると，同一パラメーターのアクション定義が複数指定された場合，自動アクション定義ファイルの記述順で先頭行に近いアクション定義を優先します。

"V8COMPATIBLE"を指定すると，JP1/IM - Managerのバージョンが09-00より前の自動アクション機能と同じ優先順位となります。つまり，同一パラメーターのアクション定義が複数指定された場合，「イベントIDを指定したアクション定義」を「すべてのイベントを対象としたアクション定義」より最も優先し，次に自動アクション定義ファイルの記述順で先頭行に近いアクション定義を優先します。

[論理ホスト名¥JP1CONSOLEMANAGER¥LOG_CONTROL¥JCAMAIN]

自動アクションログ定義のキー名称です。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"LOGSIZE"=dword:16進数値

自動アクショントレースログ(1ファイル)の最大サイズ値を指定します。

65,536～104,857,600バイトの16進数値で指定します。単位はバイトです。デフォルト値は「dword:00500000」（5,242,880バイト（5メガバイト））です。

デフォルト値の場合，実行するコマンドの最大長が100バイトのアクションを3000コマンド実行したときでもラップアラウンドしない値です。ログサイズを変更する場合は，JP1/IM - Managerのリリースノートを参照してログサイズを見積もってください。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER¥ACTION]
"ACTIONINFSIZE"=dword:00000010
"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 コメント]
   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 - Manager 導入・設計ガイド」の「5.3.2　実行条件の優先度」を参照してください。

パラメーターグループとAND条件

それぞれの自動アクション定義パラメーターは，パラメーターグループに属します。パラメーターグループとは，自動アクション実行の条件を判定する単位です。パラメーターグループによって，一つのJP1イベントで複数のアクションを実行する場合や，複数の条件を満たすときにアクションを実行する場合など，複雑な条件を指定することができます。

一つのJP1イベントがJP1/IMのマネージャーホストに届くと，パラメーターグループごとに，優先順位の順に自動アクション定義パラメーターと実行条件を比較します。実行条件が一致する場合は，パラメーターグループごとに優先順位の最も高い自動アクション定義パラメーターが一つだけ実行されます。

パラメーターグループに「&」を指定すると，前の行に定義した自動アクション定義パラメーターとのAND条件となります。自動アクション定義パラメーターをAND条件として指定すると，すべての条件が満たされたときにアクションが実行されます。

指定内容の確認

作成した定義ファイルは，jcamakeaコマンドを使って定義ファイルの定義内容を確認してください。

定義の反映時期

自動アクションの定義は，JP1/IM - Managerの起動時，JP1/IM - Viewの［アクション設定］画面の［適用］ボタンをクリックして定義を有効にしたとき，およびjcachangeコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容（自動アクション定義ファイルバージョン）

自動アクション定義ファイルバージョンに記述する項目について説明します。

DESC_VERSION=バージョン情報

自動アクション定義ファイルのフォーマットのバージョンを定義します。この定義は，自動アクション定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に記載します。先頭行以外に記載した場合，定義エラーとなります。

表2-8　自動アクション定義ファイルのフォーマットのバージョン情報

バージョン情報 | 説明
1 | 07-11～07-51の自動アクション定義ファイルのバージョンを示す。
2 | 08-00以降の自動アクション定義ファイルのバージョンを示す。
3 | 09-00の自動アクション定義ファイルのバージョンを示す。

このパラメーターを省略，または「1」を指定した場合は，バージョン情報を「2」と仮定して読み込みます。JP1/IM - Viewで［アクション設定］画面の［適用］ボタンをクリックしたとき，「2」に設定し直します。

このパラメーターに「1」，「2」，または「3」以外の値を指定した場合，統合トレースログにエラーが出力され，バージョン情報を「2」と仮定して読み込みます。このとき，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

prm パラメーターグループ

パラメーターグループを指定します。このパラメーターを省略した場合，「0」を仮定します。

パラメーターグループは，1けたの数字（0～9）および「&」で指定できます。1けたの数字（0～9）を指定した場合，アクション名は省略できません。「&」を指定すると，直前のアクションブロックとのAND条件の指定になります。この場合，このアクションブロックの自動アクション定義パラメーターが属するパラメーターグループは，直前のアクションブロックと同じになります。「&」を指定している場合は，アクション名を指定できません。

「&」を指定していないアクションブロックのあとに，AND条件のアクションブロックを最大9件（最初のアクションブロックを含めて10件）指定できます。

同一のパラメーターグループでは，アクションブロックで前に記述されている（GUIでは［アクション設定］の画面で上に表示されている）アクションブロックが優先します。一つのJP1イベントがマネージャーに届くと，パラメーターグループごとに，優先順位の順にアクションブロックのイベント条件とマッチングします。イベント条件が一致する場合は，パラメーターグループごとに優先順位の最も高いアクションブロックのアクションを実行し，実行したアクションブロック以降のアクションブロックはマッチングしません。また，パラメーターグループの小さいものから大きいものの順番にイベントとマッチングを実施します。自動アクションの優先順位については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「5.3.2　実行条件の優先度」を参照してください。

cmt コメント

アクションブロックの説明を記述します。このパラメーターは省略できます。コメントは1,040バイト以内で指定してください。指定できる文字は，すべての文字です。1,040バイトを超えた分は削除されます。

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

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。複数選択した場合の定義例「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-9　イベント条件で指定できる属性名，比較キーワードおよびオペランド

項番
項目
属性名
比較キーワード
オペランド

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件指定できる。ただし，正規表現では複数指定はできない。

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を使用します。

ユーザー名は，31バイト以内の文字列で指定します。なお，ユーザー名に半角スペースを含む文字列は指定できません。また，ユーザー名には，変数を指定できます。受信したJP1イベントに含まれる情報をユーザー名に設定したい場合は，変数を指定します。

ユーザー名にはイベントの情報を設定できます。

アクションを実行するとき，実行先ホストで，ここで指定したJP1ユーザーをJP1/Baseの定義に従ってOSユーザーにユーザーマッピングしてコマンドを実行します。UNIXの場合は，ユーザーマッピングしたOSユーザーのシェル環境を使用して実行します。なお，rulパラメーターと同時に指定できません。

hst 実行ホスト名|グループ名｜業務グループ名｜監視グループ名

アクションを実行するホスト名，ホストグループ名，業務グループ名，および監視グループ名を指定します。ホスト名にはシステム構成の定義で管理対象ホストに設定したホスト名を指定します。hstパラメーターは省略できます。省略した場合，自ホストを仮定します。

実行ホスト名，ホストグループ名は，255バイト以内の文字列で指定します。実行ホスト名，ホストグループ名に半角スペースを含むものは指定できません。また，実行ホスト名，またはホストグループ名には，変数を指定できます。受信したJP1イベントに含まれる情報を実行ホスト名，またはホストグループ名に設定したい場合は，変数を指定します。例えば，イベント発行元のホストでアクションを実行したい場合は，「$EVHOST」と指定します。

実行ホスト名，ホストグループ名にはイベントの情報を設定できます。

業務グループ名，監視グループ名には，最大2,048バイトの文字列を指定できます。指定された文字列が「/」で始まる場合は，業務グループ名，監視グループ名と見なします。ただし，統合監視DBおよびIM構成管理DBが無効な場合は，ホスト名またはホストグループ名と見なします。

なお，rulパラメーターと同時に指定できません。

cmd アクション

アクションとして実行するコマンドを指定します。 指定できるコマンドについては，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「5.　自動アクションによるコマンド実行」を参照してください。

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 - Manager 導入・設計ガイド」の「11.4(2)　注意事項」を参照してください。

アクション中の文字として認識できないコードについての注意事項

アクション中に，文字として認識できないコード（ASCIIコードおよび環境設定で指定した日本語文字コードの文字集合に含まれない部分）が含まれた場合，実行先ホストのシェルなどの仕様で実行されない，または実行されても結果が不正になることがあります。この場合，アクションは実行失敗にならず，終了状態になります。定義ファイル中に上記の不正なコードを指定していなくても，アクション定義で使用できる変数から実行時に置き換えることでアクションに含まれる場合があります。アクション対象イベントを発行する各製品のマニュアルなどで確認し，アクション定義で使用できる変数を指定してください。

rul

JP1/IM - RLへのルール起動要求を設定したい場合に指定します。なお，このパラメーターは，var，cmd，usr，hstパラメーターとは同時に指定できません。

var 環境変数ファイル名

アクションとして実行するコマンドの環境変数を指定した環境変数ファイルのファイル名をフルパスで指定します。このパラメーターは省略できます。省略した場合，環境変数ファイルは仮定されません。環境変数ファイルの形式については，「環境変数ファイル」（2.　定義ファイル）を参照してください。

環境変数ファイル名は，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-10　アクション定義で使用できる変数

情報の種類
変数名
内容

JP1イベント基本属性に含まれる情報
EVBASE
イベント基本情報全体※1

EVID
イベント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

EV"拡張属性名"
任意の拡張属性※5

その他
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イベント発行元製品のマニュアルなどを事前に参照し，属性値の情報を確認してから置き換え文字を設定してください。

変数の記述での注意点

変数の直後に文字を記述する場合，変数の直後に英数字および「_」を指定すると正しく変換されません。このような場合は，変数を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベント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 - Manager 導入・設計ガイド」の「付録G　正規表現」に各OS共通で使用できる正規表現を記載しています。これを参考にして使用する正規表現を決めてください。

Windows版の正規表現

Windows版では，使用できる正規表現をJP1独自の正規表現，拡張正規表現のどちらかにできます。デフォルトは拡張正規表現です。JP1独自の正規表現にする場合は，「自動アクション環境定義ファイル（action.conf.update）」（2.　定義ファイル）を参照して設定してください。

UNIX版の正規表現

UNIX版では「拡張正規表現」を使用します。使用できる正規表現の詳細については，OS提供の「regexp（5）」を参照してください。

定義例

自動アクション定義ファイルの定義例を次に示します。なお，定義例は，正規表現の種別に拡張正規表現を指定しています。

定義例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 - Manager 導入・設計ガイド」の「3.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コマンドを実行して定義を再読み込みしたときに有効になります。

記述内容（自動アクション定義ファイルバージョン）

自動アクション定義ファイルバージョンに記述する項目について説明します。

DESC_VERSION=バージョン情報

自動アクション定義ファイルのフォーマットのバージョンを定義します。

表2-11　自動アクション定義ファイルのフォーマットのバージョン情報

バージョン情報 | 説明
1 | 07-11～07-51の自動アクション定義ファイルのバージョンを示す。
2 | 08-00以降の自動アクション定義ファイルのバージョンを示す。
3 | 09-00の自動アクション定義ファイルのバージョンを示す。
上記以外

このパラメーターを省略，または「1」に指定した場合は，バージョン情報を「2」と仮定して読み込みます。JP1/IM - Viewで［アクション設定］画面の［適用］ボタンをクリックしたとき，「2」に設定し直します。

このパラメーターを「1」，「2」，または「3」以外の値に指定した場合，09-00の自動アクション定義ファイルとして読み込みます。

旧バージョンの自動アクション定義ファイルのフォーマットは，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 - Central Consoleに接続している場合，アクションの状態を監視する・しないにかかわらず，自動アクション状態監視パラメーターは自動アクション定義ファイルに出力されます。

記述内容（自動アクション定義パラメーター）

自動アクション定義パラメーターに記述する各項目について説明します。なお，JP1イベントについては，「3.　JP1イベント」を参照してください。また，定義中に指定する正規表現と変数については，後述します。

イベント監視条件

自動アクション定義パラメーターの中で，実行条件として記述する項目を次に示します。実行条件として定義できるパラメーターの長さは1,040バイトまでです。

{+パラメーターグループ番号|&}

この行の自動アクション定義パラメーターが属しているパラメーターグループの番号を，「+」に続けて1けたの数字（0～9）で指定します。指定を省略すると「0」を仮定します。

「&」を指定すると，直前の定義行とのAND条件の指定になります。この場合，この行の自動アクション定義パラメーターが属するパラメーターグループは，直前の定義行と同じになります。

なお，パラメーターグループの数字の大小は，実行条件判定の優先順位およびアクションの実行順序とは関係ありません。

$イベントID

イベントIDを「$」に続けて指定します。イベントIDの指定形式は次のとおりです。

　基本部[:拡張部]

基本部および拡張部は，16進数8桁以内（0～7fffffff）の範囲で指定します。英字は小文字だけを指定できます。

*

すべてのイベントIDを対象にする場合に指定します。*を指定するとすべてのイベントをアクションの対象にするため，JP1イベントの発生頻度が大きい場合にアクションが大量に発生し，実行が遅延することがあります。*を指定する場合は，その他の条件（メッセージ，イベント基本情報，イベント詳細情報，イベント拡張情報）でイベントを絞り込んでください。

メッセージ

実行条件として，JP1イベントのメッセージテキストを指定します。条件には，正規表現を使うことができます。正規表現で指定する場合は，メッセージテキストの制御コード以外の部分を記述するようにしてください。

正規表現で「/」を表す場合は，「¥/」と記述してください。

イベント基本情報

実行条件として，JP1イベント基本属性の情報を指定します。指定には，正規表現を使うことができます。

正規表現で「/」を表す場合は，「¥/」と記述してください。正規表現の詳細については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

イベント基本情報は，JP1イベント基本属性の情報を次のように並べた形式で渡されます。この形式にあわせて，アクションを実行する条件を指定してください。

イベントID△イベント発行元ユーザー名△イベント発行元ユーザーID△
イベント発行元グループ名△イベント発行元グループID△
イベント発行元イベントサーバ名△イベント発行元プロセスID△
イベント登録年月日△イベント登録時刻△イベント発行元ホストIPアドレス

これらのJP1イベントの基本属性に含まれる情報については，「3.　JP1イベント」を参照してください。

イベント詳細情報

実行条件として，JP1イベント基本属性の詳細属性の情報を指定します。

指定には，正規表現を使うことができます。

正規表現で「/」を表す場合は，「¥/」と記述してください。正規表現の詳細については，マニュアル「JP1/Integrated Management - 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ユーザー名を指定します。

ユーザー名は，31バイト以内の文字列で指定します。ユーザー名に空白を含むものは指定できません。

このパラメーターを指定しなかった場合は，自動アクションの実行環境の定義で，アクション実行標準ユーザーとして指定したJP1ユーザー名を使用します。アクション実行標準ユーザーも指定されていない場合は，jp1adminを使用します。

JP1ユーザー名は，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。

アクションを実行するとき，実行先ホストで，ここで指定したJP1ユーザーをJP1/Baseの定義に従ってOSユーザーにユーザーマッピングしてコマンドを実行します。UNIXの場合は，ユーザーマッピングしたOSユーザーのシェル環境を使用して実行されます。

アクションに「<RULE>」と指定する場合は，この項目は設定できません。

e=環境変数ファイル名

アクションとして実行するコマンドの環境変数を指定した，環境変数ファイルのファイル名をフルパスで指定します。

ファイル名には，255バイトまでの文字列が指定できます。ファイル名に空白を含む場合は""で囲んで指定してください。

ファイル名は，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。例えば，ENVFILEという名称のJP1イベント拡張属性を環境変数ファイル名として使う場合は「$EV"ENVFILE"」と指定します。

なお，環境変数ファイルの形式については，「環境変数ファイル」（2.　定義ファイル）を参照してください。

アクションに「<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 - Manager 導入・設計ガイド」の「5.　自動アクションによるコマンド実行」を参照してください。

このパラメーターを省略した場合，アクションを実行する条件が成立しても，何も実行しません。

コマンドのパラメーターに，変数を使って，受信した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 - Manager 導入・設計ガイド」の「11.4(2)　注意事項」を参照してください。

アクション定義で使用できる変数

自動アクション定義パラメーターの定義のうち，実行するアクションの指定（:以降の指定）には，変数を使って，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 - 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※¹△イベント発行元ユーザー名△イベント発行元ユーザーID△
イベント発行元グループ名△イベント発行元グループID△
イベント発行元イベントサーバ名※²△イベント発行元プロセスID△
イベント登録年月日※³△イベント登録時刻※⁴△イベント発行元ホスト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によって扱いが異なることがあります。このため，メッセージに対する条件を正規表現で記述する場合は，制御コード以外の部分を記述するようにしてください。

正規表現で，すべての文字に一致する表現の「.*」を多用すると，検索に時間が掛かることがあります。長いメッセージなどに対して「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。
また，拡張正規表現を使用できる環境で，かつ，空白以外の文字に一致させたい場合には，「.*」の代わりに「[^ ]*」が使用できます。「[^ ]*」を使用した方が検索に掛かる時間を短縮できます。

特殊文字である縦線「|」は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 - Manager 導入・設計ガイド」の「3.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のインストール時に作成されません。使用する際はテキストファイルを作成・編集してください。

定義の反映時期

イベント引き継ぎ情報変換設定ファイルの内容は，JP1/IM - Managerの起動時，JP1/IM - Viewの［アクション設定］画面の［適用］ボタンをクリックして定義を有効にしたとき，およびjcachangeコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

変換前文字=変換後文字列

イベント引き継ぎ情報変換設定ファイルには，イベント引き継ぎ情報の変換機能で「変換前の文字」と「変換後の文字列」を記述し，変換ルールを指定します。0～32件の変換ルールを指定できます。

イベント引き継ぎ情報変換設定ファイルの半角スペース，タブ，改行だけの行は無視します。1行に一つの変換ルールを指定します。変換前文字，変換後文字列は，「=」で区切って指定します。

定義した1行が「変換前文字=変換後文字列」の形式でない場合は，その定義を無視して処理を続行します。また，変換後文字列が指定されていない場合，イベント引き継ぎ情報の変換時に変換前の文字を削除する設定とします。

変換前文字の同じ変換ルールは指定できません。変換前文字の同じ変換ルールが複数あった場合，ファイルの先頭行に近い変換ルールが有効となり，その他の変換前文字の同じ変換ルールは無効となります。

変換前文字

変換前文字として指定できる文字列は，ASCII文字（0x00～0x7F）からアルファベット，数字，半角スペースを除いた半角記号1文字です。

変換前文字として指定できるASCII文字を次に示します。

表2-15　ASCII文字

文字 | 16進数
! | 0x21
" | 0x22
# | 0x23
$ | 0x24
% | 0x25
& | 0x26
' | 0x27
( | 0x28
) | 0x29
* | 0x2a
+ | 0x2b
, | 0x2c
- | 0x2d
. | 0x2e
/ | 0x2f
: | 0x3a
; | 0x3b
< | 0x3c
= | 0x3d
> | 0x3e
? | 0x3f
@ | 0x40
[ | 0x5b
¥ | 0x5c
] | 0x5d
^ | 0x5e
_ | 0x5f
` | 0x60
{ | 0x7b
| | 0x7c
} | 0x7d
~ | 0x7e

変換後文字列

変換後文字として指定できる文字列は，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コマンドでプロセス名として表示されます。

起動オプション

プロセスの起動オプションを指定します。

JP1/IM - Managerのevtconプロセスは，起動オプションの指定が必要です。

evtconプロセスの-Xmxパラメーターは，JP1/IM - Managerのevtconプロセスが使用するヒープ領域サイズを設定するパラメーターです。初期値として512メガバイトのヒープ領域サイズが設定されています。

evtconプロセスのヒープ領域使用量は，ユーザーの設定により初期値を超えることがあります。ヒープ領域を見積もり，使用量が512メガバイトを超える場合には-Xmxパラメーターの値を変更する必要があります。ヒープ領域の見積もりについては，JP1/IM - Managerのリリースノートを参照してください。

起動オプションの注意事項

JP1/IM - Managerのevtconプロセスのヒープ領域サイズを変更する場合は，十分にテスト運用して問題ないことを確認してください。ヒープ領域範囲内で指定される場合であっても，メモリー不足によりJP1/IM - Managerが停止したり，［イベントコンソール］画面のイベント表示が更新されなくなったりするなど，動作が不安定になることがあります。この場合は，ヒープ領域見積もり式を参照し，［イベントバッファー］および［検索時のイベント取得件数］の設定を見直してください。

JP1/IM - Managerのリリースノートに記載している最大メモリー容量は論理値です。OS種別，ご使用の環境，同時に稼働するアプリケーションの影響により，設定したヒープ領域を確保できない場合があります。ヒープ領域を確保できなかった場合や，初期値である512メガバイトを下回る値を設定した場合は，JP1/IM - Managerが起動できないなど，不具合が生じることがあります。

Windowsで，ヒープ領域サイズを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|
jcdmain||0|3|3|3600|
jcsmain||0|3|3|3600|
jcfmain||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）

インシデント登録サービス（jcdmain）

相関イベント発行サービス（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=11
    :
[ServerDefine]
InvalidateTime = 1440
EventCount = イベントバッファー数
Debug = true
[End]
    :
[RetryInfo]
RetryCount = リトライ回数
RetryInterval = リトライ間隔
[End]
[LocaleInformation]
Language=Japanese
[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，デフォルトは500です。

RetryCount = リトライ回数

イベント検索時にイベントサービスと接続ができなかった，または接続が切断された場合に自動的に再接続するリトライ回数を指定します。

指定できる値は0～100，デフォルトは3です。

RetryInterval = リトライ間隔

イベント検索時にイベントサービスと接続ができなかった，または接続が切断された場合に自動的に再接続するリトライ間隔をミリ秒単位で指定します。

指定できる値は1～86,400,000，デフォルトは10,000です。

注意事項

特別な理由がない場合は，［システム環境設定］画面で設定してください。

システムプロファイルの内容はイベントコンソールの動作のすべてに影響するため，操作にはご注意ください。また，説明していない属性および属性値については一切変更しないでください。変更した場合，イベントコンソールの動作が不正になることがあります。

システムプロファイルを編集する前に，JP1/IM - Viewを終了させてください。

システムプロファイルは，マネージャーごとにあります。そのため，ログインするマネージャーを変更した場合は，その接続先のシステムプロファイルを変更する必要があります。

.systemファイルの内容を変更する場合には，あらかじめバックアップを作成してから変更されることをお勧めします。

属性値が範囲外など，システムプロファイルに誤りがある場合，イベントコンソールは正しく動作しないことがあります。

定義例

DESC_VERSION=11
   :
[End]
[ServerDefine]
InvalidateTime = 1440
EventCount = 500
Debug = true
[End]
   :
[RetryInfo]
RetryCount = 3
RetryInterval = 10000
[End]
[LocaleInformation]
Language=Japanese
[End]

ユーザープロファイル（defaultUser | profile_ユーザー名）

形式

DESC_VERSION=ファイルバージョン
[DisplayItemContainer]
   :
[DisplayItemInformation]
ValidTab=All
Visible=表示可否
AttrName=JP1イベント属性名
AttrOrder=並び順
ColumnSize=列幅
[End]
[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（JP1/IM - Central Console）に再ログインするとその定義が有効になります。

記述内容

DESC_VERSION=ファイルバージョン

ユーザープロファイルの形式のバージョンを表しています。

ファイルバージョンにより，[DisplayItemInformation]～[End]で指定できる項目が変わります。バージョン09-50以降はファイルバージョンに12を指定してください。ファイルバージョンに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
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_MEMO | メモ | × | ○ | ○
30 | E.JP1_SOURCEHOST | 発生元ホスト名 | × | × | ○
31 | E.ACTION_TARGET※² | アクション | ○ | × | ×
32 | IM.ACTION_TYPE※² | アクション種別 | ○ | × | ×

（凡例）

○：指定できる

×：指定できない

注※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進数値

[論理ホスト名¥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）も変更が必要です。

WWWページ版を使用している場合は，WWWページ版動作定義ファイル（console_ja.html）も変更が必要です。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER¥EVCONS]

イベントコンソールサービス環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"COM_SO_TIMEOUT"=dword:16進数値

タイムアウト時間を16進数値で指定します。単位はミリ秒です。デフォルト値はdword:000009C4（2,500ミリ秒）です。

[論理ホスト名¥JP1CONSOLE_CMD]

jcochstatコマンド環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"COM_SO_TIMEOUT"=dword:16進数値

タイムアウト時間を16進数値で指定します。単位はミリ秒です。デフォルト値はdword:0000EA60（60,000ミリ秒）です。

"COM_RETRY_COUNT"=dword:16進数値

通信エラーが発生したときのリトライ回数を16進数で指定します。デフォルト値はdword:00000003（3回）です。

"COM_RETRY_INTERVAL"=dword:16進数値

リトライするまでの待ち時間を16進数で指定します。単位はミリ秒です。デフォルト値はdword:00000BB8（3,000ミリ秒）です。

"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）

インシデント登録サービス（jcdmain）

相関イベント発行サービス（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，jcdmain，evgenまたはjevservice）

HCPNAME
異常が発生したプロセスのプロセス名
（evflow，jcamain，evtcon，jcdmain，evgenまたはjevservice）

HCPID
異常が発生したプロセスのプロセスID
（evflow，jcamain，evtcon，jcdmain，evgenまたはjevservice※のプロセスID）

HCDATE
異常が発生した日付（YYYY/MM/DD）

HCTIME
異常が発生した時刻（hh:mm:ss）

注※　jevserviceで異常が発生した場合は，-1に置き換わります。

通知コマンドは，必ず終了するコマンドを設定してください。バッチファイル（Windows）またはシェルスクリプト（UNIX）を設定する場合は，必ず exit 0 で終了するようにしてください。終了しないコマンドやGUIが起動するコマンドを指定した場合，実行した通知コマンドのプロセスが残ってしまいます。

COMMANDに指定された通知コマンドは，JP1/IM - Managerの実行環境を引き継ぎます。

通知コマンドは，JP1/IM - Managerの実行権限（Windows：SYSTEMユーザー，UNIX：root）で実行されます。

COMMANDに指定する通知コマンドは，フルパスで指定してください。

また，設定した通知コマンドが正常に動作するかどうかは，jcohctestコマンドを使って十分にテストしてください。jcohctestコマンドについては，「jcohctest」（1.　コマンド）を参照してください。

デフォルトは指定なしの「COMMAND=」で，通知コマンドを実行しません。

「$」を指定したい場合は「$$」と指定してください。

NO_RESPONSE_TIME=無応答時間

JP1/IM - Managerのプロセスの無応答時間のチェック間隔を秒単位で指定します。指定できる範囲は，60～3,600秒です。デフォルト値は「60」秒です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「60」秒を仮定します。

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]

WWWページ版動作定義ファイル（console_ja.html）

形式

<html>

<head>
<title>JP1/Integrated Management - View</title>
<meta http-equiv="Content-Type" content="text/html; charset=SHIFT_JIS">
</head>

<body bgcolor="#FFFFFF" text="#000000" link="#000000" vlink="#000000" alink="#000000" >
  :
<param name="LANGUAGE" value="JAPANESE">
<param name="PORT" value="ポート番号">
<param name="SO_TIMEOUT" value="ソケットタイムアウト値">
<param name="TRACE_LEVEL" value="30">
<param name="DEBUG" value="NO">
<param name="RMI_TIMEOUT" value="サーバ処理タイムアウト値">
</applet>
</font>
</body>

</html>

ファイル

console_ja.html（WWWページ版動作定義ファイル）

console_ja.html.model（WWWページ版動作定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥www¥

UNIXの場合

/opt/jp1cons/www/

説明

WWWページ版のJP1/IM - Viewを起動する際に使用するファイルです。このファイルを編集することでWWWページ版のJP1/IM - Viewの動作（通信タイムアウト値や使用するポート番号の設定）を設定できます。

ビューアーとJP1/IM - Managerとの通信で，ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。

また，JP1/IM - Managerで使用するポート番号（20115）を変更した場合にはJP1/IM - Managerと接続する際に使用するポート番号も変更する必要があります。

ここで説明していないパラメーターの値は変更しないでください。

HP-UX (IPF)対応のJP1/IM - ManagerではWWWページ版のJP1/IM - Viewをサポートしていません。このため，HP-UX (IPF)対応のJP1/IM - Managerには，ここで説明しているWWWページ版動作定義ファイル，および格納先ディレクトリは存在しません。

定義の反映時期

JP1/IM - Manager（JP1/IM - Central Console）に再ログインすると，有効になります。

記述内容

<param name="PORT" value="ポート番号">

イベントコンソール用のポート番号（jp1imevtcon）をデフォルトの「20115」から変更した場合に変更します。デフォルト値は20115です。

<param name="SO_TIMEOUT" value="ソケットタイムアウト値">

受信データの到着待ち時間（ソケットタイムアウト値）を指定します。単位はミリ秒です。デフォルト値は2,500ミリ秒です。

低速回線や，イベントトラフィックが高い環境の場合は長めに設定します。

<param name="RMI_TIMEOUT" value="サーバ処理タイムアウト値">

ログイン，ログアウト，自動更新，イベントの状態の変更，イベント検索，ユーザー環境設定，重要イベント設定，自動アクション設定，フィルター設定，コマンド実行操作のタイムアウト時間（サーバ処理タイムアウト値）を指定します。単位はミリ秒です。

指定できる値は60,000～3,600,000ミリ秒，デフォルト値は60,000ミリ秒です。

定義例

<!-- Copyright(C)2003,Hitachi,LTD. -->

<html>

<head>
<title>JP1/Integrated Management - View</title>
<meta http-equiv="Content-Type" content="text/html; charset=SHIFT_JIS">
</head>

<body bgcolor="#FFFFFF" text="#000000" link="#000000" vlink="#000000" alink="#000000" >
<table border="0" cellpadding="0" cellspacing="0" width="700" align="center">
<tr>
<td><img src="image/login/splash.gif" width="700" height="324"></td>
</tr>
</table>

<font size="3">
<applet code="JP/co/Hitachi/soft/jp1/im/console/client/start/JCoViewApplet.class" archive="jcoview.jar,hntrlib2j.jar"  width="0" height="0">
<param name="LANGUAGE" value="JAPANESE">
<param name="PORT" value="20115">
<param name="SO_TIMEOUT" value="2500">
<param name="TRACE_LEVEL" value="30">
<param name="DEBUG" value="NO">
<param name="RMI_TIMEOUT" value="60000">
</applet>
</font>
</body>

</html>

イベントガイド情報ファイル（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.txt（イベントガイド情報ファイルのサンプルファイル）

sample_jco_guide.txt.model（イベントガイド情報サンプルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥guide¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥guide¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/guide/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/guide/

説明

JP1イベントに対して，イベントガイド情報を定義するファイルです。このファイルで記述した内容は，JP1/IM - Viewの［イベント詳細］画面に表示されます。

イベントガイド情報ファイルの最大サイズは，1メガバイトです。

イベントガイド情報ファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

なお，イベントガイド情報ファイルは，jco_guide.txtというファイル名で作成する必要があります。サンプルファイル（sample_jco_guide.txt）をコピーし，ファイル名をjco_guide.txtに変更してから使用するようにしてください。また，格納先のディレクトリは，サンプルファイルと同じディレクトリにしてください。EV_FILEパラメーターで指定するファイル（イベントガイドメッセージファイル）と異なり，ファイル名は任意ではないため，注意してください。

発行されたJP1イベントに対して，複数のイベントガイド情報が一致する場合，イベントガイド情報ファイルで先に記述してある方が有効になります。

#を指定した場合，#以降は改行されるまでコメント扱いとなります。ただし，開始タグ，属性情報，終了タグの後方にコメントを記述できません。開始タグと終了タグの後方にコメントを記述した場合は，エラーとなります。また，属性値の後方にコメントを書いた場合は，属性値の一部として認識されます。

¥を記述する場合，¥¥と記述する必要があります。¥nおよび¥$以外に¥を記述していた場合はログが出力され，¥を記述した行を無視して処理します。

イベントガイド情報ファイル，イベントガイドメッセージファイルに記述されているHTMLの構文チェックはしません。

定義の反映時期

イベントガイド情報ファイルを編集後，JP1/IM - Managerを再起動するか，jco_spmd_reloadコマンドを実行したときから有効になります。なお，JP1/IM - Viewでのログイン時，［イベント詳細］画面にイベントガイド情報の表示領域がない場合，定義を有効にしたあと再ログインすることで，表示領域が表示されます。

イベントガイドメッセージファイルを編集した場合は，［イベント詳細］画面を表示し直すことで，編集内容が更新されます。

記述内容

DESC_VERSION=ファイルバージョン

イベントガイド情報ファイルの形式のバージョンを表しています。指定する値はJP1/IM - Managerのバージョンが09-10までの場合1です。09-50の場合，1または2を指定できます。

[EV_GUIDE_イベントガイド番号]

イベントガイド情報の開始タグです。[EV_GUIDE_イベントガイド番号]～[END]で一つの定義ブロックとなります。このパラメーターと[END]の間に［イベント詳細］画面への表示対象となるJP1イベントの比較条件および表示するメッセージを記述します。イベントガイド番号は，1～9999の数字を10進数で指定します。

複数の定義ブロックがある場合でも順序性を持たせる必要はありませんが，同一のイベントガイド番号を指定するとエラーになり，定義ブロックが無効になります。なお，[EV_GUIDE_1]と[EV_GUIDE_0001]は異なります。

EV_GUIDE_イベントガイド番号タグ内の文字列は一意にしてください。不正な文字列がある場合はログが出力され，該当個所を無視して処理します。

EV_GUIDE_イベントガイド番号タグ内に記述できる属性以外が記述されている場合は，該当個所を無視して処理します。

EV_USER=JP1ユーザー名

イベントガイドメッセージの表示対象となるJP1ユーザー名を31バイト以内の文字列で指定します。このパラメーターは，複数指定できません。また，このパラメーターを省略した場合は，すべての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)は指定できません。

属性値

属性名で指定した属性の内容を正規表現で記述します。正規表現には拡張正規表現を使用します。正規表現の詳細については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

デフォルトでは，指定した正規表現とJP1イベントの属性値全体を比較し，完全に一致した場合だけ条件が成立します。

部分一致にしたいときは，次の共通定義情報を定義した任意のファイルを引数にjbssetcnfコマンドを実行したあと，定義を有効にするため，JP1/IM - Managerを再起動してください。定義ファイル作成時にはファイルの終端が最下行の先頭になるようにしてください。

物理ホストの場合
［JP1_DEFAULT¥JP1CONSOLEMANAGER］
"GUIDE_EV_COMP"="find"

論理ホストの場合
［論理ホスト名¥JP1CONSOLEMANAGER］
"GUIDE_EV_COMP"="find"

定義内容を完全一致（デフォルト）に戻す場合は，共通定義情報"GUIDE_EV_COMP"の値に"match"を指定してください。

共通定義情報の設定がない場合や，値が不正な場合は"match"を仮定し完全一致で動作します。

なお，この共通定義情報はインストール直後の状態では設定されていません。

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△">

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
HREF="URL"
リンク先URLを指定します。相対パスおよび「mailto:」で始まる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
－
文字を斜体にします。

HR
－
罫線を引きます。

BR
－
強制的に改行します。

（凡例）　－：なし

[END]

イベントガイド情報の終了タグです。小文字，大文字の区別はしません。

定義例1

# 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;

ファイル

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/

説明

イベント拡張属性定義ファイルは，［イベント詳細］画面に表示するイベント属性の並び順や表示する属性名を定義します。

イベント拡張属性定義ファイルには，次の3種類のファイルがあります。

表2-22　イベント拡張属性定義ファイルの種類

項番 | 種類 | 説明
1 | 標準ファイル | すべてのイベントに共通の基本属性，および拡張属性の共通情報に対するイベント詳細情報定義
2 | 連携製品提供ファイル | JP1イベントを発行する連携製品の拡張属性の固有情報定義
3 | ユーザー定義ファイル | ユーザー定義の拡張属性の固有情報

上記表の項番1と項番2の2種類のファイルは，JP1/IMの定義ファイル格納先ディレクトリに格納されています。この2種類のファイルは，システム標準の定義情報であり，ユーザーの追加・変更・削除はできません。

新たにJP1イベントに対する拡張属性の固有情報を追加する場合，ユーザーは，項番3の定義ファイルを作成し，格納先ディレクトリに格納します。

作成契機

イベント拡張属性定義ファイルの作成契機を次に示します。

項番 | ファイル | 作成契機
1 | default.conf | JP1/IM - Manager インストール時に作成する。
2 | hitachi_xxxx.conf | JP1/IM - Manager インストール時に作成する。
3 | 会社名_製品名_attr.conf | ユーザーが追加して個別に作成する。

定義の反映時期

JP1/IM - Managerを再起動したあとに有効になります。

記述内容

イベント拡張属性定義ファイルは，［イベント詳細］画面に表示するイベント属性の並び順や表示する属性名を定義します。

イベント拡張属性定義ファイルには，次の3種類のファイルがあります。

すべてのイベントに共通の基本属性，および拡張属性の共通情報に対するイベント詳細情報定義（標準提供：default.conf）

JP1イベントを発行する連携製品の拡張属性の固有情報定義（標準提供：hitachi_xxxx.conf）

ユーザー定義の拡張属性の固有情報（ユーザーが個別作成）

標準提供される2種類のファイルはJP1/IM - Managerの定義ファイル格納ディレクトリに格納されています。この2種類のファイルはシステム標準定義情報であるため，ユーザーが追加，変更，削除できません。

新たにJP1イベントに対する拡張属性の固有情報を追加する場合は，この定義ファイル格納ディレクトリに「表2-2　定義ファイルの命名規則」の名称基準に従って作成した定義ファイルを格納してください。

この定義ファイルを作成する場合，次のことに注意してください。

Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCコードで定義する必要があります。

定義ファイルに誤って基本属性や拡張属性の共通情報を定義すると，［イベント詳細］画面を表示したときに標準提供の定義と重複して表示されます。

なお，JP1/IMには，イベント拡張属性定義ファイルの記述内容をチェックするためのコマンド「jcoattrfcheck」が用意されています。このコマンドの詳細については，「1.　コマンド」を参照してください。

イベント拡張属性定義ファイルには，次のステートメントとブロックを記述できます。

表2-23　イベント拡張属性定義ファイルに記述できるステートメントおよびブロック

ステートメントまたはブロック | 意味
@fileステートメント | 定義ファイルタイプおよびバージョンを宣言する
@productステートメント | 定義中のプログラム情報を宣言する
イベント拡張属性定義ブロック | イベント属性の表示について定義する
属性グループ定義ブロック | イベント属性のグループを定義する
属性表示順序定義ブロック | ［イベント詳細］画面表示時の順序をIDごとに定義する

記述内容（文字コードの指定）

@encode

イベント拡張属性定義ファイルで使用する文字コードを指定します。この項目は省略できます。

指定できる文字コードは，使用するOSの種類によって次のように異なります。

表2-24　指定できる文字コード

文字コード | OSの種類
Windows Server 2003，Windows Server 2008 | Solaris，AIX，HP-UX （IPF） | Linux
C | ○ | ○ | ○
EUCJIS | ○ | ○ | ×
SJIS | ○ | ○ | ×
UTF-8 | × | × | ○

（凡例）

○：指定できる

×：指定できない

次の場合，エラーが出力されます。

C，EUCJIS，SJISおよびUTF-8以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

記述内容（ファイル内ステートメントの生成規則）

@fileステートメント

この定義ファイルがイベント拡張属性定義ファイルであること，および定義記述フォーマットのバージョンが0300であることを宣言します。このステートメントは必須です。

なお，このステートメントは，ファイルの先頭行に記述しなければなりません。記述しない場合，動作は保証できません。

構文

@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"
英語環境時の定義であることを示します。

platform

ブロック内の定義が有効になるプラットフォームを指定します。

定義できるプラットフォームを次に示します。

"base"
すべてのプラットフォームで有効にする場合に使用します。

"ユーザー定義"
ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象になります。したがって，ここに指定するプラットフォーム名と同一の文字列がJP1イベントの拡張属性「PLATFORM」にない場合は，処理の対象になりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

定義例

次の「attrステートメント」の定義例を参照してください。

attrステートメント

［イベント詳細］画面の属性名欄に表示する項目名と，属性値のタイプを指定します。このステートメントはブロック内に複数個指定できます。

なお，このステートメントで定義するのは，基本属性，および拡張属性の共通情報を除いた拡張属性の固有情報だけです。拡張属性の固有情報以外が指定された場合，エラーは出力されないで処理が続行されますが，表示時には標準提供の定義と重複して表示されます。標準提供の定義については，次の「定義例」を参照してください。

構文

attr name=属性名, title=表示項目名[,type="elapsed_time/
date_format:CLIENT"];

name

拡張属性名を定義します。値の形式は次のとおりです。

"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-25　イベント拡張属性定義ブロックの定義例

画面表示名 | 拡張属性名(固有情報)
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パラメーターで指定したプラットフォーム名称は，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";
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

ブロック内の定義が有効になるプラットフォームを指定します。定義できるプラットフォームを次に示します。

"base"
すべてのプラットフォームで有効にする場合に使用します。

"ユーザー定義"
ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象となります。したがって，ここに指定するプラットフォーム名と同一の文字列がイベントの拡張属性「PLATFORM」にない場合は，処理の対象となりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

定義例

次の「orderステートメント」の定義例を参照してください。

orderステートメント

［イベント詳細］画面上に表示する属性とその並び順をIDごとに定義します。このステートメントはブロック内に複数個指定できます。

構文

order id=イベントID定義文字列, attrs=属性名並び;

id

attrsパラメーターで指定した順序で属性を表示するイベントIDを一つ以上指定します。

指定形式は次のとおりです。

一つの場合：id="200"

複数の場合：id="100|101|102"

イベント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";
order id=00001000, attrs="BASE|COMMON"
@define-block-end;

イベント拡張属性定義ファイルの定義例

@file type="extended-attributes-definition",version="0300";
@product name="/HITACHI/JP1/SAMPLE";
@define-block type="event-attr-def";
block platform="base", lang="Japanese";
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";
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";
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";
attr name="B.GROUPID",          title="発行元グループID";
attr name="B.GROUPNAME",        title="発行元グループ名";
attr name="B.IDBASE",           title="イベントID";
attr name="B.PROCESSID",        title="発行元プロセスID";
attr name="B.SEQNO",            title="イベントDB内通し番号";
attr name="B.SOURCEIPADDR",     title="発行元IPアドレス";
attr name="B.SOURCESEQNO",      title="発行元イベントDB内通し番号";
attr name="B.SOURCESERVER",     title="発行元イベントサーバ名";
attr name="B.TIME",             title="登録時刻", type="elapsed_time/date_format:CLIENT";
attr name="B.USERID",           title="発行元ユーザーID";
attr name="B.USERNAME",         title="発行元ユーザー名";
attr name="B.ARRIVEDTIME",      title="到着時間", type="elapsed_time/date_format:CLIENT";
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="終了コード";
@define-block-end;

共通除外条件拡張定義ファイル

形式

DESC_VERSION=ファイルバージョン
#コメント
def 条件群名
   [cmt コメント]
   id 条件群ID
   [valid {true | false}]
   [date 開始日-終了日]
   [rtime 開始時刻-終了時刻]
   [week 曜日]
   cnd
       イベント条件
   end-cnd
end-def

def 条件群名2
・・・
end-def
  :

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

拡張モードの共通除外条件のイベント条件や適用期間を定義するファイルです。

共通除外条件のモードを拡張モードに変更した場合に，正規表現にエラーがあったときに出力されます。

なお，イベント取得フィルター（互換用）を使用している場合，共通除外条件を使用できません。イベント取得フィルター（互換用）を使用している場合は，jcochafmodeコマンドでイベント取得フィルターに変更してください。jcochafmodeコマンドについては，「jcochafmode」（1.　コマンド）を参照してください。

定義の反映時期

jcochfilterコマンドの-efオプションを指定すると，定義内容が反映されます。jcochfilterコマンドについては，「jcochfilter」（1.　コマンド）を参照してください。

記述内容

DESC_VERSION=ファイルバージョン

共通除外条件拡張定義ファイルのバージョンを表します。指定できる値は1だけです。省略した場合，「1」を仮定します。

#コメント文

#で始まる行は，コメント扱いとなります。

def～end-def（定義ブロック）

拡張モードの共通除外条件定義の開始と終了のパラメーターです。def～end-defブロックは省略できます。def以降には，拡張モードの共通除外条件の条件群名を記述します。「def△△△条件群名1△△△条件群名2△△△」と指定した場合，「△△条件群名1△△△条件群名2△△△」が定義名となります（△は半角スペースまたはタブを表す）。

条件群名は，共通除外条件拡張定義ファイル内でユニークになるように1～50バイトの文字列で指定します。指定できる文字は，制御文字（0x00～0x1F，0x7F～0x9F）以外の文字列です。

cmt コメント

拡張モードの共通除外条件の説明を記述します。このパラメーターは省略できます。コメントは1,024バイト以内で指定してください。指定できる文字は，すべての文字です。

id 条件群ID

拡張モードの共通除外条件の条件群IDを指定するパラメーターです。0以上，最大定義数から1を引いた値以下で指定できます。このパラメーターは省略できません。

valid {true | false}

拡張モードの共通除外条件を有効にするかどうかを指定するパラメーターです。

大文字・小文字を区別しません。省略した場合，trueが指定されます。

date 開始日-終了日

拡張モードの共通除外条件を適用する期間を指定するパラメーターです。このパラメーターは省略できます。次の形式で指定します。

　date△YYYYMMDD-YYYYMMDD
　（凡例）△：半角スペース

指定できる期間は1970/01/01～2038/01/19です。

このパラメーターを省略した場合，常に適用となります。

また，開始日を省略した場合，拡張モードの共通除外条件を定義した時点から終了日まで適用されます。終了日を省略した場合，開始日から常に適用となります。

rtime 開始時刻-終了時刻

拡張モードの共通除外条件を適用する時刻を指定するパラメーターです。このパラメーターは省略できます。次の形式で指定します。

　date△HHMM-HHMM
　（凡例）△：半角スペース

このパラメーターを省略した場合，開始時刻を9:00，終了時刻を開始時刻の24時間後と仮定します。また，開始時刻は省略できません。終了時刻を省略した場合，開始時刻から24時間後まで適用されます。

week 曜日

拡張モードの共通除外条件を適用する曜日を指定するパラメーターです。このパラメーターは省略できます。複数の曜日を指定する場合は「,」（半角コンマ）で区切ります。次の形式で指定します。

　week△0,1,2,3,4,5,6
　（凡例）△：半角スペース

曜日と数値は次のとおり対応しています。

日曜日：0

月曜日：1

火曜日：2

水曜日：3

木曜日：4

金曜日：5

土曜日：6

曜日を省略した場合，すべての曜日として適用されます。

cnd～end-cnd（イベント条件ブロック）

拡張モードの共通除外条件のイベント条件を指定する，ブロックの開始と終了のパラメーターです。イベント条件ブロックは，定義ブロック内に必ず一つ指定する必要があります。省略はできません。cndおよびend-cndパラメーターの前後のタブやスペースは，無視されます。

イベント条件

拡張モードの共通除外条件で除外するJP1イベントの条件を指定します。イベント条件ブロックには，0～256件のイベント条件を指定できます。イベント条件とイベント条件は，AND条件となります。次の形式で指定します。

　属性名△比較キーワード△オペランド
　（凡例）△：半角スペース

なお，半角スペース，またはタブだけで構成された行は，無視して処理を続行します。

属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英小文字と英大文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2-26　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番
項目
属性名
比較
キーワード
オペランド

1
イベントID
B.ID

と一致する

と一致しない

JP1イベントのイベントIDを指定する。

最大100件複数指定できる。

16進数形式で指定する。

英大文字・英小文字は区別しない。

指定できる範囲は0～7FFFFFFFである。

2
登録要因
B.REASON

と一致する

と一致しない

JP1イベントの登録要因を設定する。

最大100件複数指定できる。

英大文字・英小文字は区別する。

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件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

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-27　TRANGEの指定形式

比較方法 | 形式 | 指定できる範囲
日時指定 | 開始日時△終了日時 | 開始日時≦属性値≦終了日時
期間指定 | 分前 | 基準時刻△－期間（分）MIN | 基準時刻－期間（分）≦属性値≦基準時刻
分後 | 基準時刻△＋期間（分）MIN | 基準時刻≦属性値≦基準時刻＋期間（分）
時間前 | 基準時刻△－期間（時）HOUR | 基準時刻－期間（時）≦属性値≦基準時刻
時間後 | 基準時刻△＋期間（時）HOUR | 基準時刻≦属性値≦基準時刻＋期間（時）
日前 | 基準時刻△－期間（日）DAY | 基準時刻－期間（日）≦属性値≦基準時刻
日後 | 基準時刻△＋期間（日）DAY | 基準時刻≦属性値≦基準時刻＋期間（日）

（凡例）

△：半角スペース

開始日時，終了日時は，yyyyMMddHHmmss形式で指定してください。期間（分，時，日）は，数字で指定してください。MIN，HOUR，DAYは，大文字・小文字を区別します。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。小文字と大文字で区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。また，これらの値は定義フォーマットの上限チェックの場合，1文字として扱います。

項番 | 指定したい値 | 指定方法
1 | タブ（0x09） | %09
2 | 半角スペース（0x20） | %20
3 | %（0x25） | %25
4 | 改行コード LF（0x0a） | %0a
5 | 改行コード CR（0x0d） | %0d

定義例

次の条件の場合に，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

共通除外条件表示項目定義ファイル（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-28　表示項目一覧

項番 | 表示項目 | 属性名
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 | -------------------- | SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，共通除外条件表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1から25までの項目がデフォルト値として表示されます。

対処状況イベント定義ファイル（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が仮定されます。

cold，warmそれぞれを指定した場合の相関イベント発行サービスの動作を起動時，停止時に分けて次の表に示します。用途に合わせて値を変更してください。

表2-29　起動オプションの違いによる相関イベント発行サービス起動時・停止時の動作の違い

起動オプション
相関イベント発行サービスの動作

起動時の動作※1
停止時の動作

cold
前回停止時の起動オプションがcoldの場合：
相関イベント発行サービスが起動したあとに登録されたJP1イベントから，発行処理の対象とする。
発行処理中の相関イベントをすべて不成立にして，相関イベント発行履歴ファイルに出力する。

前回停止時の起動オプションがwarmの場合：
発行処理中の相関イベントをすべて不成立にして，相関イベント発行サービスが起動したあとに取得したJP1イベントから，発行処理の対象とする。

warm
前回停止時の起動オプションがcoldの場合：
相関イベント発行サービスが前回停止時に取得したJP1イベントの続きから発行処理の対象とする。
停止前の最後に取得したJP1イベントの情報，発行処理の内容，および相関イベントの発行定義の内容を内部ログに出力・保管する。

前回停止時の起動オプションがwarmの場合：
前回停止時の相関イベントの発行処理の内容を引き継ぎ，前回停止時に取得したJP1イベントの続きから発行処理の対象とする。※2

注※1

相関イベント発行サービスが初めて起動するときは，起動オプションの値に関係なく次のように動作します。

・相関イベント発行サービス起動後に登録されたJP1イベントから取得を開始する。

・相関イベント発行定義を読み込み，定義に従って処理を開始する。

なお，デフォルトでは，相関イベント発行定義が設定されていないため，相関イベントは発行されません。

注※2

JP1/IM - Managerの停止時と次の起動時で相関イベント発行定義が異なる場合，発行処理中の相関イベントはすべて不成立になります。いったん，内容がクリアされたあとは，前回停止時に取得した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-30　指定できないパラメーター一覧

バージョン | パラメーター名
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-31　イベント属性条件の設定項目

項番
設定項目
説明

1
属性名
JP1イベントの基本属性または拡張属性を指定します。 基本属性には「B.」を，拡張属性には「E.」を付けます。例えば，メッセージを指定する場合「B.MESSAGE」と指定します。
拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダーバー）

指定できる属性名については，「表2-32　相関の対象範囲の絞り込み条件に指定できる属性名の一覧」を参照してください。

2
比較条件
使用できる比較条件は次のとおりです。これ以外のものを指定すると定義不正となります。
比較条件：意味

==　：と一致する

!=　：と一致しない

^=　：から始まる

>=　：を含む

<=　：を含まない

*=　：正規表現※

注※　使用できる正規表現については，マニュアル「JP1/Integrated Management - 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-32　相関の対象範囲の絞り込み条件に指定できる属性名の一覧

項番 | 属性名 | 項目
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-33　イベント条件の設定項目

項番
設定項目
説明

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イベントを発行する各製品のマニュアルを参照してください。

比較条件および属性値

比較条件および属性値の指定方法は，TARGETにイベント属性条件を指定する場合と同じです。

「表2-31　イベント属性条件の設定項目」および表下の説明を参照してください。

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-34　同一属性値条件の設定項目

項番
設定項目
説明

1
属性名
JP1イベントの基本属性または拡張属性を指定します。
ここで指定した属性名に対応する相関元イベントの属性値がグルーピングのキーになります。
属性名は，一つの同一属性値条件に対して一つだけ指定できます。
基本属性には「B.」を，拡張属性には「E.」を付けます。拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダーバー）

指定できる属性名については，「表2-35　同一属性値条件に指定できる属性名の一覧」を参照してください。

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-35　同一属性値条件に指定できる属性名の一覧

項番 | 属性名 | 項目
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 - Manager 導入・設計ガイド」の「3.3.6(1)　相関成立の場合」を参照してください。

なお，相関イベント発行条件に「FAIL_EVENT=相関不成立イベント」が定義されている場合，この定義を省略することができます。省略した場合，相関イベント発行条件が相関成立になっても，相関成立イベントは発行されません。

相関成立イベントは，次の形式で記述します。

　属性名:属性値

各項目について説明します。

属性名

JP1イベント（相関元イベント）の基本属性または拡張属性を指定します。基本属性には「B.」を，拡張属性には「E.」を付けます。拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダーバー）

次の属性に対してはユーザーが任意に値を設定できます。

イベントID（B.ID）

メッセージ（B.MESSAGE）

次の表に示す以外の拡張属性

表2-36　値を指定できない拡張属性

属性種別
項目
属性名
内容

共通情報
プロダクト名
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・・・"

変数を使用する場合，一致する属性名がない場合は空白に置き換わります。また，相関イベントの発行時に変数を属性値に置き換えたことによって，属性値の最大長を超えた場合は相関イベントは発行されません。

FAIL_EVENT=相関不成立イベント

相関イベント発行条件が相関不成立になった場合に発行するJP1イベント(相関イベント)を定義します。1件の相関イベント発行条件に定義できる相関不成立イベントは一つだけです。相関不成立になる条件については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「3.3.6(2)　相関不成立の場合」を参照してください。

なお，相関イベント発行条件に「SUCCESS_EVENT=相関成立イベント」が定義されている場合，この定義を省略することができます。省略した場合，相関イベント発行条件が不成立になっても，相関不成立イベントは発行されません。

相関不成立イベントは，相関成立イベントと同じ形式で記述します。「SUCCESS_EVENT=相関成立イベント」を参照してください。

(1) 同一属性値条件（SAME_ATTRIBUTE）に変数を使用する

同一属性値条件（SAME_ATTRIBUTE）に変数（$EVnまたは$EVn_ENVo）を使用する方法について説明します。

(a) 相関元イベントの属性値を同一属性値条件として使用する

相関元イベントの属性値を，同一属性値条件として使用する場合，変数 $EVn_属性名を使用します。形式を次に示します。

　SAME_ATTRIBUTE=$EVn_属性名

nにはイベント条件の条件ID（CID）に対応した値を指定します。属性名には，グルーピングのキーにしたい属性名を指定します。なお，指定できる属性名については，「表2-35　同一属性値条件に指定できる属性名の一覧」を参照してください。

例えば，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）に対応した値を指定します。

また，ENVoのoに切り出しの順番を指定します。切り出しの順番とは，イベント条件の右辺に記述されている( )を左から右に数えた値です。イベント条件（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-37　変数に指定できる属性名の一覧

項番 | 属性名 | 項目 | 形式
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 | 発行元グループID | 文字列
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-38　満たしたい要件と設定値（例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-39　満たしたい要件と設定値（例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,B.SEVERITY==Error,E.PRODUCT_NAME>=HITACHI/JP1/AJS2
CON=CID:5,B.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の場合

<Consoleパス>¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

相関イベント発行履歴ファイルのサイズ，面数を定義するファイルです。

このファイルを更新する場合，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のリリースノートを参照してください。

インシデント登録用システムプロファイル（eds_system.conf）

形式

VERSION=1

START_OPTION={cold | warm}

ファイル

eds_system.conf（インシデント登録用システムプロファイル）

eds_system.conf.model（インシデント登録用システムプロファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥discrim¥define¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥discrim¥define¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/discrim/define/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/discrim/define/

説明

JP1/IM - Incident Master連携用の定義ファイルです。インシデント登録サービスの基本動作を定義するファイルです。

定義の反映時期

次の場合に，インシデント登録用システムプロファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドでリロードをした場合

記述内容

VERSION=1

ファイルのバージョンを表しています。編集不要です。省略した場合や1以外の数値を指定した場合は，VERSION=1が仮定されます。

START_OPTION={cold | warm}

インシデント登録サービスの起動時および停止時の動作を決めるためのパラメーターです。パラメーター値に指定できるのは，coldとwarmの二つです。デフォルトはcoldです。大文字小文字は区別しません。省略した場合や値が不正な場合はcoldが仮定されます。

cold，warmそれぞれを指定した場合のインシデント登録サービスの動作を起動時，停止時に分けて次表に示します。用途に合わせてパラメーター値を変更してください。

表2-40　パラメーター値の違いによるインシデント登録サービス起動時・停止時の動作の違い

パラメーター値
インシデント登録サービスの動作

初起動時の動作
停止時の動作
起動時の動作

cold
パラメーター値に関係なく，次のように動作する。

インシデント登録サービス起動後に登録されたJP1イベントから取得を開始する。

インシデント登録定義を読み込み，定義に従って処理を開始する。

「相関中」のインシデントの状態をすべて「相関不成立」にしてJP1/IM - Incident Masterに登録する。

インシデント登録履歴ファイルに処理内容を出力する。

前回停止時のパラメーター値がcoldだった場合：

初起動時の動作と同様の動作となる。

前回停止時のパラメーター値がwarmだった場合：

前回停止時に相関中のまま終了したインシデントがあった場合，状態をすべて「相関不成立」にしてJP1/IM - Incident Masterに登録する。

インシデント登録サービス起動後に登録されたJP1イベントから取得を開始する。

インシデント登録定義を再読み込みし，定義に従って処理を開始する。

warm
パラメーター値に関係なく，次のように動作する。

インシデント登録サービス起動後に登録されたJP1イベントから取得を開始する。

インシデント登録定義を読み込み，定義に従って処理を開始する。

停止前の最後に取得したJP1イベントの情報，相関処理の内容，およびインシデント登録定義の内容を内部ログに出力・保管する。

インシデント登録履歴ファイルに処理内容を出力する。

前回停止時のパラメーター値がcoldだった場合：

前回停止前の最後に取得したJP1イベントの続きから取得を開始する。

インシデント登録定義を再読み込みし，定義に従って処理を開始する。

前回停止時のパラメーター値がwarmだった場合：

前回停止前の最後に取得したJP1イベントの続きから取得を開始する。

インシデント登録定義を再読み込みし，定義に従って処理を開始する。

内部ログを参照し，前回停止時に相関中のまま終了したインシデントがあった場合，前回の処理を継続して処理を開始する。
ただし，停止→起動の間にインシデント登録定義が変更されていた場合には，状態をすべて「相関不成立」にしてJP1/IM - Incident Masterに登録する。

なお，クラスタ運用する場合には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設定のままだと，相関処理の対象イベントを取り漏らすことがあります。

インシデント手動登録定義ファイル（incident.conf）

形式

VERSION=バージョン情報

#コメント文
[IDM_URL=http://JP1/IM - Incident Masterのホスト:ポート番号/仮想ディレクトリ]
[SS_URL=http://JP1/IM - 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（JP1/IM - Central Console）にログインすると，インシデント手動登録定義ファイルの設定が有効になります。

記述内容

VERSION=バージョン情報

ファイルのバージョンを表しています。JP1/IM - Managerのバージョンが09-50の場合は2を，JP1/IM - Managerのバージョンが09-50より前の場合は1を指定します。それ以外の数値を指定した場合や省略した場合は，VERSION=1が仮定されます。

#コメント文

#で始まる行は，コメント扱いとなります。

[IDM_URL=http://JP1/IM - Incident Masterのホスト:ポート番号/仮想ディレクトリ]

インシデントを登録するJP1/IM - Incident MasterのWWWページのURLを半角英数字および記号で指定します。デフォルトは，「IDM_URL=」となっており，何も設定されていません。何も設定されていない場合は，インシデントを手動登録するためのJP1/IM - Viewのボタン，およびメニューが非表示となります。

なお，このパラメーターに記載したJP1/IM - Incident Masterのポート番号については，JP1/IM - ViewのマシンからJP1/IM - Incident Masterのマシンに対して，ファイアウォールを通過できるよう設定する必要があります。

[SS_URL=http://JP1/IM - Service Supportのホスト:ポート番号]

インシデントを登録するJP1/IM - Service SupportのWWWページのURLを半角英数字および記号で指定します。デフォルトは，「SS_URL=」となっており，何も設定されていません。

なお，このパラメーターに記載したJP1/IM - Service Supportのポート番号については，JP1/IM - ViewのマシンからJP1/IM - Service Supportのマシンに対して，ファイアウォールを通過できるよう設定する必要があります。

なお，JP1/IM - Managerをバージョンアップ後にJP1/IM - Service Supportと連携する場合は，この行を追加したあと，次の作業を実施してください。

バージョン情報を“2”に変更する。

IDM_URLで始まる行をコメント扱いに変更する（#を付ける）。

JP1/IM - Managerを再起動またはjco_spmd_reloadコマンドを実行して定義内容を反映する。JP1/IM - Viewにログインしている場合は，JP1/IM - Viewを再起動する。

インシデント登録環境定義ファイル（jcdmain.conf.update）

形式

[論理ホスト名¥JP1CONSOLEMANAGER¥JCDMAIN]
"OPERATION_LOG_SIZE"=dword:16進数値
"OPERATION_LOG_NUM"=dword:16進数値

[論理ホスト名¥JP1CONSOLEMANAGER¥JCDMAIN¥DBMS]
"PDNAMEPORT"="ポート番号"

ファイル

jcdmain.conf.update（インシデント登録環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

JP1/IM - Incident Master連携用の定義ファイルです。次に示す内容を定義するファイルです。

インシデント登録履歴ファイルのサイズ，面数

JP1/IM - Incident Masterが使用するポート番号※
注※　JP1/IM - Incident Master側の設定に合わせて設定を変更する必要があります。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，ファイルをコピーして，内容を編集してください。

定義の反映時期

この定義ファイルを引数にjbssetcnfコマンド実行後，JP1/IM - Managerを再起動，またはjco_spmd_reloadコマンドを実行することで有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER¥JCDMAIN]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"OPERATION_LOG_SIZE"=dword:16進数値

インシデント登録履歴ファイルのサイズを16進数で指定します。00010000～06400000（64キロバイト～100メガバイト）の範囲で指定できます。

デフォルトでは値に「00A00000」（10メガバイト）が指定されています。

"OPERATION_LOG_NUM"=dword:16進数値

インシデント登録履歴ファイルの面数を16進数で指定します。00000003～00000064（3面～100面）の範囲で指定できます。

デフォルトでは値に「00000003」（3面）が指定されています。

[論理ホスト名¥JP1CONSOLEMANAGER¥JCDMAIN¥DBMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"PDNAMEPORT"="ポート番号"

JP1/IM - Incident Masterが使用するポート番号を指定します。JP1/IM - Incident Master側で使用するポート番号を変更した場合には，それに合わせてこのパラメーターで指定するポート番号も変更する必要があります。

デフォルトでは値に「23044」が指定されています。

インシデント登録履歴ファイルのサイズ，面数の算出方法

インシデント登録履歴ファイルのサイズ，面数の調整をする場合，1日で増加するインシデント登録履歴ファイルのサイズを算出し，必要に応じて保存したい日数を掛けてください。調整する場合は，算出された値より少し大きめの値にしてください。

見積もりの詳細については，JP1/IM - Managerのリリースノートを参照してください。

ホスト情報ファイル（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/IM - Central Scope）が管理するホスト情報を定義するファイルです。

ホスト情報ファイルは，監視ツリーの自動生成，および監視オブジェクトの状態を変更するJP1イベント照合処理の際のホスト名比較に使用するホスト情報を記述するファイルです。なお，ホスト情報ファイルの形式は，hostsファイルと同じです。

#を指定した場合，#以降は改行されるまでコメント扱いとなります。

定義の反映時期

ホスト情報ファイルの内容は，jcshostsimportコマンド実行後，JP1/IM - Managerを再起動，またはjco_spmd_reloadコマンドを実行することで有効になります。

jcshostsimportコマンドでホスト情報ファイルの内容をホスト情報DBに格納すると，ホスト名はすべて小文字になります。そのため，jcshostsexportで出力するホスト情報のホスト名も，すべて小文字になります。

jcshostsimportコマンドでは，ホスト情報ファイルのコメントは格納されません。

記述内容

IPアドレス ホスト名1 ホスト名2 ホスト名3 ... ホスト名8

空白を除く行の先頭にIPアドレスを記述し，複数の空白またはタブのあとにホスト名，エイリアス名を記述します。

IPアドレスの文字数は，最大63バイトです。IP V6の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-41　JP1/IMの動作する言語コードとガイド情報ファイルの対応

OS
JP1/IMの動作する言語コード
編集するファイル

Windows
シフトJISコード
jcs_guide_sjis.txt（ガイド情報ファイル）

jcs_guide_sjis.txt.model
（ガイド情報ファイルのモデルファイル）

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
（ガイド情報ファイルのモデルファイル）

言語コードに対応したガイド情報ファイルを使用してください。

格納先ディレクトリ

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 - Central Scopeのガイド情報ファイルは，08-00以降のJP1/IM - Managerでも読み込めます。

Windowsの場合，08-00以降のJP1/IM - Managerのガイド情報ファイルは，07-00のJP1/IM - Central Scopeでも読み込むことはできますが，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 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

EV_TITLE=文字列

文字列には，［ガイド］画面のタイトルに表示される文字列を記述します。このパラメーターは，[EV_GUIDE_数字]と[END]の間に一つしか記述できません。

EV_GUIDE=メッセージ

メッセージには，［ガイド］画面のガイドメッセージに表示される文字列を記述します。HTMLタグを記述すれば，［ガイド］画面に表示されるガイドメッセージをHTML形式で表示できます（記述できるHTMLタグはEV_FILEの説明文にある「表2-42　ガイドメッセージとして使用できる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-42　ガイドメッセージとして使用できる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

オブジェクトタイプ定義ファイル

形式

[コメント]
[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を再起動したあとに有効になります。

記述内容

[コメント]

コメントは，「#」で開始する改行を含まない文字列です。

[ObjectType]

「[ObjectType]」および「[End]」は「[」および「]」を含めてそのまま記述します。

定義ブロック [コメント]

定義ブロックは，拡張属性値とリスト表示文字列で構成されます。拡張属性値は，オブジェクトタイプまたは登録名タイプに格納される文字列です。リスト表示文字列は，ドロップダウンリストに一覧表示する文字列です。

[End]

「[End]」は「[」および「]」を含めてそのまま記述します。

なお，定義する際には次の内容に注意してください。

オブジェクトタイプ（拡張属性値）に空白を入れることはできません。

リスト表示文字列には，日本語ではなく拡張属性値そのものを記述してください。

定義例

オブジェクトタイプ定義ファイルの定義例を次に示します。

[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="コマンドパス";
@define-block-end;

ファイル

!JP1_CC_APP0.conf.model（アプリケーション実行定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥appexecute¥ja¥

説明

アプリケーション実行定義ファイルは，［イベントコンソール］画面から起動するアプリケーションなどの実行形式ファイルのIDとパスを定義するファイルです。

なお，JP1/IMには，アプリケーション実行定義ファイルの記述内容をチェックするためのコマンド「jcoappexecfcheck」が用意されています。このコマンドの詳細については，「1.　コマンド」を参照してください。

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

@file type="application-execution-definition";

この定義ファイルがアプリケーション実行定義ファイルであることを宣言します。このステートメントは必須です。

このステートメントは，ファイルの先頭行に記述しなければなりません。

アプリケーション実行定義ブロック

［イベントコンソール］画面から起動するアプリケーションなどの実行形式ファイルのパスを定義し，ほかの定義ファイルからリンクするためのID付けをします。

このブロックには次のステートメントを記述できます。

idステートメント

pathステートメント

descriptionステートメント

これ以外のステートメントが記述された場合は，エラー出力し，該当するステートメントだけを無視します。

次にステートメントについて説明します。

id="アプリケーション実行定義識別子";

このブロックで指定するコマンドパスにIDを付けます。このステートメントは必須です。このステートメントは，ブロック内で1回だけ記述できます。

同一のidを持つブロックが解析対象のファイル内に複数個存在した場合，次の順に優先順位が決定され，最優先のブロックが有効になります。

ファイル名を昇順でソートしてあとの方のブロック

ファイル内の位置があとの方のブロック

それ以外のブロックは無効になります。

アプリケーション実行定義識別子は，32バイト以内の半角英数字で構成される文字列です。この文字列は定義内でユニークでなければなりません。ユニーク性を保持するために，次の命名規則に従ってください。

会社名_製品名[_機能名(または画面名)]

「"jco_"」で始まる文字列，および「"default_browser"」は，アプリケーション実行定義識別子として予約されているため，使用できません。

path="コマンドパス";

idステートメントで指定したアプリケーション実行定義識別子と関連づける実行形式ファイルのパスを定義します。このステートメントは必須です。このステートメントは，同一ブロック中に複数個指定できます。起動する実行形式ファイルは，フルパスで指定します。後述の置き換えキーワードを使用して，レジストリーなどからパスを組み立てることもできます。

このステートメントを複数個指定した場合は，記述順にパスが検索され，最初に見つかったパスが使用されます。

pathステートメントで指定できる実行形式ファイルは，.exeまたは.batファイルです。

コマンド実行時のカレントディレクトリは不定です。カレントディレクトリから相対パスを意識するコマンドなどは指定できません。.batファイルなどでcdコマンドを実行したあと，実行するようにしてください。

検索処理はJP1/IM - Viewの起動時にだけ実行されます。そのため，起動対象となるアプリケーションをJP1/IM - Viewの実行中にインストールした場合は，JP1/IM - Viewを再起動する必要があります。

置換文字列
pathステートメントには，実行時に置き換え可能な置換文字列を指定できます。

キーワード置換文字列
指定された定義内にキーワード置換文字列が存在する場合は，記述されたキーワードに従って文字列の置換が実行されます。形式を次に示します。

%置き換えキーワード%

置き換えキーワードの一覧を次に示します。

表2-43　置き換えキーワードの一覧

キーワード | 置換する内容
JCO_JP1USER | JP1/IM - ManagerにログインしたJP1のユーザー
JCO_INSTALLPATH | JP1/IM - Viewのインストールフォルダの名称

レジストリー置換文字列
定義内にレジストリー置換文字列を指定すると，記述されたレジストリーから値を取得して文字列の置換が実行されます。レジストリー置換文字列の形式を次に示します。

[¥レジストリーキー¥レジストリーキー¥…¥レジストリー値]

レジストリー置換文字列の中には，さらに，レジストリー専用の置き換えキーワード「%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;

CMホスト定義ファイル（jcs_atc_cm_host.conf）

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"ATC_CM_HOST"="ホスト名"

ファイル

jcs_atc_cm_host.conf（CMホスト定義ファイル）

jcs_atc_cm_host.conf.model（CMホスト定義ファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

JP1/IM - Central Information Master連携用の定義ファイルです。

監視ツリー（システム構成ツリー）を自動生成するための定義情報を収集するJP1/IM - Central Information Masterホストを定義するファイルです。

なお，JP1/IM - Managerと同一ホストのJP1/IM - Central Information Masterから定義情報を収集する場合にはこの定義は不要です。

定義の反映時期

次の場合に定義が有効になります。

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したとき。

jbssetcnfコマンドを実行し，jco_spmd_reloadコマンドを実行したとき。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"ATC_CM_HOST"="ホスト名"

ホスト名に連携するJP1/IM - Central Information Masterのホスト名を指定します。省略した場合は，JP1/IM - Central Information MasterのホストがJP1/IM - Managerと同一のホストであると仮定して動作します。

状態変更条件メモリー常駐機能の設定ファイル

形式

[論理ホスト名¥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
   cnd
       イベント条件
   end-cnd
   sev 重大度
end-def

def 定義名2
   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コマンドを実行した場合

記述内容（重大度変更定義ファイルバージョン）

DESC_VERSION

DESC_VERSIONには，重大度変更定義ファイルの形式を決定するファイルバージョンをバージョン情報として定義します。09-00の重大度変更定義ファイルのファイルバーションは，1です。DESC_VERSIONの指定を省略した場合，ファイルバージョンを1と見なして処理します。

DESC_VERSIONは，定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に記載します。先頭行にファイルバージョンがなかった場合は，ファイルバージョンを1と見なして処理します。

記述内容（重大度変更定義パラメーター）

def～end-def（定義ブロック）

重大度変更定義の開始と終了のパラメーターです。def～end-defブロックは省略でき，この場合「すべてのJP1イベントの重大度を変更しない」と解釈します。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-44　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番
項目
属性名
比較
キーワード
オペランド

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"（デバッグ）のどれかです。

#コメント文

#で始まる行は，コメント扱いとなります。

定義例

イベントIDが100または200に一致，かつ重大度がWarningで，かつ登録ホストがhostA，hostB，hostCに一致する場合に，重大度をEmergencyに変更する例を次に示します。

DESC_VERSION=1
def 重大度変更1
   cnd
       B.ID IN 100 200
       E.SEVERITY IN Warning
       B.SOURCESERVER IN hostA hostB hostC
   end-cnd
   sev Emergency
end-def

通信環境定義ファイル（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 - Central Console）間の通信でのタイムアウト時間を定義するファイルです。

ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合に，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。タイムアウト時間を設定する場合は，接続するJP1/IM - Manager（JP1/IM - Central Console）でも同様の設定が必要です。

なお，この定義ファイルの値を変更する場合は，JP1/IM - Manager（JP1/IM - Central Console）用の通信環境定義ファイルの値も変更する必要があります。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Viewを再起動したあとに有効になります。

記述内容

[JP1_DEFAULT¥JP1CONSOLEVIEW]

JP1/IM - View環境設定のキー名称です。

JP1/IM - Viewの場合，このパラメーターは固定です。

"COM_SO_TIMEOUT"=dword:16進数値

受信データの到着待ち時間（ソケットタイムアウト値）を16進数で指定します。単位はミリ秒です。デフォルト値はdword:000009C4（2,500ミリ秒）です。

低速回線や，イベントトラフィックが高い環境の場合は長めに設定します。

"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（JP1/IM - Central Scope）間の通信でのタイムアウト時間を定義するファイルです。

ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合に，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

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

IM-View設定ファイル（tuning.conf）

形式

LOGIN_HISTORY_MAX=接続先ホスト入力履歴数
MENU_AUTO_START={ON | OFF}
ACTIONLIST_AUTO_START={ON | OFF}
WWW_BROWSER_PATH=起動ブラウザーのパス
CLIPBOARD_OUTPUT={ON | OFF}

ファイル

tuning.conf（IM-View設定ファイル）

tuning.conf.model（IM-View設定ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥

説明

JP1/IM - Viewの動作を定義するファイルです。ログイン画面での接続先ホスト入力履歴数，イベントコンソール画面表示時の動作，およびクリップボードへのコピー可否を設定します。

tuning.confファイルの各項目は，「パラメーター名=値」という形式で記述します。定義ファイル中の，次の行は無視されます。

空白文字だけの行

空白文字を除いた先頭の文字が「#」の行（コメント行）

記述内容

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」を仮定します。

定義例

# ************************************************************************
# ***  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

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

形式

@encode 文字コード
DESC_VERSION=0300
キー定義
サブキー定義
関連づけ定義
呼び出しインターフェース定義

ファイル

会社名_製品名_mon_ja.conf

会社名_シリーズ名_製品名_mon_ja.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」を指定できません。

なお，JP1/IMには，モニター画面呼び出し定義ファイルの記述内容をチェックするためのコマンド「jcomonitorfcheck」が用意されています。このコマンドの詳細については，「1.　コマンド」を参照してください。

定義の反映時期

JP1/IM - Managerを再起動したあとに有効になります。

記述内容

@encode

モニター画面呼び出し定義ファイルで使用する文字コードを指定します。この項目は省略できます。

指定できる文字コードは，使用するOSの種類によって次のように異なります。

表2-45　指定できる文字コード

文字コード | OSの種類
Windows Server 2003，Windows Server 2008 | Solaris，AIX，HP-UX （IPF） | Linux
C | ○ | ○ | ○
EUCJIS | ○ | ○ | ×
SJIS | ○ | ○ | ×
UTF-8 | × | × | ○

（凡例）

○：指定できる

×：指定できない

次の場合，エラーが出力されます。

C，EUCJIS，SJISおよびUTF-8以外の文字コードを指定した場合

@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パラメーターは，どちらかだけを指定できます。

INTERFACE=インターフェース名
インターフェースの名称を記述します。定義するキーに対して，モニター画面起動時のインターフェースを一つだけ指定します。このパラメーターとSUBKEYパラメーターは，どちらかだけを指定できます。

注意事項

バージョンの比較は昇順で実行されます。開始バージョンよりも終了バージョンの方が小さい場合は，エラーは発行されませんが，そのキー定義自体が無視されます。

「PRODUCT_NAME」に指定する値は，JP1イベントの拡張属性「PRODUCT_NAME」に指定する値と同じにする必要があります。

サブキー定義

サブキー定義は，モニター画面の呼び出し時に固定キーからリンクされ，イベント属性をキーとして登録します。

形式

DEF_SUBKEY
NAME=サブキー名
       KEYS=属性名1 [, 属性名2[,属性名3[,属性名4]]]

引数

NAME=サブキー名
サブキーの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

KEYS=属性名1 [, 属性名2[,属性名3[,属性名4]]]
属性名の指定形式を次に示します。

表2-46　属性名の指定形式

指定形式 | 値の形式 | 意味および内容
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.拡張属性名 | 文字列 | 拡張属性

注※

発行元イベントサーバ名（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を指定します。
なお，「"jco_"」で始まる文字列はアプリケーション実行定義識別子として予約されているため，使用できません。

PATH="コマンド引数"
EXEC_IDで指定した実行形式ファイルに渡すコマンド引数を指定します。EXEC_IDで指定した実行形式ファイル名とここで指定した引数によってコマンドラインが構成されます。例えば，次のようなコマンドラインがあるとします。
"app.exe arg1 arg2"
コマンド引数には，この「arg1」「arg2」の部分を指定します。
PATHには，ビューアーの動作環境属性およびイベント属性値で置換できる予約キーワードを指定できます。置き換えキーワードを次に示します。

表2-47　置き換えキーワード

キーワード
置換する語句

%JCO_JP1USER%
セントラルコンソールのログインユーザー名

%JCO_INSTALLPATH%
ビューアーのインストールフォルダ名

%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」を渡して実行することを意味します。

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では，次の表に示す定義ファイルを提供しています。連携製品の対応バージョンの詳細については，各連携製品のマニュアルをご確認ください。

表2-48　統合機能メニューの名称と対応するWWWページ呼び出し定義ファイル一覧

統合機能メニューのメニュー項目
WWWページ呼び出し定義ファイル名
製品名
JP1/IM - Managerと連携できるバージョン
対応OS

フォルダ名
サブフォルダ名
機能名

ネットワーク管理
－
ネットワークノードマネージャー
hitachi_jp1_cm2.html
JP1/Cm2/NNM
バージョン8以前
制限なし

HP NNM
バージョン7.5以前

資産・配布管理
－
統合資産管理
hitachi_jp1_assetinfomationmanager.html
JP1/NETM/Asset Information Manager
制限なし
Windows VistaおよびWindows 7以外のWindows

－
資産・配布管理※
hitachi_jp1_netmdm.html
JP1/NETM/DM Manager
バージョン7以前
Windows Vista以外のOS

ストレージ管理
ストレージエリア管理
ストレージシステム稼働管理
hitachi_jp1_hicommand_tuning_manager.html
JP1/HiCommand Tuning Manager
バージョン3以降
Windows，Solaris (SPARC)，Linux

ストレージハードウェア管理
hitachi_jp1_hicommand_device_manager.html
JP1/HiCommand Device Manager
バージョン3以降

ストレージリソース割当管理
hitachi_jp1_hicommand_provisioning_manager.html
JP1/HiCommand Provisioning Manager
バージョン03-50～06-40

ストレージレプリケーション管理
hitachi_jp1_hicommand_replication_manager.html
Hitachi Replication Manager
バージョン03-50以降（バージョン5より前の場合は，Replication Monitor）

階層ストレージリソース管理
hitachi_jp1_hicommand_tiered_storage_manager.html
JP1/HiCommand Tiered Storage Manager
バージョン4以降

グローバル入出力パス稼働管理
hitachi_jp1_hicommandGLAM.html
JP1/HiCommand Global Link Availability Manager
バージョン05-00～06-60
Windows Server 2003 R2（SP2）
Windows XP Professional（SP2またはSP3）
Windows Vista（SPなし，SP1，SP2）
Windows Server 2008（SPなし，SP2），Windows Server 2008 (x64)（SPなし，SP2）
Windows Server 2008 R2 (x64)（SPなし，SP1）
Windows 7（SPなし）

サーバ管理
－
Webコンソール
hitachi_jp1_systemmanager.html
JP1/Server Conductor
制限なし
制限なし

（凡例）

－：なし

注※　Windows 7，Windows Server 2008，およびWindows Vista版のJP1/IM - Viewでは，JP1/NETM/DM Managerの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.model（統合機能メニュー定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥function¥ja¥

説明

統合機能メニュー定義ファイルは，JP1/IM - Viewの［統合機能メニュー］画面に表示するツリー構造や表示項目などを定義するためのファイルです。

なお，JP1/IMには，統合機能メニュー定義ファイルの記述内容をチェックするためのコマンド「jcofuncfcheck」が用意されています。このコマンドの詳細については，「1.　コマンド」を参照してください。

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

@file="function-definition"

この定義ファイルが統合機能メニュー定義ファイルであることを宣言します。このステートメントは必須です。

このステートメントは，ファイル内の先頭行に記述しなければなりません。

機能ツリーメニュー定義ブロック

［統合機能メニュー］画面に表示するフォルダまたは機能を作成し，機能が選択されたときに実行するアプリケーションとの関連をアプリケーション実行定義識別子で定義します。

なお，［統合機能メニュー］画面に表示される機能の順序はファイル名順になります。一つのファイル内では，定義ブロック順になります。メニューの表示順序を変更したい場合は，これらの順序を変更してください。

このブロックに記述できるステートメントは，フォルダを定義する場合と機能を定義する場合で異なります。

フォルダを定義する場合

idステートメント

parent_idステートメント

nameステートメント

機能を定義する場合

idステートメント

parent_idステートメント

nameステートメント

execute_idステートメント

iconステートメント

argumentsステートメント

これ以外のステートメントが記述された場合は，エラー出力され，該当するステートメントだけが無視されます。

次に，ステートメントについて説明します。

id="メニュー識別子";

機能ツリーメニュー定義ブロックのメニュー識別子を定義します。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

同一の「id」を持つブロックが解析対象のファイル内に複数個存在した場合，次の順に優先順位が決定され，最優先のブロックが有効になります。

ファイル名を昇順でソートしてあとの方のブロック

ファイル内の位置があとの方のブロック

それ以外のブロックは無効になります。

メニュー識別子には，32バイト以内の半角英数字を指定できます。この文字列は，統合機能メニュー定義ファイル内でユニークでなければなりません。ユニーク性を保持するために，次の命名規則に従ってください。

フォルダを定義する場合
会社名[_製品名]

機能を定義する場合
会社名_製品名[_機能名(または画面名)]

適切なフォルダ名称がすでに存在している場合は，フォルダを新規に追加しないで，定義ファイル格納場所のほかの定義ファイルに記述してあるフォルダを使用してください。

「"root"」は最上位のメニュー識別子として予約されているため，使用できません。

「"jco_"」で始まる文字列はアプリケーション実行識別子として予約されているため，使用できません。

parent_id="親メニュー識別子";

自メニュー識別子に対して，ツリー構造上の上位にあるrootまたはメニュー識別子を指定します。階層は，rootを含めて3階層まで指定できます。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

複数の親メニュー識別子を指定して複数の上位フォルダを持つことはできません。

name="表示名称";

［統合機能メニュー］画面に表示する名称を定義します。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

表示名称には，［統合機能メニュー］画面上に表示される文字列を指定します。文字列には日本語文字を含めることができます。内容のわかりやすい簡潔な表示名称を指定してください。

指定した値はメニュー上に表示されるため，名詞にすることをお勧めします。例えば，「コマンド実行機能」などの文字列にします。

指定する値は，定義内でユニークでなくてもかまいませんが，操作性を考えてユニークにすることをお勧めします。

execute_id="アプリケーション実行定義識別子";

統合機能メニューに表示される機能をダブルクリックしたときに実行するアプリケーション実行定義識別子を指定します。このステートメントは機能を指定する場合は必須です。このステートメントは，ブロック内で1回だけ指定できます。

フォルダを作成する場合は，このステートメントを指定しても無視されます。

指定したアプリケーション実行定義識別子が存在しない場合，メニューは表示されません。

「"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 ［コマンド］ボタンのコメント]
   [hst 実行ホスト名]
   cmd コマンドライン
   [var 環境変数ファイル名]
   [qui 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コマンドを実行して［コマンド］ボタンが有効な場合に，［コマンド実行］画面を表示するときに反映されます。

記述内容

DESC_VERSION=ファイルバージョン

コマンドボタン定義ファイルの形式のバージョンを表しています。指定する値は1です。省略した場合や1以外の数値を指定した場合は，1が仮定されます。

#コメント文

#で始まる行は，コメント扱いとなります。

def～end-def（定義ブロック）

コマンドボタン定義の開始と終了のパラメーターです。64個まで指定できます。

[usr 対象ユーザー名 対象ユーザー名 …]

［コマンド］ボタンを使用するJP1ユーザー名を指定します。対象ユーザー名は，31バイトまでの文字列で指定します。複数指定する場合は，一つ以上の連続した半角スペースまたはタブを対象ユーザー名と対象ユーザー名の間に挿入して区切ります。複数指定では，100個まで指定できます。省略した場合，すべてのJP1ユーザーを対象ユーザーとします。def～end-defの間に1個指定できます。btn～end-btnの間には指定できません。

btn ［コマンド］ボタン名～end-btn

［コマンド］ボタンの開始と終了パラメーターです。［コマンド］ボタン名は，［コマンド］ボタンの名称として［コマンド実行］画面の上に表示されます。一つの［コマンド］ボタン名に対して，8文字まで指定できます。指定できる文字は，制御文字（0x00～0x1F，0x7F～0x9F）以外の文字列です。大文字・小文字は区別します。［コマンド］ボタンは，定義ブロックの中に16個まで定義できます。重複した［コマンド］ボタン名は指定できません。

[cmt ［コマンド］ボタンのコメント]

［コマンド］ボタンの説明を記述します。コメントは，ツールチップとして表示されます。このパラメーターは省略できます。コメントは40文字まで指定できます。指定できる文字は，すべての文字です。

[hst 実行ホスト名]

コマンドを実行するホスト名を指定します。実行ホスト名には，ホスト名，ホストグループ名，業務グループ名，および監視グループ名を指定できます。

ホスト名，ホストグループ名には，最大255バイトの文字列を指定できます。業務グループ名，監視グループ名には，最大2,048バイトの文字列を指定できます。このパラメーターは省略できます。

統合監視DBおよびIM構成管理DBが有効な場合に，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，パス表記で業務グループ名を指定しても，ホスト名またはホストグループ名として扱われます。

cmd コマンドライン

実行するコマンドを指定します。コマンドラインは4,096バイトまで指定できます。このパラメーターは省略できません。

[var 環境変数ファイル名]

実行するコマンドの環境変数を指定した環境変数ファイルのファイル名を指定します。このパラメーターは省略できます。環境変数ファイルの形式については，「環境変数ファイル」（2.　定義ファイル）を参照してください。環境変数ファイル名は255バイト以内の文字列で指定します。

[qui true|false]

［コマンド］ボタンを使用してコマンドを実行する前に，コマンドを実行してもよいか確認するメッセージを表示させるかどうかを指定します。確認するメッセージを表示させないと，［コマンド］ボタンをクリックすると同時にコマンドが実行されます。

確認するメッセージを表示させない場合はtrue，表示させる場合はfalseを指定します。省略した場合，falseが指定されます。

trueまたはfalseは，大文字・小文字を区別しません。

定義例

DESC_VERSION=1

#Aシステム担当者用コマンド
def
 usr AsysOpe1 AsysOpe2
 btn ログ確認1
   cmt マネージャーのログを表示します。
   hst AsysMgr
   cmd showlog.bat
 end-btn

 btn ログ確認2
   cmt エージェントのログを表示します。実行ホスト名を指定してください。
   cmd showlog.bat
 end-btn

 btn マネージャ再起動
   cmt マネージャーを再起動します。
   hst AsysMgr
   cmd restart.bat
 end-btn
end-def

# Bシステム担当者用コマンド
def
 usr BsysOpe1 BsysOpe2
 btn エジェント再起動
   cmt エージェントを再起動します。実行ホスト名を指定してください。
   cmd restart.bat
 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）で指定するプログラム識別子と同一にする必要があります。

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）で指定するアイコン識別子と同一にする必要があります。

定義例

#
# 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で指定するアイコン識別子と同一にする必要があります。

name="ツールチップ";

カーソルをアイコンの上に置いたときに表示されるツールチップを指定します。

iconstandard="アイコン格納パス";

通常時に表示されるアイコンをフルパスで指定します。

icondown="アイコン格納パス";

アイコンをクリックしたときに表示されるアイコンをフルパスで指定します。

iconrollover="アイコン格納パス";

カーソルをアイコンの上に移動したときに表示されるアイコンをフルパスで指定します。

icondisable="アイコン格納パス";

そのプログラムが起動できない場合に表示されるアイコンをフルパスで指定します。

execute_id="プログラム識別子";

起動するプログラムを表す識別子を指定します。識別子として指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するプログラム識別子は，起動プログラム定義ファイル（!JP1_CS_APP0.conf）で指定するプログラム識別子と同一にする必要があります。

arguments="引数";

起動プログラム定義ファイル（!JP1_CS_APP0.conf）で定義した起動するプログラム（起動パス）に対する引数を指定します。

定義例

#----------------------------------------------------------
# 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=08100000;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=08100000

CSVファイルのフォーマットバージョンです。

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を変更した場合は，画面表示に問題がないか［ビジュアル監視］画面の確認をしてください。

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

形式

jcfview.login.host.max=ホストの最大記録数
jcfview.login.user.max=ユーザーの最大記録数
jcfview.screen.history.enable=画面表示設定履歴機能の使用／不使用
jcfview.response.wait.time=応答待ちタイムアウト時間
jcfview.imconfigreflect.response.wait.time=システムの階層構成の反映応答待ちタイムアウト時間

ファイル

jcfview.conf（IM構成管理・ビューアー動作定義ファイル）

jcfview.conf.model（IM構成管理・ビューアー動作定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥jcfview¥

説明

IM構成管理・ビューアーの動作を指定するファイルです。

定義の反映時期

IM構成管理・ビューアーの起動時に有効になります。

記述内容

jcfview.login.host.max

ログインに成功したホストの最大記録数を10進数で記述します。指定できる値は0～20です。デフォルトは5です。

jcfview.login.user.max

ログインに成功したユーザーの最大記録数を10進数で記述します。指定できる値は0または1です。デフォルトは1です。

jcfview.screen.history.enable

画面起動時に前回の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.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

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

形式

[論理ホスト名¥JP1CONFIG]
" APPLY_CONFIG_TYPE"=dword:00000001

ファイル

jp1cf_applyconfig.conf（IM構成反映方式設定ファイル）

格納先ディレクトリ

Windowsの場合

物理ホスト：Managerパス¥conf¥imcf¥

論理ホスト：共有フォルダ¥JP1IMM¥conf¥imcf¥

UNIXの場合

物理ホスト：/etc/opt/jp1imm/conf/imcf/

論理ホスト：共有ディレクトリ/jp1imm/conf/imcf/

説明

JP1/IM - Managerをインストールすると自動生成されるファイルです。

定義の反映時期

次のコマンドを実行し，JP1/IM - Managerを起動・再起動した場合か，jco_spmd_reloadコマンドでリロードした場合に設定を反映します。

jbssetcnf Managerパス¥conf¥imcf¥jp1cf_applyconfig.conf

記述内容

APPLY_CONFIG_TYPE

システムの階層構成の反映方法を指定します。

00000000
システムの階層構成を削除後に反映します。この項目は，デフォルトで設定されています。

00000001
システムの階層構成を削除しないで反映します。

値が不正または定義が存在しない場合は，デフォルトが仮定されます。

定義例

[JP1_DEFAULT¥¥JP1CONFIG]
" APPLY_CONFIG_TYPE"=dword:00000001

セットアップ情報ファイル（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をセットアップしたあとに，もう一方のデータベースを作成する場合には，同じ値を指定する必要があります。

セットアップ情報ファイルに指定したデータベースのサイズと作成するデータベースのサイズを次の表に示します。

表2-49　作成するデータベースのサイズ

サイズ | システムDB領域※（ギガバイト） | 統合監視DB領域※（ギガバイト） | IM構成管理DB領域※（ギガバイト） | 合計（ギガバイト）
S | 1 | 9 | 1 | 11
M | 2 | 33 | 1 | 36
L | 8 | 96 | 10 | 114

注※

システムDB領域，統合監視DB領域，およびIM構成管理DB領域は，セットアップ情報ファイルに指定したデータベース格納先ディレクトリ（IMMDBDIR）の直下に作成されます。インストールに必要な容量は，110メガバイトです。

定義の反映時期

セットアップ時に，このファイルの内容を読み込み，各項目に指定された値でIMデータベースの環境を構築します。

記述内容

IMDBSIZE

作成するIMデータベースのサイズを半角英大文字のS，M，Lで指定します。デフォルトはSです。

IMDBDIR

IMデータベースのデータを格納するディレクトリを絶対パス形式で指定します。指定したディレクトリの直下にimdbディレクトリを作成し，IMデータベースのファイル（領域）を格納します。デフォルトは次のとおりです。

Windowsの場合：Managerパス¥database
ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：/var/opt/jp1imm/database
指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

絶対パス形式で使用できる文字列を次に示します。

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
指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。
また，シンボリックリンクを含むパスは指定しないでください。

絶対パス形式で使用できる文字列を次に示します。

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（クラスタセットアップ情報ファイル）を別名でコピーし，設定情報を変更する必要があります。

クラスタセットアップ情報ファイルに指定したデータベースのサイズと作成するデータベースのサイズを示します。

表2-50　作成するデータベースのサイズ

サイズ | システムDB領域（ローカルディスク）※1（ギガバイト） | システムDB領域（共有ディスク）※1（ギガバイト） | 統合監視DB領域※2（ギガバイト） | IM構成管理DB領域※2（ギガバイト） | 合計（ギガバイト）
S | 0.05 | 0.95 | 9 | 1 | 11
M | 0.1 | 1.9 | 33 | 1 | 36
L | 0.6 | 7.4 | 96 | 10 | 114

注※1

システムDB領域（ローカルディスク）は，クラスタセットアップ情報ファイルに指定したローカルデータベース格納ディレクトリの直下（IMMDBDIR）に作成されます。

注※2

システムDB領域（共有ディスク），統合監視DB領域とIM構成管理DB領域は，クラスタセットアップ情報ファイルに指定した共有データベース格納先ディレクトリ（SHAREDBDIR）の直下に作成されます。インストールに必要な容量は，110メガバイトです。

定義の反映時期

セットアップ時に，このファイルの内容を読み込み，各項目に指定された値でIMデータベースの環境を構築します。

記述内容

LOGICALHOSTNUMBER

IMデータベースの論理ホストを識別する番号を1～9の半角数値で指定します。

論理ホストを追加する場合は，別の番号を指定する必要があります。実行系と待機系で同じ番号を指定してください。

LOGICALHOSTNAME

論理ホスト名を指定します。論理ホスト名はjp1cohasetupコマンドおよびjp1cc_setup_clusterコマンドで指定した論理ホスト名を指定してください。指定できる文字列は，半角英数字，_，-，.（ピリオド），および＠で構成される32文字以内の文字列です。なお，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

IMDBSIZE

作成するIMデータベースのサイズを半角英大文字のS，M，Lで指定します。デフォルトはSです。

IMDBDIR

IMデータベースのデータを格納するディレクトリを絶対パス形式で指定します。指定したディレクトリの直下にimdbディレクトリを作成し，IMデータベースのファイル（ローカル作業領域用）を格納します。

Windowsの場合：
ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：
指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：
半角英数字，_，¥，(，)，.（ピリオド），および半角スペースで構成される95文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：
半角英数字，_，/，および.（ピリオド）で構成される95文字以内の文字列です。パス区切り文字（/）で始める必要があります。

IMDBPORT

IMデータベースが使用するポート番号を指定します。指定できる範囲は，5001～65535です。

ここで指定するポート番号は，次のポート番号とは重複できません。

ほかの論理ホストのセットアップで指定したポート番号

servicesファイルに記載されているポート番号※

ほかの製品の組み込みHiRDBで使用しているポート番号

ほかの製品，OSなどが使用する一時ポート番号

注※　IMDBPORTに設定したポート番号を，あとでservicesファイルに記載しないようにしてください。

SHAREDBDIR

クラスタ構成時に実行系と待機系で共有するIM データベースのデータを格納するディレクトリを絶対パス形式で指定します。指定したディレクトリの直下にimdbディレクトリを作成し，IMデータベースのファイル（共有データ領域用）を格納します。

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：
半角英数字，_，¥，(，)，.（ピリオド），および半角スペースで構成される95文字以内の文字列です。ドライブ名で始める必要があります。
ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：
半角英数字，_，/，および.（ピリオド）で構成される95文字以内の文字列です。パス区切り文字（/）で始める必要があります。
指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

ONLINEHOSTNAME

実行系のホスト名を指定します。指定できる文字列は，半角英数字，_，-，/，.（ピリオド），および＠で構成される32文字以内の文字列です。なお，論理ホスト名は，大文字・小文字を区別します。なお，実行系のホスト名は，大文字・小文字を区別します。実行系のホスト名は大文字・小文字を含めて正確に指定してください。

IMDBENVDIR

IMデータベースをインストールするディレクトリを絶対パス形式で指定します。指定したディレクトリの直下にディレクトリ（JMn：nはLOGICALHOSTNUMBERと一致します）を作成し，IMデータベースをインストールします。デフォルトは次のとおりです。

Windowsの場合：Managerパス¥dbms
ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：/var/opt/jp1imm/dbms
指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。
また，シンボリックリンクを含むパスは指定しないでください。

絶対パス形式で使用できる文字列を次に示します。

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.固有の拡張属性名 | 固有の拡張属性

項目名の先頭に「@」を指定すると，基本属性および拡張属性の日時項目をYYYYMMDDhhmmss形式で出力します。指定した属性に数値以外の値，0未満の数値，または2147483647以上の数値が入っている場合，変換しないで出力します。JP1イベントに属性がない場合は，空文字を出力します。

#コメント文

#で始まる行は，コメント扱いとなります。

定義例

B.SEQNO
B.ID
B.PROCESSID
B.TIME
　：

イベントレポート出力のフィルターファイル

形式

イベント条件
   ：
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
発行元イべントサーバ名※
B.SOURCESERVER

9
送信先イベントサーバ名※
B.DESTSERVER

10
メッセージ
B.MESSAGE

11
重大度
E.SEVERITY
一致する

"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）の中から指定できる。

複数指定できる。ただし，重複した重大度は指定できない。

12
拡張属性
E.拡張属性名

から始まる

一致する

一致しない

を含む

を含まない

正規表現

拡張属性名には，先頭が英大文字で英大文字，数字，およびアンダーバー（_）から構成される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件指定できる。ただし，正規表現では複数指定はできない。

注※

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・小文字を区別しません。

定義例

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-51　ステートメントの種類

ステートメントの分類
ステートメントの種類

ファイル内ステートメント
ブロック開始ステートメント
ブロック終了ステートメント
ファイル属性ステートメント
プロダクトステートメント

ブロック内ステートメント
機能メニューコマンドオプション定義ステートメント
イベント属性定義ステートメント
ブロック属性定義ステートメント
機能メニュー実行定義識別子定義ステートメント
アプリケーション説明定義ステートメント
グループ定義ステートメント
機能メニュー表示アイコン定義ステートメント
アプリケーション実行定義識別子定義ステートメント
機能メニュー識別子定義ステートメント
機能メニュー表示名定義ステートメント
順序定義ステートメント
機能メニュー親識別子定義ステートメント
アプリケーションパス定義ステートメント

ステートメントの構造

表2-52　ステートメントの構造

ステートメントの種類 | 記述形式
ブロック開始ステートメント | @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-53　ステートメント内の構成要素に指定できる値

構成要素
指定できる値

16進数値文字
0～9およびA～F

EUCJIS
EUCJIS

JIS
JIS

Shift-JIS
SJIS

アプリケーション実行の説明文
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|E).属性名文字列

属性名文字
半角英大文字|半角数字|_

属性名文字列
0～31バイトの半角英大文字の属性名文字

属性名並び
属性名|属性名並び¥|属性名

定義ファイルタイプ
イベント拡張属性定義|アプリケーション実行定義|モニター画面呼び出し定義|統合機能メニュー定義

定義フォーマットバージョン
0300

適用バージョン
ALL|バージョン|バージョン範囲指定

日時表示フォーマット
date_format:表示タイムゾーン

日本語
Japanese

日本語文字
半角仮名を除く2バイト文字

日本語文字コード
Shift-JIS|EUCJIS|JIS

表示アイコンファイル名
ファイル名

表示タイムゾーン
CLIENT

表示フォーマット
日時表示フォーマット

表示項目文字
英数字|空白|-|_|日本語文字

表示項目文字列
0～64バイトの表示項目文字列

表示項目名
表示項目文字列

表示名称
1～32バイトのユーザー定義文字列

列挙セパレーター
¥|

3.　JP1イベント

この章では，JP1/IMが出力するJP1イベントの種類とその属性について説明します。

＜この章の構成＞

3.1　JP1イベントの属性

3.2　JP1/IMが出力するJP1イベント

3.1　JP1イベントの属性

JP1イベントの属性を示します。JP1イベントの属性には基本属性と拡張属性があります。

基本属性は，すべてのJP1イベントが持っている属性です。拡張属性は，JP1イベントを発行するプログラムが独自に割り当てる属性です。

＜この節の構成＞

3.1.1　基本属性

3.1.2　拡張属性

3.1.1　基本属性

JP1イベントの基本属性を次の表に示します。

なお，基本属性の属性名にはB.IDのように先頭に「B.」を付けて区別する場合があります。設定する際に「B.」を付ける必要がある場合は，マニュアル内でそのつど説明しています。

表3-1　JP1イベントの基本属性

項目
属性名
内容

イベントDB内通し番号
SEQNO
発行元によらないでこのイベントサーバに到達した順番。

イベントID
ID
発行アプリケーションプログラムや事象の内容を表す8バイトの値。

登録要因
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進数文字列の終了コード。この項目は設定されない場合もある。

3.2　JP1/IMが出力するJP1イベント

JP1/IMが出力するイベントについて説明します。

＜この節の構成＞

3.2.1　JP1/IMが出力するJP1イベント一覧

3.2.2　JP1イベントの詳細

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 表示できなかったイベントがあります。
表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，次の検索条件を指定してください。
（１） 検索ホスト名として，接続中のホスト名を指定する
（２） 登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する
このイベントが頻繁に表示される場合は，次の条件に該当していないか確認し，必要があれば設定値を見直してください。
（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い
（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい
（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい
イベントコンソールサービス

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からキャンセルされ，応答待ちイベントが「対処済」になった場合

KAVB1577-I 対処状況の操作が行われました(操作ユーザー:JP1ユーザー,イベントID:イベントID,対処前状況:対処前状況,対処後状況:対処後状況)
イベントコンソールサービス

00003F13※4
［システム環境設定］画面，［イベント取得条件一覧］画面，またはjcochfilterコマンドによって，JP1/IM - Managerのイベント取得フィルター条件が変更されたことを通知する場合
KAVB4014-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(フィルター名：フィルター名 ，最後に受信したイベント：到着時刻=到着時刻，イベントDB内通し番号=イベントDB内通し番号)
イベント基盤サービス

00003F14※4
［システム環境設定］画面，［イベント取得条件一覧］画面，またはjcochfilterコマンドによって，JP1/IM - Manager（インシデント登録サービス）のイベント取得フィルター条件が変更されたことを通知する場合
KAJV0179-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（フィルター名：フィルター名，最後に受信したイベント：到着時刻YYYY/MM/DD HH:MM:SS, イベントDB内通し番号：イベントDB内通し番号）
インシデント登録サービス

相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントID
設定した相関イベント発行条件が相関イベント発行処理で成立した場合
相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたメッセージ
相関イベント発行機能

相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントID
設定した相関イベント発行条件が相関イベント発行処理で不成立になった場合
相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたメッセージ
相関イベント発行機能

00003F15
統合監視DBが有効な場合に，［重要イベント定義］画面からJP1/IM - Central Consoleの重要イベント定義が変更された事を通知する場合に発行される。
KAVB1669-I 重要イベント定義ファイルを読み込みました。次に取得したイベントから読み込んだ定義で処理されます（最後に取得したイベント：到着時刻=最後に取得したイベントの到着時刻，イベントDB内通し番号=最後に取得したイベントのイベントDB内通し番号）。
イベント基盤サービス

00003F16
統合監視DBからイベントを取得するときにエラーが発生した場合
KAVB1671-W 統合監視DBからイベントを取得するときにエラーが発生しました。
システムプロファイルに指定された回数リトライしましたが，回復しません。
このため，以降のイベントは表示されません
イベントコンソールサービス

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で使用する正規表現を拡張していないため相関イベント発行サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します
イベント相関機能

00003F24
JP1/IM - Manager起動時にJP1/Baseで使用する正規表現の設定が拡張正規表現でない場合かつJP1/IM - Managerの共通除外条件群の動作モードが拡張モードに設定されている場合
KAJV0502-W JP1/Baseで使用する正規表現を拡張していないためインシデント登録サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します
インシデント登録サービス

00003F25
jcoegsstartコマンドによって，相関イベント発行処理を再開したことを通知する場合
KAJV2243-I 相関イベント発行機能を再開しました
相関イベント発行サービス

00003F26
jcoegsstopコマンドによって，相関イベント発行サービスを停止せずに相関イベント発行処理を停止したことを通知する場合
KAJV2234-I 相関イベント発行機能を停止しました
相関イベント発行サービス

00003F28
相関イベント発行サービスが発行処理しているJP1イベントの組数が上限値の20,000組に達した場合
KAJV2322-W 相関中のJP1イベントの組が上限(20000組)に達しているためJP1イベント（イベントID=イベントID，イベントDB内通し番号=イベントDB内通し番号）を相関できませんでした
相関イベント発行サービス

00003F30
インシデント登録サービスが相関処理しているJP1イベントの組数が上限値の20,000組に達した場合
KAJV0322-W 相関中のJP1イベントの組が上限(20000組)に達しているためJP1イベント（イベントID=イベントID，イベントDB内通し番号=イベントDB内通し番号）を相関できませんでした
インシデント登録サービス

00003F41
滞留できる上限を超えて応答待ちイベントが発生した場合
KAVB0551-E マネージャーで滞留している応答待ちイベントが上限2000件を超えました
イベントコンソールサービス

00003F42
応答待ちイベント滞留ファイルの応答待ちイベントデータの読み込みに失敗した場合
KAVB1816-W 表示できなかった応答待ちイベントがあります。
表示できなかった応答待ちイベントを確認するには，［イベント検索条件設定］画面を表示し，次の検索条件を指定してください。
（１）検索ホスト名として，接続中のホスト名を指定する。
（２）応答待ちイベントとして，対象を指定する。
（３）到着時刻として，このJP1イベントの前又は後に表示されているイベントの到着時刻を指定する。
イベントコンソールサービス

00003F51
統合監視DBからイベントが削除された場合
KAVB1841-I 削除対象始点日から削除対象終点日のイベントを統合監視DBから削除しました
統合監視DB

00003F52
保存出力していないイベントが削除警告位置を超えた場合
KAVB1842-W 保存出力していないイベントが削除警告位置（削除警告位置%）を超えました
保存出力機能

00003F53
統合監視DBへのイベント登録処理でエラーが発生した場合
KAVB1832-E 統合監視DBへのイベント登録処理でエラーが発生しました。統合監視DBへのイベント登録をリトライします（詳細情報：詳細情報）
イベント基盤サービス

00003F54
統合監視DBへのイベント登録処理で発生していたエラーが回復した場合
KAVB1833-I 統合監視DBへのイベント登録処理で発生していたエラーが回復しました。イベント基盤サービスはイベント取得を再開しています
イベント基盤サービス

00003F61
重大度変更定義を反映した場合jco_spmd_reloadを実行した場合
KAVB4600-I 重大度変更定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）
イベント基盤サービス

00003F62
重大度変更定義を反映した場合jco_spmd_reloadを実行した場合
KAJV0250-I 重大度変更定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）
インシデント登録サービス

00003F63
発生元ホストマッピング定義を反映した場合
jco_spmd_reloadを実行した場合
KAVB4650-I 発生元ホストマッピング定義ファイルを読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)
発生元ホストマッピング機能

00003F64
業務グループを反映した場合
KAVB8453-I 業務グループを反映しました。次に受信したイベントから処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)
業務グループの参照・操作制限

00003F66
業務グループを反映した場合
KAVB8453-I 業務グループを反映しました。次に受信したイベントから処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)
業務グループの参照・操作制限

00003F67
発生元ホストマッピング定義を反映した場合
jco_spmd_reloadを実行した場合
KAJV0600-I 発生元ホストマッピング定義ファイルを読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)
発生元ホストマッピング機能

00003F68
業務グループを反映した場合
KAVB8454-W 業務グループを反映できませんでした。(要因:要因)
業務グループの参照・操作制限

00003F69
業務グループを反映した場合
KAVB8456-E 業務グループを反映できませんでした。(要因:要因)
業務グループの参照・操作制限

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イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，ログファイル名: ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)
リモート監視機能

00003FD0
リモート監視のイベントログトラップがWindowsイベントの監視を開始できない場合
KNAN26107-E リモートイベントログトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)
リモート監視機能

00003FD1
リモート監視のイベントログトラップの読み込みリトライ回数がしきい値をオーバーし，該当Windowsイベントの監視を停止した場合
KNAN26028-E 指定された回数リトライ処理を行いましたが，イベントログの読み込みが出来ないためリモート監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)
リモート監視機能

00003FD2
イベントログの収集をリトライした場合
KNAN26027-I イベントログの読み込みをリトライします。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)
リモート監視機能

00003FD3
リモート監視のイベントログトラップが異常終了した場合
KNAN26002-E 続行できないエラーが発生したため，リモートイベントログトラップを停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)
リモート監視機能

00003FD4
イベントログの収集リトライにより，イベントログの収集に成功した場合
KNAN26026-I イベントログの監視が可能になりました。(監視対象ホスト名: 監視対象ホスト名)
リモート監視機能

00003FD5
リモート監視のイベントログトラップで収集したイベントログの差分データが，ログの取得上限を超えている場合
KNAN26142-W リモートイベントログトラップにおいて，監視対象ホストから収集したイベントログのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているイベントログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)
リモート監視機能

ACTDEFパラメーターに指定されている値
APのログファイルのレコードを検知した場合
ログファイルの1行分のデータの内容
リモート監視機能

00003A71
Windowsイベントのログメッセージを検知した場合
イベントログのメッセージ
リモート監視機能

00003F90※6
プロセスが異常終了した場合
KAVB3737-E コンポーネント名 の管理対象プロセス名は異常終了しました
JP1/IM - Managerのプロセス管理

00003F91※6
プロセス起動時にタイムアウトした場合
KAVB3613-W コンポーネント名 の管理対象プロセス名の起動がタイムアウトしました. 処理を継続します
JP1/IM - Managerのプロセス管理

00003F92※6
異常終了したプロセスが再起動完了した場合
KAVB3616-I コンポーネント名 の管理対象プロセス名の再起動が完了しました
JP1/IM - Managerのプロセス管理

注※1　これらのイベントはダミーイベントです。次の制限事項があります。

［イベントコンソール］画面のイベント検索で検索できません。

イベントの詳細を表示した場合，JP1イベントの基本属性および拡張属性は表示されません。

このイベントに自動アクションを設定しても，アクションは実行されません。

このイベントにイベント情報マッピングを定義しても，マッピングされません。

このイベントは，モニター起動の対象外です。

このイベントは，イベント取得フィルターのフィルター対象外です。

このイベントは，相関イベントの発行処理の対象外です。

注※2　JP1/Baseのイベントサービス（jevservice）の回復を検知した場合のメッセージは，「KAVB8063-I 機能名 が回復しました (ホスト名=ホスト名，プロセス名=プロセス名)：保守情報」です。

注※3　これらのイベントには，次の制限事項があります。

このイベントに自動アクションを設定しても，アクションは実行されません。

注※4　これらのイベントには，次の制限事項があります。

このイベントは，イベント取得フィルターのフィルター対象外です。

注※5　JP1/Baseのコマンド実行が発行するJP1イベントです。JP1イベントの詳細については，マニュアル「JP1/Base 運用ガイド」のJP1イベントを説明している章を参照してください。

注※6　プロセスの異常時にJP1イベントを発行させる設定をした場合にだけ発行されます。JP1イベントを発行させたい場合は，IMパラメーター定義ファイルを編集したあと，jbssetcnfコマンドを実行してください。定義ファイルの詳細については「IMパラメーター定義ファイル（jp1co_param_V7.conf）」（2.　定義ファイル）を，設定手順についてはマニュアル「JP1/Integrated Management - Manager 構築ガイド」の「1.19.2　JP1/IM - Managerの障害に備えた設定」（Windowsの場合），「2.18.5　JP1/IM - Managerの障害に備えた設定」（UNIXの場合）を参照してください。

3.2.2　JP1イベントの詳細

＜この項の構成＞

(1)　イベントID：00002010の詳細

(2)　イベントID：00002011の詳細

(3)　イベントID：00002012の詳細

(4)　イベントID：00002013の詳細

(5)　イベントID：00002014の詳細

(6)　イベントID：00002015の詳細

(7)　イベントID：00002016の詳細

(8)　イベントID：00002020の詳細

(9)　イベントID：00002021の詳細

(10)　イベントID：000020A0の詳細

(11)　イベントID：000020A1の詳細

(12)　イベントID：000020A2の詳細

(13)　イベントID：000020A3の詳細

(14)　イベントID：000020A4の詳細

(15)　イベントID：000020A5の詳細

(16)　イベントID：000020A6の詳細

(17)　イベントID：000020E0の詳細

(18)　イベントID：000020E1の詳細

(19)　イベントID：000020E2の詳細

(20)　イベントID：000020E3の詳細

(21)　イベントID：000020E4の詳細

(22)　イベントID：000020E5の詳細

(23)　イベントID：000020E6の詳細

(24)　イベントID：000020E7の詳細

(25)　イベントID：000020E8の詳細

(26)　イベントID：00003F01の詳細

(27)　イベントID：00003F03の詳細

(28)　イベントID：00003F04の詳細

(29)　イベントID：00003F05の詳細

(30)　イベントID：00003F06の詳細

(31)　イベントID：00003F07の詳細

(32)　イベントID：00003F08の詳細

(33)　イベントID：00003F11の詳細

(34)　イベントID：00003F13の詳細

(35)　イベントID：00003F14の詳細

(36)　相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントIDの詳細

(37)　相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントIDの詳細

(38)　イベントID：00003F15の詳細

(39)　イベントID：00003F16の詳細

(40)　イベントID：00003F20の詳細

(41)　イベントID：00003F21の詳細

(42)　イベントID：00003F22の詳細

(43)　イベントID：00003F23の詳細

(44)　イベントID：00003F24の詳細

(45)　イベントID：00003F25の詳細

(46)　イベントID：00003F25の詳細

(47)　イベントID：00003F26の詳細

(48)　イベントID：00003F28の詳細

(49)　イベントID：00003F30の詳細

(50)　イベントID：00003F41の詳細

(51)　イベントID：00003F42の詳細

(52)　イベントID：00003F51の詳細

(53)　イベントID：00003F52の詳細

(54)　イベントID：00003F53の詳細

(55)　イベントID：00003F54の詳細

(56)　イベントID：00003F61の詳細

(57)　イベントID：00003F62の詳細

(58)　イベントID：00003F63の詳細

(59)　イベントID：00003F64の詳細

(60)　イベントID：00003F66の詳細

(61)　イベントID：00003F67の詳細

(62)　イベントID：00003F68の詳細

(63)　イベントID：00003F69の詳細

(64)　イベントID：00003FB0の詳細

(65)　イベントID：00003FB1の詳細

(66)　イベントID：00003FC0の詳細

(67)　イベントID：00003FC1の詳細

(68)　イベントID：00003FC2の詳細

(69)　イベントID：00003FC3の詳細

(70)　イベントID：00003FC5の詳細

(71)　イベントID：00003FD0の詳細

(72)　イベントID：00003FD1の詳細

(73)　イベントID：00003FD2の詳細

(74)　イベントID：00003FD3の詳細

(75)　イベントID：00003FD4の詳細

(76)　イベントID：00003FD5の詳細

(77)　イベントID：ACTDEFパラメーターに指定されている値

(78)　イベントID：00003A71の詳細

(79)　イベントID：00003F90の詳細

(80)　イベントID：00003F91の詳細

(81)　イベントID：00003F92の詳細

(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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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内通し番号

メッセージ
－
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：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

(28)　イベント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

(29)　イベント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

(30)　イベント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

(31)　イベント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

(32)　イベント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

(33)　イベント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

(34)　イベント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が設定されます。

(35)　イベントID：00003F14の詳細

属性種別
項目
属性名
内容

基本属性
イベント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
KAJV0179-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（フィルター名：フィルター名，最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）

拡張属性
共通情報
重大度
SEVERITY
Information

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/JCDMAIN

オブジェクトタイプ
OBJECT_TYPE
SERVICE

オブジェクト名
OBJECT_NAME
JCDMAIN

事象種別
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：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が設定されます。

(41)　イベント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が設定されます。

(42)　イベント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が設定されます。

(43)　イベント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が設定されます。

(44)　イベントID：00003F24の詳細

属性種別
項目
属性名
内容

基本属性
イベント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
KAJV0502-W JP1/Baseで使用する正規表現を拡張していないためインシデント登録サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

拡張属性
共通情報
重大度
SEVERITY
Notice

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/JCDMAIN

オブジェクトタイプ
OBJECT_TYPE
SERVICE

オブジェクト名
OBJECT_NAME
JCDMAIN

事象種別
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：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が設定されます。

(47)　イベント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が設定されます。

(48)　イベント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が設定されます。

(49)　イベントID：00003F30の詳細

属性種別
項目
属性名
内容

基本属性
イベント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
KAJV0322-W 相関中のJP1イベントの組が上限(20000組)に達しているためJP1イベント（イベントID=イベントID，イベントDB内通し番号=イベントDB内通し番号）を相関できませんでした

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/EDS

オブジェクトタイプ
OBJECT_TYPE
SERVICE

オブジェクト名
OBJECT_NAME
EDS

事象種別
OCCURRENCE
RUN

注　00003F30は，JP1イベントの組数が上限に達した時点で1度出力されます。そのあと，JP1イベントの組数が16,000組以下になるまでは，組数が上限に達しても出力されません。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(50)　イベント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が設定されます。

(51)　イベント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が設定されます。

(52)　イベント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形式で置き換えます。

(53)　イベント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が設定されます。

(54)　イベントID：00003F53の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | 登録ホスト名 | SOURCESERVER | イベントが発行されたイベントサーバ名
メッセージ | MESSAGE | KAVB1832-E 統合監視DBへのイベント登録処理でエラーが発生しました。統合監視DBへのイベント登録をリトライします（詳細情報：詳細情報）
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM/EVFLOW
オブジェクトタイプ | OBJECT_TYPE | SERVICE
オブジェクト名 | OBJECT_NAME | EVFLOW
事象種別 | OCCURRENCE | NOTICE

(55)　イベントID：00003F54の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | 登録ホスト名 | SOURCESERVER | イベントが発行されたイベントサーバ名
メッセージ | MESSAGE | KAVB1833-I 統合監視DBへのイベント登録処理で発生していたエラーが回復しました。イベント基盤サービスはイベント取得を再開しています
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM/EVFLOW
オブジェクトタイプ | OBJECT_TYPE | SERVICE
オブジェクト名 | OBJECT_NAME | EVFLOW
事象種別 | OCCURRENCE | NOTICE

(56)　イベント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が動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(57)　イベントID：00003F62の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
ID
00003F62

イベント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
KAJV0250-I 重大度変更定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性
共通情報
重大度
SEVERITY
Information

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/JCDMAIN

オブジェクトタイプ
OBJECT_TYPE
SERVICE

オブジェクト名
OBJECT_NAME
JCDMAIN

事象種別
OCCURRENCE
RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAJV0250-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(58)　イベント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が動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(59)　イベント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が動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(60)　イベントID：00003F66の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
ID
00003F66

イベント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/JCDMAIN

オブジェクトタイプ
OBJECT_TYPE
SERVICE

オブジェクト名
OBJECT_NAME
JCDMAIN

事象種別
OCCURRENCE
RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB8453-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(61)　イベントID：00003F67の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
ID
00003F67

イベント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
KAJV0600-I 発生元ホストマッピング定義ファイルを読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性
共通情報
重大度
SEVERITY
Information

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/JCDMAIN

オブジェクトタイプ
OBJECT_TYPE
SERVICE

オブジェクト名
OBJECT_NAME
JCDMAIN

事象種別
OCCURRENCE
RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB0600-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(62)　イベント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が設定されます。

(63)　イベント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が設定されます。

(64)　イベント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の形式で格納されます。

(65)　イベントID：00003FB1の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | 発行元イベントサーバ名 | SOURCESERVER | イベントが発行されたイベントサーバ名
イベントID | － | 00003FB1
メッセージ | － | 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の後ろに（...）が付加されます。

(66)　イベントID：00003FC0の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003FC0

メッセージ
－
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
監視対象ホスト名

(67)　イベントID：00003FC1の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003FC1

メッセージ
－
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
監視対象ホスト名

(68)　イベントID：00003FC2の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003FC2

メッセージ
－
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
監視対象ホスト名

(69)　イベントID：00003FC3の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003FC3

メッセージ
－
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
監視対象ホスト名

(70)　イベントID：00003FC5の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003FC5

メッセージ
－
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
監視対象ホスト名

(71)　イベントID：00003FD0の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FD0
メッセージ | － | 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 | 監視対象ホスト名

(72)　イベントID：00003FD1の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FD1
メッセージ | － | 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 | 監視対象ホスト名

(73)　イベントID：00003FD2の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FD2
メッセージ | － | 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 | 監視対象ホスト名

(74)　イベントID：00003FD3の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FD3
メッセージ | － | 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 | 監視対象ホスト名

(75)　イベントID：00003FD4の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FD4
メッセージ | － | 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 | 監視対象ホスト名

(76)　イベントID：00003FD5の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FD5
メッセージ | － | 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 | 監視対象ホスト名

(77)　イベントID：ACTDEFパラメーターに指定されている値

属性種別
項目
属性名
内容

基本属性
イベントID
－
ACTDEFパラメーターに指定されている値

メッセージ
－
ログファイル1行分のログデータの内容

イベント発行時刻
－
イベントを発行した時刻

拡張属性
共通情報
重大度
SEVERITY
動作定義ファイルのACTDEFパラメーターで指定された重大度

プロダクト名
PRODUCT_NAME
Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名

jevlogstartコマンドの-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/AGENTLESS/LOGTRAP

ホスト名
JP1_SOURCEHOST
イベント発生元ホスト名（監視対象ホスト名）

（凡例）

－：なし

(78)　イベントID：00003A71の詳細

属性種別
項目
属性名
（WMIの属性名）
内容

基本属性
イベントID
－
00003A71

メッセージ
－
（MessageまたはInsertionStrings）
イベントログのメッセージ※
最大1,023バイト。超えた分は切り捨て。

イベント発行時刻
－
イベントを発行した時刻

拡張属性
共通情報
重大度
SEVERITY
（EventType）
イベントログの種別に応じて登録する。
Error：エラー
Warning：警告
Information：情報，詳細，その他
Notice：監査成功，監査失敗

発行元プロダクト名
PRODUCT_NAME
（SourceName）
/HITACHI/JP1/NTEVENT_LOGTRAP/ソース

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
NTEVENTLOG

登録名タイプ
ROOT_OBJECT_TYPE
LOGFILE

登録名
ROOT_OBJECT_NAME
NTEVENTLOG

固有情報
イベントログ登録日時
A0
（TimeGenerated）
time_t型（UTC 1970-01-01 00:00:00からの秒数）

コンピュータ名
A1
（ComputerName）
コンピュータ名の値

種別
A2
（Logfile）
チャネル名

種類
A3
（Type）
レベルに対応する値

分類
A4
（CategoryStringまたはCategory）
タスクのカテゴリーの値

イベントID
A5
（EventCode）
イベントログのイベントIDの値

ユーザー名
A6
（User）
イベントログのユーザー名の値

プラットフォーム
PLATFORM
NT

PP名
PPNAME

標準モードの場合

/HITACHI/JP1/IM/AGENTLESS/EVENTLOGTRAP

（凡例）

－：なし

注※　イベントログの説明文を記載したメッセージDLLが正しく設定されていない場合は，挿入句や詳細コードをダブルクォーテーションマーク（"）で囲んでJP1イベントのメッセージに登録します。

(79)　イベント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内通し番号

メッセージ
－
KAVB3737-E コンポーネント名 の管理対象プロセス名 は異常終了しました

拡張属性
共通情報
重大度
SEVERITY
Error

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/SPMD

オブジェクトタイプ
OBJECT_TYPE
SPMD

オブジェクト名
OBJECT_NAME
異常終了したプロセス名

事象種別
OCCURRENCE
NOTICE

（凡例）

－：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(80)　イベント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内通し番号

メッセージ
－
KAVB3613-Wコンポーネント名 のプロセス名 の起動がタイムアウトしました. 処理を継続します

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/SPMD

オブジェクトタイプ
OBJECT_TYPE
SPMD

オブジェクト名
OBJECT_NAME
起動タイムアウトしたプロセス名

事象種別
OCCURRENCE
NOTICE

（凡例）

－：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(81)　イベント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内通し番号

メッセージ
－
KAVB3616-I コンポーネント名 の管理対象プロセス名 の再起動が完了しました

拡張属性
共通情報
重大度
SEVERITY
Information

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/SPMD

オブジェクトタイプ
OBJECT_TYPE
SPMD

オブジェクト名
OBJECT_NAME
再起動したプロセス名

事象種別
OCCURRENCE
NOTICE

（凡例）

－：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

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

この章では，JP1/IMで提供しているシステム監視オブジェクトについて説明します。

システム監視オブジェクトとは，システムが提供している監視オブジェクトで，製品ごとに基本的な設定項目があらかじめ定義されています。

この章で説明する監視ツリーや監視オブジェクトに関する機能，および表の見方については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「4.2　監視ツリー」を参照してください。また，監視ツリーや監視オブジェクトの設定手順については，マニュアル「JP1/Integrated Management - Manager 構築ガイド」の「5.3　監視ツリーをGUIで作成する」を参照してください。

＜この章の構成＞

4.1　システム監視オブジェクト対応製品一覧

4.2　JP1/AJS用システム監視オブジェクト

4.3　JP1/Cm2/SSO用システム監視オブジェクト

4.4　JP1/PFM用システム監視オブジェクト

4.5　JP1/PAM用システム監視オブジェクト

4.6　JP1/SCIM用システム監視オブジェクト

4.7　JP1/NETM/DM用システム監視オブジェクト

4.8　JP1/Cm2/NNMi用システム監視オブジェクト

4.9　JP1/Cm2/NNM用システム監視オブジェクト

4.10　JP1/IM - Manager用システム監視オブジェクト

4.11　Cosminexus用システム監視オブジェクト

4.12　HiRDB用システム監視オブジェクト

4.13　JP1/ServerConductor用システム監視オブジェクト

4.1　システム監視オブジェクト対応製品一覧

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 (JP1/APM) 07-00以降※1※2 | 対応済み※3
JP1/PFM 07-00以降 | 対応済み※3
JP1/PAM 07-00以降 | 未対応
JP1/SCIM 07-00以降 | 未対応
JP1/NETM/DM 07-00以降 | 未対応
JP1/Cm2/NNM バージョン7またはバージョン8※2 | 未対応
JP1/Cm2/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.2　JP1/AJS用システム監視オブジェクト

JP1/AJS用のシステム監視オブジェクトには，「AJS監視」と「ジョブネット監視(AJS)」があります。

＜この節の構成＞

4.2.1　「AJS監視」システム監視オブジェクト

4.2.2　「ジョブネット監視(AJS)」システム監視オブジェクト

4.2.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.2.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.3　JP1/Cm2/SSO用システム監視オブジェクト

バージョン8以前のJP1/Cm2/SSO用のシステム監視オブジェクトには，「SSO監視」と「カテゴリー監視(SSO)」および「アプリケーション監視(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トラップのバリアブルバインディングのソース名を取り込むよう設定する必要があります。

＜この節の構成＞

(1)　「SSO監視」システム監視オブジェクト

(2)　「カテゴリー監視(SSO)」システム監視オブジェクト

(3)　「アプリケーション監視(SSO)」システム監視オブジェクト

(1)　「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」が入ります。

(2)　「カテゴリー監視(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」が入ります。

(3)　「アプリケーション監視(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.4　JP1/PFM用システム監視オブジェクト

JP1/PFM用のシステム監視オブジェクトには，「エージェント監視(PFM)」があります。

なお，JP1/PFM用システム監視オブジェクトを監視する場合，次の設定をする必要があります。

JP1/PFM - Managerからの事象を管理するには，JP1/PFM - Managerのアラームの設定で，アラーム状態が変化したときに，コマンド実行のアクションでJP1イベントを発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

＜この節の構成＞

4.4.1　「エージェント監視(PFM)」システム監視オブジェクト

4.4.1　「エージェント監視(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.5　JP1/PAM用システム監視オブジェクト

JP1/PAM用のシステム監視オブジェクトには，「メトリック監視(PAM)」と「オブジェクト監視(PAM)」があります。

＜この節の構成＞

4.5.1　「メトリック監視(PAM)」システム監視オブジェクト

4.5.2　「オブジェクト監視(PAM)」システム監視オブジェクト

4.5.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.5.2　「オブジェクト監視(PAM)」システム監視オブジェクト

表4-16　システム監視オブジェクトの概要

項目
説明

監視ノード種別
オブジェクト監視(PAM)

目的
JP1/PAMが管理するオブジェクトの状態の監視

基本情報
ホスト名
JP1/PAMの監視対象ホストのホスト名
（例）host1

表4-17　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
オブジェクトエラーのイベント（PAM） | エラー | オブジェクトエラーのイベント（PAM）※ | イベントID（B.ID） | 00004620，00004625
ホスト名（E.PAM_HOSTNAME） | 基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.6　JP1/SCIM用システム監視オブジェクト

JP1/SCIM用のシステム監視オブジェクトには，「SCIM監視」と「セキュリティ監視（SCIM）」があります。

＜この節の構成＞

4.6.1　「SCIM監視」システム監視オブジェクト

4.6.2　「セキュリティ監視（SCIM）」システム監視オブジェクト

4.6.1　「SCIM監視」システム監視オブジェクト

表4-18　システム監視オブジェクトの概要

項目
説明

監視ノード種別
SCIM監視

目的
JP1/SCIM自身の障害の監視

基本情報
ホスト名
JP1/SCIM - ManagerがインストールされているSCIMマネージャーのホスト名
（例）host1

表4-19　状態変更条件

状態変更条件
共通条件※，個別条件

条件名
状態
条件
比較する値

システムエラーのイベント（SCIM）
エラー
システムエラーのイベント（SCIM）※
イベントID（B.ID）
0000430B，0000430C，0000430D，0000430E，0000430F，00004311，00004312，00004313，00004314，00004315，00004318，00004319，0000431A，0000431B，0000431C，0000431D，0000431E，0000431F，00004320，00004321，00004322，00004323，00004325，00004326，00004327，00004328，00004329，0000432A，0000432D，0000432E，0000432F，00004330，00004331，00004332，00004335，00004336，00004337，00004338，0000433B，0000433C，0000433D，0000433E，00004341，00004342，00004343，00004344，00004374，00004376，00004378，0000437C，0000437E，00004380，00004381，00004382，00004383，00004384，00004386，00004388，00004389，0000438A，0000438C

発行元イベントサーバ名（B.SOURCE.SERVER）
基本情報のホスト名

システム警告のイベント（SCIM）
警告
システム警告のイベント（SCIM）※
イベントID（B.ID）
00004308，00004309，00004333，00004339，0000433F，00004346，00004373

発行元イベントサーバ名（B.SOURCE.SERVER）
基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.6.2　「セキュリティ監視（SCIM）」システム監視オブジェクト

表4-20　システム監視オブジェクトの概要

項目
説明

監視ノード種別
セキュリティ監視（SCIM）

目的
JP1/SCIMが監視しているセキュリティ製品の状態の監視

基本情報
ホスト名
JP1/SCIM - Runtime LibraryがインストールされているSCIMエージェントのホスト名
（例）host01

表4-21　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
セキュリティエラーのイベント（SCIM） | エラー | セキュリティエラーのイベント（SCIM）※ | イベントID（B.ID） | 0000432B
エージェントホスト名（E.SCIM_AGENT_ADDR） | 基本情報のホスト名
セキュリティ警告のイベント（SCIM） | 警告 | セキュリティ警告のイベント（SCIM）※ | イベントID（B.ID） | 0000432C
エージェントホスト名（E.SCIM_AGENT_ADDR） | 基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.7　JP1/NETM/DM用システム監視オブジェクト

JP1/NETM/DM用のシステム監視オブジェクトには，「NETM/DM監視」と「配布ジョブ監視(NETM/DM)」があります。

＜この節の構成＞

4.7.1　「NETM/DM監視」システム監視オブジェクト

4.7.2　「配布ジョブ監視(NETM/DM)」システム監視オブジェクト

4.7.1　「NETM/DM監視」システム監視オブジェクト

表4-22　システム監視オブジェクトの概要

項目
説明

監視ノード種別
NETM/DM監視

目的
JP1/NETM/DM Manager自身の障害の監視

基本情報
ホスト名
JP1/NETM/DM Managerがインストールされているマネージャーのホスト名
（例）host01

表4-23　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
システム致命的のイベント(NETM/DM) | 致命的 | システム致命的のイベント(NETM/DM)※ | イベントID（B.ID） | 00010401
発行元イベントサーバ名（B.SOURCE.SERVER） | 基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.7.2　「配布ジョブ監視(NETM/DM)」システム監視オブジェクト

表4-24　システム監視オブジェクトの概要

項目
説明

監視ノード種別
配布ジョブ監視(NETM/DM)

目的
JP1/NETM/DMによる配布ジョブの実行状態の監視

基本情報
ホスト名
JP1/NETM/DM Managerがインストールされているマネージャーのホスト名
（例）host01

表4-25　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
配布ジョブエラーのイベント(NETM/DM) | エラー | 配布ジョブエラーのイベント(NETM/DM)※ | イベントID（B.ID） | 00010403
発行元イベントサーバ名（B.SOURCE.SERVER） | 基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.8　JP1/Cm2/NNMi用システム監視オブジェクト

JP1/Cm2/NNMi用のシステム監視オブジェクトには，「NNMi監視(NNMi)」と「ノード監視(NNMi)」があります。なお，JP1/Cm2/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 - Event Gateway for Network Node Manager i」を参照してください。

＜この節の構成＞

4.8.1　「NNMi監視(NNMi)」システム監視オブジェクト

4.8.2　「ノード監視(NNMi)」システム監視オブジェクト

4.8.1　「NNMi監視(NNMi)」システム監視オブジェクト

表4-26　システム監視オブジェクトの概要

項目
説明

監視ノード種別
「NNMi監視(NNMi)」

目的
JP1/Cm2/NNMi自身の障害の監視

基本情報
ホスト名
JP1/Cm2/NNMiがインストールされているマネージャーのホスト名
（例）host01

表4-27　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
システム警戒のイベント(NNMi) | 警戒 | システム警戒のイベント(NNMi)※ | イベントID（B.ID） | 00006100
イベント発生ノード名（E.NNMI_SOURCE_NODE_NAME） | ホスト名
システム致命的のイベント(NNMi) | 致命的 | システム致命的のイベント(NNMi)※ | イベントID（B.ID） | 00006100
イベント発生ノード名（E.NNMI_SOURCE_NODE_NAME） | ホスト名
システム警告のイベント(NNMi) | 警告 | システム警告のイベント(NNMi)※ | イベントID（B.ID） | 00006100
イベント発生ノード名（E.NNMI_SOURCE_NODE_NAME） | ホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.8.2　「ノード監視(NNMi)」システム監視オブジェクト

表4-28　システム監視オブジェクトの概要

項目
説明

監視ノード種別
ノード監視(NNMi)

目的
JP1/Cm2/NNMiが監視するノードの状態の監視

基本情報
ホスト名
JP1/Cm2/NNMiが監視しているノードのホスト名
（例）host01

表4-29　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
ネットワーク警戒のイベント(NNMi) | 警戒 | ネットワーク警戒のイベント(NNMi)※ | イベントID（B.ID） | 00006100
イベント発生ノード名（E.NNMI_SOURCE_NODE_NAME） | 基本情報のホスト名
ネットワーク致命的のイベント(NNMi) | 致命的 | ネットワーク致命的のイベント(NNMi)※ | イベントID（B.ID） | 00006100
イベント発生ノード名（E.NNMI_SOURCE_NODE_NAME） | 基本情報のホスト名
ネットワーク警告のイベント(NNMi) | 警告 | ネットワーク警告のイベント(NNMi)※ | イベントID（B.ID） | 00006100
イベント発生ノード名（E.NNMI_SOURCE_NODE_NAME） | 基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

4.9　JP1/Cm2/NNM用システム監視オブジェクト

バージョン8以前のJP1/Cm2/NNM用のシステム監視オブジェクトには，「NNM監視」と「ノード監視(NNM)」があります。

＜この節の構成＞

(1)　「NNM監視」システム監視オブジェクト

(2)　「ノード監視(NNM)」システム監視オブジェクト

(1)　「NNM監視」システム監視オブジェクト

表4-30　システム監視オブジェクトの概要

項目
説明

監視ノード種別
NNM監視

目的
バージョン8以前のJP1/Cm2/NNM自身の障害の監視

基本情報
ホスト名
バージョン8以前のJP1/Cm2/NNMがインストールされているマネージャーのホスト名
（例）host01

表4-31　状態変更条件

状態変更条件 | 共通条件※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」が入ります。

(2)　「ノード監視(NNM)」システム監視オブジェクト

表4-32　システム監視オブジェクトの概要

項目
説明

監視ノード種別
ノード監視(NNM)

目的
バージョン8以前のJP1/Cm2/NNMが監視するノードの状態の監視

基本情報
ホスト名
バージョン8以前のJP1/Cm2/NNMが監視しているノードのホスト名
（例）host01

表4-33　状態変更条件

状態変更条件 | 共通条件※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.10.1　「IM監視」システム監視オブジェクト

表4-34　システム監視オブジェクトの概要

項目
説明

監視ノード種別
IM監視

目的
JP1/IM - Manager自体の障害の監視

基本情報
ホスト名
JP1/IM - Managerがインストールされているマネージャーのホスト名
（例）host01

表4-35　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
システム警告のイベント(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.11.2　「J2EEアプリケーション監視(Cosminexus)」システム監視オブジェクト

4.11.1　「論理サーバ監視(Cosminexus)」システム監視オブジェクト

表4-36　システム監視オブジェクトの概要

項目
説明

監視ノード種別
論理サーバ監視(Cosminexus)

目的
サーバレベルの障害に関するJP1イベントの監視※

基本情報
ドメイン名
Cosminexusサーバのドメイン名
（例）DOM001

論理ホスト名
Cosminexusが監視対象としている論理ホスト名
（例）APSV001

注※　重大度が「Warning」以上のJP1イベントを監視します。

表4-37　状態変更条件

状態変更条件
共通条件※，個別条件

条件名
状態
条件
比較する値

論理サーバ緊急のイベント(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-38　システム監視オブジェクトの概要

項目
説明

監視ノード種別
J2EEアプリケーション監視(Cosminexus)

目的
アプリケーションレベルの障害に関するJP1イベントの監視※

基本情報
ドメイン名
Cosminexusサーバのドメイン名
（例）DOM001

論理ホスト名
Cosminexusが監視対象としている論理ホスト名
（例）APSV001

J2EEアプリケーション名
Cosminexusが監視対象としている論理ホスト上のJ2EEアプリケーション名
（例）API

注※　重大度が「Warning」以上のJP1イベントを監視します。

表4-39　状態変更条件

状態変更条件
共通条件※，個別条件

条件名
状態
条件
比較する値

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監視」があります。

なお，HiRDB用システム監視オブジェクトを監視する場合，次の設定をする必要があります。

HiRDBに関する事象を管理するには，HiRDBが管理する障害情報をJP1イベントとして発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

＜この節の構成＞

4.12.1　「HiRDB監視」システム監視オブジェクト

4.12.1　「HiRDB監視」システム監視オブジェクト

表4-40　システム監視オブジェクトの概要

項目
説明

監視ノード種別
HiRDB監視

目的
HiRDB自身の障害監視

基本情報
ホスト名
HiRDBがインストールされているホストのホスト名
（例）host02

HiRDB識別子
HiRDBを識別するための識別子
（例）PDB1

表4-41　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
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）」があります。

なお，JP1/ServerConductor用システム監視オブジェクトを監視する場合，次の設定をする必要があります。

JP1/ServerConductorが管理する物理ホストに関する事象を管理するには，JP1/ServerConductorのマネージャーサービスが検知したアラートをJP1イベントとして発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

＜この節の構成＞

4.13.1　「物理ホスト監視（System Manager）」システム監視オブジェクト

4.13.1　「物理ホスト監視（System Manager）」システム監視オブジェクト

表4-42　システム監視オブジェクトの概要

項目
説明

監視ノード種別
物理ホスト監視（System Manager）

目的
JP1/ServerConductorが管理する物理ホストに関する障害監視

基本情報
ホスト名
System Managerが管理する物理ホスト名
（例）host02

表4-43　状態変更条件

状態変更条件 | 共通条件※，個別条件
条件名 | 状態 | 条件 | 比較する値
物理ホスト緊急のイベント | 緊急 | 物理ホスト緊急のイベント※ | プロダクト名（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.3　「システム構成ツリー」の監視ツリーモデル

5.1　「業務指向ツリー」の監視ツリーモデル

監視ツリーを自動生成するときに，「業務指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデルを次に示します。

図5-1　監視ツリー（業務指向ツリー）のモデル

図5-2　監視ツリー（業務指向ツリー）のモデル

5.2　「サーバ指向ツリー」の監視ツリーモデル

監視ツリーを自動生成するときに，「サーバ指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデルを次に示します。

図5-3　監視ツリー（サーバ指向ツリー）のモデル

図5-4　監視ツリー（サーバ指向ツリー）のモデル

5.3　「システム構成ツリー」の監視ツリーモデル

監視ツリーを自動生成するときに，「システム構成ツリー」テンプレートを選択した場合に生成される監視ツリーのモデルを次に示します。

図5-5　監視ツリー（システム構成ツリー）のモデル

システム構成ツリーの構成は，JP1/IM - Central Information Masterのシステムツリーの構成に依存します。なお，JP1/IM - Central Information Masterのシステムツリーから監視ツリー（システム構成ツリー）を生成する際には，JP1イベントを発行しないプロセスや発行するJP1イベントが不明なプロセスの監視オブジェクトは生成されません。

また，JP1/IM - Central Information Masterのシステムツリーで定義が完了していない個所があった場合，その個所も生成されません。例えば，JP1/IM - Central Information Master側で仮想ホストだけ定義して，物理ホストとのマッピングをしていなかった場合，監視グループとなる個所（仮想ホスト＜仮想ホスト名＞）も含めて生成されません。

JP1/IM - Central Information Master連携時に生成するシステム監視オブジェクトを次に示します。

表5-1　JP1/IM - Central Information Master連携時に生成するシステム監視オブジェクト

JP1/IM - Central Information Master側の定義 | JP1/IM - Central Scope側の定義
ノード名 | 種別 | 生成するシステム監視オブジェクト
プロセス | Cosminexus※1 | web-server | ＜プロセス名＞監視(Cosminexus)
j2ee-server | ＜プロセス名＞監視(Cosminexus)
naming-service | ＜プロセス名＞監視(Cosminexus)
smart-agent | ＜プロセス名＞監視(Cosminexus)
performance-tracer | ＜プロセス名＞監視(Cosminexus)
transaction-context-service | ＜プロセス名＞監視(Cosminexus)
component-transaction-monitor | ＜プロセス名＞監視(Cosminexus)
HiRDB | FES | －
BES | －
MGR | ＜プロセス名＞監視(HiRDB)
DS | －
SDS | ＜プロセス名＞監視(HiRDB)
others | others | －
物理ホスト※2 | － | ＜物理ホスト名＞監視(System Manager)

（凡例）

－：該当なし，または作成されない。

注※1　JP1/IM - Central Information Masterが作成するシステムツリーではOTSを管理しないため，OTS監視用の監視オブジェクトは生成されません（業務指向ツリー，サーバ指向ツリーの場合は生成されます）。

注※2　BladeSymphonyの物理ホストにOSがインストールされていない場合，ホスト名が特定できないため，監視できないことがあります。その場合，OSをインストールし，ホスト名が確定したあとで自動生成を再実行するか，手動でシステム監視オブジェクトを追加する必要があります。

索引

[記号]
[Ａ][Ｃ][Ｄ][Ｅ][Ｈ][Ｉ][Ｊ][Ｐ][Ｓ][Ｔ][Ｕ][Ｖ][Ｗ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(記号)

.system（システムプロファイル）

!JP1_CS_APP0.conf（起動プログラム定義ファイル）

!JP1_CS_FTOOL0.conf（ツールバー定義ファイル）

!JP1_CS_FTREE0.conf（アイコン動作定義ファイル）

(英字)

(Ａ)

actdef.conf（自動アクション定義ファイル）

actdef.conf（自動アクション定義ファイル）（互換用）

action.conf.update（自動アクション環境定義ファイル）

action_complete_xxx.conf（対処済み連動設定ファイル）

actnotice.conf（自動アクション通知定義ファイル）

attr_list.conf（イベント条件表示項目定義ファイル）

auto_dbbackup_xxx.conf（監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル）

(Ｃ)

CMホスト定義ファイル（jcs_atc_cm_host.conf）

common_exclude_filter_attr_list.conf（共通除外条件表示項目定義ファイル）

console.conf.update（通信環境定義ファイル）

console_ja.html（WWWページ版動作定義ファイル）

(Ｄ)

defaultUser（ユーザープロファイル）

(Ｅ)

eds_system.conf（インシデント登録用システムプロファイル）

egs_system.conf（相関イベント発行システムプロファイル）

event_info_replace.conf（イベント引き継ぎ情報変換設定ファイル）

evhist_warn_event_xxx.conf（状態変更イベント件数の上限監視設定ファイル）

(Ｈ)

hitachi_jp1_製品名.html（WWWページ呼び出し定義ファイル）

(Ｉ)

IM-View設定ファイル（tuning.conf）

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

IMパラメーター定義ファイル（jp1co_param_V7.conf）

incident.conf（インシデント手動登録定義ファイル）

(Ｊ)

jbs_route.conf（構成定義ファイル）

jcacancel

jcachange

jcadefconv

jcamakea

jcashowa

jcastatus

jcdmain.conf.update（インシデント登録環境定義ファイル）

jcfaleltdef（Windows限定）

jcfaleltreload（Windows限定）

jcfaleltstart（Windows限定）

jcfaleltstat（Windows限定）

jcfaleltstop（Windows限定）

jcfallogdef

jcfallogreload

jcfallogstart

jcfallogstat

jcfallogstop

jcfcolvmesx

jcfcolvmscvmm（Windows限定）

jcfcolvmvc

jcfcolvmvirtage

jcfdbsetup

jcfdbunsetup

jcfexport

jcfimport

jcfmkcsdata

jcfmkhostsdata

jcfthreaddmp（Windows限定）

jcfview.conf（IM構成管理・ビューアー動作定義ファイル）

jcfview（Windows限定）

jcfvirtualchstat

jco_guide.txt（イベントガイド情報ファイル）

jco_killall.cluster（UNIX限定）

jco_spmd_reload

jco_spmd_status

jco_start.cluster（UNIX限定）

jco_start（UNIX限定）

jco_stop.cluster（UNIX限定）

jco_stop（UNIX限定）

jcoappexecfcheck

jcoattrfcheck

jcochafmode

jcochcefmode

jcochdisc

jcochfilter

jcochstat

jcodbsetup

jcodbunsetup

jcoedsstatus

jcoegschange

jcoegscheck

jcoegsstart

jcoegsstatus

jcoegsstop

jcoevtreport

jcofuncfcheck

jcogencore

jcohc.conf（ヘルスチェック定義ファイル）

jcohctest

jcoimdef

jcomonitorfcheck

jcothreaddmp（Windows限定）

jcovcfsetup（Windows限定）

jcoview_log.bat（Windows限定）

jcoview（Windows限定）

jcs_atc_cm_host.conf（CMホスト定義ファイル）

jcs_guide_xxx.txt（ガイド情報ファイル）

jcs_hosts（ホスト情報ファイル）

jcschstat

jcsdbexport

jcsdbimport

jcsdbsetup

jcshostsexport

jcshostsimport

jim_log.bat（Windows限定）

jim_log.sh（UNIX限定）

jimdbbackup

jimdbclustersetupinfo.conf（クラスタセットアップ情報ファイル）

jimdbreclaim

jimdbrecovery

jimdbrorg

jimdbsetupinfo.conf（セットアップ情報ファイル）

jimdbstatus

jimdbstop

jimdbupdate

JP1/AJS用システム監視オブジェクト

JP1/Cm2/NNMi用システム監視オブジェクト

JP1/Cm2/NNM用システム監視オブジェクト

JP1/Cm2/SSO用システム監視オブジェクト

JP1/IMが出力するJP1イベント

jp1cc_setup_cluster（UNIX限定）

jp1cc_setup（UNIX限定）

jp1cf_applyconfig.conf（IM構成反映方式設定ファイル）

jp1cf_setup_cluster（UNIX限定）

jp1cf_setup（UNIX限定）

jp1cfhasetup（Windows限定）

jp1co_param_V7.conf（IMパラメーター定義ファイル）

jp1co_service.conf（拡張起動プロセス定義ファイル）

jp1cohasetup（Windows限定）

jp1cohaverup

jp1cs_setup_cluster（UNIX限定）

jp1cs_setup（UNIX限定）

jp1cshasetup（Windows限定）

jp1cshaverup.bat（Windows限定）

jp1cshaverup（UNIX限定）

jp1csverup.bat（Windows限定）

jp1csverup（UNIX限定）

JP1イベント

一覧

詳細

属性

(Ｐ)

processupdate.conf（対処状況イベント定義ファイル）

profile_ユーザー名（ユーザープロファイル）

(Ｓ)

SpmSetSvcCon（Windows限定）

systemColor.conf（システムカラー定義ファイル）

(Ｔ)

tree_view.conf.update（通信環境定義ファイル）

tuning.conf（IM-View設定ファイル）

(Ｕ)

user_hostmap.conf（発生元ホストマッピング定義ファイル）

(Ｖ)

view.conf.update（通信環境定義ファイル）

(Ｗ)

WWWページ版動作定義ファイル（console_ja.html）

WWWページ版のJP1/IM - Viewの資料採取

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

(ア行)

(あ)

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）

アクション情報ファイルの容量を小さくする場合

アプリケーション実行定義ファイル

チェックする

置換文字列

(い)

一次資料

JP1/IM - Manager用（UNIX）

JP1/IM - View，JP1/IM - Manager用（Windows）

イベントID

00002010の詳細

00002011の詳細

00002012の詳細

00002013の詳細

00002014の詳細

00002015の詳細

00002016の詳細

00002020の詳細

00002021の詳細

000020A0の詳細

000020A1の詳細

000020A2の詳細

000020A3の詳細

000020A4の詳細

000020A5の詳細

000020A6の詳細

000020E0の詳細

000020E1の詳細

000020E2の詳細

000020E3の詳細

000020E4の詳細

000020E5の詳細

000020E6の詳細

000020E7の詳細

000020E8の詳細

00003A71の詳細

00003F01の詳細

00003F03の詳細

00003F04の詳細

00003F05の詳細

00003F06の詳細

00003F07の詳細

00003F08の詳細

00003F11の詳細

00003F13の詳細

00003F14の詳細

00003F15の詳細

00003F16の詳細

00003F20の詳細

00003F21の詳細

00003F22の詳細

00003F23の詳細

00003F24の詳細

00003F25の詳細

00003F25の詳細

00003F26の詳細

00003F28の詳細

00003F30の詳細

00003F41の詳細

00003F42の詳細

00003F51の詳細

00003F52の詳細

00003F53の詳細

00003F54の詳細

00003F61の詳細

00003F62の詳細

00003F63の詳細

00003F64の詳細

00003F66の詳細

00003F67の詳細

00003F68の詳細

00003F69の詳細

00003F90の詳細

00003F91の詳細

00003F92の詳細

00003FB0の詳細

00003FB1の詳細

00003FC0の詳細

00003FC1の詳細

00003FC2の詳細

00003FC3の詳細

00003FC5の詳細

00003FD0の詳細

00003FD1の詳細

00003FD2の詳細

00003FD3の詳細

00003FD4の詳細

00003FD5の詳細

ACTDEFパラメーターに指定されている値

相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントIDの詳細

相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントIDの詳細

イベントガイド情報ファイル（jco_guide.txt）

イベント拡張属性定義ファイル

チェックする

イベント監視条件の優先度

イベント条件表示項目定義ファイル（attr_list.conf）

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

イベントレポート出力の項目ファイル

イベントレポート出力のフィルターファイル

インシデント手動登録定義ファイル（incident.conf）

インシデント登録環境定義ファイル（jcdmain.conf.update）

インシデント登録用システムプロファイル（eds_system.conf）

(お)

オブジェクトタイプ定義ファイル

(カ行)

(か)

ガイド情報ファイル（jcs_guide_xxx.txt）

ガイドメッセージファイル

拡張起動プロセス定義ファイル（jp1co_service.conf）

拡張属性

環境変数ファイル

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）

監視オブジェクト初期化設定ファイル

監視ツリーモデル

業務指向ツリー

サーバ指向ツリー

システム構成ツリー

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

(き)

キーワード置換文字列

起動オプションの注意事項

起動プログラム定義ファイル（!JP1_CS_APP0.conf）

基本属性

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

共通除外条件拡張定義ファイル

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

「業務指向ツリー」の監視ツリーモデル

(く)

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

(こ)

構成定義ファイル（jbs_route.conf）

コマンド

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

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

IMデータベース

jcacancel

jcachange

jcadefconv

jcamakea

jcashowa

jcastatus

jcfaleltdef（Windows限定）

jcfaleltreload（Windows限定）

jcfaleltstart（Windows限定）

jcfaleltstat（Windows限定）

jcfaleltstop（Windows限定）

jcfallogdef

jcfallogreload

jcfallogstart

jcfallogstat

jcfallogstop

jcfcolvmesx

jcfcolvmscvmm（Windows限定）

jcfcolvmvc

jcfcolvmvirtage

jcfdbsetup

jcfdbunsetup

jcfexport

jcfimport

jcfmkcsdata

jcfmkhostsdata

jcfthreaddmp（Windows限定）

jcfview（Windows限定）

jcfvirtualchstat

jco_killall.cluster（UNIX限定）

jco_spmd_reload

jco_spmd_status

jco_start.cluster（UNIX限定）

jco_start（UNIX限定）

jco_stop.cluster（UNIX限定）

jco_stop（UNIX限定）

jcoappexecfcheck

jcoattrfcheck

jcochafmode

jcochcefmode

jcochdisc

jcochfilter

jcochstat

jcodbsetup

jcodbunsetup

jcoedsstatus

jcoegschange

jcoegscheck

jcoegsstart

jcoegsstatus

jcoegsstop

jcoevtreport

jcofuncfcheck

jcogencore

jcohctest

jcoimdef

jcomonitorfcheck

jcothreaddmp（Windows限定）

jcovcfsetup（Windows限定）

jcoview_log.bat（Windows限定）

jcoview（Windows限定）

jcschstat

jcsdbexport

jcsdbimport

jcsdbsetup

jcshostsexport

jcshostsimport

jim_log.bat（Windows限定）

jim_log.sh（UNIX限定）

jimdbbackup

jimdbreclaim

jimdbrecovery

jimdbrorg

jimdbstatus

jimdbstop

jimdbupdate

JP1/IM - Incident Master連携

JP1/IM - Managerの機能拡張

jp1cc_setup_cluster（UNIX限定）

jp1cc_setup（UNIX限定）

jp1cf_setup_cluster（UNIX限定）

jp1cf_setup（UNIX限定）

jp1cfhasetup（Windows限定）

jp1cohasetup（Windows限定）

jp1cohaverup

jp1cs_setup_cluster（UNIX限定）

jp1cs_setup（UNIX限定）

jp1cshasetup（Windows限定）

jp1cshaverup.bat（Windows限定）

jp1cshaverup（UNIX限定）

jp1csverup.bat（Windows限定）

jp1csverup（UNIX限定）

SpmSetSvcCon（Windows限定）

一覧

イベント

監視オブジェクトDBの情報の移行

監視ノードの状態変更

起動・終了，セットアップ

構成定義

自動アクションおよびコマンド実行

セントラルスコープの環境設定

相関イベントの発行

トラブルシューティング

バージョンアップ

フィルター

ログイン・ログアウト

コマンドの記述形式

コマンドボタン定義ファイル（cmdbtn.conf）

(サ行)

(さ)

「サーバ指向ツリー」の監視ツリーモデル

(し)

システムカラー定義ファイル（systemColor.conf）

システム監視オブジェクト

Cosminexus用

HiRDB用

JP1/IM - Manager用

JP1/NETM/DM用

JP1/PAM用

JP1/PFM用

JP1/SCIM用システム監視オブジェクト

JP1/ServerConductor用

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

システム監視オブジェクト対応製品一覧

「システム構成ツリー」の監視ツリーモデル

システムプロファイル（.system）

指定内容の確認

自動アクション環境定義ファイル（action.conf.update）

自動アクション通知定義ファイル（actnotice.conf）

自動アクション定義パラメーターのサイズチェック

自動アクション定義ファイル（actdef.conf）

自動アクション定義ファイル（actdef.conf）（互換用）

自動アクション定義ファイル（互換用）

イベント監視条件の優先度

指定内容の確認

自動アクション定義パラメーターのサイズチェック

定義の記述

パラメーターグループとAND条件

重大度変更定義ファイル

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）

状態変更イベント自動削除設定ファイル

状態変更条件メモリー常駐機能の設定ファイル

(す)

ステートメント

構成要素の生成規則

構造

種類

詳細

(せ)

正規表現

正規表現に関する注意事項

セットアップ情報ファイル（jimdbsetupinfo.conf）

(そ)

相関イベント発行環境定義ファイル

相関イベント発行機能の状態

起動処理中

機能停止

相関稼働

停止

停止処理中

相関イベント発行システムプロファイル（egs_system.conf）

相関イベント発行定義ファイル

(タ行)

(た)

対処状況イベント定義ファイル（processupdate.conf）

対処済み連動設定ファイル（action_complete_xxx.conf）

(ち)

置換文字列

キーワード置換文字列

レジストリー置換文字列

(つ)

通信環境定義ファイル（console.conf.update）

通信環境定義ファイル（tree_view.conf.update）

通信環境定義ファイル（view.conf.update）

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）

ツリー構成ファイル

(て)

定義の記述

定義ファイル

CMホスト定義ファイル（jcs_atc_cm_host.conf）

IM-View設定ファイル（tuning.conf）

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

IMパラメーター定義ファイル（jp1co_param_V7.conf）

WWWページ版動作定義ファイル（console_ja.html）

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）

アプリケーション実行定義ファイル

一覧

イベントガイド情報ファイル（jco_guide.txt）

イベント条件表示項目定義ファイル（attr_list.conf）

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

インシデント手動登録定義ファイル（incident.conf）

インシデント登録環境定義ファイル（jcdmain.conf.update）

インシデント登録用システムプロファイル（eds_system.conf）

オブジェクトタイプ定義ファイル

ガイド情報ファイル（jcs_guide_xxx.txt）

概要

拡張起動プロセス定義ファイル（jp1co_service.conf）

格納先

環境変数ファイル

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）

監視オブジェクト初期化設定ファイル

起動プログラム定義ファイル（!JP1_CS_APP0.conf）

共通除外条件拡張定義ファイル

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

構成定義ファイル（jbs_route.conf）

構成要素

構造

コマンドボタン定義ファイル（cmdbtn.conf）

システムカラー定義ファイル（systemColor.conf）

システムプロファイル（.system）

自動アクション環境定義ファイル（action.conf.update）

自動アクション通知定義ファイル（actnotice.conf）

自動アクション定義ファイル（actdef.conf）

自動アクション定義ファイル（actdef.conf）（互換用）

重大度変更定義ファイル

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）

状態変更イベント自動削除設定ファイル

状態変更条件メモリー常駐機能の設定ファイル

セットアップ情報ファイル（jimdbsetupinfo.conf）

相関イベント発行環境定義ファイル

相関イベント発行システムプロファイル（egs_system.conf）

相関イベント発行定義ファイル

対処状況イベント定義ファイル（processupdate.conf）

対処済み連動設定ファイル（action_complete_xxx.conf）

通信環境定義ファイル（console.conf.update）

通信環境定義ファイル（tree_view.conf.update）

通信環境定義ファイル（view.conf.update）

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）

ツリー構成ファイル

統合機能メニュー定義ファイル

発生元ホストマッピング定義ファイル（user_hostmap.conf）

ヘルスチェック定義ファイル（jcohc.conf）

ホストグループ定義ファイル

ホスト情報ファイル（jcs_hosts）

命名規則

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

ユーザープロファイル（defaultUser | profile_ユーザー名）

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

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

定義ファイルの記述形式

(と)

統合機能メニュー定義ファイル

チェックする

(ナ行)

(に)

二次資料

JP1/IM - Manager用（UNIX）

JP1/IM - View，JP1/IM - Manager用（Windows）

(ハ行)

(は)

発生元ホストマッピング定義ファイル（user_hostmap.conf）

パラメーターグループとAND条件

(へ)

ヘルスチェック定義ファイル（jcohc.conf）

(ほ)

ホストグループ定義ファイル

ホスト情報ファイル（jcs_hosts）

(マ行)

(も)

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

チェックする

(ヤ行)

(ゆ)

ユーザープロファイル（defaultUser | profile_ユーザー名）

(ラ行)

(り)

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

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

(れ)

レジストリー置換文字列

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
BSAFEは，EMC Corporationの米国およびその他の国における登録商標または商標です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
J2EEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDBCは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
MicrosoftおよびHyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corporationの商品名称です。
NetInsightは，株式会社日立ソリューションズの登録商標です。
Netscapeは，米国およびその他の国におけるNetscape Communications Corporationの登録商標です。
POSIXは，the Institute of Electrical and Electronics Engineers, Inc. (IEEE)で制定された標準仕様です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
RSAは，EMC Corporationの米国およびその他の国における登録商標または商標です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Sunは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Sun Microsystemsは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
TELstaffは，株式会社日立ソリューションズの登録商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
VMwareおよびESXは，VMware, Inc.の米国および各国での登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
プログラムプロダクト「P-9D2C-8E91」には，Oracle Corporationまたはその子会社，関連会社が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-8E91」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。
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.
This product includes software developed by IAIK of Graz University of Technology.
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/).

本製品は，EMC CorporationのRSA(R) BSAFETMソフトウェアを搭載しています。