comlog¶

Purpose¶

Controls logging of interactive mode commands to a disk file.

Format¶

comlog [[file=filename]] [[on|off|reset]]

Parameters:

filename (literal or ^string) –

The file=filename subcommand selects the file to log interactive mode statements to. This can be any legal file name.

If the name of the file is to be taken from a string variable, the name of the string must be preceded by the ^ (caret) operator.

There is no default file name.

Example¶

// Log your interactive commands in the file
// 'mycommands.log' located in your current working directory
// Note that the 'reset' option will delete the current version
// of the file 'mycommands.log' if it exists
comlog file=mycommands.log reset;

// Report the comlog status
comlog;

Assuming your current working directory is /Users/Sam/gauss, you will see the following output:

Command log file: /Users/Sam/gauss/mycommands.log is open

// Execute some interactive commands.
// Note these must be run from the GAUSS command window.
// Code run in GAUSS program files will not be logged.
x = 5;
s = "This is a string";

After running the above commands, the contents of your /Users/Sam/gauss/mycommands.log file will be:

comlog;
x = 5;
s = "This is a string";

After running the above code, your commands will continue to be logged in your mycommands.log file until you enter:

comlog off;

Remarks¶

comlog on turns on command logging to the current file. If the file already exists, subsequent commands will be appended.
comlog off closes the log file and turns off command logging.
comlog reset turns on command logging to the current log file, resetting the log file by deleting any previous commands.
Interactive mode statements are always logged into the file specified by the log_file configuration variable in the gauss.cfg file, regardless of the state of comlog.
The command comlog file= filename selects the file but does not turn on logging.
The command comlog off will turn off logging. The filename will remain the same. A subsequent comlog on will cause logging to resume. A subsequent comlog reset will cause the existing contents of the log file to be destroyed and a new file created.
The command comlog by itself will cause the name and status of the current log file to be printed in the window.
Interactive commands to run a file, i.e. run ols.e; will not be logged by comlog.

combinate

compile