Controlling Playback of Journal Files

The following commands control the playback of Journal Files:

Stop

Pause

Sleep <duration_in_seconds>

Resume [<n>]

Where

Next [<n>]

The playback of a journal file can be interrupted in two ways. If the stop or pause commands are encountered in the journal file and Trelis is reading commands from a terminal (as opposed to a redirected file), playback of the journal file will halt after that command.

The sleep command pauses execution for the specified number of seconds. It can be used to build a delay into journal files during presentations.

If journal files that are playing back contain playback commands themselves, there may be multiple current journal files. The where lists all current journal files and where the journal files have paused. Each line contains the stack position (a number), the filename and the current line in the file. Unless Trelis is running in batch mode, the first line is always <stdin>. This just means that Trelis will return to the command prompt after the top-most journal file has completed.

The remaining portion of any active journal file may be skipped by specifying the stack position (first number on each line of the output from the where command) of the file where you want to resume. Any remaining commands in active journal files with lower stack positions will be skipped.

The next command steps through interrupted journal files line-by-line. The argument to the next command is the number of lines to read before halting playback again. If no number is specified, the command will advance one line.

Journal playback can also be set to stop automatically when it encounters an error during playback. The command syntax is:

Set Stop Error {On|OFF}

Setting the stop error to "on" will cause the file to halt for each error. The setting is turned off by default.