JP1/Automatic Job Management System 2 コマンドリファレンス

jpqjobmove

形式

 
jpqjobmove
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     {-dq 移動先キュー名|{-p+|-p-} 実行順}
     -j ジョブ番号
 

機能

キュー内のジョブを移動します。

移動には次に示す制限があります。

• 移動できるのは，実行中，および終了状態以外のジョブだけ。
• ジョブの移動先として指定できるキューは，移動元と同じマネージャーホスト内のキューだけ。
• デフォルトキューのジョブの場合
  
  • キュー間の移動はできない。
  • デフォルトキュー内で，ジョブの実行順を任意に指定できる。
• デフォルトキュー以外のキューのジョブの場合
  
  • 移動先にデフォルトキューは指定できない。
  • 移動元と移動先のキューが同じ場合で，かつ，移動先キューの名称を指定した場合は，ジョブの実行順は末尾になる。
  • 移動元と移動先のキューが同じ場合で，かつ，ジョブの実行順を指定した場合は，実行順を任意に指定できる。
  • 移動元と移動先のキューが異なる場合は，ジョブの実行順は末尾になる。
• ジョブネットから登録したQUEUEジョブの場合
  
  • キュー間の移動はできない。
• サブミットジョブのうちJpqSetReport関数を使用してジョブの状態をポーリング監視している場合
  
  • キュー間の移動はできない。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

• JP1_JPQ_Admin権限
• JP1_JPQ_Operator権限
• JP1_JPQ_User権限（キュー間のジョブの移動だけ操作可）

引数

-mh マネージャーホスト名

移動したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

移動したいジョブをサブミットしたキュー名を指定します。デフォルトキュー以外のキュー内のジョブの実行順を変更したい場合，およびジョブをキュー間で移動したい場合は，このオプションを指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

移動したいジョブをサブミットしたエージェントホスト名を指定します。デフォルトキュー内のジョブの実行順を変更したい場合は，このオプションを指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，-dqオプションと同時には指定できません。

-dq 移動先キュー名

ジョブ移動先のキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

このオプションは，-ahオプションと同時には指定できません。

-p+，-p-オプションと同時には指定できません。

{-p+|-p-} 実行順

キュー内でのジョブの実行順を指定します。

• -p+
  ジョブの実行順を前方向に移動します。
  
• -p-
  ジョブの実行順を後方向に移動します。
  
• 実行順
  ジョブの実行順を，現時点の実行順からの相対順で指定します（例えば，現在の実行順が5で，実行順を3に変更したい場合は，「-p+ 2」と指定します）。
  

なお，実行順として指定した値だけのジョブがキューにない場合，「-p+」を指定した場合はキューの先頭に，「-p-」を指定した場合はキューの末尾に移動されます（例えば，「-p+ 5」と指定したにもかかわらず，キュー内のジョブ数が5未満であった場合は，実行順1として扱われます）。

このオプションは，-dqオプションと同時には指定できません。

-j ジョブ番号

移動したいジョブのジョブ番号を指定します。

ジョブ番号は，jpqjobshowコマンドで確認できます。

なお，ジョブ番号は，1〜999999の範囲で指定してください。

注意事項

このコマンドは，JP1/NQSEXECおよびJP1/OJE for VOS3との連携には使用できません。

戻り値

0	正常終了。
1	引数の指定が不適切である。
2	ジョブの移動依頼側の内部的要因で，ジョブの移動に失敗した。
5	初期化に失敗した。 論理ホスト名の定義または環境設定に誤りがある。
6	ジョブの移動依頼側でメモリー不足が発生した。
7	ジョブの移動依頼側で論理不正が発生した。
100	TCP/IP通信でマネージャーホストに接続できない。 TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。 マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。
102	マネージャーホスト名によるIPアドレスの解決に失敗した。
200	マネージャーホストがジョブの移動を受け付けない。 マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。
201	指定したキューが使用できない。 指定したキューがない。
202	マネージャーホストから応答がない。
203	マネージャーホスト側の内部的要因で，ジョブの移動に失敗した。
206	ジョブを移動する権限がない。
207	移動するジョブがない。 指定したジョブがデータベース上にない。 指定したジョブは実行が終了している。
208	指定したジョブの実行はすでに開始している。
209	移動先として指定したキューがない。
210	移動先として指定したキューはサブミットジョブ数がすでに最大値に達しているため，ジョブを移動できない。
219	マネージャーホストがビジー状態である。
220	マネージャーホスト側でメモリー不足が発生した。
222	致命的なエラーが発生した。 システムコールでエラーが発生した。
223	マネージャーホスト側で論理不正が発生した。
224	JP1/AJS2以外のホストに要求した。
226	実行環境が不適切である。

[目次][前へ][次へ]

Copyright (C) 2006, 2010, Hitachi, Ltd.
Copyright (C) 2006, 2010, Hitachi Software Engineering Co., Ltd.