;
                                   ZMANG.COM                                  

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              12k (91)   5FE7  2.1d       Bob Peddicord 11/88      Z3COM13

  1- Syntax/Options  2- Parameter Summary  3- Notes                           



   ZMANG is a File MANaGer utility based on Richard Conn's VMENU.   A built-in 
help  screen displays all control characters used.   SETZCMD is used to change 
options and controls.  
:1

              Syntax:  ZMANG    <-- MENU.VMN must be on command path

Configurable Options:  Display $SYS files

                       Display amount of free space

                       Display size of program

                       Allow renaming files

                       Allow deleting files

                       Sort by type 


                   Controls Changeable in Options:
                    
^N - change directory                 ^C - exit
^A - alpha switch                     ^F - file size
^T - top of screen                    ^K - delete file
^B - bottom of screen                 ^R - rename file
^P - previous screen                  ^N - next screen
 - - alt previous screen               + - alt next screen
^G - jump to filename?

                   Other controls
^E - cursor up                        ^X - cursor down
^S - cursor left                      ^D - cursor right
                  ^Z - Command line
:2


Parameter Summary:


format	'f'	=	H   hex			D   3 decimal
			F   floating decimal	T   two decimal
						O   one decimal

module	'm'	=	B   BIOS		M   MSG
			C   CCP/CPR		N   NDR
			D   DOS			P   PATH
			E   ENV			R   RCP
			F   FCP			S   SHL
			I   IOP			X   XFCB
			L   MCL



Parameter Summary (continued):


component  'c'	=	N   FN			D   drive or default
			T   FT			U   user or default
			F   FN[.FT]		C   current file

units	'u'	=	Y  year			H  hour (mil)
			M  month		C  hour (civ)
			D  day			N  minute
						A  AM/PM


Parameter Forms:

   $Tc            parsed token
   $Hd            home DIR
   $Hr            home DU
   $"             user input
   $'             alternate user input
   $P             Current file, complete spec DU:FILENAME
   $Du            Date/Time
   $&             Menu change (external)
   $:             Menu change (internal)
   $Sc#           System file
   $Am            ENV address
   $+m            ENV offset address
   $@fAm          ENV address content
   $@f+m####      ENV offset content
   $Mf####        memory contents
   $Rf##          register contents
:3
      
ZMANG Notes:

   a. When ZMANG  is  first  invoked,  the current directory and any requested 
      directory and  file mask included as a parameter on the command line are 
      stored in the  shell  stack entry.  The  two  directories  are stored in 
      binary form  as  used by the SYSLIB routines.  This avoids  any problems 
      with recognizing DU  and forms  and with returning to a directory with a 
      password.  Once  one  has  been  admitted  to  a  directory,  subsequent 
      accesses are automatic.  By keeping  the original DU on the shell stack,
      ZMANG can  return  to  the directory from  which  the user invoked it no 
      matter how many  other  directories were  subsequently  logged in as the 
      result of macro executions or 'Z' commands.

   b. In the past, after  executing  a  command line from the 'Z' command, the 
      shell wait flag was always set and  one  was always greeted by a 'strike 
      any key' prompt before returning to ZMANG.   Now, if you enter a command
      starting with a space, shell  waiting  will  be  disabled  and  you will 
      return directly to ZMANG without any delay.   The command line is parsed
      just like the menu  display and menu controls,  so you can  use all  the 
      built-in formats.


ZMANG Notes (continued):

   c. To  be  consistent with  all  other script-building programs, '$' is the
      macro parameter designator.  '$P' is  used  for the currently pointed-to
      file and '$$' is needed for a dollar sign.

   d. The macro line is  expanded  in  three steps.   First, any prompted user
      input is processed.   This is initiated  by the parameters $" or $' that
      begin the prompt text.  Expanding user input first allows the user to be
      prompted to enter a MACRO LINE,  including  parameters.  The second step 
      is the substitution  for  all  parameters  that  do  not  depend  on the 
      pointed-to file.  This part  of  the  expansion is done for both regular 
      and group macros.   The final  step  is  the substitution for parameters 
      that depend on the file pointed to.

   e. ZMANG macros run  from  the  home directory.  If commands can accept DU: 
      prefixes, then the $P parameter can be used.  Alternatively, one can log
      into the currently displayed directory using $d$u: and return home using
      $h:. 


ZMANG Notes (continued):

   f. ZMANG has  the  capability  of  using A..Z, 0..9 and any and all special 
      characters as menu choices.  

   g. The menu number which ZMANAGER stores is  a full word (2 bytes)  and can
      be stored anywhere in memory.   Just change the two bytes after CTRLS in
      the program to whatever location you want (remember low byte first).

   h. Vs  2.1a  provides  ZCPR33/34 compatibility  and  includes  support  for 
      DateStamper.  If DS is present,  the time and date are displayed  in the 
      header.   Also,  the  filemask  is now placed in  the shell stack.  This 
      leaves the program using just system file 2 and 3 and leaves 1 and 4 for
      the user to use. 


ZMANG Notes (continued):

   i. Vs 2.1b restores the WS diamond (now an option) and  fixes  a bug  which 
      caused the pointer to not return to the pointed file.   Now it will find
      the file  no matter what system bit  is set.   ZMANAGER is now stored on 
      the shell stack  like ZFILER/EASE (thus,  DU: is first,  then the name).
      Problems with renaming have also been fixed; ZMANAGER now knows its name
      no matter what you name it.

   j. Vs 2.1c provides more DateStamper support  by allowing the  cursor to be
      turned on and off.   If set,  cursor is turned off  on entry  and turned
      on on exit.   There are two patch points to put in excape sequences.  If
      this is not wanted, just make sure null is first char.

   d. Vs 2.1d logs into drv/user the way it should.  Also changes back to menu
      #1 when the menu name is changed.