home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug085.arc / CPMPOWER.DOC < prev    next >
Text File  |  1979-12-31  |  8KB  |  204 lines
  1.                              CPMPOWER
  2.  
  3.  
  4. CPMPOWER.COM is a program that was on the  single-density  disks,  but
  5. was not included on the double-density  versions.  Also,  it  was  not
  6. originally documented. The  documentation  has  been  taken  from  the
  7. August 1983 copy of the `Portable Companion' magazine (with  acknowled
  8. gement to Pavel Breder - who reprinted the article from  `OSBUG',  the
  9. newsletter of the Osborne Business  User's  Group,  Portland,  Oregon,
  10. USA).
  11.  
  12. Basically, CPMPOWER.COM is a front-end for  CP/M;  it  is  similar  to
  13. other like-programs, but has several  unique  features  not  found  on
  14. other programs, e.g., it has a  command  to  recover  programs  inadve
  15. rtently ERAsed from a disk - as long as nothing has  been  written  to
  16. the disk after erasing the file (a most useful command as I'm sure  we
  17. all have at  sometime  made  the  dreaded  mistake  of  deleting  that
  18. `precious' program !). CPMPOWER simplifies the use  of  the  operating
  19. system, in that you never need to remember the  syntax  for  the  many
  20. CP/M commands such as PIP, STAT, REN, etc.
  21.  
  22. Load CPMPOWER and at the prompt type `?' for a  listing  of  available
  23. commands. From this level you may perform houskeeping duties on  files
  24. and run programs. The specific commands are detailed below:
  25.  
  26.                               COPY
  27.  
  28. This command does just what it says; it copies individual  files  just
  29. like PIP. Unlike PIP it is limited to copying between disks  and  USER
  30. numbers. First log onto the disk you wish to copy from (A: or B:) then
  31. simply type COPY. A listing of files on that diskette will appear with
  32. numbers preceeding them. Type the number of the file(s)  you  wish  to
  33. have copied (place a space  between  numbers)  and  the  program  will
  34. prompt you through the copy session. See LOG  on  how  to  change  the
  35. prompt sequence as well as how to have the copies verified.
  36.  
  37.                                CRT
  38.  
  39. A use for this command has not been determined by the author.
  40.  
  41.                               DISK
  42.  
  43. This command gives the statistics of the disk,  showing  details  like
  44. sector organization and the like. CPMPOWER was designed for  all  CP/M
  45. computers, so this information would be useful if it was  not  already
  46. in your owner's manuals. It may, however, have  some  application  for
  47. those owners who have purchased the updated BIOS  routine  (from  A.V.
  48. Software) and wish to configure a `user-defined'  format  for  recogni
  49. tion by the Osborne.
  50.  
  51.                               EXIT
  52.  
  53. Just what it says: back to CP/M.
  54.  
  55.                               TYPE
  56.                               TYPEA
  57.                               TYPEH
  58.                               TYPEX
  59.  
  60. All four TYPES work in a way that is similar to the standard TYPE. The
  61. difference is in the format. Again, simply type the  command  and  the
  62. program feeds you a list of numbers. Type  one  or  all  the  numbers,
  63. separated by spaces, and you will be prompted through the  display  of
  64. the files.
  65.  
  66.                               CHECK
  67.  
  68. Checksum analysis: this command will run an alogrithm over your  files
  69. and return a number. If the number matches a control number, the files
  70. are the same. Useful for determining if your *.BAK files are  actually
  71. backups or merely similar files of the same name: CHECK will  let  you
  72. know - then the problem is figuring out which is the most recent!
  73.  
  74.                                RUN
  75.  
  76. RUN a program: CPMPOWER is a front-end, meaning that you need not exit
  77. to access any other programs. Type RUN, get the list  of  numbers  and
  78. away you go.
  79.  
  80.                              SETDIR
  81.  
  82. Similar to the STAT command, but easier. Will set your  SYS  files  to
  83. type that will be displayed by DIR.
  84.  
  85.                             SETWRITE
  86.  
  87. Restores read-only (R/O) files to read-write (R/W) files.
  88.  
  89.                                LOG
  90.  
  91. Very useful command: type  LOG  selects  a  separate  menu  with  five
  92. `toggle' controls:
  93.  
  94. 1. Firstly, you may select what CPMPOWER should do  when  encountering
  95.    duplicate files (you may overlay, backup, ask  for  disposition  or
  96.    skip).
  97.  
  98. 2. Secondly, you may set the number of columns in the DIR listing.
  99.  
  100. 3. Thirdly, this function selects whether the  program  will  ask  for
  101.    verification of selections within the main program or  go  on  with
  102.    the instructions as given.
  103.  
  104. 4. Fourthly, this toggle  selects  whether  the  program  reads  after
  105.    writing a file (as when copying) to check for errors.
  106.  
  107. 5. Fifthly, this toggle  will  allow  system  files  to  be  shown  on
  108.    listings.
  109.  
  110. Finally, the bottom of the LOG menu indicates the present USER  number
  111. and the present USER DESTINATION number. Both  of  these  designations
  112. may be changed from the main menu.
  113.  
  114.                               USER
  115.  
  116. Change user number: simply type USER n where `n' is an allowed decimal
  117. value user number.
  118.  
  119.                               INFO
  120.  
  121. At one time, this program apparently came with  an  information  (DOC)
  122. file. The command when invoked will indicate that  the  file  CPMPOWER
  123. .DOC has not been found. The information  presented  in  this  documen
  124. tation is in lieu of that missing program.
  125.  
  126.                               TEST
  127.  
  128. Very useful command: log to a disk with A: or B: and then  type  TEST.
  129. It will run  over  the  disk  (figuratively),  locate  physically  bad
  130. sectors and lock them out of the directory. These sectors are also set
  131. to read-only (R/O) to prevent someone from accidently erasing them and
  132. then wrecking data  by  trying  to  write  across  them.  (Similar  to
  133. FINDBAD.COM).
  134.  
  135.                                ERA
  136.  
  137. Same as the CP/M command. It erases files, but in the same  format  of
  138. much of CPMPOWER. Type ERA and get the  number  of  file(s)  you  wish
  139. erased. Type those number(s) and they are no more.
  140.  
  141.                                JMP
  142.  
  143. Useful for assemblers. Lets you JMP (jump)  to  any  memory  location.
  144. EXEC, below, is similar. It would  be  appreciated  if  any  `hackers'
  145. could advise how they are used.
  146.  
  147.                              SETSYS
  148.  
  149. Set a file to SYS status. Can't be read by the DIR command.
  150.  
  151.                                DIR
  152.  
  153. Standard DIR command. No file statistics, however, see LOG on  how  to
  154. change the number of display columns.
  155.  
  156.                               DEST
  157.  
  158. Allows transfer of files from one USER location to another. The format
  159. is the same as USER, above.
  160.  
  161.                               STAT
  162.  
  163. Very boring STAT command. Just whether R/W or R/O, SYS or DIR.
  164.  
  165.                              RECLAIM
  166.  
  167. Another very helpful command and one with no counterpart in the  OSBUG
  168. (source of this article) library. This command recovers erased  files.
  169. Previously, this could be done only by getting onto the disk  with  DU
  170. and changing the end of the file byte in the directory.  RECLAIM  does
  171. this for you and prompts you through all  abandoned  listings  on  the
  172. directory tracks. So long as you do not write any thing  to  the  disk
  173. after erasing your file, this utility will recover the file.  Standard
  174. format: log to the disk (A: or B:), then type  RECLAIM.  You  will  be
  175. prompted, just answer yes or no. (I have  used  the  program  and  can
  176. vouch for its  usefulness,  and  should  also  mention  that  on  each
  177. occasion it has been necessary to use the STAT command to  change  the
  178. `saved' files from read-only (R/O) to read-write (R/W) status.
  179.  
  180.  
  181.                               SIZE
  182.  
  183. Shows total of tracks and sectors used by a file.
  184.  
  185.                                REN
  186.  
  187. Same as CP/M command of same name. Only difference is the  convenience
  188. of dealing with numbered files instead of having to worry about typing
  189. errors.
  190.  
  191.                               EXEC
  192.  
  193. Allows execution of a resident program from any location. (The  author
  194. is not sure and seeks verification).
  195.  
  196.                              SETREAD
  197.  
  198. Sets your files to read-only (R/O) with this command. SETWRITE, above,
  199. undoes it.
  200.              CPMPOWER
  201.  
  202.  
  203. CPMPOWER.COM  is a program that was on the single-density  disks,  but 
  204. was  not inc