NAME
log - Log a Soar agent session
SYNOPSIS
log action
DESCRIPTION
This command records the prompts, commands, printing, and command
results that are printed to stdout for a given agent. The
action must be one of the following:
- -open pathname access
- A log file named pathname is created with the selected
access mode and logging is initiated. The allowable
access modes are a to append to an existing file
and w to write to a new file or overwrite an existing file.
- -add string
- Add the given string to the open log file
- -query
- Returns open if logging is active or closed if
logging is not active.
- -close
- Close the open log file.
EXAMPLES
This initiates logging and places the record in foo.log:
log -open foo.log w
If foo.log exists, it will be overwritten.
This appends log data to an existing foo.log file:
log -open foo.log a
This terminates logging and closes the open log file:
log -close