;
                                 RESOLVE.COM                                  

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               3k (20)   6A72  1.4        H. Goldstein 8/89        Z3COM5

  1- Usage  2- Notes  3- Examples of Use                                      


   RESOLVE will resolve  a multiple-command  line passed to  it and place that
command line in  the Multiple-Command Line Buffer in memory.   It will resolve
references to shell variables, registers, and System File names.
:1
 Usage 

   RESOLVE recognizes the following flags:

   %<text>           Shell variable name.
   $R<n>             Register number.  (n = 0-31)
   $D                Current disk letter.
   $U                Current user number.
   $F<n>             System File name.  (n = 1-4)
   $N<n>             System File name, chars 1-8 only.  (n = 1-4)
   $T<n>             System File name, extension only.  (n = 1-4)
   $|                Substitute multiple-command separator.

   The QUIET flag  is  adhered  to;  the program  will not  print its  sign-on
message or error messages if the QUIET flag is set.

   If there is no room for the command-line generated,  the ERROR flag will be
set,  and an error message may be printed,  depending upon  the  state  of the 
QUIET flag.  Uninterpretable '$' parameters will also set the error flag. 
:2
 RESOLVE Notes - 1/2 

   a. Version 1.4 updates:
      - Removed all checking of quiet flag.  Program banner now only displayed
        when help requested.   Error handler is  now invoked  on  command line 
        overflow.   Error flag now  set on  unresolved shell variables and the 
        leading '%' is no longer  returned in that case.   Editing on register 
        numbers  for the  $r flag has  been  tightened  up.   Code  cleaned up 
        somewhat; now requires version 4 SYSLIB and Z3LIB.  This is now a type
        3 program but I do not recommend linking it  for high-memory execution 
        since the Z3VARLIB routines don't check for top of TPA.

   b. Version 1.3 updates:
      - Changed to allow register references up to register 32 (0-31).

   c. Version 1.2 updates:
      - Fixed register expansion so it doesn't clobber nesting depth stored in
        B.  Changed program banner to read "1.2"
 RESOLVE Notes - 2/2 

   d. Version 1.1 updates:
      - Fixed error in which a shell variable reference in the first character
        of another shell variable wasn't being expanded.  Also changed so that
        a single '$', when followed by an unrecognized flag, is not dropped.
:3
 Examples of Use 

   a. HELP:;ROOT:dir14 *.hlp h;ROOT:quiet s;ROOT:getvar ghelp enter   <<
      desired help file by name -;ROOT:resolve hlp %ghelp;ROOT:quiet r;$d$u:

      - 'GH' (Get Help) alias defined in Z-NEWS #507 (11 Aug '86):

      Log into HELP directory and run DIR14 from ROOT: directory on help files
      with mask to show files of type HLP.   Go into  quiet mode  to  suppress
      utility  headers  and messages.   With files  showing on screen,  prompt
      operator for one to use,  "enter desired help file  by name - ".  GETVAR
      places  operator's response into variable  name 'ghelp' which is located
      automatically in ROOT file SH.VAR.   RESOLVE sets up main command string
      consisting  of HLP  (HELP53.COM renamed) followed  by  expanded  'ghelp'
      variable (operator's  chosen  HLP file).   Reset quiet  flag  for normal
      operation and log back into original directory.  
