JP1 Version 8

JP1/Integrated Management - Manager 機能拡張

解説・手引・文法書

3020-3-K03-81

目　　次

前書き

変更内容

はじめに

第1編　概要

1.　機能拡張の概要

1.1　特長

第2編　運用

2.　ユーザー独自のイベント属性を表示する

2.1　機能の解説

2.2　ユーザー独自のイベント属性を表示する手順

2.2.1　定義ファイルを作成する

2.2.2　定義ファイルを有効にする

3.　JP1/IM - Viewに表示されたJP1イベントからアプリケーションを起動する

3.1　機能の解説

3.1.1　前提条件

3.2　モニター画面を呼び出す手順

3.2.1　モニター画面呼び出しをするための画面を決める

3.2.2　定義ファイルを作成する

3.2.3　定義ファイルを有効にする

4.　［統合機能メニュー］画面に新規メニューを追加する

4.1　機能の解説

4.1.1　前提条件

4.2　新規メニューを追加する手順

4.2.1　［統合機能メニュー］画面から起動する画面を決める

4.2.2　定義ファイルを作成する

4.2.3　定義ファイルを有効にする

第3編　リファレンス

5.　定義ファイル

5.1　定義ファイル一覧

5.1.1　定義ファイルの関連

5.1.2　定義ファイルの命名規則

5.1.3　定義ファイルの格納先

5.1.4　定義ファイルが有効になる契機

5.1.5　モデルファイル

5.2　定義ファイルの構造

5.2.1　定義ファイルの構成要素

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

5.3.1　ファイル内ステートメントの生成規則

5.3.2　イベント拡張属性定義ファイルのブロックの生成規則

5.3.3　イベント拡張属性定義ブロック内のステートメント生成規則

5.3.4　属性グループ定義ブロック内のステートメント生成規則

5.3.5　属性表示順序定義ブロック内のステートメント生成規則

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

5.3.7　標準提供されているイベント拡張属性定義ファイル

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

5.4.1　形式

5.4.2　注意事項

5.4.3　定義例

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

5.5.1　ファイル内ステートメントの生成規則

5.5.2　アプリケーション実行定義ファイルのブロックの生成規則

5.5.3　アプリケーション実行定義ブロック内のステートメント生成規則

5.5.4　置換文字列

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

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

5.6.1　形式

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

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

5.7.1　ファイル内ステートメントの生成規則

5.7.2　統合機能メニュー定義ファイルのブロック

5.7.3　機能ツリーメニュー定義ブロック内のステートメント生成規則

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

6.　コマンド

コマンドの記述形式

コマンド一覧

jcoappexecfcheck

jcoattrfcheck

jcofuncfcheck

jcomonitorfcheck

付録

付録A　JP1イベントの属性の設定基準

付録A.1　基本属性

付録A.2　拡張属性

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

付録B.1　ステートメントの種類

付録B.2　ステートメントの構造

付録B.3　ステートメント内の構成要素の生成規則

付録C　（3020-3-K03-81）の変更内容

索引

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

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

前書き

■ 対象製品

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

適用OS：Windows Server 2003，Windows XP Professional

P-242C-6H84　 JP1/Integrated Management - View　 08-50

適用OS：Windows Vista，Windows Server 2008

P-2A2C-6H84　 JP1/Integrated Management - View　 08-50※

適用OS：Windows Server 2003

P-242C-8E84　 JP1/Integrated Management - Manager　 08-50
P-242C-6L84　 JP1/Base　 08-50

適用OS：Windows Server 2008

P-2A2C-8E84　 JP1/Integrated Management - Manager　 08-50
P-2A2C-6L84　 JP1/Base　 08-50

適用OS：HP-UX

P-1B2C-8E81　 JP1/Integrated Management - Manager　 08-50
P-1B2C-6L81　 JP1/Base　 08-50

適用OS：Solaris

P-9D2C-8E81　 JP1/Integrated Management - Manager　 08-50
P-9D2C-6L81　 JP1/Base　 08-50

適用OS：AIX 5L 5.2，5L 5.3

P-1M2C-8E81　 JP1/Integrated Management - Manager　 08-50
P-1M2C-6L81　 JP1/Base　 08-50

適用OS：AIX 6.1

P-1M2C-9E81　 JP1/Integrated Management - Manager　 08-50
P-1M2C-6L81　 JP1/Base　 08-50

適用OS：Windows Server 2003(IPF)

P-282C-8E84　 JP1/Integrated Management - Manager　 08-50
P-282C-6L84　 JP1/Base　 08-50

適用OS：HP-UX(IPF)

P-1J2C-8E81　 JP1/Integrated Management - Manager　 08-50
P-1J2C-6L81　 JP1/Base　 08-50

適用OS：Linux AS 4（x86），Linux ES 4（x86），Linux AS 4（AMD64 & Intel EM64T），Linux ES 4（AMD64 & Intel EM64T）

P-9S2C-8E81　 JP1/Integrated Management - Manager　 08-50
P-9S2C-7L81　 JP1/Base　 08-50

適用OS：Linux 5（x86），Linux 5 AP（x86），Linux 5（AMD64 & Intel EM64T），Linux 5 AP（AMD64 & Intel EM64T）

P-9S2C-9E81　 JP1/Integrated Management - Manager　 08-50
P-9S2C-7L81　 JP1/Base　 08-50

適用OS：Linux AS 4（IPF）

P-9V2C-8E81　 JP1/Integrated Management - Manager　 08-50
P-9V2C-6L81　 JP1/Base　 08-50

適用OS：Linux 5（IPF），Linux 5 AP（IPF）

P-9V2C-9E81　 JP1/Integrated Management - Manager　 08-50
P-9V2C-6L81　 JP1/Base　 08-50

注※　Windows Server 2008は，P-2A2C-6H84 JP1/Integrated Management - View 08-50-05以降でサポートしています。

■ 輸出時の注意

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

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
BSAFEは，RSA Security Inc.の米国およびその他の国における登録商標です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
NetInsightは，日立ソフトウェアエンジニアリング株式会社の商標です。
Netscapeは，米国およびその他の国におけるNetscape Communications Corporationの登録商標です。
OpenViewは，ヒューレット・パッカード社の商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
POSIXは，the Institute of Electrical and Electronics Engineers, Inc. (IEEE)で制定された標準仕様です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
RSAは，RSA Security Inc.の登録商標です。
Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
TELstaffは，日立ソフトウェアエンジニアリング株式会社の登録商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
XPG4は，X/Open Company Limitedの規格名称です。
プログラムプロダクト「P-9D2C-8E81」「P-9D2C-6L81」には，米国Sun Microsystems, Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-8E81」「P-9D2C-6L81」には，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/).

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

■ ビジュアル監視画面背景として添付している日本地図データの著作権等についてのご注意

この地図の作成に当たっては，国土地理院の承認を得て，同院発行の数値地図25000（行政界・海岸線）を使用したものです。（承認番号 平15総使，第88号）
国土地理院の承認は，統合システム運用管理プログラム（JP1）（以下「本製品」という。）における使用に限られています。この地図の画像を本製品とは別に利用すること等この地図を本製品以外に利用することを禁じます。
また，地図を含む本製品は，著作権法により保護されています。
地図を翻案・改変等著作権を侵害する行為を行なうことを禁じます。
地図著作・制作者 株式会社 日立製作所 ソフトウェア事業部
All Rights Reserved. Copyright (C) 2003, Hitachi, Ltd.

■ 発行

2006年 6月 （第1.1版） 3020-3-K03-01
2008年 12月 （第5.1版） 3020-3-K03-81

■ 著作権

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

変更内容

変更内容(3020-3-K03-81) JP1/Integrated Management 08-50

追加・変更内容 | 変更個所
記載内容を変更した。詳細は，付録Cを参照のこと。 | 付録C

変更内容(3020-3-K01-80，3020-3-K02-80，3020-3-K03-80) JP1/Integrated Management 08-50

追加・変更内容
変更個所

システム構築・運用ガイド
リファレンス
機能拡張

JP1/Integrated Managementが連携できる統合管理製品にJP1/Integrated Management - Service Supportを追加した。
1.1.1，1.1.2
－
－

JP1/Baseの前提OSからWindows 2000を削除した。
3.1.2
－
－

イベント取得フィルターに，メンテナンス対象ホストが発行するJP1イベントを一時的に取得対象外とするための共通除外条件を追加した。
3.2.2，6.1.3，7.10.1，7.10.2，7.10.3，11.2.4，20.6，24.5，付録D，付録H，付録I.3，付録L
1.1，1.3.9，1.3.12，1.3.13，2. jcochfilter
－

次のフィルター，およびイベント検索の条件に，JP1イベントを表示（取得）対象外とするための除外条件を追加した。

イベント取得フィルター

ユーザーフィルター

重要イベントフィルター

表示フィルター

3.2.2，6.1.3，11.2.1，11.2.2，11.2.3，11.2.4，20.3.1，24.5，付録D，付録H，付録I.3，付録L
1.3.8，1.3.9，1.3.10，1.3.12，1.3.15，1.3.18，1.3.21
－

監視オブジェクトの状態変更条件をメモリーに常駐させる機能を追加した。
3.3.2，12.7.5，13.2.4，13.3.4，16.1.1，16.1.3
3. 状態変更条件メモリー常駐機能の設定ファイル
－

JP1イベントの受信時に，監視オブジェクトを自動で初期化する機能を追加した。
3.3.6，12.7.4，13.2.4，13.3.4，16.1.1，16.1.3
3. 監視オブジェクト初期化設定ファイル
－

JP1イベントの対処済み時に状態変更イベントを自動で削除する機能を追加した。
3.3.8，12.7.3，13.2.4，13.3.4，16.1.1，16.1.3
3. 状態変更イベント自動削除設定ファイル
－

イベントサービスの登録ホスト名をFQDN形式で利用する場合の設定方法を変更した。
9.4.9，10.4.8
－
－

uCosminexus Batch Job Execution Serverが発行する応答待ちイベントを監視し，応答する機能を追加した。
9.4.9，10.4.8，23，24.2.4，24.3.1，24.3.2，24.5，付録E.1，付録H.1，付録H.2，付録H.3，付録L
1.3，1.3.5，1.3.6，1.3.7，1.3.8，1.3.14，1.3.15，1.3.18，1.3.21，2. jcoimdef，2. jim_log.bat（Windows限定），2. jim_log.sh（UNIX限定），3. 通信環境定義ファイル（view.conf.update），4.2.2
－

JP1/Cm2/SNMP System Observerとの連携でのセットアップの注意事項を変更した。
12.8.2，12.8.4
－
－

ログファイルおよびディレクトリ一覧に次のファイルを追加した。

インストールログ

イベントコンソールログ

応答待ちイベント滞留ファイル

プラグインのログ

24.2.4
－
－

イベントフロー制御トレースログのファイル数，最大ディスク使用量，およびファイルの切り替え時期を変更した。
24.2.4
－
－

アクションホスト名格納ファイルの最大ディスク使用量を変更した。
24.2.4
－
－

イベント取得フィルターの最大長を変更した。
付録D
1.3.10，1.3.13
－

セントラルスコープサービスが起動していない場合は，［イベントコンソール］画面にある［セントラルスコープ］起動ボタンおよびメニューが非活性となるようにした。
－
1.3，2. jcoimdef，5.5.1
－

［コマンド実行］画面で指定する「実行ホスト名」および「実行コマンド」が保存される件数を追加した。
－
1.3.30
－

［監視ツリー］画面の表示項目の説明にタイトルバーを追加した。
－
1.4
－

このマニュアルで説明しているJP1/Baseのコマンドは，マネージャーホストを対象としているため，エージェントホストを対象に実行するJP1/BaseのコマンドについてはJP1/Baseのマニュアルを参照する注釈を追加した。
－
2. コマンド一覧
－

jcocmddefコマンドの実行権限をスーパーユーザーに変更した。
－
2. コマンド一覧，2. jcocmddef
－

jcocmddefコマンドを実行したときに出力されるメッセージの記述を追加した。
－
2. jcocmddef
－

jcocmddefコマンドの-runevintervalオプション（経過時間イベント発行間隔）に指定できる値を変更した。
－
2. jcocmddef
－

Linux版でjp1cohaverupコマンドをサポートした。
－
2. jp1cohaverup
－

次のイベントIDのJP1イベントの発行契機を変更した。

3F11

－
4.2.1
－

次のイベントIDのJP1イベントを追加した。

3F08

3F41

3F42

－
4.2.1，4.2.2
－

次のイベントIDの到着時刻の属性名を変更した。

3F01

3F03

3F04

3F05

3F06

－
4.2.2
－

次のイベントIDのプロダクト名の内容を変更した。

3FA0

－
4.2.2
－

メッセージの出力先にイベントログの列を追加した。
－
5.2.1
－

次のメッセージの出力先を変更した。
KAVB0001-E，KAVB0251-E，KAVB0292-I，KAVB0293-I，KAVB0401-E，KAVB0411-E，KAVB0801-E，KAVB0802-E，KAVB0803-E，KAVB0804-E，KAVB0805-E，KAVB0806-E，KAVB0810-E，KAVB0821-E，KAVB0822-E，KAVB0823-E，KAVB0824-E，KAVB0825-E，KAVB0826-E，KAVB0827-E，KAVB0828-E，KAVB1211-W，KAVB1501-E，KAVB1502-E，KAVB1510-E，KAVB1515-E，KAVB1523-E，KAVB1524-E，KAVB1525-E，KAVB2288-E，KAVB3625-E，KAVB3642-E，KAVB3899-E，KAVB4004-E，KAVB4022-E，KAVB4420-W，KAVB4421-W，KAVB4422-W，KAVB4423-W，KAVB4424-W，KAVB4905-E，KAVB5106-E，KAJV2234-I
－
5.2.1，5.2.2，5.2.4，5.2.5，5.2.11
－

次のメッセージを追加した。
KAVB0251-E，KAVB0551-E，KAVB0552-I，KAVB0553-Q，KAVB0554-E，KAVB0555-E，KAVB0556-I，KAVB0557-E，KAVB0558-E，KAVB0559-Q，KAVB0560-E，KAVB0561-E，KAVB0562-E，KAVB0563-E，KAVB0863-E，KAVB0864-I，KAVB0866-E，KAVB0868-I，KAVB0869-I，KAVB0870-E，KAVB0871-E，KAVB0872-E，KAVB1583-W，KAVB1584-W，KAVB1801-E，KAVB1802-W，KAVB1811-E，KAVB1812-E，KAVB1813-E，KAVB1814-E，KAVB1815-E，KAVB1816-W，KAVB1821-E，KAVB9201-I，KAVB9202-E
－
5.2.1，5.2.9，5.5.1，5.5.9
－

次のメッセージを削除した。
KAVB3792-E
－
5.2.4，5.4，5.5.4
－

JP1/Integrated Managementが出力するWindowsイベントログの一覧にソース名を追加した。
－
5.4
－

次のメッセージの説明を変更した。
KAVB0121-E，KAVB0246-E，KAVB0248-E，KAVB1210-E，KAVB1582-E，KAVB1652-E，KAVB1658-I，KAVB8101-E，KAVB8102-E，KAVB8103-E
－
5.5.1，5.5.8
－

