名前
shunanalyze -- 集計処理
形式
shunanalyze | [-s analyze用動作環境ファイル] |
機能説明
入力データを任意のグループごとに演算、集計し、結果をCSVファイルまたはXML文書としてファイル出力します。
オプション
shunanalyzeコマンドに対する入力ファイルまたは出力ファイルなどを記述した動作環境ファイルを指定します。analyze用動作環境ファイルの内容については、“1.4.1 analyze用動作環境ファイル”を参照してください。
本パラメタを省略した場合には、analyze用動作環境ファイルのすべての実行パラメタに省略値が指定されたとみなします。
shunanalyzeコマンドが動作するにあたっての条件を記述した集計条件ファイルを指定します。集計条件ファイルの内容については、“1.4.2 集計条件ファイル”を参照してください。
各種定義ファイルの実行パラメタのパラメタ値に指定された可変項目を、本コマンドに指定した定義値で置き換えて処理します。
各種定義ファイルでは、置き換える可変項目をアットマーク(@)で括って記述します。
可変項目名を複数指定する場合は、半角空白で区切ってください。
注意
可変項目名は、最大128文字です。(@を含まない)
同一の可変項目名を指定することはできません。
可変項目名は、半角英数字(大文字または小文字)を使用してください。先頭文字は英字を使用してください。
定義値は、以下の文字コードで指定してください。下記以外の場合は、正常に動作しない場合があります。
ASCIIの文字の範囲
システムロケールの文字コードとデータの文字コードが同じ場合は、日本語（マルチバイト文字）
定義値に空文字を指定する場合は、「可変項目名=」だけで記載してください
可変項目名以外(例えば、条件式のキーワード)に「@文字列@」の文字を指定する場合は、可変項目名と重複しないように気をつけてください。
コマンドで指定された可変項目名が、各種定義ファイルに設定されていない場合、その可変項目は利用されずに処理が継続します。
定義ファイルに「@文字列@」が指定されているが、コマンドラインにその「文字列」が可変項目として指定されない場合は、定義ファイルの「@文字列@」は、可変項目と見なされずに、動作します。
バッチ(または、シェルスクリプト)中に可変項目を指定したコマンドを記述した場合に、OSまたは、実行シェルにおけるコマンドラインの文字制限により、可変項目の指定内容が途中で切られる場合があります。実行するOS、実行シェルの文字制限を確認して本機能を利用してください。
可変項目名に、シェルやコマンドプロンプトのメタ文字や制御文字を指定する場合、以下のようにエスケープや二重引用符(")で括る必要があります。
詳細は、シェルスクリプトやコマンドプロンプトのマニュアルを参照してください。
Windowsのコマンドプロンプトの場合
定義値に空白が含まれる場合は、二重引用符(")で括る必要があります。
定義値に二重引用符(")が含まれる場合は、エスケープする(\" と指定)必要があります。
二重引用符(")で囲っている場合に末尾に\を記載する場合、エスケープする(\\ と指定)必要があります。
Linux/Solarisのシェルスクリプトの場合
定義値に空白が含まれる場合は、二重引用符(")で囲う、または、エスケープする(\[空白]と指定)必要があります。
定義値に二重引用符(")が含まれる場合は、エスケープする(\" と指定)必要があります。
参照
可変項目名の指定例については、“導入・運用ガイド”の“可変項目の指定”を参照してください。
使用例
Windowsの場合
analyze用動作環境ファイル D:\Shunsaku\cfg\Analyze.cfg
集計条件ファイル D:\Shunsaku\cfg\AnaCond.cfg
shunanalyze -s D:\Shunsaku\cfg\Analyze.cfg
-a D:\Shunsaku\cfg\AnaCond.cfg |
または
shunanalyze -s "D:\Shunsaku\cfg\Analyze.cfg"
-a "D:\Shunsaku\cfg\AnaCond.cfg" |
注意
ディレクトリ名に空白を含む場合には必ず二重引用符(")で囲んでください。
Linux/Solarisの場合
analyze用動作環境ファイル /home/shunsaku/cfg/Analyze.cfg
集計条件ファイル /home/shunsaku/cfg/AnaCond.cfg
shunanalyze -s /home/shunsaku/cfg/Analyze.cfg
-a /home/shunsaku/cfg/AnaCond.cfg |
終了ステータス
以下の終了ステータスが返されます。
0:正常終了
2:警告
0、2以外:異常終了(エラー)
以下のいずれかの場合、終了ステータスとして「警告」が返されます。
集計項目間の数値演算で、オーバーフローが発生した場合
集計項目間の数値演算で、ゼロ除算が発生した場合
