tcl.startlog Verb: Access/TCL

tcl.startlog

Command tcl.startlog Verb: Access/TCL
Applicable release versions: AP
Category TCL (746)
Description activates the transaction logging subsystem. All items in files with a "dl" type are automatically logged to the attached magnetic media on each add, change or delete to the item.

Before invoking this command a tape device must be already attached to the current port because the transaction logger steals the tape device.

The "port.number" argument indicates the port.number on which the logger is to be started. The default is one before the last port.

"wait.time" specifies the wait time interval (in milliseconds) to flush the tape buffer when the queue is empty. The default is 30 seconds. A negative number indicates no flush.

See the "txlog" menu for a simplified interface to the transaction logging subsystem.

If the transaction logger has not been initiated since the system was booted, the system does a "double-check" prompt.

If the transaction logger has been initiated previously, the prompt is not displayed.

"startlog" attaches the tape, if available, then logs the appropriate transactions.

If the tape is needed by another process, the transaction logger can be interrupted by attaching the tape using the "u" option with "t-att". In this case, the transaction logger must be restarted with the "startlog" command, as it will not automatically restart.

Any transactions that occur while the logger is interrupted are held on disk until the transaction logger is restarted.

All transaction tapes should be saved until the next full "file-save" or incremental "file-save" is performed. When the transaction logger encounters a tape problem it sends a message to port 0.
Syntax startlog {{port.number}{,wait.time}} {(options)}
Options a Starts, then activates. No prompt appears.

e Enqueues all files (except "tcl-stack") for logging, even if they are NOT dl-types.

f Sets flush time when accompanied by a number.

l Enqueues dl-type files only.

o Changes status of logger. Used only with the "l" and "e" options.

u Restarts the transaction logger and asks for new backup media. Backup media can only be specified after a system restore with this option. If no backup media has been specified, startlog prompts for one.
Example
startlog (eo

This changes the status of the logger to enqueue writes for all files, except 
"tcl-stack". "tcl-stack" items may be forced into the 
logging queue by editing and filing the item(s).

startlog (lo

This changes the status of the logger to enqueue writes for dl-type files only.
Purpose
Related tcl.t-att
tcl.log-msg
tcl.txlog
port.number
transaction.logger
tcl.update-logging