このセクションでは、ジャーナル・アクション(action)修飾子について説明します。

-ROLLBACK [{-ON[LINE]|-NOO[NLINE]}]

-ROLLBACKは、レプリケートされたデータベースの主要なジャーナル操作を開始します。MUPIP JOURNALコマンドは、他のアクション修飾子で-ROLLBACKを指定できますが、-RECOVERでは指定できません。もし -FETCHRESYNCを使用しない場合、データベースは最後の一貫性のある状態にまでロールバックします。ジャーナル・ファイル選択にはアスタリスク（*）修飾子のみが使用できます。つまり、-ROLLBACKはジャーナル・ファイルを単独で選択します。

-NOO[NLINE]

ROLLBACKにデータベースとレプリケーション・インスタンス・ファイルへの排他アクセスが必要であることを指定します。つまり、データベースとレプリケーション・インスタンス・ファイルは、-ROLLBACK -NOONLINEの間ではアクセスできません。

デフォルトでは、MUPIP JOURNAL-ROLLBACKは-NOONLINEです。

-ON[LINE]

データベースとレプリケーション・インスタンス・ファイルへの排他アクセスを必要とせずにROLLBACKを実行するように指定します。

GT.Mは、プロセスが同時発生する MUPIP JOURNAL -ONLINE -ROLLBACKを検出するたびに ISV $ ZONLNRLBKをインクリメントします。

もしMUPIP JOURNAL -ONLINE -ROLLBACKの完了後のデータベースの論理状態が、MUPIP JOURNAL -ONLINE -ROLLBACKの開始時のデータベースの論理状態と一致する場合、すなわち、コミットされていないTPトランザクションまたは非TPミニ・トランザクションのみが削除またはコミットされると、すべてのトランザクション（TPまたは非TP）によって再起動を招きます。

もしMUPIP JOURNAL -ONLINE -ROLLBACKがデータベースの論理状態を変更した場合、その動作は次のようになります：

• -ONLINE -ROLLBACK は ISV $ZONLNRLBKをインクリメントします。

• トランザクション内のトリガーコードを含むTPトランザクションでは、-ONLINE -ROLLBACKはトランザクションを再開します。

• トリガーによって引き起こされる暗黙のトランザクションを含む非TPミニ・トランザクションでは、-ONLINE -ROLLBACKはDBROLLEDBACKエラーを生成し、$ETRAPまたは$ZTRAPが有効な場合は、エラー・トラップを呼び出します。

MUPIP JOURNAL -ONLINE-ROLLBACKが動作している間に試行されたユーティリティ/コマンドは、ROLLBACKが完了するまで待機します； $gtm_db_startup_max_wait 環境変数は待機時間を設定します。$gtm_db_startup_max_wait の詳細については “環境変数” を参照してください。

	注意
	MUPIP ROLLBACK -ONLINEは状態空間でデータベースをバックワードに取ることができるので、呼び出すときに実行しようとしていることを理解していることを確認してください。FISはこれをはるかに大きなプロジェクトに向けた一歩として発展させ、広く有用ではないと予想しています。

-ROLLBACK -BACKWARDは、以下の条件でエラーメッセージを表示して終了します：

1. 処理されたジャーナル・ファイルに対応するデータベースの領域(Region)には、レプリケーション状態がオフになっています。レプリケートされた領域(Region)と少なくとも1つの複製されていないがジャーナリングされた領域(Region)がある構成は、複製元サーバーによって許可されていないことに注意してください。このような構成では、ジャーナル・プールを設定せずに起動時にソースサーバーがエラーになります。レプリケートされた領域(Region)へすべてのGT.Mの更新がジャーナル・プールのセットアップを持つためにソース・サーバーが必要とされて以来、構成がレプリケートされた領域(Region)、また、「複製されないそしてジャーナルされてない」(non-replicated-and-non-journaled)領域のみを持つために変更されるまで、更新は不要です。

2. コマンド引数により識別されたジャーナル・ファイルに対応する任意のデータベース領域は、ジャーナリングス・テータス DISABLEまたはENABLEとOFFを持ちます。

3. ジャーナルファイルに対応する任意のデータベース領域は、ジャーナルステータスENABLE そしてONを持ち、しかし、データベースファイルのヘッダーに指定されたジャーナルファイル名は、コマンドの引数によって識別される1つよりも異なっています。

もし不完全な囲い(フェンス)を持つトランザクションが見つかった場合、それは壊れているとみなされます。ロールバックの持続期間については、レプリケーションでは、すべての領域ではOFFにされ、そして、ロールバックの終わりでONに戻されます。

