8.3.1　adshappagentコマンド（アプリケーション実行エージェント起動コマンド）【Windows実行環境限定】

形式

adshappagent [-q] [-c]

機能

アプリケーション実行エージェントを起動し，adshappexecコマンドの実行を監視して，adshappexecコマンドで指定した実行アプリケーションを起動します。

adshappagentコマンドはadshappexecコマンドを実行するユーザー（JP1/BaseのマッピングOSユーザー）ごとに実行する必要があります。

使用するユーザーにはWindowsの管理ツールの［ローカルセキュリティポリシー］-［ローカルポリシー］-［ユーザー権利の割り当て］-［グローバルオブジェクトの作成］権限を付与する必要があります。

セキュリティ上の問題などから「グローバルオブジェクトの作成」権限を有効にできない場合は，「グローバルオブジェクトの作成」権限を有効にできるユーザーでアプリケーション実行エージェント機能を使用してください。

Windowsのスタートアップに登録，解除を画面操作でできる機能も提供します。この機能を使用し，ログオン時に自動的に起動する運用とすることを推奨します。

Windowsの［スタート］メニューから，［すべてのプログラム］−［Advanced Shell］−［アプリケーション実行エージェント］を選択すると，タスクバーの通知領域に［アプリケーション実行エージェント］アイコンが表示されます。

［アプリケーション実行エージェント］アイコンにカーソルを当てると，次のようにアイコンの説明が表示されます。

アイコンは次のように状態が変わります。

（アイコン色 白）実行アプリケーション未起動。

（アイコン色 緑）実行アプリケーション実行中。

（アイコン色 黄）実行アプリケーション強制終了。

起動中の実行アプリケーションの情報を参照する場合は，adshappagentまたはadshappexecコマンドの引数-cを使用してください。ジョブ定義スクリプト内などからは情報を取得できません。

引数

引数の指定なし

アプリケーション実行エージェントを起動します。

-q

アプリケーション実行エージェントを終了します。

クラスタ連携の系切り替えをする場合など，アプリケーション実行エージェントを終了させる場合，この引数を使用します。

-c

アプリケーション実行エージェント機能共有メモリの内容を標準出力に出力します。

この引数はadshcollectコマンドで使用します。

使用する場合にはファイルにリダイレクトする必要があります。

コンソールには表示しません。

また，取得する情報はログインユーザーごとの情報であり，実行したログインユーザーで取得する必要があります。

終了コード

終了コード	意味
0	正常終了
0以外	エラー終了

注意事項

• adshappagentコマンドは，adshappexecコマンド実行前に実行しておく必要があります。

• adshappexecコマンドで実行アプリケーションの終了を待つ設定（-w）をした場合は，実行アプリケーションの終了までアプリケーション実行エージェントを終了しないでください。終了した場合，起動した実行アプリケーションは起動したままとなり，実行アプリケーションを起動したジョブはエラーとなります。

• ドメインユーザーとドメイン以外のユーザーもアプリケーション実行エージェント機能では別ユーザーとして扱います。

• アンインストール時，およびバージョンアップインストール時にはアプリケーション実行エージェントを終了し，アプリケーション実行エージェントをスタートアップに登録したユーザーでログインし，スタートアップからアプリケーション実行エージェントを削除する必要があります。スタートアップから削除しない状態でアンインストールした場合は，再度Advanced Shellをインストールし，スタートアップが残っているユーザーでログインし，スタートアップの解除をする必要があります。

• アプリケーション実行エージェントプログラム実行中に系切り替えをした場合，系切り替え前の情報を系切り替え後に引き継ぎません。-qオプションでアプリケーション実行エージェントを終了し，系切り替え実施後にアプリケーション実行エージェントを起動してください。

• 同一のユーザーに対してアプリケーション実行エージェントは一つしか起動できません。複数起動した場合，エラーとなります。

• adshappagentコマンドはログオン空間で動作させる必要があります。サービス空間で動作するJP1/AJSのジョブの延長で動作させないでください。動作させた場合，対話型の実行アプリケージョンは操作できません。

• 引数-qおよび引数-cはほかの引数と同時に指定しないでください。同時に指定した場合はエラーとなります。