バックアップデータベースは、ソースデータベースと同じジャーナリング特性を共有します。ただし、BKUPDBJNLを使用すると、バックアップ・データベースのジャーナリングを使用不可にするか、オフにすることができます。ソースデータベースと同じ環境で同じ時間にバックアップデータベースを開こうとする場合は、この修飾子を使用します。

BKUPDBJNL修飾子の形式は次のとおりです：

-BK[UPDBJNL]={DISABLE|OFF}

TCP接続、ファイル（またはバックアップディレクトリ）、または、パイプにMUPIP BACKUPの出力を転送します。もし複数の .dat ファイルがある場合、BYTESTREAM は、TCP接続、増分バックアップファイル、および/または、ディレクトリ、または、パイプへ、カンマ区切りリストで出力を転送します。-SINCE または -TRANSACTION と一緒に使用すると、MUPIP BACKUP は増分バックアップを許可します。つまり、-SINCE または -TRANSACTION で指定された前の時点以降に変更されたデータベース・ブロックが含まれます。

	注意
	MUPIP BACKUPをTCP接続に出力すると、現在のシステム上のディスクI/O帯域幅が節約されます。

すべてのバイトストリームバックアップは、データベースファイルとして使用する前にランダムアクセスファイル（MUPIP RESTOREを使用）に復元する必要があります。-BYTESTREAMは、TCP/IP接続またはパイプ経由で、リスニングしている MUPIP RESTOREプロセスに直接出力を送信することもできます。

BYTESTREAM 修飾子の形式は次のとおりです：

-B[YTESTREAM]

選択したすべての領域(Region)のファイルを、ディスクツーディスクでバックアップコピーを作成します。DATABASEバックアップコピーは、ランダムアクセスファイルに復元する必要があるBYTESREAMバックアップとは異なり、すぐに使用できるGT.Mデータベースです。

	注意
	DATABASE修飾子は、磁気テープへのバックアップをサポートしていません。

DATABASE修飾子の形式は次のとおりです：

-D[ATABASE]

バイトストリーム BACKUPデータがTCP/IP接続を介して送信されるときのタイムアウト期間を指定します。NETTIMEOUT修飾子の形式は次のとおりです：

NET[TIMEOUT]=seconds

バックアップされるデータベースファイルのジャーナリング特性を決定します。確立されたすべてのジャーナリング特性は、新しいジャーナル・ファイルに適用されます。データベースのジャーナリングが有効な時、この修飾子は ONLINEバックアップ（デフォルト）でのみに有効です。

NEWJNLFILES 修飾子の形式は次のとおりです：

-[NO]NEWJNLFILES[=[NO]PREVLINK], [NO]S[YNC_IO]]

MUPIP BACKUP操作がアクティブな間に、他のプロセスがバックアップの結果に影響を与えずにデータベースを更新できることを指定します。ONLINE修飾子の形式は次のとおりです：

-[NO]O[NLINE]

後続のバイトストリーム、データベース、カスタムバックアップ（SANSまたはディスクミラー）プロトコルの参照ポイントをマークするためのデータベースファイル（トランザクション番号の形式）のタイムスタンプです。たとえ、-DATABASEと-BYTESTREAMの両方がそれぞれの相対タイムスタンプをマークしたとしても、-RECORD は追加のタイムスタンプオプションを提供します。MUPIP FREEZE は -RECORD修飾子も提供します。これは、FREEZEを使用してSANまたはディスクミラーベースのバックアップメカニズム用にデータベースを設定できるためです。

RECORD修飾子の形式は次のとおりです：

-R[ECORD]

既存の宛先ファイルを上書きします。

REPLACE修飾子の形式は次のとおりです：

-[REPL]ACE

レプリケーション・インスタンス・ファイルのバックアップを配置するターゲットの場所を指定します。

	注意
	レプリケーション・インスタンス・ファイルは、常にデータベースファイルでバックアップする必要があります。

REPLINSTANCE修飾子の形式は次のとおりです：

-REPLI[NSTANCE]=<target_location>

最後に指定したバックアップ以降に変更されたブロックが含まれます。SINCE修飾子の書式は次のとおりです：

-S[INCE]={DATABASE|BYTESTREAM|RECORD}

デフォルトでは、MUPIP BACKUP -BYTESTREAM は -SINCE=DATABASEとして動作します。

次のものとは互換性がありません：-TRANSACTION 。

BACKUP -BYTESTREAMによって、そのトランザクションおよびそれ以降のすべてのトランザクションによって変更されたすべてのブロックがコピーされる開始トランザクションのトランザクション番号を指定します。TRANSACTION修飾子の形式は次のとおりです：

-T[RANSACTION]=transaction-number

	注意
	時間のポイントは、アプリケーションの観点から、すべてのデータベース領域で、同じトランザクション番号を持つことはほとんどないことを、一貫しています。したがって、-TRANSACTION=1を除いて、この修飾子は複数の領域を含むバックアップには有効ではありません。

例：

$ mupip backup -bytestream REPTILES,BIRDS bkup

環境変数 gtmgbldir にREPTILES.DATとBIRDS.DATというファイルにマップするREPTILESとBIRDSの領域があるとします（ファイルが存在するディレクトリに関係なく）。次に、上記の例では、最後のDATABASEバックアップ以降、bkupディレクトリにバイトストリームのバックアップファイル REPTILES.DATとBIRDS.DATが作成されます。

例：

$ mupip backup -bkupdbjnl="OFF" "*"

このコマンドは、バックアップデータベースのジャーナリングをオフにします。

例：

$ mupip backup -bytestream "*" tcp://philadelphia:7883,tcp://tokyo:8892

ACN.DATとHIST.DATを指す2つの領域を持つグローバル・ディレクトリがあるとすると、この例では、サーバー philadelphia のポート7883でリッスンしている可能性がある MUPIP RESTOREプロセスへACN.DATのバックアップを作成し、そして、サーバーtokyoのポート8893でリッスンしている可能性がある MUPIP RESTOREプロセスへ HIST.DATのバックアップを作成します。

バックアップとレストアの両方が同じシステム上にある場合でも、<マシン名>と<ポート>を常に指定し、MUPIPのバックアッププロセスの前にMUPIP RESTORE プロセスが開始されていることを確認してください。

例：

$ mupip backup -database -noonline "*" bkup
DB file /home/gtmnode1/gtmuser1/mumps.dat backed up in file bkup/mumps.dat
Transactions up to 0x00000000000F42C3 are backed up.
BACKUP COMPLETED.

このコマンドは、ディレクトリbkupに現在のデータベースのすべての領域のディスクツーディスク(disk-to-disk)バックアップコピーを作成します。GT.Mは、バックアップ操作中にすべての領域をフリーズします。

例：

$ mupip backup -bytestream -nettimeout=420 DEFAULT tcp://${org_host}:6200

このコマンドは、DEFAULT領域のバックアップコピーを作成し、タイムアウトが420秒になります。

例：

$ mupip backup -bytestream DEFAULT '"| gzip -c > online5pipe.inc.gz"'

このコマンドは、DEFAULT領域のバックアップをgzipコマンドに（パイプ経由で）送信します。

例：

$ mupip backup -online DEFAULT bkup
DB file /gtmnode1/gtmuser1/mumps.dat backed up in file bkup/mumps.dat
Transactions up to 0x00000000483F807C are backed up.
BACKUP COMPLETED.

このコマンドは、現在のデータベースのDEFAULT領域のバックアップコピーをディレクトリbkupに作成します。バックアップ操作中に、他のプロセスがデータベースを読み込んで更新することができます。

例：

$ mupip backup -record DEFAULT bkup

このコマンドは参照ポイントを設定し、現在のデータベースのDEFAULT領域のバックアップコピーをディレクトリbkupに作成します。

例：

$ mupip backup -online -record DEFAULT bkup1921
DB file /home/reptiles/mumps.dat backed up in file bkup1921/mumps.dat
Transactions up to 0x00000000000F4351 are backed up.

例：

$ mupip backup -bytestream -since=record DEFAULT bkup1921onwards
MUPIP backup of database file /home/reptiles/mumps.dat to bkup1921onwards/mumps.dat
DB file /home/reptiles/mumps.dat incrementally backed up in file bkup1921onwards/mumps.dat
6 blocks saved.
Transactions from 0x00000000000F4351 to 0x00000000000F4352 are backed up.
BACKUP COMPLETED.

最初のコマンドは参照ポイントを設定し、現在のデータベースのDEFAULT領域のバックアップコピーをディレクトリbkup1921に作成します。第2のコマンドは、第1のコマンドによって設定された基準点から始まるバイトストリームバックアップを完了します。

例：

$ mupip backup -bytestream -transaction=1 DEFAULT bkup_dir
MUPIP backup of database file /gtmnode1/gtmuser1/mumps.dat to bkup_dir/mumps.dat
DB file /gtmnode1/gtmuser1/mumps.dat incrementally backed up in file bkup/mumps.dat
5 blocks saved.
Transactions from 0x0000000000000001 to 0x0000000000000003 are backed up.
BACKUP COMPLETED.

このコマンドは、現在のデータベースのDEFAULT領域のすべての使用中のブロックをディレクトリbkup_dirにコピーします。

例：

$ mupip backup -newjnlfiles=noprevlink,sync_io "*" backupdir

この例では、現在の領域(Region)の新しいジャーナル・ファイルを作成し、グローバル・ディレクトリ内のすべての領域(Region)の以前のジャーナル・ファイル・リンクを切り取り、SYNC_IOオプションを有効にして、ディレクトリbackupdir内のすべてのデータベースのバックアップをとります。

データベースファイルの作成のために、1つの領域を指定します。デフォルトでは、MUPIP CREATE は、現在のグローバルディレクトリ内にデータベースファイルが存在しないすべての領域のデータベースファイルを作成します。

REGION修飾子の形式は次のとおりです：

-R[EGION]=region-name

例：

$ mupip create -region=REPTILES

このコマンドは、リージョンREPTILESのグローバル・ディレクトリー（GT.Mグローバル・ディレクトリー環境変数で指定）で指定されたデータベース・ファイルを作成します。

ファイルのヘッダー形式を指定します。データベースのダウングレード基準の詳細については、現在のGT.Mバージョンのリリースノートを参照してください。

例：

$ mupip downgrade mumps.dat

このコマンドは、mumps.datのファイルヘッダをV4形式に変更します。

GT.Mに以下のエラーが発生した場合でも、MUPIP ENDIANCVT が操作を継続できるようにします：

OVERRIDE修飾子は、エンディアン形式の変換が正常に行われないような重大なエラー（データベースの整合性エラーなど）をオーバーライドしないことに注意してください。

$ mupip endiancvt mumps.dat -outdb=mumps_cvt.dat
Converting database file mumps.dat from LITTLE endian to BIG endian on a LITTLE endian system
Converting to new file mumps_cvt.dat
Proceed [yes/no] ?

このコマンドは、mumps.dat のエンディアン形式を検出し、yesを入力して確認すると他のエンディアン形式に変換します。

MUPIPがファイルを拡張するGDSデータベースブロックの数を指定します。GDSファイルは、ビットマップに追加ブロックを使用します。MUPIP EXTEND は、指定された数のブロックとオーバーヘッドとして必要なビットマップ・ブロックを加算します。ビットマップの詳細については、 第9章： “GT.Mデータベース構造（GDS）”を参照してください。

BLOCK 修飾子の書式は次のとおりです：

-BLOCKS=data-blocks-to-add

デフォルトでは、EXTENDは、データベースファイルを拡張するGDSのブロックの数として、ファイルヘッダーに拡張の値を使用します。最大合計ブロック制限内にある限り、必要な数のブロックを指定できます（最大 224,000,000 GDSブロック [224 million] ）。

$ mupip extend DEFAULT -blocks=400

このコマンドは、400 GDE データベースブロックをDEFAULT領域に追加します。

例：

$ mupip extend REPTILES -blocks=100

このコマンドは、100 GDEデータベースブロックをREPTILES領域に追加します。

出力ファイルのフォーマットを指定します。FORMAT修飾子の形式は次のとおりです：

-FO[RMAT]=format_code

フォーマットコードは、次のいずれかです：

MUPIP EXTRACTコマンドがレコードをコピーしているすべてのデータベースファイルに対するデータベースの更新を防止します。FREEZEは、MUPIP EXTRACT操作が、コピーの進行中に発生する更新によって「ぼやけた」ものではなく、グローバルの「鮮明な」イメージをキャプチャすることを保証します。

FREEZE修飾子の形式は次のとおりです：

-FR[EEZE]

デフォルトでは、MUPIP EXTRACTは操作中に領域(Rgion)を「フリーズ」しません。

出力ファイルの最初のレコードとなるテキスト文字列を指定します。MUPIP EXTRACT -FORMAT=BINARYは、ラベルテキストを32文字に切り捨てます。LABEL修飾子の形式は次のとおりです：

-LA[BEL]=text

MUPIP EXTRACTコマンドで抽出された各グローバルを stdout でメッセージを表示します。このメッセージは、グローバルノード数と、各グローバルの最大の添字の長さと、最大のデータ長を表示します。LOG修飾子の形式は次のとおりです：

-[NO]LO[G]

デフォルトでは、EXTRACTは-LOGを実行します。

MUPIP EXTRACTを一連の領域に制限します。REGION修飾子の形式は次のとおりです：

-R[EGION]=region-list 

