14.14 dcmrtry.exe(ジョブの再実行)
ジョブを再実行するdcmrtryコマンドについて説明します。
機能
配布管理システムで、パラメタファイルに指定されたジョブを再実行します。
形式
dcmrtry.exe [再実行対象キー] /i パラメタファイル名 /o 結果出力ファイル名
引数
-
再実行対象キー
再実行するジョブの実行状態を指定します。キーは、コマンド名の直後に指定してください。「ERROR」、「WAIT」、および「PENDING」は、任意に組み合わせて指定できます。組み合わせて指定する場合は、キーとキーの間をスペースで区切ってください。省略した場合は「ERROR」が仮定されます。
-
ERROR
エラーになったジョブを再実行します。
-
WAIT
実行待ちのジョブを再実行します。
-
PENDING
一時的に通信エラーになったジョブを再実行します。
-
-
/i
パラメタファイルのフルパスを指定してください。
dcmcollコマンド(/s指定なし)、dcminstコマンド(/s指定なし)、dcmjexeコマンド、またはdcmsuspコマンド(/s指定なし)の結果出力ファイルを、パラメタファイルとして使用することもできます。
-
/o
結果出力ファイルのフルパスを指定してください。コマンドが正常終了すると、結果出力ファイルには指定したパラメタファイルと同じ内容が出力されます。
パラメタファイルの指定内容
dcmrtryコマンドでのパラメタファイルの指定内容を次の表に示します。このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することはできません。
パラメタファイルの指定内容 |
内容 |
指定の有無 |
コマンドの引数 |
|
---|---|---|---|---|
タグ |
パラメタ |
|||
job_generator |
ジョブ名称 |
× |
− |
|
jobno |
ジョブ番号 |
◎ |
− |
|
job_folder |
ジョブ格納フォルダパス |
× |
− |
|
unsuspended |
中断中の配布の有無 |
× |
− |
- (凡例)
-
◎:必ず指定する ×:不要(指定しても無視される)
−:コマンドの引数では指定できない
リターンコード
dcmrtryコマンド実行時のリターンコードを次の表に示します。
コード |
意味 |
対処 |
---|---|---|
0 |
ジョブの再実行が開始された。 |
なし。 |
1 |
パラメタファイルをオープンできない、またはファイル形式が不正。 |
パラメタファイルの指定または記述形式を確認してください。 |
2 |
パラメタファイルに不正な値が指定されている。 |
パラメタファイルの値を確認してください。 |
3 |
データベースの接続に失敗した。 |
配布管理システムのセットアップで、データベースの設定を確認してください。 |
4 |
結果出力ファイルをオープンできない。 |
結果出力ファイルの指定を確認してください。 |
5 |
JP1/IT Desktop Management 2のサービスの接続に失敗した。 |
JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。 |
12 |
そのほかのエラーが発生した。 |
イベントログを参照してください。 |
注意事項
-
パラメタファイルには、dcmcollコマンド(/s指定なし)、dcminstコマンド(/s指定なし)、dcmjexeコマンド、またはdcmsuspコマンド(/s指定なし)の結果出力ファイルに出力されたジョブ番号を指定してください。
-
再実行するジョブのジョブ番号が不明な場合、dcmrtryコマンドは実行できません。配布管理システムの[ジョブ実行状況]ウィンドウで、該当するジョブ名のジョブを再実行してください。
実行例
dcminstコマンドで実行したジョブのうち、実行待ちまたはエラーになったジョブを再実行する例を次に示します。
- パラメタファイルの作成
-
dcminstコマンドの結果出力ファイルに出力されたジョブ番号を、次のようにパラメタファイルに指定します。
なお、dcminstコマンドの結果出力ファイルが保存されている場合は、このファイルをパラメタファイルとして指定できます。
JOB_ATTRIBUTE{ job_generator= NETM_INSTALL_2003_12_11_13_34_36 jobno= JB03121113315383 job_folder= \ }
- コマンドの実行
-
dcminstコマンドを実行したときの、結果出力ファイルがC:\Dmbat\out.txtに保存されている場合、コマンドは次のように指定してください。
dcmrtry.exe WAIT ERROR /i C:\Dmbat\out.txt /o C:\temp\retryout.txt