ALI[GNSIZE]=blocks

ALL[OCATION]=blocks

ジャーナルファイルの割り当てサイズを設定します。GT.Mは、この情報を使用して、ジャーナル・ファイルで使用可能なディスク・スペースを最初に確認する時期を決定します。作成時のジャーナル・ファイルのサイズは定数（GT.Mバージョンに依存）ですが、ジャーナル・ファイルがALLOCATIONで指定されたサイズに達すると、すべての拡張機能が、ジャーナル・ファイルに使用されるデバイスで使用可能な空き容量のチェックを生成します。

利用可能な空きスペースが拡大サイズより多くないときはいつも、GT.Mはシステムログへの情報メッセージを発行します。GT.Mは、スペースがなくなる前に、ジャーナル・ファイルを保持しているファイル・システムの容量が少ないことを識別するための操作補助として、これらの拡張の検査を提供します。ジャーナル・ファイルを保持しているファイル・システム上に使用可能な空き領域がなくなると、GT.Mは対応するデータベース・ファイルのジャーナリングを停止します。

デフォルトのALLOCATION値は2048ブロックです。許可される最小値は2048です。最大値は8,388,607（4GB-512バイト、最大ジャーナル・ファイル・サイズ）です。

AU[TOSWITCHLIMIT]=blocks

ジャーナルファイルのサイズの制限を指定します。ジャーナルファイルのサイズが制限に達すると、GT.Mは自動的に新しいジャーナルファイルへ暗黙的にオンラインスイッチを実行します。

AUTOSWITCHLIMITのデフォルト値は8386560で、最大値は8388607ブロック（4GB〜512バイト）です。AUTOSWITCHLIMITの最小値は16384です。もしAUTOSWITCHLIMITと割り当て値の差が拡張値の倍数でない場合、GT.Mは値を切り捨てて拡張値の倍数にし、情報メッセージを表示します。AUTOSWITCHLIMITの丸められた値が最小値よりも小さい場合、GT.Mはエラーを生成します。

もし、GDEまたはMUPIP SET -JOURNALのどちらかを使用して（ALLOCATION + EXTENSION > AUTOSWITCHLIMIT）のような領域(Region)のALLOCATION、EXTENSION、およびAUTOSWITCHLIMITの値を指定すると、GT.Mは、ALLOCATIONをAUTOSWITCHLIMITと一致するように設定し、JNLALLOCGROWメッセージを生成します。

ジャーナルの自動切り替え時間を含むジャーナル拡張時間では、もし領域(Region)の（ALLOCATION + EXTENSION > AUTOSWITCHLIMIT）の場合、GT.Mは、使用可能なジャーナル・ディスク・スペースが少ないことを警告するために、EXTENSIONおよびAUTOSWITCHLIMITのうち大きい方を増分として使用します。それ以外の場合は、EXTENSIONを使用します。

[NO]BEFORE_IMAGES

1つのアップデートが修正しようとしているGDSブロックのBEFORE_IMAGESをジャーナルに取り込むかどうかを制御します。SET -JOURNAL=ONは、付随するジャーナル・オプション・リストにBEFORE_IMAGESまたはNOBEFORE_IMAGESのいずれかを含める必要があります。

もし同じジャーナル・オプション・リストにNOBEFORE_IMAGESとBEFORE_IMAGESの両方を指定すると、最後の指定が前の指定を上書きします。

GT.MはONオプションのみで新しいジャーナル・ファイルを作成するため、すべてのON仕様にはBEFORE_IMAGESまたはNOBEFORE_IMAGESが含まれている必要があります。もしユーザーがOFFオプションと共に[NO]BEFORE_IMAGESを指定した場合は、何の目的も果たしません。

ただし、NOBEFORE-IMAGE ジャーナリングから(へ) BEFORE-IMAGEジャーナリングへ(から)データベースのオンラインスイッチを実行することが可能ですが、もしBEFORE-IMAGESのないデータベースのためにジャーナルファイルセットの1つでも遭遇するならば、逆方向のリカバリーが決して成功しないことを理解することが重要です。

BU[FFER_SIZE]=blocks

ジャーナル・ファイル出力をバッファーするために使用されるメモリーの量を指定します。

MUPIPでは、BUFFER_SIZEを変更するためにデータベースへのスタンドアロン・アクセスが必要です。したがって、GT.Mは、現在のジャーナル・バッファ・サイズをジャーナル・ファイルのオンライン・スイッチの一部として変更するために、BUFFER_SIZEオプションの使用を制限します。

デフォルト値は2308ブロックです。最小のBUFFER_SIZEは2307ブロックです。最大BUFFER_SIZEは32Kブロックです。これは、ジャーナル・ファイル出力に設定できる最大バッファーが16MBであることを意味します。

DISABLE

MUPIP SETの-NOJOURNAL修飾子と同等です。ジャーナリングは、名前のある領域(Region)またはファイルのオプションではないものを指定します。もしユーザーがDISABLEを指定すると、MUPIP SETは ジャーナル・オプション・リストの他のすべてのオプションを無視します。

ENABLE

データベース・ファイルまたは領域(Region)をジャーナリング可能にします。デフォルトでは、同じオプション・リストにOFFが指定されていない限り、ENABLEはジャーナリングをONにします。ENABLEを含むコマンドには、BEFORE_IMAGESまたはNOBEFORE_IMAGESも指定する必要があります。

EP[OCH_INTERVAL]=seconds

seconds(秒) は、2つの連続するEPOCH間の経過時間の間隔を指定します。EPOCHはチェックポイントで、データベースファイルに対するすべての更新がディスクにコミットされます。すべてのジャーナル・ファイルは、エポック・レコードが含まれています。

より小さなEPOCH_INTERVALは、（より頻繁なチェックポイントのために）ラン・タイム・システム上のI/O負荷の増加のコストに対して、クラッシュ後の回復時間を短縮します。より大きなEPOCH_INTERVALは逆の効果を持ちます。したがって、EPOCH=intervalを設定すると、実行時間が長くなり、間隔の値が大きくなり、より効率的なROLLBACK処理が行われ、間隔の値が小さくなります。

デフォルトのEPOCH_INTERVAL値は300秒（5分）です。最小値は1秒です。最大値は32,767秒（32K未満）、つまり約9.1時間です。もしジャーナリングを有効にしてEPOCH_INTERVALの値を指定しないと、GT.Mはその領域(Region)の最後のジャーナル・ファイルのEPOCH_INTERVALの値を継承します。EPOCH_INTERVALは、ユーザーがジャーナリングをオンにし、以前のジャーナル・ファイルがない場合にのみ有効になります。

EX[TENSION]=blocks

blocks は、ファイルが拡張されて満杯になるジャーナルファイル拡張のサイズを指定します。

EXTENSION=blocks は、ALLOCATIONが使い尽くされた後、ジャーナル・ファイルに使用可能なディスク・スペースをGT.Mが見直すべき時を指定します。また、各再調査時で利用できるスペースの量も指定します。

UNIXファイルシステムでは遅延割り当て方式が使用されるため、割り当て値と拡張値ではジャーナル・ファイルの物理ディスク・ブロック割り当ては行われません。

この値は、GT.Mがファイル・システムを調べて、ジャーナル・データの拡張分を保持するのに十分なスペースがあるかどうかを判断します。ジャーナル・ファイルがALLOCATIONのサイズとEXTENSIONの倍数に達すると、GT.Mは、ファイル・システムを調べて空き領域がEXTENSIONの3倍未満であれば、オペレータ・ログに警告を書き込みます。GT.Mは、スペースがなくなる前に、ジャーナル・ファイルを保持しているファイル・システムの容量が少ないことを識別するための操作補助として、これらの拡張の検査を提供します。ジャーナルファイルを保持しているファイル・システムに空き容量がなくなった場合、または、ジャーナル・ファイルを自動切り替えしようとするプロセスの許可がない場合、GT.Mは対応するデータベース・ファイルのジャーナリングを停止します。

