Manipulate Journal Files Using ^JRNUTIL
InterSystems provides several functions in the ^JRNUTIL routine. You can use these functions for writing site-specific routines to manipulate journal records and files.
The following table lists the functions available in the routine.
Functions Available in ^JRNUTIL
Journaling Task |
Function Syntax |
Close a journal file |
$$CLOSEJRN^JRNUTIL(jrnfile) |
Delete a journal file |
$$DELFILE^JRNUTIL(jrnfile) |
Read a record from a journal file into a local array |
$$GETREC^JRNUTIL(addr,jrnode) |
Switch to a different journal file directory |
$$JRNSWCH^JRNUTIL(newdir) |
Open a journal file |
$$OPENJRN^JRNUTIL(jrnfile) |
Use an opened journal file |
$$USEJRN^JRNUTIL(jrnfile) |
Important:
The DELFILE^JRNUTIL function does not check for open transactions before deleting the journal file.
The following table describes the arguments used in the utility.
Argument |
Description |
addr |
Address of the journal record. |
jrnfile |
Name of journal file. |
newdir |
New journal file directory. |
jrnode |
Local variable passed by reference to return journal record information. |