Listing of file='DRIVI.SRC;01' on disk='vmedia/driver_lister-sector.ccvf'
-
PRINTER DRIVER PROGRAM V5.1
ENTERING THE COMMAND LINE
THE COMMAND LINE PROMPT IS A GREEN '>' THAT FOLLOWS THE
INTRODUCTION 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 BY THE USER. 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 THIS WILL RESET THE CHARACTER COUNT AND
CAUSE A RETURN/LINE FEED TO BE SENT. A MINIMUM OF
16 CHARACTERS PER LINE IS REQUIRED, WITH A MAXIMUM
OF 132 BEING ALLOWED.
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
CHARACTERS 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
CHARACTER FOR THAT POSITION BEING SENT. ALSO, YOU
DO NOT NEED TO ADJUST THE CHARACTER COUNT IN ORDER
TO DETERMINE WHERE THE TABS SHOULD BE ENTERED AS
THIS IS AUTOMATICALLY 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, AND BECOMES PART OF THE COMMAND
STRING SENT TO PRESET THE PRINTER BUFFERS. THIS
NUMBER MUST EXCEED THE TOP OF FORM LINE COUNT PLUS
THE NUMBER OF LINES TO BE PRINTED (P > LP + T).
E > ENTER TEXT FOR PRINTER THAT IS TO PRECEED THE
PRINTING OF THE FILE. UP TO 2048 BYTES (32 LINES
OF 64 CHARACTERS EACH) MAY BE ENTERED FOR THIS
PURPOSE. THIS MAY BE USED TO SET UP COLUMN HEADER
TITLES, GENERAL INFORMATION ABOUT THE FILE, NOTES,
OR OTHER SIMILIAR INFORMATION. THE ACTUAL TEXT
IS NOT ENTERED UNTIL THE ENTIRE COMMAND LINE IS
ENTERED. AT THAT POINT, A PROMPTING MESSAGE WILL
APPEAR INFORMING THE USER TO ENTER THE TEXT. THE
SYSTEM WILL APPEAR TO ACT AS A DUMB TERMINAL AS
THE TEXT IS ENTERED. A FORM FEED MAY BE FORCED
INTO THE TEXT BY USING THE '^' SYMBOL, AND TO
SIGNIFY COMPLETION OF TEXT ENTRY, THE ESCAPE KEY
IS UTILIZED. DURING TEXT ENTRY, THE '<-' MAY BE
USED TO DELETE PREVIOUSLY ENTERED CHARACTERS FOR
A PARTICULIAR LINE. ONCE THE 'RETURN' IS HIT,
THEN THAT LINE MAY NO LONGER BE CHANGED. TO START
AGAIN, FROM THE BEGINNING, HIT THE 'HOME' KEY.
S > SEND TEXT TO PRINTER. IF TEXT HAS BEEN PREVIOUSLY
ENTERED, OR AN 'E' COMMAND PRECEEDS THIS COMMAND,
THEN THE TEXT WILL BE SENT TO THE PRINTER PRIOR TO
THE FILE BEING PRINTED. IF THE TEXT BUFFER IS EMPTY,
THEN TEXT WILL NOT BE SENT, NOR WILL A COMMAND LINE
ERROR MESSAGE BE ISSUED.
THIS COMMAND MUST BE ENTERED EACH TIME THE TEXT
IS TO BE PRINTED FOR A FILE, BUT RE-ENTERING THE
TEXT ITSELF (COMMAND 'E') IS NOT NECESSARY IF
THERE ARE NO CHANGES TO BE MADE.
-
NOTE: THE FOLLOWING COMMAND PARAMETERS WILL BE
IN EFFECT WHEN THE TEXT IS SENT TO THE PRINTER:
C CHARS/LINE
LM LEFT MARGIN
LP LINES/PAGE
LS LINE SPACING
M MULTIPLE COLUMNS
P PAGE LENGTH
T TOP OF FORM LINES
T > TOP OF FORM LINES. THIS WILL ALLOW THE USER 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 THE USER TO
ENTER UP TO 16 CHARACTERS OF TEXT TO BE MATCHED
WITH EACH RECORD, AND THE DEFAULT PRINT CONDITIONS
AFTER COMPARISON. 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
COMPARISONS. IF A RECORD IS PHYSICALLY SHORTER THAN
THE LENGTH OF THE MATCHING STRING PLUS THE CHARACTER
POSITION 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, THE
USER HAS 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. THE 'AND' CONDITION WILL BE
SET IF ONLY ONE MATCH CONDITION IS ENTERED.
-
* > 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 ALLOWS THE USER 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 ADDRESS 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 OTHERWISE TYPE IN
DIRECTLY.
IT IS RECOMMENDED THAT THE 'E' AND 'S' OPTIONS NOT
BE SPECIFIED IN THE PARAMETER FILE, BUT LEFT FOR
USER OPTION ON THE COMMAND LINE ITSELF.
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,E,S,C64
#PAD ,E,S,C80,LM0
EVEN THOUGH CHARS/LINE AND LEFT MARGIN MAY ALREADY
BE SPECIFIED IN THE PARAMETER FILE, THE USER ENTRY
WILL OVERRIDE ANY PARAMETER IN THE FILE.
TWO SAMPLE ENTRIES OF THE PARAMETER FILE:
PERS,*PERS,C64,P66,LM0,LP50,LS2
PERS,D26,3,I16,18,20,T4
PAD ,*PERS,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,C80,E,I2,6,LP50,P66,S,T4
* FILE NAME 'TEXT.SRC;3'
C 80 CHARACTERS PER LINE
E ENTER TEXT FOR THE PRINTER
I INSERT TABS AT POSITIONS 2 AND 6
LP PRINT 50 LINES PER PAGE
P SPECIFIES A 66 LINE FORM
S PRINT THE TEXT
T PRINT 4 BLANK LINES AT THE TOP OF FORM
> *,C96,I,M2,S,LM8,LS2,[<>,ABC,6]
* FILE NAME SAME AS PREVIOUS
I REMOVE TAB INSERTS
M PRINT 2 COLUMNS PER PAGE
S PRINT PREVIOUSLY ENTERED TEXT
LM 8 CHARACTER LEFT MARGIN
LS DOUBLE SPACING
[] PRINT ONLY IF POSITION 6 DOES NOT EQUAL 'ABC'
ALL OTHER PARAMETERS WILL REMAIN UNCHANGED.
-
DEFAULT CONDITIONS:
* > '.SRC' FILE, DEFAULT DRIVE
A > AND (ALSO SET IF <2 MATCH STRINGS)
C > 80
D > NONE
E > NONE
I > NONE
LM> NONE
LP> 50
LS> 1
M > 1
P > 66
S > OFF
T > 4
[ > OFF
REMOVAL OF PARAMETERS:
TO TURN OFF, OR REMOVE CERTAIN PARAMETERS, THE
PARAMETER 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 'S' (SEND TEXT),
AND '[' (MATCH STRING) COMMANDS, 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.