
  
  	                         AUXPRT.LIT

				DOCUMENTATION
					  
			             1.2		


 		       Written By: James A. Jarboe IV
 			      1401 19th Street 
 			    Huntsville, TX 77340
 				409-295-5767
 
 				  02/24/86
                     Copyright (c) James A. Jarboe IV
                                   GR/AM

Current versions:

	AUXPRT.LIT 	161-400-444-103     AMOSL  1.2a-1.3??
	AUXPRT.M68      744-245-725-523     AMOSL  1.2a-1.3??

Description:

	AUXPRT is an assembly language program invoked from the AMOS
	dot or command mode that allows a file to be printed through
	the terminal to the auxillary port to which a printer is attached.

Usage:
        AUXPRT filename.ext
        or
 	AUXPRT (cr)
 	  Enter Filename : filename.ext
 	
 	The default extension is LST. That is if you do not specify
	a file extension then it will default to .LST .

	It can also be invoked inside a COMMAND or DO file


What it does: 
	
	Upon invoking AUXPRT the selected filename is opened for output.
        The auxillary port on the terminal is turned on by using the
	TCRT call 82 (similar to ? tab(-1,82) or XY=82).
	The terminal's terminal driver is then changed to DUMB.TDV and
	the opened file is then sent to the terminal through the auxillary
	port to the attached printer, one character at a time.
	When the opened file is empty, it is closed, the terminal's original
	terminal driver is put back into use and the auxillary port is 
	turned off by use of the TCRT call 83 (similar to ? tab(-1,83)
	or xy=83), and the terminal is returned to AMOS.
	
Why it does it:

	As far as I know any printable file can be used with this program,
	on any printer attached to the auxillary port of any terminal capable
	of Transparency Print, or the ability to send text to the auxillary
	port without displaying it on the terminal screen. The terminal's
	driver is changed to DUMB.TDV so that if text in the file contains
	any control or escape characters they will not affect the terminal.
	Some files such as those that are prepared to print on DIABLO or	
	NEC printers contain codes to operate the printer. Those codes are
	a mixture of control and escape codes. If used in conjuction with
	a terminals normal terminal driver routine the control of escape
	characters could do odd and weird things to the terminal's display,
	status, or current functions.	

Requirements:
	
1.	A terminal capable of printing to the auxillary port in a 
	TRANSPARENCY PRINT mode or printing to the port without displaying
	the text on the terminal screen.
2.     	TCRT codes 82 and 83 within the current terminal driver routine
	TCRT code 82 is the character sequence that turns the transparency
	mode off. TCRT code 83 is the character sequence that turns the
	auxillary port off.
3.	DUMB.TDV resident in DSK0:[1,6] . It can be added or used for 
	any other terminal, printer, or NULL job on the system in an .INI file.

	Add DUMB to an existing TRMDEF statement for a printer: 
	
		TRMDEF PRINTER,AM300=2,DUMB,9600,20,20,20

        or add a new dummy TRMDEF statement that contains the DUMB.TDV

                TRMDEF AUXPRT,PSEUDO,DUMB,1,1,1	

        Add one or the other to your .INI file and then reboot the System.

4.	The auxillary port on your terminal should be set up to match
	the printer, 8 bit, no parity, DTR, or whatever parameters the
	terminal allows for auxillary port to match what the printer needs
	to see. As far as pin hookups for the cable, that is dependent upon 
	your terminal and printer. The applications that I am familiar 
	with, use the cables that came with the printers, or a direct
	25 pin ribbon cable connected from auxillary port to printer.


Application:

	I am familiar and know of the following instance and that they
	do work:

	FRE100 terminal and a DIABLO 630 PRINTER - computer hookup
	FRE100 terminal and a DIABLO 630 PRINTER - modem hookup
	FRE100 terminal and an OKIDATA 93 PRINTER - modem hookup
	LNK125 terminal and a DIABLO 1680 PRINTER - computer hookup
	FRE100 terminal and a H-P LASER-JET       - computer hookup 
	WYSE50 terminal and all the above printers
	WYS350 terminal and all the above printers

	Different and varying baud rates from 9600 baud to 300 baud

	If these can be hooked up and work most anything can be.


EXAMPLE OF DUMB.TDV


	OBJNAM	DUMB.TDV

DUMB:	WORD	0
	RTN
	RTN
	RTN
	RTN
	END


SPECIAL:

	If you use other TCRT calls for Transparent print mode on
	your terminal drivers then you may replace the variable 
	AXON (which is auxillary on) and AXOFF (which is auxillary off)
	to any TCRT code that yur driver uses to turn the auxillary
	port on and off

	If you would like to substitute a special driver instead of the
	DUMB.TDV then place it in the place of DUMDVR: at the end of this
	program between the /    / on the RAD50 line.

	Any questions, answers, or comments to:
	Let me know if you use it and with what terminals and 
	printers so that others may know and use it if it works for them.

	James A. Jarboe IV
	Educational Filmstrips
	1401 19th Street
	Huntsville,  TX  77340
	GR/AM
	409-295-5767

	[101]- sleep 7.5 secends when through printing for auxport running
	       	at slower baud rate than main port's baud rate
		I.E.  MAIN PORT BAUD RATE                    = 9600
		      AUXILLARY PORT BAUD RATE & PRINTER     = 300

        [102]- fixed erroneous error out put of DUMB.DVR
               it should be DUMB.TDV ( a terminal or printer driver)
               DUMB should be added to a TRMDEF statement or made on
               new TRMDEF statement in the .INI file prior to booting system.
 
 		 TRMDEF PRINTR,AM300=3,DUMB,9600,20,20,20
 
                or
      
                 TRMDEF AUXPRT,PSEUDO,DUMB,1,1,1
 

.
