home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ENTERPRS / CPM / UTILS / S / ZCPC02.ARK / HLPFILES.LBR / ZFILER.HZP / ZFILER.HLP
Text File  |  1989-09-24  |  12KB  |  227 lines
  1. ;
  2.                                    ZFILER.COM                                 
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. ZF10D4+       15k (118)  C204  1.0o       Carson Wilson 9/89       Z3COM13
  6. ZF10D5        15k (114)  C26C  1.0o       Carson Wilson 9/89       Z3COM13
  7. ZF10D5+       15k (118)  AAF1  1.0o       Carson Wilson 9/89       Z3COM13
  8. ZF10R4        15k (114)  C459  1.0o       Carson Wilson 9/89       Z3COM13
  9. ZF10R4+       15k (118)  299A  1.0o       Carson Wilson 9/89       Z3COM13
  10. ZF10R5+       15k (118)  976B  1.0o       Carson Wilson 9/89       Z3COM13
  11.  
  12.   1- Command Summary  2- Configuration Options  3- Notes  4- ZFCNF.Z80        
  13.  
  14.  
  15.    ZFILER is  an  enhanced  version of VFILER (follow-on to VF42B) designed to
  16. take advantage of ZCPR 3.3 facilities.  It supports DateStamper, group macros,
  17. and much more.
  18. :1
  19. ZFILER Command Summary:
  20.  
  21.                            -- Filer Commands --
  22.        A - Alpha Sort   C - Copy   D - Delete   J - Jump     T - Tag  
  23.        F - File Size    M - Move   P - Print    R - Rename   U - Untag
  24.        W - Wild Tag     V - View   Y - Retag                         
  25.     G - Group: Archive/Copy/Delete/Fsize/Move/Print/Reverse/Tag/Untag/View
  26.  
  27.          -- Misc --                         -- Cursor --
  28.                                ^R  - Top of Screen       WS Diamond
  29.      X - eXit ZFILER           ^C  - End of Screen          
  30.      L - Login DU:/DIR:        ^T  - First File             ^E
  31.      S - disk Status           ^B  - Last File               ^
  32.      Z - ZCPR3 command        +/^F - Next Screen        ^S <-+-> ^D
  33.      H - Help ZFILER          -/^A - Prev Screen             v 
  34.      E - refresh scrEen      SP/CR - Next File              ^X
  35.      O - Option toggles        BS  - Prev File              
  36.  
  37.                               -- Macros --
  38.     # : Display Menu       ESC : Lead-in Char         0-9 : Direct Macros
  39.  
  40.  
  41.  
  42. Command-Line Constants:
  43.  
  44.      $    -  Macro parameter lead-in char            
  45.      !    -  Shell wait indicator                    
  46.      !    -  Parameter to indicate 'GO' substitution 
  47.      C    -  Current display directory (DIR form)    
  48.      D    -  Current drive letter                    
  49.      H    -  Home DU (see fphdir for DIR form)       
  50.      U    -  Current user number                     
  51.      F    -  Filename.typ                            
  52.      N    -  File name only                          
  53.      T    -  File type only                          
  54.      P    -  File entry being pointed to (du:fn.ft)  
  55.      R    -  Home DIR (see fphdu for DU form)        
  56.      #    -  Denotes comment area in macro file      
  57.      '    -  Single quote for user input             
  58.      "    -  Double quote for user input             
  59. :2
  60.  
  61.  
  62. Configuration options:
  63.  
  64.                            User-Customized Options
  65.  
  66.                    Query file replace on group archiving?
  67.                    Query file replace on group copy/usq?
  68.                    Query replace on single copy/usq?
  69.                    Ask whether to verify copy/usq?
  70.                    Verify default if no query?
  71.                    Display $SYS files?
  72.                    Display files in alpha order by name and type?
  73.                    Set attributes on copied files?
  74.                    Use attributes of destination if it exists?
  75.                    ARC attribute always set for destination file?
  76.                    Search path for CMD macro file?
  77.  
  78.                             Configuration choices
  79.  
  80.                    If not using path to find CMD file, use root?
  81.                    If not cmdroot, fixed user area for CMD file
  82.                    If not cmdroot, fixed drive for CMD file
  83.                    Put group macro batch file in root directory?
  84.                    If not batroot, fixed user for batch file
  85.                    If not batroot, fixed drive for batch file
  86.                    Reverse/low video?
  87.                    Display file names in upper case (if CASEOPT)?
  88.                    Separate DSEG for data?
  89.                    Provide built-in help info?
  90.                    Provide the (O)ption command?
  91.                    File mask on shell stk (true) or fn4 (false)
  92.                    Allow immediate 0..9 macro invocation?
  93.                    Allow "Shell Installed" message?
  94.                    Log in current dir with "Z" command?
  95.                    Warmboot on exit?
  96.                    Clear screen on exit?
  97.                    Expand tabs on view, print?
  98. :3
  99.  ZFILER Notes - 1/6 
  100.  
  101.    a. ASCII headers have been placed in ZFILER with 'CONFIG' and 'OPT' to make
  102.       it  easy  to locate the beginnings of option areas with ZPATCH for quick 
  103.       manual patching.  
  104.  
  105.    b. Due  to the way Z3LIB's GETNAME routine is coded,  it is not possible at
  106.       present to 'clone'  a version  of ZFILER  by setting  the option  bytes, 
  107.       exiting, and then saving the image with the SAVE command. 
  108.  
  109.    c. Vs 1.0o improvements (9/21/89 Carson Wilson)
  110.       -- implemented list capability for group macros.  If a ZFILER.CMD script
  111.       begins  with  a  comma  (before  or  after  the  leading "!" shell pause 
  112.       parameter), ZFILER will always  expand  the  macro  directly  to  ZCPR's 
  113.       multiple command line.   In the case of a group macro, $P,  $F,  and  $T 
  114.       parameters are expanded to a list of all tagged files,  separated by the
  115.       character following the leading comma.   For example, the script
  116.               x1 , !echo the tagged files are $F
  117.       displays "THE TAGGED FILES ARE ", followed by a list of the tagged files
  118.       separated by " " on the console (assuming ECHO is a valid ZCPR command).
  119.       ZFILER then prompts for a keypress before returning.  
  120.  ZFILER Notes - 2/6 
  121.  
  122.       Please note that this macro buffers  the entire list  of tagged files to
  123.       CP/M's command line buffer, which  is  only  125 bytes in  length.   The
  124.       above command therefore normally causes  a  "Command too long"  error if 
  125.       more than  about  8 files  are  tagged,  depending on the lengths of the
  126.       tagged names.
  127.       -- made the escape character and  the characters  to  quote with it when 
  128.       writing a group  macro command  to ZEX or SUBMIT files  installable (see 
  129.       ZFCNFN.Z80 for details).  Escape character is currently "$",  and quoted
  130.       characters are currently "$", "|", and "<", as required by ZEX vs 5.
  131.       -- it is now  possible to answer ZFILER's  "Login [DIR][:MASK] "  prompt 
  132.       with ".<cr>"  (same  as ":<cr>") to log  in  all  files  in  the current 
  133.       directory.   Previously this  logged  in  all files  at user zero of the 
  134.       current drive.   The Login  command  now  also  seems  to  accept ".afn" 
  135.       instead of ":afn".
  136.       -- shell bit set while waiting for user commands, then immediately reset
  137.       when a command key is received.  This should allow Bridger Mitchell's AT
  138.       command scheduler  RSX to  interrupt  ZFILER as  it  would the CCP while 
  139.       ZFILER is prompting for commands.
  140.  ZFILER Notes - 3/6 
  141.  
  142.       -- fixed bug which prevented  any Group commands from operating when the
  143.       configuration byte MACFLAG was patched to false.
  144.       -- removed code which attempted to use the ZCPR Environment to determine
  145.       how many lines of text to  display with  the V command, as this was only 
  146.       partially implemented, resulting in difficulty on terminals with over 24
  147.       rows.  Text lines now  hard-coded to 22,  so ZFILER  should  work on any 
  148.       terminal with 24 or more screen rows.
  149.       -- fixed  small  bug   which  caused  "Public  File  Error"  message  to 
  150.       disappear.
  151.       -- control-I is now an alias for control-J (jump to file again), for use
  152.       with terminal  definitions (TCAPs) which  define  control- J as an arrow
  153.       key.
  154.       -- idea for  future versions: it would  be  very difficult to allow file
  155.       ring sorting based on file dates (would need to  store  date stamps with
  156.       ring, requiring major rewrite).   It would be relatively simple to allow
  157.       the Login and startup commands to accept and match files to  a datespec,
  158.       though...
  159.  ZFILER Notes - 4/6 
  160.  
  161.    d. Vs 1.0n improvements:
  162.       -- $* script parameter was added to clear the screen during, and rebuild
  163.       it after  a script prompt.   Usage is $"$*..text.."  Prompt text appears 
  164.       at top of a cleared screen.
  165.       -- In anticipation of ZEX 4.0x,  '$' and '|' are now the only characters
  166.       which are quoted  when  ZFILER  builds  the  ZFILER.ZEX  file.   If they 
  167.       appear in a  ZFILER.CMD script  these  chars  are quoted with  a leading
  168.       dollar  sign when  ZFILER.ZEX is built.   All other chars are passed 'as
  169.       is' to the ZEX file.   This  means  that  you cannot  use ZEX directives
  170.       such as $1, |crlf|, etc., dynamically.
  171.       -- for efficiency, ZFILER no longer resets disks under Z3PLUS.
  172.  ZFILER Notes - 5/6 
  173.  
  174.    e. Vs 1.0m improvements:
  175.       -- Copy and Move commands now work properly with Z3PLUS, and the current
  176.       12-hour time shows at the top of the screen under Z3PLUS.
  177.       -- Path file conflicts are no longer reported under ZSDOS (this produced
  178.       problems  when  users  tried  to  backup  directories  along  the path).  
  179.       ZSDOS public conflicts are still reported.
  180.       -- Group Move and  Group Copy error messages are now sustained until the 
  181.       user strikes a key, rather than disappearing immediately.
  182.       -- Prompts in scripts may now contain control chars as  "^x"  where x is 
  183.       any char from @ to z.
  184.       -- The dollar sign is now  an "escape char" for script prompts,  and can 
  185.       be used to include the $, ^, and ' characters in prompts.   Examples:
  186.             Script                           Result
  187.             $"Enter name or $^C: "           Enter name or ^C:
  188.             $"Type $"//$" for help: "        Type "//" for help:
  189.       -- Move and  Group Move  now use the  option menu selections when moving
  190.       files instead of always copying file attributes.
  191.       -- Cleaned up help screen.
  192.  ZFILER Notes - 6/6 
  193.  
  194.    f. Vs 1.0l improvements:
  195.       -- the unsQueeze command was removed to reduce program size.   Since few 
  196.       files  are  squeezed  and  UNCRUNCH   supports  unsqueezing,  it   seems 
  197.       preferable to export this  function by  calling UNCRUNCH  with  a ZFILER
  198.       macro.  ZFILER will still display and print squeezed files.
  199.       -- if a DateStamper (BDOS function 12) real-time clock is available, the
  200.       current 12-hour time is printed  to the left  of  the ZFILER name at the 
  201.       top of the screen.   Copy/Move/Archive also  use ZSDOS's  more efficient 
  202.       Get Stamp  and  Set Stamp  function calls  to  preserve file  datestamps 
  203.       across copies.   The older method  of datestamping is retained more non-
  204.       ZSDOS systems.
  205.      -- ZFILER checks for and reports  Public  or Path conflicts when Copying, 
  206.       Renaming, Moving  and Archiving  files under ZSDOS.   Files created with
  207.       Copy/Move/Archive  are  always  set  to  Private  (high bit of f2=0)  to 
  208.       avoid possible ZSDOS Public conflicts.
  209.      -- the environment address is loaded  from location  109  at run time for 
  210.       compatibility with ZCPR 3.0 systems.
  211.      -- if  running ZSDOS  or ZDDOS,  disk resets are skipped for all commands 
  212.       except Space. 
  213. :4
  214.  
  215.  
  216.                                  ZFCNFN.Z80 
  217.  
  218.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  219.                9k (72)   DE2D  1.0o       Carson Wilson 9/89       Z3COM13
  220. ==============================================================================
  221.  
  222.  
  223.    ZFCNFN.Z80 is an overlay which can  be used  to set the configuration bytes
  224. in  ZFILER.COM.   The file  should  be  edited,  assembled to  a HEX file  and 
  225. overlayed using the command:
  226.  
  227.              MLOAD ZFNEW=ZFILER.COM,ZFCNFN