home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT157.ZIP / XREADME < prev   
Text File  |  1991-09-06  |  23KB  |  633 lines
  1. (xreadme)
  2.  
  3.                DOS Extensions for Professionals
  4.     
  5.     is a Unified Package of file utilities bringing to the PC the power,
  6.     functionality, and increased personal productivity usually associated
  7.     only with minicomputer-based software.  Designed to meet the processing
  8.     needs of the corporate community as well as of demanding home users,
  9.     these utilities feature designed-in robustness, flexibility, and 
  10.     generality leading to predictable results in the most trying and
  11.     unusual situations.
  12.     
  13. Quick Start:
  14.     
  15.     The fastest way to get an overview of the capabilities of this program 
  16.     is to print this 12 page file and, while it is printing, run the Ten
  17.     Minute XDEMO. 
  18.     
  19.     The simplist way to run the demonstrations and install this product is
  20.     to make a temporary copy of the distribution disk on your hard disk.
  21.     (The demonstrations require extra free space for the creation of 
  22.     temporary subdirectories.  Documentation and installation procedures, 
  23.     which are compressed on 360K disks, must also be expanded.)
  24.  
  25.     Create a temporary directory of any name and copy the contents of the
  26.     distribution disk to it.  Assuming your current drive is your hard
  27.     disk and drive A: contains the distribution disk:
  28.  
  29.         mkdir  \DOSX
  30.         cd  \DOSX
  31.         copy  A:*.*
  32.         copy  XREADME  prn        (or print XREADME)
  33.         XDEMO
  34.         
  35.     XDEMO gives a live overview of the utilities found in "DOS Extensions 
  36.     for Professionals".
  37.     
  38.     XDEMO_AD gives a more detailed look at some of the capabilities of 
  39.     "DOS Extensions for Professionals".  Execute it when you feel the need  
  40.     for more complicated examples.
  41.     
  42.     The temporary directory you just created can be removed after "DOS
  43.     Extensions for Professionals" has been fully installed and after you
  44.     have run both demonstrations.
  45.     
  46.     
  47. Contents of Disk:
  48.     
  49.     The shareware distribution disk contains the following files:
  50.     
  51.     xreadme       general information and instructions
  52.     xinstall.bat  installation batch file
  53.     xdemo.bat     introductory demo program
  54.     xdemo_ad.bat  advanced demo program
  55.     register.doc  shareware registration form
  56.       * xmanual.doc   a high-level manual of commands
  57.     vendor.doc    distributor information & product description
  58.     rev22.old     demo text
  59.  
  60.  
  61.  
  62.  
  63.     rev22.new     altered demo text
  64.     diff.exe
  65.     dump.exe
  66.     search.exe
  67.     split.exe
  68.     sub.exe
  69.     xdel.exe
  70.     xdir.exe
  71.     xhelp.exe
  72.       * add2dos5.bat  DOS 5 supplementary installation procedure
  73.     addhelp.exe   updates doshelp.hlp
  74.       * xdosshel.scr  edlin commands for updating dosshell.ini
  75.       * xdosshel.add  text for updating dosshell.ini
  76.       * xdoshelp.ad?  text for updating doshelp.hlp
  77.  
  78.   * On smaller distribution disks, these files have been imploded into the 
  79.     self-extracting file XMANUAL.EXE.
  80.  
  81. Installation Instructions:
  82.     
  83.     Copy the .EXE's and Set the Path:
  84.  
  85.     Many users store their DOS executable images under the \DOS
  86.     directory on their hard drive.  They often keep utility programs
  87.     in a separate directory.
  88.  
  89.     XINSTALL, which installs "DOS Extensions for Professionals" on
  90.     your system, must be called with the target drive/directory path
  91.     as its first argument and must be run from your distribution disk
  92.     (or from the directory to which you copied it on your hard disk.)
  93.  
  94.     The example outlined below assumes that you've copied your
  95.     distribution disk to the directory \DOSX on your hard drive, that 
  96.     drive C: is your target hard drive, and that you've chosen \UTIL 
  97.     as the directory for your utilities.
  98.  
  99.         cd  \DOSX
  100.         XINSTALL  C:\UTIL
  101.  
  102.     DOS's search path dictates which directories, in addition to the
  103.     current directory, will be searched for executable and batch
  104.     files. Assuming you have already set the path for your \DOS
  105.     directory, the following command, which already has been executed
  106.     from within XINSTALL.BAT, adds \UTIL to it.
  107.  
  108.         path=c:\util;c:\dos
  109.  
  110.     Note that \UTIL will be searched before \DOS.  This is important
  111.     if you want to replace standard DOS commands with your own
  112.     variants.  You don't actually have to delete the DOS version if
  113.     the \UTIL directory is searched first.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.     Update Autoexec.bat:
  120.     
  121.     To make the above path change permanent, you must include it in 
  122.     C:\AUTOEXEC.BAT, the file that is executed each time your system is 
  123.     booted.  Use your favorite editor.
  124.     
  125.     Expand Compressed Files:
  126.  
  127.     The shareware version of "DOS Extensions for Professionals" does
  128.     not fit on one 360K diskette.  If you have XMANUAL.EXE rather than
  129.     XMANUAL.DOC, you must expand compressed files to read the manual
  130.     and to integrate with DOS 5.
  131.  
  132.     To expand, you must copy the contents of the distribution disk
  133.     to your hard drive - outlined in the Quick Start section above.
  134.     (If you don't have a hard drive, copy XMANUAL.EXE to an empty
  135.     diskette.)
  136.  
  137.     Execute the self-extracting file XMANUAL.EXE from your hard drive.
  138.  
  139.         cd  \DOSX
  140.         XMANUAL
  141.  
  142.     The file XMANUAL.DOC and a number of files required for the next
  143.     step are created.
  144.     
  145.     Integrate with DOS 5:
  146.  
  147.     To fully integrate "DOS Extensions for Professionals" into systems
  148.     running DOS 5, you must run the batch file ADD2DOS5 from the
  149.     distribution disk (or from your distribution directory on your
  150.     hard disk.)
  151.  
  152.     Make the drive/directory containing the (expanded) distribution 
  153.     disk your current drive and directory.  Run ADD2DOS5 with the 
  154.     path of the directory containing your DOS 5 system as its first 
  155.     argument.
  156.  
  157.         cd  \DOSX
  158.         ADD2DOS5  C:\DOS
  159.  
  160.     This procedure works only if you are running a DOS 5 system.
  161.  
  162.     The batch file does two things:
  163.  
  164.         it updates the file DOSHELP.HLP, a text file containing high
  165.         level documentation for each system command, and
  166.  
  167.         it adds the new Group "DOS Extensions for Pros" and new
  168.         Programs Items reflecting the utilities found in "DOS
  169.         Extensions for Professionals" to the system file DOSSHELL.INI.
  170.  
  171.     You will notice the new Group and Program Items when you are in the
  172.     dosshell environment.
  173.  
  174.  
  175.  
  176.  
  177.     These additions have been placed there for your convenience.  Feel
  178.     free to modify or change them as you wish.  The original system
  179.     files are preserved as DOSHELP.BAK and DOSSHELL.BAK in case you
  180.     want to restore them.  Rename them to more permanent names,
  181.     perhaps ending in .V1 for "version 1" for safe keeping.
  182.  
  183.         C:> ren  C:\DOS\DOSHELP.BAK  DOSHELP.V1
  184.         C:> ren  C:\DOS\DOSSHELL.BAK DOSSHELL.V1
  185.     
  186.     Note:  
  187.          Addition of the new Group and Program Items to the system
  188.          file DOSSHELL.INI uses the system program EDLIN by redirecting 
  189.          a simple command script to its standard input.  This process 
  190.          obviously can't work if EDLIN is unavailable on your system.  
  191.          Use your favorite editor to insert XDOSSHEL.ADD into 
  192.          DOSSHELL.INI after the first occurrence of the text 
  193.          "program =", near line 39.  
  194.     
  195.          In the unlikely event that EDLIN is available but your system 
  196.          hangs without exiting the EDLIN command (a TSR problem?), 
  197.          reboot and run EDLIN manually typing the three commands found 
  198.          in the script file XDOSSHEL.SCR.  Its surprisingly easy!
  199.  
  200.  
  201.     Having taken the preceding steps, "DOS Extensions for Professionals" 
  202.     is completely installed.  Execution of the individual programs is 
  203.     available from anywhere on your system.
  204.  
  205.  
  206. System Requirements:
  207.  
  208.     Exact system requirements vary from program to program.  Most need 
  209.     minimal memory: less than 160KB free, although some, like XDEL, can 
  210.     require considerably more depending upon the extent of the particular 
  211.     task being performed.  DOS version 3 or later on any IBM compatible 
  212.     provides a satisfactory operating environment.  A hard disk is 
  213.     recommended for practicality.
  214.  
  215.  
  216.  
  217.    
  218. Elements Common to All Programs:    
  219.     
  220.     Programs in "DOS Extensions for Professionals" share a common command 
  221.     line interface and are bound together several common threads.
  222.  
  223.  
  224. 1.  Recursive Notation
  225.     
  226.     The recursive (tree) notation "..." is supported by those commands 
  227.     for which it makes sense.
  228.  
  229.         XDIR  ...
  230.     
  231.     gives a listing of all files falling in the current directory and in 
  232.     directories under it.
  233.     
  234.  
  235. 2.  Truncatable Command Modifiers
  236.  
  237.     Command Modifiers are truncatable.  You don't have to enter the 
  238.     entire modifier, just enough to let the computer know what you want.  
  239.     If you want a directory listing sorted by date, you could enter
  240.     
  241.         XDIR  /byda
  242.     
  243.     and the program knows you mean
  244.     
  245.         XDIR  /bydate
  246.  
  247.     
  248. 3.  Explanatory Error Messages
  249.     
  250.     If you don't enter enough letters to be unambiguous, the program will 
  251.     list all possibilities.
  252.     
  253.         XDIR  /by
  254.     
  255.         Ambiguous Command Modifier "/by"
  256.             /bydate
  257.             /bysize
  258.  
  259. 4.  Built-in Help
  260.     
  261.     On-line help is always available by entering -HELP or /? on the command
  262.     line.  e.g.
  263.         XDIR  -HELP      or     XDIR  /?
  264.     
  265.     The four different levels of built-in help are discussed in the next 
  266.     section.
  267.  
  268.    
  269.     
  270. Built-In Help:
  271.  
  272.     Built-in help for each command is one of the more important aspects of 
  273.     "DOS Extensions for Professionals".  There are four levels of help.  
  274.     The first is the top level, and is accessed by entering a Command 
  275.     followed by -HELP or /?.
  276.     
  277.         SEARCH  /?
  278.  
  279.            or
  280.  
  281.         SEARCH  -HELP
  282.     
  283.            or
  284.     
  285.         SEARCH  -H
  286.     
  287.            or
  288.     
  289.         SEARCH  -HE
  290.     
  291.            etc
  292.     
  293.     gives you a list of the Command Modifiers for the SEARCH command:
  294.     
  295.         /before  /case  /context  /numbers  /pause  /since
  296.     
  297.     followed by a list of help topics associated with this command:
  298.     
  299.         -ALL    -HELP    -VERSION
  300.  
  301.     
  302.     The second level of help explains command detail and may, therefore, 
  303.     be the most important.  You can access it by inserting /?, -HELP, or
  304.     any other topic preceded by a "-" on the command line with any Command
  305.     Modifiers you may wish to learn about.
  306.     
  307.         SEARCH  /numbers  -HELP
  308.     
  309.     outputs the detailed description
  310.     
  311.     /numbers
  312.     /nonumbers  (d)
  313.     
  314.     /Numbers prepends each matched line with its line number in that file.
  315.     
  316.     /Nonumbers, the default, outputs only the line and not its number.
  317.     
  318.     
  319.     These first two levels of help embody the essence of the help 
  320.     philosphy of "DOS Extensions for Professionals".  The top level list 
  321.     of Command Modifiers reminds us of all that a command does while the 
  322.     second level reveals the details.
  323.     
  324.     Built-in help is also a great way to learn as you compute.  No need to 
  325.  
  326.  
  327.  
  328.  
  329.     master the details of all commands at once.  As you have time, scan 
  330.     the top level helps to learn new Command Modifiers or to reacquaint 
  331.     yourself with options that have slipped your mind.
  332.  
  333.     In case you can't remember the name of a command or want a more
  334.     detailed discussion of the design criteria of a command, there are two 
  335.     similar levels of help available from XHELP.   
  336.     
  337.     Entering
  338.     
  339.         XHELP
  340.     
  341.            or
  342.     
  343.         XHELP  -HELP
  344.     
  345.     gives you a list of all the commands found within "DOS Extensions for 
  346.     Professionals" plus several topics which refer to all commands:
  347.     
  348.         -BUG_REPORTING    -LICENSE    -MODIFIERS    -WILDCARDS
  349.     
  350.     (You may want to review these on-line background topics before delving 
  351.     into specific programs in depth.)
  352.  
  353.     You get the more detailed overview and discussion of each command by 
  354.     entering XHELP followed by a command or a general topic.  For example,
  355.     
  356.         XHELP  SEARCH
  357.     
  358.     lists SEARCH's Command Modifiers, examples of its use, and any notes 
  359.     pertaining to the command.
  360.     
  361.  
  362.     In review, the four levels of help are:
  363.     
  364.         Command  -HELP          (You know the command's name but not  
  365.                      all the Command Modifiers.)
  366.     
  367.         Command  /Command_modifier  -HELP       (You know the 
  368.                      command but want details about 
  369.                      one or more Command Modifiers.)
  370.     
  371.         XHELP                   (You want a list of all commands.) 
  372.     
  373.         XHELP  command          (You want an overview, examples, or 
  374.                      design information about a command.)
  375.     
  376.     If all else fails, all you have to remember is "XHELP".
  377.     
  378.     Complete help from any program can always be redirected to the 
  379.     printer or to a file for later printing by entering
  380.     
  381.         command  -ALL  /nopause  > prn
  382.  
  383.  
  384.  
  385.  
  386.  
  387.             or
  388.  
  389.         command  -ALL  /nopause  > file
  390.     
  391.     (/Nopause inhibits the normal pause after each screen full of 
  392.     information.)
  393.  
  394.  
  395. DOS 5 Compatible Help:
  396.  
  397.     The "DOS Extensions for Professionals" utilities also support the "/?"
  398.     help notation used in DOS 5.  This notation behaves exactly as the
  399.     "-HELP" notation.  You are free, for example, to type either "XDEL -h"
  400.     or "XDEL /?" for high level command help and "XDEL /secure -h" or
  401.     "XDEL /secure /?" for detailed command help.
  402.  
  403.     The DOS 5 command HELP gives one line explanations of all functions
  404.     including the "DOS Extensions for Professionals" utilities.  XHELP
  405.     gives one line explanations only for DOSX utilities.
  406.  
  407.     The support of the "/?" notation enables users to type "HELP XDEL" and
  408.     receive single-page high-level command help for a DOSX utility just as
  409.     they would for any system function.  Entering "XHELP XDEL" gives
  410.     examples and more detailed utility information in a multi-page format.
  411.  
  412.  
  413. DOS 5 Marco Command Redefinitions:
  414.  
  415.     DOS 5's macro support is a handy way to define or redefine your
  416.     favorite "DOS Extensions for Professionals" commands, or any other
  417.     command for that matter.
  418.  
  419.     If, for instance, you prefer XDIR's /FULL option, you could replace it
  420.     with DIR by defining the macro
  421.  
  422.         C:>  doskey  dir=xdir  /full
  423.  
  424.     either at the command line or in your AUTOEXEC.BAT startup batch file.
  425.     Then when you type DIR, you would get XDIR /FULL.  (The way to get the
  426.     real DIR command is to enter " DIR".)
  427.  
  428.     The down side of this technique, especially when working between many
  429.     machines, is that you're never sure what's which way on which
  430.     computer, and you may forget the full command syntax if you never use
  431.     it.  Sometimes plain vanilla is simpler unless you are in a position
  432.     to define strawberry to be vanilla everywhere.
  433.  
  434.     
  435. Program Highlights:
  436.  
  437. DIFF
  438.  
  439.     displays the differences between two similar text files.  Whether 
  440.     you've made minor or massive changes, DIFF displays only the 
  441.     differences while resyncing on identical text.
  442.  
  443.  
  444. DUMP
  445.  
  446.     displays the contents of binary files, directories, disk sectors 
  447.     (including an interpreted boot sector), disk FAT's, and cluster chains.
  448.  
  449.     Address the internals of any file by sector or byte. Search the FAT
  450.     for bad clusters, see what's really in your directories, and snoop
  451.     through deleted files.
  452.  
  453.     Learn about the details of the DOS file structure with the on-line
  454.     DISK_TUTOR and BOOT_TABLE help sections.
  455.  
  456.  
  457. SEARCH
  458.  
  459.     Locates text strings in any file anywhere on your whole disk - and only 
  460.     tells you when they've been found!  The simplicity of this favorite 
  461.     program belies its power and usefulness.
  462.  
  463.  
  464. SPLIT
  465.  
  466.     splits text files into pieces or segments by three methods. Specify the 
  467.     number of segments, the length of each segment, or that breaks be made 
  468.     only at lines containing specific search text.
  469.  
  470.  
  471. SUB
  472.  
  473.     substitutes characters in lines in text files.  This program deletes 
  474.     characters, adds characters, replaces tabs with spaces, and replaces 
  475.     spaces with any size tabs.  It strips trailing blanks from lines or 
  476.     pads out each line to a fixed length.
  477.  
  478.     SUB can also limit its operations to lines containing search strings
  479.     and anchor operations to that text.
  480.  
  481.     This utility is useful for dynamically creating complex batch and 
  482.     script files based on directory contents.  This is one of those 
  483.     utilities for which you may see no need - until you need it, and then 
  484.     it's indispensable.
  485.  
  486.  
  487. XDEL
  488.  
  489.     recursively deletes files and removes directories operating in either 
  490.     the default normal mode or in a secure overwrite mode.
  491.  
  492.  
  493.  
  494.     XDEL deletes hidden, readonly, and system files or files by date. 
  495.     Verification is available on the command, directory, or file levels as 
  496.     requested, or you can bypass all verification for batch operations.
  497.  
  498.     The secure overwrite mode is flexible, allowing you to specify the
  499.     number of overwrites and whether they are with random data or with
  500.     patterns of your own choosing.
  501.  
  502.     To a large extent, XDEL parallels XDIR in syntax and operation.
  503.  
  504.  
  505. XDIR
  506.  
  507.     recursively lists files in directory trees giving subtotals and 
  508.     grandtotals of file sizes and disk allocations.  (Bottom line 
  509.     enthusiasts can specify totals or grandtotals only - without file 
  510.     detail.) Directories are displayed in UPPER CASE and regular files in 
  511.     lower case for easy discrimination.  The default sort order is 
  512.     alphabetic unless you request ordering by file size or date.
  513.  
  514.     Searches can specify hidden, readonly, system, or modified files only,
  515.     and can limit the scope of a search before or after any time and date,
  516.     or use the generic keywords "yesterday" and "today".
  517.  
  518.     XDIR supports leading and multiple wildcards as do most "DOS Extensions 
  519.     for Professionals" utilities.
  520.  
  521.  
  522. XHELP
  523.  
  524.     supplements the help built into each command and becomes the first
  525.     stop for those not knowing where to look.  It contains a brief
  526.     description of each program in "DOS Extensions for Professionals" as 
  527.     well as examples, notes, and discussions of features common to all 
  528.     commands.
  529.  
  530.  
  531.     
  532. Legal Considerations:
  533.     
  534. Copyright:
  535.     
  536.     The collection of software described in this file and contained on 
  537.     this disk is the Shareware Version of "DOS Extensions for 
  538.     Professionals" (the Software) and is Copyright 1991 John B. Allison.
  539.  
  540. Ownership:
  541.     
  542.     You have purchased or otherwise obtained media containing a copy of 
  543.     the Shareware Version of "DOS Extensions for Professionals".  The 
  544.     Software contained on the media and all rights pertaining thereto 
  545.     remain the sole property of John B. Allison.  By continuing to use the 
  546.     Software, you indicate your acceptance of the terms and conditions 
  547.     outlined below.
  548.     
  549. Shareware License: 
  550.     
  551.     You are permitted to use the Software for an evaluation period of 
  552.     THREE WEEKS.  After the evaluation period, you must either remove all 
  553.     copies of the Software from your computer system(s) and refrain from 
  554.     all additional use, or register your copy of the Software with
  555.      
  556.                 Allison Software
  557.                  166 Shady Lane
  558.                    Apollo, PA 15613 USA
  559.     
  560.                  (412) 727-2198
  561.                   CompuServe 72600,1200
  562.     
  563.     (See the file REGISTER.DOC on the distribution disk for registration 
  564.     instructions.)
  565.  
  566. Shareware Distribution:
  567.     
  568.     You may give copies of the Software IN ITS UNMODIFIED ENTIRETY to
  569.     friends or to other parties.
  570.  
  571.     You may distribute copies of the Software IN ITS UNMODIFIED ENTIRETY
  572.     on a commercial basis for a fee not to exceed SIX DOLLARS (US), or you
  573.     may post the Software on electronic bulletin boards if you package the
  574.     Software so that it must be downloaded as a single unit IN ITS
  575.     UNMODIFIED ENTIRETY.
  576.  
  577. ASP Member:
  578.  
  579.     This program is produced by a member of the Association of Shareware
  580.     Professionals (ASP).  ASP wants to make sure that the shareware
  581.     principle works for you.  If you are unable to resolve a shareware-
  582.     related problem with an ASP member by contacting the member directly,
  583.     ASP may be able to help.  The ASP Ombudsman can help you resolve a
  584.     dispute or problem with an ASP member, but does not provide technical
  585.     support for members' products.  Please write to the ASP Ombudsman at
  586.     545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via
  587.     CompuServe Mail to ASP Ombudsman 70007,3536.  The OMB may be contacted
  588.  
  589.  
  590.  
  591.     by FAX by sending to the ASP FAX number: (616) 788-2765.  In communi-
  592.     cation with the OMB, please include a telephone number and/or FAX if
  593.     available.
  594.  
  595.  
  596. Limited Warranty:
  597.  
  598.     THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER 
  599.     EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED 
  600.     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 
  601.     THE ENTIRE RISK AS TO THE QUALITY AND PERFOMANCE OF THIS SOFTWARE IS 
  602.     YOURS.  SHOULD THIS SOFTWARE PROVE DEFECTIVE, YOU (AND NOT JOHN B. 
  603.     ALLISON, ALLISON SOFTWARE, OR AN AGENT) ASSUME THE ENTIRE COST OF ALL 
  604.     NECESSARY SERVICING, REPAIR, OR CORRECTION.
  605.  
  606.     SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE
  607.     ABOVE EXCLUSION MAY NOT APPLY TO YOU.  THIS WARRANTY GIVES YOU SPECIFIC
  608.     LEGAL RIGHTS, AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE
  609.     TO STATE.
  610.  
  611. Limitation of Remedies:
  612.  
  613.     IN NO EVENT SHALL JOHN B. ALLISON, ALLISON SOFTWARE, OR AN AGENT BE
  614.     LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION,
  615.     DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF
  616.     BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING OUT OF THE
  617.     USE OF OR INABILITY TO US THIS SOFTWARE, EVEN IF JOHN B. ALLISON OR
  618.     ALLISON SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  619.     
  620.     SOME STATES DO NOT ALLOW THE EXCLUSION OF LIABILITY FOR INCIDENTAL
  621.     OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY
  622.     NOT APPLY TO YOU.
  623.  
  624.     This agreement shall be governed by and construed in accordance with 
  625.     the laws of the Commonwealth of Pennsylvania and the applicable laws 
  626.     of the United States of America and shall inure to the benefit of John 
  627.     B. Allison dba Allison Software and any successors, administrators, 
  628.     heirs, and assigns.  Any action or proceeding brought by either party 
  629.     against the other arising out of or related to this agreement shall be 
  630.     brought only in a Commonwealth or Federal Court of competent 
  631.     jurisdiction located in Allegheny County, Pennsylvania.  The parties 
  632.     hereby consent to in personam jurisdiction of said courts.
  633.