Hitachi

JP1 Version 12　JP1/IT Desktop Management 2 配布機能 運用ガイド

14.4　dcmcoll.exe（ファイルの収集）

ファイルを収集するdcmcollコマンドについて説明します。

このコマンドで実行したジョブは、配布管理システムの［ジョブ実行状況］ウィンドウで実行結果を確認できます。

機能

次に示す、リモートコレクトに関連するジョブを作成、実行します。

また、収集したアーカイブファイルを復元します。

形式

dcmcoll.exe [処理キー] [/G] [/Z] [/s]
            /i パラメタファイル1 [パラメタファイル2]
            [/o 結果出力ファイル名]

引数

パラメタファイルの指定内容とコマンド引数との対応

このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することもできます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

表14‒4　パラメタファイルとコマンドの引数の対応（dcmcollコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_DESTINATION

group

あて先グループ名

◎※1

/g 値

host_name

ホスト名

◎※1

/h 値

JOB_DESTINATION_ID

destination_id

ID名

◎※1

/X 値

FILE_COLLECTION

source_path

収集ファイル名

◎※2

/y 値

dmz_path

収集後の格納先フォルダ（収集時）、または復元対象ファイル/フォルダ（復元時）

◎※3

/z 値

unarc_path

復元後の格納先フォルダ

◎※4

/r 値

JOB_ATTRIBUTE

job_generator

ジョブ名称

○※5

/j 値

jobno

ジョブ番号

×

−

job_folder

ジョブ格納フォルダパス

○

/l 値

unsuspended

中断中の配布の有無

×

−

JOB_SCHEDULE

job_entry_date

ジョブの登録日時

○※6

/jst 値

job_execution_date

ジョブの実行日時

○※6

/jsx 値

job_expiration_date

ジョブの実行期限

○※6

/jsp 値

SCHEDULE

expiration_date

中継でのパッケージ保管期限

×

−

expiration_days

中継でのパッケージ保管日数

×

−

installation_date_and_time

インストール日時

×

−

installation_timing

インストール（収集）タイミング

○

/tSまたは/tN

OPTION

compress

圧縮の有無

○

/uYまたは/uN

restore

バージョンアップ時のリストア対象の有無

×

−

reboot

インストール後のコンピュータ再起動

×

−

processing_dialog

インストール時の処理中ダイアログの表示

×

−

USER_PROGRAM_INSTALLATION_CONDITIONS

external_program_executed_before_installation

インストール（収集）前起動外部プログラム

○

/b 値

external_program_executed_after_installation

インストール（収集）後起動外部プログラム

○

/a 値

external_program_error_handler

インストール（収集）エラー時起動外部プログラム

○※7

/e 値

external_program_handler

起動外部プログラム

×

−

exit

外部プログラム処理結果の通知方式

×

−

action

処理結果エラー時の取り扱い

×

−

wait

監視方式

×

−

timeout

監視時間

×

−

wait_code

監視コード

×

−
（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※1

JOB_DESTINATIONとJOB_DESTINATION_IDは同時に指定できません。また、/gおよび/hは/Xと同時に指定できません。必ずどちらかを指定してください。

なお、処理キーが「NETM_COLTOM」または「NETM_COLRESET」の場合は、あて先として指定できるIDは、ID管理元中継として登録されたIDだけです。

処理キーが「NETM_UNARC」の場合は、指定しても無視されます。

注※2

処理キーが「NETM_COLLECT」および「NETM_COLTOS」の場合に必ず指定してください。

注※3

処理キーが「NETM_COLLECT」、「NETM_COLTOS」、および「NETM_UNARC」の場合に必ず指定してください。

注※4

処理キーが「NETM_UNARC」の場合に必ず指定してください。

注※5

job_generator（または/j）の指定を省略した場合、ジョブ名称として「処理キー＋ジョブの実行日時」が自動的に設定されます。このため、同じ処理キーのコマンドを同時に複数実行すると、ジョブ名称が重複しジョブが正しく実行されないことがあります。同じ処理キーのコマンドを同時に複数実行する場合は、job_generator（または/j）で、異なるジョブ名称を指定することをお勧めします。

注※6

処理キーが「NETM_UNARC」の場合は、指定しても無視されます。

注※7

UNIXのコンピュータからファイルを収集する場合は指定できません。

パラメタファイルを使用しない場合のコマンド形式

パラメタファイルを使用しないで引数だけで指定する場合の、コマンドの形式を次に示します。