次のメッセージを変更した。
KAVB0221-E，KAVB0223-E，KAVB0227-W，KAVB0228-E，KAVB0255-E，KAVB0810-E，KAVB0828-E，KAVB1516-W，KAVB1522-E，KAVB1551-E，KAVB1552-E，KAVB1554-E，KAVB1556-E，KAVB1650-E，KAVB1651-E，KAVB1658-I，KAVB4138-W，KAVB5105-W，KAVB5455-W，KAVB9032-E，KAJV2002-E，KAJV2004-E，KAJV2006-E，KAJV2008-E
－
5.5.1，5.5.5，5.5.9，5.5.11
－

はじめに

このマニュアルは，JP1/IMとJP1/Baseを使ってJP1/IMと連携するシステムを開発する際に必要な，JP1/IMで実施する作業の手順について説明したものです。

なお，このマニュアルは，マニュアル「JP1 Version 7i JP1/Integrated Manager - Console 機能拡張編」からJP1/IMの機能だけを抜粋して，マニュアル「JP1 Version 8 JP1/Integrated Management - Manager 機能拡張」として発行しました。

対象読者

このマニュアルは，JP1/IMとJP1/Baseを使ってJP1/IMと連携するシステムを開発するソフトウェア開発者の方を対象としています。また，JP1/IMおよびJP1/Baseの機能を理解していることを前提としています。

マニュアルの構成

このマニュアルは，次に示す編で構成されています。なお，このマニュアルは各OSに共通のマニュアルです。OSごとに差異がある場合は，本文中でそのつど内容を書き分けています。

第1編　概要

JP1/IMの機能を拡張してできることの概要について説明しています。

第2編　運用

JP1/IMの機能を拡張する方法について説明しています。

第3編　リファレンス

JP1/IMでカスタマイズできる定義ファイル，およびJP1/IMが提供するコマンドについてリファレンス形式で説明しています。

関連マニュアル

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

JP1/IM関連

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

JP1 Version 8 JP1/Integrated Management - Manager リファレンス（3020-3-K02）

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/Base 運用ガイド（3020-3-K06）

JP1 Version 8 JP1/Base メッセージ（3020-3-K07）

JP1 Version 8 JP1/Base 機能拡張（3020-3-K08）

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

JP1 Version 8 JP1/Integrated Management - Rule Operation システム構築・運用ガイド（3020-3-K10）

JP1 Version 8 JP1/Integrated Management - Rule Operation GUIリファレンス（3020-3-K11）

JP1 Version 8 JP1/Integrated Management - TELstaff JP1/Integrated Management - TELstaff Alarm View システム構築・運用ガイド（3020-3-K12）

JP1 Version 8 JP1/Integrated Management - Service Support システム構築・運用ガイド（3020-3-K14）

このマニュアルでの表記

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

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

Active Directory
Active Directory(R)

AIX
AIX 5L 5.2

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)

HP-UX (PA-RISC)
HP-UX 11i V2(PA-RISC)

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/AJS2
JP1/AJS2 - Advanced Manager
JP1/Automatic Job Management System 2 - Advanced Manager

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

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

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

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

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/SSO
JP1/Distributed Server System Observer

JP1/Server System Observer

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

JP1/Performance Management/SNMP System Observer

JP1/FTP
JP1/File Transmission Server/FTP

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

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

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

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

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

JP1/IM - Console View
または JP1/IM - View
JP1/Integrated Manager - Console View

JP1/IM - Satellite Console
またはJP1/IM - SC
JP1/Integrated Manager - Satellite Console

バージョン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

JP1/IPRM
JP1/IP Resource Management Server

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

JP1/NetInsight II(R) - Facility Manager Standard

JP1/NetInsight II(R) - 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/SES
JP1/System Event Service

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

Linux
Linux AS 4 (AMD64 & Intel EM64T)
Red Hat Enterprise Linux AS 4 (AMD64 & Intel EM64T)

Linux AS 4 (IPF)
またはLinux (IPF)
Red Hat Enterprise Linux AS 4 (IPF)

Linux AS 4 (x86)
Red Hat Enterprise Linux AS 4 (x86)

Linux ES 4 (AMD64 & Intel EM64T)
Red Hat Enterprise Linux ES 4 (AMD64 & Intel EM64T)

Linux ES 4 (x86)
Red Hat Enterprise Linux ES 4 (x86)

Linux AP 5 (AMD64 & Intel EM64T)
Red Hat Enterprise Linux 5 Advanced Platform (AMD64 & Intel EM64T)

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

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

Linux 5 (AMD64 & Intel EM64T)
Red Hat Enterprise Linux 5 (AMD64 & Intel EM64T)

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

NNM
HP OpenView NNM
hp OpenView network node manager

hp OpenView network node manager Starter Edition

JP1/Cm2/NNM
JP1/Cm2/Network Node Manager

JP1/Cm2/Network Node Manager Starter Edition 250

JP1/Cm2/Network Node Manager Starter Edition Enterprise

Solaris
Solaris 9

Solaris 10

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 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
Microsoft(R) Windows Server(R) 2008 Enterprise

Microsoft(R) Windows Server(R) 2008 Standard

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 - Manager，JP1/IM - Viewに関連する機能概要だけ説明しています。

Windows 2000，Windows XP Professional，Windows Server 2003，Windows Server 2008，Windows Vistaを総称して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 | JavaTM2 Platform Enterprise Edition
Java VM | JavaTM Virtual Machine
JDBC | Java 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
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

バージョン8での製品体系変更について

バージョン8では，JP1/IMの製品体系に次の変更がありました。

JP1/IM - Central Console，JP1/IM - Central Scopeが統合されてJP1/IM - Managerになりました。

JP1/IM - Central Console 10 Nodeが廃止されました。

JP1/IM - Central Console アップグレードが廃止されました。

JP1/IM - Rule Operationが追加されました。詳細については，マニュアル「JP1/Integrated Management - Rule Operation システム構築・運用ガイド」を参照してください。

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

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

記号
意味

［　］
メニュー項目，ダイアログボックス，ダイアログボックスのボタンなどを示す。
例
［ファイル］－［新規作成］を選択する。
上記の例では，メニューバーの［ファイル］を選んで，プルダウンメニューの［新規作成］を選択することを示す。

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

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

記号
意味

｜
(ストローク)
複数の項目に対し，項目間の区切りを示し，「または」の意味を示す。
例
「A｜B｜C」は，「A，BまたはC」を示す。

｛　｝
この記号で囲まれている複数の項目の中から，必ず1組の項目を選択する。項目の区切りは|で示す。
例
｛A｜B｜C｝は「A，BまたはCのどれかを指定する」ことを示す。

[　]
この記号で囲まれている項目は任意に指定できる(省略してもよい)。
複数の項目が記述されている場合には，すべてを省略するか，どれか一つを選択する。
例
[A]は「何も指定しない」か「Aを指定する」ことを示す。
[B | C]は「何も指定しない」か「BまたはCを指定する」ことを示す。

…または...
この記号の直前に示された項目を繰り返して複数個，指定できる。
例
「A，B，…」は「Aの後にBを必要個数指定する」ことを示す。

＿
(下線)
括弧内のすべてを省略したときに，システムがとる標準値を示す。標準値がない場合は，指定した項目だけが有効である。
例
[A | B]はこの項目を指定しなかった場合に，Aを選択したとみなすことを示す。

△
空白を表す。
△₀：0個以上の空白（空白を省略できる）
△₁：1個以上の空白（空白を省略できない）

図中で使用する記号

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

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 Vista，Windows Server 2008の場合，「システムドライブ:¥ProgramData」と表記している部分は，インストール時の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の機能を拡張してできることの概要について説明します。

＜この章の構成＞

1.1　特長

1.1　特長

JP1/IMの定義ファイルをカスタマイズすることによって，ほかのアプリケーションがJP1/IMと連携するための機能を拡張できるようになります。機能を拡張すると，次のことができます。

ユーザー独自のイベント属性を表示する

JP1/Baseが提供する関数を使えば，ユーザーアプリケーションからもJP1イベントを発行できるようになります。また，この場合，ユーザー独自のイベント属性（拡張属性の固有情報）を付加することもできます。ユーザー独自のイベント属性が付加された，このようなJP1イベントを独自イベントと呼びます。独自イベントの発行方法については，マニュアル「JP1/Base 機能拡張」を参照してください。

イベント属性（拡張属性の固有情報）は，通常はJP1/IM - Viewの［イベント詳細］画面に表示されませんが，そのイベント属性についての定義ファイルを作成することによって，表示できるようになります。定義ファイルを使用して独自イベント（拡張属性の固有情報）を表示する方法については，「2.　ユーザー独自のイベント属性を表示する」を参照してください。

JP1/IM - Viewに表示されたJP1イベントからモニター画面を表示する

定義ファイルを作成することによって，JP1/IM - Viewに表示されたJP1イベントからそのJP1イベントを発行したアプリケーションの画面を表示・操作できるようになります。定義ファイルを使用してJP1イベントからモニター画面を呼び出す方法については，「3.　JP1/IM - Viewに表示されたJP1イベントからアプリケーションを起動する」を参照してください。

［統合機能メニュー］画面に新規メニューを追加する

JP1/IM - Viewの［統合機能メニュー］画面に表示される機能ツリーに新しいメニューを追加して，そのメニューから，システムやアプリケーションを管理する画面を起動するように設定できます。

［統合機能メニュー］画面に新規メニューを追加するには，定義ファイルを使用します。

定義ファイルを使用して［統合機能メニュー］画面に新規メニューを追加する方法については，「4.　［統合機能メニュー］画面に新規メニューを追加する」を参照してください。

2.　ユーザー独自のイベント属性を表示する

この章では，ユーザーアプリケーションから直接発行した独自イベントのユーザー独自のイベント属性（拡張属性の固有情報）をJP1/IM - Viewの［イベント詳細］画面に表示する機能の概要および作業手順について説明します。

＜この章の構成＞

2.1　機能の解説

2.2　ユーザー独自のイベント属性を表示する手順

2.1　機能の解説

JP1/BaseのJP1イベント発行関数を使用することによって，ユーザー独自のイベント属性（拡張属性の固有情報）を付加した独自イベントをユーザーアプリケーションから直接，発行できるようになります。

JP1/IMでは，定義ファイルを作成することによって，独自イベントのユーザー独自のイベント属性（拡張属性の固有情報）を［イベント詳細］画面に表示できます。

独自イベントの発行からユーザー独自のイベント属性の表示までの概要を次の図に示します。

図2-1　独自イベントの発行からユーザー独自のイベント属性の表示までの概要

2.2　ユーザー独自のイベント属性を表示する手順

ユーザー独自のイベント属性（拡張属性の固有情報）を表示するための作業手順を示します。

なお，JP1/IMで作業に入る前に，JP1/Baseで独自イベントを発行できるようにするための作業が必要です。JP1/Baseでの独自イベントを発行できるようにする方法については，マニュアル「JP1/Base 機能拡張」を参照してください。

また，独自イベントは，JP1/Baseでjevsendおよびjevsenddコマンドを使用して発行することもできます。その場合にも，イベント拡張属性定義ファイルの設定などが必要になることがあります。JP1/Baseでjevsendおよびjevsenddコマンドを使用して独自イベントを発行できるようにする方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/IMでの作業の流れは次のとおりです。

定義ファイルを作成する
JP1/IM - Managerがインストールされたマシン上に，次の定義ファイルを作成します。

イベント拡張属性定義ファイル
表示したいユーザー独自のイベント属性を定義します。

オブジェクトタイプ定義ファイル
ユーザー独自のイベント属性をJP1/IM - Viewの画面のどの表示項目に表示するかを定義します。

定義ファイルを有効にする

それぞれの作業の詳細を次項から説明しますが，例として次に示すJP1イベントを仮定し，そのイベント属性を表示するための定義ファイルの作成方法を説明することにします。

例として取り上げるJP1イベント

Windows上で動作する「SAMPLE」という名称のアプリケーションが，起動・停止時に発行する開始イベントと異常終了イベント

それぞれのイベントの詳細を次に示します。

表示するJP1イベントの種類

SAMPLEアプリケーションの開始時に発行されるJP1イベント（開始イベント）
イベントID：0x00000001
メッセージ：「SAMPLEアプリケーションを開始します。」

SAMPLEアプリケーションの異常終了時に発行されるJP1イベント（異常終了イベント）
イベントID：0x00000002
メッセージ：「SAMPLEアプリケーションが異常終了しました。」

開始イベントのイベント属性定義（拡張属性(extattrs)）

SAMPLEアプリケーションの開始イベントには，次の属性が定義されています。

表2-1　開始イベントの属性

属性の種別
項目
属性名
内容

基本属性
イベントID
－
0x00000001

メッセージ
－
「SAMPLEアプリケーションを開始します。」

拡張属性
(共通情報)
重大度
SEVERITY
Notice

ユーザー名
USER_NAME
SAMPLE_USER

プロダクト名
PRODUCT_NAME
/COMPANY/APP1/SAMPLE_PRODUCT
（プロダクトの名称）

オブジェクトタイプ
OBJECT_TYPE
SAMPLE

オブジェクト名
OBJECT_NAME
SAMPLE_NAME

登録名タイプ
ROOT_OBJECT_TYPE
ROOT_SAMPLE

登録名
ROOT_OBJECT_NAME
ROOT_SAMPLE_NAME

オブジェクトID
OBJECT_ID
SAMPLE_ID

事象種別
OCCURRENCE
START

開始時刻
START_TIME
SAMPLEアプリケーションの開始時刻。UTC 1970年1月1日 00:00:00からの秒数。

プラットフォーム種別
PLATFORM
NT

バージョン情報
ACTION_VERSION
0600

拡張属性
(固有情報)
SAMPLE共通属性１
COMMON_ATTR1
NATIVE

SAMPLE共通属性2
COMMON_ATTR2
TRUE

SAMPLE開始属性1
START_ATTR1
SAMPLE1

SAMPLE開始属性2
START_ATTR2
SAMPLE2

異常終了イベントのイベント属性定義（拡張属性(extattrs)）

SAMPLEアプリケーションの異常終了イベントには，次の属性が定義されています。

表2-2　異常終了イベントの属性

属性の種別
項目
属性名
内容

基本属性
イベントID
－
0x00000002

メッセージ
－
「SAMPLEアプリケーションが異常終了しました。」

拡張属性
(共通情報)
重大度
SEVERITY
Error

ユーザー名
USER_NAME
SAMPLE_USER

プロダクト名
PRODUCT_NAME
/COMPANY/APP1/SAMPLE_PRODUCT
（プロダクトの名称）

オブジェクトタイプ
OBJECT_TYPE
SAMPLE

オブジェクト名
OBJECT_NAME
SAMPLE_NAME

登録名タイプ
ROOT_OBJECT_TYPE
ROOT_SAMPLE

登録名
ROOT_OBJECT_NAME
ROOT_SAMPLE_NAME

オブジェクトID
OBJECT_ID
SAMPLE_ID

事象種別
OCCURRENCE
END

終了時刻
END_TIME
SAMPLEアプリケーションの終了時刻。UTC 1970年1月1日 00:00:00からの秒数。

終了コード
RESULT_CODE
SAMPLEアプリケーション終了時の終了コード

プラットフォーム種別
PLATFORM
NT

バージョン情報
ACTION_VERSION
0600

拡張属性
(固有情報)
SAMPLE共通属性１
COMMON_ATTR1
NATIVE

SAMPLE共通属性2
COMMON_ATTR2
TRUE

