Hitachi

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


jcadefconv

〈このページの構成〉

機能

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

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

表1‒2 文字の変換

変換前の文字

変換後の文字

\/

/

半角スペース

%20

%

%25

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

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

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

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

バージョン8以前の形式

11-50以降の形式

備考

DESC_VERSIONなし)

DESC_VERSION=4

DESC_VERSION=1

DESC_VERSION=4

DESC_VERSION=2

DESC_VERSION=4

DESC_VERSION=3

DESC_VERSION=4

:state_watch=true

cmn

▲sta△true

end-cmn

:state_watch=false

cmn

▲sta△false

end-cmn

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

cmn

▲sta△false

end-cmn

#コメント1

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△コメント1

(省略)

end-act

#△コメント1

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△△コメント1

(省略)

end-act

#コメント1

#コメント2

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△コメント2

(省略)

end-act

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

act△アクション通し番号

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

act△Action通し番号

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

ANDアクションの場合

act

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

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

&

▲prm△&

$イベントID基本部

▲eid△イベントID基本部

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

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

*

▲eid△*

/メッセージ/

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

/イベント基本情報/

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

/イベント詳細情報/

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

//

(条件を設定しない)

/-------E/

▲▲E.SEVERITY△IN△Emergency

/------A-/

▲▲E.SEVERITY△IN△Alert

/-----C--/

▲▲E.SEVERITY△IN△Critical

/----E---/

▲▲E.SEVERITY△IN△Error

/---W----/

▲▲E.SEVERITY△IN△Warning

/--N-----/

▲▲E.SEVERITY△IN△Notice

/-I------/

▲▲E.SEVERITY△IN△Information

/D-------/

▲▲E.SEVERITY△IN△Debug

/DINWECAE/

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

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

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

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

u=ユーザー名

▲usr△ユーザー名

e=環境変数ファイル名

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

d=実行先ホスト名

▲hst△実行先ホスト名

d=グループ名

▲hst△グループ名

dt=抑止時間

▲det△抑止時間

rt=遅延監視時間

▲ret△遅延監視時間

+0△*△:アクション

▲cmd△アクション

+0△*△:<RULE>

▲rul

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

+0△*△:action.exe

act△アクション1

▲prm△0

▲eid△*

▲cnd

▲end-cnd

▲cmd△action.exe

end-act

イベント条件がない場合

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

act△アクション1

▲prm△0

▲eid△*

▲cnd

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

▲end-cnd

▲cmd△action.exe

end-act

イベント条件がある場合

aid△アクションID

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

valid△true

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

(凡例)

▲:タブを示す

△:半角スペース

−:なし

形式

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

実行権限

Windowsの場合:Administrators権限

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

格納先ディレクトリ

Windowsの場合

Consoleパス\bin\

UNIXの場合

/opt/jp1cons/bin/

引数

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

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

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

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

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

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

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

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

-h 論理ホスト名

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

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

注意事項

戻り値

0

正常終了

1

異常終了

2

警告終了

使用例

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

jcadefconv  -i actdef.conf  -o actdef_new.conf

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

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

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

DESC_VERSION=4
cmn
  sta true
end-cmn
act アクション1
  aid アクションID
  valid true
  prm 0
  cmt コメント
  eid A
  cnd
    B.MESSAGE REGEX メッセージ
    B.BASIC REGEX イベント基本情報
    B.DETAIL REGEX イベント詳細情報
    E.SEVERITY IN Emergency
    E.ATTR1 REGEX 属性値1
  end-cnd
 
  usr ユーザー名
  hst 実行先ホスト名
  cmd アクション
  var 環境変数ファイル名
  det 20
  ret 30
end-act