PRTASM
                           Version 1.9

                          Gene Pizzetta
                          July 18, 1990


PRTASM is a ZCPR3 utility designed to print assembly source code 
and other program listings on the CP/M LST device.  It is also 
handy for quick printing of documentation.  PRTASM puts the 
filename and page number in the upper right corner of each page.  
The file stamp modification date and time, if available, is 
printed to the left of the filename.  If no modification date is 
available, PRTASM tries for a creation date.  If neither date 
stamp is available, the current date and time are used instead.  
If no clock is available, no date and time are printed at all.  
As distributed, it is configured for Epson printers, but the 
configuration can be easily changed.

USAGE:

     PRTASM {dir:}<fn.ft> {{dir:}<fn.ft} {...}

At least one input filename is required.  Names in the file list 
may be separated by any number of spaces and commas.  Ambiguous 
filenames are not accepted.  If no DU or DIR specification is 
given, the current drive/user is assumed.

Once printing has begun, pressing any key will abort printing of 
the current file.  If the key is ^C, PRTASM will return to the 
operating system; otherwise, it will skip to the next file.

If a file cannot be found, or if an ambiguous file spec is 
encountered, PRTASM will display an error message and then 
continue with the next file in the file list.  It will, however, 
set the program error flag on exit.

The number of lines on a printed page and whether the printer can 
handle formfeeds is taken from the environment descriptor.  Make 
sure these are set properly.  It is particularly desirable that 
PRTASM use formfeeds so that a line or two that overflows the 
margin will not get the header out of sync.

The distributed version is configured for Epson printers and 
compatibles, but is easily modified.  PRTASM expects, however, 
that your printer is capable of printing a 96-character line in 
elite pitch.

MODIFICATIONS:  In the first sector of the COM file, immediately 
following the label MTIME, is a byte that determines the format 
of the time string printed in the header.  If the byte is zero, 
12-hour "civilian" time format ( 3:00p) is used.  If the byte is 
non-zero, 24-hour "military" time format (15:00) is used.

Also in the first sector are labels for the printer codes, which 
can be changed to work with any printer.  The first byte after 
each label is the number of characters in the string, followed 
immediately by the string itself, which may be up to six bytes.

     ELISTR    The escape code to put the printer in elite
               pitch (12 characters per inch).

     MARSTR    The escape code to set the printer's left margin
               to column 8.

     RSTSTR    The escape code to reset the printer (this
               program cleans up when it's through).

     BOLDON    The escape code to put the printer into boldface,
               emphasized, or double-strike for printing the
               header.

     BOLDOF    The escape code to cancel the printer's boldface
               mode.

EXPANDING TABS:  Tabs are not expanded by PRTASM.  I have assumed 
that most modern printers are IBM-compatible and thus handle tabs 
correctly.  If you printer needs tabs sent as the corresponding 
number of spaces, run your file through a filter program before 
printing it with PRTASM.  If you would prefer a future version to 
expand tabs, please let me know.

          Gene Pizzetta
          481 Revere St.
          Revere, MA 02151

          Voice:  (617) 284-0891
          Newton Centre Z-Node:  (617) 965-7259
          GEnie:  E.PIZZETTA

HISTORY:

Version 1.9 -- July 18, 1990 -- Gene Pizzetta
     Now prints source of date and time: "Modified", "Created",
     or just "Printed" if no file stamp is available.  A few bugs
     have also been squashed, including a rather serious failure
     to set the correct DMA address if the military time flag was
     false, discovered by Howard Goldstein.  Howard also found
     that if a a key was pressed while the header was being sent
     to the printer, PRTASM would not detect it.

Version 1.8 -- July 11, 1990 -- Gene Pizzetta
     I found that I was frequently calling PRTASM several times
     on a command line to print several files, so I've modified
     it to accept a list of files.  In addition, the file date is
     usually more important than the current date, so now the
     file date is used in the header, if it has a modification
     (first choice) or create stamp; otherwise, the current date
     is used.  J. I. Mortensen made some useful modifications, so
     I added them to this version, which I have been working on
     for a while.  But we're back to Intel mnemonics.  If any
     files in the file list are not found, PRTASM skips to the
     next file after printing an error message.  Printing can be
     aborted at any time with ^C.  Any other key will abort the
     file currently being printed, and move to the next in the
     list.  A two-byte page counter is now used so it will number
     past 255.  Formfeeds in the file are trapped and replaced
     with a single carriage return/linefeed.  A printer capable
     of 96 columns in elite pitch is assumed.  Page length and
     formfeed ability are obtained from the environment.  A
     configuration byte allows selection of civil or military
     time.  Patching for non-Epson escape codes no longer
     requires re-assembly.  Added a type-3 header.  Program error
     flag is set if any file in the file list cannot be found or
     if a file specification is ambiguous.

Version 1.7 -- June 16, 1990 -- J. I. Mortensen
     Translated to Zilog mnemonics.  Time of day added to header.
     ZSLIB routines added for printing time and date.  Added LST
     status check and ZCPR3 check.  Masks high bits for WordStar
     files.

Version 1.6 -- August 7, 1989 -- Gene Pizzetta
     Minor change in header format.

Version 1.5 -- July 26, 1989 -- Gene Pizzetta
     Now prints date in header line if a real time clock is
     working under DateStamper or ZDOS.  Must be linked using
     the version 4 libraries.

Version 1.4 -- June 10, 1989 -- Gene Pizzetta
     Slightly changed screen display.

Version 1.3 -- March 11, 1989 -- Gene Pizzetta
     Rewritten again to add DU filespec and ZCPR3 TCAP support,
     and to incorporate SYSLIB routines.  It now preserves the CP
     and no longer warm boots.  PRTASM is now ZCPR3 specific.

Version 1.2 -- October 13, 1988 -- Gene Pizzetta
     Quickly rewritten to eliminate CP/M Plus dependencies.  (I
     got an SB180.)  Also added printer clean-up on user abort.
     This version still sends a failure code to the BDOS on
     error, to support CP/M Plus conditional submits.  CP/M 2.2
     doesn't recognize it, but it does no harm.

Version 1.1 -- September 20, 1987 -- Gene Pizzetta
     Added page numbering and boldface filename in header.

Version 1.0 -- September 17, 1987 -- Gene Pizzetta
     First release configured for Epson and compatible printers.
     For CP/M Plus only.