4.18 dcmrmgen.exe(ジョブ定義の削除)

ジョブ定義を削除するdcmrmgenコマンドについて説明します。このコマンドは,JP1/NETM/DM ManagerおよびJP1/NETM/DM Client(中継システム)の配布管理システムで実行できます。

<この節の構成>
(1) 機能
(2) 形式
(3) 引数
(4) パラメタファイルの指定内容とコマンド引数との対応
(5) パラメタファイルを使用しない場合のコマンド形式
(6) リターンコード
(7) 注意事項
(8) 実行例

(1) 機能

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

(2) 形式

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

(3) 引数

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

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

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

パラメタファイルの指定内容内容指定の有無コマンドの引数
タグパラメタ
JOB_ATTRIBUTEjob_generator1ジョブ名称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の両方を指定する必要があります。

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

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

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

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

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

(6) リターンコード

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

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

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

(7) 注意事項

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

(8) 実行例

配布管理システムのフォルダ「バッチ定義」に保存されている「伝票ファイル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