;
                                   ZFILER.COM                                 

             Size (recs) CRC   Version    Author/Latest Issue      Disk
ZF10D4+       15k (118)  C204  1.0o       Carson Wilson 9/89       Z3COM13
ZF10D5        15k (114)  C26C  1.0o       Carson Wilson 9/89       Z3COM13
ZF10D5+       15k (118)  AAF1  1.0o       Carson Wilson 9/89       Z3COM13
ZF10R4        15k (114)  C459  1.0o       Carson Wilson 9/89       Z3COM13
ZF10R4+       15k (118)  299A  1.0o       Carson Wilson 9/89       Z3COM13
ZF10R5+       15k (118)  976B  1.0o       Carson Wilson 9/89       Z3COM13

  1- Command Summary  2- Configuration Options  3- Notes  4- ZFCNF.Z80        


   ZFILER is  an  enhanced  version of VFILER (follow-on to VF42B) designed to
take advantage of ZCPR 3.3 facilities.  It supports DateStamper, group macros,
and much more.
:1
ZFILER Command Summary:

                           -- Filer Commands --
       A - Alpha Sort   C - Copy   D - Delete   J - Jump     T - Tag  
       F - File Size    M - Move   P - Print    R - Rename   U - Untag
       W - Wild Tag     V - View   Y - Retag                         
    G - Group: Archive/Copy/Delete/Fsize/Move/Print/Reverse/Tag/Untag/View

         -- Misc --                         -- Cursor --
                               ^R  - Top of Screen       WS Diamond
     X - eXit ZFILER           ^C  - End of Screen          
     L - Login DU:/DIR:        ^T  - First File             ^E
     S - disk Status           ^B  - Last File               ^
     Z - ZCPR3 command        +/^F - Next Screen        ^S <-+-> ^D
     H - Help ZFILER          -/^A - Prev Screen             v 
     E - refresh scrEen      SP/CR - Next File              ^X
     O - Option toggles        BS  - Prev File              

                              -- Macros --
    # : Display Menu       ESC : Lead-in Char         0-9 : Direct Macros



Command-Line Constants:

     $    -  Macro parameter lead-in char            
     !    -  Shell wait indicator                    
     !    -  Parameter to indicate 'GO' substitution 
     C    -  Current display directory (DIR form)    
     D    -  Current drive letter                    
     H    -  Home DU (see fphdir for DIR form)       
     U    -  Current user number                     
     F    -  Filename.typ                            
     N    -  File name only                          
     T    -  File type only                          
     P    -  File entry being pointed to (du:fn.ft)  
     R    -  Home DIR (see fphdu for DU form)        
     #    -  Denotes comment area in macro file      
     '    -  Single quote for user input             
     "    -  Double quote for user input             
:2


Configuration options:

                           User-Customized Options

                   Query file replace on group archiving?
                   Query file replace on group copy/usq?
                   Query replace on single copy/usq?
                   Ask whether to verify copy/usq?
                   Verify default if no query?
                   Display $SYS files?
                   Display files in alpha order by name and type?
                   Set attributes on copied files?
                   Use attributes of destination if it exists?
                   ARC attribute always set for destination file?
                   Search path for CMD macro file?

                            Configuration choices

                   If not using path to find CMD file, use root?
                   If not cmdroot, fixed user area for CMD file
                   If not cmdroot, fixed drive for CMD file
                   Put group macro batch file in root directory?
                   If not batroot, fixed user for batch file
                   If not batroot, fixed drive for batch file
                   Reverse/low video?
                   Display file names in upper case (if CASEOPT)?
                   Separate DSEG for data?
                   Provide built-in help info?
                   Provide the (O)ption command?
                   File mask on shell stk (true) or fn4 (false)
                   Allow immediate 0..9 macro invocation?
                   Allow "Shell Installed" message?
                   Log in current dir with "Z" command?
                   Warmboot on exit?
                   Clear screen on exit?
                   Expand tabs on view, print?
