4.12 dcmjexe.exe(ジョブの実行)

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

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

(1) 機能

パラメタファイルに定義されたジョブを実行します。実行するジョブは,JOB_ATTRIBUTEタグで一つだけ指定できます。

(2) 形式

dcmjexe.exe /i パラメタファイル名 /o 結果出力ファイル名 [/LC {ON|OFF}]

(3) 引数

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

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

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

パラメタファイルの指定内容内容指定の有無コマンドの引数
タグパラメタ
JOB_ATTRIBUTEjob_generatorジョブ名称
jobnoジョブ番号×
job_folderジョブ格納フォルダパス
unsuspended中断中の配布の有無×
JOB_SCHEDULEjob_entry_dateジョブの登録日時/jst 値
job_execution_dateジョブの実行日時/jsx 値
job_expiration_dateジョブの実行期限/jsp 値
(凡例)
◎:必ず指定する ○:省略できる ×:不要(指定しても無視される)
-:コマンドの引数では指定できない
注※
省略した場合は,ルートフォルダ以下のすべてのフォルダまたはファイルを検索してジョブを実行します。

(5) パラメタファイルの内容を引数で指定した場合のコマンド形式

ジョブの登録日時,ジョブの実行日時,およびジョブの実行期限をコマンド引数で指定した場合のコマンドの形式を次に示します。

dcmjexe.exe /i パラメタファイル名 /o 結果出力ファイル名
          [/jst ジョブの登録日時] [/jsx ジョブの実行日時]
          [/jsp ジョブの実行期限] [/LC {ON|OFF}]

(6) リターンコード

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

コード意味対処
0配布管理システムがジョブを開始した。なし。
1パラメタファイルをオープンできない,またはファイル形式が不正。パラメタファイルの指定または記述形式を確認してください。
2パラメタファイルに不正な値が指定されている。パラメタファイルの値を確認してください。
3配布管理システムへの接続でエラーが発生した。配布管理システムのバージョンを確認してください。
4結果出力ファイルをオープンできない。
  • 結果出力ファイルの指定を確認してください。
  • ジョブが開始されている場合があります。ジョブの実行状況を確認してください。
5クライアント,配布管理システム間の通信に失敗した。配布管理システムのセットアップで,通信環境の設定を確認してください。
12そのほかのエラーが発生した。イベントログを参照してください。

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

(7) 実行例

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

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

実行するジョブが保存されているフォルダ,およびジョブ名をパラメタファイルに次のように記述し,パラメタファイルを任意の名称で保存します。

** dcmjexe Parameter File Sample

JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
job_folder= ¥バッチ定義
}

(b) コマンドの実行

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

dcmjexe.exe /i C:¥Dmbat¥dcmjexe.txt /o C:¥Dmbat¥out.txt

(c) 結果出力ファイルの内容

コマンドが正常終了すると,開始されたジョブのジョブ名称,ジョブ番号,およびジョブ格納フォルダパス(実行したジョブのフォルダ)がC:¥Dmbat¥out.txtに次のように出力されます。

JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
jobno= JB03121113315383
job_folder= ¥バッチ定義
}