region-list は、リスト内の現在のグローバルディレクトリの複数の領域を指定することができます。領域(Region)は大文字小文字を区別せず、カンマで区切り、ワイルドカードを使用して指定できます。どの領域(Region)名でもワイルドカード文字 * と % を含めることができます（シェルによる不適切な拡張からそれらを保護するためにエスケープしてください）。領域(Region)名の展開は、M（ASCII）の照合順序で行われます。

MUPIP EXTRACT操作のグローバル変数を指定します。SELECT修飾子の形式は次のとおりです：

-S[ELECT]= global-specification

グローバル変数を指定する仕様は以下のとおりです：

	注意
	もし、選択のためのルールが複雑ならば、データベースファイルへ取り出すグローバル変数をマップする、特別なグローバル ディレクトリを構築しやすくなります。これは、データベースファイルがレプリケートされたインスタンスの一部である場合は、許可されない可能性があります。このような場合は、データベースのバックアップで動作します。

データベース抽出を標準出力ストリームにリダイレクトします。STDOUT修飾子の形式は次のとおりです：

-ST[DOUT]

例：

$ mupip extract -format=go -freeze big.glo

このコマンドは、MUPIP EXTRACT操作中のデータベースの更新を防ぎます。

例：

$ mupip extract -format=GO mumps_i.go

このコマンドは、mumps_i.go という抽出ファイルを「グローバル出力」形式で作成します。ファイルを転送またはアーカイブするには、この形式を使用します。GOフォーマット・ファイルの最初のレコードには、ヘッダーラベル "GT.M MUPIP EXTRACT" がテキストとして含まれています。

例：

$ mupip extract -format=BINARY v5.bin

このコマンドは、バイナリ形式の v5.bin という抽出ファイルを作成します。この形式は、データベースの再編成や短期バックアップのために使用します。

例：

$ mupip extract -format=ZWR -LABEL=My_Label My_Extract_File

この例では、現在のデータベースから My_Extract_File（ZWRITE形式）というファイルにすべてのグローバルをMy_Labelというラベルで抽出します。

例：

$ mupip extract -nolog FL.GLO

このコマンドは、グローバル単位ごとに統計を表示せずに、グローバル出力ファイルFL.GLO（データベース内のすべてのグローバル変数で構成されます）を作成します。ラベルが指定されていないため、FL.GLO の最初のレコードには、テキスト文字列 "GT.M MUPIP EXTRACT" が含まれています。

例：

$ mupip extract -select=Tyrannosaurus /dev/tty

このコマンドは、グローバル ^Tyrannosaurus をデバイス（ファイル名）/dev/tty にダンプするようにEXTRACTに指示します。

同じユーザーIDを持つ別のプロセスによって設定されたフリーズをクリアします。

OFF修飾子の形式は次のとおりです：

OF[F]

MUPIP FREEZE操作の開始を指定します。ON修飾子の形式は次のとおりです：

-ON

次の修飾子とは同時利用できません： -OFF, -OVERRIDE

別のユーザーIDを持つプロセスによってフリーズ・セットを解放します。GT.Mは、フリーズが発生した手続きが解放されなかった場合のエラー回復を可能にするために、オーバーライドを提供します。OVERRIDE修飾子の形式は次のとおりです：

-OV[ERRIDE]

MUPIP FREEZE操作でイベントを参照ポイントとして記録することを指定します。MUPIP FREEZEを使用して、カスタムバックアップメカニズム（SANまたはミラーベース）用にデータベースを設定することができます。

RECORD修飾子の形式は次のとおりです：

-R[ECORD]

例：

$ mupip freeze -off DEFAULT

このコマンドは、DEFAULT領域で進行中のMUPIP FREEZE操作を停止します。

例：

$ mupip freeze -on "*"

このコマンドは、現在のグローバルディレクトリ内のすべてのリージョンを更新しないようにします。

例：