管理対象のコンピュータからファイルを収集する場合
dcmcoll.exe {[NETM_COLLECT]|NETM_COLTOS} [/s]
            {[/g あて先グループ名] [/h ホスト名]|/X ID名}
            /y 収集ファイル名 /z 収集ファイル格納フォルダパス
            [/j ジョブ名称] [/l ジョブ格納フォルダパス]
            [/jst ジョブの登録日時] [/jsx ジョブの実行日時]
            [/jsp ジョブの実行期限]
            [{/tS|/tN}] [ {/uY|/uN}]
            [/b ファイル収集前起動外部プログラム]
            [/a ファイル収集後起動外部プログラム]
            [/e ファイル収集エラー時起動外部プログラム]
            /o 結果出力ファイル名
中継システムおよび管理用中継サーバからコレクトファイルを収集する、または中継システムおよび管理用中継サーバ上のコレクトファイルを削除する場合
dcmcoll.exe {NETM_COLTOM|NETM_COLRESET} [/s]
            {[/g あて先グループ名] [/h ホスト名]|/X ID名}
            [/j ジョブ名称] [/l ジョブ格納フォルダパス]
            [/jst ジョブの登録日時] [/jsx ジョブの実行日時]
            [/jsp ジョブの実行期限]
            /o 結果出力ファイル名
ファイルを復元する場合
dcmcoll.exe NETM_UNARC [/G] [/Z]
            /z 復元対象ファイルまたはフォルダ
            /r 復元後の格納先

リターンコード

dcmcollコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

配布管理システムがジョブを開始した。

または、アーカイブファイルの復元が正常終了した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式に誤りがある。

パラメタファイルの指定または記述形式を確認してください。

2

コマンドの引数またはパラメタファイルに不正な値が指定されている。

コマンドの引数またはパラメタファイルの設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

結果出力ファイルをオープンできない。

結果出力ファイルの指定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

7

1つ以上のアーカイブファイルの復元に失敗した。

アーカイブファイルのパスを確認してください。

復元ファイルのフルパス（「復元後の格納先ディレクトリ」+「作成ディレクトリ」（「アーカイブファイルの格納先ディレクトリ」）+「復元後のファイル名またはディレクトリ名」）が半角259文字を超えているおそれがあります。

12

そのほかのエラーが発生した。

イベントログを参照してください。

注意事項

実行例

JP1/IT Desktop Management 2 - Agent（エージェント）が稼働するホストdmp491およびdmp492から、C:\temp下のディレクトリ「SD障害.dir」、「SD障害2.dir」、および「SD障害3.dir」のファイルを収集する例を次に示します。管理対象のコンピュータの起動を契機に収集を開始し、収集前、収集後、および収集エラー時に外部プログラムを起動するよう指定しています。

パラメタファイルの作成

ホストと収集ファイルの属性をパラメタファイルに次のように記述し、パラメタファイルを任意の名称で保存します。

** dcmcoll Parameter File Sample
 
JOB_DESTINATION{
host_name=dmp492.soft.hitachi.co.jp
host_name=dmp491
group = \grp\gname1
group = \grp\gname2;\grp\gname3
}
SCHEDULE{
installation_timing = S
}
OPTION{
compress=Y
}
USER_PROGRAM_INSTALLATION_CONDITIONS{
external_program_executed_before_installation = "C:\test B.exe"
external_program_executed_after_installation = C:\testA.exe -x "a aa"
external_program_error_handler = "C:\test E.exe"
}
FILE_COLLECTION{
source_path= C:\temp\SD障害.dir
source_path= C:\temp\SD障害2.dir;C:\temp\SD障害3.dir
dmz_path= C:\temp\収集
}
コマンドの実行

作成したパラメタファイルをC:\Dmbat\dcmcoll.txtに保存し、結果出力ファイルをC:\Dmbat\out.txtに取得する場合は、次のように指定します。 

dcmcoll.exe /i C:\Dmbat\dcmcoll.txt /o C:\Dmbat\out.txt /j temp収集
結果出力ファイルの確認

コマンドが正常終了すると、ジョブのジョブ名称、ジョブ番号、ジョブ格納フォルダパスが、C:\Dmbat\out.txtに次のように出力されます。 

JOB_ATTRIBUTE{
job_generator= NETM_COLLECT_03_12_11_13_34_36
jobno= JB03121113315383
job_folder= \
}

ページの先頭へ

Copyright (C) 2019, 2022, Hitachi, Ltd.

Copyright (C) 2019, 2022, Hitachi Solutions, Ltd.

Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated.