home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / documentation / documents / a252thrw < prev    next >
Internet Message Format  |  1999-04-27  |  2KB
  1. From: burke@vxdesy.desy.de (Stephen Burke)
  2. Subject: Throwback protocol (client end)
  3. Date: 31 Jan 93 16:40:05 GMT
  4.  
  5. Nobody else has posted this, so here goes. To use throwback (as a client) you
  6. need the DDEUtils module, an editor which supports throwback, and (AFAIK) any
  7. version of RISC OS. There are three SWIs:
  8.  
  9. DDEUtils_ThrowbackStart (&42587)
  10.  
  11. Entry: Don't Care
  12.  
  13. Exit: All registers preserved
  14.  
  15. Function: Start a throwback session
  16.  
  17.  
  18. DDEUtils_ThrowbackSend (&42588) (The documentation actually calls this SWI
  19.                                  Throwback_Send, but I think it's a mistake).
  20.  
  21. Entry: R0 = reason code
  22.        R2-R5 variable
  23.  
  24.        R0 = 0 (Throwback_ReasonProcessing)
  25.        R2 = pointer to full pathname of file (null terminated)
  26.  
  27.        R0 = 1 (Throwback_ReasonErrorDetails)
  28.        R2 = pointer to full pathname of file (null terminated)
  29.        R3 = error line number
  30.        R4 = severity:
  31.           = 0 for warning
  32.           = 1 for error
  33.           = 2 for serious error
  34.        R5 = pointer to error description string (null terminated)
  35.  
  36.        R0 = 2 (Throwback_ReasonInfoDetails)
  37.        R2 = pointer to full pathname of file (null terminated)
  38.        R3 = line number to which info message refers
  39.        R4 = 0
  40.        R5 = pointer to informational message (null terminated)
  41.  
  42. Exit: R0-R4 preserved
  43.  
  44. Function: Call once with reason code 0, and then with code 1 or 2 for
  45.           each error/message
  46.  
  47.  
  48. DDEUtils_ThrowbackEnd (&42589)
  49.  
  50. Entry: Don't Care
  51.  
  52. Exit: All registers preserved
  53.  
  54. Function: End a throwback session
  55.  
  56.  
  57. All three SWIs can give errors of "No task registered for throwback" and
  58. "Throwback not available outside the desktop" (no error numbers given).
  59.  
  60. That's it; simple really :-)
  61.  
  62. e----><----p | Stephen Burke           | Internet: burke@vxdesy.desy.de
  63.  H   H   1   | Gruppe FH1T (Liverpool) | DECnet:   vxdesy::burke (13313::burke)
  64.  H   H  11   | DESY, Notkestrasse 85   | BITNET:   BURKE@DESYVAX or SB2@UKACRL
  65.  HHHHH   1   | 2000 Hamburg 52         | JANET:    sb2@uk.ac.rl.ib
  66.  H   H   1   | Germany                 | Phone:    + 49 40 8998 2282
  67.  H   H 11111 | HERA, the world's largest electron microscope!
  68.  
  69.  
  70.