JP1 Version 9

JP1/Base 運用ガイド

解説・手引・文法・操作書

3020-3-R71-30

目　　次

前書き

変更内容

はじめに

第1編　概要編

1.　JP1/Baseの概要

1.1　JP1/Baseの機能概要

1.2　ユーザーを管理する

1.2.1　ユーザー認証とは

1.2.2　ユーザー認証圏とは

1.2.3　認証サーバ

1.2.4　ディレクトリサーバと連携してログイン認証をする（Windows限定）

1.2.5　ユーザーマッピングとは

1.3　サービスの起動順序および終了順序を制御する（Windows限定）

1.4　イベントサービスを使ってJP1イベントを送受信する

1.4.1　JP1/Baseが取得するJP1イベントの種類

1.4.2　イベントDBの概要

1.4.3　JP1イベントの転送

1.5　ログメッセージおよびイベントログをJP1イベントに変換する

1.5.1　アプリケーションプログラムのログファイルを変換する

1.5.2　Windowsのイベントログを変換する

1.6　定義情報を収集・配布する（JP1/IM限定）

1.6.1　IM構成管理による定義情報の管理

1.6.2　IM構成管理によるサービスの稼働情報の確認

1.6.3　コマンドによるイベントサービスの定義情報の収集と配布

1.6.4　JP1製品の定義情報の収集

1.7　ヘルスチェック

1.7.1　ヘルスチェック機能を利用したプロセス監視の仕組み

1.7.2　ヘルスチェック機能を利用した他ホストの監視

1.8　ローカルアクション

1.8.1　ローカルアクションを実行する条件

1.8.2　ローカルアクションで実行できるコマンド

1.8.3　ローカルアクションの実行状態

1.8.4　ローカルアクションの休止

1.9　各種システム構成への対応

1.9.1　クラスタシステムでの運用

1.9.2　非クラスタ環境での論理ホスト運用

1.10　JP1/Baseの通信方式

1.10.1　推奨する通信方式

1.10.2　ホスト名に対応するIPアドレスの確認方法

1.11　JP1/Baseの互換性

第2編　構築編

2.　インストールとセットアップ

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

2.2　インストール（Windowsの場合）

2.2.1　インストール

2.2.2　アンインストール

2.2.3　インストール・アンインストール時の注意事項

2.3　インストール（UNIXの場合）

2.3.1　インストール

2.3.2　Hitachi PP Installerの使用方法

2.3.3　アンインストール

2.3.4　インストール・アンインストール時の注意事項

2.3.5　セットアップ前の作業

2.4　セットアップ

2.4.1　使用する正規表現を拡張する

2.4.2　パスワード保管形式の設定

2.4.3　JP1/Baseの障害に備えた設定

2.5　バックアップとリカバリー

2.5.1　バックアップとリカバリーの検討

2.5.2　バックアップとリカバリー（Windowsの場合）

2.5.3　バックアップとリカバリー（UNIXの場合）

3.　クラスタシステムで運用する場合の設定

3.1　クラスタ運用の概要

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

3.1.2　JP1/Baseのクラスタ運用の概要

3.2　クラスタ運用の前提条件とサポート範囲

3.3　クラスタ運用でのJP1/Baseの機能

3.3.1　ログファイルトラップのクラスタ運用

3.3.2　イベントログトラップのクラスタ運用

3.3.3　ヘルスチェックのクラスタ運用

3.4　クラスタ運用の環境設定（Windowsの場合）

3.4.1　環境設定で設定する項目

3.4.2　インストール

3.4.3　セットアップ

3.4.4　クラスタソフトへの登録

3.4.5　同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定

3.5　クラスタ運用の環境設定（UNIXの場合）

3.5.1　環境設定で設定する項目

3.5.2　インストール

3.5.3　セットアップ

3.5.4　クラスタソフトへの登録

3.6　クラスタ運用中の設定変更時の作業

3.7　論理ホストの削除

3.7.1　論理ホストの削除（Windowsの場合）

3.7.2　論理ホストの削除（UNIXの場合）

3.8　クラスタ運用に関する注意事項

3.9　非クラスタ環境で論理ホストを運用する場合の設定

3.9.1　非クラスタ環境で論理ホストを運用する場合の構成の検討

3.9.2　非クラスタ環境で論理ホストを運用する場合の構築

3.9.3　非クラスタ環境での論理ホスト運用

4.　ネットワーク構成に応じたJP1/Baseの通信設定

4.1　単一ネットワークでの運用

4.2　複数ネットワークでの運用

4.3　ネットワークを分離した環境での運用

4.3.1　ネットワークを分離した環境でJP1/Baseを運用する際の考え方

4.3.2　jp1hosts情報を定義する

4.3.3　通信方式を変更する

4.3.4　イベントサービスの通信設定を変更する

4.3.5　JP1/Baseを再起動する

4.3.6　従来のイベントサーバとイベントを送受信する場合の注意事項

4.4　クラスタ運用していない場合の通信設定例（ネットワークを分離した環境での運用）

4.4.1　通信設定の変更

4.5　クラスタ運用する場合の通信設定例（ネットワークを分離した環境での運用）

4.5.1　通信設定の変更

4.6　ネットワークを分離した環境で，特定のネットワークで運用する場合の通信設定例

4.7　複数ネットワークでの運用から単一ネットワークでの運用に戻す

4.8　通信設定が必要な場合

第3編　運用・操作編

5.　起動と終了

5.1　JP1/Baseを起動および終了する（Windowsの場合）

5.1.1　サービスの起動

5.1.2　サービスの起動確認

5.1.3　サービスの終了

5.2　JP1/Baseを起動および終了する（UNIXの場合）

5.2.1　自動起動および自動終了の設定

5.2.2　JP1/Baseの起動確認

6.　ユーザー管理の設定

6.1　ユーザー管理の設定（Windowsの場合）

6.1.1　使用する認証サーバを指定する

6.1.2　JP1ユーザー（標準ユーザー）を設定する

6.1.3　JP1ユーザーの操作権限を設定する

6.1.4　プライマリー認証サーバの設定情報をコピーする

6.1.5　ユーザーマッピングを設定する前に

6.1.6　GUIを使ってユーザーマッピングを設定する

6.1.7　コマンドを使ってユーザーマッピングを設定する

6.1.8　ユーザー管理に関する注意事項

6.2　ディレクトリサーバと連携してログイン認証をする場合の設定（Windowsの場合）

6.2.1　連携するディレクトリサーバを指定する

6.2.2　JP1ユーザー（連携ユーザー）を設定する

6.3　ユーザー管理の設定（UNIXの場合）

6.3.1　使用する認証サーバを指定する

6.3.2　JP1ユーザーを設定する

6.3.3　JP1ユーザーの操作権限を設定する

6.3.4　プライマリー認証サーバの設定情報をコピーする

6.3.5　ユーザーマッピングを設定する

6.3.6　ユーザー管理に関する注意事項

6.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）

6.4.1　GUIを使って設定する（Windows限定）

6.4.2　コマンドを使って設定する

7.　サービスの起動順序および終了順序の設定（Windows限定）

7.1　サービスの起動順序および終了順序の設定手順

7.2　起動順序定義ファイルを編集する

7.2.1　サービスの起動順序の制御

7.2.2　サービスの終了順序の制御

7.3　サービスが起動するタイミングを設定する

7.4　起動管理機能を使用する場合の注意事項

8.　イベントサービス環境の設定

8.1　イベントサービス環境の設定手順

8.1.1　転送するJP1イベントの検討

8.1.2　イベントサービス環境を設定する

8.1.3　DNSを使ったシステムでのイベントサーバの設定

8.2　イベントDBの初期化

8.2.1　イベントサービスの稼働中に初期化する

8.2.2　イベントサービスの停止中に初期化する

8.3　イベントDBの内容をcsvファイルに出力する

8.3.1　csvファイルの出力形式

8.3.2　csvファイルに出力される項目

8.4　イベントサービスの注意事項

9.　イベント変換の設定

9.1　アプリケーションプログラムのログファイルを変換する

9.1.1　ログファイルトラップを設定する

9.1.2　ログファイルトラップの注意事項

9.2　Windowsのイベントログを変換する

9.2.1　イベントログトラップを設定する

9.2.2　イベントログトラップの注意事項

10.　イベントサービスの定義情報の収集と配布（JP1/IM限定）

10.1　定義情報・稼働情報の通信を設定する（IM構成管理連携）

10.2　イベントサービスの定義情報を収集する

10.2.1　出力形式

10.2.2　収集例

10.3　イベントサービスの定義情報を配布する

11.　ローカルアクションの設定

11.1　ローカルアクションを設定する

11.1.1　ローカルアクションを定義する

11.1.2　ローカルアクションの設定を変更する

11.1.3　ローカルアクションの動作状況を確認する

11.1.4　ローカルアクションを休止する

11.2　ローカルアクションの運用例

11.2.1　ローカルアクション実行定義ファイルを設定する

11.2.2　転送設定ファイルを設定する

11.3　ローカルアクションの注意事項

12.　JP1/Base運用中の設定変更

12.1　JP1/Baseの設定を変更する

12.2　JP1/Baseが動作するホストの設定を変更する

12.2.1　ホスト名の変更による影響および必要な作業

12.2.2　IPアドレスの変更による影響および必要な作業

12.2.3　システムの日時変更時に必要な作業

第4編　リファレンス編

13.　コマンド

コマンド一覧

cpysvprm（Windows限定）

hntr2conf

hntr2getconf

hntr2getname（Windows限定）

hntr2kill（UNIX限定）

hntr2mon（UNIX限定）

hntr2util（UNIX限定）

hntr2util（Windows限定）

jbs_killall.cluster（UNIX限定）

jbs_log.bat（Windows限定）

jbs_log.sh（UNIX限定）

jbs_setup_cluster（Windows限定）

jbs_spmd（UNIX限定）

jbs_spmd_reload

jbs_spmd_status

jbs_spmd_stop

jbs_start（UNIX限定）

jbs_start.cluster（UNIX限定）

jbs_stop（UNIX限定）

jbs_stop.cluster（UNIX限定）

jbsacllint

jbsaclreload

jbsadduser

jbsadmin（Windows Vista限定）

jbsblockadesrv

jbscancellcact

jbschgds（Windows限定）

jbschgpasswd

jbschkds（Windows限定）

jbsgetcnf

jbsgetopinfo

jbsgetumap

jbshostsexport

jbshostsimport

jbslistacl

jbslistlcact

jbslistsrv

jbslistuser

jbsmkpass（Windows限定）

jbsmkumap

jbspassmgr（Windows限定）

jbsrmacl

jbsrmumap

jbsrmumappass（Windows限定）

jbsrmuser

jbsrt_del

jbsrt_distrib

jbsrt_get

jbsrt_sync

jbssetacl

jbssetcnf

jbssetumap

jbssetupsrv（Windows限定）

jbssetusrsrv（UNIX限定）

jbsumappass（Windows限定）

jbsunblockadesrv

jbsunsetcnf

jcocmdconv

jcocmddef

jcocmddel

jcocmdlog

jcocmdshow

jevdbinit

jevdbmkrep

jevdbswitch

jevdef_distrib

jevdef_get

jeveltreload（Windows限定）

jevexport

jevlogdstart（UNIX限定）

jevlogdstat

jevlogdstop（UNIX限定）

jevlogreload

jevlogstart

jevlogstart（クラスタ運用限定）

jevlogstat

jevlogstop

jevlogstop（クラスタ運用限定）

jevregsvc（Windows限定）

jevreload

jevsend

jevsendd

jevstart（UNIX限定）

jevstat

jevstop（UNIX限定）

Jischk

Jiscond

Jisconv

Jiscpy

Jisext

Jisinfo

Jiskeymnt

Jisktod

Jislckclear（Windows限定）

Jislckext

Jislckfree（Windows限定）

Jislckreg（UNIX限定）

Jismlcktr（Windows限定）

Jisprt

Jisrsdel（UNIX限定）

jp1base_setup（UNIX限定）

jp1base_setup_cluster（UNIX限定）

jp1bshasetup（Windows限定）

jp1ping

14.　定義ファイル

定義ファイル一覧

イベントフィルターの文法

起動順序定義ファイル（Windows限定）

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）

イベントサーバインデックスファイル

イベントサーバ設定ファイル

転送設定ファイル

API設定ファイル

ログファイルトラップ動作定義ファイル

ログファイルトラップ起動定義ファイル

ログ情報定義ファイル

イベントログトラップ動作定義ファイル（Windows限定）

配布定義ファイル

パスワード定義ファイル（Windows限定）

ユーザー権限レベルファイル

ディレクトリサーバ変更ファイル（Windows限定）

ディレクトリサーバ連携定義ファイル（Windows限定）

ユーザーマッピング定義ファイル

ヘルスチェック定義ファイル

共通定義設定用ファイル（ヘルスチェック機能）

JP1/Baseパラメーター定義ファイル

拡張起動プロセス定義ファイル

jp1hosts定義ファイル

ホストアクセス制限定義ファイル

ローカルアクション環境変数ファイル

ローカルアクション実行定義ファイル

共通定義設定用ファイル（ローカルアクション機能）

15.　JP1イベント

15.1　JP1イベントの属性

15.1.1　基本属性

15.1.2　拡張属性

15.2　JP1/Baseが出力するJP1イベント一覧

15.3　JP1イベントの詳細

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

16.　トラブルシューティング

16.1　対処の手順

16.2　ログ情報の種類

16.2.1　共通メッセージログ

16.2.2　統合トレースログ

16.2.3　プロセス別ログ

16.2.4　操作ログ

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

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

16.3.1　Windowsの場合

16.3.2　UNIXの場合

16.4　資料の採取方法

16.4.1　Windowsの場合

16.4.2　UNIXの場合

16.5　トラブルへの対処方法

16.5.1　OS共通のトラブル

16.5.2　Windowsの場合

16.5.3　UNIXの場合

16.5.4　ヘルスチェック機能で異常を検知した場合

16.6　JP1/Base使用上の注意事項

付録

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

付録A.1　Windowsの場合

付録A.2　UNIXの場合

付録B　プロセス一覧

付録B.1　Windowsの場合

付録B.2　UNIXの場合

付録C　ポート番号一覧

付録C.1　JP1/Baseのポート番号

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

付録C.3　コネクションの接続状態

付録D　制限値一覧

付録E　性能と見積もり

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

付録E.2　ディスク占有量（Windowsの場合）

付録E.3　ディスク占有量（UNIXの場合）

付録E.4　クラスタ運用時の共有ディスクのディスク占有量

付録F　正規表現の文法

付録F.1　デフォルトで使用できる正規表現

付録F.2　正規表現を拡張した場合に使用できる拡張正規表現

付録F.3　06-71以前および07-00以降で使用できる正規表現の比較

付録F.4　正規表現を指定する際のヒント

付録F.5　正規表現の指定例

付録G　カーネルパラメーター一覧

付録H　通信設定の変更対応

付録I　SNMPトラップを変換する

付録I.1　SNMPトラップ変換機能によるイベント変換の仕組み

付録I.2　SNMPトラップ変換を設定する

付録I.3　SNMPトラップ変換のコマンド

付録I.4　SNMPトラップ変換の定義ファイル

付録I.5　SNMPトラップ変換のJP1イベント

付録J　JP1/SESイベントを使用する製品との連携

付録J.1　JP1/SESイベントを使用する製品別の設定

付録J.2　JP1/SESイベントを使用する製品で共通の設定

付録J.3　JP1/SESイベントを使用する場合の注意事項

付録J.4　JP1/SESイベントをJP1イベントに変換する

付録K　操作ログの出力

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

付録K.2　操作ログの保存形式

付録K.3　操作ログの出力形式

付録K.4　操作ログが出力される契機

付録K.5　操作ログを出力するための設定

付録K.6　操作ログに出力されるメッセージの一覧

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

付録L.1　09-10の変更内容

付録L.2　09-00の変更内容

付録L.3　08-50の変更内容

付録L.4　08-11の変更内容

付録L.5　08-10の変更内容

付録L.6　08-00の変更内容

付録L.7　07-51の変更内容

付録L.8　07-50の変更内容

付録L.9　07-11の変更内容

付録L.10　07-10の変更内容

付録L.11　07-00の変更内容

付録M　用語解説

索引

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

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

前書き

■ 対象製品

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

P-242C-6L94　 JP1/Base　 09-50（適用OS：Windows Server 2003，Windows Server 2003（x64），Windows XP Professional）
P-282C-6L94　 JP1/Base　 09-50（適用OS：Windows Server 2003（IPF））
P-2A2C-6L94　 JP1/Base　 09-50（適用OS：Windows Vista，Windows Server 2008 Datacenter，Windows Server 2008 Enterprise，Windows Server 2008 Standard，Windows 7）
P-2D2C-6L94　 JP1/Base　 09-50（適用OS：Windows Server 2008（IPF））
P-1J2C-6L91　 JP1/Base　 09-50（適用OS：HP-UX（IPF））
P-9D2C-6L91　 JP1/Base　 09-50（適用OS：Solaris（SPARC））
P-9E2C-6L91　 JP1/Base　 09-50（適用OS：Solaris（x86），Solaris（x64））
P-1M2C-6L91　 JP1/Base　 09-50（適用OS：AIX）
P-9S2C-7L91　 JP1/Base　 09-50（適用OS：Linux AS 4（x86），Linux ES 4（x86），Linux 5（x86），Linux 5 Advanced Platform（x86），Linux AS 4（AMD64 & Intel EM64T），Linux ES 4（AMD64 & Intel EM64T），Linux 5（AMD/Intel 64），Linux 5 Advanced Platform（AMD/Intel 64））
P-9V2C-6L91　 JP1/Base　 09-50（適用OS：Linux 5（IPF），Linux 5 Advanced Platform（Intel Itanium））

これらの製品は，ISO9001およびTickITの認証を受けた品質マネジメントシステムで開発されました。

■ 輸出時の注意

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

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MicrosoftおよびHyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
POSIXは，the Institute of Electrical and Electronics Engineers, Inc. (IEEE)で制定された標準仕様です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
Sun Microsystemsは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Visual C++は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows NTは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
XPG4は，X/Open Company Limitedの規格名称です。
プログラムプロダクト「P-9D2C-6L91」，「P-9E2C-6L91」には，Oracle Corporationまたはその子会社，関連会社が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-6L91」，「P-9E2C-6L91」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。

■ 発行

2011年7月　3020-3-R71-30

■ 著作権

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

変更内容

変更内容(3020-3-R71-30，3020-3-R72-30，3020-3-R73-30)　JP1/Base　09-50

追加・変更内容
変更個所

適用OSを追加した。
Windows 7，Linux 5 Advanced Platform（x86），Linux 5 Advanced Platform（AMD/Intel 64），Linux 5 Advanced Platform（Intel Itanium）
－

JP1/BaseがISO9001の認証を受けたため記述を追加した。
－

イベントログトラップ機能で，Windows VistaおよびWindows Server 2008で追加されたイベント種別に対応した。
運用ガイド：1.5.2
メッセージ：－
関数リファレンス：－

コマンドで収集および配布できるイベントサービスの定義情報に，ログファイルトラップ起動定義ファイルを追加した。
運用ガイド：1.6.3(2)
メッセージ：－
関数リファレンス：－

複数LAN接続の環境の場合に使用するIPアドレスについて，説明を追加および変更した。
運用ガイド：1.10，4.3.3，14. jp1hosts定義ファイル
メッセージ：－
関数リファレンス：－

JP1/Baseのインストール先フォルダのデフォルトおよび権限設定について説明を追加した。
運用ガイド：2.2.1，2.2.3(1)
メッセージ：－
関数リファレンス：－

ユーザー管理機能に関するデフォルト値の，JP1ユーザーが所有する権限に，JP1_ITSLM_AdminおよびCosminexus_vMNG_Adminを追加した。
運用ガイド：2.2.1，2.3.1
メッセージ：－
関数リファレンス：－

パスワードの保護を強化する場合に，パスワードの保管形式を変更する手順を追加した。
運用ガイド：2.4.2
メッセージ：－
関数リファレンス：－

共通定義情報を更新する操作を追加した。
運用ガイド：3.4.1(3)，3.5.1(3)
メッセージ：－
関数リファレンス：－

イベントサーバ設定ファイル（conf）のportsパラメーターに指定するIPアドレスについての注意事項を追加した。
運用ガイド：3.4.3(1)
メッセージ：－
関数リファレンス：－

クラスタソフトにJP1/Baseのサービスを登録するときの注意事項を追加した。
運用ガイド：3.4.4
メッセージ：－
関数リファレンス：－

ネットワーク構成に応じて通信設定が必要となる場合について，また，その際に設定する定義ファイルについて，説明を追加および変更した。
運用ガイド：4.3.3，4.7，4.8，12.2.1(7)，付録H
メッセージ：－
関数リファレンス：－

jbssetcnfコマンドの実行時に指定する通信方式設定ファイルを変更した。
運用ガイド：4.6
メッセージ：－
関数リファレンス：－

イベントサービスを停止する場合の注意事項を追加した。
運用ガイド：5.1.3
メッセージ：－
関数リファレンス：－

連携するディレクトリサーバを一時的に変更する手順を追加した。
運用ガイド：6.2.1(2)
メッセージ：－
関数リファレンス：－

JP1/Baseが動作しているマシンのIPアドレスを変更したときに必要な作業について，手順を変更した。
運用ガイド：12.2.2
メッセージ：－
関数リファレンス：－

ログファイルトラップ管理サービス（デーモン）の状態を確認するコマンドを追加した。
運用ガイド：13. コマンド一覧，13. jevlogdstat
メッセージ：－
関数リファレンス：－

jbs_start.clusterコマンドの実行時に出力されるメッセージを抑止する手順を追加した。
運用ガイド：13. jbs_start.cluster（UNIX限定）
メッセージ：－
関数リファレンス：－

次のコマンドの戻り値を訂正した。
jbsadduser，jbschgpasswd，jbslistuser，jevexport，jevlogreload
運用ガイド：13. jbsadduser，13. jbschgpasswd，13. jbslistuser，13. jevexport，13. jevlogreload
メッセージ：－
関数リファレンス：－

jevdef_distribコマンドの-sオプションを追加し，ログファイルトラップ起動定義ファイルの定義情報を配布できるようにした。
運用ガイド：13. jevdef_distrib
メッセージ：－
関数リファレンス：－

jevdef_getコマンドの-sオプションを追加し，ログファイルトラップ起動定義ファイルの情報を収集できるようにした。また，-rオプションを追加し，特定のホストから個別に定義情報を収集できるようにした。
運用ガイド：13. jevdef_get
メッセージ：－
関数リファレンス：－

jevlogstartコマンドの-xオプションを追加し，ログファイルをJP1イベント化したときの拡張属性JP1_SOURCEHOSTに，ログデータの出力元ホスト名を設定できるようにした。
また，-sオプションの指定時に大文字および小文字が区別されることを記載した。
運用ガイド：13. jevlogstart
メッセージ：－
関数リファレンス：－

起動順序定義ファイルのパラメーターに，スペースを含むバッチファイル名を指定する場合の注意事項を追加した。
運用ガイド：14. 起動順序定義ファイル（Windows限定）
メッセージ：－
関数リファレンス：－

各行の先頭のパラメーター名だけでなく，#（0x23）の前にも空白などが入れられないことを記載した。
運用ガイド：14. イベントサーバインデックスファイル，14. イベントサーバ設定ファイル，14. 転送設定ファイル，14. API設定ファイル
メッセージ：－
関数リファレンス：－

イベントサーバ設定ファイルのclient-bindパラメーターに，複数のアドレスが指定されている場合の注意事項を記載した。
運用ガイド：14. イベントサーバ設定ファイル
メッセージ：－
関数リファレンス：－

ログファイルトラップ動作定義ファイルのACTDEFパラメーターの形式を訂正した。
運用ガイド：14. ログファイルトラップ動作定義ファイル
メッセージ：－
関数リファレンス：－

Windows VistaおよびWindows Server 2008の場合に，ログの種類を記述するときの注意事項を追加した。
運用ガイド：14. イベントログトラップ動作定義ファイル（Windows限定）
メッセージ：－
関数リファレンス：－

配布定義ファイルにログファイルトラップ起動定義ファイルを追加した。
運用ガイド：14. 配布定義ファイル
メッセージ：－
関数リファレンス：－

ディレクトリサーバ連携定義ファイル（Windows限定）の形式を訂正した。
運用ガイド：14. ディレクトリサーバ連携定義ファイル（Windows限定）
メッセージ：－
関数リファレンス：－

次のJP1イベントを追加した。
00003A30，00003A31，00003A32
運用ガイド：15.2，15.3(7)，15.3(8)，15.3(9)
メッセージ：－
関数リファレンス：－

JP1イベント「00003A71」のPP名を，リモート監視のイベントログトラップの場合とJP1/Baseのイベントログトラップの場合に分けた。
運用ガイド：15.3(10)
メッセージ：－
関数リファレンス：－

「動作定義ファイルのACTDEFパラメーターに指定されている値」をIDとするJP1イベントのPP名を，リモート監視のログファイルトラップの場合とJP1/Baseのログファイルトラップの場合に分けた。また，ホスト名を追加した。
運用ガイド：15.3(13)
メッセージ：－
関数リファレンス：－

インストール時に出力するログファイルを追加した。
運用ガイド：付録A.1(2)
メッセージ：－
関数リファレンス：－

ログファイルトラップおよびイベントログトラップのリモート監視ログを追加した。
運用ガイド：付録A.1(2)，付録A.2(2)
メッセージ：－
関数リファレンス：－

jbs_killall.clusterコマンドトレースログのファイル名を変更した。
運用ガイド：付録A.2(2)
メッセージ：－
関数リファレンス：－

jbscomd_api.exeのプロセス数を訂正した。
運用ガイド：付録B.1
メッセージ：－
関数リファレンス：－

UNIXの場合のプロセスにjelallogを追加した。
運用ガイド：付録B.2
メッセージ：－
関数リファレンス：－

jp1bscomのファイアウォールの通過方向を追加した。
運用ガイド：付録C.2
メッセージ：－
関数リファレンス：－

JP1/SESイベントを使用する場合の注意事項について，Windows Server 2008のV5互換機能の制限を追加した。
運用ガイド：付録J.3(2)
メッセージ：－
関数リファレンス：－

操作ログを出力するための設定手順を変更した。
運用ガイド：付録K.5(1)
メッセージ：－
関数リファレンス：－

次のメッセージを追加した。
KAJP1146-E，KAJP1147-E，KAJP1156-W，KAJP1157-W，KAVA1692-I，KAVA3414-I，KAVA3415-I，KAVA3416-I，KAVA3417-E，KAVA3418-E，KAVA3663-E，KAVA3903-E，KAVA3904-E，KAVA3905-E，KAVA3906-E，KAVA3907-E，KAVA3908-I，KAVA3909-W，KAVA3910-E，KAVA3911-W，KAVA3912-I，KAVA3913-E，KAVA3914-E，KAVA3915-W，KAVA3916-W，KAVA3917-E，KAVA3918-W
運用ガイド：－
メッセージ：1.2.1，1.2.2，1.2.4，1.4(2)，1.5.1，1.5.2，1.5.3，1.5.4
関数リファレンス：－

次のメッセージを削除した。
KNAM4414-W
運用ガイド：－
メッセージ：1.2.16，1.5.16
関数リファレンス：－

次のメッセージの対処方法を変更した。
KAJP1053-E，KAVA1498-W
運用ガイド：－
メッセージ：1.5.1，1.5.2
関数リファレンス：－

次のメッセージを変更した。
KAVA3639-E，KAVA3640-W，KNAM4408-W，KNAM4410-W，KNAM4412-W
運用ガイド：－
メッセージ：1.5.4，1.5.16
関数リファレンス：－

HP-UX（PA-RISC）のコンパイラー情報を削除した。
運用ガイド：－
メッセージ：－
関数リファレンス：2.1.1(2)，2.2.3

（凡例）

運用ガイド：マニュアル「JP1 Version9 JP1/Base 運用ガイド」

メッセージ：マニュアル「JP1 Version9 JP1/Base メッセージ」

関数リファレンス：マニュアル「JP1 Version9 JP1/Base 関数リファレンス」

－：該当なし。

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

今版（3020-3-R71-30）では，前版（3020-3-R71-20）の内容の一部を移動し，目次構成を変更しました。前版との対応は次のようになっています。

旧（3020-3-R71-20） | 新（3020-3-R71-30）
3.4.5　共通定義情報変更時の作業 | 3.6　クラスタ運用中の設定変更時の作業
3.5.5　共通定義情報変更時の作業 | 3.6(1) 共通定義情報を変更した場合
3.4.6　論理ホストの削除 | 3.7.1　論理ホストの削除（Windowsの場合）
3.5.6　論理ホストの削除 | 3.7.2　論理ホストの削除（UNIXの場合）

はじめに

このマニュアルは，JP1/Baseの機能および操作方法について説明したものです。なお，このマニュアルは各OS共通のマニュアルです。OSごとに差異がある場合は，本文中でそのつど内容を書き分けています。

対象読者

次の方を対象としています。

JP1/Baseを導入および運用するシステム管理者。

JP1/Baseを前提とするJP1製品（JP1/Integrated Management，JP1/Automatic Job Management System 2または3，JP1/Power Monitorなど）を使ったシステムを導入，構築および運用するシステム管理者またはシステムオペレーター。

マニュアルの構成

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

第1編　概要編

JP1/Baseの概要および機能について説明しています。

第2編　構築編

JP1/Baseのインストールとセットアップの方法について説明しています。クラスタシステムでJP1/Baseを運用する場合や，複数ネットワークでJP1/Baseを運用する場合の設定方法についても説明しています。

第3編　運用・操作編

JP1/Baseの各機能の設定方法や操作方法について説明しています。

第4編　リファレンス編

JP1/Baseで使用できるコマンド，JP1/Baseの定義ファイル，JP1/Baseが出力するイベントについて説明しています。

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

JP1/Baseでトラブルが発生したときの原因と対処について説明しています。

関連マニュアル

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

JP1/Base関連

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

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

JP1/IM関連

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

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

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

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

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

JP1 Version 9 JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス（3020-3-R80）

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

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

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

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/AJS関連

JP1 Version 9 JP1/Automatic Job Management System 3 入門（3020-3-S01）

JP1 Version 9 JP1/Automatic Job Management System 3 導入ガイド（3020-3-S02）

JP1 Version 9 JP1/Automatic Job Management System 3 設計ガイド（システム構築編）（3020-3-S03）

JP1 Version 9 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）（3020-3-S04）

JP1 Version 9 JP1/Automatic Job Management System 3 構築ガイド1（3020-3-S05）

JP1 Version 9 JP1/Automatic Job Management System 3 構築ガイド2（3020-3-S06）

JP1 Version 9 JP1/Automatic Job Management System 3 運用ガイド（3020-3-S07）

JP1 Version 9 JP1/Automatic Job Management System 3 トラブルシューティング（3020-3-S08）

JP1 Version 9 JP1/Automatic Job Management System 3 操作ガイド（3020-3-S09）

JP1 Version 9 JP1/Automatic Job Management System 3 コマンドリファレンス1（3020-3-S10）

JP1 Version 9 JP1/Automatic Job Management System 3 コマンドリファレンス2（3020-3-S11）

JP1 Version 9 JP1/Automatic Job Management System 3 連携ガイド（3020-3-S12）

JP1 Version 9 JP1/Automatic Job Management System 3 メッセージ1（3020-3-S13）

JP1 Version 9 JP1/Automatic Job Management System 3 メッセージ2（3020-3-S14）

JP1 Version 8 JP1/Automatic Job Management System 2 解説（3020-3-K21）

JP1 Version 8 JP1/Automatic Job Management System 2 設計・運用ガイド（3020-3-K22）

JP1 Version 8 JP1/Automatic Job Management System 2 セットアップガイド（3020-3-K23）

JP1 Version 8 JP1/Automatic Job Management System 2 操作ガイド（3020-3-K24）

JP1 Version 8 JP1/Automatic Job Management System 2 コマンドリファレンス（3020-3-K25）

JP1 Version 8 JP1/Automatic Job Management System 2 連携ガイド（3020-3-K27）

JP1 Version 8 JP1/Automatic Job Management System 2 メッセージ（3020-3-K28）

その他

JP1 Version 9 JP1/Power Monitor（3020-3-S33）

JP1 Version 9 JP1/Cm2/SNMP System Observer（3020-3-T11）

JP1 Version 9 JP1/NETM/DM 導入・設計ガイド(Windows(R)用)（3020-3-S79）

JP1 Version 9 JP1/NETM/DM 構築ガイド(Windows(R)用)（3020-3-S80）

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

JP1 Version 9 JP1/NETM/DM 運用ガイド2(Windows(R)用)（3020-3-S82）

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

JP1 Version 9 JP1/NETM/Audit 構築・運用ガイド（3020-3-S90）

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

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

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

VOS3 オープンジョブウェイ支援 JP1/Open Job Entry（6190-3-365）

MVS オープンジョブウェイ支援 JP1/Open Job Entry（9000-3-365）

OSIV/MSP オープンジョブウェイ支援 JP1/Open Job Entry（9000-3-366）

VOS1 オープンジョブウェイ支援（6150-3-377）

VOSK オープンジョブウェイ支援（650-3-416）

JP1/Baseマニュアルの使い分けについて

JP1/Baseのマニュアルは3冊に分かれています。次に示す表で各マニュアルの記載内容をご確認の上，利用目的に合わせてマニュアルをお読みください。

マニュアル名
記載内容

JP1/Base 運用ガイド

JP1/Baseの機能概要

各機能の設定

コマンド，定義ファイル，JP1イベント

トラブルシューティング

プロセス，ポート番号，操作ログ

JP1/Base メッセージ
メッセージ

JP1/Base 関数リファレンス

JP1プログラムやユーザーアプリケーションでJP1イベントを発行・取得する方法

関数

このマニュアルでの表記

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

このマニュアルでの表記 | 正式名称
AIX | AIX | AIX V6.1
AIX V7.1
AIX 5L | AIX 5L V5.3
HNTRLib2 | Hitachi Network Objectplaza Trace Library 2
HP-UX | HP-UX (IPF) | HP-UX 11i V2 (IPF)
HP-UX 11i V3 (IPF)
Java | Java (TM)
JP1/AJS | JP1/AJS | JP1/Automatic Job Scheduler
JP1/AJS - Agent | JP1/Automatic Job Management System 2 - Agent
JP1/Automatic Job Management System 3 - Agent
JP1/AJS - Manager | JP1/Automatic Job Management System 2 - Manager
JP1/Automatic Job Management System 3 - Manager
JP1/AJS - View | JP1/Automatic Job Management System 2 - View
JP1/Automatic Job Management System 3 - View
JP1/AJS2 for Mainframe | JP1/AJS2 - Agent for Mainframe | JP1/Automatic Job Management System 2 - Agent for Mainframe
JP1/AJS2 - Manager for Mainframe | JP1/Automatic Job Management System 2 - Manager for Mainframe
JP1/AJS2 - View for Mainframe | JP1/Automatic Job Management System 2 - View for Mainframe
JP1/AJS - EE | JP1/Automatic Job Scheduler - Enterprise Edition
JP1/AOM | JP1/Automatic Operation Monitor
JP1/AOM - EE | JP1/Automatic Operation Monitor - Enterprise Edition
JP1/Cm2/OAA | JP1/Cm2/Operations Assist Agent
JP1/Cm2/OAM | JP1/Cm2/Operations Assist Manager
JP1/Cm2/SSO | JP1/Cm2/SNMP System Observer
JP1/Performance Management/SNMP System Observer
JP1/Server System Observer
JP1/Integrated ManagementまたはJP1/IM | バージョン8以降の製品
JP1/IM - Central Information Master | JP1/Integrated Management - Central Information Master
JP1/IM - EG for NNMi | JP1/Integrated Management - Event Gateway for Network Node Manager i（バージョン9以降）
JP1/IM - Manager | JP1/Integrated Management - Manager
JP1/IM - Rule Operation | JP1/Integrated Management - Rule Operation
JP1/IM - View | JP1/Integrated Management - View
バージョン7以前の製品
JP1/IM - Central Console | JP1/Integrated Manager - Central Console
JP1/IM - Central Information Master | JP1/Integrated Manager - Central Information Master
JP1/IM - Central Scope | JP1/Integrated Manager - Central Scope
JP1/IM - View | JP1/Integrated Manager - View
JP1/NETM/Audit | JP1/NETM/Audit - Manager
JP1/NETM/DM | JP1/NETM/DM Client | JP1/NETM/DM Client
JP1/NETM/DM Client - Base
JP1/NETM/DM Manager
JP1/OJE | JP1/Open Job Entry
JP1/SES | JP1/System Event Service
Linux | Linux 5 (AMD/Intel 64) | Red Hat Enterprise Linux(R) 5 (AMD/Intel 64)
Linux 5 (IPF) | Red Hat Enterprise Linux(R) 5 (IPF)
Linux 5 (x86) | Red Hat Enterprise Linux(R) 5 (x86)
Linux 5 Advanced Platform (AMD/Intel 64) | Red Hat Enterprise Linux(R) 5 Advanced Platform (AMD/Intel 64)
Linux 5 Advanced Platform (Intel Itanium)またはLinux 5 Advanced Platform (IPF) | Red Hat Enterprise Linux(R) 5 Advanced Platform (Intel Itanium)
Red Hat Enterprise Linux(R) 5 Advanced Platform (IPF)
Linux 5 Advanced Platform (x86) | Red Hat Enterprise Linux(R) 5 Advanced Platform (x86)
Linux AS 4 (AMD64 & Intel EM64T) | Red Hat Enterprise Linux(R) AS 4 (AMD64 & Intel EM64T)
Linux AS 4 (x86) | Red Hat Enterprise Linux(R) AS 4 (x86)
Linux ES 4 (AMD64 & Intel EM64T) | Red Hat Enterprise Linux(R) ES 4 (AMD64 & Intel EM64T)
Linux ES 4 (x86) | Red Hat Enterprise Linux(R) ES 4 (x86)
Microsoft Cluster Server | Microsoft(R) Cluster Server
Microsoft Internet Explorer | Microsoft(R) Internet Explorer
Windows(R) Internet Explorer(R)
NNM | HP NNM | HP Network Node Manager Starter Edition Software バージョン7.5
JP1/Cm2/NNM | JP1/Cm2/Network Node Manager バージョン7(07-10)
JP1/Cm2/Network Node Manager Starter Edition 250 バージョン8(08-00,08-10)
JP1/Cm2/Network Node Manager Starter Edition Enterprise バージョン8(08-00,08-10)
Solaris | Solaris (SPARC) | Solaris 9/10 (SPARC)
Solaris (x64) | Solaris 10 (x64)
Solaris (x86) | Solaris 10 (x86)
Visual C++ | Microsoft(R) Visual C++(R)
Windows7 | Microsoft(R) Windows(R) 7 Enterprise
Microsoft(R) Windows(R) 7 Professional
Microsoft(R) Windows(R) 7 Ultimate
Windows NT | Microsoft(R) Windows NT(R) Server Enterprise Edition Version 4.0
Microsoft(R) Windows NT(R) Server Network Operating System Version 4.0
Microsoft(R) Windows NT(R) Workstation Operating System Version 4.0
Windows Server 2003 | Windows Server 2003 | Microsoft(R) Windows Server(R) 2003, Datacenter Edition
Microsoft(R) Windows Server(R) 2003, Enterprise Edition
Microsoft(R) Windows Server(R) 2003, Standard Edition
Microsoft(R) Windows Server(R) 2003 R2, Datacenter Edition
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition
Windows Server 2003 (IPF) | Microsoft(R) Windows Server(R) 2003, Datacenter Edition for Itanium-based Systems
Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium-based Systems
Windows Server 2003 (x64) | Microsoft(R) Windows Server(R) 2003, Datacenter x64 Edition
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Datacenter x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition
Windows Server 2008 | Windows Server 2008 Datacenter | Microsoft(R) Windows Server(R) 2008 Datacenter
Microsoft(R) Windows Server(R) 2008 R2 Datacenter
Windows Server 2008 Enterprise | Microsoft(R) Windows Server(R) 2008 Enterprise
Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-V
Microsoft(R) Windows Server(R) 2008 R2 Enterprise
Windows Server 2008 Standard | Microsoft(R) Windows Server(R) 2008 Standard
Microsoft(R) Windows Server(R) 2008 Standard without Hyper-V
Microsoft(R) Windows Server(R) 2008 R2 Standard
Windows Server 2008 (IPF) | Microsoft(R) Windows Server(R) 2008 for Itanium(R)-based Systems
Windows Vista | Microsoft(R) Windows Vista(R) Business
Microsoft(R) Windows Vista(R) Enterprise
Microsoft(R) Windows Vista(R) Ultimate
Windows XP | Windows XP Professional | Microsoft(R) Windows(R) XP Professional Operating System

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

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

Linux 5（AMD/Intel 64）およびLinux 5 Advanced Platform（AMD/Intel 64）を総称してLinux 5（AMD/Intel 64）と表記することがあります。

Linux 5（IPF），Linux 5 Advanced Platform（Intel Itanium），およびLinux 5 Advanced Platform（IPF）を総称してLinux 5（IPF）と表記することがあります。

Linux 5（x86）およびLinux 5 Advanced Platform（x86）を総称してLinux 5（x86）と表記することがあります。

プログラムプロダクトの実行中にメッセージなどでプログラムプロダクト名称が表示される場合も略称を使用しています。

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

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

英略語 | 正式名称
AMD | Advanced Micro Devices
API | Application Programming Interface
CSV | Comma Separated Value
DB | Database
DNS | Domain Name System
EUC | Extended Unix Code
FD | Floppy Disk
FQDN | Fully Qualified Domain Name
FTP | File Transfer Protocol
GUI | Graphical User Interface
HTML | Hyper Text Markup Language
IP | Internet Protocol
IPF | Itanium(R) Processor Family
ISAM | Indexed Sequential Access Method
JIS | Japanese Industrial Standards
LAN | Local Area Network
LDAP | Lightweight Directory Access Protocol
NAT | Network Address Translator
NIC | Network Interface Card
NTP | Network Time Protocol
OS | Operating System
OU | Organization Unit
POSIX | Portable Operating System Interface for UNIX
RFC | Request For Comments
SNMP | Simple Network Management Protocol
SSL | Secure Socket Layer
TCP/IP | Transmission Control Protocol/Internet Protocol
UAC | User Account Control
UTC | Universal Time Coordinated
UTF | UCS Transformation Format
WWW | World Wide Web

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

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

記号
意味

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

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

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

記号
意味

｜
(ストローク)
複数の項目に対し，項目間の区切りを示し，「または」の意味を示す。
（例）
「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個以上の空白（空白を省略できない）

数式で使用する記号

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

記号 | 意味
× | 乗算記号を示す。
/ | 除算記号を示す。
Σ | 総和記号を示す。

図中で使用する記号

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

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

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

製品名
インストール先フォルダの表記
デフォルトインストール先フォルダ※

JP1/Base
インストール先フォルダ

x86環境の場合

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

x64環境の場合

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

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

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

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

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

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

このマニュアルでは，原則としてHP-UXのディレクトリ名を使用しています。ただし，シンボリックリンクが設定されているので，HP-UX以外のUNIX系のOSをご使用の方もマニュアルのディレクトリ名を使用できます。

なお，HP-UXとHP-UX以外のUNIX系のOSでディレクトリ名が異なる場合は，それぞれのディレクトリ名を併記しています。

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

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

1.　JP1/Baseの概要

この章では，JP1/Baseの概要と機能について説明します。

＜この章の構成＞

1.1　JP1/Baseの機能概要

1.2　ユーザーを管理する

1.3　サービスの起動順序および終了順序を制御する（Windows限定）

1.4　イベントサービスを使ってJP1イベントを送受信する

1.5　ログメッセージおよびイベントログをJP1イベントに変換する

1.6　定義情報を収集・配布する（JP1/IM限定）

1.7　ヘルスチェック

1.8　ローカルアクション

1.9　各種システム構成への対応

1.10　JP1/Baseの通信方式

1.11　JP1/Baseの互換性

1.1　JP1/Baseの機能概要

JP1/Baseは，JP1/IMを使用した統合管理システムやJP1/AJSを使用したジョブ管理システムの基盤となる製品です。システム内のイベントやJP1ユーザーを管理したり，サービスの起動を制御したりできます。

次に，JP1/Baseが提供する機能を示します。

ユーザー管理
JP1/IM - ManagerやJP1/AJS - Managerなど，JP1のマネージャー製品がインストールされた各ホストにユーザーがアクセスする権限，および各ホスト上にあるJP1資源（ジョブ，ジョブネット，イベントなど）に対して操作する権限を管理します。OSのアカウントとは別に，独立して管理され，ユーザーごとに他ホストに対する操作権限を詳細に管理できるため，セキュリティを強化できます。

サービスの起動管理（Windows限定）
サービスの起動順序や終了順序を制御します。なお，終了順序を制御する場合，JP1/Power Monitorが必要です。

イベントサービス
システムで何らかの事象が発生したときにJP1/Baseに通知されるJP1イベントを管理したり，ほかのホストとJP1イベントを送受信したりします。イベントフィルターを使って，重要なイベントだけをマネージャーへ転送することもできます。

イベント変換
ログメッセージやイベントログをJP1イベントに変換します。変換されたJP1イベントは，イベントサービスが提供しているイベントDBに格納され，JP1シリーズのプログラムが発行するJP1イベントと同様に管理できます。イベント変換機能には，次に示す三つの機能があります。

ログファイルトラップ

アプリケーションプログラムのログをJP1イベントに変換します。

イベントログトラップ（Windows限定）

WindowsのイベントログをJP1イベントに変換します。

SNMPトラップ変換

SNMPトラップをJP1イベントに変換します。SNMPトラップ変換機能がサポートするNNMのバージョンについては，「付録I　SNMPトラップを変換する」を参照してください。

定義の収集・配布（JP1/IM用）
JP1/BaseやJP1製品で定義した情報を，JP1/IMで収集・配布できます。この機能を利用すると次のことが行えます。

IM構成管理による定義情報の管理

IM構成管理を使用している場合は，IM構成管理・ビューアーを操作して，JP1/Baseの定義情報を管理できます。IM構成管理はJP1/IM - Manager 09-00で追加された機能です。

IM構成管理によるサービスの稼働情報の確認

IM構成管理を使用している場合は，IM構成管理・ビューアーを操作して，JP1/Baseのサービスの稼働情報を確認できます。

コマンドによるイベントサービスの定義情報の収集と配布

IM構成管理を使用していない場合は，JP1/Baseが提供するコマンドを実行して，転送設定ファイル（forward）およびイベント変換で使用する定義ファイルの定義情報を収集・配布できます。

JP1製品の定義情報の収集

JP1/AJSのジョブネット定義やJP1/Cm2/SSO定義など，JP1製品が管理する定義情報を収集できます。収集された定義情報はJP1/IMの監視対象としてJP1/IMで管理されます。詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」を参照してください。

プロセス管理
JP1/Baseの起動，停止などの動作を制御します。以下の機能を制御します。

ユーザー管理

定義情報収集・配布

ヘルスチェック

ローカルアクション

構成管理
JP1/IMのシステム構成を管理します。

コマンド実行
JP1/IMから要求されたコマンドを実行します。

サービス管理制御
JP1/IMの構成管理のエージェント機能を制御します。

プロセス間通信
JP1/IMの構成管理とサービス管理制御との通信などで使用する通信基盤です。

ヘルスチェック
JP1/Baseの各プロセスを監視し，プロセスにハングアップなどの異常が生じた場合にメッセージやJP1イベントで通知します。この機能を使用すると，プロセスの異常を早期に検知できます。また，異常が発生したプロセスを容易に特定できるため，異常時の影響を最小限に抑えた対処ができます。

ローカルアクション
特定のJP1イベントを契機に，自動的にコマンドを実行します。障害発生時などに，メール送信や電話連絡などのコマンドを実行してシステム管理者に通知したり，再起動などの処置を実行できます。

ISAMファイル関連のユーティリティコマンド
JP1/Baseでは，ISAMを利用する場合に役立つユーティリティコマンドを提供しています。このコマンドの詳細については，「13.　コマンド」を参照してください。

統合トレース機能（HNTRLib2）
JP1/Baseを前提とする製品（JP1/IMやJP1/AJS）を含めた動作処理の流れをトレースします。トレースした結果は，ログ情報として保管され，障害が発生した場合などの原因究明に役立ちます。

JP1/Baseが提供する各機能は，OSによってはサポートされていない機能もあります。OSごとのサポート状況を次の表に示します。

表1-1　OSによるJP1/Baseの各機能サポート状況一覧（Windowsの場合）

機能一覧 | OS
Win | Win(V) | Win(2003IPF) | Win(2008IPF)
ユーザー管理 | ユーザー認証 | ○ | ○ | ○ | ○
ディレクトリサーバによるユーザー認証※1 | ○ | ○ | － | －
ユーザーマッピング | ○ | ○ | ○ | ○
起動管理 | 起動順序の制御 | ○ | ○ | ○ | ○
終了順序の制御※2 | ○ | ○ | ○ | ○
イベントサービス | ○ | △※3 | △※3 | △※3
イベント変換 | ログファイルトラップ | ○ | ○ | ○ | ○
イベントログトラップ | ○ | ○ | ○ | ○
SNMPトラップ変換 | △※4 | － | － | －
定義収集・配布 | IM構成管理による定義情報の管理・サービスの稼働情報の確認 | ○ | ○ | ○ | ○
コマンドによるイベントサービスの定義情報の収集と配布 | ○ | ○ | ○ | ○
JP1製品の定義情報の収集 | ○ | ○ | ○ | ○
プロセス管理機能 | ○ | ○ | ○ | ○
ヘルスチェック | ○ | ○ | ○ | ○
ローカルアクション | ○ | ○ | ○ | ○
ISAMファイル関連のユーティリティコマンド | ○ | ○ | ○ | ○
統合トレース（HNTRLib2） | ○ | ○ | ○ | ○

（凡例）

Win：Windows XP Professional，Windows Server 2003およびWindows Server 2003（x64）

Win(V)：Windows Vista，Windows 7，Windows Server 2008 EnterpriseおよびWindows Server 2008 Standard

Win(2003IPF)：Windows Server 2003（IPF）

Win(2008IPF)：Windows Server 2008（IPF）

○：サポートしている。

△：一部サポートしていない。

－：サポートしていない。

注※1　連携するディレクトリサーバはActive Directoryです。

注※2　終了順序を制御したい場合，JP1/Power Monitorが必要です。

注※3　IPF版JP1/Baseでは，バージョン5のJP1/SESから環境設定やコマンドを移行するためのツール（jevmkcompatコマンド，jevconfcopyコマンド）は提供していません。また，バージョン5互換用イベントの受信はサポートしていますが，送信はサポートしていません。

注※4　Windows XP ProfessionalおよびWindows Server 2003で動作するJP1/Baseだけサポートしています。

表1-2　OSによるJP1/Baseの各機能サポート状況一覧（UNIXの場合）

機能一覧
OS

HP
(IPF)
Sol(G)
Sol(N)
AIX
Lin
Lin
(IPF)

ユーザー管理
ユーザー認証
○
○
○
○
○
○

ディレクトリサーバによるユーザー認証※1
－
－
－
－
－
－

ユーザーマッピング
○
○
○
○
○
○

起動管理※1
起動順序の制御
－
－
－
－
－
－

終了順序の制御
－
－
－
－
－
－

イベントサービス
△※2
○
△※3
○
○
△※2

イベント変換
ログファイルトラップ
○
○
○
○
○
○

イベントログトラップ※1
－
－
－
－
－
－

SNMPトラップ変換
○
△※4
－
－
－
－

定義収集・配布
IM構成管理による定義情報の管理・サービスの稼働情報の確認
○
○
○
○
○
○

コマンドによるイベントサービスの定義情報の収集と配布
○
○
○
○
○
○

JP1製品の定義情報の収集
○
○
○
○
○
○

プロセス管理機能
○
○
○
○
○
○

ヘルスチェック
○
○
○
○
○
○

ローカルアクション
○
○
○
○
○
○

ISAMファイル関連のユーティリティコマンド
○
○
○
○
○
○

統合トレース（HNTRLib2）
○
○
○
○
○
○

（凡例）

HP(IPF)：HP-UX（IPF）

Sol(G)：Solaris大域ゾーン

Sol(N)：Solaris非大域ゾーン

AIX：AIX

Lin：Linux AS 4（x86），Linux ES 4（x86），Linux AS 4（AMD64 & Intel EM64T），Linux ES 4（AMD64 & Intel EM64T），Linux 5（x86）およびLinux 5（AMD/Intel 64）

Lin(IPF)：Linux 5（IPF）

○：サポートしている。

△：一部サポートしていない。

－：サポートしていない。

注※1　UNIXではサポートしていません。

注※2　IPF版JP1/Baseでは，バージョン5のJP1/SESから環境設定やコマンドを移行するためのツール（jevmkcompatコマンド，jevconfcopyコマンド）は提供していません。

注※3　ユーザーアプリケーションの再コンパイルが必要です。バージョン5互換用イベントは使用できません。

注※4　Solaris（SPARC）だけサポートしています。

1.2　ユーザーを管理する

JP1/IM，JP1/AJSなどのJP1製品では，さまざまなOSが混在する分散システムで安全に運用するために，専用アカウントであるJP1ユーザーを使用しています。JP1/Baseは，JP1ユーザーを管理します。

JP1/Baseのユーザー管理には，次に示す二つの機能があります。

ユーザー認証

ユーザーマッピング

ユーザー認証については1.2.1～1.2.4，ユーザーマッピングについては1.2.5で説明します。

＜この節の構成＞

1.2.1　ユーザー認証とは

1.2.2　ユーザー認証圏とは

1.2.3　認証サーバ

1.2.4　ディレクトリサーバと連携してログイン認証をする（Windows限定）

1.2.5　ユーザーマッピングとは

1.2.1　ユーザー認証とは

ユーザー認証では，ビューアー（JP1/IM - View，JP1/AJS - Viewなど）からマネージャー（JP1/IM - Manager，JP1/AJS - Managerなど）へのログイン要求を確認し，ログインしたJP1ユーザーが，ジョブやジョブネットなどJP1で扱う資源（JP1資源）に対してどのような操作ができるかを設定・管理できます。JP1資源へのアクセス可否や操作権限は，認証サーバ上でJP1ユーザーごとにまとめて管理・制御されます。

認証サーバにいつ接続されるかについては，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。

ユーザー認証の各機能について次に説明します。

ログイン認証

ユーザーがJP1/IM - ViewやJP1/AJS - Viewなどのビューアーからログインする際，不正なユーザーによるアクセスを防止するためログイン認証を行います。ユーザーがログイン時に入力したJP1ユーザー名およびパスワードが，あらかじめ登録されたJP1ユーザー名およびパスワードに合致するかどうかを確認します。通常，JP1ユーザー名およびパスワードは認証サーバに登録され，ログイン認証は認証サーバ上で行います。

なお，Windowsの場合，ディレクトリサーバと連携してログイン認証できます。ディレクトリサーバと連携したログイン認証については，「1.2.4　ディレクトリサーバと連携してログイン認証をする（Windows限定）」を参照してください。

JP1資源に対する操作権限の管理

ログインしたすべてのJP1ユーザーが，システム上に存在するJP1資源に対してあらゆる操作を実行できるのは，セキュリティ上問題があります。そのため，JP1ユーザーごとに，JP1資源に対するアクセス権限および操作権限を制御する必要があります。

JP1ユーザーがどのJP1資源にアクセスできるかは， JP1資源をグループ化したJP1資源グループに対して設定します。

例えば，JP1/AJSでは，ジョブやジョブネットなどのJP1資源を幾つかのグループに分けたものをJP1資源グループとして扱います。JP1/IMでは，JP1/IMの各種設定をJP1資源グループとして扱います。

また，JP1資源グループへのアクセスを許可されたJP1ユーザーが，JP1資源グループに対してどのような操作ができるかを，JP1権限レベルとして設定します。

jp1user1が，JP1/AJS - Managerにログインする場合のユーザー認証の例を，次の図に示します。

図1-1　ユーザー認証の例

マネージャーホストでは，どのホストにインストールされたJP1/Baseを認証サーバとして参照するか指定しておきます。認証サーバは，JP1/Baseがインストールされたホストであれば，どのホストでもかまいません。認証サーバに他ホストを指定した場合は，他ホストにユーザー認証を要求します。

認証サーバのホストにログインした場合，および認証サーバ以外のホストにログインした場合のユーザー認証の例を，次の図に示します。

図1-2　認証サーバのホストにログインした場合および認証サーバ以外のホストにログインした場合のユーザー認証の例

1.2.2　ユーザー認証圏とは

ユーザー認証をする際に同一の認証サーバを参照しているホストの集まりを，ユーザー認証圏といいます。ユーザー認証圏は，認証サーバが管理するホストの範囲を示しています。ユーザー認証圏を構築するには，JP1/IM - ManagerやJP1/AJS - Managerなどのマネージャー製品がインストールされた各ホストで同じ認証サーバを指定します。

JP1/IM，JP1/AJSを例に説明します。

通常，JP1/IM - ViewからJP1/IM - Managerへ接続する際，またはJP1/AJS - ViewからJP1/AJS - Managerへ接続する際，ログイン認証が必要です。しかし，JP1/IM - ViewからJP1/IM - Managerにログインした状態で，JP1/IM - ViewからJP1/AJS - Viewのモニター画面を呼び出してほかのホストのJP1/AJS - Managerに接続する場合，JP1/AJS - Viewの接続先ホストがJP1/IM - Viewでログインしたホストと同一認証圏内であれば，ログインが不要になります。JP1/AJS - Viewの接続先ホストがJP1/IM - Viewでログインしたホストと異なる認証圏の場合は，そのホストを管理する認証サーバに登録されているJP1ユーザー名でログインする必要があります。

ユーザー認証圏を二つ構築した場合のユーザー認証の例を次の図に示します。

図1-3　ユーザー認証圏を二つ構築した場合のユーザー認証の例

認証サーバの信頼性を高めるための運用例

認証サーバは，システム全体のユーザーを管理する重要なホストです。何らかの理由によって認証サーバに接続できなくなった場合に業務が停止しないように，運用方法を検討する必要があります。認証サーバの信頼性を高めるための運用例を次に示します。

セカンダリー認証サーバを設置する

セカンダリー認証サーバを設置すると，プライマリー認証サーバの障害発生時にセカンダリー認証サーバに切り替えて業務を継続できます。セカンダリー認証サーバについては，「1.2.3　認証サーバ」を参照してください。

認証サーバをクラスタ運用する

JP1/Baseは，クラスタ運用に対応しています。クラスタシステムで認証サーバを使用すると，実行系サーバの障害発生時に待機系サーバに自動的に切り替えて業務を継続できます。クラスタシステムで認証サーバを使用する場合は，「3.　クラスタシステムで運用する場合の設定」を参照してください。

認証サーバへの接続状態を監視する

認証サーバへの接続状態を常時監視すると，認証サーバの停止やネットワーク障害によって認証サーバへ接続できなかった場合に，速やかに検知して対処できます。JP1/Baseでは，認証サーバへ接続できなかった場合に統合トレースログにメッセージを出力するため，このログを監視すると，認証サーバへの接続状態を把握できます。

また，セカンダリー認証サーバを設置した場合には，認証サーバへの接続状態が自動で変更された場合に統合トレースログに通知されるメッセージを，JP1イベントとして発行できます。認証サーバの閉塞状態をJP1イベントで監視したい場合は，「2.4.3　JP1/Baseの障害に備えた設定」を参照してください。

1.2.3　認証サーバ

一つのユーザー認証圏内に認証サーバを2台設置できます。1台は，通常時に利用する認証サーバで，もう1台は，予備として稼働する認証サーバです。通常時に利用する認証サーバをプライマリー認証サーバ，予備として稼働する認証サーバをセカンダリー認証サーバと呼びます。セカンダリー認証サーバを設置した場合，何らかの理由によってプライマリー認証サーバに接続できなかったときに，自動的に接続先をセカンダリー認証サーバに切り替えて，業務の停止を防ぎます。

＜この項の構成＞

(1)　設定

(2)　接続処理の流れ

(1)　設定

セカンダリー認証サーバを設置する場合，各ホスト上でセカンダリー認証サーバとして使用するホストを指定します。また，プライマリー認証サーバとセカンダリー認証サーバで，JP1/Baseのバージョン，JP1ユーザーおよび操作権限の設定が異なっていると，切り替えが発生したときに認証エラーになることがあるため，プライマリー認証サーバの設定情報を，セカンダリー認証サーバにコピーします。

(2)　接続処理の流れ

プライマリー認証サーバへの接続が失敗した場合の接続処理の流れを次の図に示します。

図1-4　プライマリー認証サーバへの接続が失敗した場合の接続処理の流れ

図1-4のように，接続に失敗した認証サーバに接続を試みない状態のことを閉塞状態といいます。閉塞状態かどうかは，GUI（Windows限定）やコマンドで確認でき，閉塞状態であれば閉塞中と表示されます。

認証サーバの状態と接続先認証サーバの選択方法を，次の表に示します。

認証サーバの状態
接続先認証サーバの選択方法

プライマリー認証サーバ：閉塞中でない
セカンダリー認証サーバ：閉塞中でない
プライマリー認証サーバへ接続を試みる。

プライマリー認証サーバ：閉塞中
セカンダリー認証サーバ：閉塞中でない
セカンダリー認証サーバへ接続を試みる。

プライマリー認証サーバ：閉塞中でない
セカンダリー認証サーバ：閉塞中
プライマリー認証サーバへ接続を試みる。プライマリー認証サーバとの接続に失敗した場合は，セカンダリー認証サーバへの接続は行わない。

プライマリー認証サーバ：閉塞中
セカンダリー認証サーバ：閉塞中
プライマリー認証サーバへ接続を試み，接続に成功した場合，プライマリー認証サーバの閉塞状態を解除する。
プライマリー認証サーバとの接続に失敗した場合は，セカンダリー認証サーバに接続を試み，接続に成功した場合，セカンダリー認証サーバの閉塞状態を解除する。
セカンダリー認証サーバとの接続に失敗した場合は接続エラーとなる。

ユーザーが意図的に両認証サーバを閉塞状態に設定しても，JP1/IM - View，JP1/AJS - Viewのログインなどが行われた場合は，認証サーバに接続しようと試み，接続に成功すると，認証サーバの閉塞状態は解除されます。

両認証サーバへの接続が閉塞状態になると，システム上の業務が停止することになります。そのため，閉塞状態になったことを素早く検知して，閉塞状態となった原因を取り除く必要があります。

閉塞状態になったことを検知する方法として，JP1/Baseでは，認証サーバへの接続状態が自動で変わったときにJP1イベントを発行できます。JP1イベントを発行すると，JP1/IM - Viewなどから，認証サーバへの接続状態を監視できます。デフォルトではJP1イベントは発行されません。JP1イベントを発行したい場合は，「2.4.3　JP1/Baseの障害に備えた設定」を参照してください。

なお，セカンダリー認証サーバに接続中に，プライマリー認証サーバの障害が回復した場合は，手動でプライマリー認証サーバの閉塞状態を解いてください。解除方法については，「6.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）」を参照してください。

注意事項

接続先認証サーバの切り替えが発生するのは，通信障害や認証サーバが起動していなかった場合だけです。実行ユーザーの入力ミスやパスワードミスで切り替えが発生することはありません。

1.2.4　ディレクトリサーバと連携してログイン認証をする（Windows限定）

ユーザー認証のうち，ログイン認証だけをディレクトリサーバで行えます。ディレクトリサーバと連携したログイン認証を，ディレクトリサーバ連携といいます。連携するディレクトリサーバはActive Directoryです。

ディレクトリサーバ連携では，JP1ユーザー名のパスワードはディレクトリサーバが管理します。ディレクトリサーバを利用した業務のパスワード更新作業として，各ユーザーがパスワードを定期的に更新するため，JP1/Baseのシステム管理者はパスワードの更新が不要になります。なお，JP1ユーザー名，JP1資源に対するJP1権限レベルは認証サーバが管理します。ログイン認証後は，JP1製品に対するアクセス権限や操作権限を認証サーバで付与します。

ディレクトリサーバでパスワードが管理されるJP1ユーザーを連携ユーザーといいます。認証サーバでパスワードを含めたすべてが管理されるJP1ユーザーを標準ユーザーといいます。どのJP1ユーザーを連携ユーザー，標準ユーザーとするかは，認証サーバで設定します。

＜この項の構成＞

(1)　設定

(2)　ユーザー認証の流れ

(3)　ディレクトリサーバと連携した場合の注意事項

(1)　設定

ディレクトリサーバ連携はデフォルトで無効に設定されています。ディレクトリサーバと連携するためには，共通定義の設定を変更する必要があります。設定の詳細については，「6.2　ディレクトリサーバと連携してログイン認証をする場合の設定（Windowsの場合）」を参照してください。

設定を変更したあと，ディレクトリサーバとの接続状態および設定内容をコマンドで確認できます。また，ディレクトリサーバがトラブルのために使用できなくなった場合，コマンドを使って一時的に接続先を切り替えられます。

(2)　ユーザー認証の流れ

ディレクトリサーバと連携してログイン認証をする場合の，ユーザー認証の流れを次の図に示します。

図1-5　ディレクトリサーバと連携したユーザー認証の例

(3)　ディレクトリサーバと連携した場合の注意事項

JP1/Baseの認証サーバでの認証処理のほかに次の処理が発生するため，ログイン認証に時間が掛かることがあります。

認証サーバとディレクトリサーバ間の通信

ディレクトリサーバでのログイン認証

なお，認証サーバとディレクトリサーバ間の通信はLDAPプロトコルが使用されます。

1.2.5　ユーザーマッピングとは

JP1ユーザーが他ホストに対してジョブやコマンドを実行する際，ジョブやコマンドを実行するホスト上のOSユーザー権限が必要になります。そのため，ジョブやコマンドを実行したいホスト上でJP1ユーザーとOSユーザーを対応づける必要があります。これをユーザーマッピングといいます。ユーザーマッピングでは，次に示す三つの内容を対応づけて設定します。

どのJP1ユーザーからの実行命令を許可するか

どのサーバホストからの実行命令を許可するか

ジョブやコマンドをどのOSユーザーの権限で実行するか

ユーザーマッピングの例を，JP1/AJSとJP1/IMの場合に分けて次の図に示します。

図1-6　ユーザーマッピングの例

JP1/AJSの場合

JP1/AJS - ViewからJP1/AJS - Managerにログインする場合には，JP1/AJS - Managerがインストールされたホスト上でもJP1ユーザーとOSユーザーをマッピングする必要があります。そのため，HostA（マネージャーホスト）およびHostB（ジョブを実行するエージェントホスト）でユーザーマッピングの設定が必要です。詳細については，マニュアル「JP1/Automatic Job Management System 2 セットアップガイド」，「JP1/Automatic Job Management System 3 構築ガイド1」，および「JP1/Automatic Job Management System 3 構築ガイド2」を参照してください。

JP1/IMの場合

JP1/IM - Viewからの操作でHostD（エージェントホスト）でコマンドを実行するため，HostDでユーザーマッピングの設定が必要です。また，HostEで自動アクションを実行するため，HostEでユーザーマッピングの設定が必要です。

なお，自動アクションを実行するユーザーは，JP1/IM - Manager上で定義します。

JP1ユーザーに，管理者権限のあるOSユーザーをマッピングすると，操作権限の設定に関係なく，すべてのJP1資源を操作できます。このため，JP1ユーザーに対してJP1資源に対する操作制御をしたい場合は，JP1ユーザーに管理者権限以外の権限を持つOSユーザーをマッピングしてください。

UNIXの場合は，OSユーザー名だけでOSユーザーとして実行できますが，Windowsの場合は，OSユーザー名とパスワードが必要なため，OSユーザーのパスワードも管理します。このため，WindowsでOSユーザーのパスワードを変更した場合，JP1/Baseのパスワード情報も変更してください。

1.3　サービスの起動順序および終了順序を制御する（Windows限定）

JP1/IMやJP1/AJSなど，JP1/Baseを前提とする製品のサービスは，JP1/Baseのサービスの起動後に起動する必要があります。また，JP1イベントを発行する製品のサービスも，JP1/Baseのサービスの起動後に起動する必要があります。JP1/Baseのサービスが起動する前にJP1イベントが発行された場合，JP1/Baseに登録できないためです。

JP1/Baseでは，JP1シリーズ製品，およびJP1以外の製品のサービスの起動・終了順序を詳細に管理できます。

なお，サービスを終了させたい場合，同一マシン上にJP1/Power Monitorがインストールされている必要があります。JP1/Power Monitorの詳細については，マニュアル「JP1/Power Monitor」を参照してください。

起動時には，まず起動管理サービス（JP1/Base Control Service）が起動し，その後，起動順序定義ファイル（JP1SVPRM.DAT）での記述順に，各サービスが起動されます。起動順序定義ファイル（JP1SVPRM.DAT）で指定した時間を過ぎてもサービスが起動しなかった場合は，次のサービスが起動されます。また，すべてのサービスが起動したあとに実行するコマンド名を指定することもできます。

JP1/Power Monitorからのシャットダウン時には，起動時と逆の順序で各サービスが終了したあと，起動管理サービスが終了します。この場合には，各サービスが終了したあとに実行するコマンド名を指定できます。

デフォルトでは，JP1/Base，JP1/IM，JP1/AJSの順番でサービスが起動するように設定されています。JP1/IMまたはJP1/AJSを使用しない場合には，Windowsイベントログにエラーメッセージが出力されるため，起動順序定義ファイル（JP1SVPRM.DAT）を編集してください。

1.4　イベントサービスを使ってJP1イベントを送受信する

システム内の各ホスト上では，「ディスク容量が不足しています」「通信エラーが発生しました」など，さまざまな事象が発生します。JP1/Baseでは，このような事象のうち，JP1/Baseに通知される事象をJP1イベントとして管理できます。

JP1/Baseのイベントサービスでは，次のことができます。

JP1イベントをイベントDBに保存する。
JP1/Baseに通知されたJP1イベントは，イベントDBというファイルに蓄積されます。イベントDBは，各ホストのJP1/Baseに存在します。

JP1イベントをほかのホストへ転送する。
各ホストで発生したJP1イベントを上位の管理サーバへ転送できます。転送したいJP1イベントの条件を指定して，重要なJP1イベントだけを上位の管理サーバへ転送できます。これによって，各ホストの状態を管理サーバで監視したり，対処の必要な事象が発生した場合に管理サーバ上で素早く検知して対処したりできます。
また，JP1イベントの転送が，ネットワークの障害や転送先イベントサーバの停止によって失敗した場合，自動的に転送をリトライできます。

バージョン5以前の製品であるJP1/SESおよびJP1/AJSのイベントサービス機能との上位互換性を持つ（一部機能を除く）。
UNIX上のバージョン5以前の製品であるJP1/SESが発行するイベント，およびWindows NT上でバージョン5以前の製品であるJP1/AJSのコマンドを使用して発行するイベントも取得できます。

これらの機能を，イベントサーバというプログラムが管理しています。イベントサーバを起動すると，JP1イベントを送受信できる状態になります。

＜この節の構成＞

1.4.1　JP1/Baseが取得するJP1イベントの種類

1.4.2　イベントDBの概要

1.4.3　JP1イベントの転送

1.4.1　JP1/Baseが取得するJP1イベントの種類

JP1/Baseが取得できるJP1イベントを次に示します。

JP1の各プログラムが発行するJP1イベント

JP1の各プログラムが発行するJP1イベントを取得できます。バージョン5以前の製品であるJP1/SESで認識したイベントの属性を拡張したJP1イベントを認識できます。また，バージョン5以前の製品であるJP1/IMが取得できるイベントを取得できます。各イベントの詳細については，各プログラムのマニュアルを参照してください。

バージョン5以前の製品であるJP1/SESおよびJP1/AJSで取得できるイベント（JP1/SES形式のイベント）

UNIX上で，JP1シリーズの各プログラムやユーザーアプリケーションが発行するイベント，ログファイルからのイベント，コンソールメッセージからのイベント，およびsyslogメッセージのイベントを取得できます。また，UNIX上のバージョン5以前の製品であるJP1/SESが発行するイベント，およびWindows NT上のバージョン5以前の製品であるJP1/AJSのコマンドを使用して発行するイベントについても取得できます。

注意事項

JP1イベントの属性には，基本属性と拡張属性がありますが，JP1/SES形式のイベントの属性は，基本属性だけです。JP1/SES形式のイベントをJP1/IMの［イベントコンソール］画面に表示させたい場合，JP1/IMの設定を変更するか，拡張属性を付ける必要があります。詳細については，「付録J.4　JP1/SESイベントをJP1イベントに変換する」を参照してください。

jevsendコマンドおよびjevsenddコマンドでユーザーがイベントサーバに登録したJP1イベント

jevsendコマンドおよびjevsenddコマンドを実行すると，JP1イベントをイベントサーバに登録できます（jevsenddコマンドは，06-71で新規追加されたコマンドです。jevsenddコマンドを使うと，JP1イベントがイベントサーバに登録されたかどうかを確認できます）。なお，jevsendコマンドおよびjevsenddコマンドを使ってイベントサーバに登録したJP1イベントを，JP1/IM - Viewの［イベントコンソール］画面に表示させたい場合は，拡張属性の項目「重大度」を指定する必要があります。コマンドの詳細については，「13.　コマンド」の「jevsend」および「jevsendd」を参照してください。

また，JP1イベント発行関数を使うと，JP1イベントをユーザーアプリケーションから直接発行でき，逆にJP1イベント取得関数を使って，JP1イベントをユーザーアプリケーションで直接取得できます。詳細については，マニュアル「JP1/Base 関数リファレンス」を参照してください。

アプリケーションプログラムのログファイル

アプリケーションプログラムのログファイルに出力される情報をJP1イベントに変換して取得できます。変換方法については，「9.1　アプリケーションプログラムのログファイルを変換する」を参照してください。

Windowsのイベントログ

Windowsのイベントログに出力される情報をJP1イベントに変換して取得できます。変換方法については，「9.2　Windowsのイベントログを変換する」を参照してください。

JP1/Cm2/NNMまたはHP NNMが管理するSNMPトラップ

バージョン8以前のJP1/Cm2/NNMまたはバージョン7.5以前のHP NNMが管理するSNMPトラップをJP1イベントに変換して取得できます。変換方法については，「付録I　SNMPトラップを変換する」を参照してください。

1.4.2　イベントDBの概要

イベントDBとは，JP1/Baseがインストールされたホストで発生したJP1イベントを蓄積するファイルです。イベントDBは次のファイルで構成されています。

データ（IMEvent0.dat，IMEvent1.dat）

インデックス（IMEvent0.idx，IMEvent1.idx）

転送情報（IMEvent0.fwd，IMEvent1.fwd）

重複防止テーブル（IMEvent.rep）

イベントサービスのサービスが起動すると，これらのファイルが自動生成されます。データ，インデックス，転送情報はそれぞれ二つずつ生成されます。最初に一方のファイルが使用され，それがイベントサーバ設定ファイル（conf）のdb-sizeパラメーターで指定した容量に達すると，もう一方のファイルに切り替わります。二つ目のファイルの容量がいっぱいになると，一つ目のファイルの内容がすべて削除されたあとに新しくJP1イベントが蓄積されます。

イベントDBが切り替わる流れを次の図に示します。

図1-7　イベントDBが切り替わる流れ

イベントDBが切り替わるタイミングは，イベントDBの容量がイベントサーバ設定ファイルに指定した容量に達した場合，またはJP1イベントの保管期限がイベントサーバ設定ファイルに指定した期限に達した場合です。また，コマンドを使って意図的に切り替えることもできます。

イベントDBの内容は，JP1/IM - Viewの［イベントコンソール］画面から確認したり，コマンドを使ってcsvファイルに出力して確認したりできます。JP1/IM - Viewについては，マニュアル「JP1/Integrated Management - Manager 運用ガイド」を参照してください。イベントDBの内容をcsv出力する方法については，「8.3　イベントDBの内容をcsvファイルに出力する」を参照してください。

＜この項の構成＞

(1)　イベントDBの破損を検知するタイミング

(2)　重複登録チェック機能

(3)　重複防止テーブル

(1)　イベントDBの破損を検知するタイミング

イベントDBを直接編集したり，イベントサービスの稼働中に，OSのコマンドやバックアップ用のソフトウェアでイベントDBをバックアップおよびリストアしたりすると，イベントDBを破損するおそれがあるためご注意ください。

JP1/Baseは，次に示すタイミングでイベントDBが破損したかどうかを検知します。

イベントサービスの起動時

JP1イベントの転送時

イベント取得関数によるJP1イベント取得時※

JP1/IM - Viewからのイベント検索時※

注※

イベントDBのアクティブ面，スタンバイ面ごとに，1回だけメッセージが出力されます。イベントDBのアクティブ面が破損した場合，アクティブ面に登録されているJP1イベントを取得または検索すると，破損を通知するメッセージが1回だけ出力されます。スタンバイ面が破損した場合も同様です。

メッセージをJP1/IM - View上で確認したい場合は，メッセージをJP1イベントに変換して，マネージャーホストへ転送してください。イベント変換の詳細については，「9.　イベント変換の設定」を参照してください。

(2)　重複登録チェック機能

イベントサービスには，イベントDBに同一のJP1イベントが重複して登録されることを防止するため，重複登録チェック機能があります。重複登録チェックを行わないと，次の場合にJP1イベントが重複して登録されるおそれがあります。

転送されたJP1イベントを送受信するホスト間で通信障害が発生した場合

複数ホストに転送するJP1イベントの再転送先ホストが集約されている場合

JP1イベントの転送経路が循環している場合

(3)　重複防止テーブル

重複防止テーブルは，重複登録チェック機能を行うためのテーブルです。重複防止テーブルは，転送元ホストごとの転送実績レコードを記録し，転送されたJP1イベントを受信した場合に，レコードを追加したり更新したりします。

重複防止テーブルは，イベントサーバ設定ファイル（conf）のoptionsパラメーターにsave-repフラグを指定した場合，ファイルに保持します。save-repフラグを指定しない場合，メモリーに保持します。転送されたJP1イベントを受信するイベントサーバでは，ファイルに保持する場合とメモリーに保持する場合で動作に違いがあるため，ファイルに保持して運用することを推奨します。

重複防止テーブルをファイルに保持する場合と，メモリーに保持する場合の動作の違いを次に示します。

ファイルに保持する場合

重複防止テーブルを不揮発的に保持します。このため，イベントサーバを再起動しても，クリアされません。重複防止テーブルに記録されていない転送元ホストからJP1イベントを受信した場合は，転送実績がないと判断してすぐに登録します。転送されたJP1イベントの登録に必要な時間は，転送実績に関係なく一定になります。

メモリーに保持する場合

重複防止テーブルを揮発的に保持します。このため，イベントサーバを再起動すると，クリアされてしまいます。重複防止テーブルに記録されていない転送元ホストからJP1イベントを受信した場合は，過去の転送実績をイベントDBから検索し，そのあと重複防止テーブルに登録します。転送されたJP1イベントの登録に必要な時間は，転送実績により変化します。

また，新たに追加したエージェントから転送されたJP1イベントを受信した場合には，イベントDBに登録されているすべてのJP1イベントに対して検索が行われるため，JP1イベントを使用する処理が遅延する場合があります。遅延する時間はイベントDBのサイズに比例して長くなります。

1.4.3　JP1イベントの転送

JP1/Baseでは，各ホストで発生したJP1イベントをJP1/IM - Managerで定義したシステム構成に従って上位のホストに転送できます。発生したJP1イベントのうち，障害通知や警告情報などの重要なJP1イベントだけを転送することもできます。

上位のホストに転送するJP1イベントの条件（イベントフィルター）は，転送設定ファイル（forward）で定義します。デフォルトでは，JP1/IM - Managerで定義した階層に従って，重要なJP1イベントが上位の管理サーバに転送されるように設定されています。

エージェントからサブマネージャー，サブマネージャーからマネージャーにJP1イベントを転送していく例を次の図に示します。

図1-8　イベントフィルターを使ったJP1イベントの転送例

マネージャーホストに転送されたJP1イベントは，JP1/IM - Viewで確認できます。JP1/IM - Viewからマネージャーホストにログインし，転送されたJP1イベントを確認することでシステム全体の状況を監視できます。また，障害を通知するJP1イベントに対して自動アクションを実行し，回復処理をすることもできます。

JP1イベントの転送のリトライ

一時的なネットワークの障害や転送先のイベントサービスの停止などによって，JP1イベントの転送に失敗した場合，デフォルトでは転送をリトライします。リトライする期間やリトライ間隔などの設定は，イベントサーバ設定ファイル（conf）で行います。

1.5　ログメッセージおよびイベントログをJP1イベントに変換する

JP1/Baseのイベントサービスでは，ログメッセージおよびイベントログをJP1イベントに変換して管理できます。JP1/Baseで使用できるイベント変換を次に示します。

ログファイルトラップ

アプリケーションプログラムのログファイルに出力される情報をJP1イベントに変換します。

イベントログトラップ（Windows限定）

Windowsのイベントログに出力される情報をJP1イベントに変換します。

なお，バージョン8以前のJP1/Cm2/NNMまたはバージョン7.5以前のHP NNMが管理するSNMPトラップをJP1イベントに変換する場合は，「付録I　SNMPトラップを変換する」を参照してください。

＜この節の構成＞

1.5.1　アプリケーションプログラムのログファイルを変換する

1.5.2　Windowsのイベントログを変換する

1.5.1　アプリケーションプログラムのログファイルを変換する

アプリケーションプログラムのログファイルの情報をJP1イベントに変換してイベントDBに登録する流れを次の図に示します。

図1-9　アプリケーションプログラムのログファイルの変換から登録までの流れ

ログファイルトラップを使用するには，ログファイルトラップ動作定義ファイルを作成し，監視するログファイルの出力形式と，JP1イベントに変換したいログデータの条件を指定します。その後，コマンドを実行すると，ログファイルトラップ管理サービス（デーモン）を基盤としてログファイルトラップが生成され，ログファイルを監視します。監視条件に一致するログデータがあると，JP1イベントに変換してイベントDBに登録します。複数のログファイルトラップを同時に起動できるため，さまざまなログファイルを異なる条件で監視できます。また，一つのログファイルトラップで複数のログファイルを監視することもできます。

JP1イベントとして登録できるメッセージは，デフォルトでは511バイトまでです。JP1イベントに変換するメッセージが511バイトを超えた場合，以降のメッセージを切り捨てます。メッセージの長さを拡張したい場合は，jevlogstartコマンドで-mオプションに値を指定すると，1,023バイトまで登録できます。

ログファイルトラップを使用する場合は，次の条件が必要です。

次に示すファイルの文字コードやコマンドを実行した時のロケール情報（LANGなどの言語種別）がすべて統一されていること。

ログファイルトラップの対象となるログファイル

ログファイルトラップ動作定義ファイル

jevlogstartコマンド

文字コード，およびロケール情報が統一されていない場合は，文字化けやログファイルトラップが生成されないなどの現象が発生することがあります。

イベントサービス，およびログファイルトラップ管理サービス（デーモン）が起動していること。
Windowsの場合，イベントサービス，およびログファイルトラップ管理サービスは，システムの起動時に自動的に起動するようにデフォルトで設定されています。
UNIXの場合，それぞれサービスの起動コマンドを実行する必要があります。サービスの起動方法については「5.2　JP1/Baseを起動および終了する（UNIXの場合）」を参照してください。

ログファイルトラップの起動と終了

jevlogstartコマンド，およびjevlogstopコマンドを使用します。ログファイルがまだ存在しない場合でも，jevlogstartコマンドに-rオプションを指定すると，ログファイルが作成されるまでログファイルトラップを待機させられます。

また，ログファイルトラップ起動定義ファイルを使用すると，ログファイルトラップ管理サービス（デーモン）の起動時に，自動的にログファイルトラップを起動できます。ログファイルトラップ起動定義ファイルを使用した場合のログファイルトラップの起動の流れを次に示します。

図1-10　ログファイルトラップ起動定義ファイルを使用した場合のログファイルトラップの起動の流れ

ログファイルトラップ起動定義ファイルには，起動するログファイルトラップおよび起動オプション（jevlogstartコマンドで指定する内容）を指定します。ログファイルトラップ管理サービス（デーモン）起動時に，ログファイルトラップ起動定義ファイルが読み込まれ，起動定義ファイルに指定されているログファイルトラップが自動的に起動されます。

なお，ログファイルトラップを個別に停止したり，個別に動作定義ファイルを再読み込みしたりする場合は，ログファイルトラップを起動したときに標準出力される識別用のID番号，またはログファイルトラップを起動したときに設定した監視名を指定してコマンドを実行してください。

ログファイルトラップで変換されたJP1イベントの属性については，「15.3(13)　動作定義ファイルのACTDEFパラメーターで指定されたイベントIDの詳細」を参照してください。

＜この項の構成＞

(1)　監視できるログファイル

(2)　監視できるログファイル数

(3)　監視の開始と終了

(4)　ログファイルの監視失敗時のリトライ

(5)　イベントサービスへの接続失敗時のリトライ

(1)　監視できるログファイル

ログファイルトラップは，サイズが2ギガバイトまでのログファイルを監視できます。また，さまざまな形式のログファイルを監視できます。監視対象のログファイルの形式を確認して，ログファイルトラップ動作定義ファイルにログファイルの形式を指定します。監視できるログファイルの形式を説明します。

シーケンシャルファイル（SEQ）
一つのログファイルに追加書き込みし続けるファイル，または，ログファイルが一定の容量に達すると，別のファイル名で新たにログファイルを作成して書き込むファイルです。ログファイルトラップ動作定義ファイルには「SEQ」と指定します。シーケンシャルファイル（SEQ）の動作を次の図に示します。

図1-11　シーケンシャルファイル（SEQ）の動作

シーケンシャルファイル（SEQ2）

Windowsの場合
同一ボリューム内でファイル名を変更したあと，変更前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

UNIXの場合
ファイル名を変更，またはファイルをいったん削除したあと，変更／削除前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

ログファイルトラップ動作定義ファイルには「SEQ2」と指定します。シーケンシャルファイル（SEQ2）の動作を次の図に示します。

図1-12　シーケンシャルファイル（SEQ2）の動作

ラップアラウンドファイル（WRAP1）
ログファイルが一定の容量に達すると，ラップアラウンドして，再び先頭からデータを上書きする形式のファイルです。ログファイルトラップ動作定義ファイルには「WRAP1」と指定します。
なお，WRAP1の形式のログファイルを監視する場合，監視するファイルの容量と同じサイズの空きディスク容量が必要です。ラップアラウンドファイル（WRAP1）の動作を次の図に示します。

図1-13　ラップアラウンドファイル（WRAP1）の動作

ラップアラウンドファイル（WRAP2）
ログファイルが一定の容量に達してラップアラウンドするとき，データを削除して再び先頭からデータを書き込む形式のファイルです。ログファイルトラップ動作定義ファイルには「WRAP2」と指定します。ラップアラウンドファイル（WRAP2）の動作を次の図に示します。

図1-14　ラップアラウンドファイル（WRAP2）の動作

マルチプロセス対応トレースファイル（HTRACE）
Cosminexusなどの日立のミドルウェア製品が出力するログファイルの形式の一つで，複数のプロセスが一組のトレースファイルを共有するメモリマップドファイルを使用した固定サイズのファイルです。ログファイルトラップ動作定義ファイルには「HTRACE」と指定します。ログファイルの書き込み方法はWRAP1と同様で，ログファイルが一定の容量に達すると，ラップアラウンドして，再び先頭からデータを上書きします。データの書き込み時にファイルの更新日時は更新されません。監視対象のログファイルがマルチプロセス対応トレースファイルかどうかは，各製品のマニュアルを参照してください。マルチプロセス対応トレースファイル（HTRACE）の動作を次の図に示します。

図1-15　マルチプロセス対応トレースファイル（HTRACE）の動作

ログファイルトラップでは，シンボリックリンクが設定されたファイルも監視できます。ただし，リンク先の変更に対応できるログファイルの形式はSEQ2だけです。

なお，次に示すログファイルは監視できません。

毎回ファイルの先頭からログ情報が記録されるファイル

ラップアラウンドファイル（WRAP1）のうち，データが書き込まれても日時が更新されないファイル，およびデータが書き込まれないのに日時が更新されるファイル
ラップアラウンドファイル（WRAP1）を監視する場合，ログファイルトラップがログファイルを読み込む際に，更新日時を参照します。このようなファイルを監視すると，ログファイルトラップが正常に動作しないことがあります。

スペシャルファイル，デバイスファイル
ログファイル中の1行の終了文字以外でバイナリーデータを含むレコードがあるファイルです。

ファイル名が特定できないファイル
プロセスIDなど，ファイル名にその時々に応じて値が変わるものを含んでいるファイルです。

ネットワークファイル
他コンピュータのファイルを，ファイル共有などでアクセスした場合，ネットワークの障害や遅延の際に動作を保証できません。

1行だけ出力されるログファイル
ログファイルに常に1行しかログが存在しないファイルです。

排他されるファイル
ログファイルトラップは，ログファイルを読み込みモードで開きます。このため，Windowsではログの出力プログラムが排他に失敗し，ログが出力されないことがあります。

JP1/Baseがサポートしていない言語で出力されるファイル
JP1/BaseがWindowsでサポートしている言語はMS932とCです。JP1/BaseがUNIXでサポートしている言語については「2.3.5(2)　言語種別の設定」を参照してください。

(2)　監視できるログファイル数

WindowsおよびUNIXで監視できるログファイル数の目安を次に示します。

Windowsの場合

監視できるログファイル数の最大値は次の式に従います。

（凡例）

a：監視するログファイルの総数（同一ファイルでも加算する）

b：JP1/AJSのログファイル監視ジョブで監視するログファイルの総数（同一ファイルでも加算する）

m：jevlogstartコマンドの実行数

n：JP1/AJSのログファイル監視ジョブの実行数

UNIXの場合

一つのログファイルトラップで監視できる監視ファイルの最大数は100ですが，UNIXのシステム上で監視できる監視ファイルの最大数は，カーネルパラメーターの設定（ファイルオープン数の設定）次第となります。

(3)　監視の開始と終了

ログファイルの監視は，jevlogstartコマンドを実行してログファイルトラップが起動した時点で開始し，一定の間隔で監視を続けます。デフォルトの監視間隔は10秒です。監視間隔は，jevlogstartコマンドの-tオプションで変更できます。ログファイルの監視が終了するタイミングは，jevlogstopコマンドのオプションの指定によって異なります。コマンドの詳細については，「13.　コマンド」を参照してください。

ログファイルトラップを再起動した場合，ログファイルトラップの停止後から，次に起動するまでの間に出力されたログは監視されません。

(4)　ログファイルの監視失敗時のリトライ

ログファイルの更新元プログラムがログファイルを更新するタイミングと，ログファイルトラップがログファイルを監視するタイミングが競合すると，ログファイルの更新元プログラムによってログファイルに排他が掛けられ，ログファイルのオープンや読み込みに失敗する場合があります。このように，一時的に監視に失敗した場合に，監視をリトライします。

なお，一つのログファイルトラップで複数のログファイルを監視する場合，一つのログファイルの監視に失敗すると，そのログファイルに対してはリトライを行い，ほかのログファイルの監視は続行します。

リトライによって監視を回復できなかった場合は，該当のログファイルの監視を停止します。エラーメッセージで示されるログファイルに異常がないかどうかを確認してください。監視に失敗したログファイルを再度監視したい場合は，jevlogstartコマンドでログファイルトラップを新たに起動してください。

監視の開始時にログファイルをオープンできなかった場合と，監視中にログファイルの読み込みに失敗した場合のリトライの動作について次に説明します。

(a)　監視開始時にログファイルのオープンに失敗した場合

jevlogstartコマンドでログファイルトラップを起動するとき，監視対象のログファイルをオープンします。このとき，ログファイルの更新元プログラムなどによって排他が掛けられていると，ログファイルをオープンできないため監視を開始できません。このような場合，デフォルトでは1秒後に1回リトライします。リトライ間隔およびリトライ回数は，ログファイルトラップ動作定義ファイルで設定できます。

リトライによってログファイルのオープンに成功した場合は，オープンに成功した時点から監視が開始されます。

指定した回数リトライしてもログファイルをオープンできなかった場合，またはリトライ開始から3,600秒経過してもオープンできなかった場合は，エラーメッセージおよびJP1イベント（00003A20）で通知します。JP1イベントの詳細については，「15.3(4)　イベントID：00003A20の詳細」を参照してください。

監視開始時に，一時的にログファイルのオープンに失敗した場合のリトライの例を次の図に示します。図の例では，リトライ間隔が1秒，リトライ回数が3回の場合の動作を示します。

図1-16　監視開始時にログファイルのオープンに失敗した場合のリトライの例

(b)　監視中にログファイルの読み込みに失敗した場合

ログファイルの監視中にログファイルの読み込みに失敗した場合は，10ミリ秒間隔で5回リトライします。5回リトライしても回復しなかった場合は，次の監視のタイミングまで待機します。次の監視タイミングでも読み込みに失敗すると，再度10ミリ秒間隔で5回リトライします。リトライ間隔とリトライ回数は固定です。

10ミリ秒間隔で5回のリトライを1セットとしてカウントし，デフォルトでは100セットまでリトライを繰り返します。何セットまでリトライを繰り返すかは，リトライを継続する回数のしきい値としてログファイルトラップ動作定義ファイルで設定できます。

指定した回数リトライが行われても回復しない場合は，該当のログファイルの監視が停止し，JP1イベント（00003A21）で通知します。JP1イベントの詳細については，「15.3(5)　イベントID：00003A21の詳細」を参照してください。

監視中にログファイルの読み込みに失敗した場合のリトライの例を次の図に示します。図の例では，リトライを継続する回数のしきい値を3回に設定した場合の動作を示します。

図1-17　ログファイルの読み込みに失敗した場合のリトライの例

(5)　イベントサービスへの接続失敗時のリトライ

ログファイルトラップがイベントサービスに接続できなかった場合，デフォルトでは，接続はリトライされないで，ログファイルトラップは起動に失敗または停止します。接続をリトライしたい場合は，ログファイルトラップ動作定義ファイルに，ログファイルトラップごとに設定します。指定した回数リトライが行われてもイベントサービスに接続できなかった場合，ログファイルトラップは起動に失敗，または停止します。

リトライ中に変換されたJP1イベントは，指定した件数まで保留されます。指定した件数を超過してJP1イベントが発生すると，超過したJP1イベントは消去されます。

イベントサービスへの接続に成功すると，保留された順番にJP1イベントをイベントサービスに送信します。また，イベントサービスに接続できたことをJP1イベントで通知します。JP1イベントの詳細については，「15.3(3)　イベントID：00003A10の詳細」を参照してください。

1.5.2　Windowsのイベントログを変換する

WindowsのイベントログをJP1イベントに変換してイベントDBに登録する流れを次の図に示します。

図1-18　Windowsのイベントログの変換から登録までの流れ

イベントログトラップを使用するには，イベントログトラップ動作定義ファイル（ntevent.conf）を作成し，JP1イベントに変換したいログデータの条件を指定します。イベントサービス，イベントログトラップサービスの順番でサービスが起動すると，イベントログトラップが生成され，イベントログを監視します。監視条件に一致するイベントログがあると，JP1イベントに変換してイベントDBに登録します。変換されたJP1イベントのイベントIDは，00003A71です。重大度は，変換前のイベントログの種類に対応しています。

イベントサービスは，システムの起動時に自動的に起動するようにデフォルトで設定されていますが，イベントログトラップサービスは自動で起動しません。イベントログトラップサービスを自動起動および自動終了したい場合は，起動管理を使用して，イベントサービスが起動したあとにイベントログトラップサービスが起動するように設定してください。

なお，イベントログトラップの起動時およびイベントログをトラップした際にイベントサービスに接続できなかった場合は，あらかじめイベントログトラップ動作定義ファイル（ntevent.conf）で設定しておくことで接続をリトライできます。

イベントログトラップでは，JP1イベントとして登録できるメッセージは1,023バイトまでです。JP1イベントに変換するメッセージが1,023バイトを超えた場合，1,023バイト以降のメッセージを切り捨てます。JP1イベントの属性については，「15.3(10)　イベントID：00003A71の詳細」を参照してください。

＜この項の構成＞

(1)　監視の開始と終了

(1)　監視の開始と終了

イベントログトラップは，イベントログトラップサービスを起動した時点から終了する時点までに発生したイベントログのうち，監視条件と一致するイベントログを即時にJP1イベントに変換します。また，一時的な障害でイベントログを取得できなかった場合に再度取得できるように，一定の間隔でイベントログを監視します。デフォルトの監視間隔は10秒です。監視間隔は，イベントログトラップ動作定義ファイル（ntevent.conf）で変更できます。

1.6　定義情報を収集・配布する（JP1/IM限定）

JP1/BaseおよびJP1/IMで構成されたシステムでは，定義情報の収集・配布ができます。この機能を利用すると次のことが行えます。

IM構成管理による定義情報の管理

IM構成管理によるサービスの稼働情報の確認

コマンドによるイベントサービスの定義情報の収集と配布

JP1製品の定義情報の収集

＜この節の構成＞

1.6.1　IM構成管理による定義情報の管理

1.6.2　IM構成管理によるサービスの稼働情報の確認

1.6.3　コマンドによるイベントサービスの定義情報の収集と配布

1.6.4　JP1製品の定義情報の収集

1.6.1　IM構成管理による定義情報の管理

IM構成管理を使用している場合は，IM構成管理・ビューアーを操作して，JP1/Baseの定義情報を管理できるようになります。IM構成管理は，JP1/IM - Manager 09-00でサポートされた機能です。IM構成管理・ビューアーでできることを，次に示します。

JP1/Baseの定義ファイルの内容や，現在有効になっている定義情報（各サービスの起動時に使用した定義ファイルの内容）を収集し，内容を確認する

JP1/Baseの定義ファイルを編集して，各ホストのJP1/Baseに配布する

JP1/IMの構成定義ファイルに定義されたホスト以外のJP1/Baseを管理する場合は，JP1/Baseのホストアクセス制限定義ファイルに，アクセスを許可するマネージャーホストを定義しておきます。定義ファイルの詳細については，「14.　定義ファイル」の「ホストアクセス制限定義ファイル」を参照してください。

IM構成管理による定義情報の管理については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」を参照してください。

1.6.2　IM構成管理によるサービスの稼働情報の確認

IM構成管理を使用している場合は，IM構成管理・ビューアーを操作して，JP1/Baseのサービスの稼働情報を確認できるようになります。

IM構成管理によるサービスの稼働情報の確認については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」を参照してください。

IM構成管理を使用していない場合は，JP1/Baseのjbsgetopinfoコマンドによって，自ホストのサービスの稼働情報を確認することもできます。

jbsgetopinfoコマンドについては，「13.　コマンド」の「jbsgetopinfo」を参照してください。

1.6.3　コマンドによるイベントサービスの定義情報の収集と配布

ここでは，コマンドによるイベントサービスの定義情報の収集と配布について説明します。この操作は，IM構成管理を使用していない場合に行います。JP1/IMを使用してシステムの運用監視をする場合，各ホストのJP1/Baseでどの事象をJP1イベントとして管理するか，また，どのJP1イベントを上位ホストに転送するか検討し，定義する必要があります。各ホストのJP1/Baseで定義した情報を一つ一つ確認し，変更する方法もありますが，効率が悪く，定義を誤るおそれがあります。

JP1/Baseでは，各ホストのJP1/Baseで定義した情報をマネージャーホストで一括収集して確認できます。また，マネージャーホストで定義情報を編集し，各ホストのJP1/Baseに配布し，定義情報を更新することもできます。これによって効率良く，イベントサービスに関する定義情報を管理できます。

イベントサービスの定義情報の収集・配布の流れを次の図に示します。

図1-19　イベントサービスの定義情報の収集・配布の流れ

＜この項の構成＞

(1)　イベントサービスの定義情報の収集および配布に必要な条件

(2)　収集および配布できる定義情報

(1)　イベントサービスの定義情報の収集および配布に必要な条件

定義情報の収集および配布に必要な条件を次に示します。

JP1/BaseおよびJP1/IM - Managerをインストールする。
システムの各ホストにインストールする必要のある製品と，製品のバージョンを次に示します。

ホスト | 必要な製品
定義情報を収集・配布するホスト | JP1/Base（バージョン7以降）
JP/IM - Central Console（バージョン7）またはJP1/IM - Manager（バージョン8以降）
定義情報の収集先・配布先ホスト | JP1/Base（バージョン7以降）

定義情報を収集および配布するホストのJP1/IM - Managerでシステム構成を定義する。
定義情報を収集および配布する際，JP1/IM - Managerの構成定義を利用します。システム構成で定義した管理対象ホストが，収集先および配布先となります。システム構成の定義については，マニュアル「JP1/Integrated Management - Manager 構築ガイド」を参照してください。

注意

マネージャーホスト上で，管理対象ホストの定義情報を収集および配布する際，サブマネージャーホストを経由しないで管理対象ホストと直接通信します。マネージャーホストとサブマネージャーホストの間にファイアウォールを設置している場合は，ポート番号20306について，マネージャーホストからすべての管理対象ホストに対して通過できるようにファイアウォールを設定し直してください。また，マネージャーホストと管理対象ホスト間で名前解決できるようにしてください。

(2)　収集および配布できる定義情報

次に示す定義ファイルの定義情報を収集および配布できます。

Windowsの場合

定義ファイル | ファイル名
転送設定ファイル | インストール先フォルダ¥conf¥event¥servers¥default¥forward
共有フォルダ¥jp1base¥event¥forward
ログファイルトラップ動作定義ファイル | インストール先フォルダ¥conf¥任意に指定したファイル
イベントログトラップ動作定義ファイル | インストール先フォルダ¥conf¥event¥ntevent.conf
ログファイルトラップ起動定義ファイル※ | インストール先フォルダ¥conf¥event¥jevlog_start.conf

注※　ログファイルトラップ起動定義ファイルを配布収集する場合，収集元，配布元のホスト，および収集先，配布先のホストにインストールされているJP1/Base のバージョンを09-50以降にする必要があります。

UNIXの場合

定義ファイル
ファイル名

転送設定ファイル

/etc/opt/jp1base/conf/event/servers/default/forward

共有ディレクトリ/event/forward

ログファイルトラップ動作定義ファイル
/etc/opt/jp1base/conf/任意に指定したファイル

ログファイルトラップ起動定義ファイル※
/etc/opt/jp1base/conf/event/jevlog_start.conf

注※　ログファイルトラップ起動定義ファイルを配布収集する場合，収集元，配布元のホスト，および収集先，配布先のホストにインストールされているJP1/Base のバージョンを09-50以降にする必要があります。

1.6.4　JP1製品の定義情報の収集

JP1/IM - Managerのセントラルスコープでは，JP1/AJSで定義した業務（ジョブネット）やJP1/Cm2/SSOで監視する情報など，JP1シリーズ製品が管理する定義情報をツリー形式の監視画面に表示できます。監視画面上の情報は，JP1/IM - Managerで定義したシステム構成に従って自動的に生成されます。自動生成に必要な定義情報は，JP1/Baseの定義収集・配布機能が収集します。

JP1/Baseが収集する定義情報を次に示します。

JP1/AJSで自動実行している業務の情報

JP1/Cm2/SSOで監視しているカテゴリー情報やアプリケーション情報

JP1/PFMで監視しているパフォーマンス情報

詳細については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」を参照してください。

1.7　ヘルスチェック

JP1/Baseのプロセスが無限ループやデッドロックの状態となった場合に，異常を検知してメッセージやJP1イベントを発行し，オペレーターにJP1/Baseの回復を促せます。これを，ヘルスチェック機能といいます。

ヘルスチェック機能を利用した障害対策の流れを，次の図に示します。

図1-20　ヘルスチェック機能を利用した障害対策の流れ

ヘルスチェック機能は，デフォルトでは無効になっています。有効にするには，共通定義情報に登録し，監視対象ホストやプロセスの監視間隔を設定します。設定方法については，「2.4.3　JP1/Baseの障害に備えた設定」を参照してください。

プロセス管理機能を起動すると，プロセスの監視が開始されます。

ヘルスチェック機能で検知できる障害

ヘルスチェック機能で検知できる障害を次に示します。

プロセスのハングアップ
プロセスがハングアップした場合に異常を検知して通知します。ハングアップとは，無限ループやデッドロックなどが原因で，プロセスが処理要求を受け付けなくなる状態を指します。

プロセスの異常終了
プロセス自体が異常と判断して終了した場合に，プロセスの異常を検知して通知します。ただし，OSのkillコマンドなどによってプロセスが強制終了した場合は，異常終了として検知できません。この場合は，プロセスの応答がない状態として異常を検知します。

＜この節の構成＞

1.7.1　ヘルスチェック機能を利用したプロセス監視の仕組み

1.7.2　ヘルスチェック機能を利用した他ホストの監視

1.7.1　ヘルスチェック機能を利用したプロセス監視の仕組み

ヘルスチェック機能は，プロセス自体が異常と判断して終了した場合と，プロセスがハングアップした場合を異常として検知します。プロセスがハングアップしているかどうかは，各プロセスが行っている処理に掛かる時間と，プロセスごとに設定されているしきい値を比較します。各プロセスが行っている処理に掛かる時間は，共有メモリーを介して監視します。

ヘルスチェック機能の概要を次の図に示します。

図1-21　ヘルスチェック機能の概要

ヘルスチェック機能では，業務規模などによって影響を受けにくい，プロセスが行う個々の内部処理を監視単位としています。そのため，異常しきい値や警告しきい値には，カスタマイズする必要のない値が設定されています。

＜この項の構成＞

(1)　監視対象プロセス

(1)　監視対象プロセス

ヘルスチェック機能が監視するプロセスを次の表に示します。

表1-3　ヘルスチェック機能の監視対象のプロセス一覧

項番 | プロセス | プロセス名
1 | プロセス管理 | jbsspmd
2 | 認証サーバ | jbssessionmgr
3 | 構成管理 | jbsroute
4 | コマンド実行 | jcocmd
5 | プラグインサービス | jbsplugin
6 | イベントサービス | jevservice
7 | ログファイルトラップ | jevtraplog
8 | イベントログトラップ（Windows限定） | jevtrapevt
9 | SNMPトラップ変換 | imevtgw
10 | ヘルスチェック | jbshcd，jbshchostd
11 | サービス管理制御 | jbssrvmgr
12 | ローカルアクション | jbslcact
13 | プロセス間通信 | jbscomd

プロセス管理の起動用プロセス（jbs_service），および起動管理（jbapmsrvcecon）は，サービスを起動，停止するだけのプロセスのため監視しません。また，統合トレース機能（hntr2mon）は，JP1/Base以外の製品も使用する機能のため監視しません。

1.7.2　ヘルスチェック機能を利用した他ホストの監視

ヘルスチェック機能は，JP1/Base自身の障害を検知することを目的としていますが，ヘルスチェック機能自体にハングアップなどの異常が生じると，JP1/Baseの障害を検知できなくなります。また，JP1/IM - Managerを利用したシステムでは，イベントサービスに異常が生じると，JP1イベントを発行，および転送できないため，異常を検知しても上位ホストへ通知できなくなります。

JP1/Baseは，自ホストのプロセスの異常を検知，または通知する手段がなくなった場合に備え，他ホストからヘルスチェック機能およびイベントサービスのプロセスの状態を監視できます。1台のホストで1,024台まで監視できます。

JP1/IM - Manager，またはJP1/AJSを利用したシステムでの他ホストの監視方法，および他ホストを監視する場合の運用方法について説明します。

＜この項の構成＞

(1)　JP1/IM - Managerを利用したシステムでの他ホスト監視

(2)　JP1/AJSを利用したシステムでの他ホスト監視

(3)　他ホストを監視する場合の運用方法

(1)　JP1/IM - Managerを利用したシステムでの他ホスト監視

他ホストのJP1/Baseのヘルスチェック機能，およびイベントサービスが正常に稼働しているかどうかを監視できます。

次の図に示す構成例を基に，JP1/IM - Managerを利用したシステムでの他ホストの監視について説明します。

図1-22　JP1/IM - Managerを利用したシステムでの他ホスト監視の例

図の例では，各ホストで次のように設定されています。

ホスト | 役割 | 他ホスト監視の設定
hostA | マネージャーホスト | hostB，hostXを監視する。
hostB | サブマネージャーホスト | hostA，hostY，hostZを監視する。
hostX | エージェントホスト | 設定なし。
hostY | エージェントホスト | 設定なし。
hostZ | エージェントホスト | 設定なし。

エージェントホストhostY，およびマネージャーホストhostAで，ヘルスチェック機能，およびイベントサービスに異常が生じた場合の処理について説明します。

hostYのヘルスチェック機能に異常が生じた場合

hostBのヘルスチェック機能が異常を検知してJP1イベントを発行します。発行されたJP1イベントはhostAに転送され，JP1/IM - ViewにhostYの異常通知が表示されます。

hostYのイベントサービスに異常が生じた場合

hostYのヘルスチェック機能が異常を検知しますが，JP1イベントを発行できないため，hostBのヘルスチェック機能が異常を検知してJP1イベントを発行します。hostBで発行されたJP1イベントはhostAに転送され，JP1/IM - ViewにhostYの異常通知が表示されます。

hostAのヘルスチェック機能に異常が生じた場合

hostBのヘルスチェック機能が異常を検知してJP1イベントを発行します。発行されたJP1イベントはhostAに転送され，JP1/IM - ViewにhostAの異常通知が表示されます。

hostAのイベントサービスに異常が生じた場合

hostAのJP1/IM - Managerでヘルスチェック機能を有効にしている場合は，JP1/IM - Managerのヘルスチェック機能がhostAのイベントサービスの異常を検知し，JP1/IM - ViewにhostAの異常通知が表示されます。

(2)　JP1/AJSを利用したシステムでの他ホスト監視

監視対象ホストを指定すると，他ホストのJP1/Baseのヘルスチェック機能が正常に稼働しているかどうかを監視できます。

JP1/AJSを利用したシステムで，JP1/Baseのプロセスの異常をマネージャーホストに通知したい場合は，JP1/Cm2/OAAおよびJP1/Cm2/NNMを利用して，ヘルスチェック機能がsyslogまたはイベントログに出力するメッセージを監視し，マネージャーホストへ通知してください。

次の図に示す構成例を基に，JP1/AJSを利用したシステムでの他ホストの監視について説明します。

図1-23　JP1/AJSを利用したシステムでの他ホスト監視の例

図の例では，各ホストで次のように設定されています。

ホスト | 役割 | 他ホスト監視の設定
hostA | マネージャーホスト | hostX，hostYを監視する。
hostX | エージェントホスト | hostAを監視する。
hostY | エージェントホスト | 設定なし。

エージェントホストhostX，およびマネージャーホストhostAのヘルスチェック機能に異常が生じた場合の処理について説明します。

hostXのヘルスチェック機能に異常が生じた場合

hostAのヘルスチェック機能が異常を検知し，syslog，またはイベントログにメッセージを出力します。hostAのJP1/Cm2/OAAがsyslog，またはイベントログに出力されたメッセージを検知し，JP1/Cm2/NNMに通知します。JP1/Cm2/NNMに，hostXの異常通知が表示されます。

hostAのヘルスチェック機能に異常が生じた場合

hostXのヘルスチェック機能が異常を検知し，syslog，またはイベントログにメッセージを出力します。hostXのJP1/Cm2/OAAがsyslog，またはイベントログに出力されたメッセージを検知し，JP1/Cm2/NNMに通知します。JP1/Cm2/NNMに，hostAの異常通知が表示されます。

(3)　他ホストを監視する場合の運用方法

他ホストを監視する場合の運用方法について説明します。

(a)　監視対象ホストの数が多い場合の運用方法

1台のホストで複数のホストを監視する場合，ヘルスチェック機能は1台ずつホストのプロセス状況を確認します。1台のホストの監視に掛かる時間は3秒程度です。そのため，1台のホストが監視するホスト数が多いと監視に時間が掛かります。

例えば，1台のホストで200台のホスト監視すると，すべてのホストを監視し終わるまでに600秒程度掛かります。監視時間を短縮したい場合は，監視対象ホストをグループに分け，グループごとに擬似的なマネージャーホストを決めて監視してください。

図1-24　200台のホストを監視する場合の運用例

図の例では監視対象ホストを20台ずつのグループに分けています。また，マネージャーホストhostAから擬似的なマネージャーホストhost1，host21などを監視するよう設定します。グループごとに監視すると，監視に掛かる時間を60秒程度に短縮できます。

(b)　階層管理した構成で障害が発生した場合の運用方法

監視対象ホストを階層管理している構成で，障害が発生した場合の運用方法について次の図で説明します。

図1-25　階層管理している構成で，障害が発生した場合の運用例

hostBのヘルスチェック機能やイベントサービスに障害が発生した場合，hostBが監視しているhostDやhostEの異常を検知，および通知できなくなります。

hostBが短時間で復旧した場合は，hostBの停止中にhostDやhostEで障害が発生してJP1イベントが発行されても，JP1イベントの転送のリトライによって，hostBが回復した時点でJP1イベントが転送されます。hostBの復旧に長時間掛かる場合は，hostBが復旧するまでの間，hostAからhostD，hostEを直接監視するようヘルスチェック定義ファイル（jbshc.conf）を設定し直す必要があります。

このように階層管理している構成では，サブマネージャーホストの障害に備えて，マネージャーホストから直接エージェントホストを監視するよう定義したヘルスチェック定義ファイル（jbshc.conf）をあらかじめ用意しておくと便利です。

(c)　監視間隔の見直し

他ホストを監視する場合は，ヘルスチェック定義ファイル（jbshc.conf）で監視間隔を指定できます。運用を開始する前に試運転をして，指定した監視間隔が妥当かどうか確認してください。このとき，統合トレースログにKAVA7219-Wのメッセージが出力された場合は，指定した監視間隔が短いおそれがあります。「14.　定義ファイル」の「ヘルスチェック定義ファイル」に記載してある見積もり式を参照して，監視間隔を設定し直してください。

(d)　監視対象ホストが停止する場合の運用方法

監視元ホストと監視対象ホストにインストールされているJP1/Baseのバージョンが両方とも09-10以降の場合，監視対象ホストの起動・停止を監視するかどうかを選択できます。監視対象ホストの起動・停止を監視すると，運用上計画的にホストが停止する場合，正常に停止したホストはエラーとして通知されません。

監視対象ホストの起動・停止を監視する場合と監視しない場合の動作の違いを次の図に示します。

図1-26　監視対象ホストの起動・停止を監視する場合と監視しない場合の動作の違い

JP1/Baseが起動・停止した場合，JP1イベントを発行します。エージェントホストの停止通知イベントを受信すると，監視対象ホストの起動・停止を監視する場合は，KAVA7228-Iメッセージを出力します。この場合，停止通知イベントを受信したあとも，指定された監視間隔で接続確認を行いますが，接続できなくても正常な運用と見なし，エラーの通知は行いません。

一方，監視対象ホストの起動・停止を監視しない場合は，起動または停止通知イベントを受信しても，メッセージを出力しません。この場合，停止通知イベントを受信したあとも，通常の監視を行い，接続できない場合はエラーメッセージを出力します。

現在どちらの設定になっているかは，ヘルスチェック（他ホスト監視）を起動したときに出力されるメッセージで確認できます。設定とメッセージの対応を次に示します。

設定 | メッセージ
監視対象ホストの起動・停止を監視する | KAVA7231-I 起動・停止通知イベントの監視をおこないます．
監視対象ホストの起動・停止を監視しない | KAVA7230-I 起動・停止通知イベントの監視をおこないません．

監視対象ホストの起動・停止を監視するかどうかの設定は，ヘルスチェック定義ファイル（jbshc.conf）で変更できます。

1.8　ローカルアクション

エージェントホストで障害発生などのJP1イベントが発行された場合に，登録したコマンドをエージェントホスト内で自動的に実行できます。これを，ローカルアクションといいます。マネージャーとエージェント間のネットワークに掛かる負荷を軽減することができ，マネージャーとエージェント間でネットワーク障害が発生した場合でもコマンドを実行できます。

JP1/BaseのローカルアクションとJP1/IM - Managerの自動アクションとの比較を，次の図に示します。

図1-27　ローカルアクションと自動アクションの比較

ローカルアクションを実行するには，ローカルアクション実行定義ファイルを作成し，どのJP1イベントが発生した場合にどのコマンドを実行するかを指定しておきます。指定したJP1イベントが発生すると，JP1/Baseは発生したJP1イベントに対応するコマンドを自動的に実行します。

ローカルアクションでは，アクション開始イベントおよびアクション完了イベントを発行することもできるため，これらのイベントをマネージャーホストに転送すれば，マネージャーホストでローカルアクションの実行や結果を確認できます。アクションの実行履歴は，ローカルアクション実行履歴ログにも出力されます。

次に，ローカルアクションの詳細について説明します。

＜この節の構成＞

1.8.1　ローカルアクションを実行する条件

1.8.2　ローカルアクションで実行できるコマンド

1.8.3　ローカルアクションの実行状態

1.8.4　ローカルアクションの休止

1.8.1　ローカルアクションを実行する条件

ローカルアクションの実行に必要な条件を次に示します。

エージェントにインストールされているJP1/Baseのバージョンが09-00以降である。

JP1/IMでシステム構成定義が定義され，ローカルアクションを実行するホストに配布されている。

なお，マネージャーおよびサブマネージャーにインストールされているJP1/IM - ManagerおよびJP1/Baseのバージョンがすべて09-00以降で，IM構成管理を使用している場合は，IM構成管理の機能によって，ローカルアクション実行定義ファイルをマネージャーホストで定義し，各エージェントホストに一括配布できます。IM構成管理による定義情報の管理については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」を参照してください。

1.8.2　ローカルアクションで実行できるコマンド

ローカルアクションで実行できるコマンドの形式を次に示します。

Windowsの場合

実行形式ファイル（.com，.exe）

バッチファイル（.bat）

JP1/Scriptのスクリプトファイル（.spt）
（ただし，.sptファイルが実行できるように関連づけが設定されていること）

UNIXの場合

UNIXのコマンド

シェルスクリプト

ただし，次のようなコマンドは実行できません。

対話操作を必要とするコマンド

画面を表示するコマンド

エスケープシーケンスや制御コードを伴うコマンド

デーモンなどの，終了しないコマンド

Windowsメッセージ機構やDDEなど，デスクトップとの対話が必要なコマンド（Windowsの場合）

shutdownやhaltなど，OSをシャットダウンするコマンド

1.8.3　ローカルアクションの実行状態

ローカルアクションは，JP1/Baseの起動時に自動で起動するように設定されています。ローカルアクションが起動すると，自ホストに登録されるJP1イベントを取得し，ローカルアクション実行定義ファイルで指定した条件と比較します。取得したJP1イベントと条件が合致すると，対応するコマンドを実行します。なお，ローカルアクション実行定義ファイルの条件は上から比較するため，優先度の高い条件を上位に定義するようにしてください。

ローカルアクションの実行状態は，jbslistlcactコマンドで確認できます。実行状態には，「実行待ち」および「実行中」があり，これらの状態のアクションはキャンセルすることもできます。また，ローカルアクション実行条件の成立から実行完了までの実行状態の変化は，JP1イベントおよびローカルアクション実行履歴ログで通知します。

ローカルアクションの実行状態を次の図に示します。

図1-28　ローカルアクションの流れと実行状態

実行待ちおよび実行中のローカルアクションの数は，次に示す機能で制御することもできます。

＜この項の構成＞

(1)　同一アクションの抑止

(2)　実行待ちアクション数の制限

(3)　同時実行数の制御

(1)　同一アクションの抑止

一定時間に同じアクションが複数回実行されるのを抑止できます。管理者へのメール通知など，一定時間に一度実行されればよいアクションに使用できます。抑止を設定すると，抑止時間内に条件が成立しても実行待ちにしません。

(2)　実行待ちアクション数の制限

実行待ちにできるアクションの上限値を指定できます。指定した上限値を超えた場合は，条件が成立してもアクションを実行待ちにしません。

(3)　同時実行数の制御

同時に実行できるアクションの上限値を指定できます。指定した上限値を超えていない場合だけ，アクションを実行します。上限値を超えた場合，アクションは実行待ちのままです。

1.8.4　ローカルアクションの休止

ローカルアクションを停止しないで，一時的に休止できます。休止前に実行待ちおよび実行中のローカルアクションはキャンセルされないで，そのまま実行されます。ローカルアクションが休止の間，JP1イベントは取得されないため，新しいローカルアクションが実行待ちになることはありません。また，ローカルアクションの休止が解除された場合，解除時点からJP1イベントを取得して，ローカルアクションを実行します。

1.9　各種システム構成への対応

クラスタシステムへの対応など，各種システム構成へのJP1/Baseの対応について説明します。

＜この節の構成＞

1.9.1　クラスタシステムでの運用

1.9.2　非クラスタ環境での論理ホスト運用

1.9.1　クラスタシステムでの運用

JP1/Baseは，クラスタシステムでの運用に対応しています。

JP1/Baseをクラスタ運用することによって，サーバ障害などが発生した場合でも実行系から待機系に処理を引き継いで，システム運用管理を継続できます。

詳細については，「3.　クラスタシステムで運用する場合の設定」を参照してください。

1.9.2　非クラスタ環境での論理ホスト運用

通常，論理ホストのJP1/Baseは，クラスタシステムでクラスタソフトと連携して運用します。しかし，IPアドレスとディスク領域を用意し，JP1/Baseの論理ホストをセットアップすると，クラスタソフトと連携しなくてもフェールオーバーしない論理ホスト環境でJP1/Baseを運用できます。

詳細については，「3.9　非クラスタ環境で論理ホストを運用する場合の設定」を参照してください。

1.10　JP1/Baseの通信方式

この節では，JP1/Baseの通信方式の概要について説明します。この節および「4.　ネットワーク構成に応じたJP1/Baseの通信設定」で説明する通信に対する考え方は，JP1/Baseを前提とする製品でも同様となります。

JP1/Baseには二つの通信方式があり，インストールした時点，または論理ホストをセットアップした時点で，適切な通信方式が自動で設定されます。

ネットワークの構成や運用方法によっては，通信方式を手動で設定する必要があります。さまざまなネットワーク構成に適したJP1/Baseの通信設定の詳細については，「4.　ネットワーク構成に応じたJP1/Baseの通信設定」を参照してください。

JP1/Baseは通信をする際，ホスト名を意識して動作します。物理ホスト上で動作する場合はhostnameコマンドで返されるホスト名を自ホスト名と認識し，論理ホスト上で動作する場合はクラスタシステム用の設定をした際に指定した論理ホスト名を自ホスト名と認識して動作します。そのため，次の事項にご注意ください。

基本的には代表となるホスト名を一つだけ使用し，複数のエイリアス名による運用は避けてください。

ホスト名に対して割り当てられているIPアドレスを解決できない場合，正しく動作しません。

ホスト名からIPアドレスへの変換，およびIPアドレスからホスト名への変換（逆引き）の両方ができるように設定してください。特に，DNSサーバ（Active Directory含む）で名前解決をする場合は，両方の変換ができるように設定する必要があります。

複数LAN接続の環境の場合，名前解決によって複数のIPアドレスが取得される環境では，送信時に，ホスト名に対応する最優先のIPアドレスが使用されます。

送信をIPバインド方式にしている場合，送信側のIPアドレスは，自ホスト名に対応する最優先のIPアドレスが使用されます。

＜この節の構成＞

1.10.1　推奨する通信方式

1.10.2　ホスト名に対応するIPアドレスの確認方法

1.10.1　推奨する通信方式

JP1/Baseでは，通信でのバインド方式として次に示すバインド方式を推奨しています。

物理ホストだけでJP1/Baseを運用する場合：ANYバインド方式

ANYバインド方式では，IPアドレスを意識しないでポート番号だけを利用して通信を行います。通信の待ち受け処理では，ホストに割り当てられているすべてのIPアドレスあてにきたデータを受信できます。接続処理では，ホストが複数のサブネットを利用している場合でも，すべてのサブネット上のホストにデータを送信できます。

クラスタ運用する場合にANYバインド方式にすると，物理ホストあてのデータを論理ホストで受信したり，論理ホストあてのデータを物理ホストで受信したり，正しく通信できないおそれがあります。

論理ホストを使用する（クラスタ運用する）場合：IPバインド方式

IPバインド方式では，一つのNIC（Network Interface Card）に複数のIPアドレスが割り当てられていているときや，1台のホストにNICが複数あるときなど，ホストが使用するIPアドレスが複数ある場合でも，特定のIPアドレスあてにきたデータだけを受信できます。また，接続処理では，特定のIPアドレスを使用しているNICだけを経由します。

クラスタ運用する場合，1台のホストに物理ホストと論理ホストが混在したり，複数の論理ホストを同時に起動したりすることがあります。このような場合でも，物理ホスト・論理ホストそれぞれのIPアドレスあてにきたデータだけを受信します。

通信方式は，デフォルトではANYバインド方式が設定されています。クラスタ運用する場合は，次に示すクラスタシステム用の設定をしたときに，物理ホストと論理ホストの両方でIPバインド方式が設定されます。

Windowsの場合：GUI（jp1bshasetup.exe）またはコマンド（jbs_setup_clusterコマンド）でクラスタシステム用の設定をしたとき。

UNIXの場合：コマンド（jp1base_setup_clusterコマンド）でクラスタシステム用の設定をしたとき。

注意事項

いったんクラスタシステム用の設定をしたホストでは，論理ホストをすべて削除しても物理ホストの通信方式はANYバインド方式に戻りません。物理ホストだけの運用に戻したい場合は，「4.3.3　通信方式を変更する」を参照して，通信方式をANYバインド方式に戻してください。

一例として，JP1/Baseの通信方式が，ANYバインド方式だった場合とIPバインド方式だった場合で通信の待ち受け処理がどう変わるのか図を使って説明します。

まず，JP1/Baseの通信方式が，ANYバインド方式だった場合の通信の待ち受け処理を次の図に示します。

図1-29　hostAのJP1/BaseがANYバインド方式で起動した場合の待ち受け処理

hostAのNICにはIPアドレス10.0.0.10と10.0.0.11が割り当てられています。なお，hostA自体は自分のホスト名から10.0.0.10でしかIPアドレスの解決ができないと仮定します（実際にOSによっては，一つのホスト名から一つのIPアドレスしか解決できないものがあります）。また，hostXではhostAはIPアドレス10.0.0.10で解決され，hostYではhostAはIPアドレス10.0.0.11で解決されるとします。

hostAでJP1/BaseがANYバインド方式で起動した場合，hostXからもhostYからもデータを受け取れます。ANYバインド方式の場合，IPアドレスを意識しないでポート番号だけを利用して通信をするため，10.0.0.10あてにきたデータも10.0.0.11あてにきたデータも受け取れます。

次に，JP1/Baseの通信方式が，IPバインド方式だった場合の待ち受け処理を次の図に示します。

図1-30　hostAのJP1/BaseがIPバインド方式で起動した場合の待ち受け処理

hostAでJP1/BaseがIPバインド方式で起動した場合，10.0.0.10あてにきたデータだけをJP1/Baseは受け取り，10.0.0.11あてにきたデータを認識できません。これはhostAが，ポート番号が同じでもIPアドレスのあて先が自分と異なるものは受け付けないよう動作するためです。

1.10.2　ホスト名に対応するIPアドレスの確認方法

JP1/Baseで使用したいホスト名がどのIPアドレスを解決できているのか，確認が必要になることがあります。これは，hostsファイルで，一つのホスト名に対し，複数のIPアドレスが割り当てられているよう設定されていても，OSがその設定を有効と認めていない場合があるためです。

JP1/Baseで使用したいホスト名がどのIPアドレスで解決できているのか確認する場合は，次のコマンドを実行してください。

jp1ping ホスト名

jp1pingコマンドの詳細については，「13.　コマンド」の「jp1ping」を参照してください。

1.11　JP1/Baseの互換性

この節では，バージョン9のJP1/Baseとイベントサービス機能で連携できる製品との互換性，また，バージョン9のJP1/Baseと旧バージョンのJP1/Baseとの互換性について説明します。

＜この節の構成＞

(1)　JP1/Baseとイベントサービス機能で連携できる製品との互換性

(2)　旧バージョンのJP1/Baseとの互換性

(1)　JP1/Baseとイベントサービス機能で連携できる製品との互換性

バージョン9のJP1/Baseは，イベントサービス機能を持つ以下に示す製品に対して上位互換を持ち，イベントのやり取りができます。

バージョン5以前の製品JP1/AJS

バージョン5以前の製品JP1/SES

JP1/SESのプロトコルを利用した製品（JP1/OJEなど）

バージョン5以前の製品JP1/IM

上記製品とバージョン9のJP1/Baseとの互換性の詳細については，「付録J　JP1/SESイベントを使用する製品との連携」を参照してください。

(2)　旧バージョンのJP1/Baseとの互換性

バージョン9のJP1/Baseは，旧バージョンのJP1/Baseと互換性を持ちます。ただし，次に示す場合には注意が必要です。

(a)　セカンダリー認証サーバの設置を考えている場合

セカンダリー認証サーバの設置を考え，かつ，同一認証圏にJP1/Base 06-00が存在している場合，次に示す点に注意してください。

JP1/IM - View，JP1/AJS - Viewのログイン先ホストやジョブ管理ホスト（JP1/AJS - Manager）にインストールされたJP1/Baseが06-00の場合

接続先認証サーバが一つに限られるため，認証サーバへの接続に失敗すると，業務が停止してしまいます。なお，ジョブ実行ホストにインストールされたJP1/Baseは，どのバージョンでもかまいません。

JP1/IM - View，JP1/AJS - Viewのログイン先ホストやジョブ管理ホスト（JP1/AJS - Manager）にインストールされたJP1/Baseが06-51以降の場合

接続先認証サーバおよびジョブ実行ホストにインストールされたJP1/Baseは，どのバージョンでもかまいません。

(b)　JP1/IMを使用していて構成定義を変更する場合

JP1/IMを使用していて構成定義を変更する場合，06-51以降のJP1/Baseでは，イベントサービスの転送設定ファイル（forward）が動的に反映（リロード）されますが，JP1/Base 06-00ではリロードされません。このため，JP1/Base 06-00ではイベントサービスを再起動する必要があります。

(c)　JP1/IMを使用していてコマンド実行履歴がある場合

バージョン8で，コマンド実行履歴ファイル（ISAM）の保存形式が変更になりました。そのため，バージョン7以前のJP1/IMを使用していてコマンド実行履歴ファイル（ISAM）がある場合は，JP1/Baseのバージョンアップ後，JP1/IMの運用開始までの間に必ずjcocmdconvコマンドを実行してください。

このコマンドを実行すると，バージョン7以前のJP1/Baseに蓄積されたコマンド実行履歴ファイル（ISAM）を，バージョン8以降のコマンド実行履歴ファイル（ISAM）に移行できます。このコマンドを実行しなかった場合，バージョン7以前に蓄積されたコマンド実行履歴が参照できません。また，クラスタ運用時には，共有ディスクにアクセスできる状態で，実行系か待機系のどちらか一方から論理ホストに対し，jcocmdconvコマンドを1回だけ実行してください。jcocmdconvコマンドの詳細については，「13.　コマンド」の「jcocmdconv」を参照してください。

なお，コマンド実行履歴はマネージャーホスト（JP1/IMと同ホスト）のJP1/Baseだけに作成されます。

(d)　JP1/IM用とJP1/AJS用のJP1ユーザーの操作権限を設定する場合

JP1/IM 08-00とJP1/AJS 08-00では，新たにJP1ユーザーの操作権限が追加されました。新たに追加されたJP1ユーザーの操作権限を設定する場合，認証サーバのバージョンが07-51以前では設定できません。

(e)　JP1/IM用定義情報を収集および配布する場合

イベントサービスの定義情報の収集と配布や，JP1製品の定義情報を収集する場合，収集元，配布元のホスト，および収集先，配布先のホストにインストールされているJP1/Baseのバージョンを07-00以降にする必要があります。

(f)　コマンドの戻り値を参照するシェルスクリプトを使用している場合

JP1/Base 06-71では，次に示すコマンドの戻り値が変更されました。

jbsacllint

jbsaclreload

jbsadduser

jbschgpasswd

jbslistuser

jbsrmuser

06-51以前のJP1/Baseで，上記コマンドの戻り値を参照するシェルスクリプトを使用していた場合，そのシェルスクリプトは，07-00以降のJP1/Baseで正常に動作しなくなるおそれがあります。このため，上記コマンドの戻り値の利用については見直しが必要です。各コマンドの戻り値については，「13.　コマンド」を参照してください。

2.　インストールとセットアップ

この章では，JP1/Baseのインストールとセットアップ，およびバックアップとリカバリーについて説明します。

＜この章の構成＞

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

2.2　インストール（Windowsの場合）

2.3　インストール（UNIXの場合）

2.4　セットアップ

2.5　バックアップとリカバリー

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

JP1/Baseのインストールの開始からシステムの運用開始までの作業の流れについて説明します。

なお，インストールおよびセットアップをするユーザーには，Windowsの場合はAdministrators権限，UNIXの場合はスーパーユーザー権限が必要です。

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

2.2　インストール（Windowsの場合）

この節では，Windows版JP1/Baseのインストール，アンインストール，およびインストール・アンインストール時の注意事項について説明します。

＜この節の構成＞

2.2.1　インストール

2.2.2　アンインストール

2.2.3　インストール・アンインストール時の注意事項

2.2.1　インストール

JP1/Baseをインストールする手順を次に示します。

プログラムを終了する。
JP1/Baseをインストールする前に，JP1の全プログラム，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを終了してください。

提供媒体をCD-ROMドライブに入れる。
起動したインストーラーの指示に従ってインストールを進めてください。
インストール時には，次の項目を設定します。

ユーザー情報

インストール先フォルダ
インストール先フォルダのデフォルトは次のとおりです。
x86環境の場合：
システムドライブ¥Program Files¥Hitachi¥JP1Base
x64環境の場合：
システムドライブ¥Program Files(x86)¥Hitachi¥JP1Base
x64環境の場合，システムドライブ¥Program Files¥配下にはインストールしないでください。64ビットモジュールと混在することによって，動作上問題が発生することがあります。

自動セットアップ処理
新規にインストールする場合だけ，「自動セットアップの選択」画面が表示されます。［セットアップ処理を行う］をチェックすると，自動で初期設定が行われ，インストール完了後すぐに運用できる状態になります。
自動セットアップ処理を行う場合に設定される項目を次の表に示します。

表2-1　ユーザー管理機能に関するデフォルト値

設定項目 | 内容
認証サーバの設定 | 認証サーバ名 | 自ホスト名
JP1ユーザーの設定 | JP1ユーザー名 | jp1admin
パスワード | jp1admin
JP1資源グループ | *
所有する権限 | JP1_AJS_Admin，JP1_JPQ_Admin，JP1_AJSCF_Admin，JP1_HPS_Admin，JP1_PFM_Admin，JP1_Console_Admin，JP1_CF_Admin，JP1_CM_Admin，JP1_Rule_Admin，JP1_ITSLM_Admin，JP1_Audit_Admin，JP1_DM_Admin，JP1_SSO_Admin，Cosminexus_vMNG_Admin
ユーザーマッピングの設定 | OSユーザー名とそのパスワード | OSユーザー名とそのパスワードの入力画面が表示されます。OSユーザー名とパスワードを入力してください。
マッピングするJP1ユーザー名 | jp1admin
サーバホスト名 | *
JP1ユーザーとOSユーザーのマッピング | JP1ユーザー（jp1admin）と登録したOSユーザーをマッピングします。

自動セットアップ処理を行わない場合は，JP1ユーザーの設定だけが行われます。
各設定項目の詳細については，「6.1　ユーザー管理の設定（Windowsの場合）」を参照してください。

プログラムフォルダの選択
インストーラーを実行すると，統合トレース機能（HNTRLib2）もインストールされます。HNTRLib2のインストール先は，次のとおりです。
x86環境の場合：
システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥
x64環境の場合：
システムドライブ¥Program Files(x86)¥Hitachi¥HNTRLib2¥
HNTRLib2のインストール先はシステムドライブ固定です。インストール先を変更することはできません。

システムを再起動する。
JP1/Baseを新規にインストールした場合には，必ずシステムを再起動してください。

JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）について

JP1/Baseは，JP1/NETM/DMを使ったリモートインストールに対応しています。JP1/Baseの場合，次に示すインストールに対応しています。

新規インストール
インストール対象ホストにJP1/Baseを新規にインストールできます。ただし，JP1/NETM/DMを使ったリモートインストールでは，自動セットアップ処理はできません。

バージョンアップインストール
リモートインストールすると，JP1/Baseインストール済みホストのJP1/Baseをバージョンアップできます。

JP1/NETM/DMを使った実際のリモートインストール方法については，マニュアル「JP1/NETM/DM 運用ガイド1(Windows(R)用)」を参照してください。

2.2.2　アンインストール

JP1/Baseをアンインストールする手順を次に示します。

プログラムを終了する。
アンインストールする前にWindowsの［コントロールパネル］の［サービス］から，「JP1/Base」で始まるサービスをすべて停止してください。

SNMPトラップ変換機能を使用していた場合は，SNMPトラップ変換機能の設定を解除する。
詳細については，「付録I.2(5)　設定を解除する」を参照してください。

JP1/Baseを削除する。
Windowsの［コントロールパネル］の［プログラムの追加と削除］から「JP1/Base」を削除してください。

システムを再起動する。
JP1/Baseの動作環境を無効にするために，システムを再起動する必要があります。上記手順の終了後，システムを再起動してください。

ユーザーファイルを削除する。※
JP1/Baseの削除では，インストール後に作成する定義ファイルやログファイルなどは削除されません。
これらのファイルも削除する場合，JP1/Baseをインストールしていたフォルダをエクスプローラで削除してください。

注※　JP1/Baseをアンインストールすると，HNTRLib2が自動的にアンインストールされます。ただし，HNTRLib2を利用するプログラムがほかにある場合は，そのプログラムがすべてアンインストールされた時点でHNTRLib2がアンインストールされます。

2.2.3　インストール・アンインストール時の注意事項

JP1/Baseのインストール・アンインストール時の注意事項を次に示します。

＜この項の構成＞

(1)　インストールについて

(2)　再インストールについて

(3)　アンインストールについて

(4)　Windows環境への設定

(5)　上書きインストールについて

(1)　インストールについて

ほかの製品のインストール先フォルダと同じフォルダにインストールしないでください。

JP1/Baseによって作成される最上位フォルダ（JP1Base），下位フォルダ，およびファイルは，ユーザーが指定したインストール先フォルダの権限を継承します。インストール先フォルダには，次に示す権限（参照，実行，更新）を設定することをお勧めします。

AdministratorsグループおよびSYSTEMアカウント：フルコントロール

Usersアカウント：読み取りと実行

インストール時に，ファイルmsvcrt.dllを置き換えるかどうかを問い合わせるダイアログボックスが表示された場合，必ず［再起動］を選択してファイルを置き換え，インストール後にシステムを再起動してください。「無視」を選択して古いバージョンのmsvcrt.dllを残した場合，イベントの時刻がずれるなど，正しく動作しなくなることがあります。
また，ほかの製品をインストールしたあとに，イベントの時刻がずれるなどの動作不正が発生した場合は，JP1/Baseを再インストールしてください。

JP1/Baseのインストール後にほかの製品で提供されるHNTRLib2を標準インストール先以外にインストールした場合，JP1/Baseをアンインストールしたあとで，インストール先フォルダを削除して再インストールしてください。

(2)　再インストールについて

JP1/Baseを上書きインストールする場合は，「JP1/Base」で始まる名称のサービス，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを必ず終了してください。

JP1/Baseをアンインストールしてから，再インストールする場合には，JP1/BaseおよびJP1/Baseを前提とする製品をすべてアンインストールしたあとに，JP1/Base，JP1/Baseを前提とする製品の順に再インストールをしてください。

JP1/IM - Managerの場合
JP1/IM - Managerもアンインストールしたあと，JP1/BaseおよびJP1/IM - Managerを再インストールしてください。

JP1/AJSの場合
JP1/AJSもアンインストールしたあと，JP1/BaseおよびJP1/AJSを再インストールしてください。

JP1/AJS2 for Mainframeの場合
JP1/AJS2 for Mainframeのサービスを停止してからJP1/Baseをアンインストールしてください。JP1/Baseを再インストールしたあと，JP1/AJS2 for Mainframeを再セットアップしてください。

JP1/Power Monitorの場合
JP1/Power MonitorはJP1/Baseよりも先にアンインストールしてください。そのあと，JP1/BaseおよびJP1/Power Monitorを再インストールしてください。

JP1/IM - Managerを同一ホストにインストールしている場合，JP1/Baseをアンインストールして別のフォルダにJP1/Baseをインストールすると，JP1/IM - Managerが正常に動作しなくなります。
この場合，JP1/IM - Managerをアンインストールして，インストール先フォルダを削除して再インストールしてください。

SNMPトラップ変換機能を利用している場合，JP1/Baseの上書きインストール後に再度，imevtgw_setupコマンドを実行してください。

(3)　アンインストールについて

JP1/Baseをアンインストールした場合，ほかのJP1製品も使用する共通の定義ファイルが削除されるため，ほかのJP1製品が動作できなくなります。

JP1/AJS，JP1/Baseをインストールしたあと，JP1/AJSだけをアンインストールすると，その後イベントサービスが起動しなくなることがあります。この場合，イベントサーバ設定ファイル（conf）のinclude ajs-confパラメーターの行を削除するか，コメント扱い（行の先頭に#を付ける）にしてください。

インストーラーのログとして次のファイルが作成されます。アンインストールが正常終了したあとに削除してください。
Windowsのインストール先フォルダ¥Temp¥HITACHI_JP1_INST_LOG¥jp1base_inst{1|2|3|4|5}.log

(4)　Windows環境への設定

JP1/Baseのインストール時にシステム環境変数（Path変数）に，JP1/Baseのbinフォルダのパスと，統合トレース機能（HNTRLib2）のパスとして日立共通フォルダのパス（システムドライブ¥Program files¥Common Files¥HITACHI）が設定されます。また，servicesファイルに「付録C　ポート番号一覧」に示すポート番号が設定されます。システム環境変数（Path変数）に設定したJP1/Baseのbinフォルダのパス，およびserviceファイルへ設定したポート番号は，JP1/Baseのアンインストールで削除されます。サービス名jp1imcmdaは，JP1/IM - Viewがインストールされている場合，削除しません。削除しない設定情報について不要であれば，削除してください。ただし，サービス名jp1imcmdaは，JP1/IM-Viewがインストールされている場合，削除しないでください。また，日立共通フォルダのパスは統合トレース機能（HNTRLib2）以外の製品でも使用するため，削除の際は十分ご注意ください。

(5)　上書きインストールについて

以前のバージョンの製品を使用している環境に上書きインストールする場合，次の点にご注意ください。

バージョン5のJP1/IMまたはJP1/IM - AgentがインストールされているホストにJP1/Baseをインストールする場合，次に示すサービスを必ず「手動」に変更してからインストールしてください。

JP1/IM Agent

JP1/IM Control Service

JP1/IM Event

JP1/IM Rmiregistry

JP1/Baseをインストールすると，バージョン5のJP1/IM - AgentおよびJP1/IMイベントサービスは動作できなくなります。バージョン5のイベントサービスを起動する場合は，次に示すコマンドを実行してください。

jevmkcompat -u

また，上記コマンドを実行したあと，再びJP1/Baseのイベントサービスを起動する場合は，次に示すコマンドを実行してください。このコマンドを実行しないと，JP1/Baseのイベントサービスに対してイベントを発行できないプログラムがあります。

jevmkcompat -i

JP1/Baseがインストールされている状態で，バージョン5のJP1/IM - AgentおよびJP1/IMをインストールまたはアンインストールした場合も，次に示すコマンドを実行してください。

jevmkcompat -i

JP1/Baseをインストールしたあと，JP1/Baseのイベントサービスを起動して，バージョン5以前のJP1/SESの機能を使用する場合には，次に示すコマンドを実行してください。

jevmkcompat -r

JP1/SESのイベントサービスを起動して，JP1/SESの機能を使用する環境に戻す場合には，次に示すコマンドを実行してください。

jevmkcompat -u

バージョン6のJP1/IM - Central ConsoleまたはJP1/AJSと，バージョン7以降のJP1/Baseは，同一ホストにインストールできません。

バージョン6以前のJP1/Baseにバージョン7以降のJP1/Baseを上書きインストールするとHNTRLib2がインストールされますが，HNTRLibが残ったままになります。不要であれば，HNTRLibを利用するプログラムがないことを確認してからHNTRLibをアンインストールしてください。

07-10以前のJP1/Baseでクラスタシステムをご使用で，07-11以降のJP1/Baseを上書きインストールする場合，上書きインストール後に以下の作業をして，論理ホスト環境の設定のアップグレードをする必要があります。

1.　07-00以降で追加されたプロセスが起動するようにする。

以下の手順で設定ファイルを修正してください。

1-1　以下のファイルのバックアップを取る。

共有フォルダ¥jp1base¥conf¥jp1bs_spmd.conf

共有フォルダ¥jp1base¥conf¥jp1bs_spmd.conf.session

共有フォルダ¥jp1base¥conf¥jp1bs_spmd.conf.original

共有フォルダ¥jp1base¥conf¥jp1bs_service_0700.conf

1-2　以下のファイルを修正し07-00以降で追加されたプロセスが起動するようにする。

共有フォルダ¥jp1base¥conf¥jp1bs_spmd.conf

共有フォルダ¥jp1base¥conf¥jp1bs_spmd.conf.session

共有フォルダ¥jp1base¥conf¥jp1bs_spmd.conf.original

上記ファイルをエディターなどで開き最終行に以下の行を追加します。

07-00および07-10のJP1/Baseをご使用の場合はjbshcd，jbshchostdだけを追加してください。

jbsplugin|C:¥Program Files¥HITACHI¥JP1Base¥bin¥jbsplugind.exe|||60|

jbshcd|C:¥Program Files¥HITACHI¥JP1Base¥bin¥jbshcd.exe|||60|

jbshchostd|C:¥Program Files¥HITACHI¥JP1Base¥bin¥jbshchostd.exe|||60|

太字部分はJP1/Baseがインストールされているフォルダです。これらの記述は，インストール先フォルダ¥conf¥jp1bs_spmd.conf.originalファイルに記載されています。これをコピーして貼り付けてください。

1-3　以下のファイルを修正し07-11以降に追加されたプロセスが起動するようにする。

以下のファイルがない場合は，JP1/Baseサービス起動時に自動で作成されるのでこの手順は不要です。

共有フォルダ¥jp1base¥conf¥jp1bs_service_0700.conf

このファイルをエディターなどで開き最終行に以下の行を追加します。

jbshcd|C:¥Program Files¥HITACHI¥JP1Base¥bin¥jbshcd.exe||0|3|3|21600|

jbshchostd|C:¥Program Files¥HITACHI¥JP1Base¥bin¥jbshchostd.exe||0|3|3|21600|

太字部分はJP1/Baseがインストールされているフォルダです。これらの記述は，インストール先フォルダ¥conf¥jp1bs_service_0700.confファイルに記載されています。これをコピーして貼り付けてください。

2.　07-00以降で追加された定義ファイルをコピーする。

以下の手順で定義ファイルをコピーしてください。

2-1　共有フォルダ¥jp1base¥conf¥配下にpluginフォルダを作成する。

2-2　インストール先フォルダ¥conf¥plugin¥reqforward.confを，共有フォルダ¥jp1base¥conf¥plugin¥配下にコピーする。

2-3　インストール先フォルダ¥conf¥user_acl¥JP1_AccessLevelを，共有フォルダ¥jp1base¥conf¥user_acl¥配下にコピーする。

2-4　共有フォルダ¥jp1base¥conf¥配下にjbshcフォルダを作成する。

2-5　インストール先フォルダ¥conf¥jbshc¥配下のファイルを，共有フォルダ¥jp1base¥conf¥jbshc¥配下にコピーする。

2-6　共有フォルダ¥jp1base¥conf¥配下にjbslcactフォルダを作成する。

2-7　インストール先フォルダ¥conf¥jbslcact¥配下のファイルを，共有フォルダ¥jp1base¥conf¥jbslcact¥配下にコピーする。

2-8　共有フォルダ¥jp1base¥conf¥配下にjbsdftsフォルダを作成する。

2-9　インストール先フォルダ¥conf¥jbsdfts¥配下のファイルを，共有フォルダ¥jp1base¥conf¥jbsdfts¥配下にコピーする。

3.　07-00以降で追加された共通定義情報を追加する。

以下の手順で設定ファイルを修正してください。

3-1　共通定義情報のバックアップを取る。

以下のコマンドを実行してください。

jbsgetcnf -h 論理ホスト名 > バックアップファイル名

3-2　論理ホストに追加する共通定義情報を用意する。

以下のファイルをテンポラリーディレクトリにコピーしてください。

07-00のJP1/Baseをご使用の場合はjcocmd0710.confとjbshc_com.conf，07-10のJP1/Baseをご使用の場合はjbshc_com.confだけをコピーしてください。

インストール先フォルダ¥default¥base_plugin.conf

インストール先フォルダ¥default¥jcocmd0700.conf

インストール先フォルダ¥default¥jcocmd0710.conf

インストール先フォルダ¥default¥jbsspm070.conf

インストール先フォルダ¥conf¥jp1bs_param_V7.conf

インストール先フォルダ¥default¥jbshc_com.conf

インストール先フォルダ¥conf¥jbscom_default.conf

インストール先フォルダ¥conf¥jbslcact_default.conf

インストール先フォルダ¥conf¥jbssrvmgr.conf

3-3　3-2でコピーしたファイルをエディターなどで修正して論理ホスト用の共通定義情報を作成する。

ファイル中の「JP1_DEFAULT」をすべて「論理ホスト名」に修正してください。ファイル名はそれぞれ「～.conf」にしてください。

3-4　3-3で修正したファイルを論理ホストの共通定義情報として設定する。

以下のコマンドを各ファイルに対して実行して，共通定義情報を追加してください。

jbssetcnf ファイル名

以上で，論理ホストのアップグレード作業は終了です。

バージョン8で，コマンド実行履歴ファイル（ISAM）の保存形式が変更になりました。そのため，JP1/IMを使用している環境で，バージョン8以降のJP1/Baseを07-51以前のバージョンから上書きインストールした場合，JP1/IMの運用開始までの間に必ずjcocmdconvコマンドを実行してください。
このコマンドを実行すると，バージョン7以前のJP1/Baseに蓄積されたコマンド実行履歴ファイル（ISAM）を，バージョン8以降のコマンド実行履歴ファイル（ISAM）に移行できます。このコマンドを実行しなかった場合，バージョン7以前に蓄積されたコマンド実行履歴が参照できません。また，クラスタ運用時には，共有ディスクにアクセスできる状態で，実行系か待機系のどちらか一方から論理ホストに対し，jcocmdconvコマンドを1回だけ実行してください。
jcocmdconvコマンドの詳細については，「13.　コマンド」の「jcocmdconv」を参照してください。
なお，コマンド実行履歴はマネージャーホスト（JP1/IMと同ホスト）のJP1/Baseだけに作成されます。

09-00では，イベントサーバ設定ファイル（conf）のoptionsパラメーターにsave-repフラグが追加されました。このフラグを設定すると，イベントDBの重複防止テーブルをファイル上に保持します。設定しない場合は，重複防止テーブルをメモリー上に保持します。そのため，イベントサーバの再起動時に，重複防止テーブルが破棄されたあとで再構築され，他ホストから転送されたJP1イベントの受信に時間が掛かります。他ホストから転送されたJP1イベントを受信するイベントサーバでは，save-repフラグを設定することを推奨します。
なお，08-50以前のバージョンから上書きインストールした場合は，このフラグが設定されていないため，次の手順で重複防止テーブルをファイル上に構築してください。

イベントサーバ設定ファイルのoptionsパラメーターにsave-repフラグを追加する。
イベントサーバ設定ファイルについては，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

jevdbmkrepコマンドを実行する。
jevdbmkrepコマンドについては，「13.　コマンド」の「jevdbmkrep」を参照してください。

イベントサーバを起動する。

09-10では，ログファイルトラップ起動定義ファイル（jevlog_start.conf）が追加されました。09-10以降のJP1/IMと連携している場合，IM構成管理を使用しているときは，このファイルを使用すると，IM構成管理からログファイルトラップの起動・停止を管理できます。
IM構成管理からログファイルトラップの起動・停止を管理する場合，起動順序定義ファイル（JP1SVPRM.DAT）でログファイルトラップを起動するように定義しているときは，次の作業を実施して，ログファイルトラップを起動するための定義をログファイルトラップ起動定義ファイルに移行してください。

起動順序定義ファイルで設定していた，ログファイルトラップを起動するための定義を削除する。

ログファイルトラップ起動定義ファイルに，起動・停止したいログファイルトラップを設定する。

ログファイルトラップ起動定義ファイルについては，「14.　定義ファイル」の「ログファイルトラップ起動定義ファイル」を参照してください。
なお，移行の際は，次の点に注意してください。

jevlogstartコマンドオプションにログファイルトラップ動作定義ファイル名（-fオプション）を必ず指定してください。

監視名またはログファイルトラップ動作定義ファイル名が，ほかのログファイルトラップと重複しないようにしてください。重複している場合は，別の名称に変更してください。

2.3　インストール（UNIXの場合）

この節では，UNIX版JP1/Baseのインストール，アンインストール，インストール・アンインストール時の注意事項，およびセットアップ前の作業について説明します。

＜この節の構成＞

2.3.1　インストール

2.3.2　Hitachi PP Installerの使用方法

2.3.3　アンインストール

2.3.4　インストール・アンインストール時の注意事項

2.3.5　セットアップ前の作業

2.3.1　インストール

JP1/Baseをインストールする手順を次に示します。

プログラムを終了する。
JP1/Baseをインストールする前に，JP1の全プログラム，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを終了してください。

Hitachi PP Installerを実行する。
Hitachi PP Installerの指示に従ってJP1/Baseをインストールしてください。Hitachi PP Installerの操作手順については，「2.3.2　Hitachi PP Installerの使用方法」を参照してください。
新規にインストールする場合だけ，自動でセットアップの初期設定が行われ，インストール完了後すぐにJP1/Baseを運用できるようになります。
自動セットアップで設定される項目を次の表に示します。

表2-2　ユーザー管理機能に関するデフォルト値

設定項目 | 内容
認証サーバの設定 | 認証サーバ名 | 自ホスト名
JP1ユーザーの設定 | JP1ユーザー名 | jp1admin
パスワード | jp1admin
JP1資源グループ | *
所有する権限 | JP1_AJS_Admin，JP1_JPQ_Admin，JP1_AJSCF_Admin，JP1_HPS_Admin，JP1_PFM_Admin，JP1_Console_Admin，JP1_CM_Admin，JP1_Rule_Admin，JP1_ITSLM_Admin，JP1_Audit_Admin，JP1_DM_Admin，JP1_SSO_Admin，Cosminexus_vMNG_Admin
ユーザーマッピングの設定 | マッピングするJP1ユーザー名 | jp1admin
JP1ユーザーが操作命令を出すサーバホスト名 | *
JP1ユーザーとOSユーザーのマッピング | JP1ユーザー（jp1admin）と，各ホストに登録されているOSユーザー（root）をマッピングします。

各設定項目の詳細については，「6.3　ユーザー管理の設定（UNIXの場合）」を参照してください。
Hitachi PP Installerを実行すると，統合トレース機能（HNTRLib2）もインストールされます。HNTRLib2のインストール先は，/opt/hitachi/HNTRLib2/です。

JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）について

JP1/Baseは，JP1/NETM/DMを使ったリモートインストールに対応しています。JP1/Baseの場合，次に示すインストールに対応しています。

新規インストール
インストール対象ホストにJP1/Baseを新規にインストールできます。

バージョンアップインストール
リモートインストールすると，JP1/Baseインストール済みホストのJP1/Baseをバージョンアップできます。

JP1/NETM/DMを使った実際のリモートインストール方法については，マニュアル「JP1/NETM/DM Manager」「JP1/NETM/DM SubManager(UNIX(R)用)」「JP1/NETM/DM Client(UNIX(R)用)」を参照してください。

2.3.2　Hitachi PP Installerの使用方法

Hitachi PP Installerは，JP1/Baseの提供媒体に格納されています。ここでは，次の操作について説明します。

Hitachi PP Installerの起動方法

Hitachi PP Installerを使ってJP1/Baseをインストールする方法

Hitachi PP Installerを使ってJP1/Baseを削除する方法

Hitachi PP Installerを使って現在インストールされている日立製品のバージョンを確認する方法

Hitachi PP Installerを使用するときの注意事項

Hitachi PP Installerを使用するときはスーパーユーザー権限が必要です。スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更してください。

＜この項の構成＞

(1)　Hitachi PP Installerの起動

(2)　JP1/Baseのインストール

(3)　JP1/Baseのアンインストール

(4)　バージョン情報の表示

(1)　Hitachi PP Installerの起動

JP1/Baseをテープ媒体からインストールする場合

ドライブにJP1/Baseの提供媒体をセットする。

次のコマンドを実行して，Hitachi PP Installerを取り出す。
tar xf デバイスファイル名

次のコマンドを実行して，Hitachi PP Installerを起動する。
/etc/hitachi_setup -i デバイスファイル名

JP1/BaseをCD-ROM媒体からインストールする場合

ドライブにJP1/Baseの提供媒体をセットする。

CD-ROM装置をマウントする。
次のコマンドを実行します。実行するコマンドはご使用のOSによって異なります。なお，SolarisやLinuxでは，この手順は必要ありません。
HP-UXの場合：/usr/sbin/mount -F cdfs -rデバイススペシャルファイル名 /cdrom
AIXの場合：/usr/sbin/mount -r -v cdrfs /dev/cd0 /cdrom
注　太字の部分は，ご使用の環境によって異なります。

次のコマンドを実行して，Hitachi PP Installerをインストールおよび起動する。
/cdrom/XXXX/setup /cdrom
XXXXの部分は，ご使用のOSによって異なります。
なお，「setup」は，HP-UXシステムでは大文字の「SETUP」になります。また，SolarisやLinuxでは，自動的にマウントされるため，デバイススペシャル名の「/cdrom」には，自動的にマウントされたデバイススペシャル名を指定してください。

(2)　JP1/Baseのインストール

Hitachi PP Installerを使ってJP1/Baseをインストールする方法を説明します。Hitachi PP Installerを起動すると，初期画面が表示されます。表示される初期画面例を次の図に示します。

図2-2　Hitachi PP Installerの初期画面例

初期画面で「I」を入力すると，インストールできるソフトウェアの一覧が表示されます。「JP1/Base」にカーソルを移動し，スペースバーで選択します。さらに「I」を入力すると，JP1/Baseがインストールされます。インストール完了後，「Q」を入力すると初期画面に戻ります。

(3)　JP1/Baseのアンインストール

次のコマンドを実行して，Hitachi PP Installerを起動します。

/etc/hitachi_setup

Hitachi PP Installerの初期画面が表示されます。初期画面については，「図2-2　Hitachi PP Installerの初期画面例」を参照してください。

初期画面で「D」を入力すると，削除できるソフトウェアの一覧が表示されます。「JP1/Base」にカーソルを移動し，スペースバーで選択します。さらに「D」を入力すると，JP1/Baseが削除されます。削除完了後，「Q」を入力すると，初期画面に戻ります。

(4)　バージョン情報の表示

次のコマンドを実行して，Hitachi PP Installerを起動します。

/etc/hitachi_setup

Hitachi PP Installerの初期画面が表示されます。初期画面については，「図2-2　Hitachi PP Installerの初期画面例」を参照してください。

初期画面で「L」を入力すると，インストール済みの日立製品の一覧が表示されます。

2.3.3　アンインストール

JP1/Baseをアンインストールする手順を次に示します。

プログラムを終了する。
JP1のプログラムをすべて終了してください。イベントサービスを利用しているプログラムもすべて終了してください。
JP1/AJS - Managerを使用している場合は，JP1/AJS Monitorサービスを終了してください。

SNMPトラップ変換機能を使用していた場合は，SNMPトラップ変換機能の設定を解除する。
詳細については，「付録I.2(5)　設定を解除する」を参照してください。

Hitachi PP Installerを実行する。
Hitachi PP Installerの指示に従ってJP1/Baseをアンインストールしてください。アンインストールでは，JP1/Baseのインストールディレクトリ以下のユーザーファイルも削除されます。したがって，必要なファイルはバックアップをとってからアンインストールしてください。

注意事項

JP1/Baseをアンインストールすると，HNTRLib2が自動的にアンインストールされます。ただし，HNTRLib2を利用するプログラムがほかにある場合は，そのプログラムがすべてアンインストールされた時点でHNTRLib2がアンインストールされます。

2.3.4　インストール・アンインストール時の注意事項

JP1/Baseのインストール・アンインストール時の注意事項を次に示します。

＜この項の構成＞

(1)　インストールについて

(2)　再インストールについて

(3)　アンインストールについて

(4)　OS環境への設定

(5)　上書きインストールについて

(1)　インストールについて

「Install failed」などと表示され，Hitachi PP Installerを使ったインストールが失敗した場合，/etc/.hitachi/.hitachi.logを確認してください。なお，このログファイルは，次にHitachi PP Installerを起動すると上書きされるので，必要に応じてバックアップをとってください。
また，/var/opt/jp1base/log/JBS_SETUPディレクトリ下にインストール時のログが出力されます。このログを確認してください。

Solarisの非大域ゾーンへインストールする場合，同一装置内のすべてのJP1/Baseを非大域ゾーンに対応したバージョン（08-50以降）にしてください。

(2)　再インストールについて

JP1/Baseを上書きインストールする場合は，JP1/BaseとJP1シリーズすべてのプログラム，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを必ず終了してください。
JP1/AJS - Managerを使用している場合は，JP1/AJS Monitorサービスを終了してください。

JP1/Baseを上書きインストールすると統合トレース機能（HNTRLib2）が停止します。このため，JP1/Baseを起動しても統合トレースログで情報の採取ができません。JP1/Baseを上書きインストールした場合は，統合トレース機能（HNTRLib2）が起動しているかpsコマンドを使って確認してください（hntr2monプロセスが稼働していれば起動しています）。統合トレース機能（HNTRLib2）が起動していなければ，hntr2monコマンドを使って起動してください。hntr2monコマンドの詳細については，「13.　コマンド」の「hntr2mon（UNIX限定）」を参照してください。

JP1/Baseをアンインストールしてから，再インストールする場合には，JP1/BaseおよびJP1/Baseを前提とする製品をすべてアンインストールしたあとに，JP1/Base，JP1/Baseを前提とする製品の順に再インストールをしてください。

JP1/IM - Managerの場合
JP1/Baseを再インストールしたあと，JP1/BaseおよびJP1/IM - Managerを再セットアップしてください。

JP1/AJSの場合
JP1/Baseを再インストールしたあと，JP1/BaseおよびJP1/AJSを再セットアップしてください。

JP1/AJS2 for Mainframeの場合
JP1/AJS2 for Mainframeもアンインストールしたあと， JP1/BaseおよびJP1/AJS2 for Mainframeを再インストールしてください。そのあと，JP1/BaseおよびJP1/AJS2 for Mainframeを再セットアップしてください。

JP1/Power Monitorの場合
JP1/Baseを再インストールしたあと，JP1/BaseおよびJP1/Power Monitorを再セットアップしてください。ただし，JP1/AJSとの連携セットアップや論理ホストのセットアップを実行していない場合は，JP1/Power Monitorを再セットアップする必要はありません。

SNMPトラップ変換機能を利用している場合，JP1/Baseの上書きインストール後に再度，imevtgw_setupコマンドを実行してください。

(3)　アンインストールについて

JP1/Baseのアンインストール後は，次に示すディレクトリが残っていないか確認し，残っている場合は削除してください。

/etc/opt/jp1base

/opt/jp1base

/var/opt/jp1base

なお，インストーラーのログとして次のファイルが作成されます。アンインストールが正常終了したあとに削除してください。

/tmp/HITACHI_JP1_INST_LOG/jp1base_inst{1|2|3|4|5}.log

(4)　OS環境への設定

JP1/Baseのインストール時に，/etc/servicesファイルに「付録C　ポート番号一覧」に示すポート番号が設定されます。これらの設定情報は，JP1/Baseのアンインストールで削除されます。ただし，サービス名jesrdは削除されません。不要であれば，削除してください。

(5)　上書きインストールについて

以前のバージョンの製品を使用している環境に上書きインストールする場合

JP1/Baseをインストールすると，バージョン5のイベントサービス機能は動作できなくなります。バージョン5のイベントサービスを起動する場合は，次に示すコマンドを実行してください。

jevmkcompat -r

また，上記コマンドを実行したあと，再びJP1/Baseのイベントサービスを起動する場合，次に示すコマンドを実行してください。このコマンドを実行しないと，JP1/Baseのイベントサービスに対してイベントを発行できないプログラムがあります。

jevmkcompat -u

JP1/Baseがインストールされている状態で，バージョン5のJP1/IMをインストールまたはアンインストールした場合，次に示すコマンドを実行してください。

jevmkcompat -u

バージョン6のJP1/IM - Central ConsoleまたはJP1/AJSと，バージョン7以降のJP1/Baseを同一ホストにインストールできません。

07-10以前のJP1/Baseでクラスタシステムをご使用で，07-11以降のJP1/Baseを上書きインストールする場合，上書きインストール後に以下の作業をして，論理ホスト環境の設定のアップグレードをする必要があります。

1.　07-00以降で追加されたプロセスが起動するようにする。

以下の手順で設定ファイルを修正してください。

認証サーバを論理ホストで起動する場合

cp -p /etc/opt/jp1base/conf/jp1bs_spmd.conf.session.model 共有ディレクトリ/jp1base/conf/jp1bs_spmd.conf

cp -p /etc/opt/jp1base/conf/jp1bs_service_0700.conf.model 共有ディレクトリ/jp1base/conf/jp1bs_service_0700.conf

認証サーバを論理ホストで起動しない場合

cp -p /etc/opt/jp1base/conf/jp1bs_spmd.conf.model 共有ディレクトリ/jp1base/conf/jp1bs_spmd.conf

cp -p /etc/opt/jp1base/conf/jp1bs_service_0700.conf.model 共有ディレクトリ/jp1base/conf/jp1bs_service_0700.conf

2.　07-00以降で追加された定義ファイルをコピーする。

以下の手順で定義ファイルをコピーしてください。

2-1　共有ディレクトリ/jp1base/conf/配下にpluginディレクトリを作成する。

2-2　/etc/opt/jp1base/conf/plugin/reqforward.confを，共有ディレクトリ/jp1base/conf/plugin/配下にコピーする。

2-3　/etc/opt/jp1base/conf/user_acl/JP1_AccessLevelを，共有ディレクトリ/jp1base/conf/user_acl/配下にコピーする。

2-4　共有ディレクトリ/jp1base/conf/配下にjbshcディレクトリを作成する。

2-5　/etc/opt/jp1base/conf/jbshc/配下のファイルを，共有ディレクトリ/jp1base/conf/jbshc/配下にコピーする。

2-6　/etc/opt/jp1base/conf/jbslcact/配下のファイルを，共有ディレクトリ/jp1base/conf/jbslcact/配下にコピーする。

2-7　/etc/opt/jp1base/conf/jbsdfts/配下のファイルを，共有ディレクトリ/jp1base/conf/jbsdfts/配下にコピーする。

3.　07-00以降で追加された共通定義情報を追加します。

以下の手順で設定ファイルを修正してください。

3-1　共通定義情報のバックアップを取る。

以下のコマンドを実行してください

jbsgetcnf -h 論理ホスト名 > バックアップファイル名

3-2　論理ホストに追加する共通定義情報を用意する。

以下のファイルをテンポラリーディレクトリにコピーしてください。

07-00のJP1/Baseをご使用の場合はjcocmd0710.conf.modelとjbshc_com.conf.model，07-10のJP1/Baseをご使用の場合はjbshc_com.conf.modelだけをコピーしてください。

/etc/opt/jp1base/default/base_plugin.conf.model

/etc/opt/jp1base/default/jcocmd0700.conf.model

/etc/opt/jp1base/default/jcocmd0710.conf.model

/etc/opt/jp1base/default/jbsspm070.conf.model

/etc/opt/jp1base/conf/jp1bs_param_V7.conf.model

/etc/opt/jp1base/default/jbshc_com.conf.model

/etc/opt/jp1base/default/jbscom_default.conf.model

/etc/opt/jp1base/default/jbslcact_default.conf.model

/etc/opt/jp1base/default/jbssrvmgr.conf.model

3-3　3-2でコピーしたファイルをエディターなどで修正して論理ホスト用の共通定義情報を作成する。

ファイル中の「JP1_DEFAULT」をすべて「論理ホスト名」に修正してください。ファイル名はそれぞれ「～.conf」にしてください。

3-4　3-3で修正したファイルを論理ホストの共通定義情報として設定する。

以下のコマンドを各ファイルに対して実行して，共通定義情報を追加してください。

jbssetcnf ファイル名

以上で，論理ホストのアップグレード作業は終了です。

バージョン8で，コマンド実行履歴ファイル（ISAM）の保存形式が変更になりました。そのため，JP1/IMを使用している環境で，バージョン8以降のJP1/Baseを07-51以前のバージョンから上書きインストールした場合，JP1/IMの運用開始までの間に必ずjcocmdconvコマンドを実行してください。
このコマンドを実行すると，バージョン7以前のJP1/Baseに蓄積されたコマンド実行履歴ファイル（ISAM）を，バージョン8以降のコマンド実行履歴ファイル（ISAM）に移行できます。このコマンドを実行しなかった場合，バージョン7以前に蓄積されたコマンド実行履歴が参照できません。また，クラスタ運用時には，共有ディスクにアクセスできる状態で，実行系か待機系のどちらか一方から論理ホストに対し，jcocmdconvコマンドを1回だけ実行してください。
jcocmdconvコマンドの詳細については，「13.　コマンド」の「jcocmdconv」を参照してください。
なお，コマンド実行履歴はマネージャーホスト（JP1/IMと同ホスト）のJP1/Baseだけに作成されます。

09-00では，イベントサーバ設定ファイル（conf）のoptionsパラメーターにsave-repフラグが追加されました。このフラグを設定すると，イベントDBの重複防止テーブルをファイル上に保持します。設定しない場合は，重複防止テーブルをメモリー上に保持します。そのため，イベントサーバの再起動時に，重複防止テーブルが破棄されたあとで再構築され，他ホストから転送されたJP1イベントの受信に時間が掛かります。他ホストから転送されたJP1イベントを受信するイベントサーバでは，save-repフラグを設定することを推奨します。
なお，08-50以前のバージョンから上書きインストールした場合は，このフラグが設定されていないため，次の手順で重複防止テーブルをファイル上に構築してください。

イベントサーバ設定ファイルのoptionsパラメーターにsave-repフラグを追加する。
イベントサーバ設定ファイルについては，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

jevdbmkrepコマンドを実行する。
jevdbmkrepコマンドについては，「13.　コマンド」の「jevdbmkrep」を参照してください。

イベントサーバを起動する。

09-10では，ログファイルトラップ起動定義ファイル（jevlog_start.conf）が追加されました。09-10以降のJP1/IMと連携している場合，IM構成管理を使用しているときは，このファイルを使用すると，IM構成管理からログファイルトラップの起動・停止を管理できます。
IM構成管理からログファイルトラップの起動・停止を管理する場合，jbs_startでログファイルトラップを起動するように定義しているときは，次の作業を実施して，ログファイルトラップを起動するための定義をログファイルトラップ起動定義ファイルに移行してください。

jbs_startで設定していた，ログファイルトラップを起動するための定義を削除する。

ログファイルトラップ起動定義ファイルに，起動・停止したいログファイルトラップを設定する。

ログファイルトラップ起動定義ファイルについては，「14.　定義ファイル」の「ログファイルトラップ起動定義ファイル」を参照してください。
なお，移行の際は，次の点に注意してください。

jevlogstartコマンドオプションにログファイルトラップ動作定義ファイル名（-fオプション）を必ず指定してください。

監視名またはログファイルトラップ動作定義ファイル名が，ほかのログファイルトラップと重複しないようにしてください。重複している場合は，別の名称に変更してください。

2.3.5　セットアップ前の作業

UNIXの場合，JP1/Baseのインストール後，セットアップする前に次に示す操作をする必要があります。

カーネルパラメーターの調整

言語種別の設定

＜この項の構成＞

(1)　カーネルパラメーターの調整

(2)　言語種別の設定

(1)　カーネルパラメーターの調整

カーネルパラメーターを調整し，JP1/Baseの実行に必要なリソースを割り当ててください。調整が必要なカーネルパラメーターはOSごとに異なります。詳細については，「付録G　カーネルパラメーター一覧」を参照してください。

カーネルパラメーターとは，UNIXシステムが使用するリソースを調整して最適化するための設定です。次のような値を調整します。

ファイルシステムの調整：ファイルの最大オープン数，ファイルの最大ロック数

共用メモリーの調整：共用メモリーの最大サイズ，共用メモリーの最大数

セマフォの調整：セマフォの最大数，セマフォの最大アンドゥ数

カーネルパラメーターについての詳しい説明は，各OSのマニュアルやUNIXの参考文献を参照してください。

(2)　言語種別の設定

言語種別を環境変数LANGで設定します。各OSで使用できる文字コードと環境変数LANGの値を次の表に示します。

表2-3　環境変数LANGに指定できる値

OS | 言語種別 | 文字コード | 環境変数LANGの値
HP-UX | 日本語 | シフトJISコード | ja_JP.SJISまたはjapanese
EUCコード | ja_JP.eucJPまたはjapanese.euc
英語 | C
Solaris | 日本語 | シフトJISコード | ja_JP.PCK
EUCコード | jaまたはjapanese
英語 | C
AIX | 日本語 | シフトJISコード | Ja_JP.IBM-932またはJa_JP
EUCコード | ja_JP.IBM-eucJPまたはja_JP
英語 | C
Linux | 日本語 | シフトJISコード | 使用不可
EUCコード | 使用不可
UTF-8コード | ja_JP.UTF-8またはja_JP.utf8
英語 | C

JP1/Baseの動作する言語種別を，以下のように設定してください。

同一ホスト内で動作するJP1/Baseを前提とする製品（JP1/IMやJP1/AJS）の文字コードは，JP1/Baseと統一してください。

LinuxのUTF-8ロケール環境でJP1/Baseを動作させる場合には，システムを以下のどちらかに整える必要があります。

システム上のすべてのJP1/Baseをバージョン8以降にし，JP1/Baseを前提とする製品はUTF-8コードに対応したバージョンにしてください。

バージョン7のJP1/Baseがシステム内に混在する場合は，UTF-8ロケール環境で発行されたJP1イベントを正しく処理できません。この場合，UTF-8ロケール環境のJP1/Baseをバージョン8以降にし，JP1/Baseを文字コード互換モードで動作するように設定する必要があります。

Linuxの環境に，バージョン8以降のJP1/Baseを新規にインストールした場合の言語種別は，デフォルトで日本語UTF-8コードが設定されます。

(a)　言語種別の設定手順

言語種別の設定手順を次に示します。

jp1bs_env.confを編集する。
/etc/opt/jp1base/conf/jp1bs_env.confファイルをエディターで開き，表2-3に従った環境変数LANGの値を設定します。この定義は，JP1/Baseの次回起動時から有効となります。

jp1bs_param.confを編集する。
/etc/opt/jp1base/conf/jp1bs_param.confファイルをエディターで開き，"JP1_BIND_ADDR"行を削除します。そのあと，"LANG"="文字コード"で文字コードを指定します。ここで設定した文字コードは，JP1/IM - ManagerおよびJP1/AJSで有効となります。設定できるコードを次に示します。

日本語SJISコードを使用する場合：SJIS

日本語EUCコードを使用する場合：EUCJIS

日本語UTF-8コードを使用する場合：UTF-8

英語コードを使用する場合：C

ファイルを保存したあと，スーパーユーザー権限で次に示すコマンドを実行する。

/opt/jp1base/bin/jbssetcnf /etc/opt/jp1base/conf/jp1bs_param.conf

(b)　文字コード互換モードの設定

●文字コード互換モードの設定手順（Linux限定）

文字コード互換モードの設定手順を次に示します。

モデルファイル（jbslm_setup.conf.model）をコピーして，jbslm_setup.confを作成する。

jbslm_setup.conf.modelの格納先

/etc/opt/jp1base/conf/

指定するパラメーター

パラメーターの形式を次に示します。

[JP1_DEFAULT¥JP1BASE¥]

"LANG_MODE"=dword:{00000000 | 00000001}

　0：文字コード互換モードで動作しない。

　1：文字コード互換モードで動作する。日本語UTF-8コードから日本語EUCコードへ変換する。

論理ホストの場合，JP1_DEFAULTを論理ホスト名に置き換えてください。

jbssetcnfコマンドを実行する。
jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

JP1/Baseを再起動する。

2.4　セットアップ

この節では，JP1/Baseのセットアップについて説明します。

＜この節の構成＞

2.4.1　使用する正規表現を拡張する

2.4.2　パスワード保管形式の設定

2.4.3　JP1/Baseの障害に備えた設定

2.4.1　使用する正規表現を拡張する

JP1/Baseでは，上位ホストに転送するJP1イベントのイベントフィルターや，JP1イベントに変換したいWindowsのイベントログやアプリケーションログのフィルター条件などで正規表現を使用できます。

デフォルトでは，次の正規表現を使用できます。

表2-4　デフォルトで使用できる正規表現

OS | 使用できる正規表現
Windows | JP1独自の正規表現
UNIX | 各OSが提供する基本正規表現

JP1/Baseの正規表現に従って動作するプログラムおよび定義ファイルは次のとおりです。

転送設定ファイル（forward）で指定するイベントフィルター

イベントログトラップ動作定義ファイル（ntevent.conf），ログファイルトラップ動作定義ファイルで指定するフィルター部分

jevexportコマンドで使用するフィルターファイル

ローカルアクション実行定義ファイルで指定するイベントフィルター

JP1/IM - ViewからのJP1イベントの検索※1

JP1/BaseのイベントサーバからJP1イベントを取得する関数（JevGetOpen）のイベントフィルター部分※2

拡張属性マッピング設定ファイルのイベントフィルター部分

注※1　JP1/IM - ViewからのJP1イベント検索時には，検索先ホストのJP1/Baseの正規表現の設定に準じます。

注※2　これらの設定方法については，マニュアル「JP1/Base 関数リファレンス」を参照してください。

07-00以降のJP1/Baseでは，デフォルトの正規表現を拡張できます。正規表現を拡張すると，WindowsとUNIXで共通の正規表現を使えるようになります。使用できる正規表現を次の表に示します。

表2-5　正規表現を拡張した場合に使用できる正規表現

OS
使用できる正規表現

Windows
XPG4の拡張正規表現の文法に準拠する。

UNIX
HP-UX，Solaris，またはAIXの場合はXPG4の拡張正規表現の文法に準拠する。
Linuxの場合はPOSIX1003.2の拡張正規表現の文法に準拠する。
各OSによって文法が異なることがあるため，詳細については，各正規表現の文法（regexpまたはregex）を参照のこと。

正規表現のうち，使用頻度が高そうな正規表現の文法と使用例を「付録F　正規表現の文法」に記載しています。正規表現を使用する際の参考にしてください。

＜この項の構成＞

(1)　設定方法

(2)　設定の有効契機

(1)　設定方法

正規表現を拡張するための設定手順を次に示します。クラスタシステムで運用している場合は，実行系・待機系の両方で設定してください。

定義ファイルを任意の名称で作成する。
定義ファイルに以下の内容を定義します。

[JP1_DEFAULT¥JP1BASE¥]
"REGEXP"="EXTENDED"

クラスタシステムで運用している場合は，[JP1_DEFAULT¥JP1BASE¥]のJP1_DEFAULTの部分に論理ホスト名を指定します。

jbssetcnfコマンドを実行する。

jbssetcnf 定義ファイル名

設定内容が共通定義情報に反映されます。

デフォルトの正規表現に戻す場合も，上記と同じ手順で設定します。定義ファイルには次のように定義してください。

[JP1_DEFAULT¥JP1BASE¥]
"REGEXP"=""

(2)　設定の有効契機

正規表現の設定が，JP1/Baseの正規表現の設定に従う機能で有効となる契機を次の表に示します。

機能 | 設定の有効契機
JP1イベントの転送 | イベントサービスの起動時。
jevexportコマンド | jevexportコマンド実行時。
ローカルアクション | ローカルアクション起動時。
JP1/IM - Viewからのイベント検索 | 接続先イベントサーバのイベントサービス起動時。
JP1/BaseのイベントサーバからJP1イベントを取得する関数（JevGetOpen） | 接続先イベントサーバのイベントサービス起動時。
イベントログトラップ | イベントログトラップサービスのサービス起動時。物理ホストの設定に準じる。
ログファイルトラップ | ログファイルトラップ管理サービスのサービス起動時。物理ホストの設定に準じる。
JP1/SES形式のイベント変換 | イベントサービス起動時。

2.4.2　パスワード保管形式の設定

パスワードの保管形式をハッシュレベル1モードからハッシュレベル2モードに変更すると，パスワードの保護を強化できます。共通定義情報に設定していない場合，パスワードの保管形式はハッシュレベル1モードに設定されています。なお，認証サーバのホスト以外のホストでは，パスワード保管形式の設定変更は不要です。また，ディレクトリサーバとの連携ユーザーは，パスワード保管形式の設定の影響を受けません。

パスワードの保管形式を変更する場合は，次の点に注意してください。

認証サーバに登録していたJP1ユーザー（ディレクトリサーバとの連携ユーザーを除く）は，パスワード保管形式の変更後に，削除および再登録が必要です。再登録するまでは，ユーザー認証およびパスワードの変更ができません。

プライマリー認証サーバおよびセカンダリー認証サーバは，必ずパスワードの保管形式を合わせてください。

パスワードの保管形式をハッシュレベル2モードへ変更した場合に，認証サーバのホスト以外のホストからコマンドでJP1ユーザーを設定するには，コマンドを実行するホストのJP1/Baseのバージョンが09-50以降である必要があります。09-10以前のバージョンのホストから，jbsadduserコマンドを実行した場合はメッセージKAVA5023-Eを，jbschgpasswdコマンドを実行した場合はメッセージKAVA5223-Eを出力して，各コマンドが異常終了します。

パスワードの保管形式を変更する手順を次に示します。

プライマリー認証サーバに，次の内容の定義ファイルを作成する。
ファイル名は任意です。

[JP1_DEFAULT¥JP1BASE¥]
"HASH_LEVEL"=dword:{00000001|00000002}

1：ハッシュレベル1モードで動作する。
2：ハッシュレベル2モードで動作する。
論理ホストの場合，JP1_DEFAULTを論理ホスト名に置き換えてください。

jbssetcnfコマンドを実行する。
jbssetcnf 定義ファイル名
作成した定義ファイルの内容が，プライマリー認証サーバの共通定義情報に反映されます。

プライマリー認証サーバを起動する。

jbsrmuserコマンドを実行する。
認証サーバに登録されているJP1ユーザーのうち，ディレクトリサーバと連携しない全JP1ユーザーを削除します。アクセス権限の削除は不要です。

削除したJP1ユーザーを再登録する。
手順4で削除したJP1ユーザーをすべて再登録します。

プライマリー認証サーバの設定情報を，セカンダリー認証サーバにコピーする。
詳細については，「6.1.4　プライマリー認証サーバの設定情報をコピーする」または「6.3.4　プライマリー認証サーバの設定情報をコピーする」を参照してください。

セカンダリー認証サーバに，定義ファイルを作成する。
ファイル名は任意です。また，パラメーターの形式は手順1と同じです。
なお，プライマリー認証サーバとセカンダリー認証サーバがともに物理ホストの場合は，手順2で使用した定義ファイルをセカンダリー認証サーバにコピーして使用できます。それ以外の場合は，プライマリー認証サーバとセカンダリー認証サーバで個別に定義ファイルを作成してください。

jbssetcnfコマンドを実行する。
jbssetcnf 定義ファイル名
手順7で作成した定義ファイル，またはプライマリー認証サーバからコピーした定義ファイルの内容が，セカンダリー認証サーバの共通定義情報に反映されます。

セカンダリー認証サーバを起動する。
パスワードの保管形式が変更されます。

2.4.3　JP1/Baseの障害に備えた設定

JP1/Baseでは，JP1/Base自体の障害がJP1/IMやJP1/AJSを利用したシステム運用に及ぼす影響をできるだけ防ぐために，次の機能を提供しています。

ヘルスチェック
プロセス管理機能，イベントサービス，イベント変換などのプロセスのハングアップ（無限ループやデッドロック），および異常終了（強制終了した場合を除く）を検知します。

プロセス管理機能による異常検知
プロセス管理機能が管理するプロセスの異常終了と，認証サーバの切り替えを検知します。

プロセス異常終了時の再起動
プロセス管理機能が管理するプロセスが異常終了した場合に，自動で再起動します。

イベントサービスのプロセス異常終了時の再起動（UNIX限定）
物理ホストのイベントサービスのプロセスが異常終了した場合に，自動で再起動します。

障害発生時の資料採取
JP1/Baseでトラブルが発生したときに，トラブルシュートのための保守資料を採取できます。

プロセスの異常終了には，プロセス自体が異常と判断して終了する場合と，OSのkillコマンドなどで強制的に終了する場合の2種類あります。ヘルスチェックでは，強制的にプロセスが終了した場合を異常終了として検知できず，プロセスの処理が停滞しているものとして検知します。そのため，プロセスの異常終了を確実に検知したい場合は，ヘルスチェックとプロセス管理機能による異常検知を併用してください。

ヘルスチェックが検知できるプロセスの障害の範囲と，プロセス管理機能が検知できるプロセスの障害の範囲を次の図で示します。

図2-3　ヘルスチェックとプロセス管理機能が検知できるプロセスの障害の範囲

各機能の設定方法を説明します。

＜この項の構成＞

(1)　ヘルスチェック機能でプロセスの異常を検知する

(2)　プロセスの異常終了および認証サーバの切り替え発生を検知する

(3)　異常終了したプロセス管理機能が管理するプロセスを再起動させる

(4)　異常終了したイベントサービスのプロセスを再起動させる（UNIX限定）

(5)　統合トレース機能（HNTRLib2）の設定

(6)　障害発生時の資料採取の準備（Windows限定）

(1)　ヘルスチェック機能でプロセスの異常を検知する

ヘルスチェック機能を利用すると，プロセスの異常を早期に検知できます。また，メッセージによる異常通知によって異常が発生したプロセスを特定できるため，プロセス異常時の影響を最小限に抑えた対処ができます。なお，ヘルスチェック機能を使用するには，監視するホスト，および監視対象ホストにJP1/Base 07-11以降がインストールされている必要があります。

(a)　ヘルスチェック機能を有効にする

ヘルスチェック機能は，デフォルトでは無効になっています。有効にする手順を次に示します。クラスタシステムで運用する場合は，論理ホストのセットアップの完了後に，物理ホスト，論理ホストの両方でヘルスチェック機能を有効にしてください。

共通定義情報にヘルスチェック機能を有効にする情報を登録する。

1-1　共通定義設定用ファイル（ヘルスチェック機能）のモデルファイル

（jbshc_setup.conf.model）を任意のファイル名でコピーする。

1-2　コピーしたファイルを編集する。

1-3　次のコマンドを実行する。

jbssetcnf 1-2で編集したファイル名

ヘルスチェック機能の情報が共通定義情報に登録されます。

jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

共通定義設定用ファイル（ヘルスチェック機能）の詳細については，「14.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」を参照してください。

ヘルスチェック定義ファイル（jbshc.conf）を編集する。
監視対象ホストや監視間隔を定義します。ヘルスチェック定義ファイルの詳細については，「14.　定義ファイル」の「ヘルスチェック定義ファイル」を参照してください。

JP1イベントの転送設定を変更する。
ヘルスチェック機能が発行するJP1イベントを上位の管理サーバに転送するために，転送設定ファイル（forward）に次の条件を追加してください。

E.OBJECT_TYPE IN JBSHC

転送設定ファイル（forward）の詳細については，「14.　定義ファイル」の「転送設定ファイル」を参照してください。

JP1/BaseのすべてのサービスおよびNNM（SNMPトラップ変換機能を使用している場合）を再起動する。
ヘルスチェック機能が起動し，プロセスの監視を開始します。
ヘルスチェック動作定義ファイルに誤りがあった場合は，その設定行を無効とし，デフォルト値がある場合はデフォルト値で動作します。

(b)　ヘルスチェックの設定状況を確認する

ヘルスチェックの設定，および異常検知時のフェールオーバーの有無を確認したい場合は，次のコマンドを実行して共通定義情報を参照してください。

jbsgetcnf

出力された共通定義情報から，ヘルスチェック機能のセクションを検索し，設定を確認してください。

jbsgetcnfコマンドの詳細については，「13.　コマンド」の「jbsgetcnf」を参照してください。共通定義情報の詳細については，「14.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」を参照してください。

(c)　ヘルスチェックの設定を変更する

監視対象ホストの追加や監視間隔を変更する場合の手順を次に示します。

ヘルスチェック定義ファイル（jbshc.conf）を編集する。
ヘルスチェック定義ファイルの詳細については，「14.　定義ファイル」の「ヘルスチェック定義ファイル」を参照してください。

ヘルスチェック定義ファイル（jbshc.conf）の設定内容を有効にする。
Windowsの場合は，JP1/Base（プロセス管理機能）サービスを再起動します。
UNIXの場合は，jbs_spmd_reloadコマンドを実行します。jbs_spmd_reloadコマンドの詳細については，「13.　コマンド」の「jbs_spmd_reload」を参照してください。
設定内容は，リロード後，次の監視タイミングが来た時に有効になります。
リロード時に，ヘルスチェック定義ファイル（jbshc.conf）に誤りがありエラーとなった場合は，その設定行は無効とし，リロード前の設定で動作します。

リロード時の注意事項

他ホストの監視中にエラーを検知している状態でリロードした場合，監視対象ホストの監視状態はリセットされます。このため，次回監視時に監視対象ホストが回復していないときには，再度エラーメッセージやJP1イベントが発行されます。また，すでに回復しているときには，回復メッセージやJP1イベントは発行されません。

(d)　ヘルスチェックの設定を無効にする

ヘルスチェックを無効にする手順を次に示します。

共通定義設定用ファイル（ヘルスチェック機能）を編集する。

1-1　共通定義設定用ファイル（ヘルスチェック機能）のモデルファイルを任意のファイル名でコピーする。

1-2　コピーしたファイルを編集する。

共通定義設定用ファイル（ヘルスチェック機能）の詳細については，「14.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」を参照してください。

次のコマンドを実行する。
jbssetcnf 1-2で編集したファイル名
ヘルスチェックが無効になります。
jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

JP1/BaseのすべてのサービスおよびNNM（SNMPトラップ変換機能を使用している場合）を再起動する。

(e)　07-10以前のJP1/Baseをクラスタ運用している環境からバージョンアップした場合

07-10以前のJP1/Baseでクラスタシステムを使用している場合，07-11以降のJP1/Baseを上書きインストールしたあとに，論理ホスト環境の設定をアップグレードする必要があります。論理ホスト環境の設定をアップグレードする方法については，「2.2.3(5)　上書きインストールについて」（Windowsの場合），および「2.3.4(5)　上書きインストールについて」（UNIXの場合）を参照してください。

論理ホスト環境の設定のアップグレードを行ったあと，「(a)　ヘルスチェック機能を有効にする」で説明している設定を行ってください。

(f)　注意事項

ヘルスチェック機能を使用する場合の注意事項を次に示します。

プロセスをkillコマンドなどで強制終了した場合，異常終了として検知されません。この場合は，プロセスの応答がない状態として異常を検知（KAVA7014-E）します。ただし，経過時間はkillコマンド実行からの時間ではありません。内部で使用している共有メモリーの更新時刻で判断しているため，プロセスの強制終了後，すぐに異常が検知される場合があります。

プロセスをkillコマンドなどで強制終了し正常に終了処理ができていない状態で，該当機能のプロセスを再起動した場合，先に強制終了したプロセスの異常検知メッセージが発行されることがあります。

拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）で再起動を設定しているプロセスが異常終了した場合，プロセスの再起動を通知するメッセージ（KAVB3605-I，KAVB3616-I）の発行のあとに異常終了を通知するメッセージ（KAVA7017-E）が発行されることがあります。プロセスの状態は，jbs_spmd_statusコマンドで確認してください。

(2)　プロセスの異常終了および認証サーバの切り替え発生を検知する

JP1/Baseでは，プロセスが異常終了したり，認証サーバを2台設置した運用で認証サーバが自動で切り替わったりした場合に，エラーメッセージを統合トレースログに出力します。これらのメッセージをJP1イベントとして発行できます。発行されるJP1イベントの詳細については，「15.　JP1イベント」を参照してください。

(a)　監視対象プロセス

プロセス管理（jbs_spmd）が管理する次のプロセスの異常終了を検知します。

jbssessionmgr（認証サーバ）

jbsroute（構成管理）

jcocmd（コマンド実行）

jbsplugind（プラグインサービス）

jbshcd（ヘルスチェック：自ホスト監視用）

jbshchostd（ヘルスチェック：他ホスト監視用）

jbssrvmgr（サービス管理制御）

jbslcact（ローカルアクション）

jbscomd（プロセス間通信）

(b)　JP1イベントの発行契機

設定を有効にした場合，次に示す契機でJP1イベントが発行されます。

プロセス管理機能が管理するプロセスの状態

プロセスの起動時にタイムアウトした場合

プロセスが異常終了した場合

起動時に起動通知がなく，タイムアウトした場合

異常終了した管理対象プロセスの再起動が完了した場合※
注※　プロセスの再起動を設定した場合に発行されます。

認証サーバの状態（セカンダリー認証サーバを設置した場合）

認証サーバへの接続に失敗し，自動で閉塞状態になった場合

閉塞状態が自動で解除された場合

プライマリー認証サーバおよびセカンダリー認証サーバへの接続がともに閉塞状態になった場合

(c)　設定手順

設定手順を次に示します。

JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）を編集する。
JP1イベントを発行したいパラメーターについて，1（JP1イベントを発行する）を設定します。JP1/Baseパラメーター定義ファイルの詳細については，「14.　定義ファイル」の「JP1/Baseパラメーター定義ファイル」を参照してください。

jbssetcnfコマンドを実行する。
JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）の設定内容が共通定義情報に反映されます。
jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

JP1/BaseおよびJP1/Baseを前提とする製品を再起動する。
設定が有効になります。

(3)　異常終了したプロセス管理機能が管理するプロセスを再起動させる

JP1/Baseを起動すると，複数のプロセスが生成されます。07-00以降のJP1/Baseでは，何らかの理由でプロセスが異常終了した場合に，自動でプロセスを再起動できます。

なお，ここで説明する再起動の設定は，クラスタ運用ではないJP1/Baseの再起動を目的としています。クラスタ運用の場合に再起動を行いたい場合は，クラスタソフトの制御によって再起動するようにしてください。

(a)　再起動の対象のプロセス

再起動の対象は，プロセス管理機能（jbs_spmd）が管理する次のプロセスです。

jbssessionmgr（認証サーバ）

jbsroute（構成管理）

jcocmd（コマンド実行）

jbsplugind（プラグインサービス）

jbshcd（ヘルスチェック：自ホスト監視用）

jbshchostd（ヘルスチェック：他ホスト監視用）

jbssrvmgr（サービス管理制御）

jbslcact（ローカルアクション）

jbscomd（プロセス間通信）

(b)　設定手順

設定手順を次に示します。

拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）を編集する。
拡張起動プロセス定義ファイルの詳細については，「14.　定義ファイル」の「拡張起動プロセス定義ファイル」を参照してください。

設定を有効にする。
JP1/Baseを再起動するか，リロードコマンド（jbs_spmd_reload）を実行すると設定が有効になります。

ワトソン博士によるエラー通知を抑止する（Windows限定）
エラー発生時に，ワトソン博士のメッセージボックスが表示されると，プロセスの再起動ができないため，表示を抑止する必要があります。
スタートメニューの［ファイル名を指定して実行］で「drwtsn32」を実行します。ワトソン博士のダイアログボックスが表示されるので，［メッセージボックスによる通知］のチェックを外します。
なお，ワトソン博士の設定はシステム全体で共通のため，ここでの設定がシステム全体のプログラムの設定になります。
また，ワトソン博士の設定を有効にするため，コマンドプロンプトで以下のコマンドを実行してください。

drwtsn32 -i

ワトソン博士が既定のアプリケーションデバッガとしてインストールされます。

Microsoftへのエラー報告を抑止する（Windows限定）
エラー発生時にMicrosoftへのエラー報告ダイアログボックスが表示されると，再起動が有効にならないため，エラー報告を抑止する必要があります。
1. ［コントロールパネル］から［システム］をダブルクリックする。
2. ［詳細設定］タブの［エラー報告］をクリックする。
3. ［エラー報告を無効にする］を選択し，［重大なエラーが発生した場合は通知する］のチェックが外れていることを確認する。

(4)　異常終了したイベントサービスのプロセスを再起動させる（UNIX限定）

08-10以降のUNIX版のJP1/Baseでは，物理ホストのイベントサービスのプロセスが異常終了した場合，自動で再起動できます。この設定は，デフォルトでは無効です。

Windows版のJP1/Baseの場合は，WindowsのService Control Managerでサービスを再起動する設定をしてください。

なお，ここで説明する再起動の設定は，クラスタ運用ではないJP1/Baseの再起動を目的としています。クラスタ運用の場合に再起動を行いたい場合は，クラスタソフトの制御によって再起動するようにしてください。

(a)　再起動の対象のプロセス

再起動の対象のプロセスは，jevservice（イベントサービス）が管理する子プロセスjevservice（イベントサービス）です。

jevservice（イベントサービス）が管理する子プロセスjevservice（イベントサービス）とは，jevstatコマンドで確認できるプロセスIDを親プロセスとして持つjevservice（イベントサービス）プロセスです。

(b)　設定手順

設定手順を次に示します。

イベントサーバ設定ファイル（conf）にrestartパラメーターを定義する。

イベントサービスを起動する。

イベントサーバ設定ファイル（conf）の詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

(5)　統合トレース機能（HNTRLib2）の設定

JP1/Baseでは，統合トレース機能（HNTRLib2）を使って，JP1/Baseを前提とする製品を含めた動作処理の流れをトレースしたログファイルを出力しています。このログファイルは，障害が発生したときなどの原因究明に役立ちます。

デフォルトでは，次のように設定されています。

ログファイルのサイズ：256キロバイト

ログファイルの数：4

ログファイルの出力先：

Windowsの場合

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

UNIXの場合

/var/opt/hitachi/HNTRLib2/spool/hntr2*.log

通常はデフォルト値を変更する必要はありませんが，hntr2utilコマンド，hntr2confコマンド，またはhntr2getconfコマンドを実行するとデフォルト値を参照し，変更できます。コマンドの詳細については，「13.　コマンド」の「hntr2util（Windows限定）」，「hntr2util（UNIX限定）」，「hntr2conf」，「hntr2getconf」を参照してください。

注意

バージョン7から，統合トレース機能に自動アンインストール機能が付き，名称がHNTRLibからHNTRLib2に変更になりました。統合トレース関連のコマンドの名称や，ログファイルの出力先もバージョン6と異なるため，バージョン6以前をご使用されていた方はご注意ください。

(6)　障害発生時の資料採取の準備（Windows限定）

トラブル発生時に資料を採取するためのツールを準備します。このツールは，トラブルの解決に必要な情報を一括して採取します。

なお，資料採取ツールで採取できる資料には，メモリーダンプ，クラッシュダンプがあります。これらのダンプは，出力されるようにあらかじめ次の設定をしてください。出力設定すると，資料採取ツールでこれらのダンプも採取できます。

(a)　メモリーダンプの出力設定

メモリーダンプの出力設定の手順を次に示します。

［コントロールパネル］から［システム］をダブルクリックする。

［詳細設定］タブの［起動と回復］の［設定］をクリックする。

［デバッグ情報の書き込み］で，［完全メモリダンプ］を選択し，出力先のファイルを指定する。

注意事項

メモリーダンプのサイズは，実メモリーのサイズによって異なります。搭載している物理メモリーが大きいと，メモリーダンプのサイズも大きくなります。メモリーダンプを採取できるだけのディスク領域を確保してください。詳細については，Windowsのヘルプの「STOPエラー」の項目を参照してください。

(b)　クラッシュダンプの出力設定

クラッシュダンプの出力設定手順を次に示します。

スタートメニューから［ファイル名を指定して実行］を選択する。

テキストボックスに「drwtsn32」と入力し，［OK］ボタンをクリックする。

ワトソン博士のダイアログボックスが開きます。

［クラッシュ ダンプ ファイルの作成］にチェックを入れ，クラッシュ ダンプテキストボックスに出力先のファイルを指定する。

［OK］ボタンをクリックする。

注意事項

クラッシュダンプに出力される情報はJP1だけでなく，ほかのアプリケーションプログラムのトラブル情報も出力されます。また，クラッシュダンプが出力されると，その分ディスク容量が圧迫されます。クラッシュダンプが出力されるように設定する場合は，十分なディスク領域を確保しておいてください。

2.5　バックアップとリカバリー

ここでは，JP1/Baseのバックアップおよびリカバリーについて説明します。ここでの説明を基に，システム全体のバックアップ計画の一環として，JP1/Baseのバックアップ・リカバリーを検討してください。

＜この節の構成＞

2.5.1　バックアップとリカバリーの検討

2.5.2　バックアップとリカバリー（Windowsの場合）

2.5.3　バックアップとリカバリー（UNIXの場合）

2.5.1　バックアップとリカバリーの検討

万一システムが壊れた場合，同じ環境のシステムを構築して運用再開するために，JP1/Baseの設定情報およびイベントDBをバックアップしてください。

JP1/Baseの設定情報のバックアップは，JP1/Baseをセットアップしたときなど，システムを変更したときに取得してください。

2.5.2　バックアップとリカバリー（Windowsの場合）

ここでは，Windows版JP1/Baseの設定情報およびイベントDBのバックアップとリカバリーについて説明します。

＜この項の構成＞

(1)　設定情報のバックアップ

(2)　イベントDBのバックアップ

(3)　設定情報のリカバリー

(4)　イベントDBのリカバリー

(1)　設定情報のバックアップ

JP1/Baseの設定情報には以下のものがあります。

定義ファイル

共通定義情報

クラスタ運用している場合は，物理ホスト，論理ホストの順番で，各環境をバックアップしてください。

(a)　定義ファイルのバックアップ

JP1/Baseでは，ユーザーが設定する定義ファイルとして以下のファイルがあります。ファイルをコピーするなど任意の方法で，これらのファイルをバックアップしてください。

表2-6　JP1/Baseのバックアップ対象ファイル

ファイル名
内容

JP1/Baseフォルダ※1¥boot¥JP1SVPRM.DAT
起動順序定義ファイル

JP1/Baseフォルダ※1¥boot¥jp1svprm_wait.dat
サービス起動遅延時間／タイマー監視時間定義ファイル※2

JP1/Baseフォルダ※1¥jp1bs_env.conf
JP1/Base環境定義ファイル

JP1/Baseフォルダ※1¥jp1bs_param.conf
JP1/Baseフォルダ※1¥jp1bs_param_V7.conf
JP1/Baseパラメーター定義ファイル

JP1/Baseフォルダ※1¥jp1bs_spmd.conf
JP1/Baseプロセス管理定義ファイル

JP1/Baseフォルダ※1¥jp1bs_service_0700.conf
拡張起動プロセス定義ファイル

JP1/Baseフォルダ※1¥route¥以下のファイル
構成定義ファイル
（JP1/IMで使用）

JP1/Baseフォルダ※1¥user_acl¥JP1_Passwd
JP1ユーザー定義ファイル

JP1/Baseフォルダ※1¥user_acl¥JP1_Group
JP1グループ定義ファイル

JP1/Baseフォルダ※1¥user_acl¥JP1_UserLevel
JP1権限レベル定義ファイル

JP1/Baseフォルダ※1¥user_acl¥JP1_AccessLevel
JP1資源グループ定義ファイル

JP1/Baseフォルダ※1¥user_acl¥JP1_Accountaccess
JP1アカウントアクセス情報ファイル

JP1/Baseフォルダ※1¥user_acl¥jp1BsUmap.conf
ユーザーマッピング定義ファイル

JP1/Baseフォルダ※1¥ds¥jp1bs_ds_setup.conf
ディレクトリサーバ連携定義ファイル

JP1/Baseフォルダ※1¥evtgw¥imevtgw.conf
SNMPトラップ変換動作定義ファイル

JP1/Baseフォルダ※1¥evtgw¥snmpfilter.conf
SNMPトラップ変換フィルターファイル

インストール先フォルダ¥event¥index
イベントサーバインデックスファイル

Eventフォルダ※3¥conf
イベントサーバ設定ファイル

Eventフォルダ※3¥forward
転送設定ファイル

インストール先フォルダ¥event¥api
API設定ファイル

JP1/Baseフォルダ※1¥event¥ntevent.conf
イベントログトラップ動作定義ファイル

任意のファイル※⁴または
JP1/Baseフォルダ※1¥jevlog.conf※4
ログファイルトラップ動作定義ファイル

JP1/Baseフォルダ※1¥event¥jevlog_start.conf
ログファイルトラップ起動定義ファイル

Eventフォルダ※³¥[jev_forward.conf | 任意のファイル] ※5
配布定義ファイル（転送設定ファイル用）

JP1/Baseフォルダ※1¥[jev_logtrap.conf | 任意のファイル]※⁵
配布定義ファイル（ログファイルトラップ動作定義ファイル用）

JP1/Baseフォルダ※1¥event¥[jev_ntevent.conf | 任意のファイル]※⁵
配布定義ファイル（イベントログトラップ動作定義ファイル用）

任意のファイル
パスワード定義ファイル（Windows限定）

JP1/Baseフォルダ※1¥user_acl¥JP1_UserLevel
ユーザー権限レベルファイル

任意のファイル
ディレクトリサーバ変更ファイル（Windows限定）

インストール先フォルダ¥plugin¥conf¥*.conf
アダプタコマンド設定ファイル

JP1/Baseフォルダ※1¥jbshc¥jbshc.conf
ヘルスチェック定義ファイル

任意のファイル
共通定義設定用ファイル（ヘルスチェック機能）

JP1/Baseフォルダ※1¥jp1hosts
jp1hosts定義ファイル

JP1/Baseフォルダ※1¥jbsdfts¥*.conf
サービス管理制御定義ファイル

任意のファイル
ローカルアクション環境変数ファイル

JP1/Baseフォルダ※1¥lcact¥jbslcact.conf
ローカルアクション実行定義ファイル

任意のファイル
共通定義設定用ファイル（ローカルアクション機能）

JP1/Baseフォルダ※1¥physical_ipany.conf
通信方式設定ファイル

JP1/Baseフォルダ※1¥logical_ipany.conf

JP1/Baseフォルダ※1¥physical_recovery_0651.conf

JP1/Baseフォルダ※1¥logical_recovery_0651.conf

JP1/Baseフォルダ※1¥physical_anyany.conf

JP1/Baseフォルダ※1¥physical_ipip.conf

JP1/Baseフォルダ※1¥logical_ipip.conf

JP1/Baseフォルダ※1¥jp1bs_baselog_setup.conf
操作ログ定義ファイル

注※1　「JP1/Baseフォルダ」の部分は，次のフォルダに置き換えてください。

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

論理ホストの場合：共有フォルダ¥jp1base¥conf

注※2　サービスの起動を待機させる設定，およびサービスの起動を監視する設定を有効にしている場合は，バックアップしてください。

注※3　「Eventフォルダ」の部分は，次のフォルダに置き換えてください。

物理ホストの場合：インストール先フォルダ¥conf¥event¥servers¥default

論理ホストの場合：共有フォルダ¥jp1base¥event

注※4　ログファイルトラップ動作定義ファイルは任意の名称に設定できます。使用しているファイルを，忘れずにバックアップしてください。なお，ログファイルトラップを使用していない場合には，ファイルは存在しません。

注※5　配布定義ファイルはデフォルトのファイル名または任意の名称で作成できます。使用しているファイルを，忘れずにバックアップしてください。なお，定義情報の収集および配布機能を使用していない場合には存在しません。

注意事項

統合トレースログの設定は，バックアップとリカバリーの対象ではありません。設定を変更した場合は，JP1/Baseのセットアップをする際に，再度設定し直してください。

(b)　共通定義情報のバックアップ

JP1/Baseでは，定義ファイルだけでなく，共通定義情報もバックアップする必要があります。なお，この共通定義情報には，JP1/Baseのほかに，JP1/IM，JP1/AJSの定義情報も含まれています。ただし，個々の製品の定義情報を別々に取得することはできません。

共通定義情報をバックアップするには，次のコマンドを実行してください。

jbsgetcnf > 退避ファイル

なお，クラスタ運用している場合は，次のようにコマンドを実行してください。

jbsgetcnf -h 論理ホスト名 > 退避ファイル

(2)　イベントDBのバックアップ

イベントDBのバックアップは次の2種類あります。

リカバリーを目的としたバックアップ

障害レポートとしてのバックアップ

(a)　リカバリーを目的としたバックアップ

イベントDBファイルのバックアップ手順を次に示します。

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

イベントDBファイルをコピーするなど任意の方法で，バックアップする。
バックアップの対象のファイルは次のとおりです。
インストール先フォルダ¥sys¥event¥servers¥default¥IMEvent*.*※
または，
共有フォルダ¥jp1base¥event¥IMEvent*.*※
注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するフォルダに別のパスを指定している場合は，指定したパス以下のファイルが対象となります。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

(b)　障害レポートとしてのバックアップ

障害レポートとしてバックアップする場合は，jevexportコマンドを使用してイベントDBの内容をcsvファイルに出力します。

なお，イベントDBは，イベントサーバごとに二つ存在し，一つが上限値（デフォルトでは10メガバイト）を超えると，もう一方のイベントDBに切り替わります。この際，使用するイベントDBの内容は消去されます。イベントDBの容量を定期的に確認して，イベントDBが切り替わる前にjevexportコマンドを実行してください。

(3)　設定情報のリカバリー

JP1/Baseのリカバリーについて説明します。クラスタ運用している場合は，物理ホスト，論理ホストの順番で，各環境をリカバリーしてください。

(a)　定義ファイルのリカバリー

下記の条件を確認した上で，バックアップファイルを，元の位置にリカバリーしてください。

JP1/Baseが正常にインストールされていること。

JP1/Baseが停止していること。

論理ホスト環境のJP1/Baseがセットアップされていること（論理ホストの場合）。

共有ディスクをオンラインにしていること（論理ホストの場合）。

(b)　共通定義情報のリカバリー

「(a)　定義ファイルのリカバリー」に加えて，共通定義情報をリカバリーする必要があります。

次に示すコマンドを実行してください。

jbssetcnf (1)(b)でバックアップした退避ファイル名

(4)　イベントDBのリカバリー

バックアップしたイベントDBファイルをリカバリーした場合に，動作保証できる条件を次に示します。

バックアップとリカバリーの時間差が少ない。または，バックアップしてからリカバリーする間に登録されたJP1イベントの件数が少ない場合。

ホスト名を変更しないでマシンを変更した場合。

イベントDBファイルのリカバリー手順を次に示します。

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

バックアップしたファイルをフォルダに配置する。
配置するフォルダは次のとおりです。
インストール先フォルダ¥sys¥event¥servers¥default¥※
または，
共有フォルダ¥jp1base¥event¥※
注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するフォルダに別のパスを指定している場合は，指定したパス以下に配置してください。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

2.5.3　バックアップとリカバリー（UNIXの場合）

ここでは，UNIX版JP1/Baseの設定情報およびイベントDBのバックアップとリカバリーについて説明します。

＜この項の構成＞

(1)　設定情報のバックアップ

(2)　イベントDBのバックアップ

(3)　設定情報のリカバリー

(4)　イベントDBのリカバリー

(1)　設定情報のバックアップ

JP1/Baseの設定情報には以下のものがあります。

定義ファイル

共通定義情報

クラスタ運用している場合は，物理ホスト，論理ホストの順番で，各環境をバックアップしてください。

(a)　定義ファイルのバックアップ

JP1/Baseでは，ユーザーが設定する定義ファイルとして以下のファイルがあります。これらのファイルのバックアップをしてください。バックアップの手段には，tarやcpi，またはより高度なバックアップコマンドがあります。任意の方法でバックアップしてください。

表2-7　JP1/Baseのバックアップ対象ファイル

ファイル名
内容

JP1/Baseディレクトリ※1/jp1bs_env.conf
JP1/Base環境定義ファイル

JP1/Baseディレクトリ※1/jp1bs_param.conf
JP1/Baseディレクトリ※1/jp1bs_param_V7.conf
JP1/Baseパラメーター定義ファイル

JP1/Baseディレクトリ※1/jp1bs_spmd.conf
JP1/Baseプロセス管理定義ファイル

JP1/Baseディレクトリ※1/jp1bs_service_0700.conf
拡張起動プロセス定義ファイル

JP1/Baseディレクトリ※1/route/以下のファイル
構成定義ファイル
（JP1/IMで使用）

JP1/Baseディレクトリ※1/user_acl/JP1_Passwd
JP1ユーザー定義ファイル

JP1/Baseディレクトリ※1/user_acl/JP1_Group
JP1グループ定義ファイル

JP1/Baseディレクトリ※1/user_acl/JP1_UserLevel
JP1権限レベル定義ファイル

JP1/Baseディレクトリ※1/user_acl/JP1_AccessLevel
JP1資源グループ定義ファイル

JP1/Baseディレクトリ※1/user_acl/JP1_Accountaccess
JP1アカウントアクセス情報ファイル

JP1/Baseディレクトリ※1/user_acl/jp1BsUmap.conf
ユーザーマッピング定義ファイル

JP1/Baseディレクトリ※1/evtgw/imevtgw.conf
SNMPトラップ変換動作定義ファイル

JP1/Baseディレクトリ※1/evtgw/snmpfilter.conf
SNMPトラップ変換用フィルターファイル

JP1/Baseディレクトリ※1/event/index
イベントサーバインデックスファイル

Eventディレクトリ※4/conf
イベントサーバ設定ファイル

Eventディレクトリ※4/forward
転送設定ファイル

JP1/Baseディレクトリ※1/event/api
API設定ファイル

任意のファイル※²または
JP1/Baseディレクトリ※1/jevlog.conf※²
ログファイルトラップ動作定義ファイル

JP1/Baseディレクトリ※1/event/jevlog_start.conf
ログファイルトラップ起動定義ファイル

Eventディレクトリ※4/[jev_forward.conf | 任意のファイル]※3
配布定義ファイル（転送設定ファイル用）

JP1/Baseディレクトリ※1/[jev_logtrap.conf | 任意のファイル]※3
配布定義ファイル（ログファイルトラップ動作定義ファイル用）

JP1/Baseディレクトリ※1/event/[jev_ntevent.conf | 任意のファイル]※3
配布定義ファイル（イベントログトラップ動作定義ファイル用）

/etc/opt/jp1base/conf/user_acl/JP1_UserLevel
ユーザー権限レベルファイル

/opt/jp1base/plugin/conf/*.conf
アダプタコマンド設定ファイル

JP1/Baseディレクトリ※1/jbshc/jbshc.conf
ヘルスチェック定義ファイル

任意のファイル
共通定義設定用ファイル（ヘルスチェック機能）

JP1/Baseディレクトリ※1/jp1hosts
jp1hosts定義ファイル

JP1/Baseディレクトリ※1/jbsdfts/*.conf
サービス管理制御定義ファイル

任意のファイル
ローカルアクション環境変数ファイル

JP1/Baseディレクトリ※1/lcact/jbslcact.conf
ローカルアクション実行定義ファイル

任意のファイル
共通定義設定用ファイル（ローカルアクション機能）

JP1/Baseディレクトリ※1/physical_ipany.conf
通信方式設定ファイル

JP1/Baseディレクトリ※1/logical_ipany.conf

JP1/Baseディレクトリ※1/physical_recovery_0651.conf

JP1/Baseディレクトリ※1/logical_recovery_0651.conf

JP1/Baseディレクトリ※1/physical_anyany.conf

JP1/Baseディレクトリ※1/physical_ipip.conf

JP1/Baseディレクトリ※1/logical_ipip.conf

JP1/Baseディレクトリ※1/jp1bs_baselog_setup.conf
操作ログ定義ファイル

注※1　「JP1/Baseディレクトリ」の部分は，次のディレクトリに置き換えてください。

物理ホストの場合：/etc/opt/jp1base/conf

論理ホストの場合：共有ディレクトリ/jp1base/conf

注※2　ログファイルトラップ動作定義ファイルは任意の名称に設定できます。使用しているファイルを，忘れずにバックアップしてください。なお，ログファイルトラップを使用していない場合には，このファイルは存在しません。

注※3　配布定義ファイルはデフォルトのファイル名または任意の名称で作成できます。使用しているファイルを，忘れずにバックアップしてください。なお，定義情報の収集および配布機能を使用していない場合には存在しません。

注※4　「Eventディレクトリ」の部分は，次のディレクトリに置き換えてください。

物理ホストの場合：/etc/opt/jp1base/conf/event/servers/default

論理ホストの場合：共有ディレクトリ/event

なお，クラスタ運用している場合は，クラスタシステム用の設定をした際に指定したディレクトリ内から上記表に該当する定義ファイルをバックアップしてください。

注意事項

統合トレースログの設定は，バックアップとリカバリーの対象ではありません。設定を変更した場合は，JP1/Baseのセットアップをする際に，再度設定し直してください。

(b)　共通定義情報のバックアップ

JP1/Baseでは，定義ファイルだけでなく，共通定義情報もバックアップする必要があります。なお，この共通定義情報には，JP1/Baseのほかに，JP1/IM，JP1/AJSの定義情報も含まれています。ただし，個々の製品の定義情報を別々に取得することはできません。

共通定義情報をバックアップするには，次のコマンドを実行してください。

jbsgetcnf > 退避ファイル

なお，クラスタ運用している場合は，次のようにコマンドを実行してください。

jbsgetcnf -h 論理ホスト名 > 退避ファイル

(2)　イベントDBのバックアップ

イベントDBのバックアップは次の2種類あります。

リカバリーを目的としたバックアップ

障害レポートとしてのバックアップ

(a)　リカバリーを目的としたバックアップ

イベントDBファイルのバックアップ手順を次に示します。

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

イベントDBファイルをコピーするなど任意の方法で，バックアップする。
バックアップの対象のファイルは次のとおりです。
/var/opt/jp1base/sys/event/servers/default/IMEvent*.*※
または，
共有ディレクトリ/event/IMEvent*.*※
注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するディレクトリに別のパスを指定している場合は，指定したパス以下のファイルが対象となります。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

(b)　障害レポートとしてのバックアップ

障害レポートとしてバックアップする場合は，jevexportコマンドを使用してイベントDBの内容をcsvファイルに出力します。

なお，イベントDBは，イベントサーバごとに二つ存在し，一つが上限値（デフォルトでは10メガバイト）を超えると，もう一方のイベントDBに切り替わります。この際，使用するイベントDBの内容は消去されます。イベントDBの容量を定期的に確認して，イベントDBが切り替わる前にjevexportコマンドを実行してください。

(3)　設定情報のリカバリー

JP1/Baseのリカバリーについて説明します。クラスタ運用している場合は，物理ホスト，論理ホストの順番で，各環境をリカバリーしてください。

(a)　定義ファイルのリカバリー

下記の条件を確認した上で，バックアップファイルを，元の位置にリカバリーしてください。

JP1/Baseが正常にインストールされ，セットアップコマンドが実行済みであること。

JP1/Baseが停止していること。

論理ホスト環境のJP1/Baseがセットアップされていること（論理ホストの場合）。

共有ディスクをオンラインにしていること（論理ホストの場合）。

(b)　共通定義情報のリカバリー

「(a)　定義ファイルのリカバリー」に加えて，共通定義情報をリカバリーする必要があります。

次に示すコマンドを実行してください。

jbssetcnf 退避ファイル名

退避ファイル名にはjbsgetcnfコマンドで取得した退避ファイルを指定します。

(4)　イベントDBのリカバリー

バックアップしたイベントDBファイルをリカバリーした場合に，動作保証できる条件を次に示します。

バックアップとリカバリーの時間差が少ない。または，バックアップしてからリカバリーする間に登録されたJP1イベントの件数が少ない場合。

ホスト名を変更しないでマシンを変更した場合。

イベントDBファイルのリカバリー手順を次に示します。

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

バックアップしたファイルをディレクトリに配置する。
配置するディレクトリは次のとおりです。
/var/opt/jp1base/sys/event/servers/default/※
または，
共有ディレクトリ/event/※
注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するディレクトリに別のパスを指定している場合は，指定したパス以下に配置してください。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

3.　クラスタシステムで運用する場合の設定

JP1/Baseは，Microsoft Cluster Serverなどのクラスタソフトに対応しています。クラスタソフトと連携して運用すると，JP1/Baseの可用性を向上できます。この章では，JP1/Baseのクラスタ運用およびセットアップ方法について説明します。

なお，JP1/Baseをクラスタシステムで運用する場合には，ご使用になるクラスタソフトに，JP1/Baseが対応しているか確認してから運用してください。

＜この章の構成＞

3.1　クラスタ運用の概要

3.2　クラスタ運用の前提条件とサポート範囲

3.3　クラスタ運用でのJP1/Baseの機能

3.4　クラスタ運用の環境設定（Windowsの場合）

3.5　クラスタ運用の環境設定（UNIXの場合）

3.6　クラスタ運用中の設定変更時の作業

3.7　論理ホストの削除

3.8　クラスタ運用に関する注意事項

3.9　非クラスタ環境で論理ホストを運用する場合の設定

3.1　クラスタ運用の概要

ここでは，クラスタシステムの概要と，JP1/Baseのクラスタ運用の概要について説明します。

＜この節の構成＞

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

3.1.2　JP1/Baseのクラスタ運用の概要

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

クラスタシステムとは，複数のサーバシステムを連携して一つのシステムとして運用するシステムで，一つのサーバで障害が発生しても，別のサーバで業務を継続できるようにすることを目的としています。

クラスタシステムは，処理を実行するホストと，障害が発生した時に処理を引き継げるように待機しているホストで構成されています。業務を実行中のサーバを実行系サーバ，実行系の障害時に業務を引き継げるよう待機しているサーバを待機系サーバと呼びます。障害発生時は，実行系サーバから待機系サーバに処理を引き継いで業務の停止を防ぎます。この障害時に処理を引き継ぐことをフェールオーバーといいます。

フェールオーバーする単位となる論理的なサーバのことを論理ホストといいます。クラスタシステムで実行されるアプリケーションは，フェールオーバーして業務を継続するために，論理ホスト環境で動作させる必要があります。論理ホストで動作するアプリケーションは，物理的なサーバに依存しないで，任意のサーバで動作できます。

論理ホストは，サービスとして動作するアプリケーション，共有ディスク，および論理IPアドレスの三つの要素で構成されています。サービスとして動作するJP1などのアプリケーションは，共有ディスクにデータを格納し，論理IPアドレスで通信を行います。

論理ホストを構成する各要素について次の表で説明します。

表3-1　論理ホストの構成要素

論理ホストの構成要素 | 説明
サービス | クラスタシステムで実行するJP1などのアプリケーションです。実行系の論理ホストで障害が発生すると，待機系の論理ホストで同じ名称のサービスを起動し，処理を引き継ぎます。
共有ディスク | 実行系と待機系の両方に接続されたディスク装置です。フェールオーバー時に引き継ぐ情報（定義情報，実行状況など）を保存すると，実行系の論理ホストで障害が発生した場合，待機系のサーバが共有ディスクへの接続を引き継ぎます。
論理IPアドレス | 論理ホストの動作中に割り当てられるIPアドレスです。実行系のサーバで障害が発生したときは，同じ論理IPアドレスの割り当てを待機系のサーバが引き継ぎます。そのため，クライアントからは同じIPアドレスでアクセスでき，一つのサーバが常に動作しているように見えます。

正常時，およびフェールオーバー後のアクセスを次の図に示します。

図3-1　正常時，およびフェールオーバー後のアクセス

実行系サーバが稼働している場合は，実行系サーバで共有ディスクや論理IPアドレスが割り当てられ，サービスが動作します。実行系サーバで障害が発生すると，待機系サーバが共有ディスクと論理IPアドレスを引き継ぎ，実行系サーバと同じサービスを起動します。フェールオーバーによって物理的なサーバが変わっても，待機系サーバが共有ディスクと論理IPアドレスを引き継ぐため，クライアントには同じIPアドレスのサーバが動作しているように見えます。

3.1.2　JP1/Baseのクラスタ運用の概要

ここでは，クラスタシステムでJP1/Baseを運用する概要について説明します。

JP1/Baseを論理ホスト環境で動作させるためには，フェールオーバー時に引き継ぎが必要なデータを格納するための共有ディスク，および論理IPアドレスが必要となります。また，クラスタソフトがJP1/Baseの起動・動作監視・停止を制御できるように，クラスタソフトに登録する必要があります。論理ホストをセットアップすると，引き継ぎが必要なデータを共有ディスクに格納し，論理IPアドレスを使用して通信するように設定されます。論理ホスト環境で実行されるJP1/Baseは，共有ディスクに格納したデータを使用し，フェールオーバー時に実行系から待機系に引き継いで処理を続けられます。

次節以降では，クラスタシステムでJP1/Baseを運用するための前提条件，および環境設定の方法について説明します。

3.2　クラスタ運用の前提条件とサポート範囲

JP1は，クラスタシステムでは論理ホスト環境で動作し，フェールオーバーに対応します。論理ホスト環境で実行する場合のJP1の前提条件は，共有ディスクや論理IPアドレスの割り当て・削除・動作監視がクラスタソフトによって正常に制御されていることです。

注意事項

JP1がサポートしているクラスタソフトであっても，システム構成や環境設定によってはここで説明する前提条件を満たさない場合があります。前提条件を満たすよう，システム構成や環境設定を検討してください。

＜この節の構成＞

(1)　論理ホスト環境の前提条件

(2)　物理ホスト環境の前提条件

(3)　JP1がサポートする範囲

(4)　論理ホストの指定方法

(5)　論理ホスト名の条件

(1)　論理ホスト環境の前提条件

JP1を論理ホスト環境で実行する場合，論理IPアドレスと共有ディスクについて，次に示す前提条件があります。

表3-2　論理ホスト環境の前提条件

論理ホストの
構成要素
前提条件

共有ディスク

実行系から待機系へ引き継ぎ可能な共有ディスクが使用できること。

JP1を起動する前に，共有ディスクが割り当てられること。

JP1を実行中に，共有ディスクの割り当てが解除されないこと。

JP1を停止した後に，共有ディスクの割り当てが解除されること。

共有ディスクが，不当に複数サーバから使用されないよう排他制御されていること。

システムダウンなどでファイルが消えないよう，ジャーナル機能を持つファイルシステムなどでファイルを保護すること。

フェールオーバーしてもファイルに書き込んだ内容が保証されて引き継がれること。

フェールオーバー時に共有ディスクを使用中のプロセスがあっても，強制的にフェールオーバーができること。

共有ディスクの障害を検知した場合の回復処置はクラスタソフトなどが制御し，回復処置をJP1が意識する必要がないこと。回復処置の延長でJP1の起動や停止が必要な場合は，クラスタソフトからJP1に起動や停止の実行要求をすること。

論理IPアドレス

引き継ぎ可能な論理IPアドレスを使って通信できること。

論理ホスト名から論理IPアドレスが一意に求まること。

JP1を起動する前に，論理IPアドレスが割り当てられること。

JP1を実行中に，論理IPアドレスが削除されないこと。

JP1を実行中に，論理ホスト名と論理IPアドレスの対応が変更されないこと。

JP1を停止した後に，論理IPアドレスが削除されること。

ネットワーク障害を検知した場合の回復処置はクラスタソフトなどが制御し，JP1が回復処理を意識する必要がないこと。また，回復処置の延長でJP1の起動や停止が必要な場合は，クラスタソフトからJP1に起動や停止の実行要求をすること。

上記の条件が満たされていない場合は，JP1の動作に問題が起きることがあります。例えば，次のような問題が発生します。

実行系で書き込んだデータが，フェールオーバーした時に壊れてしまう場合
JP1でエラー・データ消失・起動失敗などの問題が発生し，正常に動作できません。

LANボード障害が発生しても回復処理がされない場合
クラスタソフトなどの制御によってLANボードが切り替えられるか，または他サーバへフェールオーバーするまで，通信エラーが発生しJP1は正常に動作できません。

(2)　物理ホスト環境の前提条件

物理ホスト環境でJP1を実行する場合，次に示す前提条件があります。また，論理ホスト環境のJP1だけを実行する場合でも，システム環境として次に示す前提条件を満たしている必要があります。

表3-3　物理ホスト環境の前提条件

物理ホストの
構成要素
前提条件

サーバ本体

2台以上のサーバ機によるクラスタ構成になっていること。

実行する処理に応じたCPU性能があること。
（例えば，論理ホストを多重起動する場合などに，対応できるCPU性能があること）

実行する処理に応じた実メモリー容量があること。
（例えば，論理ホストを多重起動する場合などに，対応できる実メモリー容量があること）

ディスク

システムダウンなどでファイルが消えないよう，ジャーナル機能を持つファイルシステムなどでファイルを保護すること。

ネットワーク

ホスト名（hostnameコマンドの結果）に対応するIPアドレスで通信が可能なこと。
（クラスタソフトなどによって通信ができない状態に変更されないこと）

JP1の動作中に，ホスト名とIPアドレスの対応が変更されないこと。
（クラスタソフトやネームサーバなどによって変更がされないこと）

Windowsの場合，ホスト名に対応したLANボードがネットワークのバインド設定で最優先になっていること。
（ハートビート用などほかのLANボードが優先になっていないこと）

OS，クラスタソフト

JP1がサポートするクラスタソフトおよびバージョンであること。

JP1およびクラスタソフトが前提とするパッチやサービスパックが適用済みであること。

フェールオーバーしても同じ処理ができるよう，各サーバの環境が同じになっていること。

(3)　JP1がサポートする範囲

クラスタシステムでJP1を運用する場合，JP1がサポートする範囲は，JP1自体の動作だけです。論理ホスト環境（共有ディスクおよび論理IPアドレス）の制御はクラスタソフトの制御に依存します。

また，前述の論理ホスト環境および物理ホスト環境の前提条件が満たされていない，または論理ホスト環境の制御に問題がある場合は，JP1の動作に発生した問題もサポートの対象外となります。この場合は，論理ホスト環境を制御しているクラスタソフトやOSで問題に対処してください。

(4)　論理ホストの指定方法

コマンドを実行する場合，論理ホストでコマンドを実行させるために，論理ホスト名を指定する必要があります。論理ホスト名を指定しないと，物理ホストでコマンドが実行されます。論理ホストの指定方法には，論理ホスト名をJP1_HOSTNAME環境変数に設定する方法と，コマンドオプションで指定する方法があります。それぞれについて次の表で説明します。

指定方法 | 説明
JP1_HOSTNAME環境変数 | JP1_HOSTNAME環境変数で，論理ホスト名を指定します。論理ホスト名をコマンドオプションと環境変数の両方で指定した場合は，コマンドオプションの設定が優先されます。
コマンドオプション | 「コマンド -h 論理ホスト名」の形式でコマンドのオプションに指定します。詳細については，各コマンドの説明を参照してください。

注意事項

Windowsの場合，JP1_HOSTNAME環境変数をシステム環境変数，ユーザー環境変数として設定しないでください。サービスの起動などができなくなるおそれがあります。JP1_HOSTNAME環境変数の設定は，コマンドプロンプト，またはバッチファイルで行ってください。

(5)　論理ホスト名の条件

論理ホスト名は次に示す条件で指定してください。

指定できる文字数：Windowsの場合1～196バイト（推奨：63バイト以内）※1，UNIXの場合1～255バイト（推奨：63バイト以内）※1※2

使用できる文字：英数字，-（ハイフン）

注※1　JP1/Baseで指定できる文字数は上記のとおりですが，クラスタソフトで上記文字数に対応していない場合があります。論理ホスト名を指定する場合は，クラスタソフトの制限文字数を超えないよう注意してください。実際の運用では，63バイト以内を推奨します。

注※2　UNIX限定の強制終了コマンド（jbs_killall.cluster）で指定できる論理ホスト名は，15バイトまでです。名称が16バイト以上の論理ホスト名は指定できません。

注意事項

論理ホスト名と物理ホスト名（hostnameコマンドの実行結果）を同じ名称にしてJP1を運用する場合，以下にご注意ください。なお，クラスタシステムで指定する論理ホスト名は，物理ホスト名とは異なる名称を使用することを強く推奨します。

論理ホストのJP1だけを起動する。
論理ホストのJP1だけを起動し，物理ホストのJP1は起動しないでください。

イベントサービス環境の設定を変更する。
イベントサーバインデックスファイル（index）にデフォルトで設定されている「server * default」の行をコメントにしてください。この行が残っている場合，論理ホストのイベントDBがローカルディスクに作成され，フェールオーバーで引き継ぎができません。実行系と待機系それぞれで設定を変更してください。

環境設定ディレクトリの設定を変更する。
物理ホストの環境設定ディレクトリを共有ディレクトリにするために，次の手順で設定を変更してください。実行系と待機系それぞれで設定を変更してください。
Windowsの場合
1.　次の内容の定義ファイルを作成する。
ファイル名は任意です。
[JP1_DEFAULT¥JP1BASE¥]
"JP1BASE_CONFDIR"="共有フォルダ¥jp1base¥conf¥"
2.　次のコマンドを実行し，作成した定義ファイルの内容を共通定義情報に反映する。
jbssetcnf 定義ファイル名
UNIXの場合
1.　次の内容の定義ファイルを作成する。
ファイル名は任意です。
[JP1_DEFAULT¥JP1BASE¥]
"JP1BASE_CONFDIR"="/共有ディレクトリ/jp1base/conf"
2.　次のコマンドを実行し，作成した定義ファイルの内容を共通定義情報に反映する。
/opt/jp1base/bin/jbssetcnf 定義ファイル名

統合トレース（HNTRLib2）を再起動する。
システムの動作中にホスト名を変更する場合は，統合トレース（HNTRLib2）の再起動が必要です。次の手順で再起動してください。
Windowsの場合
1.　［コントロールパネル］の［サービス］ダイアログボックスで手動停止する。
2.　ホスト名を変更する。
3.　［コントロールパネル］の［サービス］ダイアログボックスで手動起動する。
UNIXの場合
1.　hntr2killコマンドを使って統合トレース（HNTRLib2）を停止する。
2.　ホスト名を変更する。
3.　次のコマンドを実行し，統合トレース（HNTRLib2）を起動する。
hntr2mon -d &
統合トレース（HNTRLib2）を再起動するまでの間は，トレース情報が記録されません。統合トレースを使用しているすべてのアプリケーションを停止させてから統合トレースを停止し，起動する場合は，ほかのアプリケーションより先に起動させてください。なお，hntr2killコマンドの詳細については，「13.　コマンド」の「hntr2kill（UNIX限定）」を参照してください。

DNS運用の場合は，論理ホスト名にFQDN形式ではないホスト名を使用してください。例えば，「jp1v7.soft.hitachi.co.jp」の場合は，論理ホスト名を「jp1v7」と指定します。このホスト名で名前解決されるように設定してください。

Windowsの場合，JP1_HOSTNAME環境変数をシステム環境変数，ユーザー環境変数として設定しないでください。サービスの起動などができなくなることがあります。JP1_HOSTNAMEの設定は，コマンドプロンプト，またはバッチファイルで行ってください。

UNIXで強制終了コマンド（jbs_killall.cluster）を使用する場合は，論理ホスト名の先頭～15バイトの範囲で一意になるような名称を指定してください。このコマンドは，論理ホスト名を先頭～15バイトの範囲で判定して，対応するプロセスを強制終了します。名称が16バイト以上の論理ホストのプロセスは強制終了できません。

3.3　クラスタ運用でのJP1/Baseの機能

この節では，クラスタ運用する場合に注意する必要があるJP1/Baseの機能について説明します。

＜この節の構成＞

3.3.1　ログファイルトラップのクラスタ運用

3.3.2　イベントログトラップのクラスタ運用

3.3.3　ヘルスチェックのクラスタ運用

3.3.1　ログファイルトラップのクラスタ運用

ログファイルトラップは，物理ホスト単位で起動します。論理ホスト単位での起動はできません。JP1イベントの登録先を論理ホストのイベントサービスにすると，論理ホストでJP1イベントを管理できます。運用方法に応じてJP1イベントの登録先を変更してください。

デフォルトでは，JP1イベントは物理ホストのイベントサービスへ登録されます。JP1イベントを論理ホストのイベントサービスへ登録したい場合は，jevlogstartコマンドの-sオプションに論理ホストのイベントサーバ名を指定して実行してください。

共有ディスク上のログファイルを監視する場合と，ローカルディスク上のログファイルを監視する場合の運用方法について次に説明します。

(a)　共有ディスク上のログファイルを監視する

共有ディスク上のログファイルを監視する場合は，論理ホストの起動と停止に合わせて，ログファイルトラップを起動および停止する必要があります。フェールオーバー時には，切り替え前のサーバのログファイルトラップを停止して，新たに実行系となったサーバでログファイルトラップを起動してください。

ログファイルトラップ起動定義ファイルを使用すると，フェールオーバー時にログファイルトラップをまとめて停止・起動できます。ログファイルトラップをまとめて停止・起動する場合の動作を次に示します。

図3-2　ログファイルトラップをまとめて停止・起動する場合の動作

ログファイルトラップをまとめて停止・起動する場合，停止・起動するログファイルトラップは，ログファイルトラップ起動定義ファイルに指定します。また，クラスタソフトに，フェールオーバー時に実行するコマンドとしてjevlogstopコマンドおよびjevlogstartコマンドを-clusterオプション指定で登録します。フェールオーバー時，jevlogstart -clusterコマンドが実行されると，新たに実行系となったサーバでログファイルトラップ起動定義ファイルが読み込まれ，起動定義ファイルに指定されたログファイルトラップがまとめて起動されます。また，jevlogstop -clusterコマンドが実行されると，切り替え前のサーバで，以前jevlogstart -clusterコマンドによって起動されたログファイルトラップがまとめて停止されます。

なお，ログファイルトラップ起動定義ファイルを使用した場合は，ログファイルトラップ起動実行結果ログに出力される起動開始情報（KAVA3661-I）および起動結果情報（KAVA3662-I）を参照して，対象のログファイルトラップが起動されたことを確認してください。

フェールオーバー時にログファイルトラップをまとめて停止・起動するための設定方法を次に示します。

ログファイルトラップ起動定義ファイルを編集する。
実行系と待機系のそれぞれで，ログファイルトラップ起動定義ファイルのSTART_OPT_CLSパラメーターに，フェールオーバー時に停止・起動するログファイルトラップを指定します。このとき，START_OPT_CLSパラメーターの指定は，実行系と待機系で一致させてください。なお，複数のクラスタシステムを運用している場合は，クラスタシステムごとに停止・起動するログファイルトラップを指定します。
ログファイルトラップ起動定義ファイルの詳細については，「14.　定義ファイル」の「ログファイルトラップ起動定義ファイル」を参照してください。

クラスタソフトに，jevlogstop（クラスタ運用限定）コマンドおよびjevlogstart（クラスタ運用限定）コマンドを登録する。
コマンドの詳細については，「13.　コマンド」の「jevlogstop（クラスタ運用限定）」および「jevlogstart（クラスタ運用限定）」を参照してください。

なお，共有ディスク上のログファイルの監視中は，共有ディスクを常にアクセスできるように割り当てたままにしてください。ファイル監視中に共有ディスクの割り当て状態を変更すると，共有ディスクの割り当てや割り当て解除の制御に失敗したり，監視処理がエラーになったりするなどの問題が生じるおそれがあります。

共有ディスク上のログファイルを監視する場合の構成例を次の図に示します。

図3-3　共有ディスク上のログファイルを監視する場合の構成例

(b)　ローカルディスク上のログファイルを監視する

実行系と待機系両方のローカルディスク上のログファイルを監視する場合は，変換したJP1イベントをいったん物理ホストのイベントサービスに登録してください。そして，転送設定ファイル（forward）で論理ホストのイベントサービスに転送するよう設定してください。転送設定ファイルの詳細については，「14.　定義ファイル」の「転送設定ファイル」を参照してください。

ローカルディスクのログファイルを論理ホストで監視する場合の構成例を次の図に示します。

図3-4　ローカルディスクのログファイルを論理ホストで監視する場合の構成例

3.3.2　イベントログトラップのクラスタ運用

イベントログトラップは，物理ホスト単位で起動します。論理ホスト単位での起動はできません。JP1イベントの登録先を論理ホストのイベントサービスにすると，論理ホストでJP1イベントを管理できます。運用方法に応じてJP1イベントの登録先を変更してください。

デフォルトでは，JP1イベントは物理ホストのイベントサービスへ登録されます。論理ホストのイベントサービスへ登録したい場合は，動作定義ファイルのserverパラメーターに論理ホストのイベントサーバ名を指定してください。ただし，変換したJP1イベントを直接論理ホストに登録する構成の場合，待機系のイベントログは監視できません。

実行系と待機系の両方のイベントログを監視したい場合は，変換したJP1イベントをいったん物理ホストのイベントサービスに登録してください。そして，物理ホストのイベントサービスに登録されたJP1イベントを，転送設定ファイル（forward）で論理ホストのイベントサービスに転送してください。転送設定ファイルの詳細については，「14.　定義ファイル」の「転送設定ファイル」を参照してください。

実行系と待機系の両方のイベントログを監視する場合の構成例を次の図に示します。

図3-5　実行系と待機系のイベントログを論理ホストで監視する場合の構成例

3.3.3　ヘルスチェックのクラスタ運用

ヘルスチェックは，物理ホスト，論理ホスト単位で動作し，各ホストで動作するプロセスを監視します。ヘルスチェックを使用すると，プロセスの停止だけではなくハングアップも異常と判定し，フェールオーバーさせる運用ができます。

プロセスの異常を検知した場合にフェールオーバーさせるためには，共通定義設定用ファイル（ヘルスチェック機能）でフェールオーバーを有効にします。共通定義設定用ファイル（ヘルスチェック機能）の詳細については，「14.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」を参照してください。

クラスタ環境でヘルスチェックを使用する場合の構成例を次の図に示します。

図3-6　クラスタ環境でヘルスチェックを使用する場合の構成例

図の例は，実行系物理ホスト，待機系物理ホスト，および論理ホストでヘルスチェク機能を使用した場合を示します。自ホストを監視中に論理ホストのヘルスチェックがプロセスの異常を検知した場合は，WindowsではJP1/Baseサービスを停止して，UNIXではヘルスチェック機能のプロセス（jbshcd）を停止します。この停止を検知し，クラスタソフトでフェールオーバーするようにします。

注意事項

他ホストの監視中，エラーを検知している状態でフェールオーバーした場合，監視対象ホストの監視状態がリセットされます。次回監視時に監視対象ホストの状態が回復していないときには，再度エラーメッセージやJP1イベントが発行されます。すでに回復しているときには，回復メッセージやJP1イベントは発行されません。

3.4　クラスタ運用の環境設定（Windowsの場合）

この節では，クラスタ運用に対応するためのJP1/Baseの環境設定について説明します。

＜この節の構成＞

3.4.1　環境設定で設定する項目

3.4.2　インストール

3.4.3　セットアップ

3.4.4　クラスタソフトへの登録

3.4.5　同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定

3.4.1　環境設定で設定する項目

ここでは，環境設定で設定する項目について説明します。実際の設定手順については，「3.4.3　セットアップ」で説明します。

＜この項の構成＞

(1)　共有フォルダの指定

(2)　通信方式の設定

(3)　共通定義情報の設定

(4)　クラスタソフトへの登録

(1)　共有フォルダの指定

論理ホストのセットアップ時に，実行系・待機系の切り替え時に情報を共有するための共有フォルダを指定します。指定した共有フォルダの配下に次の表に示すフォルダ，およびファイルを作成します。

共有ファイルの種別 | 共有ファイルの格納先フォルダ
定義ファイル | 共有フォルダ¥jp1base¥conf¥
ログファイル | 共有フォルダ¥jp1base¥log¥
イベントサーバ設定ファイル | 共有フォルダ¥jp1base¥event¥

共有フォルダは，論理ホストごとに割り当ててください。論理ホストが異なる場合は，必ず別の共有フォルダを割り当ててください。共有ディスクのフォルダ構成例を次に示します。

（例）論理ホストnode0の共有フォルダとして「¥shdsk¥node0」を指定する。

¥shdsk¥node0¥jp1base¥conf¥
¥shdsk¥node0¥jp1base¥log¥

なお，イベントサービスは，独自にクラスタの環境を設定できますが，「3.4.3　セットアップ」の手順どおりに環境設定をすると，イベントサーバインデックスファイル（index）に自動的に論理ホスト名と共有フォルダ下のイベントサーバ設定ファイル（conf）を作成します。

(2)　通信方式の設定

JP1/Baseでクラスタシステム用の設定をすると，TCP/IP通信で使うソケットのバインド方法を，自動的にIPアドレス指定方式に変更します。変更の対象は，作成する論理ホストおよび物理ホストの設定です。JP1/Baseの通信方式については，「1.10　JP1/Baseの通信方式」を参照してください。

なお，同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合は，ネットワーク制御の設定が必要です。詳細については，「3.4.5　同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定」を参照してください。

(3)　共通定義情報の設定

JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）は，論理ホストごとの情報を共通定義情報としてローカルディスク上に持っており，論理ホストごとにその情報を同じ内容にする必要があります。

共通定義情報は，次に示す操作をしたときに更新されます。

JP1/Base，およびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の共通定義情報を変更した場合

jbsmkumapコマンド，jbssetumapコマンド，jbsrmumapコマンド，または，GUIでユーザーマッピング情報を変更した場合

jbssetupsrvコマンドまたはGUIで認証サーバを変更した場合

jbsunsetcnfコマンドまたはjp1bshasetupコマンドを実行して，論理ホストの共通定義情報を削除した場合

jbsmkpassコマンド，jbspassmgrコマンド，jbsumappassコマンド，jbsrmumappassコマンド，またはGUIでOSユーザーのパスワード管理情報を変更した場合

jbshostsimportコマンドを実行して，jp1hosts情報を変更した場合

jbschgdsコマンドを実行して，連携するディレクトリサーバを変更した場合

jcocmddefコマンドを実行して，コマンド実行環境を設定した場合

共通定義情報を変更した場合は，「3.6　クラスタ運用中の設定変更時の作業」を参照して，共通定義情報を各サーバ上で一致させる作業を行ってください。

(4)　クラスタソフトへの登録

クラスタソフトが論理ホストのJP1/Baseを制御できるようにするために，論理ホストに対応するJP1/Baseのサービスをクラスタソフトに登録します。論理ホストのサービスは，論理ホストをセットアップしたときに作成されます。

3.4.2　インストール

実行系と待機系それぞれのローカルディスク上にJP1/Baseをインストールしてください。Windowsの場合は，実行系・待機系とも，同じ名称のドライブおよびフォルダにインストールする必要があります。なお，共有ディスク上には，JP1/Baseをインストールしないでください。

07-10以前のJP1/Baseでクラスタシステムをご使用の場合，上書きインストールしたあとに，論理ホスト環境のアップグレードが必要です。論理ホスト環境のアップグレードの詳細設定については，「2.2.3(5)　上書きインストールについて」を参照してください。

3.4.3　セットアップ

JP1/Baseをクラスタシステムで実行するには，物理ホスト環境（実行系および待機系），論理ホスト環境（実行系および待機系）のセットアップが必要です。セットアップの流れを次に示します。

図3-7　クラスタシステムでのセットアップの流れ（Windows）

＜この項の構成＞

(1)　実行系での作業

(2)　待機系での作業

(3)　ワトソン博士によるエラー通知を抑止する（実行系・待機系）

(4)　Microsoftへのエラー報告を抑止する（実行系・待機系）

(1)　実行系での作業

ここでは，実行系の物理ホスト，および論理ホストの設定手順について説明します。

物理ホストのユーザー管理機能を設定する。
物理ホストで認証サーバを運用する場合に設定します。ユーザー管理機能の設定については，「6.1　ユーザー管理の設定（Windowsの場合）」を参照してください。

物理ホストのイベントサーバ設定（conf）の設定を変更する。
イベントサービスの通信方式（portsパラメーター）とJP1イベントの転送のリトライ期限（forward-limitパラメーター）の設定を変更します。
portsパラメーターに，物理ホストが使用するIPアドレス，または物理ホスト名を指定します。
フェールオーバー中はイベントサービスが停止するため，フェールオーバー中に転送失敗となったJP1イベントを再度転送するために，forward-limitパラメーターでリトライ期限を指定します。デフォルトでは，3,600秒の間リトライを行います。
イベントサーバ設定ファイル（conf）の格納先を次に示します。

インストール先フォルダ¥conf¥event¥servers¥default¥

パラメーターの設定例を次に示します。

ports 物理ホストのIPアドレス jp1imevt jp1imevtapi
forward-limit 3600

イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

論理ホストを設定する。

GUIで設定する場合

1.　インストール先フォルダ¥bin¥jp1bshasetup.exeを実行する。

［Baseクラスタ構成の設定］ダイアログボックスが表示されます。

図3-8　［Baseクラスタ構成の設定］ダイアログボックス

2.　［実行系 論理ホストの設定］ボタンをクリックする。

［実行系 論理ホストの設定］ダイアログボックスが表示されます。

図3-9　［実行系 論理ホストの設定］ダイアログボックス

このダイアログボックスで，情報を作成する論理ホスト名，および共有フォルダ，共有ファイルを作成する共有ディスク上のフォルダを指定します。

「指定したフォルダ名¥jp1base¥」フォルダ下に，共有フォルダおよび共有ファイルが作成されます。なお，この指定をする前に，必ず共有ディスクをマウントしておいてください。

3.　［次へ］ボタンをクリックする。

次に示すダイアログボックスが表示されます。

図3-10　［実行系 論理ホストの設定］ダイアログボックス（確認画面）

このダイアログボックスで，設定内容を確認できます。設定内容が正しければ，［完了］ボタンをクリックしてください。

以上で，イベントサービスの通信方式の設定以外の設定が完了します。

4.　論理ホストの認証サーバを設定する。

論理ホストには，物理ホストで設定されている認証サーバが設定されます。物理ホストと異なる認証サーバを設定する場合，GUIで設定してください。詳細については，「6.1.1　使用する認証サーバを指定する」を参照してください。

コマンドを使って設定する場合

次のコマンドを実行します。共有ディスク上に共有フォルダおよび共有ファイルを作成し，認証サーバを設定します。

jbs_setup_cluster -h node0 -d d:¥node0 -a node0

jbs_setup_clusterコマンドの詳細については，「13.　コマンド」の「jbs_setup_cluster（Windows限定）」を参照してください。

論理ホストのユーザー管理機能の設定をする。
論理ホストで認証サーバを運用する場合に設定します。

GUIで設定する場合

1.　Windowsのスタートメニューから［プログラム］－［JP1_Base］－［環境設定］を選択する。

2.　［論理ホスト名の選択］ダイアログボックスでユーザー管理機能の設定をしたい論理ホストを選択する。

コマンドを使って設定する場合

1.　JP1ユーザーを共通定義情報に登録する（論理ホストを認証サーバとして使用する場合だけ）

認証サーバが起動していることを確認したあと，次に示すコマンドを実行して登録します。

jbsadduser -h 論理ホスト名 JP1ユーザー名

登録したJP1ユーザーを確認したい場合は次のコマンドを実行します。

jbslistuser -h 論理ホスト名

2.　ユーザーマッピングの情報を共通定義情報に登録する。

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の格納先を次に示します。

共有フォルダ¥jp1base¥conf¥user_acl¥jp1BsUmap.conf

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の編集後，次のコマンドを実行して登録します。

jbsmkumap -h 論理ホスト名

登録したユーザーマッピング情報を確認したい場合は，次に示すコマンドを実行します。

jbsgetumap -h 論理ホスト名

3.　各物理ホスト上の共通定義情報を一致させる。

上記の設定が完了したあと，「3.6　クラスタ運用中の設定変更時の作業」に記述されている操作をして，各物理ホスト上の情報を一致させます。

4.　JP1ユーザーの操作権限を設定する（論理ホストを認証サーバとして使用する場合だけ）

ユーザー権限レベルファイル（JP1_UserLevel）の格納先を次に示します。

共有フォルダ¥conf¥user_acl¥JP1_UserLevel

ユーザー権限レベルファイル（JP1_UserLevel）の編集後，jbsaclreloadコマンドを実行して設定を反映します。

ユーザー管理機能の設定詳細については，「6.1　ユーザー管理の設定（Windowsの場合）」を参照してください。

認証サーバをクラスタシステムで運用する場合の注意事項

認証サーバの設定ファイルは次のフォルダに格納されます。

共有フォルダ¥jp1base¥conf¥user_acl¥

セカンダリー認証サーバを設置する場合は，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバへコピーする必要があります。その際，セカンダリー認証サーバをクラスタ運用するかしないかで，設定ファイルのコピー先が異なるため注意が必要です。

クラスタ運用する場合のコピー先

共有フォルダ¥jp1base¥conf¥user_acl¥

クラスタ運用しない場合のコピー先

インストール先フォルダ¥conf¥user_acl¥

設定ファイルをコピーしたあとに，次のコマンドを実行して設定を反映させてください。セカンダリー認証サーバをクラスタ運用しない場合は，-hオプションの指定は不要です。

jbs_spmd_reload -h 論理ホスト名

論理ホストのイベントサーバ設定（conf）を変更する。
イベントサービスの通信方式（portsパラメーター）とJP1イベントの転送のリトライ期限（forward-limitパラメーター）の設定を変更します。
portsパラメーターに，論理ホストが使用するIPアドレス，または論理ホスト名を指定します。
フェールオーバー中はイベントサービスが停止するため，フェールオーバー中に転送失敗となったJP1イベントを再度転送するために，forward-limitパラメーターでリトライ期限を指定します。デフォルトでは，3,600秒の間リトライを行います。
イベントサーバ設定ファイル（conf）の格納先を次に示します。

共有フォルダ¥jp1base¥event¥

パラメーターの設定例を次に示します。

ports 論理ホストのIPアドレス jp1imevt jp1imevtapi
forward-limit 3600

イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

注意事項

イベントサーバ設定ファイル（conf）のportsパラメーターに指定したIPアドレスが，hostsなどOSの名前解決で論理ホスト名から求まる優先のIPアドレスと異なる場合には，API設定ファイルに明示的にIPアドレスを指定する必要があります。実行系，待機系共に設定が必要です。

設定例を次に示します。

server 論理ホスト名 keep-alive 論理ホストのIPアドレス

以上で，JP1/Baseの実行系での作業は完了です。

JP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）をインストールしている場合は，各製品のフェールオーバーの設定をしてください。詳細については，マニュアル「JP1/Integrated Management - Manager 構築ガイド」，「JP1/Integrated Management - Manager 運用ガイド」，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，「JP1/Automatic Job Management System 3 運用ガイド」，およびマニュアル「JP1/Power Monitor」を参照してください。

(2)　待機系での作業

待機系での作業は，実行系でのJP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の作業を完了したあとで行います。

ここでは，待機系の物理ホスト，および論理ホストの設定手順について説明します。

物理ホストのユーザー管理機能を設定する。
物理ホストで認証サーバを運用する場合に設定します。ユーザー管理機能の設定については，「6.1　ユーザー管理の設定（Windowsの場合）」を参照してください。

物理ホストのイベントサーバ設定（conf）の設定を変更する。
イベントサービスの通信方式（portsパラメーター）とJP1イベントの転送のリトライ期限（forward-limitパラメーター）の設定を変更します。
portsパラメーターに，物理ホストが使用するIPアドレス，または物理ホスト名を指定します。
フェールオーバー中はイベントサービスが停止するため，フェールオーバー中に転送失敗となったJP1イベントを再度転送するために，forward-limitパラメーターでリトライ期限を指定します。デフォルトでは，3,600秒の間リトライを行います。
イベントサーバ設定ファイル（conf）の格納先を次に示します。

インストール先フォルダ¥conf¥event¥servers¥default¥

パラメーターの設定例を次に示します。

ports 物理ホストのIPアドレス jp1imevt jp1imevtapi
forward-limit 3600

イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

実行系でjbsgetcnfコマンドを実行する。
実行系で次に示すコマンドを実行してください。退避ファイル内に共通定義情報が格納されます。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

退避ファイルを待機系にコピーする。

待機系でjbssetcnfコマンドを実行する。
待機系で次に示すコマンドを実行してください。なお，指定する退避ファイルは，jbsgetcnfコマンドで採取した退避ファイルです。

jbssetcnf 退避ファイル名

論理ホストを設定する。

GUIで設定する場合

1.　インストール先フォルダ¥bin¥jp1bshasetup.exeを実行する。

［Baseクラスタ構成の設定］ダイアログボックスが表示されます。

2.　［待機系 論理ホストの設定］ボタンをクリックする。

［待機系 論理ホストの設定］ダイアログボックスが表示されます。このダイアログボックスで，実行系で設定した論理ホスト名を選択します。

図3-11　［待機系 論理ホストの設定］ダイアログボックス

3.　［次へ］ボタンをクリックする。

選択した論理ホストの設定内容が表示されます。

図3-12　［待機系 論理ホストの設定］ダイアログボックス（確認画面）

このダイアログボックスで，設定内容を確認できます。設定内容が正しければ，［完了］ボタンをクリックしてください。

コマンドを使って設定する場合

次のコマンドを実行します。

jbs_setup_cluster -h node0

jbs_setup_clusterコマンドの詳細については，「13.　コマンド」の「jbs_setup_cluster（Windows限定）」を参照してください。

以上で，JP1/Baseの設定が完了します。

(3)　ワトソン博士によるエラー通知を抑止する（実行系・待機系）

ワトソン博士でアプリケーションエラーのメッセージボックスが表示されると，フェールオーバーできないおそれがあるため，メッセージボックスによるエラーの通知を抑止する必要があります。

エラーの通知を抑止すると，アプリケーションエラーが発生した際の情報取得に影響が出る場合があるためご注意ください。

ワトソン博士によるエラー通知を抑止する手順を次に示します。

ワトソン博士の設定を有効にするため，コマンドプロンプトで「drwtsn32 -i」を入力する。
ワトソン博士が既定のアプリケーションデバッガとしてインストールされます。

スタートメニューから［ファイル名を指定して実行］を選択する。

テキストボックスに「drwtsn32」と入力し，［OK］ボタンをクリックする。
ワトソン博士のダイアログボックスが開きます。

［メッセージボックスによる通知］のチェックを外す。

［OK］ボタンをクリックする。

(4)　Microsoftへのエラー報告を抑止する（実行系・待機系）

Windowsでは，アプリケーションエラーが発生すると，Microsoftへエラーを報告するダイアログボックスが表示されます。このダイアログボックスが表示されるとフェールオーバーできないおそれがあるため，エラー報告を抑止する必要があります。

Microsoftへのエラー報告を抑止する手順を次に示します。

Windows Server 2003の場合

［コントロールパネル］の「システム」を選択する。
［システムのプロパティ］ダイアログボックスが開きます。

［詳細設定］タブの［エラー報告］ボタンをクリックする。
［エラー報告］ダイアログボックスが開きます。

「エラー報告を無効にする」のラジオボタンを選択したあと，［重大なエラーが発生した場合は通知する］のチェックを外す。

［OK］ボタンをクリックする。

3.4.4　クラスタソフトへの登録

使用するクラスタソフトに，論理ホストのJP1/Baseのサービスを登録してください。Windowsの場合，クラスタソフトに登録するのは，環境設定で登録された次の名称のサービスです。

名前 | サービス名
JP1/Base_論理ホスト名 | JP1_Base_論理ホスト名
JP1/Base Event 論理ホスト名 | JP1_Base_Event 論理ホスト名

注意事項

「JP1_Base_Event 論理ホスト名」の「論理ホスト名」は，このマニュアルのイベントサービスに関する記述の「イベントサーバ名」に対応しています。

登録方法の詳細については，各クラスタソフトのマニュアルを参照してください。また，指定の際は，次の点に注意してください。

サービスは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。また，アプリケーションプログラムのフェールオーバーに伴ってフェールオーバーする場合は，アプリケーションプログラムも一緒に引き継がれるようにしてください。

論理IPアドレスと共有ディスクが使用可能になったあと，「JP1_Base_Event 論理ホスト名」を起動し，そのあとに「JP1_Base_論理ホスト名」を起動するように設定してください。JP1/IMやJP1/AJSについては，「JP1_Base_論理ホスト名」のあとに起動するように設定してください。また，停止する場合は，起動時と逆の順序で停止するように設定してください。

3.4.5　同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定

同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合，ネットワーク制御の設定が必要です。次に示す手順でネットワーク制御を設定してください。

テキストエディター（メモ帳など）で次に示すような定義ファイルを作成する。
物理ホスト名 物理IPアドレス #ノード1
物理ホスト名 物理IPアドレス #ノード2
定義ファイルのファイル名は任意です。物理ホスト名と物理IPアドレスは，そのホストの環境に合わせて定義してください。物理ホスト名には，hostnameコマンドを実行した結果，表示されるホスト名を指定してください。また，物理ホスト名と物理IPアドレスの間は，一つ以上の半角スペースかタブで区切ってください。#以降は改行されるまでコメント扱いとなります。なお，ファイルの最終行には改行を入れてください。
（例）jp1-node1（IPアドレスは100.100.100.1）とjp1-node2（IPアドレスは100.100.100.2）の2ノードクラスタ，論理ホストjp1-clusterの場合，次に示す定義ファイルを作成します。
jp1-node1 100.100.100.1
jp1-node2 100.100.100.2

共通定義情報に設定を反映する。
jbshostsimportコマンドを実行して，定義ファイルの内容を物理ホスト，論理ホストの共通定義情報に反映します。jbshostsimportコマンドの詳細については，「13.　コマンド」の「jbshostsimport」を参照してください。
（例）物理ホスト，論理ホストの共通定義情報に反映するために，次に示すようにjbshostsimportコマンドを実行します。
物理ホスト，論理ホストのJP1/Baseのサービスを停止
c:¥>インストール先フォルダ¥bin¥jbshostsimport -o 定義ファイル名
c:¥>インストール先フォルダ¥bin¥jbshostsimport -o 定義ファイル名 -h jp1-cluster
物理ホスト，論理ホストのJP1/Baseのサービスを起動

共通定義情報に反映した内容を確認する。
次に示すコマンドを実行して，反映した内容が正しいか確認します。
（例）
物理ホストjp1-node1の設定確認
c:¥>インストール先フォルダ¥bin¥jp1ping jp1-node1
LogicalHostnameKey : no define. use JP1_DEFAULT
jp1hosts : Use jp1hosts entry in JP1_DEFAULT
Search jp1hosts : jp1-node1 is found.
Resolved Host List : jp1-node1 -> jp1-node1(100.100.100.1)
：
物理ホストjp1-node2の設定確認
c:¥>インストール先フォルダ¥bin¥jp1ping jp1-node2
LogicalHostnameKey : no define. use JP1_DEFAULT
jp1hosts : Use jp1hosts entry in JP1_DEFAULT
Search jp1hosts : jp1-node2 is found.
Resolved Host List : jp1-node2 -> jp1-node2(100.100.100.2)
：
論理ホストjp1-clusterの設定確認
c:¥>インストール先フォルダ¥bin¥jp1ping -h jp1-cluster jp1-node1
LogicalHostnameKey : jp1-cluster
jp1hosts : Use jp1hosts entry in jp1-cluster
Search jp1hosts : jp1-node1 is found.
Resolved Host List : jp1-node1 -> 100.100.100.1(100.100.100.1)
：
c:¥>インストール先フォルダ¥bin¥jp1ping -h jp1-cluster jp1-node2
LogicalHostnameKey : jp1-cluster
jp1hosts : Use jp1hosts entry in jp1-cluster
Search jp1hosts : jp1-node2 is found.
Resolved Host List : jp1-node2 -> 100.100.100.2(100.100.100.2)
：
この例のように，Resolved Host Listの行に，設定したとおりに「物理IPアドレス」が表示されている場合は，正しく設定されています。もし，設定した内容と表示が異なる場合は，定義ファイルを見直してやり直してください。

3.5　クラスタ運用の環境設定（UNIXの場合）

この節では，クラスタ運用に対応するためのJP1/Baseの環境設定について説明します。

＜この節の構成＞

3.5.1　環境設定で設定する項目

3.5.2　インストール

3.5.3　セットアップ

3.5.4　クラスタソフトへの登録

3.5.1　環境設定で設定する項目

ここでは，環境設定で設定する項目について説明します。実際の設定手順については，「3.5.3　セットアップ」で説明します。

＜この項の構成＞

(1)　共有ディスク上への共有ファイルの作成

(2)　通信方式の設定

(3)　共通定義情報の設定

(4)　クラスタソフトへの登録

(1)　共有ディスク上への共有ファイルの作成

実行系・待機系の切り替え時に情報を共有するために，次の表に示すディレクトリ，およびファイルを共有ディスク上に作成します。

共有ファイルの種別 | 共有ファイルの格納先ディレクトリ
定義ファイル | 共有ディレクトリ/jp1base/conf/
ログファイル | 共有ディレクトリ/jp1base/log/
イベントサーバ設定ファイル | 共有ディレクトリ/event/

ディレクトリは，論理ホストごとに割り当ててください。論理ホストが異なる場合は，必ず別のディレクトリを割り当ててください。論理ホストごとに割り当てたディレクトリの下位に，共有するディレクトリ，ファイルを作成します。

共有ディスクのディレクトリ構成例を次に示します。

（例）論理ホストnode0の共有ディレクトリとして「/shdsk/node0」を指定する。

/shdsk/node0/jp1base/conf/
/shdsk/node0/jp1base/log/

なお，イベントサービスは，独自にクラスタ運用の環境を設定できますが，「3.5.3　セットアップ」の手順どおりに環境設定をすると，イベントサーバインデックスファイル（index）に自動的に論理ホスト名と共有ディレクトリ下のイベントサーバ設定ファイル（conf）を作成します。

(2)　通信方式の設定

JP1/Baseでクラスタシステム用の設定をすると，TCP/IP通信で使うソケットのバインド方法を，自動的にIPアドレス指定方式に変更します。変更の対象は，作成する論理ホストおよび物理ホストの設定です。JP1/Baseの通信方式については，「1.10　JP1/Baseの通信方式」を参照してください。

(3)　共通定義情報の設定

JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）は，論理ホストごとの情報を共通定義情報としてローカルディスク上に持っており，論理ホストごとにその情報を同じ内容にする必要があります。

共通定義情報は，次に示す操作をしたときに更新されます。

JP1/Base，およびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の共通定義情報を変更した場合

jbsmkumapコマンド，jbssetumapコマンド，またはjbsrmumapコマンドを実行して，ユーザーマッピング情報を変更した場合

jbssetusrsrvコマンドを実行して，認証サーバを変更した場合

jbsunsetcnfコマンドを実行して，論理ホストの共通定義情報を削除した場合

jbshostsimportコマンドを実行して，jp1hosts情報を変更した場合

jcocmddefコマンドを実行して，コマンド実行環境を設定した場合

共通定義情報を変更した場合は，「3.6　クラスタ運用中の設定変更時の作業」を参照して，共通定義情報を各サーバ上で一致させる作業を行ってください。

(4)　クラスタソフトへの登録

論理ホストを起動，停止する場合，クラスタソフトは，サービス・共有ディスク・論理IPアドレスの起動や停止，割り当てや解放などを制御します。共有ディスクや論理IPアドレスの制御はクラスタソフトがあらかじめ機能として持っていますが，サービスを制御する機能は持っていないため，サービスを制御するための機能をクラスタソフトに登録する必要があります。

クラスタソフトに登録する機能と，各機能で使用するコマンドを次の表に示します。

登録する機能 | 説明 | 使用するコマンド
起動 | JP1/Baseを起動します。 | jbs_start.cluster 論理ホスト名
停止 | JP1/Baseを停止します。 | jbs_stop.cluster 論理ホスト名
動作監視 | JP1/Baseが正常に動作していることを監視します。または，その時点で正常に動作しているかどうかを確認します。なお，この機能を提供していないクラスタソフトもあります。JP1/Baseの障害時にフェールオーバーする必要がない場合，この機能は登録しません。 | jbs_spmd_status -h 論理ホスト名
強制停止 | JP1/Baseを強制的に停止し，使用中のリソースを解放します。 | jbs_killall.cluster 論理ホスト名

なお，jbs_start.clusterコマンドおよびjbs_stop.clusterコマンド内では，次に示すコマンドが実行されます。

jbs_start.clusterコマンド内で実行されるコマンド

jevstart 論理ホスト名（イベントサービスを起動するコマンド）

jbs_spmd -h 論理ホスト名（イベントサービス以外のJP1/Baseのプロセスを起動するコマンド）

jbs_stop.clusterコマンド内で実行されるコマンド

jevstop 論理ホスト名（イベントサービスを停止するコマンド）

jbs_spmd_stop -h 論理ホスト名（イベントサービス以外のJP1/Baseのプロセスを停止するコマンド）

注意事項

jevstartコマンドおよびjevstopコマンドに指定する論理ホスト名は，このマニュアルのイベントサービスに関する記述の「イベントサーバ名」に対応しています。

3.5.2　インストール

実行系，待機系それぞれのローカルディスク上にJP1/Baseをインストールしてください。なお，共有ディスク上には，JP1/Baseをインストールしないでください。

07-10以前のJP1/Baseでクラスタシステムをご使用の場合，上書きインストールしたあとに，論理ホスト環境のアップグレードが必要です。論理ホスト環境のアップグレードの詳細設定については，「2.3.4(5)　上書きインストールについて」を参照してください。

3.5.3　セットアップ

JP1/Baseをクラスタシステムで実行するには，物理ホスト環境（実行系および待機系），論理ホスト環境（実行系および待機系）のセットアップが必要です。セットアップの流れを次に示します。なお，セットアップする前に，物理ホストで言語種別を設定する必要があります。言語種別の設定方法については，「2.3.5(2)　言語種別の設定」を参照してください。

図3-13　クラスタシステムでのセットアップの流れ（UNIX）

＜この項の構成＞

(1)　実行系での作業

(2)　待機系での作業

(1)　実行系での作業

実行系での作業手順を次に示します。

物理ホストのユーザー管理機能を設定する（物理ホストで認証サーバを運用する場合）。
物理ホストで認証サーバを運用する場合に設定します。ユーザー管理機能の設定については，「6.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

物理ホストのイベントサーバ設定（conf）の設定を変更する。
イベントサービスの通信方式（portsパラメーター）とJP1イベントの転送のリトライ期限（forward-limitパラメーター）の設定を変更します。
portsパラメーターに，物理ホストが使用するIPアドレス，または物理ホスト名を指定します。
フェールオーバー中はイベントサービスが停止するため，フェールオーバー中に転送失敗となったJP1イベントを再度転送するために，forward-limitパラメーターでリトライ期限を指定します。デフォルトでは，3,600秒の間リトライを行います。
イベントサーバ設定ファイル（conf）の格納先を次に示します。

/etc/opt/jp1base/conf/event/servers/default/

パラメーターの設定例を次に示します。

ports 物理ホストのIPアドレス jp1imevt jp1imevtapi
forward-limit 3600

イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

論理ホストを設定する。
次のコマンドを実行します。共有ディスク上に共有ディレクトリおよび共有ファイルを作成し，認証サーバを設定します。

jp1base_setup_cluster -h node0 -d /shdsk/node0 -a node0 -s

jp1base_setup_clusterコマンドの詳細については，「13.　コマンド」の「jp1base_setup_cluster（UNIX限定）」を参照してください。

論理ホストのユーザー管理機能を設定する。
論理ホストを認証サーバにしている場合のJP1ユーザーの登録，ユーザーマッピングの設定，JP1ユーザーの操作権限の設定を次に示します。

JP1ユーザーを共通定義情報に登録する（論理ホストを認証サーバとして使用する場合だけ）
認証サーバが起動していることを確認したあと，次に示すコマンドを実行して登録します。
jbsadduser -h 論理ホスト名 JP1ユーザー名
登録したJP1ユーザーを確認したい場合は次のコマンドを実行します。
jbslistuser -h 論理ホスト名

ユーザーマッピングの情報を共通定義情報に登録する。
ユーザーマッピング定義ファイル（jp1BsUmap.conf）の格納先を次に示します。
共有ディレクトリ/jp1base/conf/user_acl/jp1BsUmap.conf
ユーザーマッピング定義ファイル（jp1BsUmap.conf）の編集後，次のコマンドを実行して登録します。
jbsmkumap -h 論理ホスト名
登録したユーザーマッピング情報を確認したい場合は，次に示すコマンドを実行します。
jbsgetumap -h 論理ホスト名

各物理ホスト上の共通定義情報を一致させる。
上記の設定が完了したあと，「3.6　クラスタ運用中の設定変更時の作業」に記述されている操作をして，各物理ホスト上の情報を一致させます。

JP1ユーザーの操作権限を設定する（論理ホストを認証サーバとして使用する場合だけ）
ユーザー権限レベルファイル（JP1_UserLevel）の格納先を次に示します。
共有ディレクトリ/jp1base/conf/user_acl/JP1_UserLevel
ユーザー権限レベルファイル（JP1_UserLevel）の編集後，jbsaclreloadコマンドを実行して設定を反映します。

ユーザー管理機能の設定詳細については，「6.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

認証サーバをクラスタシステムで運用する場合の注意事項

認証サーバの設定ファイルは次のディレクトリに格納されます。

共有ディレクトリ/jp1base/conf/user_acl/

セカンダリー認証サーバを設置する場合は，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバへコピーする必要があります。その際，セカンダリー認証サーバをクラスタ運用するかしないかで，設定ファイルのコピー先が異なるため注意が必要です。

クラスタ運用する場合のコピー先

共有ディレクトリ/jp1base/conf/user_acl/

クラスタ運用しない場合のコピー先

/etc/opt/jp1base/conf/user_acl/

設定ファイルをコピーしたあとに，次のコマンドを実行して設定を反映させてください。セカンダリー認証サーバをクラスタ運用しない場合は，-hオプションの指定は不要です。

jbs_spmd_reload -h 論理ホスト名

認証サーバをクラスタシステムで運用しない場合の注意事項

jp1base_setup_clusterコマンドで-sオプションを省略して実行すると，その論理ホストのJP1/Baseでは認証サーバのプロセスは起動しません。

jp1base_setup_clusterコマンド実行後に，構成変更をして論理ホストで認証サーバのプロセスを起動したい場合は以下の手順で設定変更をしてください。

1.　JP1/Baseを停止する。

構成変更をする論理ホストおよび論理ホストのJP1/Baseと依存関係を持つプログラムも停止してください。

2.　定義ファイルを変更する。

以下のコマンドを実行して，JP1/Baseのプロセス定義ファイルを変更してください。

cd /共有ディレクトリ/jp1base/conf

cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

3.　JP1/Baseを再起動する。

構成変更をする論理ホストおよび論理ホストのJP1/Baseと依存関係を持つプログラムも再起動してください。

上記定義の変更はJP1/Baseを再起動すれば反映されます。

論理ホストのイベントサーバ設定（conf）を変更する。
イベントサービスの通信方式（portsパラメーター）とJP1イベントの転送のリトライ期限（forward-limitパラメーター）の設定を変更します。
portsパラメーターに，論理ホストが使用するIPアドレス，または論理ホスト名を指定します。
フェールオーバー中はイベントサービスが停止するため，フェールオーバー中に転送失敗となったJP1イベントを再度転送するために，forward-limitパラメーターでリトライ期限を指定します。デフォルトでは，3,600秒の間リトライを行います。
イベントサーバ設定ファイル（conf）の格納先を次に示します。

共有ディレクトリ/event/

パラメーターの設定例を次に示します。

ports 論理ホストのIPアドレス jp1imevt jp1imevtapi
forward-limit 3600

イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

以上で，実行系での作業は完了です。

JP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）をインストールしている場合，各製品のフェールオーバーの設定をしてください。詳細については，マニュアル「JP1/Integrated Management - Manager 構築ガイド」，「JP1/Integrated Management - Manager 運用ガイド」，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，「JP1/Automatic Job Management System 3 運用ガイド」，およびマニュアル「JP1/Power Monitor」を参照してください。

(2)　待機系での作業

待機系での作業は，実行系でのJP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の設定が完了したあとで行います。次に作業手順を示します。

物理ホストのユーザー管理機能を設定する（物理ホストで認証サーバを運用する場合）。
物理ホストで認証サーバを運用する場合に設定します。ユーザー管理機能の設定については，「6.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

物理ホストのイベントサーバ設定（conf）の設定を変更する。
イベントサービスの通信方式（portsパラメーター）とJP1イベントの転送のリトライ期限（forward-limitパラメーター）の設定を変更します。
portsパラメーターに，物理ホストが使用するIPアドレス，または物理ホスト名を指定します。
フェールオーバー中はイベントサービスが停止するため，フェールオーバー中に転送失敗となったJP1イベントを再度転送するために，forward-limitパラメーターでリトライ期限を指定します。デフォルトでは，3,600秒の間リトライを行います。
イベントサーバ設定ファイル（conf）の格納先を次に示します。

/etc/opt/jp1base/conf/event/servers/default/

パラメーターの設定例を次に示します。

ports 物理ホストのIPアドレス jp1imevt jp1imevtapi
forward-limit 3600

イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

実行系でjbsgetcnfコマンドを実行する。
実行系で次に示すコマンドを実行してください。退避ファイル内に共通定義情報が格納されます。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

退避ファイルを待機系にコピーする。

待機系でjbssetcnfコマンドを実行する。
待機系で次に示すコマンドを実行してください。なお，指定する退避ファイルは，jbsgetcnfコマンドで採取した退避ファイルです。

jbssetcnf 退避ファイル名

論理ホストを設定する。
次のコマンドを実行します。
jp1base_setup_cluster -h node0
jp1base_setup_clusterコマンドの詳細については，「13.　コマンド」の「jp1base_setup_cluster（UNIX限定）」を参照してください。

以上で，JP1/Baseの設定が完了します。

3.5.4　クラスタソフトへの登録

使用するクラスタソフトに，JP1/Baseのデーモンを登録してください。登録方法の詳細については，各クラスタソフトのマニュアルを参照してください。また，指定の際は，次の点に注意してください。

デーモンは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。また，アプリケーションプログラムのフェールオーバーに伴ってフェールオーバーする場合は，アプリケーションプログラムも一緒に引き継がれるようにしてください。

論理IPアドレスと共有ディスクが使用可能になったあと，JP1/Baseを起動し，そのあとにJP1/IMやJP1/AJSを起動するように設定してください。また，停止する場合は，起動時と逆の順序で停止するように設定してください。

JP1/Baseをクラスタソフトへ登録する場合に必要な情報を次の表に示します。

登録する機能
説明

起動
JP1/Baseを起動します。

使用するコマンド
jbs_start.cluster 論理ホスト名

起動コマンドの終了タイミング
起動コマンドは，JP1/Baseが起動するのを待って終了します。ただし，何らかの問題によって，タイムアウト時間（標準60秒）を過ぎても起動処理が完了しない場合は，起動処理の途中でコマンドが終了します。この場合，起動処理は中断しないで，起動処理を続けている状態のままコマンドが終了します。

起動コマンドの結果判定
JP1/Baseを起動した結果は，この表の動作監視の項目を参照して判定してください。通常は，クラスタソフトの動作監視によって判定します。なお，起動コマンドの戻り値は，0（正常終了）と1（引数異常）のため，戻り値での結果判定はできません。

停止
JP1/Baseを停止します。

使用するコマンド
jbs_stop.cluster 論理ホスト名

停止コマンドの終了タイミング
停止コマンドは，JP1/Baseが停止するのを待って終了します。ただし，何らかの問題によって，タイムアウト時間（標準60秒）を過ぎても停止処理が完了しない場合は，停止処理の途中でコマンドが終了します。この場合，停止処理は中断しないで，停止処理を続けている状態のままコマンドが終了します。

停止コマンドの結果判定
JP1/Baseを停止した結果は，この表の動作監視の項目を参照して判定してください。なお，停止コマンドの戻り値は，0（正常終了）と1（引数異常）のため，戻り値での結果判定はできません。

〈備考〉

停止コマンドが終了したあと，念のため，この表の強制停止の項目で説明しているコマンドを実行することを推奨します。これは，何らかの問題がある場合でも確実にプロセスを終了させ，フェールオーバーが失敗することを防ぐためです。

動作監視
JP1/Baseが正常に動作していることを，jbs_spmd_statusコマンドおよびjevstatコマンドの戻り値によって監視します。なお，これらのコマンドでは，各プロセスが動作しているか，動作していないかで動作状態を判定しています。
この機能を提供していないクラスタソフトもあります。JP1/Baseの障害時にフェールオーバーする必要がない場合，この機能は登録しません。

使用するコマンド
jbs_spmd_status -h論理ホスト名
jevstat 論理ホスト名

動作監視の結果判定
各戻り値の判定方法を次に示します。
戻り値=0 (すべて動作)
JP1/Baseは正常に動作しています。
戻り値=1 (エラー)
回復不能なエラーが発生しました。異常と判定してください。
〈注意〉
共有ディスクがオフラインの待機系でjbs_spmd_statusコマンドを実行すると，共有ディスクがないため戻り値が1になります。
戻り値=4 (一部停止)
JP1/Baseの一部のプロセスが，何らかの問題によって停止しています。異常と判定してください（UNIXの場合）。※
戻り値=8 (すべて停止)
JP1/Baseのプロセスが何らかの問題によって停止しています。異常と判定してください。
戻り値=12 (リトライ可能エラー)
jbs_spmd_statusコマンドによる動作状態の確認中に，リトライによって復旧可能なエラーが発生しました。一定回数を限度に，動作状態の確認をリトライしてください。なお，この戻り値は，jevstatコマンドではリトライ不可エラーとなります。

強制停止
JP1/Baseを強制的に停止し，使用中のリソースを解放します。

使用するコマンド
jbs_killall.cluster 論理ホスト名

jbs_killall.clusterコマンドを実行すると，JP1/Baseの終了処理を一切行わずに，各プロセスを強制的に停止します。

〈注意〉

強制停止をする前に，停止コマンドによってJP1/Baseを停止してください。強制停止のコマンドは，停止コマンドを実行しても処理が終了しないなど，問題が発生した場合に限り実行してください。

※　Windowsの場合は，Windowsのサービス制御との関連によって，UNIXの場合とは動作が異なります。Windowsでは，プロセスの一部が停止すると，JP1のプロセス管理が自動的にすべての各プロセスを停止して，サービスを停止状態にします。サービスの停止によって異常と判定するか，jbs_spmd_statusコマンドの戻り値が8になるのを待ってから異常と判定してください。

〈備考〉JP1の再起動について

クラスタ運用のJP1の障害を検知した場合に，待機系サーバにフェールオーバーする前に，同じサーバでJP1を再起動して回復を試みる場合があります。

この場合は，JP1のプロセス管理による再起動ではなく，クラスタソフトの制御による再起動を推奨します。

クラスタソフトはJP1の障害検知後に再起動を試みるため，障害の内容によってはJP1の再起動機能が影響を受け，正常に動作できないおそれがあります。より確実に再起動するために，クラスタソフトからの制御でJP1を再起動してください。

3.6　クラスタ運用中の設定変更時の作業

この節では，クラスタ運用中に実行系で設定を変更した場合に，待機系にも変更を反映し，実行系と待機系の両方で一致させる必要のある項目について説明します。

JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）は，論理ホストごとの情報を共通定義情報としてローカルディスクに持っています。そのためクラスタ運用中に共通定義情報の設定を変更した場合，実行系と待機系の論理ホストの共通定義情報を一致させる必要があります。

共通定義情報が変更される実行系での操作と，待機系へ共通定義情報を反映する方法を次の表に示します。なお，この操作は，JP1/BaseおよびJP1/Baseを前提とするすべての製品に影響を与えるため注意してください。また作業の前後で共通定義情報のバックアップを取得することをお勧めします。共通定義情報のバックアップ方法については，「2.5.2 バックアップとリカバリー（Windowsの場合）」または「2.5.3 バックアップとリカバリー（UNIXの場合）」を参照してください。

表3-4　共通定義情報が更新される実行系での操作と待機系への反映方法

機能
実行系での操作
待機系への反映方法

JP1/Baseの設定全般
JP1/Base，およびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の共通定義情報を変更した場合
(1) 共通定義情報を変更した場合

ユーザーマッピング情報
jbsmkumapコマンド，jbssetumapコマンド，またはGUIでユーザーマッピング情報を変更した場合
(1) 共通定義情報を変更した場合

jbsmkumapコマンド，jbsrmumapコマンド，またはGUIでユーザーマッピング情報を削除した場合
(2) ユーザーマッピング情報を削除した場合

jbsmkumapコマンド，jbssetumapコマンド，jbsrmumapコマンド，またはGUIでユーザーマッピング情報を変更および削除した場合
(1) 共通定義情報を変更した場合
(2) ユーザーマッピング情報を削除した場合

OSユーザーのパスワード情報
jbsmkpassコマンド，jbsumappassコマンド，またはjbspassmgrコマンドでOSユーザーのパスワード情報を変更した場合
(1) 共通定義情報を変更した場合

jbsmkpassコマンド，jbsrmumappassコマンド，またはjbspassmgrコマンドでOSユーザーのパスワード情報を削除した場合
(3) OSユーザーのパスワード情報を削除した場合

jbsmkpassコマンド，jbsumappassコマンド，jbsrmumappassコマンド，またはjbspassmgrコマンドでOSユーザーのパスワード情報を変更および削除した場合
(1) 共通定義情報を変更した場合
(2) ユーザーマッピング情報を削除した場合

jp1hosts情報
jbshostsimportコマンドでjp1hosts情報を変更した場合
(1) 共通定義情報を変更した場合

jbshostsimportコマンドでjp1hosts情報を削除した場合
(4) jp1hosts情報を削除した場合

jbshostsimportコマンドでjp1hosts情報を変更および削除した場合
(1) 共通定義情報を変更した場合
(4) jp1hosts情報を削除した場合

ディレクトリサーバ連携
jbschgdsコマンドで連携するディレクトリサーバを変更した場合
(1) 共通定義情報を変更した場合

コマンド実行
jcocmddefコマンドでコマンド実行環境を設定した場合
(1) 共通定義情報を変更した場合

jcocmddefコマンドでコマンド実行環境を設定した場合に，-groupオプションを指定し，ホストグループまたはホストを削除したとき
(5) コマンド実行環境のホストグループまたはホストを削除した場合

＜この節の構成＞

(1)　共通定義情報を変更した場合

(2)　ユーザーマッピング情報を削除した場合

(3)　OSユーザーのパスワード情報を削除した場合

(4)　jp1hosts情報を削除した場合

(5)　コマンド実行環境のホストグループまたはホストを削除した場合

(1)　共通定義情報を変更した場合

表3-4で示した操作で，共通定義情報を変更した場合は，次の手順で実行系と待機系の共通定義情報を一致させてください。なお，表3-4で示した実行系での操作を複数回続けて実施した場合でも，次の操作を一度実施すれば，共通定義情報が待機系に反映されます。

実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避する。
実行するコマンドを次に示します。
jbsgetcnf -h 論理ホスト名 > 退避ファイル名

退避ファイルを待機系にコピーする。

退避ファイルを引数に指定して，待機系でjbssetcnfコマンドを実行する。
実行するコマンドを次に示します。
jbssetcnf 退避ファイル名

(2)　ユーザーマッピング情報を削除した場合

jbsmkumapコマンド，jbsrmumapコマンド，GUIでユーザーマッピング情報を削除した場合は，次の操作で実行系と待機系の共通定義情報を一致させてください。

実行系でjbsgetumapコマンドを実行し，ユーザーマッピング情報を退避する。
実行するコマンドを次に示します。
jbsgetumap -h 論理ホスト名 > 退避ファイル名

退避ファイルを待機系にコピーする。

退避ファイルを引数に指定して，待機系でjbsmkumapコマンドを実行する。
実行するコマンドを次に示します。
jbsmkumap -h 論理ホスト名 -f 退避ファイル名

(3)　OSユーザーのパスワード情報を削除した場合

jbsmkpassコマンド，jbsrmumappassコマンド，またはjbspassmgrコマンドでOSユーザーのパスワード情報を削除した場合，次の操作で実行系と待機系の共通定義情報を一致させてください。なお，実行系で実行したコマンドごとに，待機系の共通定義情報に反映する方法が異なるため，注意してください。

(a)　jbspassmgrコマンドでOSユーザーを削除した場合

待機系でjbspassmgrコマンドを起動し，実行系で削除した登録ユーザーを削除してください。

(b)　jbsrmumappassコマンドでOSユーザーを削除した場合

待機系でjbsrmumappassコマンドを実行し，実行系で削除したOSユーザーを削除してください。

(c)　jbsmkpassコマンドでOSユーザーを削除した場合

次の操作で実行系と待機系の共通定義情報を一致させてください。

実行系で使用したパスワード定義ファイルを待機系にコピーする。

パスワード定義ファイルを引数に指定して，待機系でjbsmkpassコマンドを実行する。
実行するコマンドを次に示します。
jbsmkpass -h 論理ホスト名 -f パスワード定義ファイル

(4)　jp1hosts情報を削除した場合

jbshostsimportコマンドでjp1hosts情報を削除した場合，次に示す操作を実行し，実行系と待機系の共通定義情報を一致させてください。

実行系でjbshostsexportコマンドを実行し，jp1hosts情報を退避する。
実行するコマンドを次に示します。
jbshostsexport -h 論理ホスト名 > 退避ファイル名

退避ファイルを待機系にコピーする。

退避ファイルを引数に指定して，待機系でjbshostsimportコマンドを実行する。
実行するコマンドを次に示します。
jbshostsimport -h 論理ホスト名 -r 退避ファイル名

(5)　コマンド実行環境のホストグループまたはホストを削除した場合

jcocmddefコマンドでコマンド実行環境を設定した場合に，-groupオプションを指定し，ホストグループまたはホストを削除したときは，次の操作で実行系と待機系の共通定義情報を一致させてください。

実行系で使用したホストグループ定義ファイルを待機系にコピーする。

ホストグループ定義ファイルを引数に指定し，待機系でjcocmddefコマンドを実行する。
実行するコマンドを次に示します。
jcocmddef -host 論理ホスト名 -group ホストグループ定義ファイル

3.7　論理ホストの削除

論理ホストを削除する方法について説明します。

＜この節の構成＞

3.7.1　論理ホストの削除（Windowsの場合）

3.7.2　論理ホストの削除（UNIXの場合）

3.7.1　論理ホストの削除（Windowsの場合）

Windowsで論理ホストを削除する場合，GUIで削除する方法とコマンドを使って削除する方法があります。論理ホストの削除は実行系と待機系でそれぞれ実行する必要があります。論理ホストを削除するための手順を次に示します。

GUIで削除する場合

jp1bshasetup.exeコマンドを実行する。

［Baseクラスタ構成の設定］ダイアログボックスの［論理ホストの削除］ボタンをクリックする。

削除したい論理ホスト名を選択する。

コマンドを使って削除する場合

次のコマンドを実行します。

jbs_setup_cluster -h node0 -r

jbs_setup_clusterコマンドの詳細については，「13.　コマンド」の「jbs_setup_cluster（Windows限定）」を参照してください。

これによって，JP1/Base，JP1/IM，およびJP1/AJSの論理ホスト情報，およびサービスが削除されます。また，JP1/Power Monitorの論理ホスト情報も削除されます。なお，共有ディスク上の共有ファイル，共有フォルダは削除されません。手作業で削除してください。

注意事項

論理ホスト名と物理ホスト名（hostnameコマンドの実行結果）を同じ名称にしてJP1を運用していた場合，次の設定を行ってください。

イベントサービス環境の設定を変更する。
イベントサーバインデックスファイル（index）にデフォルトで設定されている「server * default」の行を有効にしてください。

環境設定ディレクトリの設定を変更する。
物理ホストの環境設定ディレクトリをインストール先フォルダにするために，次の手順で設定を変更してください。
1.　次の内容の定義ファイルを作成する。
ファイル名は任意です。
[JP1_DEFAULT¥JP1BASE¥]
"JP1BASE_CONFDIR"="インストール先フォルダ¥conf¥"
2.　次のコマンドを実行し，作成した定義ファイルの内容を共通定義情報に反映する。
jbssetcnf 定義ファイル名

3.7.2　論理ホストの削除（UNIXの場合）

UNIXで論理ホストを削除する場合は，コマンドを使って削除する方法があります。論理ホストの削除は実行系と待機系でそれぞれ実行する必要があります。次のコマンドを実行してください。

jbsunsetcnf -i -h 論理ホスト名

jbsunsetcnfコマンドの詳細については，「13.　コマンド」の「jbsunsetcnf」を参照してください。

これによって，JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の論理ホスト情報が削除されます。ただし，共有ディスク上の共有ファイル，共有ディレクトリは削除されません。手作業で削除してください。

注意事項

論理ホスト名と物理ホスト名（hostnameコマンドの実行結果）を同じ名称にしてJP1を運用していた場合，次の設定を行ってください。

イベントサービス環境の設定を変更する。
イベントサーバインデックスファイル（index）にデフォルトで設定されている「server * default」の行を有効にしてください。

環境設定ディレクトリの設定を変更する。
物理ホストの環境設定ディレクトリをインストール先フォルダにするために，次の手順で設定を変更してください。
1.　次の内容の定義ファイルを作成する。
ファイル名は任意です。
[JP1_DEFAULT¥JP1BASE¥]
"JP1BASE_CONFDIR"="/etc/opt/jp1base/conf"
2.　次のコマンドを実行し，作成した定義ファイルの内容を共通定義情報に反映する。
/opt/jp1base/bin/jbssetcnf 定義ファイル名

3.8　クラスタ運用に関する注意事項

この節では，クラスタ運用に関する注意事項をOS共通，Windows限定，およびUNIX限定の注意事項に分けて説明します。

＜この節の構成＞

(1)　OS共通の注意事項

(2)　Windows限定の注意事項

(3)　UNIX限定の注意事項

(1)　OS共通の注意事項

クラスタシステムでJP1/Baseのセットアップをする場合は，物理ホストおよび既存の論理ホストで動作しているJP1/Baseのサービスを必ず停止させてください。物理ホストおよび既存の論理ホストのJP1/Baseを停止しないままセットアップをした場合，論理ホストのサービスが正常に動作しなくなります。この場合は，サーバを再起動して，回復してください。

クラスタ運用をするシステムでユーザーアプリケーションなどからイベントを発行する場合は，jevsendコマンドを使用し，-sオプションでイベントサーバ名を指定してください。これによって，発行されたイベントがフェールオーバー時に実行系から待機系に引き継がれます。

JP1/BaseのイベントDBおよびコマンド実行履歴ファイル（ISAM）の二重化は支援していません。ミラーディスク，RAIDディスクなどを利用して，ディスクシステム自体で信頼性を確保してください。

クラスタ運用をする場合，イベントサーバ設定ファイル（conf）のoptionsパラメーターにsyncを指定してください。通常，プログラムからのディスク書き込みは，処理の性能を向上させるためにオペレーティングシステムがメモリー上でバッファリングを実行し，遅延書き込みしています。このため，電源異常やオペレーティングシステムの障害のためにシステムが急停止するような場合，ディスクに書き込んだはずのデータが消失することがあります。イベントサービスは，このバッファリングを抑止するとデータの消失を防止します。optionパラメーターにno-syncを指定したり，sync，no-syncのどちらも指定しなかったりした場合，データ消失のおそれがあります。

クラスタシステムで多重起動をする場合，多重起動する論理ホストの数だけ，システムのリソースが必要となります。

クラスタシステムでJP1/Baseを物理ホストでも運用する場合，物理ホストのイベントサービスの設定をIPアドレス指定方式に変更する必要があります。実行系，待機系それぞれのイベントサーバ設定ファイル（conf）を編集して，portsパラメーターに指定するアドレスを，自ホスト名または自ホストのIPアドレスに変更してください。物理ホストのイベントサービスでは，デフォルトで「0.0.0.0」となっていますが，この設定のイベントサービスと論理ホストのイベントサービスは同時に起動できません。イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

認証サーバがフェールオーバーによって切り替わった場合，関連プログラムは次のように動作します。

JP1/IM

通信障害が発生し，フェールオーバー後に回復する。

JP1/AJS

通信障害が発生し，フェールオーバー後に再ログインが必要となる。

JP1/IMおよびJP1/AJSの動作に問題がある場合は，認証サーバをクラスタシステム以外の場所に設置しておくことで回避できます。

JP1/Baseのログファイルトラップを使って共有ディスク上のファイルを監視する場合，ファイル監視中は，その共有ディスクを常にアクセスできるように割り当てたままにしてください。ファイル監視中に共有ディスクの割り当て状態を変更すると，共有ディスクの割り当てや割り当て解除の制御に失敗したり，監視処理がエラーになったりするなどの問題が生じるおそれがあります。

コマンド実行履歴ファイル（ISAM）のデータ消失を防止するために，jcocmddefコマンドで-flushオプションにONを設定して，実行履歴を1行ごとに書き込みする処理を有効にしてください。jcocmddefコマンドの詳細については，マニュアル「JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス」を参照してください。

(2)　Windows限定の注意事項

論理ホストの認証サーバの設定およびJP1ユーザーを登録する場合，必ず実行系のホストで操作をしてください。また，JP1ユーザーを登録する場合は，必ず論理ホストのサービスを起動してから行ってください。

クラスタ環境の実行系の定義を退避するときにjbsgetcnfコマンドに指定する論理ホスト名には，論理ホストを定義したときに指定した大文字・小文字が同じになるように指定してください。
誤って異なる指定をした場合は，論理ホストを削除してから再度設定をしてください。

論理ホストを削除する場合は，該当するホストのJP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）のサービスを停止してから，削除してください。サービスを停止しないまま削除した場合は，次のどちらかの方法でサービスを削除します。

同じ論理ホストを作成し，その後論理ホストを削除する。

JP1/Baseをアンインストールする。

自ホスト名と同じホスト名を指定して論理ホストを作成した場合，論理ホストを削除すると，物理ホストの「JP1/Base Event」サービスが削除されます。次に示すコマンドを実行して回復してください。

jevregsvc -r

JP1/Baseのサービスが起動，または停止できない場合，JP1/Baseのプロセスが残っていることがあります。このような場合には，システムを再起動してください。

物理ホストでJP1/Baseを使用しなくても，JP1/Base LogTrapサービスは論理ホストの処理のために必要です。JP1/Base Control Serviceサービスを起動しない場合は，JP1/Base LogTrapサービスの起動を「自動」に設定してください。

論理ホスト上で動作するサービスに対して起動管理機能は利用できません。起動管理機能は，物理ホスト上のサービスに対してだけ利用できます。論理ホスト上のサービスの起動管理には，クラスタソフトを利用してください。

(3)　UNIX限定の注意事項

クラスタシステムの環境設定をしたあとで，論理ホストで使用する言語種別を変更する場合，次の手順で設定を変更してください。なお，次の手順を実行する前にJP1/Baseおよび関連プログラムを終了する必要があります。

変更する論理ホストが使用する共有ディスク上に作成した共有ファイルjp1bs_env.confの言語種別を変更する。
変更手順については，「2.3.5(2)　言語種別の設定」を参照してください。

viなどのエディターでテキストファイルを作成する。
ここでは，日本語EUCコードに設定する例を示します。
[論理ホスト名¥JP1BASE¥]
"LANG"="EUCJIS"
最後の行にも改行を入れてください。

エディターで作成した上記テキストファイルを保存する。
任意の名前でかまいませんが，ここでは，"baselang.conf"にしておきます。

スーパーユーザー権限で次に示すコマンドを実行する。
/opt/jp1base/bin/jbssetcnf baselang.conf

論理ホスト対応のJP1/Baseサービスの停止を行っても，JP1/Baseのプロセスが終了しないことがあります。このような場合に，強制的にプロセスを終了させたいときは，jbs_killall.clusterコマンドを使用してください。なお，このコマンドを使ったプロセスの強制終了は，正規の方法でJP1/Baseのプロセスを終了できない場合にだけ使用してください。jbs_killall.clusterコマンドの詳細については，「13.　コマンド」の「jbs_killall.cluster（UNIX限定）」を参照してください。

停止処理時にも監視するクラスタシステムでは，JP1/Base（イベントサービスやユーザー管理機能を含むプロセス管理機能）を終了するコマンドを下記の手順で変更してください。
cd /etc/opt/jp1base
cp -p jbs_stop.cluster.retry.model jbs_stop.cluster

3.9　非クラスタ環境で論理ホストを運用する場合の設定

フェールオーバーしない論理ホストの構築および運用についての概要を説明します。フェールオーバーしない論理ホストも，通常のクラスタシステムで運用する場合の論理ホストと同じ手順でセットアップして運用します。

＜この節の構成＞

3.9.1　非クラスタ環境で論理ホストを運用する場合の構成の検討

3.9.2　非クラスタ環境で論理ホストを運用する場合の構築

3.9.3　非クラスタ環境での論理ホスト運用

3.9.1　非クラスタ環境で論理ホストを運用する場合の構成の検討

複数の論理ホストでJP1を起動すると，それぞれのJP1がシステムリソース（メモリー，ディスク，プロセス，セマフォなど）を使用します。複数のJP1を同時に実行してリソースが不足すると，システムが正常に動作しません。同時に起動するJP1の数に合わせて，リソース量も見積もってください。または，システムの性能に合わせて，同時に起動するJP1の数を調整してください。

なお，メモリー所要量およびディスク占有量の見積もりについては，リリースノートを参照してください。

3.9.2　非クラスタ環境で論理ホストを運用する場合の構築

クラスタソフトと連携しなくてもフェールオーバーしない論理ホスト環境で，JP1を運用する手順を次に示します。

＜この項の構成＞

(1)　論理ホスト環境の準備

(2)　論理ホスト環境のJP1のセットアップ

(3)　論理ホスト環境の自動起動および自動停止の設定

(1)　論理ホスト環境の準備

論理ホスト環境を作成するために，論理ホスト用のディスク領域およびIPアドレスを用意してください。

論理ホスト用のディスク領域
物理ホストやほかの論理ホストのJP1が使用しているものとは別に，論理ホストのJP1が専用で使用するファイルの格納先ディレクトリを，ローカルディスクに作成してください。

論理ホスト用のIPアドレス
論理ホストのJP1が使用するIPアドレスを，OSで割り当ててください。
IPアドレスの割り当ては，実IPでもエイリアスIPでもかまいません。ただし，論理ホスト名から一意に特定できるIPアドレスにしてください。
これらに対する前提条件は，クラスタシステムでの運用の場合と同じです。ただし，フェールオーバーしない運用方法のため「サーバ間で引き継がれる」などの条件は除きます。

なお，「3.　クラスタシステムで運用する場合の設定」で，共有ディスク・論理IPアドレスと説明している部分は，上記で割り当てた論理ホスト用のディスク領域・IPアドレスに読み替えてください。

性能の見積もり
性能を見積もる際は，以下のような観点でシステムとして動作可能か見積もってください。

システム内で複数のJP1が起動できるリソースを割り当てられるかどうかを見積もってください。リソースが十分に割り当てられないと，正しく動作しなかったり，十分な性能が確保できなかったりします。

同時に起動する論理ホストで発生するJP1イベント，JP1/AJSのジョブ数などの総量は，一つの物理ホスト上で動作可能な業務トラフィック以内にしてください。JP1を複数起動しても，起動した論理ホストに比例して処理能力は向上しません。

(2)　論理ホスト環境のJP1のセットアップ

クラスタシステムの実行系サーバと同じ手順で，論理ホスト環境のJP1をセットアップしてください。なお，クラスタシステムではフェールオーバーする両側のサーバに対してセットアップする必要がありますが，フェールオーバーしない論理ホストでは，動作するサーバだけセットアップしてください。

(3)　論理ホスト環境の自動起動および自動停止の設定

論理ホスト環境のJP1のセットアップ時に，自動起動および自動停止の設定は行われません。論理ホスト環境の自動起動および自動停止をする場合は，「3.9.3(2)　自動起動および自動停止の設定例」を参照してください。

3.9.3　非クラスタ環境での論理ホスト運用

JP1の操作，バックアップやリカバリーなど，フェールオーバーしない論理ホストの運用方法は，クラスタシステムで運用する論理ホストと同じです。ただし，クラスタソフトと連動してフェールオーバーすることを除きます。

＜この項の構成＞

(1)　起動と停止

(2)　自動起動および自動停止の設定例

(3)　論理ホストのJP1に対する操作

(4)　論理ホストの引き継ぎ

(1)　起動と停止

論理ホストのJP1は，次の順に起動してください。

JP1/Base

JP1/Baseを前提とするJP1製品

また，論理ホストのJP1は，次の順に停止してください。

JP1/Baseを前提とするJP1製品

JP1/Base

(2)　自動起動および自動停止の設定例

システム開始時および停止時に，論理ホスト用のJP1サービスを自動起動および自動停止する場合は，以下の手順で設定する必要があります。設定方法は，JP1/BaseがサポートするOSによって異なります。OSごとの設定方法を次に示します。

(a)　Windows環境の場合

起動順序定義ファイル（JP1SVPRM.DAT）に，次の記述をテキストエディターで追記する。
格納先：JP1/Baseインストールフォルダ¥conf¥boot¥JP1SVPRM.DAT

[Jp1BaseEvent_論理ホスト名]
Name=JP1/BaseEvent_論理ホスト名
ServiceName=JP1_Base_Event 論理ホスト名

[Jp1Base_論理ホスト名]
Name=JP1/Base_論理ホスト名
ServiceName=JP1_Base_論理ホスト名
StopCommand=jbs_spmd_stop.exe -h 論理ホスト名

[Jp1AJS2_論理ホスト名]
Name=JP1/AJS2_論理ホスト名
ServiceName=JP1_AJS2_論理ホスト名
StopCommand=jajs_spmd_stop.exe -h 論理ホスト名

StopCommandパラメーターで指定しているコマンドは，JP1/Power Monitorからのシャットダウン時に実行されます。

(b)　HP-UX環境の場合

論理ホスト用の自動起動および自動停止スクリプトを作成する。
格納先：/sbin/init.d/jp1_service_cluster
自動起動および自動停止スクリプト例

#!/bin/sh

## Set Environment-variables
PATH=/sbin:/bin:/usr/bin:/opt/jp1base/bin
export PATH
JP1_HOSTNAME=論理ホスト名
export JP1_HOSTNAME

case $1 in
start_msg)
     echo "Start JP1 Service $JP1_HOSTNAME"
     ;;

stop_msg)
     echo "Stop JP1 Service $JP1_HOSTNAME"
     ;;

'start')
     if [ -x /etc/opt/jp1base/jbs_start.cluster ]
     then
             /etc/opt/jp1base/jbs_start.cluster
     fi
     if [ -x /etc/opt/jp1ajs2/jajs_start.cluster ]
     then
             /etc/opt/jp1ajs2/jajs_start.cluster
     fi
     ;;

'stop')
     if [ -x /etc/opt/jp1ajs2/jajs_stop.cluster ]
     then
             /etc/opt/jp1ajs2/jajs_stop.cluster
     fi
     if [ -x /etc/opt/jp1base/jbs_stop.cluster ]
     then
             /etc/opt/jp1base/jbs_stop.cluster
     fi
     ;;

esac

exit 0

手順1で作成したスクリプトに対してリンクを設定する。

起動スクリプト

次のコマンドを実行してリンクを設定します。

ln -s /sbin/init.d/jp1_service_cluster /sbin/rc2.d/S***_JP1_SERVICE

***が大きい数字ほど，あとから起動スクリプトが実行されます。

停止スクリプト

次のコマンドを実行してリンクを設定します。

ln -s /sbin/init.d/jp1_service_cluster /sbin/rc1.d/K***_JP1_SERVICE

***が大きい数字ほど，あとから停止スクリプトが実行されます。

一般的に起動される順番が早いほど，停止する順番はあとから実行されるように設定します。

(c)　Solaris環境の場合

論理ホスト用の自動起動および自動停止スクリプトを作成する。
格納先：/etc/init.d/jp1_service_cluster
自動起動および自動停止スクリプト例

#!/bin/sh

## Set Environment-variables
PATH=/sbin:/bin:/usr/bin:/opt/jp1base/bin
export PATH
JP1_HOSTNAME=論理ホスト名
export JP1_HOSTNAME

case $1 in
start_msg)
     echo "Start JP1 Service $JP1_HOSTNAME"
     ;;

stop_msg)
     echo "Stop JP1 Service $JP1_HOSTNAME"
     ;;

'start')
     if [ -x /etc/opt/jp1base/jbs_start.cluster ]
     then
             /etc/opt/jp1base/jbs_start.cluster
     fi
     if [ -x /etc/opt/jp1ajs2/jajs_start.cluster ]
     then
             /etc/opt/jp1ajs2/jajs_start.cluster
     fi
     ;;

'stop')
     if [ -x /etc/opt/jp1ajs2/jajs_stop.cluster ]
     then
             /etc/opt/jp1ajs2/jajs_stop.cluster
     fi
     if [ -x /etc/opt/jp1base/jbs_stop.cluster ]
     then
             /etc/opt/jp1base/jbs_stop.cluster
     fi
     ;;

esac

exit 0

手順1で作成したスクリプトに対してリンクを設定します。

起動スクリプト

次のコマンドを実行してリンクを設定します。

ln -s /etc/init.d/jp1_service_cluster /etc/rc2.d/S**_JP1_SERVICE

**が大きい数字ほど，あとから起動スクリプトが実行されます。

停止スクリプト

次のコマンドを実行してリンクを設定します。

ln -s /etc/init.d/jp1_service_cluster /etc/rc0.d/K**_JP1_SERVICE

**が大きい数字ほど，あとから停止スクリプトが実行されます。

一般的に起動される順番が早いほど，停止する順番はあとから実行されるように設定します。

(d)　AIX環境の場合

mkitabコマンドで/etc/inittabファイルに以下の記述を追加する。

# mkitab -i hntr2mon "jp1base:2:wait:/etc/opt/jp1base/jbs_start.cluster 論理ホスト名"
# mkitab -i jp1base "jp1ajs2:2:wait:/etc/opt/jp1ajs2/jajs_start.cluster 論理ホスト名"

この記述を追加すると，システムの起動時にJP1サービスの起動処理が実行されます。

/etc/rc.shutdownのJP1/Baseを前提とする製品の記述のあとに，次の記述をテキストエディターで追記します。

test -x /etc/opt/jp1ajs2/jajs_stop.cluster && /etc/opt/jp1ajs2/jajs_stop.cluster 論理ホスト名
test -x /etc/opt/jp1base/jbs_stop.cluster && /etc/opt/jp1base/jbs_stop.cluster 論理ホスト名
test -x /opt/hitachi/HNTRLib2/etc/D002stop &&
/opt/hitachi/HNTRLib2/etc/D002stop

この記述を追加すると，システムの停止時にJP1サービスの停止処理が実行されます。

(e)　Linux環境の場合

論理ホスト用の自動起動および自動停止スクリプトを作成する。
格納先：/etc/rc.d/init.d/jp1_service_cluster
自動起動および自動停止スクリプト例

#!/bin/sh

## Set Environment-variables
PATH=/sbin:/bin:/usr/bin:/opt/jp1base/bin
export PATH
JP1_HOSTNAME=論理ホスト名
export JP1_HOSTNAME

case $1 in
start_msg)
     echo "Start JP1 Service $JP1_HOSTNAME"
     ;;

stop_msg)
     echo "Stop JP1 Service $JP1_HOSTNAME"
     ;;

'start')
     if [ -x /etc/opt/jp1base/jbs_start.cluster ]
     then
             /etc/opt/jp1base/jbs_start.cluster
             touch /var/lock/subsys/_JP1_BASE_$JP1_HOSTNAME
     fi
     if [ -x /etc/opt/jp1ajs2/jajs_start.cluster ]
     then
             /etc/opt/jp1ajs2/jajs_start.cluster
             touch /var/lock/subsys/_JP1_AJS2_$JP1_HOSTNAME
     fi
     ;;

'stop')
     if [ -x /etc/opt/jp1ajs2/jajs_stop.cluster ]
     then
             /etc/opt/jp1ajs2/jajs_stop.cluster
             rm -f /var/lock/subsys/_JP1_AJS2_$JP1_HOSTNAME
     fi
     if [ -x /etc/opt/jp1base/jbs_stop.cluster ]
     then
             /etc/opt/jp1base/jbs_stop.cluster
             rm -f /var/lock/subsys/_JP1_BASE_$JP1_HOSTNAME
     fi

     ;;
esac

exit 0

手順1で作成したスクリプトに対してリンクを設定します。

起動スクリプト

次のコマンドを実行してリンクを設定します。

ln -s /etc/rc.d/init.d/jp1_service_cluster /etc/rc.d/rc3.d/S**_JP1_SERVICE

ln -s /etc/rc.d/init.d/jp1_service_cluster /etc/rc.d/rc5.d/S**_JP1_SERVICE

**が大きい数字ほど，あとから起動スクリプトが実行されます。

停止スクリプト

次のコマンドを実行してリンクを設定します。

ln -s /etc/rc.d/init.d/jp1_service_cluster /etc/rc.d/rc0.d/K**_JP1_SERVICE

ln -s /etc/rc.d/init.d/jp1_service_cluster /etc/rc.d/rc6.d/K**_JP1_SERVICE

**が大きい数字ほど，あとから停止スクリプトが実行されます。

一般的に起動される順番が早いほど，停止する順番はあとから実行されるように設定します。

なお，JP1サービスの自動停止をする場合は，必ず自動起動もするようにしてください。自動停止だけを設定している場合，停止スクリプトが起動されません。

(f)　物理ホストおよび論理ホストの両方で自動起動および自動停止をする場合の設定

物理ホストおよび論理ホストの両方で自動起動および自動停止をしたい場合は，論理ホストの自動起動および自動停止の設定に加えて，次に示す設定をする必要があります。なお，設定方法はOSごとに異なります。OSごとの設定方法を次に示します。

Windows環境の場合

起動管理機能では，起動順序定義ファイル（JP1SVPRM.DAT）に記載された順番どおりに上から起動・停止処理が実行されます。物理ホストおよび論理ホストの起動順序を変更したい場合は，起動順序定義ファイル（JP1SVPRM.DAT）で，起動または停止したい順に，物理ホストおよび論理ホストの起動・停止順序を定義してください。

HP-UX，Solaris，およびLinuxの環境の場合

自動起動および自動停止の順序は，自動起動および自動停止スクリプトの数字部分（S**およびK**の**部分）の値によって決定されます。数字部分の値が大きいほど，あとから実行されます。物理ホストの自動起動および自動停止スクリプトへのシンボリックリンクは，インストール時に自動で作成されます。物理ホストも含めた自動起動および自動停止をする場合は，論理ホスト用に作成するシンボリックリンクの名称を変更して，物理ホストおよび論理ホストの起動および停止順序を調節してください。

なお，物理ホスト用の自動起動および自動停止スクリプトは，あらかじめ用意されています。物理ホストの自動起動および自動停止スクリプトへのシンボリックリンク一覧を次の表に示します。

表3-5　物理ホストの自動起動および自動停止スクリプトへのシンボリックリンク一覧

OS名
起動スクリプト
停止スクリプト

HP-UX
/sbin/rc2.d/S900jp1_base
/sbin/rc1.d/K100jp1_base

Solaris
/etc/rc2.d/S99_JP1_10_BASE
/etc/rc0.d/K01_JP1_90_BASE

Linux
/etc/rc.d/rc3.d/S99_JP1_10_BASE
/etc/rc.d/rc5.d/S99_JP1_10_BASE
/etc/rc.d/rc0.d/K01_JP1_90_BASE
/etc/rc.d/rc6.d/K01_JP1_90_BASE

シンボリックリンク一覧のS**およびK**の**（数字）部分の値と，論理ホストの自動起動および自動停止スクリプトのシンボリックリンクのS**およびK**の**（数字）部分の値との大小関係によって，物理ホストおよび論理ホストの起動順序を調節してください。

例えば，論理ホストを先に起動したい場合は，論理ホスト用に作成する自動起動スクリプトへのシンボリックリンク名S**の数字を，900（HP-UXの場合）または99（Solaris，Linuxの場合）より小さい値にしてください。

AIX環境の場合

物理ホストの自動起動および自動停止をする場合は，追加設定が必要です。追加設定については，「5.2.1　自動起動および自動終了の設定」を参照してください。

(3)　論理ホストのJP1に対する操作

論理ホストに作成したJP1に対してコマンドを実行する場合は，クラスタシステムで動作する論理ホストと同様に論理ホスト名を明示して実行してください。

(4)　論理ホストの引き継ぎ

非クラスタ環境の論理ホストでは共有ディスク上の管理情報が引き継がれないため，フェールオーバーに対応していません。複数のホストで論理ホストIPを引き継ぐ運用はしないでください。

4.　ネットワーク構成に応じたJP1/Baseの通信設定

この章では，ネットワーク構成に応じたJP1/Baseの通信設定について説明します。なお，この章で説明しているJP1/Baseの通信設定をする際の考え方は，JP1/Baseを前提とする製品でも同様となります。

また，JP1/Baseの通信方式に関する概要については，「1.10　JP1/Baseの通信方式」を参照してください。

＜この章の構成＞

4.1　単一ネットワークでの運用

4.2　複数ネットワークでの運用

4.3　ネットワークを分離した環境での運用

4.4　クラスタ運用していない場合の通信設定例（ネットワークを分離した環境での運用）

4.5　クラスタ運用する場合の通信設定例（ネットワークを分離した環境での運用）

4.6　ネットワークを分離した環境で，特定のネットワークで運用する場合の通信設定例

4.7　複数ネットワークでの運用から単一ネットワークでの運用に戻す

4.8　通信設定が必要な場合

4.1　単一ネットワークでの運用

この節では，単一ネットワークでのJP1/Baseの運用および必要となる通信設定について説明します。

JP1/Baseは，物理ホストしか使用しない場合は，デフォルト（ANYバインド方式）のまま使用できます。特に通信設定を変更する必要はありません。

また，クラスタ運用する場合でも，WindowsではGUI（jp1bshasetup.exe）またはコマンド（jbs_setup_clusterコマンド），UNIXではコマンド（jp1base_setup_clusterコマンド）を使ってクラスタシステム用の設定をすれば，自動的にIPバインド方式に設定されるため，特に通信設定を変更する必要はありません。クラスタシステム用の設定をすれば，物理ホストへの通信は物理ホストが，論理ホストへの通信は論理ホストが受け取るようになります。

単一ネットワークでクラスタ運用している場合のJP1/Baseの通信動作を次の図に示します。

図4-1　単一ネットワークでクラスタ運用している場合のJP1/Baseの通信動作

4.2　複数ネットワークでの運用

この節では，複数ネットワークでのJP1/Baseの運用および必要となる通信設定について説明します。

NICを複数枚使用して複数ネットワークに接続されるホスト上で物理ホストしか使用しない場合は，デフォルト（ANYバインド方式）のまま使用できます。通信設定の必要はありません。

一方，NICを複数枚使用して複数ネットワークに接続されるホスト上で論理ホストを使用（クラスタ運用）している場合，通信設定が必要となります。この場合の通信設定について，次に示すシステム構成例を基に説明します。

図4-2　複数ネットワークに接続されるホスト上のJP1/Baseをクラスタ運用する場合のシステム構成例

＜この節の構成＞

(1)　設定条件

(2)　通信の考え方

(3)　通信設定

(1)　設定条件

次に示す条件を満たす場合，通信設定が必要となります。

hostAには2枚のNICがあり，それぞれ別のサブネットを構築している。

ホスト名hostA（物理ホスト）はIPアドレス10.0.0.10で解決され，ホスト名logicalA（論理ホスト）はIPアドレス20.0.0.10で解決される。

(2)　通信の考え方

物理ホストhostAはサブネット1側に存在するホストとして扱われ，論理ホストlogicalAはサブネット2だけに接続されたホストとして動作します。このままでは，サブネット1にあるhostXはhostAと通信できますが，logicalAとは通信できません。同様にサブネット2にあるhostYはlogicalAと通信できますが，hostAとは通信できません。このため，hostXとlogicalAが通信できるように，また，hostYとhostAが通信できるように設定する必要があります。

(3)　通信設定

すべてのホスト間で通信ができるように，サブネット間でルーティングを設定してください（JP1/Base自体の通信設定を変更する必要はありません）。JP1/Baseが使用するポート番号については，「付録C.1　JP1/Baseのポート番号」を参照してください。ルーティングを設定するとhostXとlogicalAが通信でき，また，hostYとhostAが通信できるようになります。

図4-3　ルーティングを設定した場合のシステム構成例

なお，ルーティング機能がない，サブネット間での相互通信をさせたくないなどの理由で，ルーティングを設定しないでネットワークを分離した環境でJP1/Baseを運用する場合，JP1/Baseの通信設定を変更すればその環境に対応できます。06-71からサポートされた機能で，複数LAN接続と呼ばれる機能です。詳細については，「4.3　ネットワークを分離した環境での運用」を参照してください。

4.3　ネットワークを分離した環境での運用

JP1/Baseは，ルーティング機能がない，サブネット間での相互通信をさせたくないなどの理由でネットワークを分離した環境でも，運用できます。システムやほかのアプリケーションとは別にJP1/Base独自に通信設定を変更すれば，多様なネットワーク構成や運用に柔軟に対応できます。このように，多様なネットワーク構成や運用に柔軟に対応するための機能を，JP1では複数LAN接続と呼んでいます。

この節では，複数LAN接続を使って，ネットワークを分離した環境でJP1/Baseを運用する際の考え方や通信設定について説明します。

注意事項

通信設定を変更するホストには，06-71以降のJP1/Baseがインストールされている必要があります。

＜この節の構成＞

4.3.1　ネットワークを分離した環境でJP1/Baseを運用する際の考え方

4.3.2　jp1hosts情報を定義する

4.3.3　通信方式を変更する

4.3.4　イベントサービスの通信設定を変更する

4.3.5　JP1/Baseを再起動する

4.3.6　従来のイベントサーバとイベントを送受信する場合の注意事項

4.3.1　ネットワークを分離した環境でJP1/Baseを運用する際の考え方

ここでは，ネットワークを分離した環境でJP1/Baseを運用する際の考え方について，次の図に示すシステム構成例を基に説明します。この構成例では，物理ホストhostAおよび論理ホストlogicalAをマネージャーホストとし，hostXやhostYをエージェントホスト（またはクライアントホスト）として運用すると仮定して説明します。具体的には，hostXのJP1/IM - ViewからhostAのJP1/IM - Managerにログインし，hostYを監視したり，hostYで自動アクションを実行させたい場合などです。

図4-4　分離されたネットワークでJP1/Baseを運用する場合のシステム構成例

設定のポイントを次に示します。

JP1/Baseの通信方式を採用するかどうか

JP1/Base本体の通信設定をどうするか
JP1/Base本体の通信設定とは，ホスト間でJP1イベント以外のデータをやり取りするために必要な設定を意味します。ユーザー認証や構成定義の配布・リモートコマンド（JP1/IM用）などが該当します。JP1/Base本体の通信設定を考える上で重要になるのは，次に示す2点です。

jp1hosts情報の定義

送信時と受信時の通信方式の選択

イベントサービスの通信設定をどうするか
イベントサービスの通信設定とは，ホスト間でJP1イベントをやり取りするために必要な設定を意味します。

なお，通信設定を変更した場合は，JP1/Baseを必ず再起動させる必要があります。

＜この項の構成＞

(1)　JP1/Baseの通信方式を採用するかどうか

(2)　jp1hosts情報の定義（JP1/Base本体用）

(3)　送信時と受信時の通信方式の選択（JP1/Base本体用）

(4)　イベントサービスの通信設定

(5)　JP1/Baseの再起動

(1)　JP1/Baseの通信方式を採用するかどうか

JP1/Base 06-71以降は互換性を保つため，インストール時には06-51以前の通信設定で動作します。JP1/Baseの通信方式を採用するかどうか，まず検討してください。

(2)　jp1hosts情報の定義（JP1/Base本体用）

OSによっては，一つのホスト名から複数のIPアドレスに解決できない場合があります。この場合，JP1/BaseはJP1/Base独自のhosts情報を定義すれば，IPアドレス解決ができます。このJP1/Base独自のhosts情報をjp1hosts情報と呼びます。なお，物理ホスト，論理ホスト共にサブネット1，サブネット2を使用するためには，それぞれが使用するIPアドレスを両NICに割り当てる必要があります（UNIXの場合ipconfigコマンドを使用します）。そして，その情報をjp1hosts情報として定義します。

また，hostXでping logicalAを実行したときに，サブネット2側の20.0.0.11を検索し，通信ができないことがあります。この場合も，hostXでjp1hosts情報を定義すれば解決できます。

注意事項

hostsやDNSの設定で対処できない場合だけ，必要な設定をjp1hosts情報に定義してください。

jp1hosts情報は，jp1hosts定義ファイルを編集し，コマンド（jbshostsimportコマンド）を使って共通定義情報に登録すると反映できます。詳細については，「4.3.2　jp1hosts情報を定義する」を参照してください。

(3)　送信時と受信時の通信方式の選択（JP1/Base本体用）

複数ネットワークに接続されるホストをクラスタ運用している場合，通信方式を変更する必要があります。図4-4を基にして，以降で簡単に説明します。

複数ネットワークに接続されたホストは，物理ホスト，論理ホストを使用しているため，受信設定をANYバインド方式にすると，物理ホストあてのデータを論理ホストが受け取ったり，論理ホストあてのデータを物理ホストが受け取ったりするようになります。このため，受信設定は，IPバインド方式にする必要があります。

一方，送信設定をIPバインド方式にすると，送信データがサブネット1だけ，またはサブネット2だけしか流れなかったりするため，送信設定はANYバインド方式にする必要があります。

通常，クラスタシステム用の設定をすると受信設定，送信設定共にIPバインド方式となります。このため，送信設定だけをANYバインド方式に変更する必要があります。JP1/Base本体の通信方式の変更は，通信方式設定ファイルをコマンド（jbssetcnfコマンド）を使って共通定義情報に登録すると反映できます。詳細については，「4.3.3　通信方式を変更する」を参照してください。

(4)　イベントサービスの通信設定

イベントサービスの場合，イベントサーバ設定ファイル（conf）を編集すると，JP1/Base本体の「(2)　jp1hosts情報の定義（JP1/Base本体用）」および「(3)　送信時と受信時の通信方式の選択（JP1/Base本体用）」に該当する通信設定が行えます。詳細については，「4.3.4　イベントサービスの通信設定を変更する」を参照してください。

(5)　JP1/Baseの再起動

JP1/Baseの通信設定を変更した場合，必ず再起動する必要があります。

4.3.2　jp1hosts情報を定義する

JP1/Baseは，JP1/Base独自のhosts情報を持つことで，OSに左右されずにIPアドレス解決ができます。JP1/Base本体は，共通定義情報にJP1/Base独自のhosts情報（jp1hosts情報）を登録すると，接続先ホストの物理ホスト名や論理ホスト名に対応していないIPアドレスでも通信ができるようになります。例えば，一つのホスト名から複数のIPアドレス解決ができないOSであっても，jp1hosts情報を定義すると，JP1/Baseは一つのホスト名に対して複数のIPアドレス解決ができるようになります。なお，jp1hosts情報はJP1/Baseインストール時には存在しません。必要に応じて共通定義情報に登録する必要があります。なお，JP1/Baseが提供する各機能のjp1hosts情報への対応状況については，「付録H　通信設定の変更対応」を参照してください。

注意事項

jp1hosts情報を設定した場合，jp1hosts情報に定義されたホスト名，およびIPアドレスに関してはhostsファイルやDNSの定義は参照されません。

（例）

jp1hosts情報：

 hostA 100.0.0.10, 200.0.0.10

hostsファイル：

 100.0.0.10 hostA hostB
 200.0.0.10 hostC

上記設定の場合，hostAおよび100.0.0.10と200.0.0.10のIPアドレスに関してはhostsファイルは参照されません。

jp1hosts情報を共通定義情報に登録する必要があるのは，次の場合です。

複数ネットワークに接続されるホストをクラスタ運用する場合

接続先ホストに接続する際に使用するIPアドレスで正しく通信ができない場合

jp1hosts情報を共通定義情報に登録する手順を次に示します。

jp1hosts定義ファイルを編集する。
jp1hosts定義ファイルは，デフォルトで提供されています（jp1hostsファイルが該当します）。格納場所は，Windowsの場合インストール先フォルダ¥conf¥，UNIXの場合/etc/opt/jp1base/conf/です。ただし，デフォルトのままでは利用できません。このファイルを利用する場合は，運用に合わせて編集してください。なお，独自にjp1hosts定義ファイルを作成，編集することもできますが，この場合も格納場所は，デフォルト提供されているjp1hostsファイルと同じ場所にしてください。jp1hosts定義ファイルの形式については，「14.　定義ファイル」の「jp1hosts定義ファイル」を参照してください。

jbshostsimportコマンドを実行して共通定義情報に登録する。
次のようにコマンドを実行します。

jbshostsimport {-o|-r} jp1hosts定義ファイル名 [-h 論理ホスト名]

なお，共通定義情報に登録したjp1hosts情報を確認する場合は，jbshostsexportコマンドを利用してください。また，これらのコマンドの詳細については，「13.　コマンド」を参照してください。

4.3.3　通信方式を変更する

JP1/Baseは，JP1/Base自体の通信方式を変更すると，ネットワークを分離した環境でも運用できるようになります。JP1/Base本体の通信方式は，通信方式設定ファイルを共通定義情報に反映すると変更できます。なお，JP1/Baseが提供する各機能の通信方式設定ファイルへの対応状況については，「付録H　通信設定の変更対応」を参照してください。

JP1/Base本体の通信方式を変更する必要があるのは次の場合です。

複数ネットワークに接続されるホストをクラスタ運用する場合

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して通信する場合

複数LAN接続の環境で，特定のLANだけを使用して通信する場合

クラスタシステムから論理ホストを削除し，物理ホストだけの環境にする場合（ANYバインド方式に変更する場合）

複数ネットワークに接続されるホストを物理ホストとしてしか使用しない場合は，通信方式を選択する必要はありません。

共通定義情報に通信方式設定ファイルを反映する場合，jbssetcnfコマンドを利用します。なお，通信方式設定ファイルには，次の表に示す七つのファイルがあり，格納場所は，Windowsの場合インストール先フォルダ¥conf¥，UNIXの場合/etc/opt/jp1base/conf/です。

通信方式設定ファイル
用途

physical_ipany.conf
受信をIPバインド方式，送信をANYバインド方式にする場合に使用します。主にクラスタ運用している物理ホストで，複数のLANと通信する場合に使用します。

logical_ipany.conf
受信をIPバインド方式，送信をANYバインド方式にする場合に使用します。主にクラスタ運用している論理ホストで，複数のLANと通信する場合に使用します。なお，このファイルは編集し直す必要があります。

physical_recovery_0651.conf
共通定義情報に反映した通信方式を06-51以前の通信方式に戻す場合に使用します。主に物理ホストで設定した通信方式を06-51以前の通信方式に戻す場合に使用します。
06-51以前の通信方式では，IPバインド方式の場合，複数LAN接続に対応できません。

logical_recovery_0651.conf
共通定義情報に反映した通信方式を06-51以前の通信方式に戻す場合に使用します。主に論理ホストで設定した通信方式を06-51以前の通信方式に戻す場合に使用します。なお，このファイルは編集し直す必要があります。
06-51以前の通信方式では，IPバインド方式の場合，複数LAN接続に対応できません。

physical_anyany.conf
送受信共にANYバインド方式にする場合に使用します。主にクラスタ運用していたホストを物理ホストだけでの運用に戻す場合に使用します。このファイルを使用すると，物理ホストがANYバインド方式になります。ただし，この場合，同一ホスト上では，論理ホストと併用できなくなります。

physical_ipip.conf
送受信共にIPバインド方式にする場合に使用します。主に物理ホストで，ファイアウォール通過用に，送信時のIPアドレスを明示的に特定する場合や，特定のLANだけを利用する場合に使用します。
この設定を複数のネットワークに接続されるホストで行うと，一つのネットワークだけしか使用できなくなります。

logical_ipip.conf
送受信共にIPバインド方式にする場合に使用します。主に論理ホストで，ファイアウォール通過用に，送信時のIPアドレスを明示的に特定する場合や，特定のLANだけを利用する場合に使用します。なお，このファイルは編集し直す必要があります。
この設定を複数のネットワークに接続されるホストで行うと，一つのネットワークだけしか使用できなくなります。

複数ネットワークに接続されるホスト上の物理ホストに対し，通信方式設定ファイルの内容を反映させる場合は，次のようにjbssetcnfコマンドを実行してください。

jbssetcnf physical_ipany.conf

また，複数ネットワークに接続されるホスト上の論理ホストに対し，通信方式設定ファイルの内容を反映させる場合は，logical_ipany.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]のLOGICALHOSTNAMEをクラスタシステム用の設定をした際に指定した論理ホスト名に修正してから，次のようにjbssetcnfコマンドを実行してください。

jbssetcnf logical_ipany.conf

4.3.4　イベントサービスの通信設定を変更する

イベントサービスの通信設定は，イベントサーバ設定ファイル（conf）で管理しています。イベントサーバ設定ファイル（conf）の内容を変えることで，イベントサービスの通信設定を変更できます。ネットワークが分離された環境で運用する場合に必要なパラメーターを次に示します。

portsパラメーター

client-bindパラメーター

portsパラメーターはJP1イベント受信用，client-bindパラメーターはJP1イベント送信用として使用します。これらのパラメーターの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

confファイルにこれらのパラメーターを設定する必要があるホストを次に示します。

接続先ホストに接続する際に使用するIPアドレスで正しく通信ができない場合

複数ネットワークに接続されるホストをクラスタ運用する場合

イベントサービスの通信設定を変更する手順を次に示します。

confファイルをエディターなどを使って開く。
confファイルの格納場所は，デフォルトではWindowsの場合インストール先フォルダ¥conf¥event¥servers¥default¥，UNIXの場合/etc/opt/jp1base/conf/event/servers/default/です。
論理ホスト用のconfファイルを編集する場合は，クラスタシステム用の設定をした際に作成されるconfファイルを編集してください。

portsパラメーターを探し，運用に合わせて編集する。
confファイル内にportsパラメーターの記述がなかった場合は追記してください。なお，クラスタ運用していないホストでは，次のようにデフォルト設定でかまいません。

ports 0.0.0.0 jp1imevt jp1imevtapi

複数ネットワークに接続されるホストをクラスタ運用し，かつ，物理ホスト，論理ホストそれぞれに複数のIPアドレスを割り当てる場合は，次のように編集してください。

ports IPアドレス:IPアドレス jp1imevt jp1imevtapi

IPアドレスには，そのイベントサーバがJP1イベントを受信する際に使用するIPアドレスを指定します。複数指定する場合は，:（半角コロン）で区切ります。なお，指定できるIPアドレスの最大数は4です。

client-bindパラメーターを追記する。
追記内容は次のようになります。

client-bind 0.0.0.0

以上のように設定すると，ネットワークを分離した環境でもイベントサービスを運用できるようになります。

注意事項

上記設定（portsパラメーター，client-bindパラメーターでの設定）をしても，意図したとおりに通信ができない場合は，confファイルにremote-serverパラメーターを追記してください。remote-serverパラメーターは，他イベントサーバへの接続方法を指定するパラメーターです。このパラメーターでアドレスを明示的にIPアドレスで指定すれば，ネットワークを指定できます。追記内容は次のようになります。

remote-server イベントサーバ名 close IPアドレス

詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

4.3.5　JP1/Baseを再起動する

JP1/Base本体およびイベントサービスの通信設定を変更した場合，JP1/Baseを再起動する必要があります。通信設定を変更したホストのJP1/Base，JP1/Baseを前提とする製品（JP1/IM，JP1/AJSなど），およびJP1/Baseと依存関係のあるプログラムをいったん停止し，再起動してください。

4.3.6　従来のイベントサーバとイベントを送受信する場合の注意事項

従来のイベントサーバ（バージョン 5以前の製品JP1/SES，JP1/AJSやJP1/SESのプロトコルを利用する製品）は，OSが管理しているネットワーク機能（gethostbyname）で求まるIPアドレスでしかイベントの受信ができません。

従来のイベントサーバとJP1/Baseでイベントを送受信する場合は，従来のイベントサーバを，OSが管理しているネットワーク機能（gethostbyname）で求まるIPアドレスを利用しているネットワーク上のホストに設置してください（そのほかのネットワーク上に設置した場合，従来のイベントサーバはイベントの送信はできますが，イベントの受信ができません）。

4.4　クラスタ運用していない場合の通信設定例（ネットワークを分離した環境での運用）

この節では，ネットワークを分離した環境で，クラスタ運用していない場合の通信設定について，次に示すシステム構成例を基に説明します。

図4-5　JP1/Baseをクラスタ運用していない場合のシステム構成例（ネットワークを分離した環境での運用）

なお，上記構成図ではhost10だけ，ホスト名hostXに対してIPアドレス解決ができないIPアドレス20.0.0.11で接続すると仮定し，ほかのホストはIPアドレス解決ができるIPアドレス10.0.0.11で接続すると仮定します。

この場合，各ホストで通信設定の変更が必要かどうかを次の表に示します。

ホスト名
JP1/Base本体の通信設定
イベントサービスの通信設定
（confでの編集）

jp1hosts情報
通信方式設定情報

host10
変更が必要
変更不要
変更が必要

hostX
変更不要
変更不要
変更不要

hostA
変更不要
変更不要
変更不要

hostB
変更不要
変更不要
変更不要

hostC
変更不要
変更不要
変更不要

＜この節の構成＞

4.4.1　通信設定の変更

4.4.1　通信設定の変更

ここでは，各ホストで必要となる通信設定の変更について説明します。

＜この項の構成＞

(1)　host10で必要となる設定

(2)　hostXで必要な設定

(3)　hostA，hostB，hostCで必要な設定

(1)　host10で必要となる設定

ほかのホストと異なり，host10は，hostXに対して物理ホスト名（ここではhostX）に対応していないIPアドレス20.0.0.11で接続するため，IPアドレス20.0.0.11がhostXに対応するIPアドレスだと認識させる必要があります。この設定は，jp1hosts定義ファイルおよびイベントサーバ設定ファイル（conf）で行います。

host10で必要な通信設定手順を次に示します。

jp1hosts定義ファイルを編集する。
jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11をhostXのIPアドレスとして対応付ける。
hostX 20.0.0.11

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

イベントサーバ設定ファイル（conf）を編集する。
イベントサーバ設定ファイル（conf）に次の行を追加してください。

remote-server hostX close 20.0.0.11

JP1/Baseを再起動する。
JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhost10での通信設定は完了です。

(2)　hostXで必要な設定

hostXは，通信設定を変更する必要はありません。

(3)　hostA，hostB，hostCで必要な設定

hostA，hostB，hostCは，物理ホスト名（ここではhostX）に対応するIPアドレス10.0.0.11で接続するため，通信設定を変更する必要はありません。

4.5　クラスタ運用する場合の通信設定例（ネットワークを分離した環境での運用）

この節では，ネットワークを分離した環境で，複数のネットワークに接続されるホストがクラスタ運用である場合の通信設定について，次に示すシステム構成例を基に説明します。

図4-6　JP1/Baseをクラスタ運用する場合のシステム構成例（ネットワークを分離した環境での運用）

なお，上記構成図ではhost10だけ，物理ホスト名hostX，論理ホスト名hostLに対してIPアドレス解決ができないIPアドレス20.0.0.11（物理ホスト用），20.0.0.15（論理ホスト用）で接続すると仮定し，ほかのホストは，物理ホスト名hostX，論理ホスト名hostLに対してIPアドレス解決ができるIPアドレス10.0.0.11（物理ホスト用），10.0.0.15（論理ホスト用）で接続すると仮定します。

各ホストで通信設定の変更が必要かどうかを次の表に示します。

ホスト名
JP1/Base本体の通信設定
イベントサービスの通信設定
（confでの編集）

jp1hosts情報
通信方式設定情報

host10
変更が必要
変更不要
変更が必要

hostX（物理ホスト）
変更が必要
変更が必要
変更が必要

hostL（論理ホスト）
変更が必要
変更が必要
変更が必要

hostA
変更不要
変更不要
変更不要

hostB
変更不要
変更不要
変更不要

＜この節の構成＞

4.5.1　通信設定の変更

4.5.1　通信設定の変更

ここでは，各ホストで必要となる通信設定の変更について説明します。

＜この項の構成＞

(1)　host10で必要となる設定

(2)　hostXで必要な設定

(3)　hostL（論理ホスト）で必要な設定

(4)　hostA，hostBで必要な設定

(1)　host10で必要となる設定

host10は，hostXおよびhostLに対して物理ホスト名（hostX）および論理ホスト名（hostL）に対応していないIPアドレス20.0.0.11，20.0.0.15で接続するため，これらのIPアドレスがそれぞれhostXおよびhostLに対応するIPアドレスだと認識させる必要があります。この設定は，jp1hosts定義ファイルおよびイベントサーバ設定ファイル（conf）で行います。

host10で必要な通信設定手順を次に示します。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。
JP1/Baseと依存関係を持つプログラムには，例えばJP1/BaseのSNMPトラップ変換機能の起動に必要なJP1/Cm2/NNMがあります。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。
jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11，20.0.0.15をそれぞれ接続させたいホストの
# IPアドレスとして対応付ける。
hostX 20.0.0.11
hostL 20.0.0.15

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

イベントサーバ設定ファイル（conf）を編集する。
イベントサーバ設定ファイル（conf）に次の行を追加してください。

remote-server hostX close 20.0.0.11
remote-server hostL close 20.0.0.15

JP1/Baseを再起動する。
JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhost10での通信設定は完了です。

(2)　hostXで必要な設定

hostXで必要な通信設定手順を次に示します。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。
JP1/Baseと依存関係を持つプログラムには，例えばJP1/BaseのSNMPトラップ変換機能の起動に必要なJP1/Cm2/NNMがあります。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。
jp1hosts定義ファイルを次に示すように編集してください。

# ホスト名にIPアドレスを対応付ける。
hostX 10.0.0.11, 20.0.0.11

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipany.conf

イベントサーバ設定ファイル（conf）を編集する。
イベントサーバ設定ファイル（conf）のportsパラメーターおよびclient-bindパラメーターの値を次のように修正してください。

ports 10.0.0.11:20.0.0.11 jp1imevt jp1imevtapi
client-bind 0.0.0.0

JP1/Baseを再起動する。
JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostXでの通信設定は完了です。

(3)　hostL（論理ホスト）で必要な設定

hostLで必要な通信設定手順を次に示します。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。
JP1/Baseと依存関係を持つプログラムには，例えばJP1/BaseのSNMPトラップ変換機能の起動に必要なJP1/Cm2/NNMがあります。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。
jp1hosts定義ファイルを次に示すように編集してください。

# ホスト名にIPアドレスを対応付ける。
hostL 10.0.0.15, 20.0.0.15

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名 -h hostL

logical_ipany.confを編集する。
logical_ipany.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[hostL¥JP1BASE]に修正してください。

jbssetcnfコマンドを実行する。

jbssetcnf logical_ipany.conf

イベントサーバ設定ファイル（conf）を編集する。
イベントサーバ設定ファイル（conf）のportsパラメーターおよびclient-bindパラメーターの値を次のように修正してください。

ports 10.0.0.15:20.0.0.15 jp1imevt jp1imevtapi
client-bind 0.0.0.0

JP1/Baseを再起動する。
JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostLでの通信設定は完了です。

(4)　hostA，hostBで必要な設定

hostA，hostBは，物理ホスト名（ここではhostX）または論理ホスト名（ここではhostL）に対応するIPアドレスで接続するため，通信設定を変更する必要はありません。

4.6　ネットワークを分離した環境で，特定のネットワークで運用する場合の通信設定例

この節では，ネットワークを分離した環境で，JP1/Baseを特定のネットワークだけで運用する場合の通信設定について，次に示すシステム構成例を基に説明します。

図4-7　JP1/Baseを運用する場合のシステム構成例（ネットワークを分離した環境で，特定のネットワークだけで運用する）

上記の図では，hostL（論理ホスト）がマネージャーホストとして動作し，各ホストのJP1/Baseは，ネットワーク2を使用して接続すると仮定します。

各ホストでの通信設定の変更の有無を次の表に示します。

ホスト名 | JP1/Base本体の通信設定 | イベントサービスの通信設定（confでの編集）
jp1hosts情報 | 通信方式設定情報
hostA（物理ホスト） | 変更する | 変更する | 変更する
hostL（論理ホスト） | 変更する | 変更する | 変更する
hostB | 変更する | 変更する | 変更する

次に，各ホストでの通信設定の変更手順を説明します。

＜この節の構成＞

(1)　hostAで必要な設定

(2)　hostL（論理ホスト）で必要な設定

(3)　hostBで必要な設定

(1)　hostAで必要な設定

jp1hosts定義ファイルおよびイベントサーバ設定ファイル（conf）で，各ホストのJP1/Baseが使用するIPアドレスを認識させます。

通信の設定手順を次に示します。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。
JP1/Baseと依存関係を持つプログラムには，例えばJP1/BaseのSNMPトラップ変換機能の起動に必要なJP1/Cm2/NNMがあります。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。
jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.10をhostA，20.0.0.20をhostLとして対応付ける。
hostA 20.0.0.10
hostL 20.0.0.20

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipip.conf

イベントサーバ設定ファイル（conf）を編集する。
イベントサーバ設定ファイル（conf）のportsパラメーターおよびremote-serverパラメーターを次に示すように編集してください。

ports 20.0.0.10 jp1imevt jp1imevtapi
remote-server hostL close 20.0.0.20

JP1/Baseを再起動する。
JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostAでの通信設定は完了です。

(2)　hostL（論理ホスト）で必要な設定

hostL(論理ホスト)で必要な通信設定手順を次に示します。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。
JP1/Baseと依存関係を持つプログラムには，例えばJP1/BaseのSNMPトラップ変換機能の起動に必要なJP1/Cm2/NNMがあります。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。
jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.10をhostA，20.0.0.11をhostB，20.0.0.20をhostLとして対応付ける。
hostA 20.0.0.10
hostB 20.0.0.11
hostL 20.0.0.20

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名 -h hostL

logical_ipip.confを編集する。
logical_ipip.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[hostL¥JP1BASE]に修正してください。

jbssetcnfコマンドを実行する。

jbssetcnf logical_ipip.conf

イベントサーバ設定ファイル（conf）を編集する。
イベントサーバ設定ファイル（conf）のportsパラメーターおよびremote-serverパラメーターを次に示すように編集してください。

ports 20.0.0.20 jp1imevt jp1imevtapi
remote-server hostL close 20.0.0.20

API設定ファイル（api）を編集する。
API設定ファイル（api）のserverパラメーターを次に示すように追加してください。

server hostA keep-alive 20.0.0.10
server hostL keep-alive 20.0.0.20
server hostB keep-alive 20.0.0.11

JP1/Baseを再起動する。
JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostL（論理ホスト）での通信設定は完了です。

(3)　hostBで必要な設定

hostBで必要な通信設定手順を次に示します。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。
JP1/Baseと依存関係を持つプログラムには，例えばJP1/BaseのSNMPトラップ変換機能の起動に必要なJP1/Cm2/NNMがあります。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。
jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11をhostB，20.0.0.20をhostLとして対応付ける。
hostB 20.0.0.11
hostL 20.0.0.20

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipip.conf

イベントサーバ設定ファイル（conf）を編集する。
イベントサーバ設定ファイル（conf）のportsパラメーターおよびremote-serverパラメーターを次に示すように追加してください。

ports 20.0.0.11 jp1imevt jp1imevtapi
remote-server hostL close 20.0.0.20

JP1/Baseを再起動する。
JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostBでの通信設定は完了です。

4.7　複数ネットワークでの運用から単一ネットワークでの運用に戻す

ネットワークを分離した環境に対応させるために行った通信設定を解除し，単一ネットワークでの運用に戻す場合は，次に示す設定手順に従って戻してください。

jp1hosts情報を共通定義情報から削除する。
共通定義情報にjp1hosts情報を登録した場合は，jbshostsimportコマンドを実行して削除してください。

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

通信方式設定ファイルを共通定義情報に反映する。
jbssetcnfコマンドを実行して共通定義情報に反映します。
物理ホストの場合は，次に示すようにjbssetcnfコマンドを実行してください。

同一ホスト上に論理ホスト環境がある場合
jbssetcnf physical_recovery_0651.conf

物理ホスト環境だけの場合
jbssetcnf physical_anyany.conf

論理ホストの場合は，logical_recovery_0651.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，LOGICAHOSTNAMEをクラスタシステム用の設定をした際に指定した論理ホスト名に修正してください。その後，次に示すようにjbssetcnfコマンドを実行してください。

jbssetcnf logical_recovery_0651.conf

イベントサーバ設定ファイル（conf）を編集する。
client-bindパラメーターを削除し，portsパラメーターのIPアドレスをクラスタ運用でない状態に戻すのであれば0.0.0.0に，クラスタ運用であれば物理ホスト名，論理ホスト名に対応するIPアドレスに変更してください。

JP1/Baseを再起動する。
JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

4.8　通信設定が必要な場合

この節では，定義ファイルの通信設定が必要となる場合について説明します。なお(1)から(3)には，OSの名前解決で優先的に付与される任意のIPアドレスを使用しても，名前解決できない場合を含みます。

＜この節の構成＞

(1)　OSの名前解決で，接続先のホストが名前解決できない場合

(2)　OSの名前解決で，イベント転送先イベントサーバ名が名前解決できない場合

(3)　OSの名前解決で，JP1/IM - Viewのイベント検索で指定したイベントサーバ名が名前解決できない場合

(4)　Windows環境で，同一ホスト上の物理ホストと論理ホストのサービスを起動する場合

(5)　クラスタシステムのセットアップ時

(6)　クラスタシステムおよび複数LAN接続の環境で，複数のLANを使用して通信したい場合

(7)　複数LAN接続の環境で，特定のLANを使用して通信したい場合

(8)　複数LAN接続の環境で，特定のLANを使用してイベントサーバへ接続したい場合

(9)　クラスタシステムから論理ホストを削除し，物理ホストだけの環境にする場合

(10)　イベントサーバ設定ファイルのportsパラメーターに，OSの名前解決で優先的に付与される任意のIPアドレス以外のIPアドレスを指定している場合

(1)　OSの名前解決で，接続先のホストが名前解決できない場合

jp1hosts定義ファイルに，接続先のホストでJP1/Baseが使用しているIPアドレスを設定します。jp1hosts定義ファイルの詳細については，「14.　定義ファイル」の「jp1hosts定義ファイル」を参照してください。

(2)　OSの名前解決で，イベント転送先イベントサーバ名が名前解決できない場合

イベントサーバ設定ファイル（conf）のremote-serverパラメーターに，転送先のイベントサーバが使用しているIPアドレスを設定します。イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

(3)　OSの名前解決で，JP1/IM - Viewのイベント検索で指定したイベントサーバ名が名前解決できない場合

API設定ファイル（api）のserverパラメーターに，イベントサーバが使用しているIPアドレスを設定します。API設定ファイルの詳細については，「14.　定義ファイル」の「API設定ファイル」を参照してください。

(4)　Windows環境で，同一ホスト上の物理ホストと論理ホストのサービスを起動する場合

jp1hosts定義ファイルに，JP1/Baseが使用する物理ホストのIPアドレスを設定します。

(5)　クラスタシステムのセットアップ時

イベントサーバ設定ファイル（conf）のportsパラメーターに，物理ホストおよび論理ホストが使用するIPアドレス，またはホスト名を設定します。物理ホストの設定時には，IPアドレスで指定することをお勧めします。

(6)　クラスタシステムおよび複数LAN接続の環境で，複数のLANを使用して通信したい場合

次のファイルを設定します。

jp1hosts定義ファイルに，自ホストのIPアドレスを設定します。

次の通信方式設定ファイルを共通定義情報に反映します。

物理ホスト環境の場合：physical_ipany.conf

論理ホスト環境の場合：logical_ipany.conf
ファイルをエディターで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[論理ホスト名¥JP1BASE]に修正します。

通信方式設定ファイルの詳細については，「4.3.3　通信方式を変更する」を参照してください。

イベントサーバ設定ファイル（conf）のportsパラメーターに，自イベントサーバのIPアドレスを設定します。

イベントサーバ設定ファイル（conf）のclient-bindパラメーターに，0.0.0.0を指定します。

(7)　複数LAN接続の環境で，特定のLANを使用して通信したい場合

次のファイルを設定します。

jp1hosts定義ファイルに，自ホストのIPアドレスを設定します。

次の通信方式設定ファイルを共通定義情報に反映します。

物理ホスト環境の場合：physical_ipip.conf

論理ホスト環境の場合：logical_ipip.conf
ファイルをエディターで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[論理ホスト名¥JP1BASE]に修正します。

イベントサーバ設定ファイル（conf）のportsパラメーターに，自イベントサーバの使用するIPアドレスを設定します。

イベントサーバ設定ファイル（conf）のclient-bindパラメーターに，JP1イベントを送信するために使用するIPアドレスを設定します。

(8)　複数LAN接続の環境で，特定のLANを使用してイベントサーバへ接続したい場合

API設定ファイル（api）のclientパラメーターに，イベントサーバへ接続する際に使用するIPアドレスを設定します。

(9)　クラスタシステムから論理ホストを削除し，物理ホストだけの環境にする場合

次のファイルを設定します。

通信方式設定ファイル（physical_anyany.conf）を共通定義情報に反映すると，ANYバインド方式に戻ります。

イベントサーバ設定ファイル（conf）のportsパラメーターに，0.0.0.0を指定します。

イベントサーバ設定ファイル（conf）のclient-bindパラメーターを削除します。

jp1hosts定義ファイルを，必要に応じて削除します。

(10)　イベントサーバ設定ファイルのportsパラメーターに，OSの名前解決で優先的に付与される任意のIPアドレス以外のIPアドレスを指定している場合

API設定ファイル（api）のserverパラメーターに，イベントサーバ設定ファイルのportsパラメーターに設定しているIPアドレスを設定します。

5.　起動と終了

この章では，JP1/Baseを起動および終了する方法を説明します。

＜この章の構成＞

5.1　JP1/Baseを起動および終了する（Windowsの場合）

5.2　JP1/Baseを起動および終了する（UNIXの場合）

5.1　JP1/Baseを起動および終了する（Windowsの場合）

JP1/Baseを起動および終了する方法について説明します。Windowsの場合，次の表に示すサービスを提供しています。

表5-1　JP1/Baseのサービス一覧（Windows）

サービス
［コントロールパネル］の［サービス］
ダイアログボックスに表示される名称

統合トレース（HNTRLib2）
Hitachi Network Objectplaza Trace Monitor 2

起動管理
JP1/Base Control Service

ユーザー管理を含むプロセス管理
JP1/Base※1

イベントサービス
JP1/Base Event※1

ログファイルトラップ管理サービス※2
JP1/Base LogTrap

イベントログトラップサービス
JP1/Base EventlogTrap

注※1　論理ホストのサービス名はそれぞれ次のように表示されます。

JP1_Base_論理ホスト名

JP1_Base_Event 論理ホスト名

注※2　ログファイルトラップ管理サービスは，ログファイルトラップを使用するために必要なサービスです。

注意事項

上記サービスの［ログオン］の設定は，デフォルトの「システムアカウント」のまま変更しないでください。また，［デスクトップとの対話をサービスに許可］オプションにチェックを入れないでください。サービスが正常に動作しなくなるおそれがあります。

サービスの起動方法，および終了方法について次に説明します。

＜この節の構成＞

5.1.1　サービスの起動

5.1.2　サービスの起動確認

5.1.3　サービスの終了

5.1.1　サービスの起動

Windowsの場合，次に示すサービスが，サービスに「自動」で登録され，システムの起動時に自動起動するようにデフォルトで設定されています。

Hitachi Network Objectplaza Trace Monitor 2（統合トレース）

JP1/Base Control Service（起動管理）※
注※　JP1/Power Monitorをインストールしている環境では，JP1/Base Control Serviceの起動方法を「手動」に変更しないでください。JP1/Power Monitorが正常に動作しなくなります。

また，JP1/Base Control Service（起動管理）が起動すると，次に示すサービスが起動するようにデフォルトで設定されています。

JP1/Base（ユーザー管理を含むプロセス管理）

JP1/Base Event（イベントサービス）

JP1/Base LogTrap（ログファイルトラップ管理サービス）

通常は，この設定を変更する必要はありません。なお，JP1/Base EventlogTrap（イベントログトラップサービス）やほかのアプリケーションプログラムについてもJP1/Base Control Service（起動管理）を使って順序性を持たせて自動起動するように設定できます。起動管理を利用する方法については，「7.　サービスの起動順序および終了順序の設定（Windows限定）」を参照してください。

JP1/Base Control Service（起動管理）を利用しない場合

JP1/Base Control Service（起動管理）を利用しないで各サービスを起動したい場合は，起動順序定義ファイル（JP1SVPRM.DAT）中に定義されている該当するサービスの定義を必ずコメントアウトしてください。また，依存関係にあるすべてのサービスの定義も必ずコメントアウトしてください。該当するサービスに関する定義部分すべての行頭に#（シャープ）を付けることによってコメントアウトできます。

起動順序定義ファイル（JP1SVPRM.DAT）を編集したあと，各サービスの操作を［コントロールパネル］の［サービス］ダイアログボックス上で行ってください。コメントアウトしないで各サービスを自動起動または手動起動した場合，KAVA4003-Eメッセージが出力され，正常に動作しなくなる場合があります。

注意事項

起動管理を使用する場合，起動順序定義ファイル（JP1SVPRM.DAT）中に定義されているサービスに対しては，［コントロールパネル］の［サービス］ダイアログボックス上で操作しないでください。KAVA4003-Eメッセージが出力され，起動管理によるサービスの自動起動および自動終了が正常に動作しなくなる場合があります。

ログファイルトラップ管理サービスおよびイベントログトラップサービスはイベントサービスの起動が前提です。ログファイルトラップ管理サービスおよびイベントログトラップサービスを起動する場合は，最初にイベントサービスを起動してください。

JP1/Baseがインストールされていて，イベントサービスが起動されていない場合，イベントサービスを利用するプログラムの性能に影響が出る場合があります。これを避けるため，イベントサービスを起動しない場合には，「14.　定義ファイル」の「API設定ファイル」を参照して，イベントの発行・取得を禁止する設定を行ってください。

5.1.2　サービスの起動確認

JP1/Baseのサービスが起動しているかどうかは，［コントロールパネル］の［サービス］ダイアログボックスで確認してください。状態が「開始」になっていれば，サービスは起動しています。

なお，Hitachi Network Objectplaza Trace Monitor 2サービス（統合トレース）が起動していなかった場合は，［コントロールパネル］の［サービス］ダイアログボックスで手動起動させてください。

そのほかのJP1/Baseのサービスを起動する場合は，JP1/Base Control Serviceサービス（起動管理）を利用して起動することをお勧めします（デフォルトでは，Hitachi Network Objectplaza Trace Monitor 2サービス，JP1/Base EventlogTrapサービス以外のサービスが起動するように設定されています）。起動管理の詳細については「7.　サービスの起動順序および終了順序の設定（Windows限定）」を，起動管理を利用しないでサービスを起動する方法については「5.1.1　サービスの起動」を参照してください。

5.1.3　サービスの終了

JP1/Baseでは，JP1/Base Control Service（起動管理）を利用してシステムの終了時にサービスを自動終了できます。ただし，サービスの自動終了を行いたい場合は，JP1/Power Monitorが必要です。サービスの自動終了を行いたいマシンにJP1/Power Monitorをインストールしてください。

JP1/Base Control Service（起動管理）を利用する方法については，「7.　サービスの起動順序および終了順序の設定（Windows限定）」を参照してください。また，JP1/Power Monitorの詳細については，マニュアル「JP1/Power Monitor」を参照してください。

JP1/Base Control Service（起動管理）およびJP1/Power Monitorを利用しないで各サービスを終了したい場合は，各サービスの操作を［コントロールパネル］の［サービス］ダイアログボックス上で行ってください。

なお，イベントサービス（JP1/Base Event）を停止する場合，先にユーザー管理を含むプロセス管理（JP1/Base），ログファイルトラップ管理サービス（JP1/Base LogTrap），イベントログトラップサービス（JP1/Base EventlogTrap）を停止してください。

5.2　JP1/Baseを起動および終了する（UNIXの場合）

UNIXの場合，コマンドを使ってJP1/Baseの各機能を起動および終了します。

コマンドを使って起動および終了できる各機能を次の表に示します。

表5-2　コマンドを使って起動および終了できるJP1/Baseの機能一覧（UNIX）

機能 | 起動コマンド | 終了コマンド
統合トレース（HNTRLib2）※1 | hntr2mon -d & | hntr2kill
イベントサービス | jevstart | jevstop
ユーザー管理を含むプロセス管理 | jbs_spmd | jbs_spmd_stop
ログファイルトラップ管理デーモン※2 | jevlogdstart | jevlogdstop
JP1/Base | jbs_start.model※3 | jbs_stop.model※4

注※1　統合トレース（HNTRLib2）は，JP1/Baseのインストール時に自動起動および自動終了するように設定されています。

注※2　ログファイルトラップ管理デーモンは，ログファイルトラップを使用するために必要なデーモンです。なお，ログファイルトラップ管理デーモンは，起動した状態でシステムを停止してもかまいません。

注※3　jbs_start.modelは，/etc/opt/jp1baseディレクトリに格納されています。jbs_start.modelを使用すると，統合トレース（HNTRLib2）以外のすべての機能を起動できます。通常はこのスクリプトを使用してJP1/Baseを起動してください。

注※4　jbs_stop.modelは，/etc/opt/jp1baseディレクトリに格納されています。jbs_stop.modelを使用すると，統合トレース（HNTRLib2）とログファイルトラップ管理デーモン以外のすべての機能を終了できます。通常は，このスクリプトを使用してJP1/Baseを終了してください。なお，クラスタシステムでないシステムで運用し，論理ホストでJP1/Baseを稼働させないで，統合トレース（HNTRLib2）以外の機能を終了する場合は，jbs_stop.modelを実行後，jevlogdstopコマンドを実行してください。

上記表のコマンドの詳細については，「13.　コマンド」を参照してください。

UNIXの場合，ユーザー管理を含むプロセス管理，イベントサービスおよびログファイルトラップ管理デーモンを，システムの起動時に自動起動させられます。また，ユーザー管理を含むプロセス管理やイベントサービスをシステムの終了時に自動終了させられます。

自動起動および自動終了の設定については，次に説明します。

＜この節の構成＞

5.2.1　自動起動および自動終了の設定

5.2.2　JP1/Baseの起動確認

5.2.1　自動起動および自動終了の設定

ここでは，自動起動の設定および自動終了の設定について説明します。

システムの起動時にユーザー管理を含むプロセス管理，イベントサービス，およびログファイルトラップ管理デーモンを自動起動する場合，インストールとセットアップの完了後，次に示す操作をします。

cd /etc/opt/jp1base
cp -p jbs_start.model jbs_start

また，システムの終了時にユーザー管理を含むプロセス管理およびイベントサービスを自動終了する場合，インストールとセットアップの完了後，次に示す操作をします。

cd /etc/opt/jp1base
cp -p jbs_stop.model jbs_stop

注意事項

ログファイルトラップを自動起動する場合，ログファイルトラップ起動定義ファイルを設定してください。

ログファイルトラップをjbs_startを使用して自動起動する場合，jbs_startを必要に応じて編集してください。この場合，イベントサービスおよびログファイルトラップ管理デーモンの起動後，ログファイルトラップを起動するように設定してください。

自動起動および自動終了の設定では，デフォルトで環境変数LANGにCを設定しています。必要に応じて変更してください。

AIX環境の場合

AIX環境で自動起動および自動終了する場合は，上記の操作に加え次に示す操作も必要です。

旧バージョンの自動起動の設定を解除する。
旧バージョンですでに自動起動が設定されている場合は，/etc/rc.tcpipファイルの記述内容を確認してください。次に示す記述があるときは削除します。
バージョン6のJP1/BaseおよびJP1/Baseを前提とする製品の場合
test -x /etc/opt/jp1base/jbs_start && /etc/opt/jp1base/jbs_start
test -x /etc/opt/jp1cons/jco_start && /etc/opt/jp1cons/jco_start
test -x /etc/opt/jp1cons/jajs_start && /etc/opt/jp1ajs2/jajs_start
バージョン5のJP1/IM - Agentの場合
test -x /etc/opt/jp1_ima/ima_start && /etc/opt/jp1_ima/ima_start

自動起動を設定する。
mkitabコマンドで，/etc/inittabファイルにJP1/Baseの記述を追加します。
mkitab -i hntr2mon "jp1base:2:wait:/etc/opt/jp1base/jbs_start"
手順1で解除したJP1/Baseを前提とする製品の自動起動を，再び自動起動に設定する場合は，jp1baseの行のあとに，mkitabコマンドでその製品の記述を追加してください。記述方法については，その製品のリリースノートを参照してください。

設定内容を確認する。
lsitabコマンドで，/etc/inittabファイルの設定内容を確認します。
lsitab -a
コマンドの実行結果が表示されます。
プロセスを起動する順序のとおり，hntr2mon（統合トレース），jp1baseの順に記述されていることを確認してください。
init:2:initdefault:
brc::sysinit:/sbin/rc.boot 3 >/dev/console 2>&1 # Phase 3 of system boot
：
：
hntr2mon:2:once:/opt/hitachi/HNTRLib2/etc/D002start
jp1base:2:wait:/etc/opt/jp1base/jbs_start

旧バージョンの自動終了の設定を解除する。
旧バージョンですでに自動終了が設定されている場合は，/usr/sbin/shutdownファイルの記述内容を確認してください。次に示す記述があるときは削除します。
バージョン6のJP1/BaseおよびJP1/Baseを前提とする製品の場合
test -x /etc/opt/jp1ajs2/jajs_stop && /etc/opt/jp1ajs2/jajs_stop
test -x /etc/opt/jp1cons/jco_stop && /etc/opt/jp1cons/jco_stop
test -x /etc/opt/jp1base/jbs_stop && /etc/opt/jp1base/jbs_stop
バージョン5のJP1/IM - Agentの場合
test -x /opt/jp1_ima/bin/ima_shutdown && /opt/jp1_ima/bin/ima_shutdown
また，次に示す記述は，統合トレース 03-03-/B以前の自動停止設定です。この記述があるときは削除してください。
test -x /opt/hitachi/HNTRLib2/bin/hntr2kill && /opt/hitachi/HNTRLib2/bin/hntr2kill

自動終了を設定する。
JP1/Baseを前提とする製品の記述のあとに，テキストエディターで，/etc/rc.shutdownファイルにJP1/Baseの記述を追加します。
test -x /etc/opt/jp1base/jbs_stop && /etc/opt/jp1base/jbs_stop
test -x /opt/hitachi/HNTRLib2/etc/D002stop && /opt/hitachi/HNTRLib2/etc/D002stop
手順4で解除したJP1/Baseを前提とする製品の自動終了を，再び自動終了に設定する場合は，jp1baseの行の前に，その製品の記述を追加してください。記述方法については，その製品のリリースノートを参照してください。

終了時の処理を追加する。
/etc/rc.shutdownファイルの最後に，次に示す1行を追加してください。
exit 0
/etc/rc.shutdownスクリプトは，最後に実行したコマンドの終了コードが「0」以外の場合は，エラーと認識しシャットダウン処理を中断します。

注意事項

自動起動および自動終了の設定では，デフォルトで環境変数LANGにCを設定しています。必要に応じて変更してください。

5.2.2　JP1/Baseの起動確認

JP1/Baseが起動しているかどうか確認する場合は，jbs_spmd_statusコマンド，およびjevstatコマンドを使ってJP1/Baseのプロセスの動作状態を確認してください。JP1/Baseのプロセスについては，「付録B.2　UNIXの場合」を参照してください。また，ユーザーが意図するJP1/Baseの機能が起動していなかった場合は，コマンドを使って起動してください。コマンドの詳細については「13.　コマンド」を参照してください。

注意事項

JP1/Baseを上書きインストールした場合，統合トレースをhntr2monコマンドを使って起動してください。これは，上書きインストール時に統合トレースが停止し，JP1/Baseを起動しても統合トレースログで情報を採取できなくなるからです。統合トレース（HNTRLib2）を手動で起動する場合は，C-Shell上からhntr2monコマンドを実行する必要があります。hntr2monコマンドの詳細については，「13.　コマンド」の「hntr2mon（UNIX限定）」を参照してください。

6.　ユーザー管理の設定

この章では，ユーザー管理の設定方法について，Windowsの場合とUNIXの場合に分けて説明します。

なお，この章ではJP1/IMおよびJP1/AJSの説明を中心に記載していますが，そのほかのJP1製品でも利用できる場合があります。各JP1製品のマニュアルでご確認ください。

＜この章の構成＞

6.1　ユーザー管理の設定（Windowsの場合）

6.2　ディレクトリサーバと連携してログイン認証をする場合の設定（Windowsの場合）

6.3　ユーザー管理の設定（UNIXの場合）

6.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）

6.1　ユーザー管理の設定（Windowsの場合）

Windowsで，ユーザー管理を使用する場合の設定方法について説明します。なお，JP1/Baseインストール時に自動セットアップ処理を実行した場合は，デフォルト値が設定されています。自動セットアップ処理のデフォルト値については，「2.2.1　インストール」を参照してください。

設定方法は，認証サーバとして使用するホストと認証サーバとして使用しないホストで異なります。

また，セカンダリー認証サーバを設置する場合，プライマリー認証サーバとセカンダリー認証サーバで設定する情報を同じにする必要があります。各ホストで必要な設定の流れと，マニュアルの参照先を次の図に示します。

図6-1　ユーザー管理の設定の流れ（Windowsの場合）

Windowsの場合，GUIまたはコマンドを使ってユーザー管理を設定します。GUIを表示するには，Windowsのスタートメニューから［プログラム］－［JP1_Base］－［環境設定］を選択してください。［JP1/Base環境設定］ダイアログボックスが表示されます。なお，GUIを操作するには，Administrators権限が必要です。［JP1/Base 環境設定］ダイアログボックスを次の図に示します。

図6-2　［JP1/Base 環境設定］ダイアログボックス

＜この節の構成＞

6.1.1　使用する認証サーバを指定する

6.1.2　JP1ユーザー（標準ユーザー）を設定する

6.1.3　JP1ユーザーの操作権限を設定する

6.1.4　プライマリー認証サーバの設定情報をコピーする

6.1.5　ユーザーマッピングを設定する前に

6.1.6　GUIを使ってユーザーマッピングを設定する

6.1.7　コマンドを使ってユーザーマッピングを設定する

6.1.8　ユーザー管理に関する注意事項

6.1.1　使用する認証サーバを指定する

認証サーバにするJP1/Baseがインストールされているホストを指定します。認証サーバは，次に示すホスト上で指定する必要があります。

認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）

JP1/IM - Manager，JP1/AJS - Managerがインストールされたホスト

認証サーバに指定したホストが，JP1ユーザーや，JP1資源グループに対する操作権限を管理します。JP1/IMおよびJP1/AJSが混在するシステムで，ユーザー認証圏を一つだけにしたい場合は，各ホストで同じ認証サーバを指定します。

認証サーバの設定手順を，GUIを使う場合とコマンドを使う場合に分けて，次に示します。

＜この項の構成＞

(1)　GUIを使って認証サーバを設定する

(2)　コマンドを使って認証サーバを設定する

(3)　認証サーバ設定後の作業

(1)　GUIを使って認証サーバを設定する

認証サーバは，［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブの［認証サーバの検索順序］で指定します。［認証サーバの検索順序］では，認証サーバの追加，指定済み認証サーバの削除および変更ができます。それぞれの手順について次に説明します。なお，［認証サーバの検索順序］で自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定する場合は，「JP1/Base」サービスを停止してから，設定してください。

認証サーバの追加

自ホストが認証サーバとして利用できるホストは，2台までです。［認証サーバ名］の上方に表示される認証サーバがプライマリー認証サーバ，下方に表示される認証サーバがセカンダリー認証サーバです。

［認証サーバ名］に認証サーバが2台指定されていなければ，認証サーバを追加できます。認証サーバの追加手順を次に示します。

［追加］ボタンをクリックする。
［認証サーバ］ダイアログボックスが表示されます。

認証サーバ名を入力し，［OK］ボタンをクリックする。
［認証サーバ］タブに戻ります。［認証サーバ名］に，［認証サーバ］ダイアログボックスで指定した認証サーバ名が表示されます。なお，認証サーバに指定するホストは，自ホストでも他ホストでもかまいません。

注意事項

認証サーバ名には，ホスト名を入力してください。IPアドレスは指定できません。

指定済み認証サーバの削除

認証サーバの削除手順を次に示します。

［認証サーバ名］から削除したい認証サーバを選択する。

［削除］ボタンをクリックする。

指定済み認証サーバの変更

認証サーバの変更手順を次に示します。

［認証サーバ名］から変更したい認証サーバを選択する。

［変更］ボタンをクリックする。
［認証サーバ］ダイアログボックスが表示されます。このダイアログボックスで認証サーバを変更します。

［OK］ボタンをクリックする。
［認証サーバ］タブに戻ります。［認証サーバ名］に，［認証サーバ］ダイアログボックスで変更した認証サーバ名が表示されます。

なお，プライマリー認証サーバとセカンダリー認証サーバを入れ替えたい場合は，［認証サーバ名］に表示されている認証サーバを選択し，［上へ］ボタンまたは［下へ］ボタンをクリックしてください。

注意事項

2台目の認証サーバの追加や認証サーバを2台指定した状態で認証サーバを変更した場合，［認証サーバ］ダイアログボックスの［認証サーバを閉塞状態に設定する］が活性化されます。これをチェックすると，その認証サーバは，認証サーバとして利用できなくなるため，通常はチェックしないでください。

［認証サーバの検索順序］での設定が完了したら，［適用］ボタンをクリックしてください。［認証サーバの検索順序］での設定が反映されます。自ホストを認証サーバに指定した場合，［認証サーバ名］で認証サーバ（自ホスト）を選択する（反転表示させる）と，［JP1ユーザー］および［JP1資源グループ別権限レベル］が活性化します。

(2)　コマンドを使って認証サーバを設定する

jbssetupsrvコマンドを使って，認証サーバの登録および削除ができます。jbssetupsrvコマンドの詳細については，「13.　コマンド」の「jbssetupsrv（Windows限定）」を参照してください。

認証サーバの登録

認証サーバを登録する場合は，次に示すコマンドを実行します。

jbssetupsrv [-h 論理ホスト名]
           プライマリー認証サーバ名 [セカンダリー認証サーバ名]

認証サーバの削除

認証サーバを削除する場合は，次に示すコマンドを実行します。

jbssetupsrv [-h 論理ホスト名]
           -d [認証サーバ名]

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

セカンダリー認証サーバ名を省略した場合は，ユーザー認証圏内で稼働する認証サーバは1台だけとなります。

-dオプションだけを指定した場合は，指定した論理ホストの認証サーバをすべて削除します。

(3)　認証サーバ設定後の作業

認証サーバを確認したい場合は，次に示すコマンドを実行してください。

jbslistsrv [-h 論理ホスト名]

jbslistsrvコマンドの詳細については，「13.　コマンド」の「jbslistsrv」を参照してください。

自ホストをプライマリー認証サーバに指定した場合は，「6.1.2　JP1ユーザー（標準ユーザー）を設定する」に進んでください。

自ホストをセカンダリー認証サーバに指定した場合は，プライマリー認証サーバに指定した認証サーバでの設定を済ませたあと，「6.1.4　プライマリー認証サーバの設定情報をコピーする」に進んでください。

自ホストを認証サーバに指定しなかった場合は，ユーザー認証の設定は終了です。

6.1.2　JP1ユーザー（標準ユーザー）を設定する

認証サーバでログイン認証をするJP1ユーザー（標準ユーザー）を設定します。なお，ディレクトリサーバでログイン認証をするJP1ユーザー（連携ユーザー）の設定については「6.2.2　JP1ユーザー（連携ユーザー）を設定する」を参照してください。特に断り書きがない場合，この項では「JP1ユーザー」とは「JP1ユーザー（標準ユーザー）」を示します。

JP1ユーザーは，プライマリー認証サーバに指定したホストで設定します。JP1ユーザーを設定する場合，「JP1/Base」サービスが起動している必要があります。「JP1/Base」サービスが起動していないときは，JP1ユーザーを設定する前に「JP1/Base」のサービスを起動してください。

JP1ユーザーの設定手順を，GUIを使う場合とコマンドを使う場合に分けて，次に示します。

＜この項の構成＞

(1)　GUIを使ってJP1ユーザーを設定する

(2)　コマンドを使ってJP1ユーザーを設定する

(1)　GUIを使ってJP1ユーザーを設定する

JP1ユーザーの設定は，［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブの［JP1ユーザー］で行います。

［JP1ユーザー］で設定する場合，［JP1ユーザー］を活性化する必要があります。［認証サーバの検索順序］の［認証サーバ名］で認証サーバを選び（反転表示させて），［JP1ユーザー］を活性化してください。なお，次に示す場合には，［JP1ユーザー］は活性化しないため，注意が必要です。

［認証サーバの検索順序］で認証サーバを変更し，［適用］ボタンが活性化していた場合

選んだ（反転表示させた）認証サーバの状態が「閉塞中」の場合

［適用］ボタンが活性化していた場合は，［適用］ボタンをクリックしてください。「閉塞中」だった場合は，「6.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）」を参照して，閉塞状態を解除してください。

［追加］ボタンをクリックすると，［JP1ユーザー］ダイアログボックスが表示されます。

図6-3　［JP1ユーザー］ダイアログボックス

このダイアログボックスでJP1ユーザーおよびパスワードを設定します。［ディレクトリサーバに連携する］はチェックしないでください。チェックすると連携ユーザーの入力モードになり，パスワードが入力できなくなります。

JP1ユーザー名に使用できるのは，小文字だけです。大文字で入力した場合でも小文字のJP1ユーザー名として登録します。パスワードは，大文字と小文字を区別して入力してください。JP1ユーザー名およびパスワードに指定できる文字の制限を次の表に示します。

表6-1　JP1ユーザー名およびパスワードの文字制限

対象 | バイト数 | 使用禁止文字
JP1ユーザー名 | 1～31バイト | * / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < > およびスペース，タブ
パスワード | 6～32バイト | ¥ " : およびスペース，タブ

［OK］ボタンまたは［キャンセル］ボタンをクリックすると，［認証サーバ］タブに戻ります。

登録されたJP1ユーザーは［ユーザー名］に表示されます。登録したJP1ユーザーのパスワードを変更したい場合は，［ユーザー名］に表示されたJP1ユーザーを選択し，［パスワード変更］ボタンをクリックしてください。

また，［ユーザー名］に表示されたJP1ユーザーを選択し，［削除］ボタンをクリックすると，選択したJP1ユーザーが削除されます。

(2)　コマンドを使ってJP1ユーザーを設定する

コマンドを使って，JP1ユーザーの登録，削除，およびJP1ユーザーのパスワードの変更ができます。また，登録したJP1ユーザーを一覧表示するコマンドも提供しています。各コマンドの詳細については，「13.　コマンド」を参照してください。

JP1ユーザーの登録

JP1ユーザーを認証サーバに登録する場合，次に示すコマンドを実行します。

jbsadduser JP1ユーザー名

JP1ユーザー名には，小文字だけを使用してください。

コマンド実行後にパスワードの入力を促されます。大文字と小文字を区別して入力してください。JP1ユーザー名およびパスワードに指定できる文字の制限については，表6-1を参照してください。

JP1ユーザーのパスワードの変更

登録したJP1ユーザーのパスワードを変更する場合は，次に示すコマンドを実行します。

jbschgpasswd JP1ユーザー名

JP1ユーザーの削除

登録したJP1ユーザーを削除する場合は，次に示すコマンドを実行します。

jbsrmuser JP1ユーザー名

JP1ユーザーの一覧表示

登録したJP1ユーザーの情報を確認する場合は，次に示すコマンドを実行します。

jbslistuser

6.1.3　JP1ユーザーの操作権限を設定する

認証サーバ（プライマリー認証サーバ）で必要な設定です。JP1ユーザーが，ジョブやジョブネットなどのJP1資源グループに対して，どのような操作ができるか（JP1権限レベル）を設定します。

注意事項

JP1/AJSで，JP1資源グループ名を指定していないジョブやジョブネットは，操作権限の設定の対象になりません。すべてのJP1ユーザーによるすべてのアクセスが可能になります。

JP1ユーザーの操作権限の設定はGUIまたはコマンドで設定します。GUIの場合は，個別にJP1ユーザーの操作権限を設定します。コマンドの場合は，個別設定だけではなく，複数のJP1ユーザーの操作権限を一括して設定することもできます。

JP1ユーザーの操作権限の設定手順を，GUIを使う場合とコマンドを使う場合に分けて，次に示します。

＜この項の構成＞

(1)　GUIを使ってJP1ユーザーの操作権限を設定する

(2)　コマンドを使ってJP1ユーザーの操作権限を一括して設定する

(3)　コマンドを使ってJP1ユーザーの操作権限を個別に登録する

(4)　コマンドを使ってJP1ユーザーの操作権限を個別に削除する

(1)　GUIを使ってJP1ユーザーの操作権限を設定する

［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブの［JP1資源グループ別権限レベル］で設定します。

［JP1ユーザー］の［ユーザー名］から設定したいユーザーを選択します。選択すると，［JP1資源グループ別権限レベル］にそのユーザーがアクセスできるグループ（JP1資源グループ）とそのグループに対する権限レベル（JP1権限レベル）が表示されます。

［追加］ボタン，または［グループ名］に表示されるグループを選択し，［変更］ボタンをクリックすると，［JP1資源グループ詳細］ダイアログボックスが表示されます。

図6-4　［JP1資源グループ詳細］ダイアログボックス

［JP1資源グループ詳細］ダイアログボックスでJP1資源グループとJP1権限レベルを設定します。JP1資源グループに「*」を指定すると，すべてのJP1資源グループにアクセスできるようになります。なお，JP1資源グループで「*」を指定したJP1ユーザーに，「*」以外のJP1資源グループは設定できません。

指定するJP1資源グループおよびJP1権限レベルの詳細については，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。

(2)　コマンドを使ってJP1ユーザーの操作権限を一括して設定する

コマンドを使ってJP1ユーザーの操作権限を一括して設定できます。JP1ユーザーの操作権限を一括して登録する場合，ユーザー権限レベルファイル（JP1_UserLevel）に操作権限を定義します。編集後，jbsaclreloadコマンドを実行すると設定が反映されます。jbsaclreloadコマンドの詳細については，「13.　コマンド」の「jbsaclreload」を参照してください。ユーザー権限レベルファイルの詳細については，「14.　定義ファイル」の「ユーザー権限レベルファイル」を参照してください。

注意事項

ユーザー権限レベルファイル（JP1_UserLevel）は，GUIでも利用しています。GUIで設定した内容は，このファイルに反映されます。また，このファイルをエディターで編集後，jbsaclreloadコマンドを実行すれば，設定した内容がGUIに反映されます。

(3)　コマンドを使ってJP1ユーザーの操作権限を個別に登録する

コマンドを使ってJP1ユーザーの操作権限を追加または変更する場合，登録したいJP1ユーザーの操作権限を記述した定義ファイルを作成する必要があります。

定義ファイルは，ユーザーが任意の場所に格納できます。ファイルの形式は，ユーザー権限レベルファイル（JP1_UserLevel）の形式と同じです。ユーザー権限レベルファイルの詳細については，「14.　定義ファイル」の「ユーザー権限レベルファイル」を参照してください。

定義ファイルを設定したあと，次のコマンドを実行すると，定義ファイルの情報が認証サーバに登録されます。

jbssetacl -f 定義ファイル名

jbssetaclコマンドの詳細については，「13.　コマンド」の「jbssetacl」を参照してください。

(4)　コマンドを使ってJP1ユーザーの操作権限を個別に削除する

登録したJP1ユーザーの操作権限を個別に削除したい場合は，次のコマンドを実行してください。

jbsrmacl -u JP1ユーザー名

このコマンドを実行すると，指定したJP1ユーザーに設定されている操作権限がすべて削除されるためご注意ください。

jbsrmaclコマンドの詳細については，「13.　コマンド」の「jbsrmacl」を参照してください。

6.1.4　プライマリー認証サーバの設定情報をコピーする

セカンダリー認証サーバを設置する場合，プライマリー認証サーバと同じ設定で運用しなければなりません。そのため，プライマリー認証サーバの設定完了後，プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーする必要があります。プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーするための手順を次に示します。

プライマリー認証サーバで，JP1ユーザーおよび操作権限の設定を完了する。
JP1ユーザーの設定については，「6.1.2　JP1ユーザー（標準ユーザー）を設定する」または「6.2.2　JP1ユーザー（連携ユーザー）を設定する」を参照してください。
JP1ユーザーの操作権限の設定については，「6.1.3　JP1ユーザーの操作権限を設定する」を参照してください。

セカンダリー認証サーバを起動する。
JP1/Baseのサービスを起動し，セカンダリー認証サーバを起動してください。認証サーバが起動しているかどうかは，jbs_spmd_statusコマンドで確認できます。コマンド実行後，表示される情報の中にjbssessionmgrがあれば，認証サーバが起動しています。

プライマリー認証サーバの設定ファイルをFTPやFDなどを使ってコピーする。
プライマリー認証サーバの設定ファイルをFTPやFDなどを使って，セカンダリー認証サーバにコピーします。コピーする設定ファイルは，JP1_AccessLevel，JP1_Group，JP1_Passwd，JP1_UserLevelです。これらのファイルは以下のフォルダに格納されています。
インストール先フォルダ¥conf¥user_acl¥
コピー先フォルダは，自ホスト上の同じフォルダになります。また，論理ホストの場合は，以下のフォルダに格納されています。
共有フォルダ名¥jp1base¥conf¥user_acl¥

コマンドを使って設定を反映させる。
最後に，コピーした設定情報のファイルの内容を反映させます。jbs_spmd_reloadコマンドを実行し，正常終了すれば設定が有効になります。

コマンドの詳細については，「13.　コマンド」を参照してください。

注意事項

プライマリー認証サーバとセカンダリー認証サーバのJP1/Baseは同じバージョンにしてください。

セカンダリー認証サーバが起動していない場合は，自ホストを認証サーバに指定しているか確認してください。［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブ内の［認証サーバの検索順序］で自ホストを指定していて，かつ，［JP1ユーザー］および［JP1資源グループ別権限レベル］が活性化されているか確認してください。活性化されていれば，JP1/Baseのサービスを起動すると同時に，認証サーバも起動されます。

設定ファイルはテキストファイルです。異なるプラットフォーム間で転送する場合，文字コードに注意してください。FTPで転送する場合は，必ずASCII転送をしてください。

6.1.5　ユーザーマッピングを設定する前に

ユーザーマッピングは，JP1ユーザーとOSユーザーを対応づける機能です。Windowsの場合，ユーザーマッピングを設定する前に，ユーザーマッピングを設定するOSユーザー，およびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。

ユーザー権利は，OSの機能を使ってOSユーザーに与えます。なお，Active Directoryを使ったドメイン環境で運用している場合は，ドメインコントローラーのあるホストとドメイン内のホストで設定手順が異なります。OSユーザーに必要な権利と，Active Directory環境でOSユーザーにユーザー権利を与える方法について説明します。

＜この項の構成＞

(1)　ユーザーマッピングを設定するOSユーザーに必要なユーザー権利

(2)　ユーザーマッピングされるOSユーザーに必要なユーザー権利

(3)　Active Directory環境でOSユーザーにユーザー権利を与える方法

(1)　ユーザーマッピングを設定するOSユーザーに必要なユーザー権利

ユーザーマッピングを設定するOSユーザーとは，次に示すユーザーのことです。

環境設定GUIの［ユーザーマッピング］タブでユーザーマッピングを設定するユーザー

jbsmkpassコマンドを実行するユーザー

jbsmkumapコマンドを実行するユーザー

jbspassmgrコマンドを実行するユーザー

jbssetumapコマンドを実行するユーザー

jbsumappassコマンドを実行するユーザー

通常，上記の設定をするOSユーザーには，「オペレーティングシステムの一部として機能」というユーザー権利を与える必要があります。ただし，このマニュアルで対象製品としているWindowsの場合は，このユーザー権利を与える必要はありません。そのままユーザーマッピングの設定ができます。

注意事項

ユーザーマッピングを設定するOSユーザーに「オペレーティングシステムの一部として機能」のユーザー権利を与えた場合，いったんログオフしてください。ログオフしないと，権利の変更が反映されず，ユーザーマッピングの設定が正しくできないおそれがあります。

［ユーザーマッピング］タブの［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックすると，ユーザー権利を与えなくてもユーザーマッピングができるようになります。ただし，次に示すOSユーザーのマッピングにも成功するので，注意が必要です。実際にジョブやリモートコマンドを実行するときに権限エラーとなってしまいます。
・システム（Windows）に登録されていないOSユーザー
・パスワードが誤っているOSユーザー
・「ローカル ログオン」のユーザー権利がないOSユーザー

(2)　ユーザーマッピングされるOSユーザーに必要なユーザー権利

ユーザーマッピングされるOSユーザーに必要なユーザー権利を次に示します。

JP1/IM - Managerでリモートコマンドや自動アクションを実行する場合

「ローカル ログオン」

「サービスとしてログオン」

JP1/AJSでジョブを実行する場合

「ローカル ログオン」

ユーザー権利は，ローカルホストごとに［管理ツール］の［ローカル セキュリティ ポリシー］を使って与えてください。［管理ツール］は［コントロールパネル］上にあります。

(3)　Active Directory環境でOSユーザーにユーザー権利を与える方法

Active Directory環境でOSユーザーにユーザー権利を与える方法について説明します。従来の環境では，ローカルホスト上でユーザー権利を設定するだけでしたが，Active Directory環境では，ドメインコントローラーのあるホストとドメイン内のローカルホストとで設定手順が異なります。以降で，それぞれの設定手順を示します。

Active Directory環境では「ローカル ログオン」の権利は，デフォルトですべてのOSユーザーに与えられています。デフォルトのまま使用している場合は，改めて「ローカル ログオン」のユーザー権利を設定しないでください。

次に示す設定手順は，一つのドメインコントローラホストの直下に複数台のローカルホストを構成している場合の設定手順です。サイトや組織単位（OU）などを構成したり，ポリシーの継承を途中でやめるなど，複雑な設定をしている場合は，この設定手順でユーザー権利を与えられないことがあります。詳しくはActive Directoryの管理者に問い合わせてください。

ドメインコントローラホストでユーザー権利を設定する手順

ドメインコントローラホストでユーザー権利を設定する手順を次に示します。

ドメインコントローラホストの［ドメインコントローラセキュリティポリシー］ダイアログボックスで，与えたい権利を選択し，ドメインユーザーを追加する。

コマンドを使って，セキュリティポリシーの更新を反映させる。
次に示すコマンドを実行してください。
　gpupdate /target:user
　gpupdate /target:computer
反映されたかどうかは，イベントビューアで確認できます。

ドメインコントローラホストの［ローカルセキュリティポリシー］ダイアログボックスで［有効なポリシーの設定］がチェックされていることを確認する。
ポリシーの設定は，ローカルポリシー，サイトのグループポリシー，ドメインのグループポリシー，組織単位（OU）のグループポリシーの順に継承，上書きされていきます。また，継承を途中でやめるように設定することもできます。上位でユーザー権利を与えても有効にならない場合や，途中でユーザー権利を与えても最終的に無効になる場合があります。このため，必ず［有効なポリシーの設定］がチェックされていることを確認してください。

ドメイン内のローカルホストでユーザー権利を設定する手順

ドメイン内のローカルホストでユーザー権利を設定する手順を次に示します。

ドメインコントローラホストの［ドメイン セキュリティ ポリシー］ダイアログボックスで，与えたいユーザー権利を選択し，ドメインユーザーやドメイングループを追加する。
ローカルホストのローカルユーザーに関しては追加できません。

ローカルホストの［ローカル セキュリティ ポリシー］ダイアログボックスで，与えたいユーザー権利を選択し，ドメインユーザーやドメイングループを追加する（この手順は省略できます）。

ドメインコントローラホストで，コマンドを使ってポリシーの更新を反映させる。
次に示すコマンドを実行してください。
　gpupdate /target:user
　gpupdate /target:computer
反映されたかどうかは，イベントビューアで確認できます。
念のためローカルホスト上でもコマンドを実行してください。

ローカルホストの［ローカル セキュリティ ポリシー］ダイアログボックスで［有効なポリシーの設定］がチェックされていることを確認する。
ポリシーの設定は，ローカルポリシー，サイトのグループポリシー，ドメインのグループポリシー，組織単位（OU）のグループポリシーの順に継承，上書きされていきます。また，継承を途中でやめるように設定することもできます。上位でユーザー権利を与えても有効にならない場合や，途中でユーザー権利を与えても最終的に無効になる場合があります。このため，必ず［有効なポリシーの設定］がチェックされていることを確認してください。

なお，［ローカル セキュリティ ポリシー］ダイアログボックスで［有効なポリシーの設定］がチェックされていても，実際には権限が与えられていない場合があります。DNSの設定やIPアドレスに間違いがあった場合に，このような現象が発生することがあります。詳細についてはOSのヘルプやOS関連ドキュメントなどを参照してください。

6.1.6　GUIを使ってユーザーマッピングを設定する

GUIでユーザーマッピングを設定する場合，［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブを選択します。［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブを，次の図に示します。

図6-5　［JP1/Base 環境設定］ダイアログボックス（［ユーザーマッピング］タブ）

［ユーザーマッピング］タブでは，認証サーバに登録されているJP1ユーザーと自ホストのOSに登録されているユーザー（OSユーザー）をマッピングします。なお，ユーザーマッピングを設定する前に，ユーザーマッピングを設定するOSユーザーおよびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。詳細については，「6.1.5　ユーザーマッピングを設定する前に」を参照してください。

＜この項の構成＞

(1)　［パスワード管理］での設定

(2)　［JP1ユーザー］での設定

(3)　［マッピングOSユーザー一覧］での設定

(1)　［パスワード管理］での設定

Windowsの場合，ユーザーマッピングを設定する各ホストで，マッピングするOSユーザーとそのOSユーザーのパスワード情報を，JP1/Baseのパスワード管理情報に登録する必要があります。［パスワード管理］は，OSユーザーとそのOSユーザーのパスワード情報をパスワード管理情報に登録するための項目です。

パスワード管理情報を登録したあとにシステムのOSユーザーのパスワードを変更した場合は，パスワード管理情報に登録してあるOSユーザーのパスワードも変更してください。

パスワード管理情報を設定する方法について説明します。

注意事項

［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックした場合，次に示す条件であっても，OSユーザーの登録に成功します。

システム（Windows）に登録されていないOSユーザーの登録

パスワードが誤っているOSユーザーの登録

［パスワード管理］で設定するユーザーに「オペレーティングシステムの一部として機能」のユーザー権利※がない状態でのOSユーザーの登録

OSユーザーに「ローカル ログオン」のユーザー権利がない状態でのOSユーザーの登録

［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックしなかった場合は，上記個条書きの条件でOSユーザーを登録しようとしても失敗します。

注※　このマニュアルで対象製品としていないWindowsの場合に必要なユーザー権利です。このマニュアルで対象製品としているWindowsの場合は，このユーザー権利を与えなくてもOSユーザーの登録に成功します。

パスワード管理情報の設定手順を次に示します。

［パスワード管理］の［設定］ボタンをクリックする。
［パスワード管理］ダイアログボックスが表示されます。

図6-6　［パスワード管理］ダイアログボックス

OSユーザーおよびそのOSユーザーのパスワード情報を登録，変更，および削除する。
OSユーザーとそのOSユーザーのパスワードを登録する場合は［新規登録］ボタン，登録したOSユーザーのパスワードが変更された場合は［パスワード変更］ボタン，登録されたOSユーザーのパスワード情報を削除する場合は［ユーザー削除］ボタンをクリックします。
なお，登録するOSユーザー名には，ユーザー名だけでなく，自ホストが所属するドメイン名やローカルホスト名も記述できます。その場合，「domain¥user1」，「server¥user1」のように，ドメイン名やローカルホスト名とユーザー名の区切り文字として「¥」を使用します。ドメイン名やローカルホスト名を記述した場合，登録するOSユーザーがドメイン上のユーザーまたはローカルユーザーであるかどうかチェックされます。ドメイン上のユーザーまたはローカルユーザーでなかった場合，そのOSユーザー名では登録できません。
ドメイン名やローカルホスト名を記述しなかった場合，登録するOSユーザー名がローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，信頼するドメインを含むドメイン上のユーザーであるかどうかチェックされます。ローカルユーザーまたはドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。
なお，Windowsのドメインコントローラー上で登録する場合は，「ドメイン名¥ユーザー名」の形式で記述してください。ドメインコントローラー上ではドメインユーザーとローカルユーザーの区別がないため，ドメインユーザーとして扱われるためです。

注意事項

［ユーザーマッピング］タブの［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックした場合，OSユーザー名やOSユーザーのパスワードが誤っていても，パスワード管理情報に登録できます。ただし，実際にジョブやリモートコマンドを実行するときに権限エラーとなってしまうので，注意が必要です。

［終了］ボタンをクリックする。
［パスワード管理］ダイアログボックスが閉じ，［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブに戻ります。

(2)　［JP1ユーザー］での設定

［JP1ユーザー］では，OSユーザーとマッピングしたいJP1ユーザー，および操作命令を出すサーバホストを設定します。

設定手順を次に示します。

［追加］ボタンをクリックする。
［JP1ユーザー］ダイアログボックスが表示されます。

図6-7　［JP1ユーザー］ダイアログボックス

このダイアログボックスで，OSユーザーとマッピングしたいJP1ユーザーとそのJP1ユーザーがジョブやリモートコマンド（自動アクション）などの操作命令を出すサーバホストを設定します。サーバホストに「*」を指定すると，すべてのサーバホストからの操作が有効になります。

サーバホストが物理ホストの場合

サーバホスト名には，hostnameコマンドで表示されるホスト名を指定してください。ただし，DNS運用でドメイン名を使用している場合は，FQDN形式のホスト名を指定してください。

サーバホストが論理ホストの場合

DNS運用しているかどうかに関係なく，論理ホスト名を指定してください。

なお，JP1/AJS - Viewからログインする場合，および自ホストに対してJP1/AJSのコマンドを実行する場合，自ホスト名をサーバホスト名として設定する必要があります。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

［OK］ボタンをクリックする。
［JP1ユーザー］ダイアログボックスが閉じ，［マッピングOSユーザー詳細］ダイアログボックスが表示されます。

図6-8　［マッピングOSユーザー詳細］ダイアログボックス

［マッピングOSユーザー詳細］ダイアログボックスでJP1ユーザーとOSユーザーをマッピングする。
このダイアログボックスで，マッピングするOSユーザーとマッピングしないOSユーザーを設定します。なお，ここに表示されるOSユーザーは，［パスワード管理］ダイアログボックスで登録されたOSユーザーになります。
また，プライマリーOSユーザーには，ジョブの実行やコマンド実行時などにOSユーザー名を指定しなかった場合に，デフォルトとしてマッピングしたいOSユーザーを指定します。

［OK］ボタンをクリックする。
JP1ユーザーとOSユーザーのマッピングが完了します。

(3)　［マッピングOSユーザー一覧］での設定

［マッピングOSユーザー一覧］には，マッピングしたOSユーザー名が表示されます。この［マッピングOSユーザー一覧］で，JP1ユーザーがどのOSユーザーとマッピングしているか確認できます。また，JP1ユーザーとOSユーザーのマッピング内容を変更する場合にも使用します。

マッピング内容の変更手順を次に示します。

［JP1ユーザー］の［JP1ユーザー名］からマッピングの内容を変更したいユーザーを選択する。
選択すると，［マッピングOSユーザー一覧］に，そのユーザーがマッピングしているOSユーザー名が表示されます。

［変更］ボタンをクリックする。
［変更］ボタンをクリックすると，［マッピングOSユーザー詳細］ダイアログボックスが表示されます。

図6-9　ユーザーがマッピングしているOSユーザー名

［マッピングOSユーザー詳細］ダイアログボックスで，マッピングする，またはマッピングしないOSユーザーの変更，およびプライマリーOSユーザーを設定する。

［OK］ボタンをクリックする。
JP1ユーザーとOSユーザーのマッピングが完了します。

6.1.7　コマンドを使ってユーザーマッピングを設定する

ここでは，コマンドを使ったユーザーマッピングの設定方法について説明します。なお，ユーザーマッピングを設定する前に，ユーザーマッピングを設定するOSユーザーおよびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。詳細については，「6.1.5　ユーザーマッピングを設定する前に」を参照してください。

Windowsの場合，ユーザーマッピングを設定する各ホストで，マッピングするOSユーザーとそのOSユーザーのパスワード情報を，JP1/Baseのパスワード管理情報に登録する必要があります。

注意事項

JP1/BaseのGUI，［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブの［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックした場合，次に示す条件であっても，OSユーザーの登録に成功します。

システム（Windows）に登録されていないOSユーザーの登録

パスワードが誤っているOSユーザーの登録

［パスワード管理］で設定するユーザーに「オペレーティングシステムの一部として機能」のユーザー権利※がない状態でのOSユーザーの登録

OSユーザーに「ローカル ログオン」のユーザー権利がない状態でのOSユーザーの登録

［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックしなかった場合は，上記条件でコマンドを使ってOSユーザーを登録しようとしても失敗します。

注※　このマニュアルで対象製品としていないWindowsの場合に必要なユーザー権利です。このマニュアルで対象製品としているWindowsの場合は，このユーザー権利を与えなくてもOSユーザーの登録に成功します。

JP1/Baseでは，パスワード管理情報を設定するためのコマンドを提供しています。提供しているコマンドとその用途を次の表に示します。

表6-2　パスワード管理情報設定用コマンド

コマンド名 | 用途 | 参照先
jbspassmgr | ［パスワード管理］ダイアログボックスを表示するコマンドです。 | （1）
jbsmkpass | 定義ファイルを利用して複数のOSユーザーのパスワード管理情報を一括して設定するコマンドです。 | （2）
jbsumappass | OSユーザーを個別に追加したり，パスワード管理情報に登録されたOSユーザーのパスワードを個別に変更したりするコマンドです。 | （3）
jbsrmumappass | パスワード管理情報に登録されたOSユーザーを個別に削除するコマンドです。 | （4）

上記表の四つのコマンドのどれかを利用してJP1/Baseのパスワード管理情報の設定を済ませたら，ユーザーマッピング情報を登録します。

JP1/Baseでは，共通定義情報にユーザーマッピング情報を一括して設定するコマンドや，個別にユーザーマッピング情報を登録，変更，削除するコマンドを提供しています。提供しているコマンドとその用途を次の表に示します。

表6-3　ユーザーマッピング情報設定用コマンド

コマンド名 | 用途 | 参照先
jbsmkumap | 定義ファイルを利用して，共通定義情報にユーザーマッピング情報を一括して登録するコマンドです。 | （5）
jbssetumap | 定義ファイルを利用して，共通定義情報にユーザーマッピング情報を個別に追加したり，共通定義情報に登録されたユーザーマッピング情報を変更したりするコマンドです。 | （6）
jbsrmumap | 共通定義情報に登録されたユーザーマッピング情報を個別に削除するコマンドです。 | （7）

＜この項の構成＞

(1)　［パスワード管理］を表示する

(2)　OSユーザーのパスワード管理情報を一括して設定する

(3)　OSユーザーを個別に登録する

(4)　OSユーザーを個別に削除する

(5)　ユーザーマッピング情報を一括して設定する

(6)　ユーザーマッピング情報を個別に登録する

(7)　ユーザーマッピング情報を個別に削除する

(1)　［パスワード管理］を表示する

jbspassmgrコマンドを実行すると，［パスワード管理］ダイアログボックスが表示されます。このダイアログボックスで各ホストに登録されたOSユーザー，およびそのOSユーザーのパスワード情報を登録・管理します。パスワードは，OSのアカウントと同じものを入力してください。［パスワード管理］ダイアログボックスの操作については，「6.1.6(1)　［パスワード管理］での設定」を参照してください。

jbspassmgrコマンドの詳細については，「13.　コマンド」の「jbspassmgr（Windows限定）」を参照してください。

(2)　OSユーザーのパスワード管理情報を一括して設定する

jbsmkpassコマンドを実行すると，共通定義情報に登録したパスワード情報がいったんすべて削除され，パスワード定義ファイルに記述したパスワード管理情報が共通定義情報に一括して設定されます。jbsmkpassコマンドの詳細については，「13.　コマンド」の「jbsmkpass（Windows限定）」を参照してください。なお，jbsmkpassコマンドを使用する場合，パスワード定義ファイルにパスワード管理情報を設定する必要があります。定義ファイルは，ユーザーが任意の場所に格納できます。格納場所を忘れないようにしてください。パスワード定義ファイルの詳細については，「14.　定義ファイル」の「パスワード定義ファイル（Windows限定）」を参照してください。

(3)　OSユーザーを個別に登録する

jbsumappassコマンドを実行すると，JP1/Baseのパスワード管理情報に新規OSユーザーの個別登録，または登録済みOSユーザーのパスワード変更ができます。

このコマンドは，シェルスクリプトなどから実行することによってOSが管理するパスワード情報を変更するタイミングで，JP1/Baseが管理するパスワード管理情報を更新したい場合に利用できます。

次の形式でコマンドを実行します。

jbsumappass -u OSユーザー名 [-p パスワード]

jbsumappassコマンドの詳細については，「13.　コマンド」の「jbsumappass（Windows限定）」を参照してください。

(4)　OSユーザーを個別に削除する

jbsrmumappassコマンドを実行すると，JP1/Baseのパスワード管理情報に登録されたOSユーザーを個別に削除できます。

このコマンドは，シェルスクリプトなどから実行することによってOSが管理するユーザーを削除するタイミングでJP1/Baseが管理するパスワード管理情報からOSユーザーを削除したい場合に，利用できます。

次の形式でコマンドを実行します。

jbsrmumappass -u OSユーザー名

jbsrmumappassコマンドの詳細については，「13.　コマンド」の「jbsrmumappass（Windows限定）」を参照してください。

(5)　ユーザーマッピング情報を一括して設定する

コマンドを使ってユーザーマッピング情報を一括して設定する場合は，ユーザーマッピング定義ファイル（jp1BsUmap.conf）で設定します。ユーザーマッピング定義ファイルの詳細については，「14.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。

ユーザーマッピング定義ファイル（jp1BsUmap.conf）をエディターで編集したあと，jbsmkumapコマンドを実行すると，共通定義情報に登録されていたマッピング情報がいったんすべて削除され，ユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報が共通定義情報に登録されます。なお，設定されたマッピング情報を確認する場合は，jbsgetumapコマンドを実行します。

jbsmkumapコマンドおよびjbsgetumapコマンドの詳細については，「13.　コマンド」の「jbsmkumap」および「jbsgetumap」を参照してください。

注意事項

ユーザーマッピング定義ファイル（jp1BsUmap.conf）は，GUIでも利用しています。GUIで設定した内容は，このファイルに反映されます。また，このファイルを編集後，jbsmkumapコマンドを実行すれば，設定した内容がGUIに反映されます。

(6)　ユーザーマッピング情報を個別に登録する

jbssetumapコマンドを実行すると，ユーザーマッピング情報を個別に追加したり変更したりできます。ユーザーマッピング情報を個別に追加または変更するには，jbssetumapコマンドのオプションにユーザーマッピング情報を直接指定して登録する方法と，ユーザーマッピング情報を記述した定義ファイルを使用して登録する方法があります。

ユーザーマッピング情報を指定して共通定義情報に登録する場合は，次のコマンドを実行してください。

jbssetumap {-u JP1ユーザー名| -ua}
          {-sh サーバホスト名| -sha}
           -o OSユーザー名[,OSユーザー名]
          [-no]

定義ファイルを作成して登録する場合は，次のコマンドを実行してください。

jbssetumap -f 定義ファイル名

定義ファイルは任意の場所に格納できますが，ファイルの形式はユーザーマッピング定義ファイル（jp1BsUmap.conf）と同じにしてください。ユーザーマッピング定義ファイルの形式については，「14.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。jbssetumapコマンドの詳細については，「13.　コマンド」の「jbssetumap」を参照してください。

(7)　ユーザーマッピング情報を個別に削除する

共通定義情報からユーザーマッピング情報を個別に削除する場合，jbsrmumapコマンドを実行してください。

次の形式でコマンドを実行します。

jbsrmumap -u JP1ユーザー名

jbsrmumapコマンドの詳細については，「13.　コマンド」の「jbsrmumap」を参照してください。

6.1.8　ユーザー管理に関する注意事項

ここでは，ユーザー管理を設定する場合の注意事項について説明します。

JP1/BaseのGUI，［JP1/Base環境設定］ダイアログボックスで，認証サーバの設定やJP1ユーザーの登録をする際に，JP1/Baseのサービスを起動および停止することがありますが，次のような場合には，JP1/Baseのサービスの起動や停止に失敗することがあります。

Windowsの［サービス］ダイアログボックスで［スタートアップ］が「自動」になっているすべてのサービスが起動を完了していない場合

JP1/Base，JP1/IM，またはJP1/AJSのサービスが起動処理中，または停止処理中の場合

JP1/Base，JP1/IM，またはJP1/AJSのサービスが起動，または停止できない状態の場合

JP1/Baseのサービスの起動や停止に失敗した場合，［JP1/Base環境設定］ダイアログボックスを一度閉じ，エラーダイアログボックスに表示されたサービスが［コントロールパネル］の［サービス］ダイアログボックスから起動および停止できることを確認してください。サービスを起動および停止できる場合は，再度［JP1/Base環境設定］ダイアログボックスを表示し，設定してください。サービスを起動および停止できなかった場合は，該当するサービスの資料を，資料採取ツールを使って採取し，システム管理者に連絡してください。

ユーザーマッピングの設定をしたあと，OSが管理するパスワード情報を変更した場合，JP1/Baseのユーザーマッピングで設定したOSユーザーのパスワード管理情報も，合わせて変更する必要があります。変更しなかった場合，JP1/AJSのジョブ実行やJP1/IM - Managerのリモートコマンド（自動アクション）実行が失敗するおそれがあります。
なお，JP1/Baseのパスワード管理情報を変更したい場合は，jbsumappassコマンドやjbsrmumappassコマンドを御利用ください。

クラスタシステムでユーザー管理の設定をする場合は，まず，「3.　クラスタシステムで運用する場合の設定」を参照してクラスタ運用の環境設定をしてください。そのあと，次に示す手順を実行してください。

Windowsのスタートメニューから［プログラム］－［JP1_Base］－［環境設定］を選択する。

［論理ホスト名の選択］ダイアログボックスでユーザー管理の設定をしたい論理ホストを選択する。

「6.1　ユーザー管理の設定（Windowsの場合）」を参照してユーザー管理の設定をする。

認証サーバをクラスタシステムで運用する場合，認証サーバの設定ファイルは次のフォルダに格納されています。
共有フォルダ名¥jp1base¥conf¥user_acl¥
セカンダリー認証サーバを設置する場合は，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバへコピーする必要があります。その際，セカンダリー認証サーバをクラスタ運用するかしないかで，設定ファイルのコピー先が異なってくるので注意が必要です。

クラスタ運用する場合のコピー先

共有フォルダ名¥jp1base¥conf¥user_acl¥

クラスタ運用しない場合のコピー先

インストール先フォルダ¥conf¥user_acl¥

設定ファイルをコピーしたあとに，次のコマンドを実行して設定を反映させてください。セカンダリー認証サーバをクラスタ運用しない場合は，-hオプションの指定は不要です。
jbs_spmd_reload -h 論理ホスト名

6.2　ディレクトリサーバと連携してログイン認証をする場合の設定（Windowsの場合）

ディレクトリサーバと連携してログイン認証をする場合，JP1管理者，ディレクトリサーバ管理者それぞれで設定作業が発生します。発生する設定作業を次に示します。

JP1管理者の設定作業

認証サーバでのディレクトリサーバ連携用の設定

ディレクトリサーバの指定

JP1ユーザー（連携ユーザー）の設定

ディレクトリサーバ管理者の設定作業

ディレクトリサーバへのJP1ユーザー（連携ユーザー）の登録

この節では，JP1管理者の設定作業について説明します。

ディレクトリサーバと連携してログイン認証をする場合の，各ホストで必要な設定の流れとマニュアルの参照先を次の図に示します。

図6-10　ユーザー管理の設定の流れ（ディレクトリサーバと連携する場合）

次の項以降では，ディレクトリサーバと連携する場合だけに発生する設定について説明します。そのほかの設定については，図6-10で示す参照先を確認してください。設定内容は認証サーバだけで運用する場合と同じです。

ディレクトリサーバと連携する場合の注意事項

ディレクトリサーバ連携機能を有効にしている場合でも，標準ユーザーは認証サーバでログインできます。

ディレクトリサーバ管理者がディレクトリサーバを設定する際は，同じコンテナオブジェクトにJP1ユーザーを登録してください。なお，ディレクトリサーバと連携する場合は，ディレクトリサーバのユーザーのCN（共通名）がJP1ユーザー名と同じであることが必要です。ディレクトリサーバの構成例は，「14.　定義ファイル」の「ディレクトリサーバ連携定義ファイル（Windows限定）」の定義例を参照してください。

SSLを使用する場合，次に示すことを確認してください。
ディレクトリサーバ側

証明書サービスがインストールされているかどうか。

認証サーバ側

ディレクトリサーバでエクスポートした証明書がインストールされているかどうか。

＜この節の構成＞

6.2.1　連携するディレクトリサーバを指定する

6.2.2　JP1ユーザー（連携ユーザー）を設定する

6.2.1　連携するディレクトリサーバを指定する

ディレクトリサーバと連携してログイン認証をするためには，認証サーバで共通定義情報を設定する必要があります。ディレクトリサーバ連携機能はデフォルトで無効に設定されているため，設定の変更が必要です。セカンダリー認証サーバを設置している場合は，プライマリー認証サーバおよびセカンダリー認証サーバの両方に設定してください。

＜この項の構成＞

(1)　ディレクトリサーバの設定手順

(2)　連携するディレクトリサーバを変更する

(1)　ディレクトリサーバの設定手順

ディレクトリサーバの設定を変更する手順を次に示します。

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）を編集する。
ディレクトリサーバ連携定義ファイルの詳細については，「14.　定義ファイル」の「ディレクトリサーバ連携定義ファイル（Windows限定）」を参照してください。

jbssetcnfコマンドを実行する。
設定内容が共通定義情報に反映されます。

jbschkdsコマンドを実行する。
ディレクトリサーバ連携の設定を確認できます。jbschkdsコマンドで確認できる内容を次に示します。

ディレクトリサーバ連携機能が有効かどうか

連携するディレクトリサーバ名

ディレクトリサーバの接続先ポート番号

SSLを使用するかどうか

識別名

ディレクトリサーバに接続できたかどうか

ユーザー認証できたかどうか

jbschkdsコマンドの詳細については，「13.　コマンド」の「jbschkds（Windows限定）」を参照してください。

(2)　連携するディレクトリサーバを変更する

設定したディレクトリサーバが障害などで使用できなくなった場合，連携するディレクトリサーバを一時的に変更できます。一時的に変更するための情報を定義した定義ファイル作成してjbschgdsコマンドを実行してください。また，一時的な変更の解除も，jbschgdsコマンドを使用します。

jbschgdsコマンドの詳細については，「13.　コマンド」の「jbschgds（Windows限定）」を参照してください。

6.2.2　JP1ユーザー（連携ユーザー）を設定する

ディレクトリサーバでログイン認証をするJP1ユーザー（連携ユーザー）の設定について説明します。JP1ユーザーの設定とは，JP1/IMやJP1/AJSを使用するJP1ユーザーの登録および削除をGUIまたはコマンドで行うことを示します。ここで登録したJP1ユーザーは，JP1/IM - ViewまたはJP1/AJS - Viewからのログイン時に使用します。特に断り書きがない場合，この項では「JP1ユーザー」とは「JP1ユーザー（連携ユーザー）」を示します。

JP1ユーザーは，認証サーバ（プライマリー認証サーバ）に指定したホストにだけ設定します。08-10以前のJP1/Baseは連携ユーザーを設定できません。JP1ユーザーは08-11以降のJP1/Baseで設定してください。

JP1ユーザーを設定する場合，「JP1/Base」サービスが起動している必要があります。「JP1/Base」サービスが起動していないとき，JP1ユーザーを設定する前に「JP1/Base」のサービスを起動してください。

JP1ユーザーの設定手順を，GUIを使う場合とコマンドを使う場合に分けて，次に示します。

＜この項の構成＞

(1)　GUIを使ってJP1ユーザーを設定する

(2)　コマンドを使ってJP1ユーザーを設定する

(3)　連携ユーザーのパスワードについて

(1)　GUIを使ってJP1ユーザーを設定する

JP1ユーザーの設定は，［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブの［JP1ユーザー］で行います。

［JP1ユーザー］で設定する場合，［JP1ユーザー］を活性化する必要があります。［認証サーバの検索順序］の［認証サーバ名］で認証サーバを選び（反転表示させて），［JP1ユーザー］を活性化してください。なお，次に示す場合には，［JP1ユーザー］は活性化しないため，注意が必要です。

［認証サーバの検索順序］で認証サーバを変更し，［適用］ボタンが活性化していた場合

選んだ（反転表示させた）認証サーバの状態が「閉塞中」の場合

［適用］ボタンが活性化していた場合は，［適用］ボタンをクリックしてください。「閉塞中」だった場合は，「6.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）」を参照して，閉塞状態を解除してください。

［追加］ボタンをクリックすると，［JP1ユーザー］ダイアログボックスが表示されます。

図6-11　［JP1ユーザー］ダイアログボックス

このダイアログボックスでJP1ユーザーを設定します。登録するJP1ユーザー名を入力し，［ディレクトリサーバに連携する］をチェックしてください。パスワードの入力は必要ありません。なお，登録するJP1ユーザー名は標準ユーザーと重複しないようにしてください。JP1ユーザー名に使用できるのは，小文字だけです。大文字で入力した場合でも小文字のJP1ユーザー名として登録します。

JP1ユーザー名に指定できる文字の制限を次の表に示します。

表6-4　JP1ユーザー名の文字制限

対象 | バイト数 | 使用禁止文字
JP1ユーザー名 | 1～31バイト | * / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < > およびスペース，タブ

［OK］ボタンまたは［キャンセル］ボタンをクリックすると，［認証サーバ］タブに戻ります。

登録されたJP1ユーザーは［ユーザー名］に表示されます。連携ユーザーの場合，［連携］に「DS」と表示されます。

また，［ユーザー名］に表示されたJP1ユーザーを選択し，［削除］ボタンをクリックすると，選択したJP1ユーザーが削除されます。

(2)　コマンドを使ってJP1ユーザーを設定する

コマンドを使って，JP1ユーザーの登録および削除ができます。また，登録したJP1ユーザーを一覧表示するコマンドも提供しています。各コマンドの詳細については，「13.　コマンド」を参照してください。

JP1ユーザーの登録

JP1ユーザーを認証サーバに登録する場合，次に示すコマンドを実行します。

jbsadduser -ds JP1ユーザー名

JP1ユーザー名には，小文字だけを使用してください。JP1ユーザー名に指定できる文字の制限については，表6-4を参照してください。

JP1ユーザーのパスワードの変更

連携ユーザーのパスワードはJP1/Baseで変更できません。ディレクトリサーバで変更してください。

JP1ユーザーの削除

登録したJP1ユーザーを削除する場合は，次に示すコマンドを実行します。

jbsrmuser JP1ユーザー名

登録したJP1ユーザーの一覧表示

登録したJP1ユーザー（標準ユーザーおよび連携ユーザー）の情報を確認する場合は，次に示すコマンドを実行します。

jbslistuser

登録した連携ユーザーだけの情報を確認する場合は，次に示すコマンドを実行します。

jbslistuser -ds

(3)　連携ユーザーのパスワードについて

連携ユーザーのパスワードはディレクトリサーバで管理しますが，パスワードに指定できる文字の制限は標準ユーザーと同じです。大文字と小文字を区別して指定してください。パスワードの文字制限を次に示します。

バイト数：6～32バイト

使用禁止文字：¥ " : およびスペース，タブ

ディレクトリサーバに登録したパスワードのバイト数が制限値から外れていた場合，または使用禁止文字があった場合，ユーザー認証に失敗します。

6.3　ユーザー管理の設定（UNIXの場合）

UNIXで，ユーザー管理を使用する場合の設定方法について説明します。なお，JP1/Baseのインストール時に自動セットアップ処理を実行した場合は，デフォルト値が設定されています。自動セットアップ処理のデフォルト値については，「2.3.1　インストール」を参照してください。

設定方法は，認証サーバとして使用するホストと認証サーバとして使用しないホストで異なります。

また，セカンダリー認証サーバを設置する場合，プライマリー認証サーバとセカンダリー認証サーバで設定する情報を同じにする必要があります。各ホストで必要な設定の流れとマニュアルの参照先を次の図に示します。

図6-12　ユーザー管理の設定の流れ（UNIXの場合）

＜この節の構成＞

6.3.1　使用する認証サーバを指定する

6.3.2　JP1ユーザーを設定する

6.3.3　JP1ユーザーの操作権限を設定する

6.3.4　プライマリー認証サーバの設定情報をコピーする

6.3.5　ユーザーマッピングを設定する

6.3.6　ユーザー管理に関する注意事項

6.3.1　使用する認証サーバを指定する

認証サーバにするJP1/Baseがインストールされているホストを指定します。認証サーバは，次に示すホスト上で指定する必要があります。

認証サーバ（プライマリー認証サーバおよびセカンダリー認証サーバ）

JP1/IM - Manager，JP1/AJS - Manageがインストールされたホスト

認証サーバに指定したホストが，JP1ユーザーや，JP1資源グループに対する操作権限を管理します。JP1/IMおよびJP1/AJSの混在するシステムで，ユーザー認証圏を一つだけにしたい場合は，各ホストで同じ認証サーバを指定します。

＜この項の構成＞

(1)　認証サーバを指定する

(2)　指定した認証サーバを確認する

(3)　自ホストの認証サーバを起動しないようにする

(1)　認証サーバを指定する

認証サーバを指定する場合，次に示すコマンドを実行します。

jbssetusrsrv プライマリー認証サーバ [セカンダリー認証サーバ]

jbssetusrsrvコマンドの詳細については，「13.　コマンド」の「jbssetusrsrv（UNIX限定）」を参照してください。

注意事項

認証サーバ（プライマリー認証サーバおよびセカンダリー認証サーバ）として指定するホスト名は，JP1/Baseを起動する前にhostsファイル，またはDNSサーバに設定してください。認証サーバの指定（jbssetusrsrvコマンドの実行），hostsファイル，またはDNSサーバへの設定順序は任意ですが，JP1/Baseの起動時にはホスト名からIPアドレスを解決できる状態になっている必要があります。

プライマリー認証サーバおよびセカンダリー認証サーバには，ホスト名を指定してください。IPアドレスは認証サーバ名に指定できません。

(2)　指定した認証サーバを確認する

認証サーバを確認したい場合は，次に示すコマンドを実行してください。

jbslistsrv [-h 論理ホスト名]

jbslistsrvコマンドの詳細については，「13.　コマンド」の「jbslistsrv」を参照してください。

(3)　自ホストの認証サーバを起動しないようにする

JP1/Baseの新規インストール時には，自動で認証サーバに自ホストが設定され，認証サーバが起動するようになっています。認証サーバの指定を自ホストから他ホストに変更した場合でも，自ホストの認証サーバのプロセスは起動したままです。認証サーバに自ホストを指定しない場合で，認証サーバを停止したいときの設定手順を次に示します。

認証サーバを停止して影響がないか確認する。

次のコマンドを実行する。

cd /etc/opt/jp1base/conf
cp -p jp1bs_spmd.conf.model jp1bs_spmd.conf

JP1/Baseを再起動する。

認証サーバを停止したあとに，再度自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定する場合は，次の操作で認証サーバを起動してください。

次のコマンドを実行する。

cd /etc/opt/jp1base/conf
cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

JP1/Baseを再起動する。

6.3.2　JP1ユーザーを設定する

認証サーバでログイン認証をするJP1ユーザー（標準ユーザー）の設定について説明します。JP1ユーザーは，認証サーバ（プライマリー認証サーバ）に指定したホストでだけ設定します。

JP1/Baseで提供するコマンドを実行すると，JP1ユーザーの登録，削除およびJP1ユーザーのパスワードの変更ができます。また，登録したJP1ユーザーを一覧表示するコマンドも提供しています。各コマンドの詳細については，「13.　コマンド」を参照してください。

＜この項の構成＞

(1)　JP1ユーザーを登録する

(2)　JP1ユーザーのパスワードを変更する

(3)　JP1ユーザーの削除

(4)　JP1ユーザーの一覧表示

(1)　JP1ユーザーを登録する

JP1ユーザーを認証サーバに登録する場合，次に示すコマンドを実行します。

jbsadduser JP1ユーザー名

JP1ユーザー名には，小文字だけを使用してください。コマンド実行後にパスワードの入力を促されます。大文字と小文字を区別して入力してください。JP1ユーザー名およびパスワードに指定できる文字の制限を次の表に示します。

表6-5　JP1ユーザー名およびパスワードの文字制限

対象 | バイト数 | 使用禁止文字
JP1ユーザー名 | 1～31バイト | * / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < > およびスペース，タブ
パスワード | 6～32バイト | ¥ " : およびスペース，タブ

(2)　JP1ユーザーのパスワードを変更する

登録したJP1ユーザーのパスワードを変更する場合は，次に示すコマンドを実行します。

jbschgpasswd JP1ユーザー名

(3)　JP1ユーザーの削除

登録したJP1ユーザーを削除する場合は，次に示すコマンドを実行します。

jbsrmuser JP1ユーザー名

(4)　JP1ユーザーの一覧表示

登録したJP1ユーザーの情報を確認する場合は，次に示すコマンドを実行します。

jbslistuser

6.3.3　JP1ユーザーの操作権限を設定する

認証サーバ（プライマリー認証サーバ）で必要な設定です。JP1ユーザーが，ジョブやジョブネットなどのJP1資源グループに対して，どのような操作ができるか（JP1権限レベル）を設定します。

注意事項

JP1/AJSで，JP1資源グループ名を指定していないジョブやジョブネットは，操作権限の設定の対象になりません。すべてのJP1ユーザーによるすべてのアクセスが可能になります。

JP1ユーザーの操作権限を設定する方法は，一括して設定する方法と，個別に登録，削除する方法があります。

JP1ユーザーの操作権限の設定について次に説明します。

＜この項の構成＞

(1)　JP1ユーザーの操作権限を一括して設定する

(2)　JP1ユーザーの操作権限を個別に登録する

(3)　JP1ユーザーの操作権限を個別に削除する

(1)　JP1ユーザーの操作権限を一括して設定する

コマンドを使ってJP1ユーザーの操作権限を一括して設定できます。JP1ユーザーの操作権限を一括して登録する場合，ユーザー権限レベルファイル（JP1_UserLevel）に操作権限を定義します。編集後，jbsaclreloadコマンドを実行すると設定が反映されます。jbsaclreloadコマンドの詳細については，「13.　コマンド」の「jbsaclreload」を参照してください。ユーザー権限レベルファイルの詳細については，「14.　定義ファイル」の「ユーザー権限レベルファイル」を参照してください。

(2)　JP1ユーザーの操作権限を個別に登録する

JP1ユーザーの操作権限を個別に追加または変更する場合，登録したいJP1ユーザーの操作権限を記述した定義ファイルを作成する必要があります。

定義ファイルは，ユーザーが任意の場所に格納できます。ファイルの形式は，ユーザー権限レベルファイル（JP1_UserLevel）の形式と同じです。ユーザー権限レベルファイルの詳細については，「14.　定義ファイル」の「ユーザー権限レベルファイル」を参照してください。

定義ファイルを作成したあと，次のコマンドを実行すると，定義ファイルの情報が認証サーバに登録されます。

jbssetacl -f 定義ファイル名

jbssetaclコマンドの詳細については，「13.　コマンド」の「jbssetacl」を参照してください。

(3)　JP1ユーザーの操作権限を個別に削除する

登録したJP1ユーザーの操作権限を個別に削除したい場合は，次のコマンドを実行してください。

jbsrmacl -u JP1ユーザー名

このコマンドを実行すると，指定したJP1ユーザーに設定されている操作権限がすべて削除されるためご注意ください。

jbsrmaclコマンドの詳細については，「13.　コマンド」の「jbsrmacl」を参照してください。

6.3.4　プライマリー認証サーバの設定情報をコピーする

セカンダリー認証サーバを設置する場合，プライマリー認証サーバと同じ設定で運用しなければなりません。そのため，プライマリー認証サーバの設定完了後，プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーする必要があります。プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーするための手順を次に示します。

プライマリー認証サーバで，JP1ユーザーおよび操作権限の設定を完了する。
JP1ユーザーの設定については，「6.3.2　JP1ユーザーを設定する」，JP1ユーザーの操作権限の設定については，「6.3.3　JP1ユーザーの操作権限を設定する」を参照してください。

セカンダリー認証サーバを起動する。
JP1/Baseを起動し，セカンダリー認証サーバを起動してください。認証サーバが起動しているかどうかは，jbs_spmd_statusコマンドで確認できます。コマンド実行後，表示される情報の中にjbssessionmgrがあれば，認証サーバが起動しています。

プライマリー認証サーバの設定ファイルを，FTPなどを使ってコピーする。
プライマリー認証サーバの設定ファイルを，FTPなどを使って，セカンダリー認証サーバにコピーします。コピーする設定ファイルは，JP1_AccessLevel，JP1_Group，JP1_Passwd，JP1_UserLevelです。これらのファイルは以下のディレクトリに格納されています。
/etc/opt/jp1base/conf/user_acl/
コピー先ディレクトリは，自ホスト上の同じディレクトリになります。また，論理ホストの場合は，以下のディレクトリに格納されています。

共有ディレクトリ名/jp1base/conf/user_acl/

コマンドを使って設定を反映させる。
最後に，コピーした設定情報のファイルの内容を反映させます。jbs_spmd_reloadコマンドを実行し，正常終了すれば設定が有効になります。

各コマンドの詳細については，「13.　コマンド」を参照してください。

注意事項

プライマリー認証サーバとセカンダリー認証サーバのJP1/Baseは同じバージョンにしてください。

セカンダリー認証サーバが起動していない場合は，次のコマンドを実行してください。
cd /etc/opt/jp1base/conf
cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf
JP1/Baseを再起動すると，認証サーバが起動します。

設定ファイルはテキストファイルです。異なるプラットフォーム間で転送する場合，文字コードに注意してください。また，FTPで転送する場合は，必ずASCII転送をしてください。

6.3.5　ユーザーマッピングを設定する

コマンドを実行すると，定義ファイルに記述したユーザーマッピング情報を共通定義情報に一括して登録できます。また，ユーザーマッピング情報を個別に追加，変更および削除することもできます。

ユーザーマッピングの設定について次に説明します。

＜この項の構成＞

(1)　ユーザーマッピング情報を一括して設定する

(2)　ユーザーマッピング情報を個別に登録する

(3)　ユーザーマッピング情報を個別に削除する

(1)　ユーザーマッピング情報を一括して設定する

ユーザーマッピング情報を一括して設定する場合は，ユーザーマッピング定義ファイル（jp1BsUmap.conf）で設定します。ユーザーマッピング定義ファイルの詳細については，「14.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。

ユーザーマッピング定義ファイル（jp1BsUmap.conf）をエディターで編集したあと，jbsmkumapコマンドを実行すると，共通定義情報に登録されていたマッピング情報がいったんすべて削除され，ユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報が共通定義情報に登録されます。なお，設定されたマッピング情報を確認する場合は，jbsgetumapコマンドを実行します。

jbsmkumapコマンドおよびjbsgetumapコマンドの詳細については，「13.　コマンド」の「jbsmkumap」および「jbsgetumap」を参照してください。

(2)　ユーザーマッピング情報を個別に登録する

jbssetumapコマンドを実行すると，ユーザーマッピング情報を個別に追加したり変更したりできます。ユーザーマッピング情報を個別に追加または変更するには，jbssetumapコマンドのオプションにユーザーマッピング情報を直接指定して登録する方法と，ユーザーマッピング情報を記述した定義ファイルを使用して登録する方法があります。

ユーザーマッピング情報を指定して共通定義情報に登録する場合は，次のコマンドを実行してください。

jbssetumap {-u JP1ユーザー名 | -ua}
          {-sh サーバホスト名 | -sha}
          {-o OSユーザー名[,OSユーザー名]}
          [-no]

定義ファイルを作成して登録する場合は，次のコマンドを実行してください。

jbssetumap -f 定義ファイル名

定義ファイルは任意の場所に格納できますが，ファイルの形式はユーザーマッピング定義ファイル（jp1BsUmap.conf）と同じにしてください。ユーザーマッピング定義ファイルの形式については，「14.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。jbssetumapコマンドの詳細については，「13.　コマンド」の「jbssetumap」を参照してください。

(3)　ユーザーマッピング情報を個別に削除する

共通定義情報からユーザーマッピング情報を個別に削除する場合，jbsrmumapコマンドを実行してください。

次の形式でコマンドを実行します。

jbsrmumap -u JP1ユーザー名

jbsrmumapコマンドの詳細については，「13.　コマンド」の「jbsrmumap」を参照してください。

6.3.6　ユーザー管理に関する注意事項

ここでは，ユーザー管理を設定する場合の注意事項について説明します。

クラスタシステムでユーザー管理の設定をする場合は，まず，「3.　クラスタシステムで運用する場合の設定」を参照してクラスタ運用の環境設定をしてください。そのあと，「6.3　ユーザー管理の設定（UNIXの場合）」を参照してユーザー管理の設定をしてください。設定をする際，各コマンドで-hオプションに論理ホスト名を指定してください。

認証サーバをクラスタシステムで運用する場合，認証サーバの設定ファイルは次のディレクトリに格納されています。

共有ディレクトリ名/jp1base/conf/user_acl/

セカンダリー認証サーバを設置する場合は，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバへコピーする必要があります。その際，セカンダリー認証サーバをクラスタ運用するかしないかで，設定ファイルのコピー先が異なってくるので注意が必要です。

クラスタ運用する場合のコピー先

共有ディレクトリ名/jp1base/conf/user_acl/

クラスタ運用しない場合のコピー先

/etc/opt/jp1base/conf/user_acl/

設定ファイルをコピーしたあとに，次のコマンドを実行して設定を反映させてください。セカンダリー認証サーバをクラスタ運用しない場合は，-hオプションの指定は不要です。

jbs_spmd_reload -h 論理ホスト名

6.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）

セカンダリー認証サーバを設置した場合，プライマリー認証サーバへの接続に失敗すると，以降，接続先認証サーバをセカンダリー認証サーバに切り替え，プライマリー認証サーバへの接続を閉塞状態にします。この節では，閉塞状態の確認方法，閉塞状態の解除方法，および閉塞状態にする方法について説明します。

注意事項

一つのユーザー認証圏内に認証サーバを1台しか設置しない場合，閉塞状態の設定はできません。一つのユーザー認証圏内に認証サーバを2台設置した場合だけ，閉塞状態の設定ができます。

WindowsではGUIやコマンドを使って，UNIXではコマンドを使って閉塞状態に関する設定を行います。

＜この節の構成＞

6.4.1　GUIを使って設定する（Windows限定）

6.4.2　コマンドを使って設定する

6.4.1　GUIを使って設定する（Windows限定）

ここでは，GUIを使った閉塞状態の設定について説明します。GUIを使って閉塞状態の設定をする場合の操作を次に示します。

Windowsのスタートメニューから［プログラム］－［JP1_Base］－［環境設定］を選択する。
［JP1/Base環境設定］ダイアログボックスが表示されます。

［認証サーバ］タブを選択する。
［認証サーバ］タブの［認証サーバの検索順序］で閉塞状態の設定を行います。

＜この項の構成＞

(1)　閉塞状態を確認する

(2)　閉塞状態を解除する

(3)　閉塞状態にする

(1)　閉塞状態を確認する

［認証サーバの検索順序］で閉塞状態かどうかを確認できます。認証サーバが閉塞状態であれば，［閉塞状態］に「閉塞中」と表示されます。何も表示されていない場合，閉塞状態ではありません。

(2)　閉塞状態を解除する

閉塞状態を解除する手順を次に示します。

［認証サーバの検索順序］の［閉塞状態］で「閉塞中」となっている認証サーバ名を選択する。

［変更］ボタンをクリックする。
［認証サーバ］ダイアログボックスが表示されます。［認証サーバを閉塞状態に設定する］のチェックを外してください。

［OK］ボタンまたは［適用］ボタンをクリックする。
［OK］ボタンをクリックすると，設定内容が反映され，GUIがすべて閉じます。
［適用］ボタンをクリックすると，設定内容が反映され，［認証サーバ］タブに戻ります。

閉塞状態が解除されたことを確認する場合は，［JP1/Base環境設定］ダイアログボックスの［閉塞状態］で確認してください。何も表示されていなければ，閉塞状態が解除されたことになります。

(3)　閉塞状態にする

認証サーバを閉塞状態にする手順を次に示します。

［認証サーバの検索順序］の［閉塞状態］に何も表示されていない認証サーバ名を選択する。

［変更］ボタンをクリックする。
［認証サーバ］ダイアログボックスが表示されます。［認証サーバを閉塞状態に設定する］をチェックしてください。

［OK］ボタンまたは［適用］ボタンをクリックする。
［OK］ボタンをクリックすると，設定内容が反映され，GUIがすべて閉じます。
［適用］ボタンをクリックすると，設定内容が反映され，［認証サーバ］タブに戻ります。

閉塞状態になったことを確認する場合は，［JP1/Base環境設定］ダイアログボックスの［閉塞状態］で確認してください。「閉塞中」と表示があれば閉塞状態になったことになります。

6.4.2　コマンドを使って設定する

ここでは，コマンドを使った閉塞状態の設定について説明します。なお，ここでは，プライマリー認証サーバをserver1，セカンダリー認証サーバをserver2と指定していることを仮定して説明します。

＜この項の構成＞

(1)　閉塞状態を確認する

(2)　閉塞状態を解除する

(3)　閉塞状態にする

(1)　閉塞状態を確認する

認証サーバの閉塞状態を確認する場合は，次に示すコマンドを実行してください。

jbslistsrv

jbslistsrvコマンドの詳細については，「13.　コマンド」の「jbslistsrv」を参照してください。

(2)　閉塞状態を解除する

閉塞を解除する場合，次に示すコマンドを実行してください。

jbsunblockadesrv -s 認証サーバ

jbsunblockadesrvコマンドの詳細については，「13.　コマンド」の「jbsunblockadesrv」を参照してください。

(3)　閉塞状態にする

認証サーバを閉塞状態にする場合は，次に示すコマンドを実行してください。

jbsblockadesrv -s 認証サーバ

jbsblockadesrvコマンドの詳細については，「13.　コマンド」の「jbsblockadesrv」を参照してください。

7.　サービスの起動順序および終了順序の設定（Windows限定）

サービスの起動順序および終了順序を定義できます。この章では，サービスの起動順序および終了順序の設定方法について説明します。

＜この章の構成＞

7.1　サービスの起動順序および終了順序の設定手順

7.2　起動順序定義ファイルを編集する

7.3　サービスが起動するタイミングを設定する

7.4　起動管理機能を使用する場合の注意事項

7.1　サービスの起動順序および終了順序の設定手順

サービスの起動順序および終了順序を設定する場合，次の操作をしてください。

JP1SVPRM.DATという名称で起動順序定義ファイル（JP1SVPRM.DAT）を作成する。
cpysvprmコマンドを実行します。cpysvprmコマンドの詳細については，「13.　コマンド」の「cpysvprm（Windows限定）」を参照してください。
cpysvprmコマンドを実行すると，JP1/Baseのデータフォルダ（インストール先フォルダ¥conf¥boot¥）※¹にJP1SVPRM.DATファイルが作成されます。起動順序定義ファイル（JP1SVPRM.DAT）を変更したり※²，新規に作成したりした場合も，ファイル名はJP1SVPRM.DATとしてください。

必要に応じて，JP1SVPRM.DATファイルをテキストエディターなどで開き，編集する。
JP1SVPRM.DATファイルの編集方法については，「7.2　起動順序定義ファイルを編集する」を参照してください。

JP1SVPRM.DATファイルで設定したサービスの起動方法を「自動」から「手動」に変更する。※³
［コントロールパネル］の［サービス］ダイアログボックスで，該当するサービスの起動方法を変更してください。

サービスが起動するタイミングを設定する。
OSによるサービス起動のタイミングと，JP1/Baseによるサービス起動のタイミングが重なると，マシンに負荷が掛かりサービスの起動に失敗するおそれがあります。サービス起動の競合による起動の失敗を回避するために，JP1/Baseによるサービス起動のタイミングを設定してください。
また，指定した時間内にサービスが正常に起動したかどうかを確認できます。設定の詳細については，「7.3　サービスが起動するタイミングを設定する」を参照してください。

Windowsを再起動する。※⁴

注※1

JP1/Baseのデータフォルダ（インストール先フォルダ¥conf¥boot¥）にJP1SVPRM.DAT.MODELファイルがありますが，このファイルは，直接編集しないでください。

注※2

JP1SVPRM.DATファイルの内容を変更する場合は，変更前のファイルのバックアップをとってから，JP1SVPRM.DATファイルの内容を変更することをお勧めします。

注※3

JP1SVPRM.DATファイルで設定したサービスの起動方法を「自動」から「手動」に変更しないと，JP1SVPRM.DATファイルに記述したとおりにサービスが起動しません。また，JP1SVPRM.DATファイルに記述したとおりに起動しなかったサービスは，終了順序をJP1SVPRM.DATファイルで設定していても対象になりません。

注※4

起動管理の使用をやめる場合は，cpysvprm -dを実行します。実行すると，JP1SVPRM.DATファイルが削除されます。また，再度同じJP1SVPRM.DATファイルを登録する必要がある場合は，削除する前にJP1SVPRM.DATファイルのバックアップをとることをお勧めします。

7.2　起動順序定義ファイルを編集する

起動順序定義ファイル（JP1SVPRM.DAT）には，起動順序および終了順序を管理したいサービスの情報を記述します。サービスの起動順序の制御と終了順序の制御について，次に説明します。

＜この節の構成＞

7.2.1　サービスの起動順序の制御

7.2.2　サービスの終了順序の制御

7.2.1　サービスの起動順序の制御

起動順序定義ファイル（JP1SVPRM.DAT）で起動順序を設定する場合，次の形式で設定します。

JP1製品の前に起動させるJP1以外のサービス
起動順序定義ファイル（JP1SVPRM.DAT）の[FrontOtherServiceXXX]（XXXは，サービスごとに異なる任意の文字列）セクションに記述します。

JP1製品のサービス
起動順序定義ファイル（JP1SVPRM.DAT）の[Jp1XXX]（XXXは，サービスごとに割り当てられた文字列）セクションに記述します。

JP1製品のあとに起動させるJP1以外のサービス
起動順序定義ファイル（JP1SVPRM.DAT）の[OtherServiceXXX]（XXXは，サービスごとに異なる任意の文字列）セクションに記述します。

セクションとは，サービスごとの処理方法，および起動管理機能（JP1/Base Control Service）としての処理方法を明確にするための単位です。

起動順序定義ファイル（JP1SVPRM.DAT）に記述したサービスの起動については，次の制御もできます。

直前のサービスの開始処理が完了してから次のサービスの開始処理を始める。

直前のサービスの開始処理が完了しないうちに次のサービスの開始処理を始める。

定義ファイルの詳細については，「14.　定義ファイル」の「起動順序定義ファイル（Windows限定）」を参照してください。

システム起動時のサービスの起動順序を次の図に示します。

図7-1　起動管理を使用した場合のサービスの起動順序

なお，システム管理者は，サービスの起動が正しく完了したかどうか，次に示す二つのメッセージで確認してください。

メッセージID「KAVA4014-I」のメッセージ※

メッセージID「KAVA4036-I」のメッセージ
注※　起動順序定義ファイル（JP1SVPRM.DAT）で定義したすべてのサービスに関して出力されているか確認してください。

7.2.2　サービスの終了順序の制御

終了順序を制御する場合は，同じマシンにJP1/Power Monitorが必要です。終了順序を制御したいサービスには，起動順序定義ファイル（JP1SVPRM.DAT）で終了コマンドを指定しておきます。終了コマンドが記述されたサービスは，起動時と逆の順序で終了します。なお，サービスの終了が，複数のコマンドを組み合わせて実行されている場合には，一つのバッチファイルに記述してから指定してください。

起動順序定義ファイル（JP1SVPRM.DAT）に記述したサービスの終了については，次の制御ができます。

直前のサービスの終了処理が完了してから次のサービスの終了処理を始める。

システム終了時のサービスの終了順序を次の図に示します。

図7-2　起動管理を使用した場合のサービスの終了順序

JP1/Power Monitorからの計画終了時には，起動順序定義ファイル（JP1SVPRM.DAT）に定義したとおりに，必ずサービスの終了処理が実行されます。この場合，終了処理の対象になるのは，起動管理機能（JP1/Base Control Service）で起動したサービスだけで，終了処理開始時にすでに終了していたサービス，および起動管理機能（JP1/Base Control Service）を使って起動できなかったサービスは，終了処理の対象になりません。また，JP1/Power Monitorからの強制終了時にサービスの終了順序を管理したい場合は，起動順序定義ファイル（JP1SVPRM.DAT）の[ControlValue]セクションで指定が必要になります。

なお，システム管理者は，サービスの終了が正しく完了したかどうか，次に示す二つのメッセージで確認してください。

メッセージID「KAVA4023-I」のメッセージ※

メッセージID「KAVA4035-I」のメッセージ
注※　起動順序定義ファイル（JP1SVPRM.DAT）で定義したすべてのサービスに関して出力されているか確認してください。

各サービスについて，起動コマンド，終了コマンド，起動時の待ち時間，および終了時の待ち時間を指定できます。なお，起動コマンドおよび終了コマンドに対してサービスのスタートアップパラメーターは指定できません。

7.3　サービスが起動するタイミングを設定する

起動順序定義ファイル（JP1SVPRM.DAT）に指定したサービスが起動するタイミングを，指定した時間待機させられます。これによって，OSによるサービス起動との競合による起動の失敗を回避できます。

また，指定した時間内にサービスが正常に起動したかどうかを確認できます。指定した時間内に正常に起動しなかった場合は，Windowsのイベントログおよび統合トレースログにメッセージKAVA4107-Wが出力されます。このメッセージが出力されている場合は，起動していないサービスがないか確認し，該当するサービスを手動で起動してください。

設定する手順について説明します。

サービス起動遅延時間／タイマー監視時間定義ファイル（Jp1svprm_wait.dat）を編集する。
サービス起動遅延時間／タイマー監視時間定義ファイルのサンプル（Jp1svprm_wait.dat.sample）をJp1svprm_wait.datのファイル名でコピーして編集してください。
サービス起動遅延時間／タイマー監視時間定義ファイルの詳細については，「14.　定義ファイル」の「サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）」を参照してください。

定義を反映する。
OSを再起動してください。
または，起動順序定義ファイル（JP1SVPRM.DAT）に指定しているすべてのサービスを停止したあと，JP1/Base Control Serviceサービスを再起動してください。

設定を無効にする手順について説明します。

サービス起動遅延時間／タイマー監視時間定義ファイル（Jp1svprm_wait.dat）を削除するか，ファイル名を別の名称に変更する。

設定を無効にする。
OSを再起動してください。
または，起動順序定義ファイル（JP1SVPRM.DAT）に指定しているすべてのサービスを停止したあと，JP1/Base Control Serviceサービスを再起動してください。

7.4　起動管理機能を使用する場合の注意事項

起動管理機能を使用する場合の注意事項を次に示します。

Windowsの起動中に，［コントロールパネル］のサービスに対して操作をしないでください。サービスの起動が正しく実行されないことがあります。

起動順序定義ファイル（JP1SVPRM.DAT）内に定義されているサービスに対しては，［コントロールパネル］の［サービス］ダイアログボックス上で操作しないでください。KAVA4003-Eメッセージが出力され，正常に動作しなくなる場合があります。

論理ホスト上で動作するサービスに対しては，起動を制御できません。物理ホスト上のサービスに対してだけ利用できます。論理ホスト上のサービスの起動管理には，クラスタソフトを利用してください。

8.　イベントサービス環境の設定

この章では，JP1/Baseのイベントサービスを使うための設定方法について説明します。

＜この章の構成＞

8.1　イベントサービス環境の設定手順

8.2　イベントDBの初期化

8.3　イベントDBの内容をcsvファイルに出力する

8.4　イベントサービスの注意事項

8.1　イベントサービス環境の設定手順

イベントサービス環境の設定では，次の二つの設定を行います。

イベントサービスの動作環境の設定

JP1イベントの転送設定

デフォルトでは次のように設定されています。

自ホストでイベントサーバを動作させる。

イベントDBを作成する。
イベントDBをデフォルトで作成する場所を次に示します。
Windowsの場合：インストール先フォルダ¥sys¥event¥servers¥
UNIXの場合：/var/opt/jp1base/sys/event/servers/
なお，イベントDBの上限サイズは，デフォルトで10,000,000バイトとなっています。

JP1イベントをすべて取得する。

JP1イベントを上位サーバに転送する。※

注※　上位サーバとは，JP1/IMの構成定義ファイルで設定したサーバです。また，転送されるJP1イベントは，拡張属性「SEVERITY」の値が「Warning」「Error」「Critical」「Alert」「Emergency」のどれかと一致するJP1イベントとなっています。JP1/IMの構成定義ファイルで上位サーバを設定しなかった場合，JP1イベントは転送されません。構成定義ファイルで設定したサーバ以外の他ホストにJP1イベントを転送したい場合は，デフォルトの設定を変更してください。

次に，イベントサービス環境を設定する手順について説明します。

＜この節の構成＞

8.1.1　転送するJP1イベントの検討

8.1.2　イベントサービス環境を設定する

8.1.3　DNSを使ったシステムでのイベントサーバの設定

8.1.1　転送するJP1イベントの検討

まず，どのようなJP1イベントを転送するか検討します。検討する際には，次の点について考慮してください。

システムの障害監視を目的とする場合は，重要なJP1イベントだけを転送する
デフォルトでは，重要なJP1イベントだけをJP1/IM - Managerで定義されたシステム構成に従って上位のサーバへ転送する設定になっています。システムの障害監視を目的とする場合は，デフォルトの設定を推奨します。デフォルトの設定を変更する場合でも，運用に不要なJP1イベントは上位ホストに転送しないようにしてください。

デフォルトで転送されるJP1イベントを考慮する
ホストの起動通知イベント（00004724）および停止通知イベント（00004725）は，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されるJP1イベントです。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

転送するJP1イベントの単一時間当たりの件数を考慮する
転送するJP1イベントが多いと，転送処理に遅延が発生するおそれがあります。
転送するJP1イベント数が短い時間内に集中して発生しないように，また，短い時間内に集中して発生しても，それが長時間にわたって発生しないようにしてください。例えば，重大度が「警告」以上のJP1イベントだけ転送する，というように転送設定ファイル（forward）でイベントフィルターを指定してください。

上位ホスト（マネージャー，またはサブマネージャー）に集まるJP1イベントの総数を考慮する
上位ホストに転送されてくるJP1イベントが多いと，イベントDBにJP1イベントを登録する処理に遅延が発生するおそれがあります。
マネージャーホストが管理するホスト数と各ホストから転送されてくるJP1イベント数，そして自ホスト上で発生するJP1イベント数について検討してください。例えば，エージェントからサブマネージャーへ転送するJP1イベントは，重大度が「警告」以上，サブマネージャーからマネージャーへ転送するJP1イベントは，重大度が「エラー」以上，というように各ホストの転送設定ファイル（forward）でイベントフィルターを指定してください。

ネットワーク上を流れるデータ量を考慮する
JP1イベント1件当たりの転送データ量の見積もり式を次に示します。
60※1 + 600※2（単位：バイト）

注※1　イベントサーバ設定ファイル（conf）のremote-serverパラメーターに指定した接続先イベントサーバ名が16バイトで，通信タイプがcloseのとき，イベント転送1件ごとに発生します。また，通信タイプがkeep-aliveのときは，最初の1件目だけ発生します。

注※2　ログファイルトラップで約100バイトの文字列をトラップして発生したJP1イベントの場合です。

8.1.2　イベントサービス環境を設定する

イベントサービス環境の設定，変更および設定内容の確認方法について説明します。

＜この項の構成＞

(1)　設定する

(2)　イベントサービスの動作環境を変更する

(3)　JP1イベントの転送設定を変更する

(4)　イベントサービスの動作状況を確認する

(5)　JP1イベントの転送設定の設定内容を確認する

(1)　設定する

イベントサービス環境の設定手順を次に示します。

イベントサービスの動作環境を設定する。
イベントサービスの動作環境は，次に示すファイルで設定します。

イベントサーバインデックスファイル（index）
イベントサーバが使用するディレクトリを指定するファイルです。

イベントサーバ設定ファイル（conf）
イベントサービスの各種動作環境を指定するファイルです。

API設定ファイル（api）
アプリケーションプログラムからイベントサーバへの接続方法や使用するポートを指定するファイルです。

各定義ファイルの詳細については，「14.　定義ファイル」の「イベントサーバインデックスファイル」，「イベントサーバ設定ファイル」，「API設定ファイル」を参照してください。

JP1イベントの転送設定をする。
転送設定ファイル（forward）で，どのイベントサーバへどのようなJP1イベントを転送するか設定します。デフォルトでは，重要なJP1イベントだけをJP1/IM - Managerで定義されたシステム構成に従って上位のサーバへ転送する設定になっています。システムの障害監視を目的とする場合は，デフォルトの設定を推奨します。
転送設定ファイルの詳細については，「14.　定義ファイル」の「転送設定ファイル」を参照してください。

設定を有効にする。
イベントサービスを起動すると，設定が有効になります。

Windowsの場合

システム起動時にイベントサービスが自動起動するようにデフォルトで設定されています。起動管理については，「7.　サービスの起動順序および終了順序の設定（Windows限定）」を参照してください。

UNIXの場合

jevstartコマンドを実行します。

(2)　イベントサービスの動作環境を変更する

イベントサービスの動作環境を変更する手順を次に示します。

各設定ファイルを編集する。
イベントサーバインデックスファイル（index），イベントサーバ設定ファイル（conf），またはAPI設定ファイル（api）を編集します。

各設定ファイルの変更内容を有効にする。
イベントサービスを再起動すると，変更内容が有効になります。

Windowsの場合

［コントロールパネル］の［サービス］ダイアログボックスで，「JP1/Base Event」の名称のサービスを終了したあと，再起動してください。

UNIXの場合

jevstopコマンドでイベントサービスを終了したあと，jevstartコマンドで再起動してください。

上書きインストールした場合の注意事項

09-00では，イベントサーバ設定ファイル（conf）のoptionsパラメーターにsave-repフラグが追加されました。このフラグを設定すると，イベントDBの重複防止テーブルをファイル上に保持します。設定しない場合は，重複防止テーブルをメモリー上に保持します。そのため，イベントサーバの再起動時に，重複防止テーブルが破棄されたあとで再構築され，他ホストから転送されたJP1イベントの受信に時間が掛かります。他ホストから転送されたJP1イベントを受信するイベントサーバでは，save-repフラグを設定することを推奨します。

なお，08-50以前のバージョンから上書きインストールした場合は，このフラグが設定されていないため，次の手順で重複防止テーブルをファイル上に構築してください。

イベントサーバ設定ファイルのoptionsパラメーターにsave-repフラグを追加する。
イベントサーバ設定ファイルについては，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

jevdbmkrepコマンドを実行する。
jevdbmkrepコマンドについては，「13.　コマンド」の「jevdbmkrep」を参照してください。

イベントサーバを起動する。

(3)　JP1イベントの転送設定を変更する

JP1イベントの転送設定を変更する手順を次に示します。

転送設定ファイル（forward）を編集する。

転送設定ファイル（forward）の変更内容を有効にする。
転送設定ファイル（forward）をリロードするか，イベントサービスを再起動すると，変更内容が有効になります。

転送設定ファイル（forward）をリロードする
システムの運用中に設定を有効にできます。次のコマンドを実行してください。
jevreload

イベントサービスを再起動する
Windowsの場合：［コントロールパネル］の［サービス］ダイアログボックスで，「JP1/Base Event」の名称のサービスを終了したあと，再起動してください。
UNIXの場合：jevstopコマンドでイベントサービスを終了したあと，jevstartコマンドで再起動してください。

(a)　マネージャーホストから定義情報を収集・配布する

転送設定ファイル（forward）の情報は，JP1/IM - Managerのシステム構成で定義された上位ホストから下位ホストに一括して配布できます。配布に成功した時点で各ホストの転送設定がリロードされ，更新された情報を基にイベント転送が開始されます。

定義収集・配布の詳細については，「10.　イベントサービスの定義情報の収集と配布（JP1/IM限定）」を参照してください。

(b)　転送設定ファイル（forward）のリロード時の注意事項

転送設定ファイル（forward）のリロード時にJP1イベントが転送中だった場合，その転送は中断され，転送に失敗したと見なされます。このため，リロード後に転送に失敗したJP1イベントから転送を再開するように，イベントサーバ設定ファイル（conf）のforward-limitパラメーターでリトライ時間を設定しておく必要があります。

(c)　JP1/IM - Manager使用時の転送設定ファイルのリロードについて

転送設定ファイル（forward）の転送設定ブロックにto-upper形式を指定している場合は，JP1/IM - Managerのシステム構成に従ってJP1イベントを転送します。JP1/IM - Managerのシステム構成が変更になった場合でも，JP1/IM - Managerでシステム構成を定義するjbsrt_distribコマンド実行時に，転送設定ファイル（forward）もリロードされます。そのため，JP1/IM - Managerのシステム構成が変更になっても，各ホスト上でjevreloadコマンドを実行する必要はありません。

jbsrt_distribコマンドの詳細については，マニュアル「JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス」を参照してください。

注意事項

06-00のJP1/Baseがインストールされたホストと06-51以降のJP1/Baseがインストールされたホストが混在する環境の場合，jbsrt_distribコマンドを実行すると，構成定義情報は配布されますが，06-00のJP1/Baseがインストールされたホストでは転送設定ファイル（forward）はリロードされません。

06-00のJP1/Baseがインストールされたホストでは，イベントサービスを再起動する必要があります。

(4)　イベントサービスの動作状況を確認する

イベントサービスが稼働しているかどうかを確認したい場合は，次のコマンドを実行してください。戻り値が0の場合は，イベントサービスが稼働しています。

jevstat

jevstatコマンドの詳細については，「13.　コマンド」の「jevstat」を参照してください。

(5)　JP1イベントの転送設定の設定内容を確認する

稼働しているイベントサービスでイベント転送の設定内容を確認したい場合は，次のコマンドを実行してください。画面に転送設定ファイル（forward）の形式で出力されます。

jbsgetopinfo -o forward

jbsgetopinfoコマンドの詳細については，「13.　コマンド」の「jbsgetopinfo」を参照してください。

8.1.3　DNSを使ったシステムでのイベントサーバの設定

複数のドメインで構成されたシステムで，デフォルトのイベントサーバを利用すると，さまざまな問題が発生するおそれがあります。ここでは，DNSを使ったシステムでのイベントサーバの設定方法について，一例を挙げて説明します。なお，DNSが自ホスト名としてFQDN名を返すことを前提とします。

d1.hitachi.co.jpとd2.hitachi.co.jpの二つのドメインで構成されたシステムを次の図に示します。

図8-1　二つのドメインで構成されたシステム例

hostX.d1.hitachi.co.jpで発生した「ディスク容量不足」というJP1イベントがhost3.d2.hitachi.co.jpに転送され，JP1/IM - View上にこのJP1イベントが表示された場合，「登録ホスト名」は「hostX」と表示されます。上記図の場合では，d2.hitachi.co.jpにもhostXが存在するため，システム管理者はhostX.d1.hitachi.co.jpとhostX.d2.hitachi.co.jpのどちらで発生したJP1イベントなのかを区別できません。また，JP1/IM - Viewは，受信したJP1イベントに関連するプログラムのモニター画面を表示する機能を持ちますが，ドメインd2.hitachi.co.jpに所属するホストの場合，「hostX」を「hostX.d2.hitachi.co.jp」と解釈するため，これらの機能が誤動作することがあります。

このような問題を避けるために，複数のドメインで構成されたシステムでは，デフォルトのイベントサーバの代わりに，FQDN形式のイベントサーバ名を持つイベントサーバ（FQDN形式のイベントサーバ）に設定を変更してください。

注意事項

FQDN形式のイベントサーバを利用する場合，設定によっては，「付録J　JP1/SESイベントを使用する製品との連携」で説明しているJP1/SES互換機能やイベントサービスの定義情報の収集と配布を利用できなくなります。JP1/SES互換機能やイベントサービスの定義情報の収集と配布を利用する場合は，注意してください。

次に，FQDN形式のイベントサーバの設定手順について説明します。設定手順は，Windowsの場合とUNIXの場合で異なります。それぞれの場合の，FQDN形式のイベントサーバの設定手順を次に示します。

＜この項の構成＞

(1)　FQDN形式のイベントサーバを設定する（Windowsの場合）

(2)　FQDN形式のイベントサーバを設定する（UNIXの場合）

(1)　FQDN形式のイベントサーバを設定する（Windowsの場合）

Windowsで，FQDN形式のイベントサーバを設定する場合の設定手順を次に示します。なお，ここでは，イベントサーバとしてhostX.d1.hitachi.co.jpを指定すると仮定して説明しています。

jevregsvcコマンドを使って，FQDN形式のイベントサーバをサービスに登録する。
jevregsvcコマンドの形式は，次のようになります。

jevregsvc -r hostX.d1.hitachi.co.jp

注意事項

JP1/IM - ManagerまたはJP1/AJSをインストールしている場合，デフォルトのサービスと依存関係があります。Windowsで，FQDN形式のイベントサーバを設定するときは，JP1/IM - ManagerおよびJP1/AJSとデフォルトのイベントサービスの依存関係を解除してください。

イベントサーバインデックスファイル（index）をエディターで開き，serverパラメーターのイベントサーバ名をデフォルトの「*」から「@」または「hostX.d1.hitachi.co.jp」に変更する。
「@」に変更した場合，JP1/SES互換機能やイベントサービスの定義情報の収集と配布が利用できます。「hostX.d1.hitachi.co.jp」に変更した場合，JP1/SES互換機能やイベントサービスの定義情報の収集と配布が利用できなくなります。運用に合わせてどちらかに変更してください。

起動順序定義ファイル（JP1SVPRM.DAT）をエディターで開き，デフォルトのイベントサーバの代わりにFQDN形式のイベントサーバを起動するように起動順序定義ファイル（JP1SVPRM.DAT）を編集する。
編集後の起動順序定義ファイル（JP1SVPRM.DAT）の内容（イベントサーバに関する個所だけ）を次に示します。

(2)　FQDN形式のイベントサーバを設定する（UNIXの場合）

UNIXで，FQDN形式のイベントサーバを設定する場合の設定手順を次に示します。なお，ここでは，イベントサーバとしてhostX.d1.hitachi.co.jpを指定すると仮定して説明しています。

イベントサーバインデックスファイル（index）をエディターで開き，serverパラメーターのイベントサーバ名をデフォルトの「*」から「@」または「hostX.d1.hitachi.co.jp」に変更する。
「@」に変更した場合，JP1/SES互換機能やイベントサービスの定義情報の収集と配布が利用できます。「hostX.d1.hitachi.co.jp」に変更した場合，JP1/SES互換機能やイベントサービスの定義情報の収集と配布が利用できなくなります。運用に合わせてどちらかに変更してください。イベントサーバ名を「@」に変更した場合のイベントサーバインデックスファイル（index）の内容を次に示します。

jbs_startスクリプトおよびjbs_stopスクリプトをエディターで開き，デフォルトのイベントサーバの代わりにFQDN形式のイベントサーバが起動および停止するように編集する。
編集後のjbs_startスクリプトおよびjbs_stopスクリプトの内容（イベントサーバに関する個所だけ）を次に示します。

jbs_startスクリプトの内容

jbs_stopスクリプトの内容

8.2　イベントDBの初期化

イベントサービスの稼働中でも，jevdbswitchコマンドを使用して，イベントDBを初期化できます。ただし，次の場合にはイベントサービスを停止し，jevdbinitコマンドでイベントDBを初期化してください。

OSのリソース不足。

イベントサービスに接続できない。

ほかのイベントサーバにJP1イベントを転送している。

イベントDBを初期化する手順について説明します。

＜この節の構成＞

8.2.1　イベントサービスの稼働中に初期化する

8.2.2　イベントサービスの停止中に初期化する

8.2.1　イベントサービスの稼働中に初期化する

イベントサービスの稼働中にイベントDBを初期化する手順を次に示します。なお，ほかのイベントサーバにJP1イベントを転送している場合には，次の「8.2.2　イベントサービスの停止中に初期化する」を参照して，イベントDBを初期化してください。

OSのコマンドなどで，イベントDBをバックアップする。
イベントDBの内容を確認したい場合にバックアップします。バックアップしたデータベースの内容は，jevexportコマンドでcsvファイルに出力して確認できます。
jevexportコマンドの詳細については，「13.　コマンド」の「jevexport」を参照してください。

jevdbswitchコマンドを2回実行する。
jevdbswitchコマンドを2回実行してイベントDBを2回切り替えてください。
jevdbswitchコマンドを1回実行すると，イベントDBのアクティブ面（現在使用されているイベントDB）からスタンバイ面（待機しているイベントDB）へと切り替わります。このとき，スタンバイ面に登録されていたデータは削除されます。jevdbswitchコマンドを2回実行すると，スタンバイ面とアクティブ面の両方のデータが削除されます。
jevdbswitchコマンドの詳細については，「13.　コマンド」の「jevdbswitch」を参照してください。

注意事項

上記の操作では，メモリー上のイベントはクリアできません。メモリー上には最大2,000件の転送リトライ中のイベントが格納されます。メモリー上のイベントをクリアする場合は，「8.2.2　イベントサービスの停止中に初期化する」の手順でイベントDBを初期化してください。

8.2.2　イベントサービスの停止中に初期化する

イベントサービスの停止中に初期化する手順は，該当するマシンでイベント転送を実施しているかどうかで異なります。それぞれの場合の初期化する手順を次に示します。

＜この項の構成＞

(1)　初期化対象のイベントサーバからJP1イベントを転送している場合

(2)　初期化対象のイベントサーバからJP1イベントを転送していない場合

(1)　初期化対象のイベントサーバからJP1イベントを転送している場合

転送先イベントサーバに転送されたJP1イベントから，イベントDB内通し番号の開始番号を求め，それを基に初期化を実施します。

転送先イベントサーバで，初期化対象のイベントサーバから最後に転送されたJP1イベントのイベントDB内通し番号を確認する。
次のどちらかの方法で，初期化対象のイベントサーバから最後に転送されたJP1イベントを検索してください。なお，転送先イベントサーバが複数ある場合は，すべての転送先イベントサーバを検索対象にしてください。

JP1/IM - Viewのイベント検索

JP1/IM - Viewのイベント検索で，転送先イベントサーバに登録されているJP1イベントを検索してください。

JP1イベントの検索方法については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」を参照してください。

イベントDBのcsvファイル出力

転送先イベントサーバのイベントDBをjevexportコマンドでcsvファイルに出力して確認してください。

jevexportコマンドの詳細については，「13.　コマンド」の「jevexport」を参照してください。

jevdbinitコマンドの-sオプションに，イベントDB内通し番号の開始番号を指定して実行する。
次のコマンドを実行してください。

jevdbinit -s 手順1で求めたイベントDB内通し番号＋1 {-b | -n}

-sオプションに指定した開始番号でイベントDBが再作成されます。

(2)　初期化対象のイベントサーバからJP1イベントを転送していない場合

次のコマンドを実行して，イベントDBを初期化します。

jevdbinit {-b | -n}

jevdbinitコマンドを実行すると，イベントDBが削除されたあと，再作成されます。イベントDB内通し番号は，削除前のイベントDB内通し番号を引き継ぎます。

破壊されたデータベースをバックアップしたい場合は，-bオプションを指定してください。バックアップしない場合は-nオプションを指定してください。バックアップしたデータベースの内容は，jevexportコマンドでcsvファイルに出力して確認できます。

jevdbinitコマンド，およびバックアップしたデータベースの詳細については，「13.　コマンド」の「jevdbinit」を参照してください。

なお，jevdbinitコマンド実行時に，イベントDB内通し番号が引き継げない場合は初期化に失敗します。KAJP1789-Eのメッセージが出力された場合は，次のように，-sオプションで指定する開始番号を0に指定してイベントDBを再作成してください。

jevdbinit -s 0 {-b | -n}

8.3　イベントDBの内容をcsvファイルに出力する

この節では，イベントDBの内容をcsv形式に変換し，csvファイルに出力する方法について説明します。イベントDBの履歴をcsvファイルとして残したい場合や，バックアップしたイベントDBの内容を確認したい場合に使用します。csvファイルに出力するには，次のコマンドを実行します。

jevexport [-h イベントサーバ名]
         [-i イベントDBファイル名]
         [-o 出力ファイル名]
         [-f フィルターファイル名]
         [-t ON | OFF]
         [-l コードセット名]
         [-k 項目ファイル名]
         [-a]

jevexportコマンドの詳細については，「13.　コマンド」の「jevexport」を参照してください。次にcsvファイルの出力形式について説明します。

＜この節の構成＞

8.3.1　csvファイルの出力形式

8.3.2　csvファイルに出力される項目

8.3.1　csvファイルの出力形式

csvファイルの出力形式を次に示します。

文字列を出力する場合は，"（ダブルクォーテーションマーク）で囲んで出力します。

データをコンマで区切ります。

レコードを改行によって区切ります。

文字列データが空の場合でも"（ダブルクォーテーションマーク）で囲んで出力します。

数字型のデータを出力する場合は，半角数字を使用します。

拡張属性のうち，共通情報12種類は，拡張属性値だけを表示し，そのほかの固有情報は，拡張属性名と拡張属性値を出力します。

固有情報の出力順序は，固有情報属性名のアルファベット順に並びます。

csvファイルに出力される項目のうち列番号28番目以降は，項目ファイルによって変更できます。
出力される項目の詳細については，次に説明します。

8.3.2　csvファイルに出力される項目

ここでは，csvファイルに出力される項目について説明します。csvファイルに出力される項目は，jevexportコマンド実行時に-kオプションを指定した場合と，指定しなかった場合によって異なります。

jevexportコマンド実行時に，-kオプションを指定した場合，-kオプションを指定しなかった場合，それぞれの場合に出力される項目を次に示します。

＜この項の構成＞

(1)　jevexportコマンド実行時に-kオプションを指定した場合

(2)　jevexportコマンド実行時に-kオプションを指定しなかった場合

(1)　jevexportコマンド実行時に-kオプションを指定した場合

jevexportコマンド実行時に-kオプションを指定した場合，項目ファイルで指定した拡張属性（固有情報）が，指定された順番で列番号28以降に拡張属性名と拡張属性値のペアの形式で出力されます。なお，項目ファイルで指定した拡張属性が存在しなかった場合は，その列番号は空白となります。

jevexportコマンド実行時に-kオプションを指定した場合に出力される項目を次の表に示します。タイトル名は，-aオプションを指定した場合に出力されます。日本語で出力する場合は，-lオプションのコードセット名に文字コードを指定してください。-lオプションを指定しない場合は，タイトル名は英語で出力されます。

表8-1　jevexportコマンドに-kオプションを指定した場合のcsvファイルに出力される項目

列番号
属性名
日本語タイトル名
英語タイトル名
詳細
形式
備考

1
イベントDB内の通し番号
イベントDB内通し番号
Serial number
発行元によらないで，このイベントサーバに到達した順番（ローカルイベントも含む）。この属性はJP1イベントのイベントサーバ間の転送時に保存されない。主にJP1イベントをユーザーアプリケーションが取得したときやほかのイベントサーバへ転送した時の漏れ・重複の防止に用いる。
数値
－

2
ID(基本部)
イベントID(基本部)
Event ID(basic code)
イベントIDの基本部。イベントIDは8バイトの値で表されるが，基本部は上位4バイトを表す。
数値
1～8桁の16進数

3
ID(拡張部)
イベントID(拡張部)
Event ID(extended code)
イベントIDの拡張部。イベントIDは8バイトの値で表されるが，拡張部は下位4バイトを表す。
数値
1～8桁の16進数

4
PROCESSID
発行元プロセスID
Source process ID
発行元アプリケーションプログラムのプロセスID。
数値
数値

5
TIME
登録時刻
Registered time
発行元イベントサーバでの登録時刻（発行元ホストの時計に基づく）。
数値
UTC 1970-01-01 00:00:00からの秒数

6
ARRIVEDTIME
到着時刻
Arrived time
自イベントサーバでの登録時刻。この属性はJP1イベントのイベントサーバ間転送時には保存されない。
数値
UTC 1970-01-01 00:00:00からの秒数

7
REASON
登録要因
Registered reason
JP1イベントがこのイベントサーバに登録された要因。この属性はJP1イベントのイベントサーバ間転送時に保存されない。登録要因を次に示す。

1の場合：

自イベントサーバから自イベントサーバあての発行

3の場合：

他イベントサーバから自イベントサーバあての発行

4の場合：

環境設定の指定による他イベントサーバから自イベントサーバへの転送。

数値
－

8
USERID
発行元ユーザーID
Source user ID
発行元プロセスのユーザーID。
数値
WindowsとJavaでは環境設定による固定値(-1～65,535)

9
GROUPID
発行元グループID
Source group ID
発行元プロセスのグループID。
数値
WindowsとJavaでは環境設定による固定値(-1～65,535)

10
USERNAME
発行元ユーザー名
Source user name
発行元プロセスのユーザー名。
文字列
－

11
GROUPNAME
発行元グループ名
Source group name
発行元プロセスのグループ名。
文字列
WindowsとJavaではヌル文字列

12
SOURCESERVER
発行元イベントサーバ名
Source event server name
発行元のイベントサーバ名。JP1イベントが転送された場合でもこのJP1イベントが発生したホストのイベントサーバ名が入る。
文字列
－

13
SOURCESEQNO
発行元イベントDB内通し番号
Source specific serial number
発行元ホストでのイベントDB内通し番号。
数値
転送によって値は変化しない

14
CODESET
コードセット
Code set
メッセージ・詳細情報・拡張属性が記述されている文字コードセット名。
文字列
－

15
MESSAGE
メッセージ
Message
JP1イベントの内容を表した文字列。
文字列
－

16
SEVERITY
重大度
Event level
JP1イベントの緊急性（「重大度」）を表す。緊急性の高い順に次の値がある。
"Emergency"（緊急）
"Alert"（警戒）
"Critical"（致命的）
"Error"（エラー）
"Warning"（警告）
"Notice"（通知）
"Information"（情報）
"Debug"（デバッグ）
文字列
拡張属性値1

17
USER_NAME
ユーザー名
User name
業務を実行しているユーザー名。
文字列
拡張属性値2

18
PRODUCT_NAME
プロダクト名
Product name
JP1イベントを発行したプログラム名。次に示すプログラム名などがある。
"/HITACHI/JP1/AJS"
"/HITACHI/JP1/AOM"
"/HITACHI/JP1/IM"
"/HITACHI/JP1/NBQ"
"/HITACHI/JP1/NQSEXEC"
文字列
拡張属性値3

19
OBJECT_TYPE
オブジェクトタイプ
Object type
オブジェクトの種類を表す。次に示すオブジェクトの種類などがある。
"JOB"
"JOBNET"
"ACTION"
"ACTIONFLOW"
"PRINTJOB"
"PRINTQUEUE"
"PRINTER"
"BATCHQUEUE"
"PIPEQUEUE"
文字列
拡張属性値4

20
OBJECT_NAME
オブジェクト名
Object name
ジョブ，ジョブネットなどのオブジェクトの名称。
ジョブネットなど階層のあるオブジェクトの場合，最下層の要素となる。
文字列
拡張属性値5

21
ROOT_OBJECT_TYPE
登録名タイプ
Root object type
オブジェクトの種別。
通常はOBJECT_TYPEの種別と同じだが，ジョブネットなど階層のあるオブジェクトの場合ROOT_OBJECT_NAMEの種別と同じになる。値の範囲はOBJECT_TYPEと同じ。
文字列
拡張属性値6

22
ROOT_OBJECT_NAME
登録名
Root object name
ユーザーの操作時に実行を指示する単位になる名称。通常はオブジェクト名と同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの名称になる。
文字列
拡張属性値7

23
OBJECT_ID
オブジェクトID
Object ID
オブジェクトID。
PRODUCT_NAMEとの組み合わせによってオブジェクトのインスタンスを統合システム内で一意に意識できる文字列（形式は他製品に依存する。この情報はJP1/IM - Viewの［統合機能メニュー］画面から各製品のモニターを呼び出すときに使用する）。
文字列
拡張属性値8

24
OCCURRENCE
事象種別
Occurrence
OBJECT_NAMEに対して起こった事象。次に示す事象種別などがある。
"END"
"LATEEND"
"LATESTART"
"NOTICE"
"PAUSE"
"START"
"SWITCH"
文字列
拡張属性値9

25
START_TIME
開始時刻
Start time
実行開始または再実行開始の時刻(UTC 1970-01-01 00:00:00からの秒数)。この項目は設定されない場合もある。
文字列
拡張属性値10

26
END_TIME
終了時刻
End time
実行終了または再実行終了の時刻(UTC 1970-01-01 00:00:00からの秒数)。この項目は設定されない場合もある。
文字列
拡張属性値11

27
RESULT_CODE
終了コード
Result Code
終了コード(10進数文字列)。この項目は設定されない場合もある。
文字列
拡張属性値12

28
個別拡張属性名1
個別拡張属性
Program-specific extended attribute
個別拡張属性名
文字列
－

29
個別拡張属性値1
出力なし
個別拡張属性値
文字列
－

：
：
：
：
：
：
：
：
：
：
：
：

m-1
個別拡張属性名n
出力なし
個別拡張属性名
文字列
－

m
個別拡張属性値n
出力なし
個別拡張属性値
文字列
－

（凡例）

m：csvファイルに出力される項目数

n：個別拡張属性名と個別拡張属性値の組数

(2)　jevexportコマンド実行時に-kオプションを指定しなかった場合

jevexportコマンド実行時に-kオプションを指定しなかった場合は，列番号28以降の内容が-kオプションを指定した場合と異なります。列番号28以降の項目を次の表に示します。なお，csvファイルに出力される列番号1～27の項目については，「表8-1　jevexportコマンドに-kオプションを指定した場合のcsvファイルに出力される項目」を参照してください。タイトル名は，-aオプションを指定した場合に出力されます。日本語で出力する場合は，-lオプションのコードセット名に文字コードを指定してください。-lオプションを指定しない場合は，タイトル名は英語で出力されます。

表8-2　jevexportコマンドに-kオプションを指定しなかった場合のcsvファイルに出力される項目

列番号
属性名
日本語タイトル名
英語タイトル名
詳細
形式
備考

28
個別拡張属性数
個別拡張属性数
Program-specific extended attributes count
個別拡張属性の数
数値
数値(0～n)

29
個別拡張属性名1
個別拡張属性
Program-specific extended attribute
個別拡張属性名
文字列
－

30
個別拡張属性値1
出力なし
個別拡張属性値
文字列
－

：
：
：
：
：
：
：
：
：
：
：
：

m-1
個別拡張属性名n
出力なし
個別拡張属性名
文字列
－

m
個別拡張属性値n
出力なし
個別拡張属性値
文字列
－

（凡例）

m：csvファイルに出力される項目数

n：個別拡張属性名と個別拡張属性値の組数

8.4　イベントサービスの注意事項

イベントサービスを使用する場合の注意事項を次に示します。

Windows上で，JP1/Baseをインストールして，イベントサービスを起動しない設定に変更した場合，イベントサービスを利用するプログラムの性能に影響が出る場合があります。イベントサービスを起動しない場合には，イベントサービス環境設定のAPI設定ファイル（api）に次の指定を追加してください。

server 自ホスト名 close  0.0.0.0  jp1imevtapi

自ホスト名は，hostnameコマンドで表示されるとおりに設定してください。この指定によって，性能への影響を避けられます。なお，イベントサービスを起動する場合はこの指定は行わないでください。

自ホスト名からIPアドレスへの変換，および自IPアドレスから自ホスト名への変換が行えない環境では，イベントサービスを起動できません。これらの変換が行えるようにhostsファイル，またはDNSサーバの設定を行ってください。

インストール時に標準で設定されたイベントサーバ設定ファイル（conf）のportsパラメーターにIPアドレスを指定する場合，hostnameコマンドで返されるホスト名に対応していないIPアドレスを指定すると，JP1イベントを登録および取得するプログラムが，イベントサービスに接続できなくなることがあります。このような場合には，API設定（api）設定ファイルを修正してください。

例

confファイルの設定（portsパラメーター部分抜粋）

ports 192.168.1.2 jp1imevt jp1imevtapi

apiファイルの設定

server * keep-alive

server ホスト名 keep-alive 192.168.1.2

注　ホスト名にはhostnameコマンドで返されるホスト名を指定してください。

イベントサービスでは，JP1イベントの基本属性および拡張属性の文字列属性での外字の使用をサポートしていません。文字列属性に外字が含まれている場合，JP1/IM - Viewなどで正しく表示されない場合があります。また，転送設定ファイル（forward），ログファイルトラップ動作定義ファイル，イベントログトラップ動作定義ファイルでの外字の使用もサポートしていません。外字を指定した場合，JP1イベントが正しく転送されなかったり，正しくトラップされなかったりする場合があります。

9.　イベント変換の設定

JP1/Baseでは，ログファイルへ出力されたメッセージやWindowsのイベントログをJP1イベントに変換して，イベントサービスで利用できます。

この章では，JP1/Baseが提供するイベント変換の設定方法について説明します。なお，バージョン8以前のJP1/Cm2/NNMまたはバージョン7.5以前のHP NNMが管理するSNMPトラップをJP1イベントに変換する場合は，「付録I　SNMPトラップを変換する」を参照してください。

＜この章の構成＞

9.1　アプリケーションプログラムのログファイルを変換する

9.2　Windowsのイベントログを変換する

9.1　アプリケーションプログラムのログファイルを変換する

ログファイルトラップを使ってアプリケーションログをJP1イベントに変換します。ログファイルトラップの場合，JP1イベントに変換したいアプリケーションプログラムのログメッセージが各ユーザーによって異なると考えられるため，デフォルト値を設定していません。ログファイルトラップを利用したい場合は，各ユーザーで設定してください。

次に，ログファイルトラップの設定について説明します。

＜この節の構成＞

9.1.1　ログファイルトラップを設定する

9.1.2　ログファイルトラップの注意事項

9.1.1　ログファイルトラップを設定する

ログファイルトラップの起動，設定の変更，動作状況の確認，設定内容の確認，および終了の手順について説明します。ログファイルトラップは次に示すファイルで設定します。

ログファイルトラップ動作定義ファイル
監視するログファイルの形式や，監視失敗時のリトライなどを設定します。

ログ情報定義ファイル（jevlogd.conf）
ログファイルトラップ用ログファイルの保存ファイル数や最大容量を指定します。通常は設定を変更しなくても，デフォルト値で運用できます。

＜この項の構成＞

(1)　起動する

(2)　設定変更する

(3)　動作状況を確認する

(4)　設定内容を確認する

(5)　終了する

(6)　自動で起動する

(1)　起動する

ログファイルトラップを起動する手順を説明します。

ログファイルトラップ動作定義ファイルを作成する。

jevlogstartコマンドを実行する。
ログファイルトラップが起動し，ID番号が標準出力，またはsyslogに出力されます。ID番号は，ログファイルトラップを停止したり，定義ファイルを更新したりする際に利用するため，控えておいてください。
また，jevlogstartコマンドでは，監視名を設定できます。監視名を設定すると，jevlogstop，jevlogreload，jevlogstatコマンドで監視名を指定して操作できます。
jevlogstartコマンドの詳細については，「13.　コマンド」の「jevlogstart」を参照してください。

(2)　設定変更する

ログファイルトラップ動作定義ファイルとログ情報定義ファイル（jevlogd.conf）の設定を変更する手順を説明します。

(a)　ログファイルトラップ動作定義ファイルの設定を変更する

ログファイルトラップ動作定義ファイルを編集する。

変更を反映する。

MARKSTRまたはACTDEFパラメーター以外を変更した場合

ログファイルトラップを再起動します。jevlogstop { ID番号 | -a 監視名 }を実行したあと，jevlogstartコマンドを実行してください。

MARKSTRまたはACTDEFパラメーターを変更した場合

ログファイルトラップを停止しないで，jevlogreload { ID番号 | -a 監視名 }を実行して設定を反映してください。

jevlogstartコマンドの詳細については，「13.　コマンド」の「jevlogstart」を参照してください。

jevlogreloadコマンドの詳細については，「13.　コマンド」の「jevlogreload」を参照してください。

(b)　ログ情報定義ファイルの設定を変更する

ログ情報定義ファイル（jevlogd.conf）を編集する。

ログファイルトラップ管理サービス（デーモン）を起動する。

(3)　動作状況を確認する

ログファイルトラップの動作状況を確認したい場合は，次のコマンドを実行してください。引数に指定したID番号または監視名のログファイルトラップの動作状況を戻り値によって確認できます。

jevlogstat { ID番号 | -a 監視名 }

また，次のように指定すると，動作中のログファイルトラップID番号および監視名の一覧を表示できます。

jevlogstat ALL

jevlogstatコマンドの詳細については，「13.　コマンド」の「jevlogstat」を参照してください。

(4)　設定内容を確認する

稼働しているログファイルトラップの動作定義情報を確認したい場合は，次のコマンドを実行してください。画面にログファイルトラップ動作定義ファイルの形式で出力されます。

jbsgetopinfo -o logtrap [-i ID番号 | -a 監視名]

jbsgetopinfoコマンドの詳細については，「13.　コマンド」の「jbsgetopinfo」を参照してください。

(5)　終了する

ログファイルトラップを終了する場合は，次のコマンドを実行します。

jevlogstop { ID番号 | -a 監視名 }

起動しているすべてのログファイルトラップを終了したい場合は，次のコマンドを実行します。

jevlogstop ALL

jevlogstopコマンドの詳細については，「13.　コマンド」の「jevlogstop」を参照してください。

(6)　自動で起動する

ログファイルトラップは，システムを再起動すると停止し，自動で起動しません。システムの再起動時に，ログファイルトラップを自動で起動させたい場合は，次に示すどれかの方法を行ってください。

ログファイルトラップ起動定義ファイル（jevlog_start.conf）を使用する。
ログファイルトラップ起動定義ファイルに起動するログファイルトラップおよび起動オプションを指定します。指定したログファイルトラップは，ログファイルトラップ管理サービス（デーモン）起動時に自動的に起動されます。
ログファイルトラップ起動定義ファイルの詳細については「14.　定義ファイル」の「ログファイルトラップ起動定義ファイル」を参照してください。
なお，ログファイルトラップ起動定義ファイルを使用した場合は，ログファイルトラップ起動実行結果ログに出力される起動開始情報（KAVA3661-I）および起動結果情報（KAVA3662-I）を参照して，対象のログファイルトラップが起動されたことを確認してください。

Windowsの場合は，バッチファイルを作成し，JP1/Baseの起動管理で設定する。
jevlogstartコマンドを記述したバッチファイルを作成し，起動順序定義ファイル（JP1SVPRM.DAT）の「ReadyCommand=」に各バッチファイルのフルパスを記入してください。
起動順序定義ファイルの詳細については，「14.　定義ファイル」の「起動順序定義ファイル（Windows限定）」を参照してください。

UNIXの場合は，jbs_startを編集する。
イベントサービスおよびログファイルトラップ管理デーモンの起動後，ログファイルトラップを起動するように設定してください。

JP1/AJSのジョブとしてjevlogstartコマンドを実行する。

9.1.2　ログファイルトラップの注意事項

ログファイルトラップを使用する際の注意事項を次に示します。

ログファイルトラップで監視中のログファイルを編集，または削除する場合は，ログファイルトラップを停止してください。ログファイルトラップの動作中にログファイルを編集，または削除すると，ログファイルの監視位置がずれて，正しく変換できなくなることがあります。

ログファイルにデータを書き込んでも，ディスク中にそのデータが出力されていないと，ログファイルトラップはデータを取り出せません。つまり，即時にデータを取り出したい場合でも，ディスク中にデータが出力されていないため，データを取り出せないことがあります。

ログの書き込み位置がログファイルの最後の方にあると，最初のJP1イベントが発生するまでに時間が掛かります。

統合トレースログやsyslogファイルを監視する場合の注意事項

ログファイルトラップを使用して，統合トレースログやsyslogファイルを監視する場合，転送の失敗が繰り返されることがあります。JP1イベントの転送に失敗した場合，統合トレースログやsyslogファイルに転送失敗のKAJP1037-Eのメッセージが出力されます。統合トレースログやsyslogファイルを監視するために，ログファイルトラップ動作定義ファイルに次のような設定があると，転送失敗のKAJP1037-EのメッセージもJP1イベントに変換されます。

設定例

統合トレースログやsyslogファイルを監視する場合

ACTDEF=<Error>11 "KAJP....-E"
ACTDEF=<Error>11 "-E"

syslogファイルを監視する場合

ACTDEF=<Error>11 "error"

この場合に，JP1/IMのIM構成管理と連携していて，転送設定ファイル（forward）をデフォルトの設定のまま使用していると，転送失敗のJP1イベントも転送されるため，転送の失敗が繰り返されてしまいます。

この転送の繰り返しを回避するためには，KAJP1037-Eのメッセージをログファイルトラップ機能でトラップしないようにログファイルトラップ動作定義ファイルの設定を変更してください。設定例を次に示します。

設定例1

MARKSTR="KAJP1037-E"

設定例2

ACTDEF=<Error>11 "KAJP....-E"
      !"KAJP1037-E"

JP1/AJSのログファイル監視ジョブを使用する場合

JP1/AJSのログファイル監視ジョブを使用する場合は，JP1/Baseのログファイルトラップ管理サービス（デーモン）とイベントサービスを事前に起動してください。JP1/AJSのログファイル監視ジョブは，JP1/Baseのログファイルトラップ機能を使って実行されます。

ログファイル監視ジョブの詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

9.2　Windowsのイベントログを変換する

イベントログトラップを使って，WindowsのイベントログをJP1イベントに変換します。デフォルトでは，Windowsの「イベント ビューア」に表示される「システム ログ」と「アプリケーション ログ」の「エラーログ」および「警告ログ」をJP1イベントに変換する設定になっています。

次にイベントログトラップの設定について説明します。

＜この節の構成＞

9.2.1　イベントログトラップを設定する

9.2.2　イベントログトラップの注意事項

9.2.1　イベントログトラップを設定する

イベントログトラップの起動，および終了の手順について説明します。イベントログトラップは次に示すファイルで設定します。

イベントログトラップ動作定義ファイル
JP1イベントに変換するイベントログの条件やイベントログの監視間隔などを設定します。

＜この項の構成＞

(1)　起動する

(2)　設定を変更する

(3)　設定内容を確認する

(4)　終了する

(5)　自動で起動する

(1)　起動する

イベントログトラップを起動する手順を説明します。

イベントログトラップ動作定義ファイル（ntevent.conf）を編集する。

イベントログトラップサービスを起動する。
［コントロールパネル］の［サービス］ダイアログボックスから，「JP1/Base EventlogTrap」の名称のサービスを起動します。

注意事項

登録先イベントサーバが起動していない場合，接続のリトライを設定していなければサービスの起動に失敗します。

イベントログトラップ動作定義ファイル（ntevent.conf）が存在しない，または内容が誤っている場合，サービスの起動に失敗し，イベントログおよび統合トレースログにその情報が出力されます。

イベントログトラップ動作定義ファイル（ntevent.conf）のフィルターに不正なログの種別の指定，または不正な正規表現の指定があった場合，デフォルトではそのフィルターだけを無効として，サービスの起動およびリロードに成功します。フィルターに不正があった場合にサービスの起動およびリロードを失敗とすることもできます。設定の詳細については，「14.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」のfilter-check-levelパラメーターを参照してください。

監視対象はサービスの起動以降に発生したイベントログからになります。サービスの起動以前に発生したイベントログは監視対象にはできません。

(2)　設定を変更する

イベントログトラップ動作定義ファイル（ntevent.conf）を編集する。

変更を反映する。

serverパラメーターを変更した場合

イベントログトラップサービスを再起動してください。

serverパラメーター以外を変更した場合

イベントログトラップサービスを停止しないで，jeveltreloadコマンドを実行して設定を反映してください。

(3)　設定内容を確認する

稼働しているイベントログトラップの動作定義情報を確認したい場合は，次のコマンドを実行してください。画面にイベントログトラップ動作定義ファイル（ntevent.conf）の形式で出力されます。

jbsgetopinfo -o evttrap

jbsgetopinfoコマンドの詳細については，「13.　コマンド」の「jbsgetopinfo」を参照してください。

(4)　終了する

イベントログトラップを停止する場合は，イベントログトラップサービスを停止します。［コントロールパネル］の［サービス］ダイアログボックスから，「JP1/Base EventlogTrap」の名称のサービスを停止してください。

(5)　自動で起動する

イベントログトラップは，システムを再起動すると停止し，自動で起動しません。システムの再起動時にイベントログトラップを自動で起動させたい場合は，JP1/Baseの起動管理でイベントログトラップサービスが自動起動するように設定します。

起動順序定義ファイル（JP1SVPRM.DAT）で，下記パラメーターの行頭の「#」を削除してください。

#[Jp1BaseEventlogTrap]
#Name=JP1/BaseEventlogTrap
#ServiceName=JP1_Base_EventlogTrap

起動順序定義ファイルの設定の詳細については，「14.　定義ファイル」の「起動順序定義ファイル（Windows限定）」を参照してください。

9.2.2　イベントログトラップの注意事項

＜この項の構成＞

(1)　デフォルトで運用する場合の注意事項

(2)　JP1/AJSのWindowsイベントログ監視ジョブを使用する場合の注意事項

(1)　デフォルトで運用する場合の注意事項

イベントログトラップ動作定義ファイル（ntevent.conf）と転送設定ファイル（forward）をデフォルトで使用する場合の注意事項および対策について説明します。

JP1/IMのIM構成管理と連携していて，イベントログトラップ動作定義ファイル（ntevent.conf）と転送設定ファイル（forward）をデフォルトの設定のまま使用した場合，JP1イベントの転送に失敗するとKAJP1037-Eのメッセージがイベントログに出力され，JP1イベントに変換されます。変換されたJP1イベントは再度転送され，転送の失敗が繰り返されます。
この転送の繰り返しを回避するためには，KAJP1037-Eのメッセージをトラップしないように，イベントログトラップ動作定義ファイル（ntevent.conf）の設定を変更してください。イベントログトラップ動作定義ファイルの設定例については，「14.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」を参照してください。

イベントログの取得ができなくなった場合，統合トレースログにメッセージが出力されますが，JP1イベントは出力されません。JP1イベントが出力されるようにするには，イベントログトラップ動作定義ファイル（ntevent.conf）の設定を変更してください。イベントログトラップ動作定義ファイルについては，「14.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」を参照してください。

(2)　JP1/AJSのWindowsイベントログ監視ジョブを使用する場合の注意事項

JP1/AJSのWindowsイベントログ監視ジョブを使用する場合，イベントログトラップサービスを起動してください。JP1/AJSのWindowsイベントログ監視ジョブは，JP1/Baseのイベントログトラップが前提となっています。

また，JP1/AJSで監視するイベントの条件を含むように，イベントログトラップ動作定義ファイル（ntevent.conf）を設定してください。JP1/AJSで監視するイベントの条件は，JP1/AJSで定義した設定とイベントログトラップ動作定義ファイル（ntevent.conf）で定義した設定の論理積となります。Windowsイベントログ監視ジョブの詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

10.　イベントサービスの定義情報の収集と配布（JP1/IM限定）

この章では，JP1/BaseとJP1/IMで構成されたシステム内のイベントサービスの定義情報をマネージャーホストで一括収集する方法と，各管理ホストに配布する方法について説明します。

＜この章の構成＞

10.1　定義情報・稼働情報の通信を設定する（IM構成管理連携）

10.2　イベントサービスの定義情報を収集する

10.3　イベントサービスの定義情報を配布する

10.1　定義情報・稼働情報の通信を設定する（IM構成管理連携）

JP1/IMのIM構成管理と連携すると，JP1/Baseの定義情報や稼働情報をIM構成管理・ビューアーから管理できます。IM構成管理との連携については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」を参照してください。

IM構成管理と連携する場合は，ホストアクセス制限定義ファイルにアクセスできるホストを設定しておく必要があります。ホストアクセス制限定義ファイルで設定されたホストからのアクセスは許可されますが，設定されていないホストからのアクセスはすべて拒否されます。ホストアクセス制限定義ファイルについては，「14.　定義ファイル」の「ホストアクセス制限定義ファイル」を参照してください。

10.2　イベントサービスの定義情報を収集する

マネージャーホストで収集コマンド（jevdef_get）を実行すると，JP1/IMのシステム構成で定義したすべての管理対象ホストから，指定した定義ファイルの定義情報を収集し標準出力します。jevdef_getコマンドの詳細については，「13.　コマンド」の「jevdef_get」を参照してください。

注意事項

jevdef_getコマンド実行時に，収集先ホストで何らかのエラーが発生し定義情報が収集できなかった場合は，エラーメッセージが標準エラー出力され，エラーが発生したホストの定義情報は標準出力されません。

jevdef_getコマンド実行時に収集先ホストから返されるメッセージは，各ホストで設定されている言語種別で出力されます。言語種別設定の手順については，「2.3.5　セットアップ前の作業」を参照してください。

＜この節の構成＞

10.2.1　出力形式

10.2.2　収集例

10.2.1　出力形式

収集した定義情報は次のように出力されます。

# JP1/Base - Event Server ファイルの種類-information by jevdef_get
# Time which acquired the following definitions : 日時

[収集先ホスト1]
定義情報
[収集先ホスト2]
定義情報
　　　：

「ファイルの種類」には，収集対象の定義ファイル名が表示されます。転送設定ファイルの場合はforward，イベントログトラップ動作定義ファイルの場合はevent log trap，ログファイルトラップ動作定義ファイルの場合はlog file trapが表示されます。

「定義情報」には，#や空行を含めた定義ファイル内のすべての情報が表示されます。

10.2.2　収集例

転送設定ファイル（forward）の定義情報を収集した場合の収集例を次に示します。

# JP1/Base - Event Server forward-information by jevdef_get
# Time which acquired the following definitions : 2003/07/21 15:23:22

[SubHost_A]  
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

[SubHost_B]
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

[SubHost_C]
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

[JP1host_1]  
to SubHost_A
E.SEVERITY IN Error Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

[JP1host_2]  
to SubHost_A
E.SEVERITY IN Error Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

10.3　イベントサービスの定義情報を配布する

マネージャーホストで定義した情報を管理対象ホストへ配布する方法について説明します。配布対象のホストは，マネージャーホストのJP1/IM - Managerのシステム構成で定義した管理対象ホストです。すべての管理対象ホストや特定の管理対象ホストに配布できます。

管理対象ホストへ定義情報を配布する手順を次に示します。

配布定義ファイルを編集する。
配布定義ファイルには，配布先ホストと，配布したい定義情報を定義します。配布定義ファイルは，配布対象の定義ファイルごとに作成する必要があります。
配布定義ファイルについては，「14.　定義ファイル」の「配布定義ファイル」を参照してください。

jevdef_distribコマンドを実行する。
定義情報が配布され，設定が反映されます。jevdef_distribコマンドの詳細については，「13.　コマンド」の「jevdef_distrib」を参照してください。

注意事項

jevdef_distribコマンド実行時に，配布先のホストですでに定義情報が設定されていた場合は，いったん定義ファイルの情報を削除してから定義情報を配布します。

jevdef_distribコマンド実行時に配布先ホストから返されるメッセージは，各ホストで設定されている言語種別で出力されます。言語種別設定の手順については，「2.3.5　セットアップ前の作業」を参照してください。なお，日本語のマネージャーから日本語のエージェントに配布する場合で設定されている文字コードが異なるとき，配布定義ファイルの文字コードは自動的に変換されます。

11.　ローカルアクションの設定

JP1/Baseでは，障害発生時など特定のJP1イベントを契機に，あらかじめ登録したコマンドを自動的に実行するローカルアクションを利用できます。

この章では，JP1/Baseのローカルアクションを使うための設定方法について説明します。

＜この章の構成＞

11.1　ローカルアクションを設定する

11.2　ローカルアクションの運用例

11.3　ローカルアクションの注意事項

11.1　ローカルアクションを設定する

ここでは，ローカルアクションの設定方法について説明します。

＜この節の構成＞

11.1.1　ローカルアクションを定義する

11.1.2　ローカルアクションの設定を変更する

11.1.3　ローカルアクションの動作状況を確認する

11.1.4　ローカルアクションを休止する

11.1.1　ローカルアクションを定義する

ローカルアクションを定義する手順を次に示します。

共通定義情報にローカルアクションを定義する情報を登録する。
共通定義情報では，次に示す項目の値を変更できます。

ローカルアクション実行履歴ログのファイルサイズ（デフォルトは1,024キロバイト）

ローカルアクション実行履歴ログの保存面数（デフォルトは4面）

ローカルアクションの休止設定（デフォルトは休止しない）

これらの設定を変更する手順を次に示します。

1-1　共通定義設定用ファイル（ローカルアクション機能）のモデルファイル（jp1bs_lcact_setup.conf.model）を任意のファイル名でコピーする。

1-2　コピーしたファイルを編集する。

1-3　次のコマンドを実行する。

jbssetcnf 1-2で編集したファイル名

ローカルアクションの定義情報が共通定義情報に登録されます。

jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

共通定義設定用ファイル（ローカルアクション機能）の詳細については，「14.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。共通定義設定用ファイル（ローカルアクション機能）に誤りがあった場合は，設定項目は無効とし，デフォルト値で動作します。

ローカルアクション実行定義ファイル（jbslcact.conf）を作成・編集する。
ローカルアクション実行定義ファイルでは，次の項目を定義します。

必須項目

ローカルアクションの実行条件

JP1ユーザー名

実行するコマンド

オプション項目

環境変数ファイル名

同一アクションの抑止

実行待ちアクション数

同時実行数

ユーザープロファイルのロード（Windows限定）

ローカルアクション実行定義ファイルの詳細については，「14.　定義ファイル」の「ローカルアクション実行定義ファイル」を参照してください。ローカルアクション実行定義ファイルに誤りがあった場合，コマンドは実行されません。

JP1ユーザーのユーザーマッピングを設定する。
各アクションを実行するために必要なJP1ユーザーのユーザーマッピングを設定します。ユーザーマッピングの設定方法については，「6.1　ユーザー管理の設定（Windowsの場合）」または「6.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

ローカルアクション環境変数ファイルを編集する。
ローカルアクションの実行コマンドを実行するために必要な環境変数を定義します。ローカルアクション環境変数ファイルの詳細については，「14.　定義ファイル」の「ローカルアクション環境変数ファイル」を参照してください。ローカルアクション環境変数ファイルに誤りがあった場合，コマンドは実行されません。

JP1/Baseのすべてのサービスを再起動する。
jbs_spmd_reloadコマンドを実行します。jbs_spmd_reloadコマンドの詳細については，「13.　コマンド」の「jbs_spmd_reload」を参照してください。

11.1.2　ローカルアクションの設定を変更する

ローカルアクションの実行条件や実行コマンドを変更する場合の手順を次に示します。

ローカルアクション実行定義ファイル（jbslcact.conf）を編集する。
ローカルアクション実行定義ファイルの詳細については，「14.　定義ファイル」の「ローカルアクション実行定義ファイル」を参照してください。

ローカルアクション実行定義ファイル（jbslcact.conf）の設定内容を有効にするため，JP1/Baseのすべてのサービスを再起動する。
jbs_spmd_reloadコマンドを実行します。jbs_spmd_reloadコマンドの詳細については，「13.　コマンド」の「jbs_spmd_reload」を参照してください。

設定内容は，再起動後に発生したローカルアクションから有効になります。

ローカルアクション実行定義ファイル（jbslcact.conf）に誤りがありエラーとなった場合，ローカルアクションは休止になります。

11.1.3　ローカルアクションの動作状況を確認する

ローカルアクションによって実行されたアクションの動作状況を確認したい場合は，次のコマンドを実行して確認してください。

jbslistlcact

実行中または実行待ち状態にあるアクションの情報が出力されます。

実行中または実行待ち状態にあるアクションをキャンセルしたい場合は，次のコマンドを実行してキャンセルしてください。

jbscancellcact

コマンドで指定したアクションがキャンセルされます。実行中のアクションをキャンセルした場合，生成された子プロセスもキャンセルされます。

jbslistlcactコマンドとjbscancellcactコマンドの詳細については，「13.　コマンド」の「jbslistlcact」，「jbscancellcact」を参照してください。

11.1.4　ローカルアクションを休止する

マシンメンテナンスなどの作業のため，ローカルアクションを一時的に休止する場合の手順を次に示します。

ローカルアクションを定義したときに使用した共通定義設定用ファイル（ローカルアクション機能）を編集する。
PAUSEパラメーターに00000001（休止する）を設定します。共通定義設定用ファイル（ローカルアクション機能）の詳細については，「14.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。

次のコマンドを実行する。

jbssetcnf 1で編集したファイル名

ローカルアクションを休止するように設定された情報が共通定義情報に登録されます。jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

設定した共通定義情報の内容を有効にする。
jbs_spmd_reloadコマンドを実行します。jbs_spmd_reloadコマンドの詳細については，「13.　コマンド」の「jbs_spmd_reload」を参照してください。

ローカルアクションを休止した場合，ローカルアクションのプロセスは起動したままで，イベントの取得を中止します。実行中または実行待ち状態にあるアクションはキャンセルされません。

ローカルアクションの休止を解除して起動した場合，解除以降に登録されたイベントからアクションの対象となります。ローカルアクションの休止を解除する設定については，「14.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。

11.2　ローカルアクションの運用例

ローカルアクションを設定し，運用する例を示します。ここでは，次の図に示すようなシステム構成で，ログファイルのオーバーフローを示すJP1イベント（イベントID：999）が発生した場合に，ログファイルを退避させたり，資料採取ツールを起動させたりするなどの処理コマンドをまとめて記述したバッチファイル（ID999_operation.bat）を実行するローカルアクションを想定しています。

図11-1　ローカルアクションの運用例

＜この節の構成＞

11.2.1　ローカルアクション実行定義ファイルを設定する

11.2.2　転送設定ファイルを設定する

11.2.1　ローカルアクション実行定義ファイルを設定する

まず，ローカルアクション実行定義ファイルを設定します。ローカルアクション実行定義ファイルに設定する内容と設定例を，次に示します。

ローカルアクション実行定義ファイルに設定する内容

ログファイルのオーバーフローを通知するJP1イベント（イベントID：999）が発生したら，ログファイルのオーバーフローに対処する処理を記述したバッチファイル（ID999_operation.bat）を実行するように設定する。

バッチファイルの実行権限を持つOSユーザーで実行するため，OSユーザーがマッピングされているJP1ユーザー名（jp1user01）を設定する。

このアクションが動作したことをマネージャーホストへ通知するため，ローカルアクションの開始と完了を知らせるJP1イベントの発行を設定し，マネージャーホストへ転送する。

ローカルアクション実行定義ファイルの設定例

# JP1イベントID:999の対処
act ID999_action
 cnd
   B.ID IN 999
 end-cnd
 usr jp1user01
 cmd "D:¥EventOperation¥ID999_operation.bat"
 evt yes/yes
end-act

設定したローカルアクション実行定義ファイルを有効にする手順については，「11.1.1　ローカルアクションを定義する」を参照してください。

11.2.2　転送設定ファイルを設定する

アクション開始イベントおよびアクション完了イベントを上位のマネージャーホストへ転送します。イベントサービスの転送設定ファイルに設定する内容と設定例を，次に示します。

転送設定ファイルに設定する内容

アクション開始イベント（00004780），アクション完了イベント（00004781），アクション完了イベント（実行不可）（00004782），アクション完了イベント（キャンセル）（00004783）をエージェントホストから上位のサブマネージャーホストへ転送するように設定する。

さらに，サブマネージャーホストから上位のマネージャーホストへ転送するように設定する。

転送設定ファイルの設定例

# ローカルアクションのイベント転送
to-upper
 B.ID RANGE 4780 4783
end-to

設定した転送設定ファイルを有効にする手順については，「8.1.2　イベントサービス環境を設定する」を参照してください。

11.3　ローカルアクションの注意事項

ローカルアクションを使用する場合の注意事項を次に示します。

ローカルアクションによるコマンド実行から直接OSをシャットダウンするコマンドは使用しないでください。

12.　JP1/Base運用中の設定変更

この章では，JP1/Base運用中にJP1/Baseの設定を変更した場合に，変更内容が反映される契機と，JP1/Baseの運用中にIPアドレスやホスト名などのシステム環境を変更した場合に必要な作業について説明します。

＜この章の構成＞

12.1　JP1/Baseの設定を変更する

12.2　JP1/Baseが動作するホストの設定を変更する

12.1　JP1/Baseの設定を変更する

運用中にJP1/Baseの設定を変更した場合に，変更内容が反映される契機を次の表に示します。設定方法の詳細については，参照先に記載しています。なお，「参照先」の上段はWindowsの場合の参照先，下段はUNIXの場合の参照先となっています。

設定項目
設定が反映される契機
参照先

JP1/Baseの障害対処の設定
異常終了したプロセスの再起動の設定を変更した場合，JP1/Baseを再起動するか，リロードコマンドを実行すると設定が反映されます。
2.4.3

プロセス管理機能が制御するプロセスの異常終了時，および認証サーバ切り替え発生時にJP1イベントを発行させる設定を変更した場合，コマンドの実行後，JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS）を再起動します。
2.4.3

ユーザー管理の設定
認証サーバは，JP1製品がJP1/Baseのユーザー認証を利用する機能を実行中でなければ，JP1/Baseが起動している状態で変更できます。
GUIの［OK］ボタンをクリックした時点，またはコマンドを実行した時点で設定が反映されます。
6.1.1

6.3.1

JP1ユーザーの設定は，認証サーバが起動していれば，いつでも変更できます。
GUIの［OK］ボタンをクリックした時点，またはコマンドを実行した時点で設定が反映されます。ただし，設定を変更したJP1ユーザーがログイン中の場合は，次にログインした時点で設定が反映されます。
JP1/Baseを再起動する必要はありません。
6.1.2，6.2.2

6.3.2

JP1資源グループ別権限レベルの設定は，認証サーバが起動していれば，いつでも変更できます。
GUIの［OK］ボタンをクリックした時点，またはコマンドを実行した時点で設定が反映されます。
JP1/Baseを再起動する必要はありません。
6.1.3

6.3.3

セカンダリー認証サーバを設置する場合，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバにコピーすると設定が有効になります。
6.1.4

6.3.4

ディレクトリサーバと連携したログイン認証の設定は，認証サーバが起動していれば，いつでも変更できます。
ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）を変更し，コマンドを実行した時点で設定が反映されます。
6.2.1

ユーザーマッピングを設定する場合，JP1/Baseを停止する必要はありません。
GUIの［OK］ボタンをクリックした時点，またはコマンドを実行した時点で設定が反映されます。
6.1.6
6.1.7

6.3.5

サービスの起動順序および終了順序の設定（Windows限定）
起動順序定義ファイル（JP1SVPRM.DAT）を変更した場合，Windowsの再起動後に設定が反映されます。
起動順序定義ファイル（Windows限定）

イベントサービス環境の設定
イベントサーバインデックスファイル（index）の設定を変更した場合，イベントサービスを再起動すると設定が反映されます。
イベントサーバインデックスファイル

イベントサーバ設定ファイル（conf）の設定を変更した場合，イベントサービスを再起動すると設定が反映されます。
イベントサーバ設定ファイル

転送設定ファイル（forward）の設定を変更した場合，リロードコマンドを実行すると設定が反映されます。
転送設定ファイル

API設定ファイル（api）の設定を変更した場合，イベントサービスを再起動すると設定が反映されます。
API設定ファイル

イベント変換の設定
ログファイルトラップ動作定義ファイルの設定を変更した場合，リロードコマンドを実行すると一部のパラメーターの定義が反映されます。
ログファイルトラップ動作定義ファイル

イベントログトラップ動作定義ファイル（ntevent.conf）の設定を変更した場合，リロードコマンドを実行すると定義が反映されます。
イベントログトラップ動作定義ファイル（Windows限定）

ヘルスチェック機能の設定
ヘルスチェック定義ファイル（jbshc.conf）の設定内容を変更した場合，JP1/Baseを再起動するか，jbs_spmd_reloadコマンドを実行すると設定が反映されます。
ヘルスチェック定義ファイル

統合トレース機能の設定
統合トレース機能を再起動すると設定が反映されます。
hntr2util（Windows限定），hntr2util（UNIX限定），hntr2conf，hntr2getconf

通信設定
jp1hosts情報を変更した場合は，コマンドを実行したあとJP1/Baseを再起動すると設定が反映されます。
4.3.2

JP1/Baseの通信方式を変更した場合は，コマンドを実行したあとに，JP1/Base，JP1/Baseを前提とする製品（JP1/IM，JP1/AJS），およびJP1/Baseと依存関係のあるプログラムを再起動すると設定が反映されます。
4.3.3

イベントサービスの通信方式を変更した場合は，JP1/Base，JP1/Baseを前提とする製品（JP1/IM，JP1/AJS），およびJP1/Baseと依存関係のあるプログラムを再起動すると設定が反映されます。
4.3.4

ローカルアクション機能の設定
ローカルアクション実行定義ファイルの設定を変更した場合，JP1/Baseを起動またはリロードすると，設定が反映されます。
ローカルアクション実行定義ファイル

12.2　JP1/Baseが動作するホストの設定を変更する

この節では，JP1/Baseが動作しているマシンのホスト名，IPアドレス，およびシステムの日時を変更した場合の影響と，変更時に必要となる作業について説明します。

＜この節の構成＞

12.2.1　ホスト名の変更による影響および必要な作業

12.2.2　IPアドレスの変更による影響および必要な作業

12.2.3　システムの日時変更時に必要な作業

12.2.1　ホスト名の変更による影響および必要な作業

ここでは，ホスト名を変更したときに影響する機能および必要な作業について説明します。

＜この項の構成＞

(1)　ユーザー認証

(2)　ユーザーマッピング

(3)　イベントサービス

(4)　JP1/IM - Managerを利用している場合

(5)　クラスタシステムを運用している場合

(6)　統合トレース(HNTRLib2)

(7)　jp1hosts定義ファイル

(1)　ユーザー認証

認証サーバのホスト名を変更した場合は，Windowsの場合［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブで，UNIXの場合jbssetusrsrvコマンドで，ホスト名を変更してください。認証サーバのホスト名を変更していなければ，ユーザー認証関係に影響はありません。

(2)　ユーザーマッピング

ユーザーマッピングの場合，変更漏れが発生するおそれがあるため，十分注意して次に示す作業を行ってください。

(a)　マネージャー側のホスト名を変更した場合

マネージャーからリモートコマンド実行を出すすべてのエージェントホストで，エージェントホスト上のマッピング定義ファイルの確認をしてください。

マッピング定義ファイルに記述されている"JP1ユーザー名 : サーバホスト名 : ユーザーリスト"の二つ目のフィールドである"サーバホスト名"をマネージャー側のホスト名の変更に伴って変更する必要があります。変更手順を次に示します。

jbsgetumapコマンドを実行して，テキストベースのファイルを取得する。

該当するサーバホスト名を変更後のサーバホスト名に変更する。
変更前の"サーバホスト名"が「*」の場合は，変更する必要はありません。

サーバホスト名を変更した後，jbsmkumapコマンドを実行して，新しい定義情報を登録する。

コマンドの詳細については，「13.　コマンド」の「jbsgetumap」と「jbsmkumap」を参照してください。

注意事項

DNS運用でドメイン名を使用する場合，サーバホスト名には，FQDN形式のホスト名を指定してください。

(b)　エージェント側のホスト名を変更した場合

エージェント側のホスト名を変更した場合は，特に影響はありません。

(3)　イベントサービス

イベントサービスの環境設定ファイル（すべてテキスト形式）に，ホスト名を指定している場合は，漏れがないように修正してください。なお，修正する必要があるのは，ユーザーが設定した部分だけです。デフォルトで設定されていた個所については，修正する必要はありません。イベントサービスが自動的にどこかに記憶し，それを修正しないと動作しなくなる，ということはありません。

(4)　JP1/IM - Managerを利用している場合

イベント検索で「選択イベント条件入力」を使用する場合は，JP1/IM - Managerを使用するマシンから変更前のホスト名も参照できる（例："ping 変更前ホスト名"が成功する）ようにhostsなどが設定されている必要があります。このような操作の必要がなければ，イベントサービスに関する設定を変更する必要は特にありません。

JP1/IM - Managerの場合，システムの構成を構成定義ファイルで行っています。このため，ホスト名が変更されるたびに，システム構成の再配布（jbsrt_distribコマンドの実行）が必要となります。システム構成の再配布を行わないと，JP1イベントが正しく転送されなくなるおそれがあります。システム構成の再配布の方法については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」を参照してください。

注意事項

旧ホスト名のときに発行されたJP1イベントは，ホスト名変更後もJP1/IM - Viewの登録ホスト名には，旧ホスト名が表示されます。検索する場合でも，登録ホスト名の指定は，旧ホスト名がマッチします。また，このようなJP1イベントからJP1/AJSのモニター表示は行えません。

(5)　クラスタシステムを運用している場合

クラスタシステムを運用している環境で論理ホスト名を変更した場合は，変更前の論理ホスト名を削除してください。その後，変更後の論理ホスト名に対して，クラスタ運用ができるよう再セットアップしてください。

Windowsの場合

論理ホスト名の削除方法については，「3.7.1　論理ホストの削除（Windowsの場合）」を参照してください。クラスタシステムのセットアップ方法については，「3.4.3　セットアップ」を参照してください。

UNIXの場合

論理ホスト名の削除方法については，「3.7.2　論理ホストの削除（UNIXの場合）」を参照してください。クラスタシステムのセットアップ方法については，「3.5.3　セットアップ」を参照してください。

(6)　統合トレース(HNTRLib2)

ホスト名の変更をした場合，統合トレース(HNTRLib2)の再起動は必須ではありませんが，再起動を行わなかった場合，統合トレースログのヘッダー情報に変更前のホスト名が出力されます。

(7)　jp1hosts定義ファイル

jp1hosts定義ファイルを設定している場合は，ホスト名を再設定してください。

12.2.2　IPアドレスの変更による影響および必要な作業

ここでは，IPアドレスを変更したときに必要な作業について説明します。IPアドレスだけを変更した場合は，次に示す作業を行ってください。

JP1/Baseを前提としているすべてのプログラムを停止する。

JP1/Baseを停止する。

IPアドレスを変更する。
jp1hosts定義ファイル，イベントサーバ設定ファイル，およびAPI設定ファイルなど，それぞれのファイルで設定しているIPアドレスを変更します。IPアドレスの設定が必要な場合と，設定するファイルについては，「4.8　通信設定が必要な場合」を参照してください。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

12.2.3　システムの日時変更時に必要な作業

JP1/Baseの運用中にシステムの日時を変更する場合の注意事項および手順について説明します。

サーバのシステム時刻の時刻合わせを，NTP（Network Time Protocol）サーバなどを利用した時刻が過去に戻ることがない方式で行う場合には，以下の手順に従わないで変更できます。その場合，JP1/Baseを停止する必要はありません。

＜この項の構成＞

(1)　変更したシステムの日時を過去に戻す場合

(2)　システムの時刻が遅れているため，時刻を進める場合

(1)　変更したシステムの日時を過去に戻す場合

システムの日時を変更する際，過去の日時に変更することは避けてください。

システム時刻の進みや遅れを補正する際でも，システム時刻を過去に戻すと到着時刻を指定したイベント検索が正しく行えない場合があります。

テストなどでシステムの時刻を意図的に未来の日時へ変更したような場合に，システム日時を元に戻すときは，次に示す手順で戻してください。なお，JP1/AJSが起動している場合は，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照して変更手順を確認してください。

JP1/IM - Managerを停止する。

JP1/Baseを停止する。

起動管理機能を使用しているすべてのサービスを停止する。

システムの日時を現在日時に戻す。

jevdbinitコマンドでイベントDBを削除する。

JP1/Baseを起動する。

JP1/IM - Managerを起動する。

(2)　システムの時刻が遅れているため，時刻を進める場合

システムの時刻を進める場合，JP1/Baseではサービスを停止する必要はありませんが，JP1/AJSが起動している場合は，JP1/AJSのサービスを停止する必要があります。手順の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

13.　コマンド

この章では，JP1/Baseで使用できるコマンドの文法を説明します。

＜この章の構成＞

コマンド一覧

cpysvprm（Windows限定）

hntr2conf

hntr2getconf

hntr2getname（Windows限定）

hntr2kill（UNIX限定）

hntr2mon（UNIX限定）

hntr2util（UNIX限定）

hntr2util（Windows限定）

jbs_killall.cluster（UNIX限定）

jbs_log.bat（Windows限定）

jbs_log.sh（UNIX限定）

jbs_setup_cluster（Windows限定）

jbs_spmd（UNIX限定）

jbs_spmd_reload

jbs_spmd_status

jbs_spmd_stop

jbs_start（UNIX限定）

jbs_start.cluster（UNIX限定）

jbs_stop（UNIX限定）

jbs_stop.cluster（UNIX限定）

jbsacllint

jbsaclreload

jbsadduser

jbsadmin（Windows Vista限定）

jbsblockadesrv

jbscancellcact

jbschgds（Windows限定）

jbschgpasswd

jbschkds（Windows限定）

jbsgetcnf

jbsgetopinfo

jbsgetumap

jbshostsexport

jbshostsimport

jbslistacl

jbslistlcact

jbslistsrv

jbslistuser

jbsmkpass（Windows限定）

jbsmkumap

jbspassmgr（Windows限定）

jbsrmacl

jbsrmumap

jbsrmumappass（Windows限定）

jbsrmuser

jbsrt_del

jbsrt_distrib

jbsrt_get

jbsrt_sync

jbssetacl

jbssetcnf

jbssetumap

jbssetupsrv（Windows限定）

jbssetusrsrv（UNIX限定）

jbsumappass（Windows限定）

jbsunblockadesrv

jbsunsetcnf

jcocmdconv

jcocmddef

jcocmddel

jcocmdlog

jcocmdshow

jevdbinit

jevdbmkrep

jevdbswitch

jevdef_distrib

jevdef_get

jeveltreload（Windows限定）

jevexport

jevlogdstart（UNIX限定）

jevlogdstat

jevlogdstop（UNIX限定）

jevlogreload

jevlogstart

jevlogstart（クラスタ運用限定）

jevlogstat

jevlogstop

jevlogstop（クラスタ運用限定）

jevregsvc（Windows限定）

jevreload

jevsend

jevsendd

jevstart（UNIX限定）

jevstat

jevstop（UNIX限定）

Jischk

Jiscond

Jisconv

Jiscpy

Jisext

Jisinfo

Jiskeymnt

Jisktod

Jislckclear（Windows限定）

Jislckext

Jislckfree（Windows限定）

Jislckreg（UNIX限定）

Jismlcktr（Windows限定）

Jisprt

Jisrsdel（UNIX限定）

jp1base_setup（UNIX限定）

jp1base_setup_cluster（UNIX限定）

jp1bshasetup（Windows限定）

jp1ping

コマンド一覧

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

（凡例）

○：対応している。

－：対応していない。

スーパーユーザー：Windowsの場合，Administratorsを意味する。

起動管理機能で使用するコマンド

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
JP1SVPRM.DATファイルの作成 | cpysvprm（Windows限定） | ○ | － | なし

ネットワーク設定の確認で使用するコマンド

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
ネットワーク設定の確認 | jp1ping | ○ | ○ | なし

JP1/Baseのプロセスの起動・終了およびセットアップなどで使用するコマンド

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
統合トレース（HNTRLib2）の起動 | hntr2mon（UNIX限定） | － | ○ | スーパーユーザー
統合トレース（HNTRLib2）の終了 | hntr2kill（UNIX限定） | － | ○ | スーパーユーザー
統合トレース（HNTRLib2）の設定変更 | hntr2util（Windows限定） | ○ | － | スーパーユーザー
hntr2util（UNIX限定） | － | ○ | スーパーユーザー
hntr2conf | ○ | ○ | スーパーユーザー
統合トレース（HNTRLib2）の設定表示 | hntr2getconf | ○ | ○ | なし
統合トレース（HNTRLib2）を利用するPP名称の出力 | hntr2getname（Windows限定） | ○ | － | スーパーユーザー
JP1/Baseのセットアップ | jp1base_setup（UNIX限定） | － | ○ | スーパーユーザー
イベントサービスを含めたJP1/Baseの起動 | jbs_start（UNIX限定） | － | ○ | スーパーユーザー
イベントサービスを含めたJP1/Baseの終了 | jbs_stop（UNIX限定） | － | ○ | スーパーユーザー
イベントサービスを除くJP1/Baseのプロセスの起動 | jbs_spmd（UNIX限定） | － | ○ | スーパーユーザー
イベントサービスを除くJP1/Baseのプロセスの終了 | jbs_spmd_stop | ○ | ○ | スーパーユーザー
イベントサービスを除くJP1/Baseのプロセスの状態確認 | jbs_spmd_status | ○ | ○ | スーパーユーザー
イベントサービスを除くJP1/Baseのプロセスの再読み込み処理 | jbs_spmd_reload | ○ | ○ | スーパーユーザー
クラスタシステムで運用するための設定 | jp1bshasetup（Windows限定） | ○ | － | スーパーユーザー
jp1base_setup_cluster（UNIX限定） | － | ○ | スーパーユーザー
jbs_setup_cluster（Windows限定） | ○ | － | スーパーユーザー
クラスタシステムでの起動 | jbs_start.cluster（UNIX限定） | － | ○ | スーパーユーザー
クラスタシステムでの終了 | jbs_stop.cluster（UNIX限定） | － | ○ | スーパーユーザー
クラスタシステムで運用中のJP1/Baseプロセスの強制終了 | jbs_killall.cluster（UNIX限定） | － | ○ | スーパーユーザー
JP1/Base管理者コンソールの起動 | jbsadmin（Windows Vista限定） | ○ | － | スーパーユーザー

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

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
バージョン7以前のJP1/Baseのコマンド実行履歴をバージョン8以降用のコマンド実行履歴ファイルに移行する | jcocmdconv | ○ | ○ | スーパーユーザー

ユーザー管理機能で使用するコマンド

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
認証サーバの設定 | jbssetusrsrv（UNIX限定） | － | ○ | スーパーユーザー
jbssetupsrv（Windows限定） | ○ | － | スーパーユーザー
認証サーバの確認 | jbslistsrv | ○ | ○ | スーパーユーザー
認証サーバの閉塞 | jbsblockadesrv | ○ | ○ | スーパーユーザー
認証サーバの閉塞解除 | jbsunblockadesrv | ○ | ○ | スーパーユーザー
JP1ユーザーの登録 | jbsadduser | ○ | ○ | スーパーユーザー
JP1ユーザーの削除 | jbsrmuser | ○ | ○ | スーパーユーザー
登録したJP1ユーザーの表示 | jbslistuser | ○ | ○ | スーパーユーザー
登録済みJP1ユーザーのパスワードの変更 | jbschgpasswd | ○ | ○ | スーパーユーザー
JP1ユーザーの操作権限の登録 | jbssetacl | ○ | ○ | スーパーユーザー
JP1ユーザーの操作権限の削除 | jbsrmacl | ○ | ○ | スーパーユーザー
登録したJP1ユーザーの操作権限の表示 | jbslistacl | ○ | ○ | スーパーユーザー
マッピング情報の生成，共通定義への登録 | jbsmkumap | ○ | ○ | スーパーユーザー
マッピング情報の個別登録 | jbssetumap | ○ | ○ | スーパーユーザー
マッピング情報の個別削除 | jbsrmumap | ○ | ○ | スーパーユーザー
登録済みマッピング情報の一覧表示 | jbsgetumap | ○ | ○ | スーパーユーザー
OSユーザーのパスワード管理情報のメンテナンス用プログラム | jbspassmgr（Windows限定） | ○ | － | スーパーユーザー
OSユーザーの個別登録，個別パスワード情報変更 | jbsumappass（Windows限定） | ○ | － | スーパーユーザー
OSユーザーの個別削除 | jbsrmumappass（Windows限定） | ○ | － | スーパーユーザー
OSユーザーのパスワード情報の共通定義への一括登録 | jbsmkpass（Windows限定） | ○ | － | スーパーユーザー
認証サーバの操作権限に関する定義情報の表示 | jbsacllint | ○ | ○ | スーパーユーザー
認証サーバの操作権限に関する定義情報の再読み込み | jbsaclreload | ○ | ○ | スーパーユーザー
連携するディレクトリサーバの変更 | jbschgds（Windows限定） | ○※ | － | スーパーユーザー
連携するディレクトリサーバの設定確認 | jbschkds（Windows限定） | ○※ | － | スーパーユーザー

注※　Windows XP Professional，Windows Server 2003およびWindows Server 2008で実行できます。

イベントサービスで使用するコマンド

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
転送設定ファイルのリロード | jevreload | ○ | ○ | スーパーユーザー
イベントDBの初期化 | jevdbinit | ○ | ○ | スーパーユーザー
重複防止テーブルの再構築 | jevdbmkrep | ○ | ○ | スーパーユーザー
イベントDBの切り替え | jevdbswitch | ○ | ○ | スーパーユーザー
イベントDBのcsvファイルへの出力 | jevexport | ○ | ○ | なし
イベントサーバのサービスの追加登録 | jevregsvc（Windows限定） | ○ | － | スーパーユーザー
手動でのイベントサービスの起動 | jevstart（UNIX限定） | － | ○ | スーパーユーザー
手動でのイベントサービスの終了 | jevstop（UNIX限定） | － | ○ | スーパーユーザー
イベントサービスの状態確認 | jevstat | ○ | ○ | スーパーユーザー
イベントサーバへのJP1イベントの登録 | jevsend | ○ | ○ | なし
イベントサーバへのJP1イベントの登録および到達確認 | jevsendd | ○ | ○ | なし
イベントログトラップ動作定義ファイルのリロード | jeveltreload（Windows限定） | ○ | － | スーパーユーザー
ログファイルトラップ管理デーモンの起動 | jevlogdstart（UNIX限定） | － | ○ | スーパーユーザー
ログファイルトラップ管理デーモンの終了 | jevlogdstop（UNIX限定） | － | ○ | スーパーユーザー
ログファイルトラップ管理サービス（デーモン）の状態確認 | jevlogdstat | ○ | ○ | スーパーユーザー
ログファイルトラップの起動 | jevlogstart | ○ | ○ | スーパーユーザー
ログファイルトラップの終了 | jevlogstop | ○ | ○ | スーパーユーザー
ログファイルトラップの起動（クラスタ運用限定） | jevlogstart（クラスタ運用限定） | ○ | ○ | スーパーユーザー
ログファイルトラップの終了（クラスタ運用限定） | jevlogstop（クラスタ運用限定） | ○ | ○ | スーパーユーザー
ログファイルトラップ動作定義ファイルのリロード | jevlogreload | ○ | ○ | スーパーユーザー
ログファイルトラップの状態確認 | jevlogstat | ○ | ○ | スーパーユーザー
イベントサービスの定義情報の収集 | jevdef_get | ○ | ○ | スーパーユーザー
イベントサービスの定義情報の配布 | jevdef_distrib | ○ | ○ | スーパーユーザー

ISAMファイル（索引順編成ファイル）の操作および保守に関するユーティリティコマンド

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
キーの追加，削除，再構築 | Jiskeymnt | ○ | ○ | スーパーユーザー
ファイルの変換 | Jisconv | ○ | ○ | スーパーユーザー
ファイルの検証 | Jischk | ○ | ○ | スーパーユーザー
ファイルの抽出 | Jisext | ○ | ○ | スーパーユーザー
リソースの設定支援 | Jislckreg（UNIX限定） | － | ○ | スーパーユーザー
レコード内容の表示 | Jisprt | ○ | ○ | スーパーユーザー
リソースの削除 | Jisrsdel（UNIX限定） | － | ○ | スーパーユーザー
キー定義情報の表示 | Jisinfo | ○ | ○ | スーパーユーザー
ファイルの圧縮 | Jiscond | ○ | ○ | スーパーユーザー
ロックテーブルの拡張 | Jislckext | ○ | ○ | スーパーユーザー
ロックテーブル情報の表示 | Jismlcktr（Windows限定） | ○ | － | スーパーユーザー
ロックエントリー情報の削除 | Jislckfree（Windows限定） | ○ | － | スーパーユーザー
ファイル・レコード占有状態の確認，解除 | Jislckclear（Windows限定） | ○ | － | スーパーユーザー
ファイルのコピー | Jiscpy | ○ | ○ | スーパーユーザー
レコードの抽出 | Jisktod | ○ | ○ | スーパーユーザー

稼働情報および共通定義情報の採取，登録，および削除コマンド

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
稼働情報の採取 | jbsgetopinfo | ○ | ○ | スーパーユーザー
共通定義情報の採取 | jbsgetcnf | ○ | ○ | スーパーユーザー
共通定義情報の登録 | jbssetcnf | ○ | ○ | スーパーユーザー
共通定義情報の削除 | jbsunsetcnf | ○ | ○ | スーパーユーザー
jp1hosts情報の共通定義情報への登録 | jbshostsimport | ○ | ○ | スーパーユーザー
共通定義情報に登録したjp1hosts情報の確認 | jbshostsexport | ○ | ○ | スーパーユーザー

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

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
障害発生時の資料の採取 | jbs_log.bat（Windows限定） | ○ | － | スーパーユーザー
jbs_log.sh（UNIX限定） | － | ○ | スーパーユーザー

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

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
JP1/IMの構成定義情報の下位ホストへの配布 | jbsrt_distrib | ○ | ○ | スーパーユーザー
JP1/IMの下位ホストからの構成定義情報の収集，および更新 | jbsrt_sync | ○ | ○ | スーパーユーザー
JP1/IMの構成定義情報の削除 | jbsrt_del | ○ | ○ | スーパーユーザー
JP1/IMの構成定義情報の表示 | jbsrt_get | ○ | ○ | スーパーユーザー

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

機能概要 | コマンド名 | Windows | UNIX | 必要な実行権限
実行待ちおよび実行中のローカルアクションの一覧出力 | jbslistlcact | ○ | ○ | スーパーユーザー
実行待ちおよび実行中のローカルアクションのキャンセル | jbscancellcact | ○ | ○ | スーパーユーザー
JP1/IMのコマンド実行環境の設定 | jcocmddef | ○ | ○ | スーパーユーザー
JP1/IMから実行したコマンドの履歴の出力 | jcocmdlog | ○ | ○ | なし
JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドの削除 | jcocmddel | ○ | ○ | スーパーユーザー
JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドの状態確認 | jcocmdshow | ○ | ○ | スーパーユーザー

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

JP1/Base管理者コンソール（Windows Vista，Windows Server 2008の場合）

(1)JP1/Base管理者コンソールの概要

JP1/Baseでは実行権限に管理者権限が必要なコマンド（管理者用コマンド）を提供しています。

JP1/Base管理者コンソールは管理者用コマンドを実行するためのコマンドプロンプトです。

Windowsのユーザーアカウント制御（UAC）が有効な場合は，管理者コンソールからコマンドを実行してください。

(2)起動方法

スタートメニューから［プログラム］－［JP1_Base］－［管理者コンソール］を選択すると起動します。

(3)停止方法

プロンプト上でexitコマンドを入力，またはCloseボタン（×）をクリックすると停止します。

(4)動作のカスタマイズ

JP1/Base管理者コンソールを起動したときに任意の環境変数の設定やカレントパスの変更などのカスタマイズ情報を，JP1/Base管理者コンソールが提供するプロファイルバッチプログラムを編集すると定義できます。

プロファイルバッチプログラムは，インストール先フォルダ¥conf¥jbsadmin¥profile.batです。

［プロファイルバッチプログラムの初期設定］

@echo off

rem #------------------------------------------------------------------
rem # ここにJP1/Base管理者コンソールのプロファイル情報（環境変数など）
rem # を設定できます.
rem #------------------------------------------------------------------

echo JP1/Base 管理者コンソール

@echo on

例えば環境変数JP1_HOSTNAMEにlogicalと設定したい場合，次のように定義します。

@echo off

rem #------------------------------------------------------------------
rem # ここにJP1/Base管理者コンソールのプロファイル情報（環境変数など）
rem # を設定できます.
rem #------------------------------------------------------------------

echo JP1/Base 管理者コンソール
set JP1_HOSTNAME=logical

@echo on

cpysvprm（Windows限定）

機能

起動順序定義ファイル（JP1SVPRM.DAT）を作成します。

形式

cpysvprm [-n ファイル名]
cpysvprm -d

実行権限

なし（ただし，WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-n ファイル名

指定したファイルをコピーして，JP1/Baseのデータフォルダ（インストール先フォルダ¥conf¥boot¥）にJP1SVPRM.DATファイルを作成します。指定するファイル名は，フルパスで指定してください。このオプションを省略した場合，JP1/BaseのデータフォルダにあるJP1SVPRM.DAT.MODELファイルをサンプルにして，JP1/BaseのデータフォルダにJP1SVPRM.DATファイルを作成します。

-d

JP1/BaseのデータフォルダにあるJP1SVPRM.DATファイルを削除します。このコマンドを実行すると，起動管理機能は使用できなくなります。

注意事項

-nオプションで指定したファイル，またはJP1SVPRM.DAT.MODELファイルは必ずバックアップしてください。

JP1/Baseのデータフォルダ（インストール先フォルダ¥conf¥boot¥）にあるJP1SVPRM.DAT.MODELファイルを直接編集しないでください。

hntr2conf

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，および出力先を変更します。

このコマンドは，GUIで統合トレースログのサイズ，数，および出力先を設定するhntr2utilコマンドと同じ機能を，コマンドの設定で実現します。

形式

hntr2conf [-f ログファイル名]
         [-b ログファイルサイズ]
         [-n ログファイル数]
         [-s バッファーファイルサイズ]
         [-w 監視周期時間]
         [-i 監視間隔時間]
         [-m メッセージ数]
         [-l コマンドログファイル名]
         [-h]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/hitachi/HNTRLib2/bin/

引数

-f ログファイル名

統合トレースログの出力先およびログファイル名のプリフィックスを指定します。ここで指定したプリフィックスに，"[1-16].log"を追加した名称が統合トレースログのファイル名になります。

-b ログファイルサイズ

統合トレースログのサイズ（8～8,192キロバイト）を指定します。

-n ログファイル数

統合トレースログの数（1～16）を指定します。-fオプションで指定した出力先に，ここで指定した値分の統合トレースログを作成します。

-s バッファーファイルサイズ

バッファーファイルのサイズ（8～2,048キロバイト）を指定します。初期設定から変更しないでください。

-w 監視周期時間

監視周期時間（1～300秒）を指定します。初期設定から変更しないでください。

-i 監視間隔時間

監視間隔時間（1～3,600秒）を指定します。初期設定から変更しないでください。

-m メッセージ数

コマンドが出力するメッセージの数の範囲（0～500）を指定します。初期設定から変更しないでください。

-l コマンドログファイル名

コマンドの出力をログファイルへ出力するときに指定します。

-h

ヘルプを表示します。

注意事項

統合トレースログファイルのサイズの適正値については，hntr2utilコマンドの注意事項を参照してください。

統合トレース（HNTRLib2）の設定を変更した場合は，統合トレース機能を再起動する必要があります。統合トレース機能を再起動する方法については，hntr2utilコマンドの注意事項を参照してください。

戻り値

0 | 正常終了
1 | 引数不正
2 | Administrators権限を持たないユーザーがコマンドを実行した（Windowsの場合）
10 | -fオプションで指定したログファイルの出力先が存在しない
11 | -bオプションで指定したログファイルのサイズが小さ過ぎる
12 | -sオプションで指定したバッファーファイルのサイズがログファイルのサイズより大きい
13～17 | 内部エラー
99 | システムエラー

hntr2getconf

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，出力先などの設定情報を出力します。

このコマンドは，GUIで統合トレースログのサイズ，数，および出力先を変更するhntr2utilコマンドと同じ機能を，コマンドの設定で実現します。

形式

hntr2getconf [-f]
            [-b]
            [-n]
            [-s]
            [-w]
            [-i]
            [-m]
            [-l コマンドログファイル名]
            [-h]

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/hitachi/HNTRLib2/bin/

引数

-f

統合トレースログの出力先およびログファイル名を出力します。

-b

統合トレースログのサイズを出力します。

-n

統合トレースログの数を出力します。

-s

バッファーファイルのサイズを出力します。

-w

監視周期時間を出力します。

-i

監視間隔時間を出力します。

-m

メッセージ数を出力します。

-l コマンドログファイル名

コマンドの出力をログファイルへ出力するときに指定します。

-h

ヘルプを出力します。

戻り値

0 | 正常終了
1 | 引数不正
13～17 | 内部エラー
99 | システムエラー

使用例

出力例を次に示します。

オプションを単数で指定したとき（Windowsの場合）

> hntr2getconf.exe -b
8
>

オプションを複数で指定したとき（UNIXの場合）

$ hntr2getconf -b -n
LogSize=8
LogFNum=4
$

オプションを複数指定した場合，オプションの指定順にキー名称を付けて出力します。オプション名とキー名称の対応を次の表に示します。

キー名称 | オプション名
LogFile | -f
LogSize | -b
LogFNum | -n
MapSize | -s
WatchDog | -w
IntervalSec | -i
MaxMsgNum | -m

hntr2getname（Windows限定）

機能

統合トレース（HNTRLib2）を使用するPP名称を標準出力に出力します。

形式

hntr2getname

実行権限

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

格納先ディレクトリ

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

戻り値

-1 | 異常終了
0～126 | HNTRLib2を使用するPP数
127 | HNTRLib2を使用するPP数が127個以上

hntr2kill（UNIX限定）

機能

統合トレース（HNTRLib2）を終了します。

形式

hntr2kill

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/hitachi/HNTRLib2/bin/

hntr2mon（UNIX限定）

機能

統合トレース（HNTRLib2）を起動します。

形式

hntr2mon -d &

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/hitachi/HNTRLib2/bin/

hntr2util（UNIX限定）

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，および出力先を変更します。

このコマンドを実行すると次に示すメニューが表示されます。

次に，このメニューの各項目について説明します。

1

ログファイルのサイズを指定します。（8～4,096キロバイト）

2

ログファイル数を指定します。（1～16）

3および4

変更しないでください。

5

ログファイルの出力先を指定します。

形式

hntr2util

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/hitachi/HNTRLib2/bin/

注意事項

各プログラムが1日当たりに出力するログの量を次に示します。この値を参考にしてログファイルのサイズを設定してください。なお，次に示す計算式の値は，正常に運用した場合のログの量です。エラー時に対処するためには，これ以上のサイズを設定してください。

プロセス管理

3.1 × 1日当たりの起動回数および停止回数（キロバイト）

上記の計算式の値は，1製品当たりのログの量です。JP1/Base，JP1/IM，JP1/AJSそれぞれでログの量を見積もってください。

認証サーバ

0.2 × JP1/AJS - Viewからのログイン回数 + 0.2 × コマンド実行回数（キロバイト）

JP1/IM

（0.16 + 自動アクションのコマンド長） × 1日当たりの自動アクション実行回数 + 0.4 × JP1/IM - Viewからの自動アクション定義の変更回数 + 0.16 × JP1/IM - ViewからJP1/IM - Managerへのログイン回数 + （0.16 + コマンド実行画面のコマンド長） × 1日当たりのコマンド実行回数（キロバイト）

JP1/AJS

起動条件が成立した数 × 0.2（キロバイト）

統合トレース（HNTRLib2）の設定を変更した場合は，次に示す手順で，統合トレース機能を再起動してください。

次に示すコマンドを実行して，統合トレース採取プロセスを停止します。
/opt/hitachi/HNTRLib2/bin/hntr2kill

次に示すコマンドを実行して，統合トレース採取プロセスを起動します。
/opt/hitachi/HNTRLib2/bin/hntr2mon -d &

hntr2util（Windows限定）

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，および出力先を変更します。

このコマンドを実行すると，次に示すダイアログボックスが表示されます。

このダイアログボックスで統合トレースログの出力先，数，およびサイズを設定できます。次にこのダイアログボックスの各項目について説明します。

Output (directory and prefix):

ログファイルの出力先およびログファイル名のプリフィックスを指定します。初期設定では，システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2*.logになっています。

Number of Files:

ログファイル数（1～16）を指定します。初期設定では，4が設定されています。Outputで指定した出力先に，ここで指定した値分のログファイルを作成します。

File Size (KB):

ログファイルのサイズ（8～4,096キロバイト）を指定します。初期設定では，256キロバイトが設定されています。

Buffer (KB):およびWatch Dog (sec):

変更しないでください。

［OK］ボタン

ダイアログボックスで指定した値を反映して，ダイアログボックスを閉じます。

［Cancel］ボタン

ダイアログボックスで指定した値を反映しないで，ダイアログボックスを閉じます。

［Kill］ボタン

実行中のモニタープロセスを終了します。統合トレースサービス（サービス名：Hitachi Network Objectplaza Trace Monitor 2）を停止できますが，通常は，このボタンを利用しないで，Windowsの［コントロールパネル］の［サービス］ダイアログボックス上で操作してください。

形式

hntr2util

実行権限

Administrators権限

格納先ディレクトリ

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

注意事項

各プログラムが1日当たりに出力するログの量を次に示します。この値を参考にしてログファイルのサイズを設定してください。なお，次に示す計算式の値は，正常に運用した場合のログの量です。エラー時に対処するためには，これ以上のサイズを設定してください。

プロセス管理

3.1 × 1日当たりの起動回数および停止回数（キロバイト）

上記の計算式の値は，1製品当たりのログの量です。JP1/Base，JP1/IM，JP1/AJSそれぞれでログの量を見積もってください。

認証サーバ

0.2 × JP1/AJS - Viewからのログイン回数 + 0.2 × コマンド実行回数（キロバイト）

JP1/IM

（0.16 + 自動アクションのコマンド長） × 1日当たりの自動アクション実行回数 + 0.4 × JP1/IM - Viewからの自動アクション定義の変更回数 + 0.16 × JP1/IM - ViewからJP1/IM - Managerへのログイン回数 + （0.16 + コマンド実行画面のコマンド長） × 1日当たりのコマンド実行回数（キロバイト）

JP1/AJS

起動条件が成立した数 × 0.2（キロバイト）

統合トレース（HNTRLib2）の設定を変更した場合は，統合トレース機能を再起動する必要があります。［コントロールパネル］の［サービス］ダイアログボックスで，［Hitachi Network Objectplaza Trace Monitor 2］の名称のサービスを再起動してください。

jbs_killall.cluster（UNIX限定）

機能

論理ホスト上で動作しているJP1/Baseのプロセスを強制終了します。終了させるプロセスを次に示します。

メインプロセス

構成管理プロセス

リモートコマンド実行プロセス

認証サーバプロセス（認証サーバを起動している場合）

イベントサービス

形式

jbs_killall.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1base/

引数

論理ホスト名

JP1/Baseで設定した論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに設定されているホスト名を仮定します。このオプションを省略し，環境変数JP1_HOSTNAMEに何も設定されていない場合は，異常終了します。

注意事項

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

フェールオーバー時には，jbs_stop.clusterコマンドを実行しても，プロセスが終了しないでフェールオーバーが失敗することがあります。終了しないプロセスを強制終了させるために，このコマンドを実行してください。

戻り値

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

jbs_log.bat（Windows限定）

機能

JP1/Baseで障害が発生したときに資料を採取するためのツールです。JP1/Baseの保守資料，OSのシステム情報，統合トレースログなどを採取します。

このツールは，バッチファイルです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料格納フォルダに指定したフォルダの下にjp1defaultフォルダが作成されます。-hオプションを指定した場合は，jp1defaultフォルダと論理ホスト名のフォルダが作成されます。各フォルダの下に，base_1stとbase_2ndのフォルダが作成され，そのフォルダの中に採取した資料がコピーされます。必要に応じて採取した資料を圧縮ツールなどで圧縮してください。フォルダ構成および資料内容を次に示します。

格納先フォルダ
採取した資料

資料格納フォルダ¥jp1_default¥base_1st¥conf¥
設定および定義ファイル

資料格納フォルダ¥jp1_default¥base_1st¥log¥
ログファイル

資料格納フォルダ¥jp1_default¥base_1st¥allusers¥jp1_default¥JP1Base¥log
ログファイル

資料格納フォルダ¥jp1_default¥base_1st¥allusers¥論理ホスト名¥JP1Base¥log
ログファイル

資料格納フォルダ¥jp1_default¥base_1st¥sys¥
OSのシステム情報

資料格納フォルダ¥jp1_default¥base_1st¥sys¥tmp¥event¥
イベントサーバ設定

資料格納フォルダ¥jp1_default¥base_1st¥sys¥OPI
サービス稼働情報

資料格納フォルダ¥jp1_default¥base_1st¥default¥
共通定義情報

資料格納フォルダ¥jp1_default¥base_1st¥plugin¥conf¥
プラグインサービスの設定ファイル

資料格納フォルダ¥jp1_default¥base_1st¥spool¥
統合トレースログ

資料格納フォルダ¥jp1_default¥base_2nd¥log¥Command¥
コマンド実行履歴ファイル

資料格納フォルダ¥jp1_default¥base_2nd¥sys¥
イベントDB

資料格納フォルダ¥論理ホスト名¥base_1st¥conf¥
論理ホストの設定および定義ファイル（論理ホスト指定時）

資料格納フォルダ¥論理ホスト名¥base_1st¥log¥
論理ホストのログ情報
（論理ホスト指定時）

資料格納フォルダ¥論理ホスト名¥base_1st¥event¥
論理ホストのイベントサーバ設定（論理ホスト指定時）

資料格納フォルダ¥論理ホスト名¥base_1st¥sys¥OPI
論理ホストのサービス稼働情報

資料格納フォルダ¥論理ホスト名¥base_2nd¥sys¥
論理ホストのコマンド実行履歴ファイル（論理ホスト指定時）

資料格納フォルダ¥論理ホスト名¥base_2nd¥event¥
論理ホストのイベントDB
（論理ホスト指定時）

なお，このツールを使って採取できる資料の詳細については，「16.3　トラブル発生時に採取が必要な資料」を参照してください。

形式

jbs_log.bat [-h 論理ホスト名]
           [資料格納フォルダ]
           [-r]
           [-t]
           [-u]
           [-p]
           [-q]

実行権限

なし（ただし，WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

インストール先フォルダ¥tools¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。省略した場合，物理ホストの資料だけを採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため，クラスタシステムで使用する場合には，論理ホスト名を必ずこのオプションで指定してください。

資料格納フォルダ

採取した資料を出力するフォルダ名をフルパスまたはコマンドを実行した場所からの相対パスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。

すでに存在するフォルダを指定した場合は，いったんフォルダを削除してから再度作成します。削除したくないファイルが格納されているフォルダと同じフォルダ名は指定しないでください。

このオプションを省略した場合，環境変数TEMPで指定されているフォルダ下のjp1logフォルダを仮定します。環境変数TEMPは，使用しているOSおよびユーザーによって異なりますので，Windowsの［コントロールパネル］の［システム］から確認してください。

-r

コマンド実行履歴ファイル（ISAM）を採取しない場合に指定します。

-t

hostsファイル，およびservicesファイルを採取しない場合に指定します。

-u

クラッシュダンプを採取しない場合に指定します。

-p

イベントDBを採取しない場合に指定します。

-q

資料採取処理の続行確認の応答待ちが必要ない場合に指定します。

-qオプションを指定しない場合は，続行確認のメッセージとともに応答待ちになります。

戻り値

0
正常終了

8
異常終了

引数エラー

採取する保守資料が格納されているフォルダが見つからない

jbs_log.sh（UNIX限定）

機能

JP1/Baseで障害が発生したときに資料を採取するためのツールです。JP1/Baseの保守資料，OSのシステム情報，統合トレース情報などを採取します。

このツールは，シェルスクリプトです。ユーザーによるカスタマイズはできません。

このツールを実行すると，ルートディレクトリの直下で，tarコマンドを使用して資料を採取する対象ディレクトリまたはファイルをアーカイブしたあと，compressコマンドを使用して圧縮します（Linuxでは，gzipコマンドを使用します）。圧縮されたファイルは，-fオプションを指定した場合は資料格納ディレクトリ名に，省略した場合は/tmp/jp1base/に格納されます。圧縮されたファイルのディレクトリ構成を次に示します。

格納先ディレクトリ
採取した資料

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/conf/
設定および定義ファイル

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/log/
ログファイル

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/log/sys/

OSのシステム情報

jbs_spmd_statusコマンドの実行結果

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/sys/tmp/event/
イベントサーバ設定

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/sys/OPI
サービス稼働情報

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/plugin/conf/
プラグインサービスの設定ファイル

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/hitachi/HNTRLib2/spool/
統合トレースログ

資料格納ディレクトリ名/jp1_default_base_1st/opt/jp1/hcclibcnf/
共通定義情報

資料格納ディレクトリ名/jp1_default_base_2nd/var/opt/jp1base/Command/
コマンド実行履歴ファイル

資料格納ディレクトリ名/jp1_default_base_2nd/var/opt/jp1base/sys/event/
イベントDB

資料格納ディレクトリ名/jp1_default_base_2nd/usr/tmp/jp1_ses/
SES互換用設定ファイル

資料格納ディレクトリ名/jp1_default_base_2nd/usr/lib/jp1_ses/

資料格納ディレクトリ名/jp1_default_base_2nd/usr/bin/jp1_ses/

資料格納ディレクトリ名/jp1_default_base_2nd/tmp/

資料格納ディレクトリ名/jp1_default_base_2nd/var/opt/jp1_ses/

資料格納ディレクトリ名/論理ホスト名_base_1st/etc/opt/jp1base/log/
論理ホストのログファイル

資料格納ディレクトリ名/論理ホスト名_base_1st/etc/opt/jp1base/conf/
論理ホストの設定および定義ファイル
（論理ホスト指定時）

資料格納ディレクトリ名/論理ホスト名_base_1st/共有ディレクトリ/event/
論理ホストのイベントサーバ設定
（論理ホスト指定時）

資料格納ディレクトリ名/論理ホスト名_base_1st/共有ディレクトリ/jp1base/sys/OPI
論理ホストのサービス稼働情報

資料格納ディレクトリ名/論理ホスト名_base_2nd/共有ディレクトリ/event/
論理ホストのイベントDB
（論理ホスト指定時）

資料格納ディレクトリ名/論理ホスト名_base_2nd/var/opt/jp1base/COMMAND/
論理ホストのコマンド実行履歴ファイル
（論理ホスト指定時）

なお，このツールを使って採取できる資料の詳細については，「16.3　トラブル発生時に採取が必要な資料」を参照してください。

形式

jbs_log.sh [-f 資料格納ディレクトリ名]
          [-k]
          [-p]
          [-r]
          [-t]
          [-u]
          [-q]
          [-h 論理ホスト名]
          [ディレクトリ名またはファイル名...]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/tools/

引数

-f 資料格納ディレクトリ名

採取した情報の格納ディレクトリ名を，空白文字を含まない絶対パスで指定します。なお，指定されたディレクトリ名に空白文字を含んでいる場合，空白文字以前までの文字列を格納ディレクトリ名とし，空白文字以降の文字列は別の引数と見なされます。

-fオプションを省略した場合，次のファイルが作成されます。

物理ホストの場合

Linux以外

/tmp/jp1base/jp1_default_base_1st.tar.Z

/tmp/jp1base/jp1_default_base_2nd.tar.Z

Linux

/tmp/jp1base/jp1_default_base_1st.tar.gz

/tmp/jp1base/jp1_default_base_2nd.tar.gz

論理ホストの場合

Linux以外

/tmp/jp1base/論理ホスト名_base_1st.tar.Z

/tmp/jp1base/論理ホスト名_base_2nd.tar.Z

Linux

/tmp/jp1base/論理ホスト名_base_1st.tar.gz

/tmp/jp1base/論理ホスト名_base_2nd.tar.gz

-k

バージョン5以前の製品であるJP1/SESに関するログを採取しない場合に指定します。

-p

イベントDBを採取しない場合に指定します。

-r

コマンド実行履歴ファイル（ISAM）を採取しない場合に指定します。

-t

/etc/hosts，/etc/services，/etc/passwdファイルを採取しない場合に指定します。

-u

coreの解析情報を採取しない場合に指定します。

-q

資料採取処理の続行確認の応答待ちが必要ない場合に指定します。

-qオプションを指定しない場合は，続行確認のメッセージとともに応答待ちになります。

ディレクトリ名またはファイル名

資料採取ツールで任意のファイルまたはディレクトリを採取したいときに指定します。フルパス名で指定してください。複数指定する場合は，スペースで区切ってください。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。省略した場合，物理ホストの資料だけを採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため，クラスタシステムで使用する場合には，論理ホスト名を必ずこのオプションで指定してください。

戻り値

0
正常終了

8

引数エラー

指定された論理ホスト名が存在しない

指定された論理ホストの共有ディレクトリがマウントされていない

インストールされていない製品があったため，ファイルのコピー処理ができなかった

デバイスファイルが準備されているかどうかの質問にユーザーがNOで答えた

出力ファイルを上書きしてよいかの質問にユーザーがNOで答えた

指定された追加ファイルが読み取れない

指定された追加ファイルが存在しない

出力先ディレクトリが書き込めない

出力先ディレクトリが作成できなかった

jbs_setup_cluster（Windows限定）

機能

JP1/Baseの論理ホストの動作環境を設定します。クラスタシステムの運用環境のセットアップをする場合には，実行系および待機系で実行してください。

実行系の環境設定

論理ホスト名と共有フォルダ名の指定が必要です。ほかのオプションについては，必要に応じて指定してください。このコマンドを実行すると，指定した共有フォルダに定義ファイルやログファイルなどがコピーされるため，必ず共有ディスクをマウントしておいてください。

待機系の環境設定

論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。なお，待機系の環境設定をする前に，実行系で設定した共通定義情報を待機系にコピーする必要があります。共通定義情報をコピーする方法については，jbsgetcnfコマンドおよびjbssetcnfコマンドを参照してください。

形式

jbs_setup_cluster -h 論理ホスト名
               [[-d 共有フォルダ名 [-a 認証サーバ]] | -r]
               [-v]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

セットアップまたは削除する論理ホスト名を指定します。指定できる文字数は，1～196（バイト）です。

-d 共有フォルダ名

実行系の環境設定時に使用します。フェールオーバー時に引き継ぐ情報を格納する共有フォルダを指定します。共有ディスク上のフォルダを指定してください。指定した共有フォルダで，JP1/Baseの動作に必要な環境設定が行われます。このオプションを指定してコマンドを実行すると，共有ディスク上に次の表に示すフォルダを作成し，定義ファイルをインストール先フォルダ¥jp1base¥confからコピーします。

フォルダ | 格納するファイル
共有フォルダ¥jp1base¥conf¥ | 定義ファイル
共有フォルダ¥jp1base¥log¥ | ログファイル
共有フォルダ¥event¥ | イベントサーバ設定ファイル

-a 認証サーバ

論理ホストが接続する認証サーバのホスト名を指定します。このオプションを省略した場合，認証サーバの設定は物理ホストの環境設定と同じ認証サーバが指定されます。

-v

このオプションを指定すると，論理ホストの動作環境を設定するときのすべてのメッセージを画面上に表示します。

-r

このオプションを指定すると，論理ホストを削除します。このオプションは，実行系および待機系で実行してください。これによって，JP1/Base，JP1/IM，JP1/Power Monitor，およびJP1/AJSの論理ホストの共通定義情報およびサービスが削除されます。なお，共有ディスク上の共有ファイル，共有フォルダは削除されません。手作業で削除してください。

注意事項

設定は，ノードごとに実施してください。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法をIPアドレス指定方式に変更します。変更の対象は，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信のソケットのバインド方法の詳細については，OSのマニュアルを参照してください。

jbs_setup_clusterコマンドで，イベントサービスの通信方式の設定はできません。イベントサーバ設定ファイル（conf）を編集してイベントサービスの通信方式を設定してください。

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

このコマンドを実行すると，ローカルディスク上にあるイベントサービスのイベントサーバインデックスファイル（インストール先フォルダ¥conf¥event¥index）に「論理ホスト名」と「共有ディスク上のフォルダ名¥event」が自動設定されます。また，「共有ディスク上のフォルダ名¥event」下にイベントサーバ設定ファイル（conf）および転送設定ファイル（forward）が作成されます。

戻り値

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

jbs_spmd（UNIX限定）

機能

イベントサービス以外のJP1/Baseのプロセスを起動します。イベントサービス以外で障害が発生した場合，イベントサービスを終了する必要はありません。jbs_spmd_stopコマンドを使って，イベントサービス以外のJP1/Baseのプロセスを終了し，このコマンドで再起動します。イベントサービス以外のJP1/Baseプロセスの終了については，jbs_spmd_stopコマンドを参照してください。

形式

jbs_spmd [-h 論理ホスト名]
        [-HA]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，起動する論理ホスト名を指定します。指定できる文字数は，1～255（バイト）です。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-HA

クラスタシステムで，プロセス管理の対象プロセスが一つでも異常終了した場合に，プロセス管理を終了させたいときに指定します。

注意事項

このコマンドによって，JP1/Baseのプロセスが起動したかどうか確認する場合は，jbs_spmd_statusコマンドを実行してください。

同一ホスト上で，jbs_spmdコマンドを同時に複数実行することはできません。

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/Baseのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

戻り値

0 | 正常終了
0以外の値 | 異常終了

jbs_spmd_reload

機能

イベントサービス以外のJP1/Baseのプロセスを再読み込みします。

形式

jbs_spmd_reload [-h 論理ホスト名]
               [-t 時間（秒）]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，再読み込みしたい論理ホスト名を指定します。指定できる文字数は，1～255（バイト）です。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-t 時間（秒）

jbs_spmd_reloadコマンドの実行終了を待つ時間を指定します。指定できる値は，0～32,767（秒）です。指定した時間内にjbs_spmd_reloadコマンドの実行が終わらない場合，jbs_spmd_reloadコマンドの実行が失敗したと見なします。省略した場合は，60秒が設定されます。

注意事項

イベントサービスの環境設定は再読み込みされません。イベントサービスの環境設定の変更を反映するには，イベントサービスの再起動が必要です。

同一ホスト上で，jbs_spmd_reloadコマンド，jbs_spmd_statusコマンド，jbs_spmd_stopコマンドを同時に複数実行することはできません。

JP1/IM - Viewなどのビューアーからログイン中に，認証サーバホストでjbs_spmd_reloadコマンドを実行すると，ログイン認証が無効になります。このような場合には，再度ログインしてください。

戻り値

0 | 正常終了
0以外の値 | 異常終了

jbs_spmd_status

機能

イベントサービス以外のJP1/Baseの管理するプロセス群が起動または終了しているかどうかを確認します。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合

jbssessionmgr

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

認証サーバが設定されていない場合

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

JP1/Baseの管理するプロセスについては，「付録B　プロセス一覧」を参照してください。

形式

jbs_spmd_status [-h 論理ホスト名]
               [-t 時間（秒）]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，JP1/Baseの管理するプロセス群が起動または終了しているかどうか確認したい論理ホスト名を指定します。指定できる文字数は，1～255（バイト）です。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-t 時間（秒）

jbs_spmd_statusコマンドの実行終了を待つ時間を指定します。指定できる値は，0～32,767（秒）です。指定した時間内にjbs_spmd_statusコマンドの実行が終わらない場合，jbs_spmd_statusコマンドの実行が失敗したと見なします。省略した場合は，60秒が設定されます。

注意事項

同一ホスト上で，jbs_spmd_statusコマンド，jbs_spmd_reloadコマンド，jbs_spmd_stopコマンドを同時に複数実行することはできません。

戻り値

0 | すべてのプロセスが起動している
1 | プロセス管理との通信などでエラーが発生した，またはクラスタシステムで運用している場合に共有フォルダ（共有ディレクトリ）がマウントされていない
4 | 一部のプロセスが起動している
8 | すべて停止している
12 | 要求処理中，またはタイムアウトした（リトライできます）

jbs_spmd_stop

機能

イベントサービス以外のJP1/Baseのプロセスを終了します。イベントサービス以外で障害が発生した場合，イベントサービスを終了しないでJP1/Baseのプロセスを終了したい場合に便利です。再起動についてはjbs_spmdコマンドを参照してください。

形式

jbs_spmd_stop [-h 論理ホスト名]
             [-kill]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，プロセスを終了する論理ホスト名を指定します。指定できる文字数は，1～255（バイト）です。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-kill

このオプションを指定すると，強制終了を実行します。

注意事項

JP1/Baseのプロセスが終了したかどうか確認する場合は，jbs_spmd_statusコマンドを実行してください。

このコマンドでは，ログファイルトラップ管理デーモンは終了しません。ログファイルトラップ管理デーモンを終了する場合は，このコマンドを実行したあと，jevlogdstopコマンドを実行してください。

同一ホスト上で，jbs_spmd_stopコマンド，jbs_spmd_reloadコマンド，jbs_spmd_statusコマンドを同時に複数実行することはできません。

戻り値

0 | 正常終了
0以外の値 | 異常終了

jbs_start（UNIX限定）

機能

JP1/Base（イベントサービス，ユーザー管理機能を含むプロセス管理機能，およびログファイルトラップ管理デーモン）を起動します。

このコマンドを使って，JP1/Baseを自動起動させるには，JP1/Baseのインストールとセットアップの完了後，次に示す操作が必要です。

cd /etc/opt/jp1base
cp -p jbs_start.model jbs_start

形式

jbs_start

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1base/

注意事項

JP1/Baseのプロセス群に起動要求を出したあと，戻り値0で終了します。プロセス群が正しく起動したかどうかは，jbs_startコマンドの終了後，jbs_spmd_statusコマンドで確認してください。

Linuxの場合，標準設定でコアファイル出力時の最大サイズが「0」となっていることがあります。この場合，コアダンプは出力されません。このため，コアダンプが出力できるように，jbs_startスクリプトおよびjbs_start.clusterスクリプトは，標準で次のように設定されています。

if [ 'uname' = Linux ]; then
ulimit -c unlimited
fi

この設定がご使用マシンのセキュリティポリシーに反する場合は，次のように行の先頭に「#」を付けてコメント行に変更してください。

#if [ 'uname' = Linux ]; then
#ulimit -c unlimited
#fi

コメント行に変更すると，ファイルの設定は無効になります。ただし，JP1/Baseのプロセスのセグメンテーション障害やバス障害などのコアダンプ出力契機にコアダンプが出力されないため，調査ができないことがあります。

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/Baseのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

戻り値

0 | 正常終了
1 | 引数が二つ以上指定されている

jbs_start.cluster（UNIX限定）

機能

クラスタシステムでJP1/Base（イベントサービス，ユーザー管理機能を含むプロセス管理機能，およびログファイルトラップ管理デーモン）を起動します。このコマンドを実行する場合は，クラスタソフトにこのコマンドを登録する必要があります。

このコマンド内では，次に示すコマンドを実行しています。

jevstart 論理ホスト名

jbs_spmd -h 論理ホスト名

形式

jbs_start.cluster 論理ホスト名

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1base/

引数

論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。

注意事項

JP1/Baseのプロセス群に起動要求を出したあと，戻り値0で終了します。プロセス群が正しく起動したかどうかは，jbs_start.clusterコマンドの終了後，jbs_spmd_statusコマンドで確認してください。

Linuxの場合，標準設定でコアファイル出力時の最大サイズが「0」となっていることがあります。この場合，コアダンプは出力されません。このため，コアダンプが出力できるように，jbs_startスクリプトおよびjbs_start.clusterスクリプトは，標準で次のように設定されています。

if [ 'uname' = Linux ]; then
ulimit -c unlimited
fi

この設定がご使用マシンのセキュリティポリシーに反する場合は，次のように行の先頭に「#」を付けてコメント行に変更してください。

#if [ 'uname' = Linux ]; then
#ulimit -c unlimited
#fi

コメント行に変更すると，ファイルの設定は無効になります。ただし，JP1/Baseのプロセスのセグメンテーション障害やバス障害などのコアダンプ出力契機にコアダンプが出力されないため，調査ができないことがあります。

jbs_start.clusterコマンドを実行すると，ログファイルトラップ管理デーモンがすでに起動しているというメッセージが出力されることがあります。このメッセージを出力させたくない場合は，jbs_start.clusterスクリプトを変更してください。なお，09-50以降のJP1/Baseを新規インストールした場合は，変更する必要はありません。

jbs_start.clusterスクリプトは，標準で次のように設定されています。
## Start services
echo "Please wait a minutes, now starting JP1/Base..."
if [ "$LHHOST" ]; then
       /opt/jp1base/bin/jevstart ${LHHOST}
       /opt/jp1base/bin/jevlogdstart
else
       /opt/jp1base/bin/jevstart
       /opt/jp1base/bin/jevlogdstart
fi

次のように変更してください。

## Start services
echo "Please wait a minutes, now starting JP1/Base..."
if [ "$LHHOST" ]; then
       /opt/jp1base/bin/jevstart ${LHHOST}
       /opt/jp1base/bin/jevlogdstat >/dev/null 2>/dev/null
       if [ $? -ne 0 ]; then
           /opt/jp1base/bin/jevlogdstart
       fi
else
       /opt/jp1base/bin/jevstart
       /opt/jp1base/bin/jevlogdstart
fi

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/Baseのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

戻り値

0 | 正常終了
1 | 引数が二つ以上指定されている

jbs_stop（UNIX限定）

機能

JP1/Base（イベントサービスやユーザー管理を含むプロセス管理機能）を終了します。

このコマンドを使って，JP1/Baseを自動終了させるには，JP1/Baseのインストールとセットアップの完了後，次に示す操作が必要です。

cd /etc/opt/jp1base
cp -p jbs_stop.model jbs_stop

形式

jbs_stop

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1base/

注意事項

ログファイルトラップ管理デーモンは，物理ホスト，論理ホスト共通のデーモンのため，jbs_stopコマンドでは，ログファイルトラップ管理デーモンを終了できません。jbs_stopコマンドの実行後，jevlogdstopコマンドを実行すれば，ログファイルトラップ管理デーモンを終了できますが，論理ホストでログファイルトラップ管理デーモンを利用していた場合，論理ホスト用のログファイルトラップが使用できなくなります。jevlogdstopコマンドを実行する場合は，論理ホストでログファイルトラップを使用していないか十分に確認してください。

JP1/Baseのプロセス群に停止要求を出したあと，戻り値0で終了します。プロセス群が正しく停止したかどうかは，jbs_stopコマンドの終了後，jbs_spmd_statusコマンドで確認してください。

戻り値

0 | 正常終了
1 | 引数が二つ以上指定されている

jbs_stop.cluster（UNIX限定）

機能

クラスタシステムでJP1/Base（イベントサービスやユーザー管理機能を含むプロセス管理機能）を終了します。このコマンドを実行する場合は，クラスタソフトにこのコマンドを登録する必要があります。

なお，このコマンド内では，次に示すコマンドを実行しています。

jevstop 論理ホスト名

jbs_spmd_stop -h 論理ホスト名

形式

jbs_stop.cluster 論理ホスト名

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1base/

引数

論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。

注意事項

ログファイルトラップ管理デーモンは，物理ホスト，論理ホスト共通のデーモンのため，jbs_stop.clusterコマンドでは，ログファイルトラップ管理デーモンを終了できません。jbs_stop.clusterコマンドの実行後，jevlogdstopコマンドを実行すれば，ログファイルトラップ管理デーモンを終了できますが，物理ホストでログファイルトラップ管理デーモンを利用していた場合，物理ホスト用のログファイルトラップが使用できなくなります。jevlogdstopコマンドを実行する場合は，物理ホストでログファイルトラップを使用していないか十分に確認してください。

JP1/Baseのプロセス群に停止要求を出したあと，戻り値0で終了します。プロセス群が正しく停止したかどうかは，jbs_stop.clusterコマンドの終了後，jbs_spmd_statusコマンドで確認してください。

停止処理時にも監視処理を行うクラスタシステムでは，JP1/Base（イベントサービスやユーザー管理機能を含むプロセス管理機能）を終了するコマンドを下記の手順で変更してください。

cd /etc/opt/jp1base
cp -p jbs_stop.cluster.retry.model jbs_stop.cluster

戻り値

0 | 正常終了
1 | 引数が二つ以上指定されている

jbsacllint

機能

認証サーバに登録されている，JP1ユーザーの操作権限に関する定義情報を整理して，標準出力で出力します。定義情報とは，アクセス権限レベルファイル（JP1_AccessLevel）およびユーザー権限レベルファイル（JP1_UserLevel）を表します。

形式

jbsacllint [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

注意事項

定義情報を表示させたい認証サーバ上でこのコマンドを実行してください。

戻り値

0 | 正常終了
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
32 | 通信機能の初期化中にエラーが発生した
128 | 内部処理で矛盾を生じた（C++の例外）
255 | そのほかのエラー

jbsaclreload

機能

JP1ユーザーの操作権限に関する定義情報を認証サーバに再読み込みさせ，反映させます。定義情報とは，アクセス権限レベルファイル（JP1_AccessLevel）およびユーザー権限レベルファイル（JP1_UserLevel）を表します。

形式

jbsaclreload [-h 論理ホスト名]
            [-s 認証サーバ名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている，JP1ユーザーの操作権限に関する定義情報を再読み込みします。

-s 認証サーバ名

JP1ユーザーの操作権限に関する定義情報を再読み込みしたい認証サーバを指定します。このオプションを指定した場合，-hオプションは無視されます。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して指定された認証サーバの操作権限に関する定義情報を再読み込みします。

戻り値

0 | 正常終了
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
8 | 認証サーバが未起動または応答しない
16 | 認証サーバ側の処理でエラーが発生した
32 | 通信機能の初期化中にエラーが発生した
128 | 内部処理で矛盾を生じた（C++の例外）
255 | そのほかのエラー

jbsadduser

機能

JP1ユーザーを登録します。このコマンドは，自ホストを認証サーバとして使用する場合に使用します。このコマンドを実行すると，登録するJP1ユーザーに対するパスワードの入力が促されます。-pオプションを指定した場合は，パスワードの入力は促されずに指定したパスワードが登録されます。-dsオプションを指定した場合は，パスワードを入力しないで連携ユーザーを登録できます。

形式

jbsadduser [-h 論理ホスト名]
          [-s 認証サーバ名]
          [-p パスワード | -ds※]
           JP1ユーザー名

注※

-dsオプションは，Windows（Windows Server 2003（IPF）およびWindows Vistaを除く）だけで使用できます。

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバにJP1ユーザーを登録します。

-s 認証サーバ名

JP1ユーザーを登録したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-p パスワード

標準ユーザーのパスワードを指定します。大文字と小文字は区別されます。パスワードに指定できる文字数は，6～32（バイト）です。また，パスワードに使用できる文字は，¥ " :とタブ・スペースを除くASCII文字だけです。このオプションを指定した場合，パスワードの入力は促されずに指定したパスワードが登録されます。

-ds

このオプションは，Windows（Windows Server 2003（IPF）およびWindows Vistaを除く）だけで使用できます。

連携ユーザーを登録する場合に指定します。このオプションを指定して登録したJP1ユーザーがログインするときは，ディレクトリサーバが管理しているパスワードを入力してください。

JP1ユーザー名

JP1ユーザーとして登録したいユーザー名を指定します。JP1ユーザー名には，小文字しか使用できません。指定できる文字数は，1～31（バイト）です。また，JP1ユーザー名に使用できる文字は，* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < >とタブ・スペースを除くASCII文字だけです。

注意事項

-hオプションによる論理ホスト名の指定，および-sオプションによる認証サーバ名の指定は，JP1ユーザー名の前に指定してください。

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して指定された認証サーバにJP1ユーザーを登録します。

戻り値

0 | 正常終了
1 | ユーザーは登録済み
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
8 | 認証サーバが未起動または応答しない
16 | 認証サーバ側の処理でエラーが発生した
24 | 不正なパスワード
32 | 通信機能の初期化中にエラーが発生した
128 | 内部処理で矛盾を生じた（C++の例外）
255 | そのほかのエラー

jbsadmin（Windows Vista限定）

機能

JP1/Base管理者コンソールを起動します。JP1/Base管理者コンソールでは，JP1/Baseが提供する管理者権限が必要なコマンドを実行できます。

形式

jbsadmin

実行権限

Administrators権限

格納先ディレクトリ

インストール先フォルダ¥bin¥

jbsblockadesrv

機能

指定した認証サーバへの接続を閉塞状態にします。

形式

jbsblockadesrv [-h 論理ホスト名]
               -s 認証サーバ名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，接続先認証サーバを設定している論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-s 認証サーバ名

閉塞状態にしたい認証サーバ名を指定します。

戻り値

0 | 認証サーバを閉塞状態にした
1 | 認証サーバはすでに閉塞状態になっている
17 | 指定された認証サーバは閉塞状態にできない
0，1，17以外 | 異常終了

使用例

プライマリー認証サーバがserver1，セカンダリー認証サーバがserver2で，jbsblockadesrvコマンドを実行してserver2を閉塞状態にすると，次のように表示されます。

jbsblockadesrv -s server2
プライマリー:server1
セカンダリー:server2:閉塞中

jbscancellcact

機能

実行待ちおよび実行中のローカルアクションをキャンセルします。実行中のコマンドをキャンセルした場合，実行プロセスと子プロセスもキャンセルします。

形式

jbscancellcact [-h 論理ホスト名]
             アクション番号

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

アクション番号

キャンセルしたいローカルアクションのアクション番号を指定します。jbslistlcactコマンドで表示される一覧からアクション番号がわかります。

戻り値

0 | 正常終了
1 | 指定されたアクションは実行待ちまたは実行中として存在しない
255 | そのほかのエラー

jbschgds（Windows限定）

機能

連携するディレクトリサーバを一時的に変更します。このコマンドは，ディレクトリサーバ連携機能を設定した認証サーバ上で実行してください。

形式

jbschgds [-h 論理ホスト名]
        {-f 定義ファイル | -d}

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

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

-f 定義ファイル

ディレクトリサーバ変更ファイルを指定します。定義ファイルの格納場所および名称は任意です。ディレクトリサーバ変更ファイルについては，「14.　定義ファイル」の「ディレクトリサーバ変更ファイル（Windows限定）」を参照してください。

-d

連携するディレクトリサーバの一時的な変更を解除するときに指定します。

戻り値

0 | 正常終了
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
64 | 実行権限がない
128 | 内部処理で矛盾を生じた（C++の例外）
255 | その他のエラー

jbschgpasswd

機能

登録済みのJP1ユーザーのパスワードを変更します。このコマンドを実行すると，以前設定したパスワードと新しく設定するパスワードの入力が促されます。パスワードに指定できる文字数は，6～32（バイト）で，新旧のパスワードが同一であってもかまいません。

形式

jbschgpasswd [-h 論理ホスト名]
            [-s 認証サーバ名]
            [-op 旧パスワード -np 新パスワード]
             JP1ユーザー名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバに登録されたJP1ユーザーのパスワードを変更します。

-s 認証サーバ名

JP1ユーザーのパスワードを変更したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-op 旧パスワード

変更したい旧パスワードを指定します。-npオプションと同時に指定してください。-opオプションと-npオプションを指定すると，パスワードの入力が促されずに，-npオプションで指定したパスワードが登録されます。

-np 新パスワード

新しいパスワードを指定します。-opオプションと同時に指定してください。

JP1ユーザー名

パスワードを変更したいJP1ユーザー名を指定します。

注意事項

-hオプションによる論理ホスト名の指定，および-sオプションによる認証サーバ名の指定は，JP1ユーザー名の前に指定してください。

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストの認証サーバに登録されたJP1ユーザーのパスワードを変更します。

戻り値

0 | 正常終了
1 | ユーザーが存在しない，旧パスワード誤りまたは連携ユーザーのパスワードを変更しようとした
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
8 | 認証サーバが未起動または応答しない
16 | 認証サーバ側の処理でエラーが発生した
24 | 不正なパスワード
32 | 通信機能の初期化中にエラーが発生した
128 | 内部処理で矛盾を生じた（C++の例外）
255 | そのほかのエラー

jbschkds（Windows限定）

機能

ディレクトリサーバ連携機能を使用しているときに，ディレクトリサーバ連携機能の設定内容，ディレクトリサーバへの接続結果およびユーザー認証結果を表示します。表示する内容を次に示します。

ディレクトリサーバ連携機能が有効かどうか

ディレクトリサーバ名

ポート番号

SSLを使用するかどうか

識別名

ディレクトリサーバへの接続結果

ユーザー認証結果

このコマンドは，ディレクトリサーバ連携機能を設定した認証サーバ上で実行してください。

形式

jbschkds [-h 論理ホスト名]
        [-u JP1ユーザー名 -p パスワード]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

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

-u JP1ユーザー名

ディレクトリサーバで認証するJP1ユーザー名を指定します。

-p パスワード

-uオプションで指定したユーザーのパスワードを指定します。

戻り値

0 | 正常終了
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
64 | 実行権限がない
128 | 内部処理で矛盾を生じた（C++の例外）
255 | その他のエラー

使用例

出力例を次に示します。

ディレクトリサーバ連携機能が無効のとき

>jbschkds
ディレクトリサーバ連携機能は無効です

ディレクトリサーバ連携機能が有効でユーザー認証に成功したとき

>jbschkds -u jp1user -p password
ディレクトリサーバの設定内容を表示します
 ディレクトリサーバ名 host-A
 ポート番号 636
 SSL 使用する
 識別名 CN=jp1user,CN=Users,DC=netmanage,DC=local
ディレクトリサーバに接続できました
認証に成功しました

ディレクトリサーバ連携機能が有効でディレクトリサーバに接続できないとき

>jbschkds
ディレクトリサーバの設定内容を表示します
 ディレクトリサーバ名 host-A
 ポート番号 636
 SSL 使用する
KAVA5810-E ディレクトリサーバに接続できませんでした
サーバがダウンしています

jbsgetcnf

機能

共通定義情報の内容をすべて採取します。このコマンドを実行すると，共通定義情報を読み出し，標準出力に出力します。

形式

jbsgetcnf [-h 論理ホスト名] > 退避ファイル名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，定義情報を採取したい論理ホスト名を指定します。このオプションを省略した場合，物理ホスト名が仮定されます。

なお，このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため，クラスタシステムで使用する場合には論理ホスト名を必ずこのオプションで指定してください。このオプション以外の誤った引数を指定した場合は，誤った引数以降はすべて無視します。

退避ファイル名

共通定義情報を退避するファイル名を指定します。

戻り値

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

jbsgetopinfo

機能

稼働情報を採取し，定義ファイルの記述形式に変換して標準出力に出力します。稼働情報として採取できるのは，イベント転送の定義情報，ログファイルトラップの定義情報，およびイベントログトラップの定義情報です。

形式

jbsgetopinfo [-h 論理ホスト名]
            [-o 稼働情報名，...]
            [-i ID番号 | -a 監視名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

-o 稼働情報名，...

採取したい稼働情報名を指定します。このオプションを省略した場合，すべての稼働情報名を指定したと仮定されます。複数の稼働情報名を指定する場合，「,」で区切って指定します。

指定できる稼働情報名を次に示します。

forward
稼働している転送設定ファイルの定義情報を出力します。転送設定ファイルの記述形式については，「14.　定義ファイル」の「転送設定ファイル」を参照してください。

logtrap
稼働しているログファイルトラップ動作定義ファイルの定義情報を出力します。稼働情報を採取したいホストが論理ホストの場合，物理ホストの稼働情報を採取します。ログファイルトラップ動作定義ファイルの記述形式については，「14.　定義ファイル」の「ログファイルトラップ動作定義ファイル」を参照してください。

evttrap
稼働しているイベントログトラップ動作定義ファイルの定義情報を出力します。稼働情報を採取したいホストが論理ホストの場合，物理ホストの稼働情報を採取します。この稼働情報名は，Windowsの場合にだけ指定できます。イベントログトラップ動作定義ファイルの記述形式については，「14.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」を参照してください。

-i ID番号 | -a 監視名

このオプションは，稼働情報名にlogtrapを指定した場合にだけ指定できます。ID番号には，稼働情報を採取したいログファイルトラップのID番号を指定します。監視名には，稼働情報を採取したいログファイルトラップの監視名を指定します。ID番号と監視名のどちらか一方を指定します。稼働情報名にlogtrapを指定して，このオプションを省略した場合は，稼働しているすべてのログファイルトラップの定義情報が採取されます。

注意事項

指定した稼働情報名の定義情報が存在しない場合，エラーになります。複数の稼働情報名を指定した場合は，存在する定義情報を出力します。

指定したID番号または監視名のログファイルトラップが存在しない場合，ログファイルトラップの定義情報は出力されません。

戻り値

0 | 正常終了
1 | 引数エラー
2 | 稼働情報なし
248 | 稼働情報ファイルが壊れている
249 | 指定した論理ホスト名が存在しない
250 | リロード未反映
251 | 他でアクセス中
252 | 実行権限なし
253 | UACエラー
254 | メモリー不足
255 | そのほかのエラー

jbsgetumap

機能

登録済みのユーザーマッピング情報の一覧を表示します。

このコマンドを実行すると，登録済みのユーザーマッピング情報を読み込み，jbsmkumapコマンドで登録したユーザーマッピング定義ファイル（jp1BsUmap.conf）の形式で標準出力に出力します。

形式

jbsgetumap [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，ユーザーマッピング情報の一覧を表示したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

戻り値

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

jbshostsexport

機能

共通定義情報に登録されたjp1hosts情報を採取し，標準出力に出力します。

形式

jbshostsexport [-h 論理ホスト名] > jp1hosts定義ファイル名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

jp1hosts定義ファイル名

jp1hosts情報を採取するファイル名を指定します。

戻り値

0 | 正常終了
1 | メッセージ処理エラー
2 | コマンド引数エラー
3 | 権限チェックエラー
4 | 共通定義エラー

jbshostsimport

機能

jp1hosts情報を共通定義情報に登録します。

形式

jbshostsimport { {-o|-r} jp1hosts定義ファイル名 | -d }
              [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

{-o|-r} jp1hosts定義ファイル名

共通定義情報に登録したいjp1hosts情報を定義したファイル名を指定します。-oオプションを指定した場合は，共通定義情報に登録済みのjp1hosts情報を削除しないで新規にjp1hosts情報を登録します（同一ホストが存在した場合は上書きします）。-rオプションを指定した場合は，共通定義情報に登録済みのjp1hosts情報をすべて削除してからjp1hosts情報を登録します。jp1hosts定義ファイルの記述形式については，「14.　定義ファイル」の「jp1hosts定義ファイル」を参照してください。

-d

共通定義情報に登録されたjp1hosts情報を削除したい場合に指定します。

-h 論理ホスト名

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

注意事項

JP1/Baseを起動しているときは，このコマンドを使用しないでください。

戻り値

0 | 正常終了
1 | メッセージ処理エラー
2 | コマンド引数エラー
3 | 権限チェックエラー
4 | 共通定義エラー
5 | 文法エラー
6 | ファイル I/Oエラー

jbslistacl

機能

登録済みのJP1ユーザーの操作権限を表示します。

形式

jbslistacl [-h 論理ホスト名]
          [-s 認証サーバ名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバに登録されているJP1ユーザーの操作権限が表示されます。

-s 認証サーバ名

登録済みJP1ユーザーの操作権限を表示したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストの認証サーバの登録済みJP1ユーザーが表示されます。

戻り値

0 | 正常終了
1 | 認証サーバにユーザーが登録されていない
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
8 | 認証サーバが未起動または応答しない
16 | 認証サーバ側の処理でエラーが生じた
32 | 通信機能の初期化中にエラーが生じた
128 | 内部処理で矛盾を生じた（C++の例外）
255 | そのほかのエラー

jbslistlcact

機能

実行待ちおよび実行中のローカルアクションの一覧を表示します。

形式

jbslistlcact [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

戻り値

0 | 正常終了
1 | 実行待ちおよび実行中のアクションがない
255 | そのほかのエラー

出力例

jbslistlcactコマンドを実行して出力される例を次に示します。

act-No      act-Name      Status      Command
1122        JOB10         実行中      abc.exe
1334        JOB22         実行待ち    xyz.bat

act-Noにはアクション番号，act-Nameにはアクション名，Statusにはアクションの実行状態，Commandにはコマンドの先頭文字列が出力されます。コマンドに属性変数名が指定されている場合，展開して出力されます。

jbslistsrv

機能

共通定義情報に設定されている接続先認証サーバを画面に表示します。

形式

jbslistsrv [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，接続先認証サーバを設定している論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

戻り値

0 | 正常終了
0以外 | 異常終了

使用例

使用例を次に示します。

（例1）

プライマリー認証サーバがserver1，セカンダリー認証サーバがserver2の場合に，jbslistsrvコマンドを実行すると，次のように表示されます。

jbslistsrv
プライマリー:server1
セカンダリー:server2

（例2）

プライマリー認証サーバがserver1，セカンダリー認証サーバがserver2でserver1が閉塞状態であった場合に，jbslistsrvコマンドを実行すると，次のように表示されます。

jbslistsrv
プライマリー:server1:閉塞中
セカンダリー:server2

（例3）

接続先認証サーバ（認証サーバ名：server1）を1台しか設定していなかった場合に，jbslistsrvコマンドを実行すると，次のように表示されます。

jbslistsrv
プライマリー:server1

jbslistuser

機能

登録済みJP1ユーザーの一覧を表示します。

形式

jbslistuser [-h 論理ホスト名]
           [-s 認証サーバ名]
           [-ld]
           [-ds※]

注※

-dsオプションは，Windows（Windows Server 2003（IPF）およびWindows Vistaを除く）だけで使用できます。

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバの登録済みJP1ユーザーが表示されます。

-s 認証サーバ名

登録済みJP1ユーザーを表示したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-ld

JP1ユーザーごとに最終更新日付（yyyy/mm/dd△HH:MM:SS形式）を出力します。最終更新日付は，JP1ユーザーを登録した日付またはパスワードを変更した日付です。なお，08-10へバージョンアップする前に登録されたJP1ユーザー，または新規インストールで初期設定されるJP1ユーザー，または連携ユーザーの最終更新日付はハイフン（----/--/-- --:--:--）で表示されます。［JP1/Base環境設定］ダイアログボックス，またはパスワード変更コマンド（jbschgpasswd）でパスワードを変更したあと，最終更新日付が表示されます。

-dsオプションを指定した場合は，このオプションの指定は無視されます。

-ds

このオプションは，Windows（Windows Server 2003（IPF）およびWindows Vistaを除く）だけで使用できます。

連携ユーザーだけを表示します。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストの認証サーバの登録済みJP1ユーザーが表示されます。

-ldオプションと-dsオプションを同時に指定した場合は，-dsオプションだけが有効になります。

戻り値

0 | 正常終了
1 | 認証サーバにユーザーが登録されていない
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
8 | 認証サーバが未起動または応答しない
16 | 認証サーバ側の処理でエラーが発生した
32 | 通信機能の初期化中にエラーが発生した
128 | 内部処理で矛盾を生じた（C++の例外）
255 | そのほかのエラー

使用例

標準ユーザーとしてjp1adminおよびjp1admin2，連携ユーザーとしてtestuser1を認証サーバに登録している場合の出力例を次に示します。

オプションを何も指定しないとき

>jbslistuser
jp1user account[0]:jp1admin
jp1user account[1]:jp1admin2
jp1user account[2]:testuser1
正常終了しました

-ldオプションを指定したとき

-dsオプションを指定したとき

>jbslistuser -ds
jp1user account[0]:testuser1
正常終了しました

標準ユーザーとしてjp1adminおよびjp1admin2を認証サーバに登録し，連携ユーザーとして何も登録していない場合の出力例を次に示します。

-dsオプションを指定したとき

>jbslistuser -ds
JP1ユーザーアカウントがありません
異常終了しました

jbsmkpass（Windows限定）

機能

パスワード管理情報を一括して登録します。このコマンドを実行すると，共通定義情報に登録されていたパスワード管理情報がいったんすべて削除され，パスワード定義ファイルに記述したパスワード管理情報が共通定義情報に一括登録されます。

形式

jbsmkpass [-h 論理ホスト名 ]
          -f パスワード定義ファイル

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，パスワード管理情報を登録する論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-f パスワード定義ファイル

パスワード管理情報を読み込みたいパスワード定義ファイルを指定します。パスワード定義ファイルに記述された文法をチェックし，書式に誤りがあった場合はエラーを返します。パスワード管理情報が正しい場合，共通定義情報にパスワード定義ファイルの内容を一括登録します。パスワード定義ファイルの記述形式については，「14.　定義ファイル」の「パスワード定義ファイル（Windows限定）」を参照してください。

注意事項

このコマンドを実行すると，共通定義情報に登録したパスワード管理情報がいったんすべて削除され，パスワード定義ファイルに記述したパスワード管理情報が共通定義情報に一括登録されます。登録済みパスワード管理情報を残したい場合は，パスワード定義ファイルに登録済みパスワード情報を記述してください。

Windowsでは，このコマンドを実行するOSユーザーおよびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。詳細については，「6.1.5　ユーザーマッピングを設定する前に」を参照してください。

戻り値

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

jbsmkumap

機能

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報を，共通定義情報に登録します。このコマンドを実行すると，共通定義情報に登録されていたマッピング情報がいったんすべて削除され，ユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報が共通定義情報に登録されます。ユーザーマッピング定義ファイル（jp1BsUmap.conf）の書式に誤りがあった場合，エラーを返します。

形式

jbsmkumap [-h 論理ホスト名]
         [-f ユーザーマッピング定義ファイル名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，ユーザーマッピング情報を登録する論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-f ユーザーマッピング定義ファイル名

マッピング情報を記述した定義ファイルのファイル名を指定します。このオプションを省略した場合は，初期設定のユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報を，共通定義情報に登録します。ユーザーマッピング定義ファイルの形式については，「14.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。

注意事項

このコマンドを実行すると，共通定義情報に登録されていたマッピング情報がいったんすべて削除され，マッピング定義ファイルの情報が共通定義情報に登録されます。登録済みのマッピング情報を残したい場合は，マッピング定義ファイルに登録済みマッピング情報を記述してください。

このコマンドで設定した内容を確認する場合は，jbsgetumapコマンドを使用してください。

戻り値

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

jbspassmgr（Windows限定）

機能

［パスワード管理］ダイアログボックスを表示します。［パスワード管理］ダイアログボックスでは，次の操作ができます。

新規ユーザーの登録

パスワードの変更

登録ユーザーの削除

なお，登録または削除するユーザーは，OSに登録されているユーザーです。

形式

jbspassmgr

実行権限

Administrators権限

格納先ディレクトリ

インストール先フォルダ¥bin¥

注意事項

Windowsでは，このコマンドを実行するOSユーザーおよびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。詳細については，「6.1.5　ユーザーマッピングを設定する前に」を参照してください。

jbsrmacl

機能

指定したJP1ユーザーに設定されている操作権限をすべて削除します。

形式

jbsrmacl [-h 論理ホスト名]
        [-s 認証サーバ名]
         -u JP1ユーザー名
        [-i]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，JP1ユーザーの操作権限を削除したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-s 認証サーバ名

操作権限を削除したい認証サーバ名を指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-u JP1ユーザー名

操作権限を削除したいJP1ユーザー名を指定します。

-i

このオプションを指定すると，指定したJP1ユーザーの操作権限を削除する前に確認メッセージを表示します。メッセージに対して「y」または「Y」を指定した場合だけ削除処理を実行します。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して操作権限を登録します。

戻り値

0 | 正常終了
1 | 認証サーバにユーザーが登録されていない
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
8 | 認証サーバが未起動または応答しない
16 | 認証サーバ側の処理でエラーが生じた
32 | 通信機能の初期化中にエラーが生じた
128 | 内部処理で矛盾を生じた（C++例外の場合）
255 | そのほかのエラー

jbsrmumap

機能

共通定義情報からユーザーマッピング情報を個別に削除します。

形式

jbsrmumap [-h 論理ホスト名]
         {-u JP1ユーザー名 | -ua}
         [-sh サーバホスト名 | -sha]
         [-i]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，ユーザーマッピング情報を削除したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-u JP1ユーザー名

ユーザーマッピング情報を削除したいJP1ユーザー名を指定します。

-ua

JP1ユーザー名に「*」を指定したマッピング情報を削除する場合に指定します。

-sh サーバホスト名

-uオプションに指定するJP1ユーザーに設定されているサーバホスト名を指定します。このオプションを省略した場合，-uオプションに指定したJP1ユーザーのマッピング情報がすべて削除されます。-shaオプションと同時に指定しないでください。

-sha

-uオプションに指定するJP1ユーザーのサーバホスト名に，「*」が指定されているマッピング情報を削除します。-shオプションと同時に指定しないでください。

-i

このオプションを指定すると，ユーザーマッピング情報を削除する前に確認メッセージを表示します。メッセージに対して「y」または「Y」を指定した場合だけ削除処理を実行します。

戻り値

0 | 正常終了
1 | 引数誤り
2 | コマンド実行ユーザーに権限がない
5 | 共通定義アクセスエラー
6 | メモリーなどシステムリソースが不足した
10 | 共通定義ロック取得エラー
255 | そのほかのエラー

jbsrmumappass（Windows限定）

機能

JP1/Baseのパスワード管理情報に登録されているOSユーザーを個別に削除します。

形式

jbsrmumappass [-h 論理ホスト名]
              -u OSユーザー名

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

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

-u OSユーザー名

パスワード管理情報から削除したいOSユーザー名を指定します。

戻り値

0 | 正常終了
0以外 | 異常終了

jbsrmuser

機能

JP1ユーザーを削除します。

形式

jbsrmuser [-i]
         [-h 論理ホスト名]
         [-s 認証サーバ名]
          JP1ユーザー名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-i

このオプションを指定すると，指定したJP1ユーザー名を削除する前に確認メッセージを表示します。メッセージに対して「y」または「Y」を指定した場合だけ削除処理を実行します。

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバのJP1ユーザーを削除します。

-s 認証サーバ名

JP1ユーザーを削除したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

JP1ユーザー名

削除したいJP1ユーザー名を指定します。

注意事項

-hオプションによる論理ホスト名の指定，および-sオプションによる認証サーバ名の指定は，JP1ユーザー名の前に指定してください。

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して指定された認証サーバのJP1ユーザーを削除します。

戻り値

0 | 正常終了
1 | ユーザーは削除済み
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
8 | 認証サーバが未起動または応答しない
16 | 認証サーバ側の処理でエラーが発生した
32 | 通信機能の初期化中にエラーが発生した
128 | 内部処理で矛盾を生じた（C++の例外）
255 | そのほかのエラー

jbsrt_del

機能

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

形式

jbsrt_del [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

戻り値

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

jbsrt_distrib

機能

マネージャーホスト（JP1/IM - Managerインストールホスト）で実行するコマンドです。

構成定義ファイルに定義した情報を，コマンドを実行したホストの下位にあるホストに配布し，定義を有効にします。

すでに構成定義が設定されている場合は，既存の構成定義情報を削除してから，構成定義を配布します。

このコマンドを実行するときには，構成定義を配布する全ホストで，JP1/Baseが起動している必要があります。配布先のホストで，JP1/Baseが起動していなかった場合，そのホストへは構成定義が配布されません。この場合，コマンドの実行時に，構成情報を設定できないというメッセージが出力されます。そのまま処理を続行すると，残りのホストには定義が配布されます。定義を配布できなかったホストへ構成情報を配布するには，そのホストのJP1/Baseを起動してから，再度jbsrt_distribコマンドを実行します。構成情報を削除しますか，というメッセージが出力されるので「N」を入力し，定義を配布します。これで，システム全体への定義配布が完了します。

このコマンドが参照する構成定義ファイルは，次のファイルです。

Windowsの場合

インストール先フォルダ¥conf¥route¥jbs_route.conf
共有フォルダ¥jp1base¥conf¥route¥jbs_route.conf（-hオプション指定時）

UNIXの場合

/etc/opt/jp1base/conf/route/jbs_route.conf
共有ディレクトリ/jp1base/conf/route/jbs_route.conf（-hオプション指定時）

定義ファイルの形式については，マニュアル「JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス」を参照してください。

形式

jbsrt_distrib [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

注意事項

システムの運用中に構成情報を削除すると，削除してから配布完了するまでの間に，次の問題が発生するおそれがあります。

イベントの転送に失敗する

コマンドの実行に失敗する

自動アクションの実行に失敗する

システムの運用中に管理対象ホストを追加する場合，削除するホストがないときは，次の手順で，構成情報を削除しないで構成定義を配布してください。既存の構成情報に影響を与えないで，システム構成を変更できます。

構成情報を削除しますか，というメッセージが出力されたら，「N」を入力します。

構成定義を配布してもよろしいですか，というメッセージが出力されたら，「Y」を入力します。

戻り値

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

jbsrt_get

機能

このコマンドを実行したホストの構成定義情報を表示します。

なお，クラスタシステムの待機系ホストで-hオプションを指定してこのコマンドを実行すると，定義情報が表示されません。この場合は，実行系ホストでコマンドを再実行してください。

形式

jbsrt_get [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

戻り値

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

出力例

このコマンドの出力例を次に示します。

** 構成定義情報 **

上位ホスト : parent_host
自ホスト　 : myhost
下位ホスト : child_host1
　　　　　 : child_host2
　　　　　 : [child_host1]
　　　　　 : child_host3

jbsrt_sync

機能

マネージャーホスト（JP1/IM - Managerインストールホスト）で実行するコマンドです。

下位のホストから構成定義情報を収集し，システム内の構成定義を更新します。システム構成定義を分割して定義したあとに，このコマンドを実行します。

形式

jbsrt_sync [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

戻り値

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

jbssetacl

機能

JP1ユーザーの操作権限を個別に登録します。

形式

jbssetacl [-h 論理ホスト名]
         [-s 認証サーバ名]
          -f 定義ファイル名
         [-no]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合，指定した論理ホストに設定されているプライマリー認証サーバに登録します。

-s 認証サーバ名

JP1ユーザーの操作権限を登録したい認証サーバを指定します。このオプションを省略した場合は，-hオプションの指定は無視されます。

-f 定義ファイル

JP1ユーザーの操作権限を記述した定義ファイルのファイル名を指定します。定義ファイルの形式は，ユーザー権限レベルファイル（JP1_UserLevel）の形式と同じです。定義ファイルは任意の名称および任意の場所に格納できます。ユーザー権限レベルファイルの形式については，「14.　定義ファイル」の「ユーザー権限レベルファイル」を参照してください。

-no

このオプションを指定すると，指定したJP1ユーザーに対してすでに操作権限が設定されていた場合，エラーを返し，そのJP1ユーザーの操作権限は登録されません。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して操作権限を登録します。

戻り値

0 | 正常終了
2 | 引数誤り
4 | メモリーなどシステムリソースが不足した
8 | 認証サーバが未起動または応答しない
16 | 認証サーバ側の処理でエラーが生じた
32 | 通信機能の初期化中にエラーが生じた
64 | ファイルフォーマットエラー
128 | 内部処理で矛盾を生じた（C++例外）
255 | そのほかのエラー

jbssetcnf

機能

指定した定義ファイル内の情報を共通定義情報に登録します。

形式

jbssetcnf 定義ファイル名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

定義ファイル名

共通定義情報に登録したい定義ファイルを指定します。定義ファイル名はフルパスで指定してください。

戻り値

0 | 正常終了（引数にファイル名を指定しなかった場合もこの値が返される）
-1 | 異常終了

jbssetumap

機能

共通定義情報にユーザーマッピング情報を個別に登録します。

形式

定義ファイルを使用する場合
jbssetumap [-h 論理ホスト名]
           -f 定義ファイル名
          [-no]
定義ファイルを使用しない場合
jbssetumap [-h 論理ホスト名]
          {-u JP1ユーザー名 | -ua}
          {-sh サーバホスト名 | -sha}
           -o OSユーザー名[,OSユーザー名...]
          [-no]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，ユーザーマッピング情報を登録したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-f 定義ファイル名

登録または変更したいマッピング情報を記述した定義ファイルのファイル名を指定します。定義ファイルの格納場所および名称は任意ですが，形式はユーザーマッピング定義ファイル（jp1BsUmap.conf）と同じにしてください。ユーザーマッピング定義ファイルの形式については，「14.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。

このオプションを指定した場合，-uオプション，-uaオプション，-shオプション，-shaオプションは指定できません。

-u JP1ユーザー名

マッピング情報を登録または変更したいJP1ユーザー名を指定します。-uaオプションと同時に指定できません。

-ua

JP1ユーザー名に「*」を指定します。認証サーバに登録されたすべてのJP1ユーザーにユーザーリストで指定した権限が与えられます。-uオプションと同時に指定できません。

-sh サーバホスト名

JP1ユーザーが操作命令を出すサーバホスト名を指定します。-shaオプションと同時に指定できません。

-sha

サーバホスト名に「*」を指定します。JP1ユーザーはすべてのサーバホストからの操作が有効になります。-shオプションと同時に指定できません。

-o OSユーザー名

JP1ユーザーにマッピングしたいOSユーザー名を指定します。「,」で区切ると複数のOSユーザーを指定できます。

-no

指定したJP1ユーザーに対してすでにマッピング情報が登録されていた場合，エラーとなり，そのJP1ユーザーのマッピング情報は登録されません。

注意事項

このコマンドで設定した内容を確認する場合は，jbsgetumapコマンドを実行してください。

戻り値

0 | 正常終了
1 | 引数誤り
2 | コマンド実行ユーザーに権限がない
3 | ユーザーマッピング定義ファイル読み込みエラー
4 | ユーザーマッピング定義ファイルの文法エラー
5 | 共通定義アクセスエラー
6 | メモリーなどシステムリソースが不足した
10 | 共通定義ロック取得エラー
255 | そのほかのエラー

jbssetupsrv（Windows限定）

機能

認証サーバ（プライマリー認証サーバおよびセカンダリー認証サーバ）を登録または削除するコマンドです。認証サーバを自ホストから他ホスト，またはその逆に設定を変更する場合には，認証サーバの起動設定の変更を行います。

形式

jbssetupsrv [-h 論理ホスト名]
           {プライマリー認証サーバ [セカンダリー認証サーバ] |
            -d [認証サーバ]}
           [-f]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，認証サーバを登録したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。指定できる文字数は，1～196（バイト）です。

プライマリー認証サーバ

通常時に利用する認証サーバ（プライマリー認証サーバ）を指定します。

セカンダリー認証サーバ

予備として稼働する認証サーバ（セカンダリー認証サーバ）を指定します。一つのユーザー認証圏内に認証サーバを2台設置する場合に指定してください。このオプションを省略した場合は，ユーザー認証圏内で稼働する認証サーバは1台だけとなります。

-d 認証サーバ名

認証サーバの登録を削除する場合に指定します。-dオプションだけを指定したときは，認証サーバをすべて削除します。

-f

認証サーバの起動設定を変更するために，JP1/Baseを強制的に再起動させるオプションです。JP1/Baseの起動中に，認証サーバを自ホストから他ホスト，またはその逆に変更する場合に指定します。

注意事項

セカンダリー認証サーバの登録時に，プライマリー認証サーバだけを削除した場合は，セカンダリー認証サーバがプライマリー認証サーバになります。

戻り値

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

jbssetusrsrv（UNIX限定）

機能

認証サーバ（プライマリー認証サーバおよびセカンダリー認証サーバ）を指定します。JP1/IMおよびJP1/AJSを使用する場合に使用します。

このコマンドは，次に示すホスト上で実行してください。

認証サーバとして使用するホスト

JP1/IM - Manager，JP1/AJS - Manager，JP1/AJS - Agentがインストールされたホスト

形式

jbssetusrsrv [-h 論理ホスト名]
             プライマリー認証サーバ
            [セカンダリー認証サーバ]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

プライマリー認証サーバ

通常時に利用する認証サーバ（プライマリー認証サーバ）を指定します。

セカンダリー認証サーバ

予備として稼働する認証サーバ（セカンダリー認証サーバ）を指定します。一つのユーザー認証圏内に認証サーバを2台設置する場合に指定してください。このオプションを省略した場合は，ユーザー認証圏内で稼働する認証サーバは1台だけとなります。

戻り値

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

jbsumappass（Windows限定）

機能

JP1/Baseのパスワード管理情報へ新規OSユーザーを登録します。また，登録されたOSユーザーのパスワードを変更することもできます。

形式

jbsumappass [-h 論理ホスト名]
            -u OSユーザー名
           [-p パスワード]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，新規OSユーザーを登録したい，または登録されたOSユーザーのパスワードを変更したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-u OSユーザー名

パスワード管理情報に登録したいOSユーザー名，またはパスワードを変更したい登録済みOSユーザー名を指定します。

OSユーザー名には，ユーザー名だけでなく，自ホストが所属するドメイン名やローカルホスト名も記述できます。ドメイン名やローカルホスト名を記述する場合，「domain¥user1」，「server¥user1」のように，ドメイン名やローカルホスト名とユーザー名の区切り文字として「¥」を使用します。ドメイン名を記述した場合，登録するOSユーザーがドメイン上のユーザーであるかどうかチェックされます。ドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。ローカルホスト名を記述した場合，登録するOSユーザーがローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，そのOSユーザー名では登録できません。

ドメイン名やローカルホスト名を記述しなかった場合，登録するOSユーザー名がローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，信頼するドメインを含むドメイン上のユーザーであるかどうかチェックされます。ローカルユーザーおよびドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。

なお，Windowsのドメインコントローラー上で登録する場合は，「ドメイン名¥ユーザー名」の形式で記述してください。ドメインコントローラー上ではドメインユーザーとローカルユーザーの区別がないため，ドメインユーザーとして扱われるためです。

-p パスワード

OSユーザーのパスワードを指定します。OSユーザーにパスワードがない場合は，このオプションを省略してください。

注意事項

Windowsでは，このコマンドを実行するOSユーザーおよびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。詳細については，「6.1.5　ユーザーマッピングを設定する前に」を参照してください。

戻り値

0 | OSユーザーのパスワードを変更した
1 | OSユーザーを登録した
0，1以外 | 異常終了

jbsunblockadesrv

機能

接続先認証サーバの閉塞状態を解除します。

形式

jbsunblockadesrv [-h 論理ホスト名]
                 -s 認証サーバ名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，接続先認証サーバを設定している論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-s 認証サーバ名

閉塞状態を解除したい認証サーバ名を指定します。

戻り値

0 | 認証サーバの閉塞状態を解除した
1 | 認証サーバはすでに閉塞状態ではない
0，1以外 | 異常終了

使用例

プライマリー認証サーバがserver1，セカンダリー認証サーバがserver2で，server1が閉塞中になっていた場合に，jbsunblockadesrvコマンドを実行してserver1の閉塞状態を解除すると，次のように表示されます。

jbsunblockadesrv -s server1
プライマリー:server1
セカンダリー:server2

jbsunsetcnf

機能

指定した論理ホストを共通定義情報から削除します。

形式

jbsunsetcnf [-i]
            -h 論理ホスト名
           [-c コンポーネント名]
           [-n サブキー]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-i

このオプションを指定すると，指定した論理ホストの共通定義情報を削除する前に確認メッセージを表示します。メッセージに対して「y」または「Y」を指定した場合だけ削除処理を実行します。

-h 論理ホスト名

共通定義情報に登録した論理ホストから削除したい論理ホスト名を指定します。

-c コンポーネント名

共通定義情報に登録した論理ホストの削除したいコンポーネント名を指定します。

-n サブキー

共通定義情報に登録した論理ホストの削除したいコンポーネントのサブキーを指定します。このオプションは，-cオプションを指定している場合だけ有効となります。

注意事項

通常は，-iオプションを指定してこのコマンドを実行してください。

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

戻り値

0 | 正常終了（削除対象の論理ホストが存在しなかった場合もこの値が返される）
-1 | 削除処理に失敗

jcocmdconv

機能

バージョン7以前のJP1/Baseのコマンド実行の履歴を，バージョン8以降用のコマンド実行履歴ファイル（ISAM）に移行します。jcocmdconvコマンドを実行しないと，バージョン7以前に蓄積されたコマンド実行履歴が参照できません。

バージョン7以前のJP1/Baseから，バージョン8以降のJP1/Baseにバージョンアップしたあと，コマンド実行履歴のあるマネージャーホスト上で一度だけ実行してください。クラスタ運用している場合は，物理ホスト，論理ホストのぞれぞれで実行してください。jcocmdconvコマンドは物理ホスト，論理ホストで同時実行できますが，物理ホストで複数のjcocmdconvコマンドを同時に実行することはできません。

形式

jcocmdconv [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

注意事項

バージョン8以降のJP1/Base，JP1/IM - Managerのインストールのあと，JP1/IM - Managerを起動する前に実行してください。JP1/IM - Managerを起動すると，自動アクションなどでバージョン8以降用のコマンド実行履歴が更新されてしまうおそれがあります。jcocmdconvコマンドの実行前に，コマンド実行履歴ファイル（ISAM）が更新されると，バージョン7以前で蓄積した履歴が移行できなくなります。

戻り値

0 | 正常終了
2 | パラメーターが不正
3 | 論理ホストがない
4 | メモリーエラー
5 | ディスクファイルエラー
6 | 保存先ファイルがすでにある
7 | コマンドがシグナルに中断された
8 | 実行権限エラー
32 | 共通定義アクセスエラー
41 | ファイルアクセスエラー
42 | ほかのjcocmdconvコマンドが実行中
255 | そのほかのエラー

jcocmddef

機能

コマンド実行環境を設定，参照します。引数には，マネージャーホスト（JP1/IM - Managerインストールホスト）でだけ指定すればよいもの，コマンド実行先ホストでだけ指定すればよいものがあります。これらについては以降の引数の説明で説明します。

形式

jcocmddef [ [-show] |
         [-default]
         [-rsptime 応答監視時間]
         [-record レコード数]
         [-group ホストグループ定義ファイル名]
         [-loaduserprofile {ON|OFF}]
         [-queuenum コマンド先行入力数]
         [-execnum コマンド同時実行数]
         [-open {ON|OFF}]
         [-flush {ON|OFF}]
         [-cmdevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}]
         [-actevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}]
         [-actresult {ON|OFF}]
         [-host 論理ホスト名]
         [-runevinterval 経過時間イベント発行間隔]
         [-actlimit {ON [転送データ量（行数）] | OFF}]
         [-cmdlimit {ON [転送データ量（行数）] | OFF}]
         [-queuethreshold コマンド先行入力数の閾値] ]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-show

現在の定義内容を表示します。このオプションはほかのオプションと併用はできません。なお，このオプションを省略し，かつ，ほかのオプションも省略した場合は，このオプション指定時と同じく，現在の定義内容を表示します。

-default

-rsptime，-record，-loaduserprofile，-queuenum，-execnum，-open，-flush，-cmdevent，-actevent，-actresult，-runevinterval，-actlimit，-cmdlimit，および-queuethresholdの設定を初期設定に戻します。ほかのオプションを同時に指定した場合は，-defaultオプションが有効になります。

-rsptime 応答監視時間

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

実行コマンドの応答監視時間を指定します。指定できる値は0～600（秒）です。0を指定した場合は監視しません。初期設定では，60秒が設定されています。

実行したコマンドが応答監視時間以内に応答がない場合は，KAVB2002-Iメッセージが出力されます。

このオプションで指定した値は，JP1/Baseを再起動したあとに有効になります。

-record レコード数

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

JP1/IM - Viewの［コマンド実行］画面，および自動アクションで実行したコマンドの実行履歴を保存するファイルの上限値をレコード数で指定します。

指定できる値は，1～196,600です。初期設定では，20,000レコードが設定されています。

1回のコマンド実行で使用するレコード数は，(実行コマンドの出力行数+3)レコードです。1レコードは6,520バイトです。レコードサイズは変更できません。

レコード数が少ないと，自動アクションのアクション結果が正しく表示されないことがあります。

変更したレコード数は，コマンド実行履歴ファイル（ISAM）を削除したあとに有効になります。コマンド実行履歴ファイル（ISAM）を削除すると，過去の自動アクション，コマンド実行による履歴はすべて失われますので，注意してください。コマンド実行履歴ファイル（ISAM）の削除手順，および削除する際の注意事項については，マニュアル「JP1/Integrated Management - Manager 運用ガイド」（トラブルシューティングの章，トラブルへの対処方法にある「レコード数の上限値を変更する」）を参照してください。

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

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

コマンド実行先ホストを定義したホストグループ定義ファイルを指定します。定義ファイルの形式は，マニュアル「JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス」を参照してください。

ホストグループ定義ファイルで，ホストグループを定義していない場合は，そのホストグループが削除されます。

-loaduserprofile {ON|OFF}

このオプションはコマンド実行先ホストで設定します。

コマンド実行時にOSユーザーのプロファイルを読み込むかどうかを指定します。プロファイルを読み込む場合はON，読み込まない場合はOFFを指定します。ONまたはOFFの大文字・小文字は，区別されません。初期設定では，OFFが設定されています。

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

このオプションは，Windowsの場合にだけ使用できます。

-queuenum コマンド先行入力数

このオプションはコマンド実行先ホストで設定します。

自動アクション機能を使用してコマンドを実行する場合に，コマンド実行先ホストで実行待ちにできるコマンドの最大値を指定します。指定できる値は，0～65,535です。初期設定では，1,024が設定されています。0を指定した場合は，コマンド実行先ホストに複数のコマンドを同時に投入できません。

実行待ちの自動アクションがコマンド先行入力数を超えた場合は，KAVB2058-Eメッセージが出力されます。

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

-execnum コマンド同時実行数

このオプションはコマンド実行先ホストで設定します。

自動アクション機能を使用してコマンドを実行する場合に，コマンド実行先ホストで同時に実行できるコマンド数の最大値を指定します。指定できる値は，1～48です。初期設定では，1が設定されています。コマンドを実行するホストごとに異なる値を指定できます。

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

このオプションは，実行終了までに長時間かかるコマンドを実行した場合に後続のコマンドの実行開始を早めたいときや，同時に大量の自動アクションが発生した場合に処理性能を向上させたいときなどに指定してください。

なお，このオプションで2以上の値を指定した場合は，複数のコマンドが同時に実行されるため，先に実行されたコマンドが必ずしも先に終了するとは限りません。したがって，自動アクションの終了順序を考慮した運用をしている場合は，このオプションを指定しないでください。

-open {ON|OFF}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

コマンド実行履歴ファイル（ISAM）を常時オープンした状態で実行履歴を出力するかどうかを設定します。ONの場合，常時オープンした状態で出力します。OFFの場合，常時オープンしないで出力します。初期設定では，OFFが設定されています。自動アクション用コマンド実行履歴にだけ有効な設定で，JP1/IM - Viewの［コマンド実行］画面用コマンド実行履歴では有効になりません。

-openの設定を有効にするには，JP1/Baseの再起動が必要です。

-flush {ON|OFF}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

コマンド実行履歴1行ごとにディスクへ書き込みをするかどうかを設定します。この設定を有効にすると，突然のシャットダウンが発生した場合でも1行ごとにディスクへ実行履歴が書き込まれているため，再起動後に実行履歴データを参照できます。ONの場合，1行ごとにディスク中のファイルへ書き込みます。OFFの場合，システムでバッファリングを行うため，1行ごとにディスク中のファイルへ書き込みません。初期設定では，OFFが設定されています。

なお，-flushを有効にした場合，1行ごとにディスク中のファイルへ書き込むため，自動アクションおよびコマンド実行の性能が劣化する場合があります。

-flushの設定を有効にするには，JP1/Baseの再起動が必要です。

-cmdevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

コマンド実行操作をした際にコマンド実行操作に関係するイベントを発行したい場合に，どのイベントを発行するかを指定します。次に示す発行レベルのどれかを指定します。初期設定では，0が設定されています。

表13-1　イベント発行レベル（コマンド実行操作）

発行レベル | 発行するイベントのイベントID | 説明
0 | なし | コマンド実行操作に関係するイベントを発行しない
1 | 00003FA0 | コマンド実行開始イベントを発行する
2 | 00003FA1 | コマンド実行終了イベントを発行する
3 | 00003FA0，00003FA1 | コマンド実行開始イベント，コマンド実行終了イベントを発行する
4 | 00003FA2 | コマンド実行異常終了イベントを発行する
5 | 00003FA0，00003FA2 | コマンド実行開始イベント，コマンド実行異常終了イベントを発行する
6 | 00003FA1，00003FA2 | コマンド実行終了イベント，コマンド実行異常終了イベントを発行する
7 | 00003FA0，00003FA1，00003FA2 | コマンド実行開始イベント，コマンド実行終了イベント，コマンド実行異常終了イベントを発行する

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

-actevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

アクションの状態が変化した際にアクション状態通知に関係するイベントを発行したい場合に，どのイベントを発行するかを指定します。次に示す発行レベルのどれかを指定します。初期設定では，0が設定されています。

表13-2　イベント発行レベル（自動アクション状態通知）

発行レベル | 発行するイベントのイベントID | 説明
0 | なし | アクション状態通知に関係するイベントを発行しない
1 | 000020E0，000020E3 | アクション状態が送信中・キューイング・実行中になった際にイベントを発行する
2 | 000020E1，000020E4 | アクション状態が終了・キャンセル・強制終了になった際にイベントを発行する
3 | 000020E0，000020E1，000020E3，000020E4 | アクション状態が送信中・キューイング・実行中または終了になった際にイベントを発行する
4 | 000020E2，000020E5 | アクション状態が実行不可・実行失敗になった際にイベントを発行する
5 | 000020E0，000020E2，000020E3，000020E5 | アクション状態が送信中・キューイング・実行中または実行不可・実行失敗になった際にイベントを発行する
6 | 000020E1，000020E2，000020E4，000020E5 | アクション状態が終了・キャンセル・強制終了または実行不可・実行失敗になった際にイベントを発行する
7 | 000020E0，000020E1，000020E2，000020E3，000020E4，000020E5 | アクション状態が送信中・キューイング・実行中，終了・キャンセル・強制終了，または実行不可・実行失敗になった際にイベントを発行する

このオプションで指定した値は，JP1/IM - Managerを再起動したあとから，またはjco_spmd_reloadコマンドでリロードしたあとから有効になります。

なお，アクション状態通知に関係するイベントは，アクション情報ファイルを参照して発行されます。アクション情報ファイルの上限値に達して，上書きされた場合には，上書きされる以前のアクション情報を参照できなくなるため，アクション状態通知に関係するイベントを発行できません。このような場合には，警告イベント（000020E6または000020E7）またはエラーイベント（000020E8）が発行されます。

-actresult {ON|OFF}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

自動アクションによるコマンド実行の実行結果をコマンド実行履歴に保存するかどうか指定します。保存する場合はON，保存しない場合はOFFを指定します。

ONまたはOFFの大文字・小文字は，区別されません。初期設定では，ONが設定されています。コマンドの実行結果の詳細を知りたい場合は，必ずONを指定してください。

OFFを指定すると，コマンド実行履歴ファイル（ISAM）への出力を抑止するため，JP1/Base制御部の処理速度を向上できます。ただし，自動アクションによるコマンドの戻り値以外の情報をすべて破棄するため，コマンドの実行結果の詳細は出力されません（JP1/IM - Viewの［アクション結果詳細］画面の［メッセージ］に出力される情報がすべて「KAVB2401-I」のメッセージ情報になります）。

このオプションで指定した値は，JP1/IM - Managerを再起動したあとから有効になります。

-host 論理ホスト名

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

このオプションを指定して，実行系サーバまたは待機系サーバの設定を変更した場合は，必ずもう一方のサーバでも同様の設定をしてください。

-runevinterval 経過時間イベント発行間隔

このオプションはコマンド実行先ホストで設定します。

JP1/IM - Viewの［コマンド実行］画面，および自動アクションで実行したコマンドの経過時間を通知する，イベント発行間隔を指定します。指定できる値は，0～86,400（秒）です。初期設定では，600秒（10分）が設定されています。

指定した時間が経過するたびにイベントID 00003FA3（実行経過時間通知イベント）が発行され，KAVB2402-Wメッセージが出力されます。0を指定した場合，イベントは発行されません。

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

-actlimit {ON [転送データ量（行数）] | OFF}

このオプションはコマンド実行先ホストで設定します。

自動アクションで実行したコマンドの実行結果をマネージャーに転送する場合に，転送するデータ量を抑止するかどうか，また，抑止する場合はその上限値を指定します。指定できる値は0～196,600です。初期設定では，ON（抑止する）で値は1,000が設定されています。なお，コマンド実行先ホストのJP1/Baseのバージョンが07-51以前の場合，初期設定はOFF（抑止しない）が設定されています。

コマンド実行結果のデータ量を抑止する場合には，ONを指定し，転送するデータ量の上限値を行数（1行256バイト）で指定します。行数の指定を省略した場合は，1,000行が設定されます。

コマンド実行結果のデータ量の転送を抑止しない場合には，OFFを指定します。

自動アクションの実行結果として大量の出力データを必要としない場合，実行したコマンドが動作不正で無限ループした場合など，大量のデータの出力を抑止する目的で使用してください。

コマンド実行結果が上限値を超えた場合は，KAVB2070-Wメッセージが出力されます。

-actlimitの設定を有効にするには，JP1/Baseの再起動が必要です。

-cmdlimit {ON [転送データ量（行数）] | OFF}

このオプションはコマンド実行先ホストで設定します。

JP1/IM - Viewの［コマンド実行］画面から実行したコマンドの実行結果をマネージャーに転送する場合に，転送するデータ量を抑止するかどうか，また，抑止する場合はその上限値を指定します。指定できる値は0～196,600です。初期設定では，ON（抑止する）で値は1,000が設定されています。なお，コマンド実行先ホストのJP1/Baseのバージョンが07-51以前の場合，初期設定はOFF（抑止しない）が設定されています。

コマンド実行結果のデータ量を抑止する場合には，ONを指定し，転送するデータ量の上限値を行数（1行256バイト）で指定します。行数の指定を省略した場合は，1,000行が設定されます。

コマンド実行結果のデータ量を抑止しない場合には，OFFを指定します。

JP1/IM - Viewの［コマンド実行］画面から実行したコマンドの実行結果として，大量の出力データを必要としない場合，実行したコマンドが動作不正で無限ループした場合など，大量のデータの出力を抑止する目的で使用してください。

コマンド実行結果が上限値を超えた場合は，KAVB2070-Wメッセージが出力されます。

-cmdlimitの設定を有効にするには，JP1/Baseの再起動が必要です。

-queuethreshold コマンド先行入力数の閾値

このオプションはコマンド実行先ホストで設定します。

自動アクション機能を使用してコマンドを実行し，コマンド実行先ホストで実行待ちになるコマンド数（キューイング数）を監視したい場合に，コマンドの先行入力数の閾値を指定します。指定できる値は，0～65,535です。初期設定では，10が設定されています。

0を指定すると閾値監視をしません。

0以外を指定すると，その値に達した時点で警告のJP1イベントが発行され，KAVB2071-Wメッセージが出力されます。また，先行入力数が0に戻った時点で回復のJP1イベントが発行され，KAVB2072-Iメッセージが出力されます。

閾値監視をすると，JP1/Baseのキューにアクションが蓄積しているのを検知できます。そのため，実行遅延に対して事前に対処ができます。

-queuethresholdの設定を有効にするには，JP1/Baseの再起動が必要です。

出力形式

jcocmddefコマンドを実行すると，設定変更したパラメーターだけでなく，ほかのパラメーターも表示されます。出力形式を次に示します。

図13-1　jcocmddefコマンドの出力形式

戻り値

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

jcocmddel

機能

JP1/IM（JP1/IM - Viewの［コマンド実行］画面または自動アクション）から実行指示を受けてJP1/Base側で実行またはキューイングしているコマンドを終了させ，削除します。

システムの運用中に誤ったコマンドを実行してしまった，処理に時間が掛かり過ぎるコマンドを実行したために後続のコマンドが実行されない状態になった，など，コマンド実行でトラブルが発生したときに使用します。なお，このコマンドを実行する前にjcocmdshowコマンドを実行してコマンドの状態を確認し，不要な（削除してもよい）コマンドかどうかを判断してください。

形式

jcocmddel [-h 論理ホスト名]
         [-s 接続ホスト名]
         [-f]
         [コマンドID | ALL]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

-s 接続ホスト名

削除したいコマンドが存在している接続先ホストのホスト名を指定します。指定できる文字数は，1～255バイトです。このオプションを省略した場合は，自ホストを仮定します。

-f

コマンドを削除する際に，確認メッセージを表示させたくない場合に指定します。このオプションを指定すると，指定したコマンドを強制的に削除します。

コマンドID | ALL

削除するコマンドを指定します。コマンドIDで指定する場合はjcocmdshowコマンドの実行結果で得たIDを，「実行中」および「キューイング中」のすべてのコマンドを削除したい場合はALLを指定します。

コマンドIDを複数指定する場合は，スペースで区切ってください。

戻り値

0 | 正常終了
1 | コマンドIDがない，またはJP1/Baseのコマンド実行管理内のコマンドが部分的に削除されている
2 | 引数エラー
4 | システムリソース不足
8 | コマンドを実行する権限がない
16 | JP1/Baseのコマンド実行管理との通信でエラーが発生した
32 | 共通定義アクセスエラー
64 | 接続先ホストからの応答がない
65 | 接続先ホストとバージョンの互換性がない
128 | 内部エラー
129 | 最大接続数エラー
255 | その他のエラー

使用例

接続ホストhost01で実行されているコマンド1234を削除する。

jcocmddel -s host01 1234

出力例

jcocmddel -s host01 1234
KAVB2291-Q このコマンドIDを削除してよろしいですか？[Y/y or N/n] -> y
KAVB2293-I コマンド実行制御内のコマンド削除に成功しました。

jcocmdlog

機能

マネージャーホスト（JP1/IM - Managerインストールホスト）で実行するコマンドです。

JP1/IM - Viewの［コマンド実行］画面および自動アクションで実行したコマンドの履歴を，CSV形式で標準出力に出力します。

形式

jcocmdlog [-window]
         [-act]
         [-dir 実行履歴保存ディレクトリ]
         [-h 論理ホスト名]
         [-ext]
         [-date {日時 | [開始日時],[終了日時]}]

実行権限

Windowsの場合：なし（ただし，WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-window

JP1/IM - Viewの［コマンド実行］画面から実行したコマンドの履歴を出力します。

-act

自動アクションで実行したコマンドの履歴を出力します。

-windowオプションと-actオプションのどちらも省略した場合は，JP1/IM - Viewの［コマンド実行］画面および自動アクションで実行したコマンドの履歴を出力します。

なお，jcocmddefコマンドで出力抑止（-actresult OFF）を設定している間は，出力結果には詳細情報が含まれません（出力される情報はすべて「KAVB2401-I」のメッセージ情報になります）。初期設定またはjcocmddefコマンドで出力抑止を解除した場合は（-actresult ON），詳細情報が出力されます。

-dir 実行履歴保存ディレクトリ

指定したディレクトリの実行履歴を出力します。省略した場合は，運用中の実行履歴を出力します。

-h 論理ホスト名

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

-ext

JP1/IM - Viewの［コマンド実行］画面および自動アクションで実行したコマンドの受け取り時刻をYYYY/MM/DD,hh:mm:ssの形式で出力します。また，実行コマンド名とメッセージをダブルクォーテーションで囲んで出力します。なお，実行コマンド名またはメッセージにダブルクォーテーションが含まれる場合，ダブルクォーテーションを連続して一つ付加します。-extオプションを指定しない場合は，受け取り時刻はMM/DD/YY hh:mm:ssの形式で，実行コマンド名とメッセージをダブルクォーテーションで囲まずに出力します。

（例）

-extオプションを指定した場合

Window,2005/04/01,14:16:23,hostA,"jcochstat -k HELD -n 1003",2420,0,"KAVB2013-I ""jcochstat -k HELD -n 1003""のコマンドが実行終了しました。 pid=2420 terminate code=0"

-extオプションを指定しない場合

Window,04/01/05 14:16:23,hostA,jcochstat -k HELD -n 1003,2420,0,KAVB2013-I "jcochstat -k HELD -n 1003"のコマンドが実行終了しました。 pid=2420 terminate code=0

-date {日時 | [開始日時],[終了日時]}

履歴を出力する日時を指定します。このオプションを省略した場合は，すべての履歴を出力します。

日時，開始日時および終了日時の指定形式は，日付（YYYYMMDD：年月日）と時刻（hhmmss：時分秒）を次のように指定します。時刻は省略できます。

-date 日時
日付または指定した時間帯の履歴を出力します。

（例）-date 2005030317

2005年3月3日の17時台（17時00分00秒～17時59分59秒）の履歴を出力します。

-date [開始日時],[終了日時]
開始日時と終了日時で範囲指定した場合，範囲内の履歴を出力します。
時刻を省略した場合には以下のように仮定します。
開始：000000（0時0分0秒）
終了：235959（23時59分59秒）

-date 開始日時,終了日時
指定した開始日時から終了日時までの範囲内の履歴を出力します。
（例）-date 2005030317,2005030416
　2005年3月3日の17時00分00秒から2005年3月4日の16時59分59秒までの履歴を出力します。

-date 開始日時,
指定した開始日時以降の履歴を出力します。
（例）-date 200503031724,
　2005年3月3日の17時24分00秒以降の履歴を出力します。

-date ,終了日時
指定した終了日時以前の履歴を出力します。
（例）-date ,200503031724
　2005年3月3日の17時24分59秒以前の履歴を出力します。

-date ,
-dateオプション省略時と同様で，すべての履歴を出力します。

戻り値

0 | 正常終了
4 | コマンド実行履歴ファイルが使用中のため，処理が中断された
-1 | 異常終了

出力形式

コマンドの実行結果は，コンマ区切り（CSV形式）で出力されます。出力形式は次のとおりです。

実行種別,メッセージ受け取り時刻,コマンド実行先ホスト名,実行コマンド,プロセスID,終了コード,メッセージ

実行種別は，「Window」（JP1/IM - Viewの［コマンド実行］画面から実行したコマンド）または「Action」（自動アクションで実行したコマンド）のどちらかの値を取ります。

コマンドの実行結果は1行256バイトで出力されるため，257バイト以上の実行結果は複数行に分割されて出力されます。

出力する内容のない項目は，コンマだけが出力されます。

jcocmdshow

機能

JP1/IM（JP1/IM - Viewの［コマンド実行］画面または自動アクション）から実行指示を受けてJP1/Base側で実行またはキューイングしているコマンドの状態を確認するコマンドです。

システムの運用中に誤ったコマンドを実行してしまった，処理に時間が掛かり過ぎるコマンドを実行したために後続のコマンドが実行されない状態になった，など，コマンド実行でトラブルが発生したときに使用します。このコマンドを実行して得られる情報は，次のとおりです。

ID：コマンド実行管理内で実行中，キューイング中のコマンドに付けられるユニークなID

STATUS：コマンド実行管理内でのコマンドの実行状態（実行中は「R」，キューイング中は「Q」）

TYPE：コマンド実行指示をした機能名（JP1/IM - Viewからの実行指示の場合は「WIN」，自動アクションからの実行指示の場合は「ACT」）

USER：コマンド実行指示をしたJP1ユーザー名

STIME：コマンド実行管理がJP1/IMからコマンドを受け付けた時間

ETIME：コマンド実行開始からの経過時間

COMMAND：実行中またはキューイング中のコマンド名

なお，このコマンドで確認したのち，不要（削除してもよい）と判断したコマンドはjcocmddelコマンドを実行して削除してください。

形式

jcocmdshow [-h 論理ホスト名]
          [-s 接続ホスト名]
          [-window]
          [-act]
          [-state {r|q}]
          [-ph コマンド投入元ホスト名]
          [-v]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

-s 接続ホスト名

実行状態を確認したいコマンドが存在している接続先ホストのホスト名を指定します。指定できる文字数は，1～255バイトです。このオプションを省略した場合は，自ホストを仮定します。

-window

JP1/IM - Viewの［コマンド実行］画面から実行指示を受けたコマンドの実行状態だけを確認したいときに指定します。-actオプションと同時に指定，または両方とも指定しなかった場合は，JP1/IM - Viewの［コマンド実行］画面または自動アクションから実行指示を受けたコマンドの実行状態が表示されるようになります。

-act

自動アクションから実行指示を受けたコマンドの実行状態だけを確認したいときに指定します。-windowオプションと同時に指定，または両方（-window，-act）とも指定しなかった場合は，JP1/IM - Viewの［コマンド実行］画面または自動アクションから実行指示を受けたコマンドの実行状態が表示されるようになります。

-state {r|q}

コマンドの実行状況を指定します。「実行中」のコマンドを取得する場合はrを，「キューイング中」のコマンドを取得する場合はqを指定します。

このオプションを省略した場合は，「実行中」および「キューイング中」のコマンドを取得します。

-ph コマンド投入元ホスト名

特定のホストから投入されたコマンドだけを確認したいときに指定します。

-v

jcocmdshowコマンドを実行して出力される情報を縦表示したいときに指定します。

このオプションを省略した場合は，jcocmdshowコマンドを実行して出力される情報は横表示されます。

戻り値

0 | 正常終了
1 | JP1/Baseのコマンド実行管理にコマンドが存在しない
2 | 引数エラー
4 | システムリソース不足
8 | コマンドを実行する権限がない
16 | JP1/Baseのコマンド実行管理との通信でエラーが発生した
32 | 共通定義アクセスエラー
64 | 接続先ホストからの応答がない
65 | 接続先ホストとバージョンの互換性がない
128 | 内部エラー
129 | 最大接続数エラー
255 | その他のエラー

使用例

接続ホストhost01で実行されているコマンドの実行状況を確認する。

jcocmdshow -s host01

出力例

-vオプション省略時

jcocmdshow -s host01
ID   STATUS TYPE USER     STIME           ETIME     COMMAND
1234 R      WIN  jp1admin Feb 13 18:55:29 000:01:05 "C:¥WINNT¥system32¥notepad.exe"

-vオプション指定時

jcocmdshow -s host01 -v
ID       :1234
STATUS   :R
TYPE     :WIN
USER     :jp1admin
STIME    :Feb 13 18:55:29
ETIME    :000:01:05
COMMAND  :"C:¥WINNT¥system32¥notepad.exe"

jevdbinit

機能

イベントDBを初期化します。このコマンドを実行すると，イベントDBの内容が削除され，イベントDBが再作成されます。

新しいイベントDBの通し番号の開始番号は，削除される前のイベントDBから引き継いだ通し番号，または指定された通し番号になります。

初期化する前のイベントDBのバックアップを残せます。バックアップファイルは，jevexportコマンドでcsvファイルに出力できます。バックアップファイルをリストアすることはできません。

イベントDBの初期化の詳細については，「8.2　イベントDBの初期化」を参照してください。

形式

jevdbinit [-h イベントサーバ名]
         [-s イベントDB内通し番号の開始番号]
         [-f]
         {-b | -n}

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

イベントDBを初期化したいイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

-s イベントDB内通し番号の開始番号

初期化後に作成されるイベントDBの開始番号を指定します。-sオプションに指定した通し番号でイベントDBが作成されます。指定できる値は，0～2,147,483,647です。

このオプションを省略した場合，削除する前のイベントDB内通し番号を引き継ぎます。

-f

このオプションを省略すると，このコマンドを実行してよいかどうかを確認するための入力が要求されます（「よろしいですか？[Y/N]」，または「Is This OK?[Y/N]」が表示されます）。この確認入力を不要にしたい場合に，このオプションを指定します。

-b

初期化前のイベントDBをバックアップする場合に指定します。-bまたは-nの指定は，省略できません。

バックアップファイルは，イベントDBが格納されているディレクトリと同じディレクトリに格納されます。バックアップファイル名は，次のようになります。

イベントDBファイル名 | バックアップファイル名
IMEvent{0|1}.idx | 0IMEvent{0|1}.idx
IMEvent{0|1}.dat | 0IMEvent{0|1}.dat
IMEvent{0|1}.fwd | 0IMEvent{0|1}.fwd

バックアップする場合，イベントDBが使用するディスク占有量が2倍になるためご注意ください。前回のバックアップファイルが残っている状態で-bオプションを指定すると，前回のバックアップファイルは削除されます。

-n

初期化前のイベントDBをバックアップしない場合に指定します。-bまたは-nの指定は，省略できません。前回のバックアップファイルが残っている状態で-nオプションを指定すると，前回のバックアップファイルは残ったままとなります。

注意事項

イベントサービスが稼働しているときは，このコマンドは実行できません。

このコマンドの実行中は，イベントサービスは起動できません。

イベントDBが空の状態でこのコマンドを実行すると，戻り値が7（イベントDBが壊れている）となりますが，問題ありません。

戻り値

0 | 正常終了
1 | 引数エラー
2 | 実行権限不足
3 | 入出力エラー
4 | メモリー不足
5 | イベントサーバ名が未定義
6 | イベントDBが存在しない
7 | イベントDBが壊れている
8 | イベントサービスが稼働中のため，イベントDBを初期化できない
255 | そのほかのエラー

jevdbmkrep

機能

イベントDBの重複防止テーブルファイルを再構築します。

重複防止テーブルについては，「1.4.2　イベントDBの概要」を参照してください。

形式

jevdbmkrep [-h イベントサーバ名]
          [-f]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

重複防止テーブルファイルを再構築したいイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

-f

このオプションを省略すると，このコマンドを実行してよいかどうかを確認するための入力が要求されます（「よろしいですか？[Y/N]」，または「Is This OK?[Y/N]」が表示されます）。この確認入力を不要にしたい場合に，このオプションを指定します。

注意事項

イベントDBの容量が大きい場合，このコマンドの実行には時間が掛かります。

イベントサービスが稼働している場合は，このコマンドは実行できません。また，このコマンドの実行中は，イベントサービスは起動できません。

イベントDBが空の状態でこのコマンドを実行すると，戻り値が6（イベントDBが存在しない）で失敗します。

戻り値

0 | 正常終了
1 | 引数エラー
2 | 実行権限不足
3 | 入出力エラー
4 | メモリー不足
5 | イベントサーバ名が未定義
6 | イベントDBが存在しない
7 | イベントDBが壊れている
8 | イベントサービスが稼働中のため，重複防止テーブルファイルを再構築できない
255 | そのほかのエラー

jevdbswitch

機能

イベントサービスが稼働しているイベントサーバのイベントDB内で，イベントが実際に登録される面を，現在使用されている側のイベントDB（アクティブ面）から，待機している側のイベントDB（スタンバイ面）に強制的に切り替えます。

イベントDBがスタンバイ面に切り替わる際，スタンバイ面に登録されていたデータは削除されます。このコマンドを2回続けて実行すると，イベントDBは初期化されます。なお，イベントDBに登録されているJP1イベントを保存しておきたい場合は，あらかじめjevexportコマンドでイベントDBをcsvファイルに出力してください。

jevdbswitchコマンドを使用したイベントDBの初期化方法については，「8.2　イベントDBの初期化」を参照してください。

形式

jevdbswitch [-h イベントサーバ名]
           [-f]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

イベントが実際に登録されるイベントDBをアクティブ面からスタンバイ面に切り替えるイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

-f

このオプションを省略すると，このコマンドを実行してよいかどうかを確認するための入力が要求されます（「よろしいですか？[Y/N]」，または「Is This OK?[Y/N]」が表示されます）。この確認入力を不要にしたい場合に，このオプションを指定します。

戻り値

0 | 正常終了
1 | 引数エラー
2 | 実行権限不足
3 | 入出力エラー
4 | メモリー不足
5 | イベントサーバ名が未定義
8 | イベントサービスに接続できない
9 | イベントDBが切り替えられたかどうかを検知できない
255 | そのほかのエラー

jevdef_distrib

機能

イベントサービスの定義情報を配布し，配布先に定義情報を反映させます。

形式

jevdef_distrib {-f [配布定義ファイル名] |
               -e [配布定義ファイル名] |
               -l [配布定義ファイル名] |
               -s [配布定義ファイル名]}
              [-h 論理ホスト名]
              [-n]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f [配布定義ファイル名]

転送設定ファイル（forward）の定義情報を配布するときに指定します。配布定義ファイルとして，あらかじめjev_forward.confを作成しておいた場合，配布定義ファイル名の指定は省略できます。任意の名称で配布定義ファイルを作成した場合は，配布定義ファイル名を指定します。指定するファイル名にディレクトリ名は指定できません。配布定義ファイルは，「14.　定義ファイル」の「配布定義ファイル」を参照し，各配布定義ファイルの格納先に作成してください。

このオプションを指定すると，配布元で定義ファイル中の正規表現の構文チェックが実施されます。また，配布先でjevreloadコマンドが実行されるため，配布先でも正規表現の構文チェックが実施されます。配布元での構文チェックは基本正規表現（Windowsの場合はJP1独自の正規表現）で実施されるため，配布先で拡張正規表現を使用する設定にしている場合などには，-nオプションを指定して，配布元での構文チェックを実施しないようにしてください。

-e [配布定義ファイル名]

イベントログトラップ動作定義ファイル（ntevent.conf）の定義情報を配布する場合に指定します。配布定義ファイルとして，あらかじめjev_ntevent.confを作成しておいた場合，配布定義ファイル名の指定は省略できます。任意の名称で配布定義ファイルを作成した場合は，配布定義ファイル名を指定します。指定するファイル名にディレクトリ名は指定できません。配布定義ファイルは，「14.　定義ファイル」の「配布定義ファイル」を参照し，各配布定義ファイルの格納先に作成してください。なお，配布先ホストがWindowsの場合に対してだけ配布処理を行います。

配布先エージェントが論理ホストの場合，配布先エージェントホストの物理ホスト（実行系）へ，イベントログトラップ動作定義ファイルが配布およびリロードされます。

-l [配布定義ファイル名]

ログファイルトラップ動作定義ファイルの定義情報を配布する場合に指定します。配布定義ファイルとして，あらかじめjev_logtrap.confを作成しておいた場合，配布定義ファイル名の指定は省略できます。任意の名称で配布定義ファイルを作成した場合は，配布定義ファイル名を指定します。指定するファイル名にディレクトリ名は指定できません。配布定義ファイルは，「14.　定義ファイル」の「配布定義ファイル」を参照し，各配布定義ファイルの格納先に作成してください。

配布先エージェントが論理ホストの場合，配布先エージェントホストの物理ホスト（実行系）へ，ログファイルトラップ動作定義ファイルが配布およびリロードされます。

-s [配布定義ファイル名]

ログファイルトラップ起動定義ファイル（jevlog_start.conf）の定義情報を配布する場合に指定します。ログファイルトラップ起動定義ファイルの定義情報は，共通定義情報に自動で反映されません。反映するには，ログファイルトラップ管理サービスを再起動してください。

配布定義ファイルとして，あらかじめjev_logstart.confを作成しておいた場合，配布定義ファイル名の指定は省略できます。配布定義ファイルを任意の名称で作成した場合は，配布定義ファイル名を指定します。指定するファイル名にディレクトリ名は指定できません。配布定義ファイルは，「14.　定義ファイル」の「配布定義ファイル」を参照し，各配布定義ファイルの格納先に作成してください。ログファイルトラップ起動定義ファイルを配布するには，配布元および配布先のホストにインストールされているJP1/Baseのバージョンを09-50以降にする必要があります。

-h 論理ホスト名

論理ホスト上でこのコマンドを実行する場合に指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じホスト名が仮定されます。

-eオプションを指定した場合，コマンドを実行したホスト（実行系）の物理ホストに設定しているイベントログトラップ動作定義ファイルが配布されます。

-lオプションを指定した場合，コマンドを実行したホスト（実行系）の物理ホストに設定しているログファイルトラップ動作定義ファイルが配布されます。

-n（-fオプション指定時に有効）

配布元での構文チェックを実施しない場合に指定します。正規表現の仕様は，プラットフォームおよび正規表現の種類（基本正規表現，拡張正規表現）によって異なるため，次に示すような場合は，このオプションを指定してください。

転送設定ファイル（forward）の配布定義ファイル中に正規表現が含まれていて，配布元と配布先のプラットフォームが異なる場合

配布先で拡張正規表現を使用する設定にしている場合

-eオプションまたは-lオプションを指定した場合，配布元での構文チェックは実施されませんが，-nオプションと同時に指定してもエラーにはなりません。

このオプションを指定すると，配布元での構文チェックは実施されませんが，配布先のイベントサーバが稼働中の場合，リロード結果がこのコマンドの実行結果として出力されます。配布先のイベントサーバが停止している場合には，フィルター条件の誤りを検出できません。配布先のイベントサーバ起動時にフィルター条件の誤りを検出できます。イベントサーバが停止しているかどうかは，jevdef_distribコマンドの戻り値で判断できます。

注意事項

jevdef_distribコマンドを実行できるホストは，バージョン7のJP1/IM - Central Consoleまたはバージョン8以降のJP1/IM - Managerがインストールされているホストだけです。

マネージャーホストの下位に，バージョン7のJP1/IM - Central Consoleまたはバージョン8以降のJP1/IM - Managerがインストールされたサブマネージャーが存在する場合，サブマネージャーからもjevdef_distribコマンドが実行できます。マネージャーホストおよびサブマネージャーから同時にjevdef_distribコマンドを実行した場合は，最後に配布した定義情報が有効となります。

定義情報は，配布定義ファイルに指定した配布先に配布されます。

jevdef_distribコマンド実行時，配布先ホストのjbspluginプロセス（Windowsの場合），jbspluginデーモン（UNIXの場合）が起動している必要があります。

jevdef_distribコマンド実行時，起動していないホストがある場合，そのホストの定義情報を変更できなかったメッセージが表示されます。この場合，エラーとなったホストが起動していることを確認したあとに，再度定義情報を配布してください。

jevdef_distribコマンド実行時に，配布先のホストですでに定義情報が設定されている場合は，各ホストに設定されている定義情報を削除してから定義情報を配布します。

配布定義ファイルに，JP1/IMの構成定義ファイルで定義されていないホストを指定すると，jevdef_distribコマンド実行時にエラーとなり，定義情報はどこにも配布されません。

配布定義ファイルに配布先ホストを重複して指定すると，jevdef_distribコマンド実行時にエラーとなり，定義情報はどこにも配布されません。

jevdef_distribコマンド実行時に，配布先ホストにインストールされたJP1/Baseのバージョンが06-71以前の場合，そのホストでの処理を中断し，次の配布先への処理を続行します。

配布先ホストでリロードの失敗によるエラーが発生した場合，配布前の定義を有効としたまま機能を続行しますが，定義情報は配布した定義情報に書き換えられます。リロードに失敗したホストには，再度jevdef_distribコマンドを実行してください。

エラーになった配布先ホストのホスト名およびエラーメッセージは標準エラー出力されます。

ログファイルトラップまたはイベントログトラップの定義情報を配布すると，配布先でjevlogreloadコマンドまたはjeveltreloadコマンドが実行されます。このとき，トラップ処理中の場合は，トラップ処理完了後にリロードコマンドが実行されます。jevlogreloadコマンドまたはjeveltreloadコマンドが実行中にイベントが発生した場合は，リロードコマンドを実行後，新たに読み込まれた定義情報に従ってイベントが変換されます。

定義情報を配布する場合，ログファイルトラップのファイル属性に関するパラメーター（FILETYPE，HEADLINE，HEADSIZE，およびRECTYPE）の値は，起動時に指定した値のまま変更しないでください。これらのパラメーターを変更して定義情報を配布すると，配布先の定義情報は変更されますが，jevlogreloadコマンドの実行時エラーとなります。

戻り値

0 | 正常終了
1 | 引数エラー
2 | サービスまたは管理デーモンが起動していない
3 | 構成定義情報取得エラー
4 | メモリーなどシステムリソースが不足した
10 | 配布定義ファイルに誤りあり
11 | 配布定義ファイルオープンエラー
12 | 配布先でエラー
255 | そのほかのエラー

jevdef_get

機能

イベントサービスの定義情報を収集します。

形式

jevdef_get {-f | -e | -l [ログファイルトラップ動作定義ファイル名] | -s}
          [-r ホスト名[,ホスト名...]]
          [-h 論理ホスト名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f

転送設定ファイル（forward）の定義情報を収集します。

-e

イベントログトラップ動作定義ファイル（ntevent.conf）の定義情報を収集します。収集先ホストがWindowsの場合に対してだけ収集処理を行います。

収集先エージェントが論理ホストの場合，収集先エージェントホストの物理ホスト（実行系）のイベントログトラップ動作定義ファイルが収集されます。

-l [ログファイルトラップ動作定義ファイル名]

ログファイルトラップ動作定義ファイルの情報を収集します。収集先ホストで，任意の名称の動作定義ファイルを作成している場合は，動作定義ファイル名を指定してください。

収集先エージェントが論理ホストの場合，収集先エージェントホストの物理ホスト（実行系）のログファイルトラップ動作定義ファイルが収集されます。

-s

ログファイルトラップ起動定義ファイル（jevlog_start.conf）の情報を収集します。ログファイルトラップ起動定義ファイルを収集するには，収集元および収集先のホストにインストールされているJP1/Base のバージョンを09-50以降にする必要があります。

-r ホスト名[,ホスト名...]

特定のホストから個別に定義情報を収集する場合に指定します。このオプションを省略すると，定義情報は一括で収集されます。複数の論理ホスト名を指定する場合は「,」で区切ります。

-h 論理ホスト名

論理ホスト上でこのコマンドを実行する場合に指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じホスト名が仮定されます。

注意事項

jevdef_getコマンド実行時，収集先ホストのjbspluginプロセス（Windowsの場合），jbspluginデーモン（UNIXの場合）が起動している必要があります。

jevdef_getコマンド実行時に，収集先ホストにインストールされたJP1/Baseのバージョンが06-71以前の場合，そのホストでの処理を中断し，次の収集先への処理を続行します。

定義情報の収集先ホストでエラーが発生した場合は，そのホストでの処理を中断し，次の収集先への処理を続行します。

エラーになった収集先ホストのホスト名およびエラーメッセージは標準エラー出力されます。

収集した定義情報は，1行につき1,023バイトまで出力されます。1,024バイト以降は出力されません。

戻り値

0 | 正常終了
1 | 引数エラー
2 | サービスまたは管理デーモンが起動していない
3 | 構成定義情報取得エラー
4 | メモリーなどシステムリソースが不足した
10 | 収集先でエラー
255 | そのほかのエラー

jeveltreload（Windows限定）

機能

イベントログトラップ動作定義ファイル（ntevent.conf）をリロードします。

形式

jeveltreload

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

注意事項

リロードコマンド実行時にトラップ処理を行っていた場合，そのトラップ処理の完了後，リロード処理を行います。

serverパラメーターを変更した場合は，イベントログトラップサービスを再起動してください。再起動しないでコマンドを実行するとエラーとなり，リロードできません。

戻り値

0 | 正常終了
1 | 引数誤り
2 | サービスが起動していない
3 | 動作定義ファイルの文法エラー
4 | 動作定義ファイルのオープンエラー
5 | メモリーなどシステムリソースが不足した
6 | 権限チェックエラー
255 | そのほかのエラー

jevexport

機能

イベントDBの内容をcsvファイルに出力します。

形式

jevexport [-h イベントサーバ名]
         [-i イベントDBファイル名]
         [-o 出力ファイル名]
         [-f フィルターファイル名]
         [-t {ON | OFF}]
         [-l コードセット名]
         [-k 項目ファイル名]
         [-a]

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

csvファイルに出力するイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションは，-iオプションと同時に指定できません。

-i イベントDBファイル名

csvファイルに出力するイベントDBファイル名（拡張子：dat）を指定します。OSのバックアップ用コマンドやjevdbinitコマンドでバックアップされたイベントDBのファイル名などを指定できます。パス名を省略した場合は，カレントディレクトリが仮定されます。

このオプションは，-hオプションと同時に指定できません。

-o 出力ファイル名

csvファイル名を255バイト以内で指定します。指定した出力ファイルがすでに存在する場合，そのファイルを上書きします。このオプションを省略した場合は，カレントディレクトリにimevexport.csvファイルを出力します。なお，JP1イベントは古い順に出力されます。

-f フィルターファイル名

イベントDBに登録されたJP1イベントの中から，csvファイルに出力したいJP1イベントの条件を記述したテキストファイルを255バイト以内で指定します。フィルターファイルの記述形式は，イベントフィルターの形式と同じです。詳細については，「14.　定義ファイル」の「イベントフィルターの文法」を参照してください。このオプションを省略した場合，イベントDBに登録されたすべてのJP1イベントがcsvファイルへの出力対象となります。

注意事項

csvファイルに出力するJP1イベントの条件として，フィルターファイルに日本語文字列を指定する場合，その文字コードは，jevexportコマンド実行時のロケール情報（環境変数LANGなど）と合致させてください。

JP1イベントの条件として指定した文字列の文字コードとjevexportコマンド実行時のロケール情報（環境変数LANGなど）が異なる場合，JP1イベントはcsvファイルに出力されません。

-t {ON | OFF}

JP1イベント登録時刻，JP1イベント到着時刻，および拡張属性の共通情報のSTART_TIMEやEND_TIMEを1970年1月1日からの通算秒の表記からYYYYMMDDhhmmssの西暦表示に変換したい場合は，ONを指定してください。西暦表示に変換しない場合は，OFFを指定してください。なお，このオプションを省略した場合は，OFFを指定した場合と同じ動作になります。

-l コードセット名

csv形式に変換するときに，イベントDB中の文字列を指定された文字コードに変換します。このオプションを省略した場合は，文字コードを変換しないで，イベントDBに登録されたコードセットの状態で出力します。指定できる文字コードを次に示します。

SJIS

EUCJIS

ISO2022JP

UTF-8

-k 項目ファイル名

csvファイルに出力したい拡張属性（固有情報）名を記述したテキストファイルを，255バイト以内で指定します。このオプションを指定した場合，イベントDBに記録された固有情報のうち，項目ファイルに記述された拡張属性の固有情報だけが出力されます。このオプションを省略した場合は，すべての固有情報がcsvファイルに出力されます。なお，基本属性と拡張属性の共通情報についてはすべて出力されます。

項目ファイルの記述形式を次に示します。

csvファイルに出力したい固有情報名を先頭（1バイト）から記述する。

csvファイルに出力したくない固有情報は，記述しないまたはコメント行（#を行頭に付ける）にする。

固有情報で，1970年1月1日からの通算秒で表記されているものについては固有情報名の前に@を付ける。
@を付けることによってYYYYMMDDhhmmssの西暦表示に変換できます。
ただし，名称の前に@を付けた固有情報に値が設定されていない場合は，0を仮定して西暦表示に変換します。TZ=JST-9の場合，「19700101090000」に変換します。

以上の条件をファイルに記述した例を次に示します。

AAA     ←   時間変更なし
@BBB    ←   YYYYMMDDhhmmssの西暦表示に変換する
#CCC    ←   コメント行

-a

csvファイルの先頭行に基本属性および拡張属性のタイトル名を，見出し行として出力します。拡張属性の固有情報は，属性名称と属性値がペアで出力されるため，最初の個別拡張属性名だけがタイトルとして出力され，以降は省略されます。

日本語で出力する場合は，-lオプションのコードセット名に文字コードを指定してください。-lオプションを指定しない場合は，タイトル名は英語で出力されます。

注意事項

出力ファイル名，フィルターファイル名，および項目ファイル名の途中にスペースが入る場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。

このコマンドの実行中にイベントDBが切り替わった場合，その時点でcsv出力を中断し，メッセージを出力します。その際のcsvファイルの出力情報は保証できません。コマンドを再実行すると，正常な情報を出力できます。

このコマンドでは，イベントサーバ設定ファイル（conf）で指定したイベントDBのサイズ分のcsv出力を保証します。イベント情報をすべて保存したい場合は，イベントDBが切り替わる前に，比較キーワードWITHINなどを指定したフィルターファイルを-fオプションで指定して定期的に実行することを推奨します。イベントDBサイズの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」のdb-sizeオプションの説明を参照してください。

-lオプションで文字コードを変換する場合，機種依存文字は正しく変換できません。

このコマンドでJP1/SES形式のイベントをcsvファイルに出力する場合，JP1/SES形式のイベントはコードセットを持たないため，文字列にダブルクォーテーションマークを含むイベントを正しくcsv形式に変換できないことがあります。

イベントIDは16進数でcsv出力されます。表計算ソフトで表示する場合，指数表示形式に合致したイベントID（例:000020E0）は指数形式で表示されることがあります。テキストファイルで表示すれば，文字列表示で確認できます。

破壊されたイベントDBをcsvファイルに出力した場合，破損していないデータは正常に出力されますが，破損しているデータ部分には，KAJP1765-Wのメッセージが出力されます。

このコマンドで出力できるcsvファイルのサイズは2ギガバイトまでです。イベントサーバ環境設定ファイル（conf）のdb-sizeパラメーターを1ギガバイト以上の値に設定している場合，フィルターを指定しないでコマンドを実行すると，csvファイルが2ギガバイトに達してコマンドがエラーになるおそれがあります。このコマンドをエラーにしないためには，-fオプションで出力するイベントを絞り込むか，-iオプションで1面ずつ出力してください。

戻り値

0 | 正常終了
1 | 引数エラー
2 | コマンド処理中にイベントDBの切り替わりが発生したためcsv出力を中断した
3 | イベントDBに破損レコードを検出した
255 | そのほかのエラー

使用例

使用例を次に示します。

イベントサーバ名がServiceのイベントDBからfilter.txtに記述されたフィルター条件に合致したJP1イベントだけを取り出し，conf.txtファイルで指定された固有情報だけをcsv形式に変換して，csvconv.csvファイルに出力します。

jevexport -h Service -o csvconv.csv -f filter.txt -k conf.txt

jevlogdstart（UNIX限定）

機能

ログファイルトラップ管理デーモンを起動します。

形式

jevlogdstart

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

戻り値

0 | 正常終了
255 | 異常終了

jevlogdstat

機能

ログファイルトラップ管理サービス（デーモン）の動作状況を表示します。このコマンドを実行すると，ログファイルトラップ管理サービス（デーモン）の動作状況をメッセージや戻り値で確認できます。

形式

jevlogdstat

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

戻り値

0 | ログファイルトラップ管理サービス（デーモン）が起動している
1 | 引数エラー
2 | ログファイルトラップ管理サービス（デーモン）が起動していない
4 | ログファイルトラップ管理サービス（デーモン）が起動処理中
7 | メモリー不足
8 | 実行権限エラー
9 | 通信エラー
255 | そのほかのエラー

jevlogdstop（UNIX限定）

機能

ログファイルトラップ管理デーモンを終了します。

形式

jevlogdstop

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

注意事項

ログファイルトラップ管理デーモンは，物理ホスト，論理ホスト共通のデーモンです。また，jevlogdstopコマンドを実行すると，ログファイルトラップが使用できなくなります。jevlogdstopコマンドを実行する場合は，物理ホストおよび論理ホストでログファイルトラップを使用していないか十分に確認してください。

戻り値

0 | 正常終了
1 | 引数エラー
2 | 管理デーモンが起動していない
255 | そのほかのエラー

jevlogreload

機能

ログファイルトラップ動作定義ファイルをリロードします。リロードできる定義情報は，jevlogstartコマンドで起動時に指定した動作定義ファイルのMARKSTR，ACTDEFパラメーターの値だけです。

形式

jevlogreload { ID番号 | -a 監視名 | ALL }

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

ID番号

リロードしたいログファイルトラップのID番号を指定します。なお，ID番号は，jevlogstartコマンドの実行時に，標準出力に出力されます。

-a 監視名

リロードしたいログファイルトラップの監視名を指定します。なお，監視名は，jevlogstartコマンドの-aオプションで指定した名称です。

ALL

jevlogstartコマンドで起動したすべてのログファイルトラップをリロードします。

注意事項

MARKSTR，ACTDEF以外のパラメーターを，起動時に設定した値と異なる値で設定すると，コマンド実行時エラーとなりリロードできません。MARKSTR，ACTDEF以外のパラメーターを変更したい場合は，該当するログファイルトラップを再起動してください。また，リロードコマンド実行時にトラップ処理を行っていた場合，そのトラップ処理の完了後，リロード処理を行います。

戻り値

0
正常終了

1
引数エラー

2
サービスまたは管理デーモンが起動していない

3
指定IDまたは監視名のログファイルトラップは存在しない（すでに終了している）
ALL指定の場合は，ログファイルトラップが一つも存在しない

4
動作定義ファイルに誤りあり

5
動作定義ファイルオープンエラー

6
イベントサーバが起動していない

7
メモリーなどシステムリソース不足

8
権限チェックエラー

10
一部リロード失敗

255
そのほかのエラー

jevlogstart

機能

ログファイルトラップを起動します。このコマンドを実行すると，オプションに指定したログファイルを検索し，ログファイルトラップ動作定義ファイルで指定した条件に合うログの1行をJP1イベント化して，イベントサーバに登録します。このコマンドの起動前に，ログファイルトラップ動作定義ファイルを作成しておく必要があります。

ログファイルに出力されるデータの形式が異なるファイルは同時に扱えません。この場合は，新たに別のログファイルトラップを起動してください。

なお，クラスタ運用でのフェールオーバー時に，ログファイルトラップ起動定義ファイルに指定されているログファイルトラップをまとめて起動するためのコマンドについては，「jevlogstart（クラスタ運用限定）」を参照してください。

形式

jevlogstart [-f ログファイルトラップ動作定義ファイル名]
           [-t ファイル監視間隔（秒）]
           [-m イベント化するデータの最大長（バイト）]
           [-h]
           [-n 表示コマンド名]（UNIX限定）
           [-p ログデータ出力元プログラム名]
           [-r]
           [-s 登録先イベントサーバ名]
           [-a 監視名]
           [-x]
           ログファイル名1[ログファイル名32(100)]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f 動作定義ファイル名

ログファイルトラップ動作定義ファイルの名称を256バイト以内で指定します。なお，相対パス名を指定する場合，ディレクトリ名を補ったフルパス名が256バイト以内になるように指定してください。相対パスはこのコマンドを実行するカレントディレクトリからの相対パスです。あらかじめconfフォルダにjevlog.confを作成し，そこに動作定義内容を指定しておいた場合，このオプションは省略できます。

jevlog.confの格納先ディレクトリは次のとおりです。

Windowsの場合

インストール先フォルダ¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/

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

ログファイルの監視間隔（1～86,400秒）を指定します。このオプションを省略すると，10が仮定されます。

WRAP1，WRAP2またはHTRACEの形式のログファイルを監視する場合

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

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

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

指定したログファイルを読み込むとき，ログファイルの1行を，先頭から何バイト（1～1,024）までJP1イベントにするのかを指定します。行の終了文字は終了記号「¥0」に変更されます。先頭からのバイトの指定には，「¥0」が含まれます。読み込んだログファイルの1行がこのオプションで指定されたバイト数を超えた場合，イベント化するデータは「-mで指定したバイト数 - 1バイト」になります。

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

-h

ログを先頭から読み込みたい場合に指定します。ログを出力するプログラムを起動したあとにこのコマンドを実行すると，この時点ですでに出力されているログは読み込まれません。しかし，このオプションを指定すれば，ファイルの先頭データから読み込みができるようになります。ラップアラウンドファイルの場合，ファイルの先頭からEOF（End Of File）までデータを読み込んだ後，カレント入力ポインターを見つけて，最新データを読み込んでいきます。

-n 表示コマンド名

このオプションはUNIXだけで使用できます。

ログファイルトラップの表示コマンド名を指定します。この表示コマンド名は，psコマンドで表示できます。なお，コマンド名は256バイト以内で指定してください。このオプションを省略した場合，「ログファイル名1」が表示コマンド名に仮定されます。

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

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

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

Windowsの場合

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

UNIXの場合

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

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

-r

-rオプションを指定しておくと，ログファイルトラップ起動時に指定したログファイルが存在しなかった場合，そのファイルが作成されるまで，-tオプションで指定した間隔でオープンを試みます。オープンに成功すると検索を開始します。

共有ディスクのログファイルを監視する場合は，論理ホストの起動と停止に合わせてログファイルトラップを起動および停止してください。なお，-rオプションは，ログファイルトラップの起動後に作成されるログファイルを監視する場合に指定してください。

このオプションを省略した場合，ログファイルトラップを起動した時点で，指定したログファイルが存在していない場合，ログファイルトラップはログファイルのオープンを中止し，処理を終了します。

-s 登録先イベントサーバ名

JP1イベント登録先のサーバ名を，このオプションで指定されたサーバ名に変更します。指定できるイベントサーバは，自ホストで稼働しているイベントサーバに限ります。このオプションを省略すると，自ホストと同じイベントサーバ名（hostnameコマンドが返すホスト名）が仮定されます。イベントサーバ名は255バイト以内で指定してください。大文字，小文字は区別されます。

このオプションは，主にクラスタシステムで使用します。

また，自ホスト名がショート名の環境で物理ホストのイベントサービスをFQDN形式で起動している場合は，このオプションで明示的にFQDN形式のイベントサーバ名を指定してください。

-a 監視名

ID番号に代わる別名として監視名を指定します。監視名は30バイト以内で指定してください。使用できる文字は，英数字，ハイフン，およびアンダーラインです。監視名の先頭の文字は，必ず英数字を指定してください。大文字，小文字は区別されます。

-x

ログファイルをJP1イベント化したときの拡張属性JP1_SOURCEHOSTに，ログデータの出力元ホスト名を設定する場合に指定します。

ログファイル名1[ ...ログファイル名32(100)]

監視するログファイル名を256バイト以内で指定します。なお，相対パス名を指定する場合，ディレクトリ名を補った完全名が256バイト以内になるように指定してください。相対パスはこのコマンドを実行するカレントディレクトリからの相対パスです。ログファイル名の先頭に「-（ハイフン）」を指定しないでください。

指定できる個数はWindowsでは32個，UNIXでは100個までです。ただし，オープンできるファイル数が各システムによって異なるため，実際に指定できる個数の最大値は，Windowsでは32以下，UNIXでは100以下になる場合があります。また，UNIXの場合，1ログファイルの監視につき，1プロセスを使用します。psコマンドで表示されるコマンド名は「ログファイル名.child」です。

ログファイルの形式によっては監視できない場合があります。監視できるログファイルおよび監視できないログファイルの形式については，「1.5.1（1）　監視できるログファイル」を参照してください。

注意事項

ログファイルトラップは，ログを出力するプログラムを起動する前に起動してください。ログ出力中のファイルに対してログファイルトラップを起動すると，正しくトラップできません。まだ，存在していないログファイルを指定する場合は，-rオプションでログファイルトラップを待機させてください。

Windowsの場合はログファイルトラップ管理サービス，UNIXの場合はログファイルトラップ管理デーモンが起動しているのを確認してから，jevlogstartコマンドを実行してください。

戻り値

0 | 正常終了
1 | 引数エラー
2 | サービスまたは管理デーモンが起動していない
3 | イベントサービスが起動していない
4 | 同一の監視名で起動済み（-aオプション指定時だけ）
255 | そのほかのエラー

また，jevlogstartコマンドを実行すると，標準出力にID番号を出力します。このID番号はログファイルトラップを終了するときに必要になります。

使用例

この使用例は，Windowsの場合です。

（例1）

ログファイルc:¥log¥logfile1.logから検索し，読み込みます。ここでの引数はログファイル名以外すべて省略しています。ログファイルトラップ動作定義ファイルはJP1/Baseのconfフォルダ内のjevlog.conf，ファイル監視間隔は10秒，イベント化するデータの最大長は512バイトが仮定されます。

jevlogstart c:¥log¥logfile1.log

（例2）

ログファイルトラップ動作定義ファイルをc:¥conf¥configfile.confにして，ログファイル c:¥log¥logfile1.logから検索し，読み込みます。

jevlogstart -f c:¥conf¥configfile.conf c:¥log¥logfile1.log

（例3）

ファイル監視間隔を5秒にして，ログファイルc:¥log¥logfile1.logとc:¥log¥logfile2.logから検索し，読み込みます。

jevlogstart -t 5 c:¥log¥logfile1.log c:¥log¥logfile2.log

jevlogstart（クラスタ運用限定）

機能

ログファイルトラップ起動定義ファイルのSTART_OPT_CLSパラメーターに指定されているログファイルトラップを起動します。このコマンドをクラスタソフトに登録することで，クラスタ運用でのフェールオーバー時に，新たに実行系となったサーバでログファイルトラップをまとめて起動できます。

形式

jevlogstart -cluster [クラスタID]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-cluster [クラスタID]

ログファイルトラップ起動定義ファイルのSTART_OPT_CLSパラメーターに指定されているログファイルトラップのうち，指定したクラスタIDに対応するログファイルトラップが起動されます。クラスタIDに指定できる値は0～99です。クラスタIDの指定を省略すると，クラスタIDの値に0が仮定されます。

注意事項

起動の対象となるログファイルトラップが複数ある場合，KAVA3652-Iのメッセージが出力された直後では，すべてのログファイルトラップが起動していないときがあります。コマンドを実行したあと，しばらくしてからログファイルトラップが起動したかどうか確認してください。

戻り値

0 | 正常終了
1 | 引数エラー
2 | サービスまたは管理デーモンが起動していない
255 | そのほかのエラー

jevlogstat

機能

ログファイルトラップの動作状況を表示します。このコマンドを実行すると，引数に指定したID番号または監視名を持つログファイルトラップの動作状況を戻り値で返します。

形式

jevlogstat { ID番号 | -a 監視名 | ALL }

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

ID番号

動作状態を確認したいログファイルトラップのID番号を指定します。なお，ID番号は，jevlogstartコマンドの実行時に，標準出力に出力されます。

-a 監視名

動作状態を確認したいログファイルトラップの監視名を指定します。なお，監視名は，jevlogstartコマンドの-aオプションで指定した名称です。

ALL

jevlogstartコマンドで起動したすべてのログファイルトラップのID番号を表示します。なお，監視名が設定されている場合は，監視名を付加して表示します。

戻り値

0
指定IDのログファイルトラップは動作中
ALL指定の場合は，動作中のログファイルトラップが最低一つは存在する

1
引数エラー

2
サービスまたは管理デーモンが起動していない

3
指定IDのログファイルトラップが存在しない（すでに終了している）

255
そのほかのエラー

jevlogstop

機能

ログファイルトラップを終了するコマンドです。

なお，クラスタ運用でのフェールオーバー時に，以前jevlogstart（クラスタ運用限定）コマンドによって起動されたログファイルトラップをまとめて終了するためのコマンドについては，「jevlogstop（クラスタ運用限定）」を参照してください。

形式

jevlogstop [-w] { ID番号 | -a 監視名 | ALL }

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-w

ログファイルトラップの停止前に，監視間隔に関係なく一度ログを読み込むため，jevlogstopコマンドを実行した時点まで監視されます。このオプションを指定しなかった場合は，前回の監視タイミングからjevlogstopコマンド実行時までの間に発生したログは監視されません。ログファイルの監視が終了するタイミングの違いを，次の図に示します。

図13-2　ログファイルの監視が終了するタイミングの違い

監視対象のログデータ量，およびリトライ中に保留されたJP1イベントの件数によっては，コマンドを実行してから終了するまでの時間が長くなる場合があります。クラスタシステム運用時で，フェールオーバー発生時の終了処理にこのオプションを使用する際は注意が必要です。

ID番号

終了したいログファイルトラップのID番号を指定します。なお，ID番号は，jevlogstartコマンドの実行時に，標準出力に出力されます。

-a 監視名

終了したいログファイルトラップの監視名を指定します。なお，監視名は，jevlogstartコマンドの-aオプションで指定した名称です。

ALL

jevlogstartコマンドで起動したすべてのログファイルトラップが終了します。

戻り値

0
正常終了

1
引数エラー

2
サービスまたは管理デーモンが起動していない

3
指定IDまたは監視名のログファイルトラップが存在しない（すでに終了している）
ALL指定の場合は，ログファイルトラップが一つも存在しない

255
そのほかのエラー

jevlogstop（クラスタ運用限定）

機能

このコマンドが実行される以前にjevlogstart（クラスタ運用限定）コマンドによって起動されたログファイルトラップを終了します。このコマンドをクラスタソフトに登録することで，クラスタ運用でのフェールオーバー時に，切り替え前のサーバでログファイルトラップをまとめて終了できます。

形式

jevlogstop -cluster [クラスタID]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-cluster [クラスタID]

このコマンドが実行される以前に，同じクラスタIDが指定されたjevlogstart（クラスタ運用限定）コマンドによって起動されたログファイルトラップを終了します。クラスタIDに指定できる値は0～99です。クラスタIDの指定を省略すると，クラスタIDの値に0が仮定されます。

戻り値

0 | 正常終了
1 | 引数エラー
2 | サービスまたは管理デーモンが起動していない
3 | 対象のログファイルトラップが存在しない（すでに終了している）
255 | そのほかのエラー

jevregsvc（Windows限定）

機能

Windowsで，次の場合にイベントサーバのサービスを追加・削除するコマンドです。

クラスタシステムで運用する場合※

非クラスタ環境で論理ホストを運用する場合※

DNSを使ったシステムでイベントサーバを設定する場合

JP1/NETM/Auditで監査ログ専用イベントサーバを設定する場合

注※

jp1bshasetupコマンドで自動的に実行されるため，手動での実行は必要ありません。

形式

jevregsvc -r [イベントサーバ名]
jevregsvc -u [イベントサーバ名]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-r イベントサーバ名

イベントサーバのサービスを追加します。イベントサーバ名を省略すると，自ホスト名が仮定されます。

-u イベントサーバ名

イベントサーバのサービスを削除します。イベントサーバ名を省略すると，自ホスト名が仮定されます。

注意事項

イベントサーバ名は，イベントサーバインデックスに指定したものと大文字小文字を含めて完全に一致させてください。

戻り値

0 | 正常終了
1 | 引数エラー
255 | そのほかのエラー

jevreload

機能

転送設定ファイル（forward）をリロードします。

形式

jevreload [-h イベントサーバ名]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

転送設定ファイル（forward）をリロードしたいイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

戻り値

0 | 正常終了
1 | 引数エラー
2 | 指定されたイベントサーバが未起動
3 | 転送設定ファイルに誤りがある
255 | そのほかのエラー

使用例

使用例を次に示します。

イベントサーバevserver1の転送設定ファイル（forward）をリロードします。

jevreload -h evserver1

jevsend

機能

イベントサーバにJP1イベントを登録します。

形式

jevsend [-i イベントID]
       [-m メッセージ]
       [[-e 拡張属性名=拡張属性値] ...]
       [-d 送信先イベントサーバ名]
       [-s 送信元イベントサーバ名]

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-i イベントID

登録するJP1イベントのイベントIDを指定します。指定できる範囲は，0～1FFF，7FFF8000～7FFFFFFFです。このオプションを省略すると，0が仮定されます。

-m メッセージ

登録するJP1イベントのメッセージテキストを指定します。メッセージテキストは，1,023バイト以下の文字列で指定してください。

-e 拡張属性名=拡張属性値 ...

登録するJP1イベントの拡張属性を指定します。登録する拡張属性の設定は「-e 拡張属性名=拡張属性値」を1組として複数記述できます。「=」と拡張属性値の間には空白（スペースやタブなど）を入れないでください。拡張属性とは次に示す内容の100個までの集まりのことです。なお，すべての属性値の長さの合計が，10,000バイトに制限されます。

拡張属性 | 内容 | 形式
拡張属性名 | 属性の意味を表す名称 | 英数字またはアンダーライン（英字は大文字，先頭は英字）から成る32バイトまでの文字列
拡張属性値 | 属性の内容 | 文字列（0～10,000バイト）

なお，拡張属性名にSEVERITYを指定したJP1イベントは，JP1/IM - Viewの［イベントコンソール］画面の一覧に表示されます。SEVERITYの拡張属性値は，「15.1.2　拡張属性」の項目「重大度」の内容の中から指定し，必ず先頭を大文字にしてください。

-d 送信先イベントサーバ名

JP1イベントを転送設定ファイル（forward）で指定されたイベントサーバに送信しないで，任意のイベントサーバに送信したい場合，送信先のイベントサーバ名を指定します。イベントサーバ名は255バイト以内の文字列で指定してください。

注意事項

定義されていないイベントサーバ，起動されていないイベントサーバ，およびネットワークの障害などでイベントが届かないイベントサーバなどを指定してもエラーにはなりません。

このオプションを指定して送信したJP1イベントは，自ホストのイベントサーバからは取得できません。

このオプションを指定して，JP1イベントを他ホストのイベントサーバに送信する場合，イベントサーバ設定ファイル（conf）で設定したforward-limitパラメーターで指定したリトライの対象にはなりません。

-s 送信元イベントサーバ名

-dオプションを併用する場合は，転送のために使用するイベントサーバ名を指定します。-dオプションを指定しない場合は，イベントを登録するイベントサーバ名を指定します。指定できるイベントサーバは自ホストで稼働しているイベントサーバに限ります。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションは，主にクラスタシステムで使用します。

注意事項

オプションと値の間には1個以上の半角のスペースを入れてください。

メッセージテキスト，拡張属性値の途中にスペースを入れる場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。

コマンドのオプションで指定できるバイト数は，OSの制限に依存しますので，各OSの制限内で設定してください。

UNIXシステムで，メッセージまたは拡張属性に日本語の非ASCII文字を含める場合，LANG環境変数に，使用する文字コードを表す正しい値を設定しておいてください。

戻り値

0 | 正常終了
1 | 引数エラー
255 | そのほかのエラー

使用例

（例1）

イベントIDが111，メッセージが"BaseEvent_Sample"のJP1イベントを登録します。

jevsend -m BaseEvent_Sample -i 111

（例2）

イベントIDが111，拡張属性名が"EXTATTR"，拡張属性値が"Extend Value"を登録します。

jevsend -i 111 -e EXTATTR="Extend Value"

（例3）

次に示す拡張属性のJP1イベントを登録します。

拡張属性名が"EXTATTR"，拡張属性値が"extattr"

拡張属性名が"INCLUDESPACE"，拡張属性値が"include space"

jevsend -e EXTATTR=extattr -e INCLUDESPACE="include space"

（例4）

イベントIDが111，拡張属性名が"SEVERITY"，拡張属性値が"Information"のJP1イベントを登録します。

jevsend -i 111 -e SEVERITY=Information

jevsendd

機能

イベントサーバにJP1イベントを登録し，登録に成功したかどうかを確認できます。イベントサービスが起動しているのにJP1イベントが登録されない場合などに実行して，登録を確認できます。

形式

jevsendd [-i イベントID]
        [-m メッセージ]
        [[-e 拡張属性名=拡張属性値] ...]
        -d 送信先イベントサーバ名
        [-s 送信元イベントサーバ名]
        [-f 初期ポーリング間隔(秒)]
        [-p ポーリング間隔(秒)]
        [-t 確認回数]

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-i イベントID

登録するJP1イベントのイベントIDを指定します。指定できる範囲は，0～1FFF，7FFF8000～7FFFFFFFです。このオプションを省略すると，0が仮定されます。

-m メッセージ

登録するJP1イベントのメッセージテキストを指定します。メッセージテキストは，1,023バイト以下の文字列で指定してください。

-e 拡張属性名=拡張属性値 ...

登録するJP1イベントの拡張属性を指定します。登録する拡張属性の設定は「-e 拡張属性名=拡張属性値」を1組として複数記述できます。「=」と拡張属性値の間には空白（スペースやタブなど）を入れないでください。拡張属性とは次に示す内容の100個までの集まりのことです。なお，すべての属性値の長さの合計が，10,000バイトに制限されます。

拡張属性 | 内容 | 形式
拡張属性名 | 属性の意味を表す名称 | 英数字またはアンダーライン（英字は大文字，先頭は英字）から成る32バイトまでの文字列
拡張属性値 | 属性の内容 | 文字列（0～10,000バイト）

なお，拡張属性名にSEVERITYを指定したJP1イベントは，JP1/IM - Viewの［イベントコンソール］画面の一覧に表示されます。SEVERITYの拡張属性値は，「15.1.2　拡張属性」の項目「重大度」の内容の中から指定し，必ず先頭を大文字にしてください。

-d 送信先イベントサーバ名

送信先のイベントサーバ名を指定します。イベントサーバ名は255バイト以内の文字列で指定してください。

注意事項

このオプションを指定して送信したJP1イベントは，自ホストのイベントサーバからは取得できません。

このオプションを指定して，JP1イベントを他ホストのイベントサーバに送信する場合，イベントサーバ設定ファイル（conf）で設定したforward-limitパラメーターの指定によるリトライの対象にはなりません。

-s 送信元イベントサーバ名

転送のために使用するイベントサーバ名を指定します。指定できるイベントサーバは自ホストで稼働しているイベントサーバに限ります。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションは，主にクラスタシステムで使用します。

-f 初期ポーリング間隔(秒)

JP1イベントを送信先イベントサーバへ送信してから最初の到達確認までの待ち時間を1～10秒で指定します。このオプションを省略すると，3秒が仮定されます。

-p ポーリング間隔(秒)

初回の到達確認でJP1イベントが到達していなかった場合，2回目以降の到達確認をする間隔を3～600秒で指定します。このオプションを省略すると，10秒が仮定されます。

-t 確認回数

2回目以降の到達確認の確認回数を0～999で指定します。このオプションを省略すると，0が仮定されます。

注意事項

オプションと値の間には1個以上の半角のスペースを入れてください。

メッセージテキスト，拡張属性値の途中にスペースを入れる場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。

ダブルクォーテーションマーク（"）の前に円記号を付けた場合（¥"），ダブルクォーテーションマークとして解釈されます。

次に示す特殊文字を含む場合，ダブルクォーテーションマーク（"）で囲む必要があります。
# ; | & ( ) ^ < > スペース タブ

コマンドのオプションで指定できるバイト数は，OSの制限に依存しますので，各OSの制限内で設定してください。

UNIXシステムで，メッセージまたは拡張属性に日本語の非ASCII文字を含める場合，LANG環境変数に，使用する文字コードを表す正しい値を設定しておいてください。

このコマンドは，到達確認がされるか，エラーを検知するまで制御を返しません。

戻り値

0 | 正常終了
1 | 引数エラー
2 | 処理は続行中（最大到達待ち時間内に到達確認ができなかった場合）
3 | 転送に失敗した
255 | そのほかのエラー

補足事項

-f，-p，-tオプションを指定した場合の動作を次の図に示します。

図13-3　-f，-p，-tオプションを指定した場合の動作

最大到達待ち時間は，次の式で求まります。

最大到達待ち時間 = -fで指定した秒数 + -pで指定した秒数 × -tで指定した回数

最大到達待ち時間内に到達確認ができなかった場合，エラーメッセージを出力して終了します。

jevstart（UNIX限定）

機能

手動でイベントサーバを起動します。

形式

jevstart [イベントサーバ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

イベントサーバ名

起動するイベントサーバを指定します。イベントサーバ名を省略すると，自ホストと同じイベントサーバ名が仮定されます。

戻り値

0 | 正常終了
255 | 異常終了

jevstat

機能

イベントサービスのプロセス群（jevservice）の動作状況を確認できます。イベントサービスのプロセスについては，「付録B　プロセス一覧」を参照してください。

形式

jevstat [イベントサーバ名]
       [-t 時間（秒）]

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

イベントサーバ名

クラスタシステムなどで運用している場合に，イベントサービスのプロセス群が起動または終了しているか確認したいイベントサーバ名を指定します。大文字，小文字は区別されます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

-t 時間（秒）

jevstatコマンドの実行終了を待つ時間を指定します。指定できる値は，1～32,767（秒）です。指定した時間内にjevstatコマンドの実行が終わらない場合，jevstatコマンドの実行が失敗したと見なします。省略した場合は，60が設定されます。

注意事項

イベントサービス起動直後にjevstatコマンドを実行すると，エラーメッセージ「KAJP1706-E　イベントサーバに接続できません」が出力される場合があります。このようなときは，イベントサービスの起動から数秒あけてjevstatコマンドを実行してください。

jevstatコマンドを実行し，統合トレースログに「KAJP1775-E　通信データの送受信に失敗しました（保守情報）」が出力された場合には，コマンドの実行がタイムアウトしているおそれがあります。-tオプションにコマンドの実行終了を待つ時間を指定して，jevstatコマンドを再実行してください。

戻り値

0 | すべてのプロセスが起動している
1 | 異常終了（コマンドの処理でエラーが発生）
4 | 一部のプロセスが起動している
8 | すべて停止している
12 | 異常終了（イベントサーバがエラーを返した）

補足事項

UNIX上のクラスタシステムで運用している場合，論理ホストの異常検知スクリプトにjevstatコマンドを組み込んで利用できます。この場合，論理ホスト上で動作させるイベントサーバ名の大文字小文字を意識して正しく指定してください。論理ホスト用イベントサーバ名は，イベントサーバインデックスファイル（index）に定義されているので，これを参考にして指定してください。

イベントサーバインデックスファイル（index）の定義例と，それを基にjevstatコマンドを実行した場合の実行結果を次に示します。

イベントサーバインデックスファイル（index）内の定義例

server * default
server HOSTZZ /jp1/share/

jevstatコマンド実行例と実行結果

jevstatコマンド実行例 | 実行結果
jevstat | 物理ホスト上のイベントサーバの状態を表示します。
jevstat hostzz | 指定されたイベントサーバ名が見つからない旨のエラーメッセージを表示します。
jevstat HOSTZZ | 論理ホスト上のイベントサーバの状態を表示します。

使用例

jevstatコマンドの実行例をWindows，UNIXに分けて次に示します。

Windowsの場合

E:¥>jevstat
KAJP1771-I HOST1の状態通知処理を開始します
稼働中のプロセスを表示します
プロセス名称  プロセスID
 jevservice        1234
KAJP1772-I プロセスは全て起動しています

UNIXの場合

$ /opt/jp1base/bin/jevstat
KAJP1771-I HOST1の状態通知処理を開始します
稼働中のプロセスを表示します
プロセス名称  プロセスID
 jevservice        2098
KAJP1772-I プロセスは全て起動しています

KAJP1772-Iは，イベントサーバとして必要なプロセスがすべて起動しているときに表示されるメッセージです。

jevstop（UNIX限定）

機能

手動でイベントサーバを停止します。

形式

jevstop [イベントサーバ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

イベントサーバ名

起動するイベントサーバを指定します。イベントサーバ名を省略すると，自ホストと同じイベントサーバ名が仮定されます。

戻り値

0 | 正常終了
255 | 異常終了

Jischk

機能

ISAMファイルの論理構造を検証し，不正がある場合にメッセージを表示します。指定された検証レベルに応じて，ISAMファイルを構成する各ファイルの内容や，ファイルの関連などを検証します。

また，UNIXでは，キーファイルが不正な場合，キーの情報を表すキー定義パラメーターを出力できます。このパラメーターを使用すると，Jiskeymnt（キーの追加，削除，および再構築）コマンドでキーファイルを再構築できます。

形式

Jischk [-l レベル] ファイル名 ...（Windowsの場合）
Jischk [-l レベル] [-p] ファイル名 ...（UNIXの場合）

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-l レベル

ファイルを検証するレベルを指定します。レベルの数字が大きいほど，検証の内容が厳密になり，処理時間が長くなります。

1

Windowsの場合，キーファイルだけを検証します。

UNIXの場合，キー定義ファイル，およびキーファイルを検証します。

2

Windowsの場合，キーファイル，およびキーファイルとデータファイルの関連を検証します。

UNIXの場合，キー定義ファイル，キーファイル，およびキーファイルとデータファイルの関連を検証します。

3

次の項目を検証します。

キー定義ファイル（UNIX限定）

キーファイル

キーファイルとデータファイルの関連

データファイルの構造

レコード件数

省略時は，1が仮定されます。

-p

キーファイルの不正が検出されたとき，Jiskeymnt（キーの追加，削除，および再構築）コマンド用のキー定義パラメーターを標準出力する場合に指定します。なお，このオプションはUNIXだけで使用できます。

ファイル名

検証するファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。複数のファイルを指定する場合は，ファイル名を1文字以上のスペースで区切ります。また，ワイルドカード（*）を使用してファイルを指定できます。なお，Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

（例）

Windowsの場合の指定例を次に示します。

ディレクトリ"c:¥data"にあるすべてのファイルを指定します。

Jischk -l3 c:¥data¥*

ディレクトリ"c:¥data"にある，ファイル名が"SAMPLE"で始まるファイルを指定します。

Jischk -l3 c:¥data¥SAMPLE*

注意事項

複数のファイルを指定したときに，処理の途中で入出力エラーが発生した場合や，ファイルがなかった場合は，その時点でコマンドの実行は終了します。

Windowsで，検証結果をテキストファイルなどに出力したい場合は，>のあとに出力先のファイル名を指定します。指定例を次に示します。

（例）

Jischk -l3 sample > chk.txt

戻り値

0 | 正常終了
1 | 異常終了
2 | 異常終了（ファイルの不整合があった場合に返される）

Jiscond

機能

データファイルの無効領域を圧縮します。同時に，キーファイルを再構築します。

レコードを更新したり，レコードを削除したりすると，データファイルに無効領域が発生します。このコマンドでは，データファイルの無効データを除去して，データファイルを圧縮します。また，キー定義ファイルのキー情報に従って，キーを抽出しながらキーファイルを再構築します。ただし，ファイルにキーが定義されていない場合，キーファイルは再構築しません。

形式

Jiscond [-r] [-d dir ワークフォルダ名] [-k | -q] ファイル名（Windowsの場合）
Jiscond [-T dir ワークディレクトリ名] [-k | -q] ファイル名（UNIXの場合）

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-r

データファイルおよびキーファイルの圧縮率を表示する場合に指定します。指定すると，ファイル圧縮ユーティリティの実行結果に，圧縮前のファイルサイズに対する圧縮後のファイルサイズの割合が表示されます。

-d dir ワークフォルダ名

ファイルの圧縮では，キーファイルをソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。省略時は，環境変数のtemp，またはtmpで指定されたディレクトリ，またはカレントディレクトリを使用します。なお，このオプションはWindowsだけで使用できます。

-T dir ワークディレクトリ名

ファイルの圧縮では，キーファイルをソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。省略時は，/tmp，または/usr/tmpを使用します。なお，このオプションはUNIXだけで使用できます。

-k

ISAMファイルの再編成と同時に，肥大化抑止を設定する場合に指定します。JP1の運用を長期間継続すると，ISAMデータベースのインデックスであるキーファイルのサイズが際限なく増加するため，定期的にISAMファイルを再編成する必要があります。この引数を指定すれば，キーファイルの肥大化を抑止できます。

-q

ISAMファイルの再編成と同時に，肥大化抑止の設定を解除する場合に指定します。JP1を以前のバージョンに戻すためには，以前のバージョンで対応していない機能を解除する必要があります。この引数を指定すれば，以前のバージョンのJP1でもISAMファイルをアクセスできます。

ファイル名

検証するファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。Windowsで，複数のファイルを指定する場合は，ファイル名を1文字以上のスペースで区切ります。スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。また，ワイルドカード（*）を使用してファイルを指定できます。

（例）

Windowsの場合の指定例を次に示します。

ディレクトリc:¥dataにあるすべてのファイルを指定します。

Jiscond c:¥data¥*

ディレクトリc:¥dataにある，ファイル名がSAMPLEで始まるファイルを指定します。

Jiscond c:¥data¥SAMPLE*

注意事項

ファイルを圧縮するときにワークファイルを使用します。また，ファイルの圧縮では，データファイルの複製を作成してからキーファイルを構築するので，容量の大きいファイルを圧縮する場合には注意が必要です。

Windowsで，複数のファイルを指定したときに，処理の途中で入出力エラーが発生した場合，またはファイルがなかった場合は，その時点でコマンドの実行は終了します。

Windowsで，圧縮率を表示する指定にすると，結果が表示されるまでに多少時間が掛かります。

06-71以前のJP1/Baseの実行系・待機系が使用する共有ディスク上にISAMファイルを作成しているシステムで，ISAMファイルに対して肥大化抑止の設定をしたい場合は，実行系・待機系のJP1/Baseのバージョンを07-00以降にしたあと，共有ディスク上のISAMファイルに対して肥大化抑止の設定をしてください。

実行系・待機系で共有ディスク上に作成したISAMファイルに対して肥大化抑止の設定をしているシステムで，JP1/Baseを06-71以前のバージョンに戻す場合は，共有ディスク上のISAMファイルの肥大化抑止設定を解除してから，実行系・待機系のJP1/Baseのバージョンを戻してください。

戻り値

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

Jisconv

機能

順編成ファイルをISAMファイルに変換します。また，ISAMファイルを順編成ファイルに変換します。

このコマンドは，障害が発生したISAMファイルから順編成ファイルに抽出したデータレコードを，ISAMファイルのデータファイルに回復する場合などに使用します。

ISAMファイルに変換する

キー定義ファイルの内容に従って，順編成ファイルをISAMファイルのデータファイルに変換します。このとき，同時にキーファイルを作成します。ただし，ISAMファイルにキーが定義されていない場合，キーファイルは作成しません。

変換元の順編成ファイルと変換先のISAMファイルは，レコード種別が同じでなければなりません。レコード種別の関係を，次の表に示します。

表13-3　レコード種別の関係（ISAMファイルに変換する場合）

順編成ファイル（変換元） | ISAMファイル（変換先）
固定長 | 可変長
固定長 | ○ | ×
可変長 | × | ○

（凡例）

○：変換する

×：変換しない

レコード長の扱いは，次のようになります。

固定長の順編成ファイルを固定長のISAMファイルに変換する場合
変換先のキー定義ファイルに定義されているレコード長を，変換元のレコード長と見なして変換します。

可変長の順編成ファイルを可変長のISAMファイルに変換する場合
変換元の各レコードのレコード長に従って変換します。
変換元のレコード長が，変換先のキー定義ファイルに定義されているレコード長の範囲に含まれていない場合は，変換元のレコード長を不正と見なし，変換を中止します。

注意事項

順編成ファイルをISAMファイルに変換する際の注意事項を次に示します。

変換先のISAMファイルを，あらかじめ作成しておく必要があります。

ISAMファイルに変換する際，ワークファイルを使用します。

順編成ファイルに変換する

ISAMファイルのデータファイルを，順編成ファイルに変換します。変換元のレコードは，データファイル中での物理的な並び順に従って出力されます。データファイル中の削除レコードは，出力されません。

変換元のISAMファイルと変換先の順編成ファイルは，レコード種別が同じでなければなりません。レコード種別の関係を，次の表に示します。

表13-4　レコード種別の関係（順編成ファイルに変換する場合）

ISAMファイル（変換元） | 順編成ファイル（変換先）
固定長 | 可変長
固定長 | ○ | ×
可変長 | × | ○

（凡例）

○：変換する

×：変換しない

レコード長の扱いは，次のようになります。

固定長のISAMファイルを固定長の順編成ファイルに変換する場合
変換元のキー定義ファイルに定義されているレコード長を，変換先のレコード長と見なして変換します。

可変長のISAMファイルを可変長の順編成ファイルに変換する場合
変換元のキー定義ファイルに定義されている最小レコード長，および最大レコード長を，変換先の最小レコード長，および最大レコード長と見なして変換します。

形式

Jisconv [-f] -t タイプ [-d dir ワークフォルダ名] ファイル名1 ファイル名2（Windowsの場合）
Jisconv -t タイプ [-T dir ワークディレクトリ名] ファイル名1 ファイル名2（UNIXの場合）

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f

ファイル名2で指定したものと同じファイル名のファイルが存在するとき，上書き確認メッセージを表示しない場合に指定します。なお，このオプションはWindowsだけで使用できます。

-t タイプ

ファイルの変換タイプを，次に示すどちらかで指定します。

SI

順編成ファイルをISAMファイルに変換します。

IS

ISAMファイルを順編成ファイルに変換します。

-d dir ワークフォルダ名

順編成ファイルをISAMファイルに変換する場合，キーファイルをソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。省略時は，環境変数のtemp，またはtmpで指定されたディレクトリ，またはカレントディレクトリを使用します。なお，このオプションはWindowsだけで使用できます。

-T dir ワークディレクトリ名

順編成ファイルをISAMファイルに変換する場合，キーファイルをソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。省略時は，/tmp，または/usr/tmpを使用します。なお，このオプションは，UNIXだけで使用できます。

ファイル名1

変換元ファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

UNIXの場合，順編成ファイルからISAMファイルへの変換で，ハイフン（-）を指定した場合は，標準入力を仮定します。

ファイル名2

変換先ファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。同じファイル名のファイルが存在する場合，上書きします。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

UNIXの場合，ISAMファイルから順編成ファイルへの変換で，ハイフン（-）を指定した場合は，標準出力を仮定します。

戻り値

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

Jiscpy

機能

指定したISAMファイルをコピーします。複数のISAMファイルを，指定したディレクトリにコピーすることもできます。

形式

Jiscpy コピー元ファイル名 コピー先ファイル名
Jiscpy コピー元ファイル名1 [コピー元ファイル名2 ...] コピー先ディレクトリ名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

コピー元ファイル名

コピーするISAMファイルを指定します。

コピー先ファイル名

コピー先のファイル名を指定します。

コピー元ファイル名1 [コピー元ファイル名2 ...]

ISAMファイルを複数コピーする場合に指定します。なお，ISAMファイルを複数指定する場合は，コピー先ディレクトリ名を指定する必要があります。

コピー先ディレクトリ名

コピーするISAMファイルを格納するディレクトリ名を指定します。

注意事項

ISAMファイルを安全にコピーするには，JP1/Baseを停止する必要があります。

戻り値

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

Jisext

機能

障害が発生したISAMファイルのデータファイルから，有効なレコードをできる限り抽出し，順編成ファイルに回復します。また，UNIXの場合，ISAMファイルのキー定義情報を出力します。

このコマンドでは，データファイルの先頭からレコードを検証し，不正を検出するまで，レコードを順編成ファイルへ出力します。次に，末尾からレコードを検証し，不正を検出するまで，レコードを順編成ファイルへ出力します。

レコードを抽出するとき，レコード種別，およびレコード長は，キー定義ファイルに基づいて決定されます。そのため，キー定義ファイルが破壊されている場合は，これらの属性をオプションで指定する必要があります。ファイルを検証したときに，定義ファイルの不正を検出したというメッセージが表示された場合，キー定義ファイルは破壊されています。なお，キー定義ファイルが正常な場合でも，これらの属性を指定できます。この場合，指定した属性でレコードが抽出されます。

形式

Jisext [-f レコード種別:レコード長] ファイル名1 ファイル名2（Windowsの場合）
Jisext {-p | -f レコード種別:レコード長} ファイル名1 [ファイル名2]（UNIXの場合）

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-p

キー定義パラメーターを標準出力したい場合に指定します。-fオプションと同時に指定できません。なお，このオプションは，UNIXだけで使用できます。

-f レコード種別:レコード長

ISAMファイルのレコード種別，およびレコード長を指定します。ここでの指定は，キー定義ファイルでの指定より優先されます。UNIXの場合，-pオプションと同時に指定できません。

レコード種別

レコード種別を，次のどちらかで指定します。

f：固定長

v：可変長

レコード長

レコード長を，1～65,503の範囲で指定します。

レコード種別が可変長の場合，最大レコード長を指定します。この場合，最小レコード長は1を仮定します。

ファイル名1

レコードを抽出するISAMファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

ファイル名2

抽出したレコードを出力する順編成ファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。同じファイル名のファイルが存在する場合，上書きします。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

HP-UX，およびSolarisの場合，省略できません。

戻り値

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

Jisinfo

機能

ISAMファイルを構成するファイルに関する情報，およびキーに関する情報を表示します。

次に示す，キー定義ファイルの内容を表示します。

データファイルに関する情報
レコード形式，レコード長，フラグ類

キーファイルに関する情報
キーファイルページ長，キー項目名，キー項目数，キーファイル名，フラグ類，キーの要素数，キーの位置，キーの長さ，キーの属性

形式

Jisinfo [-u] [-e] ファイル名（-eオプションはUNIX限定）

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-u

レコードの削除や更新によってデータファイルおよびキーファイルに未使用領域ができます。このファイルの未使用領域サイズの割合を表示する場合に指定します。なお，未使用領域率が高い場合は，ファイル圧縮ユーティリティで未使用領域率を0にできます。

-e

このオプションはUNIXだけで使用できます。

ISAMファイルの肥大化抑止機能の設定を確認する場合に指定します。設定が有効のときは，「キーファイル再利用」の項目に「再利用する」と表示されます。なお，Windowsの場合で肥大化抑止が設定されているとき，ISAMファイルの肥大化抑止の状態は常に表示されます。

ファイル名

キー定義情報を表示するファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。複数のファイルを指定する場合は，ファイル名を1文字以上のスペースで区切ります。また，ワイルドカード（*）を使用してファイルを指定できます。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

（例）

Windowsの場合の指定例を次に示します。

ディレクトリc:¥dataにあるすべてのファイルを指定します。

Jisinfo c:¥data¥*

ディレクトリc:¥dataにある，ファイル名がSAMPLEで始まるファイルを指定します。

Jisinfo c:¥data¥SAMPLE*

注意事項

複数のファイルを指定したときに，処理の途中で入出力エラーが発生した場合や，ファイルがなかった場合は，その時点でコマンドの実行は終了します。

検証結果をテキストファイルなどに出力したい場合は，>のあとに出力先のファイル名を指定します。指定例を次に示します。

（例）

Jisinfo sample > info.txt

未使用領域を表示する指定にすると，キー定義情報が表示されるまでに多少時間が掛かります。

未使用領域を表示する指定にすると，指定したISAMファイルがほかの処理でアクセス中の場合，占有エラーとなります。

戻り値

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

Jiskeymnt

機能

キーを追加，または削除したり，キーファイルを再構築したりします。追加，削除，および再構築するキーの情報は，テキストエディターやUNIXのviなどのエディターを使用して，キー定義パラメーターファイルに定義しておきます。

キーの追加

キー項目名やキーの定義情報を，キー定義ファイルへ追加します。また，追加するキーに対応するキーファイルを作成します。

キーの削除

キー項目名やキーの定義情報を，キー定義ファイルから削除します。また，削除するキーに対応するキーファイルを削除します。

キーの再構築

指定されたキーに対応するキーファイルを，現在のキー定義内容で再作成します。

形式

Jiskeymnt ファイル名（Windowsの場合）
Jiskeymnt [ファイル名  ...]（UNIXの場合）

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

ファイル名

キーを編集するISAMファイルの情報を記述した，キー定義パラメーターファイルのファイル名を指定します。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

UNIXの場合，省略時は，ISAMファイルのキー定義情報を標準入力から読み込みます。複数のファイルを指定する場合は，ファイル名を1文字以上のスペースで区切ります。また，ワイルドカード（*）を使用してファイルを指定できます。

（例）

Windowsの場合の指定例を次に示します。

ディレクトリc:¥dataにあるすべてのファイルを指定します。

Jiskeymnt c:¥data¥*

ディレクトリc:¥dataにある，ファイル名がSAMPLEで始まるすべてのファイルを指定します。

Jiskeymnt c:¥data¥SAMPLE*

キー定義パラメーターファイルの定義方法

キーの追加，削除，および再構築で使用するキー定義パラメーターファイルの定義方法を説明します。

パラメーターファイルの指定内容

キー定義パラメーターファイルに指定する内容を，次の表に示します。

表13-5　キー定義パラメーターファイルの指定内容（キーの追加，削除，および再構築）

キーワード
形式
内容

fi-
ファイル名※¹
ISAMファイルのファイル名を指定する。パス名を含めて指定できる。OSのファイル名の規則に従うこと。
Windowsの場合，スペースを含むファイル名は，ダブルクォーテーションマーク（"）で囲む。
UNIXの場合，指定できるファイル名の最大長は，ファイル名の長さに関するOSの制限値よりも4文字短い。

an-
キー項目名※²
キーを追加するとき，キー項目名を指定する。

dn-
キー項目名※²
キーを削除するとき，キー項目名を指定する。

rn-
キー項目名※²
キーを再構築するとき，キー項目名を指定する。すべてのキーを再構築する場合は，キー項目名を省略する。

ke-
t=キー属性
,p=キー位置
,l=キー長
[,ISDESC]
キーを追加するとき，キーの詳細を指定する。キー追加時は，必ず指定する。合成キーの場合，構成項目ごとに指定する。※³

キー属性

次のどれかを指定する。

c：文字型（CHARTYPE）

i：2バイト整数型（INTTYPE）

l：4バイト整数型（LONGTYPE）

f：計算機浮動型（FLOATTYPE）

d：計算機倍長型（DOUBLETYPE）

キー位置

レコード種別に応じて，次のように指定する。

固定長の場合：0～（レコード長－1）の範囲

可変長の場合：0～（最小レコード長－1）の範囲

キー長

キー属性に応じて，次のように指定する。

c（文字型）の場合：1～255の範囲

i（2バイト整数型）の場合：2

l（4バイト整数型）の場合：4

f（計算機浮動型）の場合：4

d（計算機倍長型）の場合：8

ISDESC

キーの要素が降順型であることを示す。省略時は昇順型とする。

cp-
重複情報，圧縮情報
キーを追加するとき，キーの重複および圧縮の情報を16進4桁で指定する。

ビット位置15：重複キー順序保証

キー値が重複した場合のキー作成順を保証するかを指定する。

0：保証する

1：保証しない

ビット位置14：スパースキーの有無

0：なし

1：あり

ビット位置1～13：予備（Windowsの場合）

(0000000000)₂固定

ビット位置4～13：予備（UNIXの場合）

(0000000000)₂固定

ビット位置1～3：圧縮レベル※⁴（UNIXの場合）

(111)₂：完全圧縮

(000)₂：圧縮なし

ビット位置0：重複キーの許可

0：認めない

1：認める

sp-
スパース文字
キーを追加するとき，スパース文字の内部値を16進2桁で指定する。cpパラメーターでスパースキーありを指定した場合に指定する。

注※1　末尾に".KDF"，".DRF"，および".K01"～".K99"を付けたファイル名は指定できない。

注※2　各キー項目名は半角で31バイトまで指定できる。また，an-パラメーターのキー項目名に"K01"～"K99"は指定できない。

注※3　キー属性，キー位置，キー長，および順序（ISDESC）がすべて同じ構成項目を，複数指定できない。

注※4　このISAMファイル管理では，圧縮レベルの指定内容に関係なく，キーは圧縮される。

キー定義パラメーターファイルには，追加するキー，削除するキー，および再構築するキーを，同時に指定できます。また，それぞれ複数のキーを指定できます。

パラメーターの記述方法

キー定義パラメーターファイルのパラメーターの記述方法を，次に示します。

パラメーターファイル定義時の注意事項

キー定義パラメーターファイルを定義するときの注意事項を，次に示します。

各パラメーターの間には，1個以上のスペースを指定してください。

（例）

fi-isamfile△rn-subkey1△...

（凡例）△：スペース

パラメーター内にスペースは指定できません。

（例）

ke-t=c△,p=10...

（凡例）△：スペース

注意事項

主キーの追加，および削除はできません。

キーの追加，および再構築では，ワークファイルを使用します。

UNIXで，複数のファイルを指定したときに，処理の途中で入出力エラーが発生した場合や，ファイルがなかった場合は，その時点でコマンドの実行は終了します。

戻り値

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

Jisktod

機能

障害が発生したISAMファイルのキーファイルから，有効なレコードをできる限り抽出し，順編成ファイルに回復します。また，このコマンドは，回復するISAMファイルに排他モードでロックをかけます。回復するISAMファイルにアクセスしている場合は，このコマンドを実行する前に必ずアクセスしていない状態にしてください。

ISAMファイルの以下に示す論理構造を検証し，キーファイルで管理している有効レコードを順編成ファイルへ出力します。

定義ファイルの論理構造

データファイルのサイズとレコードの論理構造

キーファイルの論理構造とデータファイルとの整合性

論理構造を検証した結果，不正を検出した場合は，指定されたメッセージ出力レベルに応じて，詳細なメッセージを出力します。致命的な不正を検出した場合は，コマンドは異常終了し，順編成ファイルは作成されません。ただし，不正の内容によっては，できる限り有効レコードを抽出します。

レコードを抽出するとき，レコード種別，およびレコード長は，キー定義ファイルに基づいて決定されます。そのため，キー定義ファイルが破壊されている場合は，レコードを抽出できません。

出力された順編成ファイルは，既存のファイルの変換コマンド（Jisconv）で，ISAMファイルに変換できます。変換先のレコード種別，およびレコード長は，順編成ファイルと同じにしてください。

形式

Windowsの場合

Jisktod [-k キー項目名]
       [-l メッセージの出力レベル]
       [-b バッファサイズ]
       [-d ワークフォルダ名]
       抽出対象のISAMファイル名 順編成ファイル名
Jisktod -c
       [-k キー項目名]
       [-l メッセージの出力レベル]
       [-b バッファサイズ]
       [-d ワークフォルダ名]
       検証対象のISAMファイル名

UNIXの場合

Jisktod [-k キー項目名]
       [-l メッセージの出力レベル]
       [-b バッファサイズ]
       [-T ワークディレクトリ名]
       抽出対象のISAMファイル名 順編成ファイル名
Jisktod -c
       [-k キー項目名]
       [-l メッセージの出力レベル]
       [-b バッファサイズ]
       [-T ワークディレクトリ名]
       検証対象のISAMファイル名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-c

ISAMファイルの論理構造の検証だけを実行したい場合に指定します。指定したISAMファイルの各キーファイルからレコードが抽出可能かどうかを検証します。ISAMファイルの論理構造を検証した結果，各キーファイルから抽出可能なレコード件数やエラーの内容を標準エラー出力にメッセージを出力します。

このオプションを指定する場合は，検証したいISAMファイル名を指定してください。

このオプションを省略した場合は，ISAMファイルの論理構造の検証を実行したあとに有効なレコードをできる限り抽出し，順編成ファイルに回復します。このオプションを省略する場合は，有効レコードを抽出するISAMファイル名と，抽出した有効レコードを出力する順編成ファイル名を指定してください。

-kオプションを指定した場合は，検証したいキーファイルを特定できます。

-kオプションを省略した場合は，キー定義ファイルに定義されているすべてのキーファイルを検証します。対象のキーファイルが存在しない場合は，検証処理をスキップし，次のキーファイルの検証処理を実行します。

-k キー項目名

キー項目名は，キー定義情報の表示コマンド（Jisinfo）で表示されるキーファイル情報のキー項目名を指定します。

-cオプションを指定する場合（ISAMファイルの論理構造を検証したい場合）は，検証したいキーファイルのキー項目名を指定します。-cオプションを指定し，-kオプションを省略した場合，キー定義ファイルに定義されているすべてのキーファイルを検証します。

-cオプションを省略する場合（ISAMファイルから有効レコードを抽出したい場合）は，有効レコードを抽出するキーファイルのキー項目名を指定します。-cおよび-kオプションを省略した場合は，キー定義情報の表示コマンド（Jisinfo）で表示されるキーファイル情報の最初のキー項目名のキーファイルに対して，有効レコードが抽出されます。

-l メッセージの出力レベル

エラーの内容を示す詳細メッセージを標準エラー出力に出力するかどうかを指定します。指定できる値は0または1です。1を指定した場合は，詳細メッセージを含めすべてのメッセージを標準エラー出力に出力します。省略した場合は，0が設定されます。

-b バッファサイズ（MB）

ファイル入出力に使用するバッファサイズを指定します。指定できる値は0～256（メガバイト）です。0を指定した場合はバッファを確保しません。省略した場合は，16が設定されます。

-d ワークフォルダ名

キーファイルから有効レコードを取り出しソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するフォルダを指定します。このオプションを省略した場合は，環境変数のtemp，tmpで指定されたフォルダ，またはカレントフォルダを使用します。なお，このオプションはWindowsだけで使用できます。

-T ワークディレクトリ名

キーファイルから有効レコードを取り出しソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。このオプションを省略した場合は，/tmpまたは/usr/tmpを使用します。なお，このオプションはUNIXだけで使用できます。

抽出対象のISAMファイル名

-cオプションを省略した場合に指定できます。キーファイルから有効レコードを抽出するISAMファイル名を指定します。ドライブ名およびディレクトリ名を省略した場合は，カレントドライブおよびカレントディレクトリが仮定されます。スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

また，ファイル名の後ろに定義ファイルの拡張子※を指定した場合，指定した拡張子を取り除いた名前をISAMファイル名と仮定します。定義ファイルの拡張子※以外を指定した場合は，拡張子を含めた名前をISAMファイル名と仮定します。

注※

Windowsの場合：半角大小文字の「.KDF」

UNIXの場合：半角大文字の「.DEF」

順編成ファイル名

-cオプションを省略した場合に指定できます。抽出対象のISAMファイルで指定したISAMファイルから抽出した有効レコードを出力する順編成ファイル名を指定します。すでに存在するファイル名を指定した場合は，上書きされます。

ドライブ名およびディレクトリ名を省略した場合は，カレントドライブおよびカレントディレクトリが仮定されます。スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

また，ISAMファイルの拡張子※は指定できません。

注※

Windowsの場合：半角の大文字または小文字の「.KDF」「.DRF」「.K01～.K99」

UNIXの場合：半角大文字の「.DEF」「.DAT」「.K01～.K99」

検証対象のISAMファイル名

-cオプションを指定した場合に指定できます。論理構造を検証するISAMファイル名を指定します。ドライブ名およびディレクトリ名を省略した場合は，カレントドライブおよびカレントディレクトリが仮定されます。スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

また，ファイル名の後ろに定義ファイルの拡張子※を指定した場合，指定した拡張子を取り除いた名前をISAMファイル名と仮定します。定義ファイルの拡張子※以外を指定した場合は，拡張子を含めた名前をISAMファイル名と仮定します。

注※

Windowsの場合：半角の大文字または小文字の「.KDF」

UNIXの場合：半角大文字の「.DEF」

注意事項

-cオプションを省略した場合，ファイル入出力に使用するバッファは2面使用されます。したがって，-bオプションに指定した値の2倍のバッファサイズが確保されます。

複数のキーファイルを持つISAMファイルのうち，どれか1個でも論理構造が確保されていないキーファイルが存在すると，ファイルの変換コマンド（Jisconv）でISAMファイルに変換できないことがあります。

戻り値

0 | 正常終了
1 | 抽出できないレコードが存在する
2 | 一部整合性が確保されていないが，抽出できるレコードが存在する
3 | 引数誤り，ファイル不正，システムエラー，内部矛盾，排他エラー

使用例

ISAMファイル（ISAMFILE）から順編成ファイル（SAMFILE）に有効レコードを抽出する例を次に示します。

1個のISAMファイルから順編成ファイルに抽出する例

>Jisktod ISAMFILE SAMFILE
KAIU347-I 索引順編成ファイルのデータファイル検証を開始します。
           ISAMファイル名　: ISAMFILE
KAIU348-I 索引順編成ファイルのデータファイル検証を終了します。
           ISAMファイル名　: ISAMFILE
KAIU321-I 索引順編成ファイルの抽出を開始します。
           キー項目名　　　: K01
           ISAMファイル名　: ISAMFILE
           出力ファイル　　: SAMFILE
KAIU323-I 正常にキーファイルからレコードを抽出しました。
           キー項目名　　　: K01
           抽出件数　　　　: 101
           登録件数　　　　: 101
           ISAMファイル名　: ISAMFILE
           出力ファイル　　: SAMFILE

2個のキーファイル（キー項目名：K01とK02）を持つISAMファイルから順編成ファイルに抽出する例
1.　各キーファイルに対してキーファイルの論理構造を検証します。

>Jisktod -c -l 1 ISAMFILE
KAIU347-I 索引順編成ファイルのデータファイル検証を開始します。
ISAMファイル名　: ISAMFILE
KAIU348-I 索引順編成ファイルのデータファイル検証を終了します。
     ISAMファイル名　: ISAMFILE
KAIU322-I 索引順編成ファイルのキーファイル検証を開始します。
     キー項目名　　　: K01
     ISAMファイル名　: ISAMFILE
KAIU333-W リーフページとレコードのキーが一致していません。
キー項目名: K01 ISAMファイル名: ISAMFILE オフセット: 0x00000000
KAIU342-W 定義ファイルとキーファイルのレコード件数が一致しません。
     キー項目名　　　: K01
     有効レコード件数: 100
     登録件数　　　　: 101
     ISAMファイル名　: ISAMFILE
KAIU340-W キーファイルから管理されていないレコードが存在します。
     キー項目名　　　: K01
     ISAMファイル名　: ISAMFILE
     オフセット　　　: 0x00000000
KAIU328-W キーファイルは一部整合性が確保できていません。
     キー項目名　　　: K01
     抽出可能件数　　: 100
     登録件数　　　　: 101
     ISAMファイル名　: ISAMFILE
KAIU322-I 索引順編成ファイルのキーファイル検証を開始します。
     キー項目名　　　: K02
     ISAMファイル名　: ISAMFILE
KAIU324-I キーファイルは正常な状態です。
     キー項目名　　　: K02
     抽出可能件数　　: 101
     登録件数　　　　: 101
     ISAMファイル名　: ISAMFILE

2.　手順1で検証した結果，正常なキーファイル（キー項目名：K02）を使用して，レコードを抽出します。

>Jisktod -k K02 ISAMFILE SAMFILE
KAIU347-I 索引順編成ファイルのデータファイル検証を開始します。
     ISAMファイル名　: ISAMFILE
KAIU348-I 索引順編成ファイルのデータファイル検証を終了します。
     ISAMファイル名　: ISAMFILE
KAIU321-I 索引順編成ファイルの抽出を開始します。
     キー項目名　　　: K02
     ISAMファイル名　: ISAMFILE
     出力ファイル　　: SAMFILE
KAIU323-I 正常にキーファイルからレコードを抽出しました。
     キー項目名　　　: K02
     抽出件数　　　　: 101
     登録件数　　　　: 101
     ISAMファイル名　: ISAMFILE
     出力ファイル　　: SAMFILE

Jislckclear（Windows限定）

機能

ISAMファイルにアクセスしているJP1製品のプロセスを強制終了した場合などで，消滅したプロセスによってファイルやレコードが占有されたままとなっている状態を確認および解除します。

形式

Jislckclear {-c | -d}

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-c

消滅したプロセスによってファイルやレコードが占有されているかどうかを確認します。消滅したプロセスのファイルやレコードの占有情報が残っている場合は，KAIU315-Iのメッセージが標準エラー出力に出力されます。

-d

消滅したプロセスによってファイルやレコードが占有されている状態をすべて解除します。

注意事項

このコマンドの実行中，ISAMファイルにアクセスしているJP1製品のプロセスは待機状態となることがあります。

-cオプションで占有情報を確認したあと，-dオプションで解除する間に，ISAMファイルをアクセスしているほかのプロセスによって，占有状態が解除される場合があります。このため，-cオプションで表示される占有情報の個数と，-dオプションで表示される解除した数は一致しない場合があります。

戻り値

0 | 正常終了
1 | 正常終了（占有情報の通知または解除）
2 | 正常終了（占有情報がないため処理を終了）
3 | 異常終了（実行権限がない）
4 | 異常終了（引数の誤り）
5 | 異常終了（システムコールエラー）
99 | 異常終了（プログラム論理エラー）

Jislckext

機能

ロックテーブルのエントリー数を拡張，または縮小します。なお，Jislckextコマンド実行前や実行後にロックテーブルの状態を表示する手順は，次のようになります。

Windowsの場合

Jislckextコマンドの-tオプションを使用して現在のロックエントリー数を取得する。
コマンドは次のように指定して実行してください。

Jislckext -t

エントリー数を変更する。
コマンドは次のように指定して実行してください。

Jislckext エントリー数

Jislckextコマンドの-tオプションを使用してロックエントリー数が変更されたことを確認する。
コマンドは次のように指定して実行してください。

Jislckext -t

UNIXの場合

ipcsコマンドで共有メモリーのセグメントサイズを調べる。
コマンドは次のように指定して実行してください。

ipcs -ma | grep 0x88

エントリー数を求める。
次に示す計算式でエントリー数が求まります。

（ipcsコマンド実行結果 - 36972） / 104

エントリー数を変更する。
コマンドは次のように指定して実行してください。

Jislckext エントリー数

ipcsコマンドで共有メモリーのセグメントサイズが変更されたことを確認します。

ipcs -ma | grep 0x88

形式

Jislckext エントリー数

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

エントリー数

指定したエントリー数で，ロックテーブルを再作成します。

注意事項

ロックテーブルがほかのプロセスで使用中の場合は，使用中のエントリー数だけを返します。

ロックテーブルのエントリー数を変更する場合は，JP1/Baseのサービス，およびJP1/AJSのサービスを停止する必要があります。また，ISAMファイルの操作，保守に関するユーティリティコマンド，およびJP1/AJSのジョブネットを操作するコマンドを終了する必要があります。

ロックテーブルのエントリー数の最大は，32,767です。

戻り値

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

Jislckfree（Windows限定）

機能

システム共有メモリーに持つISAMのロックテーブルから，PIDで指定されたロックエントリー情報を削除します。これによって，ファイル・レコード占有が解除されます。指定されたPIDがISAMのロックテーブル中になくても正常終了します。ISAMのロックテーブルがない（ISAMを使用しているJP1製品が起動していない）状態でコマンドを実行した場合，"SetSecurity DescriptorDacl Error"のエラーメッセージで異常終了します。

形式

Jislckfree -p PID

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-p PID

PIDには，ISAMファイル・レコード占有中のプロセスIDを指定します。

注意事項

ISAMのロックテーブルから指定されたPIDで示されるロックエントリー情報をすべて削除するため，PIDで示されるJP1製品の起動中にコマンドは実行しないようにしてください。

ロックエントリー情報を削除したいPIDは，Jismlcktrコマンドでわかります。

戻り値

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

Jislckreg（UNIX限定）

機能

ISAMで使用するリソースの設定を支援します。

JP1製品に組み込まれているISAMデータベースはシステムで共通のリソースを使用しているため，ある製品でISAMデータベースへのアクセスが集中した場合，ほかのJP1製品のISAMデータベースへのアクセスと動作が干渉して性能が低下することがあります。ISAMで使用するリソースを分割するとアクセス性能を向上できます。設定方法については，各JP1製品のマニュアルを参照してください。

形式

Jislckreg {-r | -c | -i | -s}

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

-r

現在の設定ファイル（/etc/opt/jp1base/conf/Jismdef.ini）の内容に従ってISAMで使用するリソース（共有メモリーとセマフォ）を設定します。ISAMリソースの設定は，JP1/Baseの起動時に自動的に行われるため，この引数を使用して本コマンドを実行する必要はありません。

-c

設定ファイル（/etc/opt/jp1base/conf/Jismdef.ini）の文法をチェックします。

-i

現在のシステム上のリソース設定情報を表示します。

-s

設定ファイル（/etc/opt/jp1base/conf/Jismdef.ini）でのシステムリソース使用量を表示します。

注意事項

設定を変更する場合，すべてのJP1サービスを停止してからファイル内容の変更をしてください。

設定ファイルの変更後，すべてのJP1サービスを再起動する前にJisrsdelコマンドを実行してください。

戻り値

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

Jismlcktr（Windows限定）

機能

ISAMロックテーブルの情報を表示します。表示内容を次に示します。

形式

Jismlcktr

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

Jisprt

機能

データファイルのレコードの内容を，指定した形式に編集して表示します。表示形式には，ダンプ形式，文字形式，および16進形式があります。

レコード内容の表示は，次に示すときに終了します。

データファイルのすべてのレコードの内容を，表示し終わったとき。

オプションで指定した範囲内のレコードの内容を，表示し終わったとき。

オプションで指定した件数分のレコードの内容を，表示し終わったとき。

形式

Jisprt [-t タイプ]
      {[-k キー項目名][-s 開始キー値[:x]][-e 終了キー値[:x]] | -d}
      [-c レコード件数]
       ファイル名

実行権限

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

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-t タイプ

レコード内容の表示形式を，次のどれかで指定します。

d（ダンプ形式）

c（文字形式）

h（16進形式）

省略時は，dを仮定します。

-k キー項目名

レコードの表示順序の基準にするキーの，キー項目名を指定します。省略時は，主キー順にレコードを表示します。

-s 開始キー値[:x]

表示を開始するキーの値を指定します。省略時は，いちばん小さい値を持つキーから表示します。キーの値を16進数で指定する場合，値のあとに:xを指定します。

-e 終了キー値[:x]

表示を終了するキーの値を指定します。省略時は，いちばん大きい値を持つキーまで表示します。キーの値を16進数で指定する場合，値のあとに:xを指定します。

-d

レコードを物理順に表示する場合に指定します。-k キー項目名，-s 開始キー値[:x]，およびe 終了キー値[:x]と同時には指定できません。

-c レコード件数

表示するレコードの件数を指定します。

ファイル名

レコード内容を表示するファイルのファイル名を指定します。

注意事項

レコード内容をテキストファイルなどに出力したい場合は，>のあとに出力先のファイル名を指定します。
（例）

Jisprt sample > prt.txt

UJIS環境，またはSolarisの場合，半角のかたかなをピリオドに置き換えて表示します。

戻り値

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

Jisrsdel（UNIX限定）

機能

ISAMで使用するリソースを削除します。

形式

Jisrsdel

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

注意事項

このコマンドを実行する場合は，すべてのJP1サービスが停止していることを確認してください。JP1サービス実行中に実行すると，ISAMファイルを破壊するおそれがあります。

戻り値

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

jp1base_setup（UNIX限定）

機能

JP1/Baseの動作環境を設定します。このコマンドは，クラスタシステムやクラスタシステムでない場合も含めて，JP1/Baseを使用する場合に実行します。

形式

jp1base_setup

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin

注意事項

JP1/Baseのバージョンが07-00以降の場合，このコマンドはインストーラーで実行されるため，個別に実行する必要はありません。
バージョンが06-00の場合，JP1/IMがインストールされているマシンにJP1/Baseを上書きインストールし，jp1base_setupコマンドを実行すると，JP1/IMのjcocmddefコマンドで設定していた値が初期設定に戻ります。この場合は，jcocmddefコマンドを使用して値を再設定してください。

論理ホスト設定後にjp1base_setupコマンドを実行した場合，物理ホストの通信方式がANYバインド方式に設定されます。この場合は，以下の手順で物理ホストの通信方式をIPバインド方式に変更してください。

以下の内容のファイルを作成する。
[JP1_DEFAULT¥JP1BASE]
"JP1_BIND_ADDR"="IP"

操作1で作成したファイルをjbssetcnfコマンドを使って共通定義に設定する。

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

戻り値

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

jp1base_setup_cluster（UNIX限定）

機能

JP1/Baseの論理ホストの動作環境を設定します。クラスタシステムでの環境設定で使用します。環境設定は，実行系，待機系の順に行います。

形式

jp1base_setup_cluster  -h 論理ホスト名
                     [-d 共有ディレクトリ [-a 認証サーバ] [-s] [-v]]

実行権限

スーパーユーザー権限

実行系の環境設定

論理ホスト名と共有ディレクトリ名の指定が必要です。ほかのオプションについては，必要に応じて指定してください。このコマンドを実行すると，指定した共有ディレクトリに定義ファイルなどがコピーされるため，必ず共有ディスクをマウントしておいてください。

待機系の環境設定

論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。なお，待機系の環境設定をする前に，実行系で設定した共通定義情報を待機系にコピーする必要があります。コピーする場合，jbsgetcnfコマンド，およびjbssetcnfコマンドを利用します。

格納先ディレクトリ

/opt/jp1base/bin/

引数

-h 論理ホスト名

環境を設定する論理ホスト名を指定します。

注意事項

論理ホスト名は，hostsファイルやネームサーバに設定し，TCP/IP通信ができるようにしてください。

DNS運用の場合は，FQDN（Fully Qualified Domain Name）形式ではないホスト名を指定してください。例えば，jp1v6.soft.hitachi.co.jpの場合は，jp1v6を指定します。

-d 共有ディレクトリ

実行系の環境設定時に使用します。フェールオーバー時に引き継ぐ情報を格納する共有ディレクトリを指定します。共有ディスク上のディレクトリを指定してください。指定した共有ディレクトリで，JP1/Baseの動作に必要な環境設定が行われます。このオプションを指定してコマンドを実行すると，共有ディスク上に次の表に示すディレクトリを作成し，定義ファイルを/etc/opt/jp1base/conf/からコピーします。

ディレクトリ | 格納するファイル
共有ディレクトリ/jp1base/conf/ | 定義ファイル
共有ディレクトリ/jp1base/log/ | ログファイル
共有ディレクトリ/event/ | イベントサーバ設定ファイル

なお，定義ファイルの内容は，必要に応じて変更してください。

-a 認証サーバ

論理ホストが接続する認証サーバのホスト名を指定します。このオプションを省略した場合，認証サーバの設定は物理ホストの環境設定と同じ認証サーバが指定されます。

-s

論理ホストで認証サーバを実行する場合に指定します。このオプションを指定すると，JP1/Baseの起動時に認証サーバが起動するように設定されます。このオプションを省略した場合，認証サーバを起動しないように設定されます。

-v

このオプションを指定すると，論理ホストの動作環境を設定するときのすべてのメッセージを画面上に表示します。

注意事項

設定は，ノードごとに実施してください。

このコマンドを実行すると，ローカルディスク上にあるイベントサービスのイベントサーバインデックスファイル（/etc/opt/jp1base/conf/event/index）に「論理ホスト名」と「共用ディスク上のディレクトリ名/event」が自動設定されます。また，ローカルディスク上にあるイベントサービスのAPI設定ファイル（/etc/opt/jp1base/conf/event/api）に「論理ホスト名」と通信タイプ（keep-alive）が自動設定されます。「共用ディスク上のディレクトリ名/event」下にイベントサーバ設定ファイル（conf）および転送設定ファイル（forward）が作成されます。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法をIPアドレス指定方式に変更します。変更の対象は，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信のソケットのバインド方法の詳細については，OSのマニュアルを参照してください。

jp1base_setup_clusterコマンドで，イベントサービスの通信方式の設定はできません。イベントサーバ設定ファイル（conf）を編集してイベントサービスの通信方式を設定してください。

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

使用例

論理ホスト名をlnode0に，共有ディスク上のディレクトリ名を/shdsk/lnode0に設定した場合の使用例を次に示します。

実行系での環境設定

jp1base_setup_cluster -h lnode0 -d /shdsk/lnode0 -a lnode0 -s

このコマンドを実行すると，論理ホストの環境設定，共有ディスク上に共有ディレクトリと共有ファイルの作成，および認証サーバの設定が行われます。

待機系での環境設定

jp1base_setup_cluster -h lnode0

jp1bshasetup（Windows限定）

機能

JP1/Baseの論理ホストの動作環境を設定する［Baseクラスタ構成の設定］ダイアログボックスを表示します。クラスタシステムでの環境設定で使用します。

形式

jp1bshasetup

実行権限

Administrators権限

格納先ディレクトリ

インストール先フォルダ¥bin¥

注意事項

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

jp1ping

機能

オペレーティングシステムで管理しているネットワーク機能（gethostbyname）を使用して，引数で指定されたホスト名をIPアドレスに変換し，得られたIPアドレスに対してpingコマンドを実行します。

ネットワークインターフェースを複数備えているホスト（一つのホスト名に対して複数のIPアドレスを割り当てているようなホスト）に対するネットワークの設定が有効かを確認する場合に使用します。

形式

jp1ping [-h 論理ホスト名]
        ホスト名

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

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

ホスト名

ネットワーク上のホスト名を指定します。

戻り値

0 | 正常終了
0以外 | 異常終了（ただし，引数を指定しないでコマンドを実行し，使用方法が表示される場合は正常終了）

使用例

server1上で自分自身（server1）がどのIPアドレスを使用しているのかを確認するために，jp1pingコマンドを実行した場合の結果（出力例）を次に示します。

C:¥>jp1ping server1
LogicalHostnameKey : no define. use JP1_DEFAULT
jp1hosts           : no entry. extract hostlist is disabled.
Search jp1hosts    : server1 is not found.
Resolved Host List : server1 -> server1.hitachi.co.jp(172.16.0.10, 172.16.0.20),
Check with ping command ---

Pinging 172.16.0.10 with 32bytes of data:

Reply from 172.16.0.10: bytes=32 time<10ms TTL=128
Reply from 172.16.0.10: bytes=32 time<10ms TTL=128
Reply from 172.16.0.10: bytes=32 time<10ms TTL=128
Reply from 172.16.0.10: bytes=32 time<10ms TTL=128

Pinging 172.16.0.20 with 32bytes of data:

Reply from 172.16.0.20: bytes=32 time<10ms TTL=128
Reply from 172.16.0.20: bytes=32 time<10ms TTL=128
Reply from 172.16.0.20: bytes=32 time<10ms TTL=128
Reply from 172.16.0.20: bytes=32 time<10ms TTL=128
C:¥>

出力内容から，server1というホスト名が，172.16.0.10と172.16.0.20の二つのIPアドレスに解決され，実際にNICへのpingが有効になっていることが判断できます。

14.　定義ファイル

この章では，JP1/Baseの定義ファイルとイベントフィルターの形式および文法について説明します。

＜この章の構成＞

定義ファイル一覧

イベントフィルターの文法

起動順序定義ファイル（Windows限定）

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）

イベントサーバインデックスファイル

イベントサーバ設定ファイル

転送設定ファイル

API設定ファイル

ログファイルトラップ動作定義ファイル

ログファイルトラップ起動定義ファイル

ログ情報定義ファイル

イベントログトラップ動作定義ファイル（Windows限定）

配布定義ファイル

パスワード定義ファイル（Windows限定）

ユーザー権限レベルファイル

ディレクトリサーバ変更ファイル（Windows限定）

ディレクトリサーバ連携定義ファイル（Windows限定）

ユーザーマッピング定義ファイル

ヘルスチェック定義ファイル

共通定義設定用ファイル（ヘルスチェック機能）

JP1/Baseパラメーター定義ファイル

拡張起動プロセス定義ファイル

jp1hosts定義ファイル

ホストアクセス制限定義ファイル

ローカルアクション環境変数ファイル

ローカルアクション実行定義ファイル

共通定義設定用ファイル（ローカルアクション機能）

定義ファイル一覧

JP1/Baseの定義ファイルを次の表に示します。

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

機能
定義ファイル名・説明

起動管理機能

起動順序定義ファイル（Windows限定）

サービスの起動順序および終了順序を設定するファイル。

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）

サービスの起動を待機させる時間と，サービスの起動を監視する時間を設定するファイル。

イベントサービス

イベントサーバインデックスファイル

イベントサーバが使用するディレクトリを設定するファイル。

イベントサーバ設定ファイル

イベントサービスの各種動作環境を設定するファイル。

転送設定ファイル

どのイベントサーバにどのJP1イベントを転送するかを設定するファイル。

API設定ファイル

アプリケーションプログラムからイベントサーバへの接続方法や使用するポートを設定するファイル。

イベント変換機能

ログファイルトラップ動作定義ファイル

JP1イベントに変換するログデータの条件や，監視失敗時のリトライなどを設定するファイル。

ログファイルトラップ起動定義ファイル

ログファイルトラップ管理サービス（デーモン）起動時，jevlogstart（クラスタ運用限定）コマンド実行時，およびjevlogstop（クラスタ運用限定）コマンド実行時に，起動または終了するログファイルトラップを設定するファイル。

ログ情報定義ファイル

ログファイルトラップ用ログファイルの保存ファイル数や最大容量を設定するファイル。

イベントログトラップ動作定義ファイル（Windows限定）

JP1イベントに変換するイベントログの条件や，イベントログの監視間隔などを設定するファイル。

イベントサービスの定義情報の収集・配布機能

配布定義ファイル

配布したい定義情報と，配布先ホストを設定するファイル。

ユーザー管理機能

パスワード定義ファイル（Windows限定）

複数のOSユーザーのパスワード情報を設定するファイル。

ユーザー権限レベルファイル

JP1ユーザーのJP1資源グループに対する操作権限を設定するファイル。

ディレクトリサーバ変更ファイル（Windows限定）

連携したディレクトリサーバが障害などで使用できなくなった場合，一時的にディレクトリサーバを変更するための共通定義情報を設定するファイル。

ディレクトリサーバ連携定義ファイル（Windows限定）

ディレクトリサーバと連携してログイン認証をする場合に，ディレクトリサーバ名などを設定するための共通定義情報を設定するファイル。

ユーザーマッピング定義ファイル

複数のJP1ユーザーのマッピング情報を設定するファイル。

ヘルスチェック機能

ヘルスチェック定義ファイル

ヘルスチェックで異常を検知した場合の通知方法や，ヘルスチェックで監視する他ホストなどを設定するファイル。

共通定義設定用ファイル（ヘルスチェック機能）

ヘルスチェック機能を有効にするための共通定義情報を設定するファイル。

プロセス管理機能

JP1/Baseパラメーター定義ファイル

共通定義情報を設定するファイル。プロセスが異常終了した場合や，認証サーバの切り替えが発生した場合に，JP1イベントを発行するかどうかを設定します。

拡張起動プロセス定義ファイル

プロセスが異常終了した場合，自動で再起動するために設定するファイル。

通信設定

jp1hosts定義ファイル

JP1/Base独自のhosts情報を変更するための共通定義情報を設定するファイル。

ホストアクセス制限定義ファイル

JP1/IMのIM構成管理機能へ情報提供する場合のように，ほかのホストからのアクセス制限を設定するファイル。

ローカルアクション機能

ローカルアクション環境変数ファイル

ローカルアクション機能で指定されたコマンドを実行するときの環境変数を設定するファイル。

ローカルアクション実行定義ファイル

ローカルアクション機能の実行条件と実行コマンドを設定するファイル。

共通定義設定用ファイル（ローカルアクション機能）

ローカルアクション機能を有効にするかどうか，およびログ情報を共通定義情報に設定するためのファイル。

イベントフィルターの文法

イベントフィルターは，イベントIDや発行元ユーザー名などをキーにして，JP1イベントをフィルタリングします。イベントフィルターを設定する個所を次に示します。

転送設定ファイル（forward）

ローカルアクション実行定義ファイル

jevexportコマンド

JP1イベント取得関数（JevGetOpen）※

拡張属性マッピング設定ファイル※

注※　詳細については，「付録J.4　JP1/SESイベントをJP1イベントに変換する」を参照してください。

イベントフィルターの書式

イベントフィルターは一つ以上の「条件文群」の集まりです。条件文群は一つ以上の「条件文」の集まりです。条件文は1行で表され，条件文を並べることで条件文群が構成されます。条件文群同士の間には「OR」とだけ記述した行を挿入します。なお，1行の最大長は1,024バイトです。一つのイベントフィルター全体の最大長は，64キロバイトです。

条件文群は条件文群を構成する条件文がすべて成立すると成立します。イベントフィルターは，イベントフィルターを構成する条件文群のどれか一つが成立すると成立します。

イベントフィルターの書式の概念を次の図に示します。

図14-1　イベントフィルターの書式の概念

JP1/Base 08-50以降では，イベントフィルターに除外条件を記述できます。

抽出条件が成立するJP1イベントのうち，特定のJP1イベントを除外したい場合に記述します。

抽出条件と除外条件の間には「EXCLUDE」とだけ記述した行を挿入します。「EXCLUDE」は，一つのフィルターに一つだけ記述でき，「EXCLUDE」より前に記述された条件文群は抽出条件，「EXCLUDE」より後ろに記述された条件文群は除外条件となります。除外条件に記述する条件文の書式は，抽出条件と同じです。

除外条件は省略できるため，以前のバージョンで作成したフィルターをJP1/Base 08-50以降でもそのまま使用できます。

条件文の書式

条件文の書式は次の形式で記述します。

属性名△比較キーワード△オペランド1△オペランド2△…

△は区切りで，一つ以上の連続した半角のスペースまたはタブを示します。オペランドを複数指定した場合は，どれか一つに当てはまるときに条件文が成立します。オペランドとして，半角スペース，タブ，CR，LFおよび%は通常の方法では使用できませんが，次に示すように2桁の16進数で表現できます。

半角スペース：%20

タブ：%09

CR：%0d

LF：%0a

%：%25

また，半角スペース，タブ，CR，LFおよび%以外の文字も16進数で表現できます。

注意事項

JP1/SES形式で登録されたイベントに日本語文字列が含まれる場合，その文字コードと条件文に指定した文字コードが一致しないと，条件に合致しません。

条件文に機種依存文字が含まれる場合，正しく比較できません。

属性名

条件文の属性名を次の表に示します。

表14-2　条件文の属性名

属性名
内容
型および形式

B.SEQNO
イベントDB内通し番号
数値(0～2,147,483,647)

B.ID
イベントID
イベントID※1

B.PROCESSID
発行元プロセスID
数値(0～2,147,483,647)

B.TIME
登録時刻
数値
(0～2,147,483,647 =UTC1970年1月1日00:00:00からの秒数)

B.ARRIVEDTIME
到着時刻
数値
(0～2,147,483,647 =UTC1970年1月1日00:00:00からの秒数)

B.REASON
イベントDBへの登録要因
数値(1～4)

B.USERID
発行元ユーザーID
数値(-1～2,147,483,647)

B.GROUPID
発行元グループID
数値(-1～2,147,483,647)

B.USERNAME
発行元ユーザー名
文字列※3

B.GROUPNAME
発行元グループ名
文字列※3

B.SOURCESERVER
発行元イベントサーバ名
文字列※3

B.DESTSERVER
送信先イベントサーバ名
文字列※3

B.SOURCESEQNO
発行元別通し番号
数値(0～2,147,483,647)

B.CODESET
コードセット
文字列※3

B.MESSAGE
メッセージ
文字列※3

E.拡張属性名※2
拡張属性
文字列※3

注※1　イベントIDは，文字列型，数値型と異なります。詳細については，「表14-3　条件文の比較キーワード」の条件内の属性値がイベントIDの場合を参照してください。

注※2　拡張属性名の形式については，「15.1.2　拡張属性」を参照してください。

注※3　文字列は，英字の大小文字を区別します。

比較キーワード

条件文の比較キーワードを次の表に示します。

表14-3　条件文の比較キーワード

比較キーワード
オペランドの数
条件

IN
1以上
属性値が，オペランドのどれかと一致する。
属性値が文字列型の場合，オペランドは任意の文字列。
属性値が数値型の場合，オペランドは10進数（符号可）と見なせる文字列。そうでないオペランドは常に不一致。
属性値がイベントIDの場合，オペランドはx:yまたはx（xとyは1～8桁の16進数）の形式の文字列。xがイベントID基本部に，yがイベントID拡張部に対応。そうでないものは常に不一致。

NOTIN
1以上
比較キーワードINの否定。

BEGIN
1以上
属性値が文字列型であり，オペランドに指定した文字列のどれかで始まると成立。属性値が数値型またはイベントIDの場合は常に不成立。

RANGE
2

属性名が，B.TIMEまたはB.ARRIVEDTIMEの場合

次の条件を満たすと成立。

属性値が数値，または10進数(0～2,147,483,647)と見なせる文字列。

オペランド1およびオペランド2が14桁の数字列。

属性値をUTC1970年1月1日00:00:00からの秒数と見なし，イベントサーバの稼働環境のタイムゾーンに基づくyyyymmddHHMMSSの形式の数字列にしたときに，オペランド1 ≦ 属性値 ≦ オペランド2であるとき。

そのほかの属性名で属性値が数値型の場合

オペランド1およびオペランド2を10進数と見なしたときに，オペランド1 ≦ 属性値 ≦ オペランド2であると成立。

属性値が文字列型の場合

文字コード順の比較で，オペランド1 ≦ 属性値 ≦ オペランド2であると成立。

属性値がイベントIDの場合

オペランド1およびオペランド2がx:y（xとyは1～8桁の16進数）の形式の文字列で，y（拡張部）を上8桁，x（基本部）を下8桁の計16桁の16進数と見なしたときにオペランド1 ≦ 属性値 ≦ オペランド2であると成立。

以上のどれでもない場合は不成立。

TRANGE
2
次の条件を満たすと成立する。

属性値が数値，または10進数(0～2,147,483,647)と見なせる文字列。

オペランド1およびオペランド2が14桁の数字列。

属性値をUTC1970年1月1日00:00:00からの秒数と見なし，イベントサーバの稼働環境のタイムゾーンに基づくyyyymmddHHMMSSの形式の数字列にした場合に，オペランド1 ≦ 属性値 ≦ オペランド2であるとき。

以上の場合でないときは不成立。

DEFINED
0
属性名が拡張属性名を表し，指定の拡張属性が定義されていると成立。定義されていないと不成立。属性名が基本属性を表す場合は常に成立。

NOTDEFINED
0
比較キーワードDEFINEDの否定。

SUBSTR
1以上
属性値が文字列型であり，オペランドに指定した文字列のどれかが含まれていると成立。
属性値が数値型，またはイベントIDの場合は常に不成立。

NOTSUBSTR
1以上
比較キーワードSUBSTRの否定。

REGEX※1
1以上
正規表現記述用比較キーワード。
属性値が文字列型であり，オペランドに指定した正規表現のどれかと一致すると成立。
正規表現については「付録F　正規表現の文法」を参照のこと。

WITHIN※2
2

属性名が，B.TIMEまたはB.ARRIVEDTIMEの場合

次の条件を満たすと成立。

属性値が数値，または10進数(1～2,147,483,647)と見なせる文字列。

オペランド1がM（分），H（時間），D（日）のどれかの文字列。

オペランド2が10進数（符号不可）と見なせる文字列。

オペランド1がM（分）およびH（時間）の場合
属性値をUTC1970年1月1日00:00:00からの秒数と見なし，イベントサーバの稼働環境のタイムゾーンに基づくyyyymmddHHMMSSの形式の数字列にしたときに，(現在時刻－オペランド2)≦属性値≦現在時刻 であるとき。

オペランド1がD(日)の場合
属性値をUTC1970年1月1日00:00:00からの秒数と見なし，イベントサーバの稼働環境のタイムゾーンに基づくyyyymmddHHMMSSの形式の数字列にしたときに，[今日の日付－(オペランド2－1)]の00:00:00≦属性値≦今日の日付の24:59:59であるとき

注※1　REGEXは06-71から追加された比較キーワードです。このため，06-71以降のJP1/Base以外でREGEXを定義したファイルを利用した場合，REGEXの定義部分は無視されます。なお，機種依存文字を正規表現に指定した場合でも通常文字列と同様に処理されます。

注※2　WITHINは07-00から追加された比較キーワードです。jevexportコマンドで指定するフィルターファイルでだけ指定できます。このため，07-00以降のJP1/Baseで提供するjevexportコマンド以外でWITHINを定義したファイルを利用した場合，WITHINの定義がエラーとなり，06-71以前と同じ動作となります。

イベントフィルターの記述例

イベントフィルターの記述例を示します。

イベントIDが基本部111，拡張部0のJP1イベントを選択します。

B.ID IN 111:0
または
B.ID IN 111
または
B.ID IN 00000111:00000000

発行元ユーザーIDが103のJP1イベントを選択します。

B.USERID IN 103
または
B.USERID RANGE 103 103

発行元イベントサーバ名がreysolのJP1イベントを選択します。

B.SOURCESERVER IN reysol

メッセージがKAJPまたはKAVAで始まるJP1イベントを選択します。

B.MESSAGE BEGIN KAJP KAVA

メッセージがHello, worldで始まるJP1イベントを選択します。なお，「，」と「w」の間の%20はスペースを示します。

B.MESSAGE BEGIN Hello,%20world

イベントIDが222:0以外で，かつ発行元ユーザー名がhanakoのJP1イベントを選択します。

B.ID NOTIN 222
B.USERNAME IN hanako

拡張属性の属性名がTASK_NAMEで，その値が「在庫管理」のJP1イベントを選択します。

E.TASK_NAME IN 在庫管理

属性名がTASK_NAMEの拡張属性が設定（値は問わない）されているJP1イベントを選択します。

E.TASK_NAME DEFINED

2002年6月16日※以降に発生したJP1イベントを選択します。

B.TIME TRANGE 20020616000000 99999999999999

次に示すJP1イベントを選択します。

拡張属性SEVERITYがWarningまたはErrorかつ拡張属性PRODUCT_NAMEが定義されているJP1イベント

発生元イベントサーバがwww.hitachi.co.jpでかつ拡張属性PRODUCT_NAMEが /HITACHI/JP1/AJSであるJP1イベント

E.SEVERITY IN Warning Error
E.PRODUCT_NAME DEFINED
OR
B.SOURCESERVER IN www.hitachi.co.jp
E.PRODUCT_NAME IN /HITACHI/JP1/AJS

現在時刻（2003年7月16日01:30:00）※の30分前から現在までに発生したJP1イベントを選択します。

B.TIME WITHIN M 30
（B.TIME TRANGE 20030716010000 20030716013000と同意）

現在時刻（2003年7月16日01:21:21）※の24時間前から現在までに発生したJP1イベントを選択します。

B.TIME WITHIN H 24
（B.TIME TRANGE 20030715012121 20030716012121と同意）

今日（2003年7月16日）※を含めた二日間に発生したJP1イベントを選択します。

B.TIME WITHIN D 2
（B.TIME TRANGE 20030715000000 20030716235959と同意）

イベントIDが101，102または重大度がエラーのJP1イベントを選択します。ただし，登録元イベントサーバ名がhost3のJP1イベントは除外します。

B.ID IN 101 102
OR
E.SEVERITY IN Error
EXCLUDE
B.SOURCESERVER IN host3

注※　イベントサーバ環境での時刻を基にしています。

起動順序定義ファイル（Windows限定）

形式

# コメント
[ControlValue]
ForcedTerminateExec=YES
[FrontOtherServiceXXX]
Name=任意の名称
ServiceName=起動および終了するサービスの名称
StartCommand=サービスの起動に使用するコマンド
StopCommand=サービスの終了に使用するコマンド
Parallel=YES
Wait=サービス開始処理が完了するまでの最大待ち時間（秒）
StopWait=サービス終了処理が完了するまでの最大待ち時間（秒）
[Jp1XXX]
Name=任意の名称
ServiceName=起動および終了するサービスの名称
StartCommand=サービスの起動に使用するコマンド
StopCommand=サービスの終了に使用するコマンド
Parallel=YES
Wait=サービス開始処理が完了するまでの最大待ち時間（秒）
StopWait=サービス終了処理が完了するまでの最大待ち時間（秒）
[OtherServiceXXX]
Name=任意の名称
ServiceName=起動および終了するサービスの名称
StartCommand=サービスの起動に使用するコマンド
StopCommand=サービスの終了に使用するコマンド
Parallel=YES
Wait=サービス開始処理が完了するまでの最大待ち時間（秒）
StopWait=サービス終了処理が完了するまでの最大待ち時間（秒）
[Command]
ReadyCommand=すべてのサービス開始処理が完了したあとに実行するコマンド
StopReadyCommand=すべてのサービス終了処理が完了したあとに実行するコマンド

ファイル名

JP1SVPRM.DAT（起動順序定義ファイル）

JP1SVPRM.DAT.MODEL（起動順序定義ファイルのモデルファイル）

格納先ディレクトリ

インストール先フォルダ¥conf¥boot¥

説明

JP1シリーズの製品のサービス，JP1以外の製品のサービスの起動順序および終了順序，サービスの起動または終了したあとに実行するコマンドやバッチファイルを設定しておくファイルです。

定義の反映時期

cpysvprmコマンドを実行すると，起動順序定義ファイル（JP1SVPRM.DAT）が作成されます。Windowsを再起動すると，設定が有効になります。cpysvprmコマンドの詳細については，「13.　コマンド」の「cpysvprm（Windows限定）」を参照してください。

記述内容

起動順序定義ファイル（JP1SVPRM.DAT）の各パラメーターの説明を次に示します。起動順序定義ファイル（JP1SVPRM.DAT）には8文字を超えるファイル名や，スペースを含むファイル名も指定できます。コメント文を挿入したい場合は，行頭に#を付けてください。改行されるまでコメント文になります。

[ControlValue]

JP1/Power Monitorからの強制終了時に，サービスを順序どおりに終了したい場合に記述するセクションです。このセクションでは，ForcedTerminateExec=だけを指定できます。

なお，JP1/Power Monitorからの計画終了時には，このセクションを省略した場合でも，起動順序定義ファイル（JP1SVPRM.DAT）に定義したとおりに，必ずサービスの終了処理が実行されます。

ForcedTerminateExec=

JP1/Power Monitorからの強制終了時にサービスの終了処理を実行する場合，「YES」を指定します。「YES」以外を指定した場合，および省略した場合，JP1/Power Monitorからの強制終了時にサービスの終了処理は実行されません。

[FrontOtherServiceXXX]

JP1製品のサービスより前に起動する，JP1以外のサービスについて記述するセクションです。XXXには，60バイト以内の半角英数文字で，任意の名称を指定します。英字の大文字小文字の区別はしません。

[Jp1XXX]

JP1製品のサービスについて記述するセクションです。XXXは，各製品によって異なった文字列を割り当てられています。なお，JP1シリーズのサービスについては，あらかじめモデルファイルで提供されています。モデルファイルに記述されていないサービスを追加する場合には，各ユーザーで任意の名称を指定してください。XXXには，60バイト以内の半角英数文字を指定してください。英字の大文字小文字の区別はしません。

[OtherServiceXXX]

JP1製品のサービスよりあとに起動する，JP1以外のサービスについて記述するセクションです。XXXには，60バイト以内の半角英数文字で，任意の名称を指定します。英字の大文字小文字の区別はしません。

Name=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。識別用として，ユーザーが任意の名称を指定します。

ServiceName=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。起動および終了するサービスの名称を指定します。このパラメーターを省略した場合，サービスの起動および終了は管理されません。

なお，定義ファイルに指定するサービス名は，［コントロールパネル］の［サービス］ダイアログボックスで表示されるサービス名と異なる場合があります。詳細については，各プログラムの発売元にご確認ください。

StartCommand=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。サービスの起動に使用するコマンドがある場合に，コマンド名を指定します。コマンド名は一つだけ指定できます。

StopCommand=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。サービスの終了に使用するコマンドがある場合に，コマンド名を指定します。省略した場合は，終了の処理をしません。コマンド名は一つだけ指定できます。

Parallel=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。他サービスの開始処理中に，並行して開始処理を実行する場合に，「YES」を指定します。「YES」以外を指定した場合，および省略した場合は，直前のサービス開始処理が完了してから，このサービスの開始処理を実行します。

Parallel=パラメーターは，サービスの起動順序を制御するときに有効となります。サービスの終了順序を制御するときはParallel=パラメーターの設定内容に関係なく，直前に定義したサービスの終了処理が完了してから，このサービスの終了処理を実行します。

Wait=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。サービス開始処理が完了するまでの最大待ち時間（秒）を指定します。このパラメーターで指定した時間を過ぎても，サービスの開始処理が完了しない場合は，次のサービスの起動処理を始めます。指定できる値は，1～86,400（秒）です。省略した場合は，60秒が設定されます。

StopWait=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。サービス終了処理が完了するまでの最大待ち時間（秒）を指定します。このパラメーターで指定した時間を過ぎても，サービスの終了処理が完了しない場合は，次のサービスの終了処理を始めます。省略した場合は，60秒が設定されます。指定できる値は，1～86,400（24時間）です。

[Command]

すべてのサービスが起動または終了したあとに実行するコマンドまたはバッチファイルを記述するセクションです。このセクションでは，ReadyCommand=およびStopReadyCommand=だけを指定できます。

ReadyCommand=

［Command］セクションで指定します。すべてのサービス開始処理が完了したあとに実行するコマンド名を指定します。複数のコマンドを実行したい場合は，バッチファイルを作成し，ReadyCommandには，バッチファイルを指定してください。

StopReadyCommand=

［Command］セクションで指定します。すべてのサービス終了処理が完了したあとに実行するコマンド名を指定します。複数のコマンドを実行したい場合は，バッチファイルを作成し，StopReadyCommandには，バッチファイルを指定してください。

注意事項

セクションを囲む「[　]」は省略できません。セクションを起動順序定義ファイル（JP1SVPRM.DAT）に記述する場合，必ず「[　]」で囲んでください。

各セクション名は，起動順序定義ファイル（JP1SVPRM.DAT）内に一つだけ記述してください。同名のセクションがある場合，起動順序定義ファイル（JP1SVPRM.DAT）内で先に指定してあるセクションが有効になります。

各セクションのパラメーターに指定する名称およびコマンド名は，各セクション内で重複しないようにしてください。セクション内に同名の名称およびコマンド名がある場合，セクション内で先に指定してある名称およびコマンド名が有効になります。

起動順序定義ファイル（JP1SVPRM.DAT）内のセクション名の記述は順序を問いません。ただし，[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクション単位では，起動順序定義ファイル（JP1SVPRM.DAT）の先頭から記述している順序に従って処理が実行されます。

依存関係が結ばれているサービスを起動順序定義ファイル（JP1SVPRM.DAT）に記述する場合は，主となるサービスを先に，従属的なサービスを後に記述してください。従属的サービスを先に記述すると，従属的なサービスの起動時に，主サービスが自動的に起動してしまいます。このような場合，JP1/Baseは，主サービスの終了処理をしません。

StopCommand=に指定したコマンドは，起動管理機能を使って起動したサービス（StartCommand=を使って起動したサービス）にだけ有効です。起動管理機能の実行時にすでに起動していたサービスは，StopCommand=にコマンドの指定があっても，終了処理をしません。

StartCommand=，StopCommand=，ReadyCommand=，およびStopReadyCommand=に指定するコマンドには，対話操作が必要なコマンドおよびGUI画面を表示するコマンドは指定できません。
対話操作が必要なコマンドおよびGUI画面を表示するコマンドを指定すると，正常に動作しないで機能が停止してしまいます。

StartCommand=，StopCommand=，ReadyCommand=，およびStopReadyCommand=に指定するコマンドには，ネットワーク上のほかのマシンに対するアクセス権を与えることができません。ネットワーク上のほかのマシンに対して操作するコマンドを指定すると，実行時にエラーとなります。

コマンド名をフルパスで指定した場合に，スペースが含まれるときは，指定したコマンド名を「"　"」で囲んで指定してください。スペースを含まないときは，「"　"」で囲まなくてもかまいません。また，コマンドには，引数を指定できます。

Windowsのスタートメニューから［シャットダウン］を選択して，シャットダウンを実行した場合，サービスの終了順序は制御されません。サービスの終了順序を制御したい場合，JP1/Power Monitorからのシャットダウンを実行する必要があります。

JP1/Base Control Serviceサービスを手動で停止した場合，起動順序定義ファイル（JP1SVPRM.DAT）で設定をしていても，サービスの終了順序は制御されません。

JP1/Base Control Serviceサービスを利用しないで各サービスを自動起動または手動起動したい場合，起動順序定義ファイル（JP1SVPRM.DAT）内に定義されている該当するサービスの定義を必ずコメントアウトしてください。また，依存関係にあるすべてのサービスの定義も必ずコメントアウトしてください。該当するサービスの定義部分すべての行頭に#（シャープ）を付けることによって，コメントアウトできます。
このように起動順序定義ファイル（JP1SVPRM.DAT）を編集したあと，各サービスの操作を［コントロールパネル］上の［サービス］ダイアログボックス上で行ってください。コメントアウトしないで各サービスを自動起動または手動起動した場合，KAVA4003-Eメッセージが出力され，正常に動作しなくなる場合があります。

次に示すセクションのパラメーターにスペースを含むバッチファイル名を指定する場合，「cmd /c "バッチファイル名"」と指定してください。スペースを含むバッチファイル名をそのまま指定するとコマンドが正常に実行されません。

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクション

StartCommandパラメーター

StopCommandパラメーター

[Command]セクション

ReadyCommandパラメーター

StopReadyCommandパラメーター

（例）StopCommand="cmd /c "D:¥Program Files¥HITACHI¥JP1Base¥conf¥boot¥
stop_baseev.bat""

定義例

起動順序定義ファイル（JP1SVPRM.DAT）の設定例を次に示します。

# JP1/Power Monitorからの強制終了時にサービスを順序どおりに終了する場合，
# 記述します。
[ControlValue]
ForcedTerminateExec=YES

# JP1製品のサービスより前に起動するサービスを記述します。
[FrontOtherService1]
Name=ABC
ServiceName=ABC
StartCommand="c:¥Program Files¥ABC¥start.exe" -start
StopCommand="c:¥Program Files¥ABC¥start.exe" -stop
[FrontOtherService2]
Name=DEF
ServiceName=def_serv

# JP1製品のサービスを記述します。
[Jp1BaseStart]
Name=JP1/Base
ServiceName=JP1Base
StopCommand="jbs_spmd_stop.exe"
[Jp1BaseEvent]
Name=JP1/Base Event
ServiceName=JP1_Base_Event
  :
[Jp1Nps]
Name=JP1/Nps
ServiceName=JP1_NPS
Wait=60
Parallel=YES

#JP1製品のサービスより後に起動するサービスを記述します。
[OtherService1]
Name=XYZ
ServiceName=XYZ

# 全サービス終了後に実行するコマンドを記述します。
[Command]
StopReadyCommand=c:¥sfiles¥stop.exe

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）

形式

[StartTimeControl]
DelayTime=サービス起動処理の遅延時間（秒）
SurveillanceTime=タイマー監視時間（秒）

ファイル名

Jp1svprm_wait.dat（サービス起動遅延時間／タイマー監視時間定義ファイル）

Jp1svprm_wait.dat.sample（サービス起動遅延時間／タイマー監視時間定義ファイルのサンプル）

格納先ディレクトリ

インストール先フォルダ¥conf¥boot¥

説明

起動順序定義ファイル（JP1SVPRM.DAT）に指定したサービスの起動を待機させる時間と，指定したサービスが正常に起動したかどうかを監視する時間を設定しておくファイルです。

定義の反映時期

Windowsまたは起動順序定義ファイル（JP1SVPRM.DAT）に指定しているすべてのサービスを停止したあと，JP1/Base Control Serviceサービスを再起動すると，設定が有効になります。

記述内容

サービス起動処理の遅延時間

起動順序定義ファイル（JP1SVPRM.DAT）に指定したサービスの起動を待機させる時間を1～900（秒）の範囲で指定します。

タイマー監視時間

サービスの起動を監視する時間を60～900（秒）の範囲で指定します。タイマー監視時間に指定した時間内にサービスが正常に起動しなかった場合，Windowsのイベントログおよび統合トレースログにメッセージが出力されます。

注意事項

サービスの起動タイミングを設定すると，起動順序定義ファイル（JP1SVPRM.DAT）のParallel=YES（サービスの並行起動の許可）の設定は無効になります。

起動管理機能で起動しているサービスをJP1/Cm2/SSOで監視またはJP1/Power Monitorで制御しているシステムでは，サービスの起動を待機する時間分，監視または制御が遅れるため注意してください。

サービス起動処理の待機中に，ローカルマシンのJP1/Power Monitorから計画終了または強制終了しても，サービスの起動を待機する時間が経過するまで，システムの停止処理は待たされます。

定義例

サービス起動遅延時間／タイマー監視時間定義ファイル（Jp1svprm_wait.dat）の設定例を次に示します。

[StartTimeControl]
DelayTime=60
SurveillanceTime=600

イベントサーバインデックスファイル

形式

server　イベントサーバ名　ディレクトリ名

ファイル名

index

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥event¥

UNIXの場合

/etc/opt/jp1base/conf/event/

説明

イベントサーバ設定，転送設定，イベントDB，ワークファイルの格納場所としてイベントサーバが使用するディレクトリを設定しておくファイルです。通常は初期設定から変更する必要はありません。

JP1/Baseをインストールしたディレクトリ以外の大容量ディスクや高速なディスクなどを指定したい場合や，自ホストで複数のイベントサーバを起動したい場合に，イベントサーバを複数定義します。

定義の反映時期

イベントサービスを起動すると，設定が有効になります。

記述内容

イベントサーバインデックスファイル（index）には，次に示す規則があります。

1行1,024バイト以内，ファイルサイズ2ギガバイト以内のテキストファイルにしてください。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。コメントと空行は，ファイル中の任意の場所に記述できます。

英字の大文字小文字は区別されます。

イベントサーバを定義し，使用するディレクトリを指定します。なお，イベントサーバを自ホスト上で複数起動する場合，イベントサーバと使用するディレクトリは，1対1で対応させてください。

server　イベントサーバ名　ディレクトリ名

イベントサーバ名

定義するイベントサーバ名を指定します。イベントサーバ名には，次に示すどれかを指定します。初期設定では，「*」が設定されています。

*
自ホスト名（hostnameコマンドで返される値）が仮定されます。通常は，初期設定の「*」で問題ありませんが，DNSに対応させる場合は，「*」をイベントサーバ名または「@」に変更してください。

イベントサーバ名
DNSに対応させる場合，またはクラスタシステムで使用する場合に指定します。DNSを使ったシステムでのイベントサーバの設定例については，「8.1.3　DNSを使ったシステムでのイベントサーバの設定」を参照してください。
イベントサーバ名は，イベントサーバを起動するホスト名を255バイト以内の文字列で指定してください。英字の大文字小文字は区別されます。なお，DNSに対応させた環境でイベントサービスの定義情報の配布と収集を利用する場合は，「@」を指定してください。

@
「@」を指定すると，DNSに対応します。また，DNSに対応させた環境でイベントサービスの定義情報の配布と収集を利用できるイベントサーバとなります。

ディレクトリ名

イベントサーバが使用するディレクトリを変更できます。変更した場合は，イベントサーバ設定，転送設定ファイルを配置してください。

フルパスで指定した場合
指定したディレクトリにイベントDBおよびワークファイルをすべて格納します。

部分パスで指定した場合
次に示すディレクトリのサブディレクトリと見なし，イベントDBおよびワークファイルをすべて格納します。

表14-4　部分パスで指定した場合に基準となるディレクトリ（Windowsの場合）

ファイル名 | ディレクトリ
イベントサーバ設定・転送設定 | インストール先フォルダ¥conf¥event¥servers¥
イベントDB | インストール先フォルダ¥sys¥event¥servers¥
一時的ワークファイル | インストール先フォルダ¥sys¥tmp¥event¥servers¥

表14-5　部分パスで指定した場合に基準となるディレクトリ（UNIXの場合）

ファイル名 | ディレクトリ
イベントサーバ設定・転送設定 | /etc/opt/jp1base/conf/event/servers/
イベントDB | /var/opt/jp1base/sys/event/servers/
一時的ワークファイル | /var/opt/jp1base/sys/tmp/event/servers/

注意事項

DNSに対応させる場合は，DNSが自ホスト名としてFQDN名を返す必要があります。DNSが自ホスト名としてFQDN名を返さない場合，FQDN名のイベントサーバは物理ホストのイベントサーバとして認識されません。

稼働中のイベントサービスのserverパラメーターを変更すると，イベントサービスを停止できなくなります。

イベントサーバ設定ファイル

形式

# コメント
ports　アドレス　転送用ポート指定　AP用ポート指定
client-bind　アドレス
users　{　*　|　ユーザー名　}　…
eventids　{　*　|　基本コード　|　基本コード:拡張コード　}　…
alt-userid　代用ユーザーID　代用グループID
forward-limit　リトライ期限
after-error　エラー後の転送抑止時間
retry-interval　転送リトライ間隔
buffnum　SESイベント数
include　ses-conf　ファイル名
include　ajs-conf
expire　イベント保管期限
db-size　イベントDBの容量
remote-server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]
forward-timeout　待ち時間
options　[no-sync | sync]　[remote-receive]　[conv-off]　[v5-unused]　[KAJP1037-hntroff]　[KAJP1037-syslogoff]　[save-rep]　[auto-forward-off]
error-size　ファイルサイズ
trace-size　ファイルサイズ
evtlog-size　ファイルサイズ
fwderr-size　ファイルサイズ
log-keep　ログファイルの個数
log-level　レベル
repetition-noncheck-server　{　*　|　イベントサーバ名　}　…
restart　再起動回数　リトライ間隔　リセット時間

ファイル名

conf

格納先ディレクトリ

Windowsの場合

イベントサーバインデックスファイルで指定したフォルダ¥
共有フォルダ¥jp1base¥event¥conf¥（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，インストール先フォルダ¥conf¥event¥servers¥default¥となっています。

UNIXの場合

イベントサーバインデックスファイルで指定したディレクトリ/
共有ディレクトリ/event/conf/（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，/etc/opt/jp1base/conf/event/servers/default/となっています。

説明

イベントサービスの各種動作環境を設定するファイルです。主に次の項目を設定します。

JP1イベント送受信用のIPアドレスやポート番号

取得できるJP1イベントおよびJP1イベントを取得できるJP1ユーザーの指定

イベント転送失敗時のリトライ

JP1/SESおよびJP1/AJSの稼働するホストとのJP1イベントの送受信

イベントDB内のJP1イベントの保管期限およびイベントDBの容量

他ホストのイベントサーバにJP1イベントを転送するときの接続方法および転送時のエラーへの対処方法

定義の反映時期

イベントサービスを起動または再起動すると，設定が有効になります。

記述内容

イベントサーバ設定ファイル（conf）には，次に示す規則があります。

1行1,024バイト以内，ファイルサイズ2ギガバイト以内のテキストファイルにしてください。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。コメントと空行は，ファイル中の任意の場所に記述できます。

英字の大文字小文字は区別されます。

ports　アドレス　転送用ポート指定　AP用ポート指定

このイベントサーバが，他プログラムからの接続を受け入れるために使用するIPアドレスとポート番号を指定します。なお，このパラメーターでの指定は，バージョン5以前の製品であるJP1/SESまたはJP1/AJSが稼働するホストからのイベント受信には適用されません。

アドレス

使用するIPアドレスを次に示すどれかの形式で指定します。

portsパラメーターを省略すると，アドレスとして，イベントサーバ名が指定されたものと仮定します。

0.0.0.0
IPアドレスを特に限定しないで，システムに任せることを指定します。
システムを物理ホストだけで運用する場合は，この値を指定してください。

IPアドレス
ピリオドで区切った10進数（例: 172.16.50.50）で指定します。IPアドレスを指定する場合は，複数指定できます。IPアドレスの複数指定は，主にネットワークを分離した環境でイベントサービスを運用するときに利用します。ネットワークを分離した環境での運用については，「4.3　ネットワークを分離した環境での運用」を参照してください。IPアドレスを複数指定する場合は，IPアドレスを:（半角コロン）で区切って指定します（例: 172.16.50.50:172.16.50.51:172.16.50.52）。IPアドレスは，最大で4指定できます。
注意事項
OSの名前解決でプライマリーに返されるIPアドレス以外のIPアドレスを指定した場合，API設定ファイルのserverパラメーターには，明示的にIPアドレスを指定してください。

ホスト名
システムのhostsファイル，ネームサーバなどでIPアドレスに変換できる255バイト以内の名称を指定します。

転送用ポート指定

他サーバからのJP1イベント転送を受け付けるためのポート番号を次に示すどちらかの形式で指定します。

ポート番号
ポート番号を，10進数で指定します。

サービス名
システムのservicesファイルで定義されている，tcpのサービス名を指定します。通常は，サービス名として「jp1imevt」を指定してください。portsパラメーターを省略すると，この値を仮定します。

AP用ポート指定

JP1イベントを発行または取得するアプリケーションからの要求を受け付けるためのポート番号を次に示すどちらかの形式で指定します。

ポート番号
ポート番号を，10進数で指定します。

サービス名
システムのservicesファイルで定義されている，tcpのサービス名を指定します。通常は，サービス名として「jp1imevtapi」を指定してください。portsパラメーターを省略すると，この値を仮定します。

client-bind　アドレス

このイベントサーバが，他プログラムにJP1イベントを送信するために使用するIPアドレスを指定します。このパラメーターは，ネットワークを分離した環境でイベントサービスを運用するときに利用します。通常は，このパラメーターを指定する必要はありません。このパラメーターを省略すると，portsパラメーターに指定されたアドレスでJP1イベントを送信します。複数のアドレスが指定されている場合は，先頭のアドレスが設定されます。ネットワークを分離した環境での運用については，「4.3　ネットワークを分離した環境での運用」を参照してください。また，このパラメーターでの指定は，バージョン5以前の製品であるJP1/SESまたはJP1/AJSが稼働するホストへのイベント送信には適用されません。

アドレス

使用するIPアドレスを次に示すどちらかの形式で指定します。

0.0.0.0
IPアドレスを特に限定しないで，システムに任せてイベント送信します。複数LAN対応の通信設定をする場合，通常はこの値を指定してください。

IPアドレス
ピリオドで区切った10進数で指定します。指定したIPアドレスを利用してイベント送信します。

users　{　*　|　ユーザー名　}　…

JP1イベントを取得できるユーザー名を指定します。

このパラメーターは複数指定でき，すべての指定の和が，JP1イベントを取得できるユーザーとなります。このパラメーターを一つも指定しないと，どのユーザーもJP1イベントを取得できません。

*

すべてのユーザーがJP1イベントを取得できるようになります。

ユーザー名

ユーザー名を指定します。指定されたユーザー名を持つユーザーが，JP1イベントを取得できます。

eventids　{　*　|　基本コード　|　基本コード:拡張コード　}　…

プログラムで取得できるイベントIDを指定します。ここで指定されないイベントIDのJP1イベントは，発行されてもエラーにはなりませんが，取得できません。

このパラメーターは複数指定でき，すべての指定の和が，取得できるJP1イベントとなります。このパラメーターを一つも指定しないと，JP1イベントを取得できません。

*

すべてのJP1イベントを取得できるようになります。

基本コード

イベントIDの基本コードを，1～8桁の16進数で指定します。拡張コードには，0が仮定されます。

基本コード:拡張コード

イベントIDの基本コードと拡張コードを，それぞれ1～8桁の16進数で，コロンで区切って指定します。

alt-userid　代用ユーザーID　代用グループID

WindowsおよびJavaの実行環境は，数値形式のユーザーID・グループIDの概念を持たないため，代わりにイベントデータ中に設定する値を指定します。

代用ユーザーIDおよび代用グループIDは，-1～65,535の10進数で指定します。省略すると，どちらも-1を仮定します。

forward-limit　リトライ期限

JP1イベントの転送に失敗した場合の，リトライを繰り返す期限を指定します。転送設定ファイル（forward）で指定したJP1イベントの転送は，転送に成功するか，ここで指定した時間が過ぎるまで，retry-intervalパラメーターで指定した間隔で繰り返されます。値は，0～86,400（秒）の10進数で指定します。省略した場合は，0（リトライしない）を仮定します。なお，このパラメーターを設定する場合は，retry-intervalパラメーターで指定するリトライ間隔よりも大きい値を指定してください。

after-error　エラー後の転送抑止時間

ある他サーバへのJP1イベント転送が失敗した後，そのサーバへのJP1イベント転送を抑止する時間を指定します。したがって，指定された時間内は，JP1イベントはそのサーバへ転送されず，エラーとして扱われます。値は0～2,147,483,647（秒）の10進数で指定します。retry-intervalパラメーターよりも小さい値を指定してください。このパラメーターを省略すると，30秒を仮定します。

retry-interval　転送リトライ間隔

JP1イベントの転送失敗時にリトライする間隔を指定します。値は，60～2,147,483,647（秒）の10進数で指定します。after-errorパラメーターよりも大きい値を指定してください。このパラメーターを省略すると，600秒を仮定します。

リトライに関連するパラメーターの相関関係

JP1イベントの転送のリトライに関連するパラメーターは，forward-limit，after-error，retry-intervalです。初期設定では，JP1イベントの転送に失敗すると，3,600秒の間600秒の間隔で転送をリトライします。

クラスタ運用の場合，JP1イベントの転送中に転送元ホストまたは転送先ホストがフェールオーバーすると，そのJP1イベントの転送は失敗します。確実にJP1イベントを転送するために，必ず転送をリトライするように設定してください。

JP1イベントの転送のリトライに関連するパラメーターの相関関係を次の図に示します。

図14-2　リトライ関連のパラメーターの相関関係

なお，転送抑止期間を除いたリトライ間隔内で，次のJP1イベントの転送が発生した場合には，その時点でリトライが行われます。

JP1イベントの転送のリトライ中にイベントサービスの再起動またはリロードが行われた場合，転送されなかったJP1イベントはリトライ期限内であればイベントサービスの起動時に再送されます。

buffnum　SESイベント数

JP1/SESイベントを使用する製品と連携するための機能に関連するパラメーターです。このパラメーターの詳細については，「付録J　JP1/SESイベントを使用する製品との連携」を参照してください。

include　ses-conf　ファイル名

JP1/SESイベントを使用する製品と連携するための機能に関連するパラメーターです。このパラメーターの詳細については，「付録J　JP1/SESイベントを使用する製品との連携」を参照してください。

include　ajs-conf

JP1/SESイベントを使用する製品と連携するための機能に関連するパラメーターです。このパラメーターの詳細については，「付録J　JP1/SESイベントを使用する製品との連携」を参照してください。

expire　イベント保管期限

発行されたJP1イベントを，イベントDBに保管しておく時間を指定します。JP1イベントはJP1イベントの発行後，ここで指定された時間内はイベントDB中に保管され，JP1/IM - Viewなどから参照できます。ただし，イベントDBの容量がdb-sizeパラメーターで指定した値に達した場合は，保管期限に達していなくても削除されることがあります。値は0～2,147,483,647（秒）の10進数で指定します。このパラメーターを省略すると，31,536,000秒，つまり365日が仮定されます。

db-size　イベントDBの容量

イベントDBの容量を指定します。指定された容量に達すると，expireパラメーターで指定した期限に達していなくても，古いJP1イベントが削除されることがあります。イベントサービスでは，指定された容量の最大約2倍のディスク容量を使用します。値は0～2,147,483,647（バイト）の10進数で指定します。このパラメーターを省略すると，2,147,483,647バイトが仮定されます。

保存する日数分のイベントDBの容量の計算式を次に示します。容量を指定する際に参考にしてください。

[{a × (b + 64) + (c × 64)}× d]/2 （バイト）

a：1日当たりに登録されるイベント※の総数。

b：イベント1件当たりの平均サイズ。サイズは実測で測定してください。

c：1日当たりに転送されるイベントの総数。

d：保存する日数。

注※　1日当たりに登録されるイベントとは，自ホスト上で発生するイベント，他ホストから受信するJP1/SESイベントおよびJP1イベント，転送されるイベントのことを指します。

remote-server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]

他サーバへイベントを転送する際の接続方法を指定します。このパラメーターには，異なるイベントサーバ名を複数指定できます。

イベントサーバ名

定義するイベントサーバ名を，次に示すどちらかの形式で指定します。

イベントサーバ名
個別のイベントサーバ名を，255バイト以内で指定します。

*
個別に指定されなかったイベントサーバ名に対する省略値を指定します。
この指定がない場合は，個別に指定されていないイベントサーバに対してはイベントを転送できません。

通信タイプ

指定したイベントサーバへの接続方法を指定します。

keep-alive
転送するJP1イベントが発生したら，転送元からTCP/IPのコネクションを張って送信します。 JP1イベント送信後，イベントサーバの終了時までコネクションを保存し再利用します。
注意事項
ファイアウォールで無通信時にコネクションを切断する設定をしている場合，または一時的な通信障害が発生した場合は，コネクション切断後の最初のJP1イベントの転送に失敗するおそれがあります。

close
転送するJP1イベントが発生したら，転送元からTCP/IPのコネクションを張って送信します。送信後は3秒後にコネクションを切断します。

ses
JP1/SESイベントを使用する製品と連携するための機能に関連するパラメーターです。このパラメーターの詳細については，「付録J　JP1/SESイベントを使用する製品との連携」を参照してください。

アドレス

使用するIPアドレスを次に示すどちらかの形式で指定します。

IPアドレス
ピリオドで区切った10進数（例: 172.16.50.50）で指定します。

ホスト名
システムのhostsファイル，ネームサーバなどでIPアドレスに変換できる255バイト以内の名称を指定します。

対象とするイベントサーバの，イベントサーバ設定ファイル（conf）に指定したportsパラメーターと一致させてください。

省略すると，ホスト名としてイベントサーバ名を仮定します。

ポート指定

使用するポート番号を次に示すどちらかの形式で指定します。

ポート番号
ポート番号を，10進数で指定します。

サービス名
システムのservicesファイルで定義されている，tcpのサービス名を指定します。

対象とするイベントサーバの，イベントサーバ設定ファイル（conf）に指定したportsパラメーターと一致させてください。

省略すると，自イベントサーバの転送用ポートと同じ値を仮定します。

forward-timeout　待ち時間

JP1イベントを転送する場合に，転送先からの応答を待つ時間を指定します。指定した時間内に応答がなかった場合は，転送失敗と見なします。

値は，10～600（秒）の10進数で指定します。省略すると，90秒を仮定します。

options　[no-sync | sync]　[remote-receive]　[conv-off]　[v5-unused]　[KAJP1037-hntroff]　[KAJP1037-syslogoff]　[save-rep]　[auto-forward-off]

オプションのフラグを指定します。このパラメーターは，複数に分けて指定できます。

no-sync | sync

no-syncフラグを指定すると，JP1イベントのデータベースへの書き込みの，システムによるバッファリングを許します。JP1イベント発行の性能向上が期待できますが，システムが何らかの障害で停止した場合に，発行済みJP1イベントが消失することがあります。クラスタ運用をする場合は，信頼性の向上を目的とするため，指定しないでください。

syncフラグを指定すると，発行されたJP1イベントをそのつど確実にディスクに書き込みます。システムの再起動後も確実に取得できます。ただし，JP1イベントが発行されるたびにディスクに書き込むため，JP1イベント発行の性能が劣化する場合があります。

no-syncフラグ，syncフラグのどちらも指定しない場合，ディスクへの書き込みが定期的（10秒）となるため，発行済みJP1イベントが消失することがあります。

remote-receive

他ホストで稼働しているプログラムからの，ネットワークを介したJP1イベント取得を許します。

ほかのホストに接続したJP1/IM - ViewのGUIから，このホストのJP1イベントを検索する場合，およびバージョン5以前の製品であるJP1/AOM - EEの情報を参照する場合は，このフラグの指定が必要です。

conv-off

JP1/SESイベントを使用する製品と連携するための機能に関連するフラグです。このフラグの詳細については，「付録J　JP1/SESイベントを使用する製品との連携」を参照してください。

v5-unused

バージョン5以前の製品であるJP1/SES，JP1/AJSとの互換性のために用意されているすべての機能の利用を抑止します。このフラグを指定するとJP1/SES，JP1/AJSの互換プロセスを起動しません。このため，JP1/OJEなどJP1/SESのプロトコルを利用している製品と，イベントの送受信ができなくなります。

このフラグはバージョン5以前に対応していた製品と連携する場合を除き，外さないでください。バージョン5以前に対応していた製品との連携については，「付録J　JP1/SESイベントを使用する製品との連携」を参照してください。

KAJP1037-hntroff

KAJP1037-E（イベント転送失敗）メッセージの統合トレースログへの出力を抑止します。

KAJP1037-syslogoff

KAJP1037-E（イベント転送失敗）メッセージのsyslog（UNIX）およびイベントログ（Windows）への出力を抑止します。

save-rep

イベントDBの重複防止テーブルをファイルに保持します。重複防止テーブルとは，JP1イベントが重複して登録されることを防止するテーブルです。

save-repフラグを指定する場合，イベントDBを格納するディレクトリには，32 + 転送元イベントサーバ総数 × 288 バイトの空き容量が必要です。重複防止テーブルについては，「1.4.2　イベントDBの概要」を参照してください。

auto-forward-off

ホストの起動通知イベント（00004724）および停止通知イベント（00004725）が，抽出条件に一致しなくても転送される機能を無効にします。このフラグを指定した場合，ホストの起動通知イベントおよび停止通知イベントも，ほかのイベントと同様に，抽出条件に一致する場合だけ転送されるようになります。

注意事項

KAJP1037-hntroff，KAJP1037-syslogoffを設定しても，転送エラーを通知するKAJP1017-Eは統合トレースログおよびsyslog（UNIX），イベントログ（Windows）に出力されます。転送エラーはKAJP1017-Eで監視してください。

KAJP1037-Eメッセージは，イベントサービス転送エラーログ（fwderr.*）でも確認できます。

error-size　ファイルサイズ

イベントサービスエラーログファイル（error.*）の最大容量を指定します。指定したサイズを超えると，イベントサービスエラーログファイルは， 先頭から上書きされます。値は，65,536～2,147,483,647（バイト）までの10進数で指定します。省略すると，500,000バイトを仮定します。

保存する日数分のイベントサービスエラーログファイルの容量の計算式を次に示します。ファイルサイズを指定する際に参考にしてください。

a + (b × c) × d （バイト）

a：基本部1キロバイト。

b：エラーのメッセージの平均サイズ（約120バイト）。

c：1日当たりのエラーの発生回数。

d：保存する日数。

trace-size　ファイルサイズ

イベント転送トレースログファイル（trace.*）の最大容量を指定します。指定したサイズを超えると，イベント転送トレースログファイルは，先頭から上書きされます。値は，65,536～2,147,483,647（バイト）までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する日数分のイベント転送トレースログファイルの容量の計算式を次に示します。ファイルサイズを指定する際には，ログの出力量および1日当たりのイベント取得件数も考慮に入れて設定してください。

a + (b + c + d) × e （バイト）

a：基本部1キロバイト。

b：イベント1件登録時のログの出力量 × 1日当たりのイベント登録件数

c：イベント1件取得時のログの出力量 × 1日当たりのイベント取得件数

d：イベント1件転送時のログの出力量 × 1日当たりのイベント転送件数

e：保存する日数。

ログの出力量はイベントサービスの動作によって異なりますが，参考値としてのログの出力量を次に示します。

表14-6　ログの出力量（イベント転送トレースログ）

出力されるログの量(バイト)
イベント1件登録時 | イベント1件取得時※1 | イベント1件転送時※2（失敗時・イベント転送リトライ設定あり）
約150※3 | 約150※3 | 約1,500

注※1　イベント取得には，他アプリケーションによるJP1イベントの取得を含みます。参考値は，10件登録されているイベントDBの10件目のJP1イベント取得時のログ出力量となっています。また，イベントDBに登録されているJP1イベントの件数と，検索するJP1イベントの登録位置によって出力される量は変わります。

注※2　JP1イベント転送時にログ出力が最大になるのは，JP1イベントの転送に失敗し，リトライする場合です。

注※3　API設定ファイル（api）で，通信タイプをcloseに設定した場合のログの量です。

イベント取得件数は，ユーザーアプリケーションやJP1シリーズのプログラムからイベント取得関数を使用してイベントを取得する件数です。JP1シリーズのプログラムの1日当たりのイベント取得件数は，次の計算式で求めた値を目安にしてください。

イベント取得回数※1 × イベントDBに登録されているイベント数 + 1日当たりのイベント登録件数※2

注※1　JP1/IMから，下記の回数の合計分だけイベントDBに対してイベントを取得します。

JP1/IM - Viewの起動の回数

JP1/IM - Viewのイベント検索の回数

注※2　JP1/AJSのイベント受信ジョブが実行登録されている場合，JP1/AJSは，新たにイベントDBに登録されたイベントを取得します。なお，イベント受信ジョブが複数登録されていても，JP1/AJSは登録されたイベントに対して1回だけイベントを取得します。

evtlog-size　ファイルサイズ

イベントサービストレースログファイル（imevterr.*）の最大容量（バイト数）を指定します。指定したサイズを超えると，イベントサービストレースログファイルは，先頭から上書きされます。値は，65,536～2,147,483,647までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する日数分のイベントサービストレースログの容量の計算式を次に示します。ファイルサイズを指定する際には，ログの出力量および1日当たりのイベント取得件数も考慮に入れて設定してください。

a + (b + c + d) × e （バイト）

a：基本部1キロバイト。

b：イベント1件登録時のログの出力量 × 1日当たりのイベント登録件数

c：イベント1件取得時のログの出力量 × 1日当たりのイベント取得件数

d：イベント1件転送時のログの出力量 × 1日当たりのイベント転送件数

e：保存する日数。

ログの出力量はイベントサービスの動作によって異なりますが，参考値としてのログの出力量を次に示します。なお，イベントサービストレースログファイルは，log-levelパラメーターで設定されたログレベルに影響されません。

表14-7　ログの出力量（イベントサービストレースログ）

出力されるログの量（バイト）
イベント1件登録時 | イベント1件取得時※1 | イベント1件転送時※2（失敗時・イベント転送リトライ設定あり）
約3,000 | 約7,000 | 約3,000

注※1　イベント取得には，他アプリケーションによるJP1イベントの取得を含みます。参考値は，10件登録されているイベントDBの10件目のJP1イベント取得時のログ出力量となっています。また，イベントDBに登録されているJP1イベントの件数と，検索するJP1イベントの登録位置によって出力される量は変わります。

注※2　JP1イベント転送時にログ出力が最大になるのは，JP1イベントの転送に失敗し，リトライする場合です。

イベント取得件数は，ユーザーアプリケーションやJP1シリーズのプログラムからイベント取得関数を使用してイベントを取得する件数です。JP1シリーズのプログラムの1日当たりのイベント取得件数は，次の計算式で求めた値を目安にしてください。

イベント取得回数※1 × イベントDBに登録されているイベント数 + 1日当たりのイベント登録件数※2

注※1　JP1/IMから，下記の回数の合計分だけイベントDBに対してイベントを取得します。

JP1/IM - Viewの起動の回数

JP1/IM - Viewのイベント検索の回数

注※2　JP1/AJSのイベント受信ジョブが実行登録されている場合，JP1/AJSは，新たにイベントDBに登録されたイベントを取得します。なお，イベント受信ジョブが複数登録されていても，JP1/AJSは登録されたイベントに対して1回だけイベントを取得します。

fwderr-size　ファイルサイズ

イベントサービス転送エラーログファイル（fwderr.*）の最大容量を指定します。指定したサイズを超えると，イベントサービスエラーログファイルは，先頭から上書きされます。値は，65,536～2,147,483,647（バイト）までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する転送失敗イベント数分の転送エラーログ容量の計算式を次に示します。

保存する転送失敗イベント数×（ 150 ＋ イベントサーバ名長 ＋送信先イベントサーバ名長）

送信先イベントサーバが複数ある場合，送信先イベントサーバ名長は，送信先イベントサーバの中で最も長い送信先イベントサーバ名長とします。

log-keep　ログファイルの個数

イベントサービスエラーログファイル，イベント転送トレースログファイル，およびイベントサービストレースログファイルを最大で幾つ作成するかを指定します。ログファイルは，イベントサービスの起動時に作成されます。イベントサービスの起動時に，指定した数以上のファイルがある場合は，最も古いファイルから削除されます。値は，0～50の10進数で指定します。省略すると，5を仮定します。0を指定するとログを保存しません。

log-level　レベル

06-51以前のJP1/Baseでは，syslog，イベントログ，イベントサービスエラーログファイル，およびイベント転送トレースログファイルへのログの出力レベルを指定できます。値は，1～10の10進数で指定します。省略すると，1を仮定します。通常は，値を1にしてご利用ください。なお，2以上の値を設定した場合は，障害発生時や障害から回復した場合などの詳細なログが出力されるようになります。

06-71以降のJP1/Baseでは，値に関係なく詳細なログが出力されるため，設定は不要です。

repetition-noncheck-server　{　*　|　イベントサーバ名　}　…

重複登録チェックを抑止するイベントサーバ名を指定します。重複登録チェックとは，JP1イベントの転送を受信する際にそのJP1イベントがすでに登録されているかどうかをチェックする処理のことを指します。重複と判断されるのは，JP1イベントの発行元イベントサーバ名，発行元イベントDB内通し番号，登録時刻が一致する場合です。

JP1/SESのプロトコルで発生したイベントを複数経路から転送する場合にイベントのロストを防ぐために使用します。

このパラメーターは複数指定でき，すべての指定の和が，重複登録チェックを抑止するイベントサーバとなります。このパラメーターを一つも指定しないと，すべての転送元イベントサーバからのJP1イベントの重複登録チェックを行います。

*

すべての転送元イベントサーバからの重複登録チェックが抑止されます。

イベントサーバ名

重複登録チェックを抑止するイベントサーバ名を個別に指定します。イベントサーバ名は，英字の大文字小文字を区別します。

restart　再起動回数　リトライ間隔　リセット時間

物理ホストのイベントサービスのプロセスが異常終了した場合の再起動の動作を設定します。再起動するための設定として，再起動回数，再起動のリトライ間隔および再起動回数のリセット時間を指定します。リセット時間で指定した期間内にプロセスが異常終了した回数が，再起動回数以下であれば，プロセスは再起動されます。再起動されると，回復したときにメッセージ（KAJP1072-I）を出力します。このメッセージはJP1イベント（イベントID：00003D04）としても通知されます。したがって，運用時にこのJP1イベントを監視すると，イベントサービスのプロセスが再起動されたことを検知できます。この指定はUNIX版のJP1/Baseだけで有効になり，Windows版のJP1/Baseでは無効になります。このパラメーターを省略した場合，イベントサービスのプロセスが異常終了しても，再起動されないため，イベントサービスは停止します。

なお，イベントサービスの再起動中は，転送元ホストから転送されるJP1イベントを受け付けられません。転送元ホストでJP1イベント転送のリトライを設定している場合は転送がリトライされますが，リトライ期間を過ぎると転送失敗となります。このような転送失敗を防ぐために，再起動回数×リトライ間隔の値は，転送元ホストのconfで指定するJP1イベント転送のリトライ期限（forward-limitパラメーター）の値より小さくなるよう設定してください。

再起動回数

再起動の試行回数を指定します。推奨値は4回です。値は，0～99（回）の10進数で指定します。0を指定した場合，再起動されません。-1以下の値を指定した場合，0を仮定します。100以上の値を指定した場合，99を仮定します。

リトライ間隔

イベントサービスのプロセスが異常終了してから再起動をするまでの間隔を指定します。再起動に失敗した場合は，指定した間隔後に再起動します。推奨値は15秒です。値は，0～3,600（秒）の10進数で指定します。-1以下の値を指定した場合，0を仮定します。3,601以上の値が指定された場合，3,600を仮定します。

リセット時間

再起動によってプロセスが起動してから，何秒後に再起動回数をリセットするかを指定します。プロセスが起動してから，指定した時間が経過すると，再起動回数がリセットされます。リセット時間の推奨値は，3,600秒です。値は，3,600～2,147,483,647（秒）の10進数で指定します。3,599以下の値を指定した場合，3,600秒が仮定されます。2,147,483,648以上の値を指定した場合，2,147,483,647秒を仮定します。

推奨値である，再起動回数に4回，リトライ間隔に15秒，リセット時間に3,600秒を設定した場合の動作を次の図に示します。

図14-3　イベントサービスのプロセスが異常終了した場合の動作例

図の例では，再起動後，再起動回数のリセット時間で指定した3,600秒以内に異常終了しなかった場合，3,600秒の時点で再起動回数がリセットされます。次回異常終了したときには1回目からカウントされます。一方，再起動後，3,600秒以内に異常終了した場合は，再起動回数を引き継ぎます。再起動回数が指定した回数に達すると，次回異常終了時には再起動しません。

注意事項

restartパラメーターの設定によって再起動できるイベントサービスのプロセスは，jevstatコマンドで確認できるプロセスIDのjevserviceプロセスの子プロセスだけです。

親プロセスが異常終了した場合，イベントサービスは停止します。

再起動回数は，子プロセスごとにカウントされます。

jevserviceプロセスの子プロセスには，次の6種類があります。

表14-8　イベントサービスのプロセス構成

親プロセス | 子プロセス | 概要
jevservice | jevservice（LogTrc） | syslogまたは統合トレースログなどへ記録されるメッセージを出力します。
jevservice（DBMngr） | イベントDBを管理します。
jevservice（SESEmu） | SES互換機能です。optionsパラメーターにv5-unusedフラグを設定している場合は起動しません。
jevservice（EvtAPI） | JP1イベントの登録要求または取得要求を受け付けます。
jevservice（FwdRcv） | 転送されてきたJP1イベントを受信します。
jevservice（FwdMgr） | JP1イベントを転送します。

定義例

イベントサーバ設定ファイル（conf）の設定例を次に示します。

# ポート番号は，システムの services ファイルに定義した，jp1imevt，および
# jp1imevtapi を使用する。
ports 0.0.0.0 jp1imevt jp1imevtapi
# ユーザー root と adm で実行されているプログラムだけがJP1イベントを取得
# できる。
users root adm
# JP1/SESのAPIで発行および取得できるJP1イベントは，IDが 2000・2001・3000・
# 3001であるものに限る。JP1/Baseに対応したプログラムでは，すべてのJP1
# イベントを発行および取得できる。
eventids ＊
eventids 2000 2001 3000 3001
# 自マシンがWindowsである場合，また，自マシンがUNIXでもJavaプログラム
# から発行された場合は，JP1イベントをUNIX環境に転送する際，ユーザーID
# またはグループIDがそれぞれ 1001 および 100 であると見なす。
alt-userid 1001 100
# JP1イベントの転送に失敗したときに，転送をリトライする。リトライは，
# 転送に成功するか，1時間(3600秒)経過するまで繰り返す。
forward-limit 3600
# 他ホストへのイベント転送に失敗した場合，ネットワークの負荷増大を
# 防ぐため，そのホストには以後 300 秒間，イベントを転送しない。
after-error 300
# JP1/SESの環境設定ファイル「/usr/bin/jp1_ses/jpevent.conf」を参照し，
# 指定内容を上記 userids・evendids の設定に追加する。
include ses-conf /usr/bin/jp1_ses/jpevent.conf
# 到着後 31日(2678400秒)経ったJP1イベントは，削除する。また，31日
# 経たなくても，保管されたイベントのデータ量が 1000000 バイトに達したら，
# 古いJP1イベントを削除する。
expire 2678400
db-size 1000000
# 他ホストからのJP1イベント取得を許す。(他マシンに接続したJP1/IM -
# Console ViewからJP1/AOM - EEの情報を参照したい場合は必ず
# 指定してください。)
options remote-receive
# JP1イベントのディスクへの書き込みの，OSによるバッファリングを許す。
options no-sync
# host1・host2 は，自LAN内のマシンであるため，TCP/IPに接続した
# ままでよい。
# ほかのマシン(host3以外)は，電話回線を経由するため，接続をこまめに切る。
# host3 は，JP1/BaseでなくJP1/SESを使用している。
remote-server host1 keep-alive
remote-server host2 keep-alive
remote-server host3 ses
remote-server ＊    close
# エラーログファイルの最大容量を 500000バイト，トレースログファイルの
# 最大容量を 1000000バイトとする。この容量を超えると，ファイルの先頭から
# 上書きする。ログファイルが5個以上ある場合は，最も古いファイルから
# 削除する。
error-size 500000
trace-size 1000000
log-keep 5

転送設定ファイル

形式

to-upper
イベントフィルター
end-to
または
to イベントサーバ名
イベントフィルター
end-to

ファイル名

forward

格納先ディレクトリ

Windowsの場合

イベントサーバインデックスファイルで指定されたフォルダ¥
共有フォルダ¥jp1base¥event¥（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，インストール先フォルダ¥conf¥event¥servers¥default¥となっています。

UNIXの場合

イベントサーバインデックスファイルで指定されたディレクトリ/
共有ディレクトリ/event/（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，/etc/opt/jp1base/conf/event/servers/default/となっています。

説明

転送設定ファイル（forward）は，どのイベントサーバにどのJP1イベントを転送するかを記述した転送設定ブロックが集まったファイルです。

定義の反映時期

イベントサービスを起動または再起動するか，またはjevreloadコマンドを実行して転送設定ファイルをリロードすると，設定が有効になります。jevreloadコマンドの詳細については，「13.　コマンド」の「jevreload」を参照してください。

記述内容

転送設定ファイル（forward）には，次に示す規則があります。

転送設定ファイル（forward）は，1行1,024バイト以内のテキストファイルです。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

英字の大文字小文字は区別されます。

転送設定ブロックがto-upper形式の場合，JP1イベントは，JP1/IM - Managerで定義された階層に従って，上位のサーバに転送されます。

転送設定ブロックがto形式の場合，転送先のイベントサーバ名を指定できます。なお，転送先のイベントサーバ名として，自サーバのイベントサーバ設定ファイル（conf）で指定されている他イベントサーバ名を指定する必要があります。

どちらの形式でも他ホストに転送するJP1イベントの条件として，イベントフィルターを記述する必要があります。イベントフィルターの記述形式については，「イベントフィルターの文法」を参照してください。

注意事項

転送設定ファイル（forward）では，転送設定ブロックと転送設定ブロックの間にコメントを記述できますが，転送設定ブロックの途中には記述できません。また，転送設定ブロックは複数指定できます。

イベントフィルターとして転送設定ファイル（forward）に日本語文字列を指定する場合，その文字コードは，イベントサービス起動時のロケール情報（環境変数LANGなど）と合致させてください。イベントフィルターとして指定した文字列の文字コードとイベントサービス起動時のロケール情報（環境変数LANGなど）が異なる場合，JP1イベントは転送されません。

複数の経路を使ってJP1イベントを転送する場合，転送先のイベントサーバが同一のJP1イベントを複数受信する場合があります。この場合，転送されてきたJP1イベントの重複チェックが行われます。重複チェックの条件を次に示します。

一つ目のJP1イベントと「発行元イベントサーバ名」が等しい。

一つ目のJP1イベントと「発行元別通し番号」が等しい。

一つ目のJP1イベントと「登録時刻」が等しい。

「登録要因」が「4」になっている（転送されてきたイベント）。

これらすべての条件を満たした場合，重複しているJPイベントと判断され，二つ目以降のJP1イベントは，イベントDBに登録されません。

同じ転送先を指定した転送ブロック（to～end-to）が複数指定された場合，それぞれのブロックで指定されたイベントフィルターの順番で転送処理が行われます。最終的には各イベントフィルターをORで結合して転送処理を行った場合と等しい転送処理となります。

定義例

次に示すシステム構成でJP1イベントを転送する場合の転送設定の例を示します。

表14-9　転送設定の例の構成

ホスト名 | 構成の説明
jp1-svs1 | 統合マネージャー
jp1-svs2 | サブマネージャー
jp1-sva1 | 拠点内のJP1ホスト

条件

jp1-sva1からjp1-svs2へ転送するJP1イベント

「SEVERITY」が「Error」である

「PRODUCT_NAME」が「/HITACHI/JP1/AJS」であり，かつ「SEVERITY」が「Warning」または「Notice」

「PRODUCT_NAME」が「/HITACHI/JP1/AOM」

jp1-svs2からjp1-svs1へ転送するJP1イベント

「SEVERITY」が「Error」である

「PRODUCT_NAME」が「/HITACHI/JP1/AJS」であり，かつ「SEVERITY」が「Warning」

「PRODUCT_NAME」が「/HITACHI/JP1/AOM」であり，かつ「SEVERITY」が「Warning」

JP1イベント転送の流れを次の図に示します。

図14-4　JP1イベント転送の流れ

jp1-svs1のforwardファイルの定義例

#------------------------------------------------------------------
# JP1/Base - Event Service Forwarding Setting
#------------------------------------------------------------------
# Event Server Name : jp1-svs1
#(Nothing)

jp1-svs2のforwardファイルの定義例

#------------------------------------------------------------------
# JP1/Base - Event Service Forwarding Setting
#------------------------------------------------------------------
# Event Server Name : jp1-svs2
to jp1-svs1
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AJS
E.SEVERITY IN Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
E.SEVERITY IN Warning
end-to

jp1-sva1のforwardファイルの定義例

#------------------------------------------------------------------
# JP1/Base - Event Service Forwarding Setting
#------------------------------------------------------------------
# Event Server Name : jp1-sva1
to jp1-svs2
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AJS
E.SEVERITY IN Warning Notice
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

API設定ファイル

形式

server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]
client　イベントサーバ名　接続元アドレス
log-keep　ログファイルの個数
log-size　ファイルサイズ

ファイル名

api

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥event¥

UNIXの場合

/etc/opt/jp1base/conf/event/

説明

アプリケーションプログラムからイベントサーバへの接続方法や使用するポートを設定しておくファイルです。通常は，初期設定を変更する必要はありません。他ホスト上のイベントサーバから，JP1イベントを取得するアプリケーションプログラムを自ホスト上で実行したい場合に指定を追加します。

また，イベントサーバ設定ファイル（conf）のportsパラメーターを初期設定から変更した場合は，それに合わせて変更する必要があります。

定義の反映時期

JP1/Baseのイベント変換機能や，イベントサービスと連携するJP1/IMやJP1/AJSなどのプログラムを起動または再起動すると，設定が有効になります。

記述内容

API設定ファイル（api）には，次に示す規則があります。

1行1,024バイト以内，ファイルサイズ2ギガバイト以内のテキストファイルにしてください。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。コメントと空行は，ファイル中の任意の場所に記述できます。

英字の大文字小文字は区別されます。

server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]

イベントサーバに接続する方法を指定します。異なるイベントサーバ名で指定する場合，このパラメーターは複数指定できます。

イベントサーバ名

定義するイベントサーバ名を，次に示すどちらかの形式で指定します。

イベントサーバ名
個別のイベントサーバ名を，255バイト以内で指定します。

*
個別に指定しなかったイベントサーバに対する値を指定します。
この指定がない場合は，個別に指定していないイベントサーバには接続できません。

通信タイプ

指定したイベントサーバへの接続の方法を指定します。

keep-alive
アプリケーションプログラムが明示的に接続を切らないかぎり，TCP/IPのコネクションは張ったままで再利用します。

close
1件のJP1イベントの取得ごとに，TCP/IPのコネクションを切断します。電話回線を使用しているなどの理由で，コネクションを常時接続していたくない場合に使用してください。ただし，効率は悪くなります。

注意事項

JP1/AJS，JP1/IM，JP1/Power Monitorでイベントサービスと連携する場合は，必ずkeep-aliveを設定してください。

次に示す場合は，closeを設定した場合でもkeep-aliveとして動作します。
イベントサービスと連携するプログラム（JP1/AJS，JP1/IM，JP1/Power Monitorなど）が接続しようとするイベントサービスのIPアドレスが，物理ホスト名（hostnameコマンドで返されるホスト名）でOSから解決されるIPアドレスと同じである場合。

アドレス

使用する接続先IPアドレスを次に示すどちらかの形式で指定します。対象とするイベントサーバの，イベントサーバ設定ファイル（conf）に記述されたportsパラメーターの指定と一致させてください。省略すると，ホスト名としてイベントサーバ名を仮定します。

IPアドレス
ピリオドで区切った10進数（例: 172.16.50.50）で指定します。

ホスト名
システムのhostsファイル，ネームサーバなどでIPアドレスに変換できる255バイト以内の名称を指定します。

0.0.0.0
アプリケーションプログラムから，イベントの発行・取得が一切できなくなります（JP1のプログラムを含みますが，バージョン5以前の製品であるJP1/SES，JP1/AJSの関数やコマンドを使用した場合を除きます）。
JP1/AJSなど，多くのプログラムは，特に設定がなくてもイベントを発行しますが，イベントサービスが不要な場合は，「0.0.0.0」を指定すると，イベントの発行処理のオーバーヘッドを削減し，処理性能を向上できます。

ポート指定

使用するポート番号を次に示すどちらかの形式で指定します。対象とするイベントサーバの，イベントサーバ設定ファイル（conf）に記述されたportsパラメーターの指定と一致させてください。指定を省略すると，サービス名として jp1imevtapi を仮定します。

ポート番号
ポート番号を，10進数で指定します。

サービス名
システムのservicesファイルで定義されているtcpのサービス名を指定します。

client　イベントサーバ名　接続元アドレス

イベントサーバに接続する際に使用する接続元アドレスを指定します。初期設定ではclientパラメーターの設定は省略されています。省略時には，接続元アドレスはOSが自動的に割り当てる設定になっています。複数のNICを割り当てている環境で，使用する接続元アドレスを明示的に指定する必要がある場合にこのパラメーターを定義します。このパラメーターは複数指定できます。

イベントサーバ名

接続先イベントサーバ名を，次に示すどちらかの形式で指定します。

イベントサーバ名
個別のイベントサーバ名を，255バイト以内で指定します。

*
個別に指定しなかったイベントサーバに対する値を指定します。
この指定がない場合，接続元アドレスは0.0.0.0になります。

接続元アドレス

使用する接続元アドレスを次に示すどちらかの形式で指定します。

IPアドレス
ピリオドで区切った10進数（例: 172.16.50.50）で指定します。ここに指定するIPアドレスは自ホストに割り当てられているものでなければなりません。

0.0.0.0
使用する接続元IPアドレスをOSが自動的に割り当てます。

log-keep　ログファイルの個数

ログファイルの個数

イベントサービスAPI用ログファイル（IMEvapi.*）の保存ファイル数を指定します。log-sizeで指定した容量を超えると切り替わり，ファイル数が最大になると，最も古いファイルを削除します。値は，0～50の10進数で指定します。省略すると，5を仮定します。0を指定するとログを保存しません。

log-size　ファイルサイズ

ファイルサイズ

イベントサービスAPI用ログファイル（IMEvapi.*）の最大容量（バイト数）を指定します。値は，65,536～2,147,483,647までの10進数で指定します。省略すると，1,000,000バイトを仮定します。ログ情報は，APIのロード時，およびエラーが発生した場合だけ出力されます。

ログファイルトラップ動作定義ファイル

形式

retry-times=リトライ回数（イベントサービスへの接続用）
retry-interval=リトライ間隔（イベントサービスへの接続用）
open-retry-times=リトライ回数（ログファイルのオープン用）
open-retry-interval=リトライ間隔（ログファイルのオープン用）
read-retry-times=リトライ継続回数のしきい値（ログファイルの読み込み用）
hold-count=JP1イベントの保留件数
keep-event={ OLD | NEW }
FILETYPE={ SEQ | SEQ2 | WRAP1 | WRAP2 | HTRACE }
RECTYPE=｛VAR｛’￥n’｜’1行の終了文字’|’1行の終了記号’｝｜FIX　レコード長｝
HEADLINE=ヘッダーの行数
HEADSIZE=ヘッダーのサイズ
MARKSTR=[!]"正規表現"
[!]"正規表現n"※
ACTDEF=[{EXIT}][<重大度>]イベントID [!]"正規表現"
[!]"正規表現n"※

注※　「正規表現n」は複数個の指定を表します。

ファイル名

任意

格納先ディレクトリ

任意

次に示すディレクトリにjevlog.confの名称のログファイルトラップ動作定義ファイルを作成した場合は，jevlogstartコマンドの-fオプションの指定を省略できます。

Windowsの場合

インストール先フォルダ¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/

任意のディレクトリに任意のファイル名でログファイルトラップ動作定義ファイルを作成した場合は，jevlogstartコマンドの-fオプションにディレクトリ名を補ったファイル名を指定する必要があります。

説明

監視するログファイルの形式や，監視失敗時のリトライなどを設定しておくファイルです。ログファイルトラップ動作定義ファイルは初期設定では提供されません。ユーザーが作成する場合と，定義配布機能によって作成される場合があります。

定義の反映時期

jevlogstartコマンドまたはjevlogreloadコマンドを実行すると，設定が有効になります。jevlogstartコマンドおよびjevlogreloadコマンドの詳細については，「13.　コマンド」の「jevlogstart」，「jevlogreload」を参照してください。

記述内容

ログファイルトラップ動作定義ファイルには，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

1カラム目から入力します。

パラメーターと値は「=」でつなぎます。パラメーターと「=」との間には空白を入れてもかまいませんが，「=」と値の間には空白を入れないでください。また，一つのパラメーターに対して複数の値を指定する場合，値と値の間には空白を入れます。空白とは，一つ以上の半角スペース，またはタブのことです。次に例を示します。
（例）FILETYPE△△=SEQ
（例）ACTDEF=0△message
（凡例）△：1個の空白

値の後ろ（値が複数ある場合は最後の値）と改行の間にはコメントを記入することはできません。空白以外は入れないでください。

retry-times=リトライ回数（イベントサービスへの接続用）

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの回数を指定します。値は，0～86,400（回）の10進数で指定します。このパラメーターを省略すると，リトライは行われません。

なお，リトライ回数とリトライ間隔の指定に関係なく，リトライを開始してから86,400秒（24時間）経過するとエラーとなります。

retry-interval=リトライ間隔（イベントサービスへの接続用）

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの間隔を指定します。リトライ回数を1以上に設定した場合に有効となります。リトライ間隔は，イベントサービスへの接続に失敗してから次にイベントサービスへの接続を試みるまでの間隔です。イベントサービスへの接続処理に掛かる時間は含みません。値は，1～600（秒）の10進数で指定します。このパラメーターを省略すると，10秒が仮定されます。

なお，リトライ回数とリトライ間隔の指定に関係なく，リトライを開始してから86,400秒（24時間）経過するとエラーとなります。

open-retry-times=リトライ回数（ログファイルのオープン用）

ログファイルトラップの開始時に，一時的にログファイルをオープンできなかった場合に行うリトライの回数を指定します。値は，1～3,600（回）の10進数で指定します。このパラメーターを省略すると，1回が仮定されます。

なお，リトライ回数とリトライ間隔の指定に関係なく，リトライを開始してから3,600秒（1時間）経過するとエラーとなります。

open-retry-interval=リトライ間隔（ログファイルのオープン用）

ログファイルトラップの開始時に，一時的にログファイルをオープンできなかった場合に行うリトライ間隔を指定します。リトライ間隔は，ログファイルのオープンに失敗してから，次にログファイルのオープンを試みるまでの間隔です。値は，1～600（秒）の10進数で指定します。このパラメーターを省略すると，1秒が仮定されます。

なお，リトライ回数とリトライ間隔の指定に関係なく，リトライを開始してから3,600秒（1時間）経過すると，エラーとなります。

read-retry-times=リトライの継続回数のしきい値（ログファイルの読み込み用）

一時的にログファイルの読み込みに失敗した場合に行うリトライの，継続回数のしきい値を指定します。リトライの継続回数のしきい値とは，10ミリ秒間隔で5回行うリトライを1セットとしてカウントした回数です。10ミリ秒間隔で5回行うリトライが，このパラメーターに指定した回数を超えると，エラーとなります。値は，1～1,000（回）の10進数で指定します。このパラメーターを省略すると，100回が仮定されます。

hold-count=JP1イベントの保留件数

リトライ処理中に保留できるJP1イベントの件数を指定します。値は，1～1,000（件）の10進数で指定します。このパラメーターを省略すると，100件が仮定されます。

リトライ処理をする場合，リトライ処理中に変換されたJP1イベントを保留するためのリソースが必要となります。リトライ処理をする場合に必要なメモリー所要量を次に示します。

JP1イベントの保留件数 × 1キロバイト

keep-event={ OLD | NEW }

リトライ処理中に保留されたJP1イベントが保留件数を超過した場合，超過したJP1イベントは消去されます。超過した場合に，古いJP1イベントと新しいJP1イベントのどちらを残すかを指定します。このパラメーターを省略すると，OLDが仮定されます。

OLD

古いJP1イベントを残したい場合に指定します。この場合，hold-countパラメーターに指定したJP1イベントの保留件数までJP1イベントを保留し，以降に発生したJP1イベントは保留されずに消去されます。

NEW

新しいJP1イベントを残したい場合に指定します。この場合，JP1イベントの保留件数を超過すると，古いJP1イベントから消去されます。

FILETYPE={ SEQ | SEQ2 | WRAP1 | WRAP2 | HTRACE }

読み込むログファイルのデータ出力形式を指定します。このパラメーターを省略すると，SEQが仮定されます。

SEQ

シーケンシャルファイル（一つのログファイルに追加書き込みし続けるファイル，またはログファイルが一定の容量に達すると，別のファイル名で新たにログファイルを作成して書き込むファイル）の場合に指定します。

SEQ2

次のようなファイルの場合に指定します。

Windowsの場合
同一ボリューム内でファイル名を変更したあと，変更前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

UNIXの場合
ファイル名を変更，またはファイルをいったん削除したあと，変更／削除前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

注意事項

SEQ2で監視する場合，監視間隔の間にログファイルが1回切り替わると，切り替わる前のファイル内から前回読み込んだデータ以降に蓄積されたデータを読み込んだあと，新たなファイル内のデータを読み込みます。そのため，監視間隔の間に2回以上切り替わると，切り替わる直前のファイルからのデータしか読み込めません。ログファイルが切り替わる頻度を考慮してjevlogstartコマンドの-tオプション（監視間隔）を設定してください。

WRAP1

ラップアラウンドファイル（ラップアラウンドして，再び先頭からデータを上書きするファイル）の場合に指定します。

WRAP1の場合，読み込むログファイルのコピーを作成して，そのコピーと現在のログファイルを比較して読み込み位置を決定するため，監視するファイルの容量と同じサイズのディスク容量が必要です。

注意事項

WRAP1で大容量のファイルを監視する場合，書き込んでいるデータ位置がファイルの最後の方にあると，最初のJP1イベントが発生するまでに時間が掛かります。

WRAP2

ラップアラウンドファイル（ラップアラウンドするとき，データを削除して再び先頭からデータを書き込むファイル）の場合に指定します。

統合トレースログを監視する場合はWRAP2を適用してください。

ファイルを削除または名称を変更して作成し直す運用の場合は，SEQ2を指定してください。

注意事項

WRAP2の場合，データをすべて読み込む前にラップアラウンドしてデータが削除されると，読み込めないデータが発生します。監視間隔を長くすると，一度に読み込むデータの量が多くなるため，jevlogstartコマンドの-tオプション（監視間隔）の指定に注意してください。

JP1/Baseは，ラップアラウンドしたことを，ファイルのサイズが小さくなったことで検知しています。ラップアラウンド前とラップアラウンド後のファイルのサイズが同じである場合やラップアラウンド後のファイルのサイズが大きい場合，ラップアラウンドしたと判断しないため注意が必要です。

HTRACE

マルチプロセス対応トレースファイル（複数のプロセスが一組のトレースファイルを共有し，メモリマップドファイルを使用した固定サイズのファイル）の場合に指定します。

ログファイルへの書き込み方法はWRAP1と同様で，ログファイルが一定の容量に達するとラップアラウンドして，再び先頭からデータを上書きします。

RECTYPE={ VAR { ’¥n’| ’1行の終了文字’ | ’1行の終了記号’} | FIX レコード長 }

読み込むログファイルのレコード形式を指定します。このパラメーターを省略すると，RECTYPE=VAR ’¥n’が仮定されます。つまり，可変長で「¥n」が1行の区切りというレコード形式の指定になります。

VAR

可変長のレコード形式の場合に，1行の終了文字，または1行の終了記号を指定します。C言語でのキャラクター1文字の指定と同じように「’’」で囲み，エスケープシーケンスでも指定できます。

FIX

固定長のレコード形式の場合に，レコード長を1行の区切りとして指定します。レコード長は，1～9,999,999（バイト）の10進数で指定します。

HEADLINE=ヘッダーの行数

読み込むログファイルの先頭にヘッダーがある場合，ヘッダーの行数を，0～99,999（行）の10進数で指定します。このパラメーターを省略すると，0行が仮定されます。

HEADSIZE=ヘッダーのサイズ

読み込むログファイルの先頭にヘッダーがあり，かつそのヘッダーが行数で指定できない場合，ヘッダーのサイズを，0～9,999,999（バイト）の10進数で指定します。行数で指定できないヘッダーとは，バイナリーデータや，レコード形式がログデータと異なっているヘッダーなどです。HEADLINEパラメーターを指定しているときには，このパラメーターは無効になります。このパラメーターを省略すると，0バイトが仮定されます。

MARKSTR=[!]"正規表現"

ログデータ以外のデータなど，監視の対象外にしたいデータを正規表現で指定します。正規表現は「"　"」で囲んでください。ログデータ以外のデータとは，一定間隔でログファイル中に出力されるデータなどです。ログデータ以外のデータの例を次に示します。

（例）"==== 13:00:00 JP1/Base Event ===="

「!」を「"　"」の前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを監視の対象外とします。

一つのMARKSTRパラメーターには，複数の正規表現を指定できます。複数の正規表現を指定した場合，AND条件となり，「!」の指定も含むすべての正規表現の条件に一致するデータだけを監視対象外とします。なお，複数の正規表現を指定する場合は，正規表現の間を改行で区切ってください。2行目からは値だけを指定します。この場合，2行目以降の値の前に一つ以上の空白を入れてください。次に，「====」および「MARK」を含むデータを監視の対象外に指定する場合の例を示します。

（例）MARKSTR="===="（改行）
     △△△△△"MARK"
   （凡例）△：空白

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべて監視対象外とします。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭からjevlogstartコマンドの-mオプションで指定した長さまでの間だけです。このパラメーターを省略すると，ログデータ以外のデータはないと仮定されます。

ACTDEF=[{EXIT}][<重大度>]イベントID [!]"正規表現"

JP1イベントに変換するログデータの正規表現と，対応するJP1イベントのイベントIDおよび重大度を指定します。正規表現に一致するログがあると，指定したイベントIDでJP1イベントを発行します。なお，「=」，「{EXIT}」，「<重大度>」，および「イベントID」の間にはスペースまたはタブを入れないでください。入れた場合は文法エラーになります。

{EXIT}

複数のACTDEFパラメーターを指定した場合に，「{EXIT}」を指定した条件に一致した時点で，そのログデータの監視を終了します。

複数のACTDEFパラメーターを指定した場合，一つのログデータが複数のACTDEFパラメーターの条件に一致すると，一致した数だけJP1イベントが発行されます。「{EXIT}」を指定しておくと，「{EXIT}」を指定した条件のイベントIDでJP1イベントが発行され，以降の監視は行われません。

「{EXIT}」を指定した場合，および指定しない場合の処理の違いを次の図に示します。

図14-5　ログファイルトラップ動作定義ファイル指定例

<重大度>

JP1イベントの拡張属性の重大度を「<　>」で囲んで指定します。重大度とイベントIDは，対にして指定します。指定できる値を次に示します。

Emergency

Alert

Critical

Error

Warning

Notice

Information

Debug

指定を省略した場合はNoticeが仮定されます。

イベントID

イベントサーバにJP1イベントを登録する際のイベントIDを指定します。イベントIDは上位4バイト（基本コード）と下位4バイト（拡張コード）をコロン「:」で区切り，16進数で記述します。A～Fは大文字で記述してください。なお，下位4バイトまたはコロン以下の下位4バイトは省略できます。この場合，省略値には0を仮定します。また，上位下位とも8桁に満たない場合は前から補われます。ユーザーが指定できる範囲の値，0:0～1FFF:0および7FFF8000:0～7FFFFFFF:0を指定してください。なお，拡張コードには0を指定してください。イベントIDの表記例を次に示します。

(例)次に示す3通りの表記は同じ意味になります。

0000011A:00000000
11A:0
11A

"正規表現"

JP1イベントに変換するログデータを正規表現で指定します。正規表現は「"　"」で囲んでください。「!」を一つ目の「"　"」の手前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを変換対象とします。

一つのACTDEFパラメーターには，複数の正規表現を指定できます。複数の正規表現を指定した場合，AND条件となり，「!」の指定も含むすべての正規表現の条件に一致するデータだけをJP1イベントに変換します。なお，複数の正規表現を指定する場合は，正規表現の間を改行で区切ってください。2行目からは正規表現だけを指定します。この場合，2行目以降の値の前に一つ以上の空白を入れてください。次に，「jp1base」および「error」を含むデータを，イベントID「00000333」でJP1イベントに変換する場合の指定例を示します。

（例）ACTDRF=00000333  "jp1base"（改行）
     △△△△△"error"
   （凡例）△：空白

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべてJP1イベントに変換します。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭からjevlogstartコマンドの-mオプションで指定した長さまでの間だけです。

このパラメーターは省略できません。

注意事項

MARKSTR，およびACTDEFパラメーターで指定できる正規表現は，OSによって異なります。また，Linuxの場合，MARKSTR，およびACTDEFパラメーターで指定する正規表現に日本語を指定できません。.（ピリオド）2個が日本語文字1個にマッチするなどの動作になります。正規表現の文法の詳細については，「付録F　正規表現の文法」を参照してください。

次の誤りがある場合は，jevlogstartコマンド実行時にKAVA3646-Eのメッセージが標準エラー出力に出力され，ログファイルトラップの起動に失敗します。

ログファイルがマルチプロセス対応トレースであるが，ログファイルトラップ動作定義ファイルのファイル形式にHTRACEが指定されていない

ログファイルがマルチプロセス対応トレース以外であるが，ログファイルトラップ動作定義ファイルのファイル形式にHTRACEが指定されている

なお，jevlogstartコマンドに-rオプションを指定して実行した場合は，ログファイルトラップは，監視対象のログファイルが作成されるまで待機します。ファイル形式の指定に上記の誤りがある場合は，ログファイルが作成されたあとにKAVA3646-Eのメッセージがsyslog，イベントログ，および統合トレースログに出力され，ログファイルトラップが停止します。
このエラーメッセージが出力された場合は，ログファイルトラップ動作定義ファイルのファイル形式を指定し直してからjevlogstartコマンドを再度実行してください。
このほかのケースでファイル形式の指定を誤った場合は，ログファイルトラップの起動後，ログファイルが一定量に達して切り替わったときに，エラーメッセージおよびJP1イベント（00003A22）で通知します。JP1イベントの詳細については，「15.3(6)　イベントID：00003A22の詳細」を参照してください。
JP1イベント（00003A22）が通知された場合は，エラーメッセージで示されるログファイルの状態を確認し，ログファイルトラップ動作定義ファイルのデータ出力形式（FILETYPE）を正しく定義してください。
また，形式を誤った状態のままで運用を継続しても正しく監視されません。データ出力形式を正しく定義したあと，ログファイルトラップを再起動してください。
JP1イベント（00003A22）が通知されるケースを，ログファイルの形式ごとに示します。

表14-10　ファイル形式ごとのJP1イベントが通知されるケース

ログファイルトラップ動作定義ファイルに指定したファイル形式
異常となるケース

SEQ

ログファイルが削除された場合

ログファイルのサイズが小さくなった場合

ログファイルが削除されたあと，同じ名称で再作成された場合※

SEQ2

リネームして再作成される前に，ログファイルのサイズが小さくなった場合

WRAP1

ログファイルが削除された場合

ログファイルのサイズが小さくなった場合

ログファイルが削除されたあと，同じ名称で再作成された場合※

WRAP2

ログファイルが削除された場合

ログファイルが削除されたあと，同じ名称で再作成された場合※

HTRACE

ログファイルが削除された場合

ログファイルが削除されたあと，同じ名称で再作成された場合

注※　ログファイルの形式がSEQ2の可能性があるため，ログファイルトラップ動作定義ファイルに指定したファイル形式を見直してください。

定義例

MARKSTRパラメーターおよびACTDEFパラメーターの定義例
次に示すログデータを基に，MARKSTRパラメーターおよびACTDEFパラメーター部分の定義例を説明します。

定義例1
ログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

定義例2
定義例1とは異なるログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

定義例3
ログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

ログファイルトラップ起動定義ファイル

形式

START_OPT=[<起動LANG>]監視名:jevlogstartコマンドオプション
　　：
START_OPT_CLS=[(クラスタID)][<起動LANG>]監視名:jevlogstartコマンドオプション
　　：

ファイル名

jevlog_start.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥event¥

UNIXの場合

/etc/opt/jp1base/conf/event/

説明

次に示すときに起動または終了するログファイルトラップを設定するファイルです。

ログファイルトラップ管理サービス（デーモン）が起動したとき

jevlogstart（クラスタ運用限定）コマンドが実行されたとき

jevlogstop（クラスタ運用限定）コマンドが実行されたとき

ログファイルトラップ起動定義ファイルは初期設定では提供されません。ユーザーが作成する場合と，IM構成管理による定義情報（プロファイル）として作成される場合があります。

ログファイルトラップ起動定義ファイルを使用してログファイルトラップを起動した場合，ログファイルトラップ起動実行結果ログに起動開始情報（KAVA3661-I）および起動結果情報（KAVA3662-I）が出力されます。また，パラメーターの指定に誤りがあった場合，警告メッセージが出力されて無効な指定となります。

ログファイルトラップ起動実行結果ログの出力先は，次のとおりです。

Windowsの場合

インストール先フォルダ¥log¥jevlog_start¥jevlog_start{1|2|3}.log

UNIXの場合

/var/opt/jp1base/log/jevlog_start/jevlog_start{1|2|3}.log

定義の反映時期

次に示すときに設定が有効になります。

ログファイルトラップ管理サービス（デーモン）が起動したとき

jevlogstart（クラスタ運用限定）コマンドが実行されたとき

なお，jevlogstop（クラスタ運用限定）コマンドが実行されたときは，直前のjevlogstart（クラスタ運用限定）コマンド実行時に読み込んだログファイルトラップ起動定義ファイルの情報に基づいて，ログファイルトラップが終了されます。

記述内容

ログファイルトラップ起動定義ファイル（jevlog_start.conf）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

1行に1パラメーターを定義します。

1カラム目から入力します。

パラメーターと値は「=」でつなぎます。パラメーターと「=」との間には空白を入れてもかまいませんが，「=」と値の間には空白を入れないでください。

値の後ろ（値が複数ある場合は最後の値）と改行の間にはコメントを記入することはできません。空白以外は入れないでください。

START_OPT=[<起動LANG>]監視名:jevlogstartコマンドオプション

ログファイルトラップ管理サービス（デーモン）起動時に起動するログファイルトラップおよび起動オプションを指定します。

このパラメーターは，START_OPT_CLSパラメーターと合わせて200件まで指定できます。START_OPTパラメーターとSTART_OPT_CLSパラメーターの指定の合計が200件を超える場合，201件目以降の指定は無効となります。

なお，このパラメーターで指定したログファイルトラップは，jevlogstart（クラスタ運用限定）コマンドおよびjevlogstop（クラスタ運用限定）コマンド実行時には，起動または終了対象になりません。

START_OPT_CLS=[(クラスタID)][<起動LANG>]監視名:jevlogstartコマンドオプション

jevlogstart（クラスタ運用限定）コマンド実行時に起動し，jevlogstop（クラスタ運用限定）コマンド実行時に終了するログファイルトラップおよび起動オプションを指定します。このパラメーターは，クラスタ運用で共有ディスク上のログファイルを監視している場合に，フェールオーバー時にログファイルトラップをまとめて起動・終了するときに指定します。

このパラメーターは，START_OPTパラメーターと合わせて200件まで指定できます。START_OPTパラメーターとSTART_OPT_CLSパラメーターの指定の合計が200件を超える場合，201件目以降の指定は無効となります。

なお，このパラメーターで指定したログファイルトラップは，ログファイルトラップ管理サービス（デーモン）起動時には，起動対象になりません。

<起動LANG>

UNIXの場合，jevlogstartコマンド実行時の環境変数LANGの値を「< >」内に指定します。指定できるLANGの値については，「2.3.5(2)　言語種別の設定」の「表2-3　環境変数LANGに指定できる値」を参照してください。

省略した場合は，ログファイルトラップ管理デーモン起動時の環境変数LANGと同じ文字コードが仮定されます。

なお，この指定は，Windowsの場合は無効となります。指定した場合は，無視されます。

監視名

ログファイルトラップの監視名を指定します。コロン「:」の前までが監視名と見なされます。

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

なお，監視名は重複しないように指定してください。

jevlogstartコマンドオプション

jevlogstartコマンドのオプションを指定します。ログファイルトラップ管理サービス（デーモン）起動時またはjevlogstart（クラスタ運用限定）コマンド実行時には，この指定と監視名の指定を基にjevlogstartコマンドが生成され，ログファイルトラップが起動されます。

指定できるオプションについては，「13.　コマンド」の「jevlogstart」を参照してください。ただし，起動するログファイルトラップの監視名は，START_OPTパラメーターまたはSTART_OPT_CLSパラメーターの監視名に指定した値となります。このため，-aオプションを指定した場合は，無視されます。

また，jevlogstart（クラスタ運用限定）コマンドのオプション（-cluster）を指定した場合はパラメーター不正となり，定義が無効になります。

jevlogstartコマンド実行時のカレントディレクトリを次に示します。

Windowsの場合

インストール先フォルダ¥COMMAND

UNIXの場合

/opt/jp1base/command

コマンドオプションでファイルパスの相対パス指定をする場合は，これらのパスを基準に指定してください。

(クラスタID)

クラスタIDを「()」内に指定します。クラスタIDとは，クラスタシステムを識別するためのID番号です。複数のクラスタシステムを運用している場合に，0～99の範囲でユーザーが任意に指定します。

値は0～99の10進数で指定します。省略した場合は，0が仮定されます。

複数のクラスタシステムを運用している場合の定義方法

複数のクラスタシステムを運用している場合は，論理ホストに対応するクラスタIDを決定し，各論理ホストのフェールオーバー時に起動・終了するログファイルトラップを定義します。

複数のクラスタシステムを運用している場合の構成例を次に示します。

図14-6　複数のクラスタシステムを運用している場合の構成例

この構成例の場合，論理ホスト1のクラスタIDは「0」です。また，論理ホスト1が出力するログを監視するログファイルトラップは「ログファイルトラップA」および「ログファイルトラップB」です。したがって，ログファイルトラップ起動定義ファイルには，クラスタID「0」のログファイルトラップとして，「ログファイルトラップA」および「ログファイルトラップB」の起動オプションを定義します。

同様に，論理ホスト2については，クラスタID「1」のログファイルトラップとして，「ログファイルトラップC」および「ログファイルトラップD」の起動オプションを定義します。

なお，クラスタソフトには，論理ホスト1，論理ホスト2のフェールオーバー時にそれぞれ次のコマンドを実行するように登録しておきます。

論理ホスト1のフェールオーバー時

jevlogstart -cluster 0

jevlogstop -cluster 0

論理ホスト2のフェールオーバー時

jevlogstart -cluster 1

jevlogstop -cluster 1

このように登録することで，論理ホスト1のフェールオーバー時には「ログファイルトラップA」および「ログファイルトラップB」だけが，論理ホスト2のフェールオーバー時には「ログファイルトラップC」および「ログファイルトラップD」だけが，起動・終了の対象となります。

クラスタソフトに登録するコマンドの詳細については，「13.　コマンド」の「jevlogstart（クラスタ運用限定）」および「jevlogstop（クラスタ運用限定）」を参照してください。

定義例

ログファイルトラップ起動定義ファイル（jevlog_start.conf）の定義例を次に示します。

#サービス(デーモン)起動時に，起動させるログファイルトラップを指定
START_OPT=<ja_JP.eucJP>KANSI1:-f /etc/～/jevlog.conf /fil/aaa.log
   ：
#「jevlogstart -cluster [クラスタID]」要求時に，起動対象となるログファイルトラップを指定
#「jevlogstop -cluster [クラスタID]」要求時には，停止対象となる
START_OPT_CLS=(1)<ja_JP.eucJP>KANSI2:-f /etc/～/jevlog.conf /share/aaa.log
   ：

ログ情報定義ファイル

形式

log-keep ログファイルの個数
log-size ファイルサイズ

ファイル名

jevlogd.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥event¥

UNIXの場合

/etc/opt/jp1base/conf/event/

ログ出力先ディレクトリ

Windowsの場合

インストール先フォルダ¥sys¥tmp¥event¥logtrap¥jevtraplog¥jevtraplog.{000|001|002|003|004}※

UNIXの場合

/var/opt/jp1base/sys/tmp/event/logtrap/jevtraplog/jevtraplog.{000|001|002|003|004}※

注※　これらのログファイル数は，log-keepパラメーターで変更できます。

説明

ログファイルトラップ用ログのファイル数およびファイル容量を設定しておくファイルです。ログ情報定義ファイル（jevlogd.conf）は初期設定では提供されません。ファイルが存在しない場合は，初期設定のログファイル数，およびファイル容量が設定されます。必要に応じてログ情報定義ファイル（jevlogd.conf）を作成し，設定を変更してください。

定義の反映時期

ログファイルトラップ管理サービス（デーモン）を起動すると，設定が有効になります。

記述内容

ログ情報定義ファイル（jevlogd.conf）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

パラメーターと値の間は一つ以上の半角スペースまたはタブで区切ります。

1行に1パラメーターを定義します。

各行の先頭パラメーター名の前に，スペースやタブなどは入れられません。

値の後ろと改行の間にはコメントを記入することはできません。

定義内容に誤りがあった場合は，初期設定の値が設定されます。

英字の大文字小文字は区別されます。

log-keep ログファイルの個数

ログファイルトラップ用ログファイル（jevtraplog.*）の保存ファイル数を指定します。log-sizeで指定した容量を超えると切り替わり，ファイル数が最大になると，最も古いファイルを削除します。ログファイルの個数は，0～50（個）の10進数を指定します。このパラメーターを省略した場合は，初期設定値の5（個）が仮定されます。0を指定するとログを保存しません。

log-size ファイルサイズ

ログファイルトラップ用ログファイル（jevtraplog.*）の最大容量を指定します。ファイルサイズは，65,536～2,147,483,647（バイト）の10進数を指定します。このパラメーターを省略した場合は，初期設定値の1,000,000（バイト）が仮定されます。

ログ情報は，ログファイルトラップ管理デーモンまたはサービスの起動時およびエラーが発生した場合に出力されます。

定義例

ログ情報定義ファイル（jevlogd.conf）の定義例を次に示します。

log-keep 5
log-size 65536

イベントログトラップ動作定義ファイル（Windows限定）

形式

server イベントサーバ名
retry-times リトライ回数
retry-interval リトライ間隔
trap-interval 監視間隔※1
matching-level [0 | 1]
filter-check-level [0 | 1]
jp1event-send [0 | 1]※1
ext-attr-option 拡張属性名※2
# フィルター
filter　ログの種別
　　条件文1
　　条件文2
　　　：
　　条件文n
end-filter

注※1　Windows VistaおよびWindows Server 2008の場合は無効なパラメーターです。

注※2　Windows VistaおよびWindows Server 2008の場合だけ指定できます。

ファイル名

ntevent.conf

格納先ディレクトリ

インストール先フォルダ¥conf¥event¥

説明

JP1イベントに変換するイベントログの条件や，イベントログの監視間隔などを設定しておくファイルです。

定義の反映時期

イベントログトラップサービスを起動するか，またはjeveltreloadコマンドを実行してイベントログトラップ動作定義ファイルをリロードすると，設定が有効になります。jeveltreloadコマンドの詳細については，「13.　コマンド」の「jeveltreload（Windows限定）」を参照してください。

記述内容

イベントログトラップ動作定義ファイル（ntevent.conf）は，登録先イベントサーバ名，リトライ設定，および一つ以上のフィルターで構成されます。行頭に「#」を指定すると，改行するまでコメントになります。

server イベントサーバ名

イベントログをJP1イベントに変換して登録するときの登録先イベントサーバ名を255バイト以内で指定します。イベントサーバ名はダブルクォーテーションマーク（"）で囲みます。指定できるイベントサーバは自ホストで稼働しているイベントサーバに限ります。イベントサーバ名を省略した場合，自ホスト名が仮定されます。

retry-times リトライ回数

一時的な通信障害で，イベントサービスへの接続に失敗した場合のリトライ回数を指定します。値は，0～86,400（回）の10進数で指定します。このパラメーターを省略すると，リトライ処理は行われません。

retry-interval リトライ間隔

一時的な通信障害で，イベントサービスへの接続に失敗した場合のリトライ間隔を指定します。リトライ回数を1以上に設定した場合に有効となります。リトライ間隔は，イベントサービスへの接続に失敗してから次にイベントサービスへの接続を試みるまでの間隔です。イベントサービスへの接続処理に掛かる時間は含みません。値は，1～600（秒）の10進数で指定します。このパラメーターを省略すると，10秒が仮定されます。

trap-interval 監視間隔

イベントログを監視する間隔を指定します。イベントログトラップは，リアルタイムでイベントログを監視する一方で，一定の間隔でイベントログを監視します。値は，1～180（秒）の10進数で指定します。このパラメーターを省略すると，10秒が仮定されます。

なお，このパラメーターは，Windows VistaおよびWindows Server 2008の場合は無効となります。指定した場合は，無視されます。

matching-level [0 | 1]

フィルターにmessage属性またはcategory属性を指定した場合で，メッセージDLLまたはカテゴリーDLLが正しく設定されてないなどの理由で，イベントログの説明文の読み込みに失敗したときの，イベントログと定義内容の比較レベルを指定します。0を指定すると，比較しないで次のフィルターと比較をします。1を指定すると，比較をします。このパラメーターを省略すると，0が仮定されます。

filter-check-level [0 | 1]

フィルターに不正な（システムに存在しない）ログの種別や不正な正規表現指定がある場合のチェックレベルを指定します。0を指定すると，フィルターに不正なログの種別や不正な正規表現がある場合，該当するフィルターを無効にします。ただし，有効なフィルターが一つでもある場合，サービスの起動またはリロードは成功します。有効なフィルターが一つもない場合，サービスの起動またはリロードは失敗します。1を指定すると，フィルターに不正なログの種別や不正な正規表現が一つでもある場合，サービスの起動またはリロードは失敗します。このパラメーターを省略すると0が仮定されます。

jp1event-send [0 | 1]

イベントログの監視中にイベントログの取得に失敗した場合，JP1イベントを出力するかどうかを指定します。0を指定すると，イベントログの取得に失敗してもJP1イベントを出力しません。1を指定すると，イベントログの取得に失敗した場合，JP1イベント（00003A73）を出力します。イベントログの取得に失敗したというJP1イベントが出力されたあと，再び監視ができる場合があります。この場合もJP1イベント（00003A74）を出力します。このパラメーターを省略すると0が仮定されます。

なお，このパラメーターの指定に関係なく，統合トレースログにメッセージが出力されます。JP1イベントの詳細については，「15.3　JP1イベントの詳細」を参照してください。

なお，このパラメーターは，Windows VistaおよびWindows Server 2008の場合は無効となります。指定した場合は，無視されます。

ext-attr-option 拡張属性名

拡張属性A0～A6，PLATFORM，PPNAME以外の拡張属性を追加で作成したいときに指定します。このパラメーターは，Windows VistaおよびWindows Server 2008の場合だけ指定できます。

複数の拡張属性を追加で作成するときは，拡張属性名を半角スペースで区切って指定します。拡張属性名の指定順序は任意です。

指定できる拡張属性名を次に示します。

拡張属性名 | 意味
A7 | Windowsログレベル
A8 | Windowsログキーワード
A9 | Windowsログオペコード
OS_VERSION | Windowsバージョン番号

このパラメーターを省略すると，JP1イベント変換時に上記の拡張属性は作成されません。

上記四つの拡張属性を作成する場合の記述例を次に示します。

ext-attr-option A7 A8 A9 OS_VERSION

フィルターの文法

フィルターは，JP1イベントに変換するイベントログの条件を指定した「条件文」の集まりです。フィルター内の条件文はAND条件，フィルター間はOR条件です。複数のフィルターを指定した場合は，フィルターのどれかが成立する条件で成立します。フィルターは必ず一つ以上指定してください。フィルターの記述形式を次の図に示します。

図14-7　フィルターの記述形式（イベントログトラップ動作定義ファイル）

ログの種別

監視対象となるログの種別を指定します。ログの種別とは，Windowsの［イベント ビューア］に表示される各ログの名前のことです。ログの種別は「"　"」（ダブルクォーテーションマーク）で囲みます。

指定できるログの種別

Windows VistaおよびWindows Server 2008の場合

Windowsのログ※1
"アプリケーション"または"Application"
"セキュリティ"または"Security"
"システム"または"System"
"セットアップ"または"Setup"

アプリケーションとサービスのログ
"DNS Server"
"Directory Service"
"ファイル レプリケーション サービス"または"File Replication Service"
"DFS Replication"※2
"Internet Explorer"
"Key Management Service"
"ハードウェア イベント"または"HardwareEvents"　　ほか※3

Windows VistaおよびWindows Server 2008以外の場合

"アプリケーション"または"Application"

"セキュリティ"または"Security"

"システム"または"System"

"DNS Server"

"Directory Service"

"ファイル レプリケーション サービス"または"File Replication Service"

"DFS レプリケーション"または"DFS Replication"※4

注※1

Windowsログの「転送されたイベント」を指定することはできません。

リモートマシンで発生したイベントログは，発生元マシン上のイベントログトラップで監視対象としてください。

注※2

Windows VistaおよびWindows Server 2008の場合，日本語文字は指定できません。

注※3

フィルターに指定できる「ログの種別」は次の手順で確認してください。条件に当てはまらない場合は，無効な「ログの種別」となります。

MS-DOSプロンプト上でwevtutilコマンドを実行し，システムに登録されている「ログの種別」の一覧を確認する。
コマンドの入力例を次に示します。
>wevtutil el

1.で確認した「ログの種別」の有効・無効の設定および種別を「ログの種別」ごとに確認する。
コマンドの入力例を次に示します。
>wevtutil gl Application
name: Application
enabled: true
type: Admin
:
次の条件をすべて満たす場合だけ，フィルターに指定できます。
・enabledが「true」である
・typeが「Admin」または「Operational」である

注※4

イベントビューアで表示されるログ名が日本語表示となっている場合だけ「"DFS レプリケーション"」を指定できます。

複数のフィルターに同一のログの種別を指定した場合，それらのフィルターのどれかが成立する場合にフィルターが成立します。

条件文の書式

条件文には，次の表に示す属性名と，対応するイベントビューアに表示される項目を指定します。

表14-11　条件文に指定できる属性名

属性名 | 記述する内容
type | ログの種類※5を記述します。
source※1 | イベントビューアのプロパティ※2で表示されるソースの情報を記述します。
category※3 | イベントビューアのプロパティ※2で表示される分類の情報を記述します。
id | イベントビューアのプロパティ※2で表示されるイベントIDの情報を記述します。
user | イベントビューアのプロパティ※2で表示されるユーザー名を記述します。
message※3 | イベントビューアのプロパティ※2で表示される説明の情報を記述します。
computer | イベントビューアのプロパティ※2で表示されるコンピュータ名を記述します。
level※3※4 | イベントビューアのプロパティ※2で表示されるレベル名を記述します。
keyword※3※4 | イベントビューアのプロパティ※2で表示されるキーワード名を記述します。
opcode※3※4 | イベントビューアのプロパティ※2で表示されるオペコード名を記述します。

注※1

イベントビューアのプロパティで表示されているソースの情報に合わせて記述してください。異なっている場合は，記述を変更してください。

注※2

Windows VistaおよびWindows Server 2008の場合，イベントビューアのプロパティの［全般］タブに表示されます。

注※3

Windowsのイベントログの仕組みに従って，イベントログの説明文を記載したメッセージDLLが正しく設定された状態でご利用ください。メッセージDLLが正しく設定されていないと，イベントログから説明文を読み込めないため，トラップの対象にできないことがあります。なお，メッセージDLLまたはカテゴリーDLLがないメッセージをトラップしたい場合は，matching-levelパラメーターを1に設定してください。

メッセージDLLが正しく設定されていない場合，イベントビューアに「メッセージDLLファイルがない可能性があり，説明が見つからない」という旨の文字列が出力されます。この文字列はイベントビューアが出力している文字列のため，イベントログトラップではトラップできません。

メッセージDLLが存在しない状態でJP1イベントに変換した場合，メッセージとして，イベントビューアで「メッセージDLLファイルがない可能性があり，説明が見つからない」という旨の文字列以降に出力される文字列を「"（ダブルクォーテーション）」で囲んで登録します。この文字列が複数存在する場合には，「,（コンマ）」で区切ります。また，カテゴリーDLLが存在しない状態で変換に失敗した場合には，該当する数値を「（　）」で囲み，カテゴリーとして登録します。

レベル，キーワード，オペコードの変換に失敗した場合も，カテゴリーの変換に失敗した場合と同様に，該当する数値を「（　）」で囲み，登録します。

イベントビューアに「詳細な情報は、http://go.microsoft.com/fwlink/events.aspの[ヘルプとサポート センター]を参照してください。」という内容の文字列が出力されることがあります。この文字列はイベントビューアが出力している文字列のため，イベントログトラップではトラップできません。

注※4

Windows VistaおよびWindows Server 2008の場合だけ指定できます。

注※5

Windows VistaおよびWindows Server 2008の場合，イベントビューアのプロパティ※2で表示されるレベルの内容を「表14-12　typeに指定できるログの種類と対応するJP1イベントの重大度」に従って記述します。

「成功の監査」，「失敗の監査」については，イベントビューアのプロパティ※2の「キーワード」に表示されます。

記述形式を次に示します。

type　ログの種類1 ログの種類2 ログの種類3・・・

ログの種類を指定します。複数の種類を指定した場合は，どれか一つが一致した場合に条件が成立します。変換後のJP1イベントの重大度は，ログの種類によって決まります。指定できるログの種類と，対応するJP1イベントの重大度を次の表に示します。

表14-12　typeに指定できるログの種類と対応するJP1イベントの重大度

ログの種類 | 内容 | JP1イベントの重大度
Information | 情報 | Information
Warning | 警告 | Warning
Error | エラー | Error
Critical※ | 重大 | Critical
Verbose※ | 詳細 | Information
Audit_success | 成功の監査 | Notice
Audit_failure | 失敗の監査 | Notice

注※　Windows VistaおよびWindows Server 2008の場合だけ指定できます。

上記以外のログの種類をtypeに指定することはできません。また，上記以外のログの種類のイベントが変換対象となった場合は，JP1イベントの重大度にはInformationが設定されます。

type以外の属性名

属性名　'正規表現1' '正規表現2' '正規表現3'・・・

type以外の属性名では，条件を正規表現で指定します。正規表現は「'　'」で囲んでください。「!」を「'　'」の前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを変換対象とします。正規表現の中に「'」（シングルクォーテーション）を指定する場合は，「'」の前に「¥」を追加し，「¥'」と指定してください。なお，使用できる正規表現は，OSによって異なります。正規表現の文法の詳細については，「付録F　正規表現の文法」を参照してください。

注意事項

リトライ回数とリトライ間隔の組み合わせによっては，24時間以上のリトライ処理が可能ですが，リトライ処理が24時間を超えた場合，リトライ処理は打ち切られ，イベントログトラップサービスは停止します。

Windowsのメディアセンス機能によってサービスが停止する現象を回避するためには，リトライ機能を使用してください。

filter-check-levelの指定が0（または指定なし）で，フィルターが無効となった場合，KAVA3025-Wまたは，KAVA3026-Wのメッセージがイベントログ，統合トレースログ（リロード時は標準エラー出力だけ）に出力されます。ただし，これらのメッセージは10件出力した時点で打ち切りとなります。

filter-check-levelの指定が0（または指定なし）で，有効なフィルターが存在しなかった場合，KAVA3027-E（リロード時は，KAVA3028-E）のメッセージがイベントログ，統合トレースログ（リロード時は，イベントログ，統合トレースログ，標準エラー出力）に出力されます。

Windows VistaおよびWindows Server 2008の場合だけ有効となる指定を含む動作定義ファイルを，Windows VistaおよびWindows Server 2008以外の環境に配布すると，定義不正となり配布に失敗します。

標準提供のイベントログトラップ動作定義ファイル

標準提供のイベントログトラップ動作定義ファイル（ntevent.conf）では，イベントサービスへ接続できなかった場合に10秒間隔で3回リトライを行います。また，JP1イベントに変換するログの条件として，「システムログ」の「警告」と「エラー」，および「アプリケーションログ」の「警告」と「エラー」がJP1イベントに変換されるように定義されています。標準提供の指定を次に示します。

retry-times 3
retry-interval 10

filter "System"
   type Warning Error
end-filter

filter "Application"
   type Warning Error
end-filter

なお，このイベントログトラップ動作定義ファイル（ntevent.conf）および転送設定ファイル（forward）を初期設定で使用した場合，JP1イベントの転送に失敗するとKAJP1037-Eのメッセージがイベントログに出力され，JP1イベントに変換されます。変換されたJP1イベントは再度転送され，転送の失敗が繰り返されます。

この転送の繰り返しを回避するためには，KAJP1037-Eのメッセージをトラップしないように動作定義ファイルの設定を変更してください。設定例を次に示します。

retry-times 3
retry-interval 10

filter "System"
type Warning Error
end-filter

#重要度が[Error][Warning]で，かつソースが[JP1/Base Event]
#以外のイベントログをトラップする。
filter "Application"
   type Warning Error
   source !'JP1/Base Event'
end-filter

#重要度が[Error][Warning]で，かつソースが[JP1/Base Event]
#で，かつイベントIDが[1037]以外のイベントログをトラップする。
filter "Application"
   type Warning Error
   source 'JP1/Base Event'
   id !'1037'
end-filter

フィルターの定義例

定義例1：OR条件とAND条件

OR条件の定義例

ログの種別が「システムログ」で，説明に「TEXT」，「MSG」，または「-W」のどれかを含む。

filter "System"
   message 'TEXT' 'MSG' '-W'
end-filter

条件をスペースまたはタブで区切って指定すると，OR条件になります。

AND条件の定義例

ログの種類が「システムログ」で，説明に「TEXT」，「MSG」，および「-W」をすべて含む。

filter "System"
   message 'TEXT'
   message 'MSG'
   message '-W'
end-filter

条件を改行で区切って指定すると，AND条件になります。改行した場合は，属性名から記述してください。

定義例2：複数のフィルターを設定する

ログの種別が「アプリケーションログ」のイベントログのうち，次に示す条件のイベントログをトラップする。

フィルター1

種別：アプリケーションログ

種類：エラー

説明：「-E」および「JP1/Base」を含む。

フィルター2

種別：アプリケーションログ

種類：警告

説明：「-W」または「warning」を含む。

#フィルター1
filter "Application"
   type Error
   message '-E'
   message 'JP1/Base'
end-filter
#フィルター2
filter "Application"
   type Warning
   message '-W' 'warning'
end-filter

定義例3：正規表現を使用する

次に示す条件のイベントログをトラップする。

種別：アプリケーションログ

種類：エラー

イベントID：111

説明：「-E」または「MSG」を含み，かつ「TEXT」を含まない。

filter "Application"
   type Error
   id '^111$'
   message '-E' 'MSG'
   message !'TEXT'
end-filter

「111」のイベントIDを条件にしたい場合は，正規表現を使用して，「id '^111$'」と指定してください。「id '111'」と指定すると，「イベントIDに111を含む」という条件になるため，イベントIDが「1112」や「0111」でも条件が成立します。「!」を「'　'」の手前に付けた場合は，指定した正規表現に一致しないデータを選択します。正規表現の詳細については，「付録F　正規表現の文法」を参照してください。

定義例4：特定のイベントログだけ変換しない

ログの種別が「システムログ」で，ログの種類が「警告」のイベントログのうち，次に示す条件のイベントログだけトラップしない。

ソース：AAA

イベントID：111

説明：「TEXT」を含む。

#ソースがAAAのイベントログはトラップしない。

filter "System"
   type Warning
   source !'AAA'
end-filter
#ソースがAAA，かつイベントIDが111以外のイベントログをトラップする。
filter "System"
   type Warning
   source 'AAA'
   id !'^111$'
end-filter
#ソースがAAA，イベントIDが111，かつ説明に「TEXT」を含まないイベントログをトラップする。
filter "System"
   type Warning
   source 'AAA'
   id '^111$'
   message !'TEXT'
end-filter

配布定義ファイル

形式

[配布先ホスト，...]
定義情報
[&配布先ホスト，...]
定義情報
[配布先ホスト，...]@動作定義ファイル名
定義情報
　　　：

ファイル名

表14-13　配布定義ファイルのファイル名

配布対象の定義ファイル | 配布定義ファイルのファイル名
転送設定ファイル | [jev_forward.conf | 任意のファイル]
ログファイルトラップ動作定義ファイル | [jev_logtrap.conf | 任意のファイル]
ログファイルトラップ起動定義ファイル | [jev_logstart.conf | 任意のファイル]
イベントログトラップ動作定義ファイル | [jev_ntevent.conf | 任意のファイル]

格納先ディレクトリ

表14-14　配布定義ファイルの格納先（Windowsの場合）

配布対象の定義ファイル | 配布定義ファイルの格納先
転送設定ファイル | Eventフォルダ※¥
ログファイルトラップ動作定義ファイル | インストール先フォルダ¥conf¥
ログファイルトラップ起動定義ファイル | インストール先フォルダ¥conf¥event¥
イベントログトラップ動作定義ファイル | インストール先フォルダ¥conf¥event¥

注※　「Eventフォルダ」の部分は，次のフォルダに置き換えてください。

インストール先フォルダ¥conf¥event¥servers¥default

共有フォルダ¥jp1base¥event（クラスタ運用時）

表14-15　配布定義ファイルの格納先（UNIXの場合）

配布対象の定義ファイル | 配布定義ファイルの格納先
転送設定ファイル | Eventディレクトリ※/
ログファイルトラップ動作定義ファイル | /etc/opt/jp1base/conf/
ログファイルトラップ起動定義ファイル | /etc/opt/jp1base/conf/event/
イベントログトラップ動作定義ファイル | /etc/opt/jp1base/conf/event/

注※　「Eventディレクトリ」の部分は，次のディレクトリに置き換えてください。

/etc/opt/jp1base/conf/event/servers/default

共有ディレクトリ/event（クラスタ運用時）

説明

配布したい定義情報と，配布先ホストを設定しておくファイルです。配布定義ファイルは，配布対象の定義ファイルごとに作成する必要があります。標準の名称または任意のファイル名で，格納先に作成してください。

定義の反映時期

jevdef_distribコマンドを実行すると定義情報が配布され，設定が反映されます。jevdef_distribコマンドの詳細については，「13.　コマンド」の「jevdef_distrib」を参照してください。

記述内容

配布定義ファイルには，次に示す規則があります。

最初の「[　]」より前は，すべてコメント行になります。「[　]」以降は，定義情報と判断されます。

コメント行「#」を指定した場合は，コメント行も配布されます。

各行の最後には，必ず改行を入れてください。

[配布先ホスト]

JP1/IM - Managerのシステム構成で定義してあり，かつ，07-00以降のJP1/Baseがインストールされたホストのホスト名を指定します。

複数のホストに同じ定義情報を配布したい場合は，「[　]」内に，複数の配布先ホストを「,」で区切って指定します。

一つのホスト名に指定できる文字数は，255バイト以内です。

1行の最大長は1,023バイトです。

&

ホスト名の前に&を指定すると，構成定義情報でそのホストの下位1階層に定義された全ホストに対して定義情報が配布されます。構成定義情報で最下位に定義されたホストに対して「&」を指定しても，対象ホストがないため無視されます。「[　]」内には，&を指定したホストと，&を指定していないホストを混在して記述できます。

@動作定義ファイル名

ログファイルトラップ動作定義ファイルの定義情報を配布する場合だけ，任意のファイル名で配布できます。なお，ファイル名には，¥ / : , ; * ? " < > | とタブ・スペースは使用できません。「[　]」のあとに「@動作定義ファイル名」を指定すると，「[　]」内に指定されたホストの次のフォルダに配布されます。

Windowsの場合：インストール先フォルダ¥conf¥

UNIXの場合：/etc/opt/jp1base/conf/

このパラメーターを省略すると動作定義ファイル名としてjevlog.confが仮定されます。

注意事項

配布先のフォルダは変更できません。動作定義ファイル名にパスを指定した場合，配布は失敗します。

定義情報

各ホストに配布する定義情報を定義します。定義情報の形式は，各定義ファイルの形式と同じです。詳細については下記を参照してください。

「転送設定ファイル」のファイル形式

「ログファイルトラップ動作定義ファイル」のファイル形式
注　ファイル属性に関するパラメーター（FILETYPE，HEADLINE，HEADSIZE，およびRECTYPE）は変更しないでください。

「イベントログトラップ動作定義ファイル（Windows限定）」のファイル形式

定義例

次に示すシステムで，定義情報を一括して配布する場合の配布定義ファイルの定義例を示します。

図14-8　システムの構成例

上記のシステム構成例のManagerHostは，統合マネージャーです。SubHostA，SubHostB，SubHostCは，ManagerHostの管理対象ホスト，JP1host_1，JP1host_2は，SubHostAの管理対象ホストとしてJP1/IM - Managerのシステム構成で定義されています。システム構成の定義については，マニュアル「JP1/Integrated Management - Manager 構築ガイド」を参照してください。

ManagerHostから管理対象ホストへ転送設定ファイル（forward）の定義情報を配布する場合の配布定義ファイルの定義例を次に示します。

#------------------------------------------
# JP1/Base - Event Server jev_forward.conf
#------------------------------------------

[SubHostA, SubHostB, SubHostC]
#-------------------------------------------
# JP1/Base - Event Server Forwarding Setting
#-------------------------------------------
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

[JP1host_1，JP1host_2]
#-------------------------------------------
# JP1/Base - Event Server Forwarding Setting
#-------------------------------------------
to SubHostA
E.SEVERITY IN Error Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

次に，ログファイルトラップ動作定義ファイルの定義情報を配布する場合の設定例について説明します。ここでは，ManagerHostからSubHostA，SubHostBに「ACTDEF1」というファイル名で定義情報を配布し，SubHostCに「ACTDEF2」というファイル名で定義情報を配布します。

ログファイルトラップ動作定義ファイルの定義情報を配布する場合の配布定義ファイル（jev_logtrap.conf）の定義例を次に示します。

#------------------------------------------
# JP1/Base - Event Server jev_logtrap.conf
#------------------------------------------

[SubHostA,SubHostB]@ACTDEF1
FILETYPE=SEQ
RECTYPE =VAR '¥n'
HEADLINE=3
MARKSTR ="====="
        "MARK"
ACTDEF  =00000111:00000000  "message"
[SubHostC]@ACTDEF2
FILETYPE=SEQ
RECTYPE =VAR '¥n'
HEADLINE=3
MARKSTR ="====="
        "MARK"
ACTDEF  =00000222:00000000  "error"

パスワード定義ファイル（Windows限定）

形式

; コメント
OSユーザー名:パスワード

ファイル名

任意

格納先ディレクトリ

任意

説明

複数のOSユーザーのパスワード管理情報を一括して設定しておくファイルです。

定義の反映時期

jbsmkpassコマンドを実行すると，設定が有効になります。jbsmkpassコマンドの詳細については，「13.　コマンド」の「jbsmkpass（Windows限定）」を参照してください。

記述内容

一つのエントリーに対して1行の形式で表します。各行に記述できる文字数は，4,096バイト以内です。「;」以降は改行されるまでコメントになります。一つのエントリーは，「:」で区切られた二つのフィールドで構成されます。各フィールドに記述する内容を次に示します。

OSユーザー名

各ホストに登録されているOSユーザー名を指定します。

なお，登録するOSユーザー名には，ユーザー名だけでなく，自ホストが所属するドメイン名やローカルホスト名も記述できます。ドメイン名やローカルホスト名を記述する場合，「domain¥user1」，「server¥user1」のように，ドメイン名やローカルホスト名とユーザー名の区切り文字として「¥」を使用します。ドメイン名を記述した場合，登録するOSユーザーがドメイン上のユーザーであるかどうかチェックされます。ドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。ローカルホスト名を記述した場合，登録するOSユーザーがローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，そのOSユーザー名では登録できません。

ドメイン名やローカルホスト名を記述しなかった場合，登録するOSユーザー名がローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，信頼するドメインを含むドメイン上のユーザーであるかどうかチェックされます。ローカルユーザーおよびドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。

なお，Windowsのドメインコントローラー上で登録する場合は，「ドメイン名¥ユーザー名」の形式で記述してください。ドメインコントローラー上ではドメインユーザーとローカルユーザーの区別がないため，ドメインユーザーとして扱われるためです。

パスワード

OSユーザーのパスワードを指定します。パスワードを省略した場合は，パスワードなしのOSユーザーと見なしてパスワード管理情報に登録します。

注意事項

［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブで，［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックした場合，OSユーザー名やOSユーザーのパスワードが誤っていても，パスワード管理情報に登録できます。ただし，実際にジョブやリモートコマンドを実行するときに権限エラーとなってしまうので，注意が必要です。

定義例

パスワード定義ファイルの設定例を次に示します。

jp1user1:passwd000

ユーザー権限レベルファイル

形式

; コメント
JP1ユーザー:JP1資源グループ=JP1権限レベル:JP1資源グループ=JP1権限レベル:・・・

ファイル名

JP1_UserLevel

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥user_acl¥
共有フォルダ¥jp1base¥conf¥user_acl¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/user_acl/
共有ディレクトリ/jp1base/conf/user_acl/（クラスタ運用時）

説明

JP1ユーザーのJP1資源グループに対する操作権限を設定しておくファイルです。

定義の反映時期

jbsaclreloadコマンドを実行すると，設定が有効になります。jbsaclreloadコマンドの詳細については，「13.　コマンド」の「jbsaclreload」を参照してください。

記述内容

登録または変更したいJP1ユーザーのJP1資源グループに対するJP1権限レベルの割り当ては，一つのエントリーに対して1行の形式で表します。各行に記述できる文字数は，4,096バイト以内です。「;」以降は改行されるまでコメントになります。一つのエントリーは，「:」で区切られた二つ以上のフィールドで構成されます。各フィールドに記述する内容を次に示します。

JP1ユーザー

認証サーバに登録したJP1ユーザー名を指定します。JP1ユーザー名には，小文字しか使用できません。指定できる文字数は，1～31（バイト）です。

JP1資源グループ=JP1権限レベル

JP1資源グループとJP1権限レベル（JP1ユーザーの操作権限）を指定します。指定できる文字数は，JP1資源グループおよびJP1権限レベルそれぞれ一つにつき，64バイト以内です。

一つのJP1資源グループに対して，複数のJP1権限レベルを「,」で区切って，JP1_AJS_Admin,JP1_JPQ_Admin,JP1_Console_Adminのように指定できます。

指定するJP1資源グループおよびJP1権限レベルの詳細については，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。

JP1資源グループとJP1権限レベルについて次に説明します。

JP1資源グループ

JP1資源グループとは，ジョブ，ジョブネット，イベントなどの管理対象（資源）を幾つかに分けたグループのことです。指定するJP1資源グループについては，マニュアル「JP1/Integrated Management - Manager 構築ガイド」，「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。そのほかの製品については，それぞれのマニュアルを参照してください。「*」を指定すると，すべてのJP1資源グループにアクセスできるようになります。なお，「*」を指定したJP1ユーザーに，「*」以外のJP1資源グループは設定できません。

JP1権限レベル

JP1権限レベルとは，管理対象（資源）に対してJP1ユーザーがどのような操作権限を持っているかを表しています。ジョブ，ジョブネット，イベントなどの管理対象（資源）の種類に応じて，操作項目を定めています。管理対象（資源）の種類と，それに対する操作項目の幾つかを組み合わせた形式でJP1ユーザーの操作権限を管理します。

JP1権限レベルには，JP1_AJS_Admin，JP1_JPQ_Admin，JP1_Console_Adminなどがあります。指定するJP1権限レベルについては，マニュアル「JP1/Integrated Management - Manager 構築ガイド」，「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。そのほかの製品については，それぞれのマニュアルを参照してください。

注意事項

ユーザー権限レベルファイル（JP1_UserLevel）は，GUIでも利用しています。GUIで設定した内容は，このファイルに反映されます。

定義例

ユーザー権限レベルファイル（JP1_UserLevel）の設定例を次に示します。

jp1admin:*=JP1_AJS_Admin,JP1_JPQ_Admin,JP1_Console_Admin

ディレクトリサーバ変更ファイル（Windows限定）

形式

"SERVER"=ディレクトリサーバ名
"PORT"=接続先ポート番号
"BASE_DN"=コンテナオブジェクト識別名
"ATTR_NAME"=相対識別名
"SSL"=dword:{00000000 | 00000001}

ファイル名

任意

格納先ディレクトリ

任意

説明

連携したディレクトリサーバが障害などで使用できなくなった場合，一時的に変更するための共通定義情報を設定しておくファイルです。

定義の反映時期

jbschgdsコマンドを実行すると，ディレクトリサーバ変更ファイルの設定が共通定義情報に反映されます。また，一時的な変更の解除も，jbschgdsコマンドを使用します。jbschgdsコマンドの詳細については，「13.　コマンド」の「jbschgds（Windows限定）」を参照してください。

記述内容

ディレクトリサーバ変更ファイルの記述内容は，「ディレクトリサーバ連携定義ファイル（Windows限定）」を参照してください。ただし，ENABLEは指定しないでください。

定義例

ディレクトリサーバ変更ファイルの設定例を次に示します。

"SERVER"="host-B.domain.local"
"PORT"=dword:0000027C
"BASE_DN"="OU=JP1,DC=domain,DC=local"
"ATTR_NAME"="CN"
"SSL"=dword:00000001

ディレクトリサーバ連携定義ファイル（Windows限定）

形式

[JP1_DEFAULT¥JP1BASE¥DIRSRV]
"ENABLE"=dword:{00000000 | 00000001}
"SERVER"=ディレクトリサーバ名
"PORT"=接続先ポート番号
"BASE_DN"=コンテナオブジェクト識別名
"ATTR_NAME"=相対識別名
"SSL"=dword:{00000000 | 00000001}

ファイル名

jp1bs_ds_setup.conf（ディレクトリサーバ連携定義ファイル）

jp1bs_ds_setup.conf.model（ディレクトリサーバ連携定義ファイルのモデルファイル）

格納先ディレクトリ

インストール先フォルダ¥conf¥ds¥
共有フォルダ¥jp1base¥conf¥ds¥（クラスタ運用時）

説明

ディレクトリサーバと連携してログイン認証をするため，認証サーバで共通定義情報を設定しておくファイルです。セカンダリー認証サーバを設置している場合は，プライマリー認証サーバおよびセカンダリー認証サーバの両方に設定してください。

定義の反映時期

jbssetcnfコマンドを実行すると，ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）の設定が共通定義情報に反映されます。jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

記述内容

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）には，次のパラメーターを定義します。

ENABLE（省略できる）

ディレクトリサーバと連携するかどうかを指定します。ディレクトリサーバと連携しない場合は，00000000を指定します。ディレクトリサーバと連携する場合は，00000001を指定します。共通定義情報に設定していない場合は，00000000が仮定されます。

SERVER

通常時に使用するディレクトリサーバ名を指定します。SSLを使用する場合はFQDN形式で指定してください。指定できる文字数は，1～255（バイト）です。

PORT（省略できる）

通常時に使用するディレクトリサーバの接続先ポート番号を16進数で指定します。指定できる範囲は，00000001～0000ffffです。共通定義情報に設定していない場合，SSLを使用しないとき（ポート番号：389）は00000185が，SSLを使用するとき（ポート番号：636）は0000027Cが仮定されます。

BASE_DN

JP1ユーザーが存在するコンテナオブジェクトの識別名を指定します。指定できる文字数は，1～4,095（バイト）です。

ATTR_NAME

JP1ユーザー名として使用する相対識別名の属性名を指定します。指定できる文字数は，1～255（バイト）です。

SSL（省略できる）

SSLを使用するかどうかを指定します。SSLを使用しない場合は，00000000を指定します。SSLを使用する場合は，00000001を指定します。共通定義情報に設定していない場合は，00000001が仮定されます。

注意事項

論理ホスト上で設定する場合は，実行系および待機系の両方で設定します。その際，[JP1_DEFAULT¥JP1BASE]のJP1_DEFAULTを論理ホスト名に変更してください。

定義例

ディレクトリサーバの構成例を次に示します。

図14-9　ディレクトリサーバの構成例

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）の設定例を次に示します。

[JP1_DEFAULT¥JP1BASE¥DIRSRV]
"ENABLE"=dword:00000001
"SERVER"="host-A.domain.local"
"PORT"=dword:0000027C
"BASE_DN"="OU=JP1,DC=domain,DC=local"
"ATTR_NAME"="CN"
"SSL"=dword:00000001

ユーザーマッピング定義ファイル

形式

; コメント
JP1ユーザー名:サーバホスト名:ユーザーリスト

ファイル名

jp1BsUmap.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥user_acl¥
共有フォルダ¥jp1base¥conf¥user_acl¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/user_acl/
共有ディレクトリ/jp1base/conf/user_acl/（クラスタ運用時）

説明

複数のJP1ユーザーのユーザーマッピング情報を一括して設定しておくファイルです。

定義の反映時期

jbsmkumapコマンドまたはjbssetumapコマンドを実行すると，設定が有効になります。jbsmkumapコマンドおよびjbssetumapコマンドの詳細については，「13.　コマンド」の「jbsmkumap」，「jbssetumap」を参照してください。

記述内容

一つのエントリーに対して1行の形式で表します。各行に記述できる文字数は，4,096バイト以内です。「;」以降は改行されるまでコメントになります。一つのエントリーは，「:」で区切られた三つのフィールドで構成されます。各フィールドに記述する内容を次に示します。

JP1ユーザー名

認証サーバに登録したJP1ユーザー名を指定します。JP1ユーザー名には，小文字しか使用できません。指定できる文字数は，1～31（バイト）です。「*」を指定すると，認証サーバに登録されたすべてのJP1ユーザーにユーザーリストで指定したユーザーの権限が与えられます。複数のエントリーを記述する場合，同じサーバホストに対して，JP1ユーザー名には「*」と「認証サーバに登録した任意のJP1ユーザー名」を混合して指定できます。ただし，「*」は一つしか指定できません。

サーバホスト名

操作命令を出すサーバホスト名を指定します。指定できる文字数は，255バイト以内です。「*」を指定すると，すべてのサーバホストからの操作が有効になります。

サーバホストが物理ホストの場合

サーバホスト名には，hostnameコマンドで表示されるホスト名を指定してください。ただし，DNS運用でドメイン名を使用している場合は，FQDN形式のホスト名を指定してください。

サーバホストが論理ホストの場合

DNS運用しているかどうかに関係なく，論理ホスト名を指定してください。

なお，JP1/AJS - Viewからログインする場合，および自ホストに対してJP1/AJSのコマンドを実行する場合，自ホスト名をサーバホスト名として設定する必要があります。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

ユーザーリスト

各ホストに登録されているOSユーザー名を指定します。「,」で区切って複数指定できます。OSユーザー名を複数指定した場合，ユーザーリストの先頭に記述したOSユーザー名が，ジョブの実行やコマンド実行時などにユーザーを指定しなかった場合のプライマリーOSユーザーとなります。一つのOSユーザー名として指定できる文字数は，64バイト以内です。

なお，このユーザーリストに指定できるOSユーザーは，jbspassmgrコマンド，jbsumappassコマンド，またはjbsmkpassコマンドを利用してパスワード情報を登録したOSユーザーだけです。マッピングするOSユーザーをユーザーリストに指定する場合，必ずパスワード管理情報にそのOSユーザーの情報を登録してください。なお，OSユーザーの情報を登録したときに，自ホストが所属するドメイン名を記述した場合は，ユーザーリストのOSユーザー名にもドメイン名を記述する必要があります。

注意事項

ユーザーマッピング定義ファイル（jp1BsUmap.conf）は，GUIでも利用しています。GUIで設定した内容は，このファイルに反映されます。

定義例

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の設定例を次に示します。

jp1admin:*:Administrator

ヘルスチェック定義ファイル

形式

[JP1_EVENT]
OUTPUT={YES | NO}
RECOVER={YES | NO}
[SYSLOG]
OUTPUT={YES | NO}
RECOVER={YES | NO}
[OTHER_HOSTS]
INTERVAL=他ホスト監視間隔（秒）
STOP_CHECK={YES | NO}
HOST=ホスト名1,ホスト名2,...

ファイル名

jbshc.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥jbshc¥
共有フォルダ¥jp1base¥conf¥jbshc¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/jbshc/
共有ディレクトリ/jp1base/conf/jbshc/（クラスタ運用時）

説明

ヘルスチェック機能の動作として，監視対象ホストやプロセスの監視間隔を設定しておくファイルです。

定義の反映時期

プロセス管理機能を起動すると，ヘルスチェック定義ファイル（jbshc.conf）の内容が読み込まれ，プロセスの監視が開始されます。

記述内容

ヘルスチェック定義ファイル（jbshc.conf）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，その行は無効になります。

改行だけの行は無効になります。

[JP1_EVENT]

JP1イベントの発行に関するセクションです。

OUTPUT={YES | NO}

プロセスの状態が異常の場合にJP1イベントを発行するかどうかを指定します。「YES」または「NO」のどちらかを指定します。省略した場合は，YESが仮定されます。

RECOVER={YES | NO}

プロセスの状態が回復した場合にJP1イベントを発行するかどうかを指定します。「YES」または「NO」のどちらかを指定します。省略した場合は，YESが仮定されます。

なお，OUTPUTパラメーターに「NO」を指定した場合は，RECOVERパラメーターに「YES」を指定しても無効になります。

[SYSLOG]

syslog，またはイベントログへのメッセージ出力に関するセクションです。

OUTPUT={YES | NO}

プロセスの状態が異常の場合に，syslogまたはイベントログにメッセージを出力するかどうかを指定します。「YES」または「NO」のどちらかを指定します。省略した場合は，YESが仮定されます。

RECOVER={YES | NO}

プロセスの状態が回復した場合に，syslogまたはイベントログにメッセージを出力するかどうかを指定します。「YES」または「NO」のどちらかを指定します。省略した場合は，YESが仮定されます。

なお，OUTPUTパラメーターに「NO」を指定した場合は，RECOVERパラメーターに「YES」を指定しても無効になります。

[OTHER_HOSTS]

他ホスト監視の動作に関するセクションです。

INTERVAL=他ホスト監視間隔（秒）

他ホストを監視する間隔を指定します。指定できる値は，60～7,200（秒）です。

監視間隔の目安を次に示します。

HOSTパラメーターに指定したホスト数×3（秒）

監視に掛かる時間は，1台当たり3秒を目安にしてください。ただし，ネットワーク状況や監視対象ホストの状態によって監視に掛かる時間は変わる場合があります。

監視間隔を目安よりも短く設定すると，障害を早期に検知できますが，指定した監視間隔の間に他ホストを監視し終わらないことがあります。このような場合，前回の監視処理が終了するまで待機します。

監視間隔を目安よりも長く設定すると，ネットワークやOSのリソースの消費を抑えられますが，障害の検知が遅れるおそれがあります。

このパラメーターを省略した場合は，300秒が仮定されます。

運用中，統合トレースログにKAVA7219-Wのメッセージが出力された場合

指定した監視間隔が短いおそれがあります。次に示す計算式で監視間隔を見積もってください。

現在の設定値 ＋ ((KAVA7227-Iの出力時刻 - KAVA7219-Wの出力時刻) × 1.1)

STOP_CHECK={YES | NO}

監視対象ホストの起動・停止を監視するかどうかを指定します。「YES」または「NO」のどちらかを指定します。省略した場合は，YESが仮定されます。指定を省略した場合は，「NO」が仮定されます。

HOST=ホスト名1,ホスト名2,...

他ホストを監視する場合に，監視対象ホストを指定します。自ホストだけを監視する場合は，指定は不要です。

複数のホストを指定する場合は，コンマで区切って指定します。HOSTパラメーターは複数指定できます。なお，監視できる他ホスト数は1,024台までです。1,025台以上を指定した場合は，1,025台目以降のホストは監視しません。

共通定義設定用ファイル（ヘルスチェック機能）

形式

[JP1_DEFAULT¥JP1BASE¥JBSHC]
"ENABLE"=dword:{00000000 | 00000001}
"FAILOVER"=dword:{00000000 | 00000001}

ファイル名

任意

jbshc_setup.conf.model（共通定義設定用ファイル（ヘルスチェック機能）のモデルファイル）

格納先ディレクトリ

共通定義設定用ファイル（ヘルスチェック機能）のモデルファイルの格納先ディレクトリを次に示します。モデルファイルをコピーして，任意のファイル名で作成してください。

Windowsの場合

インストール先フォルダ¥conf¥jbshc¥
共有フォルダ¥jp1base¥conf¥jbshc¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/jbshc/
共有ディレクトリ/jp1base/conf/jbshc/（クラスタ運用時）

説明

ヘルスチェック機能は，初期設定では無効になっています。ヘルスチェック機能を使用するためには，ヘルスチェック機能を有効にするよう共通定義情報に設定するためのファイルです。

定義の反映時期

jbssetcnfコマンドを実行すると，ヘルスチェック機能の情報が共通定義情報に登録されます。jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

記述内容

共通定義設定用ファイル（ヘルスチェック機能）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1BASE¥JBSHC]

ヘルスチェック機能の設定の有無，および異常検知時のフェールオーバーの有無を記述するセクションです。論理ホストを設定する場合は，「JP1_DEFAULT」を論理ホスト名にしてください。

"ENABLE"=dword:{00000000 | 00000001}

ヘルスチェック機能を有効にするか無効にするかを指定します。有効にする場合は「dword:00000001」を指定します。無効にする場合は「dword:00000000」を指定します。共通定義情報に設定していない場合は，00000000が仮定されます。

"FAILOVER"=dword:{00000000 | 00000001}

クラスタシステムで運用する場合，自ホストを監視するヘルスチェック機能がプロセスの異常を検知した際にフェールオーバーするかどうかを指定します。フェールオーバーするときは「dword:00000001」を指定します※。フェールオーバーしないときは「dword:00000000」を指定します。共通定義情報に設定していない場合は，00000000が仮定されます。

※　Windowsの場合はJP1/Baseサービスを停止し，UNIXの場合はヘルスチェック機能のプロセス（jbshcd）を停止します。この停止を検知し，クラスタソフトでフェールオーバーするようにします。

JP1/Baseパラメーター定義ファイル

形式

[JP1_DEFAULT¥JP1BASE]
"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:{0 | 1}
"SEND_PROCESS_RESTART_EVENT"=dword:{0 | 1}
"SEND_AUTHSRV_EVENT"=dword:{0 | 1}

ファイル名

jp1bs_param_V7.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥
共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/
共有ディレクトリ/jp1base/conf/（クラスタ運用時）

説明

JP1/Baseでは，プロセスが異常終了した場合や，認証サーバを2台設置していて，自動で認証サーバの切り替えが発生した場合に，エラーメッセージを統合トレースログに出力しています。このメッセージをJP1イベントとして発行するため，あらかじめ設定しておくファイルです。

定義の反映時期

jbssetcnfコマンドを実行すると，JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）の設定が共通定義情報に反映されます。JP1/BaseおよびJP1/Baseを前提とする製品を再起動すると，設定が有効になります。jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

記述内容

jp1bs_param_V7.conf内から下記記述を探してください。

SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT

プロセスが異常終了した場合や，プロセス起動時にタイムアウトした場合にJP1イベントを発行するかどうかを定義します。共通定義情報に設定していない場合は，dword:0が仮定されます。

SEND_PROCESS_RESTART_EVENT

プロセスの再起動が完了した場合にJP1イベントを発行するかどうかを定義します。共通定義情報に設定していない場合は，dword:0が仮定されます。

SEND_AUTHSRV_EVENT

認証サーバの切り替えが発生した場合にJP1イベントを発行するかどうかを定義します。共通定義情報に設定していない場合は，dword:0が仮定されます。

JP1イベントを発行したい場合は，各パラメーターの値をdword:0からdword:1に変更してください。JP1イベントを発行する設定を解除したい場合は，各パラメーターの値をdword:1からdword:0に戻してください。

注意事項

論理ホスト上で設定する場合は，実行系および待機系の両方で設定します。その際，[JP1_DEFAULT¥JP1BASE]のJP1_DEFAULTを論理ホスト名に変更してください。

拡張起動プロセス定義ファイル

形式

プロセス名|パス|起動オプション|再起動可否|再起動回数|リトライ間隔|再起動回数リセット時間|

ファイル名

jp1bs_service_0700.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥
共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/
共有ディレクトリ/jp1base/conf/（クラスタ運用時）

説明

何らかの理由でプロセスが異常終了した場合，自動でプロセスを再起動するために，あらかじめ再起動の設定をしておくファイルです。

拡張起動プロセス定義ファイルで管理するプロセスの一覧を次に示します。

表14-16　拡張起動プロセス定義ファイルで管理するプロセスの一覧

親プロセス名
機能
子プロセス名
機能

jbs_spmd
JP1/Baseプロセス管理
jbscomd
プロセス間通信
jbssrvmgrプロセスおよびjbslcactプロセスの前提プロセス

jcocmd
コマンド実行

jbsroute
構成管理

jbssessionmgr
認証サーバ

jbsplugin
プラグインサービス

jbshcd
ヘルスチェック（自ホスト監視用）

jbshchostd
ヘルスチェック（他ホスト監視用）

jbssrvmgr
サービス管理制御機能
jbscomdプロセスに依存する。

jbslcact
ローカルアクション機能
jbscomdプロセスに依存する。

定義の反映時期

jbs_spmd_reloadコマンドを実行するか，JP1/Baseを再起動すると，設定が有効になります。jbs_spmd_reloadコマンドの詳細については，「13.　コマンド」の「jbs_spmd_reload」を参照してください。

記述内容

定義ファイルには，あらかじめ定義情報が記載されています。プロセス名，パス，起動オプションのパラメーターは変更しないでください。また，パラメーターを区切っている|は省略できません。コメント文を挿入したい場合は，行頭に#を付けてください。改行されるまでコメント文になります。

再起動可否

プロセスが異常終了した場合に，再起動するかどうかを指定します。再起動しない場合は0，再起動する場合は1を指定します。初期設定では，0が設定されています。

なお，依存関係を持ったプロセス群については，すべての子プロセスに対して同じ値を設定してください。

再起動回数

プロセスの再起動の試行回数を指定します。指定できる値は，0～99です。各プロセスで，あらかじめ最適値が設定されています。運用方法に応じてカスタマイズしてください。再起動可否のパラメーターに0が指定されている場合は，値が指定されていても無効になります。

リトライ間隔

プロセスの再起動のリトライ間隔を秒単位で指定します。指定できる値は，0～3,600です。各プロセスで，あらかじめ最適値が設定されています。運用方法に応じてカスタマイズしてください。再起動可否のパラメーターに0が指定されている場合は，値が指定されていても無効になります。

再起動回数リセット時間

再起動によってプロセスが起動してから，何秒後に再起動回数をリセットするかを指定します。プロセスが起動してから，指定した時間が経過すると，再起動回数がリセットされます。再度プロセスが異常終了した場合は，再起動回数が1からカウントされます。

再起動によってプロセスが起動してから，指定した時間より前に再度異常終了した場合は，前回の再起動回数を引き継ぎます。指定できる値は，3,600～2,147,483,647（秒）です。各プロセスで，あらかじめ最適値が設定されています。運用方法に応じてカスタマイズしてください。再起動可否のパラメーターに0が指定されている場合は，値が指定されていても無効になります。

注意事項

設定を省略したり，正常値を設定していない状態でプロセスを起動したりすると，エラーとなり起動しません。また，設定を省略したり正常値を設定していない状態でjbs_spmd_reloadコマンドを実行すると，エラーとなり，設定は反映されません。

クラスタ構成では，論理ホストのプロセス管理のプロセスを起動する際，論理ホストのconfフォルダに拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）がない場合，物理ホストの拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）がコピーされます。

クラスタ運用の場合に再起動したいときは，クラスタソフトの制御によって再起動してください。

定義例

プロセスが異常終了した場合の動作
拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）の設定例と，プロセスが異常終了した場合の動作を次に示します。
ここでは，JP1/Baseのプロセスに対して次の条件を設定します。

再起動可否：する

再起動回数：4回

リトライ間隔：3秒

再起動回数リセット時間：3,600秒

jcocmd|C:¥ProgramFiles¥HITACHI¥JP1Base¥bin¥jcocmd.exe||1|4|3|3600|
jbsroute|C:¥ProgramFiles¥HITACHI¥JP1Base¥bin¥jbsroute.exe|-o,600|1|4|3|3600|
jbssessionmgr|C:¥ProgramFiles¥HITACHI¥JP1Base¥bin¥jbssessionmgr.exe||1|4|3|3600|
jbsplugin|C:¥ProgramFiles¥HITACHI¥JP1Base¥bin¥jbsplugind.exe||1|4|3|3600|

図14-10　プロセスが異常終了した場合の動作例

図の例では，再起動後，再起動回数のリセット時間で指定した3,600秒以内に異常終了しなかった場合，3,600秒の時点で再起動回数がリセットされます。次回異常終了したときには1回目からカウントされます。一方，再起動後，3,600秒以内に異常終了した場合は，再起動回数を引き継ぎます。再起動回数が，指定した回数に達すると，次回異常終了時には再起動しません。

依存関係を持ったプロセスが異常終了した場合の動作
依存関係を持ったプロセスが異常終了した場合の動作を次に示します。

再起動可否：する

再起動回数：4回

リトライ間隔：3秒

再起動回数リセット時間：21,600秒

jbscomd|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbscomd.exe||1|4|3|21600|
jcocmd|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jcocmd.exe||0|3|3|21600|
jbsroute|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbsroute.exe|-o,600|0|3|3|21600|
jbssessionmgr|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbssessionmgr.exe||0|3|3|21600|
jbsplugin|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbsplugind.exe||0|3|3|21600|
jbshcd|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbshcd.exe||0|3|3|21600|
jbshchostd|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbshchostd.exe||0|3|3|21600|
jbssrvmgr|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbssrvmgr.exe|jbscomd|1|4|3|21600|
jbslcact|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbslcact.exe|jbscomd|1|4|3|21600|

図14-11　依存関係を持ったプロセスが異常終了した場合の動作例

前提プロセスであるjbscomdプロセスが異常終了した場合，依存しているプロセス（jbssrvmgrおよびjbslcact）も停止します。再起動可否が設定されていると，前提プロセス（jbscomd）の再起動が完了したあとに，依存しているプロセスも再起動します。
再起動可否については，依存関係を持っているすべてのプロセス群に対して，同じ値を設定してください。

jp1hosts定義ファイル

形式

#　コメント
ホスト名　IPアドレス，IPアドレス，IPアドレス

ファイル名

jp1hostsまたは任意のファイル名

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥
共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/
共有ディレクトリ/jp1base/conf/（クラスタ運用時）

説明

JP1/Base独自のhosts情報を設定しておくファイルです。jp1hosts定義ファイルは，初期設定で提供されています。ただし，初期の状態では利用できません。このファイルを利用する場合は，運用に合わせて編集してください。なお，独自にjp1hosts定義ファイルを作成，編集することもできますが，この場合も格納場所は，初期設定で提供されているjp1hostsファイルと同じ場所にしてください。

定義の反映時期

jbshostsimportコマンドを実行すると，jp1hosts情報が共通定義情報に反映されます。jbshostsimportコマンドの詳細については，「13.　コマンド」の「jbshostsimport」を参照してください。

記述内容

jp1hosts定義ファイルには，次に示す規則があります。

jp1hosts定義ファイルは，一つのエントリーに対して1行の形式で表します。1行に記述できる文字数は，255バイト以内です。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

ホスト名　IPアドレス，IPアドレス，IPアドレス

この行にはホスト名とIPアドレスの対応を記述します。ホスト名およびIPアドレスにはASCII文字だけが使用できます。また，" / ¥ [ ] ; : | = , + ? < >の文字は使用できません。ホスト名とIPアドレスの間は一つ以上の半角スペースかタブ文字で区切ってください。また，IPアドレスとして認識できる文字列はホスト名として利用できません。

IPアドレスを複数指定する場合は，「,」で区切ってください。「,」の前後の半角スペース，タブ文字は入力しても無視されます。なお，各IPアドレスの指定形式はW.X.Y.Zだけです（W，X，Y，Zにはそれぞれ0以上255以下の数値を指定してください）。

IPアドレスを複数設定する場合，送信時には，ホスト名に最初に設定されているIPアドレスが使用されます。

送信をIPバインド方式にしている場合，送信側のIPアドレスは，自ホスト名に最初に設定されているIPアドレスが使用されます。

一つのホスト名に対して指定できるIPアドレスの数は4です。また，同じホスト名の複数指定はできません。複数指定した場合，jbshostsimportコマンドを実行した際にエラーとなります。

ホストアクセス制限定義ファイル

形式

AllowHost {
upper-host
all-host
host ホスト名1
host ホスト名2
　　　：
host ホスト名n
}

ファイル名

jbsdfts_srv.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥jbsdfts
共有フォルダ¥jp1base¥conf¥jbsdfts¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/jbsdfts
共有ディレクトリ/jp1base/conf/jbsdfts/（クラスタ運用時）

説明

JP1/IMのIM構成管理と連携する場合に，アクセスを許可するホストを指定しておくファイルです。ここで指定されたホスト以外からのアクセスは，すべて拒否します。ただし，自ホストのJP1/IMからのアクセスは，すべて許可します。

定義の反映時期

jbs_spmd_reloadコマンドを実行するか，JP1/Baseを再起動すると，設定が有効になります。jbs_spmd_reloadコマンドの詳細については，「13.　コマンド」の「jbs_spmd_reload」を参照してください。

記述内容

upper-host

JP1/IMのIM構成管理上の上位ホストをすべて許可します。IM構成管理に組み込まれていないホストでは，上位ホストなしとみなされます。初期設定は，upper-hostが設定されています。

all-host

すべてのホストを許可します。

host　ホスト名

ホスト名に指定されたホストを許可します。

ローカルアクション環境変数ファイル

形式

環境変数名1=変数値1
[環境変数名2=変数値2]
　　　：

ファイル名

任意。なお，ファイル名は，255バイト以内で設定してください。

格納先ディレクトリ

任意。なお，格納先ディレクトリおよびファイル名は，ローカルアクション実行定義ファイルのvarオプションに指定してください。

説明

ローカルアクション機能で指定されたコマンドを実行するときの環境変数を設定するファイルです。複数のローカルアクション環境変数ファイルを用意することで，実行するコマンドごとに任意の環境変数を指定できます。Windowsの場合，ローカルアクション環境変数ファイルを指定しない場合，システムの環境変数でコマンドが実行されます。

定義の反映時期

ローカルアクション機能で指定されたコマンドを実行するときに参照されます。

記述内容

環境変数名

環境変数の名称を指定します。改行文字を含む環境変数は指定できません。

変数値

環境変数名の値を指定します。

環境変数名と変数値の設定内容は，システム環境変数の値と置換できます。例えば，Windowsの場合に%で囲む指定や，UNIXの$で始まる指定のように，システム環境変数名を「<-」と「->」で囲み，「<-variable->」のように指定してください。ただし，置換できるのは1行に対して1か所だけです。

ローカルアクション実行定義ファイル

形式

# 共通ブロック
[cmn
[usr JP1ユーザー名]
[var 環境変数ファイル名]
[evt [{yes|no}]/[{yes|no}]]
[cnt-opt [queue=実行待ちアクション数] , [exec=同時実行数]]
end-cmn]
# アクションブロック
act アクション名
cnd
イベントフィルター
end-cnd
[det 同一アクション抑止時間]
[usr JP1ユーザー名]
[var 環境変数ファイル名]
cmd 実行するコマンド
[evt [{yes|no}]/[{yes|no}]]
[cmd-opt usrprofile={0|1}]
end-act
　　　：

ファイル名

jbslcact.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥lcact
共有フォルダ¥jp1base¥conf¥lcact（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/lcact/
共有ディレクトリ/jp1base/conf/lcact/（クラスタ運用時）

説明

ローカルアクション機能の実行条件と実行コマンドを定義するファイルです。共通ブロックとアクションブロックで構成されます。共通ブロックは，すべてのアクションブロックで共通に設定するパラメーターを定義します。アクションブロックは，アクションを成立させるJP1イベントの条件と，JP1イベントの条件が成立した場合に実行するアクションを一対として定義します。

ローカルアクション機能が実行される場合，上位に定義されたアクションブロックから条件の判定を行い，条件が成立したときにアクションを実行します。条件が成立したアクションブロックより下位に定義されたアクションブロックは，条件の判定を行わず，アクションも実行されません。このため，優先度の高い条件を上位に定義してください。

定義の反映時期

JP1/Baseを起動またはリロードすると，設定が有効になります。

記述内容

ローカルアクション実行定義ファイルには，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

1行の最大長は4,200バイトです。

パラメーターは，半角スペース（0x20）またはタブ（0x09）で区切ります。

英字の大文字小文字は区別します。

共通ブロックはアクションブロックの前に一つだけ指定します。共通ブロックとアクションブロックで共通するパラメーターが指定されている場合は，アクションブロックの指定が有効になります。共通ブロックの記述形式を次に示します。

cmn ～ end-cmn

共通ブロックの開始と終了を示すパラメーターです。

usr　JP1ユーザー名

アクションを実行するOSユーザーにマッピングするJP1ユーザーを指定します。このパラメーターを省略した場合，アクションブロックに同じパラメーターが必要になります。

var　環境変数ファイル名

アクションを実行する場合に参照する環境変数ファイル名を255バイト以内で指定します。

evt [{yes|no}]/[{yes|no}]

アクション開始イベントとアクション完了イベントのJP1イベントを発行するかどうかを指定します。/の前がアクション開始イベントで，後がアクション完了イベントの指定になります。yesが指定されている場合，JP1イベントが発行されます。noが指定されている場合や省略されている場合，JP1イベントは発行されません。

cnt-opt [queue=実行待ちアクション数] , [exec=同時実行数]

実行待ちアクション数および同時実行数を指定します。queueオプションとexecオプションを指定する場合は，コンマで区切ってください。

queue=実行待ちアクション数

アクションの条件が成立した後に，アクションを実行待ちできる上限値を指定します。指定した上限値を超えると，そのアクションは実行されないため，余裕のある値を指定してください。指定できる値の範囲は，0～65,535です。省略した場合は，1,024が仮定されます。

exec=同時実行数

同時に実行できるアクション数の上限値を指定します。実行中のアクション数が指定した上限値に達していると，そのアクションは実行待ちになります。指定できる値の範囲は，1～48です。省略した場合は，1が仮定されます。

アクションブロックは，上限を1,000として複数指定できますが，省略はできません。共通ブロックとアクションブロックで共通するパラメーターが指定されている場合は，アクションブロックの指定が有効になります。アクションブロックの記述形式を次に示します。

act アクション名 ～ end-act

アクションブロックの開始と終了を示すパラメーターです。actパラメーターの後には任意のアクション名を50バイト以内で指定してください。アクション名はローカルアクション実行履歴ログに出力されます。

cnd ～ end-cnd

アクションを成立させるJP1イベントの条件を指定するブロックの開始と終了を示すパラメーターです。このブロックは，actパラメーターの直後に指定してください。アクションを成立させる条件はイベントフィルターの記述形式で指定します。イベントフィルターの記述形式については，「イベントフィルターの文法」を参照してください。

det　同一アクション抑止時間

同じアクションを実行しない時間を秒単位で指定します。指定できる時間の範囲は，1～3,600（秒）です。このパラメーターを省略した場合，同じアクションの実行を抑止しません。

usr　JP1ユーザー名

アクションを実行するOSユーザーにマッピングするJP1ユーザーを指定します。JP1ユーザー名には，属性変数名が指定できます。このパラメーターを省略した場合，共通ブロックに同じパラメーターが必要になります。

var　環境変数ファイル名

アクションを実行する場合に参照する環境変数ファイル名を255バイト以内で指定します。環境変数ファイル名には，属性変数名が指定できます。

cmd 実行するコマンド

アクションで実行するコマンドを4,096バイト以内で指定します。実行するコマンドには，属性変数名が指定できます。実行するコマンドの形式については，「1.8.2　ローカルアクションで実行できるコマンド」を参照してください。

evt [{yes|no}]/[{yes|no}]

アクション開始イベントとアクション完了イベントのJP1イベントを発行するかどうかを指定します。/の前がアクション開始イベントで，後がアクション完了イベントの指定になります。yesが指定されている場合，JP1イベントが発行されます。noが指定されている場合や省略されている場合，JP1イベントは発行されません。

cmd-opt usrprofile={0|1}

コマンドの実行時にユーザープロファイルをロードすることを指定します。

このオプションを省略した場合は，0を仮定します。

0：マッピングOSユーザーのユーザープロファイルをロードしない

1：マッピングOSユーザーのユーザープロファイルをロードする

属性変数名

属性変数名は，アクションブロック内の項目に指定できます。属性変数名を指定できる項目は，JP1ユーザー名，環境変数ファイル名，実行するコマンドの3項目です。アクションを実行する前に，アクションが成立した条件のJP1イベントから，属性変数名に対応した属性値を取得して展開します。複数個所での展開はできますが，展開後の文字列に対しての展開はできません。指定できる属性変数名の一覧を次に示します。

表14-17　ローカルアクションで指定できる属性変数名の一覧

情報の種類
属性変数名
内容

JP1イベント基本属性に含まれる情報
EVID
イベントID（基本コード:拡張コード）

EVPID
イベント発行元プロセスID

EVUSRID
イベント発行元プロセスのユーザーID

EVGRPID
イベント発行元プロセスのグループID

EVUSR
イベント発行元ユーザー名

EVGRP
イベント発行元グループ名

EVHOST
イベント発行元ホスト名

EVIPADDR
イベント発行元IPアドレス

EVMSG
メッセージテキスト全体

JP1イベント拡張属性に含まれる情報
EVSEV
イベント拡張情報重大度
（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）

EV"拡張属性名"
任意の拡張属性

属性変数名の指定例を次に示します。

cmd  abcd.bat $EVUSR

cmdパラメーターに属性変数名EVUSR（属性値:USER01）を指定した例です。この例では，abcd.bat USER01に展開されます。

属性変数名を指定するときの注意事項を次に示します。

JP1イベントの文字コードと動作環境の文字コードが異なっていてもそのまま展開されてしまいます。文字コードは一致させてください。

展開後の文字列長が制限値をオーバーしている場合，アクションは実行されません。

該当しない項目の属性変数名の値はNULLになります。また，JP1イベントの種類によっては，属性変数名自体のないものや，各属性に含まれる情報に文字として認識できないコード（ASCIIコードおよび環境設定で指定した日本語文字コードの文字集合に含まれない部分）が含まれていることで，アクションが実行できない，または実行されても結果が不正になる場合があります。JP1イベント発行元製品のマニュアルなどを事前に参照し，設定してください。

属性変数名の直後に文字を記述する場合，英数字および「_ 」を指定すると正しく変換されません。このような場合は，属性変数名を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

アクション定義 → 変換後の情報
「$EVID abc」  →「100:0 abc」
「$EVIDabc」   →「$EVIDabc」(Windowsの場合)，なし(UNIXの場合)
「${EVID}abc」 →「100:0abc」
「$EVID_abc」  →「$EVID_abc」(Windowsの場合)，なし(UNIXの場合)
「${EVID}_abc」→「100:0_abc」
「$EV"EX" abc」→「ABC abc」
「$EV"EX"abc」 →「ABCabc」

変換元の文字情報に，次に示す制御文字が含まれていた場合，その制御文字は半角スペース（0x20）に変換されて処理されます。
半角スペースに変換される制御文字：0x01～0x1F（タブ(0x09)を除く），0x7F
例えば，$EVMSGの指定によって取得したメッセージの中に改行コード（0x0A）が含まれていた場合，改行コード（0x0A）は半角スペース（0x20）に変換されて処理されます。
（例）アクション（echo $EVMSG）を設定し，イベントのメッセージとして改行コードを含む文字列”1行目 0x0A 2行目”を受信した場合には，アクションとして実行されるコマンドは "echo 1行目△2行目"となります（△は半角スペースを表す）。

UNIXの場合，最終的な展開はシェルの解釈に依存します。展開後のデータに「*」など，シェルで特別な意味を持つ文字がある場合，その内容に置き換えられます。置き換えが行われないようにするには，変数全体を「"」で囲み，「"$EVMSG"」のように記述してください。

共通定義設定用ファイル（ローカルアクション機能）

形式

[JP1_DEFAULT¥JP1BASE¥LCACT]
"LOGSIZE"=ローカルアクション実行履歴ログファイルのサイズ
"LOGFILENUM"=ローカルアクション実行履歴ログファイルの保存面数
"PAUSE"=dword:{00000000 | 00000001}

ファイル名

任意

jp1bs_lcact_setup.conf.model（共通定義設定用ファイル（ローカルアクション機能）のモデルファイル）

格納先ディレクトリ

共通定義設定用ファイル（ローカルアクション機能）のモデルファイルの格納先ディレクトリを次に示します。モデルファイルをコピーして，任意のファイル名で作成してください。

Windowsの場合

インストール先フォルダ¥conf¥lcact¥
共有フォルダ¥jp1base¥conf¥lcact¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/lcact/
共有ディレクトリ/jp1base/conf/lcact/（クラスタ運用時）

説明

マシンメンテナンスなどの作業のため，ローカルアクション機能を休止したり，休止を解除して起動したりする設定や，ローカルアクション実行履歴ログファイルのログ情報を共通定義情報に設定するためのファイルです。

定義の反映時期

jbssetcnfコマンドを実行すると，共通定義設定用ファイル（ローカルアクション機能）の情報が共通定義情報に登録されます。jbssetcnfコマンドの詳細については，「13.　コマンド」の「jbssetcnf」を参照してください。

その後，jbs_spmd_reloadコマンドを実行するか，JP1/Baseを再起動すると，共通定義情報の設定が有効になります。jbs_spmd_reloadコマンドの詳細については，「13.　コマンド」の「jbs_spmd_reload」を参照してください。

記述内容

共通定義設定用ファイル（ローカルアクション機能）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1BASE¥LCACT]

ローカルアクション機能の設定の有無，およびローカルアクション実行履歴ログファイルのログ情報を記述するセクションです。論理ホストを設定する場合は，「JP1_DEFAULT」を論理ホスト名にしてください。

"LOGSIZE"=ローカルアクション実行履歴ログファイルのサイズ

ローカルアクション実行履歴ログファイルのサイズ（バイト単位）を16進数で指定します。指定できる範囲は，「00002000」（8KB）～「00400000」（4,096KB）です。指定できる範囲の下限値よりも小さい値を指定した場合は下限値を仮定し，上限値よりも大きい値を指定した場合は上限値を仮定します。共通定義情報に設定していない場合は，00100000（1,024KB）が仮定されます。

"LOGFILENUM"=ローカルアクション実行履歴ログファイルの保存面数

ローカルアクション実行履歴ログファイルの保存面数を16進数で指定します。指定できる範囲は，「00000001」（1面）～「00000010」（16面）です。指定できる範囲の下限値よりも小さい値を指定した場合は下限値を仮定し，上限値よりも大きい値を指定した場合は上限値を仮定します。共通定義情報に設定していない場合は，00000004（4面）が仮定されます。

"PAUSE"=dword:{00000000 | 00000001}

ローカルアクション機能を起動するか，休止するかを指定します。起動する場合は「dword:00000000」を指定します。休止する場合は「dword:00000001」を指定します。共通定義情報に指定できる値以外の値を設定した場合や，値を設定していない場合は，00000000が仮定されます。

15.　JP1イベント

この章では，JP1/Baseが出力するJP1イベントの種類と発行契機，およびJP1イベント情報の詳細について説明します。

＜この章の構成＞

15.1　JP1イベントの属性

15.2　JP1/Baseが出力するJP1イベント一覧

15.3　JP1イベントの詳細

15.1　JP1イベントの属性

JP1イベントの属性を示します。JP1イベントの属性には基本属性と拡張属性があります。

基本属性は，すべてのJP1イベントが持っている属性です。拡張属性は，JP1イベントを発行するプログラムが独自に割り当てる属性です。

＜この節の構成＞

15.1.1　基本属性

15.1.2　拡張属性

15.1.1　基本属性

JP1イベントの基本属性を次の表に示します。

表15-1　JP1イベントの基本属性

通称
形式※1
内容
JP1/SESでの採否

イベントDB内の通し番号
数値（32ビット）
発行元によらないでこのイベントサーバに到達した順番（ローカルイベントも含む）。この属性はJP1イベントのイベントサーバ間の転送時に保存されない。主にJP1イベントを擬似オペレーターやほかのイベントサーバへ転送した時の漏れ・重複の防止に用いる。※7
×

イベントID
数値（32ビット）の2組※2
発行APや事象の内容を表す8バイトの値。
○

登録要因
数値（32ビット）
JP1イベントがこのイベントサーバに登録された要因。この属性はJP1イベントのイベントサーバ間転送時に保存されない。登録要因を次に示す。

1の場合：

自イベントサーバから自イベントサーバあての発行

2の場合：

自イベントサーバから他イベントサーバあての発行（この値はアプリケーションで取得できません）

3の場合：

他イベントサーバから自イベントサーバあての発行

4の場合：

環境設定の指定による他イベントサーバから自イベントサーバへの転送

×

発行元プロセスID
数値（32ビット）
発行元APのプロセスID。
○

登録時刻
数値（32ビット）
発行元イベントサーバでの登録時刻（発行元ホストの時計に基づく。UTCの1970-01-01 00:00:00からの秒数）。
○

到着時刻
数値（32ビット）
自イベントサーバでの登録時刻（UTCの1970-01-01 00:00:00からの秒数）。この属性はJP1イベントのイベントサーバ間転送時に保存されない。
×

発行元ユーザーID
数値（32ビット）
発行元プロセスのユーザーID（数値）。WindowsとJavaでは環境設定による固定値（-1～65,535）。
○

発行元グループID
数値（32ビット）
発行元プロセスのグループID（数値）。WindowsとJavaでは環境設定による固定値（-1～65,535）。
○

発行元ユーザー名
文字列（0～20バイト）
発行元プロセスのユーザー名。
○

発行元グループ名
文字列（0～20バイト）
発行元プロセスのグループ名。WindowsとJavaではヌル文字列。
○

発行元イベントサーバ名※3
文字列（0～255バイト）
発行元のイベントサーバ名。
JP1イベントが，エージェントホスト→サブマネージャーホスト→マネージャーホストのように転送された場合でも，最初のエージェントホストのイベントサーバ名が入る。
○

送信先イベントサーバ名 ※3
文字列（0～255バイト）
発行元APが他イベントサーバへの転送を明示して指定した場合に，他イベントサーバの名称が入る。
○

発行元IPアドレス
バイト列（0～16バイト）
発行元イベントサーバに対応するIPアドレス（NAT（ネットワークアドレス変換）やプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。
○

送信先IPアドレス
バイト列（0～16バイト）
送信先イベントサーバに対応するIPアドレス（NAT（ネットワークアドレス変換）やプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。
○

発行元別通し番号
数値（32ビット）
発行元ホストでのイベントDB内通し番号（転送によって値は変化しない）。※4※7
×

コードセット
文字列（0～255バイト）
メッセージ・詳細情報・拡張属性が記述されている文字コードセット名。※5
×

メッセージ
文字列（0～1,023バイト）※6
JP1イベントの内容を表した文字列。
○

詳細情報
文字列またはバイト列（0～1,024バイト）※6
任意のデータ。
○

（凡例）

○：JP1/SESでサポートしている属性

×：JP1/SESでサポートしていない属性

注※1　文字列は0を除く任意のバイト列です。バイト列は0を含むことがあります。

注※2　上位4バイト（基本コード），下位4バイト（拡張コード）で示される16進数で表現されます。例えば，00000111:00000000または111:0と表現します。値の範囲については各JP1プログラムのマニュアルを参照してください。また，ユーザーの使用できるIDは0:0～1FFF:0および7FFF8000:0～7FFFFFFF:0の範囲です。なお，拡張コードは必ず0になります。

注※3　通常，イベントサーバ名はホスト名です。

注※4　06-51/C以降のJP1/Baseでは，JP1/SESプロトコルのイベントについてはJP1/SESプロトコルのイベントを受信したイベントサーバでそのときの時刻をミリ秒に変換したものを基に採番されます。

注※5　次の値などがあります。

8859_1（ISO-8859-1）

SJIS（シフトJIS）

EUCJIS（EUC日本語）

UTF-8（日本語UTF-8）

注※6　メッセージと詳細情報を合わせて1,024バイトに制限されます。メッセージと詳細情報の関係を次に示します。

詳細情報の有無と形式 | メッセージなし | メッセージあり（文字列）
なし | － | 1,023バイト
あり（文字列） | 1,023バイト | 合計1,022バイト
あり（バイト列） | 1,024バイト | 合計1,023バイト

注※7　値は0～2,147,483,647の範囲です。2,147,483,647に達すると0に戻ります。ただし，登録要因が2のイベントなど，内部的に使用しているイベントは取得できないため，通し番号が抜けているように見える場合があります。

15.1.2　拡張属性

JP1イベントの拡張属性とは，JP1イベント発行元プログラムが任意に指定できる属性です。拡張属性には共通情報と固有情報があります。共通情報はJP1プログラムで統一されている情報を示します。固有情報は共通情報以外の拡張属性を示します。

共通情報の一覧を次の表に示します。

表15-2　共通情報の一覧

項目
属性名
内容

重大度
SEVERITY
JP1イベントの緊急性を表す。緊急性の高い順に，次の値がある。
"Emergency"（緊急）
"Alert"（警戒）
"Critical"（致命的）
"Error"（エラー）
"Warning"（警告）
"Notice"（通知）
"Information"（情報）
"Debug"（デバッグ）

ユーザー名
USER_NAME
業務を実行しているユーザー名。

プロダクト名
PRODUCT_NAME
JP1イベントを発行したプログラム名。次に示すプログラム名などがある。
"/HITACHI/JP1/AJS"
"/HITACHI/JP1/AOM"
"/HITACHI/JP1/IM"
"/HITACHI/JP1/NBQ"
"/HITACHI/JP1/NETMDM"
"/HITACHI/JP1/NPS"
"/HITACHI/JP1/NQSEXEC"
"/HITACHI/JP1/SES"
"/HITACHI/JP1/BASE"

オブジェクトタイプ
OBJECT_TYPE
オブジェクトの種類を表す。
"JOB" "JOBNET" "BATCHJOB" "ACTION" "LIST" "EVENTDB" "COMMAND" "LOGFILE" "SNMP_TRAP" "SESSION" "SPMD"

オブジェクト名
OBJECT_NAME
ジョブ，ジョブネットなどのオブジェクトの名称。ジョブネットなど階層のあるオブジェクトの場合，最下層の要素。

登録名タイプ
ROOT_OBJECT_TYPE
オブジェクトの種別。通常はオブジェクトタイプと同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの種別となる。値の範囲はオブジェクトタイプと同じ。

登録名
ROOT_OBJECT_NAME
ユーザーの操作時に実行を指示する単位になる名称。通常はオブジェクト名と同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの名称になる。

オブジェクトID
OBJECT_ID
オブジェクトID。
PRODUCT_NAMEとの組み合わせによってオブジェクトのインスタンスを統合システム内で一意に意識できる文字列（形式は他製品に依存する。この情報はJP1/IM - Viewの［統合機能メニュー］画面から各製品のモニターを呼び出すときに使用する）。

事象種別
OCCURRENCE
オブジェクト名に示したオブジェクトに対して起こった事象。次に示す事象種別などがある。
"END"
"LATEEND"
"LATESTART"
"NOTICE"
"PAUSE"
"START"
"SWITCH"
"RECEIVE"

開始時刻
START_TIME
実行開始または再実行開始の時刻（UTC 1970-01-01 00:00:00からの秒数）。この項目は設定されない場合もある。

終了時刻
END_TIME
実行終了の時刻（UTC 1970-01-01 00:00:00からの秒数）。この項目は設定されない場合もある。

終了コード
RESULT_CODE
10進数文字列の終了コード。この項目は設定されない場合もある。

15.2　JP1/Baseが出力するJP1イベント一覧

JP1/Baseが出力するJP1イベントを次の表に示します。

表15-3　JP1/Baseが出力するJP1イベント一覧

イベントID
発行契機
メッセージ

00003D00
イベントDBを切り替えた場合
イベントDBを旧DB番号から新DB番号に切り替えました

00003D04
イベントサービスの再起動機能によって異常終了したプロセスを再起動した場合
イベントサービスは内部機能の再起動により回復しました

00003A10※4
ログファイルトラップのリトライによってイベントサービスに再接続できた場合
ログファイルトラップのリトライが行われたため，イベント発行が遅延しました

00003A20※4
ログファイルトラップがログファイルの監視を開始できない場合
該当ログファイルの監視を開始出来ません

00003A21※4
APのログファイルの読み込みリトライ回数がしきい値をオーバーし，該当ログファイルの監視を停止した場合
指定された回数リトライ処理を行いましたが，該当ログファイルの読み込みが出来ないため監視を停止します

00003A22※4
APのログファイルの状態が異常となった場合
該当ログファイルを正しく監視することができない状態になりました

00003A30
リモート監視ログ（ログファイルトラップまたはイベントログトラップ）が，異常終了してから再起動した場合
前回停止時から今回起動時までのログのJP1イベントが登録されていないおそれがあります

00003A31
リモート監視ログ（ログファイルトラップまたはイベントログトラップ）が，イベントサービスへ接続できる状態で異常終了した場合
続行不可能なエラーが発生したためリモート監視を停止します

00003A32
リモート監視ログ（ログファイルトラップまたはイベントログトラップ）のリトライによって，イベントサービスに再接続できた場合
リモート監視のリトライが行われたため、イベント発行が遅延しました

00003A71
Windowsイベントのログメッセージを検知した場合
Windowsイベントのログメッセージ

00003A73
Windowsイベントのログの取得に失敗した場合
イベントログの取得に失敗しました

00003A74
Windowsイベントのログの監視が可能になった場合
イベントログの監視が可能になりました

動作定義ファイルのACTDEFパラメーターに指定されたイベントID※4
APのログファイルのレコードを検知した場合
ログファイルの1行分のデータの内容

00003A80
SNMPトラップを検知した場合
JP1/Cm2/NNMまたはHP NNMのメッセージ（詳細については，「付録I.5　SNMPトラップ変換のJP1イベント」を参照）

00003FA0※1
コマンド実行制御が［コマンド実行］画面からコマンド実行要求を受け取った場合
[ホスト名 : JP1ユーザー名] コマンド実行を開始しました

00003FA1※1
［コマンド実行］画面から実行要求されたコマンドが実行完了した場合
[ホスト名 : JP1ユーザー名] コマンド実行が終了しました

00003FA2※1
［コマンド実行］画面から実行要求されたコマンドが，何らかの原因で実行されなかった場合
[ホスト名 : JP1ユーザー名] コマンド実行が異常終了しました

00003FA3※1
jcocmddefコマンドで経過時間イベント発行間隔を指定している場合。
［コマンド実行］画面および自動アクションから実行要求されたコマンドが，経過時間イベント発行間隔を超えて実行している場合。
[ホスト名] コマンド実行の実行時間が数値秒を超えました

00003FA5※1
jcocmddefコマンドでコマンド先行入力数のしきい値が設定されている場合。自動アクションの先行入力数がしきい値に達した場合。
実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が閾値[xx件]を超えました

00003FA6※1
jcocmddefコマンドでコマンド先行入力数のしきい値が設定されている場合。自動アクションの先行入力数が0になった場合。
実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が0件になりました

00004700※2
認証サーバが閉塞状態になった場合
接続順序 : 認証サーバ名を閉塞状態に設定しました

00004701※2
認証サーバの閉塞状態が解除された場合
接続順序 : 認証サーバ名の閉塞状態を解除しました

00004702※2
全認証サーバが閉塞状態になった場合
全ての認証サーバが閉塞しました

00004720※2
プロセスが異常終了した場合
コンポーネント名 の管理対象プロセス名 は異常終了しました

00004721※2
プロセス起動時にタイムアウトした場合
コンポーネント名 のプロセス名 の起動がタイムアウトしました. 処理を継続します

00004722※2
異常終了したプロセスの再起動が完了した場合
コンポーネント名 の管理対象プロセス名 の再起動が完了しました

00004724※5
JP1/Baseの起動が完了した場合
ホスト名 のJP1/Baseを起動しました

00004725※5
JP1/Baseを停止する場合
ホスト名 のJP1/Baseを停止します

00004740
監視対象プロセスが異常終了した場合
機能名 が異常終了しました

00004741
監視対象プロセスが共有メモリーに一定期間アクセス（更新）しなくなった場合（重大度：Error）
機能名 が処理中のままnn秒経過しています

00004742
監視対象プロセスが共有メモリーに一定期間アクセス（更新）しなくなった場合（重大度：Warning）
機能名 が処理中のままnn秒経過しています． mm秒経過後にエラー状態になります

00004743
共有メモリーに一定期間アクセス（更新）していなかった監視対象プロセスが回復した場合
機能名 の正常状態が確認されました

00004747
ヘルスチェック機能が異常終了した場合
エラーが発生したため，ヘルスチェック機能を終了します

00004748
他ホスト監視中に異常を検知した場合（サービスが機能していない）
ホスト名 の サービス名 が機能していないため監視通知が出来ない状態です

00004749
他ホスト監視中に異常を検知した場合（ホストに接続できない）
ホスト名 に接続できないため監視ができません

0000474A
他ホストを監視できるようになった場合。
停止中の監視対象ホストが起動した場合。
ホスト名 の監視が可能になりました

0000474B
共有メモリーが参照できない場合
共有メモリーがロックされています

0000474C
監視対象ホストが停止した場合
ホスト名 が停止中のため監視しません

0000474D
監視対象ホストが停止しているのか異常なのかの区別がつかない場合
停止通知を受けていない ホスト名 に接続できないため監視できません

00002102※3
UNIXの場合，次のどちらかの契機で出力されます。

JP1/SES互換機能が有効な状態でイベントサービスが起動したとき

リモートホストのJP1/SESまたはJP1/AJSのイベントサービスから接続されたとき

なし

00002103※3
UNIXの場合，次のどれかの契機で出力されます。

JP1/SES互換機能が有効な状態でイベントサービスが起動したとき

リモートホストのJP1/SESまたはJP1/AJSのイベントサービスから接続されたとき

リモートホストのJP1/SESまたはJP1/AJSのイベントサービスへ接続するとき

Windowsの場合，次のどちらかの契機で出力されます。

リモートホストのJP1/SESまたはJP1/AJSのイベントサービスから接続されたとき

リモートホストのJP1/SESまたはJP1/AJSのイベントサービスへ接続するとき

なし

00002104※3
UNIXの場合，次のどちらかの契機で出力されます。

JP1/SES互換機能が有効な状態でイベントサービスを停止するとき

接続されているリモートホストのJP1/SESまたはJP1/AJSのイベントサービスが停止したとき

プロセスの機能名称

00010B7F※3
WindowsまたはUNIXの場合，リモートホストのJP1/AJSのイベントサービスから接続されたとき
なし

00004780
アクション実行の開始要求を受け付けたとき，JP1イベント（アクション開始イベント）を登録したとき
アクション実行の開始要求を受け付けました（アクション実行情報）

00004781
コマンドを実行して完了した場合，JP1イベント（アクション完了イベント）を登録したとき
アクション実行が完了しました（アクション実行情報）

00004782
コマンドを実行できないで完了した場合，JP1イベント（アクション完了イベント（実行不可））を登録したとき
アクションが実行できずに完了しました（アクション実行情報）

00004783
アクションがキャンセルされて完了した場合，JP1イベント（アクション完了イベント（キャンセル））を登録したとき
アクションがキャンセルされて完了しました（アクション実行情報）

注※1　JP1/IM - Manager用にjcocmddefコマンドを使って設定した場合にだけ，発行されるJP1イベントです。設定の詳細については，「13.　コマンド」の「jcocmddef」を参照してください。

注※2　認証サーバの閉塞状態の変更時，またはプロセスの異常終了時にJP1イベントを発行させる設定をした場合にだけ発行されます。認証サーバの閉塞状態，またはプロセスの異常をJP1イベントで監視したい場合は，「2.4.3(2)　プロセスの異常終了および認証サーバの切り替え発生を検知する」を参照してください。

注※3　JP1/SES互換機能のJP1イベントには重大度がありませんが，Informationと同じレベルのため，この通知に対する対処は不要です。

注※4　ログファイルトラップ，またはJP1/AJSのログ監視ジョブが発行します。

注※5　イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されるJP1イベントです。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

15.3　JP1イベントの詳細

JP1イベントの詳細をイベントID別に示します。

＜この節の構成＞

(1)　イベントID：00003D00の詳細

(2)　イベントID：00003D04の詳細

(3)　イベントID：00003A10の詳細

(4)　イベントID：00003A20の詳細

(5)　イベントID：00003A21の詳細

(6)　イベントID：00003A22の詳細

(7)　イベントID：00003A30の詳細

(8)　イベントID：00003A31の詳細

(9)　イベントID：00003A32の詳細

(10)　イベントID：00003A71の詳細

(11)　イベントID：00003A73の詳細

(12)　イベントID：00003A74の詳細

(13)　動作定義ファイルのACTDEFパラメーターで指定されたイベントIDの詳細

(14)　イベントID：00003FA0の詳細

(15)　イベントID：00003FA1の詳細

(16)　イベントID：00003FA2の詳細

(17)　イベントID：00003FA3の詳細

(18)　イベントID：00003FA5の詳細

(19)　イベントID：00003FA6の詳細

(20)　イベントID：00004700の詳細

(21)　イベントID：00004701の詳細

(22)　イベントID：00004702の詳細

(23)　イベントID：00004720の詳細

(24)　イベントID：00004721の詳細

(25)　イベントID：00004722の詳細

(26)　イベントID：00004724の詳細

(27)　イベントID：00004725の詳細

(28)　イベントID：00004740の詳細

(29)　イベントID：00004741の詳細

(30)　イベントID：00004742の詳細

(31)　イベントID：00004743の詳細

(32)　イベントID：00004747の詳細

(33)　イベントID：00004748の詳細

(34)　イベントID：00004749の詳細

(35)　イベントID：0000474Aの詳細

(36)　イベントID：0000474Bの詳細

(37)　イベントID：0000474Cの詳細

(38)　イベントID：0000474Dの詳細

(39)　イベントID：00002102の詳細

(40)　イベントID：00002103の詳細

(41)　イベントID：00002104の詳細

(42)　イベントID：00010B7Fの詳細

(43)　イベントID：00004780の詳細

(44)　イベントID：00004781の詳細

(45)　イベントID：00004782の詳細

(46)　イベントID：00004783の詳細

(1)　イベントID：00003D00の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003D00
メッセージ | － | イベントDBを旧DB番号から新DB番号に切り替えました
詳細情報 | － | 旧イベントDB番号
拡張属性 | 共通情報 | 重大度 | SEVERITY | Notice
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM
オブジェクトタイプ | OBJECT_TYPE | EVENTDB
オブジェクト名 | OBJECT_NAME | 旧イベントDB番号
オブジェクトID | OBJECT_ID | イベントサーバ名:旧DB番号
事象種別 | OCCURRENCE | SWITCH
固有情報 | 旧イベントDB番号 | E0 | 旧イベントDB番号

（凡例）

－：なし

(2)　イベントID：00003D04の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003D04
メッセージ | － | イベントサービスは内部機能の再起動により回復しました。
拡張属性 | 共通情報 | 重大度 | SEVERITY | Notice
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM
オブジェクトタイプ | OBJECT_TYPE | EVENT
オブジェクト名 | OBJECT_NAME | jevservice
事象種別 | OCCURRENCE | NOTICE

（凡例）

－：なし

(3)　イベントID：00003A10の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A10

メッセージ
－
KAVA3640-W ログファイルトラップのリトライが行われたため，イベント発行が遅延しました。(ID=ID番号[監視名])

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
jevlogstart

オブジェクトID
OBJECT_ID
リトライ処理をしたログファイルトラップのID番号

事象種別
OCCURRENCE
RECONNECT

固有情報
リトライ開始時刻
RETRY_START_TIME
リトライ処理が開始された時刻（UTC 1970-01-01 00:00:00からの秒数）

再接続時刻
RECONNECT_TIME
イベントサービスへ再接続が確認できた時刻（UTC 1970-01-01 00:00:00からの秒数）

保留イベント数
HOLD_EVENT
リトライ処理中に保留されたJP1イベントの件数

消去イベント数
DELETE_EVENT
リトライ処理中に消去されたJP1イベントの件数

（凡例）

－：なし

(4)　イベントID：00003A20の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A20

メッセージ
－
KAVA3643-E 該当ログファイルの監視を開始出来ません (code=エラー番号, file name=ログファイル名)

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

プロダクト名
PRODUCT_NAME
Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
監視ログファイル（パス）名

オブジェクトID
OBJECT_ID
ログファイルトラップのID番号

事象種別
OCCURRENCE
NOTICE

固有情報
監視停止時刻
WATCH_STOP_TIME
ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

（凡例）

－：なし

(5)　イベントID：00003A21の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A21

メッセージ
－
KAVA3644-E 指定された回数リトライ処理を行いましたが，該当ログファイルの読み込みが出来ないため監視を停止します (code=エラー番号, file name=ログファイル名)

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

プロダクト名
PRODUCT_NAME
Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
監視ログファイル（パス）名

オブジェクトID
OBJECT_ID
ログファイルトラップのID番号

事象種別
OCCURRENCE
NOTICE

固有情報
監視停止時刻
WATCH_STOP_TIME
ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

（凡例）

－：なし

(6)　イベントID：00003A22の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A22

メッセージ
－
KAVA3645-E 該当ログファイルを正しく監視することができない状態になりました (code=数値, file name=ログファイル名)

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

プロダクト名
PRODUCT_NAME
Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合
/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
監視ログファイル（パス）名

オブジェクトID
OBJECT_ID
ログファイルトラップのID番号

事象種別
OCCURRENCE
NOTICE

固有情報
異常検知時刻
WATCH_CHECK_TIME
ログファイルの異常を検知した時刻（UTC 1970-01-01 00:00:00からの秒数）

（凡例）

－：なし

(7)　イベントID：00003A30の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A30

メッセージ
－
KAVA3909-W 前回停止時から今回起動時までのログのJP1イベントが登録されていないおそれがあります(接続先=イベントサーバ名,監視先=監視先,監視名=監視名)

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
Windowsの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合
/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME

ログ監視の場合：

jelallog

イベントログ監視の場合：

jelalelt

オブジェクトID
OBJECT_ID
問題を検出したリモート監視のID番号

事象種別
OCCURRENCE
NOTICE

固有情報
監視対象ホスト名
MONITOR_HOST
監視対象ホスト名

監視名
MONITOR_NAME
監視名

（凡例）

－：なし

(8)　イベントID：00003A31の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A31

メッセージ
－
KAVA3910-E 続行不可能なエラーが発生したためリモート監視を停止します(event server = イベントサーバ名,target host = 監視先,monitor name = 監視名)

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

プロダクト名
PRODUCT_NAME
Windowsの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合
/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME

ログ監視の場合：

jelallog

イベントログ監視の場合：

jelalelt

オブジェクトID
OBJECT_ID
異常終了するリモート監視のID番号

事象種別
OCCURRENCE
NOTICE

固有情報
監視対象ホスト名
MONITOR_HOST
監視対象ホスト名

監視名
MONITOR_NAME
監視名

（凡例）

－：なし

(9)　イベントID：00003A32の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A32

メッセージ
－
KAVA3915-W リモート監視のリトライが行われたため、イベント発行が遅延しました (接続先=イベントサーバ名, 監視先=監視対象ホスト名, 監視名=監視名)

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
Windowsの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合
/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME

ログ監視の場合：

jelallog

イベントログ監視の場合：

jelalelt

オブジェクトID
OBJECT_ID
リトライ処理をしたリモート監視のID番号

事象種別
OCCURRENCE
RECONNECT

固有情報
監視対象ホスト名
MONITOR_HOST
監視対象ホスト名

監視名
MONITOR_NAME
監視名

リトライ開始時刻
RETRY_START_TIME
リトライ処理が開始された時刻
（UTC 1970-01-01 00:00:00からの秒数）

再接続時刻
RECONNECT_TIME
イベントサービスへ再接続が確認できた時刻
（UTC 1970-01-01 00:00:00からの秒数）

保留イベント数
HOLD_EVENT
リトライ処理中に保留されたJP1イベントの件数

削除イベント数
DELETE_EVENT
リトライ処理中に消去されたJP1イベントの件数

（凡例）

－：なし

(10)　イベントID：00003A71の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A71

メッセージ
－
Windowsイベントログのメッセージ。※1
最大1,023バイト。超えた分は切り捨て。

拡張属性
共通情報
重大度
SEVERITY
Windowsログの種別に応じて登録する。

Windows VistaおよびWindows Server 2008の場合

値：ログ種別

Critical：重大

Error：エラー

Warning：警告

Information：情報，詳細，その他

Notice：監査成功，監査失敗

Windows VistaおよびWindows Server 2008以外の場合

値：ログ種別

Error：エラー

Warning：警告

Information：情報，その他

Notice：監査成功，監査失敗

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/NTEVENT_LOGTRAP/ソース

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
NTEVENTLOG

登録名タイプ
ROOT_OBJECT_
TYPE
LOGFILE

登録名
ROOT_OBJECT_
NAME
NTEVENTLOG

固有情報
Windowsログ登録日時
A0
time_t型（UTC 1970-01-01 00:00:00からの秒数）

コンピュータ名
A1
コンピュータ名

NTログ種別
A2

Windows VistaおよびWindows Server 2008の場合

System/Security/Application/Setup/Directory Service/DNS Server/File Replication Service/Internet Explorer/Key Management Service/HardwareEvents

その他，イベントビューアの"ログの名前"に表示される内容。

Windows VistaおよびWindows Server 2008以外の場合

System/Security/Application/Directory Service/DNS Server/File Replication Service

NTログ種類
A3

Windows VistaおよびWindows Server 2008の場合

Critical/Error/Warning/Information/Verbose/Audit_Success/Audit_Failure

その他，イベントビューアの"レベル"に表示される内容。

Windows VistaおよびWindows Server 2008以外の場合

Error/Warning/Information/Audit_Success/Audit_Failure

上記以外：None

セキュリティログの場合，イベントビューアの"キーワード"に表示される内容。

NTログ分類
A4
分類。
分類できなかった場合：None
Windows VistaまたはWindows Server 2008の場合はイベントビューアの"タスクのカテゴリ"に表示される内容。

NTイベントID
A5
WindowsのイベントID

NTユーザー名
A6
Windowsのユーザー名。
ユーザー名がわからなかった場合：N/A

NTログレベル※2
A7
レベル。
イベントビューアの"レベル"に表示される内容。
最大256バイト。超えた分は切り捨て。

NTログキーワード※2
A8
キーワード。
イベントビューアの"キーワード"に表示される内容。
最大256バイト。超えた分は切り捨て。

NTログオペコード※2
A9
オペコード。
イベントビューアの"オペコード"に表示される内容。
最大256バイト。超えた分は切り捨て。

プラットフォーム
PLATFORM
NT

PP名
PPNAME

リモート監視のイベントログトラップの場合

/HITACHI/JP1/IM/REMOTE_MONITORING/EVENTLOGTRAP

JP1/Baseのイベントログトラップの場合

/HITACHI/JP1/NTEVENT_LOGTRAP

Windowsバージョン番号※2
OS_VERSION
Windowsメジャーバージョン番号

（凡例）

－：なし

注※1　イベントログの説明文を記載したメッセージDLLが正しく設定されていない場合は，挿入句や詳細コードをダブルクォーテーションマーク（"）で囲んでJP1イベントのメッセージに登録します。

注※2　Windows VistaおよびWindows Server 2008の場合に，イベントログトラップ動作定義ファイルにext-attr-optionパラメーターを指定すると作成される情報です。ext-attr-optionパラメーターを指定しない場合は作成されません。

(11)　イベントID：00003A73の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A73

メッセージ
－
KAVA3030-W イベントログの取得に失敗しました。(function=機能, code=要因コード, log=ログ種別)

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/NTEVENT_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
NTEVENTLOG

固有情報
エラー検知時刻
ERROR_TIME
エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

ログ種別
LOG_TYPE
エラーの発生したWindowsログ種別
System/Security/Application/Directory Service/DNS Server/File Replication Service

エラー発生API名
ERROR_FUNCTION
エラーの発生したWindowsのAPI名

エラー要因
ERROR_CAUSE_ID
エラー要因コード

（凡例）

－：なし

(12)　イベントID：00003A74の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003A74

メッセージ
－
KAVA3031-I イベントログの監視が可能になりました。(log=ログ種別)

拡張属性
共通情報
重大度
SEVERITY
Information

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/NTEVENT_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
NTEVENTLOG

固有情報
回復時刻
RECOVER_TIME
エラーから回復した時刻（UTC 1970-01-01 00:00:00からの秒数）

ログ種別
LOG_TYPE
エラーの発生したWindowsログ種別
System/Security/Application/Directory Service/DNS Server/File Replication Service

（凡例）

－：なし

(13)　動作定義ファイルのACTDEFパラメーターで指定されたイベントIDの詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
ACTDEFパラメーターに指定されている値

メッセージ
－
ログファイル1行分のログデータの内容

拡張属性
共通情報
重大度
SEVERITY
動作定義ファイルのACTDEFパラメーターで指定された重大度

プロダクト名
PRODUCT_NAME
Windowsの場合：

jevlogstartコマンド，またはJP1/IMの［プロファイル表示/編集］画面の追加オプションに，-pオプションを指定した場合
/HITACHI/JP1/NT_LOGTRAP/プログラム名
プログラム名は-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンド，またはJP1/IMの［プロファイル表示/編集］画面の追加オプションに，-pオプションを指定していない場合
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンド，またはJP1/IMの［プロファイル表示/編集］画面の追加オプションに，-pオプションを指定した場合
/HITACHI/JP1/UX_LOGTRAP/プログラム名
プログラム名は-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンド，またはJP1/IMの［プロファイル表示/編集］画面の追加オプションに，-pオプションを指定していない場合
/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ
OBJECT_TYPE
LOGFILE

オブジェクト名
OBJECT_NAME
起動コマンドのオプションで指定したログファイル名

登録名タイプ
ROOT_OBJECT_
TYPE
LOGFILE

登録名
ROOT_OBJECT_
NAME
起動コマンドのオプションで指定したログファイル名

固有情報
プラットフォーム
PLATFORM
Windowsの場合：NT
UNIXの場合：UNIX

PP名
PPNAME

リモート監視のログファイルトラップの場合

/HITACHI/JP1/IM/REMOTE_MONITORING/LOGTRAP

JP1/Baseのログファイルトラップの場合

Windowsの場合：
/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：
/HITACHI/JP1/UX_LOGTRAP

ホスト名
JP1_SOURCEHOST
ログの発生元ホスト名

（凡例）

－：なし

(14)　イベントID：00003FA0の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FA0
メッセージ | － | KAVB2100-I [ホスト名 : JP1ユーザー名] コマンド実行を開始しました。
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM
オブジェクトタイプ | OBJECT_TYPE | COMMAND
オブジェクト名 | OBJECT_NAME | JCOCMD
事象種別 | OCCURRENCE | NOTICE
ユーザー名 | USER_NAME | コマンドを実行するJP1ユーザー名
開始時刻 | START_TIME | コマンド実行要求受付時刻
固有情報 | 実行先ホスト | EXECHOST | コマンド実行先ホスト名
実行コマンド | EXECCMD | 実行するコマンド名
環境変数ファイル名 | EXECENV | 実行時に使用する環境変数ファイル名

（凡例）

－：なし

(15)　イベントID：00003FA1の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FA1
メッセージ | － | KAVB2101-I [ホスト名 : JP1ユーザー名] コマンド実行が終了しました。
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM/JCOCMD
オブジェクトタイプ | OBJECT_TYPE | COMMAND
オブジェクト名 | OBJECT_NAME | JCOCMD
事象種別 | OCCURRENCE | NOTICE
ユーザー名 | USER_NAME | コマンドを実行するJP1ユーザー名
終了時刻 | END_TIME | コマンド終了時刻
終了コード | RESULT_CODE | 実行したコマンドのリターンコード
固有情報 | 実行先ホスト | EXECHOST | コマンド実行先ホスト名
実行コマンド | EXECCMD | 実行したコマンド名

（凡例）

－：なし

(16)　イベントID：00003FA2の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FA2
メッセージ | － | KAVB2102-E [ホスト名 : JP1ユーザー名] コマンド実行が異常終了しました。
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM/JCOCMD
オブジェクトタイプ | OBJECT_TYPE | COMMAND
オブジェクト名 | OBJECT_NAME | JCOCMD
事象種別 | OCCURRENCE | NOTICE
ユーザー名 | USER_NAME | コマンドを実行するJP1ユーザー名
終了時刻 | END_TIME | コマンド異常終了時刻

（凡例）

－：なし

(17)　イベントID：00003FA3の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00003FA3

メッセージ
－
KAVB2402-W [ホスト名] コマンド実行の実行時間が数値秒を超えました

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/JCOCMD

オブジェクトタイプ
OBJECT_TYPE

COMMAND（［コマンド実行］画面の場合）

ACTION（自動アクションの場合）

オブジェクト名
OBJECT_NAME
JCOCMD

事象種別
OCCURRENCE
NOTICE

ユーザー名
USER_NAME
コマンドを実行するJP1ユーザー名

開始時刻
START_TIME
コマンド実行要求受付時刻

固有情報
実行先ホスト
EXECHOST
コマンド実行先ホスト名

実行コマンド
EXECCMD
実行するコマンド名

投入元ホスト
REQUESTHOST
コマンドを投入したホスト名

コマンドID
COMMANDID
コマンドID

実行時間
EXEC_TIME
コマンドの実行経過時間

（凡例）

－：なし

(18)　イベントID：00003FA5の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FA5
メッセージ | － | KAVB2071-W 実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が閾値[xx件]を超えました。
拡張属性 | 共通情報 | 重大度 | SEVERITY | Warning
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM/JCOCMD
オブジェクトタイプ | OBJECT_TYPE | ACTION
オブジェクト名 | OBJECT_NAME | JCOCMD
事象種別 | OCCURRENCE | NOTICE
ユーザー名 | USER_NAME | コマンドを実行するJP1ユーザー名
開始時刻 | START_TIME | コマンド実行要求受付時刻
固有情報 | 実行先ホスト | EXECHOST | コマンド実行先ホスト名
投入元ホスト | REQUESTHOST | コマンドを投入したホスト名

（凡例）

－：なし

(19)　イベントID：00003FA6の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00003FA6
メッセージ | － | KAVB2072-I実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が0件になりました。
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/IM/JCOCMD
オブジェクトタイプ | OBJECT_TYPE | ACTION
オブジェクト名 | OBJECT_NAME | JCOCMD
事象種別 | OCCURRENCE | NOTICE
ユーザー名 | USER_NAME | コマンドを実行するJP1ユーザー名
開始時刻 | START_TIME | コマンド実行要求受付時刻
固有情報 | 実行先ホスト | EXECHOST | コマンド実行先ホスト名
投入元ホスト | REQUESTHOST | コマンドを投入したホスト名

（凡例）

－：なし

(20)　イベントID：00004700の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00004700

メッセージ
－
KAVA1524-W 接続順序: 認証サーバ名 was successfully blocked.
KAVA1524-W接続順序 : 認証サーバ名を閉塞状態に設定しました.

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/BASE/JBSSESS

オブジェクトタイプ
OBJECT_TYPE
SESSION

オブジェクト名
OBJECT_NAME
認証サーバを閉塞したホスト名

事象種別
OCCURRENCE
NOTICE

固有情報
接続失敗先ホスト名
AUTHSRV_NAME
閉塞された認証サーバ名

（凡例）

－：なし

(21)　イベントID：00004701の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00004701

メッセージ
－
KAVA1525-I 接続順序: 認証サーバ名 was successfully unblocked.
KAVA1525-I 接続順序 : 認証サーバ名の閉塞状態を解除しました

拡張属性
共通情報
重大度
SEVERITY
Information

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/BASE/JBSSESS

オブジェクトタイプ
OBJECT_TYPE
SESSION

オブジェクト名
OBJECT_NAME
認証サーバの閉塞を解除したホスト名

事象種別
OCCURRENCE
NOTICE

固有情報
接続失敗先ホスト名
AUTHSRV_NAME
閉塞解除された認証サーバ名

（凡例）

－：なし

(22)　イベントID：00004702の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00004702

メッセージ
－
KAVA1396-E All authentication servers were blocked.
KAVA1396-E 全ての認証サーバが閉塞しました

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

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/BASE/JBSSESS

オブジェクトタイプ
OBJECT_TYPE
SESSION

オブジェクト名
OBJECT_NAME
すべての認証サーバへの接続が閉塞したホスト名

事象種別
OCCURRENCE
NOTICE

（凡例）

－：なし

(23)　イベントID：00004720の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00004720

メッセージ
－
KAVB3737-E The コンポーネント名 管理対象プロセス名 terminated abnormally
KAVB3737-E コンポーネント名 の管理対象プロセス名 は異常終了しました

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

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/BASE/SPMD

オブジェクトタイプ
OBJECT_TYPE
SPMD

オブジェクト名
OBJECT_NAME
異常終了したプロセス名

事象種別
OCCURRENCE
NOTICE

（凡例）

－：なし

(24)　イベントID：00004721の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00004721

メッセージ
－
KAVB3613-W コンポーネント名 timeout occurred in 管理対象プロセス名. Processing continues.
KAVB3613-Wコンポーネント名 のプロセス名 の起動がタイムアウトしました. 処理を継続します

拡張属性
共通情報
重大度
SEVERITY
Warning

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/BASE/SPMD

オブジェクトタイプ
OBJECT_TYPE
SPMD

オブジェクト名
OBJECT_NAME
起動タイムアウトしたプロセス名

事象種別
OCCURRENCE
NOTICE

（凡例）

－：なし

(25)　イベントID：00004722の詳細

属性種別
項目
属性名
内容

基本属性
イベントID
－
00004722

メッセージ
－
KAVB3616-I Restart of the コンポーネント名 管理対象プロセス名 has finished.
KAVB3616-I コンポーネント名 の管理対象プロセス名 の再起動が完了しました

拡張属性
共通情報
重大度
SEVERITY
Information

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/BASE/SPMD

オブジェクトタイプ
OBJECT_TYPE
SPMD

オブジェクト名
OBJECT_NAME
再起動したプロセス名

事象種別
OCCURRENCE
NOTICE

（凡例）

－：なし

(26)　イベントID：00004724の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004724
メッセージ | － | KAVB3664-I ホスト名 のJP1/Baseを起動しました
拡張属性 | 共通情報 | 重大度 | SEVERITY | Notice
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/SPMD
オブジェクトタイプ | OBJECT_TYPE | SPMD
オブジェクト名 | OBJECT_NAME | 起動したホスト名
事象種別 | OCCURRENCE | NOTICE

（凡例）

－：なし

注　このイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されます。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

(27)　イベントID：00004725の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004725
メッセージ | － | KAVB3665-I ホスト名 のJP1/Baseを停止します
拡張属性 | 共通情報 | 重大度 | SEVERITY | Notice
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/SPMD
オブジェクトタイプ | OBJECT_TYPE | SPMD
オブジェクト名 | OBJECT_NAME | 停止するホスト名
事象種別 | OCCURRENCE | NOTICE

（凡例）

－：なし

注　このイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されます。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

(28)　イベントID：00004740の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004740
メッセージ | － | KAVA7017-E 機能名 が異常終了しました. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | 異常終了した機能名
事象種別 | OCCURRENCE | NOTICE
固有情報 | ホスト名 | HOST_NAME | ホスト名
プロセス名 | PROCESS_NAME | プロセス名
内部機能名 | SFUNCTION_NAME | 内部機能名
プロセスID | PROCESS_ID | プロセスID
スレッドID | THREAD_ID | スレッドID

（凡例）

－：なし

(29)　イベントID：00004741の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004741
メッセージ | － | KAVA7014-E 機能名 が処理中のままnn秒経過しています. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | 機能名
事象種別 | OCCURRENCE | NOTICE
固有情報 | ホスト名 | HOST_NAME | ホスト名
プロセス名 | PROCESS_NAME | プロセス名
内部機能名 | SFUNCTION_NAME | 内部機能名
プロセスID | PROCESS_ID | プロセスID
スレッドID | THREAD_ID | スレッドID

（凡例）

－：なし

(30)　イベントID：00004742の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004742
メッセージ | － | KAVA7013-W 機能名 が処理中のままnn秒経過しています. mm秒経過後にエラー状態になります． (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)
拡張属性 | 共通情報 | 重大度 | SEVERITY | Warning
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | 機能名
事象種別 | OCCURRENCE | NOTICE
固有情報 | ホスト名 | HOST_NAME | ホスト名
プロセス名 | PROCESS_NAME | プロセス名
内部機能名 | SFUNCTION_NAME | 内部機能名
プロセスID | PROCESS_ID | プロセスID
スレッドID | THREAD_ID | スレッドID

（凡例）

－：なし

(31)　イベントID：00004743の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004743
メッセージ | － | KAVA7016-I 機能名 の正常状態が確認されました. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | 機能名
事象種別 | OCCURRENCE | NOTICE
固有情報 | ホスト名 | HOST_NAME | ホスト名
プロセス名 | PROCESS_NAME | プロセス名
内部機能名 | SFUNCTION_NAME | 内部機能名
プロセスID | PROCESS_ID | プロセスID
スレッドID | THREAD_ID | スレッドID

（凡例）

－：なし

(32)　イベントID：00004747の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004747
メッセージ | － | KAVA7003-E エラーが発生したため，ヘルスチェック機能を終了します. (ホスト名=ホスト名)
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | ホスト名
事象種別 | OCCURRENCE | NOTICE

（凡例）

－：なし

(33)　イベントID：00004748の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004748
メッセージ | － | KAVA7222-E ホスト名 の サービス名 が機能していないため監視通知が出来ない状態です.
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | ホスト名
事象種別 | OCCURRENCE | NOTICE
固有情報 | サービス名 | SERVICE_NAME | サービス名

（凡例）

－：なし

(34)　イベントID：00004749の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004749
メッセージ | － | KAVA7223-E ホスト名 に接続できないため監視ができません.
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | ホスト名
事象種別 | OCCURRENCE | NOTICE

（凡例）

－：なし

(35)　イベントID：0000474Aの詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 0000474A
メッセージ | － | KAVA7224-I ホスト名 の監視が可能になりました.
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | ホスト名
事象種別 | OCCURRENCE | NOTICE

（凡例）

－：なし

(36)　イベントID：0000474Bの詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 0000474B
メッセージ | － | KAVA7030-E 共有メモリーがロックされています. (ホスト名=ホスト名, プロセス名=プロセス名, 機能名=機能名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | 機能名
事象種別 | OCCURRENCE | NOTICE
固有情報 | ホスト名 | HOST_NAME | ホスト名
プロセス名 | PROCESS_NAME | プロセス名
内部機能名 | SFUNCTION_NAME | 内部機能名
プロセスID | PROCESS_ID | プロセスID
スレッドID | THREAD_ID | スレッドID

（凡例）

－：なし

(37)　イベントID：0000474Cの詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 0000474C
メッセージ | － | KAVA7228-I ホスト名 が停止中のため監視しません
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | 監視しないホスト名
事象種別 | OCCURRENCE | NOTICE

（凡例）

－：なし

(38)　イベントID：0000474Dの詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 0000474D
メッセージ | － | KAVA7229-W 停止通知を受けていない ホスト名 に接続できないため監視ができません
拡張属性 | 共通情報 | 重大度 | SEVERITY | Warning
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/JBSHC
オブジェクトタイプ | OBJECT_TYPE | JBSHC
オブジェクト名 | OBJECT_NAME | 監視できないホスト名
事象種別 | OCCURRENCE | NOTICE

（凡例）

－：なし

(39)　イベントID：00002102の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00002102
メッセージ | － | －
詳細情報 | － | －

（凡例）

－：なし

(40)　イベントID：00002103の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00002103
メッセージ | － | －
詳細情報 | － | －

（凡例）

－：なし

(41)　イベントID：00002104の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00002104
メッセージ | － | プロセスの機能名称
詳細情報 | － | －

（凡例）

－：なし

(42)　イベントID：00010B7Fの詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00010B7F
メッセージ | － | －
詳細情報 | － | －

（凡例）

－：なし

(43)　イベントID：00004780の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004780
メッセージ | － | KNAM3203-I アクション実行の開始要求を受け付けました（アクション実行情報）
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/LOCAL_ACTION
オブジェクトタイプ | OBJECT_TYPE | ACTION
オブジェクト名 | OBJECT_NAME | LOCAL ACTION
オブジェクトID | OBJECT_ID | アクション名
ユーザー名 | USER_NAME | JP1ユーザー名
開始時刻 | START_TIME | アクション実行の開始時刻
事象種別 | OCCURRENCE | NOTICE
固有情報 | アクションイベント通番 | ACT_EVENT_SEQ | アクションの契機となったJP1イベントの通し番号
アクションイベントID | ACT_EVENT_ID | アクションの契機となったJP1イベントID
環境変数ファイル名 | EXECENV | 実行時に使用する環境変数ファイル名※
実行コマンド | EXECCMD | 実行するコマンド名（属性変数展開後）

（凡例）

－：なし

注※　未使用時は空文字が設定されます。

(44)　イベントID：00004781の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004781
メッセージ | － | KNAM3210-I アクション実行が完了しました（アクション実行情報）
拡張属性 | 共通情報 | 重大度 | SEVERITY | Information
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/LOCAL_ACTION
オブジェクトタイプ | OBJECT_TYPE | ACTION
オブジェクト名 | OBJECT_NAME | LOCAL ACTION
オブジェクトID | OBJECT_ID | アクション名
ユーザー名 | USER_NAME | JP1ユーザー名
開始時刻 | START_TIME | アクション実行の開始時刻
終了時刻 | END_TIME | アクション実行の終了時刻
終了コード | RESULT_CODE | アクションで実行したコマンドの終了コード
事象種別 | OCCURRENCE | NOTICE
固有情報 | アクションイベント通番 | ACT_EVENT_SEQ | アクションの契機となったJP1イベントの通し番号
アクションイベントID | ACT_EVENT_ID | アクションの契機となったJP1イベントID
プロセスID | EXEC_PID | 実行したプロセスID/スレッドID※
OSユーザー名 | EXEC_USER | 実行したOSユーザー名※
環境変数ファイル名 | EXECENV | 実行時に使用する環境変数ファイル名※
実行コマンド | EXECCMD | 実行したコマンド名（属性変数展開後）

（凡例）

－：なし

注※　未使用時は空文字が設定されます。

(45)　イベントID：00004782の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004782
メッセージ | － | KNAM3211-E アクションが実行できずに完了しました（アクション実行情報）
拡張属性 | 共通情報 | 重大度 | SEVERITY | Error
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/LOCAL_ACTION
オブジェクトタイプ | OBJECT_TYPE | ACTION
オブジェクト名 | OBJECT_NAME | LOCAL ACTION
オブジェクトID | OBJECT_ID | アクション名
ユーザー名 | USER_NAME | JP1ユーザー名
開始時刻 | START_TIME | アクション実行の開始時刻
終了時刻 | END_TIME | アクション実行の終了時刻
事象種別 | OCCURRENCE | NOTICE
固有情報 | アクションイベント通番 | ACT_EVENT_SEQ | アクションの契機となったJP1イベントの通し番号
アクションイベントID | ACT_EVENT_ID | アクションの契機となったJP1イベントID
プロセスID | EXEC_PID | 実行したプロセスID/スレッドID※
OSユーザー名 | EXEC_USER | 実行したOSユーザー名※
環境変数ファイル名 | EXECENV | 実行時に使用する環境変数ファイル名※
実行コマンド | EXECCMD | 実行するコマンド名（属性変数展開後）
エラーコード | ERR_CODE | 実行できなかった要因のエラー番号

（凡例）

－：なし

注※　未使用時や定まっていない場合は空文字が設定されます。

(46)　イベントID：00004783の詳細

属性種別 | 項目 | 属性名 | 内容
基本属性 | イベントID | － | 00004783
メッセージ | － | KNAM3212-W アクションがキャンセルされて完了しました（アクション実行情報）
拡張属性 | 共通情報 | 重大度 | SEVERITY | Warning
プロダクト名 | PRODUCT_NAME | /HITACHI/JP1/BASE/LOCAL_ACTION
オブジェクトタイプ | OBJECT_TYPE | ACTION
オブジェクト名 | OBJECT_NAME | LOCAL ACTION
オブジェクトID | OBJECT_ID | アクション名
ユーザー名 | USER_NAME | JP1ユーザー名
開始時刻 | START_TIME | アクション実行の開始時刻
終了時刻 | END_TIME | アクション実行の終了時刻
事象種別 | OCCURRENCE | NOTICE
固有情報 | アクションイベント通番 | ACT_EVENT_SEQ | アクションの契機となったJP1イベントの通し番号
アクションイベントID | ACT_EVENT_ID | アクションの契機となったJP1イベントID
プロセスID | EXEC_PID | 実行したプロセスID/スレッドID※
OSユーザー名 | EXEC_USER | 実行したOSユーザー名※
環境変数ファイル名 | EXECENV | 実行時に使用する環境変数ファイル名※
実行コマンド | EXECCMD | 実行するコマンド名（属性変数展開後）

（凡例）

－：なし

注※　未使用時や定まっていない場合は空文字が設定されます。

16.　トラブルシューティング

この章では，JP1/Baseでトラブルの原因になりやすい項目やトラブルへの対処方法などについて説明します。

＜この章の構成＞

16.1　対処の手順

16.2　ログ情報の種類

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

16.4　資料の採取方法

16.5　トラブルへの対処方法

16.6　JP1/Base使用上の注意事項

16.1　対処の手順

JP1/Baseでトラブルが起きた場合の対処の手順を次の図に示します。

図16-1　トラブル発生時の対処の手順

16.2　ログ情報の種類

JP1/Baseを運用しているときに出力されるログ情報は4種類あります。

共通メッセージログ

統合トレースログ

プロセス別ログ

操作ログ

この節では4種類のログ情報について説明します。

＜この節の構成＞

16.2.1　共通メッセージログ

16.2.2　統合トレースログ

16.2.3　プロセス別ログ

16.2.4　操作ログ

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

16.2.1　共通メッセージログ

共通メッセージログとは，システム側のトラブルを通知する，システム管理者向けのログ情報のことです。共通メッセージログは，必要最小限のトラブル情報を通知します。

共通メッセージログは，UNIXの場合はsyslog，Windowsの場合はWindowsイベントログに出力されます。

16.2.2　統合トレースログ

統合トレースログとは，各プログラムが出力するトレース情報を，統合トレース機能（HNTRLib2）を通じて，一つの出力先ファイルにまとめて採取するログ情報のことです。共通メッセージログより詳しい内容のメッセージが出力されます。

統合トレースログのデフォルトの出力先は次のとおりです。

Windowsの場合

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2{1|2|3|4}.log

UNIXの場合

/var/opt/hitachi/HNTRLib2/spool/hntr2{1|2|3|4}.log

出力先やログファイルのサイズなどを参照したり，変更したりする場合は，hntr2utilコマンド，hntr2confコマンド，またはhntr2getconfコマンドで実行できます。詳細については，「13.　コマンド」の「hntr2util（Windows限定）」，「hntr2util（UNIX限定）」，「hntr2conf」，または「hntr2getconf」を参照してください。

統合トレースログファイルは，任意のテキストエディターで参照できます。統合トレースログの出力例を次の図に示します。

図16-2　統合トレースログファイルの出力例

統合トレースログファイルに出力されるヘッダー情報と出力項目の説明を次の表に示します。

表16-1　統合トレースログファイルのヘッダー情報

ヘッダー情報
説明

OS情報
統合トレース機能が起動しているOSの情報が出力されます。

ホスト名
統合トレース機能が起動しているホスト名が出力されます。

タイムゾーン

Windowsの場合

OSのタイムゾーンが出力されます。

UNIXの場合

統合トレースプロセスの環境変数TZが出力されます。

環境変数TZが設定されていない場合はUnknownと出力されます。

統合トレースログ機能起動時刻
統合トレース機能を起動した時刻が出力されます。

表16-2　統合トレースログファイルの出力項目

出力項目
説明

番号（4桁）
トレースレコードの通番
番号はログを出力したプロセスごとに採番されます。

日付（10バイト）
トレースの取得日付：yyyy/mm/dd（年/月/日）

時刻（12バイト）
トレースの取得時刻（ローカル時刻）：hh:mm:ss.sss（時:分:秒.ミリ秒）

AP名（16バイト以内）
アプリケーションを識別するための名称（アプリケーション識別名）。

プロセス管理
JBS_SPMD

起動管理
JP1ControlSvc

認証アクセス制御
jp1BsSess

操作権限アクセス制御
jp1BsAcl

認証サーバ
jbssessionmgr

構成管理
jbsroute

コマンド実行（制御プロセス）
jcocmdrouter

コマンド実行（JP1/Base間通信プロセス）
jcocmdcom

コマンド実行（JP1/IM-M,JP1/Base間通信プロセス）
jcocmdapi

コマンド実行（実行制御プロセス）
jcocmdexe

コマンド実行（実行プロセス）
jcocmdcmc

プラグインサービス
jbsplugin

プラグイン（マネージャーコマンド）
jbsrmtcmd

プラグイン（エージェントコマンド）
plAdapter_Event

ヘルスチェック(自ホスト監視用)
jbshcd

ヘルスチェック(他ホスト監視用)
jbshchostd

イベントサービス
jevservice

JP1/AJS互換プロセス
jevsessvc

ログファイルトラップ(Windows)
jevtraplog

ログファイルトラップ(UNIX)
jevlogd

イベントログトラップ
jevtrapevt

SNMPトラップ変換
jp1co_evtgw

その他のコマンド名
コマンド名

pid
プロセスID。OSが付けるプロセスID。

tid
スレッドID。スレッドを識別するためのID。

メッセージID
メッセージの出力形式で説明したメッセージID。この製品で使用するメッセージID。

メッセージテキスト
統合トレースログに出力されるメッセージのテキスト。この製品から出力されるメッセージテキスト。

注意

統合トレースログに出力されるログの時刻は，出力したプロセスのタイムゾーンでフォーマットされます。

このため，環境変数TZを変更したユーザーなどがサービスを起動したり，コマンドを実行したりすると，OSに設定されているタイムゾーンと異なる時刻が出力されることがあります。

16.2.3　プロセス別ログ

プロセス別ログとは，JP1/Baseの各機能が出力するログ情報のことです。各機能によって異なるログファイルに出力されます。出力されるログファイルについては，「16.2.5　ログファイルおよびディレクトリ一覧」を参照してください。

16.2.4　操作ログ

操作ログとは，認証サーバに対して「いつ」「だれが」「何を行ったか」などの操作情報の履歴を出力するログ情報です。操作ログの詳細については，「付録K　操作ログの出力」を参照してください。

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

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

Windows版JP1/Baseが出力するログ情報の種類とデフォルトのログファイルの一覧については，「付録A.1(2)　ログファイル一覧（Windowsの場合）」を参照してください。

(2)　UNIXの場合

UNIX版JP1/Baseが出力するログ情報の種類とデフォルトのログファイルの一覧については，「付録A.2(2)　ログファイル一覧（UNIXの場合）」を参照してください。

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

トラブルが発生したときに採取が必要な資料を示します。なお，JP1/Baseでは採取が必要な資料を一括採取するための「資料採取ツール」を用意しています。資料採取ツールは，Windowsの場合バッチファイル（jbs_log.bat）で，UNIXの場合シェルスクリプト（jbs_log.sh）で提供しています。これら資料採取ツールの詳細については，「13.　コマンド」の「jbs_log.bat（Windows限定）」および「jbs_log.sh（UNIX限定）」を参照してください。

資料採取ツールの初期設定で採取できる資料については，次に示す表中に記号で示しています。

＜この節の構成＞

16.3.1　Windowsの場合

16.3.2　UNIXの場合

16.3.1　Windowsの場合

＜この項の構成＞

(1)　OSのシステム情報

(2)　JP1/Baseの情報

(3)　JP1/Baseのプロセス一覧

(4)　オペレーション内容

(5)　画面上のエラー情報

(6)　ユーザーダンプ（Windows VistaまたはWindows Server 2008の場合）

(7)　問題レポートの採取（Windows VistaまたはWindows Server 2008の場合）

(1)　OSのシステム情報

次に示すOSのログ情報の採取が必要です。これらの情報は資料採取ツールで採取できます。

情報の種類
採取資料
ファイル名※1

資料採取日時
date /tの実行結果
time /tの実行結果
date.log

Windowsイベントログ
アプリケーションログ：
システムフォルダ¥system32¥config¥AppEvent.Evt
システムログ：
システムフォルダ¥system32¥config¥SysEvent.Evt

SysEvent(Backup).evt

AppEvent(Backup).evt

マシンに設定されているホスト名の設定
システムフォルダ¥system32¥drivers¥etc¥hosts
hosts

マシンに設定されているサービスポートの設定
システムフォルダ¥system32¥drivers¥etc¥services
services

NICの実装状況
ipconfig /allの実行結果
ipconfig.log

起動サービス一覧
net startの実行結果
netstart.log

マシンの環境変数
setの実行結果
set.log

ワトソンログファイル※2
ユーザー指定フォルダ¥drwtsn32.log
drwtsn32.log

クラッシュダンプ※2
ユーザー指定フォルダ¥user.dmp
user.dmp

マシンのシステム情報
msinfo32 /report ファイル名の実行結果
msinfo32.log

注※1　資料採取ツールを実行したあとの格納先でのファイル名です。

注※2　あらかじめ出力設定をしておく必要があります。設定方法については，「2.4.3(6)　障害発生時の資料採取の準備（Windows限定）」を参照してください。

(2)　JP1/Baseの情報

JP1/Baseに関する次の情報の採取が必要です。これらの情報は資料採取ツールで採取できます。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

情報の種類
採取資料
ファイル名※1

環境設定情報
インストール先フォルダ¥conf以下のファイル
採取元のファイル名と同じファイル名

インストール先フォルダ¥conf¥default¥以下のファイル
採取元のファイル名と同じファイル名

インストール先フォルダ¥plugin¥conf¥以下のファイル
採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥conf以下のファイル※2
採取元のファイル名と同じファイル名

共通定義情報
jbsgetcnfコマンドの実行結果
jbsgetcnfコマンドで指定したファイル

jbsgetcnf -h論理ホスト名の実行結果※2

ログ情報
インストール先フォルダ¥log¥以下のファイル
採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥log¥以下のファイル※2
採取元のファイル名と同じファイル名

%ALLUSERSPROFILE%¥Hitachi¥jp1¥jp1_default¥JP1Base¥log¥以下のファイル※4※5
採取元のファイル名と同じファイル名

%ALLUSERSPROFILE%¥Hitachi¥jp1¥論理ホスト名¥JP1Base¥log¥以下のファイル※4※5
採取元のファイル名と同じファイル名

インストールログ
Windowsのインストール先フォルダ¥Temp¥HITACHI_JP1_INST_LOG¥jp1base_inst{1|2|3|4|5}.log
採取元のファイル名と同じファイル名

Windows のインストール先フォルダ¥Temp¥jp1common¥jp1base¥hliclib*.log
採取元のファイル名と同じファイル名

サービス稼働情報
インストール先フォルダ¥sys¥OPI¥以下のファイル
採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥sys¥OPI¥以下のファイル
採取元のファイル名と同じファイル名

イベントサービスの設定情報
インストール先フォルダ¥sys¥tmp¥event¥以下のファイル
採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥event¥以下のファイル※2
採取元のファイル名と同じファイル名

イベントDB
インストール先フォルダ¥sys¥event¥以下のファイル※3
採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥event¥以下のファイル※2※3
採取元のファイル名と同じファイル名

コマンド実行履歴
インストール先フォルダ¥log¥COMMAND以下のファイル※3
採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥log¥Command¥以下のファイル※2※3
採取元のファイル名と同じファイル名

統合トレースログ
システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2*.log
採取元のファイル名と同じファイル名

ISAMの保守情報
Jischkコマンドの実行結果※6
物理ホスト指定時：
インストール先フォルダ¥log¥Command¥*
論理ホスト指定時：
共有フォルダ¥jp1base¥log¥Command¥*
isamchk.log

ファイル一覧
dir /s インストール先フォルダの実行結果
dir_jp1base.log

dir /s 共有フォルダ¥jp1baseの実行結果
dir_jp1base.log

バージョン情報
システムドライブ¥Program Files
¥InstallShield Installation Information
¥{F8C71F7C-E5DE-11D3-A21E-006097C00EBC}¥setup.ilg，setup.ini
base_setup.ilg，base_setup.ini

パッチ適用履歴
インストール先フォルダ¥Patchlog.txt
Patchlog_jp1base.txt

JP1/Baseのバインド状況
netstat -naの実行結果
netstat.log

ネットワークアドレス解決のためのホスト名
jbsgethostbynameの実行結果
jbsgethostbyname.log

フォルダのアクセス権限
cacls インストール先フォルダの実行結果
cacls_jp1base.log

cacls 共有フォルダ¥jp1base の実行結果

cacls インストール先フォルダ¥log の実行結果
cacls_jp1base_log.log

cacls 共有フォルダ¥jp1base¥log の実行結果

cacls インストール先フォルダ¥log¥COMMAND の実行結果
cacls_jp1base_log_COMMAND.log

cacls 共有フォルダ¥jp1base¥log¥COMMAND の実行結果

cacls インストール先フォルダ¥sys の実行結果
cacls_jp1base_sys.log

cacls インストール先フォルダ¥sys¥event の実行結果
cacls_jp1base_sys_event.log

cacls インストール先フォルダ¥sys¥event¥servers の実行結果
cacls_jp1base_sys_event_servers.log

cacls インストール先フォルダ¥sys¥event¥servers¥default の実行結果
cacls_jp1base_sys_event_servers_default.log

cacls 共有フォルダ¥jp1base¥event の実行結果
cacls_jp1base_event.log

日立総合インストーラのログファイル
Windowsのインストール先フォルダ¥Temp¥HCDINST¥以下のファイル
左記ファイルのコピーファイル

製品情報ファイル
システムドライブ¥Program Files¥Hitachi¥jp1common¥jp1base¥jp1base.dat※⁷
採取元のファイル名と同じファイル名

注　イベントサーバインデックスファイル（index）で別パスを指定している場合，および統合トレースログの出力先を変更している場合は，指定したパス，および変更した出力先から直接採取してください。

注※1　資料採取ツールを実行したあとの格納先でのファイル名です。

注※2　論理ホスト（クラスタ）環境の資料を採取する際に採取します。

注※3　イベントDBおよびコマンド実行履歴を採取する場合，ファイルサイズが大きく，資料採取にディスク容量が必要となる場合があります。資料採取する場合，事前にファイルサイズを確認してください。

注※4　インストール時の環境変数「%ALLUSERSPROFILE%」に設定されている値になります。

注※5　Windows VistaまたはWindows Server 2008の場合。

注※6　Windows VistaとWindows Server 2008以外の場合。

注※7　x86環境またはx64環境の場合。

(3)　JP1/Baseのプロセス一覧

Windowsのタスク マネージャでプロセスの動作状態を確認します。

(4)　オペレーション内容

トラブル発生時のオペレーション内容について次に示す情報が必要です。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/IM - Managerの構成）

再現性

JP1/IM - Viewからログインしている場合のログインユーザー名

(5)　画面上のエラー情報

次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー（および詳細ボタンがある場合はその内容）

(6)　ユーザーダンプ（Windows VistaまたはWindows Server 2008の場合）

Windows VistaまたはWindows Server 2008でJP1/Baseのプロセスがアプリケーションエラーで停止した場合は，ユーザーダンプを採取してください。

(7)　問題レポートの採取（Windows VistaまたはWindows Server 2008の場合）

Windows VistaまたはWindows Server 2008でJP1/Baseのプロセスがアプリケーションエラーで停止した場合は，問題レポートを採取してください。

16.3.2　UNIXの場合

＜この項の構成＞

(1)　OSのシステム情報

(2)　JP1/Baseの情報

(3)　オペレーション内容

(4)　画面上のエラー情報

(1)　OSのシステム情報

次に示すOSのログ情報の採取が必要です。これらの情報は資料採取ツールで採取できます。

情報の種類
採取資料
ファイル名※1

資料採取日時
dateの実行結果
jp1_default_base_1st.tar.Z，date.log

シスログ（syslog）
/var/adm/syslog/syslog.log（HP-UX）※2
/var/adm/messages（Solaris）※2
/var/adm/messages（AIX）※2
/var/log/messages（Linux）※2
jp1_default_base_1st.tar.Z，syslog.log

マシンに設定されているホスト名
/etc/hosts
jp1_default_base_1st.tar.Z，hosts

マシンに設定されているサービスポートの設定
/etc/services
jp1_default_base_1st.tar.Z，services

マシンに設定されているユーザーの一覧
/etc/passwd
jp1_default_base_1st.tar.Z，passwd

NICの実装状況
netstat -inの実行結果
jp1_default_base_1st.tar.Z，netstat_in.log

プロセス一覧
ps -elfaの実行結果
jp1_default_base_1st.tar.Z，ps.log

マシンの環境変数

envの実行結果

jp1_default_base_1st.tar.Z，env.log

カーネルパラメーター情報

HP-UX：

sysdefの実行結果

/usr/sbin/kmtune，または/usr/sbin/kctuneの実行結果

ulimit -aの実行結果

Solaris：

/usr/sbin/sysdef -iの実行結果

ulimit -aの実行結果

AIX：

lsattr -E -l sys0の実行結果

ulimit -aの実行結果

/etc/security/limits

Linux：

/sbin/sysctl -aの実行結果

ulimit -aの実行結果

jp1_default_base_1st.tar.Z

HP-UX：

sysdef.log

kmtune.log

kctune.log

ulimit.log

Solaris：

sysdef.log

ulimit.log

AIX：

lsatt.log

ulimit.log

limits

Linux：

sysctl.log

ulimit.log

ページサイズ情報
dmesgの実行結果（HP-UX）
pagesizeの実行結果（Solaris，AIX）
採取しない（Linux）
jp1_default_base_1st.tar.Z，pagesize.log

共有メモリー情報
ipcs -aの実行結果
jp1_default_base_1st.tar.Z,ipcs.log

メモリー情報
swapinfo -tの実行結果（HP-UX）
swap -lの実行結果（Solaris）
lsps -sの実行結果（AIX）
cat /proc/meminfo（Linux）
jp1_default_base_1st.tar.Z，swapinfo.log

ディスク情報
bdfの実行結果（HP-UX）
df -kの実行結果（HP-UX以外）
jp1_default_base_1st.tar.Z，df.log

システム診断状況
/etc/dmesgの実行結果（HP-UX）
/usr/sbin/dmesgの実行結果（Solaris）
/usr/bin/alog -o -t bootの実行結果（AIX）
/bin/dmesgの実行結果（Linux）
jp1_default_base_1st.tar.Z，sys_info.log

OSのパッチ適用状況

HP-UX：

/usr/sbin/swlist -l product

/usr/sbin/swlist

/usr/sbin/swlist -l fileset -a patch_state *.*,c=patch

Solaris：

showrev -a

AIX：

lslpp -l -a

/usr/bin/instfix -a -icv

Linux：

/bin/rpm -qa

jp1_default_base_1st.tar.Z，patch_info.log

OSのバージョン情報
uname -aの実行結果
jp1_default_base_1st.tar.Z，uname_a.log

インストール済みの日立製品情報
/etc/.hitachi/pplistd/pplistd
jp1_default_base_1st.tar.Z，pplistd

ネットワークアドレス解決のためのホスト名
jbsgethostbynameの実行結果
jp1_default_base_1st.tar.Z，jbsgethostbyname.log

Linux リリース情報
/etc/redhat-release（Linux）
jp1_default_base_1st.tar.Z，redhat-release

ネームサービス 設定ファイル
/etc/nsswitch.conf
jp1_default_base_1st.tar.Z，nsswitch.conf

DNSサーバ設定ファイル
/etc/resolv.conf
jp1_default_base_1st.tar.Z，resolv.conf

ネットワーク・インターフェースの設定
ifconfig -aの実行結果
jp1_default_base_1st.tar.Z，ifconfig.log

注※1　資料採取ツールを実行したあとの圧縮ファイルおよび解凍後のファイル名です（圧縮ファイル，解凍後のファイルの順に記載しています）。Linuxでは，拡張子がgzになります。

注※2　syslogファイルは，デフォルトのファイル名と異なる場合があります。

(2)　JP1/Baseの情報

JP1/Baseに関する次の情報の採取が必要です。これらの情報は資料採取ツールで採取できます。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

情報の種類
デフォルトのファイル名
ファイル名

環境設定情報
/etc/opt/jp1base/conf/以下のファイル
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

/etc/opt/jp1base/default/以下のファイル
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

/opt/jp1base/plugin/conf/以下のファイル
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/conf以下のファイル※1
論理ホスト名_1st.tar.Z，採取元のファイル名と同じファイル名

共通定義情報
/opt/jp1/hcclibcnf/
（jbsgetcnfコマンドを実行した出力結果でも確認できます）
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

/etc/opt/jp1base/default/以下のファイル
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

ログ情報
/var/opt/jp1base/log/以下のファイル
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/log※1※2
論理ホスト名_base_1st.tar.Z，採取元のファイル名と同じファイル名

インストールログ
/tmp/HITACHI_JP1_INST_LOG/jp1base_inst{1|2|3|4|5}.log
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

サービス稼働情報
/var/opt/jp1base/sys/OPI/以下のファイル
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/sys/OPI/以下のファイル
論理ホスト名_base_1st.tar.Z，採取元のファイル名と同じファイル名

イベントサービスの設定情報
/var/opt/jp1base/sys/tmp/event/以下のファイル
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/event/以下のファイル※1
論理ホスト名_base_1st.tar.Z，採取元のファイル名と同じファイル名

イベントDB
/var/opt/jp1base/sys/event/以下のファイル
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/event/以下のファイル※1
論理ホスト名_base_2nd.tar.Z，採取元のファイル名と同じファイル名

JP1/SESに関するログ情報
/var/tmp/jp1_ses/以下のファイル
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

/var/opt/jp1_ses/log/以下のファイル
（OSがHP-UXの場合）（/usr/lib/jp1_ses/log/のシンボリックリンクあり）
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

/usr/lib/jp1_ses/log/以下のファイル
（OSがHP-UX以外の場合）
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

/usr/lib/jp1_ses/sys/以下のファイル
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

/usr/tmp/jp1_ses/以下のファイル
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

/usr/bin/jp1_ses/jp*
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

/tmp/.JP1_SES*
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

コマンド実行履歴
/var/opt/jp1base/log/COMMAND以下のファイル
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/log/COMMAND以下のディレクトリ
jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

プロセスの動作状況（イベントサービスを除く）
jbs_spmd_statusの実行結果
jp1_default_base_1st.tar.Z，jbs_spmd_status.log

jbs_spmd_status -h 論理ホスト名の実行結果※1
jp1_default_base_1st.tar.Z，jbs_spmd_status_論理ホスト名.log

イベントサービスのプロセスの動作状況
jevstatコマンドの実行結果
jp1_default_base_1st.tar.Z，jevstat.log

jevstat 論理ホスト名の実行結果※1
jp1_default_base_1st.tar.Z，jevstat_論理ホスト名.log

統合トレースログファイル
/var/opt/hitachi/HNTRLib2/spool/hntr2*.log
jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

ISAMの保守情報
Jischkコマンドの実行結果
物理ホスト指定時：
/var/opt/jp1base/log/COMMAND
論理ホスト指定時：
共有ディレクトリ/jp1base/log/COMMAND
物理ホスト指定時：
jp1_default_base_1st.tar.Z，com.jischk,log
論理ホスト指定時：
jp1_default_base_1st.tar.Z，com.jischk_論理ホスト名.log

coreの解析情報※3
carコマンドの実行結果
（/var/opt/jp1base/，および/opt/jp1base/
/以下のcoreファイルの解析結果）
jp1_default_base_2nd.tar.Z，core_モジュール名.log
jp1_default_base_2nd.tar.Z，core_モジュール名_cat.tar.Z

ファイル一覧
lsコマンドの実行結果
ls -lRa /opt/jp1base
ls -lRa /etc/opt/jp1base
ls -lRa /var/opt/jp1base
jp1_default_base_1st.tar.Z，inst_dir.log

lsコマンドの実行結果※1
ls -lRa 共有ディレクトリ/jp1base
ls -lRa 共有ディレクトリ/event
jp1_default_base_1st.tar.Z，share_dir.log

パッチ適用履歴
/opt/jp1base/PatchInfo
jp1_default_base_1st.tar.Z，PatchInfo

パッチログ情
報
/opt/jp1base/PatchLog
jp1_default_base_1st.tar.Z，PatchLog

JP1/Baseのバインド状況
netstat -naの実行結果
jp1_default_base_1st.tar.Z，netstat_na.log

注　イベントサーバインデックスファイル（index）で別パスを指定している場合，および統合トレースログの出力先を変更している場合は，資料採取ツールに次のオプションを指定して，指定したパス，および変更した出力先の情報を採取してください。

jbs_log.sh (任意のオプション) [indexファイルで指定したディレクトリ]

jbs_log.sh (任意のオプション) [統合トレースログの出力先ディレクトリ]

注※1　論理ホスト（クラスタ）環境の資料を採取する際に採取します。

注※2　イベントDBおよびコマンド実行履歴を採取する場合，ファイルサイズが大きく，資料採取にディスク容量が必要となる場合があります。資料採取する場合，事前にファイルサイズを確認してください。

注※3　Linuxでは，次の注意事項があります。

Linuxでは，標準設定でコアファイル出力時の最大サイズが「0」となっている場合があります。この場合，コアダンプは出力されません。このため，コアダンプが出力できるように，jbs_startスクリプトおよびjbs_start.clusterスクリプトは標準で，次のように設定されています。

if [ 'uname' = Linux ]; then
ulimit -c unlimited
fi

この設定がご使用マシンのセキュリティポリシーに反する場合は，次のように行の先頭に「#」を付けてコメント行に変更してください。コメント行に変更すると，ファイルの設定は無効になります。ただし，JP1/Baseのプロセスがセグメンテーション障害やバス障害などのコアダンプ出力契機に，コアダンプが出力されないため，調査ができないことがあります。

#if [ 'uname' = Linux ]; then
#ulimit -c unlimited
#fi

(3)　オペレーション内容

トラブル発生時のオペレーション内容について次に示す情報が必要です。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/IM - Managerの構成）

再現性

JP1/IM - Viewからログインしている場合のログインユーザー名

(4)　画面上のエラー情報

次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー（および詳細ボタンがある場合はその内容）

16.4　資料の採取方法

トラブルが発生したときに資料を採取する方法を次に示します。

＜この節の構成＞

16.4.1　Windowsの場合

16.4.2　UNIXの場合

16.4.1　Windowsの場合

＜この項の構成＞

(1)　資料採取ツールを実行する

(2)　プロセスの状態を確認する

(3)　オペレーション内容を確認する

(4)　画面上のエラー情報を採取する

(5)　ユーザーダンプを採取する（Windows VistaまたはWindows Server 2008の場合）

(6)　問題レポートを採取する（Windows VistaまたはWindows Server 2008の場合）

(1)　資料採取ツールを実行する

資料採取ツール（jbs_log.bat）を実行します。

jbs_log.batを実行すると，同ホスト上のJP1/Baseの障害調査に必要な資料を採取できます。

資料採取ツールで採取する資料の総容量はご使用の環境によって大きく変化します。実行する前に次に示す方法で容量を見積もり，ご使用のマシンの空き容量を確認してください。

jbs_log.batで物理ホストを指定した場合のデータサイズ

jbs_log.batで物理ホストを指定し（オプションを指定しない），JP1/Baseおよびマシン環境情報の資料を採取するときは，以下の方法で採取する資料のサイズを見積もれます。

データサイズ = 5 + a + b + c + d メガバイト

a

インストール先フォルダ¥log¥以下のデータサイズ（最大45メガバイト※1）

b

インストール先フォルダ¥sys¥以下のデータサイズ（最大55メガバイト※2）

c

ワトソンログおよびクラッシュダンプのデータサイズ

d

以下のファイルの合計値

システムドライブ（C:¥WINNTなど）¥system32¥config¥AppEvent.evt

システムドライブ（C:¥WINNTなど）¥system32¥config¥SysEvent.evt

注※1　JP1/IM - Managerを同一のホストで使用する場合には，さらに142メガバイト必要です。

注※2　デフォルト値です。イベントDBのサイズを変更した場合には増加します。

jbs_log.batで論理ホストを指定した場合のデータサイズ

jbs_log.batで論理ホストを指定し，JP1/Baseおよびマシン環境情報の資料を採取するときは，以下の方法で採取する資料のサイズを見積もれます。

データサイズ = 5 + a + b + c + d + e + f メガバイト

a

インストール先フォルダ¥log¥以下のデータサイズ（最大45メガバイト※1）

b

インストール先フォルダ¥sys¥以下のデータサイズ（最大55メガバイト※2）

c

ワトソンログおよびクラッシュダンプのデータサイズ

d

以下のファイルの合計値

システムドライブ（C:¥WINNTなど）¥system32¥config¥AppEvent.evt

システムドライブ（C:¥WINNTなど）¥system32¥config¥SysEvent.evt

e

共有フォルダ¥jp1base¥log¥のデータサイズ（最大45メガバイト※1）

f

共有フォルダ¥jp1base¥event¥のデータサイズ（最大55メガバイト※2）

注※1　JP1/IM - Managerを同一のホストで使用する場合には，さらに142メガバイト必要です。

注※2　デフォルト値です。イベントDBのサイズを変更した場合には増加します。最大値の見積もりはリリースノートを参照してください。

フォルダのデータサイズは，エクスプローラ上で右クリックをして表示されるメニューの［フォルダのプロパティ］画面で確認できます。

各フォルダのディスク占有量の最大値の見積もりは，リリースノートを参照してください。

次にツールの実行例を示します。

c:¥>c:¥usertools¥jbs_log.bat 資料格納フォルダ

資料格納フォルダは，フルパスで指定してください。パスに空白を含む場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。

ツールを実行すると，資料格納フォルダに指定したディレクトリの下にjp1defaultフォルダが作成されます。-hオプションを指定した場合は，jp1defaultフォルダと論理ホスト名のフォルダが作成されます。各フォルダの下に，base_1stとbase_2ndのフォルダが作成され，そのフォルダの中に採取した資料がコピーされます。必要に応じて採取した資料を圧縮ツールなどで圧縮してください。

なお，jbs_log.batでは，コマンド実行履歴ファイル（ISAM）やイベントDBなどを採取しないオプションを提供しています。詳細については，「13.　コマンド」の「jbs_log.bat（Windows限定）」を参照してください。

07-00以前のJP1/IM，JP1/AJSをご使用の場合の注意事項

JP1/Base 07-10では，資料採取ツールをカスタマイズしてJP1/IMおよびJP1/AJSの資料を採取することはできません。JP1/IMおよびJP1/AJSの資料を採取する場合は，各製品の資料採取ツールを個別に実行してください。

(2)　プロセスの状態を確認する

Windowsのタスク マネージャを使って，プロセスの動作状態を確認してください。正常に動作している場合に表示されるプロセスを次に示します。なお，表内の(　)内の数値は同時に実行できるプロセス数です。

親プロセス名
機能
子プロセス名
機能

hntr2srv.exe(1)
統合トレース起動用
－
－

hntr2mon.exe(1)
統合トレース
－
－

jbs_service.exe(1)
JP1/Baseプロセス管理起動用※1
－
－

jbs_spmd.exe(1)
JP1/Baseプロセス管理※1
jbssessionmgr.exe(1)
認証サーバ※1※3
認証サーバとして設定したホスト上にだけ存在する。
jbs_spmd_statusコマンドを実行した場合の表示名はjbssessionmgrとなる。

jbsroute.exe(1)
構成管理※1※3
jbs_spmd_statusコマンドを実行した場合の表示名はjbsrouteとなる。

jcocmd.exe(1)
jcocmdexe.exe(1)
jcocmdapi.exe
(コマンド実行画面数※2+1(JP1/IM - Managerがインストールされている場合))
コマンド実行※1※3
jbs_spmd_statusコマンドを実行した場合の表示名はjcocmdとなる。

jbsplugind.exe
プラグインサービス※1※3
jbs_spmd_statusコマンドを実行した場合の表示名はjbspluginとなる。

jbshcd.exe(1)
ヘルスチェック（自ホスト監視用）※1※3
jbs_spmd_statusコマンドを実行した場合の表示名はjbshcdとなる。

jbshchostd.exe(1)
ヘルスチェック（他ホスト監視用）※1※3
jbs_spmd_statusコマンドを実行した場合の表示名はjbshchostdとなる。

jbssrvmgr.exe(1)
サービス管理制御機能※1※3
jbs_spmd_statusコマンドを実行した場合の表示名はjbssrvmgrとなる。

jbslcact.exe(1)
ローカルアクション機能※1※3
jbs_spmd_statusコマンドを実行した場合の表示名はjbslcactとなる。

jbscomd.exe(1)
jbscomd_api.exe(1～9999)
jbscomd_ses.exe(1)
jbscomd_snd.exe(1)
jbscomd_rcv.exe(1)
プロセス間通信※1※3
jbs_spmd_statusコマンドを実行した場合の表示名はjbscomdとなる。

jbapmsrvcecon.exe(1)
起動管理
powendar.exe(1)
電源制御
JP1/Power Monitorがインストールされていると，このプロセスが生成される。

jevservice.exe(1)
イベントサービス※1※4
jevsessvc.exe(1)
イベントサービス
このプロセスは物理ホストでだけ生成される。

jevtraplog.exe(1)
ログファイルトラップ
－
ログファイルトラップを使用した場合だけ生成される。

jevtrapevt.exe(1)
イベントログトラップ
－
イベントログトラップを使用した場合だけ生成される。

imevtgw.exe(1)
SNMPトラップ変換
－
SNMPトラップ変換機能を使用した場合だけ生成される。

（凡例）

－：なし

注※1　クラスタシステムで複数の論理ホストが一つの物理ホスト上で動作する場合，または一つの論理ホストと物理ホストが同時に起動される場合は，上記のプロセスの同時に実行できるプロセス数の上限は，（論理ホスト数+1）×プロセス数となります。

注※2　接続しているJP1/IM - Viewがコマンド実行画面を開いている数のことです。開いている画面数だけプロセス数が増えます。コマンド実行画面を閉じると，閉じた分だけプロセスは消滅します。

注※3　これらのプロセスの状態は，jbs_spmd_statusコマンドで確認できます。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合
jbssessionmgr
jbsroute
jcocmd
jbsplugin
jbshcd
jbshchostd
jbssrvmgr
jbslcact
jbscomd

認証サーバが設定されていない場合
jbsroute
jcocmd
jbsplugin
jbshcd
jbshchostd
jbssrvmgr
jbslcact
jbscomd

注※4　これらのプロセスの状態は，jevstatコマンドで確認できます。jevstatコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

jevservice

(3)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/IM - Managerの構成）

再現性

JP1/IM - Viewからログインしている場合のログインユーザー名

(4)　画面上のエラー情報を採取する

画面にエラーが表示された場合は，その情報も採取します。次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー

詳細ボタンがある場合は，その内容もコピーしてください。

(5)　ユーザーダンプを採取する（Windows VistaまたはWindows Server 2008の場合）

Windows VistaまたはWindows Server 2008でJP1/Baseのプロセスがアプリケーションエラーで停止した場合，エラーダイアログボックスが表示されている状態で，次の手順でユーザーダンプを採取してください。

注意事項

エラーダイアログボックスを消してしまうと正常なダンプは取得されないため，ユーザーダンプを採取できなくなってしまいます。誤って採取前にエラーダイアログボックスを（OKボタンなどをクリックして）消してしまった場合は，現象を再現させてからユーザーダンプを採取してください。

タスクマネージャを起動する。
タスクマネージャは次のどちらかの手順で起動できます。

タスクバーの空いている場所で右クリックをして「タスクマネージャ」を選択する。

CTRL+SHIFT+ESCキーを押してタスクマネージャを起動する。

「プロセス」タブをクリックする。

アプリケーションエラーで停止したJP1/Baseのプロセス名を右クリックし，「ダンプファイルの生成」を選択する。

ユーザーダンプの出力先パスを示すダイアログボックスが表示されるので，そこから採取する。

(6)　問題レポートを採取する（Windows VistaまたはWindows Server 2008の場合）

Windows VistaまたはWindows Server 2008でJP1/Baseのプロセスがアプリケーションエラーで停止した場合，次の手順で問題レポートを採取してください。

［ファイル名を指定して実行］のテキストボックスに「wercon」と入力し，［OK］ボタンをクリックする。
［問題のレポートと解決策］ダイアログボックスが開きます。

左側の領域で，［問題の履歴の表示］をクリックする。

該当する問題をダブルクリックする。
問題レポートの詳細が表示されます。

「クリップボードにコピー」を選択する。

コピーした内容を，テキストファイルにコピーして保存する。
保存した問題レポートを，障害調査用の資料として利用してください。

16.4.2　UNIXの場合

＜この項の構成＞

(1)　資料採取ツールを実行する

(2)　プロセスの状態を確認する

(3)　オペレーション内容を確認する

(4)　画面上のエラー情報を採取する

(1)　資料採取ツールを実行する

資料採取ツール（jbs_log.sh）を実行します。

jbs_log.shを実行すると，同ホスト上のJP1/Baseの障害調査に必要な資料を採取できます。

資料採取ツールで採取する資料の総容量はご使用の環境によって大きく変化します。実行する前に次に示す方法で容量を見積もり，ご使用のマシンの空き容量を確認してください。

jbs_log.shで物理ホストを指定した場合のデータサイズ

jbs_log.shで物理ホストを指定し（オプションを指定しない），JP1/Baseおよびマシン環境情報の資料を採取するときは，以下の方法で採取する資料のサイズを見積もれます。

データサイズ = 3 + a + b +（60 × c） メガバイト

a

/var/opt/jp1base/以下のデータサイズ（最大83メガバイト※1※2）

b

/直下のcoreのサイズ（存在する場合だけ）

c

/直下，/var/opt/jp1base/，または/opt/jp1base/以下のcoreの数

注※1　JP1/IM - Managerを同一のホストで使用する場合には，さらに142メガバイト必要です。

注※2　デフォルト値です。イベントDBのサイズを変更した場合には増加します。最大値の見積もりはリリースノートを参照してください。

jbs_log.shで論理ホストを指定した場合のデータサイズ

jbs_log.shで論理ホストを指定し，JP1/Baseおよびマシン環境情報の資料を採取するときは，以下の方法で採取する資料のサイズを見積もれます。

データサイズ = 3 + a + b +（60 × c）+ d + e メガバイト

a

/var/opt/jp1base/以下のデータサイズ（最大83メガバイト※1※2）

b

/直下のcoreのサイズ（存在する場合だけ）

c

/直下，/var/opt/jp1base/，または/opt/jp1base/以下のcoreの数

d

共有ディレクトリ/jp1base/log/のデータサイズ（最大45メガバイト※1）

e

共有ディレクトリ/event/のデータサイズ（最大55メガバイト※2）

注※1　JP1/IM - Managerを同一のホストで使用する場合には，さらに142メガバイト必要です。

注※2　デフォルト値です。イベントDBのサイズを変更した場合には増加します。最大値の見積もりはリリースノートを参照してください。

フォルダのデータサイズは，duコマンドを使用して確認できます。

各フォルダのディスク占有量の最大値の見積もりは，リリースノートを参照してください。

次に，ツールの実行例を示します。

jbs_log.sh -f 出力ファイル名

なお，jbs_log.shでは，コマンド実行履歴ファイル（ISAM）やイベントDBなどを採取しないオプションを提供しています。詳細については，「13.　コマンド」の「jbs_log.sh（UNIX限定）」を参照してください。

07-00以前のJP1/IM，JP1/AJSをご使用の場合の注意事項

JP1/Base 07-10では，資料採取ツールをカスタマイズしてJP1/IMおよびJP1/AJSの資料を採取することはできません。JP1/IMおよびJP1/AJSの資料を採取する場合は，各製品の資料採取ツールを個別に実行してください。

(2)　プロセスの状態を確認する

psコマンドを使用したときに表示されるプロセスを次に示します。UNIXの場合は，資料採取ツール（jbs_log.sh）を実行すると，ほかの資料とともにpsコマンドの実行結果を採取できます。

表内の(　)内の数値は同時に実行できるプロセス数です。

親プロセス名
機能
子プロセス名
機能

hntr2mon(1)
統合トレース
－
－

jbs_spmd(1)
プロセス管理※1
jbssessionmgr(1)
認証サーバ※1※4
認証サーバとして設定したホスト上にだけ存在する。
jbs_spmd_statusコマンドを実行した場合の表示名はjbssessionmgrとなる。

jbsroute(1～9)
構成管理※1※4
jbs_spmd_statusコマンドを実行した場合の表示名はjbsrouteとなる。

jcocmd(1)
jcocmdexe(1)
jcocmdapi(コマンド実行画面数※2+1(JP1/IM - Managerがインストールされている場合))
jcocmdcmc(0～コマンド数※3)
コマンド実行※1※4
jbs_spmd_statusコマンドを実行した場合の表示名はjcocmdとなる。

jbsplugind※5
プラグインサービス※1※4
jbs_spmd_statusコマンドを実行した場合の表示名はjbspluginとなる。

jbshcd(1)
ヘルスチェック（自ホスト監視用）※1※4
jbs_spmd_statusコマンドを実行した場合の表示名はjbshcdとなる。

jbshchostd(1)
ヘルスチェック（他ホスト監視用）※1※4
jbs_spmd_statusコマンドを実行した場合の表示名はjbshchostdとなる。

jbssrvmgr(1)
サービス管理制御機能※1※4
jbs_spmd_statusコマンドを実行した場合の表示名はjbssrvmgrとなる。

jbslcact(1)
ローカルアクション機能※1※4
jbs_spmd_statusコマンドを実行した場合の表示名はjbslcactとなる。

jbscomd(1)
jbscomd_api(1～9999)
jbscomd_ses(1)
jbscomd_snd(1)
jbscomd_rcv(1)
プロセス間通信※1※4
jbs_spmd_statusコマンドを実行した場合の表示名はjbscomdとなる。

jevservice(1)
イベントサービス※1※6
jevservice(6～9,999)
イベントサービス

jesdmain(1)※7
JP1/SES互換用
このプロセスは物理ホストでだけ生成される。

jesrd(4～9,999)
JP1/SES互換用
このプロセスは物理ホストでだけ生成される。

jevlogd(1～2)
ログファイルトラップ
jelparentim
(0～jevlogstartコマンド実行数)
ログファイルトラップ
jelparentim一つにつき，監視するファイル数分jelchildimプロセスが生成される。なお，jevlogstopコマンドを実行すれば，jelparentimプロセスは消滅する。

imevtgw(1)
SNMPトラップ変換
－
SNMPトラップ変換機能を使用する場合だけ生成される。

（凡例）

－：なし

注※1　クラスタシステムで複数の論理ホストが一つの物理ホスト上で動作する場合，または一つの論理ホストと物理ホストが同時に起動される場合は，上記のプロセスの同時に実行できるプロセス数の上限は，（論理ホスト数+1）×プロセス数となります。

注※2　接続しているJP1/IM - Viewがコマンド実行画面を開いている数のことです。開いている画面数だけプロセス数が増えます。コマンド実行画面を閉じると，閉じた分だけプロセスは消滅します。

注※3　JP1/IM - Managerによるリモートコマンドや自動アクションの実行数のことです。コマンド一つにつき，プロセスが一つ生成されます。処理が完了すると，プロセスは消滅します。なお，コマンドを連続して実行した場合，複数のプロセスが生成されることがあります。

注※4　これらのプロセスの状態は，jbs_spmd_statusコマンドで確認できます。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合
jbssessionmgr
jbsroute
jcocmd
jbsplugin
jbshcd
jbshchostd
jbssrvmgr
jbslcact
jbscomd

認証サーバが設定されていない場合
jbsroute
jcocmd
jbsplugin
jbshcd
jbshchostd
jbssrvmgr
jbslcact
jbscomd

注※5　ps-elコマンドで表示されるプロセス名は，「jbsplugin」となります。

注※6　これらのプロセスの状態は，jevstatコマンドで確認できます。jevstatコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

jevservice

注※7　psコマンドで表示されるプロセス名は，/var/opt/jp1base/sys/tmp/event/servers/default/jpevent.confとなります。

(3)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/IM - Managerの構成）

再現性

JP1/IM - Viewからログインしている場合のログインユーザー名

(4)　画面上のエラー情報を採取する

画面にエラーが表示された場合は，その情報も採取します。次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー

詳細ボタンがある場合は，その内容もコピーしてください。

16.5　トラブルへの対処方法

この節では，トラブル発生時の現象別の対処方法について説明します。

＜この節の構成＞

16.5.1　OS共通のトラブル

16.5.2　Windowsの場合

16.5.3　UNIXの場合

16.5.4　ヘルスチェック機能で異常を検知した場合

16.5.1　OS共通のトラブル

Windows，UNIX共通で発生する主なトラブルを次に示します。

表16-3　OS共通のトラブル

項番 | トラブルの内容
1 | 短時間に大量のJP1イベントが発生し，登録遅延，転送遅延が発生した。
2 | イベントDBが破損した。
3 | JP1/Baseを起動すると，「SESエミュレータ用のポートIDが定義されていません」のメッセージが出力される。
4 | 定義ファイルに設定した内容と実際の動作が異なる。

＜この項の構成＞

(1)　短時間に大量のJP1イベントが発生し，登録遅延，転送遅延が発生した。

(2)　イベントDBが破損した。

(3)　JP1/Baseを起動すると，「SESエミュレータ用のポートIDが定義されていません」のメッセージが出力される。

(4)　定義ファイルに設定した内容と実際の動作が異なる。

(1)　短時間に大量のJP1イベントが発生し，登録遅延，転送遅延が発生した。

障害の発生によって突発的に大量のJP1イベントが発生すると，障害が発生しているのに，障害通知のJP1イベントがJP1/IM - Viewに表示されるまでに時間が掛かったり，JP1イベントを契機にしたJP1/AJSのジョブの実行が遅れたりすることがあります。障害が発生したホストの障害を復旧しイベントサービスを再起動しても，転送処理中となったJP1イベントは転送され続けます。

JP1イベントの大量発生によるマシンの負荷や業務への影響が大きく，どうしてもJP1イベントの転送を中止したい場合は，JP1イベントの転送元イベントサーバのイベントDBを初期化してください。なお，イベントDBに登録されているJP1イベントを保存したい場合は，あらかじめjevexportコマンドでイベントDBをcsvファイルに出力してください。

イベントDBの初期化の手順については，「8.2　イベントDBの初期化」を参照してください。

また，JP1イベントの大量発生を防止するために，転送するJP1イベントの条件を転送設定ファイル（forward）で調整してください。

(2)　イベントDBが破損した。

イベントDBは，次に示す要因によって破損することがあります。

停電などで，急にシステムの電源が落ちた。

イベントサービスの稼働中に，OSのコマンドやバックアップ用のソフトウェアでイベントDBをバックアップおよびリストアした。

イベントDBをエディターなどで編集した。

コマンドの出力結果などをイベントDBにリダイレクトした。

ハードディスクに障害が発生した。

イベントDBが破損しても，イベントサービスは起動または続行し，新規のJP1イベントの登録や取得は正常に行えます。ただし，破損したレコードは，イベント検索や取得の対象外となります。また，イベントDBに破損したレコードが存在すると，JP1/IM - Viewからのイベント検索の性能が低下するおそれがあります。

イベントDBが破損すると，イベントログ，syslog，および統合トレースログにメッセージ（KAJP1057-W，KAJP1058-W，またはKAJP1059-E）が出力されます。これらのメッセージが出力された場合は，イベントDBを初期化してください。

イベントDBの初期化の手順については，「8.2　イベントDBの初期化」を参照してください。

(3)　JP1/Baseを起動すると，「SESエミュレータ用のポートIDが定義されていません」のメッセージが出力される。

JP1/Baseの起動時に，「SESエミュレータ用のポートIDが定義されていません」のメッセージが出力される場合の要因と対処について説明します。

要因

servicesファイルにJP1/SES互換用のポートIDを指定していないためです。JP1/SES形式でイベントを送受信しない場合は問題ありません。

対処

JP1/SES，JP1/AJSおよびJP1/SESのプロトコルを利用した製品（JP1/OJEなど）とイベントの送受信をする場合は，servicesファイルにJP1AutoJob（Windowsの場合），jesrd（UNIXの場合）を追加してください。ポート番号は任意です。

(4)　定義ファイルに設定した内容と実際の動作が異なる。

ホストで稼働しているサービスの設定が，定義ファイルに設定した内容とは異なる内容で反映されているため，期待していた動作とは異なる動作をする場合があります。この原因を解明するには，実際に稼働しているサービスの稼働情報の内容と定義ファイルの内容を比較する必要があります。

実際に稼働しているサービスの稼働情報の内容を知るには，jbsgetopinfoコマンドを使用します。このコマンドでは，イベントサービスの転送設定ファイル，ログファイルトラップ動作定義ファイル，イベントログトラップ動作定義ファイル（Windows限定）から定義される稼働情報について確認できます。定義ファイルの内容と比較し，異なる場合には定義ファイルの内容を有効になるよう対処してください。jbsgetopinfoコマンドの詳細については，「13.　コマンド」の「jbsgetopinfo」を参照してください。

16.5.2　Windowsの場合

Windowsの場合に発生する主なトラブルを次に示します。

表16-4　Windowsの場合のトラブル

項番 | トラブルの内容
1 | JP1/Baseのイベントサービスが起動しない。
2 | JP1/IM - Viewの［イベントコンソール］画面に表示されるJP1イベントの時刻がずれる。
3 | 認証サーバが起動しない。
4 | 「サービス固有のエラー3004」が表示され，JP1/Base EventlogTrapサービスが起動できない。
5 | 起動管理機能（JP1/Base Control Serviceサービス）でサービスを正常に起動または停止できない。
6 | 起動管理機能（JP1/Base Control Serviceサービス）でサービスをシステム終了時に停止できない。
7 | 特定の順番でサービスを起動する必要があるため，起動管理機能を使ってサービスの起動完了を待って順番にサービスが起動するように定義している。しかし，先に起動する必要があるサービスの起動が完了しないうちに次のサービスが起動してしまい，エラーメッセージが出る。
8 | 起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，"XXXXサービスが既に起動されています"と警告が出る。
9 | 起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，イベントビューアのアプリケーションログに「指定時間を過ぎてもXXXXサービスの起動完了が確認できませんでした。」のメッセージが出力される。
10 | 起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，「KAVA4003-E 予期しないエラーが発生したため，XXXXサービスを起動できませんでした.」のメッセージが出力され，サービスが起動できない。
11 | ディレクトリサーバ連携機能有効時にログインできない。

＜この項の構成＞

(1)　JP1/Baseのイベントサービスが起動しない。

(2)　JP1/IM - Viewの［イベントコンソール］画面に表示されるJP1イベントの時刻がずれる。

(3)　認証サーバが起動しない。

(4)　「サービス固有のエラー3004」が表示され，JP1/Base EventlogTrapサービスが起動できない。

(5)　起動管理機能（JP1/Base Control Serviceサービス）でサービスを正常に起動または停止できない。

(6)　起動管理機能（JP1/Base Control Serviceサービス）でサービスをシステム終了時に停止できない。

(7)　特定の順番でサービスを起動する必要があるため，起動管理機能を使ってサービスの起動完了を待って順番にサービスが起動するように定義している。しかし，先に起動する必要があるサービスの起動が完了しないうちに次のサービスが起動してしまい，エラーメッセージが出る。

(8)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，"XXXXサービスが既に起動されています"と警告が出る。

(9)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，イベントビューアのアプリケーションログに「指定時間を過ぎてもXXXXサービスの起動完了が確認できませんでした。」のメッセージが出力される。

(10)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，「KAVA4003-E 予期しないエラーが発生したため，XXXXサービスを起動できませんでした.」のメッセージが出力され，サービスが起動できない。

(11)　ディレクトリサーバ連携機能有効時にログインできない。

(1)　JP1/Baseのイベントサービスが起動しない。

Windowsホスト上でイベントサービスが起動しない場合の要因と対処について次に示します。

要因

従来の製品JP1/IMを使用しているマシンにJP1/Baseをインストールして使用する場合，JP1/IM Control Service，またはJP1/IM Eventサービスが［コントロールパネル］の［サービス］ダイアログボックス上で「自動」で登録されていると，タイミングによってJP1/Base Eventサービスが起動できなくなります。

対処

JP1/IM Control ServiceおよびJP1/IM Eventサービスを手動に変更してください。また，そのほかのJP1/IM関連サービスも手動にしておいてください。

(2)　JP1/IM - Viewの［イベントコンソール］画面に表示されるJP1イベントの時刻がずれる。

JP1/IM - Viewの［イベントコンソール］画面に表示されるJP1イベントの時刻がずれる場合の要因と対処について次に示します。

要因

システムのmsvcrt.dllのバージョンが古い場合に発生します。

対処

JP1/Baseのインストール時にmsvcrt.dllを置き換えるかどうかの確認ダイアログボックスが表示された場合，必ず［再起動］を選択してファイルの置き換え，インストール後にシステムを再起動してください。

また，ほかの製品をインストールした後に，イベントの時刻がずれるなどの動作不正が発生した場合は，JP1/Baseを再インストールしてください。

(3)　認証サーバが起動しない。

認証サーバが起動しない場合の要因と対処について説明します。

要因

［JP1/Base環境設定］画面の［認証サーバ］タブの［認証サーバ］で，認証サーバとして自ホストを指定していない場合，認証サーバは起動しません。JP1/Baseの新規インストール時に自動セットアップを選択しない場合は，起動しないようになっています。

対処

［JP1/Base環境設定］画面の［認証サーバ］タブの［認証サーバ］で，認証サーバに自ホストを指定してください。

(4)　「サービス固有のエラー3004」が表示され，JP1/Base EventlogTrapサービスが起動できない。

「サービス固有のエラー3004」が表示され，イベントログトラップサービス（JP1/Base EventlogTrap）が起動できない場合の要因と対処について説明します。

要因

イベントサービス（JP1/Base Event）が起動する前に，イベントログトラップサービス（JP1/Base EventlogTrap）が起動したためです。これは，イベントログトラップサービス（JP1/Base EventlogTrap）を［コントロールパネル］の［サービス］ダイアログボックス上で起動方法を「自動」にした場合に発生することがあります。

対処

イベントログトラップサービス（JP1/Base EventlogTrap）を自動起動にしたい場合は，起動管理機能（JP1/Base Control Serviceサービス）を利用して，イベントサービス（JP1/Base Event）の起動後に，イベントログトラップサービス（JP1/Base EventlogTrap）が起動するように設定してください。起動管理機能（JP1/Base Control Serviceサービス）の詳細については，「7.　サービスの起動順序および終了順序の設定（Windows限定）」を参照してください。

(5)　起動管理機能（JP1/Base Control Serviceサービス）でサービスを正常に起動または停止できない。

JP1/Base Control Serviceサービスでサービスを正常に起動または停止できない場合の要因と対処を次に示します。

要因

次に示す要因が考えられます。

対話形式のコマンド，またはダイアログボックスを表示するコマンドを起動順序定義ファイル（JP1SVPRM.DAT）に登録している。

スペースを含むパスのコマンドをダブルクォーテーションマーク（"）で囲まずに起動順序定義ファイル（JP1SVPRM.DAT）に記述している。

対処

要因への対処を示します。番号は，上記要因の番号に対応しています。

対話形式のコマンド，またはダイアログボックスを表示するコマンドがないか確認し，これらのコマンドを登録しないようにしてください。

ダブルクォーテーションマーク（"）で囲むか，環境変数PATHに参照パスを登録し，実行ファイル名だけを起動順序定義ファイル（JP1SVPRM.DAT）に記述してください。

(6)　起動管理機能（JP1/Base Control Serviceサービス）でサービスをシステム終了時に停止できない。

JP1/Base Control Serviceサービスでサービスをシステム終了時に停止できない場合の要因と対処を次に示します。

要因

次に示す要因が考えられます。

JP1/Power Monitorをインストールしていない。

スタートメニューからシャットダウンを実行した。

JP1/Power Monitorから強制終了を実行したが，定義ファイルに[Control Value]セクションを登録していなかった。

JP1/Power Monitor以外でOSのシャットダウンコマンドを実行した。

停止しないサービスの起動方法が［コントロールパネル］の［サービス］ダイアログボックスの表示で「自動」になっている。

手動でJP1/Base Control Serviceサービスを停止した。

対処

要因への対処を示します。番号は，上記要因の番号に対応しています。

JP1/Power Monitorをインストールしてください。

JP1/Power Monitorを使って計画終了，または強制終了を行ってください。

[Control Value]セクションを定義ファイルに登録してください。

JP1/Power Monitorを使って計画終了，または強制終了を行ってください。

停止しないサービスの起動方法を［コントロールパネル］の［サービス］ダイアログボックスで「手動」に変更してください。

JP1/Power Monitorを使って計画終了，または強制終了を行ってください。

(7)　特定の順番でサービスを起動する必要があるため，起動管理機能を使ってサービスの起動完了を待って順番にサービスが起動するように定義している。しかし，先に起動する必要があるサービスの起動が完了しないうちに次のサービスが起動してしまい，エラーメッセージが出る。

直前のサービスの起動処理が完了してから次のサービスの起動処理が開始されるように定義していても，先に起動する必要があるサービスの起動処理が完了しないうちに次のサービスが起動してしまい，エラーメッセージが出る場合の要因と対処を次に示します。

要因

次に示す要因が考えられます。

起動管理機能（JP1/Base Control Serviceサービス）は，直前のサービスの起動処理を完了してから次のサービスの起動処理を開始しようとしたが，定義されている最大待ち時間を過ぎてもサービスの起動処理が完了しなかったため，次に定義されているサービスの起動処理を開始した。

起動順序定義ファイル（JP1SVPRM.DAT）の設定が，直前のサービスの起動処理の完了を待たずに，次のサービスを起動処理する設定になっている。

対処

要因への対処を示します。番号は，上記要因の番号に対応しています。

時間切れを起こしたサービスの起動に必要な時間を調査してください。そして，起動順序定義ファイル（JP1SVPRM.DAT）内の該当サービスのWait=パラメーターの値を，時間切れを起こさない時間に変更して運用してください。

起動順序定義ファイル（JP1SVPRM.DAT）内の該当サービスのParallel=パラメーターの設定を見直してください。詳細については，「14.　定義ファイル」の「起動順序定義ファイル（Windows限定）」を参照してください。

(8)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，"XXXXサービスが既に起動されています"と警告が出る。

起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，"XXXXサービスが既に起動されています"と警告メッセージが出る場合の要因と対処を次に示します。

要因

この警告メッセージは，起動管理機能を使って起動しようとしているサービスがすでに起動しているときに出力されます。この警告メッセージが出力される要因として，該当するサービスのスタートアップの設定が自動起動になっていることが考えられます。

対処

起動管理機能を使ってサービスを起動する場合は，そのサービスのスタートアップの設定を手動に変更してください。

(9)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，イベントビューアのアプリケーションログに「指定時間を過ぎてもXXXXサービスの起動完了が確認できませんでした。」のメッセージが出力される。

起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，イベントビューアのアプリケーションログに「指定時間を過ぎてもXXXXサービスの起動完了が確認できませんでした。」のメッセージが出力され，かつ，該当サービスが起動している場合は，次に示す設定を見直してください。また，このメッセージが出力され，かつ，該当サービスが起動していない場合は，該当サービス製作会社に，起動が失敗する原因について調査してもらってください。

Wait=パラメーターが該当サービスのセクション内に設定されていない場合

該当サービスを起動するのに，デフォルトの待ち時間60秒以上の時間を必要としています。該当サービスのセクション内にWait=パラメーターを設定し，60秒よりも大きい値を設定してください。

Wait=パラメーターが該当サービスのセクション内に設定されている場合

該当サービスを起動するのに，設定した待ち時間以上の時間を必要としています。該当サービスのWait=パラメーターの値を，現在設定している値より大きい値に変更してください。

(10)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，「KAVA4003-E 予期しないエラーが発生したため，XXXXサービスを起動できませんでした.」のメッセージが出力され，サービスが起動できない。

起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，「KAVA4003-E 予期しないエラーが発生したため，XXXXサービスを起動できませんでした」のメッセージが出る場合の要因と対処を次に示します。

要因

マシンの起動時に，Windowsのサービスコントロールマネージャーによって自動起動が設定されているサービスの起動と，起動管理機能で設定されているサービスの起動が並行して動作した場合に発生することがあります。

対処

起動管理機能で設定されているサービスが起動するタイミングを遅らせるよう設定してください。これによって，サービス起動時の過負荷による起動の失敗を回避できます。

設定の詳細については，「7.3　サービスが起動するタイミングを設定する」を参照してください。

(11)　ディレクトリサーバ連携機能有効時にログインできない。

ディレクトリサーバ連携機能有効時にログインできない場合は，統合トレースログを調査してください。次のエラーメッセージが出力されていたときは，マニュアル「JP1/Base メッセージ」を参照して要因と対処を確認し，ディレクトリサーバ管理者に連絡してください。

KAVA1677-W

KAVA1678-W

KAVA1679-W

KAVA1687-W

KAVA1688-W

KAVA1690-W

KAVA1691-W

16.5.3　UNIXの場合

UNIXの場合に発生する主なトラブルを次に示します。

表16-5　UNIXの場合のトラブル

項番 | トラブルの内容
1 | 認証サーバが起動しない
2 | イベントサービスを起動しようとすると，KAJP1005-EやKAJP1852-Eのエラーが発生してイベントサービスが起動できない

＜この項の構成＞

(1)　認証サーバが起動しない

(2)　イベントサービスを起動しようとすると，KAJP1005-EやKAJP1852-Eのエラーが発生してイベントサービスが起動できない

(1)　認証サーバが起動しない

認証サーバが起動しない場合の要因と対処について説明します。

要因

認証サーバを停止するように設定を変更した場合，jbssetusrsrvコマンドで自ホストを認証サーバに指定しただけでは，認証サーバは起動しません。

対処

jbssetusrsrvコマンドで自ホストを認証サーバに指定した後，次に示す操作をしてください。

cd /etc/opt/jp1base/conf
cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

(2)　イベントサービスを起動しようとすると，KAJP1005-EやKAJP1852-Eのエラーが発生してイベントサービスが起動できない

イベントサービスを起動しようとしてもエラーメッセージが発生して，イベントサービスが起動できない場合の要因と対処について説明します。

要因

次に示す要因が考えられます。

カーネルパラメーターがJP1/Baseおよびそのほかの製品を考慮した値に設定されていない。

イベントサーバインデックスファイル（index）で指定したディレクトリがシンボリックリンクされているが，そのシンボリックリンク先のディレクトリが存在しない。

イベントサービスの起動時に作成されるディレクトリが権限エラーなどで作成できない。

対処

要因への対処を示します。番号は，上記要因の番号に対応しています。

カーネルパラメーターの値を設定し直してください。なお，カーネルパラメーターの値については，「付録G　カーネルパラメーター一覧」を参照してください。

ディレクトリを作成し，シンボリックリンクを再作成してください。

ユーザーの権限をスーパーユーザー権限にして，イベントサービスを再起動してください。

16.5.4　ヘルスチェック機能で異常を検知した場合

ヘルスチェック機能では，JP1/Baseの各プロセスの異常を検知できます。ここでは，ヘルスチェック機能で検知した異常要因と対処方法について説明します。

＜この項の構成＞

(1)　システムリソース（CPU，ディスクなど）が大量に消費されている。または，プロセスへの要求が性能の限界を超えている。

(2)　すぐに終了するはずのコマンドが終了しない。または，コマンドがリソースを保持したまま終了しない。

(3)　プロセスがデッドロック，または無限ループの状態になっている。

(4)　監視対象ホストに接続できない。

(1)　システムリソース（CPU，ディスクなど）が大量に消費されている。または，プロセスへの要求が性能の限界を超えている。

高負荷の要因となっている処理をキャンセルしてください。

(2)　すぐに終了するはずのコマンドが終了しない。または，コマンドがリソースを保持したまま終了しない。

コマンドプロセスをkillコマンドなどのOS機能で強制終了してください。

(3)　プロセスがデッドロック，または無限ループの状態になっている。

プロセスがデッドロック，または無限ループの状態になって処理が長時間終了しない場合は，次の表に示す対処方法に従って対処してください。

項番
機能
プロセス名
対処方法

1
プロセス管理機能
jbs_spmd
JP1/Baseを再起動する。

Windowsの場合

JP1/Baseサービス（ユーザー管理を含むプロセス管理）を再起動する。

UNIXの場合

JP1/Baseを再起動する。※

2
認証サーバ
jbssessionmgr

3
構成管理
jbsroute

4
コマンド実行
jcocmd

5
プラグインサービス
jbsplugind

6
イベントサービス
jevservice

イベントサービスを再起動する。

Windowsの場合

JP1/Base Eventサービスを再起動する。

UNIXの場合

イベントサービスを再起動する。※

7
ログファイルトラップ
jevtraplog
jevtraplog
jevlogd
ログファイルトラップ管理サービス（デーモン）を再起動する。

Windowsの場合

JP1/Base LogTrapサービスを再起動する。

UNIXの場合

ログファイルトラップ管理デーモンを再起動する。※

jelparentim
エラーメッセージに示されるIDのログファイルトラップをjevlogstartコマンドで再起動する。

jelchildim

8
イベントログトラップ
jevtrapevt
イベントログトラップサービス（JP1/Base EventlogTrap）を再起動する。

9
SNMPトラップ変換
imevtgw
JP1/Cm2/NNMを再起動する。

10
ヘルスチェック
jbshcd
jbshchostd
JP1/Baseを再起動する。

Windowsの場合

JP1/Baseサービス（ユーザー管理を含むプロセス管理）を再起動する。

UNIXの場合

JP1/Baseを再起動する。※

注※　プロセスの終了コマンドで，該当するプロセスを停止したあと，ps -elコマンドで終了していないプロセスがないか確認してください。プロセスが残っている場合は，killコマンドで終了してください。その後，起動コマンドでプロセスを起動してください。

(4)　監視対象ホストに接続できない。

ホストが起動しているかどうか確認してください。

JP1/Baseが起動しているか確認してください。

ネットワークが正常かどうか確認してください。

監視対象ホストにインストールされたJP1/Baseのバージョンが07-11以降かどうか確認してください。

16.6　JP1/Base使用上の注意事項

JP1/Baseを使用する場合の注意事項について説明します。

＜この節の構成＞

(1)　システム起動時の注意事項

(2)　システム運用時の注意事項

(3)　ユーザー認証に関する注意事項

(4)　起動順序の制御に関する注意事項

(5)　JP1/Baseで使用するファイルおよびディレクトリに関する注意事項

(1)　システム起動時の注意事項

次のコマンドを同時に実行した場合，JP1/Baseの起動が正しく行われない場合があります。これらのコマンドを同時に実行しないでください。

jbs_start

jbs_start.cluster

jbs_spmd

(2)　システム運用時の注意事項

JP1/Baseを起動しているときは，次のコマンドを使用しないでください。

jbs_setup_cluster（Windowsの場合）

jbshostsimport

jbsunsetcnf

jevdbinit

jevdbmkrep

jp1base_setup（UNIXの場合）

jp1base_setup_cluster（UNIXの場合）

jp1bshasetup（Windowsの場合）

Jischk

Jiscond

Jisconv

Jiscpy

Jisext

Jiskeymnt

Jislckext

Jisprt

Jislckreg（UNIXの場合）

Jisrsdel（UNIXの場合）

JP1製品がJP1/Baseのユーザー認証を利用する機能を実行中でなければ，JP1/Baseを起動している状態で，次に示す環境設定情報を変更できます。

JP1ユーザーの設定

JP1資源グループ別権限レベルの設定（Windowsの場合）

JP1ユーザーの操作権限の設定（UNIXの場合）

認証サーバの変更

運用中に上記環境設定情報を変更する場合は，十分に注意してください。

(3)　ユーザー認証に関する注意事項

1台の認証サーバにログインの負荷が集中すると，「KAVB0109-E 接続ホストと認証サーバの間で，通信エラーが発生しました」，またはKAVB0105，KAVB0106，KAVB0108のメッセージが出力され，ログインできなくなることがあります。この現象が発生した場合，しばらく待ってから再度ログインを実行してください。
メッセージ「KAVB0109」「KAVB0105」「KAVB0106」および「KAVB0108」の詳細については，マニュアル「JP1/Integrated Management - Manager メッセージ」を参照してください。

JP1/IM - ViewまたはJP1/AJS - Viewからログインするときに，パスワードの後ろに付けたスペースは無視されます。

(4)　起動順序の制御に関する注意事項

JP1/Base Control Serviceサービスの［ログオン］の設定を「システムアカウント」以外に変更しないでください。また，［デスクトップの対話をサービスに許可］オプションにチェックを入れないでください。

JP1SVPRM.DATファイルには，対話形式のコマンドやダイアログボックスを表示するコマンドを登録しないでください。

(5)　JP1/Baseで使用するファイルおよびディレクトリに関する注意事項

UNIXでJP1/Baseを使用する場合，/var/opt/jp1base/tmp以下にはファイルなどを作成しないでください。作成した場合，削除される場合があります。

Windowsでは，コマンド実行機能でインストール先フォルダ¥COMMANDをカレントフォルダとして使用しています。そのため，JP1ユーザーにマッピングしているOSユーザーに対して，カレントフォルダの読み取り権限が必要となります。また，カレントフォルダにリダイレクトによるファイル作成や，一時ファイルの作成をする場合は，書き込み権限が必要となります。

付録

＜この付録の構成＞

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

付録B　プロセス一覧

付録C　ポート番号一覧

付録D　制限値一覧

付録E　性能と見積もり

付録F　正規表現の文法

付録G　カーネルパラメーター一覧

付録H　通信設定の変更対応

付録I　SNMPトラップを変換する

付録J　JP1/SESイベントを使用する製品との連携

付録K　操作ログの出力

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

付録M　用語解説

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

JP1/Baseで使用するファイルおよびディレクトリを次に示します。

＜この節の構成＞

付録A.1　Windowsの場合

付録A.2　UNIXの場合

付録A.1　Windowsの場合

表中のBase_Pathは，マニュアル本文中で使用している「インストール先フォルダ」です。なお，Base_Pathは，デフォルトでは次のフォルダとなります。

x86環境の場合：

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

x64環境の場合：

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

表中のSystemDriveは，マニュアル本文中で使用している「システムドライブ」です。

表A-1　JP1/Baseのファイルおよびフォルダ一覧（Windowsの場合）

内容
ファイル名・フォルダ名

コマンド格納フォルダ
Base_Path¥bin¥

環境設定フォルダ※¹
Base_Path¥conf¥
共有フォルダ¥jp1base¥conf¥

言語種別設定ファイル
Base_Path¥conf¥jp1bs_param.conf
共有フォルダ¥jp1base¥conf¥jp1bs_param.conf

構成定義ファイル
Base_Path¥conf¥route¥jbs_route.conf
共有フォルダ¥jp1base¥conf¥route¥jbs_route.conf

JP1/IM関数　ヘッダーファイル
Base_Path¥include¥JevApi.h

ログフォルダ※²
Base_Path¥log¥
共有フォルダ¥jp1base¥log¥

プラグイン用フォルダ
Base_Path¥plugin¥

稼働情報格納フォルダ
Base_Path¥sys¥OPI¥
共有フォルダ¥jp1base¥sys¥OPI¥

readme
Base_Path¥readme.txt

イベントDB格納フォルダ※³
Base_Path¥sys¥event¥servers¥※⁴
共有フォルダ¥jp1base¥event¥※⁴

ログおよびテンポラリーフォルダ※²
Base_Path¥sys¥tmp¥event¥servers¥※⁴

JP1/AJS互換用イベントID保存ファイル

Base_Path¥sys¥tmp¥event¥servers¥default¥ereb.backup※⁴

共有フォルダ¥jp1base¥event¥ereb.backup※⁴

ログファイルトラップ機能内部動作ファイル

Base_Path¥sys¥tmp¥event¥logtrap¥conftbl.ID番号

ツール関連フォルダ
Base_Path¥tools¥

資料採取ツールサンプルバッチファイル

Base_Path¥tools¥jbs_log.bat

JP1イベントを発行および取得する関数サンプルソースファイル

Base_Path¥tools¥event¥receiver.c

Base_Path¥tools¥event¥sender.c

AR System連携用サンプルバッチファイル

Base_Path¥tools¥helpdesk¥register_ars.bat

統合トレースログフォルダ
SystemDrive¥Program Files¥Hitachi¥HNTRLib2¥spool¥

注※1　定義ファイルについては，「付録A.1(1)　定義ファイル一覧（Windowsの場合）」を参照してください。

注※2　ログファイルについては，「付録A.1(2)　ログファイル一覧（Windowsの場合）」を参照してください。

注※3　イベントDBのファイル名については，「1.4.2　イベントDBの概要」を参照してください。

注※4　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるフォルダに格納されます。

＜この項の構成＞

(1)　定義ファイル一覧（Windowsの場合）

(2)　ログファイル一覧（Windowsの場合）

(1)　定義ファイル一覧（Windowsの場合）

JP1/Baseで使用する定義ファイルの一覧を次に示します。

表A-2　定義ファイル一覧（Windowsの場合）

機能
ファイル名・フォルダ名

起動管理機能

起動順序定義ファイル

Base_Path¥conf¥boot¥JP1SVPRM.DAT

Base_Path¥conf¥boot¥JP1SVPRM.DAT.MODEL

サービス起動遅延時間／タイマー監視時間定義ファイル

Base_Path¥conf¥boot¥jp1svprm_wait.dat

Base_Path¥conf¥boot¥jp1svprm_wait.dat.sample

イベントサービス

イベントサーバインデックスファイル

Base_Path¥conf¥event¥index

イベントサーバ設定ファイル

Base_Path¥conf¥event¥servers¥default¥conf※¹

共有フォルダ¥jp1base¥event¥conf※1

転送設定ファイル

Base_Path¥conf¥event¥servers¥default¥forward※¹

共有フォルダ¥jp1base¥event¥forward※¹

API設定ファイル

Base_Path¥conf¥event¥api

JP1/AJS互換用定義ファイル

Base_Path¥sys¥tmp¥event¥servers¥default¥ajses.def

イベント変換機能

ログファイルトラップ動作定義ファイル

任意のファイルおよび任意のフォルダを指定できます。

ログファイルトラップ起動定義ファイル

Base_Path¥conf¥event¥jevlog_start.conf

ログ情報定義ファイル

Base_Path¥conf¥event¥jevlogd.conf

イベントログトラップ動作定義ファイル

Base_Path¥conf¥event¥ntevent.conf

SNMPトラップ変換動作定義ファイル

Base_Path¥conf¥evtgwt¥imevtgw.conf

共有フォルダ¥jp1base¥conf¥evtgwt¥imevtgw.conf※2

SNMPトラップ変換フィルターファイル

Base_Path¥conf¥evtgwt¥snmpfilter.conf

共有フォルダ¥jp1base¥conf¥evtgwt¥snmpfilter.conf※2

イベントサービスの定義情報の収集・配布機能

配布定義ファイル（転送設定ファイル）

Base_Path¥conf¥event¥servers¥default¥[jev_forward.conf | 任意のファイル]※3

共有フォルダ¥jp1base¥event¥[jev_forward.conf | 任意のファイル]※3

配布定義ファイル（ログファイルトラップ動作定義ファイル）

Base_Path¥conf¥[jev_logtrap.conf | 任意のファイル]※3

配布定義ファイル（イベントログトラップ動作定義ファイル）

Base_Path¥conf¥event¥[jev_ntevent.conf | 任意のファイル]※3

ユーザー管理機能

パスワード定義ファイル

任意のファイルおよび任意のフォルダを指定できます。

ユーザー権限レベルファイル

Base_Path¥conf¥user_acl¥JP1_UserLevel

共有フォルダ¥jp1base¥conf¥user_acl¥JP1_UserLevel

ディレクトリサーバ変更ファイル

任意のファイルおよび任意のフォルダを指定できます。

ディレクトリサーバ連携定義ファイル

Base_Path¥conf¥ds¥jp1bs_ds_setup.conf

Base_Path¥conf¥ds¥jp1bs_ds_setup.conf.model

共有フォルダ¥jp1base¥conf¥ds¥jp1bs_ds_setup.conf

共有フォルダ¥jp1base¥conf¥ds¥jp1bs_ds_setup.conf.model

ユーザーマッピング定義ファイル

Base_Path¥conf¥user_acl¥jp1BsUmap.conf

共有フォルダ¥jp1base¥conf¥user_acl¥jp1BsUmap.conf

ヘルスチェック機能

ヘルスチェック定義ファイル

Base_Path¥conf¥jbshc¥jbshc.conf

共有フォルダ¥jp1base¥conf¥jbshc¥jbshc.conf

共通定義設定用ファイル（ヘルスチェック機能）のモデルファイル

Base_Path¥conf¥jbshc¥jbshc_setup.conf.model

共有フォルダ¥jp1base¥conf¥jbshc¥jbshc_setup.conf.model

共通定義設定用ファイル（ヘルスチェック機能）（07-10以前からのバージョンアップ用）のモデルファイル

Base_Path¥default¥jbshc_com.conf.model

共有フォルダ¥jp1base¥default¥jbshc_com.conf.model

プラグインサービス

要求転送設定ファイル

Base_Path¥conf¥plugin¥reqforward.conf

共有フォルダ¥jp1base¥conf¥plugin¥reqforward.conf

操作ログ出力機能

操作ログ定義ファイル

Base_Path¥conf¥jp1bs_baselog_setup.conf

Base_Path¥conf¥jp1bs_baselog_setup.conf.model

プロセス管理機能

JP1/Baseパラメーター定義ファイル

Base_Path¥conf¥jp1bs_param_V7.conf

共有フォルダ¥jp1base¥conf¥jp1bs_param_V7.conf

拡張起動プロセス定義ファイル

Base_Path¥conf¥jp1bs_service_0700.conf

共有フォルダ¥jp1base¥conf¥jp1bs_service_0700.conf

通信設定

jp1hosts定義ファイル

Base_Path¥conf¥jp1hosts

共有フォルダ¥jp1base¥conf¥jp1hosts

通信方式設定ファイル

Base_Path¥conf¥physical_ipany.conf

Base_Path¥conf¥logical_ipany.conf

Base_Path¥conf¥physical_recovery_0651.conf

Base_Path¥conf¥logical_recovery_0651.conf

Base_Path¥conf¥physical_anyany.conf

Base_Path¥conf¥physical_ipip.conf

Base_Path¥conf¥logical_ipip.conf

共有フォルダ¥jp1base¥conf¥physical_ipany.conf

共有フォルダ¥jp1base¥conf¥logical_ipany.conf

共有フォルダ¥jp1base¥conf¥physical_recovery_0651.conf

共有フォルダ¥jp1base¥conf¥logical_recovery_0651.conf

共有フォルダ¥jp1base¥conf¥physical_anyany.conf

共有フォルダ¥jp1base¥conf¥physical_ipip.conf

共有フォルダ¥jp1base¥conf¥logical_ipip.conf

ホストアクセス制限定義ファイル

Base_Path¥conf¥jbsdfts¥jbsdfts_srv.conf

ローカルアクション機能

ローカルアクション環境変数ファイル

任意のファイルおよび任意のフォルダを指定できます。

ローカルアクション実行定義ファイル

Base_Path¥conf¥lcact¥jbslcact.conf

共有フォルダ¥jp1base¥conf¥lcact¥jbslcact.conf

共通定義設定用ファイル（ローカルアクション機能）

Base_Path¥conf¥lcact¥jp1bs_lcact_setup.conf.model

共有フォルダ¥jp1base¥conf¥lcact¥jp1bs_lcact_setup.conf.model

注※1　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるフォルダに格納されます。

注※2　これらのファイルは使用されません。

注※3　定義情報の配布機能を使用していない場合には存在しません。

(2)　ログファイル一覧（Windowsの場合）

JP1/Baseが出力するデフォルトのログファイルの一覧を次の表に示します。

注意

JP1/Baseが出力するログファイルには，製品保守の必要上出力している内部ログファイルがあります。これらは，ユーザーが参照，または変更する必要はありません。なお，システム障害が発生したときなど資料採取のために，これらのファイルをご利用元で一時保管していただくことがあります。

「ログの種類」には，JP1/Baseが出力するログの種類を記載しています。

「ファイル名・フォルダ名」には，JP1/Baseをデフォルトでインストールした場合のログファイル名と，クラスタ運用の場合のログファイル名をそれぞれフルパスで記載しています。

「最大ディスク占有量」には，ログファイルが最大でどの程度ディスクを使用するのかを記載しています。ログファイルが複数ある場合は，その合計量を記載しています。

「ファイルの切り替え時期」には，JP1/Baseが出力先のログファイルを切り替えるタイミングを記載しています。ファイルがこの欄に示すサイズに達したとき，または，この欄に示す事象が起きたときに出力先が切り替わります。なお，ログファイルが一つの場合，ファイルの切り替えが発生すると同ファイルに上書きされます。ログファイルが複数あり，最大ディスク占有量に達した場合は，更新日付の古いファイルから上書きされます。

表A-3　ログファイル一覧（Windowsの場合）

ログの種類
ファイル名・フォルダ名
最大ディスク占有量
ファイルの切り替え時期

プロセス管理ログ

Base_Path¥log¥JBS_SPMD{1|2|3}.log

共有フォルダ¥jp1base¥log¥JBS_SPMD{1|2|3}.log

384KB
128KB

Base_Path¥log¥JBS_SPMD_COMMAND{1|2|3}.log

共有フォルダ¥jp1base¥log¥JBS_SPMD_COMMAND{1|2|3}.log

384KB
128KB

Base_Path¥log¥JBS_SERVICE{1|2|3}.log

共有フォルダ¥jp1base¥log¥JBS_SERVICE{1|2|3}.log

384KB
128KB

認証サーバログ

Base_Path¥log¥jbssessionapi.log{1|2|3|4|5|6|7|8}.log※1

共有フォルダ¥jp1base¥log¥jbssessionapi.log{1|2|3|4|5|6|7|8}.log※1

2MB
256KB

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥jbssessionapi.log{1|2|3|4|5|6|7|8}.log※2※3

%ALLUSERSPROFILE%¥Hitachi¥JP1¥論理ホスト名¥JP1Base¥log¥jbssessionapi.log{1|2|3|4|5|6|7|8}.log※2※3

2MB
256KB

Base_Path¥log¥jbssessionmgr{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbssessionmgr{1|2|3|4|5|6|7|8}.log

2MB
256KB

Base_Path¥log¥jbssessionmgr_trace{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥ jbssessionmgr_trace{1|2|3|4|5|6|7|8}.log

2MB
256KB

認証サーバ設定コマンドログ

Base_Path¥log¥JBSSESS{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JBSSESS{1|2|3|4|5|6|7|8}.log

2MB
256KB

Base_Path¥log¥JBS_SETUP¥JBSSETUPSRV{1|2}.log

128KB
64KB

環境設定プログラムログ

Base_Path¥log¥jp1bssetup{1|2}.log

共有フォルダ¥jp1base¥log¥jp1bssetup{1|2}.log

128KB
64KB

論理ホスト設定プログラムログ

Base_Path¥log¥jp1hasetup.{log|log.old}

2,000KB
1,000KB

Base_Path¥log¥JBS_SETUP¥JBSSETUPCLUSTER{1|2}.log

128KB
64KB

SNMPトラップ変換機能ログ（定義情報）

Base_Path¥log¥imevtgw.conf{1|2|3}.log

3MB
1MB

SNMPトラップ変換機能ログ（監視情報）

Base_Path¥log¥imevtgw.log{1|2|3}.log

15MB
5MB

コマンド実行履歴ファイル（ISAM）※4

Base_Path¥log¥COMMAND¥ACTISAMLOGV8.DRF

共有フォルダ¥jp1base¥log¥COMMAND¥ ACTISAMLOGV8.DRF

125MB※5
125MB※5

Base_Path¥log¥COMMAND¥ACTISAMLOGV8.K01

共有フォルダ¥jp1base¥log¥COMMAND¥ ACTISAMLOGV8.K01

200KB※5
なし

Base_Path¥log¥COMMAND¥ACTISAMLOGV8.KDF

共有フォルダ¥jp1base¥log¥COMMAND¥ ACTISAMLOGV8.KDF

1KB
コマンド実行時

Base_Path¥log¥COMMAND¥CMDISAMLOGV8.DRF

共有フォルダ¥jp1base¥log¥COMMAND¥ CMDISAMLOGV8.DRF

125MB※5
125MB※5

Base_Path¥log¥COMMAND¥CMDISAMLOGV8.K01

共有フォルダ¥jp1base¥log¥COMMAND¥ CMDISAMLOGV8.K01

200KB※5
なし

Base_Path¥log¥COMMAND¥CMDISAMLOGV8.KDF

共有フォルダ¥jp1base¥log¥COMMAND¥ CMDISAMLOGV8.KDF

1KB
コマンド実行時

共通定義情報ログ

Base_Path¥log¥JBSCNFCMD¥JBSCNFCMD{1|2}.log

共有フォルダ¥jp1base¥log¥JBSCNFCMD¥JBSCNFCMD{1|2}.log

128KB
64KB

jp1hosts情報コマンドログ

Base_Path¥log¥JBSCNFCMD¥JBSCOMMCMD{1|2}.log

共有フォルダ¥jp1base¥log¥JBSCNFCMD¥JBSCOMMCMD{1|2}.log

128KB
64KB

ユーザーマッピングコマンドログ

Base_Path¥log¥JBSUMAPCMD¥JBSUMAPCMD{1|2}.log

共有フォルダ¥jp1base¥log¥JBSUMAPCMD¥JBSUMAPCMD{1|2}.log

128KB
64KB

リモートコマンドログ※4

Base_Path¥log¥JCOCMD¥jcocmd_result{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmd_result{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥jcocmdapi{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdapi{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥jcocmdapi_trace{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdapi_trace{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥jcocmdcom{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdcom{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥jcocmdcom_trace{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdcom_trace{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥jcocmdexe{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdexe{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥jcocmdexe_trace{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdexe_trace{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥jcocmdrouter{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdrouter{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥jcocmdrouter_trace{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdrouter_trace{1|2|3}.log

2,304KB
768KB

Base_Path¥log¥JCOCMD¥JCOCMDCMD{1|2|3}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥JCOCMDCMD{1|2|3}.log

2,304KB
768KB

プラグインサービスログ

Base_Path¥log¥plugin¥jbsplugin{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbsplugin{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

Base_Path¥log¥plugin¥jbsplugincom_{0|1|2|3|4|5|6|7|8|9}※6_{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbsplugincom_{0|1|2|3|4|5|6|7|8|9}※6_{1|2|3|4|5|6|7|8}.log

20MB
256KB

Base_Path¥log¥plugin¥jbsplugincmd{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbsplugincmd{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

Base_Path¥log¥plugin¥jbspluginmgrapi{1|2|3|4|5|6|7|8}.log※1

共有フォルダ¥jp1base¥log¥plugin¥jbspluginmgrapi{1|2|3|4|5|6|7|8}.log※1

2,048KB
256KB

Base_Path¥log¥plugin¥jbsplugincomapi{1|2|3|4|5|6|7|8}.log※1

共有フォルダ¥jp1base¥log¥plugin¥jbsplugincomapi{1|2|3|4|5|6|7|8}.log※1

2,048KB
256KB

Base_Path¥log¥plugin¥jbsplugincmdapi{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbsplugincmdapi{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

Base_Path¥log¥plugin¥jbspluginhcshm{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbspluginhcshm{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

Base_Path¥log¥plugin¥jbsrmtcmd{1|2|3|4|5|6|7|8}.log※1

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥plugin¥jbsrmtcmd{1|2|3|4|5|6|7|8}.log※2※3

2,048KB
256KB

Base_Path¥log¥plugin¥jjbspluginremotecmd{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbspluginremotecmd{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

Base_Path¥log¥plugin¥jbsrmtapi{1|2|3|4|5|6|7|8}.log※1

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥plugin¥jbsrmtapi{1|2|3|4|5|6|7|8}.log※2※3

2,048KB
256KB

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥plugin¥jbspluginmgrapi{1|2|3|4|5|6|7|8}.log※2※3

%ALLUSERSPROFILE%¥Hitachi¥JP1¥論理ホスト名¥JP1Base¥log¥jbspluginmgrapi{1|2|3|4|5|6|7|8}.log※2※3

2,048KB
256KB

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥plugin¥jbsplugincomapi{1|2|3|4|5|6|7|8}.log※2※3

%ALLUSERSPROFILE%¥Hitachi¥JP1¥論理ホスト名¥JP1Base¥log¥jbsplugincomapi{1|2|3|4|5|6|7|8}.log※2※3

2,048KB
256KB

構成管理ログ※4

Base_Path¥log¥route¥JBSRT{1|2|3}.log

共有フォルダ¥jp1base¥log¥route¥JBSRT{1|2|3}.log

384KB
128KB

起動順序制御ログ

Base_Path¥log¥boot¥ContServ{1|2}.log

128KB
64KB

イベントログトラップトレースログ

Base_Path¥log¥ntevtrap¥trace{1|2}.log

1,024KB
512KB

イベントログトラップトラップログ

Base_Path¥log¥ntevtrap¥trap{1|2|3|4}.log※3

4,096KB
1,024KB

ヘルスチェック機能ログ（自ホスト監視）

Base_Path¥log¥jbshc¥jbshc{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshc{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

ヘルスチェック機能ログ（他ホスト監視）

Base_Path¥log¥jbshc¥jbshchost{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshchost{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

ヘルスチェックコマンドログ

Base_Path¥log¥jbshc¥jbshcstatus{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshcstatus{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

ヘルスチェックAPI用ログ

Base_Path¥log¥jbshc¥jbshcapi{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshcapi{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

ヘルスチェック共有メモリー削除コマンドログ

Base_Path¥log¥jbshc¥jbshcshmctl{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshcshmctl{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

アプリケーションエラーログ

Base_Path¥log¥jbsdump.log

5MB
5MB

操作ログ

Base_Path¥log¥BASE¥base_log[{1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16}].log

68MB※7
1,024KB※7※8

イベント設定一元管理取得コマンド用トレースログ

Base_Path¥sys¥tmp¥event¥servers¥default¥jevdef_get.{000|001|002}※9

共有フォルダ¥jp1base¥event¥jevdef_get.{000|001|002}※9

64KB
コマンド実行時

イベント設定一元管理配布コマンド用トレースログ

Base_Path¥sys¥tmp¥event¥servers¥default¥jevdef_distrib.{000|001|002}※9

共有フォルダ¥jp1base¥event¥jevdef_distrib.{000|001|002}※9

64KB
コマンド実行時

イベントサービス用トレースログ

Base_Path¥sys¥tmp¥event¥servers¥default¥trace.{000|001|002|003|004}※9※10

共有フォルダ¥jp1base¥event¥trace.{000|001|002|003|004}※9※10

5MB※10
イベントサービス起動時

Base_Path¥sys¥tmp¥event¥servers¥default¥imevterr.{000|001|002|003|004}※9※10

共有フォルダ¥jp1base¥event¥imevterr.{000|001|002|003|004}※9※10

5MB※10
イベントサービス起動時

イベントサービス用転送エラーログ

Base_Path¥sys¥tmp¥event¥servers¥default¥fwderr.{000|001|002|003|004}※9※10

共有フォルダ¥jp1base¥event¥fwderr.{000|001|002|003|004}※9※10

5MB※10
イベントサービス起動時

イベントサービス用エラーログ

Base_Path¥sys¥tmp¥event¥servers¥default¥error.{000|001|002|003|004}※9※10

共有フォルダ¥jp1base¥event¥error.{000|001|002|003|004}※9※10

2,500KB※10
イベントサービス起動時

イベントサービスAPI用ログ

Base_Path¥sys¥tmp¥event¥IMEvapi.{000|001|002|003|004}※1※11

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥event¥IMEvapi.{000|001|002|003|004}※³※¹¹※¹²

5MB※11
1MB※11

JP1/AJS互換用ソケット通信コネクションログ

Base_Path¥sys¥tmp¥event¥servers¥default¥evtrace.dir¥{ajevconn.csv|ajevconn.bak}※9

2,000行※13
1,000行

JP1/AJS互換用JP1/SES形式イベント送受信ログ

Base_Path¥sys¥tmp¥event¥servers¥default¥evtrace.dir¥{ajevtrap.csv|ajevtrap.bak}※9

2,000行※13
1,000行

ログファイルトラップエラーログ

Base_Path¥sys¥tmp¥event¥logtrap¥.errorfile.ID番号

数百バイト程度※14
ログファイルトラップ起動時

ログファイルトラップログ

Base_Path¥sys¥tmp¥event¥logtrap¥jevtraplog¥jevtraplog.{000|001|002|003|004}

5MB※15
1MB※15

ログファイルトラップ起動実行結果ログ

Base_Path¥log¥jevlog_start¥jevlog_start{1|2|3}.log※17※18

3MB
1MB

リモート監視ログ（ログファイルトラップ）

Base_Path¥sys¥tmp¥event¥logtrap¥jelallog¥jelallog{1-5}.log※17

10MB
2MB

リモート監視ログ（イベントログトラップ）

Base_Path¥sys¥tmp¥event¥logtrap¥jelalelt¥jelalelt{1-5}.log※17

10MB
2MB

インストール時のログ

Windowsのインストール先フォルダ¥Temp¥HITACHI_JP1_INST_LOG¥jp1base_inst{1|2|3|4|5}.log※1

128KB
インストール時

Windowsのインストール先フォルダ¥Temp¥jp1common¥jp1base¥hliclib*.log※1※3

5MB
1MB

Windowsのインストール先フォルダ¥Temp¥HCDINST¥P-282C-6L94[_{1|2|3|4|5}].LOG※19

サーバ系OSのターミナルサービス環境では，次のようにログ出力先が変わります。

%USERPROFILE%¥WINDOWS¥Temp¥HCDINST¥P-282C-6L94[_{1|2|3|4|5}].LOG※19

512KB
インストール時

Windowsのインストール先フォルダ¥Temp¥HCDINST¥P-2A2C-6L94[_{1|2|3|4|5}].LOG※3

サーバ系OSのターミナルサービス環境では，次のようにログ出力先が変わります。

%USERPROFILE%¥WINDOWS¥Temp¥HCDINST¥P-2A2C-6L94[_{1|2|3|4|5}].LOG※3

512KB
インストール時

Windowsのインストール先フォルダ¥Temp¥HCDINST¥P-2D2C-6L94[_{1|2|3|4|5}].LOG※20

サーバ系OSのターミナルサービス環境では，次のようにログ出力先が変わります。

%USERPROFILE%¥WINDOWS¥Temp¥HCDINST¥P-2D2C-6L94[_{1|2|3|4|5}].LOG※20

512KB
インストール時

プロセス間通信トレースログ

Base_Path¥log¥JBSCOM¥jbscomd {1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd{1|2|3|4}.log

4MB
1MB

Base_Path¥log¥JBSCOM¥jbscomd_api {1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd_api{1|2|3|4}.log

4MB
1MB

Base_Path¥log¥JBSCOM¥jbscomd_ses {1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd_ses{1|2|3|4}.log

4MB
1MB

Base_Path¥log¥JBSCOM¥jbscomd _snd{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd_snd{1|2|3|4}.log

4MB
1MB

Base_Path¥log¥JBSCOM¥jbscomd _rcv{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd_rcv{1|2|3|4}.log

4MB
1MB

Base_Path¥log¥JBSCOM¥command {1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥command{1|2|3|4}.log

4MB
1MB

稼働情報採取コマンドエラーログ

Base_Path¥log¥jbsopi¥jbsopi_cmd{1|2|3|4|5}.log

5MB
1MB

稼働情報API用ログ

Base_Path¥log¥jbsopi¥jbsopi_api{1|2|3|4|5}.log

共有フォルダ¥jp1base¥log¥jbsopi¥jbsopi_api{1|2|3|4|5}.log

5MB
1MB

サービス管理制御ログ

Base_Path¥log¥jbssrvmgr¥jbssrvmgr{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥jbssrvmgr¥jbssrvmgr{1|2|3|4}.log

4MB
1MB

サービス管理制御トレースログ

Base_Path¥log¥jbssrvmgr¥jbssrvmgr_trace{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥jbssrvmgr¥jbssrvmgr_trace{1|2|3|4}.log

4MB
1MB

サービス管理制御API用ログ

Base_Path¥log¥jbssrvmgr¥jbssrvmgr_api{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥jbssrvmgr¥jbssrvmgr_api{1|2|3|4}.log

4MB
1MB

ローカルアクション実行履歴ログ

Base_Path¥log¥lcact¥localact{1～n}※16.log

共有フォルダ¥jp1base¥log¥lcact¥localact{1～n}※16.log

1,024KB※16
256KB※16

ローカルアクションログ

Base_Path¥log¥jbslcact¥jbslcact{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbslcact¥jbslcact{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

Base_Path¥log¥jbslcact¥jbslcact_list{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbslcact¥jbslcact_list{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

Base_Path¥log¥jbslcact¥jbslcact_cancel{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbslcact¥jbslcact_cancel{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

製品情報ログ

Base_Path¥log¥hliclib¥hliclib*.log

5MB
1MB

注※1　Windows XP ProfessionalまたはWindows Server 2003の場合。

注※2　インストール時の環境変数「%ALLUSERSPROFILE%」に設定されている値になります。

注※3　Windows VistaまたはWindows Server 2008の場合。

注※4　JP1/IM - Manager用のログファイルです。

注※5　JP1/IM - Managerのjcocmddefコマンドの-recordオプションを使うことで以下の範囲で変更できます。

レコード数1の場合（-record 1）
DRFファイル:7KB，K01ファイル:4KB

レコード数20,000の場合（デフォルト値）
DRFファイル:125MB，K01ファイル:200KB

レコード数196,600の場合（-record 196600）
DRFファイル:1.2GB，K01ファイル:2MB

注※6　jbsplugincomプロセス識別番号を示します。

注※7　ファイル数・最大ディスク占有量は，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で変更できます。変更できる範囲については，「付録K.5　操作ログを出力するための設定」を参照してください。

注※8　JP1/Base起動時に，ファイルの切り替えを自動で行うか行わないかを，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で指定できます。

注※9　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるフォルダに格納されます。

注※10　ファイル数，最大ディスク占有量は，イベントサーバ設定ファイル（conf）で変更できます。変更できる範囲については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

注※11　ファイル数・最大ディスク占有量は，API設定ファイル（api）で変更できます。変更できる範囲については，「14.　定義ファイル」の「API設定ファイル」を参照してください。

注※12　実行時の環境変数「%ALLUSERSPROFILE%」に設定されている値になります。

注※13　1行は100バイト程度です。

注※14　ログファイルトラップ起動時に作成され，正常終了時に削除されます。エラー発生時には，ログファイルトラップを終了したときにファイルがそのまま残ります。ログファイルトラップでエラーが多発すると，エラーファイルが増えていくため，不要なエラーファイルは削除する必要があります。

注※15　ファイル数・最大ディスク占有量は，ログ情報定義ファイル（jevlogd.conf）で変更できます。変更できる範囲については，「14.　定義ファイル」の「ログ情報定義ファイル」を参照してください。

注※16　ファイル数・最大ディスク占有量は，共通定義設定用ファイル（ローカルアクション機能）で変更できます。変更できる範囲については，「14.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。

注※17　ログの出力形式は，HNTRLib2（マルチプロセス対応トレース）です。

注※18　ログを削除する場合，ログ出力先フォルダにあるmmapフォルダも削除してください。

注※19　Windows Server 2003（IPF）の場合。

注※20　Windows Server 2008（IPF）の場合。

付録A.2　UNIXの場合

表A-4　JP1/Baseのファイルおよびディレクトリ一覧（UNIXの場合）

内容
ファイル名・ディレクトリ名

コマンド格納ディレクトリ
/opt/jp1base/bin/

環境設定ディレクトリ※¹
/etc/opt/jp1base/conf/
共有ディレクトリ/jp1base/conf/

言語種別設定ファイル
/etc/opt/jp1base/conf/jp1bs_param.conf
共有ディレクトリ/jp1base/conf/jp1bs_param.conf

構成定義ファイル
/etc/opt/jp1base/conf/route/jbs_route.conf
共有ディレクトリ/jp1base/conf/route/jbs_route.conf

JP1/IM関数　ヘッダーファイル
/opt/jp1base/include/JevApi.h

ログディレクトリ※²
/var/opt/jp1base/log/
共有ディレクトリ/jp1base/log/

プラグイン用ディレクトリ
/opt/jp1base/plugin/

稼働情報格納ディレクトリ
/var/opt/jp1base/sys/OPI/
共有ディレクトリ/jp1base/sys/OPI/

イベントDB格納ディレクトリ※³
/var/opt/jp1base/sys/event/servers/※⁴
共有ディレクトリ/event/※⁴

ログおよびテンポラリーディレクトリ※²
/var/opt/jp1base/sys/tmp/event/servers/※⁴

JP1/SES互換用イベントID保存ファイル

/var/opt/jp1base/sys/tmp/event/servers/default/ereb.backup※⁴

ログファイルトラップ機能内部動作ファイル

/var/opt/jp1base/sys/tmp/event/logtrap/conftbl.ID番号

ツール関連ディレクトリ
/opt/jp1base/tools/

資料採取ツールサンプルスクリプトファイル

/opt/jp1base/tools/jbs_log.sh

JP1イベントを発行および取得する関数サンプルソースファイル

/opt/jp1base/tools/event/receiver.c

/opt/jp1base/tools/event/sender.c

AR System連携用サンプルスクリプトファイル

/opt/jp1base/tools/helpdesk/register_ars.sh

統合トレースログディレクトリ
/var/opt/hitachi/HNTRLib2/spool/

JP1/SES互換用ディレクトリ
/usr/bin/jp1_ses/，/usr/lib/jp1_ses/および/usr/lib/jp1_ses/sys/

JP1/SES互換用テンポラリーディレクトリ
/usr/tmp/jp1_ses/

JP1/SES互換用メッセージカタログディレクトリ
/usr/lib/jp1_ses/nls/

JP1/SES互換用ログディレクトリ
/usr/lib/jp1_ses/log/および/tmp/(.JP1_SESで始まるファイル)

注※1　定義ファイルについては，「付録A.2(1)　定義ファイル一覧（UNIXの場合）」を参照してください。

注※2　ログファイルについては，「付録A.2(2)　ログファイル一覧（UNIXの場合）」を参照してください。

注※3　イベントDBのファイル名については，「1.4.2　イベントDBの概要」を参照してください。

注※4　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるディレクトリに格納されます。

＜この項の構成＞

(1)　定義ファイル一覧（UNIXの場合）

(2)　ログファイル一覧（UNIXの場合）

(1)　定義ファイル一覧（UNIXの場合）

JP1/Baseで使用する定義ファイルの一覧を次に示します。

表A-5　定義ファイル一覧（UNIXの場合）

機能
ファイル名・ディレクトリ名

イベントサービス

イベントサーバインデックスファイル

/etc/opt/jp1base/conf/event/index

イベントサーバ設定ファイル

/etc/opt/jp1base/conf/event/servers/default/conf※¹

共有ディレクトリ/event/conf※¹

転送設定ファイル

/etc/opt/jp1base/conf/event/servers/default/forward※1

共有ディレクトリ/event/forward※1

API設定ファイル

/etc/opt/jp1base/conf/event/api

JP1/SES互換用定義ファイル

/var/opt/jp1base/sys/tmp/event/servers/default/jpevent.conf

イベント変換機能

ログファイルトラップ動作定義ファイル

任意のファイルおよび任意のディレクトリを指定できます。

ログファイルトラップ起動定義ファイル

/etc/opt/jp1base/conf/event/jevlog_start.conf

ログ情報定義ファイル

/etc/opt/jp1base/conf/event/jevlogd.conf

SNMPトラップ変換動作定義ファイル

/etc/opt/jp1base/conf/evtgw/imevtgw.conf

共有ディレクトリ/jp1base/conf/evtgw/imevtgw.conf※2

SNMPトラップ変換フィルターファイル

/etc/opt/jp1base/conf/evtgw/snmpfilter.conf

共有ディレクトリ/jp1base/conf/evtgw/snmpfilter.conf※2

イベントサービスの定義情報の収集・配布機能

配布定義ファイル（転送設定ファイル）

/etc/opt/jp1base/conf/event/servers/default/[jev_forward.conf | 任意のファイル]※3

共有ディレクトリ/event/[jev_forward.conf | 任意のファイル]※3

配布定義ファイル（ログファイルトラップ動作定義ファイル）

/etc/opt/jp1base/conf/[jev_logtrap.conf | 任意のファイル]※3

配布定義ファイル（イベントログトラップ動作定義ファイル）

/etc/opt/jp1base/conf/event/[jev_ntevent.conf | 任意のファイル]※3

ユーザー管理機能

ユーザー権限レベルファイル

/etc/opt/jp1base/conf/user_acl/JP1_UserLevel

共有ディレクトリ/jp1base/conf/user_acl/JP1_UserLevel

ユーザーマッピング定義ファイル

/etc/opt/jp1base/conf/user_acl/jp1BsUmap.conf

共有ディレクトリ/jp1base/conf/user_acl/jp1BsUmap.conf

ヘルスチェック機能

ヘルスチェック定義ファイル

/etc/opt/jp1base/conf/jbshc/jbshc.conf

共有ディレクトリ/jp1base/conf/jbshc/jbshc.conf

共通定義設定用ファイル（ヘルスチェック機能）のモデルファイル

/etc/opt/jp1base/conf/jbshc/jbshc_setup.conf.model

共有ディレクトリ/jp1base/conf/jbshc/jbshc_setup.conf.model

共通定義設定用ファイル（ヘルスチェック機能）（07-10以前からのバージョンアップ用）のモデルファイル

/etc/opt/jp1base/default/jbshc_com.conf.model

共有ディレクトリ/jp1base/default/jbshc_com.conf.model

プラグインサービス

要求転送設定ファイル

/etc/opt/jp1base/conf/plugin/reqforward.conf

共有ディレクトリ/jp1base/conf/plugin/reqforward.conf

操作ログ出力機能

操作ログ定義ファイル

/etc/opt/jp1base/conf/jp1bs_baselog_setup.conf

/etc/opt/jp1base/conf/jp1bs_baselog_setup.conf.model

プロセス管理機能

JP1/Baseパラメーター定義ファイル

/etc/opt/jp1base/conf/jp1bs_param_V7.conf

共有ディレクトリ/jp1base/conf/jp1bs_param_V7.conf

拡張起動プロセス定義ファイル

/etc/opt/jp1base/conf/jp1bs_service_0700.conf

共有ディレクトリ/jp1base/conf/jp1bs_service_0700.conf

通信設定

jp1hosts定義ファイル

/etc/opt/jp1base/conf/jp1hosts

共有ディレクトリ/jp1base/conf/jp1hosts

通信方式設定ファイル

/etc/opt/jp1base/conf/physical_ipany.conf

/etc/opt/jp1base/conf/logical_ipany.conf

/etc/opt/jp1base/conf/physical_recovery_0651.conf

/etc/opt/jp1base/conf/logical_recovery_0651.conf

/etc/opt/jp1base/conf/physical_anyany.conf

/etc/opt/jp1base/conf/physical_ipip.conf

/etc/opt/jp1base/conf/logical_ipip.conf

共有ディレクトリ/jp1base/conf/physical_ipany.conf

共有ディレクトリ/jp1base/conf/logical_ipany.conf

共有ディレクトリ/jp1base/conf/physical_recovery_0651.conf

共有ディレクトリ/jp1base/conf/logical_recovery_0651.conf

共有ディレクトリ/jp1base/conf/physical_anyany.conf

共有ディレクトリ/jp1base/conf/physical_ipip.conf

共有ディレクトリ/jp1base/conf/logical_ipip.conf

ホストアクセス制限定義ファイル

/etc/opt/jp1base/conf/jbsdfts/jbsdfts_srv.conf

ローカルアクション機能

ローカルアクション環境変数ファイル

任意のファイルおよび任意のフォルダを指定できます。

ローカルアクション実行定義ファイル

/etc/opt/jp1base/conf/lcact/jbslcact.conf

共有ディレクトリ/jp1base/conf/lcact/jbslcact.conf

共通定義設定用ファイル（ローカルアクション機能）

/etc/opt/jp1base/conf/lcact/jp1bs_lcact_setup.conf.model

共有ディレクトリ/jp1base/conf/lcact/jp1bs_lcact_setup.conf.model

注※1　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるディレクトリに格納されます。

注※2　これらのファイルは使用されません。

注※3　定義情報の配布機能を使用していない場合には存在しません。

(2)　ログファイル一覧（UNIXの場合）

JP1/Baseが出力するデフォルトのログファイルの一覧を次の表に示します。

注意

JP1/Baseが出力するログファイルには，製品保守の必要上出力している内部ログファイルがあります。これらは，ユーザーが参照，または変更する必要はありません。なお，システム障害が発生したときなど資料採取のために，これらのファイルをご利用元で一時保管していただくことがあります。

「ログの種類」には，JP1/Baseが出力するログの種類を記載しています。

「ファイル名・フォルダ名」には，JP1/Baseをデフォルトでインストールした場合のログファイル名と，クラスタ運用の場合のログファイル名をフルパスで記載しています。

「最大ディスク占有量」には，ログファイルが最大でどの程度ディスクを使用するのかを記載しています。ログファイルが複数ある場合は，その合計量を記載しています。

「ファイルの切り替え時期」には，JP1/Baseが出力先のログファイルを切り替えるタイミングを記載しています。ファイルがこの欄に示すサイズに達したとき，または，この欄に示す事象が起きたときに出力先が切り替わります。なお，ログファイルが一つの場合，ファイルの切り替えが発生すると同ファイルに上書きされます。ログファイルが複数あり，最大ディスク占有量に達した場合は，更新日付の古いファイルから上書きされます。

表A-6　ログファイル一覧（UNIXの場合）

ログの種類
ファイル名・ディレクトリ名
最大ディスク占有量
ファイルの切り替え時期

JP1/Base起動時ログ

/var/opt/jp1base/log/JBS_START/jbs_start.log[.old]

共有ディレクトリ/jp1base/log/JBS_START/jbs_start.log[.old]

128KB
コマンド実行時

JP1/Base終了時ログ

/var/opt/jp1base/log/JBS_STOP/jbs_stop.log[.old]

共有ディレクトリ/jp1base/log/JBS_STOP/jbs_stop.log[.old]

128KB
コマンド実行時

プロセス管理ログ

/var/opt/jp1base/log/JBS_SPMD{1|2|3}.log

共有ディレクトリ/jp1base/log/JBS_SPMD{1|2|3}.log

384KB
128KB

/var/opt/jp1base/log/JBS_SPMD_COMMAND{1|2|3}.log

共有ディレクトリ/jp1base/log/JBS_SPMD_COMMAND{1|2|3}.log

384KB
128KB

認証サーバログ

/var/opt/jp1base/log/jbssessionapi.log{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbssessionapi.log{1|2|3|4|5|6|7|8}.log

2MB
256KB

/var/opt/jp1base/log/jbssessionmgr{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbssessionmgr{1|2|3|4|5|6|7|8}.log

2MB
256KB

/var/opt/jp1base/log/jbssessionmgr_trace{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbssessionmgr_trace{1|2|3|4|5|6|7|8}.log

2MB
256KB

認証サーバ設定コマンドログ

/var/opt/jp1base/log/JBSSESS{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JBSSESS{1|2|3|4|5|6|7|8}.log

2MB
256KB

SNMPトラップ変換機能ログ（定義情報）

/var/opt/jp1base/log/imevtgw.conf{1|2|3}.log

3MB
1MB

SNMPトラップ変換機能ログ（監視情報）

/var/opt/jp1base/log/imevtgw.log{1|2|3}.log

15MB
5MB

コマンド実行履歴ファイル（ISAM）※1

/var/opt/jp1base/log/COMMAND/actisamlogv8.DAT

共有ディレクトリ/jp1base/log/COMMAND/actisamlogv8.DAT

125MB※2
125MB※2

/var/opt/jp1base/log/COMMAND/actisamlogv8.K01

共有ディレクトリ/jp1base/log/COMMAND/actisamlogv8.K01

200KB※2
なし

/var/opt/jp1base/log/COMMAND/actisamlogv8.DEF

共有ディレクトリ/jp1base/log/COMMAND/actisamlogv8.DEF

1KB
コマンド実行時

/var/opt/jp1base/log/COMMAND/cmdisamlogv8.DAT

共有ディレクトリ/jp1base/log/COMMAND/cmdisamlogv8.DAT

125MB※2
125MB※2

/var/opt/jp1base/log/COMMAND/cmdisamlogv8.K01

共有ディレクトリ/jp1base/log/COMMAND/cmdisamlogv8.K01

200KB※2
なし

/var/opt/jp1base/log/COMMAND/cmdisamlogv8.DEF

共有ディレクトリ/jp1base/log/COMMAND/cmdisamlogv8.DEF

1KB
コマンド実行時

共通定義情報ログ

/var/opt/jp1base/log/JBSCNFCMD/JBSCNFCMD{1|2}.log

共有ディレクトリ/jp1base/log/JBSCNFCMD/JBSCNFCMD{1|2}.log

128KB
64KB

jp1hosts情報コマンドログ

/var/opt/jp1base/log/JBSCNFCMD/JBSCOMMCMD{1|2}.log

共有ディレクトリ/jp1base/log/JBSCNFCMD/JBSCOMMCMD{1|2}.log

128KB
64KB

ユーザーマッピングコマンドログ

/var/opt/jp1base/log/JBSUMAPCMD/JBSUMAPCMD{1|2}.log

共有ディレクトリ/jp1base/log/JBSUMAPCMD/JBSUMAPCMD{1|2}.log

128KB
64KB

リモートコマンドログ※1

/var/opt/jp1base/log/JCOCMD/jcocmd_result{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmd_result{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdapi{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdapi{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdapi_trace{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdapi_trace{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdcmc{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdcmc{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdcmc_trace{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdcmc_trace{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdcom{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdcom{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdcom_trace{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdcom_trace{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdexe{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdexe{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdexe_trace{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdexe_trace{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdrouter{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdrouter{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/jcocmdrouter_trace{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdrouter_trace{1|2|3}.log

2,304KB
768KB

/var/opt/jp1base/log/JCOCMD/JCOCMDCMD{1|2|3}.log

共有ディレクトリ/jp1base/log/JCOCMD/JCOCMDCMD{1|2|3}.log

2,304KB
768KB

プラグインサービスログ

var/opt/jp1base/log/plugin/jbsplugin{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugin{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/plugin/jbsplugincom_{0|1|2|3|4|5|6|7|8|9}※3_{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugincom_{0|1|2|3|4|5|6|7|8|9}※3_{1|2|3|4|5|6|7|8}.log

20MB
256KB

/var/opt/jp1base/log/plugin/jbsplugincmd{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugincmd{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/plugin/jbspluginmgrapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbspluginmgrapi{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/plugin/jbsplugincomapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugincomapi{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/plugin/jbsplugincmdapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugincmdapi{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/plugin/jbspluginhcshm{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbspluginhcshm{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/plugin/jbsrmtcmd{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/plugin/jbspluginremotecmd{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbspluginremotecmd{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/plugin/jbsrmtapi{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

インストール時のログ

/tmp/HITACHI_JP1_INST_LOG/jp1base_inst{1|2|3|4|5}.log

128KB
インストール時

セットアップ時のログ

/var/opt/jp1base/log/JBS_SETUP/jbs_setup.log

128KB
セットアップ時

構成管理ログ※1

/var/opt/jp1base/log/route/JBSRT{1|2|3}.log

共有ディレクトリ/jp1base/log/route/JBSRT{1|2|3}.log

384KB
128KB

ヘルスチェック機能ログ（自ホスト監視）

/var/opt/jp1base/log/jbshc/jbshc{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshc{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

ヘルスチェック機能ログ（他ホスト監視）

/var/opt/jp1base/log/jbshc/jbshchost{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshchost{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

ヘルスチェックコマンドログ

/var/opt/jp1base/log/jbshc/jbshcstatus{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshcstatus{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

ヘルスチェックAPI用ログ

/var/opt/jp1base/log/jbshc/jbshcapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshcapi{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

ヘルスチェック共有メモリー削除コマンドログ

/var/opt/jp1base/log/jbshc/jbshcshmctl{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshcshmctl{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

操作ログ

/var/opt/jp1base/log/BASE/base_log[{1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16}].log

68MB※4
1,024KB※4※5

イベント設定一元管理取得コマンド用トレースログ

/var/opt/jp1base/sys/tmp/event/servers/default/jevdef_get.{000|001|002}※6

共有ディレクトリ/event/jevdef_get.{000|001|002}※6

64KB
コマンド実行時

イベント設定一元管理配布コマンド用トレースログ

/var/opt/jp1base/sys/tmp/event/servers/default/jevdef_distrib.{000|001|002}※6

共有ディレクトリ/event/jevdef_distrib.{000|001|002}※6

64KB
コマンド実行時

イベントサービス用トレースログ

/var/opt/jp1base/sys/tmp/event/servers/default/trace.{000|001|002|003|004}※6※7

共有ディレクトリ/event/trace.{000|001|002|003|004}※6※7

5MB※7
イベントサービス起動時

/var/opt/jp1base/sys/tmp/event/servers/default/imevterr.{000|001|002|003|004}※6※7

共有ディレクトリ/event/imevterr.{000|001|002|003|004}※6※7

5MB※7
イベントサービス起動時

/var/opt/jp1base/sys/tmp/event/servers/default/imses.{log|old}※6

共有ディレクトリ/event/imses.{log|old}※6

2MB
イベントサービス起動時

イベントサービス用転送エラーログ

/var/opt/jp1base/sys/tmp/event/servers/default/fwderr.{000|001|002|003|004}※6※7

共有ディレクトリ/event/fwderr.{000|001|002|003|004}※6※⁷

5MB※7
イベントサービス起動時

イベントサービス用エラーログ

/var/opt/jp1base/sys/tmp/event/servers/default/error.{000|001|002|003|004}※6※7

共有ディレクトリ/event/error.{000|001|002|003|004}※6※7

2,500KB※7
イベントサービス起動時

イベントサービスAPI用ログ

/var/opt/jp1base/sys/tmp/event/IMEvapi.{000|001|002|003|004}※8

5MB※8
1MB※8

JP1/SES互換プロセスの起動に関するログ

/var/opt/jp1base/sys/tmp/event/servers/default/result.txt

数十バイト程度
イベントサービス起動時

イベント登録/受信プロセスからイベントサービスへの接続時に発生したエラー情報

/var/opt/jp1base/sys/tmp/event/refuse.txt

数百バイト程度
イベントサービスへの接続エラー発生時

イベント登録/受信プロセスとイベントサービスとの通信で発生したエラー情報

/var/opt/jp1base/sys/tmp/event/sock.log

1KB
1KB

JP1/SES互換用ローカルサーバエラーログ

/usr/lib/jp1_ses/log/.JP1_SES_dmain.log（HP-UX以外）

/var/opt/jp1_ses/log/.JP1_SES_dmain.log（HP-UXの場合）

1KB
イベントサービス起動時

JP1/SES互換用マネージャーログ

/usr/lib/jp1_ses/log/.JP1_SES_MNG.log（HP-UX以外）

/var/opt/jp1_ses/log/.JP1_SES_MNG.log（HP-UXの場合）

16KB
イベントサービス起動時

JP1/SES互換用受信プロセスエラーログ

/usr/lib/jp1_ses/log/.JP1_SES_RVC.log（HP-UX以外）

/var/opt/jp1_ses/log/.JP1_SES_RVC.log（HP-UXの場合）

16KB
イベントサービス起動時

JP1/SES互換用受信プロセスマネージャーエラーログ

/usr/lib/jp1_ses/log/.JP1_SES_RVM.log（HP-UX以外）

/var/opt/jp1_ses/log/.JP1_SES_RVM.log（HP-UXの場合）

16KB
イベントサービス起動時

JP1/SES互換用送信プロセスエラーログ

/usr/lib/jp1_ses/log/.JP1_SES_SND.log（HP-UX以外）

/var/opt/jp1_ses/log/.JP1_SES_SND.log（HP-UXの場合）

16KB
イベントサービス起動時

JP1/SES互換用監視プロセスエラーログ

/usr/lib/jp1_ses/log/.JP1_SES_WAC.log（HP-UX以外）

/var/opt/jp1_ses/log/.JP1_SES_WAC.log（HP-UXの場合）

16KB
イベントサービス起動時

JP1/SES互換用開始コマンドエラーログ

/tmp/.JP1_SES_startlogプロセスID

数百バイト程度※9
JP1/SES互換用サブシステム開始時

JP1/SES互換用停止コマンドエラーログ

/tmp/.JP1_SES_stoperrプロセスID

数百バイト程度※10
JP1/SES互換用サブシステム停止時

ログファイルトラップエラーログ

/var/opt/jp1base/sys/tmp/event/logtrap/.errorfile.ID番号

数百バイト程度※11
ログファイルトラップ起動時

ログファイルトラップログ

/var/opt/jp1base/sys/tmp/event/logtrap/jevtraplog/jevtraplog.{000|001|002|003|004}

5MB※12
1MB※12

ログファイルトラップ起動実行結果ログ

/var/opt/jp1base/log/jevlog_start/jevlog_start{1|2|3}.log※15※16

3MB
1MB

リモート監視ログ（ログファイルトラップ）

/var/opt/jp1base/sys/tmp/event/logtrap/jelallog/jelallog{1-5}.log

10MB
2MB

jbs_killall.clusterコマンドトレースログ※13

共有ディレクトリ/jp1base/log/jbs_killall.cluster[.{1|2|3|4}]

256KB
コマンド実行時

プロセス間通信トレースログ

/var/opt/jp1base/log/JBSCOM/jbscomd {1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd{1|2|3|4}.log

4MB
1MB

/var/opt/jp1base/log/JBSCOM/jbscomd_api {1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd_api{1|2|3|4}.log

4MB
1MB

/var/opt/jp1base/log/JBSCOM/jbscomd_ses {1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd_ses{1|2|3|4}.log

4MB
1MB

/var/opt/jp1base/log/JBSCOM/jbscomd _snd{1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd_snd{1|2|3|4}.log

4MB
1MB

/var/opt/jp1base/log/JBSCOM/jbscomd _rcv{1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd_rcv{1|2|3|4}.log

4MB
1MB

/var/opt/jp1base/log/JBSCOM/command {1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/command{1|2|3|4}.log

4MB
1MB

稼働情報採取コマンドエラーログ

/var/opt/jp1base/log/jbsopi/jbsopi_cmd{1|2|3|4|5}.log

5MB
1MB

稼働情報API用ログ

/var/opt/jp1base/log/jbsopi/jbsopi_api{1|2|3|4|5}.log

共有ディレクトリ/jp1base/log/jbsopi/jbsopi_api{1|2|3|4|5}.log

5MB
1MB

サービス管理制御ログ

/var/opt/jp1base/log/jbssrvmgr/jbssrvmgr{1|2|3|4}.log

共有ディレクトリ/jp1base/log/jbssrvmgr/jbssrvmgr{1|2|3|4}.log

4MB
1MB

サービス管理制御トレースログ

/var/opt/jp1base/log/jbssrvmgr/jbssrvmgr_trace{1|2|3|4}.log

共有ディレクトリ/jp1base/log/jbssrvmgr/jbssrvmgr_trace{1|2|3|4}.log

4MB
1MB

サービス管理制御API用ログ

/var/opt/jp1base/log/jbssrvmgr/jbssrvmgr_api{1|2|3|4}.log

共有ディレクトリ/jp1base/log/jbssrvmgr/jbssrvmgr_api{1|2|3|4}.log

4MB
1MB

ローカルアクション実行履歴ログ

/var/opt/jp1base/log/lcact/localact{1～n}※14.log

共有ディレクトリ/jp1base/log/lcact/localact{1～n}※14.log

1,024KB※14
256KB※14

ローカルアクションログ

/var/opt/jp1base/log/jbslcact/jbslcact{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbslcact/jbslcact{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/jbslcact/jbslcact_list{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbslcact/jbslcact_list{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

/var/opt/jp1base/log/jbslcact/jbslcact_cancel{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbslcact/jbslcact_cancel{1|2|3|4|5|6|7|8}.log

2,048KB
256KB

注※1　JP1/IM - Manager用のログファイルです。

注※2　JP1/IM - Managerのjcocmddefコマンドの-recordオプションを使うことで以下の範囲で変更できます。

レコード数1の場合（-record 1）
DATファイル:7KB，K01ファイル:4KB

レコード数20,000の場合（デフォルト値）
DATファイル:125MB，K01ファイル:200KB

レコード数196,600の場合（-record 196600）
DATファイル:1.2GB，K01ファイル:2MB

注※3　jbsplugincomプロセス識別番号を示します。

注※4　ファイル数・最大ディスク占有量は，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で変更できます。変更できる範囲については，「付録K.5　操作ログを出力するための設定」を参照してください。

注※5　JP1/Base起動時に，ファイルの切り替えを自動で行うか行わないかを，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で指定できます。

注※6　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるディレクトリに格納されます。

注※7　ファイル数，最大ディスク占有量は，イベントサーバ設定ファイル（conf）で変更できます。変更できる範囲については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

注※8　ファイル数・最大ディスク占有量は，API設定ファイル（api）で変更できます。変更できる範囲については，「14.　定義ファイル」の「API設定ファイル」を参照してください。

注※9　JP1/SES互換サブシステムの開始時にエラーが発生するたびにファイルが作成されるため，不要なファイルは削除する必要があります。

注※10　JP1/SES互換サブシステムの停止時にエラーが発生するたびにファイルが作成されるため，不要なファイルは削除する必要があります。

注※11　ログファイルトラップ起動時に作成され，正常終了時に削除されます。エラー発生時には，ログファイルトラップを終了したときにファイルがそのまま残ります。ログファイルトラップでエラーが多発すると，エラーファイルが増えていくため，不要なエラーファイルは削除する必要があります。

注※12　ファイル数・最大ディスク占有量は，ログ情報定義ファイル（jevlogd.conf）で変更できます。変更できる範囲については，「14.　定義ファイル」の「ログ情報定義ファイル」を参照してください。

注※13　クラスタ運用時にjbs_killall.clusterコマンドを実行すると出力されるログファイルです。

注※14　ファイル数・最大ディスク占有量は，共通定義設定用ファイル（ローカルアクション機能）で変更できます。変更できる範囲については，「14.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。

注※15　ログの出力形式は，HNTRLib2（マルチプロセス対応トレース）です。

注※16　ログを削除する場合，ログ出力先ディレクトリにあるmmapディレクトリも削除してください。

付録B　プロセス一覧

JP1/Baseのプロセスを次に示します。

＜この節の構成＞

付録B.1　Windowsの場合

付録B.2　UNIXの場合

付録B.1　Windowsの場合

Windowsのタスク マネージャを使って，プロセスの動作状態を確認してください。正常に動作している場合に表示されるプロセスを次に示します。なお，表内の(　)内の数値は同時に実行できるプロセス数です。

親プロセス名
機能
子プロセス名
機能

hntr2srv.exe(1)
統合トレース起動用
－
－

hntr2mon.exe(1)
統合トレース
－
－

jbs_service.exe(1)
JP1/Baseプロセス管理起動用※1
－
－

jbs_spmd.exe(1)
JP1/Baseプロセス管理※1
jbssessionmgr.exe(1)※2※3
認証サーバ※1※5
認証サーバとして設定したホスト上にだけ存在する。
jbs_spmd_statusコマンドを実行した場合の表示名はjbssessionmgrとなる。

jbsroute.exe(1) ※2
構成管理※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbsrouteとなる。

jcocmd.exe(1) ※2
jcocmdexe.exe(1)
jcocmdapi.exe(コマンド実行画面数※4+1（JP1/IM - Managerがインストールされている場合）)
コマンド実行※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjcocmdとなる。

jbsplugind.exe(1) ※2
プラグインサービス※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbspluginとなる。

jbshcd.exe(1)
ヘルスチェック（自ホスト監視用）※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbshcdとなる。

jbshchostd.exe(1)
ヘルスチェック（他ホスト監視用）※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbshchostdとなる。

jbssrvmgr.exe(1)
サービス管理制御機能※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbssrvmgrとなる。

jbslcact.exe(1)
ローカルアクション機能※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbslcactとなる。

jbscomd.exe(1)
jbscomd_api.exe(1)
jbscomd_ses.exe(1)
jbscomd_snd.exe(1)
jbscomd_rcv.exe(1)
プロセス間通信※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbscomdとなる。

jbapmsrvcecon.exe(1)※3
起動管理
powendar.exe(1)
電源制御
JP1/Power Monitorがインストールされていると，この子プロセスが生成される。

jevservice.exe(1)
イベントサービス※1※6
jevsessvc.exe(1)
イベントサービス
このプロセスは物理ホストでだけ生成される。※6

jevtraplog.exe(1)
ログファイルトラップ
－
ログファイルトラップ
ログファイルトラップを使用した場合だけ生成される。

jevtrapevt.exe(1)
イベントログトラップ
－
イベントログトラップ
イベントログトラップを使用した場合だけ生成される。

imevtgw.exe(1)
SNMPトラップ変換
－
SNMPトラップ変換
SNMPトラップ変換を使用した場合だけ生成される。

（凡例）

－：なし

注※1　クラスタシステムで複数の論理ホストが一つの物理ホスト上で動作する場合，または一つの論理ホストと物理ホストが同時に起動される場合は，上記のプロセスの同時に実行できるプロセス数の上限は，（論理ホスト数+1）×プロセス数となります。

注※2　これらのプロセスは，JP1/Baseの基盤となる重要なプロセスです。JP1/Baseでは，これらのプロセスの異常終了時に備えて，異常終了時に自動で再起動する機能と，プロセスの異常を検知した場合にJP1イベントを発行する機能を提供しています。プロセス停止による業務への影響を最小限にするために，あらかじめ設定しておくことをお勧めします。設定方法については，「2.4.3　JP1/Baseの障害に備えた設定」を参照してください。

注※3　タスクマネージャ上ではプロセス名称の途中までしか表示されません。

注※4　接続しているJP1/IM - Viewがコマンド実行画面を開いている数のことです。開いている画面数だけプロセス数が増えます。コマンド実行画面を閉じると，閉じた分だけプロセスは消滅します。

注※5　これらのプロセスの状態は，jbs_spmd_statusコマンドで確認できます。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合
jbssessionmgr
jbsroute
jcocmd
jbsplugin
jbshcd
jbshchostd
jbssrvmgr
jbslcact
jbscomd

認証サーバが設定されていない場合
jbsroute
jcocmd
jbsplugin
jbshcd
jbshchostd
jbssrvmgr
jbslcact
jbscomd

注※6　これらのプロセスの状態は，jevstatコマンドで確認できます。jevstatコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

jevservice

付録B.2　UNIXの場合

UNIXのpsコマンドを使ってプロセスの動作状態を確認してください。正常に動作している場合に表示されるプロセスを次に示します。なお，表内の(　)内の数値は同時に実行できるプロセス数です。

親プロセス名
機能
子プロセス名
機能

hntr2mon(1)
統合トレース
－
－

jbs_spmd(1)
プロセス管理※1
jbssessionmgr(1)※2
認証サーバ※1※5
認証サーバとして設定したホスト上にだけ存在する。
jbs_spmd_statusコマンドを実行した場合の表示名はjbssessionmgrとなる。

jbsroute(1～9)※2
構成管理※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbsrouteとなる。

jcocmd(1)※2
jcocmdexe(1)
jcocmdapi(コマンド実行画面数※3+1（JP1/IM - Managerがインストールされている場合）)
jcocmdcmc(0～コマンド数※4)
jcocmdcom(1)※10
コマンド実行※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjcocmdとなる。

jbsplugind(1)※2※7
プラグインサービス※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbspluginとなる。

jbshcd(1)
ヘルスチェック（自ホスト監視用）※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbshcdとなる。

jbshchostd(1)
ヘルスチェック（他ホスト監視用）※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbshchostdとなる。

jbssrvmgr(1)
サービス管理制御機能※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbssrvmgrとなる。

jbslcact(1)
ローカルアクション機能※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbslcactとなる。

jbscomd(1)
jbscomd_api(1～9999)
jbscomd_ses(1)
jbscomd_snd(1)
jbscomd_rcv(1)
プロセス間通信※1※5
jbs_spmd_statusコマンドを実行した場合の表示名はjbscomdとなる。

jevservice(1)
イベントサービス※1※6
jevservice(6～9,999)※11
イベントサービス※6

jesdmain(1)※8※9
JP1/SES互換用※6
このプロセスは物理ホストでだけ生成される。

jesrd(6～9,999)※9
JP1/SES互換用※6
このプロセスは物理ホストでだけ生成される。

jevlogd(1)
ログファイルトラップ
jelparentim
(0～jevlogstartコマンド実行数)
ログファイルトラップ
jelparentim一つにつき，監視するファイル数分jelchildimプロセスが生成される。なお，jevlogstopコマンドを実行すれば，jelparentimプロセスは消滅する。

jelallog
(0～ログファイルトラップのプロセス起動回数)
JP1/IMの［プロファイル表示/編集］画面から，リモート監視のログファイルトラップのプロセスを起動した回数だけ生成される。なお，プロセスを停止すれば消滅する。

imevtgw(1)
SNMPトラップ変換
－
SNMPトラップ変換
SNMPトラップ変換を使用する場合だけ生成される。

（凡例）

－：なし

注※1　クラスタシステムで複数の論理ホストが一つの物理ホスト上で動作する場合，または一つの論理ホストと物理ホストが同時に起動される場合は，上記のプロセスの同時に実行できるプロセス数の上限は，（論理ホスト数+1）×プロセス数となります。

注※2　これらのプロセスは，JP1/Baseの基盤となる重要なプロセスです。JP1/Baseでは，これらのプロセスの異常終了時に備えて，異常終了時に自動で再起動する機能と，プロセスの異常を検知した場合にJP1イベントを発行する機能を提供しています。プロセス停止による業務への影響を最小限にするために，あらかじめ設定しておくことをお勧めします。設定方法については，「2.4.3　JP1/Baseの障害に備えた設定」を参照してください。

注※3　接続しているJP1/IM - Viewがコマンド実行画面を開いている数のことです。開いている画面数だけプロセス数が増えます。コマンド実行画面を閉じると，閉じた分だけプロセスは消滅します。

注※4　JP1/IMによるリモートコマンドや自動アクションの実行数のことです。コマンド一つにつき，プロセスが一つ生成されます。処理が完了すると，プロセスは消滅します。なお，コマンドを連続して実行した場合，複数のプロセスが生成されることがあります。

注※5　これらのプロセスの状態は，jbs_spmd_statusコマンドで確認できます。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合
jbssessionmgr
jbsroute
jcocmd
jbsplugin
jbshcd
jbshchostd
jbssrvmgr
jbslcact
jbscomd

認証サーバが設定されていない場合
jbsroute
jcocmd
jbsplugin
jbshcd
jbshchostd
jbssrvmgr
jbslcact
jbscomd

注※6　これらのプロセスの状態は，jevstatコマンドで確認できます。jevstatコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

jevservice

注※7　ps-elコマンドで表示されるプロセス名は，「jbsplugin」となります。

注※8　psコマンドで表示されるプロセス名は，/var/opt/jp1base/sys/tmp/event/servers/default/jpevent.confとなります。

注※9　jevserviceから起動されますが，プロセスの間に親子関係はありません。

注※10　07-51で追加になったプロセスです。

注※11　イベントサーバ環境設定ファイル（conf）で，optionsパラメーターに，v5-unusedを指定している場合は（5～9,999），v5-unusedを指定していない場合は（6～9,999）となります。

付録C　ポート番号一覧

JP1/Baseで使用するポート番号について説明します。使用するプロトコルはTCP/IPです。JP1/SES互換用を除く各ポート番号は，製品の提供時にデフォルトとして設定されています。

＜この節の構成＞

付録C.1　JP1/Baseのポート番号

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

付録C.3　コネクションの接続状態

付録C.1　JP1/Baseのポート番号

JP1/Baseで使用するポート番号を次の表に示します。

表C-1　JP1/Baseで使用するポート番号

サービス名
ポート番号
用途

jp1imevt
20098/tcp
JP1イベントを他ホストに転送するときに使用

jp1imevtapi
20099/tcp
JP1イベントを登録・取得するすべての製品，およびJP1イベント発行関数・JP1イベント取得関数で使用

jp1imrt
20237/tcp
構成管理で使用（JP1/IM - Manager使用時）

jp1imcmda
20238/tcp
コマンド実行で使用（JP1/IM - Manager使用時）

jp1imcmdc
20239/tcp
コマンド実行で使用（JP1/IM - Manager使用時）

jp1bsuser
20240/tcp
ユーザー認証サーバで使用

JP1AutoJob※1（Windowsの場合）
jesrd※1（UNIXの場合）
ユーザー任意/tcp
JP1/SESプロトコル利用製品とのイベントの送受信で使用

jp1bsplugin
20306/tcp
JP1/IM用定義情報の収集・配布時，およびJP1/Baseのヘルスチェック機能で使用

jp1bscom
20600/tcp
JP1/IMの構成管理とサービス管理制御との通信で使用

ldap
389/tcp※2
ディレクトリサーバ連携で使用

ldaps
636/tcp※2

注※1　JP1/SES互換用です。これらのサービスは，JP1/Baseをインストールしても，servicesファイルに設定されません。バージョン5以前の製品JP1/SES，JP1/AJSおよびJP1/SESのプロトコルを利用した製品（JP1/OJEなど）とイベントの送受信をしたい場合は，servicesファイルに設定してください。

注※2　JP1/Base（認証サーバ）とディレクトリサーバ間の通信でSSLを利用するかどうかで使用するポート番号は変わります。SSLを利用する場合は，636/tcpを使用します。

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

ファイアウォールの通過方向を次の表に示します。なお，JP1/Baseは，パケットフィルタリング型，NAT（スタティックモード）型のアドレス変換をサポートしています。

表C-2　ファイアウォールの通過方向

サービス名
ポート番号
ファイアウォールの通過方向

jp1imevt
20098/tcp
JP1イベント転送元のJP1/Base → JP1イベント転送先のJP1/Base

jp1imevtapi
20099/tcp
JP1/IM - ManagerなどのJP1イベントを取得するプログラム → JP1/Base

jp1imrt
20237/tcp
JP1/IM - Manager → JP1/Base
上位JP1/IM - Manager → 下位JP1/IM - Manager

jp1imcmda
20238/tcp
JP1/IM - View → JP1/IM - Managerが導入されているホストのJP1/Base
JP1/IM - Manager → JP1/Base

jp1imcmdc
20239/tcp
JP1/IM - Managerが導入されているホストのJP1/Base ←→ コマンド実行先ホストのJP1/Base

jp1bsuser
20240/tcp
JP1/IM - Manager → JP1/Base
JP1/AJS - Manager → JP1/Base
JP1/AJS - Agent → JP1/Base

JP1AutoJob（Windowsの場合）
jesrd（UNIXの場合）
ユーザー任意/tcp
JP1/Base ←→ JP1/SESプロトコル利用製品

jp1bsplugin
20306/tcp
JP1/IM - Managerなどのサービスを使用する上位プログラム → JP1/Base
JP1/Baseのヘルスチェック機能を使用する場合
監視ホストのJP1/Base → 監視対象ホストのJP1/Base

jp1bscom
20600/tcp
JP1/IM - Manager ←→ ほかのホストのJP1/Base
上位JP1/IM - Manager ←→ 下位JP1/IM - Manager

ldap
389/tcp※
JP1/Base（認証サーバ） → ディレクトリサーバ

ldaps
636/tcp※

（凡例）

→：コネクション確立時，左項から右項への片方向で接続することを表す。

←→：コネクション確立時，両方向で相互接続することを表す。

注※　JP1/Base（認証サーバ）とディレクトリサーバ間の通信でSSLを利用するかどうかで使用するポート番号は変わります。SSLを利用する場合は，636/tcpを使用します。

表C-2のポート番号を利用してコネクションを確立したい場合は，ファイアウォールの設定で「サービス名のポート」と「サービス名のポート番号に対して確立されたセションへの返信はANY」を必ず通すようにしてください。返信が「ANY」となるのは，OSによる自動採番のためです。

ファイアウォールサーバマシン上にJP1/Baseをインストールする場合は，同一マシン内での通信もファイアウォールの対象となる場合がありますので，同一マシン内でも通信できるように設定してください。

付録C.3　コネクションの接続状態

各ポート番号のコネクションの接続状態を次の表に示します。

表C-3　コネクションの接続状態

サービス名
ポート番号
コネクションの接続状態

jp1imevt
20098/tcp
イベントサーバ設定ファイル（conf）のremote-serverパラメーターにkeep-aliveを設定している場合，コネクションを維持します。強制的にコネクションを切断したい場合は，パラメーターにcloseを設定してください。

jp1imevtapi
20099/tcp
API設定ファイル（api）のserverパラメーターにkeep-aliveを設定している場合，コネクションを維持します。強制的にコネクションを切断したい場合は，パラメーターにcloseを設定してください。

jp1imrt
20237/tcp
コネクションは必要なときだけ接続します。

jp1imcmda
20238/tcp
コネクションを維持します。強制的にコネクションが切断された場合，再度コマンド実行要求が必要です。

jp1imcmdc
20239/tcp
コネクションを維持します。※1強制的にコネクションが切断された場合でも，自動的に再接続されます。

jp1bsuser
20240/tcp
コネクションは必要なときだけ接続します。

JP1AutoJob（Windowsの場合）
jesrd（UNIXの場合）
ユーザー任意/tcp
コネクションは必要なときだけ接続します。

jp1bsplugin
20306/tcp
コネクションは必要なときだけ接続します。

jp1bscom
20600/tcp
コネクションは必要なときだけ接続します。

ldap
389/tcp※2
コネクションは必要なときだけ接続します。

ldaps
636/tcp※2

注※1　無通信状態で30分以上経過した場合，コネクションを切断します。

注※2　JP1/Base（認証サーバ）とディレクトリサーバ間の通信でSSLを利用するかどうかで使用するポート番号は変わります。SSLを利用する場合は，636/tcpを使用します。

付録D　制限値一覧

JP1/Baseの各種の制限値を次に示します。

表D-1　制限値一覧

項目
制限値

イベントサービスの環境設定（イベントサーバ設定ファイル，転送設定ファイルおよび配布定義ファイル）の1行の最大長
1,023バイト

転送設定ファイルの一つのフィルターの全体の最大長
64キロバイト

イベントサーバ名の最大長
255バイト（ただし，Windows版提供のjevregsvcコマンドで指定できる最大長は240バイト）

JP1ユーザー名
1～31バイト

JP1ユーザー用パスワード
6～32バイト

OSユーザー名
1～64バイト（ドメイン名を含む。ただし，OSによって最大長が異なる）

サーバホスト名の最大長
255バイト

論理ホスト名の最大長
Windowsの場合：196バイト（推奨：63バイト）※
UNIXの場合：255バイト（推奨：63バイト）※

ユーザー権限レベルファイルの1行の最大長
4,096バイト

ユーザーマッピング定義ファイルの1行の最大長
4,096バイト

認証サーバに同時にログインできるJP1ユーザー数
10,000ユーザー

登録できるJP1ユーザー数
3,000ユーザー

ユーザー権限レベルファイルに登録できるJP1ユーザー数
3,000ユーザー

ヘルスチェック定義ファイルの1行の最大長
1,023バイト

注※　JP1/Baseの制限値は上記のとおりですが，クラスタソフトで上記制限値に対応していない場合があります。JP1/Baseで論理ホスト名を指定する場合は，クラスタソフトの制限値を超えないよう注意してください。実際の運用では，63バイト以内を推奨しています。

付録E　性能と見積もり

JP1/Baseのメモリー所要量およびディスク占有量について説明します。

＜この節の構成＞

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

付録E.2　ディスク占有量（Windowsの場合）

付録E.3　ディスク占有量（UNIXの場合）

付録E.4　クラスタ運用時の共有ディスクのディスク占有量

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

JP1/Baseのメモリー所要量については，リリースノートを参照してください。

付録E.2　ディスク占有量（Windowsの場合）

Windowsの場合のJP1/Baseのディスク占有量については，リリースノートを参照してください。

付録E.3　ディスク占有量（UNIXの場合）

UNIXの場合のJP1/Baseのディスク占有量については，リリースノートを参照してください。

付録E.4　クラスタ運用時の共有ディスクのディスク占有量

JP1/Baseのディスク占有量については，リリースノートを参照してください。

付録F　正規表現の文法

JP1製品で正規表現を使用する場合は次に示す正規表現を利用できます。正規表現を使って検索する場合，検索条件は次の表記法に従って指定してください。

＜この節の構成＞

付録F.1　デフォルトで使用できる正規表現

付録F.2　正規表現を拡張した場合に使用できる拡張正規表現

付録F.3　06-71以前および07-00以降で使用できる正規表現の比較

付録F.4　正規表現を指定する際のヒント

付録F.5　正規表現の指定例

付録F.1　デフォルトで使用できる正規表現

Windowsの場合に，デフォルトで使用できる正規表現について説明します。UNIXでは，OS提供の正規表現が適用されるため，次に示す文法とは異なります。UNIX上で使用できる正規表現については，各正規表現の文法（regexpまたはregex）を参照してください。

＜この項の構成＞

(1)　通常文字

(2)　特殊文字

(1)　通常文字

通常文字とは，正規表現としてその文字自体を検索対象に指定した場合に一致する文字です。通常文字として扱わないのは「改行文字」と「特殊文字」だけです。通常文字では，大小文字を区別します。

(2)　特殊文字

特殊文字とは，サーカムフレックス（^），ドル記号（$），ピリオド（.），アスタリスク（*），および円記号（¥）です。

それぞれの特殊文字について次に説明します。

^

^は，先頭指定（前方一致）を意味します。正規表現の最初の文字として使用する場合だけ特殊文字になります。先頭以外で使用する場合は通常文字として扱われます。

^を特殊文字として指定すると，行頭にある指定の文字列に一致します。

$

$は，末尾指定（後方一致）を意味します。正規表現の最後の文字として使用する場合だけ特殊文字になります。末尾以外で使用する場合，通常文字として扱われます。

$を特殊文字として指定すると，行末にある指定の文字列に一致します。なお，^と併用すると，指定した文字列だけの行に一致します。

.（ピリオド）

.（ピリオド）は，「改行文字」以外の任意の1文字であることを意味します。

.（ピリオド）を特殊文字として指定すると，「改行文字」以外の任意の1文字に一致します。

*

*は，直前の正規表現の0回以上の繰り返しを意味します。

¥

¥は，特殊文字（*，.，^，$，¥）の打ち消しを意味します。

¥を特殊文字の前に指定すると，その特殊文字は，通常文字として扱われます。また，¥を英小文字の前に指定すると，エラーになります。なお，英小文字の前に指定しても，エラーにならない場合を次に示します。

¥n

¥nは，改行コードを意味します。

¥t

¥tは，タブを意味します。

付録F.2　正規表現を拡張した場合に使用できる拡張正規表現

JP1製品では，正規表現を拡張すると，WindowsとUNIXで共通の正規表現を使用できるようになります。正規表現を拡張したい場合は，「2.4.1　使用する正規表現を拡張する」を参照して設定してください。なお，UNIXの場合は，各OSによって適用される拡張正規表現が異なります。HP-UX，Solaris，またはAIXの場合はXPG4に準拠した拡張正規表現，Linuxの場合はPOSIX1003.2に準拠した拡張正規表現が適用されます。Windowsの場合は，XPG4の拡張正規表現の文法に準じます。ここでは，拡張正規表現のうち，使用頻度が高そうな正規表現について説明します。

拡張した場合に使用できる正規表現を次に示します。

文字列

指定の文字列の行に一致します。

^文字列

行頭にある指定の文字列に一致します。先頭以外で使用する場合は通常文字として扱われます。

文字列$

行末にある指定の文字列に一致します。末尾以外で使用する場合は通常文字として扱われます。なお，^と併用すると，指定した文字列だけの行に一致します。

^文字列$

指定の文字列だけの行に一致します。

^$

空行に一致します。

.(ピリオド)

「改行文字」以外の任意の1文字に一致します。

[文字列]

[　]内の文字列に指定された文字のどれかに一致します。

[文字-文字]

文字コードの昇順で範囲内のどれか1文字に一致します。

[^文字-文字]

文字コードの昇順で範囲外のどれか1文字に一致します。

文字*

直前の文字が0回以上繰り返されている文字列に一致します。

正規表現｜正規表現

左右の正規表現のどちらかに一致します。

¥特殊文字

特殊文字を通常文字として扱います。

（正規表現）

正規表現をグループ化します。

付録F.3　06-71以前および07-00以降で使用できる正規表現の比較

06-71以前および07-00以降のデフォルトで使用できる正規表現と，07-00以降で正規表現を拡張した場合に使用できる正規表現のうち主なものについて，次の表に示します。

指定方法
機能
06-71以前
07-00以降

Windowsの場合
（JP1独自の正規表現）
UNIXの場合
（基本正規表現）※1
Windowsの場合
（拡張正規表現）※3
UNIXの場合
（拡張正規表現）※2

文字列
指定の文字列の行に一致する
○
○
○
○

^文字列
行頭にある指定の文字列に一致する
○
○
○
○

文字列$
行末にある指定の文字列に一致する
○
○
○
○

^文字列$
指定の文字列だけの行に一致する
○
○
○
○

^$
空行に一致する
○
○
○
○

.（ピリオド）
任意の1文字に一致する
○
○
○
○

.*
.（ピリオド）と*の併用，任意の1文字に一致する
○
○
○
○

[文字列]
[　]内の文字列に指定された文字のどれかに一致する
×
○
○
○

[^文字列]
[　]内の文字列に指定された文字以外の文字に一致する
×
○
○
○

[文字-文字]
文字コードの昇順で範囲内の文字に一致する
×
○
○
○

[^文字-文字]
文字コードの昇順で範囲外の文字に一致する
×
○
○
○

文字*
直前の文字が0回以上繰り返されている文字列に一致する
○
○
○
○

文字+
直前の文字が1回以上繰り返されている文字列に一致する
×
×
○
○

文字?
直前の文字が0回または1回繰り返されている文字列に一致する
×
×
○
○

文字{n}
直前の文字がn回繰り返されている文字列に一致する
×
×
○
○

文字{n,}
直前の文字がn回以上繰り返されている文字列に一致する
×
×
○
○

文字{n,m}
直前の文字がn回以上，m回以内の文字列に一致する
×
×
○
○

正規表現｜正規表現
左右の正規表現のどちらかに一致する
×
×
○
○

¥特殊文字
特殊文字を通常文字として扱う
○
○
○
○

（正規表現）
正規表現をグループ化する
×
×
○
○

（凡例）

○：使用できる

×：使用できない

注※1　デフォルトで基本正規表現を使用しているのはJP1/Baseだけです。ほかのJP1製品では異なる正規表現を使用しているため，デフォルトで使用できる正規表現については各製品のマニュアルを参照してください。

注※2　正規表現を拡張した場合，各OSによって適用される拡張正規表現が異なります。HP-UX，Solaris，またはAIXの場合はXPG4に準拠した拡張正規表現，Linuxの場合はPOSIX1003.2に準拠した拡張正規表現が適用されます。使用できる正規表現の詳細については，各正規表現の文法（regexpまたはregex）を参照してください。

注※3　正規表現を拡張した場合，XPG4の拡張正規表現の文法に準拠します。なお，正規表現規格で未定義とされている項目については，UNIXの場合と動作が異なることがあります。

付録F.4　正規表現を指定する際のヒント

正規表現を指定する際のヒントを次に示します。正規表現を指定する際に参考にしてください。

正規表現ですべての文字に一致する「.*」を多数使用すると，検索に時間が掛かることがあります。長いメッセージなどに対して「.*」を使用する場合は，必要な個所にだけ「.*」を使用してください。

UNIXでは，空白以外の文字に一致させたい場合など，「.*」の代わりに，空白以外の文字の繰り返しとなる「[^ ]*」を使用すると，検索時間を短縮できます。

付録F.5　正規表現の指定例

正規表現の指定例を次に示します。

指定方法 | 機能 | 正規表現として指定した文字列 | 文字列の例 | 一致
文字列 | 指定の文字列の行に一致する | spring | spring has come. | ○
winter-summer-autumn-spring | ○
-----spring----- | ○
^文字列 | 行頭にある指定の文字列に一致する | ^spring | spring has come. | ○
winter-summer-autumn-spring | ×
-----spring----- | ×
文字列$ | 行末にある指定の文字列に一致する | spring$ | spring has come. | ×
winter-summer-autumn-spring | ○
-----spring----- | ×
^文字列$ | 指定の文字列だけの行に一致する | ^spring$ | spring has come. | ×
winter-summer-autumn-spring | ×
spring | ○
　　spring | ×
^$ | 空行に一致する | ^$ |  | ○
spring | ×
.(ピリオド) | 任意の1文字に一致する | in.e | winter has come. | ○
mother of invention | ○
life is in everything | ○
eight nine ten | ×
increasing population | ×
s..ing | picnic in spring | ○
skiing in winter | ○
[文字列] | [　]内の文字列に指定された文字のどれかに一致する | [pr] | spring has come. | ○
today is monday. | ×
[文字-文字] | 文字コードの昇順で範囲内の文字のどれか1文字に一致する | [a-i] | spring has come. | ○
[^文字-文字] | 文字コードの昇順で範囲外の文字のどれか1文字一致する | [^a-i] | spring has come. | ○
文字* | 直前の文字が0回以上繰り返されている文字列に一致する | ro*m | terminal | ○
cd-rom | ○
living room | ○
h.*n | This is a pen. | ○
That is an apple. | ○
正規表現｜正規表現 | 左右の正規表現のどちらかに一致する | [0-9]+|apple | That is an apple. | ○
spring in 2003 | ○
¥特殊文字 | 特殊文字を通常文字として扱う | o¥.h | <stdio.h> | ○
another man | ×
（正規表現） | 正規表現をグループ化する | i(n.e|ng) | winter has come. | ○
interesting book | ○

（凡例）

太字：指定した正規表現と一致する文字列

空欄：空行

○：一致する文字列がある

×：一致する文字列がない

付録G　カーネルパラメーター一覧

UNIX環境でJP1/Baseを使用する場合，JP1/Baseの実行に必要なリソースを割り当てるために，OSのカーネルパラメーターを調整します。調整が必要なカーネルパラメーターについては，リリースノートを参照してください。

付録H　通信設定の変更対応

06-71以降のJP1/Baseは，さまざまなネットワーク構成に応じて通信設定を変更できます。ネットワークの構成や運用方法によっては，通信方式を設定する必要があります。JP1/Baseの通信設定の変更に関するファイルおよびパラメーターを次に示します。

＜この節の構成＞

(1)　jp1hosts定義ファイル

(2)　通信方式設定ファイル

(3)　イベントサーバ設定ファイル（conf）のportsパラメーター

(4)　イベントサーバ設定ファイル（conf）のclient-bindパラメーター

(5)　イベントサーバ設定ファイル（conf）のremote-serverパラメーター

(6)　API設定ファイル（api）のserverパラメーター

(7)　API設定ファイル（api）のclientパラメーター

(1)　jp1hosts定義ファイル

JP1/Base独自のhosts情報を設定しておくファイルです。OSの名前解決ができない場合，複数LAN接続の環境で特定のLANを使用する場合，クラスタシステムで自ホストが複数の受信用IPアドレスを使用する場合などに設定します。

hosts情報を設定していないホスト名に対しては，OSの名前解決を利用します。ネットワーク構成によっては，通信方式設定ファイルの設定が必要な場合があります。jp1hosts定義ファイルの詳細については，「14.　定義ファイル」の「jp1hosts定義ファイル」を参照してください。

設定変更が必要となる場合の例

OSの名前解決で，接続先ホストが名前解決できない場合，または優先IPアドレスとして取得できない場合

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して受信する場合

複数LAN接続の環境で，特定のLANだけを使用して受信する場合

Windows環境で，同一ホスト上で物理ホストと論理ホストのサービスを起動する場合

複数LAN接続の環境で，特定のLANを使用して送信する場合

(2)　通信方式設定ファイル

クラスタシステムで送信設定をANYバインド方式に変更する場合や，複数LAN接続の環境で特定のLANを使用する場合に設定します。なお，名前解決するためには，jp1hosts定義ファイルの設定が必要な場合があります。通信方式設定ファイルの詳細については，「4.3.3　通信方式を変更する」を参照してください。

設定変更が必要となる場合の例

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して通信する場合

複数LAN接続の環境で，特定のLANだけを使用して通信する場合

クラスタシステムから論理ホストを削除し，物理ホストだけの環境にする場合

(3)　イベントサーバ設定ファイル（conf）のportsパラメーター

JP1イベントを受信する際に，イベントサーバが使用するIPアドレスを設定します。イベントサーバ設定ファイルのclient-bindパラメーターを省略した場合は，送信元イベントサーバのIPアドレスに設定されます。イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

設定変更が必要となる場合の例

クラスタシステムでのセットアップ時

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して受信する場合

複数LAN接続の環境で，特定のLANだけを使用して通信する場合

(4)　イベントサーバ設定ファイル（conf）のclient-bindパラメーター

JP1イベントを転送する際に，イベントサーバが使用するIPアドレスを設定します。client-bindパラメーターを省略した場合，イベントの送信元IPアドレスは，portsパラメーターに指定されたアドレスが使用されます。設定していないイベントサーバ名に関しては，OSの名前解決を利用します。イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

設定変更が必要となる場合の例

クラスタシステムかつ複数LAN接続の環境で，複数のLANに対してイベントを送信する場合（0.0.0.0を指定）

複数LAN接続の環境で，特定のLANだけを使用して送信する場合

(5)　イベントサーバ設定ファイル（conf）のremote-serverパラメーター

JP1イベントを転送する際に，転送先のイベントサーバ名の名前解決をする場合に設定します。イベント転送先イベントサーバのportsパラメーターで指定しているアドレスを指定します。イベントサーバ名を設定していない場合は，OSの名前解決を利用します。イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

設定変更が必要となる場合の例

OSの名前解決で，イベント転送先イベントサーバ名が名前解決できない場合

優先IPアドレスとして取得できない場合

(6)　API設定ファイル（api）のserverパラメーター

アプリケーションプログラムからイベントサーバにイベントを登録する際の，自ホスト内での名前解決や，他ホストのイベントを検索する際に名前解決する場合に設定します。このパラメーターを設定していないホストに関しては，OSの名前解決を利用します。API設定ファイルの詳細については，「14.　定義ファイル」の「API設定ファイル」を参照してください。

設定変更が必要となる場合の例

イベントサーバ設定ファイルのportsパラメーターに，OSの名前解決で優先的に付与される任意のIPアドレス以外のIPアドレスを指定している場合

OSの名前解決で，JP1/IM - Viewのイベント検索で指定したイベントサーバ名が名前解決できない場合

優先IPアドレスとして取得できない場合

(7)　API設定ファイル（api）のclientパラメーター

アプリケーションプログラムから，イベントサーバへ接続するときに使用するIPアドレスを設定します。このパラメーターを省略した場合は，OSが自動的にIPアドレスを割り当てます。イベントサーバ設定ファイルの詳細については，「14.　定義ファイル」の「API設定ファイル」を参照してください。

設定変更が必要となる場合の例

複数LAN接続の環境で，特定のLANだけを使用して送信する場合

通信設定の詳細については，「4.　ネットワーク構成に応じたJP1/Baseの通信設定」を参照してください。

JP1/Baseが提供する各機能の通信設定への対応状況を次の表に示します。設定を変更した場合は，再起動が必要です。

表H-1　各機能の通信設定への対応状況

機能 | 通信設定
jp1hosts定義ファイル | 通信方式設定ファイル | confファイル | API設定ファイル
ユーザー管理 | ユーザー認証 | ○ | ○ | ○ | ○
ユーザーマッピング | － | － | － | －
起動管理 | 起動順序制御 | － | － | － | －
終了順序制御 | － | － | － | －
イベントサービス | － | － | ○ | ○
イベント変換 | ログファイルトラップ | － | － | － | ○
イベントログトラップ | － | － | － | ○
SNMPトラップ変換 | － | － | － | ○
イベントサービスの定義情報の収集と配布 | ○ | ○ | － | －
プロセス管理機能 | － | － | － | ○
ヘルスチェック | ○ | ○ | － | ○
ローカルアクション | － | － | － | ○
ISAMユーティリティコマンド | － | － | － | －
統合トレース（HNTRLib2） | － | － | － | －
JP1/Baseの機能を拡張してユーザーが作成したプログラム | － | － | － | ○

（凡例）

○：使用する

－：使用しない

付録I　SNMPトラップを変換する

HP NNMまたはJP1/Cm2/NNMが管理するSNMPトラップをJP1イベントに変換します。ネットワークの障害，構成，および性能の情報を集中して管理したい場合に使用します。

以降の説明では，JP1/Cm2/NNMまたはHP NNMをNNMと略します。

JP1/BaseのSNMPトラップ変換では，次の表に示すバージョンのNNMをサポートしています。

表I-1　Windows，Solaris（SPARC）の場合

SNMPトラップ変換機能がサポートするNNM | バージョン
JP1/Cm2/Network Node Manager | 07-10
JP1/Cm2/Network Node Manager Starter Edition Enterprise | 08-00，08-10
JP1/Cm2/Network Node Manager Starter Edition 250 | 08-00，08-10
HP Network Node Manager Starter Edition Software | 7.5

表I-2　HP-UX（IPF）の場合

SNMPトラップ変換機能がサポートするNNM | バージョン
JP1/Cm2/Network Node Manager Starter Edition Enterprise | 08-00，08-10
JP1/Cm2/Network Node Manager Starter Edition 250 | 08-00，08-10
HP Network Node Manager Starter Edition Software | 7.5

また，SNMPトラップをJP1イベントに変換するには，次の条件が必要です。

OSが次のどれかであること。

Windows XP Professional

Windows Server 2003（Windows Server 2003（x64），およびWindows Server 2003（IPF）を除く）

HP-UX（IPF）

Solaris（Solaris（SPARC）大域ゾーン）

NNMが対応していないOS（Windows Server 2008やLinuxなど）では使用できません。

NNMのovstartコマンドの実行環境とNNMのGUIであるovwのLANG環境変数が同じであること。
両方のLANG環境変数が異なる場合，SNMPトラップをJP1イベントに変換できなかったり，NNMのアラーム・ブラウザの表示と異なる変換をしたりすることがあります。詳細についてはNNMのマニュアルを参照してください。

＜この節の構成＞

付録I.1　SNMPトラップ変換機能によるイベント変換の仕組み

付録I.2　SNMPトラップ変換を設定する

付録I.3　SNMPトラップ変換のコマンド

付録I.4　SNMPトラップ変換の定義ファイル

付録I.5　SNMPトラップ変換のJP1イベント

付録I.1　SNMPトラップ変換機能によるイベント変換の仕組み

SNMPトラップをJP1イベントに変換してイベントDBに登録する流れを次の図に示します。

図I-1　SNMPトラップの変換から登録までの流れ

SNMPトラップ変換を使用するには，SNMPトラップ変換動作定義ファイル（imevtgw.conf）およびSNMPトラップ変換フィルターファイル（snmpfilter.conf）を作成し，JP1イベントに変換するSNMPトラップの条件や変換するJP1イベントの重大度などを指定しておきます。その後，NNMを起動すると，SNMPトラップ変換が起動します。

SNMPトラップ変換が起動すると，SNMPトラップ変換フィルターファイル（snmpfilter.conf）に指定した条件と一致するSNMPトラップを取得してJP1イベントに変換します。取得する情報は，メッセージ，重要度，エンタープライズ名，エンタープライズID，オブジェクト名，オブジェクトID，およびソースリストです。SNMPトラップ変換が起動していないときに出力されたSNMPトラップはJP1イベントに変換できません。JP1イベントとして登録できるメッセージは，1,023バイトまでです。JP1イベントに変換するメッセージが1,023バイトを超えた場合，1,023バイト以降のメッセージを切り捨てます。

JP1イベントのイベントIDは，00003A80で固定です。JP1イベントの属性については，「付録I.5　SNMPトラップ変換のJP1イベント」を参照してください。

なお，SNMPトラップ変換は，動作定義ファイルおよびSNMPトラップ変換フィルターファイル（snmpfilter.conf）を読み込む際，ファイル内の構文不正をチェックします。構文不正があった場合は，メッセージを表示します。

＜この項の構成＞

(1)　クラスタシステムでの運用

(2)　変換できるSNMPトラップ

(3)　注意事項

(1)　クラスタシステムでの運用

SNMPトラップ変換機能は，物理ホストでしか動作しません。また，NNMの機能の一つとして動作し，NNMの起動と停止に連動します。このため，JP1/Baseのフェールオーバーとは無関係に動作します。

デフォルトでは，JP1イベントは物理ホストのイベントサービスに登録されます。論理ホストのイベントサービスへ登録したい場合は，SNMPトラップ変換動作定義ファイルのimevt_serverパラメーターに論理ホストのイベントサーバ名，imevt_regkindパラメーターにイベントサーバへの登録方法を指定してください。ただし，NNMを非クラスタシステムで使用し，変換したJP1イベントを直接論理ホストに登録する構成の場合，待機系で受信したSNMPトラップは監視できません。

NNMをクラスタシステムで使用し，直接論理ホストに登録する場合の構成例を次の図に示します。

図I-2　JP1イベントを直接論理ホストに登録する場合の構成例

NNMをクラスタシステムで使用する場合は，実行系・待機系の両方で「付録I.2　SNMPトラップ変換を設定する」を参照してNNMの設定をしてください。また，NNMとJP1/Baseを同じクラスタグループにしてください。

NNMをクラスタシステムで使用し，JP1/Baseを非クラスタシステム，つまり物理ホストだけで使用する場合は，実行系・待機系の両方で物理ホストのJP1/Baseを起動しておく必要があります。

(2)　変換できるSNMPトラップ

変換できるSNMPトラップの条件を次に示します。

各定義ファイルの1行のサイズ
各定義ファイル（imevtgw.conf，snmpfilter.conf，trapd.conf）の1行のサイズが1,023バイト以内である。

エンタープライズ名
trapd.confで定義されているエンタープライズ名の先頭に「#」，「!」，「+」を含まないSNMPトラップ。

イベント名
trapd.confで定義されているイベント名の先頭に*（アスタリスク）を含まないSNMPトラップ

オブジェクトID
trapd.confで定義されているオブジェクトIDに*（アスタリスク）を含まないSNMPトラップ。なお，trapd.confに定義されているオブジェクトIDと発生したSNMPトラップのオブジェクトIDが完全に一致したものだけが，JP1イベントに変換されます。

ソースリスト
NNMの［イベント設定］画面で表示される［イベントの変更］画面－［ソース］タブで，「指定ソースのみ」を選択してソース（ノード）を指定している場合，指定したソースで発生したSNMPトラップだけをJP1イベントとして変換できます。
また，ソースを記述したファイルを指定することもできます。なお，ファイル内では「#」をコメントアウトとして使用できません。1ソース当たりの文字列長の上限は511バイトです。ソース（ノード）名は正規表現には対応していません。

メッセージ
trapd.confから取得したメッセージ中に$変数が含まれている場合，SNMPトラップ変換機能ではJP1イベント変換時にこの$変数をSNMPトラップに含まれる情報で展開します。SNMPトラップ変換機能で対応している$変数は次のとおりです。これ以外の$変数については展開しないで，そのまま出力されます。

デフォルトでは展開されない$変数も展開したい場合は，SNMPトラップ変換動作定義ファイル（imevtgw.conf）で設定してください。設定方法については，「付録I.4(1)　SNMPトラップ変換動作定義ファイル（imevtgw.conf）」を参照してください。
$変数の情報展開時にエラーが発生した場合，KAVA2108-Eのメッセージが出力されます。エラーをJP1イベントとして検知したい場合は，統合トレースログに出力されるKAVA2108-Eのメッセージを条件に，ログファイルトラップで監視してください。
なお，$変数の展開後の出力は，NNMの出力するメッセージと表示が異なる場合があります。NNMの出力するメッセージを確認する方法には，次に示す二つの方法があります。

JP1/IM - Viewの統合機能メニューを利用して，ネットワーク管理を選択し，NNM画面を開いて確認する。

JP1/IM - Viewの［イベント詳細］画面からNNMをモニター起動して，NNMのアラーム・ブラウザで確認する。

一般トラップ
SNMPトラップ変換機能では，一般トラップを変換できます。
SNMPトラップ変換フィルターファイル（snmpfilter.conf）に一般トラップを変換対象として定義した場合，「エンタープライズID付き一般トラップ」も一般トラップとして変換されます。また，trapd.confに一般トラップと「エンタープライズID付き一般トラップ」の両方が定義されている場合，NNMでは「エンタープライズID付き一般トラップ」として変換され，SNMPトラップ変換機能では一般トラップとして変換されます。そのため，NNMで表示されている内容と，JP1/IM - Viewで表示される内容が異なる場合があります。この現象を回避したい場合は，変換したい「エンタープライズID付き一般トラップ」の定義をSNMPトラップ変換フィルターファイル（snmpfilter.conf）に追加してください。一般トラップと「エンタープライズID付き一般トラップ」の例を次に示します。

（例）一般トラップ

エンタープライズ名：snmpTraps

イベント名：SNMP_Link_Down

オブジェクトID：.1.3.6.1.6.3.1.1.5.3

（例）エンタープライズID付き一般トラップ

エンタープライズID：hitachi

イベント名：HI_Link_Down

オブジェクトID：.1.3.6.1.6.3.1.1.5.3.1.3.6.1.4.1.116

なお，次に示すNNM内部で使用されるSNMPトラップはJP1イベントに変換できません。

OpenView.OV_Ack_Alarm

OpenView.OV_Delete_Alarm

OpenView.OV_Unack_Alarm

OpenView.OV_ChgSev_Alarm

OpenView.OV_ChgCat_Alarm

ECSエンジンに起因するイベント（OpenView.OV_Corr_Indicなど）

詳細についてはNNMのマニュアルを参照してください。

(3)　注意事項

SNMPトラップ変換機能を使用する際の注意事項を次に示します。

SNMPトラップをJP1イベントに変換する際に，イベントサービスとの接続に失敗した場合，エラーメッセージが表示され，該当するイベントデータは破棄されます。

付録I.2　SNMPトラップ変換を設定する

SNMPトラップ変換の起動，設定の変更，および終了の手順について説明します。

＜この項の構成＞

(1)　セットアップ

(2)　起動する

(3)　設定を変更する

(4)　終了する

(5)　設定を解除する

(1)　セットアップ

SNMPトラップ変換を使用する前に，セットアップを行います。JP1/Baseを上書きインストールした場合もセットアップが必要です。SNMPトラップ変換のセットアップの手順を次に示します。

imevtgw_setupコマンドを実行し，NNMにSNMPトラップ変換を登録する。

Windowsの場合
コマンドプロンプトから次のコマンドを実行します。

cd インストール先フォルダ¥bin
imevtgw_setup.exe

UNIXの場合
次のコマンドを実行します。

/opt/jp1base/bin/imevtgw_setup

SNMPトラップ変換機能がNNMのプロセス管理に登録されます。

SNMPトラップ変換機能が正しく登録されたかどうかを確認する。
NNMのプロセスを次に示す操作で確認します。

Windowsの場合
スタートメニューから，［プログラム］－［Network Node Manager］－［ネットワークノードマネージャー管理］－［NNMステータス］を選択します。

UNIXの場合
次のコマンドを実行します。

/opt/OV/bin/ovstatus

ovwプロセスの配下にIMEvtgwというプロセスが表示されていれば，正しく登録できています。

(2)　起動する

SNMPトラップ変換を起動する手順を次に示します。

SNMPトラップ変換動作定義ファイル（imevtgw.conf）を編集する。
動作定義ファイルの詳細については，「付録I.4（1）　SNMPトラップ変換動作定義ファイル（imevtgw.conf）」を参照してください。

SNMPトラップ変換フィルターファイル（snmpfilter.conf）を編集する。

JP1イベントに変換するSNMPトラップの条件を，trapd.confに記載されているエンタープライズ名とイベント名で指定します。SNMPトラップ変換フィルターファイルの詳細については，「付録I.4（2）　SNMPトラップ変換フィルターファイル（snmpfilter.conf）」を参照してください。

NNMを起動する。
NNMを起動すると，SNMPトラップ変換が起動します。

Windowsの場合
スタートメニューから［プログラム］－［Network Node Manager］－［ネットワークノードマネージャー管理］－［NNMサービス - 開始］を選択します。

UNIXの場合
次のコマンドを実行して，NNMのバックグラウンド・プロセスを起動します。

/opt/OV/bin/ovstart

正しく動作するか確認する。
実際に変換対象のSNMPトラップを発生させて，JP1イベントに変換されているかを確認してください。

(3)　設定を変更する

SNMPトラップ変換動作定義ファイル（imevtgw.conf），およびSNMPトラップ変換フィルターファイル（snmpfilter.conf）を変更した場合の反映方法を次に示します。

SNMPトラップ変換動作定義ファイルを変更した場合

定義ファイルの編集後，SNMPトラップ変換を再起動してください。

SNMPトラップ変換フィルターファイルを変更した場合

NNMが提供するxnmeventsコマンドに-eventオプションを指定して実行すると，SNMPトラップ変換を停止しないで変更を反映できます。

(4)　終了する

SNMPトラップ変換を終了する方法を次に示します。

Windowsの場合
スタートメニューから「プログラム」－「Network Node Manager」－「ネットワークノードマネージャー管理」－「NNMサービス - 終了」を選択します。

UNIXの場合
次のコマンドを実行します。

/opt/OV/bin/ovstop

(5)　設定を解除する

JP1/Baseをアンインストールする場合，アンインストールの前に，NNMのプロセス管理に登録したSNMPトラップ変換を解除してください。解除の手順を次に示します。

Windowsの場合

スタートメニューから「プログラム」－「Network Node Manager」－「ネットワークノードマネージャー管理」－「NNMステータス」を実行して，IMEvtgw（SNMPトラップ変換機能）が実行中でないことを確認する。
IMEvtgwが実行中の場合は，スタートメニューから「プログラム」－「Network Node Manager」－「ネットワークノードマネージャー管理」－「NNMサービス - 終了」を選択して，終了してください。

コマンドプロンプトで次のコマンドを実行する。
cd インストール先フォルダ¥bin
imevtgw_setup.exe -d
imevtgw.exeファイルがNNMのフォルダから削除され，SNMPトラップ変換を起動する設定がNNMのプロセス管理から解除されます。

UNIXの場合

/opt/OV/bin/ovstatusコマンドを実行し，IMEvtgw（SNMPトラップ変換）が実行中でないことを確認する。
実行中の場合は，/opt/OV/bin/ovstopコマンドを実行してNNMのデーモンプロセスを終了してください。

次のコマンドを実行する。
/opt/jp1base/bin/imevtgw_setup -d
imevtgw.exeファイルとimevtgwファイルがNNMのディレクトリから削除され，SNMPトラップ変換の設定がNNMのプロセス管理から解除されます。

付録I.3　SNMPトラップ変換のコマンド

SNMPトラップ変換で使用するコマンドの文法について説明します。

＜この項の構成＞

(1)　imevtgw_setup（Windows，HP-UX，Solaris限定）

(1)　imevtgw_setup（Windows，HP-UX，Solaris限定）

機能

SNMPトラップ変換をNNMのプロセス管理に登録します。

形式

imevtgw_setup { -d }

実行権限

Windowsの場合：Administrators権限

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

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-d

SNMPトラップ変換を解除する場合に指定します。

注意事項

JP1/Baseをアンインストールする場合は，アンインストール前にこのコマンドを実行して，NNMのプロセス管理に登録されたSNMPトラップ変換機能を解除してください。

このコマンドは，修正パッチを適用した場合やバージョンアップを行った場合にも実行してください。

このコマンドは，SNMPトラップ変換機能が停止している状態で実行してください。

クラスタ環境でNNMを使用している場合，このコマンドを実行系および待機系の両方で実行してください。ただし，WindowsでNNMクラスタ運用方式として「直接データ共有方式」を採用している場合には，アクティブなノードでだけ実行してください。

付録I.4　SNMPトラップ変換の定義ファイル

SNMPトラップ変換で使用する定義ファイルの形式および文法について説明します。

＜この項の構成＞

(1)　SNMPトラップ変換動作定義ファイル（imevtgw.conf）

(2)　SNMPトラップ変換フィルターファイル（snmpfilter.conf）

(1)　SNMPトラップ変換動作定義ファイル（imevtgw.conf）

形式

nnm_url_base http://ホスト名:ポート番号/OvCgi/jovw.exe?MapName=default
severity SNMPトラップの重要度 to JP1イベントの重大度
snmp-filter
source ホスト名1 ホスト名2 ホスト名3...
end-filter
var_expand 0 | 1
var_option $変数...
imevt_server イベントサーバ名
imevt_regkind 0 | 1

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥evtgw¥imevtgw.conf

UNIXの場合

/etc/opt/jp1base/conf/evtgw/imevtgw.conf

説明

NNMのURLやSNMPトラップの重要度とJP1イベントの重大度のマッピングなど，SNMPトラップ変換時の動作を設定します。

定義の反映時期

SNMPトラップ変換機能を起動すると，設定が有効になります。

定義の記述

パラメーターの各単語は，半角スペースまたはタブで区切ってください。

行頭に「#」を指定すると，その行はコメント行になります。

記述内容

nnm_url_base

JP1/IM - Viewの［イベント詳細］画面からNNMをモニター起動するために，NNMのURLを次の書式で指定します。

http://ホスト名:ポート番号/OvCgi/jovw.exe?MapName=default

ホスト名には，SNMPトラップ変換動作定義ファイル（imevtgw.conf）を設定するホストのホスト名を記述します。ホスト名で指定したホストがWindowsの場合，ポート番号の指定は不要です。指定したホストがUNIXの場合，ポート番号を指定します。NNM6.2（NNM 07-01）以前をご使用の場合は8880を指定します。NNM6.4（NNM 07-10）以降をご使用の場合は3443を指定します。ただし，NNMの設定によっては，ポート番号が異なる場合があります。NNMでのポート番号の設定をご確認ください。

severity

SNMPトラップの重要度と変換後のJP1イベントの重大度を対応づけます。SNMPトラップの重要度に指定できる内容を次に示します。

normal

warning

minor

major

critical

unknown

unknownは，SNMPトラップに重要度のデータがない，またはnormal，warning，minor，major，criticalに一致しないものを指します。

JP1イベントの重大度に指定できる内容を次に示します。

Information

Notice

Warning

Error

Emergency

Critical

Alert

Debug

デフォルトおよびseverityパラメーターの指定を省略した場合は，次のように対応づけられます。

SNMPトラップの重要度 | 変換後のJP1イベントの表示（重大度）
normal | Information
warning | Warning
minor | Error
major | Critical
critical | Alert

snmp-filter

source ホスト名1　ホスト名2　ホスト名3...

end-filter

JP1イベントに変換するSNMPエージェントのホスト名を指定します。NNMのアラーム・ブラウザに表示されるソース（ホスト名）を指定してください。大文字小文字は区別されます。

ここで指定したホスト名から発行されたSNMPトラップのうち，SNMPトラップ変換フィルターファイル（snmpfilter.conf）で指定した条件に一致するSNMPトラップをJP1イベントに変換します。ホスト名を複数指定した場合は，どれかが一致した場合に条件が成立します。

source条件文を指定する場合の注意事項を次に示します。

source条件文の指定は，必ずsnmp-filterとend-filterで囲んでください。

sourceとホスト名指定，およびホスト名とホスト名指定は，スペースまたはタブで区切ってください。

1行当たり1,023バイトまで指定できます。1,024バイト以降に指定されたホスト名は無効となります。

一つのsnmp-filter内には，source条件文は一つだけ指定できます。一つのsource属性条件文に対象ホスト名をすべて指定できない場合，別のsnmp-filter文のsource条件文で指定してください。

このパラメーターの指定を省略した場合，SNMPトラップ変換フィルターファイル（snmpfilter.conf）で指定した条件に一致するSNMPトラップがすべてJP1イベントに変換されます。

var_expand 0｜1

trapd.confから取得したメッセージ中に$r・$ar・$c・$s・$N・$$・$C・$aA・$T変数が含まれている場合，JP1イベント変換時にこれらの$変数をSNMPトラップに含まれる情報として展開するかどうかを指定します。

0を指定すると，デフォルトで展開される$#・$数字・$-数字・$+数字・$>数字・$>-数字・$>+数字・$x・$X・$@・$O・$o・$G・$S・$e・$E・$A・$*の合計18個の$変数を展開します。

1を指定すると，デフォルトで展開される$#・$数字・$-数字・$+数字・$>数字・$>-数字・$>+数字・$x・$X・$@・$O・$o・$G・$S・$e・$E・$A・$*に加えて，$r・$ar・$c・$s・$N・$$・$C・$aA・$Tの合計27個の$変数を展開します。

このパラメーターを省略すると，0が仮定されます。

var_option $変数...

trapd.confから取得したメッセージ中に，このパラメーターで指定した$変数が含まれている場合，NNMの表示と同じ内容を展開します。指定できる$変数は，$Eおよび$eの2種類です。

このパラメーターを省略した場合，または指定のない$変数に対しては，SNMPトラップ変換機能の$変数変換方式で情報を展開します。この場合，NNMに表示される内容とは異なった情報になります。

imevt_server イベントサーバ名

クラスタシステムなどで，変換したJP1イベントを論理ホストに登録したい場合にイベントサーバ名を指定します。指定できるイベントサーバは，自ホストで稼働しているイベントサーバに限ります。このパラメーターを指定する場合，イベントサーバ設定ファイル（conf）のremote-serverパラメーターにもイベントサーバ名が設定されている必要があります。ただし，JP1/Baseのバージョンが09-00以降では，imevt_regkindパラメーターに0を設定した場合に，remote-serverパラメーターが設定されている必要があります。イベントサーバ設定ファイル（conf）については，「14.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

このパラメーターを省略すると，JP1イベントの登録先は自ホストに仮定されます。

imevt_regkind 0｜1

imevt_serverパラメーターで指定したイベントサーバにJP1イベントを登録する方法を指定します。0を指定すると，imevt_serverパラメーターで指定したイベントサーバへ登録するJP1イベントの登録要因は3※になります。1を指定すると，imevt_serverパラメーターで指定したイベントサーバへ登録するJP1イベントの登録要因は1※になります。

imevt_serverパラメーターが指定されていない場合は，このパラメーターを設定する必要はありません。

このパラメーターを省略すると，1（登録要因1で登録）が仮定されます。

注※　JP1イベントの登録要因

1：　自イベントサーバから自イベントサーバあての発行

3：　他イベントサーバから自イベントサーバあての発行

注意事項

従来のSNMPトラップ変換機能では，imevt_serverパラメーターを設定し，かつイベントサーバ設定ファイル（conf）のremote-serverパラメーターをデフォルトから変更している場合，imevt_serverパラメーターに設定したイベントサーバ名をremote-serverパラメーターにも設定することが必要でした。このような環境で次の作業をした場合，SNMPトラップ変換機能でのJP1イベントの登録要因が3から1に変更になります。

バージョン9への上書きバージョンアップ

以前のバージョンの定義ファイルをバージョン9へ移行する

登録要因が変更になることで，次の機能を使用している場合に影響があります。

転送設定ファイル（forward）にB.REASON属性を設定している

jevexportコマンドの-fオプションでフィルターファイルにB.REASON属性を設定している

JP1イベントを取得する関数のJevGetOpen関数の第3引数（lpszFilter）にB.REASON属性を指定している

JP1イベントを取得する関数のJevGetRegistFactor関数で登録要因を取得している

従来と同じ登録要因から変更させないためには，imevt_regkindパラメーターに0を設定する必要があります。ただし，0を設定した場合，JP1イベントの登録でエラーになるおそれがあります。エラーになった場合には，登録対象のSNMPイベントをロストします。

なお，JP1/Baseのバージョンが09-00以降では，imevt_regkindパラメーターを0に設定しないかぎり，remote-serverパラメーターの設定は必要ありません。

定義例

次に示す条件で，SNMP動作定義ファイルを作成します。

NNMのURL：自ホスト（HostA）

ポート番号：8080

SNMPトラップの重要度とJP1イベントの重大度の対応：デフォルトの設定に下記の条件を追加。

SNMPトラップの重要度「unknown」をJP1イベントの重大度「Information」に対応させる。

SNMPエージェントのホスト名指定：hostA，hostB，hostC，および10.208.aa.bbb

$変数展開パラメーター：$r・$ar・$c・$s・$N・$$・$C・$aA・$T変数が含まれている場合，JP1イベント変換時にこれらの$変数をSNMPトラップに含まれる情報として展開する。

$変数変換方式指定パラメーター：$Eまたは$eが含まれている場合，NNMの表示と同じ内容の情報を展開する。

# NNM URL
nnm_url_base    http://HostA:8080/OvCgi/jovw.exe?MapName=default

# JP1EVENT SEVERITY
severity normal  to Information
severity warning to Warning
severity minor   to Error
severity major   to Critical
severity critical to Alert
severity unknown to Information

# SNMPエージェントのホスト名指定
snmp-filter
 source hostA hostB hostC 10.208.aa.bbb
end-filter

# $変数展開パラメーター
var_expand   1

# $変数変換方式指定パラメーター
var_option  $E $e

(2)　SNMPトラップ変換フィルターファイル（snmpfilter.conf）

形式

[+△] エンタープライズ名.イベント名
[+△] エンタープライズ名.*
！エンタープライズ名.イベント名

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥evtgw¥snmpfilter.conf

UNIXの場合

/etc/opt/jp1base/conf/evtgw/snmpfilter.conf

説明

JP1イベント変換対象とするSNMPトラップおよびJP1イベント変換対象外とするSNMPトラップを指定します。SNMPトラップ変換フィルターファイル（snmpfilter.conf）に定義するエンタープライズ名およびイベント名は，NNMのtrapd.confに定義されているエンタープライズ名およびイベント名と完全に一致するようにしてください。エンタープライズ名，およびイベント名の大文字小文字は区別されます。なお，trapd.confは，NNMが起動する言語環境によって異なるため注意してください。

定義の反映時期

次のどれかを操作すると，設定が有効になります。

SNMPトラップ変換機能を起動する。

NNMのアラームブラウザ（xnmevents）を起動する。

NNMのイベント設定ダイアログボックスで設定を変更し，［保存］ボタンをクリックする。

NNMが提供するxnmevents -eventコマンドを実行する。

NNMが提供するxnmtrap -eventコマンドを実行する。

定義の記述

行頭に「#」を指定すると，その行はコメント行になります。

SNMPトラップ変換フィルターファイル（snmpfilter.conf）の定義内容は，次に示す式で900バイト以下にしてください。
（（a1＋1）＋（a2＋1）＋（a3＋1）＋（a4＋1）・・・（an※＋1））＋34 < 900バイト
注※　SNMPトラップ変換フィルターファイル（snmpfilter.conf）で定義されているSNMPトラップのオブジェクトID長。例えば，オブジェクトIDが「.1.2.3.4.5」の場合，anは10バイトになります。
SNMPトラップ変換フィルターファイル（snmpfilter.conf）に一般トラップを定義する場合は，次に示す式で計算してください。
上記計算式の結果＋（一般トラップ数×2） < 900

記述内容

＋

SNMPトラップのバリアブルバインディングをJP1イベントの拡張属性の固有情報として変換する場合に指定します。「+」とエンタープライズ名の間には，一つ以上のスペースまたはタブを入れてください。なお，1行の中で「+」と「!」の指定を混在させないでください。混在させた場合は，その行は無効となります。

バリアブルバインディングをJP1イベントに変換する際の注意事項

変換できる各バリアブルバインディング値の最大値は1,023バイトです。1,024バイト以降のデータは変換されません。

JP1イベントの最大値は10,000バイトです。バリアブルバインディングをJP1イベントの拡張属性の固有情報として変換すると，JP1イベントのサイズが10,000バイトを超える場合，変換されないバリアブルバインディングが存在します。

JP1イベントの拡張属性の固有情報として変換できるバリアブルバインディングの個数は最大28個です。

エンタープライズ名

変換するSNMPトラップのOID_ALIASを指定します。

イベント名

変換するSNMPトラップのイベント名を指定します。

エンタープライズ名とイベント名の例

エンタープライズ名とイベント名について説明します。

エンタープライズ名は，trapd.confに次のように定義されています。

図I-3　trapd.confのエンタープライズ名の定義例

イベント名は，trapd.confに次のように定義されます。この例では，イベント名が「OV_Network_Warning」となっています。

図I-4　trapd.confのイベント名の定義例

*

指定したエンタープライズ名のSNMPトラップすべてを，JP1イベントの変換対象とします。

！

JP1イベント変換対象として指定したSNMPトラップ（「[+△] エンタープライズ名.*」または「[+△] エンタープライズ名.イベント名」）のうち，ここで指定したSNMPトラップをJP1イベント変換の対象外とします。このパラメーターを指定しても，「[+△] エンタープライズ名.*」または「[+△] エンタープライズ名.イベント名」の指定がない場合は，無効となります。

注意事項

SNMPトラップ変換では，SNMPトラップをJP1イベントに変換する際，SNMPトラップ変換フィルターファイル（snmpfilter.conf）の定義順に比較します。そのため，SNMPトラップ変換フィルターファイル（snmpfilter.conf）にはJP1イベントに変換する優先度の高い順に定義してください。

SNMPトラップ変換フィルターファイル（snmpfilter.conf）では「エンタープライズ名」および「イベント名」に.（ピリオド）を指定できません。変換対象のSNMPトラップの「エンタープライズ名」および「イベント名」に，.（ピリオド）が含まれる場合は，NNMで.（ピリオド）を使用しない名前に変更してください。

定義例

次に示す条件と一致するSNMPトラップをJP1イベントに変換します。

エンタープライズ名：OpenView，snmpTraps，またはsso

エンタープライズ名がOpenViewかつイベント名がOV_Network_Critical

条件1，2と一致しても，エンタープライズ名がsnmpTrapsかつイベント名がSNMP_Authen_FailureのSNMPトラップは変換しない。

OpenView.*
snmpTraps.*
sso.*

OpenView.OV_Network_Critical

!snmpTraps.SNMP_Authen_Failure

付録I.5　SNMPトラップ変換のJP1イベント

SNMPトラップ変換で発行されるJP1イベントについて説明します。SNMPトラップを検知すると，イベントID「00003A80」のJP1イベントが発行されます。イベントID「00003A80」の詳細を，次の表に示します。なお，JP1イベントの属性については，「15.1　JP1イベントの属性」を参照してください。

表I-3　イベントID：00003A80の詳細

属性種別
項目
属性名
内容

基本属性
メッセージ
－
JP1/Cm2/NNMまたはHP NNMのメッセージ

拡張属性
共通情報
重大度
SEVERITY
SNMPトラップの重要度に対応した値
デフォルトの設定
値 : 重要度
Information : Normal
Warning : Warning
Error : Minor
Critical : Major
Alert : Critical

プロダクト名
PRODUCT_NAME
/HITACHI/JP1/IM/SNMP_TRAP

オブジェクトタイプ
OBJECT_TYPE
SNMP_TRAP

オブジェクト名
OBJECT_NAME
JP1/Cm2/NNMまたはHP NNMで設定されたイベント名

登録名タイプ
ROOT_OBJECT_
TYPE
SNMP_TRAP

登録名
ROOT_OBJECT_
NAME
JP1/Cm2/NNMまたはHP NNMで設定されたイベント名

事象種別
OCCURRENCE
RECEIVE

固有情報
SNMP Object ID
SNMP_OID
SNMPトラップのオブジェクトID

SNMPトラップ発生日時
SNMP_DATE
SNMPトラップの発生日時

SNMPトラップ発生ソース
SNMP_SOURCE
SNMPトラップの発生ソース

重要度
SNMP_SEVERITY
SNMPトラップに設定された重要度

NNMサブマップ表示URL
SNMP_URL
JP1/Cm2/NNMまたはHP NNMのサブマップを表示するためのURL

バリアブルバインディング格納結果※1
SNMP_VARBIND_RESULT
バリアブルバインディングを変換した結果
SUCCESS：
すべての$変数が変換された。
ESTRLEN：
文字列長の制限（1,023バイト）によって文字列が途切れた$変数がある。
EVARNUM：
$変数の個数制限（28個）によって削除された$変数がある。
EEVENTLEN：
JP1イベント長の制限（10,000バイト）によって削除された$変数がある。
ESTRVARNUM：
$変数の個数制限（28個）によって削除された$変数があり，かつ，変換された$変数の中に文字列長の制限（1,023バイト）によって文字列が途切れた$変数がある。
ESTREVENTLEN：
JP1イベント長の制限（10,000バイト）によって削除された$変数があり，かつ，変換された$変数の中に文字列長の制限（28個）によって文字列が途切れた$変数がある。

バリアブルバインディングの数※1
SNMP_VARBIND_NUM
SNMPトラップに含まれるバリアブルバインディングの個数

オブジェクトID[1,2,3...]※1※2
SNMP_VARBIND_OID[1,2,3...]※2
バリアブルバインディングのオブジェクトID

型[1,2,3...]※1※2
SNMP_VARBIND_TYPE[1,2,3...]※2
バリアブルバインディングの型
ASN_INTEGER
ASN_U_INTEGER
ASN_OCTET_STR
ASN_OBJECT_ID
ASN_IPADDRESS
ASN_UNSIGNED32
ASN_COUNTER32
ASN_TIMETICKS
ASN_COUNTER64
Unsupport:上記以外の型

値[1,2,3...]※1※2
SNMP_VARBIND[1,2,3...]※2
バリアブルバインディングの値

（凡例）

－：なし

注※1　SNMPトラップ変換機能の設定で，バリアブルバインディングをJP1イベントに変換する設定にした場合に出力されます。

注※2　一つのバリアブルバインディングに対して，SNMP_VARBIND_OID，SNMP_VARBIND_TYPE，およびSNMP_VARBINDの三つが出力されます。各項目のあとに付く数値は，バリアブルバインディングの$変数に対応しています。

付録J　JP1/SESイベントを使用する製品との連携

JP1/SESイベントとは，バージョン5以前の製品であるJP1/SES，JP1/AJSのイベントサーバで発行されるイベントです。JP1/SESおよびJP1/AJSは，次のプログラムを指します。

JP1/SES

JP1/SES 05-10以前

JP1/AOM - EE 05-10から05-20（UNIX版）

JP1/AJS

JP1/AJS 05-20以前（Windows NT版）

JP1/AJS - EE 05-10から05-20（Windows NT版）

JP1/SESイベントを使用する製品には次のものがあります。

JP1/OJE Client for VOS1

JP1/OJE Client for VOSK

OSCF/Datareplicator Client（VOSKデータ連動機能）

VOSK Datareplicator for HiRDB（VOSKデータ連動機能）

JP1/OJE Client for VOS3

JP1/OJE Client for Mainframe

JP1/OJE for VOS3

JP1/OJE for Mainframe（MVS版）

HiRDB

JP1/AJSのajsevput，ajsevgetコマンド（Windows Server 2003版だけ）

JP1/Baseでは，これらJP1/SESイベントを使用する製品と連携するための機能（V5互換機能）を提供しています。V5互換機能は物理ホストで稼働するイベントサーバだけで使用できます。物理ホストで稼働するイベントサーバとは，イベントサーバインデックスファイル（index）のイベントサーバ名の部分に，「*」または「@」を指定したイベントサーバのことを指します。

また，JP1/SESイベントをJP1イベントに変換すると，JP1/IMからそのイベントを監視できるようになります。

ここでは，JP1/SESイベントを使用する製品と連携する場合の設定方法や，JP1/SESイベントをJP1イベントに変換する場合の設定方法について説明します。

＜この節の構成＞

付録J.1　JP1/SESイベントを使用する製品別の設定

付録J.2　JP1/SESイベントを使用する製品で共通の設定

付録J.3　JP1/SESイベントを使用する場合の注意事項

付録J.4　JP1/SESイベントをJP1イベントに変換する

付録J.1　JP1/SESイベントを使用する製品別の設定

JP1/SESイベントを使用する製品と連携する場合に，JP1/Baseで必要となる設定について説明します。

＜この項の構成＞

(1)　VOS1/VOSKのJP1/OJEまたはVOSKデータ連動機能を使用する場合

(2)　VOS3/MVSのJP1/OJEを使用する場合

(3)　HiRDBを使用する場合

(4)　 ajsevputコマンドを使用する場合

(5)　ajsevgetコマンドを使用する場合

(1)　VOS1/VOSKのJP1/OJEまたはVOSKデータ連動機能を使用する場合

(a)　各種クライアント製品を使用する場合

JP1/Baseが動作するホスト上で，JP1/OJEまたはVOSKデータ連動機能のクライアント製品を使用する場合，次の設定をしてください。

イベントサーバ設定ファイル（conf）から，V5互換機能を抑止するパラメーターであるoptions v5-unusedパラメーターを削除する。

servicesファイルに，サービス名「JP1AutoJob」のTCPポートを定義する。
TCPポートの定義については，「付録C.1　JP1/Baseのポート番号」を参照してください。
次に定義例を示します。

JP1AutoJob  5001/tcp  # JP1/AutoJob Event Service

なお，ポート番号（5001）は接続先の設定と一致させてください。

(b)　イベント送信機能を使用する場合

VOS1/VOSK上のJP1/OJEから，JP1/Baseが動作するホストへイベントを送信する場合，送信先のJP1/Baseで「(a)　各種クライアント製品を使用する場合」と同じ設定をしてください。なお，UNIX版が動作するクライアントの場合，servicesファイルに定義するサービス名は「jesrd」としてください。

(c)　イベント受信機能を使用する場合

VOS1/VOSK上のJP1/OJEで，JP1/Baseが動作するホストから送信するイベントを受信する場合，送信元のJP1/Baseで次の設定をしてください。

イベントサーバ設定ファイル（conf）から，V5互換機能を抑止するパラメーターであるoptions v5-unusedパラメーターを削除する。

イベントサーバ設定ファイル（conf）でremote-serverパラメーターのイベントサーバ名にVOS1/VOSKのホスト名，通信タイプに「ses」を定義する。

servicesファイルに，サービス名「JP1AutoJob」または「jesrd」のTCPポートを定義する。
TCPポートの定義については，「付録C.1　JP1/Baseのポート番号」を参照してください。
次に定義例を示します。

Windowsの場合
JP1AutoJob  5001/tcp  # JP1/AutoJob Event Service

UNIXの場合
jesrd  5001/tcp  # JP1/SES remote management server

なお，ポート番号（5001）は接続先の設定と一致させてください。

(2)　VOS3/MVSのJP1/OJEを使用する場合

(a)　SES通信方式で各種クライアント製品を使用する場合

VOS3/MVS上のJP1/OJEで「SES通信方式」を設定し，イベント送受信機能のジョブ実行機能を使用しているときに，JP1/Baseが動作するホスト上でJP1/OJEのクライアント製品を使用する場合，「(1)　VOS1/VOSKのJP1/OJEまたはVOSKデータ連動機能を使用する場合」の「(a)　各種クライアント製品を使用する場合」と同じ設定をしてください。なお，VOS3/MVS上のJP1/OJEで「IM通信方式」を設定しているか，バッチジョブ連携機能を使用している場合，この設定は不要です。

V5互換機能は，将来廃止される可能性があります。「IM通信方式」を設定するか，またはバッチジョブ連携機能を使用する運用への移行をご検討ください。

(b)　イベント送信機能を使用する場合

VOS3/MVS上のJP1/OJEで「SES通信方式」を設定しているときに，VOS3/MVS上のJP1/OJEからJP1/Baseが動作するホストへイベントを送信する場合，「(1)　VOS1/VOSKのJP1/OJEまたはVOSKデータ連動機能を使用する場合」の「(b)　イベント送信機能を使用する場合」と同じ設定をしてください。なお，VOS3/MVS上のJP1/OJEで「IM通信方式」を設定している場合，この設定は不要です。

V5互換機能は，将来廃止される可能性があります。「IM通信方式」を設定する運用への移行をご検討ください。

(c)　イベント受信機能を使用する場合

VOS3/MVS上のJP1/OJEで「SES通信方式」を設定しているときに，VOS3/MVSホストのJP1/OJEで，JP1/Baseが動作するホストから送信するイベントを受信する場合，「(1)　VOS1/VOSKのJP1/OJEまたはVOSKデータ連動機能を使用する場合」の「(c)　イベント受信機能を使用する場合」と同じ設定をしてください。なお，VOS3/MVS上のJP1/OJEで「IM通信方式」を設定している場合，この設定は不要です。

V5互換機能は，将来廃止される可能性があります。「IM通信方式」を設定する運用への移行をご検討ください。

(3)　HiRDBを使用する場合

(a)　イベント通知機能を使用する場合

pd_jp1_event_levelオペランドに「1」を設定している場合，「(1)　VOS1/VOSKのJP1/OJEまたはVOSKデータ連動機能を使用する場合」の「(a)　各種クライアント製品を使用する場合」と同じ設定をしてください。なお，pd_jp1_event_levelオペランドに「2」を設定している場合，この設定は不要です。

V5互換機能は，将来廃止される可能性があります。pd_jp1_event_levelオペランドに「2」を設定できる環境では，「2」を設定する運用への移行をご検討ください。

(4)　 ajsevputコマンドを使用する場合

「(1)　VOS1/VOSKのJP1/OJEまたはVOSKデータ連動機能を使用する場合」の「(a)　各種クライアント製品を使用する場合」と同じ設定をしてください。

ajsevputコマンドは，将来廃止される可能性があります。JP1/Baseのjevsendコマンドまたはjevsenddコマンドを使用する運用への移行をご検討ください。

(5)　ajsevgetコマンドを使用する場合

「(1)　VOS1/VOSKのJP1/OJEまたはVOSKデータ連動機能を使用する場合」の「(a)　各種クライアント製品を使用する場合」と同じ設定をしてください。

ajsevgetコマンドは，将来廃止される可能性があります。JP1/Baseのイベント取得関数を用いたユーザープログラムを使用する運用への移行をご検討ください。

付録J.2　JP1/SESイベントを使用する製品で共通の設定

必要に応じてイベントサーバ設定ファイル（conf）に次のパラメーターを設定してください。

＜この項の構成＞

(1)　users　{　*　|　ユーザー名　}　…

(2)　eventids　{　*　|　基本コード　|　基本コード:拡張コード　}

(3)　buffnum　JP1/SESイベント数

(4)　include　ses-conf　ファイル名

(5)　include　ajs-conf

(6)　options　[conv-off]

(1)　users　{　*　|　ユーザー名　}　…

include ses-confパラメーター，またはinclude ajs-confパラメーターに指定するファイル内でユーザー名を設定していない場合は，このパラメーターにユーザー名を指定する必要があります。なお，「*」を指定してもすべてのユーザーでイベントを取得できるようにはなりません。

Windowsの場合は，「system」および「SYSTEM」を指定してください。これらを指定しなかった場合，イベントサーバは起動に失敗します。UNIXの場合は，ユーザー名として必ずスーパーユーザー名（通常は「root」）および「adm」を指定してください。

(2)　eventids　{　*　|　基本コード　|　基本コード:拡張コード　}

include ses-confパラメーター，またはinclude ajs-confパラメーターに指定するファイル内でイベントIDを設定していない場合は，このパラメーターにイベントIDを指定する必要があります。なお，「*」を指定してもすべてのイベントIDのイベントを取得できるようにはなりません。

(3)　buffnum　JP1/SESイベント数

JP1/SESイベントを取得するプログラムのために保存しておくJP1/SESイベント数を指定します。この値を超えたJP1/SESイベントが登録されると，古いJP1/SESイベントから順に削除され，削除されたJP1/SESイベントは，取得できなくなります。値は，Windowsの場合は64～2,048，UNIXの場合は2,500～10,000の10進数で指定します。省略すると，Windowsの場合は1,024，UNIXの場合は2,500を仮定します。

(4)　include　ses-conf　ファイル名

JP1/SESの環境定義ファイルから，バッファー数（BUFFNUM），ユーザー名（USER），イベントID（EVIDxxxx）の指定を取り込みます。取り込んだバッファー数の指定は，イベントサーバ設定ファイル（conf）に指定したbuffnumパラメーターよりも優先されます。また，ユーザー名およびイベントIDの指定は，イベントサーバ設定ファイル（conf）での指定と取り込んだ指定の和となります。

ファイル名はフルパスで指定します。この指定はWindows版のJP1/Baseでは無効になり，UNIX版のJP1/Baseだけで有効になります。

(5)　include　ajs-conf

JP1/AJS - EEの設定ダイアログボックスで指定した，最大イベント数，UNIXユーザーID，UNIXグループID，ユーザー名，およびイベントIDの指定を取り込みます。取り込んだ最大イベント数，UNIXユーザーID，UNIXグループIDの指定は，イベントサーバ設定ファイル（conf）に指定したbuffnumパラメーター，alt-useridパラメーターよりも優先されます。また，ユーザー名およびイベントIDの指定は，イベントサーバ設定ファイル（conf）での指定と取り込んだ指定の和となります。

この指定はWindows版のJP1/Baseだけで有効になり，UNIX版のJP1/Baseでは無効になります。

(6)　options　[conv-off]

イベント取得関数の利用を抑止します。このフラグを指定すると，JP1イベントのJP1/SES互換用イベント取得関数への受け渡しが抑止され，転送されてきたJP1イベントの受信，および転送の性能向上が見込まれます。ただし，このフラグを指定すると，JP1/SES互換用イベント取得関数はJP1イベントを取得できなくなります。また，JP1/AJSのJP1/AJS互換コマンドajsevgetも同様にJP1イベントを取得できなくなります。なお，JP1/SES互換用イベント取得関数，およびajsevgetコマンド以外は，このフラグの影響を受けません。このフラグ指定時のイベント受信可否を次の表に示します。

表J-1　フラグ指定時のイベント受信可否

受信イベント
受信機能
イベントの受信（検知）

JP1イベント
JP1/SES互換用イベント取得関数
ajsevgetコマンド
検知されない

JP1/SESイベント
JP1/SES互換用イベント取得関数
ajsevgetコマンド
検知される

付録J.3　JP1/SESイベントを使用する場合の注意事項

JP1/SESイベントを使用する製品と連携する場合の注意事項を次に示します。

＜この項の構成＞

(1)　擬似オペレーター数の制限

(2)　V5互換機能を使用できないOS

(1)　擬似オペレーター数の制限

同時に接続できる擬似オペレーターの最大数に制限があります。擬似オペレーターとは，JP1/SESイベントを取得するプログラムのことを指します。

WindowsのV5互換機能に接続できる擬似オペレーター数は最大52です。そのうち20は，JP1/AJSのajsevgetコマンド専用です。同時に起動するajsevgetコマンド数が20を超えないようにしてください。残り32は，JP1/OJE Client for VOS3/Mainframe/VOS1/VOSKのカスタムジョブ用として用意されています。同時に実行するカスタムジョブ数が32を超えないようにしてください。

UNIXのV5互換機能に接続できる擬似オペレーター数は最大32です。擬似オペレーター数が32を超えないようにしてください。擬似オペレーターとなるプログラムの詳細については，インストールされている日立製品の各マニュアルを参照してください。

(2)　V5互換機能を使用できないOS

V5互換機能の一部または全部の使用が制限されているOSを次の表に示します。

表J-2　V5互換機能が制限されているOS

OS | 制限内容
Windows Server 2008 | JP1/SESプロトコルによるイベント送受信は使用できますが，ajsevputコマンドおよびajsevgetコマンドなど，JP1/SESのインターフェースを使用したイベント登録および受信はできません。
Solaris非大域ゾーン | すべてのV5互換機能を使用できません。

付録J.4　JP1/SESイベントをJP1イベントに変換する

JP1/SESイベントには基本属性（イベントIDやメッセージなど）だけがあり，拡張属性（重大度，ユーザー名，プロダクト名，オブジェクトタイプなど）がありません。

イベントをJP1/IMの［イベントコンソール］画面に表示するには，イベントに拡張属性が設定されている必要があります。そのため，拡張属性マッピング設定ファイルを使用してJP1/SESイベントに重大度などの拡張属性を付加します。このように，JP1/SESイベントに拡張属性を付加してJP1イベントに変換することを，JP1/SESイベントの変換といいます。

JP1/SESイベントの変換の概要を次の図に示します。

図J-1　JP1/SESイベントの変換

＜この項の構成＞

(1)　JP1/SESイベントを変換する手順

(1)　JP1/SESイベントを変換する手順

JP1/SESイベントに拡張属性を付加してJP1イベントに変換するための作業手順を次に示します。なお，必要であれば，拡張属性とともにメッセージも付加できます。

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

対象イベント，付加する拡張属性，メッセージを決める

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

拡張属性マッピング設定ファイル

イベントサービス（JP1/Base）を再起動する
JP1/IMが起動している場合は，JP1/IMを終了させてからJP1/Baseを再起動してください。このあと，必要であればJP1/IMを起動してください。

(a)　対象イベント，付加する拡張属性，メッセージを決める

まず，どのJP1/SESイベントをJP1イベントに変換するのかを決めます。対象イベントは，イベントIDや発行元サーバ名などでフィルタリングできます。そのため，特定のイベントIDを持つJP1/SESイベントや，特定のサーバから発行されたJP1/SESイベントだけをJP1イベントに変換できます。

次に，JP1/SESイベントに付加する拡張属性およびメッセージを決めます。JP1/IMでイベント監視をするためには，そのイベントに少なくとも拡張属性「SEVERITY」を付加しなければなりません。それ以外の拡張属性やメッセージは，JP1/IMでイベント監視をするために有用なものを付加します。拡張属性を設定する際の指針としては，マニュアル「JP1/Base 関数リファレンス」を参照してください。

(b)　定義ファイルを作成する

JP1/SESイベントに拡張属性およびメッセージを付加するためには，拡張属性マッピング設定ファイルを作成します。次に，拡張属性マッピング設定ファイルの作成方法について説明します。

●定義する内容

拡張属性マッピング設定ファイルには，対象となるJP1/SESイベントを絞り込むためのイベントフィルター，およびJP1/SESイベントに付加する拡張属性とメッセージを定義します。

●格納場所

拡張属性マッピング設定ファイルは，JP1/Baseがインストールされたマシン上の次のディレクトリに作成します。

Windowsの場合

イベントサーバインデックスで指定されたディレクトリ¥sesmap¥

デフォルトのイベントサーバインデックスでは次のようになります。

Baseパス¥conf¥event¥servers¥default¥sesmap¥

UNIXの場合

イベントサーバインデックスで指定されたディレクトリ/sesmap/

デフォルトのイベントサーバインデックスでは次のようになります。

/etc/opt/jp1base/conf/event/servers/default/sesmap/

sesmapディレクトリは，標準インストールの状態では存在しません。まずsesmapディレクトリを作成し，その直下に，次の形式のファイル名を持つテキストファイルを作成してください。

会社名_製品名_map.conf

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

なお，拡張属性マッピング設定ファイルは複数作成することもできます。sesmapディレクトリの直下に異なる名称の複数の拡張属性マッピング設定ファイルを作成すれば，それらのファイルの定義に基づいて，該当するJP1/SESイベントが変換されます。複数の拡張属性マッピング設定ファイルを作成した場合，それらの定義は，ファイル名の昇順に解析されます。

注意事項

sesmapディレクトリには，定義ファイル以外のファイルは格納しないでください。

バックアップファイルやモデルファイルを格納している場合，それらのファイルにより変換が行われることがあります。

●形式

拡張属性マッピング設定ファイルは，マッピング設定ブロックの集合体です。マッピング設定ブロックの形式を次に示します。

[コメント]
map
[フィルターブロック]
[メッセージ指定]
[拡張属性指定1]
[拡張属性指定2]
      ：
[拡張属性指定n]
end-map
[コメント]

コメントは，「#」で開始する改行を含まない行です。コメントは，マッピング設定ブロックとマッピング設定ブロックの間に記述できますが，マッピング設定ブロックの内部には記述できません。

「map」および「end-map」は，それぞれ，マッピング設定ブロックの開始および終了を宣言します。

マッピング設定ブロックを構成するほかの要素について，次に説明します。

・フィルターブロック

フィルターブロックには，JP1イベントに変換するJP1/SESイベントを絞り込むためのフィルターを設定します。フィルターブロックの形式を次に示します。

filter
イベントフィルター
end-filter

フィルターブロックを省略した場合は，すべてのJP1/SESイベントが変換の対象となります。イベントフィルターの指定形式に関しては，「14.　定義ファイル」の「イベントフィルターの文法」を参照してください。

・メッセージ指定

JP1/SESイベントのイベント情報にメッセージを付加する場合に指定します。形式を次に示します。

B.MESSAGE区切り文字 メッセージ文字列

「B.MESSAGE」に続く区切り文字の後ろからその行末の改行までの間に存在する文字列が，メッセージとして付加されます。指定を省略した場合，メッセージは付加されません。

イベント情報に最初からメッセージがある場合は，このパラメーターで指定されたメッセージ文字列に置き換えられます。ただし，このメッセージ文字列を付加することによって，元から設定してある詳細情報との合計サイズが1,024バイトを超える場合には，メッセージは付加されません。

・拡張属性指定

イベント情報に拡張属性を付加する場合に指定します。形式を次に示します。

E.拡張属性名 区切り文字 拡張属性値

「E.」に続けて，付加する拡張属性の名称を指定します。区切り文字の後ろから行末の改行までの間にある文字列が，拡張属性の値として扱われます。拡張属性値を空（NULL文字列）にした指定はできません。また，改行を含む値も指定できません。

一つのJP1/SESイベントに複数の拡張属性を付加する場合は，この指定を複数回繰り返します。ただし，一つのマッピング設定ブロックで，同一名称を持つ拡張属性は指定できません。また，一つのJP1/SESイベントに付加できる拡張属性の数は最大100個で，すべての拡張属性値の合計サイズは10,000バイトに制限されます。これらの制限に反した場合は，そのマッピング設定ブロック全体が無視されます。

●注意事項

拡張属性マッピング設定ファイルでは，1レコードが最大1,024バイトに制限されます。

フィルターブロック，メッセージ指定，拡張属性指定はそれぞれ省略できますが，指定する場合はこの順番に指定してください。誤った順番で指定した場合，または拡張属性指定以外のブロックを2回以上指定した場合は，そのマッピング設定ブロック全体が無効になります。

フィルターブロックで定義するフィルターに日本語文字列を指定した場合，その文字コードとJP1/SES形式で登録されたイベントの文字コードが異なると，そのイベントは変換されません。

拡張属性マッピング設定ファイルでは，除外条件はサポートされていません。フィルターブロックで定義するフィルターに除外条件を指定しないでください。

●定義例

・単一のマッピング設定

ここでは，「raysol」という名前のホストで稼働しているJP1/SESから自ホストに転送されたJP1/SESイベントのうち，イベントIDが111のものを対象にして，拡張属性「SEVERITY」を「Information」に設定し，「Informational Message」というメッセージを付加する例を示します。

テキストエディターを使って，「company_sample_map.conf」という名前の拡張属性マッピング設定ファイルを作成します。この拡張属性マッピング設定ファイルでの定義を次に示します。

図J-2　拡張属性マッピング設定ファイルの定義例（単一のマッピング）

・複数のマッピング設定

一つの拡張属性マッピング設定ファイルに，複数のマッピング定義を記述することもできます。

例えば，「単一のマッピング設定」で設定した定義に，イベントIDが222のJP1/SESイベントの重大度を「Warning」にするという設定を追加できます。その場合の定義は次のようになります。

図J-3　拡張属性マッピング設定ファイルの定義例（複数のマッピング）

なお，一つの拡張属性マッピング設定ファイルに複数のマッピングを定義した場合には，ファイル内で上位に定義されたものから順に解析されます。

付録K　操作ログの出力

JP1/Baseの操作ログとは，認証サーバに対する不正な操作などセキュリティ上の問題発生時の原因究明や，システムを安全に運用するための情報収集を目的として，認証サーバに対して「いつ」「だれが」「何を行ったか」などの操作情報の履歴を出力するログ情報です。

JP1/Baseの操作ログには，対象資源であるJP1ユーザーアカウント情報または操作権限情報が登録・変更・削除された場合に，変更情報が出力されます。例えば，JP1ユーザーのパスワードを変更した場合，いつ，どのOSユーザーによって，どのJP1ユーザーのパスワードを変更したかの情報が操作ログに出力されます。また，認証サーバの起動または停止の情報も出力されます。

操作ログは，08-10以降のJP1/Baseであれば，出力できます。ただし，デフォルトでは出力されません。

操作ログは，CSV形式で出力されるテキストファイルです。定期的に保存して表計算ソフトで加工すると，分析資料として利用できます。

なお，出力された操作ログはJP1/NETM/Audit - Managerを使用して収集すると，一元管理できます。JP1/NETM/Audit - Managerで操作ログを収集する方法については，マニュアル「JP1/NETM/Audit構築・運用ガイド」を参照してください。

ここでは，操作ログの出力内容と操作ログを出力するための設定方法について説明します。

＜この節の構成＞

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

付録K.2　操作ログの保存形式

付録K.3　操作ログの出力形式

付録K.4　操作ログが出力される契機

付録K.5　操作ログを出力するための設定

付録K.6　操作ログに出力されるメッセージの一覧

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

操作ログに出力される事象の種別およびJP1/Baseが操作ログを出力する契機を次の表に示します。事象の種別とは，操作ログに出力される事象を分類するための，操作ログ内での識別子です。

表K-1　操作ログに出力される事象の種別

事象の種別
説明
JP1/Baseが出力する契機

StartStop
ソフトウェアの起動および終了を示す事象。
認証サーバの起動時または停止時

ConfigurationAccess
管理者が許可された運用操作を実行し，操作が成功または失敗したことを示す事象。

JP1ユーザーの登録・削除時

JP1ユーザーのパスワード変更

JP1ユーザーの操作権限の登録・変更・削除時

jbs_spmd_reloadコマンドの実行時

jbsaclreloadコマンドの実行時

付録K.2　操作ログの保存形式

操作ログの保存形式について説明します。操作ログは，操作ログファイル（base_log.log）に出力されます。操作ログファイル（base_log.log）は，シーケンシャルファイルです。一定の容量に達すると，ファイル名を変更して保存したあと，変更前と同じ名称のファイルを作成して新たにログを書き込みます。一定の容量に達して操作ログファイル（base_log.log）が切り替わる際，「base_log.log」を，「base_log1.log」に変更して保存し，新たに「base_log.log」を作成して，ログを書き込みます。再び「base_log.log」が一定量に達すると，保存済みの「base_log1.log」を「base_log2.log」に変更したあと，「base_log.log」を「base_log1.log」に変更して保存します。

このように，保存済みのログファイルは，新たにファイルが作成されるごとにファイル名末尾の数値+1をしたファイル名称に変更されます。つまり，数値が大きいログファイルほど古いログファイルとなります。なお，一定の保存面数を超えると，古いログファイルから削除されます。

ファイルの切り替え時期，出力先および保存面数は操作ログ定義ファイル（jp1bs_baselog_setup.conf）で変更できます。ログファイルサイズの初期値は1,024キロバイトです。保存面数の初期値は4面です。操作ログ定義ファイルの設定方法については，「付録K.5　操作ログを出力するための設定」を参照してください。

付録K.3　操作ログの出力形式

操作ログは，操作対象のJP1ユーザーおよびJP1資源グループ単位にレコードが出力されます。例えば，JP1ユーザーに登録されている二つのJP1資源グループ（jp1group1，jp1group2）のJP1権限レベルを変更した場合，「JP1資源グループ(jp1group1)の変更」と「JP1資源グループ(jp1group2)の変更」という二つのレコードが出力されます。

また，ユーザー権限レベルファイル（JP1_UserLevel）でJP1資源グループやJP1権限レベルの内容を変更し，jbsaclreloadコマンドまたはjbs_spmd_reloadコマンドを実行した場合，認証サーバ上の操作権限情報とユーザー権限レベルファイル（JP1_UserLevel）の内容を比較し，変更した定義に関する情報だけが操作ログに出力されます。

操作ログ出力の出力形式，出力先，出力項目について説明します。

＜この項の構成＞

(1)　出力形式

(2)　出力先

(3)　出力項目

(4)　出力例

(1)　出力形式

CALFHM x.x,出力項目1=値1,出力項目2=値2,…,出力項目n=値n

(2)　出力先

Windowsの場合

インストール先フォルダ¥log¥BASE¥base_log[n※].log

UNIXの場合

/var/opt/jp1base/log/BASE/base_log[n※].log

注※

nは1～16の10進数です。

(3)　出力項目

出力項目は二つの分類があります。

共通出力項目
操作ログを出力するJP1製品が共通して出力する項目です。

固有出力項目
操作ログを出力するJP1製品が任意に出力する項目です。

(a)　共通出力項目

共通出力項目に出力される値と項目の内容を次の表に示します。

表K-2　操作ログの共通出力項目

項番
出力項目
値
内容

項目名
出力される属性名

1
共通仕様識別子
－
CALFHM
ログフォーマット識別子

2
共通仕様リビジョン番号
－
x.x
ログフォーマットを管理するためのリビジョン番号

3
通番
seqnum
通し番号
操作ログレコードの通し番号（プロセスごとに採番される）

4
メッセージID
msgid
KAJP6xxx-x
製品のメッセージID

5
日付・時刻
date
yyyy-mm-ddThh:mm:ss.sssTZD※1
操作ログの出力日時およびタイムゾーン

6
発生プログラム名
progid
JP1Base
事象が発生したプログラムのプログラム名

7
発生コンポーネント名
compid
User_management
事象が発生したコンポーネント名

8
発生プロセスID
pid
認証サーバのプロセスID
事象が発生したプロセスのプロセスID

9
発生場所（ホスト名）
ocp:host
認証サーバのホスト名※4
事象が発生したホストのホスト名

10
事象の種別
ctgry

StartStop

ConfigurationAccess

操作ログに出力される事象を分類するためのカテゴリー名

11
事象の結果
result

Success（成功）

Failure（失敗）

事象の結果

12
サブジェクト識別情報
subj:euid

OSユーザー名※4

Unknown※2

Not Support※3

事象を発生させたOSユーザー名

（凡例）

－：出力される属性名はありません。

注※1　Tは日付と時刻の区切りです。ZDはタイムゾーン指定子です。次のどれかが出力されます。

+hh:mm：UTCからhh:mmだけ進んでいることを示す。

-hh:mm：UTCからhh:mmだけ遅れていることを示す。

Z：UTCと同じであることを示す。

注※2　Unknownは，jbs_spmd_reloadコマンド実行時に出力されるメッセージ（KAJP6016-I～KAJP6020-I）の場合に出力されます。このコマンドを実行したOSユーザー名は，直後に出力されるKAJP6022-I～KAJP6023-Wのサブジェクト種別情報に出力されます。

注※3　Not Supportは，08-00以前のJP1/Baseで，ユーザー認証機能のコマンドを実行した場合に出力されます。どのOSユーザーによって実行されたか知りたい場合には，JP1/Baseのバージョンを08-10以上にしてください。

注※4　値を取得できなかった場合は，Noneが出力されます。

(b)　固有出力項目

固有出力項目に出力される値と項目の内容を次の表に示します。

表K-3　操作ログの固有出力項目

項番
出力項目
値
内容

項目名
出力される属性名

1
オブジェクト情報
obj

JP1user

Permission

Process

Password

操作の対象

2
操作情報
op

Add

Apply

Update

Delete

Start

Stop

操作内容

3
オブジェクトロケーション情報：認証サーバ名
objloc:authsv
認証サーバ名※1
操作対象の資源がある認証サーバ名を出力する

4
オブジェクトロケーション情報：JP1ユーザー名
objloc:user
JP1ユーザー名※1
操作対象の資源のJP1ユーザー名を出力する

5
変更前情報：JP1資源グループ名
before:rsrcgrp
JP1資源グループ名※1
変更前の情報として，削除された情報を出力する

6
変更後情報：JP1資源グループ名
after:rsrcgrp
JP1資源グループ名※1
変更後の情報を出力する

7
変更後情報：JP1権限レベル名
after:prmssn
JP1権限レベル名※1
変更後の情報を出力する

8
権限情報
auth

Windows
Administrator

UNIX
SuperUser

操作したOSユーザーが持つ権限

9
リクエスト送信元ホスト
from:ipv4
コマンド実行ホストのIPアドレス※1※2
コマンド実行ホストのIPアドレス

10
自由記述
msg
メッセージ※2の詳細については「付録K.6　操作ログに出力されるメッセージの一覧」を参照。
事象の内容を示すメッセージ

注※1　この値は，操作ログによって出力の有無が異なります。表K-4を参照してください。

注※2　値を取得できなかった場合は，Noneが出力されます。

操作ログに出力される固有出力項目のうち，出力の有無が異なる項目について，メッセージIDごとに次の表に示します。

表K-4　メッセージIDと固有出力項目の出力有無

メッセージID | オブジェクトロケーション情報：認証サーバ名 | オブジェクトロケーション情報：JP1ユーザー名 | 変更前情報：JP1資源グループ名 | 変更後情報：JP1資源グループ名 | 変更後情報：JP1権限レベル名 | リクエスト送信元ホスト
KAJP6000-I | ○ | ○ | × | × | × | ○
KAJP6001-W | ○ | ○ | × | × | × | ○
KAJP6002-I | ○ | ○ | × | × | × | ○
KAJP6003-W | ○ | ○ | × | × | × | ○
KAJP6004-I | ○ | ○ | × | × | × | ○
KAJP6005-W | ○ | ○ | × | × | × | ○
KAJP6006-I | ○ | ○ | × | ○ | ○ | ○
KAJP6007-W | ○ | × | × | × | × | ○
KAJP6008-I | ○ | ○ | × | ○ | ○ | ○
KAJP6010-I | ○ | ○ | ○ | × | × | ○
KAJP6011-W | ○ | ○ | × | × | × | ○
KAJP6012-I | ○ | × | × | × | × | ×
KAJP6013-E | ○ | × | × | × | × | ×
KAJP6014-I | ○ | × | × | × | × | ×
KAJP6015-E | ○ | × | × | × | × | ×
KAJP6016-I | ○ | ○ | × | ○ | ○ | ○
KAJP6017-W | ○ | × | × | × | × | ○
KAJP6018-I | ○ | ○ | × | ○ | ○ | ○
KAJP6020-I | ○ | ○ | ○ | × | × | ○
KAJP6022-I | × | × | × | × | × | ×
KAJP6023-W | × | × | × | × | × | ×

（凡例）

○：出力される。

×：出力されない。

(4)　出力例

操作ログの出力例を次に示します。

jbsadduserコマンドでJP1ユーザー「jp1user1」を登録した場合，認証サーバ「server1」の操作ログに出力される内容

CALFHM 1.0,seqnum=59,msgid=KAJP6000-I,date=2006-09-10T11:05:23.480+09:00,
progid=JP1Base,compid=User_management, pid=4028,
ocp:host=hostA,ctgry=ConfigurationAccess,result=Success,
subj:euid=Administrator,obj=JP1user,op=Add,objloc:authsv=server1,
objloc:user=jp1user1,auth=Administrator,from:ipv4=206.aa.bb.ccc,
msg=JP1ユーザーの登録に成功しました

付録K.4　操作ログが出力される契機

操作ログが出力される契機およびメッセージIDの一覧を示します。各メッセージIDが出力するメッセージ本文を知りたい場合は，「付録K.6　操作ログに出力されるメッセージの一覧」を参照してください。

表K-5　操作ログが出力される契機およびメッセージID

契機
メッセージID

操作
結果
失敗ログが出力される事象

JP1ユーザーの登録時
登録成功
－
KAJP6000-I

登録失敗
登録済みのJP1ユーザーを登録しようとした
KAJP6001-W

JP1ユーザーのパスワードの変更時※1
変更成功
－
KAJP6002-I

変更失敗

変更しようとしたJP1ユーザーが存在しない

旧パスワードが誤っている

KAJP6003-W

JP1ユーザーの削除時
削除成功
－
KAJP6004-I

削除失敗
削除しようとしたJP1ユーザーが存在しない
KAJP6005-W

JP1資源グループの登録時
登録成功
－
KAJP6006-I

JP1資源グループの変更時
変更成功
－
KAJP6008-I

JP1資源グループの削除時
削除成功
－
KAJP6010-I

削除失敗
削除しようとしたJP1ユーザーが存在しない
KAJP6011-W

認証サーバの起動時
起動成功
－
KAJP6012-I

起動失敗
認証サーバの起動に失敗した
KAJP6013-E

認証サーバの停止
停止成功
－
KAJP6014-I

停止失敗
認証サーバの停止に失敗した
KAJP6015-E

JP1/Baseのプロセスの再読み込み時（jbs_spmd_reloadコマンド実行時）※2
登録成功
－
KAJP6016-I

更新失敗
更新処理が途中で失敗した
KAJP6017-W

変更成功
－
KAJP6018-I

削除成功
－
KAJP6020-I

コマンド成功
－
KAJP6022-I

コマンド失敗
jbs_spmd_reloadコマンドが失敗した
KAJP6023-W

ユーザー権限レベルの再読み込み時（jbsaclreloadコマンド実行時）※3
登録成功
－
KAJP6006-I

変更成功
－
KAJP6008-I

削除成功
－
KAJP6010-I

更新失敗
更新処理が途中で失敗した
KAJP6007-W

（凡例）

－：出力される失敗ログはありません。

注※1　連携ユーザーのパスワードを変更しようとしたとき，操作ログは出力されません。連携ユーザーのパスワードは連携先のディレクトリサーバで管理するため，認証サーバ上で変更できません。jbschgpasswdコマンドを実行するとKAVA5209-Eメッセージが出力されます。

注※2　jbs_spmd_reloadコマンドは，JP1/Baseのプロセスを再読み込みするコマンドです。このコマンドを実行すると，ユーザー権限レベルファイル（JP1_UserLevel）に定義された操作権限の情報が読み込まれます。認証サーバ上の操作権限情報から変更のあったJP1ユーザー情報だけが，操作ログに出力されます。

注※3　jbsaclreloadコマンドは，ユーザー権限レベルファイル（JP1_UserLevel）に定義された操作権限の情報を読み込むコマンドです。認証サーバ上の操作権限情報から変更のあったJP1ユーザー情報だけが，操作ログに出力されます。

付録K.5　操作ログを出力するための設定

操作ログを出力するための設定は，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で行います。操作ログを出力するために設定する内容とその手順について次に示します。

＜この項の構成＞

(1)　設定手順

(2)　操作ログ定義ファイル（jp1bs_baselog_setup.conf）の詳細

(1)　設定手順

操作ログを出力するための設定手順を次に示します。

(a)　物理ホストの場合

1.　操作ログ定義ファイル（jp1bs_baselog_setup.conf）を編集する。

1-1　ENABLEパラメーターを設定する。

操作ログ定義ファイル（jp1bs_baselog_setup.conf）をエディターで開き，ENABLEパラメーターを次のように変更します。

変更前（デフォルトの設定）
"ENABLE"=dword:00000000

変更後
"ENABLE"=dword:00000001

1-2　操作ログの出力先をデフォルト以外に設定する場合，LOGFILEDIRパラメーターを設定する。

LOGFILEDIRパラメーターを次のように変更します。

Windowsの場合

変更前（デフォルトの設定）
"LOGFILEDIR"="インストール先フォルダ¥log¥BASE"

変更後
"LOGFILEDIR"="任意の出力先"

UNIXの場合

変更前（デフォルトの設定）
"LOGFILEDIR"="/var/opt/jp1base/log/BASE"

変更後
"LOGFILEDIR"="任意の出力先"

2.　jbssetcnfコマンドを実行する。

設定内容が共通定義情報に反映されます。

3.　設定を有効にする。

JP1/Baseを再起動するか，jbs_spmd_reloadコマンドを実行すると設定が有効になります。

(b)　論理ホストの場合

1.　共有ディスク上の操作ログ定義ファイル（jp1bs_baselog_setup.conf）を編集する。

1-1　[JP1_DEFAULT¥JP1BASE¥BASE_LOG]パラメーターを設定する。

操作ログ定義ファイル（jp1bs_baselog_setup.conf）をエディターで開き，[JP1_DEFAULT¥JP1BASE¥BASE_LOG]パラメーターを次のように設定します。

変更前（デフォルトの設定）
[JP1_DEFAULT¥JP1BASE¥BASE_LOG]

変更後
[論理ホスト名¥JP1BASE¥BASE_LOG]

1-2　ENABLEパラメーターを設定する。

ENABLEパラメーターを次のように設定します。

変更前（デフォルトの設定）
"ENABLE"=dword:00000000

変更後
"ENABLE"=dword:00000001

1-3　操作ログの出力先を設定する。

LOGFILEDIRパラメーターを次のように設定します。論理ホスト側の操作ログは，共有ディスク上に出力するように指定することをお勧めします。

Windowsの場合

変更前（デフォルトの設定）
"LOGFILEDIR"="インストール先フォルダ¥log¥BASE"

変更後
"LOGFILEDIR"="共有フォルダ¥jp1base¥log¥BASE"

UNIXの場合

変更前（デフォルトの設定）
"LOGFILEDIR"="/var/opt/jp1base/log/BASE"

変更後
"LOGFILEDIR"="共有ディレクトリ/jp1base/log/BASE"

2.　実行系でjbssetcnfコマンドを実行する。

定義ファイルの設定内容が共通定義情報に反映されます。

3.　実行系の設定を待機系に反映する。

クラスタ運用の場合，共通定義情報を各サーバ上で一致させる必要があります。詳細については「3.6(1)　共通定義情報を変更した場合」を参照してください。

4.　設定を有効にする。

クラスタソフトからJP1/Baseを再起動するか，jbs_spmd_reloadコマンドを実行すると設定が有効になります。

(2)　操作ログ定義ファイル（jp1bs_baselog_setup.conf）の詳細

操作ログ定義ファイル（jp1bs_baselog_setup.conf）の詳細について説明します。

(a)　格納先ディレクトリ

操作ログ定義ファイル（jp1bs_baselog_setup.conf）の格納先ディレクトリを次に示します。

Windowsの場合

インストール先フォルダ¥conf¥

共有フォルダ¥jp1base¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/

共有ディレクトリ/jp1base/conf/

(b)　形式

操作ログ定義ファイル（jp1bs_baselog_setup.conf）には，操作ログの出力の有無，操作ログファイル（base_log.log）の出力先，サイズ，保存面数および自動的にファイルを切り替えるための設定を次の形式で定義します。

"項目名"=値

(c)　記述内容

操作ログ定義ファイル（jp1bs_baselog_setup.conf）に記述する内容を次に示します。なお，操作ログファイル（base_log.log）の出力先以外は，すべて16進数で指定します。（　）内の数値は，10進数です。

ENABLE

操作ログの出力を有効にするか無効にするかを指定します。下記以外の値を指定した場合，初期値を仮定します。

初期値：00000000

操作ログの出力を無効にする場合：00000000

操作ログの出力を有効にする場合：00000001

LOGFILEDIR

操作ログファイル（base_log.log）の出力先を指定します。論理ホスト側の操作ログは，共有ディスク上に出力するように指定することをお勧めします。

初期値
Windowsの場合：インストール先フォルダ¥log¥BASE
UNIXの場合：/var/opt/jp1base/log/BASE

論理ホストの場合の出力先例
Windowsの場合：共有フォルダ¥log¥BASE
UNIXの場合：共有ディレクトリ/jp1base/log/BASE

LOGSIZE

操作ログファイル（base_log.log）のサイズをバイトで指定します。下記の指定できる範囲の下限値よりも小さい値を指定した場合は，下限値を仮定し，上限値よりも大きい値を指定した場合には，上限値を仮定します。

初期値：00100000（1,024KB）

指定できる範囲：00002000～00400000（8KB～4,096KB）

LOGFILENUM

操作ログファイル（base_log.log）の保存する面数を指定します。下記の指定できる範囲の下限値よりも小さい値が設定された場合には，下限値を仮定し，上限値よりも大きい値が設定された場合には，上限値を仮定します。

初期値：00000004（4面）

指定できる範囲：00000001～00000010（1～16面）

LOGCHANGEOPT

JP1/Baseが起動した時点で，自動的にファイルを切り替えるかどうかを指定します。下記以外の値を指定した場合，初期値を仮定します。

初期値：00000000

起動時に切り替えない場合：00000000

起動時に切り替える場合：00000001

(d)　操作ログ定義ファイルの定義例

操作ログを出力する場合の定義例を示します。例えば，ENABLEの値を「00000001」に変更すると，1メガバイトの操作ログが出力され4面まで保存できます。

[JP1_DEFAULT¥JP1BASE¥BASE_LOG]
"ENABLE"=dword:00000001
"LOGFILEDIR"="/var/opt/jp1base/log/BASE"
"LOGSIZE"=dword:00100000
"LOGFILENUM"=dword:00000004
"LOGCHANGEOPT"=dword:00000000

付録K.6　操作ログに出力されるメッセージの一覧

ここでは，操作ログに出力されるメッセージIDおよびメッセージ本文を示します。

KAJP6000-I

JP1ユーザーの登録に成功しました

The JP1 user was registered successfully.

KAJP6001-W

JP1ユーザーの登録に失敗しました

An attempt to register the JP1 user has failed.

KAJP6002-I

JP1ユーザーのパスワードの変更に成功しました

The password for the JP1 user was changed successfully.

KAJP6003-W

JP1ユーザーのパスワードの変更に失敗しました

An attempt to change the password for the JP1 user has failed.

KAJP6004-I

JP1ユーザーの削除に成功しました

The JP1 user was deleted successfully.

KAJP6005-W

JP1ユーザーの削除に失敗しました

An attempt to delete the JP1 user has failed.

KAJP6006-I

JP1資源グループの登録に成功しました

The JP1 resource group was registered successfully.

KAJP6007-W

JP1ユーザーの操作権限に関する定義情報の再読み込みに失敗しました

An attempt to reload the definition information about the JP1 user operating permissions has failed.

KAJP6008-I

JP1資源グループの変更に成功しました

The JP1 resource group was changed successfully.

KAJP6010-I

JP1資源グループの削除に成功しました

The JP1 resource group was deleted successfully.

KAJP6011-W

JP1資源グループの削除に失敗しました

An attempt to delete the JP1 resource group has failed.

KAJP6012-I

認証サーバの起動に成功しました

The authentication server was started successfully.

KAJP6013-E

認証サーバの起動に失敗しました

An attempt to start the authentication server has failed.

KAJP6014-I

認証サーバの停止に成功しました

The authentication server was stopped successfully.

KAJP6015-E

認証サーバの停止に失敗しました

An attempt to stop the authentication server has failed.

KAJP6016-I

JP1資源グループの登録に成功しました

The JP1 resource group was registered successfully.

KAJP6017-W

JP1ユーザーの操作権限に関する定義情報の再読み込みに失敗しました

An attempt to reload the definition information about the JP1 user operating permissions has failed.

KAJP6018-I

JP1資源グループの変更に成功しました

The JP1 resource group was changed successfully.

KAJP6020-I

JP1資源グループの削除に成功しました

The JP1 resource group was deleted successfully.

KAJP6022-I

jbs_spmd_reloadコマンドの実行に成功しました

The jbs_spmd_reload command was executed successfully.

KAJP6023-W

jbs_spmd_reloadコマンドの実行に失敗しました

An attempt to execute the jbs_spmd_reload command has failed.

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

各バージョンの変更内容を示します。

＜この節の構成＞

付録L.1　09-10の変更内容

付録L.2　09-00の変更内容

付録L.3　08-50の変更内容

付録L.4　08-11の変更内容

付録L.5　08-10の変更内容

付録L.6　08-00の変更内容

付録L.7　07-51の変更内容

付録L.8　07-50の変更内容

付録L.9　07-11の変更内容

付録L.10　07-10の変更内容

付録L.11　07-00の変更内容

付録L.1　09-10の変更内容

イベントログトラップ機能で，Windows VistaおよびWindows Server 2008で追加されたイベント種別に対応しました。

ログファイルトラップ起動定義ファイルを使用してログファイルトラップを起動できるようにしました。

ログファイルトラップで監視できないログファイルの説明に，毎回先頭からログ情報が記録されるファイルを追加しました。

ヘルスチェック機能で他ホストを監視する場合に，監視対象ホストの起動・停止を監視するかどうかを選択できるようにしました。これに伴い，次のとおり定義ファイルの記述内容を変更しました。

ヘルスチェック定義ファイルにSTOP_CHECKパラメーターを追加しました。

イベントサーバ設定ファイルのoptionsパラメーターにauto-forward-offフラグを追加しました。

また，JP1イベント「0000474A」の発行契機を追加しました。

x64環境の場合に，インストール時，インストール先フォルダを設定する際の注意点を追記しました。

jbs_setup_cluster（Windows限定）コマンドの形式の誤りを訂正しました。

次のコマンドについて，コマンド使用時の注意事項を追加しました。
jbsrt_distribコマンド，jevexportコマンド

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

配布定義ファイルの記述内容で，@動作定義ファイル名の説明を変更しました。

次のJP1イベントを追加しました。
00004724，00004725，0000474C，0000474D

トラブル発生時に採取が必要な資料を追加しました。

JP1/Baseの起動中に使用できないコマンドにjbs_setup_cluster（Windowsの場合）を追加しました。

メッセージを追加，変更しました。

対応するコンパイラーにVisual C++(R) 2008を追加しました。

付録L.2　09-00の変更内容

ローカルアクション機能を追加しました。

IM構成管理に対応しました。

稼働情報を収集できるようにしました。

メッセージを追加・変更しました。

付録L.3　08-50の変更内容

Windows Server 2008上で動作するJP1/Baseをサポートしました。

次のコマンドの説明を変更しました。
コマンド一覧，cpysvprm，hntr2getname，jbs_log.bat，jbs_spmd_reload，jbs_spmd_status，jbs_spmd_stop，jbsacllint，jbsaclreload，jbsadduser，jbsblockadesrv，jbschgpasswd，jbsgetcnf，jbsgetumap，jbshostsexport，jbshostsimport，jbslistacl，jbslistsrv，jbslistuser，jbsmkpass，jbsmkumap，jbsrmacl，jbsrmumap，jbsrmumappass，jbsrmuser，jbssetacl，jbssetcnf，jbssetumap，jbsumappass，jbsunblockadesrv，jbsunsetcnf，jcocmdconv，jevdbinit，jevdbswitch，jevdef_distrib，jevdef_get，jeveltreload，jevlogreload，jevlogstart，jevlogstat，jevlogstop，jevregsvc，jevreload，jevstat，Jischk，Jiscond，Jisconv，Jiscpy，Jisext，Jisinfo，Jiskeymnt，Jisktod，Jislckclear，Jislckext，Jislckfree，Jismlcktr，Jisprt

メッセージ（KAJP1037-E）の出力を抑止できるようにしました。

API設定ファイルにclientパラメーターを追加しました。

イベントフィルターに除外条件を指定できるようにしました。

次のログファイルトラップ用コマンドに監視名を指定できるようにしました。
jevlogreload，jevlogstart，jevlogstat，jevlogstop

資料採取コマンドの操作性を向上させるため，-qオプションを追加しました。

JP1/Integrated Management用JP1イベント（00003A10）の説明を変更しました。

メッセージを追加・変更しました。

ユーザーアプリケーションをC言語で記述できるようにしました。

付録L.4　08-11の変更内容

ディレクトリサーバと連携してログイン認証ができるようにしました（Windows限定）。

jbsadduserコマンド，およびjbslistuserコマンドに-dsオプションを追加しました（Windows限定）。

jbschgdsコマンド，およびjbschkdsコマンドを追加しました（Windows限定）。

Jisinfoコマンドに-eオプションを追加しました（UNIX限定）。

次のJP1/IM用コマンドの説明を追加しました。
jbsrt_del，jbsrt_distrib，jbsrt_get，jbsrt_sync，jcocmddef，jcocmddel，jcocmdlog，jcocmdshow

次のJP1/IM用JP1イベントの説明を追加しました。
00003FA0，00003FA1，00003FA2，00003FA3，00003FA5，00003FA6

統合トレースログの出力形式の説明を追加しました。

付録L.5　08-10の変更内容

Windows Vista上で動作するJP1/Baseをサポートしました。

イベントサーバ設定ファイル（conf）に，UNIX版のJP1/Baseで物理ホストのイベントサービスのプロセスが異常終了した場合に，再起動させるパラメーター（restart）を追加しました。

バックアップ対象ファイルの一覧表に操作ログ定義ファイルを追加しました。

jevlogstartコマンドのオプションで，JP1イベント登録メッセージ最大長を，1,024バイト（終了文字1バイトを含んだ値）まで指定できるようにしました。

SEQ2ファイルをWinodws上でも監視できるようにしました。

jbslistuserコマンドに，JP1ユーザーの最終更新日付を出力するオプションを追加しました。

障害が発生したISAMファイルのキーファイルから，有効なレコードをできる限り抽出し，順編成ファイルに回復するコマンド（Jisktod）を追加しました。

JP1イベント00003D04を追加しました。

操作ログを出力する機能を追加しました。

ファイル一覧を08-10に合わせて更新しました。

付録L.6　08-00の変更内容

SNMPトラップ変換機能で，サポートする$変数を拡張しました。また，イベント変換時に，新たにサポートした$変数の情報を展開するかどうかを指定するパラメーターを追加しました。

SNMPトラップ変換機能で，JP1イベント変換対象とするSNMPエージェントのホスト名を指定できるようにしました。

SNMPトラップ変換機能で，JP1イベント変換対象とするSNMPトラップのワイルドカード指定および変換対象外とするSNMPトラップを指定するパラメーターを追加しました。

Linux版のJP1/Baseが使用する文字コードとして，日本語UTF-8をサポートしました。

ファイル一覧を08-00に合わせて更新しました。

メッセージを追加，変更しました。

メモリー所要量，ディスク占有量の記述を削除しました。メモリー所要量およびディスク占有量については，リリースノートを参照してください。

jcocmddefコマンドの転送データ量を設定するオプション（-actlimit，-cmdlimit）のデフォルト値を「ON（抑止する）値:1,000行」に変更しました。

Jiscondコマンドの肥大化抑止を設定するオプション（-k）をデフォルトで有効にしました。

付録L.7　07-51の変更内容

イベントログトラップで，イベントログと動作定義ファイルの内容の比較レベルを指定するパラメーター（matching-level）を追加しました。

イベントログトラップ動作定義ファイル（ntevent.conf）に，フィルターに不正な指定がある場合のチェックレベルを指定するパラメーター（filter-check-level）を追加しました。

プロセス管理機能のプロセスにjcocmdcomを追加しました。

イベントサーバ設定ファイル（conf）のerror-sizeパラメーターに指定する，イベントサービスエラーログファイルの容量の計算式を変更しました。

付録L.8　07-50の変更内容

jevexportコマンドに基本属性および拡張属性のタイトル名を出力するオプションを追加しました。

ログファイルトラップで，監視できるログファイルの形式にマルチプロセス対応トレースファイル（HTRACE）を追加しました。

jbsrmaclコマンドに，操作権限の削除前に削除確認をするオプションを追加しました。

jbsrmumapコマンドに，ユーザーマッピング情報の削除前に削除確認をするオプションを追加しました。

ISAMのファイル・レコード占有状態を確認および解除するコマンド（Jislckclear）を追加しました。

「SESエミュレータ用のポートIDが定義されていません」のメッセージが出力された場合の対処方法を追加しました。

メッセージを追加，変更，削除しました。

付録L.9　07-11の変更内容

JP1/Baseのプロセスのハングアップや異常終了を検知できる機能（ヘルスチェック機能）を追加しました。

バックアップ対象ファイルの一覧表を更新しました。

イベントDBの破壊を検知した場合にJP1イベントを発行するようにしました。

ログファイルトラップで，ログファイルの監視に失敗した場合にJP1イベントを発行し，監視をリトライする機能を追加しました。

イベントログトラップで，イベントログの監視間隔を指定できるようにしました。

イベントDBをcsv形式で出力するコマンド（jevexport）に，出力対象のファイル名を指定するオプションを追加しました。

イベントDBを初期化するコマンド（jevdbinit）と，イベントDBを手動で切り替えるコマンド（jevdbswitch）を追加しました。

イベントサービスのプロセス群の動作状況を確認するコマンド（jevstat）に，実行終了を待つ時間を指定するオプションを追加しました。

jcocmddefコマンドに転送データ量を設定するオプション（-actlimit，-cmdlimit），コマンド先行入力数の閾値を設定するオプション（-queuethreshold）を追加しました。

JP1イベントを追加しました。
00003A20，00003A21，00003A22，00003FA5，00003FA6，00004740，00004741，00004742，00004743，00004747，00004748，00004749，0000474A，0000474B

ファイル一覧を07-11に合わせて更新しました。

制限値一覧を07-11に合わせて更新しました。

メモリー所要量，ディスク占有量を07-11に合わせて更新しました。

メッセージを追加，変更しました。

付録L.10　07-10の変更内容

サービス起動時のマシンへの負荷を軽減させるために，起動管理機能で制御するサービスが起動するタイミングを設定できるようになりました。

ログファイルトラップ動作定義ファイルで指定するACTDEFパラメーターに，{EXIT}オプションを追加しました。

ログファイルトラップがイベントサービスの接続に失敗した際に，接続をリトライする機能を追加しました。

SNMPトラップ変換機能で，SNMPトラップの重要度に対するJP1の重大度を指定できるようになりました。

資料採取ツール（jbs_log.bat，jbs_log.sh）をカスタマイズしないで，資料を採取できるようになりました。

ログファイルトラップの停止コマンド（jevlogstop）に，最終のログまで監視できるオプションを追加しました。

jcocmddefコマンドにコマンド実行履歴の抑止を設定するオプション（-actresult），経過時間イベント発行間隔を設定するオプション（-runevinterval）を追加しました。

コマンド実行の状態確認コマンド（jcocmdshow），削除コマンド（jcocmddel）を追加しました。

JP1イベント（00003A10，00003FA3）を追加しました。

メッセージを追加しました。

一部の英文メッセージを変更しました。

メッセージを削除しました。

コマンド実行に関するメッセージを記載しました。

構成管理に関するメッセージを記載しました。

付録L.11　07-00の変更内容

JP1/Baseのプロセス停止時に再起動する機能をサポートしました。

プロセスの異常終了時や認証サーバの切り替え発生時にJP1イベントを発行する機能を追加しました。

JP1ユーザー，JP1ユーザーの操作権限，ユーザーマッピング情報を個別に登録，変更および削除するコマンドを追加しました。

Windowsで，コマンドを使ったJP1ユーザーの設定する機能を追加しました。

SNMPトラップ変換機能で，バリアブルバインディングをJP1イベントの拡張属性の固有情報として付加できる機能を追加しました。

ログファイルトラップ動作定義ファイルおよびイベントログトラップ動作定義ファイルをリロードできるコマンドを追加しました。

イベントサービスの定義情報を収集・配布する機能を追加しました（JP1/IM限定）。

jevexportコマンド実行中のイベントDB切り替わりを検知できるようになりました。

jevexportコマンドで指定するフィルターファイルに記述できる比較キーワード（WITHIN）を追加しました。

フィルターで使用する正規表現に拡張正規表現をサポートしました。

インストール時の自動セットアップ処理機能を追加しました。Windowsの場合だけ，インストール時に自動セットアップ処理が選択できるようになりました。

ログファイルトラップの動作定義ファイルのフィルターとして指定できるログの種類に，SEQ2を指定できるようになりました。

Linuxで，認証サーバ機能をサポートしました。

jcocmddefコマンドにコマンド同時実行数を設定するオプション（-execnum），コマンド実行操作関連イベントを設定するオプション（-cmdevent，-actevent）を追加しました。

JP1イベント（00003FA0，00003FA1，00003FA2）を追加しました。

付録M　用語解説

（英字）

ANYバインド方式

ホストに割り当てられているすべてのIPアドレスへの接続を受信できる通信方式です。通信の待ち受け処理では，ポート番号を使用してホストへアクセスしてきたすべてのデータを確実に受信できます。また，接続処理では，ホストが複数のサブネットを利用している場合でも，すべてのサブネット上のホストにデータを確実に送信できます。通常，物理ホストだけでJP1/Baseを運用する場合，このANYバインド方式で動作します（特に設定の必要はありません）。

IPバインド方式

特定のIPアドレスへの接続だけを受信できる通信方式です。通信の待ち受け処理では，特定のIPアドレスあてにきたデータだけを受信します。また，接続処理では，特定のIPアドレスを使用しているNICだけを経由してデータを送信します。

通常，JP1/Baseをクラスタ運用する場合，このIPバインド方式で動作します（クラスタシステム用に設定すると，通信方式がIPバインド方式に変わります）。

JP1/AJS

JP1/AJSは，業務を自動的に運用するためのプログラムです。処理を順序付けて定期的に実行したり，特定の事象が発生したときに処理を開始したりできます。

JP1/Base

JP1/Baseは，イベントサービス機能を提供するプログラムです。サービスの起動順序を制御したり，JP1イベントを送受信したりできます。

また，JP1/Baseは，JP1/IM，JP1/AJS，およびJP1/Power Monitorの前提プログラムです。JP1/IM，およびJP1/AJSを使ったシステムを導入する場合，JP1ユーザーの操作を制限する機能を提供します。

JP1/Cm2

ネットワークの構成管理，性能管理および障害管理のための統合ネットワーク管理プログラムの総称です。

JP1/IM - Manager

JP1/IM - Manager（JP1/Integrated Management - Manager）は，システム全体の一元的な監視と操作を実現し，システムを統合管理するためのプログラムです。

JP1/IM - Managerは，「セントラルコンソール」および「セントラルスコープ」の二つの機能によって構成されています。

JP1/IM - View

JP1/IMでのシステム統合管理を実現するためのビューアー機能を提供するプログラム（GUI提供プログラム）です。

JP1/IM - Manager，JP1/IM - Central Information MasterおよびJP1/IM - Rule Operationで共通のJP1/IM - Viewを使用します。目的に応じて，それぞれの製品に接続し，システムの監視や管理を行います。

JP1/NETM/Audit - Manager

内部統制の有効性を評価するために必要な証跡記録を一元管理し，内部統制の報告書作成や監査業務を支援する製品です。ユーザー情報やシステム構成の変更などの証跡記録を利用して，業務の正当性を確認したり，リソースへの操作やアクセス状況を監査できます。

JP1/Power Monitor

JP1/Power Monitorは，ホストを自動的に起動・終了するプログラムです。

スケジュールを設定してホストを起動・終了したり，離れた場所にあるホストを起動・終了したりできます。

JP1/SES

JP1/SESはバージョン5以前の製品です。プログラムが発行するイベントを管理する機能（システムイベントサービス）を提供するプログラムプロダクトです。

JP1/SES互換機能

バージョン5以前の製品であるJP1/SESおよびJP1/AJSのイベントサービスとの互換を保つための機能です。

jp1hosts情報

JP1/Base独自のhosts情報のことです。一つのホスト名から一つのIPアドレスしか解決できないOSであっても，jp1hosts情報を定義すればJP1/Baseでは，一つのホスト名に複数のIPアドレスを割り当てられ，一つのホスト名から複数のIPアドレスに解決できます。なお，jp1hosts情報は共通定義情報に登録すると有効になります。

JP1イベント

システムで発生した事象をJP1で管理するための情報です。

JP1イベントは，次のような属性に分けて，事象を記録しています。

基本属性

すべてのJP1イベントが持つ属性です。

属性名を表記する場合，例えばイベントIDはB.ID（または単にID）のように記述します。

拡張属性

JP1イベントの発行元が任意に指定できる属性です。拡張属性は，次の共通情報と固有情報で構成されます。

・共通情報（形式が統一されている拡張属性の情報）

・固有情報（共通情報以外の各製品固有の形式の情報）

属性名を表記する場合，例えば重大度はE.SEVERITY（または単にSEVERITY）のように記述します。

JP1イベントは，JP1/Baseのイベントサービス機能が管理しています。システムで発生した事象をJP1イベントとしてデータベースに記録しています。

JP1権限レベル

管理対象（資源）に対してJP1ユーザーがどのような操作ができるかを表しています。ジョブ，ジョブネット，イベントなどの管理対象（資源）の種類に応じて，操作項目を定めています。管理対象（資源）の種類と，それに対する操作項目の幾つかを組み合わせた形式でJP1ユーザーのアクセス権限を管理します。

JP1資源グループ

ジョブ，ジョブネット，イベントなどの管理対象（資源）を幾つかのグループに分けて管理します。この管理対象（資源）を分けたグループのことをJP1資源グループと呼びます。

JP1ユーザー

JP1/IMまたはJP1/AJSを使用するときのユーザー名です。JP1ユーザーは，認証サーバに登録され，他ホストへのアクセス権限を認証サーバで管理されます。OSに登録されているユーザーとは異なる場合があります。

認証サーバでログイン認証をするJP1ユーザーを標準ユーザーといい，ディレクトリサーバでログイン認証をするJP1ユーザーを連携ユーザーといいます。

SNMPトラップ変換機能

JP1/Cm2/NNMまたはHP NNMが発行するSNMPトラップをJP1イベントに変換する機能です。

（ア行）

イベントID

JP1イベントの属性の一つで，JP1イベントを発行したプログラムや，発生した事象の内容を示す識別子です。JP1イベントの基本属性で，属性名は「B.ID」です。

イベントIDは，例えば，7FFF8000のような値で，16進数で表記します。

イベントIDは，JP1シリーズの各製品で一意になるように割り当てられています。JP1シリーズの各製品が発行するJP1イベントについては，各製品のマニュアルを参照してください。

ユーザーが使用できるイベントIDは，0～1FFFおよび7FFF8000～7FFFFFFFです。

なお，JP1イベントの詳細は，基本コード（上位4バイト）と拡張コード（下位4バイト）に分かれた8バイトの数値です。通常は，基本コードだけを使って4バイトで表記します。拡張コードは，ユーザーがAPIで設定するなど特別な場合を除いて0です。基本コードと拡張コードの表記が必要な場合は，「:」でつなげて，7FFF8000:0のように表します。

イベントサーバ

JP1/BaseでJP1イベントを管理する機能を持つプログラムです。イベントサーバを起動すると，JP1イベントを収集・配布できる状態になります。

イベントサービス

システム内で発生した事象をJP1イベントとして登録，および管理するための機能です。

イベントログトラップ

WindowsのイベントログをJP1イベントに変換する機能です。

エージェント

システム上でほかのプログラムに管理される役割を持つプログラムのことです。または，システム上でほかのホストに管理される役割を持つホストのことです。

JP1/IM，JP1/AJSを例にすると，JP1/IMの場合はJP1/Baseが，JP1/AJSの場合はJP1/AJS - Agent，JP1/Baseがエージェントとしての役割を持つプログラムになります。

（カ行）

拡張属性

JP1イベントの属性のうち，JP1イベントの発行元プログラムが任意に指定する属性です。拡張属性には共通情報と固有情報があります。共通情報にはJP1プログラムで統一されている情報を示します。固有情報は共通情報以外の拡張属性を示します。

稼働情報

JP1/Baseサービスが読み込んだ定義情報のことです。現在JP1/Baseでどの定義が有効になっているかを確認できます。

キー定義ファイル

データファイルとキーファイルとの対応を表すデータを格納するファイルです。

キーファイル

キーを検索するためのインデックス情報を，階層木構造で格納するファイルです。データファイルのレコードを検索するためのキーも格納されます。キーファイルには，主キーファイルと副キーファイルがあります。

基本属性

JP1イベントの属性のうち，すべてのJP1イベントに共通する属性です。

共通定義情報

JP1/Base，JP1/IM，JP1/AJS，およびJP1/Power Monitorの定義情報の集まりで，JP1/Baseが管理しています。データベースは，各サーバのローカルディスクにあり，定義パラメーターが物理ホストおよび論理ホストごとに分けて格納されています。

なお，JP1をクラスタシステムで運用する場合は，実行系・待機系の各サーバにある共通定義情報の論理ホストの定義内容を同じにする必要があります。このため，セットアップや環境設定をしたときは，実行系サーバでパラメーターを設定したあとで，待機系サーバに設定をコピーします。

クライアント

処理を実行するほかのホスト（プログラム）に対して，実行の指示を出し，その結果を受け取るホストです。JP1/IMでは，JP1/IM - View，JP1/AJSでは，JP1/AJS - Viewがクライアントとなります。

クラスタシステム

クラスタシステムとは，複数のサーバシステムを連携して一つのシステムとして運用するシステムで，障害が発生しても業務を継続できるようにすることを目的としています。この処理を引き継ぐことをフェールオーバーといいます。業務を実行中のサーバ（実行系）で障害が発生すると，待機していた別のサーバ（待機系）が業務の処理を引き継ぎます。実行「系」から待機「系」へ業務を切り替えるため，「系切り替えシステム」とも呼びます。

なお，クラスタシステムの種類には，複数のサーバが並列処理をして負荷分散することを目的としたシステム構成などもありますが，このマニュアルでは，フェールオーバーによって業務の中断を防ぐ機能のことだけを指します。

系切り替えシステム

クラスタシステムを参照してください。

構成定義

JP1/IMが運用管理するシステムの構成を定義した情報です。

構成定義には，JP1/IMのマネージャーとエージェントの階層関係を定義します。また，マネージャーは階層化して定義でき，例えば上位の統合マネージャーと下位の拠点マネージャーのように定義できます。

構成定義に定義している階層化したホストの情報は，JP1/IMでマネージャーに重要なJP1イベントを転送するための転送先ホストや，JP1/IMで自動アクションによってコマンドを実行できるホストの情報などとして使われます。

（サ行）

スパース文字

キーとして使用しないように指定した文字のことです。スパース文字は，キー定義ファイルを作成するときや，キーを追加するときに指定します。

レコードを追加するとき，あるキーのすべての内容がスパース文字と同じ場合，そのキーはキーファイルに追加されません。このようなキーを，スパースキーといいます。これによって，キーファイルの容量を削減できます。また，重複キーの処理時間を短縮できます。

正規表現

特定のテキスト文字列に対応する文字や特殊文字の並びのことです。

セカンダリー認証サーバ

一つのユーザー認証圏内に認証サーバを2台設置するときに，予備として稼働する認証サーバのことです。

（タ行）

ディレクトリサーバ

ネットワーク上に存在するさまざまな資源，および資源の属性を一元管理するためのサービスを提供するサーバのことです。

（ナ行）

認証サーバ

JP1ユーザーのアクセス権限を管理するサーバです。一つのユーザー認証圏に1台設置する必要があります。このサーバを利用してJP1ユーザーを一括で管理します。JP1/IM，JP1/AJSを導入する場合，JP1ユーザー名をこのサーバに登録する必要があります。

（ハ行）

バリアブルバインディング

SNMPトラップをJP1/BaseでJP1イベントに変換するときに，JP1イベントの拡張属性の固有情報に取り込むSNMPトラップのバリアブルバインディングのことです。

SNMPトラップには，基本的な情報として，トラップ発行元を示すエンタープライズ名（enterprise）や，トラップの意味（generic-trapやspecific-trap）があります。これらに加えてSNMPトラップ固有の詳細情報を付加する場合は，バリアブルバインディング（variable bindings。VarBindと書く場合もある）を付加してSNMPトラップが発行されます。

バリアブルバインディングは，オブジェクト識別子（OID）とデータを持ちます。例えば，JP1/Cm2/SSOでアプリケーションを監視する場合，エラー発生を検知したときには，詳細情報としてバリアブルバインディングにアプリケーション名を付加し，SNMPトラップが発行されます。

SNMPトラップの詳細については，RFC1157やネットワーク関連の専門書を参照してください。また，SNMPトラップのバリアブルバインディングに含まれる情報については，SNMPトラップを発行する各製品のマニュアルを参照してください。

ビューアー

マネージャーやエージェントが管理する情報を確認し，マネージャーやエージェントを操作するための画面を提供するプログラムのことです。または，ビューアーを実行するホストのことです。

JP1/IM，JP1/AJSを例にすると，JP1/IM - View，JP1/AJS - Viewなどがビューアーとしての役割を持つプログラムになります。

標準ユーザー

認証サーバでログイン認証をするJP1ユーザーのことです。パスワードは認証サーバで管理します。

フェールオーバー

JP1を実行するサーバに障害が発生した場合に，ほかの正常なサーバにJP1を移動させて処理を続行することです。または，システム管理者の操作によって，JP1を実行するサーバを切り替えることです。

実行系サーバから待機系サーバにフェールオーバーするため，系切り替えとも言います。

複数LAN接続

複数のLANで構成されたシステムに対応するJP1の機能のことです。

この機能を使うと，複数のLANに接続されたホスト上で，JP1の通信に使うLANを設定できます。システムやほかのアプリケーションとは別にJP1独自に通信設定できるので，多様なネットワーク構成や運用方法に柔軟に対応できます。

なお，複数のLANに接続したホストを，マルチホームホストや複数NICのホストと呼ぶこともあります。

JP1/Baseでは，次の複数LAN接続の環境での運用をサポートしています。

複数のネットワークに分かれている環境

物理ホスト

クラスタシステムを構成する各サーバに固有な環境のことです。物理ホストの環境は，フェールオーバー時にはほかのサーバに引き継がれません。

プライマリー認証サーバ

一つのユーザー認証圏内に認証サーバを2台設置するときに，通常時に利用する認証サーバのことです。

プロセス

Windowsの場合のサービスプログラム，UNIXの場合のデーモンプログラムなどを示します。

閉塞状態

接続に失敗した認証サーバに接続を試みない状態のことです。これは，一つのユーザー認証圏内に認証サーバを2台設置したときに発生することがあります。

（マ行）

マネージャー

システム上のほかのプログラムを管理する役割を持つプログラムのことです。または，システム上のほかのホストを管理する役割を持つホストのことです。

JP1/IM，JP1/AJSを例にすると，JP1/IM - ManagerやJP1/IM - Rule Operation，JP1/AJS - Managerなどがマネージャーとしての役割を持つプログラムになります。これらのプログラムはシステム上のほかのプログラム（エージェント）を管理します。

（ヤ行）

ユーザー認証圏

システム内で認証サーバが管理するホスト群の範囲を表しています。JP1ユーザーは，認証サーバが管理するホスト群に対してジョブの実行，コマンドの実行，自動アクションなどの各種操作ができます。JP1/IM，JP1/AJSを導入する場合，ユーザー認証圏を決める必要があります。

ユーザーマッピング

JP1ユーザーに，OSに登録されているユーザーの権限を与える機能です。

JP1ユーザーとして認証サーバに登録されたユーザーが，各ホストのOSに登録されているユーザーの権限で各ホストの操作を実行できるようになります。

（ラ行）

連携ユーザー

ディレクトリサーバでログイン認証をするJP1ユーザーのことです。パスワードはディレクトリサーバで管理します。そのため，JP1ユーザーを認証サーバに登録する際，パスワードは入力しません。

ローカルアクション

特定のJP1イベントが発生したときに，ローカルホスト内で自動的にコマンドを実行する機能です。

ログファイルトラップ機能

アプリケーションプログラムがログファイルに出力するログをJP1イベントに変換する機能です。

論理ホスト

クラスタシステムでの運用時にJP1の実行環境となる論理上のサーバのことです。障害の発生時には，論理ホスト単位でフェールオーバーします。

論理ホストは専用のIPアドレスと共有ディスクを持ち，フェールオーバー時にはそのIPアドレスと共有ディスクを引き継いで動作します。そのため，障害で物理的なサーバが切り替わった場合も，ほかのホストからは同じIPアドレスでアクセスでき，一つのホストが常に動作しているように見えます。

索引

[Ａ][Ｂ][Ｃ][Ｄ][Ｆ][Ｈ][Ｉ][Ｊ][Ｌ][Ｎ][Ｏ][Ｓ][Ｖ][Ｗ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(英字)

(Ａ)

Active Directory

ANYバインド方式

用語解説

api（API設定ファイル）

API設定ファイル（api）

(Ｂ)

［Baseクラスタ構成の設定］ダイアログボックス

(Ｃ)

conf（イベントサーバ設定ファイル）

cpysvprm（Windows限定）

(Ｄ)

DNSを使ったシステムでのイベントサーバの設定

(Ｆ)

forward（転送設定ファイル）

定義情報を収集する

定義情報を配布する

(Ｈ)

Hitachi Network Objectplaza Trace Monitor 2（サービス）

Hitachi PP Installer

使用方法

初期画面例

注意事項

hntr2conf

hntr2getconf

hntr2getname（Windows限定）

hntr2kill（UNIX限定）

hntr2mon（UNIX限定）

hntr2util（UNIX限定）

hntr2util（Windows限定）

HNTRLib2（統合トレース機能）

設定する

(Ｉ)

imevtgw.conf（動作定義ファイル）

詳細

index（イベントサーバインデックスファイル）

IPアドレス

確認方法

変更による影響および必要な作業

IPバインド方式

用語解説

ISAMファイル

操作および保守に関するユーティリティコマンド

(Ｊ)

jbs_killall.cluster（UNIX限定）

jbs_log.bat（Windows限定）

jbs_log.sh（UNIX限定）

jbs_setup_cluster（Windows限定）

jbs_spmd_reload

jbs_spmd_status

jbs_spmd_stop

jbs_spmd（UNIX限定）

jbs_start.cluster（UNIX限定）

jbs_start（UNIX限定）

jbs_stop.cluster（UNIX限定）

jbs_stop（UNIX限定）

jbsacllint

jbsaclreload

jbsadduser

jbsadmin（Windows Vista限定）

jbsblockadesrv

jbscancellcact

jbschgds（Windows限定）

jbschgpasswd

jbschkds（Windows限定）

jbsgetcnf

jbsgetopinfo

jbsgetumap

jbshostsexport

jbshostsimport

jbslistacl

jbslistlcact

jbslistsrv

jbslistuser

jbsmkpass（Windows限定）

jbsmkumap

jbspassmgr（Windows限定）

jbsrmacl

jbsrmumap

jbsrmumappass（Windows限定）

jbsrmuser

jbsrt_del

jbsrt_distrib

jbsrt_get

jbsrt_sync

jbssetacl

jbssetcnf

jbssetumap

jbssetupsrv（Windows限定）

jbssetusrsrv（UNIX限定）

jbsumappass（Windows限定）

jbsunblockadesrv

jbsunsetcnf

jcocmdconv

jcocmddef

jcocmddel

jcocmdlog

jcocmdshow

jevdbinit

jevdbmkrep

jevdbswitch

jevdef_distrib

jevdef_get

jeveltreload（Windows限定）

jevexport

jevlogdstart（UNIX限定）

jevlogdstat

jevlogdstop（UNIX限定）

jevlogreload

jevlogstart

jevlogstart（クラスタ運用限定）

jevlogstat

jevlogstop

jevlogstop（クラスタ運用限定）

jevregsvc（Windows限定）

jevreload

jevsend

jevsend（概要）

jevsendd

jevsendd（概要）

jevstart（UNIX限定）

jevstat

jevstop（UNIX限定）

Jischk

Jiscond

Jisconv

Jiscpy

Jisext

Jisinfo

Jiskeymnt

Jisktod

Jislckclear（Windows限定）

Jislckext

Jislckfree（Windows限定）

Jislckreg（UNIX限定）

Jismlcktr（Windows限定）

Jisprt

Jisrsdel（UNIX限定）

JP1_HOSTNAME環境変数

JP1/AJS

Windowsイベントログ監視ジョブを使用する場合

用語解説

ログファイル監視ジョブ

JP1/Base

運用中の設定変更

各機能サポート状況一覧（UNIXの場合）

各機能サポート状況一覧（Windowsの場合）

起動確認する（UNIX）

起動確認する（Windows）

起動する（UNIX）

起動する（Windows）

互換性

終了する（UNIX）

終了する（Windows）

障害に備えた設定

使用上の注意事項

制限値一覧

通信設定

ポート番号一覧

用語解説

JP1/Base（サービス）

JP1/Base Control Service（サービス）

JP1/Base Event（サービス）

JP1/Base EventlogTrap（サービス）

JP1/Base LogTrap（サービス）

JP1/Cm2（用語解説）

JP1/IM - Manager（用語解説）

JP1/IM - View（用語解説）

JP1/NETM/Audit - Manager（用語解説）

JP1/Power Monitor（用語解説）

JP1/SES

イベント

互換機能（用語解説）

用語解説

JP1/SESイベント

製品との連携

変換手順

jp1base_setup_cluster（UNIX限定）

jp1base_setup（UNIX限定）

jp1bshasetup（Windows限定）

jp1hosts

定義する

用語解説

jp1ping

JP1SVPRM.DAT（起動順序定義ファイル）

JP1イベント

一覧

拡張属性

基本属性

取得件数

種類

詳細

送受信する

属性

重複チェック

転送

転送のリトライ

保管期限

用語解説

JP1権限レベル

用語解説

JP1資源グループ

用語解説

［JP1資源グループ詳細］ダイアログボックス

JP1ユーザー

GUIを使って設定する（Windows）

コマンドを使って設定する（Windows）

設定する（UNIX）

操作権限を設定する（UNIX）

操作権限を設定する（Windows）

用語解説

［JP1ユーザー］ダイアログボックス（ユーザー追加）

［JP1ユーザー］ダイアログボックス（ユーザーマッピング）

(Ｌ)

LANG環境変数

(Ｎ)

ntevent.conf（動作定義ファイル）

定義情報を収集する

定義情報を配布する

(Ｏ)

OSユーザー

個別に削除する（コマンド）

個別に登録する（コマンド）

パスワード管理情報を一括して設定する（コマンド）

パスワード管理情報を設定する（GUI）

［OSユーザー設定時にWindowsに対してログオンチェックを行わない］

(Ｓ)

snmpfilter.conf（SNMPトラップ変換フィルターファイル）

SNMPトラップ変換機能

SNMPトラップ変換フィルターファイル

起動する

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

終了する

設定を解除する

動作定義ファイルの詳細

用語解説

SNMPトラップ変換フィルターファイル（snmpfilter.conf）

(Ｖ)

V5互換機能

(Ｗ)

Windowsイベントログ監視ジョブを使用する場合

(ア行)

(あ)

アンインストール

注意事項（UNIX）

注意事項（Windows）

手順（UNIX）

手順（Windows）

(い)

イベントDB

csvファイルに出力する

初期化する

バックアップ

バックアップ（UNIX）

容量

リカバリー（UNIX）

リカバリー（Windows）

イベントID

00002102の詳細

00002103の詳細

00002104の詳細

00003A10の詳細

00003A20の詳細

00003A21の詳細

00003A22の詳細

00003A30の詳細

00003A31の詳細

00003A32の詳細

00003A71の詳細

00003A73の詳細

00003A74の詳細

00003A80の詳細

00003D00の詳細

00003D04の詳細

00003FA0の詳細

00003FA1の詳細

00003FA2の詳細

00003FA3の詳細

00003FA5の詳細

00003FA6の詳細

00004700の詳細

00004701の詳細

00004702の詳細

00004720の詳細

00004721の詳細

00004722の詳細

00004724の詳細

00004725の詳細

00004740の詳細

00004741の詳細

00004742の詳細

00004743の詳細

00004747の詳細

00004748の詳細

00004749の詳細

0000474Aの詳細

0000474Bの詳細

0000474Cの詳細

0000474Dの詳細

00004780の詳細

00004781の詳細

00004782の詳細

00004783の詳細

00010B7Fの詳細

ACTDEFパラメーターで指定されたイベントIDの詳細

用語解説

イベントサーバ

用語解説

イベントサーバインデックスファイル（index）

イベントサーバ設定ファイル（conf）

イベントサービス

DNSを使ったシステムでのイベントサーバの設定

稼働中に初期化する

使用するコマンド

設定手順

注意事項

通信設定を変更する

定義情報を収集する

定義情報を配布する

停止中に初期化する

用語解説

イベントフィルター

記述例

イベント変換

イベントログトラップ

用語解説

イベントログトラップ機能

監視間隔

監視の開始位置

監視の終了位置

起動する

クラスタ運用

自動で起動する

終了する

イベントログトラップ動作定義ファイル

インストール

注意事項（UNIX）

注意事項（Windows）

手順（UNIX）

手順（Windows）

(え)

エージェント（用語解説）

(お)

オペレーティングシステムの一部として機能

(カ行)

(か)

カーネルパラメーター

調整

概要

拡張正規表現

拡張属性

用語解説

拡張属性マッピング設定ファイル

定義例（単一のマッピング）

定義例（複数のマッピング）

各バージョンの変更内容

07-00の変更内容

07-10の変更内容

07-11の変更内容

07-50の変更内容

07-51の変更内容

08-00の変更内容

08-10の変更内容

08-10の変更内容

08-50の変更内容

09-00の変更内容

09-10の変更内容

稼働情報

用語解説

環境変数

JP1_HOSTNAME

LANG

監視間隔

イベントログトラップ機能

ログファイルトラップ機能

監視の開始位置

イベントログトラップ機能

ログファイルトラップ機能

監視の終了位置

イベントログトラップ機能

ログファイルトラップ機能

(き)

キー定義ファイル（用語解説）

キーファイル（用語解説）

起動確認する（UNIX）

起動確認する（Windows）

起動管理

使用をやめる

起動管理機能

使用するコマンド

注意事項

起動順序定義ファイル（JP1SVPRM.DAT）

起動する

JP1/Base（UNIX）

JP1/Base（Windows）

SNMPトラップ変換機能

イベントログトラップ機能

使用するコマンド

ログファイルトラップ

機能一覧（UNIX）

機能概要

基本属性

用語解説

共通定義情報

コマンド

バックアップ（UNIX）

バックアップ（Windows）

用語解説

リカバリー（UNIX）

リカバリー（Windows）

共通メッセージログ

共有ファイルの作成（UNIX）

共有フォルダの指定（Windows）

(く)

クライアント（用語解説）

クラスタID

クラスタ運用

JP1/Baseの機能

JP1の再起動

概要

環境設定（UNIX）

環境設定（Windows）

クラスタソフトへの登録（UNIX）

クラスタソフトへの登録（Windows）

言語種別を変更する（UNIX限定）

設定変更時の作業

セットアップ（UNIX）

セットアップ（Windows）

前提条件

注意事項

クラスタシステム

概要

実行系サーバ

待機系サーバ

用語解説

クラッシュダンプの出力設定

(け)

系切り替えシステム

用語解説

言語種別

設定

変更する（UNIX限定）

(こ)

構成定義（用語解説）

互換性

イベントサービス機能で連携できる製品

コネクションの接続状態

コマンド

ISAMファイルの操作，保守

jbsrt_del

jbsrt_distrib

jbsrt_get

jbsrt_sync

jcocmddef

jcocmddel

jcocmdlog

jcocmdshow

一覧

イベントサービス

起動・終了，セットアップ

起動管理機能

共通定義情報

構成定義

トラブルシューティング

ネットワーク設定の確認

バージョンアップ

ユーザー管理機能

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

コマンド実行履歴ファイル

ディレクトリ（UNIX）

ディレクトリ（Windows）

(サ行)

(さ)

サービス

Hitachi Network Objectplaza Trace Monitor 2（統合トレース）

JP1/Base（ユーザー管理を含むプロセス管理）

JP1/Base Control Service（起動管理）

JP1/Base Event（イベントサービス）

JP1/Base EventlogTrap（イベントログトラップサービス）

JP1/Base LogTrap（ログファイルトラップ管理サービス）

一覧

起動

起動確認する

起動順序

起動順序の設定手順

起動順序を制御する（概要）

起動するタイミングを設定する

終了

終了順序の設定手順

終了順序を制御する（概要）

サービスとしてログオン

(し)

システムの日時変更

実行系サーバ

［実行系 論理ホストの設定］ダイアログボックス

自動起動

イベントログトラップ機能

設定する（UNIX限定）

ログファイルトラップ

自動終了の設定（UNIX限定）

自動セットアップ（UNIX）

自動セットアップ（Windows）

終了する

JP1/Base（UNIX）

JP1/Base（Windows）

SNMPトラップ変換機能

イベントログトラップ機能

使用するコマンド

ログファイルトラップ

障害に備えた設定

資料採取ツール

資料を採取する

UNIX

Windows

(す)

スパース文字（用語解説）

(せ)

正規表現

拡張する

拡張正規表現

指定する際のヒント

指定例

デフォルトの文法

比較

用語解説

制限値一覧

セカンダリー認証サーバ

用語解説

設定する

IPアドレスの変更

JP1ユーザー（UNIX）

JP1ユーザー（Windows）

SNMPトラップ変換機能

イベントログトラップ機能

クラスタ運用環境（UNIX）

クラスタ運用環境（Windows）

障害に備えた設定

正規表現を拡張する

操作権限（UNIX）

操作権限（Windows）

ディレクトリサーバ

ディレクトリサーバ連携

認証サーバ（UNIX）

認証サーバ（Windows）

標準ユーザー

ユーザーマッピング（UNIX）

ユーザーマッピング（Windows）（GUI）

ユーザーマッピング（Windows）（コマンド）

連携ユーザー

ログファイルトラップ

セットアップ

事前の作業（UNIX）

使用するコマンド

論理ホスト（UNIX）

論理ホスト（Windows）

(そ)

操作権限

GUIを使って設定する（Windows）

一括して設定する（UNIX）

一括して設定する（Windows）

個別に登録する（UNIX）

個別に登録する（Windows）

削除する（UNIX）

削除する（Windows）

操作ログ

出力

出力形式

出力される契機

出力される事象の種別

出力されるメッセージの一覧

出力するための設定

操作ログ定義ファイル（jp1bs_baselog_setup.conf）の詳細

操作ログ定義ファイルの定義例

保存形式

操作ログ定義ファイル（jp1bs_baselog_setup.conf）

詳細

定義例

(タ行)

(た)

待機系サーバ

［待機系 論理ホストの設定］ダイアログボックス

単一ネットワークでの運用

(つ)

通信設定

単一ネットワークでの運用に戻す

必要な場合

変更対応

通信方式

ANYバインド方式

IPバインド方式

設定ファイル

変更する

(て)

定義収集

定義収集機能

JP1製品の定義情報の収集

収集する

定義配布

定義配布機能

配布する

定義ファイル

API設定ファイル

JP1/Baseパラメーター定義ファイル

jp1hosts定義ファイル

イベントサーバインデックスファイル

イベントサーバ設定ファイル

イベントログトラップ動作定義ファイル（Windows限定）

拡張起動プロセス定義ファイル

起動順序定義ファイル（Windows限定）

共通定義設定用ファイル（ヘルスチェック機能）

共通定義設定用ファイル（ローカルアクション機能）

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）

定義ファイル一覧

ディレクトリサーバ変更ファイル（Windows限定）

ディレクトリサーバ連携定義ファイル（Windows限定）

転送設定ファイル

配布定義ファイル

パスワード定義ファイル（Windows限定）

ヘルスチェック定義ファイル

ホストアクセス制限定義ファイル

ユーザー権限レベルファイル

ユーザーマッピング定義ファイル

ローカルアクション環境変数ファイル

ローカルアクション実行定義ファイル

ログ情報定義ファイル

ログファイルトラップ起動定義ファイル

ログファイルトラップ動作定義ファイル

ディスク占有量

UNIX

Windows

共有ディスク

ディレクトリ一覧

ディレクトリサーバ

～と連携してログイン認証をする

指定する

用語解説

ディレクトリサーバ連携

設定する

ディレクトリサーバ連携機能

注意事項

転送設定ファイル（forward）

定義情報を収集する

定義情報を配布する

(と)

同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定

統合トレース機能（HNTRLib2）

設定する

統合トレースログ

動作定義ファイル（imevtgw.conf）

詳細

動作定義ファイル（ntevent.conf）

定義情報を収集する

定義情報を配布する

動作定義ファイル（ログファイルトラップ機能用）

定義情報を収集する

定義情報を配布する

トラブルシューティング

採取が必要な資料

使用するコマンド

対処の手順

対処方法（OS共通）

対処方法（UNIX）

対処方法（Windows）

ヘルスチェック機能で異常を検知した場合

(ナ行)

(に)

認証サーバ

GUIを使って設定する（Windows）

コマンドを使って設定する（Windows）

指定する（UNIX）

指定する（Windows）

信頼性を高めるための運用例

認証サーバ設定後の作業

用語解説

(ね)

ネットワーク

構成に応じた通信設定

設定の確認で使用するコマンド

単一ネットワークでの運用

ネットワークを分離した環境での運用

複数ネットワークでの運用

(ハ行)

(は)

パスワード

［パスワード管理］ダイアログボックス

保管形式の設定

連携ユーザーのパスワード

バックアップ

イベントDB

イベントDB（UNIX）

共通定義情報（UNIX）

共通定義情報（Windows）

対象ファイル（UNIX）

対象ファイル（Windows）

定義ファイル（UNIX）

定義ファイル（Windows）

バリアブルバインディング

用語解説

(ひ)

ビューアー

用語解説

標準ユーザー

GUIを使って設定する（Windows）

コマンドを使って設定する（Windows）

設定する（UNIX）

設定する（Windows）

操作権限を設定する（UNIX）

操作権限を設定する（Windows）

用語解説

(ふ)

ファイアウォール

通過方向

定義情報の収集と配布

ファイル一覧

フェールオーバー

用語解説

複数LAN接続

用語解説

複数ネットワークでの運用

物理ホスト

前提条件

用語解説

プライマリー認証サーバ

設定情報をコピーする（UNIX）

設定情報をコピーする（Windows）

用語解説

プロセス

一覧（UNIX）

一覧（Windows）

用語解説

プロセス管理

プロセス別ログ

(へ)

閉塞状態

～にする（GUI）

～にする（コマンド）

解除する（GUI）

解除する（コマンド）

確認する（GUI）

確認する（コマンド）

用語解説

閉塞中

ヘルスチェック機能

監視対象プロセス

クラスタ運用

他ホストの監視

プロセス監視の仕組み

(ほ)

ポート番号一覧

ホスト名の変更

(マ行)

(ま)

［マッピングOSユーザー詳細］ダイアログボックス

マネージャー（用語解説）

(め)

メモリー所要量

メモリーダンプの出力設定

(も)

文字コード互換モード

(ヤ行)

(ゆ)

ユーザー管理

設定する（UNIX）

設定する（Windows）

設定する（ディレクトリサーバ連携）

設定の流れ（UNIX）

設定の流れ（Windows）

設定の流れ（ディレクトリサーバ連携）

注意事項（UNIX）

注意事項（Windows）

ユーザー管理機能

使用するコマンド

デフォルト値（UNIX）

デフォルト値（Windows）

ユーザー認証

ユーザー認証圏

用語解説

ユーザーマッピング

一括して設定する（UNIX）

一括して設定する（Windows）

確認する（Windows）

個別に削除する（UNIX）

個別に削除する（Windows）

個別に登録する（UNIX）

個別に登録する（Windows）

設定する（UNIX）

設定する（Windows）（GUI）

設定する（Windows）（コマンド）

設定する前に（Windows限定）

変更する（Windows）

用語解説

ユーザーを管理する

(よ)

用語解説

(ラ行)

(り)

リカバリー

イベントDB（UNIX）

イベントDB（Windows）

共通定義情報（UNIX）

共通定義情報（Windows）

定義ファイル（UNIX）

定義ファイル（Windows）

リモートインストール

UNIX

Windows

(る)

ルーティング

(れ)

連携ユーザー

GUIを使って設定する

コマンドを使って設定する

設定する

用語解説

(ろ)

ローカルアクション

用語解説

ローカル ログオン

ログ情報

種類

ログファイル一覧

ログファイル監視ジョブを使用する場合

ログファイルトラップ

ログファイルトラップ

起動する

自動で起動する

終了する

動作状況を確認する

ログファイルトラップ機能

監視間隔

監視の開始位置

監視の終了位置

クラスタ運用

用語解説

論理ホスト

アップグレード（UNIX）

アップグレード（Windows）

サービスの起動管理

削除する（UNIX）

削除する（Windows）

セットアップ（UNIX）

セットアップ（Windows）

前提条件

非クラスタ環境での論理ホスト運用

非クラスタ環境で論理ホストを運用する場合の設定

用語解説

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MicrosoftおよびHyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
POSIXは，the Institute of Electrical and Electronics Engineers, Inc. (IEEE)で制定された標準仕様です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
Sun Microsystemsは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Visual C++は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows NTは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
XPG4は，X/Open Company Limitedの規格名称です。
プログラムプロダクト「P-9D2C-6L91」，「P-9E2C-6L91」には，Oracle Corporationまたはその子会社，関連会社が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-6L91」，「P-9E2C-6L91」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。