SAMPLE終了属性1
END_ATTR1
SAMPLE1

SAMPLE終了属性2
END_ATTR2
SAMPLE2

＜この節の構成＞

2.2.1　定義ファイルを作成する

2.2.2　定義ファイルを有効にする

2.2.1　定義ファイルを作成する

＜この項の構成＞

(1)　イベント拡張属性定義ファイルの作成

(2)　オブジェクトタイプ定義ファイルの作成

(1)　イベント拡張属性定義ファイルの作成

(a)　定義する内容

イベント拡張属性定義ファイルには，表示したい独自イベントに設定されているイベント属性のうち，詳細情報として表示したいイベント属性だけを定義します。基本属性，および拡張属性の共通情報部分は自動的に設定されるため，定義の必要はありません。固有情報部分だけを定義します。イベント拡張属性定義ファイルの詳細については，「5.3　イベント拡張属性定義ファイル」を参照してください。

なお，JP1/IMには，イベント拡張属性定義ファイルの記述内容をチェックするためのコマンド「jcoattrfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

(b)　格納場所

この定義ファイルは次のディレクトリに格納します。定義は，JP1/IM - Managerを再起動した後に有効になります。

Windowsの場合

Consoleパス¥conf¥console¥attribute¥

クラスタ運用の場合は，共有フォルダ¥jp1cons¥conf¥console¥attribute¥となります。

UNIXの場合

/etc/opt/jp1cons/conf/console/attribute/

クラスタ運用の場合は，共有ディレクトリ/jp1cons/conf/console/attribute/となります。

(c)　定義例

前述の「SAMPLE」というアプリケーションが発行する独自イベントについてイベント拡張属性定義ファイルに定義をする例を示します。この定義ファイルでは，一つのアプリケーションが発行するすべてのJP1イベントの属性をまとめて定義します。この例では，SAMPLEアプリケーションが発行するイベントID 00000001および00000002のJP1イベントの属性をまとめて記述してあります。

この例では次のファイル名を使用します。

company_sample_attr_ja.conf

このファイル名は，「company」という会社のSAMPLEアプリケーションであることを表します。

イベント拡張属性定義ファイルの定義例を次に示します。

図2-2　イベント拡張属性定義ファイルの定義例

(2)　オブジェクトタイプ定義ファイルの作成

(a)　定義する内容

オブジェクトタイプ定義ファイルには，表示したい独自イベントの拡張属性値，およびJP1/IM - Viewの画面（［重要イベント定義］画面，［イベント取得条件設定］画面など）の［オブジェクトタイプ］および［登録名タイプ］に表示される項目を定義します。この定義ファイルは，JP1イベントの詳細情報を表示するために必要です。オブジェクトタイプ定義ファイルの詳細については，「5.4　オブジェクトタイプ定義ファイル」を参照してください。

(b)　格納場所

この定義ファイルは次のディレクトリに格納します。定義は，JP1/IM - Managerを再起動した後に有効になります。

Windowsの場合

Consoleパス¥conf¥console¥object_type¥

クラスタ運用の場合は，共有フォルダ¥jp1cons¥conf¥console¥object_type¥となります。

UNIXの場合

/etc/opt/jp1cons/conf/console/object_type/

クラスタ運用の場合は，共有ディレクトリ/jp1cons/conf/console/object_type/となります。

(c)　定義例

前述の「SAMPLE」というアプリケーションが発行する独自イベントについてオブジェクトタイプ定義ファイルに定義をする例を示します。この例では，ROOT_OBJECT_TYPEとOBJECT_TYPEに新しい定義を追加しているので，オブジェクト定義ファイルに定義する必要があります。

この例では次のファイル名を使用します。

company_sample_obj.ja

このファイル名は，「company」という会社のSAMPLEアプリケーションであることを表します。

オブジェクトタイプ定義ファイルの定義例を次に示します。

[ObjectType]
# 拡張属性値， リスト表示文字列， コメント
ROOT_SAMPLE,  ROOT_SAMPLE   //サンプルのルートオブジェクト名
SAMPLE,  SAMPLE   //サンプルのオブジェクト名
[End]

2.2.2　定義ファイルを有効にする

定義ファイルが有効になる契機は，ファイルによって異なります。有効になる契機を次に示します。

表2-3　定義ファイルが有効になる契機

定義ファイル名 | 有効になる契機
イベント拡張属性定義ファイル | JP1/IM - Managerの再起動時
オブジェクトタイプ定義ファイル | JP1/IM - Viewの再起動時

3.　JP1/IM - Viewに表示されたJP1イベントからアプリケーションを起動する

この章では，JP1/IM - Viewに表示されたJP1イベントに対してユーザーが指定したモニター画面を呼び出す機能の概要，前提条件，および作業手順について説明します。

＜この章の構成＞

3.1　機能の解説

3.2　モニター画面を呼び出す手順

3.1　機能の解説

JP1/IM - Viewには，画面に表示されたJP1イベントに対してモニター画面を呼び出す機能があります。このモニター画面上で，JP1イベントを発行したジョブやアプリケーションの詳細を表示したり，それらのジョブやアプリケーションを直接操作したりできます。なお，JP1/IMで提供しているWWWページ版のJP1/IM - Viewに表示されたJP1イベントからは，モニター画面を呼び出すことはできません。

JP1/IMの定義ファイルをカスタマイズすることにより，デフォルトで起動できる画面※のほかに，ユーザーが指定した次の画面を起動できるようになります（一つのJP1イベントからは一つのアプリケーションだけ起動できます）。

アプリケーションプログラムの画面
アプリケーションプログラムの画面を起動するためには，実行ファイルを指定します。

WWWページ
WWWページを起動するためには，URLを指定します。

また，画面呼び出しの際には，JP1イベントなどの情報をアプリケーションに渡すことができます。

注※

デフォルトでは，次の画面を起動できます。

JP1/AJS2（アプリケーション画面）

JP1/PAM（アプリケーション画面）

JP1/Cm2/NNMまたはHP OpenView NNMのサブマップ画面（WWWページ）

なお，これらの連携製品側でJP1/IMとの連携機能を強化するために，新たに設定を追加していることがあります。上記製品のマニュアルもお読みください。

モニター画面呼び出しの概要を次の図に示します。

図3-1　JP1/IM - Viewに表示されたJP1イベントからのモニター画面呼び出し

＜この節の構成＞

3.1.1　前提条件

3.1.1　前提条件

アプリケーションプログラムの画面を起動するためには，起動する実行ファイルをJP1/IM - Viewがインストールされているマシン上に配置する必要があります。また，起動するアプリケーションプログラムの画面が実行できる権限でJP1/IM - Viewを起動する必要があります。

WWWページを起動するためには，指定するWWWブラウザーが接続するためのHTTPサーバが必要です。

3.2　モニター画面を呼び出す手順

モニター画面呼び出しをするための作業手順を示します。作業の流れは次のとおりです。

モニター画面呼び出しをするための画面を決める

定義ファイルを作成する
次の定義ファイルを作成します。

モニター画面呼び出し定義ファイル
この定義ファイルでは，どのJP1イベントが発行されたときにどの画面を呼び出すかを定義します。この定義ファイルは，JP1/IM - Managerがインストールされたマシン上に作成します。

アプリケーション実行定義ファイル
この定義ファイルでは，モニター画面呼び出し定義ファイルで定義されたアプリケーションのパスをJP1/IM - View側で解決するための定義をします。この定義ファイルは，JP1/IM - Viewがインストールされたマシン上に作成します。

定義ファイルを有効にする

それぞれの作業の詳細を次項から説明します。

＜この節の構成＞

3.2.1　モニター画面呼び出しをするための画面を決める

3.2.2　定義ファイルを作成する

3.2.3　定義ファイルを有効にする

3.2.1　モニター画面呼び出しをするための画面を決める

モニター画面呼び出しをするためには，どのJP1イベントが発行されたときにどの画面を呼び出すか，およびその画面を起動するときにどんな引数を指定するかを決める必要があります。モニター画面呼び出しは，あるJP1イベントを発行したジョブやアプリケーションの詳細画面を呼び出したり，その詳細画面から直接，該当するジョブやアプリケーションを操作したりできるようにすることを目的としています。この目的に適した画面を選んでください。

また，画面起動時に必要な情報はすべてJP1イベントの属性値から引き継ぐことになるので，JP1イベントの属性もあわせて考慮する必要があります。

なお，モニター画面呼び出しによって起動されたアプリケーションのログイン認証などは共通化できないため，必要であればログインを省略するなどの方法（画面起動コマンドのオプション化）をアプリケーションごとにとる必要があります。

ここでは，JP1/IM - View上でのアプリケーションプログラムの起動とWWWページの起動について，「2.　ユーザー独自のイベント属性を表示する」で説明したイベント属性の例を使って説明します。

3.2.2　定義ファイルを作成する

＜この項の構成＞

(1)　モニター画面呼び出し定義ファイルの作成

(2)　アプリケーション実行定義ファイルの作成

(1)　モニター画面呼び出し定義ファイルの作成

(a)　定義する内容

この定義ファイルでは，モニター画面呼び出しをするJP1イベントのIDや属性などを定義します。イベント属性は，イベント拡張属性定義ファイルの定義と対応させる必要があります。イベント属性の詳細については，「付録A　JP1イベントの属性の設定基準」を参照してください。イベント拡張属性定義ファイルの詳細については，「5.3　イベント拡張属性定義ファイル」を参照してください。

また，この定義ファイルでは，呼び出す画面，および画面を呼び出すときの引数を定義します。呼び出す画面を定義するために，アプリケーション実行定義識別子を指定します。アプリケーション実行定義識別子は，モニター画面呼び出し定義ファイルで定義した画面をJP1/IM - View側で識別するためのものです。したがって，モニター画面呼び出し定義ファイルで指定するアプリケーション実行定義識別子を，アプリケーション実行定義ファイルに定義する必要があります。指定したアプリケーション実行定義識別子は，アプリケーション実行定義ファイルによってパスが解決されます。また，実行ファイルの起動時には，モニター画面呼び出し定義ファイルで指定した引数が渡されます。モニター画面呼び出し定義ファイルの詳細については，「5.6　モニター画面呼び出し定義ファイル」を参照してください。

なお，JP1/IMには，モニター画面呼び出し定義ファイルの記述内容をチェックするためのコマンド「jcomonitorfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

(b)　格納場所

この定義ファイルは，次のディレクトリに格納します。定義は，JP1/IM - Managerを再起動した後に有効になります。

Windowsの場合

Consoleパス¥conf¥console¥monitor¥

クラスタ運用の場合は，共有フォルダ¥jp1cons¥conf¥console¥monitor¥となります。

UNIXの場合

/etc/opt/jp1cons/conf/console/monitor/

クラスタ運用の場合は，共有ディレクトリ/jp1cons/conf/console/monitor/となります。

(c)　定義例

ここでは，次の例を示します。

アプリケーションプログラムの画面の起動（SAMPLE.EXEコマンドを起動する）

次の条件に適合した場合にアプリケーションプログラムの画面を呼び出します。

イベントID：00000001

プログラムのバージョン：0500-0600

拡張属性「E.COMMON_ATTR1」の値：NATIVE

拡張属性「E.COMMON_ATTR2」の値：TRUE

アプリケーションプログラムの起動時に，-oオプションによってオブジェクト名を指定し，該当するオブジェクトに対する操作画面を開きます。次のオプションを指定します。

SAMPLE.EXE -o オブジェクト名 -u ユーザー名

WWWページの起動（URLを指定してWWWブラウザーを起動する）

次の条件に適合した場合にWWWページを呼び出します。

イベントID：00000002

プログラムのバージョン：0500-0600

次に示すURLを呼び出します。

http://ホスト名/company/app1/cgi-bin/sample.cgi ?param=オブジェクト名

この例では，次のファイル名を使用します。

company_sample_mon_ja.conf

このファイル名は，「company」という会社の「SAMPLE」アプリケーションであることを表します。

モニター画面呼び出し定義ファイルの定義例を次に示します。なお，「DEF_」で始まる行は改行までが定義として認識されるため，実際の定義ファイルでは１行に記述します。次の例では，わかりやすくするために途中に改行を入れて示してあります。

図3-2　モニター画面呼び出し定義ファイルの定義例

(2)　アプリケーション実行定義ファイルの作成

(a)　定義する内容

アプリケーション実行定義ファイルには，モニター画面呼び出し定義ファイルで定義されたアプリケーション実行定義識別子とパスの関連づけを定義します。アプリケーション実行定義ファイルの詳細については，「5.5　アプリケーション実行定義ファイル」を参照してください。

なお，JP1/IMには，アプリケーション実行定義ファイルの記述内容をチェックするためのコマンド「jcoappexecfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

(b)　格納場所

この定義ファイルは，ビューアーホスト上の次のディレクトリに格納します。定義は，JP1/IM - Viewを再起動したあとに有効になります。

Viewパス¥conf¥appexecute¥ja¥

(c)　定義例

ここでは，次の例を示します。

アプリケーションプログラムの画面を起動するコマンド：SAMPLE.EXE
このコマンドのパスはレジストリーに記述されています。

使用するWWWブラウザー
C:¥Program files¥Netscape¥bin¥netscape.exe
なお，システムのデフォルトのWWWブラウザーを使用する場合は，WWWブラウザーを定義する必要はありません。

この例では，次のファイル名を使用します。

company_sample_app.conf

アプリケーション実行定義ファイルの定義例を次に示します。

図3-3　アプリケーション実行定義ファイルの定義例

3.2.3　定義ファイルを有効にする

定義ファイルが有効になる契機は，ファイルによって異なります。有効になる契機を次に示します。

表3-1　定義ファイルが有効になる契機

定義ファイル名 | 有効になる契機
アプリケーション実行定義ファイル | JP1/IM - Viewの再起動時
モニター画面呼び出し定義ファイル | JP1/IM - Managerの再起動時

4.　［統合機能メニュー］画面に新規メニューを追加する

この章では，JP1/IM - Viewの［統合機能メニュー］画面に新規メニューを追加して，アプリケーションプログラムの画面やWWWページを起動できるようにする機能の概要，前提条件，および作業手順について説明します。

＜この章の構成＞

4.1　機能の解説

4.2　新規メニューを追加する手順

4.1　機能の解説

JP1/IM - Viewの［統合機能メニュー］画面には，JP1/IMと連携するプログラムが一覧表示されます。このメニューから，ほかの管理アプリケーションプログラムやWWWページを起動できます。

JP1/IM - Viewの定義ファイルをカスタマイズすることにより，この［統合機能メニュー］画面に新しいメニューを追加できます。新しいメニューから起動する画面には，次の画面を指定できます。

アプリケーションプログラムの画面
アプリケーションプログラムの画面を起動するためには，実行ファイルを指定します。

WWWページ
WWWページを起動するためには，URLを指定します。

［統合機能メニュー］画面への新規メニューの追加の概要を次の図に示します。

図4-1　［統合機能メニュー］画面への新規メニューの追加

＜この節の構成＞

4.1.1　前提条件

4.1.1　前提条件

アプリケーションプログラムの画面を起動するためには，起動する実行ファイルをJP1/IM - Viewがインストールされているマシン上に配置する必要があります。また，起動するアプリケーションプログラムの画面が実行できる権限でJP1/IM - Viewを起動する必要があります。

WWWページを起動するためには，URLで指定するホスト（WWWページを提供している製品がインストールされたホスト）上にHTTPサーバが必要です。

4.2　新規メニューを追加する手順

［統合機能メニュー］画面に新規メニューを追加するための作業手順を示します。作業の流れは次のとおりです。

［統合機能メニュー］画面から起動する画面を決める

定義ファイルを作成する
JP1/IM - Viewがインストールされたマシン上に，次の定義ファイルを作成します。

統合機能メニュー定義ファイル
この定義ファイルでは，追加する新規メニューの情報，新規メニューから起動する画面などを定義します。

アプリケーション実行定義ファイル
この定義ファイルでは，統合機能メニュー定義ファイルで定義されたアプリケーションのパスをJP1/IM - Viewで解決するための定義をします。

定義ファイルを有効にする

それぞれの作業の詳細を次項から説明します。

＜この節の構成＞

4.2.1　［統合機能メニュー］画面から起動する画面を決める

4.2.2　定義ファイルを作成する

4.2.3　定義ファイルを有効にする

4.2.1　［統合機能メニュー］画面から起動する画面を決める

［統合機能メニュー］画面から起動する画面は，システムやアプリケーションを管理するための画面です。この目的に適した画面を選んでください。

なお，ログイン認証などは共通化できないため，必要であればログインを省略するなどの方法（画面起動コマンドのオプション化）をアプリケーションごとにとる必要があります。

［統合機能メニュー］画面から起動する画面を決める手順を次に示します。

［統合機能メニュー］画面に表示する名称と使用するIDを決める
IDはメニュー識別子です。「会社名_製品名」の形式で指定します。IDは，メニュー全体でユニークにしてください。

［統合機能メニュー］画面に表示するときのフォルダを決める
既存のフォルダに適切なものがない場合は，フォルダの名称と使用するIDを決めます。IDは，「会社名_製品名」の形式で指定します。IDは，メニュー全体でユニークにしてください。

［統合機能メニュー］画面に表示するアイコンを準備する
アイコンは，16×16ピクセルのGIFファイルとして作成します。アイコンを指定しない場合は，デフォルトのアイコンが使用されます。

4.2.2　定義ファイルを作成する

＜この項の構成＞

(1)　統合機能メニュー定義ファイルの作成

(2)　アプリケーション実行定義ファイルの作成

(1)　統合機能メニュー定義ファイルの作成

(a)　定義する内容

統合機能メニュー定義ファイルには，メニューから起動する画面，メニューツリーの上位ノード，メニューに表示するときの名称などを定義します。

メニューから起動する画面を定義するために，アプリケーション実行定義識別子を指定します。アプリケーション実行定義識別子は，統合機能メニュー定義ファイルで定義した画面をJP1/IM - Viewで識別するためのものです。したがって，統合機能メニュー定義ファイルで指定するアプリケーション実行定義識別子を，アプリケーション実行定義ファイルに定義する必要があります。指定したアプリケーション実行定義識別子は，アプリケーション実行定義ファイルによってパスが解決され，それによってメニューから画面を起動できるようになります。統合機能メニュー定義ファイルの詳細については，「5.7　統合機能メニュー定義ファイル」を参照してください。アプリケーション実行定義ファイルの詳細については，「5.5　アプリケーション実行定義ファイル」を参照してください。

なお，JP1/IMには，統合機能メニュー定義ファイルの記述内容をチェックするためのコマンド「jcofuncfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

(b)　格納場所

この定義ファイルは，ビューアーホスト上の次のディレクトリに格納します。定義は，JP1/IM - Viewを再起動したあとに有効になります。

Viewパス¥conf¥function¥ja¥

(c)　定義例

ここでは，次の例を示します。

アプリケーション

COMPANY社のSAMPLEという名称の製品

フォルダの名称とID

「SAMPLE管理」，ID＝"company_sample_management"

メニューの名称とID

「SAMPLE管理画面（アプリケーション）」， ID="company_sample_naitive"

「SAMPLE管理画面（ＷＷＷ）」， ID="company_sample_web"

アイコンファイル

sample_icon.gif

実行ファイル

sample.exe

URL

http://host1/company/sample_url.html

この例では，次のファイル名を使用します。

company_sample_tree.conf

統合機能メニュー定義ファイルの定義例を次に示します。

図4-2　統合機能メニュー定義ファイルの定義例

この定義によって，［統合機能メニュー］画面のツリー上では，「SAMPLE管理」という名称のフォルダの下に「SAMPLE管理画面（アプリケーション）」および「SAMPLE管理画面（ＷＷＷ）」という名称のメニューが定義した順序で表示されるようになります。

(2)　アプリケーション実行定義ファイルの作成

(a)　定義する内容

アプリケーション実行定義ファイルには，統合機能メニュー定義ファイルで定義されたアプリケーション実行定義識別子とパスの関連づけを定義します。アプリケーション実行定義ファイルの詳細については，「5.5　アプリケーション実行定義ファイル」を参照してください。

なお，JP1/IMには，アプリケーション実行定義ファイルの記述内容をチェックするためのコマンド「jcoappexecfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

(b)　格納場所

この定義ファイルは，ビューアーホスト上の次のディレクトリに格納します。定義は，JP1/IM - Viewを再起動したあとに有効になります。

Viewパス¥conf¥appexecute¥ja¥

(c)　定義例

ここでは，モニター画面呼び出しをする場合と同じ例を使用します。この例では，次のファイル名を使用します。

company_sample_app.conf

アプリケーション実行定義ファイルの定義例を次に示します。

図4-3　アプリケーション実行定義ファイルの定義例

4.2.3　定義ファイルを有効にする

定義ファイルが有効になる契機は，ファイルによって異なります。有効になる契機を次に示します。

表4-1　定義ファイルが有効になる契機

定義ファイル名 | 有効になる契機
統合機能メニュー定義ファイル | JP1/IM - Viewの再起動時
アプリケーション実行定義ファイル | JP1/IM - Viewの再起動時

5.　定義ファイル

この章では，機能を拡張するために使用するJP1/IMの定義ファイルについて説明します。

＜この章の構成＞

5.1　定義ファイル一覧

5.2　定義ファイルの構造

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

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

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

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

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

5.1　定義ファイル一覧

JP1/IMで機能を拡張するために使用するJP1/IMの定義ファイルを次に示します。

表5-1　定義ファイル一覧

定義ファイル名 | 説　明
イベント拡張属性定義ファイル | JP1イベントの拡張属性を定義する
オブジェクトタイプ定義ファイル | JP1イベントの拡張属性のオブジェクトタイプを定義する
アプリケーション実行定義ファイル | ビューアーで実行するアプリケーションのIDとパスを定義する
モニター画面呼び出し定義ファイル | モニター画面呼び出しの設定を定義する
統合機能メニュー定義ファイル | 統合機能メニューに表示するツリーを定義する

＜この節の構成＞

5.1.1　定義ファイルの関連

5.1.2　定義ファイルの命名規則

5.1.3　定義ファイルの格納先

5.1.4　定義ファイルが有効になる契機

5.1.5　モデルファイル

5.1.1　定義ファイルの関連

定義ファイルの中で，定義を記述するブロック間には関連があります。また，定義ファイル間にも関連があります。それらの関連を次の図に示します。

図5-1　定義ブロックおよび定義ファイルの関連

5.1.2　定義ファイルの命名規則

定義ファイルの命名規則を次に示します。

表5-2　定義ファイルの命名規則

定義ファイル名 | 命名規則
イベント拡張属性定義ファイル | 会社名_製品名_attr_ja.conf
オブジェクトタイプ定義ファイル | 会社名_製品名_obj.ja
アプリケーション実行定義ファイル | 会社名_製品名_app.conf
モニター画面呼び出し定義ファイル | 会社名_製品名_mon_ja.conf
統合機能メニュー定義ファイル | 会社名_製品名_tree.conf

注

「製品名」は，「シリーズ名_製品名」とすることもできます。JP1イベント発行時の「PRODUCT_NAME」に指定する値の「/」を「_」に変更してファイル名に使用することをお勧めします。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

5.1.3　定義ファイルの格納先

それぞれの定義ファイルの格納先を次に示します。

表5-3　定義ファイルの格納先

定義ファイル名 | 格納先
イベント拡張属性定義ファイル | JP1/IM - Managerがインストールされたマシン
モニター画面呼び出し定義ファイル | JP1/IM - Managerがインストールされたマシン
オブジェクトタイプ定義ファイル | JP1/IM - Managerがインストールされたマシン
アプリケーション実行定義ファイル | JP1/IM - Viewがインストールされたマシン
統合機能メニュー定義ファイル | JP1/IM - Viewがインストールされたマシン

それぞれの定義ファイル格納ディレクトリを示します。

＜この項の構成＞

(1)　格納先がJP1/IM - Managerの場合

(2)　格納先がJP1/IM - Viewの場合

(1)　格納先がJP1/IM - Managerの場合

JP1/IM - Managerがインストールされたマシンの定義ファイル格納ディレクトリは次のとおりです。

表5-4　JP1/IM - Manager上の定義ファイル格納ディレクトリ（Windowsの場合）

定義ファイル名 | 格納ディレクトリ
イベント拡張属性定義ファイル | Consoleパス¥conf¥console¥attribute¥
共有フォルダ¥jp1cons¥conf¥console¥attribute¥
モニター画面呼び出し定義ファイル | Consoleパス¥conf¥console¥monitor¥
共有フォルダ¥jp1cons¥conf¥console¥monitor¥
オブジェクトタイプ定義ファイル | Consoleパス¥conf¥console¥object_type¥
共有フォルダ¥jp1cons¥conf¥console¥object_type¥

表5-5　JP1/IM - Manager上の定義ファイル格納ディレクトリ（UNIXの場合）

定義ファイル名 | 格納ディレクトリ
イベント拡張属性定義ファイル | /etc/opt/jp1cons/conf/console/attribute/
共有ディレクトリ/jp1cons/conf/console/attribute/
モニター画面呼び出し定義ファイル | /etc/opt/jp1cons/conf/console/monitor/
共有ディレクトリ/jp1cons/conf/console/monitor/
オブジェクトタイプ定義ファイル | /etc/opt/jp1cons/conf/console/object_type/
共有ディレクトリ/jp1cons/conf/console/object_type/

(2)　格納先がJP1/IM - Viewの場合

JP1/IM - View上の定義ファイル格納ディレクトリは次のとおりです。

表5-6　JP1/IM - View上の定義ファイル格納ディレクトリ

定義ファイル名 | 格納ディレクトリ
アプリケーション実行定義ファイル | Viewパス¥conf¥appexecute¥ja¥
統合機能メニュー定義ファイル | Viewパス¥conf¥function¥ja¥

5.1.4　定義ファイルが有効になる契機

定義ファイルが有効になる契機は，ファイルによって異なります。有効になる契機を次に示します。

表5-7　定義ファイルが有効になる契機

定義ファイル名 | 有効になる契機
イベント拡張属性定義ファイル | JP1/IM - Managerの再起動時
オブジェクトタイプ定義ファイル | JP1/IM - Viewの再起動時
アプリケーション実行定義ファイル | JP1/IM - Viewの再起動時
モニター画面呼び出し定義ファイル | JP1/IM - Managerの再起動時
統合機能メニュー定義ファイル | JP1/IM - Viewの再起動時

5.1.5　モデルファイル

アプリケーション実行定義ファイルおよび統合機能メニュー定義ファイルには，モデルファイルが提供されます。モデルファイルには，「.model」という拡張子が付いています。インストール時に，「.model」という拡張子のファイルと，内容が同じで拡張子を「.conf」に変更したファイルの二つが所定のディレクトリにコピーされます。定義ファイルをカスタマイズしたあと，デフォルトの設定に戻したい場合は，デフォルトのモデルファイルをコピーして拡張子の「.model」部分を削除してください。

提供されるモデルファイルを次に示します。

表5-8　モデルファイル一覧

定義ファイル名 | モデルファイル名
アプリケーション実行定義ファイル | !JP1_CC_APP0.conf.model
統合機能メニュー定義ファイル | !JP1_CC_FTREE0.conf.model

5.2　定義ファイルの構造

この節では，［イベントコンソール］画面，［統合機能メニュー］画面と連携するためにカスタマイズできるJP1/IMの定義ファイルに共通する事項について説明します。

なお，この節の説明は次の三つの定義ファイルだけに該当します。

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

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

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

オブジェクトタイプ定義ファイルおよびモニター画面呼び出し定義ファイルは，それぞれ構造が異なります。

＜この節の構成＞

5.2.1　定義ファイルの構成要素

5.2.1　定義ファイルの構成要素

定義ファイルを構成する要素には，大きく分けて，ステートメント，ブロック，およびコメントがあります。定義ファイルは，そのファイル全体の属性を表すステートメント（定義情報ヘッダー）から開始し，定義内容を記述するブロック，および任意選択のコメントが続きます。

定義ファイルを構成するこれらの要素について説明します。

＜この項の構成＞

(1)　ステートメント

(2)　ブロック

(3)　コメント

(4)　共通ステートメントの生成規則

(1)　ステートメント

(a)　 ステートメントの構造

ステートメントとは，複数の構成要素が組み合わされて一つの意味を形成するようになった列のことです。ステートメントは必ず行頭から開始しなければなりません。また，ステートメントは「;」と改行で区切らなければなりません。

(b)　ステートメントの種別

ステートメントは，記述できる場所によって「ファイル内ステートメント」と「ブロック内ステートメント」に分けられます。

ファイル内ステートメント

ファイル内ステートメントは，定義ファイルの属性を表すステートメントです。ファイル内ステートメントには，さらに「定義情報ヘッダー用ステートメント」と「ブロック制御用ステートメント」の二つがあります。

ファイル内ステートメントには「@」のプリフィックスが付きます。

ブロック内ステートメント

ブロック内ステートメントは，ブロック内の属性を表すステートメントです。ブロック内ステートメントは，ブロック開始ステートメント（@define-block）からブロック終了ステートメント（@define-block-end）までの間に記述できるステートメントのうち，コメント以外のものを指します。記述できるブロック内ステートメントは，ブロックごとに決まっています。

ブロック内ステートメントには「@」などのプリフィックスは付きません。

(2)　ブロック

(a)　ブロックの構造

ブロックはステートメントの集合体です。ブロックは，ブロックの開始を宣言するステートメント（@define-block），実際の定義を記述するブロック内ステートメント，コメント，およびブロックの終了を宣言するステートメント（@define-block-end）によって構成されます。

定義ファイルの中でブロックをネストすることはできません。

(b)　ブロックの種別

ブロック種別は，ブロック開始ステートメント（@define-block）の「type=」パラメーターで指定します。ブロック種別の詳細については，「(4) (a)　@define-blockステートメント」を参照してください。

(c)　ブロックの優先順位

ブロックには，定義内でユニークでなければならないキー項目があります。キー項目が定義内に複数個存在した場合は，優先順位に従ってブロック単位で取捨選択されます。ブロックの優先順位は次のようになります。

ファイル名を昇順にソートして後の方のファイル内のブロック

ファイル内で記述場所が後ろの方に存在するブロック

言い換えると，「定義ファイルをファイル名で昇順にソートして一つのファイルに連結し，連結したファイル内で後に記述されているものが優先される」ということになります。

(3)　コメント

コメントとは，行頭が「#」のステートメント，または1行が空白，タブ，または改行だけで構成される行です。コメントは定義情報としての意味を持ちません。

