Cluster Server 7.3.1 エージェント開発者ガイド - AIX、Linux、Solaris、Windows
- 概要
- エージェントのエントリポイントの概要
- エージェントのエントリポイントについて
- エージェントエントリポイントの説明
- action エントリポイントについて
- info エントリポイントについて
- C++ またはスクリプトエントリポイントの使用上の注意事項
- エージェント情報ファイルについて
- ArgList 属性と ArgListValues 属性について
- C++ でのエントリポイントの作成
- C++ でのエントリポイントの作成について
- C++ のエントリポイントの構文
- エージェントフレームワークの基本関数
- コンテナサポートのためのエージェントフレームワーク基本関数
- スクリプトでのエントリポイントの作成
- スクリプトでのエントリポイントの作成について
- スクリプトエントリポイントの構文
- エージェントフレームワークの基本関数
- VCSAG_GET_ATTR_VALUE
- コンテナをサポートするエージェントフレームワーク基本関数
- スクリプトのエントリポイントの例
- エージェントメッセージのログ
- カスタムエージェントの作成
- スクリプトベースの IMF 対応カスタムエージェントの作成
- エージェントのテスト
- 静的タイプ属性
- 静的属性について
- 静的タイプ属性の定義
- AdvDbg
- ArgList
- 状態の遷移図
- 国際化されたメッセージ
- First Failure Data Capture(FFDC)を使用した VCS リソースの予期しない動作のトラブルシューティング
- 付録 A. 5.0 より前の VCS エージェントの使用
VCSAG_GET_CONTAINER_BASE_PATH
メモ:
この API は Linux Docker コンテナではサポートされません。
この API は、グループレベルで ContainerInfo 属性で説明したコンテナの基本パスを返します。この API は、グローバルゾーンまたは WPAR から実行する必要があります。
Solaris ゾーンの場合
エージェントが Solaris コンピュータで動作している場合、API はゾーンがインストールされているゾーンの基本パスを返します。
WPAR の場合
エージェントが AIX コンピュータで動作している場合、API は WPAR がインストールされている WPAR の基本パスを返します。
Perl ベース: API の終了状態、コマンドの状態、コンテナのベースパスを戻り値として返します。
戻り値:
0 | ContainerInfo が正しく設定される前に VCSAG_GET_CONTAINER_INFO が呼び出された場合。つまり、
コンテナのベースパスが戻り値として返されます。 |
4 | VCSAG_GET_CONTAINER_INFO API が前に呼び出されなかった場合、またはリソースの ContainerInfo 属性が設定されなかった場合。たとえば、ContainerInfo の Name キーが "" か ContainerInfo の Type キーが無効な場合。 |
5 | コンテナのベースパスをフェッチするコマンドが失敗した場合。コマンドの状態が戻り値として返されます。 |
使用法:
my ($ret, $cmdstatus, $container_base_path) = VCSAG_GET_CONTAINER_BASE_PATH();
シェルベース:
この API は、コンテナのベースパスを環境変数 VCSAG_CONTAINER_BASE_PATH で返し、API がベースパス名のフェッチに使ったコマンドの状態を環境変数 VCSAG_CMD_STATUS で返します。API は、終了状態を環境変数 VCSAG_BASE_PATH_RET_VAL で返します。
戻り値:
0 | ContainerInfo が正しく設定される前に VCSAG_GET_CONTAINER_INFO が呼び出された場合。つまり、
コンテナのベースパスは環境変数 VCSAG_CONTAINER_BASE_PATH のパラメータに格納されます。 |
4 | VCSAG_GET_CONTAINER_INFO API が前に呼び出されなかった場合、またはリソースの ContainerInfo 属性が設定されなかった場合。たとえば、ContainerInfo の Name キーが "" か ContainerInfo の Type キーが無効な場合。 |
5 | コンテナのベースパスをフェッチするコマンドが失敗した場合。環境変数 VCSAG_CMD_STATUS は、コマンドの終了状態に応じて更新されます。 |
使用法:
VCSAG_GET_CONTAINER_BASE_PATH base_path=${VCSAG_CONTAINER_BASE_PATH}
メモ:
この API を使う前に、API VCSAG_GET_CONTAINER_INFO を呼び出す必要があります。VCSAG_GET_CONTAINER_INFO API は、この API に必要となるコンテナの名前とタイプを適切に設定します。