home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / printer / tagprint.arc / TAGPRINT.DOC < prev    next >
Text File  |  1987-01-31  |  23KB  |  600 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.              +----------------------------------------------------+
  16.              |                   TAGPRINT                         |
  17.              |                 Version 1.20                       |
  18.              +----------------------------------------------------+
  19.              |                                                    |
  20.              |  (C)Copyright Ashcroft Group Inc. 1985, 1986, 1987 |
  21.              |                ALL RIGHTS RESERVED                 |
  22.              +----------------------------------------------------+
  23.              |      This version of the documentation, software   |
  24.              | and copyright supersedes all previous versions of  |
  25.              | TAGPRINT.                                          |
  26.              +----------------------------------------------------+
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                January 15, 1987
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                               ASHCROFT GROUP INC.
  39.                               2401 Longest Avenue
  40.                               Louisville, Ky 40204
  41.  
  42.                              CompuServe [75166,1547]
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                              TABLE OF CONTENTS
  50.  
  51.  
  52.  
  53.  
  54.                    Copyright Notice..................... I
  55.  
  56.                    Introduction......................... II
  57.  
  58.                    What you need........................ III
  59.  
  60.                    Configuring for your System ......... IV
  61.  
  62.                    Loading TagPrint Automatically....... V
  63.  
  64.                    Operation............................ VI
  65.  
  66.                    Building a Printer Command File...... VII
  67.  
  68.                    Order Form........................... VIII
  69.  
  70.  
  71.       I.                   COPYRIGHT NOTICE
  72.  
  73.  
  74.       This user-supported software product is copyrighted and all rights
  75.       reserved by the Ashcroft Group Inc..  The use of this software is
  76.       expressly prohibited, except as authorized herein.  Users of this
  77.       software are granted a limited license for trial use on a private
  78.       non-commercial basis.
  79.  
  80.       You may not:
  81.  
  82.       1) Translate, reverse engineer, decompile or disassemble this
  83.          software.
  84.       2) Grant licenses, leases or other rights in this software to
  85.          others.
  86.       3) Distribute this software for any consideration or fees.
  87.       4) Distribute this software in any modified form.
  88.  
  89.       This software is a demonstration version which we encourage you to
  90.       share with others.  This demonstration version is identical in all
  91.       respects to the commercial version, except that it contains an
  92.       advertising display screen.  The intent of this advertising screen
  93.       is to encourage users to purchase the product.  An order form is
  94.       provided at the end of this user's manual.
  95.  
  96.       The Ashcroft Group Inc. makes no warranty of any kind, whether
  97.       express or implied, regarding the program and disclaim any warranty
  98.       of merchantability or fitness for a particular purpose.  The entire
  99.       risk as to the results and performance of the program is assumed by
  100.       the user.  The Ashcroft Group Inc. will not be liable for any
  101.       damages arising out of use of the program including incidental or
  102.       consequential damages.
  103.  
  104.       II.                      INTRODUCTION
  105.  
  106.  
  107.       Congratulations on your choice of TagPrint. We hope you will find
  108.       TagPrint to be one of your most useful utilities.  We encourage you
  109.       to read this manual which contains important information to help
  110.       you get started quickly on your way to using the power provided by
  111.       TagPrint.  The manual will instruct you on what you need to start
  112.       and how to configure and operate TagPrint.  Once you have
  113.       configured TagPrint for your system, you can choose to have it
  114.       automatically load upon initial power-up or reboot.  Then you can
  115.       enter TagPrint at any time by simply pressing Shift PrtSc
  116.       (print-screen).  TagPrint can even be called up from within another
  117.       program.  TagPrint's friendly pop-up menu allows you to easily
  118.       control the many special features of your printer.
  119.  
  120.       TagPrint will support virtually any printer.  As distributed, TagPrint
  121.       is set to work with an Epson FX printer.  Regardless of what
  122.       printer you have, try this example:
  123.  
  124.       1)  To activate TagPrint, type "TAGPRINT /X" and press the ENTER
  125.           key.
  126.  
  127.       2)  Press Shift PrtSc (print- screen).  An advertising screen will
  128.           be displayed followed by a print selection screen.
  129.  
  130.       3)  Press PgDn.  "Elite, 12 CPI, Single Strike"  should now appear on
  131.           the highlighted line.  Select this printing mode by pressing the
  132.           RETURN key.  The printer will be sent the proper command codes to
  133.           set this mode of operation.
  134.  
  135.       4)  Press the ESC key to exit TagPrint.
  136.  
  137.       5)  Now if you have an Epson FX printer, anything you print will be
  138.           in Elite, 12 characters per inch, Single Strike until the
  139.           printer is reset.
  140.  
  141.       NOTE: If your printer is not an Epson FX, you should reset it at
  142.             this time.
  143.  
  144.  
  145.  
  146.       III.                   WHAT YOU NEED
  147.  
  148.  
  149.       To run TagPrint (ie TAGPRINT.COM) you will need an IBM PC,
  150.       XT, AT, or compatible machine; PC or MS-DOS 2.0 or higher; and a
  151.       printer.
  152.  
  153.       Useful, but not absolutely necessary, would be a command file
  154.       (ie ????????.TAG) for your particular printer.  A TAG file contains
  155.       printer command codes and descriptions which may be installed
  156.       during the customization process.  The following is a list of TAG
  157.       files which have been developed by the authors and placed on
  158.       CompuServe and numerous computer bulletin boards for the indicated
  159.       printers.
  160.  
  161.                PRINTER                        FILE NAME
  162.  
  163.                Epson LX                       EPSONLX.TAG
  164.                Epson FX                       EPSONFX.TAG
  165.                Epson MX                       EPSONMX.TAG
  166.                Epson JX                       EPSONJX.TAG
  167.                Epson RX                       EPSONRX.TAG
  168.                Epson LQ                       EPSONLQ.TAG
  169.                Okidata Microline 84           OKI84.TAG
  170.                Okidata Microline 92/192       OKI92.TAG
  171.                Okidata Microline 93/193       OKI93.TAG
  172.                IBM ProPrinter                 IBMPRO.TAG
  173.                IBM Matrix Printer             IBMMATRI.TAG
  174.                IBM Graphics Printer           IBMGP.TAG
  175.                NEC P2/32                      NECP232.TAG
  176.                TOSHIBA 1351                   TOSHI351.TAG
  177.  
  178.  
  179.       The program can support additional printers by utilizing the
  180.       built-in Printer Command Editor.  This is the exact method used by
  181.       the authors to create the above TAG files.
  182.  
  183.       IV.             CONFIGURING FOR YOUR SYSTEM
  184.  
  185.       Configuration consists of setting your printer port (default
  186.       LPT1), indicating your audio bell preference (default ON), and
  187.       customizing TagPrint for your printer.  Until you become familiar
  188.       with the operation of TagPrint, we strongly recommend leaving the
  189.       audio bell signal on.  If you are using printer port 2 (LPT2), it
  190.       can be easily selected from the Main Customization Screen.
  191.  
  192.       If you have an EPSON FX printer attached to LPT1, you can skip this
  193.       section - the TagPrint program is already set to work with that
  194.       printer.  Otherwise, you will need to customize TagPrint for your
  195.       particular printer.
  196.  
  197.       There are two methods of customization:
  198.  
  199.         1) Loading an existing TAG file such as those provided by
  200.            the authors, or
  201.  
  202.         2) Developing a 'special' TAG file for your printer.
  203.  
  204.       In order to perform either customization process, a thorough
  205.       understanding of the Customization Screen is required.
  206.  
  207.       The Main Customization Screen is normally displayed after issuing
  208.       the command 'TAGPRINT' at the DOS system prompt.
  209.  
  210.       NOTE: This screen cannot be accessed after TagPrint is resident.
  211.  
  212.       All available options are displayed on the Main Customization
  213.       Screen and are explained below:
  214.  
  215.         F1 - Pop-up screen is displayed which lists printers for which
  216.              printer command files are available from the authors.
  217.  
  218.         F2 - User's manual is printed.
  219.  
  220.         F3 - Use the alternate printer port - LPT1  or LPT2.
  221.              NOTE: Use F8 to make the current selection permanent.
  222.  
  223.         F4 - Toggle Audio Bell.  Bell signals in any printer command code
  224.              will be sent or not sent to the printer in accordance with
  225.              option currently selected.  Note: Use F8 to make the current
  226.              selection permanent.
  227.  
  228.         F5 - Use to load program with any printer command file
  229.              (ie. TAG file) in current default directory.
  230.  
  231.         F6 - Editing Printer Commands. (Refer to section VII).
  232.  
  233.         F7 - Use to save current Printer Commands to a file.
  234.  
  235.         F8 - Save TagPrint as currently configured.
  236.  
  237.         F9 - Exit and make resident.
  238.  
  239.        ESC - Exit and return to DOS (not resident).
  240.  
  241.  
  242.       Here are two examples of customization:
  243.  
  244.       Example 1 - Loading an existing TAG file
  245.  
  246.       1)  To activate TagPrint, type 'TAGPRINT' and press the ENTER key.
  247.           This will display the Main Customization Screen.
  248.  
  249.       2)  Refer to Section III of this manual to find the file name
  250.           for your printer.  For example if you have an IBM Matrix
  251.           Printer, your file name is IBMMATRI.TAG.
  252.  
  253.       3)  Press the F5 key, type in the name of your file
  254.           (i.e. IBMMATRI), and press the ENTER key.
  255.           NOTE: It is not necessary to type the extension (.TAG).
  256.  
  257.       4)  Press the F8 key to resave TagPrint incorporating your
  258.           printer commands.
  259.  
  260.       5)  Press F9 to exit.  You are now ready to use TagPrint.
  261.  
  262.  
  263.       Example 2 - Developing a 'special' Tag file for your printer.
  264.  
  265.       1)  Perform Step 1 in Example 1 above.
  266.  
  267.       2)  Press the F6 key to display the Printer Command Editor.
  268.           Refer to Section VII of this manual for editing instructions.
  269.  
  270.       3)  When editing is completed, return to the Main Customization
  271.           Screen by pressing the ESC key.
  272.  
  273.       4)  Press F7 and then enter a file name to which you wish to save
  274.           your printer command file.  The file will be saved when you
  275.           press the ENTER key.
  276.           NOTE: It is not necessary to enter the extension (.TAG).
  277.  
  278.       5)  Perform steps 4 and 5 of Example 1 above.
  279.  
  280.  
  281.       V.             LOADING TAGPRINT AUTOMATICALLY
  282.  
  283.       If you choose to have TAGPRINT.COM automatically load upon initial
  284.       power-up or reboot, you must place the command 'TAGPRINT' in your
  285.       AUTOEXEC.BAT file.
  286.  
  287.       If you do not have an AUTOEXEC.BAT file, enter:
  288.  
  289.             COPY CON: AUTOEXEC.BAT and press [ENTER]
  290.  
  291.       Now type:
  292.             TAGPRINT /X and press [ENTER]
  293.  
  294.       Next Press the F6 key, then press [ENTER].
  295.  
  296.       The TAGPRINT program will now run automatically whenever you
  297.       power-up or reboot.  If you already have an AUTOEXEC.BAT file and
  298.       you want to add TAGPRINT, you will need to change your current
  299.       AUTOEXEC.BAT to include the command TAGPRINT /X.
  300.  
  301.       A word about the '/X' following TAGPRINT.  This  command line
  302.       parameter tells the program to immediately terminate but stay
  303.       resident.  The result is the same as pressing the F9 (ie. make
  304.       resident) after loading the program without using the ' /X'
  305.       parameter.
  306.  
  307.       If you are unfamiliar with AUTOEXEC we strongly recommend that you
  308.       read the appropriate section in your DOS manual.
  309.  
  310.  
  311.       VI.                  OPERATION
  312.  
  313.  
  314.       TagPrint may be called up any time you need it, from any
  315.       application program.  Simply press Shift PrtSc (print-screen).  In
  316.       this demonstration version an advertising message will be displayed
  317.       for 20 seconds followed by TagPrint's main menu.
  318.  
  319.       While TagPrint is active, several groups of keys have special
  320.       significance:
  321.  
  322.  
  323.  
  324.       FUNCTION KEYS
  325.  
  326.          F1 - Pop-up HELP screen is displayed which provides
  327.               descriptions of Function Keys 2-5.
  328.  
  329.          F2 - Normal print screen is executed.  You will be returned to
  330.               your normal application (not TagPrint) after the print
  331.               screen is completed.  This allows normal print-screen
  332.               operations.
  333.  
  334.          F3 - Causes the program to use the alternate printer port - LPT1
  335.               or LPT2.
  336.  
  337.          F4 - Toggle Audio Bell.  Bell signals in any printer command
  338.               code will be sent or not sent to the printer in
  339.               accordance with the option currently selected.
  340.  
  341.          F5 - A copy of the screen that was present before TagPrint
  342.               was activated will be displayed.  After viewing, return
  343.               to TagPrint by pressing the F5 key again.
  344.  
  345.  
  346.  
  347.      WINDOW SCROLL KEYS
  348.  
  349.       Six different keys on the cursor pad can be used to change the
  350.       highlighted menu selection in the bottom portion of the screen.
  351.  
  352.             UP ARROW - moves up one line.
  353.  
  354.             DOWN ARROW - moves down one line.
  355.  
  356.             PgUp - moves up 4 lines.
  357.  
  358.             PgDn - moves down 4 lines.
  359.  
  360.             Home - moves to top of menu.
  361.  
  362.             End  - moves to bottom of menu.
  363.  
  364.  
  365.  
  366.      WINDOW COMMAND KEYS
  367.  
  368.             RETURN - send command to printer for highlighted menu
  369.                      selection.
  370.  
  371.  
  372.             ESC -  The ESC key causes TagPrint to go back into
  373.                    hiding, leaving your application intact right
  374.                    where you left off.
  375.  
  376.            Ctrl End - This key combination will cause TagPrint to
  377.                       deinstall and return all allocated memory to
  378.                       the system memory pool.  The actual
  379.                       performance of the deinstall request may be
  380.                       delayed until DOS is not busy.  This delay
  381.                       will in no way cause problems with the
  382.                       operation of your computer.
  383.  
  384.  
  385.       When TagPrint encounters an error while sending a command to your
  386.       printer, it flashes to let you know that communications with the
  387.       printer were not successful.
  388.  
  389.       There are several things you can do to remedy the problem.
  390.  
  391.       1) Make sure that the printer is turned on and is on-line and ready.
  392.  
  393.       2) Verify that the printer cable is attached to the specified port,
  394.          and is in good condition.
  395.  
  396.       3) If you have an external print buffer make sure it is powered up
  397.          and properly connected.
  398.  
  399.  
  400.  
  401.  
  402.      VII.                BUILDING A PRINTER COMMAND FILE
  403.  
  404.       The capability to easily build a customized printer command file
  405.       was added to this version of TagPrint to provide a method of
  406.       supporting all printers and allowing users the flexibility to
  407.       customize TagPrint for any printer.  If your printer is not one of
  408.       those for which a printer command file has been provided, or if you
  409.       decide to improve upon an existing file, you will probably need to
  410.       refer to your printer manual to determine what commands you wish to
  411.       utilize.
  412.  
  413.  
  414.       To build or modify a printer command file, press F6 while on the
  415.       Main Customization Screen.  This will cause the Printer Command Editor
  416.       to be displayed.  This screen is actually three stacked windows.
  417.  
  418.       Bottom Window:
  419.  
  420.       When F6 is pressed, control is passed to this window.  The user may
  421.       select a printer command to be edited, add a new printer command,
  422.       delete an existing printer command, or return to the Main
  423.       Customization Screen.  The printer command menu can be scrolled
  424.       using the following keys:
  425.  
  426.             UP ARROW - moves up one line.
  427.  
  428.             DOWN ARROW - moves down one line.
  429.  
  430.             PgUp - moves up 4 lines.
  431.  
  432.             PgDn - moves down 4 lines.
  433.  
  434.             Home - moves to top of menu.
  435.  
  436.             End  - moves to bottom of menu.
  437.  
  438.  
  439.       When the Ins (INSERT) key is pressed, a blank line is inserted
  440.       before the highlighted line.  A blank line is considered a valid
  441.       printer command.  Maximum commands = 50.
  442.  
  443.       Existing commands may be deleted from the menu by pressing the Del
  444.       (DELETE) key.  Minimum commands = 1.
  445.  
  446.       Pressing the ENTER key will select the currently highlighted
  447.       printer command for editing, and the TOP WINDOW will become active.
  448.  
  449.       Pressing the ESC key will return the program to the Main
  450.       Customization Screen where the edited changes can either be saved
  451.       or discarded.
  452.  
  453.  
  454.  
  455.  
  456.  
  457.       Top Window:
  458.  
  459.       When active, a cursor will appear in the top window.  The user may
  460.       then enter or modify the description for the command highlighted in
  461.       the bottom window.
  462.  
  463.       The following keys perform special functions:
  464.  
  465.         Left Arrow  - moves cursor left
  466.  
  467.         Right Arrow - moves cursor right
  468.  
  469.         Tab         - moves cursor right 5 spaces
  470.  
  471.         Back Tab    - moves cursor left 5 spaces
  472.  
  473.         Backspace   - destructs character to left of cursor, then moves
  474.                       cursor left one space.
  475.  
  476.         Insert      - Ins key changes modes between insert and
  477.                       overwrite.  Insert mode is denoted by a large
  478.                       solid cursor.  While in insert mode each time a
  479.                       character is entered from the keyboard, all
  480.                       characters from the cursor to the end of the
  481.                       edit line are shifted right. (Any character in
  482.                       the end of line position will be lost).
  483.  
  484.          ESC        - The escape key will abort the current text
  485.                       editing and will restore the text to that
  486.                       displayed in the bottom window.
  487.  
  488.          Enter      - Accept the changes entered and proceed to the
  489.                       center window for Print Control Code Editing.
  490.  
  491.  
  492.      Center Window:
  493.  
  494.  
  495.       This window displays the actual codes that will be sent to the
  496.       printer for the description highlighted in the bottom window.  A
  497.       command code may be from 0 to 15 bytes .  The command code is shown
  498.       in both decimal and hexadecimal notation.  When applicable,
  499.       mnemonic symbols, ASCII characters, or control characters are also
  500.       displayed.  Although a command code may consist of less, the
  501.       display always shows 16 bytes.  A byte with a value of 255 has
  502.       special significance.  It signals the program that the printer
  503.       command code sequence has been completed.  Any bytes shown to the
  504.       right of a '255' terminator byte would never be sent to the printer
  505.       and therefore are meaningless.
  506.  
  507.       ALWAYS END A PRINTER COMMAND WITH A 255!
  508.  
  509.       Another value, 254, also has special significance to TagPrint.
  510.       When included in a printer command code, the program will prompt
  511.       for a replacement value when the command is actually sent to the
  512.       printer.  Use this technique when the actual value you might wish
  513.       to use is not known.  For example, setting the left margin on your
  514.       printer could  be handled by one menu selection since the '254'
  515.       placeholder byte could be used to prompt for a 'variable' margin.
  516.  
  517.       When this window is active, a flashing down arrow is displayed over
  518.       the byte that may be modified.  This arrow may be moved left and
  519.       right using the appropriate arrows on the cursor pad.
  520.  
  521.       The cursor pad is also used to change the value of the selected
  522.       byte.  Changes may be made by using the following keys:
  523.  
  524.          Home      -  set to 255 decimal
  525.  
  526.          End       -  set to 0 decimal
  527.  
  528.          PgUp      -  increase by 16 decimal
  529.  
  530.          PgDn      -  decrease by 16 decimal
  531.  
  532.          Up Arrow  -  increase by 1
  533.  
  534.          Dn Arrow  -  decrease by 1
  535.  
  536.       NOTE:  Values will roll over at 255 and 0 (eg. pressing PgUp when
  537.              current value is 255 will result in a value of 15).
  538.  
  539.       As with the top and bottom windows, two keys will cause the program
  540.       to exit the middle window.
  541.  
  542.          ESC      - The escape key will abort the printer control
  543.                     code editing and will restore the code to its
  544.                     original condition.  The process is returned to
  545.                     the bottom window.
  546.  
  547.          Enter    - Accept the changes entered and return process
  548.                     to the bottom window.
  549.  
  550.  
  551.  
  552.                          -----------------
  553.             VIII.            ORDER FORM
  554.                          -----------------
  555.  
  556.  
  557.             ATTENTION:  ASHCROFT GROUP INC.            DATE: _________
  558.                         2401 Longest Avenue
  559.                         Louisville, Kentucky 40204
  560.  
  561.  
  562.             BILL TO:                       SHIP TO:
  563.  
  564.           ________________________             _________________________
  565.  
  566.           ________________________             _________________________
  567.  
  568.           ________________________             _________________________
  569.  
  570.           ________________________             _________________________
  571.  
  572.  
  573.  
  574.  
  575.           QUANTITY        ITEM              COST PER UNIT      TOTAL COST
  576.           ======== =====================  ================= ================
  577.  
  578.               ____   TagPrint Program 1.2       $20.00           _______
  579.  
  580.           (Outside USA or Canada add $15.00 for postage)         _______
  581.  
  582.                                      Total Amount ....           _______
  583.  
  584.           ==================================================================
  585.  
  586.           Payment must accompany order.  Please check method of payment.
  587.  
  588.               ____    Check payable to: Ashcroft Group Inc.
  589.  
  590.               ____    Visa     ____  MasterCard
  591.  
  592.              Cardholder's Name _______________________________________
  593.  
  594.              Account Number  _______________________________________
  595.  
  596.              Expiration Date ____________     Telephone ____________
  597.  
  598.              Cardholder's Signature __________________________________
  599.  
  600.