2.12 btfwqinfo(ジョブキュー情報の表示)

Interstage Job Workload Server リファレンス

第2章運用操作コマンド

2.12 btfwqinfo(ジョブキュー情報の表示)

■名前

btfwqinfo －ジョブキュー情報の表示

■形式

一覧表示
btfwqinfo [ジョブキュー名]

詳細表示
btfwqinfo -l ジョブキュー名

■機能説明

バッチ受付サービス上のジョブキューの情報を表示します。表示形式には以下の種類があります。

一覧表示
バッチ受付サービスに存在するすべてのジョブキューの一覧を表示します。

詳細表示
指定したジョブキューの詳細情報を表示します。

一覧情報の表示項目は以下のとおりです。

表示項目

内容

JobQueueName

ジョブキュー名です。
デフォルトジョブキューの指定がされているジョブキューには、ジョブキュー名の直後に“(def)”を表示します。

State

ジョブキューの状態です。
active ：ジョブキューは実行可能状態です。
inactive：ジョブキューは実行禁止状態です。

MaxJob

ジョブキューに定義されている投入可能ジョブ数です。
ジョブキューに定義されていない場合は“-”を1文字表示します。

Multi

ジョブキューの現在有効となっているジョブの多重度です。

Limit

ジョブキューに定義されている実行経過時間の制限値です。単位は秒です。
ジョブキューに定義されていない場合は“-”を1文字表示します。

表示項目	内容
JobQueueName	ジョブキュー名です。デフォルトジョブキューの指定がされているジョブキューには、ジョブキュー名の直後に“(def)”を表示します。
State	ジョブキューの状態です。 active ：ジョブキューは実行可能状態です。 inactive：ジョブキューは実行禁止状態です。
MaxJob	ジョブキューに定義されている投入可能ジョブ数です。ジョブキューに定義されていない場合は“-”を1文字表示します。
Multi	ジョブキューの現在有効となっているジョブの多重度です。
Limit	ジョブキューに定義されている実行経過時間の制限値です。単位は秒です。ジョブキューに定義されていない場合は“-”を1文字表示します。

詳細情報の表示項目は以下のとおりです。

表示項目

内容

Jobqueue Name

ジョブキュー名です。
デフォルトジョブキューの指定がされているジョブキューには、ジョブキュー名の直後に“(default)”を表示します。

Jobqueue State

ジョブキューの状態です。
active ：ジョブキューは実行可能状態です。
inactive：ジョブキューは実行禁止状態です。

[Number of Jobs]

投入ジョブ数です。
Exec：ジョブ状態が実行中のジョブ数です。
Wait：ジョブ状態が実行待ちのジョブ数です。
Hold：ジョブ状態が保留中のジョブ数です。

[Max Job]

投入可能ジョブ数です。
Definition：ジョブキューに定義されている投入可能ジョブ数です。ジョブキューに定義されていない場合は“-”を1文字表示します。
System：システムの投入可能ジョブ数です。

[Multiplicity]

ジョブの多重度です。
Current：ジョブキューの現在有効となっているジョブの多重度です。
Definition：ジョブキューに定義されているジョブの多重度です。
System：ジョブキューに割り当てられているシステム構成上の多重度です。ジョブの多重度は、システム構成上の多重度以上にできません。

[Time Limit]

ジョブキューに定義されている実行経過時間の制限値です。単位は秒です。
ジョブキューに定義されていない場合は“-”を1文字表示します。

[Initiator]

バッチ実行サービス上のイニシエータ名およびイニシエータの状態です。
以下の形式で表示します。
イニシエータ名(状態)
バッチ実行サービスと1度も通信されていない場合は“-”を1文字表示します。
［状態］
active ：稼働
inactive：停止

表示項目	内容
Jobqueue Name	ジョブキュー名です。デフォルトジョブキューの指定がされているジョブキューには、ジョブキュー名の直後に“(default)”を表示します。
Jobqueue State	ジョブキューの状態です。 active ：ジョブキューは実行可能状態です。 inactive：ジョブキューは実行禁止状態です。
[Number of Jobs]	投入ジョブ数です。 Exec：ジョブ状態が実行中のジョブ数です。 Wait：ジョブ状態が実行待ちのジョブ数です。 Hold：ジョブ状態が保留中のジョブ数です。
[Max Job]	投入可能ジョブ数です。 Definition：ジョブキューに定義されている投入可能ジョブ数です。ジョブキューに定義されていない場合は“-”を1文字表示します。 System：システムの投入可能ジョブ数です。
[Multiplicity]	ジョブの多重度です。 Current：ジョブキューの現在有効となっているジョブの多重度です。 Definition：ジョブキューに定義されているジョブの多重度です。 System：ジョブキューに割り当てられているシステム構成上の多重度です。ジョブの多重度は、システム構成上の多重度以上にできません。
[Time Limit]	ジョブキューに定義されている実行経過時間の制限値です。単位は秒です。ジョブキューに定義されていない場合は“-”を1文字表示します。
[Initiator]	バッチ実行サービス上のイニシエータ名およびイニシエータの状態です。以下の形式で表示します。イニシエータ名(状態) バッチ実行サービスと1度も通信されていない場合は“-”を1文字表示します。［状態］ active ：稼働 inactive：停止

■オプション

-l

指定したジョブキューの詳細情報を表示します。
本オプション省略時は、一覧表示となります。

■オペランド

ジョブキュー名

対象のジョブキュー名を指定します。
一覧表示でジョブキュー名省略時は、すべてのジョブキューが対象となります。
-lオプション指定時は、ジョブキュー名を省略できません。

■実行可能ユーザ

システム管理者(スーパユーザ)またはibsbtgrpグループユーザ

■使用例

ジョブキューの一覧情報を表示します。

# btfwqinfo
  JobQueueName          State     MaxJob  Multi     Limit
 ------------------------------------------------------------------------------
  queue1(def)           active      1000      8       600
  queue2                active       500      8      1200
  queue3                active       200      8      1800
  queue4                active       100      8      3600
  queue5                active        20      8      7200
  queue6                active        20      8     21600
  queue7                active         3      0         -
  queue8                active         -      0         -

指定したジョブキューの詳細情報を表示します。

# btfwqinfo -l queue1
 Jobqueue Name = queue1(default)
 Jobqueue State = active
 [Number of Jobs]
   Exec = 8
   Wait = 15
   Hold = 0
 [Max Job]
   Definition = 1000
   System     = 99999
 [Multiplicity]
   Current    = 8
   Definition = 8
   System     = 8
 [Time Limit]
   Definition = 600
 [Initiator]
   Name = queue1(active)

■コマンドの復帰コード

0：正常終了
1：警告終了
上記以外：異常終了

■注意事項

本コマンドを投入する場合は、バッチ受付サービスが開始されている必要があります。バッチ受付サービスの開始方法は、btfwstartacコマンドを参照してください。