IAC2FILE  Printer To File Redirection
                   -------------------------------------

INTRODUCTION

IAC2FILE is a program that intercepts IAC scoring program printer output,
and redirects it to a specified file. The specified file is a text file that
may be displayed, edited, or printed, like any other text file.

IAC2FILE is a memory-resident program. Once installed, IAC2FILE resides in 
RAM memory in the background, becoming active only when there is output
headed for the printer. IAC2FILE captures the output before it reaches the 
printer, and routes it to the specified file. 

In order to once again send output to the printer once IAC2FILE has been 
installed, IAC2FILE must either be un-installed, or the output file must be 
de-specified. Then, any output for the printer will once again reach the 
printer. Until IAC2FILE is un-installed, or the file is de-specified, any
and all output for the printer will be redirected to the specified file.


REQUIREMENTS AND FILES

IAC2FILE.COM is the executed program. It runs in the DOS environment, not
   windows. It works with DOS 2.0 or greater. It works on any PC/XT/AT or
   Compatable or better, with any display, or any printer.

IAC2FILE.DOC is this plain text documentation file.


SYNTAX

[disk:][path]IAC2FILE [disk:][path][filename] [/Bnn] [/Dn] [/U]

filename is the name of the file that is specified for the printer output to 
   be redirected to. filename must be at least 2 letters long. filename may 
   be of the form FILENAME, or FILENAME.EXT, with .EXT being the optional 
   extension. All printer output that is directed to filename is APPENDED 
   onto the file contents. The file contents are not overwritten or cleared 
   first. A form-feed character is appended to the file contents concluding 
   each page if there is not already one included.

   If filename does not exist yet, then it is created. If IAC2FILE is
   re-executed with a different filename, then the latest filename will
   receive the printer output instead of the previous filename. IAC2FILE 
   may be re-executed any number of times, with the output file becoming
   whatever filename specifies.

   If a filename is not included in the command line, then the previously 
   specified filename is de-specified, and all output for the printer will 
   once again reach the printer.

/Bnn is an optional switch to set the output buffer size in number of 
   kilobytes. Valid values of nn are from 1 to 64, in increments of 1. The 
   letter K or k is not entered in the nn value. The default value is 4, 
   which provides plenty of buffer space for IAC scoring program output. The 
   output buffer is temporary RAM storage between the printer port and the 
   specified output file. This option is generally only needed when the disk 
   that the output file is on is extremely slow. 

   The output file will contain *Buffer Overflow* messages if the buffer is 
   too small, and output has not been included in the file. In this case, 
   the /Bnn switch is used to increase the buffer size. Since the buffer 
   uses RAM, if RAM is in very short supply, the /Bnn switch may be used to 
   decrease the buffer size. The buffer size may be reduced until *Buffer 
   Overflow* messages appear in the output file.

/Dn is an optional switch to specify the printer device number. Valid values 
   for n are from 1 to 3. The default value is 1. This option is only needed 
   if the printer output to be redirected is not for printer device 1, that 
   is LPT1 or PRN.

/U is an optional switch to remove IAC2FILE from resident RAM memory. 
   Including the /U switch causes IAC2FILE to be un-installed. Once
   un-installed, any output for the printer will once again reach the 
   printer.

   IAC2FILE can only be un-installed if no other resident programs have been
   installed since IAC2FILE was installed. Any resident programs installed 
   since IAC2FILE was installed must be un-installed first, then IAC2FILE 
   may be un-installed. 

   If IAC2FILE cannot be un-installed, it will respond with a Cannot 
   Uninstall message. In this case, output can be restored to the printer 
   by de-specifying the output file. This is accomplished by re-executing 
   IAC2FILE without including a filename, as described in the filename 
   section above. Alternatively, the computer can be re-booted to clear
   IAC2FILE from resident RAM memory.

[disk:][path] are optional disk and path specifiers. The specifiers 
   preceding IAC2FILE give the location of the executable IAC2FILE.COM 
   program. Without the use of these specifiers, the current directory is
   utilized. The specifiers preceding filename give the location of the 
   output file. Without the use of these specifiers, the current directory 
   is utilized.      


DISTRIBUTION

IAC2FILE was written as a utility for use with the IAC scoring program. 
   Distribution to anyone using the IAC scoring program is encouraged.


AUTHOR

IAC2FILE was written by Tom R. Myers, 300 Miramonte Ave., Palo Alto, CA,
   94306-1032, 415-328-2141 (Voice and Fax), in November, 1995.