ロールバックの前方フェーズの間に、もし完全なトランザクション（フェンスされている、または、フェンスされてない）が、破損したトランザクションの後に発見されるならば、それは失われたトランザクションとして考えられます。ロールバックのフォワードフェーズの間では、MUPIPジャーナルはDBへ論理更新されます。すべてが壊れそして失われたトランザクションは、ロールバックの結果として利用できるようになります。これらは、ジャーナルを抽出するフォーマットとして異なる2つのテキストファイルに書き込まれます。

DBファイルが -ROLLBACKによってロールバックされる時には、2つが同期されるように、対応するジャーナルファイルもロールバックされます。-ROLLBACKは、その時には新しいジャーナルファイルを作成します。もしジャーナルレコードのないフォワード再生が必要ならば、新しく作成されたジャーナルファイルは、空になりそして新しいジャーナルファイルへのデータベースのポイントになります。新しいジャーナルファイル内のジャーナル 割り当て/拡張/自動スイッチ制限(allocation/extension/autoswitchlimit)の値は、-RECOVERの元で以前のセクションの -RECOVER -BACKWARDで説明した方法で設定されます。

接頭辞 roll_bak_がジャーナル・ファイルに追加され、その全内容が-ROLLBACKによって除去されます。これらのファイルは、MUPIP JOURNAL -RECOVERの後にGT.Mで使用されず、必要に応じて移動/削除することができます。

-ROLLBACKの場合、ターゲット・データベース・ファイルは、GT.Mが最後の完了トランザクションをジャーナルに書き込んだときと同じにする必要があります。

もし -FETCHRESYNCまたは -RESYNC修飾子が指定されていない場合、MUPIPは最適なロールバックを実行します（つまり、データベースが健全な状態にあるかどうかをチェックし、クラッシュが発生した場合にデータベースを自動的にリカバリしようとします）。

注意

もしROLLBACK（-NOONLINEまたは-ONLINEのいずれか）が異常終了した場合（kill -9のため）、データベースファイルのヘッダーのFILE破損フィールドによって示される可能性のある矛盾した状態になることがあります。このフィールド・セットを残してROLLBACKが終了すると、他のすべてのプロセスはデータベースとの対話を試みるたびにDBFLCORRPエラーを受け取ります。リスクの降順でこの条件をクリアすることができます： ROLLBACKを完了して再開する MUPIP SET -FILE -PARTIAL_RECOV_BYPASS DSE CHANGE -FILEHEADER -CORRUPT=FALSE -NOCRIT ただし、MUPIPアクションとDSEアクションでは、データベースの状態が一貫しているとは限りません。 MUPIP INTEGでデータベースの整合性をチェックしてください。

$ mupip journal -show -backward mumps.mjl 2>&1 | grep hash
Journal file hash F226703EC502E975784
8EEC733E1C3CABE5AC146C60F922D0E7D7CB5E
2A37ABA005CE98D908B219249A0464F5BB622B72F5FDA
0FDF04C8ECE52A4261975B89A2

次の2つの修飾子はジャーナル処理のディレクション(方向)を制御します：

-BACKWARD

MUPIP JOURNAL処理はジャーナルファイルの末尾から続行する必要があることを指定します。もしアクションに -RECOVERが含まれている場合、フォワード方向（フォワード・フェーズ）でデータベース更新を反転させて処理する前に、JOURNAL-BACKWARDは、ファイルの終わりから明示的にまたは暗示的に指定された点（折り返し点）まで戻すのにのビフォワ・イメージ(before-image)を復元します。

	注意
	-BACKWARDは-FORWARDと互換性がありません。

-FO[RWARD]

指定されたaction修飾子のMUPIP JOURNAL処理が、与えられたジャーナル・ファイルの先頭から始まることを指定します。-RECOVER action修飾子を処理する場合、特定のケースでは、MUPIP JOURNALは、指定されたジャーナル・ファイルの最初のレコードの前に移動する必要があります。つまり、前世代のジャーナル・ファイルから開始できます （詳細は、“-RECover ” を参照してください）。

もしコマンドラインで複数のジャーナルファイルが指定されている場合、 -FORWARDは、作成時間に基づいて各領域(Region)内のジャーナル・ファイルをソートし、最も古いジャーナル・ファイルから処理します。-NOCHECKTN修飾子が指定されていないかぎり、-FORWARDは、タイムスパンおよびトランザクション番号スパンの両方で連続していることを確認するために、各領域(Region)に対応するジャーナル・ファイルのチェックを実行します。 -FORWARDは、不連続性を検出するとエラーを出します。

	注意
	-FORWARDは、-BACKWARDおよび-ROLLBACKと互換性がありません。

