Cluster Server 7.3.1 エージェント開発者ガイド - AIX、Linux、Solaris、Windows
- 概要
- エージェントのエントリポイントの概要
- エージェントのエントリポイントについて
- エージェントエントリポイントの説明
- open エントリポイントについて
- monitor エントリポイントについて
- online エントリポイントについて
- offline エントリポイントについて
- clean エントリポイントについて
- action エントリポイントについて
- info エントリポイントについて
- attr_changed エントリポイントについて
- close エントリポイントについて
- shutdown エントリポイントについて
- imf_init エントリポイントについて
- imf_register エントリポイントについて
- imf_getnotification エントリポイントについて
- migrate エントリポイントについて
- meter エントリポイントについて
- エントリポイントの戻り値
- C++ またはスクリプトエントリポイントの使用上の注意事項
- エージェント情報ファイルについて
- ArgList 属性と ArgListValues 属性について
- C++ でのエントリポイントの作成
- C++ でのエントリポイントの作成について
- データ構造
- C++ のエントリポイントの構文
- エージェントフレームワークの基本関数
- VCSAgGetMonitorLevel
- VCSAgGetFwVersion
- VCSAgGetRegVersion
- VCSAgRegisterEPStruct
- VCSAgSetCookie2
- VCSAgRegister
- VCSAgUnregister
- VCSAgGetCookie
- VCSAgStrlcpy
- VCSAgStrlcat
- VCSAgSnprintf
- VCSAgCloseFile
- VCSAgDelString
- VCSAgExec
- VCSAgExecWithTimeout
- VCSAgGenSnmpTrap
- VCSAgSendTrap
- VCSAgLockFile
- VCSAgInitEntryPointStruct
- VCSAgSetStackSize
- VCSAgUnlockFile
- VCSAgValidateAndSetEntryPoint
- VCSAgSetLogCategory
- VCSAgGetProductName
- VCSAgMonitorReturn
- VCSAgSetResEPTimeout
- VCSAgDecryptKey
- VCSAgGetConfDir
- VCSAgGetHomeDir
- VCSAgGetLogDir
- VCSAgGetSystemName
- VCSAG_CONSOLE_LOG_MSG
- VCSAG_LOG_MSG
- VCSAG_LOGDBG_MSG
- VCSAG_RES_LOG_MSG
- コンテナサポートのためのエージェントフレームワーク基本関数
- スクリプトでのエントリポイントの作成
- スクリプトでのエントリポイントの作成について
- スクリプトエントリポイントの構文
- エージェントフレームワークの基本関数
- VCSAG_GET_MONITOR_LEVEL
- VCSAG_GET_AGFW_VERSION
- VCSAG_GET_REG_VERSION
- VCSAG_SET_RES_EP_TIMEOUT
- VCSAG_GET_ATTR_VALUE
- VCSAG_SET_RESINFO
- VCSAG_MONITOR_EXIT
- VCSAG_SYSTEM
- VCSAG_SU
- VCSAG_RETURN_IMF_RESID
- VCSAG_RETURN_IMF_EVENT
- VCSAG_BLD_PSCOMM
- VCSAG_PHANTOM_STATE
- VCSAG_SET_ENVS
- VCSAG_LOG_MSG
- VCSAG_LOGDBG_MSG
- VCSAG_SQUEEZE_SPACES
- コンテナをサポートするエージェントフレームワーク基本関数
- スクリプトのエントリポイントの例
- エージェントメッセージのログ
- カスタムエージェントの作成
- スクリプトベースの IMF 対応カスタムエージェントの作成
- エージェントのテスト
- 静的タイプ属性
- 静的属性について
- 静的タイプ属性の定義
- ActionTimeout
- AdvDbg
- AEPTimeout
- AgentClass
- AgentDirectory
- AgentFailedOn
- AgentFile
- AgentPriority
- AgentReplyTimeout
- AgentStartTimeout
- AlertOnMonitorTimeouts
- ArgList
- AttrChangedTimeout
- AvailableMeters
- CleanRetryLimit
- CleanTimeout
- CloseTimeout
- ContainerOpts
- ConfInterval
- EPClass
- EPPriority
- ExternalStateChange
- FaultOnMonitorTimeouts
- FaultPropagation
- FireDrill
- IMF
- IMFRegList
- InfoInterval
- InfoTimeout
- IntentionalOffline
- LevelTwoMonitorFreq
- LogDbg
- LogFileSize
- LogViaHalog
- ManageFaults
- Meters
- MeterControl
- MeterRegList
- MeterRetryLimit
- MeterTimeout
- MonitorInterval
- MonitorStatsParam
- MonitorTimeout
- MigrateTimeout
- MigrateWaitLimit
- NumThreads
- OfflineMonitorInterval
- OfflineTimeout
- OfflineWaitLimit
- OnlineClass
- OnlinePriority
- OnlineRetryLimit
- OnlineTimeout
- OnlineWaitLimit
- OpenTimeout
- Operations
- RegList
- RestartLimit
- ScriptClass
- ScriptPriority
- SourceFile
- SupportedActions
- SupportedOperations
- ToleranceLimit
- 状態の遷移図
- 国際化されたメッセージ
- 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 に必要となるコンテナの名前とタイプを適切に設定します。