home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 051-075 / scopedisk52 / tutor / c4 < prev    next >
Encoding:
Text File  |  1995-03-19  |  7.9 KB  |  246 lines
  1. Commands in this section:
  2. STATUS
  3. BREAK
  4. FAULT
  5. PROTECT
  6. VERSION
  7. WAIT
  8. WHY
  9. BINDDRIVERS
  10. CHANGETASKPRI
  11. DISKCHANGE
  12. DISKDOCTOR
  13. EDIT
  14. SETDATE
  15. SETMAP
  16. ________________________________________________________________________________
  17.  
  18. STATUS
  19.  
  20.     displays information about the tasks that are currently being performed.
  21.  
  22. >> STATUS ?
  23. PROCESS,FULL/S,TCB/S,CLI=ALL/S:
  24.  
  25.     There's another mouthful. "PROCESS" is a task by number. "TCB" gives
  26. information about the task priorities, stack, and global vector size. "CLI"
  27. displays the currently loaded programs. /* STATUS alone displays this
  28. information */. "FULL" gives all the information 
  29.  
  30. >> STATUS
  31. >> STATUS FULL
  32.  
  33. ________________________________________________________________________________
  34.  
  35. BREAK
  36.  
  37.     sets the "attention" flag[s] in a given task.
  38.  
  39.     This is similar to typing <CTRL>C to escape from a task that's being
  40. run, but you can send a task either <CTRL>C, <CTRL>D, <CTRL>E, or <CTRL>F.
  41.  
  42. >> BREAK ?
  43. task/a,all/s,c/s,d/s,e/s,f/s:<RETURN>
  44. Bad args to BREAK
  45.  
  46.     OK, look at the help line. We have to give BREAK a task number /* can
  47. be obtained with STATUS */, and the letter for the flag we want to send or all.
  48.  
  49.     Let's set-up a demo situation:
  50.  
  51. >> NEWCLI
  52.  
  53.     /* take note of the number that's at the prompt. If you've changed it,
  54. work in the new window and just change the new window's prompt so it gives you
  55. the current task. /* PROMPT "%N" if you don't remember */. Now in your new
  56. window, type:
  57.  
  58. NEWWINDOW_#> TYPE CLI_tutorial.1
  59. /* and use <SPACE> to stop it from scrolling */
  60.  
  61.     Go to your work CLI and type in:
  62.  
  63. >> BREAK NEWWINDOW_# C
  64.  
  65.     Go back to NEWWINDOW_# and press <BACK SPACE> to start the scrolling
  66. again. But now instead of continuing, you get a line:
  67.  
  68. **BREAK
  69.  
  70.     See how it works? You can perform the same experiment and pass the
  71. BREAK with the ALL option if you want. If you don't, just:
  72.  
  73. NEWWINDOW_#> ENDCLI
  74.  
  75. ________________________________________________________________________________
  76.  
  77. FAULT
  78.  
  79.     displays error message for the code you supply.
  80.  
  81.     Up to 10 numbers may be supplied.
  82.  
  83. >> FAULT 218
  84. Fault 218: device (or volume) not mounted
  85.  
  86. ________________________________________________________________________________
  87.  
  88. PROTECT
  89.  
  90.     sets a file's protection status
  91.  
  92.     Although LIST will display "rwed" /* r=read, w=write, e=execute, and
  93. d=delete */ as the status for a command and changing them with PROTECT will
  94. make them appear changed, AmigaDOS only pays attention to the "d" flag in the
  95. current /* 1.2 */ release.
  96.  
  97. ________________________________________________________________________________
  98.  
  99. VERSION
  100.  
  101.     displays the version numbers for the kickstart and workbench disks
  102.     the system is currently using.
  103.  
  104.     This is a "file-seperately" command. Use it once, write the results on
  105. the kickstart and workbench disks you're using, and move this command to an
  106. area for storing rarely used things...somewhere other than your WB.
  107.  
  108. >> VERSION
  109. /* a message with the aforementioned numbers in it */
  110.  
  111. ________________________________________________________________________________
  112.  
  113. WAIT
  114.  
  115.     puts everything on hold for a specified period of time.
  116.  
  117. >> WAIT ?
  118. ,SEC=SECS/S,MIN=MINS/S,UNTIL/K:
  119.  
  120.     Followed by a number, the current process will wait for that number of
  121. seconds unless the word MINS is used.
  122.  
  123.     Waiting UNTIL can take quite a while if you don't set your clock on a
  124. regular basis, but if that's what you want to do, you can:
  125.  
  126. BS> WAIT UNTIL HH:MM
  127.  
  128.     By itself, WAIT waits 1 second
  129.  
  130. ________________________________________________________________________________
  131.  
  132. WHY
  133.  
  134.     gives a brief explanation of why a command failed
  135.  
  136.     This command probably belongs in the same ultimate directory as VERSION.
  137. But, if a command fails, WHY will, if the command sets a return code, let you
  138. know what happened. These comments are often cryptic to those who need to use
  139. this command /* after you've had a few of the same error codes, you'll begin to
  140. KNOW what happened */ or they simply don't tell you enough. This isn't
  141. necessarily that the command is written poorly, it's just that it can't do your
  142. thinking for you.
  143.  
  144. ________________________________________________________________________________
  145.  
  146. BINDDRIVERS
  147.  
  148.     binds the device driver for add-on hardware.
  149.  
  150.     I guess I could be wrong, but it seems to me this command is left
  151. overfrom the 1.1 days, when things wouldn't auto-configure. 
  152.     This command would be used in the startup-sequence and, if it finds
  153. icons for expansion hardware in the sys:expansion directory, will auto-configure
  154. them. 
  155.  
  156. ________________________________________________________________________________
  157.  
  158. CHANGETASKPRI
  159.  
  160.     changes the priority of the specified task.
  161.  
  162.     AmigaDOS uses the priority number to determine which task to attend to
  163. in it's environment. Most tasks have a priority number of 0 and this allows the
  164. CPU to alternate between tasks. CHANGETASKPRI sets the priority number of your
  165. CLI to the number you specify, the range is -127 to 127. Tasks begun from this
  166. CLI will inherit this property.
  167.     It is suggested that you stick within the range of -5 to 5, since
  168. AmigaDOS will assume you know what you're doing and it's possible to lock
  169. critical tasks out of the CPU by using the hamfist approach.
  170.  
  171. ________________________________________________________________________________
  172.  
  173. DISKCHANGE
  174.  
  175.     informs AmigaDOS that you've changed disks in a 5¼" drive.
  176.  
  177.     If you don't have a 5¼" drive, move this command to external storage, if
  178. you do have one. You'll need to tell AmigaDOS whenever you change a disk in it
  179. by: 
  180.  
  181. BS> DISKCHANGE df?:
  182.  
  183. ________________________________________________________________________________
  184.  
  185. DISKDOCTOR
  186.  
  187.     attempts to repair a corrupted disk.
  188.  
  189.     If a disk gets corrupted, AmigaDOS will display a requester imforming
  190. you of the fact and will suggest that you use DISKDOCTOR to repair it.
  191.     Corrupted disks can happen through mechanical damage or sometimes by
  192. magic(?).
  193.     DISKDOCTOR will attempt to restore as much of the data as it can. After 
  194. DISKDOCTORing a disk, you should copy everything you want off of it and to
  195. another disk.
  196.     After moving the files to a new disk, you can attempt to salvage the old
  197. disk by formatting it again to clean it up.
  198.  
  199. BS> DISKDOCTOR df?:
  200.  
  201. ________________________________________________________________________________
  202.  
  203. EDIT
  204.  
  205.     is a line editor, as opposed to ED which if full-screen.
  206.  
  207.     To be honest, I have never had much luck getting it to work. /* I read
  208. somewhere that Carolyn Scheppner of CATS claims that the only person she knows
  209. that can use it is Andy Finkel... */ If you want to use it, refer to one of
  210. your reference manuals for the instructions. There's whole chapters devoted to
  211. it's use. If you are or become adept at it, let me know and I'll update this
  212. entry. 
  213.  
  214. ________________________________________________________________________________
  215.  
  216. SETDATE
  217.  
  218.     changes the date stamp of a file or directory.
  219.  
  220.     AmigaDOS maintains a date stamp that contains the time of creation for
  221. disks, directories, and files. SETDATE allows you to change this date.
  222.  
  223. ________________________________________________________________________________
  224.  
  225. SETMAP
  226.  
  227.     changes the key map that the Amiga uses.
  228.  
  229.     In the devs:keymaps directory are stored various keyboard mapping
  230. configurations. You can use the SETMAP command to set your keyboard to the key
  231. maps of different countries. This is handy if you have to do documents in a
  232. different language.
  233.     Bear in mind that while your screen display will reflect these changes,
  234. your printer might not. Ofttimes there will be "dip switches" in the printer to
  235. configure it to different international characters. You'll have to refer to your
  236. own printer manual to find out how to do this and what the combination of switch
  237. positions has to be.
  238.  
  239. ________________________________________________________________________________
  240.     OK! We've finished another one. That pretty well some up the general
  241. stuff. In the next section, we'll start going over the big guns of the CLI.
  242.  
  243.     You know the routine:
  244.  
  245.         READER CLI_tutorial.5
  246.