時間を指定するジャーナル修飾子は、絶対時刻または相対時刻(delta time)形式の引数を受け入れます。時刻引数は引用符（ ""）で囲みます。開始と終了の引用符をUNIXシェルで処理しないようにするには、両方の前にバックスラッシュ（\）区切り文字を含めます。

絶対的なフォーマットは day-mon-yyyy hh:mm:ss で、day は月の日付を表し、monは月の名前を短縮した3文字を示し（例えば、Jan, Feb,..）年yyyyと時刻の hh はスペースで区切られています。絶対的な時間は、時(hours)の前に"-- "を付けて今日の日付を示してください。

デルタフォーマットは day hh:mm:ss で、日、時、分、秒、の数を示しますが、ここでは、日と時間（hh）は、スペースで区切られています。もしデルタ時間が1日未満の場合は、ゼロ（0）ではじまりスペースが続く必要があります。

デルタ時間は、常にMUPIP JOURNALコマンドへ引数によって指定されたすべてのジャーナルファイルの中で最後のレコードの最大時間への相対パスです。

	注意
	すべての time修飾子は、 -ROLLBACKと互換性がありません。

次のセクションでtime修飾子の詳細について説明します：

-A[FTER]=time

ジャーナルとポイントを識別する参照タイムスタンプを指定し、その後に、JOURNALはジャーナルファイルで処理を開始します。このtime修飾子は、-FORWARD のみに適用されます。

もし -AFTER= がジャーナル・ファイルに最後に記録された時刻に続き、または、-BEFORE= time に続く時間を提供する場合、ジャーナル処理は結果を生成せず、警告メッセージが表示されます。もし -AFTERがコマンド行で指定されたジャーナル・ファイルに記録された最初の時刻より前の時刻を提供し、そして、そのジャーナル・ファイル用の前世代のジャーナル・ファイルが存在する場合、前世代のジャーナル・ファイルは処理に含まれません 。前世代のジャーナル・ファイルをコマンド行で明示的に指定して、考慮する必要があります。

-BEFORE と-AFTERを一緒に使用すると、処理がジャーナル・ファイルの特定の期間に制限されます。

-BE[FORE]=time

-FORWARDまたは-BACKWARDのアクションの終了時刻を指定します。指定された時刻は、ジャーナル・ファイルのタイム・スタンプを参照します。もし -BEFORE= がジャーナル・ファイルに記録された最初の時刻より以前の時刻を指定するか、または、-AFTER= または -SINCE= 時刻より以前の時刻を指定すると、JOURNAL処理は結果を生成せず、警告メッセージが表示されます。

もし -BEFORE= の時間がジャーナル・ファイルに記録された最後の時間を超える場合、ジャーナル処理は、修飾子を効果的に無視し、ジャーナル・ファイルの最後で終了します。デフォルトでは、JOURNAL処理はジャーナルファイルの最後で終了します。

-[NO]LOO[KBACK_LIMIT][=lookback-option-list]

オープン・トランザクション・フェンス(囲い込)を解決しようとしている間は、JOURNAL -BACKWARDが過去の折り返し点をどのくらいまで処理するかを指定します（ジャーナル・ファイルの明示的または暗黙的なポイントから -RECOVER が逆方向に進み、データベースを順方向に処理します）。このオプションは、ZTSTARTとZTCOMMITを持つトランザクション・フェンスでのみに適用されます。TSTARTとTCOMMITを持つトランザクション・フェンスでは、-RECOVERは常に開いているトランザクション・フェンスを解決します。

-LOOKBACK_LIMIT=options は、timeとトランザクション数が含まれます。-NOLOOKBACK_LIMITは、オープン・トランザクション・フェンスを解決するために、必要に応じて、JOURNAL-BACKWARDがジャーナル・ファイルの先頭まで幅広く処理できることを指定します。-LOOKBACK_LIMIT= は-FORWARDと互換性がありません。

-FENCES=NONEの場合、JOURNAL処理は -LOOKBACK_LIMIT を無視します。

-LOOKBACK_LIMITオプションは次のとおりです:

TIME LOOKBACKオプションの名前とその値は、引用符（ ""）で囲む必要があります。

例：

-lookback=\"time=0 00:00:30\"

-LOOKBACK_LIMIT= に両方のオプションを指定する場合は、カンマ（,）で区切る必要があります。たとえば、次のようにします：

-lookback=\"time=0 00:00:30,operations=35\"

-LOOKBACK_LIMIT= に両方のオプションを指定すると、最初に到達した限界値でLOOKBACKを終了します。

