home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMMUNIC / C26_EXE.ZIP / README.DOC < prev    next >
Encoding:
Text File  |  1990-04-27  |  20.3 KB  |  462 lines
  1. -------------------------------------------------------------------------------
  2. 900426                COM-AND 2.6                Page  1
  3. -------------------------------------------------------------------------------
  4. This release of COM-AND:
  5. -------------------------------------------------------------------------------
  6.  
  7.      o    This is the seventh release of COM-AND (version 2.6).  This release
  8.     corrects problems reported with version 2.5 and adds features.
  9.  
  10.      o    Run instructions and installation procedures will be found following
  11.     this page.
  12.  
  13.      o    Changes to the previous version (additions and corrections) are to
  14.     be found following run/installation pages.
  15.  
  16.      o    The author asks for comments and criticisms of this program.
  17.     You may contact the author:
  18.  
  19.     CABER Software            PLINK, GEnie id: TARTAN
  20.     R. (Scott) McGinnis        UNISON id: SCOTTM
  21.     P.O. Box 3607 Mdse Mart
  22.     Chicago, IL 60654-0607
  23.  
  24. -------------------------------------------------------------------------------
  25. Release history (not including beta releases)
  26. -------------------------------------------------------------------------------
  27.    860806: PC-VCO 1.0
  28.    860929: PC-VCO 1.1
  29.    861119: PC-VCO 1.2
  30.    861222: PC-VCO 1.3
  31.    861226: PC-VCO 1.31
  32.    870814: PC-VCO 2.0     COM-AND 2.0   CCHESS 1.0
  33.    871202: PC-VCO 2.1     COM-AND 2.1   CCHESS 1.1
  34.    871211:                         CBRIDG 1.0
  35.    880122:                              CCOLOR 1.0
  36.    880713: PC-VCO 2.2     COM-AND 2.2   CCHESS 1.2    CBRIDG 1.1   CCOLOR 1.1
  37.    881202:         COM-AND 2.3
  38.    890309:         COM-AND 2.4
  39.    891020:         COM-AND 2.5
  40. -------------------------------------------------------------------------------
  41.  
  42. -------------------------------------------------------------------------------
  43. 900426                COM-AND 2.6                Page  2
  44. -------------------------------------------------------------------------------
  45. Files in this distribution:
  46. -------------------------------------------------------------------------------
  47.  
  48.      CA26-1.ARC:
  49.  
  50.     COM-AND.EXE    2.6  executable
  51.     COM-AND.PIF    PIF file for Windows
  52.     COM-AND.DVP    DVP file for DesqView
  53.     README.DOC    This file.
  54.     REGISTER.DOC    Registration form
  55.  
  56.      CA26-2.ARC:
  57.  
  58.     COM-AND.DOC    Documentation for version 2.6 manual functions
  59.     CASCRIPT.DOC    Documentation for version 2.6 script language
  60.     README.DOC    This file.
  61.     REGISTER.DOC    Registration form
  62.  
  63.      CA26-3.ARC:
  64.  
  65.     SCRIPTS.DOC    Summary documentation for scripts
  66.     REGISTER.DOC    Registration form
  67.     README.DOC    This file.
  68.     *.CMD        REMAP.CMD, XLATE.CMD, LEARN.CMD, FILEMGR.CMD...
  69.  
  70.      CA26-4.ARC:
  71.  
  72.     OVERLAY.*    Sample script overlay files
  73.     TALKER.*    Sample script overlay supprting limited speech synth
  74.     VOICE.*     Voice driver and documentation for TALKER
  75.     VEND.COM    Voice driver termination utility
  76.     PC-VCO.EXC    Excpetion file for TALKER.CMD script
  77.     README.DOC    This file.
  78.     REGISTER.DOC    Registration form
  79.  
  80. -------------------------------------------------------------------------------
  81.    *    COM-AND creates any files it requires that it does not find on the
  82.     drive:subdirectory where it is loaded (or on the drive:subdirectory
  83.     where the environment variable COM-AND= directs the processor)
  84. -------------------------------------------------------------------------------
  85.    *    To print the document files, deARC the file onto disc and use the DOS
  86.     command "PRINT <file>.DOC".  COM-AND documents are formatted 54 lines
  87.     to the page, with top-of-forms as page breaks, using tab characters.
  88. -------------------------------------------------------------------------------
  89.  
  90. -------------------------------------------------------------------------------
  91. 900426                  COM-AND 2.6                Page  3
  92. -------------------------------------------------------------------------------
  93. Run instructions:
  94. -------------------------------------------------------------------------------
  95.  
  96. o    To run COM-AND from the DOS prompt:
  97.        (Install the release as described below)
  98.  
  99.        C> COM-AND
  100.  
  101.        (Run this way, the F1 menu makes many accessories available to
  102.        you.  You can modify (and create) new accessories with the 'r'
  103.        subcommand at any time.)
  104.  
  105. -------------------------------------------------------------------------------
  106. Installation:
  107. -------------------------------------------------------------------------------
  108.  
  109. 1)    Set your current subdirectory to the subdirectory where you wish
  110.     to install COM-AND... where you've already installed previous
  111.     COM-ANDs (if you've used one).  I'd suggest "\COM-AND".
  112.  
  113. 2)    DeARC the distribution file.  Have a care not to overwrite files
  114.     you want to keep!
  115.  
  116. 3)    Load COM-AND (i.e. C> COM-AND <return>)
  117.  
  118.     o  Check Alt-S
  119.        .. Modem parms are set for HAYES - you may want to change them.
  120.        .. The backscreen buffer size defaults to 4K.  You can set it
  121.           up to 64K, for redisplay and transcripting.
  122.        .. Remember to save the new settings.
  123.  
  124.     o  Check Alt-P
  125.        .. Choose the COM port you use (1/2/3/4).
  126.        .. Default speed selection is not usually important (if you always
  127.           use the dialing directory).  Set it anyway.
  128.        .. Remember to save new settings.
  129.  
  130.     o  Check Alt-O
  131.        .. Set flags the way you want them (e.g. exit query on, d*mned
  132.           advert off, and so on;  Note BIOS/DIRECT and PCJr settings)
  133.        .. Remember to save new settings.
  134.  
  135. 4)    Review the accessories (F1).
  136.  
  137.        You may review the contents of accessory definitions with the 'r'
  138.        subcommand.    You may wish to add entries for a listing program
  139.        and editor.. and perhaps PC-VCO... CCOLOR...
  140.  
  141. 5)    Exit COM-AND with Alt-X.
  142.  
  143.  
  144. -------------------------------------------------------------------------------
  145. 900426                  COM-AND 2.6                Page  4
  146. -------------------------------------------------------------------------------
  147. Additions and corrections this release:
  148. -------------------------------------------------------------------------------
  149.  
  150.  
  151.     ---------------------------------------
  152.     Changes and corrections to 2.5 COM-AND:
  153.     ---------------------------------------
  154.  
  155.  
  156. o    Corrected the .DFT file to retain modem init string (when upgrading
  157.     from version 2.4{or 3} to 2.5 or 6)
  158. o    Changed display routines to 'fix' cursor ONLY for EGA adapters
  159. o    Changed display routines for PS/2 VGAs to provide proper 50 line mode
  160. o    Changed accessory/shell loader to preserve the number of screen lines
  161.     25/43(50) [though screen is still set b&w during accessory/shell]
  162. o    Corrected screen repaint (Alt-J, COLOR stmt) to allow for menu mode
  163. o    Changed comm driver to send XOFF whenever a character is received in
  164.     threshold conditions (only one XOFF was previously sent)
  165. o    Corrected CISB (not Quick-B) receive to show status screen (ugh)
  166. o    Corrected CISB/Quick-B response to ENQ received during download
  167. o    Corrected KERMIT to format last values before exit (for calllogging)
  168. o    Corrected ZMODEM to retain error number when recovery not on (was lost)
  169. o    Changed ZMODEM to catch carrier drop immediately (was deferred 1 block)
  170. o    Corrected ZMODEM to properly show blocksize under all option settings
  171. o    Corrected ZMODEM to properly format final values for calllogging
  172. o    Changed ZMODEM/comm driver interface to allow XOFF+parity as proper
  173.     flow control (this is a test... for Telenet users)
  174. o    Changed ASCII send comm driver interface to allow XOFF+parity bit
  175. o    Changed code to repaint border when screen clear is performed.
  176.     This is required if ANSI changes colors and then clears screen.
  177. o    Changed Alt-D dial hangup to eliminate spurious calllog entry (and to
  178.     ensure modem disconnected (if waiting for connect))
  179. o    Changed Alt-R escape (and script DIAL) to hangup before return
  180. o    Purge Y/N prompt during encrypt does not interfere now with last
  181.     Alt-N selection
  182. o    Changed hangup during dial to send modem escape (after dropping DTR
  183.     if that option is set).  Some modems require this to hangup during
  184.     wait for connect (they don't 'see' DTR dropped)
  185. o    Corrected bug in remapping code (when keypress not remapped)
  186. o    Corrected tab expansion in CRT mode to multiple-of-8
  187. o    Corrected Alt-V to actually save emulation selected for next session
  188.  
  189.  
  190. -------------------------------------------------------------------------------
  191. 900426                  COM-AND 2.6                Page  5
  192. -------------------------------------------------------------------------------
  193. Additions and corrections this release:
  194. -------------------------------------------------------------------------------
  195.  
  196.  
  197.     -------------------------
  198.     Additions to 2.5 COM-AND:
  199.     -------------------------
  200.  
  201.  
  202. o    Improved script interpretor's speed by approx 10% (new lookups)
  203. o    Improved screen display speed by approx 10% (cut fat, trimmed crusts)
  204. o    Improved XMODEM/YMODEM speed by approx 10% (new CRC algorithm)
  205. o    Improved ZMODEM send speed by approx 7% (bufferred sends)
  206. o    Added optional re-init of modem after hangup to Alt-O
  207. o    Added 'modified' hardware flow control (RTS) to Alt-O
  208. o    Reorganized Alt-O generally
  209. o    Added a flow control mode dynamically raising RTS when able to
  210.     receive and waiting for CTS before sending (modified hardware flow)
  211. o    If there is insufficient memory to load COM-AND, COM-AND exits not
  212.     an error code of 1.  [How did it get loaded in the first place?]
  213. o    Added mention of menu mode cursor keys to HELP display (F10)
  214. o    Accessories for COM-AND now permit scripts to be executed, if the
  215.     accessory is coded to do so (CCOLOR so modified will be released)
  216. o    All windows now circle backwards (as well as circling forwards)
  217.     when scroll bar is moved.
  218. o    Added error count to calllog record for Up/downloads
  219. o    Command buffer (char 255) now accepts script statement as well as
  220.     file name (statement must be preceded by ".").
  221. o    Added XOFF to status line display in CRT mode
  222. o    Added indicator of XOFF during ASCII send (if not paced or timed)
  223. o    Extended VT100 subset emulated considerably.
  224. o    Added VT52 sequence ESC/< (switch to VT100 mode)
  225. o    Added more protective code to detect and correct for lost write-ready
  226.     interrupt during bufferred sends (especially on 4.77 MHz machines)
  227.  
  228.  
  229. -------------------------------------------------------------------------------
  230. 900426                  COM-AND 2.6                Page  6
  231. -------------------------------------------------------------------------------
  232. Additions and corrections this release:
  233. -------------------------------------------------------------------------------
  234.  
  235.  
  236.     -------------------------------
  237.     Script changes and corrections:
  238.     -------------------------------
  239.  
  240.  
  241. o    Corrected STORE DEFAULT to store CURRENT comm settings (not default)
  242. o    Corrected SET COLOR to remove artifact from screen display (sorry!)
  243. o    Corrected STORE DIAL to store dialing directory as currently set
  244. o    Corrected STORE ACCESSRY to store accessory directory as currently set
  245. o    Increased number of script static string variables to 30 (S0 to S29)
  246. o    When dynamic variables have been ALLOCATEd, string variables V0 through
  247.     Vn-1 ('n' being the number allocated) are available in place of Sx
  248. o    Indexing is now implemented on string variables as well as numerics.
  249.     e.g: S0 = S0[2](2:3) ; Extract cols 2-3 from S2 and place in S0
  250. o    SET commands now will ALL take string variables in place of keyword
  251.     operands (e.g. SET FLAG(9) S0 ; S0 must contain "ON" or "OFF")
  252. o    The ELSE statement now allows a short form as IF allows.  Example:
  253.     ELSE N0 = N0+N5 ; No ENDIF needed for this ELSE
  254. o    Numeric comparisons now allow 'normal' form... Example: IF 5 GT N0
  255.     NOTE: parentheticization should not be used in the first expression,
  256.     as IF (...) expects an AND/OR/XOR following; e.g. IF ((N10-2) GT N0)
  257.     is incorrectly interpreted, even though it reads well.
  258. o    Corrected potential error on CALLLOG after script RESET statement
  259. o    Expanded SET XSUI to store a value that may be returned by _XSUI
  260. o    Corrected screen border problem when colors set through script
  261. o    Corrected SET DEFAULT color problem in current session
  262. o    Corrected SET TEXT to store a value that may be saved in the DFT file
  263. o    Corrected "_EXIT" to return null valye DURING exit script
  264. o    Corrected CUROFF twice error (losing cursor)
  265. o    Corrected CUROFF for some VGAs
  266. o    FATTR, FSIZE, FTIME, and FDATE now all will reference a hidden file
  267. o    Changed STORE DIAL to update the Long Distance from memory at same time
  268. o    Enabled display in char area and echo in text window during script
  269. o    Allowed for "access denied" error while searching for a script file
  270.     name (when a subdirectory name collides with the target script name)
  271. o    Corrected ESC during script when 1) ON ESCAPE set, 2) ON ESCAPE label
  272.     does not exist, and 3) 'N' is answered at default ESCAPE pop-up
  273. o    Corrected FGETS handling of text records - stop on CRLF
  274. o    Corrected READ to return empty buffer on EOF
  275. o    Corrected FOPENO to flush buffered data to old file before opening new
  276.     file (only when old file was not closed with an FCLOSEO).
  277. o    Corrected EXIT code to close files left open by uncompleted FCALLs
  278.  
  279.  
  280. -------------------------------------------------------------------------------
  281. 900426                  COM-AND 2.6                Page  7
  282. -------------------------------------------------------------------------------
  283. Additions and corrections this release:
  284. -------------------------------------------------------------------------------
  285.  
  286.  
  287.     -------------------------------
  288.     Script language additions:
  289.     -------------------------------
  290.  
  291.     ALLOCATE <number>    ; Allocate dynamic variables, up to 100
  292.     DEALLOCATE        ; Deallocate dynamic variables
  293.     IF [NOT] ALLOCATED    ; Test if dynamic variables currently available
  294.     IF [NOT] FKEY        ; Like HITKEY, test for ftn key pending
  295.     IF [NOT] FULL        ; Test if we have XOFFed host
  296.     IF [NOT] OVERLAY    ; Test if overlay currently loaded
  297.     IF [NOT] XOFF        ; If currently XOFFed by host
  298.     LOAD ALLOCATED <fname>    ; Load allocated variables from a file
  299.     OVERLAY <fname>     ; Load a machine language overlay (EXE or COM)
  300.     OVERLAY CLEAR        ; Clear overlay if loaded
  301.     RND <modulus> Nx    ; Rtn random # between 0 and <modulus-1>
  302.     SCALL <addr> [<parms>]    ; Call a machine language routine
  303.     SCREEN y1,x1 y2,x2 <attr> Sx ; Multi-line window display
  304.                 ; Displays from variables: Sx to S(x+(x2-x1))
  305.     STORE ALLOCATED <fname> ; Store allocated variables to a file
  306.  
  307.     SET BAR <attr>        ; Set status bar fore/background
  308.     SET DEFAULT <attr>    ; Set menu window fore/background
  309.     SET DOSLEVEL <num>    ; Set COM-AND exit-to-DOS return value
  310.     SET INAFTER ON!OFF    ; Set Init modem after hangup
  311.     SET RDMA <number>    ; Set max # redials for DIAL statement
  312.     SET RTSF ON!OFF     ; Set RTS flow control (set HARDFLOW on too)
  313.     SET TEXT <attr>     ; Set text area fore/background
  314.     SET WATCHDOG <number>    ; Set XOFF watchdog timer (seconds)
  315.  
  316.  
  317.     ------------------------------------------
  318.     Script language intrinsic functions added:
  319.     ------------------------------------------
  320.  
  321.     _ALLO            ; Rtns # allocated variables (0,1,2...100)
  322.     _DOW            ; Rtns # (0 = Sunday, 1 = Monday, etc)
  323.     _INAF            ; Rtns ON/OFF (Init modem after hangup)
  324.     _LEGE            ; Rtns user set legend text
  325.     _OVER            ; Rtns overlay file name or NULL
  326.     _RDMA            ; # redials allowed during DIAL statement
  327.     _RDPN            ; Pass number during which last DIAL connected
  328.     _RTSF            ; Rtns ON/OFF state of RTS flow control
  329.  
  330.  
  331. -------------------------------------------------------------------------------
  332. 900426                  COM-AND 2.6                Page  8
  333. -------------------------------------------------------------------------------
  334. Updated scripts in CA26-3:
  335. -------------------------------------------------------------------------------
  336.  
  337. BREAKOUT.CMD            ; Speed improved
  338.  
  339. DIALER.CMD            ; Modified to work with more modem types
  340.  
  341. LISTER.CMD            ; Minor modifications
  342.  
  343. REMAP.CMD            ; Modified to catch circular redefinitions
  344. REMAP.DOC            ; Updated to amplify discussion
  345.  
  346. SCRDUMP.CMD            ; New, screen dump script
  347.  
  348. STRIPPER.CMD            ; Fixed handling of long line, when the 80 col
  349.                 ; .. break occurs within a blank string: "  "
  350.  
  351. TELENET.CMD            ; Minor modifications
  352.  
  353. UNISON.CMD            ; Minor modifications
  354.  
  355. -------------------------------------------------------------------------------
  356. Known bugs in the current release:
  357. -------------------------------------------------------------------------------
  358.  
  359.  
  360. o    KERMIT 12 and 16 bit checksums don't seem to work with Jan van der
  361.     Eyjk's PCKERMIT.  I have not yet found the incompatibilty.
  362.  
  363. o    Reports came, but could not be reproduced, of the CPU clock losing
  364.     time.  Now reports have come in suggesting that the clock speeds
  365.     up (!) when run in the background under DesqView.
  366.  
  367.     No instances have been found due to COM-AND.  Several instances have
  368.     been tracked to TSR's and special hardware (e.g. ALL-Charge card).
  369.  
  370.  
  371. -------------------------------------------------------------------------------
  372. 900426                COM-AND 2.6                Page  9
  373. -------------------------------------------------------------------------------
  374. Related release; PC-VCO:
  375. -------------------------------------------------------------------------------
  376.  
  377.  
  378.     PC-VCO is Visual Conferencing for the IBM PC.  It is completely
  379.     compatible with all three flavors of MacIntosh VCO/VMCO.  It has
  380.     been in use for more than a year by several groups of people.  On
  381.     GEnie, the IBM RT has a regularly scheduled VCO conference every
  382.     Wednesday at 9PM Eastern Standard Time.
  383.  
  384.  
  385.     The concept of VCO is that each conference attendee draws a set of
  386.     16 (or 18) ICONs, and posts them publically.  Other attendees down-
  387.     load the ICONs (called face files), and add them to their own lib-
  388.     rary of faces.    8 (or 9) expressions (happy, sad, etc) are supported.
  389.     When someone speaks in a VCO conference, the appropriate ICON is
  390.     displayed on all PC-VCO screens.  People who've not uploaded face
  391.     files are depicted as Charlie Brown, Don Martin, or OPUS.
  392.  
  393.  
  394.     PC-VCO interfaces to a public domain text-to speech synthesizer.
  395.     The quality is less than might be desired, but its a start!
  396.     PC-VCO now includes its own speech driver for faster processors.
  397.  
  398.  
  399.     PC-VCO has been distributed (its seventh release) as PC-VCO22.ARC.
  400.     PC-VCO may be used on either CGA, EGA or Hercules graphics adapters.
  401.  
  402. -------------------------------------------------------------------------------
  403. Related release; CCHESS:
  404. -------------------------------------------------------------------------------
  405.  
  406.     CCHESS is Conference Chess - two people can play chess over PLINK's
  407.     PARTY, CIS CB, etc.  CCHESS provides a graphics depiction of a chess
  408.     board, and a log of the last few moves.  Game play can be performed
  409.     entirely with a mouse (if you desire - not necessary).    Games may be
  410.     saved, and restored later for continuation.
  411.  
  412.  
  413.     Version 1.2 is a production release - beta testing is complete.
  414.     However,  I am still looking for comments, criticisms and thoughts
  415.     from those interested in on-line interactive gaming.
  416.  
  417.  
  418.     CCHESS has been distributed (its second release) as CCHESS12.ARC.
  419.     Please read the CCHESS.DOC document for a description of CCHESS.
  420.     CCHESS may be used on either CGA, EGA or Hercules graphics adapters.
  421.  
  422.  
  423. -------------------------------------------------------------------------------
  424. 900426                COM-AND 2.6                Page 10
  425. -------------------------------------------------------------------------------
  426. Related release; CBRIDGE:
  427. -------------------------------------------------------------------------------
  428.  
  429.     CBRIDGE is Conference Bridge - four people can play bridge over
  430.     PLINK's PARTY, CIS CB, etc.  CBRIDGE deals cards, displays hands,
  431.     displays (and protects) the bidding, and monitors game play.
  432.     Bidding can be reviewed at any time, as can game play.
  433.  
  434.  
  435.     Version 1.1 has completed its beta trials.  It has found quite
  436.     usable.  It may be 'rough' in spots...  I am looking for comments,
  437.     criticisms and thoughts from those interested in on-line interactive
  438.     gaming.
  439.  
  440.     CBRIDGE has been distributed (its first release) as CBRIDG11.ARC.
  441.     Please read the CBRIDG.DOC document for a description of CBRIDGE.
  442.     CBRIDGE may be used on either MDA, CGA, EGA or Hercules adapters.
  443.  
  444.  
  445. -------------------------------------------------------------------------------
  446. Related release; CCOLOR:
  447. -------------------------------------------------------------------------------
  448.  
  449.     CCOLOR is another accessory for conferencing.  It tracks the conver-
  450.     sation, and assigns different colors to each speaker.  Each speaker's
  451.     text is highlighted and easy to see.  Of course, a color adapter,
  452.     CGA or EGA is required.  It has to be seen to be appreciated!
  453.  
  454.  
  455.     CCOLOR has been distributed (its second release) as CCOLOR11.ARC.
  456.     CCOLOR may be used on either CGA, or EGA adapters.
  457.  
  458.     -------------------------------------------------------------------
  459.     A new release of CCOLOR (1.2) may be expected shortly after COM-AND
  460.     2.6's release, with screen clock and chat mode additions.
  461.     -------------------------------------------------------------------
  462.