コメントは一つのステートメントとして処理されます。コメントは行単位で判断されるので，「;」で区切る必要はありません。コメントの末尾に「;」を付けた場合は，「;」もコメントの一部として解釈されます。

(4)　共通ステートメントの生成規則

ファイル内ステートメントには，定義情報ヘッダー用ステートメントとブロック制御用ステートメントの二つがあります。

ファイル内ステートメントの一覧を次に示します。

表5-9　ファイル内ステートメントの一覧

ステートメント名 | 意　味 | 種　別
@file | 定義バージョン，文字コードを宣言する | 定義情報ヘッダー用
@product | 定義中のPP情報を宣言する | 定義情報ヘッダー用
@define-block | ブロックの開始を宣言する | ブロック制御用
@define-block-end | ブロックの終了を宣言する | ブロック制御用

これらのステートメントのうち，定義情報ヘッダー用ステートメントは，一つの定義ファイル全体に共通する属性を定義します。使用できる定義情報ヘッダー用ステートメントは定義ファイルごとに異なります。また，定義情報ヘッダー用ステートメントのパラメーターも，定義ファイルごとに異なります。

ブロック制御用ステートメントは，その定義ファイル内で定義するブロックの単位を宣言するために使用します。ブロック制御用ステートメントの生成規則は，すべての定義ファイルで共通です。

このあとに，ブロック制御用ステートメントの生成規則を示します。定義情報ヘッダー用ステートメントの生成規則については，個々の定義ファイルの説明を参照してください。

(a)　@define-blockステートメント

構文

@define-block type="ブロック種別";

機能

ブロックの開始を宣言します。このステートメントから @define-block-endステートメントまでを一つの定義ブロックとして扱います。

パラメーター

type="ブロック種別"
定義ブロックの種類を指定します。指定できるブロック種別を次に示します。

表5-10　ブロック種別一覧

ブロック名 | パラメーターでの指定値
イベント属性定義ブロック | "event-attr-def"
イベント属性グループ定義ブロック | "event-attr-group-def"
イベント表示順序定義ブロック | "event-attr-order-def"
アプリケーション実行定義ブロック | "application-execution-def"
機能ツリーメニュー定義ブロック | "function-tree-def"

無効なブロック種別が指定された場合は，ブロック全体が無視されて警告が表示されますが，ファイルの解析処理は続行されます。

注意事項

定義ブロックをネストすることはできません。

定義例

@define-block-endステートメントの説明を参照してください。

(b)　@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;

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

イベント拡張属性定義ファイルは，［イベント詳細］画面に表示するイベント属性の並び順や表示する属性名を定義します。

イベント拡張属性定義ファイルには，次の3種類のファイルがあります。

すべてのイベントに共通の基本属性，および拡張属性の共通情報に対するイベント詳細情報定義（標準提供：default.conf）

JP1イベントを発行する連携製品の拡張属性の固有情報定義（標準提供：hitachi_xxxx.conf）

ユーザー定義の拡張属性の固有情報（ユーザーが個別作成）

標準提供される2種類のファイルはJP1/IM - Managerの定義ファイル格納ディレクトリに格納されています。この2種類のファイルはシステム標準定義情報であるため，ユーザーが追加，変更，削除することはできません。

新たにJP1イベントに対する拡張属性の固有情報を追加する場合は，この定義ファイル格納ディレクトリに「表5-2　定義ファイルの命名規則」の名称基準に従って作成した定義ファイルを格納してください。

この定義ファイルを作成する場合，次のことに注意してください。

Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCコードで定義する必要があります。

定義ファイルに誤って基本属性や拡張属性の共通情報を定義すると，［イベント詳細］画面を表示したときに標準提供の定義と重複して表示されます。

なお，JP1/IMには，イベント拡張属性定義ファイルの記述内容をチェックするためのコマンド「jcoattrfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

イベント拡張属性定義ファイルには，次のステートメントとブロックを記述できます。

表5-11　イベント拡張属性定義ファイルに記述できるステートメントおよびブロック

ステートメントまたはブロック | 意　味
@fileステートメント | 定義ファイルタイプおよびバージョンを宣言する
@productステートメント | 定義中のプログラム情報を宣言する
イベント拡張属性定義ブロック | イベント属性の表示について定義する
属性グループ定義ブロック | イベント属性のグループを定義する
属性表示順序定義ブロック | ［イベント詳細］画面表示時の順序をIDごとに定義する

＜この節の構成＞

5.3.1　ファイル内ステートメントの生成規則

5.3.2　イベント拡張属性定義ファイルのブロックの生成規則

5.3.3　イベント拡張属性定義ブロック内のステートメント生成規則

5.3.4　属性グループ定義ブロック内のステートメント生成規則

5.3.5　属性表示順序定義ブロック内のステートメント生成規則

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

5.3.7　標準提供されているイベント拡張属性定義ファイル

5.3.1　ファイル内ステートメントの生成規則

＜この項の構成＞

(1)　@fileステートメント

(2)　@productステートメント

(1)　@fileステートメント

(a)　構文

@file type="extended-attributes-definition", version="0300";

(b)　説明

この定義ファイルがイベント拡張属性定義ファイルであること，および定義記述フォーマットのバージョンが0300であることを宣言します。このステートメントは必須です。

(c)　注意事項

このステートメントは，ファイルの先頭行に記述しなければなりません。記述しない場合，動作は保証できません。

(2)　@productステートメント

(a)　構文

@product name="プロダクト名";

(b)　説明

ファイル内で定義する各ステートメントのプロダクト情報を定義します。

(c)　パラメーター

name="プロダクト名"

プロダクト名は，スラントで区切られた半角英数字列です。次のどちらかの形式になります。

/会社名/シリーズ名/プロダクト名

または

/会社名/プロダクト名

(d)　注意事項

指定値は，JP1イベントの拡張属性「PRODUCT_NAME」と一致させる必要があります。

解析処理では，使用禁止文字や形式はチェックされません。指定した文字列がそのまま使用されます。

(e)　定義例

定義情報ヘッダー用ステートメントの定義例を次に示します。

@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;

5.3.2　イベント拡張属性定義ファイルのブロックの生成規則

イベント拡張属性定義ファイルに記述できるブロックについて説明します。なお，それぞれのブロックに記述できるステートメント以外のステートメントを記述した場合は，エラー出力され，該当するステートメントだけが無視されます。

＜この項の構成＞

(1)　イベント拡張属性定義ブロック

(2)　属性グループ定義ブロック

(3)　属性表示順序定義ブロック

(1)　イベント拡張属性定義ブロック

(a)　説明

［イベント詳細］画面で，イベント属性名とその表示項目名（日本語名と英語名の両方）を関連づけます。このブロックは，定義ファイル内に複数個記述できます。ただし，ブロックのキーとなる属性（後述のblockステートメントの指定値）が同じブロックは，複数個記述することはできません。

なお，日本語と英語の両方を指定する場合は，後述のattrステートメントの属性名が日本語と英語ですべて対応している必要があります。

(b)　記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

blockステートメント

attrステートメント

(2)　属性グループ定義ブロック

(a)　説明

イベント拡張属性定義ブロックで定義したイベント属性をグループ化します。グループ化することにより，属性表示順序定義ブロック内のorderステートメントで属性を何度も定義する必要がなくなります。

このブロックは省略できます。

(b)　記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

blockステートメント

groupステートメント

(3)　属性表示順序定義ブロック

(a)　説明

イベント単位でそのイベントが詳細表示されたときに表示するイベント属性の順序や属性の表示名の順序を定義します。

(b)　記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

blockステートメント

orderステートメント

5.3.3　イベント拡張属性定義ブロック内のステートメント生成規則

＜この項の構成＞

(1)　blockステートメント

(2)　attrステートメント

(1)　blockステートメント

(a)　構文

block lang=言語種別, platform=プラットフォーム種別;

(b)　説明

ブロックの属性を定義します。このステートメントは，ブロックの先頭に１回だけ記述できます。

(c)　パラメーター

lang

イベント拡張属性定義ブロックの言語種別を宣言します。指定できる言語種別を次に示します。

"Japanese"
日本語環境時の定義であることを示します。

"English"
英語環境時の定義であることを示します。

platform

ブロック内の定義が有効になるプラットフォームを指定します。

定義できるプラットフォームを次に示します。

"base"
すべてのプラットフォームで有効にする場合に使用します。

"ユーザー定義"
ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

(d)　注意事項

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象になります。したがって，ここに指定するプラットフォーム名と同一の文字列がJP1イベントの拡張属性「PLATFORM」にない場合は，処理の対象になりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

(e)　定義例

次の「(2)　attrステートメント」の定義例を参照してください。

(2)　attrステートメント

(a)　構文

