ajsagtshow

〈このページの構成〉

形式
機能
実行権限
引数
注意事項
戻り値
使用例1
使用例2
使用例3
出力例1
出力例2
出力例3
出力例4
出力例5

形式

ajsagtshow
     [-h 論理ホスト名]
     {-a 実行エージェント名 | -g 実行エージェントグループ名|-l|-n|-e}

形式1（実行エージェントの情報表示）

ajsagtshow
     [-h 論理ホスト名]
     -a 実行エージェント名

形式2（実行エージェントグループの情報表示）

ajsagtshow
     [-h 論理ホスト名]
     -g 実行エージェントグループ名

形式3（すべての実行エージェントおよび実行エージェントグループの情報表示）

ajsagtshow
     [-h 論理ホスト名]
     -l

形式4（すべての実行エージェントおよび実行エージェントグループの名称表示）

ajsagtshow
     [-h 論理ホスト名]
     -n

形式5（実行エージェントの状態の情報表示）

ajsagtshow
     [-h 論理ホスト名]
     -e

ページの先頭へ

機能

実行エージェントまたは実行エージェントグループのジョブ実行状態などの情報を標準出力に出力します。

ページの先頭へ

実行権限

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

JP1_JPQ_Admin権限
JP1_JPQ_Operator権限
JP1_JPQ_User権限

または，

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

ページの先頭へ

引数

`-h` 論理ホスト名

実行エージェント情報を出力したい実行エージェントまたは実行エージェントグループが登録されている自ホストの論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

物理ホストの場合，このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

`-a` 実行エージェント名

実行エージェント情報を出力したい実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの状態もあわせて出力されます。

`-g` 実行エージェントグループ名

実行エージェント情報を出力したい実行エージェントグループ名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの状態もあわせて出力されます。

`-l`

すべての実行エージェントおよび実行エージェントグループの情報を出力する場合に指定します。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの状態もあわせて出力されます。

`-n`

すべての実行エージェントおよび実行エージェントグループの名称だけを出力する場合に指定します。実行エージェント名および実行エージェントグループ名以外の情報は出力されません。

`-e`

実行エージェントの状態を出力する場合に指定します。

このオプションは，ジョブ配信遅延の軽減機能が有効である場合だけ指定できます。ジョブ配信遅延の軽減機能が無効である場合は，エラーメッセージを出力してコマンドが中断されます。

ページの先頭へ

注意事項

このコマンドは，JP1/AJS3からJP1/NQSEXECおよびJP1/OJE for VOS3への要求には使用できません。
このコマンドは，別ホストのJP1/AJS3 - Managerに対しては実行できません。

ページの先頭へ

戻り値

0	正常終了。
4	コマンド実行時の環境変数が不正である。 JP1/AJS3サービスが起動されていない。 `-h`オプション指定時，指定された論理ホストがない，または環境設定に誤りがある。指定した実行エージェントがない。指定した実行エージェントグループがない。認証サーバが起動していない。 `-e`オプション指定時，ジョブ配信遅延の軽減機能が無効である。
8	コマンド引数の指定に誤りがある。
12	コマンド処理中にメモリー不足が発生した。
20	共有メモリーのアクセスが排他エラーで失敗した。
24	コマンド実行権限がない。
40	共有メモリーの割り当て，ファイルディスクリプタの割り当て，排他資源の割り当ての際，システムの限界値を超えた。
120	OSのシステムコールで予期しないエラーを検知した。
124	JP1/AJSの内部処理で予期しないエラーを検知した。

ページの先頭へ

使用例1

すべての実行エージェントまたは実行エージェントグループの情報を表示します。

ajsagtshow -l

ページの先頭へ

使用例2

実行エージェント「AP1」の情報を表示します。

ajsagtshow -a AP1

ページの先頭へ

使用例3

実行エージェントの状態の一覧情報を表示します。

ajsagtshow -e

ページの先頭へ

出力例1

-aオプションを指定した場合の出力例と出力内容の意味を次に示します。

なお，次の例はジョブ配信遅延の軽減機能が無効な場合の例です。

ajsagtshow -a AGT01
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT      STATUS HOST       CON-EXE   QUE   JOB EVENT DESCRIPTION
---------- ------ --------- -------- ----- ----- ----- -----------
AGT01      Ef     AGT01            5     0     0     0
KNAC1102-I エージェント管理の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT

実行エージェント名を示します。

STATUS

