home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / DOS_HELP / ENVCAT12.ZIP / ENVIRCAT.DOC < prev    next >
Encoding:
Text File  |  1990-11-27  |  2.9 KB  |  71 lines
  1. envircat.exe v1.2
  2.  
  3. environment string concatenation
  4. 11-27-90 Mark Gardner
  5. c1990 Mark Gardner
  6. (released to public domain)
  7.  
  8. operates on PREVIOUSLY loaded string elements in the environment, flagged
  9. as described below, and concatenates them together into a single string.
  10.  
  11. USAGE:
  12.  
  13.     1) use PATH or SET commands to load into the environment, strings
  14.        that will be concatenated.  The first of these should have the
  15.        name that the ultimate string will have, e.g.:
  16.  
  17.         PATH=c:\;\;c:\utils
  18.  
  19.        The subsequent strings must be loaded immediately after the
  20.        first, and have the essentially the same name as the first,
  21.        except that the name must start with a '+' character.  If
  22.        there is more than one subsequent string, trailing characters
  23.        must be added to distinguish them (for the sake of the SET
  24.        command... envircat doesn't care, it only checks the characters
  25.        after the '+' for the target name), e.g.:
  26.  
  27.         SET +PATH1=;c:\brief;c:\dos;
  28.         SET +PATH2=d:\procomm
  29.  
  30.        Note: envircat will not add characters to the string -- hence,
  31.        in this example, the semi-colon separators are included in one
  32.        string or the other.
  33.  
  34.        Additional strings may be loaded into the environment before
  35.        or after the set to be concatenated.  There may be multiple
  36.        sets for concatenation.  Envircat does not need to be invoked
  37.        at any particular time, although doing so will remove the
  38.        'trigger' names from the environment, thereby freeing some room.
  39.  
  40.     2) invoke envircat, no arguments are needed.  If envircat can find
  41.        the environment (see source file headers for methods), it will
  42.        concatenate the strings and give a report somewhat like this:
  43.  
  44.         environment string concatenation : ENVIRCAT v1.2
  45.         c1990 Mark Gardner (placed in public domain)
  46.  
  47.         envircat found environment at 0E5F:0010
  48.         envircat found 2 continuations
  49.  
  50.        If it can't find and verify the environment (by checking for
  51.        at least two equal signs before a terminating double nul)
  52.        it will report that it can't and safely go away.  The max
  53.        check length is 2048.
  54.  
  55.     3) envircat can be invoked anytime, even with no intent to
  56.        concatenate strings; it will merely report the location
  57.        of the environment, since it will contain no trigger
  58.        words anymore.
  59.  
  60. envircat was inspired by a program 'LONGEST' available on CompuServe IBMSYS,
  61. written by a fellow named Pete Maclean.  It didn't work locally because it
  62. was pre-DOS3.3, evidently.  The current version of envircat (v1.2) has been
  63. tested on DOS 2.11, 3.10, 3.20, and 3.30.
  64.  
  65.     The distribution file is currently named ENVCAT12.ZIP.  The intent
  66.     is that this entire package be in the public domain.  A portion of
  67.     the work is from an article by Robert Scott Ladd, credits given in
  68.     the file ENV_ADRS.ASM.  The source code has been included in the
  69.     distribution file.  Bug reports or comments can be sent to Mark
  70.     Gardner CompuServe 75076,2552, or to P.O. Box 149, Acton, CA 93510.
  71.