ConvertBot: send all textual screen output to specified file or device

2020-04-27T22:04:50Z

send all textual screen output to specified file or device

New page

send all textual screen output to specified file or device
<pre>
<FUNC> ON, TO, or OFF [DEF=OFF]
<FILE> File or device to send screen output

The ARCHIVE command can be used to save, or "archive", a record of history,
results, data lists, or other textual output. All screen output will go to
<file> until a new ARCHIVE command defines another archive file or a ARCHIVE
OFF command turns off the archiving function.

If FUNC is "TO", then <FILE> is name of the command that gets a "TEXT" message
forwarded to it for every terminal write.

Examples:

1. Send output of some commands to job.log (in the WRITE AUX) in addition to
the shell terminal, then turn off logging to archive file.
nM> archive on job.log !
commands ...
nM> archive off ! turn off logging

2. Send output of some commands to the MAIN macro (processMessage) as a "TEXT"
message in addition to the shell terminal.
...
archive to MAIN
commands...
archive off
..

Switches:
/ECHO=[ON|OFF] - Turn ON/OFF output to the screen [DEF=ON]

</pre>

[[Category:NXM_Explain]]

ARCHIVE - Revision history

ConvertBot: send all textual screen output to specified file or device