デフォルトでは、MUPIP JOURNALは、オープン・フェンスを解決するために、-SINCE= 以前のジャーナル時間を5分間提供する -LOOKBACK_LIMIT=\"TIME=0 00:05\" を使用します。最も古いジャーナルファイルの開始よりもずっと前に制限を指定する -LOOKBACK_LIMITは、-NOLOOKBACK_LIMITが指定されているかのように動作します。

-SI[NCE]=time

-BACKWARDを指定したaction修飾子の開始（またはチェックポイント）時間を指定します、つまり、-SINCEは、フォワード処理を開始する前に、JOURNAL -BACKWARDが処理する時間（ジャーナル・ファイルの終わりから）を指定します。

指定された時刻は、ジャーナル・ファイルのタイム・スタンプを参照します。もし JOURNAL -BACKWARD が -SINCE= time を見つけたときにオープン・フェンス・トランザクションがある場合、コマンドが -FENCES=NONEも指定されていないかぎり、それらを解決するためにバックワード処理を続けます。もし -SINCE= 時間 がジャーナル・ファイルに記録された最後の時間を超えた場合、または、-BEFORE= 時間の後に続く場合、JOURNAL処理は修飾子を効果的に無視し、警告メッセージを表示します。

デフォルトでは、-SINCE= time は 0:00:00:00で、ジャーナル・ファイルの最後の時間（最後のジャーナル・レコードが更新された時刻）を示します。

これらの修飾子は、-ROLLBACKのみ互換性があります。

-FET[CHRESYNC]=<port number>

LMS構成では、レプリケートするインスタンスを、オリジナルのインスタンスがそれに追いつくために更新を送信することができる位置から共通の同期ポイントへ、ロールバックします。このコマンドは、前のオリジナルのインスタンスを、現在のオリジナルのインスタンスが引き継いだ点のジャーナル・シーケンス番号にロールバックします。fetchresync修飾子の形式は次のとおりです：

-fetchresync=<port number> -losttrans=<extract file> file-list

<port number> は、ロールバックコマンドがリファレンス・ポイントを取得している時に使用しているその通信ポート番号です。受信側サーバーで使用されているものと同じロールバック用の、オリジナルのインスタンスで常に同じ<port number>を使用してください。

	重要
	同期外れ状態の可能性を避けるために、複製インスタンス上の任意のソースサーバを起動する前に、mupip journal -rollback -fetchresync コマンドを無条件にスクリプト化することを、FISはお勧めします。

オリジナルのインスタンスによって送信された参照ポイントは、オリジナルのインスタンスが一度保持していたRESYNC_SEQNO（後述）です。データベース/ジャーナル・ファイルは、以前のRESYNC_SEQNO（つまり、オリジナルのインスタンスから受信したものか、または、ローカルに維持されているもの）からロールバックされます。もし -fetchresync を使用しない場合、データベースは最後の一貫した複製インスタンス状態にロールバックされます。

システムは、この必須の修飾子で指定されたファイル<extract file> の中で、抽出される失われたトランザクションを保存します。失われたトランザクションの検索の開始点は、-fetchresync操作でオリジナルのインスタンスから取得されたJNL_SEQNOです。 もし -fetchresync が指定されていない場合、<extract file>は、一貫性のある状態に到達するためにロールバックプロシージャによって取り消された整合性の悪い(post-consistent-state transaction)トランザクションをリストします。

	注意
	抽出された紛失トランザクションのリストには、処理中に発生したシステム障害のために壊れたトランザクションが含まれることがあります。これらのトランザクションを解決しないでください。コミットされていないとみなされます。

	注意
	もし進行中の ROLLBACK -FETECHRESYNC 操作を中断した場合、または、もし2つのインスタンス間のTCP接続が切断された場合、データベース・ヘッダーが破損する可能性があります。回避策は、ROLLBACK -FETCHRESYNC操作を再始動するか、または、FETCHRESYNC操作がタイムアウトするまで60秒待つことです。

例：

$ mupip journal -rollback -fetchresync=2299 -losttrans="glo.lost" -backward 

このコマンドは、オリジナルのインスタンスが更新を送信してそれに追いつくことができる位置から共通の同期ポイントへ移動させるために、複製インスタンス上の ROLLBACK -FETCHRESYNC操作を実行します。また、複製インスタンス上に存在するが、しかし、ポート2299のオリジナルのインスタンス上には存在しない、すべてのそれらトランザクションの失われたトランザクションファイルglo.lostも生成されます。

-RES[YNC]=<journal sequence number>

