JP1/NETM/DM 運用ガイド2 (Windows(R)用)
インベントリ情報をCSV形式ファイルまたはパラメタファイル形式で出力するdcmcsvuコマンドについて説明します。
ローカルホスト上の配布管理システムに接続し,その時点のインベントリ情報をCSV形式ファイルまたはパラメタファイルの形式で出力します。また,JP1/NETM/DM未導入ホストの検出結果,およびネットワーク上のホストの探索結果をCSV形式ファイルで出力することもできます。なお,UnicodeのCSV形式ファイルで出力することもできます。ただし,UnicodeのCSV形式ファイルのエンコーディングはUTF-8だけです。
出力する情報は,JP1/NETM/DMが提供するテンプレートを使って指定します。インベントリ情報を出力するテンプレートは,CSV出力ユティリティで使用するテンプレートと同じです。指定したテンプレートに含まれる項目(テンプレート中の列)について,情報が出力されます。また,パラメタファイルを使用した場合は,出力項目の詳細設定や出力内容の絞り込みもできます。
なお,JP1/NETM/DM未導入ホストの情報を出力する場合,検出対象外に指定されているホストの情報は出力できません。
dcmcsvu.exe /i パラメタファイル名 /o 結果出力ファイル名 [/LC {ON|OFF}]
このコマンドで使用するパラメタファイルの内容のうち,出力に使用するテンプレートと出力ファイルの形式は,コマンドの引数でも指定できます。パラメタファイルの指定内容と,コマンドの引数との対応を次の表に示します。
表4-8 パラメタファイルの指定内容とコマンドの引数の対応(dcmcsvuコマンド)
パラメタファイルの指定内容 | 内容 | 指定の有無 | コマンドの引数 | |
---|---|---|---|---|
タグ | パラメタ | |||
OUTPUT_CONSTRAINTS | template | 出力に使用するテンプレート | ◎ | テンプレートキー |
format | 出力ファイルの形式 | ○※1 | /parまたは/csv | |
group_membership | 所属グループ | ○※2 | − | |
row | 出力したい項目(列) | ○※3 | − | |
condition | 比較条件 | ○ | − | |
unicode | UnicodeのCSV形式ファイル出力の有無 | ○※4※5 | /uniYまたは/uniN |
パラメタファイルを指定しないで引数だけで指定する場合の,コマンドの形式を次に示します。
dcmcsvu.exe テンプレートキー [/par|/csv] [/uniY|/uniN] /o 結果出力ファイル名 [/LC {ON|OFF}]
指定できるテンプレートキーについては,「4.26.14 OUTPUT_CONSTRAINTS(出力する情報の設定)」の「表4-23 出力ファイル形式と指定できるテンプレート」を参照してください。各テンプレートで出力できる項目は,CSV出力ユティリティを使ってCSV形式ファイルを出力する場合と同じです。出力される項目の詳細については,マニュアル「運用ガイド1」の「9.1.1 CSV形式ファイルに出力できる項目」を参照してください。
出力ファイルの形式は,パラメタファイルでは,format=par(またはcsv)と指定しますが,コマンド引数の場合はdcmcsvu.exe /par(または/csv)と最初に「/」(スラッシュ)を付けて指定するので,注意してください。
UnicodeのCSV形式ファイルの出力は,パラメタファイルでは,unicode=Y(またはN)と指定しますが,コマンド引数の場合はdcmcsvu.exe /uniY(または/uniN)となりますので,注意してください。
なお,コマンド引数を使った場合は,出力項目の詳細設定や出力内容の絞り込みはできません。
dcmcsvuコマンド実行時のリターンコードを次の表に示します。
コード | 意味 | 対処 |
---|---|---|
0 | 出力が成功した。 | なし。 |
1 | パラメタファイルをオープンできない,またはファイル形式に誤りがある。 | ファイルのパスまたはファイルの形式を確認してください。 |
2 | コマンドの引数またはパラメタファイルに不正な値が指定されている。 | コマンドの引数またはパラメタファイルの設定値を確認してください。 |
3 | 配布管理システムへの接続またはアクセス時にエラーが発生した。 | 配布管理システム,データベースサーバが動作しているか,またはその設定に誤りがないか確認してください。 |
4 | 結果出力ファイルをオープンできない。 | 結果出力ファイルの状態を確認してください。結果出力ファイルがすでにほかのアプリケーションによって開かれているか,容量不足のおそれがあります。 |
5 | 動作環境が不正である。 | 配布管理システムまたはデータベースサーバの動作環境に誤りがないか確認してください。 |
10 | /parを指定している場合で,該当するデータが多過ぎてパラメタファイルに記述できる行数を超えたため,出力に失敗した。 | 該当データの内容を確認し,出力する情報の絞り込みをしてください。 |
11 | 該当するデータがない。出力ファイルを作成しない。 | なし。 |
12 | そのほかのエラーが発生した。 | イベントログを参照してください。 |
また,JP1/Baseと連携してJP1/NETM/DMのユーザを管理している場合は,「1.3.3 コマンドを実行するための設定」も合わせて参照してください。
転送されたジョブの「実行状態」が「インストール/収集待ち」で,「ジョブあて先名」が「dmp4*」であるホストのジョブ実行状況の情報を,パラメタファイル形式でJOB_DESTINATIONタグに出力する例を次に示します。
パラメタファイルを次のように作成し,任意の名称で保存します。
OUTPUT_CONSTRAINTS{ template = J_STAT condition = result=インストール/収集待ち AND dstname = dmp4* ; }
「インストール/収集待ち」の実行状態は,「ステータス」項目を使っても同様に絞り込めます。「ステータス」で絞り込む場合は,保守コードの左から6けたを「status=2000B0」のように指定してください。
作成したパラメタファイルをC:\temp\in.txtに保存し,結果出力ファイルをC:\temp\parmjob.txtに取得する場合は,次のように指定します。
dcmcsvu.exe /i C:\temp\in.txt /o C:\temp\parmjob.txt /par
コマンドが正常終了すると,パラメタファイル形式のJOB_DESTINATIONタグの情報がC:\temp\parmjob.txtに次のように出力されます。
JOB_DESTINATION { host_name = dmp410; dmp4200; dmp4system }
転送されたジョブの実行状態が「インストール/収集待ち」で,「ジョブあて先名」が「dmp4*」であるホストについて,「ジョブ名称」,「サーバ側実行日時」,および「ジョブあて先名」の情報だけをCSV形式ファイルに出力する例を次に示します。この例では,ジョブの実行状態を絞り込むのに,「実行状態」項目ではなく「ステータス」項目を使っています。
パラメタファイルを次のように作成し,任意の名称で保存します。
OUTPUT_CONSTRAINTS{ template = J_STAT row = jname; execdate; dstname condition = status=2000B0 AND dstname = dmp4*; }
作成したパラメタファイルをC:\temp\in.txtに保存し,結果出力ファイルをC:\temp\jobout.csvに取得する場合は,次のように指定します。
dcmcsvu.exe /i C:\temp\in.txt /csv /o C:\temp\jobout.csv
「実メモリ容量」が256メガバイト以上で,あて先グループAまたはあて先グループBに属するホストのシステム情報を,CSV形式ファイルに出力する例を次に示します。
パラメタファイルを次のように作成し,任意の名称で保存します。
OUTPUT_CONSTRAINTS{ template = SYS_INFO condition = ram>=256; group_membership = \A;\B; }
作成したパラメタファイルをC:\temp\in.txtに保存し,結果出力ファイルをC:\temp\system.csvに取得する場合は,次のように指定します。
dcmcsvu.exe /i C:\temp\in.txt /csv /o C:\temp\system.csv
「パッケージ名称」が「*OFFICE」で,「新バージョン」の一けた目の値が6以下のパッケージがインストールされているホストについて,インストール済みパッケージ情報をCSV形式ファイルに出力する例を次に示します。
パラメタファイルを次のように作成し,任意の名称で保存します。
OUTPUT_CONSTRAINTS{ template = INSTLD_PKG condition = pname = *OFFICE; condition = newver < 6; }
作成したパラメタファイルをC:\temp\in.txtに保存し,結果出力ファイルをC:\temp\inspack.csvに取得する場合は,次のように指定します。
dcmcsvu.exe /i C:\temp\in.txt /csv /o C:\temp\inspack.csv
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.
Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated.