home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / get261up.zip / GET-READ.ME < prev    next >
Text File  |  1993-12-22  |  10KB  |  162 lines
  1.   GET-READ.ME            GET Version 2.6          Copyright 1993 Bob Stephan
  2.  
  3.   READ.ME
  4.  
  5.     GET.EXE is a general purpose DOS BATch file enhancer.  It makes informa- 
  6.       tion available to BATch files through the BATch 'IF' subcommand.  The 
  7.       information can come from user input or from the operating system, and 
  8.       it is made available to the BATch file through the DOS ErrorLevel (Exit 
  9.       Code) and variables in the DOS master Environment. GET also has capabil- 
  10.       ities to set some system parameters and perform a few other specific ac- 
  11.       tions, over 40 functions in all.  Not only is GET wonderful for automat- 
  12.       ing your personal system, it is excellent for client support and soft- 
  13.       ware installation programs.  If these terms are not familiar to you,
  14.       you will find them fully described and explained in the 80 page manual.
  15.       You will also be interested in the information in GET26NEW.DOC to help
  16.       focus on the new and improved features.
  17.  
  18.     One BATch file that just about every PC user has some familiarity with
  19.       is AUTOEXEC.BAT.  Have you ever felt the need to be more creative
  20.       in what your AUTOEXEC.BAT or other BATch files can be made to do?
  21.       That is the purpose of BATch enhancers, such as GET.EXE.
  22.  
  23.     The BATch programming language is a simple language.  The DOS manual
  24.       describes only 8 subcommands specific to BATch files.  This makes it
  25.       very easy to program simple BATch files - much easier than, say,
  26.       spreadsheet macros or database programs.  At the same time BATch does
  27.       not support many of the more interesting things we would like to be
  28.       able to do in BATch files.  That is where GET comes in.
  29.  
  30.     GET makes it possible to do many more interesting things in your BATch
  31.       files than is possible with plain DOS.  GET has over 40 functions that
  32.       are useful in BATch files, so it can replace a multitude of small BATch
  33.       file utilities, thus saving disk space.  Each BATch file will probably
  34.       use only a few features, but as you become familiar with the power of
  35.       GET you will find more and more uses for all the features.
  36.  
  37.     The functions available in GET.EXE fall into three general categories:
  38.     The √ mark indicates functions that are new or enhanced in Version 2.6.
  39.  
  40.       1. Keyboard and Screen Input and Output
  41.       2. Disk and File Information
  42.       3. Memory and System Information
  43.  
  44.     Some of the many things you can do with the Keyboard and Screen I/O are:
  45.  
  46.     √ Echo text to the screen in color or reverse video.  Echo ANSI.SYS
  47.          or printer commands without a carriage return at the end.
  48.       Display a custom prompt, optionally in color or reverse video, and get
  49.          keyboard input.  The prompt can even be displayed as a line of text
  50.          moving across the bottom line of the screen to attract attention.
  51.     √ Obtain keyboard input for menu selection, yes/no answers, USER IDs and
  52.          passwords, just to mention a few, then take appropriate action
  53.          depending on what was entered.  You can control the length, valid
  54.          characters, case, length of time to wait for input, and other 
  55.          characteristics of what is to be entered.
  56.     √ Manipulate character (string) information to extract substrings, 
  57.          control the case, measure the length, provide input to other 
  58.          programs, trim leading and/or trailing blanks, and/or write 
  59.          the information to files.  
  60.     √ Clear the screen with full control of background and foreground color,
  61.          automatically adjusting for the number of lines of text on the
  62.          screen such as 43 for VGA or 50 for EGA.
  63.     √ Arithmetic - add or subtract two numbers to make a loop counter,
  64.          create sequential file names, or simply convert a numerical
  65.          Environment variable into an ErrorLevel.  Use ASCII characters
  66.          or hexadecimal numbers in arithmetic.  In addition to the usual
  67.          four arithmetic functions, you can do modulo arithmetic or
  68.          compare two numbers.
  69.  
  70.     Some of the many things you can do with the Disk and File functions are:
  71.  
  72.     √ Your BATch file can find out how large a file is, or how much space
  73.          is available on a disk.  Decisions can be programmed based on this
  74.          information, for example, to do a COPY only if enough free space
  75.          is available, or to verify that a directory exists.
  76.     √ Obtain the date and/or time a file was created or last modified.
  77.     √ You can determine whether a formatted disk is available in a floppy 
  78.          drive, and determine its size without getting the dreaded "Abort,
  79.          Retry, Ignore" critical error message.
  80.       Your BATch file can check the volume label of a disk and take 
  81.          appropriate action based on which disk has been inserted in the
  82.          drive.  You can check that the correct backup, installation, data,
  83.          or program disk has been inserted, for example.
  84.       You can determine which device drivers were loaded in a CONFIG.SYS file
  85.          and have your AUTOEXEC.BAT automatically make decisions about which
  86.          programs to run depending on the system configuration. 
  87.       Your BATch file can obtain and store the current drive and directory
  88.          so it can return there after performing an action or running a
  89.          program in a different drive or directory.
  90.       You can extract the first line of a file and use it as a string, 
  91.          or redirect information from other sources into the Environment
  92.          where it will be available for manipulation by your BATch file.
  93.  
  94.     A few of the many things you can to with the Memory and System 
  95.          functions are:
  96.  
  97.     √ Get date and time information to use to control when to run other
  98.          programs, to time stamp information in files, to display on the
  99.          screen or for many other purposes.
  100.     √ Check the DOS version for programs that are sensitive to it.
  101.     √ BATch files can find out how much memory is available, how much
  102.          Environment space is left, what video attributes and modes are in
  103.          use, whether a math coprocessor is available, and whether the CPU
  104.          is an 8086, 80286, or 80386 (among other things).  Many BATch 
  105.          programming decisions can be based on such information.  Additional,
  106.          checks are whether ANSI.SYS has been loaded, or whether Microsoft
  107.          Windows, 4DOS, or DESQview is running.
  108.     √ Your BATch file can check to see if a printer is available and ready
  109.          and determine whether to print or not automatically.  It can even
  110.          turn off Print Screen to avoid accidental hang-ups if no printer
  111.          is currently on-line.  Also check other hardware featrues 
  112.          such as the ROM BIOS model and date.
  113.     √ Execute another program under control of GET and place its Return
  114.          Code in the Environment for later use.
  115.     √ You can even have your BATch file reboot your computer with either a
  116.          warm or cold boot, for example to change the configuration.
  117.          
  118.     Over 80 pages of documentation not only describe these and other features
  119.        in detail, it also gives many examples and BATch programming hints.
  120.  
  121.     LICENSING SUMMARY
  122.  
  123.     GET is copyrighted software and is not in the public domain!  GET is not 
  124.       totally free for all users, and there are conditions imposed on its dis- 
  125.       tribution.  Please read this information and the section on Licensing 
  126.       and Distribution to be sure you are not using GET illegally.  The only 
  127.       version of GET that is shareware is the one that displays the help screen 
  128.       when the name GET is entered at the DOS prompt by itself.  If you have 
  129.       one that says it is licensed and you have not registered, you have a 
  130.       pirated copy that is protected by law.
  131.  
  132.     VENDORS, CORPORATE, and COMMERCIAL users see licensing terms in the
  133.       file ORDER.GET.
  134.  
  135.     INDIVIDUALS, SHAREWARE AUTHORS, and SYSOPS.  GET.EXE may be freely 
  136.       copied and distributed provided that all files in the GET26.ZIP 
  137.       package are included on the disk or in the compressed file with 
  138.       GET.EXE.  Contributions to support this development project will 
  139.       be gratefully accepted.  If you use GET and can't send money, at 
  140.       least send thanks.
  141.  
  142.     If you send $15 or more (plus Shipping & Handling) you will receive the 
  143.       following benefits: (California residents please add 7.25% sales tax).
  144.  
  145.       The latest version of GET with any new features, including the 
  146.          full manual on disk.
  147.       A smaller runtime version to distribute with your BATch files.
  148.       A single user license with no royalties for non-commercial use of the 
  149.          runtime version.
  150.       Eligibility to purchase a >80 page user manual giving examples and 
  151.          detailed explanations.
  152.       Free support by BBS, mail, phone, CompuServe, or Prodigy (see below).
  153.       Notification of new releases and upgrades when available.
  154.  
  155.     See additional purchase and licensing information in the order form 
  156.       file ORDER.GET.
  157.  
  158.     If you have any questions, comments, or suggestions please contact us at:
  159.           MOBY DISK: 1021 San Carlos Road, Pebble Beach, CA 93953
  160.       Phone: (408) 646-1899/1373.    PRODIGY:FNGC05A    COMPUSERVE:72357,2276
  161.       BBS: The Cricket 408-373-3773       /s/ Bob Stephan  December 22, 1993.
  162.