events
Section: WIN SYSTEM (1W)
Updated: 2013.8.29
Index
Return to Main Contents
名称
events, eventsrtape - リストに従ったイベント波形の切り出し
形式
events
[ -x
area
]
paramfile
[
start
end
]
eventsrtape [ -f
device
] [ -x
area
]
paramfile
start
end
解説
events はディスク上の win 形式連続データから、
eventsrtape はテープ上の win 形式連続データから、
いずれも設定ファイル
paramfile
の内容にしたがって、
start
と
end
で指定された時間範囲のイベントファイルを切り出します。
events が使う切り出し元は、wdisk(1W) が生成する形式の1分毎の
ファイルです。
eventsrtape が使う切り出し元は、wtape(1W) が生成する形式の
連続記録テープです。
時間範囲は
start
で始めを、
end
で終わりを指定します。それぞれの形式は、年月日時分を
yymmdd.HHMM
で表したものです。トリガーリスト中の "on時刻" がこの範囲に
含まれる("yymmdd.HHMM" の部分が一致するものまでを含む)
イベントが切り出されます。"on時刻" との比較は "yymmdd.HHMM" の
部分についてだけ行なわれますので、かわりに "yymmdd.HHMMSS" まで
書いても、"SS" の部分が無視されるだけでかまいません。
start
と
end
を省略すると、events は無期限モードで動作し、シグナルによって
止められるまで動きつづけます。ただしこのとき、切り出しを始めるのは
トリガーリストに次に追加書きされるイベントからになります。
通常 events は自動処理システムにおいて、_bj(1W) から無期限モードで
バックグラウンド実行されます。
events/eventsrtape の動作のしかたは設定ファイル
paramfile
に記述されている必要があります。
paramfile
では1行に1項目が設定されており、その意味は先頭から何行目にあるか
で決まります。1行目以外は、スペース・タブまたは改行で区切られた
最初の項目だけが読まれ、その行の以降の部分はコメントとして
扱われます。"#"で始まる行は
コメント行として無視されます。各行の内容は次のとおりです。
-
1行目:トリガーリストのファイル名。これは pmon(1W) の出力の形式です。
ファイル中で先頭が空白の行は無視されます。
-
2行目:events がデータを切り出し元として使う、win形式1分毎ファイル
のディレクトリ名。eventsrtape の場合は使われませんが、ダミーとして
この行は必要です。このディレクトリには、どの1分ファイルまでが利用
できるか(書き込み完了しているか)を示す標識ファイル LATEST が必要
です。LATEST の内容は、「最も新しく書き込みの完了したファイル」の
名前("YYHHDDhh.mm" の形式)です。
-
3行目:切り出したイベントファイルを書き込むディレクトリ名。
このディレクトリに、"yymmdd.HHMMSS" 形式の名前を持つ波形ファイルと、
それに付属するチャネル表ファイル(名前は波形ファイル名に ".ch" を
つけたもの)が作られます。
-
4行目:切り出したイベントファイルを書き込むディレクトリで常に確保
しておくべき空きスペース(MB)。":"で区切った後に、そのディレクトリ中の
ファイルが合計で占めることのできる最大スペース(MB)を指定することも
でき、この場合は両方の制限を同時に満たすようになります。events は
新たに切り出した1つのイベントファイルを書き込む前に、ここに
指定した大きさの空きスペースができるまで、同じディレクトリの
中で("yymmdd.HHMMSS" で表される名前が)最も古い
ファイルから順に削除していきます。
-
5行目:作業用の一時ファイルを作るためのディレクトリ名。
波形そのものを書き込むことはないので、通常は 1MB 程度あれば十分です。
-
6行目:トリガーリストの "on時刻" より何秒前から切り出しを始めるか
を指定します。
-
7行目:トリガーファイルの "off時刻" よりどれだけ後ろまでを
切り出すかを指定する係数です。"off時刻"-"on時刻" にここで指定する
値の平方根を乗じた長さの時間だけ、"off時刻" よりも後ろへ切り出し
終了時刻を延ばします。
-
8行目:チャネル表ファイル名。データ切り出しに必要なチャネル番号を
観測点名から得るためと、波形ファイルに付属するチャネル表ファイル
を作るために使われます。
-
9行目:地域分け定義ファイル名。このファイルは1行に1地域を
定義したテキストファイルで、行の先頭にトリガーリストに出てくる
1つの地域名を、その右にその地域に属する1つまたは複数の観測点名を、
それぞれ空白またはタブで区切って列挙します。
1つの観測点が複数の地域に属していてもかまいません。
ただし、現バージョンでは pmon(1W) 用の地域分け定義ファイルでは
許される区切り文字 "+-/" は使えませんので、共用する際には
注意が必要です。行の先頭の "#" は無視されます。
-
10行目:各地域の「隣接地域」を定義するファイル名。
events/eventsrtape はイベントファイルを切り出す際に、
トリガーリスト中でそのイベントについてリストアップされた
地域だけでなく、それらの地域に「隣接する」地域に属する
観測点のデータまでを切り出します。ある地域の隣接地域が
どこであるかを定義するのがこのファイルで、実際には
隣接していない地域を「隣接する」と定義してもかまいません。
1行に1地域の隣接地域を定義したテキストファイルで、
行の先頭にトリガーリストや地域分け定義ファイルに
出てくる1つの地域名を、
その右にその地域に隣接する1つまたは複数の地域名を、
それぞれ空白またはタブで区切って列挙します。
ある地域の隣接地域を1つも定義したくない場合は、
隣接地域の位置に、その地域名自身を1つだけ隣接地域として
書いてください。
-
11行目:events/eventsrtape は1つのイベントファイルの切り出しを完了する
たびに、そのイベント波形ファイルと同名で大きさ0のファイルを、ここに指定した
ディレクトリに作ります。これは自動検測プログラム autopick(1W) または自動検測
割り当てプログラム automan(1W) に、イベントファイルができたことを知らせるための
機構です。
以降は、events が2行目に指定された連続データディレクトリにないチャネルの
データを、ネットワークでつながった他の連続データサーバーに要求するシステムの
ために必要な設定です。
-
12行目:
-
13行目:
-
14行目:
-
15行目以降:
以下に設定ファイルの例を示します。
/dat/etc/pmon.out # trigger file
/dat/raw # input raw file directory
/dat/trg # output trg file directory
100:1000 # min.free space and max.used amount in outdir (MB)
/dat/tmp # working directory for temporary file
20 # pre event time in sec (<60)
3.0 # post event time factor; LEN=PRE+TRG+POST*sqrt(TRG)
/dat/etc/channels.tbl # master channel table file
/dat/etc/zones.tbl # zone table file
/dat/etc/nxtzones.tbl # list of neighboring zones
/dat/auto # touch directory for auto-pick
/dat/request # request touch directory
eri # my system code
/dat/log/request-lpr # log file
#
# list of remote data servers follows.
# local (my) server may be included, but it will not be used.
#<sys> <station list> <printcap entry of data server>
tky /dat/etc/tky.station request-saemon
sso /dat/etc/sso.station request-sso-jc3
データの切り出しのために events は wed(1W) を、eventsrtape は rtape(1W) を、
それぞれ使います。eventsrtape は events へのリンクです。
オプション
- -f
-
tape_device
で指定されるテープ装置の連続記録データからイベントの切り出しを
行ないます。省略すると /dev/nrst0 が仮定されます。
- -x
-
トリガーリスト中で、地域名
area
で最初にトリガーのかかったイベントについては切り出しを行ないません。
このオプションは複数指定することができます。
ソース
- `events.c'
-
関連事項
winformat(1W), pmon(1W), wtape(1W), rtape(1W), wed(1W), autopick(1W),
automan(1W)
Index
- 名称
-
- 形式
-
- 解説
-
- オプション
-
- ソース
-
- 関連事項
-