Compucolor.org – Virtual Media

Listing of file='DRIVI.SRC;01' on disk='vmedia/ida_v2.6-sideB-sector.ccvf'

-

		PRINTER DRIVER PROGRAM V11.82


		 ENTERING THE COMMAND LINE




THE COMMAND LINE PROMPT IS A GREEN '>' THAT FOLLOWS THE INTRO-
DUCTION MESSAGE FOR THE PROGRAM.


THE COMMAND LINE IS BASICALLY A 128 BYTE BUFFER AVAILABLE TO
THE USER FOR TELLING THE PROGRAM HOW THE SOURCE FILE IS TO BE
SENT TO THE PRINTER.  WITHIN THIS ARE SEVERAL OPTIONS THE
PROGRAM WILL LOOK FOR BASED ON KEY CHARACTERS ENTERED.  THESE
CHARACTERS ARE:


C >	SETS THE MAXIMUM CHARACTERS PER LINE TO BE PRINTED
	BEFORE A CR/LF IS FORCED TO BE SENT.  CR/LF's SEEN
	BEFORE THE MAXIMUM LINE LENGTH IS REACHED WILL CAUSE
	A CR/LF TO BE SENT.  A MINIMUM OF 16 CHARACTERS PER
	LINE IS REQUIRED, WITH A MAXIMUM OF 132.

D >	DELETE CHARS FROM TEXT (SKIP CHARACTERS FROM BEING
	PRINTED).  FORMAT IS POSITION, NUMBER, WHERE POSITION
	IS THE CHARACTER POSITION TO START SKIPPING, AND
	NUMBER IS THE QUANTITY OF CHARACTERS TO SKIP OVER.
	UP TO EIGHT (8) SEPERATE FIELDS MAY BE SKIPPED IN
	THIS MANNER; IE:

	D21,9,37,1,40,3

	WILL SKIP FIELD 21 FOR 9 CHARACTERS, FIELD 37 FOR 1
	CHARACTER, AND FIELD 40 FOR 3 CHARACTERS.

	WARNING:   FAILURE TO ENTER DATA IN PAIRS MAY RESULT
	IN EITHER A COMMAND LINE ERROR OR THE PROGRAM MAY
	RETURN TO THE CRT MODE.

	WARNING:   DO NOT USE THIS PARAMETER AS THE LAST ENTRY
	ON THE COMMAND LINE OR THE PROGRAM MAY HANG UP.


I >	INSERT TABS.  THIS MAY BE USED TO AUTOMATICALLY INSERT
	TABS AT CERTAIN CHARACTER POSITIONS WITHIN THE FILE
	TEXT.  UP TO SIXTEEN (16) TABS MAY BE USED AND MULTIPLE
	TABS AT THE SAME POSITION ARE ALLOWED.  A SAMPLE ENTRY
	MIGHT BE:

	I3,7,7,12	WHICH INDICATES THAT TABS WILL BE SENT
	JUST PRIOR TO THE 3RD, 7TH (2 TABS), AND 12TH CHAR-
	ACTERS IN EACH RECORD OF THE FILE.  IF THE TEXT LINE,
	PRIOR TO TABBING, WAS:

	80TEST12345HELLO


	THEN THE TEXT WOULD BE PRINTED AS:

	80	TEST		12345	HELLO

	YOU WILL NOTE THAT THE TABS ARE SENT PRIOR TO THE CHAR-
	ACTER FOR THAT POSITION BEING SENT.  ALSO, YOU DO NOT
	NEED TO ADJUST THE CHARACTER COUNT IN ORDER TO DETER-
	MINE WHERE THE TABS SHOULD BE ENTERED AS THIS IS AUTO-
	MATICALLY DONE FOR YOU.


	WARNING:   DO NOT USE THIS PARAMETER AS THE LAST ENTRY
	ON THE COMMAND LINE OR THE PROGRAM MAY HANG UP.


LM>	LEFT MARGIN.  LEFT MARGIN ADJUST OR INDENTATION.
	ENTRIES ARE USUALLY IN MULTIPLES OF 8 AS THIS CONFORMS
	TO THE TAB POSITIONS, BUT THIS IS NOT A REQUIREMENT.
	HOWEVER, IF TABS AND LEFT MARGIN ARE UTILIZED FOR A
	PARTICULIAR FILE TEXT, THEN THE TABS MAY APPEAR TO BE
	OFF-CENTERED OR NOT SPACED PROPERLY WHEN THEY ARE
	ENCOUNTERED.


