home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 485.lha / BackTalk_v1.10 / BackTalk.doc.pp / BackTalk.doc
Text File  |  1991-03-10  |  31KB  |  758 lines
  1.                                BackTalk 1.10
  2.  
  3.             Copyright 1991 by Steve Ahlstrom and Don Curtis
  4.  
  5.  
  6. Copyright and Distribution Notice:
  7.  
  8. BackTalk is a copyrighted program.  BackTalk is freely distributable
  9. provided the following files (listed below) remain UNCHANGE and AS A WHOLE
  10. in LHARCIVE FORM along with this notice.
  11.  
  12. All rights to the program BackTalk and all files in this archive, except
  13. where specifically noted, remain the property of Steve Ahlstrom and Don
  14. Curtis.
  15.  
  16. BackTalk may not be sold or distributed for any fee.  The exception to this
  17. is that BackTalk may be included on any Amiga User Group Club disks on which
  18. BackTalk is not the only program on the disk and the disk does not sell for
  19. more than $10US. 
  20.  
  21.  
  22. Disclaimer:
  23.  
  24. No warranty is offered and no fitness for any particular purpose is claimed.
  25. Every effort has been made for this software to perform as indicated in
  26. the documentation.  However, nothing is perfect.
  27.  
  28.  
  29. Credits:
  30.  
  31. Thanks to the creators of the XPR library specification. 
  32.  
  33. Thanks to the authors of the various XPR libraries.  Do be aware than that,
  34. depending upon implementation, some of these libraries work better than
  35. others.
  36.  
  37. Thanks to Khalid Aldoseri for this File Requester library, his considerable
  38. help and expertise with suggestions, coding hints, and support all while he
  39. was constantly donning his gas mask and seeking shelter from SCUD attacks.
  40.  
  41. And special thanks to the corp of BackTalk testers who include, but are not
  42. limited to, Khalid Aldoseri, Bob Rakosky, Steve Pietrowicz, Betty Clay, 
  43. David Art, Brian Bartlett, Vic Wagner, Jim Williams (eet), Michael McCormick, 
  44. and Rick Stevens.
  45.  
  46.  
  47. Files in this LHARCHIVE:
  48.  
  49. BackTalk                  This is the terminal program "BackTalk"
  50. BackTalk.info             Icon for BackTalk
  51. BackTalk.doc              This file
  52.  
  53. *frqlib.lzh               Khalid Aldoseri's File Requester library (ver 2.0).
  54.                           This is the full distribution of the library,
  55.                           auxillary programs, user documentation, and
  56.                           programmer documentation.
  57.  
  58.                           Release 3.0 of Khalid's file requester library
  59.                           is due to be released "any day now" (as of the
  60.                           the date this is written, 24 Feb 1991).  It
  61.                           is fully backward compatible with previous
  62.                           versions and with BackTalk's calls to the
  63.                           library.
  64.                           
  65.  
  66. *xprquickb.library        Jack Rousse's CompuServe QuickB XPR library
  67.                           updated and modified by Don Curtis
  68.  
  69. *xprzmodem.library        Rick Huebner's XPR Zmodem library version 2.1.
  70.                           Previous versions of this library will NOT
  71.                           work with BackTalk and will likely cause
  72.                           a guru.
  73.  
  74. *xprascii.library         an ascii XPR library distributed with the
  75.                           XPR 2.0 specification
  76.  
  77. * These files freely distributable and all rights to them remain with
  78.   their authors.
  79.  
  80. ---------------------------------------------------------------------------
  81.  
  82.                                  BackTalk
  83.  
  84.     A general purpose TTY-type telecommunications program for the Amiga
  85.  
  86. Feature Overview:
  87.  
  88.    - Supports the XPR specification.  You may use any file transfer protocol
  89.      for which there exists an XPR library implementation.  At the time of
  90.      this writing there exists XPR libraries for CompuServe QuickB, Zmodem,
  91.      Xmodem, Kermit, and Ascii.
  92.  
  93.    - Fully supports user selected fonts, including proportional fonts.
  94.  
  95.    - ARexx interface
  96.  
  97.    - Full featured Review Buffer
  98.  
  99.    - Program will operate in a 1 or a 2 bit plane custom screen or in
  100.      a workbench window.
  101.  
  102.    - If run in a hi-res/interlaced environment, a "split" is provided 
  103.      (half screen)
  104.  
  105.    - Capture Buffer for saving text to a file
  106.  
  107.    - Chat Window for network conferencing.  
  108.    
  109.    - Color requester for loading and saving color choices
  110.    
  111.    - Phone book limited only by available memory.  Baud rate loaded from
  112.      phone book entry.
  113.  
  114.    - Real time clock
  115.  
  116.    - A non-graphic Print Screen function
  117.  
  118.    - Print feature for echoing incoming text to a printer
  119.  
  120.    
  121.  
  122. Minimum System Requirement:
  123.  
  124. Amiga 500/1000/2000/3000 with a minimum of 512k and 1 floppy drive
  125. Modem: 300/1200/2400/4800/9600
  126.  
  127. ---------------------------------------------------------------------------
  128.  
  129.                             How to Use BackTalk
  130.  
  131. Before running BackTalk for the first time, decompress frqlib.lzh and place 
  132. kd_freq.library, xprquickb.library, xprzmodem.library and xprascii.library 
  133. files in your LIBS: logical directory.  Library file names are case sensitive, 
  134. please do not change them.  BackTalk will not run without kd_freq.library and
  135. xprquickb.library.
  136.  
  137. BackTalk will open its screen/window in whatever resolution your computer
  138. is in at the time the program is run.  When BackTalk loads, it looks for 3
  139. files, BT.CFG (its configuration file), BT.MACROS (it's macro key file),
  140. and BT.PHONES (its phone book data file).  BackTalk will look in the current
  141. directory for these files.  If it does not find them there, it will look in
  142. S:.  Since first time users will not have these files, BackTalk will put up
  143. a requester informing the user that the files cannot be found and will then
  144. use its internal defaults.
  145.  
  146. FIRST TIME USERS, PLEASE TAKE NOTE.  When BackTalk attempts to load its
  147. data files (BT.CFG, BT.MACROS, and BT.PHONES) it looks FIRST to your current
  148. directory.  If not found it then looks to S:.  When you create these files
  149. they will be saved to where ever they were read from (current directory or
  150. S:).  This means that for first time use they will not be read from S:.
  151. The files will be saved to current directory.  If you want these files to
  152. be in S: in future runs of the program, you must copy them there after
  153. BackTalk creates them.  From then on, when updating these files from within
  154. BackTalk, they will be saved to S: because they were read in from S:.
  155.  
  156. The most coherent method to document BackTalk is to describe the function
  157. of its menu items (from left to right) and their subitems.
  158.  
  159. Menu: BackTalk
  160.    SubItem: About
  161.       Hot Key: Right-Amiga-A
  162.  
  163.       This brings up a "credits" requester containing copyright, support,
  164.       and distribution information.
  165.  
  166.    SubItem: Hangup
  167.       Hot Key: Right-Amiga-H
  168.  
  169.       This will cause your modem to hang up the phone.  This is done by
  170.       dropping DTR.  If your modem is setup to ignore DTR or you are using
  171.       a 3 wire serial cable between your computer and your modem, this
  172.       command has detects that dropping DTR had no effect and will then
  173.       send the standard Hayes compatible "+++ATH" string to your modem.
  174.  
  175.    SubItem: Quit
  176.       Hot Key: Right-Amiga-Q
  177.  
  178.       This will terminate the program.
  179.  
  180. Menu: Phone
  181.    SubItem: Dial...
  182.    Hot Key: Right-Amiga-P
  183.  
  184.       This brings up the Phone Directory.
  185.  
  186.       The Phone Directory displays 10 entries.  If there are more than 10
  187.       entries, you may scroll through them using the UP and DOWN arrow keys.
  188.       
  189.       You may select the entry to dial by using the mouse and clicking upon 
  190.       the entry or by typing the number to the left of the entry from the 
  191.       keyboard.  This will place the entry into the string gadgets below.  
  192.       You may dial the entry by clicking on the gadget labeled "Dial" or by 
  193.       typing "D" from the keyboard.  The phone number will be sent to the
  194.       modem with a terminating carriage return.  
  195.  
  196.       If for any reason you do not want the carriage return sent, in the
  197.       phone number portion of that entry, place an asterisk (*) as the last
  198.       character in the phone number (see "Adding Phone Book Entries" and
  199.       "Editing Phone Book Entries" below).  When "Dial" is clicked upon or
  200.       the letter "D" is typed, the phone number will be sent to the modem
  201.       without a terminating carriage return.
  202.  
  203.       Adding Phone Book Entries:
  204.       To add a phone book entry, click on the "Add" gadget with the mouse.
  205.       This will activate the "System" string gadget.  Type in the name and
  206.       then type return.  The "Phone" string gadget will now be activated.
  207.       Enter the phone number to be dialed and type a  return.  The "Comment"
  208.       string gadget will be activated.  Enter a comment if you wish, and
  209.       type return.  The "Baud" string gadget will be activated.  In this
  210.       string gadget the current baud rate will be displayed.  If you wish this
  211.       Phone Book entry to have a different baud rate, enter it here, otherwise
  212.       just hit return.  Should you enter an invalid baud rate, (ie, NOT 300,
  213.       1200, 2400, 4800, 9600, or 19200) the current baud rate will be used and
  214.       saved with the Phone Book entry.  The "Modem Prefix" string gadget will 
  215.       be activated.  The "Modem Prefix" string gadget serves two purposes.  
  216.       The information entered here will be prepended to the phone number when 
  217.       it is sent to the modem.  This is also a "terminator" field for the Phone
  218.       Book entry.  If you do not type a return in this gadget the Phone Book 
  219.       entry will not be added.  By default, an "ATDT" is placed in the "Modem 
  220.       Prefix" string gadget.  If this is acceptable, just type a carriage 
  221.       return, if not, enter your dialing prefix and type a carriage return.
  222.  
  223.       Editing Phone Book Entries:
  224.       To edit an existing Phone Book entry, select the entry to be edited by
  225.       clicking upon the entry or by typing the number of the entry.  The
  226.       entry will be placed into the string gadgets below.  Click the mouse
  227.       on the string gadget you wish to change and make your changes.  When
  228.       you type a carriage return in the "Modem Prefix" string gadget, the
  229.       changes will be accepted.
  230.  
  231.       Deleting Phone Book Entries:
  232.       To delete an existing Phone Book entry, select the entry to be deleted
  233.       by clicking upon the entry of by typing the number of the entry.  The
  234.       entry will be placed into the string gadgets below.  Click the mouse 
  235.       on the "Delete" gadget.  The entry will be removed from the list.
  236.  
  237.       The Phone Book entries are "hot keyable" from within the requester by
  238.       using the number keys 1-1(0).  The Dial and Exit gadgets are also hot
  239.       keyable using the D and E keys, respectively.  
  240.  
  241.       If there have been any changes to the Phone Book those changes will be
  242.       written to the file BT.PHONES when you exit the Phone Book (by using
  243.       the Dial or Exit gadgets).
  244.  
  245.    SubItem: Redial
  246.    Hot Key: Right-Amiga-$
  247.  
  248.       This will cause the last dialed Phone Book entry to be dialed again.
  249.  
  250. Menu: Serial
  251.    SubItem: Serial Definitions...
  252.    Hot Key: Right-Amiga-*
  253.  
  254.        This brings up the Serial Definitions requester.  Most of the items
  255.        within this requester are self explanatory.
  256.  
  257.       If you are using a modem or a serial card that requires the use of a
  258.       serial device driver other than the CBM supplied "serial.device" make
  259.       sure that device driver is located in your LIBS: directory.  Enter
  260.       the name of the device driver (the name is case sensitive) into the
  261.       "Device Name" string gadget.  If a unit number other than 0 is 
  262.       required, enter the unit number into the "Unit #" string gadget (check 
  263.       the documentation for your non-CBM supplied device driver for this 
  264.       information.
  265.    
  266.       NOTE:  There appears to be a problem with CBM's serial.device that
  267.       is distributed with the A2232 card.  The symptom is that when a unit
  268.       number other than 0 is being used, attempting to close and reopen the
  269.       port while online will cause BackTalk to hang.
  270.  
  271.       To exit the Serial Definitions requester, click on the Cancel or Use
  272.       gadgets, or type the letter C or U.  If you have made changes and 
  273.       selected "Use", those changes will go into effect immediately.  By 
  274.       selecting "Cancel" all changes will be negated and your serial 
  275.       definitions will remain as they were before you entered the Serial 
  276.       Definitions requester.
  277.  
  278.    SubItem: Send Break
  279.    Hot Key: Right-Amiga-~ (tilde)
  280.  
  281.       This sends a break signal.
  282.  
  283. Menu: Files
  284.    SubItem: Protocols...
  285.    Hot Key:  NONE
  286.  
  287.       BackTalk utilizes the XPR protocol specification.  This menu item will
  288.       bring up a file requester from which you may load the xpr library you
  289.       would like to use.  By default, the file requester will display files
  290.       in LIBS: that begin with XPR#?.
  291.  
  292.    SubItem: Download
  293.    Hot Key: Right-Amiga-D
  294.  
  295.       When selected you will be presented with a file requester for you to
  296.       indicate the path and file name of where the download will be written.
  297.       Some transfer protocols are "autostart" meaning that when you tell
  298.       the system you are calling that you want to download a file the file
  299.       transfer starts automatically.  You will be prompted for the location
  300.       of where the file will be written.  In this case, the DOWNLOAD menu
  301.       option will be ghosted.
  302.    
  303.       An example of an autostart protocol is CompuServe QuickB protocol.
  304.       You would simply type "DOW filename", Compuserve will respond with
  305.       "Filename for your computer".  You would respond with the 
  306.       path/filename of the file you are downloading.  The transfer will 
  307.       start automatically at that point.
  308.  
  309.    SubItem: Upload
  310.    Hot Key: Right-Amiga-U
  311.  
  312.       Same as DOWNLOAD only in the reverse direction.
  313.  
  314.    SubItem: Capture On
  315.    Hot Key: Right-Amiga-O
  316.  
  317.       A file requester will be presented with the default path and filename
  318.       taken from the path and filename you indicated in the Global Options
  319.       requester (more on the Global Options requester later).  If this is
  320.       acceptable, hit return and the capture file will be opened.  If it is
  321.       not acceptable, enter the desired path and filename.
  322.       
  323.       Should you open a capture file, and that file already exists, the
  324.       new information will be appended to the existing file rather than
  325.       overwriting the existing file.
  326.  
  327.    SubItem: Capture Off
  328.    Hot Key: Right-Amiga-C
  329.    
  330.       This turns off the capture buffer and closes the capture file.
  331.  
  332. Menu: Review
  333.    SubItem: Show Review
  334.    Hot Key: Right-Amiga-R
  335.  
  336.       This opens the Review Buffer.  The Review Buffer is a circular buffer,
  337.       16k in size.  You may move around in the Review Buffer by using the
  338.       up arrow and down arrow keys to scroll a line at a time.  Shifted up 
  339.       or   down arrows will scroll a page at a time.  ALT up and down arrow 
  340.       will move you to top or bottom of file, respectively.  Clicking the 
  341.       mouse   upper half of the display will scroll the display up one page.
  342.       Clicking the mouse in the lower half of the display will scroll the
  343.       display down one page.
  344.  
  345.       The Review Buffer has a menu attached that allows you to print the
  346.       current screen or print the entire review buffer.  You may also
  347.       exit the Review Buffer via the menu.  Other methods to exit the
  348.       Review Buffer is to type Right-Amiga-Q, type ESC, or type HELP.
  349.       If you are running in a workbench window, there will also be a
  350.       Close Box in the upper left corner.
  351.  
  352.    SubItem: Save Review
  353.    Hot Key: NONE
  354.  
  355.       This brings up a file requester with the path "RAM:ReviewBuff" as
  356.       the default.  If this is acceptable hit return or click on the
  357.       SAVE button.  If it is not acceptable, enter the desired path and
  358.       file.
  359.  
  360. Menu: Print
  361.    SubItem: Print Screen
  362.    Hot Key: Right-Amiga-Z
  363.  
  364.       This will send what is currently displayed on BackTalk's screen to 
  365.       your prt:.
  366.  
  367.    SubItem: Print Review
  368.    Hot Key: Right-Amiga-!
  369.    
  370.       This will send the contents of the Review Buffer to prt:.
  371.  
  372.    SubItem: Echo Printer
  373.    Hot Key: Right-Amiga-E
  374.  
  375.       All text that is displayed on BackTalk's screen will be echoed to
  376.       prt:.
  377.  
  378. Menu: Configuration
  379.    SubItem: Global Options
  380.    Hot Key: NONE
  381.  
  382.       This brings up the Global Options requester.  Here you specify
  383.       the default Upload and Download directories and the default name
  384.       of the Capture file.
  385.  
  386.       BackTalk utilizes proportional fonts.  Even if the font you have
  387.       selected is not proportional, it is treated as such.  When using
  388.       the Chat Window (described in more detail later) lines are
  389.       "auto sent" when a maximum line length is reached.  This line
  390.       length is based upon the pixel length of the line, not the 
  391.       character length of the line.  You may, in the Global Options
  392.       requester, specify at what pixel length the line should be sent.
  393.       You are shown the current maximum line length, in pixels, that
  394.       is possible (based upon your horizontal resolution) and may enter
  395.       a different value in the string gadget.  This feature is basicly
  396.       a trial and error adventure depending on the font you are using.
  397.  
  398.       When using the Chat Window, as mentioned above, lines are auto sent
  399.       if a maximum line length is reached before a carriage return is
  400.       entered.  You may elected to have a "..." automatically appended to
  401.       all lines that are auto sent from the Chat Window.  Appending the
  402.       dots is especially user when in a conferencing area to indicate to
  403.       others that you are not through typing.  However, it can become a
  404.       nuisance if you are leaving a message while using the Chat Window.
  405.       In the Global Options requester you may select to have the dots
  406.       appended or not.
  407.  
  408.       Also in the Global Options requester are two string gadgets, labeled
  409.       "Modem Init Command" and "Modem Exit Command".  Whatever string is
  410.       in the Moden Init Command string gadget will be sent to the serial
  411.       port immediately upon starting BackTalk.  The Modem Exit Command
  412.       string will be sent to the serial port just prior to terminating
  413.       BackTalk.  If you do not want these strings to be sent, clear
  414.       these string gadgets.
  415.  
  416.    SubItem: Split
  417.    Hot Key: Right-Amiga-S
  418.  
  419.       If you are running BackTalk in a hi resolution/interlaced mode, the
  420.       Split command will reduce the size of BackTalk's window to half
  421.       screen.  Split is a toggle.  If BackTalk is in half size mode, 
  422.       selecting split again will return it to full screen size.
  423.       The state of this item is saved in the BT.CFG file.
  424.  
  425.    SubItem: Screen - 1 Plane
  426.    Hot Key: Right-Amiga-1
  427.       
  428.       Causes BackTalk to be run in a 1 bit plane custom screen.
  429.       The state of this item is saved in the BT.CFG file.
  430.  
  431.    SubItem: Screen - 2 Plane
  432.    Hot Key: Right-Amiga-2
  433.    
  434.       Causes BackTalk to be run in a 2 bit plane custom screen.
  435.       The state of this item is saved in the BT.CFG file.
  436.  
  437.    SubItem: Workbench Screen
  438.    Hot Key: Right-Amiga-3
  439.  
  440.       Causes BackTalk to be run in a workbench window.
  441.       The state of this item is saved in the BT.CFG file.
  442.  
  443.    SubItem: Borders On/Off
  444.    Hot Key: Right-Amiga-B
  445.  
  446.       This is a toggle which turns the window borders on or off.
  447.       The state of this item is saved in the BT.CFG file.
  448.  
  449.    SubItem: Set Colors
  450.    Hot Key: NONE
  451.  
  452.       This brings up a color requester.  You may change the colors of the
  453.       program with this requester.  This menu item is ghosted if you are
  454.       running BackTalk from a workbench window.
  455.       The state of this item is saved in the BT.CFG file.
  456.  
  457.    SubItem: Fonts
  458.       SubSubItem: Diskfonts...
  459.       Hot Key: Right-Amiga-F
  460.          
  461.          This brings up a file requester defaulted to FONTS:.  Select the
  462.          font you wish to use, then select the point size, and click
  463.          on use.  The state of this item is saved in the BT.CFG file.
  464.          
  465.       SubSubItem: Topaz 8
  466.       Hot Key: Right-Amiga-8
  467.       
  468.          Since Topaz is a rom font it will not show up in the Fonts
  469.          file requester.  This item will select the Topaz 8 font.
  470.          The state of this item is saved in the BT.CFG file.
  471.  
  472.       SubSubItem: Topaz 9
  473.       Hot Key: Right-Amiga-9
  474.  
  475.          Since Topaz is a rom font it will not show up in the Fonts
  476.          file requester.  This item will select the Topaz 9 font.
  477.          The state of this item is saved in the BT.CFG file.
  478.  
  479.    SubItem: Macros
  480.    Hot Key: NONE
  481.  
  482.       This brings up the Macros requester.  Simply click on the FKey
  483.       gadget of your choice, enter the text into the string gadget and
  484.       type return in the string gadget.  To enter a carriage return 
  485.       into your macros, type a ^M (either the 2 separate characters ^
  486.       and M or the 2 keys together.  The same goes for any control 
  487.       character you'd like to embed in a macro).  If you exit the 
  488.       Macro requester by selecting SAVE your macros will be written to
  489.       the file BT.MACROS.
  490.  
  491.    SubItem: Chat Window
  492.    Hot Key: Right-Amiga-W
  493.  
  494.       This toggles the Chat Window on and off.  Text typed into the Chat
  495.       Window will be sent to the serial port when a carriage return is
  496.       typed or when the length of the line exceeds the maximum line length
  497.       (see Global Options for more information on the maximum line length).
  498.       Because lines are auto sent from the Chat Window an insert mode
  499.       is not provided.  You may move the cursor on the line in the Chat
  500.       Window with the left and right arrow keys.  If you type over text you
  501.       will be "typing over text" rather than inserting new text.
  502.  
  503.       A ctrl-X typed in the Chat Window will clear the current line.
  504.       A ctrl-Y typed in the Chat Window will delete the text from the cursor
  505.       position to the end of the line.
  506.  
  507.       The Chat Window features a 20 line Chat History Buffer.  This is a
  508.       circular buffer.  You move through previously send line by using the
  509.       the up and down arrow keys.
  510.  
  511.       Using the Chat Window in Compuserve's Conferenicng or CB areas:
  512.       If the beginning of a line is "/sen nn" (where nn is a "job number")
  513.       and the line is auto sent before a carriage return is entered, the
  514.       unsent text will be wrapped to the next line and PREpended with
  515.       the "/sen nn" from the previous line.  This helps prevent embarassing
  516.       moments if the first /sen line is auto sent and the user neglects to
  517.       type "/sen nn" on the following line.
  518.  
  519.       Sending control characters from the Chat Window to the serial port is
  520.       sometimes necessary.  BackTalk will send ctrl-C, ctrl-O, ctrl-P, ctrl-Q,
  521.       ctrl-S, and ctrl-Z from the Chat Window to the serial port.  All others
  522.       are ignored.
  523.  
  524.       When the Chat Window is active, a gadget labeled /SEN is located
  525.       on the right side of the bottom status line.  When the /SEN gadget
  526.       is clicked upon a string gadget will appear to it's right.  This
  527.       gadget is used to make it more convenient to have a /SEN converation
  528.       (private conversation) with someone in CompuServe's Conferencing or
  529.       CB areas.  When the the /SEN gadget is activated and a job number
  530.       is entered into the string gadget, all lines in the Chat Window will
  531.       be prepended with "/SEN nn" (where nn is the job number).
  532.  
  533.       The state of this item is saved in the BT.CFG file.
  534.  
  535.    SubItem: Append "..."
  536.    Hot Key: Right-Amiga-. (period)
  537.  
  538.       This function was decribed in more detail under Global Options.
  539.       It is another way (that is "hot keyable") to turn on and off the
  540.       append dots feature of lines auto sent from the Chat Window.  When
  541.       this option is selected a "box" will appear on the far right side of
  542.       the Chat Window bar (the bar separates the main communications window
  543.       from the Chat Window).  This gives you a visual indication that you
  544.       have selected the Send Dots feature.
  545.       The state of this item is saved in the BT.CFG file.
  546.  
  547.    SubItem: Double Click XON/XOFF
  548.    Hot Key: NONE
  549.       
  550.       A check marked menu item that toggles on and off the ability to double
  551.       click the mouse to send an xon/xoff.  The state of this item is saved
  552.       in the BT.CFG file.
  553.  
  554.    SubItem: CTRL-U From Chat
  555.    Hot Key: NONE
  556.  
  557.       A check marked menu item that prepends a ^U to all lines sent from
  558.       the Chat Window.  This option is CompuServe specific.  If you are using
  559.       the Chat Window and you are experiencing line noise, a ^U will clear
  560.       CompuServe's input buffer (get rid of the noise) before you line is
  561.       sent.  The state of this item is saved in the BT.CFG file.
  562.    
  563.  
  564.    SubItem: Save Configuration
  565.    Hot Key: NONE
  566.  
  567.       Selecting this item causes all current user selectable options to
  568.       be written to the file BT.CFG.  This includes the current selection
  569.       of protocol, colors, fonts, split or full window, 1 bit plane screen,
  570.       2 bit plane screen, or workbench screen, modem init and modem exit
  571.       strings, what window off or on, borders off or on, send dots off or
  572.       on, all serial parameters -- ANYTHING the user may select or change
  573.       from the default configuration.
  574.  
  575.  
  576. ---------------------------------------------------------------------------
  577.  
  578.                        Other Features and Functions
  579.  
  580.  
  581. ARexx:
  582.  
  583. BackTalk has an ARexx port.  In the initial release of BackTalk ARexx
  584. scripts are not executable from within BackTalk but BackTalk may be
  585. controlled externally by an ARexx script.  A future update will provide
  586. internal capabilities.
  587.  
  588. Since BackTalk may be run more than once, different iterations of the progrm 
  589. will have a uniquely named ARexx port.  In the first iteration it is 
  590. named BT_REXX. The second iteration is BT_REXX2, the third is 
  591. BT_REXX3, etc.
  592.  
  593. Quote all string arguments in your BackTalk ARexx scripts.
  594.  
  595. Following are the ARExx command currently supported:
  596.  
  597. WAITFOR  Usage: WAITFOR <string>
  598.    This command waits for the string.  ARexx is not replied to
  599.    until this string is found.
  600.  
  601. SEND  Usage: SEND <string>
  602.    Sends a string to the serial port with a terminating carriage return.
  603.  
  604. SENDNCR  Usage: SENDNCR <string>
  605.     The same as SEND however does not send a terminating carriage return
  606.  
  607. MESSAGE  Usage:  MESSAGE <string>
  608.    Sends a text message to the screen and to the review buffer 
  609.    but does not send it to the serial port.
  610.  
  611. FKEY  Usage FKEY <Fn | SFn> 
  612.    This will send one of BackTalk's fkey macros
  613.    returns a non-zero on failure.
  614.  
  615. OPENCAPTURE  Usage: OPENCAPTURE <filename | default from global options>
  616.    returns a non-zero on failure.
  617.  
  618. CLOSECAPTURE  Usage:  CLOSECAPTURE
  619.    closes the capture file
  620.  
  621. DISPLAYOFF  Usage: DISPLAYOFF
  622.    this turns off screen output.  Scrolling, cursor
  623.    positioning, etc. still takes place, just no text
  624.    is output to the screen.
  625.  
  626. DISPLAYON  Usage:
  627.    resume text display
  628.  
  629. BAUD  Usage: BAUD <rate>
  630.    returns a non-zero on failure.
  631.  
  632. PARITY  Usage: PARITY <Odd | Even | None>
  633.   returns a non-zero on failure.
  634.  
  635. DUPLEX  Usage: DUPLEX <Full | Half>
  636.    returns a non-zero on failure.
  637.  
  638. DLENGTH  Usage: DLENGTH <7 | 8>
  639.    returns a non-zero on failure.
  640.  
  641. STOPBITS  Usage: STOPBITS <1 | 2>
  642.    returns a non-zero on failure.
  643.  
  644. DEVICENAME <string>  Usage: DEVICENAME <device.name>
  645.    Should this command fail, the program will read bt.cfg and use
  646.    those values to reopen the serial port.  Of course, this will
  647.    negate any changes you may have made previously via the
  648.    PARITY, DUPLEX, DLENGTH, BAUD, and STOPBITS command.
  649.  
  650. UNITNUMBER <number>  Usage: UNITNUMBER <number>
  651.    This command has the same caveat as DEVICENAME.  If it fails
  652.    bt.cfg will be read and the serial port reopened with those
  653.    values.  A strange thing with unit number, tho.  Serial.device
  654.    will allow you to open using unit number 1, so the change is
  655.    successful altho BackTalk no longer talks to the modem.
  656.  
  657. PRINTERON  Usage: PRINTERON
  658.    turns on echo to printer
  659.  
  660. PRINTEROFF  Usage: PRINTEROFF
  661.    turns off echo to printer 
  662.  
  663. BEEP  Usage: BEEP
  664.    Flashes all screens
  665.  
  666. BLOCK  Usage: BLOCK
  667.    This function blocks all user input to BackTalk.
  668.    Block removes the menustrip and ignores all keyboard input.  Block puts 
  669.    up a requester to remind you that user input is being blocked.
  670.  
  671.    Note: Make sure that you issue either the UNBLOCK command or
  672.    the QUIT command before the ARexx script ends otherwise
  673.    you will not be able to communicate at all with BackTalk.
  674.  
  675. UNBLOCK  Usage: UNBLOCK
  676.    Restores the menustrip and again pays attention to keyboard input.
  677.    Unblock removes the informational requester.
  678.  
  679. SCREENTOBACK  Usage: SCREENTOBACK
  680.    If BackTalk is running in a non-workbench screen, this will push
  681.    the screen to the back.
  682.  
  683. SCREENTOFRONT  Usage: SCREENTOFRONT
  684.    If BackTalk is running in a non-workbench screen, this will push
  685.    the screen to the front.
  686.  
  687. HANGUP  Usage: HANGUP
  688.   This command works just like the Hangup menu item.
  689.   It drops DTR.  If CD was never set (dip flipped or using a 3 wire cable)
  690.   it will wait 60 ticks then send a "+++", delay(60), "ATH\r\n".
  691.  
  692. QUIT  Usage: QUIT
  693.    It does what it says, it will shutdown the program.
  694.  
  695. Following is an example ARexx script:
  696.  
  697. ---------------------------------------------------------------------------
  698.  
  699. /* Start BackTalk ARexx script */
  700. address command "run BackTalk"
  701. waitforport BT_REXX
  702.  
  703. if ~show('l', "rexxsupport.library") then
  704.    addlib('rexxsupport.library',0,-30,0) 
  705.  
  706. address BT_REXX 
  707. call delay 200
  708. BLOCK
  709. SEND "atmdt 555-1234"
  710. WAITFOR "CONNECT"
  711. call delay 50
  712. SENDNCR "^C"
  713. WAITFOR "User ID:"
  714. call delay 50
  715. DISPLAYOFF
  716. FKEY F2      /* this is an fkey macro, it sends my ppn and password */
  717.              /* in the form of 77777,1234\password                  */
  718.    
  719. call delay 100
  720. DISPLAYON
  721. SEND "G AmigaUser"
  722. WAITFOR "Welcome"
  723. WAITFOR "Forum !"
  724. OPENCAPTURE "ram:testing"
  725. SEND "RN"
  726. WAITFOR "Forum !"
  727. CLOSECAPTURE
  728. SEND "BYE"
  729. UNBLOCK
  730. QUIT
  731.  
  732. ---------------------------------------------------------------------------
  733.  
  734. Scroll Lock:
  735.  
  736. When a ^S is sent to the serial port, a text message, "Scroll Lock On" is
  737. displayed on the left side of bottom status line.  This is just a visual
  738. indication that a ^S has been send and incoming text will not be resumed
  739. until a ^Q is sent.
  740.  
  741. Mouse double click:
  742.  
  743. Double clicking the left mouse button sends a ^S to the modem.  Double
  744. clicking again sends a ^Q.  This feature is user selectable via the
  745. Configuration menu.  The state of this item will be saved in BT.CFG.
  746.  
  747.  
  748. Hot keyable requesters:
  749.  
  750. All gadget "buttons" in requesters in BackTalk, except for 2 exceptions 
  751. previously noted, are "hot keyable".  Just type the first letter in the name
  752. of the gadget.
  753.  
  754. ---------------------------------------------------------------------------
  755.  
  756. Many enhancements are planned for the future.  Please don't be shy with
  757. enhancement requests and bug reports.
  758.