# $EPIC: log_command.txt,v 1.2 2007/02/15 03:53:35 jnelson Exp $
log <refnum> <command> [<arguments> ...]
The log command is the interface to the client’s generalized logfiles. A logfile writes a copy to a file of everything that appears in your display.
| ACTIVITY | Reset the logfile’s activity timer |
| ADD | Add a target or refnum this logfile will log |
| DESCRIBE | Output information about the logfile |
| FILENAME filename | |
| KILL | |
| LEVEL levels | |
| LIST] ]| | | [[log mangle|MANGLE [mangle types]] | |
| NAME logical name | |
| NEW | |
| OFF | |
| ON | |
| REFNUM logfile refnum or logfile name | Operate on |
| REMOVE target or window refnum or server refnum | |
| REWRITE expando string | |
| SERVER server refnum | |
| TYPE server or window or target |
The log command breaks down into a stream of operations of the form:
LOG <refnum> <operation> <operation-arguments>
The <refnum> is the target of the <operation>. The <refnum> is optional. There is no default <refnum> for the first operation, so it is an error if you don’t specify a logfile first.
If any <operation> fails, the current logfile is unset; further operations are performed, but since there is no logfile, most further operations will also fail.
The LOG command first appeared in EPIC4-1.1.8