;
                                 PRTASM.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
PRTASM.CIM     5k (35)   6078  1.9        Gene Pizzetta 7/90       Z3COM16
PRTASM.COM     4k (32)   9210  2.0        Gene Pizzetta 11/90      Z3COM16

  1- Usage  2- Expanding Tabs  3- Configuration  4- Notes                     

   PRTASM is  a ZCPR3 utility  that prints  assembly  source  code  and  other
program listings  on the CP/M LST device.   It  prints  the  filename and page 
number in the upper  right  corner  of  each page.   If  a real-time  clock is
available under ZDOS or DateStamper, the file stamp modification date and time
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.  It is configured for Epson printers, but the config-
uration can be easily changed.  Runs under ZCPR 3.x only.  Vs 1.0 (9/17/87) by
Gene Pizzetta.
:1
 Usage - 1/2   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, but will not abort the program.  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 in the list and continue printing.

   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 ZCPR3 environment descriptor.  Make sure these are
set properly.   It is particularly desirable that PRTASM use formfeeds so that
if a line or two overflows the margin, the header will not get out of sync.
 Usage - 2/2 


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

   Tabs are not expanded by PRTASM.   It is  assumed that most modern printers 
are IBM-compatible and thus handle tabs correctly.  If your 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 the author know.
:3
 Configuration 

   PRTASM  can  be  easily  configured   using   ZCNFG  and  the  accompanying
PRTASMnn.CFG file.   The name of the CFG file should  not be changed,  so that
ZCNFG can always find it, even if you rename PRTASM.

   A single configuration option allows you choose whether the time printed in
the page header is in civilian or military format.  The rest of the configura-
tion menus concern printer escape  strings  required by PRTASM for putting the
printer in elite pitch  (12 characters per inch);  for  setting  the printer's
left margin to column 8;  for resetting the  printer to its default mode;  for
putting the printer into boldface,  emphasized,  or double-strike for printing
the header; and for cancelling the printer's boldface mode.

   For full details of the configuration options see the ZCNFG help screens.
:4
 PRTASM Notes - 1/4 

   a. Version 2.0 updates (11/24/90, Gene Pizzetta):
      - Added a larger file buffer for speedup. 
      - Incorporated several code improvements,  size cut by 3 sectors to less
        that 4K, and speed increased by about 20 percent.
      - No longer supports type-3 assembly.  
      - Added ZCNFG configuration.
      - Converted to Zilog mnemonics.

   b. Version 1.9 updates (7/18/90, 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,  1) failure to set the correct DMA
        address if the military time flag was false;  2) if a  key was pressed
        while the header was  being sent  to  the  printer,  PRTASM  would not
        detect it.
 PRTASM Notes - 2/4 

   c. Version 1.8 updates (7/11/90, Gene Pizzetta):
      - Modified to accept a list of files.  
      - file date now  used in the header,  if it has  a  modification  (first
        choice) or create stamp; otherwise, the current date is used.
      - 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.
 PRTASM Notes - 3/4 

   d. Version 1.7 updates (7/16/90, J. 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.

   e. Version 1.6 updates (8/7/89, Gene Pizzetta):
      - minor change in header format

   f. Version 1.5 updates (7/26/89, Gene Pizzetta):
      - now prints date in header line if a  real-time clock is  working under
        DateStamper or ZDOS (must be linked with version 4 SYSLIB's)

   g. Version 1.4 updates (6/10/89, Gene Pizzetta):
      - slight change in screen display
 PRTASM Notes - 4/4 

   h. Version 1.3 updates (3/11/89, Gene Pizzetta):
      - adds DU filespec and ZCPR3 TCAP support
      - incorporates SYSLIB routines
      - now preserves the CP and no longer warm boots

   i. Version 1.2 updates (10/13/88, Gene Pizzetta):
      - eliminates CP/M Plus dependencies.  
      - adds printer cleanup on user abort.   
      - 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.

   j. Version 1.1 updates (9/20/87, Gene Pizzetta):
      - added page numbering and boldface filename in header

   k. PRTASM was developed using the SLRMAC assembler and SLRNK+ linker:
 	slrmac prtasm/m
 	slrnkp prtasm/n,/v,/a:100,/j,prtasm,zslib/s,dslibs/s,vlibs/s,
 		z3libs/s,syslibs/s,/e
