jcadefconv
機能
バージョン11-50より前のアクション定義ファイル(DESC_VERSIONの値が4未満)を11-50以降のアクション定義ファイル(DSEC_VERSIONの値が4)に変換します。
ただし,バージョン8以前のアクション定義ファイルの,メッセージ,イベント基本情報,イベント詳細情報,およびイベント拡張情報の項目に,次の文字があった場合,変換して定義します。
変換前の文字 |
変換後の文字 |
---|---|
\/ |
/ |
半角スペース |
%20 |
% |
%25 |
なお,このコマンドは変換前にアクション定義ファイルのフォーマットを自動でチェックします。チェックした結果,エラーが見つかった場合は,標準エラー出力にエラーメッセージが出力され,変換されません。
変換後のアクション定義ファイルの出力先は任意に設定できます。
バージョン8以前のアクション定義ファイルから11-50以降のアクション定義ファイルへは,次のように変換されます。
バージョン8以前の形式 |
11-50以降の形式 |
備考 |
---|---|---|
(DESC_VERSIONなし) |
DESC_VERSION=4 |
− |
DESC_VERSION=1 |
DESC_VERSION=4 |
− |
DESC_VERSION=2 |
DESC_VERSION=4 |
− |
DESC_VERSION=3 |
DESC_VERSION=4 |
− |
:state_watch=true |
cmn ▲sta△true end-cmn |
− |
:state_watch=false |
cmn ▲sta△false end-cmn |
− |
(:state_watchを指定していない) |
cmn ▲sta△false end-cmn |
− |
#コメント1 +0△*△:action.exe |
act△アクション1 ▲prm△0 ▲cmt△コメント1 (省略) end-act |
− |
#△コメント1 +0△*△:action.exe |
act△アクション1 ▲prm△0 ▲cmt△△コメント1 (省略) end-act |
− |
#コメント1 #コメント2 +0△*△:action.exe |
act△アクション1 ▲prm△0 ▲cmt△コメント2 (省略) end-act |
− |
パラメーターグループ指定のアクション |
act△アクション通し番号 |
コマンド実行の環境が日本語環境だった場合 |
act△Action通し番号 |
コマンド実行の環境が英語環境だった場合 |
|
ANDアクションの場合 |
act |
− |
+パラメーターグループ番号 |
▲prm△パラメーターグループ番号 |
− |
& |
▲prm△& |
− |
$イベントID基本部 |
▲eid△イベントID基本部 |
− |
$イベントID基本部:イベントID拡張部 |
▲eid△イベントID基本部:イベントID拡張部 |
− |
* |
▲eid△* |
− |
/メッセージ/ |
▲▲B.MESSAGE△REGEX△メッセージ |
− |
/イベント基本情報/ |
▲▲B.BASIC△REGEX△イベント基本情報 |
− |
/イベント詳細情報/ |
▲▲B.DETAIL△REGEX△イベント詳細情報 |
− |
// |
(条件を設定しない) |
− |
/-------E/ |
▲▲E.SEVERITY△IN△Emergency |
− |
/------A-/ |
▲▲E.SEVERITY△IN△Alert |
− |
/-----C--/ |
▲▲E.SEVERITY△IN△Critical |
− |
/----E---/ |
▲▲E.SEVERITY△IN△Error |
− |
/---W----/ |
▲▲E.SEVERITY△IN△Warning |
− |
/--N-----/ |
▲▲E.SEVERITY△IN△Notice |
− |
/-I------/ |
▲▲E.SEVERITY△IN△Information |
− |
/D-------/ |
▲▲E.SEVERITY△IN△Debug |
− |
/DINWECAE/ |
▲▲E.SEVERITY△IN△Emergency△Alert△Critical△Error△Warning△Notice△Information△Debug |
複数の重大度の条件を指定する場合 |
イベント拡張情報属性名=/属性値/ |
▲▲E.イベント拡張情報属性名△REGEX△属性値 |
− |
u=ユーザー名 |
▲usr△ユーザー名 |
− |
e=環境変数ファイル名 |
▲var△環境変数ファイル名 |
− |
d=実行先ホスト名 |
▲hst△実行先ホスト名 |
− |
d=グループ名 |
▲hst△グループ名 |
− |
dt=抑止時間 |
▲det△抑止時間 |
− |
rt=遅延監視時間 |
▲ret△遅延監視時間 |
− |
+0△*△:アクション |
▲cmd△アクション |
− |
+0△*△:<RULE> |
▲rul |
JP1/IM - RLを実行する場合 |
+0△*△:action.exe |
act△アクション1 ▲prm△0 ▲eid△* ▲cnd ▲end-cnd ▲cmd△action.exe end-act |
イベント条件がない場合 |
+0△*△/メッセージ/ : action.exe |
act△アクション1 ▲prm△0 ▲eid△* ▲cnd ▲▲B.MESSAGE△REGEX△メッセージ ▲end-cnd ▲cmd△action.exe end-act |
イベント条件がある場合 |
− |
aid△アクションID |
アクション定義の先頭からアクション実行条件が定義されている順に,アクションIDを0〜2,147,483,647を昇順に設定します。ただし,パラメーターグループに&が指定されているアクション実行条件には採番しません。 |
− |
valid△true |
有効パラメーターをtrue(有効)に設定します。ただし,パラメーターグループに&が指定されているアクション実行条件には設定しません。 |
- (凡例)
-
▲:タブを示す
△:半角スペース
−:なし
形式
jcadefconv -i 変換するアクション定義ファイル名 -o 変換後のアクション定義ファイル名 [-h 論理ホスト名]
実行権限
Windowsの場合:Administrators権限
UNIXの場合:スーパーユーザー権限
格納先ディレクトリ
- Windowsの場合
-
Consoleパス\bin\
- UNIXの場合
-
/opt/jp1cons/bin/
引数
- -i 変換するアクション定義ファイル名
-
変換するアクション定義ファイル名を,相対パスまたは絶対パス形式で指定します。アクション定義ファイルのパス名に空白を含む場合は,「"」で囲んで指定します。ファイル名には,255バイトまでの名称を指定できます。
- -o 変換後のアクション定義ファイル名
-
変換するアクション定義ファイル名を,相対パスまたは絶対パス形式で指定します。アクション定義ファイルのパス名に空白を含む場合は,「"」で囲んで指定します。ファイル名には,255バイトまでの名称を指定できます。
ただし,Windowsの場合,次に示す文字列はファイル名には指定できません。
-
「:」,「?」,「"」,「<」,「>」,「|」の文字。
-
CON,PRN,AUX,NUL,COM1,COM2,COM3,COM4,COM5,COM6,COM7,COM8,COM9,LPT1,LPT2,LPT3,LPT4,LPT5,LPT6,LPT7,LPT8,LPT9のどれかと完全一致する(小文字も含む)文字列。
変換後のアクション定義ファイル名はユーザー任意に指定できますが,-iオプションに指定したファイルは指定できません。指定した場合,KAVB5502-Eのメッセージが出力されコマンドが終了します。また,-oオプションに指定したファイル名と同名のファイルがすでにある場合,KAVB5504-Eメッセージが出力されてプログラムが終了されます。
-
- -h 論理ホスト名
-
クラスタシステムで運用している場合に,論理ホスト名を指定します。指定した論理ホストが使用する正規表現を使用して,変換する定義ファイルの内容をチェックします。
このオプションを省略した場合,環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,物理ホスト名が仮定されます。
注意事項
-
-iオプションまたは-oオプションに,JP1/IM - Managerが使用している自動アクション定義を指定する場合は,JP1/IM - Managerを停止してください。
-
11-50以降の形式に変換した際に,定義不正となる項目があります。定義不正の場合には,KAVB5505-Wメッセージが出力されますので,メッセージに従って,アクション定義ファイルを修正してください。そのあと,jcamakeaコマンドでチェックし,定義ファイルが正しく修正されたことを確認してください。
戻り値
0 |
正常終了 |
1 |
異常終了 |
2 |
警告終了 |
使用例
バージョン8以前の形式で指定されたアクション定義ファイルを11-50以降の形式に変換する場合の例を次に示します。
jcadefconv -i actdef.conf -o actdef_new.conf
バージョン8以前の形式で指定されたアクション定義ファイルの記述が次の場合を仮定します。
DESC_VERSION=2 :state_watch=true #コメント +0 $0000000A /メッセージ/,/イベント基本情報/,/イベント詳細情報/,/-------E/ ATTR1=/属性値1/ : u=ユーザー名 e=環境変数ファイル名 d=実行先ホスト名 dt=20 rt=30 アクション
jcadefconvコマンドを実行すると,次のように変換されます。
DESC_VERSION=4 cmn sta true end-cmn act アクション1 aid アクションID valid true prm 0 cmt コメント eid A cnd B.MESSAGE REGEX メッセージ B.BASIC REGEX イベント基本情報 B.DETAIL REGEX イベント詳細情報 E.SEVERITY IN Emergency E.ATTR1 REGEX 属性値1 end-cnd usr ユーザー名 hst 実行先ホスト名 cmd アクション var 環境変数ファイル名 det 20 ret 30 end-act