![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
PlacementControllerProcs.jacl スクリプト
PlacementControllerProcs.jacl スクリプトを使用して、アプリケーション配置コントローラー・ランタイム構成を変更できます。
目的
管理のロールに応じて、オートノミック・マネージャーの 構成時に特定の特権が許可されます。このスクリプトを使用して オートノミック・マネージャーを構成するには、管理者特権が必要です。
PlacementControllerProcs.jacl スクリプトを 使用して、一連のアプリケーション配置コントローラー構成オプションをすべて変更します。 ランタイム構成に対して次の操作ができます。- アプリケーション配置コントローラーを使用可能または使用不可にする
- 指定したノードを、アプリケーション配置コントローラーで管理対象または非管理対象にする
- 動的クラスターを使用可能または使用不可にする
- 追加設定の値の取得や設定を行う
このスクリプトは、アプリケーション配置コントローラーのランタイム構成の 変更のみを行います。構成にパーシスタント変更を行うには、APCconfig.jacl スクリプトを使用します。

ロケーション
PlacementControllerProcs.jacl スクリプトは、app_server_root/bin ディレクトリーにあります。
使用法
wsadmin ユーティリティーで PlacementControllerProcs.jacl スクリプトを実行するには、
次のコマンドを使用します。
wsadmin -profile PlacementControllerProcs.jacl -c "insert_proc_parameters"insert_proc_parameters 変数の代わりに、プロシージャーの名前と適切な変数値を 使用して変更内容を入力します。 プロシージャーを 引用符 (") で囲んでください。操作環境によっては、wsadmin コマンドを wsadmin.sh または wsadmin.bat に変更しなければならない場合があります。
プロシージャー
次のコマンドを使用して、
すべての使用可能なプロシージャーのリストを表示できます。
wsadmin -profile PlacementControllerProcs.jacl -c "help"
以下のプロシージャーが使用できます。
- anyFailedServerOperations
- アプリケーション配置コントローラーが始動しようとしたサーバー別に失敗した始動のリストを表示します。
- closeLockMultiAPCGateremoveAPCID
- 複数のアプリケーション配置コントローラー・セットアップのゲートを閉じて、ロックします。 必要であれば、APCGate メカニズムを使用して、異なる Intelligent Management システムにある複数の配置コントローラーが自ら決定したサイクルを同時に実行しないようにすることができます。複数の個別の Intelligent Management セルが同一物理ハードウェアを共有している場合は、APCGate メカニズムを使用可能にすることは重要です。
- deferFailedServerOperations
- アプリケーション配置コントローラーが始動に失敗したすべてのサーバーに対して保守モードの使用可能性を不可にします。
- disable
- アプリケーション配置コントローラーを使用不可にします。
- disableDynamicCluster dynamic_cluster_name
- 指定した動的クラスターを手動で実行するよう設定します。
- disableNode node_name
- 指定したノードを、アプリケーション配置コントローラーで 非管理対象にします。
- enable
- アプリケーション配置コントローラーを使用可能にします。
- enableDynamicCluster dynamic_cluster_name
- 指定した動的クラスターを自動的に実行するよう設定します。
- enableNode node_name
- 指定されたノードに対してアプリケーション配置コントローラーを使用可能にします。
- findBestLocation cell_name node_name server_name
- 動的クラスターのメンバーであるサーバーの停止を試みるときに実行するアクションを示す 3 つの値のいずれか 1 つを戻します。
このプロシージャーは、以下の値のいずれかを戻します。
- NULL: プロシージャーに渡されたサーバーを問題なく停止できます。
- サーバー名: プロシージャーに渡されたサーバー名を停止してはなりません。
- 代替サーバー名: 別のサーバーの名前が返された場合、そのサーバーを先に停止する必要があります。
- getApprovalTimeOut
- 監視モードでの実行時に、タスクがタイムアウトになるまでのタスクの管理者承認を待つ時間を返します。
- getMinTimeBetweenPlacementChange
- 2 つの連続する配置変更の間の最小時間を 戻します。
- getNodeName
- アプリケーション配置コントローラーを実行中の ノードを表示します。
- getServerOperationTimeOut
- サーバーで実行されるスタートまたは停止オペレーションが、 未実行の場合失敗と判断される時間を 戻します。
- handleFailedServerOperations
- アプリケーション配置コントローラーが始動しようとしたが始動しなかったすべてのサーバーを保守モードにします。
- isNodeInUse node_name
- 保守モードにした後もノードが使用されていないかどうかを確認 します。
- isPrimary
- このノードが、アプリケーション配置コントローラーを実行中の 1 次ノードかどうかを返します。
- isEnabled
- アプリケーション配置コントローラーが使用可能の場合、戻ります。
- openMultiAPCGateremoteAPCID
- 複数アプリケーション配置コントローラー・セットアップのゲートを開きます。
- recomputePlacement
- アプリケーション配置コントローラーを起動して、 最適化を計算し、必要な配置変更を行います。
- setMinTimeBetweenPlacementChange time
- 連続する 2 つの配置変更の間の最小時間を、 分単位で設定します。
- setServerOperationTimeOut timeout
- タイムアウトを分単位で設定します。この時間を過ぎると、 サーバーで実行されるスタートまたは停止オペレーションは、 未実行の場合失敗と判断されます。
- setApprovalTimeOut approval_timeout
- タスクが否認と判断されるまで監視モードで操作するとき、 管理者承認までの待ち時間を分単位で 設定します。
- unlockMultiAPCGateremoteAPCID
- 複数アプリケーション配置コントローラー・セットアップのゲートのロックを解除します。
- enableElasticity
- アプリケーション配置コントローラーで Elasticity モードを使用可能にします。 有効な引数は true または false です。
- isElasticityModeEnabled
- Elasticity モードを使用可能にするかどうかを指定します。 戻り値は true または false です。
- elasticityMode
- アプリケーション配置の Elasticity のランタイム・タスクを監視または自動として設定します。 有効な引数は、自動の 0 または監視の 1 です。
- getElasticityMode
- アプリケーション配置の Elasticity が監視に設定されているか、自動に設定されているかを示します。 戻り値は 0 または 1 です。
- elasticityModeTimeOut
- 失敗と判断される前に Elasticity アクションの完了が許される時間 (分) を指定します。 例えば、 操作タイムアウト値を 30 分に設定する場合、この手順で elasticityModeTimeOut 30 0 と指定します。
- getElasticityTimeOutMins
- 失敗と判断される前に Elasticity アクションの完了が許される時間 (分) を返します。