パラメタファイルに指定されたジョブ定義を削除します。

dcmrmgen.exe /i パラメタファイル名 [/LC {ON|OFF}]

• /i
  パラメタファイルのフルパスを指定してください。
  dcminstコマンド（/s指定あり）の結果出力ファイルを，パラメタファイルとして使用することもできます。
  
• /LC
  タスクスケジューラやJP1/AJSを使用してコマンドをバックグラウンドサービスとして実行している場合にWindowsをログオフしても，コマンド処理を継続するかどうかを「ON」または「OFF」で指定します。
  
  • ON
    Windowsをログオフしても，コマンド処理を継続します。
    
  • OFF
    Windowsをログオフすると，コマンド処理を強制終了します。
    
  この引数は，次に示すOSでコマンドをサービスから実行した場合に，有効となります。
  
  • Windows NT 4.0
  • Windows 2000
  • Windows XP
  • Windows Server 2003（Windows Server 2003 (IPF)を除く）
  コマンドプロンプトからコマンドを実行する場合は，フォアグラウンドプログラムとして実行されるため，「/LC ON」を指定しないでください。
  Windowsをログオフしてもコマンド処理を継続するかどうかは，レジストリでも設定できます。レジストリでの設定については，次の個所を参照してください。
  
  • JP1/NETM/DM Managerで実行する場合
    マニュアル「構築ガイド」の「4.6　レジストリの設定（JP1/NETM/DM Manager）」
    
  • JP1/NETM/DM Client（中継システム）で実行する場合
    マニュアル「構築ガイド」の「5.4　レジストリの設定（JP1/NETM/DM Client（中継システム））」
    
  なお，/LCでの指定と，レジストリでの設定の組み合わせで，動作が異なります。詳細については，「4.28　レジストリ設定とログオフオプションによるログオフ時のコマンドの動作」を参照してください。
  

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

表4-17　パラメタファイルとコマンドの引数の対応（dcmrmgenコマンド）

パラメタファイルの指定内容		内容	指定の有無	コマンドの引数
タグ	パラメタ
JOB_ATTRIBUTE	job_generator※1	ジョブ名称	◎※2	/j
	jobno	ジョブ番号	×	−
	job_folder	ジョブ格納フォルダパス	◎※2	/f
	unsuspended	中断中の配布の有無	×	−

（凡例）

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

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

注※1

複数のジョブ名称を指定する場合は，ジョブ名称を「;」で区切ってください。

注※2

パラメタファイルの指定では，job_generatorおよびjob_folderのどちらかまたは両方を指定します。

job_generatorおよびjob_folderの両方が指定された場合は，指定したフォルダ下を検索し，最初に検出したジョブ定義を削除します。

job_generatorだけを指定した場合は，ルートフォルダ下が検索対象となります。job_folderだけを指定した場合は，job_folderで指定したフォルダ下のすべてのジョブ定義を，フォルダごと削除します。

コマンド引数で指定する場合は，/jと/fの両方を指定する必要があります。

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

dcmrmgen.exe /j ジョブ名称 /f ジョブ格納フォルダパス [/LC {ON|OFF}]
　

「/j ジョブ名称」に複数のジョブ名称を指定する場合は，ジョブ名称を「;」で区切ってください。

/j（ジョブ名称）と/f（ジョブ格納フォルダパス）は必ず両方指定してください。両方を指定しないとエラーになります。

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

コード	意味	対処
0	ジョブが削除された，または指定されたジョブがない。	なし。
1	パラメタファイルをオープンできない，またはファイル形式が不正。	パラメタファイルの指定または記述形式を確認してください。
2	パラメタファイルに不正な値が指定されている。	パラメタファイルの値を確認してください。
3	配布管理システムへの接続でエラーが発生した。	配布管理システムのバージョンを確認してください。
12	そのほかのエラーが発生した。	イベントログを参照してください。

また，JP1/Baseと連携してJP1/NETM/DMのユーザを管理している場合は，「1.3.3　コマンドを実行するための設定」も合わせて参照してください。

ルートフォルダだけを指定して，すべてのジョブ格納フォルダとジョブ定義を一括して削除することはできません。

配布管理システムのフォルダ「バッチ定義」に保存されている「伝票ファイル0001収集」という名称のジョブを削除する例を次に示します。

(a)　パラメタファイルの作成

削除するジョブ定義が保存されているフォルダ，およびジョブ名称をパラメタファイルに次のように定義し，任意の名称で保存します。

** dcmjexe Parameter File Sample
 
JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
job_folder= \バッチ定義
} 

(b)　コマンドの実行

パラメタファイルをC:\Dmbat\dcmjexe.txtに保存した場合，コマンドは次のように実行してください。

dcmrmgen.exe /i C:\Dmbat\dcmjexe.txt