LP>	LINES/PAGE.  THIS WILL SET THE MAXIMUM LINES PER PAGE
	THAT WILL BE PRINTED.  THIS COUNT WILL NOT INCLUDE THE
	TOP OF FORM LINES, BUT WILL INCLUDE ANY MULTIPLE LINE
	SPACING AND TEXT ENTERED, IF USED.


LS>	LINE SPACING.  THIS MAY BE USED TO INDICATE SINGLE
	(LS1), DOUBLE (LS2), TRIPLE (LS3), OR OTHER LINE
	SPACING.


M >	MULTIPLE COLUMNS.  IN SOME CASES, IT IS DESIRED TO
	PRINT TEXT, OR TABLES, IN MULTIPLE COLUMN FORMAT.  THIS
	COMMAND WILL SET THE NUMBER OF COLUMNS TO BE PRINTED
	BEFORE A CR/LF IS ISSUED.  NOTE, HOWEVER, THAT IF THE
	MULTIPLE COLUMN PRINT OUT WOULD EXCEED THE MAXIMUM
	CHARACTERS PER LINE, A CR/LF WILL BE SENT AT THAT
	POINT, THEN THE REMAINDER OF THE TEXT.


P >	PAGE LENGTH.  THIS WILL SET THE PAGE FORM LENGTH FOR
	THE PRINTER.  THIS NUMBER MUST EXCEED THE TOP OF FORM
	LINE COUNT PLUS THE NUMBER OF LINES TO BE PRINTED
	(P > LP + T).


S >	SELECT MX-80 OR BASE 2 PRINTER.  THIS WILL SELECT ONE
	OF THE TWO PRINTER PRESET STRINGS TO BE SENT PRIOR TO
	ACTUAL PRINTING.  TO SELECT A BASE 2 PRINTER, ENTER
	THE PARAMETER "SB2", AND FOR THE EPSON MX-80, "SMX".
	"SB2" MUST BE ENTERED PRIOR TO THE "C" (CHARS PER
	LINE ENTRY) IN ORDER TO PROPERLY SET THE PRINTER
	PRESET STRING....FAILURE MAY RESULT IN THE PROPER
	NUMBER OF CHARACTERS BEING PRINTED, BUT WITHOUT THE
	PRINTER LINE WIDTH BEING ADJUSTED (IE, PRINTING 64
	CHARS/LINE WHEN PRINTER IS SET FOR 132 CHARS/LINE.)


T >	TOP OF FORM LINES.  THIS WILL ALLOW YOU TO SEND BLANK
	LINES AT THE TOP OF THE PAGE PRIOR TO PRINTING A NEW
	PAGE OF FILE TEXT.


[ >	ENTER MATCH STRING TEXT.  THIS ALLOWS YOU TO ENTER UP
	TO 16 CHARACTERS OF TEXT TO BE MATCHED WITH EACH
	RECORD, AND THE DEFAULT PRINT CONDITIONS AFTER COMPAR-
	ISON.  THE FORMAT IS:

	[CONDITIONS,STRING,POSITION]

	"CONDITIONS":

	<	SIGNIFIES RECORD WILL BE PRINTED IF THE
		COMPARISON PROVES TO BE LESS THAN.

	>	SIGNIFIES RECORD WILL BE PRINTED IF THE
		COMPARISON PROVES TO BE GREATER THAN.

	<>	SIGNIFIES RECORD WILL BE PRINTED IF THE
		COMPARISON DOES NOT MATCH.

	=	SIGNIFIES RECORD WILL BE PRINTED IF THE
		COMPARISON DOES MATCH EXACTLY.

	<= =>	ARE ALSO VALID EXPRESSIONS.

	"STRING" (ABOVE) IS THE DATA STREAM THAT WILL BE USED
	FOR COMPARISON PURPOSES.  THE MAXIMUM STRING LENGTH
	ALLOWED IS 16, AND THE MINIMUM REQUIREMENT IS 1.


	"POSITION" SIGNIFIES THE CHARACTER POSITION WITHIN THE
	RECORD THAT WILL BE THE STARTING POINT FOR THE COMPAR-
	ISONS.  IF A RECORD IS PHYSICALLY SHORTER THAN THE
	LENGTH OF THE MATCHING STRING PLUS THE CHARACTER POSI-
	TION TO START THE COMPARISON AT, THEN A <> (NOT EQUAL)
	CHECK WILL BE PERFORMED, AND, IF VALID, WILL ALLOW THE
	RECORD TO BE PRINTED.


	COMMAS MUST SEPERATE THE SPECIFIC ITEMS WITHIN THE LEFT
	AND RIGHT BRACKETS, AND THE CLOSING BRACKET (]) MUST BE
	USED OR A COMMAND LINE ERROR WILL OCCUR.  DO NOT INSERT
	SPACES EXCEPT WITHIN THE MATCH STRING.