実行エージェントの受付配信制限の状態を示します。

値	状態	説明
`Ef`	有効	ジョブを受け付け，実行ホストに配信されます。
`In`	無効	ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。
`Hd`	保留	ジョブを受け付けます。ただし，実行ホストには配信されません。
`Bl`	閉塞	ジョブを受け付けません。また，実行ホストにも配信されません。

HOST

実行ホスト名を示します。

CON-EXE

ジョブ実行多重度を示します。

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数を示します。

JOB

実行中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数を示します。

EVENT

実行中のイベントジョブ数を示します。

DESCRIPTION

追加・変更時に設定した実行エージェントに対するコメントを示します。

ページの先頭へ

出力例2

-gオプションを指定した場合の出力例と出力内容の意味を次に示します。

なお，次の例はジョブ配信遅延の軽減機能が無効な場合の例です。

ajsagtshow -g AGTG01
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT GROUP     STATUS   QUE LINKAGENT         AGT ST DESCRIPTION
--------------- ------ ----- ----------------- ------ ------------
AGTG01          Ef         0 -                 -
                -          - AGT01:16          Ef
                -          - AGT02:16          Ef
KNAC1102-I エージェント管理の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT GROUP

実行エージェントグループ名を示します。

STATUS

実行エージェントグループの受付配信制限の状態を示します。

値	状態	説明
`Ef`	有効	ジョブを受け付け，実行ホストに配信されます。
`In`	無効	ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。
`Hd`	保留	ジョブを受け付けます。ただし，実行ホストには配信されません。
`Bl`	閉塞	ジョブを受け付けません。また，実行ホストにも配信されません。

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブの数を示します。

LINKAGENT

実行エージェントグループに属する実行エージェント名と優先順位を「:（コロン）」で区切って示します。優先順位は，いちばん低いのが1，いちばん高いのが16です。

AGT ST

実行エージェントの受付配信制限の状態を示します。

値	状態	説明
Ef	有効	ジョブを受け付け，実行ホストに配信されます。
In	無効	ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。
Hd	保留	ジョブを受け付けます。ただし，実行ホストには配信されません。
Bl	閉塞	ジョブを受け付けません。また，実行ホストにも配信されません。

DESCRIPTION

追加・変更時に設定した実行エージェントグループに対するコメントを示します。

ページの先頭へ

出力例3

-aオプションを指定した場合の出力例と出力内容の意味を次に示します。

なお，次の例はジョブ配信遅延の軽減機能が有効な場合の例です。

ajsagtshow -a AGT01
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT      STATUS HOST       CON-EXE   QUE   JOB EVENT DESCRIPTION
---------- ------ --------- -------- ----- ----- ----- --------------------
AGT01      In-Co  AGT01           10     0     5     3 エージェント1
KNAC1102-I エージェント管理の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT

実行エージェント名を示します。

STATUS

実行エージェントの受付配信制限の状態と，実行エージェントの状態を示します。

実行エージェントの受付配信制限の状態を次に示します。

値	状態	説明
`Ef`	有効	ジョブを受け付け，実行ホストに配信されます。
`In`	無効	ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。
`Hd`	保留	ジョブを受け付けます。ただし，実行ホストには配信されません。
`Bl`	閉塞	ジョブを受け付けません。また，実行ホストにも配信されません。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの受付配信制限の状態を示す値のあとに，実行エージェントの状態を「-実行エージェントの状態」の形式で示します。

実行エージェントの状態を次に示します。

値	状態	説明
`Nc`	未確認	実行エージェントの状態が「未確認」です。
`Co`	接続可	実行エージェントの状態が「接続可」です。
`Uc`	接続不可	実行エージェントの状態が「接続不可」です。
`Ua`	使用不可	実行エージェントの状態が「使用不可」です。

HOST

実行ホスト名を示します。

CON-EXE

ジョブ実行多重度を示します。

QUE

JOB

EVENT

実行中のイベントジョブ数を示します。

DESCRIPTION

追加・変更時に設定した実行エージェントに対するコメントを示します。

ページの先頭へ

出力例4

-gオプションを指定した場合の出力例と出力内容の意味を次に示します。

なお，次の例はジョブ配信遅延の軽減機能が有効な場合の例です。

ajsagtshow -g AGTG01
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT GROUP     STATUS   QUE LINKAGENT         AGT ST DESCRIPTION
--------------- ------ ----- ----------------- ------ --------------------
AGTG01          Ef         0 -                 -      エージェントグループ
                -          - AGT01:1           In-Co  エージェント1
                -          - AGT02:2           Bl-Co  エージェント2
