2.18 btfwiniinfo(イニシエータの状態表示)

名前

btfwiniinfo －イニシエータの状態表示

形式

btfwiniinfo [-m] [イニシエータ名]

btfwiniinfo [イニシエータ名]

機能説明

イニシエータの状態を表示します。表示形式には以下の種類があります。

一覧表示
バッチ実行サービス上に存在するすべてのイニシエータの一覧を表示します。
表示順序はイニシエータ名の昇順です。
詳細表示
指定したイニシエータの詳細情報を表示します。

イニシエータ名省略時は、すべてのイニシエータの状態の一覧を表示します。

イニシエータ一覧情報の表示項目は以下のとおりです。

表示項目	内容
InitiatorName	イニシエータ名です。イニシエータ名の英字の大文字・小文字については、コマンドに指定した文字で出力されます。
State	イニシエータの状態です。 start pending ：稼働準備中（バッチワークユニットが起動状態になるのを待っている状態） active ：稼働 stop pending：停止中 inactive：停止
NumberOfJobs	イニシエータで実行中のジョブ数です。稼働状態ではない場合は“-”を1文字表示します。
NumberOfProcesses	イニシエータで実行中のプロセス数です。 -mオプション指定時のみ表示されます。稼働状態ではない場合は“-”を1文字表示します。
MaxJob	イニシエータでジョブが使用できる最大多重度数(プロセス数)です。

イニシエータ詳細情報の表示項目は以下のとおりです。

表示項目	内容
Initiator Name	イニシエータ名です。イニシエータ名の英字の大文字・小文字については、コマンドに指定した文字で出力されます。
State	イニシエータの稼働状態です。 start pending ：稼働準備中（バッチワークユニットが起動状態になるのを待っている状態） active ：稼働 stop pending：停止中 inactive：停止
Start Time	イニシエータの運用を開始した日時です。稼働状態ではない場合は“----/--/-- --:--:--”を表示します。
Number of Jobs	イニシエータで実行中のジョブ数です。稼働状態ではない場合は“-”を1文字表示します。
Number of Processes	イニシエータで実行中のプロセス数です。 -mオプション指定時のみ表示されます。稼働状態ではない場合は“-”を1文字表示します。
Max Job	イニシエータでジョブが使用できる最大多重度数(プロセス数)です。
Batch Workunit	対象のイニシエータに関連付けられている、バッチワークユニットの名前です。
[Destination Name]	イニシエータに関連付けられている、各イベントチャネルに対応するDestination名です。 Error Event Channel：エラー用イベントチャネルのDestination名です。 Job Completion Event Channel：ジョブ終了用イベントチャネルのDestination名です。
Jobqueue Name	対象のイニシエータに関連付けられている、ジョブキュー名です。ジョブキュー名の英字は、すべて小文字で出力されます。
Start Mode	イニシエータの開始モードです。 auto：バッチ実行サービスの開始時にイニシエータを開始します。 manual：バッチ実行サービスの開始時にイニシエータを開始しません。これは、以下のいずれかで設定した値を示します。 btfwcrtbtenv(バッチサーバ環境のセットアップ)での設定バッチサーバ環境のセットアップ後に、btfwaltinidef(イニシエータの設定変更)でイニシエータの開始モードを変更した場合は、そのときの指定

オプション

-m: イニシエータで実行中のプロセス数を表示します。
カスケードジョブを実行する場合、カスケード結合数分のプロセスが必要となります。カスケードジョブを実行する運用では、常に本オプションを指定してください。カスケードジョブの実行開始が遅延した場合には、イニシエータでジョブが使用できる最大多重度数(プロセス数)が、カスケード結合数以上であることを確認してください。

オぺランド

イニシエータ名: 詳細表示対象のイニシエータ名を指定します。
省略時は、一覧表示となります。

イニシエータ名の半角英大文字、半角英小文字は区別されません。

実行可能ユーザ

システム管理者(スーパユーザ)またはInterstage運用者

システム管理者(Administratorsグループに所属するユーザ)

使用例

すべてのイニシエータの状態の一覧を表示します。

# btfwiniinfo
InitiatorName   State              NumberOfJobs   MaxJob
---------------------------------------------------------------------------------
que001          active                        0       20
que002          start pending                 -        0

指定したイニシエータの状態を表示します。

# btfwiniinfo que001
Initiator Name = que001
State = active
Start Time = 2006/03/04 03:26:37
Number of Jobs = 0
Max Job = 20
Batch Workunit = que001_CWU
[Destination Name]
  Error Event Channel = que001_ERRORdest
  Job Completion Event Channel = que001_JobCOMPdest
Jobqueue Name = que001
Start Mode = auto

すべてのイニシエータの状態を表示します。

# btfwiniinfo -m
InitiatorName   State              NumberOfJobs       NumberOfProcesses   MaxJob
---------------------------------------------------------------------------------
que001          active                       10                    16      20
que002          start pending                 -                     -       0

指定したイニシエータの状態を表示します。

# btfwiniinfo -m que001
Initiator Name = que001
State = active
Start Time = 2006/03/04 03:26:37
Number of Jobs = 10
Number of Processes = 16
Max Job = 20
Batch Workunit = que001_CWU
[Destination Name]
  Error Event Channel = que001_ERRORdest
  Job Completion Event Channel = que001_JobCOMPdest
Jobqueue Name = que001
Start Mode = auto

コマンドの復帰コード

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