デフォルトのEXTENSION値は2048ブロックです。最小拡張はゼロ（0）ブロックで、最大値は1073741823（1ギガ以下）ブロックです。

F[ILENAME]=journal_filename

journal_filename はジャーナルファイルの名前を指定します。複数の領域(Region)を指定すると、FILENAMEはSET -REGIONと互換性がありません。

GT.Mはファイル名をベース名と拡張子の2つの構成要素として扱います。ジャーナルファイル名のフォーマットはbasename.extensionで、拡張子にピリオド (.)は含まれませんが、ファイル名に複数のピリオド (.)が含まれる場合、basenameには最後のピリオド (.)を除くすべてが含まれます。また、これらも注意してください。ファイル名にピリオド(.)が含んでないならば、"拡張子"は空の文字列("")です。

FILENAMEのデフォルト値の規則は次のとおりです。

ジャーナルファイル名にはユニコード文字を含めることができます。

ジャーナル・リカバリの場合、GT.Mは、同じデータベース・ファイルの前世代のジャーナル・ファイルの名前を格納するすべてのジャーナル・ファイルのヘッダーにフィールドを保持します。MUPIP SETがジャーナル状態をDISABLEDまたはOFFからONに変更すると、GT.Mは以前の世代のジャーナル・ファイル名の無い新しいジャーナルファイルを作成します。これは、特定のデータベースの新しいジャーナリングの開始であることを示します。ジャーナリングがすでにONになっていて、新しいジャーナル・ファイルを作成することをGT.Mが暗黙的に（AUTOSWITCHLIMITに達しているため）または明示的に（MUPIP SET JOURNALのために）必要な場合は、GT.Mは、以前の世代のジャーナルファイル名（適切な名前を変更した後）を新しいジャーナルファイルのヘッダーに追加します。

ジャーナル・ファイル・スイッチの前後の両方でジャーナリングがONになっているすべての場合では、現在のジャーナル・ファイルの異常終了を検出したためにGT.Mが暗黙の切り替えによって新しいジャーナルファイルを作成したとき、または、現在のジャーナルファイルがシステムクラッシュのために正しく閉じられてなくて、かつ、その後データベースがMUPIP RUNDOWNの対象だった場合、GT.Mは、前の世代のジャーナル・ファイル名を、新しいジャーナル・ファイルのヘッダー以外の内に保持します。

以前の世代のジャーナル・ファイル名は、現在の世代のジャーナルからのバック・リンクです。

GT.Mはエラーを生成し、FILENAMEが既存のファイルであり、そのデータベースのアクティブ・ジャーナル・ファイルではない場合、データベースのジャーナリング状態を変更しません。このようにして、GT.Mは、バック・リンクの可能なサイクルを防止する（例えば、a3.mjlはa2.mjlへのバックリンクを持ち、順にa1.mjlへのバックリンクを持ち、次にa1.mjlへのバックリンクはa3.mjlへのバックリンクを持ち、それによってサイクルを作ります）。サイクルがジャーナル回復を妨げる可能性があります。また、バックリンクのサイクルは、明示的なFILENAME仕様のためにのみ可能であり、そして、データベースからの既存のFILENAME特性に起因するものでも、デフォルトのFILENAMEの使用によるものでもないことに、注意してください。

NOPREVJNLFILE

ジャーナルファイルのバックリンクを削除します。

[NO]S[YNC_IO]

特定の追加のIOフラグを使用してジャーナルファイルを開くようにGT.Mに指示します（正確なフラグのセットは、SYNC_IOがサポートされているプラットフォームによって異なります。たとえば、LinuxではO_DIRECTフラグを使用します）。通常の操作では、データはジャーナル・ファイルに書き込まれますが、ジャーナルファイルからは読み込まれません。したがって、実際のワークロードとコンピュータ・システムによっては、SYNC_IOジャーナル・オプションを使用すると、より良いスループットが得られる場合があります。