GT.Mがデータベース/ジャーナルファイルをロールバックして特定のポイントにロールバックする必要があるジャーナルシーケンス番号を指定します。もし最後の一貫性のある状態よりも大きいジャーナルシーケンス番号を指定すると、GT.Mはデータベース/ジャーナルファイルを最後の一貫性のある状態にロールバックします。通常の動作条件下では、この修飾子は必要ありません。

次の修飾子はジャーナル処理を制御します：

-[NO]AP[PLY_AFTER_IMAGE]

バックワード・リカバリーまたはロールバックのフォワード処理の一部として、イメージ・レコード（AIMG）をデータベースに適用される後に指定します。AIMGは、DSEの更新が原因で発生した変更の直後に、GTMによりキャプチャーされたデータベース更新の"スナップショット"です。デフォルトでは、バックワード・リカバリーまたはロールバックのフォワード・フェーズの間に、AIMGレコードはデータベースに適用されます。

デフォルトでは、-RECOVER -FORWARD はAIMGレコードをデータベースに適用しません。-APPLY_AFTER_IMAGEは、-RECOVER または -ROLLBACK action 修飾子とのみ互換性があります。

-BR[OKENTRANS]=<extract file>

-BROKENTRANSは、-ROLLBACK、-RECOVER、-EXTRACTのオプション修飾子です。もしこれが指定されておらず、破損したトランザクション・ファイルの作成が必要な場合、MUPIP JOURNALは、処理中の現在のジャーナルファイルの名前を .broken 拡張子を使って1つ作成します。

もし selection修飾子が指定されている場合、破棄されたトランザクションの決定（したがって、トランザクションの決定も同様に失われます）は、selection修飾子でフィルタリングされたジャーナル・ファイルに基づいて行われます。これは、selection修飾子の性質に応じて、トランザクションのジャーナルレコードが完全であるとみなされるか、または、破損または失われたとみなされる可能性があることを意味します。selection修飾子とともに -FENCES=NONEを使用すると、すべてのジャーナル・レコードが完全であるとみなされ、したがって、トランザクション処理が壊れたり失われたりするのを防ぐことができます。

-[NO]CHA[IN]

-CHAINを指定すると、ジャーナル処理で、以前の世代のジャーナルファイルを-FORWARDで含めることができます。もし JOURNAL -RECOVERが以前の世代のジャーナルファイルを処理する必要があり、かつ、-NOCHAINが指定されている場合、MUPIP JOURNALはエラーで終了します。

-CHAINがデフォルトです。

-[NO]CHE[CKTN]

-CHECKTNは、JOURNAL -FORWARDが、各領域(Region)に対して、その領域(Region)に対して処理される最も古いジャーナル・ファイルの開始トランザクション番号がデータベース・ファイル内の現在のトランザクションと同じであり、かつ、すべてのジャーナル・ファイルの終了トランザクション番号が、所定の領域(Region)に対する次世代ジャーナル・ファイルの開始トランザクション番号に変換するために、等しいことを確認する必要があることを指定します。デフォルトでは、-FORWARDは-CHECKTNを使用します。

-NOCHECKTNは、トランザクションの整合性をチェックするための組み込みのメカニズムをオーバーライドすることによって、フォワードリカバリを強制します。回復されたデータベースおよびジャーナル・ファイルで整合性の問題が発生する可能性があるため、-NOCHECKTNは慎重に使用してください。

-CHECKTNは-BACKWARDおよび-ROLLBACKと互換性がありません。

-[NO]ER[ROR_LIMIT][=integer]

MUPIP JOURNAL処理を受け入れるエラーの数を指定します。エラーの数が -ERROR_LIMITを超えると、-INTERACTIVE修飾子は、JOURNAL処理がオペレータに対して停止するか延期するかどうかを決定します。-NOERROR_LIMITは、エラーのためにMUPIP JOURNALが停止するのを防ぎます。ジャーナル処理は、エラーの数にかかわらず、ジャーナル・ファイルの終わりに達するまで続きます。

-NOERROR_LIMITは -ERROR_LIMIT=0と同じではないことに注意してください。

デフォルトでは、MUPIP JOURNALは-ERROR_LIMIT=0を使用し、最初のエラーで適切なエラー処理が開始されます。クラッシュの場合、そこではジャーナルファイルの末尾にいくつかの不完全なジャーナルレコードがあるかもしれない。MUPIP JOURNALは、エラーとしてこれらをみなしません。加えて、フェンスで囲まれたトランザクションは、エラーとはみなされませんが、壊れています。

リカバリーのフォワードフェーズの間では、もし壊れたトランザクションが見つかったならば、後で処理されるすべての論理レコードは、疑わしいと見なされます。もし壊れたトランザクションの後に完全なトランザクションが見つかると、MUPIP JOURNAL -RECOVERはエラーカウントをインクリメントし、エラー制限よりも小さい場合はデータベースに適用します。それ以外の場合は、失われたトランザクションとして処理され、抽出されます。もし壊れたトランザクションの後に完全なトランザクションが見つかった場合、MUPIP JOURNAL-ROLLBACKはそれを損失トランザクションとして扱い、エラー限度に関係なく抽出します。

もし MUPIP JOURNALが処理中にエラー・カウントを増分する必要がある場合は、 次の場合を除いて、発生したすべてのエラーに対して警告メッセージが発行されます。ただし、エラーカウントが増分されても警告メッセージは表示されません：

もしMUPIP JOURNALがエラーカウントの値が0以外で正常に完了すると、戻りステータスは成功ではなく警告になります。

-FE[NCES][=fence-option]

どのようにJOURNALがフェンスで囲まれたトランザクションを処理するかを指定します。フェンスで囲まれたトランザクションは、TSTARTまたはZTSTARTコマンドとそれぞれに続くTCOMMITまたはZTCOMMITコマンドにより先行するデータベースの更新が成立する論理トランザクションです。TSTARTまたはZTSTARTとTCOMMITまたはZTCOMMIT間のすべての更新は共にに発生するように設計され、そのため、ジャーナルリカバリーデータベースはフェンスで囲まれたトランザクション、または、それらが無いどちらか一方に一致するすべての更新を含みます。

MUPIP -RECOVERの -FENCES オプションの引数の値は、大文字と小文字は区別されません。

フェンスオプションは：

デフォルトでは、MUPIP JOURNALは -FENCES=PROCESSを使用します。

-FU[LL]

-FULLを -EXTRACTとともに使用すると、すべてのジャーナル・レコードが抽出されるように指定されます。ジャーナル・ファイルの内容は、データベースとジャーナルの同期を維持するために、バックワード・リカバリまたはロールバックの場合にロールバックできます （詳細は、“-ROLLBACK [{-ON[LINE]|-NOO[NLINE]}] ” を参照） 。これは、ロールバックする前にジャーナルファイルの終わりを示し、かつ、ジャーナルファイルの新しい終了点を示すためにファイルヘッダー内の別のフィールドを設定するために、ジャーナルファイルの内容を切り捨てるのではなく、MUPIP JOURNAL -SHOW=HEADERの出力に "Prev Recovery End of Data"として表示されるジャーナルファイルヘッダーのフィールドを設定することによって達成されます（このフィールドは MUPIP JOURNAL -SHOW=HEADER の出力に「End of Data」と表示されます）。ジャーナル・ファイルの内容がロールバックされると、将来のすべてのMUPIP JOURNALコマンド（ -EXTRACTを含む）は、ロールバックされたジャーナル・ファイルのみで動作します。しかし、もし -FULLを -EXTRACTとともに指定すると、ジャーナル・ファイルの内容（ロールバックされたこれらレコードを含む）全体が抽出されます。この修飾子は診断ツールとしてのみ使用され、通常の操作では使用されません。

-FULL修飾子は -EXTRACTとのみ互換性があります。

-[NO]IN[TERACTIVE]

-ERROR_LIMITを超える各エラーに対して、JOURNAL処理が処理の継続をコントロールするレスポンスの呼び出し元オペレータにプロンプトを出すかどうかを指定します。もしオペレータが処理を続行すべきでないことをレスポンスした場合、MUPIP JOURNALコマンドは終了します。

-NOINTERACTIVEは、MUPIP JOURNALコマンドが -ERROR_LIMITで指定されたエラー数を生成するとすぐに、ジャーナル処理を終了します。

この修飾子は、対話モードまたは端末モードにのみ適用されます。デフォルトは-INTERACTIVEです。

-LOST[TRANS]=<extract file>

-LOSTTRANS は、-RECOVER、-ROLLBACK および -EXTRACTのオプションの修飾子です。もしこれが指定されてなくて、失われたトランザクション・ファイルの作成が必要な場合、MUPIP JOURNALは .lost 拡張子で処理されている現在のジャーナル・ファイルの名前を使用してジャーナルファイルを作成します。

壊れたトランザクションの後の完全なトランザクションは、失われたトランザクションとみなされます。それらは失われたトランザクション・ファイルに書き込まれます。-RECOVERの場合、もし -ERROR_LIMIT修飾子で許可するには、それは良好なトランザクションとみなされ、データベースに適用されます。

もし selection修飾子が指定されている場合、破棄されたトランザクションの決定（したがって、トランザクションの決定も同様に失われます）は、selection修飾子でフィルタリングされたジャーナル・ファイルに基づいて行われます。これは、selection修飾子の性質に応じて、トランザクションのジャーナルレコードが完全であるとみなされるか、または、破損または失われたとみなされる可能性があることを意味します。selection修飾子とともに -FENCES=NONEを使用すると、すべてのジャーナル・レコードが完全であるとみなされ、したがって、トランザクション処理が壊れたり失われたりするのを防ぐことができます。

レプリケートされたデータベースの場合、失われたトランザクションには更なる原因があります。もしフェイルオーバーが発生すると（つまり、オリジナルのソース・サーバー Aが失敗し、オリジナルのインスタンスの役割(ロール)を引き継いでいるレプリケートしているソース・サーバー B）、Aのデータベースにコミットされたトランザクションが、Bのデータベースに反映されないことがあります。オリジナルのインスタンスが新しい複製インスタンスになる前に、これらのトランザクションをロールバックする必要があります。これらのトランザクションは、"失われたトランザクション" として知られます。これらは完全なトランザクションであり、壊れたトランザクションとは異なることに注意してください。MUPIP JOURNAL -ROLLBACKは、抽出された失われたトランザクションを、この修飾子で指定された抽出ファイルに格納します。失われたトランザクションの検索の開始点は、-FETCHRESYNC操作でオリジナルのソース・サーバーから取得されたジャーナル・シーケンス番号です。

-RED[IRECT]=file-pair-list

ジャーナル・ファイルを作成したデータベースとは異なるデータベースにジャーナル・ファイルを再生します。-REDIRECTを使用して、トレーニングまたはテスト用のデータベースを作成または維持します。

この修飾子は、-RECOVERアクションおよび-FORWARD direction修飾子にのみ適用されます。JOURNALは、-RECOVERとともに表示されない限り、-REDIRECTを拒否します。

ファイル・ペア・リスト(file-pair-list)は、カッコ() で囲まれカンマ(,) で区切られた1つ以上のファイル名のペアで構成されます。ペアは、以下の形式で、等号(イコール)で区切られています：

old-file-name=new-file-name

古いファイル名がオリジナルのデータベース・ファイルを識別し、新しいファイル仕様のファイル名が -RECOVERのターゲットを識別する。古いファイル指定(old-file-specification)は、常に -SHOW を使って決定することができます。

デフォルトでは、ジャーナルが作成されたデータベース・ファイルに対して、ジャーナルは-RECOVERに指示します。-REDIRECT は -ROLLBACKと互換性がありません。

例：

$ mupip journal -recover -forward -redirect="bgdbb.dat=test.dat" bgdbb.mjl

このJOURANLコマンドは、-REDIRECT が bgdbb.dat からtest.datへbgdbb.mjl の中で更新するようなフォワード・リカバリーをします。

-VERB[OSE]

処理中に冗長出力を出力します。それは無視されず、デフォルトではOFFに設定されています。

