ARCHIVE

send all textual screen output to specified file or device

<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]