MGRB.INIは、MRB用の環境設定ファイルです。MGRB.INIファイルは、MRBの初期設定処理中に読み込まれます。MGRB.INIファイルが見つからない場合、MRBはデフォルト値で初期設定を行います。
以下のパラメータが定義されています。
キーワード |
意味 |
|||||
BrokerPort |
MRBのポート番号を指定します。このポートにリクエストが送られてきていないか、MRBにより常時チェックされます。MRBは、指定されたポート番号で始まる5つの連続したポートを開くことができます。
ポート番号のデフォルトは、Magic uniPaaSのレビジョンによって変わります。 |
|||||
タイムアウト(単位:秒)で、非同期コールの実行中、この時間が経過するとエンジンからMRB に対してI-AM-ALIVE メッセージが送出されます。 この値を0 にした場合、エンジンからMRB にはI-AM-ALIVE メッセージは送られなくなります。このため、タスクの実行中、エンジンが何らかの原因でクラッシュしたり異常終了した時でも、エンジンからI-AM-ALIVE メッセージが送られることがなくなるため、その状態はMRB には認識不可能になります。
|
||||||
TCP/IP操作(接続/送信/受信)が、失敗する前にリトライする最大時間(単位:秒)です。 MRBによって送信されたメッセージに対してMGRB.INIファイル内のこの設定はMGREQ.INIファイル内の設定を上書きします。「通信タイムアウト」のトピックを参照してください。 汎用のリクエスタレイヤーの低レベルのメッセージは、MGREQ.INIファイルの設定が使用されます。 デフォルトは10秒です。最小値は1秒です。 |
||||||
PasswordSupervisor |
このキーワードを使用して、ユーザからのMRB に対するアクセスを制限できます。 パスワードを指定した場合、MRB の次の処理でセキュリティチェックが実行されます。
指定を省略した場合には、MRB の処理ではセキュリティチェックは行われないため、ユーザ名とパスワードはチェックされません。
|
|||||
PasswordQuery |
オプションで省略できます。このキーワードを使用して、ユーザからのMRB に対するアクセスを制限できます。 パスワードを指定した場合、あるユーザから別のユーザのリクエストの照会が実行された時、そのユーザのユーザ名とパスワードがチェックされます。リクエストは提出時に使用されたユーザ名とパスワードを使用して行なわれるため、自分のリクエストを照会する場合には、制限はありません。 リクエストの提出時に使用されるユーザ名とパスワードとして、[設定/サービス]のユーザ名とパスワード、Magic uniPaaSのアプリケーションのログオンに使用されたユーザ名とパスワード、MGREQ.INI ファイルに保存されているユーザ名とパスワードは全てMRB により受け入れられます。 この指定を省略した場合、ユーザ名とパスワードはチェックされません。そのためリクエストは、どのユーザからも照会が可能となり、ユーザは別のユーザのリクエストを確認できます。
|
|||||
ReLoad |
Magicアプリケーションサーバのインスタンスが異常終了した場合、MRBが自動的にMagicアプリケーションサーバを再ロードするかどうかを指定します。
|
|||||
Log |
上位レベルのMRBの動作(初期化、リクエストの受信、アプリケーションサーバの割当、アプリケーションサーバ情報の送信など)を記録するログファイルを指定します。このログにより、特定のリクエストの処理を確認できます。
ファイル名 ログファイル名を指定します。ファイル名に空白を含むことはできません。 同期
レベル
低レベルのMRBの動作(接続、送信、受信など)を記録できるようにするには、MRBのカレントディレクトリにあるMGREQ.INIファイルでのログ設定を行います。 |
|||||
ReqHistorySize |
MRBは、処理した各リクエストについての履歴ログを持っています。(Magic uniPaaSのRQ関数やコマンドラインリクエスタのQUERY=LOGパラメータでアクセス可能です。) このキーワードは、MRBが履歴ログに保持するリクエストの数を制御します。
デフォルトは、20,000、最小値は5,000、最大価値は100,000です。 |
|||||
ActivityLog |
MRB の動作イベント内容を記録するログファイルのファイル名を指定します。
指定されない場合、「mrb_event.log」という名前で作成されます。 |
|||||
この値は、全てのアプリケーションサーバに対し、指定された期間内に段階的にシャットダウンするように指示するための数秒です。
デフォルト(=1)では、全てのアプリケーションに対して、直ちにシャットダウンするように指示し、MRB自身をも直ちにシャットダウンされます。 |
||||||
DelayServiceStart |
MRBをサービスで起動した場合、起動を指定した秒数分遅らせるように指定できます。 |
|||||
EnableFilters |
「Filters」パラメータで指定されたフィルタ処理を有効にするかどうかを指定します。
この指定が「N」の場合、「Filters」や「AllowReserve」の指定は意味がありません。 デフォルトは、「N」です。 |
|||||
リクエストのフィルタ機能を利用すると、複数の異なるリクエストに対してMRB やMagicエンジンが利用できるスレッド数に応じて処理が案分されます。 設定方法 フィルタ機能を有効にするには、MGRB.INIの[MRB_ENV]セクションにて以下のパラメータを指定します。
フィルタ用キーワードの指定 コールリモートの場合
この場合、20 スレッドのライセンスを持つアプリケーションサーバが、異なる種類のリクエストを処理する際に、以下のような割合を指定することになります。
インターネントリクエスタ/ コマンドラインリクエスタの場合
|
||||||
AllowReserve |
Filterキーワードの割合の合計が100% に満たない場合、残りの割合を他のフィルタ用に利用できるようにするかどうかを指定します。
|
|||||
デフォルトは、1,000リクエストです。 MRBがすでにそのキュー内にQueueMaxSizeリクエストを持っている場合、直ちに送信できない以降のリクエスト(同期または非同期)は、キューに入らず、リクエスタは、エラー-198(キューの上限に達した)を受け取ります。 |
||||||
TerminateEnginesDuringShutdown |
このキーワードは、[ShutdownTimeout]キーワードに0より大きな値が設定された場合のみ有効です。 「Y」が設定された場合、MRBによって起動された全ての実行エンジンを終了させます。段階的に終了できなかった場合でも、MRBが記録した実行エンジンのプロセスIDに基づいて、指定されたタイムアウト値を越えた時点でシャットダウンさせます。
|
|||||
ContextsUsage |
MRBがファイルにコンテキストの使用内容を保存するかどうかを指定します。コンテキストが閉じた時点で、データが保存されます。実行時エンジンの実行モードでバックグラウンドに設定される場合のみ有効です。この場合、コンテキストは常にメイン/単一コンテキストになります。
|
|||||
ContextsUsageLog |
Contexts Usageで出力するファイル名を指定します。値は相対/絶対パスで指定できます。 デフォルト値は、ContextsUsage_YYYY_MM_DD.Logです。 |
|||||
|
||||||
|
割合が同じ場合は、より高い最大スレッド数が定義されたエンジンが選択されます。