:3
 ZFILER Notes - 1/6 

   a. ASCII headers have been placed in ZFILER with 'CONFIG' and 'OPT' to make
      it  easy  to locate the beginnings of option areas with ZPATCH for quick 
      manual patching.  

   b. Due  to the way Z3LIB's GETNAME routine is coded,  it is not possible at
      present to 'clone'  a version  of ZFILER  by setting  the option  bytes, 
      exiting, and then saving the image with the SAVE command. 

   c. Vs 1.0o improvements (9/21/89 Carson Wilson)
      -- implemented list capability for group macros.  If a ZFILER.CMD script
      begins  with  a  comma  (before  or  after  the  leading "!" shell pause 
      parameter), ZFILER will always  expand  the  macro  directly  to  ZCPR's 
      multiple command line.   In the case of a group macro, $P,  $F,  and  $T 
      parameters are expanded to a list of all tagged files,  separated by the
      character following the leading comma.   For example, the script
              x1 , !echo the tagged files are $F
      displays "THE TAGGED FILES ARE ", followed by a list of the tagged files
      separated by " " on the console (assuming ECHO is a valid ZCPR command).
      ZFILER then prompts for a keypress before returning.  
 ZFILER Notes - 2/6 

      Please note that this macro buffers  the entire list  of tagged files to
      CP/M's command line buffer, which  is  only  125 bytes in  length.   The
      above command therefore normally causes  a  "Command too long"  error if 
      more than  about  8 files  are  tagged,  depending on the lengths of the
      tagged names.
      -- made the escape character and  the characters  to  quote with it when 
      writing a group  macro command  to ZEX or SUBMIT files  installable (see 
      ZFCNFN.Z80 for details).  Escape character is currently "$",  and quoted
      characters are currently "$", "|", and "<", as required by ZEX vs 5.
      -- it is now  possible to answer ZFILER's  "Login [DIR][:MASK] "  prompt 
      with ".<cr>"  (same  as ":<cr>") to log  in  all  files  in  the current 
      directory.   Previously this  logged  in  all files  at user zero of the 
      current drive.   The Login  command  now  also  seems  to  accept ".afn" 
      instead of ":afn".
      -- shell bit set while waiting for user commands, then immediately reset
      when a command key is received.  This should allow Bridger Mitchell's AT
      command scheduler  RSX to  interrupt  ZFILER as  it  would the CCP while 
      ZFILER is prompting for commands.
 ZFILER Notes - 3/6 

      -- fixed bug which prevented  any Group commands from operating when the
      configuration byte MACFLAG was patched to false.
      -- removed code which attempted to use the ZCPR Environment to determine
      how many lines of text to  display with  the V command, as this was only 
      partially implemented, resulting in difficulty on terminals with over 24
      rows.  Text lines now  hard-coded to 22,  so ZFILER  should  work on any 
      terminal with 24 or more screen rows.
      -- fixed  small  bug   which  caused  "Public  File  Error"  message  to 
      disappear.
      -- control-I is now an alias for control-J (jump to file again), for use
      with terminal  definitions (TCAPs) which  define  control- J as an arrow
      key.
      -- idea for  future versions: it would  be  very difficult to allow file
      ring sorting based on file dates (would need to  store  date stamps with
      ring, requiring major rewrite).   It would be relatively simple to allow
      the Login and startup commands to accept and match files to  a datespec,
      though...
 ZFILER Notes - 4/6 

   d. Vs 1.0n improvements:
      -- $* script parameter was added to clear the screen during, and rebuild
      it after  a script prompt.   Usage is $"$*..text.."  Prompt text appears 
      at top of a cleared screen.
      -- In anticipation of ZEX 4.0x,  '$' and '|' are now the only characters
      which are quoted  when  ZFILER  builds  the  ZFILER.ZEX  file.   If they 
      appear in a  ZFILER.CMD script  these  chars  are quoted with  a leading
      dollar  sign when  ZFILER.ZEX is built.   All other chars are passed 'as
      is' to the ZEX file.   This  means  that  you cannot  use ZEX directives
      such as $1, |crlf|, etc., dynamically.
      -- for efficiency, ZFILER no longer resets disks under Z3PLUS.
 ZFILER Notes - 5/6 

   e. Vs 1.0m improvements:
      -- Copy and Move commands now work properly with Z3PLUS, and the current
      12-hour time shows at the top of the screen under Z3PLUS.
      -- Path file conflicts are no longer reported under ZSDOS (this produced
      problems  when  users  tried  to  backup  directories  along  the path).  
      ZSDOS public conflicts are still reported.
      -- Group Move and  Group Copy error messages are now sustained until the 
      user strikes a key, rather than disappearing immediately.
      -- Prompts in scripts may now contain control chars as  "^x"  where x is 
      any char from @ to z.
      -- The dollar sign is now  an "escape char" for script prompts,  and can 
      be used to include the $, ^, and ' characters in prompts.   Examples:
            Script                           Result
            $"Enter name or $^C: "           Enter name or ^C:
            $"Type $"//$" for help: "        Type "//" for help:
      -- Move and  Group Move  now use the  option menu selections when moving
      files instead of always copying file attributes.
      -- Cleaned up help screen.
 ZFILER Notes - 6/6 

   f. Vs 1.0l improvements:
      -- the unsQueeze command was removed to reduce program size.   Since few 
      files  are  squeezed  and  UNCRUNCH   supports  unsqueezing,  it   seems 
      preferable to export this  function by  calling UNCRUNCH  with  a ZFILER
      macro.  ZFILER will still display and print squeezed files.
      -- if a DateStamper (BDOS function 12) real-time clock is available, the
      current 12-hour time is printed  to the left  of  the ZFILER name at the 
      top of the screen.   Copy/Move/Archive also  use ZSDOS's  more efficient 
      Get Stamp  and  Set Stamp  function calls  to  preserve file  datestamps 
      across copies.   The older method  of datestamping is retained more non-
      ZSDOS systems.
     -- ZFILER checks for and reports  Public  or Path conflicts when Copying, 
      Renaming, Moving  and Archiving  files under ZSDOS.   Files created with
      Copy/Move/Archive  are  always  set  to  Private  (high bit of f2=0)  to 
      avoid possible ZSDOS Public conflicts.
     -- the environment address is loaded  from location  109  at run time for 
      compatibility with ZCPR 3.0 systems.
     -- if  running ZSDOS  or ZDDOS,  disk resets are skipped for all commands 
      except Space. 
:4


                                 ZFCNFN.Z80 

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               9k (72)   DE2D  1.0o       Carson Wilson 9/89       Z3COM13
==============================================================================


   ZFCNFN.Z80 is an overlay which can  be used  to set the configuration bytes
in  ZFILER.COM.   The file  should  be  edited,  assembled to  a HEX file  and 
overlayed using the command:

             MLOAD ZFNEW=ZFILER.COM,ZFCNFN