attr name=属性名, title=表示項目名[,type="elapsed_time/

date_format:CLIENT"];

(b)　説明

［イベント詳細］画面の属性名欄に表示する項目名と，属性値のタイプを指定します。このステートメントはブロック内に複数個指定できます。

(c)　パラメーター

name

拡張属性名を定義します。値の形式は次のとおりです。

"E.拡張属性名"

title

［イベント詳細］画面表示時の属性名欄に表示する文字列を指定します。その際には，blockステートメントで指定した言語種別が使用されます。指定文字列に半角仮名を含めることはできません。

type="elapsed_time/date_format:CLIENT"

属性値のタイプと表示形式を指定します。属性値「elapsed_time」は，UTC 1970年1月1日00:00:00からの経過秒数を10進文字列で表記した値です。表示形式「date_format:CLIENT」は，表示するビューアーホストのローカルタイムゾーンで指定された時刻を使用して，時刻形式で書式化して表示することを示します。

(d)　注意事項

このステートメントで定義するのは，基本属性，および拡張属性の共通情報を除いた拡張属性の固有情報だけです。拡張属性の固有情報以外が指定された場合，エラーは出力されないで処理が続行されますが，表示時には標準提供の定義と重複して表示されます。標準提供の定義については，次の「(2) (e)　定義例」を参照してください。

(e)　定義例

JP1イベントの拡張属性の固有情報定義例を示します。プラットフォームが"W2K"で下記表の四つの拡張属性(固有情報)を表示させたい場合の「イベント拡張属性定義ブロック」の定義例を示します。

表5-12　イベント拡張属性定義ブロックの定義例

画面表示名 | 拡張属性名(固有情報)
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;

5.3.4　属性グループ定義ブロック内のステートメント生成規則

＜この項の構成＞

(1)　blockステートメント

(2)　groupステートメント

(1)　blockステートメント

(a)　構文

block platform=プラットフォーム種別;

(b)　説明

ブロックの属性を定義します。このステートメントは，ブロックの先頭に１回だけ記述できます。

(c)　パラメーター

platform

ブロック内の定義が有効になるプラットフォームを指定します。指定できる値を次に示します。

"base"
すべてのプラットフォームで有効にする場合に使用します。

"ユーザー定義"
ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

(d)　注意事項

このブロックにはlangパラメーターは使用できません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象となります。したがって，ここに指定するプラットフォーム名と同一の文字列がイベントの拡張属性「PLATFORM」にない場合は，処理の対象となりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

(e)　定義例

次の「(2)　groupステートメント」の定義例を参照してください。

(2)　groupステートメント

(a)　構文

group name=グループ名, attrs=属性名並び;

(b)　説明

［イベント詳細］画面上に表示する属性の並び順に名称を付けてグループ化します。このステートメントはブロック内に複数個指定できます。

(c)　パラメーター

name

属性名並びに付ける名称を指定します。名称は，32バイト以内の半角英数字で指定します。大文字と小文字は区別されません。ここで付けた名称は，定義ファイル内のorderブロック中で使用できます。

attrs

グループ化する属性を一つ以上並べて指定します。複数個並べた場合は，［イベント詳細］画面に上からその順序で表示されます。指定形式は次のとおりです。

一つの場合：attrs="E.A0"

複数の場合：attrs="E.A0|E.A1"

(d)　注意事項

指定できる属性は拡張属性の固有情報だけです。基本属性または拡張属性の共通情報を指定した場合は，指定した属性値が［イベント詳細］画面上に複数個表示されます。

(e)　定義例

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;

5.3.5　属性表示順序定義ブロック内のステートメント生成規則

＜この項の構成＞

(1)　blockステートメント

(2)　orderステートメント

(1)　blockステートメント

(a)　構文

block platform=プラットフォーム種別;

(b)　説明

属性表示順序定義ブロックに依存するブロック属性を定義します。このステートメントは，ブロックの先頭に１回だけ記述できます。

(c)　パラメーター

platform

ブロック内の定義が有効になるプラットフォームを指定します。定義できるプラットフォームを次に示します。

"base"
すべてのプラットフォームで有効にする場合に使用します。

"ユーザー定義"
ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

(d)　注意事項

このブロックではlangパラメーターは使用できません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象となります。したがって，ここに指定するプラットフォーム名と同一の文字列がイベントの拡張属性「PLATFORM」にない場合は，処理の対象となりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

(e)　定義例

次の「(2)　orderステートメント」の定義例を参照してください。

(2)　orderステートメント

(a)　構文

order id=イベントID定義文字列, attrs=属性名並び;

(b)　説明

［イベント詳細］画面上に表示する属性とその並び順をIDごとに定義します。このステートメントはブロック内に複数個指定できます。

(c)　パラメーター

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ステートメントの場合と同様に，指定できる属性は固有の拡張属性だけです。基本属性または共通の拡張属性を指定した場合は，指定した属性値が［イベント詳細］画面上に複数個表示されます。

(d)　定義例

イベントIDが00001000の場合にBASEグループとCOMMONグループを表示する定義例を次に示します。

@define-block type="event-attr-order-def";
block platform="base";
order id=00001000, attrs="BASE|COMMON"
@define-block-end;

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

イベント拡張属性定義ファイルの定義例を次に示します。

@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;

5.3.7　標準提供されているイベント拡張属性定義ファイル

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;

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

オブジェクトタイプ定義ファイルは，JP1/IM - Viewの画面（［重要イベント定義］画面，［イベント取得条件設定］画面など）の［オブジェクトタイプ］および［登録名タイプ］に表示するオブジェクトタイプおよび登録名タイプを設定します。

この定義ファイルは，Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCコードで定義する必要があります。

＜この節の構成＞

5.4.1　形式

5.4.2　注意事項

5.4.3　定義例

5.4.1　形式

オブジェクトタイプ定義ファイルの形式を次に示します。

[コメント]
[ObjectType]
定義ブロック [コメント]
[End]
[コメント]

注

ここで，「[ObjectType]」および「[End]」は「[」および「]」を含めてそのまま記述します。

コメントは，「#」で開始する改行を含まない文字列です。

定義ブロックは，拡張属性値とリスト表示文字列で構成されます。拡張属性値は，オブジェクトタイプまたは登録名タイプに格納される文字列です。リスト表示文字列は，ドロップダウンリストに一覧表示する文字列です。

5.4.2　注意事項

オブジェクトタイプ（拡張属性値）に空白を入れることはできません。

リスト表示文字列には，日本語ではなく拡張属性値そのものを記述してください。

複数のファイルに同一のオブジェクトタイプが存在した場合の動作は保証されません。

5.4.3　定義例

オブジェクトタイプ定義ファイルの定義例を次に示します。

[ObjectType]
# 拡張属性値,  リスト表示文字列   コメント
ACTION,        ACTION          // アクション
ACTIONFLOW,    ACTIONFLOW      // アクションフロー
BATCHQUEUE,    BATCHQUEUE      // バッチキュー
JOB,           JOB             // ジョブ
JOBNET,        JOBNET          // ジョブネット
MEDIA,         MEDIA           // メディア
PRINTER,       PRINTER         // プリンタ
PRINTJOB,      PRINTJOB        // プリントジョブ
PRINTQUEUE,    PRINTQUEUE      // パイプキュー
PROCESS,       PROCESS         // プロセス
RESTORE,       RESTORE         // リストア
[End]

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

アプリケーション実行定義ファイルは，［イベントコンソール］画面から起動するアプリケーションなどの実行形式ファイルのIDとパスを定義するファイルです。

なお，JP1/IMには，アプリケーション実行定義ファイルの記述内容をチェックするためのコマンド「jcoappexecfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

アプリケーション実行定義ファイルには，次のステートメントとブロックを記述できます。

表5-13　アプリケーション実行定義ファイルに記述できるステートメントおよびブロック

ステートメントまたはブロック | 意　味
@fileステートメント | 定義ファイルタイプを宣言する
アプリケーション実行定義ブロック | アプリケーション実行定義識別子と実行形式ファイルのパスの関連を定義する

＜この節の構成＞

5.5.1　ファイル内ステートメントの生成規則

5.5.2　アプリケーション実行定義ファイルのブロックの生成規則

5.5.3　アプリケーション実行定義ブロック内のステートメント生成規則

5.5.4　置換文字列

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

5.5.1　ファイル内ステートメントの生成規則

＜この項の構成＞

(1)　@fileステートメント

(1)　@fileステートメント

(a)　構文

@file type="application-execution-definition";

(b)　説明

この定義ファイルがアプリケーション実行定義ファイルであることを宣言します。このステートメントは必須です。

(c)　注意事項

このステートメントは，ファイルの先頭行に記述しなければなりません。

5.5.2　アプリケーション実行定義ファイルのブロックの生成規則

＜この項の構成＞

(1)　アプリケーション実行定義ブロック

(1)　アプリケーション実行定義ブロック

(a)　説明

［イベントコンソール］画面から起動するアプリケーションなどの実行形式ファイルのパスを定義し，ほかの定義ファイルからリンクするためのID付けをします。

(b)　記述できるステートメント

このブロックには次のステートメントを記述できます。

idステートメント

pathステートメント

descriptionステートメント

上記以外のステートメントが記述された場合は，エラー出力し，該当するステートメントだけを無視します。

(c)　指定値

pathステートメントで指定できる実行形式ファイルは，.exeまたは.batファイルです。

(d)　注意事項

コマンド実行時のカレントディレクトリは不定です。カレントディレクトリから相対パスを意識するコマンドなどは指定できません。.batファイルなどでcdコマンドを実行した後，実行するようにしてください。

5.5.3　アプリケーション実行定義ブロック内のステートメント生成規則

＜この項の構成＞

(1)　idステートメント

(2)　pathステートメント

(3)　descriptionステートメント

(1)　idステートメント

(a)　構文

id="アプリケーション実行定義識別子";

(b)　説明

このブロックで指定するコマンドパスにIDを付けます。このステートメントは必須です。このステートメントは，ブロック内で１回だけ記述できます。

(c)　指定値

アプリケーション実行定義識別子は，32バイト以内の半角英数字で構成される文字列です。この文字列は定義内でユニークでなければなりません。ユニーク性を保持するために，次の命名規則に従ってください。

会社名_製品名[_機能名(または画面名)]

(d)　注意事項

「"jco_"」で始まる文字列，および「"default_browser"」は，アプリケーション実行定義識別子として予約されているため，使用できません。

同一の「id」を持つブロックが解析対象のファイル内に複数個存在した場合，次の順に優先順位が決定され，最優先のブロックが有効になります。

ファイル名を昇順でソートして後の方のブロック

ファイル内の位置が後の方のブロック

それ以外のブロックは無効になります。

(e)　定義例

「(3)　descriptionステートメント」の定義例を参照してください。

(2)　pathステートメント

(a)　構文

path="コマンドパス";

(b)　説明

idステートメントで指定したアプリケーション実行定義識別子と関連づける実行形式ファイルのパスを定義します。このステートメントは必須です。このステートメントは，同一ブロック中に複数個指定できます。

(c)　指定値

起動する実行形式ファイルのフルパスを指定します。後述の置き換えキーワードを使用して，レジストリーなどからパスを組み立てることもできます。

(d)　注意事項

このステートメントを複数個指定した場合は，記述順にパスが検索され，最初に見つかったパスが使用されます。

検索処理はJP1/IM - Viewの起動時にだけ実行されます。そのため，起動対象となるアプリケーションをJP1/IM - Viewの実行中にインストールした場合は，JP1/IM - Viewを再起動する必要があります。

(e)　定義例

次の「(3)　descriptionステートメント」の定義例を参照してください。

(3)　descriptionステートメント

(a)　構文

description="アプリケーション実行の説明文";

(b)　説明

ブロック内のアプリケーション実行定義に説明を付加します。このステートメントは，ブロック内で1回だけ記述できます。

(c)　指定値

アプリケーション実行の説明文を指定します。文字数の制限はありませんが，50文字以内にすることをお勧めします。

(d)　定義例

@define-block type="application-execution-def";
id="HITACHI_JP1_SAMPLE";
path="C:¥Program Files¥HITACHI¥JP1¥bin¥sample.exe";
description="日立のサンプルプログラム";
@define-block-end;

5.5.4　置換文字列

pathステートメントには，実行時に置き換え可能な置換文字列を指定できます。

＜この項の構成＞

(1)　キーワード置換文字列

(2)　レジストリー置換文字列

(1)　キーワード置換文字列

指定された定義内にキーワード置換文字列が存在する場合は，記述されたキーワードに従って文字列の置換が実行されます。形式を次に示します。

%置き換えキーワード%

置き換えキーワードの一覧を次に示します。

表5-14　 置き換えキーワードの一覧

キーワード | 置換する内容
JCO_JP1USER | JP1/IM - ManagerにログインしたJP1のユーザー
JCO_INSTALLPATH | JP1/IM - Viewのインストールフォルダの名称

(2)　レジストリー置換文字列

定義内にレジストリー置換文字列を指定すると，記述されたレジストリーから値を取得して文字列の置換が実行されます。レジストリー置換文字列の形式を次に示します。

[¥レジストリーキー¥レジストリーキー¥…¥レジストリー値]

レジストリー置換文字列の中には，さらに，レジストリー専用の置き換えキーワード「%UPPER%」を使用できます。「%UPPER%」を使用すると，レジストリーキーの中で同一階層のキーの中からキー名称で文字列比較が実行され，最も大きな文字列を選択して置換が実行されます。このキーワードの目的は，レジストリーキー内でバージョンごとにキーを分けているときに，常に最新のバージョンが得られるようにすることです。

「%UPPER%」は，レジストリー文字列内に１か所だけ指定できます。次に，「%UPPER%」を使用してJP1/SAMPLEのレジストリーを指定する例を示します。

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥%UPPER%¥PATHNAME¥PATH00]

このように指定すると，「%UPPER%」の部分が最新バージョンに置き換えられ，常に最新の実行形式ファイルが得られます。

例えば，レジストリーキーに

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥0671¥PATHNAME¥PATH00]
[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥0700¥PATHNAME¥PATH00]

の二つが存在した場合，"0700">"0671"となるため，

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥0700¥PATHNAME¥PATH00]

のレジストリーから値を取得します。

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

アプリケーション実行定義ファイルの定義例を次に示します。

@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;

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

モニター画面呼び出し定義ファイルは，［イベントコンソール］画面からイベント発行元などのモニター画面を呼び出すための定義ファイルです。この定義ファイルは，イベントIDや属性などの情報からキーを作り，イベント属性からコマンドラインパラメーターを作成するために使用します。

この定義ファイルは，Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCコードで定義する必要があります。

なお，JP1/IMには，モニター画面呼び出し定義ファイルの記述内容をチェックするためのコマンド「jcomonitorfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

＜この節の構成＞

5.6.1　形式

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

5.6.1　形式

モニター画面呼び出し定義ファイルの形式を次に示します。

DESC_VERSION=0300
[コメント]
キー定義
サブキー定義
関連づけ定義
呼び出しインターフェース定義

「DESC_VERSION=0300」はテーブルバージョンレコードです。

コメントは，「#」で開始する改行を含まない文字列です。

そのほかの要素について，このあとで説明します。

＜この項の構成＞

(1)　キー定義

(2)　サブキー定義

(3)　関連づけ定義

(4)　呼び出しインターフェース定義

(1)　キー定義

モニター画面の呼び出し時にイベント属性中で固定的にキーとなる項目を定義します。キーとなる項目は次の三つです。

イベントID

プロダクト名

バージョン

それぞれの属性の組み合わせによって，動作やサブキーへのリンクを定義します。

(a)　形式

DEF_KEY PRODUCT_NAME="プロダクト名"
       EVENT_ID=イベントID
       [VERSION=バージョン|ALL]
       {SUBKEY=サブキー
      ｜INTERFACE=インターフェース名}

(b)　引数

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パラメーターは，どちらかだけを指定できます。

(c)　注意事項

バージョンの比較は昇順で実行されます。開始バージョンよりも終了バージョンの方が小さい場合は，エラーは発行されませんが，そのキー定義自体が無視されます。

「PRODUCT_NAME」に指定する値は，JP1イベントの拡張属性「PRODUCT_NAME」に指定する値と同じにする必要があります。

(2)　サブキー定義

サブキー定義は，モニター画面の呼び出し時に固定キーからリンクされ，イベント属性をキーとして登録します。

(a)　形式

DEF_SUBKEY
NAME=サブキー名
       KEYS=属性名1 [, 属性名2[,属性名3[,属性名4]]]

(b)　引数

NAME=サブキー名

サブキーの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

KEYS=属性名1 [, 属性名2[,属性名3[,属性名4]]]

属性名の指定形式を次に示します。

表5-15　属性名の指定形式

指定形式 | 値の形式 | 意味および内容
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.拡張属性名 | 文字列 | 拡張属性

(3)　関連づけ定義

サブキーの値とインターフェースの関連づけを定義します。

(a)　形式

DEF_IF_RELATION
SUBKEY_NAME=サブキー名
       ｛ VALUE1=" 属性値1"[[ VALUE2=" 属性値2"]…]
        ｜KEY_DEFAULT ｝
        IF_NAME=インターフェース名

(b)　引数

SUBKEY_NAME=サブキー名

サブキーの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

VALUEn=" 属性値"

nは，サブキー定義のKEYSパラメーターで指定した属性の並び順に1から4までの数です。キーの値は完全に一致させる必要があります。値に正規表現などは使用できません。指定できる属性の一覧と指定形式については，サブキー定義の説明を参照してください。

KEY_DEFAULT

VALUE1，VALUE2，…に指定した値と一致しないケースをインターフェースと関連づける際に，VALUE1，VALUE2，…の代わりに指定します。

IF_NAME=インターフェース名

サブキー値が一致した場合に呼び出すインターフェース名称を指定します。インターフェース名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

(c)　注意事項

VALUE1，VALUE2，…のすべての属性が完全に一致しないJP1イベントは，「KEY_DEFAULT」で指定したインターフェースとなります。

(4)　呼び出しインターフェース定義

モニター画面呼び出し時のインターフェースを定義します。

(a)　形式

DEF_MTR_CALL
        NAME=インターフェース名
        EXEC_ID=アプリケーション実行定義識別子
        PATH="コマンド引数"
        [PARAM= 属性名1[,属性名2…]]

(b)　引数

NAME=インターフェース名

インターフェースの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

EXEC_ID=アプリケーション実行定義識別子

アプリケーション実行定義識別子を指定します。識別子には，ビューアー上のアプリケーション実行定義ファイルで定義したIDを指定します。

なお，「"jco_"」で始まる文字列はアプリケーション実行定義識別子として予約されているため，使用できません。

PATH="コマンド引数"

EXEC_IDで指定した実行形式ファイルに渡すコマンド引数を指定します。EXEC_IDで指定した実行形式ファイル名とここで指定した引数によってコマンドラインが構成されます。例えば，次のようなコマンドラインがあるとします。

"app.exe arg1 arg2"

コマンド引数には，この「arg1」「arg2」の部分を指定します。

PATHには，ビューアーの動作環境属性およびイベント属性値で置換できる予約キーワードを指定できます。置き換えキーワードを次に示します。

表5-16　置き換えキーワード

キーワード
置換する語句

%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

指定できるイベント属性は，基本属性の一部と拡張属性です。指定できる属性と指定形式については，サブキーの説明を参照してください。

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

WindowsのイベントログをトラップしたJP1イベントからモニター画面を呼ぶ場合の例を示します。

注

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

1行目

「DESC_VERSION=0300」は，このファイルの記述形式のバージョンが「0300」であることを示します。

2～4行目

コメント行です。動作バージョンの適用範囲を含めることをお勧めします。

5行目

キー定義レコードで，プロダクト名が「/HITACHI/JP1/NTEVENT_LOGTRAP」，イベントIDが「00003A71」の場合に，サブキー「SAMPLE」を使用して，呼び出すモニター画面を決定することを意味します。

6行目

サブキー定義レコードで，サブキー名を「SAMPLE」として，拡張属性「PRODUCT_NAME」と，拡張属性「A5」（WindowsのイベントログのID）を使用することを宣言します。

７行目

関連づけ定義レコードで，サブキーに設定した「E.A5」の値が「8010」と一致した場合，インターフェース「NETM_DM」を使用してモニター画面を表示することを意味します。

8行目

呼び出しインターフェース定義レコードです。インターフェース名称を「NETM_DM」とし，アプリケーション実行定義識別子が「HITACHI_NETM_DM」で定義されているコマンドに引数として「netmdm_argument」を渡して実行することを意味します。

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

統合機能メニュー定義ファイルは，JP1/IM - Viewの［統合機能メニュー］画面に表示するツリー構造や表示項目などを定義するためのファイルです。

なお，JP1/IMには，統合機能メニュー定義ファイルの記述内容をチェックするためのコマンド「jcofuncfcheck」が用意されています。このコマンドの詳細については，「6.　コマンド」を参照してください。

統合機能メニュー定義ファイルには，次のステートメントとブロックを記述できます。

表5-17　統合機能メニュー定義ファイルに記述できるステートメントとブロック

ステートメントまたはブロック | 意　味
@fileステートメント | 定義ファイルタイプを宣言する
機能ツリーメニュー定義ブロック | ［統合機能メニュー］画面上の一つのフォルダまたは機能を定義する

なお，［統合機能メニュー］画面に表示される機能の順序はファイル名順になります。一つのファイル内では，定義ブロック順になります。メニューの表示順序を変更したい場合は，これらの順序を変更してください。

＜この節の構成＞

5.7.1　ファイル内ステートメントの生成規則

5.7.2　統合機能メニュー定義ファイルのブロック

5.7.3　機能ツリーメニュー定義ブロック内のステートメント生成規則

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

5.7.1　ファイル内ステートメントの生成規則

＜この項の構成＞

(1)　@fileステートメント

(1)　@fileステートメント

(a)　構文

@file type="function-definition";

(b)　説明

この定義ファイルが統合機能メニュー定義ファイルであることを宣言します。このステートメントは必須です。

(c)　注意事項