R >	IF REPEATING COMPARISONS ARE DESIRED FOR ADDITIONAL
	FILES, THEN THIS OPTION MAY BE UTILIZED.  THE MATCH
	CONDITIONS ARE RETAINED, ALTHOUGH NOT NECESSARILY USED,
	FROM ONE PRINT TO ANOTHER.  TO RESET THE LAST MATCH
	CONDITIONS UTILIZED, THIS OPTION SHOULD BE ENTERED.

	IE:	*1:PERS,R	WILL RESET THE MATCH PARAMETERS
	LAST USED, EVEN THOUGH OTHER PRINTS, WITHOUT ANY MATCH
	CONDITIONS, WERE MADE PRIOR TO THIS.


A >	SET 'AND' CONDITION FOR MULTIPLE MATCHES.
O >	SET 'OR'  CONDITION FOR MULTIPLE MATCHES.

	THESE OPTIONS ARE USEFUL WHEN MORE THAN 1 MATCH IS
	DESIRED OF A RECORD, AND OPERATES SIMILIAR TO THE
	"IF A=6 OR B=10 THEN..." IN BASIC.  WITH THESE, YOU
	HAVE A MUCH MORE SELECTIVE PRINT OPTION AT HAND.  THE
	'A' AND 'O' OPTIONS MAY BE PLACED ANYWHERE WITHIN THE
	COMMAND LINE, BUT IT IS RECOMMENDED THEY BE PLACED
	ACCORDING TO THE FOLLOWING FORMAT:

	[CONDITION,STRING,POSIT],A,[CONDITION,STRING,POSIT]
				OR
	[CONDITION,STRING,POSIT],O,[CONDITION,STRING,POSIT]


	IT SHOULD BE NOTED THAT ONLY TWO (2) MATCH STRINGS ARE
	ALLOWED PER PRINT.  IF MORE THAN TWO ARE SPECIFIED,
	THEN THE FIRST AND LAST ONE ENTERED WILL ACTUALLY BE
	IN EFFECT.


* >	FILE NAME.  THE ASTERICK IS USED TO IDENTIFY THE START
	OF THE FILE NAME TO BE PRINTED.  IF THE SAME FILE IS
	TO BE PRINTED AGAIN, THEN ONLY THE ASTERICK NEEDS TO
	BE ENTERED FOR THE FILE NAME.  THE FILE NAME MUST BE
	THE FIRST ENTRY ON THE COMMAND LINE.


$ >	QUIT THE PROGRAM.  THIS IS THE ONLY COMMAND THAT IS
	ACTED UPON IMMEDIATELY WHEN DETECTED, AND MUST NOT BE
	PART OF A COMPLEX COMMAND SEQUENCE.  WHEN USED, THIS
	SHOULD BE THE ONLY ENTRY ON THE LINE.  AN ADDITIONAL
	FORM FEED WILL BE SENT TO THE PRINTER PRIOR TO
	RETURNING TO THE FCS SYSTEM.


