ジャーナルファイルの自動作成

ジャーナルファイル自動作成の制御

既定では、CUBITを実行するたびにジャーナルファイルが自動的に作成されます。ファイルは現在のディレクトリに作成され、名前は「cubit」で始まり、cubit01.jouからcubit999.jouまで番号が続きます。ディスク容量の浪費や混乱を避けるため、1つのディレクトリに保持するジャーナルファイルは100個程度以下にすることを推奨します。そのため、ジャーナル名がcubit99.jouを超えると、起動時に少なくとも99個のジャーナルファイルが存在することと、不要なファイルを整理するよう求める警告が表示されます。cubit999.jouまで存在する場合は、現在のディレクトリにジャーナルファイルが多すぎることが警告され、cubit999.jouが再利用されて以前の内容は失われます。

Cubitの起動時に選択されるジャーナルファイル名は、既存のcubitXX.jouファイルによって決まります。Cubitは最も小さい番号から欠番を埋めます。たとえばcubit01.jou、cubit02.jou、cubit04.jouがすでに存在する場合、現在のジャーナルファイルにはcubit03.jouが使用されます。

ジャーナルファイル名は通常「.jou」拡張子で終わりますが、ユーザーが作成するジャーナルファイルでは必須ではありません。ジャーナリングが不要な場合は、-nojournalコマンドラインオプションでCUBITを起動するか、次のコマンドを使用します。

[Set] Journal {Off | On}

ジャーナリングを再び有効にすると、同じジャーナルファイルへのコマンド記録が再開されます。

セッション中に入力したCUBITコマンドの大部分はジャーナルへ記録されます。例外は、Zoom Cursorのように対話入力を必要とするコマンド、一部のグラフィックス関連コマンド、および Playback コマンドです。

グラフィックスコマンドの記録

グラフィックス関連コマンドの記録は、次のコマンドですべて有効または無効にできます。

Journal Graphics {On | Off}

既定値は Journal Graphics Off .

エンティティIDと名前の記録

コマンド内で名前を使用してエンティティを指定した場合、そのコマンドはエンティティ名を使って記録することも、対応するエンティティ型とIDを使って記録することもできます。名前を使用したコマンドのジャーナル記録方式は次のコマンドで指定します。

Journal Names {On | Off}

既定値は Journal Names On .

エンティティを型とIDで参照した場合、そのエンティティに名前が付いていても、コマンドは型とIDを使ってジャーナルへ記録されます。

APREPROコマンドの記録

APREPROコマンドは、次のコマンドを使用してジャーナルファイルへ出力できます。

[set] Journal [Graphics|Names|Aprepro|Errors] [on|off]

詳しくは APREPROジャーナリング を参照してください。

エラーの記録

CUBITの既定動作では、正常に実行されなかったコマンドはジャーナルへ記録されません。この動作を無効にし、成功・失敗に関係なくすべてのコマンドをジャーナルファイルへ出力するには、次のコマンドを使用します。

Journal Errors {On|OFF}

コマンドが正常に実行されず、journal errorsの状態がONの場合、失敗したコマンドはコメントとしてファイルへ書き込まれます。たとえば、失敗したコマンドはジャーナルファイル内で次のように記録されます。

## create brick x 10 x 10 z 10

CUBITはこの構文を誤りとして認識するため、そのコマンドを実行するとエラーを出しますが、コマンド自体は先頭に「##」を付けたコメントとしてジャーナルファイルへ書き込みます。

このオプションは、プログラムエラーの追跡や記録に役立ちます。