home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 550a.lha / BackTalk_v1.46 / BackTalk.doc.pp / BackTalk.doc
Text File  |  1991-09-08  |  59KB  |  1,441 lines
  1.                                BackTalk 1.46
  2.                               August 11, 1991
  3.  
  4.             Copyright 1991 by Steve Ahlstrom and Don Curtis
  5.  
  6.  
  7. Copyright and Distribution Notice:
  8.  
  9. BackTalk is a copyrighted program.  BackTalk is freely distributable
  10. provided the following files (listed below) remain UNCHANGED and AS A WHOLE
  11. in LHARCIVE FORM along with this notice.
  12.  
  13. All rights to the program BackTalk and all files in this archive, except
  14. where specifically noted, remain the property of Steve Ahlstrom and Don
  15. Curtis.
  16.  
  17. BackTalk may not be sold or distributed for any fee.  The exception to this
  18. is that BackTalk may be included on any Amiga User Group Club disks on which
  19. BackTalk is not the only program on the disk and the disk does not sell for
  20. more than $10US.
  21.  
  22.  
  23. Disclaimer:
  24.  
  25. No warranty is offered and no fitness for any particular purpose is claimed.
  26. Every effort has been made for this software to perform as indicated in
  27. the documentation.  However, nothing is perfect.
  28.  
  29.  
  30. Credits:
  31.  
  32. Thanks to the creators of the XPR library specification.
  33.  
  34. Thanks to the authors of the various XPR libraries.  Do be aware than that,
  35. depending upon implementation, some of these libraries work better than
  36. others.
  37.  
  38. Thanks to Khalid Aldoseri for this File Requester library, his considerable
  39. help and expertise with suggestions, coding hints, and support all while he
  40. was constantly donning his gas mask and seeking shelter from SCUD attacks.
  41.  
  42. And special thanks to the corp of BackTalk testers who include, but are not
  43. limited to, Khalid Aldoseri, Larry, Phillips, Bob Rakosky, Steve Pietrowicz,
  44. Betty Clay, David Art, Brian Bartlett, Vic Wagner, Michael McCormick, and
  45. Rick Stevens.
  46.  
  47.  
  48. Files in this LHARCHIVE:
  49.  
  50. BackTalk                  This is the terminal program "BackTalk"
  51. BackTalk.info             Icon for BackTalk
  52. BackTalk.doc              This file
  53.  
  54. *frqlib.lzh               Khalid Aldoseri's File Requester library (ver 3.0).
  55.                           This is the full distribution of the library,
  56.                           auxillary programs, user documentation, and
  57.                           programmer documentation.
  58.  
  59.                           Release 3.0 of Khalid's file requester library
  60.                           is due to be released "any day now" (as of the
  61.                           the date this is written, 24 Feb 1991).  It
  62.                           is fully backward compatible with previous
  63.                           versions and with BackTalk's calls to the
  64.                           library.
  65.  
  66.  
  67. *xprquickb.library        Jack Rousse's CompuServe QuickB XPR library
  68.                           updated and modified by Keith Young.
  69.  
  70. *xprzmodem.library        Rick Huebner's XPR Zmodem library version 2.1.
  71.  
  72. *xprascii.library         an ascii XPR library distributed with the
  73.                           XPR 2.0 specification
  74.  
  75. About_XPR                 A text file describing the various user
  76.                           options for the enclosed XPR libraries
  77.  
  78. *and various example ARexx scripts
  79.  
  80. * These files freely distributable and all rights to them remain with
  81.   their authors.
  82.  
  83. ---------------------------------------------------------------------------
  84.  
  85.                                  BackTalk
  86.  
  87.     A general purpose TTY-type telecommunications program for the Amiga
  88.  
  89. Feature Overview:
  90.  
  91.    - Supports the complete XPR specification.  You may use any file transfer
  92.      protocol for which there exists an XPR library implementation.  At the
  93.      time of this writing there exists XPR libraries for CompuServe QuickB,
  94.      Zmodem, Xmodem, Kermit, and Ascii.
  95.  
  96.    - Fully supports user selected fonts, including proportional fonts.
  97.  
  98.    - ARexx interface - callable internally and externally
  99.      113 ARexx commands and growing
  100.  
  101.    - ARexx scripts callable from FKey macros
  102.  
  103.    - Full featured Review Buffer
  104.  
  105.    - User sizable Review Buffer, from 8k to available ram.
  106.  
  107.    - "Live" Review Buffer.  You may use the review buffer while continuing
  108.      to interact with the communications window.
  109.  
  110.    - Sizable Review Buffer window
  111.  
  112.    - Program will operate in a 1 or a 2 bit plane custom screen or in
  113.      a workbench window.
  114.  
  115.    - If run in a hi-res/interlaced environment, a "split" is provided
  116.      (half screen)
  117.  
  118.    - Capture Buffer for saving text to a file
  119.  
  120.    - Chat Window for network conferencing.
  121.  
  122.    - Color requester for loading and saving color choices
  123.  
  124.    - Phone Book limited only by available memory
  125.  
  126.     - Double click dialing
  127.  
  128.    - Phone Book entries carry their own configuration and macro
  129.      files
  130.  
  131.    - Real time clock
  132.  
  133.    - A non-graphic Print Screen function
  134.  
  135.    - Print feature for echoing incoming text to a printer
  136.  
  137.    - Screen text is restored when moving from one display configuration
  138.      to another or in and out of the Chat Window
  139.  
  140. Minimum System Requirement:
  141.  
  142. Amiga 500/1000/2000/3000 with a minimum of 512k and 1 floppy drive
  143. Modem: 300/1200/2400/4800/9600
  144.  
  145. ---------------------------------------------------------------------------
  146.  
  147.                             How to Use BackTalk
  148.  
  149. Before running BackTalk for the first time, decompress frqlib.lzh and place
  150. kd_freq.library, xprquickb.library, xprzmodem.library and xprascii.library
  151. files in your LIBS: logical directory.  Library file names are case sensitive,
  152. please do not change them.  BackTalk will not run without kd_freq.library and
  153. xprquickb.library.
  154.  
  155. BackTalk will open its screen/window in whatever resolution your computer
  156. is in at the time the program is run.  When BackTalk loads, it looks for 3
  157. files, BT.CFG (its configuration file), BT.MACROS (it's macro key file),
  158. and BT.PHONES (its phone book data file).  The S: directory will be
  159. searched for these files.  If they do not exist program defaults will be
  160. used.
  161.  
  162.  
  163. The most coherent method to document BackTalk is to describe the function
  164. of its menus (from left to right) and their menu items.
  165.  
  166. Menu: BackTalk
  167.    MenuItem: About
  168.       Hot Key: Right-Amiga-A
  169.  
  170.       This brings up a "credits" requester containing copyright, support,
  171.       and distribution information.  This requester also contains
  172.       information on the current available chip ram, current available
  173.       fast ram, and current buffer size.
  174.  
  175.    MenuItem: Hangup
  176.       Hot Key: Right-Amiga-H
  177.  
  178.       This will cause your modem to hang up the phone.  This is done by
  179.       dropping DTR.  If your modem is setup to ignore DTR or you are using
  180.       a 3 wire serial cable between your computer and your modem, this
  181.       command has detects that dropping DTR had no effect and will then
  182.       send the standard Hayes compatible "+++ATH" string to your modem.
  183.  
  184.    MenuItem: Quit
  185.       Hot Key: Right-Amiga-Q
  186.  
  187.       This will terminate the program.  There are no "Are you sure?"
  188.       requesters.  Make sure you really want to exit the program before
  189.       using this menu item.
  190.  
  191. Menu: Phone
  192.    MenuItem: Dial...
  193.    Hot Key: Right-Amiga-P
  194.  
  195.       This brings up the Phone Directory.
  196.  
  197.       The Phone Directory displays 10 entries.  If there are more than 10
  198.       entries, you may scroll through them using the UP and DOWN arrow keys.
  199.  
  200.       You may select the entry to dial by using the mouse and clicking upon
  201.       the entry or by typing the number to the left of the entry from the
  202.       keyboard.  This will place the entry into the string gadgets below.
  203.       You may dial the entry by clicking on the gadget labeled "Dial" or by
  204.       typing "D" from the keyboard.  The phone number will be sent to the
  205.       modem with a terminating carriage return.
  206.  
  207.       If for any reason you do not want the carriage return sent, in the
  208.       phone number portion of that entry, place an asterisk (*) as the last
  209.       character in the phone number (see "Adding Phone Book Entries" and
  210.       "Editing Phone Book Entries" below).  When "Dial" is clicked upon or
  211.       the letter "D" is typed, the phone number will be sent to the modem
  212.       without a terminating carriage return.
  213.  
  214.       Adding Phone Book Entries:
  215.       To add a phone book entry, click on the "Add" gadget with the mouse.
  216.       This will activate the "System" string gadget.  Type in the name and
  217.       then type return.
  218.  
  219.       The "Phone" string gadget will now be activated.  Enter the phone
  220.       number to be dialed and type a  return.
  221.  
  222.       The "Comment" string gadget will be activated.  Enter a comment if you
  223.       wish, and type return.
  224.  
  225.       The "Configuration" gadget will be activated.  In this string gadget
  226.       enter the name of the configuration file you wish to have activated
  227.       for this Phone Book entry.  If you do not remember the name of the
  228.       configuration file, click on the small gadget immediately to the
  229.       right of the "Configuration" string gadget.  This will bring up a file
  230.       requester defaulted to S:#?.CFG.
  231.  
  232.       The "Macros" gadget will be activated.  In this string gadget enter the
  233.       name of the macro file you wish to have activated for this Phone Book
  234.       entry.  If you do not remember the name of the macro file, click on
  235.       the small gadget immediately to the left of the "Macros" string gadget.
  236.       This will bring up a file requester defaulted to S:#?.MACROS.
  237.  
  238.       The "Modem Prefix" string gadget will be activated.  The "Modem Prefix"
  239.       string gadget serves two purposes.  The information entered here will
  240.       be prepended to the phone number when it is sent to the modem.  This is
  241.       also a "terminator" field for the Phone Book entry.  If you do not type
  242.       a return in this gadget the Phone Book entry will not be added.
  243.       By default, an "ATDT" is placed in the "Modem Prefix" string gadget.
  244.       If this is acceptable, just type a carriage return, if not, enter your
  245.       dialing prefix and type a carriage return.
  246.  
  247.       You may also enter the new phone entry by clicking again on the
  248.       ADD gadget.  If the "System" string requester contains text, the
  249.       entry will be added.  Should you change your mind about adding a
  250.       Phone Book entry, click on the DELETE gadget and all information
  251.       currently in the string gadgets will be thrown away.
  252.  
  253.       Editing Phone Book Entries:
  254.       To edit an existing Phone Book entry, select the entry to be edited by
  255.       clicking upon the entry or by typing the number of the entry.  The
  256.       entry will be placed into the string gadgets below.  Click the mouse
  257.       on the string gadget you wish to change and make your changes.  When
  258.       you type a carriage return in the "Modem Prefix" string gadget, the
  259.       changes will be accepted.
  260.  
  261.       Deleting Phone Book Entries:
  262.       To delete an existing Phone Book entry, select the entry to be deleted
  263.       by clicking upon the entry of by typing the number of the entry.  The
  264.       entry will be placed into the string gadgets below.  Click the mouse
  265.       on the "Delete" gadget.  The entry will be removed from the list.
  266.  
  267.       The Phone Book entries are "hot keyable" from within the requester by
  268.       using the number keys 1-1(0).  The Dial and Exit gadgets are also hot
  269.       keyable using the D and E keys, respectively.
  270.  
  271.       If there have been any changes to the Phone Book those changes will be
  272.       written to the file BT.PHONES when you exit the Phone Book (by using
  273.       the Dial or Exit gadgets).
  274.  
  275.    MenuItem: Redial
  276.    Hot Key: Right-Amiga-$
  277.  
  278.       This will cause the last dialed Phone Book entry to be dialed again.
  279.       This will not cause the associated configuration or macros file
  280.       to be read.
  281.  
  282. Menu: Serial
  283.    MenuItem: Serial Definitions...
  284.    Hot Key: Right-Amiga-*
  285.  
  286.        This brings up the Serial Definitions requester.  Most of the items
  287.        within this requester are self explanatory.
  288.  
  289.       If you are using a modem or a serial card that requires the use of a
  290.       serial device driver other than the CBM supplied "serial.device" make
  291.       sure that device driver is located in your DEVS: directory.  Enter
  292.       the name of the device driver (the name is case sensitive) into the
  293.       "Device Name" string gadget.  If a unit number other than 0 is
  294.       required, enter the unit number into the "Unit #" string gadget (check
  295.       the documentation for your non-CBM supplied device driver for this
  296.       information.
  297.  
  298.       NOTE 1:  There appears to be a problem with CBM's serial.device that
  299.                is distributed with the A2232 card.  The symptom is that when
  300.                a unit number other than 0 is being used, attempting to close
  301.                and reopen the port while online will cause BackTalk to hang.
  302.  
  303.       NOTE 2: BackTalk opens the serial port in SHARED mode, thus, one of
  304.               the first things it does it check to see if the serial port is
  305.               already in use (on-line).  BackTalk does this by checking the
  306.               state of the Carrier Detect line.  Thus, IF you have your modem
  307.               configured to have the Carrier Detect line held ON all the time
  308.               (this is the default configuration for many modems!), BackTalk
  309.               will take the current serial parameters and use them, you will
  310.               NOT be able to change them.
  311.  
  312.               If you're not really on-line, but have the Carrier Detect line
  313.               set HIGH all the time, the serial port will open with the values
  314.               you've saved using the Amiga's Serial Preferences (saved by
  315.               running the PREFERENCES program).  If you must keep your modem
  316.               configured with the Carrier Detect line HIGH all the time, use
  317.               PREFERENCES to set your serial parameters.
  318.  
  319.               The best solution is, of course, to have the modem configured so
  320.               the Carrier Detect line shows the true state of connection.  On
  321.               a Hayes Compatible modem, this is done via the AT&C1 command
  322.               followed by the AT&W command to save that setting.
  323.  
  324.  
  325.  
  326.       To exit the Serial Definitions requester, click on the Cancel or Use
  327.       gadgets, or type the letter C or U.  If you have made changes and
  328.       selected "Use", those changes will go into effect immediately.  By
  329.       selecting "Cancel" all changes will be negated and your serial
  330.       definitions will remain as they were before you entered the Serial
  331.       Definitions requester.
  332.  
  333.    MenuItem: Send Break
  334.    Hot Key: Right-Amiga-~ (tilde)
  335.  
  336.       This sends a break signal.
  337.  
  338. Menu: Files
  339.    MenuItem: Protocols...
  340.    Hot Key:  NONE
  341.  
  342.       BackTalk utilizes the XPR protocol specification.  This menu item will
  343.       bring up a file requester from which you may load the xpr library you
  344.       would like to use.  By default, the file requester will display files
  345.       in LIBS: that begin with XPR#?.
  346.  
  347.    MenuItem: Receive File...
  348.    Hot Key: Right-Amiga-D
  349.  
  350.       When selected you will be presented with a file requester for you to
  351.       indicate the path and file name of where the download will be written.
  352.       Some transfer protocols are "autostart" meaning that when you tell
  353.       the system you are calling that you want to download a file the file
  354.       transfer starts automatically.  You will be prompted for the location
  355.       of where the file will be written.
  356.  
  357.       An example of an autostart protocol is CompuServe QuickB protocol.
  358.       You would simply type "DOW filename", Compuserve will respond with
  359.       "Filename for your computer".  You would respond with the
  360.       path/filename of the file you are downloading.  The transfer will
  361.       start automatically at that point.
  362.  
  363.    MenuItem: Send File...
  364.    Hot Key: Right-Amiga-U
  365.  
  366.       Same as Receive File... only in the reverse direction.
  367.  
  368.    MenuItem: Capture On
  369.    Hot Key: Right-Amiga-O
  370.  
  371.       A file requester will be presented with the default path and filename
  372.       taken from the path and filename you indicated in the Global Options
  373.       requester (more on the Global Options requester later).  If this is
  374.       acceptable, hit return and the capture file will be opened.  If it is
  375.       not acceptable, enter the desired path and filename.
  376.  
  377.       Should you open a capture file, and that file already exists, the
  378.       new information will be appended to the existing file rather than
  379.       overwriting the existing file.
  380.  
  381.    MenuItem: Capture Off
  382.    Hot Key: Right-Amiga-C
  383.  
  384.       This turns off the capture buffer and closes the capture file.
  385.  
  386.    MenuItem: Change Current Directory
  387.    Hot Key: None
  388.  
  389.       This brings up a string requester into which you enter the
  390.       directory path you'd like to be the new current directory.
  391.  
  392.    MenuItem: Selected Protocol Options
  393.    Hot Key: None
  394.  
  395.       All of the XPR libraries have options that the user may select
  396.       on a "run time" basis.  Using this item you will be presented
  397.       with a requester with various options that the currently
  398.       selected protocol offers.
  399.  
  400.       ALSO SEE:  The SETXPR ARexx command and the text file About_XPR.
  401.  
  402. Menu: Review
  403.    MenuItem: Show Review
  404.    Hot Key: Right-Amiga-R
  405.  
  406.       This opens the Review Buffer.  The Review Buffer is a circular buffer,
  407.       user sizable.  You may move around in the Review Buffer by using the
  408.       up arrow and down arrow keys to scroll a line at a time.  Shifted up
  409.       or   down arrows will scroll a page at a time.  ALT up and down arrow
  410.       will move you to top or bottom of file, respectively.  Clicking the
  411.       mouse   upper half of the display will scroll the display up one page.
  412.       Clicking the mouse in the lower half of the display will scroll the
  413.       display down one page.
  414.  
  415.       A menu called "Size" is available.  The menu item below will either
  416.       be "FULL" or "HALF".  Select this item if you want to change the
  417.       size of the Review Buffer's window.  This will cause the Review
  418.       Buffer's window to be the full size of the communications window or
  419.       half the size of the communications window.  You may also size the
  420.       Review Buffer's window by using the sizing gadget in the lower
  421.       right corner.
  422.  
  423.       NOTE:  When you use the "Save Configuration" menu item located
  424.              in the Configuration menu, the current setting of the
  425.              Size variable will be saved in the configuration file.
  426.  
  427.       You may exit the Review Buffer via the menu.  Other methods to exit
  428.       the Review Buffer is to type Right-Amiga-Q, type ESC, or type HELP.
  429.       If you are running in a workbench window, there will also be a
  430.       Close Box in the upper left corner.
  431.  
  432.       NOTE:  The Review Buffer is "live", meaning that you may scroll around
  433.              in the buffer while text continues to come into the serial
  434.              port.  When the Review Buffer's window is opened, only that
  435.              text which is currently in the review buffer will be displayed.
  436.              Text which subsequently is received will continue to be added
  437.              to the Review Buffer but will not be displayable until you
  438.              close and reopen the Review Buffer window.
  439.  
  440.    MenuItem: Save Review
  441.    Hot Key: NONE
  442.  
  443.       This brings up a file requester with the path "RAM:ReviewBuff" as
  444.       the default.  If this is acceptable hit return or click on the
  445.       SAVE button.  If it is not acceptable, enter the desired path and
  446.       file.
  447.  
  448.  
  449.    MenuItem: Size Review Buffer
  450.    Hot Key: NONE
  451.  
  452.      Enter the size you want the Review Buffer to be _in bytes_.  The
  453.      minimum size is 8k, the maximum is available memory size.  If the
  454.      attempted allocation fails, the program will automatically subtract
  455.      8k the given size and try again, repeating as necessary until the
  456.      the allocation succeeds.
  457.  
  458.      NOTE:  When changing the size of the Review Buffer, all information
  459.             currently in the Review Buffer will be destroyed.
  460.  
  461.  
  462. Menu: Print
  463.    MenuItem: Print Screen
  464.    Hot Key: Right-Amiga-Z
  465.  
  466.       This will send what is currently displayed on BackTalk's screen to
  467.       your prt:.
  468.  
  469.    MenuItem: Print Review
  470.    Hot Key: Right-Amiga-!
  471.  
  472.       This will send the contents of the Review Buffer to prt:.
  473.  
  474.    MenuItem: Echo Printer
  475.    Hot Key: Right-Amiga-E
  476.  
  477.       All text that is displayed on BackTalk's screen will be echoed to
  478.       prt:.
  479.  
  480. Menu: Configuration
  481.    MenuItem: Global Options
  482.    Hot Key: NONE
  483.  
  484.       This brings up the Global Options requester.  Here you specify
  485.       the default Upload and Download directories and the default name
  486.       of the Capture file.
  487.  
  488.       When BackTalk is first run, it takes note of the current directory.
  489.       It then will change the current directory to the path defined in
  490.       the "Download Directory" string gadget.  When BackTalk terminates,
  491.       it sets current directory to what it was before.
  492.  
  493.       NOTE:  If you use the Change Current Directory menu item from
  494.              the Files menu, the current directory will be set to
  495.              that directory.  On program termination, current directory
  496.              will be restored to what it was when the program was
  497.              run.
  498.  
  499.       BackTalk utilizes proportional fonts.  Even if the font you have
  500.       selected is not proportional, it is treated as such.  When using
  501.       the Chat Window (described in more detail later) lines are
  502.       "auto sent" when a maximum line length is reached.  This line
  503.       length is based upon the pixel length of the line, not the
  504.       character length of the line.  You may, in the Global Options
  505.       requester, specify at what pixel length the line should be sent.
  506.       You are shown the current maximum line length, in pixels, that
  507.       is possible (based upon your horizontal resolution) and may enter
  508.       a different value in the string gadget.  This feature is basicly
  509.       a trial and error adventure depending on the font you are using.
  510.  
  511.       When using the Chat Window, as mentioned above, lines are auto sent
  512.       if a maximum line length is reached before a carriage return is
  513.       entered.  You may elect to have a "..." automatically appended to
  514.       all lines that are auto sent from the Chat Window.  Appending the
  515.       dots is especially useful when in a conferencing area to indicate to
  516.       others that you are not through typing.  However, it can become a
  517.       nuisance if you are leaving a message while using the Chat Window.
  518.       In the Global Options requester you may select to have the dots
  519.       appended or not.
  520.  
  521.       Also in the Global Options requester are two string gadgets, labeled
  522.       "Modem Init Command" and "Modem Exit Command".  Whatever string is
  523.       in the Moden Init Command string gadget will be sent to the serial
  524.       port immediately upon starting BackTalk.  The Modem Exit Command
  525.       string will be sent to the serial port just prior to terminating
  526.       BackTalk.  If you do not want these strings to be sent, clear
  527.       these string gadgets.
  528.  
  529.    MenuItem: Split
  530.    Hot Key: Right-Amiga-S
  531.  
  532.       If you are running BackTalk in a hi resolution/interlaced mode, the
  533.       Split command will reduce the size of BackTalk's window to half
  534.       screen.  Split is a toggle.  If BackTalk is in half size mode,
  535.       selecting split again will return it to full screen size.
  536.       The state of this item is saved in the BT.CFG file.
  537.  
  538.    MenuItem: Screen Type
  539.       SubItem: 1 Bit Plane
  540.       Hot Key: Right-Amiga-1
  541.  
  542.          Causes BackTalk to be run in a 1 bit plane custom screen.
  543.          The state of this item is saved in the BT.CFG file.
  544.  
  545.       SubItem: 2 Bit Plane
  546.       Hot Key: Right-Amiga-2
  547.  
  548.          Causes BackTalk to be run in a 2 bit plane custom screen.
  549.          The state of this item is saved in the BT.CFG file.
  550.  
  551.       SubItem: Workbench
  552.       Hot Key: Right-Amiga-3
  553.  
  554.          Causes BackTalk to be run in a workbench window.
  555.          The state of this item is saved in the BT.CFG file.
  556.  
  557.    MenuItem: Borders On/Off
  558.    Hot Key: Right-Amiga-B
  559.  
  560.       This is a toggle which turns the window borders on or off.
  561.       The state of this item is saved in the BT.CFG file.
  562.  
  563.    MenuItem: Set Colors
  564.    Hot Key: NONE
  565.  
  566.       This brings up a color requester.  You may change the colors of the
  567.       program with this requester.  This menu item is ghosted if you are
  568.       running BackTalk from a workbench window.
  569.       The state of this item is saved in the BT.CFG file.
  570.  
  571.    MenuItem: Fonts
  572.       SubItem: Diskfonts...
  573.       Hot Key: Right-Amiga-F
  574.  
  575.          This brings up a file requester defaulted to FONTS:.  Select the
  576.          font you wish to use, then select the point size, and click
  577.          on use.  The state of this item is saved in the BT.CFG file.
  578.  
  579.       SubItem: Topaz 8
  580.       Hot Key: Right-Amiga-8
  581.  
  582.          Since Topaz is a rom font it will not show up in the Fonts
  583.          file requester.  This item will select the Topaz 8 font.
  584.          The state of this item is saved in the BT.CFG file.
  585.  
  586.       SubItem: Topaz 9
  587.       Hot Key: Right-Amiga-9
  588.  
  589.          Since Topaz is a rom font it will not show up in the Fonts
  590.          file requester.  This item will select the Topaz 9 font.
  591.          The state of this item is saved in the BT.CFG file.
  592.  
  593.    MenuItem: Macros
  594.       SubItem: Load Macros
  595.       Hot Key: NONE
  596.  
  597.          This brings up the a file requester.  You may choose the macro
  598.          the macro file you want to be active.
  599.  
  600.          NOTE: Macro files may be in any directory and named in any
  601.                way you would like.  However, it is recommended that
  602.                you place your macros files in S: and that you use
  603.                the extension ".macro".  When the file requester is
  604.                presented it will be defaulted to S:#?.macros.
  605.  
  606.  
  607.       SubItem: Edit Macros
  608.       Hot Key: NONE
  609.  
  610.          This brings up the Macros requester.  Simply click on the FKey
  611.          gadget of your choice, or type the associated F-key, enter the
  612.          text into the string gadget and type return in the string gadget.
  613.          To enter a carriage return into your macros, type a ^M (either
  614.          the 2 separate characters ^ and M or the 2 keys together.  The
  615.          same goes for any control character you'd like to embed in a macro).
  616.          If you exit the Macro requester by selecting SAVE a file requester
  617.          will be presented with the name of the currently selected macro file.
  618.  
  619.          A macro may contain the command to execute an ARexx script.  The
  620.          delimiter for ARexx script names is the backslash (\).
  621.          An example ...
  622.  
  623.          This is a test \do_something\and another test.
  624.  
  625.          If the above is your macro, "This is a test " will be sent as a
  626.          normal macro string.  Then the ARexx script "do_something" will be
  627.          run, then the text "and another test" will be sent as a normal macro
  628.          string.
  629.  
  630.          NOTE 1:  If you need to send a backslash as part of your macro and
  631.                 it's not to be used as an ARexx scriptname delimiter, preface
  632.                 the backslash with another backslash, ie., \\.
  633.  
  634.          NOTE 2:  The ARexx script name need not contain the path nor the
  635.                 extension.  The path is assumed to be REXX: and the extension
  636.                 is assumed to be .BT.
  637.  
  638.    MenuItem: Chat Window
  639.    Hot Key: Right-Amiga-W
  640.  
  641.       This toggles the Chat Window on and off.  Text typed into the Chat
  642.       Window will be sent to the serial port when a carriage return is
  643.       typed or when the length of the line exceeds the maximum line length
  644.       (see Global Options for more information on the maximum line length).
  645.       Because lines are auto sent from the Chat Window an insert mode
  646.       is not provided.  You may move the cursor on the line in the Chat
  647.       Window with the left and right arrow keys.  If you type over text you
  648.       will be "typing over text" rather than inserting new text.
  649.  
  650.       A ctrl-X typed in the Chat Window will clear the current line.
  651.       A ctrl-Y typed in the Chat Window will delete the text from the cursor
  652.       position to the end of the line.
  653.  
  654.       The Chat Window features a 20 line Chat History Buffer.  This is a
  655.       circular buffer.  You move through previously send line by using the
  656.       the up and down arrow keys.
  657.  
  658.       Using the Chat Window in Compuserve's Conferenicng or CB areas:
  659.       If the beginning of a line is "/sen nn" (where nn is a "job number")
  660.       and the line is auto sent before a carriage return is entered, the
  661.       unsent text will be wrapped to the next line and PREpended with
  662.       the "/sen nn" from the previous line.  This helps prevent embarassing
  663.       moments if the first /sen line is auto sent and the user neglects to
  664.       type "/sen nn" on the following line.
  665.  
  666.       Sending control characters from the Chat Window to the serial port is
  667.       sometimes necessary.  BackTalk will send ctrl-C, ctrl-O, ctrl-P, ctrl-Q,
  668.       ctrl-S, ctrl-Z, and ESC from the Chat Window to the serial port.
  669.       All others are ignored.
  670.  
  671.       When the Chat Window is active, a gadget labeled /SEN is located
  672.       on the right side of the bottom status line.  When the /SEN gadget
  673.       is clicked upon a string gadget will appear to it's right.  This
  674.       gadget is used to make it more convenient to have a /SEN converation
  675.       (private conversation) with someone in CompuServe's Conferencing or
  676.       CB areas.  When the the /SEN gadget is activated and a job number
  677.       is entered into the string gadget, all lines in the Chat Window will
  678.       be prepended with "/SEN nn" (where nn is the job number).
  679.  
  680.       The state of this item is saved in the BT.CFG file.
  681.  
  682.    MenuItem: Append "..."
  683.    Hot Key: Right-Amiga-. (period)
  684.  
  685.       This function was decribed in more detail under Global Options.
  686.       It is another way (that is "hot keyable") to turn on and off the
  687.       append dots feature of lines auto sent from the Chat Window.  When
  688.       this option is selected a "box" will appear on the far right side of
  689.       the Chat Window bar (the bar separates the main communications window
  690.       from the Chat Window).  This gives you a visual indication that you
  691.       have selected the Send Dots feature.
  692.       The state of this item is saved in the BT.CFG file.
  693.  
  694.    MenuItem: Double Click XON/XOFF
  695.    Hot Key: NONE
  696.  
  697.       A check marked menu item that toggles on and off the ability to double
  698.       click the mouse to send an xon/xoff.  The state of this item is saved
  699.       in the BT.CFG file.
  700.  
  701.    MenuItem: CTRL-U From Chat
  702.    Hot Key: NONE
  703.  
  704.       A check marked menu item that prepends a ^U to all lines sent from
  705.       the Chat Window.  This option is CompuServe specific.  If you are using
  706.       the Chat Window and you are experiencing line noise, a ^U will clear
  707.       CompuServe's input buffer (get rid of the noise) before you line is
  708.       sent.  The state of this item is saved in the BT.CFG file.
  709.  
  710.    MenuItem: Load Configuration
  711.    Hot Key: NONE
  712.  
  713.       Selecting this item will present a file requester.  You may choose
  714.       a configuration file to be loaded and "take effect".
  715.  
  716.       NOTE: Configuration files may be in any directory and named in any
  717.             way you would like.  However, it is recommended that you place
  718.             your configuration files in S: and that you use the extension
  719.             ".cfg".  When the file requester is presented it will be
  720.             defaulted to S:#?.cfg.
  721.  
  722.  
  723.    MenuItem: Save Configuration
  724.    Hot Key: NONE
  725.  
  726.       Selecting this item causes all current user selectable options to
  727.       be written to the file BT.CFG.  This includes the current selection
  728.       of protocol, colors, fonts, split or full window, 1 bit plane screen,
  729.       2 bit plane screen, or workbench screen, modem init and modem exit
  730.       strings, what window off or on, borders off or on, send dots off or
  731.       on, all serial parameters -- ANYTHING the user may select or change
  732.       from the default configuration.
  733.  
  734.       NOTE: As of BackTalk 1.30, a version check is made when BT.CFG
  735.       is read from disk.  If your BT.CFG file was written with a version
  736.       of BackTalk prior to 1.30 you will be presented with a requester
  737.       informing you that the file format is incompatible.  The program
  738.       will then use the internal default values.  However, the next time
  739.       you use select "Save Configuration" the new file format will be
  740.       written to disk.  This was added in anticipation of future additions
  741.       to the BT.CFG file.
  742.  
  743.  
  744. ---------------------------------------------------------------------------
  745.  
  746.                        Other Features and Functions
  747.  
  748.  
  749. ARexx:
  750.  
  751. Using internal scripts ...
  752.  
  753. When BackTalk is run it attempts to open the ARexx port "REXX".  If this
  754. port is found an new menu is added, ARexx.  Under this menu is one menuitem,
  755. "ARexx...".  When this is selected a file requester is presented.
  756. The file requester is defaulted to the REXX: directory and only filenames
  757. with an extension of .BT are displayed.  .BT is the recognized extension
  758. for BackTalk specific ARexx scripts.
  759.  
  760. Using external scripts ...
  761.  
  762. Since BackTalk may be run more than once, different iterations of the progrm
  763. will have a uniquely named ARexx port.  In the first iteration it is
  764. named BT_REXX. The second iteration is BT_REXX2, the third is
  765. BT_REXX3, etc.
  766.  
  767. Quote all string arguments in your BackTalk ARexx scripts.
  768. NOTE:  All <string> arguments are case sensitive EXCEPT those used
  769.        with the ONSTRING and OFFSTRING commands.
  770.  
  771. Following are the ARexx command currently supported:
  772.  
  773. WAITFOR  Usage: WAITFOR <string>
  774.    This command waits for the string.  ARexx is not replied to
  775.    until this string is found.
  776.  
  777. ONSTRING  Usage: ONSTRING <string>
  778.    Sends a message to ARexx whenever <string> is encountered in the
  779.    serial input stream.  Your ARexx program must open a port named
  780.    BT_msg.  When a match is found, BackTalk will send a message
  781.    to BT_msg, arg0 will be MATCH.
  782.  
  783.    You may embed control characters within <string>.  To do so, use
  784.    the ^ (caret) then the character.  (ie, "John^M^J(" will cause the
  785.    serial input stream to be searched for "John" followed by an
  786.    0x0d (^M/carriage return), a 0x0a (^J), and a left parenthesis.
  787.    If you want to search the input stream for a ^ (caret) itself,
  788.    use "^^".  IE., to search for "2^2" your string would be entered
  789.    as "2^^2".  Each caret to be searched for must be preceeded with
  790.    another caret so the program knows you really want to search for
  791.    a caret and not to interpret it as the next character being a
  792.    control character.
  793.  
  794.    NOTE 1:  If you call ONSTRING(n) while an existing ONSTRING(n) command is
  795.           running you will not add a second string to the search but
  796.           will change the search string for the currently running
  797.           iteration of ONSTRING(n).
  798.           IE., ONSTRING "JOE"   (input stream being searched for "JOE")
  799.                ONSTRING "MOE"   (input strean now being searched for "MOE")
  800.  
  801.    NOTE 2:  There is only 1 port for BackTalk to send messages to
  802.             your ARexx script, that being "BT_msg".  You should
  803.             include something like the following in your scripts
  804.             that use ONSTRING(n) and OFFSTRING(n) in case another
  805.             script you've got running is already using the port.
  806.  
  807.               if ~openport("BT_msg") then do
  808.                  MESSAGE "PORT ALREADY IN USE"
  809.                  exit
  810.               end
  811.  
  812.               If you don't and just assume the port opened without
  813.               checking the return value, or you ignore the return
  814.               value and try to use it anyway, all sorts of strange
  815.               things may happen.
  816.  
  817.               The length of the ONSTRINGn/OFFSTRINGn arguments can
  818.               be up to 64 characters.  They are NOT case sensitive.
  819.  
  820. ONSTRING1  Usage: ONSTRING1 <string>
  821.    Works exactly as described for ONSTRING except the message sent to your
  822.    ARexx script will be MATCH1.
  823.  
  824. ONSTRING2  Usage: ONSTRING2 <string>
  825.    Works exactly as described for ONSTRING except the message sent to your
  826.    ARexx script will be MATCH2.
  827.  
  828. ONSTRING3  Usage: ONSTRING3 <string>
  829.    Works exactly as described for ONSTRING except the message sent to your
  830.    ARexx script will be MATCH3.
  831.  
  832. ONSTRING4  Usage: ONSTRING4 <string>
  833.    Works exactly as described for ONSTRING except the message sent to your
  834.    ARexx script will be MATCH4.
  835.  
  836. ONSTRING5  Usage: ONSTRING5 <string>
  837.    Works exactly as described for ONSTRING except the message sent to your
  838.    ARexx script will be MATCH5.
  839.  
  840. ONSTRING6  Usage: ONSTRING6 <string>
  841.    Works exactly as described for ONSTRING except the message sent to your
  842.    ARexx script will be MATCH6.
  843.  
  844. ONSTRING7  Usage: ONSTRING7 <string>
  845.    Works exactly as described for ONSTRING except the message sent to your
  846.    ARexx script will be MATCH7.
  847.  
  848. ONSTRING8  Usage: ONSTRING8 <string>
  849.    Works exactly as described for ONSTRING except the message sent to your
  850.    ARexx script will be MATCH8.
  851.  
  852. ONSTRING9  Usage: ONSTRING9 <string>
  853.    Works exactly as described for ONSTRING except the message sent to your
  854.    ARexx script will be MATCH9.
  855.  
  856. ONSTRING10  Usage: ONSTRING10 <string>
  857.    Works exactly as described for ONSTRING except the message sent to your
  858.    ARexx script will be MATCH10.
  859.  
  860. ONSTRING11  Usage: ONSTRING11 <string>
  861.    Works exactly as described for ONSTRING except the message sent to your
  862.    ARexx script will be MATCH11.
  863.  
  864. ONSTRING12  Usage: ONSTRING12 <string>
  865.    Works exactly as described for ONSTRING except the message sent to your
  866.    ARexx script will be MATCH12.
  867.  
  868. ONSTRING13  Usage: ONSTRING13 <string>
  869.    Works exactly as described for ONSTRING except the message sent to your
  870.    ARexx script will be MATCH13.
  871.  
  872. ONSTRING14  Usage: ONSTRING14 <string>
  873.    Works exactly as described for ONSTRING except the message sent to your
  874.    ARexx script will be MATCH14.
  875.  
  876. ONSTRING15  Usage: ONSTRING15 <string>
  877.    Works exactly as described for ONSTRING except the message sent to your
  878.    ARexx script will be MATCH15.
  879.  
  880. ONSTRING16  Usage: ONSTRING16 <string>
  881.    Works exactly as described for ONSTRING except the message sent to your
  882.    ARexx script will be MATCH16.
  883.  
  884. ONSTRING17  Usage: ONSTRING17 <string>
  885.    Works exactly as described for ONSTRING except the message sent to your
  886.    ARexx script will be MATCH17.
  887.  
  888. ONSTRING18  Usage: ONSTRING18 <string>
  889.    Works exactly as described for ONSTRING except the message sent to your
  890.    ARexx script will be MATCH18.
  891.  
  892. ONSTRING19  Usage: ONSTRING19 <string>
  893.    Works exactly as described for ONSTRING except the message sent to your
  894.    ARexx script will be MATCH19.
  895.  
  896. OFFSTRING  Usage: OFFSTRING <no argument> | <string>
  897.    This causes BackTalk to terminate the ONSTRING command.
  898.    If an argument is given to OFFSTRING it will be searched for in the
  899.    serial input string.  When found BackTalk will send a message to
  900.    ARexx which will terminate the ONSTRING command.  If no argument
  901.    is given to OFFSTRING a message will be sent to ARexx immediately
  902.    to terminate the ONSTRING command.
  903.  
  904.    When the message is sent to ARexx it is sent to a port that ARexx
  905.    has opened named "BT_msg".  Arg0 will contain "OFF".
  906.  
  907.    You may embed control characters within <string>.  To do so, use
  908.    the ^ (caret) then the character.  (ie, "John^M^J(" will cause the
  909.    serial input stream to be searched for "John" followed by an
  910.    0x0d (^M/carriage return), a 0x0a (^J), and a left parenthesis.
  911.    If you want to search the input stream for a ^ (caret) itself,
  912.    use "^^".  IE., to search for "2^2" your string would be entered
  913.    as "2^^2".  Each caret to be searched for must be preceeded with
  914.    another caret so the program knows you really want to search for
  915.    a caret and not to interpret it as the next character being a
  916.    control character.
  917.  
  918.    NOTE:  If you give OFFSTRINGn an argument ...
  919.           The input stream is searched for the argument string.
  920.           When it is found a message is sent to ARexx and the
  921.           corresponding ONSTRINGn (it it exists) is cleared.
  922.           If you change the argument to OFFSTRINGn before a match
  923.           is found in the input stream, all you have done is changed
  924.           the search string and NOT cleared the corresponding
  925.           ONSTRING (if it exists).  This means you may do a
  926.  
  927.           OFFSTRING "test"
  928.  
  929.           if later in your ARexx script you do a
  930.  
  931.           OFFSTRING "news"
  932.  
  933.           BEFORE a match on "test" is made, you will have changed
  934.           the search criteria from "test" to "news".
  935.  
  936.           If you do NOT give OFFSTRINGn an argument ...
  937.           A message is sent to ARexx immediately and the
  938.           corresponding ONSTRINGn (if it exists) is cleared.
  939.  
  940.           What this means is that OFFSTRINGn can be used as a "one shot"
  941.           "signal me when this string is found".  Very much like WAITFOR
  942.           with the exception being that your ARexx script will have to
  943.           be looking for the message from BackTalk signaling the string
  944.           was found.  (WAITFOR does not reply to ARexx until the string
  945.           is found and therefore effectively stops further execution of
  946.           your ARexx script until a match is found).
  947.  
  948.  
  949. OFFSTRING1  Usage: OFFSTRING1 <no argument> | <string>
  950.    Works exactly as described for OFFSTRING except the message sent to your
  951.    ARexx script will be OFF1.
  952.  
  953. OFFSTRING2  Usage: OFFSTRING2 <no argument> | <string>
  954.    Works exactly as described for OFFSTRING except the message sent to your
  955.    ARexx script will be OFF2.
  956.  
  957. OFFSTRING3  Usage: OFFSTRING3 <no argument> | <string>
  958.    Works exactly as described for OFFSTRING except the message sent to your
  959.    ARexx script will be OFF3.
  960.  
  961. OFFSTRING4  Usage: OFFSTRING4 <no argument> | <string>
  962.    Works exactly as described for OFFSTRING except the message sent to your
  963.    ARexx script will be OFF4.
  964.  
  965. OFFSTRING5  Usage: OFFSTRING5 <no argument> | <string>
  966.    Works exactly as described for OFFSTRING except the message sent to your
  967.    ARexx script will be OFF5.
  968.  
  969. OFFSTRING6  Usage: OFFSTRING6 <no argument> | <string>
  970.    Works exactly as described for OFFSTRING except the message sent to your
  971.    ARexx script will be OFF6.
  972.  
  973. OFFSTRING7  Usage: OFFSTRING7 <no argument> | <string>
  974.    Works exactly as described for OFFSTRING except the message sent to your
  975.    ARexx script will be OFF7.
  976.  
  977. OFFSTRING8  Usage: OFFSTRING8 <no argument> | <string>
  978.    Works exactly as described for OFFSTRING except the message sent to your
  979.    ARexx script will be OFF8.
  980.  
  981. OFFSTRING9  Usage: OFFSTRING9 <no argument> | <string>
  982.    Works exactly as described for OFFSTRING except the message sent to your
  983.    ARexx script will be OFF9.
  984.  
  985. OFFSTRING10  Usage: OFFSTRING10 <no argument> | <string>
  986.    Works exactly as described for OFFSTRING except the message sent to your
  987.    ARexx script will be OFF10.
  988.  
  989. OFFSTRING11  Usage: OFFSTRING11 <no argument> | <string>
  990.    Works exactly as described for OFFSTRING except the message sent to your
  991.    ARexx script will be OFF11.
  992.  
  993. OFFSTRING12  Usage: OFFSTRING12 <no argument> | <string>
  994.    Works exactly as described for OFFSTRING except the message sent to your
  995.    ARexx script will be OFF12.
  996.  
  997. OFFSTRING13  Usage: OFFSTRING13 <no argument> | <string>
  998.    Works exactly as described for OFFSTRING except the message sent to your
  999.    ARexx script will be OFF13.
  1000.  
  1001. OFFSTRING14  Usage: OFFSTRING14 <no argument> | <string>
  1002.    Works exactly as described for OFFSTRING except the message sent to your
  1003.    ARexx script will be OFF14.
  1004.  
  1005. OFFSTRING15  Usage: OFFSTRING15 <no argument> | <string>
  1006.    Works exactly as described for OFFSTRING except the message sent to your
  1007.    ARexx script will be OFF15.
  1008.  
  1009. OFFSTRING16  Usage: OFFSTRING16 <no argument> | <string>
  1010.    Works exactly as described for OFFSTRING except the message sent to your
  1011.    ARexx script will be OFF16.
  1012.  
  1013. OFFSTRING17  Usage: OFFSTRING17 <no argument> | <string>
  1014.    Works exactly as described for OFFSTRING except the message sent to your
  1015.    ARexx script will be OFF17.
  1016.  
  1017. OFFSTRING18  Usage: OFFSTRING18 <no argument> | <string>
  1018.    Works exactly as described for OFFSTRING except the message sent to your
  1019.    ARexx script will be OFF18.
  1020.  
  1021. OFFSTRING19  Usage: OFFSTRING19 <no argument> | <string>
  1022.    Works exactly as described for OFFSTRING except the message sent to your
  1023.    ARexx script will be OFF19.
  1024.  
  1025. OFFSTRINGALL  Usage:  OFFSTRINGALL
  1026.    This will clear all outstanding OFFSTRINGn and ONSTRINGn
  1027.    calls.  To be used if RESET does too much for your needs.
  1028.    It is HIGHLY recommended you use either OFFSTRINGALL or
  1029.    RESET immediately before exiting your ARexx script if
  1030.    ONSTRINGn and/or OFFSTRINGn were used in the script.
  1031.  
  1032. RESET  Usage: RESET
  1033.    This is recommended to be used immediately before the "exit" command
  1034.    in your ARexx scripts.  It will clear all outstanding ONSTRINGn and
  1035.    OFFSTRINGn calls, restore screen display if DISPLAYOFF was called,
  1036.    and UNBLOCK user input if BLOCK was called.  The main purpose of this
  1037.    command is to tell BackTalk that the script has terminated and there
  1038.    is no longer any reason to be checking the input stream for matches
  1039.    if you had used ONSTRINGn/OFFSTRINGn.  Of course, RESET can be used
  1040.    at any time in an ARexx script if you wish the above actions to take
  1041.    place.
  1042.  
  1043. SEND  Usage: SEND <string>
  1044.    Sends a string to the serial port with a terminating carriage return.
  1045.    If the first character of <string> is a ^ (caret) the following
  1046.    character will immediately be sent as a control character and any
  1047.    text following that 2 character sequence will be ignored.  No carriage
  1048.    return is sent after a control character regardless of whether SEND
  1049.    or SENDNCR was used.
  1050.  
  1051. SENDNCR  Usage: SENDNCR <string>
  1052.     The same as SEND however does not send a terminating carriage return
  1053.  
  1054. MESSAGE  Usage:  MESSAGE <string>
  1055.    Sends a text message to the screen and to the review buffer
  1056.    but does not send it to the serial port.
  1057.  
  1058. FKEY  Usage: FKEY <Fn | SFn>
  1059.    This will send one of BackTalk's fkey macros
  1060.    Returns a non-zero on failure.
  1061.  
  1062. LMACROS  Usage: LMACROS <path/filename>
  1063.    This will load in an alternate set of macros.
  1064.    Returns a non-zero on failure.
  1065.  
  1066. LCONFIG  Usage: LCONFIG <path/filename>
  1067.    This will load in an alternate configuration.
  1068.    Returns a non-zero on failure.
  1069.  
  1070. CDIR  Usage: CDIR <drive/path>
  1071.    Changes the current directory.  Returns non-zero on failure.
  1072.  
  1073. FONT  Usage: FONT <fontname> <size>  (ie, FONT "courier" "13")
  1074.    Will load in a new font.  If the point size argument is missing
  1075.    no change will be made and an error of "5" will be returned.  If
  1076.    the font name cannot be found the font will be changed to Topaz 8 and
  1077.    and error of 10 will be returned.
  1078.  
  1079. OPENCAPTURE  Usage: OPENCAPTURE <filename | default from global options>
  1080.    Returns a non-zero on failure.
  1081.  
  1082. CLOSECAPTURE  Usage:  CLOSECAPTURE
  1083.    closes the capture file
  1084.  
  1085. DISPLAYOFF  Usage: DISPLAYOFF
  1086.    this turns off screen output.  Scrolling, cursor
  1087.    positioning, etc. still takes place, just no text
  1088.    is output to the screen.
  1089.  
  1090. DISPLAYON  Usage:
  1091.    resume text display
  1092.  
  1093. GETSTRING  Usage: GETSTRING <no argument> | <string>
  1094.    Brings up a string requester and returns the string to ARexx.
  1095.    The argument for this command is the prompt string for the requester.
  1096.    You may remember why the requester popped up requesting input but
  1097.    other users of your script might not.  If no argument is given the
  1098.    default text is "Enter your text".  An error code of 10 is returned
  1099.    if the requester failed to display.
  1100.  
  1101. GETFILENAME  Usage: GETFILENAME <no argument | path>
  1102.    Brings up a file requester and returns the full path to ARexx.
  1103.    If cancel is clicked in the file requester a null string is returned.
  1104.  
  1105. PROTOCOL  Usage: PROTOCOL <xprlibrary name>  (ie., PROTOCOL "xprascii")
  1106.    Selects and loads the specified XPR library.  The ".library" is not
  1107.    needed in the argument (but nothing is harmed if it's there).  If the
  1108.    specified library cannot be loaded for some reason, the xprquickb.library
  1109.    will be loaded.  If this is the case an error of 10 will be returned,
  1110.    otherwise the result will be 0.
  1111.  
  1112. SETXPR  Usage: SETXPR <string>
  1113.    This will send string containing the codes for various user definable
  1114.    options for the currently loaded XPR library.  NO checking is made
  1115.    to determine which library is currently active, just that there IS a
  1116.    library loaded.  This function is probably best used immediately
  1117.    after a PROTOCOL call.  For details on just what user definable
  1118.    options each individual XPR protocol offers, and their codes,
  1119.    see the file "ABOUT_XPR".
  1120.  
  1121. DOWNLOAD  Usage: DOWNLOAD <path/filename>
  1122.    The argument the path/name of the file that is written to your computer.
  1123.    If no path/filename argument is given a file requester will be presented
  1124.    for you to enter the path/name.  If you select Cancel on the file requester
  1125.    or select USE with no filename selected a non-zero error code will be
  1126.    returned.
  1127.  
  1128.    NOTE: If the protocol selected is an "auto-start" protocol (currently
  1129.          xprquickb and xprzmodem are the only two currently available in
  1130.          XPR format that I know of) this function will return immediately
  1131.          with an error code of 0.  If the protocol is not an auto-start
  1132.          protocol this function will return with a 0 after completion of
  1133.          the file transfer.
  1134.  
  1135. UPLOAD  Usage: UPLOAD <path/filename>
  1136.    The argument the path/name of the file that is sent from your computer.
  1137.    If no path/filename argument is given a file requester will be presented
  1138.    for you to enter the path/name.  If you select Cancel on the file requester
  1139.    or select USE with no filename selected a non-zero error code will be
  1140.    returned.
  1141.  
  1142.    NOTE: See the NOTE for DOWNLOAD.
  1143.  
  1144. BAUD  Usage: BAUD <rate>
  1145.    Returns a non-zero on failure.
  1146.  
  1147. PARITY  Usage: PARITY <Odd | Even | None>
  1148.   Returns a non-zero on failure.
  1149.  
  1150. DUPLEX  Usage: DUPLEX <Full | Half>
  1151.    Returns a non-zero on failure.
  1152.  
  1153. DLENGTH  Usage: DLENGTH <7 | 8>
  1154.    Returns a non-zero on failure.
  1155.  
  1156. STOPBITS  Usage: STOPBITS <1 | 2>
  1157.    Returns a non-zero on failure.
  1158.  
  1159. DEVICENAME <string>  Usage: DEVICENAME <device.name>
  1160.    Should this command fail, the program will read bt.cfg and use
  1161.    those values to reopen the serial port.  Of course, this will
  1162.    negate any changes you may have made previously via the
  1163.    PARITY, DUPLEX, DLENGTH, BAUD, and STOPBITS command.
  1164.  
  1165. UNITNUMBER <number>  Usage: UNITNUMBER <number>
  1166.    This command has the same caveat as DEVICENAME.  If it fails
  1167.    bt.cfg will be read and the serial port reopened with those
  1168.    values.  A strange thing with unit number, tho.  Serial.device
  1169.    will allow you to open using unit number 1, so the change is
  1170.    successful altho BackTalk no longer talks to the modem.
  1171.  
  1172. PRINTERON  Usage: PRINTERON
  1173.    turns on echo to printer
  1174.  
  1175. PRINTEROFF  Usage: PRINTEROFF
  1176.    turns off echo to printer
  1177.  
  1178. BEEP  Usage: BEEP
  1179.    Flashes all screens
  1180.  
  1181. CLEARSCREEN  Usage: CLEARSCREEN
  1182.    Clears the communications window.  If the Chat Window is present it will
  1183.    clear up to the Chat Bar.
  1184.  
  1185. BLOCK  Usage: BLOCK
  1186.    This function blocks all user input to BackTalk.
  1187.    Block removes the menustrip and ignores all keyboard input.
  1188.  
  1189.    Note: Make sure that you issue either the UNBLOCK command or
  1190.          the QUIT command before the ARexx script ends otherwise
  1191.          you will not be able to communicate at all with BackTalk.
  1192.  
  1193. UNBLOCK  Usage: UNBLOCK
  1194.    Restores the menustrip and again pays attention to keyboard input.
  1195.  
  1196. SCREENTOBACK  Usage: SCREENTOBACK
  1197.    If BackTalk is running in a non-workbench screen, this will push
  1198.    the screen to the back.
  1199.  
  1200. SCREENTOFRONT  Usage: SCREENTOFRONT
  1201.    If BackTalk is running in a non-workbench screen, this will push
  1202.    the screen to the front.
  1203.  
  1204. HANGUP  Usage: HANGUP
  1205.   This command works just like the Hangup menu item.
  1206.   It drops DTR.  If CD was never set (dip flipped or using a 3 wire cable)
  1207.   it will wait 60 ticks then send a "+++", delay(60), "ATH\r\n".
  1208.  
  1209. QUIT  Usage: QUIT
  1210.    It does what it says, it will shutdown the program.
  1211.  
  1212. DOTS  Usage: DOTS
  1213.    This is a toggle.  If the "Append ..." feature is enabled this will
  1214.    turn it off.  If it is not enabled, this will turn it on.
  1215.  
  1216. BORDER  Usage: BORDER
  1217.    This is a toggle.  If the window borders are displayed this will remove
  1218.    them.  If the borders are not displayed this will a set them.
  1219.  
  1220. CHAT  Usage: CHAT
  1221.    This is a toggle.  If the chat window is up, this removes it.  If it is
  1222.    not enabled this enables it.
  1223.  
  1224. CLICK  Usage: CLICK
  1225.    This is a toggle.  If the "Double Click XON/XOFF" feature is set this
  1226.    turns it off.  If it is off, this turns it on.
  1227.  
  1228. SENDU  Usage: SENDU
  1229.    This is a toggle.  If the "Preface lines from chat window with ^U" is set
  1230.    this turns it off.  If it is off, this turns it on.
  1231.  
  1232. SPLIT  Usage: SPLIT
  1233.    This is a toggle.  If you are running on an interlaced system, SPLIT will
  1234.    toggle from full screen display to half screen display and back again.
  1235.  
  1236. BITPLANE1  Usage: BITPLANE1
  1237.    Causes BackTalk to be run in a 1 bitplane custom screen.
  1238.  
  1239. BITPLANE2  Usage: BITPLANE2
  1240.    Causes BackTalk to be run in a 2 bitplane custom screen.
  1241.  
  1242. WBWINDOW  Usage: WBWINDOW
  1243.    Causes BackTalk to be run in a Workbench window.
  1244.  
  1245. QSCREEN  Usage: QSCREEN
  1246.    Returns the string "SCREEN" or "WORKBENCH" indicating in what screen mode
  1247.    the program is currently running.
  1248.  
  1249. QSIZE  Usage: QSIZE
  1250.    Checks whether the program is running with a half or full sized window.
  1251.    Returns the string "HALF" or "FULL".
  1252.  
  1253. QLACE  Usage: QLACE
  1254.    Checks the interlace flag.  Returns the string "ON" or "OFF".
  1255.  
  1256. QDEPTH  Usage: QDEPTH
  1257.    If the program is running on a custom screen, returns, as a string,  the
  1258.    number of bit planes.  If running in a workbench window, it returns a
  1259.    null string.
  1260.  
  1261. QFONTNAME  Usage: QFONTNAME
  1262.     Returns the name of the currently selected font.
  1263.  
  1264. QFONTSIZE  Usage: QFONTSIZE
  1265.    Returns the size of the currently selected font.
  1266.  
  1267. QCHAT  Usage: QCHAT
  1268.    Returns the "ON" or "OFF" state of chat window.
  1269.  
  1270. QBORDER  Usage: QBORDER
  1271.    Returns the "ON" or "OFF" state of the window borders.
  1272.  
  1273. QDUPLEX  Usage: QDUPLEX
  1274.    Returns the "FULL" or "HALF" state of the duplex.
  1275.  
  1276. QBAUD  Usage: QBAUD
  1277.    Returns the current baud rate.
  1278.  
  1279. QWLENGTH  Usage: QWLENGTH
  1280.    Returns the current word length setting.
  1281.  
  1282. QSTOPBITS  Usage: QSTOPBITS
  1283.    Returns the current stop bit setting.
  1284.  
  1285. QPARITY  Usage: QPARITY
  1286.    Returns the current parity setting, "NONE", "ODD", or "EVEN".
  1287.  
  1288. QCD  Usage: QCD
  1289.    Returns the state of Carrier Detect.  Returns the string "ON" if
  1290.    you are online, "OFF" if you aren't.
  1291.  
  1292. QDEVICENAME  Usage: QDEVICENAME
  1293.    Returns the name of the currently seleced serial device.
  1294.  
  1295. QUNITNUMBER  Usage: QUNITNUMBER
  1296.    Returns the currently selected serial device unit number.
  1297.  
  1298. QPROTOCOL  Usage: QPROTOCOL
  1299.    Returns the currently selected XPR protocol.
  1300.  
  1301. QDOTS   Usage: QDOTS
  1302.    Returns the state of "Append ...".  "ON" or "OFF".
  1303.  
  1304. QPIXELS  Usage: QPIXELS
  1305.    Returns the currently selected pixel length wrap point.
  1306.  
  1307. QCAPTURE  Usage: QCAPTURE
  1308.    Returns the name of the default capture path/file
  1309.  
  1310. QDOWNLOAD  Usage: QDOWNLOAD
  1311.    Returns the name of the default download path
  1312.  
  1313. QUPLOAD  Usage: QUPLOAD
  1314.    Returns the name of the default upload path
  1315.  
  1316. QCLICK  Usage: QCLICK
  1317.    Returns the current state of the "Double Click XON/XOFF" feature,
  1318.    "ON", or "OFF".
  1319.  
  1320. QSENDU  Usage: QSENDU
  1321.    Returns the current state of the "prepend ^U to chat lines" feature,
  1322.    "ON", of "OFF"
  1323.  
  1324. QSADDRESS  Usage: QSADDRESS
  1325.    If BackTalk is currently running in a custom screen, this
  1326.    returns the hex address of that screen.  If the program is
  1327.    running in a workbench window, this command returns a null string.
  1328.  
  1329.  
  1330.                        !!!!! IMPORTANT !!!!!
  1331.  
  1332. In all of your ARexx scripts that call ONSTRINGn and/or OFFSTRINGn,
  1333. make sure that in your getpkt() loop you've got something similiar to...
  1334.  
  1335. when arg0 = 'DIE' then do
  1336.    closeport("BT_msg")
  1337.    /* other clean up stuff here */
  1338.    exit
  1339. end
  1340.  
  1341. This is _VERY_ important.  If you have an ARexx script running that is
  1342. waiting for events (currently the only implemented BackTalk ARexx calls
  1343. that will generate these events are the ONSTRINGn and OFFSTRINGn calls)
  1344. and you terminate BackTalk, BackTalk will not be able to fully terminate
  1345. until your ARexx script exits the getpkt() loop.  During BackTalk's
  1346. termination process, it will check if the port BT_msg is open.  If it
  1347. is, BackTalk will send the "DIE" message to BT_msg.  It is up to your
  1348. script to properly exit the getpkt() loop and terminate.  The termination
  1349. of the ARexx script will signal BackTalk to complete its termination
  1350. process.
  1351.  
  1352. ---------------------------------------------------------------------------
  1353.  
  1354. Following is an example ARexx script:
  1355.  
  1356.  
  1357. /* Start BackTalk ARexx script */
  1358. options results
  1359. address command "run BackTalk"
  1360. waitforport BT_REXX
  1361.  
  1362. if ~show('l', "rexxsupport.library") then
  1363.    addlib('rexxsupport.library',0,-30,0)
  1364.  
  1365. address BT_REXX
  1366. BLOCK
  1367. QSIZE
  1368. if result = "FULL" then
  1369.    SPLIT
  1370.  
  1371. call delay 100
  1372.  
  1373. GETSTRING "Enter the phone number to dial"
  1374. num = result
  1375.  
  1376. SENDNCR "atmdt "
  1377. SEND num
  1378. WAITFOR "CONNECT"
  1379. call delay 50
  1380. SENDNCR "^C"
  1381. WAITFOR "User ID:"
  1382. call delay 50
  1383. DISPLAYOFF
  1384. FKEY F2      /* this is an fkey macro, it sends my ppn and password */
  1385.              /* in the form of 77777,1234\\password                 */
  1386.  
  1387. call delay 100
  1388. DISPLAYON
  1389. FONT "Courier" "13"
  1390. SEND "G AmigaUser"
  1391. WAITFOR "Forum !"
  1392. OPENCAPTURE "ram:testing"
  1393. SEND "RN"
  1394. WAITFOR "Forum !"
  1395. CLOSECAPTURE
  1396. SEND "BYE"
  1397. QUIT
  1398.  
  1399.  
  1400. (More scripts are included in the archive and will likely change from
  1401. release to release.  Remember, scripts ending in .REXX are meant to be
  1402. run external to BackTalk, those ending in .BT are meant to be run from
  1403. within BackTalk)
  1404.  
  1405. ---------------------------------------------------------------------------
  1406.  
  1407. Scroll Lock:
  1408.  
  1409. When a ^S is sent to the serial port, a text message, "Scroll Lock On" is
  1410. displayed on the left side of bottom status line.  This is just a visual
  1411. indication that a ^S has been send and incoming text will not be resumed
  1412. until a ^Q is sent.
  1413.  
  1414. Mouse double click:
  1415.  
  1416. Double clicking the left mouse button sends a ^S to the modem.  Double
  1417. clicking again sends a ^Q.  This feature is user selectable via the
  1418. Configuration menu.  The state of this item will be saved in BT.CFG.
  1419.  
  1420.  
  1421. Hot keyable requesters:
  1422.  
  1423. All gadget "buttons" in requesters in BackTalk, except for 2 exceptions
  1424. previously noted, are "hot keyable".  Just type the first letter in the name
  1425. of the gadget.
  1426.  
  1427. ARexx Entrance and Exit Scripts:
  1428.  
  1429. If ARexx is available on your system, when you startup BackTalk, it will
  1430. look in REXX: for an ARexx script named BTstartup.bt.  If the ARexx script
  1431. exists it will be run.
  1432.  
  1433. When terminating Backtalk, if ARexx is available on your system, BackTalk
  1434. will look for a file in REXX: named BTexit.bt.  If found, the script
  1435. will be run before BackTalk terminates.
  1436.  
  1437. ---------------------------------------------------------------------------
  1438.  
  1439. Many enhancements are planned for the future.  Please don't be shy with
  1440. enhancement requests and bug reports.
  1441.