Skip to main content


Set the alternate location of the journal file.


[Journal]    AlternateDirectory=n

n is the full path to an existing directory. By default, no directory is listed.


AlternateDirectory is the name of an alternate (secondary) directory in which to store journal files.

This alternate directory is used if the primary journal directory specified by CurrentDirectory is unavailable; for example, if the disk partition for the primary journal directory is full, offline, or has some other problem. For these reasons, InterSystems recommends that the alternate journal directory be located on a different disk than the current journal directory.

When installed, the initial value of this field is an empty string. After InterSystems IRIS® data platform starts for the first time, the actual journal directory is filled in here, such as <install-dir>\mgr\journal.

The combined length of AlternateDirectory and the JournalFilePrefix parameters must be less than 208 characters. (The maximum length of JournalFilePrefix is 64 characters.)

Changing This Parameter

On the Journal Settings page of the Management Portal (System Administration > Configuration > System Configuration > Journal Settings) , in the Secondary journal directory row, select Browse. Select the name of an existing directory.

Instead of using the Management Portal, you can change AlternateDirectory in the Config.JournalOpens in a new tab class (as described in the class reference), from the ^JOURNAL utility (as described in Update Journal Settings Using ^JRNOPTS), or by editing the CPF in a text editor (as described in Editing the Active CPF).

FeedbackOpens in a new tab