Hitachi

uCosminexus Grid Processing Server 使用の手引


gpjobls(グリッドジョブおよびサブジョブ状態表示コマンド)

〈このページの構成〉

形式

gpjobls -a [-Z ] [-v ] [ {-D [ -d データマネージャが管理するデータ格納ディレクトリ] | -h グリッドプロパティ管理ホスト名} ] |

-p グリッドプロパティ名 [ -n グリッドプロパティ識別子 ] [ -g 世代識別子] [-Z ] [-v ] [-h グリッドプロパティ管理ホスト名] |

-i グリッドジョブ識別子 [ -s ] [-Z ] [-v ] [-h グリッドプロパティ管理ホスト名] |

-n グリッドプロパティ識別子 [-Z ] [-v ] [-h グリッドプロパティ管理ホスト名] |

-b 表示開始日 [ -t 表示開始時刻 ] [ -e 表示終了日 [ -m 表示終了時刻 ] ] [ -Z ] [ -v ] [ {-D [ -d データマネージャが管理するデータ格納ディレクトリ] | -h グリッドプロパティ管理ホスト名} ] |

-e 表示終了日 [ -m 表示終了時刻 ] [ -Z ] [ -v ] [ {-D [ -d データマネージャが管理するデータ格納ディレクトリ] | -h グリッドプロパティ管理ホスト名} ]

機能

クライアント上でこのコマンドを実行することで,実行中または実行済みのグリッドジョブおよびサブジョブの状態を表示します。

指定したグリッドプロパティの一覧情報を表示します。また,指定したグリッドジョブの一覧情報や,-sオプションによってサブジョブの状態および稼働情報を表示します。

オプション

-a

コマンド投入時までに実行されたグリッドジョブ一覧を表示します。

-Z

ヘッダを出力しない場合に指定します。サブジョブの状態および稼働情報を表示する場合は,サブジョブ情報以外の情報を表示しません。

-v

すべてのサブジョブの状態および稼働状況を表示します。このオプションを省略した場合,再実行中または再実行済みのグリッドジョブは,再実行対象となったサブジョブの状態および稼働状況だけを表示します。

-D

管理ホストで実行することで,グリッドジョブの情報を,グリッドプロパティ管理ホストとは非同期に取得して表示します。グリッドプロパティ情報が多量にありgpjoblsコマンドの実行に長時間必要な場合に,グリッドプロパティ管理ホストを占有しないで表示できます。ただし,実行中のグリッドジョブについては,サブジョブの状態を同期しないで取得するため,過去の情報が表示されます。なお,このオプションを指定した場合,グリッドプロパティ管理ホストが未起動であっても情報を取得することができます。

-d

データマネージャのユーザサービス定義で指定したUGPSM_DIR環境変数の値を指定します。このオプションを省略した場合は,UGPSM_DIR環境変数のデフォルト値が仮定されます。

-h グリッドプロパティ管理ホスト名〜((1〜63文字))

状態を表示するグリッドジョブおよびサブジョブのグリッドプロパティ情報を管理しているグリッドプロパティ管理ホスト名を指定します。このオプションは,実行ノード共有機能を適用している場合に指定する必要があります。クラスタシステムの場合は,論理ホスト名を指定します。このオプションを省略した場合は,コマンド実行ホストのDM_HOSTパラメータの指定値が仮定されます。

-p グリッドプロパティ名〜((1〜30文字))

指定した特定グリッドプロパティ名のグリッドジョブ一覧を表示します。

-n グリッドプロパティ識別子〜((7文字))

指定した特定グリッドプロパティ識別子のグリッドジョブ一覧を表示します。

-g 世代識別子〜((10文字))

指定した世代識別子のグリッドジョブ一覧を表示します。

-i グリッドジョブ識別子〜((7文字))

指定したグリッドジョブ識別子の情報を出力します。

-s

指定したグリッドジョブから生成されたサブジョブの状態および稼働情報を表示します。

-b 表示開始日〜<10桁の年月日>((2001/01/01〜2037/12/31))

表示開始日をYYYY/MM/DDの形式(YYYY:年,MM:月,DD:日)で指定します。指定した年月日以降に実行を開始したグリッドジョブ一覧を表示します。

-t 表示開始時刻〜<5桁の時分>((00:00〜23:59))

表示開始時刻をhh:mmの形式(hh:時,mm:分)で指定します。このオプションは-bとともに指定し,指定した日時以降に実行を開始したグリッドジョブ一覧を表示します。省略した場合は,00:00を仮定します。

-e 表示終了日〜<10桁の年月日>((2001/01/01〜2037/12/31))

表示終了日をYYYY/MM/DDの形式(YYYY:年,MM:月,DD:日)で指定します。指定した年月日以前に実行を開始したグリッドジョブ一覧を表示します。省略した場合は,開始日以降の情報を表示します。

-m 表示終了時刻〜<5桁の時分>((00:00〜23:59))

表示終了時刻をhh:mmの形式(hh:時,mm:分)で指定します。このオプションは-eとともに指定し,指定した日時以前に実行を開始したグリッドジョブ一覧を表示します。省略した場合は,23:59を仮定します。

指定例

2014年8月20日 7時00分から2014年8月27日 6時59分までの間に実行を開始したジョブの情報を表示する場合:

gpjobls -b 2014/08/20 -t 07:00 -e 2014/08/27 -m 06:59

戻り値

戻り値

内容

出力メッセージ

0

正常終了

なし。

1〜31

内部エラー

KAKJ1901-E

システムコールエラーが発生しました。

KAKJ1902-E

メモリ不足が発生しました。

KAKJ1903-E

プログラム論理エラーが発生しました。

32〜47

パラメータエラー

KAKJ1700-E

オプションの指定に誤りがあります。

48〜

その他のエラー

KAKJ1567-E

管理ホストで実行してください。

KAKJ1577-E

グリッドプロパティ管理ホストとの通信でエラーが発生しました。

KAKJ1701-E

指定した条件に該当するデータが存在しません。

KAKJ1703-E

グリッドプロパティ管理ホストから取得したデータが壊れています。

KAKJ1704-E

グリッドプロパティ管理ホストでエラーが発生しました。

KAKJ1714-E

ディレクトリが存在しませんでした。

KAKJ1915-E

一時ファイルの処理でエラーが発生しました。

KAKJ1918-E

RPCでエラーが発生しました。

表示形式

注意事項