home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / robot-pd / 12400.ZIP / 12400B.DSK / manual01.txt < prev    next >
Text File  |  1998-04-30  |  9KB  |  236 lines
  1.  
  2.                   C H A P T E R   O N E
  3.  
  4.                    Introducing Centrox
  5.  
  6.  
  7. There are two main parts to Centrox. The first  is  called
  8. the  Kernel  and  it  is  this  that  is  responsible  for
  9. management of system resources. The kernel stays in memory
  10. at all times.
  11.  
  12. The second part of  Centrox  is  called  the  Shell.  This
  13. program can be either permanent or transient. The Shell is
  14. responsible for  interfacing  between  the  user  and  the
  15. Kernel.
  16.  
  17.  
  18. 1.1 Documentation Conventions
  19.  
  20. In this manual, the following conventions apply:-
  21.  
  22. Items enclosed in chevrons `<...>' should not be typed  as
  23. read. Instead the comments inside  the  brackets  describe
  24. the type of information that should be entered.
  25.  
  26. Square brackets enclose items which can  be  omitted.  The
  27. text will describe what happens if such items are omitted.
  28.  
  29. Curly brackets enclose a list of items from which one  AND
  30. ONLY ONE item may be chosen.
  31.  
  32. The prefix `++'  indicates  possible  repetitions  of  the
  33. following item.
  34.  
  35.  
  36. 1.2 Shell Command Line
  37.  
  38. Using the above convention, the general form of the  Shell
  39. command line can be given as:-
  40.  
  41. [++<Statement>;]
  42.  
  43. This means that the line takes the  form  of  an  optional
  44. list of statements, each separated  from  the  next  by  a
  45. semicolon. A pair of semicolons will be translated into  a
  46. single semicolon, which  will  be  treated  as  an  normal
  47. character.
  48.  
  49. Eg; "LF /COM;LF .." is two commands.
  50.     "Echo This (;;) is a semi colon" is one  command,  but
  51. note that the double semi colon IS converted into a single
  52. semi colon.
  53.     "Echo Test;;;LF /COM" is two commands, with the  first
  54. consisting of "Echo Test;;" followed by "LF /COM".  Again,
  55. the EFFECTIVE first command is "Echo Test;".
  56.  
  57.  
  58. 1.3 Shell Command Statement
  59.  
  60. The format of a Shell statement is:-
  61.  
  62. <Command name> [&++<Selector>] [++<Argument>]
  63.  
  64. The <Selector>s can be thought of as switches. They  allow
  65. certain options to be switched on or off, hence  tailoring
  66. the operation of the command. The <Argument>s can be  file
  67. names, numbers or any other construct.
  68.  
  69. The Shell allows the user to abbreviate internal  commands.
  70. The abbreviation is entered as a truncated version  of  the
  71. command name, terminated by a dot.
  72.  
  73.  
  74. 1.4 Halting Or Pausing A Program
  75.  
  76. A program can be paused by holding down [CONTROL] and [S],
  77. the program can be restarted by pressing [CONTROL] and [Q]
  78. when ready. The notation ^<letter> is  used  to  represent
  79. such a sequence of keys, eg; ^Q => CONTROL+Q.
  80.  
  81. ^C ([CONTROL] and [C]) will usually stop a program if held
  82. down for about one second. Note, however, that  the  Shell
  83. may  in  some  cases  take  longer  to  respond   to   the
  84. interruption. When it recognises the signal, it will  emit
  85. a `Bleep'.
  86.  
  87.  
  88. 1.5 Disk Structure
  89.  
  90. Centrox provides the means to set  up  a  relational  disk
  91. partitioning system. This allows you to  divide  the  disk
  92. into different areas for each topic you use  the  computer
  93. for. Each of these areas has a position relative to  other
  94. areas.
  95.  
  96. Each of these areas are known as  DIRECTORIES.  A  typical
  97. directory structure as shown below:-
  98.  
  99.                              /
  100.                              |
  101.                    +---------+---------+
  102.                    |                   |
  103.                   COM                 Jim
  104.                                        |
  105.                              +-------------------+
  106.                              |                   |
  107.                           Programs            letters
  108.  
  109.  
  110. If the Kernel is to access a particular file, it needs  to
  111. be told where it is stored. This is  done  by  giving  the
  112. Shell a description of the PATH to the required directory.
  113. The Shell recognises two methods of describing the path.
  114.  
  115. Directories can be stored on any of up to ten  disks,  and
  116. can be either data or system directories. Data directories
  117. are read from drive B: (except on  single  drive  systems)
  118. whilst system directories are read from drive  A:.  AMSDOS
  119. can't deal with disk swapping while files  are  open.  For
  120. this reason, single drive users  may  experience  problems
  121. from time to time.
  122.  
  123. All the Centrox  programs  have  been  written  to  either
  124. overcome this problem (see COPY, next  chapter),  or  else
  125. will refuse to allow such a situation to arise (see  COMP,
  126. chapter five).
  127.  
  128.  
  129. 1.6 Using File Paths
  130.  
  131. 1.6.1 Description
  132.  
  133. File paths take the form:-
  134.  
  135.       <directory path list>/<CP/M file name>
  136.  
  137. In the example "/Jim/letters/mum.let" the  file  "mum.let"
  138. is being referred to. "Jim" and "letters" are the names of
  139. directories.  Centrox  knows  that  "mum.let"  is  a  file
  140. because it is the last item in the list. If the  list  was
  141. simply  "mum.let"  then  Centrox  would  accept  that   no
  142. directories had been mentioned.
  143.  
  144. But so what? Why should Centrox allow us to give a list of
  145. directories? The reason is that the list is a  description
  146. of the path that must be taken to get to the area  of  the
  147. disk that "mum.let" is stored in.
  148.  
  149. The  above  example  means;  first  go  into   the   "Jim"
  150. directory. When you arrive, look for  a  directory  called
  151. "letters" which branches off from "Jim". When you find it,
  152. look in it for the file "mum.let".
  153.  
  154. This system allows you to organise your disks better  than
  155. AMSDOS and CP/M. No longer will a letter to your mother be
  156. stored along with a program. Of course, CP/M and AMSDOS do
  157. allow you to separate your disks into sixteen  areas,  but
  158. these  are  all  at  the  same  "level".  Centrox   allows
  159. directories to branch off other directories.
  160.  
  161.  
  162. 1.6.2 Describing Paths To Centrox
  163.  
  164. I'm now going to ignore  file  paths  and  concentrate  on
  165. directory  paths.  File  paths  are,  after  all,   simply
  166. directory paths with a CP/M / AMSDOS file name appended.
  167.  
  168. Centrox evaluates directory paths  by  walking  along  the
  169. path "in its mind". The  first  step  is  for  Centrox  to
  170. choose a starting point on the directory  "tree".  If  the
  171. path starts with a "/" then Centrox  starts  walking  from
  172. the "top" of the  tree,  otherwise  it  starts  from  your
  173. current directory (more on that later).
  174.  
  175. For the  sake  of  this  discussion,  I'll  refer  to  the
  176. directory that Centrox starts walking  from  as  the  CWSD
  177. (Centrox Walk Start Directory!). The next step is  to  get
  178. the first directory name. Centrox then looks in  the  CWSD
  179. for a directory  with  that  name.  If  it  finds  such  a
  180. directory it "walks" into it, making it the new CWSD.
  181.  
  182. Centrox then fetches the next directory name  and  repeats
  183. the operation 'till all names have been dealt with.  After
  184. finishing the list, the CWSD is the target of the path.
  185.  
  186. The following directory names work differently:-
  187.  
  188. ".." makes Centrox backtrack up the  tree.  In  case  this
  189. confuses you, bare in mind that, like humans,  directories
  190. can only have one set of parents. Going back to the  first
  191. example, ".." from "letters" takes us to "fred".
  192.  
  193. "-" causes Centrox to "teleport" into your home directory.
  194. This directory is the directory that you start  from  when
  195. you first log onto Centrox.
  196.  
  197. "." causes Centrox to teleport into the current directory.
  198. This directory is used to save time. Without it, you would
  199. have to give Centrox a complete directory path every  time
  200. you  wanted  a  file..imagine   the   tedium   of   typing
  201. "/Jim/letters/mum.let" every time  you  want  to  write  a
  202. letter!
  203.  
  204. By making "/Jim/letters" the current  directory,  you  can
  205. simply type "mum.let". If you go back to Centrox's  little
  206. stroll, remember that without the "/" at the start of  the
  207. path, Centrox starts looking from the  current  directory.
  208. Since only a file name has  been  given,  Centrox  doesn't
  209. actually   "walk"   anywhere,   it   just   starts    from
  210. "/Jim/letters" and looks for the file immediately.
  211.  
  212. Centrox uses the  name  "/(TOP)"  to  refer  to  the  root
  213. directory. This is  for  (stupid)  historical  reasons,  I
  214. suggest that you ignore it. The path "/" ALWAYS refers  to
  215. the root directory. Oddly  enough,  neither  "/(TOP)"  nor
  216. "(TOP)"  can  ever  be  given  legally..they  will  always
  217. generate the error "No such directory"..try  to  work  out
  218. why.
  219.  
  220.  
  221. 1.7 Directory Names
  222.  
  223. Directory names can be any length, but they may only share
  224. names  with  another  directory  if  they  have  different
  225. parents. Directory names cannot be abbreviated.
  226.  
  227.  
  228. 1.7 File Names
  229.  
  230. These must obey the normal AMSDOS conventions  and  again,
  231. files may only  share  names  if  they  are  in  different
  232. directories. File names cannot be abbreviated.
  233.           ╔Introducing CentroxΘ
  234.  
  235.  
  236. There are two main parts to Centro