# >	READ PARAMETER FILE.  THIS PARAMETER MAY BE USED TO
	RETRIEVE ALL PREVIOUS PARAMETERS FROM A PARAMETER
	SOURCE FILE NAMED "PARAM", RESIDING ON EITHER DISK.
	USE OF THIS COMMAND WILL ALLOW YOU TO RETRIEVE ALL
	BASIC PARAMETERS FROM "PARAM.SRC" WITHOUT HAVING TO
	SPECIFICALLY ENTER EACH ON THE COMMAND LINE.  IF THIS
	OPTION IS USED, IT MUST BE THE FIRST ENTRY ON THE
	COMMAND LINE.


	THE '#' MUST THEN BE FOLLOWED BY A FOUR CHARACTER CODE,
	LETTERS OR NUMERALS, WHICH IDENTIFIES THE LISTING IN
	THE FILE THE USER IS TO RETRIEVE.  IE, "#PERS" MAY LIST
	PARAMETERS FOR A PERSONNEL FILE, WHILE "#PAD " MAY
	SPECIFY PARAMETERS OF THE SAME PERSONNEL FILE FOR ADD-
	RESS DATA.  NOTE THE USE OF A TRAILING SPACE IN "#PAD "
	TO MAKE UP THE 4 CHARACTER REQUIREMENT.


	THE PARAMETER FILE MAY BE GENERATED BY THE USE OF THE
	CCII SCREEN EDITOR, AND TAKES THE FOLLOWING FORMAT:


	EACH SPECIFIC FILE PRINTING PARAMETER SERIES MUST
	(REPEAT MUST) BE SPECIFIED ON TWO DISTINCT LINES, EACH
	FOLLOWED BY A CARRIAGE RETURN/LINE FEED.  THE FIRST
	ENTRY OF EACH LINE MUST BE THE MATCHING CODE ("PERS"
	AND "PAD " ABOVE) WITHOUT THE LEADING '#' MARK.  THE
	FIRST LINE MUST THEN BE FOLLOWED BY THE FILE NAME TO
	BE PRINTED, AND THE REMAINING PARAMETER MAKEUP, IN ANY
	ORDER DESIRED, SO LONG AS THE REQUIREMENTS SPECIFIED
	EARLIER ARE MET.  THE SECOND LINE MUST CONTAIN AT LEAST
	ONE (1) PARAMETER FOR THE FILE TO BE PRINTED.  IN
	ESSENCE, THE PARAMETER FILE CONTAINS A SERIES OF COMMON
	COMMAND LINES THAT YOU WOULD NORMALLY TYPE IN DIRECTLY.


	USE OF THE '#' OPTION DOES NOT NEGATE SPECIFYING OTHER
	OPTIONS ON THE COMMAND LINE.  IT IS PERFECTLY LEGAL TO
	HAVE COMMAND LINES (ON THE CRT) AS FOLLOWS:


	#PERS,C64
	#PAD ,C80,LM0

	EVEN THOUGH CHARS/LINE AND LEFT MARGIN MAY ALREADY BE
	SPECIFIED IN THE PARAMETER FILE, YOUR ENTRY WILL OVER-
	RIDE ANY PARAMETER IN THE FILE.


	TWO SAMPLE ENTRIES OF THE PARAMETER FILE:


	PERS,*PERS,SB2,C64,P66,LM0,LP50,LS2
	PERS,D26,3,I16,18,20,T4
	PAD ,*PERS,SMX,C96,P66,LM8,LP50,LS1
	PAD ,D0,I16,T2


	NOTE THE FOUR CHARACTER PRINT CODE LEADING EACH LINE,
	AND THAT 1 COMMAND SEQUENCE TAKES UP TWO LINES.


PARAMETER SEPERATION:


	EACH SPECIFIC PARAMETER SHOULD BE SEPERATED BY A COMMA
OR SPACE.


SAMPLE COMMAND LINE:


	A SAMPLE COMMAND LINE MAY APPEAR AS FOLLOWS:

	>  *1:TEXT.SRC;3,SB2,C80,I2,6,LP50,P66,T4

	*	FILE NAME 'TEXT.SRC;3'
	S	SELECT BASE 2 PRINTER
	C	80 CHARACTERS PER LINE
	I	INSERT TABS AT POSITIONS 2 AND 6
	LP	PRINT 50 LINES PER PAGE
	P	SPECIFIES A 66 LINE FORM
	T	PRINT 4 BLANK LINES AT THE TOP OF FORM

	>  *,C96,I,M2,SMX,LM8,LS2,[<>,ABC,6]

	*	FILE NAME SAME AS PREVIOUS
	S	SELECT MX-80 PRINTER
	I	REMOVE TAB INSERTS
	M	PRINT 2 COLUMNS PER PAGE
	LM	8 CHARACTER LEFT MARGIN
	LS	DOUBLE SPACING
	[]	PRINT ONLY IF POSITION 6 DOES NOT EQUAL 'ABC'
		ALL OTHER PARAMETERS WILL REMAIN UNCHANGED.


REMOVAL OF PARAMETERS:

	TO TURN OFF, OR REMOVE CERTAIN PARAMETERS, THE PARA-
METER COMMAND FOLLOWED BY A ZERO (0) SHOULD BE ENTERED ON THE
COMMAND LINE IF ADDITIONAL FILES ARE TO BE PRINTED.  PARAMETERS
WILL NOT CHANGE FROM FILE TO FILE, AND REMAIN IN EFFECT UNTIL
CHANGED, EXCEPT FOR THE '[' (MATCH STRING) COMMAND, AS
DESCRIBED ABOVE.



END OF PAGE:

	A FORM FEED (ASCII 12) IS ISSUED TO THE PRINTER AT THE
END OF A PAGE OF TEXT.  IN ADDITION, A LINE OF '=' IS PRINTED
ON THE SCREEN TO DENOTE AN END OF PAGE.


END OF FILE:

	A FORM FEED, AS DESCRIBED ABOVE, IS SENT TO THE PRINTER
