home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpmug / cpmug034.ark / UPD051.TXT < prev    next >
Encoding:
Text File  |  1985-02-10  |  6.3 KB  |  157 lines
  1. Çr│╜care defined and the initial assignments are as listed belá└/π19
  2. .[20    |use of the|"nud"|function
  3.  
  4. It is  evident  that  use  of  some  of  the foregoing value`
  5. returning functions would fail due  to  lack  of  sufficient`
  6. user  work  space  for  storage  prior  to evaluation. It is`
  7. appropriate to  use  the  "nud"  null  display  function  to`
  8. obviate  this  problem;  typical  expressions  making use of`
  9. "nud" and some of the above functions are shown below:
  10.  
  11. %nud,xu,fm,100,200, /=  Displays from 100 to 200
  12.  
  13. %nud,xu,rcv,5,9000/=    Accepts   the   blocked   checksummed`
  14. transmission of object code offsetting  the  load  point  by`
  15. 9000  Hex.  Assuming  that  an  8K  object code of the SAM76`
  16. language   interpreter  intended  for  loading  at  8000  is`
  17. received, the loading will take place at 1000 instead. While`
  18. loading takes place progress of load  is  displayed  on  the`
  19. user  console,  and  each  block  correctly received will be`
  20. acknowledged to the sender; if incorrectly received  then  a`
  21. retransmission will be requested.
  22.  
  23. ┘Σ18|xu,rcv,m,0,x1,x2|  Xperimental User Receive
  24.  
  25. This valued  function  accepts data in the checksummed block`
  26. format generated by the "xu,xmt" function. The modes are the`
  27. same as described for the transmit function.  The  arguments`
  28. symbolized  by  "x1" and "x2" are to force loading elsewhere`
  29. than specified within the received block of data; "x1" is an`
  30. offsetting value.
  31.  
  32. This function may be used to load SAM76 language object code`
  33. distributed in the "loadit" format.
  34.  
  35. ┌517|xu,xmt,m,0,x1,x2|  Xperimental User X{trans}mit
  36.  
  37. This null  valued  function  is   used   to   generate   for`
  38. transmission purposes a blocked checksummed group of records`
  39. of the contents of memory locations between those symbolized`
  40. in the current X base by "x1" and "x2" inclusive. The symbol`
  41. "m"  denotes one of several modes of transmission as defined`
  42. below:
  43.  
  44. mode 0          No local display, no error feedback
  45. mode 1          No local display, automatic error control
  46. mode 4          Local progress display, no error control
  47. mode 5          Local progress display, with error control
  48.  
  49. All of the above transmissions are in the blocked checksummed`
  50. format to be described later and are through the  "group  2"`
  51. communications channel of the SAM76 language processor.
  52.  
  53. The argument  symbolized  by  "0" in the above expression is`
  54. reserved for future control and selection  purposes  and  is`
  55. undefined at this time.
  56.  
  57. Note:The format  is  that  which  is  currently  used in the`
  58. "loadit"  software  distributed  with  the  paper  tape  and`
  59. cassette media.
  60.  
  61. +316|xu,wl,sym,x|               Xperimental User Write Label
  62.  
  63. This null  valued function is the reverse of the "xu,rl,sym"`
  64. function, in that its execution will cause  the  storing  of`
  65. the  value  symbolized  by  "x"  at  the   actual   location`
  66. identified by the valide label symbolized by "sym".
  67.  
  68. )▒15|xu,vm,x1,x2,x3,s0| Xperimental User Verify Memory
  69.  
  70. This valued  function  compares  the  contents of the memory`
  71. between the locations symbolized in the current  X  base  by`
  72. "x1" and "x2" inclusive with memory locations which start at`
  73. the location symbolized by "x3". The value returned provides`
  74. a  list  of  adresses  of the locations which are different.`
  75. Each adress is preceded with the string symbolized by "s0".
  76.  
  77. º²14|xu,tm,x1,x2|               Xperimental User Type Memory
  78.  
  79. This valued  function  contains  in  "printable"  form   the`
  80. contents  of  the memory cells located between "x1" and "x2"`
  81. inclusive. Non printing characters are displayed as "dots".
  82.  
  83. ≤½13|xu,sum,x1,x2|              Xperimental User SUM
  84.  
  85. The value  of  this  function is the low order "byte" of the`
  86. arithmetic sum of all memory  cells  between  the  locations`
  87. symbolized in the current X base by "x1" and "x2" inclusive.`
  88. {This  is  useful  in  verifying  portions  of  the  system;`
  89. overlays are usually checksummed  to  zero  by  storing  the`
  90. appropriate value in the last location of the overlay}.
  91.  
  92. íù12|xu,rl,sym|         Xperimental User Read Label
  93.  
  94. This function  returns as a value the contents of the memory`
  95. location identified by the valid label symbolized by  "sym".`
  96. A  list of the valid labels is obtained through execution of`
  97. the %xll, / Xamine Label List function. {Note  this  differs`
  98. from  the  "xal,sym"  function  which  only gives the actual`
  99. machine adress of the symbol label}.
  100.  
  101. ì11|xu,mm,x1,x2,x3|    Xperimental User Move Memory
  102.  
  103. This null valued function serves to move the contents of the`
  104. system memory between "x1" and "x2" inclusive to a  location`
  105. whose  starting point is symbolized by "x"; all of these are`
  106. in the current X base.
  107.  
  108. 10|xu,fm,x1,x2,s0|    Xperimental User Fetch Memory
  109.  
  110. The value  of  this  function  is the contents of the system`
  111. memory between locations symbolized in the current X base by`
  112. "x1" and "x2" inclusive. Each word content  is  preceded  by`
  113. the string symbolized by "s0".
  114.  
  115. ä9|xu,dm,x1,x2,x|             Duplicate Memory
  116.  
  117. This null  valued  function  fills  memory from the location`
  118. symbolized in the current X base by  "x1"  to  the  location`
  119. symbolized  by  "x2" inclusive with the "byte" symbolized by`
  120. "x". {to be used with care as for instance when  one  wishes`
  121. to  scuttle  the  system which is about to be intruded by an`
  122. unauthorized peeker".
  123.  
  124. {Ö8Two  of  the subfunctions of "xu" were defined in Update No.`
  125. 4, namely "xu,dt,..." and "xu,ft,..."; additional  functions`
  126. are defined below.
  127.  
  128. É╫7|xu,lf,s0|          Xperimental User List Functions
  129.  
  130. The value of this expression is a list of the subfunctions of`
  131. the "xu" primitive. Each name in the list is preceded by the`
  132. string symbolized by "s0".
  133.  
  134. ╬±6
  135. .[20    |the XU|family
  136.  
  137. A family  of experimental functions exist as subfunctions of`
  138. the   "xu"  Xperimental  User  function;  a  list  of  these`
  139. functions may be obtained by executing  &xu,lf, /= which  is`
  140. defined as follows:
  141.  
  142. Φ!5This  update will discuss a number of the functions that may`
  143. be found in SAM76 language processors  released  after  July`
  144. 1978.  These  functions  are  located  in "overlays" and are`
  145. linked through the  POA,  POB,  POC  and  POD  locations  as`
  146. described in previous updates.
  147.  
  148. :4
  149. ./SAM76 Language Update No. 5 - September 1978
  150.  
  151. 13
  152. .Sup5-
  153. 2
  154. .W76
  155. 1
  156. .H60
  157.