home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / c / cktsr103.zip / CHKTSR.DOC < prev    next >
Text File  |  1992-12-21  |  7KB  |  177 lines
  1.                                   CHKTSR 1.03
  2.                                   -----------
  3.  
  4.         Function
  5.         --------
  6.         CHKTSR tells you whether or not a specific program is currently
  7.         resident in memory.  An errorlevel is returned for use in batch
  8.         files.  CHKTSR may be useful in situations where a batch file or
  9.         other process requires that certain programs, primarily TSRs, be
  10.         resident (or not resident).  DOS 3.0 or later is required.
  11.  
  12.         Version 1.03 simply improves CHKTSR's ability to find programs
  13.         loaded high under DOS 5.0.
  14.  
  15.  
  16.         Use
  17.         ---
  18.         To determine whether or not a program is present in memory, use
  19.  
  20.             CHKTSR name [/E]
  21.  
  22.         where "name" is the name of the program you're interested in.
  23.         Use only the primary file name--don't include a drive, path, or
  24.         extension.  If the optional switch /E is present, CHKTSR only
  25.         returns an errorlevel; there is no display.
  26.  
  27.         For example, to determine if the program "MYTSR" is loaded:
  28.  
  29.             CHKTSR mytsr
  30.  
  31.         CHKTSR will attempt to determine whether or not MYTSR is
  32.         currently loaded.  It will then display one of the following:
  33.  
  34.             Program MYTSR not found
  35.             Program MYTSR found at segment xxxx
  36.  
  37.         where xxxx is the hexadecimal segment number where the program
  38.         was found (its PSP, or Program Segment Prefix address).  If
  39.         the program was loaded more than once, multiple copies of the
  40.         "found" message will appear, one for each loaded copy.
  41.  
  42.         Remember that CHKTSR won't display anything if you use /E:
  43.  
  44.             CHKTSR mytsr /e
  45.  
  46.         Only the errorlevel will be returned.
  47.  
  48.  
  49.         Errorlevels
  50.         -----------
  51.         CHKTSR will return one of the following errorlevels:
  52.  
  53.             0       Program not found
  54.             1..253  Found this many copies of program
  55.             254     Error found in DOS's memory control block chain
  56.             255     Usage error or incompatible DOS version (2.x)
  57.  
  58.  
  59.         Use in batch files
  60.         ------------------
  61.         Here is a skeleton batch file that demonstrates how to use the
  62.         returned errorlevel correctly:
  63.  
  64.             chktsr mytsr /e
  65.             if errorlevel 255 goto usage
  66.             if errorlevel 254 goto oops
  67.             if errorlevel 1 goto present
  68.             rem
  69.             rem MYTSR is not present
  70.             ...
  71.             :PRESENT
  72.             rem MYTSR is loaded at least once
  73.             ...
  74.             :OOPS
  75.             rem Your memory is hosed up, DOS is going to crash.
  76.             rem Not very likely to occur in this context.
  77.             ...
  78.             :USAGE
  79.             rem Error in CHKTSR usage, or DOS 2.x
  80.  
  81.  
  82.         "High DOS" loaders
  83.         ------------------
  84.         If you use one of the "high DOS" program loaders on your 386
  85.         system (for example, 386LOAD with Qualitas's 386Max or LOADHI
  86.         with Quarterdeck's QEMM), CHKTSR will not work unless the blocks
  87.         of memory allocated for the high-loaded program are included in
  88.         the DOS memory chain.  For example, CHKTSR will not work for
  89.         high-loaded programs under 386Max unless you first run
  90.  
  91.             386LOAD OPENHIGH
  92.  
  93.         You can check this by running our free PMAP program.  If you
  94.         have loaded programs in high memory and they do not show up in
  95.         PMAP's display, then CHKTSR won't find them either.
  96.  
  97.  
  98.         DOS versions
  99.         ------------
  100.         Under DOS 3.0, CHKTSR may not be 100% reliable.  It should never
  101.         indicate that a program is present when it is not, but there can
  102.         be situations where a program that IS present is reported as
  103.         "not found."  This will generally occur when a TSR has released
  104.         its copy of the DOS environment.  To be sure that CHKTSR works
  105.         with a given program, run it once when you are certain that the
  106.         program is present.  Chances are that the error will be
  107.         consistent--if CHKTSR works once with the program, it will
  108.         probably always work.
  109.  
  110.         You can also check with our free PMAP program, using the /D
  111.         (Detail) option.  If PMAP does not show that the program you're
  112.         interested in has an environment block, then CHKTSR won't be
  113.         reliable with that program.
  114.  
  115.         CHKTSR should be quite reliable under DOS 4.0 or later, and it
  116.         will not run at all under DOS 2.x (which provided no facilities
  117.         for this sort of thing).
  118.  
  119.  
  120.         Revision history
  121.         ----------------
  122.         Version 1.03 12/21/92
  123.             Improved compatibility with DOS 5.0.
  124.  
  125.         Version 1.02 08/31/89
  126.             Name search is now case-insensitive.  DOS always stores
  127.             program names in uppercase, but some aftermarket program
  128.             loaders apparently do not.  Should affect DOS 4.x users
  129.             only.
  130.  
  131.         Version 1.01 05/17/89
  132.             This version simply implements everything as stated in
  133.             this documentation file.  We originally released an earlier
  134.             development version of the program, mislabeled as 1.00.
  135.             Our apologies...
  136.  
  137.  
  138.         Copyright/License/Warranty
  139.         --------------------------
  140.         This document and the program CHKTSR.COM are copyrighted by the
  141.         author.  The copyright owner hereby licenses you to: use the
  142.         software; make as many copies of the program and documentation
  143.         as you wish; give such copies to anyone; and redistribute the
  144.         software and documentation via electronic means.  There is no
  145.         charge for any of the above.
  146.  
  147.         You may not charge or request donations for redistribution of
  148.         any such copies, however made; and you may not distribute the
  149.         software and/or documentation with commercial or sharware
  150.         products without prior permission in writing from the copyright
  151.         holder.  An exception is granted to recognized user's groups,
  152.         which are authorized to charge a small fee for composite disks
  153.         which may contain CHKTSR, as long as the fee is intended to
  154.         cover the costs of materials, handling, postage, library
  155.         maintenance, etc., and is charged on a per-disk rather than a
  156.         per-program basis.
  157.  
  158.         No copy of the software may be distributed or given away without
  159.         this document; and this notice must not be removed.
  160.  
  161.         There is no warranty of any kind, and the copyright owner is not
  162.         liable for damages of any kind.  By using this free software,
  163.         you agree to this.
  164.  
  165.         The software and documentation are:
  166.  
  167.                            Copyright (C) 1989,1992 by
  168.  
  169.                              Christopher J. Dunford
  170.                             The Cove Software Group
  171.                                  P.O. Box 1072
  172.                           Columbia, Maryland 21044-0072
  173.  
  174.                                  (410) 992-9371
  175.                              CompuServe: 76703,2002
  176.                        Internet: 76703.2002@compuserve.com
  177.