KNAC1102-I エージェント管理の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT GROUP

実行エージェントグループ名を示します。

STATUS

実行エージェントグループの受付配信制限の状態を示します。

値	状態	説明
`Ef`	有効	ジョブを受け付け，実行ホストに配信されます。
`In`	無効	ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。
`Hd`	保留	ジョブを受け付けます。ただし，実行ホストには配信されません。
`Bl`	閉塞	ジョブを受け付けません。また，実行ホストにも配信されません。

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブの数を示します。

LINKAGENT

実行エージェントグループに属する実行エージェント名と優先順位を「:（コロン）」で区切って示します。優先順位は，いちばん低いのが1，いちばん高いのが16です。

AGT ST

実行エージェントの受付配信制限の状態と，実行エージェントの状態を示します。

実行エージェントの受付配信制限の状態を次に示します。

値	状態	説明
`Ef`	有効	ジョブを受け付け，実行ホストに配信されます。
`In`	無効	ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。
`Hd`	保留	ジョブを受け付けます。ただし，実行ホストには配信されません。
`Bl`	閉塞	ジョブを受け付けません。また，実行ホストにも配信されません。

実行エージェントの状態を次に示します。

値	状態	説明
`Nc`	未確認	実行エージェントの状態が「未確認」です。
`Co`	接続可	実行エージェントの状態が「接続可」です。
`Uc`	接続不可	実行エージェントの状態が「接続不可」です。
`Ua`	使用不可	実行エージェントの状態が「使用不可」です。

DESCRIPTION

追加・変更時に設定した実行エージェントグループに対するコメントを示します。

ページの先頭へ

出力例5

-eオプションを指定した場合の出力例と出力内容の意味を次に示します。

ajsagtshow -e
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT           STATUS HOST           IP ADDRESS      CHECK TIME
--------------- ------ -------------- --------------- -------------------
AGT01           Ef-Co  AGT01          -               2016/01/01 10:00:00
AGT02           Ef-Nc  AGT02          -               ----/--/-- --:--:--
AGT04           Ef-Uc  AGT04          123.456.789.25  2016/01/01 10:00:10
                -                     123.456.987.10  2016/01/01 10:01:40
                -                     123.456.797.65  2016/01/01 10:03:10
AGT05           Hd-Ua  AGT05          -               ----/--/-- --:--:--
AGT06           Ef-Uc  AGT06          123.456.789.27  2016/01/01 10:00:11
KNAC1102-I エージェント管理の情報の出力を終了します

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT

実行エージェント名を示します。

STATUS

実行エージェントの受付配信制限の状態と実行エージェントの状態を「実行エージェントの受付配信制限の状態-実行エージェントの状態」の形式で示します。

実行エージェントの受付配信制限の状態を次に示します。

値	状態	説明
`Ef`	有効	ジョブを受け付け，実行ホストに配信されます。
`In`	無効	ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。
`Hd`	保留	ジョブを受け付けます。ただし，実行ホストには配信されません。
`Bl`	閉塞	ジョブを受け付けません。また，実行ホストにも配信されません。

実行エージェントの状態を次に示します。

値	状態	説明
`Nc`	未確認	実行エージェントの状態が「未確認」です。
`Co`	接続可	実行エージェントの状態が「接続可」です。
`Uc`	接続不可	実行エージェントの状態が「接続不可」です。
`Ua`	使用不可	実行エージェントの状態が「使用不可」です。

HOST

実行ホスト名を示します。

IP ADDRESS

接続IPアドレスを示します。

実行エージェントの状態が「接続不可」の場合だけ，通信障害が発生しているIPアドレスを1行ずつ示します。IPアドレスは，最も新しいIPアドレスから順に，最大四つまで示します。

なお，IPアドレスが解決される前に発生した通信障害の場合は，表示されません。

CHECK TIME

実行エージェントを確認した時間を，IPアドレスごとに「YYYY/MM/DD hh:mm:ss」の形式で示します。

注意事項

「IP ADDRESS」および「CHECK TIME」には，ジョブ配信遅延の軽減機能の通信状態確認で通信障害を検知した実行エージェントの情報だけが出力されます。通信状態確認以外で検知したエラーの情報は，統合トレースログに出力されるエラーメッセージで確認してください。

ページの先頭へ