High Voltage Shareware/high1.zip/high1/DIR16/PRINDIR9.ZIP/PRINDIR.DOC

Text File | 1993-10-12 | 41KB | 872 lines

       PPPPPPPP   RRRRRRRR   IIIIIII  N      N  DDDD     IIIIIII  RRRRRRRR       PPPPPPPP   RRRRRRRR   IIIIIII  N      N  DDDD     IIIIIII  RRRRRRRR       PPPPPPPP   RRRRRRRR   IIIIIII  N      N  DDDD     IIIIIII  RRRRRRRR
       P       P  R       R     I     NN     N  D   D       I     R       R       P       P  R       R     I     NN     N  D   D       I     R       R       P       P  R       R     I     NN     N  D   D       I     R       R
       P       P  R       R     I     NN     N  D    D      I     R       R       P       P  R       R     I     NN     N  D    D      I     R       R       P       P  R       R     I     NN     N  D    D      I     R       R
       P       P  R       R     I     N N    N  D     D     I     R       R       P       P  R       R     I     N N    N  D     D     I     R       R       P       P  R       R     I     N N    N  D     D     I     R       R
       PPPPPPPP   RRRRRRRR      I     N  N   N  D     D     I     RRRRRRRR       PPPPPPPP   RRRRRRRR      I     N  N   N  D     D     I     RRRRRRRR       PPPPPPPP   RRRRRRRR      I     N  N   N  D     D     I     RRRRRRRR
       P          RRRRR         I     N   N  N  D     D     I     RRRRR       P          RRRRR         I     N   N  N  D     D     I     RRRRR       P          RRRRR         I     N   N  N  D     D     I     RRRRR
       P          R    R        I     N    N N  D     D     I     R    R       P          R    R        I     N    N N  D     D     I     R    R       P          R    R        I     N    N N  D     D     I     R    R
       P          R     R       I     N     NN  D    D      I     R     R       P          R     R       I     N     NN  D    D      I     R     R       P          R     R       I     N     NN  D    D      I     R     R
       P          R      R      I     N     NN  D   D       I     R      R       P          R      R      I     N     NN  D   D       I     R      R       P          R      R      I     N     NN  D   D       I     R      R
       P          R       R  IIIIIII  N      N  DDDD     IIIIIII  R       R       P          R       R  IIIIIII  N      N  DDDD     IIIIIII  R       R       P          R       R  IIIIIII  N      N  DDDD     IIIIIII  R       R








                            User Guide and Reference Manual








                              Printer Redirection System


                                     Version 9.00


                                   October 12, 1993


                     Copyright (c) 1989-1993 J.M. Allen Creations


                        All Rights Reserved by Michael A. Hotz

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



                                   TABLE OF CONTENTS                                   TABLE OF CONTENTS                                   TABLE OF CONTENTS

       INTRODUCTION .............................................3
       SHAREWARE NOTICE .........................................4
       DISCLAIMER ...............................................4
       INSTALLATION AND REMOVAL .................................5
       REQUIRED COMMAND LINE ARGUMENT ...........................5
       EXAMPLES .................................................5
       OPTIONAL COMMAND LINE ARGUMENTS ..........................5
       THE MULTIPLEX ID .........................................6
       POPUP PARAMETER MENU .....................................6
       SOURCE DEVICE ............................................6
       DESTINATION DEVICE .......................................6
       FILE NAME ................................................7
       FILE REDIRECTION NOTES ...................................7
       WHEN PRINDIR WRITES TO THE FILE ..........................7
       MEMORY BUFFER DETAILS ....................................7
       DELAY AND MINIMUM DUMP SIZE DETAILS ......................7
       INVISIBLE MODE ...........................................8
       DELETE CURRENT FILE ......................................8
       BYTE COUNTER .............................................8
       ECHO MODE ................................................8
       VIDEO MODE SWITCHING .....................................8
       PRINMOD UTILITY ..........................................9
       PRINMOD SWITCHES .........................................9
       PRINKEY UTILITY ..........................................10
       PRINCOL UTILITY ..........................................10
       NOTES FOR PROGRAMMERS ....................................11
       FINAL NOTES AND WHERE TO GET HELP ........................12
       KNOWN CONFLICTS AND OTHER INFORMATION ....................13
       SITE LICENSE INFORMATION .................................13
       PRINDIR Version 9.00 Official Registration Form ..........14

























                                      - Page 2 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       INTRODUCTION       INTRODUCTION       INTRODUCTION
       Welcome to Version 9.00 of PRINDIR, the BEST printer redirection program
       available!  PRINDIR is a TSR program that will allow you to redirect the
       output of any standard COM or LPT port to any other COM or LPT port, as
       well as to disk files and to the display.  In addition, PRINDIR allows
       you to specify the full path and file name for disk file redirection,
       thus it is possible to redirect to any file or named device.

       The main program offers an easy to use Popup Parameter Menu from which
       the user can quickly and easily set program options.  PRINDIR can
       utilize expanded and extended memory on systems so equipped, making its
       conventional memory footprint even smaller.  PRINDIR also includes
       several small support utilities to help you customize PRINDIR to meet
       your needs.  PRINDIR is fast, intuitive, easy to use, and can be
       utilized to solve many different types of problems.  Only your
       imagination will limit what you can do with PRINDIR.

       PRINDIR is a Shareware program written by Michael A. Hotz of J.M. Allen
       Creations, and is user supported through Shareware registration.
       Technical support is provided via phone, electronic mail, U.S. mail, or
       any other means possible.  Registered users are rewarded with very cheap
       upgrades to any future version which is released after the version they
       register.

       The long history of this program demonstrates our commitment to
       providing enhancements and updates.  We could not justify the many hours
       invested in writing, maintaining, and improving PRINDIR if it weren't
       for the tremendous number of users who have registered.  Our most
       sincere thanks go out to anyone who has registered, recommended, or in
       any other way helped make PRINDIR the success it has become!



























                                      - Page 3 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       SHAREWARE NOTICE       SHAREWARE NOTICE       SHAREWARE NOTICE
       The PRINDIR system, comprised of PRINDIR, PRINMOD, PRINCOL, and PRINKEY
       versions 9.00, this documentation, and any previous or later versions of
       any of the above are all Copyright (c) 1989-1993 J.M. Allen Creations.
       All Rights Reserved by Michael A. Hotz.  This program is NOT public
       domain, it is released using the Shareware concept.  We invite you to
       use our software on a trial basis.  If after 30 days, you find that this
       is an indispensable addition to your utility entourage, we ask that you
       pay for this program by sending a $20.00 registration fee to JMAC using
       the registration form included on the last page of this manual.  You may
       also register by phone using a valid VISA or MASTERCARD.

       Registered users are invited to upgrade to the latest version of PRINDIR
       for only $5.00.  Registration assures you of 25 percent upgrades for any
       future Shareware versions of the program, unlimited technical support,
       and you will have a clear conscience knowing you have not stolen this
       software, but rather paid a very modest fee for the continued legal use
       of PRINDIR.  In addition, there is no cost to upgrade to a minor release
       version which is within the same major release version you are currently
       registered for.  For instance, as a registered user of version 9.00, you
       can upgrade to any 9.xx version for no charge when they are released.
       Only when the major version number changes are there changes or
       improvements which warrant additional payment.

       This program may be freely distributed for others evaluation as long as
       no fee is charged, with the exception of modest disk, shipping and
       handling charges.  Any person who uses this product agrees to the terms
       of the Shareware, Copyright, and Disclaimer notices contained herein.
       If this system is distributed, only the original archive distributed by
       J.M. Allen Creations should be used, and it should not be modified in
       ANY WAY!  This will allow users who fear they may have obtained a
       patched, or otherwise modified version of the program to verify the
       integrity of the program by calling J.M. Allen Creations with the
       archive checksum information.

       You MAY NOT disassemble, reverse engineer, hack, change, modify, alter,
       mutate, refashion, vary, or catalyze any of these programs or
       documentation in any way, manner, shape or form.

       DISCLAIMER       DISCLAIMER       DISCLAIMER
       Michael A. Hotz, nor J.M. Allen Creations, nor any person or entity
       affiliated with either, will assume any responsibility for any situation
       which occurs as a result, be it direct, or indirect, of the use of any
       of these programs.  THE USER ASSUMES ALL RISK WHICH MAY BE ASSOCIATED
       WITH THE USE OF THESE PROGRAMS.  There are no warrantees whatsoever,
       expressed or implied, as to the usefulness or effectiveness of this
       system for any particular purpose.  This software is licensed as is, and
       is not guaranteed to work on any particular machine, or under any
       particular hardware or software configuration.  All of the programs have
       been tested on many different types of hardware under numerous
       configurations to perform as described in this documentation.  Use of
       this software in any way constitutes IMMEDIATE acceptance of these terms
       by the user.




                                      - Page 4 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       INSTALLATION AND REMOVAL       INSTALLATION AND REMOVAL       INSTALLATION AND REMOVAL
       PRINDIR should be installed on a system running version 3.00 of DOS or
       greater.  It should be installed at the command line, or in a batch
       file, but should not be installed while you are shelled to DOS from
       inside another program.  The program requires one of three command line
       switches to be installed, or one to be released.  There are five
       additional switches available to control special features.

       REQUIRED COMMAND LINE ARGUMENT       REQUIRED COMMAND LINE ARGUMENT       REQUIRED COMMAND LINE ARGUMENT
       prindir /c - Conventional Memory Mode
       prindir /e - Expanded Memory Mode
       prindir /x - Extended Memory Mode
       prindir /u - Attempt to remove if installed

       In all modes of installation, PRINDIR will allocate a default buffer of
       64k for buffering captured data that is being redirected to a disk file.
       You can instruct PRINDIR to use more or less memory by specifying a
       kilobyte value immediately after the /x switch.

       EXAMPLES       EXAMPLES       EXAMPLES
       prindir /c256  - Install with a 256k conventional memory buffer
       prindir /x2048 - Install with a 2 meg extended memory buffer
       prindir /e1024 - Install with a 1 meg extended memory buffer

       PRINDIR can use as much memory as you have available on your system.  To
       use EXPANDED memory, you must have an EMS driver installed.  To use
       EXTENDED memory, you must have an XMS driver installed.

       prindir /u

       Running PRINDIR with the /u switch will unload the resident copy of
       PRINDIR.  If one of the interrupts PRINDIR takes over while it is
       installed is changed while it is resident, PRINDIR will not be able to
       unload until the affected interrupt is restored.  If PRINDIR cannot
       unload safely, it will display a message to this effect and remain
       resident.  At this point you may want to unload the offending program,
       and attempt to release PRINDIR again.  Any data in the disk buffer will
       be written automatically before the program releases.

       OPTIONAL COMMAND LINE ARGUMENTS       OPTIONAL COMMAND LINE ARGUMENTS       OPTIONAL COMMAND LINE ARGUMENTS
       /k  This switch is used to tell PRINDIR not to grab the keyboard
       interrupt vector when the popup menu is displayed.  This vector is
       normally changed when PRINDIR is popped up, and restored when the menu
       is closed to provide compatibility with programs that do strange
       handling with the keyboard.  The EDIT.EXE program that comes with DOS
       5.0 is one particular program which benefits from this action.  If you
       have problems with PRINDIR you might try using the /k switch to disable
       this function before calling for technical support.

       /b  This switch is used to tell PRINDIR not to change the blink bit
       setting.  On EGA and better display adapters, PRINDIR normally turns of
       the blink bit to allow 256 different colors for the popup parameter
       menu.  You can use the /b switch to force PRINDIR not to modify the
       blink bit setting.



                                      - Page 5 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       /p  This switch is used to tell PRINDIR to add a formfeed character
       after each print screen operation.

       /q  This switch is used to tell PRINDIR not to display any messages on
       the screen.

       /ixx  This switch is used to change the ID number used by PRINDIR in
       communicating through the multiplex interrupt 2Fh.  The xx should be
       replaced with any valid hexadecimal value from 00 to FF.  See the
       discussion of the multiplex ID below for details.

       THE MULTIPLEX ID       THE MULTIPLEX ID       THE MULTIPLEX ID
       The purpose of the ID is twofold.  First, if you have another resident
       program using the default ID of 7Fh, you can change the ID used by
       PRINDIR to avoid conflict.  Generally speaking, if another piece of
       software suddenly stops working when PRINDIR is installed, you may need
       to use this switch.

       The second reason to use this switch would be in a case where you want
       to load multiple copies of the PRINDIR program to redirect multiple
       devices at the same time.  You could install the first copy of PRINDIR
       with the default, and the second using a different ID number.

       The PRINMOD program has an identical /ID switch so that you can
       communicate with several loaded copies of PRINDIR installed using
       different ID numbers.  You may want to change the hotkey for one of them
       so you have access to both popup menus, and you may want to change the
       colors for one of them as well.

       When you are ready to unload PRINDIR, you must specify the same ID
       number when unloading as when you loaded.  Also, if you install multiple
       copies, you should unload them in reverse order.

       POPUP PARAMETER MENU       POPUP PARAMETER MENU       POPUP PARAMETER MENU
       The popup parameter menu is your interface with the PRINDIR program.
       From this small popup menu, you can set many different parameters.  The
       following paragraphs summarize the different configuration settings and
       information displays.  The default keystroke to pop up PRINDIR is ALT +
       P (Hold the ALT key and press P).

       SOURCE DEVICE       SOURCE DEVICE       SOURCE DEVICE
       This section determines which port PRINDIR will capture data from.  The
       F1 through F7 keys will allow you to select different source devices.
       Any output sent to this device will be intercepted by PRINDIR, and
       redirected to the appropriate destination based on the DESTINATION
       DEVICE.  This setting will remain in effect until you change it again
       through the popup parameter menu, or the PRINMOD program.

       DESTINATION DEVICE       DESTINATION DEVICE       DESTINATION DEVICE
       This section indicates which device PRINDIR is currently writing
       redirected output to.  The 1 through 7 keys, plus S and F will allow you
       to select different destination devices.  Any data that is printed to
       the SOURCE DEVICE will be captured by PRINDIR and redirected to the
       DESTINATION DEVICE selected.  This setting will remain in effect until



                                      - Page 6 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       you change it again through the popup parameter menu, or the PRINMOD
       program.

       FILE NAME       FILE NAME       FILE NAME
       The N key will allow you to edit the file name field.  In this field,
       you should type the entire path and file name for the file you wish to
       redirect to.  If you provide a filename without a path, the file will be
       created in the current directory.  If this field is blank, PRINDIR will
       capture to the file PRINDIR.DAT in the current directory.

       FILE REDIRECTION NOTES       FILE REDIRECTION NOTES       FILE REDIRECTION NOTES
       You don't have to worry about losing data already in a file because
       PRINDIR will never write over existing data.  If the destination file
       you have specified already exists, PRINDIR will simply append any
       further data to the end of the file, leaving the original data
       untouched.  If the file specified does not exist, PRINDIR will
       automatically create it.

       WHEN PRINDIR WRITES TO THE FILE       WHEN PRINDIR WRITES TO THE FILE       WHEN PRINDIR WRITES TO THE FILE
       PRINDIR automatically writes any data in it's buffers before the
       parameter menu is activated and before the program is removed from
       memory at the users request.  PRINDIR will attempt to write any buffered
       data after a default of 5 seconds pass with no new data being added to
       the buffer.  PRINDIR will also attempt to write any buffered data when
       the number of bytes in the buffer reaches or exceeds a predefined
       minimum.  The default is 10k and can be changed with the PRINMOD
       program.

       MEMORY BUFFER DETAILS       MEMORY BUFFER DETAILS       MEMORY BUFFER DETAILS
       The memory buffer serves as a temporary storage area where PRINDIR can
       store redirected data to be redirected to a file until the system is in
       a state where PRINDIR can safely interrupt the foreground application to
       open a file, write the data, and close the file again.  Most programs
       that you will run should provide ample opportunities for PRINDIR to
       safely write to files.  For the few that don't, you can use a very large
       buffer to capture all printed data, and then have it written to the file
       when the program terminates.

       DELAY AND MINIMUM DUMP SIZE DETAILS       DELAY AND MINIMUM DUMP SIZE DETAILS       DELAY AND MINIMUM DUMP SIZE DETAILS
       The delay and minimum dump size values that can be set with the PRINMOD
       utility are designed to allow PRINDIR to operate efficiently.  Without
       them, PRINDIR would try to write each character to the file as it is
       printed.  This would slow the system to a crawl as the file would have
       to be opened, written, and closed for each character printed.

       The /SIZE option of PRINMOD allows you to tell PRINDIR not to bother
       writing to the disk file until at least a certain amount of data has
       been captured.  This prevents the thrashing situation that was described
       above.

       Now the, since PRINDIR isn't going to write every byte it receives
       instantly to the file, the situation will often occur when your
       application is done printing, but some of the data is still in the
       buffer.  PRINDIR solves this problem with the /WAIT option of the



                                      - Page 7 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       PRINMOD program.  This option tells PRINDIR how long to wait for no data
       to be printed before it writes the remaining data in the buffer to the
       capture file.  This time-out value is necessary because there is no way
       of knowing when a print job has ended that is compatible with all
       printer drivers or applications.

       INVISIBLE MODE       INVISIBLE MODE       INVISIBLE MODE
       When PRINDIR is in invisible mode, it appears transparent in that it
       does not modify any data in any way.  Invisible mode allows PRINDIR to
       remain in memory without disturbing any printed data, waiting for your
       commands at any time.  You can set PRINDIR to invisible by using the I
       key in the Popup Parameter Menu, or by using the PRINMOD program.

       DELETE CURRENT FILE       DELETE CURRENT FILE       DELETE CURRENT FILE
       The D key will allow you to delete the file currently specified  in the
       File Path and File Name fields.  PRINDIR does not provide you with an
       option to change your mind when this key is pressed.  The file is
       deleted instantly.

       BYTE COUNTER       BYTE COUNTER       BYTE COUNTER
       This display is a eight digit counter that can be seen in the upper
       right corner of the screen when the Counter option is selected with the
       C key.  The display shows the number of bytes that are in the
       redirection buffer, and uses the same colors as the parameter menu.

       ECHO MODE       ECHO MODE       ECHO MODE
       Echo mode provides a way to print to two devices at one time.  When echo
       mode is on, every byte printed to the port intercepted will be sent to
       the PRINDIR destination, as well as to the original intercepted device.
       For instance, if the CAPTURED DEVICE is set for LPT1, and the
       DESTINATION DEVICE is set to FILE, and the ECHO MODE is turned on,
       anything you print to LPT1 will go into the file specified, as well as
       to LPT1.

       VIDEO MODE SWITCHING       VIDEO MODE SWITCHING       VIDEO MODE SWITCHING
       PRINDIR now incorporates very simple logic for dealing with graphics and
       other nonstandard display modes.  When you pop PRINDIR up over anything
       but a standard 80 x 25 text display, PRINDIR will switch the display
       mode to a mode it can deal with, and when you close the Popup Parameter
       Menu the original screen and video mode will be restored.  HOWEVER, the
       method used to save and restore the screen is not perfect, and therefore
       you will notice, particularly in graphics modes, that a portion of the
       display is not properly restored, and the palette colors may be lost as
       well.  While we aren't pleased with the end results, we feel this is
       better than nothing at all.  This approach allows popping up over
       graphics with virtually no additional code overhead.  If the side effect
       of popping PRINDIR over graphics displays annoys you, we suggest you
       only pop up over text screens.

       PRINDIR will automatically write any bytes in the disk buffer before
       popup.  This occurs to prevent problems with parts of files being
       printed to parts of other files when doing file name changes.





                                      - Page 8 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       PRINMOD UTILITY       PRINMOD UTILITY       PRINMOD UTILITY
       PRINMOD is a separate program to support changing resident PRINDIR
       parameters from batch files, or at the command line, or even from within
       other programs.  PRINMOD will allow you to do this easily.  You simply
       run PRINMOD with the desired parameters.  The parameters can be any
       number from the list below, in any combination.

       PRINMOD SWITCHES       PRINMOD SWITCHES       PRINMOD SWITCHES

            /IDxx               - Set ID number used to communicate with
                                  resident program (00h through FFh allowed).

            /GETx               - Set captured device         (1 - 7)
            /PUTx               - Set destination device      (0 - 9)

            The device numbers used with /GET and /PUT are:

            1 = LPT1, 2 = LPT2, 3 = LPT3
            4 = COM1, 5 = COM2, 6 = COM3, 7 = COM4
            8 = SCREEN, 9 = FILE, 0 = INVISIBLE
            /FILE-...           - Set the name for the capture file
            /LOCK-...           - Set the name for the file lock
            /DUMP               - Write remaining bytes in buffer to file
            /NCOLxxx            - Change the standard text color
            /HCOLxxx            - Change the highlight text color
            /KEYxxx             - Change the hotkey
            /DISPx[0,1]         - Turn the byte count display off or on
            /ECHOx[0,1]         - Turn the echo mode off or on
            /WAITxxx            - Set the delay for writing remaining bytes
            /SIZExxx            - Set the minimum kb required for writing
            /POP                - Show the popup parameter menu

       The /ID parameter is used to select the ID number of the resident copy
       of PRINDIR to communicate with.  This can be any hexadecimal number
       between 00 and FF.

       The /GET parameter is used to set the source device for redirection.

       The /PUT parameter is used to set the target device for redirection.

       The /FILE parameter is used to set the name of the file PRINDIR should
       write to when capturing output to a file.  It is the same as the File
       Name field in the popup menu.

       The /LOCK parameter is used to set the name of a lock file that PRINDIR
       should create and obey.  This is useful in multitasking environments
       where programs other than PRINDIR will be accessing the capture files.
       When you specify a lock file, PRINDIR will not write to it's capture
       file when the lock file exists.  If the lock file does not exist,
       PRINDIR will create it before dumping to the capture file, and remove it
       after the dump is finished.  If no lock file is specified, PRINDIR will
       not use the locking mechanism.





                                      - Page 9 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       The /DUMP parameter will force PRINDIR to write any bytes that are in
       its capture buffer to the current capture file.

       The /NCOL parameter will allow you to change the normal color for the
       popup menu.  (Use PRINCOL to see a table of colors and values to be used
       with this switch).

       The /HCOL parameter will allow you to change the highlight color for the
       popup menu.  (Use PRINCOL to see a table of colors and values to be used
       with this switch).

       The /KEY parameter can be used to set the hotkey to be used to open the
       popup menu.  (Use PRINKEY to determine the scancode for the key you wish
       to use).

       The /DISP parameter can be used to turn on (/DISP1) and off (/DISP0) the
       byte count indicator.

       The /ECHO parameter can be used to turn on (/ECHO1) and off (/ECHO0) the
       echo feature.

       The /WAIT parameter can be used to set the number of ticks to wait with
       no additional data being written to the captured device  before PRINDIR
       will flush it's buffers to the capture file.  This value is specified in
       clock ticks.  There are 18.2 clock ticks in a second.

       The /SIZE parameter can be used to set the minimum number of bytes that
       must be in the buffer before PRINDIR will begin watching for a safe time
       to write it's buffers to disk.

       The /POP parameter can be used to open the popup menu from the command
       line, or a batch file.

       If you give an invalid argument, or PRINDIR is not installed, the
       program will display a message indicating the situation.  Also remember
       that PRINMOD only changes the parameters in the resident copy of
       PRINDIR.  Each time PRINDIR is installed, it starts out its resident
       life with the defaults.  Many users who install PRINDIR in their
       autoexec.bat file run the PRINMOD program immediately after the PRINDIR
       program to set the desired parameters.

       PRINKEY UTILITY       PRINKEY UTILITY       PRINKEY UTILITY
       The PRINKEY program will allow you to press the key you wish to use to
       popup the PRINDIR Popup Parameter Menu.  The program will then print the
       number you must use with the PRINMOD program using the /KEY option.
       Remember that this does not change the keystroke permanently, only while
       PRINDIR is installed, or until it is changed again with PRINMOD.  While
       you must use the ALT key in conjunction with the hotkey to popup
       PRINDIR, you should NOT use the ALT key when running this program.

       PRINCOL UTILITY       PRINCOL UTILITY       PRINCOL UTILITY
       The PRINCOL program will display all of the possible values for the
       /NCOL and /HCOL options of the PRINMOD program.  Remember that this does
       not change the color permanently, only while PRINDIR is installed, or



                                      - Page 10 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       until it is changed again with PRINMOD.

       NOTES FOR PROGRAMMERS       NOTES FOR PROGRAMMERS       NOTES FOR PROGRAMMERS
       You may easily incorporate support for changing resident PRINDIR
       settings in your own software through multiplex interrupt 2Fh.  You
       simply put valid numbers in the correct registers, and issue software
       interrupt 2Fh.

       For all calls, the AH register should contain the ID number of the
       resident copy you wish to communicate with.  The AL register should
       contain one of the values from the table below.  Return values are
       generally passed in the AX register.  The AX register will return 0 if
       the call is successful, or -1 if it fails.  If a call fails, it is
       usually because you requested an invalid function number, or provided an
       invalid argument.

       AL = 00h  - Determine if PRINDIR is installed.

            Upon return, the AH register will contain the ID number and the AL
       register will contain 0xFF.  If these values aren't returned, then
       PRINDIR is not installed.  If these values are returned, you then need
       to check the string located at the far address returned in the CX:DX
       registers to make sure PRINDIR is the program installed on the ID number
       you are using.  You should find "PRINDIR" at this address as a null
       terminated string.  Finally, once you have determined PRINDIR is
       installed, check the version number returned in the BX register.  The BH
       register will contain the major version number, and the BL register will
       contain the minor version number.  The API listed below is subject to
       change between versions.

       AL = 01h - Set Capture Device
       DX = A valid capture device as defined above
            AX returns 0 for success, -1 for an invalid device number

       AL = 02h - Set Destination Device
       DX = A valid destination device number as defined above
            AX returns 0 for success, -1 for an invalid device number

       AL = 03h - Set Capture File Name
       CX = Segment to a null terminated capture file name
       DX = Offset to a null terminated capture file name
            AX returns 0 for success, -1 if the string is to long

       AL = 04h - Set Lock File Name
       CX = Segment to a null terminated lock file name
       DX = Offset to a null terminated lock file name
            AX returns 0 for success, -1 if the string is to long

       AL = 05h - Dump Capture Buffer
            AX always returns zero

       AL = 06h - Set Normal Text Color
       DH = New text color
            AX always returns zero



                                      - Page 11 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual




       AL = 07h - Set Highlight Text Color
       DH = New highlight color
            AX always returns zero

       AL = 08h - Set Popup Hotkey
       DH = Scancode for new hotkey
            AX always returns zero

       AL = 09h - Set state of byte counter display
       DX = 0 to turn off, 1 to turn on
            AX always returns zero

       AL = 0Ah - Set Flush Delay
       DX = Number of clock ticks for delay
            AX always returns zero

       AL = 0Bh - Set Minimum Dump Size
       DX = Number of kilobytes before dumping
            AX always returns zero

       AL = 0Ch - Set echo state
       DX = 0 to turn off, 1 to turn on

       AL = 0Dh - Show Popup Parameter Menu
            AX returns 0 if successful, any other value indicates failure

       AL = 0Eh - Submit byte to current destination device
       DL = Byte to submit.
            AX returns 0 if successful, any other value indicates failure

       FINAL NOTES AND WHERE TO GET HELP       FINAL NOTES AND WHERE TO GET HELP       FINAL NOTES AND WHERE TO GET HELP
       We have put a great deal of work into this system, and believe PRINDIR
       is the best, safest, most versatile, and most reliable programs of this
       nature that is available.  If, however, you are experiencing any
       problems, please don't hesitate to contact us.  We deal with all
       technical support questions promptly, and we would be glad to help with
       any problem you may be having.

       You may contact Michael A. Hotz from 9:00 a.m. until 5:00 p.m Monday
       through Friday at [phone].  After hours and on weekends, you may
       call [phone].  This is a cell phone, and if it is not answered,
       will forward to a voice mailbox which we check as often as possible.  If
       you leave a message on here, we will usually call you back the same day.
       You may also send Compuserve Mail to 74160,3111, GEnie Mail to MAHOTZ,
       or Internet Mail to [e-mail].

       Many of the features in PRINDIR have been added at the request of other
       users.  If you have ideas, suggestions, questions, comments, or
       criticism, please contact us so a solution can be worked out.

       If you have trouble and can't get things going, be sure you have some
       basic information before you call, such as what type of system you are
       using, what type of memory buffer you are using, what types of programs



                                      - Page 12 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



       you have resident, what programs you are using, and when the problems
       occur.  With this information we can generally determine what the
       problem is, and find a way to get PRINDIR to work for you!

       KNOWN CONFLICTS AND OTHER INFORMATION       KNOWN CONFLICTS AND OTHER INFORMATION       KNOWN CONFLICTS AND OTHER INFORMATION
       PRINDIR cannot redirect programs which bypass the BIOS and access
       hardware directly.  PRINDIR intercepts all devices at the BIOS level,
       but there is no easy way to intercept direct hardware writes on all
       computers.

       PRINDIR has been tested under MS-DOS Versions 3.30, 4.01, 5.00, and
       6.00, IBM OS/2 2.0 in a DOS Window, Desqview 386 Version 2.42, and
       Microsoft Windows 3.0 and 3.1.  PRINDIR should have no problem with the
       loadhigh statement available under MS-DOS 5.0, and similar statements
       provided by other memory managers such as QEMM.

       SITE LICENSE INFORMATION       SITE LICENSE INFORMATION       SITE LICENSE INFORMATION
       PRINDIR can be site licensed by using the following guidelines.  The
       minimum registration cost is $20.00.  This allows the use of PRINDIR on
       up to 20 machines at any single location.  The charge for each
       additional machine is $1.00 in increments of $10.00

       1   -  20 Machine   =  $20.00
       21  -  30 Machines  =  $30.00
       31  -  40 Machines  =  $40.00
       41  -  50 Machines  =  $50.00

       etc...  etc...  etc...

       Site license upgrades follow the same logic of single license upgrades,
       including the same logic as above.

       1   -  20 Machines  = $5.00
       21  -  30 Machines  = $7.50
       31  -  40 Machines  = $10.00
       41  -  50 Machines  = $12.50

       etc...  etc...  etc...



















                                      - Page 13 -

              JMAC PRINDIR Version 9.00 Users Guide and Reference Manual



                    PRINDIR Version 9.00 Official Registration Form                    PRINDIR Version 9.00 Official Registration Form                    PRINDIR Version 9.00 Official Registration Form

       Please mail this form to:

       J.M. Allen Creations
       P.O Box 387
       Lindsey, Ohio  43442-0387

       Please make any check or money orders payable to J.M. Allen Creations.
       First time registration is $20.00.  Registered users of versions prior
       to 9.00 may upgrade to version 9.00 for only $5.00.

       Name _________________________________________________________________

       Title ________________________________________________________________

       Company Name _________________________________________________________

       Address ______________________________________________________________

       City _______________________ State _____________ Zipcode _____________

       Daytime Phone __________________________ Fax _________________________

       E-Main (Compuserve, GEnie, Delphi, Internet, MCI Mail, Etc...)

       ______________________________________________________________________

       ____ New Registrations @ $20.00 Each            = $________.____

       ____ Upgrade Registrations @ $5.00 Each         = $________.____

       ____ New Site License For _____ Machines       = $________.____

       ____ Upgrade Site License For _____ Machines    = $________.____

       TOTAL COST -------------------------------------- $________.____

       [ ] I have enclosed a check or money order for the total

       [ ] Charge the credit card below for the total (SIGNATURE REQUIRED)

       CREDIT CARD NUMBER (13 or 16 digits)                        EXPIRATION
       VISA/MASTERCARD ONLY!                                       DATE

       __ __ __ __ - __ __ __ __ - __ __ __ __ - __ __ __ __       __ - __

       AUTHORIZED SIGNATURE__________________________________________________


       IF YOU DOWNLOADED PRINDIR, PLEASE TELL US FROM WHERE SO WE CAN PROVIDE
       UPDATES TO THE SYSTEM OPERATOR WHEN THEY BECOME AVAILABLE.

       ______________________________________________________________________



                                      - Page 14 -