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オプションだけです。

実行権限

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

引数

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

ジョブ情報を出力したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は,1~255(単位:バイト)です。

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

-q キュー名

ジョブ情報を出力したいジョブをサブミットしたキュー名を指定します。

指定できる文字数は,1~63(単位:バイト)です。

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

ジョブ情報を出力したいジョブをサブミットしたエージェントホスト名を指定します。

指定できる文字数は,1~255(単位:バイト)です。

このオプションは,JP1/NQSEXECおよびJP1/OJE for VOS3との連携時には指定できません。

-u 所有者名

そのユーザーがサブミットしたジョブのジョブ情報を出力したい場合に,ジョブの所有者名を指定します。

指定できる文字数は,1~63(単位:バイト)です。

省略した場合,JP1_JPQ_Admin権限またはJP1_JPQ_Operator権限を持つユーザーがこのコマンドを実行している場合はすべてのユーザーが,JP1_JPQ_User権限を持つユーザーが実行しているときは,自ユーザーが仮定されます。

-s {e|h|w|s|r}

特定の状態のジョブの情報を出力します。状態は複数指定できます。

注意事項

各出力項目に対して,出力できるバイト数が決まっています。出力項目の内容が出力制限値を超えると,内容の末尾は「..」になります(例えば,ジョブ名の出力制限値は26バイトです。ジョブ名が27バイト以上の場合,25バイト以降は「..」になります)。

各出力項目に対してすべての内容を出力したい場合は,jpqjobgetコマンドを利用してください。

戻り値

0正常終了。
1引数の指定が不適切である。
2未終了ジョブ情報の出力依頼側の内部的要因で,未終了ジョブ情報の出力に失敗した。
5初期化に失敗した。
  • 論理ホスト名の定義または環境設定に誤りがある。
6未終了ジョブ情報の出力依頼側でメモリー不足が発生した。
7未終了ジョブ情報の出力依頼側で論理不正が発生した。
100TCP/IP通信でマネージャーホストに接続できない。
  • 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/AJS2だけで構成されているシステムの場合,「配送中」の状態が出力されることはありません。
-qオプションにJP1/NQSEXECだけで使用しているキュー名を指定した場合,「配送中」の状態が出力されることがあります。