Alter System
「Essbaseサーバー」の状態を変更します。 アプリケーションの起動と停止、システム全体の変数の変更、パスワードとログイン・アクティビティの管理、ユーザーの切断、プロセスの終了またはサーバーの停止を行います。
必要な権限: 管理者。
キーワード
- load application
-
アプリケーションを起動するか、「Essbaseサーバー」上のすべてのアプリケーションを起動します。
- unload application
-
アプリケーションを停止するか、「Essbaseサーバー」上のすべてのアプリケーションを停止します。 アプリケーションをアンロードすると、すべてのアクティブなリクエストおよびデータベース接続が取り消され、アプリケーションが停止します。 Essbaseで、アクティブなリクエストおよびデータベース接続を取り消してアプリケーションを停止しようとしたときに問題が発生した場合、アプリケーション・ログにエラーが記録されます。
アクティブなリクエストおよびデータベース接続があるアプリケーションを停止しない場合は、no_force文法を使用します。 no_forceを使用する場合:
-
アプリケーションにアクティブなリクエストおよびデータベース接続がある場合、アプリケーションは停止されず、実行を続行
-
アプリケーションにアクティブなリクエストおよびデータベース接続がない場合、no_forceを指定せずに「アプリケーションのアンロード」を使用した場合と同様に、アプリケーションは停止
-
- set session_idle_limit
-
「Essbaseサーバー」がユーザーをログオフする前に、セッションが非アクティブになるまでの許容時間間隔を設定します。 設定できる最小制限は5分(300秒)です。 セッション・アイドル制限がnoneに設定されている場合、すべてのユーザーは「Essbaseサーバー」が停止するまでログオンしたままになります。
デフォルトのユーザー・アイドル・ログアウト時間は60分です。 ユーザーがバックグラウンドで計算を開始すると、60分後にアイドル状態とみなされてログアウトされますが、計算はバックグラウンドで続行されます。
ユーザーは、ログアウトしたために計算が誤って停止したと想定する可能性があるため、次のいずれかを実行してユーザー・エクスペリエンスを修正できます:
-
フォアグラウンドでの計算の実行
-
セッションのアイドル制限を計算の期間を超える時間に増やすか、何もしないようにします
-
- set session_idle_poll
-
非アクティブ・チェックおよびセキュリティ・バックアップのリフレッシュの時間間隔を設定します。 セッション・アイドル・ポーリングで指定された時間間隔によって、Essbase命令が提供されます:
-
ユーザー・セッションが、alter system文で
session_idle_limit
によって示された許容される非アクティブ間隔を超えたかどうかを確認する頻度を示します。 -
セキュリティ・バックアップ・ファイルを更新する頻度を指定します。
session_idle_poll
がゼロに設定されている場合、セキュリティ・バックアップ・ファイルは5分ごとにリフレッシュされます。
-
- set invalid_login_limit
-
ユーザーが許可するログイン試行の失敗回数を設定します。この回数を超えると、システムはログイン試行を無効にします。 この設定を変更すると、カウンタは0にリセットされます。 無効なログイン制限がnoneに設定されている場合、制限はありません。 デフォルトでは、制限はありません。
- set inactive_user_days
-
システムによって無効化されるまでにユーザー・アカウントが非アクティブのままでいられる日数を設定します。 カウンタは、ユーザーがログインするか、編集されるか、管理者によってアクティブ化されるとリセットされます。 非アクティブな日数制限がnoneに設定されている場合、ユーザー・アカウントは使用されていなくても有効なままです。 デフォルトでは、制限はありません。
- set password_reset_days
-
ユーザーがパスワードを保持できる日数を設定します。 割り当てられた日数が経過すると、ユーザーはログイン時にパスワードの変更を求められます。 カウンタは、ユーザーがパスワードを変更したとき、ユーザーが編集したとき、または管理者によってアクティブ化されたときにリセットされます。 パスワード・リセット日数制限がnoneに設定されている場合、パスワード保存の組込み制限はありません。 デフォルトでは、制限はありません。
- set variable
-
システム上の既存の代替変数の値を変更します。 値は256バイトを超えることはできません。 先頭のアンパサンド(&)以外の任意の文字を含めることができます。
- set server_port
-
指定されたEssbase構成プロパティのポート範囲を展開します。 各Essbaseアプリケーションは、この範囲のポートを使用します。 使用可能なポートがなくなると、エラー・メッセージが表示されます。
ノート:
ポート範囲を拡張できるのは、開始ポート範囲がSERVERPORTBEGINより小さく、終了ポート範囲がSERVERPORTENDより大きい場合のみです。
- delete export_directory
-
データベースからエクスポートされたリンク・レポート・オブジェクト用に作成されたディレクトリを、
ARBORPATH\app
で作成されたディレクトリに削除します。 この文法は、エクスポートされたLROがimport lroを使用してデータベースに移行され、エクスポートされたLRO情報を含むディレクトリが不要になった後に使用します。ノート:
このプロセスは、export lro文のDBS-EXPORT-DIRオプションを使用して
ARBORPATH\app
で作成されたディレクトリに対してのみ機能します。 export lro文のFULL-EXPORT-DIRオプションを使用して他の場所で作成されたディレクトリでは機能しません。ARBORPATH\app
でエクスポートされたリンク・レポート・オブジェクト・ディレクトリの名前のリストを表示するには、display system export_directory
を使用します。 - add variable
-
システム・レベルの代替変数を名前で作成し、オプションで、その変数が表す文字列値を割り当てます。 この値は、後で「変数の設定」を使用して割当てまたは変更できます。 置換変数は、定期的に変更される情報のグローバル・プレースホルダーとして機能します。 代替変数は、計算およびレポート・スクリプトで参照できます。
サーバー、アプリケーションおよびデータベース・レベルに同じ名前の置換変数が存在する場合、変数の優先順位は次のようになります: データベース・レベルの置換変数は、アプリケーション・レベルの変数よりも優先され、サーバー・レベルの変数よりも優先されます。
- drop variable
-
代替変数とそれに対応する値をシステムから削除します。
- logout session all
-
「Essbaseサーバー」で実行されているすべてのユーザー・セッションを終了します。
- logout session...force
-
リクエストを処理している場合でもセッションを終了します。 リクエストは安全なポイントに進むことができ、その後トランザクションはロールバックされます。
- logout session <session-id>
-
一意のセッションID番号でセッションを終了します。 セッションID番号を確認するには、display sessionを使用します。
- logout session by user
-
「Essbaseサーバー」全体で、または特定のアプリケーションまたはデータベースに制限された特定のユーザーによる現在のセッションをすべて終了します。
- logout session by user on application
-
特定のアプリケーション全体で、特定のユーザーによる現在のセッションをすべて終了します。
- logout session by user on database
-
特定のデータベース全体で、特定のユーザーによる現在のセッションをすべて終了します。
- logout session on application
-
特定のアプリケーションの現在のユーザー・セッションをすべて終了します。
- logout session on database
-
特定のデータベースの現在のユーザー・セッションをすべて終了します。
- shutdown
-
「Essbaseサーバー」を停止します。
- kill request all
-
「Essbaseサーバー」で現在のリクエストをすべて終了します。
ノート:
MaxL Shellでアクティブなリクエストを終了するには、ESCキーを押します。
- kill request <session-id>
-
セッションIDで示された現在のリクエストを終了します。 display sessionを使用してセッションIDを取得できます。
- kill request by user
-
「Essbaseサーバー」上の指定されたユーザーによる現在のリクエストをすべて終了します。
- kill request on application
-
指定したアプリケーションの現在のリクエストをすべて終了します。
- kill request on database
-
指定したデータベースで現在のすべてのリクエストを終了します。
- enable unicode
-
Unicodeモードのアプリケーションを作成し、Unicodeモード以外のアプリケーションをUnicodeモードのアプリケーションに移行できるように「Essbaseサーバー」を設定します。
- disable unicode
-
「Essbaseサーバー」がUnicodeモードのアプリケーションの作成またはUnicodeモード以外のアプリケーションからUnicodeモードのアプリケーションへの移行を許可しないようにします。
- reconcile
-
essbase.sec
ではなくセキュリティ・バックアップ・ファイル(essbase_timestamp.bak
)を使用してEssbaseを起動する場合は、外部ディスク上のEssbaseの状態と一致するようにセキュリティ・ファイルを調整します。 この文法では、セキュリティ・ファイルと外部ディスク間のアプリケーション情報とデータベース情報の不一致が表示されます:-
アプリケーション・フォルダがディスク上にあるが、セキュリティ・ファイル内にない場合は、不一致を示すメッセージが表示されます。 (Essbaseは、
ARBORPATH/app/appname
ディレクトリにappname.app
ファイルが存在するかどうかをチェックします。)このシナリオでは、
force
オプションは適用されません。 -
アプリケーション・ファイルがディスク上ではなくセキュリティ・ファイル内にある場合は、不一致を示すメッセージが表示されます。
force
オプションは、セキュリティ・ファイルからアプリケーションを削除します。 -
アプリケーション・データベース・フォルダがディスク上にあるが、セキュリティ・ファイル内にない場合は、不一致を示すメッセージが表示されます。 (Essbaseは、
ARBORPATHapp/appname/dbname/cube
ディレクトリにdbname.otl
ファイルが存在するかどうかをチェックします。)このシナリオでは、
force
オプションは適用されません。 -
アプリケーション・データベース・ファイルがセキュリティ・ファイルにはあるが、ディスクにはない場合は、不一致を示すメッセージを表示します。
force
オプションは、セキュリティ・ファイルからデータベースを削除します。
-
ノート
SESSION SPECIFICATION
sessionは、「Essbaseサーバー」への単一ユーザー接続です。 セッションは、コンテキストを示すキーワードと名前、または一意のセッションID番号で識別できます。
requestは、アプリケーションの起動やデータベース・アウトラインの再構築など、ユーザーまたは別のプロセスによって「Essbaseサーバー」に送信される問合せです。 各セッションで一度に処理できるリクエストは1つのみです。
管理者がセッションを終了しようとした時点でセッションがリクエストを処理している場合、管理者は最初にリクエストを終了するか、alter systemで使用可能なforce kewyordを使用してセッションおよび現在のリクエストを終了する必要があります。

例
alter system unload application Sample;
Sampleアプリケーションが現在実行中の場合は停止します。
alter system unload application all;
すべてのアクティブなリクエストを終了し、すべてのアプリケーションを停止します。
alter system unload application Sample no_force;
Essbaseはサンプル・アプリケーションのアンロードを準備しますが、アクティブなリクエストが実行されている場合、アプリケーションは停止しません。
alter system shutdown;
実行中のすべてのアプリケーションを停止し、「Essbaseサーバー」を停止します。
alter system logout session by user Fiona;
Fionaが接続されているアプリケーションまたはデータベースからFionaを切断します。
ユーザーをログアウトするには、そのユーザーが所有するセッションをログアウトします。
alter system set password_reset_days 10;
パスワードの変更を10日後にすべてのユーザーに要求するように指定します。 ユーザーの日数は、ユーザーがパスワードを変更するか、管理者によって編集または再アクティブ化されるとリセットされます。