ジャーナル selection 修飾子は、-EXTRACT および -SHOW操作とのみ互換性があります。これは、ほとんどのアプリケーションが、アプリケーション設計の外部にある基準に基づいてトランザクションのサブセットを安全に削除するように構築されていないためです。選択基準に基づいてトランザクションをリカバリから除外するには、レコードを抽出(-EXTRACT)し、ジャーナル・リカバリではなくアプリケーション・ロジックを使用して再び適用する方法があります。このアプローチにより、アプリケーションロジックは、削除されたトランザクションと保持されたトランザクションとの間のあらゆる対話を適切に処理することができます。 selection修飾子を使用すると、フェンスされた(囲われた)トランザクションのジャーナル・レコードのサブセットのみが抽出されることに注意してください （例えば、対応するTCOMMITレコードが抽出されて取り出されている間、トランザクションがselection修飾子によって取り除かれるその最初の更新の理由でTSTARTレコードは抽出されないことがあります）。これは、実際にそれがない時に破壊が見えるために、フェンス(囲い込）されたトランザクションが発生することができます。

次の修飾子は、ジャーナル処理のためのselection基準を制御します。

-TRANSACTIONを除いて、すべての修飾子でカンマ(,) で区切られた値のリストを指定できます。

-G[LOBAL]=global-list

処理を含めるか、または、処理から除外するにはMUPIP JOURNAL用のグローバルを指定してください。この修飾子は、特定のデータの抽出および分析に役立ちます。

グローバル・リスト(global-list)には、キャレット記号（^）の前に1つ以上のグローバル名（添え字なし）が含まれています。複数のグローバルを含めるには、次の構文のいずれかを使用してください：

$ mupip journal -forward -extract -global="^A*,^C" mumps.mjl 

または

$ mupip journal -forward -extract -global="(^A*,^C)" mumps.mjl 

名前は、アスタリスク(*)でワイルドカードを含めることができます。つまり、-GLOBAL="^ A *" は、名前がAで始まるすべてのグローバル変数を選択します。リスト全体または各名前の前に、オプションでティルド記号（~）を付けることができ、JOURNALに指定されたグローバルにデータベースの更新を除外するように要求します。MUPIP JOURNAL -GLOBAL のグローバル・リストがティルダ記号（~）で始まらない場合、JOURNALは明示的に名前のついたグローバルのみを処理します。デフォルトでは、JOURNALはすべてのグローバルを処理します。

添字を指定するには、-GLOBAL="^ A(1)" を使用すると^A(1)ツリー下のすべてのキーが含まれます。つまり、-GLOBAL="^A(1,*)" と使用するのと同等です。アスタリスク(*)またはパーセント(%)は、グローバル仕様の任意の位置で許可されます。パーセント(%)は任意の文字と一致し、アスタリスク(*)は任意の文字列（ゼロの長さもある）と一致します。アスタリスク（*）またはパーセント（%）指定は、-USER修飾子にも使用できます。

例：

^GBLTMPを除いて、すべての^GBL*を抽出するためには：

$ mupip journal -extract -global="^GBL*,~^GBLTMP" -forward mumps.mjl

^GBL(1,"TMP")を除いて、すべての^GBLを抽出するためには：

$ mupip journal -extract -global=\"^GBL,~^GBL\(1,\"\"TMP\"\"\)\" -forward mumps.mjl

バックスラッシュ(\) 区切り文字は、添字開始の二重引用符(")をMUPIPに渡すためにUNIXでは必要とされます。

グローバル修飾子の文字列のエラー解析が発生した時は必ず、INVGLOBALQUALエラーはコマンドラインでエラーオフセットと共に発行されます。

-ID=pid-list

プロセス識別番号（PIDs）によって識別された1つまたは複数のプロセスによって生成されたデータベースの更新が含まれまたは除外されるJOURNALプロセスを指定します。リスト全体または各PIDの前にオプションでティルダ記号（~）を付けることができ、JOURNALには、指定されたPIDで開始されたデータベース更新を除外する必要があります。トラブルシューティングやデータ解析のため、この修飾子を使用することがあります。

デフォルトでは、JOURNALはそれによって開始されるPIDに関係なくデータベースの更新を処理します。

-T[RANSACTION]=transaction-type

処理を含めるか、または、処理から除外するにはJOURNALのためにトランザクションタイプを指定してください。たとえば、データを見落とすことに可能性がある原因を見つけるためにKILL操作でレポートだけを行う、この修飾子を使用することがあります。

トランザクションタイプは、SETおよびKILLであり、そして、否定ができます。これらのタイプは、同じ名前のMコマンドに対応します。JOURNAL -TRANSACTIONのトランザクションタイプが否定されていない場合、JOURNALは名前付きタイプ（たとえば、-TRANSACTION=KILL）のトランザクションのみを処理し、一方、もし否定されていれば、（例えば、-TRANSACTION=NOKILL ）JOURNALは 、名前付きタイプのトランザクションを処理しません。

デフォルトでは、そのタイプに関係なく、JOURNALはトランザクションを処理します。

-U[SER]=user-list

一人または複数ユーザによって生成されたデータベースの更新が含まれまたは除外されるJOURNALプロセスを指定します。特定のユーザーのアクションを監査するためにこの修飾子を使用することができます。ユーザーリストは、1つまたは複数のユーザの名前が含まれます。カンマ(,)で区切られた名前で複数のユーザーを示します。名前は、アスタリスク(*)でワイルドカードを含めることができます。指定されたユーザにより開始されるデータベース更新を除外するためにJOURNALを必要としている、リスト全体またはそれぞれのPIDは、マイナス記号 (-) ティルダ記号 (~)より先にオプションを付ける必要があります。JOURNAL -USERでユーザリストは、(~)ティルダ記号で開始しない時は、JOURNALは、明示的に名づけられたユーザにより生成されたそのデータベース更新のみを処理します。The asterisk (*) or percent (%) specification can be used for -USER qualifier. パーセント(%)は任意の文字と一致し、アスタリスク(*)は任意の文字列（ゼロの長さもある）と一致します。

デフォルトでは、JOURNALはそれらによって開始されるユーザに関係なくデータベースの更新を処理します。