このステートメントは，ファイル内の先頭行に記述しなければなりません。

5.7.2　統合機能メニュー定義ファイルのブロック

＜この項の構成＞

(1)　機能ツリーメニュー定義ブロック

(1)　機能ツリーメニュー定義ブロック

(a)　説明

［統合機能メニュー］画面に表示するフォルダまたは機能を作成し，機能が選択されたときに実行するアプリケーションとの関連をアプリケーション実行定義識別子で定義します。

(b)　記述できるステートメント種別

このブロックに記述できるステートメントは，フォルダを定義する場合と機能を定義する場合で異なります。

フォルダを定義する場合

idステートメント

parent_idステートメント

nameステートメント

機能を定義する場合

idステートメント

parent_idステートメント

nameステートメント

execute_idステートメント

iconステートメント

argumentsステートメント

上記以外のステートメントが記述された場合は，エラー出力され，該当するステートメントだけが無視されます。

5.7.3　機能ツリーメニュー定義ブロック内のステートメント生成規則

＜この項の構成＞

(1)　idステートメント

(2)　parent_idステートメント

(3)　nameステートメント

(4)　execute_idステートメント

(5)　iconステートメント

(6)　argumentsステートメント

(1)　idステートメント

(a)　構文

id="メニュー識別子";

(b)　説明

機能ツリーメニュー定義ブロックのメニュー識別子を定義します。このステートメントは必須です。このステートメントはブロック内に１回だけ記述できます。

(c)　指定値

メニュー識別子には，32バイト以内の半角英数字を指定できます。この文字列は，統合機能メニュー定義ファイル内でユニークでなければなりません。ユニーク性を保持するために，次の命名規則に従ってください。

フォルダの場合

会社名[_製品名]

機能の場合

会社名_製品名[_機能名(または画面名)]

適切なフォルダ名称がすでに存在している場合は，フォルダを新規に追加しないで，定義ファイル格納場所のほかの定義ファイルに記述してあるフォルダを使用してください。

(d)　注意事項

「"root"」は最上位のメニュー識別子として予約されているため，使用できません。

「"jco_"」で始まる文字列はメニュー識別子として予約されているため，使用できません。

同一の「id」を持つブロックが解析対象のファイル内に複数個存在した場合，次の順に優先順位が決定され，最優先のブロックが有効になります。

ファイル名を昇順でソートして後の方のブロック

ファイル内の位置が後の方のブロック

それ以外のブロックは無効になります。

(e)　定義例

「(6)　argumentsステートメント」の定義例を参照してください。

(2)　parent_idステートメント

(a)　構文

parent_id="親メニュー識別子";

(b)　説明

自メニュー識別子に対して，ツリー構造上の上位にあるメニュー識別子を指定します。階層は，rootを含めて3階層まで指定できます。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

(c)　指定値

rootまたは定義済みのメニュー識別子を指定します。

(d)　注意事項

複数の親メニュー識別子を指定して複数の上位フォルダを持つことはできません。

(e)　定義例

「(6)　argumentsステートメント」の定義例を参照してください。

(3)　nameステートメント

(a)　構文

name="表示名称";

(b)　説明

［統合機能メニュー］画面に表示する名称を定義します。このステートメントは必須です。このステートメントはブロック内に１回だけ記述できます。

(c)　指定値

「表示名称」には，［統合機能メニュー］画面上に表示される文字列を指定します。文字列には日本語文字を含めることができます。内容のわかりやすい簡潔な表示名称を指定してください。

(d)　注意事項

指定した値はメニュー上に表示されるため，名詞にすることをお勧めします。例えば，「コマンド実行機能」などの文字列にします。

指定する値は，定義内でユニークでなくてもかまいませんが，操作性を考えてユニークにすることをお勧めします。

(e)　定義例

「(6)　argumentsステートメント」の定義例を参照してください。

(4)　execute_idステートメント

(a)　構文

execute_id="アプリケーション実行定義識別子";

(b)　説明

統合機能メニューに表示される機能をダブルクリックしたときに実行するアプリケーションを指定します。このステートメントは機能を指定する場合は必須です。このステートメントは，ブロック内で１回だけ指定できます。

(c)　指定値

アプリケーション実行定義ファイルで定義したアプリケーション実行定義識別子を指定します。

(d)　注意事項

フォルダを作成する場合は，このステートメントを指定しても無視されます。

指定したアプリケーション実行定義識別子が存在しない場合，メニューは表示されません。

「"jco_"」で始まる文字列はアプリケーション実行定義識別子として予約されているため，使用できません。

(e)　定義例

「(6)　argumentsステートメント」の定義例を参照してください。

(5)　iconステートメント

(a)　構文

icon="表示アイコンファイル名";

(b)　説明

［統合機能メニュー］画面に表示するアイコンを指定します。このステートメントは，機能を指定する場合にだけ使用できます。

(c)　指定値

GIFファイルのファイル名称をフルパスで指定します。

(d)　注意事項

フォルダを作成する場合は，このステートメントを指定しても無視されます。

このステートメントが省略された場合は，共通のアイコンが使用されます。

GIFファイルの推奨サイズは16×16ピクセルとします。それ以外のサイズはリサイズして表示します。

(e)　定義例

次の「(6)　argumentsステートメント」の定義例を参照してください。

(6)　argumentsステートメント

(a)　構文

arguments="コマンド引数";

(b)　説明

execute_idで指定したアプリケーションに対する引数を指定します。このステートメントは，機能を指定する場合にだけ使用できます。このステートメントは，ブロック内で１回だけ指定できます。

(c)　指定値

argumentsは，execute_idで指定した実行形式ファイル名に付加されてコマンドラインを構成します。例えば，次のようなコマンドラインがあるとします。

app.exe arg1 arg2

引数には，この「arg1」「arg2」の部分を指定します。

argumentsには，ビューアーの動作環境属性で置き換える予約キーワードや，レジストリーの値から置き換える置換文字列も使用できます。置換文字列に関する詳細は，「5.5.4　置換文字列」を参照してください。

(d)　注意事項

フォルダを作成する場合は，このステートメントを指定しても無視されます。

execute_idで指定した実行形式ファイルへのフルパスと，置換文字列を置換した後のargumentsは，１個の空白を付加して連結されます。このときのコマンドラインの長さが1,024文字を超えた場合は，実行できません。

(e)　定義例

機能ツリーメニューブロックの定義例を次に示します。

@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;

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

統合機能メニュー定義ファイルの定義例を次に示します。

#
# 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;
#----------------------------------------------------------

6.　コマンド

この章では，JP1/IMの定義ファイルをチェックするために使用できるコマンドについて説明します。

＜この章の構成＞

コマンドの記述形式

コマンド一覧

jcoappexecfcheck

jcoattrfcheck

jcofuncfcheck

jcomonitorfcheck

コマンドの記述形式

コマンドの説明で使用する見出しについて説明します。

このマニュアルでは，次に示す見出しを使ってコマンドの使い方を説明しています。

機能

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

形式

コマンドの記述形式を示します。形式の説明で使用する記号については，「はじめに」で説明しています。

実行権限

コマンドの実行権限について説明します。

格納先ディレクトリ

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

引数

コマンドの引数の意味，形式，指定できる値などについて説明します。

注意事項

コマンドを使用する場合に注意する事柄を説明します。また，条件によって制限を受けることがあれば説明します。

使用例

具体的な値を入力したコマンドの使用例を示します。

コマンド一覧

JP1/IMで使用できるコマンドを次に示します。

表6-1　コマンド一覧

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

イベント拡張属性定義ファイルをチェックする
jcoattrfcheck
Windows Server 2003の場合：なし
Windows Server 2008の場合：Administrators権限（Windows のUAC 機能が有効な場合は管理者コンソールから実行）
UNIXの場合：なし

モニター画面呼び出し定義ファイルをチェックする
jcomonitorfcheck
Windows Server 2003の場合：なし
Windows Server 2008の場合：Administrators権限（Windows のUAC 機能が有効な場合は管理者コンソールから実行）
UNIXの場合：なし

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

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

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

jcoappexecfcheck

機能

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

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

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

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

形式

jcoappexecfcheck アプリケーション実行定義ディレクトリ名

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

アプリケーション実行定義ディレクトリ名

チェックの対象となるアプリケーション実行定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名を指定することはできません。

注意事項

解析結果には，システムで定義するアプリケーション実行定義識別子（統合コンソールで使用するデフォルトのWWWブラウザー定義である「"default_browser"」）が含まれます。

使用例

次の定義ファイルに対してコマンドを実行した場合の例を示します。

@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ごとに，次の情報を含んだ１行で出力されます。

プラットフォーム,イベントID,言語種別,プロダクト名,属性名,表示名,タイプ

注

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

形式

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

実行権限

Windows Server 2003の場合：なし

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

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

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

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

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

注意事項

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

jcofuncfcheck

機能

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

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

Function tree definition
 ツリー階層 "表示文字列" [,"実行コマンドパス"]

Function toolbar definition
 row = 列
   "表示文字列"[,"実行コマンドパス"]

注

「Function toolbar definition」以降の部分は，統合機能メニュー定義ディレクトリとして次のディレクトリが指定された場合にだけ表示されます。

Viewパス¥conf¥function¥ja
または
Viewパス¥conf¥function¥en

形式

jcofuncfcheck アプリケーション実行定義ディレクトリ名△
             統合機能メニュー定義ディレクトリ名

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

アプリケーション実行定義ディレクトリ名

チェックの対象となるアプリケーション実行定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名を指定することはできません。

統合機能メニュー定義ディレクトリ名

チェックの対象となる統合機能メニュー定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名を指定することはできません。

注意事項

解析結果には，システムで定義するアプリケーション実行定義識別子（統合コンソールで使用するデフォルトのWWWブラウザー定義である「"default_browser"」）および統合機能メニュー識別子（機能ツリーの最上位ノードを表す「"root"」）が含まれます。

使用例

次の定義ファイルに対してコマンドを実行した場合の例を示します。

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

@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"

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

#AJS2-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

付録

＜この付録の構成＞

付録A　JP1イベントの属性の設定基準

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

付録C　（3020-3-K03-81）の変更内容

付録A　JP1イベントの属性の設定基準

JP1イベントの属性の設定基準を示します。モニター画面呼び出しの定義をする際は，ここに示す基準に基づいてイベント属性を設定してください。

＜この節の構成＞

付録A.1　基本属性

付録A.2　拡張属性

付録A.1　基本属性

JP1イベントの基本属性を次に示します。

表A-1　基本属性

属性の項目
説　明

イベントDB内の通し番号
発行元によらないでこのイベントサーバに到達した順番（ローカルイベントも含む）。この属性はJP1イベントのイベントサーバ間の転送時に保存されない。主にJP1イベントをユーザーアプリケーションが取得したときやほかのイベントサーバへ転送したときの漏れ・重複の防止に用いる。

イベントID
発行元のアプリケーションや事象の内容を表す８バイトの値。各日立プログラムおよびユーザープログラムには，イベントのIDの範囲が割り当てられている。ユーザープログラムに指定できる値の範囲は，0～0x1FFFおよび0x7FFF8000～0x7FFFFFFFである。イベントIDは，システム全体でユニーク性を保持できるように割り当てる必要がある。なお，メッセージIDの8バイトのうち上位4バイトが基本部，下位4バイトが拡張部となっている。

登録要因
JP1イベントがこのイベントサーバに登録された要因。この属性はJP1イベントのイベントサーバ間転送時に保存されない。登録要因を次に示す。
1：自イベントサーバから自イベントサーバあての発行
2：自イベントサーバから他イベントサーバあての発行
3：他イベントサーバから自イベントサーバあての発行
4：環境設定の指定による他イベントサーバから自イベントサーバへの転送

プロセスID
発行元アプリケーションプログラムのプロセスID。

登録時刻
発行元イベントサーバでの登録時刻（発行元ホストの時計に基づく。UTCの1970-01-01 00:00:00からの秒数）。

到着時刻
自イベントサーバでの登録時刻（UTCの1970-01-01 00:00:00からの秒数）。この属性はJP1イベントのイベントサーバ間転送時に保存されない。

発行元ユーザーID
発行元プロセスのユーザーID。WindowsとJavaでは環境設定による固定値（-1～65,535）。

発行元グループID
発行元プロセスのグループID。WindowsとJavaでは環境設定による固定値（-1～65,535）。

発行元ユーザー名
発行元プロセスのユーザー名。

発行元グループ名
発行元プロセスのグループ名。WindowsとJavaではNULL文字列。

発行元イベントサーバ名
発行元のイベントサーバ名。JP1イベントが転送された場合でもこのJP1イベントが発生したホストのイベントサーバ名が入る。

送信先イベントサーバ名
発行元アプリケーションが他イベントサーバへの転送を明示して指定した場合に，他イベントサーバの名称が入る。

発行元IPアドレス
発行元イベントサーバに対応するIPアドレス（NATやプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。

送信先IPアドレス
送信先イベントサーバに対応するIPアドレス（NATやプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。

発行元別通し番号
発行元ホストでのイベントDB内通し番号（転送によって値は変化しない）。

コードセット
メッセージ・詳細情報・拡張属性が記述されている文字コードセット名。

メッセージ
メッセージは次の規則に基づいて指定する。

事象の内容をわかりやすく説明する。

改行コードを含めないで１行で書く。

詳細情報
任意のデータ。

付録A.2　拡張属性

JP1イベントの拡張属性を次に示します。拡張属性には，共通情報と固有情報があります。

＜この項の構成＞

(1)　共通情報

(2)　固有情報

(1)　共通情報

拡張属性の共通情報を次に示します。なお，拡張属性の共通情報はイベント拡張属性定義ファイルに定義する必要はありません。

表A-2　拡張属性（共通情報）

属性名
項目
内容

SEVERITY
重大度
次に示す重大度がある。
Emergency，Alert，Critical，Error，Warning，Notice，Information，Debug
重大度の詳細については，「表A-3重大度の意味」を参照のこと。

USER_NAME
ユーザー名
ユーザー名。業務を実行しているユーザーの名前。

PRODUCT_NAME
プロダクト名
プロダクト名。プロダクト名は，スラント「/」で区切られた半角英数字列となる。次のどちらかの形式に従い，会社ごとにユニークな文字列となるようにする。
/会社名/シリーズ名/プロダクト名
または
/会社名/プロダクト名
なお，会社名「HITACHI」は予約されているため，使用できない。

OBJECT_TYPE
オブジェクトタイプ
オブジェクトタイプには，イベント発行元のオブジェクトの種類を指定する。デフォルトでは，次のオブジェクトタイプが登録されている。このタイプを使用してJP1イベントのフィルタリングおよび検索を実行するため，同じ意味を持つJP1イベントは，できるだけ同じオブジェクトタイプとして扱えるように指定する。
新しいオブジェクトタイプを追加する場合は，ユニークな名称を指定する。オブジェクトタイプを追加した場合は，オブジェクトタイプ定義ファイルを作成する必要がある。
JOB：ジョブ
JOBNET：ジョブネット
ACTION：アクション
ACTIONFLOW：アクションフロー
PRINTJOB：印刷ジョブ
PRINTQUEUE：プリントキュー
PRINTER：プリンタ
BATCHQUEUE：バッチキュー
PIPEQUEUE：パイプキュー
JOBBOX：ジョブボックス
LOGFILE：ログファイル
LINK：リンク（下位層の通信レイヤーの事象通知用）
SERVICE：サービス（デーモンプロセスなど）
PRODUCT：プロダクト（プログラム固有のそのほかの事象通知用）
CONFIGRATION：構成定義
SERVER：サーバ
BACKUP：バックアップ
RESTORE：リストア
MEDIA：メディア

