Alter Application (集約ストレージ)

ASOモードのMaxL alter application文は、Essbaseアプリケーション全体の設定を変更するために役立ちます。

非集約ストレージ・バージョンはここをクリック

構文

図altapp_as.gifの説明

キーワード

MaxL alter applicationを使用して、次のアプリケーション全体の設定を変更します。ほとんどの文に必要な最小アプリケーション権限はアプリケーション・マネージャですが、例外が記載されています。

alter application APP-NAME set minimum permission …

すべてのユーザーに対して、アプリケーション内のすべてのデータベースへの最小レベルの権限を付与します。この最小よりも高い権限を持つユーザーは影響を受けません。

オプションはno_access、read、write、executeおよびmanagerです。

例:

alter application ASOsamp set minimum permission no_access;

alter application APP-NAME set variable …

既存の代替変数名に文字列値を割り当てます。変数が存在しない場合は、まずadd variableを使用して作成します。代替変数は、アプリケーション内の計算で参照される場合があります。

例:

alter application ASOsamp set variable CurrMonth Oct;

alter application APP-NAME set cache_size …

集約ストレージ・キャッシュが増加する可能性のある最大サイズを設定します。集約ストレージ・キャッシュは、この制限に達するまで動的に増加します。この設定は、アプリケーションを再起動した後に有効になります。現在設定されている制限を確認するには、次のMaxL文を使用します。

query application APP-NAME get cache_size;

アプリケーションまたはサーバー・レベルでASODEFAULTCACHESIZE構成設定が使用されている場合は、このMaxL文に効果はありません。

例:

alter application ASOsamp set cache_size 64MB;

集約ストレージ・キャッシュの最大サイズを64 MBに設定します。

alter application APP-NAME set type unicode_mode

アプリケーションをUnicodeモードに移行します。Unicodeモードへの移行は元に戻せません。

例:

alter application ASOsamp set type unicode_mode;

alter application APP-NAME load database …

アイドル状態のデータベースを(メモリーにロードして)開始します。アプリケーションで少なくともデータベース・アクセス権限がプロビジョニングされている必要があります。

例:

alter application ASOSamp load database Basic;

alter application APP-NAME unload database …

アクティブなデータベースを(メモリーからアンロードして)停止します。アプリケーションで少なくともデータベース・アクセス権限がプロビジョニングされている必要があります。

例:

alter application ASOSamp unload database Basic;

alter application APP-NAME enable startup

少なくともデータベース・アクセス権限を持つすべてのユーザーに、アプリケーションのロード(起動)を許可します。スタートアップはデフォルトで使用可能になっています。

例:

alter application ASOSamp enable startup;

alter application APP-NAME disable startup

すべてのユーザーにアプリケーションのロード(開始)を禁止します。スタートアップはデフォルトで使用可能になっています。

例:

alter application ASOSamp disable startup;

alter application APP-NAME enable autostartup

Essbaseサーバーの起動時にアプリケーションを自動的に起動します。デフォルトでは、自動スタートアップは使用不可になっています。

例:

alter application ASOSamp enable autostartup;

alter application APP-NAME disable autostartup

Essbaseサーバーの起動時にアプリケーションを自動的に起動しません。デフォルトでは、自動スタートアップは使用不可になっています。

例:

alter application ASOSamp disable autostartup;

alter application APP-NAME enable commands

十分な権限を持つすべてのユーザーに対して、アプリケーションのデータベースにリクエストを実行することを許可します。disable commandsの効果を戻すために使用します。disable commandsの設定は、セッション中のみ有効です。デフォルトでは、コマンドは使用可能になっています。

例:

alter application ASOSamp enable commands;

alter application APP-NAME disable commands

データベース情報の参照やデータベース設定の変更などの、データに固有でないリクエストを含む、アプリケーション内のデータベースに対するすべてのリクエストを禁止します。他の管理者を含む、すべてのユーザーが影響を受けます。管理者は、メンテナンス操作中にデータベースに誤って更新を加えることを防ぐための安全機構として、この設定の影響を受けます。この設定は、セッション中のみ有効です。この設定は即時有効になり、現在ログインしているユーザーと、セッション中に後からログインするユーザーに影響します。

