jpqjobshow
形式
jpqjobshow [-mh マネージャーホスト名] {-q キュー名|-ah エージェントホスト名} [-u 所有者名] -s {e|h|w|s|r}
機能
未終了ジョブ情報(ジョブ番号,ジョブ名,ジョブ状態など)の一覧を標準出力ファイルに出力します。
JP1/NQSEXECホスト,およびJP1/OJE for VOS3ホストのジョブ情報も出力できます。
また,AS/400システムのジョブ情報も出力できます。AS/400システムに対して指定できるのは,-mh,-q,-u,-sオプションだけです。
このコマンドで操作対象となるジョブは次のとおりです。
- データベースが標準構成の場合
-
サブミットジョブ,QUEUEジョブ
- データベースが標準構成(ISAMレス構成)の場合
-
なし
- データベースが互換用ISAM構成の場合
-
PCジョブ(キューレスジョブを除く),UNIXジョブ(キューレスジョブを除く),アクションジョブ,カスタムジョブ,サブミットジョブ,QUEUEジョブ
実行権限
次に示すJP1権限レベルのどれかを与えられたユーザー
-
JP1_JPQ_Admin権限
-
JP1_JPQ_Operator権限
-
JP1_JPQ_User権限(ユーザー自身が所有するジョブだけ操作可)
引数
-mh マネージャーホスト名
ジョブ情報を出力したいジョブをサブミットしたマネージャーホスト名を指定します。
指定できる文字数は,1〜255(単位:バイト)です。
省略した場合,自ホスト名が仮定されます。
-q キュー名
ジョブ情報を出力したいジョブをサブミットしたキュー名を指定します。
指定できる文字数は,1〜63(単位:バイト)です。
-ah エージェントホスト名
ジョブ情報を出力したいジョブをサブミットしたエージェントホスト名を指定します。
指定できる文字数は,1〜255(単位:バイト)です。
このオプションは,JP1/AJS3からJP1/NQSEXECおよびJP1/OJE for VOS3への要求には指定できません。
-u 所有者名
そのユーザーがサブミットしたジョブのジョブ情報を出力したい場合に,ジョブの所有者名を指定します。
指定できる文字数は,1〜63(単位:バイト)です。
省略した場合,JP1_JPQ_Admin権限またはJP1_JPQ_Operator権限を持つユーザーがこのコマンドを実行している場合はすべてのユーザーが,JP1_JPQ_User権限を持つユーザーが実行しているときは,自ユーザーが仮定されます。
-s {e|h|w|s|r}
特定の状態のジョブの情報を出力します。状態は複数指定できます。
-
e
実行中ジョブの情報を出力します。
-
h
保留ジョブの情報を出力します。
-
w
実行待ちジョブの情報を出力します。
-
s
時間待ちジョブの情報を出力します。
-
r
配送中ジョブの情報を出力します。※
- 注※
-
「配送中」は,JP1/NQSEXECシステム上のジョブの状態です。
JP1/AJS3だけで構成されているシステムの場合,「配送中」の状態が出力されることはありません。
-qオプションにJP1/NQSEXECだけで使用しているキュー名を指定した場合,「配送中」の状態が出力されることがあります。
注意事項
各出力項目に対して,出力できるバイト数が決まっています。出力項目の内容が出力制限値を超えると,内容の末尾は「..」になります(例えば,ジョブ名の出力制限値は26バイトです。ジョブ名が27バイト以上の場合,25バイト以降は「..」になります)。
各出力項目に対してすべての内容を出力したい場合は,jpqjobgetコマンドを利用してください。
戻り値
0 |
正常終了。 |
1 |
引数の指定が不適切である。 |
2 |
未終了ジョブ情報の出力依頼側の内部的要因で,未終了ジョブ情報の出力に失敗した。 |
5 |
初期化に失敗した。
|
6 |
未終了ジョブ情報の出力依頼側でメモリー不足が発生した。 |
7 |
未終了ジョブ情報の出力依頼側で論理不正が発生した。 |
100 |
TCP/IP通信でマネージャーホストに接続できない。
|
102 |
マネージャーホスト名によるIPアドレスの解決に失敗した。 |
200 |
マネージャーホストが未終了ジョブ情報の出力を受け付けない。
|
201 |
指定したキューが使用できない。
|
202 |
マネージャーホストから応答がない。 |
203 |
マネージャーホスト側の内部的要因で,未終了ジョブ情報の出力に失敗した。 |
206 |
未終了ジョブ情報を出力する権限がない。 |
207 |
指定したジョブがない。
|
219 |
マネージャーホストがビジー状態である。 |
220 |
マネージャーホスト側でメモリー不足が発生した。 |
222 |
致命的なエラーが発生した。
|
223 |
マネージャーホスト側で論理不正が発生した。 |
224 |
サポートしていないホストに未終了ジョブ情報の出力を依頼した。 |
226 |
実行環境が不適切である。 |
出力例
ファイル出力例と出力内容の意味を次に示します。
出力内容の意味を次に示します。
- JOBID
-
ジョブ番号を示します。
- JOBNAME
-
ジョブ名を示します。
26バイト分出力されます。
QUEUEジョブまたはjpqjobsubコマンドでジョブ名を指定している場合はそのジョブ名を設定し,省略した場合は実行ファイル名を設定します。
また,ジョブネットでPCジョブを定義した場合は,実行ファイル名を設定します。ジョブネットでUNIXジョブを定義した場合は,スクリプトファイル名を設定します。スクリプトファイル名を省略してコマンド文で指定した場合は,ジョブ名に「script_job」を設定します。
アクションジョブの場合は,各アクションジョブで実行する固定の実行ファイル名をジョブ名として設定します。なお,実行ファイル名の場合,パス情報を除いたファイル名部分の先頭から63バイト分までの文字列をジョブ名として設定し,そのうち先頭から26バイト分までを表示します。
- T
-
キュー種別を示します。
-
q:キュー
-
a:エージェントホスト
-
- QUEUE
-
キュー名(または,エージェントホスト名)を示します。
27バイト分出力されます。
- STATUS
-
ジョブの状態を示します。
-
EXECUTING:実行中
-
HOLDING:保留
-
WAITING:実行待ち
-
SCHEDULED:時間待ち
-
ROUTING:配送中※
- 注※
-
「配送中」は,JP1/NQSEXECシステム上のジョブの状態です。
JP1/AJS3だけで構成されているシステムの場合,「配送中」の状態が出力されることはありません。
-qオプションにJP1/NQSEXECだけで使用しているキュー名を指定した場合,「配送中」の状態が出力されることがあります。
-