OBJECT_NAME
オブジェクト名
オブジェクト名。オブジェクトタイプを特定するための名称を指定する。例えば，オブジェクトタイプが「JOB」の場合はジョブ名称などを指定する。

ROOT_OBJECT_TYPE
登録名タイプ
登録名タイプ。オブジェクトタイプの親オブジェクトのタイプを指定する。これは，オブジェクトが階層を持つ場合などに有効である。例えば，オブジェクトタイプが「JOB」の場合，ルートオブジェクトタイプは「JOBNET」となる。ルートオブジェクトタイプが存在しない場合は，オブジェクトタイプと同じ種別を指定すること。デフォルトでは，オブジェクトタイプと同じ値が定義されている。

ROOT_OBJECT_NAME
登録名
登録名。上記のルートオブジェクトタイプを特定するための名称を指定する。例えば，ジョブネット名称などを指定する。

OBJECT_ID
オブジェクトID
オブジェクトID。
PRODUCT_NAMEとの組み合わせによってオブジェクトのインスタンスを統合システム内で一意に意識できる文字列（形式は他製品に依存する。この情報はJP1/IMの［統合機能メニュー］画面から各製品のモニターを呼び出すときに使用する）。

OCCURRENCE
事象種別
特定のオブジェクトについて，イベントの発行契機となる事象を設定する。デフォルトでは次のものがある。基本的には，オブジェクトタイプとこの事象種別によってフィルター設定などをすることで，特定のオブジェクトの特定の事象を選択できるようになる。
ACTIVE：アクティブになった
INACTIVE：非アクティブになった
START：開始した
END：終了した
NOTSTART：開始できなかった
CANCEL：キャンセルされた
LATESTART：開始予定時刻を過ぎた
LATEEND：終了予定時刻を過ぎた
SUBMIT：サブミットされた
UNSUBMIT：サブミットが取り消された
ENQUEUE：キューに登録された
DEQUEUE：キューから削除された
PAUSE：一時停止（保留）
RELEASE：一時停止の解除（保留解除）
RESTART：再実行を開始した
CREATE：作成された
DELETE：削除された
MODIFY：更新された
RETRY：リトライを開始した
STOP：停止中
MOVE：移動した
COPY：コピーした
NOTICE：通知した（オペレーターなどへの通知結果）
REPLY：応答された
CONNECT：接続した
DISCONNECT：切り離した
EXCEPTION：その他のエラーが発生した

START_TIME
開始時刻
実行開始または再実行開始の時刻。UTC 1970年1月1日 00:00:00からの秒数で指定する。事象種別がSTART，RESTART，PAUSE，RELEASE，またはENDの場合だけに指定する。

END_TIME
終了時刻
実行終了の時刻。UTC 1970年1月1日 00:00:00からの秒数で指定する。事象種別がENDの場合だけに指定する。

RESULT_CODE
終了コード
10進数文字列の終了コード。事象種別がENDの場合だけに指定する。

PLATFORM※
－
イベント拡張属性定義ファイル，モニター画面呼び出し定義ファイルなどでプラットフォーム種別として指定する任意の文字列を指定する。省略した場合は，「base」が指定されたものとして扱われる。

ACTION_VERSION※
－
モニター画面呼び出しのときのバージョン情報として使用する。複数バージョンが混在していて，それぞれの場合に呼び出す画面などが異なる場合に必要である。指定しない場合は，モニター画面呼び出し定義でバージョン指定を使用しないこと。

注※

これらの属性はイベント詳細情報には表示されません。ただし，イベント拡張属性定義ファイルに定義した場合はイベント詳細情報に表示されます。

「重大度」の意味

拡張属性の共通情報「重大度」の意味を次の表に示します。モニター画面呼び出しの定義をするときには，ここに示す基準を指針としてください。なお，発行時に「重大度」が指定されていないイベントは，［イベントコンソール］画面に表示されません。

表A-3　重大度の意味

重大度 | 表示名称 | 意　味
Emergency | 緊急 | パニック状態。通常すべてのユーザーにブロードキャストするもの
Alert | 警戒 | システムやデータベースの破壊など，直ちに修復が必要な状態
Critical | 致命的 | ハードデバイスのエラーなどの危険な状態
Error | エラー | エラー
Warning | 警告 | 警告メッセージ
Notice | 通知 | エラー状態ではないが，特別な扱いが必要な状態
Information | 情報 | 通知メッセージ
Debug | デバッグ | 通常，プログラムのデバッグ時だけに使用する情報を含むメッセージ。メッセージ量の問題が発生するので，JP1イベント発行の対象としない

(2)　固有情報

共通情報のほかに，JP1イベントに付加して利用価値のある情報をプログラムごとに固有情報として設定します。拡張属性の固有情報を設定した場合は，イベント拡張属性定義ファイルに定義する必要があります。

固有情報を設定するときの規則を次に示します。

属性名は意味のない記号名でもよい。

属性名と意味は，同じ「PRODUCT_NAME」の拡張属性を持つ各プログラムで１対１で対応するようにする。

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

JP1/IMの定義ファイルに記述できるステートメントの種類，構造，および指定できる値を一覧で示します。

注

この節の説明は次の三つの定義ファイルだけに該当します。

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

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

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

＜この節の構成＞

付録B.1　ステートメントの種類

付録B.2　ステートメントの構造

付録B.3　ステートメント内の構成要素の生成規則

付録B.1　ステートメントの種類

表B-1　ステートメントの種類

ステートメントの分類
ステートメントの種類

ファイル内ステートメント
ブロック開始ステートメント
ブロック終了ステートメント
ファイル属性ステートメント
プロダクトステートメント

ブロック内ステートメント
機能メニューコマンドオプション定義ステートメント
イベント属性定義ステートメント
ブロック属性定義ステートメント
機能メニュー実行定義識別子定義ステートメント
アプリケーション説明定義ステートメント
グループ定義ステートメント
機能メニュー表示アイコン定義ステートメント
アプリケーション実行定義識別子定義ステートメント
機能メニュー識別子定義ステートメント
機能メニュー表示名定義ステートメント
順序定義ステートメント
機能メニュー親識別子定義ステートメント
アプリケーションパス定義ステートメント

付録B.2　ステートメントの構造

表B-2　ステートメントの構造

ステートメントの種類 | 記述形式
ブロック開始ステートメント | @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=コマンドパス

付録B.3　ステートメント内の構成要素の生成規則

ステートメント内の構成要素に指定できる値を次に示します。

表B-3　ステートメント内の構成要素に指定できる値

構成要素
指定できる値

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バイトのユーザー定義文字列

列挙セパレーター
¥|

付録C　（3020-3-K03-81）の変更内容

3020-3-K03-81の変更内容を表C-1に示します。

表C-1　（3020-3-K03-81）の変更内容

#
変更個所
追加・変更内容

1
前書き
■対象製品
［訂正前］
適用OS：Windows Server 2003，Windows XP Professional
P-242C-6H84
JP1/Integrated Management - View
08-50
適用OS：Windows Vista
P-2A2C-6H84
JP1/Integrated Management - View
08-50
適用OS：Windows Server 2003
P-242C-8E84
JP1/Integrated Management - Manager
08-50
P-242C-6L84
JP1/Base
08-50
［訂正後］
適用OS：Windows Server 2003，Windows XP Professional
P-242C-6H84
JP1/Integrated Management - View
08-50
適用OS：Windows Vista，Windows Server 2008
P-2A2C-6H84
JP1/Integrated Management - View
08-50※
適用OS：Windows Server 2003
P-242C-8E84
JP1/Integrated Management - Manager
08-50
P-242C-6L84
JP1/Base
08-50
適用OS：Windows Server 2008
P-2A2C-8E84
JP1/Integrated Management - Manager
08-50
P-2A2C-6L84
JP1/Base
08-50

2
前書き
■対象製品
［訂正前］
適用OS：AIX
P-1M2C-8E81
JP1/Integrated Management - Manager
08-50
P-1M2C-6L81
JP1/Base
08-50
［訂正後］
適用OS：AIX 5L 5.2，5L 5.3
P-1M2C-8E81
JP1/Integrated Management - Manager
08-50
P-1M2C-6L81
JP1/Base
08-50
適用OS：AIX 6.1
P-1M2C-9E81
JP1/Integrated Management - Manager
08-50
P-1M2C-6L81
JP1/Base
08-50

3
前書き
■対象製品
［訂正前］
適用OS：Linux AS 4（x86），Linux ES 4（x86），Linux AS 4（AMD64 & Intel EM64T），Linux ES 4（AMD64 & Intel EM64T）
P-9S2C-8E81
JP1/Integrated Management - Manager
08-50
P-9S2C-7L81
JP1/Base
08-50
適用OS：Linux AS 4（IPF）
P-9V2C-8E81
JP1/Integrated Management - Manager
08-50
P-9V2C-6L81
JP1/Base
08-50
［訂正後］
適用OS：Linux AS 4（x86），Linux ES 4（x86），Linux AS 4（AMD64 & Intel EM64T），Linux ES 4（AMD64 & Intel EM64T）
P-9S2C-8E81
JP1/Integrated Management - Manager
08-50
P-9S2C-7L81
JP1/Base
08-50
適用OS：Linux 5（x86），Linux 5 AP（x86），Linux 5（AMD64 & Intel EM64T），Linux 5 AP（AMD64 & Intel EM64T）
P-9S2C-9E81
JP1/Integrated Management - Manager
08-50
P-9S2C-7L81
JP1/Base
08-50
適用OS：Linux AS 4（IPF）
P-9V2C-8E81
JP1/Integrated Management - Manager
08-50
P-9V2C-6L81
JP1/Base
08-50
適用OS：Linux 5（IPF），Linux 5 AP（IPF）
P-9V2C-9E81
JP1/Integrated Management - Manager
08-50
P-9V2C-6L81
JP1/Base
08-50

4
前書き
■対象製品
［追加］
注※　Windows Server 2008は，P-2A2C-6H84 JP1/Integrated Management - View 08-50-05以降でサポートしています。

5
はじめに
■このマニュアルでの表記
［訂正前］
[図データ]
［訂正後］
[図データ]

6
はじめに
■このマニュアルでの表記
［訂正前］
[図データ]
［訂正後］
[図データ]

7
はじめに
■このマニュアルでの表記
［追加］
[図データ]

8
はじめに
■このマニュアルでの表記
［訂正前］

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

［訂正後］

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

9
はじめに
■Windows版JP1/IM，JP1/Baseのインストール先フォルダの表記
［訂正前］
Windows Vistaの場合，「システムドライブ:¥ProgramData」と表記している部分は，インストール時のOS環境変数によって決定されるため，環境によって異なる場合があります。
［訂正後］
Windows Vista，Windows Server 2008の場合，「システムドライブ:¥ProgramData」と表記している部分は，インストール時のOS環境変数によって決定されるため，環境によって異なる場合があります。

10
5.6.1
(2)　サブキー定義
(b)　引数
表 5-15　属性名の指定形式
［訂正前］
[図データ]
［訂正後］
[図データ]

11
6
コマンド一覧
表 6-1　コマンド一覧
［訂正前］
[図データ]
［訂正後］
[図データ]

12
6
jcoattrfcheck
実行権限
［訂正前］
なし
［訂正後］
Windows Server 2003の場合：なし
Windows Server 2008の場合：Administrators権限（Windows のUAC 機能が有効な場合は管理者コンソールから実行）
UNIXの場合：なし

13
6
jcomonitorfcheck
実行権限
［訂正前］
なし
［訂正後］
Windows Server 2003の場合：なし
Windows Server 2008の場合：Administrators権限（Windows のUAC 機能が有効な場合は管理者コンソールから実行）
UNIXの場合：なし

索引

[Ｊ][Ｓ]
[ア行][カ行][サ行][タ行][マ行][ヤ行][ラ行]

(英字)

(Ｊ)

jcoappexecfcheck

jcoattrfcheck

jcofuncfcheck

jcomonitorfcheck

JP1イベント

拡張属性

基本属性

属性の設定基準

定義ファイル利用によるユーザー独自のイベント属性の表示

表示手順

(Ｓ)

SEVERITY（重大度）

(ア行)

(あ)

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

アプリケーション実行定義ファイルのブロックの生成規則

アプリケーション実行定義ブロック内のステートメント生成規則

チェックする

置換文字列

定義例

ファイル内ステートメントの生成規則

(い)

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

イベント拡張属性定義ブロック内のステートメント生成規則

属性グループ定義ブロック内のステートメント生成規則

属性表示順序定義ブロック内のステートメント生成規則

チェックする

定義例

標準提供されているイベント拡張属性定義ファイル

ファイル内ステートメントの生成規則

ブロックの生成規則

(お)

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

形式

注意事項

定義例

(カ行)

(か)

概要

拡張属性

共通情報

固有情報

(き)

キーワード置換文字列

基本属性

共通情報

(こ)

コマンド

jcoappexecfcheck

jcoattrfcheck

jcofuncfcheck

jcomonitorfcheck

一覧

記述形式

固有情報

(サ行)

(し)

「重大度」の意味

(す)

ステートメント

構成要素の生成規則

構造

種類

詳細

(タ行)

(ち)

置換文字列

キーワード置換文字列

レジストリー置換文字列

(て)

定義ファイル

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

一覧

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

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

格納先

構成要素

構造

チェックコマンド

定義ファイルの関連

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

命名規則

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

有効になる契機

(と)

［統合機能メニュー］画面

起動する画面を決める

新規メニューの追加手順

新規メニューの追加の概要

新規メニューを追加する

新規メニューを追加するための前提条件

定義ファイルを作成する

定義ファイルを有効にする

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

機能ツリーメニュー定義ブロック内のステートメント生成規則

チェックする

定義例

統合機能メニュー定義ファイルのブロック

ファイル内ステートメントの生成規則

独自イベント

特長

(マ行)

(も)

モデルファイル

モニター画面

定義ファイルを作成する

定義ファイルを有効にする

呼び出しの概要

呼び出しをするための画面を決める

呼び出す

呼び出すための設定手順

呼び出すための前提条件

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

形式

チェックする

定義例

(ヤ行)

(ゆ)

ユーザー独自のイベント属性

定義ファイルを作成する

定義ファイルを有効にする

表示する

表示する手順

表示の概要

(ラ行)

(れ)

レジストリー置換文字列

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
BSAFEは，RSA Security Inc.の米国およびその他の国における登録商標です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
NetInsightは，日立ソフトウェアエンジニアリング株式会社の商標です。
Netscapeは，米国およびその他の国におけるNetscape Communications Corporationの登録商標です。
OpenViewは，ヒューレット・パッカード社の商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
POSIXは，the Institute of Electrical and Electronics Engineers, Inc. (IEEE)で制定された標準仕様です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
RSAは，RSA Security Inc.の登録商標です。
Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
TELstaffは，日立ソフトウェアエンジニアリング株式会社の登録商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
XPG4は，X/Open Company Limitedの規格名称です。
プログラムプロダクト「P-9D2C-8E81」「P-9D2C-6L81」には，米国Sun Microsystems, Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-8E81」「P-9D2C-6L81」には，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/).

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