IF THE END OF PAGE WAS NOT REACHED.  IF THE END OF PAGE AND END
OF FILE COINCIDE, THEN A FORM FEED IS NOT ISSUED.

	THE PROGRAM WILL THEN RETURN TO THE COMMAND LINE ENTRY
FOR ADDITIONAL FILES AND PARAMETERS TO BE ENTERED.


THE DRIVER PROGRAM WILL SUPPORT IMBEDDED ESCAPE CODE SEQUENCES
WITHIN THE TEXT ITSELF.  AN EXAMPLE OF AN ESCAPE SEQUENCE, FOR
THE MX80, COULD TAKE THE FOLLOWING FORM:


	TEXT		PRINTER		EXPLANATION

	27,00,14,27	14		DOUBLE WIDTH ON
	27,00,15,27	15		CONDENSED SIZE ON
	27,00,18,27	18		CONDENSED SIZE OFF
	27,00,20,27	20		DOUBLE WIDTH OFF
	27,48,27	27,48		1/8  INCH SPACING
	27,49,27	27,49		7/72 INCH SPACING
	27,50,27	27,50		1/6  INCH SPACING
	27,65,NN,27	27,65,N		N/72 INCH SPACING
	27,69,27	27,69		EMPHASIZE ON
	27,70,27	27,70		EMPHASIZE OFF
	27,71,27	27,71		DOUBLE PRINT ON
	27,72,27	27,72		DOUBLE PRINT OFF


	THESE CODES ARE NOT (REPEAT NOT) PART OF THE COMMAND
LINE INPUT, BUT MUST BE SET UP AS EMBEDDED CODES WITHIN THE
TEXT FILE ITSELF.  THE PROPER METHOD TO DO THIS IS THE PRECEED
THE CODE WITH AN "ESCAPE" CODE, FOLLOWED BY A COMMA, THE DATA,
COMMA, DATA, (ETC), AND THEN TERMINATE WITH EITHER A CR/LF OR
ANOTHER "ESCAPE" CODE.  IN ADDITION, IF THE FIRST DATA ENTRY
FOLLOWING THE LEADING "ESCAPE" HAS A VALUE OF ZERO, THEN THE
ESCAPE ITSELF WILL NOT BE SENT TO THE PRINTER.  IF IT IS NON-
ZERO, THE LEADING ESCAPE CODE (ASCII 27) WILL BE SENT.


	SOME SAMPLE ENTRIES:

	NOTE:  "*" IS USED BELOW TO INDICATE AN ESCAPE
	CHARACTER FOR ILLUSTRATION PURPOSES ONLY.


*,0,14,*THIS IS A TEST LINE FOR DOUBLE WIDTH,
AND THIS IS A NORMAL LINE

*,48,*THIS WOULD SET 1/8 INCH SPACING.

*,65,32,*,*,50,*WILL SET THE EQUIVALENT TO A 27,65,32,27,50
COMMAND AND SO ON.


THESE CODES DO NOT NEED TO BE AT THE BEGINNING OF THE LINE,
BUT MAY BE PLACED *,69,*ANYWHERE DESIRED.*,70,*



	NOTE:	THE "ESCAPE" CODE IS NORMALLY A NON-PRINTABLE
	CHARACTER.  HOWEVER, THE MODIFIED SCREEN EDITOR IS
	CAPABLE OF INSERTING ESCAPE CODES AS WELL AS COLOR IF
	DESIRED.  THE ORIGINAL SCREEN EDITOR AVAILABLE FROM
	INTELLIGENT SYSTEMS CORP. DOES NOT SUPPORT THE ESCAPE
	CODE, BUT THE SCREEN EDITOR AVAILABLE FROM HELMS
	SOFTWARE AND ITS DISTRIBUTORS DOES.



BASE 2	DEFAULT CONDITIONS:


	* >	'.SRC' FILE, DEFAULT DRIVE
	A >	AND (ALSO SET IF <2 MATCH STRINGS)
	C >	80
	D >	NONE
	I >	NONE
	LM>	NONE
	LP>	50
	LS>	1
	M >	1
	P >	66
	S >	OFF
	T >	4
	[ >	OFF


MX-80	DEFAULT CONDITIONS:


	* >	'.SRC' FILE, DEFAULT DRIVE
	A >	AND (ALSO SET IF <2 MATCH STRINGS)
	C >	132
	D >	NONE
	I >	NONE
	LM>	NONE
	LP>	50
	LS>	1
	M >	1
	P >	66
	S >	OFF
	T >	4
	[ >	OFF