home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / s / zx.arc / ZX.DOC < prev    next >
Encoding:
Text File  |  1987-08-27  |  5.3 KB  |  108 lines
  1.                         **>> ZX.DOC <<**
  2.  
  3. ZX.COM IS A HORIZONTAL DIRECTORY PROGRAM, AND ALSO PERFORMS 
  4. ELEMENTARY FILE MANAGEMENT OPERATIONS.  FILE NAMES ARE LISTED IN 
  5. HORIZONTAL ALPHABETICAL ORDER.  HERE'S WHAT THE SCREEN LOOKS LIKE:
  6.                                                                                
  7. A>ZX D:
  8. > CHAR    .DEF  1K > CHAR    .GRK  1K > CHAR    .GTH  1K > CHAR    .ZIG  1K    
  9. > FIND51  .COM  3K > FINDBD54.COM  2K > INITDISK.COM  5K > MERGPRIN.OVR  8K    
  10. > NSWP    .COM 12K > PRN     .COM 29K > RAMDISK .COM  9K > SETDISK .COM  6K    
  11. > TOON12  .COM  1K > UNERA   .COM  1K > USFT1C  .COM  6K > WS      .COM 14K    
  12. > WSJ     .COM 14K > WSMSGS  .OVR 26K > WSOVLY1 .OVR 27K > ZX      .COM  1K    
  13. D: 254K TOTAL/170K USED >> 84K LEFT
  14. A>
  15.  
  16. ZX ALSO CONTAINS A FILE ERASE FUNCTION, A TYPE FUNCTION FOR 
  17. VIEWING FILES, AND A RENAME FUNCTION FOR CHANGING FILE NAMES.  
  18. ZX.COM IS SMALLER THAN 1K, THE MINIMUM CP/M FILE SIZE.  ZX'S 
  19. SMALL DISK FOOTPRINT IS WELL-SUITED TO ANY SITUATION WHERE SPACE 
  20. SHOULD BE CONSERVED, AND ITS HORIZONTAL OUTPUT IS WELL SUITED FOR 
  21. SMALL SCREENS (SUCH AS LCD'S).  HOWEVER, ZX SHOULD WORK ON ANY 
  22. CP/M 2.X SYSTEM WHICH HAS A Z80 CPU.
  23.  
  24.                        **>> USING ZX <<**
  25.  
  26. DIRECTORY FUNCTIONS ARE PERFORMED IN STANDARD CP/M STYLE:
  27.  
  28.      A>ZX                                    -> DIRECTORY OF A:
  29.      A>ZX D:                                 -> DIRECTORY OF D:
  30.      A>ZX A.FL                               -> SHOW A.FL ONLY
  31.      A>ZX *.COM                              -> ALL .COM FILES ON A:
  32.      A>ZX B:??.*                             -> B:FILES WITH 1 & 2 
  33.                                              LETTER FILE NAMES
  34.  
  35. ERASE IS INDICATED BY PUTTING E OR E AFTER THE FILE NAME:
  36.  
  37.      A>ZX BAD.TXT E                          -> ERASES A:BAD.TXT, 
  38.                                              THEN SHOWS DIRECTORY
  39.      A>ZX B:*.BAK E                          -> ERASES ALL .BAK 
  40.                                              FILES ON B:, CONFIRMS
  41.                                              WITH B: DIRECTORY
  42.  
  43. TYPE IS INITIATED BY T OR T AFTER THE FILE, AND STOPPED BY ^X:
  44.  
  45.      A>ZX BAD.TXT T                          -> EACH KEYPRESS 
  46.                                              TYPES ONE SECTOR OF
  47.                                              BAD.TXT, ^X EXITS 
  48.                                              TO A DIRECTORY
  49.      
  50. RENAME REQUIRES TWO FILE NAMES ON THE COMMAND LINE, THEN R OR R:
  51.  
  52.      A>ZX APT.TXT BAD.TXT R                  -> RENAMES APT.TXT TO 
  53.                                              BAD.TXT, THEN SHOWS THE 
  54.                                              DIRECTORY TO CONFIRM
  55.  
  56. ZX.COM'S OPERATIONS ARE ALL DUPLICATED IN CP/M'S STANDARD CCP, 
  57. WHICH HAS DIR, ERA, TYPE, AND REN.  WHY USE ZX?
  58.  
  59. THE REASON LIES IN THE BETTER INFORMATION SUPPLIED IN ZX'S 
  60. DIRECTORY, AND IN THE INTEGRATION OF THE OTHER FUNCTIONS WITH A 
  61. DIRECTORY DISPLAY.  I ALWAYS CHECK THE DIRECTORY AFTER ERASING A 
  62. FILE, AND ZX'S AUTOMATIC CONFIRMATION OF AN ERASE OR RENAME 
  63. OPERATION SAVES KEYSTROKES MANY TIMES A DAY.
  64.  
  65.                     **>> ERROR MESSAGES <<**
  66.  
  67. =NO FILE=  INDICATES THAT A FILENAME SUPPLIED IN A RENAME, ERASE, 
  68. OR TYPE OPERATION DOES NOT EXIST.  THE SAME MESSAGE APPEARS WHEN 
  69. A DIRECTORY IS REQUESTED FOR AN EMPTY DISK.  A =NO FILE= IS 
  70. ALWAYS FOLLOWED BY A DIRECTORY DISPLAY IN ORDER TO ASSIST THE 
  71. USER IN TYPING THE CORRECT FILE NAME.
  72.  
  73. =FILE EXISTS=  INDICATES THAT YOU HAVE TRIED TO RENAME A FILE TO 
  74. A FILE NAME WHICH ALREADY EXISTS.  THE MESSAGE IS (OF COURSE) 
  75. FOLLOWED BY A DIRECTORY.
  76.  
  77. =NO */?=  IS THE MOST MYSTERIOUS OF THE ERROR MESSAGES, BUT MEANS 
  78. THAT AN AMBIGUOUS FILE NAME (CONTAINING * OR ?) HAS BEEN SUPPLIED 
  79. WHERE AN UNAMBIGUOUS FILE NAME MUST BE.  FOR EXAMPLE, AMBIGUOUS 
  80. FILE NAMES SHOULD NEVER BE SUPPLIED FOR RENAMING, BECAUSE THE 
  81. DIRECTORY WILL BE SCRAMBLED.  ZX WILL TRAP MOST SUCH ATTEMPTS, 
  82. WITHOUT RESTRICTING THE USES OF AMGIGUITY IN DIRECTORY AND ERASE 
  83. OPERATIONS.  TO ASSIST IN FINDING THE SPECIFIC FILE NAME, =NO */?= 
  84. IS FOLLOWED BY A FULL DIRECTORY (SURPRISE!).
  85.  
  86.                   **>> APPLICATION NOTES  <<**
  87.  
  88. ZX USES MANY TRICKS TO STAY SMALL.  IT USES Z80 RATHER THAN 8080 
  89. OPERATIONS WHERE THEY SAVE DISK SPACE, AND THUS WILL RUN ONLY ON 
  90. THE Z80.  FORTUNATELY, THIS COVERS MOST MODERN SYSTEMS.  IT 
  91. BUILDS ITS DIRECTORY TABLE ABOVE ITSELF, SO THAT IT DOES NOT HAVE 
  92. TO RESERVE DISK SPACE FOR IT.  THIS MEANS THAT ZX WILL OVERWRITE 
  93. THE KBYTE OR SO ABOVE ITS LAST LOAD ADDRESS DURING OPERATION.  
  94. EVEN ZX'S INTERNAL STACK IS EXPORTED TO THE UNUSED INTERRUPT AREA 
  95. OF THE ZERO PAGE, SO AS TO REQUIRE NO RESERVED DISK SPACE.  
  96.  
  97. ZX IS AN INHERITOR OF THE IDEA EXPRESSED IN DO.COM, WHICH ALSO 
  98. COMBINES SEVERAL UTILITIES INTO MINIMAL DISK SPACE.  THERE IS A 
  99. SUBTLE BENEFIT OF THIS IDEA WHICH ONE ONLY APPRECIATES WITH USE.  
  100. ONE KBYTE PROGRAMS CAN SEEM TO LOAD AND EXECUTE INSTANTANEOUSLY, 
  101. WHICH IS DEFINITELY THE WAY A COMPUTER SHOULD BEHAVE.  I HOPE YOU 
  102. FIND ZX USEFUL.
  103.  
  104. AUGUST, 1985                                 MIKE YARUS
  105.                                              2231 16TH STREET
  106.                                              BOULDER, CO 80302
  107.                                              2231 16TH STREET
  108.