$ set +e
$ mupip freeze -on -record "*"
$ tar cvf /dev/tape /prod/appl/*.dat
$ mupip freeze -off
$ set -e

set + eコマンドは、コマンドが遭遇したエラーにかかわらず、シェルがシーケンス内のすべてのコマンドを試行するように指示します。これは、tarコマンドが失敗したとしても、freeze -off が処理されるようになります。FREEZEは、現在のグローバルディレクトリによって識別される、すべてのデータベースファイルを更新することを防ぎます。 -record修飾子は、各データベースの現在のトランザクションは、データベースファイルのヘッダーのレコードの一部分に格納することを、指定します。tarコマンドは、/drod/app から.dat拡張子を持つすべてのファイルを含めて、/dev/tapeデバイスに、テープアーカイブファイルを作成します。おそらく、現在のグローバルディレクトリ内のすべてのデータベースファイルは、そのディレクトリに、その拡張子で、保存されます。2番目のFREEZEコマンドは、を再は、最初のFREEZEにより一時中断された更新を、再び有効にします。set - eコマンドは、シェルによって、通常のエラーハンドリングを再び有効にします。

例：

$ mupip freeze -override -off DEFAULT

このコマンドは、異なるユーザーIDを持つプロセスによってフリーズが設定されていても、DEFAULT領域をフリーズ解除します。

file-nameがデータベース・ファイルであることを指定します。デフォルトでは、MUPIP FTOK は -DB を使用します。

報告されたキーが、現在のグローバルディレクトリによって作成されたインスタンスのジャーナルプール用であることを指定します。

報告されたキーが、現在のグローバルディレクトリによって作成されたインスタンスの受信プール用であることを指定します。

MUPIP INTEGがデータベースの診断中に想定するデータブロックの論理的な隣接関係を指定します。デフォルトでは、MUPIP INTEGは -ADJACENCY=10で動作し、MUPIP INTEGレポートの「Adjacent」カラムに論理的な隣接関係を報告します。

ADJACENCY修飾子の形式は次のとおりです：

-AD[JACENCY]=integer

MUPIP INTEGコマンドのブロックを指定して、データベースのサブツリーのチェックを開始します。MUPIP INTEG -BLOCKは「間違ってマークされたビジーエラー」を検出できません。

. BLOCK 修飾子の書式は次のとおりです：

-BL[OCK]=block-number

ディレクトリ、インデックス、データブロックの総数をデータベースファイルごとに1つのサマリーレポートで表示します。BRIEF修飾子の形式は次のとおりです：L

-BR[IEF]

インデックスブロックのみをチェックします。 FASTは、データブロックをチェックしません。

FAST修飾子の形式は次のとおりです：

-FA[ST]

MUPIP INTEG操作のデータベース・ファイルの名前を指定します。FILEは、データベースファイルへの排他的（スタンドアロン）アクセスを必要とし、グローバルディレクトリを必要としません。FILE修飾子の形式は次のとおりです：

-FI[LE]

MUPIP INTEG操作の拡張レポートを表示します。-FULLを指定すると、MUPIP INTEGは、ディレクトリー・ツリーおよび各グローバル変数ツリー内の索引およびデータ・ブロックの数、ならびにディレクトリー、索引およびデータ・ブロックの合計数を表示します。FULL修飾子の形式は次のとおりです：

-FU[LL]

MUPIP INTEGレポートに検出された問題の疑いのあるデータを識別するキー範囲が含まれているかどうかを指定します。KEYRANGES修飾子の形式は次のとおりです：

-[NO]K[EYRANGES]

デフォルトでは、INTEGは -KEYRANGES を表示します。

MUPIP INTEGが報告する「誤ってマークされたビジーエラー("incorrectly marked busy errors")」の最大数を指定します。MAP修飾子の形式は次のとおりです：

-[NO]MAP[=max_imb_errors]

	注意
	MUPIP INTEGは、すべての「間違ってマークされたフリー("incorrectly marked free")」エラーを即時に処理する必要があると報告します。MAPはレポートを制限しません。

インデックスブロック内のエラーは、データベースの大きい領域の潜在的な処理から、INTEGを防止します。単一の「プライマリ」エラーにより、有効なインデックスポインタを持たない有効なブロックを特定するのに実際に役立つ、多数の「セカンダリ」誤ってマークされたビジーエラーが発生する可能性があります。"リアル"、または、ビジーエラーをマークされたプライマリの誤りは、システムへ使用できない"空"のブロックのみ作り、それらは低い影響であり、そして、すぐに修復する必要はありません。

	注意
	-RECOVER（たとえば、-BEFORE_TIMEを使用）または-ROLLBACK（たとえば、-FETCHRESYNCを使用）を使用したデータベースのリカバリ後に、データベースに誤ってマークされたビジー・エラーが含まれている可能性があります。これらのエラーは問題ありませんが、使用可能なスペースを消費します。次の機会に修理を予定します。

MUPIP INTEG操作で報告される「キーサイズが大きすぎます("key size too large" )」エラーの最大数を指定します。MAXKEYSIZE修飾子の形式は次のとおりです：

-[NO]MAX[KEYSIZE][=integer]

MUPIP INTEG操作がアクティブな間、他のプロセスがバックアップの結果に影響を与えずにデータベースを更新できることを指定します。データベース構造の整合性をデータベースの更新と同時に確認することができます。ONLINE修飾子の形式は次のとおりです：

-[NO]O[NLINE]

INTEGパラメータがデータベースファイルというよりは、むしろ、1つ以上の領域(Region)を識別することを、指定します。REGION修飾子の形式は次のとおりです：

-R[EGION]=region-list

INTEGのグローバルまたはキーの範囲を指定します。グローバルキーは、引用符(" ")で囲む必要があります。コロン(:)で、2つの添字を区切って、範囲を指定します。 -SUBSCRIPTは、間違ってマークされたビジーエラーを検出できません。 SUBSCRIPT修飾子の形式は次のとおりです：

-S[UBSCRIPT]=subscript

添字内のキーへのパスが破損していない場合のみ、SUBSCRIPTを指定してください。もしパスが疑わしい、または損傷していることがわかっている場合は、DSEを使用してブロックと INTEG -BLOCK を見つけます。

次の修飾子とは同時利用できません： -BLOCK, -TN_RESET

トランザクション番号とバックアップイベント記録されたトランザクション番号を1つにリセットし、現在のトランザクション番号を2つにリセットします。これにより、バックアップイベント記録されたトランザクション番号をより有意義かつ有益なものにします。また、バックアップを実行するための勧告メッセージを発行します。

TN_RESET修飾子の形式は次のとおりです：

-TN[_RESET]

	注意
	GT.Mアップデートが正しく閉じられなかったデータベースファイルを開くたびに、GT.Mはトランザクション番号を1000だけインクリメントします。この自動増分は、異常なデータベースのクローズによって引き起こされる問題を防ぎますが、ユーザーは常に操作手順でこの要素を考慮する必要があります。GT.Mがトランザクション番号を使い切る("uses up")する割合は、運用手順と実際のデータベース更新の機能によります。

MUPIP INTEGが報告する 「トランザクション番号のブロックが大きすぎます(block transaction- number-too-large errors)」エラーの最大数を指定します。TRANSACTION修飾子の形式は次のとおりです：

-[NO]TR[ANSACTION][=integer]

例：

$ mupip integ -block=4 mumps.dat

このコマンドは、mumps.dat のブロック4に対してMUPIP INTEG操作を実行します。

例：

$ mupip integ -adjacency=20

上記のコマンドの出力例は次のとおりです：

Type      Blocks     Records     % Used   Adjacent
Directory      2        5      4.150      NA
Index       18      1151     77.018       1
Data       1137      94189     97.894     1030
Free        43       NA       NA      NA
Total      1200      95345       NA     1031

この例では、論理的に関連するデータが現在のデータベース内の20のデータブロックを占有すると仮定して、MUPIP INTEG操作を実行します。サンプル出力は、1137個のデータブロックのうち、1030個のデータブロックが互いに隣接していることを示しています。すべてのブロックが可能な限り隣接している場合、データベースのパフォーマンスを向上させることができます。

例：

$ mupip integ -brief mumps.dat

このコマンドは、データベース mumps.dat に対してMUPIP INTEG操作を実行します。上記のコマンドの出力例は次のとおりです：

No errors detected by integ.
Type      Blocks     Records     % Used   Adjacent
Directory      2        2      2.490      NA
Index        1        1      2.343       1
Data        1        3      6.738       1
Free        96       NA       NA      NA
Total       100        6       NA       2

例：

$ mupip integ -fast mumps.dat

このコマンドは、データベースファイル mumps.dat のインデックスブロックに対してのみ MUPIP INTEG操作を実行します。上記のコマンドの出力例は次のとおりです：

No errors detected by fast integ.

Type      Blocks     Records     % Used   Adjacent
Directory      2        2      2.490      NA
Index        1        1      2.343       1
Data        1       NA       NA      NA
Free        96       NA       NA      NA
Total       100       NA       NA       1

データ型のNAエントリ（太字で強調表示）に注意してください。これは、MUPIP INTEG-FAST操作がインデックスブロックのみをチェックしたことを意味します。

$ mupip integ -full mumps.dat

上記のコマンドの出力例は次のとおりです：

Directory tree
Level     Blocks     Records     % Used   Adjacent
  1        1        1      2.343      NA
  0        1        1      2.636      NA
Global variable ^Dinosaur
Level     Blocks     Records     % Used   Adjacent
  1        1        6      8.398       1
  0        6       500     83.902       6
No errors detected by integ.
Type      Blocks     Records     % Used   Adjacent
Directory      2        2      2.490      NA
Index        1        6      8.398       1
Data        6       500     83.902       6
Free        91       NA       NA      NA
Total       100       508       NA       7

例：

$ mupip integ -map=20 -maxkeysize=20 -transaction=2 mumps.dat

このコマンドは、MUPIP INTEG操作を実行し、「キーサイズが大きすぎます("key size too large")」エラーの最大数を20に制限します。

例：

$ mupip integ -map=20 -transaction=2 mumps.dat

このコマンドは、MUPIP INTEG操作を実行し、「トランザクション番号のブロックが大きすぎます("block transaction number too large" )」のエラーの最大数を2に制限します。

$ mupip integ -file mumps.dat -tn_reset

このコマンドは、データベース番号ごとにトランザクション番号を1にリセットします。

例：

$ mupip integ -subscript="^Parrots" mumps.dat

この例では、データベースファイル mumps.dat のグローバル変数 ^Parrotsに対してMUPIP INTEG 操作を実行します。

例：

$ mupip integ -subscript="^Amsterdam(100)":"^Bolivia(""Chimes"")" -region DEFAULT

この例では、MUPIP INTEG 操作を実行して、デフォルト領域 の ^Amsterdam (100)以上で ^Bolivia("Chimes") 以下のすべてのグローバル変数を実行します。

	注意
	コマンド文字列にリテラルを指定するには、二重引用符を使用します（ 例：^b(""c"") ）。

入力ファイルのフォーマットを指定します。もし入力ファイルの形式が指定されていない場合、MUPIP LOADは入力ファイルのファイルヘッダーに基づいてファイル形式（BINARY / ZWR / GO）を自動的に検出します。もし format が指定されている場合は、入力ファイルの実際のフォーマットと一致する必要があります。

フォーマットコードは次のとおりです：

B[INARY] - Binary format
GO - Global Output format
Z[WR] - ZWRITE format

LOADを開始すべきかどうか、入力ファイルのレコード番号を指定します。有効なキーの先頭がエラーを発生する以外のポイントを開始するために、LAODを指示します。BEGIN修飾子の形式は次のとおりです：

-BE[GIN]=integer

	重要
	常に、-BEGINポイントを選択するためのヘッダーレコードの数を検討してください。詳細については、FORMAT修飾子を参照してください。

LOADを停止すべきかどうか、入力ファイルのレコード番号を指定します。-END=integer は、LOADが動作するためには -BEGIN =integerより大きくなければなりません。LOADは、-ENDで指定された番号のレコードを処理した後、または、入力ファイルの最後に到達した後に終了します。END修飾子の形式は次のとおりです：

-E[ND]=integer

-FORMAT=GO入力の値は、通常は偶数でなければなりません。デフォルトでは、LOADは入力ファイルの最後まで続きます。

データベースブロックに格納されているデータの量を指定します。ブロックへの後続のランタイム更新は、FILL_FACTORによって予約された残りの空き領域を満たします。ブロック分割を避けるブロックは、より効率的に動作します。FILL_FACTOR 修飾子の形式は次のとおりです：

-FI[LL_FACTOR]=integer

	注意
	FILL_FACTOR は、更新が広いキー範囲で合理的に一様にレコードを追加または増やす場合に便利です。もし更新が常に昇順または降順のキーになっている場合、または、もしレコードのセットおよびレコードのサイズが更新時に比較的静的である場合、FILL_FACTOR は大きなメリットはありません。

エラーが発生したときのMUPIP LOAD動作を決定します。ONERROR修飾子の形式は次のとおりです：

-[O]NERROR={STOP|PROCEED|INTERACTIVE}

デフォルトでは、MUPIP LOADはエラーが発生すると終了します。

MUPIP LOAD が標準入力（stdin）から入力を受け取ることを指定します。 STDIN修飾子の形式は次のとおりです：

-S[TDIN]

例：

$ mupip load ex_file.go

このコマンドは、抽出ファイル ex_file.go の内容を現在のデータベースにロードします。

例：

$ mupip load -format=go big.glo

このコマンドは、現在のデータベースに抽出ファイルbig.gloをロードします。

例：

$ mupip load -begin=5 -end=10 rs.glo

このコマンドは、レコード番号 5からMUPIP LOAD操作を開始し、レコード番号10で終了します。BEGINの値は奇数であることに注意してください。上記のコマンドの出力例は次のとおりです：

GT.M MUPIP EXTRACT
02-MAR-2011 18:25:47 ZWR
Beginning LOAD at record number: 5
LOAD TOTAL Key Cnt: 6 
Max Subsc Len: 7 
Max Data Len: 1
Last LOAD record number: 10

例：

$ mupip load -fill_factor=5 reobs.glo

このコマンドは、現在のデータベースに抽出ファイルをロードするためにFILL_FACTORを5に設定します。

例：

$cat big.glo | mupip load -stdin
$mupip load -stdin < big.glo

これらのコマンドは、抽出ファイルbig.gloを-stdinを使用してロードします。

関連するリスト内のグローバルに関する情報を含むブロックをREORGが処理しないように指定します。つまり、他のグローバルを再編成する際に再編成もスワップもされません。 -EXCLUDEは、隣接関係を改善しようとするブロックスワップ動作を複雑にし、妨げるため、REORGの効率を低下させる可能性があります。

EXCLUDE修飾子の形式は次のとおりです：

-E[XCLUDE]=global-name-list

最初のケースで、REORGは、グローバル ^ACN のみ除外します。2番目のケースで、REORGは、A7からB7までの照合シーケンスの中のすべてのグローバル名を除外します。3番目のケースで、REORGは、A,B,Cを除外します。最後のケースで、REORGは、接頭辞がTMPのすべてのグローバルを除外します。

各データベースブロックを、どのようにフルにするべきかを指定します。これは、ターゲットの数です。個々のブロックは、フィルファクターよりも、多かれ少なかれフルになることがあります。FILL_FACTOR 修飾子の形式は次のとおりです：

F[ILL_FACTOR]=integer

インデックスブロック内に、将来のアップデートのための空き領域を残すためにREORGを指示します。この修飾子に対する引数は、REORGがフィル可能なインデックスブロックの割合(パーセンテージ)を表す30から100までの整数でなければなりません。REORGは、インデックスブロック内の詳細情報を配置したり、別のブロックヘデータを移動することによってスペースを作成したりするかどうかを決定し、この番号を使用します。INDEX_FILL_FACTOR修飾子の形式は次のとおりです：

-I[NDEX_FILL_FACTOR]=integer

一定の条件の下で、特に大規模なデータベースのブロックサイズの場合は、データ用ブロックに比べてインデックス用ブロックがより小さなフィルファクタを使用することによって、高速なスループットを実現する可能性があります。デフォルトでは、その値が明示的に指定されているか、または、デフォルトで暗黙的に取得されたかのどちらにかかわらず、INDEX_FILL_FACTORはFILL_FACTORの値です。

中断されたREORG操作の場合、-RESUMEを使用すると、操作が停止した時点からREORG操作を再開できます。REORGは、データベースファイルのヘッダーに、最後のキー値を格納します。RESUME修飾子の形式は次のとおりです：

-R[ESUME]

REORGが関連リスト内の領域(Region)内で操作されるように指定し、REORGを現在のグローバル・ディレクトリーでマップされている領域(Region)内のグローバルに制限します。 -EXCLUDEと-SELECTと同じインタラクションはありませんが、しかし、結合されたときにそれらのインタラクションを緩和しません。

REGION修飾子の形式は次のとおりです：

-R[EGION]=region-list

region-list は、リスト内の現在のグローバルディレクトリの複数の領域を指定することができます。領域(Region)は大文字小文字を区別せず、カンマで区切り、ワイルドカードを使用して指定できます。どの領域(Region)名でもワイルドカード文字 * と % を含めることができます（シェルによる不適切な拡張からそれらを保護するためにエスケープしてください）。領域(Region)名の展開は、M（ASCII）の照合順序で行われます。

REORG は関連リスト内のグローバルのみを再編成することを指定します。リストにないグローバルは、-EXCLUDEで指定されていない限り、選択されたグローバルとのブロック・スワップによって変更される可能性があります。 -SELECTは、-EXCLUDEリストの名前でなければ選択されていないグローバルを非最適化する傾向があるため、効率的に使用するのが難しい場合があります（これは非効率的です）。

SELECT修飾子の形式は次のとおりです：

-S[ELECT]=global-name-list

REORGが、領域(Region)の内容の一部または全部を再配置した後に、データベース・ファイルのサイズを縮小し、空きスペースをファイル・システムに戻そうとすることを指定します。TRUNCATE修飾子の形式は次のとおりです：

-T[RUNCATE][=percentage]

オプションのパーセンテージ（0〜99）は、再生利用(reclamation)の最小量を提供します。言い換えれば、REORGは、少なくともファイルのこのパーセンテージを戻すことができない限り、ファイルの切り詰めを実行するのを邪魔することはありません。デフォルト（0）は、できる限り何かを戻します。TRUNCATEは、ビットマップ境界に合わせたスペースを常に返します。これは512データベースブロックの間隔になります。TRUNCATEはビットマップを解析し、必要に応じてリサイクルされた（以前に使用された）ブロックの必要に応じてイメージジャーナルレコードの前に生成します。切り詰められたデータベースファイルのジャーナル抽出には、特定のブロックが切り捨てによってリサイクルされてマークされたことを示す inctn オペコード値 9 を有するINCTNレコードを含むことができます。

	注意
	同時のオンラインBACKUPがある場合、またはINTEGなどのスナップショット・メカニズムを使用している場合、TRUNCATEは完了しません。

例：

$ mupip reorg -exclude="^b2a,^A4gsEQ2e:^A93"

この例では、^b2a を 除くすべてのグローバルおよび ^A4gsEQ2e から^A93 まで範囲のすべてのグローバルに対してMUPIP REORG操作を実行します。

例：

もし比較的均等に分散された更新によってグローバルの予測成長率が月5%で、REORGが四半期ごとにスケジュールされる場合、オリジナルのLOADとそれに続くREORGのFILL_FACTORは、80% 100-((3か月 + 1か月の "安全 "マージン) * 5%/月) となります。上記の仮定に基づくREORGコマンドは、次のとおりです：

$ mupip reorg -fill_factor=80 

データのロードに必要なサイズよりも小さい場合、MUPIP RESTORE操作でデータベースファイルを自動的に拡張するかどうかを指定します。

EXTEND修飾子の形式は次のとおりです：

-[NO]E[XTEND]

バックアップ間のMのアクティビティは、自動的にデータベースファイルを拡張することがあります。したがって、RESTOREのために出発点として指定されたデータベースファイルは、復元する前に、拡張を必要とする可能性があります。もしデータベースに拡張子が必要で、コマンドで -NOEXTENDが指定されている場合、MUPIPはメッセージを表示して終了します。メッセージは、データベースファイルの入力と出力のサイズと、データベースが拡張されたブロック数を提供します。もしRESTOREがファイルリストをもつ1つ以上のインクリメンタルバックアップを指定するならば、データベースファイルは拡張を1つ以上である必要があります。

デフォルトでは、RESTOREは自動的にデータベースファイルを拡張します。

$ mupip restore backup.dat $backup_dir/backup.bk1, $backup_dir/backup.bk2, $backup_dir/backup.bk3

このコマンドは、backup.dat を、環境変数 backup_dir で指定されたディレクトリに格納されている増分バックアップからリストアします。

$ mupip restore gtm.dat '"gzip -d -c online5pipe.inc.gz |"'

このコマンドは、pipeを使用して、online5pipe.inc.gzに格納されているバイトストリームバックアップからの最後のDATABASEバックアップ以降にgtm.datをリストアします。

引数が単一のデータベースファイルのファイル名であることを指定します。-FILE修飾子はREGION修飾子と同時利用できません。もしRUNDOWNパラメータがファイルのリストで構成するならば、コマンドはリスト内の最初の項目でのみ動作します。

次の修飾子とは同時利用できません： -REGION

MUPIP RUNDOWNが、複製が有効な（BEFORE_IMAGEの）データベースまたは異常終了した非複製NOBEFOREジャーナルデータベースの停止を防止する保護を無効にします。保護には、以前にクラッシュしたレプリケーション対応（BEFORE IMAGEジャーナリングを使用）データベースのMUUSERLBKエラーと、非レプリケートまたはNOBEFOREジャーナリング・データベースのMUUSERECOVエラーの発行が含まれます。これらの両方のエラーは、ジャーナル・ファイルまたはレプリケーション可能なデータベースからのデータ・リカバリーに関連する複雑さを防ぎます。

region-listは、RUNDOWNのターゲットを識別します。region-listは、リスト内の現在のグローバルディレクトリの複数の領域(Region)を指定することができます。領域(Region)は大文字小文字を区別せず、カンマで区切り、ワイルドカードを使用して指定できます。どの領域(Region)名でもワイルドカード文字 * と % を含めることができます（シェルによる不適切な拡張からそれらを保護するためにエスケープしてください）。領域(Region)名の展開は、M（ASCII）の照合順序で行われます。

ワイルドカード "*" を使用して、グローバルディレクトリ内のすべての非アクティブ領域を停止します。

次の修飾子とは同時利用できません：-FILE

MUPIP RUNDOWNに修飾子がない場合、ノード上のすべての非アクティブなデータベース・メモリー・セクションについての停止が実行されます。このフォームはデータベースの明示的なリストを持たないため、破棄されたメモリセグメントを持たない領域ではクリーンアップを実行しませんが、クラッシュ時にはシャットダウンしていない可能性があります。

孤立したRelinkctlファイルをクリーンアップします。FISは、GT.Mプロセスの kill -9 やアクティブなRelinkctlやRtnobj共有メモリセグメントの ipcrm -m など、必要なクリーンアップが必要なアクションを避けることを強く推奨しています。

もしオプションの dir1 が指定されていない場合、MUPIP RUNDOWN -RELINKCTLは環境変数 $gtmroutines を調べ、接続カウントの確認と修正を試み、すべての非アクティブな自動再リンク対応ディレクトリ（*接尾辞付き）を実行します。別の方法として、パラメータ dir1 のディレクトリパスを指定することもできます。また、MUPIP RUNDOWN -RELINKCTL は、自動再リンク対応ディレクトリとして扱い、この1つのディレクトリに関連するリソースを停止します。正常終了時にはRLNKCTLRNDWNSUCメッセージが表示され、失敗時にはRLNKCTLRNDWNFLメッセージが出力されます（通常、ライブプロセスは依然としてRelinkctlファイルにアクセスしているため）。

引数が単一のデータベースファイルのファイル名であることを指定します。FILE修飾子の形式は次のとおりです：

-F[ILE]

次の修飾子とは同時利用できません： -JNLFILE、-REGIONおよび-REPLICATION

引数がジャーナル・ファイル名(journal-file-name)であることを指定します。JNLFILE修飾子のフォーマットは次のとおりです：

-JNLF[ILE] journal-file-name

次の修飾子とは同時利用できません： -FILE, -REGION and -REPLICATION

現在のグローバルディレクトリでマップされたデータベースファイルを識別する領域リストとなる引数を指定します。REGION修飾子の形式は次のとおりです：

-R[EGION] region-list

領域(REGION)リスト(region-list)は、SETの対象を識別します。region-listは、リスト内の現在のグローバルディレクトリの複数の領域(Region)を指定することができます。領域(Region)は大文字と小文字を区別せず、カンマで区切り、ワイルドカードを使用して指定できます。どの領域名(region-name)にもワイルドカード文字 * と % を含めることができます（シェルによる不適切な拡張からそれらを保護するためにエスケープすることを忘れないでください）。領域(Region)名の展開は、M（ASCII）の照合順序で行われます。

次の修飾子とは同時利用できません： -FILE、-JNLFILE および -REPLICATION。

複製がオンかオフかを指定します。REPLICATION 修飾子の形式は次のとおりです：

-REP[LICATION]={ON|OFF}

次の修飾子とは同時利用できません：-FILE、-JNLFILE、および -REGION。

グローバルデータベースファイルからのデータの格納および取得のためのアクセス方法（GT.Mバッファリング戦略）を指定します。ACCESS_METHOD修飾子の形式は次のとおりです：

-A[CCESS_METHOD]=code

ACCESS_METHODの指定の詳細については、 “セグメント修飾子” を参照してください。

MMアクセスモードで、ジャーナルバッファのディスクへの書き込みを保証する前に、更新後に待機を生成するためにフラッシュ時間に適用される倍率を指定します。デフォルトは1です。値 2 は、フラッシュ時間の2倍の待機を生成します。 -NODEFER_TIME または -1 の値を指定すると、定期的なジャーナル書き込みがオフになり、軽い更新条件の下で、エポック時間と同じくらい古い時間が得られます。sync_ioオプションが設定されていないMMモードでは、アプリケーションからのVIEW（ "JNLFLUSH"）がないと、GT.Mはエポックでジャーナルをfsyncします。DEFER_TIME修飾子の形式は次のとおりです：

-[NO]D[efer_time][=seconds]

既存のデータベースファイルを拡張するGDSブロックの数を指定します。ファイルまたは領域の名前が必要です。この修飾子はスタンドアロンアクセスが必要です。EXTENSION_COUNTコマンドのフォーマットは次のとおりです：

-E[XTENSION_COUNT]=integer 

EXTENSION_COUNT の指定の詳細については、 “セグメント修飾子” を参照してください。

古いキャッシュバッファの書き込みを引き延ばす間の時間量を指定します。デフォルト値は1秒で、最大値は1時間です。-FLUSH_TIMEには、スタンドアロンアクセスが必要です。FLUSH_TIME修飾子のフォーマットです：

-F[LUSH_TIME]=[[[HOURS:]MINUTES:]SECONDS:]CENTISECONDS

BGデータベースに対するキャッシュバッファ数を指定します。この修飾子はスタンドアロンアクセスが必要です。GLOBAL_BUFFERS修飾子の形式は次のとおりです：

-G[LOBAL_BUFFERS]=integer

GLOBAL_BUFFERSの有効な作業サイズを決定する方法の詳細については、 “セグメント修飾子” を参照してください。

一般的に、グローバルバッファ数の増加は、システム上のI/O負荷のピークを平滑化することにより、パフォーマンスを改善します。しかし、グローバルバッファの数を増やすと、システムのメモリ要件も増加し、メモリが制約されたシステム上のグローバルバッファの数が増えると、バッファがスワップアウトされる確率が高くなります。もしグローバルバッファがスワップアウトされるならば、グローバルバッファ数の増加から任意のパフォーマンスを得ること以上に、グローバルバッファのスワップのパフォーマンスへの影響により相殺されることでしょう。ほとんどのアプリケーションは頻繁に使用されるデータベース領域では1000から4000のグローバルバッファを使用します。特殊な状況を除いて、FISは 256以下のバッファを使用することは推奨しません。

最小は64バッファで、最大は65536バッファです。デフォルトでは、MUPIP CREATEはGLOBAL_BUFFERSはグローバルディレクトリに入った情報を使用して確立されます。

多くのUNIXシステムでは、デフォルトのカーネルパラメータではGT.Mのグローバルバッファにとっては不十分な可能性があり、システム管理者によって調整される必要があるでしょう。

ある領域内のカスタムエラーを有効または無効にして、インスタンスフリーズを自動的に発生させます。このフラグは、 "Inst Freeze on Error" ファイルヘッダーフラグを変更します。INST_FREEZE_ON_ERROR修飾子の形式は次のとおりです：

-[NO]INST[_FREEZE_ON_ERROR]

インスタンスフリーズを自動的に引き起こすカスタムエラーのリストの作成の詳細については、“インスタンスフリーズ” を参照してください。

どのインスタンスでインスタンスが使用可能になっているかにかかわらず、インスタント・フリーズを即座に設定またはクリアする方法の詳細は、「データベース・レプリケーション」の章の “ソース・サーバーの起動” を参照してください。

データベースがジャーナリングを許可するかどうかを指定し、そして、もしなるならば、ジャーナルファイルの特性を許可するかどうかを指定します。

	注意
	ジャーナリングを有効または無効にしている領域(Region)では、スタンドアロン・アクセスまたは更新のフリーズを必要とせずにジャーナルファイルを切り替えることができます。

JOURNAL修飾子の形式は次のとおりです：

-[NO]J[OURNAL][=journal-option-list]

すべてのJOURNAL修飾子とそのキーワードの詳細については、 “SET -JOURNALオプション ” を参照してください。

グローバル・データベース・ファイルからデータを格納および取得するための最大キーサイズをバイト単位で指定します。サポートされる最大サイズは 1019 バイトです。KEY_SIZE修飾子の形式は次のとおりです：

-K[EY_SIZE=bytes

KEY_SIZEの詳細については、“領域(Region)修飾子” を参照してください。

Mの管理に割り当てられているページ数はデータベースに関連付けられたロックを指定します。ページのサイズは常に512バイトです。LOCK_SPACE修飾子のフォーマットです：

-L[OCK]_SPACE=integer

GT.Mがデータベースの主要クリティカルセクションの競合を管理するために使用する構造体のサイズを設定します。パフォーマンスの問題は、データベースアクセスを競合するプロセスが多数ある場合、および、この構造が待機中のすべてのプロセスに対応できない場合に発生する可能性があります。したがって、FISでは、データベースにアクセスすると予想される同時プロセスの最大数よりもわずかに多い値にこの値を設定することを推奨しています。

最小値は64、最大値は32768です。デフォルト値は 1024 です。MUTEX_SLOTS修飾子の形式は次のとおりです：

-M[UTEX_SLOTS]=integer

例えばベンチマークシナリオなど、ほぼ同時にシャットダウンするためにデータベースファイルにアクセスする多数のプロセスが必要な場合、通常のプロセス・シャットダウンを迅速化します。QDBRUNDOWN修飾子の形式は次のとおりです：

-[NO]Q[DBRUNDOWN]

終了するGT.Mプロセスが、多数のプロセスがデータベース・ファイルに接続されていて、かつ、QDBRUNDOWNが使用可能になっていることを確認すると、そのプロセスがデータベースにアクセスしている最後のプロセスかどうかのチェックをバイパスします。このようなチェックはクリティカル・セクションで行われ、バイパスは通常のRUNDOWNアクションをバイパスし、プロセスのシャットダウンを加速し、プロセス起動の障害を取り除きます。デフォルトでは、QDBRUNDOWNは無効です。

QDBRUNDOWNでは、データベースファイルのヘッダーとIPCリソースをクリーンアップする必要がある競合状態が発生する可能性があることに注意してください。QDBRUNDOWNは競合状態の可能性を最小限に抑えますが、それを排除することはできません。QDBRUNDOWNを使用する場合、FISは、データベースファイルのヘッダーおよびIPCリソースのクリーンアップを確実にするために、最後のプロセスが終了した後にデータベースファイルの明示的なMUPIP RUNDOWNを推奨します。

データベース・ファイル・ヘッダーの CORRUPT_FILE フラグをFALSEに設定します。CORRUPT_FILE フラグは、領域(Region)が正常にリカバリーを完了したかどうかを示します。PARTIAL_RECOV_BYPASS修飾子の形式は次のとおりです：

-PA[RTIAL_RECOV_BYPASS]

詳細は、 “CHANGE -CHANGE-FIleheader修飾子” のCORRUPT_FILE修飾子を参照してください。

グローバル・データベース・ファイルからデータを格納および検索するための最大レコード・サイズをバイト単位で指定します。サポートされる最大サイズは1MiBバイトです。RECORD_SIZE修飾子の形式は次のとおりです：

-REC[ORD_SIZE=bytes

KEY_SIZEの詳細については、“領域(Region)修飾子” を参照してください。

各データベースブロック内に確保されるサイズを指定します。RESERVED_BYTESは、一般的に、Mの通信プロトコルの制限を観察する他の実装、または互換性のための予備の部屋に使用されます。RESERVED_BYTES修飾子の形式は次のとおりです：

-RES[ERVED_BYTES]=size

後続のすべての新しいブロックの、ブロック・フォーマット・バージョン（ファイルヘッダの希望DBフォーマットフィールド）を設定します。VERSION修飾子の形式は次のとおりです：

-V[ERSION]={V4|V6}

データベースブロックの書き込みを断念するまでのディスク領域を待機する秒数を指定します、ここで、ゼロ（0）は待機せずにただちにエラーを出すことを意味します。WAIT_DISK 修飾子の形式は次のとおりです：

-W[AIT_DISK]=seconds

例：

$ mupip set -journal=on,nobefore -region "*"

この例では、NOBEFOREイメージジャーナリングを有効にし、すべての領域(Region)のジャーナリングをオンにします。

$ mupip set -version=V4 -file mumps.dat
Database file mumps.dat now has desired DB format V4

この例では、ブロック・フォーマットをV6データベース・ファイルmumps.dat内のすべての後続の新規ブロックについてV4に設定します。

例：

$ mupip set -version=v6 -file mumps.dat
Database file mumps.dat now has desired DB format V5

この例では、ブロック・フォーマットをV4データベース・ファイルmumps.dat内のすべての後続の新規ブロックについてV6に設定します。

例：

mupip set -flush_time=01:00:00:00 -region DEFAULT

この例では、フラッシュ時間を1時間に設定します。フラッシュ時間は、[[[時間:]分:]秒:]ミリ秒（ [[[HOURS:]MINUTES:]SECONDS:]CENTISECONDS ）の任意の組み合わせで指定することもできます。MUPIPは、-FLUSH_TIME=360000 または -FLUSH_TIME=00:60:00:00 を -FLUSH_TIME=01:00:00:00 と解釈します。

例：

$ mupip set -region REPTILES -inst_freeze_on_error

この例では、領域 REPTILES でカスタムエラーを有効にしてインスタンスフリーズを発生させます。

このセクションでは、トリガーの作成、変更、および削除の手順を段階的に説明します。トリガは、プロセス単位で動作する $gtmututines などの環境変数とは異なり、データベースを更新するすべてのプロセスに影響します。したがって、本番環境ではトリガを変更するための慎重に計画された手順を常に実行することをお勧めします。

グローバルノード ^Acct("ID") の新しいトリガーを作成するには：

グローバルノード ^Acct("ID") の既存のトリガを変更するには：

既存のトリガー定義を新しいものに直接置き換えることはできません。-NAME および -OPTIONS を除き、既存のトリガーを変更するには、既存のトリガー定義を削除し、変更されたトリガー定義を新しいトリガーとして追加する必要があります。GT.Mは、S[ET] がトリガー呼び出しコマンドであるかどうかによって、トリガー定義と一致する2つの異なるトリガー比較を実行することに注意してください。もし S[ET] がある場合、比較はグローバル名と添字、PIECES、[Z]DELIM、および、XECUTEに基づいて行われます。もしSETがない場合、GT.Mはグローバルノードのみを添字と -XECUTEコードの値と比較します。

グローバルノード ^Acct("ID") の既存のトリガーを削除するには：

トリガー "ValidateAccount" を正常に削除しました。

グローバルノード ^Acct("ID") のトリガー名を変更するには：

例：

$ mupip upgrade mumps.dat

この例では、mumps.datのファイルヘッダをV5形式にアップグレードします。