このオプションの効果を経験的に判断する必要があります。これは、パフォーマンスの向上または影響を事前に予測する方法がないためです。SYNC_IOを使用してGT.Mの動作に機能的な違いはありません。もし異なるワークロードがSYNC_IOの異なる設定で最もよく動作すると判断した場合は、いつでもMUPIP SETを使用してワークロードを変更できます。

デフォルトはNOSYNC_IOです。もし同じジャーナル・オプション・リストにNOSYNC_IOとSYNC_IOの両方を指定すると、GT.Mは最後に現れたものを使用します。

OFF

後続のデータベースの更新をジャーナルファイルに記録しないようにします。ジャーナル・ファイルを作成せずにジャーナリング特性を確立するか、またはジャーナリングを開始するには、OFFを指定します。

SET -JOURNAL= のデフォルトはONです。

ON

そのジャーナル・ファイルの後続のデータベース更新を記録します。MUPIP SET -JOURNAL=ON は、付随するジャーナル・オプション・リストにBEFORE_IMAGESまたはNOBEFORE_IMAGESのいずれかを含める必要があります。デフォルトでは、もしこのコマンドによってデータベースの複製状態（詳細は 第7章: “データベースの複製” を参照）がOFFからONに変更され、JOURNAL=NOBEFORE_IMAGEが指定されていない場合、GT.MはBEFORE_IMAGEにジャーナル操作を設定します。

もし現在の世代のジャーナル・ファイルが破損/欠損がある場合、MUPIP SET -JOURNAL=ON は指定された領域(Region)のジャーナリングを暗黙的にオフにし、以前の世代のジャーナルファイルへのバックポインタを持たない新しいジャーナルファイルを作成し、ジャーナリングをオンに戻します。さらに、もし複製が有効になっている場合、MUPIP SETコマンドが、ジャーナル・プール・バッファの外で動作していて損傷したジャーナルファイルを参照する必要がない限りは、ジャーナリングをオフにし正常に戻る時に、MUPIP SET -JOURNAL=ONは、一時的に時間窓の中の複製WAS_ON状態を切り替えます。この操作の間、MUPIP SET -JOURNAL=ONは、領域(Region)のPREJNLLINKCUTメッセージをアプリケーションおよびオペレータ・ログにも送信します。この操作が、たとえ現在の世代のジャーナルファイルが破損/欠損してたとしてもジャーナリングが続行されることを確保している間は、バックポインタのない新しいジャーナルファイルを作成すると、以前のジャーナルファイルとの不連続が作成されます。したがって、FIPは、MUPIP RECOVER/ROLLBACKがこの不連続を過ぎて戻ることができないので、できるだけ早くデータベースバックアップを取ることを推奨します。また、他の領域(Region)のRECOVER/ROLLBACKが影響を受けないように、インスタンス内のすべての領域(Region)上のジャーナル・ファイルは(REGION "*"を使って)切り替えることを検討してください。

SET -JOURNAL= のデフォルトはONです。

Y[IELD_LIMIT]=yieldcount

yieldcount は、決して最適でないI/O操作を開始する前に、ジャーナル・バッファの内容をディスクにフラッシュしようとするプロセスが、そのタイムスライスを生成し、かつ、同時にアクティブなプロセスによって追加のジャーナル・バッファ・コンテンツが満たされるを待つ、そのプロセスの回数を指定します。

軽い負荷状態には小さいYIELD_LIMITが適していますが、負荷が増加するにつれて大きな値が適切です。

最小のYIELD_LIMITは 0（ゼロ）で、最大のYIELD_LIMITは 2048 で、デフォルトYIELD_LIMITは8です。

ディスクはデータのブロック全体のみを書き込むことができるので、多くのI/Oサブシステムは、ブロック全体の単純な書き込みとは異なり、書き込むデータが部分ブロックであるときにREAD-MODIFY-WRITのE操作を実行します。YIELD_LIMIT修飾子は、その間にジャーナル・バッファがより多くのコンテンツを蓄積し、最適な全ブロック書き込みを行うことを期待して、できるだけそのような書き込みを延期することによって、最適には達していない部分ブロック書き込みの頻度を減らそうとします。