4.23 dcmsusp.exe(ファイル転送の中断と再開)

ファイル転送を中断または再開するdcmsuspコマンドについて説明します。このコマンドは,JP1/NETM/DM Managerの配布管理システムで実行できます。

<この節の構成>
(1) 機能
(2) 形式
(3) 引数
(4) パラメタファイルの指定内容とコマンド引数との対応
(5) リターンコード
(6) 注意事項

(1) 機能

ローカルホスト上の配布管理システムに接続し,指定した中継するシステムとその直下のシステム間のファイル転送を中断,再開します。また,接続先の配布管理システムとその直下のシステム間のファイル転送を中断,再開します。

(2) 形式

dcmsusp.exe [処理キー] [/s] /i パラメタファイル1 [パラメタファイル2]
           [/o 結果出力ファイル名] [/LC {ON|OFF}]

(3) 引数

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

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

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

パラメタファイルの指定内容内容指定の有無コマンドの引数
タグパラメタ
JOB_ATTRIBUTEjob_generatorジョブ名称※1/j 値
jobnoジョブ番号×
job_folderジョブ格納フォルダパス/l 値
unsuspended中断中の配布の有無×
JOB_DESTINATIONgroupあて先グループ名※2/g 値
host_nameホスト名※2/h 値
lower_clientsすべてのあて先指定の有無×
JOB_DESTINATION_IDdestination_idID名※2/X 値
JOB_SCHEDULEjob_entry_dateジョブの登録日時/jst 値
job_execution_dateジョブの実行日時/jsx 値
job_expiration_dateジョブの実行期限/jsp 値
(凡例)
◎:必ず指定する ○:省略できる ×:不要(指定しても無視される)
-:コマンドの引数では指定できない
注※1
job_generator(または/j)の指定を省略した場合,ジョブ名称として「処理キー+ジョブの実行日時」が自動的に設定されます。このため,同じ処理キーのコマンドを同時に複数実行すると,ジョブ名称が重複しジョブが正しく実行されないことがあります。同じ処理キーのコマンドを同時に複数実行する場合は,job_generator(または/j)で,異なるジョブ名称を指定することをお勧めします。
注※2
JOB_DESTINATIONとJOB_DESTINATION_ID,/gおよび/hと/Xは,同時に指定できません。どちらかを必ず指定してください。groupとhost_name(/gと/h)は片方だけでも,両方同時に指定してもかまいません。

(5) リターンコード

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

コード意味対処
0配布管理システムがジョブを開始した。または,配布管理システム自身の中断状態を変更した。なし。
1パラメタファイルをオープンできない,またはファイル形式に誤りがある。パラメタファイルの指定または記述形式を確認してください。
2コマンドの引数またはパラメタファイルに不正な値が設定されている。コマンドの引数またはパラメタファイルの設定値を確認してください。
3配布管理システムへの接続でエラーが発生した。配布管理システムのバージョンを確認してください。
4結果出力ファイルをオープンできない。結果出力ファイルの指定を確認してください。
5クライアント,配布管理システム間の通信に失敗した。配布管理システムのセットアップで,通信環境の設定を確認してください。
12そのほかのエラーが発生した。イベントログを参照してください。
システムエラー,コマンドの引数の文法不正,または接続先配布管理システムに定義されていない値がパラメタファイルに指定され処理が拒否された,などの原因が考えられます。

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

(6) 注意事項

JOB_DESTINATIONタグのhost_nameまたはコマンド引数の/hの指定時には,次のことに注意してください。

JOB_ATTRIBUTEタグのjob_folderまたはコマンド引数の/lの指定時には,次のことに注意してください。