home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / hppcmode.arc / LPRINT.DOC < prev    next >
Encoding:
Text File  |  1979-12-31  |  7.0 KB  |  180 lines
  1.        LPRINT UTILITY PROGRAM -- WRITTEN 6/84, REVISED 1/85 
  2.  
  3.  
  4.  
  5. Program name:        LPRINT.EXE
  6. Program title:        HP 150 / HP 3000 Line Printer Program
  7. Program status:        Contributed / free software, unsupported
  8.  
  9. Development system:      HP 150 A
  10. Operating system:    Rev A op sys
  11. Base language:        Microsoft compiled BASIC
  12. Supporing languages:    Assembler
  13. Hardware:        For use on an HP 150 connected to an HP 3000
  14.  
  15.  
  16.                                                                
  17.  
  18.            ============== WARNING ==========
  19.  
  20. BRIAN RAINIE MAKES NO EXPRESS OR IMPLIED WARRANTY OF ANY KIND WITH
  21. REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO THE IMPLIED
  22. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  23. BRIAN RAINIE SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL,
  24. INCIDENTAL OR CONSEQUENTIAL DAMAGES, WHETHER BASED ON CONTRACT,    
  25. TORT OR ANY OTHER LEGAL THEORY.                                    
  26.  
  27.  
  28.  
  29.  
  30. SOFTWARE DESCRIPTION:
  31.  
  32. This program accepts path names (with wild cards) from the user and
  33. sends the files to an HP3000 to be printed on a LASER printer.  It
  34. assumes the user has already logged on and COM1 will allow proper
  35. access to the system.  Numerous options exist for specifying anything
  36. from the environment type to an alternate device (useful if you do 
  37. not have a laser printer).
  38.  
  39. The program and attached documentation is classified as free software
  40. and may be copied and distributed as such.  As stated above, no support
  41. is implied!  If you find LPRINT useful, please send a donation for the
  42. amount you feel the software is worth to the author listed below.  Your
  43. appreciation will help recover the development costs incurred.  In
  44. recognition of your thoughtfulness, you will be put on a mailing list
  45. and notified when new versions are released.  New copies will not be
  46. sent to you directly, but the channels of distribution will be noted.
  47.  
  48.  
  49.  
  50. AUTHOR:
  51.         Brian Rainie
  52.         513 Fern Ridge Ct.
  53.         Sunnyvale, CA
  54.                94087
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. PROGRAM DOCUMENTATION:
  62.  
  63. User input is simply path name specifications one at a time.  Replying
  64. to the prompt with nothing but a carriage return initiates transfer.
  65. Options for this program are available as strap settings and are
  66. described below:
  67.  
  68.              Strap description                    Default spec.
  69.  
  70.      ENV=[<alternate environment file>]         ENV=<ELITE or LP>
  71.      DEV=<alternate output device name>         DEV=PP
  72.      <Record length of 80 or 128>               80
  73.      <Pages selection of 1, 2, or 4>            1
  74.      <Page length of 60, 66, or 60+6>           60
  75.      HEAD=<Heading selection of 0 to 9>         0 (No heading)
  76.      PAUSE (pause before termination)           Not enabled
  77.  
  78. The default ENV specification is determined by the record length
  79. (ELITE for 80, LP for 128) and number of logical pages per physical
  80. page (eg:  80 col / 4 pages will use ELITE4).  If you use your own
  81. ENV specification, make sure that pages and page length match this
  82. environment!  (NOTE:  The default environment names are fully
  83. qualified with the group.account of HPENV.SYS)
  84.  
  85. The page length designates how many lines per page.  For the default
  86. environment, 60 or 60+6 must be used.  The 60+6 assumes that the 
  87. source file format is 66 lines per page where the last 6 lines are
  88. blank.  Specifying 60+6 causes the program to ignore the last 6 lines
  89. of each page so it can be printed on a 60 line page.
  90.  
  91. This program allows standard command line format.  Rather than
  92. responding to the prompts, all information can be passed through
  93. the command line.  The following example will print all .LST files
  94. starting with the letter R on drive A along with all .DOC files
  95. on drive C.  The output will be 80 cols wide (default), 4 pages
  96. per physical page, converting 66 lines per page to 60 lines per
  97. page:
  98.     LPRINT A:R*.LST,C:*.DOC/4/60+6;
  99.  
  100. The semicolon at the end shows end-of-input, telling the program
  101. not to ask for any additional path names.  The command line method
  102. is most useful when used to invoke LPRINT through batch files.
  103.  
  104. The heading selection specifies whether or not the name of the
  105. file should appear in line 1.  If 1 is selected, the name will
  106. overwrite the far right section of the first line.  For values of
  107. 2 and higher, the name will appear left justified on its own line
  108. followed by <heading selection - 2> blank lines.  The first line
  109. of text will follow this.
  110.  
  111. If you must include one or more commas when specifying a response
  112. (eg: dev=pp,12), you can enclose the entire response within soft
  113. braces so the comma will not be taken as a command line separator
  114. (ex: {myfile.lst/dev=pp,12},nextfile.lst,...).
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121. HIDDEN FEATURES:
  122.  
  123. As with most software products, there are several operations which
  124. are hidden from the user.  This is seldom a case of hidden function-
  125. altiy, but usually just a nasty habit of forgetting to tell the
  126. user that the software performs friendly functions which may not
  127. be readily apparent.  The following is a list of features included
  128. within the software to make life easier:
  129.  
  130. Echo-Off to Increase Speed
  131. An escape ; is sent to the HP3000 prior to transmission to eliminate
  132. the need to read the information as it is echoed back.  If something
  133. goes wrong, you may find the you will have to send the HP3000 an
  134. escape : to turn it back on (seldom necessary).
  135.  
  136. Pound-sign or Colon
  137. Yes, it will recognize a pound-sign as a system prompt if you are 
  138. DSed over to another system.
  139.  
  140. Special Characters
  141. The FF (form feed) character will generate enough lines to put the
  142. paper at top-of-form.  Imbedded carriage returns and line feeds are
  143. handled properly.  TAB is converted to spaces, matching the MS-DOS
  144. specification for TAB.  The eighth bit of each character is reset
  145. to zero (word processing documents will convert properly).
  146.  
  147. Control-C 
  148. The control-C break feature is always active and will exit you
  149. from the software in a nice clean fashion.
  150.  
  151. TELLS and WARNS
  152. Messages received from the HP3000 during transmission will cause
  153. the following:
  154.     1)  Transmission is suspended while message is displayed
  155.     2)  LPRINT waits for you to hit return
  156.     3)  Message is removed and program continues
  157.  
  158.  
  159.  
  160. BAT FILES I HAVE USED:
  161.  
  162. When developing assembly language subroutines, I include a PAGE 60
  163. command in the source and print the listing file by calling the
  164. following bat file (it allows up to 8 file specifications):
  165.  
  166.     LPRINT {/2/132/DEV=PP,12},%1,%2,%3,%4,%5,%6,%7,%8;
  167.  
  168. If you are not familiar with BAT files, give it a try anyway.  Place
  169. the line shown above into a new file called LPRINTA.BAT.  When you
  170. are ready to print the file, enter the LPRINTA command followed by
  171. the name of the file to be printed.  (NOTE:  The BAT file should
  172. reside on the same disc as the LPRINT program.
  173.  
  174. I have found it quite beneficial to print BASIC crossreference listings
  175. of each program I develop for easy reference.  By directing the BASIC
  176. Crossreference Utility to print to a disc file with PAGE EJECTS (under
  177. MAIN SETTINGS), the following bat file command works well:
  178.  
  179.     LPRINT {/4/60+6/DEV=PP,12},%1,%2,%3,%4,%5,%6,%7,%8;
  180.