注意:

コマンドの無効化が必要なメンテナンス操作を実行している場合は、コマンドが無効化されたのと同じセッションおよび同じスクリプト内でそれらのメンテナンス操作を実施する必要があります。

デフォルトでは、コマンドは使用可能になっています。

例:

alter application ASOSamp disable commands;

すべてのユーザーにアプリケーション・スコープにリクエストすることを禁止します。この文は、アプリケーション全体に対する更新やメンテナンス操作を実行する前に使用します。

alter application APP-NAME enable updates

十分な権限を持つすべてのユーザーに対して、アプリケーションのデータベースにリクエストを実行することを許可します。disable updatesの効果を戻すために使用します。更新の無効化は、セッション中のみ有効です。デフォルトでは、更新は有効になっています。

例:

alter application ASOSamp enable updates;

alter application APP-NAME disable updates

アプリケーションのデータベースへのリクエストをすべてのユーザーに禁止します。更新とメンテナンス操作を実行する前に使用します。disable updatesの設定は、セッション中のみ有効です。

注意:

更新を無効にする必要があるメンテナンス操作を実行している場合は、更新を無効にしたのと同じセッションと同じスクリプト内でそれらのメンテナンス操作を実行する必要があります。デフォルトでは、更新は有効になっています。

例:

alter application ASOSamp disable updates;

alter application APP-NAME enable connects

十分な権限を持つすべてのユーザーに、アプリケーションのデータベースに接続することを許可します。disable connectsの効果を戻すために使用します。デフォルトでは、接続は有効になっています。

例:

alter application ASOSamp enable connects;

alter application APP-NAME disable connects

アプリケーション・マネージャより低い権限を持つすべてのユーザーが、データベースの起動が必要なデータベースに接続することを禁止します。管理者がアプリケーション設定を再度有効化するまで、アプリケーション内のすべてのデータベースに対するデータベース接続が無効になります。

デフォルトでは、接続は有効になっています。

例:

alter application ASOSamp disable connects;

alter application APP-NAME enable security

セキュリティが無効になると、Essbaseはアプリケーション内のすべてのセキュリティ設定を無視し、すべてのユーザーをアプリケーション・マネージャとして扱います。デフォルトでは、セキュリティは有効です。

例:

alter application ASOSamp enable security;

alter application APP-NAME disable security

例:

alter application ASOSamp disable security;

alter application APP-NAME comment …

アプリケーションの説明を入力します(オプション)。説明には、80文字まで入力できます。

例:

alter application ASOSamp comment 'Sales application';

alter application APP-NAME clear logfile

アプリケーション・ディレクトリにあるアプリケーション・ログを削除します。以降のアプリケーション・アクティビティを記録しているエントリについては、新しいログが作成されます。

例:

alter application ASOSamp clear logfile;

alter application APP-NAME add variable …

アプリケーション・レベルの代替変数を名前を指定して作成し、オプションで、表す変数の文字列値を割り当てます。値は、set variableを使用して後から割当てまたは変更できます。代替変数は定期的に変化する情報のグローバルなプレースホルダとして機能します。代替変数は、計算およびレポート・スクリプトで参照される場合があります。

同じ名前の代替変数がサーバー、アプリケーション、およびデータベース・レベルで存在する場合、変数の優先順位は次のようになります。データベース・レベルの代替変数は、アプリケーション・レベルの変数に優先し、アプリケーション・レベルの変数はサーバー・レベルの変数に優先します。

例:

alter application ASOSamp add variable Month Nov;

alter application APP-NAME drop variable …

代替変数とそれに対応する値をアプリケーションから削除します。

例:

alter application ASOSamp drop variable Month;

alter application APP-NAME rename to

アプリケーションの名前を変更します。アプリケーションの名前を変更すると、アプリケーションとアプリケーション・ディレクトリの名前が変更されます。

例:

alter application ASOSamp rename to Sample2;