home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 382.lha / skyterm_v1.2 / termdocs < prev    next >
Text File  |  1990-06-05  |  5KB  |  111 lines
  1.  
  2.                         SkyTerm 1.2 with AREXX
  3.  
  4.           Copyright (c) 1989 by Michael Cox - all rights reserved
  5.  
  6.  
  7. This program is not in the public domain; however, it is freely
  8. redistributable through any non-profit means. It may NOT be included
  9. on collections of programs that are sold for more than the cost of
  10. a blank disk, without the permission of the author.
  11.  
  12. This is version 1.2 of the Skyterm Skypix-compatible term program. It
  13. has many changes and enhancements, most of which are invisible until
  14. you call an Atredes board. The same docs that were supplied for the
  15. Atredes Demo Term 1.1 will apply here. The enhancements include corrections
  16. in the handling of certain ANSI commands that were mishandled before.
  17.  
  18. As before, make certain you do two things to complete installation:
  19.  
  20. 1. Install PEARL.FONT in your FONTS: directory. If your fonts won't reset,
  21. this is why.
  22.  
  23. 2. Put ATRZ and ATSZ in the directory you will be running the term FROM. If
  24. you can't get ZMODEM to work at all, this is why.
  25.  
  26. One NEW thing you must do is make an assignment for a new device called
  27. BRU:. This is where all Skypix brushes and sample files will automagically
  28. store themselves. If you don't want to devote any disk space to this,
  29. simply assign it to RAM:. BRU: is checked for brushes every time an Atredes
  30. board starts to send you one; if it's there, it shows immediately instead
  31. of being transferred to you, or having to copy it to the RAMdisk, etc.
  32.  
  33. The thing that many will find exciting is the wealth of AREXX support
  34. built directly into the terminal. Many of the same AREXX commands that
  35. ATREDES 1.2 itself understands are usable from this terminal. This makes a
  36. great number of things possible. You could write your own MICROHOST-type
  37. program, for example, using the terminal to handle serial IO for you. Or
  38. use a CRON-type program to startup the terminal at a certain time, call a
  39. BBS, run an AREXX-driven script, and exit. The possibilities are limited
  40. only by your AREXX proficiency.
  41.  
  42. This terminal is also compatible with the ASDG Dual Serial Board, or
  43. any other similar product. To use it in this way, use the command line form
  44.  
  45.     skyterm [unit] [devicename]
  46.  
  47. The default setting is of course unit 0 and "serial.device".
  48.  
  49. Any AREXX program to be used in conjunction with this terminal needs the
  50. line "options results" in it. Strings are returned in the global variable
  51. called RESULT. Arguments are passed as usual.
  52.  
  53. AREXX HOST COMMANDS SUPPORTED:
  54.  
  55. SCREENOUT string    Send a string to the screen only; EOL added.
  56.  
  57. TRANSMIT string     Send a string to the screen and modem; EOL added.
  58.  
  59. SENDSTRING string   Same as TRANSMIT but adds no EOL character.
  60.  
  61. RECEIVE             Get a string.
  62.  
  63. GETCHAR             Get a single-character invisible "hotkey" input.
  64.                     Automatically capitalized.
  65.  
  66. GETCARRIER          Get the state of the carrier - returns string "TRUE"
  67.                     or "FALSE".
  68.  
  69. DROPCARRIER         Drop carrier. Remembers last baud rate and other
  70.                     RS232 settings.
  71.  
  72. BUFFERFLUSH         Discards contents of the RS232 buffer, if any.
  73.  
  74. QUERY               Send a string and get a string response, all on same
  75.                     line; much like INPUT in BASIC. Works exactly like
  76.                     a SENDSTRING followed by a RECEIVE.
  77.  
  78. SENDMODEM string    Send a string to the modem only. Always use this
  79.                     instruction when talking to the modem for commands,
  80.                     since if there's no carrier, TRANSMIT will only put
  81.                     it on the screen.
  82.  
  83. RESETMODEM          Reset the modem by sending an AT Z.
  84.  
  85. VERSION             Return the Skyterm version number.
  86.  
  87. XUP path            Immediately starts an XMODEM transmit.
  88.  
  89. XDN path            Immediately starts an XMODEM receive
  90.  
  91. SPAWN string        Asynchronously issue an AREXX command, start macro, etc.
  92.  
  93. DIE                 Tells the terminal to exit cleanly.
  94.  
  95. BAUD string         Changes the baud rate to whatever argument you pass.
  96.  
  97. In addition, the terminal will accept all the other commands included
  98. in ATREDES; it just won't act on them. This makes it possible to run
  99. many AREXX programs intended for ATREDES with this terminal with minimal
  100. changes. You will of course have to change 'address atredes' to
  101. 'address skyterm'.
  102.  
  103. For more information and programming assistance call the Iconoclast BBS
  104. at 915-833-3899 and consult your AREXX manual.
  105.  
  106. If you feel that this software has been helpful to you, please make a
  107. $5 or larger donation to your local Humane Society.
  108.  
  109.                                          Michael
  110.  
  111.