home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128CPM / CPM-PRIMER < prev    next >
Encoding:
Text File  |  2019-04-13  |  6.9 KB  |  156 lines
  1. *********************************************************************
  2. This article is being presented through the *StarBoard* Journal of
  3. the FlagShip/StarShip, SIGS (Special Interest Groups) on the
  4. Delphi and GEnie telecommunications networks.  Permission is
  5. hereby granted to non-profit organizations only to reprint this
  6. article or pass it along electronically as long as proper credit
  7. is given to both the author and the *StarBoard* Journal.
  8. *********************************************************************
  9.  
  10.          CP/M Mini-Primer  ***  Easy Handling of DIRectories
  11.                           By: Mike Mantino
  12.                      GEnie Mail Address: MIKEM
  13.   -------------------------------------------------------------------
  14.  
  15.     You've finally booted up CP/M Plus on your C-128.  There's that
  16. cryptic A> prompt staring you in the face, waiting for you to do
  17. something.  You say to yourself, 'Now how the heck do I see what is
  18. on this disk?'.  Ah, glad you asked!
  19.  
  20.     Let's assume you have two 1571 disk drives and a 1750 RAM
  21. expansion module.  In CP/M, the 1571 with device #8 is now referred
  22. to as drive A and the 1571 with device #9 is now referred to as
  23. drive B.  The 17xx RAM expansion should be thought of as another disk
  24. drive, but lots quicker.  It is assigned the drive designation M.
  25.  
  26.     When CP/M is first booted up, the default drive is A, hence the
  27. prompt A>.  You can change the default drive at any time by typing
  28. the letter of the drive followed by a colon and <RETURN>.  The prompt
  29. should then display the current default drive designation, such
  30. as B>.
  31.  
  32.     If you still have your CP/M system disk in drive A, typing DIR
  33. followed by <RETURN> will show you a listing of files that are on
  34. that disk.  It may or may not be a total list, depending on whether
  35. files have been saved to other portions of the disk which are called
  36. USER areas.  A CP/M disk has 16 different sections which are
  37. partitioned off from each other (labeled 0 thru 15).  That cryptic A>
  38. prompt should actually read A0>, since the default USER area upon
  39. boot-up is 0.
  40.  
  41.     One way to check to see if files are in these other nooks and
  42. crannies, is to change USER areas and type DIR again.  Let's see if
  43. there are any files in USER area 1 on that disk.  First, change USER
  44. areas by typing A1 and hitting <RETURN>.  Your prompt should now be
  45. A1>.  Next, check the directory by typing DIR and hitting <RETURN>
  46. again.  You can do this for all 16 different USER areas on that
  47. disk. You can also change to drive B or M and check all USER areas
  48. one at a time in much the same fashion.  Not much fun, is it?  Well,
  49. it *can* be easier, as you will see.
  50.  
  51.     The DIR command has two versions.  The one that you have just
  52. used is the 'built-in' version. The wildcards * and ? can be used,
  53. and it's simple and to the point, but not very versatile.  It is
  54. built into the CP/M operating system and does not require loading in
  55. any utility program in order to use it, but you *do* have more power
  56. at your disposal through the 'transient' version of DIR.  This
  57. transient utility is included on your CP/M disk and has the filename
  58. DIR.COM.  If you type DIR, followed by a set of parameters enclosed
  59. in brackets, CP/M will automatically search the disk for the
  60. transient DIR.COM and act upon those parameters, giving you enormous
  61. versatility when dealing with multi-USER areas and multi-drives.
  62. Let's explore these parameters and find out what DIR.COM has to
  63. offer.
  64.  
  65.      If you wanted to get a directory listing of all USER areas and
  66. all drives with one command, you would type:
  67.  
  68.               DIR [DRIVE=ALL USER=ALL]
  69.  
  70.      The right bracket need not be typed, and you must hit <RETURN>
  71. after typing the command.  You will then be shown a sorted directory
  72. of all files in all USER areas on all drives.  If the listing takes
  73. up more than one screen, CP/M will halt the listing to allow you to
  74. view one screen at a time.  To continue the display, just hit the
  75. spacebar.  To abort the display, hit CNTRL-C.
  76.  
  77.      You will notice that a summary at the end of the listings will
  78. show the number of files and the total number of bytes used by the
  79. files.  Also, the listings are placed in alphabetical order across
  80. each line.  This can be helpful when trying to find a specific file,
  81. but also can be a hindrance since long directories are noticeably
  82. longer to sort.  You can turn off the sorting by adding the NOSORT
  83. option inside the brackets.  Here is another example:
  84.  
  85.               DIR [DRIVE=B USER=ALL NOSORT]
  86.                         -OR-
  87.               DIR B: [USER=ALL NOSORT]
  88.  
  89.      These two commands will return the same unsorted directory of
  90. files in all USER areas of drive B.
  91.  
  92.      What follows is a listing of parameters available for DIR.COM, a
  93. description of each, and an example of each.  Note that references
  94. are made to Time-Stamping and other attributes which are beyond the
  95. scope of this primer.  These parameters must be enclosed in brackets,
  96. and may be used in conjunction with other parameters.
  97.  
  98.  
  99. DRIVE=ALL   -   Displays files on all online drives.
  100.  
  101. DRIVE=(A,B,C,.....P)  -  Displays files on the drives specified.
  102.  
  103. ATT  -  Displays the user-definable attributes
  104.  
  105. DIR  -  Displays only files that have the DIR attribute
  106.  
  107. DATE  -  Displays date and time stamps of files.
  108.  
  109. EXCLUDE  -  Displays files that Do Not Match the files specified in
  110. the command line.  Example:   DIR [EXCLUDE] *.COM     This command
  111. will list all files on the default drive that do NOT have a filetype
  112. of .COM
  113.  
  114. FULL  -  Displays the name, size, number of 128-byte records, and
  115. attributes of the files.
  116.  
  117. FF  -  Sends an initial form-feed to the printer device, if the
  118. printer has been activated using CNTRL-P.  (To print the DIR listing)
  119.  
  120. LENGTH=n  -  Displays n lines of printer output before inserting a
  121. table heading.  n is a number between 5 and 65536.
  122.  
  123. MESSAGE  -  Displays the names of drives and USER numbers the command
  124. is searching.
  125.  
  126. NOPAGE  -  Continuously scrolls the listing on the screen. (Used for
  127. printouts of listings, basically)
  128.  
  129. NOSORT  -  Displays files in the order it finds them on disk.
  130.  
  131. RO  -  Displays only those files having the Read/Only attribute.
  132.  
  133. RW  -  Displays only those files having the Read/Write attribute.
  134.  
  135. SIZE  -  Displays the filename and size in kilobytes (1024 bytes).
  136.  
  137. SYS  -  Displays only those files having the SYS attribute.
  138.  
  139. USER=ALL  -  Displays all files in all USER areas of the default or
  140. selected drive.
  141.  
  142. USER=n  -  Displays all files in the USER area specified by n.
  143.  
  144. USER=(0,1,2,.....15)  -  Displays all files in the USER areas
  145. specified.
  146.  
  147.  
  148.      Although this article only scratches the surface of just one of
  149. CP/M's combination transient/built-in commands, it should wing you on
  150. your way to a better overall understanding of the environment.  If
  151. you would like to see more of these primers or have questions about
  152. this one, leave mail to MIKEM on GEnie, MEYEK on People/Link, or
  153. 72767,2533 on Compuserve.
  154.  
  155. -Mike Mantino  7/24/86
  156.